@mkbabb/glass-ui 3.9.0 → 3.10.0

package/dist/styles/glass.css

@@ -46,8 +46,15 @@
 
        The `.glass-dock` SHELL is OUT of this group BY DESIGN — it hand-rolls a
        parallel surface (its own `--glass-*-dock` family + a local rim + an
-       instrument-strip `::before`) the dock arm owns; the dock's catch-light
-       lives on its CONTROL (`.dock-icon-button`, listed below), not the shell.
+       instrument-strip `::before`) the dock arm owns. The COHESION CONSEQUENCE is
+       DELIBERATE: the dock shell carries NO shared edge-gleam / moving-specular
+       `::before` (its only `::before` is the `variant-instrument-strip` engraved
+       bezel, dock/shell.css — a different effect). The dock's catch-light lives on
+       its CONTROLS (`.dock-icon-button` et al., listed below + in the opt-in
+       transition block), which ARE in the material group — NOT on the shell plate.
+       Adding a shell gleam would re-introduce glass-on-glass over the controls, so
+       the shell-without-gleam is a NAMED EXEMPTION, gated as `dock-shell-exempt` in
+       proof:glass-cohesion (the only exemption beside the legibility allowlist).
 
        The selector GROUP is the single source. Adding a surface to the band
        material is one comma-entry here, not a new opt-in class string. */
@@ -146,6 +153,37 @@
            a plain low-alpha warm overlay (the gleam composes normally — no blend, no
            blowout), the no-workaround floor; NOT a `screen` fallback. */
         mix-blend-mode: plus-lighter;
+        /* The moving-specular TRANSITION is NOT declared here. An idle/unwired
+           `::before` is STATIC (no interpolation track), so a bare glass rung / an
+           un-armed Card / a glass Button at rest attaches ZERO animation tracks (the
+           keyframes.js runtime counts 0 idle tracks, not 19). The transition rides
+           ONLY the WIRED + interactive surfaces — the opt-in scoped block below. */
+    }
+
+    /* AY.W-GLASS — the moving-specular transition is OPT-IN (the Card wire-or-omit
+       pattern, generalized). It attaches ONLY to a WIRED surface
+       (`.glass-specular-track` — Card emits it conditionally, the dock controls + the
+       Slider thumb compose it) OR to any glass surface under `:hover`/`:active` (the
+       pointer is present, so the interpolation is legitimately live). An idle/unwired
+       `.glass-floating` / `.glass-wash` / bare-rung `::before` carries NO transition
+       and thus NO keyframes.js track. The §6 register is PRESERVED (still
+       `--ease-standard` on the position-tracked + surface-opacity legs — H-motion §6
+       "position-tracked → --ease-standard"; only the SELECTOR scope changes). The dock
+       controls keep the always-on transition (they are interactive controls; their rest
+       intensity is 0 so they paint nothing at rest, but a control legitimately carries
+       the transition). */
+    .glass-specular-track::before,
+    .glass-material:hover::before,    .glass-material:active::before,
+    .glass-wash:hover::before,        .glass-wash:active::before,
+    .glass-quiet:hover::before,       .glass-quiet:active::before,
+    .glass-resting:hover::before,     .glass-resting:active::before,
+    .glass-floating:hover::before,    .glass-floating:active::before,
+    .glass-overlay:hover::before,     .glass-overlay:active::before,
+    .glass-card:hover::before,        .glass-card:active::before,
+    .dock-icon-button::before,
+    .dock-tab-button::before,
+    .dock-select-trigger::before,
+    .dock-dropdown-trigger::before {
         /* Smooth the position + intensity between pointer samples (the typed
            @property regs make the percentage stops interpolable). */
         transition:
@@ -222,6 +260,97 @@
         --specular-intensity: var(--glass-specular-intensity-active, 0.16);
     }
 
