@vui-rs/ui 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,765 @@
+import { PropType, Ref } from "@vue/runtime-core";
+import { DispatchableEvent, SPINNER_PRESETS, SpinnerPreset, SpinnerPreset as SpinnerPreset$1, VuiSpinner } from "@vui-rs/vue";
+
+//#region src/fuzzy.d.ts
+/** A successful fuzzy match: a relevance score (higher is better) + matched char positions. */
+interface FuzzyMatch {
+  score: number;
+  indices: number[];
+}
+/**
+ * Greedy left-to-right subsequence match. Returns `null` when `query` is not a
+ * subsequence of `text`. An empty query matches everything with score 0 (so an
+ * empty search box shows the full list in its original order).
+ */
+declare function fuzzyMatch(query: string, text: string): FuzzyMatch | null;
+/** An item ranked by `fuzzyFilter`: the original item plus its match metadata. */
+interface FuzzyRanked<T> {
+  item: T;
+  score: number;
+  indices: number[];
+}
+/**
+ * Filter + rank `items` against `query` by the text `key` returns for each item.
+ * Non-matches are dropped; the rest come back best-score first. Ties keep the
+ * original order (the sort is stable), so an empty query is an identity filter.
+ */
+declare function fuzzyFilter<T>(query: string, items: readonly T[], key: (item: T) => string): Array<FuzzyRanked<T>>;
+//#endregion
+//#region src/use-focus-trap.d.ts
+/**
+ * Capture/restore focus around a modal's open state. Pass a reactive getter for
+ * whether the modal is open; when it flips false (or the component unmounts) the
+ * previously focused node is re-focused.
+ */
+declare function useFocusTrap(isOpen: () => boolean): void;
+//#endregion
+//#region src/dialog.d.ts
+type DialogSize = 'small' | 'medium' | 'large' | 'xlarge';
+declare const VuiDialog: import("@vue/runtime-core").DefineComponent<import("@vue/runtime-core").ExtractPropTypes<{
+  /** v-model: whether the dialog is open. */open: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  title: {
+    type: StringConstructor;
+    default: string;
+  };
+  size: {
+    type: PropType<DialogSize>;
+    default: string;
+  }; /** Backdrop dim strength (0..1 brightness multiplier); `false` for none. */
+  backdrop: {
+    type: PropType<number | boolean>;
+    default: number;
+  }; /** Esc closes the dialog (emits `update:open=false` + `close`). */
+  closeOnEsc: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  /**
+   * Auto-focus the panel itself on open. Default `true` for plain content
+   * dialogs (so they receive Esc). Variants with their own focusable control
+   * (select, input, buttons) pass `false` and focus that control instead; Esc
+   * still bubbles up to the panel's handler from the focused child.
+   */
+  autofocus: {
+    type: BooleanConstructor;
+    default: boolean;
+  }; /** Override the panel width (columns); defaults to the `size` preset. */
+  width: {
+    type: NumberConstructor;
+    default: undefined;
+  };
+}>, () => import("@vue/runtime-core").VNode<import("@vue/runtime-core").RendererNode, import("@vue/runtime-core").RendererElement, {
+  [key: string]: any;
+}> | null, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, ("close" | "update:open")[], "close" | "update:open", import("@vue/runtime-core").PublicProps, Readonly<import("@vue/runtime-core").ExtractPropTypes<{
+  /** v-model: whether the dialog is open. */open: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  title: {
+    type: StringConstructor;
+    default: string;
+  };
+  size: {
+    type: PropType<DialogSize>;
+    default: string;
+  }; /** Backdrop dim strength (0..1 brightness multiplier); `false` for none. */
+  backdrop: {
+    type: PropType<number | boolean>;
+    default: number;
+  }; /** Esc closes the dialog (emits `update:open=false` + `close`). */
+  closeOnEsc: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  /**
+   * Auto-focus the panel itself on open. Default `true` for plain content
+   * dialogs (so they receive Esc). Variants with their own focusable control
+   * (select, input, buttons) pass `false` and focus that control instead; Esc
+   * still bubbles up to the panel's handler from the focused child.
+   */
+  autofocus: {
+    type: BooleanConstructor;
+    default: boolean;
+  }; /** Override the panel width (columns); defaults to the `size` preset. */
+  width: {
+    type: NumberConstructor;
+    default: undefined;
+  };
+}>> & Readonly<{
+  onClose?: ((...args: any[]) => any) | undefined;
+  "onUpdate:open"?: ((...args: any[]) => any) | undefined;
+}>, {
+  title: string;
+  width: number;
+  size: DialogSize;
+  open: boolean;
+  backdrop: number | boolean;
+  closeOnEsc: boolean;
+  autofocus: boolean;
+}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/dialog-select.d.ts
+interface SelectOption {
+  label: string;
+  value: string | number;
+  group?: string;
+  hint?: string;
+}
+type OptionInput = SelectOption | string;
+declare const VuiDialogSelect: import("@vue/runtime-core").DefineComponent<import("@vue/runtime-core").ExtractPropTypes<{
+  open: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  title: {
+    type: StringConstructor;
+    default: string;
+  };
+  items: {
+    type: PropType<OptionInput[]>;
+    default: () => never[];
+  };
+  placeholder: {
+    type: StringConstructor;
+    default: string;
+  }; /** Max rows of the scrolling list viewport. */
+  maxRows: {
+    type: NumberConstructor;
+    default: number;
+  };
+}>, () => import("@vue/runtime-core").VNode<import("@vue/runtime-core").RendererNode, import("@vue/runtime-core").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, ("select" | "close" | "update:open")[], "select" | "close" | "update:open", import("@vue/runtime-core").PublicProps, Readonly<import("@vue/runtime-core").ExtractPropTypes<{
+  open: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  title: {
+    type: StringConstructor;
+    default: string;
+  };
+  items: {
+    type: PropType<OptionInput[]>;
+    default: () => never[];
+  };
+  placeholder: {
+    type: StringConstructor;
+    default: string;
+  }; /** Max rows of the scrolling list viewport. */
+  maxRows: {
+    type: NumberConstructor;
+    default: number;
+  };
+}>> & Readonly<{
+  onSelect?: ((...args: any[]) => any) | undefined;
+  onClose?: ((...args: any[]) => any) | undefined;
+  "onUpdate:open"?: ((...args: any[]) => any) | undefined;
+}>, {
+  title: string;
+  open: boolean;
+  items: OptionInput[];
+  placeholder: string;
+  maxRows: number;
+}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/dialog-prompt.d.ts
+declare const VuiDialogPrompt: import("@vue/runtime-core").DefineComponent<import("@vue/runtime-core").ExtractPropTypes<{
+  open: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  title: {
+    type: StringConstructor;
+    default: string;
+  };
+  message: {
+    type: StringConstructor;
+    default: string;
+  }; /** Initial / v-model text value. */
+  modelValue: {
+    type: StringConstructor;
+    default: string;
+  };
+  placeholder: {
+    type: StringConstructor;
+    default: string;
+  }; /** Returns an error message to block submit, or null/empty to allow it. */
+  validate: {
+    type: PropType<(v: string) => string | null>;
+    default: undefined;
+  };
+}>, () => import("@vue/runtime-core").VNode<import("@vue/runtime-core").RendererNode, import("@vue/runtime-core").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, ("close" | "submit" | "update:open" | "update:modelValue")[], "close" | "submit" | "update:open" | "update:modelValue", import("@vue/runtime-core").PublicProps, Readonly<import("@vue/runtime-core").ExtractPropTypes<{
+  open: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  title: {
+    type: StringConstructor;
+    default: string;
+  };
+  message: {
+    type: StringConstructor;
+    default: string;
+  }; /** Initial / v-model text value. */
+  modelValue: {
+    type: StringConstructor;
+    default: string;
+  };
+  placeholder: {
+    type: StringConstructor;
+    default: string;
+  }; /** Returns an error message to block submit, or null/empty to allow it. */
+  validate: {
+    type: PropType<(v: string) => string | null>;
+    default: undefined;
+  };
+}>> & Readonly<{
+  onClose?: ((...args: any[]) => any) | undefined;
+  onSubmit?: ((...args: any[]) => any) | undefined;
+  "onUpdate:open"?: ((...args: any[]) => any) | undefined;
+  "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+}>, {
+  title: string;
+  open: boolean;
+  placeholder: string;
+  modelValue: string;
+  message: string;
+  validate: (v: string) => string | null;
+}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/dialog-confirm.d.ts
+declare const VuiDialogConfirm: import("@vue/runtime-core").DefineComponent<import("@vue/runtime-core").ExtractPropTypes<{
+  open: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  title: {
+    type: StringConstructor;
+    default: string;
+  };
+  message: {
+    type: StringConstructor;
+    default: string;
+  };
+  confirmLabel: {
+    type: StringConstructor;
+    default: string;
+  };
+  cancelLabel: {
+    type: StringConstructor;
+    default: string;
+  }; /** Which choice is highlighted when the dialog opens. */
+  defaultConfirm: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+}>, () => import("@vue/runtime-core").VNode<import("@vue/runtime-core").RendererNode, import("@vue/runtime-core").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, ("close" | "update:open" | "confirm")[], "close" | "update:open" | "confirm", import("@vue/runtime-core").PublicProps, Readonly<import("@vue/runtime-core").ExtractPropTypes<{
+  open: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  title: {
+    type: StringConstructor;
+    default: string;
+  };
+  message: {
+    type: StringConstructor;
+    default: string;
+  };
+  confirmLabel: {
+    type: StringConstructor;
+    default: string;
+  };
+  cancelLabel: {
+    type: StringConstructor;
+    default: string;
+  }; /** Which choice is highlighted when the dialog opens. */
+  defaultConfirm: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+}>> & Readonly<{
+  onClose?: ((...args: any[]) => any) | undefined;
+  "onUpdate:open"?: ((...args: any[]) => any) | undefined;
+  onConfirm?: ((...args: any[]) => any) | undefined;
+}>, {
+  title: string;
+  open: boolean;
+  message: string;
+  confirmLabel: string;
+  cancelLabel: string;
+  defaultConfirm: boolean;
+}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/dialog-alert.d.ts
+declare const VuiDialogAlert: import("@vue/runtime-core").DefineComponent<import("@vue/runtime-core").ExtractPropTypes<{
+  open: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  title: {
+    type: StringConstructor;
+    default: string;
+  };
+  message: {
+    type: StringConstructor;
+    default: string;
+  };
+  okLabel: {
+    type: StringConstructor;
+    default: string;
+  };
+}>, () => import("@vue/runtime-core").VNode<import("@vue/runtime-core").RendererNode, import("@vue/runtime-core").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, ("close" | "update:open")[], "close" | "update:open", import("@vue/runtime-core").PublicProps, Readonly<import("@vue/runtime-core").ExtractPropTypes<{
+  open: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  title: {
+    type: StringConstructor;
+    default: string;
+  };
+  message: {
+    type: StringConstructor;
+    default: string;
+  };
+  okLabel: {
+    type: StringConstructor;
+    default: string;
+  };
+}>> & Readonly<{
+  onClose?: ((...args: any[]) => any) | undefined;
+  "onUpdate:open"?: ((...args: any[]) => any) | undefined;
+}>, {
+  title: string;
+  open: boolean;
+  message: string;
+  okLabel: string;
+}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/command-palette.d.ts
+interface Command {
+  id: string;
+  title: string;
+  /** Right-aligned hint, typically the keybinding (e.g. "⌘S"). */
+  hint?: string;
+  /** Optional group header (shown when not searching). */
+  group?: string;
+  /** Invoked when the command is chosen. */
+  run?: () => void;
+}
+declare const VuiCommandPalette: import("@vue/runtime-core").DefineComponent<import("@vue/runtime-core").ExtractPropTypes<{
+  open: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  commands: {
+    type: PropType<Command[]>;
+    default: () => never[];
+  };
+  title: {
+    type: StringConstructor;
+    default: string;
+  };
+  placeholder: {
+    type: StringConstructor;
+    default: string;
+  };
+}>, () => import("@vue/runtime-core").VNode<import("@vue/runtime-core").RendererNode, import("@vue/runtime-core").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, ("close" | "update:open" | "run")[], "close" | "update:open" | "run", import("@vue/runtime-core").PublicProps, Readonly<import("@vue/runtime-core").ExtractPropTypes<{
+  open: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  commands: {
+    type: PropType<Command[]>;
+    default: () => never[];
+  };
+  title: {
+    type: StringConstructor;
+    default: string;
+  };
+  placeholder: {
+    type: StringConstructor;
+    default: string;
+  };
+}>> & Readonly<{
+  onClose?: ((...args: any[]) => any) | undefined;
+  "onUpdate:open"?: ((...args: any[]) => any) | undefined;
+  onRun?: ((...args: any[]) => any) | undefined;
+}>, {
+  title: string;
+  open: boolean;
+  placeholder: string;
+  commands: Command[];
+}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/toast.d.ts
+type ToastKind = 'info' | 'success' | 'warning' | 'error';
+interface Toast {
+  id: number;
+  message: string;
+  kind: ToastKind;
+  /** Auto-dismiss after this many ms; 0 keeps it until dismissed manually. */
+  duration: number;
+}
+interface ToastController {
+  toasts: Toast[];
+  show: (message: string, opts?: {
+    kind?: ToastKind;
+    duration?: number;
+  }) => number;
+  dismiss: (id: number) => void;
+  clear: () => void;
+}
+/** Create + provide the toast controller. Call once in your root component setup. */
+declare function provideToasts(): ToastController;
+/** Access the toast controller installed by `provideToasts()`. */
+declare function useToast(): ToastController;
+declare const VuiToastHost: import("@vue/runtime-core").DefineComponent<import("@vue/runtime-core").ExtractPropTypes<{
+  /** Corner to stack toasts in. */position: {
+    type: PropType<"top-right" | "top-left" | "bottom-right" | "bottom-left">;
+    default: string;
+  };
+}>, () => import("@vue/runtime-core").VNode<import("@vue/runtime-core").RendererNode, import("@vue/runtime-core").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {}, string, import("@vue/runtime-core").PublicProps, Readonly<import("@vue/runtime-core").ExtractPropTypes<{
+  /** Corner to stack toasts in. */position: {
+    type: PropType<"top-right" | "top-left" | "bottom-right" | "bottom-left">;
+    default: string;
+  };
+}>> & Readonly<{}>, {
+  position: "top-right" | "top-left" | "bottom-right" | "bottom-left";
+}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/autocomplete.d.ts
+interface Suggestion {
+  label: string;
+  value: string;
+  /** Right-aligned secondary text (type, path, etc.). */
+  hint?: string;
+}
+/** Produces suggestions for a query. Return `[]` to contribute nothing. */
+type SuggestionProvider = (query: string) => Suggestion[];
+interface AutocompleteOptions {
+  query: () => string;
+  providers: SuggestionProvider[];
+  onAccept: (s: Suggestion) => void;
+  /** Cap the merged suggestion list. */
+  max?: number;
+}
+interface AutocompleteApi {
+  suggestions: Ref<Suggestion[]>;
+  active: Ref<number>;
+  /** True when there is at least one suggestion to show. */
+  visible: Ref<boolean>;
+  /** Up/Down navigation — wire on the input's wrapper (they bubble out of the input). */
+  onKeyDown: (ev: DispatchableEvent) => void;
+  /** Accept the active suggestion — call from the input's `@enter`. */
+  accept: () => void;
+}
+/** Wire provider-stack suggestions + keyboard navigation for an input. */
+declare function useAutocomplete(opts: AutocompleteOptions): AutocompleteApi;
+declare const VuiAutocomplete: import("@vue/runtime-core").DefineComponent<import("@vue/runtime-core").ExtractPropTypes<{
+  suggestions: {
+    type: PropType<Suggestion[]>;
+    default: () => never[];
+  };
+  active: {
+    type: NumberConstructor;
+    default: number;
+  };
+  maxRows: {
+    type: NumberConstructor;
+    default: number;
+  };
+}>, () => import("@vue/runtime-core").VNode<import("@vue/runtime-core").RendererNode, import("@vue/runtime-core").RendererElement, {
+  [key: string]: any;
+}> | null, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, "select"[], "select", import("@vue/runtime-core").PublicProps, Readonly<import("@vue/runtime-core").ExtractPropTypes<{
+  suggestions: {
+    type: PropType<Suggestion[]>;
+    default: () => never[];
+  };
+  active: {
+    type: NumberConstructor;
+    default: number;
+  };
+  maxRows: {
+    type: NumberConstructor;
+    default: number;
+  };
+}>> & Readonly<{
+  onSelect?: ((...args: any[]) => any) | undefined;
+}>, {
+  maxRows: number;
+  suggestions: Suggestion[];
+  active: number;
+}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/status-bar.d.ts
+type ColorProp$1 = string | number;
+declare const VuiStatusBar: import("@vue/runtime-core").DefineComponent<import("@vue/runtime-core").ExtractPropTypes<{
+  height: {
+    type: NumberConstructor;
+    default: number;
+  };
+  bg: {
+    type: PropType<ColorProp$1>;
+    default: undefined;
+  };
+  fg: {
+    type: PropType<ColorProp$1>;
+    default: undefined;
+  }; /** Horizontal padding inside the bar. */
+  pad: {
+    type: NumberConstructor;
+    default: number;
+  };
+}>, () => import("@vue/runtime-core").VNode<import("@vue/runtime-core").RendererNode, import("@vue/runtime-core").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {}, string, import("@vue/runtime-core").PublicProps, Readonly<import("@vue/runtime-core").ExtractPropTypes<{
+  height: {
+    type: NumberConstructor;
+    default: number;
+  };
+  bg: {
+    type: PropType<ColorProp$1>;
+    default: undefined;
+  };
+  fg: {
+    type: PropType<ColorProp$1>;
+    default: undefined;
+  }; /** Horizontal padding inside the bar. */
+  pad: {
+    type: NumberConstructor;
+    default: number;
+  };
+}>> & Readonly<{}>, {
+  fg: ColorProp$1;
+  height: number;
+  bg: ColorProp$1;
+  pad: number;
+}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, true, {}, any>;
+/** A header row: a status bar with the active-border accent by default. */
+declare const VuiHeader: import("@vue/runtime-core").DefineComponent<import("@vue/runtime-core").ExtractPropTypes<{
+  bg: {
+    type: PropType<ColorProp$1>;
+    default: undefined;
+  };
+  fg: {
+    type: PropType<ColorProp$1>;
+    default: undefined;
+  };
+}>, () => import("@vue/runtime-core").VNode<import("@vue/runtime-core").RendererNode, import("@vue/runtime-core").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {}, string, import("@vue/runtime-core").PublicProps, Readonly<import("@vue/runtime-core").ExtractPropTypes<{
+  bg: {
+    type: PropType<ColorProp$1>;
+    default: undefined;
+  };
+  fg: {
+    type: PropType<ColorProp$1>;
+    default: undefined;
+  };
+}>> & Readonly<{}>, {
+  fg: ColorProp$1;
+  bg: ColorProp$1;
+}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, true, {}, any>;
+/** A footer row — alias of the status bar with footer-typical muted styling. */
+declare const VuiFooter: import("@vue/runtime-core").DefineComponent<{}, () => import("@vue/runtime-core").VNode<import("@vue/runtime-core").RendererNode, import("@vue/runtime-core").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {}, string, import("@vue/runtime-core").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/virtual-list.d.ts
+declare const VuiVirtualList: import("@vue/runtime-core").DefineComponent<import("@vue/runtime-core").ExtractPropTypes<{
+  items: {
+    type: PropType<unknown[]>;
+    required: true;
+  }; /** Viewport height in rows (definite — see the note above). */
+  height: {
+    type: NumberConstructor;
+    required: true;
+  }; /** Rows each item occupies. */
+  itemHeight: {
+    type: NumberConstructor;
+    default: number;
+  }; /** Extra rows mounted above/below the viewport to smooth fast scrolling. */
+  overscan: {
+    type: NumberConstructor;
+    default: number;
+  };
+  focused: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  focusable: {
+    type: BooleanConstructor;
+    default: boolean;
+  }; /** Scroll step (rows) for arrow keys / one wheel notch. */
+  step: {
+    type: NumberConstructor;
+    default: number;
+  }; /** Render an integrated vertical scrollbar (indicator + drag) on the right edge. */
+  scrollbar: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  /**
+   * Controlled scroll offset (top row). Bind it (`v-model:scrollY` /
+   * `:scrollY` + `@update:scrollY`) to drive the list from an ancestor — e.g. a
+   * focused parent that owns the keyboard. Omit for uncontrolled (internal).
+   */
+  scrollY: {
+    type: NumberConstructor;
+    default: undefined;
+  };
+}>, () => import("@vue/runtime-core").VNode<import("@vue/runtime-core").RendererNode, import("@vue/runtime-core").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, ("scroll" | "update:scrollY")[], "scroll" | "update:scrollY", import("@vue/runtime-core").PublicProps, Readonly<import("@vue/runtime-core").ExtractPropTypes<{
+  items: {
+    type: PropType<unknown[]>;
+    required: true;
+  }; /** Viewport height in rows (definite — see the note above). */
+  height: {
+    type: NumberConstructor;
+    required: true;
+  }; /** Rows each item occupies. */
+  itemHeight: {
+    type: NumberConstructor;
+    default: number;
+  }; /** Extra rows mounted above/below the viewport to smooth fast scrolling. */
+  overscan: {
+    type: NumberConstructor;
+    default: number;
+  };
+  focused: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  focusable: {
+    type: BooleanConstructor;
+    default: boolean;
+  }; /** Scroll step (rows) for arrow keys / one wheel notch. */
+  step: {
+    type: NumberConstructor;
+    default: number;
+  }; /** Render an integrated vertical scrollbar (indicator + drag) on the right edge. */
+  scrollbar: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  /**
+   * Controlled scroll offset (top row). Bind it (`v-model:scrollY` /
+   * `:scrollY` + `@update:scrollY`) to drive the list from an ancestor — e.g. a
+   * focused parent that owns the keyboard. Omit for uncontrolled (internal).
+   */
+  scrollY: {
+    type: NumberConstructor;
+    default: undefined;
+  };
+}>> & Readonly<{
+  onScroll?: ((...args: any[]) => any) | undefined;
+  "onUpdate:scrollY"?: ((...args: any[]) => any) | undefined;
+}>, {
+  focusable: boolean;
+  focused: boolean;
+  scrollY: number;
+  step: number;
+  scrollbar: boolean;
+  itemHeight: number;
+  overscan: number;
+}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/working-indicator.d.ts
+type ColorProp = string | number;
+declare const VuiWorkingIndicator: import("@vue/runtime-core").DefineComponent<import("@vue/runtime-core").ExtractPropTypes<{
+  label: {
+    type: StringConstructor;
+    default: string;
+  };
+  done: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  doneLabel: {
+    type: StringConstructor;
+    default: string;
+  };
+  preset: {
+    type: PropType<SpinnerPreset$1>;
+    default: string;
+  }; /** Spinner / check color; defaults to theme accent (busy) / success (done). */
+  color: {
+    type: PropType<ColorProp>;
+    default: undefined;
+  }; /** Glyph shown when done. */
+  doneGlyph: {
+    type: StringConstructor;
+    default: string;
+  };
+}>, () => import("@vue/runtime-core").VNode<import("@vue/runtime-core").RendererNode, import("@vue/runtime-core").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {}, string, import("@vue/runtime-core").PublicProps, Readonly<import("@vue/runtime-core").ExtractPropTypes<{
+  label: {
+    type: StringConstructor;
+    default: string;
+  };
+  done: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+  doneLabel: {
+    type: StringConstructor;
+    default: string;
+  };
+  preset: {
+    type: PropType<SpinnerPreset$1>;
+    default: string;
+  }; /** Spinner / check color; defaults to theme accent (busy) / success (done). */
+  color: {
+    type: PropType<ColorProp>;
+    default: undefined;
+  }; /** Glyph shown when done. */
+  doneGlyph: {
+    type: StringConstructor;
+    default: string;
+  };
+}>> & Readonly<{}>, {
+  label: string;
+  done: boolean;
+  doneLabel: string;
+  preset: "braille" | "dots" | "line" | "bounce" | "arc" | "circle" | "arrow" | "toggle" | "pulse";
+  color: ColorProp;
+  doneGlyph: string;
+}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, true, {}, any>;
+//#endregion
+export { type AutocompleteApi, type AutocompleteOptions, type Command, type DialogSize, type FuzzyMatch, type FuzzyRanked, SPINNER_PRESETS, type SelectOption, type SpinnerPreset, type Suggestion, type SuggestionProvider, type Toast, type ToastController, type ToastKind, VuiAutocomplete, VuiCommandPalette, VuiDialog, VuiDialogAlert, VuiDialogConfirm, VuiDialogPrompt, VuiDialogSelect, VuiFooter, VuiHeader, VuiSpinner, VuiStatusBar, VuiToastHost, VuiVirtualList, VuiWorkingIndicator, fuzzyFilter, fuzzyMatch, provideToasts, useAutocomplete, useFocusTrap, useToast };