eidotter 0.24.2 → 0.26.0

package/guidelines/README.md

@@ -4,7 +4,7 @@ A DOS-themed React component library with authentic CGA/amber phosphor aesthetic
 
 ## Overview
 
-eidotter provides 36 ready-to-use components with consistent DOS terminal styling:
+eidotter provides 40 ready-to-use components with consistent DOS terminal styling:
 
 - **Dark theme only** - Amber-on-black phosphor CRT aesthetic
 - **CGA color palette** - 16 authentic CGA colors + amber extensions
@@ -128,3 +128,7 @@ These patterns break the eidotter aesthetic:
 - Rounded corners > 4px (`rounded-xl`, `rounded-full`)
 - `prefers-color-scheme` (eidotter is dark-only)
 - Arbitrary Tailwind values for colors (`bg-[#1a1a1a]`)
+
+## Maintainers
+
+- [`figma-architecture.md`](./figma-architecture.md) — how the multi-platform Figma DS is structured (Foundation → platform → app), the aliasing model, the sync pipeline, and the app-adoption recipe.

package/guidelines/components.md

@@ -766,3 +766,66 @@ DOS-styled icons backed by pixelarticons (MIT).
 <Icon name="Check" size="M" />
 <Icon name="Warning" size="L" />
 ```
+
+---
+
+## Lightbox
+
+Fullscreen image viewer built on Modal's React Aria primitives — prev/next navigation, counter, caption, keyboard nav, touch swipe.
+
+### When to Use
+
+- Viewing images from a gallery or timeline entry at full size
+- Any "click thumbnail to expand" interaction
+- Used internally by `TimelineContainer`'s image/gallery entry variants
+
+### Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| images | `TimelineImage[]` | - | **Required.** Images to navigate between |
+| isOpen | `boolean` | - | **Required.** Whether the lightbox is open |
+| onClose | `() => void` | - | **Required.** Called on close button, backdrop click, or Esc |
+| initialIndex | `number` | `0` | Index to start on when opened |
+| onIndexChange | `(index: number) => void` | - | Fired when navigation moves to a new image |
+
+### Examples
+
+```tsx
+const [open, setOpen] = useState(false);
+
+<Lightbox
+  images={entry.images}
+  isOpen={open}
+  onClose={() => setOpen(false)}
+  initialIndex={2}
+/>
+```
+
+---
+
+## AIText
+
+Inline marker for AI-drafted prose. Renders a `<span data-provenance="ai-draft">` with the magenta→white→cyan shimmer gradient from the eidotter provenance system.
+
+### When to Use
+
+- Marking a single AI-drafted phrase inside otherwise-human prose
+- Hand-authored MDX where `<AIText>…</AIText>` reads more naturally than the raw attribute
+- For whole paragraphs in MDX, prefer `<p data-provenance="ai-draft">` directly — the diff pipeline unwraps it once the text drifts ≥40% from its AI baseline
+
+### Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| children | `ReactNode` | - | **Required.** The AI-drafted text |
+| title | `string` | `'AI-assisted text — being rewritten'` | Tooltip text |
+| className | `string` | - | Additional CSS classes |
+
+### Examples
+
+```tsx
+<p>
+  The release notes were <AIText>drafted with Claude and are being rewritten</AIText> by hand.
+</p>
+```

package/guidelines/figma-architecture.md

@@ -0,0 +1,136 @@
+# eiDotter Figma Design System — Architecture & Governance
+
+How eiDotter's design system is structured across Figma files, how those files relate to the npm token sources, and how apps adopt it. This is the **maintainer/contributor** reference for the multi-platform DS (DMNC-916 and descendants). Consumers of the npm package do not need this — see `README.md` for usage.
+
+> **Source of truth.** The npm token sources in `src/tokens/*.tokens.json` are canonical. Figma is a *projection* of them (via `style-dictionary` → DTCG → `figma_batch_create_variables`) plus the place components are designed. When they disagree, the JSON wins; rebuild and re-sync Figma rather than hand-editing generated values.
+
+## The chain
+
+```
+                    src/tokens/*.tokens.json   (canonical — npm)
+                              │  style-dictionary (DTCG emit)
+                              ▼
+        ┌──────────────────────────────────────────────┐
+        │   eiDotter Foundation  (KoGTFX8…)             │   T1 primitives + T3 dimensions
+        │   amber-mono CGA · effect numerics · type     │   + T4 effect numerics + typography
+        └──────────────────────────────────────────────┘
+                  │ alias            │ alias          │ alias
+                  ▼                  ▼                ▼
+        ┌───────────────┐  ┌───────────────┐  ┌───────────────┐
+        │  Web DS        │  │  iOS DS        │  │  macOS DS      │   T2 semantic layers
+        │  (iohPpta…)    │  │  (TEnlcIg…)    │  │  (peVTIvO…)    │   (+ components)
+        └───────────────┘  └───────────────┘  └───────────────┘
+                  │                  │  subscribe + alias
+                  ▼                  ▼
+              ┌──────────────────────────────────┐
+              │  App files (DOSBTS_fig, …)        │   subscribe + alias;
+              │  keep only app-specific literals  │   app-only surfaces stay local
+              └──────────────────────────────────┘
+
+   V.37 / "❖ Pattern Lab" (V4tIz3sAMRx7…)  ── UTI-full component-authoring reference;
+                                               the npm React components are designed against it.
+                                               Sits BESIDE the chain — aliases nothing in production.
+```
+
+**One line:** Foundation is the single source of primitives + effect/motion numerics; each platform library aliases Foundation and adds a semantic layer + components; each app subscribes and aliases, keeping only genuinely app-specific literals local.
+
+## File map (authoritative)
+
+| File | Key | Role |
+|------|-----|------|
+| **eiDotter Foundation** | `KoGTFX8INOAjFaOKPXnSlX` | **The canonical foundation.** Lean DOS-native, amber-mono CGA. Collections: `1. Primitives` (T1), `2. Effect Parameters` (T4 numerics), `3. Typography`. Published; subscribed-to. |
+| **eiDotter Web DS** | `iohPpta7n73wCcP5xbsaJU` | Web platform sub-library. `2. Web Semantics` (T2, 126 vars — all aliasing Foundation) + 34 ComponentSets. |
+| **eiDotter iOS DS** | `TEnlcIgXrB3akHvtjMy3po` | Apple iOS HIG semantic layer, 87 vars aliased to Foundation. |
+| **eiDotter macOS DS** | `peVTIvO9oDzynkPXhQo0W8` | Apple macOS HIG aliased to Foundation; Liquid Glass shader params kept as literals (not aliased). |
+| **V.37 / "❖ Pattern Lab"** | `V4tIz3sAMRx7H9wMYeesA6` | UntitledUI-full component fork — the component-authoring reference the npm package is built against. **Not a foundation**; aliases nothing in the production chain. Unpublished as a team library. |
+| ~~"Foundation"~~ | `qlEyN6zHPX4XOohJefJ4bZ` | **Abandoned first attempt** on Molly Helmuth's DS. **Out of scope — never subscribe to or alias.** Named "Foundation" and shares V.37's "❖" glyph, so easily confused with `KoGTFX8`; it is neither the foundation nor V.37. Frozen palette-pattern source for DMNC-922 only. |
+| **DOSBTS_fig** | `1Hemp6DehvK1a5uMrPJyhr` | Amber CGM app. Adoption target. |
+| **calendar-365** | `npu5c86H9QHBB4fluVUjKJ` | App; future adoption candidate. |
+
+## Token tier taxonomy (DMNC-916)
+
+| Tier | What | Lives in |
+|------|------|----------|
+| **T1 — Primitives** | The raw CGA palette (`color/cga/*`), brand amber. | Foundation `1. Primitives` |
+| **T2 — Semantics** | Role-named tokens (`color/semantic/text/primary`, `status/success`, …). Each **aliases** a T1 primitive. | Platform DS files (Web/iOS/macOS) |
+| **T3 — Dimensions** | Spacing, radius, border width, z-index, opacity. | Foundation (+ surfaced per platform) |
+| **T4 — Effect numerics** | Phosphor/scanline/flicker/vignette/shadow numbers; (NEW) motion durations + easings. | Foundation `2. Effect Parameters` / `4. Motion` |
+
+A T1 change in Foundation ripples through every T2 alias in every subscriber — that is the entire point of the chain.
+
+### Known limitation: amber-mono status colours
+
+Foundation's CGA `green/red/cyan` primitives are **amber-monochromed** — they resolve to browns (`cga/brightGreen ≈ rgb(203,149,41)`). Because Web DS `color/semantic/status/*` aliases those primitives, **the amber-mono limitation propagates Foundation → Web DS → any app that adopts the chain.** Apps that need *honest* status colour (e.g. a glucose monitor's in-range green) cannot get it by aliasing today.
+
+- **DMNC-1001 (this work):** *additively* introduces literal-CGA status primitives in Foundation (`#00AA00`/`#AA0000`/`#00AAAA`) so apps can alias honest colours, without disturbing the amber-mono DOS default.
+- **DMNC-922 (future):** the *full* rationalization — collapse the 16-colour CGA set to ~10 honest primitives, rename `cga/*` → `color/amber/*`, and re-alias every platform DS. Heavier; deliberately out of scope here.
+
+## Aliasing mechanism
+
+Cross-file aliasing is done via the figma-console MCP bridge (see `feedback_figma_mcp_preference` / `reference_figma_console_bridge_wsl` in maintainer memory), not REST (REST `/variables` is Enterprise-only):
+
+```js
+const imported = await figma.variables.importVariableByKeyAsync(foundationKey);
+localVar.setValueForMode(modeId, { type: 'VARIABLE_ALIAS', id: imported.id });
+```
+
+- **Resolution map:** `figma-snapshots/foundation-keys.json` maps every Foundation variable *key* → its name. It is generated by resolving the unique Foundation keys referenced by alias targets in `ios.json` + `macos.json` + `web-ds.json`. After adding/renaming Foundation variables, **re-snapshot** so apps/platforms can alias the new keys.
+- **Batching:** ≤86 alias updates per `figma_execute` call is known-safe (one macOS run landed 86 in a single call; the iOS migration ran 316 in batched form). Batch above 86 until empirically tested higher.
+- **Effect Style colours can't bind variables** (2026 Plugin API) — phosphor-glow Effect Styles are literal RGBA; an amber rebrand still needs a manual republish. Effect *numerics* DO bind (`setBoundVariableForEffect`).
+- **Opacity quirk:** `setBoundVariable('opacity', floatVar)` divides the resolved value by 100 — store Figma opacity vars as percent (0–100). The JSON sources keep decimal; Style Dictionary reads JSON, not Figma.
+
+## Sync pipeline
+
+- **Forward (npm → Figma):** `scripts/sync-to-figma.ts` writes Markdown specs to `figma-specs/` (repo root). Variable/component-set *creation* in Figma is figma-console MCP work (`figma_batch_create_variables`), not REST.
+- **Reverse (Figma → Swift):** `scripts/sync-figma-to-swift.ts` reads `figma-snapshots/{ios,macos}.json` + `foundation-keys.json` and emits `platforms/swiftui/Sources/EiDotterTokens/Apple{IOS,MacOS}.swift`, resolving cross-file Foundation aliases via the key map. Run `npm run sync-figma-to-swift` after re-snapshotting. CI (`build.yml`) fails if committed Swift drifts from the snapshot.
+
+## Live-verify rule (don't trust stale keys)
+
+Figma file keys in the repo can mislead — multiple files are named "Foundation", keys rotate, and the abandoned `qlEyN6` masquerades as the real thing. **Before touching any file, verify it live on the bridge:**
+
+1. `figma_list_open_files` → confirm the target file is connected.
+2. `figma_navigate` to switch the active target (the bridge reads one active Desktop tab at a time; it cannot *open* files in local mode — the user opens them and starts the bridge plugin).
+3. `figma_get_variables` (summary) → confirm collections/var counts match expectation **before** any write.
+
+iOS DS, macOS DS, and V.37 are documented from snapshots/memory — give each a live pass before modifying it.
+
+## App-adoption recipe (reusable)
+
+How an app file adopts the DS. Goal: **no visual change** — every alias must resolve to the same hex the local literal had. Proven on DOSBTS_fig (DMNC-1002).
+
+0. **Confirm the app is in the eidotter DOS design language.** Adoption is *not* for every portfolio Figma file. If the app has its own bespoke palette and aesthetic, it is **not a DS consumer** — skip it. Example: `calendar-365`'s "Sunburst Tokens" are a *light* print-calendar palette (black/gray text, near-white pastel month wedges, gold spoke) with **zero** value-matches to Foundation — forcing adoption would be wrong. Only DOS-amber apps (DOSBTS, DOOMBTS, EatThisDie, …) adopt.
+1. **Enable libraries** in the app file: Assets → Libraries → enable **eiDotter Foundation** (+ the relevant platform DS, e.g. iOS DS for an iOS app). *Manual Figma UI step — the bridge cannot toggle subscriptions.*
+2. **Inventory + value-match** the app's local collection (`figma_get_variables` with `resolveAliases`); for each var, find the Foundation var with the **same resolved hex** (keys live in `figma-snapshots/foundation-keys.json`).
+3. **Re-point matches to aliases**, batched ≤86/call. What can alias **today**:
+   - `amber` → `color/cga/amber`; **status → the literal-CGA set** (`success`→`cga-true/green`, `error`→`cga-true/red`, `info`→`cga-true/cyan`) — *not* the amber-mono primitives.
+   - **Colours only, for now.** Foundation's Figma file currently exposes only **colours, effect numerics, and fontFamily** as variables — it has **no spacing/radius/type-size variables** — so dimensional/type tokens stay local until Foundation's T3 dimensions are pushed to Figma (follow-up under DMNC-916).
+   - keep genuinely app-specific surfaces (e.g. DOSBTS `bg`/`card`/`muted`) **local** — don't force-alias mismatches.
+
+   > **Accessibility caveat (cga-true/red):** `#AA0000` on the near-black CRT background is ~2.3:1 — below WCAG AA body text (4.5:1). Alias `status/error → cga-true/red` for **fills** (light foreground text over the red), not for error **text** on a dark background. `cga-true/green` (#00AA00) and `cga-true/cyan` (#00AAAA) pass AA body on dark.
+
+   The mechanism (figma-console / `figma_execute`):
+   ```js
+   const local = await figma.variables.getVariableByIdAsync(localId);
+   const imported = await figma.variables.importVariableByKeyAsync(foundationKey); // key from foundation-keys.json
+   local.setValueForMode(modeId, { type: 'VARIABLE_ALIAS', id: imported.id });
+   ```
+4. **Verify no drift:** components/screens bind to the local collection *by name*, so re-pointing values ripples invisibly. Screenshot-diff every screen against pre-refactor captures. (Cross-file aliases resolve to `null`+`aliasTo` in the bridge's resolver — the screenshot, not the resolved value, is the proof.)
+5. **Spot-check the ripple:** tweak a Foundation amber value and confirm it propagates into the app file, then revert.
+
+**Worked example — DOSBTS_fig (DMNC-1002):** of 37 local vars, **5 aliased** — `amber` + `text-primary` → `cga/amber`; `success`/`error`/`info` → `cga-true/green·red·cyan` (the glucose colours, now Foundation-sourced). The rest stayed local: `bg`/`card`/`amber-dark`/`amber-light`/`muted`/`border`/`text-secondary`/`text-muted`/`white` (no Foundation value-match), plus all spacing/radius/type + `font-family` (no Foundation dimension/type vars yet). The Overview screen rendered identically.
+
+## Android (deferred)
+
+Not built. Recipe for when un-deferred:
+
+1. Import the **Material 3** Figma community kit as `Android DS`.
+2. Rebind its colour/type/shape variables to **alias Foundation** (amber DOS) — same mechanism as Web/iOS/macOS.
+3. Add `Android DS` to the platform-sub-library set; snapshot it (`figma-snapshots/android.json`) and extend the Swift/sync tooling if a Kotlin/Compose token target is added.
+4. Keep Material-specific shape/elevation tokens local where they have no Foundation equivalent (mirrors macOS Liquid Glass literals).
+
+## References
+
+- Linear: DMNC-916 (4-tier taxonomy, parent) · DMNC-1001 (this formalization) · DMNC-922 (full colour rationalization) · DMNC-976 (DOSBTS pipeline) · DMNC-596 / DMNC-802 (Apple forks).
+- `CLAUDE.md` → "Figma Design System" for the condensed in-repo version.
+- `figma-snapshots/{foundation-keys,web-ds,ios,macos}.json`, `scripts/sync-figma-to-swift.ts`, `scripts/sync-to-figma.ts`.
+- `solutions/developer-experience/figma-variable-binding-quirks-2026-05-08.md` (opacity/dot-name quirks).

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "eidotter",
-  "version": "0.24.2",
+  "version": "0.26.0",
   "type": "module",
   "description": "A DOS Themed Design System",
   "main": "./dist/index.umd.js",
   "module": "./dist/index.es.js",
   "types": "./dist/index.d.ts",
+  "sideEffects": [
+    "**/*.css",
+    "**/*.scss"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -20,14 +24,25 @@
     "./styles": "./dist/eidotter.css",
     "./utilities": "./src/styles/dos-utilities.css",
     "./tailwind.preset": "./tailwind.preset.cjs",
