@mkbabb/glass-ui 4.0.1 → 4.2.0

package/dist/styles/tokens/dark-arm.css

@@ -71,8 +71,8 @@
     /* BA.W-DARK-MATERIAL scope 1 — the --card plate LIFTS L10→L16 (a warm-dark elevated
        surface, macOS-window territory) so it sits ~5× the deepened L4 page relL — a
        clearly distinct surface the five glass rungs ladder up from. LOCKSTEP light-dark.css:80. */
-    --card: hsl(24 8% 16%);
-    --popover: hsl(24 8% 16%);
+    --card: hsl(26 22% 17%);
+    --popover: hsl(26 22% 17%);
 
     /* R0G-5 (AO.W4) — dark mirror of the warm-neutral public-data panel.
        --card's dark hsl(24 8% 16%) nudged one warmth step toward amber
@@ -164,12 +164,28 @@
     --warning-foreground: hsl(24 10% 10%);
     --info-foreground:    hsl(48 10% 96%);
 
-    --shadow-cartoon:       3px 3px 0px 0px color-mix(in srgb, var(--foreground) 6%, transparent);
-    --shadow-cartoon-hover: 4px 4px 0px 0px color-mix(in srgb, var(--foreground) 8%, transparent);
+    /* BD.W-CARTOON-CEL-INK — the WARM DARK ink. In dark, `--foreground` flips to
+       near-cream, so the SAME `oklch(from --foreground …)` construction would lift the
+       ink toward a light warm LINE (the iOS-7-sticker glow). A cel cast is dark INK on
+       any cel — so the dark ink is built by the SAME `oklch(from)` mechanism (NOT a
+       hardcoded `oklch(0.22 0.07 70)` literal — the H3/R6 retirement) but L-TARGETED to
+       a warm MID-tone: `clamp(0.20, 1 − l, 0.30)` deepens the flipped-cream L back down
+       to a warm dark mid that READS as a defined edge against the near-black `--card`
+       (ΔL ≥ 0.12), chroma floored `max(c, 0.11)` for TECHNICOLOR, hue preserved. The
+       opacity rungs floor UP (46/38/26%) for presence on the dark ground. Plain `.dark`
+       ancestor — NO `:global()`, NO `light-dark()` (the recorded traps). */
+    --cartoon-ink: oklch(from var(--foreground) clamp(0.20, calc(1 - l), 0.30) max(c, 0.11) h);
+    --cartoon-ink-lead:    color-mix(in oklab, var(--cartoon-ink) 46%, transparent);
+    --cartoon-ink-mid:     color-mix(in oklab, var(--cartoon-ink) 38%, transparent);
+    --cartoon-ink-contact: color-mix(in oklab, var(--cartoon-ink) 26%, transparent);
+    --cartoon-ink-fallback: #5a3f28;
+
+    --shadow-cartoon:       -3px 3px 0px 0px var(--cartoon-ink-lead);
+    --shadow-cartoon-hover: -4px 4px 0px 0px var(--cartoon-ink-lead);
     --shadow-soft:     0 4px 12px rgba(0, 0, 0, 0.3);
     --shadow-elevated: 0 8px 24px rgba(0, 0, 0, 0.35);
     --shadow-modal:
-        4px 4px 0px 0px color-mix(in srgb, var(--foreground) 6%, transparent),
+        -4px 4px 0px 0px var(--cartoon-ink-lead),
         0 24px 64px color-mix(in srgb, var(--foreground) 18%, transparent);
 
     --shadow-cartoon-color:            rgb(255 255 255 / 0.07);
@@ -214,7 +230,20 @@
     --glass-opacity-floating: 0.88;
     --glass-opacity-overlay:  0.96;
     --glass-opacity-chassis:  0.36;
+    /* BC.W-DIALOG-GLASS — the dialog dark register lifts ~0.08 over the light arm
+       (0.68 → 0.76) for read-weight over the deep canvas, mirroring the dark opacity
+       ladder (it sits between dark `resting` 0.72 and `floating` 0.88 — see-through
+       but legible over the deep page). The SAME named token as the light arm, per-
+       mode; the composed `--glass-bg-dialog` (glass.css :root) re-resolves from it
+       automatically per mode. */
+    --glass-opacity-dialog:   0.76;
     --glass-grain-opacity: 0.045;
