@mkbabb/glass-ui 0.2.0 → 2.0.0

package/dist/components/custom/configurator/ConfiguratorLayer.vue.d.ts

@@ -0,0 +1,68 @@
+import { type HTMLAttributes } from "vue";
+/**
+ * <ConfiguratorLayer> — labeled section inside a <Configurator>'s controls
+ * column. Provides a header trigger + chevron affordance + collapsible body.
+ * Authors stack multiple layers to express the per-axis split (per R2 §C:
+ * aurora has Medium / Palette / Flow / Texture / Comp / Nuclei; blob has
+ * Mood / Body / Surface / Color / Motion / Pointer / Render).
+ *
+ * The layer is uncontrolled by default (`defaultOpen` opens at mount);
+ * pass `:open` + `@update:open` for controlled mode (e.g., when a
+ * BouncyTabs / DockLayerGroup at the parent governs which layer is
+ * active).
+ *
+ * # M.W2 Lane A (F-ε-3 fix) — recursion-free reveal
+ *
+ * Earlier versions composed `<Collapsible>` + `<CollapsibleContent>` from
+ * reka-ui to drive the height transition. Under Lighthouse's strict cold-
+ * load discipline (CPU throttle + network throttle + headless Chrome
+ * stable layout gating) this surfaced a watcher-graph race inside reka-
+ * ui's `<Presence>` + `<CollapsibleContent>` height-measurement watchers
+ * — `getComputedStyle(node).animationName` + `getBoundingClientRect()`
+ * reads inside a `watch([isOpen, presentRef.value?.present])` callback
+ * created a non-convergent loop that tripped Vue's 100-iteration
+ * recursion cap on `<Configurator>`.
+ *
+ * This component now uses the canonical CSS-only animated-reveal pattern
+ * (`grid-template-rows: 0fr ↔ 1fr` with `transition-[grid-template-rows]`)
+ * which requires no JS watchers and produces no reactive graph. The
+ * a11y surface (`role="button"` + `aria-expanded` + `aria-controls`)
+ * matches the prior reka-ui shape; consumers do not need to migrate.
+ *
+ * Cf. `docs/tranches/M/audit/W2-Lane-A-F-eps-3-proof.md`.
+ */
+type __VLS_Props = {
+    /** Header label (large, semantic). */
+    label: string;
+    /** Optional sub-label / token reference (small, monospaced). */
+    sub?: string;
+    /** Optional id used by external state (e.g., a sibling tab row). */
+    id?: string;
+    /** Controlled open state. Pair with `@update:open`. */
+    open?: boolean;
+    /** Uncontrolled initial state. */
+    defaultOpen?: boolean;
+    class?: HTMLAttributes["class"];
+    /** Body wrapper class override. */
+    bodyClass?: HTMLAttributes["class"];
+};
+declare var __VLS_6: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_6) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:open": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {
+    defaultOpen: boolean;
+    open: boolean;
+}, {}, {}, {}, 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/configurator/ConfiguratorRow.vue.d.ts