-    "./tailwind.preset.enhanced": "./tailwind.preset.enhanced.cjs",
     "./fonts.css": "./src/styles/fonts.css",
     "./tokens.css": "./src/styles/tokens.css",
     "./themes/amber-mono.css": "./src/styles/theme.amber-mono.css",
     "./themes/cga-amber.css": "./src/styles/theme.cga-amber.css",
     "./themes/cga-mode4-p0.css": "./src/styles/theme.cga-mode4-p0.css",
     "./themes/cga-mode4-p1.css": "./src/styles/theme.cga-mode4-p1.css",
-    "./themes/cga-mode5.css": "./src/styles/theme.cga-mode5.css"
+    "./themes/cga-mode5.css": "./src/styles/theme.cga-mode5.css",
+    "./icons": {
+      "types": "./dist/icons/published.d.ts",
+      "import": "./dist/icons/published.js"
+    },
+    "./icons/all": {
+      "types": "./dist/icons/index.d.ts",
+      "import": "./dist/icons/index.js"
+    },
+    "./icons/*": {
+      "types": "./dist/icons/components/*.d.ts",
+      "import": "./dist/icons/components/*.js"
+    }
   },
   "files": [
     "dist/index.d.ts",
@@ -35,8 +50,8 @@
     "dist/index.umd.js",
     "dist/eidotter.css",
     "dist/components",
+    "dist/icons",
     "tailwind.preset.cjs",
-    "tailwind.preset.enhanced.cjs",
     "src/styles/fonts.css",
     "src/styles/fonts/Perfect_DOS_VGA_437_Win.ttf",
     "src/styles/fonts/Perfect_DOS_VGA_437_LICENSE.txt",
@@ -49,7 +64,10 @@
   ],
   "scripts": {
     "dev": "vite",
-    "build": "vite build && tsc -p tsconfig.build.json",
+    "build": "vite build && tsc -p tsconfig.build.json && npm run build-icons",
+    "build-icons": "node scripts/icons/build-barrels.mjs && tsc -p tsconfig.icons.json",
+    "fetch-icons": "node scripts/icons/fetch-svgs.mjs",
+    "generate-icons": "node scripts/icons/build-tsx.mjs && node scripts/icons/build-barrels.mjs",
     "prepublishOnly": "npm run build",
     "build-tokens": "node style-dictionary.config.mjs",
     "lint": "eslint src/ --report-unused-disable-directives --max-warnings 0",
@@ -62,6 +80,7 @@
     "test": "jest",
     "create-component": "ts-node scripts/create-component.ts",
     "sync-to-figma": "ts-node scripts/sync-to-figma.ts",
+    "export-figcli-design-md": "ts-node scripts/figcli/export-design-md.ts",
     "sync-figma-to-swift": "ts-node scripts/sync-figma-to-swift.ts",
     "validate-tokens": "node scripts/validate-tokens.cjs"
   },
