@mkbabb/glass-ui 4.2.0 → 5.0.0

package/dist/components/custom/dock/DockSelectTrigger.vue.d.ts

@@ -1,29 +0,0 @@
-import { type HTMLAttributes } from "vue";
-import { type SelectTriggerProps } from "reka-ui";
-/**
- * <DockSelectTrigger> — variable-width Select trigger for use inside GlassDock.
- *
- * Emits the dock select-trigger class contract. Interactive styling is owned
- * by src/styles/dock.css. Unlike DockIconButton, this does NOT scale on hover
- * so dropdown content anchors smoothly to the trigger.
- *
- * The trailing chevron is built-in; override via :icon slot.
- */
-type __VLS_Props = SelectTriggerProps & {
-    class?: HTMLAttributes["class"];
-};
-declare var __VLS_8: {}, __VLS_16: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_8) => any;
-} & {
-    icon?: (props: typeof __VLS_16) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
-declare const _default: typeof __VLS_export;
-export default _default;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};

package/dist/components/custom/dock/DockStack.vue.d.ts

@@ -1,78 +0,0 @@
-import { type Component } from "vue";
-import type { DockStackItem } from "./constants";
-/**
- * <DockStack> — BC.W-DOCK-STACK-RAIL + BE.W-DOCK-RAIL-REALIZE. The ONE rail engine on
- * the KEPT `.glass-dock-frame` non-clipping escape, with TWO render modes:
- *
- *   • `mode="stack"` (DEFAULT — the BC byte-identical path). The macOS Dock
- *     hover-expand STACK: a `core` anchor glyph + N members that FAN OUT on hover/focus
- *     beside the rail, each a clear `--glass-bg-floating` glass icon.
- *
- *   • `mode="facets"` (BE.W-DOCK-RAIL-REALIZE — the re-instated AZ context carousel).
- *     The members render as a CONTEXT CAROUSEL — a flex strip of facet-CHIPS that fans
- *     in the SAME gutter, each chip carrying its OWN `--glass-accent` hue (the
- *     per-instance chromatic-rim axis), the active facet lit on the selected-as-glass
- *     `--dock-control-active-bg` tier. Clicking a chip writes the consumer-owned
- *     `v-model:selected`. This is a RENDER MODE, NOT a second component — there is no
- *     `DockRail.vue`/`DockFacetRail.vue`; `<DockStack>` owns both modes.
- *
- * THE KEPT ESCAPE (both modes). It renders in `GlassDock`'s `#rail` slot, over the
- * `.glass-dock-frame` shell — a `display:contents`-by-default wrapper that becomes a
- * NON-clipping positioning context only on `data-has-rail`, so the rail extends BEYOND
- * the dock edge into its own gutter WITHOUT touching the dock box (the box-INVIOLATE
- * discipline — `deltaW = deltaH = 0`; the chips feed NO size into the dock's intrinsic
- * box).
- *
- * 3 CONFIGURABLE, SCROLLABLE, N-STACK (both modes). `visibleCount` (default 3) members
- * fan at rest; an >visibleCount set routes the fanned strip through `<FadingScroll>`
- * (the one scroll-fade port) so the n-set is reachable by scrolling the rail, NOT by
- * overflowing the dock box.
- *
- * THE HOVER-HYSTERESIS (REUSED, not re-forked — AZ.W-DOCK-FLICKER). The pointer-enter
- * commits the open only after the `HOVER_INTENT_MS` intent-dwell. Focus opens
- * immediately; blur/leave closes.
- *
- * ONE REGISTRY (R4 KEPT). The members write the consumer-owned `v-model:selected`; this
- * primitive owns NO internal `ref()`/`reactive()` shadow of the active member. The hover
- * `expanded` is a transient UI state (optionally `v-model:expanded` controlled), NOT a
- * selection shadow.
- */
-type __VLS_Props = {
-    /** The stack/facet members — the fan-out contents. */
-    items: readonly DockStackItem[];
-    /**
-     * The render mode. `"stack"` (default) = the macOS hover-expand glyph fan (the BC
-     * byte-identical path). `"facets"` = the re-instated AZ context carousel of
-     * accent-tinted facet chips (each chip writes its own `--glass-accent` hue).
-     */
-    mode?: "stack" | "facets";
-    /** The core anchor glyph (the always-visible dock(1) item). Default: a layers glyph. */
-    core?: Component;
-    /** The core's accessible label (the stack's name). */
-    coreLabel?: string;
-    /** Members visible at rest before scrolling (the verbatim "3 configurable"). */
-    visibleCount?: number;
-    /** Which dock edge the stack anchors to. */
-    position?: "start" | "end";
-};
-type __VLS_ModelProps = {
-    "selected"?: string;
-    "expanded"?: boolean;
-};
-type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    select: (id: string) => any;
-    "update:selected": (value: string | undefined) => any;
-    "update:expanded": (value: boolean) => any;
-}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
-    onSelect?: ((id: string) => any) | undefined;
-    "onUpdate:selected"?: ((value: string | undefined) => any) | undefined;
-    "onUpdate:expanded"?: ((value: boolean) => any) | undefined;
-}>, {
-    position: "start" | "end";
-    mode: "stack" | "facets";
-    visibleCount: number;
-    coreLabel: string;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const _default: typeof __VLS_export;
-export default _default;

package/dist/components/custom/dock/DockTabButton.vue.d.ts

@@ -1,39 +0,0 @@
-import { type HTMLAttributes } from "vue";
-/**
- * <DockTabButton> — text-tab button for use inside a horizontal GlassDock.
- *
- * Emits the dock tab-button class contract. Interactive styling is owned by
- * src/styles/dock.css. Sibling to <DockIconButton>: DockIconButton is
- * fixed-square for icons; DockTabButton is auto-sized for short text labels.
- *
- * Use `as-child` to render as a <RouterLink> or <a>: the active state
- * automatically activates when the rendered element carries
- * aria-current="page" (which RouterLink sets).
- *
- * BA.W-GLASS-CAL (H2a) — the `data-tier="primary"` auto-attach of the
- * `btn-audacious` disco utility is REMOVED (the recipe is retired). The primary
- * tier now reads ONLY its dock-local structural shell + the plain de-red'd glass
- * hover register (`dock-controls/tab-button.css`); `data-tier` is still the styling
- * hook the CSS keys off, the component no longer composes a utility class.
- */
-type __VLS_Props = {
-    as?: string;
-    asChild?: boolean;
-    class?: HTMLAttributes["class"];
-};
-declare var __VLS_8: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_8) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    asChild: boolean;
-    as: string;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
-declare const _default: typeof __VLS_export;
-export default _default;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};

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

