@atscript/vue-table 0.1.132 → 0.1.133

package/dist/{as-table-base-RG2TEIgV.cjs → as-table-base-Dfw012G5.cjs}

@@ -1,6 +1,6 @@
-const require_use_table_state = require("./use-table-state-Oi2ds4_a.cjs");
+const require_use_table_state = require("./use-table-state-D6dHOFrA.cjs");
 const require_get_cell_value = require("./get-cell-value-4rHKP-TG.cjs");
-const require_as_table_status = require("./as-table-status-Du4WLF4k.cjs");
+const require_as_table_status = require("./as-table-status-BgDexT2x.cjs");
 let vue = require("vue");
 let _atscript_ui_table = require("@atscript/ui-table");
 let _vueuse_core = require("@vueuse/core");
@@ -160,6 +160,7 @@ const _hoisted_6 = [
 	"id",
 	"aria-rowindex",
 	"aria-selected",
+	"data-selectable",
 	"onClick",
 	"onDblclick"
 ];
@@ -168,16 +169,24 @@ const _hoisted_7 = {
 	class: "as-td-select",
 	role: "gridcell"
 };
-const _hoisted_8 = {
+const _hoisted_8 = [
+	"tabindex",
+	"aria-checked",
+	"aria-disabled",
+	"aria-label",
+	"title",
+	"onKeydown"
+];
+const _hoisted_9 = {
 	key: 0,
 	class: "as-table-checkbox-tick",
 	"aria-hidden": "true"
 };
-const _hoisted_9 = {
+const _hoisted_10 = {
 	key: 0,
 	role: "gridcell"
 };
-const _hoisted_10 = {
+const _hoisted_11 = {
 	key: 3,
 	class: "as-td-filler",
 	role: "gridcell"
@@ -289,6 +298,14 @@ var as_table_base_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			type: Boolean,
 			required: false,
 			default: false
+		},
+		rowClass: {
+			type: Function,
+			required: false
+		},
+		rowAttrs: {
+			type: Function,
+			required: false
 		}
 	},
 	emits: [
@@ -314,14 +331,69 @@ var as_table_base_default = /* @__PURE__ */ (0, vue.defineComponent)({
 		const isListbox = (0, vue.computed)(() => props.renderMode === "listbox");
 		const isRekaWrapped = (0, vue.computed)(() => isCombobox.value || isListbox.value);
 		const hasValue = (0, vue.computed)(() => isRekaWrapped.value || props.select !== "none");
+		const SELECTABLE = Object.freeze({ ok: true });
+		const DEFAULT_ROW_META = Object.freeze({
+			selectable: SELECTABLE,
+			cls: void 0,
+			attrs: void 0
+		});
+		const rowHooks = (0, vue.computed)(() => {
+			const rows = props.rows;
+			if (!isStandalone.value) return {
+				metas: [],
+				selectable: rows.length,
+				selected: 0
+			};
+			const gated = !!ctx?.state.rowSelectable.value;
+			if (!gated && !props.rowClass && !props.rowAttrs) {
+				let selected = 0;
+				for (const row of rows) if (isPkSelected(row)) selected++;
+				return {
+					metas: [],
+					selectable: rows.length,
+					selected
+				};
+			}
+			let selectable = 0;
+			let selected = 0;
+			return {
+				metas: rows.map((row, index) => {
+					const hookCtx = {
+						index,
+						get selected() {
+							return isPkSelected(row);
+						}
+					};
+					const verdict = gated ? ctx.state.isRowSelectable(row, index) : SELECTABLE;
+					if (verdict.ok) {
+						selectable++;
+						if (isPkSelected(row)) selected++;
+					}
+					return {
+						selectable: verdict,
+						cls: props.rowClass?.(row, hookCtx),
+						attrs: props.rowAttrs?.(row, hookCtx)
+					};
+				}),
+				selectable,
+				selected
+			};
+		});
+		function metaFor(index) {
+			return rowHooks.value.metas[index] ?? DEFAULT_ROW_META;
+		}
+		/** Accessible name for a row's selection control, carrying the disabled reason. */
+		function selectLabel(verdict) {
+			if (verdict.ok) return "Select row";
+			return verdict.reason ? `Select row, ${verdict.reason}` : "Select row, not selectable";
+		}
 		const hasActiveFilters = (0, vue.computed)(() => props.filters ? (0, _atscript_ui_table.filledFilterCount)(props.filters) > 0 : false);
 		const showSelectAllCheckbox = (0, vue.computed)(() => isStandalone.value && props.select === "multi" && !!props.selectedRows);
 		const selectAllState = (0, vue.computed)(() => {
 			if (!showSelectAllCheckbox.value) return void 0;
-			const sel = props.selectedRows ?? [];
-			if (sel.length === 0) return "none";
-			if (sel.length === props.rows.length && props.rows.length > 0) return "all";
-			return "some";
+			if ((props.selectedRows ?? []).length === 0) return "none";
+			const { selectable, selected } = rowHooks.value;
+			return selectable > 0 && selected >= selectable ? "all" : "some";
 		});
 		const emit = __emit;
 		const slots = (0, vue.useSlots)();
@@ -360,6 +432,11 @@ var as_table_base_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			if (!isStandalone.value || !ctx) return;
 			ctx.state.handleNavKey(event, { mode: props.select });
 		}
+		/** Space on a row's selection control toggles just that row. */
+		function onSelectCellKeydown(event, index) {
+			if (!ctx) return;
+			require_use_table_state.onSelectControlKeydown(event, index, props.select, ctx.state);
+		}
 		const scrollContainerRef = (0, vue.ref)(null);
 		function alignActiveRow(idx) {
 			if (!ctx) return;
@@ -597,50 +674,68 @@ var as_table_base_default = /* @__PURE__ */ (0, vue.defineComponent)({
 						"aria-activedescendant": ariaActiveDescendant.value,
 						onKeydown: onTbodyKeydown
 					}, {
-						default: (0, vue.withCtx)(({ item, index, spaceBefore }) => [(0, vue.createElementVNode)("tr", {
-							id: rowIdFor(index),
-							role: "row",
-							"aria-rowindex": index + 2,
-							"aria-selected": ariaSelectedFor(item),
-							class: (0, vue.normalizeClass)({ "as-table-row-active": isActiveRow(index) }),
-							style: (0, vue.normalizeStyle)({
-								height: __props.virtualRowHeight ? `${__props.virtualRowHeight}px` : void 0,
-								transform: spaceBefore ? `translateY(${spaceBefore}px)` : void 0
-							}),
-							onClick: ($event) => onRowClick(item, $event, index),
-							onDblclick: ($event) => onRowDblClick(item, $event, index)
-						}, [
-							hasValue.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("td", _hoisted_7, [(0, vue.createElementVNode)("span", { class: (0, vue.normalizeClass)(["as-table-checkbox", { "as-table-checkbox-checked": isPkSelected(item) }]) }, [isPkSelected(item) ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", _hoisted_8)) : (0, vue.createCommentVNode)("v-if", true)], 2)])) : (0, vue.createCommentVNode)("v-if", true),
-							(0, vue.unref)(hasAnyCellBindings) ? ((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, { key: 1 }, (0, vue.renderList)(__props.columns, (col) => {
-								return (0, vue.openBlock)(), (0, vue.createElementBlock)(vue.Fragment, { key: col.path }, [((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, null, (0, vue.renderList)([(0, vue.unref)(cellResolver)(col, item, index)], (bindings) => {
-									return (0, vue.openBlock)(), (0, vue.createElementBlock)(vue.Fragment, { key: 0 }, [cellSlotFlags.value[col.path] ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("td", (0, vue.mergeProps)({
-										key: 0,
-										role: "gridcell"
-									}, { ref_for: true }, bindings), [(0, vue.renderSlot)(_ctx.$slots, `cell-${col.path}`, {
+						default: (0, vue.withCtx)(({ item, index, spaceBefore }) => [(0, vue.createCommentVNode)("\n            `meta` is resolved ONCE per row (the row's hook results + its\n            selectability verdict); `v-bind=\"meta.attrs\"` comes FIRST so every\n            framework binding after it wins — consumer attrs can decorate a\n            row but can never rewrite its id / role / aria / data contract.\n          "), ((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, null, (0, vue.renderList)([metaFor(index)], (meta) => {
+							return (0, vue.openBlock)(), (0, vue.createElementBlock)("tr", (0, vue.mergeProps)({
+								key: 0,
+								ref_for: true
+							}, meta.attrs, {
+								id: rowIdFor(index),
+								role: "row",
+								"aria-rowindex": index + 2,
+								"aria-selected": ariaSelectedFor(item),
+								"data-selectable": meta.selectable.ok ? void 0 : "false",
+								class: [{ "as-table-row-active": isActiveRow(index) }, meta.cls],
+								style: {
+									height: __props.virtualRowHeight ? `${__props.virtualRowHeight}px` : void 0,
+									transform: spaceBefore ? `translateY(${spaceBefore}px)` : void 0
+								},
+								onClick: ($event) => onRowClick(item, $event, index),
+								onDblclick: ($event) => onRowDblClick(item, $event, index)
+							}), [
+								hasValue.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("td", _hoisted_7, [(0, vue.createElementVNode)("span", {
+									class: (0, vue.normalizeClass)(["as-table-checkbox", {
+										"as-table-checkbox-checked": isPkSelected(item),
+										"as-table-checkbox-disabled": !meta.selectable.ok
+									}]),
+									role: "checkbox",
+									tabindex: meta.selectable.ok ? 0 : void 0,
+									"aria-checked": isPkSelected(item) ? "true" : "false",
+									"aria-disabled": meta.selectable.ok ? void 0 : "true",
+									"aria-label": selectLabel(meta.selectable),
+									title: meta.selectable.reason,
+									onKeydown: ($event) => onSelectCellKeydown($event, index)
+								}, [isPkSelected(item) ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", _hoisted_9)) : (0, vue.createCommentVNode)("v-if", true)], 42, _hoisted_8)])) : (0, vue.createCommentVNode)("v-if", true),
+								(0, vue.unref)(hasAnyCellBindings) ? ((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, { key: 1 }, (0, vue.renderList)(__props.columns, (col) => {
+									return (0, vue.openBlock)(), (0, vue.createElementBlock)(vue.Fragment, { key: col.path }, [((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, null, (0, vue.renderList)([(0, vue.unref)(cellResolver)(col, item, index)], (bindings) => {
+										return (0, vue.openBlock)(), (0, vue.createElementBlock)(vue.Fragment, { key: 0 }, [cellSlotFlags.value[col.path] ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("td", (0, vue.mergeProps)({
+											key: 0,
+											role: "gridcell"
+										}, { ref_for: true }, bindings), [(0, vue.renderSlot)(_ctx.$slots, `cell-${col.path}`, {
+											row: item,
+											value: (0, vue.unref)(require_get_cell_value.getCellValue)(item, col.path),
+											column: col
+										})], 16)) : ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.resolveDynamicComponent)((0, vue.unref)(cellComponents)[col.path]), (0, vue.mergeProps)({
+											key: 1,
+											row: item,
+											column: col,
+											role: "gridcell"
+										}, { ref_for: true }, bindings), null, 16, ["row", "column"]))], 64);
+									}), 128))], 64);
+								}), 128)) : ((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, { key: 2 }, (0, vue.renderList)(__props.columns, (col) => {
+									return (0, vue.openBlock)(), (0, vue.createElementBlock)(vue.Fragment, { key: col.path }, [cellSlotFlags.value[col.path] ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("td", _hoisted_10, [(0, vue.renderSlot)(_ctx.$slots, `cell-${col.path}`, {
 										row: item,
 										value: (0, vue.unref)(require_get_cell_value.getCellValue)(item, col.path),
 										column: col
-									})], 16)) : ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.resolveDynamicComponent)((0, vue.unref)(cellComponents)[col.path]), (0, vue.mergeProps)({
+									})])) : ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.resolveDynamicComponent)((0, vue.unref)(cellComponents)[col.path]), {
 										key: 1,
 										row: item,
 										column: col,
 										role: "gridcell"
-									}, { ref_for: true }, bindings), null, 16, ["row", "column"]))], 64);
-								}), 128))], 64);
-							}), 128)) : ((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, { key: 2 }, (0, vue.renderList)(__props.columns, (col) => {
-								return (0, vue.openBlock)(), (0, vue.createElementBlock)(vue.Fragment, { key: col.path }, [cellSlotFlags.value[col.path] ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("td", _hoisted_9, [(0, vue.renderSlot)(_ctx.$slots, `cell-${col.path}`, {
-									row: item,
-									value: (0, vue.unref)(require_get_cell_value.getCellValue)(item, col.path),
-									column: col
-								})])) : ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.resolveDynamicComponent)((0, vue.unref)(cellComponents)[col.path]), {
-									key: 1,
-									row: item,
-									column: col,
-									role: "gridcell"
-								}, null, 8, ["row", "column"]))], 64);
-							}), 128)),
-							__props.stretch ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("td", _hoisted_10)) : (0, vue.createCommentVNode)("v-if", true)
-						], 46, _hoisted_6)]),
+									}, null, 8, ["row", "column"]))], 64);
+								}), 128)),
+								__props.stretch ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("td", _hoisted_11)) : (0, vue.createCommentVNode)("v-if", true)
+							], 16, _hoisted_6);
+						}), 128))]),
 						_: 3
 					}, 8, [
 						"options",

package/dist/{as-table-header-cell-CIqlO6Lw.cjs → as-table-header-cell-Bb4ddLmQ.cjs}

@@ -1,4 +1,4 @@
-const require_use_table_component = require("./use-table-component-DO_kvKSf.cjs");
+const require_use_table_component = require("./use-table-component-DlLganVc.cjs");
 const require_as_column_menu = require("./as-column-menu-fZVbJ9lU.cjs");
 let vue = require("vue");
 let _atscript_ui_table = require("@atscript/ui-table");

package/dist/{as-table-header-cell-Bdhl5Lox.mjs → as-table-header-cell-q-c_QklI.mjs}

@@ -1,4 +1,4 @@
-import { t as useTableComponent } from "./use-table-component-K6xj1obF.mjs";
+import { t as useTableComponent } from "./use-table-component-KuzZxAP8.mjs";
 import { t as as_column_menu_default } from "./as-column-menu-kTIQfLTi.mjs";
 import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, defineComponent, normalizeClass, openBlock, resolveDynamicComponent, toDisplayString, unref, withCtx, withModifiers } from "vue";
 import { isFilled } from "@atscript/ui-table";