@@ -109,6 +128,7 @@
     "@storybook/react": "^10.2.7",
     "@storybook/react-vite": "^10.2.7",
     "@storybook/test-runner": "^0.24.3",
+    "@tailwindcss/postcss": "^4.3.0",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.3.0",
@@ -119,7 +139,6 @@
     "@types/react": "^19.1.2",
     "@types/react-dom": "^19.0.0",
     "@vitejs/plugin-react": "^6.0.2",
-    "autoprefixer": "^10.4.27",
     "axe-playwright": "^2.2.2",
     "chromatic": "^16.2.0",
     "cross-env": "^10.1.0",
@@ -138,8 +157,7 @@
     "storybook": "^10.2.7",
     "style-dictionary": "^5.1.1",
     "tailwind-merge": "^3.5.0",
-    "tailwindcss": "^3.4.19",
-    "tailwindcss-animate": "^1.0.7",
+    "tailwindcss": "^4.3.0",
     "tailwindcss-react-aria-components": "^2.0.1",
     "ts-jest": "^29.4.0",
     "ts-node": "^10.9.2",

package/src/styles/theme.amber-mono.css

@@ -29,6 +29,9 @@
   --color-cga-magenta-glow: rgba(255, 85, 255, 0.5); /** Magenta glow at 50% opacity */
   --color-cga-blue-glow: rgba(85, 85, 255, 0.5); /** Blue glow at 50% opacity */
   --color-cga-white-glow: rgba(255, 245, 224, 0.5); /** Warm white glow at 50% opacity */