+    /* ── LIQUID by tier — the moving-specular hover catch-light is the
+       FLOATING / OVERLAY tier's PROPERTY, not a per-surface wire (D6.c M10) ──────
+       The shared `:hover::before` rule above already lifts `--specular-intensity`
+       to the hover rung on EVERY material surface, so the catch-light wakes on
+       hover library-wide. What this block promotes is the FLOATING / OVERLAY
+       tier's identity: a navigation/overlay-band surface (a Dialog, a Sheet, a
+       Popover, the dock crest's `.glass-floating`) reads as LIQUID OUT OF THE BOX
+       — the catch-light is a tier guarantee, documented here so a consumer reaches
+       for `variant="floating"` and inherits the lens without a `useSpecularTracking`
+       wire. The pointer-anchored TRACKING still rides `useSpecularTracking` (a
+       host can sharpen the lens to the cursor); un-wired, the catch-light sits at
+       the centred `50%` fallback and breathes on hover — felt, not garish.
+
+       The magnitude rides the SAME `--glass-specular-intensity-hover` cohort the
+       aurora-calibrated π-ledger judges (tokens.css §specular-intensity), so the
+       liquid tier never out-shouts a number — it is the SAME gleam, named as a
+       tier default. The OPT-OUT survives: `.glass-no-liquid` on a floating/overlay
+       surface pins the rest rung (a flat tier for dense data, the deft escape). */
+    .glass-floating:not(.glass-no-liquid),
+    .glass-overlay:not(.glass-no-liquid) {
+        --glass-liquid: 1; /* the tier carries the liquid identity (informational marker) */
+    }
+    .glass-floating.glass-no-liquid:hover::before,
+    .glass-overlay.glass-no-liquid:hover::before,
+    .glass-floating.glass-no-liquid:active::before,
+    .glass-overlay.glass-no-liquid:active::before {
+        /* The deft escape — a dense-data floating surface that wants a FLAT tier
+           pins the catch-light at the clean rest rung even on hover/active. */
+        --specular-intensity: var(--glass-specular-intensity-rest, 0);
+    }
+    @media (prefers-reduced-motion: reduce) {
+        /* PRM fence — the liquid tier degrades to the static centred gleam. The
+           `useSpecularTracking` write is already PRM-gated (it skips the pointer
+           write under reduce); this pins the CSS half (`--specular-x/y: 50%`
+           centred) AND kills the position-track `transition` so an un-wired liquid
+           tile does NOT animate a travelling catch-light on hover under PRM. The
+           gleam may still LIFT on hover (a discrete opacity step, no interpolation
+           track) — the correct PRM degrade: no MOTION, the surface still responds.
+           This mirrors the shared moving-specular PRM bracket (one static-pin
+           convention across the specular cohort). */
+        .glass-floating::before,
+        .glass-overlay::before {
+            --specular-x: 50%;
+            --specular-y: 50%;
+            transition: none;
+        }
+    }
+
+    /* ── The GILT EDGE — `.glass-gilt`, the gilt-tooled glass modifier (D6.c M3/M12) ──
+       A fine book's cover is gold-tooled at the EDGE — never a gold fill. The
+       modifier composes on ANY tier (the tier is the FROST; the gilt is the
+       hairline gold catch on its rim) so a featured card OR the dock crest wears
+       the same recipe over its own backdrop. Two box-shadow layers ride INSIDE
+       the tier (they do not perturb the tier's own elevation stack — they are
+       additive inset rings):
+         (1) a 1px inset ring on `--gold-rim` — the tooled gold edge (D6.b lands
+             `--gold-rim` = `--gold` at ~40%α over the surface; referenced by name,
+             so the gilt resolves the moment the token cohort is minted), and
+         (2) a 0.5px gold top-catch highlight — the bevel light reading off the
+             upper edge, `--gold-light` at low α so it is a catch, not a band.
+       The surface still reads as cream-glass; the gold is the bevel light, the
+       SCARCE flourish (the consumption budget — at most one gilt surface per
+       route — is the atlas's D7 rule, not enforced here). */
+    .glass-gilt {
+        box-shadow:
+            inset 0 0 0 1px var(--gold-rim, color-mix(in oklab, var(--gold) 40%, transparent)),
+            inset 0 0.5px 0 0 color-mix(in oklab, var(--gold-light) 35%, transparent),
+            var(--glass-material-rim),
+            var(--glass-shadow-floating);
+    }
+
+    /* The liquid-metal CATCH-LIGHT (D6.c M12) — `.glass-gilt` overrides the
+       moving-specular `::before` sweep COLOR from warm-cream to GOLD, so the light
+       travelling across the gilt edge is golden the way gold leaf catches a warm
+       highlight. This is the single richest moment in the platform — gold + liquid
+       + specular — and therefore the most scarce (ONE surface ever, the title-page
+       flourish; the budget lives in D7). The geometry (bounded circle, the
+       `--glass-specular-size` falloff, the `plus-lighter` blend, the mask) is
+       INHERITED verbatim from the shared `::before`; only the gradient color stops
+       shift to the warm-gold mix. The intensity still rides the `--specular-intensity`
+       opacity multiplier (0 at rest), so a resting gilt surface paints NO gold sweep
+       — it wakes on hover like every liquid tier. */
+    .glass-gilt::before {
+        background: radial-gradient(
+            circle var(--glass-specular-size, 36%) at var(--specular-x, 50%) var(--specular-y, 50%),
+            color-mix(in oklab, var(--gold-light) 60%, hsl(40 35% 92%)) 0%,
+            hsl(40 35% 92% / 0) 70%,
+            transparent 100%
+        );
+    }
+
     /* ── Five-tier surface ladder (v0.8.0; visual only, no geometry) ──
        Tier semantics, alpha-monotonic per R3-spec §A:
          wash      ~0.30α  + light blur      (was `subtle`)
@@ -430,7 +559,10 @@
         background: var(--paper-clean-texture);
         background-repeat: repeat;
         background-size: var(--paper-texture-size);
-        opacity: var(--glass-grain-opacity);
+        /* D6.c M5 — the grain rung lifted off the dead 0.025 floor to a felt-but-
+           deft 0.038 (the page rung; the kitsch ceiling is ~0.05). The canonical
+           token still wins; this is the felt floor a no-override mount inherits. */
+        opacity: var(--glass-grain-opacity, 0.038);
         pointer-events: none;
         mix-blend-mode: overlay;
     }
