eidotter 0.40.2 → 0.41.1

package/migrations/README.md

@@ -0,0 +1,46 @@
+# eidotter migration guides
+
+This folder holds one upgrade guide per eidotter release that has breaking or
+visible changes for consumers. The guides are written for developers and AI
+agents working in a consuming app who have not seen the eidotter repository.
+
+## Naming
+
+- `<version>.md`, for example `0.41.0.md`: one guide per minor (or major) whose
+  changes a consumer can see or must act on.
+- Patch releases and purely additive minors get no guide. Their notes are in
+  the [CHANGELOG](https://github.com/CinimoDY/eiDotter/blob/main/CHANGELOG.md).
+- A guide is written before its release is published, so it ships in that
+  version's npm package.
+
+## How to use them
+
+1. Find your installed version (`npm ls eidotter`) and your target version.
+2. Read every guide whose version is greater than your installed version and
+   less than or equal to your target, oldest first. Each guide covers only the
+   step from the previous minor.
+3. Each guide has the same shape: who must act, how to bump, breaking and
+   visible changes (each with what changed, how to find it, what to do, how to
+   verify), new pieces to adopt, an ordered checklist, and pointers for
+   consumers jumping several versions.
+
+Remember the 0.x caret rule: `^0.40.2` never resolves to 0.41.0. Bump the range
+explicitly.
+
+## Where to find them
+
+The folder ships in the npm package:
+
+```
+node_modules/eidotter/migrations/README.md
+node_modules/eidotter/migrations/0.41.0.md
+```
+
+It is also exported, so tooling can resolve a guide by path:
+`require.resolve('eidotter/migrations/0.41.0.md')`.
+
+## Guides
+
+| Version | Summary |
+|---|---|
+| [0.41.0](./0.41.0.md) | 16px floor, CSS reset and unused utilities no longer leak, `text-secondary` meaning change, Header lockup default, overlays on `DosDialog` (removed classes), focus rings; adopt `IconButton`, `DosDialog`, `DosWindow`, the favicon export and the `amber-paper` theme |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eidotter",
-  "version": "0.40.2",
+  "version": "0.41.1",
   "type": "module",
   "description": "A DOS Themed Design System",
   "main": "./dist/index.umd.js",
@@ -29,6 +29,7 @@
     "./utilities": "./src/styles/dos-utilities.css",
     "./tailwind.preset": "./tailwind.preset.cjs",
     "./favicon.svg": "./public/favicon.svg",
+    "./migrations/*": "./migrations/*",
     "./fonts.css": "./src/styles/fonts.css",
     "./tokens.css": "./src/styles/tokens.css",
     "./shadcn.css": "./src/styles/shadcn.css",
@@ -38,6 +39,7 @@
     "./themes/cga-mode4-p1.css": "./src/styles/theme.cga-mode4-p1.css",
     "./themes/cga-mode5.css": "./src/styles/theme.cga-mode5.css",
     "./themes/light.css": "./src/styles/theme.light.css",
+    "./themes/amber-paper.css": "./src/styles/theme.amber-paper.css",
     "./icons": {
       "types": "./dist/icons/published.d.ts",
       "import": "./dist/icons/published.js"
@@ -75,6 +77,7 @@
     "src/styles/shadcn.css",
     "src/styles/dos-utilities.css",
     "guidelines",
+    "migrations",
     "llms.txt"
   ],
   "scripts": {
@@ -85,7 +88,7 @@
     "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 && node scripts/generate-shadcn-shim.mjs",
+    "build-tokens": "node style-dictionary.config.mjs && node scripts/generate-shadcn-shim.mjs && node scripts/generate-tailwind-safelist.mjs",
     "lint": "eslint src/ --report-unused-disable-directives --max-warnings 0",
     "lint-tokens": "node scripts/lint-token-refs.mjs",
     "check-contrast": "node scripts/check-contrast.mjs",
@@ -100,7 +103,10 @@
     "sync-figma-to-swift": "ts-node scripts/sync-figma-to-swift.ts",
     "fetch-figma-snapshot": "ts-node scripts/fetch-figma-snapshot.ts",
     "publish-figma-library": "ts-node scripts/publish-figma-library.ts",
-    "validate-tokens": "node scripts/validate-tokens.cjs"
+    "validate-tokens": "node scripts/validate-tokens.cjs",
+    "extract-code-contract": "tsx scripts/contracts/extract-code-contract.cli.ts",
+    "extract-figma-contract": "tsx scripts/contracts/extract-figma-contract.cli.ts",
+    "diff-contracts": "tsx scripts/contracts/diff-contracts.cli.ts"
   },
   "repository": {
     "type": "git",
@@ -180,7 +186,9 @@
     "tailwindcss": "^4.3.0",
     "tailwindcss-react-aria-components": "^2.0.1",
     "ts-jest": "^29.4.0",
+    "ts-morph": "^28.0.0",
     "ts-node": "^10.9.2",
+    "tsx": "^4.23.1",
     "typescript": "^5.7.3",
     "typescript-eslint": "^8.54.0",
     "vite": "^8.0.10"

package/public/favicon.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="8 7 22 22" width="32" height="32"><defs> <radialGradient id="h" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(19 19.1) scale(13.2)"> <stop stop-color="#FFB000" stop-opacity="0.3" /> <stop offset="1" stop-color="#020003" stop-opacity="0" /> </radialGradient> <radialGradient id="c" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(19 18.9) scale(9.9)"> <stop stop-color="#FFB000" stop-opacity="0.45" /> <stop offset="0.6" stop-color="#9A5700" stop-opacity="0.22" /> <stop offset="1" stop-color="#020003" stop-opacity="0" /> </radialGradient> </defs> <path d="M19 29C25.0751 29 30 24.0751 30 18C30 11.9249 25.0751 7 19 7C12.9249 7 8 11.9249 8 18C8 24.0751 12.9249 29 19 29Z" fill="url(#h)" /> <path d="M19 27C23.9706 27 28 22.9706 28 18C28 13.0294 23.9706 9 19 9C14.0294 9 10 13.0294 10 18C10 22.9706 14.0294 27 19 27Z" fill="url(#c)" /> <path d="M20.375 9.0625H17.625V9.75H20.375V9.0625Z" fill="#FFB000" /> <path d="M16.9375 9.75H15.5625V10.4375H16.9375V9.75Z" fill="#FFB000" /> <path d="M17.625 9.75H16.9375V10.4375H17.625V9.75Z" fill="#FFB000" /> <path d="M22.4375 9.75H20.375V10.4375H22.4375V9.75Z" fill="#FFB000" /> <path d="M15.5625 10.4375H14.1875V11.125H15.5625V10.4375Z" fill="#FFB000" /> <path d="M23.8125 10.4375H22.4375V11.125H23.8125V10.4375Z" fill="#FFB000" /> <path d="M14.1875 11.125H13.5V11.8125H14.1875V11.125Z" fill="#FFB000" /> <path d="M25.1875 11.125H23.8125V11.8125H25.1875V11.125Z" fill="#FFB000" /> <path d="M13.5 11.8125H12.8125V12.5H13.5V11.8125Z" fill="#FFB000" /> <path d="M25.875 11.8125H25.1875V13.1875H25.875V11.8125Z" fill="#FFB000" /> <path d="M12.8125 12.5H12.125V13.875H12.8125V12.5Z" fill="#FFB000" /> <path d="M12.125 13.875H11.4375V15.9375H12.125V13.875Z" fill="#FFB000" /> <path d="M11.4375 15.9375H10.75V18H11.4375V15.9375Z" fill="#FFB000" /> <path d="M10.75 18H10.0625V19.375H10.75V18Z" fill="#FFB000" /> <path d="M11.4375 19.375H10.75V20.75H11.4375V19.375Z" fill="#FFB000" /> <path d="M12.125 20.75H11.4375V22.125H12.125V20.75Z" fill="#FFB000" /> <path d="M12.8125 22.125H12.125V23.5H12.8125V22.125Z" fill="#FFB000" /> <path d="M26.5625 13.1875H25.875V15.25H26.5625V13.1875Z" fill="#FFB000" /> <path d="M27.25 15.25H26.5625V17.3125H27.25V15.25Z" fill="#FFB000" /> <path d="M27.9375 17.3125H27.25V19.375H27.9375V17.3125Z" fill="#FFB000" /> <path d="M27.25 19.375H26.5625V20.75H27.25V19.375Z" fill="#FFB000" /> <path d="M26.5625 20.75H25.875V22.125H26.5625V20.75Z" fill="#FFB000" /> <path d="M25.875 22.125H25.1875V23.5H25.875V22.125Z" fill="#FFB000" /> <path d="M14.1875 23.5H12.8125V24.1875H14.1875V23.5Z" fill="#FFB000" /> <path d="M16.25 24.1875H14.1875V24.875H16.25V24.1875Z" fill="#FFB000" /> <path d="M18.3125 24.875H16.25V25.5625H18.3125V24.875Z" fill="#FFB000" /> <path d="M20.375 25.5625H18.3125V26.25H20.375V25.5625Z" fill="#FFB000" /> <path d="M22.4375 24.875H20.375V25.5625H22.4375V24.875Z" fill="#FFB000" /> <path d="M24.5 24.1875H22.4375V24.875H24.5V24.1875Z" fill="#FFB000" /> <path d="M25.1875 23.5H24.5V24.1875H25.1875V23.5Z" fill="#FFB000" /> <path d="M10.0625 15.9375H9.375V16.625H10.0625V15.9375Z" fill="#FFB000" /> <path d="M29.3125 16.625H28.625V17.3125H29.3125V16.625Z" fill="#FFB000" /> <path d="M28.625 20.75H27.9375V21.4375H28.625V20.75Z" fill="#FFB000" /> <path d="M10.75 21.4375H10.0625V22.125H10.75V21.4375Z" fill="#FFB000" /> <path d="M18.4375 21C20.6466 21 22.4375 19.2091 22.4375 17C22.4375 14.7909 20.6466 13 18.4375 13C16.2284 13 14.4375 14.7909 14.4375 17C14.4375 19.2091 16.2284 21 18.4375 21Z" fill="#FFB000" /> <path d="M16.25 15.25H15.5625V17.3125H16.25V15.25Z" fill="#FFC233" /> <path d="M18.3125 13.875H16.25V14.5625H18.3125V13.875Z" fill="#FFC233" /> <path d="M16.25 14.5625H15.5625V15.25H16.25V14.5625Z" fill="#FFC233" /> <path d="M17.5 17C18.3284 17 19 16.3284 19 15.5C19 14.6716 18.3284 14 17.5 14C16.6716 14 16 14.6716 16 15.5C16 16.3284 16.6716 17 17.5 17Z" fill="#FFD97A" /> <path d="M17.5 15C17.7761 15 18 14.7761 18 14.5C18 14.2239 17.7761 14 17.5 14C17.2239 14 17 14.2239 17 14.5C17 14.7761 17.2239 15 17.5 15Z" fill="#FFE8A8" /></svg>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="8 7 22 22" width="32" height="32"><defs> <radialGradient id="h" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(19 19.1) scale(13.2)"> <stop stop-color="#FFB000" stop-opacity="0.3" /> <stop offset="1" stop-color="#020003" stop-opacity="0" /> </radialGradient> <radialGradient id="c" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(19 18.9) scale(9.9)"> <stop stop-color="#FFB000" stop-opacity="0.45" /> <stop offset="0.6" stop-color="#9A5700" stop-opacity="0.22" /> <stop offset="1" stop-color="#020003" stop-opacity="0" /> </radialGradient> <radialGradient id="y" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(16.9 15.5) scale(5.6)"> <stop stop-color="#FFD97A" /> <stop offset="0.55" stop-color="#FFB000" /> <stop offset="1" stop-color="#B87C00" /> </radialGradient> </defs> <path d="M19 29C25.0751 29 30 24.0751 30 18C30 11.9249 25.0751 7 19 7C12.9249 7 8 11.9249 8 18C8 24.0751 12.9249 29 19 29Z" fill="url(#h)" /> <path d="M19 27C23.9706 27 28 22.9706 28 18C28 13.0294 23.9706 9 19 9C14.0294 9 10 13.0294 10 18C10 22.9706 14.0294 27 19 27Z" fill="url(#c)" /> <path d="M20.375 9.0625H17.625V9.75H20.375V9.0625Z" fill="#FFB000" /> <path d="M16.9375 9.75H15.5625V10.4375H16.9375V9.75Z" fill="#FFB000" /> <path d="M17.625 9.75H16.9375V10.4375H17.625V9.75Z" fill="#FFB000" /> <path d="M22.4375 9.75H20.375V10.4375H22.4375V9.75Z" fill="#FFB000" /> <path d="M15.5625 10.4375H14.1875V11.125H15.5625V10.4375Z" fill="#FFB000" /> <path d="M23.8125 10.4375H22.4375V11.125H23.8125V10.4375Z" fill="#FFB000" /> <path d="M14.1875 11.125H13.5V11.8125H14.1875V11.125Z" fill="#FFB000" /> <path d="M25.1875 11.125H23.8125V11.8125H25.1875V11.125Z" fill="#FFB000" /> <path d="M13.5 11.8125H12.8125V12.5H13.5V11.8125Z" fill="#FFB000" /> <path d="M25.875 11.8125H25.1875V13.1875H25.875V11.8125Z" fill="#FFB000" /> <path d="M12.8125 12.5H12.125V13.875H12.8125V12.5Z" fill="#FFB000" /> <path d="M12.125 13.875H11.4375V15.9375H12.125V13.875Z" fill="#FFB000" /> <path d="M11.4375 15.9375H10.75V18H11.4375V15.9375Z" fill="#FFB000" /> <path d="M10.75 18H10.0625V19.375H10.75V18Z" fill="#FFB000" /> <path d="M11.4375 19.375H10.75V20.75H11.4375V19.375Z" fill="#FFB000" /> <path d="M12.125 20.75H11.4375V22.125H12.125V20.75Z" fill="#FFB000" /> <path d="M12.8125 22.125H12.125V23.5H12.8125V22.125Z" fill="#FFB000" /> <path d="M26.5625 13.1875H25.875V15.25H26.5625V13.1875Z" fill="#FFB000" /> <path d="M27.25 15.25H26.5625V17.3125H27.25V15.25Z" fill="#FFB000" /> <path d="M27.9375 17.3125H27.25V19.375H27.9375V17.3125Z" fill="#FFB000" /> <path d="M27.25 19.375H26.5625V20.75H27.25V19.375Z" fill="#FFB000" /> <path d="M26.5625 20.75H25.875V22.125H26.5625V20.75Z" fill="#FFB000" /> <path d="M25.875 22.125H25.1875V23.5H25.875V22.125Z" fill="#FFB000" /> <path d="M14.1875 23.5H12.8125V24.1875H14.1875V23.5Z" fill="#FFB000" /> <path d="M16.25 24.1875H14.1875V24.875H16.25V24.1875Z" fill="#FFB000" /> <path d="M18.3125 24.875H16.25V25.5625H18.3125V24.875Z" fill="#FFB000" /> <path d="M20.375 25.5625H18.3125V26.25H20.375V25.5625Z" fill="#FFB000" /> <path d="M22.4375 24.875H20.375V25.5625H22.4375V24.875Z" fill="#FFB000" /> <path d="M24.5 24.1875H22.4375V24.875H24.5V24.1875Z" fill="#FFB000" /> <path d="M25.1875 23.5H24.5V24.1875H25.1875V23.5Z" fill="#FFB000" /> <path d="M10.0625 15.9375H9.375V16.625H10.0625V15.9375Z" fill="#FFB000" /> <path d="M29.3125 16.625H28.625V17.3125H29.3125V16.625Z" fill="#FFB000" /> <path d="M28.625 20.75H27.9375V21.4375H28.625V20.75Z" fill="#FFB000" /> <path d="M10.75 21.4375H10.0625V22.125H10.75V21.4375Z" fill="#FFB000" /> <path d="M18.4375 21C20.6466 21 22.4375 19.2091 22.4375 17C22.4375 14.7909 20.6466 13 18.4375 13C16.2284 13 14.4375 14.7909 14.4375 17C14.4375 19.2091 16.2284 21 18.4375 21Z" fill="url(#y)" /> <path d="M16.25 15.25H15.5625V17.3125H16.25V15.25Z" fill="#FFE8A8" opacity="0.8" /> <path d="M18.3125 13.875H16.25V14.5625H18.3125V13.875Z" fill="#FFE8A8" opacity="0.8" /> <path d="M17.5 15C17.7761 15 18 14.7761 18 14.5C18 14.2239 17.7761 14 17.5 14C17.2239 14 17 14.2239 17 14.5C17 14.7761 17.2239 15 17.5 15Z" fill="#FFFFFF" opacity="0.9" /> </svg>

package/src/styles/dos-utilities.css

@@ -43,6 +43,14 @@
   font-synthesis: none;
 }
 
+/* Text floor (DMNC-1579): body text, labels and controls never render below 16px
+ * (--typography-font-size-text-base, Tailwind text-dos-text-base). The DOS VGA font's native cell
+ * is 9x16, so 16px is the authentic size. The preset aliases Tailwind text-xs/text-sm to the same
+ * 1rem. Named exceptions, and the only ones: em-relative secondary glyphs that scale with their
+ * parent (CalendarHeatmap day labels 0.6em, ProgressRing centre label 0.5em, Stat/VitalsStrip unit
+ * suffix 0.5em of the display-size value). LegalPage sits on the floor since DMNC-1610.
+ */
+
 /* Body tier — JetBrains Mono Nerd Font (multi-weight; includes Nerd Font glyphs).
  * Uses --typography-font-family-body and real body-weight tokens (DMNC-885). */
 :where(
@@ -193,7 +201,7 @@
  * Accessibility
  * ========================================================================== */
 
-@media (prefers-contrast: high) {
+@media (prefers-contrast: high), (prefers-contrast: more) {
   .dos-hero,
   .dos-h1,
   .dos-h2,

package/src/styles/shadcn.css

@@ -8,8 +8,9 @@
  * then delete your own :root/.dark/etc. colour definitions. Re-themes via
  * [data-theme]. Opt-in — NOT part of eidotter/styles.
  *
- * sidebar-* and chart-* are best-effort amber-family aliases; override per
- * surface for real sidebar/data-viz needs.
+ * sidebar-* are best-effort aliases of the core roles; chart-* are five
+ * series chosen per theme (>=3:1 on --background, pairwise distinct).
+ * Override per surface for real sidebar/data-viz needs.
  * ========================================================================== */
 
 :root {
@@ -41,10 +42,10 @@
   --sidebar-border: 37 75% 41%;
   --sidebar-ring: 45 77% 55%;
   --chart-1: 41 100% 50%;
-  --chart-2: 34 100% 30%;
-  --chart-3: 45 77% 55%;
-  --chart-4: 41 100% 50%;
-  --chart-5: 37 75% 41%;
+  --chart-2: 37 75% 41%;
+  --chart-3: 27 96% 81%;
+  --chart-4: 40 66% 48%;
+  --chart-5: 34 100% 30%;
 }
 
 [data-theme="amber-mono"], .theme-amber-mono {
@@ -66,7 +67,7 @@
   --destructive-foreground: 0 0% 100%;
   --border: 41 100% 50%;
   --input: 41 100% 50%;
-  --ring: 27 96% 81%;
+  --ring: 41 100% 50%;
   --sidebar: 280 100% 1%;
   --sidebar-foreground: 41 100% 50%;
   --sidebar-primary: 41 100% 50%;
@@ -74,12 +75,12 @@
   --sidebar-accent: 240 50% 1%;
   --sidebar-accent-foreground: 41 100% 50%;
   --sidebar-border: 41 100% 50%;
-  --sidebar-ring: 27 96% 81%;
+  --sidebar-ring: 41 100% 50%;
   --chart-1: 41 100% 50%;
   --chart-2: 37 75% 41%;
   --chart-3: 27 96% 81%;
-  --chart-4: 41 100% 50%;
-  --chart-5: 41 100% 50%;
+  --chart-4: 40 66% 48%;
+  --chart-5: 34 100% 30%;
 }
 
 [data-theme="cga-amber"], .theme-cga-amber {
@@ -96,7 +97,7 @@
   --muted: 48 5% 22%;
   --muted-foreground: 30 100% 33%;
   --accent: 240 100% 33%;
-  --accent-foreground: 36 100% 1%;
+  --accent-foreground: 38 100% 98%;
   --destructive: 0 100% 33%;
   --destructive-foreground: 0 0% 100%;
   --border: 37 5% 66%;
@@ -111,9 +112,9 @@
   --sidebar-border: 37 5% 66%;
   --sidebar-ring: 41 100% 50%;
   --chart-1: 41 100% 50%;
-  --chart-2: 30 100% 33%;
-  --chart-3: 41 100% 50%;
-  --chart-4: 240 100% 33%;
+  --chart-2: 180 100% 67%;
+  --chart-3: 300 100% 67%;
+  --chart-4: 120 100% 67%;
   --chart-5: 37 5% 66%;
 }
 
@@ -146,10 +147,10 @@
   --sidebar-border: 120 100% 50%;
   --sidebar-ring: 60 100% 50%;
   --chart-1: 60 100% 50%;
-  --chart-2: 60 100% 50%;
-  --chart-3: 60 100% 50%;
-  --chart-4: 120 100% 50%;
-  --chart-5: 60 100% 50%;
+  --chart-2: 120 100% 50%;
+  --chart-3: 0 100% 50%;
+  --chart-4: 180 100% 33%;
+  --chart-5: 0 0% 100%;
 }
 
 [data-theme="cga-mode4-p1"], .theme-cga-mode4-p1 {
@@ -181,10 +182,10 @@
   --sidebar-border: 180 100% 50%;
   --sidebar-ring: 38 100% 98%;
   --chart-1: 180 100% 50%;
-  --chart-2: 38 100% 98%;
+  --chart-2: 300 100% 50%;
   --chart-3: 38 100% 98%;
-  --chart-4: 180 100% 50%;
-  --chart-5: 38 100% 98%;
+  --chart-4: 120 100% 33%;
+  --chart-5: 0 100% 67%;
 }
 
 [data-theme="cga-mode5"], .theme-cga-mode5 {
@@ -216,10 +217,10 @@
   --sidebar-border: 180 100% 50%;
   --sidebar-ring: 38 100% 98%;
   --chart-1: 180 100% 50%;
-  --chart-2: 38 100% 98%;
+  --chart-2: 0 100% 50%;
   --chart-3: 38 100% 98%;
-  --chart-4: 180 100% 50%;
-  --chart-5: 38 100% 98%;
+  --chart-4: 120 100% 33%;
+  --chart-5: 180 100% 33%;
 }
 
 [data-theme="light"], .theme-light {
@@ -250,9 +251,44 @@
   --sidebar-accent-foreground: 33 17% 10%;
   --sidebar-border: 40 18% 80%;
   --sidebar-ring: 34 100% 30%;
-  --chart-1: 41 100% 50%;
+  --chart-1: 34 100% 30%;
   --chart-2: 39 8% 40%;
-  --chart-3: 34 100% 30%;
-  --chart-4: 41 100% 50%;
+  --chart-3: 34 100% 24%;
+  --chart-4: 28 74% 21%;
   --chart-5: 33 17% 10%;
 }
+
+[data-theme="amber-paper"], .theme-amber-paper {
+  --background: 41 100% 50%;
+  --foreground: 280 100% 1%;
+  --card: 42 100% 45%;
+  --card-foreground: 280 100% 1%;
+  --popover: 42 100% 45%;
+  --popover-foreground: 280 100% 1%;
+  --primary: 280 100% 1%;
+  --primary-foreground: 41 100% 50%;
+  --secondary: 42 100% 45%;
+  --secondary-foreground: 280 100% 1%;
+  --muted: 42 100% 45%;
+  --muted-foreground: 28 74% 21%;
+  --accent: 280 100% 1%;
+  --accent-foreground: 41 100% 50%;
+  --destructive: 28 74% 21%;
+  --destructive-foreground: 41 100% 50%;
+  --border: 280 100% 1%;
+  --input: 280 100% 1%;
+  --ring: 280 100% 1%;
+  --sidebar: 41 100% 50%;
+  --sidebar-foreground: 280 100% 1%;
+  --sidebar-primary: 280 100% 1%;
+  --sidebar-primary-foreground: 41 100% 50%;
+  --sidebar-accent: 42 100% 45%;
+  --sidebar-accent-foreground: 280 100% 1%;
+  --sidebar-border: 280 100% 1%;
+  --sidebar-ring: 280 100% 1%;
+  --chart-1: 280 100% 1%;
+  --chart-2: 25 83% 14%;
+  --chart-3: 28 74% 21%;
+  --chart-4: 34 100% 24%;
+  --chart-5: 0 100% 33%;
+}

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

@@ -41,7 +41,9 @@
   --color-semantic-text-ai-gradient-from-light: #c0228a; /** AI-marker gradient start under light themes ([data-theme=light]/.light) — deep magenta, contrast on white. Static, brand-locked. Gradient-only; no Tailwind utility (DMNC-946). */
   --color-semantic-text-ai-gradient-to-light: #7a3cc0; /** AI-marker gradient end under light themes — violet, contrast on white. Static, brand-locked. Gradient-only; no Tailwind utility (DMNC-946). */
   --color-semantic-text-primary: var(--color-cga-amber);
-  --color-semantic-text-secondary: var(--color-cga-black);
+  --color-semantic-text-secondary: var(--color-cga-light-gray); /** DMNC-1494: visible de-emphasised tone on dark backgrounds. For dark text on an amber fill use `text.onAccent`. */
+  --color-semantic-text-on-accent: var(--color-cga-black); /** DMNC-1494: dark text/icon sitting on an accent (amber) fill. Was the value of `text.secondary`. */
+  --color-semantic-text-on-light: var(--color-cga-black); /** DMNC-1494: near-black text/icon for an unfilled element sitting on a light surface (e.g. Nav modern links). Near-black in every theme, unlike `text.onAccent`, which follows the accent fill. */
   --color-semantic-text-accent: var(--color-cga-yellow);
   --color-semantic-text-disabled: var(--color-cga-amber-dim);
   --color-semantic-text-muted: var(--color-cga-light-gray);
@@ -53,7 +55,7 @@
   --color-semantic-background-accent: var(--color-cga-amber);
   --color-semantic-background-error: var(--color-cga-amber-dim); /** DMNC-1059: amber-mono is the DEFAULT theme — functional roles must NOT leak the honest :root red/green. Destructive fill uses dark amberDim so the white foreground keeps contrast (honest #AA0000 fill only appears under colour themes, e.g. cga-amber / the Modern theme DMNC-1058). */
   --color-semantic-border-default: var(--color-cga-amber);
-  --color-semantic-border-focus: var(--color-cga-amber-bright);
+  --color-semantic-border-focus: var(--color-cga-amber);
   --color-semantic-border-hover: var(--color-cga-yellow);
   --color-semantic-border-disabled: var(--color-cga-amber-dim);
   --color-semantic-border-success: var(--color-cga-amber-bright); /** DMNC-1059: amber-mono default — success border is amber, not honest green. */

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

@@ -0,0 +1,106 @@
+/**
+ * Do not edit directly, this file was auto-generated.
+ */
+
+[data-theme="amber-paper"], .theme-amber-paper {
+  --color-cga-black: #ffb000; /** Reverse video: the darkest CGA value becomes the amber ground. */
+  --color-cga-blue: #2c1203; /** Amber monochrome */
+  --color-cga-green: #411f06; /** Amber monochrome */
+  --color-cga-cyan: #552d0a; /** Amber monochrome */
+  --color-cga-red: #65360c; /** Amber monochrome */
+  --color-cga-magenta: #713e0d; /** Amber monochrome */
+  --color-cga-brown: #5f340e; /** Amber monochrome */
+  --color-cga-light-gray: #5f340e; /** Reverse video: tan body tone becomes dark brown (5.8:1 on ground). */
+  --color-cga-dark-gray: #e6a000; /** Reverse video: raised/secondary surface, a slightly darker amber shade. */
+  --color-cga-bright-blue: #2c1203;
+  --color-cga-bright-green: #2c1203;
+  --color-cga-bright-cyan: #2c1203;
+  --color-cga-bright-red: #2c1203;
+  --color-cga-bright-magenta: #2c1203;
+  --color-cga-yellow: #020003; /** Reverse video: accent yellow becomes ink. */
+  --color-cga-white: #2c1203; /** Reverse video: hover/emphasis tone becomes a deep brown. */
+  --color-cga-amber: #020003; /** Reverse video: amber ink becomes near-black. */
+  --color-cga-amber-bright: #1a1000; /** Reverse video: hover/active peaks go darker, not lighter. */
+  --color-cga-amber-dim: #7a4500; /** Reverse video: dim amber becomes mid brown (4.3:1 on ground, 3.5:1 on shade). */
+  --color-cga-amber-glow: rgba(0, 0, 0, 0); /** Reverse video has no phosphor bloom: transparent, so raw amber-glow rules render nothing. */
+  --color-cga-red-glow: rgba(255, 85, 85, 0.5); /** Red glow at 50% opacity */
+  --color-cga-green-glow: rgba(85, 255, 85, 0.5); /** Green glow at 50% opacity */
+  --color-cga-cyan-glow: rgba(85, 255, 255, 0.5); /** Cyan glow at 50% opacity */
+  --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-cga-true-white: #ffffff; /** True CGA white — theme-invariant light foreground for functional fills (white-on-red destructive, white-on-green success). #FFFFFF on cga-true.red #AA0000 is ~5.9:1 (passes WCAG AA). DMNC-922. */
+  --color-cga-true-red-bright: #ff5555; /** True CGA bright red — theme-invariant. The readable-as-TEXT-on-dark red (#FF5555 on the #020003 CRT bg passes AA, where the solid #AA0000 is only ~2.3:1). Use for error TEXT/icons on dark; use the solid `red` for fills. DMNC-922. */
+  --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-ai-gradient-from: #ff1a8c; /** AI-marker gradient start on amber/dark themes (Signalnoise pink). Static two-stop magenta gradient ('AI writer' style — no animation) clipped to the text in provenance.css; brand-locked; no Tailwind utility (DMNC-946). */
+  --color-semantic-text-ai-gradient-to: #ff55ff; /** AI-marker gradient end on amber/dark themes (bright magenta). Static, brand-locked. Gradient-only; no Tailwind utility (DMNC-946). */
+  --color-semantic-text-ai-gradient-from-light: #c0228a; /** AI-marker gradient start under light themes ([data-theme=light]/.light) — deep magenta, contrast on white. Static, brand-locked. Gradient-only; no Tailwind utility (DMNC-946). */
+  --color-semantic-text-ai-gradient-to-light: #7a3cc0; /** AI-marker gradient end under light themes — violet, contrast on white. Static, brand-locked. Gradient-only; no Tailwind utility (DMNC-946). */
+  --color-semantic-text-primary: #020003; /** Black ink body text (11.4:1 on ground). */
+  --color-semantic-text-secondary: #5f340e; /** DMNC-1494: visible de-emphasised tone on the amber ground (5.8:1). For text on a black fill use text.onAccent. */
+  --color-semantic-text-on-accent: #ffb000; /** DMNC-1494: text/icon on an accent (black) fill, amber. */
+  --color-semantic-text-on-light: #020003; /** DMNC-1494: near-black text/icon for an unfilled element sitting on a light surface (e.g. Nav modern links); the amber ground is the light surface here (11.4:1 on ground, 9.4:1 on shade). */
+  --color-semantic-text-accent: #1a1000; /** Accent text, near-black ink (10.3:1 on ground). Reverse video: where the default accent is brighter than amber, here it is the darker peak; distinct from background.brand so the shadcn chart ramp stays five distinct colours (DMNC-1436). */
+  --color-semantic-text-disabled: #7a4500; /** Disabled text/icon, mid brown, at least 3:1 on ground and shade. */
+  --color-semantic-text-muted: #5f340e; /** Muted supplementary text, dark brown (5.8:1 ground, 4.7:1 shade). */
+  --color-semantic-text-tertiary: #5f340e; /** Third-emphasis text, same as muted. */
+  --color-semantic-text-brand: #020003; /** Brand text, ink. */
+  --color-semantic-text-brand-bright: #1a1000; /** Brand emphasis text (hover/active peaks), near-black; reverse video peaks go darker. */
+  --color-semantic-text-on-brand: #ffb000; /** Text/icon on a black brand fill, amber. */
+  --color-semantic-text-error: #020003; /** Monochrome error text, ink (pair with icon/pattern, never colour alone). */
+  --color-semantic-text-warning: #411f06; /** Monochrome warning text, deep brown. */
+  --color-semantic-text-success: #2c1203; /** Monochrome success text, deep brown. */
+  --color-semantic-text-info: #5f340e; /** Monochrome info text, dark brown. */
+  --color-semantic-text-white: #ffb000; /** Light foreground for functional (dark) fills; in reverse video the light tone is the amber ground. */
+  --color-semantic-background-primary: #ffb000; /** Amber page ground. */
+  --color-semantic-background-secondary: #e6a000; /** Raised/card surface, slightly darker amber. */
+  --color-semantic-background-tertiary: #e6a000; /** Third surface level (same as secondary, mirrors the default). */
+  --color-semantic-background-accent: #020003; /** Accent fill: what was an amber fill is black ink. Pair with text.onAccent (amber). */
+  --color-semantic-background-brand: #020003; /** Brand fill (e.g. primary button), black. Pair with text.onBrand. */
+  --color-semantic-background-brand-bright: #2c1203; /** Brand emphasis fill (hover/active), deep brown, visibly distinct from the black brand fill. */
+  --color-semantic-background-brand-dim: #4a2808; /** Dim brand fill (card header, timeline axis), dark brown; text.onAccent (amber) reads 7.2:1 on it. Kept distinct from text.muted so the shadcn chart ramp stays five distinct colours (DMNC-1436). */
+  --color-semantic-background-error: #5f340e; /** Destructive fill stays monochrome: dark brown with text.white (amber) on it. */
+  --color-semantic-background-success: #411f06; /** Success fill stays monochrome: deep brown with text.white (amber) on it. */
+  --color-semantic-border-default: #020003; /** Ink border. */
+  --color-semantic-border-focus: #020003; /** Focus ring, ink. */
+  --color-semantic-border-hover: #2c1203; /** Hover border, deep brown. */
+  --color-semantic-border-disabled: #7a4500; /** Disabled border, mid brown. */
+  --color-semantic-border-brand: #020003; /** Brand border, ink. */
+  --color-semantic-border-brand-bright: #2c1203; /** Brand emphasis border. */
+  --color-semantic-border-brand-dim: #7a4500; /** Dim brand border, mid brown (3:1+ on ground). */
+  --color-semantic-border-error: #020003; /** Monochrome error border, ink. */
+  --color-semantic-border-success: #020003; /** Monochrome success border, ink. */
+  --color-semantic-link-default: #2c1203; /** Link, deep brown (9.6:1); distinguished by underline, not hue. */
+  --color-semantic-link-hover: #020003; /** Link hover, ink. */
+  --color-semantic-link-active: #5f340e; /** Link active, dark brown. */
+  --color-semantic-link-visited: #411f06; /** Visited, deep brown. */
+  --color-semantic-status-success: #2c1203; /** Monochrome status success. */
+  --color-semantic-status-warning: #411f06; /** Monochrome status warning. */
+  --color-semantic-status-error: #020003; /** Monochrome status error. */
+  --color-semantic-status-info: #5f340e; /** Monochrome status info. */
+  --color-semantic-alert-info: #e6a000; /** Alert surface, amber shade; tone is carried by icon + text, not hue. */
+  --color-semantic-alert-success: #e6a000; /** Alert surface, amber shade. */
+  --color-semantic-alert-warning: #e6a000; /** Alert surface, amber shade. */
+  --color-semantic-alert-error: #e6a000; /** Alert surface, amber shade. */
+  --color-semantic-glow-error: rgba(0, 0, 0, 0); /** No bloom on reverse video, transparent. */
+  --shadow-glow-xs: 0px 0px 8px 0px #02000300; /** No phosphor bloom on reverse video (transparent). */
+  --shadow-glow-sm: 0px 0px 10px 0px #02000300; /** No phosphor bloom on reverse video (transparent). */
+  --shadow-glow-md: 0px 0px 20px 0px #02000300; /** No phosphor bloom on reverse video (transparent). */
+  --shadow-glow-lg: 0px 0px 30px 0px #02000300; /** No phosphor bloom on reverse video (transparent). */
+  --focus-ring-color: #020003; /** Focus ring, ink on the amber ground. */
+  --effects-overlay: rgba(2, 0, 3, 0.7); /** Modal backdrop, ink at 70% so the amber dialog separates from the page. */
+  --effects-scanline-light: rgba(2, 0, 3, 0.05); /** Scanline band, faint ink. */
+  --effects-scanline-dark: rgba(2, 0, 3, 0.02); /** Scanline band, fainter ink. */
+  --effects-vignette-glow: rgba(2, 0, 3, 0); /** No inner glow on reverse video. */
+  --effects-vignette-edge: rgba(2, 0, 3, 0.15); /** Vignette edge darkening, ink at low alpha. */
+  --effects-vignette-corner: rgba(2, 0, 3, 0.3); /** Vignette corner darkening, ink at low alpha. */
+  --effects-screen-tint: rgba(2, 0, 3, 0.05); /** Screen tint, ink at about 5%. */
+  --effects-phosphor-glow: rgba(2, 0, 3, 0); /** No phosphor bloom on reverse video. */
+  --effects-bloom-outer: rgba(2, 0, 3, 0); /** No bloom on reverse video. */
+  --effects-bloom-center: rgba(2, 0, 3, 0); /** No bloom on reverse video. */
+  --effects-crt-background: #ffb000; /** CRT screen background, amber ground. */
+}

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

@@ -45,7 +45,9 @@
   --color-semantic-alert-warning: #352800;
   --color-semantic-alert-error: #430500;
   --color-semantic-text-primary: var(--color-cga-light-gray);
-  --color-semantic-text-secondary: var(--color-cga-black);
+  --color-semantic-text-secondary: var(--color-cga-light-gray); /** DMNC-1494: visible de-emphasised tone on dark backgrounds. For dark text on an amber fill use `text.onAccent`. */
+  --color-semantic-text-on-accent: var(--color-cga-white); /** DMNC-1494: text/icon sitting on an accent fill. Light here because the cga-amber accent fill is blue; elsewhere it is the old `text.secondary` value. */
+  --color-semantic-text-on-light: var(--color-cga-black); /** DMNC-1494: near-black text/icon for an unfilled element sitting on a light surface (e.g. Nav modern links). Near-black in every theme, unlike `text.onAccent`, which follows the accent fill. */
   --color-semantic-text-accent: var(--color-cga-amber);
   --color-semantic-text-disabled: var(--color-cga-dark-gray);
   --color-semantic-text-muted: var(--color-cga-brown);

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

@@ -41,7 +41,9 @@
   --color-semantic-text-ai-gradient-from-light: #c0228a; /** AI-marker gradient start under light themes ([data-theme=light]/.light) — deep magenta, contrast on white. Static, brand-locked. Gradient-only; no Tailwind utility (DMNC-946). */
   --color-semantic-text-ai-gradient-to-light: #7a3cc0; /** AI-marker gradient end under light themes — violet, contrast on white. Static, brand-locked. Gradient-only; no Tailwind utility (DMNC-946). */
   --color-semantic-text-primary: #ffff00;
-  --color-semantic-text-secondary: #050300;
+  --color-semantic-text-secondary: #ffff00; /** DMNC-1494: visible de-emphasised tone (same as text.primary in this mode theme). */
+  --color-semantic-text-on-accent: #050300; /** DMNC-1494: dark text on an accent fill. Was the value of `text.secondary`. */
+  --color-semantic-text-on-light: #050300; /** DMNC-1494: near-black text/icon for an unfilled element sitting on a light surface (e.g. Nav modern links). Near-black in every theme, unlike `text.onAccent`, which follows the accent fill. */
   --color-semantic-text-accent: #00ff00;
   --color-semantic-text-disabled: #ff0000;
   --color-semantic-text-muted: rgba(255, 255, 0, 0.65);

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

@@ -41,7 +41,9 @@
   --color-semantic-text-ai-gradient-from-light: #c0228a; /** AI-marker gradient start under light themes ([data-theme=light]/.light) — deep magenta, contrast on white. Static, brand-locked. Gradient-only; no Tailwind utility (DMNC-946). */
   --color-semantic-text-ai-gradient-to-light: #7a3cc0; /** AI-marker gradient end under light themes — violet, contrast on white. Static, brand-locked. Gradient-only; no Tailwind utility (DMNC-946). */
   --color-semantic-text-primary: #fffcf7;
-  --color-semantic-text-secondary: #050300;
+  --color-semantic-text-secondary: #fffcf7; /** DMNC-1494: visible de-emphasised tone (same as text.primary in this mode theme). */
+  --color-semantic-text-on-accent: #050300; /** DMNC-1494: dark text on an accent fill. Was the value of `text.secondary`. */
+  --color-semantic-text-on-light: #050300; /** DMNC-1494: near-black text/icon for an unfilled element sitting on a light surface (e.g. Nav modern links). Near-black in every theme, unlike `text.onAccent`, which follows the accent fill. */
   --color-semantic-text-accent: #00ffff;
   --color-semantic-text-disabled: #ff00ff;
   --color-semantic-text-muted: rgba(255, 252, 247, 0.65);

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

@@ -41,7 +41,9 @@
   --color-semantic-text-ai-gradient-from-light: #c0228a; /** AI-marker gradient start under light themes ([data-theme=light]/.light) — deep magenta, contrast on white. Static, brand-locked. Gradient-only; no Tailwind utility (DMNC-946). */
   --color-semantic-text-ai-gradient-to-light: #7a3cc0; /** AI-marker gradient end under light themes — violet, contrast on white. Static, brand-locked. Gradient-only; no Tailwind utility (DMNC-946). */
   --color-semantic-text-primary: #fffcf7;
-  --color-semantic-text-secondary: #050300;
+  --color-semantic-text-secondary: #fffcf7; /** DMNC-1494: visible de-emphasised tone (same as text.primary in this mode theme). */
+  --color-semantic-text-on-accent: #050300; /** DMNC-1494: dark text on an accent fill. Was the value of `text.secondary`. */
+  --color-semantic-text-on-light: #050300; /** DMNC-1494: near-black text/icon for an unfilled element sitting on a light surface (e.g. Nav modern links). Near-black in every theme, unlike `text.onAccent`, which follows the accent fill. */
   --color-semantic-text-accent: #00ffff;
   --color-semantic-text-disabled: #ff0000;
   --color-semantic-text-muted: rgba(255, 252, 247, 0.65);

package/src/styles/theme.light.css

@@ -41,7 +41,9 @@
   --color-semantic-text-ai-gradient-from-light: #c0228a; /** AI-marker gradient start under light themes ([data-theme=light]/.light) — deep magenta, contrast on white. Static, brand-locked. Gradient-only; no Tailwind utility (DMNC-946). */
   --color-semantic-text-ai-gradient-to-light: #7a3cc0; /** AI-marker gradient end under light themes — violet, contrast on white. Static, brand-locked. Gradient-only; no Tailwind utility (DMNC-946). */
   --color-semantic-text-primary: #1f1b16; /** Warm near-black body text (~13:1 on bg.primary). */
-  --color-semantic-text-secondary: #1f1b16; /** Dark text for amber/light fills. */
+  --color-semantic-text-secondary: #1f1b16; /** DMNC-1494: visible on the light page background (near-black). For dark text on an amber fill use `text.onAccent`. */
+  --color-semantic-text-on-accent: #1f1b16; /** DMNC-1494: dark text/icon on an amber accent fill. */
+  --color-semantic-text-on-light: #1f1b16; /** DMNC-1494: near-black text/icon for an unfilled element sitting on a light surface (e.g. Nav modern links). Near-black in every theme, unlike `text.onAccent`, which follows the accent fill. */
   --color-semantic-text-accent: #9a5700; /** Deep-amber accent text (readable on light, ~5:1). */
   --color-semantic-text-disabled: #a8a096; /** Disabled text/icon. */
   --color-semantic-text-muted: #6e685d; /** Muted supplementary text (~5.5:1 on bg.primary). */

package/src/styles/tokens.css

@@ -47,6 +47,7 @@
   --typography-font-family-primary: 'Perfect DOS VGA 437', monospace; /** Perfect DOS VGA 437 by Zeh Fernando (free-for-any-use; ships with bundled LICENSE.txt). Pixel-perfect-vector TTF — every glyph outline is axis-aligned, scales cleanly to any size. The `monospace` fallback preserves DOS aesthetic on @font-face failure. Used for display/heading tiers (dos-hero, dos-h1…h5). */
   --typography-font-family-body: 'JetBrains Mono Nerd Font', monospace; /** JetBrains Mono Nerd Font (OFL-1.1; ships with bundled JetBrainsMonoNerdFont_OFL.txt). Multi-weight monospace body font — includes Nerd Font glyph extensions (powerline, devicons, language logos) for terminal-aesthetic UIs alongside pixelarticons. Ships as four per-weight woff2 files (Regular/Medium/SemiBold/Bold). Used for body/prose tiers (dos-body, dos-body-lg, dos-caption, dos-micro). Use fontWeight.body-* tokens for real weight variation (DMNC-885). */
   --typography-font-family-fallback: monospace; /** Bare `monospace` stack — fail-loud diagnostic counterpart to `primary`. Compose with `primary` when consumers want strict Perfect-DOS-or-nothing rendering. */
+  --typography-font-size-text-base: 1rem; /** 16px — body floor (DOS VGA native 9x16 cell) for body text, labels and controls (DMNC-1579). Named exceptions: em-relative secondary glyphs that scale with their parent (CalendarHeatmap day labels 0.6em, ProgressRing centre label 0.5em, Stat/VitalsStrip unit suffix 0.5em of the display-size value) */
   --typography-font-size-text-xs: 1.125rem; /** 18px — smallest body text */
   --typography-font-size-text-sm: 1.25rem; /** 20px — secondary body text */
   --typography-font-size-text-md: 1.375rem; /** 22px — default body text */
@@ -65,6 +66,7 @@
   --typography-font-weight-body-medium: 500; /** Body: JetBrains Mono Nerd Font medium. */
   --typography-font-weight-body-semibold: 600; /** Body: JetBrains Mono Nerd Font semibold. */
   --typography-font-weight-body-bold: 700; /** Body: JetBrains Mono Nerd Font bold. */
+  --typography-line-height-text-base: 1.25rem; /** 20px */
   --typography-line-height-text-xs: 1.125rem; /** 18px */
   --typography-line-height-text-sm: 1.25rem; /** 20px */
   --typography-line-height-text-md: 1.5rem; /** 24px */
@@ -195,7 +197,9 @@
   --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-secondary: var(--color-cga-light-gray); /** DMNC-1494: visible de-emphasised tone on dark backgrounds. For dark text on an amber fill use `text.onAccent`. */
+  --color-semantic-text-on-accent: var(--color-cga-black); /** DMNC-1494: dark text/icon sitting on an accent (amber) fill. Was the value of `text.secondary`. */
+  --color-semantic-text-on-light: var(--color-cga-black); /** DMNC-1494: near-black text/icon for an unfilled element sitting on a light surface (e.g. Nav modern links). Near-black in every theme, unlike `text.onAccent`, which follows the accent fill. */
   --color-semantic-text-accent: var(--color-cga-yellow);
   --color-semantic-text-disabled: var(--color-cga-dark-gray);
   --color-semantic-text-muted: var(--color-cga-amber-dim); /** Muted supplementary text — timestamps, counts, footnotes. T10 handoff: dedicated amber-dim hex (in-family with primary), not brown; no opacity coupling. */

package/tailwind.preset.cjs

@@ -30,6 +30,7 @@ try {
   animatePlugin = null;
 }
 
+// DMNC-1579: text-xs/text-sm are aliased to the 16px body floor
 const preset = {
   "theme": {
     "extend": {
@@ -72,6 +73,8 @@ const preset = {
         "dos-text-ai-draft": "var(--color-semantic-text-ai-draft)",
         "dos-text-primary": "var(--color-semantic-text-primary)",
         "dos-text-secondary": "var(--color-semantic-text-secondary)",
+        "dos-text-on-accent": "var(--color-semantic-text-on-accent)",
+        "dos-text-on-light": "var(--color-semantic-text-on-light)",
         "dos-text-accent": "var(--color-semantic-text-accent)",
         "dos-text-disabled": "var(--color-semantic-text-disabled)",
         "dos-text-muted": "var(--color-semantic-text-muted)",
@@ -120,6 +123,12 @@ const preset = {
         ]
       },
       "fontSize": {
+        "dos-text-base": [
+          "1rem",
+          {
+            "lineHeight": "1.25rem"
+          }
+        ],
         "dos-text-xs": "1.125rem",
         "dos-text-sm": "1.25rem",
         "dos-text-md": "1.375rem",
@@ -130,9 +139,22 @@ const preset = {
         "dos-display-md": "2.625rem",
         "dos-display-lg": "3.5rem",
         "dos-display-xl": "4.125rem",
-        "dos-display-2xl": "4.875rem"
+        "dos-display-2xl": "4.875rem",
+        "xs": [
+          "1rem",
+          {
+            "lineHeight": "1.25rem"
+          }
+        ],
+        "sm": [
+          "1rem",
+          {
+            "lineHeight": "1.25rem"
+          }
+        ]
       },
       "lineHeight": {
+        "dos-text-base": "1.25rem",
         "dos-text-xs": "1.125rem",
         "dos-text-sm": "1.25rem",
         "dos-text-md": "1.5rem",

package/dist/components/Brand/components/markGeometry.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/components/Connector/components/connectorGeometry.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/components/DecayStrip/components/resample.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/components/TimelineContainer/components/timelineUtils.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/components/TimelineContainer/components/useDrillDown.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/components/TimelineContainer/components/useSelection.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/components/TimelineContainer/components/useZoom.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/hooks/useTextScramble.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/hooks/useThemePortal.test.d.ts

@@ -1 +0,0 @@
-export {};