+  --color-cga-true-green: #00aa00; /** True CGA green — functional success / in-range. */
+  --color-cga-true-red: #aa0000; /** True CGA red — functional error / out-of-range. */
+  --color-cga-true-cyan: #00aaaa; /** True CGA cyan — functional info / sensor. */
   --color-semantic-text-ai-draft: #ff1a8c; /** AI-drafted prose, not yet revised by human — Signalnoise hot pink. Brand-locked hex: same value across all themes so the AI marker is unmissable regardless of palette. Lives in base (T1) so all themes inherit it; the rest of color.semantic.* lives in web.tokens.json (T2). */
   --color-semantic-text-ai-draft-glow: rgba(255, 26, 140, 0.5); /** Phosphor halo around AI-drafted prose. 50% rgba of the aiDraft hex; brand-locked alongside it. Used in text-shadow only; no Tailwind utility. */
   --color-semantic-text-primary: var(--color-cga-amber);

package/src/styles/theme.cga-amber.css

@@ -29,6 +29,9 @@
   --color-cga-magenta-glow: rgba(255, 85, 255, 0.5); /** Magenta glow at 50% opacity */
   --color-cga-blue-glow: rgba(85, 85, 255, 0.5); /** Blue glow at 50% opacity */
   --color-cga-white-glow: rgba(255, 245, 224, 0.5); /** Warm white glow at 50% opacity */
