@mkbabb/glass-ui 3.9.0 → 3.10.1

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mkbabb/glass-ui",
-    "version": "3.9.0",
+    "version": "3.10.1",
     "description": "Glassmorphic design system — Vue 3.5 components, reka-ui primitives, Tailwind CSS v4 tokens",
     "license": "MIT",
     "repository": {
@@ -58,6 +58,9 @@
             "fourier-field": [
                 "dist/fourier-field.d.ts"
             ],
+            "fourier-math": [
+                "dist/fourier-math.d.ts"
+            ],
             "goo-blob": [
                 "dist/goo-blob.d.ts"
             ],
@@ -76,9 +79,6 @@
             "status-dot": [
                 "dist/status-dot.d.ts"
             ],
-            "deck-progress": [
-                "dist/deck-progress.d.ts"
-            ],
             "pulse": [
                 "dist/pulse.d.ts"
             ],
@@ -88,9 +88,6 @@
             "toggle-chip": [
                 "dist/toggle-chip.d.ts"
             ],
-            "glass-panel": [
-                "dist/glass-panel.d.ts"
-            ],
             "sortable-list": [
                 "dist/sortable-list.d.ts"
             ],
@@ -109,24 +106,21 @@
             "instrument-chassis": [
                 "dist/instrument-chassis.d.ts"
             ],
-            "instrument-rail": [
-                "dist/instrument-rail.d.ts"
-            ],
             "hover-popover": [
                 "dist/hover-popover.d.ts"
             ],
             "configurator": [
                 "dist/configurator.d.ts"
             ],
-            "header-ribbon": [
-                "dist/header-ribbon.d.ts"
-            ],
             "constellation": [
                 "dist/constellation.d.ts"
             ],
             "scrolling-text": [
                 "dist/scrolling-text.d.ts"
             ],
+            "underline": [
+                "dist/underline.d.ts"
+            ],
             "forms": [
                 "dist/forms.d.ts"
             ],
@@ -151,6 +145,9 @@
             "motion-core": [
                 "dist/motion-core.d.ts"
             ],
+            "motion-curves": [
+                "dist/motion-curves.d.ts"
+            ],
             "button": [
                 "dist/button.d.ts"
             ],
@@ -297,6 +294,10 @@
             "types": "./dist/fourier-field.d.ts",
             "import": "./dist/fourier-field.js"
         },
+        "./fourier-math": {
+            "types": "./dist/fourier-math.d.ts",
+            "import": "./dist/fourier-math.js"
+        },
         "./goo-blob": {
             "types": "./dist/goo-blob.d.ts",
             "import": "./dist/goo-blob.js"
@@ -309,10 +310,6 @@
             "types": "./dist/configurator.d.ts",
             "import": "./dist/configurator.js"
         },
-        "./header-ribbon": {
-            "types": "./dist/header-ribbon.d.ts",
-            "import": "./dist/header-ribbon.js"
-        },
         "./constellation": {
             "types": "./dist/constellation.d.ts",
             "import": "./dist/constellation.js"
@@ -337,10 +334,6 @@
             "types": "./dist/status-dot.d.ts",
             "import": "./dist/status-dot.js"
         },
-        "./deck-progress": {
-            "types": "./dist/deck-progress.d.ts",
-            "import": "./dist/deck-progress.js"
-        },
         "./pulse": {
             "types": "./dist/pulse.d.ts",
             "import": "./dist/pulse.js"
@@ -353,10 +346,6 @@
             "types": "./dist/toggle-chip.d.ts",
             "import": "./dist/toggle-chip.js"
         },
-        "./glass-panel": {
-            "types": "./dist/glass-panel.d.ts",
-            "import": "./dist/glass-panel.js"
-        },
         "./sortable-list": {
             "types": "./dist/sortable-list.d.ts",
             "import": "./dist/sortable-list.js"
@@ -381,10 +370,6 @@
             "types": "./dist/instrument-chassis.d.ts",
             "import": "./dist/instrument-chassis.js"
         },
-        "./instrument-rail": {
-            "types": "./dist/instrument-rail.d.ts",
-            "import": "./dist/instrument-rail.js"
-        },
         "./hover-popover": {
             "types": "./dist/hover-popover.d.ts",
             "import": "./dist/hover-popover.js"
@@ -393,6 +378,10 @@
             "types": "./dist/scrolling-text.d.ts",
             "import": "./dist/scrolling-text.js"
         },
