@mkbabb/glass-ui 6.0.0 → 8.0.0

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

@@ -1,11 +1,29 @@
-import { type DialogRootProps } from 'reka-ui';
+export interface DialogProps {
+    open?: boolean;
+    defaultOpen?: boolean;
+    modal?: boolean;
+    unmountOnHide?: boolean;
+    /**
+     * THE ORIGIN RECT — the surface this dialog grew out of, in viewport coordinates.
+     *
+     * A SEAM, and it is declared as one: the entrance reads it NOWHERE today, and the
+     * plate blooms from its own centre exactly as it does without it. It is here so the
+     * expandable-container fold lands `origin="element"` by wiring an entrance to a rect
+     * the root already accepts, instead of re-cutting the entrance and this signature in
+     * the same breath. It is the ONE prop-shaped hole this wave was told to leave.
+     *
+     * It carries no machinery on purpose. If the fold refuses, this prop leaves with the
+     * refusal — a hole that nothing ever fills is a hole, not an API.
+     */
+    origin?: DOMRectReadOnly | null;
+}
 declare var __VLS_8: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_8) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<DialogRootProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_base: import("vue").DefineComponent<DialogProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:open": (value: boolean) => any;
-}, string, import("vue").PublicProps, Readonly<DialogRootProps> & Readonly<{
+}, string, import("vue").PublicProps, Readonly<DialogProps> & Readonly<{
     "onUpdate:open"?: ((value: boolean) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

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

@@ -1,115 +1,48 @@
-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 { Motion, Surface } from "../_shared/axes.js";
+/**
+ * The DISMISSAL GRAMMAR — one axis, three rungs, and every "confirm dialog" and "gate"
+ * the library used to duplicate falls out of it:
+ *
+ *   free (default)  ✕ · Esc · outside   — a dialog
+ *   deliberate      Esc · outside       — a confirm
+ *   locked          rebuffs Esc AND outside — a gate
+ *
+ * The old boolean close knob folds into it, and no `Confirm*`/`Gate*` symbol is minted:
+ * destructive tone stays `<Button tone="destructive">` — named presets live in consumers.
+ */
+export type DialogDismiss = "free" | "deliberate" | "locked";
+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;
-    /**
-     * 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).
-     */
-    stage?: 'none' | 'dim' | 'scale' | 'immersive';
-};
-declare var __VLS_19: {};
+    dismiss?: DialogDismiss;
+}
+declare var __VLS_28: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_19) => any;
+    default?: (props: typeof __VLS_28) => 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.js").PointerDownOutsideEvent) => any;
+    focusOutside: (event: import("../_shared/interaction.js").FocusOutsideEvent) => any;
+    interactOutside: (event: import("../_shared/interaction.js").PointerDownOutsideEvent | import("../_shared/interaction.js").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.js").PointerDownOutsideEvent) => any) | undefined;
+    onFocusOutside?: ((event: import("../_shared/interaction.js").FocusOutsideEvent) => any) | undefined;
+    onInteractOutside?: ((event: import("../_shared/interaction.js").PointerDownOutsideEvent | import("../_shared/interaction.js").FocusOutsideEvent) => any) | undefined;
     onOpenAutoFocus?: ((event: Event) => any) | undefined;
     onCloseAutoFocus?: ((event: Event) => any) | undefined;
 }>, {
-    surface: Surface;
     scroll: boolean;
-    placement: Placement;
-    showClose: boolean;
-    stage: "none" | "dim" | "scale" | "immersive";
+    surface: Surface;
+    dismiss: DialogDismiss;
 }, {}, {}, {}, 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/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/DialogFooter.vue.d.ts

