@mkbabb/glass-ui 3.10.1 → 3.11.0

package/dist/useSpringMount-BJSHcLl3.js

@@ -0,0 +1,113 @@
+import { computed as e, getCurrentScope as t, nextTick as n, onMounted as r, onScopeDispose as i, readonly as a, ref as o, shallowRef as s, toValue as c, watch as l } from "vue";
+import { SpringProgress as u } from "@mkbabb/keyframes.js";
+//#region src/composables/motion/useSpring.ts
+function d(e, n = {}) {
+	let r = n.initial ?? 0, d = n.initialVelocity ?? 0, f = o(r), p = o(d), m = o(d === 0), h = s(new u({
+		response: n.response ?? .5,
+		dampingFraction: n.dampingFraction ?? .86,
+		initial: r,
+		initialVelocity: d,
+		settleThreshold: n.settleThreshold ?? .001,
+		velocitySettleThreshold: n.velocitySettleThreshold ?? .001,
+		respectReducedMotion: n.respectReducedMotion !== !1
+	})), g = h.value.subscribe((e, t) => {
+		f.value = e, p.value = t, m.value = h.value.settled, n.onValue?.(e, t);
+	});
+	h.value.play(() => {});
+	let _ = l(() => c(e), (e) => {
+		e != null && (h.value.target = e);
+	}, { immediate: !0 });
+	function v() {
+		f.value = h.value.value, p.value = h.value.velocity, m.value = h.value.settled;
+	}
+	function y() {
+		_(), g(), h.value.dispose();
+	}
+	return t() && i(y), {
+		value: a(f),
+		velocity: a(p),
+		isSettled: a(m),
+		snap: () => {
+			h.value.snap(), v();
+		},
+		reset: (e, t) => {
+			h.value.reset(e ?? 0, t ?? 0), v();
+		},
+		dispose: y
+	};
+}
+//#endregion
+//#region src/composables/motion/useSpringMount.ts
+var f = {
+	smooth: {
+		response: .5,
+		dampingFraction: .86
+	},
+	snappy: {
+		response: .35,
+		dampingFraction: .65
+	},
+	bouncy: {
+		response: .5,
+		dampingFraction: .45
+	},
+	gentle: {
+		response: .7,
+		dampingFraction: 1
+	}
+};
+function p(t) {
+	let a = f[t.preset ?? "smooth"], s = o(1), c = o(!1), u = 0, p = 0, m = null, h = !1, g = d(s, {
+		response: a.response,
+		dampingFraction: a.dampingFraction,
+		initial: 1,
+		settleThreshold: .001,
+		velocitySettleThreshold: .001,
+		respectReducedMotion: t.respectReducedMotion !== !1
+	});
+	r(() => {
+		t.open.value && n(() => {
+			s.value = 0;
+		});
+	});
+	let _ = l(() => t.open.value, (e, t) => {
+		e !== t && (c.value || (s.value = +!e));
+	}, { immediate: !1 }), v = l(() => g.isSettled.value, (e) => {
+		e && h && s.value >= 1 && (h = !1, t.onDismiss?.());
+	});
+	function y(e) {
+		if (e.button !== 0) return;
+		let t = e.currentTarget;
+		p = t.getBoundingClientRect().height || 1, u = e.clientY, m = e.pointerId, c.value = !0, t.setPointerCapture(e.pointerId);
+	}
+	function b(e) {
+		if (!c.value || e.pointerId !== m) return;
+		let t = e.clientY - u;
+		if (t <= 0) {
+			s.value = 0;
+			return;
+		}
+		s.value = Math.min(1, t / p);
+	}
+	function x(e) {
+		if (!c.value || e.pointerId !== m) return;
+		let n = e.currentTarget;
+		n.hasPointerCapture(e.pointerId) && n.releasePointerCapture(e.pointerId), c.value = !1, m = null;
+		let r = t.dismissThreshold ?? .3;
+		s.value >= r ? (h = !0, s.value = 1) : s.value = 0;
+	}
+	return i(() => {
+		_(), v();
+	}), {
+		position: g.value,
+		isDragging: e(() => c.value),
+		dragHandlers: {
+			onPointerdown: y,
+			onPointermove: b,
+			onPointerup: x,
+			onPointercancel: x
+		}
+	};
+}
+//#endregion
+export { d as n, p as t };

