@atscript/vue-table 0.1.132 → 0.1.134

package/dist/{as-table-root.vue-D0T3n-Vm.d.cts → as-table-root.vue-D94eypcL.d.cts}

@@ -1,13 +1,13 @@
-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-CTMxE_zA.cjs";
+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--ex8BJIO.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 { Client, PageResult } from "@atscript/db-client";
+import { FilterExpr, Uniquery } from "@uniqu/core";
 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, 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, 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>;
@@ -30,6 +30,14 @@ interface UseLocalDraftOptions {
   enabled: Ref<boolean> | boolean;
   /** Persisted-aspect gate — drafts only persist aspects in this set. */
   availableAspects: readonly PresetAspect[];
+  /**
+   * Identity the draft is keyed under — pass the signed-in user's id so a
+   * shared browser never restores the previous user's draft. Reactive: when
+   * it changes, reads and writes move to the new key and the old scope's
+   * draft is neither read nor overwritten. Omitted (or `undefined`) keeps
+   * the pre-0.1.133 unscoped key. Since 0.1.133.
+   */
+  scope?: MaybeRefOrGetter<string | undefined>;
   /** Optional debounce override (default 300ms). */
   debounceMs?: number;
   /**
@@ -67,8 +75,9 @@ interface UseLocalDraftReturn {
 }
 /**
  * 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).
+ * `(app, scope, 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
@@ -104,6 +113,11 @@ interface UsePresetsReturn {
   /** False on 401/403 from initial load — UI hides itself. */
   available: ComputedRef<boolean>;
   loading: Ref<boolean>;
+  /**
+   * Load failure from `reload()`, or null. Mutator failures are NOT recorded
+   * here — they rethrow, and the table-state slice's
+   * `state.preset.lastError` is the single channel UI renders.
+   */
   error: Ref<unknown>;
   /**
    * Authoritative current-user id. `capabilities.userId` when caps are
@@ -186,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[]>;
@@ -212,8 +236,12 @@ interface TableQueryOptions {
    * meta), regardless of which columns are visible. Additive only.
    */
   alwaysSelected?: string[];
-  /** When true, all triggers (query/queryNext/loadRange) early-return. */
-  blockQuery?: boolean;
+  /**
+   * When true, all triggers (query/queryNext/loadRange) early-return. Pass a
+   * getter (or a ref) to keep it reactive: when it flips back to `false` the
+   * table runs the query it was holding back, once. Since 0.1.133.
+   */
+  blockQuery?: boolean | (() => boolean);
   /**
    * Configured default for the runtime `ignoreSortersWhenSearched` flag
    * (default `false`). Opt-in for relevance-ranked backends: while the
@@ -225,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
@@ -275,6 +309,8 @@ interface TablePresetOptions {
   draftHandle?: UseLocalDraftReturn | null;
   /** App-declared aspect set; default `['columns','filters','filterOps','sorters']`. */
   availableAspects?: PresetAspect[];
+  /** Aspects a system preset owns; intersected with `availableAspects`, default all. */
+  systemAspects?: PresetAspect[];
   /** Static fallback for system presets when no `presetsHandle` is wired. */
   fallbackSystemPresets?: SystemPreset[];
   /** Whether localStorage drafts should be hydrated + persisted on bootstrap. */
@@ -297,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 {
@@ -310,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`. */
@@ -320,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
@@ -330,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;
 /**
@@ -420,8 +484,12 @@ interface UseTableOptions {
   queryFn?: QueryFn;
   /** Auto-query when metadata loads (default: true). */
   queryOnMount?: boolean;
-  /** When true, all triggers (query/queryNext/loadRange) early-return. */
-  blockQuery?: boolean;
+  /**
+   * When true, all triggers (query/queryNext/loadRange) early-return. Pass a
+   * getter to keep it reactive — the held-back query runs once when it flips
+   * back to `false`. Since 0.1.133.
+   */
+  blockQuery?: boolean | (() => boolean);
   /** Page-alignment unit for `loadRange` and the `queryNext` extension. */
   blockSize?: number;
   /** Debounce window for the topIndex/viewportRowCount watcher. */
@@ -481,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.
@@ -489,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"> {
   /**
@@ -1982,6 +2155,14 @@ interface UseTableUrlQueryOptions {
    *   navigation-recoverable.
    */
   mode?: "replace" | "push";
+  /**
+   * Namespace for this table's query keys. With `prefix: "t1"` every key the
+   * bridge writes becomes `t1.<key>` (`t1.$skip`, `t1.status`, `t1.total>100`)
+   * and only keys under that prefix are read back or removed. Keys with no
+   * prefix — or another table's prefix — are foreign and preserved untouched,
+   * so two tables can share one route. Since 0.1.133.
+   */
+  prefix?: string;
 }
 /**
  * Bridge `<AsTableRoot v-model:url-query>` to vue-router. Uses **type-only**
@@ -1989,11 +2170,19 @@ interface UseTableUrlQueryOptions {
  * 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.
+ * Scope: the bridge owns **only what the table reads back** (since 0.1.133).
+ * A key is the table's iff `urlQueryStringToState` would consume it — see
+ * `urlQueryConsumesKey` — or the bridge has written it before. Read and
+ * write therefore agree in both directions: a key the parser ignores (a host
+ * flag, an unrecognised `$control`) is never removed, and a key the parser
+ * reads is the bridge's to remove. Every write merges into the current
+ * `route.query`, in place.
+ *
+ * Without a `prefix` the bridge cannot tell a plain `field=value` filter from
+ * a page-owned flag of the same shape, so a plain key that was already in the
+ * URL when the bridge mounted counts as foreign until the bridge writes it
+ * itself. Pass `prefix` when a route carries a host key that could collide
+ * with a column path, or when it carries two tables.
  *
  * @example
  * ```vue
@@ -2001,6 +2190,9 @@ interface UseTableUrlQueryOptions {
  * import { useRoute, useRouter } from 'vue-router';
  * import { useTableUrlQuery } from '@atscript/vue-table';
  * const urlQuery = useTableUrlQuery(useRoute(), useRouter());
+ * // Two tables on one route:
+ * // const left = useTableUrlQuery(useRoute(), useRouter(), { prefix: 'a' });
+ * // const right = useTableUrlQuery(useRoute(), useRouter(), { prefix: 'b' });
  * </script>
  * <template>
  *   <AsTableRoot v-model:url-query="urlQuery" url="/db/products" .../>
@@ -2157,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"`. */
@@ -2261,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[];
@@ -2286,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;
@@ -2310,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;
@@ -2320,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;
@@ -2335,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 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 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 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 };

package/dist/{as-table-status-Du4WLF4k.cjs → as-table-status-B2HPerJT.cjs}

@@ -1,8 +1,8 @@
-const require_use_table_state = require("./use-table-state-Oi2ds4_a.cjs");
-const require_use_table_component = require("./use-table-component-DO_kvKSf.cjs");
-const require_as_table_header_cell = require("./as-table-header-cell-CIqlO6Lw.cjs");
-const require_as_row_actions = require("./as-row-actions-Bm6Bzyno.cjs");
-const require_as_table_cell_value = require("./as-table-cell-value-D1JkTQt0.cjs");
+const require_use_table_state = require("./use-table-state-mhm-YWnu.cjs");
+const require_use_table_component = require("./use-table-component-DS5NJPzs.cjs");
+const require_as_table_header_cell = require("./as-table-header-cell-Bv6q5iKA.cjs");
+const require_as_row_actions = require("./as-row-actions-CRg8LHGk.cjs");
+const require_as_table_cell_value = require("./as-table-cell-value-BAi5yadc.cjs");
 let _atscript_ui = require("@atscript/ui");
 let vue = require("vue");
 //#region src/composables/use-cell-resolver.ts
@@ -532,6 +532,18 @@ var as_table_header_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			table.style.tableLayout = origTableLayout;
 			return measured;
 		}
+		/**
+		* The select-all control is a `role="checkbox"` span, not a `<button>`, so
+		* it gets no native key activation: bind Space (checkbox semantics) and
+		* Enter (the table's row-activation key) explicitly.
+		*/
+		function onSelectAllKeydown(event) {
+			if (event.key !== " " && event.key !== "Enter") return;
+			if (!props.selectAllState) return;
+			event.preventDefault();
+			event.stopPropagation();
+			emit("select-all-toggle", props.selectAllState);
+		}
 		return (_ctx, _cache) => {
 			return (0, vue.openBlock)(), (0, vue.createElementBlock)("thead", null, [(0, vue.createElementVNode)("tr", null, [
 				__props.hasSelectColumn ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("th", _hoisted_1$1, [__props.selectAllState ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", {
@@ -542,9 +554,11 @@ var as_table_header_default = /* @__PURE__ */ (0, vue.defineComponent)({
 					}]),
 					role: "checkbox",
 					tabindex: "0",
+					"aria-label": "Select all rows",
 					"aria-checked": __props.selectAllState === "none" ? "false" : __props.selectAllState === "all" ? "true" : "mixed",
-					onClick: _cache[0] || (_cache[0] = ($event) => emit("select-all-toggle", __props.selectAllState))
-				}, [__props.selectAllState === "all" ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", _hoisted_3$1)) : __props.selectAllState === "some" ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", _hoisted_4$1)) : (0, vue.createCommentVNode)("v-if", true)], 10, _hoisted_2$1)) : (0, vue.createCommentVNode)("v-if", true)])) : (0, vue.createCommentVNode)("v-if", true),
+					onClick: _cache[0] || (_cache[0] = ($event) => emit("select-all-toggle", __props.selectAllState)),
+					onKeydown: onSelectAllKeydown
+				}, [__props.selectAllState === "all" ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", _hoisted_3$1)) : __props.selectAllState === "some" ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", _hoisted_4$1)) : (0, vue.createCommentVNode)("v-if", true)], 42, _hoisted_2$1)) : (0, vue.createCommentVNode)("v-if", true)])) : (0, vue.createCommentVNode)("v-if", true),
 				((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, null, (0, vue.renderList)(__props.columns, (col) => {
 					return (0, vue.openBlock)(), (0, vue.createElementBlock)("th", {
 						key: col.path,
@@ -557,37 +571,39 @@ var as_table_header_default = /* @__PURE__ */ (0, vue.defineComponent)({
 						onDragover: ($event) => col.fixed ? void 0 : (0, vue.unref)(onHeaderDragOver)($event),
 						onDrop: ($event) => col.fixed ? void 0 : (0, vue.unref)(onHeaderDrop)($event),
 						onDragend: ($event) => col.fixed ? void 0 : (0, vue.unref)(onHeaderDragEnd)()
-					}, [!col.fixed ? (0, vue.renderSlot)(_ctx.$slots, `header-${col.path}`, {
-						key: 0,
-						column: col
-					}, () => [((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.resolveDynamicComponent)((0, vue.unref)(HeaderCell)), {
-						column: col,
-						"sort-direction": sortMap.value[col.path] ?? null,
-						filters: __props.filters?.[col.path],
-						"column-menu": __props.columnMenu,
-						"width-entry": __props.columnWidths[col.path],
-						onSort: _cache[1] || (_cache[1] = (c, d) => emit("sort", c, d)),
-						onHide: _cache[2] || (_cache[2] = (c) => emit("hide", c)),
-						onFilter: _cache[3] || (_cache[3] = (c) => emit("filter", c)),
-						onFiltersOff: _cache[4] || (_cache[4] = (c) => emit("filters-off", c)),
-						onResetWidth: _cache[5] || (_cache[5] = (c) => emit("reset-width", c))
-					}, null, 40, [
-						"column",
-						"sort-direction",
-						"filters",
-						"column-menu",
-						"width-entry"
-					]))]) : (0, vue.createCommentVNode)("v-if", true), __props.resizable && !col.fixed ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", {
-						key: 1,
-						class: "as-th-resize-handle",
-						draggable: "false",
-						onDragstart: _cache[6] || (_cache[6] = (0, vue.withModifiers)(() => {}, ["prevent", "stop"])),
-						onPointerdown: _cache[7] || (_cache[7] = (0, vue.withModifiers)((...args) => (0, vue.unref)(onResizeHandlePointerDown) && (0, vue.unref)(onResizeHandlePointerDown)(...args), ["stop"])),
-						onPointermove: _cache[8] || (_cache[8] = (...args) => (0, vue.unref)(onResizeHandlePointerMove) && (0, vue.unref)(onResizeHandlePointerMove)(...args)),
-						onPointerup: _cache[9] || (_cache[9] = (...args) => (0, vue.unref)(onResizeHandleEnd) && (0, vue.unref)(onResizeHandleEnd)(...args)),
-						onPointercancel: _cache[10] || (_cache[10] = (...args) => (0, vue.unref)(onResizeHandleEnd) && (0, vue.unref)(onResizeHandleEnd)(...args)),
-						onDblclick: _cache[11] || (_cache[11] = (0, vue.withModifiers)((...args) => (0, vue.unref)(onResizeHandleDoubleClick) && (0, vue.unref)(onResizeHandleDoubleClick)(...args), ["stop"]))
-					}, null, 32)) : (0, vue.createCommentVNode)("v-if", true)], 46, _hoisted_5$1);
+					}, [
+						(0, vue.createCommentVNode)(" An explicitly supplied `header-<path>` slot renders for fixed\n             (synthesised) columns too; only the DEFAULT header cell is\n             suppressed there, so `__actions` keeps its blank gutter unless\n             the consumer fills it. Reorder/resize stay disabled regardless. "),
+						(0, vue.renderSlot)(_ctx.$slots, `header-${col.path}`, { column: col }, () => [!col.fixed ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.resolveDynamicComponent)((0, vue.unref)(HeaderCell)), {
+							key: 0,
+							column: col,
+							"sort-direction": sortMap.value[col.path] ?? null,
+							filters: __props.filters?.[col.path],
+							"column-menu": __props.columnMenu,
+							"width-entry": __props.columnWidths[col.path],
+							onSort: _cache[1] || (_cache[1] = (c, d) => emit("sort", c, d)),
+							onHide: _cache[2] || (_cache[2] = (c) => emit("hide", c)),
+							onFilter: _cache[3] || (_cache[3] = (c) => emit("filter", c)),
+							onFiltersOff: _cache[4] || (_cache[4] = (c) => emit("filters-off", c)),
+							onResetWidth: _cache[5] || (_cache[5] = (c) => emit("reset-width", c))
+						}, null, 40, [
+							"column",
+							"sort-direction",
+							"filters",
+							"column-menu",
+							"width-entry"
+						])) : (0, vue.createCommentVNode)("v-if", true)]),
+						__props.resizable && !col.fixed ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", {
+							key: 0,
+							class: "as-th-resize-handle",
+							draggable: "false",
+							onDragstart: _cache[6] || (_cache[6] = (0, vue.withModifiers)(() => {}, ["prevent", "stop"])),
+							onPointerdown: _cache[7] || (_cache[7] = (0, vue.withModifiers)((...args) => (0, vue.unref)(onResizeHandlePointerDown) && (0, vue.unref)(onResizeHandlePointerDown)(...args), ["stop"])),
+							onPointermove: _cache[8] || (_cache[8] = (...args) => (0, vue.unref)(onResizeHandlePointerMove) && (0, vue.unref)(onResizeHandlePointerMove)(...args)),
+							onPointerup: _cache[9] || (_cache[9] = (...args) => (0, vue.unref)(onResizeHandleEnd) && (0, vue.unref)(onResizeHandleEnd)(...args)),
+							onPointercancel: _cache[10] || (_cache[10] = (...args) => (0, vue.unref)(onResizeHandleEnd) && (0, vue.unref)(onResizeHandleEnd)(...args)),
+							onDblclick: _cache[11] || (_cache[11] = (0, vue.withModifiers)((...args) => (0, vue.unref)(onResizeHandleDoubleClick) && (0, vue.unref)(onResizeHandleDoubleClick)(...args), ["stop"]))
+						}, null, 32)) : (0, vue.createCommentVNode)("v-if", true)
+					], 46, _hoisted_5$1);
 				}), 128)),
 				__props.withFiller ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("th", _hoisted_6$1)) : (0, vue.createCommentVNode)("v-if", true)
 			])]);