@@ -947,17 +1079,20 @@
     .glass-resting,
     .glass-floating,
     .glass-overlay,
-    .glass-card {
+    .glass-card,
+    .glass-drawer {
         border: 1px solid CanvasText;
     }
 
     /* The floating + overlay rungs (Dialog / Sheet / Popover / DropdownMenu /
-       HoverCard compose them) get the canonical `Canvas` fill so the modal reads as
-       a DISTINCT boxed region OVER the page, not a transparent overlap — the
-       hierarchy survives. The `CanvasText` edge above already draws the box; this
-       opaque fill separates the floating layer from the content beneath it. */
+       HoverCard compose them) + the Drawer (the overlay-band sheet, drawer.css)
+       get the canonical `Canvas` fill so the modal reads as a DISTINCT boxed
+       region OVER the page, not a transparent overlap — the hierarchy survives.
+       The `CanvasText` edge above already draws the box; this opaque fill
+       separates the floating layer from the content beneath it. */
     .glass-floating,
-    .glass-overlay {
+    .glass-overlay,
+    .glass-drawer {
         background: Canvas;
     }
 
@@ -972,6 +1107,7 @@
     .glass-floating::before,
     .glass-overlay::before,
     .glass-card::before,
+    .glass-drawer::before,
     .glass-wash::after,
     .glass-quiet::after,
     .glass-resting::after,

package/dist/styles/paper.css

@@ -7,8 +7,54 @@
  *
  * Texture: feTurbulence baseFrequency 0.65, 4 octaves, desaturated via
  * feColorMatrix, blended multiply (light) / soft-light (dark). Tiles ~60px.
+ *
+ * ── THE GRAIN RUNGS (D6.c M5 — the printed-paper tooth, FELT not seen) ─────────
+ * The warm-paper grain must be FELT at rest — a premium editorial stock has a
+ * felt depth, and the measured finding (ds2-medium M5 / fd-usf-gallery §F) is
+ * that the shipped `--glass-grain-opacity: 0.025` floor reads as NOTHING. This
+ * file lifts the grain off that floor and mints a SECOND rung for chart plates:
+ *
+ *   --glass-grain-opacity        — the PAGE grain. Lifted here to a perceptible-
+ *                                  but-deft 0.038 default (the local floor below).
+ *                                  Numeric justification: the kitsch line is
+ *                                  ~0.05 (above it the grain reads as screen-noise
+ *                                  / a dirty monitor, ds2-medium M5); 0.025 is
+ *                                  sub-perceptual ("felt as nothing"). 0.038 is
+ *                                  the calibrated MIDPOINT — ~1.5× the dead floor,
+ *                                  ~0.76× the kitsch ceiling — felt at rest, never
+ *                                  seen AS grain. (The canonical token still lives
+ *                                  in tokens.css; this utility reads it with the
+ *                                  lifted fallback so a no-override mount is felt.)
+ *   --glass-grain-opacity-plate  — the PLATE grain (NEW rung). A chart plate is
+ *                                  the FIGURE's "paper", so it wants slightly more
+ *                                  tooth than the page (M5): 0.045 — still below
+ *                                  the 0.05 kitsch ceiling, distinctly felt so the
+ *                                  plate reads as PRINTED on the same stock as the
+ *                                  page, not pasted onto it.
+ *
+ * THE DATA-REGION MASK CONTRACT (M5, non-negotiable). Grain on the FRAME, never
+ * under the FIGURE — a fleck over a choropleth reads as a data artifact; on the
+ * plate margin it reads as paper. `paper-grain-overlay` exposes a custom-property
+ * MASK SLOT (`--paper-grain-mask`) so a consumer can carve the data viewport out
+ * of the grain ::after: set it to a gradient/`url()` that is transparent over the
+ * data region and opaque over the frame, and the grain is masked off the figure.
+ * Default `none` (the whole surface is grained — the page/card case, no data to
+ * fence). The plate rung is opt-in via `[data-grain="plate"]`.
  */
 
+/* The grain rung DEFAULTS — lifted off the tokens.css floor (D6.c M5). These are
+   plain custom-property fallbacks the utilities read; a consumer/tokens.css value
+   still wins (`var(--glass-grain-opacity, <floor>)`), so this only sets the floor
+   a no-override mount inherits. The plate rung is minted here (no canonical
+   tokens.css home is touched in this lane — D6.b owns tokens.css). */
+@layer components {
+    :root {
+        /* The PLATE grain rung — distinct from the page rung; the figure's paper
+           wants more tooth. Minted in this lane; a consumer overrides at :root. */
+        --glass-grain-opacity-plate: 0.045;
+    }
+}
+
 @utility paper-underpaint {
     position: fixed;
     inset: 0;
@@ -17,7 +63,8 @@
     background-image: url("data:image/svg+xml,%3Csvg width='60' height='60' viewBox='0 0 60 60' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.65' numOctaves='4' stitchTiles='stitch'/%3E%3CfeColorMatrix type='saturate' values='0'/%3E%3CfeBlend mode='multiply' in2='SourceGraphic'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)' opacity='1'/%3E%3C/svg%3E");
     background-repeat: repeat;
     background-size: 60px 60px;
-    opacity: var(--glass-grain-opacity);
+    /* Lifted floor — the page grain is FELT at rest (0.038), not the dead 0.025. */
+    opacity: var(--glass-grain-opacity, 0.038);
     mix-blend-mode: multiply;
 }
 
@@ -39,8 +86,27 @@
         background-image: url("data:image/svg+xml,%3Csvg width='60' height='60' viewBox='0 0 60 60' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.65' numOctaves='4' stitchTiles='stitch'/%3E%3CfeColorMatrix type='saturate' values='0'/%3E%3CfeBlend mode='multiply' in2='SourceGraphic'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)' opacity='1'/%3E%3C/svg%3E");
         background-repeat: repeat;
         background-size: 60px 60px;
-        opacity: var(--glass-grain-opacity);
+        /* Lifted floor — felt on the frame at rest (0.038). */
+        opacity: var(--glass-grain-opacity, 0.038);
         mix-blend-mode: overlay;
+        /* THE DATA-REGION MASK SLOT (M5). Default `none` = the whole surface is
+           grained (page/card — no data to fence). A consumer that grains a chart
+           plate sets `--paper-grain-mask` to a gradient/url() transparent over the
+           data viewport + opaque over the frame, carving the figure out of the
+           grain so no fleck lands on a tier fill. `mask` is Baseline; a
+           non-supporting engine ignores it and keeps the full-surface grain (the
+           page case is unaffected — the mask only matters when a consumer fences
+           the data region). */
+        mask: var(--paper-grain-mask, none);
+        -webkit-mask: var(--paper-grain-mask, none);
+    }
+
+    /* The PLATE rung — a chart plate opts in via `[data-grain="plate"]` to the
+       higher-tooth `--glass-grain-opacity-plate` (the figure's paper reads as the
+       same stock as the page, with a touch more tooth). Pair with the mask slot to
+       fence the data viewport. */
+    &[data-grain="plate"]::after {
+        opacity: var(--glass-grain-opacity-plate, 0.045);
     }
 }
 

