@mkbabb/glass-ui 5.0.0 → 6.0.0

package/src/styles/dock/shell.css

@@ -1,500 +0,0 @@
-/* dock/shell.css — the `.glass-dock` structural skeleton (AX.W06 carve).
- *
- * Carved from the dock.css god-module (slice 25). This partial owns the dock's
- * STATIC structural surface: the `.glass-dock` root + the W02 single-axis
- * `overflow: clip` morph aperture, the paper-grain `::after`, the vertical-root
- * column layout, the shape/variant plates (rail · instrument-strip · the
- * horizontal shape-rounded/card + the W56 squircle), the position helpers, and
- * the W45 `#persistent` / vertical three-region body. The dynamic single-scalar
- * morph chrome lives in dock/morph.css; the density × `--dock-scale` cascade in
- * dock/density.css; the layer crossfade/hit-test in dock/layers.css.
- *
- * @import-ed by dock.css in cascade order, in the SAME `@layer components` — the
- * carve is isomorphic (same layer, same source order → ZERO visual delta). */
-
-@layer components {
-    .glass-dock {
-        /* 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
-           scrolls with a mask-fade. Consumers override per-instance by
-           setting `--dock-max-block-size` / `--dock-max-inline-size`
-           on a `.glass-dock` directly. */
-        --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. Consumers retune the
-           cascade feel per instance.
-
-           AX.W02 — `--dock-stagger-step` is the per-child onset BEAT: each
-           successive control's reveal starts this fraction-of-morph later than the
-           one before it, so the row fills outer→in. ONE token × the child index
-           replaces the hand-typed 0.08/0.16/0.24/0.32/0.4 onset ladder — the onset
-           is `step × (childIndex − 1)`, capped (the cap below). 0.08 = ~5% of the
-           ~0.32s morph between items — inside Emil Kowalski's 30–60ms stagger band,
-           never the >100ms "slideshow" register. The onset rides the NORMALIZED
-           morph progress (`--dock-expand-t`), NOT a wall-clock timer, so a fast
-           flick and a slow hover-open both choreograph correctly and an interrupted
-           morph orphans no timers.
-
-           AX.W45 DK1/DK7 — the window NARROWED 0.55 → 0.4. The per-child onset caps
-           at `step × 5 = 0.40` (child 6+), so the LAST detail child used to finish at
-           `0.40 + 0.55 = 0.95` of the morph — it barely appeared until 95% through
-           (the "shrunken icon does not appear for a while" tail). Tightening the
-           window to 0.4 lands the last child at `0.40 + 0.4 = 0.80` (the iOS front-
-           loaded register: stagger the EXPANDING detail, never the persistent/summary
-           glyph). The step (0.08, Kowalski's band) is KEPT — it is the window, not the
-           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-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
-           below); `--dock-tile-min` is the grid tile minimum (auto-fill track
-           floor). Both are density-scaled (compact tighter, spacious looser) — the
-           card radius + tile size ride the density cascade, never magic numbers. */
-        --dock-card-radius: var(--radius-dock-card);
-        --dock-tile-min: 4.5rem;
-        /* Individual-transform identity base (AQ.W3 §W3.2). `scale: 1` at rest
-           mints the stacking context once so a portaled popover over `--z-dock`
-           stays above the dock during a hover scale (the load-bearing
-           stacking-context guarantee). Covers every dock scale site. */
-        scale: 1;
-        position: relative;
-        /* AZ.W-ADAPTIVE-AUTO Arm 1 — the dock self-darkens over light backdrops by
-           default via the UNCONDITIONAL `:where(.glass-dock)` self-engage rule in
-           dock/morph.css (mirroring the overlay band's `ladder.css:169`): it re-points
-           the inheriting `--glass-tint-source`/`--glass-tint-strength` directly on the
-           dock root, so the shell + chassis + held/open tiers darken toward warm-ink
-           with NO consumer opt-in (a dock floats over arbitrary — frequently light —
-           page content). `--glass-backdrop: light` is KEPT here so a consumer's
-           DESCENDANT nested-glass inside the dock also reads the bright bucket via the
-           ancestor-querying `@container` block in dock/morph.css (CSS style queries
-           never self-match, so this declaration alone is inert for the dock's OWN
-           plate — the self-engage rule, not this token, darkens the dock). */
-        --glass-backdrop: light;
-        /* AY.W-A11Y-PERF O-4 — paint containment so the maximal-glass nested
-           backdrop-filter sample does not escape the dock box (the standard nested-
-           backdrop-cost mitigation; the Button-in-glass-in-dock stack re-samples the
-           already-blurred buffer at each level without it). */
-        /* BA.W-DOCK-GEOMETRY contain:paint AUDIT verdict (a) — the control-plate
-           clearance fix (the `--dock-control-safe-inset` painted-plate inset, scope
-           1) + the scroll-port cross-axis un-clip (scope 2) keep the maximal
-           hover/active control plate INSIDE the dock padding box: the inset plate is
-           centered in its cell (≥1px slack/side at hover), the cell sits flush at the
-           dock content edge, and the `--dock-padding-block` (≈6px) padding holds the
-           plate ≥7px clear of the `contain: paint` border-box edge on the block axis.
-           So the `paint` clip axis is the NON-proximate second clip box (the lane's
-           `probe-bottomdock-nocontain.png` forced-root probe proved the inner
-           scroll-port box was proximate, not this) and the `paint` axis is RETAINED
-           here — the inset + freed cross axis suffice, no containment LIFT on the
-           control-plate band. (BB.W-PERF-PRODUCER A′-4 widens the value to
-           `contain: layout style paint` — the restyle-scope axes ALONGSIDE the paint
-           clip box, see below — but never lifts `paint`.) The π readback
-           (W-DOCK-GEOMETRY-DELTA.md) records the live plate-inside-padding margin
-           number that binds this verdict. */
-        /* BB.W-PERF-PRODUCER A′-4 — the `--dock-morph-t` restyle-scope narrowing.
-           The per-frame morph scalar write recomputes the inheriting `calc()` group
-           across the dock subtree (dock.css's 10-selector `:where()` consumers); add
-           the `layout` + `style` containment axes so a scalar write recomputes
-           layout/style WITHIN the dock subtree, not up the document (the value.js A′-4
-           ~13fps restyle-cost trace). RECONCILED with the existing axes: `paint`
-           (above, the BA.W-DOCK-GEOMETRY clip box) composes — `contain: layout style
-           paint` is the union, NEVER `size` (which `container-type: inline-size` carries
-           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). `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. */
-        /* 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.
-           `container-type: inline-size` applies `contain: inline-size`, which
-           makes an element's inline size INDEPENDENT of its contents — fatally
-           incompatible with a shrink-to-fit pill: under it `.glass-dock` cannot
-           size to its content and collapses to its padding floor (~19px) with the
-           active layer overflowing (the 3.3.0 regression — every horizontal dock,
-           collapsed AND always-expanded, rendered as a sliver). The `dock`-named
-           container is now OPT-IN via the `containerName` prop: a consumer
-           embedding the dock in a width-CONSTRAINED host (a 320px sidebar) sets
-           `containerName="dock"` to get the descendant container-query reads (the
-           audacious-label compression below), trading shrink-to-fit for the
-           host-constrained width it already has there. The default free-floating
-           dock shrink-wraps to its content (AV.W16 TW3 made this a default and
-           silently broke dock sizing for the common case). */
-        /* BC.W-DOCK-ARBITRARY — the base corner is the shape register's token lerp (dock/shape.css, the single radius authority generalizing the prior static). */
-        white-space: nowrap;
-        max-inline-size: var(--dock-max-inline-size);
-        padding: var(--dock-padding-block, 0.375rem) var(--dock-padding-inline, 0.5rem);
-        /* 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
-           `--glass-edge-light` ring that fought the (now ≤4% α) `--glass-border-dock`
-           perimeter; the navigation band reads its rim from the SAME corrected token
-           source as cards/dialogs (no dock-local dark rim re-paste). */
-        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),
-       gated on a `data-morphing` attribute the driver owns (set at gesture START,
-       cleared on SETTLE). The clip PERSISTS through the morph — content is laid
-       out ONCE at its natural size behind the aperture and the growing/shrinking
-       box uncovers it, never spills it — and lifts to `visible` only at REST
-       expanded (so grown content + the focus ring paint past the box). The
-       prior `.expanded { overflow: visible }` (bound synchronously to
-       `visualExpanded`) lifted the clip at frame 0, leaving no aperture to reveal
-       through; the `:not([data-morphing])` guard holds the clip for the whole
-       gesture and lifts it on the final paint.
-
-       `overflow: clip` is PAINT-ONLY (not a scroll container): it never
-       participates in `scrollIntoView`/scroll-anchoring, cannot be a
-       scroll-driven-animation `scroller`, and drops the `min-width:0` scroll-box
-       dance for the non-scroll shell. The cross axis is ALWAYS explicitly
-       `visible` (the MDN single-axis-clip-degrades-to-hidden caveat). The
-       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. */
-    /* 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;
-    }
-
-    /* AX.W04 F6 — the vertical-dock max-block-size + internal-scroll CONTRACT.
-       A vertical rail caps at `--dock-max-block-size` (the `.vertical` rule), but
-       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. 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.always-expanded:not([data-morphing])::-webkit-scrollbar,
-    .glass-dock.vertical.expanded:not([data-morphing])::-webkit-scrollbar {
-        display: none;
-    }
-
-    /* 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%;
-    }
-
-    /* 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
-       internally (the `.vertical.always-expanded:not([data-morphing])` port above)
-       so a consumer setting `--dock-max-block-size` gets a viewport-anchored
-       scrollable tool palette without hand-anchoring it. `overflow="wrap"` is
-       horizontal-only (the class is not emitted for a vertical orientation); a
-       vertical column's natural overflow story is this cap + internal scroll. No
-       edge-fade mask — the scroll is scrollbar-hidden, not feathered. */
-    .glass-dock.vertical {
-        display: inline-flex;
-        flex-direction: column;
-        align-items: stretch;
-        justify-content: flex-start;
-        /* 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 `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). */
-        gap: var(--dock-layer-gap, 0.375rem);
-        white-space: normal;
-        width: auto;
-        height: auto;
-        max-block-size: var(--dock-max-block-size);
-        /* overflow on the block (morph) axis is the data-morphing-gated clip
-           shell above; the cross axis stays visible there. */
-        padding: var(--dock-padding-block, 0.375rem);
-        border-radius: var(--radius-dock);
-        /* BB.W-DOCK-MORPH-FAMILY (f) — the stale "a vertical rail is ALWAYS-EXPANDED
-           (no collapse↔expand morph)" assumption is RETIRED (it was false since
-           vertical-collapse shipped: `alwaysExpanded` defaults FALSE, so a vertical
-           dock genuinely collapses its `block-size`). The vertical plate's
-           bg/border/padding/radius now MORPH on the SAME `--dock-expand-t` scalar
-           the horizontal chrome rides (the morph.css `.glass-dock.vertical` interp +
-           padding axis-inverse + the radius arm below) — the chrome follows the
-           box-size morph, no discrete snap. NO root CSS-transition on the morph-
-           chrome props is re-added (a `transition: padding/background/border-color`
-           arm is the second-clock smell the single-scalar rebuild forbids — the
-           `--dock-expand-t` interp is the single authority). KEPT: the DECORATIVE
-           hover-scale + press-squish (the individual `scale`/`transform`) and the
-           box-shadow fade — interaction polish on the rail, NOT the morph chrome. */
-        transition:
-            box-shadow var(--dock-motion-standard),
-            transform var(--dock-motion-resize),
-            scale var(--dock-motion-resize);
-    }
-
-    /* BC.W-DOCK-ENGINE move 2 — the rail polish transition is COMPOSITOR-PROMOTED
-       only while its hover/press/held state is ARMED (the transform/scale legs ride
-       the compositor channel; `will-change: transform` hints the layer for the
-       gesture). NEVER a resting `will-change` (a permanent promotion pins a wasted
-       compositor layer at rest — the motion-canon P5 no-resting-promotion floor):
-       the hint lives on the `:hover`/`:active`/`[data-held]` armed selectors and is
-       cleared the instant the state releases. PRM keeps no pinned layer either — the
-       universal a11y carve strips the spatial transform under reduce, and a
-       non-animating rail needs no promotion. */
-    .glass-dock.vertical:hover,
-    .glass-dock.vertical:active,
-    .glass-dock.vertical[data-held] {
-        will-change: transform;
-    }
-
-    /* AZ.W-DOCK-TAXONOMY — the vertical dock's surface plate (the prior
-       `.variant-rail` block; "rail-ness" is now `orientation="vertical"` + a
-       shape/density choice, not a variant). */
-    .glass-dock.vertical {
-        padding: var(--dock-rail-padding, var(--dock-padding-inline, 0.5rem));
-    }
-
-    /* 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)),
-            var(--glass-tint-source) var(--glass-tint-strength)
-        );
-        border-color: var(--glass-border-dock, var(--glass-border-wash));
-    }
-
-    .glass-dock.vertical.shape-pill {
-        border-radius: var(--radius-pill);
-    }
-
-    .glass-dock.vertical.shape-rounded {
-        border-radius: var(--radius-xl);
-    }
-
-    /* BB.W-DOCK-MORPH-FAMILY (f) — the VERTICAL big-dock CARD radius MORPHS on the
-       SAME `--dock-expand-t` scalar the horizontal `.shape-card` rides (the radius
-       arm of the vertical chrome un-gate; it lives in shell.css beside the horizontal
-       arm, not morph.css). `--radius-pill` at expand-t 0 (collapsed), the finite
-       `--dock-card-radius` at expand-t 1 (expanded) — the radius follows the box-size
-       block morph, no discrete snap. The static `.shape-pill`/`.shape-rounded` rest
-       radii above are the rest endpoints for those shapes; this is the card shape's
-       interpolated radius (mirroring the horizontal `:not(.vertical).shape-card`). */
-    .glass-dock.vertical.shape-card {
-        border-radius: calc(
-            var(--radius-pill) +
-                (var(--dock-card-radius) - var(--radius-pill)) *
-                var(--dock-expand-t)
-        );
-    }
-
-    /* AW.W3b — horizontal-root shape rules. The `shape-*` class once bound ONLY under
-       the vertical surface; on a horizontal dock the prop silently no-op'd (the root
-       hardwired `--radius-dock` = `--radius-pill`). These rules close that
-       documented-but-dead prop — `shape="rounded"` / `shape="card"` now paint on a
-       horizontal dock. Scoped to `:not(.vertical)` so the vertical dock (which owns
-       its own radius above) is untouched. */
-    .glass-dock:not(.vertical).shape-rounded {
-        border-radius: var(--radius-xl);
-    }
-
-    /* The big-dock CARD shell — a FINITE concentric radius above 2xl, below pill.
-       It does NOT collapse to a stadium. Collapsed it returns to a pill (the morph
-       target); the pill↔card radius now MORPHS on the SAME `--dock-expand-t` scalar
-       the box + chrome ride (ONE clock, no discrete snap) — `--radius-pill` at
-       expand-t 0 (collapsed), `--dock-card-radius` at expand-t 1 (expanded). The
-       prior two discrete `.shape-card` / `.shape-card.collapsed` rules + their
-       reliance on the deleted `border-radius var(--dock-motion-resize)` transition
-       are RETIRED for this single interpolation. */
-    .glass-dock:not(.vertical).shape-card {
-        border-radius: calc(
-            var(--radius-pill) +
-                (var(--dock-card-radius) - var(--radius-pill)) *
-                var(--dock-expand-t)
-        );
-    }
-
-    /* AX.W56 — the big-dock IS the one squircle surface (the rounded-vs-squircle
-       policy: cards/pills/panels stay round, big-docks + the like → superellipse).
-       The squircle reads markedly better at the large `--radius-dock-card` (24px)
-       shell — an `@supports`-gated ENHANCEMENT only (Chrome 139+, no FF/Safari 2026).
-       The `border-radius` arc is the cross-engine CONTRACT; the squircle is the
-       better tier (NOT a degraded fallback). The shape is now the tokenized
-       `var(--corner-shape-bigdock)` (theme.css) so it is as overridable as the
-       radius — a consumer retints the corner shape from `:root`, and W42's
-       dock-morph reads the same `--corner-k-*` vocabulary. The `@supports`
-       condition tests the LITERAL `superellipse(2)` (a `var()` is not evaluable in
-       an `@supports` query) — the same Chrome-139 feature the token resolves to. */
-    @supports (corner-shape: superellipse(2)) {
-        .glass-dock:not(.vertical).shape-card {
-            corner-shape: var(--corner-shape-bigdock);
-        }
-    }
-
-    /* AZ.W-DOCK-TAXONOMY — the `instrument-strip` chassis-strip variant is RETIRED
-       (the ≥2-consumer bar). It carried the vocabulary of the InstrumentRail
-       component RETIRED at AY W-IC1; with the `variant` discriminant gone and no
-       live `variant="instrument-strip"` call-site in src/ or demo/, the chassis
-       paint has zero consumers. The cross-repo speedtest SurveyResultDock cockpit
-       re-pins in its own migration (recorded in MIGRATION.md). A consumer needing
-       the chassis surface composes `<InstrumentChassis>` directly. */
-
-    .glass-dock:where(.fixed) {
-        z-index: var(--z-dock);
-    }
-
-    .dock-inline {
-        margin: 0 auto;
-    }
-
-    .dock-sticky {
-        position: sticky;
-        top: 0;
-        z-index: var(--z-dock);
-        margin: 0 auto;
-    }
-
-}

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

