@vanduo-oss/vue 0.1.0

package/dist/components/VdSelect.vue.d.ts

@@ -0,0 +1,27 @@
+interface SelectOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+interface Props {
+    modelValue: string;
+    options: readonly SelectOption[];
+    name?: string;
+    id?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    required?: boolean;
+}
+declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string) => any;
+}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+}>, {
+    id: string;
+    name: string;
+    required: boolean;
+    disabled: boolean;
+    placeholder: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VdSidenav.vue.d.ts

@@ -0,0 +1,35 @@
+interface Props {
+    modelValue: boolean;
+    placement?: "left" | "right" | "top" | "bottom";
+    title?: string;
+    closeOnBackdrop?: boolean;
+    closeOnEsc?: boolean;
+}
+declare var __VLS_7: {}, __VLS_9: {}, __VLS_11: {};
+type __VLS_Slots = {} & {
+    header?: (props: typeof __VLS_7) => any;
+} & {
+    default?: (props: typeof __VLS_9) => any;
+} & {
+    footer?: (props: typeof __VLS_11) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: boolean) => any;
+    close: () => any;
+}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+    onClose?: (() => any) | undefined;
+}>, {
+    title: string;
+    closeOnBackdrop: boolean;
+    placement: "left" | "right" | "top" | "bottom";
+    closeOnEsc: 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/VdSkeleton.vue.d.ts

@@ -0,0 +1,16 @@
+type Shape = "text" | "circle" | "rect" | "card" | "button";
+type Size = "sm" | "md" | "lg" | "xl";
+interface Props {
+    shape?: Shape;
+    size?: Size;
+    width?: string;
+    lines?: number;
+}
+declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    size: Size;
+    shape: Shape;
+    width: string;
+    lines: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VdSpinner.vue.d.ts

@@ -0,0 +1,11 @@
+type Size = "sm" | "md" | "lg";
+interface Props {
+    size?: Size;
+    label?: string;
+}
+declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    label: string;
+    size: Size;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VdTable.vue.d.ts

@@ -0,0 +1,22 @@
+type Variant = "primary" | "secondary" | "success" | "warning" | "error" | "info";
+interface Column {
+    key: string;
+    label: string;
+    variant?: Variant;
+}
+interface Props {
+    columns: readonly Column[];
+    rows: readonly Record<string, string | number>[];
+    striped?: boolean;
+    bordered?: boolean;
+    hover?: boolean;
+    caption?: string;
+}
+declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    caption: string;
+    bordered: boolean;
+    striped: boolean;
+    hover: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VdTabs.vue.d.ts

@@ -0,0 +1,25 @@
+interface Tab {
+    id: string;
+    label: string;
+}
+interface Props {
+    tabs: Tab[];
+    modelValue: string;
+}
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string) => any;
+}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string) => 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/VdToast.vue.d.ts