package/dist/styles/theme.css

@@ -308,6 +308,13 @@
     --color-gold: var(--gold);
     --color-gold-light: var(--gold-light);
     --color-gold-dark: var(--gold-dark);
+    --color-gold-deep: var(--gold-deep);
+    /* D6.b — the gilt family: the rim (gilt edge) + the legible gold ink. The
+       `@theme` bridge surfaces `text-gold-ink` / `border-gold-rim` utilities
+       beside the existing gold quad. `--gold-ink` clears cream-law ② on `--card`
+       in both arms (proof:gold-ink-contrast). */
+    --color-gold-rim: var(--gold-rim);
+    --color-gold-ink: var(--gold-ink);
 
     --color-rainbow-red:    var(--rainbow-red);
     --color-rainbow-orange: var(--rainbow-orange);

package/dist/styles/tokens.css

@@ -80,9 +80,12 @@
     --duration-xxl: 1.5s;
     --duration-shimmer-fast: 3s;
     --duration-shimmer: 5s;
-    /* Sparkle micro-event — primary-CTA disco-grain sparkle sweep, success
-       affirmations. R5 vocab.γ gap row 3 (single-site at dock.css:735 today,
-       reserved for J.W2.7 §17 audacious-CTA buildout). */
+    /* Sparkle micro-event — primary-CTA disco-grain sparkle sweep.
+       @deprecated 3.10 — the disco-star is EXCISED (D6.b); the `sparkle-sweep`
+       keyframe is tombstoned (animations.css) and no live recipe consumes this
+       duration. Retained one minor so an out-of-tree consumer resolves a value
+       rather than `unset`; full delete (this token + the theme bridge + the
+       keyframe) lands in 3.11. */
     --duration-sparkle: 600ms;
 
     /* AH.W5-e (FA-8 §4d) — motion-duration + staged-reveal canon.
@@ -181,7 +184,7 @@
        The BUTTON family (`.btn-pill` / `.tap-squish` / `.glass-btn` /
        `btn-interactive`) UNIFIES its `scale` transform leg onto ONE register —
        `--spring-smooth` — so hover + press read as one motion language (the
-       hover lift is the restrained `--scale-hover-btn` = 1.035, not the 1.08
+       hover lift is the restrained `--scale-hover-btn` = 1.05, not the 1.08
        `--scale-hover`). Springs read alive on TRANSFORM and ENTER (overshoot =
        physicality); a spring on a COLOR or an EXIT reads as a wobble/hesitation.
        `--ease-apple` is the ambient-only register (consumed solely by the Pulse
@@ -511,6 +514,26 @@
        field recedes further: BELOW the slides 0.92 max-legibility reference. */
     --constellation-alpha:               0.80;
 
