@tangle-network/brand 1.29.0 → 1.30.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 1.30.0
+
+### Minor Changes
+
+- 29e2a49: One loop period, one shadow colour and one radius ramp.
+  
+  - `--duration-ambient` (2000ms) and `--motion-ambient` (ease-in-out) are the only loop period on a page; the shared `tangle-breathe` keyframe breathes a running mark on them, opacity only. Reduced motion keeps that period, so the essential "still working" signal survives.
+  - `--shadow-color` is the one shadow colour, as HSL channels: black in dark, `220 40% 8%` in light. Every spine shadow, the agents and hospitality themes and system.css draw in it; hospitality's forest-tinted shadow becomes the light shadow colour. The dark `--shadow-overlay` no longer inverts into a white halo.
+  - Radius roles are one ramp: `--radius-tag` 4, `--radius-control` 8, `--radius-card` 12, `--radius-container` 16, `--radius-pill`. `--radius-chip`, `--radius-field` and `--radius-panel` keep their values as aliases of control, card and container.
+
 ## 1.29.0
 
 ### Minor Changes

package/README.md

@@ -82,7 +82,7 @@ The Agent App light-default contract is an explicit exception to Brand's default
 /* Import globals.css separately only when the host already intends those globals. */
 ```
 
-Choose this **instead of** `styles`, `tokens.css` and `named-themes.css`; do not stack the two default contracts. The projection contains canonical declarations with a zero-specificity light root default, keeps all explicit mode selectors, and omits `--radius`, which the legacy consumer deliberately leaves to its host. It includes no global component rules, keyframes or automatic ladder/system imports.
+Choose this **instead of** `styles`, `tokens.css` and `named-themes.css`; do not stack the two default contracts. The projection contains canonical declarations with a zero-specificity light root default, keeps all explicit mode selectors, and omits `--radius`, which the legacy consumer deliberately leaves to its host. It includes no global component rules or automatic ladder/system imports; its one keyframe, `tangle-breathe`, runs only where a component names it.
 
 This export is the shared migration boundary, **not a claim that Agent App has already migrated** and not a replacement for that package's entire stylesheet. Its component-specific variables, neutral-ramp API, keyframes and structural rules remain consumer-owned until a separate, explicit migration reconciles them. Remove duplicate shared palette declarations in that migration rather than placing competing global token systems on the same page.
 
@@ -123,9 +123,9 @@ Renderers that cannot read CSS variables (PDF, canvas, WebGL, email, the `theme-
 
 The base surface ladder is the one GTM proved out: dark is indigo-lifted `#0a0a14` / `#191826` / `#221f33` / `#2c2942`; light is a cool `#eceef3` canvas, white paper cards and overlays, and `#f1f2f7` nested wells. The cast stays below 0.1 chroma and ink stays achromatic, so indigo still reads as the interaction accent, not the base field. Existing named products may supply deliberate surface overrides.
 
-Chrome radii are 6/8/10/12px in both base modes; the composer has its own 26px role. Inter (variable, then static) leads body and display stacks, with Geist fallbacks; Geist Mono leads code with JetBrains Mono and system fallbacks. Runtime font/radius registrations retain their public override names; tests keep Tailwind registration defaults aligned with the canonical declarations.
+Chrome radii are 6/8/10/12px in both base modes; the composer has its own 26px role. Role radii are one ramp: `--radius-tag` 4, `--radius-control` 8, `--radius-card` 12, `--radius-container` 16, and `--radius-pill` for every chip; `--radius-chip`, `--radius-field` and `--radius-panel` are older names of control, card and container. Every shadow is drawn in `--shadow-color`, HSL channels that are black in dark and `220 40% 8%` in light; a named theme retints its shadows by setting that one token. Inter (variable, then static) leads body and display stacks, with Geist fallbacks; Geist Mono leads code with JetBrains Mono and system fallbacks. Runtime font/radius registrations retain their public override names; tests keep Tailwind registration defaults aligned with the canonical declarations.
 
