@mkbabb/glass-ui 4.2.0 → 6.0.0

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

@@ -1,214 +0,0 @@
-import { type ComputedRef } from "vue";
-export type DockDensity = "compact" | "comfortable" | "spacious" | "audacious";
-/**
- * The ONE GlassDock prop shape (AZ.W-DOCK-TAXONOMY — the discriminated union is
- * gone). Every dock — horizontal or vertical — reads the SAME surface; orientation
- * is the single layout axis and the collapse surface applies on both.
- */
-export interface DockProps {
-    fitContent?: boolean;
-    position?: "fixed" | "inline" | "sticky";
-    /**
-     * Never collapse — render permanently expanded; the single opt-OUT of the
-     * collapse↔expand machinery. Default `false` (every dock is collapsible).
-     * AZ.W-DOCK-TAXONOMY — vertical docks are NO LONGER force-pinned here (a
-     * vertical dock morphs its height too; the prior `variant="rail"`
-     * always-expanded-by-construction is removed). A `layout="grid"` dock is
-     * `alwaysExpanded` BY CONTRACT (a 2D tile panel does not read as a collapsible
-     * pill). A vertical nav column that wants the static always-expanded look opts
-     * in via this prop. (A positive `collapsible` boolean was considered and
-     * rejected: Vue coerces an absent boolean prop to `false`, so a `collapsible`
-     * defaulting to `true` would need a `withDefaults` second default-path; the
-     * existing `alwaysExpanded` opt-out — which correctly defaults `false` — is the
-     * one knob, no Vue boolean-trap.)
-     */
-    alwaysExpanded?: boolean;
-    /**
-     * Corner treatment.
-     *   `"pill"`    — the stadium silhouette (default).
-     *   `"rounded"` — a finite rounded radius (`--radius-xl`).
-     *   `"card"`    — the AW.W3b big-dock card shell: a finite concentric
-     *                 radius (`--dock-card-radius`, default `--radius-3xl`)
-     *                 ABOVE 2xl, below pill — does NOT collapse to a stadium.
-     *                 Collapsed it returns to a pill; the pill↔card swap
-     *                 morphs on the `--dock-motion-resize` spring. AX.W56's
-     *                 squircle policy applies `corner-shape:
-     *                 var(--corner-shape-bigdock)` here under `@supports
-     *                 (corner-shape: superellipse(2))` — the big-dock is the ONE
-     *                 surface where the superellipse reads (cards/pills stay
-     *                 round); the border-radius arc is the cross-engine contract.
-     *
-     * Paints on BOTH orientations (AZ.W-DOCK-TAXONOMY — `shape` is no longer
-     * variant-gated; a vertical dock reads `shape="rounded"` for the tool-palette
-     * look, a horizontal dock reads `shape="card"` for the big-dock shell).
-     */
-    shape?: "pill" | "rounded" | "card";
-    /**
-     * Layout axis of the dock. `"horizontal"` (default) lays items out
-     * left-to-right and animates `width`; `"vertical"` lays items out
-     * top-to-bottom and animates `height`. This is the SINGLE layout axis — there
-     * is no `variant` second-way to express "vertical" (AZ.W-DOCK-TAXONOMY).
-     */
-    orientation?: "horizontal" | "vertical";
-    /**
-     * Density controls dock padding, gaps, layer height, and inherited
-     * dock control sizing. Root CSS variables can override each density.
-     */
-    density?: DockDensity;
-    /**
-     * Overflow strategy when the expanded content exceeds the dock's
-     * axis cap (`--dock-max-inline-size` horizontally,
-     * `--dock-max-block-size` vertically). The ONE knob governing every
-     * overflow behaviour (AT.W7-dock-a clean break — collapsed from the
-     * prior `wrap` boolean + `overflow` pair + `containerName` clip-lift,
-     * which all touched overflow divergently).
-     *   `"grow"`   — content grows to fit then overflows visibly past
-     *                the cap (the default; nothing clips or scrolls).
-     *   `"wrap"`   — expanded content wraps to multiple rows via CONTENT-DRIVEN
-     *                intrinsic flex-wrap (the `.dock-overflow-wrap` recipe). The
-     *                dock shrink-wraps to content and caps that intrinsic width
-     *                at `max-inline-size: var(--dock-max-inline-size)`, so the row
-     *                reflows to N rows EXACTLY when its intrinsic width exceeds
-     *                the cap — at ANY viewport width — and collapses to one row
-     *                when it fits (no viewport breakpoint). The wrapped multi-row silhouette lifts
-     *                onto the card/floating shadow tier as the dock expands.
-     *                HORIZONTAL-ONLY: a vertical dock grows-to-fit + clamps via
-     *                `--dock-max-block-size` (its own overflow story), so the
-     *                `.dock-overflow-wrap` class is not emitted for a vertical
-     *                orientation.
-     *   `"scroll"` — the dock becomes the scroll port. Horizontal docks
-     *                scroll the active layer on the inline axis
-     *                (`.dock-scroll-x`); vertical docks scroll on the
-     *                block axis (`.dock-scroll-y`), keeping the
-     *                `max-block-size` cap. The rounded pill masks the
-     *                scroll edge; the scrollbar is hidden. The axis is
-     *                chosen automatically from `orientation`.
-     */
-    overflow?: "grow" | "wrap" | "scroll";
-    /**
-     * 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 silently change the dock's clip shell
-     * (AT.W7-dock-a — the prior clip-lift was folded out; use
-     * `overflow="wrap"` to allow multi-line content).
-     *
-     * ALWAYS-EXPANDED-ONLY (AY.W-DOCK2 §F1): `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;
-    /**
-     * Idle-collapse delay in ms (default 2000). Inert on an always-expanded dock.
-     */
-    collapseDelay?: number;
-    /**
-     * Start in the collapsed state (default true). Applies on BOTH orientations
-     * (AZ.W-DOCK-TAXONOMY — a vertical dock starts collapsed and morphs its block
-     * axis open too). Inert on an always-expanded dock.
-     */
-    startCollapsed?: boolean;
-    /**
-     * In-cap arrangement. `"linear"` (default) lays the active layer out as a
-     * linear row/column. `"grid"` makes the active layer a self-wrapping tile
-     * grid (Launchpad/Stage-Manager track symmetry — `auto-fill` columns of
-     * `--dock-tile-min`). ORTHOGONAL to `overflow` (the OVER-cap strategy):
-     * `layout` is the IN-cap arrangement.
-     *
-     * Hard contract: a `layout="grid"` dock is `alwaysExpanded` (a 2D panel
-     * does not read as a collapsible pill, and no width morph means no
-     * per-frame grid reflow). The canonical pairing is
-     * `shape="card" layout="grid"` (the props stay independent — no
-     * auto-implication of `shape`).
-     */
-    layout?: "linear" | "grid";
-    /**
-     * AZ.W-ADAPTIVE-AUTO Arm 2 (H3 arm a) — the sampled-luminance observer that
-     * DYNAMICALLY refines the W55 declarative bright-bucket darken (the iOS-27
-     * "darken dynamically" register). Default `true` (default-ON for the dock — the
-     * surface most often over a live/bright backdrop). It REFINES the floor (the
-     * unconditional self-engage + the declarative bucket stay the guarantee); 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
-     * observer downsamples it under the dock's box each settle (the ANIMATED-backdrop
-     * case); absent, it stack-walks the painted page background (the static case).
-     */
-    backgroundCanvas?: HTMLCanvasElement | (() => HTMLCanvasElement | null) | string | null;
-    /**
-     * BC.W-DOCK-SEARCH — the dock-as-native-dynamic-search-bar MODE (additive,
-     * default `false`). When true the dock stamps `[data-search]` (the CSS hook the
-     * `dock/search.css` active-field tint seam + the `.glass-menu-row` result rows
-     * target) and renders the `#search` slot INSIDE the existing morph aperture — the
-     * consumer composes `useDockSearch` (the gesture/shrink/dropdown seam) and slots
-     * its search field + fuzzy dropdown there. The pill→field morph is the dock's OWN
-     * `--dock-morph-t` glide (box-inviolate — no second engine). A non-search dock is
-     * byte-identical to HEAD (the slot + the data-attr are present only when authored).
-     */
-    search?: boolean;
-    /**
-     * BD.W-DOCK-CORE (A13 / II.2) — arm the SHIPPED fission seam (additive, default
-     * `false`). When true the dock composes `useDockFission` (the n-ary detach
-     * orchestrator on the SAME `DOCK_SPRING` clock, BESIDE the morph engine — box-
-     * INVIOLATE, never editing `dockMorphContext`), auto-registers every child marked
-     * `data-dock-splittable` as a fission PIECE (its detach vector derived from its
-     * FLIP-measured center relative to the dock center), feeds the seam-tension on
-     * `@pointermove`, and exposes `split()`/`merge()`/`toggle()` via `defineExpose`. A
-     * non-splittable dock is byte-identical to HEAD. The ONE `<GooFilter>` mount must be mounted
-     * once at the app root (the goo `<filter>` the necks reference).
-     */
-    splittable?: boolean;
-    /**
-     * BD.W-DOCK-CORE (A13) — the fission CONTEXT (the `DOCK_SPLIT_SIGNATURES` row): the
-     * detach-vector family + neck stagger. `"nav"` (default) is inward-merge; `"search"`
-     * is a radial bloom; `"media"` is a lateral peel.
-     */
-    splitContext?: "search" | "media" | "nav";
-    /**
-     * BD.W-DOCK-CORE (A13) — where the detached sibling dock lands (reads the split
-     * vector). `"beside"` (default) is the radial/lateral lateral landing; `"above"`/
-     * `"below"` are the V-axis landings.
-     */
-    splitPlacement?: "beside" | "above" | "below";
-    /**
-     * BD.W-DOCK-CORE (A12) — arm the draggable-ITEMS axis (additive, default `false`).
-     * When true every child marked `data-dock-draggable` (or, lacking marks, every
-     * `.dock-icon-button` in the active layer) becomes GRABBABLE: a pointer-capture grab
-     * lets the user pull a dock item and the gesture follows ~1:1 with a volume-preserving
-     * gel-squish (the SHIPPED `useDragMorph` composing kf `Draggable` + `useLiquidFlex`
-     * "tanh" velocity-squish — NO second drag engine), then flings velocity-continuously to
-     * the nearest slot, committing a REORDER via `update:order`. Compositor-only
-     * (`transform: translate` — never a layout property); PRM-safe (the gesture still
-     * functions, the squish off, the release an instant nearest-snap); the roving-tabindex
-     * keyboard contract on the dock controls is preserved (a draggable strip that is
-     * keyboard-dead is the worse failure). A non-draggable dock is byte-identical to HEAD.
-     */
-    draggableItems?: boolean;
-}
-/** The resolved shell-prop computeds the GlassDock SFC binds. */
-export interface DockShellProps {
-    containerStyle: ComputedRef<Record<string, string> | undefined>;
-    collapseDelay: ComputedRef<number>;
-    startCollapsed: ComputedRef<boolean>;
-    layoutValue: ComputedRef<"linear" | "grid">;
-    shape: ComputedRef<"pill" | "rounded" | "card">;
-    orientation: ComputedRef<"horizontal" | "vertical">;
-    density: ComputedRef<DockDensity>;
-    scrollClass: ComputedRef<string | null>;
-    alwaysExpanded: ComputedRef<boolean>;
-    fitContent: ComputedRef<boolean>;
-}
-/**
- * Derive the dock's resolved shell props off the raw `props`. The defaults are
- * applied at each read site via `?? default` (every shared default has exactly one
- * resolution point — the one-path precept).
- */
-export declare function useDockShellProps(props: DockProps): DockShellProps;

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