+  --color-cga-true-green: #00aa00; /** True CGA green — functional success / in-range. */
+  --color-cga-true-red: #aa0000; /** True CGA red — functional error / out-of-range. */
+  --color-cga-true-cyan: #00aaaa; /** True CGA cyan — functional info / sensor. */
   --color-semantic-text-ai-draft: #ff1a8c; /** AI-drafted prose, not yet revised by human — Signalnoise hot pink. Brand-locked hex: same value across all themes so the AI marker is unmissable regardless of palette. Lives in base (T1) so all themes inherit it; the rest of color.semantic.* lives in web.tokens.json (T2). */
   --color-semantic-text-ai-draft-glow: rgba(255, 26, 140, 0.5); /** Phosphor halo around AI-drafted prose. 50% rgba of the aiDraft hex; brand-locked alongside it. Used in text-shadow only; no Tailwind utility. */
   --color-semantic-alert-info: #0a1828;

package/src/styles/theme.cga-mode4-p0.css

@@ -29,6 +29,9 @@
   --color-cga-magenta-glow: rgba(255, 85, 255, 0.5); /** Magenta glow at 50% opacity */
   --color-cga-blue-glow: rgba(85, 85, 255, 0.5); /** Blue glow at 50% opacity */
   --color-cga-white-glow: rgba(255, 245, 224, 0.5); /** Warm white glow at 50% opacity */
