@atscript/vue-table 0.1.146 → 0.1.148

package/dist/index.mjs

@@ -1,37 +1,36 @@
-import { F as ROW_ACTIONS_TYPE, T as extractIdentifier, a as useTableContext, n as createTableState, o as useTableContextOptional, r as provideTableContext, t as createStaticTableState, v as resolveRowActions } from "./use-table-state-DuY-Mf8e.mjs";
+import { I as queryTargetGate, O as extractIdentifier, V as ROW_ACTIONS_TYPE, a as useTableContext, b as QUERY_TARGET_UNSUPPORTED_REASON, k as identifierFieldsOf, n as createTableState, o as useTableContextOptional, r as provideTableContext, t as createStaticTableState, v as resolveRowActions, x as actionIdentifiers } from "./use-table-state-CIoWhwTD.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-BTsNGBVx.mjs";
-import { t as useTableNavBridge } from "./use-table-nav-bridge-Bw0NFDSf.mjs";
-import { t as useTableComponent } from "./use-table-component-DRMXTk9M.mjs";
-import { t as as_cell_array_default } from "./as-cell-array-Bgc4GYZf.mjs";
-import { t as as_cell_date_default } from "./as-cell-date-B9mu0OOD.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-ByEGYRST.mjs";
-import { t as as_cell_number_default } from "./as-cell-number-CNDT6gfw.mjs";
+import { n as useTableSelection } from "./use-table-selection-CdaOPo1d.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-BYNBpLJt.mjs";
+import { n as useCellLocale, t as provideCellLocale } from "./use-cell-locale-BTJZ6UcP.mjs";
+import { t as useTableNavBridge } from "./use-table-nav-bridge-CJBERyPB.mjs";
+import { t as useTableComponent } from "./use-table-component-Dy397695.mjs";
+import { t as as_cell_array_default } from "./as-cell-array-CnoVd9ps.mjs";
+import { t as as_cell_date_default } from "./as-cell-date-dhIM7hWA.mjs";
+import { t as as_cell_json_default } from "./as-cell-json-ChN_NDhO.mjs";
+import { t as as_cell_number_default } from "./as-cell-number-D-mSaE_G.mjs";
 import { t as formatCellValue } from "./format-cell-D1Ziv96Q.mjs";
-import { t as as_cell_union_default } from "./as-cell-union-DMnoa7RM.mjs";
+import { t as as_cell_union_default } from "./as-cell-union-C9Bbnkrg.mjs";
 import { t as as_column_menu_default } from "./as-column-menu-CBtUfYEE.mjs";