@@ -1,70 +0,0 @@
-import type { ComputedRef, Ref } from "vue";
-export interface UseDockStateOptions {
-    /** Delay before auto-collapse after mouse leaves (ms) */
-    collapseDelay?: number;
-    /** Root element ref — used for contains() checks */
-    rootEl: Ref<HTMLElement | null>;
-    /** Disable collapse behavior and keep the dock expanded. */
-    alwaysExpanded?: Ref<boolean> | boolean;
-    /** Ref that suppresses click-away during an active dock animation. */
-    isTransitioning?: Ref<boolean>;
-    /** Owner id for dock-owned teleported targets. */
-    dockId?: string;
-    /** Called on every state transition */
-    onStateChange?: (newState: DockState, oldState: DockState) => void;
-}
-export type DockState = "collapsed" | "hover" | "pinned";
-/**
- * Canonical return shape for `useDockState`. Named per the O.W6 Lane A
- * `UseClipboardReturn` precedent + P.W2 Lane D (Pγ.3 "useDockState inline
- * return"); freezes today's surface so consumers wrapping `<GlassDock>` (or
- * authoring a custom dock chassis) can type the composable handle from `/api`
- * or the `/dock` subpath without reaching for `ReturnType<typeof useDockState>`.
- */
-export interface UseDockStateReturn {
-    /** Three-state machine: `"collapsed" | "hover" | "pinned"`. */
-    state: Ref<DockState>;
-    /** `true` whenever `state !== "collapsed"` — derived ref. */
-    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`. */
-    isHeld: ComputedRef<boolean>;
-    /** Mouseenter handler — transitions `collapsed → hover`. */
-    onMouseEnter: () => void;
-    /** Mouseleave handler — schedules `hover → collapsed` after `collapseDelay`. */
-    onMouseLeave: (e?: MouseEvent) => void;
-    /** Focusin handler — transitions `collapsed → hover` (keyboard parity with mouse). */
-    onFocusIn: () => void;
-    /** Focusout handler — schedules `hover → collapsed` when focus leaves the dock. */
-    onFocusOut: (e: FocusEvent) => void;
-    /** Click handler on the collapsed layer — transitions to `pinned`. */
-    onClickCollapsed: () => void;
-    /** Increment hold ref-count; suppresses timer-based collapse. */
-    keepOpen: () => void;
-    /** Decrement hold ref-count; allows timer-based collapse when count reaches 0. */
-    release: () => void;
-    /** Imperative open — forces `state = "hover"` (no-op when `alwaysExpanded`). */
-    expand: () => void;
-    /** Imperative close — forces `state = "collapsed"` (no-op when `alwaysExpanded`). */
-    collapse: () => void;
-}
-/**
- * Dock state machine with three states and ref-counted child holds.
- *
- * ```
- * State Machine:
- *   COLLAPSED ──(mouseenter/focusin)──→ HOVER
- *   HOVER ──(mouseleave + timeout)──→ COLLAPSED
- *   HOVER ──(clickCollapsed)──→ PINNED
- *   PINNED ──(clickOutside)──→ COLLAPSED
- *   Any ──(alwaysExpanded=true)──→ PINNED
- *
- * keepOpen/release ref-counting prevents TIMER-BASED collapse
- * but NOT explicit click-away dismissal (onPointerDownOutside).
- *
- * Teleported targets (reka-ui portals, floating panels, dock popovers)
- * are treated as "inside the dock" for mouse/focus/click-away purposes.
- * ```
- */
-export declare function useDockState(options: UseDockStateOptions): UseDockStateReturn;

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

@@ -1,90 +0,0 @@
-import type { Ref } from "vue";
-/**
- * AX.W01 — the dock single-scalar morph: ONE spring, ONE clock, the whole box.
- *
- * Re-derived from first principles (the e8380d7 single-clock high-water; the
- * 479-line VT-fork accretion is gone). The collapse↔expand (and inner pane-swap)
- * morph runs off ONE normalized analytic spring whose progress scalar (0→1) is
- * written once per frame to `--dock-morph-t` on the `.glass-dock` root. EVERY
- * animated axis — inline-size, padding, border-radius, scale, background / border
- * color, AND the child stagger — is a pure `calc()` read off that one scalar in
- * `dock.css`. NO CSS `transition` on the root morph props; NO View-Transitions
- * fork: the live `SpringProgress` ODE is the single authority on every engine, so
- * iOS interruptible-physics + velocity-continuity retarget are universal, not
- * capability-gated.
- *
- * The morph is a FLIP — the from→to size is measured ONCE per swap (the allowed
- * one-time measurement primitive, never a co-driver), written as `--dock-morph-from`
- * / `--dock-morph-to` px vars on the morphing element, and the live scalar
- * interpolates between them in CSS. Content lays out once at natural size;
- * `overflow:clip` on the morph axis (dock.css, gated on `data-morphing`) makes the
- * box the reveal aperture; the spring-keyed stagger fades the children in-step.
- *
- * Velocity-continuity (the ONE load-bearing iOS piece): a re-toggle mid-flight
- * re-bases the live solver onto the new span from its current velocity (the
- * analytic re-seat keyframes.js owns) — inertia carries, no snap-from-rest. The
- * spring constant is the published `--spring-dock` (response 0.32, ζ 0.7, ~+4.6%
- * overshoot), the SAME analytic ODE the build-time linear() token samples.
- *
- * LIGHT-surface only: `SpringProgress` owns its own rAF via `.play(onFrame)` and
- * carries no static value.js edge. NEVER import `AnimationGroup` / the `./engine`
- * boundary — that pulls value.js into the dock bundle.
- *
- * BOOKED: AY.W-GOD1 — the FLIP-engine FOLD. This standalone engine is a
- * near-duplicate of the orchestrator's FLIP-pin-measure-arm dance
- * (`dockMorphContext.ts:onSwap`), which is the SUPERSET (it carries sibling-rebase
- * this copy lacks). W-DOCK2 found the duplication (H-dock §D3) and BOOKED the fold
- * to W-GOD1 (the GlassDock.vue carve touches the same FLIP code, so the carve is
- * cleaner over ONE engine; folding now would also break the `/dock` `useLayerTransition`
- * public re-export an external consumer reads). Until W-GOD1 lands, `proof:dock-orchestrator-single`'s
- * FLIP DRIFT-GUARD asserts this engine and the orchestrator stay byte-faithful on
- * the load-bearing pin-measure-arm markers, so a divergence in the shared dance REDs.
- * The CANONICAL `DOCK_SPRING` authority is `dock/constants.ts` (the colocation home
- * BOTH this engine and the orchestrator import); `proof:spring-tokens-synced` reads
- * it there, NOT a per-composable copy (W-COLOCATE — the dead-witness fix, continued).
- */
-export interface UseLayerTransitionOptions {
-    /** The container element that owns the stacked layer panes. */
-    containerEl: Ref<HTMLElement | null>;
-    /** The currently active layer id. */
-    activeLayer: Ref<string>;
-    /**
-     * Animation axis. `"horizontal"` morphs the inline axis; `"vertical"` morphs
-     * the block axis. Defaults to horizontal when omitted.
-     */
-    axis?: Ref<"horizontal" | "vertical">;
-    /**
-     * Retained for API parity with the prior VT-typed signature (consumed by
-     * `GlassDock` + `DockLayerGroup`). The single-scalar morph runs ONE symmetric
-     * spring on every engine, so the direction hint is no longer a curve fork — it
-     * is accepted and ignored. Kept so the call sites need no edit.
-     */
-    directionTypes?: (from: string, to: string) => string[];
-}
-export interface UseLayerTransitionReturn {
-    /** Attach to `@transitionend` on the container (kept for call-site parity). */
-    onTransitionEnd(e: TransitionEvent): void;
-    /** The currently active layer id (post-swap). */
-    currentLayer: Ref<string>;
-    /** The layer id currently fading out, or null. */
-    leavingLayer: Ref<string | null>;
-    /**
-     * BB.W-PERF-PRODUCER A′-4 — `true` while the size morph is in flight (the
-     * reactive twin of the `data-morphing` attr). A floating dock consumer reads
-     * this to hold a reka Popper re-position off the morph's critical frames.
-     */
-    morphing: Ref<boolean>;
-    /**
-     * BB.W-PERF-PRODUCER A′-4 — schedule a reka Popper re-position OFF the
-     * synchronous morph flush. Queued while a morph is live (flushed ONCE on
-     * settle, against the final box), else run on the next rAF. Defers the floating
-     * re-position only — NOT the FLIP measure.
-     */
-    deferReposition(cb: () => void): void;
-}
-/**
- * Coordinates the size morph + crossfade between grid-stacked dock layer panes.
- * Reusable at any nesting level (the inner `<DockLayerGroup>` pair AND the outer
- * `GlassDock` collapsed↔expanded pair).
- */
-export declare function useLayerTransition(options: UseLayerTransitionOptions): UseLayerTransitionReturn;

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

@@ -1,98 +0,0 @@
-import type { Component } from "vue";
-/**
- * BC.W-DOCK-STACK-RAIL — one `<DockStack>` member descriptor: a stack member that fans
- * OUT of the macOS hover-expand stack (id + label + glyph + optional select handler).
- * A `<script setup>` SFC cannot re-export a named type through the `export { default }`
- * barrel, so the descriptor lives here (the colocated types home) and the SFC imports
- * it; the barrel re-exports it for consumers typing their `items` array. This is the
- * stack's MEMBER, not a facet chip — the divider-carousel `DockRailItem` is RETIRED
- * (clean break, no alias).
- */
-export interface DockStackItem {
-    /** Stable identifier — the `v-for` key + the selected-member id. */
-    id: string;
-    /** The member's accessible label (the `aria-label` + tooltip). */
-    label: string;
-    /** The member glyph (a `@lucide/vue` icon or any component). */
-    icon?: Component;
-    /** Optional per-member select handler (fired alongside the model write). */
-    onSelect?: () => void;
-    /**
-     * BE.W-DOCK-RAIL-REALIZE — the per-FACET accent hue (the `mode="facets"` context
-     * carousel only — IGNORED by the macOS `mode="stack"` glyph fan). A complete
-     * `<color>` (a consumer DATA/context hue) written to the chip's `--glass-accent`
-     * (the BB.W-GLASS-ACCENT per-instance chromatic-rim axis, `rim.css`/`material.css`),
-     * so each context facet carries its OWN rim+glint hue — the AZ context-carousel
-     * identity. Unset ⇒ the neutral warm-cream rim (the `--glass-accent: transparent`
-     * no-op floor). NOT a plate-background fill (the accent rides the THIN rim/glint;
-     * presets-in-consumers — no consumer hue enters a library token).
-     */
-    accent?: string;
-}
-/**
- * BA.W-DOCK-SECTIONS — the three named zone kinds the declarative `<DockSection>`
- * descriptor renders (the R8-9 "rail core + sections + nav" three-zone gestalt):
- *   - `"rail-core"` — the leading home/brand region (the ℱ wordmark / category trigger).
- *   - `"section"`   — a named, divider-demarcated group of controls; a section
- *                     carrying `layers` composes the existing `DockLayerGroup`/`DockLayer`
- *                     registry (NOT a parallel layer machine).
- *   - `"nav"`       — the trailing nav arrows / utility group.
- */
-export type DockSectionKind = "rail-core" | "section" | "nav";
-/**
- * BA.W-DOCK-SECTIONS — one declarative section descriptor. A consumer passes
- * `sections: readonly DockSectionDescriptor[]` to `<DockSection>` and the dock body
- * renders the tripartite silhouette (rail-core | divided named sections | nav)
- * demarcated by `<DockSeparator>` — the IG-A3 / R8-9 "abstract this into a re-usable
- * component for layering" library gap. A `<script setup>` SFC cannot re-export a named
- * type through its default barrel, so the descriptor lives here (the colocated types
- * home, beside `DockRailItem`) and `DockSection.vue` imports it; the barrel re-exports
- * it for consumers typing their `sections` array.
- */
-export interface DockSectionDescriptor {
-    /** Which of the three zone kinds this descriptor renders. */
-    kind: DockSectionKind;
-    /** Stable identifier — the `v-for` key + the layer-context id for a `section`. */
-    id: string;
-    /** Optional accessible label for the grouped zone. */
-    label?: string;
-    /**
-     * For a `section` kind: the stack members this section carries. When present
-     * (length > 1) the members ride the dock's `#rail` stack (the macOS hover-expand
-     * stack, OUTSIDE the dock box — never re-inflating it). The descriptor names them;
-     * `<DockStack :items>` fans them out.
-     */
-    layers?: readonly DockStackItem[];
-}
-/**
- * The ONE dock-morph spring authority — the iOS-26 interruptible-physics tuning the
- * dock's single `SpringProgress` orchestrator (`dockMorphContext.ts`) AND the
- * `useLayerTransition` engine both read. Co-located here so the `response`/`damping`
- * pair is defined ONCE rather than duplicated at the top of each composable (the two
- * prior copies were a DRY hazard — a re-tune had to touch both).
- */
-export declare const DOCK_SPRING: {
-    readonly response: number;
-    readonly dampingFraction: number;
-};
-/**
- * The CSS properties whose `transitionend` the dock-morph window watches to know a
- * resize-morph has settled (`useDockMorphWindow.ts`). A `transitionend` on any other
- * property is ignored.
- */
-export declare const RESIZE_MORPH_PROPS: Set<string>;
-/** `Symbol()` label for the `DockContext` injection key (`dockContext.ts`). */
-export declare const DOCK_CONTEXT_LABEL = "glass-ui:dock-context";
-/** `Symbol()` label for the `DockLayerGroupContext` injection key (`dockLayerContext.ts`). */
-export declare const DOCK_LAYER_GROUP_LABEL = "glass-ui:dock-layer-group";
-/** `Symbol()` label for the `DockMorphContext` injection key (`dockMorphContext.ts`). */
-export declare const DOCK_MORPH_LABEL = "glass-ui:dock-morph-context";
-/** AZ.W-DOCK-FLICKER — the hover-hysteresis tuning pair (useDockState).
- *  HOVER_INTENT_MS: the intent-dwell before a collapsed→hover expand commits
- *  (a sweeping-edge enter is canceled by the chasing leave inside this window).
- *  EDGE_BAND_PX: the morphing-edge-sweep recheck band — a mid-morph leave with
- *  the pointer still inside (within this band of the moving edge) is the box
- *  edge sweeping past the cursor, not a real exit. */
-export declare const HOVER_INTENT_MS = 60;
-export declare const EDGE_BAND_PX = 24;
-export declare const MORPH_SETTLE_MS = 840;

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