+    /* §interaction — the warp spring + the gravity-well tunings (NUMERIC, NOT
+       colors — read ONCE on mount via parseFloat, never reach a Canvas2D
+       fillStyle, so immune to the W30 light-dark()/Canvas2D leak; AY.W-CON2).
+       Mode-INVARIANT, declared ONCE in :root (the .dark arm needs no numeric
+       re-declare — a per-mode value SPLIT is what proof:constellation-tokens
+       clause (c) flags, and these tunings are identical in both modes).
+       `--constellation-warp-response` is the keyframes.js ANGULAR PERIOD (the
+       SwiftUI .spring(response:) axis), NOT a settle-duration — at ζ=1 the 2%
+       settle lands at t₂ ≈ 5.83/ω₀ ≈ 0.93·response (the engine keeps the
+       keyframes.js ω₀ = 2π/response convention, mints no second ω). */
+    --constellation-warp-response:    0.55;   /* s — keyframes.js angular period (NOT a settle) */
+    --constellation-warp-zeta:        1.0;    /* critically damped — a focal mark must NOT ring */
+    --constellation-well-gain:        14000;  /* inverse-square force scale (the held-pull gain) */
+    --constellation-well-reach:       340;    /* base-width px — the well's reach (k-scaled at step) */
+    --constellation-well-ramp:        4.0;    /* 1/s — the ARM rate (≈0.25s bloom; release is the fixed brisk WELL_RELEASE_RAMP — the field-cools invariant, not consumer-tunable) */
+    --constellation-well-max-speed:   4.0;    /* base-width px/frame cap — the no-slingshot clamp */
+    --constellation-well-hold-ms:     140;    /* ms hold before the well arms */
+    --constellation-wander-idle:      8000;   /* ms — min idle between auto re-targets (the W-CON1 drift cadence) */
+    --constellation-wander-jitter:    8000;   /* ms — random extra idle per cadence (so the rhythm is not metronomic) */
+
     /* ═══════════════════════════════════════════════
        §6  SECTION PALETTE — 13-stop jewel tones (light)
        ═══════════════════════════════════════════════ */