-import { t as as_config_dialog_default } from "./as-config-dialog-ObHtungs.mjs";
-import { t as as_confirm_dialog_default } from "./as-confirm-dialog-zg7jmS3u.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-CWy0mjZl.mjs";
-import { t as as_table_header_cell_default } from "./as-table-header-cell-Csv1KQDa.mjs";
-import { t as as_window_table_default } from "./as-window-table-JOTOi_Nm.mjs";
-import { t as as_filter_field_default } from "./as-filter-field-CW1_GHZT.mjs";
-import { t as as_residual_filter_default } from "./as-residual-filter-CUTouIn5.mjs";
-import { t as as_filters_default } from "./as-filters-BLFSS_VP.mjs";
-import { t as as_preset_dialog_default } from "./as-preset-dialog-CI2Hw8vi.mjs";
-import { t as as_row_actions_default } from "./as-row-actions-ed1P6GEJ.mjs";
-import { t as as_table_cell_value_default } from "./as-table-cell-value-DoH8Mieo.mjs";
-import { t as as_table_root_default } from "./as-table-root-BreMYhnv.mjs";
-import { t as as_table_default } from "./as-table-DGWfzV4w.mjs";
-import { t as as_table_actions_default } from "./as-table-actions-DQco4pGu.mjs";
-import { t as as_preset_picker_default } from "./as-preset-picker-CbZDGPaf.mjs";
+import { t as as_config_dialog_default } from "./as-config-dialog-ZKMnfirD.mjs";
+import { t as as_confirm_dialog_default } from "./as-confirm-dialog-DMiGquH1.mjs";
+import { t as as_filter_field_default } from "./as-filter-field-DE6MJMx7.mjs";
+import { t as as_filter_input_default } from "./as-filter-input-DmOW_jzK.mjs";
+import { t as as_filter_dialog_default } from "./as-filter-dialog-DNFR30fV.mjs";
+import { t as as_table_header_cell_default } from "./as-table-header-cell-ahzAeHXj.mjs";
+import { t as as_window_table_default } from "./as-window-table-DjplqWzr.mjs";
+import { t as as_residual_filter_default } from "./as-residual-filter-DHfbtTQj.mjs";
+import { t as as_filters_default } from "./as-filters-DErM2bFq.mjs";
+import { t as as_preset_dialog_default } from "./as-preset-dialog-CY5dPfZa.mjs";
+import { t as as_row_actions_default } from "./as-row-actions-BNQ7jrie.mjs";
+import { t as as_table_cell_value_default } from "./as-table-cell-value-D-S127gr.mjs";
+import { t as as_table_root_default } from "./as-table-root-BnkF5-rh.mjs";
+import { t as as_table_default } from "./as-table-Bcz-WOTS.mjs";
+import { t as as_table_actions_default } from "./as-table-actions-DPq5SrGa.mjs";
+import { t as as_preset_picker_default } from "./as-preset-picker-DkZ7sinz.mjs";
 import { getDefaultClientFactory, resetDefaultClientFactory, setDefaultClientFactory } from "@atscript/ui";
 import { computed, effectScope, ref, shallowRef } from "vue";
-import { AppPrefsClient, ExportAbortError, PRESET_ASPECTS, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, collectExportRows, columnDefaultCondition, columnFilterConditions, columnFilterType, isFilled, isSystemPresetId, isUnavailableError, resolveExportValue, resolveSystemPresets, toCsv, urlQueryConsumesKey, withStableOrder } from "@atscript/ui-table";
-import { splitUrlSegments } from "@uniqu/url";
+import { AppPrefsClient, DEV, ExportAbortError, PRESET_ASPECTS, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, collectExportRows, columnFilter, isFilled, isSystemPresetId, isUnavailableError, leadingKey, mergeUrlQueryRecord, resolveExportValue, resolveSystemPresets, toCsv, urlQueryConsumesKey, urlQueryRecordToString, withStableOrder } from "@atscript/ui-table";
 import { StorageSerializers, useEventBus, useStorage } from "@vueuse/core";
 //#region src/composables/use-table-export.ts
 /**
@@ -71,13 +70,12 @@ function useTableExport(ctx) {
 	}
 	/**
 	* One value resolver per column, built once per run: the formatter lookup
-	* and the union-option index happen here instead of per cell.
+	* happens here instead of per cell (union-option labels are Map-backed in `optionLabel`).
 	*/
 	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) {
@@ -88,11 +86,7 @@ function useTableExport(ctx) {
 					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);
+				return resolveExportValue(raw, column);
 			};
 		});
 	}