@@ -1,24 +0,0 @@
-export { default as GlassDock } from "./GlassDock.vue";
-export { default as DockLayerGroup } from "./DockLayerGroup.vue";
-export { default as DockLayer } from "./DockLayer.vue";
-export { default as DockIconButton } from "./DockIconButton.vue";
-export { default as DockBackgroundToggle } from "./DockBackgroundToggle.vue";
-export { default as DockTabButton } from "./DockTabButton.vue";
-export { default as DockSelectTrigger } from "./DockSelectTrigger.vue";
-export { default as DockDropdownTrigger } from "./DockDropdownTrigger.vue";
-export { default as DockPopoverTrigger } from "./DockPopoverTrigger.vue";
-export { default as DockSeparator } from "./DockSeparator.vue";
-export { default as DockStack } from "./DockStack.vue";
-export type { DockStackItem } from "./constants";
-export { default as DockSection } from "./DockSection.vue";
-export type { DockSectionDescriptor, DockSectionKind } from "./constants";
-export type { UseDockStateOptions, UseDockStateReturn, DockState } from "./composables";
-export { useLayerTransition } from "./composables";
-export type { UseLayerTransitionOptions, UseLayerTransitionReturn, } from "./composables";
-export { DOCK_CONTEXT_KEY, useDockContext, useOptionalDockContext, provideDockContext, type DockContext, type DockOrientation, type DockLayout, } from "./composables/dockContext";
-export { useDockOrientationMorph, type DockMorphOrientation, type UseDockOrientationMorphOptions, type UseDockOrientationMorphReturn, } from "./composables/useDockOrientationMorph";
-export { useDockCtaReceive, type UseDockCtaReceiveOptions, type UseDockCtaReceiveReturn, type DockCtaReceivePreset, } from "../../../composables/motion/useDockCtaReceive";
-export { useDockSearch } from "./composables";
-export type { UseDockSearchOptions, UseDockSearchReturn } from "./composables";
-export { GooFilter } from "../goo-filter";
-export { useDockFission, DOCK_SPLIT_SIGNATURES, type DockSplitContext, type DockSplitVector, type DockSplitSquishPeak, type DockSplitSignature, type DockFissionPieceRegistration, type DockFissionPieceHandle, type UseDockFissionOptions, type UseDockFissionReturn, } from "./composables/useDockFission";

