jig-ui 0.18.8 → 0.18.9

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 0.18.9 (2026-09-25)
+
+Each theme names its colour scheme, and no release summary names a rule by its
+id.
+
+### Changed
+
+- **No release summary names a rule by its id.** jig-site's Versions page shows
+  each summary, and the site keeps rule ids out of its interface. Three named a
+  rule as `A-05`, `I-118` or `H-47`; they now name it in words. A test keeps ids
+  out of summaries.
+
+### Fixed
+
+- **Each theme names its `color-scheme`.** The default brand file's `:root`
+  said `color-scheme: light dark`, which follows the device, and its dark blocks
+  set tokens only. jig-site added a theme toggle and a reader who chose the
+  other theme got the right page inside the device's scrollbars and form
+  controls. Both dark blocks now set `color-scheme: dark`, `[data-theme="light"]`
+  sets `light`, and `T-09` says why. A project whose brand file predates this
+  adds the same three declarations.
+
 ## 0.18.8 (2026-09-25)
 
 Two runs writing one manifest no longer lose an entry.
@@ -121,7 +143,7 @@ for jig-site's Versions page.
 ## 0.18.1 (2026-09-25)
 
 Two fixes found by jig-site's fourth round: the probe misread a `<details>`
-menu, and `A-05` missed an arrow that renders as an emoji.
+menu, and the emoji rule missed an arrow that renders as an emoji.
 
 ### Fixed
 
@@ -539,7 +561,7 @@ Meaning before presentation, and one fewer step anyone can skip.
 
 ## 0.12.0 (2026-09-18)
 
-One new rule: no em dashes in interface text (`I-118`), with a detector.
+One new rule: no em dashes in interface text, with a detector.
 
 ### Added
 
@@ -666,8 +688,8 @@ runs with Haiku.
 
 ## 0.9.0 (2026-09-13)
 
-One new rule and one amended correction, both about the same blind spot: H-47's
-correction always pointed an agent at a token.
+One new rule and one amended correction, both about the same blind spot: a
+rule's correction always pointed an agent at a token.
 
 ### Added
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jig-ui",
-  "version": "0.18.8",
+  "version": "0.18.9",
   "description": "A design system for coding agents. 143 numbered UI rules, brand x mode design tokens, and an installer for Claude Code, Codex, Cursor and opencode.",
   "license": "Apache-2.0",
   "type": "module",

package/rules/02-tokens.md

@@ -442,6 +442,8 @@ These thresholds are APCA's own and do not line up with WCAG's large-text defini
 
 Not an inversion (`C-21`). Each brand file supplies a dark block under `@media (prefers-color-scheme: dark)` and `[data-theme="dark"]`, remapping semantics only. Mode files are theme-independent — density does not change with colour scheme.
 
+Each theme also names its `color-scheme`: `dark` in both dark blocks, and `light` under `[data-theme="light"]`. The browser's own parts, its scrollbars, form controls and the canvas behind the page, follow `color-scheme` and not the tokens, so a site with a theme toggle otherwise draws the chosen theme inside the device's scrollbars.
+
 In dark, elevated surfaces get **lighter**, not shadowed. Border-led elevation survives the switch; shadow-led does not, which is one reason border-led is the unbranded default.
 
 ## T-10 · Consuming

package/tokens/brand.default.css

@@ -154,6 +154,7 @@
    is the answer to it. */
 @media (prefers-color-scheme: dark) {
   :root:not([data-theme="light"]) {
+    color-scheme: dark;
 
     /* Three solid levels. In dark, DEPTH COMES FROM BACKGROUND, NOT SHADOW —
        shadows are nearly invisible on a dark surface. Never pure black. */
@@ -186,6 +187,7 @@
 }
 
 :root[data-theme="dark"] {
+    color-scheme: dark;
 
     /* Three solid levels. In dark, DEPTH COMES FROM BACKGROUND, NOT SHADOW —
        shadows are nearly invisible on a dark surface. Never pure black. */
@@ -215,3 +217,11 @@
     --shadow-raised:  none;
     --shadow-overlay: 0 8px 24px -8px rgb(0 0 0 / 60%);
 }
+
+/* The browser's own parts (scrollbars, form controls, the canvas behind the
+   page) follow `color-scheme`, not the tokens. `:root` says `light dark`, which
+   follows the device, so a reader who chose the other theme got the right page
+   inside the wrong scrollbars (jig-site, DRIFT 48). Each theme names its own. */
+:root[data-theme="light"] {
+  color-scheme: light;
+}