@mkbabb/glass-ui 4.0.0 → 4.1.0

package/src/styles/dock/stack-rail.css

@@ -0,0 +1,264 @@
+/* dock/stack-rail.css — BC.W-DOCK-STACK-RAIL — the macOS hover-expand STACK rail
+ * (the clean-break rebuild; the divider-carousel chip-strip RETIRED).
+ *
+ * THE KEPT CHASSIS (glass-dock-codebase.md §2.5 — "that part STAYS"). The `.glass-dock`
+ * root carries `contain: paint` + `backdrop-filter` + (on a vertical dock) `overflow` —
+ * all three hard-clip every descendant to the dock's border box, so an `#rail` rendered
+ * as a dock CHILD could never paint beyond the edge. The escape: GlassDock renders the
+ * `#rail` as a SIBLING of `.glass-dock` inside the `.glass-dock-frame` (a `display:contents`
+ * shell that becomes a NON-clipping positioning context only when `data-has-rail`). The
+ * `.dock-hairline-slot` is `position: absolute` relative to THAT shell — outside the dock's
+ * containment — so the stack VISIBLY extends beyond the dock edge into its own gutter. No
+ * `contain`, no `backdrop-filter`, no `overflow` on the shell → nothing clips it. This is
+ * the load-bearing chassis the rebuild reuses; the box stays INVIOLATE (the slot feeds NO
+ * size into the dock's intrinsic box).
+ *
+ * THE STACK (the verbatim spec — rail-spec-contradicted-divider-carousel). A `<DockStack>`
+ * is one stack: a CORE anchor item (the always-visible dock(1) glyph) + N members. On
+ * hover/focus of the core, the members FAN OUT next to the rail — a column (vertical dock)
+ * / row (horizontal dock) of FULLY-VISIBLE glass icons springing open beside the line,
+ * each a `--glass-bg-floating` glass icon (NEVER a shadowed half-tucked chip). The fan-out
+ * is compositor-only (scale/translate/opacity/filter — the `proof:no-layout-animation`
+ * floor, NO animated width/height/inset), staggered by `--dock-stack-stagger * var(--i)`.
+ *
+ * CLEARS CONTENT BY TOPOLOGY (THE HEADLINE — ba-dock-shell-gestalt-fail-revoked +
+ * ba-chip-graze). The stack lives BEYOND the dock edge in its own gutter (the
+ * `chipOverMain: false` topology), the fan extending AWAY from content, never over
+ * `<main>` / the `<h1>` / a form field at any y. The chip-graze that revoked the dock/shell
+ * PASS cannot recur.
+ *
+ * @import-ed by dock.css into the SAME `@layer components` as the other partials. */
+@layer components {
+    :root {
+        /* The beyond-edge extent — how far the stack reaches into the gutter past the dock
+           edge. Rides `--dock-scale` so it tracks the coarse-pointer density thread. (KEPT
+           token, re-conceived from the divider-carousel's symmetric overrun to the stack's
+           one-way gutter reach.) */
+        --dock-rail-extend-length: calc(2.5rem * var(--dock-scale, 1));
+        /* The macOS-stack tuning tokens (re-expressed via @theme — Tailwind-first, NEVER a
+           raw macOS-dock CSS paste). */
+        --dock-stack-stagger: 28ms; /* the per-member fan delay (× var(--i)) */
+        --dock-stack-gap: calc(0.375rem * var(--dock-scale, 1));
+        --dock-stack-member-size: calc(2rem * var(--dock-scale, 1));
+        --dock-stack-fold: 0.4; /* the at-rest fold scale (the members tuck behind the core) */
+    }
+
+    /* The dock-frame wrapper — KEPT. DEFAULT (`display: contents`) is layout-transparent
+       (byte-identical no-rail path). When a `#rail` is authored it lifts to a real
+       NON-clipping positioning context so the abs-positioned slot anchors to the dock box
+       yet escapes the dock's clip. */
+    .glass-dock-frame {
+        display: contents;
+    }
+    .glass-dock-frame[data-has-rail] {
+        display: inline-flex;
+        position: relative;
+        /* No containment, no overflow, no blur — the WHOLE point: the stack must paint
+           beyond the dock box. The wrapper shrink-wraps the dock (inline-flex) so its box
+           == the dock box and the rail anchors to the true edge. */
+    }
+    .glass-dock-frame[data-has-rail].vertical {
+        flex-direction: column;
+        align-items: stretch;
+    }
+
+    /* The chrome-slot wrapper — a `position: absolute` sibling of `.glass-dock`, anchored
+       to the dock-frame (NOT the dock box), so the dock's clip never reaches it. It paints
+       nothing itself; `<DockStack>` owns the core + fan. The slot seats at the dock EDGE
+       (the `position` start/end), NOT a `[data-rail-anchor]` divider seam (the seam-locator
+       RETIRED). It is pass-through; the controls re-arm pointer events. */
+    .dock-hairline-slot {
+        position: absolute;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        pointer-events: none;
+        z-index: 1;
+    }
+    .dock-hairline-slot > * {
+        pointer-events: auto;
+    }
+
+    /* VERTICAL (column) dock — the stack hangs off the TRAILING (inline-end) edge in its
+       gutter, the core seated at the dock's block-end (the macOS-stack anchor: the
+       bottom-most member at the dock floor, the rest fanning up the rail). The slot starts
+       at the dock's trailing edge + the extend reach, clear of <main> (which is to the
+       inline-start). */
+    .glass-dock-frame[data-has-rail].vertical .dock-hairline-slot {
+        inset-inline-start: 100%;
+        inset-inline-end: auto;
+        inset-block-end: 0;
+        inset-block-start: auto;
+        inline-size: var(--dock-rail-extend-length);
+        block-size: 100%;
+    }
+    /* HORIZONTAL (row) dock — the stack rises off the TOP (block-start) edge in its gutter
+       (a viewport-bottom dock keeps the fan ON-SCREEN above the row), the core at the dock's
+       inline-end, the members fanning up. Clear of <main> (which is above the dock). */
+    .glass-dock-frame[data-has-rail]:not(.vertical) .dock-hairline-slot {
+        inset-block-end: 100%;
+        inset-block-start: auto;
+        inset-inline-end: 0;
+        inset-inline-start: auto;
+        block-size: var(--dock-rail-extend-length);
+        inline-size: 100%;
+    }
+
+    /* ── The stack ────────────────────────────────────────────────────────────────── */
+    .dock-stack {
+        position: relative;
+        display: flex;
+        gap: var(--dock-stack-gap);
+        /* the core anchors at the gutter end nearest the dock; the fan extends AWAY into
+           the gutter (clear of content). */
+    }
+    /* Vertical dock — the stack is a ROW: core nearest the dock edge, members fanning out
+       (inline) into the trailing gutter. Anchored block-end (the bottom-most member at the
+       dock floor — the macOS-stack anchor topology). */
+    .dock-stack.vertical {
+        flex-direction: row;
+        align-items: flex-end;
+    }
+    /* Horizontal dock — the stack is a COLUMN: core nearest the dock edge (block-end),
+       members fanning UP into the gutter above the row. */
+    .dock-stack.horizontal {
+        flex-direction: column-reverse;
+        align-items: center;
+    }
+
+    /* The CORE anchor — the always-visible dock(1) glyph. A floating glass plate (it is
+       chrome OUTSIDE the dock substrate, so it carries its OWN glass register, not the
+       transparent in-dock recipe). */
+    .dock-stack-core {
+        flex: 0 0 auto;
+        z-index: 1;
+    }
+
+    /* The fanned members — the FadingScroll port (the one scroll-fade port). The fan's
+       main-axis extent caps at `--dock-stack-visible` members; an >visibleCount stack
+       scrolls (the port feathers the overflow). */
+    .dock-stack-fan {
+        display: flex;
+        gap: var(--dock-stack-gap);
+        /* scoped main-axis budget — the fan shows `--dock-stack-visible` members then
+           scrolls (the n-stack reachable by scrolling the rail, not the dock box). */
+    }
+    .dock-stack.vertical .dock-stack-fan {
+        flex-direction: row;
+        align-items: flex-end;
+        max-inline-size: calc(
+            var(--dock-stack-visible, 3) * var(--dock-stack-member-size) +
+                (var(--dock-stack-visible, 3) - 1) * var(--dock-stack-gap)
+        );
+    }
+    .dock-stack.horizontal .dock-stack-fan {
+        flex-direction: column-reverse;
+        align-items: center;
+        max-block-size: calc(
+            var(--dock-stack-visible, 3) * var(--dock-stack-member-size) +
+                (var(--dock-stack-visible, 3) - 1) * var(--dock-stack-gap)
+        );
+    }
+
+    /* Each member — a FULLY-VISIBLE glass icon (the `--glass-bg-floating` tier + the
+       catch-light rim), NEVER a shadowed half-tucked chip (the "NOT shadowed" verbatim
+       ask). It composes the `.dock-icon-button` base; the stack-scoped surface override
+       (0,2,0) beats the base `.dock-icon-button` (0,1,0) on source-order tie without
+       `!important`. */
+    .dock-stack-fan .dock-stack-member {
+        flex: 0 0 auto;
+        inline-size: var(--dock-stack-member-size);
+        block-size: var(--dock-stack-member-size);
+        background: var(--glass-bg-floating);
+        backdrop-filter: var(--glass-blur-floating);
+        -webkit-backdrop-filter: var(--glass-blur-floating);
+        box-shadow:
+            var(--glass-edge-light),
+            var(--glass-specular),
+            0 2px 6px -2px color-mix(in srgb, var(--shadow-color) 22%, transparent);
+        border-radius: var(--radius-pill);
+        color: color-mix(in srgb, var(--dock-fg-on-aurora, var(--foreground)) 88%, transparent);
+        /* THE FAN-OUT — compositor-only (scale/translate/opacity/filter), NO animated
+           width/height/inset (proof:no-layout-animation). At rest each member is folded
+           behind the core: scaled-down, translated toward the rail (the dock edge),
+           transparent, and a slight materialize blur. The hover-expand springs them OUT
+           staggered by `--dock-stack-stagger * var(--i)` in reading order. */
+        opacity: 0;
+        scale: var(--dock-stack-fold);
+        filter: blur(1px);
+        transition:
+            opacity var(--duration-fast) var(--ease-out)
+                calc(var(--dock-stack-stagger) * var(--i, 0)),
+            scale var(--duration-normal) var(--spring-dock, var(--ease-out))
+                calc(var(--dock-stack-stagger) * var(--i, 0)),
+            translate var(--duration-normal) var(--spring-dock, var(--ease-out))
+                calc(var(--dock-stack-stagger) * var(--i, 0)),
+            filter var(--duration-fast) var(--ease-out)
+                calc(var(--dock-stack-stagger) * var(--i, 0)),
+            background-color var(--duration-fast) var(--ease-standard),
+            box-shadow var(--duration-fast) var(--ease-standard);
+    }
+    /* Vertical dock — at rest the members tuck toward the dock edge (inline-start). */
+    .dock-stack.vertical .dock-stack-member {
+        translate: calc(-1 * var(--dock-rail-extend-length)) 0;
+    }
+    /* Horizontal dock — at rest the members tuck DOWN toward the dock edge (block-end). */
+    .dock-stack.horizontal .dock-stack-member {
+        translate: 0 var(--dock-rail-extend-length);
+    }
+    /* EXPANDED — the members spring OUT to their fanned positions (full scale, in place,
+       opaque, crisp). The stagger lives in the per-member transition-delay. */
+    .dock-stack.is-expanded .dock-stack-member {
+        opacity: 1;
+        scale: 1;
+        translate: 0 0;
+        filter: blur(0);
+    }
+    .dark .dock-stack-fan .dock-stack-member {
+        box-shadow:
+            var(--glass-edge-light-dark),
+            var(--glass-specular-dark),
+            0 2px 6px -2px color-mix(in srgb, var(--shadow-color) 30%, transparent);
+    }
+    /* The hover/active register — the floating plate firms, the glyph wakes (NOT a
+       saturated brand hue; the selected-reads-as-glass tier, W-REGISTER-IOS). */
+    .dock-stack-fan .dock-stack-member:hover {
+        background: var(--dock-control-hover-bg, var(--glass-bg-resting));
+        color: var(--dock-fg-on-aurora, var(--foreground));
+    }
+    .dock-stack-fan .dock-stack-member.is-active {
+        background: var(--dock-control-active-bg, var(--glass-bg-floating));
+        color: var(--dock-fg-on-aurora, var(--foreground));
+        box-shadow:
+            var(--glass-edge-light),
+            var(--glass-specular),
+            0 0 0 1px color-mix(in srgb, var(--foreground) 12%, transparent),
+            0 3px 8px -2px color-mix(in srgb, var(--shadow-color) 28%, transparent);
+    }
+    .dark .dock-stack-fan .dock-stack-member.is-active {
+        box-shadow:
+            var(--glass-edge-light-dark),
+            var(--glass-specular-dark),
+            0 0 0 1px color-mix(in srgb, var(--foreground) 18%, transparent),
+            0 3px 8px -2px color-mix(in srgb, var(--shadow-color) 36%, transparent);
+    }
+    .dock-stack-fan .dock-stack-member svg {
+        inline-size: 0.875rem;
+        block-size: 0.875rem;
+        flex-shrink: 0;
+    }
+
+    /* PRM — the fan SNAPS to terminal (the fade survives, the transform drops — P6 /
+       proof:no-layout-animation PRM carve). No spring travel, no stagger, no blur-settle. */
+    @media (prefers-reduced-motion: reduce) {
+        .dock-stack-fan .dock-stack-member {
+            transition:
+                opacity var(--duration-fast) linear,
+                background-color var(--duration-fast) var(--ease-standard),
+                box-shadow var(--duration-fast) var(--ease-standard);
+            scale: 1;
+            translate: 0 0;
+            filter: none;
+        }
+    }
+}