package/dist/components/custom/dot-flow-field/DotFlowField.vue.d.ts

@@ -1,42 +0,0 @@
-import type { FlowFieldConfig } from "./constants";
-/**
- * DotFlowField — a calm anchored dot-matrix a slow LARGE wave sweeps through
- * (BC.W-VIZ-DOTFLOW retopology — NOT the BB free-advecting particle cloud).
- *
- * Each dot is anchored to a deterministic lattice cell and eases toward its sub-cell
- * displacement target with a restoring spring (no advection, no re-seed); a broad
- * bright iso-band sweeps the lattice, lighting the dots it passes — the low-frequency
- * Gerstner/Tessendorf sum-of-sines height (`composables/flowField.ts`). WebGPU-FIRST:
- * the compute pass pulls the lattice to its target, the render pass draws instanced
- * billboard quads lit by the sweeping band; a pure WebGL2 FRAGMENT fallback evaluates
- * the SAME field where WebGPU is absent (no Canvas2D — the §E "no canvas" mandate). It
- * composes `useDotFlowField` → the `createGpuSubstrate` picker over the ONE canvas
- * lifecycle leaf (offscreen-pause, live-PRM freeze, the shared pointer field) — it never
- * bootstraps its own context.
- *
- * The DEFAULT palette is the warm-cream library identity; the mono-dim-on-near-black
- * reference + the globe mask are DEMO presets (presets-in-consumers — never a library
- * token). The teal-on-navy is GONE entirely (clean break).
- */
-type __VLS_Props = {
-    /** The full author schema (the studio's `useConfiguratorState` model). */
-    config?: FlowFieldConfig;
-    /**
-     * The declarative WCAG-2.2.2 pause seam. `v-model:paused` parks the render loop
-     * (the substrate's `manual` suspend) when `true`. Wire `<DockBackgroundToggle>`'s
-     * `@update:paused` to this `v-model`.
-     */
-    paused?: boolean;
-};
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
-    pause: () => void;
-    resume: () => void;
-    wake: () => void;
-    renderAt: (timeSec: number) => void;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:paused": (value: boolean) => any;
-}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:paused"?: ((value: boolean) => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const _default: typeof __VLS_export;
-export default _default;