package/dist/as-table-header-cell.cjs

@@ -1,2 +1,2 @@
-const require_as_table_header_cell = require("./as-table-header-cell-CIqlO6Lw.cjs");
+const require_as_table_header_cell = require("./as-table-header-cell-Bb4ddLmQ.cjs");
 module.exports = require_as_table_header_cell.as_table_header_cell_default;

package/dist/as-table-header-cell.d.cts

@@ -1,2 +1,2 @@
-import { t as _default } from "./as-table-header-cell.vue-BzTzfGRo.cjs";
+import { t as _default } from "./as-table-header-cell.vue-qS1Xfc-U.cjs";
 export = _default;

package/dist/as-table-header-cell.d.mts

@@ -1,2 +1,2 @@
-import { t as _default } from "./as-table-header-cell.vue-BCszzxtU.mjs";
+import { t as _default } from "./as-table-header-cell.vue-BjVOEFqz.mjs";
 export { _default as default };

package/dist/as-table-header-cell.mjs

@@ -1,2 +1,2 @@
-import { t as as_table_header_cell_default } from "./as-table-header-cell-Bdhl5Lox.mjs";
+import { t as as_table_header_cell_default } from "./as-table-header-cell-q-c_QklI.mjs";
 export { as_table_header_cell_default as default };