package/dist/useViewTransition-DaN5Zrox.js

@@ -0,0 +1,21 @@
+//#region src/composables/motion/useViewTransition.ts
+function e() {
+	return typeof document < "u" && typeof document.startViewTransition == "function";
+}
+function t(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
+export { e as n, t };

package/dist/vReveal-zUIQk-rJ.js

@@ -0,0 +1,53 @@
+//#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/useRouteTransition.ts
+function r() {
+	return typeof window > "u" || typeof window.matchMedia != "function" ? !1 : window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+}
+function i() {
+	return typeof document < "u" && typeof document.startViewTransition == "function";
+}
+function a() {
+	function e(e, t) {
+		let n = typeof document > "u" ? void 0 : document;
+		if (!n || typeof n.startViewTransition != "function" || r()) return {
+			finished: (async () => e())().then(() => void 0, () => void 0),
+			transitioned: !1
+		};
+		let i = t?.types && t.types.length > 0 ? n.startViewTransition({
+			update: () => e(),
+			types: t.types
+		}) : n.startViewTransition(() => e());
+		return i.ready?.catch(() => {}), {
+			finished: i.finished.then(() => void 0, () => void 0),
+			transitioned: !0
+		};
+	}
+	return {
+		navigate: e,
+		supported: i()
+	};
+}
+//#endregion
+//#region src/composables/motion/vReveal.ts
+function o(e, t) {
+	e.setAttribute("data-reveal", t.arg === "fade" ? "fade" : ""), e.style.setProperty("--d", String(t.value ?? 0));
+}
+var s = {
+	mounted: o,
+	updated: o
+};
+//#endregion
+export { e as a, n as i, i as n, t as o, a as r, s as t };

package/dist/watercolor-dot.js

@@ -1,5 +1,5 @@
-import { t as e } from "./_plugin-vue_export-helper-DWghtRt7.js";
-import { n as t, t as n } from "./prng-CjVgzjQT.js";
+import { t as e } from "./_plugin-vue_export-helper-ok8pgSl5.js";
+import { n as t, t as n } from "./prng-D27-B3tK.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.10.1",
+    "version": "3.11.0",
     "description": "Glassmorphic design system — Vue 3.5 components, reka-ui primitives, Tailwind CSS v4 tokens",
     "license": "MIT",
     "repository": {
@@ -79,6 +79,9 @@
             "status-dot": [
                 "dist/status-dot.d.ts"
             ],
+            "deck-progress": [
+                "dist/deck-progress.d.ts"
+            ],
             "pulse": [
                 "dist/pulse.d.ts"
             ],
@@ -88,6 +91,9 @@
             "toggle-chip": [
                 "dist/toggle-chip.d.ts"
             ],
+            "glass-panel": [
+                "dist/glass-panel.d.ts"
+            ],
             "sortable-list": [
                 "dist/sortable-list.d.ts"
             ],
@@ -106,21 +112,24 @@
             "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"
             ],
@@ -145,9 +154,6 @@
             "motion-core": [
                 "dist/motion-core.d.ts"
             ],
-            "motion-curves": [
-                "dist/motion-curves.d.ts"
-            ],
             "button": [
                 "dist/button.d.ts"
             ],
@@ -306,10 +312,18 @@
             "types": "./dist/watercolor-dot.d.ts",
             "import": "./dist/watercolor-dot.js"
         },