+  --color-cga-true-green: #00aa00; /** True CGA green — functional success / in-range. */
+  --color-cga-true-red: #aa0000; /** True CGA red — functional error / out-of-range. */
+  --color-cga-true-cyan: #00aaaa; /** True CGA cyan — functional info / sensor. */
   --color-semantic-text-ai-draft: #ff1a8c; /** AI-drafted prose, not yet revised by human — Signalnoise hot pink. Brand-locked hex: same value across all themes so the AI marker is unmissable regardless of palette. Lives in base (T1) so all themes inherit it; the rest of color.semantic.* lives in web.tokens.json (T2). */
   --color-semantic-text-ai-draft-glow: rgba(255, 26, 140, 0.5); /** Phosphor halo around AI-drafted prose. 50% rgba of the aiDraft hex; brand-locked alongside it. Used in text-shadow only; no Tailwind utility. */
   --color-semantic-text-primary: #ffff00;

package/src/styles/theme.cga-mode4-p1.css

@@ -29,6 +29,9 @@
   --color-cga-magenta-glow: rgba(255, 85, 255, 0.5); /** Magenta glow at 50% opacity */
   --color-cga-blue-glow: rgba(85, 85, 255, 0.5); /** Blue glow at 50% opacity */
   --color-cga-white-glow: rgba(255, 245, 224, 0.5); /** Warm white glow at 50% opacity */
