@mkbabb/glass-ui 5.0.0 → 7.0.0

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

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

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

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

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

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

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

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

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

@@ -21,6 +21,7 @@ declare const __VLS_base: import("vue").DefineComponent<DockProps, {
     keepOpen: () => void;
     release: () => 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>;

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

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

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

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

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

@@ -1,86 +1,17 @@
 import { type Ref } from "vue";
-/**
- * BD.W-DOCK-CORE (the width-seizure cure) — the dock morph SIZE measure.
- *
- * THE BUG THIS RETIRES (the year-old seizure): the prior pipeline measured a
- * per-swap `from/to` FLIP ratio and drove the visible size by
- * `--dock-root-scale = max(ratio + (1−ratio)·t, 0.06)` — a FLOOR with NO CEILING.
- * When the morph target measured small (a degenerate `to` racing the content
- * layout), `ratio = from/max(to,1px)` ran to ~56 → `scaleX(56)` = a ~2451px
- * detonation on collapse / an inversion at the spring overshoot peak. The
- * `transform-origin: center` kept the centroid clean (`cxRange 0`), which is
- * exactly why every prior judge measuring the centroid PASSED while the WIDTH
- * detonated. The whole measure-and-arm FLIP machinery
- * (`measureAndArmMorph`/`seatTargetSync`/`rebaseSiblingSpans`/
- * `forceNestedMaxContent`/`nestedTargetsWithin`/`measureTo`/`armRootMorphSpan`/
- * `clearRootMorphSpan`/`morphMinFloorPx`/the per-target generation gating) is
- * DELETED — clean break, no legacy, no floor that masks a bad measurement.
- *
- * THE CURE — a ratio-FREE measure-ONCE convex blend. The dock measures its two
- * KNOWN footprints ONCE per content change (a `ResizeObserver`, NOT a per-swap
- * rAF race): `--dock-expanded-px` (the expanded content width, read behind the
- * clip aperture) and `--dock-collapsed-px` (the collapsed summary box). The
- * visible size is the convex blend `--dock-live = collapsed + (expanded −
- * collapsed)·--dock-morph-t` and `--dock-size-scale = --dock-live / expanded`
- * (layers.css). A convex blend of two POSITIVE endpoints can NEVER exceed the
- * larger nor invert below the smaller — BOUNDED by construction, no ratio, no
- * `scaleX` explosion, regardless of spring overshoot (the `clamp(0,t,1)` caps the
- * size term; the >1 excursion routes to the orthogonal punch channel).
- *
- * THE FRESHNESS GUARD (challenge 3·R2): a measure-ONCE endpoint can still be read
- * stale — before `fonts.ready`, before async icon SVGs lay out, on a
- * `display:none`→0 route swap, or on a `content-visibility:auto` parent (the RO
- * fires 0). A 0 expanded would give `collapsed/0 = ∞`. So FLOOR `--dock-expanded-px`
- * at `max(measured, --dock-collapsed-px)` and re-measure on `fonts.ready` + the
- * FIRST non-zero RO callback + visibility-enter. This is NOT the deleted magic
- * floor (which masked a per-frame measurement); it is a one-shot endpoint
- * sanity bound on a value that is otherwise stable across the whole morph.
- *
- * `DOCK_SPRING` is byte-fenced — it lives in `../constants`, never touched here.
- */
-export declare function dimOf(axis: "horizontal" | "vertical"): "width" | "height";
 export declare function getSize(el: HTMLElement, axis: "horizontal" | "vertical"): number;
 export interface UseDockExpandedSizeOptions {
-    /** The `.glass-dock` root the `--dock-expanded-px`/`--dock-collapsed-px` write to. */
     rootEl: Ref<HTMLElement | null>;
-    /**
-     * The content element whose intrinsic morph-axis span is observed for size
-     * changes (the active full-pane container — `.dock-layers`). Its resizes are the
-     * RO trigger; the ENDPOINTS are read off the ROOT box (content + chrome), keyed
-     * by the dock's at-rest expanded/collapsed state.
-     */
     contentEl: Ref<HTMLElement | null>;
-    /**
-     * The morph axis (a horizontal dock blends width; a vertical dock blends height).
-     */
+    expandedEl: Ref<HTMLElement | null>;
+    collapsedEl: Ref<HTMLElement | null>;
     axis: Ref<"horizontal" | "vertical">;
-    /**
-     * Whether the dock is currently in its EXPANDED visual state (a `Ref<boolean>`).
-     * The endpoint captured at rest is keyed off this: at rest expanded → the root
-     * box is the `--dock-expanded-px` endpoint; at rest collapsed → the
-     * `--dock-collapsed-px` endpoint. (A reactive read, so a state flip re-captures.)
-     */
     expanded: Ref<boolean>;
 }
 /**
- * BD.W-DOCK-CORE — capture the two convex-blend endpoints ONCE PER STATE off the
- * ROOT box.
- *
- * The visible morph scales the ROOT (chrome + content), so the two blend endpoints
- * must be the ROOT's OWN expanded/collapsed footprints — NOT the bare content span
- * (which omits the padding/min-width chrome). The endpoints are captured at REST
- * (when `[data-morphing]` is OFF): the dock's settled root box in its current
- * expanded/collapsed state IS that state's endpoint. A `ResizeObserver` on the
- * content re-captures the CURRENT state's endpoint whenever the content reflows
- * (more controls, a font swap), so the blend stays fresh — but it never reads the
- * box MID-MORPH (the scaled box would feed back a degenerate endpoint, the seizure's
- * cousin). The expanded endpoint is FLOORED at `max(captured, collapsed)` — the
- * freshness guard against a 0/degenerate read giving `collapsed/0 = ∞`.
- *
- * The collapsed endpoint starts at the resolved `--dock-morph-min` icon-square floor
- * and is refined to the real collapsed root box the first time the dock rests
- * collapsed; the expanded endpoint is captured the first (and every) time it rests
- * expanded. So the FIRST morph from a freshly-mounted expanded dock already has a
- * real expanded endpoint + a sane collapsed floor — bounded by construction.
+ * Measure the dock's two rendered pane compositions. The inactive pane remains
+ * laid out (visibility, never display, hides it), so the first morph can derive
+ * both endpoints from real content—coarse controls bring their own 44px floor;
+ * non-interactive visuals receive no invented one.
  */
 export declare function useDockExpandedSize(options: UseDockExpandedSizeOptions): void;

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

@@ -7,4 +7,4 @@ 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, provideDockMorphContext, useOptionalDockMorphContext, DOCK_MORPH_KEY, type DockMorphContext, type DockMorphGroupRegistration, type DockMorphGroupHandle, type UseDockMorphOrchestratorOptions, type UseDockMorphOrchestratorReturn, } from "./dockMorphContext";
+export { useDockMorphOrchestrator, type UseDockMorphOrchestratorOptions, type UseDockMorphOrchestratorReturn, } from "./useDockMorph";

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