+        "./underline": {
+            "types": "./dist/underline.d.ts",
+            "import": "./dist/underline.js"
+        },
         "./forms": {
             "types": "./dist/forms.d.ts",
             "import": "./dist/forms.js"
@@ -421,6 +410,10 @@
             "types": "./dist/motion-core.d.ts",
             "import": "./dist/motion-core.js"
         },
+        "./motion-curves": {
+            "types": "./dist/motion-curves.d.ts",
+            "import": "./dist/motion-curves.js"
+        },
         "./button": {
             "types": "./dist/button.d.ts",
             "import": "./dist/button.js"
@@ -554,6 +547,9 @@
         "proof:phantom-classes": "node scripts/proof-phantom-classes.mjs",
         "proof:vt-names": "node scripts/proof-vt-names.mjs",
         "proof:dock-animation-live": "node scripts/proof-dock-animation-live.mjs",
+        "proof:dock-rail-cohesion": "node scripts/proof-dock-rail-cohesion.mjs",
+        "proof:dock-lockstep-bornred": "node scripts/proof-dock-lockstep-bornred.mjs",
+        "proof:dock-items-lag-capture": "node scripts/proof-dock-items-lag-capture.mjs",
         "proof:dock-orchestrator-single": "node scripts/proof-dock-orchestrator-single.mjs",
         "proof:dock-clip-reveal": "node scripts/proof-dock-clip-reveal.mjs",
         "proof:dock-layering-polish": "node scripts/proof-dock-layering-polish.mjs",
@@ -568,6 +564,7 @@
         "proof:dock-css-carve": "node scripts/proof-dock-css-carve.mjs",
         "proof:dock-css-split": "node scripts/proof-dock-controls-split.mjs",
         "proof:design-idiom-localization": "node scripts/proof-design-idiom-localization.mjs",
+        "proof:colocation": "node scripts/proof-colocation.mjs",
         "proof:tailwind-v4-idiom": "node scripts/proof-tailwind-v4-idiom.mjs",
         "proof:au-w9-consumers": "node scripts/proof-au-w9-consumers.mjs",
         "proof:shadow-contract": "node scripts/proof-shadow-contract.mjs",
@@ -575,8 +572,10 @@
         "proof:card-cartoon-consumers": "node scripts/proof-card-cartoon-consumers.mjs",
         "proof:doc-consistency": "node scripts/proof-doc-consistency.mjs",
         "proof:au-w0-reground": "node scripts/proof-au-w0-reground.mjs",
+        "proof:ay-w0-reground": "node scripts/proof-ay-w0-reground.mjs",
         "proof:au-w1-design": "node scripts/proof-au-w1-design.mjs",
         "proof:au-final": "node scripts/proof-au-final.mjs",
+        "proof:ay-final": "node scripts/proof-ay-final.mjs",
         "proof:strict-templates": "node scripts/proof-strict-templates.mjs",
         "proof:peer-optional": "node scripts/proof-peer-optional.mjs",
         "proof:vueuse-free-root": "node scripts/proof-vueuse-free-root.mjs",
@@ -598,7 +597,7 @@
         "proof:blob-value-free": "node scripts/proof-blob-value-free.mjs",
         "proof:motion-composables-consumer": "node scripts/proof-motion-composables-consumer.mjs",
         "proof:motion-value-free": "node scripts/proof-motion-value-free.mjs",
-        "proof:no-value-default": "node scripts/proof-no-value-default.mjs",
+        "proof:motion-suite": "node scripts/proof-motion-suite.mjs",
         "proof:blob-space-gamma": "node scripts/proof-blob-space-gamma.mjs",
         "proof:blob-smin-normalized": "node scripts/proof-blob-smin-normalized.mjs",
         "proof:blob-gradient-unit-length": "node scripts/proof-blob-gradient-unit-length.mjs",
@@ -616,18 +615,22 @@
         "proof:aurora-oilpastel-medium": "node scripts/proof-aurora-oilpastel-medium.mjs",
         "proof:aurora-stroke-composite": "node scripts/proof-aurora-stroke-composite.mjs",
         "proof:aurora-painterly-statistics": "node scripts/proof-aurora-painterly-statistics.mjs",
+        "proof:aurora-arresting-ref": "node scripts/aurora-arresting-metric.mjs tests-visual/fixtures/starry-night-crop.png",
         "proof:aurora-atoms-roundtrip": "node scripts/proof-aurora-atoms-roundtrip.mjs",
-        "proof:aurora-wgsl-equivalence": "node scripts/proof-aurora-wgsl-equivalence.mjs",
-        "proof:aurora-noise-hash-equivalence": "node scripts/proof-aurora-noise-hash-equivalence.mjs",
-        "proof:aurora-backend-fallback": "node scripts/proof-aurora-backend-fallback.mjs",
-        "proof:webgpu-substrate-single": "node scripts/proof-webgpu-substrate-single.mjs",
-        "proof:aurora-webgpu-render": "node scripts/proof-aurora-webgpu-render.mjs",
+        "proof:aur2-residue": "node scripts/proof-aur2-residue.mjs",
+        "proof:aurora-arresting": "node scripts/proof-aurora-arresting.mjs",
+        "proof:aurora-atoms-render": "node scripts/proof-aurora-atoms-render.mjs",
+        "proof:aurora-studio": "node scripts/proof-aurora-studio.mjs",
         "proof:aurora-interaction-prm": "node scripts/proof-aurora-interaction-prm.mjs",
         "proof:shader-shared-source": "node scripts/proof-shader-shared-source.mjs",
         "proof:blob-color-equivalence": "vitest run tests/components/custom/goo-blob/blob-color-equivalence.test.ts",
         "proof:fail-explicit": "node scripts/proof-fail-explicit.mjs",
         "proof:no-god-module": "node scripts/proof-no-god-module.mjs",
+        "proof:composable-return-types": "node scripts/proof-composable-return-types.mjs",
         "proof:no-legacy-commentary": "node scripts/proof-no-legacy-commentary.mjs",
+        "proof:no-retired-survivor": "node scripts/proof-no-retired-survivor.mjs",
+        "proof:tag-parity": "node scripts/proof-tag-parity.mjs",
+        "proof:var-in-arbitrary-guard": "node scripts/proof-var-in-arbitrary-guard.mjs",
         "proof:story-language": "node scripts/proof-story-language.mjs",
         "proof:gate-detrap": "node scripts/proof-gate-detrap.mjs",
         "proof:liquid-glass-tokens": "node scripts/proof-liquid-glass-tokens.mjs",
@@ -640,6 +643,11 @@
         "proof:constellation-substrate-single": "node scripts/proof-constellation-substrate-single.mjs",
         "proof:constellation-tokens": "node scripts/proof-constellation-tokens.mjs",
         "proof:constellation-warp-live": "node scripts/proof-constellation-warp-live.mjs",
+        "proof:constellation-egg-live": "node scripts/proof-constellation-egg-live.mjs",
+        "proof:constellation-freeze-live": "node scripts/proof-constellation-freeze-live.mjs",
+        "proof:fourier-field-intensity": "node scripts/proof-fourier-field-intensity.mjs",
+        "proof:fourier-field-visibility-live": "node scripts/proof-fourier-field-visibility-live.mjs",
+        "proof:constellation-refit-live": "node scripts/proof-constellation-refit-live.mjs",
         "proof:canvas2d-substrate": "vitest run tests/composables/glass/canvas2d/useCanvas2D.test.ts",
         "proof:resolve-canvas-color": "vitest run tests/composables/glass/canvas2d/resolveCanvasColor.test.ts",
         "proof:text-highlight": "vitest run tests/composables/motion/text-highlight-home.test.ts tests/composables/motion/useTextHighlight.test.ts",
@@ -656,13 +664,26 @@
         "proof:aurora-chrome-idiomatic": "node scripts/proof-aurora-chrome-idiomatic.mjs",
         "proof:aurora-preset-roster": "node scripts/proof-aurora-preset-roster.mjs",
         "proof:ui-scale": "node scripts/proof-ui-scale.mjs",
+        "proof:touch-target": "node scripts/proof-touch-target.mjs",
+        "proof:webkit-backdrop": "node scripts/proof-webkit-backdrop.mjs",
+        "proof:nested-backdrop-budget": "node scripts/proof-nested-backdrop-budget.mjs",
         "proof:dropdown-type-scale": "node scripts/proof-dropdown-type-scale.mjs",
         "proof:forced-colors-skin": "node scripts/proof-forced-colors-skin.mjs",
-        "proof:glass-one-model": "node scripts/proof-glass-level.mjs --one-model",
+        "proof:glass-cohesion": "node scripts/proof-glass-cohesion.mjs",
+        "proof:substrate-cohesion": "node scripts/proof-substrate-cohesion.mjs",
+        "proof:component-orphan": "node scripts/proof-component-orphan.mjs",
+        "proof:substrate-staging": "node scripts/proof-substrate-staging.mjs",
+        "proof:easter-eggs": "node scripts/proof-easter-eggs.mjs",
+        "proof:instrument-scope": "node scripts/proof-instrument-scope.mjs",
+        "proof:readme-meta-clean": "node scripts/proof-readme-meta-clean.mjs",
+        "proof:convergence-fit-coherent": "node scripts/proof-convergence-fit-coherent.mjs",
         "proof:adaptive-glass": "node scripts/proof-adaptive-glass.mjs",
         "proof:dark-semantic-contrast": "node scripts/proof-dark-semantic-contrast.mjs",
         "proof:glass-material-demo": "node scripts/proof-glass-material-demo.mjs",
         "proof:blob-live-truth": "node scripts/proof-blob-live-truth.mjs",
+        "proof:blob-config-atoms": "node scripts/proof-blob-config-atoms.mjs",
+        "proof:blob3-strip": "node scripts/proof-blob3-strip.mjs",
+        "proof:blob-config": "node scripts/proof-blob-config.mjs",
         "proof:tabs-unified": "node scripts/proof-tabs-unified.mjs",
         "proof:glass-material-sota": "node scripts/proof-glass-material-sota.mjs",
         "proof:primitive-affordance": "node scripts/proof-primitive-affordance.mjs",
@@ -673,10 +694,13 @@
         "proof:substrate-paints-color": "node scripts/proof-substrate-paints-color.mjs",
         "proof:deck-progress-rail": "node scripts/proof-deck-progress-rail.mjs",
         "proof:blob-render": "node scripts/proof-blob-render.mjs",
+        "proof:blob-warm-default": "node scripts/proof-blob-warm-default.mjs",
         "proof:blob-integration": "node scripts/proof-blob-integration.mjs",
         "proof:gate-script-parity": "node scripts/proof-gate-script-parity.mjs",
         "proof:all": "node scripts/gates.mjs --run local",
-        "proof:live-verified-ledger": "node scripts/proof-live-verified-ledger.mjs",
+        "proof:live-verified-ledger": "node scripts/proof-live-verified-ledger.mjs --tranche=AY",
+        "proof:live-verified-ledger:ay": "node scripts/proof-live-verified-ledger.mjs --tranche=AY",
+        "proof:live-verified-ledger:ax": "node scripts/proof-live-verified-ledger.mjs --tranche=AX",
         "proof:disposition-live": "node scripts/proof-disposition-live.mjs",
         "proof:gen-ci-fresh": "node scripts/proof-gen-ci-fresh.mjs",
         "gates:verify-ci": "node scripts/gates.mjs --verify-ci",
@@ -724,7 +748,7 @@
     },
     "devDependencies": {
         "@lucide/vue": "^1.16.0",
-        "@mkbabb/keyframes.js": "^2.2.0",
+        "@mkbabb/keyframes.js": "^4.1.0",
         "@mkbabb/value.js": "^0.10.0",
         "@tailwindcss/postcss": "^4.3.0",
         "@tailwindcss/vite": "^4.3.0",

package/src/styles/cards.css

@@ -38,8 +38,8 @@
        mints the stacking context once. Longhand maps `translate(x, y)` 1:1. */
     translate: 0;
     transition:
-        translate var(--duration-normal) var(--spring-bouncy),
-        box-shadow var(--duration-normal) var(--ease-apple);
+        translate var(--duration-normal) var(--spring-smooth),
+        box-shadow var(--duration-normal) var(--ease-standard);
 
     &:hover:not(:disabled) {
         translate: var(--lift-sm) var(--lift-sm);

package/src/styles/dock/layer-group.css

@@ -98,6 +98,22 @@
         display: flex;
         flex-direction: column;
         flex-shrink: 0;
+        /* AY.W-DOCK-NAV B6 — `align-self: start` (not the group's `stretch`
+           default) so the column rail reports its OWN intrinsic content height
+           (the stacked tabs) to the group's cross-axis sizing rather than being
+           stretched to the group's content-row height. Under `stretch` the rail's
+           height resolved to the group height, which was the single content-row
+           height — circular: the rail's 3 tall tabs overflowed a 40px rail and the
+           lower tabs + the indicator fell below the dock floor (the B6 break). With
+           `align-self: start` the rail demands its natural column height, the group
+           grows to it, and the dock grows to contain the whole rail. The
+           `min-height: max-content` belt makes the demand explicit — a row-flex
+           child's cross-size can otherwise resolve to the (smaller) container row
+           height even under `align-self: start`; `max-content` floors the rail at
+           its stacked-tab content height so the chain (group → pane → dock) grows
+           to fit. */
+        align-self: start;
+        min-height: max-content;
         gap: var(--dock-layer-rail-gap, 0.125rem);
         padding: var(--dock-layer-rail-padding, 0.125rem);
         background: var(--dock-layer-rail-bg, var(--surface-tint-8));
@@ -134,6 +150,12 @@
         display: inline-flex;
         align-items: center;
         justify-content: center;
+        /* AY.W-DOCK-NAV B6 — `flex-shrink: 0` so the stacked tabs in the column rail
+           hold their full size and the rail demands its natural content height (no
+           tab squish). With the rail's `align-self: start` this makes the rail report
+           its true column height to the group's cross-axis sizing, growing the dock
+           to contain all the tabs + the travelling indicator (the B6 un-clip). */
+        flex-shrink: 0;
         width: var(--dock-layer-tab-size, var(--dock-control-size, 1.75rem));
         height: var(--dock-layer-tab-size, var(--dock-control-size, 1.75rem));
         border: 0;
@@ -183,7 +205,19 @@
        it at the top tab and it NEVER reached the active tab below (the mis-alignment
        the user screenshotted). The default rule below travels Y; the `.vertical`
        group's ROW rail overrides back to X. The active-tab plate reads the tunable
-       `--dock-layer-rail-active` rung. Both morph on `--dock-motion-resize`. */
+       `--dock-layer-rail-active` rung.
+
+       AY.W-DOCK2 (D5 one-clock) — the rail indicator travel moves OFF the fixed-
+       linear `--dock-motion-resize` SECOND clock (DK7 killed exactly this pattern
+       for the leaving-pane opacity but left it alive on the rail; H-dock §D7 L2) onto
+       the `--spring-snappy` register. DECISION: a rail tab switch is a DISCRETE
+       selection (the user picks a pane), NOT the box collapse↔expand morph — so it
+       does NOT fold onto `--dock-morph-t` (the morph scalar). It uses the iOS
+       segmented-control register (`--spring-snappy`, the SAME curve `SegmentedTabs`'
+       indicator rides — the confirmed discrete-selection register), so the rail
+       indicator glides between tabs on the house spring, never a fixed-linear timer.
+       The binding outcome: NO `--dock-motion-resize` survives on the rail (recorded
+       in W-DOCK2-DELTA.md). */
     .dock-layer-rail .dock-layer-tab-indicator {
         position: absolute;
         left: 0;
@@ -197,9 +231,9 @@
             color-mix(in srgb, var(--primary) 15%, transparent)
         );
         transition:
-            width var(--dock-motion-resize),
-            height var(--dock-motion-resize),
-            transform var(--dock-motion-resize);
+            width var(--duration-fast) var(--spring-snappy),
+            height var(--duration-fast) var(--spring-snappy),
+            transform var(--duration-fast) var(--spring-snappy);
         pointer-events: none;
     }
 

package/src/styles/dock/layers.css

@@ -196,9 +196,19 @@
        block-axis morph reveals a column) is NOT forced onto one nowrap row — the
        vertical group's active host block-sizes to `height: max-content` below
        (the AP.W3 column treatment, KEPT). */