package/dist/components/custom/dot-flow-field/composables/flowField.d.ts

@@ -1,104 +0,0 @@
-/** A 2-vector. */
-export interface Vec2 {
-    x: number;
-    y: number;
-}
-/**
- * One Gerstner / Tessendorf wave component. `amplitude` A_i, `wavelength` λ_i (so
- * k_i = 2π/λ_i), `direction` in DEGREES (the unit travel direction), `phase` φ_i.
- * `ω_i = √(g·k_i)` is derived from the dispersion relation, not stored.
- */
-export interface WaveComponent {
-    amplitude: number;
-    wavelength: number;
-    /** Travel direction in degrees (0 = +x). */
-    direction: number;
-    phase: number;
-}
-/** Deep-water gravity constant (normalized; scales the dispersion ω). */
-export declare const FLOW_GRAVITY = 9.81;
-/**
- * The Gerstner-sum velocity v(p,t) = ∇⊥h = (∂h/∂y, −∂h/∂x), ANALYTIC. The single
- * math source the WGSL kernel transcribes. `windSpeed` scales the dispersion ω;
- * `windDirection` (deg) is folded into each component's direction by the caller (the
- * components carry their own absolute direction). Returns the un-normalized flow vector.
- */
-export declare function gerstnerVelocity(p: Vec2, timeSec: number, waves: readonly WaveComponent[], windSpeed: number): Vec2;
-/** The 2D curl of the scalar fbm potential (the JS twin of `curlFBM`). */
-export declare function curlFBM(p: Vec2): Vec2;
-/**
- * The COMPOSITE flow velocity v(p,t): the Gerstner sum-of-sines analytic ∇⊥h PLUS the
- * `curlStrength`-weighted fbm curl-noise braiding term. The SINGLE math source the WGSL
- * compute kernel transcribes; `proof:viz-dotflow` clause F3 round-trips the two paths.
- *
- * RETOPOLOGY (BC.W-VIZ-DOTFLOW). The curl domain-scale dropped 1.7→0.55 (coarse braiding,
- * not fine chatter) per the §3.2 regime inversion. The velocity is no longer an advection
- * integrand (the lattice does not advect) — it is the DISPLACEMENT field's perp-gradient
- * source. `sampleDisplacement` is the per-frame sub-cell offset; `sampleVelocity` stays as
- * the round-trip anchor + the analytic ∇⊥h the displacement reads.
- */
-export declare function sampleVelocity(p: Vec2, timeSec: number, waves: readonly WaveComponent[], windSpeed: number, curlStrength: number): Vec2;
-/** The cursor-vortex lever set (the √φ-laddered radius + the spin/drag/burst gains). */
-export interface VortexParams {
-    cursor: Vec2;
-    /** Pointer velocity (domain units / sec). */
-    pointerVel: Vec2;
-    /** Flick-burst impulse 0..1. */
-    burst: number;
-    /** Pointer active? (inert when false — the vortex is off). */
-    active: boolean;
-    radius: number;
-    spin: number;
-    dragGain: number;
-    burstShove: number;
-}
-/**
- * The velocity the cursor injects at `p` — the perturbation `cs_flow` adds to the curl
- * current. A true tangential vortex (∇⊥ of the radial), plus a drag-along (the streamlines
- * follow the gesture) and a radial flick shove (the shockwave), all gaussian-falling off the
- * vortex radius. Returns the un-normalized perturbation in domain/sec.
- */
-export declare function pointerVortex(p: Vec2, v: VortexParams): Vec2;
-/** The shipped domain half-extent (the lattice is laid out over [-half, half]²). */
-export declare const FLOW_DOMAIN_HALF = 0.85;
-/**
- * The deterministic lattice origin for a particle index — the WGSL `instance_index →
- * origin` mapping matches this EXACTLY (the F3 round-trip anchor). `cols` columns, square
- * pitch in DOMAIN units; the grid is centered on the origin so the field reads symmetric.
- * Index `i` walks row-major (`col = i % cols`, `row = floor(i / cols)`).
- */
-export declare function gridOrigin(index: number, cols: number, pitch: number): Vec2;
-/**
- * The scalar Gerstner HEIGHT at an origin — the brightness driver (the moving bright
- * stripe the lattice paints). `h(o,t) = Σ_i A_i·sin(k_i·(D_i·o) − ω_i·t + φ_i)`, the SAME
- * sum the velocity derives from (no second wave table). The brightness field reads at the
- * ANCHOR (`o`), not the live position, so the sweep is stable + low-frequency.
- */
-export declare function sampleHeight(o: Vec2, timeSec: number, waves: readonly WaveComponent[], windSpeed: number): number;
-/**
- * The sub-cell DISPLACEMENT for an origin — the divergence-free ∇⊥h (the Gerstner perp-
- * gradient) PLUS a faint coarse curl break. The dot eases toward `o + disp·displaceAmp`
- * (the restoring spring lives in the kernel); this is the target offset, NOT an advection
- * step. Capped LOW by `displaceAmp` so the dot never leaves its cell by > ~0.5 pitch.
- */
-export declare function sampleDisplacement(o: Vec2, timeSec: number, waves: readonly WaveComponent[], windSpeed: number, curlStrength: number): Vec2;
-/**
- * The sweeping bright-stripe band: a `smoothstep` band centered `center` width `width`
- * over the normalized height — the moving iso-band that lights the dots it passes. The
- * band is symmetric about the center (a soft ridge crossing the lattice as `h` sweeps).
- */
-export declare function waveBand(h: number, center: number, width: number): number;
-/**
- * Build the wave ladder about a dominant wind direction. BC.W-VIZ-DOTFLOW REGIME
- * INVERSION (research/viz/dot-flow-field.md §3.2): the LOW-frequency coherent regime — a
- * LARGE base wavelength (≈½–1 period across the view → ONE dominant sweeping wave), 2-3
- * octaves (no fine chatter), a steep amplitude persistence (×0.38 → the base wave
- * dominates, detail a whisper), the λ falloff floored so the finest λ ≥ ~⅓ view. The
- * directions spread MODESTLY about `windDirection` (the sweep reads as ONE coherent form,
- * not a braided delta).
- *
- * `lambda0Mul` is λ₀ as a MULTIPLE of the domain extent (default 2.5 — the §1 target);
- * `octaves` is 2-3 (the coherent band). Amplitudes follow the Phillips falloff × the
- * per-octave persistence so the field stays energy-realistic.
- */
-export declare function buildWaveLadder(windDirection: number, octaves?: number, lambda0Mul?: number): WaveComponent[];

package/dist/components/custom/dot-flow-field/composables/flowGLProgram.d.ts

@@ -1,8 +0,0 @@
-export declare function compileGL(gl: WebGL2RenderingContext, type: number, src: string): WebGLShader;
-export declare function linkGL(gl: WebGL2RenderingContext, vsSrc: string, fsSrc: string): WebGLProgram;
-/** Probe whether an internal format is color-renderable as a float FBO target (R-A). */
-export declare function probeRenderable(gl: WebGL2RenderingContext, internal: number, type: number): boolean;
-/** Pack a Float32Array to half-float (RGBA16F upload) — the RGBA32F-absent fallback (R-A). */
-export declare function float32ToHalf(src: Float32Array): Uint16Array;
-/** IEEE-754 float32 → float16 bits (the standard round-to-nearest packing). */
-export declare function f32ToF16(val: number): number;