@atscript/vue-table 0.1.132 → 0.1.133

package/dist/index.mjs

@@ -1,8 +1,8 @@
-import { a as useTableContext, m as extractIdentifier, n as createTableState, o as useTableContextOptional, t as createStaticTableState, x as ROW_ACTIONS_TYPE } from "./use-table-state-BxX3SpeW.mjs";
+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-CyFcVtUN.mjs";
-import { t as useTableNavBridge } from "./use-table-nav-bridge-DeGeaQX-.mjs";
-import { t as useTableComponent } from "./use-table-component-K6xj1obF.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";
@@ -12,24 +12,24 @@ 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-BehfqIGd.mjs";
-import { t as as_confirm_dialog_default } from "./as-confirm-dialog-bpN4A-KN.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-D1qzq-8b.mjs";
-import { t as as_table_header_cell_default } from "./as-table-header-cell-Bdhl5Lox.mjs";
-import { t as as_window_table_default } from "./as-window-table-DWujiUQy.mjs";
-import { t as as_filter_field_default } from "./as-filter-field-DirBmnbb.mjs";
-import { t as as_filters_default } from "./as-filters-beIud9sF.mjs";
-import { t as as_preset_dialog_default } from "./as-preset-dialog-CDqCAR7N.mjs";
-import { t as as_row_actions_default } from "./as-row-actions-xqJeAdQl.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-BLReUbRH.mjs";
-import { t as as_table_default } from "./as-table-CDSG2yED.mjs";
-import { t as as_table_actions_default } from "./as-table-actions-DMxeaczm.mjs";
-import { t as as_preset_picker_default } from "./as-preset-picker-CISaxEZ0.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 { 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, isAuthError, isFilled, isSystemPresetId, resolveSystemPresets } from "@atscript/ui-table";
+import { AppPrefsClient, PRESET_ASPECTS, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, columnFilterType, conditionsForType, defaultCondition, isFilled, isSystemPresetId, isUnavailableError, resolveSystemPresets, urlQueryConsumesKey } from "@atscript/ui-table";
 import { StorageSerializers, useEventBus, useStorage } from "@vueuse/core";
 //#region src/composables/use-table-filter.ts
 /**
@@ -187,11 +187,19 @@ function findCleanEq(segment) {
 * 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
@@ -199,6 +207,9 @@ function findCleanEq(segment) {
 * 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" .../>
@@ -207,25 +218,46 @@ function findCleanEq(segment) {
 */
 function useTableUrlQuery(route, router, opts = {}) {
 	const navigate = (opts.mode ?? "replace") === "push" ? router.push.bind(router) : router.replace.bind(router);
+	const prefix = opts.prefix ? `${opts.prefix}.` : "";
+	const written = /* @__PURE__ */ new Set();
+	function isOwn(key) {
+		if (prefix) return key.startsWith(prefix);
+		return written.has(key) || urlQueryConsumesKey(key);
+	}
 	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 ? key : `${key}=${item}`);
-				else if (v == null) parts.push(key);
-				else parts.push(`${key}=${v}`);
+				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("&");
 		},
 		set: (urlString) => {
-			const query = {};
+			const serialized = /* @__PURE__ */ new Map();
 			for (const segment of splitSegments(urlString)) {
 				const eqIdx = findCleanEq(segment);
-				if (eqIdx > 0) query[segment.slice(0, eqIdx)] = segment.slice(eqIdx + 1);
-				else query[segment] = null;
+				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 query = {};
+			for (const key in route.query) {
+				if (!isOwn(key)) {
+					query[key] = route.query[key];
+					continue;
+				}
+				if (serialized.has(key)) {
+					query[key] = serialized.get(key);
+					serialized.delete(key);
+				}
 			}
+			for (const [key, value] of serialized) query[key] = value;
 			navigate({ query });
 		}
 	});