-Existing `--transition-*` values are preserved. The shared `--duration-*`, `--ease-*` and `--motion-*` vocabulary comes from the existing Agent App contract. It does not apply animations automatically. Reduced motion zeroes those durations and re-resolves composites at theme boundaries. The adjacent `--interaction-*` roles are elapsed acknowledgment/loading thresholds for existing product instrumentation, not animation durations; reduced motion does not change them.
+Existing `--transition-*` values are preserved. The shared `--duration-*`, `--ease-*` and `--motion-*` vocabulary comes from the existing Agent App contract. It does not apply animations automatically. Reduced motion zeroes those durations and re-resolves composites at theme boundaries. `--duration-ambient` (2000 ms; `--motion-ambient` adds ease-in-out) is the only loop period on a page: a running mark breathes on it with the `tangle-breathe` keyframe, opacity only. Reduced motion keeps that one, because it is the essential "still working" signal and moves nothing. The adjacent `--interaction-*` roles are elapsed acknowledgment/loading thresholds for existing product instrumentation, not animation durations; reduced motion does not change them.
 
 Focus uses `--focus-border`, `--focus-halo`, their danger variants, and `--border-strong`, derived from the local ring/border palette. UI's `focusField` / `focusRing` consume them. `globals.css` supplies the existing fallback for controls without their own focus treatment.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/brand",
-  "version": "1.29.0",
+  "version": "1.30.0",
   "description": "Tangle brand system — design tokens, logo, Tailwind v4 theme. Single source of truth for every Tangle app.",
   "type": "module",
   "license": "MIT",

package/src/styles/legacy-light.css

@@ -1,6 +1,6 @@
 /* GENERATED by scripts/gen-compat.mjs. Do not edit.
  * Source: tokens.css + named-themes.css
- * SHA-256: 0a80a683644d15e5e56e938a3094142b9f1a2dd6f3fe136154af4b6bc7c033e0
+ * SHA-256: 83dde77644ce502513ced146ea7ed7dad93fc736195530c0c2bef82849bf1f21
  * Light-default compatibility; all explicit modes remain canonical.
  */
 :where(:root),
@@ -272,12 +272,12 @@
     --code-success: var(--surface-success-text);
     --code-comment: var(--syntax-comment);
     --code-error: var(--syntax-error);
-    --shadow-card: 0 1px 2px rgba(0, 0, 0, 0.3);
-    --shadow-dropdown: 0 8px 30px rgba(0, 0, 0, 0.45);
+    --shadow-color: 0 0% 0%;
+    --shadow-card: 0 1px 2px hsl(var(--shadow-color) / 0.3);
+    --shadow-dropdown: 0 8px 30px hsl(var(--shadow-color) / 0.45);
     --shadow-glow: none;
-    --shadow-accent: 0 1px 2px rgba(0, 0, 0, 0.3);
-    --shadow-overlay: 0 2px 6px hsl(var(--hsl-foreground) / 0.1),
-    0 16px 40px hsl(var(--hsl-foreground) / 0.16);
+    --shadow-accent: var(--shadow-card);
+    --shadow-overlay: 0 2px 6px hsl(var(--shadow-color) / 0.3), 0 16px 40px hsl(var(--shadow-color) / 0.5);
     --scrim: rgb(0 0 0 / 0.4);
     --scrim-strong: rgb(0 0 0 / 0.72);
     --on-media: #ffffff;
@@ -292,9 +292,12 @@
     --radius-full: 999px;
     --radius-composer: 26px;
     --radius-tag: 4px;
-    --radius-chip: 8px;
-    --radius-field: 12px;
-    --radius-panel: 16px;
+    --radius-control: var(--radius-md);
+    --radius-card: var(--radius-xl);
+    --radius-container: 16px;
+    --radius-chip: var(--radius-control);
+    --radius-field: var(--radius-card);
+    --radius-panel: var(--radius-container);
     --radius-cover: 20px;
     --radius-sheet: 24px;
     --control-height: 2.25rem;
@@ -377,6 +380,8 @@
     --motion-dismiss: var(--duration-instant) var(--ease-exit);
     --motion-stream: var(--duration-stream) var(--ease-expo);
     --motion-arrive: var(--duration-arrive) var(--ease-expo);
+    --duration-ambient: 2000ms;
+    --motion-ambient: var(--duration-ambient) ease-in-out;
     --interaction-feedback-budget: 100ms;
     --interaction-pending-delay: 200ms;
     --interaction-long-work-delay: 1000ms;
@@ -533,10 +538,10 @@
     --run-mix-cancelled: #515367;
     --glass-bg-strong: var(--depth-1);
     --code-header-bg: color-mix(in srgb, hsl(var(--hsl-muted)) 50%, transparent);