@@ -0,0 +1,11 @@
+import type { ToastEntry } from "../composables/useToast";
+type __VLS_Props = {
+    toast: ToastEntry;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    dismiss: (id: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onDismiss?: ((id: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VdToastContainer.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VdTooltip.vue.d.ts

@@ -0,0 +1,20 @@
+type Position = "top" | "bottom" | "left" | "right";
+interface Props {
+    text: string;
+    position?: Position;
+}
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    position: Position;
+}, {}, {}, {}, 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/VdTransfer.vue.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Reactive reimplementation of framework/js/components/transfer.js — a dual-list
+ * picker generated from a `data-vd-transfer` JSON array. Reproduces the
+ * framework's generated DOM (`.vd-transfer` → panels + actions), per-panel
+ * search, checkbox selection, and the move buttons. Dispatches a native
+ * `transfer:change` CustomEvent so the documented
+ * `el.addEventListener('transfer:change', ...)` API works.
+ *
+ * Two fixes-to-documented-intent vs the Vanilla JS:
+ *  - items use `.is-selected` (what transfer.css actually styles); the docs API
+ *    table's `.is-checked` is a stale typo.
+ *  - the event detail is `{ selected, available }` (the documented shape used by
+ *    the demo snippet's `e.detail.selected`); the Vanilla JS fired the wrong
+ *    `{ source, target }`, so the documented `e.detail.selected` was undefined.
+ */
+interface TransferItem {
+    id: string;
+    label: string;
+}
+type __VLS_Props = {
+    items: TransferItem[];
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
+    getSelected: () => string[];
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VdTree.vue.d.ts

@@ -0,0 +1,26 @@
+import { type TreeNode } from "./VdTreeNode.vue";
+/**
+ * Reactive reimplementation of framework/js/components/tree.js — renders
+ * hierarchical `data-vd-tree` JSON as an expand/collapse tree with optional
+ * checkbox selection and parent→child cascade. Reproduces the framework's
+ * generated DOM (`.vd-tree[role=tree]` → `.vd-tree-node` → `.vd-tree-node-content`
+ * → `.vd-tree-children`), `getChecked()`, and keyboard navigation.
+ *
+ * Fixes-to-documented-intent vs the Vanilla JS:
+ *  - fires `tree:toggle` with `{ id, open }` (listed in the docs API table but
+ *    never dispatched by the Vanilla JS) and `tree:check` with the documented
+ *    `{ checked: string[], node: string }` shape (Vanilla fired a single
+ *    `{ id, checked: boolean, label }`).
+ *  - Arrow Left/Right collapse/expand the focused branch (documented keyboard
+ *    support the Vanilla JS omitted; it only handled Up/Down).
+ */
+type __VLS_Props = {
+    nodes: TreeNode[];
+    checkbox?: boolean;
+    cascade?: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
+    getChecked: () => string[];
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/VdTreeNode.vue.d.ts

@@ -0,0 +1,22 @@
+/** A single recursive tree node — see VdTree.vue for the data model and events. */
+export interface TreeNode {
+    id?: string;
+    label?: string;
+    icon?: string;
+    open?: boolean;
+    checked?: boolean;
+    children?: TreeNode[];
+}
+type __VLS_Props = {
+    node: TreeNode;
+    checkbox: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    toggle: (node: TreeNode) => any;
+    check: (node: TreeNode, checked: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onToggle?: ((node: TreeNode) => any) | undefined;
+    onCheck?: ((node: TreeNode, checked: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/primitives/VdBox.vue.d.ts

@@ -0,0 +1,22 @@
+type Space = "0" | "fib-1" | "fib-2" | "fib-3" | "fib-5" | "fib-8" | "fib-13" | "fib-21" | "fib-34" | "fib-55";
+interface Props {
+    as?: keyof HTMLElementTagNameMap;
+    /** Fibonacci padding step (maps to `data-pad`). */
+    pad?: Space;
+}
+declare var __VLS_8: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_8) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    as: keyof HTMLElementTagNameMap;
+    pad: Space;
+}, {}, {}, {}, 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/primitives/VdCenter.vue.d.ts

@@ -0,0 +1,25 @@
+type Max = "fib-377" | "fib-610" | "fib-987";
+type Axis = "both" | "horizontal" | "vertical";
+interface Props {
+    as?: keyof HTMLElementTagNameMap;
+    /** Max content width (maps to `data-max`). */
+    max?: Max;
+    /** Also center children along an axis (maps to `data-axis`). */
+    axis?: Axis;
+}
+declare var __VLS_8: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_8) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    max: Max;
+    as: keyof HTMLElementTagNameMap;
+}, {}, {}, {}, 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/primitives/VdCover.vue.d.ts

@@ -0,0 +1,25 @@
+type Min = "screen" | "half" | "fib-610" | "fib-987";
+type Gap = "fib-3" | "fib-5" | "fib-8";
+interface Props {
+    as?: keyof HTMLElementTagNameMap;
+    /** Minimum height (maps to `data-min`). */
+    min?: Min;
+    /** Gap between centered children (maps to `data-gap`). */
+    gap?: Gap;
+}
+declare var __VLS_8: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_8) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    as: keyof HTMLElementTagNameMap;
+    min: Min;
+}, {}, {}, {}, 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/primitives/VdFrame.vue.d.ts

@@ -0,0 +1,20 @@
+type Ratio = "golden" | "golden-portrait" | "square" | "16-9" | "4-3" | "3-2";
+interface Props {
+    /** Aspect ratio (maps to `data-ratio`). */
+    ratio?: Ratio;
+}
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    ratio: Ratio;
+}, {}, {}, {}, 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/primitives/VdInline.vue.d.ts

@@ -0,0 +1,20 @@
+type Space = "0" | "fib-1" | "fib-2" | "fib-3" | "fib-5" | "fib-8" | "fib-13" | "fib-21" | "fib-34" | "fib-55";
+interface Props {
+    /** Fibonacci gap between wrapped inline items (maps to `data-gap`). */
+    gap?: Space;
+}
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    gap: Space;
+}, {}, {}, {}, 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/primitives/VdStack.vue.d.ts

@@ -0,0 +1,22 @@
+type Space = "0" | "fib-1" | "fib-2" | "fib-3" | "fib-5" | "fib-8" | "fib-13" | "fib-21" | "fib-34" | "fib-55";
+interface Props {
+    /** Fibonacci gap between stacked children (maps to `data-gap`). */
+    gap?: Space;
+    as?: "div" | "section" | "ul" | "ol";
+}
+declare var __VLS_8: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_8) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    as: "div" | "section" | "ul" | "ol";
+    gap: Space;
+}, {}, {}, {}, 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/primitives/VdSwitcher.vue.d.ts

