@mkbabb/glass-ui 3.7.0 → 3.8.0

package/dist/timeline.js

@@ -1,5 +1,5 @@
-import { t as e } from "./_plugin-vue_export-helper-gLzyemvl.js";
-import { t } from "./HoverPopover-DXpOEw1P.js";
+import { t as e } from "./_plugin-vue_export-helper-ok8pgSl5.js";
+import { t } from "./HoverPopover-D56O6Ylp.js";
 import { Fragment as n, computed as r, createBlock as i, createCommentVNode as a, createElementBlock as o, createElementVNode as s, createSlots as c, createVNode as l, defineComponent as u, guardReactiveProps as d, normalizeClass as f, normalizeProps as p, normalizeStyle as m, openBlock as h, ref as g, renderList as _, renderSlot as v, toDisplayString as y, unref as b, withCtx as x } from "vue";
 //#region src/components/custom/timeline/geometry.ts
 function S(e) {
@@ -197,7 +197,7 @@ var A = ["aria-label"], j = [
 			_: 2
 		}, 1032, ["class", "onUpdate:open"]))], 4))), 128))], 8, A)) : a("", !0);
 	}
-}), [["__scopeId", "data-v-8e53d036"]]), H = [
+}), [["__scopeId", "data-v-54dadfb5"]]), H = [
 	"aria-valuemax",
 	"aria-valuenow",
 	"aria-label"

package/dist/toast.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, i as n, n as r, o as i, r as a, s as o, t as s } from "./Toaster-BMaeziJJ.js";
+import { a as e, c as t, i as n, n as r, o as i, r as a, s as o, t as s } from "./Toaster-CabYEEF_.js";
 export { t as Toast, o as ToastAction, i as ToastClose, e as ToastDescription, n as ToastTitle, s as Toaster, r as toast, a as useToast };

package/dist/toggle-group.js

@@ -1,2 +1,2 @@
-import { n as e, t } from "./ToggleGroupItem-C-AIkBUw.js";
+import { n as e, t } from "./ToggleGroupItem-CkXUcBlt.js";
 export { e as ToggleGroup, t as ToggleGroupItem };

package/dist/tooltip.js

@@ -1,2 +1,2 @@
-import { i as e, n as t, r as n, t as r } from "./TooltipProvider-CD2IXfRv.js";
+import { i as e, n as t, r as n, t as r } from "./TooltipProvider-CmZzCuaG.js";
 export { e as Tooltip, n as TooltipContent, r as TooltipProvider, t as TooltipTrigger };

package/dist/typewriter.js

@@ -1,4 +1,4 @@
-import { t as e } from "./_plugin-vue_export-helper-gLzyemvl.js";
+import { t as e } from "./_plugin-vue_export-helper-ok8pgSl5.js";
 import { Fragment as t, computed as n, createCommentVNode as r, createElementBlock as i, createElementVNode as a, defineComponent as o, normalizeClass as s, onMounted as c, onUnmounted as l, openBlock as u, ref as d, renderList as f, toDisplayString as p, unref as m, watch as h } from "vue";
 //#region src/components/custom/typewriter/types.ts
 var g = {

package/dist/{useAnimatedNumber-C5I3wWd8.js → useAnimatedNumber-C_3wZLx4.js}

@@ -1,4 +1,4 @@
-import { n as e, t } from "./constants-CS75AWHG.js";
+import { n as e, t } from "./constants-BPOqYJAm.js";
 import { getCurrentScope as n, onScopeDispose as r, readonly as i, ref as a, shallowRef as o, toValue as s, watch as c } from "vue";
 import { SmoothProgress as l } from "@mkbabb/keyframes.js";
 //#region src/composables/motion/useAnimatedNumber.ts

package/dist/{useCanvas2D-C31yfUGY.js → useCanvas2D-ClrQuZtp.js}

@@ -91,5 +91,6 @@ function i(i) {
 		}
 	};
 }
+var a = i;
 //#endregion
-export { i as t };
+export { a as n, i as t };

package/dist/{useConfiguratorState-B24TcgIn.js → useConfiguratorState-CMff4GzH.js}

@@ -1,9 +1,9 @@
 import { t as e } from "./cn-DJXf4yaB.js";
 import { t } from "./createLucideIcon-B6uNAU9G.js";
 import { t as n } from "./chevron-down-BSkTP2aL.js";