-    --shadow-card: 0 1px 2px rgba(25, 28, 36, 0.06);
-    --shadow-dropdown: 0 8px 30px rgba(25, 28, 36, 0.10);
-    --shadow-glow: none;
-    --shadow-accent: 0 1px 2px rgba(25, 28, 36, 0.06);
+    --shadow-color: 220 40% 8%;
+    --shadow-card: 0 1px 2px hsl(var(--shadow-color) / 0.06);
+    --shadow-dropdown: 0 8px 30px hsl(var(--shadow-color) / 0.1);
+    --shadow-overlay: 0 2px 6px hsl(var(--shadow-color) / 0.1), 0 16px 40px hsl(var(--shadow-color) / 0.16);
 }
 :where(:root),
 .dark,
@@ -640,6 +645,11 @@
     --chart-tier-a: #5b5bd6;
     --chart-tier-s: #272962;
 }
+@keyframes tangle-breathe {
+    50% {
+        opacity: 0.45;
+    }
+}
 @media (prefers-reduced-motion: reduce) {
     :where(:root),
   .dark,
@@ -1262,9 +1272,9 @@
     --field-border: #798479;
     --border-accent: rgba(40, 88, 66, 0.20);
     --border-accent-hover: rgba(40, 88, 66, 0.36);
-    --shadow-card: 0 1px 2px rgba(23, 38, 29, 0.07), 0 4px 14px -4px rgba(23, 38, 29, 0.10);
-    --shadow-raised: 0 1px 1px rgba(23, 38, 29, 0.05), 0 2px 6px -2px rgba(23, 38, 29, 0.07);
-    --shadow-well: inset 0 1px 2px rgba(23, 38, 29, 0.06);
+    --shadow-card: 0 1px 2px hsl(var(--shadow-color) / 0.07), 0 4px 14px -4px hsl(var(--shadow-color) / 0.1);
+    --shadow-raised: 0 1px 1px hsl(var(--shadow-color) / 0.05), 0 2px 6px -2px hsl(var(--shadow-color) / 0.07);
+    --shadow-well: inset 0 1px 2px hsl(var(--shadow-color) / 0.06);
     --edge-highlight: 0 0 0 0 transparent;
     --accent-text: #285842;
     --accent-surface-soft: rgba(40, 88, 66, 0.05);
@@ -1364,9 +1374,9 @@
     --field-border: #939c94;
     --border-accent: rgba(118, 183, 145, 0.35);
     --border-accent-hover: rgba(118, 183, 145, 0.50);
-    --shadow-card: 0 1px 2px rgba(0, 0, 0, 0.45), 0 10px 24px -14px rgba(0, 0, 0, 0.6);
-    --shadow-raised: 0 1px 2px rgba(0, 0, 0, 0.35);
-    --shadow-well: inset 0 1px 2px rgba(0, 0, 0, 0.5);
+    --shadow-card: 0 1px 2px hsl(var(--shadow-color) / 0.45), 0 10px 24px -14px hsl(var(--shadow-color) / 0.6);
+    --shadow-raised: 0 1px 2px hsl(var(--shadow-color) / 0.35);
+    --shadow-well: inset 0 1px 2px hsl(var(--shadow-color) / 0.5);
     --edge-highlight: inset 0 1px 0 rgba(255, 255, 255, 0.06);
     --accent-text: #b2dbc2;
     --accent-surface-soft: rgba(118, 183, 145, 0.07);
@@ -1448,8 +1458,8 @@
     --border-default: #49474e;
     --border-hover: #625f69;
     --shadow-card: inset 0 0 0 1px rgb(255 255 255 / 0.06);
-    --shadow-dropdown: inset 0 0 0 1px rgb(255 255 255 / 0.08), 0 8px 24px rgb(0 0 0 / 0.5);
-    --shadow-overlay: inset 0 0 0 1px rgb(255 255 255 / 0.1), 0 16px 48px rgb(0 0 0 / 0.6);
+    --shadow-dropdown: inset 0 0 0 1px rgb(255 255 255 / 0.08), 0 8px 24px hsl(var(--shadow-color) / 0.5);
+    --shadow-overlay: inset 0 0 0 1px rgb(255 255 255 / 0.1), 0 16px 48px hsl(var(--shadow-color) / 0.6);
 }
 [data-theme="agents-light"] {
     --bg-card: #ffffff;
@@ -1502,9 +1512,9 @@
     --border-subtle: #dbd8e0;
     --border-default: #d0cdd7;
     --border-hover: #bcbac7;
-    --shadow-card: 0 0 0 1px rgb(33 31 38 / 0.03), 0 2px 6px rgb(33 31 38 / 0.05), 0 4px 8px rgb(33 31 38 / 0.08);
-    --shadow-dropdown: 0 0 0 1px rgb(33 31 38 / 0.04), 0 6px 16px rgb(33 31 38 / 0.12);
-    --shadow-overlay: 0 8px 28px rgb(33 31 38 / 0.28);
+    --shadow-card: 0 0 0 1px hsl(var(--shadow-color) / 0.03), 0 2px 6px hsl(var(--shadow-color) / 0.05), 0 4px 8px hsl(var(--shadow-color) / 0.08);
+    --shadow-dropdown: 0 0 0 1px hsl(var(--shadow-color) / 0.04), 0 6px 16px hsl(var(--shadow-color) / 0.12);
+    --shadow-overlay: 0 8px 28px hsl(var(--shadow-color) / 0.28);
 }
 [data-theme="website"]:where(:not(.dark)) {
     --hsl-background: 240 42.9% 97.3%;

package/src/styles/named-themes.css

@@ -393,9 +393,9 @@
   --border-hover: rgba(23, 38, 29, 0.28); --border-strong: #798479;
   --field-border: #798479;
   --border-accent: rgba(40, 88, 66, 0.20); --border-accent-hover: rgba(40, 88, 66, 0.36);
-  --shadow-card: 0 1px 2px rgba(23, 38, 29, 0.07), 0 4px 14px -4px rgba(23, 38, 29, 0.10);
-  --shadow-raised: 0 1px 1px rgba(23, 38, 29, 0.05), 0 2px 6px -2px rgba(23, 38, 29, 0.07);
-  --shadow-well: inset 0 1px 2px rgba(23, 38, 29, 0.06);
+  --shadow-card: 0 1px 2px hsl(var(--shadow-color) / 0.07), 0 4px 14px -4px hsl(var(--shadow-color) / 0.1);
+  --shadow-raised: 0 1px 1px hsl(var(--shadow-color) / 0.05), 0 2px 6px -2px hsl(var(--shadow-color) / 0.07);
+  --shadow-well: inset 0 1px 2px hsl(var(--shadow-color) / 0.06);
   --edge-highlight: 0 0 0 0 transparent;
   --accent-text: #285842;
   --accent-surface-soft: rgba(40, 88, 66, 0.05); --accent-surface-strong: rgba(40, 88, 66, 0.13);
@@ -443,9 +443,9 @@
   --border-hover: rgba(227, 233, 229, 0.28); --border-strong: #939c94;
   --field-border: #939c94;
   --border-accent: rgba(118, 183, 145, 0.35); --border-accent-hover: rgba(118, 183, 145, 0.50);
-  --shadow-card: 0 1px 2px rgba(0, 0, 0, 0.45), 0 10px 24px -14px rgba(0, 0, 0, 0.6);
-  --shadow-raised: 0 1px 2px rgba(0, 0, 0, 0.35);
-  --shadow-well: inset 0 1px 2px rgba(0, 0, 0, 0.5);
+  --shadow-card: 0 1px 2px hsl(var(--shadow-color) / 0.45), 0 10px 24px -14px hsl(var(--shadow-color) / 0.6);
+  --shadow-raised: 0 1px 2px hsl(var(--shadow-color) / 0.35);
+  --shadow-well: inset 0 1px 2px hsl(var(--shadow-color) / 0.5);
   --edge-highlight: inset 0 1px 0 rgba(255, 255, 255, 0.06);
   /* Lifted from #99caad so selected text on a primary tint still clears 4.5:1
    * over the lighter raised plane (L 37.9). */
@@ -517,8 +517,8 @@
   --border-default: #49474e;
   --border-hover: #625f69;
   --shadow-card: inset 0 0 0 1px rgb(255 255 255 / 0.06);
-  --shadow-dropdown: inset 0 0 0 1px rgb(255 255 255 / 0.08), 0 8px 24px rgb(0 0 0 / 0.5);
-  --shadow-overlay: inset 0 0 0 1px rgb(255 255 255 / 0.1), 0 16px 48px rgb(0 0 0 / 0.6);
+  --shadow-dropdown: inset 0 0 0 1px rgb(255 255 255 / 0.08), 0 8px 24px hsl(var(--shadow-color) / 0.5);
+  --shadow-overlay: inset 0 0 0 1px rgb(255 255 255 / 0.1), 0 16px 48px hsl(var(--shadow-color) / 0.6);
 }
 [data-theme="agents-light"] {
   --bg-card: #ffffff;
@@ -571,9 +571,9 @@
   --border-subtle: #dbd8e0;
   --border-default: #d0cdd7;
   --border-hover: #bcbac7;
-  --shadow-card: 0 0 0 1px rgb(33 31 38 / 0.03), 0 2px 6px rgb(33 31 38 / 0.05), 0 4px 8px rgb(33 31 38 / 0.08);
-  --shadow-dropdown: 0 0 0 1px rgb(33 31 38 / 0.04), 0 6px 16px rgb(33 31 38 / 0.12);
-  --shadow-overlay: 0 8px 28px rgb(33 31 38 / 0.28);
+  --shadow-card: 0 0 0 1px hsl(var(--shadow-color) / 0.03), 0 2px 6px hsl(var(--shadow-color) / 0.05), 0 4px 8px hsl(var(--shadow-color) / 0.08);
+  --shadow-dropdown: 0 0 0 1px hsl(var(--shadow-color) / 0.04), 0 6px 16px hsl(var(--shadow-color) / 0.12);
+  --shadow-overlay: 0 8px 28px hsl(var(--shadow-color) / 0.28);
 }
 /* agents:end */
 

