@nurix/etna 0.20.17 → 0.20.18

package/data/harness-index.json

@@ -1,5 +1,5 @@
 {
-    "fingerprint": "2923378ebe87",
+    "fingerprint": "993a4863fa1f",
     "harnesses": {
         "code": {
             "plugin": "code",

package/data/harnesses/code/harness.json

@@ -1,7 +1,7 @@
 {
   "harness": "code",
   "name": "code",
-  "version": "3.16.5",
+  "version": "3.16.6",
   "files": [
     ".prettierignore",
     ".prettierrc.json",
@@ -25,5 +25,5 @@
     }
   ],
   "docsRoot": "docs",
-  "digest": "2e50abdd4ddd"
+  "digest": "79daa8edeb53"
 }

package/data/harnesses/code/skills/design/references/emission.md

@@ -36,6 +36,8 @@ personality:
 Each prevents a known silent-failure class:
 
 - **Specificity armor.** Theme blocks are `:root:not(.dark)` and `:root.dark` — both specificity (0,2,0) — keyed on the `.dark` class the library compiles into its own stylesheet. A `data-theme` attribute keys none of the library's `dark:` variants, its theme toggle, or its toaster: an app on the attribute inverts its tokens and renders mixed library chrome.
+- **Theme-invariant tokens sit in a bare `:root`.** Only the colour roles are themed. Font stacks, the type ramp, radii, shadows, motion and layout emit into a bare `:root` block ahead of the two theme blocks. Behind `:root:not(.dark)` they match nothing once `.dark` is on the root, and every `font-size: var(--text-…)` collapses to an inherited 16px in dark mode while the colours still look right.
+- **The ramp emits Tailwind's composite sub-keys.** `--text-<step>` with `--line-height`, `--font-weight` and `--letter-spacing` sub-keys are exactly what the `text-<step>` utility applies. A `-size`/`-line`/`-weight` suffix form generates junk utilities and leaves `text-<step>` undefined. The `--font-feature-settings` and `--font-family` sub-keys are inert for the utility and are read through `var()`. The dense operator tier's steps are optional: absent steps emit nothing and warn once per package (`dmw-08`).
 - **The tone trio.** `success`, `warning`, and `info` reach the library as `--tone-success|warning|info` — what a status dot (`<Chip prefix="dot" color="var(--tone-success)">`) and the copy button's check read, falling back to the library's own hue when a role is absent. Declare all three, in both themes — a missing `info` (`dmw-06`) puts the library's blue beside the package's green and amber.
 - **Font binding by derivation.** Font stacks bind to installed packages under **registered family names** (`"Inter Variable"`, not `"Inter"`), each with its declared fallback stack — otherwise the flagship font silently never renders. Install the font packages the design.md declares (e.g. Fontsource) and verify the name matches what the package registers. The library's `font-sans` / `font-mono` / `font-display` utilities compile to `inherit` on purpose (a ramp, never a face): the app declares its own theme keys in a plain `@theme` pointing at the emitted slots — `--font-body: var(--font-sans)`, `--font-heading: var(--font-display)`, `--font-code: var(--font-mono)` — and sets the ambient face on `body` in `@layer base`.
 - **Every authored token group reaches a named consumer.** An authored ramp with no emitter vanishes without a trace — wire each group (colors → theme classes/utilities, ramp → text styles, elevation → radius/shadow utilities, motion → duration/easing vars) and let the ship gate's reach check prove it. The personality families reach the library by construction; the app's `--duration-*` / `--ease-*` reach app-owned animation code, or they are unused.

package/data/harnesses/code/skills/design/scripts/validate-design-md.mjs

@@ -105,14 +105,15 @@
 //           background (checked only where chroma ≥ 0.01 — hue is noise near gray).
 //   dmw-07  accent chroma delta between themes > 0.06 (identity likely not held across themes).
 //
-// Emitted artifact shape (deterministic, byte-stable): a `:root:not(.dark)` block and a
-// `:root.dark` block (specificity armor — both selectors reach 0,2,0 via the attribute
-// form, so a component library's later bare `:root` cannot silently defeat a theme). The light block
-// carries the 36 roles as --<role> plus every theme-invariant group: --font-display/sans/mono (registered
-// names quoted, declared fallback stacks appended), --text-<step>-size/-line/-weight (+ -family/-tracking/
-// -features where authored), --radius-*, --shadow-*, --duration-*, --ease-*, and the layout vars
-// (--space-base, --sidebar-width[-collapsed], --topbar-height, --side-panel-width[-wide],
-// --content-max-width; unmapped keys emit as --layout-<key>). The dark block carries the 36 dark roles.
+//   dmw-08  the dense operator tier is unadopted: typography.ramp omits optional steps (one warn per package).
+//
+// Emitted artifact shape (deterministic, byte-stable): THREE blocks. A bare `:root` carries every
+// theme-invariant group — --font-display/sans/mono (registered names quoted, fallback stacks appended),
+// the ramp as Tailwind composite keys --text-<step> + --line-height/--font-weight/--letter-spacing
+// sub-keys, --radius-*, --shadow-*, --duration-*, --ease-*, and the layout vars (unmapped keys emit as
+// --layout-<key>). Then `:root:not(.dark)` and `:root.dark` (both 0,2,0) carry the colour roles.
+// Theme-invariant tokens must never move behind `:root:not(.dark)`: it matches nothing once `.dark` is on
+// the root, and the whole ramp collapses to inherited 16px in dark mode (references/emission.md).
 
 import { readFileSync, writeFileSync, existsSync, statSync, readdirSync, realpathSync } from "node:fs";
 import { join, resolve, basename, dirname, relative, sep } from "node:path";
@@ -140,7 +141,11 @@ const SECTIONS = [
     "11 Responsive", "12 Agent Prompt Guide",
 ];
 
-const RAMP_STEPS = ["display", "h1", "h2", "body", "small", "caption", "data"];
+// The dense operator tier is optional: every catalog package authors only the seven required steps, and
+// each new value would be a taste decision per identity. Absent optional steps warn once (dmw-08) and emit nothing.
+const RAMP_STEPS_REQUIRED = ["display", "h1", "h2", "body", "small", "caption", "data"];
+const RAMP_STEPS_OPTIONAL = ["title", "h3", "prose", "control-lg", "dense", "control", "meta", "micro", "code", "ident"];
+const RAMP_STEPS = [...RAMP_STEPS_REQUIRED, ...RAMP_STEPS_OPTIONAL];
 const FONT_SLOTS = ["display", "sans", "mono"];
 // Optional color roles: emitted only when declared (both themes or neither). `info` completes the
 // success/warning/info trio @nurix/components' status dots read through --tone-*.
@@ -688,9 +693,17 @@ function checkCoverage(values, report) {
         for (const slot of FONT_SLOTS) if (!isObj(typo[slot])) missing(`typography.${slot}`);
         if (!isObj(typo.ramp)) missing("typography.ramp");
         else {
+            // One warn per package, not one per step, so the taste warns stay readable across the catalog.
+            const unadopted = RAMP_STEPS_OPTIONAL.filter((s) => !isObj(typo.ramp[s]));
+            if (unadopted.length) {
+                warn(report, "dmw-08", `dense operator tier unadopted — typography.ramp missing ${unadopted.length}/${RAMP_STEPS_OPTIONAL.length}: ${unadopted.join(", ")}`);
+            }
             for (const step of RAMP_STEPS) {
                 const r = typo.ramp[step];
-                if (!isObj(r)) { missing(`typography.ramp.${step}`); continue; }
+                if (!isObj(r)) {
+                    if (!RAMP_STEPS_OPTIONAL.includes(step)) missing(`typography.ramp.${step}`);
+                    continue;
+                }
                 for (const k of ["size", "line", "weight"]) if (r[k] == null) missing(`typography.ramp.${step}.${k}`);
                 if (r.family == null) missing(`typography.ramp.${step}.family`);
                 else if (!FONT_SLOTS.includes(r.family)) {
@@ -997,30 +1010,27 @@ export function emitTokens(front, values) {
     const out = [];
     out.push(`/* design.tokens.css — compiled from ${id} (design-md/v2) by validate-design-md.mjs — derived artifact: edit the design.md, never this file */`);
     out.push("");
-    out.push(':root:not(.dark) {');
-    out.push("    /* color roles */");
-    for (const role of COLOR_ROLES) out.push(`    --${role}: ${cssValue(req(values, ["color", "light", role]))};`);
-    for (const role of OPTIONAL_COLOR_ROLES) {
-        const v = values.color.light[role];
-        if (v != null) out.push(`    --${role}: ${cssValue(v)};`);
-    }
-    out.push("");
+    // Theme-invariant tokens sit in a bare `:root`; behind `:root:not(.dark)` they would not exist in dark mode.
+    out.push(":root {");
     out.push("    /* typography */");
     for (const slot of FONT_SLOTS) {
         const f = req(values, ["typography", slot]);
         if (f.family == null || f.fallback == null) throw new Error(`cannot emit: typography.${slot} family/fallback missing`);
         out.push(`    --font-${slot}: "${f.family}", ${f.fallback};`);
     }
+    const ramp = req(values, ["typography", "ramp"]);
     for (const step of RAMP_STEPS) {
+        if (ramp[step] == null && RAMP_STEPS_OPTIONAL.includes(step)) continue;
         const r = req(values, ["typography", "ramp", step]);
-        out.push(`    --text-${step}-size: ${cssValue(req(r, ["size"]))};`);
-        out.push(`    --text-${step}-line: ${cssValue(req(r, ["line"]))};`);
-        out.push(`    --text-${step}-weight: ${cssValue(req(r, ["weight"]))};`);
-        if (r.family != null) out.push(`    --text-${step}-family: var(--font-${r.family});`);
-        if (r.tracking != null) out.push(`    --text-${step}-tracking: ${cssValue(r.tracking)};`);
+        // Tailwind's `text-*` utility reads exactly --line-height, --letter-spacing and --font-weight sub-keys.
+        out.push(`    --text-${step}: ${cssValue(req(r, ["size"]))};`);
+        out.push(`    --text-${step}--line-height: ${cssValue(req(r, ["line"]))};`);
+        out.push(`    --text-${step}--font-weight: ${cssValue(req(r, ["weight"]))};`);
+        if (r.tracking != null) out.push(`    --text-${step}--letter-spacing: ${cssValue(r.tracking)};`);
         if (Array.isArray(r.features) && r.features.length) {
-            out.push(`    --text-${step}-features: ${r.features.map((x) => `"${x}"`).join(", ")};`);
+            out.push(`    --text-${step}--font-feature-settings: ${r.features.map((x) => `"${x}"`).join(", ")}; /* inert for text-*; read via var() */`);
         }
+        if (r.family != null) out.push(`    --text-${step}--font-family: var(--font-${r.family}); /* inert for text-*; read via var() */`);
     }
     out.push("");
     out.push("    /* elevation */");
@@ -1043,15 +1053,18 @@ export function emitTokens(front, values) {
         }
     }
     out.push("}");
-    out.push("");
-    out.push(':root.dark {');
-    out.push("    /* color roles */");
-    for (const role of COLOR_ROLES) out.push(`    --${role}: ${cssValue(req(values, ["color", "dark", role]))};`);
-    for (const role of OPTIONAL_COLOR_ROLES) {
-        const v = values.color.dark[role];
-        if (v != null) out.push(`    --${role}: ${cssValue(v)};`);
+    // Both colour blocks reach (0,2,0), one notch above a library's unlayered `:root`/`.dark`, whatever the import order.
+    for (const [selector, theme] of [[":root:not(.dark)", "light"], [":root.dark", "dark"]]) {
+        out.push("");
+        out.push(`${selector} {`);
+        out.push(`    /* color roles — ${theme} */`);
+        for (const role of COLOR_ROLES) out.push(`    --${role}: ${cssValue(req(values, ["color", theme, role]))};`);
+        for (const role of OPTIONAL_COLOR_ROLES) {
+            const v = values.color[theme][role];
+            if (v != null) out.push(`    --${role}: ${cssValue(v)};`);
+        }
+        out.push("}");
     }
-    out.push("}");
     return out.join("\n") + "\n";
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nurix/etna",
-  "version": "0.20.17",
+  "version": "0.20.18",
   "description": "Bootstrap a project with a Nurix harness — copies the harness's CLAUDE.md, skills, agents, rules, and hooks directly into the project from a bundled payload (no marketplace fetch, no network).",
   "type": "module",
   "bin": {
@@ -42,5 +42,5 @@
     "agent",
     "plugin"
   ],
-  "etnaFingerprint": "2923378ebe87"
+  "etnaFingerprint": "993a4863fa1f"
 }