@mkbabb/glass-ui 7.0.0 → 9.0.0

package/dist/components/deck/window.d.ts

@@ -0,0 +1,27 @@
+/** Which window a recompute is allowed to choose. */
+export type SequenceWindowPolicy = "recentre" | "nudge";
+export interface SequenceWindowOptions {
+    /** The window start the caller is coming FROM (the `"nudge"` policy's anchor). */
+    from?: number;
+    /** Default `"recentre"`. */
+    policy?: SequenceWindowPolicy;
+}
+export interface SequenceWindow {
+    /** The 0-based member indices inside the window, in order. */
+    shown: number[];
+    /** The window's first index — the FLIP delta is a difference of these. */
+    start: number;
+    /** Members exist before the window (a dimmed leading edge cue). */
+    clippedStart: boolean;
+    /** Members exist after the window (a dimmed trailing edge cue). */
+    clippedEnd: boolean;
+}
+/**
+ * The window of members around `active`.
+ *
+ * @param total   the member count
+ * @param active  the active 0-based index
+ * @param fit     how many members the window holds
+ * @param options the policy + the window the caller is coming from
+ */
+export declare function sequenceWindow(total: number, active: number, fit: number, options?: SequenceWindowOptions): SequenceWindow;

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

@@ -3,6 +3,19 @@ export interface DialogProps {
     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 = {} & {

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

@@ -1,52 +1,48 @@
 import { type HTMLAttributes } from "vue";
-import { type SpringPreset } from "../../composables/motion/spring/useSpringMount";
-import type { Backdrop, Motion, Placement, Surface } from "../_shared/axes";
+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;
-    placement?: Placement;
     motion?: Motion;
-    springPreset?: SpringPreset;
-    showClose?: boolean;
     scroll?: boolean;
-    stage?: "none" | "dim" | "scale" | "immersive";
-    /**
-     * 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.
-     */
-    backdrop?: Backdrop;
+    dismiss?: DialogDismiss;
 }
-declare var __VLS_19: {}, __VLS_21: {};
+declare var __VLS_28: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_19) => any;
-} & {
-    default?: (props: typeof __VLS_21) => any;
+    default?: (props: typeof __VLS_28) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<DialogContentProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     escapeKeyDown: (event: KeyboardEvent) => 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;
+    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<DialogContentProps> & Readonly<{
     onEscapeKeyDown?: ((event: KeyboardEvent) => 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;
+    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;
 }>, {
     scroll: boolean;
     surface: Surface;
-    backdrop: Backdrop;
-    placement: Placement;
-    showClose: boolean;
-    stage: "none" | "dim" | "scale" | "immersive";
+    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/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/ModalOverlay.vue.d.ts

@@ -1,39 +1,60 @@
 import { type HTMLAttributes } from "vue";
-import type { Backdrop } from "../_shared/axes";
-/** Canonical Dialog scrim with one enter/exit recipe and a real intensity axis. */
+/**
+ * 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"];
     /**
-     * Scrim intensity. `glass` reads `--overlay-scrim`; `clear` reads
-     * `--overlay-scrim-subtle`; `dim` reads `--overlay-scrim-strong`.
+     * 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.
      */
-    scrim?: "glass" | "clear" | "dim";
-    /**
-     * 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.
-     */
-    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;
+    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<{}>, {
-    scrim: "glass" | "clear" | "dim";
-    backdrop: Backdrop;
-    slideT: number | null;
+    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;

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

@@ -1,8 +1,7 @@
-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";
+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

@@ -30,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"). */
@@ -52,8 +56,8 @@ 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<{}>, {
-    disabled: boolean;
     type: "button" | "reset" | "submit";
+    disabled: boolean;
     as: string | Component;
     asChild: boolean;
     shape: "icon" | "tab";

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

@@ -1,4 +1,4 @@
-import { type DockFaceDescriptor } from "./composables/dockCrossfadeContext";
+import { type DockFaceDescriptor } from "./composables/dockCrossfadeContext.js";
 /**
  * <DockCrossfade:active> is the thin controlled face-swap core.
  *
@@ -10,9 +10,9 @@ import { type DockFaceDescriptor } from "./composables/dockCrossfadeContext";
  * 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 (a consumer) 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

@@ -12,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.
  *
  * 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.
  *
- * 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,
@@ -24,15 +24,15 @@ import type { Motion } from "../_shared/axes";
  *   </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";
     /**
      * the ONE motion-weight axis. `full` (default) arms
-     * pull-to-switch: the switcher-rail indicator is draggable — pull along the rail
+     * 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

@@ -6,12 +6,11 @@
  * class was axis-blind — a fixed VERTICAL 1px hairline that paints a useless
  * 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
+ * it reads the dock `orientation` via `useOptionalDockContext()` and the
+ * dock-root ancestor class (`.glass-dock.vertical`) 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
  *
  * 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 +22,29 @@
  * landmark without it being interactive (it has no four-state contract — a flex
  * gap rule, not a control).
  *
- * 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 '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.
+ * `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 = {
     /**
-     * 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,15 @@ 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<{}>, {
+    collapse: import(".").DockCollapse;
     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;

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

@@ -1,11 +1,25 @@
 import type { ComputedRef } from "vue";
 export type DockOrientation = "horizontal" | "vertical";
-export type DockLayout = "linear" | "grid";
+/**
+ * What KIND of hold a token is. The two are different facts about the dock and
+ * only one of them is a hand:
+ *
+ *  - `"morph"` (the default) — POSTURE only. "Something is open and the dock must
+ *    not idle-collapse under it": an armed search field, an open popover, a
+ *    focused switcher tab. It suppresses the collapse timer and nothing else. It is
+ *    NOT a hand, and it never engages the grasp optic (glass/grasp.css) — a
+ *    search field left open for a minute is not a minute-long touch.
+ *  - `"grasp"` — a live POINTER HOLD on a descendant control (`useDockHold`'s
+ *    acquire, driven by native `pointerdown`/`touchstart` on the resolved host).
+ *    A grasp IMPLIES a morph hold (a finger down must also hold the dock open),
+ *    so it takes both counts; it is the edge the material answers.
+ */
+export type DockHoldKind = "morph" | "grasp";
 /**
  * Dock context surfaces the dock id + orientation + held-state coordination
  * to descendants.
  *
- * One typed key carries id, orientation, layout, and held-state coordination.
+ * One typed key carries id, orientation, and held-state coordination.
  * Paired helpers:
  *  - `useDockContext()` — strict; throws when used outside `<GlassDock>`.
  *  - `useOptionalDockContext()` — befitting silent default for primitives
@@ -18,16 +32,19 @@ export interface DockContext {
     id: string;
     orientation: ComputedRef<DockOrientation>;
     /**
-     * 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).
+     * Acquire a hold token; suppresses timer-based collapse. `kind` defaults to
+     * `"morph"` (posture only). Pass `"grasp"` for a live pointer hold — it takes
+     * BOTH counts, so a grasp also holds the dock open.
+     */
+    keepOpen: (kind?: DockHoldKind) => void;
+    /** Release a previously-acquired token of the SAME `kind` that took it. */
+    release: (kind?: DockHoldKind) => void;
+    /**
+     * Reactive GRASP edge — `true` while ≥1 pointer hold is live on a descendant.
+     * This is what the dock root reflects as `data-held` and what the grasp
+     * register answers; it is deliberately NOT the morph-hold count (an open
+     * popover is not a finger).
      */
-    layout: ComputedRef<DockLayout>;
-    /** Acquire a keep-open token; suppresses timer-based collapse. */
-    keepOpen: () => void;
-    /** Release a previously-acquired keep-open token. */
-    release: () => void;
-    /** Reactive `keepOpenCount > 0` flag; descendants reflect via `data-held`. */
     held: ComputedRef<boolean>;
 }
 export declare const DOCK_CONTEXT_KEY: import("vue").InjectionKey<DockContext>;

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

@@ -5,9 +5,9 @@ import type { Component, Ref } from "vue";
  * `<DockCrossfade:active>` provides this; each face host (`<DockLayer>`) registers
  * its id + label + icon + host element on mount. The crossfade slot owns ONE face
  * registry.
- * A switcher rail (where one exists — `<DockLayerGroup>`) reads `faces` for its chip
- * run; the controlled-no-rail 5-pane case (a consumer) consumes `<DockCrossfade>`
- * DIRECTLY and reads only `activeId`/`leavingId` (no rail, no selection engine).
+ * A switcher (where one exists — `<DockLayerGroup>`) reads `faces` for its chip
+ * run; the controlled-no-switcher 5-pane case (a consumer) consumes `<DockCrossfade>`
+ * DIRECTLY and reads only `activeId`/`leavingId` (no switcher, no selection engine).
  *
  * The context is DISTINCT from `DockContext` (a `<DockCrossfade>` need not live inside
  * a `<GlassDock>`) and from the plate collapse orchestrator — the
@@ -42,8 +42,8 @@ export interface DockCrossfadeContext {
     /** The face currently dissolving out, or `null`. READ-ONLY to faces. */
     leavingId: Readonly<Ref<string | null>>;
     /**
-     * The registered face descriptors in registration order — the switcher rail's
-     * chip source (a `<DockLayerGroup>` reads this; the controlled-no-rail case
+     * The registered face descriptors in registration order — the switcher's
+     * chip source (a `<DockLayerGroup>` reads this; the controlled-no-switcher case
      * ignores it).
      */
     faces: Readonly<Ref<DockFaceDescriptor[]>>;

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

@@ -1,5 +1,4 @@
 import { type Ref } from "vue";
-export declare function getSize(el: HTMLElement, axis: "horizontal" | "vertical"): number;
 export interface UseDockExpandedSizeOptions {
     rootEl: Ref<HTMLElement | null>;
     contentEl: Ref<HTMLElement | null>;

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

@@ -0,0 +1,29 @@
+import type { Ref } from "vue";
+/**
+ * The dock switcher tablist context.
+ *
+ * `<DockLayerGroup>` provides it so a `<DockLayer>` face can complete the APG
+ * tablist↔tabpanel linkage: the switcher's `role="tab"` buttons `aria-controls` a face,
+ * and each face is the matching `role="tabpanel"` with a stable `id` +
+ * `aria-labelledby` back to its tab. The id derivation lives HERE (once), keyed off a
+ * group-level uid, so the tab side (`DockLayerGroup`) and the panel side (`DockLayer`)
+ * mint the SAME strings with no shared literal.
+ *
+ * `isTablist` is reactive because the switcher only renders as a tablist when it actually
+ * paints (`showSwitcher && >1 face`) — that is not known until faces register. A face
+ * reads it to decide whether to BECOME a tabpanel: absent (the controlled-no-switcher
+ * `<DockCrossfade>` case, or a 0/1-face group), the face carries no panel role, so a
+ * dangling `aria-labelledby` to a tab that does not exist is never minted.
+ */
+export interface DockSwitcherContext {
+    /** True while the switcher renders as an APG tablist (`showSwitcher && >1 face`). */
+    isTablist: Readonly<Ref<boolean>>;
+    /** The switcher tab button's id for a face id — the panel's `aria-labelledby` target. */
+    tabId: (faceId: string) => string;
+    /** The face panel's id for a face id — the tab's `aria-controls` target. */
+    panelId: (faceId: string) => string;
+}
+export declare const DOCK_SWITCHER_KEY: import("vue").InjectionKey<DockSwitcherContext>;
+export declare function provideDockSwitcherContext(context: DockSwitcherContext): void;
+/** Befitting-silent — `null` when a face is not inside a tablist switcher. */
+export declare const useDockSwitcherContext: () => DockSwitcherContext | null;

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

@@ -1,10 +1,10 @@
-export { useDockState } from "./useDockState";
-export type { UseDockStateOptions, UseDockStateReturn, DockState } from "./useDockState";
-export { useDockSearch } from "./useDockSearch";
-export type { UseDockSearchOptions, UseDockSearchReturn } from "./useDockSearch";
-export { useDockHold } from "./useDockHold";
-export type { UseDockHoldOptions, UseDockHoldReturn } from "./useDockHold";
-export { isTeleportedTarget } from "./isTeleportedTarget";
-export { provideDockContext, useDockContext, useOptionalDockContext, DOCK_CONTEXT_KEY, type DockContext, type DockOrientation, } from "./dockContext";
-export { provideDockCrossfadeContext, useDockCrossfadeContext, useOptionalDockCrossfadeContext, DOCK_CROSSFADE_KEY, type DockFaceDescriptor, type DockFaceRegistration, type DockCrossfadeContext, } from "./dockCrossfadeContext";
-export { useDockMorphOrchestrator, type UseDockMorphOrchestratorOptions, type UseDockMorphOrchestratorReturn, } from "./useDockMorph";
+export { useDockState } from "./useDockState.js";
+export type { UseDockStateOptions, UseDockStateReturn, DockState } from "./useDockState.js";
+export { useDockSearch } from "./useDockSearch.js";
+export type { UseDockSearchOptions, UseDockSearchReturn } from "./useDockSearch.js";
+export { useDockHold } from "./useDockHold.js";
+export type { UseDockHoldOptions, UseDockHoldReturn } from "./useDockHold.js";
+export { isTeleportedTarget } from "../../_shared/overlay/isTeleportedTarget.js";
+export { provideDockContext, useDockContext, useOptionalDockContext, DOCK_CONTEXT_KEY, type DockContext, type DockOrientation, } from "./dockContext.js";
+export { provideDockCrossfadeContext, useDockCrossfadeContext, useOptionalDockCrossfadeContext, DOCK_CROSSFADE_KEY, type DockFaceDescriptor, type DockFaceRegistration, type DockCrossfadeContext, } from "./dockCrossfadeContext.js";
+export { useDockMorphOrchestrator, type UseDockMorphOrchestratorOptions, type UseDockMorphOrchestratorReturn, } from "./useDockMorph.js";