@mkbabb/glass-ui 6.0.0 → 7.0.0

package/dist/components/dialog/DialogContent.vue.d.ts

@@ -1,112 +1,49 @@
-import { type HTMLAttributes } from 'vue';
-import { type DialogContentProps } from 'reka-ui';
-import { type SpringPreset } from '../../composables/motion/useSpringMount';
-import type { Motion, Placement } from '../_shared/axes';
-import { type Surface } from '../_shared/useSurfaceAxis';
-type __VLS_Props = DialogContentProps & {
-    class?: HTMLAttributes['class'];
-    /** Surface decoration register (BA.W-SURFACE-AXIS) — the SHARED
-     *  {glass·veil·opaque} axis. `glass` (translucent blur, default) renders the
-     *  floating glass tier; `veil` overlays the borderless/rimless text-legibility
-     *  plate; `opaque` sets `--glass-level:0` (the solid-card escape). Replaces the
-     *  retired binary `variant: glass|opaque` (clean break). */
+import { type HTMLAttributes } from "vue";
+import { type SpringPreset } from "../../composables/motion/spring/useSpringMount";
+import type { Backdrop, Motion, Placement, Surface } from "../_shared/axes";
+export interface DialogContentProps {
+    forceMount?: boolean;
+    disableOutsidePointerEvents?: boolean;
+    class?: HTMLAttributes["class"];
     surface?: Surface;
-    /**
-     * BI.W-DIALOG-PLACEMENT — the overlay-placement axis (Sheet FOLDED onto Dialog).
-     * `center` (default) is the byte-identical centered modal — the `.glass-reveal`
-     * bloom over the see-through `--glass-bg-dialog` rung. `top|right|bottom|left`
-     * are the edge SIDE-SLIDE (the former `<Sheet side>`): the content fixes to that
-     * viewport edge, spans the cross axis, rounds its INNER corners on the dialog rung,
-     * and slides in via the shared `sheet-animate` CSS register (byte-identical to the
-     * retired Sheet frame-series). N3: a placement != center Dialog is a NON-detented
-     * side sheet — a detented bottom sheet over a LIVE surface stays `<Drawer>` (snap
-     * physics is Drawer's mechanism, never this paint axis).
-     */
     placement?: Placement;
-    /**
-     * Optional CSS `animation` shorthand forwarded to the portaled scrim
-     * via the `--scrim-animation` typed cascade variable. reka-ui's
-     * `DialogPortal` teleports the `DialogOverlay` outside the consumer's
-     * component subtree, so a scoped `--scrim-animation` declaration on a
-     * parent of `<Dialog>` never reaches the overlay — the publisher owns
-     * the bridge.
-     *
-     * Pass a complete `animation` shorthand (e.g. `"scrim-breath 6s
-     * ease-in-out infinite"`); the rule
-     * `[data-scrim-animation] { animation: var(--scrim-animation, none) }`
-     * in `animations.css` consumes it on the portaled overlay element.
-     * Composes with the default `.sheet-animate` enter/exit (distinct
-     * selectors: `[data-state]` keys the fade, `[data-scrim-animation]`
-     * keys the breath — no cascade fight).
-     *
-     * Reduced-motion: the global `@media (prefers-reduced-motion: reduce)`
-     * bracket in `animations.css` retires the breath automatically.
-     *
-     * AJ-W4-δ.
-     */
-    scrimAnimation?: string;
-    /**
-     * BH.W-MOTION-AXIS — the ONE motion-weight axis (the `spring` boolean's clean-break
-     * successor). `full` (default) is the FULL liquid register: the default entrance is
-     * the spring-clocked `.glass-reveal` CSS bloom (byte-identical to HEAD's unset
-     * `spring`); an explicit `springPreset` opts into the JS `useSpringMount` entrance.
-     * `reduced`/`off` opt DOWN — the JS spring entrance unbinds and the `.glass-reveal`
-     * CSS floor stands (the SAME state PRM produces). PRM forces `full → reduced`
-     * regardless (a11y absolute).
-     */
     motion?: Motion;
-    /**
-     * BH.W-MOTION-AXIS — the JS spring entrance PRESET (the curve choice carved OFF the
-     * retired `spring` boolean; a distinct concern from motion INTENSITY). UNSET (default)
-     * keeps the `.glass-reveal` CSS bloom (byte-identical to HEAD's unset `spring`);
-     * naming one of `'smooth' | 'snappy' | 'bouncy' | 'gentle'` opts into the
-     * `useSpringMount` JS entrance (the W13 iOS spring-physics scale+fade). Ignored when
-     * `motion === "off"` (the CSS floor stands). PRM snaps the spring to target (no-op
-     * transform).
-     */
     springPreset?: SpringPreset;
-    /**
-     * Render the default top-right close (X) button (default `true`).
-     * Set `false` when the consumer composes its own header / dismiss control
-     * (e.g. a hand-composed access modal) so the built-in X does not
-     * double-up. The default keeps every existing mount byte-identical.
-     */
     showClose?: boolean;
-    /**
-     * Bound the dialog to the viewport and make its content the single vertical
-     * scroll owner.
-     */
     scroll?: boolean;
+    stage?: "none" | "dim" | "scale" | "immersive";
     /**
-     * BD.W-OVERLAY-STAGE-COUPLE — the scene-staging enum for the centered modal band.
-     * `none` (default — byte-identical to HEAD) leaves the page untouched; `dim`/
-     * `scale`/`immersive` flip the ONE `--stage-t` scalar 0→1 on open so the page
-     * RECEDES + SCALES behind the dialog (the iOS card-recede) and the scrim deepens.
-     * PRM degrades `scale`/`immersive` → `dim` (no page transform, fold C1·R6).
+     * The scrim backdrop axis. `scrim` (default) is byte-identical to today; `graded`
+     * swaps the flat scrim for the box-following halo. Applies to a centred dialog
+     * (the immersive stage opts in first); side sheets keep their own per-edge graded
+     * edge and ignore it.
      */
-    stage?: 'none' | 'dim' | 'scale' | 'immersive';
-};
-declare var __VLS_19: {};
+    backdrop?: Backdrop;
+}
+declare var __VLS_19: {}, __VLS_21: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_19) => any;
+} & {
+    default?: (props: typeof __VLS_21) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_base: import("vue").DefineComponent<DialogContentProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     escapeKeyDown: (event: KeyboardEvent) => any;
-    pointerDownOutside: (event: import("reka-ui").PointerDownOutsideEvent) => any;
-    focusOutside: (event: import("reka-ui").FocusOutsideEvent) => any;
-    interactOutside: (event: import("reka-ui").PointerDownOutsideEvent | import("reka-ui").FocusOutsideEvent) => any;
+    pointerDownOutside: (event: import("../_shared/interaction").PointerDownOutsideEvent) => any;
+    focusOutside: (event: import("../_shared/interaction").FocusOutsideEvent) => any;
+    interactOutside: (event: import("../_shared/interaction").PointerDownOutsideEvent | import("../_shared/interaction").FocusOutsideEvent) => any;
     openAutoFocus: (event: Event) => any;
     closeAutoFocus: (event: Event) => any;
-}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+}, string, import("vue").PublicProps, Readonly<DialogContentProps> & Readonly<{
     onEscapeKeyDown?: ((event: KeyboardEvent) => any) | undefined;
-    onPointerDownOutside?: ((event: import("reka-ui").PointerDownOutsideEvent) => any) | undefined;
-    onFocusOutside?: ((event: import("reka-ui").FocusOutsideEvent) => any) | undefined;
-    onInteractOutside?: ((event: import("reka-ui").PointerDownOutsideEvent | import("reka-ui").FocusOutsideEvent) => any) | undefined;
+    onPointerDownOutside?: ((event: import("../_shared/interaction").PointerDownOutsideEvent) => any) | undefined;
+    onFocusOutside?: ((event: import("../_shared/interaction").FocusOutsideEvent) => any) | undefined;
+    onInteractOutside?: ((event: import("../_shared/interaction").PointerDownOutsideEvent | import("../_shared/interaction").FocusOutsideEvent) => any) | undefined;
     onOpenAutoFocus?: ((event: Event) => any) | undefined;
     onCloseAutoFocus?: ((event: Event) => any) | undefined;
 }>, {
-    surface: Surface;
     scroll: boolean;
+    surface: Surface;
+    backdrop: Backdrop;
     placement: Placement;
     showClose: boolean;
     stage: "none" | "dim" | "scale" | "immersive";

package/dist/components/dialog/DialogDescription.vue.d.ts

@@ -1,13 +1,12 @@
-import { type HTMLAttributes } from 'vue';
-import { type DialogDescriptionProps } from 'reka-ui';
-type __VLS_Props = DialogDescriptionProps & {
-    class?: HTMLAttributes['class'];
-};
+import type { HTMLAttributes } from "vue";
+export interface DialogDescriptionProps {
+    class?: HTMLAttributes["class"];
+}
 declare var __VLS_8: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_8) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_base: import("vue").DefineComponent<DialogDescriptionProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<DialogDescriptionProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/dialog/DialogTitle.vue.d.ts

