@mkbabb/glass-ui 4.0.1 → 4.2.0

package/src/styles/tokens/glass-fx.css

@@ -15,6 +15,16 @@
        so it sits at the perceptual floor. Dark companion drops 0.06 →
        0.045 below to keep the soft-light blend alive without stippling. */
     --glass-grain-opacity: 0.025;
+    /* BD.W-PAPER-MORPHISM — the PAPER grain is its OWN register (~3× the glass grain):
+       paper texture is MEANT to READ (the user: "I don't see any paper grain or grit
+       anywhere"), not sit at the glass perceptual floor. ONE token retunes paper grit
+       library-wide WITHOUT coarsening the subtle glass-material grain (the split keeps
+       glass calm + paper tactile). The dark arm (dark-arm.css) lifts it for soft-light. */
+    /* BD.W-PAPER-MORPHISM — re-calibrated to the JND floor for the CORRECTED coarse
+       tooth + multiply blend (std ≥ 4.5 light, the no-squint floor): multiply on the
+       cream pole is GENTLE so it needs MORE alpha. The prior 0.08 rode a blend
+       (overlay) that was mathematically incapable of moving a near-white pixel. */
+    --paper-grain-opacity: 0.22;
     /* BB.W-LIQUIDHOVER — the grain ENGAGE clock: a hover/active grain lift cross-fades
        the grain `::after` OPACITY on this thin ~120ms linear write while the
        `background-image` stays ALWAYS PRESENT (never a none→image swap — the one-frame
@@ -33,6 +43,20 @@
     --hairline-under-shadow: 0 0.5px 0 0 rgb(0 0 0 / 0.04);
     --border-hairline: var(--hairline-catch-light), var(--hairline-under-shadow);
 
+    /* BC.W-AX-METAL-GLOW — the brand-metal catch-light DEFAULTS (the consumer
+       retune seam). The metal-shimmer family (`.metal-{gold,silver,bronze}`,
+       metal.css) halos the text-clip with a `drop-shadow` of the metal's OWN base
+       hue at this radius + strength — the gold reads as LIT metal, not a flat fill.
+       Shared by the loop sweep AND the one-shot headline (the W-AX-COMPLETION-SEAL
+       seal glint reads `--metal-glow-blur`/`--metal-glow-opacity` — the ≥2-consumer
+       register). The defaults are a soft warm WHISPER bounded by the warm-cream
+       identity — a halo radius proportional to the text (0.5em) at a low strength
+       (0.35), NOT a neon bloom (the §6 calm register; the disco family stays gone).
+       A garish high-opacity glow is the consumer's preset choice, never the default;
+       a consumer who wants NO glow sets `--metal-glow-opacity: 0`. */
+    --metal-glow-blur-default: 0.5em;
+    --metal-glow-opacity-default: 0.35;
+
     /* Specular catch-light — 1.5px-tall top-edge highlight that swaps in for
        --glass-highlight on interactive moments (e.g. primary-action hover).
        Reads as a real catch-light on a curved surface. The `-dark` companion
@@ -54,6 +78,56 @@
        on text. The `-dark` companion is overridden inside `.dark` mirroring
        the `--glass-specular-dark` precedent. */
     --glass-edge-light:      inset 0 0 0 0.75px hsl(0 0% 100% / 0.18);