@@ -316,7 +348,7 @@ function createInstance(app, opts) {
 				cache.value = { ...result.prefs };
 				existing.value = result.row;
 			} catch (err) {
-				if (isAuthError(err)) {
+				if (isUnavailableError(err)) {
 					denied.value = true;
 					clearCache();
 					existing.value = null;

package/dist/{types-CTMxE_zA.d.cts → types-BZ0HssRY.d.cts}

@@ -1,4 +1,4 @@
-import { Component, ComputedRef, Ref, ShallowRef } from "vue";
+import { Component, ComputedRef, MaybeRefOrGetter, Ref, ShallowRef } from "vue";
 import { ClientError, TDbActionInfo, TDbActionProcessor, TDbDeleteResult } from "@atscript/db-client";
 import { ColumnDef, PaginationControl, SortControl, TableDef } from "@atscript/ui";
 import { AsPresetEntryRow, AspectMask, ColumnWidthsMap, ConfigTab, FieldFilters, PresetAspect, PresetCapabilities, PresetSnapshot, SelectionMode, SystemPreset, SystemPresetInput, TableStateMethods } from "@atscript/ui-table";
@@ -190,14 +190,62 @@ interface PresetConfig {
    * Add `'itemsPerPage'` for paginated tables; drop any aspect this app doesn't use.
    */
   aspects?: PresetAspect[];
+  /**
+   * Aspects a SYSTEM preset owns. Intersected with `aspects`; defaults to all
+   * of them. Narrow it to e.g. `['filterOps']` when system presets are
+   * filter-only views that must not reset the user's columns, displayed
+   * filters, sorters or page size. Since 0.1.133.
+   */
+  systemAspects?: PresetAspect[];
   /**
    * Opt-in localStorage overlay for the user's in-flight tweaks (default
    * `false`). Persists `columns` / `filters` / `sorters` / opt-in
    * `itemsPerPage`; `filterOps` / `searchTerm` / pagination are NOT persisted.
    */
   persistDrafts?: boolean;
+  /**
+   * Identity the draft is stored under — pass the signed-in user's id
+   * whenever `persistDrafts` is on, so a shared browser never restores the
+   * previous user's draft. Omitted keeps the pre-0.1.133 unscoped key.
+   * Since 0.1.133.
+   */
+  draftScope?: MaybeRefOrGetter<string | undefined>;
 }
 type QueryErrorKind = "initial" | "query" | "queryNext" | "loadRange";
+/**
+ * Context handed to the per-row hooks of `<AsTable>` (`rowSelectable`,
+ * `rowClass`, `rowAttrs`). Since 0.1.133.
+ */
+interface RowHookContext {
+  /** Position of the row in the rows the renderer is currently rendering. */
+  index: number;
+  /**
+   * Whether the row's pk is in `state.selectedRows` right now. A getter —
+   * reading it subscribes that hook call to the selection, so predicates
+   * that ignore it are not re-run when the selection changes.
+   */
+  readonly selected: boolean;
+}
+/**
+ * Per-row selectability predicate. Return `false` — or a string, which is
+ * surfaced as the disabled reason on the selection control — to make the row
+ * not selectable; `true` (or omitting the prop) keeps it selectable.
+ * Since 0.1.133.
+ */
+type RowSelectableHook = (row: Record<string, unknown>, ctx: RowHookContext) => boolean | string | undefined | void;
+/** Extra classes for the row element. Since 0.1.133. */
+type RowClassHook = (row: Record<string, unknown>, ctx: RowHookContext) => string | string[] | Record<string, boolean> | undefined;
+/**
+ * Extra attributes for the row element. The framework's own `id`, `role`,
+ * `aria-*`, `data-*`, `class` and `style` always win. Since 0.1.133.
+ */
+type RowAttrsHook = (row: Record<string, unknown>, ctx: RowHookContext) => Record<string, unknown> | undefined;
+/** Normalised {@link RowSelectableHook} verdict. */
+interface RowSelectableVerdict {
+  ok: boolean;
+  /** Disabled reason, when the predicate returned a string. */
+  reason?: string;
+}
 /** Controls which sections appear in the column header dropdown menu. */
 interface ColumnMenuConfig {
   sort?: boolean;
@@ -373,6 +421,31 @@ interface ReactiveTableState extends TableStateMethods {
    * naturally without consulting mode.
    */
   isPkSelected: (pk: unknown) => boolean;
+  /**
+   * Per-row selectability predicate — writable ref owned by the renderer,
+   * like {@link rowDelete}. `<AsTable>` / `<AsWindowTable>` push their
+   * `:row-selectable` prop into it, and every selection path in the model
+   * gates on it. Since 0.1.133.
+   */
+  rowSelectable: Ref<RowSelectableHook | undefined>;
+  /**
+   * Normalised `rowSelectable` verdict for one row. `index` is the row's
+   * position in what the renderer renders (absolute in window mode).
+   * Since 0.1.133.
+   */
+  isRowSelectable: (row: Record<string, unknown>, index: number) => RowSelectableVerdict;
+  /** The subset of `rows` the `rowSelectable` predicate lets through. Since 0.1.133. */
+  selectableRows: (rows: readonly Record<string, unknown>[]) => Record<string, unknown>[];
+  /** How many of `rows` the `rowSelectable` predicate lets through. Since 0.1.133. */
+  selectableCount: (rows: readonly Record<string, unknown>[]) => number;
+  /**
+   * Select every eligible row in `rows`. An ineligible row that is already
+   * selected stays selected. `indexOf` maps a position in `rows` to the
+   * index the `rowSelectable` predicate sees — windowed callers pass it
+   * because their rows come from a cache keyed by absolute index.
+   * Since 0.1.133.
+   */
+  selectAll: (rows: readonly Record<string, unknown>[], indexOf?: (position: number) => number) => 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. */
@@ -398,7 +471,10 @@ interface ReactiveTableState extends TableStateMethods {
   setActive: (absIndex: number) => void;
   /** Reset the active-row index to `-1`. */
   clearActive: () => void;
-  /** Toggle selection of the active row's PK in `selectedRows`. */
+  /**
+   * Toggle selection of the active row's PK in `selectedRows`. No-op in
+   * `select="none"` and on a row the `rowSelectable` predicate rejects.
+   */
   toggleActiveSelection: (mode: SelectionMode) => void;
   /** Ask the rendering component to emit `main-action` for the active row. */
   requestMainAction: (event: KeyboardEvent | MouseEvent) => void;
@@ -415,6 +491,12 @@ interface ReactiveTableState extends TableStateMethods {
    * consumers should not mutate directly.
    */
   confirmRequest: Ref<ConfirmRequest | null>;
+  /**
+   * The prompt request the dialog SURFACE renders: the last non-null
+   * `confirmRequest`, retained after it is answered so the copy survives the
+   * exit animation. Internal — used by the dialog. @since 0.1.133
+   */
+  confirmDisplay: Ref<ConfirmRequest | null>;
   /**
    * Open the in-app confirm dialog with `message` as the body. Resolves
    * `true` on accept, `false` on cancel/dismiss. Public — consumers can
@@ -431,12 +513,24 @@ interface ReactiveTableState extends TableStateMethods {
   acceptPrompt: () => void;
   /** Resolve the active prompt with `false`. Internal — used by the dialog. */
   dismissPrompt: () => void;
+  /**
+   * Clear `confirmDisplay` once the dialog surface has left (bound to the
+   * content's `after-leave`). A no-op while a prompt is pending. Internal.
+   * @since 0.1.133
+   */
+  releaseConfirm: () => void;
   /**
    * Currently pending action-form request — `null` when no form is open.
    * Writes are owned by `requestActionInput()` / `acceptActionForm()` /
    * `dismissActionForm()`; consumers should not mutate directly.
    */
   actionFormRequest: Ref<ActionFormRequest | null>;
+  /**
+   * The form request the dialog SURFACE renders: the last non-null
+   * `actionFormRequest`, retained after it is answered so the title, id chips
+   * and form survive the exit animation. Internal. @since 0.1.133
+   */
+  actionFormDisplay: Ref<ActionFormRequest | null>;
   /**
    * Open the action-form dialog. Resolves with the submitted form payload
    * on accept, or `null` on cancel/dismiss.
@@ -449,6 +543,12 @@ interface ReactiveTableState extends TableStateMethods {
   acceptActionForm: (input: unknown) => void;
   /** Resolve the active form request with `null`. Internal — used by the dialog. */
   dismissActionForm: () => void;
+  /**
+   * Clear `actionFormDisplay` (and the loaded schema/draft) once the dialog
+   * surface has left. A no-op while a request is pending. Internal.
+   * @since 0.1.133
+   */
+  releaseActionForm: () => void;
   /**
    * Hydrate state from a URL query string produced by `stateToUrlQueryString`.
    * Replaces filters / sorters / search / pagination with values decoded from
@@ -487,9 +587,22 @@ interface PresetSurface {
    * `['columns', 'filters', 'filterOps', 'sorters']`.
    */
   availableAspects: PresetAspect[];
+  /**
+   * Aspects a SYSTEM preset owns — subset of `availableAspects`, equal to it
+   * unless `preset.systemAspects` narrowed it. Drives apply/reset, the dirty
+   * baseline, the picker/dialog badges and the Save-As defaults for system
+   * presets. Since 0.1.133.
+   */
+  systemAspects: PresetAspect[];
+  /**
+   * Aspects the preset `id` owns — the ones applying it writes. System →
+   * `systemAspects`, stored → what its snapshot claims, `null` (or an id
+   * with no row) → `availableAspects`. Since 0.1.133.
+   */
+  ownedAspects: (id: string | null) => PresetAspect[];
   /**
    * False when `preset` config is absent OR the initial load returned
-   * 401/403 OR any other error. The picker / dialog should hide their UI.
+   * 401/403/404 OR any other error. The picker / dialog should hide their UI.
    */
   available: ComputedRef<boolean>;
   /** Currently active preset id (system `'sys:*'` or stored). null = no active. */
@@ -548,6 +661,15 @@ interface PresetSurface {
    * feature is off.
    */
   batch: <T>(fn: () => Promise<T>) => Promise<T>;
+  /**
+   * Error thrown by the most recent mutator, or null — the SINGLE channel
+   * for preset write failures. Cleared when an OUTERMOST mutator starts, so
+   * a `batch()` counts as one user action: a failure early in a batch is not
+   * wiped by a later write inside it, and the batch's last failure wins.
+   * Mutators rethrow as well, so a caller can handle a single call; this ref
+   * is for UI that only needs to render the failure. Since 0.1.133.
+   */
+  lastError: Ref<Error | null>;
 }
 //#endregion
-export { TableNavBridge as _, EnterAction as a, NavKeyOptions as c, ReactiveTableState as d, RowDeleteOpt as f, TableActionsState as g, TVueTableActionInfo as h, ConfirmOptions as i, PresetConfig as l, TAsTableControls as m, ColumnMenuConfig as n, InvokeOpts as o, TAsCellTypeComponents as p, ConfigTab as r, MainActionRequest as s, ActionResult as t, QueryErrorKind as u };
+export { TableNavBridge as S, RowSelectableVerdict as _, EnterAction as a, TVueTableActionInfo as b, NavKeyOptions as c, ReactiveTableState as d, RowAttrsHook as f, RowSelectableHook as g, RowHookContext as h, ConfirmOptions as i, PresetConfig as l, RowDeleteOpt as m, ColumnMenuConfig as n, InvokeOpts as o, RowClassHook as p, ConfigTab as r, MainActionRequest as s, ActionResult as t, QueryErrorKind as u, TAsCellTypeComponents as v, TableActionsState as x, TAsTableControls as y };

package/dist/{types-ByU4O0Yf.d.mts → types-CXz-4dPz.d.mts}

@@ -1,5 +1,5 @@
 import { ColumnDef, PaginationControl, SortControl, TableDef } from "@atscript/ui";
-import { Component, ComputedRef, Ref, ShallowRef } from "vue";
+import { Component, ComputedRef, MaybeRefOrGetter, Ref, ShallowRef } from "vue";
 import { AsPresetEntryRow, AspectMask, ColumnWidthsMap, ConfigTab, FieldFilters, PresetAspect, PresetCapabilities, PresetSnapshot, SelectionMode, SystemPreset, SystemPresetInput, TableStateMethods } from "@atscript/ui-table";
 import { ClientError, TDbActionInfo, TDbActionProcessor, TDbDeleteResult } from "@atscript/db-client";
 
@@ -190,14 +190,62 @@ interface PresetConfig {
    * Add `'itemsPerPage'` for paginated tables; drop any aspect this app doesn't use.
    */
   aspects?: PresetAspect[];
+  /**
+   * Aspects a SYSTEM preset owns. Intersected with `aspects`; defaults to all
+   * of them. Narrow it to e.g. `['filterOps']` when system presets are
+   * filter-only views that must not reset the user's columns, displayed
+   * filters, sorters or page size. Since 0.1.133.
+   */
+  systemAspects?: PresetAspect[];
   /**
    * Opt-in localStorage overlay for the user's in-flight tweaks (default
    * `false`). Persists `columns` / `filters` / `sorters` / opt-in
    * `itemsPerPage`; `filterOps` / `searchTerm` / pagination are NOT persisted.
    */
   persistDrafts?: boolean;
+  /**
+   * Identity the draft is stored under — pass the signed-in user's id
+   * whenever `persistDrafts` is on, so a shared browser never restores the
+   * previous user's draft. Omitted keeps the pre-0.1.133 unscoped key.
+   * Since 0.1.133.
+   */
+  draftScope?: MaybeRefOrGetter<string | undefined>;
 }
 type QueryErrorKind = "initial" | "query" | "queryNext" | "loadRange";
+/**
+ * Context handed to the per-row hooks of `<AsTable>` (`rowSelectable`,
+ * `rowClass`, `rowAttrs`). Since 0.1.133.
+ */
+interface RowHookContext {
+  /** Position of the row in the rows the renderer is currently rendering. */
+  index: number;
+  /**
+   * Whether the row's pk is in `state.selectedRows` right now. A getter —
+   * reading it subscribes that hook call to the selection, so predicates
+   * that ignore it are not re-run when the selection changes.
+   */
+  readonly selected: boolean;
+}
+/**
+ * Per-row selectability predicate. Return `false` — or a string, which is
+ * surfaced as the disabled reason on the selection control — to make the row
+ * not selectable; `true` (or omitting the prop) keeps it selectable.
+ * Since 0.1.133.
+ */
+type RowSelectableHook = (row: Record<string, unknown>, ctx: RowHookContext) => boolean | string | undefined | void;
+/** Extra classes for the row element. Since 0.1.133. */
+type RowClassHook = (row: Record<string, unknown>, ctx: RowHookContext) => string | string[] | Record<string, boolean> | undefined;
+/**
+ * Extra attributes for the row element. The framework's own `id`, `role`,
+ * `aria-*`, `data-*`, `class` and `style` always win. Since 0.1.133.
+ */
+type RowAttrsHook = (row: Record<string, unknown>, ctx: RowHookContext) => Record<string, unknown> | undefined;
+/** Normalised {@link RowSelectableHook} verdict. */
+interface RowSelectableVerdict {
+  ok: boolean;
+  /** Disabled reason, when the predicate returned a string. */
+  reason?: string;
+}
 /** Controls which sections appear in the column header dropdown menu. */
 interface ColumnMenuConfig {
   sort?: boolean;
@@ -373,6 +421,31 @@ interface ReactiveTableState extends TableStateMethods {
    * naturally without consulting mode.
    */
   isPkSelected: (pk: unknown) => boolean;
+  /**
+   * Per-row selectability predicate — writable ref owned by the renderer,
+   * like {@link rowDelete}. `<AsTable>` / `<AsWindowTable>` push their
+   * `:row-selectable` prop into it, and every selection path in the model
+   * gates on it. Since 0.1.133.
+   */
+  rowSelectable: Ref<RowSelectableHook | undefined>;
+  /**
+   * Normalised `rowSelectable` verdict for one row. `index` is the row's
+   * position in what the renderer renders (absolute in window mode).
+   * Since 0.1.133.
+   */
+  isRowSelectable: (row: Record<string, unknown>, index: number) => RowSelectableVerdict;
+  /** The subset of `rows` the `rowSelectable` predicate lets through. Since 0.1.133. */
+  selectableRows: (rows: readonly Record<string, unknown>[]) => Record<string, unknown>[];
+  /** How many of `rows` the `rowSelectable` predicate lets through. Since 0.1.133. */
+  selectableCount: (rows: readonly Record<string, unknown>[]) => number;
+  /**
+   * Select every eligible row in `rows`. An ineligible row that is already
+   * selected stays selected. `indexOf` maps a position in `rows` to the
+   * index the `rowSelectable` predicate sees — windowed callers pass it
+   * because their rows come from a cache keyed by absolute index.
+   * Since 0.1.133.
+   */
+  selectAll: (rows: readonly Record<string, unknown>[], indexOf?: (position: number) => number) => 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. */
@@ -398,7 +471,10 @@ interface ReactiveTableState extends TableStateMethods {
   setActive: (absIndex: number) => void;
   /** Reset the active-row index to `-1`. */
   clearActive: () => void;
-  /** Toggle selection of the active row's PK in `selectedRows`. */
+  /**
+   * Toggle selection of the active row's PK in `selectedRows`. No-op in
+   * `select="none"` and on a row the `rowSelectable` predicate rejects.
+   */
   toggleActiveSelection: (mode: SelectionMode) => void;
   /** Ask the rendering component to emit `main-action` for the active row. */
   requestMainAction: (event: KeyboardEvent | MouseEvent) => void;
@@ -415,6 +491,12 @@ interface ReactiveTableState extends TableStateMethods {
    * consumers should not mutate directly.
    */
   confirmRequest: Ref<ConfirmRequest | null>;
+  /**
+   * The prompt request the dialog SURFACE renders: the last non-null
+   * `confirmRequest`, retained after it is answered so the copy survives the
+   * exit animation. Internal — used by the dialog. @since 0.1.133
+   */
+  confirmDisplay: Ref<ConfirmRequest | null>;
   /**
    * Open the in-app confirm dialog with `message` as the body. Resolves
    * `true` on accept, `false` on cancel/dismiss. Public — consumers can
@@ -431,12 +513,24 @@ interface ReactiveTableState extends TableStateMethods {
   acceptPrompt: () => void;
   /** Resolve the active prompt with `false`. Internal — used by the dialog. */
   dismissPrompt: () => void;
+  /**
+   * Clear `confirmDisplay` once the dialog surface has left (bound to the
+   * content's `after-leave`). A no-op while a prompt is pending. Internal.
+   * @since 0.1.133
+   */
+  releaseConfirm: () => void;
   /**
    * Currently pending action-form request — `null` when no form is open.
    * Writes are owned by `requestActionInput()` / `acceptActionForm()` /
    * `dismissActionForm()`; consumers should not mutate directly.
    */
   actionFormRequest: Ref<ActionFormRequest | null>;
+  /**
+   * The form request the dialog SURFACE renders: the last non-null
+   * `actionFormRequest`, retained after it is answered so the title, id chips
+   * and form survive the exit animation. Internal. @since 0.1.133
+   */
+  actionFormDisplay: Ref<ActionFormRequest | null>;
   /**
    * Open the action-form dialog. Resolves with the submitted form payload
    * on accept, or `null` on cancel/dismiss.
@@ -449,6 +543,12 @@ interface ReactiveTableState extends TableStateMethods {
   acceptActionForm: (input: unknown) => void;
   /** Resolve the active form request with `null`. Internal — used by the dialog. */
   dismissActionForm: () => void;
+  /**
+   * Clear `actionFormDisplay` (and the loaded schema/draft) once the dialog
+   * surface has left. A no-op while a request is pending. Internal.
+   * @since 0.1.133
+   */
+  releaseActionForm: () => void;
   /**
    * Hydrate state from a URL query string produced by `stateToUrlQueryString`.
    * Replaces filters / sorters / search / pagination with values decoded from
@@ -487,9 +587,22 @@ interface PresetSurface {
    * `['columns', 'filters', 'filterOps', 'sorters']`.
    */
   availableAspects: PresetAspect[];
+  /**
+   * Aspects a SYSTEM preset owns — subset of `availableAspects`, equal to it
+   * unless `preset.systemAspects` narrowed it. Drives apply/reset, the dirty
+   * baseline, the picker/dialog badges and the Save-As defaults for system
+   * presets. Since 0.1.133.
+   */
+  systemAspects: PresetAspect[];
+  /**
+   * Aspects the preset `id` owns — the ones applying it writes. System →
+   * `systemAspects`, stored → what its snapshot claims, `null` (or an id
+   * with no row) → `availableAspects`. Since 0.1.133.
+   */
+  ownedAspects: (id: string | null) => PresetAspect[];
   /**
    * False when `preset` config is absent OR the initial load returned
-   * 401/403 OR any other error. The picker / dialog should hide their UI.
+   * 401/403/404 OR any other error. The picker / dialog should hide their UI.
    */
   available: ComputedRef<boolean>;
   /** Currently active preset id (system `'sys:*'` or stored). null = no active. */
@@ -548,6 +661,15 @@ interface PresetSurface {
    * feature is off.
    */
   batch: <T>(fn: () => Promise<T>) => Promise<T>;
+  /**
+   * Error thrown by the most recent mutator, or null — the SINGLE channel
+   * for preset write failures. Cleared when an OUTERMOST mutator starts, so
+   * a `batch()` counts as one user action: a failure early in a batch is not
+   * wiped by a later write inside it, and the batch's last failure wins.
+   * Mutators rethrow as well, so a caller can handle a single call; this ref
+   * is for UI that only needs to render the failure. Since 0.1.133.
+   */
+  lastError: Ref<Error | null>;
 }
 //#endregion
-export { TableNavBridge as _, EnterAction as a, NavKeyOptions as c, ReactiveTableState as d, RowDeleteOpt as f, TableActionsState as g, TVueTableActionInfo as h, ConfirmOptions as i, PresetConfig as l, TAsTableControls as m, ColumnMenuConfig as n, InvokeOpts as o, TAsCellTypeComponents as p, ConfigTab as r, MainActionRequest as s, ActionResult as t, QueryErrorKind as u };
+export { TableNavBridge as S, RowSelectableVerdict as _, EnterAction as a, TVueTableActionInfo as b, NavKeyOptions as c, ReactiveTableState as d, RowAttrsHook as f, RowSelectableHook as g, RowHookContext as h, ConfirmOptions as i, PresetConfig as l, RowDeleteOpt as m, ColumnMenuConfig as n, InvokeOpts as o, RowClassHook as p, ConfigTab as r, MainActionRequest as s, ActionResult as t, QueryErrorKind as u, TAsCellTypeComponents as v, TableActionsState as x, TAsTableControls as y };

package/dist/{use-table-CyFcVtUN.mjs → use-table-Bk-jSxOM.mjs}

@@ -1,8 +1,8 @@
-import { n as createTableState, r as provideTableContext, s as DEFAULT_AVAILABLE_ASPECTS } from "./use-table-state-BxX3SpeW.mjs";
+import { n as createTableState, r as provideTableContext, s as DEFAULT_AVAILABLE_ASPECTS } from "./use-table-state-DLJbW753.mjs";
 import { n as useTableSelection } from "./use-table-selection-C84z4OZy.mjs";
 import { createTableDef, getMetaEntry, resetMetaCache } from "@atscript/ui";
-import { computed, inject, isRef, ref, shallowRef, watch } from "vue";
-import { PresetsClient, STANDARD_PRESET_ID, debounce, deserializeDraft, isAuthError, isEmptyDraft, isSystemPresetId, resolveSystemPresets, serializeDraft, stableStringify } from "@atscript/ui-table";
+import { computed, inject, isRef, ref, shallowRef, toValue, watch } from "vue";
+import { PresetsClient, STANDARD_PRESET_ID, debounce, deserializeDraft, isEmptyDraft, isSystemPresetId, isUnavailableError, resolveSystemPresets, serializeDraft, stableStringify } from "@atscript/ui-table";
 //#region src/composables/as-presets-app.ts
 /**
 * App-wide injection key for the presets system. The host app calls
@@ -37,11 +37,16 @@ function injectPresetsApp(explicit) {
 const DEFAULT_DEBOUNCE_MS = 300;
 /**
 * 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).
 */
 function useLocalDraft(opts) {
-	const key = `as-table-draft:${opts.app}:${opts.tableKey}`;
+	/** Resolved per call — `scope` is reactive. */
+	function storageKey() {
+		const scope = toValue(opts.scope);
+		return scope ? `as-table-draft:${opts.app}:${scope}:${opts.tableKey}` : `as-table-draft:${opts.app}:${opts.tableKey}`;
+	}
 	const debounceMs = opts.debounceMs ?? DEFAULT_DEBOUNCE_MS;
 	const storage = resolveStorage(opts.storage);
 	function isEnabled() {
@@ -52,7 +57,7 @@ function useLocalDraft(opts) {
 	function readDraft() {
 		if (!storage) return null;
 		try {
-			const raw = storage.getItem(key);
+			const raw = storage.getItem(storageKey());
 			if (!raw) return null;
 			const parsed = JSON.parse(raw);
 			if (!parsed || typeof parsed !== "object") return null;
@@ -65,7 +70,7 @@ function useLocalDraft(opts) {
 	function writeDraft(draft) {
 		if (!storage) return;
 		try {
-			storage.setItem(key, JSON.stringify(draft));
+			storage.setItem(storageKey(), JSON.stringify(draft));
 		} catch (err) {
 			console.warn("[vue-table] useLocalDraft: localStorage write failed", err);
 		}
@@ -73,7 +78,7 @@ function useLocalDraft(opts) {
 	function clear() {
 		if (!storage) return;
 		try {
-			storage.removeItem(key);
+			storage.removeItem(storageKey());
 		} catch {}
 	}
 	function hydrate(applied) {
@@ -114,9 +119,17 @@ function useLocalDraft(opts) {
 		}
 		const flushDebounced = debounce(((current, preset) => flush(current, preset)), debounceMs);
 		const stop = watch(() => [currentSnapshot(), activePresetSnapshot()], ([current, preset]) => flushDebounced(current, preset), { flush: "post" });
+		const stopScope = watch(() => toValue(opts.scope), () => {
+			flushDebounced.cancel();
+			lastPresetRef = null;
+			lastPresetSerialized = "";
+			const existing = readDraft();
+			lastDraftSerialized = existing && !isEmptyDraft(existing) ? stableStringify(existing) : "";
+		}, { flush: "post" });
 		return () => {
 			flushDebounced.cancel();
 			stop();
+			stopScope();
 		};
 	}
 	return {
@@ -250,7 +263,7 @@ function usePresets(opts) {
 			userConf.value = result.userConf;
 			if (result.capabilities !== void 0) capabilities.value = result.capabilities;
 		} catch (err) {
-			if (isAuthError(err)) {
+			if (isUnavailableError(err)) {
 				denied.value = true;
 				presets.value = [];
 				userConf.value = null;
@@ -376,7 +389,8 @@ function useTable(url, opts) {
 		app: injectPresetsApp(preset.app),
 		tableKey: preset.tableKey,
 		enabled: preset.persistDrafts ?? false,
-		availableAspects: preset.aspects ?? DEFAULT_AVAILABLE_ASPECTS
+		availableAspects: preset.aspects ?? DEFAULT_AVAILABLE_ASPECTS,
+		scope: preset.draftScope
 	}) : null;
 	const { state, internals } = createTableState({
 		client,
@@ -417,6 +431,7 @@ function useTable(url, opts) {
 			presetsHandle,
 			draftHandle,
 			availableAspects: preset?.aspects,
+			systemAspects: preset?.systemAspects,
 			persistDrafts: preset?.persistDrafts ?? false
 		}
 	});