@mkbabb/glass-ui 4.1.0 → 5.0.0

package/src/styles/dock/shell.css

@@ -14,7 +14,45 @@
 
 @layer components {
     .glass-dock {
-        --dock-surface-blur: var(--glass-blur-dock, var(--glass-blur-wash));
+        /* BG.W-GLASS-BLUR-PEER — the dock's backdrop re-points onto the SHARED
+           `--glass-blur-resting` (the unified 8px material), so the dock reads the
+           SAME `blur(8px)` RADIUS LEG as the glass button (`.btn-glass`), the
+           default-Card, and the menu-row — ONE liquid-glass material (the
+           resolved-radius peer lock, proof:glass-cal). `--glass-blur-resting`
+           carries a `saturate()` companion (it concentrates light like every
+           other tier — the flat-slab gray-read root stays closed, proof:no-gray
+           dock witnesses follow this source), and it composes `--glass-level` so
+           the `prefers-reduced-transparency` → `--glass-level: 0` a11y bracket
+           firms the dock to `blur(0)` unchanged. The `--glass-blur-dock` tier is
+           RETIRED (BG.W-CLOSEFIX-9SITE — the chain orphaned by this peer re-point);
+           the dock reads the unified resting material, there is no dock-own rung. */
+        /* BG.W-DOCK-LEGIBILITY-RECAL — re-anchor the dock's saturate at 1.2 now the
+           UNIFIED PLATE TINT is the PRIMARY anti-gray. HEAD had the dock riding the
+           content-tier `--glass-saturate-resting` (1.4) through the resting peer — the
+           C-GRAY "over-corrected to metallic" saturate the M4 revert condemns (real
+           liquid glass concentrates light ~1.1-1.25×). The plate-tint self-engage
+           (dock/adaptive-legibility.css) is now the PRIMARY anti-gray device, so saturate
+           no longer carries the whole load and drops off the metallic ceiling to the calm
+           1.2 SECONDARY floor.
+
+           THE SUBSTITUTION-VS-INHERITANCE RETUNE PATH (the recurring trap, honoured): the
+           `:root` `--glass-blur-resting` composes its `saturate(var(--glass-saturate-
+           resting))` AT `:root` — the inner `var()` is fixed at 1.4 there, so re-declaring
+           the `--glass-saturate-resting` KNOB on a descendant does NOT re-resolve the
+           inherited composed blur (the exact --glass-bg-{tier}/--glass-opacity-{tier}
+           documented trap). So the dock RE-DECLARES the COMPOSED `--glass-blur-resting`
+           here — the SAME recipe (the `--glass-blur-resting-radius` 8px primitive ×
+           `--glass-level`, so the `prefers-reduced-transparency` → `--glass-level: 0`
+           bracket firms to `blur(0)` unchanged AND the proof:glass-cal 8px PEER LOCK holds
+           by construction — the radius leg is byte-identical), with the pinned
+           `saturate(1.2)`. `--dock-surface-blur: var(--glass-blur-resting)` reads the
+           re-composed dock-scoped value; the content-tier resting plate keeps `:root`'s
+           1.4. The DARK dock read-weight is PRESERVED by the `.dark .glass-dock` arm below
+           (the 1.30 glow — the light 1.2 anchor never bleeds into the luminous-dark
+           register). Machine-locked by proof:no-gray's dock-saturate-anchored-recal
+           witnesses. */
+        --glass-blur-resting: blur(calc(var(--glass-blur-resting-radius) * var(--glass-level))) saturate(1.2);
+        --dock-surface-blur: var(--glass-blur-resting);
         /* J.W3.C — vertical-rail max-block + horizontal max-inline caps
            live as semantic tokens (defaults in `tokens.css`). When
            content exceeds the cap, the appropriate axis container
@@ -24,8 +62,7 @@
         --dock-separator-height: calc(var(--dock-h, var(--size-icon-btn)) * 0.5);
         --dock-collapsed-hover-scale: var(--scale-hover-dock);
         /* AW.W3 — the spring-keyed child stagger knobs. `--dock-stagger-window-size`
-           is the fraction of the morph each child reveals over; `--dock-stagger-rise`
-           is the px the child rises from as it fades in. Consumers retune the
+           is the fraction of the morph each child reveals over. Consumers retune the
            cascade feel per instance.
 
            AX.W02 — `--dock-stagger-step` is the per-child onset BEAT: each
@@ -49,7 +86,6 @@
            beat, that was too wide. The summary/persistent glyph is front-loaded
            structurally (onset 0, scalar-keyed below). */
         --dock-stagger-window-size: 0.4;
-        --dock-stagger-rise: 4px;
         --dock-stagger-step: 0.08;
         /* AW.W3b — big-dock tokens. `--dock-card-radius` is the finite card-shell
            radius (default --radius-dock-card = --radius-3xl, density-scaled
@@ -107,12 +143,23 @@
            as `inline-size` ONLY on the OPT-IN `containerName` host below; the default
            free-floating dock must stay shrink-to-fit, so `size`/`inline-size` is
            DELIBERATELY excluded here — adding it would re-introduce the 3.3.0 sliver
-           regression the §99 comment documents). The morph-axis `overflow: clip`
-           (the reveal aperture) + the `.glass-dock-frame` rail-escape are UNAFFECTED:
-           `layout`/`style` containment scopes RECALC, it does not establish a paint
-           clip beyond the already-present `paint` axis. The `DOCK_SPRING` clock is
+           regression the §99 comment documents). `layout`/`style` containment scopes
+           RECALC, it does not establish a paint clip — the L0 plate owns the clip
+           (W-DOCK-SPINE) and the fan/menu surfaces are TOP-LAYER popovers (W-DOCK-ESCAPE;
+           the `.glass-dock-frame` rail-escape retired). The `DOCK_SPRING` clock is
            byte-fenced (the value.js letter) — this is restyle COST, not a re-tune. */
-        contain: layout style paint;
+        /* BI.W-DOCK-SPINE — the `paint` axis is DROPPED from `contain` (the triple-identity
+           clip root). `.glass-dock` is NO LONGER the clip aperture: the L0 `.dock-plate`
+           (dock/dock.css) owns the visible extent via `clip-path` off `--dock-t`, and the
+           L1 control run is `overflow: visible`, so a hover plate at the dock edge overhangs
+           UN-CLIPPED (UF-C6/C7 unrepresentable). `contain: layout style` is KEPT (NO
+           `paint` — the A′-4 ~13fps restyle-scope for the transitional per-frame
+           `--dock-morph-t` subtree write, WITHOUT a paint clip that would re-clip the
+           controls). `contain: layout` establishes a containing block + isolates internal
+           layout but does NOT clip painting, so the controls still overhang freely. When
+           W-DOCK-SPRING-UNIFY retires `--dock-morph-t`, the plate scalar's own
+           `inherits: false` is the sole restyle-scope + `contain` can drop entirely. */
+        contain: layout style;
         display: inline-flex;
         align-items: center;
         /* AW.W1 — the dock does NOT establish a default inline-size container.
@@ -133,21 +180,15 @@
         white-space: nowrap;
         max-inline-size: var(--dock-max-inline-size);
         padding: var(--dock-padding-block, 0.375rem) var(--dock-padding-inline, 0.5rem);
-        /* AX.W55 — the dock SHELL composes the oklab tint at the ELEMENT (not via the
-           pre-substituted `--glass-bg-dock` token, which resolves its tint at the
-           `:root` 0% strength before the @container bucket can re-point it — the
-           substitution-vs-inheritance trap). Wrapping here lets the bright-bucket
-           block below (which re-points --glass-tint-source/-strength on `.glass-dock`)
-           reach the shell: the inner `--glass-bg-dock` mix is a 0% no-op at rest, the
-           outer element mix does the adaptive darken. Zero-delta at the `0%` default
-           (both mixes resolve to the flat dock bg = byte-identical to today). */
-        background: color-mix(
-            in oklab,
-            var(--glass-bg-dock, var(--glass-bg-resting)),
-            var(--glass-tint-source) var(--glass-tint-strength)
-        );
-        backdrop-filter: var(--dock-surface-blur);
-        border: 1.5px solid var(--glass-border-dock, var(--glass-border-resting));
+        /* BI.W-DOCK-SPINE — the GLASS SURFACE (background + backdrop-filter + border)
+           MOVED off `.glass-dock` onto the L0 `.dock-plate` (dock/dock.css), which owns
+           the ONE backdrop lens + its `clip-path` visible-extent morph. The box is now
+           STRUCTURAL (layout + the drop-shadow elevation below); the plate is the surface.
+           The `--dock-surface-blur` + `--glass-tint-*` tokens re-pointed on `.glass-dock`
+           by the shell + adaptive-legibility partials INHERIT to the plate, so the AZ
+           self-engage darken + the dark-arm glow reach it with ZERO re-author. The
+           collapsed↔expanded surface INTERP is retargeted onto `.dock-plate` in
+           morph.css. No `backdrop-filter` on the box → ONE lens, no double-blur. */
         /* BC.W-BLACK-BAR D2 — the dock rim is the DIRECTIONAL pair (bright catch-light
            on the TOP edge, faint warm under-shadow on the BOTTOM — glass-fx.css), the
            leading inset layers of the dock shadow stack. RETIRES the omnidirectional
@@ -157,6 +198,20 @@
         box-shadow: var(--glass-rim-top), var(--glass-rim-bottom), var(--shadow-dock-override, var(--shadow-dock));
     }
 
+    /* BG.W-DOCK-LEGIBILITY-RECAL — PRESERVE the dark-dock read-weight. The light dock
+       re-composes its blur at saturate 1.2 (the calm secondary anti-gray floor above); the
+       LUMINOUS-DARK register earns a higher saturate glow + the luminosity brightness lift
+       (the W-DARK-MATERIAL "dark glass glows where light passes" model), so the dark dock
+       RE-DECLARES the composed `--glass-blur-resting` back to the dark `:root` recipe
+       (`saturate(1.30) brightness(1.14)`) — otherwise the light `.glass-dock` re-compose
+       (which wins over the dark `:root` value by cascade order) would strip the dark glow
+       to 1.2. This is the plain per-mode pair, the house idiom; the SAME radius primitive
+       (8px × `--glass-level`, peer-lock byte-identical). The dark content-tier resting
+       plate keeps the dark `:root` value untouched (this override is `.glass-dock`-scoped). */
+    .dark .glass-dock {
+        --glass-blur-resting: blur(calc(var(--glass-blur-resting-radius) * var(--glass-level))) saturate(1.30) brightness(1.14);
+    }
+
     /* AW.W2 — the box IS the reveal aperture (clip-reveal one-clock morph).
        Migrated from `overflow: hidden` to a SINGLE-AXIS `overflow: clip` on the
        MORPH axis (horizontal clips X / visible Y; vertical clips Y / visible X),
@@ -178,34 +233,18 @@
        legitimate scroll ports (`.dock-scroll-{x,y}`, `overflow: auto`) STAY
        `auto` — they are NOT migrated. AT.W7-dock-a's orthogonality holds: the
        `containerName` opt-in does not touch the clip. */
-    .glass-dock:not(.vertical) {
-        overflow-x: clip;
-        overflow-y: visible;
-    }
-
-    .glass-dock.vertical {
-        overflow-x: visible;
-        overflow-y: clip;
-    }
-
-    /* DURING a morph the clip is the aperture — keyed off `data-morphing`, NOT
-       off `.expanded`, so it survives the whole gesture and the box reveals its
-       content rather than letting it spill. */
-    .glass-dock[data-morphing]:not(.vertical) {
-        overflow-x: clip;
-        overflow-y: visible;
-    }
-
-    .glass-dock[data-morphing].vertical {
-        overflow-x: visible;
-        overflow-y: clip;
-    }
-
-    /* AT REST EXPANDED — lift the morph-axis clip (grown content + focus ring
-       paint past the box). Fires ONLY when NOT morphing; the [data-morphing]
-       rules above win during the gesture by being more specific + later. */
-    .glass-dock.expanded:not([data-morphing]),
-    .glass-dock.always-expanded:not([data-morphing]) {
+    /* BI.W-DOCK-SPINE — the box `overflow: clip` MORPH APERTURE is DELETED (all four
+       `:not(.vertical)`/`.vertical` × `[data-morphing]` aperture rules + the rest-expanded
+       lift). `.glass-dock` NEVER clips its descendants now: the L0 `.dock-plate` owns the
+       visible-extent morph via `clip-path` off `--dock-t`, and the L1 control run is
+       `overflow: visible` BOTH axes — a hover/press plate at the dock edge overhangs
+       UN-CLIPPED (UF-C6/C7). The legitimate vertical SCROLL port (`overflow-y: auto`)
+       stays below; its cross axis is `visible` (the `overflow-clip-margin` band-aid is
+       gone — the plate is the clip). During the transitional window (until
+       W-DOCK-SPRING-UNIFY re-points the plate scalar) the box-size morph still drives the
+       extent + the plate clip is a corner-safe no-op; a mid-morph content spill is the
+       tolerated transitional state W-DOCK-CROSSFADE's content-wrapper clip closes. */
+    .glass-dock {
         overflow: visible;
     }
 
@@ -214,57 +253,74 @@
        at rest the `overflow: visible` above let over-cap content SPILL — forcing a
        consumer (bbnf-buddy ToolsLayer) to hand-anchor a max-height + scroll. Ship
        the contract here: at rest a vertical column scrolls its OWN block axis when
-       content exceeds the cap (cross axis stays `visible` for focus rings + grown
-       popovers). When content fits under the cap (`height:auto` < cap) nothing
-       scrolls — the scroll port only engages on real over-cap content. The
-       block-axis morph clip stays `data-morphing`-gated above; this is the
-       AT-REST port only. Consumers set `--dock-max-block-size` per-instance to
-       anchor the column to the viewport without re-deriving the scroll plumbing.
-
-       BA.W-DOCK-GEOMETRY (DC-1) — the port is now GATED behind the `dock-scroll-y`
-       opt-in (`overflow="scroll"`), NOT unconditional on every `.vertical.
-       always-expanded`. THE ROOT: `overflow-y: auto` is a scroll value, and CSS
-       Overflow §3 FORCES the sibling `overflow-x: visible` to COMPUTE to `auto` —
-       so the F6 pin never survived, and EVERY at-rest vertical dock (even a
-       fit-content shell that never scrolls) paid the cross-axis inline clip,
-       slicing a control's inset plate left/right (the live π readback measured
-       `overflow-x: auto` on the grow-to-fit SidebarDock). A vertical dock that
-       genuinely needs the cap+scroll opts IN via `overflow="scroll"` (the
-       `.dock-scroll-y` port in overflow.css, the SAME plumbing the F6 comment names);
-       a grow-to-fit vertical shell stays `overflow: visible` (line 186) on BOTH axes
-       so its inset control plate paints past the track. The fit-content shell pays
-       NO cross-axis clip for zero scroll benefit — the goal criterion's "the
-       scroll-port cross-axis clip no longer fires on a fit-content shell that never
-       scrolls", honored at the geometry root. */
-    .glass-dock.vertical.dock-scroll-y.always-expanded:not([data-morphing]),
-    .glass-dock.vertical.dock-scroll-y.expanded:not([data-morphing]) {
+       content exceeds the cap. When content fits under the cap (`height:auto` <
+       cap) nothing scrolls — the scroll port only engages on real over-cap
+       content. The block-axis morph clip stays `data-morphing`-gated above; this
+       is the AT-REST port only. Consumers set `--dock-max-block-size` per-instance
+       to anchor the column to the viewport without re-deriving the scroll plumbing.
+
+       BG.W-DOCK-CAP-SCROLL-FADE — a capped vertical axis is INTRINSICALLY a scroll
+       axis (the `dock-scroll-y` opt-in RETIRED): this rule fires UNCONDITIONALLY on
+       every at-rest vertical dock, so a SidebarDock that hits `--dock-max-block-
+       size` at 1280×600 scrolls its trailing utility controls into reach with NO
+       prop change (the #12 "dock scrolling broken" root fix). The CROSS (inline)
+       axis is `overflow-x: visible` — post-SPINE the L0 plate owns the clip, so
+       the scroll port's cross axis never clips the control's inset hover plate
+       (the `overflow-clip-margin` band-aid retired with the aperture, W-DOCK-SPINE).
+       The geometric inset (the 80%-of-cell plate) is the lozenge guard. The soft
+       edge-fade rides the ONE FadingScroll mask seam (the `--fade-start`/
+       `--fade-end` customs driven off `scroll(self block)` in the `@supports`
+       block below); at rest both are 0px → SHARP. NOT PRM-gated (a legibility
+       cue). */
+    .glass-dock.vertical.always-expanded:not([data-morphing]),
+    .glass-dock.vertical.expanded:not([data-morphing]) {
+        /* BI.W-DOCK-SPINE — the cross-axis `overflow-x: clip` + `overflow-clip-margin`
+           band-aid is GONE (the shell.css:294 aperture the plate retires): the L0 plate
+           owns the clip, so the scroll port's cross axis is `visible`. The block-axis
+           `overflow-y: auto` scroll port stays (a capped vertical column scrolls). */
         overflow-x: visible;
         overflow-y: auto;
         scrollbar-width: none;
         overscroll-behavior-y: contain;
     }
 
-    .glass-dock.vertical.dock-scroll-y.always-expanded:not([data-morphing])::-webkit-scrollbar,
-    .glass-dock.vertical.dock-scroll-y.expanded:not([data-morphing])::-webkit-scrollbar {
+    .glass-dock.vertical.always-expanded:not([data-morphing])::-webkit-scrollbar,
+    .glass-dock.vertical.expanded:not([data-morphing])::-webkit-scrollbar {
         display: none;
     }
 
-    .glass-dock::after {
-        content: "";
-        position: absolute;
-        inset: 0;
-        border-radius: inherit;
-        background: var(--paper-clean-texture);
-        background-repeat: repeat;
-        background-size: var(--paper-texture-size);
-        opacity: var(--glass-grain-opacity);
-        pointer-events: none;
-        mix-blend-mode: overlay;
+    /* BG.W-DOCK-CAP-SCROLL-FADE — the liquid-weight soft edge on the vertical
+       scroll port: the `mask-image` reads the `--fade-start`/`--fade-end` customs
+       the SAME `gl-fade-start-in`/`gl-fade-end-out` keyframes `<FadingScroll>`
+       uses drive off the `scroll(self block)` timeline (reached by name — ZERO
+       new recipe). The `@supports (animation-timeline: scroll())` co-gate was
+       COLLAPSED at BG.NF.2 W-LEGACY-LADDER-COLLAPSE — scroll-driven animations
+       are Baseline on the target set (the Safari-26 `scroll()` floor RATIFIED by
+       4.7's dual-engine paint PASS, WebKit 26.4 driving the ScrollTimelines
+       live), so this is the un-gated mechanism. NOT PRM-gated (a legibility
+       cue). */
+    .glass-dock.vertical.always-expanded:not([data-morphing]),
+    .glass-dock.vertical.expanded:not([data-morphing]) {
+        mask-image: linear-gradient(
+            to bottom,
+            transparent 0,
+            black var(--fade-start, 0px),
+            black calc(100% - var(--fade-end, 0px)),
+            transparent 100%
+        );
+        animation:
+            gl-fade-start-in linear both,
+            gl-fade-end-out linear both;
+        animation-timeline: scroll(self block), scroll(self block);
+        animation-range:
+            0 var(--fade-scroll-width),
+            calc(100% - var(--fade-scroll-width)) 100%;
     }
 
-    .dark .glass-dock::after {
-        mix-blend-mode: soft-light;
-    }
+    /* BI.W-DOCK-SPINE — the paper-grain `::after` MOVED onto `.dock-plate::after`
+       (dock/dock.css): the grain belongs on the glass SURFACE, which is the plate now.
+       Same recipe (the `--paper-clean-texture` overlay + the `.dark` soft-light arm),
+       byte-identical. */
 
     /* Vertical rails grow-to-fit then clamp at `--dock-max-block-size` (the
        AX.W04 F6 contract). At rest a capped column scrolls its OWN block axis
@@ -282,7 +338,7 @@
         /* AX.W45 D13-b — H/V PROPORTION PARITY. The hardcoded `gap: 0.25rem` + the
            density-blind `--dock-vertical-padding` override are DELETED. The vertical
            dock now reads the SAME `--dock-layer-gap` / `--dock-padding-*` density
-           cascade the horizontal dock tunes, so `density="spacious"` paints a LARGER
+           cascade the horizontal dock tunes, so `size="lg"` paints a LARGER
            gap than `compact` on BOTH axes (the density axis was dead on the vertical
            dock). ONE token ladder, both orientations; the `--dock-scale` multiplier
            threads it for free (the cascade is `calc(* --dock-scale)`-keyed). */
@@ -334,14 +390,15 @@
        shape/density choice, not a variant). */
     .glass-dock.vertical {
         padding: var(--dock-rail-padding, var(--dock-padding-inline, 0.5rem));
-        /* AZ.W-ADAPTIVE-AUTO Arm 1 — the vertical dock threads the SAME element-level
-           oklab tint wrapper the shell base carries (NOT the pre-substituted
-           `--glass-bg-dock` token alone, whose inner tint baked at the `:root` 0%
-           strength before the `:where(.glass-dock)` self-engage re-points the
-           inheriting tint tokens — the substitution-vs-inheritance trap §3a names).
-           Wrapping HERE lets the self-engage darken reach the vertical dock's OWN
-           plate. Zero-delta at the `0%` rest default (the mix is a no-op =
-           byte-identical to the flat dock bg). */
+    }
+
+    /* BI.W-DOCK-SPINE — the vertical dock's SURFACE (background + border-color) retargeted
+       onto the L0 `.dock-plate` (the box is structural; the plate is the glass). The
+       AZ.W-ADAPTIVE-AUTO element-level oklab tint composes the inheriting
+       `--glass-tint-source`/`-strength` the self-engage re-points on `.glass-dock`, so the
+       darken reaches the vertical plate. Zero-delta at the `0%` rest default. morph.css's
+       `.glass-dock.vertical .dock-plate` interp (0,3,0) OVERRIDES this during the morph. */
+    .glass-dock.vertical .dock-plate {
         background: color-mix(
             in oklab,
             var(--glass-bg-dock, var(--glass-bg-wash)),
@@ -370,7 +427,7 @@
         border-radius: calc(
             var(--radius-pill) +
                 (var(--dock-card-radius) - var(--radius-pill)) *
-                var(--dock-expand-t, 1)
+                var(--dock-expand-t)
         );
     }
 
@@ -396,7 +453,7 @@
         border-radius: calc(
             var(--radius-pill) +
                 (var(--dock-card-radius) - var(--radius-pill)) *
-                var(--dock-expand-t, 1)
+                var(--dock-expand-t)
         );
     }
 
@@ -440,61 +497,4 @@
         margin: 0 auto;
     }
 
-    /* AX.W45 D13-a — the PERSISTENT region (the iOS Now-Playing / Stage-Manager
-       idiom done STRUCTURALLY). The `#persistent` slot lives in-flow as a root flex
-       SIBLING of the morph-region (`.dock-layers`) in BOTH collapsed AND expanded —
-       NEVER `:inert`, NEVER a crossfade pane, NEVER a `registerGroup` morph target.
-       It is a stable always-present rail beside the expand-on-demand content region,
-       so a consumer keeps a control visible while collapsed WITHOUT hand-duplicating
-       it into both the `#default` and `#collapsed` slots. The region co-laid by the
-       root flex/grid; the morph scalar `--dock-morph-t` co-drives only its chrome
-       (it inherits the root padding/radius morph), it is NOT a morph TARGET. It holds
-       steady (no jitter) while the morph-region's aperture animates on the ONE
-       spring. `align-items: center` keeps it on the dock's centerline; the
-       `--dock-layer-gap` separates it from the morph region (same rhythm both
-       orientations). */
-    .dock-persistent {
-        display: flex;
-        align-items: center;
-        flex-shrink: 0;
-        gap: var(--dock-layer-gap, 0.375rem);
-    }
-
-    .glass-dock:not(.vertical) .dock-persistent {
-        flex-direction: row;
-    }
-
-    .glass-dock.vertical .dock-persistent {
-        flex-direction: column;
-        align-items: stretch;
-    }
-
-    /* The persistent region + the morph region share the dock's gap rhythm. The
-       region renders only when the consumer authors a `#persistent` slot
-       (GlassDock.vue guards it with `v-if="$slots.persistent"`), so a dock with no
-       persistent controls is byte-identical to before (no empty flex item). */
-    .glass-dock:not(.vertical) .dock-persistent + .dock-layers {
-        margin-inline-start: var(--dock-layer-gap, 0.375rem);
-    }
-
-    .glass-dock.vertical .dock-persistent + .dock-layers {
-        margin-block-start: var(--dock-layer-gap, 0.375rem);
-    }
-
-    /* AZ.W-DOCK-TAXONOMY (move 2) — the VERTICAL dock's layer panes lay their content
-       out as a COLUMN. The dock body is now the SAME orientation-agnostic
-       `.dock-layers` full/summary morph pair the horizontal dock uses (the prior
-       static `.dock-layer--vertical-body` single-stack RETIRED — a vertical dock now
-       collapses its block axis too). The base `.dock-layer { display: flex;
-       align-items: center }` is row by default; here the full/summary panes flip to a
-       stretched column stack carrying the dock's `--dock-layer-gap` rhythm, so
-       authored item groups + `<DockSeparator>` rules read with the correct vertical
-       cadence. The block-axis morph aperture is owned by `.dock-layers` (layers.css —
-       `.glass-dock.vertical[data-morphing] .dock-layers` morphs `block-size`). */
-    .glass-dock.vertical .dock-layer {
-        flex-direction: column;
-        align-items: stretch;
-        gap: var(--dock-layer-gap, 0.375rem);
-        min-width: 0;
-    }
 }

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

@@ -36,7 +36,8 @@
         }
 
         &:focus-visible {
-            box-shadow: var(--focus-ring-shadow);
+            /* BI.W-DOCK-CONTROLS (value.js P5) — the ONE dock ring register. */
+            box-shadow: var(--dock-ring);
         }
 
         &[data-size="sm"] {
@@ -83,7 +84,7 @@
            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]`,
+           `--dock-control-glyph-size` both INHERIT from `.glass-dock[data-size]`,
            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

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

@@ -11,6 +11,18 @@
    the dock-controls.css root. */
 
 @layer components {
+    /* BG.W-LIQUID-WEIGHT-DEFAULT (F5.2, row 2) — the dock press drive typed registration.
+       `useLiquidPress` (DockIconButton) writes it 0→1 on the press spring; the coupled
+       darken/specular legs read it via `calc()` (typed <number> so the calc interpolates),
+       and an unwired / SSR / no-JS dock control reads the static rest 0 (the no-JS floor —
+       the `:active` register carries the press without it). Inherits so the material
+       `::before` catch-light (a descendant pseudo) reads the host's press scalar. */
+    @property --dock-press-t {
+        syntax: "<number>";
+        inherits: true;
+        initial-value: 0;
+    }
+
     .dock-icon-button {
         display: inline-flex;
         align-items: center;
@@ -20,20 +32,19 @@
         scale: 1;
         width: var(--dock-control-size, var(--size-icon-btn));
         height: var(--dock-control-size, var(--size-icon-btn));
-        /* BA.W-DOCK-GEOMETRY — the control-plate clearance inset (DC-2). The HIT
-           BOX stays the full `--dock-control-size` (the WCAG 2.5.5 touch floor on
-           the CELL), while the inset padding + `background-clip: content-box`
-           insets the PAINTED plate within it: the hover/active fill paints only the
-           content box (the cell minus the inset on every side), so the maximal
-           hover (×1.1) / active circle clears the cross-axis clip edge with ≥1px
-           margin — the lozenge dies at the plate diameter, not at the clip box. The
-           inset falls back to the prior `--dock-icon-padding` (0) when no dock
-           ancestor sets `--dock-control-safe-inset` (a standalone icon button). */
-        padding: var(--dock-icon-padding, var(--dock-control-safe-inset, 0));
+        /* BI.W-DOCK-CONTROLS — the `--dock-control-safe-inset` painted-plate inset
+           FOLDED onto the shared `.glass-capsule` face (glass/glass-capsule.css):
+           `.glass-dock .dock-icon-button { padding: var(--dock-icon-padding,
+           var(--dock-control-safe-inset, 0)) }` + `background-clip: content-box` on
+           the capsule family. The HIT CELL stays the full `--dock-control-size`
+           (the WCAG 2.5.5 touch floor on the CELL); the painted plate insets within
+           it (hit box ≠ paint box). Here the standalone routing is GONE — a bare
+           standalone icon button (outside a dock) keeps only its `--dock-icon-padding`
+           override, no safe-inset token read (the face owns the token). */
+        padding: var(--dock-icon-padding, 0);
         cursor: pointer;
         border: none;
         background: transparent;
-        background-clip: content-box;
         border-radius: var(--dock-control-radius, var(--radius-pill));
         /* Foreground base routes through `--dock-fg-on-aurora` (defaults to
            `--foreground`, byte-identical to before) so a consumer floating the
@@ -59,6 +70,27 @@
                specular no longer rides it. */
                 box-shadow var(--dock-motion-fast);
 
+        /* BG.W-LIQUID-WEIGHT-DEFAULT (F5.2, row 2) — the dock control press couples to
+           the ONE interruptible press spring. DockIconButton composes `useLiquidPress`
+           (springPreset('press'), squish on) writing the `--dock-press-t` 0..1 drive; the
+           CSS reads it on TWO coupled feedback legs so a tap reads as a spring-settling iOS
+           press (the paint-judge dock-hover-press repair), while the binary `:active`
+           register below stays the no-JS / PRM floor:
+
+           • the SPECULAR leg — the dock press drive aliases onto the shared
+             `--glass-btn-press-t` the material `::before` catch-light reads (glass/
+             material.css `--specular-intensity: max(rest, active·--glass-btn-press-t)`),
+             so on RELEASE the gleam SETTLES with the spring's alive rebound instead of
+             snapping to rest (the material comment's "a dock control writes it" intent, now
+             wired). At rest `--dock-press-t` is 0 → `--glass-btn-press-t` 0 → byte-identical
+             (no second specular recipe — the DRY reuse of the built material gleam).
+           • the DARKEN leg — a sub-perceptual `filter: brightness()` deepen on the SAME
+             drive so the plate reads as pressing IN (not just shrinking), settling on the
+             spring; `filter` is compositor-safe (`proof:no-layout-animation` greens it),
+             and `brightness(1)` at rest is a no-op. */
+        --glass-btn-press-t: var(--dock-press-t, 0);
+        filter: brightness(calc(1 - var(--dock-press-t, 0) * 0.04));
+
         /* AT.W7-dock-b — glass icon-hover. The icon-button hover reads as a glass
            surface, not a flat `--muted` plate: a translucent card-tinted fill is
            the hover affordance. A consumer retunes the fill via `--dock-icon-hover-bg`.
@@ -95,6 +127,18 @@
             scale: var(--scale-press-dock);
         }
 
+        /* W-NAV-DOCK-FIX — the four-state DISABLED register. A boundary nav control
+           (prev/next at the first/last item) stays PRESENT but disabled so the row
+           geometry holds (never DOM-absent — the "flaky" read). It dims to the shared
+           disabled opacity + suppresses the press/pointer (the hover/active rules
+           already `:not(:disabled)`-exclude it, so this only needs the dim + the
+           pointer-suppress). Compositor-only (opacity); no layout shift. */
+        &:disabled {
+            opacity: var(--opacity-disabled, 0.4);
+            pointer-events: none;
+            cursor: default;
+        }
+
         &:focus:not(:focus-visible) {
             box-shadow: none;
             outline: none;
@@ -122,9 +166,29 @@
            `--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`. */
+           glyph/label firm to the full warm-ink, mirroring the rail's `.is-active`.
+
+           BD.W-DOCK-CORE (P4 deferred) — the selected pill now COMPOSES the shared
+           `.glass-capsule` register (the component adds the `.glass-capsule` class when
+           `active`). So instead of painting a bare `background`, the `[data-active]`
+           rung re-points `--glass-capsule-fill` (the override hook the capsule register
+           exposes) to the selected glass tier — the capsule's lifted-plate composite
+           (rim + lift + the warm-floor fill base) reads the selected tier WITHOUT
+           forking the register (the selected-parity rung). The glyph firms to the full
+           warm-ink. */
         &[data-active] {
-            background: var(--dock-control-active-bg, var(--glass-bg-floating));
+            --glass-capsule-fill: var(
+                --dock-control-active-bg,
+                var(--glass-bg-floating)
+            );
+            /* Re-assert the capsule fill as the painted background — the base
+               `.dock-icon-button { background: transparent }` (same layer, later
+               source order, equal specificity) would otherwise win over
+               `.glass-capsule`'s background; this `[data-active]` rule (specificity
+               0,2,0 > the base 0,1,0) hands the selected pill its lifted-glass fill.
+               The capsule's rim/lift `box-shadow` + `backdrop-filter` already apply
+               (the base rule never sets those). */
+            background: var(--glass-capsule-fill);
             color: var(--dock-fg-on-aurora, var(--foreground));
         }
     }

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

@@ -17,9 +17,9 @@
            knob (parallel to DockIconButton's --dock-control-size) merged
            here from the prior DockTabButton.vue scoped style block. The
            density rungs that set `--dock-tab-h` per tier live in dock.css
-           (the `.glass-dock[data-density="…"]` blocks) — Q.W3
+           (the `.glass-dock[data-size="…"]` blocks) — Q.W3
            Lane A consolidated them out of utilities.css, closing the
-           cascade-order split-brain. When a parent <GlassDock density="…">
+           cascade-order split-brain. When a parent <GlassDock size="…">
            sets `--dock-tab-h`, the tab-button reserves that row even when
            the glyph + padding sum would ride lower. Falls through to
            `--dock-tab-min-height` (kept for audacious-tier callers) and

package/src/styles/dock-controls/touch-floor.css

@@ -27,6 +27,31 @@
             min-block-size: var(--dock-touch-target, 2.75rem);
             min-inline-size: var(--dock-touch-target, 2.75rem);
         }
+
+        /* ATLAS-N C3 (NF.1 rider) — the compact/dense DOCK-TRIGGER 44px tap floor via a
+           HIT-SLOP, not a box grow. The select/dropdown triggers size off
+           `min-height: auto` + padding (NOT `--dock-control-size`), so on a compact/dense
+           rung a coarse-pointer trigger paints ~32×24 — below the WCAG-2.5.5 chrome floor
+           (the atlas census `.dock-trigger.dock-dropdown-trigger` = 32×24). A centred
+           `::after` hit-slop extends the POINTER target to `--dock-touch-target` in each
+           axis WITHOUT painting or growing the box (the atlas N-SPEC §4.5 chrome-floor
+           idiom — `--dock-control-floor`/`--dock-touch-target` names survive per Q4). The
+           slop is a transparent child of the button, so a tap anywhere within it fires the
+           button; `max(100%, …)` is SELF-LIMITING — a trigger already ≥ floor gets a slop
+           exactly its own size (no-op), so the rule never shrinks nor over-grows a target. */
+        :is(.dock-trigger, .dock-select-trigger, .dock-dropdown-trigger) {
+            position: relative;
+        }
+        :is(.dock-trigger, .dock-select-trigger, .dock-dropdown-trigger)::after {
+            content: "";
+            position: absolute;
+            inset-block-start: 50%;
+            inset-inline-start: 50%;
+            inline-size: max(100%, var(--dock-touch-target, 2.75rem));
+            block-size: max(100%, var(--dock-touch-target, 2.75rem));
+            transform: translate(-50%, -50%);
+            /* transparent — the slop extends the tap area, never the paint. */
+        }
     }
 
     /* AX.W06 F2/F3 — the HOISTED refined rail nav-item polish. The demo's