+    /* BD.W-PAPER-MORPHISM — re-calibrated to the JND floor for the CORRECTED coarse
+       tooth + SCREEN blend (std ≥ 3.86 dark): screen on the ink pole BITES HARD so it
+       needs LESS alpha (the honest inversion the measurements force — the opacity
+       ladder light→dark 0.22→0.16 ≈ ×1/√φ, dark steps DOWN). Was 0.11 on the
+       self-cancelling soft-light arm. */
+    --paper-grain-opacity: 0.16;
     --glass-highlight: inset 0 0.5px 0 0 hsl(0 0% 100% / 0.08);
 
     /* BA.W-DARK-MATERIAL scope 2 — dark glass is TRANSMISSIVE. The dark rung
@@ -225,13 +254,35 @@
        aurora/page behind reads with chroma + a glow. The blur() RADIUS is the
        light-arm primitive UNTOUCHED (W-GLASS-CAL owns the radius dial-back) — only the
        saturate/brightness COMPANIONS lift here. The lower rungs lift more (they're
-       thinner, the backdrop carries the read); the heavy overlay lifts least. */
-    --glass-blur-wash:     blur(calc(var(--glass-blur-wash-radius) * var(--glass-level))) saturate(1.35) brightness(1.18);
-    --glass-blur-quiet:    blur(calc(var(--glass-blur-quiet-radius) * var(--glass-level))) saturate(1.35) brightness(1.16);
-    --glass-blur-resting:  blur(calc(var(--glass-blur-resting-radius) * var(--glass-level))) saturate(1.30) brightness(1.14);
-    --glass-blur-floating: blur(calc(var(--glass-blur-floating-radius) * var(--glass-level))) saturate(1.28) brightness(1.10);
-    --glass-blur-overlay:  blur(calc(var(--glass-blur-overlay-radius) * var(--glass-level))) saturate(1.22) brightness(1.06);
-    --glass-blur-dock:     blur(calc(var(--glass-blur-dock-radius) * var(--glass-level))) saturate(1.30) brightness(1.12);
+       thinner, the backdrop carries the read); the heavy overlay lifts least.
+
+       BC.W-GLASS-LEGIBILITY-MEASURED — the per-rung `--glass-saturate-{tier}` knob
+       (the speedtest-AX BC-W10 fold) is the SAME named register as the light arm
+       (tokens/glass.css), per-mode — the dark identity. The dark values ARE this
+       scope's luminosity lift (wash/quiet 1.35, resting 1.30, floating 1.28, overlay
+       1.22) become the dark token defaults, and each `--glass-blur-{tier}` reads
+       `saturate(var(--glass-saturate-{tier}))` THROUGH — so a `.dark` override re-
+       resolves the rung saturation with ZERO recipe edit, AND the composed dark blur
+       is BYTE-IDENTICAL to the old baked literal. The `brightness()` companions stay
+       baked (this fold mints ONLY the saturate knob). The dark dock/deep saturate stay
+       baked (off-ladder footprint rungs, not part of the {wash..overlay} ladder).
+       Machine-locked by `proof:glass-legibility` L7. */
+    --glass-saturate-wash:     1.35;
+    --glass-saturate-quiet:    1.35;
+    --glass-saturate-resting:  1.30;
+    --glass-saturate-floating: 1.28;
+    --glass-saturate-overlay:  1.22;
+    --glass-blur-wash:     blur(calc(var(--glass-blur-wash-radius) * var(--glass-level))) saturate(var(--glass-saturate-wash)) brightness(1.18);
+    --glass-blur-quiet:    blur(calc(var(--glass-blur-quiet-radius) * var(--glass-level))) saturate(var(--glass-saturate-quiet)) brightness(1.16);
+    --glass-blur-resting:  blur(calc(var(--glass-blur-resting-radius) * var(--glass-level))) saturate(var(--glass-saturate-resting)) brightness(1.14);
+    --glass-blur-floating: blur(calc(var(--glass-blur-floating-radius) * var(--glass-level))) saturate(var(--glass-saturate-floating)) brightness(1.10);
+    --glass-blur-overlay:  blur(calc(var(--glass-blur-overlay-radius) * var(--glass-level))) saturate(var(--glass-saturate-overlay)) brightness(1.06);
+    /* W-NAV-DOCK-FIX — re-point the dark dock saturate to the named --glass-saturate-dock
+       knob (the single retune point in BOTH modes; the dark value 1.30 is declared here
+       so the descendant var() substitutes the dark value — the substitution-vs-redeclare
+       discipline). Value unchanged. */
+    --glass-saturate-dock: 1.30;
+    --glass-blur-dock:     blur(calc(var(--glass-blur-dock-radius) * var(--glass-level))) saturate(var(--glass-saturate-dock)) brightness(1.12);
 
     /* BB.W-DEEP-GLASS — the DARK arm of the OPT-IN deep tier (the luminous-dark
        deep mirror, the W-DARK-MATERIAL scope-2 "dark glass glows where light
@@ -264,6 +315,13 @@
        self-engage uses the AA arm directly (the luminous-dark lift is the desired default,
        not a sub-perceptual silhouette). */
     --glass-tint-strength-aa: 12%;