@@ -1,6 +1,6 @@
-import type { HTMLAttributes } from 'vue';
+import type { HTMLAttributes } from "vue";
 type __VLS_Props = {
-    class?: HTMLAttributes['class'];
+    class?: HTMLAttributes["class"];
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

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

@@ -1,6 +1,6 @@
-import type { HTMLAttributes } from 'vue';
+import type { HTMLAttributes } from "vue";
 type __VLS_Props = {
-    class?: HTMLAttributes['class'];
+    class?: HTMLAttributes["class"];
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

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/ModalOverlay.vue.d.ts

@@ -0,0 +1,66 @@
+import { type HTMLAttributes } from "vue";
+/**
+ * The modal scrim — DIM ONLY.
+ *
+ * The `backdrop-filter` leg is gone. It measurably BRIGHTENED the page it was meant to
+ * recede: +5.1% at the core and +31.3% below the plate in light, +76.0% in dark, because
+ * a wash blur pulls bright neighbours into every sampled pixel. A scrim that raises the
+ * luminance of what it occludes is not a scrim, and no amount of re-inking fixes a
+ * mechanism whose sign is wrong. Dimming is the whole job.
+ *
+ * The α token is NOT this component's to mint — it belongs to the scrim register, and
+ * this seat supplies measurement only.
+ *
+ * THE FOCUS VEIL IS GEOMETRY, so it is a decision the CALLER makes, not a constant.
+ * `.glass-focus-veil` (styles/glass/focus-veil.css, MOTION-CANON §5) is a centre-weighted
+ * frost mask: a fixed `--glass-focus-veil-core-x/-y` 13rem core plus a 7rem bloom, sited
+ * at `--veil-x`/`--veil-y`'s 50% rest. A CENTRED plate sits inside that core and IS the
+ * definitional focus event. A SIDE SHEET does not: the engaged surface is anchored at an
+ * edge, so an unconditional veil paints a ~640×640 frost pool in the middle of the
+ * viewport with nothing engaged inside it — the pool measured against a 384-wide sheet at
+ * the far right of a 1440 viewport. Slide-gating cannot save it either, because the sheet
+ * drives `slideT` and the centre-path plate leaves it null.
+ *
+ * So the veil takes an explicit boolean and `DialogContent` is its ONE passer. This is not
+ * the retired graded-overlay opt-in coming back — that one gated a private brightening
+ * recipe and is gone with its tokens. This selects between two geometries that both
+ * already exist and cannot both be right for one component.
+ */
+interface ModalOverlayProps {
+    class?: HTMLAttributes["class"];
+    /**
+     * The scrim's live opacity, driven off the SAME scalar its surface reads so the two
+     * can never desync through an interrupt. When set, the scrim drops its
+     * `sheet-animate` fade keyframe and takes this value instead.
+     *
+     * The scrim holds NO law of its own: a slide-dismissed surface hands it
+     * `scrimOpacity(position)` and a detented one hands it `scrimDetentOpacity(rung)`
+     * (both `sheet/motion.ts`). One knob, and the law lives with the geometry it
+     * describes rather than in the component that merely paints it.
+     */
+    opacity?: number | null;
+    /** Hold the scrim mounted through the spring exit (mirrors the content forceMount). */
+    forceMount?: boolean;
+    /**
+     * Paint the centre-weighted focus veil. TRUE only where the engaged surface sits at
+     * the veil's own centre — i.e. the centred modal. An edge-anchored surface passes
+     * nothing and gets the dim alone.
+     */
+    veil?: boolean;
+}
+declare var __VLS_8: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_8) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<ModalOverlayProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ModalOverlayProps> & Readonly<{}>, {
+    opacity: number | null;
+    veil: boolean;
+}, {}, {}, {}, 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;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -1,8 +1,7 @@
-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.js";
+export { default as DialogContent, type DialogContentProps, type DialogDismiss, } from "./DialogContent.vue.js";
+export { default as DialogHeader } from "./DialogHeader.vue.js";
+export { default as DialogTitle, type DialogTitleProps } from "./DialogTitle.vue.js";
+export { default as DialogDescription, type DialogDescriptionProps, } from "./DialogDescription.vue.js";
+export { default as DialogFooter } from "./DialogFooter.vue.js";
+export { DialogTrigger, DialogClose } from "reka-ui";

package/dist/components/dialog/styles.css

@@ -0,0 +1 @@
+:where([data-slot="dialog-content"]){border-radius: var(--radius-3xl);display: grid;gap: var(--space-body);inline-size: min(100% - 2 * var(--space-section),32rem);padding-inline: var(--space-family);padding-block: var(--space-family);translate: -50% -50%;}:where([data-slot="dialog-header"]){display: flex;flex-direction: column;gap: var(--space-atom);text-align: start;}:where([data-slot="dialog-content"]:has([data-slot="dialog-close"])) :where([data-slot="dialog-header"]){padding-inline-end: calc(var(--touch-target) + var(--space-atom));}:where([data-slot="dialog-title"]){font-size: calc(var(--type-body) * 1.272);line-height: var(--type-leading-body);letter-spacing: var(--type-tracking-tight);}:where([data-slot="dialog-description"]){font-size: var(--type-body);line-height: var(--type-leading-body);color: var(--foreground);}:where([data-slot="dialog-footer"]){display: flex;flex-direction: row;justify-content: flex-end;gap: var(--space-body);}:where([data-slot="dialog-close"]){position: absolute;inset-block-start: var(--space-family);inset-inline-end: var(--space-family);display: inline-flex;align-items: center;justify-content: center;inline-size: var(--touch-target);block-size: var(--touch-target);border-radius: var(--radius-pill);color: var(--foreground);cursor: pointer;isolation: isolate;}:where([data-slot="dialog-close"])::before{content: "";position: absolute;inset: 0;z-index: -1;border-radius: inherit;background: transparent;transition: background-color var(--spring-press-duration) var(--spring-press),scale var(--spring-press-duration) var(--spring-press);}@media (hover: hover){:where([data-slot="dialog-close"]):hover::before{background: color-mix(in oklab,var(--foreground) 5%,transparent);scale: var(--scale-hover);}}:where([data-slot="dialog-close"]):active::before{background: color-mix(in oklab,var(--foreground) 12%,transparent);scale: var(--scale-press);}:where([data-slot="dialog-close"]):focus-visible{outline: 2px solid color-mix(in oklab,var(--foreground) 48%,transparent);outline-offset: 2px;}@property --rebuff-x{syntax: "<length>";inherits: false;initial-value: 0px;}@keyframes glass-dialog-rebuff-a{0%{--rebuff-x: 0px;}22%{--rebuff-x: -4px;}48%{--rebuff-x: 3px;}72%{--rebuff-x: -1.6px;}88%{--rebuff-x: 0.6px;}100%{--rebuff-x: 0px;}}@keyframes glass-dialog-rebuff-b{0%{--rebuff-x: 0px;}22%{--rebuff-x: -4px;}48%{--rebuff-x: 3px;}72%{--rebuff-x: -1.6px;}88%{--rebuff-x: 0.6px;}100%{--rebuff-x: 0px;}}:where([data-slot="dialog-content"][data-rebuff]){translate: calc(-50% + var(--rebuff-x)) -50%;}:where([data-slot="dialog-content"][data-rebuff="a"]){animation: glass-dialog-rebuff-a var(--spring-press-duration) var(--spring-press);}:where([data-slot="dialog-content"][data-rebuff="b"]){animation: glass-dialog-rebuff-b var(--spring-press-duration) var(--spring-press);}@keyframes glass-dialog-rebuff-flash{0%,100%{outline-color: transparent;}50%{outline-color: color-mix(in oklab,var(--foreground) 48%,transparent);}}@media (prefers-reduced-motion: reduce){:where([data-slot="dialog-content"][data-rebuff]){outline: 2px solid transparent;outline-offset: 0;animation: glass-dialog-rebuff-flash var(--spring-press-duration) linear;}}

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 = {
@@ -33,15 +30,19 @@ type __VLS_Props = {
     /** Compact icon variant: auto-sized instead of fixed square (icon shape). */
     compact?: boolean;
     /**
-     * Selected/toggled state. Stamps `aria-pressed` + `data-active`; the icon
-     * shape composes the `.glass-capsule` selected seat.
+     * Toggle state — a THREE-state discriminant. Unset ⇒ nav mode (no
+     * `aria-pressed`); `false` ⇒ off-state toggle (`aria-pressed="false"`);
+     * `true` ⇒ on (`aria-pressed="true"` + `data-active` + the `.glass-capsule`
+     * selected seat, both truthy-gated).
      */
     active?: boolean;
     /** Button type (default "button" to prevent form submission). */
     type?: ButtonHTMLAttributes["type"];
     /**
      * Disabled state (the four-state contract). A boundary nav control stays
-     * PRESENT but disabled so the row geometry holds, never DOM-absent.
+     * PRESENT-but-disabled — FOCUSABLE via `aria-disabled` (never the native
+     * `disabled` stamp that drops it from the tab order), with activation
+     * suppressed — so the row geometry holds and AT can still discover it.
      */
     disabled?: boolean;
     /** Host tag/component (reka-ui Primitive `as`; default "button"). */
@@ -57,8 +58,8 @@ type __VLS_Slots = {} & {
 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;
     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";
+import { type DockFaceDescriptor } from "./composables/dockCrossfadeContext.js";
 /**
- * <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
+ * Faces register through the crossfade context (`<DockLayer>` children). Where a switcher
  * 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-switcher 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
@@ -13,7 +12,7 @@ import type { Component } from "vue";
 type __VLS_Props = {
     /** Stable identifier — referenced by the crossfade's `active` id. */
     id: string;
-    /** Human-readable label; used for tooltip + the switcher rail glyph. */
+    /** Human-readable label; used for tooltip + the switcher glyph. */
     label?: string;
     /** Optional icon: a Vue component, or a raw string (rendered as text). */
     icon?: Component | string;

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

@@ -1,17 +1,17 @@
-import type { Motion } from "../_shared/axes";
+import type { Motion } from "../_shared/axes.js";
 /**
  * <DockLayerGroup> — a stack of <DockLayer> faces with an optional Figma-style
- * switcher rail built from each face's metadata.
+ * switcher 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.
+ * the registered face descriptors off it for the switcher.
  *
- * BI.W-DOCK-FOLD — the switcher rail is driven by the library's ONE headless selection
+ * the switcher 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
+ * ABSENT (retired); the switcher is a plain `role="tablist"` of `role="tab"` buttons whose
  * roving focus (Arrow/Home/End), role-per-mode ARIA, and the ONE traveling-indicator
  * writer (`useSelectionIndicator`, Safari-identical by construction) come from the engine.
  * Selecting a tab writes the SAME `activeLayer` the crossfade slot reads — one registry,
@@ -19,20 +19,20 @@ 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 = {
-    /** Layout axis; matches `GlassDock.orientation`. Drives the rail + face axis. */
+    /** Layout axis; matches `GlassDock.orientation`. Drives the switcher + face axis. */
     orientation?: "horizontal" | "vertical";
-    /** Render the embedded switcher rail. Hidden when there is 0 or 1 face. */
-    showRail?: boolean;
-    /** Rail placement relative to the face stack. */
-    railPosition?: "start" | "end";
+    /** Render the embedded switcher. Hidden when there is 0 or 1 face. */
+    showSwitcher?: boolean;
+    /** Switcher placement relative to the face stack. */
+    switcherPosition?: "start" | "end";
     /**
-     * BH.W-MOTION-AXIS — the ONE motion-weight axis. `full` (default) arms
-     * pull-to-switch: the switcher-rail indicator is draggable — pull along the rail
+     * the ONE motion-weight axis. `full` (default) arms
+     * pull-to-switch: the switcher indicator is draggable — pull along the switcher
      * 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
      * (the roving tabindex + Arrow keys stay). PRM forces `full → reduced`.
@@ -52,8 +52,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:active"?: ((value: string) => any) | undefined;
 }>, {
-    showRail: boolean;
-    railPosition: "start" | "end";
+    showSwitcher: boolean;
+    switcherPosition: "start" | "end";
 }, {}, {}, {}, 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/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)
+ *   - row dock (horizontal, default) → a vertical 1px rule
+ *   - column dock (vertical)         → a horizontal 1px rule
+ *   - 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,24 +23,29 @@
  * 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
- * 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
- * position of this element within the dock-frame; GlassDock's seam read consumes it.
+ * `anchor` promotes this separator to THE HAIRLINE — the line ARCHAEOLOGY E29
+ * records the owner asking for ≥2×: a hairline that sits INSIDE the horizontal or
+ * vertical dock. It is the same primitive and
+ * the same one `--dock-hairline` colour; what changes is the SPAN — the anchored
+ * form stretches across the cross extent of its LAYOUT ROOT instead of floating at
+ * `--dock-separator-height` with a gap either side. The layout root is a `.glass-dock`
+ * or a `<DockLayerGroup>` on its own (both arms are in layer-group.css, and the group
+ * is a root here exactly as it is for every other rule in that partial). With neither
+ * ancestor there is no cross extent to span and the anchored form paints as the plain
+ * divider — the same befitting-silent standalone render, stated rather than promised.
+ *
+ * [BK #72] Until this cut `anchor` stamped a marker attribute and a modifier class
+ * for a slot that existed in no file, and both
+ * markers were read by exactly zero selectors and zero code — a prop that did
+ * nothing. It does something now. A dock takes at most one hairline (one line across
+ * a dock is the point of it); nothing enforces that but nothing needs to.
  */
 type __VLS_Props = {
     /**
-     * BA.W-DOCK-SECTIONS — 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
-     * it (the divider and the rail unify into one primitive — the user's "where the
-     * dividing line is"). NO geometry side-effect on the separator itself; it is the
-     * SAME thin oriented hairline either way, just flagged as the rail's seam. A
-     * dock with at most one anchored separator is the contract (the first marked
-     * wins; the rail reads one seam offset).
+     * Promote this separator to the dock hairline: one 1px rule spanning the
+     * cross extent of its layout root — a `.glass-dock` or a standalone
+     * `<DockLayerGroup>` — in a row OR a column. Off by default: the plain
+     * separator is the short group divider.
      */
     anchor?: boolean;
 };

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

@@ -1,4 +1,4 @@
-import { type DockProps } from "./composables/useDockShellProps";
+import { type DockProps } from "./composables/useDockShellProps.js";
 declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_7: {}, __VLS_9: {};
 type __VLS_Slots = {} & {
     persistent?: (props: typeof __VLS_1) => any;
@@ -15,14 +15,14 @@ declare const __VLS_base: import("vue").DefineComponent<DockProps, {
     expanded: import("vue").Ref<boolean, boolean>;
     isPinned: import("vue").Ref<boolean, boolean>;
     isHeld: import("vue").ComputedRef<boolean>;
+    graspHeld: import("vue").ComputedRef<boolean>;
     isTransitioning: import("vue").Ref<boolean, boolean>;
     expand: () => void;
     collapse: () => void;
-    keepOpen: () => void;
-    release: () => void;
+    keepOpen: (kind?: import("./composables/dockContext.js").DockHoldKind) => void;
+    release: (kind?: import("./composables/dockContext.js").DockHoldKind) => void;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<DockProps> & Readonly<{}>, {
     backdropMode: import(".").DockBackdropMode;
-    autoLuminance: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;