@@ -0,0 +1,63 @@
+import { type HTMLAttributes } from "vue";
+import { type ConfiguratorDensity } from "./density";
+/**
+ * <ConfiguratorRow> — labeled control row for a single field inside a
+ * <ConfiguratorLayer>. Mirrors the demo's PresetEditorField surface
+ * (label + token-name + optional reset + description) but ships from
+ * the library so consumers can compose configurators without re-rolling
+ * the row layout.
+ *
+ * Slot consumes the actual control (Slider, Select, Switch, NumberField,
+ * etc.). The reset button is opt-in via `canReset`; emits a `reset`
+ * event the consumer wires to its own field-clear path.
+ *
+ * # Density axis (N.W2 Lane A)
+ *
+ * The row honors a four-rung density axis (`mobile` | `compact` |
+ * `comfortable` | `spacious`). Resolution order:
+ *
+ * 1. Local `density` prop (highest priority).
+ * 2. `<Configurator>` inject (`CONFIGURATOR_DENSITY_KEY`).
+ * 3. `undefined` — the row keeps its baked-in `gap-1.5 py-2` recipe and
+ *    emits no `data-density` attribute (pre-N.W2 visual preserved).
+ *
+ * When density resolves to a value, the root gets `data-density="…"`
+ * and the token-driven CSS rule overrides the Tailwind gap. The
+ * `"comfortable"` rung is functionally identical to the no-density
+ * fallback; it exists so consumers can be explicit.
+ */
+type __VLS_Props = {
+    /** Display label (top-left, primary). */
+    label: string;
+    /** Optional token name / spec reference (right of label, monospaced). */
+    name?: string;
+    /** Optional helper / value description (below the control). */
+    description?: string;
+    /** Show the reset affordance (top-right). */
+    canReset?: boolean;
+    /**
+     * Density rung. Overrides the value injected by an ancestor
+     * `<Configurator>` when set. Omit to follow the inject (or to fall
+     * back to the pre-N.W2 `gap-1.5 py-2` recipe when there is no
+     * ancestor configurator).
+     */
+    density?: ConfiguratorDensity;
+    class?: HTMLAttributes["class"];
+};
+declare var __VLS_12: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_12) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    reset: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onReset?: (() => 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/configurator/density.d.ts

@@ -0,0 +1,30 @@
+import { type ComputedRef, type InjectionKey } from "vue";
+/**
+ * Density axis for `<Configurator>` + `<ConfiguratorRow>` (N.W2 Lane A).
+ *
+ * - `"mobile"`       — tight gap; for narrow-viewport studios (≤ 480px host).
+ * - `"compact"`      — slightly tighter than the default; dense studios.
+ * - `"comfortable"`  — current default; matches the pre-N.W2 `gap-1.5 py-2` recipe.
+ * - `"spacious"`     — generous gap; demo / settings-page surface.
+ *
+ * The `<Configurator>` provides its `density` prop to descendants via
+ * `provide`/`inject` (key: `configuratorDensity`). A `<ConfiguratorRow>`
+ * may override locally by setting its own `density` prop — prop wins over
+ * inject. When neither is set, the row falls back to `"comfortable"` and
+ * NO `data-density` attribute is emitted, so the pre-N.W2 visual is bit-
+ * for-bit preserved.
+ */
+export type ConfiguratorDensity = "mobile" | "compact" | "comfortable" | "spacious";
+/**
+ * Provide / inject key for the cascading density value. Carries a
+ * `ComputedRef<ConfiguratorDensity>` so descendants stay reactive when
+ * the host swaps density (e.g., viewport-driven mobile/desktop branch).
+ */
+export declare const CONFIGURATOR_DENSITY_KEY: InjectionKey<ComputedRef<ConfiguratorDensity>>;
+export declare function provideConfiguratorDensity(density: ComputedRef<ConfiguratorDensity>): void;
+/**
+ * Befitting silent default — returns `null` when there is no ancestor
+ * `<Configurator>`. The consumer null-coalesces to `undefined` so the
+ * `:data-density` binding emits no attribute (pre-N.W2 visual preserved).
+ */
+export declare function useOptionalConfiguratorDensity(): ComputedRef<ConfiguratorDensity> | null;

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

@@ -0,0 +1,6 @@
+export { default as Configurator } from "./Configurator.vue";
+export { default as ConfiguratorLayer } from "./ConfiguratorLayer.vue";
+export { default as ConfiguratorRow } from "./ConfiguratorRow.vue";
+export type { ConfiguratorPreset, ConfiguratorScrollMode, } from "./Configurator.vue";
+export { CONFIGURATOR_DENSITY_KEY, provideConfiguratorDensity, useOptionalConfiguratorDensity, type ConfiguratorDensity, } from "./density";
+export { useConfiguratorState, type ConfiguratorCloneMode, type ConfiguratorState, type ConfiguratorStateOptions, } from "./useConfiguratorState";

package/dist/components/custom/configurator/useConfiguratorState.d.ts

@@ -0,0 +1,45 @@
+import { type ComputedRef } from "vue";
+import type { ConfiguratorPreset } from "./Configurator.vue";
+export type ConfiguratorCloneMode = "commit-on-write" | "per-preset";
+export interface ConfiguratorStateOptions<T> {
+    readonly presets: readonly ConfiguratorPreset<T>[];
+    readonly initialPreset?: string;
+    /**
+     * Optional deep-clone hook. The default uses `structuredClone`. Pass a
+     * custom cloner for shapes that contain unclonable values (functions,
+     * DOM nodes, etc.).
+     */
+    readonly clone?: (value: T) => T;
+    /**
+     * Optional equality check used by `isDirty`. Default uses JSON-string
+     * equality; sufficient for plain config objects but not for shapes
+     * that contain non-serialisable fields.
+     */
+    readonly equals?: (a: T, b: T) => boolean;
+    /**
+     * Clone-mode strategy. Default `"commit-on-write"` (single live config;
+     * preset switch overwrites). Use `"per-preset"` (aurora shape:
+     * per-preset clone map; edits persist per slot across switches).
+     */
+    readonly cloneMode?: ConfiguratorCloneMode;
+}
+export interface ConfiguratorState<T> {
+    /** Reactive live config. */
+    readonly config: T;
+    /** Current preset id (or `undefined` if `presets` is empty). */
+    readonly activePreset: ComputedRef<string | undefined>;
+    /** True when `config` diverges from the active preset's baseline. */
+    readonly isDirty: ComputedRef<boolean>;
+    /** Switch to a preset by key. */
+    selectPreset(key: string): void;
+    /** Restore `config` to the active preset's baseline. */
+    resetCurrent(): void;
+    /**
+     * Advance to the next preset id (wraps). Pass `-1` to cycle backwards.
+     * No-op for empty presets.
+     */
+    cyclePreset(direction?: 1 | -1): void;
+    /** Look up a preset by key, or `undefined`. */
+    getPreset(key: string): ConfiguratorPreset<T> | undefined;
+}
+export declare function useConfiguratorState<T extends object>(options: ConfiguratorStateOptions<T>): ConfiguratorState<T>;

package/dist/components/custom/confirm-dialog/ConfirmDialog.vue.d.ts

@@ -0,0 +1,32 @@
+type __VLS_Props = {
+    title: string;
+    description?: string;
+    confirmLabel: string;
+    destructive?: boolean;
+    loading?: boolean;
+};
+type __VLS_ModelProps = {
+    "open"?: boolean;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare var __VLS_13: {}, __VLS_36: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_13) => any;
+} & {
+    action?: (props: typeof __VLS_36) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:open": (value: boolean) => any;
+    confirm: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+    onConfirm?: (() => 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/controls/DarkModeToggle.vue.d.ts

@@ -0,0 +1,23 @@
+type DarkModeToggleSize = "sm" | "md" | "lg" | "control" | "dock";
+type __VLS_Props = {
+    passive?: boolean;
+    /**
+     * Button size. `sm` = 28px, `md` = 36px (default), `lg` = 44px.
+     * `control` follows generic control CSS variables; `dock` follows
+     * GlassDock sizing variables.
+     */
+    size?: DarkModeToggleSize;
+    /**
+     * When true, CSS transitions on `<html>` and all descendants are
+     * temporarily suppressed during dark mode toggle to prevent jank.
+     * @default false
+     */
+    disableTransitions?: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    size: DarkModeToggleSize;
+    passive: boolean;
+    disableTransitions: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/custom/disco-glyph/DiscoGlyph.vue.d.ts

@@ -0,0 +1,58 @@
+/**
+ * <DiscoGlyph> — faceted SVG glyph primitive.
+ *
+ * Three layers paint over a single `silhouette` path:
+ *   1. base — the silhouette filled `currentColor` so consumers retain the
+ *      lucide cascade (Vignelli-clean colour register at idle).
+ *   2. facet — an 8-stop linear gradient that simulates ~6 facets cutting
+ *      across the glyph face. `phaseColor` (default `currentColor`) drives
+ *      the hue; in active states a phase var (`--phase-color` or similar)
+ *      reads through. Q.W3.A.3: gradient axis adapts to silhouette via
+ *      `facetAxis` so each consumer picks the axis that cuts *across* its
+ *      dominant stroke direction (CheckDisco's V-shape calls for vertical;
+ *      ArrowRightDisco's horizontal shaft also vertical; PlayDisco's
+ *      triangle works on the diagonal).
+ *   3. cap — a 165° specular catch-light gradient. White at the upper-left,
+ *      transparent past 40%; the polished-metal hot-spot a real disco
+ *      glyph would carry under club lighting.
+ *
+ * Q.W3.A.1 silhouette hand-off: when wrapped in a `<GlyphFace>`, this
+ * primitive publishes its `silhouette` prop upward via the
+ * `GLYPH_FACE_SILHOUETTE_KEY` injection slot, so the GlyphFace cap clips
+ * to the disco silhouette without the wrapping consumer (PrimaryAction)
+ * needing to mirror the path on every glyph swap. The provide/inject
+ * path is reactive — GlyphFace re-reads when the descendant's
+ * `silhouette` prop changes (e.g. PrimaryAction's `glyphFor(state)`
+ * branches across Play / Check / ArrowRight / RotateCcw).
+ *
+ * `useId()` scopes the gradient ids so multiple glyphs on one page do not
+ * collide post-SSR/hydration. The id format mirrors the existing speedtest
+ * conventions (`disco-facet-<id>` / `disco-cap-<id>`).
+ */
+type __VLS_Props = {
+    /** SVG path d-attribute describing the glyph silhouette. */
+    silhouette: string;
+    /** SVG viewBox. Defaults `0 0 24 24`. */
+    viewBox?: string;
+    /** Phase-tinted state — wired through CSS class consumers may hook. */
+    active?: boolean;
+    /** Stop-color for the facet gradient. Defaults `currentColor`. */
+    phaseColor?: string;
+    /**
+     * Axis along which the facet gradient runs. The 8 stops cut
+     * perpendicular to this axis, so a diagonal axis gives diagonal
+     * facets, vertical gives horizontal facets across the glyph,
+     * etc. Q.W3.A.3 default stays diagonal; consumers picking an
+     * axis that cuts across the silhouette's dominant stroke
+     * sharpen the facet read at small render sizes.
+     */
+    facetAxis?: "diagonal" | "horizontal" | "vertical";
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    active: boolean;
+    viewBox: string;
+    phaseColor: string;
+    facetAxis: "diagonal" | "horizontal" | "vertical";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/custom/disco-glyph/index.d.ts

@@ -0,0 +1 @@
+export { default as DiscoGlyph } from "./DiscoGlyph.vue";

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

@@ -0,0 +1,29 @@
+import { type ButtonHTMLAttributes, type HTMLAttributes } from "vue";
+import { type DropdownMenuTriggerProps } from "reka-ui";
+/**
+ * <DockDropdownTrigger> — variable-width DropdownMenu trigger for use inside GlassDock.
+ *
+ * Emits the dock dropdown-trigger class contract. Interactive styling is owned
+ * by src/styles/dock.css. Matches DockIconButton's hover-scale behaviour
+ * unlike DockSelectTrigger, which doesn't scale.
+ *
+ * Consumers provide the button content (icon + text + optional chevron)
+ * via the default slot.
+ */
+type __VLS_Props = DropdownMenuTriggerProps & {
+    type?: ButtonHTMLAttributes["type"];
+    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<{}>, {}, {}, {}, {}, 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/DockIconButton.vue.d.ts

@@ -0,0 +1,30 @@
+import { type ButtonHTMLAttributes, type HTMLAttributes } from "vue";
+/**
+ * <DockIconButton> — fixed-square icon button for use inside GlassDock.
+ *
+ * Emits the dock icon-button class contract. Interactive styling is owned by
+ * src/styles/dock.css so all dock controls share one public style authority.
+ */
+type __VLS_Props = {
+    /** Compact variant: auto-sized instead of fixed 2.5rem square. */
+    compact?: boolean;
+    /** Button type attribute (default: "button" to prevent form submission). */
+    type?: ButtonHTMLAttributes["type"];
+    class?: HTMLAttributes["class"];
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    type: "button" | "reset" | "submit";
+    compact: boolean;
+}, {}, {}, {}, 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/DockLayer.vue.d.ts

@@ -0,0 +1,34 @@
+import type { Component } from "vue";
+/**
+ * <DockLayer> — a named content pane inside a <DockLayerGroup>.
+ *
+ * Layers register themselves with their parent group via provide/inject,
+ * so the group can both render a switcher rail (using each layer's
+ * label/icon) and coordinate crossfade transitions when the active
+ * layer changes.
+ *
+ * O.W2 Lane A — typed-key DI via `useDockLayerGroupContext()` (strict;
+ * throws when used outside `<DockLayerGroup>`). Replaces the prior
+ * `inject("dockLayerGroup", null) + manual !group throw` shape.
+ */
+type __VLS_Props = {
+    /** Stable identifier — referenced by the parent group's `active` v-model. */
+    id: string;
+    /** Human-readable label; used for tooltip + fallback rail glyph. */
+    label?: string;
+    /** Optional icon: a Vue component, or a raw string (rendered as text). */
+    icon?: Component | string;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => 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/DockLayerGroup.vue.d.ts

@@ -0,0 +1,43 @@
+/**
+ * <DockLayerGroup> — a stack of <DockLayer> children with crossfade +
+ * FLIP size animation between layers, and an optional Figma-style
+ * switcher rail built from each child's metadata.
+ *
+ * Usage:
+ *   <DockLayerGroup v-model:active="layer">
+ *     <DockLayer id="assets" label="Assets" :icon="AssetsIcon">...</DockLayer>
+ *     <DockLayer id="layers" label="Layers" :icon="LayersIcon">...</DockLayer>
+ *   </DockLayerGroup>
+ */
+type __VLS_Props = {
+    /** Layout axis; matches `GlassDock.orientation`. Controls FLIP dim. */
+    orientation?: "horizontal" | "vertical";
+    /** Render the embedded switcher rail. Hidden when there is 0 or 1 layer. */
+    showRail?: boolean;
+    /** Rail placement relative to the layer stack. */
+    railPosition?: "start" | "end";
+};
+type __VLS_ModelProps = {
+    "active": string;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare var __VLS_6: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_6) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:active": (value: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:active"?: ((value: string) => any) | undefined;
+}>, {
+    showRail: boolean;
+    railPosition: "start" | "end";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,29 @@
+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/DockTabButton.vue.d.ts

@@ -0,0 +1,39 @@
+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).
+ *
+ * K.W6 Lane B — when the consumer attaches `data-tier="primary"`, the
+ * button composes the canonical `btn-audacious` utility (the lifted
+ * disco-grain + sparkle-sweep + specular-highlight recipe at
+ * `utilities.css`). `dock.css` retains the dock-local phase-tinting +
+ * structural shell on top of the canonical recipe.
+ */
+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

@@ -0,0 +1,96 @@
+type DockDensity = "compact" | "comfortable" | "spacious" | "audacious";
+type __VLS_Props = {
+    collapseDelay?: number;
+    startCollapsed?: boolean;
+    fitContent?: boolean;
+    position?: "fixed" | "inline" | "sticky";
+    alwaysExpanded?: boolean;
+    /** Allow expanded content to wrap to multiple lines. */
+    wrap?: boolean;
+    /**
+     * Visual/behavioral preset.
+     *   `dock`             — the horizontal floating dock (default).
+     *   `rail`             — the vertical icon rail variant used by
+     *                        app chrome (stadium-pill silhouette,
+     *                        `--glass-bg-wash` plate).
+     *   `instrument-strip` — vertical chassis-strip mode for consumer
+     *                        cockpits composing an instrument-cluster
+     *                        gauge column (the speedtest
+     *                        SurveyResultDock consumer). Drops the
+     *                        rail variant's `--radius-pill` extreme
+     *                        and adopts the `<InstrumentChassis>`
+     *                        family's surface vocabulary
+     *                        (`--radius-card` border-radius,
+     *                        `--glass-bg-chassis` background,
+     *                        `--glass-border-quiet` border,
+     *                        `--glass-shadow-quiet` shadow, plus an
+     *                        engraved-bezel `::before` inner stroke
+     *                        matching `InstrumentChassis::before`).
+     *                        No new tokens — lifts the existing
+     *                        chassis vocabulary. AJ-W1-δ / G-AJ-D7.
+     */
+    variant?: "dock" | "rail" | "instrument-strip";
+    /** Corner treatment for vertical rail/tool-palette docks. */
+    shape?: "pill" | "rounded";
+    /**
+     * 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`.
+     */
+    orientation?: "horizontal" | "vertical";
+    /**
+     * Density controls dock padding, gaps, layer height, and inherited
+     * dock control sizing. Root CSS variables can override each density.
+     */
+    density?: DockDensity;
+    /**
+     * When set, the dock root establishes an inline-size container query
+     * subject (`container-type: inline-size; container-name: <value>`)
+     * and lifts its `overflow: hidden` clip so descendants can wrap or
+     * report intrinsic widths at narrow viewports. Consumers query the
+     * named container via `@container <value> (...)` rules.
+     *
+     * Without this prop the dock retains its default `overflow: hidden`
+     * shell — the pre-T behaviour. T.B audit §1.3 cornerstone: the
+     * cluster's container subject must live on the dock primitive, never
+     * on a descendant whose intrinsic size the dock relies on.
+     */
+    containerName?: string;
+};
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+} & {
+    collapsed?: (props: typeof __VLS_3) => any;
+} & {
+    default?: (props: typeof __VLS_5) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
+    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;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    position: "fixed" | "inline" | "sticky";
+    variant: "dock" | "rail" | "instrument-strip";
+    orientation: "horizontal" | "vertical";
+    wrap: boolean;
+    density: DockDensity;
+    collapseDelay: number;
+    alwaysExpanded: boolean;
+    startCollapsed: boolean;
+    fitContent: boolean;
+    shape: "pill" | "rounded";
+}, {}, {}, {}, 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;
+    };
+};