package/dist/{as-table-header-cell.vue-BCszzxtU.d.mts → as-table-header-cell.vue-BjVOEFqz.d.mts}

@@ -1,4 +1,4 @@
-import { n as ColumnMenuConfig } from "./types-ByU4O0Yf.mjs";
+import { n as ColumnMenuConfig } from "./types-CXz-4dPz.mjs";
 import { ColumnDef } from "@atscript/ui";
 import * as vue from "vue";
 import { ColumnWidthEntry, FilterCondition } from "@atscript/ui-table";

package/dist/{as-table-header-cell.vue-BzTzfGRo.d.cts → as-table-header-cell.vue-qS1Xfc-U.d.cts}

@@ -1,4 +1,4 @@
-import { n as ColumnMenuConfig } from "./types-CTMxE_zA.cjs";
+import { n as ColumnMenuConfig } from "./types-BZ0HssRY.cjs";
 import * as vue from "vue";
 import { ColumnDef } from "@atscript/ui";
 import { ColumnWidthEntry, FilterCondition } from "@atscript/ui-table";

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

@@ -1,8 +1,8 @@
-import { i as useRegisterMainActionListener } from "./use-table-state-BxX3SpeW.mjs";
-import { n as useTable } from "./use-table-CyFcVtUN.mjs";
-import { t as useTableNavBridge } from "./use-table-nav-bridge-DeGeaQX-.mjs";
+import { i as useRegisterMainActionListener } from "./use-table-state-DLJbW753.mjs";
+import { n as useTable } from "./use-table-Bk-jSxOM.mjs";
+import { t as useTableNavBridge } from "./use-table-nav-bridge-B9SSEajW.mjs";
 import { t as useHasEmitListener } from "./use-has-emit-listener-BTMDIv2e.mjs";