@@ -1,47 +0,0 @@
-import { type DockProps } from "./composables/useDockShellProps";
-/** Imperative split/merge/toggle — re-measure pieces, then run the fission spring. */
-declare function split(): void;
-declare function merge(): void;
-declare function toggleSplit(): void;
-declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_7: {}, __VLS_9: {
-    fissioned: boolean;
-}, __VLS_11: {};
-type __VLS_Slots = {} & {
-    persistent?: (props: typeof __VLS_1) => any;
-} & {
-    default?: (props: typeof __VLS_3) => any;
-} & {
-    collapsed?: (props: typeof __VLS_5) => any;
-} & {
-    search?: (props: typeof __VLS_7) => any;
-} & {
-    split?: (props: typeof __VLS_9) => any;
-} & {
-    rail?: (props: typeof __VLS_11) => any;
-};
-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>;
-    isTransitioning: import("vue").Ref<boolean, boolean>;
-    expand: () => void;
-    collapse: () => void;
-    keepOpen: () => void;
-    release: () => void;
-    split: typeof split;
-    merge: typeof merge;
-    toggleSplit: typeof toggleSplit;
-    fissioned: Readonly<import("vue").Ref<boolean, boolean>>;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:order": (from: number, to: number) => any;
-}, string, import("vue").PublicProps, Readonly<DockProps> & Readonly<{
-    "onUpdate:order"?: ((from: number, to: number) => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
-declare const _default: typeof __VLS_export;
-export default _default;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};

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

@@ -1,47 +0,0 @@
-import type { ComputedRef } from "vue";
-export type DockOrientation = "horizontal" | "vertical";
-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`.
- *
- * 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 `<HoverPopover keep-dock-open>` whose open/close
- * cadence is owned by reka-ui's HoverCard primitives; cooperative
- * dismissal between sibling popovers is no longer needed (HoverCard's
- * pointer-leave timer handles the cluster transit case).
- */
-export interface DockContext {
-    id: string;
-    orientation: ComputedRef<DockOrientation>;
-    /**
-     * In-cap arrangement (`linear` row/column vs `grid` tile panel). AX.W45 —
-     * `<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).
-     */
-    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>;
-export declare function provideDockContext(context: DockContext): void;
-/** Strict — throws when used outside `<GlassDock>`. */
-export declare const useDockContext: () => DockContext;
-/** Befitting silent default for primitives that may render outside a dock. */
-export declare const useOptionalDockContext: () => DockContext | null;