+
+    /* BC.W-BLACK-BAR D2 — the DIRECTIONAL rim register (the iOS-27 glass-thickness
+       physics: light catch-light rims the TOP, a faint warm shadow grounds the
+       BOTTOM, so the plate reads as a physical pane lifted off the page — NEVER a
+       dark full-perimeter ink hairline). This RETIRES the load-bearing dark-rim role
+       of the per-rung `--glass-border-*` (now ≤5% α, glass.css): the silhouette is
+       carved by these two stops, not by the perimeter ink.
+         --glass-rim-top: the BRIGHT catch-light on the top edge (the kevinbism
+           `inset 0 1px white` motif; 0.30 α = apple-ios27.md §1.3 community value
+           rgba(255,255,255,0.3)). Subsumes the old omnidirectional white rim RING.
+         --glass-rim-bottom: the FAINT warm under-shadow grounding the plate (the
+           warm-ink that used to ring the whole perimeter, now only the bottom, at a
+           whisper 6% — riding --foreground so it stays warm-not-grey, BA.W-NO-GRAY).
+       Plain per-mode arms — NEVER an inset fragment inside light-dark() (the dark arm
+       re-declares both in dark-arm.css; light-dark() round an inset computes the WHOLE
+       box-shadow to none). The dark arm lifts the top to 0.40 (dark glass glows where
+       light passes) + keeps the bottom under-shadow at 6%. */
+    /* BD.W-GLASS-KEY-EDGE — the cel KEYSTONE. ONE light vector (the 1940s cel
+       upper-right key) drives WHICH edge of the existing two-stop directional rim
+       reads LIT vs SHADE, in lockstep with the shipped `.shadow-cartoon-*` down-LEFT
+       cast (shadow.css `-Npx Npx` → key upper-right). The key is expressed NOT as a
+       `-58deg` angle with sign-inverted cos()/sin() trig (the glass-material sign
+       trap — banned here), but as two PLAIN per-axis sign tokens the rim stops read
+       directly: the LIT catch wraps the key-facing edges (top + right), the SHADE
+       under-shadow grounds the opposite edges (bottom + left). A consumer re-points
+       `--glass-key-lit-x`/`--glass-key-lit-y` to move the key (e.g. upper-LEFT →
+       `1px`/`1px`) and the rim re-reads off it with ZERO new layer, ZERO new conic,
+       ZERO new DOM node. The key's SIGN tokens below are the wired form (the
+       upper-right keystone). */
+    --glass-key-lit-x: -1px; /* the lit catch sits on the RIGHT edge (key-facing) */
+    --glass-key-lit-y: 1px; /* …and the TOP edge — the upper-right key */
+    --glass-key-shade-x: 1px; /* the under-shadow grounds the LEFT edge */
+    --glass-key-shade-y: -1px; /* …and the BOTTOM edge — opposite the key */
+    /* BC.W-BLACK-BAR D2 + BD.W-GLASS-KEY-EDGE — the two-stop directional rim, now
+       KEY-DRIVEN: the bright catch-light `--glass-rim-top` rides the lit (key-facing)
+       edges, the faint warm under-shadow `--glass-rim-bottom` rides the shade edges.
+       Which edge each lands on is `--glass-key-{lit,shade}-{x,y}` so the rim and the
+       cartoon cast AGREE on one light source (the cel coherence). At the default
+       upper-right key these resolve byte-compatibly to the shipped top-lit/bottom-shade
+       silhouette (top catch + bottom under-shadow) PLUS the key-facing side stops, so
+       the lit edge reads as a real lit pane corner, not a flat omnidirectional halo.
+       The accent (BB.W-GLASS-ACCENT) still mixes onto the lit ink in rim.css — at 0%
+       strength byte-identical. Plain per-mode arms — NEVER an inset fragment inside
+       light-dark() (the dark arm re-declares both in dark-arm.css). */
+    --glass-rim-top:
+        inset 0 var(--glass-key-lit-y) 0 hsl(0 0% 100% / 0.30),
+        inset var(--glass-key-lit-x) 0 0 hsl(0 0% 100% / 0.18);
+    --glass-rim-bottom:
+        inset 0 var(--glass-key-shade-y) 0 color-mix(in srgb, var(--foreground) 6%, transparent),
+        inset var(--glass-key-shade-x) 0 0 color-mix(in srgb, var(--foreground) 4%, transparent);
     /* BA.W-DARK-MATERIAL scope 2 — the dark edge/rim is the PRIMARY silhouette device in
        dark. The light register's fill+shadow carry the plate; in dark the fill barely
        separates (the deep page is near-black), so the EDGE + the transmitted glow carry the
@@ -83,6 +157,29 @@
     --glass-tint-source:   var(--card);
     --glass-tint-strength: 0%;
 
+    /* BD.W-TAB-IOS-CAPSULE — the `.glass-capsule` warm-floor (C6). `--card` itself
+       is too pale to clear the meanChroma ≥ 0.02 floor (its own OKLab chroma is
+       ~0.015), so the capsule composes a SMALL fixed floor toward an explicitly
+       WARM oklch source — a warm cream/amber that carries real chroma. This is the
+       build-trap-(d) safe form (a warm color, never bare `transparent`). At the 16%
+       floor the painted capsule fill clears chroma ≥ 0.02 with negligible L lift
+       (stays near-white). Mode-invariant warm (the oklch reads warm on both the
+       light cream page and the dark canvas — the warm-floor is a property of the
+       LOZENGE, not the page); the floor is INDEPENDENT of the `--glass-tint-strength:
+       0%` adaptive default (which is zero-delta at rest, lifting only under the
+       bright bucket). Both are composed in `.glass-capsule`'s fill. */
+    --glass-capsule-warm: oklch(0.88 0.1 75);
+    --glass-capsule-warm-floor: 16%;
+
+    /* BD.W-TAB-IOS-CAPSULE — the `.glass-capsule-track` recess ink (the iOS-27
+       sunken-well inner-top edge). A PLAIN per-mode pair — this light arm + the dark
+       arm in `tokens/dark-arm.css`. NEVER a `light-dark()` fragment: an inset-shadow
+       leg inside `light-dark()` computes the WHOLE `box-shadow` to `none` (the
+       binding MEMORY lesson) and the recess would silently vanish. Bounded warm ink
+       so it darkens the inner-top edge without re-coloring the warm fill (no gray
+       well). */
+    --tab-track-recess-ink: color-mix(in srgb, var(--foreground) 7%, transparent);
+
     /* AX.W55 — adaptive glass legibility (the iOS-26/27 "locally darken the glass
        over light content" move; G2). There is NO web API that reads the pixels
        painted BEHIND a `backdrop-filter` element, so the backdrop-luminance signal
@@ -120,8 +217,32 @@
        bucket blocks drive to; the live 4.5:1 readback (proof:adaptive-glass π arm)
        ratifies the exact value. */
     --glass-backdrop:           dark;
-    --glass-backdrop-luma:      ;
     --glass-tint-ink:           var(--foreground);
