Coverage Summary for Class: DashboardWidgetType (com.georgeci.moneysurfer.domain.dashboard)

 package com.georgeci.moneysurfer.domain.dashboard
 
 /**
  * Registry of the widgets the dashboard can render. The dashboard screen has a renderer for every
  * entry here, so adding a widget is a two-step change: add the constant, then handle it in the
  * screen's `when`. Entries are also the persistence keys of a saved layout — renaming one drops
  * that widget from layouts already stored on device, so prefer adding over renaming. Only the
  * constant name is persisted, so [isPeriodScoped] can be changed freely.
  *
  * @property isPeriodScoped whether this widget reads [DashboardPeriod]. Declared here rather than
  * inferred on the screen so the period switch knows whether it drives anything at all: a layout
  * with every period-scoped widget switched off must not render a control that changes nothing.
  */
 enum class DashboardWidgetType(val isPeriodScoped: Boolean = false) {
     Balance,
     QuickActions,
 
     /**
      * Spend-oriented, and **not** period-scoped — a decision, not an oversight.
      *
      * The card is month-shaped end to end: the headline is what *this month* has cost, the bar is
      * that against a monthly budget cap (`monthlySpendCap` qualifies monthly budgets only), and the
      * label compares it against the same stretch of the month before. Pointing it at
      * [DashboardPeriod.Week] would not narrow a window — it would have to pick a different cap and
      * a different baseline, which is a different card. Its title says "this month" for that reason,
      * so the switch never claims to drive it. See `md/insights.md` Phase 2.
      */
     SpentMonth,
     SafeToSpend(isPeriodScoped = true),
 
     /**
      * Spend-oriented, and **not** period-scoped yet — a scoping call, not an oversight.
      *
      * This card is deliberately two spans at once: a fixed [BURN_RATE_DAYS] bar chart of the last
      * week, and a projection of where the *month* lands. `monthToDate`, `daysAheadInMonth` and
      * `monthlySpendCap` are all month-shaped, so reading [DashboardPeriod] here is not a matter of
      * passing a window down — it means deciding what the card projects to under Week, which cap it
      * measures against, and whether the chart becomes the ISO week rather than a trailing seven
      * days. That is the widget's own design question, and #413 landed after #296 was reviewed.
      * See `md/insights.md` Phase 2.
      */
     BurnRate,
     Budgets,
     SpentByCategory(isPeriodScoped = true),
 
     /**
      * The same per-category spend [SpentByCategory] reads, drawn as a donut with a legend rather
      * than as rows — so it is period-scoped for exactly the same reason. Two cards over one figure
      * is a deliberate offer, not a duplicate: the rows answer "how much on what", the donut answers
      * "what shape is the period", and both read the same use case, so they cannot disagree.
      */
     CategoriesDonut(isPeriodScoped = true),
     Accounts,
 
     /**
      * Spend-oriented, and still **not** period-scoped — a decision, not an oversight.
      *
      * `GenerateInsightsUseCase` builds its own month-to-date window and stands its comparison
      * rules down below seven elapsed days (`MIN_COMPARISON_DAYS`). Under a Week period that
      * counter runs 1..7 and clears the bar only on the last day of the week, so pointing this
      * widget at [DashboardPeriod] would silence it six days in seven. Making the guard a share
      * of the period, or a per-mode minimum, is what has to happen first — see `md/insights.md`
      * Phase 2. Until then the switch does not claim to drive this card.
      */
     Insights,
 
     /**
      * The scheduled payments the next few days hold. **Not** period-scoped, and this one could not
      * be: it looks forward, and [DashboardPeriod] names a window that has already elapsed. Switching
      * to Week must not turn "what is about to be charged" into "the next seven days only" —
      * a rent payment eight days out is exactly what the card exists to warn about.
      */
     Recurring,
     Goals,
     RecentTransactions,
 }