@@ -0,0 +1,24 @@
+type Threshold = "fib-377" | "fib-610" | "fib-987";
+type Gap = "fib-3" | "fib-5" | "fib-8";
+interface Props {
+    /** Width below which children stack (maps to `data-threshold`). */
+    threshold?: Threshold;
+    /** Gap between items (maps to `data-gap`). */
+    gap?: Gap;
+}
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    gap: Gap;
+    threshold: Threshold;
+}, {}, {}, {}, 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/composables/useAffix.d.ts

@@ -0,0 +1,2 @@
+import { type Ref } from "vue";
+export declare function useAffix(root: Ref<HTMLElement | null>): void;

package/dist/composables/useDatepicker.d.ts

@@ -0,0 +1,2 @@
+import { type Ref } from "vue";
+export declare function useDatepicker(root: Ref<HTMLElement | null>): void;

package/dist/composables/useDraggable.d.ts

@@ -0,0 +1,9 @@
+import { type Ref } from "vue";
+/**
+ * Reproduces `VanduoDraggable.init(root)` from
+ * `framework/js/components/draggable.js`: scans `root` for `.vd-draggable`
+ * elements (or with attribute `data-vd-draggable`) and wires pointer drag
+ * + drop-target detection. The framework global handles per-instance state;
+ * this composable wires on mount and tears down on unmount via `destroyAll()`.
+ */
+export declare function useDraggable(root: Ref<HTMLElement | null>): void;

package/dist/composables/useDropdown.d.ts

@@ -0,0 +1,20 @@
+import { type Ref } from "vue";
+/**
+ * Reproduces `VanduoDropdown.init(root)` from `framework/js/components/dropdown.js`:
+ * scans `root` for `.vd-dropdown` containers, wires toggle / menu / keyboard /
+ * outside-click / typeahead, and tears down on unmount.
+ *
+ * The framework JS already exposes a global, so we do NOT re-implement the
+ * logic. Instead, `init(root)` is called once on mount; the framework's own
+ * lifecycle (registered via `Vanduo.register('dropdown', …)`) handles each
+ * dropdown's per-instance wiring, and `VanduoDropdown.destroyAll()` runs on
+ * unmount so Vue's patch-driven DOM doesn't leave stale listeners behind.
+ *
+ * Notes:
+ *   - The framework tracks instances in a Map keyed by the `.vd-dropdown`
+ *     element. Vue's diffing may re-use the same element across re-renders,
+ *     so calling `init` twice is safe (the Map dedupes).
+ *   - `VanduoDropdown.destroyAll()` is the canonical teardown path called from
+ *     `Vanduo.destroy(root)`.
+ */
+export declare function useDropdown(root: Ref<HTMLElement | null>): void;

package/dist/composables/useExpandingCards.d.ts

@@ -0,0 +1,10 @@
+import { type Ref } from "vue";
+/**
+ * Reproduces `VanduoExpandingCards.init(root)` from
+ * `framework/js/components/expanding-cards.js`: scans `root` for
+ * `.vd-expanding-cards` containers and wires the click-to-expand behaviour
+ * (one card expands to fill, others shrink to a thumbnail strip). The framework
+ * global handles per-container state; this composable wires on mount and tears
+ * down on unmount via `destroyAll()`.
+ */
+export declare function useExpandingCards(root: Ref<HTMLElement | null>): void;

