@atscript/vue-table 0.1.133 → 0.1.134

package/dist/{as-table-root-Bpsrp0Vz.mjs → as-table-root-C1A6JkwL.mjs}

@@ -1,9 +1,28 @@
-import { i as useRegisterMainActionListener } from "./use-table-state-DLJbW753.mjs";
-import { n as useTable } from "./use-table-Bk-jSxOM.mjs";
-import { t as useTableNavBridge } from "./use-table-nav-bridge-B9SSEajW.mjs";
-import { t as useHasEmitListener } from "./use-has-emit-listener-BTMDIv2e.mjs";
-import { t as as_confirm_dialog_default } from "./as-confirm-dialog-BV01t7dn.mjs";
+import { i as useRegisterMainActionListener, t as createStaticTableState } from "./use-table-state-mBXx11aH.mjs";
+import { n as finalizeTableState, r as useTable } from "./use-table-BFhbfWgY.mjs";
+import { t as useTableNavBridge } from "./use-table-nav-bridge-DzJN5v9a.mjs";
+import { t as useHasEmitListener } from "./use-has-emit-listener-DrBbsLHQ.mjs";
+import { t as as_confirm_dialog_default } from "./as-confirm-dialog-G4ZoL_Xo.mjs";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, defineAsyncComponent, defineComponent, mergeModels, openBlock, ref, renderSlot, resolveDynamicComponent, unref, useModel, watch } from "vue";
+//#region src/utils/dev.ts
+/**
+* `true` outside a production build — the gate for authoring-time warnings, so
+* their strings and checks cost a shipped app nothing.
+*
+* Read from `process.env.NODE_ENV` rather than `import.meta.env`: bundlers
+* replace this expression with a literal in both the ESM and the CJS output,
+* while `import.meta` only exists in the former. Where neither a bundler nor a
+* `process` shim is present the read throws — warnings stay on, which is the
+* safe side of the trade.
+*/
+function detectDev() {
+	try {
+		return process.env.NODE_ENV !== "production";
+	} catch {
+		return true;
+	}
+}
+const DEV = detectDev();
 //#endregion
 //#region src/components/as-table-root.vue
 var as_table_root_default = /* @__PURE__ */ defineComponent({
@@ -11,7 +30,32 @@ var as_table_root_default = /* @__PURE__ */ defineComponent({
 	props: /* @__PURE__ */ mergeModels({
 		url: {
 			type: String,
-			required: true
+			required: false
+		},
+		rows: {
+			type: Array,
+			required: false
+		},
+		columns: {
+			type: Array,
+			required: false
+		},
+		searchPaths: {
+			type: Array,
+			required: false
+		},
+		localSort: {
+			type: Boolean,
+			required: false,
+			default: true
+		},
+		displayColumns: {
+			type: Array,
+			required: false
+		},
+		rowActions: {
+			type: Object,
+			required: false
 		},
 		clientFactory: {
 			type: Function,
@@ -174,7 +218,61 @@ var as_table_root_default = /* @__PURE__ */ defineComponent({
 		const urlQuery = useModel(__props, "urlQuery");
 		const urlQueryActive = useHasEmitListener("onUpdate:urlQuery").value;
 		const urlQueryReady = ref(!urlQueryActive);
-		const state = useTable(props.url, {
+		/**
+		* Local mode is decided once, at setup: `:rows` present means "render this
+		* array", which is a different state factory (no client, no metadata fetch).
+		* It cannot flip at runtime — a table that changes data source re-mounts.
+		*/
+		const localMode = props.rows !== void 0;
+		if (!localMode && !props.url) throw new Error("[vue-table] <AsTableRoot> requires either :url or :rows (local mode).");
+		/**
+		* Build the local-mode state: a `createStaticTableState` over the `:rows`
+		* array, provided to the subtree exactly like the fetching path so cells,
+		* keyboard nav, header slots, selection and the config dialog all work.
+		* Features that need a client are inert here and warned about once.
+		*/
+		function createLocalState() {
+			if (DEV) {
+				if (props.url) console.warn("[vue-table] <AsTableRoot>: :rows is set, so :url is ignored (local mode).");
+				if (props.preset) console.warn("[vue-table] <AsTableRoot>: presets need a server and are off in local mode.");
+				if (urlQueryActive) console.warn("[vue-table] <AsTableRoot>: v-model:urlQuery is not wired in local mode.");
+				if (props.queryFn) console.warn("[vue-table] <AsTableRoot>: :queryFn is ignored in local mode.");
+			}
+			const { state: localState } = createStaticTableState({
+				rows: () => props.rows ?? [],
+				columns: props.columns ?? [],
+				searchPaths: props.searchPaths,
+				localSort: props.localSort,
+				displayColumns: props.displayColumns,
+				limit: props.limit,
+				queryOnMount: props.queryOnMount,
+				selection: {
+					rowValueFn: props.rowValueFn,
+					selectedRows
+				},
+				model: {
+					filterFields,
+					columnNames,
+					columnWidths,
+					sorters
+				},
+				actions: {
+					resolveHref: props.resolveHref,
+					onResolved: (action, ids, result, event) => emit("action", action, ids, result, event)
+				}
+			});
+			finalizeTableState(localState, {}, {
+				selectionPersistence: props.selectionPersistence,
+				controls: props.controls,
+				types: props.types,
+				components: props.components,
+				formTypes: props.formTypes,
+				formComponents: props.formComponents
+			});
+			watch(() => props.rows, () => localState.query({ silent: true }));
+			return localState;
+		}
+		const state = localMode ? createLocalState() : useTable(props.url, {
 			limit: props.limit,
 			rowValueFn: props.rowValueFn,
 			selectionPersistence: props.selectionPersistence,
@@ -206,9 +304,13 @@ var as_table_root_default = /* @__PURE__ */ defineComponent({
 			urlQueryReady: urlQueryActive ? urlQueryReady : void 0,
 			onUrlQueryChange: urlQueryActive ? (s) => urlQuery.value = s : void 0,
 			urlQuerySync: props.urlQuerySync,
-			preset: props.preset
+			preset: props.preset,
+			displayColumns: props.displayColumns
 		});
-		if (urlQueryActive) watch([
+		watch(() => props.rowActions, (value) => {
+			state.rowActions.value = value;
+		}, { immediate: true });
+		if (urlQueryActive && !localMode) watch([
 			() => state.tableDef.value,
 			() => urlQuery.value,
 			() => state.preset.ready.value

package/dist/{as-table-root-CUDO9ybm.cjs → as-table-root-DlYjnZax.cjs}

@@ -1,9 +1,28 @@
-const require_use_table_state = require("./use-table-state-D6dHOFrA.cjs");
-const require_use_table = require("./use-table-CdFFqaEx.cjs");
-const require_use_table_nav_bridge = require("./use-table-nav-bridge-CVUmTjDr.cjs");
-const require_use_has_emit_listener = require("./use-has-emit-listener-hhOH8CBI.cjs");
-const require_as_confirm_dialog = require("./as-confirm-dialog-Cw7KErhz.cjs");
+const require_use_table_state = require("./use-table-state-mhm-YWnu.cjs");
+const require_use_table = require("./use-table-nvuZdgUd.cjs");
+const require_use_table_nav_bridge = require("./use-table-nav-bridge-DS14D_rG.cjs");
+const require_use_has_emit_listener = require("./use-has-emit-listener-BaGFZDyM.cjs");
+const require_as_confirm_dialog = require("./as-confirm-dialog-ByMfIG0A.cjs");
 let vue = require("vue");
+//#region src/utils/dev.ts
+/**
+* `true` outside a production build — the gate for authoring-time warnings, so
+* their strings and checks cost a shipped app nothing.
+*
+* Read from `process.env.NODE_ENV` rather than `import.meta.env`: bundlers
+* replace this expression with a literal in both the ESM and the CJS output,
+* while `import.meta` only exists in the former. Where neither a bundler nor a
+* `process` shim is present the read throws — warnings stay on, which is the
+* safe side of the trade.
+*/
+function detectDev() {
+	try {
+		return process.env.NODE_ENV !== "production";
+	} catch {
+		return true;
+	}
+}
+const DEV = detectDev();
 //#endregion
 //#region src/components/as-table-root.vue
 var as_table_root_default = /* @__PURE__ */ (0, vue.defineComponent)({
@@ -11,7 +30,32 @@ var as_table_root_default = /* @__PURE__ */ (0, vue.defineComponent)({
 	props: /* @__PURE__ */ (0, vue.mergeModels)({
 		url: {
 			type: String,
-			required: true
+			required: false
+		},
+		rows: {
+			type: Array,
+			required: false
+		},
+		columns: {
+			type: Array,
+			required: false
+		},
+		searchPaths: {
+			type: Array,
+			required: false
+		},
+		localSort: {
+			type: Boolean,
+			required: false,
+			default: true
+		},
+		displayColumns: {
+			type: Array,
+			required: false
+		},
+		rowActions: {
+			type: Object,
+			required: false
 		},
 		clientFactory: {
 			type: Function,
@@ -174,7 +218,61 @@ var as_table_root_default = /* @__PURE__ */ (0, vue.defineComponent)({
 		const urlQuery = (0, vue.useModel)(__props, "urlQuery");
 		const urlQueryActive = require_use_has_emit_listener.useHasEmitListener("onUpdate:urlQuery").value;
 		const urlQueryReady = (0, vue.ref)(!urlQueryActive);
-		const state = require_use_table.useTable(props.url, {
+		/**
+		* Local mode is decided once, at setup: `:rows` present means "render this
+		* array", which is a different state factory (no client, no metadata fetch).
+		* It cannot flip at runtime — a table that changes data source re-mounts.
+		*/
+		const localMode = props.rows !== void 0;
+		if (!localMode && !props.url) throw new Error("[vue-table] <AsTableRoot> requires either :url or :rows (local mode).");
+		/**
+		* Build the local-mode state: a `createStaticTableState` over the `:rows`
+		* array, provided to the subtree exactly like the fetching path so cells,
+		* keyboard nav, header slots, selection and the config dialog all work.
+		* Features that need a client are inert here and warned about once.
+		*/
+		function createLocalState() {
+			if (DEV) {
+				if (props.url) console.warn("[vue-table] <AsTableRoot>: :rows is set, so :url is ignored (local mode).");
+				if (props.preset) console.warn("[vue-table] <AsTableRoot>: presets need a server and are off in local mode.");
+				if (urlQueryActive) console.warn("[vue-table] <AsTableRoot>: v-model:urlQuery is not wired in local mode.");
+				if (props.queryFn) console.warn("[vue-table] <AsTableRoot>: :queryFn is ignored in local mode.");
+			}
+			const { state: localState } = require_use_table_state.createStaticTableState({
+				rows: () => props.rows ?? [],
+				columns: props.columns ?? [],
+				searchPaths: props.searchPaths,
+				localSort: props.localSort,
+				displayColumns: props.displayColumns,
+				limit: props.limit,
+				queryOnMount: props.queryOnMount,
+				selection: {
+					rowValueFn: props.rowValueFn,
+					selectedRows
+				},
+				model: {
+					filterFields,
+					columnNames,
+					columnWidths,
+					sorters
+				},
+				actions: {
+					resolveHref: props.resolveHref,
+					onResolved: (action, ids, result, event) => emit("action", action, ids, result, event)
+				}
+			});
+			require_use_table.finalizeTableState(localState, {}, {
+				selectionPersistence: props.selectionPersistence,
+				controls: props.controls,
+				types: props.types,
+				components: props.components,
+				formTypes: props.formTypes,
+				formComponents: props.formComponents
+			});
+			(0, vue.watch)(() => props.rows, () => localState.query({ silent: true }));
+			return localState;
+		}
+		const state = localMode ? createLocalState() : require_use_table.useTable(props.url, {
 			limit: props.limit,
 			rowValueFn: props.rowValueFn,
 			selectionPersistence: props.selectionPersistence,
@@ -206,9 +304,13 @@ var as_table_root_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			urlQueryReady: urlQueryActive ? urlQueryReady : void 0,
 			onUrlQueryChange: urlQueryActive ? (s) => urlQuery.value = s : void 0,
 			urlQuerySync: props.urlQuerySync,
-			preset: props.preset
+			preset: props.preset,
+			displayColumns: props.displayColumns
 		});
-		if (urlQueryActive) (0, vue.watch)([
+		(0, vue.watch)(() => props.rowActions, (value) => {
+			state.rowActions.value = value;
+		}, { immediate: true });
+		if (urlQueryActive && !localMode) (0, vue.watch)([
 			() => state.tableDef.value,
 			() => urlQuery.value,
 			() => state.preset.ready.value

package/dist/as-table-root.cjs

@@ -1,2 +1,2 @@
-const require_as_table_root = require("./as-table-root-CUDO9ybm.cjs");
+const require_as_table_root = require("./as-table-root-DlYjnZax.cjs");
 module.exports = require_as_table_root.as_table_root_default;

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

@@ -1,2 +1,2 @@
-import { t as _default } from "./as-table-root.vue-szvjZsCn.cjs";
+import { t as _default } from "./as-table-root.vue-D94eypcL.cjs";
 export = _default;

package/dist/as-table-root.d.mts

@@ -1,2 +1,2 @@
-import { t as _default } from "./as-table-root.vue-BPU92_Ns.mjs";
+import { t as _default } from "./as-table-root.vue-CWk9YgpG.mjs";
 export { _default as default };

package/dist/as-table-root.mjs

@@ -1,2 +1,2 @@
-import { t as as_table_root_default } from "./as-table-root-Bpsrp0Vz.mjs";
+import { t as as_table_root_default } from "./as-table-root-C1A6JkwL.mjs";
 export { as_table_root_default as default };

package/dist/{as-table-root.vue-szvjZsCn.d.cts → as-table-root.vue-CWk9YgpG.d.mts}

@@ -1,11 +1,11 @@
-import { S as TableNavBridge, b as TVueTableActionInfo, c as NavKeyOptions, d as ReactiveTableState, i as ConfirmOptions, l as PresetConfig, t as ActionResult, v as TAsCellTypeComponents, x as TableActionsState, y as TAsTableControls } from "./types-BZ0HssRY.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 { C as TableActionsState, S as TVueTableActionInfo, b as TAsCellTypeComponents, f as ReactiveTableState, i as ConfirmOptions, l as NavKeyOptions, p as RowActionsConfig, t as ActionResult, u as PresetConfig, w as TableNavBridge, x as TAsTableControls } from "./types-CBGaTR2Z.mjs";
 import * as _atscript_ui0 from "@atscript/ui";
 import { ClientFactory, ClientFactory as ClientFactory$1, ColumnDef, SortControl, TableDef, getDefaultClientFactory, resetDefaultClientFactory, setDefaultClientFactory } from "@atscript/ui";
+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 * 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, QueryOptions, 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 { AppConfData, AppConfData as AppConfData$1, AsPresetEntryRow, AsPresetEntryRow as AsPresetEntryRow$1, ColumnWidthsMap, CsvOptions, CsvOptions as CsvOptions$1, DisplayColumnDef, DisplayColumnDef as DisplayColumnDef$1, ExportAbortError, ExportScalar, ExportScalar as ExportScalar$1, FilterCondition, PRESET_ASPECTS, PresetAspect, PresetAspect as PresetAspect$1, PresetCapabilities, PresetCapabilities as PresetCapabilities$1, PresetData, PresetDraft, PresetSnapshot, PresetSnapshot as PresetSnapshot$1, PresetSnapshotWire, QueryOptions, STANDARD_PRESET_ID as STANDARD_PRESET_ID$1, SYSTEM_PRESET_PREFIX, SelectionMode, SystemPreset, SystemPreset as SystemPreset$1, SystemPresetInput, SystemPresetInput as SystemPresetInput$1, UrlQuerySync, UrlQuerySync as UrlQuerySync$1, UserConfData, isSystemPresetId as isSystemPresetId$1, resolveSystemPresets as resolveSystemPresets$1 } from "@atscript/ui-table";
+import { Client, PageResult } from "@atscript/db-client";
 import { TAsTypeComponents } from "@atscript/vue-form";
 import { FilterExpr, Uniquery } from "@uniqu/core";
 
@@ -200,6 +200,16 @@ interface TableContext {
   formComponents?: Record<string, Component$1>;
 }
 type QueryFn = (query: Uniquery, page: number, size: number) => Promise<PageResult<Record<string, unknown>>>;
+/** Per-call overrides for `state.buildQuery()`. Since 0.1.134. */
+interface BuildQueryOptions {
+  /**
+   * Column paths to project instead of the visible ones. Client-owned
+   * (`local`) columns are dropped from the result either way.
+   */
+  columnPaths?: string[];
+  /** Override the `$actions` opt-in (default: whatever the renderer asked for). */
+  includeActions?: boolean;
+}
 /** External refs the consumer wires up via `defineModel` (or otherwise). */
 interface TableModelRefs {
   filterFields?: Ref<string[]>;
@@ -243,6 +253,12 @@ interface TableQueryOptions {
   ignoreSortersWhenSearched?: boolean;
   /** Auto-query when metadata loads (default: true). */
   queryOnMount?: boolean;
+  /**
+   * The query function already returns its rows ordered by every active
+   * sorter, so `applyLocalSort` must not re-order the page on top of it. Set
+   * by the in-memory (`createStaticTableState`) path. Since 0.1.134.
+   */
+  preSorted?: boolean;
   /**
    * Gate the initial `scheduleQuery("initial")` until this ref flips to
    * `true`. Used by `<AsTableRoot>` when `v-model:urlQuery` is bound, to
@@ -317,6 +333,11 @@ interface CreateTableStateOptions {
   actions?: TableActionsOptions;
   /** Preset settings. */
   preset?: TablePresetOptions;
+  /**
+   * Client-owned columns merged into the server's column list. Captured once
+   * at setup — to change the set, re-mount. Since 0.1.134.
+   */
+  displayColumns?: readonly DisplayColumnDef[];
 }
 /** Internal handles returned alongside the public state. */
 interface TableStateInternals {
@@ -330,8 +351,12 @@ declare function createTableState(opts: CreateTableStateOptions): {
   internals: TableStateInternals;
 };
 interface CreateStaticTableStateOptions {
-  /** All rows in the dataset. Sorting/searching is applied locally. */
-  rows: Record<string, unknown>[];
+  /**
+   * All rows in the dataset. Sorting/searching is applied locally. Pass a
+   * getter (or a ref) to keep it reactive — every local "fetch" re-reads it,
+   * so replacing the array and calling `state.query()` re-renders the table.
+   */
+  rows: MaybeRefOrGetter<Record<string, unknown>[]>;
   /** Columns to render. Used to synthesize a minimal `TableDef`. */
   columns: ColumnDef[];
   /** Field paths matched (substring, case-insensitive) by `searchTerm`. */
@@ -340,6 +365,23 @@ interface CreateStaticTableStateOptions {
   selection?: TableSelectionOptions;
   /** Default page size (`pagination.itemsPerPage`). */
   limit?: number;
+  /**
+   * Sort `rows` in memory from the active sorters (default `true`). Set
+   * `false` when `rows` already arrives in the order it should render and the
+   * header's sort affordance is purely cosmetic. Since 0.1.134.
+   */
+  localSort?: boolean;
+  /** Client-owned columns merged into `columns`. Since 0.1.134. */
+  displayColumns?: readonly DisplayColumnDef[];
+  /** External refs from `defineModel` — same contract as `createTableState`. Since 0.1.134. */
+  model?: TableModelRefs;
+  /** Auto-query once the synthetic definition is in place (default: true). Since 0.1.134. */
+  queryOnMount?: boolean;
+  /**
+   * Action settings. Only the client-free parts apply — there is no client to
+   * invoke a server action with. Since 0.1.134.
+   */
+  actions?: TableActionsOptions;
 }
 /**
  * Build a `ReactiveTableState` backed by an in-memory row list. Used by the
@@ -350,6 +392,8 @@ declare function createStaticTableState(opts: CreateStaticTableStateOptions): {
   state: ReactiveTableState;
   internals: TableStateInternals;
 };
+/** Provide the full table context to the component subtree. */
+declare function provideTableContext(ctx: TableContext): void;
 /** Inject the full table context (throws if used outside as-table-root). */
 declare function useTableContext(): TableContext;
 /**
@@ -505,6 +549,11 @@ interface UseTableOptions {
    * `url` and `tableKey` are required.
    */
   preset?: PresetConfig;
+  /**
+   * Client-owned columns merged into the server's column list — see
+   * {@link DisplayColumnDef}. Captured once at setup. Since 0.1.134.
+   */
+  displayColumns?: readonly DisplayColumnDef[];
 }
 /**
  * Main entry composable for table setup.
@@ -513,6 +562,106 @@ interface UseTableOptions {
  */
 declare function useTable(url: string, opts?: UseTableOptions): ReactiveTableState;
 //#endregion
+//#region src/composables/use-table-export.d.ts
+/** Per-cell formatter override. Return `undefined` to fall back to the default. */
+type ExportCellFormatter = (value: unknown, column: ColumnDef, row: Record<string, unknown>) => ExportScalar | undefined;
+interface ExportRowsOptions {
+  /**
+   * `'visible'` (default) exports the visible columns in their current display
+   * order, minus the client-owned ([display](/tables/customization)) ones —
+   * nothing on the server backs them, so they would export as an empty column
+   * unless a `formatters` entry fills them in. An array of column paths
+   * exports exactly those, in that order, display columns included.
+   */
+  columns?: "visible" | string[];
+  /** `'csv'` (default) renders a CSV string; `'rows'` returns scalar arrays. */
+  format?: "csv" | "rows";
+  /** Rows per request while paging. Default 500. */
+  pageSize?: number;
+  /** Stop the run between pages; the promise rejects with an `AbortError`. */
+  signal?: AbortSignal;
+  /** Called after each settled page. `total` is the first page's `count`, when the endpoint reports one. */
+  onProgress?: (done: number, total?: number) => void;
+  /** Global cell formatter, applied to every column that has no `formatters` entry. */
+  formatCell?: ExportCellFormatter;
+  /** Per-column formatters keyed by column path. Win over `formatCell`. */
+  formatters?: Record<string, ExportCellFormatter>;
+  /** File name for `format: 'csv'`. `.csv` is appended when missing. Default `"export.csv"`. */
+  filename?: string;
+  /**
+   * CSV writer settings — `bom`, `escapeFormulas`, `delimiter`. Ignored by
+   * `format: 'rows'`.
+   */
+  csv?: CsvOptions;
+  /** Hard ceiling on exported rows. */
+  maxRows?: number;
+}
+interface ExportResultBase {
+  /** Header labels, in export order. */
+  columns: string[];
+  /** Column paths, in export order. */
+  columnPaths: string[];
+  /** How many data rows the run collected. */
+  rowCount: number;
+  /** Total the endpoint reported for the query, when it reported one. */
+  total?: number;
+}
+/** A finished export. `format` discriminates the payload. */
+type ExportResult = (ExportResultBase & {
+  format: "csv";
+  csv: string;
+  filename: string;
+}) | (ExportResultBase & {
+  format: "rows";
+  rows: ExportScalar[][];
+});
+/** Progress of the run in flight: rows collected so far, and the reported total. */
+interface ExportProgress {
+  done: number;
+  total?: number;
+}
+interface UseTableExportReturn {
+  /**
+   * Run an export against the table's CURRENT query. Rejects when a run is
+   * already in flight — one handle runs one export at a time.
+   */
+  exportRows: (opts?: ExportRowsOptions) => Promise<ExportResult>;
+  /** `true` while an `exportRows` call is in flight. */
+  exporting: ComputedRef<boolean>;
+  /** Progress of the in-flight run, or `null` while idle. */
+  progress: Ref<ExportProgress | null>;
+}
+/**
+ * Export the table's data as it is queried right now.
+ *
+ * The export snapshots the table's own query at call time — the same filters,
+ * sorters, search term, force-filters and `$select` projection the on-screen
+ * fetch uses (`state.buildQuery()`), through the same fetch path
+ * (`state.fetchPage()`, so a custom `queryFn` is honoured) — then pages
+ * through every result instead of one page. The primary key(s) are appended
+ * to the sort as a tiebreaker so pages never overlap or skip.
+ *
+ * Values come out of the same column metadata the cells read: union/enum keys
+ * become their labels, dates become ISO strings, arrays join. Override per
+ * column with `formatters`, or globally with `formatCell`.
+ *
+ * ```ts
+ * const { exportRows } = useTableExport()
+ * downloadExport(await exportRows({ filename: "orders.csv", csv: { bom: true } }))
+ * ```
+ *
+ * Since 0.1.134.
+ */
+declare function useTableExport(ctx?: TableContext): UseTableExportReturn;
+/**
+ * Hand a finished CSV export to the browser as a file download. Returns
+ * `false` without doing anything when there is no DOM (SSR / a worker), so a
+ * server render can call it unguarded.
+ *
+ * Since 0.1.134.
+ */
+declare function downloadExport(result: ExportResult): boolean;
+//#endregion
 //#region src/composables/use-table-nav-bridge.d.ts
 interface UseTableNavBridgeOptions extends Omit<NavKeyOptions, "mode"> {
   /**
@@ -2200,25 +2349,48 @@ declare function getCellValue(row: Record<string, unknown>, path: string): unkno
 /** 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). */
+  /**
+   * Table endpoint URL (e.g. "/db/tables/products"). Omit it — and pass
+   * `:rows` + `:columns` instead — to run the table in local mode over an
+   * already-loaded array.
+   */
+  url?: string;
+  /**
+   * Local mode: render these rows instead of fetching. No client, no
+   * `/meta` request and no metadata cache entry. Reactive — replacing the
+   * array re-runs the local query (search / sort / paging stay live).
+   * Requires `:columns`. Since 0.1.134.
+   */
+  rows?: Record<string, unknown>[];
+  /**
+   * Local mode: the columns to render. Read once at setup. Since 0.1.134.
+   */
+  columns?: ColumnDef[];
+  /**
+   * Local mode: field paths the search term matches (substring,
+   * case-insensitive). Omit to disable search. Since 0.1.134.
+   */
+  searchPaths?: string[];
+  /**
+   * Local mode: sort `rows` in memory from the active sorters (default
+   * `true`). Since 0.1.134.
+   */
+  localSort?: boolean;
+  /**
+   * Client-owned columns merged into the server's column list — labelled,
+   * hideable, reorderable and preset-persisted like any column, but never
+   * part of `$select`, server sorting or filters. Since 0.1.134.
+   */
+  displayColumns?: DisplayColumnDef[];
+  /**
+   * Per-screen policy for the row-actions cell: narrow the server's action
+   * set (`include` / `exclude`), relabel it (`overrides`), and append
+   * app-owned actions (`extra`). The server stays authoritative — an action
+   * a row's `$actions` gated away never appears. Since 0.1.134.
+   */
+  rowActions?: RowActionsConfig; /** 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"`. */
@@ -2304,10 +2476,10 @@ type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
 declare var __VLS_1: {
   tableDef: _atscript_ui0.TableDef | null;
   loadingMetadata: boolean;
-  allColumns: _atscript_ui0.ColumnDef[];
+  allColumns: ColumnDef[];
   columnNames: string[];
   columnWidths: ColumnWidthsMap;
-  columns: _atscript_ui0.ColumnDef[];
+  columns: ColumnDef[];
   filterFields: string[];
   filters: _atscript_ui_table0.FieldFilters;
   sorters: SortControl[];
@@ -2329,7 +2501,7 @@ declare var __VLS_1: {
   queryNext: () => void;
   resetFilters: () => void;
   showConfigDialog: (tab?: _atscript_ui_table0.ConfigTab) => void;
-  openFilterDialog: (column: _atscript_ui0.ColumnDef) => void;
+  openFilterDialog: (column: ColumnDef) => void;
   closeFilterDialog: () => void;
   setFieldFilter: (path: string, conditions: _atscript_ui_table0.FilterCondition[]) => void;
   removeFieldFilter: (path: string) => void;
@@ -2353,9 +2525,11 @@ declare const __VLS_base: vue.DefineComponent<__VLS_PublicProps, {
   "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;
+  "main-action": (row: Record<string, unknown>, absIndex: number, event: MouseEvent | KeyboardEvent) => any;
+  action: (action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: MouseEvent | KeyboardEvent | undefined) => any;
 }, string, vue.PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+  "onMain-action"?: ((row: Record<string, unknown>, absIndex: number, event: MouseEvent | KeyboardEvent) => any) | undefined;
+  onAction?: ((action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: MouseEvent | KeyboardEvent | undefined) => any) | undefined;
   "onUpdate:filterFields"?: ((value: string[]) => any) | undefined;
   "onUpdate:columnNames"?: ((value: string[]) => any) | undefined;
   "onUpdate:columnWidths"?: ((value: ColumnWidthsMap) => any) | undefined;
@@ -2363,9 +2537,8 @@ declare const __VLS_base: vue.DefineComponent<__VLS_PublicProps, {
   "onUpdate:ignoreSortersWhenSearched"?: ((value: boolean) => any) | undefined;
   "onUpdate:selectedRows"?: ((value: unknown[]) => any) | undefined;
   "onUpdate:urlQuery"?: ((value: string | undefined) => any) | undefined;
-  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;
 }>, {
+  localSort: boolean;
   queryOnMount: boolean;
   selectionPersistence: SelectionPersistence;
   refreshOnAction: boolean;
@@ -2378,4 +2551,4 @@ type __VLS_WithSlots<T, S> = T & {
   };
 };
 //#endregion
-export { createStaticTableState as $, createDefaultCellTypes as A, useTableActions as B, extractIdentifier as C, CellLocale as D, getColumnWidth as E, useAppPrefs as F, clearTableCache as G, useTableFilter as H, AS_PRESETS_APP as I, useTableSelection as J, useTable as K, injectPresetsApp as L, useTableComponent as M, UseAppPrefsOptions as N, provideCellLocale as O, UseAppPrefsReturn as P, TableStateInternals as Q, UseTableUrlQueryOptions as R, setDefaultClientFactory as S, getCellValue as T, useTableNavBridge as U, useTableSearch as V, UseTableOptions as W, CreateTableStateOptions as X, CreateStaticTableStateOptions as Y, TableContext as Z, UserConfData as _, PRESET_ASPECTS as a, UsePresetsReturn as at, resetDefaultClientFactory as b, PresetData as c, UseLocalDraftOptions as ct, QueryOptions as d, createTableState as et, STANDARD_PRESET_ID as f, UrlQuerySync$1 as g, SystemPresetInput$1 as h, ClientFactory$1 as i, UsePresetsOptions as it, createDefaultControls as j, useCellLocale as k, PresetSnapshot$1 as l, UseLocalDraftReturn as lt, SystemPreset$1 as m, AppConfData$1 as n, useTableContextOptional as nt, PresetAspect$1 as o, usePresets as ot, SYSTEM_PRESET_PREFIX as p, SelectionPersistence as q, AsPresetEntryRow$1 as r, ActivePresetView as rt, PresetCapabilities$1 as s, StorageLike as st, _default as t, useTableContext as tt, PresetSnapshotWire as u, useLocalDraft as ut, getDefaultClientFactory as v, formatCellValue as w, resolveSystemPresets as x, isSystemPresetId as y, useTableUrlQuery as z };
+export { useTableExport as $, CellLocale as A, injectPresetsApp as B, isSystemPresetId$1 as C, UseLocalDraftReturn as Ct, formatCellValue as D, setDefaultClientFactory as E, useTableComponent as F, useTableFilter as G, useTableUrlQuery as H, UseAppPrefsOptions as I, ExportProgress as J, useTableNavBridge as K, UseAppPrefsReturn as L, useCellLocale as M, createDefaultCellTypes as N, getCellValue as O, createDefaultControls as P, downloadExport as Q, useAppPrefs as R, getDefaultClientFactory as S, UseLocalDraftOptions as St, resolveSystemPresets$1 as T, useTableActions as U, UseTableUrlQueryOptions as V, useTableSearch as W, ExportRowsOptions as X, ExportResult as Y, UseTableExportReturn as Z, SYSTEM_PRESET_PREFIX as _, ActivePresetView as _t, CsvOptions$1 as a, BuildQueryOptions as at, UrlQuerySync$1 as b, usePresets as bt, ExportScalar$1 as c, QueryFn as ct, PresetCapabilities$1 as d, TableStateInternals as dt, UseTableOptions as et, PresetData as f, createStaticTableState as ft, STANDARD_PRESET_ID$1 as g, useTableContextOptional as gt, QueryOptions as h, useTableContext as ht, ClientFactory$1 as i, useTableSelection as it, provideCellLocale as j, getColumnWidth as k, PRESET_ASPECTS as l, TableContext as lt, PresetSnapshotWire as m, provideTableContext as mt, AppConfData$1 as n, useTable as nt, DisplayColumnDef$1 as o, CreateStaticTableStateOptions as ot, PresetSnapshot$1 as p, createTableState as pt, ExportCellFormatter as q, AsPresetEntryRow$1 as r, SelectionPersistence as rt, ExportAbortError as s, CreateTableStateOptions as st, _default as t, clearTableCache as tt, PresetAspect$1 as u, TableModelRefs as ut, SystemPreset$1 as v, UsePresetsOptions as vt, resetDefaultClientFactory as w, useLocalDraft as wt, UserConfData as x, StorageLike as xt, SystemPresetInput$1 as y, UsePresetsReturn as yt, AS_PRESETS_APP as z };