+
+    /* BD.W-DOCK-CORE (D1) — the warm-CHROMATIC dock tint ink (the keystone, RESEARCH-3).
+       The dock self-engage (dock/morph.css) mixes its thin ~0.42-alpha plate toward the
+       near-black `--foreground` (chroma ≈ 0.0062) → it darkens L with chroma DEAD-FLAT (the
+       gray dock the user reports). This dock-SCOPED ink extracts the foreground's warm
+       hue/chroma via `oklch(from …)` (the BB.W-DARK-INK-WARM idiom — NOT a new mechanism),
+       LIFTS the chroma to 0.05 (well above foreground's 0.0062), and DROPS L to 0.42 (the
+       darken anchor). At the bright-bucket AA engage the composited plate yields a WARM
+       material darken (C ≈ 0.016, ~2× HEAD, H ≈ 62°) — never gray. The OUTER mix stays
+       `color-mix(in oklab)` (the glass-tint family, AW.W26 in-srgb fence untouched); this
+       `oklch(from)` is only the INK SOURCE. The GLOBAL `--glass-tint-ink` above is FROZEN
+       (W-DARK-MATERIAL's whole-system register) — this is a NEW dock-scoped token read ONLY
+       by the dock self-engage (file-line-disjoint, no-dual-path). */
+    --glass-tint-ink-dock:      oklch(from var(--foreground) 0.42 0.05 h);
+
+    /* BC.W-ADAPTIVE-RECONCILE — the ONE retune knob for the continuous observer
+       driver. `--glass-backdrop-luma` (the measured sampled relative-luminance the
+       useGlassBackdropLuminance observer WRITES, registered typed in property-regs.css)
+       is now READ on the RHS of the `--glass-tint-strength` clamp (glass/ladder.css +
+       dock/morph.css): below this knee the plate holds the calm warm-cream floor; above
+       it the strength ramps CONTINUOUSLY toward the ≤24% AA ceiling (the iOS-27 dynamic-
+       range shift, apple-ios27.md §1.5 ~0.6 light threshold). The dead-knob is closed —
+       the loop READS. A consumer raising the knee darkens LATER (a brighter backdrop is
+       tolerated before the lift); the ONE override point for the whole adaptive axis. */
+    --glass-backdrop-luma-knee: 0.6;
     /* AZ.W-ADAPTIVE-AUTO Arm 1 — recalibrated 18% → 20%. The bump strengthens the
        G2 surface-SILHOUETTE darken (ΔL ≈ 0.40 over synthetic white, the plate is
        distinguishable from a bright page behind) while staying bounded ≤ 24% (the

package/src/styles/tokens/glass.css

@@ -91,12 +91,45 @@
        opacity-only register. */
     --glass-blur-dock-radius:     9px;
 
+    /* ── Per-rung SATURATE — the CANONICAL named saturate register (BC.W-GLASS-
+       LEGIBILITY-MEASURED, the speedtest-AX BC-W10 fold) ───────────────────────
+       The saturate term is the LOAD-BEARING glass knob (research/apple-glass.md §4:
+       the apple.com nav rides `saturate(1.8)` — the highest term, blur moderate).
+       Each `--glass-saturate-{tier}` is the library's canonical saturation for that
+       rung — a NAMED, `:root`-overridable input the composed `--glass-blur-{tier}`
+       reads THROUGH, the SAME substitution-vs-redeclaration discipline as the
+       `--glass-opacity-{tier}` alpha register above. A `:root { --glass-saturate-
+       quiet: … }` override re-resolves the rung's saturation with ZERO recipe edit
+       (the speedtest "dark cards" chronic + the apple-glass saturate-as-load-bearing
+       lever). The values here ARE the W52-D19 bake (wash/quiet/resting 1.05,
+       floating 1.18, overlay 1.2) become the token defaults — so the composed blur
+       is BYTE-IDENTICAL to the old baked literal (proof:glass-cal / proof:card-tier-
+       alpha stay GREEN by construction). The deep-tier `--glass-saturate-deep` 1.8
+       ceiling (glass-deep.css) is the upper bound; no rung saturate exceeds it. The
+       dark arm (tokens/dark-arm.css) re-declares this register with the W-DARK-
+       MATERIAL luminosity lift — the SAME named tokens, per-mode (the plain per-mode
+       pair idiom). The brightness() companions stay baked (this fold mints ONLY the
+       saturate knob). Machine-locked by `proof:glass-legibility` L7. */
+    --glass-saturate-wash:     1.4;
+    --glass-saturate-quiet:    1.4;
+    --glass-saturate-resting:  1.4;
+    --glass-saturate-floating: 1.6;
+    --glass-saturate-overlay:  1.6;
+    /* W-NAV-DOCK-FIX — the dock's named light-concentration saturate. The dock is a
+       calm chrome strip (the wash/quiet/resting register 1.4, NOT the floating 1.6).
+       Mirrors the dark arm's dock saturate; the single retune knob in both modes. The
+       light dock was the ONLY light surface with no saturate companion — over the flat
+       warm-cream page the un-saturated backdrop-filter pulled the cream toward neutral
+       (the flat-slab gray read). */
+    --glass-saturate-dock:     1.4;
+
     /* AX.W54 — each blur radius is scaled by the ONE `--glass-level` scalar (in
        lockstep with the opacity seam above): level=1 byte-identical; level=0 →
        blur(0) (the clean solid floor with the opacity); level>1 → more diffusion.
-       The per-rung `saturate()`/`brightness()` companions are UNTOUCHED (the level
+       The per-rung `saturate()` companion reads the named `--glass-saturate-{tier}`
+       knob (BC.W-GLASS-LEGIBILITY-MEASURED); `brightness()` stays baked (the level
        scales the RADIUS, not the saturation — W52's calm light-concentration). */
