@mkbabb/glass-ui 4.2.0 → 6.0.0

package/src/styles/glass/glass-atom.css

@@ -49,17 +49,17 @@
             var(--accent-fill-strength-in, 0%),
             var(--atom-tint-floor)
         );
-        /* The quiet register's tint application — the plate body mixes toward the
-           per-instance data hue ON TOP of the capsule's warm composite. At the
-           `@property` defaults (`--glass-fill-tint: transparent` / strength 0%)
-           this is the byte-identical no-op floor; the warm floor above keeps the
-           idle body warm even at a transparent tint. The mix is `in oklab` (the
-           perceptual glass-tint family — NOT the in-srgb brand fence). */
-        --glass-atom-tinted: color-mix(
-            in oklab,
-            var(--glass-capsule-warm) calc(var(--atom-tint-floor) + var(--glass-fill-strength)),
-            oklch(0.9 0.05 75 / 0)
-        );
+        /* The quiet register's tint application reads the SHARED per-instance PLATE
+           recipe `--glass-fill-tinted` (BG.W-GLASS-CONSUMER-BAND, tokens/glass.css) —
+           NOT a forked `color-mix` re-spell. The plate tints toward the per-instance
+           DATA hue (`--glass-fill-tint` at `--glass-fill-strength`), so a semantic
+           badge (`destructive`/`success`/`info`) reaches its hue — closing the prior
+           `.glass-atom` fork that mixed a FIXED `--glass-capsule-warm` cream regardless
+           of the data hue (the comment claimed "toward the per-instance data hue" while
+           the code ignored it). At the `@property` defaults this is the byte-identical
+           no-op (`color-mix(in oklab, X, transparent 0%)` ≡ X); the capsule's own warm
+           floor above keeps the idle body warm. ONE plate, ONE rim (`--glass-material-
+           rim`, the capsule carries it) — the shared plate/rim pair. */
         /* The motion register — the press/hover deform rides
            `--motion-weight × --ease-cartoon-punch`. The atom inherits the rest
            `--motion-weight: 0.618`; the loud register (`data-cast`, below) pushes
@@ -117,8 +117,8 @@
        `transparent` (challenge #1 R4 / #2 R4 — the WebKit desaturation fix). */
     .glass-atom[data-surface="glass"] {
         background-image: linear-gradient(
-            var(--glass-atom-tinted),
-            var(--glass-atom-tinted)
+            var(--glass-fill-tinted),
+            var(--glass-fill-tinted)
         );
     }
 
@@ -217,16 +217,19 @@
            A consumer overrides `--glass-fill-tint` per-instance for a bespoke hue. */
         --glass-fill-strength: var(--badge-glass-strength, 16%);
     }
-    /* Per-variant glass tint — the data hue the quiet body mixes toward. The
-       semantic plate token becomes the tint source (the loud fill demoted to a
-       transmissive hue). `secondary`/`outline` are the calm/neutral routes. */
+    /* Per-axis glass tint — the data hue the quiet body mixes toward. BI.W-SYNONYM-
+       RENAMES: the STYLE plate keys off `[data-variant]` (default/secondary/outline),
+       the SEMANTIC hue off `[data-tone]` (destructive/success/warning/info — a tone
+       is not a style). A set tone's rule follows the variant rule in source order, so
+       a `tone` capsule's hue wins the cascade — byte-identical to the former
+       per-`variant` tint map. `secondary`/`outline` are the calm/neutral routes. */
     .badge-atom--glass[data-variant='default'] { --glass-fill-tint: var(--primary); }
     .badge-atom--glass[data-variant='secondary'] { --glass-fill-tint: var(--glass-capsule-warm); }
     .badge-atom--glass[data-variant='outline'] { --glass-fill-tint: var(--glass-capsule-warm); }
