@atscript/vue-table 0.1.58

package/dist/as-table-root.vue-CSqEtIll.d.cts

@@ -0,0 +1,2258 @@
+import { _ as TableNavBridge, c as NavKeyOptions, d as ReactiveTableState, g as TableActionsState, h as TVueTableActionInfo, i as ConfirmOptions, l as PresetConfig, m as TAsTableControls, p as TAsCellTypeComponents, t as ActionResult } from "./types-CNMmF6W2.cjs";
+import * as vue from "vue";
+import { AllowedComponentProps, AnchorHTMLAttributes, App, Component as Component$1, ComponentCustomProps, ComponentPublicInstance, ComputedRef, DefineComponent, InjectionKey, MaybeRef, MaybeRefOrGetter, Ref, ShallowRef, UnwrapRef, VNode, VNodeProps, WritableComputedRef } from "vue";
+import { Client, PageResult, TDbActionInfo } from "@atscript/db-client";
+import * as _atscript_ui0 from "@atscript/ui";
+import { ClientFactory, ClientFactory as ClientFactory$1, ColumnDef, SortControl, TableDef, getDefaultClientFactory, resetDefaultClientFactory, setDefaultClientFactory } from "@atscript/ui";
+import * as _atscript_ui_table0 from "@atscript/ui-table";
+import { AppConfData, AppConfData as AppConfData$1, AsPresetEntryRow, AsPresetEntryRow as AsPresetEntryRow$1, ColumnWidthsMap, FilterCondition, PRESET_ASPECTS, PresetAspect, PresetAspect as PresetAspect$1, PresetCapabilities, PresetCapabilities as PresetCapabilities$1, PresetData, PresetDraft, PresetSnapshot, PresetSnapshot as PresetSnapshot$1, PresetSnapshotWire, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, SelectionMode, SystemPreset, SystemPreset as SystemPreset$1, SystemPresetInput, SystemPresetInput as SystemPresetInput$1, UrlQuerySync, UrlQuerySync as UrlQuerySync$1, UserConfData, isSystemPresetId, resolveSystemPresets } from "@atscript/ui-table";
+import { TAsTypeComponents } from "@atscript/vue-form";
+import { FilterExpr, Uniquery } from "@uniqu/core";
+
+//#region src/composables/state/create-selection.d.ts
+type Row = Record<string, unknown>;
+interface SelectionApiOptions {
+  /** Extract a unique value from a row for selection tracking. */
+  rowValueFn?: (row: Row) => unknown;
+  /**
+   * External ref to back `selectedRows`. When provided the framework reads
+   * from and writes to this ref directly (identity preserved); otherwise a
+   * local `shallowRef([])` is created.
+   */
+  selectedRows?: Ref<unknown[]>;
+}
+//#endregion
+//#region src/composables/use-local-draft.d.ts
+interface UseLocalDraftOptions {
+  app: string;
+  tableKey: string;
+  /** Reactive on/off toggle (`<AsTableRoot :persist-local-drafts>`). */
+  enabled: Ref<boolean> | boolean;
+  /** Persisted-aspect gate — drafts only persist aspects in this set. */
+  availableAspects: readonly PresetAspect[];
+  /** Optional debounce override (default 300ms). */
+  debounceMs?: number;
+  /**
+   * Optional storage backend. Defaults to `globalThis.localStorage`. Tests
+   * supply an in-memory mock; SSR contexts pass `null` to disable.
+   */
+  storage?: StorageLike | null;
+}
+/** Subset of `Storage` we depend on. Avoids type coupling to DOM lib. */
+interface StorageLike {
+  getItem(key: string): string | null;
+  setItem(key: string, value: string): void;
+  removeItem(key: string): void;
+}
+interface UseLocalDraftReturn {
+  /**
+   * Layer the persisted draft (if any) on top of `applied` and return the
+   * merged snapshot. Aspects not in `availableAspects` are skipped silently
+   * (forward-compat for deploys that toggle aspect availability).
+   */
+  hydrate(applied: PresetSnapshot): PresetSnapshot;
+  /**
+   * Wire a debounced watcher that mirrors persisted aspects of `current`
+   * to localStorage on each change. When `current` matches the active
+   * preset's persisted-aspect subset, the entry is removed instead.
+   *
+   * Returns the unwatch handle so callers can dispose explicitly; if not
+   * called, the watcher lives until the host component unmounts.
+   */
+  watchAndPersist(currentSnapshot: () => PresetSnapshot, activePresetSnapshot: () => PresetSnapshot): () => void;
+  /** Drop the localStorage entry. Used by sign-out / explicit preset switch. */
+  clear(): void;
+  /** Read the raw draft from storage; `null` when absent or corrupted. */
+  readDraft(): PresetDraft | null;
+}
+/**
+ * localStorage overlay manager for table presets. One overlay per
+ * `(app, tableKey)`; switching presets clears it (caller's responsibility
+ * — this composable only tracks state, not which preset is active).
+ */
+declare function useLocalDraft(opts: UseLocalDraftOptions): UseLocalDraftReturn;
+//#endregion
+//#region src/composables/use-presets.d.ts
+interface UsePresetsOptions {
+  /** App namespace; defaults to `inject(AS_PRESETS_APP)`. */
+  app?: string;
+  /** Per-table identifier. Required. */
+  tableKey: string;
+  /** Presets controller URL, e.g. `"/db/_presets"`. */
+  url: string;
+  /** Custom client factory (auth-configured). */
+  clientFactory?: ClientFactory;
+  /** Consumer-defined synthetic presets (`sys:*` namespace). */
+  systemPresets?: SystemPresetInput[];
+  /** Auto-load on setup. Default `true`. */
+  autoLoad?: boolean;
+}
+type ActivePresetView = {
+  kind: "system";
+  entry: SystemPreset;
+} | {
+  kind: "stored";
+  entry: AsPresetEntryRow;
+};
+interface UsePresetsReturn {
+  presets: ShallowRef<AsPresetEntryRow[]>;
+  presetsById: ComputedRef<Map<string, AsPresetEntryRow>>;
+  userConf: ShallowRef<AsPresetEntryRow | null>;
+  capabilities: Ref<PresetCapabilities | null>;
+  systemPresets: ComputedRef<SystemPreset[]>;
+  systemPresetsById: ComputedRef<Map<string, SystemPreset>>;
+  /** False on 401/403 from initial load — UI hides itself. */
+  available: ComputedRef<boolean>;
+  loading: Ref<boolean>;
+  error: Ref<unknown>;
+  /**
+   * Authoritative current-user id. `capabilities.userId` when caps are
+   * loaded, else best-effort derivation from any private row.
+   */
+  currentUser: ComputedRef<string | null>;
+  /** Currently applied preset id (`sys:*` for system or stored row id). */
+  activePresetId: Ref<string | null>;
+  /** Resolved view of the active preset (system / stored / null). */
+  activePreset: ComputedRef<ActivePresetView | null>;
+  /**
+   * "Owned by current user" predicate for stored rows. Used by canSave /
+   * delete / public-toggle gating. Returns false for system presets.
+   */
+  isOwned(id: string): boolean;
+  reload(): Promise<void>;
+  /**
+   * Run `fn` with the trailing `reload()` of every mutator (save / saveAs /
+   * rename / delete / togglePublic / setDefault / setFavorites / toggleFav)
+   * deferred until `fn` resolves. One coalesced reload fires at the end —
+   * collapses N round-trips into 1 for batched UI flows like the manage
+   * dialog's Save button. Re-entrant; outer batch wins.
+   */
+  batch<T>(fn: () => Promise<T>): Promise<T>;
+  /**
+   * Overwrite the active preset's content. The caller supplies the
+   * snapshot — the table-state composable uses `state.captureSnapshot()`
+   * here. Throws when the active preset is a system preset (never saveable).
+   */
+  savePreset(snapshot: PresetSnapshot): Promise<void>;
+  /**
+   * Create a new preset row. Returns the new id; sets `activePresetId` to
+   * it so the picker switches to the new preset.
+   */
+  savePresetAs(label: string, snapshot: PresetSnapshot, opts?: {
+    public?: boolean;
+  }): Promise<string>;
+  renamePreset(id: string, label: string): Promise<void>;
+  deletePreset(id: string): Promise<void>;
+  togglePublic(id: string): Promise<void>;
+  /** Pin a preset as default for this `(user, app, tableKey)`. */
+  setDefault(id: string | null): Promise<void>;
+  /** Toggle a preset's pinned-as-favorite state. */
+  toggleFav(id: string): Promise<void>;
+  /**
+   * Replace the full favorites list in one upsert. Lets a batched UI
+   * (e.g. the manage dialog's "Save" button) commit a whole new set instead
+   * of N round-trips through {@link toggleFav}.
+   */
+  setFavorites(ids: string[]): Promise<void>;
+}
+/**
+ * Public dev-facing composable for table presets. Powers `<AsPresetPicker>`
+ * internally and is exported for devs who want to wire bespoke surfaces.
+ *
+ * Stateful: holds reactive `presets` / `userConf` / `capabilities` and
+ * supports optimistic mutators that re-list after each successful write.
+ *
+ * Active-preset selection (`activePresetId`) is **owned by the caller** —
+ * the composable provides the ref but doesn't auto-resolve it on mount;
+ * that's the table-state's responsibility (Slice 4) since it depends on
+ * `userConf.defaultPresetId` resolution + Standard fallback.
+ */
+declare function usePresets(opts: UsePresetsOptions): UsePresetsReturn;
+//#endregion
+//#region src/composables/use-table-state.d.ts
+/** Everything provided by as-table-root to its subtree. */
+interface TableContext {
+  state: ReactiveTableState;
+  client: Client;
+  /** Skin-slot overrides for table chrome (header cells, filter dialog, etc.). */
+  controls: TAsTableControls;
+  /** Cell-type → component dispatch map. */
+  types?: TAsCellTypeComponents;
+  /** Named cell-component overrides — looked up by `@ui.table.component "name"`. */
+  components?: Record<string, Component$1>;
+  /** Form-type → component dispatch map for the action-form dialog. */
+  formTypes?: TAsTypeComponents;
+  /** Named form-component overrides for the action-form dialog. */
+  formComponents?: Record<string, Component$1>;
+}
+type QueryFn = (query: Uniquery, page: number, size: number) => Promise<PageResult<Record<string, unknown>>>;
+/** External refs the consumer wires up via `defineModel` (or otherwise). */
+interface TableModelRefs {
+  filterFields?: Ref<string[]>;
+  columnNames?: Ref<string[]>;
+  columnWidths?: Ref<ColumnWidthsMap>;
+  sorters?: Ref<SortControl[]>;
+}
+type TableSelectionOptions = SelectionApiOptions;
+interface TableQueryOptions {
+  /** Override the default query function. */
+  fn?: QueryFn;
+  /** Always-applied Uniquery filter expression (AND'd with user filters). */
+  forceFilters?: FilterExpr;
+  /** Always-applied sorters (prepended before user sorters). */
+  forceSorters?: SortControl[];
+  /** When true, all triggers (query/queryNext/loadRange) early-return. */
+  blockQuery?: boolean;
+  /** Auto-query when metadata loads (default: true). */
+  queryOnMount?: boolean;
+  /**
+   * Gate the initial `scheduleQuery("initial")` until this ref flips to
+   * `true`. Used by `<AsTableRoot>` when `v-model:urlQuery` is bound, to
+   * defer the first fetch until URL hydration has run so the table fires one
+   * composed query on mount instead of two. Implicitly open when omitted.
+   */
+  urlQueryReady?: Ref<boolean>;
+  /**
+   * Called when a state mutation produces a new URL query string. Self-emits
+   * are echo-suppressed by `lastEmittedUrl` so `applyUrlQuery(s)` followed
+   * by mutations that re-encode to the same `s` will not re-fire this
+   * callback. Opt-in: omitting disables the URL emitter entirely.
+   */
+  onUrlQueryChange?: (urlString: string) => void;
+  /**
+   * Per-aspect opt-in/out for the URL bridge. Defaults to full sync (current
+   * behaviour). Static — captured at setup; to change sync, re-mount.
+   */
+  urlQuerySync?: UrlQuerySync;
+}
+interface TableWindowOptions {
+  /** Page-alignment unit for `loadRange` and the `queryNext` extension. */
+  blockSize?: number;
+  /** Debounce window for the topIndex/viewportRowCount watcher. */
+  dragReleaseDebounceMs?: number;
+}
+interface TableActionsOptions {
+  /** Refetch policy: when `true` (default), successful backend / __remove invocations call `state.query()`. */
+  refreshOnAction?: () => boolean;
+  /**
+   * Bridge for `<AsTableRoot>`'s `@action` emit. Called once per settled
+   * `invoke` (success, error, custom). `ids` is the level-derived list:
+   * `'row'` → `[pk]`, `'rows'` → `pk` if array else `[pk]`, `'table'` → `[]`.
+   */
+  onResolved?: (action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: KeyboardEvent | MouseEvent) => void;
+}
+interface TablePresetOptions {
+  /** `usePresets` handle. When omitted, the preset surface degrades to a
+   * permanently-unavailable shape (`state.preset.available=false`). */
+  presetsHandle?: UsePresetsReturn | null;
+  /** `useLocalDraft` handle for opt-in localStorage persistence. */
+  draftHandle?: UseLocalDraftReturn | null;
+  /** App-declared aspect set; default `['columns','filters','filterOps','sorters']`. */
+  availableAspects?: PresetAspect[];
+  /** Static fallback for system presets when no `presetsHandle` is wired. */
+  fallbackSystemPresets?: SystemPreset[];
+  /** Whether localStorage drafts should be hydrated + persisted on bootstrap. */
+  persistDrafts?: boolean;
+}
+interface CreateTableStateOptions {
+  /** Data-layer client used for `client.pages` calls. */
+  client: Client;
+  /** Default page size (`pagination.itemsPerPage`). */
+  limit?: number;
+  /** External refs from `defineModel`. */
+  model?: TableModelRefs;
+  /** Selection settings. */
+  selection?: TableSelectionOptions;
+  /** Query/fetch settings. */
+  query?: TableQueryOptions;
+  /** Windowed-mode (virtualized) settings. */
+  window?: TableWindowOptions;
+  /** Action settings (built-in row delete + refetch policy). */
+  actions?: TableActionsOptions;
+  /** Preset settings. */
+  preset?: TablePresetOptions;
+}
+/** Internal handles returned alongside the public state. */
+interface TableStateInternals {
+  /** Initialize state from a loaded table definition. */
+  init(def: TableDef): void;
+  /** Reset pagination to page 1 (suppresses the pagination watcher). */
+  resetPagination(): void;
+}
+declare function createTableState(opts: CreateTableStateOptions): {
+  state: ReactiveTableState;
+  internals: TableStateInternals;
+};
+interface CreateStaticTableStateOptions {
+  /** All rows in the dataset. Sorting/searching is applied locally. */
+  rows: Record<string, unknown>[];
+  /** Columns to render. Used to synthesize a minimal `TableDef`. */
+  columns: ColumnDef[];
+  /** Field paths matched (substring, case-insensitive) by `searchTerm`. */
+  searchPaths?: string[];
+  /** Selection settings. */
+  selection?: TableSelectionOptions;
+  /** Default page size (`pagination.itemsPerPage`). */
+  limit?: number;
+}
+/**
+ * Build a `ReactiveTableState` backed by an in-memory row list. Used by the
+ * enum value-help branch (`column.options`) where there's no client and no
+ * metadata fetch — sorting/searching/pagination run locally against `rows`.
+ */
+declare function createStaticTableState(opts: CreateStaticTableStateOptions): {
+  state: ReactiveTableState;
+  internals: TableStateInternals;
+};
+/** Inject the full table context (throws if used outside as-table-root). */
+declare function useTableContext(): TableContext;
+/**
+ * Inject the table context if present; return undefined when no
+ * `<as-table-root>` ancestor provided one. Use from components that may mount
+ * inside or outside a table subtree (`<AsTableBase>` in combobox/listbox modes,
+ * external composables that probe for context).
+ */
+declare function useTableContextOptional(): TableContext | undefined;
+//#endregion
+//#region src/composables/use-table-selection.d.ts
+type SelectionPersistence = "clear" | "trim" | "persist";
+/**
+ * Wire up selection reconciliation on results change.
+ *
+ * The watcher distinguishes results-replacement (query / invalidate /
+ * pagination jump) from results-extension in EITHER direction (queryNext /
+ * forward-merging loadRange / backward-merging loadRange) and only runs the
+ * reconciliation logic on replacement. Backward extension prepends rows AND
+ * decrements `resultsStart` — caught via the last-row reference identity
+ * check, so scrolling upward doesn't silently mutate selection.
+ *
+ * Mode semantics on results-replacement:
+ * - `"persist"` — no-op; the consumer's ref is untouched.
+ * - `"trim"` (default) — keep the subset of selected PKs still present in the new results.
+ * - `"clear"` — drop everything.
+ */
+declare function useTableSelection(state: ReactiveTableState, opts?: {
+  mode?: SelectionPersistence;
+}): void;
+//#endregion
+//#region src/composables/use-table.d.ts
+/** Thin alias over `resetMetaCache` — retained so existing test code keeps working. */
+declare function clearTableCache(): void;
+/**
+ * Public composable options. Flat shape for Vue-template ergonomics
+ * (`<AsTableRoot :limit="50">`). Internally translated into the grouped
+ * `CreateTableStateOptions` before reaching `createTableState`.
+ *
+ * The data-engine `client` is resolved internally from the URL via
+ * `getMetaEntry`; callers don't and can't pass it.
+ */
+interface UseTableOptions {
+  /** Default page size. */
+  limit?: number;
+  /** Extract unique value from a row for selection tracking. */
+  rowValueFn?: (row: Record<string, unknown>) => unknown;
+  /**
+   * Selection write policy applied on every results-replacement.
+   * - `"clear"` — drop everything on refresh.
+   * - `"trim"` (default) — keep the subset of PKs that still exist in the new results.
+   * - `"persist"` — never write to `selectedRows`; full consumer ownership.
+   */
+  selectionPersistence?: SelectionPersistence;
+  /** External ref for filter field names (from defineModel). */
+  filterFields?: Ref<string[]>;
+  /** External ref for visible column names (from defineModel). */
+  columnNames?: Ref<string[]>;
+  /** External ref for per-column widths (from defineModel). */
+  columnWidths?: Ref<ColumnWidthsMap>;
+  /** External ref for sorters (from defineModel). */
+  sorters?: Ref<SortControl[]>;
+  /**
+   * External ref for selected rows (from `defineModel`/v-model or any external
+   * source). Identity is preserved — the framework reads from and writes to
+   * this ref directly.
+   */
+  selectedRows?: Ref<unknown[]>;
+  /** Always-applied Uniquery filter expression (AND'd with user filters). */
+  forceFilters?: FilterExpr;
+  /** Always-applied sorters (prepended before user sorters). */
+  forceSorters?: SortControl[];
+  /** Override the default query function. */
+  queryFn?: QueryFn;
+  /** Auto-query when metadata loads (default: true). */
+  queryOnMount?: boolean;
+  /** When true, all triggers (query/queryNext/loadRange) early-return. */
+  blockQuery?: boolean;
+  /** Page-alignment unit for `loadRange` and the `queryNext` extension. */
+  blockSize?: number;
+  /** Debounce window for the topIndex/viewportRowCount watcher. */
+  dragReleaseDebounceMs?: number;
+  /** Factory to create a client from a URL. Only honored on the first `useTable`/`resolveValueHelp` call per URL — subsequent callers reuse the cached client. */
+  clientFactory?: ClientFactory;
+  /** Skin-slot overrides for table chrome (header cells, filter dialog, column menu, etc.). */
+  controls?: TAsTableControls;
+  /** Cell-type → component dispatch map. Use {@link createDefaultCellTypes} to seed defaults. */
+  types?: TAsCellTypeComponents;
+  /** Named cell-component overrides — looked up by `@ui.table.component "name"`. */
+  components?: Record<string, Component$1>;
+  /**
+   * Form-type → component dispatch map for the action-form dialog. Defaults to
+   * `createDefaultTypes()` from `@atscript/vue-form`.
+   */
+  formTypes?: TAsTypeComponents;
+  /** Named form-component overrides for the action-form dialog. */
+  formComponents?: Record<string, Component$1>;
+  /** Whether to provide table context to the subtree (default: true). */
+  provideContext?: boolean;
+  /**
+   * Refetch policy for `state.actions.invoke`. When `true` (default),
+   * successful `'backend'` / `'__remove'` invocations call `state.query()`.
+   */
+  refreshOnAction?: () => boolean;
+  /** Bridge for `<AsTableRoot>`'s `@action` emit; see `TableActionsOptions.onResolved`. */
+  onActionResolved?: (action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: KeyboardEvent | MouseEvent) => void;
+  /**
+   * Gate the initial `scheduleQuery("initial")` until this ref is `true`.
+   * `<AsTableRoot>` sets it `false` while it hydrates from `v-model:urlQuery`
+   * so the first fetch composes URL + defaults into one request. Omit when
+   * not using the URL bridge — the gate stays implicitly open.
+   */
+  urlQueryReady?: Ref<boolean>;
+  /**
+   * Called whenever a state mutation produces a new URL query string.
+   * Omitting it disables the URL emitter — the feature is opt-in.
+   */
+  onUrlQueryChange?: (urlString: string) => void;
+  /**
+   * Per-aspect opt-in/out for the URL bridge — gate filters / sorters /
+   * search / pagination independently. Static; captured once at setup.
+   * Default (omitted): full sync.
+   */
+  urlQuerySync?: UrlQuerySync;
+  /**
+   * Preset feature config — opt-in. Omit to disable presets entirely
+   * (`<AsPresetPicker>` / `<AsPresetDialog>` render nothing). When set,
+   * `url` and `tableKey` are required.
+   */
+  preset?: PresetConfig;
+}
+/**
+ * Main entry composable for table setup.
+ *
+ * @param url — Table endpoint URL (e.g. "/db/tables/products")
+ */
+declare function useTable(url: string, opts?: UseTableOptions): ReactiveTableState;
+//#endregion
+//#region src/composables/use-table-nav-bridge.d.ts
+interface UseTableNavBridgeOptions extends Omit<NavKeyOptions, "mode"> {
+  /**
+   * Selection mode source. Pass a function (`() => selectMode.value`) so
+   * the bridge re-reads on every dispatch — Enter semantics depend on mode,
+   * but selection mode lives on the renderer's `:select` prop, not state.
+   * Default `"none"` (Enter only fires main-action).
+   */
+  mode?: SelectionMode | (() => SelectionMode);
+}
+/**
+ * Construct a keyboard-bridge for an external `<input>` to drive table nav
+ * without losing focus. Without args, injects the nearest `<as-table-root>`
+ * context's state. With an explicit `state`, binds to that state. With
+ * `opts.enterAction`, the returned bridge's `onKeydown` defaults to that
+ * enter-action (per-call options still win).
+ *
+ * Each call returns a fresh bridge object — callers that need stable
+ * identity should bind once at setup and reuse the binding.
+ */
+declare function useTableNavBridge(state?: ReactiveTableState, opts?: UseTableNavBridgeOptions): TableNavBridge;
+//#endregion
+//#region src/composables/use-table-filter.d.ts
+/**
+ * Per-field filter state composable.
+ *
+ * Creates a working copy of filter conditions (cancel-safe dialog model).
+ * Call `apply()` to commit, `reset()` to revert, `clear()` to remove.
+ *
+ * Accepts `state` directly rather than injecting — safe to call outside `setup`.
+ */
+declare function useTableFilter(column: ColumnDef, state: ReactiveTableState): {
+  filterType: _atscript_ui_table0.ColumnFilterType;
+  availableConditions: readonly _atscript_ui_table0.FilterConditionType[];
+  defaultCondition: _atscript_ui_table0.FilterConditionType;
+  conditions: vue.Ref<{
+    type: _atscript_ui_table0.FilterConditionType;
+    value: (string | number | boolean)[];
+  }[], FilterCondition[] | {
+    type: _atscript_ui_table0.FilterConditionType;
+    value: (string | number | boolean)[];
+  }[]>;
+  filledCount: vue.ComputedRef<number>;
+  addCondition: () => void;
+  removeCondition: (index: number) => void;
+  updateCondition: (index: number, update: Partial<FilterCondition>) => void;
+  apply: () => void;
+  clear: () => void;
+  reset: () => void;
+};
+//#endregion
+//#region src/composables/use-table-search.d.ts
+/**
+ * Convenience composable for wiring a search input to the table.
+ * Must be called inside an `<AsTableRoot>` subtree.
+ *
+ * Returns the reactive `searchTerm` ref and an `onSearchInput` handler.
+ * The central filter/search watcher debounces the auto-query.
+ */
+declare function useTableSearch(): {
+  searchTerm: vue.Ref<string, string>;
+  onSearchInput: (event: Event) => void;
+};
+//#endregion
+//#region src/composables/use-table-actions.d.ts
+/**
+ * Inject the table-actions namespace from the closest `<AsTableRoot>` ancestor.
+ * Returns `state.actions` directly — no wrapping. Throws when called outside
+ * the provider tree (delegated to `useTableContext`).
+ *
+ * Useful for consumers that want the model without the chrome (custom
+ * toolbars, headless action buttons, programmatic invoke).
+ */
+declare function useTableActions(): TableActionsState;
+//#endregion
+//#region ../../node_modules/.pnpm/vue-router@4.6.4_vue@3.5.30_typescript@5.9.3_/node_modules/vue-router/dist/router-CWoNjPRp.d.mts
+//#region src/query.d.ts
+/**
+ * Possible values in normalized {@link LocationQuery}. `null` renders the query
+ * param but without an `=`.
+ *
+ * @example
+ * ```
+ * ?isNull&isEmpty=&other=other
+ * gives
+ * `{ isNull: null, isEmpty: '', other: 'other' }`.
+ * ```
+ *
+ * @internal
+ */
+type LocationQueryValue = string | null;
+/**
+ * Possible values when defining a query. `undefined` allows to remove a value.
+ *
+ * @internal
+ */
+type LocationQueryValueRaw = LocationQueryValue | number | undefined;
+/**
+ * Normalized query object that appears in {@link RouteLocationNormalized}
+ *
+ * @public
+ */
+type LocationQuery = Record<string, LocationQueryValue | LocationQueryValue[]>;
+/**
+ * Loose {@link LocationQuery} object that can be passed to functions like
+ * {@link Router.push} and {@link Router.replace} or anywhere when creating a
+ * {@link RouteLocationRaw}
+ *
+ * @public
+ */
+type LocationQueryRaw = Record<string | number, LocationQueryValueRaw | LocationQueryValueRaw[]>;
+/**
+ * Transforms a queryString into a {@link LocationQuery} object. Accept both, a
+ * version with the leading `?` and without Should work as URLSearchParams
+
+ * @internal
+ *
+ * @param search - search string to parse
+ * @returns a query object
+ */
+declare function parseQuery(search: string): LocationQuery;
+/**
+ * Stringifies a {@link LocationQueryRaw} object. Like `URLSearchParams`, it
+ * doesn't prepend a `?`
+ *
+ * @internal
+ *
+ * @param query - query object to stringify
+ * @returns string version of the query without the leading `?`
+ */
+declare function stringifyQuery(query: LocationQueryRaw | undefined): string; //#endregion
+//#region src/config.d.ts
+/**
+ * Allows customizing existing types of the router that are used globally like `$router`, `<RouterLink>`, etc. **ONLY FOR INTERNAL USAGE**.
+ *
+ * - `$router` - the router instance
+ * - `$route` - the current route location
+ * - `beforeRouteEnter` - Page component option
+ * - `beforeRouteUpdate` - Page component option
+ * - `beforeRouteLeave` - Page component option
+ * - `RouterLink` - RouterLink Component
+ * - `RouterView` - RouterView Component
+ *
+ * @internal
+ */
+interface TypesConfig {} //#endregion
+//#region src/typed-routes/route-map.d.ts
+/**
+ * Helper type to define a Typed `RouteRecord`
+ * @see {@link RouteRecord}
+ */
+interface RouteRecordInfo<Name extends string | symbol = string, Path extends string = string, ParamsRaw extends RouteParamsRawGeneric = RouteParamsRawGeneric, Params extends RouteParamsGeneric = RouteParamsGeneric, ChildrenNames extends string | symbol = never> {
+  name: Name;
+  path: Path;
+  paramsRaw: ParamsRaw;
+  params: Params;
+  childrenNames: ChildrenNames;
+}
+type RouteRecordInfoGeneric = RouteRecordInfo<string | symbol, string, RouteParamsRawGeneric, RouteParamsGeneric, string | symbol>;
+/**
+ * Convenience type to get the typed RouteMap or a generic one if not provided. It is extracted from the {@link TypesConfig} if it exists, it becomes {@link RouteMapGeneric} otherwise.
+ */
+type RouteMap = TypesConfig extends Record<'RouteNamedMap', infer RouteNamedMap> ? RouteNamedMap : RouteMapGeneric;
+/**
+ * Generic version of the `RouteMap`.
+ */
+type RouteMapGeneric = Record<string | symbol, RouteRecordInfoGeneric>; //#endregion
+//#region src/typed-routes/params.d.ts
+/**
+ * Utility type for raw and non raw params like :id+
+ *
+ */
+//#endregion
+//#region src/types/utils.d.ts
+/**
+ * Creates a union type that still allows autocompletion for strings.
+ * @internal
+ */
+type _LiteralUnion<LiteralType, BaseType extends string = string> = LiteralType | (BaseType & Record<never, never>);
+/**
+ * Maybe a promise maybe not
+ * @internal
+ */
+type _Awaitable<T> = T | PromiseLike<T>;
+/**
+ * @internal
+ */
+//#endregion
+//#region src/typed-routes/route-records.d.ts
+/**
+ * @internal
+ */
+type RouteRecordRedirectOption = RouteLocationRaw | ((to: RouteLocation, from: RouteLocationNormalizedLoaded) => RouteLocationRaw);
+/**
+ * Generic version of {@link RouteRecordName}.
+ */
+type RouteRecordNameGeneric = string | symbol | undefined;
+/**
+ * Possible values for a route record **after normalization**
+ *
+ * NOTE: since `RouteRecordName` is a type, it evaluates too early and it's often the generic version {@link RouteRecordNameGeneric}. If you need a typed version of all of the names of routes, use {@link RouteMap | `keyof RouteMap`}
+ */
+/**
+ * @internal
+ */
+type _RouteRecordProps<Name extends keyof RouteMap = keyof RouteMap> = boolean | Record<string, any> | ((to: RouteLocationNormalized<Name>) => Record<string, any>); //#endregion
+//#region src/typed-routes/route-location.d.ts
+/**
+ * Generic version of {@link RouteLocation}. It is used when no {@link RouteMap} is provided.
+ */
+interface RouteLocationGeneric extends _RouteLocationBase, RouteLocationOptions {
+  /**
+   * Array of {@link RouteRecord} containing components as they were
+   * passed when adding records. It can also contain redirect records. This
+   * can't be used directly. **This property is non-enumerable**.
+   */
+  matched: RouteRecord[];
+}
+/**
+ * Helper to generate a type safe version of the {@link RouteLocation} type.
+ */
+interface RouteLocationTyped<RouteMap$1 extends RouteMapGeneric, Name extends keyof RouteMap$1> extends RouteLocationGeneric {
+  name: Extract<Name, string | symbol>;
+  params: RouteMap$1[Name]['params'];
+}
+/**
+ * List of all possible {@link RouteLocation} indexed by the route name.
+ * @internal
+ */
+type RouteLocationTypedList<RouteMap$1 extends RouteMapGeneric = RouteMapGeneric> = { [N in keyof RouteMap$1]: RouteLocationTyped<RouteMap$1, N> };
+/**
+ * Generic version of {@link RouteLocationNormalized} that is used when no {@link RouteMap} is provided.
+ */
+interface RouteLocationNormalizedGeneric extends _RouteLocationBase {
+  name: RouteRecordNameGeneric;
+  /**
+   * Array of {@link RouteRecordNormalized}
+   */
+  matched: RouteRecordNormalized[];
+}
+/**
+ * Helper to generate a type safe version of the {@link RouteLocationNormalized} type.
+ */
+interface RouteLocationNormalizedTyped<RouteMap$1 extends RouteMapGeneric = RouteMapGeneric, Name extends keyof RouteMap$1 = keyof RouteMap$1> extends RouteLocationNormalizedGeneric {
+  name: Extract<Name, string | symbol>;
+  params: RouteMap$1[Name]['params'];
+  /**
+   * Array of {@link RouteRecordNormalized}
+   */
+  matched: RouteRecordNormalized[];
+}
+/**
+ * List of all possible {@link RouteLocationNormalized} indexed by the route name.
+ * @internal
+ */
+type RouteLocationNormalizedTypedList<RouteMap$1 extends RouteMapGeneric = RouteMapGeneric> = { [N in keyof RouteMap$1]: RouteLocationNormalizedTyped<RouteMap$1, N> };
+/**
+ * Generic version of {@link RouteLocationNormalizedLoaded} that is used when no {@link RouteMap} is provided.
+ */
+interface RouteLocationNormalizedLoadedGeneric extends RouteLocationNormalizedGeneric {
+  /**
+   * Array of {@link RouteLocationMatched} containing only plain components (any
+   * lazy-loaded components have been loaded and were replaced inside the
+   * `components` object) so it can be directly used to display routes. It
+   * cannot contain redirect records either. **This property is non-enumerable**.
+   */
+  matched: RouteLocationMatched[];
+}
+/**
+ * Helper to generate a type safe version of the {@link RouteLocationNormalizedLoaded} type.
+ */
+interface RouteLocationNormalizedLoadedTyped<RouteMap$1 extends RouteMapGeneric = RouteMapGeneric, Name extends keyof RouteMap$1 = keyof RouteMap$1> extends RouteLocationNormalizedLoadedGeneric {
+  name: Extract<Name, string | symbol>;
+  params: RouteMap$1[Name]['params'];
+}
+/**
+ * List of all possible {@link RouteLocationNormalizedLoaded} indexed by the route name.
+ * @internal
+ */
+type RouteLocationNormalizedLoadedTypedList<RouteMap$1 extends RouteMapGeneric = RouteMapGeneric> = { [N in keyof RouteMap$1]: RouteLocationNormalizedLoadedTyped<RouteMap$1, N> };
+/**
+ * Generic version of {@link RouteLocationAsRelative}. It is used when no {@link RouteMap} is provided.
+ */
+interface RouteLocationAsRelativeGeneric extends RouteQueryAndHash, RouteLocationOptions {
+  name?: RouteRecordNameGeneric;
+  params?: RouteParamsRawGeneric;
+  /**
+   * A relative path to the current location. This property should be removed
+   */
+  path?: undefined;
+}
+/**
+ * Helper to generate a type safe version of the {@link RouteLocationAsRelative} type.
+ */
+interface RouteLocationAsRelativeTyped<RouteMap$1 extends RouteMapGeneric = RouteMapGeneric, Name extends keyof RouteMap$1 = keyof RouteMap$1> extends RouteLocationAsRelativeGeneric {
+  name?: Extract<Name, string | symbol>;
+  params?: RouteMap$1[Name]['paramsRaw'];
+}
+/**
+ * List of all possible {@link RouteLocationAsRelative} indexed by the route name.
+ * @internal
+ */
+type RouteLocationAsRelativeTypedList<RouteMap$1 extends RouteMapGeneric = RouteMapGeneric> = { [N in keyof RouteMap$1]: RouteLocationAsRelativeTyped<RouteMap$1, N> };
+/**
+ * Generic version of {@link RouteLocationAsPath}. It is used when no {@link RouteMap} is provided.
+ */
+interface RouteLocationAsPathGeneric extends RouteQueryAndHash, RouteLocationOptions {
+  /**
+   * Percentage encoded pathname section of the URL.
+   */
+  path: string;
+}
+/**
+ * Helper to generate a type safe version of the {@link RouteLocationAsPath} type.
+ */
+interface RouteLocationAsPathTyped<RouteMap$1 extends RouteMapGeneric = RouteMapGeneric, Name extends keyof RouteMap$1 = keyof RouteMap$1> extends RouteLocationAsPathGeneric {
+  path: _LiteralUnion<RouteMap$1[Name]['path']>;
+}
+/**
+ * List of all possible {@link RouteLocationAsPath} indexed by the route name.
+ * @internal
+ */
+type RouteLocationAsPathTypedList<RouteMap$1 extends RouteMapGeneric = RouteMapGeneric> = { [N in keyof RouteMap$1]: RouteLocationAsPathTyped<RouteMap$1, N> };
+/**
+ * Helper to generate a type safe version of the {@link RouteLocationAsString} type.
+ */
+type RouteLocationAsStringTyped<RouteMap$1 extends RouteMapGeneric = RouteMapGeneric, Name extends keyof RouteMap$1 = keyof RouteMap$1> = RouteMap$1[Name]['path'];
+/**
+ * List of all possible {@link RouteLocationAsString} indexed by the route name.
+ * @internal
+ */
+type RouteLocationAsStringTypedList<RouteMap$1 extends RouteMapGeneric = RouteMapGeneric> = { [N in keyof RouteMap$1]: RouteLocationAsStringTyped<RouteMap$1, N> };
+/**
+ * Generic version of {@link RouteLocationResolved}. It is used when no {@link RouteMap} is provided.
+ */
+interface RouteLocationResolvedGeneric extends RouteLocationGeneric {
+  /**
+   * Resolved `href` for the route location that will be set on the `<a href="...">`.
+   */
+  href: string;
+}
+/**
+ * Helper to generate a type safe version of the {@link RouteLocationResolved} type.
+ */
+interface RouteLocationResolvedTyped<RouteMap$1 extends RouteMapGeneric, Name extends keyof RouteMap$1> extends RouteLocationTyped<RouteMap$1, Name> {
+  /**
+   * Resolved `href` for the route location that will be set on the `<a href="...">`.
+   */
+  href: string;
+}
+/**
+ * List of all possible {@link RouteLocationResolved} indexed by the route name.
+ * @internal
+ */
+type RouteLocationResolvedTypedList<RouteMap$1 extends RouteMapGeneric = RouteMapGeneric> = { [N in keyof RouteMap$1]: RouteLocationResolvedTyped<RouteMap$1, N> };
+/**
+ * Type safe versions of types that are exposed by vue-router. We have to use a generic check to allow for names to be `undefined` when no `RouteMap` is provided.
+ */
+/**
+ * {@link RouteLocationRaw} resolved using the matcher
+ */
+type RouteLocation<Name extends keyof RouteMap = keyof RouteMap> = RouteMapGeneric extends RouteMap ? RouteLocationGeneric : RouteLocationTypedList<RouteMap>[Name];
+/**
+ * Similar to {@link RouteLocation} but its
+ * {@link RouteLocationNormalizedTyped.matched | `matched` property} cannot contain redirect records
+ */
+type RouteLocationNormalized<Name extends keyof RouteMap = keyof RouteMap> = RouteMapGeneric extends RouteMap ? RouteLocationNormalizedGeneric : RouteLocationNormalizedTypedList<RouteMap>[Name];
+/**
+ * Similar to {@link RouteLocationNormalized} but its `components` do not contain any function to lazy load components.
+ * In other words, it's ready to be rendered by `<RouterView>`.
+ */
+type RouteLocationNormalizedLoaded<Name extends keyof RouteMap = keyof RouteMap> = RouteMapGeneric extends RouteMap ? RouteLocationNormalizedLoadedGeneric : RouteLocationNormalizedLoadedTypedList<RouteMap>[Name];
+/**
+ * Route location relative to the current location. It accepts other properties than `path` like `params`, `query` and
+ * `hash` to conveniently change them.
+ */
+type RouteLocationAsRelative<Name extends keyof RouteMap = keyof RouteMap> = RouteMapGeneric extends RouteMap ? RouteLocationAsRelativeGeneric : RouteLocationAsRelativeTypedList<RouteMap>[Name];
+/**
+ * Route location resolved with {@link Router | `router.resolve()`}.
+ */
+type RouteLocationResolved<Name extends keyof RouteMap = keyof RouteMap> = RouteMapGeneric extends RouteMap ? RouteLocationResolvedGeneric : RouteLocationResolvedTypedList<RouteMap>[Name];
+/**
+ * Same as {@link RouteLocationAsPath} but as a string literal.
+ */
+type RouteLocationAsString<Name extends keyof RouteMap = keyof RouteMap> = RouteMapGeneric extends RouteMap ? string : _LiteralUnion<RouteLocationAsStringTypedList<RouteMap>[Name], string>;
+/**
+ * Route location as an object with a `path` property.
+ */
+type RouteLocationAsPath<Name extends keyof RouteMap = keyof RouteMap> = RouteMapGeneric extends RouteMap ? RouteLocationAsPathGeneric : RouteLocationAsPathTypedList<RouteMap>[Name];
+/**
+ * Route location that can be passed to `router.push()` and other user-facing APIs.
+ */
+type RouteLocationRaw<Name extends keyof RouteMap = keyof RouteMap> = RouteMapGeneric extends RouteMap ? RouteLocationAsString | RouteLocationAsRelativeGeneric | RouteLocationAsPathGeneric : _LiteralUnion<RouteLocationAsStringTypedList<RouteMap>[Name], string> | RouteLocationAsRelativeTypedList<RouteMap>[Name] | RouteLocationAsPathTypedList<RouteMap>[Name]; //#endregion
+//#region src/typed-routes/navigation-guards.d.ts
+/**
+ * Return types for a Navigation Guard. Based on `TypesConfig`
+ *
+ * @see {@link TypesConfig}
+ */
+type NavigationGuardReturn = void | Error | boolean | RouteLocationRaw;
+/**
+ * Navigation Guard with a type parameter for `this`.
+ * @see {@link TypesConfig}
+ */
+interface NavigationGuardWithThis<T> {
+  (this: T, to: RouteLocationNormalized, from: RouteLocationNormalizedLoaded, next: NavigationGuardNext): _Awaitable<NavigationGuardReturn>;
+}
+/**
+ * Navigation Guard.
+ */
+interface NavigationGuard {
+  (to: RouteLocationNormalized, from: RouteLocationNormalizedLoaded, next: NavigationGuardNext): _Awaitable<NavigationGuardReturn>;
+}
+/**
+ * Navigation hook triggered after a navigation is settled.
+ */
+interface NavigationHookAfter {
+  (to: RouteLocationNormalized, from: RouteLocationNormalizedLoaded, failure?: NavigationFailure | void): unknown;
+}
+/**
+ * `next()` callback passed to navigation guards.
+ */
+interface NavigationGuardNext {
+  (): void;
+  (error: Error): void;
+  (location: RouteLocationRaw): void;
+  (valid: boolean | undefined): void;
+  (cb: NavigationGuardNextCallback): void;
+}
+/**
+ * Callback that can be passed to `next()` in `beforeRouteEnter()` guards.
+ */
+type NavigationGuardNextCallback = (vm: ComponentPublicInstance) => unknown; //#endregion
+//#region src/matcher/types.d.ts
+/**
+ * Normalized version of a {@link RouteRecord | route record}.
+ */
+interface RouteRecordNormalized {
+  /**
+   * {@inheritDoc _RouteRecordBase.path}
+   */
+  path: _RouteRecordBase['path'];
+  /**
+   * {@inheritDoc _RouteRecordBase.redirect}
+   */
+  redirect: _RouteRecordBase['redirect'] | undefined;
+  /**
+   * {@inheritDoc _RouteRecordBase.name}
+   */
+  name: _RouteRecordBase['name'];
+  /**
+   * {@inheritDoc RouteRecordMultipleViews.components}
+   */
+  components: RouteRecordMultipleViews['components'] | null | undefined;
+  /**
+   * Contains the original modules for lazy loaded components.
+   * @internal
+   */
+  mods: Record<string, unknown>;
+  /**
+   * Nested route records.
+   */
+  children: RouteRecordRaw[];
+  /**
+   * {@inheritDoc _RouteRecordBase.meta}
+   */
+  meta: Exclude<_RouteRecordBase['meta'], void>;
+  /**
+   * {@inheritDoc RouteRecordMultipleViews.props}
+   */
+  props: Record<string, _RouteRecordProps>;
+  /**
+   * Registered beforeEnter guards
+   */
+  beforeEnter: _RouteRecordBase['beforeEnter'];
+  /**
+   * Registered leave guards
+   *
+   * @internal
+   */
+  leaveGuards: Set<NavigationGuard>;
+  /**
+   * Registered update guards
+   *
+   * @internal
+   */
+  updateGuards: Set<NavigationGuard>;
+  /**
+   * Registered beforeRouteEnter callbacks passed to `next` or returned in guards
+   *
+   * @internal
+   */
+  enterCallbacks: Record<string, NavigationGuardNextCallback[]>;
+  /**
+   * Mounted route component instances
+   * Having the instances on the record mean beforeRouteUpdate and
+   * beforeRouteLeave guards can only be invoked with the latest mounted app
+   * instance if there are multiple application instances rendering the same
+   * view, basically duplicating the content on the page, which shouldn't happen
+   * in practice. It will work if multiple apps are rendering different named
+   * views.
+   */
+  instances: Record<string, ComponentPublicInstance | undefined | null>;
+  /**
+   * Defines if this record is the alias of another one. This property is
+   * `undefined` if the record is the original one.
+   */
+  aliasOf: RouteRecordNormalized | undefined;
+}
+/**
+ * {@inheritDoc RouteRecordNormalized}
+ */
+type RouteRecord = RouteRecordNormalized; //#endregion
+//#region src/matcher/pathParserRanker.d.ts
+/**
+ * @internal
+ */
+interface _PathParserOptions {
+  /**
+   * Makes the RegExp case-sensitive.
+   *
+   * @defaultValue `false`
+   */
+  sensitive?: boolean;
+  /**
+   * Whether to disallow a trailing slash or not.
+   *
+   * @defaultValue `false`
+   */
+  strict?: boolean;
+  /**
+   * Should the RegExp match from the beginning by prepending a `^` to it.
+   * @internal
+   *
+   * @defaultValue `true`
+   */
+  start?: boolean;
+  /**
+   * Should the RegExp match until the end by appending a `$` to it.
+   *
+   * @deprecated this option will alsways be `true` in the future. Open a discussion in vuejs/router if you need this to be `false`
+   *
+   * @defaultValue `true`
+   */
+  end?: boolean;
+}
+type PathParserOptions = Pick<_PathParserOptions, 'end' | 'sensitive' | 'strict'>; //#endregion
+//#region src/matcher/pathMatcher.d.ts
+//#endregion
+//#region src/history/common.d.ts
+type HistoryLocation = string;
+/**
+ * Allowed variables in HTML5 history state. Note that pushState clones the state
+ * passed and does not accept everything: e.g.: it doesn't accept symbols, nor
+ * functions as values. It also ignores Symbols as keys.
+ *
+ * @internal
+ */
+type HistoryStateValue = string | number | boolean | null | undefined | HistoryState | HistoryStateArray;
+/**
+ * Allowed HTML history.state
+ */
+interface HistoryState {
+  [x: number]: HistoryStateValue;
+  [x: string]: HistoryStateValue;
+}
+/**
+ * Allowed arrays for history.state.
+ *
+ * @internal
+ */
+interface HistoryStateArray extends Array<HistoryStateValue> {}
+declare enum NavigationType {
+  pop = "pop",
+  push = "push"
+}
+declare enum NavigationDirection {
+  back = "back",
+  forward = "forward",
+  unknown = ""
+}
+interface NavigationInformation {
+  type: NavigationType;
+  direction: NavigationDirection;
+  delta: number;
+}
+interface NavigationCallback {
+  (to: HistoryLocation, from: HistoryLocation, information: NavigationInformation): void;
+}
+/**
+ * Interface implemented by History implementations that can be passed to the
+ * router as {@link Router.history}
+ *
+ * @alpha
+ */
+interface RouterHistory {
+  /**
+   * Base path that is prepended to every url. This allows hosting an SPA at a
+   * sub-folder of a domain like `example.com/sub-folder` by having a `base` of
+   * `/sub-folder`
+   */
+  readonly base: string;
+  /**
+   * Current History location
+   */
+  readonly location: HistoryLocation;
+  /**
+   * Current History state
+   */
+  readonly state: HistoryState;
+  /**
+   * Navigates to a location. In the case of an HTML5 History implementation,
+   * this will call `history.pushState` to effectively change the URL.
+   *
+   * @param to - location to push
+   * @param data - optional {@link HistoryState} to be associated with the
+   * navigation entry
+   */
+  push(to: HistoryLocation, data?: HistoryState): void;
+  /**
+   * Same as {@link RouterHistory.push} but performs a `history.replaceState`
+   * instead of `history.pushState`
+   *
+   * @param to - location to set
+   * @param data - optional {@link HistoryState} to be associated with the
+   * navigation entry
+   */
+  replace(to: HistoryLocation, data?: HistoryState): void;
+  /**
+   * Traverses history in a given direction.
+   *
+   * @example
+   * ```js
+   * myHistory.go(-1) // equivalent to window.history.back()
+   * myHistory.go(1) // equivalent to window.history.forward()
+   * ```
+   *
+   * @param delta - distance to travel. If delta is \< 0, it will go back,
+   * if it's \> 0, it will go forward by that amount of entries.
+   * @param triggerListeners - whether this should trigger listeners attached to
+   * the history
+   */
+  go(delta: number, triggerListeners?: boolean): void;
+  /**
+   * Attach a listener to the History implementation that is triggered when the
+   * navigation is triggered from outside (like the Browser back and forward
+   * buttons) or when passing `true` to {@link RouterHistory.back} and
+   * {@link RouterHistory.forward}
+   *
+   * @param callback - listener to attach
+   * @returns a callback to remove the listener
+   */
+  listen(callback: NavigationCallback): () => void;
+  /**
+   * Generates the corresponding href to be used in an anchor tag.
+   *
+   * @param location - history location that should create an href
+   */
+  createHref(location: HistoryLocation): string;
+  /**
+   * Clears any event listener attached by the history implementation.
+   */
+  destroy(): void;
+} //#endregion
+//#region src/types/index.d.ts
+type Lazy<T> = () => Promise<T>;
+/**
+ * @internal
+ */
+type RouteParamValue = string;
+/**
+ * @internal
+ */
+type RouteParamValueRaw = RouteParamValue | number | null | undefined;
+type RouteParamsGeneric = Record<string, RouteParamValue | RouteParamValue[]>;
+type RouteParamsRawGeneric = Record<string, RouteParamValueRaw | Exclude<RouteParamValueRaw, null | undefined>[]>;
+/**
+ * @internal
+ */
+interface RouteQueryAndHash {
+  query?: LocationQueryRaw;
+  hash?: string;
+}
+/**
+ * @internal
+ */
+/**
+ * Common options for all navigation methods.
+ */
+interface RouteLocationOptions {
+  /**
+   * Replace the entry in the history instead of pushing a new entry
+   */
+  replace?: boolean;
+  /**
+   * Triggers the navigation even if the location is the same as the current one.
+   * Note this will also add a new entry to the history unless `replace: true`
+   * is passed.
+   */
+  force?: boolean;
+  /**
+   * State to save using the History API. This cannot contain any reactive
+   * values and some primitives like Symbols are forbidden. More info at
+   * https://developer.mozilla.org/en-US/docs/Web/API/History/state
+   */
+  state?: HistoryState;
+}
+/**
+ * Route Location that can infer the necessary params based on the name.
+ *
+ * @internal
+ */
+interface RouteLocationMatched extends RouteRecordNormalized {
+  components: Record<string, RouteComponent> | null | undefined;
+}
+/**
+ * Base properties for a normalized route location.
+ *
+ * @internal
+ */
+interface _RouteLocationBase extends Pick<MatcherLocation, 'name' | 'path' | 'params' | 'meta'> {
+  /**
+   * The whole location including the `search` and `hash`. This string is
+   * percentage encoded.
+   */
+  fullPath: string;
+  /**
+   * Object representation of the `search` property of the current location.
+   */
+  query: LocationQuery;
+  /**
+   * Hash of the current location. If present, starts with a `#`.
+   */
+  hash: string;
+  /**
+   * Contains the location we were initially trying to access before ending up
+   * on the current location.
+   */
+  redirectedFrom: RouteLocation | undefined;
+}
+/**
+ * Allowed Component in {@link RouteLocationMatched}
+ */
+type RouteComponent = Component$1 | DefineComponent;
+/**
+ * Allowed Component definitions in route records provided by the user
+ */
+type RawRouteComponent = RouteComponent | Lazy<RouteComponent>;
+/**
+ * Internal type for common properties among all kind of {@link RouteRecordRaw}.
+ */
+interface _RouteRecordBase extends PathParserOptions {
+  /**
+   * Path of the record. Should start with `/` unless the record is the child of
+   * another record.
+   *
+   * @example `/users/:id` matches `/users/1` as well as `/users/posva`.
+   */
+  path: string;
+  /**
+   * Where to redirect if the route is directly matched. The redirection happens
+   * before any navigation guard and triggers a new navigation with the new
+   * target location.
+   */
+  redirect?: RouteRecordRedirectOption;
+  /**
+   * Aliases for the record. Allows defining extra paths that will behave like a
+   * copy of the record. Allows having paths shorthands like `/users/:id` and
+   * `/u/:id`. All `alias` and `path` values must share the same params.
+   */
+  alias?: string | string[];
+  /**
+   * Name for the route record. Must be unique.
+   */
+  name?: RouteRecordNameGeneric;
+  /**
+   * Before Enter guard specific to this record. Note `beforeEnter` has no
+   * effect if the record has a `redirect` property.
+   */
+  beforeEnter?: NavigationGuardWithThis<undefined> | NavigationGuardWithThis<undefined>[];
+  /**
+   * Arbitrary data attached to the record.
+   */
+  meta?: RouteMeta;
+  /**
+   * Array of nested routes.
+   */
+  children?: RouteRecordRaw[];
+  /**
+   * Allow passing down params as props to the component rendered by `router-view`.
+   */
+  props?: _RouteRecordProps | Record<string, _RouteRecordProps>;
+}
+/**
+ * Interface to type `meta` fields in route records.
+ *
+ * @example
+ *
+ * ```ts
+ * // typings.d.ts or router.ts
+ * import 'vue-router';
+ *
+ * declare module 'vue-router' {
+ *   interface RouteMeta {
+ *     requiresAuth?: boolean
+ *   }
+ * }
+ * ```
+ */
+interface RouteMeta extends Record<PropertyKey, unknown> {}
+/**
+ * Route Record defining one single component with the `component` option.
+ */
+interface RouteRecordSingleView extends _RouteRecordBase {
+  /**
+   * Component to display when the URL matches this route.
+   */
+  component: RawRouteComponent;
+  components?: never;
+  children?: never;
+  redirect?: never;
+  /**
+   * Allow passing down params as props to the component rendered by `router-view`.
+   */
+  props?: _RouteRecordProps;
+}
+/**
+ * Route Record defining one single component with a nested view. Differently
+ * from {@link RouteRecordSingleView}, this record has children and allows a
+ * `redirect` option.
+ */
+interface RouteRecordSingleViewWithChildren extends _RouteRecordBase {
+  /**
+   * Component to display when the URL matches this route.
+   */
+  component?: RawRouteComponent | null | undefined;
+  components?: never;
+  children: RouteRecordRaw[];
+  /**
+   * Allow passing down params as props to the component rendered by `router-view`.
+   */
+  props?: _RouteRecordProps;
+}
+/**
+ * Route Record defining multiple named components with the `components` option.
+ */
+interface RouteRecordMultipleViews extends _RouteRecordBase {
+  /**
+   * Components to display when the URL matches this route. Allow using named views.
+   */
+  components: Record<string, RawRouteComponent>;
+  component?: never;
+  children?: never;
+  redirect?: never;
+  /**
+   * Allow passing down params as props to the component rendered by
+   * `router-view`. Should be an object with the same keys as `components` or a
+   * boolean to be applied to every component.
+   */
+  props?: Record<string, _RouteRecordProps> | boolean;
+}
+/**
+ * Route Record defining multiple named components with the `components` option and children.
+ */
+interface RouteRecordMultipleViewsWithChildren extends _RouteRecordBase {
+  /**
+   * Components to display when the URL matches this route. Allow using named views.
+   */
+  components?: Record<string, RawRouteComponent> | null | undefined;
+  component?: never;
+  children: RouteRecordRaw[];
+  /**
+   * Allow passing down params as props to the component rendered by
+   * `router-view`. Should be an object with the same keys as `components` or a
+   * boolean to be applied to every component.
+   */
+  props?: Record<string, _RouteRecordProps> | boolean;
+}
+/**
+ * Route Record that defines a redirect. Cannot have `component` or `components`
+ * as it is never rendered.
+ */
+interface RouteRecordRedirect extends _RouteRecordBase {
+  redirect: RouteRecordRedirectOption;
+  component?: never;
+  components?: never;
+  props?: never;
+}
+type RouteRecordRaw = RouteRecordSingleView | RouteRecordSingleViewWithChildren | RouteRecordMultipleViews | RouteRecordMultipleViewsWithChildren | RouteRecordRedirect;
+/**
+ * Route location that can be passed to the matcher.
+ */
+/**
+ * Normalized/resolved Route location that returned by the matcher.
+ */
+interface MatcherLocation {
+  /**
+   * Name of the matched record
+   */
+  name: RouteRecordNameGeneric | null | undefined;
+  /**
+   * Percentage encoded pathname section of the URL.
+   */
+  path: string;
+  /**
+   * Object of decoded params extracted from the `path`.
+   */
+  params: RouteParamsGeneric;
+  /**
+   * Merged `meta` properties from all the matched route records.
+   */
+  meta: RouteMeta;
+  /**
+   * Array of {@link RouteRecord} containing components as they were
+   * passed when adding records. It can also contain redirect records. This
+   * can't be used directly
+   */
+  matched: RouteRecord[];
+} //#endregion
+//#region src/errors.d.ts
+/**
+ * Flags so we can combine them when checking for multiple errors. This is the internal version of
+ * {@link NavigationFailureType}.
+ *
+ * @internal
+ */
+declare const enum ErrorTypes {
+  MATCHER_NOT_FOUND = 1,
+  NAVIGATION_GUARD_REDIRECT = 2,
+  NAVIGATION_ABORTED = 4,
+  NAVIGATION_CANCELLED = 8,
+  NAVIGATION_DUPLICATED = 16
+}
+/**
+ * Enumeration with all possible types for navigation failures. Can be passed to
+ * {@link isNavigationFailure} to check for specific failures.
+ */
+/**
+ * Extended Error that contains extra information regarding a failed navigation.
+ */
+interface NavigationFailure extends Error {
+  /**
+   * Type of the navigation. One of {@link NavigationFailureType}
+   */
+  type: ErrorTypes.NAVIGATION_CANCELLED | ErrorTypes.NAVIGATION_ABORTED | ErrorTypes.NAVIGATION_DUPLICATED;
+  /**
+   * Route location we were navigating from
+   */
+  from: RouteLocationNormalized;
+  /**
+   * Route location we were navigating to
+   */
+  to: RouteLocationNormalized;
+}
+/**
+ * Internal error used to detect a redirection.
+ *
+ * @internal
+ */
+/**
+ * Internal type to define an ErrorHandler
+ *
+ * @param error - error thrown
+ * @param to - location we were navigating to when the error happened
+ * @param from - location we were navigating from when the error happened
+ * @internal
+ */
+interface _ErrorListener {
+  (error: any, to: RouteLocationNormalized, from: RouteLocationNormalizedLoaded): any;
+} //#endregion
+//#region src/scrollBehavior.d.ts
+/**
+ * Scroll position similar to
+ * {@link https://developer.mozilla.org/en-US/docs/Web/API/ScrollToOptions | `ScrollToOptions`}.
+ * Note that not all browsers support `behavior`.
+ */
+type ScrollPositionCoordinates = {
+  behavior?: ScrollOptions['behavior'];
+  left?: number;
+  top?: number;
+};
+/**
+ * Internal normalized version of {@link ScrollPositionCoordinates} that always
+ * has `left` and `top` coordinates. Must be a type to be assignable to HistoryStateValue.
+ *
+ * @internal
+ */
+type _ScrollPositionNormalized = {
+  behavior?: ScrollOptions['behavior'];
+  left: number;
+  top: number;
+};
+/**
+ * Type of the `scrollBehavior` option that can be passed to `createRouter`.
+ */
+interface RouterScrollBehavior {
+  /**
+   * @param to - Route location where we are navigating to
+   * @param from - Route location where we are navigating from
+   * @param savedPosition - saved position if it exists, `null` otherwise
+   */
+  (to: RouteLocationNormalized, from: RouteLocationNormalizedLoaded, savedPosition: _ScrollPositionNormalized | null): Awaitable<ScrollPosition | false | void>;
+}
+interface ScrollPositionElement extends ScrollToOptions {
+  /**
+   * A valid CSS selector. Note some characters must be escaped in id selectors (https://mathiasbynens.be/notes/css-escapes).
+   * @example
+   * Here are a few examples:
+   *
+   * - `.title`
+   * - `.content:first-child`
+   * - `#marker`
+   * - `#marker\~with\~symbols`
+   * - `#marker.with.dot`: selects `class="with dot" id="marker"`, not `id="marker.with.dot"`
+   *
+   */
+  el: string | Element;
+}
+type ScrollPosition = ScrollPositionCoordinates | ScrollPositionElement;
+type Awaitable<T> = T | PromiseLike<T>; //#endregion
+//#region src/experimental/route-resolver/matchers/param-parsers/types.d.ts
+/**
+ * Defines a parser that can read a param from the url (string-based) and
+ * transform it into a more complex type, or vice versa.
+ *
+ * @see MatcherPattern
+ */
+//#endregion
+//#region src/experimental/router.d.ts
+/**
+ * Options to initialize a {@link Router} instance.
+ */
+interface EXPERIMENTAL_RouterOptions_Base extends PathParserOptions {
+  /**
+   * History implementation used by the router. Most web applications should use
+   * `createWebHistory` but it requires the server to be properly configured.
+   * You can also use a _hash_ based history with `createWebHashHistory` that
+   * does not require any configuration on the server but isn't handled at all
+   * by search engines and does poorly on SEO.
+   *
+   * @example
+   * ```js
+   * createRouter({
+   *   history: createWebHistory(),
+   *   // other options...
+   * })
+   * ```
+   */
+  history: RouterHistory;
+  /**
+   * Function to control scrolling when navigating between pages. Can return a
+   * Promise to delay scrolling.
+   *
+   * @see {@link RouterScrollBehavior}.
+   *
+   * @example
+   * ```js
+   * function scrollBehavior(to, from, savedPosition) {
+   *   // `to` and `from` are both route locations
+   *   // `savedPosition` can be null if there isn't one
+   * }
+   * ```
+   */
+  scrollBehavior?: RouterScrollBehavior;
+  /**
+   * Custom implementation to parse a query. See its counterpart,
+   * {@link EXPERIMENTAL_RouterOptions_Base.stringifyQuery}.
+   *
+   * @example
+   * Let's say you want to use the [qs package](https://github.com/ljharb/qs)
+   * to parse queries, you can provide both `parseQuery` and `stringifyQuery`:
+   * ```js
+   * import qs from 'qs'
+   *
+   * createRouter({
+   *   // other options...
+   *   parseQuery: qs.parse,
+   *   stringifyQuery: qs.stringify,
+   * })
+   * ```
+   */
+  parseQuery?: typeof parseQuery;
+  /**
+   * Custom implementation to stringify a query object. Should not prepend a leading `?`.
+   * {@link parseQuery} counterpart to handle query parsing.
+   */
+  stringifyQuery?: typeof stringifyQuery;
+  /**
+   * Default class applied to active {@link RouterLink}. If none is provided,
+   * `router-link-active` will be applied.
+   */
+  linkActiveClass?: string;
+  /**
+   * Default class applied to exact active {@link RouterLink}. If none is provided,
+   * `router-link-exact-active` will be applied.
+   */
+  linkExactActiveClass?: string;
+}
+/**
+ * Internal type for common properties among all kind of {@link RouteRecordRaw}.
+ */
+/**
+ * Router base instance.
+ *
+ * @experimental This version is not stable, it's meant to replace {@link Router} in the future.
+ */
+interface EXPERIMENTAL_Router_Base<TRecord> {
+  /**
+   * Current {@link RouteLocationNormalized}
+   */
+  readonly currentRoute: ShallowRef<RouteLocationNormalizedLoaded>;
+  /**
+   * Allows turning off the listening of history events. This is a low level api for micro-frontend.
+   */
+  listening: boolean;
+  /**
+   * Checks if a route with a given name exists
+   *
+   * @param name - Name of the route to check
+   */
+  hasRoute(name: NonNullable<RouteRecordNameGeneric>): boolean;
+  /**
+   * Get a full list of all the {@link RouteRecord | route records}.
+   */
+  getRoutes(): TRecord[];
+  /**
+   * Returns the {@link RouteLocation | normalized version} of a
+   * {@link RouteLocationRaw | route location}. Also includes an `href` property
+   * that includes any existing `base`. By default, the `currentLocation` used is
+   * `router.currentRoute` and should only be overridden in advanced use cases.
+   *
+   * @param to - Raw route location to resolve
+   * @param currentLocation - Optional current location to resolve against
+   */
+  resolve<Name extends keyof RouteMap = keyof RouteMap>(to: RouteLocationAsRelativeTyped<RouteMap, Name>, currentLocation?: RouteLocationNormalizedLoaded): RouteLocationResolved<Name>;
+  resolve(to: RouteLocationAsString | RouteLocationAsRelative | RouteLocationAsPath, currentLocation?: RouteLocationNormalizedLoaded): RouteLocationResolved;
+  /**
+   * Programmatically navigate to a new URL by pushing an entry in the history
+   * stack.
+   *
+   * @param to - Route location to navigate to
+   */
+  push(to: RouteLocationRaw): Promise<NavigationFailure | void | undefined>;
+  /**
+   * Programmatically navigate to a new URL by replacing the current entry in
+   * the history stack.
+   *
+   * @param to - Route location to navigate to
+   */
+  replace(to: RouteLocationRaw): Promise<NavigationFailure | void | undefined>;
+  /**
+   * Go back in history if possible by calling `history.back()`. Equivalent to
+   * `router.go(-1)`.
+   */
+  back(): void;
+  /**
+   * Go forward in history if possible by calling `history.forward()`.
+   * Equivalent to `router.go(1)`.
+   */
+  forward(): void;
+  /**
+   * Allows you to move forward or backward through the history. Calls
+   * `history.go()`.
+   *
+   * @param delta - The position in the history to which you want to move,
+   * relative to the current page
+   */
+  go(delta: number): void;
+  /**
+   * Add a navigation guard that executes before any navigation. Returns a
+   * function that removes the registered guard.
+   *
+   * @param guard - navigation guard to add
+   */
+  beforeEach(guard: NavigationGuardWithThis<undefined>): () => void;
+  /**
+   * Add a navigation guard that executes before navigation is about to be
+   * resolved. At this state all component have been fetched and other
+   * navigation guards have been successful. Returns a function that removes the
+   * registered guard.
+   *
+   * @param guard - navigation guard to add
+   * @returns a function that removes the registered guard
+   *
+   * @example
+   * ```js
+   * router.beforeResolve(to => {
+   *   if (to.meta.requiresAuth && !isAuthenticated) return false
+   * })
+   * ```
+   *
+   */
+  beforeResolve(guard: NavigationGuardWithThis<undefined>): () => void;
+  /**
+   * Add a navigation hook that is executed after every navigation. Returns a
+   * function that removes the registered hook.
+   *
+   * @param guard - navigation hook to add
+   * @returns a function that removes the registered hook
+   *
+   * @example
+   * ```js
+   * router.afterEach((to, from, failure) => {
+   *   if (isNavigationFailure(failure)) {
+   *     console.log('failed navigation', failure)
+   *   }
+   * })
+   * ```
+   */
+  afterEach(guard: NavigationHookAfter): () => void;
+  /**
+   * Adds an error handler that is called every time a non caught error happens
+   * during navigation. This includes errors thrown synchronously and
+   * asynchronously, errors returned or passed to `next` in any navigation
+   * guard, and errors occurred when trying to resolve an async component that
+   * is required to render a route.
+   *
+   * @param handler - error handler to register
+   */
+  onError(handler: _ErrorListener): () => void;
+  /**
+   * Returns a Promise that resolves when the router has completed the initial
+   * navigation, which means it has resolved all async enter hooks and async
+   * components that are associated with the initial route. If the initial
+   * navigation already happened, the promise resolves immediately.
+   *
+   * This is useful in server-side rendering to ensure consistent output on both
+   * the server and the client. Note that on server side, you need to manually
+   * push the initial location while on client side, the router automatically
+   * picks it up from the URL.
+   */
+  isReady(): Promise<void>;
+  /**
+   * Called automatically by `app.use(router)`. Should not be called manually by
+   * the user. This will trigger the initial navigation when on client side.
+   *
+   * @internal
+   * @param app - Application that uses the router
+   */
+  install(app: App): void;
+}
+//#endregion
+//#region ../../node_modules/.pnpm/vue-router@4.6.4_vue@3.5.30_typescript@5.9.3_/node_modules/vue-router/dist/vue-router.d.mts
+//#endregion
+//#region src/router.d.ts
+/**
+ * Options to initialize a {@link Router} instance.
+ */
+interface RouterOptions extends EXPERIMENTAL_RouterOptions_Base {
+  /**
+   * Initial list of routes that should be added to the router.
+   */
+  routes: Readonly<RouteRecordRaw[]>;
+}
+/**
+ * Router instance.
+ */
+interface Router extends EXPERIMENTAL_Router_Base<RouteRecordNormalized> {
+  /**
+   * Original options object passed to create the Router
+   */
+  readonly options: RouterOptions;
+  /**
+   * Add a new {@link RouteRecordRaw | route record} as the child of an existing route.
+   *
+   * @param parentName - Parent Route Record where `route` should be appended at
+   * @param route - Route Record to add
+   */
+  addRoute(parentName: NonNullable<RouteRecordNameGeneric>, route: RouteRecordRaw): () => void;
+  /**
+   * Add a new {@link RouteRecordRaw | route record} to the router.
+   *
+   * @param route - Route Record to add
+   */
+  addRoute(route: RouteRecordRaw): () => void;
+  /**
+   * Remove an existing route by its name.
+   *
+   * @param name - Name of the route to remove
+   */
+  removeRoute(name: NonNullable<RouteRecordNameGeneric>): void;
+  /**
+   * Delete all routes from the router.
+   */
+  clearRoutes(): void;
+}
+/**
+ * Creates a Router instance that can be used by a Vue app.
+ *
+ * @param options - {@link RouterOptions}
+ */
+//#endregion
+//#region src/RouterLink.d.ts
+interface RouterLinkOptions {
+  /**
+   * Route Location the link should navigate to when clicked on.
+   */
+  to: RouteLocationRaw;
+  /**
+   * Calls `router.replace` instead of `router.push`.
+   */
+  replace?: boolean;
+}
+interface RouterLinkProps extends RouterLinkOptions {
+  /**
+   * Whether RouterLink should not wrap its content in an `a` tag. Useful when
+   * using `v-slot` to create a custom RouterLink
+   */
+  custom?: boolean;
+  /**
+   * Class to apply when the link is active
+   */
+  activeClass?: string;
+  /**
+   * Class to apply when the link is exact active
+   */
+  exactActiveClass?: string;
+  /**
+   * Value passed to the attribute `aria-current` when the link is exact active.
+   *
+   * @defaultValue `'page'`
+   */
+  ariaCurrentValue?: 'page' | 'step' | 'location' | 'date' | 'time' | 'true' | 'false';
+  /**
+   * Pass the returned promise of `router.push()` to `document.startViewTransition()` if supported.
+   */
+  viewTransition?: boolean;
+}
+/**
+ * Options passed to {@link useLink}.
+ */
+interface UseLinkOptions<Name extends keyof RouteMap = keyof RouteMap> {
+  to: MaybeRef<RouteLocationAsString | RouteLocationAsRelativeTyped<RouteMap, Name> | RouteLocationAsPath | RouteLocationRaw>;
+  replace?: MaybeRef<boolean | undefined>;
+  /**
+   * Pass the returned promise of `router.push()` to `document.startViewTransition()` if supported.
+   */
+  viewTransition?: boolean;
+}
+/**
+ * Return type of {@link useLink}.
+ * @internal
+ */
+interface UseLinkReturn<Name extends keyof RouteMap = keyof RouteMap> {
+  route: ComputedRef<RouteLocationResolved<Name>>;
+  href: ComputedRef<string>;
+  isActive: ComputedRef<boolean>;
+  isExactActive: ComputedRef<boolean>;
+  navigate(e?: MouseEvent): Promise<void | NavigationFailure>;
+}
+/**
+ * Returns the internal behavior of a {@link RouterLink} without the rendering part.
+ *
+ * @param props - a `to` location and an optional `replace` flag
+ */
+declare function useLink<Name extends keyof RouteMap = keyof RouteMap>(props: UseLinkOptions<Name>): UseLinkReturn<Name>;
+/**
+ * Component to render a link that triggers a navigation on click.
+ */
+declare const RouterLink: _RouterLinkI;
+/**
+ * @internal
+ */
+type _RouterLinkPropsTypedBase = AllowedComponentProps & ComponentCustomProps & VNodeProps & RouterLinkProps;
+/**
+ * @internal
+ */
+type RouterLinkPropsTyped<Custom extends boolean | undefined> = Custom extends true ? _RouterLinkPropsTypedBase & {
+  custom: true;
+} : _RouterLinkPropsTypedBase & {
+  custom?: false | undefined;
+} & Omit<AnchorHTMLAttributes, 'href'>;
+/**
+ * Typed version of the `RouterLink` component. Its generic defaults to the typed router, so it can be inferred
+ * automatically for JSX.
+ *
+ * @internal
+ */
+interface _RouterLinkI {
+  new <Custom extends boolean | undefined = boolean | undefined>(): {
+    $props: RouterLinkPropsTyped<Custom>;
+    $slots: {
+      default?: ({
+        route,
+        href,
+        isActive,
+        isExactActive,
+        navigate
+      }: UnwrapRef<UseLinkReturn>) => VNode[];
+    };
+  };
+  /**
+   * Access to `useLink()` without depending on using vue-router
+   *
+   * @internal
+   */
+  useLink: typeof useLink;
+} //#endregion
+//#region src/RouterView.d.ts
+interface RouterViewProps {
+  name?: string;
+  route?: RouteLocationNormalized;
+}
+/**
+ * Component to display the current route the user is at.
+ */
+declare const RouterView: {
+  new (): {
+    $props: AllowedComponentProps & ComponentCustomProps & VNodeProps & RouterViewProps;
+    $slots: {
+      default?: ({
+        Component,
+        route
+      }: {
+        Component: VNode;
+        route: RouteLocationNormalizedLoaded;
+      }) => VNode[];
+    };
+  };
+}; //#endregion
+//#region src/useApi.d.ts
+/**
+ * Returns the router instance. Equivalent to using `$router` inside
+ * templates.
+ */
+//#endregion
+//#region src/index.d.ts
+declare module 'vue' {
+  interface ComponentCustomOptions {
+    /**
+     * Guard called when the router is navigating to the route that is rendering
+     * this component from a different route. Differently from `beforeRouteUpdate`
+     * and `beforeRouteLeave`, `beforeRouteEnter` does not have access to the
+     * component instance through `this` because it triggers before the component
+     * is even mounted.
+     *
+     * @param to - RouteLocationRaw we are navigating to
+     * @param from - RouteLocationRaw we are navigating from
+     * @param next - function to validate, cancel or modify (by redirecting) the
+     * navigation
+     */
+    beforeRouteEnter?: TypesConfig extends Record<'beforeRouteEnter', infer T> ? T : NavigationGuardWithThis<undefined>;
+    /**
+     * Guard called whenever the route that renders this component has changed, but
+     * it is reused for the new route. This allows you to guard for changes in
+     * params, the query or the hash.
+     *
+     * @param to - RouteLocationRaw we are navigating to
+     * @param from - RouteLocationRaw we are navigating from
+     * @param next - function to validate, cancel or modify (by redirecting) the
+     * navigation
+     */
+    beforeRouteUpdate?: TypesConfig extends Record<'beforeRouteUpdate', infer T> ? T : NavigationGuard;
+    /**
+     * Guard called when the router is navigating away from the current route that
+     * is rendering this component.
+     *
+     * @param to - RouteLocationRaw we are navigating to
+     * @param from - RouteLocationRaw we are navigating from
+     * @param next - function to validate, cancel or modify (by redirecting) the
+     * navigation
+     */
+    beforeRouteLeave?: TypesConfig extends Record<'beforeRouteLeave', infer T> ? T : NavigationGuard;
+  }
+  interface ComponentCustomProperties {
+    /**
+     * Normalized current location. See {@link RouteLocationNormalizedLoaded}.
+     */
+    $route: TypesConfig extends Record<'$route', infer T> ? T : RouteLocationNormalizedLoaded;
+    /**
+     * {@link Router} instance used by the application.
+     */
+    $router: TypesConfig extends Record<'$router', infer T> ? T : Router;
+  }
+  interface GlobalComponents {
+    RouterView: TypesConfig extends Record<'RouterView', infer T> ? T : typeof RouterView;
+    RouterLink: TypesConfig extends Record<'RouterLink', infer T> ? T : typeof RouterLink;
+  }
+} //#endregion
+//#endregion
+//#region src/composables/use-table-url-query.d.ts
+/** Options for {@link useTableUrlQuery}. */
+interface UseTableUrlQueryOptions {
+  /**
+   * Navigation mode for outbound writes.
+   * - `"replace"` (default) — `router.replace`, no new history entry. Right
+   *   for tables that emit on every keystroke (search box) so back-button
+   *   doesn't step through 30 typing-induced URLs.
+   * - `"push"` — `router.push`, every state change becomes a discrete
+   *   history entry. Choose when each filter/sort change should be
+   *   navigation-recoverable.
+   */
+  mode?: "replace" | "push";
+}
+/**
+ * Bridge `<AsTableRoot v-model:url-query>` to vue-router. Uses **type-only**
+ * imports of `Router` and `RouteLocationNormalizedLoaded` — no runtime
+ * dependency on `vue-router` is added to `@atscript/vue-table`. Consumers
+ * pass in their already-resolved `useRoute()` and `useRouter()` instances.
+ *
+ * Scope: **owns the whole query string**. The getter returns the entire
+ * `route.query` serialized; the setter replaces `route.query` wholesale.
+ * Apps that need the table to coexist with non-table query params should
+ * write their own `computed` instead — that pattern is small and keeps the
+ * library's contract crisp.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useRoute, useRouter } from 'vue-router';
+ * import { useTableUrlQuery } from '@atscript/vue-table';
+ * const urlQuery = useTableUrlQuery(useRoute(), useRouter());
+ * </script>
+ * <template>
+ *   <AsTableRoot v-model:url-query="urlQuery" url="/db/products" .../>
+ * </template>
+ * ```
+ */
+declare function useTableUrlQuery(route: RouteLocationNormalizedLoaded, router: Router, opts?: UseTableUrlQueryOptions): WritableComputedRef<string>;
+//#endregion
+//#region src/composables/as-presets-app.d.ts
+/**
+ * App-wide injection key for the presets system. The host app calls
+ * `app.provide(AS_PRESETS_APP, '<your-app>')` once at boot; every
+ * `<AsTableRoot>`, `usePresets`, and `useAppPrefs` call below it pulls the
+ * value via `inject(AS_PRESETS_APP)` unless an explicit `app` option
+ * overrides it.
+ *
+ * The string identifies the application namespace on the server side —
+ * one Moost backend can serve many apps; rows are scoped by `(app,
+ * tableKey)`.
+ */
+declare const AS_PRESETS_APP: InjectionKey<string>;
+/**
+ * Resolve the app name with these precedence rules:
+ *
+ * 1. `explicit` argument (composable option) — wins.
+ * 2. `inject(AS_PRESETS_APP)` from the Vue tree.
+ * 3. Throws — composable can't run without an app namespace.
+ *
+ * Throws a clear error when neither is available so misconfiguration
+ * surfaces at setup time, not when the first network round-trip fails.
+ */
+declare function injectPresetsApp(explicit?: string): string;
+//#endregion
+//#region src/composables/use-app-prefs.d.ts
+interface UseAppPrefsOptions {
+  /** App namespace; defaults to `inject(AS_PRESETS_APP)`. */
+  app?: string;
+  /** Presets controller URL, e.g. `"/db/_presets"`. */
+  url: string;
+  /** Custom client factory (auth-configured). Defaults to `getDefaultClientFactory()`. */
+  clientFactory?: ClientFactory;
+  /** Auto-load on setup. Default `true`. */
+  autoLoad?: boolean;
+  /**
+   * Cache the most recent prefs in `localStorage` keyed by app, so the
+   * next mount paints from cache (no flash of defaults while the network
+   * settles) and a failed/denied load still surfaces a usable theme.
+   * Server responses always overwrite the cache, so when a different
+   * user signs in, their state replaces the previous user's after one
+   * round-trip. Default `true` — pass `false` to opt out (e.g. tests,
+   * sensitive environments).
+   */
+  cache?: boolean;
+}
+interface UseAppPrefsReturn {
+  /**
+   * Reactive prefs object. Always non-null — defaults to `{}` until the
+   * first load resolves. Read-only at the surface; mutate via `save()`.
+   */
+  prefs: WritableComputedRef<AppConfData>;
+  loading: Ref<boolean>;
+  /** Last non-auth error, or `null`. Auth errors flip `available` instead. */
+  error: Ref<unknown>;
+  /** False on 401/403 from initial load; UI should hide pref-bound controls. */
+  available: ComputedRef<boolean>;
+  reload(): Promise<void>;
+  /**
+   * Optimistic shallow-merge save. The local `prefs` is updated immediately
+   * for snappy UI; on server error the optimistic write is rolled back and
+   * the error is re-thrown for the caller to surface.
+   */
+  save(patch: Partial<AppConfData>): Promise<void>;
+  /** Drop in-memory state. Useful from sign-out flows. */
+  reset(): void;
+}
+/**
+ * Public dev-facing composable for app-wide user preferences. Independent
+ * of presets / tables — devs can use it on any settings surface to read
+ * and write `appearance`, `language`, `density`, `customJson` etc. for
+ * `(currentUser, app)`.
+ *
+ * Multiple calls with the same `(app, url)` share one underlying instance,
+ * so duplicate widgets (sidebar + page header + /preferences) make a single
+ * `/query?type=appConf` request total.
+ *
+ * @example
+ * ```ts
+ * const { prefs, save } = useAppPrefs({ url: "/db/_presets" })
+ * // prefs.value.appearance is reactive in templates
+ * await save({ appearance: "dark" })
+ * ```
+ */
+declare function useAppPrefs(opts: UseAppPrefsOptions): UseAppPrefsReturn;
+//#endregion
+//#region src/composables/use-table-component.d.ts
+/** Resolve a single skin-slot component from the injected `controls` map, falling back to the default. */
+declare function useTableComponent<K extends keyof TAsTableControls>(key: K, fallback: Component$1): Component$1;
+//#endregion
+//#region src/composables/create-default-controls.d.ts
+/**
+ * Returns a fresh skin-slot map pre-filled with all built-in defaults.
+ *
+ * Spread or assign additional entries to override specific pieces:
+ * ```ts
+ * const controls = { ...createDefaultControls(), filterDialog: MyFilterDialog }
+ * ```
+ *
+ * `actionFormDialog` is intentionally not seeded — the table root
+ * lazy-mounts it only when an `@InputForm` action is detected. To override
+ * or eager-load, import from `@atscript/vue-table/as-action-form-dialog`
+ * and assign it as the `actionFormDialog` entry on this map.
+ */
+declare function createDefaultControls(): TAsTableControls;
+//#endregion
+//#region src/composables/create-default-cell-types.d.ts
+/**
+ * Returns a fresh cell-type-to-component map pre-filled with the built-in
+ * defaults. Spread to extend or override:
+ * ```ts
+ * const types = { ...createDefaultCellTypes(), status: StatusBadgeCell }
+ * ```
+ */
+declare function createDefaultCellTypes(): TAsCellTypeComponents;
+//#endregion
+//#region src/composables/use-cell-locale.d.ts
+interface CellLocale {
+  language?: string;
+  timezone?: string;
+}
+declare function provideCellLocale(source: MaybeRefOrGetter<CellLocale | undefined>): void;
+declare function useCellLocale(): {
+  locale: ComputedRef<string>;
+  timezone: ComputedRef<string | undefined>;
+};
+//#endregion
+//#region src/utils/column-width.d.ts
+/** Returns column width from annotation or type-based default. */
+declare function getColumnWidth(column: ColumnDef): string;
+//#endregion
+//#region src/utils/get-cell-value.d.ts
+/** Gets a nested value from a row by dot-separated path. */
+declare function getCellValue(row: Record<string, unknown>, path: string): unknown;
+//#endregion
+//#region src/utils/format-cell.d.ts
+/** Format a cell value based on column type. */
+declare function formatCellValue(value: unknown, type: string): string;
+//#endregion
+//#region src/composables/state/intent-scope.d.ts
+/**
+ * Build the identifier object to forward to `client.action` / `client.remove`.
+ *
+ * Per `@atscript/db-client` invariant #11, identifier bodies are object-only
+ * — never bare scalars, even for single-field PK tables. This helper accepts:
+ * - a row-shaped object (default `rowValueFn`) → picks `preferredId` fields;
+ * - a scalar value when `preferredId` has exactly one field (consumers that
+ *   override `rowValueFn` to return the PK scalar) → wraps it.
+ *
+ * Returns `undefined` when no `preferredId` is declared, the source is
+ * `null`/`undefined`, or a scalar can't be paired with a single-field
+ * identifier.
+ */
+declare function extractIdentifier(source: unknown, preferredId: readonly string[]): Record<string, unknown> | undefined;
+//#endregion
+//#region src/components/as-table-root.vue.d.ts
+type __VLS_Props = {
+  /** Table endpoint URL (e.g. "/db/tables/products"). */url: string; /** Factory to create a client from a URL. Falls back to the app-wide default set via `setDefaultClientFactory` (or the built-in `new Client(url)` factory if unset). */
+  clientFactory?: ClientFactory; /** Skin-slot overrides for table chrome — header cells, filter dialog, column menu, etc. Use {@link createDefaultControls} to seed defaults. */
+  controls?: TAsTableControls; /** Cell-type → component dispatch map. Use {@link createDefaultCellTypes} to seed defaults. */
+  types?: TAsCellTypeComponents; /** Named cell-component overrides — looked up by `@ui.table.component "name"`. */
+  components?: Record<string, Component$1>;
+  /**
+   * Form-type → component dispatch map for the built-in action-form dialog.
+   * Defaults to `createDefaultTypes()` from `@atscript/vue-form`.
+   */
+  formTypes?: TAsTypeComponents; /** Named form-component overrides for the action-form dialog. */
+  formComponents?: Record<string, Component$1>;
+  limit?: number;
+  forceFilters?: FilterExpr;
+  forceSorters?: SortControl[];
+  queryOnMount?: boolean;
+  queryFn?: (query: Uniquery, page: number, size: number) => Promise<PageResult<Record<string, unknown>>>;
+  blockQuery?: boolean;
+  rowValueFn?: (row: Record<string, unknown>) => unknown;
+  /**
+   * Selection write policy applied on every results-replacement.
+   * - `"clear"` — drop everything.
+   * - `"trim"` (default) — keep PKs that survive the new result set.
+   * - `"persist"` — never write to `selectedRows`; full consumer ownership.
+   */
+  selectionPersistence?: SelectionPersistence; /** Page-alignment unit for `loadRange` and `queryNext` extension. */
+  blockSize?: number; /** Debounce window for the topIndex/viewportRowCount watcher. */
+  dragReleaseDebounceMs?: number;
+  /**
+   * Refetch policy: when `true` (default), successful `'backend'` /
+   * `'__remove'` invocations call `state.query()` after settling. Per-call
+   * `state.actions.invoke(action, pk, { suppressRefresh: true })` overrides.
+   */
+  refreshOnAction?: boolean;
+  /**
+   * Per-aspect opt-in/out for `v-model:url-query`. Default (omitted): full
+   * sync — filters, sorters, `searchTerm`, and pagination all round-trip.
+   * Set fields to `false`/`true`/`string[]` to gate. Has no effect unless
+   * `v-model:url-query` is bound.
+   *
+   * @example
+   * `:url-query-sync="{ pagination: false }"` — shareable filtered view,
+   *   recipients aren't pinned to your current page.
+   * `:url-query-sync="{ filters: ['status'], sorters: false }"` — only
+   *   `status` filter participates; sorters stay private.
+   */
+  urlQuerySync?: UrlQuerySync; /** See {@link PresetConfig}. Omit to disable presets. */
+  preset?: PresetConfig;
+};
+type __VLS_ModelProps = {
+  "filterFields"?: string[];
+  "columnNames"?: string[];
+  "columnWidths"?: ColumnWidthsMap;
+  "sorters"?: SortControl[];
+  "selectedRows"?: unknown[];
+  /**
+   * Bidirectional URL bridge bound via `v-model:url-query`. When unbound the
+   * feature is off (zero overhead); when bound the first query is gated on
+   * tableDef settle + URL hydration so the table fetches once.
+   */
+  "urlQuery"?: string | undefined;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare var __VLS_1: {
+  tableDef: _atscript_ui0.TableDef | null;
+  loadingMetadata: boolean;
+  allColumns: _atscript_ui0.ColumnDef[];
+  columnNames: string[];
+  columnWidths: ColumnWidthsMap;
+  columns: _atscript_ui0.ColumnDef[];
+  filterFields: string[];
+  filters: _atscript_ui_table0.FieldFilters;
+  sorters: SortControl[];
+  results: Record<string, unknown>[];
+  querying: boolean;
+  queryingNext: boolean;
+  totalCount: number;
+  loadedCount: number;
+  pagination: _atscript_ui0.PaginationControl;
+  queryError: Error | null;
+  metadataError: Error | null;
+  mustRefresh: boolean;
+  searchTerm: string;
+  selectedRows: unknown[];
+  selectedCount: number;
+  navBridge: TableNavBridge;
+  query: () => void;
+  queryNext: () => void;
+  resetFilters: () => void;
+  showConfigDialog: (tab?: _atscript_ui_table0.ConfigTab) => void;
+  openFilterDialog: (column: _atscript_ui0.ColumnDef) => void;
+  closeFilterDialog: () => void;
+  setFieldFilter: (path: string, conditions: _atscript_ui_table0.FilterCondition[]) => void;
+  removeFieldFilter: (path: string) => void;
+  addFilterField: (path: string) => void;
+  removeFilterField: (path: string) => void;
+  actions: TableActionsState;
+  prompt: (message: string, opts?: ConfirmOptions) => Promise<boolean>;
+};
+type __VLS_Slots = {} & {
+  default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: vue.DefineComponent<__VLS_PublicProps, {
+  state: ReactiveTableState;
+  navBridge: TableNavBridge;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+  "update:filterFields": (value: string[]) => any;
+  "update:columnNames": (value: string[]) => any;
+  "update:columnWidths": (value: ColumnWidthsMap) => any;
+  "update:sorters": (value: SortControl[]) => any;
+  "update:selectedRows": (value: unknown[]) => any;
+  "update:urlQuery": (value: string | undefined) => any;
+} & {
+  action: (action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: KeyboardEvent | MouseEvent | undefined) => any;
+  "main-action": (row: Record<string, unknown>, absIndex: number, event: KeyboardEvent | MouseEvent) => any;
+}, string, vue.PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+  onAction?: ((action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: KeyboardEvent | MouseEvent | undefined) => any) | undefined;
+  "onMain-action"?: ((row: Record<string, unknown>, absIndex: number, event: KeyboardEvent | MouseEvent) => any) | undefined;
+  "onUpdate:filterFields"?: ((value: string[]) => any) | undefined;
+  "onUpdate:columnNames"?: ((value: string[]) => any) | undefined;
+  "onUpdate:columnWidths"?: ((value: ColumnWidthsMap) => any) | undefined;
+  "onUpdate:sorters"?: ((value: SortControl[]) => any) | undefined;
+  "onUpdate:selectedRows"?: ((value: unknown[]) => any) | undefined;
+  "onUpdate:urlQuery"?: ((value: string | undefined) => any) | undefined;
+}>, {
+  queryOnMount: boolean;
+  selectionPersistence: SelectionPersistence;
+  refreshOnAction: boolean;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+export { createTableState as $, createDefaultControls as A, useTableSearch as B, formatCellValue as C, provideCellLocale as D, CellLocale as E, AS_PRESETS_APP as F, useTable as G, useTableNavBridge as H, injectPresetsApp as I, CreateStaticTableStateOptions as J, SelectionPersistence as K, UseTableUrlQueryOptions as L, UseAppPrefsOptions as M, UseAppPrefsReturn as N, useCellLocale as O, useAppPrefs as P, createStaticTableState as Q, useTableUrlQuery as R, extractIdentifier as S, getColumnWidth as T, UseTableOptions as U, useTableFilter as V, clearTableCache as W, TableContext as X, CreateTableStateOptions as Y, TableStateInternals as Z, getDefaultClientFactory as _, PRESET_ASPECTS as a, usePresets as at, resolveSystemPresets as b, PresetData as c, UseLocalDraftReturn as ct, STANDARD_PRESET_ID as d, useTableContext as et, SYSTEM_PRESET_PREFIX as f, UserConfData as g, UrlQuerySync$1 as h, ClientFactory$1 as i, UsePresetsReturn as it, useTableComponent as j, createDefaultCellTypes as k, PresetSnapshot$1 as l, useLocalDraft as lt, SystemPresetInput$1 as m, AppConfData$1 as n, ActivePresetView as nt, PresetAspect$1 as o, StorageLike as ot, SystemPreset$1 as p, useTableSelection as q, AsPresetEntryRow$1 as r, UsePresetsOptions as rt, PresetCapabilities$1 as s, UseLocalDraftOptions as st, _default as t, useTableContextOptional as tt, PresetSnapshotWire as u, isSystemPresetId as v, getCellValue as w, setDefaultClientFactory as x, resetDefaultClientFactory as y, useTableActions as z };