-    --glass-blur-wash:     blur(calc(var(--glass-blur-wash-radius) * var(--glass-level))) saturate(1.05);
+    --glass-blur-wash:     blur(calc(var(--glass-blur-wash-radius) * var(--glass-level))) saturate(var(--glass-saturate-wash));
     /* AV.W15 M1 — the `quiet` rung gained `saturate(1.05) brightness(1.02)`
        so the lower ladder reads with the same saturation life as `resting`+
        (Apple: Liquid Glass concentrates light, it does not desaturate). The
@@ -104,34 +137,93 @@
        between bare `wash` and `resting` without over-brightening the rung.
        The `prefers-reduced-transparency: reduce` bracket at glass.css maps
        `--glass-blur-quiet: none`, so this whole chain drops with the blur. */
-    --glass-blur-quiet:    blur(calc(var(--glass-blur-quiet-radius) * var(--glass-level))) saturate(1.05) brightness(1.02);
-    --glass-blur-resting:  blur(calc(var(--glass-blur-resting-radius) * var(--glass-level))) saturate(1.05);
+    --glass-blur-quiet:    blur(calc(var(--glass-blur-quiet-radius) * var(--glass-level))) saturate(var(--glass-saturate-quiet)) brightness(1.02);
+    --glass-blur-resting:  blur(calc(var(--glass-blur-resting-radius) * var(--glass-level))) saturate(var(--glass-saturate-resting));
     /* AX.W52 D19 — the floating/overlay backdrop saturate tamed from 1.4/1.5 to a
        gentle ~1.18/1.2 (real liquid glass concentrates light ~1.1–1.2×; the prior
        1.4–1.5× over-juiced the bleed-through into a garish smear over a colored
        substrate). wash/quiet/resting already sit at 1.05 — untouched. */
-    --glass-blur-floating: blur(calc(var(--glass-blur-floating-radius) * var(--glass-level))) saturate(1.18);
-    --glass-blur-overlay:  blur(calc(var(--glass-blur-overlay-radius) * var(--glass-level))) saturate(1.2);
+    --glass-blur-floating: blur(calc(var(--glass-blur-floating-radius) * var(--glass-level))) saturate(var(--glass-saturate-floating));
+    --glass-blur-overlay:  blur(calc(var(--glass-blur-overlay-radius) * var(--glass-level))) saturate(var(--glass-saturate-overlay));
     /* Dock blur composes blur() only — no saturate. */
-    --glass-blur-dock:     blur(calc(var(--glass-blur-dock-radius) * var(--glass-level)));
-
-    /* AX.W52 — the GLASS BUTTON blur. The `glass`/`glass-wash` button variants
-       compose the `.glass-wash` tier (`--glass-blur-wash` = blur(1px)) — a
-       sub-perceptual diffusion authored for a small detail TILE, not a button
-       the user reads as "glass." A button is a hero control: it wants a real
-       glass blur. `--glass-blur-btn` lifts the variant onto the `quiet`-tier
-       radius (10px — a genuine liquid-glass diffusion) with the same gentle
-       `saturate(1.05) brightness(1.02)` light-concentration the quiet rung
-       carries (NOT a colour-juice). The wash TILE tier (MetricCell et al.) keeps
-       its 1px — only the glass BUTTON variants reach for this. */
-    --glass-blur-btn:      blur(calc(var(--glass-blur-quiet-radius) * var(--glass-level))) saturate(1.05) brightness(1.02);
+    /* W-NAV-DOCK-FIX — the dock concentrates light like every other tier (apple-glass
+       §4): the saturate lifts the warm-cream chroma THROUGH the plate, the small
+       brightness is the light-concentration the quiet rung carries. The blur RADIUS is
+       untouched (the W-GLASS-CAL dial). Compositor-only (backdrop-filter is a paint op);
+       the prefers-reduced-transparency bracket maps --glass-blur-dock: none, so the
+       saturate drops with the blur (no separate carve owed). */
+    --glass-blur-dock:
+        blur(calc(var(--glass-blur-dock-radius) * var(--glass-level)))
+        saturate(var(--glass-saturate-dock))
+        brightness(1.02);
+
+    /* AX.W52 → BC.W-GLASS-LEGIBILITY-MEASURED — the GLASS BUTTON blur, lifted to
+       the FLOATING-tier "more glass" register. The `glass`/`glass-wash` button
+       variants compose the `.glass-wash` tier (`--glass-blur-wash` = blur(1px)) — a
+       sub-perceptual diffusion authored for a small detail TILE, not a button the
+       user reads as "glass." A button is a hero control: it wants a real glass blur.
+       The AX.W52 landing sat at the quiet-tier 8px/saturate(1.05) — "quieter than
+       even the calm floating tier" (apple-ios27.md §4.2). This wave lifts it to the
+       FLOATING-tier register (apple-ios27.md §5 bake-table "button blur lift to
+       10-13 / 1.18"): the floating radius (13px, in the 10-13 band) + the named
+       `--glass-saturate-floating` knob (1.18) — a genuinely MORE-glass transmissive
+       capsule revealing the craft beneath (the apple-glass SUPERSET: apple.com's web
+       CTA is a SOLID blue capsule, zero blur — research/apple-glass.md §1.4). The
+       `brightness(1.02)` light-concentration the quiet rung carried is KEPT (no
+       colour-juice). Clean break — the old 8px/quiet value is GONE, no alias. The
+       wash TILE tier (MetricCell et al.) keeps its 1px — only the glass BUTTON
+       variants reach for this. Machine-locked by `proof:glass-legibility` L3. */
+    --glass-blur-btn:      blur(calc(var(--glass-blur-floating-radius) * var(--glass-level))) saturate(var(--glass-saturate-floating)) brightness(1.02);
 
     /* Dock-specific opacity (0.42) — lighter than `resting` (0.65) so the dock
        reads as a translucent overlay rather than a panel, backdrop bleed
        visible through it. Consumed by `.glass-dock` via `--glass-bg-dock`. The
        value holds the surface register against the tightened 11px blur so the
        dock reads as painted chrome, not a frosted ghost. */