package/src/styles/named-themes.test.ts

@@ -301,7 +301,7 @@ for (const [name, mode] of [
       it("is a white page whose cards separate by shadow", () => {
         expect(declIn(css, "hsl-background")).toBe("0 0% 100%");
         expect(declIn(css, "hsl-card")).toBe("0 0% 100%");
-        expect(declIn(css, "shadow-card")).toMatch(/rgb\(/);
+        expect(declIn(css, "shadow-card")).toMatch(/hsl\(var\(--shadow-color\)/);
       });
     }
   });

package/src/styles/system.css

@@ -140,12 +140,15 @@
    * action. White text passes on every stop (5.37, 5.39 and 5.18:1). */
   --cta: linear-gradient(90deg, #5b5bd6 0%, #6e56cf 55%, #8e4ec6 100%);
   --cta-hover: linear-gradient(90deg, #5151cd 0%, #654dc4 55%, #8347b9 100%);
-  /* Radius by role. The numeric --radius-sm..xl scale is unchanged, so no
-   * existing surface re-rounds; new surfaces pick the role they play. */
+  /* Radius by role, the tokens.css ramp: tag 4, control 8, card 12,
+   * container 16, pill. Chip, field and panel are the older names. */
   --radius-tag: 4px;
-  --radius-chip: 8px;
-  --radius-field: 12px;
-  --radius-panel: 16px;
+  --radius-control: 8px;
+  --radius-card: 12px;
+  --radius-container: 16px;
+  --radius-chip: var(--radius-control);
+  --radius-field: var(--radius-card);
+  --radius-panel: var(--radius-container);
   --radius-cover: 20px;
   --radius-sheet: 24px;
   --radius-pill: 999px;
@@ -191,10 +194,11 @@
   --text-figure--line-height: 2.75rem;
   --text-figure--letter-spacing: -0.02em;
   --text-figure--font-weight: 600;
+  --shadow-color: 0 0% 0%;
   /* Elevation. In dark, a white hairline states the edge; only floating layers cast a shadow. */
   --shadow-1: inset 0 0 0 1px rgb(255 255 255 / 0.06);
-  --shadow-2: inset 0 0 0 1px rgb(255 255 255 / 0.08), 0 8px 24px rgb(0 0 0 / 0.5);
-  --shadow-3: inset 0 0 0 1px rgb(255 255 255 / 0.1), 0 16px 48px rgb(0 0 0 / 0.6);
+  --shadow-2: inset 0 0 0 1px rgb(255 255 255 / 0.08), 0 8px 24px hsl(var(--shadow-color) / 0.5);
+  --shadow-3: inset 0 0 0 1px rgb(255 255 255 / 0.1), 0 16px 48px hsl(var(--shadow-color) / 0.6);
   --shadow-card: var(--shadow-1);
   --shadow-dropdown: var(--shadow-2);
   --shadow-overlay: var(--shadow-3);
@@ -332,12 +336,15 @@
    * action. White text passes on every stop (5.37, 5.39 and 5.18:1). */
   --cta: linear-gradient(90deg, #5b5bd6 0%, #6e56cf 55%, #8e4ec6 100%);
   --cta-hover: linear-gradient(90deg, #5151cd 0%, #654dc4 55%, #8347b9 100%);
-  /* Radius by role. The numeric --radius-sm..xl scale is unchanged, so no
-   * existing surface re-rounds; new surfaces pick the role they play. */
+  /* Radius by role, the tokens.css ramp: tag 4, control 8, card 12,
+   * container 16, pill. Chip, field and panel are the older names. */
   --radius-tag: 4px;
-  --radius-chip: 8px;
-  --radius-field: 12px;
-  --radius-panel: 16px;
+  --radius-control: 8px;
+  --radius-card: 12px;
+  --radius-container: 16px;
+  --radius-chip: var(--radius-control);
+  --radius-field: var(--radius-card);
+  --radius-panel: var(--radius-container);
   --radius-cover: 20px;
   --radius-sheet: 24px;
   --radius-pill: 999px;
@@ -383,10 +390,11 @@
   --text-figure--line-height: 2.75rem;
   --text-figure--letter-spacing: -0.02em;
   --text-figure--font-weight: 600;
+  --shadow-color: 220 40% 8%;
   /* Elevation. In light, shadow separates a card from the white page. */
-  --shadow-1: 0 0 0 1px rgb(33 31 38 / 0.03), 0 2px 6px rgb(33 31 38 / 0.05), 0 4px 8px rgb(33 31 38 / 0.08);
-  --shadow-2: 0 0 0 1px rgb(33 31 38 / 0.04), 0 6px 16px rgb(33 31 38 / 0.12);
-  --shadow-3: 0 8px 28px rgb(33 31 38 / 0.28);
+  --shadow-1: 0 0 0 1px hsl(var(--shadow-color) / 0.03), 0 2px 6px hsl(var(--shadow-color) / 0.05), 0 4px 8px hsl(var(--shadow-color) / 0.08);
+  --shadow-2: 0 0 0 1px hsl(var(--shadow-color) / 0.04), 0 6px 16px hsl(var(--shadow-color) / 0.12);
+  --shadow-3: 0 8px 28px hsl(var(--shadow-color) / 0.28);
   --shadow-card: var(--shadow-1);
   --shadow-dropdown: var(--shadow-2);
   --shadow-overlay: var(--shadow-3);

package/src/styles/theme.css

@@ -36,12 +36,10 @@
   --radius-xl: 12px;
   --radius-full: 999px;
 
-  --shadow-card: 0 1px 2px rgba(0, 0, 0, 0.3);
-  --shadow-dropdown: 0 8px 30px rgba(0, 0, 0, 0.45);
+  --shadow-card: 0 1px 2px hsl(var(--shadow-color) / 0.3);
+  --shadow-dropdown: 0 8px 30px hsl(var(--shadow-color) / 0.45);
   --shadow-glow: none;
-  --shadow-overlay:
-    0 2px 6px hsl(var(--hsl-foreground) / 0.1),
-    0 16px 40px hsl(var(--hsl-foreground) / 0.16);
+  --shadow-overlay: 0 2px 6px hsl(var(--shadow-color) / 0.3), 0 16px 40px hsl(var(--shadow-color) / 0.5);
 }
 
 /* Inline variable-dependent utilities so their source is resolved on the

package/src/styles/tokens.css

@@ -374,23 +374,18 @@
   --code-comment: var(--syntax-comment);
   --code-error: var(--syntax-error);
 
-  /* Shadows — flat, no inner ring, no indigo glow */
-  --shadow-card: 0 1px 2px rgba(0, 0, 0, 0.3);
-  --shadow-dropdown: 0 8px 30px rgba(0, 0, 0, 0.45);
+  /* Shadows — flat, no inner ring, no glow. Every shadow is one colour,
+     --shadow-color, as HSL channels so each sets its own alpha: black here, a
+     deep cool ink in light. A shadow never inverts into a light halo; dark
+     elevation is the plane step plus --edge-highlight. --shadow-overlay is the
+     lift above --shadow-dropdown, for a surface that covers the page (a
+     drawer, a modal, a floating dock): a tight contact layer plus a wide one. */
+  --shadow-color: 0 0% 0%;
+  --shadow-card: 0 1px 2px hsl(var(--shadow-color) / 0.3);
+  --shadow-dropdown: 0 8px 30px hsl(var(--shadow-color) / 0.45);
   --shadow-glow: none;
-  --shadow-accent: 0 1px 2px rgba(0, 0, 0, 0.3);
-  /* The lift above --shadow-dropdown, for a surface that covers the page
-     rather than sitting beside it: a drawer, a modal, a floating dock.
-     Two layers — a tight contact shadow plus a wide ambient one.
-     Alone among the shadows this is derived from --hsl-foreground instead of
-     a fixed rgba, so it INVERTS with the theme. That is what makes it work in
-     dark: a black shadow on a dark canvas renders as nothing (see the ladder
-     note at the top of this file), while the foreground is near-white there,
-     so the same declaration reads as a soft halo. One definition therefore
-     serves both themes and the light block does not restate it. */
-  --shadow-overlay:
-    0 2px 6px hsl(var(--hsl-foreground) / 0.1),
-    0 16px 40px hsl(var(--hsl-foreground) / 0.16);
+  --shadow-accent: var(--shadow-card);
+  --shadow-overlay: 0 2px 6px hsl(var(--shadow-color) / 0.3), 0 16px 40px hsl(var(--shadow-color) / 0.5);
   /* Scrim and media ink. A scrim dims the page behind a modal or sheet, or
      darkens a photo under its caption. It is black in every theme: a dimming
      layer that inverted in dark mode would brighten the page it covers.
@@ -410,12 +405,18 @@
   --radius-pill: 999px;
   --radius-full: 999px;
   --radius-composer: 26px;    /* centered composer pill */
-  /* Radius by role. New surfaces pick the role they play; system.css repeats
-     these for pages that load it on its own ladders. */
+  /* Radius by role, one ramp: tag 4, control 8, card 12, container 16, and
+     --radius-pill for every chip and status pill. Chip, field and panel are
+     the older names of control, card and container. Cover and sheet are the
+     media and bottom-sheet radii. system.css repeats these for pages that load
+     it on its own ladders. */
   --radius-tag: 4px;
-  --radius-chip: 8px;
-  --radius-field: 12px;
-  --radius-panel: 16px;
+  --radius-control: var(--radius-md);
+  --radius-card: var(--radius-xl);
+  --radius-container: 16px;
+  --radius-chip: var(--radius-control);
+  --radius-field: var(--radius-card);
+  --radius-panel: var(--radius-container);
   --radius-cover: 20px;
   --radius-sheet: 24px;
   --radius: 0.5rem;           /* 8px chrome default (was 10px) */
@@ -527,6 +528,11 @@
   --motion-dismiss: var(--duration-instant) var(--ease-exit);
   --motion-stream: var(--duration-stream) var(--ease-expo);
   --motion-arrive: var(--duration-arrive) var(--ease-expo);
+  /* The only loop period on a page. A running mark breathes on it with
+     `tangle-breathe` (opacity, never position or scale), so every live thing
+     shares one rhythm. Reduced motion keeps it: see the rule below. */
+  --duration-ambient: 2000ms;
+  --motion-ambient: var(--duration-ambient) ease-in-out;
 
   /* Elapsed interaction thresholds, not animation durations. See
    * docs/design-bible.md#interaction. Reduced motion leaves these unchanged. */
@@ -737,11 +743,11 @@
   --glass-bg-strong: var(--depth-1);
   --code-header-bg: color-mix(in srgb, hsl(var(--hsl-muted)) 50%, transparent);
 
-  /* Shadows — flat, no inner ring, no glow */
-  --shadow-card: 0 1px 2px rgba(25, 28, 36, 0.06);
-  --shadow-dropdown: 0 8px 30px rgba(25, 28, 36, 0.10);
-  --shadow-glow: none;
-  --shadow-accent: 0 1px 2px rgba(25, 28, 36, 0.06);
+  /* Shadows — the dark roles in the light shadow colour, at light alphas. */
+  --shadow-color: 220 40% 8%;
+  --shadow-card: 0 1px 2px hsl(var(--shadow-color) / 0.06);
+  --shadow-dropdown: 0 8px 30px hsl(var(--shadow-color) / 0.1);
+  --shadow-overlay: 0 2px 6px hsl(var(--shadow-color) / 0.1), 0 16px 40px hsl(var(--shadow-color) / 0.16);
 }
 
 
@@ -940,7 +946,11 @@
 
 
 /* Motion is opt-in at the component, but its reduced-motion preference is
- * shared. Re-declare composites at the same boundary as their durations. */
+ * shared. Re-declare composites at the same boundary as their durations.
+ * --duration-ambient is not zeroed: the essential running mark
+ * (data-motion="essential") keeps its opacity-only breathe, because it is the
+ * only "still working" signal and it never moves anything. */
+@keyframes tangle-breathe { 50% { opacity: 0.45; } }
 @media (prefers-reduced-motion: reduce) {
   :root,
   .dark,

package/src/styles/tokens.test.ts

@@ -5,10 +5,12 @@ import {
   blockIn,
   compositeOver,
   contrastRatio,
+  declIn,
   hexIn,
   hexRelativeLuminanceIn,
   hslIn,
   hslToRgb,
+  resolveIn,
 } from "./css-test-utils";
 
 /**
@@ -608,3 +610,39 @@ describe("each colour is declared once: a role, then aliases", () => {
     expect(literalsOutsideTones(spine).size).toBeLessThanOrEqual(ceiling);
   });
 });
+
+describe("shadow, radius and loop period are one role each", () => {
+  // The run-UI critique of 2026-10-27 (fixes 9, 10 and 22) found a white shadow
+  // haze in dark mode, six radii and seven loop periods. Each is now one role
+  // that every other name aliases, so a surface cannot drift to a second value.
+  it.each([
+    ["dark", DARK, "0 0% 0%"],
+    ["light", LIGHT, "220 40% 8%"],
+  ] as const)("%s: every shadow is drawn in --shadow-color and never inverts", (_, spine, colour) => {
+    expect(declIn(spine, "shadow-color")).toBe(colour);
+    for (const token of ["shadow-card", "shadow-dropdown", "shadow-overlay"]) {
+      const value = declIn(spine, token);
+      expect(value, `--${token}`).toMatch(/^[^,]*hsl\(var\(--shadow-color\) \/ [\d.]+\)/);
+      expect(value, `--${token} names a colour of its own`).not.toMatch(/rgba?\(|#[0-9a-f]{3,8}\b|--hsl-foreground/i);
+    }
+  });
+
+  it("draws radii from one ramp, and the older role names alias it", () => {
+    const ramp = { tag: "4px", control: "8px", card: "12px", container: "16px", pill: "999px" };
+    for (const [role, px] of Object.entries(ramp)) expect(resolveIn(DARK, `radius-${role}`), role).toBe(px);
+    for (const [older, role] of [["chip", "control"], ["field", "card"], ["panel", "container"]]) {
+      expect(declIn(DARK, `radius-${older}`)).toBe(`var(--radius-${role})`);
+    }
+  });
+
+  it("has one loop period, which reduced motion keeps for an opacity-only breathe", () => {
+    expect(declIn(DARK, "duration-ambient")).toBe("2000ms");
+    expect(declIn(DARK, "motion-ambient")).toBe("var(--duration-ambient) ease-in-out");
+    const reduced = tokens.match(/@media \(prefers-reduced-motion: reduce\) \{([\s\S]*?)\n\}/)![1];
+    expect(reduced).toContain("--duration-fast: 0ms");
+    expect(reduced, "the essential breathe keeps its period").not.toContain("--duration-ambient");
+    const breathe = tokens.match(/@keyframes tangle-breathe \{([\s\S]*?)\}\s*\}/)?.[1];
+    expect(breathe, "the shared breathe keyframe").toMatch(/opacity/);
+    expect(breathe, "a loop never moves or scales").not.toMatch(/transform|translate|scale|rotate/);
+  });
+});