@@ -1,13 +1,12 @@
-import { type HTMLAttributes } from 'vue';
-import { type DialogTitleProps } from 'reka-ui';
-type __VLS_Props = DialogTitleProps & {
-    class?: HTMLAttributes['class'];
-};
+import type { HTMLAttributes } from "vue";
+export interface DialogTitleProps {
+    class?: HTMLAttributes["class"];
+}
 declare var __VLS_8: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_8) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_base: import("vue").DefineComponent<DialogTitleProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<DialogTitleProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/dialog/DialogTrigger.vue.d.ts

@@ -1,4 +1,6 @@
-import { type DialogTriggerProps } from 'reka-ui';
+import type { PrimitiveProps } from "../_shared/primitive";
+export interface DialogTriggerProps extends PrimitiveProps {
+}
 declare var __VLS_8: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_8) => any;

package/dist/components/{_shared → dialog}/ModalOverlay.vue.d.ts

@@ -1,4 +1,5 @@
 import { type HTMLAttributes } from "vue";
+import type { Backdrop } from "../_shared/axes";
 /** Canonical Dialog scrim with one enter/exit recipe and a real intensity axis. */
 interface ModalOverlayProps {
     class?: HTMLAttributes["class"];
@@ -8,23 +9,22 @@ interface ModalOverlayProps {
      */
     scrim?: "glass" | "clear" | "dim";
     /**
-     * Optional CSS `animation` shorthand applied to the portaled overlay
-     * via the `--scrim-animation` typed cascade variable. Pairs with the
-     * `[data-scrim-animation] { animation: var(--scrim-animation, none) }`
-     * rule in `animations.css` so consumers can drive a long-running
-     * scrim-breath without owning the portal traversal. Composes with the
-     * `.sheet-animate` data-state enter/exit (the fade's panel/fast base clocks
-     * co-scale through `--motion-tempo`; the scrim-breath
-     * rides the typed variable on `data-scrim-animation` — distinct
-     * selectors, no cascade fight).
-     *
-     * Example: `scrimAnimation="scrim-breath 6s ease-in-out infinite"`
-     * — pairs with a `@keyframes scrim-breath` declared at the consumer
-     * (or in `animations.css` if the rhythm is canonical).
-     *
-     * AJ-W4-δ.
+     * The backdrop axis. `scrim` (default) is today's flat full-viewport scrim,
+     * byte-identical. `graded` swaps it for ONE masked box-following halo child
+     * (`data-slot="glass-graded-halo"`) — the flat blur + dim drop and the halo is
+     * the sole plate (the `--stage-t` scrim/immersive arms are gated off in
+     * drawer/styles.css). The centred immersive Dialog opts in.
      */
-    scrimAnimation?: string;
+    backdrop?: Backdrop;
+    /**
+     * A side sheet's live slide position (0 open → 1 dismissed). When set, the scrim
+     * drops its `sheet-animate` fade keyframe and drives `opacity` off this SAME scalar
+     * so it can never desync from the surface through an interrupt. `null` (center
+     * dialog + the `off` side path) keeps the keyframe fade.
+     */
+    slideT?: number | null;
+    /** Hold the scrim mounted through the spring exit (mirrors the content forceMount). */
+    forceMount?: boolean;
 }
 declare var __VLS_8: {};
 type __VLS_Slots = {} & {
@@ -32,6 +32,8 @@ type __VLS_Slots = {} & {
 };
 declare const __VLS_base: import("vue").DefineComponent<ModalOverlayProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ModalOverlayProps> & Readonly<{}>, {
     scrim: "glass" | "clear" | "dim";
+    backdrop: Backdrop;
+    slideT: number | null;
 }, {}, {}, {}, 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/dialog/dialogStageContext.d.ts

@@ -0,0 +1,7 @@
+import type { Ref } from "vue";
+export interface DialogStageContext {
+    wrapperEl: Ref<HTMLElement | null>;
+    scrimEl: Ref<HTMLElement | null>;
+}
+export declare function provideDialogStageContext(context: DialogStageContext): void;
+export declare const useOptionalDialogStageContext: () => DialogStageContext | null;

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

@@ -1,8 +1,8 @@
-export { default as Dialog } from './Dialog.vue';
-export { default as DialogClose } from './DialogClose.vue';
-export { default as DialogTrigger } from './DialogTrigger.vue';
-export { default as DialogHeader } from './DialogHeader.vue';
-export { default as DialogTitle } from './DialogTitle.vue';
-export { default as DialogDescription } from './DialogDescription.vue';
-export { default as DialogContent } from './DialogContent.vue';
-export { default as DialogFooter } from './DialogFooter.vue';
+export { default as Dialog, type DialogProps } from "./Dialog.vue";
+export { default as DialogClose, type DialogCloseProps } from "./DialogClose.vue";
+export { default as DialogTrigger, type DialogTriggerProps } from "./DialogTrigger.vue";
+export { default as DialogHeader } from "./DialogHeader.vue";
+export { default as DialogTitle, type DialogTitleProps } from "./DialogTitle.vue";
+export { default as DialogDescription, type DialogDescriptionProps, } from "./DialogDescription.vue";
+export { default as DialogContent, type DialogContentProps } from "./DialogContent.vue";
+export { default as DialogFooter } from "./DialogFooter.vue";

package/dist/components/dialog/placement.css

@@ -1 +1 @@
-:where([data-slot="dialog-content"][data-placement]) { position: fixed; z-index: var(--z-modal); } :where([data-slot="dialog-content"][data-placement="top"]) { left: 0; right: 0; top: 0; } :where([data-slot="dialog-content"][data-placement="bottom"]) { left: 0; right: 0; bottom: 0; } :where([data-slot="dialog-content"][data-placement="left"]) { top: 0; bottom: 0; left: 0; height: 100%; width: 75%; } :where([data-slot="dialog-content"][data-placement="right"]) { top: 0; bottom: 0; right: 0; height: 100%; width: 75%; } @media (min-width: 40rem) { :where([data-slot="dialog-content"][data-placement="left"]), :where([data-slot="dialog-content"][data-placement="right"]) { max-width: 24rem; } }
+:where([data-slot="dialog-content"][data-placement]) { position: fixed; z-index: var(--z-modal); } :where( [data-slot="dialog-content"][data-placement] > [data-slot="dialog-content-region"] ) { display: grid; align-content: start; gap: 1rem; } :where( [data-slot="dialog-content"][data-placement][data-scroll] > [data-slot="dialog-content-region"] ) { min-block-size: 0; max-block-size: calc(100dvh - var(--overlay-pad-block) - var(--overlay-pad-block)); overflow-y: auto; } :where( [data-slot="dialog-content"][data-placement="left"] > [data-slot="dialog-content-region"], [data-slot="dialog-content"][data-placement="right"] > [data-slot="dialog-content-region"] ) { display: flex; flex-direction: column; block-size: 100%; min-block-size: 0; } :where( [data-slot="dialog-content"][data-placement="left"] > [data-slot="dialog-content-region"] > :only-child, [data-slot="dialog-content"][data-placement="right"] > [data-slot="dialog-content-region"] > :only-child ) { min-block-size: 0; } :where([data-slot="dialog-content"][data-placement][data-surface="glass"]) { isolation: isolate; -webkit-backdrop-filter: none; backdrop-filter: none; } :where([data-slot="dialog-content"][data-placement] > [data-slot="glass-graded-halo"]) { position: absolute; inset: 0; z-index: -1; border-radius: inherit; pointer-events: none; background: linear-gradient( var(--sheet-edge-direction), color-mix(in oklab, var(--glass-bg-overlay) 10%, transparent) 0, color-mix(in oklab, var(--glass-bg-overlay) 16%, transparent) 40px, color-mix(in oklab, var(--glass-bg-overlay) 34%, transparent) 120px, color-mix(in oklab, var(--glass-bg-overlay) 34%, transparent) 100% ); -webkit-backdrop-filter: blur(calc(34px * var(--glass-level))) saturate(var(--glass-saturate-overlay)); backdrop-filter: blur(calc(34px * var(--glass-level))) saturate(var(--glass-saturate-overlay)); mask-image: linear-gradient( var(--sheet-edge-direction), rgb(0 0 0 / 0.325) 0, rgb(0 0 0 / 0.45) 40px, black 120px, black 100% ); } :where([data-slot="dialog-content"][data-placement="top"]) > [data-slot="glass-graded-halo"] { --sheet-edge-direction: to top; } :where([data-slot="dialog-content"][data-placement="bottom"]) > [data-slot="glass-graded-halo"] { --sheet-edge-direction: to bottom; } :where([data-slot="dialog-content"][data-placement="left"]) > [data-slot="glass-graded-halo"] { --sheet-edge-direction: to left; } :where([data-slot="dialog-content"][data-placement="right"]) > [data-slot="glass-graded-halo"] { --sheet-edge-direction: to right; } :where([data-backdrop="graded"] > [data-slot="glass-graded-halo"]) { position: absolute; inset: 0; pointer-events: none; -webkit-backdrop-filter: blur(var(--glass-halo-blur)) saturate(var(--glass-saturate-overlay)); backdrop-filter: blur(var(--glass-halo-blur)) saturate(var(--glass-saturate-overlay)); background: color-mix(in oklab, var(--glass-bg-overlay) 50%, transparent); -webkit-mask-image: linear-gradient( to right, transparent calc(50% - var(--glass-halo-core) - var(--glass-halo-bloom)), black calc(50% - var(--glass-halo-core)), black calc(50% + var(--glass-halo-core)), transparent calc(50% + var(--glass-halo-core) + var(--glass-halo-bloom)) ), linear-gradient( to bottom, transparent calc(50% - var(--glass-halo-core) - var(--glass-halo-bloom)), black calc(50% - var(--glass-halo-core)), black calc(50% + var(--glass-halo-core)), transparent calc(50% + var(--glass-halo-core) + var(--glass-halo-bloom)) ); -webkit-mask-composite: source-in; mask-image: linear-gradient( to right, transparent calc(50% - var(--glass-halo-core) - var(--glass-halo-bloom)), black calc(50% - var(--glass-halo-core)), black calc(50% + var(--glass-halo-core)), transparent calc(50% + var(--glass-halo-core) + var(--glass-halo-bloom)) ), linear-gradient( to bottom, transparent calc(50% - var(--glass-halo-core) - var(--glass-halo-bloom)), black calc(50% - var(--glass-halo-core)), black calc(50% + var(--glass-halo-core)), transparent calc(50% + var(--glass-halo-core) + var(--glass-halo-bloom)) ); mask-composite: intersect; } .dark :where([data-backdrop="graded"] > [data-slot="glass-graded-halo"]) { background: color-mix(in oklab, var(--glass-bg-overlay) 40%, transparent); } @media (prefers-reduced-transparency: reduce), (forced-colors: active) { :where([data-slot="glass-graded-halo"]) { display: none; } } :where([data-slot="dialog-content"][data-placement="top"]) { left: 0; right: 0; top: 0; } :where([data-slot="dialog-content"][data-placement="bottom"]) { left: 0; right: 0; bottom: 0; } :where([data-slot="dialog-content"][data-placement="left"]) { top: 0; bottom: 0; left: 0; height: 100%; width: 75%; } :where([data-slot="dialog-content"][data-placement="right"]) { top: 0; bottom: 0; right: 0; height: 100%; width: 75%; } @media (min-width: 40rem) { :where([data-slot="dialog-content"][data-placement="left"]), :where([data-slot="dialog-content"][data-placement="right"]) { max-width: 24rem; } }

package/dist/components/dialog/sheet-motion.d.ts

@@ -0,0 +1,17 @@
+import type { Placement } from "../_shared/axes";
+/** The four slide placements (a `center` modal is the non-slide path). */
+export type SidePlacement = Exclude<Placement, "center">;
+/**
+ * The side sheet's slide as a CSS `translate` LONGHAND value ("<lp> <lp>").
+ * `p`: 0 = mounted at rest, 1 = one own-dimension offscreen along the anchored
+ * axis. This is a `translate` longhand, NOT a `transform` function —
+ * `translateX()`/`translateY()` are invalid as a `translate` value and paint
+ * nothing (R1). `p` is left unclamped so the spring's overshoot IS the settle.
+ */
+export declare function sheetSlideTransform(placement: SidePlacement, p: number): string;
+/**
+ * Scrim opacity synced to the surface position: 1 at open (p=0), 0 at dismissed
+ * (p=1). Clamped so the spring overshoot (p<0 or p>1) never pushes opacity out of
+ * [0,1]. Reads the SAME live scalar as the surface → no desync through an interrupt.
+ */
+export declare function scrimOpacity(p: number): number;

package/dist/components/dock/DockControl.vue.d.ts

@@ -1,27 +1,24 @@
 import { type ButtonHTMLAttributes, type Component, type HTMLAttributes } from "vue";
 /**
- * <DockControl> — the ONE dock control (BI.W-DOCK-CONTROLS; folds
- * `DockIconButton` + `DockTabButton` onto a `shape` axis). The dock IS
- * SegmentedTabs/ToggleGroup wearing chrome (PASS-1 §1 DOCK-D verdict), so the two
- * control components collapse to ONE with a `shape` discriminant:
+ * <DockControl> is the single dock control, with icon and tab geometry selected by
+ * a `shape` discriminant:
  *
- *   • `shape="icon"` (DEFAULT) — the fixed-square icon control (the prior
- *     `DockIconButton`): glass hover, the interruptible spring-press, the
+ *   • `shape="icon"` (default) — fixed-square icon control with glass hover,
+ *     interruptible spring press,
  *     pointer-anchored specular gleam, the selectable `active` glass-capsule seat.
- *   • `shape="tab"` — the auto-sized text-tab control (the prior `DockTabButton`):
+ *   • `shape="tab"` — auto-sized text-tab control with
  *     the de-red'd glass hover register + the pointer-following gleam.
  *
  * ONE FACE, the folded safe-inset. Both shapes read the shared `.glass-capsule`
  * face (glass/glass-capsule.css): the painted plate insets via the dock-scoped
  * `--dock-control-safe-inset` fold, while the HIT CELL stays the full
  * `--dock-control-size` (≥44px on coarse via the density clamp) — hit box ≠ paint
- * box (A11Y-5's 17×40px defect dies by construction, with W-DOCK-SPINE's L1
- * `overflow: visible` making the clip structurally absent).
+ * box. `overflow: visible` keeps the painted inset unclipped.
  *
  * Role rides the consumer: an `active` control stamps `aria-pressed` (the
  * AT-selectable semantic) + `data-active` (the CSS hook reading the
  * `--dock-control-active-bg` "selected reads as glass" tier — never a saturated
- * brand hue, per W-REGISTER-IOS). A dock built on `useSelectionGroup` threads the
+ * brand hue). A dock built on `useSelectionGroup` threads the
  * role-per-mode (radio/tab/pressed) at the group level.
  */
 type __VLS_Props = {
@@ -55,10 +52,10 @@ type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_18) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    type: "button" | "reset" | "submit";
     disabled: boolean;
-    asChild: boolean;
+    type: "button" | "reset" | "submit";
     as: string | Component;
+    asChild: boolean;
     shape: "icon" | "tab";
     compact: boolean;
     active: boolean;

package/dist/components/dock/DockCrossfade.vue.d.ts

@@ -1,22 +1,18 @@
 import { type DockFaceDescriptor } from "./composables/dockCrossfadeContext";
 /**
- * <DockCrossfade :active> — the THIN controlled face-swap core (BI.W-DOCK-CROSSFADE,
- * PASS-1 §2.6 / PASS-4B ruling 3).
+ * <DockCrossfade:active> is the thin controlled face-swap core.
  *
  * The content layer hosts ONE active face; a switch is a two-child OPACITY OVERLAP on
  * the per-face `--dock-t` scalar — driven by the ONE dock spring (`useDockSpring`,
- * velocity-continuous + interruptible), NOT a UA-eased View Transition. G6 CLOSED:
- * `startViewTransition` is non-interruptible (a hard cut on rapid re-toggle — a direct
- * violation of the liquid-weight edict) and its snapshot of a live `backdrop-filter`
- * plate over aurora is unproven (blur ghost / edge pop); the two-child crossfade needs
- * no VT and stays spring-driven. The reserved box is sized to the PEAK face as a
+ * velocity-continuous + interruptible), not a UA-eased View Transition. The reserved
+ * box is sized to the peak face as a
  * MEASURE-ONCE `min-block-size` (a running max — NOT a per-swap FLIP). A dissolving
  * focus-holding face transfers focus to its successor, else the body
  * (un-inert-before-focus is load-bearing).
  *
  * Faces register through the crossfade context (`<DockLayer>` children). Where a rail
  * exists, `useSelectionGroup` (the switcher run) drives `:active` — the composing
- * `<DockLayerGroup>` case. The controlled-no-rail 5-pane case (speedtest) consumes this
+ * `<DockLayerGroup>` case. The controlled-no-rail 5-pane case (a consumer) consumes this
  * DIRECTLY: a no-selection face-swap does NOT route through a selection engine (the
  * roving machine + indicator + selection model are all inert in that mode; don't
  * abstract them over a case that never selects).

package/dist/components/dock/DockLayer.vue.d.ts

@@ -1,9 +1,8 @@
 import type { Component } from "vue";
 /**
- * <DockLayer> — a named content pane (a "face") inside a <DockCrossfade> /
- * <DockLayerGroup>.
+ * DockLayer is a named content pane (a face) inside DockCrossfade or DockLayerGroup.
  *
- * BI.W-DOCK-CROSSFADE — the FLIP/registration engine is RETIRED. A face now does one
+ * the FLIP/registration engine is RETIRED. A face now does one
  * thing: it registers its id + label + icon + host element with the crossfade slot on
  * mount, renders its content in a `.dock-face` host, and reads its active/leaving state
  * off the context. The crossfade slot (`<DockCrossfade>`) owns the two-child opacity

package/dist/components/dock/DockLayerGroup.vue.d.ts

@@ -3,12 +3,12 @@ import type { Motion } from "../_shared/axes";
  * <DockLayerGroup> — a stack of <DockLayer> faces with an optional Figma-style
  * switcher rail built from each face's metadata.
  *
- * BI.W-DOCK-CROSSFADE — the FLIP/registration engine is RETIRED. The face-swap is now
- * ONE crossfade slot: this component COMPOSES `<DockCrossfade :active>` (the thin
+ * the FLIP/registration engine is RETIRED. The face-swap is now
+ * ONE crossfade slot: this component COMPOSES `<DockCrossfade:active>` (the thin
  * controlled core — two-child opacity overlap, peak reserve, focus-transfer) and reads
  * the registered face descriptors off it for the rail.
  *
- * BI.W-DOCK-FOLD — the switcher rail is driven by the library's ONE headless selection
+ * the switcher rail is driven by the library's ONE headless selection
  * engine `useSelectionGroup` (the dock IS SegmentedTabs/ToggleGroup wearing chrome). The
  * reka `ui/tabs` substrate + its `--reka-tabs-indicator-*` position path are DEFINITION-
  * ABSENT (retired); the rail is a plain `role="tablist"` of `role="tab"` buttons whose
@@ -19,8 +19,8 @@ import type { Motion } from "../_shared/axes";
  *
  * Usage:
  *   <DockLayerGroup v-model:active="layer">
- *     <DockLayer id="assets" label="Assets" :icon="AssetsIcon">...</DockLayer>
- *     <DockLayer id="layers" label="Layers" :icon="LayersIcon">...</DockLayer>
+ *     <DockLayer id="assets" label="Assets":icon="AssetsIcon">...</DockLayer>
+ *     <DockLayer id="layers" label="Layers":icon="LayersIcon">...</DockLayer>
  *   </DockLayerGroup>
  */
 type __VLS_Props = {
@@ -31,7 +31,7 @@ type __VLS_Props = {
     /** Rail placement relative to the face stack. */
     railPosition?: "start" | "end";
     /**
-     * BH.W-MOTION-AXIS — the ONE motion-weight axis. `full` (default) arms
+     * the ONE motion-weight axis. `full` (default) arms
      * pull-to-switch: the switcher-rail indicator is draggable — pull along the rail
      * axis to the next face chip, the fling-to-nearest on release writes `active`
      * (`useDragMorph`, consumer #2). `reduced`/`off` opt DOWN to click/keyboard-only

package/dist/components/dock/DockSeparator.vue.d.ts

@@ -1,5 +1,5 @@
 /**
- * <DockSeparator> — AX.W45 D13-c / DK5.
+ * <DockSeparator>.
  *
  * An orientation-aware divider that demarcates dock item GROUPS (transport |
  * navigation | settings) for affordance hierarchy. The raw `.dock-separator`
@@ -7,11 +7,11 @@
  * 1px-wide sliver in a column (vertical) dock and a single cell-sliver in a grid
  * dock. This primitive bundles the orientation contract the bare class could not:
  * it reads the dock `orientation`/`layout` via `useOptionalDockContext()` and the
- * dock-root ancestor class (`.glass-dock.vertical` / `.layout-grid`) drives the
+ * dock-root ancestor class (`.glass-dock.vertical`, `.layout-grid`) drives the
  * PERPENDICULAR paint (dock.css) —
  *   - row dock (horizontal, default) → a vertical 1px hairline
- *   - column dock (vertical / rail)  → a horizontal 1px rule (cross-extent)
- *   - grid dock (`layout="grid"`)     → a full-row section break (grid-column: 1 / -1)
+ *   - column dock (vertical, rail)  → a horizontal 1px rule (cross-extent)
+ *   - grid dock (`layout="grid"`)     → a full-row section break (grid-column: 1, -1)
  *
  * It is a thin oriented `<div>` (KISS); `data-orientation` is the explicit axis
  * marker (so the perpendicular paint resolves even when used inside a
@@ -23,16 +23,16 @@
  * landmark without it being interactive (it has no four-state contract — a flex
  * gap rule, not a control).
  *
- * BA.W-DOCK-SECTIONS — the `anchor` prop is the seam-locator (direction (b)): an
+ * the `anchor` prop is the seam-locator (direction (b)): an
  * anchored separator stamps `data-rail-anchor`, which the enclosing `<GlassDock>`
  * reads to seat the `#rail` line AT this divider's measured offset (the divider IS
- * the rail's anchor seam — one primitive folds R8-9's section-divider model and
- * R8-1's anchor-at-the-divider). The exposed measurable seam offset is the painted
+ * the rail's anchor seam — one primitive folds 's section-divider model and
+ * 's anchor-at-the-divider). The exposed measurable seam offset is the painted
  * position of this element within the dock-frame; GlassDock's seam read consumes it.
  */
 type __VLS_Props = {
     /**
-     * BA.W-DOCK-SECTIONS — the seam-locator affordance (direction (b): the
+     * the seam-locator affordance (direction (b): the
      * separator IS the rail's anchor). When `anchor` is set the separator stamps a
      * `data-rail-anchor` marker so the enclosing `<GlassDock>` can read THIS
      * divider's measured offset within the dock-frame and seat the `#rail` line at

package/dist/components/dock/composables/dockContext.d.ts

@@ -5,30 +5,20 @@ export type DockLayout = "linear" | "grid";
  * Dock context surfaces the dock id + orientation + held-state coordination
  * to descendants.
  *
- * O.W2 — canonical typed-key + helper-pair DI shape per invariant 25.
- * The 6 prior string-keyed provides (`glassDockContext`, `glassDockId`,
- * `dockKeepOpen`, `dockRelease`, `dockHeld`, `dockExpanded`) collapse into
- * the single `DOCK_CONTEXT_KEY` typed `InjectionKey<DockContext>`.
- * `dockExpanded` is retired (zero downstream consumers per Rδ audit).
- * `glassDockId` is dedup'd with `context.id`.
- *
+ * One typed key carries id, orientation, layout, and held-state coordination.
  * Paired helpers:
  *  - `useDockContext()` — strict; throws when used outside `<GlassDock>`.
  *  - `useOptionalDockContext()` — befitting silent default for primitives
  *    that may render outside a dock (Slider, popovers, …).
  *
- * J.W3.B — `registerPopover` / `closeOtherPopovers` retired. Hover-driven
- * dock popovers compose `<Popover trigger="hover" keep-dock-open>` (the
- * BI.W-OVERLAY-UNION sealed union; the fine-hover branch is reka's
- * HoverCardRoot). Open/close cadence is owned by reka's hover primitives;
- * cooperative dismissal between sibling popovers is no longer needed (the
- * pointer-leave timer handles the cluster transit case).
+ * Hover-driven dock popovers compose `<Popover trigger="hover" keep-dock-open>`.
+ * Reka's hover primitives own open/close cadence and cluster transit.
  */
 export interface DockContext {
     id: string;
     orientation: ComputedRef<DockOrientation>;
     /**
-     * In-cap arrangement (`linear` row/column vs `grid` tile panel). AX.W45 —
+     * In-cap arrangement (`linear` row/column vs `grid` tile panel).
      * `<DockSeparator>` reads this to paint a full-row section break in a grid dock
      * (a 1px perpendicular hairline is useless in a 2D tile grid).
      */

package/dist/components/dock/composables/dockCrossfadeContext.d.ts

@@ -1,21 +1,20 @@
 import type { Component, Ref } from "vue";
 /**
- * BI.W-DOCK-CROSSFADE — the crossfade face-registration context.
+ * the crossfade face-registration context.
  *
- * `<DockCrossfade :active>` provides this; each face host (`<DockLayer>`) registers
+ * `<DockCrossfade:active>` provides this; each face host (`<DockLayer>`) registers
  * its id + label + icon + host element on mount. The crossfade slot owns ONE face
- * registry — the registration machinery FOLDED here from the retired
- * `DockLayerGroup` `register`/`unregister` + `useLayerTransition` FLIP (PASS-1 §2.6).
+ * registry.
  * A switcher rail (where one exists — `<DockLayerGroup>`) reads `faces` for its chip
- * run; the controlled-no-rail 5-pane case (speedtest) consumes `<DockCrossfade>`
+ * run; the controlled-no-rail 5-pane case (a consumer) consumes `<DockCrossfade>`
  * DIRECTLY and reads only `activeId`/`leavingId` (no rail, no selection engine).
  *
  * The context is DISTINCT from `DockContext` (a `<DockCrossfade>` need not live inside
- * a `<GlassDock>`) and from `DockMorphContext` (the plate collapse orchestrator) — the
+ * a `<GlassDock>`) and from the plate collapse orchestrator — the
  * face crossfade is orthogonal to the box morph (the compound: a face-swap DURING a
  * simultaneous collapse rides two independent scalars — per-face `--dock-t` for the
  * opacity overlap, the inheriting `--dock-morph-t` for the plate clip). It keeps its
- * own module-local key (canonical typed-key DI, invariant 25).
+ * own module-local key (canonical typed-key DI).
  */
 export interface DockFaceDescriptor {
     id: string;