-import { t as r } from "./_plugin-vue_export-helper-gLzyemvl.js";
-import { t as i } from "./createContext-CvNyBk4o.js";
-import { t as a } from "./Label-DBc7bKzZ.js";
+import { t as r } from "./_plugin-vue_export-helper-ok8pgSl5.js";
+import { t as i } from "./createContext-B44Sah_H.js";
+import { t as a } from "./Label-zRfbQdCn.js";
 import { Fragment as o, computed as s, createCommentVNode as c, createElementBlock as l, createElementVNode as u, createTextVNode as d, createVNode as f, defineComponent as p, mergeModels as m, normalizeClass as h, normalizeStyle as g, openBlock as _, reactive as v, ref as y, renderList as b, renderSlot as x, toDisplayString as S, toRaw as C, unref as w, useId as T, useModel as E, withCtx as D } from "vue";
 var O = t("rotate-ccw", [["path", {
 	d: "M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8",

package/dist/useResolveTokenColor-r9pnNjqK.js

@@ -0,0 +1,24 @@
+//#region src/composables/dom/useResolveTokenColor.ts
+function e(e, t) {
+	if (!e.includes("var(") || typeof window > "u" || !t) return e;
+	let n = t.style.color;
+	t.style.color = e;
+	let r = getComputedStyle(t).color;
+	return t.style.color = n, r || e;
+}
+function t(t = 256) {
+	let n = /* @__PURE__ */ new Map();
+	return {
+		resolve(r, i) {
+			let a = n.get(r);
+			if (a !== void 0) return a;
+			let o = e(r, i);
+			return n.size >= t && n.clear(), n.set(r, o), o;
+		},
+		invalidate() {
+			n.clear();
+		}
+	};
+}
+//#endregion
+export { e as n, t };

package/dist/useSpecularTracking-BVRZsRHA.js

@@ -0,0 +1,26 @@
+import { ref as e } from "vue";
+//#region src/composables/glass/useSpecularTracking.ts
+function t() {
+	return typeof window > "u" || typeof window.matchMedia != "function" ? !1 : window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+}
+function n() {
+	let n = e({});
+	function r(e) {
+		if (t()) return;
+		let r = e.currentTarget;
+		if (!r) return;
+		let i = r.getBoundingClientRect();
+		if (i.width === 0 || i.height === 0) return;
+		let a = (e.clientX - i.left) / i.width * 100, o = (e.clientY - i.top) / i.height * 100;
+		n.value = {
+			"--mouse-x": `${a.toFixed(2)}%`,
+			"--mouse-y": `${o.toFixed(2)}%`
+		};
+	}
+	return {
+		specularStyle: n,
+		onPointerMove: r
+	};
+}
+//#endregion
+export { n as t };

package/dist/{useTextHighlight-aMPdEpkq.js → useTextHighlight-9nMW23Qb.js}

@@ -1,5 +1,5 @@
 import { getCurrentScope as e, onScopeDispose as t } from "vue";
-//#region src/composables/dom/useTextHighlight.ts
+//#region src/composables/motion/useTextHighlight.ts
 var n = /* @__PURE__ */ new Map();
 function r() {
 	return typeof CSS < "u" && "highlights" in CSS && typeof globalThis.Highlight == "function";

package/dist/{useTouchGate-YQRwyUGU.js → useTouchGate-WFyJYsth.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./useTimer-DEJonOZa.js";
+import { t as e } from "./useTimer-3xqf_54b.js";
 import { getCurrentScope as t, onScopeDispose as n, ref as r } from "vue";
 //#region src/composables/dom/useTouchGate.ts
 var i = /* @__PURE__ */ new Set(), a = !1;

package/dist/vReveal-CqaCz_mC.js

@@ -0,0 +1,44 @@
+//#region src/utils/moveBefore.ts
+function e(e, t, n) {
+	let r = e;
+	typeof r.moveBefore == "function" ? r.moveBefore(t, n) : e.insertBefore(t, n);
+}
+function t() {
+	return typeof Element < "u" && "moveBefore" in Element.prototype;
+}
+//#endregion
+//#region src/utils/platformSupport.ts
+function n() {
+	return typeof globalThis.scheduler?.postTask == "function";
+}
+//#endregion
+//#region src/composables/motion/useViewTransition.ts
+function r() {
+	return typeof document < "u" && typeof document.startViewTransition == "function";
+}
+function i(e, t) {
+	let n = typeof document > "u" ? void 0 : document;
+	if (!n || typeof n.startViewTransition != "function") return e(), {
+		finished: Promise.resolve(),
+		transitioned: !1
+	};
+	let r = t?.types && t.types.length > 0 ? n.startViewTransition({
+		update: () => e(),
+		types: t.types
+	}) : n.startViewTransition(() => e());
+	return r.ready?.catch(() => {}), {
+		finished: r.finished.then(() => void 0, () => void 0),
+		transitioned: !0
+	};
+}
+//#endregion
+//#region src/composables/motion/vReveal.ts
+function a(e, t) {
+	e.setAttribute("data-reveal", t.arg === "fade" ? "fade" : ""), e.style.setProperty("--d", String(t.value ?? 0));
+}
+var o = {
+	mounted: a,
+	updated: a
+};
+//#endregion
+export { e as a, n as i, i as n, t as o, r, o as t };

package/dist/watercolor-dot.js

@@ -1,5 +1,5 @@
-import { t as e } from "./_plugin-vue_export-helper-gLzyemvl.js";
-import { n as t, t as n } from "./prng-wHuHlNHE.js";
+import { t as e } from "./_plugin-vue_export-helper-ok8pgSl5.js";
+import { n as t, t as n } from "./prng-COGhh02-.js";
 import { computed as r, createBlock as i, createElementVNode as a, defineComponent as o, normalizeClass as s, normalizeStyle as c, onUnmounted as l, openBlock as u, ref as d, renderSlot as f, resolveDynamicComponent as p, toRef as m, useId as h, watch as g, withCtx as _ } from "vue";
 //#region src/components/custom/watercolor-dot/prng.ts
 function v(e, t, n) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mkbabb/glass-ui",
-    "version": "3.7.0",
+    "version": "3.8.0",
     "description": "Glassmorphic design system — Vue 3.5 components, reka-ui primitives, Tailwind CSS v4 tokens",
     "license": "MIT",
     "repository": {
@@ -10,6 +10,9 @@
     "homepage": "https://github.com/mkbabb/glass-ui#readme",
     "bugs": "https://github.com/mkbabb/glass-ui/issues",
     "type": "module",
+    "workspaces": [
+        "tests-visual"
+    ],
     "types": "./dist/index.d.ts",
     "typesVersions": {
         "*": {
@@ -49,6 +52,9 @@
             "aurora": [
                 "dist/aurora.d.ts"
             ],
+            "canvas": [
+                "dist/canvas.d.ts"
+            ],
             "color": [
                 "dist/color.d.ts"
             ],
@@ -73,6 +79,9 @@
             "status-dot": [
                 "dist/status-dot.d.ts"
             ],
+            "deck-progress": [
+                "dist/deck-progress.d.ts"
+            ],
             "pulse": [
                 "dist/pulse.d.ts"
             ],
@@ -292,6 +301,10 @@
             "types": "./dist/aurora.d.ts",
             "import": "./dist/aurora.js"
         },
+        "./canvas": {
+            "types": "./dist/canvas.d.ts",
+            "import": "./dist/canvas.js"
+        },
         "./color": {
             "types": "./dist/color.d.ts",
             "import": "./dist/color.js"
@@ -344,6 +357,10 @@
             "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"
@@ -564,10 +581,11 @@
         "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-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",
-        "proof:dock-motion-parity": "node scripts/proof-dock-motion-parity.mjs",
-        "proof:dock-motion-single-source": "node scripts/proof-dock-motion-single-source.mjs",
+        "proof:dock-wrap-content-driven": "node scripts/proof-dock-wrap-content-driven.mjs",
+        "proof:dock-hold-contract": "node scripts/proof-dock-hold-contract.mjs",
         "proof:dock-opacity-lockstep": "node scripts/proof-dock-opacity-lockstep.mjs",
         "proof:dock-a11y-contract": "vitest run tests/components/custom/dock/DockLayerRail.a11y.test.ts",
         "proof:dock-vocabulary": "node scripts/proof-dock-vocabulary.mjs",
@@ -585,17 +603,18 @@
         "proof:peer-optional": "node scripts/proof-peer-optional.mjs",
         "proof:vueuse-free-root": "node scripts/proof-vueuse-free-root.mjs",
         "proof:supportsPostTask-wired": "node scripts/proof-supports-post-task-wired.mjs",
-        "proof:font-axes": "node scripts/proof-font-axes.mjs",
         "proof:color-acyclic": "node scripts/proof-color-acyclic.mjs",
         "proof:single-color-core": "node scripts/proof-single-color-core.mjs",
         "proof:frostShader-deleted": "node scripts/proof-frostshader-deleted.mjs",
         "proof:slider-two-only": "node scripts/proof-slider-two-only.mjs",
+        "proof:carousel-glass-atoms": "node scripts/proof-carousel-glass-atoms.mjs",
         "proof:storybook-ia": "node scripts/proof-storybook-ia.mjs",
         "proof:storybook-complete": "node scripts/proof-storybook-complete.mjs",
         "proof:no-orphan-demo-route": "node scripts/proof-no-orphan-demo-route.mjs",
         "proof:demo-dock-nav": "node scripts/proof-demo-dock-nav.mjs",
         "proof:demo-dock-nav-runtime": "node scripts/proof-demo-dock-nav-runtime.mjs",
         "proof:font-canon": "node scripts/proof-font-canon.mjs",
+        "proof:font-cascade-live": "node scripts/proof-font-cascade-live.mjs",
         "proof:webgl-substrate-single": "node scripts/proof-webgl-substrate-single.mjs",
         "proof:blob-value-free": "node scripts/proof-blob-value-free.mjs",
         "proof:motion-composables-consumer": "node scripts/proof-motion-composables-consumer.mjs",
@@ -615,10 +634,14 @@
         "proof:aurora-impasto-relight": "node scripts/proof-aurora-impasto-relight.mjs",
         "proof:aurora-vangogh-preset": "node scripts/proof-aurora-vangogh-preset.mjs",
         "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-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: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",
@@ -633,7 +656,11 @@
         "proof:spring-tokens-synced": "node scripts/proof-spring-tokens-synced.mjs",
         "proof:offscreen-pause": "node scripts/proof-offscreen-pause.mjs",
         "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: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",
         "proof:constellation-field": "vitest run tests/components/custom/constellation/constellationField.test.ts",
         "proof:input-invalid-aria": "node scripts/proof-input-invalid-aria.mjs",
         "proof:styling-hygiene": "node scripts/proof-styling-hygiene.mjs",
@@ -648,6 +675,11 @@
         "proof:animation-coherence": "node scripts/proof-animation-coherence.mjs",
         "proof:design-md-current": "node scripts/proof-design-md-current.mjs",
         "proof:naming-consistency": "node scripts/proof-naming-consistency.mjs",
+        "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-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",
         "gates:verify-ci": "node scripts/gates.mjs --verify-ci",
         "profile:bundle": "node scripts/profile-bundle.mjs",

package/src/fonts/README.md

@@ -1,9 +1,17 @@
 # `src/fonts/` — self-hostable woff2 assets
 
-Per O.W6 Lane D / speedtest AC.W6 cohort (T_GU-FONT-A): glass-ui ships
-Fira Code (and forthcoming display/text companions) as woff2 assets so
-consumers can self-host via a single `@font-face` block rather than
-re-fetching from Google Fonts on every page-load.
+glass-ui ships its brand register as self-hosted woff2 assets so consumers
+can self-host via the `@mkbabb/glass-ui/styles/fonts` bundle rather than
+re-fetching from a CDN on every page-load. The register is ONE coherent
+brand voice:
+
+- **Plus Jakarta Sans** — the text + display register (body, headings,
+  prose, display). The library DEFAULT family; every live surface paints it.
+- **Fira Code** — the mono register (admin labels, tabular numerics, code).
+
+Both are OFL-1.1 variable faces, each paired with a Capsize-calibrated
+`"… Fallback"` face (declared in `typography.css`) so the swap window is
+geometry-neutral (zero CLS).
 
 ## Canonical filenames (Fira Code)
 
@@ -21,26 +29,26 @@ woff2 builds live in `distr/woff2/` of that repository's releases — pull
 the `Regular`/`Medium`/`SemiBold` weights only (the three glass-ui ships
 as the `--font-mono` stack rungs).
 
-## Fraunces (display, AU.W4)
+## On-disk layout (the shipped register)
 
 The actual on-disk layout is per-family nested
-(`src/fonts/<family>/<face>.woff2`), e.g.
-`src/fonts/plus-jakarta-sans/plus-jakarta-sans-latin.woff2`. AU.W4 ships the
-display register's face — the `--font-stack-display: "Fraunces"` token
-(`tokens.css`) had no face, so the `WONK`/`SOFT` axes `typography.css` drives were
-silently inert. The shipped face is the FULL variable Fraunces (latin subset):
+(`src/fonts/<family>/<face>.woff2`):
 
 ```
-src/fonts/fraunces/fraunces-latin.woff2
+src/fonts/plus-jakarta-sans/plus-jakarta-sans-latin.woff2
+src/fonts/plus-jakarta-sans/plus-jakarta-sans-latin-ext.woff2
+src/fonts/fira-code/fira-code-latin.woff2
+src/fonts/fira-code/fira-code-latin-ext.woff2
 ```
 
-It carries the `wght` · `opsz` · `SOFT` · `WONK` axes (verified by
-`proof:font-axes`, which parses the woff2 `fvar` against the axes
-`typography.css` references). Source canonical:
-<https://github.com/googlefonts/fraunces> (OFL-1.1); the variable woff2 latin
-subset is the Google Fonts / fontsource distribution. `proof:font-axes` fails
-closed if a wght-only instance (one that drops `SOFT`/`WONK`) is ever
-substituted.
+Plus Jakarta Sans is the text + display register (`--font-stack-text`,
+aliased by `--font-stack-display`); Fira Code is `--font-stack-mono`. Each is
+a FULL variable face (latin + latin-ext subsets). Source canonical:
+<https://github.com/tokotype/PlusJakartaSans> +
+<https://github.com/tonsky/FiraCode> (both OFL-1.1); the variable woff2 latin
+subsets are the Google Fonts / fontsource distributions. The Capsize metric
+overrides on the fallback faces (`size-adjust` / `ascent-override` /
+`descent-override`) reference these binaries' exact geometry.
 
 ## Why this directory ships, not the fetch step
 

package/src/styles/dock-controls.css

@@ -75,16 +75,26 @@
                (transform-scoped only; the surface fades stay on the flat ease). */
                 scale var(--dock-press-spring),
             opacity var(--dock-motion-fast),
-            /* AT.W7-dock-b — the glass specular highlight fades in on hover. */
+            /* The box-shadow fade now carries ONLY the focus-visible ring (shared
+               `:focus-visible` group in dock.css) + the active-state
+               `--dock-active-shadow` — the AX.W09-retired hover `--glass-highlight`
+               specular no longer rides it. */
                 box-shadow var(--dock-motion-fast);
 
-        /* AT.W7-dock-b — glass icon-hover. The icon-button hover now reads as a
-           glass surface, not a flat `--muted` plate: a translucent card-tinted fill
-           composes with the specular `--glass-highlight` token (the inset top-edge
-           glass highlight every glass tier carries — `--dock-icon-hover-shadow`
-           defaults to it). Coherent with the dock's glass tier and the
-           `[data-tier="secondary"]` recipe below. A consumer retunes the fill via
-           `--dock-icon-hover-bg` and the specular via `--dock-icon-hover-shadow`. */
+        /* 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`.
+
+           AX.W09 — the dock control's SECOND specular (the `--glass-highlight`
+           hover box-shadow, AT.W7-dock-b) is RETIRED. The dock-icon-button is a
+           member of the unified `.glass-material` group (glass.css), so the moving
+           `::before` catch-light is now its SOLE specular owner — one light per
+           surface (the §0 "excise or fail" discipline). Stacking the
+           `--glass-highlight` inset box-shadow on the most-hovered, slides-floated
+           surface was the worst-offending double-light blowout; the card-tinted
+           hover fill carries the affordance without a second catch-light, and
+           dropping it also removes the `:not(:focus-visible)` specular-vs-ring
+           juggle. */
         &:hover:not(:disabled) {
             background: var(
                 --dock-icon-hover-bg,
@@ -94,14 +104,6 @@
             scale: var(--scale-hover-dock);
         }
 
-        /* The specular highlight is scoped to `:not(:focus-visible)` so it never
-           clobbers the focus ring box-shadow (the shared `:focus-visible` group in
-           dock.css) when a control is both hovered and keyboard-focused —
-           the ring wins, the specular yields. */
-        &:hover:not(:disabled):not(:focus-visible) {
-            box-shadow: var(--dock-icon-hover-shadow, var(--glass-highlight));
-        }
-
         &:active:not(:disabled) {
             scale: var(--scale-press-dock);
         }
@@ -128,8 +130,9 @@
 
     /* focus-visible ring + disabled paint hoisted to the shared `:where()`
        group in dock.css. The box-shadow fade transition lives on the base
-       `.dock-icon-button` rule (AT.W7-dock-b added `box-shadow` there for the
-       glass specular hover), so no per-state transition override is needed. */
+       `.dock-icon-button` rule (it carries the focus-ring + active-shadow fade
+       since AX.W09 retired the hover `--glass-highlight` specular), so no
+       per-state transition override is needed. */
 
     .dock-icon-button--compact {
         width: var(--dock-compact-control-size, auto);