package/dist/components/custom/dock/composables/dockLayerContext.d.ts

@@ -1,36 +0,0 @@
-import type { Component, Ref } from "vue";
-/**
- * DockLayerGroup context — DI surface for `<DockLayer>` children registering
- * with their parent `<DockLayerGroup>` for the switcher rail + crossfade
- * coordination.
- *
- * O.W2 Lane A — canonical typed-key + helper-pair DI shape per invariant
- * 25. Replaces the prior raw `provide("dockLayerGroup", {...})` + duplicated
- * inline interface in `DockLayer.vue`. The context is distinct from
- * `DockContext` (a `<DockLayerGroup>` doesn't have to live inside a
- * `<GlassDock>`) so it gets its own module-local key.
- */
-export interface DockLayerDescriptor {
-    id: string;
-    label?: string;
-    icon?: Component | string;
-}
-export interface DockLayerGroupContext {
-    register(desc: DockLayerDescriptor): void;
-    unregister(id: string): void;
-    /**
-     * AU.W8b.6 — group-orchestrated layer state, exposed READ-ONLY. The
-     * `<DockLayerGroup>` (via `useLayerTransition`) owns the writable refs and
-     * provides `readonly()` projections; a `<DockLayer>` child can read but
-     * never write this state. A child `currentLayerId.value = …` is a compile
-     * error (see `__tests__/dockLayerContext.readonly.test-d.ts`).
-     */
-    currentLayerId: Readonly<Ref<string>>;
-    leavingLayerId: Readonly<Ref<string | null>>;
-}
-export declare const DOCK_LAYER_GROUP_KEY: import("vue").InjectionKey<DockLayerGroupContext>;
-export declare function provideDockLayerGroupContext(context: DockLayerGroupContext): void;
-/** Strict — throws when used outside `<DockLayerGroup>`. */
-export declare const useDockLayerGroupContext: () => DockLayerGroupContext;
-/** Befitting silent default; reserved for future consumers. */
-export declare const useOptionalDockLayerGroupContext: () => DockLayerGroupContext | null;

package/dist/components/custom/dock/composables/dockMorphContext.d.ts