-    .badge-atom--glass[data-variant='destructive'] { --glass-fill-tint: var(--destructive); }
-    .badge-atom--glass[data-variant='success'] { --glass-fill-tint: var(--success); }
-    .badge-atom--glass[data-variant='warning'] { --glass-fill-tint: var(--warning); }
-    .badge-atom--glass[data-variant='info'] { --glass-fill-tint: var(--info); }
+    .badge-atom--glass[data-tone='destructive'] { --glass-fill-tint: var(--destructive); }
+    .badge-atom--glass[data-tone='success'] { --glass-fill-tint: var(--success); }
+    .badge-atom--glass[data-tone='warning'] { --glass-fill-tint: var(--warning); }
+    .badge-atom--glass[data-tone='info'] { --glass-fill-tint: var(--info); }
 
     @media (prefers-reduced-motion: reduce) {
         .badge-atom {

package/src/styles/glass/glass-capsule.css

@@ -129,15 +129,47 @@
            scale of its own — the translate/squish are the morph primitive's writes) */
         scale: 1.015;
     }
-    .glass-capsule-hover:active {
+    .glass-capsule-hover:not([data-press-armed]):active {
         /* the --scale-press snap */
         scale: var(--scale-press-sm, 0.97);
     }
     @media (prefers-reduced-motion: reduce) {
         /* the lift is motion; the specular catch (a static legibility cue) stays. */
         .glass-capsule-hover:hover,
-        .glass-capsule-hover:active {
+        .glass-capsule-hover:not([data-press-armed]):active {
             scale: 1;
         }
     }
+
+    /* ── BI.W-DOCK-CONTROLS — the folded dock-control safe-inset (the face token) ──
+       The `--dock-control-safe-inset` 10% band-aid the user rejected FOLDS into the
+       FACE: the painted plate insets (`background-clip: content-box` over the inset
+       `padding`), while the HIT CELL stays the full `--dock-control-size` (the WCAG
+       2.5.5 ≥44px touch floor on the CELL, never the plate). Hit box ≠ paint box —
+       the clip fix (W-DOCK-SPINE's L1 `overflow: visible`) and the touch floor are
+       now DECOUPLED: A11Y-5's 17×40px defect dies because the hit box reads the full
+       cell while the painted plate insets independently.
+
+       DOCK-SCOPED (`.glass-dock` descendant) so NO other `.glass-capsule` consumer
+       (a glass Button, a Badge/IconChip/chip OUTSIDE a dock) inherits the content-box
+       clip — `--dock-control-safe-inset` resolves to 0 outside a dock anyway, but the
+       scope keeps the content-box clip off the broad capsule family. This is the ONE
+       home of the safe-inset routing (the standalone `padding`/`background-clip`
+       sites in the dock-control recipe files collapsed onto it — proof:dock-controls
+       C3). Two legs, ONE token home:
+       • the SHARED fill-inset — the painted plate clips to the content box so the
+         fill insets within the control's own padding / the safe-inset. Applies to
+         the whole dock capsule family (icon active plate + hover register).
+       • the ICON-SHAPE safe-inset padding — the ONE `--dock-control-safe-inset`
+         read. A fixed-square icon control needs `padding` to define a content box
+         SMALLER than the cell (the plate insets within the square); a text control
+         (tab/trigger) uses its OWN text padding as the inset, so the padding leg is
+         scoped to the icon shape (`.dock-icon-button`) — it never clobbers a text
+         control's or a nested strip's padding. */
+    .glass-dock :is(.glass-capsule, .glass-capsule-hover) {
+        background-clip: content-box;
+    }
+    .glass-dock .dock-icon-button {
+        padding: var(--dock-icon-padding, var(--dock-control-safe-inset, 0));
+    }
 }

package/src/styles/glass/glass-chip.css

@@ -86,21 +86,17 @@
            bolder warm-clearing stop so a selected default chip is tonal, not gray. */
         --accent-band-strength: max(18%, calc(var(--chip-tint-floor) + 10%));
 
-        /* ── The per-instance fill tint (BE.W-TINTED-CHIP CONSUME) ──
-           The translucent capsule body tints toward the consumer data hue ON TOP
-           of the W55 legibility composite. At the `@property` defaults
-           (`--glass-fill-tint: transparent` / strength 0%) this is the byte-
-           identical no-op (`color-mix(in oklab, X, transparent 0%)` ≡ X — the warm
-           floor above keeps the idle body warm even at a transparent tint). The
-           mix is `in oklab` (the perceptual glass-tint family). The 0-alpha stop is
-           warm `oklch(… / 0)`, never bare `transparent` (the WebKit black-
-           premultiply hole). */
-        --glass-chip-tinted: color-mix(
-            in oklab,
-            var(--glass-fill-tint, oklch(0.9 0.05 75 / 0))
-                var(--glass-fill-strength, 0%),
-            oklch(0.9 0.05 75 / 0)
-        );
+        /* ── The per-instance fill tint (BG.W-GLASS-CONSUMER-BAND CONSUME) ──
+           The translucent capsule body tints toward the consumer data hue via the
+           SHARED per-instance PLATE recipe `--glass-fill-tinted` (tokens/glass.css) —
+           NOT a forked `color-mix` re-spell (the chip read the SAME seam the atom
+           does, so this fold is net-neutral: both read the ONE plate). At the
+           `@property` defaults (`--glass-fill-tint: transparent` / strength 0%) it is
+           the byte-identical no-op (`color-mix(in oklab, X, transparent 0%)` ≡ X — the
+           warm floor above keeps the idle body warm even at a transparent tint). The
+           shared plate is `in oklab` over a warm `oklch(… / 0)` 0-alpha stop (never
+           bare `transparent` — the WebKit black-premultiply hole). ONE plate, ONE rim
+           (`--glass-material-rim`, the capsule carries it). */
 
         /* ── The ONE scale write (hover/press/punch, single source of truth) ──
            Folds the on-flood overshoot into ONE `scale` so it never collides with
@@ -132,8 +128,8 @@
            tinted layer is the warm 0-alpha no-op (invisible) and the capsule's warm
            body reads. */
         background-image: linear-gradient(
-            var(--glass-chip-tinted),
-            var(--glass-chip-tinted)
+            var(--glass-fill-tinted),
+            var(--glass-fill-tinted)
         );
     }
     .dark .glass-chip {

package/src/styles/glass/grain-overlay.css

@@ -0,0 +1,79 @@
+/* glass/grain-overlay.css
+   The glass-tier paper-grain `::after` overlay (BB.W-LIQUIDHOVER — the always-present
+   texture + the opacity-only engage + the PRM/reduced-motion carve + the `.dark`
+   soft-light arm).
+   Carved from glass/ladder.css at BG.W-CLOSEFIX-9SITE to hold the no-god-module 500-line
+   bound (the five-rung surface ladder + the W55 bright-bucket @container + the calm-tier
+   re-point + the contrast-color ink-flip + the opaque escape + the under-shadow modifier
+   stay in ladder.css; the rim/accent group is glass/rim.css). @import-ed by glass.css in
+   cascade order IMMEDIATELY AFTER ladder.css and BEFORE accent-tone.css — the SAME @layer
+   components; the grain `::after` is the SOLE writer of the `.glass-*::after` overlay so
+   the relocation is cascade-order-invariant (the grain block was the tail of ladder.css;
+   the dist is byte-isomorphic).
+   See docs/precepts/design-idioms.md §cohesion-aware partials. */
+@layer components {
+    /* Grain noise overlay — reuses paper texture SVG, no extra assets.
+       BB.W-LIQUIDHOVER — the disco-grain pop (T8-F6) killed at the COMPOSITION CLASS:
+       the `background-image` is ALWAYS PRESENT (decoded once at rest, NEVER toggled to
+       `none`), and any STATE-driven grain engagement cross-fades the `opacity` ONLY on
+       the thin `--glass-grain-engage-duration` (~120ms linear) clock. A `background-
+       image: none → var(--paper-clean-texture)` engage decodes-and-appears in one frame
+       (the pop); the opacity cross-fade is a compositor-cheap interpolation with the
+       image constant — the only sanctioned grain engage. The `transition` lives HERE so
+       a hover/active grain lift (wherever a glass surface raises grain on interaction)
+       reads as a smooth fade by construction, not a discrete swap. */
+    .glass-wash::after,
+    .glass-quiet::after,
+    .glass-resting::after,
+    .glass-floating::after,
+    .glass-overlay::after {
+        content: '';
+        position: absolute;
+        inset: 0;
+        border-radius: inherit;
+        /* The grain texture is the `background-image` longhand (NOT the `background`
+           shorthand) so the image stays a STABLE always-present layer the engage
+           never re-declares — the structural anti-pop: opacity is the only animated
+           channel, the image is never `none → image`. */
+        background-image: var(--paper-clean-texture);
+        background-repeat: repeat;
+        background-size: var(--paper-texture-size);
+        opacity: var(--glass-grain-opacity);
+        /* The opacity cross-fade engage — plain ~120ms linear direct-write (no spring,
+           no overshoot — instant-but-smooth per the ask). Under the PRM / reduced-
+           transparency brackets the clock collapses to 0ms (the a11y bracket below). */
+        transition: opacity var(--glass-grain-engage-duration, 120ms) linear;
+        pointer-events: none;
+        mix-blend-mode: overlay;
+    }
+
+    /* BB.W-LIQUIDHOVER — the grain engage collapses to INSTANT under reduced motion (a
+       grain that cross-fades on hover under reduce is still motion; accessibility is
+       absolute). The reduced-transparency / forced-colors brackets already zero
+       `--glass-grain-opacity` (a11y-fallback.css), so the grain is inert there; this
+       bracket covers the reduced-MOTION case where the grain still paints but must not
+       animate. */
+    @media (prefers-reduced-motion: reduce) {
+        .glass-wash::after,
+        .glass-quiet::after,
+        .glass-resting::after,
+        .glass-floating::after,
+        .glass-overlay::after {
+            transition: none;
+        }
+    }
+
+    /* The unified rim (AW.W22) + the BB.W-GLASS-ACCENT per-INSTANCE chromatic-RIM
+       tint group (the rim-ink + --glass-material-rim ring + the per-rung
+       --glass-border-accent border, light + dark arms) lives in glass/rim.css
+       (carved at BB.W-CARVE4 — the next adjacent @layer components block, the SOLE
+       writer of --glass-material-rim/--glass-border-accent). */
+
+    .dark .glass-wash::after,
+    .dark .glass-quiet::after,
+    .dark .glass-resting::after,
+    .dark .glass-floating::after,
+    .dark .glass-overlay::after {
+        mix-blend-mode: soft-light;
+    }
+}

package/src/styles/glass/ladder-undershadow.css

@@ -0,0 +1,61 @@
+/* glass/ladder-undershadow.css
+   The ladder tail: the AX.W54 .glass-opaque level-0 escape + the AV.W15 M4 content-aware under-shadow modifier (.glass-over-text / [data-over-content]).
+   Carved from glass/ladder.css to hold the no-god-module 500-line bound (BI.W-STYLE-REDRAIN); its own @layer components block @import-ed by glass.css IMMEDIATELY AFTER ladder.css (the tail of the ladder @layer, unique selectors, source-order-after — byte-isomorphic). */
+@layer components {
+    /* ── The opaque escape (AX.W54) ───────────────────
+       The level-0 endpoint of the SAME glass machinery — a solid `--card` plate
+       (the opacity seam → 1) with `blur(0)` (the blur seam → 0), routed through
+       the ONE `--glass-level` knob. NOT a parallel solid `background:` recipe:
+       a `.glass-*` surface that ALSO carries `.glass-opaque` keeps its glass edge,
+       rim, and under-shadow (a solid plate with a glass edge, not a bare div), and
+       the @supports fallback + the a11y brackets compose coherently. This is the
+       explicit opt-out from the MAXIMAL glass default (dense data, forced-colors,
+       a consumer that wants a flat surface). */
+    .glass-opaque {
+        --glass-level: 0;
+        /* BA.W-DARK-MATERIAL scope 7 — the opaque escape suppresses the adaptive TINT axis
+           too (not just the opacity/blur level). A solid opaque plate has no translucent
+           backdrop to darken-over, so the self-engage tint is meaningless on it; zeroing the
+           strength keeps the opaque escape bucket-INVARIANT (the unset floor and the bright
+           bucket resolve the SAME solid plate — the byte-identity canary). Without this, the
+           scope-7 unconditional content-tier floor (4%) tinted even the solid plate, breaking
+           the opt-out's "flat surface" contract. */
+        --glass-tint-strength: 0%;
+    }
+
+    /* ── Content-aware under-shadow modifier (AV.W15 M4) ──────────────
+       Apple raises the under-shadow over text (so the glass reads as
+       lifting OFF the text) and drops it over solid light. The modifier
+       is ATTRIBUTE-DRIVEN, no JS: a consumer adds `.glass-over-text`
+       (or `[data-over-content="text"]`) to a text-bearing glass surface to
+       swap it ONE under-shadow rung heavier, or `[data-over-content="solid"]`
+       to lighten it one rung over a solid-light backdrop. It reuses the
+       existing `--glass-under-shadow-{quiet,default,vivid}` rungs (no new
+       shadow value — `vivid` is sufficient over text), redefining only the
+       leading under-shadow layer per tier; the lift stack is untouched.
+
+       The selectors are per-tier so the swap is rung-correct
+       (quiet→default, resting→vivid). `.glass-floating` already sits at the
+       `vivid` ceiling over text, so the heavier variant is a no-op there
+       (the rung saturates) — documented, not an error. */
+    .glass-quiet.glass-over-text,
+    .glass-quiet[data-over-content="text"] {
+        box-shadow: var(--glass-under-shadow-default), var(--glass-shadow-quiet);
+    }
+    .glass-resting.glass-over-text,
+    .glass-resting[data-over-content="text"] {
+        box-shadow: var(--glass-under-shadow-vivid), var(--glass-shadow-resting);
+    }
+
+    /* The inverse — over a solid-light backdrop the under-shadow lightens
+       one rung (the glass need not lift as hard off a flat bright field). */
+    .glass-resting[data-over-content="solid"] {
+        box-shadow: var(--glass-under-shadow-quiet), var(--glass-shadow-resting);
+    }
+    .glass-floating[data-over-content="solid"] {
+        box-shadow:
+            var(--glass-material-rim),
+            var(--glass-under-shadow-default),
+            var(--glass-shadow-floating);
+    }
+}

package/src/styles/glass/ladder.css

@@ -38,9 +38,53 @@
        (`tokens/dark-arm.css`), where the tolerant α-mix absorbs the small high-L
        chroma (the gamut-map caveat documented + pinned under the gamut edge there).
        That is the INK derivation, separate from THIS glass-tint mix space. */
+
+    /* BG.W-GLASS-IDIOM-FACTOR — the DRY plate-tint recipe, DECLARED ONCE.
+       The five-rung surface ladder each composed the SAME element-level oklab tint
+       INLINE (5 byte-identical `color-mix(in oklab, var(--glass-bg-<rung>),
+       var(--glass-tint-source) var(--glass-tint-strength))` pastes). The recipe is
+       the W55 adaptive-legibility seam — the rung bg mixed TOWARD the sampled/ink
+       `--glass-tint-source` at the continuous `--glass-tint-strength`; at the `0%`
+       rest default the mix is a no-op (`color-mix(…, X, transparent 0%) ≡ X`),
+       byte-identical to the raw rung bg.
+
+       Factored to ONE declaration: each rung sets only its own `--glass-bg-rung`
+       (the per-rung bg indirection — the EXACT `--glass-border-rung` →
+       `--glass-border-accent` pattern rim.css already runs for the border half) and
+       reads `background: var(--glass-plate-tinted)`. `--glass-plate-tinted` resolves
+       its `var(--glass-bg-rung)` / `--glass-tint-source` / `--glass-tint-strength`
+       at the rung element where it is composed (a custom property substitutes its
+       var() refs against the SAME element's other customs), so the per-rung bg AND
+       the per-element W55 re-points (the `:where()` content-tier + overlay-band tint
+       cascades below) reach it unchanged — net-neutral, dist byte-isomorphic. This
+       single home is the ONE place a later wave (BG.W-GLASS-TINT-UNIFY) adds the
+       bias outer-leg, instead of N pastes.
+
+       BG.W-GLASS-REGISTER-UNIFY — `--glass-plate-tinted` is the LADDER-RUNG spelling
+       of the ONE tint recipe; its applied-at-the-element twin for NON-ladder surfaces
+       is `@utility glass-fill` (glass/surfaces.css, reading `--glass-fill-rung`). Same
+       oklab W55 seam, two delivery seams: the ladder rungs read the token, a Card /
+       button / dock surface APPLIES the utility. A NON-ladder surface never re-spells
+       the `color-mix(in oklab, …)` — it composes `glass-fill`; the `--glass-bg-*-tinted`
+       pre-composed tokens + the `:root --glass-bg-dock` inline tint are the substitution-
+       trap forms the utility supersedes (their DELETE is the sibling-gate-coordinated
+       atomic step). */
+    .glass-wash,
+    .glass-quiet,
+    .glass-resting,
+    .glass-floating,
+    .glass-overlay {
+        --glass-plate-tinted: color-mix(
+            in oklab,
+            var(--glass-bg-rung),
+            var(--glass-tint-source) var(--glass-tint-strength)
+        );
+    }
+
     .glass-wash {
         position: relative;
-        background: color-mix(in oklab, var(--glass-bg-wash), var(--glass-tint-source) var(--glass-tint-strength));
+        --glass-bg-rung: var(--glass-bg-wash);
+        background: var(--glass-plate-tinted);
         backdrop-filter: var(--glass-blur-wash);
         /* BB.W-GLASS-ACCENT — the rung border ink feeds the accent-composed
            `--glass-border-accent` (rim group above); byte-identical at 0%. */
@@ -63,7 +107,8 @@
        Spine tier wires its own rung at instrument-chassis.css. */
     .glass-quiet {
         position: relative;
-        background: color-mix(in oklab, var(--glass-bg-quiet), var(--glass-tint-source) var(--glass-tint-strength));
+        --glass-bg-rung: var(--glass-bg-quiet);
+        background: var(--glass-plate-tinted);
         backdrop-filter: var(--glass-blur-quiet);
         --glass-border-rung: var(--glass-border-quiet);
         border: 1px solid var(--glass-border-accent);
@@ -75,7 +120,8 @@
 
     .glass-resting {
         position: relative;
-        background: color-mix(in oklab, var(--glass-bg-resting), var(--glass-tint-source) var(--glass-tint-strength));
+        --glass-bg-rung: var(--glass-bg-resting);
+        background: var(--glass-plate-tinted);
         backdrop-filter: var(--glass-blur-resting);
         --glass-border-rung: var(--glass-border-resting);
         border: 1px solid var(--glass-border-accent);
@@ -102,7 +148,8 @@
            dark-substrate consumer dials in on an ancestor. */
         --glass-backdrop: light;
         position: relative;
-        background: color-mix(in oklab, var(--glass-bg-floating), var(--glass-tint-source) var(--glass-tint-strength));
+        --glass-bg-rung: var(--glass-bg-floating);
+        background: var(--glass-plate-tinted);
         backdrop-filter: var(--glass-blur-floating);
         --glass-border-rung: var(--glass-border-floating);
         border: 1px solid var(--glass-border-accent);
@@ -117,7 +164,8 @@
            (see .glass-floating). */
         --glass-backdrop: light;
         position: relative;
-        background: color-mix(in oklab, var(--glass-bg-overlay), var(--glass-tint-source) var(--glass-tint-strength));
+        --glass-bg-rung: var(--glass-bg-overlay);
+        background: var(--glass-plate-tinted);
         backdrop-filter: var(--glass-blur-overlay);
         --glass-border-rung: var(--glass-border-overlay);
         border: 1px solid var(--glass-border-accent);
@@ -226,7 +274,7 @@
             calc(
                 var(--glass-tint-strength-floor) +
                 (var(--glass-tint-strength-aa) - var(--glass-tint-strength-floor)) *
-                max(0, (var(--glass-backdrop-luma, 0) - var(--glass-backdrop-luma-knee, 0.6)) / (1 - var(--glass-backdrop-luma-knee, 0.6)))
+                max(0, (var(--glass-backdrop-luma, 0) - var(--glass-backdrop-luma-knee)) / (1 - var(--glass-backdrop-luma-knee)))
             ),
             var(--glass-tint-strength-aa)
         );
@@ -282,16 +330,28 @@
            clamp resolves EXACTLY `--glass-tint-strength-floor` (the GLASS-IDENTITY calm
            identity, byte-equal); rising luma ramps the lift CONTINUOUSLY; the clamp floors
            at the 4% identity and ceilings at the bounded AA — never an unconditional 20%
-           slab (the AZ grey-slab is the OPPOSITE of this earned, measured track). This
-           RETIRES the discrete `@container --glass-backdrop: light` bucket as the strength
-           driver — the continuous calc subsumes it (the bucket survives only as a no-
-           `@property` degrade fallback). */
+           slab (the AZ grey-slab is the OPPOSITE of this earned, measured track).
+
+           BG.W-GLASS-SIGNAL-TRUTH (M7) — THE BAND-DRIVER DECISION (reconciled to ONE):
+           the declarative `@container --glass-backdrop: light` bucket below is THE BAND
+           DRIVER (a consumer/shell writes `--glass-backdrop: light` on an ancestor where
+           it KNOWS the backdrop is bright — the AA darken then reaches every descendant
+           content tier), and this CONTINUOUS `--glass-backdrop-luma` clamp is the DYNAMIC
+           REFINEMENT layer that engages WHERE A LUMA WRITER FIRES — the dock (its own
+           `useGlassBackdropLuminance` observer, wired ON) and any band surface a consumer
+           wires the observer to. On a content-tier Card with no wired observer + no
+           ancestor bucket, `--glass-backdrop-luma` reads the registered initial 0 → the
+           clamp resolves the calm floor (the honest calm identity — a plate over an
+           UNKNOWN backdrop stays warm, never a false darken). The prior claim that this
+           clamp "RETIRES the bucket as THE driver" was the contradictory-canon half the
+           M7 audit named (glass-fx.css declared the bucket the default path); the bucket
+           is the band driver, the clamp is the refinement — no double-ownership. */
         --glass-tint-strength: clamp(
             var(--glass-tint-strength-floor),
             calc(
                 var(--glass-tint-strength-floor) +
                 (var(--glass-tint-strength-aa) - var(--glass-tint-strength-floor)) *
-                max(0, (var(--glass-backdrop-luma, 0) - var(--glass-backdrop-luma-knee, 0.6)) / (1 - var(--glass-backdrop-luma-knee, 0.6)))
+                max(0, (var(--glass-backdrop-luma, 0) - var(--glass-backdrop-luma-knee)) / (1 - var(--glass-backdrop-luma-knee)))
             ),
             var(--glass-tint-strength-aa)
         );
@@ -299,6 +359,31 @@
         --muted-foreground-strong: var(--on-glass-muted-strong);
     }
 
+    /* F2.R1 W-DARK-READABILITY-REPAIR (paint re-open — the full-route dark census Class-3
+       mustFix) — the on-glass MUTED lift EXTENDS to the mid-tone / tone-tinted / selected-
+       glass surfaces the calm content-tier :where() above does NOT reach. The muted register
+       (--muted-foreground = --neutral-5, calibrated "AA vs the OPAQUE page") COLLAPSES on a
+       composited TINTED / mid-tone glass plate exactly as it does on the calm content tier —
+       but these surfaces are NOT content tiers, so the re-point above never reached them
+       (the census measured the raw page-muted at WCAG 3.3-4.27 dark, BELOW AA): the feedback
+       TONE-TINTED plates (`.feedback-tone` — Alert / Notification / Toast, the AlertDescription
+       caption + mono labels), the selected-glass capsule CHIPS + overflow PUCKS (`.glass-capsule`
+       — selectable-chip / toggle-chip / tags-input, idle `text-muted-foreground`
+       ink), and the `.metric-badge` mono label. These plates composite BRIGHTER than the calm
+       quiet plate (the quiet content plate lands L≈0.28; a tone-tinted / selected chip plate
+       lands L≈0.30-0.35), so a subordinate light ink loses contrast on them — they need the
+       STRONGER on-glass rung (`--on-glass-muted-strong`, one step more present) to clear the
+       floor while STAYING subordinate to the L90 --foreground ink. ONE register (no new token,
+       no fork — it READS the existing on-glass -strong rung the wave already ships), the SAME
+       substitution-over-redeclaration discipline the content-tier re-point uses. The rung
+       auto-flips per mode (the on-glass tokens carry their own light/dark arms); in light these
+       surfaces already read the on-glass register on their light glass, byte-consistent. Machine-
+       locked by `proof:glass` dark-legibility DL5. */
+    :where(.feedback-tone, .glass-capsule, .metric-badge) {
+        --muted-foreground: var(--on-glass-muted-strong);
+        --muted-foreground-strong: var(--on-glass-muted-strong);
+    }
+
     /* AX.W55 — the `contrast-color()` foreground-ink flip (Chrome 147+/Safari 26+).
        A PROGRESSIVE-ENHANCEMENT layer, NEVER the load-bearing floor (Open-Q #5
        ratified): the declarative bucket above already carries AA on ALL engines (it
@@ -364,126 +449,4 @@
            in the @container bucket with the rest of the bright-condition darken. */
     }
 
-    /* ── The opaque escape (AX.W54) ───────────────────
-       The level-0 endpoint of the SAME glass machinery — a solid `--card` plate
-       (the opacity seam → 1) with `blur(0)` (the blur seam → 0), routed through
-       the ONE `--glass-level` knob. NOT a parallel solid `background:` recipe:
-       a `.glass-*` surface that ALSO carries `.glass-opaque` keeps its glass edge,
-       rim, and under-shadow (a solid plate with a glass edge, not a bare div), and
-       the @supports fallback + the a11y brackets compose coherently. This is the
-       explicit opt-out from the MAXIMAL glass default (dense data, forced-colors,
-       a consumer that wants a flat surface). */
-    .glass-opaque {
-        --glass-level: 0;
-        /* BA.W-DARK-MATERIAL scope 7 — the opaque escape suppresses the adaptive TINT axis
-           too (not just the opacity/blur level). A solid opaque plate has no translucent
-           backdrop to darken-over, so the self-engage tint is meaningless on it; zeroing the
-           strength keeps the opaque escape bucket-INVARIANT (the unset floor and the bright
-           bucket resolve the SAME solid plate — the byte-identity canary). Without this, the
-           scope-7 unconditional content-tier floor (4%) tinted even the solid plate, breaking
-           the opt-out's "flat surface" contract. */
-        --glass-tint-strength: 0%;
-    }
-
-    /* ── Content-aware under-shadow modifier (AV.W15 M4) ──────────────
-       Apple raises the under-shadow over text (so the glass reads as
-       lifting OFF the text) and drops it over solid light. The modifier
-       is ATTRIBUTE-DRIVEN, no JS: a consumer adds `.glass-over-text`
-       (or `[data-over-content="text"]`) to a text-bearing glass surface to
-       swap it ONE under-shadow rung heavier, or `[data-over-content="solid"]`
-       to lighten it one rung over a solid-light backdrop. It reuses the
-       existing `--glass-under-shadow-{quiet,default,vivid}` rungs (no new
-       shadow value — `vivid` is sufficient over text), redefining only the
-       leading under-shadow layer per tier; the lift stack is untouched.
-
-       The selectors are per-tier so the swap is rung-correct
-       (quiet→default, resting→vivid). `.glass-floating` already sits at the
-       `vivid` ceiling over text, so the heavier variant is a no-op there
-       (the rung saturates) — documented, not an error. */
-    .glass-quiet.glass-over-text,
-    .glass-quiet[data-over-content="text"] {
-        box-shadow: var(--glass-under-shadow-default), var(--glass-shadow-quiet);
-    }
-    .glass-resting.glass-over-text,
-    .glass-resting[data-over-content="text"] {
-        box-shadow: var(--glass-under-shadow-vivid), var(--glass-shadow-resting);
-    }
-
-    /* The inverse — over a solid-light backdrop the under-shadow lightens
-       one rung (the glass need not lift as hard off a flat bright field). */
-    .glass-resting[data-over-content="solid"] {
-        box-shadow: var(--glass-under-shadow-quiet), var(--glass-shadow-resting);
-    }
-    .glass-floating[data-over-content="solid"] {
-        box-shadow:
-            var(--glass-material-rim),
-            var(--glass-under-shadow-default),
-            var(--glass-shadow-floating);
-    }
-
-    /* Grain noise overlay — reuses paper texture SVG, no extra assets.
-       BB.W-LIQUIDHOVER — the disco-grain pop (T8-F6) killed at the COMPOSITION CLASS:
-       the `background-image` is ALWAYS PRESENT (decoded once at rest, NEVER toggled to
-       `none`), and any STATE-driven grain engagement cross-fades the `opacity` ONLY on
-       the thin `--glass-grain-engage-duration` (~120ms linear) clock. A `background-
-       image: none → var(--paper-clean-texture)` engage decodes-and-appears in one frame
-       (the pop); the opacity cross-fade is a compositor-cheap interpolation with the
-       image constant — the only sanctioned grain engage. The `transition` lives HERE so
-       a hover/active grain lift (wherever a glass surface raises grain on interaction)
-       reads as a smooth fade by construction, not a discrete swap. */
-    .glass-wash::after,
-    .glass-quiet::after,
-    .glass-resting::after,
-    .glass-floating::after,
-    .glass-overlay::after {
-        content: '';
-        position: absolute;
-        inset: 0;
-        border-radius: inherit;
-        /* The grain texture is the `background-image` longhand (NOT the `background`
-           shorthand) so the image stays a STABLE always-present layer the engage
-           never re-declares — the structural anti-pop: opacity is the only animated
-           channel, the image is never `none → image`. */
-        background-image: var(--paper-clean-texture);
-        background-repeat: repeat;
-        background-size: var(--paper-texture-size);
-        opacity: var(--glass-grain-opacity);
-        /* The opacity cross-fade engage — plain ~120ms linear direct-write (no spring,
-           no overshoot — instant-but-smooth per the ask). Under the PRM / reduced-
-           transparency brackets the clock collapses to 0ms (the a11y bracket below). */
-        transition: opacity var(--glass-grain-engage-duration, 120ms) linear;
-        pointer-events: none;
-        mix-blend-mode: overlay;
-    }
-
-    /* BB.W-LIQUIDHOVER — the grain engage collapses to INSTANT under reduced motion (a
-       grain that cross-fades on hover under reduce is still motion; accessibility is
-       absolute). The reduced-transparency / forced-colors brackets already zero
-       `--glass-grain-opacity` (a11y-fallback.css), so the grain is inert there; this
-       bracket covers the reduced-MOTION case where the grain still paints but must not
-       animate. */
-    @media (prefers-reduced-motion: reduce) {
-        .glass-wash::after,
-        .glass-quiet::after,
-        .glass-resting::after,
-        .glass-floating::after,
-        .glass-overlay::after {
-            transition: none;
-        }
-    }
-
-    /* The unified rim (AW.W22) + the BB.W-GLASS-ACCENT per-INSTANCE chromatic-RIM
-       tint group (the rim-ink + --glass-material-rim ring + the per-rung
-       --glass-border-accent border, light + dark arms) lives in glass/rim.css
-       (carved at BB.W-CARVE4 — the next adjacent @layer components block, the SOLE
-       writer of --glass-material-rim/--glass-border-accent). */
-
-    .dark .glass-wash::after,
-    .dark .glass-quiet::after,
-    .dark .glass-resting::after,
-    .dark .glass-floating::after,
-    .dark .glass-overlay::after {
-        mix-blend-mode: soft-light;
-    }
-
 }