@@ -1052,13 +1075,22 @@
 
     /* Overlay scrim rungs — substrate-aware modal/dialog backdrop tints.
        Three weights cover the deployed range: dialog-scroll (subtle),
-       canonical modal (default), drawer/full-cover (strong). Currently
-       5 raw `bg-black/{40,50,80}` sites across Dialog/Sheet/Drawer/
-       ConfirmDialog hardcode the value; W2.A migrates consumers.
-       R5 vocab.γ gap row 2. */
-    --overlay-scrim:         color-mix(in srgb, var(--shadow-color) 50%, transparent);
-    --overlay-scrim-strong:  color-mix(in srgb, var(--shadow-color) 80%, transparent);
-    --overlay-scrim-subtle:  color-mix(in srgb, var(--shadow-color) 40%, transparent);
+       canonical modal (default), drawer/full-cover (strong).
+
+       AY.W-PRIM-POLISH D3 — the scrim is its OWN identity token, NOT derived
+       from `--shadow-color`. A scrim's role is to RECEDE: it must pin to INK in
+       BOTH modes. The cartoon-shadow family rides `--shadow-color: var(--foreground)`
+       (correct — a shadow re-tints under `.dark` by construction), but a scrim
+       that does the same FLOODS the dark room with a cream fog (the old dark
+       overlay painted `srgb(0.91… / 0.5)`, a near-white wash that BRIGHTENED the
+       page at the modal moment). `--overlay-scrim-ink` is a fixed warm near-black
+       (the light-mode `--foreground` value), re-resolved verbatim in `.dark` so
+       the scrim recedes in both modes. Clean break, no alias (no-backwards-compat).
+       The `--shadow-color` / `--shadow-cartoon-*` family is UNTOUCHED. */
+    --overlay-scrim-ink:     hsl(24 10% 10%);
+    --overlay-scrim:         color-mix(in srgb, var(--overlay-scrim-ink) 50%, transparent);
+    --overlay-scrim-strong:  color-mix(in srgb, var(--overlay-scrim-ink) 80%, transparent);
+    --overlay-scrim-subtle:  color-mix(in srgb, var(--overlay-scrim-ink) 40%, transparent);
 
     /* ═══════════════════════════════════════════════
        §9  ANIMATION OFFSETS
@@ -1485,8 +1517,15 @@
     --opacity-icon-muted: 0.8;
 
     --focus-ring-width: 2px;
-    --focus-ring-shadow: 0 0 0 var(--focus-ring-width) color-mix(in srgb, var(--ring) 30%, transparent),
-        0 0 8px color-mix(in srgb, var(--ring) 15%, transparent);
+    /* D6.b — the focus-ring color routes through a `--focus-ring-color`
+       indirection (default `--ring`, so the resolved shadow is byte-identical to
+       the prior hard `--ring` recipe). An opt-in channel (the `focus-ring-gold`
+       utility, utilities.css) overrides ONLY this color to mint a gilded
+       "you are here / this is live" ring — gold is the transient STATE voice;
+       the resting active mark stays its structural color (the four-voice law). */
+    --focus-ring-color: var(--ring);
+    --focus-ring-shadow: 0 0 0 var(--focus-ring-width) color-mix(in srgb, var(--focus-ring-color) 30%, transparent),
+        0 0 8px color-mix(in srgb, var(--focus-ring-color) 15%, transparent);
     --focus-ring: var(--focus-ring-shadow);
 
     /* ═══════════════════════════════════════════════
@@ -1508,10 +1547,40 @@
     --gold: oklch(0.751 0.147 84.2);
     --gold-light: oklch(0.890 0.183 96.1);
     --gold-dark: oklch(0.599 0.132 64.2);
+    /* AY.W-PRIM-POLISH D1 — the saturated CTA plate the AW.W13 gold-CTA contract
+       names. A FIXED deep gold (mode-INVARIANT — the gold-CTA hover backplate must
+       be dark in BOTH modes so the white label clears ≥4.5:1; deepening toward the
+       mode-flipping `--foreground` brightened the dark plate to a cream-gold and
+       broke dark). ~`--gold-dark` deepened toward warm-ink → ~rgb(120,87,45),
+       6.5:1 white in light / 5.5:1 in dark. The opaque base of `btn-audacious-gold`
+       :hover. */
+    --gold-deep: oklch(0.487 0.103 63.0);
+
+    /* D6.b — the chrome-gold additions (the rim + the legible ink), completing
+       the gold quad into the gilt FAMILY. Gold is a metal, not a hue — it must
+       read as reflectance, so it lives at the EDGE and the HIGHLIGHT, rarely as
+       an area.
+
+       --gold-rim — the gilt EDGE catch: `--gold` at 40% over the surface, the
+       1px tooled bevel light the `.glass-gilt` modifier + the gilt dock button
+       paint. Non-text → no contrast floor.
+
+       --gold-ink — legible gold-toned TEXT. Derived (NOT guessed) to clear the
+       cream-law ② floor (APCA |Lc| ≥ 45) against `--card` in BOTH arms; the raw
+       `--gold-dark` does not (it was minted as a plate hue). LIGHT arm:
+       oklch(0.560 0.118 70) → |Lc| 69.9 on the cream `--card` (hsl 48 12% 98%).
+       The dark-arm pair lifts L (the warm-dark stock) in the `.dark` block,
+       reaching |Lc| 77.1 on the dark `--card`. Both verified by
+       `proof:gold-ink-contrast`. */
+    --gold-rim: color-mix(in oklab, var(--gold) 40%, transparent);
+    --gold-ink: oklch(0.560 0.118 70);
 
     --color-gold: var(--gold);
     --color-gold-light: var(--gold-light);
     --color-gold-dark: var(--gold-dark);