package/dist/composables/useFlow.d.ts

@@ -0,0 +1,13 @@
+import { type Ref } from "vue";
+/**
+ * Reproduces `VanduoFlow.init()` from `framework/js/components/flow.js`:
+ * scans `root` for `.vd-flow` / `.vd-carousel` carousels and wires slide
+ * transitions (slide + fade), prev/next controls, dot indicators, keyboard
+ * arrows, pointer/touch swipe, and autoplay (pause on hover/focus).
+ *
+ * Indicator bridge: the docs markup places bare `<button>`s inside
+ * `.vd-flow-indicators`, but the framework CSS/JS target `.vd-flow-indicator`.
+ * We add that class here so indicators render as dots and become interactive —
+ * matching the component's clear design intent.
+ */
+export declare function useFlow(root: Ref<HTMLElement | null>): void;

package/dist/composables/useFocusTrap.d.ts

@@ -0,0 +1,6 @@
+import { type Ref } from "vue";
+export declare const useFocusTrap: (container: Ref<HTMLElement | null>) => {
+    active: Ref<boolean>;
+    activate: () => void;
+    deactivate: () => void;
+};

package/dist/composables/useGlass.d.ts

@@ -0,0 +1,8 @@
+import { type Ref } from "vue";
+/**
+ * Reproduces `framework/js/components/glass.js`: scroll-aware glass activation.
+ * For each `[data-glass-scroll]` element, observes a sentinel (the
+ * `data-glass-sentinel` selector, else the previous sibling) and toggles
+ * `.is-glass-active` when that sentinel scrolls out of / back into view.
+ */
+export declare function useGlass(root: Ref<HTMLElement | null>): void;

package/dist/composables/useImageBox.d.ts

@@ -0,0 +1,9 @@
+import { type Ref } from "vue";
+/**
+ * Reproduces `VanduoImageBox.init(root)` from
+ * `framework/js/components/image-box.js`: scans `root` for `.vd-image-box`
+ * elements and wires hover-reveal caption + click-to-zoom behaviour. The
+ * framework global handles per-instance state; this composable wires on mount
+ * and tears down on unmount via `destroyAll()`.
+ */
+export declare function useImageBox(root: Ref<HTMLElement | null>): void;

package/dist/composables/useKeyboardNav.d.ts

@@ -0,0 +1,10 @@
+import { type Ref } from "vue";
+export interface UseKeyboardNavOptions {
+    itemSelector: string;
+    onSelect?: (index: number) => void;
+    onEscape?: () => void;
+}
+export declare const useKeyboardNav: (container: Ref<HTMLElement | null>, options: UseKeyboardNavOptions) => {
+    activeIndex: Ref<number>;
+    setItems: (count: number) => void;
+};

package/dist/composables/useMorph.d.ts

@@ -0,0 +1,10 @@
+import { type Ref } from "vue";
+/**
+ * Reproduces `framework/js/components/morph.js`: a liquid wave content-swap on
+ * click for `.vd-morph` / `[data-vd-morph]` elements. Auto-creates the
+ * `.vd-morph-wave` / `.vd-morph-shine` layers, originates the wave at the
+ * pointer, adds `.is-morphing` for the animation window, then swaps
+ * `.vd-morph-current` ⇄ `.vd-morph-next`. `[data-vd-morph="manual"]` opts out
+ * of the click handler.
+ */
+export declare function useMorph(root: Ref<HTMLElement | null>): void;

package/dist/composables/useMorphBadges.d.ts

@@ -0,0 +1,9 @@
+import { type Ref } from "vue";
+/**
+ * Ports the docs-only multi-state morph badge cycling from
+ * `docs/js/modules/demos.js` (`initSectionDemos`). Wires
+ * `[data-vd-morph="manual"][data-morph-states]` badges to cycle through
+ * `data-morph-states` / `-classes` / `-icons` on click, swapping the badge
+ * variant class and the current/next content with the morph wave.
+ */
+export declare function useMorphBadges(root: Ref<HTMLElement | null>): void;

package/dist/composables/useNavbarGlassScroll.d.ts