@@ -1,123 +0,0 @@
-/* dock-controls/dark-mode-toggle.css — the `.dark-mode-toggle-button` control
-   family (AZ.W-CARVE partial 2 of 5; carved out of dock-controls.css).
-
-   The standalone toggle sizes (sm/md/lg/control) + the IN-DOCK glyph-inset
-   contract (AY.W-DOCK-CHROME §2 / AX.W06 USF-2 — the toggle glyph routes through
-   `--dock-control-glyph-size` so it is optically uniform with the nav glyphs when
-   docked). Opens its OWN `@layer components`; @import-ed after icon-button.css. */
-
-@layer components {
-    .dark-mode-toggle-button {
-        width: var(--dark-mode-toggle-size, 2.25rem);
-        height: var(--dark-mode-toggle-size, 2.25rem);
-        min-width: var(--dark-mode-toggle-size, 2.25rem);
-        min-height: var(--dark-mode-toggle-size, 2.25rem);
-        max-width: var(--dark-mode-toggle-size, 2.25rem);
-        max-height: var(--dark-mode-toggle-size, 2.25rem);
-        aspect-ratio: 1;
-        padding: var(--dark-mode-toggle-padding, 0.375rem);
-        transition:
-            opacity var(--dock-motion-standard),
-            background-color var(--dock-motion-standard),
-            box-shadow var(--dock-motion-fast);
-
-        & > svg {
-            width: 100%;
-            height: 100%;
-            max-width: 100%;
-            max-height: 100%;
-        }
-
-        &:hover,
-        &:focus {
-            background: var(--surface-tint-10);
-            opacity: 1;
-            outline: none;
-        }
-
-        &:focus-visible {
-            /* BI.W-DOCK-CONTROLS (value.js P5) — the ONE dock ring register. */
-            box-shadow: var(--dock-ring);
-        }
-
-        &[data-size="sm"] {
-            --dark-mode-toggle-size: 1.75rem;
-            --dark-mode-toggle-padding: 0.25rem;
-        }
-
-        &[data-size="md"] {
-            --dark-mode-toggle-size: 2.25rem;
-            --dark-mode-toggle-padding: 0.375rem;
-        }
-
-        &[data-size="lg"] {
-            --dark-mode-toggle-size: 2.75rem;
-            --dark-mode-toggle-padding: 0.5rem;
-        }
-
-        &[data-size="control"] {
-            --dark-mode-toggle-size: var(--control-size, 2.25rem);
-            --dark-mode-toggle-padding: var(--control-icon-padding, 0.375rem);
-        }
-    }
-
-    .dark-mode-toggle-button[data-size="dock"],
-    .glass-dock
-        .dark-mode-toggle-button:not([data-size="sm"]):not([data-size="lg"]):not(
-            [data-size="control"]
-        ) {
-        --dark-mode-toggle-size: var(--dock-control-size, var(--size-icon-btn));
-        /* AY.W-DOCK-CHROME §2 — the in-dock toggle GLYPH insets to the nav-glyph
-           register. The toggle SVG carries `h-full w-full` (the utility layer, which
-           BEATS the component-layer `> svg { width: --dock-control-glyph-size }` rule
-           below), so the glyph fills whatever the PADDED box leaves. Prior the in-dock
-           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-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-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
-           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-control-glyph-size, var(--dock-icon-glyph, 1.25rem))
-                ) / 2
-        );
-    }
-
-    /* AX.W06 USF-2 — the dock-control optical-size contract. The
-       DarkModeToggle renders its OWN internal SVG `h-full w-full` (it bypasses
-       the `--dock-icon-glyph`-sized `> svg` slot the `.dock-icon-button` family
-       uses), so IN-DOCK it filled the whole control box edge-to-edge (~2.5× the
-       nav glyphs) — `--dock-icon-padding` is NEVER DEFINED, so the
-       `--dark-mode-toggle-padding: var(--dock-icon-padding, 0)` above fell to the
-       `0` fallback and zero padding let the SVG fill the box. Route the in-dock
-       toggle glyph through `--dock-control-glyph-size` (the ONE size the whole
-       dock-control family reads, default = `--dock-icon-glyph`, the same
-       `--dock-scale`-keyed glyph the nav icons paint), so the toggle is optically
-       UNIFORM with the nav glyphs WHEN DOCKED. The `h-full w-full` SVG stays
-       correct for the STANDALONE DarkModeToggle sizes (no `.glass-dock`
-       ancestor); this rule is scoped to the in-dock path only. Machine-checked by
-       the dock-control optical-parity gate, not eyeballed. */
-    .glass-dock
-        .dark-mode-toggle-button:not([data-size="sm"]):not([data-size="lg"]):not(
-            [data-size="control"]
-        )
-        > svg {
-        width: var(--dock-control-glyph-size, var(--dock-icon-glyph, 1.25rem));
-        height: var(--dock-control-glyph-size, var(--dock-icon-glyph, 1.25rem));
-    }
-}