+    /* AY.W-DOCK-NAV B6 — the height is a FLOOR (`min-height`), not a fixed lock. A
+       single-row content pane's intrinsic height already equals
+       `--dock-layer-height` (the controls + line-height sum to it), so `min-height`
+       is byte-identical for the common case. But a horizontal dock hosting a COLUMN
+       switcher-rail (`<DockLayerGroup>` with `show-rail`) lays the rail out as a
+       stack of tabs taller than one row — the prior fixed `height` clipped the
+       rail's lower tabs + the active indicator BELOW the dock floor (the B6 "no rail
+       line / broken" read, measured: 2 of 3 tabs clipped). The floor lets the pane
+       block-size to the rail's natural column height so the dock grows to contain
+       the whole rail. The cross axis keeps `nowrap`. */
     .glass-dock:not(.vertical) .dock-layer {
         white-space: nowrap;
-        height: var(--dock-layer-height, 2.5rem);
+        min-height: var(--dock-layer-height, 2.5rem);
     }
 
     .dock-layer.is-active {

package/src/styles/dock/morph.css

@@ -61,9 +61,22 @@
        authority, and at rest `--dock-expand-t` resolves to the class endpoint (0
        collapsed / 1 expanded) so the resting look is exact. */
     .glass-dock.variant-dock:not(.vertical) {
+        /* AY.W-A11Y-PERF O-1 — the resting-endpoint dock bg composes the W55 oklab
+           adaptive tint so the bright bucket (engaged when a consumer/page marks
+           `--glass-backdrop: light` on the dock's ancestor — the @container block
+           below + the page-redesign W60 wiring) reaches the LIVE `.variant-dock`
+           surface (this 0,3,0 morph interp OVERRIDES the 0,1,0 shell.css bg, so the
+           tint must be applied HERE too). The srgb transition mix is preserved between
+           the two color endpoints; the adaptive darken rides the resting endpoint
+           (`--glass-bg-dock` wrapped in the oklab tint) — at the `0%` rest default the
+           inner oklab mix is a no-op so this is byte-identical to today. */
         background: color-mix(
             in srgb,
-            var(--glass-bg-dock, var(--glass-bg-resting))
+            color-mix(
+                in oklab,
+                var(--glass-bg-dock, var(--glass-bg-resting)),
+                var(--glass-tint-source) var(--glass-tint-strength)
+            )
                 calc(var(--dock-expand-t, 1) * 100%),
             var(--glass-bg-wash)
         );
@@ -78,18 +91,40 @@
     /* The padding morph is split out + scoped `:not(.dock-overflow-wrap)` so the
        wrap variant's own padding rules (W04 territory — `.dock-overflow-wrap` +
        its `@media` snap-back) are NOT clobbered by this higher-specificity longhand.
-       Padding interpolates linearly between the collapsed floor and the expanded
-       block/inline padding on the same `--dock-expand-t` scalar. */
+
+       AY.W-DOCK-CHROME §1 — the LAYOUT-ISOLATION fix: the collapse↔expand morph is
+       an INLINE-WIDTH aperture by contract ("horizontal docks animate width"), so
+       the BLOCK axis MUST be invariant across the morph — otherwise the dock's
+       outer height shrinks ~4px on collapse (the collapsed-pad 0.25rem vs the
+       expanded pad-block 0.375rem, ×2) and, because a free-floating / inline dock
+       sits in normal flow (`display:inline-flex`), that height delta REFLOWS its
+       siblings — the page content jumped as the dock animated (the user's 13:27
+       audit item 1). The fix holds `padding-block` PINNED at the expanded value in
+       BOTH states (no `--dock-expand-t` interpolation on the block axis) so the
+       outer block-size is constant; ONLY `padding-inline` morphs to tighten the
+       collapsed pill inline. The collapsed circle is unaffected — its diameter is
+       owned by the summary pane's own symmetric `block-size` + `aspect-ratio:1`
+       (the `.collapsed .dock-layer--summary` rule below), CENTRED on the dock's
+       stable-height plate by the root `align-items:center`, not by the root pad. So
+       the morph reflows NOTHING vertically: 0px container-height delta. */
     .glass-dock.variant-dock:not(.vertical):not(.dock-overflow-wrap) {
-        --dock-pad-collapsed: var(
-            --dock-collapsed-padding,
-            var(--dock-padding-block, 0.375rem)
-        );
-        padding-block: calc(
-            var(--dock-pad-collapsed) +
-                (var(--dock-padding-block, 0.375rem) - var(--dock-pad-collapsed)) *
-                var(--dock-expand-t, 1)
+        /* The collapsed inline-pad endpoint is the EXPANDED block pad (max'd with the
+           consumer `--dock-collapsed-padding` handle) so the height-pinned collapsed
+           pill is SYMMETRIC → a clean circle at the `--radius-dock` 9999px. The block
+           axis is pinned to the expanded pad (below), so matching the inline collapsed
+           endpoint to it keeps the box square (the B4 "symmetric collapsed padding
+           keeps the pill a circle" intent, preserved through the §1 height-pin). The
+           `max()` lets a consumer set `--dock-collapsed-padding` LARGER for a looser
+           pill but never SMALLER than the block pad (which would re-introduce the
+           narrower-than-tall oval the height-pin would otherwise leave). */
+        --dock-pad-collapsed: max(
+            var(--dock-padding-block, 0.375rem),
+            var(--dock-collapsed-padding, 0px)
         );
+        /* block padding is INVARIANT — the expanded value, both states (the
+           layout-isolation contract above): the inline aperture morphs, the block
+           axis is pinned so the outer height never changes → 0px container reflow. */
+        padding-block: var(--dock-padding-block, 0.375rem);
         padding-inline: calc(
             var(--dock-pad-collapsed) +
                 (var(--dock-padding-inline, 0.5rem) - var(--dock-pad-collapsed)) *
@@ -110,14 +145,17 @@
         box-shadow: var(--shadow-dock-override, var(--shadow-dock-collapsed));
     }
 
-    /* AX.W45-TUNE Q1 — the collapsed summary floors on BOTH axes off the SAME
-       `--dock-collapsed-summary-min-size` token (now MINTED in tokens.css §10 as a
-       tight ≈0.7× of the full control height). The prior rule floored ONLY
-       `min-width` and let the token fall to `--dock-layer-height` (the full control
-       height) — so the collapsed pill read as a full-row stub, not a proportioned
-       squircle. Adding the symmetric `min-block-size` makes the collapsed pill a
-       tight square-ish dot the consumer's glyph sits centred in (the proportioned-
-       pill target the user's Q1 named). */
+
+    /* AY.W-DOCK-NAV B4 — the collapsed summary is a PERFECT CIRCLE. The `.dock-layer`
+       base rule (`.glass-dock:not(.vertical) .dock-layer`) locks `height:
+       var(--dock-layer-height)` (40px) on EVERY layer including the summary; against
+       the 0.85× `--dock-collapsed-summary-min-size` min-width that made the pane
+       40h × 30w — an oval (the user's "circle, not oval"). This rule (1) LIFTS the
+       height-lock so the summary block-sizes to the SAME token its width floors at,
+       and (2) floors both axes to that ONE token, so the collapsed pane is a square
+       and the root's symmetric collapsed padding keeps the pill a circle. The glyph
+       sits centred on both axes. The `aspect-ratio: 1` belt-and-braces guarantees
+       1:1 even if a consumer's collapsed-slot content is wider than the floor. */
     .glass-dock.collapsed .dock-layer--summary {
         min-width: var(
             --dock-collapsed-summary-min-size,
@@ -127,6 +165,15 @@
             --dock-collapsed-summary-min-size,
             var(--dock-layer-height, 2.5rem)
         );
+        block-size: var(
+            --dock-collapsed-summary-min-size,
+            var(--dock-layer-height, 2.5rem)
+        );
+        height: var(
+            --dock-collapsed-summary-min-size,
+            var(--dock-layer-height, 2.5rem)
+        );
+        aspect-ratio: 1;
         justify-content: center;
     }
 
@@ -146,6 +193,35 @@
         --dock-expand-t: var(--dock-morph-t);
     }
 
+    /* AY.W-DOCK-NAV B15 — the EMPTY-collapsed-summary trap. A dock with a
+       `#persistent` control but NO `#collapsed` slot (the overview first-section
+       dock) still renders a `.dock-layer--summary` pane that floors to the circle
+       min-width — so collapsed it read as a WIDE pill: the persistent Home glyph on
+       the LEFT + an empty circle of dead space on the RIGHT (the measured 84×50
+       oval). Expanding then grew the content INTO that right-side void, so the
+       morph read "from the right" not center-out (the user's B15). When the summary
+       slot is EMPTY (`:not(:has(*))`), collapse it to zero width + no floor so the
+       persistent control stands alone as the collapsed circle, and the morph grows
+       symmetrically about the persistent. An empty Vue `#collapsed` slot renders
+       ZERO child nodes (no whitespace text node either), so `:empty` matches it
+       exactly — and a flat `:empty` avoids the nested-`:has()` form Lightning CSS
+       drops. An authored `#collapsed` slot (non-empty summary) keeps its circle
+       pill. */
+    .glass-dock.collapsed .dock-layer--summary:empty {
+        min-width: 0;
+        inline-size: 0;
+        padding: 0;
+        margin: 0;
+        border: 0;
+    }
+
+    /* The persistent control IS the collapsed pill in the empty-summary case — drop
+       the inter-region gap so the collapsed circle is exactly the persistent box. */
+    .glass-dock.collapsed:has(.dock-layer--summary:empty) .dock-persistent
+        + .dock-layers {
+        margin-inline-start: 0;
+    }
+
     /* AW.W3 — the collapsed-hover scale rides the unified dock spring vocabulary.
        The `scale var(--dock-motion-resize)` arm was added to the `.glass-dock`
        root transition above, so this hover scale settles on the SAME spring curve

package/src/styles/dock/shell.css

@@ -64,6 +64,18 @@
            stacking-context guarantee). Covers every dock scale site. */
         scale: 1;
         position: relative;
+        /* AY.W-A11Y-PERF O-1 — engage the W55 bright-backdrop bucket BY DEFAULT on
+           the dock (the surface the user reported unreadable over light content). The
+           SELF-engage rule in dock/morph.css darkens the dock's OWN plate toward ink
+           unconditionally (a dock floats over arbitrary — frequently light — page
+           content). `dark` (the :root default) stays the inherited value a consumer
+           re-reads; the descendant/nested-glass reach uses the @container block. */
+        --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). */
+        contain: paint;
         display: inline-flex;
         align-items: center;
         /* AW.W1 — the dock does NOT establish a default inline-size container.

package/src/styles/dock-controls.css

@@ -24,23 +24,21 @@
        toward `--scale-press-dock` settles on a NO-OVERSHOOT spring (Apple,
        "Designing Fluid Interfaces": default 100% damping — no bounce — for a tap;
        reserve bounce for surfaces driven by gesture MOMENTUM). The dock controls
-       are tap surfaces (no momentum), so the press re-binds `--dock-press-spring`
-       from the bouncy preset (`--spring-bouncy`, ~+20% overshoot, defined in
-       tokens.css §-2) to `--spring-smooth` — the critically-damped (ζ≈1, ~0.4%
-       peak) iOS tap curve. Token-routed (an existing spring preset, never a raw
-       cubic-bezier); the `--duration-fast` prefix is kept so the squish-back stays
-       quick. Every dock-control `scale var(--dock-press-spring)` press transition
-       (and the select chevron's `rotate`) inherits this one binding. A future
-       momentum-gated surface (none today) would override this back to a bouncy
-       preset on its own scope. The `:where()` group keeps zero specificity so a
-       consumer override of `--dock-press-spring` still wins. */
+       are tap surfaces (no momentum).
+
+       AY.W-DOCK2 (D6) — the per-surface re-point of `--dock-press-spring` to
+       `--spring-smooth` is DELETED here: the ROOT token (`tokens.css`) IS the §6
+       doctrine register now (`--spring-smooth`), so the re-point was a dead
+       byte-identical redeclaration — the exact per-surface fork the §6 doctrine
+       claims to have killed. The dock controls inherit the correct smooth
+       transform-press register straight from the ROOT token; this `:where()` group
+       keeps ONLY the small-tile specular sizing below. */
     :where(
         .dock-icon-button,
         .dock-tab-button,
         .dock-select-trigger,
         .dock-dropdown-trigger
     ) {
-        --dock-press-spring: var(--duration-fast) var(--spring-smooth);
         /* AX.W45-TUNE C4/C5 — the small-tile specular sizing. The dock controls are
            ~40px tiles, a fraction of a card's plate, so the global 36% specular
            radius blooms a tile-filling disc (the I.W6 finding). The family re-points
@@ -227,7 +225,22 @@
             [data-size="control"]
         ) {
         --dark-mode-toggle-size: var(--dock-control-size, var(--size-icon-btn));
-        --dark-mode-toggle-padding: var(--dock-icon-padding, 0);
+        /* 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-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. */
+        --dark-mode-toggle-padding: calc(
+            (
+                    var(--dock-control-size, var(--size-icon-btn)) -
+                        var(--dock-icon-glyph, 1.25rem)
+                ) / 2
+        );
     }
 
     /* AX.W06 USF-2 — the dock-control optical-size contract. The