-    --glass-opacity-dock: 0.42;
+    /* BD.W-DOCK-CORE (D3) — the dock base alpha lifts 0.42 → 0.50 (margin-insurance for
+       the warm-chromatic darken: the base composite chroma closes a notch before any tint
+       engages). Stays the lightest chrome tier (below resting 0.65), mode-invariant. */
+    --glass-opacity-dock: 0.50;
+
+    /* Dialog-specific opacity (0.68) — BC.W-DIALOG-GLASS. The iOS-27 control-
+       center modal register: SEE-THROUGH frosted glass that reveals the page
+       beneath, NOT the floating-tier near-opaque slab (0.80 read as "NOT glassy
+       at all"). 0.68 sits between `resting` (0.65 — transparent enough to read
+       through) and `floating` (0.80 — opaque enough for AA legibility against
+       the bright bucket), so the modal floats with the FLOATING-tier lift (edge/
+       rim/under-shadow) while reading at the RESTING-tier transparency. The
+       LIBRARY iOS-modal identity (presets-in-consumers — a consumer retunes
+       `--glass-bg-dialog` via :root). Consumed by DialogContent.vue, which re-
+       declares `--glass-bg-floating: var(--glass-bg-dialog)` on the dialog scope
+       (the self-re-point recipe, the dock precedent — NOT a raw rung override
+       that won't re-compose). */
+    --glass-opacity-dialog: 0.68;
+
+    /* Sheet-specific opacity (0.74) — BE.W-SHEET-TRANSLUCENT. The iOS-27 bottom-
+       sheet register: SEE-THROUGH frosted glass whose lifted crown reveals the
+       page/album grid beneath, NOT the near-opaque overlay slab (0.95 read as "not
+       glassy"). 0.74 sits BETWEEN the dialog 0.68 (transparent enough that the
+       backdrop reads through) and the overlay 0.95 (opaque enough for AA body text
+       against a busy grid) — a sheet is content-bearing, so it sits a hair above the
+       dialog. The composed `--glass-bg-sheet` rides the SAME oklab-tint-wrapped
+       recipe `--glass-bg-dialog` speaks, so the W55 bright-bucket darken + the
+       `--glass-level` opaque escape + the dark-arm saturate companions reach the
+       sheet with ZERO new compositing seam. Drawer + Sheet self-re-point onto it.
+       Presets-in-consumers — a consumer retunes `--glass-opacity-sheet` via :root. */
+    --glass-opacity-sheet: 0.74;
+
+    /* Clear-specific opacity (0.58) — BE.W-CLEAR-VARIANT. The Apple-Clear MAXIMALLY
+       translucent register — the clearest rung the library ships, BELOW the dialog
+       0.68 (the now-playing pill, the Control-Center clear tile: the album grid
+       bleeds genuinely through). It is STRUCTURALLY coupled to a MANDATORY legibility
+       scrim (the `surface="clear"` decoration carries a `::before` backdrop-dim whose
+       strength derives from the sampled `--glass-backdrop-luma`) — a scrim-less clear
+       plate is FORBIDDEN by construction (the Apple Clear contract: near-transparent →
+       the text needs a scrim floor). 0.58 sits in the Apple-Clear band (clearer than
+       the modal 0.68, still a plate not a ghost — > 0.45). The composed
+       `--glass-bg-clear` rides the SAME oklab-tint-wrapped recipe so the W55 darken +
+       the `--glass-level` escape reach it. Presets-in-consumers — retune via :root. */
+    --glass-opacity-clear: 0.58;
 
     /* Dock foreground over an animated backdrop. A dock floating over an
        aurora/animated surface (`value.js` dock-over-aurora, a slides routed
@@ -178,22 +270,73 @@
        second hand-rolled recipe. */
     --glass-bg-dock:     color-mix(in oklab, color-mix(in srgb, var(--card) calc((1 - (1 - var(--glass-opacity-dock)) * var(--glass-level)) * 100%), transparent), var(--glass-tint-source) var(--glass-tint-strength));
     --glass-bg-chassis:  color-mix(in srgb, var(--card) calc((1 - (1 - var(--glass-opacity-chassis)) * var(--glass-level)) * 100%), transparent);
