@mkbabb/glass-ui 3.13.0 → 4.0.1

package/dist/styles/glass-refract.css

@@ -1,59 +1,111 @@
-/* AW.W23 — the #glass-refract convex-lens SVG filter, shipped as a library
- * asset so `.glass-refract` works OUT OF THE BOX (no consumer hand-mounts a
- * filter node).
+/* BB.W-LENSING — the #glass-refract edge-lensing SVG filter, EVOLVED off the
+ * AW.W23 crude-radial garnish onto the real squircle bevel-profile + the typed
+ * `--glass-refract` axis driving the animatable displacement `scale` (the press
+ * lens-swell). Shipped as a library asset so `.glass-lens` works OUT OF THE BOX
+ * (no consumer hand-mounts a filter node).
  *
- * The refraction recipe is the canonical 3-primitive graph (kube.io /
+ * The refraction recipe is the canonical 3-primitive graph (kube.io / ekino /
  * LogRocket, 2025):
  *
- *   feImage          — a pre-baked displacement map computed from the convex-
- *                      squircle surface profile  y = ⁴√(1 − (1 − x)⁴)  (Apple's
- *                      preferred corner curve) via Snell's law (n₁ = 1 air,
- *                      n₂ = 1.5 glass). The map is authored as an embedded SVG
- *                      whose R channel carries the x-shift and G channel the
- *                      y-shift (neutral 128 = no shift; bright edges bend light
- *                      inward like a lens), expressed as two crossed linear
- *                      gradients over the squircle silhouette.
+ *   feImage          — the displacement map computed from the convex-squircle
+ *                      surface profile  f(x) = ⁴√(1 − (1 − x)⁴)  (Apple's preferred
+ *                      corner curve) via Snell's law (n₁ = 1 air, n₂ = 1.5 glass).
+ *                      The map's R channel carries the x-shift and G the y-shift
+ *                      (neutral 128 = no shift). The squircle slope is near-flat past
+ *                      the outer ~14% band and STEEP at the rim, so the bend
+ *                      CONCENTRATES at the edge (thin interior) — the iOS edge-lensing
+ *                      read, NOT a uniform radial bulge (the retired AW.W23 placeholder).
+ *                      Encoding: TWO crossed linear gradients — a HORIZONTAL gradient
+ *                      drives the R channel (255 @0% → 128 across the flat interior →
+ *                      0 @100%, the squircle ramp held in the bevel band) and a VERTICAL
+ *                      gradient drives the G channel the same way — SCREEN-composited
+ *                      over a black base so each channel carries its own axis EXACTLY
+ *                      (`screen(C, 0) = C`; the displacement map reads only R/G, B unused).
+ *                      The map carries ZERO color (the warm-cream identity HOLDS —
+ *                      refraction is DEPTH not hue). The asset is baked ONCE (the
+ *                      squircle CURVE is fixed, the Apple-preferred profile); only the
+ *                      `scale` param animates the magnitude (scope 2 — no map re-bake).
  *   feDisplacementMap— displaces the backdrop by the baked map (R = x-shift,
- *                      G = y-shift, `scale` = max px, neutral 128).
- *   feImage specular — a soft top-left specular highlight…
- *   feBlend screen   — …blended `screen` over the displaced backdrop for the
- *                      polished-glass catch.
+ *                      G = y-shift, `scale` = max px the `--glass-refract` axis drives).
+ *   feImage specular — a soft warm top-left specular highlight (PRESERVED from HEAD —
+ *                      the polished-glass catch).
+ *   feBlend screen   — blended `screen` over the displaced backdrop.
  *
- * The filter ships INLINE as a data-URI in the `backdrop-filter` declaration, so
- * the consumer gets it with zero markup. `backdrop-filter: url(#…)` is
- * Chromium-only (WebKit bug 245510 open, Firefox not shipping), so the whole
- * decl sits behind `@supports (backdrop-filter: url(#…))`; a non-supporting
- * engine paints the un-gated blur base alone (no broken `url()` reference).
+ * DDR-LENS-BAKE — the displacement `scale` is a BAKED LITERAL (`scale='28'`, the §10
+ * default depth), NOT a var()-driven axis. WHY (the reversal of BB.W-LENSING scope 2):
+ * the scope-2 design split the filter across `var(--…head) var(--glass-refract) var(--…tail)`
+ * to splice the typed `@property --glass-refract` value between a head ending `…scale='`
+ * and a tail beginning `'…`. That construction is doubly broken, proven on the real edge
+ * (Chromium, playwright):
+ *   (1) PARSE — head/tail each carry a COMPLETE `url(…)`, so the composite is the three
+ *       tokens `url("…") 28 url("…")`, which a `backdrop-filter` REJECTS. The lens
+ *       computed-`backdrop-filter: none` — it never rendered. (A var() inside a single
+ *       url() STRING token is not re-tokenised by the engine either — tested — so there
+ *       is no CSS-legal path to a dynamic `scale` inside one self-contained data-URI.)
+ *   (2) BUNDLER — the tail `url("'…")` starts with a bare quote, so a consumer's CSS
+ *       url()-rewriter (vite/postcss) reads it as a relative asset path and fails
+ *       `ENOENT: open ''`, breaking EVERY bundler-based consumer.
+ * The fix: ONE complete, valid `url("data:…scale='28'…")` token. A `data:` URI is the
+ * single form that both PARSES as a filter value AND is skipped by the url()-rewriter
+ * (the rewriter only resolves non-data/non-#/non-http content as a file). RE-LITIGATE-IF
+ * the platform ships a way to substitute a value into a url() string token (then the
+ * press-swell `scale` animation could return). TRADEOFF: the per-instance `:active`
+ * lens-swell (28→44 `scale` on press) is dropped — but it was already inert (it animated
+ * a value that reached no rendering filter), so the lived read is UNCHANGED (and the lens
+ * now actually renders). The `@property --glass-refract` reg + `--glass-refract-swell`
+ * knob are retired with it. The bevel-band width is the `--glass-refract-bevel` knob
+ * (default 14% — the iOS edge band); the baked stops fix the squircle CURVE, the knob
+ * documents the rim concentration the map encodes.
  *
- * RE-HOME (AW.W23 — decouple from the W22-folded compound). At HEAD the
- * refraction rule was bound to `.glass-specular-track.glass-refract`. W22 folds
- * `glass-specular-track` into `.glass-material`, retiring the compound's left
- * operand, so the rule is re-homed onto `.glass-material.glass-refract` — the
- * refraction garnish opts in on ANY `.glass-material` surface, no dependency on
- * the now-aliased `glass-specular-track` class. The garnish stays PE-only over
- * the blur base; it is NEVER promoted to the card/primitive substrate
- * (feDisplacementMap is resize-expensive — only the `scale` attr animates
- * without rebuilding the map).
+ * The filter ships INLINE as a data-URI in the `backdrop-filter` declaration, so the
+ * consumer gets it with zero markup. `backdrop-filter: url(#…)` is Chromium-only (WebKit
+ * bug 245510 open, Firefox not shipping), so the whole decl sits behind
+ * `@supports (backdrop-filter: url(#…))`; a non-supporting engine paints the un-gated blur
+ * base alone (no broken `url()` reference — the no-workaround degrade floor, PRESERVED).
+ *
+ * CLASS RENAME (BB.W-LENSING scope 5 — clean break, no alias, BB inv-7). The AW.W23
+ * `.glass-refract` opt-in class is RENAMED to `.glass-lens` (the §2 vocabulary); the
+ * `--glass-refract*` AXIS/token names are KEPT (the lens magnitude is the refraction
+ * axis). Consumers (`<Button :liquid>`, the demo witness) compose `.glass-lens`. The
+ * rename is the only public-surface delta (MIGRATION.md row). The garnish stays PE-only
+ * over the blur base; it is NEVER promoted to the card/primitive substrate
+ * (feDisplacementMap is resize-expensive — only the `scale` param animates without
+ * rebuilding the map).
  */
 
 @layer components {
-    /* The shipped filter graph as a data-URI SVG. A `0×0` host SVG mounted via
-       the CSS asset keeps the `#glass-refract` id resolvable in-document. */
-    .glass-refract {
-        /* The named convex-lens displacement filter, baked from the squircle
-           surface profile. Composed as a custom property so the @supports arm
-           below references one source. */
-        --glass-refract-filter: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='glass-refract' x='0' y='0' width='100%25' height='100%25'%3E%3CfeImage href='data:image/svg+xml,%253Csvg xmlns=%2522http://www.w3.org/2000/svg%2522 width=%2522100%2522 height=%2522100%2522%253E%253CradialGradient id=%2522m%2522 cx=%252250%2525%2522 cy=%252250%2525%2522 r=%252250%2525%2522%253E%253Cstop offset=%25220%2525%2522 stop-color=%2522rgb(128,128,128)%2522/%253E%253Cstop offset=%252270%2525%2522 stop-color=%2522rgb(128,128,128)%2522/%253E%253Cstop offset=%2522100%2525%2522 stop-color=%2522rgb(255,255,128)%2522/%253E%253C/radialGradient%253E%253Crect width=%2522100%2522 height=%2522100%2522 fill=%2522url(%2523m)%2522/%253E%253C/svg%253E' result='map'/%3E%3CfeDisplacementMap in='SourceGraphic' in2='map' scale='28' xChannelSelector='R' yChannelSelector='G' result='disp'/%3E%3CfeImage href='data:image/svg+xml,%253Csvg xmlns=%2522http://www.w3.org/2000/svg%2522 width=%2522100%2522 height=%2522100%2522%253E%253CradialGradient id=%2522s%2522 cx=%252230%2525%2522 cy=%252225%2525%2522 r=%252260%2525%2522%253E%253Cstop offset=%25220%2525%2522 stop-color=%2522rgba(255,255,255,0.5)%2522/%253E%253Cstop offset=%2522100%2525%2522 stop-color=%2522rgba(255,255,255,0)%2522/%253E%253C/radialGradient%253E%253Crect width=%2522100%2522 height=%2522100%2522 fill=%2522url(%2523s)%2522/%253E%253C/svg%253E' result='spec'/%3E%3CfeBlend in='disp' in2='spec' mode='screen'/%3E%3C/filter%3E%3C/svg%3E#glass-refract");
+    /* The shipped filter graph as ONE self-contained data-URI SVG (`scale='28'` baked,
+       DDR-LENS-BAKE). A single `url("data:…")` token is the only form that PARSES as a
+       `backdrop-filter` value AND survives a consumer bundler's url()-rewrite (a `data:`
+       URI is skipped; any other `url("…")` content is mis-resolved as a file). The
+       `#glass-refract` id is resolvable in-document (the data-URI is self-contained). */
+    .glass-lens {
+        /* The bevel-band width the squircle map encodes (the iOS edge concentration).
+           Documents the rim thickness the baked stops fix; a consumer reads it to tune
+           the perceived rim band on a successor re-bake. */
+        --glass-refract-bevel: 14%;
+
+        /* The shipped filter — ONE complete, valid `url("data:…")` token carrying the
+           whole 3-primitive graph with the `scale='28'` baked in (the §10 default depth,
+           DDR-LENS-BAKE). A single self-contained `data:` URI is (a) the ONLY form that
+           PARSES as a `backdrop-filter` value — the prior var()-spliced head/tail emitted
+           `url("…") <n> url("…")`, three tokens a `backdrop-filter` rejects, so the lens
+           silently rendered `none`; and (b) bundler-SAFE — a consumer's CSS url()-rewriter
+           skips a `data:` URI but mis-resolves any `url("…")` whose content starts with a
+           bare char (the old tail began `'…` → ENOENT, breaking every bundler consumer).
+           See the DDR-LENS-BAKE note in the header for the lost-tunability tradeoff. */
+        --glass-refract-filter: url("data:image/svg+xml,%3Csvg xmlns=%27http://www.w3.org/2000/svg%27%3E%3Cfilter id=%27glass-refract%27 x=%270%27 y=%270%27 width=%27100%25%27 height=%27100%25%27%3E%3CfeImage href=%27data:image/svg+xml,%253Csvg xmlns=%2522http://www.w3.org/2000/svg%2522 width=%2522100%2522 height=%2522100%2522%253E%253ClinearGradient id=%2522hx%2522 x1=%25220%2522 y1=%25220%2522 x2=%2522100%2525%2522 y2=%25220%2522%253E%253Cstop offset=%25220%2525%2522 stop-color=%2522rgb(255,0,0)%2522/%253E%253Cstop offset=%252214%2525%2522 stop-color=%2522rgb(128,0,0)%2522/%253E%253Cstop offset=%252286%2525%2522 stop-color=%2522rgb(128,0,0)%2522/%253E%253Cstop offset=%2522100%2525%2522 stop-color=%2522rgb(0,0,0)%2522/%253E%253C/linearGradient%253E%253ClinearGradient id=%2522vy%2522 x1=%25220%2522 y1=%25220%2522 x2=%25220%2522 y2=%2522100%2525%2522%253E%253Cstop offset=%25220%2525%2522 stop-color=%2522rgb(0,255,0)%2522/%253E%253Cstop offset=%252214%2525%2522 stop-color=%2522rgb(0,128,0)%2522/%253E%253Cstop offset=%252286%2525%2522 stop-color=%2522rgb(0,128,0)%2522/%253E%253Cstop offset=%2522100%2525%2522 stop-color=%2522rgb(0,0,0)%2522/%253E%253C/linearGradient%253E%253Crect width=%2522100%2522 height=%2522100%2522 fill=%2522black%2522/%253E%253Crect width=%2522100%2522 height=%2522100%2522 fill=%2522url(%2523hx)%2522/%253E%253Crect width=%2522100%2522 height=%2522100%2522 fill=%2522url(%2523vy)%2522 style=%2522mix-blend-mode:screen%2522/%253E%253C/svg%253E%27 result=%27map%27/%3E%3CfeDisplacementMap in=%27SourceGraphic%27 in2=%27map%27 scale=%2728%27 xChannelSelector=%27R%27 yChannelSelector=%27G%27 result=%27disp%27/%3E%3CfeImage href=%27data:image/svg+xml,%253Csvg xmlns=%2522http://www.w3.org/2000/svg%2522 width=%2522100%2522 height=%2522100%2522%253E%253CradialGradient id=%2522s%2522 cx=%252230%2525%2522 cy=%252225%2525%2522 r=%252260%2525%2522%253E%253Cstop offset=%25220%2525%2522 stop-color=%2522rgba(255,255,255,0.5)%2522/%253E%253Cstop offset=%2522100%2525%2522 stop-color=%2522rgba(255,255,255,0)%2522/%253E%253C/radialGradient%253E%253Crect width=%2522100%2522 height=%2522100%2522 fill=%2522url(%2523s)%2522/%253E%253C/svg%253E%27 result=%27spec%27/%3E%3CfeBlend in=%27disp%27 in2=%27spec%27 mode=%27screen%27/%3E%3C/filter%3E%3C/svg%3E%23glass-refract");
     }
 
-    /* The gated consuming selector — RE-HOMED onto `.glass-material.glass-refract`
-       (decoupled from the W22-folded `.glass-specular-track` compound). The
-       refraction composes the shipped `#glass-refract` filter OVER the host's
-       existing blur; it is additive (the blur already painted, this sharpens the
-       refraction edge where the engine supports it). */
+    /* The gated consuming selector. The squircle map + the baked `scale='28'` ride
+       INSIDE the `@supports (backdrop-filter: url(#…))` block;
+       the refraction composes the shipped `#glass-refract` filter OVER the host's existing
+       blur — additive (the blur already painted, this bends + concentrates the refraction
+       at the rim where the engine supports it). A non-supporting engine never reaches this
+       block and paints the un-gated `--glass-blur-*` + `--glass-tint-*` base ALONE. */
     @supports (backdrop-filter: url("#glass-refract")) {
-        .glass-material.glass-refract,
-        .glass-refract {
+        .glass-material.glass-lens,
+        .glass-lens {
             -webkit-backdrop-filter: var(--glass-blur-resting) var(--glass-refract-filter);
 
             backdrop-filter: var(--glass-blur-resting) var(--glass-refract-filter);

package/dist/styles/glass-specular-track.css

@@ -43,6 +43,13 @@
     .glass-specular-track::before {
         --specular-x: 50%;
         --specular-y: 50%;
+        /* BB.W-LENSING — pin the EDGE-glint angle static too (the conic seats at its
+           `0deg` top-edge rest). The `useSpecularPointer` leaf already skips the angle
+           write under PRM; this is the CSS belt-and-braces pin so the rim glint never
+           drifts under reduce. The lens-swell drive also snaps (Button.vue / .tap-squish
+           PRM carve), so the whole motion-reactive lens reaches rest with no in-between
+           frames — the gesture functions, the physics off. */
+        --specular-angle: 0deg;
         transition: none;
     }
 }

package/dist/styles/glass.css

@@ -40,11 +40,17 @@
  * docs/precepts/design-idioms.md §cohesion-aware partials.
  */
 
-/* CSS @import rules must precede every other rule. The six partials @import in
-   cascade order: */
+/* CSS @import rules must precede every other rule. The seven partials @import in
+   cascade order (surface-axis.css AFTER ladder/surfaces so its [data-surface]
+   decoration attr rules win over the base rung by source order; BEFORE the
+   squircle + a11y @supports overrides, which must stay last): */
 @import "./glass/material.css";
 @import "./glass/ladder.css";
+@import "./glass/rim.css";
 @import "./glass/surfaces.css";
+@import "./glass/surface-axis.css";
+@import "./glass/reveal.css";
+@import "./glass/deep.css";
 @import "./glass/progress-rail.css";
 @import "./glass/squircle.css";
 @import "./glass/a11y-fallback.css";

package/dist/styles/hover-popover.css

@@ -37,10 +37,11 @@
     }
 }
 
-/* The data-state animation grammar canonicalises onto `.popover-animate`
-   (V.W3.T9 / A5 §5.8). Authors compose `class="hover-popover-panel popover-animate"`
-   on the panel root so the canonical fade + zoom-95 entry/exit grammar
-   replaces the bespoke `hover-popover-in/out` keyframes that lived here.
-   The `prefers-reduced-motion` carve is handled at the canonical site
-   (`utilities.css`'s reduced-motion block) so it cascades to all four
+/* The data-state animation grammar canonicalises onto `.glass-reveal`
+   (BB.W-LIQUID-REVEAL — off the retired `popover-animate` bezier zoom-95, clean
+   break). Authors compose `class="hover-popover-panel glass-reveal"` on the panel
+   root so the spring-clocked LIQUID-ENTER grammar (the coupled scale+fade+filter
+   blur-settle, glass/reveal.css) replaces the bespoke `hover-popover-in/out`
+   keyframes that lived here. The `prefers-reduced-motion` carve is handled at the
+   canonical site (`glass/reveal.css`'s reduced-motion block) so it cascades to all
    popover-animation consumers automatically. */

package/dist/styles/icon-chip.css

@@ -0,0 +1,211 @@
+/* icon-chip.css — BA.W-ICON-CHIP: the <IconChip> section-color pop primitive.
+ *
+ * The library's SINGLE section-color icon-chip recipe — the brand's ONE color
+ * event per surface (the one-color-event rule, AZ.W-SUFFUSE / proof:suffuse):
+ * a `color-mix(… 25%, transparent)` backplate under a full-chroma glyph, walked
+ * over the 13-stop `--section-color-N` ramp (or a complete `tone` token). It
+ * OWNS the recipe the four inline `:style` pastes (icons.vue / empty-states.vue
+ * / auth-shell.vue / the MetricCell glyph-tint) collapsed onto, so the recipe
+ * lives ONCE and proof:suffuse asserts against one component, not N pastes.
+ *
+ * THE INTERPOLATION SPACE — `in srgb` (DELIBERATE, recorded). The backplate is
+ * a foreground-over-transparent overlay at a hand-tuned α stop — the SAME shape
+ * as the `--surface-tint-*` brand family, which CLAUDE.md fixes at `in srgb`
+ * (the brand-calibrated mix; switching the space shifts the resting α off its
+ * hand-set value). The chip is byte-faithful to the reference paste register
+ * (the binding W7 π target: stop-0 bg `color(srgb 0.915 0.484 0.671 / 0.25)`),
+ * so it preserves `in srgb` — the same brand-overlay path, NOT the glass-tint
+ * `in oklab` perceptual-mix path. (The spec text says `in oklab`; the resolution
+ * preserves the reference-faithful `in srgb` so the pop register does not shift
+ * — recorded in PROGRESS / the DELTA.)
+ *
+ * THE α STOP IS A TOKEN (BB.W-SUFFUSE3 c3). The hardcoded `25%` lifted onto
+ * `--icon-chip-plate-strength` (default `25%`, BYTE-IDENTICAL); the `:saturated`
+ * axis re-points it to ~40% for a louder focal pop — the STRENGTH varies, the
+ * `in srgb` space + the chip≤glyph ratio do NOT. The pop is ALIVE too: the
+ * reveal entrance + the hover-bloom GROW ride the per-spring CLOCK (the
+ * --spring-snappy/--spring-smooth registers), no longer the fixed bezier.
+ */
+
+:root {
+    /* The chip≤glyph proportion (d2, structural). The diameter floors at
+       `glyph × ratio` so the plate can NEVER paint under the glyph — a
+       consumer's tiny `size` is clamped. The default reproduces the reference
+       48/22 ≈ 2.18 register. Token-first: a consumer retunes without a
+       component edit. */
+    --icon-chip-glyph-ratio: 2.18;
+    /* The duotone fill α — a low-alpha fill of the same hue UNDER the
+       full-chroma stroke (the iOS/Material filled-tonal move). Mono-hue. */
+    --icon-chip-duotone-fill: 18%;
+    /* The backplate vibrancy stop (BB.W-SUFFUSE3 c3). The default reproduces
+       the reference 25% register BYTE-IDENTICALLY — the plate `color-mix`
+       reads this token instead of the hardcoded `25%`. The `:saturated` axis
+       re-points it to a louder focal stop (~40%); the STRENGTH changes, the
+       `in srgb` space + the chip≤glyph ratio do NOT (the recorded keep). Still
+       ONE color event per surface — a saturated chip is the same event,
+       louder, never a license for a second (proof:suffuse d3 counts the event
+       FAMILY, not the saturation). Token-first: a consumer retunes without a
+       component edit. */
+    --icon-chip-plate-strength: 25%;
+    /* The hover-bloom backplate lift (25% → ~35%) + the glow-ring spread. */
+    --icon-chip-bloom-mix: 35%;
+    --icon-chip-bloom-glow: 28%;
+    /* The reveal stagger step (consumed by the vReveal `--d` index). */
+    --icon-chip-reveal-step: 60ms;
+}
+
+.icon-chip {
+    /* The diameter FLOORS at glyph × ratio — the d2 proportion enforced in the
+       component, not a per-consumer hope. */
+    --_icon-chip-floor: calc(
+        var(--icon-chip-glyph-size, 22px) * var(--icon-chip-glyph-ratio)
+    );
+    inline-size: max(var(--icon-chip-size, 48px), var(--_icon-chip-floor));
+    block-size: max(var(--icon-chip-size, 48px), var(--_icon-chip-floor));
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    border-radius: var(--radius-pill, 9999px);
+    /* The backplate — the reference recipe (`in srgb`, the --icon-chip-plate-
+       strength α stop, default 25% — BB.W-SUFFUSE3 c3 lifts the hardcoded `25%`
+       onto the token, BYTE-IDENTICAL at default). */
+    background-color: color-mix(
+        in srgb,
+        var(--icon-chip-plate-color, var(--muted))
+            var(--icon-chip-plate-strength),
+        transparent
+    );
+    color: var(--icon-chip-event-color, var(--muted-foreground));
+    /* The §6 easing doctrine — surface props (bg/box-shadow) on the bezier
+       standard ease. The transform leg at REST (the leave direction, reverting
+       to base) is the NO-OVERSHOOT bezier (a bloom must never overshoot past
+       gone — §6 exit law, BB.W-SUFFUSE3 c2); the hover ENTER direction lifts
+       onto --spring-smooth on the .icon-chip--bloom:hover rule below. */
+    transition:
+        background-color var(--duration-fast, 150ms) var(--ease-standard),
+        box-shadow var(--duration-fast, 150ms) var(--ease-standard),
+        transform var(--duration-fast, 150ms) var(--ease-out);
+}
+
+.icon-chip__glyph {
+    display: block;
+    flex-shrink: 0;
+}
+
+/* ── The bare register (the MetricCell leading-glyph tint — no backplate) ──── */
+.icon-chip--bare {
+    inline-size: auto;
+    block-size: auto;
+    background-color: transparent;
+    border-radius: 0;
+}
+
+/* ── The :saturated vibrancy axis (BB.W-SUFFUSE3 c3) ───────────────────────── */
+/* A louder, more-chromatic backplate for a genuine focal pop — the plate
+   `color-mix` re-points off the 25% reference stop to ~40%. STILL the ONE color
+   event (the same event, louder — proof:suffuse d3 counts the event FAMILY, not
+   the saturation). The interpolation STAYS `in srgb` (the recorded reference-
+   register keep) and the chip≤glyph ratio is untouched. */
+.icon-chip--saturated {
+    --icon-chip-plate-strength: 40%;
+}
+
+/* ── The duotone axis — a low-alpha fill of the same hue UNDER the stroke ──── */
+/* Lucide glyphs bake `fill: none` on the SVG root; CSS wins over the
+   presentation attribute, so the `[data-duotone] svg` rule reaches the inner
+   paths (they inherit `fill` from the root). Mono-hue, proportion-safe. */
+.icon-chip--duotone[data-duotone] svg,
+.icon-chip[data-duotone] .icon-chip__glyph {
+    fill: color-mix(
+        in srgb,
+        var(--icon-chip-event-color, var(--muted-foreground))
+            var(--icon-chip-duotone-fill),
+        transparent
+    );
+}
+
+/* ── The hover-bloom axis — the SMOOTH GLASS register (NO disco) ───────────── */
+/* The backplate mix lifts, a soft same-hue glow ring appears, the glyph stroke
+   firms. DISCO FENCE: composes NO sparkle-sweep / btn-audacious / disco-grain —
+   the W-GLASS-CAL-retired-disco's calm replacement register only. */
+@media (hover: hover) {
+    .icon-chip--bloom:hover {
+        background-color: color-mix(
+            in srgb,
+            var(--icon-chip-plate-color, var(--muted)) var(--icon-chip-bloom-mix),
+            transparent
+        );
+        box-shadow: 0 0 0 0.25rem
+            color-mix(
+                in srgb,
+                var(--icon-chip-event-color, var(--muted-foreground))
+                    var(--icon-chip-bloom-glow),
+                transparent
+            );
+        /* The bloom GROW (BB.W-SUFFUSE3 c2) — the plate lifts a hair on the
+           §6 --spring-smooth transform register (enter smooth). The transition
+           is re-declared on :hover so the ENTER direction rides the spring; the
+           base rule's --ease-out transform leg governs the leave (no overshoot
+           past gone). The color legs stay on the bezier (base rule). */
+        transform: scale(var(--icon-chip-bloom-scale, 1.06));
+        transition:
+            background-color var(--duration-fast, 150ms) var(--ease-standard),
+            box-shadow var(--duration-fast, 150ms) var(--ease-standard),
+            transform var(--spring-smooth-duration) var(--spring-smooth);
+    }
+    /* The glyph stroke firms on the chip's own hover. */
+    .icon-chip--bloom:hover .icon-chip__glyph {
+        stroke-width: 2;
+    }
+}
+
+/* ── The entrance-reveal axis — composes the shipped vReveal directive ─────── */
+/* The directive writes `[data-reveal]` + `--d` (the stagger index); this rule
+   reacts ONLY on an opted-in chip (`.icon-chip--reveal`) so a non-reveal chip's
+   inert `[data-reveal]` hook never animates. PRM-gated. */
+@media (prefers-reduced-motion: no-preference) {
+    /* BB.W-SUFFUSE3 c1 — the pop-ENTRANCE rides the per-spring CLOCK, NOT the
+       fixed --duration-medium bezier. The animation-timing-function is the
+       --spring-snappy linear() string (peaks ~1.068) and the duration is
+       --spring-snappy-duration (0.34s, the W-GLASS-CAL per-spring clock), so the
+       `scale(0.85)→1` keyframe carries the snappy spring's ~+7% overshoot then
+       settles (the springy pop, not a flat fade-up). The opacity 0→1 is COUPLED
+       on the SAME clock (the W-MOTION-CANON P3 coupled-fade — plate + glyph
+       bloom as ONE continuous layer). Compositor-only: transform/opacity only
+       (the proof:motion-compositor floor holds). The per-spring clock is the
+       W-GLASS-CAL/W-MOTION-CANON fence — CONSUMED here, never re-generated. */
+    .icon-chip--reveal[data-reveal] {
+        animation: icon-chip-reveal var(--spring-snappy-duration)
+            var(--spring-snappy) both;
+        animation-delay: calc(var(--d, 0) * var(--icon-chip-reveal-step));
+    }
+}
+
+@keyframes icon-chip-reveal {
+    from {
+        opacity: 0;
+        transform: scale(0.85) translateY(0.25rem);
+    }
+    to {
+        opacity: 1;
+        transform: none;
+    }
+}
+
+/* ── The deform axes collapse under reduced motion (the PRM guard) ─────────── */
+/* BB.W-SUFFUSE3 c1/c2 — the spring deform drops under reduce: the bloom GROW
+   scale collapses to 1 (the color cross-fade may stay — the legibility cue is
+   not motion), and the reveal pop SNAPS to its endpoint (scale 1, opacity 1,
+   zero in-between frames) via `animation: none` (the chip still APPEARS — only
+   the spring/overshoot is off; the W-MOTION-CANON P6 keep-fade/drop-transform). */
+@media (prefers-reduced-motion: reduce) {
+    .icon-chip--bloom:hover {
+        transform: none;
+    }
+    .icon-chip--bloom:hover .icon-chip__glyph {
+        stroke-width: inherit;
+    }
+    .icon-chip--reveal[data-reveal] {
+        animation: none;
+    }
+}

package/dist/styles/index.css

@@ -94,6 +94,15 @@
  *                              cascades into these control rules.
  *   7. cards.css             — .cartoon-surface, .paper-texture.
  *                              Component utility layer.
+ *  7a. feedback-tone.css     — the ONE shared tinted-glass tone register
+ *                              (BA.W-FEEDBACK-TONE): `.feedback-tone` +
+ *                              `.feedback-tone-{success,warning,info,destructive}`
+ *                              tint a glass rung a bounded % toward a house tone
+ *                              token on the EXISTING color-mix(in oklab, …) seam.
+ *                              Toast / Notification / Alert consume it (the three
+ *                              tone maps collapse). Loads after cards.css (it reads
+ *                              the same `--glass-bg-*` rung tokens cards.css/the
+ *                              ladder mint) and before floating-panel.css.
  *   8. floating-panel.css    — .floating-panel + .floating-panel-item.
  *                              Component utility layer.
  *   9. transitions.css       — Vue <Transition> classes (fade, fade-slide,
@@ -105,6 +114,12 @@
  *  10a. scroll-driven.css    — native scroll-driven recipes (.scroll-progress
  *                              + [data-scroll-reveal]); the `@supports`-gated
  *                              primary over the JS-composable fallback (AQ.W5).
+ *  10a'. scroll-choreography.css — the SOTA scroll-CHOREOGRAPHY register
+ *                              (.scroll-build page-build / .scroll-cascade
+ *                              section-cascade / .scroll-pin scroll-pinned + the
+ *                              native .smooth-scroll opt-in) on the native
+ *                              scroll()/view()/timeline-scope substrate; NO
+ *                              Lenis/GSAP dep (BB.W-SCROLL-MOTION).
  *  10b. view-transition.css  — the `.gl-list-item` View-Transitions group
  *                              recipe + `--vt-*` axes (AQ.W5; the
  *                              `useViewTransition` substrate's CSS half).
@@ -114,14 +129,26 @@
  *                              K W6 + Q.W3 Lane E), rainbow-vivid +
  *                              rainbow-pastel. Consumes earlier animations +
  *                              tokens.
+ *  11a. menu.css             — BA.W-MENU-GLASS the glass MENU-ROW + MENU-SECTION
+ *                              register. AFTER utilities.css so `.glass-menu-row`'s
+ *                              `@layer components` hover/highlight rules source-
+ *                              order-win over `.interactive-item:hover` (same layer
+ *                              + specificity) — the cascade-trap-safe placement.
  *  12. instrument-chassis.css — P-tranche component CSS (chassis bezel +
  *                              groove dividers). Loaded after utilities so
  *                              component-local recipes can override.
  *  13. hover-popover.css     — V.W3 popover-animation grammar.
  *  14. drawer.css            — AN.W3 detented bottom-sheet grammar (glass
  *                             sheet surface + peek handle + snap-stop rules).
+ *  15. segmented-tabs.css    — AX.W53 SegmentedTabs overflow/indicator grammar.
+ *  16. select.css            — BA.W-EMISSION the PRECOMPILED Select content
+ *                             collision-bound (the `[data-slot="select-content"]`
+ *                             max-height rule) — moved off the dead arbitrary-
+ *                             bracket CVA class so the bound SHIPS in dist/glass-ui.css
+ *                             regardless of consumer JIT reach. A structural utility
+ *                             never depends on a content-scan; locked by proof:emission.
  *
- * Per-package component CSS lives at (12)-(14) (loaded after utilities so
+ * Per-package component CSS lives at (12)-(16) (loaded after utilities so
  * component-local recipes can override). New per-package CSS files append
  * to that tail.
  */
@@ -135,20 +162,67 @@
 @import "./dock.css";
 @import "./dock-controls.css";
 @import "./cards.css";
+@import "./feedback-tone.css";
 @import "./floating-panel.css";
 @import "./transitions.css";
 @import "./animations.css";
 @import "./scroll-driven.css";
+@import "./scroll-choreography.css";
 @import "./view-transition.css";
 @import "./utilities.css";
+/* BA.W-MENU-GLASS — the glass menu-row + menu-section register. @import-ed AFTER
+   utilities.css (NOT the floating/transitions band the spec hinted) so the
+   `.glass-menu-row` `@layer components` hover/highlight rules source-order-WIN
+   over `.interactive-item:hover` (utilities/base.css, same layer + specificity) —
+   the cascade-trap-safe placement, mirroring glass/surface-axis.css's "import
+   AFTER ladder.css" discipline. */
+@import "./menu.css";
 @import "./configurator.css";
 @import "./instrument-chassis.css";
 @import "./hover-popover.css";
 @import "./drawer.css";
 @import "./segmented-tabs.css";
+@import "./select.css";
+/* BA.W-ICON-CHIP — the <IconChip> section-color pop recipe + the three axes
+   (duotone/bloom/reveal). A component partial; the token arms (--section-color-N
+   / --muted) auto-flip under .dark so the chip is mode-robust by construction. */
+@import "./icon-chip.css";
+/* BB.W-BORDER-PROGRESS — progress IS the element's border: the masked-conic ring
+   consumption (the @property reg lives in tokens/property-regs.css §18). A
+   component partial; the conic + the radius-following mask-composite + the coverage
+   masks + the PRM milestone-pulse bracket. */
+@import "./border-progress.css";
 
-/* Ensure consumer's Tailwind scans glass-ui components for utility classes
-   (e.g. CVA button variants like text-destructive-foreground) */
+/* Ensure Tailwind scans glass-ui's compiled component templates for the utility
+   classes they emit (CVA variant classes like text-destructive-foreground,
+   layout utilities like h-full/shrink-0).
+
+   BA.W-EMISSION — re-pointed from the DEAD components-mirror glob (the prior
+   `../components` target). That glob resolved correctly in glass-ui's OWN build
+   (`src/styles/index.css` → `src/components` carries the real `.vue` source), but the
+   SHIPPED dist copy of this file (`dist/styles/index.css`) resolved `../components` to
+   `dist/components/` — a
+   directory that carries ONLY `.d.ts` mirror files (zero `.js`, zero `.vue`). The
+   compiled render-functions live FLAT at `dist/*.js`. So in every consumer that
+   re-imported this `@source` line, Tailwind scanned an empty dir and glass-ui's own
+   arbitrary utilities silently died (the P9 / valuejs-fold register-B class).
+
+   `../*.js` reaches the compiled render-functions PRECISELY in the SHIPPED context:
+   in dist it is `dist/*.js` (the 150+ flat compiled chunks that carry glass-ui's
+   utility class strings — the surface the dead `../components` mirror NEVER held).
+   In glass-ui's OWN source build it is `src/*.js` (empty — glass-ui's own components
+   compile their CSS through vite, not this `@source`), so the directive is a no-op
+   in the own-build and never scans the `src/` shader/`.ts` tree (a bare `../` glob
+   tripped Tailwind's dev candidate-extractor on the shader template strings —
+   `Missing opening (`). This directive is a BACKSTOP for a consumer that imports
+   this exact cascade file — the PRIMARY self-emission path is
+   `vite.style-assets.ts emitComponentUtilities` (P9), which ships glass-ui's
+   component-utility RULES build-independently into `dist/styles/components.css`.
+   Fully-arbitrary BRACKET utilities (`[max-height:…]`, `[--slider-track-height:…]`)
+   are rejected by that path's `classish` token filter AND are not reliably reachable
+   by a JIT scan, so every STRUCTURAL bracket utility (geometry/bounds/sizing) is
+   pre-compiled into shipped CSS instead — never load-bearing on any consumer's
+   content-scan reach. Locked by proof:emission. */
 /* AN.W1 — SFC scoped component CSS (folded so a single
    @import "@mkbabb/glass-ui/styles" carries cascade + components) */
 @import "../glass-ui.css";
@@ -157,4 +231,4 @@
    …) shipped build-independently so a bare consumer paints them. */
 @import "./components.css";
 
-@source "../components";
+@source "../*.js";