@@ -1,79 +0,0 @@
-import type { Ref } from "vue";
-/**
- * AX.W02 — ONE morph orchestrator per dock. The dock is a single morph stack
- * whose active "layer" is `(expandedState × activePane)`: the outer
- * collapse↔expand swap and the inner `<DockLayerGroup>` pane swaps are
- * transitions in the SAME group — ONE spring, ONE scalar (`--dock-morph-t`),
- * ONE clock. No second engine.
- *
- * BD.W-DOCK-CORE (the size re-invent) — the orchestrator no longer MEASURES a
- * per-swap `from/to` span. The visible size is a ratio-free convex blend of two
- * endpoints measured ONCE per content change (`useDockExpandedSize` writes
- * `--dock-expanded-px`/`--dock-collapsed-px`; layers.css blends them on
- * `--dock-morph-t`). So this driver shrinks to its essence: on a layer swap it
- * arms `[data-morphing]`, swaps the crossfade classes (the a11y-006 3-state
- * hit-test contract, LOAD-BEARING — KEPT verbatim), and runs ONE `SpringProgress`
- * gliding `--dock-morph-t` 0→1; on settle it clears the morph state. A re-toggle
- * mid-flight re-bases the live solver onto a fresh spring CARRYING the prior
- * velocity (the iOS interruptible-physics continuity).
- *
- * LIGHT-surface only: `SpringProgress` owns its own rAF via `.play(onFrame)` and
- * carries no static value.js edge — never import `AnimationGroup` / `./engine`.
- *
- * `DOCK_SPRING` is byte-fenced — it lives in `../constants`.
- */
-export interface DockMorphGroupRegistration {
-    /** The container element owning this group's grid-stacked panes. */
-    containerEl: Ref<HTMLElement | null>;
-    /** The group's currently-active pane id (its `v-model:active`). */
-    activeLayer: Ref<string>;
-    /** Layout axis of the group; matches the group's `orientation`. */
-    axis: Ref<"horizontal" | "vertical">;
-}
-export interface DockMorphGroupHandle {
-    /** The active pane id post-swap (the orchestrator mutates it). */
-    currentLayer: Readonly<Ref<string>>;
-    /** The pane id currently fading out, or null. */
-    leavingLayer: Readonly<Ref<string | null>>;
-    /** Detach this group from the orchestrator (on the group's unmount). */
-    release(): void;
-}
-/**
- * The provided morph seam. A nested `<DockLayerGroup>` injects this and DEFERS
- * its pane-swap morph to the dock's single orchestrator via `registerGroup`.
- */
-export interface DockMorphContext {
-    registerGroup(group: DockMorphGroupRegistration): DockMorphGroupHandle;
-}
-export declare const DOCK_MORPH_KEY: import("vue").InjectionKey<DockMorphContext>;
-export declare function provideDockMorphContext(context: DockMorphContext): void;
-/**
- * Befitting-silent — returns `null` for a `<DockLayerGroup>` rendered outside a
- * `<GlassDock>` (the standalone self-orchestrate path).
- */
-export declare const useOptionalDockMorphContext: () => DockMorphContext | null;
-export interface UseDockMorphOrchestratorOptions {
-    /** The `.glass-dock` root that carries the shared scalar + clip aperture. */
-    rootEl: Ref<HTMLElement | null>;
-    /** The outer collapse↔expand container (`.dock-layers`). */
-    outerEl: Ref<HTMLElement | null>;
-    /** The outer active "layer" id — `(expandedState)` projected to a string. */
-    outerActiveLayer: Ref<string>;
-    /** The outer pair morphs the inline axis (a horizontal dock). */
-    outerAxis: Ref<"horizontal" | "vertical">;
-}
-export interface UseDockMorphOrchestratorReturn {
-    /** Provide-able context: a nested `<DockLayerGroup>` registers through it. */
-    context: DockMorphContext;
-    /** The outer pair's post-swap active layer id (call-site parity). */
-    outerCurrentLayer: Readonly<Ref<string>>;
-    /** Defensive settle on a stray `@transitionend` (call-site parity). */
-    onOuterTransitionEnd(e: TransitionEvent): void;
-}
-/**
- * The ONE morph engine for a dock instance. Owns a single `SpringProgress` that
- * glides the one `--dock-morph-t` scalar 0→1 on a layer swap; the size is a
- * ratio-free blend of the measure-ONCE endpoints (layers.css). Crossfade classes
- * (the 3-state a11y hit-test contract) swap on the swap; the spring is the clock.
- */
-export declare function useDockMorphOrchestrator(options: UseDockMorphOrchestratorOptions): UseDockMorphOrchestratorReturn;

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

@@ -1,14 +0,0 @@
-export { useDockState } from "./useDockState";
-export type { UseDockStateOptions, UseDockStateReturn, DockState } from "./useDockState";
-export { useDockSearch } from "./useDockSearch";
-export type { UseDockSearchOptions, UseDockSearchReturn } from "./useDockSearch";
-export { useLayerTransition } from "./useLayerTransition";
-export type { UseLayerTransitionOptions, UseLayerTransitionReturn } from "./useLayerTransition";
-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 { provideDockLayerGroupContext, useDockLayerGroupContext, useOptionalDockLayerGroupContext, DOCK_LAYER_GROUP_KEY, type DockLayerDescriptor, type DockLayerGroupContext, } from "./dockLayerContext";
-export { useDockMorphOrchestrator, provideDockMorphContext, useOptionalDockMorphContext, DOCK_MORPH_KEY, type DockMorphContext, type DockMorphGroupRegistration, type DockMorphGroupHandle, type UseDockMorphOrchestratorOptions, type UseDockMorphOrchestratorReturn, } from "./dockMorphContext";
-export { useDockOrientationMorph, type DockMorphOrientation, type UseDockOrientationMorphOptions, type UseDockOrientationMorphReturn, } from "./useDockOrientationMorph";
-export { useDockFission, DOCK_SPLIT_SIGNATURES, type DockSplitContext, type DockSplitVector, type DockSplitSquishPeak, type DockSplitSignature, type DockFissionPieceRegistration, type DockFissionPieceHandle, type UseDockFissionOptions, type UseDockFissionReturn, } from "./useDockFission";