+    /* BC.W-DIALOG-GLASS — the dialog plate bg, composed the SAME oklab-tint-wrapped
+       way the dock self-re-points (so the BC.W-ADAPTIVE-RECONCILE darken reaches the
+       modal over a bright backdrop without a second hand-rolled recipe). The 0.68
+       opacity is the iOS-27 control-center register (see `--glass-opacity-dialog`).
+       DialogContent.vue re-declares `--glass-bg-floating: var(--glass-bg-dialog)` on
+       the dialog scope (the documented retune path — the self-re-point, NOT a raw
+       rung override) so the floating edge/rim/under-shadow LIFT survives the
+       transparency drop. */
+    --glass-bg-dialog:   color-mix(in oklab, color-mix(in srgb, var(--card) calc((1 - (1 - var(--glass-opacity-dialog)) * var(--glass-level)) * 100%), transparent), var(--glass-tint-source) var(--glass-tint-strength));
+    /* BE.W-SHEET-TRANSLUCENT — the bottom-sheet plate bg, composed the SAME oklab-
+       tint-wrapped way the dialog self-re-points (so the W55 darken + the dark-arm
+       saturate companion reach the see-through sheet without a second hand-rolled
+       recipe — byte-isomorphic to `--glass-bg-dialog`, only the opacity token
+       differs). Drawer + SheetContent re-declare `--glass-bg-floating:
+       var(--glass-bg-sheet)` on their scope (the self-re-point recipe — NOT a raw
+       rung override that won't re-compose) so the floating edge/rim/under-shadow LIFT
+       survives the transparency drop. */
+    --glass-bg-sheet:    color-mix(in oklab, color-mix(in srgb, var(--card) calc((1 - (1 - var(--glass-opacity-sheet)) * var(--glass-level)) * 100%), transparent), var(--glass-tint-source) var(--glass-tint-strength));
+    /* BE.W-CLEAR-VARIANT — the maximally-translucent Apple-Clear plate bg, composed
+       the SAME oklab-tint-wrapped way (so the W55 darken reaches the clear plate).
+       The `surface="clear"` decoration reads this fill AND couples its MANDATORY
+       `::before` legibility scrim (the scrim dims the BACKDROP — distinct from this
+       PLATE tint; the two axes stay disjoint). Byte-isomorphic to `--glass-bg-dialog`,
+       only the (lower) clear opacity differs. */
+    --glass-bg-clear:    color-mix(in oklab, color-mix(in srgb, var(--card) calc((1 - (1 - var(--glass-opacity-clear)) * var(--glass-level)) * 100%), transparent), var(--glass-tint-source) var(--glass-tint-strength));
+
+    /* ── BE.W-TINTED-CHIP — the per-INSTANCE PLATE-FILL tint axis (`--glass-fill-tint`
+       / `--glass-fill-strength`) ──────────────────────────────────────────────────
+       The THIRD per-instance chromatic axis (BESIDE the rim `--glass-accent` and the
+       whole-plate legibility `--glass-tint-source`): `--glass-fill-tint` tints the
+       plate BACKGROUND BODY toward a consumer DATA hue, so a glass surface reads as
+       COLORED GLASS (a green chip, a violet facet) without re-declaring the composed
+       `--glass-bg-*` token. DISTINCT-not-fork of `--glass-accent` (which tints only the
+       RIM + the `::before` specular CORE — file-line-disjoint): the fill writes the
+       plate body, the accent writes the rim; a chip may carry BOTH. The mix is `in
+       oklab` (the perceptual glass-tint family — NOT the in-srgb `--surface-tint-*`
+       brand-overlay fence, AW.W26). It rides ON TOP of the W55 legibility composite
+       (the plate still darkens-over-light for AA AND carries the data hue — additive,
+       never a replacement). At the `@property` defaults (transparent + 0%) the body is
+       byte-identical to today (`color-mix(in oklab, X, transparent 0%)` ≡ X — the no-op
+       floor). `<GlassChip :tone>` is the first-class consumer (BE.W-TINTED-CHIP
+       component) — the fill is read on the surface, never written into a `--glass-bg-*`
+       token here. The `@property` registration is below (the typed no-op floor). */
 