+    --color-gold-deep: var(--gold-deep);
+    --color-gold-rim: var(--gold-rim);
+    --color-gold-ink: var(--gold-ink);
 
     /* ═══════════════════════════════════════════════
        §14 RAINBOW PALETTE — oklch (AV.W16 TW2; mode-independent, no .dark
@@ -1767,8 +1836,18 @@
        flat ease. STRICTLY transform-scoped: it must never touch the surface-tier
        `[data-held]` fades (background/border/box-shadow), which stay on
        `--duration-fast var(--ease-standard)`. The duration pairs with
-       `--duration-fast`; consumers retune the whole feel via this one token. */
-    --dock-press-spring: var(--duration-fast) var(--spring-bouncy);
+       `--duration-fast`; consumers retune the whole feel via this one token.
+
+       AY.W-DOCK2 (D6) — the register is `--spring-smooth`, the §6 easing-doctrine
+       transform-press register (tokens.css §2: transform hover/press/active →
+       `--spring-smooth`/`--spring-snappy`, NEVER `--spring-bouncy`; a press must
+       settle, never overshoot into a visible bounce). The prior `--spring-bouncy`
+       ROOT default was off-doctrine, shadowed for the four named controls by a
+       per-surface re-point in dock-controls.css — the exact per-surface fork the
+       doctrine kills. The re-point is now a DEAD byte-identical redeclaration and is
+       DELETED; the ROOT token IS the doctrine register, so any other consumer of
+       `--dock-press-spring` inherits the correct smooth register. */
+    --dock-press-spring: var(--duration-fast) var(--spring-smooth);
 }
 
 /* AX.W51 D18 — the GLOBAL coarse-pointer comfort amplification. The WHOLE library
@@ -2112,6 +2191,13 @@
     --gold: oklch(0.784 0.143 86.0);
     --gold-light: oklch(0.898 0.182 97.4);
     --gold-dark: oklch(0.678 0.150 63.8);
+    /* D6.b — the dark-arm gilt ink. `--gold-rim` auto-re-resolves (its color-mix
+       reads the dark `--gold` above — no override). `--gold-ink` MUST lift L for
+       the dark `--card` (hsl 24 8% 10%): a deep gold-dark ink would vanish into
+       the near-black plate, so the dark ink is a BRIGHT gold —
+       oklch(0.860 0.158 90) → |Lc| 77.1 on the dark `--card` (cream-law ②;
+       verified by proof:gold-ink-contrast). */
+    --gold-ink: oklch(0.860 0.158 90);
 }
 
 /* ═══════════════════════════════════════════════

package/dist/styles/transitions.css

@@ -184,10 +184,28 @@
      * surface). The grammar is single-event entrance + dwell + exit;
      * the next toast (if any) enters on its own contract.
      *
+     * §6 EASING-DOCTRINE EXEMPTION (AY.W-MOTION — DELIBERATE KEEP).
+     * Every glass-ui-OWNED entrance surface (`dialog-scale`, `pop`,
+     * `dropdown`, `fade-slide`, `dock-in`) rides the house `--spring-*`
+     * enter / `--ease-out`/`--ease-standard` exit vocabulary (the §6
+     * doctrine, tokens.css:162-190). The Toast does NOT — and that is
+     * BY DESIGN, not an unexamined default. The reka-ui `ToastRoot`
+     * primitive OWNS its data-state choreography: the entrance slide
+     * direction tracks the viewport origin AND the swipe-end gesture
+     * (`data-[swipe=end]:slide-out-to-right-full`), so the entrance/exit
+     * are coupled to reka's `tw-animate-css` data-state machinery. The §6
+     * spring vocabulary governs glass-ui-OWNED surfaces; the reka-Toast
+     * entrance is not one — re-authoring it onto a `<Transition>` would
+     * fork the primitive's swipe-coupled contract (and `tw-animate-css`
+     * is the shipped optionalPeer this contract depends on). The gate
+     * (proof:animation-coherence) carries the Toast surface in its
+     * REGISTER_ASSIGNMENT_ALLOW set so this keep reads as a gated,
+     * deliberate exemption.
+     *
      * PRM is honoured at the `@media (prefers-reduced-motion: reduce)`
      * block below — the slide motion retires; the fade-in/out
-     * remains. No source change in W4; this comment block IS the
-     * documentation closure for the W4-M.3 toast contract row.
+     * remains. No source motion change; this comment block IS the
+     * documentation closure for the toast contract row.
      */
 
     /* ── Reduced motion: preserve fades, remove transform/scale motion ── */