-import { t as as_confirm_dialog_default } from "./as-confirm-dialog-bpN4A-KN.mjs";
+import { t as as_confirm_dialog_default } from "./as-confirm-dialog-BV01t7dn.mjs";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, defineAsyncComponent, defineComponent, mergeModels, openBlock, ref, renderSlot, resolveDynamicComponent, unref, useModel, watch } from "vue";
 //#endregion
 //#region src/components/as-table-root.vue
@@ -183,7 +183,7 @@ var as_table_root_default = /* @__PURE__ */ defineComponent({
 			alwaysSelected: props.alwaysSelected,
 			queryFn: props.queryFn,
 			queryOnMount: props.queryOnMount,
-			blockQuery: props.blockQuery,
+			blockQuery: () => props.blockQuery === true,
 			blockSize: props.blockSize,
 			dragReleaseDebounceMs: props.dragReleaseDebounceMs,
 			clientFactory: props.clientFactory,

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

@@ -1,8 +1,8 @@
-const require_use_table_state = require("./use-table-state-Oi2ds4_a.cjs");
-const require_use_table = require("./use-table-nvBq1dZ4.cjs");
-const require_use_table_nav_bridge = require("./use-table-nav-bridge-uOQUDooh.cjs");
+const require_use_table_state = require("./use-table-state-D6dHOFrA.cjs");
+const require_use_table = require("./use-table-CdFFqaEx.cjs");
+const require_use_table_nav_bridge = require("./use-table-nav-bridge-CVUmTjDr.cjs");
 const require_use_has_emit_listener = require("./use-has-emit-listener-hhOH8CBI.cjs");
-const require_as_confirm_dialog = require("./as-confirm-dialog-UwhDHysk.cjs");
+const require_as_confirm_dialog = require("./as-confirm-dialog-Cw7KErhz.cjs");
 let vue = require("vue");
 //#endregion
 //#region src/components/as-table-root.vue
@@ -183,7 +183,7 @@ var as_table_root_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			alwaysSelected: props.alwaysSelected,
 			queryFn: props.queryFn,
 			queryOnMount: props.queryOnMount,
-			blockQuery: props.blockQuery,
+			blockQuery: () => props.blockQuery === true,
 			blockSize: props.blockSize,
 			dragReleaseDebounceMs: props.dragReleaseDebounceMs,
 			clientFactory: props.clientFactory,

package/dist/as-table-root.cjs

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

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

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

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

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

package/dist/as-table-root.mjs

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

package/dist/{as-table-root.vue-QMT93qPk.d.mts → as-table-root.vue-BPU92_Ns.d.mts}

@@ -1,4 +1,4 @@
-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-ByU4O0Yf.mjs";
+import { S as TableNavBridge, b as TVueTableActionInfo, c as NavKeyOptions, d as ReactiveTableState, i as ConfirmOptions, l as PresetConfig, t as ActionResult, v as TAsCellTypeComponents, x as TableActionsState, y as TAsTableControls } from "./types-CXz-4dPz.mjs";
 import * as _atscript_ui0 from "@atscript/ui";
 import { ClientFactory, ClientFactory as ClientFactory$1, ColumnDef, SortControl, TableDef, getDefaultClientFactory, resetDefaultClientFactory, setDefaultClientFactory } from "@atscript/ui";
 import * as vue from "vue";
@@ -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
@@ -212,8 +226,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
@@ -275,6 +293,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. */
@@ -420,8 +440,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. */
@@ -1982,6 +2006,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 +2021,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 +2041,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" .../>

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

@@ -1,4 +1,4 @@
-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 { S as TableNavBridge, b as TVueTableActionInfo, c as NavKeyOptions, d as ReactiveTableState, i as ConfirmOptions, l as PresetConfig, t as ActionResult, v as TAsCellTypeComponents, x as TableActionsState, y as TAsTableControls } from "./types-BZ0HssRY.cjs";
 import * as vue from "vue";
 import { AllowedComponentProps, AnchorHTMLAttributes, App, Component as Component$1, ComponentCustomProps, ComponentPublicInstance, ComputedRef, DefineComponent, InjectionKey, MaybeRef, MaybeRefOrGetter, Ref, ShallowRef, UnwrapRef, VNode, VNodeProps, WritableComputedRef } from "vue";
 import { Client, PageResult, TDbActionInfo } from "@atscript/db-client";
@@ -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
@@ -212,8 +226,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
@@ -275,6 +293,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. */
@@ -420,8 +440,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. */
@@ -1982,6 +2006,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 +2021,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 +2041,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" .../>