@mkbabb/glass-ui 4.1.0 → 5.0.0

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

@@ -1,176 +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;
-}
-/** 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/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,87 +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;
-}
-/**
- * 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: 0.32;
-    readonly dampingFraction: 0.7;
-};
-/**
- * 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 = 320;

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

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

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,83 +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 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/uniformBridgeWGPU.d.ts

@@ -1,39 +0,0 @@
-import type { OklchStop } from "../../../../composables/color";
-import { type FlowFieldConfig } from "../constants";
-/** The domain half-extent (the lattice spans [-half, half]²; mirrors flowField.ts). */
-export declare const FLOW_DOMAIN_HALF = 0.85;
-export interface FlowGridGeometry {
-    cols: number;
-    count: number;
-    /** The lattice pitch in DOMAIN units (the px pitch mapped to the domain). */
-    pitchDomain: number;
-}
-/** Compile-time lattice cap (mirrors the WGSL storage-buffer array bound). */
-export declare const FLOW_MAX_LATTICE = 16384;
-export declare function flowGridGeometry(gridPitchPx: number, canvasCssMin: number): FlowGridGeometry;
-export declare const FLOW_COMPUTE_UNIFORM_BYTES: number;
-export interface FlowUniformScratch {
-    buffer: ArrayBuffer;
-    f32: Float32Array;
-    i32: Int32Array;
-}
-export declare function createFlowComputeScratch(): FlowUniformScratch;
-/** Pack the compute uniforms in place. */
-export declare function packFlowComputeUniforms(scratch: FlowUniformScratch, config: FlowFieldConfig, timeSec: number, dt: number, geometry: FlowGridGeometry): FlowUniformScratch;
-export declare const FLOW_RENDER_UNIFORM_BYTES: number;
-export declare function createFlowRenderScratch(): FlowUniformScratch;
-/** The base resting brightness (the calm-lattice floor before the band lights a dot). */
-export declare const FLOW_BASE_BRIGHT = 0.22;
-/** The drift-driven size pulse (a subtle breathing; never a re-seed). */
-export declare const FLOW_SIZE_PULSE = 0.4;
-/** Pack the render uniforms in place. */
-export declare function packFlowRenderUniforms(scratch: FlowUniformScratch, config: FlowFieldConfig, timeSec: number, aspect: number, canvasCssMin: number, geometry: FlowGridGeometry, palette: OklchStop[]): FlowUniformScratch;
-/** The byte size of one lattice dot in the storage buffer (vec4<f32>). */
-export declare const FLOW_PARTICLE_BYTES = 16;
-/**
- * Seed the lattice storage buffer: each dot starts AT its anchor origin (the restoring
- * spring needs no initial offset). `(pos.x, pos.y, height=0, |disp|=0)` per index — the
- * compute kernel re-derives the origin from `gridOrigin(index, cols, pitch)` each frame,
- * so the seed only needs the starting position (the lattice settles on the first frames).
- */
-export declare function seedLatticeBuffer(geometry: FlowGridGeometry): Float32Array;

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

@@ -1,35 +0,0 @@
-import { type Ref } from "vue";
-import { type GpuBackend } from "../../../../composables/glass/webgpu/useGpuSubstrate";
-import type { OklchStop } from "../../../../composables/color";
-import type { FlowFieldConfig } from "../constants";
-export interface UseDotFlowFieldOptions {
-    config: FlowFieldConfig;
-    /** Resolve the dot-color palette as OKLCh (the demo themes it; default warm-identity). */
-    getPalette: () => OklchStop[];
-    /** `"capture"` → renderAt-only (the deterministic π capture path). Default `"live"`. */
-    mode?: "live" | "capture";
-}
-/** The uniform handle a consumer wires its lifecycle against (backend-agnostic). */
-export interface DotFlowFieldHandle {
-    /** The resolved backend (`"webgpu"` where supported, else the WebGL2 fragment fallback). */
-    readonly backend: GpuBackend;
-    /** Park the loop (the WCAG-2.2.2 pause seam — `DockBackgroundToggle` wires this). */
-    pause: () => void;
-    /** Re-arm the loop. */
-    resume: () => void;
-    /** Re-arm a parked loop on demand (a pointer/setter that re-introduced motion). */
-    wake: () => void;
-    /** Draw one frame out-of-loop (capture / thumbnail). */
-    renderAt: (timeSec: number) => void;
-    /** The live `prefers-reduced-motion: reduce` state. */
-    readonly reducedMotion: boolean;
-    /** Tear down the renderer + release GPU/GL resources. */
-    dispose: () => void;
-}
-/**
- * Mount the dot-flow-field renderer on `canvasRef`. The WebGPU primary runs the
- * compute+render two-pass over the anchored lattice; the WebGL2 fallback evaluates the SAME
- * `flowField.ts` field as a fullscreen fragment pass (the ONE math source). Returns the
- * uniform lifecycle handle.
- */
-export declare function useDotFlowField(canvasRef: Ref<HTMLCanvasElement | null>, options: UseDotFlowFieldOptions): DotFlowFieldHandle;

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

@@ -1,31 +0,0 @@
-import type { WebGPUCanvasFrame } from "../../../../composables/glass/webgpu/useWebGPUCanvas";
-import type { WebGLCanvasFrame } from "../../../../composables/glass/webgl/useWebGLCanvas";
-import type { OklchStop } from "../../../../composables/color";
-import type { FlowFieldConfig } from "../constants";
-export interface FlowSetupDeps {
-    canvas: HTMLCanvasElement;
-    config: FlowFieldConfig;
-    /** The resolved (ColorResolver) palette stops as OKLCh — re-read each frame so a live palette edit reaches the buffer. */
-    getPalette: () => OklchStop[];
-    /** Demand-gate (the renderer's quiescence layer — substrate-agnostic). */
-    shouldContinue: () => boolean;
-    /**
-     * The per-frame pointer hook — useDotFlowField advances the shared
-     * `usePointerVelocityField` here (the no-own-rAF discipline; the renderer's loop feeds
-     * the push-API tick). ZERO own rAF.
-     */
-    onFrame?: (timeSec: number) => void;
-}
-/**
- * Build the dot-flow-field `setupWGPU(device, context, format)` callback. Closes over the
- * config/palette getters + the renderer's demand gate + the pointer `onFrame` hook.
- */
-export declare function createFlowWGPUSetup(deps: FlowSetupDeps): (device: GPUDevice, context: GPUCanvasContext, format: GPUTextureFormat) => WebGPUCanvasFrame;
-/**
- * Build the `setupGL(gl)` callback the `createGpuSubstrate` WebGL2 path invokes — a clean
- * aurora-class fullscreen fragment pass (the retopology made the dot-lattice + brightness
- * model fragment-friendly; the Canvas2D point-cloud is GONE, clean break). It evaluates
- * the SAME `flowField.ts` height/displacement field the WGSL primary does, splicing the
- * SHARED GLSL color chunk (the ONE color source → no drift between the two backends).
- */
-export declare function createFlowGLSetup(deps: FlowSetupDeps): (gl: WebGL2RenderingContext) => WebGLCanvasFrame;