feat: custom themes and the theme registry (#82, #138)

CHANGELOG.md

@@ -9,6 +9,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Themes: `theme: dracula` (or `nord`) picks a built-in palette, and `themes:` in
+  the config defines your own, naming only the tokens you want to change. An
+  invalid color stops startup with a message naming the theme, the token and
+  the value, because lipgloss renders a bad color as no color at all and would
+  otherwise fail silently; an unknown theme stops startup with a message
+  naming the theme and listing the ones available (#82).
 - The report screen now draws a per-day sparkline of the selected range, with
   idle days rendered as gaps rather than as low bars (#80).
 - Command palette (`ctrl+p`): a fuzzy action launcher that floats over the current screen,
@@ -30,6 +36,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Fixed
 
+- The report's empty-state box is drawn with the same border color as the table
+  frame, so a report with no hours no longer shows a differently-weighted frame
+  from one with hours (#138).
 - The report header ("Report <period> — scope …") is now truncated when it no
   longer fits the terminal width instead of wrapping to a second line, with an
   ellipsis marking where it was cut (#143).

README.it.md

@@ -478,6 +478,34 @@ billing:
   il mouse attivo, in quasi tutti i terminali tenere **Shift** mentre si trascina
   seleziona e copia comunque, oppure impostare questa chiave a `false` per
   restituire il mouse al terminale una volta per tutte.
+- `theme` (opzionale): la tavolozza con cui la TUI si disegna. I nomi built-in sono
+  `default`, `dracula` e `nord`; puoi anche nominarne una tua tra le `themes` sotto.
+  Omettere la chiave usa `default`. Un nome sconosciuto ferma `clup` all'avvio
+  anziché ricadere in silenzio.
+  - **`dracula` e `nord` sono disegnate per un terminale scuro e sono spedite
+    fedelmente.** Su uno sfondo chiaro parti della TUI diventano difficili o
+    impossibili da leggere — misurato contro il bianco, il verde di dracula sta a
+    1.37:1; misurata contro il testo scuro di default del terminale dipinto sopra
+    di lei, la zebra stripe di nord sta a 2.09:1. Entrambi ben sotto il floor di
+    3:1. `default` è quella adattiva: cambia con lo sfondo del tuo terminale.
+- `themes` (opzionale): le tue tavolozze, per nome. Un tema nomina solo i token
+  che cambia; il resto viene da `default`. I sei token sono `primary`, `accent`,
+  `muted`, `danger`, `success` e `subtle` (la zebra stripe del report). Un valore è
+  un colore singolo, usato su entrambi gli sfondi, oppure una coppia `{light: …, dark: …}`.
+  Un colore è un hex `#RGB`/`#RRGGBB` oppure un numero da 0 a 255. Qualunque altra
+  cosa blocca l'avvio con un messaggio che nomina il tema, il token e il valore —
+  e ogni tema che definisci viene controllato, non solo quello che hai selezionato.
+  - **Quota i tuoi valori hex.** In YAML un `#` senza virgolette inizia un
+    commento, così `muted: #fff` imposta `muted` a nulla. `muted: "#fff"` è il colore.
+    I numeri nudi non hanno bisogno di virgolette.
+
+    ```yaml
+    theme: mine
+    themes:
+      mine:
+        accent: {light: "127", dark: "205"}
+        muted: "240"
+    ```
 
 ### Come vengono calcolati gli importi fatturati
 

README.md

@@ -447,6 +447,34 @@ billing:
   reporting takes the terminal's native text selection away: with it on, in most
   terminals holding **Shift** while dragging still selects and copies, or set this
   key to `false` to give the mouse back to the terminal for good.
+- `theme` (optional): the palette the TUI renders with. Built-in names are
+  `default`, `dracula` and `nord`; you can also name one of your own from `themes`
+  below. Omitting the key uses `default`. An unknown name stops `clup` from starting
+  rather than silently falling back.
+  - **`dracula` and `nord` are designed for a dark terminal and are shipped
+    faithfully.** On a light background parts of the UI become hard or impossible
+    to read — measured against white, dracula's green sits at 1.37:1; measured
+    against the terminal's own dark text painted on top of it, nord's zebra
+    stripe sits at 2.09:1. Both are far below the 3:1 floor. `default` is the
+    adaptive one: it changes with your terminal background.
+- `themes` (optional): your own palettes, by name. A theme names only the tokens it
+  changes; the rest come from `default`. The six tokens are `primary`, `accent`,
+  `muted`, `danger`, `success` and `subtle` (the report's zebra stripe). A value is
+  either one color, used on both backgrounds, or a `{light: …, dark: …}` pair. A
+  color is a `#RGB`/`#RRGGBB` hex or a number from 0 to 255. Anything else stops
+  startup with a message naming the theme, the token and the value — and every
+  theme you define is checked, not just the one you selected.
+  - **Quote your hex values.** In YAML an unquoted `#` starts a comment, so
+    `muted: #fff` sets `muted` to nothing at all. `muted: "#fff"` is the color.
+    Plain numbers need no quotes.
+
+    ```yaml
+    theme: mine
+    themes:
+      mine:
+        accent: {light: "127", dark: "205"}
+        muted: "240"
+    ```
 
 ### How billed amounts are computed