@atscript/vue-table 0.1.133 → 0.1.135

package/dist/index.cjs

@@ -1,37 +1,192 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_use_table_state = require("./use-table-state-D6dHOFrA.cjs");
-const require_use_table_selection = require("./use-table-selection-Cmiu1h4S.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_table_component = require("./use-table-component-DlLganVc.cjs");
-const require_get_cell_value = require("./get-cell-value-4rHKP-TG.cjs");
-const require_as_cell_array = require("./as-cell-array-iPeUnk2G.cjs");
-const require_as_cell_date = require("./as-cell-date-DyixWKuS.cjs");
-const require_use_cell_locale = require("./use-cell-locale-BGBRQB7s.cjs");
-const require_as_cell_json = require("./as-cell-json-Bvv2P7YV.cjs");
-const require_as_cell_number = require("./as-cell-number-DuPMOesI.cjs");
-const require_format_cell = require("./format-cell-vCNTh4WZ.cjs");
-const require_as_cell_union = require("./as-cell-union-DJNsEKTi.cjs");
-const require_as_column_menu = require("./as-column-menu-fZVbJ9lU.cjs");
-const require_as_config_dialog = require("./as-config-dialog-Bt8oP8qg.cjs");
-const require_as_confirm_dialog = require("./as-confirm-dialog-Cw7KErhz.cjs");
-const require_as_filter_input = require("./as-filter-input-DJu2k9gO.cjs");
-const require_as_filter_dialog = require("./as-filter-dialog-Bxii-mYH.cjs");
-const require_as_table_header_cell = require("./as-table-header-cell-Bb4ddLmQ.cjs");
-const require_as_window_table = require("./as-window-table-CXq6UuUx.cjs");
-const require_as_filter_field = require("./as-filter-field-xBr6TtKo.cjs");
-const require_as_filters = require("./as-filters-DuCk8nkk.cjs");
-const require_as_preset_dialog = require("./as-preset-dialog-jZeyXJeJ.cjs");
-const require_as_row_actions = require("./as-row-actions-B_OHWIAt.cjs");
-const require_as_table_cell_value = require("./as-table-cell-value-D1JkTQt0.cjs");
-const require_as_table_root = require("./as-table-root-CUDO9ybm.cjs");
-const require_as_table = require("./as-table-BejpMVid.cjs");
-const require_as_table_actions = require("./as-table-actions-qb0gQz2D.cjs");
-const require_as_preset_picker = require("./as-preset-picker-4xXU1KQz.cjs");
+const require_use_table_state = require("./use-table-state-jljSQQ8m.cjs");
+const require_get_cell_value = require("./get-cell-value-CJT4fk4y.cjs");
+const require_use_table_selection = require("./use-table-selection-DtCV3rhu.cjs");
+const require_use_table = require("./use-table-Bm2a0g9D.cjs");
+const require_use_table_nav_bridge = require("./use-table-nav-bridge-qyvyRm6S.cjs");
+const require_use_table_component = require("./use-table-component-Bpy5mg_P.cjs");
+const require_as_table_root = require("./as-table-root-EyN1JHuS.cjs");
+const require_as_cell_array = require("./as-cell-array-D-8Pqlgo.cjs");
+const require_as_cell_date = require("./as-cell-date-DviMJEqs.cjs");
+const require_use_cell_locale = require("./use-cell-locale-caG2Fzpc.cjs");
+const require_as_cell_json = require("./as-cell-json-CaVB6e7V.cjs");
+const require_as_cell_number = require("./as-cell-number-BnYbxOiG.cjs");
+const require_format_cell = require("./format-cell-DaxV6WIJ.cjs");
+const require_as_cell_union = require("./as-cell-union-BjMP91PS.cjs");
+const require_as_column_menu = require("./as-column-menu-D_8NxujZ.cjs");
+const require_as_config_dialog = require("./as-config-dialog-CP362FP3.cjs");
+const require_as_confirm_dialog = require("./as-confirm-dialog-D41XaN_P.cjs");
+const require_as_filter_input = require("./as-filter-input-DUqpkTkg.cjs");
+const require_as_filter_dialog = require("./as-filter-dialog-BCUqpKPd.cjs");
+const require_as_table_header_cell = require("./as-table-header-cell-Ct_GPLVu.cjs");
+const require_as_window_table = require("./as-window-table-Bxq7cYW5.cjs");
+const require_as_filter_field = require("./as-filter-field-D3jSbSwB.cjs");
+const require_as_filters = require("./as-filters-Dp93OWRS.cjs");
+const require_as_preset_dialog = require("./as-preset-dialog-pusPD935.cjs");
+const require_as_row_actions = require("./as-row-actions-PD-sFmDs.cjs");
+const require_as_table_cell_value = require("./as-table-cell-value-BAi5yadc.cjs");
+const require_as_table = require("./as-table-ucLFACn0.cjs");
+const require_as_table_actions = require("./as-table-actions-D_PUqMYy.cjs");
+const require_as_preset_picker = require("./as-preset-picker-nAx3MYl7.cjs");
 let _atscript_ui = require("@atscript/ui");
 let vue = require("vue");
 let _atscript_ui_table = require("@atscript/ui-table");
 let _vueuse_core = require("@vueuse/core");
+//#region src/composables/use-table-export.ts
+/**
+* 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.
+*/
+function useTableExport(ctx) {
+	const state = (ctx ?? require_use_table_state.useTableContext()).state;
+	const progress = (0, vue.ref)(null);
+	const exporting = (0, vue.computed)(() => progress.value !== null);
+	function resolveColumns(selection, opts) {
+		if (selection && selection !== "visible") {
+			const byPath = new Map(state.allColumns.value.map((c) => [c.path, c]));
+			return selection.map((path) => byPath.get(path) ?? rawColumn(path));
+		}
+		const local = state.localColumnPaths.value;
+		const visible = state.columns.value;
+		if (local.size === 0) return visible;
+		return visible.filter((c) => !local.has(c.path) || opts.formatters?.[c.path]);
+	}
+	/**
+	* One value resolver per column, built once per run: the formatter lookup
+	* and the union-option index happen here instead of per cell.
+	*/
+	function resolversFor(columns, opts) {
+		return columns.map((column) => {
+			const perColumn = opts.formatters?.[column.path];
+			const formatCell = opts.formatCell;
+			const labels = column.options?.length ? new Map(column.options.map((o) => [o.key, o.label])) : null;
+			return (row) => {
+				const raw = require_get_cell_value.getCellValue(row, column.path);
+				if (perColumn) {
+					const out = perColumn(raw, column, row);
+					if (out !== void 0) return out;
+				}
+				if (formatCell) {
+					const out = formatCell(raw, column, row);
+					if (out !== void 0) return out;
+				}
+				if (labels !== null && (typeof raw === "string" || typeof raw === "number")) {
+					const hit = labels.get(String(raw));
+					if (hit !== void 0) return hit;
+				}
+				return (0, _atscript_ui_table.resolveExportValue)(raw);
+			};
+		});
+	}
+	async function exportRows(opts = {}) {
+		if (progress.value !== null) throw new Error("[vue-table] exportRows() is already running on this handle.");
+		const columns = resolveColumns(opts.columns, opts);
+		const columnPaths = columns.map((c) => c.path);
+		const query = (0, _atscript_ui_table.withStableOrder)(state.buildQuery({
+			columnPaths,
+			includeActions: false
+		}), state.tableDef.value?.primaryKeys ?? []);
+		const resolvers = resolversFor(columns, opts);
+		progress.value = { done: 0 };
+		try {
+			const { rows: matrix, total } = await (0, _atscript_ui_table.collectExportRows)({
+				query,
+				pageSize: opts.pageSize,
+				maxRows: opts.maxRows,
+				signal: opts.signal,
+				fetchPage: state.fetchPage,
+				mapRow: (row) => resolvers.map((resolve) => resolve(row)),
+				onProgress: (done, reported) => {
+					progress.value = {
+						done,
+						total: reported
+					};
+					opts.onProgress?.(done, reported);
+				}
+			});
+			const header = columns.map((c) => c.label || c.path);
+			const base = {
+				columns: header,
+				columnPaths,
+				rowCount: matrix.length,
+				total
+			};
+			if (opts.format === "rows") return {
+				...base,
+				format: "rows",
+				rows: matrix
+			};
+			return {
+				...base,
+				format: "csv",
+				filename: withCsvSuffix(opts.filename ?? "export.csv"),
+				csv: (0, _atscript_ui_table.toCsv)(header, matrix, opts.csv)
+			};
+		} finally {
+			progress.value = null;
+		}
+	}
+	return {
+		exportRows,
+		exporting,
+		progress
+	};
+}
+/**
+* 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.
+*/
+function downloadExport(result) {
+	if (result.format !== "csv") throw new Error("[vue-table] downloadExport() needs a `format: 'csv'` export result.");
+	if (typeof document === "undefined" || typeof URL?.createObjectURL !== "function") return false;
+	const blob = new Blob([result.csv], { type: "text/csv;charset=utf-8" });
+	const href = URL.createObjectURL(blob);
+	const anchor = document.createElement("a");
+	anchor.href = href;
+	anchor.download = result.filename;
+	anchor.style.display = "none";
+	document.body.appendChild(anchor);
+	anchor.click();
+	anchor.remove();
+	URL.revokeObjectURL(href);
+	return true;
+}
+function withCsvSuffix(name) {
+	return name.toLowerCase().endsWith(".csv") ? name : `${name}.csv`;
+}
+/** Minimal column for an export path that is not one of the table's columns. */
+function rawColumn(path) {
+	return {
+		path,
+		label: path,
+		type: "text",
+		sortable: false,
+		filterable: false,
+		nullable: true,
+		order: 0
+	};
+}
+//#endregion
 //#region src/composables/use-table-filter.ts
 /**
 * Per-field filter state composable.
@@ -552,6 +707,12 @@ exports.AsTableCellValue = require_as_table_cell_value.as_table_cell_value_defau
 exports.AsTableHeaderCell = require_as_table_header_cell.as_table_header_cell_default;
 exports.AsTableRoot = require_as_table_root.as_table_root_default;
 exports.AsWindowTable = require_as_window_table.as_window_table_default;
+Object.defineProperty(exports, "ExportAbortError", {
+	enumerable: true,
+	get: function() {
+		return _atscript_ui_table.ExportAbortError;
+	}
+});
 Object.defineProperty(exports, "PRESET_ASPECTS", {
 	enumerable: true,
 	get: function() {
@@ -575,6 +736,7 @@ exports.createDefaultCellTypes = createDefaultCellTypes;
 exports.createDefaultControls = createDefaultControls;
 exports.createStaticTableState = require_use_table_state.createStaticTableState;
 exports.createTableState = require_use_table_state.createTableState;
+exports.downloadExport = downloadExport;
 exports.extractIdentifier = require_use_table_state.extractIdentifier;
 exports.formatCellValue = require_format_cell.formatCellValue;
 exports.getCellValue = require_get_cell_value.getCellValue;
@@ -593,6 +755,7 @@ Object.defineProperty(exports, "isSystemPresetId", {
 	}
 });
 exports.provideCellLocale = require_use_cell_locale.provideCellLocale;
+exports.provideTableContext = require_use_table_state.provideTableContext;
 Object.defineProperty(exports, "resetDefaultClientFactory", {
 	enumerable: true,
 	get: function() {
@@ -620,6 +783,7 @@ exports.useTableActions = useTableActions;
 exports.useTableComponent = require_use_table_component.useTableComponent;
 exports.useTableContext = require_use_table_state.useTableContext;
 exports.useTableContextOptional = require_use_table_state.useTableContextOptional;
+exports.useTableExport = useTableExport;
 exports.useTableFilter = useTableFilter;
 exports.useTableNavBridge = require_use_table_nav_bridge.useTableNavBridge;
 exports.useTableSearch = useTableSearch;

package/dist/index.d.cts

@@ -1,23 +1,23 @@
 import { t as _default$11 } from "./as-filters.vue-DcxDnWAU.cjs";
 import { t as _default$13 } from "./as-preset-picker.vue-DfXS3pGl.cjs";
-import { S as TableNavBridge, _ as RowSelectableVerdict, b as TVueTableActionInfo, c as NavKeyOptions, d as ReactiveTableState, f as RowAttrsHook, g as RowSelectableHook, h as RowHookContext, m as RowDeleteOpt, n as ColumnMenuConfig, o as InvokeOpts, p as RowClassHook, r as ConfigTab, s as MainActionRequest, t as ActionResult, u as QueryErrorKind, v as TAsCellTypeComponents, x as TableActionsState, y as TAsTableControls } from "./types-BZ0HssRY.cjs";
-import { t as _default$16 } from "./as-table-actions.vue-CckRRsL6.cjs";
-import { $ as createStaticTableState, A as createDefaultCellTypes, B as useTableActions, C as extractIdentifier, D as CellLocale, E as getColumnWidth, F as useAppPrefs, G as clearTableCache, H as useTableFilter, I as AS_PRESETS_APP, J as useTableSelection, K as useTable, L as injectPresetsApp, M as useTableComponent, N as UseAppPrefsOptions, O as provideCellLocale, P as UseAppPrefsReturn, Q as TableStateInternals, R as UseTableUrlQueryOptions, S as setDefaultClientFactory, T as getCellValue, U as useTableNavBridge, V as useTableSearch, W as UseTableOptions, X as CreateTableStateOptions, Y as CreateStaticTableStateOptions, Z as TableContext, _ as UserConfData, a as PRESET_ASPECTS, at as UsePresetsReturn, b as resetDefaultClientFactory, c as PresetData, ct as UseLocalDraftOptions, d as QueryOptions, et as createTableState, f as STANDARD_PRESET_ID, g as UrlQuerySync, h as SystemPresetInput, i as ClientFactory, it as UsePresetsOptions, j as createDefaultControls, k as useCellLocale, l as PresetSnapshot, lt as UseLocalDraftReturn, m as SystemPreset, n as AppConfData, nt as useTableContextOptional, o as PresetAspect, ot as usePresets, p as SYSTEM_PRESET_PREFIX, q as SelectionPersistence, r as AsPresetEntryRow, rt as ActivePresetView, s as PresetCapabilities, st as StorageLike, t as _default$19, tt as useTableContext, u as PresetSnapshotWire, ut as useLocalDraft, v as getDefaultClientFactory, w as formatCellValue, x as resolveSystemPresets, y as isSystemPresetId, z as useTableUrlQuery } from "./as-table-root.vue-szvjZsCn.cjs";
-import { t as _default$15 } from "./as-table.vue-_urybtQj.cjs";
-import { t as _default$20 } from "./as-window-table.vue-h1bdyMv7.cjs";
+import { C as TableActionsState, S as TVueTableActionInfo, T as extractIdentifier, _ as RowHookContext, b as TAsCellTypeComponents, c as MainActionRequest, d as QueryErrorKind, f as ReactiveTableState, g as RowDeleteOpt, h as RowClassHook, l as NavKeyOptions, m as RowAttrsHook, n as ColumnMenuConfig, o as InvokeOpts, p as RowActionsConfig, r as ConfigTab, s as LocalRowAction, t as ActionResult, v as RowSelectableHook, w as TableNavBridge, x as TAsTableControls, y as RowSelectableVerdict } from "./types-CyAmAg10.cjs";
+import { t as _default$16 } from "./as-table-actions.vue-iKw4tsJh.cjs";
+import { $ as useTableExport, A as CellLocale, B as injectPresetsApp, C as isSystemPresetId, Ct as UseLocalDraftReturn, D as formatCellValue, E as setDefaultClientFactory, F as useTableComponent, G as useTableFilter, H as useTableUrlQuery, I as UseAppPrefsOptions, J as ExportProgress, K as useTableNavBridge, L as UseAppPrefsReturn, M as useCellLocale, N as createDefaultCellTypes, O as getCellValue, P as createDefaultControls, Q as downloadExport, R as useAppPrefs, S as getDefaultClientFactory, St as UseLocalDraftOptions, T as resolveSystemPresets, U as useTableActions, V as UseTableUrlQueryOptions, W as useTableSearch, X as ExportRowsOptions, Y as ExportResult, Z as UseTableExportReturn, _ as SYSTEM_PRESET_PREFIX, _t as ActivePresetView, a as CsvOptions, at as BuildQueryOptions, b as UrlQuerySync, bt as usePresets, c as ExportScalar, ct as QueryFn, d as PresetCapabilities, dt as TableStateInternals, et as UseTableOptions, f as PresetData, ft as createStaticTableState, g as STANDARD_PRESET_ID, gt as useTableContextOptional, h as QueryOptions, ht as useTableContext, i as ClientFactory, it as useTableSelection, j as provideCellLocale, k as getColumnWidth, l as PRESET_ASPECTS, lt as TableContext, m as PresetSnapshotWire, mt as provideTableContext, n as AppConfData, nt as useTable, o as DisplayColumnDef, ot as CreateStaticTableStateOptions, p as PresetSnapshot, pt as createTableState, q as ExportCellFormatter, r as AsPresetEntryRow, rt as SelectionPersistence, s as ExportAbortError, st as CreateTableStateOptions, t as _default$19, tt as clearTableCache, u as PresetAspect, ut as TableModelRefs, v as SystemPreset, vt as UsePresetsOptions, w as resetDefaultClientFactory, wt as useLocalDraft, x as UserConfData, xt as StorageLike, y as SystemPresetInput, yt as UsePresetsReturn, z as AS_PRESETS_APP } from "./as-table-root.vue-Do0j4ibu.cjs";
+import { t as _default$15 } from "./as-table.vue-QQ1aXpJC.cjs";
+import { t as _default$20 } from "./as-window-table.vue-avZGJlCe.cjs";
 import { t as _default } from "./as-cell-array.vue-pFs5GcCR.cjs";
 import { t as _default$1 } from "./as-cell-date.vue-BBSps2B2.cjs";
 import { t as _default$2 } from "./as-cell-json.vue-C6wg4ARZ.cjs";
 import { t as _default$3 } from "./as-cell-number.vue-CJ2K5zeM.cjs";
 import { t as _default$4 } from "./as-cell-union.vue-CslPM_c2.cjs";
-import { t as _default$5 } from "./as-column-menu.vue-CZ8XqHl0.cjs";
+import { t as _default$5 } from "./as-column-menu.vue-CDlI4-Cz.cjs";
 import { t as _default$6 } from "./as-config-dialog.vue-DvvJi3xx.cjs";
 import { t as _default$7 } from "./as-confirm-dialog.vue-CXxLpzbu.cjs";
 import { t as _default$8 } from "./as-filter-dialog.vue-BV2J8PgZ.cjs";
 import { t as _default$9 } from "./as-filter-field.vue-ByQ8xIGq.cjs";
 import { t as _default$10 } from "./as-filter-input.vue-CS4nOk_Q.cjs";
 import { t as _default$12 } from "./as-preset-dialog.vue-DP9fy00Y.cjs";
-import { t as _default$14 } from "./as-row-actions.vue-Bvcc2tUN.cjs";
+import { t as _default$14 } from "./as-row-actions.vue-D0MXQoeg.cjs";
 import { t as _default$17 } from "./as-table-cell-value.vue-BgFDv2JQ.cjs";
-import { t as _default$18 } from "./as-table-header-cell.vue-qS1Xfc-U.cjs";
-export { AS_PRESETS_APP, ActionResult, ActivePresetView, AppConfData, _default as AsCellArray, _default$1 as AsCellDate, _default$2 as AsCellJson, _default$3 as AsCellNumber, _default$4 as AsCellUnion, _default$5 as AsColumnMenu, _default$6 as AsConfigDialog, _default$7 as AsConfirmDialog, _default$8 as AsFilterDialog, _default$9 as AsFilterField, _default$10 as AsFilterInput, _default$11 as AsFilters, _default$12 as AsPresetDialog, AsPresetEntryRow, _default$13 as AsPresetPicker, _default$14 as AsRowActions, _default$15 as AsTable, _default$16 as AsTableActions, _default$17 as AsTableCellValue, _default$18 as AsTableHeaderCell, _default$19 as AsTableRoot, _default$20 as AsWindowTable, CellLocale, ClientFactory, ColumnMenuConfig, ConfigTab, CreateStaticTableStateOptions, CreateTableStateOptions, InvokeOpts, MainActionRequest, NavKeyOptions, PRESET_ASPECTS, PresetAspect, PresetCapabilities, PresetData, PresetSnapshot, PresetSnapshotWire, QueryErrorKind, QueryOptions, ReactiveTableState, RowAttrsHook, RowClassHook, RowDeleteOpt, RowHookContext, RowSelectableHook, RowSelectableVerdict, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, SelectionPersistence, StorageLike, SystemPreset, SystemPresetInput, TAsCellTypeComponents, TAsTableControls, TVueTableActionInfo, TableActionsState, TableContext, TableNavBridge, TableStateInternals, UrlQuerySync, UseAppPrefsOptions, UseAppPrefsReturn, UseLocalDraftOptions, UseLocalDraftReturn, UsePresetsOptions, UsePresetsReturn, UseTableOptions, UseTableUrlQueryOptions, UserConfData, clearTableCache, createDefaultCellTypes, createDefaultControls, createStaticTableState, createTableState, extractIdentifier, formatCellValue, getCellValue, getColumnWidth, getDefaultClientFactory, injectPresetsApp, isSystemPresetId, provideCellLocale, resetDefaultClientFactory, resolveSystemPresets, setDefaultClientFactory, useAppPrefs, useCellLocale, useLocalDraft, usePresets, useTable, useTableActions, useTableComponent, useTableContext, useTableContextOptional, useTableFilter, useTableNavBridge, useTableSearch, useTableSelection, useTableUrlQuery };
+import { t as _default$18 } from "./as-table-header-cell.vue-DqjorECQ.cjs";
+export { AS_PRESETS_APP, ActionResult, ActivePresetView, AppConfData, _default as AsCellArray, _default$1 as AsCellDate, _default$2 as AsCellJson, _default$3 as AsCellNumber, _default$4 as AsCellUnion, _default$5 as AsColumnMenu, _default$6 as AsConfigDialog, _default$7 as AsConfirmDialog, _default$8 as AsFilterDialog, _default$9 as AsFilterField, _default$10 as AsFilterInput, _default$11 as AsFilters, _default$12 as AsPresetDialog, AsPresetEntryRow, _default$13 as AsPresetPicker, _default$14 as AsRowActions, _default$15 as AsTable, _default$16 as AsTableActions, _default$17 as AsTableCellValue, _default$18 as AsTableHeaderCell, _default$19 as AsTableRoot, _default$20 as AsWindowTable, BuildQueryOptions, CellLocale, ClientFactory, ColumnMenuConfig, ConfigTab, CreateStaticTableStateOptions, CreateTableStateOptions, CsvOptions, DisplayColumnDef, ExportAbortError, ExportCellFormatter, ExportProgress, ExportResult, ExportRowsOptions, ExportScalar, InvokeOpts, LocalRowAction, MainActionRequest, NavKeyOptions, PRESET_ASPECTS, PresetAspect, PresetCapabilities, PresetData, PresetSnapshot, PresetSnapshotWire, QueryErrorKind, QueryFn, QueryOptions, ReactiveTableState, RowActionsConfig, RowAttrsHook, RowClassHook, RowDeleteOpt, RowHookContext, RowSelectableHook, RowSelectableVerdict, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, SelectionPersistence, StorageLike, SystemPreset, SystemPresetInput, TAsCellTypeComponents, TAsTableControls, TVueTableActionInfo, TableActionsState, TableContext, TableModelRefs, TableNavBridge, TableStateInternals, UrlQuerySync, UseAppPrefsOptions, UseAppPrefsReturn, UseLocalDraftOptions, UseLocalDraftReturn, UsePresetsOptions, UsePresetsReturn, UseTableExportReturn, UseTableOptions, UseTableUrlQueryOptions, UserConfData, clearTableCache, createDefaultCellTypes, createDefaultControls, createStaticTableState, createTableState, downloadExport, extractIdentifier, formatCellValue, getCellValue, getColumnWidth, getDefaultClientFactory, injectPresetsApp, isSystemPresetId, provideCellLocale, provideTableContext, resetDefaultClientFactory, resolveSystemPresets, setDefaultClientFactory, useAppPrefs, useCellLocale, useLocalDraft, usePresets, useTable, useTableActions, useTableComponent, useTableContext, useTableContextOptional, useTableExport, useTableFilter, useTableNavBridge, useTableSearch, useTableSelection, useTableUrlQuery };

package/dist/index.d.mts

@@ -1,23 +1,23 @@
 import { t as _default$11 } from "./as-filters.vue-BG_ysCkC.mjs";
 import { t as _default$13 } from "./as-preset-picker.vue-BPjsiaVt.mjs";
-import { S as TableNavBridge, _ as RowSelectableVerdict, b as TVueTableActionInfo, c as NavKeyOptions, d as ReactiveTableState, f as RowAttrsHook, g as RowSelectableHook, h as RowHookContext, m as RowDeleteOpt, n as ColumnMenuConfig, o as InvokeOpts, p as RowClassHook, r as ConfigTab, s as MainActionRequest, t as ActionResult, u as QueryErrorKind, v as TAsCellTypeComponents, x as TableActionsState, y as TAsTableControls } from "./types-CXz-4dPz.mjs";
-import { t as _default$16 } from "./as-table-actions.vue-DsqauvXR.mjs";
-import { $ as createStaticTableState, A as createDefaultCellTypes, B as useTableActions, C as extractIdentifier, D as CellLocale, E as getColumnWidth, F as useAppPrefs, G as clearTableCache, H as useTableFilter, I as AS_PRESETS_APP, J as useTableSelection, K as useTable, L as injectPresetsApp, M as useTableComponent, N as UseAppPrefsOptions, O as provideCellLocale, P as UseAppPrefsReturn, Q as TableStateInternals, R as UseTableUrlQueryOptions, S as setDefaultClientFactory, T as getCellValue, U as useTableNavBridge, V as useTableSearch, W as UseTableOptions, X as CreateTableStateOptions, Y as CreateStaticTableStateOptions, Z as TableContext, _ as UserConfData, a as PRESET_ASPECTS, at as UsePresetsReturn, b as resetDefaultClientFactory, c as PresetData, ct as UseLocalDraftOptions, d as QueryOptions, et as createTableState, f as STANDARD_PRESET_ID, g as UrlQuerySync, h as SystemPresetInput, i as ClientFactory, it as UsePresetsOptions, j as createDefaultControls, k as useCellLocale, l as PresetSnapshot, lt as UseLocalDraftReturn, m as SystemPreset, n as AppConfData, nt as useTableContextOptional, o as PresetAspect, ot as usePresets, p as SYSTEM_PRESET_PREFIX, q as SelectionPersistence, r as AsPresetEntryRow, rt as ActivePresetView, s as PresetCapabilities, st as StorageLike, t as _default$19, tt as useTableContext, u as PresetSnapshotWire, ut as useLocalDraft, v as getDefaultClientFactory, w as formatCellValue, x as resolveSystemPresets, y as isSystemPresetId, z as useTableUrlQuery } from "./as-table-root.vue-BPU92_Ns.mjs";
-import { t as _default$15 } from "./as-table.vue-4WhMA8AM.mjs";
-import { t as _default$20 } from "./as-window-table.vue-CWsJvOkL.mjs";
+import { C as TableActionsState, S as TVueTableActionInfo, T as extractIdentifier, _ as RowHookContext, b as TAsCellTypeComponents, c as MainActionRequest, d as QueryErrorKind, f as ReactiveTableState, g as RowDeleteOpt, h as RowClassHook, l as NavKeyOptions, m as RowAttrsHook, n as ColumnMenuConfig, o as InvokeOpts, p as RowActionsConfig, r as ConfigTab, s as LocalRowAction, t as ActionResult, v as RowSelectableHook, w as TableNavBridge, x as TAsTableControls, y as RowSelectableVerdict } from "./types-yS6-QFfT.mjs";
+import { t as _default$16 } from "./as-table-actions.vue-kndyFTyi.mjs";
+import { $ as useTableExport, A as CellLocale, B as injectPresetsApp, C as isSystemPresetId, Ct as UseLocalDraftReturn, D as formatCellValue, E as setDefaultClientFactory, F as useTableComponent, G as useTableFilter, H as useTableUrlQuery, I as UseAppPrefsOptions, J as ExportProgress, K as useTableNavBridge, L as UseAppPrefsReturn, M as useCellLocale, N as createDefaultCellTypes, O as getCellValue, P as createDefaultControls, Q as downloadExport, R as useAppPrefs, S as getDefaultClientFactory, St as UseLocalDraftOptions, T as resolveSystemPresets, U as useTableActions, V as UseTableUrlQueryOptions, W as useTableSearch, X as ExportRowsOptions, Y as ExportResult, Z as UseTableExportReturn, _ as SYSTEM_PRESET_PREFIX, _t as ActivePresetView, a as CsvOptions, at as BuildQueryOptions, b as UrlQuerySync, bt as usePresets, c as ExportScalar, ct as QueryFn, d as PresetCapabilities, dt as TableStateInternals, et as UseTableOptions, f as PresetData, ft as createStaticTableState, g as STANDARD_PRESET_ID, gt as useTableContextOptional, h as QueryOptions, ht as useTableContext, i as ClientFactory, it as useTableSelection, j as provideCellLocale, k as getColumnWidth, l as PRESET_ASPECTS, lt as TableContext, m as PresetSnapshotWire, mt as provideTableContext, n as AppConfData, nt as useTable, o as DisplayColumnDef, ot as CreateStaticTableStateOptions, p as PresetSnapshot, pt as createTableState, q as ExportCellFormatter, r as AsPresetEntryRow, rt as SelectionPersistence, s as ExportAbortError, st as CreateTableStateOptions, t as _default$19, tt as clearTableCache, u as PresetAspect, ut as TableModelRefs, v as SystemPreset, vt as UsePresetsOptions, w as resetDefaultClientFactory, wt as useLocalDraft, x as UserConfData, xt as StorageLike, y as SystemPresetInput, yt as UsePresetsReturn, z as AS_PRESETS_APP } from "./as-table-root.vue-D0XFmTEL.mjs";
+import { t as _default$15 } from "./as-table.vue-Dl0nGtMF.mjs";
+import { t as _default$20 } from "./as-window-table.vue-CdfbFgGs.mjs";
 import { t as _default } from "./as-cell-array.vue-D4vS7C_D.mjs";
 import { t as _default$1 } from "./as-cell-date.vue-Chs7WTZ9.mjs";
 import { t as _default$2 } from "./as-cell-json.vue-C0_LDvQw.mjs";
 import { t as _default$3 } from "./as-cell-number.vue-BBF0OuU8.mjs";
 import { t as _default$4 } from "./as-cell-union.vue-CL-Lf-Rm.mjs";
-import { t as _default$5 } from "./as-column-menu.vue-Cuelpv3p.mjs";
+import { t as _default$5 } from "./as-column-menu.vue-BaIGUOhP.mjs";
 import { t as _default$6 } from "./as-config-dialog.vue-BvFZZRuY.mjs";
 import { t as _default$7 } from "./as-confirm-dialog.vue-Cz52-v6c.mjs";
 import { t as _default$8 } from "./as-filter-dialog.vue-likNLqzF.mjs";
 import { t as _default$9 } from "./as-filter-field.vue-BbXLhd6O.mjs";
 import { t as _default$10 } from "./as-filter-input.vue-B9ma2l9j.mjs";
 import { t as _default$12 } from "./as-preset-dialog.vue-BRjjfPty.mjs";
-import { t as _default$14 } from "./as-row-actions.vue-DUSDuoR2.mjs";
+import { t as _default$14 } from "./as-row-actions.vue-AXXt5kQS.mjs";
 import { t as _default$17 } from "./as-table-cell-value.vue-kfNgVhzn.mjs";
-import { t as _default$18 } from "./as-table-header-cell.vue-BjVOEFqz.mjs";
-export { AS_PRESETS_APP, ActionResult, ActivePresetView, AppConfData, _default as AsCellArray, _default$1 as AsCellDate, _default$2 as AsCellJson, _default$3 as AsCellNumber, _default$4 as AsCellUnion, _default$5 as AsColumnMenu, _default$6 as AsConfigDialog, _default$7 as AsConfirmDialog, _default$8 as AsFilterDialog, _default$9 as AsFilterField, _default$10 as AsFilterInput, _default$11 as AsFilters, _default$12 as AsPresetDialog, AsPresetEntryRow, _default$13 as AsPresetPicker, _default$14 as AsRowActions, _default$15 as AsTable, _default$16 as AsTableActions, _default$17 as AsTableCellValue, _default$18 as AsTableHeaderCell, _default$19 as AsTableRoot, _default$20 as AsWindowTable, CellLocale, ClientFactory, ColumnMenuConfig, ConfigTab, CreateStaticTableStateOptions, CreateTableStateOptions, InvokeOpts, MainActionRequest, NavKeyOptions, PRESET_ASPECTS, PresetAspect, PresetCapabilities, PresetData, PresetSnapshot, PresetSnapshotWire, QueryErrorKind, QueryOptions, ReactiveTableState, RowAttrsHook, RowClassHook, RowDeleteOpt, RowHookContext, RowSelectableHook, RowSelectableVerdict, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, SelectionPersistence, StorageLike, SystemPreset, SystemPresetInput, TAsCellTypeComponents, TAsTableControls, TVueTableActionInfo, TableActionsState, TableContext, TableNavBridge, TableStateInternals, UrlQuerySync, UseAppPrefsOptions, UseAppPrefsReturn, UseLocalDraftOptions, UseLocalDraftReturn, UsePresetsOptions, UsePresetsReturn, UseTableOptions, UseTableUrlQueryOptions, UserConfData, clearTableCache, createDefaultCellTypes, createDefaultControls, createStaticTableState, createTableState, extractIdentifier, formatCellValue, getCellValue, getColumnWidth, getDefaultClientFactory, injectPresetsApp, isSystemPresetId, provideCellLocale, resetDefaultClientFactory, resolveSystemPresets, setDefaultClientFactory, useAppPrefs, useCellLocale, useLocalDraft, usePresets, useTable, useTableActions, useTableComponent, useTableContext, useTableContextOptional, useTableFilter, useTableNavBridge, useTableSearch, useTableSelection, useTableUrlQuery };
+import { t as _default$18 } from "./as-table-header-cell.vue-BNsOEsof.mjs";
+export { AS_PRESETS_APP, ActionResult, ActivePresetView, AppConfData, _default as AsCellArray, _default$1 as AsCellDate, _default$2 as AsCellJson, _default$3 as AsCellNumber, _default$4 as AsCellUnion, _default$5 as AsColumnMenu, _default$6 as AsConfigDialog, _default$7 as AsConfirmDialog, _default$8 as AsFilterDialog, _default$9 as AsFilterField, _default$10 as AsFilterInput, _default$11 as AsFilters, _default$12 as AsPresetDialog, AsPresetEntryRow, _default$13 as AsPresetPicker, _default$14 as AsRowActions, _default$15 as AsTable, _default$16 as AsTableActions, _default$17 as AsTableCellValue, _default$18 as AsTableHeaderCell, _default$19 as AsTableRoot, _default$20 as AsWindowTable, BuildQueryOptions, CellLocale, ClientFactory, ColumnMenuConfig, ConfigTab, CreateStaticTableStateOptions, CreateTableStateOptions, CsvOptions, DisplayColumnDef, ExportAbortError, ExportCellFormatter, ExportProgress, ExportResult, ExportRowsOptions, ExportScalar, InvokeOpts, LocalRowAction, MainActionRequest, NavKeyOptions, PRESET_ASPECTS, PresetAspect, PresetCapabilities, PresetData, PresetSnapshot, PresetSnapshotWire, QueryErrorKind, QueryFn, QueryOptions, ReactiveTableState, RowActionsConfig, RowAttrsHook, RowClassHook, RowDeleteOpt, RowHookContext, RowSelectableHook, RowSelectableVerdict, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, SelectionPersistence, StorageLike, SystemPreset, SystemPresetInput, TAsCellTypeComponents, TAsTableControls, TVueTableActionInfo, TableActionsState, TableContext, TableModelRefs, TableNavBridge, TableStateInternals, UrlQuerySync, UseAppPrefsOptions, UseAppPrefsReturn, UseLocalDraftOptions, UseLocalDraftReturn, UsePresetsOptions, UsePresetsReturn, UseTableExportReturn, UseTableOptions, UseTableUrlQueryOptions, UserConfData, clearTableCache, createDefaultCellTypes, createDefaultControls, createStaticTableState, createTableState, downloadExport, extractIdentifier, formatCellValue, getCellValue, getColumnWidth, getDefaultClientFactory, injectPresetsApp, isSystemPresetId, provideCellLocale, provideTableContext, resetDefaultClientFactory, resolveSystemPresets, setDefaultClientFactory, useAppPrefs, useCellLocale, useLocalDraft, usePresets, useTable, useTableActions, useTableComponent, useTableContext, useTableContextOptional, useTableExport, useTableFilter, useTableNavBridge, useTableSearch, useTableSelection, useTableUrlQuery };

package/dist/index.mjs

@@ -1,36 +1,191 @@
-import { D as ROW_ACTIONS_TYPE, a as useTableContext, b as extractIdentifier, n as createTableState, o as useTableContextOptional, t as createStaticTableState } from "./use-table-state-DLJbW753.mjs";
-import { n as useTableSelection } from "./use-table-selection-C84z4OZy.mjs";
-import { a as AS_PRESETS_APP, i as useLocalDraft, n as useTable, o as injectPresetsApp, r as usePresets, t as clearTableCache } from "./use-table-Bk-jSxOM.mjs";
-import { t as useTableNavBridge } from "./use-table-nav-bridge-B9SSEajW.mjs";
-import { t as useTableComponent } from "./use-table-component-KuzZxAP8.mjs";
-import { t as getCellValue } from "./get-cell-value-C8LLc_Rr.mjs";
-import { t as as_cell_array_default } from "./as-cell-array-2qmJ1lT2.mjs";
-import { t as as_cell_date_default } from "./as-cell-date-BwFgi6O0.mjs";
-import { n as useCellLocale, t as provideCellLocale } from "./use-cell-locale-MQXoONh5.mjs";
-import { t as as_cell_json_default } from "./as-cell-json--95Xq6yq.mjs";
-import { t as as_cell_number_default } from "./as-cell-number-DKRaS9pM.mjs";
-import { t as formatCellValue } from "./format-cell-D1Ziv96Q.mjs";
-import { t as as_cell_union_default } from "./as-cell-union-C9FukGqF.mjs";
-import { t as as_column_menu_default } from "./as-column-menu-kTIQfLTi.mjs";
-import { t as as_config_dialog_default } from "./as-config-dialog-BKsm8OHR.mjs";
-import { t as as_confirm_dialog_default } from "./as-confirm-dialog-BV01t7dn.mjs";
-import { t as as_filter_input_default } from "./as-filter-input-BM23TNeh.mjs";
-import { t as as_filter_dialog_default } from "./as-filter-dialog-Ckrl79kU.mjs";
-import { t as as_table_header_cell_default } from "./as-table-header-cell-q-c_QklI.mjs";
-import { t as as_window_table_default } from "./as-window-table-S1XWpDHQ.mjs";
-import { t as as_filter_field_default } from "./as-filter-field-C-IFnj8K.mjs";
-import { t as as_filters_default } from "./as-filters-DJEQj7_p.mjs";
-import { t as as_preset_dialog_default } from "./as-preset-dialog-CCIacZ2C.mjs";
-import { t as as_row_actions_default } from "./as-row-actions-pukI1JT7.mjs";
-import { t as as_table_cell_value_default } from "./as-table-cell-value-CPcFxSOj.mjs";
-import { t as as_table_root_default } from "./as-table-root-Bpsrp0Vz.mjs";
-import { t as as_table_default } from "./as-table-D5_bQ0p5.mjs";
-import { t as as_table_actions_default } from "./as-table-actions-DKYK_mTO.mjs";
-import { t as as_preset_picker_default } from "./as-preset-picker-DGSqQl9A.mjs";
+import { D as ROW_ACTIONS_TYPE, a as useTableContext, b as extractIdentifier, n as createTableState, o as useTableContextOptional, r as provideTableContext, t as createStaticTableState } from "./use-table-state-CwfgWmuk.mjs";
+import { t as getCellValue } from "./get-cell-value-Cb3X8nUn.mjs";
+import { n as useTableSelection } from "./use-table-selection-ULbKT2xW.mjs";
+import { a as useLocalDraft, i as usePresets, o as AS_PRESETS_APP, r as useTable, s as injectPresetsApp, t as clearTableCache } from "./use-table-BVptAnaS.mjs";
+import { t as useTableNavBridge } from "./use-table-nav-bridge-LCL6vq9F.mjs";
+import { t as useTableComponent } from "./use-table-component-DYzKgCC4.mjs";
+import { t as as_table_root_default } from "./as-table-root-DGYw0kPC.mjs";
+import { t as as_cell_array_default } from "./as-cell-array-BWHkJX3I.mjs";
+import { t as as_cell_date_default } from "./as-cell-date-mGlnDeLP.mjs";
+import { n as useCellLocale, t as provideCellLocale } from "./use-cell-locale-CxQOQsns.mjs";
+import { t as as_cell_json_default } from "./as-cell-json-2I081xnO.mjs";
+import { t as as_cell_number_default } from "./as-cell-number-CP2AZI9g.mjs";
+import { t as formatCellValue } from "./format-cell-Bx7wNc4X.mjs";
+import { t as as_cell_union_default } from "./as-cell-union-NHpDCXty.mjs";
+import { t as as_column_menu_default } from "./as-column-menu-BMTS3DO2.mjs";
+import { t as as_config_dialog_default } from "./as-config-dialog-BMQxSqzl.mjs";
+import { t as as_confirm_dialog_default } from "./as-confirm-dialog-Dp_njNXz.mjs";
+import { t as as_filter_input_default } from "./as-filter-input-C8KmOus8.mjs";
+import { t as as_filter_dialog_default } from "./as-filter-dialog-kAXGDwsk.mjs";
+import { t as as_table_header_cell_default } from "./as-table-header-cell-CZyy4q1s.mjs";
+import { t as as_window_table_default } from "./as-window-table-B9Y4Xgwm.mjs";
+import { t as as_filter_field_default } from "./as-filter-field-WnV2axh8.mjs";
+import { t as as_filters_default } from "./as-filters-Bc44srvA.mjs";
+import { t as as_preset_dialog_default } from "./as-preset-dialog-Bx4nRuyk.mjs";
+import { t as as_row_actions_default } from "./as-row-actions-gxmuZkYI.mjs";
+import { t as as_table_cell_value_default } from "./as-table-cell-value-BVcfhhCb.mjs";
+import { t as as_table_default } from "./as-table-BIV1W3O9.mjs";
+import { t as as_table_actions_default } from "./as-table-actions-DQ5Nn8Jc.mjs";
+import { t as as_preset_picker_default } from "./as-preset-picker-BRQdflJz.mjs";
 import { getDefaultClientFactory, resetDefaultClientFactory, setDefaultClientFactory } from "@atscript/ui";
 import { computed, effectScope, ref, shallowRef } from "vue";
-import { AppPrefsClient, PRESET_ASPECTS, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, columnFilterType, conditionsForType, defaultCondition, isFilled, isSystemPresetId, isUnavailableError, resolveSystemPresets, urlQueryConsumesKey } from "@atscript/ui-table";
+import { AppPrefsClient, ExportAbortError, PRESET_ASPECTS, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, collectExportRows, columnFilterType, conditionsForType, defaultCondition, isFilled, isSystemPresetId, isUnavailableError, resolveExportValue, resolveSystemPresets, toCsv, urlQueryConsumesKey, withStableOrder } from "@atscript/ui-table";
 import { StorageSerializers, useEventBus, useStorage } from "@vueuse/core";
+//#region src/composables/use-table-export.ts
+/**
+* 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.
+*/
+function useTableExport(ctx) {
+	const state = (ctx ?? useTableContext()).state;
+	const progress = ref(null);
+	const exporting = computed(() => progress.value !== null);
+	function resolveColumns(selection, opts) {
+		if (selection && selection !== "visible") {
+			const byPath = new Map(state.allColumns.value.map((c) => [c.path, c]));
+			return selection.map((path) => byPath.get(path) ?? rawColumn(path));
+		}
+		const local = state.localColumnPaths.value;
+		const visible = state.columns.value;
+		if (local.size === 0) return visible;
+		return visible.filter((c) => !local.has(c.path) || opts.formatters?.[c.path]);
+	}
+	/**
+	* One value resolver per column, built once per run: the formatter lookup
+	* and the union-option index happen here instead of per cell.
+	*/
+	function resolversFor(columns, opts) {
+		return columns.map((column) => {
+			const perColumn = opts.formatters?.[column.path];
+			const formatCell = opts.formatCell;
+			const labels = column.options?.length ? new Map(column.options.map((o) => [o.key, o.label])) : null;
+			return (row) => {
+				const raw = getCellValue(row, column.path);
+				if (perColumn) {
+					const out = perColumn(raw, column, row);
+					if (out !== void 0) return out;
+				}
+				if (formatCell) {
+					const out = formatCell(raw, column, row);
+					if (out !== void 0) return out;
+				}
+				if (labels !== null && (typeof raw === "string" || typeof raw === "number")) {
+					const hit = labels.get(String(raw));
+					if (hit !== void 0) return hit;
+				}
+				return resolveExportValue(raw);
+			};
+		});
+	}
+	async function exportRows(opts = {}) {
+		if (progress.value !== null) throw new Error("[vue-table] exportRows() is already running on this handle.");
+		const columns = resolveColumns(opts.columns, opts);
+		const columnPaths = columns.map((c) => c.path);
+		const query = withStableOrder(state.buildQuery({
+			columnPaths,
+			includeActions: false
+		}), state.tableDef.value?.primaryKeys ?? []);
+		const resolvers = resolversFor(columns, opts);
+		progress.value = { done: 0 };
+		try {
+			const { rows: matrix, total } = await collectExportRows({
+				query,
+				pageSize: opts.pageSize,
+				maxRows: opts.maxRows,
+				signal: opts.signal,
+				fetchPage: state.fetchPage,
+				mapRow: (row) => resolvers.map((resolve) => resolve(row)),
+				onProgress: (done, reported) => {
+					progress.value = {
+						done,
+						total: reported
+					};
+					opts.onProgress?.(done, reported);
+				}
+			});
+			const header = columns.map((c) => c.label || c.path);
+			const base = {
+				columns: header,
+				columnPaths,
+				rowCount: matrix.length,
+				total
+			};
+			if (opts.format === "rows") return {
+				...base,
+				format: "rows",
+				rows: matrix
+			};
+			return {
+				...base,
+				format: "csv",
+				filename: withCsvSuffix(opts.filename ?? "export.csv"),
+				csv: toCsv(header, matrix, opts.csv)
+			};
+		} finally {
+			progress.value = null;
+		}
+	}
+	return {
+		exportRows,
+		exporting,
+		progress
+	};
+}
+/**
+* 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.
+*/
+function downloadExport(result) {
+	if (result.format !== "csv") throw new Error("[vue-table] downloadExport() needs a `format: 'csv'` export result.");
+	if (typeof document === "undefined" || typeof URL?.createObjectURL !== "function") return false;
+	const blob = new Blob([result.csv], { type: "text/csv;charset=utf-8" });
+	const href = URL.createObjectURL(blob);
+	const anchor = document.createElement("a");
+	anchor.href = href;
+	anchor.download = result.filename;
+	anchor.style.display = "none";
+	document.body.appendChild(anchor);
+	anchor.click();
+	anchor.remove();
+	URL.revokeObjectURL(href);
+	return true;
+}
+function withCsvSuffix(name) {
+	return name.toLowerCase().endsWith(".csv") ? name : `${name}.csv`;
+}
+/** Minimal column for an export path that is not one of the table's columns. */
+function rawColumn(path) {
+	return {
+		path,
+		label: path,
+		type: "text",
+		sortable: false,
+		filterable: false,
+		nullable: true,
+		order: 0
+	};
+}
+//#endregion
 //#region src/composables/use-table-filter.ts
 /**
 * Per-field filter state composable.
@@ -529,4 +684,4 @@ function getColumnWidth(column) {
 	return column.width || DEFAULT_WIDTHS[column.type] || "15em";
 }
 //#endregion
-export { AS_PRESETS_APP, as_cell_array_default as AsCellArray, as_cell_date_default as AsCellDate, as_cell_json_default as AsCellJson, as_cell_number_default as AsCellNumber, as_cell_union_default as AsCellUnion, as_column_menu_default as AsColumnMenu, as_config_dialog_default as AsConfigDialog, as_confirm_dialog_default as AsConfirmDialog, as_filter_dialog_default as AsFilterDialog, as_filter_field_default as AsFilterField, as_filter_input_default as AsFilterInput, as_filters_default as AsFilters, as_preset_dialog_default as AsPresetDialog, as_preset_picker_default as AsPresetPicker, as_row_actions_default as AsRowActions, as_table_default as AsTable, as_table_actions_default as AsTableActions, as_table_cell_value_default as AsTableCellValue, as_table_header_cell_default as AsTableHeaderCell, as_table_root_default as AsTableRoot, as_window_table_default as AsWindowTable, PRESET_ASPECTS, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, clearTableCache, createDefaultCellTypes, createDefaultControls, createStaticTableState, createTableState, extractIdentifier, formatCellValue, getCellValue, getColumnWidth, getDefaultClientFactory, injectPresetsApp, isSystemPresetId, provideCellLocale, resetDefaultClientFactory, resolveSystemPresets, setDefaultClientFactory, useAppPrefs, useCellLocale, useLocalDraft, usePresets, useTable, useTableActions, useTableComponent, useTableContext, useTableContextOptional, useTableFilter, useTableNavBridge, useTableSearch, useTableSelection, useTableUrlQuery };
+export { AS_PRESETS_APP, as_cell_array_default as AsCellArray, as_cell_date_default as AsCellDate, as_cell_json_default as AsCellJson, as_cell_number_default as AsCellNumber, as_cell_union_default as AsCellUnion, as_column_menu_default as AsColumnMenu, as_config_dialog_default as AsConfigDialog, as_confirm_dialog_default as AsConfirmDialog, as_filter_dialog_default as AsFilterDialog, as_filter_field_default as AsFilterField, as_filter_input_default as AsFilterInput, as_filters_default as AsFilters, as_preset_dialog_default as AsPresetDialog, as_preset_picker_default as AsPresetPicker, as_row_actions_default as AsRowActions, as_table_default as AsTable, as_table_actions_default as AsTableActions, as_table_cell_value_default as AsTableCellValue, as_table_header_cell_default as AsTableHeaderCell, as_table_root_default as AsTableRoot, as_window_table_default as AsWindowTable, ExportAbortError, PRESET_ASPECTS, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, clearTableCache, createDefaultCellTypes, createDefaultControls, createStaticTableState, createTableState, downloadExport, extractIdentifier, formatCellValue, getCellValue, getColumnWidth, getDefaultClientFactory, injectPresetsApp, isSystemPresetId, provideCellLocale, provideTableContext, resetDefaultClientFactory, resolveSystemPresets, setDefaultClientFactory, useAppPrefs, useCellLocale, useLocalDraft, usePresets, useTable, useTableActions, useTableComponent, useTableContext, useTableContextOptional, useTableExport, useTableFilter, useTableNavBridge, useTableSearch, useTableSelection, useTableUrlQuery };