@@ -0,0 +1,7 @@
+import { type Ref } from "vue";
+/**
+ * Reproduces `framework/js/components/navbar.js` initScrollWatcher:
+ * toggles scroll-aware glass/transparent behaviour for a navbar element.
+ * Threshold: `data-scroll-threshold` attribute (px) or the navbar's own height.
+ */
+export declare function useNavbarGlassScroll(navbarRef: Ref<HTMLElement | null>): Ref<boolean>;

package/dist/composables/useParallax.d.ts

@@ -0,0 +1,9 @@
+import { type Ref } from "vue";
+/**
+ * Reproduces `framework/js/components/parallax.js`: layers inside a
+ * `.vd-parallax` container translate at speed-scaled rates on a
+ * rAF-throttled scroll listener. Container speed comes from
+ * `.vd-parallax-slow|medium|fast` (0.5 / 1 / 1.5); per-layer rate from
+ * `data-parallax-speed`. Disabled entirely under prefers-reduced-motion.
+ */
+export declare function useParallax(root: Ref<HTMLElement | null>): void;

package/dist/composables/usePopover.d.ts

@@ -0,0 +1,9 @@
+import { type Ref } from "vue";
+/**
+ * Wires the framework's bubble/popover component over `root`. The shipped
+ * framework registers this as `bubble` (`window.VanduoBubble`) and scans for
+ * `[data-vd-bubble]` / `[data-vd-popover]` triggers — building the panel from
+ * attributes (`data-vd-bubble`, `-title`, `-placement`). This composable calls
+ * `init(root)` on mount and tears down on unmount via `destroyAll()`.
+ */
+export declare function usePopover(root: Ref<HTMLElement | null>): void;

package/dist/composables/useRipple.d.ts

@@ -0,0 +1,9 @@
+import { type Ref } from "vue";
+/**
+ * Reproduces `VanduoRipple.init(root)` from `framework/js/components/ripple.js`:
+ * adds a click-spawned ripple element to any element matching `.vd-ripple`
+ * (or with the attribute `data-vd-ripple`). The framework global owns the
+ * per-element state and cleanup, so this composable simply wires the root on
+ * mount and lets the framework tear down on unmount via `destroyAll(root)`.
+ */
+export declare function useRipple(root: Ref<HTMLElement | null>): void;

package/dist/composables/useScrollspy.d.ts

@@ -0,0 +1,7 @@
+import { type Ref } from "vue";
+export declare const useScrollspy: (ids: string[], options?: {
+    offset?: number;
+    rootMargin?: string;
+}) => {
+    activeId: Ref<string | null>;
+};

package/dist/composables/useSearch.d.ts

@@ -0,0 +1,13 @@
+import { type Ref } from "vue";
+/**
+ * Wires the framework search helper against `root`. Sources registered with
+ * `VanduoSearch.register()` are independent of mounting; the composable is a
+ * thin lifecycle hook so vd2 consumers can mount sources alongside a search
+ * overlay container.
+ *
+ * Per-source `fetch` functions are defined by the caller (see
+ * `src/stores/search.ts` for the default vd2 sources). This composable does
+ * NOT manage source registration — that happens in app-level code so the
+ * registry outlives any single component instance.
+ */
+export declare function useSearch(root: Ref<HTMLElement | null>): void;

package/dist/composables/useSidenav.d.ts

@@ -0,0 +1,14 @@
+import { type Ref } from "vue";
+/**
+ * Reproduces the open/close behavior of
+ * `framework/js/components/sidenav.js` for `.vd-sidenav` and `.vd-offcanvas`
+ * drawers: `[data-sidenav-toggle="#id"]` triggers, a body-level overlay,
+ * close button, overlay-click (unless `data-backdrop="static"`), Escape
+ * (unless `data-keyboard="false"`), body scroll-lock, `data-vd-position`
+ * direction class, and `sidenav:open` / `sidenav:close` events.
+ *
+ * The Vanilla portal-to-body + push/fixed/resize handling is omitted: the demo
+ * drawers are `position: fixed`, so they overlay the viewport without moving in
+ * the DOM, which keeps this from fighting Vue's ownership of the elements.
+ */
+export declare function useSidenav(root: Ref<HTMLElement | null>): void;