-    /* Composed borders — foreground-tinted. BA.W-NO-GRAY L3 — the warm RIM
-       re-anchor (G9). The rim IS warm (it rides --foreground, hsl-24 warm ink),
-       but at 8-12% α over a near-white plate it was a near-invisible hairline —
-       the plate had no carved silhouette, reading as a borderless gray rectangle
-       (the user's "no gray ... for cards"). The α lifts a few points per rung so
-       the warm hairline CARVES the silhouette (the WWDC25 "rim that defines the
-       silhouette" device, on the warm-ink register). Still bounded low — the rim
-       is a whisper that defines the edge, never a hard rule. The source stays
-       --foreground (the warm-ink tint, NOT a new color); only the presence lifts. */
-    --glass-border-wash:     color-mix(in srgb, var(--foreground) 11%, transparent);
-    --glass-border-quiet:    color-mix(in srgb, var(--foreground) 13%, transparent);
-    --glass-border-resting:  color-mix(in srgb, var(--foreground) 16%, transparent);
-    --glass-border-floating: color-mix(in srgb, var(--foreground) 19%, transparent);
-    --glass-border-overlay:  color-mix(in srgb, var(--foreground) 22%, transparent);
-    --glass-border-dock:     color-mix(in srgb, var(--foreground) 14%, transparent);
+    /* Composed borders — foreground-tinted. BC.W-BLACK-BAR D2 — the perimeter
+       hairline is RETIRED as the silhouette device. The old 11-22% warm-ink rung
+       borders rode --foreground (oklab L 0.216, near-black warm ink); over a
+       near-white cream plate the full-perimeter hairline read as the user's "wtf
+       is this black bar" — worst on the TOP edge where the bright white catch-light
+       ring sat just inside a dark border (a bright rim and a dark line at war on the
+       SAME edge). The silhouette is now carved by the directional rim
+       (--glass-rim-top catch-light + --glass-rim-bottom under-shadow, glass-fx.css),
+       NOT by this perimeter ink. So each rung drops to ≤5% α — the warm hue stays
+       --foreground (the warm-not-tinted identity, BA.W-NO-GRAY), only the PRESENCE
+       falls below the read-threshold so the hairline can never read as a bar. The
+       +1% on the two heaviest rungs (floating/overlay) holds a faint tier-presence
+       ordering without crossing the threshold (apple-ios27.md §5 "top ≤4%" target). */
+    --glass-border-wash:     color-mix(in srgb, var(--foreground) 4%, transparent);
+    --glass-border-quiet:    color-mix(in srgb, var(--foreground) 4%, transparent);
+    --glass-border-resting:  color-mix(in srgb, var(--foreground) 4%, transparent);
+    --glass-border-floating: color-mix(in srgb, var(--foreground) 5%, transparent);
+    --glass-border-overlay:  color-mix(in srgb, var(--foreground) 5%, transparent);
+    /* W-NAV-DOCK-FIX — the dock is FLOATING chrome over an UNKNOWN backdrop (unlike a
+       content card on the page), so it earns a readable warm-INK hairline (the iOS-27
+       edge-rim layer). 8% warm-ink is still a whisper, never a black bar (--foreground
+       H≈56° → a WARM rim, never a gray line). */
+    --glass-border-dock:     color-mix(in srgb, var(--foreground) 8%, transparent);
     --glass-border:          var(--glass-border-quiet);
 
     /* ── The control REST register (BA.W-SURFACE-AXIS scope 7) ────────────────
@@ -218,3 +361,52 @@
        under-shadow/overlay-scrim) lives in tokens/glass-fx.css (carved at BB.W-CARVE4
        — the next adjacent :root{} block in the cascade). */
 }
+
+/* ── BE.W5 foundation — the typed per-instance axes (the @property no-op floors) ──
+   Registered HERE beside the §8 glass tokens (the canonical @property idiom home is
+   tokens/property-regs.css; these foundation axes live with the §8 ladder they
+   compose so the BE Tier-0 foundation is one self-contained partial). Each mirrors the
+   `--glass-accent`/`--glass-accent-strength` registration shape: a `<color>` HUE +
+   a `<percentage>` STRENGTH, both `inherits: true` (a host sets them on any ancestor
+   to retune the sub-tree) with the NEUTRAL no-op identity (`transparent` / `0%`) so
+   an unset surface is byte-identical to today — `color-mix(in oklab, X, <hue> 0%)` ≡ X.
+   A malformed override CLAMPS to the initial-value (the typed fail-safe). */
+
+/* BE.W-AMBIENT-TINT — the backdrop hue the glass absorbs. `useGlassBackdropLuminance`
+   writes a sampled `oklch()` modal hue here (at a FIXED sub-perceptual chroma — a HUE
+   event, never the backdrop's saturation); a gray backdrop writes `transparent` (the
+   room tints nothing). The `transparent` initial-value is the neutral identity. */
+@property --glass-ambient-hue {
+    syntax: "<color>";
+    inherits: true;
+    initial-value: transparent;
+}
+
+/* The opt-in ambient bias knob — the EXISTING `--glass-tint-source` self-engage
+   re-point biases toward `--glass-ambient-hue` at this strength (bounded ≤ 8% in the
+   cascade — sub-perceptual under the W55 `--glass-tint-strength-aa` bound). `0%`
+   default is the no-op floor (the un-biased `--glass-tint-ink`); the dock wires it on. */
+@property --glass-ambient-strength {
+    syntax: "<percentage>";
+    inherits: true;
+    initial-value: 0%;
+}
+
+/* BE.W-TINTED-CHIP — the per-INSTANCE PLATE-FILL tint. A complete `<color>` data hue
+   the plate BODY mixes toward (`in oklab`, ON TOP of the W55 legibility composite —
+   DISTINCT from the rim `--glass-accent`). `transparent` is the neutral identity (the
+   no-op floor: `color-mix(in oklab, X, transparent 0%)` ≡ X). */
+@property --glass-fill-tint {
+    syntax: "<color>";
+    inherits: true;
+    initial-value: transparent;
+}
+
+/* The fill-tint bounded strength — `0%` default (an unset surface carries no fill
+   tint, byte-identical to today). A consumer (`<GlassChip :strength>`) dials it for a
+   louder colored-glass chip; the body ink stays legible (the W-ON-GLASS-FG floor). */
+@property --glass-fill-strength {
+    syntax: "<percentage>";
+    inherits: true;
+    initial-value: 0%;
+}