+        "./handmark": {
+            "types": "./dist/handmark.d.ts",
+            "import": "./dist/handmark.js"
+        },
         "./configurator": {
             "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"
@@ -334,6 +348,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"
@@ -346,6 +364,10 @@
             "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"
@@ -370,6 +392,10 @@
             "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"
@@ -378,10 +404,6 @@
             "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"
@@ -410,10 +432,6 @@
             "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"
@@ -557,6 +575,10 @@
         "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-collapse-contract": "vitest run tests/components/custom/dock/GlassDock.collapse-contract.test.ts",
+        "proof:expand-reparent-determinism": "vitest run tests/components/custom/expandable-container/single-surface-reparent.test.ts",
+        "proof:dark-flip-settle": "vitest run tests/composables/dark/flip-settle.test.ts",
+        "proof:control-glass-register": "vitest run tests/components/ui/toggle-group/glass-register.test.ts tests/components/ui/slider/track-frost.test.ts",
         "proof:dock-vocabulary": "node scripts/proof-dock-vocabulary.mjs",
         "proof:dock-region-model": "node scripts/proof-dock-region-model.mjs",
         "proof:dock-perfection": "node scripts/proof-dock-perfection.mjs",
@@ -564,7 +586,6 @@
         "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,7 +596,6 @@
         "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",
@@ -597,7 +617,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:motion-suite": "node scripts/proof-motion-suite.mjs",
+        "proof:no-value-default": "node scripts/proof-no-value-default.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",
@@ -609,6 +629,7 @@
         "proof:aurora-space-gamma": "node scripts/proof-aurora-space-gamma.mjs",
         "proof:aurora-oklch-interp": "node scripts/proof-aurora-oklch-interp.mjs",
         "proof:aurora-derive-gamut": "vitest run tests/components/custom/aurora/derive-color.test.ts",
+        "proof:aurora-paper-ground": "vitest run tests/components/custom/aurora/paper-ground.test.ts",
         "proof:aurora-tensor-field": "node scripts/proof-aurora-tensor-field.mjs && vitest run tests/components/custom/aurora/painterly.test.ts",
         "proof:aurora-impasto-relight": "node scripts/proof-aurora-impasto-relight.mjs",
         "proof:aurora-vangogh-preset": "node scripts/proof-aurora-vangogh-preset.mjs",
@@ -626,11 +647,7 @@
         "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",
@@ -654,6 +671,14 @@
         "proof:constellation-field": "vitest run tests/components/custom/constellation/constellationField.test.ts",
         "proof:input-invalid-aria": "node scripts/proof-input-invalid-aria.mjs",
         "proof:subpath-enumeration": "node scripts/proof-subpath-enumeration.mjs",
+        "proof:handmark-export": "node scripts/proof-handmark-export.mjs",
+        "proof:handmark-tests": "vitest run tests/components/custom/handmark",
+        "proof:no-disco-star": "node scripts/proof-no-disco-star.mjs",
+        "proof:gold-ink-contrast": "node scripts/proof-gold-ink-contrast.mjs",
+        "proof:gold-seal-roundtrip": "node scripts/proof-gold-seal-roundtrip.mjs",
+        "proof:glass-gilt": "node scripts/proof-glass-gilt.mjs",
+        "proof:crayon-wipe-compositor": "node scripts/proof-crayon-wipe-compositor.mjs",
+        "proof:metric-badge-record": "vitest run tests/components/custom/metric-badge/MetricBadge.record.test.ts",
         "proof:no-orphan-composable": "node scripts/proof-no-orphan-composable.mjs",
         "proof:speedtest-boundary": "node scripts/proof-speedtest-boundary.mjs",
         "proof:glass-material-unified": "node scripts/proof-glass-material-unified.mjs",
@@ -664,19 +689,9 @@
         "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-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",
@@ -718,11 +733,13 @@
     "peerDependencies": {
         "@lucide/vue": "^1.16.0",
         "@mkbabb/keyframes.js": "^2.2.0 || ^3.0.0 || ^4.0.0",
+        "@mkbabb/pencil-boil": "^0.4.1",
         "@mkbabb/value.js": "^0.10.0 || ^0.11.0",
         "@vueuse/core": "^14.0",
         "class-variance-authority": "^0.7",
         "clsx": "^2.0",
         "embla-carousel-vue": "^8.0",
+        "perfect-freehand": "^1.2.3",
         "reka-ui": "^2.0",
         "tailwindcss": "^4.0",
         "tw-animate-css": "^1.2.5",
@@ -739,16 +756,23 @@
         "@mkbabb/keyframes.js": {
             "optional": true
         },
+        "@mkbabb/pencil-boil": {
+            "optional": true
+        },
         "@mkbabb/value.js": {
             "optional": true
         },
+        "perfect-freehand": {
+            "optional": true
+        },
         "tw-animate-css": {
             "optional": true
         }
     },
     "devDependencies": {
         "@lucide/vue": "^1.16.0",
-        "@mkbabb/keyframes.js": "^4.1.0",
+        "@mkbabb/keyframes.js": "^2.2.0",
+        "@mkbabb/pencil-boil": "^0.4.1",
         "@mkbabb/value.js": "^0.10.0",
         "@tailwindcss/postcss": "^4.3.0",
         "@tailwindcss/vite": "^4.3.0",

package/src/styles/animations.css

@@ -141,33 +141,129 @@
     100% { background-position: -200% 0; }
 }
 
-/* ── Sparkle sweep: four-point star traverses a surface diagonally ──
+/* ── Gold ONE-SHOT round-trip: the pressed seal (E7c — the to-AND-fro) ──────────
  *
- * Reserved for the chassis primary-action hover (dock-tab-button[data-tier="primary"])
- * and the `Complete!` shimmer cycle. Single keyframe, ~600ms per pass; the
- * consumer rule sets the duration and easing. Reduced-motion guard at the
- * consumer site (per surface — not all sparkle uses share the same gate).
- */
-@keyframes sparkle-sweep {
+ * A seal is PRESSED, catches the light ONCE, and RECEDES — a full ease-IN-AND-OUT
+ * envelope, not a fire-and-yank. The defect this replaces: `.text-gilt` used the
+ * infinite `gold-shimmer-slide` (`1 forwards`), which HELD its gilt terminal frame
+ * forever, and the consumer ripped the class off on a `setTimeout` — but the gold
+ * gradient lives in `background-image`, which no transition covers, so it SNAPPED
+ * off in one frame.
+ *
+ * This keyframe owns the WHOLE envelope and RESOLVES TO THE RESTING INK — there is
+ * nothing left to yank when it ends:
+ *   - `-webkit-text-fill-color` (and `color`) ride from the figure's OWN ink
+ *     (`currentColor` — the consumer's data-pole green/red) → `transparent` (the
+ *     gilt gradient shows through `background-clip:text`) → back to `currentColor`.
+ *     So the gilt FADES UP and FADES DOWN; at 0% and 100% the figure paints its own
+ *     ink and the gradient is occluded — the resting state, by construction.
+ *   - `background-position` slides the gradient across through the same window.
+ * No `forwards` is needed (the final keyframe IS rest), so on completion the class
+ * may simply stop mattering — the snap is structurally impossible. */
+@keyframes gold-shimmer-pulse {
     0% {
-        transform: translate(-30%, -30%) scale(0.5);
-        opacity: 0;
+        background-position: 150% 0;
+        color: currentColor;
+        -webkit-text-fill-color: currentColor;
     }
     25% {
-        opacity: 1;
+        color: transparent;
+        -webkit-text-fill-color: transparent;
+    }
+    75% {
+        color: transparent;
+        -webkit-text-fill-color: transparent;
     }
     100% {
-        transform: translate(180%, 180%) scale(1.2);
-        opacity: 0;
+        background-position: -150% 0;
+        color: currentColor;
+        -webkit-text-fill-color: currentColor;
     }
 }
 
-@media (prefers-reduced-motion: reduce) {
-    @keyframes sparkle-sweep {
-        0%, 100% { opacity: 0; transform: none; }
+/* ── Crayon-wipe: the scroll-scrubbed draw-on (D6.c M1) ──────────────────────
+ *
+ * The bidirectional, scroll-scrubbed DRAW-ON of a hand-mark (the crayon/pen
+ * underline, a drawn rule). The wipe is a `clip-path: inset()` of the LEFT edge
+ * only — the mark draws from inset(0 100% 0 0) (fully clipped from the right, so
+ * NOTHING shows) to inset(0) (fully revealed) — so the underline DRAWS as the
+ * figure scrolls into view and UN-DRAWS as it scrolls back up. `clip-path` is the
+ * compositor-eligible, FILTER-STABLE wipe (the medium's grain `feTurbulence`
+ * rasters ONCE and is untouched by the clip — the cardinal "no per-frame raster"
+ * discipline ds2-motion-field M1 names): clip-path animates on the compositor and
+ * never re-runs the static filter, unlike a `stroke-dashoffset` draw under the
+ * grain filter (which re-rasters per frame). The grammar mirrors scroll-driven.css
+ * (the `view()`/`scroll()` timeline home): the keyframe lives here (the shared
+ * @keyframes register); a consumer binds it to a NAMED `view-timeline` so the
+ * draw-on SCRUBS bidirectionally with scroll (forward → draws, back → un-draws),
+ * never a one-shot. The `.crayon-wipe` utility below is the binding.
+ *
+ * The keyframe itself is timeline-agnostic — it is equally a load-clock draw-on
+ * (bound to a keyframes.js Sequence) or a scroll scrub (bound to a view-timeline).
+ * The DEFAULT consumer is the scroll scrub (the figure-item underline drawing into
+ * the lower third), hence the utility's `view()` binding.
+ *
+ * Reduced-motion: the utility (NOT the keyframe) gates — under PRM the mark is SET
+ * to inset(0) (fully drawn, never animated), the correct degrade for a permanent
+ * structural draw (information parity: the underline is present, just not drawn).
+ */
+@keyframes crayon-wipe {
+    from {
+        /* clipped from the RIGHT by 100% → the mark is fully hidden (nothing
+           drawn yet); the left edge is the pen-tip about to move right. */
+        clip-path: inset(0 100% 0 0);
+    }
+    to {
+        /* fully revealed — the mark is wholly drawn. */
+        clip-path: inset(0 0 0 0);
+    }
+}
+
+/* ── .crayon-wipe — bind the wipe to a scroll view-timeline (D6.c M1) ──────────
+ * The scroll-scrubbed draw-on utility. A consumer puts `.crayon-wipe` on a
+ * hand-mark surface (the underline span, a drawn rule) and the mark draws/un-draws
+ * as it scrolls through its OWN `view()` timeline — a bidirectional scrub, free,
+ * off the main thread. The animation is `paused` with `animation-timeline: view()`
+ * so the scroll position IS the playhead (the native scroll-driven model — the
+ * timeline drives the frame, time does not). The named timeline is overridable
+ * (`--crayon-wipe-timeline`, default the element's own `view()`) so a consumer can
+ * scrub off a SHARED beat timeline (the §--beat-tl the atlas scroll-driven.css
+ * names) instead of the per-element view — that is the "named view-timeline so a
+ * consumer scrubs a draw-on bidirectionally" contract.
+ *
+ * @supports-gated + PRM-OUTER-gated, mirroring scroll-driven.css exactly: the
+ * whole binding sits under `prefers-reduced-motion: no-preference`, so under PRM
+ * the animation never attaches and the mark renders in its terminal `inset(0)`
+ * (fully-drawn) state — the static-draw degrade. The draw range is `entry`-keyed
+ * (the mark draws as it ENTERS the lower viewport), tunable via
+ * `--crayon-wipe-range-{start,end}`. */
+@media (prefers-reduced-motion: no-preference) {
+    @supports ((animation-timeline: view()) and (animation-range: entry)) {
+        .crayon-wipe {
+            animation: crayon-wipe auto linear both;
+            animation-timeline: var(--crayon-wipe-timeline, view(block));
+            animation-range: var(--crayon-wipe-range-start, entry 0%)
+                var(--crayon-wipe-range-end, cover 35%);
+        }
     }
 }
 
+/* ── Sparkle sweep: TOMBSTONE (D6.b — the disco-star excision) ──
+ *
+ * @deprecated 3.10 — DELETE in 3.11. The four-point `✦` star sweep was the one
+ * garish gesture in the library; the user named it for removal ("remove the disco
+ * star from all glass-ui elements"). Every in-tree consumer is re-homed: the
+ * `btn-audacious` hover affirmation now rides the specular catch-light alone; the
+ * gold-CTA rides the `btn-gold-bg-sweep` metal-catch; the chassis `complete`
+ * celebration re-homes to the `.text-gilt` one-shot (utilities.css). The keyframe
+ * body is EMPTIED rather than deleted for ONE minor so any out-of-tree consumer
+ * (the slides decks) fails SOFT — a no-op animation, not an unknown-animation
+ * error. The `--duration-sparkle` token is `@deprecated` alongside (tokens.css).
+ * Full delete (this block + the token + the theme bridge) lands in 3.11. */
+@keyframes sparkle-sweep {
+    /* intentionally empty — tombstoned, see deprecation note above */
+}
+
 /* ── Pulse dot bounce: dots variant of <Pulse> ──
  *
  * Three-dot loading indicator. Opacity 0.35 ↔ 1, scale 0.8 ↔ 1.2. Consumer

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

@@ -98,22 +98,6 @@
         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));
@@ -150,12 +134,6 @@
         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;

package/src/styles/dock/layers.css

@@ -196,19 +196,9 @@
        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;
-        min-height: var(--dock-layer-height, 2.5rem);
+        height: var(--dock-layer-height, 2.5rem);
     }
 
     .dock-layer.is-active {