@@ -2,10 +2,14 @@ import { type Ref } from "vue";
 export interface DockClickIntegrity {
     /** Capture-phase `pointerdown` handler — records the press-time element + state. */
     onPointerDownCapture: (event: PointerEvent) => void;
+    /** Capture-phase `pointercancel` handler — clears an abandoned press identity. */
+    onPointerCancelCapture: () => void;
     /** Capture-phase `click` handler — swallows an identity-changed post-swap click. */
     onClickCapture: (event: MouseEvent) => void;
     /** Mark the collapsed→expanded flip so the settle window opens (call on expand). */
     markExpandFlip: () => void;
+    /** The outer pane retained for the witnessed press, or null. */
+    pressKeepaliveLayer: Readonly<Ref<"full" | null>>;
 }
 export interface UseDockClickIntegrityOptions {
     /** The dock root element ref — the morph-state owner (`[data-morphing]`). */
@@ -14,7 +18,7 @@ export interface UseDockClickIntegrityOptions {
     visualExpanded: Ref<boolean>;
 }
 /**
- * The dock click-integrity guard (R5-3). Returns the three capture-phase handlers
+ * The dock click-integrity guard. Returns the three capture-phase handlers
  * the GlassDock SFC wires onto its root. The guard is a pure DOM-timing concern: it
  * holds the press-time element identity + the settle-window deadline and decides, on
  * the click, whether the click landed on the SAME control it was aimed at. Owns its

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

@@ -1,6 +1,6 @@
 import type { ComputedRef } from "vue";
 /**
- * AX.W03 — the host-native dock hold.
+ * Host-native dock hold.
  *
  * `keepDockOpen` is a FIRST-CLASS, synchronous morph-state input to the dock's
  * one state machine: while a continuous pointer/touch gesture is live on a
@@ -17,9 +17,8 @@ import type { ComputedRef } from "vue";
  * Slot/forwardRef boundary — vue-tsc + units pass, only a real drag catches it
  * (the canonical binding-verification class, `feedback_glass_ui_binding_*`). A
  * native `addEventListener` on the RESOLVED host element is immune: the event
- * always reaches the DOM node the user actually presses. This is the
- * device-proven fix (AX.W03 §Scope.1/2 — slice-2 F0/F2; ratified host-native
- * over a reka `dragging`-ref subscription, which reka does not publicly expose
+ * always reaches the DOM node the user actually presses. This host-native behavior is
+ * preferable to a Reka `dragging`-ref subscription, which Reka does not publicly expose
  * and which would re-introduce the same forwarding fragility).
  *
  * The hold is INSTANT-ON (Apple "Building Fluid Interfaces", facet 5): the first
@@ -34,7 +33,7 @@ import type { ComputedRef } from "vue";
  * hold path, no parallel `touchGate` watch).
  *
  * DI: consumes the EXISTING typed `DockContext` via `useOptionalDockContext()`
- * (the `keepOpen`/`release` pair, O.W2 single-typed-key collapse). A control
+ * 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.
  */

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

@@ -0,0 +1,26 @@
+import type { Ref } from "vue";
+/**
+ * The dock collapse/expand morph has one job: project the current outer face
+ * onto the shared `--dock-morph-t` spring. Controlled face swaps belong to
+ * `DockCrossfade`; they do not register with, or resize, the dock shell.
+ */
+export interface UseDockMorphOrchestratorOptions {
+    /** The `.glass-dock` root carrying the shared scalar. */
+    rootEl: Ref<HTMLElement | null>;
+    /** The outer collapsed/expanded face id. */
+    outerActiveLayer: Ref<string>;
+    /** Notifies the shell when the spring arms and settles. */
+    onMorphActiveChange?: (active: boolean) => void;
+}
+export interface UseDockMorphOrchestratorReturn {
+    /** The outer face that currently owns layout and interaction. */
+    outerCurrentLayer: Readonly<Ref<string>>;
+    /** The face fading out, or null after settle. */
+    outerLeavingLayer: Readonly<Ref<string | null>>;
+}
+/**
+ * Drive the outer collapsed/expanded pair from the sole dock spring. Mid-flight
+ * reversals complement both position and velocity so the painted trajectory is
+ * continuous; reduced motion seats the same endpoint immediately.
+ */
+export declare function useDockMorphOrchestrator(options: UseDockMorphOrchestratorOptions): UseDockMorphOrchestratorReturn;

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

@@ -1,16 +1,14 @@
 import { type Ref } from "vue";
 /**
- * useDockOverflowFit — the fits-vs-scrollable mode resolution for the dock's native
- * scroll track (BI.W-DOCK-OVERFLOW, PASS-1 §2.5). A MEASURED branch (the wave's "single
- * container-query / measured branch"): it toggles `[data-dock-overflow]` on the dock root
- * when the active full layer's over-cap inline content exceeds its clamped port width.
+ * useDockOverflowFit resolves fits-vs-scrollable mode for the dock's native scroll
+ * track. It toggles `[data-dock-overflow]` on the dock root
+ * when content exceeds the horizontal full-layer port or vertical root scroll host.
  * The overflow.css scroll track + FadingScroll edge mask engage ONLY under that attr, so
- * at rest (fits) the mask is `none` (T-52 a — no 0px-fade shave) and the fisheye is FREE
- * (fisheye.css gates on `:not([data-dock-overflow])`, the exclusive-mode ruling).
+ * at rest (fits) the mask is `none`.
  *
- * G9 / O5 — ZERO SCROLL LISTENER. The measure is RESIZE- and CONTENT-driven (a
- * `ResizeObserver` on the dock + the port, plus a `MutationObserver` on the port's
- * content). It never listens to `scroll` — the traveling indicator (`useSelectionIndicator`)
+ * The measure is resize- and content-driven, with no scroll listener (a
+ * `ResizeObserver` on the dock + the port, plus a narrowly filtered `MutationObserver`
+ * on dock content). It never listens to `scroll` — the traveling indicator (`useSelectionIndicator`)
  * lives inside the scroll port and travels WITH scroll in content coordinates, needing no
  * scroll listener; this fit measure adds none either.
  *

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

@@ -1,7 +1,7 @@
 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/useScrollChrome";
+import { type UseScrollChromeReturn } from "../../../composables/motion/scroll/useScrollChrome";
 export interface UseDockSearchOptions<T extends SearchableItem = SearchableItem> {
     /** Composes the existing dock state machine (no fork) — `armSearch`/`disarmSearch`
         ride its `onClickCollapsed`/`keepOpen`/`release`. */
@@ -34,19 +34,19 @@ export interface UseDockSearchOptions<T extends SearchableItem = SearchableItem>
     /** The dock element the collapse-on-scroll writes `--chrome-collapse-t` onto. */
     chromeRef?: MaybeRefOrGetter<HTMLElement | null>;
     /**
-     * Result-select hook — wires the ToC subsume: `ensureTargetWindow(id)` (warm the
-     * window so the target renders) + `scrollTo(id)` (the rAF-retry scroll-to-and-land).
+     * Result-select hook — wires the ToC subsume: `ensureTargetWindow(id)` (seat the
+     * target's bounded render window) + `scrollTo(id)` (the rAF-retry scroll-to-and-land).
      * The dock owns the gesture; the consumer passes the two leaves' bound functions.
      */
     onResultSelect?: (result: SearchResult<T>) => void;
     /**
-     * The virtual-window warm step (composed `useVirtualSectionWindow.ensureTargetWindow`).
-     * Called BEFORE `scrollTo` on a result-select so the windowed target is rendered.
+     * Consumer-provided target-window step. Called BEFORE `scrollTo` on result
+     * selection so a windowed target can render before the scroll lands.
      */
     ensureTargetWindow?: (id: string) => void;
     /**
      * The ToC scroll-to (composed `useScrollTo.scrollTo`) — the rAF-retry scroll-to-id.
-     * Called AFTER the warm step on a result-select.
+     * Called AFTER the target-window step on a result-select.
      */
     scrollTo?: (id: string) => void;
 }
@@ -71,9 +71,9 @@ export interface UseDockSearchReturn<T extends SearchableItem = SearchableItem>
  * `useScrollChrome`); the `armSearch`/`disarmSearch`/`autocompleteText`/
  * `acceptAutocomplete` surface; the async `onSearch` adapter; the `onResultSelect` →
  * `ensureTargetWindow` + `scrollTo` wire. Does NOT edit the morph engine
- * (`dockMorphContext`/`DOCK_SPRING` byte-untouched — the box-inviolate fence); the
+ * (`useDockMorph`/`DOCK_SPRING` byte-untouched — the box-inviolate fence); the
  * pill→field morph is the dock's OWN `--dock-morph-t`/`--dock-t` plate glide, and the
- * results dropdown re-hosts on a top-layer `popover` (BI.W-DOCK-ESCAPE — `useDockPopover`).
+ * results surface is consumer-authored and can be portaled independently of the dock.
  *
  * @example
  * ```ts