From 440877965e8879f3c9567cf923b7c65c0eee227c Mon Sep 17 00:00:00 2001
From: Craig Jennings <c@cjennings.net>
Date: Sat, 11 Jul 2026 23:36:51 -0500
Subject: refactor(gallery): extract design tokens to one source for 3 targets

The colors, glows, gradient ramp, and pulse rate were hardcoded literals scattered across ~40 sites in the gallery. Retuning the amber meant a find-and-replace through the whole file. I pulled them into tokens.json as the single source.

gen_tokens.py reads that source and emits three targets: web CSS custom properties (into the gallery :root, between markers), waybar GTK @define-color declarations, and an elisp alist for the future svg.el renderer. The three genuinely differ (CSS --vars with rgb-triple glows, GTK @define-color with underscore names, elisp hex alist), which is why one generator beats three hand-maintained copies.

The amber hue is defined once, and its glow triples are derived from the hex, so retuning it means editing one line and rerunning the generator.

The gallery render is unchanged. I verified it pixel-identical against the prior commit with reduced-motion forced and the live clock masked (diff of 0).

Tests cover hex conversion, the three emitters, marker replacement, and idempotency: 27 tests, 100% line coverage, wired into make test-unit.
---
 docs/prototypes/tokens.el | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 docs/prototypes/tokens.el

(limited to 'docs/prototypes/tokens.el')

diff --git a/docs/prototypes/tokens.el b/docs/prototypes/tokens.el
new file mode 100644
index 0000000..1fb6e52
--- /dev/null
+++ b/docs/prototypes/tokens.el
@@ -0,0 +1,41 @@
+;;; gallery-tokens.el --- generated from tokens.json -*- lexical-binding: t; -*-
+;;; Commentary:
+;; Generated by gen_tokens.py — do not edit by hand; edit tokens.json.
+;;; Code:
+(defconst gallery-tokens
+  '((ground . "#151311")
+    (panel . "#100f0f")
+    (well . "#0a0c0d")
+    (raise . "#1a1917")
+    (silver . "#bfc4d0")
+    (cream . "#f3e7c5")
+    (steel . "#969385")
+    (dim . "#7c838a")
+    (slate . "#424f5e")
+    (slate-hi . "#54677d")
+    (wash . "#2c2f32")
+    (pass . "#74932f")
+    (fail . "#cb6b4d")
+    (phos . "#7fe0a0")
+    (phos-dim . "#1c3626")
+    (vfd . "#63e6c8")
+    (sevgrn . "#57d357")
+    (sevred . "#e2543f")
+    (sevoff . "#1a1613")
+    (jewel-r . "#ff5b45")
+    (jewel-a . "#ffb43a")
+    (jewel-g . "#6fce33")
+    (gold . "#e2a038")
+    (gold-hi . "#ffbe54")
+    (amber-grad-top . "#f2c76a")
+    (amber-grad-mid . "#d29638")
+    (amber-grad-bot . "#8f671f")
+    (amber-edge . "#7d5c16")
+    (amber-warn . "#f0b552")
+    (glow-hi . "#ffbe54")
+    (glow-lo . "#e2a038")
+    (mono . "\"BerkeleyMono Nerd Font\",\"Berkeley Mono\",monospace")
+    (pulse-rate . "1s"))
+  "Design tokens for the panel widget gallery.")
+(provide 'gallery-tokens)
+;;; gallery-tokens.el ends here
-- 
cgit v1.2.3