package/src/styles/dock-controls/dark-mode-toggle.css

@@ -73,13 +73,26 @@
            padding fell to `var(--dock-icon-padding, 0)` (the token is never defined →
            0 pad → the glyph filled the whole 40px box edge-to-edge, ~2.5× the 16-20px
            nav glyphs — the user's "too large" read). Pad the box by HALF the box↔glyph
-           difference so the `h-full` SVG lands at exactly `--dock-icon-glyph` (the
-           `--dock-scale`-keyed size the nav icons paint) — optically UNIFORM with the
-           nav glyphs through the utility-win path, not fighting it. */
+           difference so the `h-full` SVG lands at exactly `--dock-control-glyph-size`
+           (default `--dock-icon-glyph`, the `--dock-scale`-keyed size the nav icons
+           paint) — optically UNIFORM with the nav glyphs through the utility-win path,
+           not fighting it.
+
+           BC.W-DOCK-ENGINE move 3 (the Atlas A-9 fold) — the inset subtracts
+           `--dock-control-glyph-size`, the SAME ONE knob the SVG `width`/`height`
+           reads below, so the pad and the glyph stay LOCKED (a consumer retinting
+           `--dock-control-glyph-size` moves both in lockstep — no drift between the
+           box pad and the painted glyph). `--dock-control-size` AND
+           `--dock-control-glyph-size` both INHERIT from `.glass-dock[data-density]`,
+           where the coarse `--dock-scale` re-declare (overflow.css) re-resolves them
+           in lockstep — so the calc reads the coarse-scaled values on a coarse
+           pointer too (the AZ.R5-TOKENS substitution-vs-inheritance trap closed for
+           the toggle glyph: the var() resolves at the toggle button, reading the
+           coarse-re-resolved inherited tokens, never the frozen `:root` scale). */
         --dark-mode-toggle-padding: calc(
             (
                     var(--dock-control-size, var(--size-icon-btn)) -
-                        var(--dock-icon-glyph, 1.25rem)
+                        var(--dock-control-glyph-size, var(--dock-icon-glyph, 1.25rem))
                 ) / 2
         );
     }