package/dist/components/custom/dock/composables/railProjection.d.ts

@@ -1,45 +0,0 @@
-/** The signed shortest-arc offset on a wrap ring (the "negative-infinity modulus" — a
- *  naive `raw % N` breaks the backward wrap). Wraps to `[-N/2, N/2)`. */
-export declare function ringOffset(raw: number, n: number): number;
-/** The φ-tiered slot SPAN to a given absolute slot-distance — the chosen→neighbour gap
- *  is wider than the neighbour→far gap (the recession compresses as items recede, the
- *  depth read). The tier ratio is EXPRESSED in the accumulation, never a flat resolved
- *  rebake (the W-CARD-PAD φ-ladder fence). */
-export declare function tieredSpan(adist: number, base: number, ratio: number): number;
-/** The geometry knobs for the facet carousel — the φ-tier spacing + the fade model. */
-export interface RailProjectionGeometry {
-    /** The active→neighbour base slot gap, in px (the tier-0 spacing). Default 44. */
-    slotSpacing?: number;
-    /** The φ tier ratio — each receding tier compresses by this. Default 1.618. */
-    tierRatio?: number;
-    /** The slot-distance at which the fade begins (active + immediate neighbour stay
-     *  full). Default 0.5. */
-    fadeStart?: number;
-    /** The slot-span the fade runs over. Default 2.5. */
-    fadeRange?: number;
-    /** The far floor alpha. Default 0. */
-    fadeMinAlpha?: number;
-    /** The per-slot scale recession (the depth read). Default 0.06. */
-    scaleStep?: number;
-    /** The max slots the scale recession clamps at. Default 4. */
-    scaleClampSlots?: number;
-}
-/** One projected facet — the compositor-only transform tier for the ring item. */
-export interface RailFacetProjection {
-    /** The stable ring index `0..count-1` (the `v-for` key). */
-    index: number;
-    /** The signed shortest-arc slot offset from the active facet. */
-    offset: number;
-    /** The px translate along the rail's main axis. */
-    translate: number;
-    /** The faded alpha (0..1). */
-    opacity: number;
-    /** The recession scale (≤1). */
-    scale: number;
-    /** Whether this is the active facet (offset 0). */
-    active: boolean;
-}
-/** Project the facet ring around the `active` index, fanned by `expand` (0 collapsed → 1
- *  fully fanned). Returns the virtualized WINDOW of `±ceil(fadeRange+1)` items, each with
- *  its compositor-only `{ translate, opacity, scale }`. PURE — no state, no measure. */
-export declare function projectFacets(count: number, active: number, expand: number, geometry?: RailProjectionGeometry): RailFacetProjection[];

package/dist/components/custom/dock/composables/useDockContextSilhouette.d.ts