@@ -198,9 +192,7 @@ function rawColumn(path) {
 * Accepts `state` directly rather than injecting — safe to call outside `setup`.
 */
 function useTableFilter(column, state) {
-	const filterType = columnFilterType(column.type);
-	const availableConditions = columnFilterConditions(column);
-	const defCondition = columnDefaultCondition(column);
+	const { kind: filterType, conditions: availableConditions, defaultCondition: defCondition } = columnFilter(column);
 	function cloneConditions() {
 		const existing = state.filters.value[column.path];
 		if (existing && existing.length > 0) return existing.map((c) => ({
@@ -294,26 +286,11 @@ function useTableActions() {
 }
 //#endregion
 //#region src/composables/use-table-url-query.ts
-const KEY_CHAR = /[A-Za-z0-9_.$-]/;
-/**
-* Index of `=` if every char before it is URL-key-safe. Returns -1 when any
-* non-key char (uniqu operator, whitespace, etc.) appears first — those
-* segments must round-trip as a single bare key because vue-router's `query`
-* record has no encoding for non-`=` separators.
-*/
-function findCleanEq(segment) {
-	for (let i = 0; i < segment.length; i++) {
-		const c = segment[i];
-		if (c === "=") return i > 0 ? i : -1;
-		if (!KEY_CHAR.test(c)) return -1;
-	}
-	return -1;
-}
 /**
-* Bridge `<AsTableRoot v-model:url-query>` to vue-router. Uses **type-only**
-* imports of `Router` and `RouteLocationNormalizedLoaded` — no runtime
-* dependency on `vue-router` is added to `@atscript/vue-table`. Consumers
-* pass in their already-resolved `useRoute()` and `useRouter()` instances.
+* Bridge `<AsTableRoot v-model:url-query>` to a router. Takes the structural
+* {@link TableUrlQueryRoute} / {@link TableUrlQueryRouter} slices, so
+* `@atscript/vue-table` imports nothing from `vue-router`: consumers pass
+* their already-resolved `useRoute()` and `useRouter()` instances.
 *
 * 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
@@ -325,10 +302,11 @@ function findCleanEq(segment) {
 * written as one block in the table's order.
 *
 * 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.
+* a page-owned flag of the same shape: the table reads every unprefixed key,
+* so a host key that is also a column path becomes a user filter. Pass
+* `preserveKeys` to fence such host keys off (or `prefix` to namespace the
+* table, which changes its URLs), and `prefix` when a route carries two
+* tables.
 *
 * @example
 * ```vue
@@ -346,47 +324,47 @@ function findCleanEq(segment) {
 * ```
 */
 function useTableUrlQuery(route, router, opts = {}) {
-	const navigate = (opts.mode ?? "replace") === "push" ? router.push.bind(router) : router.replace.bind(router);
+	const usePush = (opts.mode ?? "replace") === "push";
+	if (usePush && typeof router.push !== "function") throw new TypeError("[vue-table] useTableUrlQuery: mode \"push\" needs router.push.");
+	const navigate = (query) => usePush ? router.push?.({ query }) : router.replace({ query });
 	const prefix = opts.prefix ? `${opts.prefix}.` : "";
+	const recordOpts = {
+		prefix: opts.prefix,
+		preserveKeys: opts.preserveKeys
+	};
 	const written = /* @__PURE__ */ new Set();
 	function isOwn(key) {
 		if (prefix) return key.startsWith(prefix);
 		return written.has(key) || urlQueryConsumesKey(key);
 	}
+	let withheld;
+	const warned = /* @__PURE__ */ new Set();
 	return computed({
 		get: () => {
-			const q = route.query;
-			const parts = [];
-			for (const key in q) {
-				if (prefix && !key.startsWith(prefix)) continue;
-				const own = prefix ? key.slice(prefix.length) : key;
-				const v = q[key];
-				if (Array.isArray(v)) for (const item of v) parts.push(item == null ? own : `${own}=${item}`);
-				else if (v == null) parts.push(own);
-				else parts.push(`${own}=${v}`);
-			}
-			return parts.join("&");
+			const own = urlQueryRecordToString(route.query, recordOpts);
+			if (!withheld) return own;
+			if (own === withheld.expectedOwn) return withheld.lastSet;
+			return [own, ...withheld.held].filter(Boolean).join("&");
 		},
 		set: (urlString) => {
-			const serialized = /* @__PURE__ */ new Map();
-			for (const segment of splitUrlSegments(urlString)) {
-				if (!segment) continue;
-				const eqIdx = findCleanEq(segment);
-				const key = eqIdx > 0 ? `${prefix}${segment.slice(0, eqIdx)}` : `${prefix}${segment}`;
-				serialized.set(key, eqIdx > 0 ? segment.slice(eqIdx + 1) : null);
-				written.add(key);
+			const merged = mergeUrlQueryRecord(route.query, urlString, {
+				...recordOpts,
+				isOwn
+			});
+			const { query } = merged;
+			for (const key of merged.own) written.add(key);
+			withheld = merged.withheld.length ? {
+				held: merged.withheld,
+				lastSet: urlString,
+				expectedOwn: urlQueryRecordToString(query, recordOpts)
+			} : void 0;
+			if (DEV) for (const segment of merged.withheld) {
+				const name = leadingKey(segment) || segment;
+				if (warned.has(name)) continue;
+				warned.add(name);
+				console.warn(`[vue-table] useTableUrlQuery: "${name}" is in preserveKeys, so the table's own "${name}" filter is kept private and is not written to the URL.`);
 			}
-			const query = {};
-			let placed = false;
-			const place = () => {
-				if (placed) return;
-				placed = true;
-				for (const [key, value] of serialized) query[key] = value;
-			};
-			for (const key in route.query) if (isOwn(key)) place();
-			else query[key] = route.query[key];
-			place();
-			navigate({ query });
+			navigate(query);
 		}
 	});
 }
@@ -658,4 +636,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, 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, resolveRowActions, resolveSystemPresets, setDefaultClientFactory, useAppPrefs, useCellLocale, useLocalDraft, usePresets, useTable, useTableActions, useTableComponent, useTableContext, useTableContextOptional, useTableExport, 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, QUERY_TARGET_UNSUPPORTED_REASON, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, actionIdentifiers, clearTableCache, createDefaultCellTypes, createDefaultControls, createStaticTableState, createTableState, downloadExport, extractIdentifier, formatCellValue, getCellValue, getColumnWidth, getDefaultClientFactory, identifierFieldsOf, injectPresetsApp, isSystemPresetId, provideCellLocale, provideTableContext, queryTargetGate, resetDefaultClientFactory, resolveRowActions, resolveSystemPresets, setDefaultClientFactory, useAppPrefs, useCellLocale, useLocalDraft, usePresets, useTable, useTableActions, useTableComponent, useTableContext, useTableContextOptional, useTableExport, useTableFilter, useTableNavBridge, useTableSearch, useTableSelection, useTableUrlQuery };

package/dist/{types-D1NxhrpW.d.cts → intent-scope-CGch9yhy.d.cts}

@@ -1,37 +1,9 @@
 import { Component, ComputedRef, MaybeRefOrGetter, Ref, ShallowRef } from "vue";
 import { ColumnDef, PaginationControl, SortControl, TableDef } from "@atscript/ui";
-import { ClientError, PageResult, TDbActionInfo, TDbActionProcessor, TDbDeleteResult } from "@atscript/db-client";
+import { ClientError, PageResult, TDbActionInfo, TDbActionProcessor, TDbActionTargetSummary, TDbDeleteResult, TDbQueryTarget } from "@atscript/db-client";
+import { AsPresetEntryRow, AspectMask, ColumnWidthsMap, ConfigTab, DroppedFields, FieldFilters, PresetAspect, PresetCapabilities, PresetSnapshot, SelectionMode, SelectionQuery, SystemPreset, SystemPresetInput, TableStateMethods } from "@atscript/ui-table";
 import { FilterExpr, Uniquery } from "@uniqu/core";
-import { AsPresetEntryRow, AspectMask, ColumnWidthsMap, ConfigTab, DroppedFields, FieldFilters, PresetAspect, PresetCapabilities, PresetSnapshot, SelectionMode, SystemPreset, SystemPresetInput, TableStateMethods } from "@atscript/ui-table";
 
-//#region src/composables/state/intent-scope.d.ts
-/**
- * Per-action verdict of a gate: `true` keeps the action as is, `false` drops
- * it (hidden), a non-empty string keeps it DISABLED with that string as the
- * reason (`""` counts as `true`).
- */
-type ActionVerdict = boolean | string;
-type ActionGate = (a: TVueTableActionInfo) => ActionVerdict;
-interface ActionBuckets {
-  default: TVueTableActionInfo | undefined;
-  others: TVueTableActionInfo[];
-  rows: TVueTableActionInfo[];
-}
-/**
- * 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/composables/state/row-actions-config.d.ts
 /**
  * A {@link RowActionsConfig} compiled into the two passes a surface runs per
@@ -117,6 +89,65 @@ interface InvokeOpts {
    * Since 0.1.134.
    */
   row?: Record<string, unknown>;
+  /**
+   * Run a `'rows'` action on every row matching this query instead of on
+   * `pk` (pass `pk` as `undefined`): `client.actionOnQuery`. The action's
+   * `/meta` entry must carry `queryTarget`. Since 0.1.147.
+   */
+  target?: ActionQueryTarget;
+  /**
+   * With `target`: the match count the user confirmed. The server answers
+   * `TARGET_CHANGED` when the query matches a different number of rows by
+   * the time it runs. Since 0.1.147.
+   */
+  expectCount?: number;
+  /**
+   * With `target` + `expectCount`: asked once with the new count when the
+   * server answers `TARGET_CHANGED`. Resolve `true` to run again on the new
+   * count; `false` settles the action as that error. Since 0.1.147.
+   */
+  confirmTargetChange?: (matched: number) => Promise<boolean>;
+}
+/**
+ * "Every row matching this query, minus `exclude`" — the target of a
+ * query-targeted action run (`InvokeOpts.target`). The `filter` / `search`
+ * / `index` of the table's query, never its sorting or paging. Since 0.1.147.
+ */
+type ActionQueryTarget = Pick<TDbQueryTarget, "filter" | "search" | "index" | "exclude" | "maxRows">;
+/**
+ * A symbolic selection of every row matching the table's query (the "Select
+ * all N matching" banner), held in `state.querySelection`. Since 0.1.147.
+ */
+interface QuerySelection {
+  /** The filter / search / index the selection was made over. */
+  query: SelectionQuery;
+  /** `selectionSignature(query)` — a change of the live one drops the selection. */
+  signature: string;
+  /** `rowValueFn` values the user unticked after selecting all. */
+  excluded: unknown[];
+  /** Rows the query matched (`totalCount`), refreshed on same-scope refetches. */
+  total: number;
+}
+/**
+ * The selection as one value (`state.selection`): explicit row values, or
+ * every row matching a query minus the excluded ones. `count` is what the
+ * selection covers in both modes. Since 0.1.147.
+ */
+type TableSelection = {
+  mode: "ids";
+  ids: unknown[];
+  count: number;
+} | {
+  mode: "query";
+  query: SelectionQuery;
+  excluded: unknown[];
+  total: number;
+  count: number;
+};
+/** Why the table dropped a selection on its own (`selection-reset`). Since 0.1.147. */
+interface SelectionResetEvent {
+  /** `"scope"` — the filter, search or index changed under a query selection. */
+  reason: "scope";
 }
 /**
  * A row action the APP owns — it has no server counterpart, so the backend
@@ -185,6 +216,15 @@ type ActionResult = {
   kind: "backend";
   data: unknown;
   message?: string;
+  /**
+   * A query-targeted run (`InvokeOpts.target`): how many rows the query
+   * matched, and the handler's `TDbActionTargetSummary` when it returned
+   * one (a delegated action always does). Since 0.1.147.
+   */
+  target?: {
+    matched: number;
+    summary?: TDbActionTargetSummary;
+  };
 } | {
   ok: true;
   kind: "navigate";
@@ -235,6 +275,14 @@ interface TableActionsState {
    * `{ id: '...' }`.
    */
   invoke: (action: TVueTableActionInfo, pk?: Record<string, unknown> | Record<string, unknown>[], opts?: InvokeOpts) => Promise<ActionResult>;
+  /**
+   * How many rows a query-targeted run of `action` would cover right now
+   * (`client.countActionTarget` — a dry run, the handler does not run).
+   * Resolves `undefined` when the count failed; that failure is settled as
+   * the action's error result (`lastResult` + the `@action` emit), like an
+   * invoke. Since 0.1.147.
+   */
+  countTarget: (action: TVueTableActionInfo, target: ActionQueryTarget, event?: KeyboardEvent | MouseEvent) => Promise<number | undefined>;
   /** Set of action names with an in-flight invoke. */
   invoking: ShallowRef<Set<string>>;
   /** Latest result keyed by action name. */
@@ -305,6 +353,11 @@ interface ActionFormRequest {
   /** Identifier objects for the targeted rows (used by `$1`/`$N` substitution in dialog copy). */
   identifiers: Record<string, unknown>[];
   preferredId: readonly string[];
+  /**
+   * A query-targeted run: how many rows it covers (`identifiers` is empty
+   * then). The dialog shows it in the title. Since 0.1.147.
+   */
+  count?: number;
   /** Internal — the dialog never calls this directly; use accept/dismiss. */
   resolve: (input: unknown) => void;
 }
@@ -533,6 +586,19 @@ interface ReactiveTableState extends TableStateMethods {
    * when present, otherwise type+`@expect.maxLen`-derived (see `computeDefaultColumnWidth`).
    */
   columnWidths: Ref<ColumnWidthsMap>;
+  /**
+   * The app-authored `forceFilters` scope, read live. For chrome such as a
+   * "scoped to ..." badge. Since 0.1.148.
+   */
+  forceFilters: ComputedRef<FilterExpr | undefined>;
+  /** The app-authored `forceSorters`, read live (empty when none). Since 0.1.148. */
+  forceSorters: ComputedRef<SortControl[]>;
+  /**
+   * The IANA time zone the table reads dates in (`undefined` = the browser's):
+   * the `timeZone` option, else the cell locale's. Date filters, their chips
+   * and their inputs all follow it. Since 0.1.148.
+   */
+  timeZone: ComputedRef<string | undefined>;
   filterFields: ShallowRef<string[]>;
   filters: ShallowRef<FieldFilters>;
   /**
@@ -693,15 +759,62 @@ interface ReactiveTableState extends TableStateMethods {
   deselectAll: (rows: readonly Record<string, unknown>[]) => void;
   /**
    * The header checkbox's action over `rows`: deselect them when every
-   * eligible one is selected, otherwise select them. Since 0.1.142.
+   * eligible one is selected, otherwise select them. In a query selection
+   * a fully selected `rows` ends it. `indexOf` as in `selectAll` (since
+   * 0.1.147). Since 0.1.142.
    */
-  toggleAll: (rows: readonly Record<string, unknown>[]) => void;
+  toggleAll: (rows: readonly Record<string, unknown>[], indexOf?: (position: number) => number) => void;
   /**
    * Empty the selection — every pk, whether or not its row is loaded or
    * eligible. The header checkbox only ever acts on loaded rows; this is the
-   * real clear. Since 0.1.142.
+   * real clear. Ends a query selection too. Since 0.1.142.
    */
   clearSelection: () => void;
+  /**
+   * The symbolic "every row matching the query" selection, or `null` while
+   * the selection is the explicit `selectedRows` (bound by
+   * `v-model:query-selection` on `<AsTableRoot>`). While set, `selectedRows`
+   * is empty, row toggles edit `excluded`, `isPkSelected` is "not excluded"
+   * and `selectedCount` is `total − excluded.length`. Dropped (with a
+   * `selection-reset` `{ reason: "scope" }`) as soon as the filter, search
+   * or index changes — sorting, columns, paging and scrolling keep it. A
+   * successful query-targeted action clears it. Since 0.1.147.
+   */
+  querySelection: Ref<QuerySelection | null>;
+  /** The selection as one value, in either mode — see {@link TableSelection}. Since 0.1.147. */
+  selection: ComputedRef<TableSelection>;
+  /**
+   * Opt-in for selecting every row matching the query — writable ref owned
+   * by `<AsTableRoot>`'s `select-all-matching` prop (default `false`).
+   * Since 0.1.147.
+   */
+  allowSelectAllMatching: Ref<boolean>;
+  /**
+   * The renderer's `select` mode — writable ref pushed by `<AsTable>` /
+   * `<AsWindowTable>` (default `"none"`). Since 0.1.147.
+   */
+  selectMode: Ref<SelectionMode>;
+  /**
+   * `rowValueFn` values of the LOADED rows the `rowSelectable` predicate
+   * lets through — the set "all rows on this page" covers (every cached row
+   * in window mode). Since 0.1.147.
+   */
+  loadedEligiblePks: ComputedRef<unknown[]>;
+  /** How many of `loadedEligiblePks` are selected. Since 0.1.147. */
+  loadedSelectedCount: ComputedRef<number>;
+  /**
+   * Whether "Select all N matching" can be offered: `allowSelectAllMatching`
+   * ∧ `selectMode === "multi"` ∧ a server-backed table (no custom query
+   * function, not local mode) ∧ more matching rows than loaded ones
+   * ∧ at least one `'rows'` action that takes a query target. Since 0.1.147.
+   */
+  canSelectAllMatching: ComputedRef<boolean>;
+  /**
+   * Select every row matching the current query (filter, search, index —
+   * force filters and custom filter conditions included). A no-op unless
+   * {@link canSelectAllMatching}. Since 0.1.147.
+   */
+  selectAllMatching: () => void;
   /** Column currently open in the filter dialog (null when closed). */
   filterDialogColumn: Ref<ColumnDef | null>;
   /** Absolute index of the keyboard-active row. -1 = nothing active. */
@@ -793,7 +906,8 @@ interface ReactiveTableState extends TableStateMethods {
    */
   requestActionInput: (action: TVueTableActionInfo, ctx: {
     identifiers: Record<string, unknown>[];
-    preferredId: readonly string[];
+    preferredId: readonly string[]; /** A query-targeted run's row count (since 0.1.147). */
+    count?: number;
   }) => Promise<unknown>;
   /** Resolve the active form request with `input`. Internal — used by the dialog. */
   acceptActionForm: (input: unknown) => void;
@@ -1012,4 +1126,70 @@ interface PresetSurface {
   lastError: Ref<Error | null>;
 }
 //#endregion
-export { TableNavBridge as A, RowSelectableVerdict as C, TAsTableControls as D, TAsCellTypeComponents as E, extractIdentifier as M, TVueTableActionInfo as O, RowSelectableHook as S, SelectOn as T, RowActionsConfig as _, ConfirmOptions as a, RowDeleteOpt as b, InvokeOpts as c, NavKeyOptions as d, PresetConfig as f, RowActionsColumnPlacement as g, ResolvedRowActions as h, ConfigTab as i, resolveRowActions as j, TableActionsState as k, LocalRowAction as l, ReactiveTableState as m, ApplyUrlQueryOptions as n, DroppedFieldsReport as o, QueryErrorKind as p, ColumnMenuConfig as r, EnterAction as s, ActionResult as t, MainActionRequest as u, RowAttrsHook as v, SelectAllState as w, RowHookContext as x, RowClassHook as y };
+//#region src/composables/state/intent-scope.d.ts
+/**
+ * Per-action verdict of a gate: `true` keeps the action as is, `false` drops
+ * it (hidden), a non-empty string keeps it DISABLED with that string as the
+ * reason (`""` counts as `true`).
+ */
+type ActionVerdict = boolean | string;
+type ActionGate = (a: TVueTableActionInfo) => ActionVerdict;
+interface ActionBuckets {
+  default: TVueTableActionInfo | undefined;
+  others: TVueTableActionInfo[];
+  rows: TVueTableActionInfo[];
+}
+/** Disabled reason of a non-query-target action in a query selection. Since 0.1.147. */
+declare const QUERY_TARGET_UNSUPPORTED_REASON = "Not available for all matching rows \u2014 select rows individually";
+/**
+ * The gate a query selection ("every row matching the query") puts on the
+ * `'rows'` actions: enabled iff the action takes a query target
+ * (`queryTarget`) of at least `count` rows; otherwise kept DISABLED with the
+ * reason ({@link QUERY_TARGET_UNSUPPORTED_REASON}, or "At most {max} rows").
+ * The loaded rows' `$actions` are deliberately not consulted — a sample of
+ * the matching rows cannot speak for the rest; the server gates every row
+ * when the action runs. Since 0.1.147.
+ */
+declare function queryTargetGate(count: number): ActionGate;
+/**
+ * The fields an action identifier is built from — `tableDef.identifierFields`
+ * (`preferredId` plus every delegated action's `idMap` path), falling back to
+ * `preferredId` for a hand-built `TableDef` without it. Since 0.1.147.
+ */
+declare function identifierFieldsOf(def: TableDef | null | undefined): readonly string[];
+/**
+ * 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 the `fields` (a dot
+ *   path keeps the row's nesting: `ref.key` → `{ ref: { key } }`);
+ * - a scalar value when `fields` has exactly one entry (consumers that
+ *   override `rowValueFn` to return the PK scalar) → wraps it.
+ *
+ * `fields` is usually `identifierFields` (see {@link identifierFieldsOf}), so
+ * the identifier carries what a delegated action maps from; each action then
+ * takes the part it needs ({@link actionIdentifiers}).
+ *
+ * Returns `undefined` when `fields` is empty, the source is
+ * `null`/`undefined`, or a scalar can't be paired with a single field.
+ */
+declare function extractIdentifier(source: unknown, fields: readonly string[]): Record<string, unknown> | undefined;
+/**
+ * The identifiers `action` is sent, from the table's identifiers (built
+ * from `identifierFields`): a delegated action (`idMap`) keeps exactly its
+ * map's paths — the client maps them to the owner's identification — any
+ * other action exactly the `preferredId` fields, the identification the
+ * server validates. No fields → no identifiers. Identifiers already in that
+ * shape come back as the same array. Since 0.1.147.
+ */
+declare function actionIdentifiers(action: Pick<TVueTableActionInfo, "idMap">, ids: Record<string, unknown>[], preferredId: readonly string[]): Record<string, unknown>[];
+/**
+ * The query a query selection targets, with the excluded rows' identifiers
+ * (built from `identifierFields`) — see `PromptCtx.target`. Since 0.1.147.
+ */
+type PromptTarget = SelectionQuery & {
+  exclude: Record<string, unknown>[];
+};
+//#endregion
+export { RowSelectableHook as A, TableSelection as B, ResolvedRowActions as C, RowClassHook as D, RowAttrsHook as E, TAsCellTypeComponents as F, TAsTableControls as I, TVueTableActionInfo as L, SelectAllState as M, SelectOn as N, RowDeleteOpt as O, SelectionResetEvent as P, TableActionsState as R, ReactiveTableState as S, RowActionsConfig as T, resolveRowActions as V, MainActionRequest as _, identifierFieldsOf as a, QueryErrorKind as b, ActionResult as c, ConfigTab as d, ConfirmOptions as f, LocalRowAction as g, InvokeOpts as h, extractIdentifier as i, RowSelectableVerdict as j, RowHookContext as k, ApplyUrlQueryOptions as l, EnterAction as m, QUERY_TARGET_UNSUPPORTED_REASON as n, queryTargetGate as o, DroppedFieldsReport as p, actionIdentifiers as r, ActionQueryTarget as s, PromptTarget as t, ColumnMenuConfig as u, NavKeyOptions as v, RowActionsColumnPlacement as w, QuerySelection as x, PresetConfig as y, TableNavBridge as z };