package/src/styles/dock-controls/icon-button.css

@@ -113,6 +113,20 @@
             border: var(--dock-active-border);
             box-shadow: var(--dock-active-shadow);
         }
+
+        /* BC.W-DOCK-ENGINE cross-repo fold (fourier-M #10) — the `<DockIconButton
+           :active>` selectable register. The `data-active` hook the component stamps
+           reads the rail's "selected reads as glass" tier (`--dock-control-active-bg`,
+           default `--glass-bg-floating` — a GLASS tier ABOVE the rest fill, NEVER a
+           saturated brand hue, per W-REGISTER-IOS). Distinct from the consumer
+           `--dock-active-*` cohort above (a parent-scoped audacious override): this is
+           the library's default selected glass, ergonomic sugar over the shipped
+           register so a selectable dock control needs no hand-rolled active paint. The
+           glyph/label firm to the full warm-ink, mirroring the rail's `.is-active`. */
+        &[data-active] {
+            background: var(--dock-control-active-bg, var(--glass-bg-floating));
+            color: var(--dock-fg-on-aurora, var(--foreground));
+        }
     }
 
     /* focus-visible ring + disabled paint hoisted to the shared `:where()`

package/src/styles/dock.css

@@ -37,12 +37,22 @@
 @import "./dock/shell.css";
 @import "./dock/morph.css";
 @import "./dock/density.css";
+@import "./dock/shape.css";
 @import "./dock/layers.css";
 @import "./dock/layer-group.css";
 @import "./dock/overflow.css";
-@import "./dock/rail-extend.css";
+@import "./dock/stack-rail.css";
 @import "./dock/section.css";
 @import "./dock/morph-bridge.css";
+/* BC.W-AX-DOCK-CTA-SEAT — the [data-cta-pending] CTA-receive landing seat (the static
+   resting-geometry reserve + the plain transition:opacity FLIP reveal). Last in the
+   dock cascade — a net-new surface around the byte-untouched useDockCtaReceive morph. */
+@import "./dock/cta-seat.css";
+/* BC.W-DOCK-SEARCH — the dock-as-native-dynamic-search-bar field surface (the W55
+   active-field tint legibility seam + the `.glass-menu-row` result rows). A net-new
+   surface on a `[data-search]` dock around the byte-untouched morph-bridge metaball;
+   CONSUMES the W55 tint seam + the menu-row recipe, re-authors neither. */
+@import "./dock/search.css";
 
 /* AX.W01 — the SINGLE morph scalar. `useLayerTransition` writes it once per frame
    to the `.glass-dock` root; EVERY morph axis (box size, padding, radius, scale,
@@ -67,6 +77,38 @@
     initial-value: 0;
 }
 
+/* BB.W-DOCK-MORPH-FAMILY (e) — the `@property`-registered dock-scale axis. The
+   dock-scale cascade is `--dock-scale: calc(var(--ui-scale) * var(--dock-local-scale,
+   1))` (tokens/sizing.css). UNregistered, that `calc()` substitutes ONCE at `:root`
+   against the `:root` identity `--dock-local-scale: 1`, so a consumer-scope
+   `--dock-local-scale` override is INHERITED but never RE-EVALUATED — the dock keeps
+   `--dock-scale: calc(1 * 1)` and stays at the unscaled base (the 3rd recurrence of
+   the AX.W55 substitution-vs-inheritance trap; the documented-but-broken `:root`
+   preset). Registering `--dock-local-scale` as an INHERITING `@property <number>`
+   makes a registered inheriting custom property re-substitute PER-ELEMENT, so a
+   `--dock-local-scale` override on ANY dock scope re-evaluates the `calc()` at that
+   scope and threads the whole geometry cascade (box·pad·gap·tab·tile·glyph) down in
+   lockstep — the `:root` preset made real (the `@property --dock-morph-t` house
+   idiom above is the precedent). `--dock-scale` itself is ALSO registered (the
+   derived axis) so its `calc()` re-resolves per-element when `--dock-local-scale`
+   shifts. ADDITIVE ONLY: `initial-value: 1` is the identity, so at the default
+   `--dock-local-scale: 1` the resolved `--dock-scale` is byte-IDENTICAL to HEAD (no
+   rung re-tune); the `@media (pointer: coarse)` re-declare (overflow.css) STAYS the
+   `:root`-equivalent re-resolve, and this registration is the complementary
+   non-`:root`-scope thread. DOCK_SPRING is untouched (this is a token registration,
+   not a clock). */
+@property --dock-local-scale {
+    syntax: "<number>";
+    inherits: true;
+    initial-value: 1;
+}
+
+@property --dock-scale {
+    syntax: "<number>";
+    inherits: true;
+    initial-value: 1;
+}
+
 @layer components {
     :where(
         .glass-dock,

package/src/styles/drawer.css

@@ -1,21 +1,35 @@
 /*
- * drawer.css — Detented bottom-sheet grammar (AN.W3).
+ * drawer.css — Detented bottom-sheet grammar (AN.W3; BB.W-DRAWER-ABROGATE).
  *
- * vaul-vue owns the snap math (the spring transform between snap-points, the
- * drag-resistance overshoot, the `data-vaul-*` state attributes). glass-ui owns
- * the LOOK: the glass sheet surface, the rounded peek handle, the snap-stop
- * indicator rules, and the drag-resistance feel-tuning. This file is the
- * substrate so a consumer mounting `<Drawer mode="live-behind">` does not
- * re-author the three detents from scratch.
+ * THE HOUSE owns the snap math end-to-end now (vaul-vue ABROGATED). The Drawer
+ * family composes the reka `DialogRoot`/`DialogPortal`/`DialogContent` headless
+ * substrate (the SAME vueuse-free substrate every other compound wrapper binds),
+ * and the snap settle is driven by ONE house `SpringProgress` on the `DRAWER_SNAP`
+ * register (`useDrawerSnap.ts`, the §6 dock-morph `linear()` clock — NOT a bespoke
+ * `cubic-bezier(.32,.72,0,1)` transition; that was vaul's). The engine writes the
+ * `--glass-drawer-t` snap-fraction scalar (0 = closed/offscreen, 1 = the fullest
+ * detent) the content root reads as its translate; this file owns the LOOK: the
+ * glass sheet surface, the rounded peek handle, the snap-stop indicator rules, and
+ * the detent-fill geometry. This file is the substrate so a consumer mounting
+ * `<Drawer mode="live-behind">` does not re-author the three detents from scratch.
  *
  * Token-first — every visual axis reads a custom property. Consumers retune
  * the sheet by overriding the rungs below, never by editing this file.
  */
 
+/* The snap-fraction scalar the house `useDrawerSnap` engine writes per frame. The
+ * content root's inline `transform` reads it (DrawerContent.vue) — typed so the
+ * default (1 = fully open) keeps a no-snap content-sized sheet seated open. */
+@property --glass-drawer-t {
+    syntax: "<number>";
+    inherits: false;
+    initial-value: 1;
+}
+
 :root {
     /* Detent grammar knobs — overridable per-consumer */
     --drawer-handle-w: 2.25rem;
-    --drawer-handle-h: 0.3125rem; /* 5px — vaul's hit-target rhythm */
+    --drawer-handle-h: 0.3125rem; /* 5px — the iOS grip hit-target rhythm */
     --drawer-handle-color: var(--muted-foreground);
     --drawer-handle-opacity: 0.45;
     --drawer-handle-opacity-active: 0.85;
@@ -23,14 +37,15 @@
 }
 
 /*
- * The sheet surface. Replaces the prior inline-Tailwind triplet on
- * DrawerContent.vue so the glass tier + the snap transform feel live in one
+ * The sheet surface. The glass tier + the snap-translate feel live in one
  * token-driven place. The fixed/inset/z-index layout stays here too.
  *
- * NOTE: vaul-vue sets `transition: transform .5s cubic-bezier(.32,.72,0,1)` and
- * `touch-action: none` on `[data-vaul-drawer]` from its injected stylesheet —
- * that IS the drag-resistance spring curve. We do NOT override `transition` so
- * the snap feel is preserved; we layer border-radius + glass surface on top.
+ * NOTE: the snap motion is the house `useDrawerSnap` `SpringProgress` writing
+ * `--glass-drawer-t`, which the content root's inline `transform` reads (the §6
+ * doctrine — ONE motion vocabulary, no `transition: transform` curve injected on
+ * `[data-glass-drawer]`). `touch-action: none` on the handle keeps the drag gesture
+ * from scrolling the page. We layer border-radius + glass surface on top of the
+ * spring-driven translate.
  */
 .glass-drawer {
     position: fixed;
@@ -101,24 +116,26 @@
 }
 
 /*
- * Detented (snap-point) sheets fill the viewport height. vaul positions the
- * sheet by translating it DOWN by `innerHeight - (fraction * innerHeight)` —
- * so for a snap fraction to read as that fraction OF THE VIEWPORT, the sheet's
- * top must sit at the viewport top when fully open (offset 0). A `height: auto`
- * content sheet would instead translate off-screen. vaul tags the snap case via
- * `[data-vaul-snap-points=true]`; we fill height there and let the content
+ * Detented (snap-point) sheets fill the viewport height. The house engine positions
+ * the sheet by translating it along its drag axis by `(1 - --glass-drawer-t) * 100%`
+ * (DrawerContent.vue's inline transform) — so for a snap fraction to read as that
+ * fraction OF THE VIEWPORT, the sheet's top must sit at the viewport top when fully
+ * open (translate 0). A `height: auto` content sheet would instead translate
+ * off-screen. The content root tags the multi-detent case via
+ * `[data-glass-drawer-snap-points=true]`; we fill height there and let the content
  * scroll inside.
  */
-.glass-drawer[data-vaul-snap-points="true"] {
+.glass-drawer[data-glass-drawer-snap-points="true"] {
     height: 100%;
     max-height: 100%;
     margin-top: 0;
 }
 
-/* Live-behind direction variants — vaul tags the root with the drag axis.
-   Bottom is the default + the F-side pattern; the others ride the same surface
-   so a top/side live-behind sheet inherits the grammar. */
-.glass-drawer[data-vaul-drawer-direction="top"] {
+/* Direction variants — the content root tags itself with the drag axis
+   (`data-glass-drawer-direction`). Bottom is the default; the others ride the same
+   surface so a top/side sheet inherits the grammar. The side-lens (left/right) is
+   the BB-2 full-slide axis — it pins to its edge + fills the cross axis. */
+.glass-drawer[data-glass-drawer-direction="top"] {
     bottom: auto;
     top: 0;
     margin-top: 0;
@@ -128,11 +145,35 @@
     border-radius: 0 0 var(--radius-panel) var(--radius-panel);
 }
 
+.glass-drawer[data-glass-drawer-direction="left"],
+.glass-drawer[data-glass-drawer-direction="right"] {
+    inset-inline: auto;
+    inset-block: 0;
+    height: 100%;
+    max-height: 100%;
+    width: min(24rem, 92vw);
+    margin: 0;
+    border: 1px solid var(--glass-border-overlay);
+}
+
+.glass-drawer[data-glass-drawer-direction="left"] {
+    left: 0;
+    border-left: 0;
+    border-radius: 0 var(--radius-panel) var(--radius-panel) 0;
+}
+
+.glass-drawer[data-glass-drawer-direction="right"] {
+    right: 0;
+    border-right: 0;
+    border-radius: var(--radius-panel) 0 0 var(--radius-panel);
+}
+
 /*
  * Peek handle — the rounded grip at the top of the sheet. It is the visual
- * affordance the user drags to cycle peek → half → full. vaul-vue intensifies
- * the grip on `:active` via its own `[data-vaul-handle]` rules when the consumer
- * uses `<DrawerHandle>`; this is the glass-ui default grip for the common case.
+ * affordance the user drags to cycle peek → half → full. The house snap engine
+ * (`useDrawerSnap`) binds the pointer-drag gesture directly on this handle (the
+ * `[data-glass-drawer-handle]` element) and flags it `[data-dragging]` while a drag
+ * is in flight, so the grip intensifies "live" during the gesture.
  */
 .glass-drawer-handle {
     flex-shrink: 0;
@@ -154,10 +195,11 @@
         width var(--duration-fast) var(--ease-out);
 }
 
-/* While the sheet is being dragged vaul exposes the gesture; intensify the grip
-   so the affordance reads as "live". `:active` covers the pointer-held case for
-   the default grip; consumers using vaul's `<DrawerHandle>` get its own active
-   rule in addition. */
+/* While the sheet is being dragged the house engine flags the handle
+   `[data-dragging]`; intensify the grip so the affordance reads as "live".
+   `:active` covers the pointer-held case + `[data-dragging]` covers the captured
+   drag; the hover lift is the rest affordance. */
+.glass-drawer-handle[data-dragging] .glass-drawer-grip,
 .glass-drawer-handle:active .glass-drawer-grip,
 .glass-drawer:hover .glass-drawer-grip {
     opacity: var(--drawer-handle-opacity-active);
@@ -170,7 +212,8 @@
  * `.glass-drawer-snap-rule` to a separator element inside the sheet; it reads as
  * the detent boundary line without competing with the content. This is the
  * "snap-stop visual indicator" the spec asks for, expressed as an opt-in class
- * (the detents themselves are positional, owned by vaul; the RULE is the look).
+ * (the detents themselves are positional, owned by the house snap engine; the
+ * RULE is the look).
  */
 .glass-drawer-snap-rule {
     height: 1px;
@@ -179,8 +222,11 @@
     background-color: var(--drawer-snap-rule-color);
 }
 
-/* Reduced-motion — vaul's transform transition is its own; we only suppress the
-   grip's affordance animation so the handle does not pulse for PRM users. */
+/* Reduced-motion — the house `SpringProgress` snaps the detent deterministically
+   under `prefers-reduced-motion: reduce` (its `respectReducedMotion` jumps the
+   `--glass-drawer-t` scalar to target in one frame, zero motion frames); here we
+   only suppress the grip's affordance animation so the handle does not pulse for
+   PRM users. */
 @media (prefers-reduced-motion: reduce) {
     .glass-drawer-grip {
         transition: none;

package/src/styles/glass/accent-tone.css

@@ -0,0 +1,66 @@
+/* glass/accent-tone.css
+   BC.W-ACCENT-TONE — the contrast-floored 3-channel tonal-accent register.
+
+   ONE `--tone` (a complete `<color>`, default `var(--primary)`) → a coherent,
+   contrast-SAFE four-channel tonal set:
+
+     --accent-fill  idle FILL  — faint but FLOORED (≥3:1 at rest, the load-bearing
+                                 new behavior fourier named: "not just hover/active").
+     --accent-band  active BAND — the bolder selected fill.
+     --accent-edge  active EDGE — the active rim hairline.
+     --accent-ink   label INK  — the contrast-SAFE label colour ON the band, written
+                                 by useAccentTone (the JS half) via value.js
+                                 safeAccentColor; the CSS fallback is the warm ink.
+
+   The mix space is `in oklab` (the perceptual glass-tint family, W55/W-NO-GRAY) —
+   NOT `in srgb` (the `--surface-tint-*` brand-overlay fence, AW.W26). This is the
+   CONTROL tonal-FILL register (the plate background + the contrast-safe ink), a
+   DISTINCT seam from the BB `--glass-accent` glass-RIM axis (decoration on a glass
+   plate) — the two COMPOSE on a chip that is both a glass surface and a tonal
+   control (the rim from `--glass-accent`, the fill from `--accent-tone`); they
+   never fork, never write each other's channels.
+
+   The strength MAGNITUDES are TOKENS a `:root`/scope override retunes (NOT props —
+   the no-over-prop fence, component-customizability §5): `--accent-fill-strength`
+   (idle, the ~6-8% fourier names) / `--accent-band-strength` (active) /
+   `--accent-edge-strength` (rim). The idle floor is the strength default — the
+   8% over the warm-cream `--card` clears ≥3:1; proof:accent-tone A4 measures the
+   resolved idle fill against the surface (a strength that drops it below 3:1 reds).
+
+   @import-ed by glass.css in cascade order IMMEDIATELY AFTER ladder.css (the same
+   @layer components; this is the SOLE writer of the `--accent-*` channels, read at
+   use-time on the chip elements, so the placement is cascade-order-invariant). */
+@layer components {
+    .accent-tone {
+        /* `--surface` is an OPTIONAL consumer-retarget hook (NOT a declared HEAD
+           token) — a consumer sets it on the scope to point the accent at a
+           non-`--card` surface; it defaults to the declared `--card` so the recipe
+           resolves at HEAD with zero consumer wiring. */
+        --accent-fill-strength: 8%;
+        --accent-band-strength: 18%;
+        --accent-edge-strength: 55%;
+
+        /* idle: faint but FLOORED — the resting tint stays ≥3:1 by the strength
+           floor + the perceptual `in oklab` mix (the glass-tint family). */
+        --accent-fill: color-mix(
+            in oklab,
+            var(--surface, var(--card)),
+            var(--tone, var(--primary)) var(--accent-fill-strength)
+        );
+        --accent-band: color-mix(
+            in oklab,
+            var(--surface, var(--card)),
+            var(--tone, var(--primary)) var(--accent-band-strength)
+        );
+        --accent-edge: color-mix(
+            in oklab,
+            transparent,
+            var(--tone, var(--primary)) var(--accent-edge-strength)
+        );
+        /* ink is the contrast-SAFE label colour ON the active band — written by
+           useAccentTone (the JS half) via safeAccentColor onto
+           `--accent-ink-resolved`; the CSS fallback is the warm ink (CSS cannot
+           call value.js at the token tier). */
+        --accent-ink: var(--accent-ink-resolved, var(--foreground));
+    }
+}