@@ -1,192 +0,0 @@
-import { type MorphRect } from "@mkbabb/keyframes.js";
-import { type Ref } from "vue";
-import { type SpringPresetName } from "../../../../composables/motion/springPresets";
-/** The dock orientation axis (the `dim`-idiom source — slot geometry derives from it). */
-export type SilhouetteOrientation = "horizontal" | "vertical";
-/** The four named silhouette kinds (the descriptor map's contract). */
-export type DockSilhouetteKind = "bar" | "bar+pill" | "split" | "search";
-/**
- * The silhouette spring register — a subset of the named `SPRING_PRESETS` rows matching
- * the `useDockCtaReceive`/`useLiquidReveal` register so every dock morph reads as ONE
- * spring family. `dock` is the default (the dock's own settle clock).
- */
-export type SilhouettePreset = Extract<SpringPresetName, "dock" | "snappy" | "bouncy">;
-/**
- * One named SLOT inside a silhouette — a position keyed by `controlId`. The geometry is
- * ORIENTATION-DERIVED: `main` is the offset along the dock's main axis (the row position
- * horizontal / the column position vertical), `cross` the cross-axis offset, `size` the
- * control's extent. The orchestrator resolves these into a concrete `MorphRect` off the
- * orientation + the dock's measured origin (the `dim`-idiom — never a hardcoded
- * `inline-size`/`block-size` literal, so vertical is the SAME data with `orientation`
- * flipped).
- */
-export interface SilhouetteSlot {
-    /** The control this slot positions (the diff key — present-in-both → FLIP). */
-    controlId: string;
-    /** Offset along the dock's MAIN axis (px from the dock origin). */
-    main: number;
-    /** Offset along the CROSS axis (px from the dock origin). */
-    cross: number;
-    /** The control's main-axis extent (px). */
-    size: number;
-    /** The control's cross-axis extent (px; defaults to `size` for a square control). */
-    thickness?: number;
-    /**
-     * FUSION marker (the `bar+pill` headline): when true, this slot's `to`-rect is the
-     * bar's TOP CROWN and the orchestrator drives `--silhouette-fuse-t` so the slotted
-     * control (the now-playing pill) DOCKS DOWN and MELDS into the bar as ONE plate. A
-     * `bar+pill` descriptor with NO `fuse: true` slot is a pill-ABOVE-bar literal (the
-     * C3 anti-evasion — the gate reds it).
-     */
-    fuse?: boolean;
-}
-/**
- * One declarative silhouette descriptor — a context's whole geometry as DATA (the
- * `DockSectionDescriptor` precedent: data, not code paths). The orchestrator reads the
- * MAP; there is NO per-context hardcoded silhouette literal (the gate's C1 anti-evasion
- * floor).
- */
-export interface DockSilhouetteDescriptor {
-    /** Stable identifier — the `setSilhouette` argument + the active-silhouette id. */
-    id: string;
-    /** Which of the four named kinds this context renders. */
-    kind: DockSilhouetteKind;
-    /** The named slots (control positions) this silhouette places. */
-    slots: readonly SilhouetteSlot[];
-    /** This silhouette's spring register (DATA, not an SFC ternary). Default `dock`. */
-    preset?: SilhouettePreset;
-    /**
-     * The neck-hold for any DETACH this transition drives (DATA — fed to `useDockFission`
-     * when a control is present-in-from-only). 0 = no hold (immediate release), 1 = full
-     * hold (the goo necks late then snaps).
-     */
-    neckHold?: number;
-}
-/**
- * The DETACH hand-off API the orchestrator drives (BE.W-DOCK-FISSION owns the engine).
- * A control PRESENT-only-in-FROM detaches — the orchestrator registers it as a fission
- * PIECE via `registerPiece` and the fission orchestrator buds it off the body. Defined
- * here per the fission spec (`useDockFission` `registerPiece`); the sibling agent builds
- * it, the orchestrator reconciles the import. The orchestrator never re-implements the
- * detach physics — it CALLS this.
- */
-export interface FissionPieceHandle {
-    /** Release the piece (drive its `--dock-split-t` 0→1 detach). */
-    detach: () => void;
-    /** Re-merge the piece (the bidirectional 1→0). */
-    remerge: () => void;
-    /** Unregister the piece (cleanup). */
-    release: () => void;
-}
-/** The fission registrar the orchestrator composes (BE.W-DOCK-FISSION's `registerPiece`). */
-export type RegisterFissionPiece = (el: HTMLElement, spec: {
-    vector: {
-        dx: number;
-        dy: number;
-    };
-    rank: number;
-    neckHold: number;
-}) => FissionPieceHandle;
-/**
- * The BLOOM-IN hand-off API the orchestrator drives (BE.W-BLOOM-UP owns the engine). A
- * control PRESENT-only-in-TO blooms in — the inverse FLIP. Defined here per the bloom-up
- * spec (`useBloomUp(sourceRef, destRef)`); the orchestrator CALLS it, never re-implements
- * the bloom.
- */
-export type BloomInPiece = (el: HTMLElement, fromRect: MorphRect, toRect: MorphRect) => void;
-export interface UseDockContextSilhouetteOptions {
-    /** The declarative silhouette descriptor MAP (the four kinds; net-new DATA). */
-    silhouettes: readonly DockSilhouetteDescriptor[];
-    /** The id of the silhouette to seat at construction (defaults to the first). */
-    initial?: string;
-    /** The dock orientation (the `dim`-idiom source). Default `horizontal`. */
-    orientation?: SilhouetteOrientation | Ref<SilhouetteOrientation>;
-    /**
-     * Resolve a control's live element by `controlId` (the orchestrator measures its
-     * current rect for the FLIP). The consumer wires this off its slot refs.
-     */
-    resolveControl: (controlId: string) => HTMLElement | null;
-    /**
-     * The dock ROOT element — the orchestrator measures its origin (to resolve a slot's
-     * orientation-derived `main`/`cross` into a viewport `MorphRect`) AND writes
-     * `--silhouette-fuse-t` onto it for the fusion meld. The fused glass plate is the
-     * dock body itself (C5 — the detach pieces paint in the non-clipping frame; the fused
-     * plate is the dock root).
-     */
-    dockRoot: Ref<HTMLElement | null>;
-    /**
-     * The DETACH registrar (BE.W-DOCK-FISSION's `registerPiece`). When absent, a
-     * present-in-from-only control is simply removed from the FLIP set (no detach
-     * choreography — graceful until fission wires in).
-     */
-    registerFissionPiece?: RegisterFissionPiece;
-    /**
-     * The BLOOM-IN driver (BE.W-BLOOM-UP). When absent, a present-in-to-only control
-     * snaps in (no bloom choreography — graceful until bloom-up wires in).
-     */
-    bloomInPiece?: BloomInPiece;
-    /** Honor `prefers-reduced-motion: reduce` (seat synchronously). Default true. */
-    respectReducedMotion?: boolean;
-    /** Fired once when a silhouette transition has settled (the consumer hand-off). */
-    onSettled?: (toId: string) => void;
-}
-export interface UseDockContextSilhouetteReturn {
-    /** The active silhouette id (reactive — the consumer reads the SHAPE). */
-    active: Readonly<Ref<string>>;
-    /** The active descriptor (reactive). */
-    activeDescriptor: Readonly<Ref<DockSilhouetteDescriptor | null>>;
-    /** Whether a transition is in flight (the consumer guards re-entrancy / `[data-morphing]`). */
-    transitioning: Readonly<Ref<boolean>>;
-    /**
-     * Transition to the silhouette `toId` — DIFFs the slots by `controlId`, FLIPs the
-     * survivors, detaches the from-only, blooms in the to-only, and drives the fusion
-     * meld for a `bar+pill` target. A no-op if `toId` is unknown or already active.
-     */
-    setSilhouette: (toId: string) => void;
-}
-/**
- * The declarative context→silhouette state machine. Reads a `DockSilhouetteDescriptor[]`
- * MAP; on `setSilhouette` it DIFFs the slots by `controlId` and FLIPs/detaches/blooms via
- * the SHIPPED `ElementMorph` + `springTimingFunction` substrate, ONE `DOCK_SPRING`. The
- * `bar+pill` fusion docks the pill into the bar via `--silhouette-fuse-t`. Compositor-only
- * + PRM-seats. See the module header for the REUSE + the orientation-derived slots + the
- * fusion mechanism.
- *
- * @example
- * ```ts
- * const sil = useDockContextSilhouette({
- *   silhouettes: [
- *     { id: "nav",   kind: "bar",      slots: [...] },
- *     { id: "media", kind: "bar+pill", slots: [{ controlId: "pill", main: 0, cross: -56, size: 240, fuse: true }, ...] },
- *   ],
- *   orientation,
- *   dockRoot,
- *   resolveControl: (id) => slotRefs.value[id] ?? null,
- * })
- * sil.setSilhouette("media") // the pill DOCKS DOWN + MELDS into the bar
- * ```
- */
-export declare function useDockContextSilhouette(options: UseDockContextSilhouetteOptions): UseDockContextSilhouetteReturn;
-/**
- * Compute a detached control's DIRECTION-VECTOR off its slot + the orientation (the
- * fission `vector` — the `dim`-idiom). A control peels along the CROSS axis (the
- * `stack-rail.css` gutter direction the fission media=lateral signature reuses): the sign
- * of `cross` chooses the side, the orientation chooses the axis. This is PURE (exported
- * for the unit test — the slot-diff vector logic is testable without a DOM).
- */
-export declare function detachVector(slot: SilhouetteSlot, orientation: SilhouetteOrientation): {
-    dx: number;
-    dy: number;
-};
-/**
- * PURE slot-diff — exported for the unit test (the diff logic is testable without a DOM).
- * Classifies each controlId across the from/to slot sets: `survivors` (present-in-both →
- * FLIP), `bloomIns` (to-only → BLOOM), `detaches` (from-only → DETACH). This is the
- * load-bearing classification `setSilhouette` runs; testing it directly proves the
- * descriptor-driven state machine is correct without a browser.
- */
-export declare function diffSilhouetteSlots(from: readonly SilhouetteSlot[], to: readonly SilhouetteSlot[]): {
-    survivors: string[];
-    bloomIns: string[];
-    detaches: string[];
-};