package/src/styles/tokens/light-dark.css

@@ -98,8 +98,8 @@
            BA.W-NO-GRAY L1 — the LIGHT arm DECOUPLES off the near-achromatic page onto the
            warm-cream plate hsl(36 48% 97%) (LOCKSTEP color-radius.css --card) so the light
            glass plate reads warm-not-gray; the dark arm is UNCHANGED (W-DARK-MATERIAL's). */
-        --card:                       light-dark(hsl(36 48% 97%), hsl(24 8% 16%));
-        --popover:                    light-dark(hsl(36 48% 97%), hsl(24 8% 16%));
+        --card:                       light-dark(hsl(30 85% 96%), hsl(26 22% 17%));
+        --popover:                    light-dark(hsl(30 85% 96%), hsl(26 22% 17%));
         --surface-public-data-panel:  light-dark(hsl(44 16% 96%), hsl(36 9% 18%));
 
         /* BA.W-DARK-MATERIAL scope 4 — the chromatic dark --primary (legendre-violet house
@@ -131,7 +131,7 @@
         --section-color-2:   light-dark(oklch(0.484 0.163 265.5), oklch(0.718 0.107 268.4));
         --section-color-3:   light-dark(oklch(0.542 0.089 222.8), oklch(0.767 0.091 219.9));
         --section-color-4:   light-dark(oklch(0.551 0.088 171.1), oklch(0.776 0.105 172.6));
-        --section-color-5:   light-dark(oklch(0.623 0.124 69.6),  oklch(0.813 0.109 78.2));
+        --section-color-5:   light-dark(oklch(0.530 0.124 69.6),  oklch(0.813 0.109 78.2));
         --section-color-6:   light-dark(oklch(0.579 0.201 30.4),  oklch(0.693 0.151 28.1));
         --section-color-7:   light-dark(oklch(0.532 0.180 317.5), oklch(0.739 0.134 318.1));
         --section-color-8:   light-dark(oklch(0.520 0.176 8.4),   oklch(0.709 0.142 2.3));

package/src/styles/tokens/offsets.css

@@ -108,6 +108,33 @@
        it claimed to back never read it — PopoverContent paints `p-4` directly), so
        it was an orphan declaration the golden-padding cut prunes. */
     --panel-padding:       0.375rem;
+
+    /* BC.W-OVERLAY-UNIFORM — the token-BACKING of the raw floating-overlay
+       literals (the token-beats-prop seam). Each defaults to the byte-identical
+       HEAD magnitude so a bare overlay is pixel-unchanged; a consumer retunes
+       EVERY overlay's min-width / max-block / tooltip type / select chevron from
+       ONE `:root` override (the uniformity payoff). These are token-backings of
+       EXISTING raw literals (`min-w-32` / `max-h-[60vh]` / tooltip `text-sm` /
+       chevron `opacity-50`) — NOT a new compositing register (the `surface` axis
+       + the φ `--overlay-pad-*` ladder are THREADED, not re-minted). */
+    /* `min-w-32` = 32 × 0.25rem = 8rem — the dropdown/select/context-menu min-width. */
+    --overlay-min-width: 8rem;
+    /* The collision-bounded max-block ceiling the dropdown (`max-h-[60vh]`) +
+       command list (`max-h-[300px]`) read. Defaults to 60vh — the viewport-
+       relative ceiling so a long menu scrolls inside the overlay rather than
+       running off-screen. (The Select precompiled `[data-slot="select-content"]`
+       max-height in select.css is the BA.W-EMISSION consumer-reach floor — KEPT,
+       not threaded here; see the census on-the-line row.) */
+    --overlay-max-block: 60vh;
+    /* The tooltip type rung — the golden quiet caption register (√φ ladder), the
+       token-backing of the bare `text-sm` on TooltipContent (the overlay share of
+       class 3). Defaults to `--type-caption` so the compact tooltip chip reads the
+       house caption scale; a consumer retunes the tooltip type from `:root`. */
+    --tooltip-text: var(--type-caption);
+    /* The Select trigger chevron opacity — the token-backing of the bare
+       `opacity-50` so a consumer retunes the affordance prominence from `:root`. */
+    --select-chevron-opacity: 0.5;
+
     --chart-height-compact: 15rem;
     --chart-height-default: 22.5rem;
     --chart-height-large: 25rem;