@mkbabb/glass-ui 5.0.0 → 6.0.0

package/dist/components/skeleton/Skeleton.vue.d.ts

@@ -28,8 +28,8 @@ type __VLS_Props = {
     class?: HTMLAttributes['class'];
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    variant: SkeletonVariant;
     surface: SkeletonSurface;
+    variant: SkeletonVariant;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/slider/Slider.vue.d.ts

@@ -8,6 +8,8 @@ type __VLS_Props = SliderRootProps & {
     variant?: SliderVariants['variant'];
     /** Track + thumb geometry — sm | md (default) | lg. */
     size?: SliderVariants['size'];
+    /** Quiet, paint-only checkpoints in the slider's numeric domain. */
+    marks?: readonly number[];
     /**
      * Acquire a `dockKeepOpen` token while the user drags the slider, so
      * an enclosing dock doesn't auto-collapse mid-gesture. The slider also

package/dist/components/split-chars/SplitChars.vue.d.ts

@@ -45,8 +45,8 @@ type __VLS_Props = {
     class?: HTMLAttributes["class"];
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    as: string | Component;
     by: "char" | "word" | "grapheme";
+    as: string | Component;
     stagger: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/components/surface/Surface.vue.d.ts

@@ -29,8 +29,8 @@ type __VLS_Slots = {} & {
 };
 declare const __VLS_base: import("vue").DefineComponent<SurfaceProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<SurfaceProps> & Readonly<{}>, {
     shadow: boolean;
-    surface: SurfaceKind;
     as: import("reka-ui").AsTag | import("vue").Component;
+    surface: SurfaceKind;
     deep: boolean;
     tier: SurfaceTier;
     grain: boolean;

package/dist/components/table/Table.vue.d.ts

@@ -1,6 +1,10 @@
 import type { HTMLAttributes } from "vue";
 type __VLS_Props = {
     class?: HTMLAttributes["class"];
+    role?: HTMLAttributes["role"];
+    ariaLabel?: string;
+    ariaColCount?: number;
+    ariaRowCount?: number;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/components/tabs/SegmentedTabs.vue.d.ts

@@ -11,6 +11,9 @@ export interface SegmentedTabOption {
 /** The two materials. `pill` (DEFAULT) = the glass-track slider (absorbs the
  *  retired `segmented`); `underline` = the paper ink-hairline rule. */
 export type SegmentedTabsVariant = "pill" | "underline";
+/** The interaction semantic, independent of material. `toggle` exposes a
+ *  group of pressed buttons; `tabs` exposes a tablist with selected tabs. */
+export type SegmentedTabsSemantics = "toggle" | "tabs";
 /** The orientation axis — `horizontal` (default) lays children in a row + tracks
  *  the indicator on the inline axis; `vertical` stacks a column + tracks the
  *  block axis (the vertical underline is the leading-edge ink rail). */
@@ -34,11 +37,18 @@ export interface SegmentedTabsResponsive {
 }
 export interface SegmentedTabsProps {
     options: SegmentedTabOption[];
+    /** Accessible name shared by the desktop strip and responsive Select. */
+    ariaLabel?: string;
     /**
      * The material — `pill` (DEFAULT, the glass-track slider) or `underline`
      * (the paper ink-hairline rule).
      */
     variant?: SegmentedTabsVariant;
+    /**
+     * Interaction semantics, independent of `variant`. When omitted, preserves the
+     * historical mapping: `pill` → `toggle`, `underline` → `tabs`.
+     */
+    semantics?: SegmentedTabsSemantics;
     /**
      * Orientation — `horizontal` (default) or `vertical`. Axis-derived on the
      * one indicator engine.

package/dist/components/tabs/index.d.ts

@@ -1,2 +1,2 @@
 export { default as SegmentedTabs } from "./SegmentedTabs.vue";
-export type { SegmentedTabOption, SegmentedTabsVariant, SegmentedTabsOrientation, SegmentedTabsProps, SegmentedTabsResponsive, } from "./SegmentedTabs.vue";
+export type { SegmentedTabOption, SegmentedTabsVariant, SegmentedTabsSemantics, SegmentedTabsOrientation, SegmentedTabsProps, SegmentedTabsResponsive, } from "./SegmentedTabs.vue";

package/dist/components/tabs/styles/drag.css

@@ -0,0 +1 @@
+.glass-drag-grabbable { cursor: grab; touch-action: none; } .glass-drag-lift { cursor: grabbing; will-change: transform; } .segmented-tabs:not(.segmented-tabs--underline):has( .segmented-indicator.glass-drag-grabbable ) .segmented-tab[aria-pressed="true"] { pointer-events: none; } .segmented-indicator.glass-drag-lift { z-index: 30; } .segmented-tabs[data-eyeglass] { --eyeglass-settled: 0.84; --eyeglass-proud: 1.12; --eyeglass-track-blur: var(--glass-blur-floating); -webkit-backdrop-filter: var(--eyeglass-track-blur); backdrop-filter: var(--eyeglass-track-blur); -webkit-backdrop-filter: var(--eyeglass-track-blur); } .segmented-tabs[data-eyeglass] .segmented-indicator__plate { --eyeglass-y: calc( var(--eyeglass-settled) + var(--eyeglass-live-t) * (var(--eyeglass-proud) - var(--eyeglass-settled)) ); } @media (prefers-reduced-motion: reduce) { .segmented-tabs[data-eyeglass] .segmented-indicator__plate { --eyeglass-y: 1; } } @supports (backdrop-filter: url("#glass-refract")) { .segmented-tabs[data-eyeglass] .segmented-indicator__plate.glass-lens { -webkit-backdrop-filter: var(--glass-blur-floating) var(--glass-refract-filter); backdrop-filter: var(--glass-blur-floating) var(--glass-refract-filter); } } .segmented-tabs[data-eyeglass] .segmented-tab[aria-pressed="true"] svg { color: var(--tab-selected-ink, var(--foreground)); }

package/dist/components/tags-input/TagsInput.vue.d.ts

@@ -8,13 +8,13 @@ type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_8) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    invalid: (payload: import("reka-ui").AcceptableInputValue) => any;
     "update:modelValue": (payload: import("reka-ui").AcceptableInputValue[]) => any;
+    invalid: (payload: import("reka-ui").AcceptableInputValue) => any;
     addTag: (payload: import("reka-ui").AcceptableInputValue) => any;
     removeTag: (payload: import("reka-ui").AcceptableInputValue) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onInvalid?: ((payload: import("reka-ui").AcceptableInputValue) => any) | undefined;
     "onUpdate:modelValue"?: ((payload: import("reka-ui").AcceptableInputValue[]) => any) | undefined;
+    onInvalid?: ((payload: import("reka-ui").AcceptableInputValue) => any) | undefined;
     onAddTag?: ((payload: import("reka-ui").AcceptableInputValue) => any) | undefined;
     onRemoveTag?: ((payload: import("reka-ui").AcceptableInputValue) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/components/timeline/ContinuousTimeline.vue.d.ts

@@ -70,7 +70,7 @@ declare var __VLS_17: {
     segment: TimelineSegment;
 }, __VLS_19: {
     segment: TimelineSegment | null;
-    source: "idle" | "current" | "hovered";
+    source: "current" | "idle" | "hovered";
     currentKey: string | null;
     hoveredKey: string | null;
 };

package/dist/components/timeline/GlassTimeline.vue.d.ts

@@ -58,7 +58,7 @@ declare var __VLS_13: {
     segment: TimelineSegment;
 }, __VLS_16: {
     segment: TimelineSegment | null;
-    source: "idle" | "current" | "hovered";
+    source: "current" | "idle" | "hovered";
     currentKey: string | null;
     hoveredKey: string | null;
 };
@@ -68,6 +68,7 @@ type __VLS_Slots = {} & {
     detail?: (props: typeof __VLS_16) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (v: number) => any;
     click: (payload: {
         key: string;
         segment: TimelineSegment;
@@ -76,7 +77,6 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
         key: string;
         segment: TimelineSegment;
     }) => any;
-    "update:modelValue": (v: number) => any;
     hoverEnd: (payload: {
         key: string;
         segment: TimelineSegment;
@@ -84,6 +84,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     scrubStart: () => any;
     scrubEnd: () => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((v: number) => any) | undefined;
     onClick?: ((payload: {
         key: string;
         segment: TimelineSegment;
@@ -92,7 +93,6 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
         key: string;
         segment: TimelineSegment;
     }) => any) | undefined;
-    "onUpdate:modelValue"?: ((v: number) => any) | undefined;
     onHoverEnd?: ((payload: {
         key: string;
         segment: TimelineSegment;
@@ -100,8 +100,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     onScrubStart?: (() => any) | undefined;
     onScrubEnd?: (() => any) | undefined;
 }>, {
-    variant: "scrubber" | "segmented" | "continuous";
     modelValue: number;
+    variant: "scrubber" | "segmented" | "continuous";
     disablePopover: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/components/toast/Toast.vue.d.ts

@@ -12,9 +12,9 @@ type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_8) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<ToastProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    pause: () => any;
     "update:open": (value: boolean) => any;
     escapeKeyDown: (event: KeyboardEvent) => any;
+    pause: () => any;
     resume: () => any;
     swipeStart: (event: {
         currentTarget: EventTarget & HTMLElement;
@@ -53,9 +53,9 @@ declare const __VLS_base: import("vue").DefineComponent<ToastProps, {}, {}, {},
         };
     }>, "currentTarget">) => any;
 }, string, import("vue").PublicProps, Readonly<ToastProps> & Readonly<{
-    onPause?: (() => any) | undefined;
     "onUpdate:open"?: ((value: boolean) => any) | undefined;
     onEscapeKeyDown?: ((event: KeyboardEvent) => any) | undefined;
+    onPause?: (() => any) | undefined;
     onResume?: (() => any) | undefined;
     onSwipeStart?: ((event: {
         currentTarget: EventTarget & HTMLElement;
@@ -94,8 +94,8 @@ declare const __VLS_base: import("vue").DefineComponent<ToastProps, {}, {}, {},
         };
     }>, "currentTarget">) => any) | undefined;
 }>, {
-    tone: Tone;
     surface: Surface;
+    tone: Tone;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/components/toast/use-toast.d.ts

@@ -39,14 +39,14 @@ declare function useToast(): {
         id: string;
         title?: string | undefined;
         description?: string | undefined;
-        action?: VNode<import("vue").RendererNode, import("vue").RendererElement, {
-            [key: string]: any;
-        }> | import("vue").FunctionalComponent<any, {}, any, {}> | {
+        action?: import("vue").FunctionalComponent<any, {}, any, {}> | {
             new (...args: any[]): any;
             __isFragment?: never;
             __isTeleport?: never;
             __isSuspense?: never;
-        } | {
+        } | VNode<import("vue").RendererNode, import("vue").RendererElement, {
+            [key: string]: any;
+        }> | {
             [x: string]: any;
             setup?: ((this: void, props: import("@vue/shared").LooseRequired<any>, ctx: {
                 attrs: import("vue").Attrs;

package/dist/components/typewriter/TypewriterText.vue.d.ts

@@ -27,8 +27,6 @@ interface Props {
     pauseAfterDelete?: number;
     /** Backspace speed in word-rotation mode (ms per char). */
     deletingSpeed?: number;
-    /** Whether clicking characters triggers interactive backspace. */
-    interactive?: boolean;
     respectReducedMotion?: boolean;
 }
 declare const __VLS_export: import("vue").DefineComponent<Props, {
@@ -56,10 +54,9 @@ declare const __VLS_export: import("vue").DefineComponent<Props, {
     onComplete?: (() => any) | undefined;
     onWordComplete?: ((index: number) => any) | undefined;
 }>, {
-    loop: boolean;
     text: string;
     respectReducedMotion: boolean;
-    interactive: boolean;
+    loop: boolean;
     words: TypewriterWord[];
     ngramSize: number | {
         min: number;

package/dist/components/typewriter/composables/useTypewriter.d.ts

@@ -14,7 +14,6 @@ export declare function useTypewriter(options: TypewriterOptions): {
     stopTyping: () => void;
     reset: () => void;
     updateText: (newText: string) => void;
-    backspaceToPosition: (targetLength: number) => Promise<void>;
     pause: () => void;
     resume: () => void;
     setCharPosition: (n: number) => void;

package/dist/components/typewriter/utils/graphemes.d.ts

@@ -0,0 +1 @@
+export declare function splitGraphemes(text: string): string[];

package/dist/components/watercolor-dot/WatercolorDot.vue.d.ts

@@ -57,10 +57,10 @@ type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_11) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    animate: boolean;
     range: [number, number];
-    variant: "solid" | "ghost";
+    animate: boolean;
     seed: string;
+    variant: "solid" | "ghost";
     tag: "div" | "button";
     cycleDuration: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/composables/glass/useGlassBackdropLuminance.d.ts

@@ -53,11 +53,42 @@ export interface UseGlassBackdropLuminanceControls {
     readonly luma: Readonly<Ref<number | null>>;
     /** The last derived bucket, or null before the first sample. */
     readonly bucket: Readonly<Ref<GlassBackdropBucket | null>>;
+    /**
+     * The observer's explicit sample provenance. A live request is never represented
+     * as a static sample: a missing or unreadable canvas reports `unavailable`.
+     */
+    readonly sample: Readonly<Ref<GlassBackdropSample>>;
     /** Force one sample now (bypasses the throttle — used on mount + resize-settle). */
     sampleNow: () => void;
     /** Stop the loop + detach every observer/listener. */
     dispose: () => void;
 }
+export type GlassBackdropSample = {
+    state: "pending";
+    mode: "live" | "static";
+    source: "canvas" | "elements";
+} | {
+    state: "sampled";
+    mode: "live" | "static";
+    source: "canvas" | "elements";
+    luma: number;
+    ambientHue: string;
+    sampledAt: number;
+    targetRect: GlassBackdropTargetRect;
+} | {
+    state: "unavailable";
+    mode: "live" | "static";
+    source: "canvas" | "elements";
+    reason: "source-unavailable" | "sample-unavailable";
+    sampledAt: number;
+    targetRect: GlassBackdropTargetRect;
+};
+export interface GlassBackdropTargetRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
 /**
  * BI.W-DOCK-LUMA-SHARE — the shared-coverage marker. A SHARED route observer
  * (`shared: true`) stamps this attribute on its target (the route/stage scope); a

package/dist/composables/glass/webgpu/rendererStatus.d.ts

@@ -0,0 +1,13 @@
+export type RendererEngine = "webgpu" | "webgl2" | "canvas2d" | "css";
+export interface RendererStatus {
+    phase: "initializing" | "ready" | "error";
+    engine: RendererEngine;
+    adapter: string;
+    error?: string;
+}
+export declare const pendingRenderer: (engine: RendererEngine) => RendererStatus;
+export declare const canvas2DRenderer: () => RendererStatus;
+export declare const cssRenderer: () => RendererStatus;
+export declare function describeWebGPUAdapter(info?: GPUAdapterInfo): string;
+export declare function describeWebGL2Adapter(gl: WebGL2RenderingContext | null): string;
+export declare function rendererFailure(engine: RendererEngine, adapter: string, error: unknown): RendererStatus;

package/dist/composables/glass/webgpu/useGpuSubstrate.d.ts

@@ -2,6 +2,8 @@ import { type WebGLCanvasFrame, type WebGLCanvasOptions } from "../webgl/useWebG
 import type { DprPolicy } from "../webgl/createCanvasLifecycle";
 export type { BackingSize, DprPolicy } from "../webgl/createCanvasLifecycle";
 import { supportsWebGPU, type WebGPUCanvasFrame, type WebGPUCanvasOptions } from "./useWebGPUCanvas";
+import { type RendererStatus } from "./rendererStatus";
+export type { RendererStatus, RendererEngine } from "./rendererStatus";
 export { supportsWebGPU };
 /** Which backend the picker resolved. */
 export type GpuBackend = "webgpu" | "webgl2";
@@ -64,6 +66,7 @@ export interface GpuSubstrateOptions {
         to: "webgl2";
         error: unknown;
     }) => void;
+    onStatus?: (status: RendererStatus) => void;
 }
 /**
  * The uniform substrate handle. A viz consumer wires its lifecycle (offscreen pause,

package/dist/composables/glass/webgpu/webgpuCanvasTypes.d.ts

@@ -87,6 +87,8 @@ export interface WebGPUCanvasHandle {
     dispose: () => void;
     /** The live device (null before armAsync / after dispose / mid-loss). */
     readonly device: GPUDevice | null;
+    /** Runtime-derived adapter identity, available once acquisition succeeds. */
+    readonly adapterClass: string;
     /**
      * The live `prefers-reduced-motion: reduce` state. The shared lifecycle core
      * owns + re-monitors it; consumers read it (e.g. a viz freezes its frame time

package/dist/composables/motion/springProjection.d.ts

@@ -0,0 +1,16 @@
+import { type TimingFunction } from "@mkbabb/keyframes.js";
+import type { SpringPresetRow } from "./springPresets";
+type SpringParameters = Pick<SpringPresetRow, "response" | "dampingFraction">;
+/** Internal projection shared by token generation and the Springs lab. */
+export interface SpringProjection {
+    readonly settleSeconds: number;
+    readonly sampleCount: number;
+    readonly stops: string;
+    readonly timingFunction: TimingFunction;
+}
+export declare const SPRING_TOKEN_SAMPLE_COUNT = 48;
+/** Numeric 2%-band settle, rounded to the token register's nearest 10 ms. */
+export declare function springSettleDurationSeconds(parameters: SpringParameters): number;
+/** Project one spring through the exact horizon and density used by CSS tokens. */
+export declare function springProjection(parameters: SpringParameters): SpringProjection;
+export {};

package/dist/composables/motion/useAnimatedNumber.d.ts

@@ -18,10 +18,7 @@ export interface UseAnimatedNumberOptions {
     /** Per-frame side-effect hook. Receives the smoothed current value. */
     onValue?: (value: number) => void;
 }
-/**
- * The `useAnimatedNumber` return shape (AW.W15 — named `Use<Name>Return`
- * convention). `AnimatedNumber` is the preserved alias so import sites stay put.
- */
+/** The `useAnimatedNumber` return shape. */
 export interface UseAnimatedNumberReturn {
     /** Reactive smoothed value. Bind in templates. */
     current: Readonly<Ref<number>>;
@@ -34,8 +31,6 @@ export interface UseAnimatedNumberReturn {
     /** Stop the smoother and target watcher. */
     dispose: () => void;
 }
-/** Preserved alias for {@link UseAnimatedNumberReturn} (AW.W15). */
-export type AnimatedNumber = UseAnimatedNumberReturn;
 /**
  * Track a live numeric target with exponentially damped hysteresis.
  *

package/dist/composables/motion/useCountup.d.ts

@@ -1,8 +1,5 @@
 import { type Ref } from "vue";
-/**
- * The `useCountup` return shape (AW.W15 — named `Use<Name>Return` convention).
- * `Countup` is the preserved alias so existing import sites do not break.
- */
+/** The `useCountup` return shape. */
 export interface UseCountupReturn {
     /** Animate the count-ups inside the currently-active slide/region. */
     runActive: () => void;
@@ -11,8 +8,6 @@ export interface UseCountupReturn {
     /** Cancel every in-flight tween (also runs on scope-dispose). */
     cancel: () => void;
 }
-/** Preserved alias for {@link UseCountupReturn} — keeps import sites stable (AW.W15). */
-export type Countup = UseCountupReturn;
 export interface UseCountupOptions {
     /**
      * Easing applied to tween progress — a value.js-FREE callable

package/dist/composables/motion/useDockCtaReceive.d.ts

@@ -4,6 +4,55 @@ import { type ElementMorphPreset } from "./useElementMorph";
  *  emphatic land-with-overshoot). Matches `useLiquidReveal`'s register so the two seams
  *  read as ONE family. */
 export type DockCtaReceivePreset = ElementMorphPreset;
+export type DockCtaReceivePath = "fine" | "coarse" | "reduced-motion" | "no-target";
+export type DockCtaReceivePhase = "idle" | "receiving" | "settled" | "handed-off" | "completed" | "reset";
+export interface DockCtaReceiveBand {
+    readonly latencyFactor: readonly [number, number];
+    readonly travelPx: readonly [number, number];
+    readonly scaleRatio: readonly [number, number];
+}
+/** Product bounds relative to the selected spring's measured analytic horizon. */
+export declare const DOCK_CTA_RECEIVE_BANDS: {
+    readonly fine: {
+        readonly latencyFactor: readonly [0.9, 1.2];
+        readonly travelPx: readonly [16, 520];
+        readonly scaleRatio: readonly [0.2, 1.4];
+    };
+    readonly coarse: {
+        readonly latencyFactor: readonly [0.9, 1.2];
+        readonly travelPx: readonly [16, 360];
+        readonly scaleRatio: readonly [0.2, 1.4];
+    };
+    readonly "reduced-motion": {
+        readonly latencyFactor: readonly [0, 0.017];
+        readonly travelPx: readonly [0, 0];
+        readonly scaleRatio: readonly [1, 1];
+    };
+    readonly "no-target": {
+        readonly latencyFactor: readonly [0, 0.017];
+        readonly travelPx: readonly [0, 0];
+        readonly scaleRatio: readonly [1, 1];
+    };
+};
+export interface DockCtaReceiveObservables {
+    readonly phase: DockCtaReceivePhase;
+    readonly path: DockCtaReceivePath | null;
+    readonly run: number;
+    readonly interruptions: number;
+    readonly resets: number;
+    readonly startedAtMs: number | null;
+    readonly settledAtMs: number | null;
+    readonly handedOffAtMs: number | null;
+    readonly completedAtMs: number | null;
+    readonly latencyMs: number | null;
+    readonly travelPx: number;
+    readonly scaleRatio: number;
+    readonly latencyBandMs: readonly [number, number] | null;
+    readonly travelBandPx: readonly [number, number] | null;
+    readonly scaleBand: readonly [number, number] | null;
+    readonly withinBand: boolean | null;
+    readonly supportsReverse: false;
+}
 export interface UseDockCtaReceiveOptions {
     /**
      * The dock control the CTA flies onto — a templateRef to the control ELEMENT or to a
@@ -40,6 +89,12 @@ export interface UseDockCtaReceiveReturn {
     clearPending: () => void;
     /** The reactive seat state — the consumer binds `:class`/`v-if` off it. */
     pending: Readonly<Ref<boolean>>;
+    /** Whether the shared morph owner is currently playing. */
+    playing: Readonly<Ref<boolean>>;
+    /** Live normalized arrival progress from the shared morph owner. */
+    progress: Readonly<Ref<number>>;
+    /** Start/settle/handoff/completion and policy-band readback for the current run. */
+    observables: Readonly<Ref<DockCtaReceiveObservables>>;
 }
 /**
  * The external-CTA-into-dock-control morph. A ≤20-line adapter over `useElementMorph` —

package/dist/composables/motion/useElementMorph.d.ts

@@ -59,6 +59,14 @@ export interface UseElementMorphReturn {
     playing: Readonly<Ref<boolean>>;
     /** The live eased ARRIVAL progress (0 at play start → 1 at settle). */
     progress: Readonly<Ref<number>>;
+    /** Geometry and engine horizon measured by this owner for the current play. */
+    measurement: Readonly<Ref<ElementMorphMeasurement | null>>;
+}
+export interface ElementMorphMeasurement {
+    readonly travelPx: number;
+    readonly scaleX: number;
+    readonly scaleY: number;
+    readonly durationMs: number;
 }
 /**
  * Resolve a templateRef value to its root HTMLElement — accepts an element directly OR a

package/dist/composables/motion/useLiquidPress.d.ts

@@ -1,4 +1,4 @@
-import { type CSSProperties, type ComputedRef, type Ref } from "vue";
+import { type CSSProperties, type ComputedRef, type MaybeRefOrGetter, type Ref } from "vue";
 import { type UseSpringPressOptions } from "./useSpringPress";
 export interface UseLiquidPressOptions extends UseSpringPressOptions {
     /**
@@ -15,7 +15,7 @@ export interface UseLiquidPressOptions extends UseSpringPressOptions {
      * the travel axis). Default 1.04 (a button has no size span — the deform is a
      * lively settle, never a taffy-pull). Kept LOW by the liquid register.
      */
-    maxStretch?: number;
+    maxStretch?: MaybeRefOrGetter<number>;
     /**
      * The custom-property NAME the live press value (0..1) is written under, for the
      * surface CSS to read for the coupled brightness/specular leg. Default
@@ -51,6 +51,8 @@ export interface UseLiquidPressOptions extends UseSpringPressOptions {
      * lively settle, never a taffy-pull.
      */
     el?: Ref<HTMLElement | null>;
+    /** Disable every activation path. A held press is released when this becomes true. */
+    disabled?: MaybeRefOrGetter<boolean | undefined>;
 }
 export interface UseLiquidPressReturn {
     /** The live spring press value (0 released → 1 pressed, with the spring overshoot). */
@@ -59,12 +61,18 @@ export interface UseLiquidPressReturn {
     press: () => void;
     /** Release the press to 0 (call on `pointerup`/`cancel`/`leave`). */
     release: () => void;
-    /** Pointer handlers ready to spread onto an element (the `useSpringPress` ergonomics). */
+    /** True after hydration, when JS exclusively owns the scale channel. */
+    armed: Readonly<Ref<boolean>>;
+    /** Pointer and keyboard handlers for the complete press lifecycle. */
     handlers: {
-        onPointerdown: () => void;
+        onPointerdown: (event?: PointerEvent) => void;
         onPointerup: () => void;
         onPointercancel: () => void;
         onPointerleave: () => void;
+        onPointerenter: (event: PointerEvent) => void;
+        onKeydown: (event: KeyboardEvent) => void;
+        onKeyup: (event: KeyboardEvent) => void;
+        onBlur: () => void;
     };
     /**
      * The coupled press style — the ONE `:style` object a consumer binds. Carries the

package/dist/composables/motion/useNumericTransition.d.ts

@@ -22,6 +22,8 @@ export interface UseNumericTransitionOptions<K extends string> {
     to: SpringSnapshot<K>;
     /** Playback duration in ms. */
     duration: number;
+    /** Honor prefers-reduced-motion by snapping to the target. Default true. */
+    respectReducedMotion?: boolean;
     /**
      * keyframes.js timing function — an explicit callable `(t) => number`.
      *

package/dist/composables/motion/useTextHighlight.d.ts

@@ -24,7 +24,8 @@ export interface UseTextHighlightControls {
 /**
  * Drive a named CSS Custom Highlight reactively.
  *
- * @param name registry key — must match a `::highlight(<name>)` style rule.
+ * @param name registry key — must match a caller-owned
+ *   `::highlight(<name>)` style rule. This low-level API does not inject CSS.
  *   Instances sharing a name multiplex: each contributes its own ranges and
  *   the shared paint is their union (last to dispose drops the registry entry).
  *