@mkbabb/glass-ui 4.0.1 → 4.2.0

package/dist/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/dist/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/dist/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;