+    /* BD.W-DOCK-CORE (D4) — the dark §2c dock-ink lockstep (the MIRROR of the light
+       darken). In dark the dock tint is a LIFT toward a luminous warm-cream (L 0.90,
+       C 0.045) — `oklch(from var(--foreground) …)` extracts the dark foreground's warm
+       hue/chroma and lifts L (the dark `--foreground` is the light cream, so this stays a
+       luminous lift). The dark `--glass-tint-strength-aa` stays 12% (FROZEN,
+       W-DARK-MATERIAL). The dock self-engage reads this dock-scoped ink in BOTH modes. */
+    --glass-tint-ink-dock: oklch(from var(--foreground) 0.90 0.045 h);
     /* The unconditional content-tier self-engage (glass/ladder.css) reads
        --glass-tint-strength-floor. In LIGHT that is the 4% sub-perceptual silhouette (the
        calm-light card stays warm); in DARK the content tiers WANT the full luminous-dark
@@ -338,6 +396,30 @@
        resolves to the `-dark` alpha on the deeper canvas. */
     --glass-edge-light: var(--glass-edge-light-dark);
 
+    /* BC.W-BLACK-BAR D2 — the DIRECTIONAL rim dark arm (plain per-mode pair, NEVER
+       light-dark() round an inset — MEMORY: the inset-shadow trap). The top
+       catch-light lifts to 0.40 (the dark plate's fill barely separates from the deep
+       page, so the rim is the PRIMARY silhouette device — dark glass glows where light
+       passes; mirrors the --glass-edge-light-dark 0.18→0.22 lift). The bottom warm
+       under-shadow holds at 6% — the shadow grounds the plate in BOTH modes. */
+    /* BD.W-GLASS-KEY-EDGE — the dark rim rides the SAME `--glass-key-{lit,shade}-{x,y}`
+       sign tokens (inherited from :root — not re-declared here) so the dark plate's
+       lit edge agrees with the cartoon cast's key in both modes. The top/lit catch
+       lifts to 0.40 (the dark silhouette device); the key-facing side stop a touch
+       brighter (0.24). The shade under-shadow holds warm at 6%/4%. */
+    --glass-rim-top:
+        inset 0 var(--glass-key-lit-y) 0 hsl(0 0% 100% / 0.40),
+        inset var(--glass-key-lit-x) 0 0 hsl(0 0% 100% / 0.24);
+    --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);
+
+    /* BD.W-TAB-IOS-CAPSULE — the `.glass-capsule-track` recess ink, DARK arm (the
+       PLAIN per-mode pair's dark leg; the light arm is in `tokens/glass-fx.css`).
+       NEVER a `light-dark()` fragment (the inset-shadow trap). Deeper on the dark
+       canvas (11%) so the sunken well still reads against the near-black page. */
+    --tab-track-recess-ink: color-mix(in srgb, var(--foreground) 11%, transparent);
+
     /* AW.W23 — the chromatic-fringe + adaptive-tint dark arm. The fringe drops
        to a lower-luminance warm/cool pair on the deep canvas; `--glass-tint-
        source` auto-flips with `--card` (no override needed — the default already

package/dist/styles/tokens/glass-deep.css

@@ -18,7 +18,7 @@
  * dark companions).
  *
  * ── The Apple-range derivation (DELTA cross-ref) ───────────────────────────
- * Apple home nav:       saturate(1.8) blur(20px)  (the canonical measure)
+ * Apple home nav:       saturate(1.8) blur(20px)  (the canonical measure; the CEILING)
  * Apple product tiers:  blur(14-20px)             (the band)
  * glass-ui calm ceiling: floating 13px / saturate 1.18  (W-GLASS-CAL dial-back)
  * glass-ui DEEP:        16px / saturate 1.5        (STRICTLY deeper on BOTH axes,
@@ -29,14 +29,42 @@
  * and the warm-cream light-concentration ceiling (AX.W52 D19 — a saturate that
  * over-juices a colored substrate reads as a garish smear) keeps it just-rich.
  * The deepest BLUR carries the "more glass" read; the saturate stays restrained.
+ *
+ * ── The deep-tier BUDGET CALL (BC.W-GLASS-LEGIBILITY-MEASURED L4) ───────────
+ * The deep blur radius is the most expensive idiom glass-ui ships (`backdrop-
+ * filter` cost is super-linear in the radius past ~16px). The wave's call:
+ * STAY at the budget-clearing 16px and BOOK the 18-20px push (toward the live-
+ * measured apple.com nav `blur(20px)` ceiling, research/apple-glass.md §1.1)
+ * behind a recorded `profile:budget` clearance — the full 20px is the BOOKED
+ * successor (apple-ios27.md §1.4 "the full 20px booked"), NOT a silent over-
+ * spend. `--glass-saturate-deep-ceiling` BAKES the apple.com nav saturate 1.8 as
+ * the deep-tier CEILING (the load-bearing term — research/apple-glass.md §4
+ * "saturate 1.5 shipped, bake 1.8 as the deep ceiling"); the shipped
+ * `--glass-saturate-deep` 1.5 sits at the low end (≤ ceiling), warm-aurora-safe.
+ * `proof:glass-legibility` L4 reads BOTH: the 16px-stay is honest IFF the budget
+ * booking is recorded here, and the shipped deep saturate never crosses the 1.8
+ * ceiling. When a `profile:budget` run clears the 18-20px push, the radius
+ * lifts toward 20px on the SAME LERP (the booked successor lands, no recipe edit).
  */
 :root {
     /* The Apple-range deep ENDPOINTS — the radius + saturate the deep tier reaches
        at full depth (`--glass-depth: 1`). The calm `floating` rung (13px / 1.18)
        is the depth-0 floor; the deep recipe LERPs between the two on `--glass-depth`
        so the axis is a genuine driver, not a literal. */
-    --glass-blur-deep-radius:    16px; /* in [14,20], STRICTLY > calm floating 13px */
-    --glass-saturate-deep:       1.5;  /* >= 1.5 (toward Apple 1.8), > calm floating 1.18 */
+    --glass-blur-deep-radius:    16px; /* in [14,20], STRICTLY > calm floating 13px;
+                                          BUDGET CALL (L4): stays 16px, the 18-20px push
+                                          toward the apple.com nav ceiling is BOOKED
+                                          behind a recorded profile:budget clearance. */
+    --glass-saturate-deep:       1.8;  /* BD.W-GLASS-ABROGATE-GRAY — lifted 1.5→1.8 (the
+                                          apple.com nav ceiling) IN LOCKSTEP with FIX-D's
+                                          content/floating saturate lift, so the deep tier
+                                          STAYS the richest register (calm floating now 1.6;
+                                          deep must clear it). == --glass-saturate-deep-ceiling
+                                          (1.8 — at the bound, never over-shot, L4 holds). */
+    --glass-saturate-deep-ceiling: 1.8; /* the apple.com-nav saturate CEILING, BAKED as
+                                           the deep-tier load-bearing term (research/
+                                           apple-glass.md §4); the deep saturate never
+                                           exceeds it (the warm-cream identity bound). */
 
     /* The deep blur RADIUS — LERPed from the calm floating radius (depth 0) to the
        Apple-deep radius (depth 1) on `--glass-depth`, THEN scaled by the ONE
@@ -60,7 +88,8 @@
        chroma, it does NOT inject a hue; the warm-cream `--card` base is the same). */
     --glass-saturate-deep-active:
         calc(
-            1.18 + (var(--glass-saturate-deep) - 1.18) * var(--glass-depth)
+            var(--glass-saturate-floating)
+            + (var(--glass-saturate-deep) - var(--glass-saturate-floating)) * var(--glass-depth)
         );
 
     /* The composed deep backdrop-filter — the SEPARATE deep family. The calm

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