@mkbabb/glass-ui 7.0.0 → 8.0.0

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

@@ -9,9 +9,9 @@
  * it reads the dock `orientation`/`layout` via `useOptionalDockContext()` and 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).
  *
- * 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,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;

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

@@ -1,6 +1,21 @@
 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.
@@ -23,11 +38,20 @@ export interface DockContext {
      * (a 1px perpendicular hairline is useless in a 2D tile grid).
      */
     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`. */
+    /**
+     * 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).
+     */
     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";

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

@@ -1,4 +1,4 @@
-import type { ComputedRef } from "vue";
+import type { Ref } from "vue";
 /**
  * Host-native dock hold.
  *
@@ -8,6 +8,14 @@ import type { ComputedRef } from "vue";
  * dock's `held` edge lights `data-held` on the dock root AND the control for the
  * thumb-halo intensification.
  *
+ * THIS ACQUIRE IS THE HAND. It is the only path in the library driven by an actual
+ * pointer going down, so it is the one the GRASP register (glass/grasp.css) is
+ * sourced from: the token it takes is `keepOpen("grasp")`, which lights the dock's
+ * `held` edge as well as holding posture. The returned `isHeld` is this host's OWN
+ * live-hold flag — it flips with the finger whether or not a dock is present, so a
+ * STANDALONE control engages on its own drag and a control inside a dock does NOT
+ * co-engage off a sibling's hold.
+ *
  * Why NATIVE host listeners (not a Vue `@pointerdown` template binding):
  * reka-ui's `<SliderRoot>` is a FORWARDING component — it renders through a
  * `CollectionSlot` + `resolveDynamicComponent` (SliderHorizontal/Vertical) +
@@ -33,9 +41,11 @@ import type { ComputedRef } from "vue";
  * hold path, no parallel `touchGate` watch).
  *
  * DI: consumes the EXISTING typed `DockContext` via `useOptionalDockContext()`
- * through the `keepOpen` and `release` pair. A control
- * rendered OUTSIDE a `<GlassDock>` gets the befitting-silent default (no dock) —
- * every hook is a no-op, a primitive may legitimately render outside a dock.
+ * through the `keepOpen` and `release` pair. A control rendered OUTSIDE a
+ * `<GlassDock>` gets the befitting-silent default (no dock) — the DOCK half is a
+ * no-op, a primitive may legitimately render outside a dock. The HAND half is not
+ * conditional on it: the returned edge tracks the pointer either way, which is what
+ * lets a standalone `<Slider>` grasp.
  */
 export interface UseDockHoldOptions {
     /**
@@ -46,8 +56,13 @@ export interface UseDockHoldOptions {
     enabled?: () => boolean;
 }
 export interface UseDockHoldReturn {
-    /** `true` whenever the dock observes ≥1 held token (the `data-held` edge). */
-    isHeld: ComputedRef<boolean> | undefined;
+    /**
+     * `true` while THIS host's own pointer hold is live — from the native
+     * `pointerdown`/`touchstart` acquire to the window-scoped release. Dock-free by
+     * construction: a control outside a `<GlassDock>` still reports its own hand,
+     * and a control inside one never reports a sibling's.
+     */
+    isHeld: Ref<boolean>;
 }
 /**
  * @param resolveHost A getter that resolves the REAL host element to attach the

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

@@ -1,10 +1,10 @@
 import { type MaybeRefOrGetter, type Ref } from "vue";
-import type { UseDockStateReturn } from "./useDockState";
-import { type FuzzySearchState, type SearchableItem, type SearchResult } from "../../search/composables";
-import { type UseScrollChromeReturn } from "../../../composables/motion/scroll/useScrollChrome";
+import type { UseDockStateReturn } from "./useDockState.js";
+import { type FuzzySearchState, type SearchableItem, type SearchResult } from "../../search/composables/index.js";
+import { type UseScrollChromeReturn } from "../../../composables/motion/scroll/useScrollChrome.js";
 export interface UseDockSearchOptions<T extends SearchableItem = SearchableItem> {
     /** Composes the existing dock state machine (no fork) — `armSearch`/`disarmSearch`
-        ride its `onClickCollapsed`/`keepOpen`/`release`. */
+        ride its `expand`/`keepOpen`/`release`. */
     dockState: UseDockStateReturn;
     /**
      * The search items (sync) — a static array or a getter. Drives the composed
@@ -57,7 +57,7 @@ export interface UseDockSearchReturn<T extends SearchableItem = SearchableItem>
     autocompleteText: Ref<string>;
     /** The optional collapse-on-scroll machine (null when `collapseOnScroll` is false). */
     scrollChrome: UseScrollChromeReturn | null;
-    /** Tap/focus → expand + hold (composes `onClickCollapsed` + `keepOpen`). */
+    /** Tap/focus → expand + hold (composes `expand()` + `keepOpen()`). */
     armSearch: () => void;
     /** Close → release the hold (composes `release`) + close the fuzzy surface. */
     disarmSearch: () => void;

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

@@ -9,6 +9,11 @@ export type DockInteraction = "auto" | "manual";
  */
 export interface DockProps {
     fitContent?: boolean;
+    /**
+     * Positioning register: `"inline"` (default) participates in normal flow;
+     * `"fixed"` pins the dock centred to the viewport bottom; `"sticky"` rides
+     * the `.dock-sticky` register.
+     */
     position?: "fixed" | "inline" | "sticky";
     /**
      * Backdrop material mode. `"live"` (default) samples and filters the painted
@@ -27,7 +32,9 @@ export interface DockProps {
     /**
      * Corner treatment.
      *   `"pill"`    — the stadium silhouette (default).
-     *   `"rounded"` — a finite rounded radius (`--radius-xl`).
+     *   `"rounded"` — the finite CARD-role corner (`--radius-card`): a plate
+     *                 silhouette, distinct from both the stadium and the big-dock
+     *                 shell. Bound to the role, never to a literal rung.
      *   `"card"`    — a finite concentric big-dock shell
      *                 radius (`--dock-card-radius`, default `--radius-3xl`)
      *                 ABOVE 2xl, below pill — does NOT collapse to a stadium.
@@ -79,34 +86,13 @@ export interface DockProps {
      * dock's inline axis reads `.dock-scroll-x` unconditionally (the CSS
      * `overflow-x: auto` scrolls ONLY when the row exceeds
      * `--dock-max-inline-size`; under the cap nothing scrolls), and a vertical
-     * rail's block axis scrolls via the unconditional cap-derived shell rule
+     * vertical dock's block axis scrolls via the unconditional cap-derived shell rule
      * (`--dock-max-block-size` is the sole knob). No prop, no unreachable
      * controls.
      */
     overflow?: "grow" | "wrap";
     /**
-     * When set, the dock root establishes an inline-size container query
-     * subject (`container-type: inline-size; container-name: <value>`) so
-     * descendants can query the named container via `@container <value>
-     * (...)` rules. ORTHOGONAL to the `overflow` clip: opting into a
-     * container subject does not change the dock's clip shell; use
-     * `overflow="wrap"` for multi-line content.
-     *
-     * Always-expanded only: `container-type: inline-size`
-     * clamps the box to its contained intrinsic size, so on a COLLAPSIBLE
-     * dock the collapse↔expand FLIP measures collapsed→collapsed and the
-     * morph FREEZES. A collapsible dock that needs deterministic targeting
-     * uses a plain `data-testid` (no layout side-effect).
-     */
-    containerName?: string;
-    /**
-     * Opt this dock into a consumer-owned shared-element View Transition. Leave
-     * unset for ordinary route transitions so the dock remains in the root
-     * snapshot rather than becoming a separate backdrop-filter snapshot.
-     */
-    viewTransitionName?: string;
-    /**
-     * Idle-collapse delay in ms (default 2000). Inert on an always-expanded dock.
+     * Idle-collapse delay in ms (default 3600). Inert on an always-expanded dock.
      */
     collapseDelay?: number;
     /**
@@ -142,15 +128,6 @@ export interface DockProps {
      * auto-implication of `shape`).
      */
     layout?: "linear" | "grid";
-    /**
-     * The sampled-luminance observer dynamically refines the declarative bright-
-     * backdrop tint. Default `true` because docks commonly sit over live fields.
-     * It refines the material floor; a
-     * dark-substrate consumer opts out with `:auto-luminance="false"` (or
-     * `--glass-tint-strength: 0%` on the dock). The observer is rAF-throttled ≤ 4 Hz,
-     * IntersectionObserver-gated, and parks under `prefers-reduced-motion: reduce`.
-     */
-    autoLuminance?: boolean;
     /**
      * The KNOWN background-layer canvas the dock floats over (an aurora/blob
      * `<canvas>`) — an element, a getter, or a CSS selector. When present, the
@@ -168,7 +145,6 @@ export interface DockProps {
 }
 /** The resolved shell-prop computeds the GlassDock SFC binds. */
 export interface DockShellProps {
-    containerStyle: ComputedRef<Record<string, string> | undefined>;
     collapseDelay: ComputedRef<number>;
     startCollapsed: ComputedRef<boolean>;
     interaction: ComputedRef<DockInteraction>;

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

@@ -1,5 +1,6 @@
 import type { ComputedRef, Ref } from "vue";
-import type { DockInteraction } from "./useDockShellProps";
+import type { DockHoldKind } from "./dockContext.js";
+import type { DockInteraction } from "./useDockShellProps.js";
 export interface UseDockStateOptions {
     /** Delay before auto-collapse after mouse leaves (ms) */
     collapseDelay?: number;
@@ -37,8 +38,20 @@ export interface UseDockStateReturn {
     expanded: Ref<boolean>;
     /** `true` whenever `state === "pinned"` — derived ref. */
     isPinned: Ref<boolean>;
-    /** `true` whenever at least one child token holds the dock open via `keepOpen`. */
+    /**
+     * `true` whenever at least one child token holds the dock open via `keepOpen`
+     * — the MORPH hold (posture). An armed search field or an open popover is one;
+     * a hand is not implied. It governs the collapse timer and the click-away, and
+     * it drives NO paint.
+     */
     isHeld: ComputedRef<boolean>;
+    /**
+     * `true` while at least one `keepOpen("grasp")` token is live — an actual
+     * POINTER hold on a descendant control. The dock's `data-held` edge and the
+     * grasp register (glass/grasp.css) read THIS, never `isHeld`: the material
+     * answers a hand, and "a popover is open" is not one.
+     */
+    graspHeld: ComputedRef<boolean>;
     /** Mouseenter handler — transitions `collapsed → hover`. */
     onMouseEnter: () => void;
     /** Mouseleave handler — schedules `hover → collapsed` after `collapseDelay`. */
@@ -50,9 +63,9 @@ export interface UseDockStateReturn {
     /** Click handler on the collapsed layer — transitions to `pinned`. */
     onClickCollapsed: () => void;
     /** Increment hold ref-count; suppresses timer-based collapse. */
-    keepOpen: () => void;
+    keepOpen: (kind?: DockHoldKind) => void;
     /** Decrement hold ref-count; allows timer-based collapse when count reaches 0. */
-    release: () => void;
+    release: (kind?: DockHoldKind) => void;
     /** Imperative open — forces `state = "hover"` (no-op when `alwaysExpanded`). */
     expand: () => void;
     /** Imperative close — forces `state = "collapsed"` (no-op when `alwaysExpanded`). */

package/dist/components/dock/constants.d.ts

@@ -8,10 +8,24 @@ export declare const DOCK_SPRING: {
     readonly dampingFraction: number;
 };
 /**
- * The shape-morph squish cap — mirrors `--dock-morph-max-stretch` (density.css). The
- * iOS-27 register.
+ * The OPEN-DISMISSABLE-LAYER probe for the dock's Escape guard (`GlassDock.vue`).
+ *
+ * `[data-dismissable-layer]` is reka's own marker, stamped by `DismissableLayer` — the
+ * single primitive that owns Escape→dismiss. It is therefore EXACTLY the set of hosted
+ * layers entitled to eat an Escape (Dialog/Sheet/Popover/Menu/Select/Combobox/
+ * HoverCard/NavigationMenu/Tooltip content), and it excludes the disclosure primitives
+ * that merely stamp `data-state="open"` (Accordion, Collapsible) — those handle no
+ * Escape, so they must NOT swallow the dock's collapse.
+ *
+ * `:not([data-state="closed"])` is the OPEN half: a non-`forceMount` layer only exists
+ * while open, and a `forceMount` one stays mounted with `data-state="closed"`. Written
+ * as a negation, not `[data-state="open"]`, because the marker element is not
+ * guaranteed to carry a state attribute at all (e.g. `ToastViewport`).
+ *
+ * ONE attribute pair beats an enumerated content-class list: reka owns the marker, so
+ * a new dismissable primitive is covered without touching this constant.
  */
-export declare const DOCK_MORPH_MAX_STRETCH = 1.14;
+export declare const OPEN_DISMISSABLE_LAYER_SELECTOR = "[data-dismissable-layer]:not([data-state=\"closed\"])";
 /** `Symbol()` label for the `DockContext` injection key (`dockContext.ts`). */
 export declare const DOCK_CONTEXT_LABEL = "glass-ui:dock-context";
 /** `Symbol()` label for the `DockCrossfadeContext` injection key (`dockCrossfadeContext.ts`). */