+  --color-cga-true-green: #00aa00; /** True CGA green — functional success / in-range. */
+  --color-cga-true-red: #aa0000; /** True CGA red — functional error / out-of-range. */
+  --color-cga-true-cyan: #00aaaa; /** True CGA cyan — functional info / sensor. */
   --color-semantic-text-ai-draft: #ff1a8c; /** AI-drafted prose, not yet revised by human — Signalnoise hot pink. Brand-locked hex: same value across all themes so the AI marker is unmissable regardless of palette. Lives in base (T1) so all themes inherit it; the rest of color.semantic.* lives in web.tokens.json (T2). */
   --color-semantic-text-ai-draft-glow: rgba(255, 26, 140, 0.5); /** Phosphor halo around AI-drafted prose. 50% rgba of the aiDraft hex; brand-locked alongside it. Used in text-shadow only; no Tailwind utility. */
   --color-semantic-text-primary: #fffcf7;

package/src/styles/theme.cga-mode5.css

@@ -29,6 +29,9 @@
   --color-cga-magenta-glow: rgba(255, 85, 255, 0.5); /** Magenta glow at 50% opacity */
   --color-cga-blue-glow: rgba(85, 85, 255, 0.5); /** Blue glow at 50% opacity */
   --color-cga-white-glow: rgba(255, 245, 224, 0.5); /** Warm white glow at 50% opacity */
+  --color-cga-true-green: #00aa00; /** True CGA green — functional success / in-range. */
+  --color-cga-true-red: #aa0000; /** True CGA red — functional error / out-of-range. */
+  --color-cga-true-cyan: #00aaaa; /** True CGA cyan — functional info / sensor. */
   --color-semantic-text-ai-draft: #ff1a8c; /** AI-drafted prose, not yet revised by human — Signalnoise hot pink. Brand-locked hex: same value across all themes so the AI marker is unmissable regardless of palette. Lives in base (T1) so all themes inherit it; the rest of color.semantic.* lives in web.tokens.json (T2). */
   --color-semantic-text-ai-draft-glow: rgba(255, 26, 140, 0.5); /** Phosphor halo around AI-drafted prose. 50% rgba of the aiDraft hex; brand-locked alongside it. Used in text-shadow only; no Tailwind utility. */
   --color-semantic-text-primary: #fffcf7;

package/src/styles/tokens.css

@@ -29,6 +29,9 @@
   --color-cga-magenta-glow: rgba(255, 85, 255, 0.5); /** Magenta glow at 50% opacity */
   --color-cga-blue-glow: rgba(85, 85, 255, 0.5); /** Blue glow at 50% opacity */
   --color-cga-white-glow: rgba(255, 245, 224, 0.5); /** Warm white glow at 50% opacity */
+  --color-cga-true-green: #00aa00; /** True CGA green — functional success / in-range. */
+  --color-cga-true-red: #aa0000; /** True CGA red — functional error / out-of-range. */
+  --color-cga-true-cyan: #00aaaa; /** True CGA cyan — functional info / sensor. */
   --color-semantic-text-ai-draft: #ff1a8c; /** AI-drafted prose, not yet revised by human — Signalnoise hot pink. Brand-locked hex: same value across all themes so the AI marker is unmissable regardless of palette. Lives in base (T1) so all themes inherit it; the rest of color.semantic.* lives in web.tokens.json (T2). */
   --color-semantic-text-ai-draft-glow: rgba(255, 26, 140, 0.5); /** Phosphor halo around AI-drafted prose. 50% rgba of the aiDraft hex; brand-locked alongside it. Used in text-shadow only; no Tailwind utility. */
   --color-semantic-alert-info: #1f2228; /** Warm dark blue for info alerts */
@@ -174,6 +177,12 @@
   --effect-web-power-brightness-warmup-mid: 0.6; /** Warmup-mid brightness (web-only). */
   --effect-web-power-duration-off: 400ms; /** Web-only power-off animation duration. Apple platforms have own timing curves. */
   --effect-web-power-duration-on: 600ms; /** Web-only power-on animation duration. */
+  --motion-duration-warmup: 400ms; /** phosphor-warmup — CRT ignition brightness flicker on hover entry. Matches var(--duration-slow) at the Button call site. */
+  --motion-duration-energize: 150ms; /** phosphor-energize — brightness flash on press / check. */
+  --motion-duration-blink: 1000ms; /** blink — cursor / indicator blink cycle (paired with the stepped easing). */
+  --motion-easing-warmup: ease-out; /** phosphor-warmup easing. */
+  --motion-easing-energize: ease-out; /** phosphor-energize easing (runs forwards). */
+  --motion-easing-blink: step-end; /** blink easing — hard step, no interpolation (terminal cursor). */
   --color-semantic-text-primary: var(--color-cga-light-gray);
   --color-semantic-text-secondary: var(--color-cga-black);
   --color-semantic-text-accent: var(--color-cga-yellow);

package/tailwind.preset.enhanced.cjs

@@ -1,29 +0,0 @@
-/**
- * Deprecated alias for `eidotter/tailwind.preset`.
- *
- * REMOVE-IN-0.21.0 — grep this marker when preparing the 0.21.0 release to
- * delete this file, the `./tailwind.preset.enhanced` entry in `package.json`
- * `exports`, and the matching entry in `files`.
- *
- * @note Hand-written — NOT generated by `style-dictionary.config.mjs`.
- *       The sibling `tailwind.preset.cjs` IS generated; do not confuse them.
- *
- * In v0.19.2, the base and enhanced presets were merged (#282). The single
- * `tailwind.preset` now includes all design tokens plus React Aria state
- * variants and the animate plugin. This file is a shim so existing consumers
- * don't break on upgrade.
- *
- * Migration:
- *   - presets: [require('eidotter/tailwind.preset.enhanced')]
- *   + presets: [require('eidotter/tailwind.preset')]
- */
-
-if (!globalThis.__eidotterEnhancedPresetDeprecationWarned) {
-  globalThis.__eidotterEnhancedPresetDeprecationWarned = true;
-  console.warn(
-    "[eidotter] 'eidotter/tailwind.preset.enhanced' is deprecated since 0.19.2 " +
-      "and will be removed in 0.21.0. Use 'eidotter/tailwind.preset' instead."
-  );
-}
-
-module.exports = require('./tailwind.preset.cjs');