@atscript/vue-table 0.1.152 → 0.1.153

package/dist/{as-filter-dialog-Cd16xRfM.cjs → as-filter-dialog-BB9M5PhT.cjs}

@@ -1,14 +1,14 @@
 const require_use_table_state = require("./use-table-state-zE3BpeA7.cjs");
-const require_use_table = require("./use-table-B3CvWW_y.cjs");
+const require_use_table = require("./use-table-nZElzw2r.cjs");
 const require_use_table_nav_bridge = require("./use-table-nav-bridge-C43u266u.cjs");
 const require_use_table_component = require("./use-table-component-Daap95CE.cjs");
 const require_as_config_dialog = require("./as-config-dialog-XSkaW1X0.cjs");
 const require_use_seed_on_open = require("./use-seed-on-open-Dg9I89fU.cjs");
 const require_use_condition_format = require("./use-condition-format-Dyb5CVYw.cjs");
-const require_as_filter_field = require("./as-filter-field-BPPMOZ9M.cjs");
+const require_as_filter_field = require("./as-filter-field-BFCTuRAa.cjs");
 const require_as_filter_input = require("./as-filter-input-DZkhoSWO.cjs");
 const require_as_window_table = require("./as-window-table-BvUfaBj8.cjs");
-const require_as_filters = require("./as-filters-C22XxgEx.cjs");
+const require_as_filters = require("./as-filters-9kFdHR4q.cjs");
 let _atscript_ui = require("@atscript/ui");
 let vue = require("vue");
 let _atscript_ui_table = require("@atscript/ui-table");

package/dist/{as-filter-dialog-8xvnKXTd.mjs → as-filter-dialog-DA7vdmUO.mjs}

@@ -1,14 +1,14 @@
 import { a as useTableContext, o as useTableContextOptional, r as provideTableContext, t as createStaticTableState } from "./use-table-state-DzvCmxEx.mjs";
-import { r as useTable } from "./use-table-CTCYFwrE.mjs";
+import { r as useTable } from "./use-table-D86LSCnG.mjs";
 import { t as useTableNavBridge } from "./use-table-nav-bridge-Ch61msQs.mjs";
 import { t as useTableComponent } from "./use-table-component-B9QRSvoR.mjs";
 import { n as useDialogTabKeyboard, t as as_config_dialog_default } from "./as-config-dialog-DW4WfYEi.mjs";
 import { t as useSeedOnOpen } from "./use-seed-on-open-DO3A1kIb.mjs";
 import { t as useConditionFormat } from "./use-condition-format-ka5_XiSn.mjs";
-import { a as valueColumn, i as hasValuePicker, n as createDistinctPager, r as declineIfRejected } from "./as-filter-field-DEBQQy_6.mjs";
+import { a as valueColumn, i as hasValuePicker, n as createDistinctPager, r as declineIfRejected } from "./as-filter-field-BxZwGNoI.mjs";
 import { t as as_filter_input_default } from "./as-filter-input-DeI85XVZ.mjs";
 import { t as as_window_table_default } from "./as-window-table-Cf523h8Q.mjs";
-import { t as as_filters_default } from "./as-filters-CT1ks7gu.mjs";
+import { t as as_filters_default } from "./as-filters-Cu8Hulrv.mjs";
 import { resolveValueHelp, valueHelpDictPaths } from "@atscript/ui";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, mergeModels, normalizeClass, normalizeStyle, onMounted, openBlock, ref, renderList, resolveDynamicComponent, shallowRef, toDisplayString, unref, useModel, watch, withCtx } from "vue";
 import { columnDefaultCondition, columnFilter, conditionLabel, filledFilterCount, isColumnFilterable, isFilled, isSimpleEq, isTemporalKind, sameColumnSet, temporalShortcuts } from "@atscript/ui-table";

package/dist/as-filter-dialog.cjs

@@ -1,2 +1,2 @@
-const require_as_filter_dialog = require("./as-filter-dialog-Cd16xRfM.cjs");
+const require_as_filter_dialog = require("./as-filter-dialog-BB9M5PhT.cjs");
 module.exports = require_as_filter_dialog.as_filter_dialog_default;

package/dist/as-filter-dialog.mjs

@@ -1,2 +1,2 @@
-import { t as as_filter_dialog_default } from "./as-filter-dialog-8xvnKXTd.mjs";
+import { t as as_filter_dialog_default } from "./as-filter-dialog-DA7vdmUO.mjs";
 export { as_filter_dialog_default as default };

package/dist/{as-filter-field-BPPMOZ9M.cjs → as-filter-field-BFCTuRAa.cjs}

@@ -1,5 +1,5 @@
 const require_use_table_state = require("./use-table-state-zE3BpeA7.cjs");
-const require_use_table = require("./use-table-B3CvWW_y.cjs");
+const require_use_table = require("./use-table-nZElzw2r.cjs");
 const require_use_condition_format = require("./use-condition-format-Dyb5CVYw.cjs");
 const require_as_table_base = require("./as-table-base-D_Hmin8J.cjs");
 let _atscript_ui = require("@atscript/ui");

package/dist/{as-filter-field-DEBQQy_6.mjs → as-filter-field-BxZwGNoI.mjs}

@@ -1,5 +1,5 @@
 import { a as useTableContext } from "./use-table-state-DzvCmxEx.mjs";
-import { r as useTable } from "./use-table-CTCYFwrE.mjs";
+import { r as useTable } from "./use-table-D86LSCnG.mjs";
 import { t as useConditionFormat } from "./use-condition-format-ka5_XiSn.mjs";
 import { t as as_table_base_default } from "./as-table-base-C1B_VVk-.mjs";
 import { NUMERIC_VALUE_KINDS, ValueHelpClient, fetchDistinctValues, getMetaEntry, isPickerDeclined, optionValue, resolveValueHelp, valueHelpDictPaths } from "@atscript/ui";

package/dist/as-filter-field.cjs

@@ -1,2 +1,2 @@
-const require_as_filter_field = require("./as-filter-field-BPPMOZ9M.cjs");
+const require_as_filter_field = require("./as-filter-field-BFCTuRAa.cjs");
 module.exports = require_as_filter_field.as_filter_field_default;

package/dist/as-filter-field.mjs

@@ -1,2 +1,2 @@
-import { t as as_filter_field_default } from "./as-filter-field-DEBQQy_6.mjs";
+import { t as as_filter_field_default } from "./as-filter-field-BxZwGNoI.mjs";
 export { as_filter_field_default as default };

package/dist/{as-filters-C22XxgEx.cjs → as-filters-9kFdHR4q.cjs}

@@ -1,6 +1,6 @@
 const require_use_table_state = require("./use-table-state-zE3BpeA7.cjs");
 const require_use_table_component = require("./use-table-component-Daap95CE.cjs");
-const require_as_filter_field = require("./as-filter-field-BPPMOZ9M.cjs");
+const require_as_filter_field = require("./as-filter-field-BFCTuRAa.cjs");
 const require_as_residual_filter = require("./as-residual-filter-BGz7pSdL.cjs");
 let vue = require("vue");
 let _atscript_ui_table = require("@atscript/ui-table");

package/dist/{as-filters-CT1ks7gu.mjs → as-filters-Cu8Hulrv.mjs}

@@ -1,6 +1,6 @@
 import { a as useTableContext } from "./use-table-state-DzvCmxEx.mjs";
 import { t as useTableComponent } from "./use-table-component-B9QRSvoR.mjs";
-import { t as as_filter_field_default } from "./as-filter-field-DEBQQy_6.mjs";
+import { t as as_filter_field_default } from "./as-filter-field-BxZwGNoI.mjs";
 import { t as as_residual_filter_default } from "./as-residual-filter-BoeOL9AJ.mjs";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, mergeModels, mergeProps, openBlock, renderList, renderSlot, resolveDynamicComponent, toDisplayString, unref, useModel, watch, withCtx } from "vue";
 import { filterExprKey } from "@atscript/ui-table";

package/dist/as-filters.cjs

@@ -1,2 +1,2 @@
-const require_as_filters = require("./as-filters-C22XxgEx.cjs");
+const require_as_filters = require("./as-filters-9kFdHR4q.cjs");
 module.exports = require_as_filters.as_filters_default;

package/dist/as-filters.mjs

@@ -1,2 +1,2 @@
-import { t as as_filters_default } from "./as-filters-CT1ks7gu.mjs";
+import { t as as_filters_default } from "./as-filters-Cu8Hulrv.mjs";
 export { as_filters_default as default };

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

@@ -1,2 +1,2 @@
-import { t as _default } from "./as-table-actions.vue-D8KKwLdM.cjs";
+import { t as _default } from "./as-table-actions.vue-Dzi8wX-e.cjs";
 export = _default;

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

@@ -1,2 +1,2 @@
-import { t as _default } from "./as-table-actions.vue-BMC3nQ5z.mjs";
+import { t as _default } from "./as-table-actions.vue-DNNYGVQW.mjs";
 export { _default as default };

package/dist/{as-table-actions.vue-BMC3nQ5z.d.mts → as-table-actions.vue-DNNYGVQW.d.mts}

@@ -23,7 +23,7 @@ declare var __VLS_1: {
     defaultAction: TVueTableActionInfo | undefined;
     otherActions: TVueTableActionInfo[];
     trailingRowActions: TVueTableActionInfo[];
-    level: "rows" | "row" | "table";
+    level: "table" | "rows" | "row";
     ids: Record<string, unknown>[];
     target: PromptTarget | undefined;
     count: number;

package/dist/{as-table-actions.vue-D8KKwLdM.d.cts → as-table-actions.vue-Dzi8wX-e.d.cts}

@@ -23,7 +23,7 @@ declare var __VLS_1: {
     defaultAction: TVueTableActionInfo | undefined;
     otherActions: TVueTableActionInfo[];
     trailingRowActions: TVueTableActionInfo[];
-    level: "rows" | "row" | "table";
+    level: "table" | "rows" | "row";
     ids: Record<string, unknown>[];
     target: PromptTarget | undefined;
     count: number;

package/dist/{as-table-root-BeyqcJUq.mjs → as-table-root-_eZRGvAC.mjs}

@@ -1,5 +1,5 @@
 import { c as warnUnsupportedFilter, i as useRegisterMainActionListener, s as warnFieldsDropped, t as createStaticTableState } from "./use-table-state-DzvCmxEx.mjs";
-import { n as finalizeTableState, r as useTable } from "./use-table-CTCYFwrE.mjs";
+import { n as finalizeTableState, r as useTable } from "./use-table-D86LSCnG.mjs";
 import { n as useCellLocale, t as provideCellLocale } from "./use-cell-locale-Bye0ANIP.mjs";
 import { t as useTableNavBridge } from "./use-table-nav-bridge-Ch61msQs.mjs";
 import { t as useHasEmitListener } from "./use-has-emit-listener-CsF2w9iT.mjs";
@@ -44,6 +44,10 @@ var as_table_root_default = /* @__PURE__ */ defineComponent({
 			type: Function,
 			required: false
 		},
+		metaKey: {
+			type: String,
+			required: false
+		},
 		controls: {
 			type: Object,
 			required: false
@@ -302,6 +306,7 @@ var as_table_root_default = /* @__PURE__ */ defineComponent({
 			blockSize: props.blockSize,
 			dragReleaseDebounceMs: props.dragReleaseDebounceMs,
 			clientFactory: props.clientFactory,
+			metaKey: props.metaKey,
 			controls: props.controls,
 			types: props.types,
 			components: props.components,
@@ -339,6 +344,7 @@ var as_table_root_default = /* @__PURE__ */ defineComponent({
 				"displayColumns",
 				"limit",
 				"clientFactory",
+				"metaKey",
 				...localMode ? ["columns"] : []
 			];
 			const sameValue = (a, b) => {

package/dist/{as-table-root-BQ5PA2SL.cjs → as-table-root-c2ep1IOv.cjs}

@@ -1,5 +1,5 @@
 const require_use_table_state = require("./use-table-state-zE3BpeA7.cjs");
-const require_use_table = require("./use-table-B3CvWW_y.cjs");
+const require_use_table = require("./use-table-nZElzw2r.cjs");
 const require_use_cell_locale = require("./use-cell-locale-Dy5Rf1yp.cjs");
 const require_use_table_nav_bridge = require("./use-table-nav-bridge-C43u266u.cjs");
 const require_use_has_emit_listener = require("./use-has-emit-listener-gD1aWp6N.cjs");
@@ -44,6 +44,10 @@ var as_table_root_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			type: Function,
 			required: false
 		},
+		metaKey: {
+			type: String,
+			required: false
+		},
 		controls: {
 			type: Object,
 			required: false
@@ -302,6 +306,7 @@ var as_table_root_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			blockSize: props.blockSize,
 			dragReleaseDebounceMs: props.dragReleaseDebounceMs,
 			clientFactory: props.clientFactory,
+			metaKey: props.metaKey,
 			controls: props.controls,
 			types: props.types,
 			components: props.components,
@@ -339,6 +344,7 @@ var as_table_root_default = /* @__PURE__ */ (0, vue.defineComponent)({
 				"displayColumns",
 				"limit",
 				"clientFactory",
+				"metaKey",
 				...localMode ? ["columns"] : []
 			];
 			const sameValue = (a, b) => {

package/dist/as-table-root.cjs

@@ -1,2 +1,2 @@
-const require_as_table_root = require("./as-table-root-BQ5PA2SL.cjs");
+const require_as_table_root = require("./as-table-root-c2ep1IOv.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-Mvmfeg6Y.cjs";
+import { t as _default } from "./as-table-root.vue-CwQtwsIY.cjs";
 export = _default;

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

@@ -1,2 +1,2 @@
-import { t as _default } from "./as-table-root.vue-mhHmNm2I.mjs";
+import { t as _default } from "./as-table-root.vue-D1M2B9A_.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-BeyqcJUq.mjs";
+import { t as as_table_root_default } from "./as-table-root-_eZRGvAC.mjs";
 export { as_table_root_default as default };

package/dist/{as-table-root.vue-Mvmfeg6Y.d.cts → as-table-root.vue-CwQtwsIY.d.cts}

@@ -124,6 +124,11 @@ interface UsePresetsReturn {
   systemPresetsById: ComputedRef<Map<string, SystemPreset>>;
   /** False on 401/403 from initial load — UI hides itself. */
   available: ComputedRef<boolean>;
+  /**
+   * True while the preset rows load. Capabilities load beside it and never
+   * hold it (they arrive in `capabilities`); a load served from the session
+   * cache never sets it.
+   */
   loading: Ref<boolean>;
   /**
    * Load failure from `reload()`, or null. Mutator failures are NOT recorded
@@ -188,6 +193,14 @@ interface UsePresetsReturn {
  * Stateful: holds reactive `presets` / `userConf` / `capabilities` and
  * supports optimistic mutators that re-list after each successful write.
  *
+ * Once the app binds the viewer with `setMetaCacheIdentity()`, loads go
+ * through the browser session cache of `@atscript/ui-table`: a re-mount
+ * applies the cached rows synchronously (no request inside the max age,
+ * a background revalidation after it), capabilities load once per session,
+ * and a write here updates every other mounted consumer of the same
+ * `(url, app, tableKey)` — in this tab directly, in other tabs through a
+ * `BroadcastChannel`.
+ *
  * Active-preset selection (`activePresetId`) is **owned by the caller** —
  * the composable provides the ref but doesn't auto-resolve it on mount;
  * that's the table-state's responsibility (Slice 4) since it depends on
@@ -589,6 +602,14 @@ interface UseTableOptions {
   dragReleaseDebounceMs?: number;
   /** Factory to create a client from a URL. Only honored on the first `useTable`/`resolveValueHelp` call per URL — subsequent callers reuse the cached client. */
   clientFactory?: ClientFactory;
+  /**
+   * Store key for `/meta` revalidation (default: the URL). Pass the route
+   * template of a parametric mount (e.g. `"/api/db/ticket-issue/:key"`) so
+   * every key shares one stored `/meta`: a new key costs a `304`, not the
+   * full body. Only honored on the first call per URL, like `clientFactory`.
+   * Since 0.1.153.
+   */
+  metaKey?: string;
   /** Skin-slot overrides for table chrome (header cells, filter dialog, column menu, etc.). */
   controls?: TAsTableControls;
   /** Cell-type → component dispatch map. Use {@link createDefaultCellTypes} to seed defaults. */
@@ -1121,20 +1142,20 @@ type __VLS_Slots$2 = {} & { [K in NonNullable<typeof __VLS_28>]?: (props: typeof
   'query-loading'?: (props: typeof __VLS_31) => any;
 };
 declare const __VLS_base$2: vue.DefineComponent<__VLS_Props$2, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
-  "main-action": (row: Record<string, unknown>, absIndex: number, event: KeyboardEvent | MouseEvent) => any;
+  "main-action": (row: Record<string, unknown>, absIndex: number, event: MouseEvent | KeyboardEvent) => any;
   "row-click": (row: Record<string, unknown>, event: MouseEvent) => any;
   "row-dblclick": (row: Record<string, unknown>, event: MouseEvent) => any;
 }, string, vue.PublicProps, Readonly<__VLS_Props$2> & Readonly<{
-  "onMain-action"?: ((row: Record<string, unknown>, absIndex: number, event: KeyboardEvent | MouseEvent) => any) | undefined;
+  "onMain-action"?: ((row: Record<string, unknown>, absIndex: number, event: MouseEvent | KeyboardEvent) => any) | undefined;
   "onRow-click"?: ((row: Record<string, unknown>, event: MouseEvent) => any) | undefined;
   "onRow-dblclick"?: ((row: Record<string, unknown>, event: MouseEvent) => any) | undefined;
 }>, {
+  select: SelectionMode;
   stickyHeader: boolean;
   virtualOverscan: number;
   reorderable: boolean;
   resizable: boolean;
   columnMinWidth: number;
-  select: SelectionMode;
   selectOn: SelectOn;
   rowDelete: boolean | RowDeleteOpt;
   rowActionsColumn: RowActionsColumnPlacement | false;
@@ -1256,20 +1277,20 @@ type __VLS_Slots$1 = {} & { [K in NonNullable<typeof __VLS_24>]?: (props: typeof
   'query-loading'?: (props: typeof __VLS_27) => any;
 };
 declare const __VLS_base$1: vue.DefineComponent<__VLS_Props$1, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
-  "main-action": (row: Row, absIndex: number, event: KeyboardEvent | MouseEvent) => any;
+  "main-action": (row: Row, absIndex: number, event: MouseEvent | KeyboardEvent) => any;
   "row-click": (row: Row, event: MouseEvent) => any;
   "row-dblclick": (row: Row, event: MouseEvent) => any;
   error: (error: Error, kind: QueryErrorKind) => any;
 }, string, vue.PublicProps, Readonly<__VLS_Props$1> & Readonly<{
-  "onMain-action"?: ((row: Row, absIndex: number, event: KeyboardEvent | MouseEvent) => any) | undefined;
+  "onMain-action"?: ((row: Row, absIndex: number, event: MouseEvent | KeyboardEvent) => any) | undefined;
   "onRow-click"?: ((row: Row, event: MouseEvent) => any) | undefined;
   "onRow-dblclick"?: ((row: Row, event: MouseEvent) => any) | undefined;
   onError?: ((error: Error, kind: QueryErrorKind) => any) | undefined;
 }>, {
+  select: SelectionMode;
   reorderable: boolean;
   resizable: boolean;
   columnMinWidth: number;
-  select: SelectionMode;
   selectOn: SelectOn;
   rowDelete: boolean | RowDeleteOpt;
   rowActionsColumn: RowActionsColumnPlacement | false;
@@ -1382,7 +1403,14 @@ type __VLS_Props = {
    * a row's `$actions` gated away never appears. Since 0.1.134.
    */
   rowActions?: RowActionsConfig; /** Factory to create a client from a URL. Falls back to the app-wide default set via `setDefaultClientFactory` (or the built-in `new Client(url)` factory if unset). */
-  clientFactory?: ClientFactory; /** Skin-slot overrides for table chrome — header cells, filter dialog, column menu, etc. Use {@link createDefaultControls} to seed defaults. */
+  clientFactory?: ClientFactory;
+  /**
+   * Store key for `/meta` revalidation (default: the URL). Pass the route
+   * template of a parametric mount (e.g. `"/api/db/ticket-issue/:key"`) so
+   * a table opened for a new key revalidates the `/meta` already loaded for
+   * another key (a `304`) instead of downloading it. Since 0.1.153.
+   */
+  metaKey?: string; /** Skin-slot overrides for table chrome — header cells, filter dialog, column menu, etc. Use {@link createDefaultControls} to seed defaults. */
   controls?: TAsTableControls; /** Cell-type → component dispatch map. Use {@link createDefaultCellTypes} to seed defaults. */
   types?: TAsCellTypeComponents; /** Named cell-component overrides — looked up by `@ui.table.component "name"`. */
   components?: Record<string, Component>;
@@ -1554,12 +1582,13 @@ declare const __VLS_base: vue.DefineComponent<__VLS_PublicProps, {
   "update:querySelection": (value: QuerySelection | null) => any;
   "update:urlQuery": (value: string | undefined) => any;
 } & {
+  action: (action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: MouseEvent | KeyboardEvent | undefined) => any;
   "unsupported-filter": (issue: UnsupportedFilter) => any;
   "selection-reset": (event: SelectionResetEvent) => any;
   "fields-dropped": (report: DroppedFieldsReport) => any;
-  "main-action": (row: Record<string, unknown>, absIndex: number, event: KeyboardEvent | MouseEvent) => any;
-  action: (action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: KeyboardEvent | MouseEvent | undefined) => any;
+  "main-action": (row: Record<string, unknown>, absIndex: number, event: MouseEvent | KeyboardEvent) => any;
 }, string, vue.PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+  onAction?: ((action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: MouseEvent | KeyboardEvent | undefined) => any) | undefined;
   "onUnsupported-filter"?: ((issue: UnsupportedFilter) => any) | undefined;
   "onSelection-reset"?: ((event: SelectionResetEvent) => any) | undefined;
   "onFields-dropped"?: ((report: DroppedFieldsReport) => any) | undefined;
@@ -1571,8 +1600,7 @@ declare const __VLS_base: vue.DefineComponent<__VLS_PublicProps, {
   "onUpdate:selectedRows"?: ((value: unknown[]) => any) | undefined;
   "onUpdate:querySelection"?: ((value: QuerySelection | null) => any) | undefined;
   "onUpdate:urlQuery"?: ((value: string | undefined) => any) | undefined;
-  "onMain-action"?: ((row: Record<string, unknown>, absIndex: number, event: KeyboardEvent | MouseEvent) => any) | undefined;
-  onAction?: ((action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: KeyboardEvent | MouseEvent | undefined) => any) | undefined;
+  "onMain-action"?: ((row: Record<string, unknown>, absIndex: number, event: MouseEvent | KeyboardEvent) => any) | undefined;
 }>, {
   localSort: boolean;
   queryOnMount: boolean;

package/dist/{as-table-root.vue-mhHmNm2I.d.mts → as-table-root.vue-D1M2B9A_.d.mts}

@@ -124,6 +124,11 @@ interface UsePresetsReturn {
   systemPresetsById: ComputedRef<Map<string, SystemPreset>>;
   /** False on 401/403 from initial load — UI hides itself. */
   available: ComputedRef<boolean>;
+  /**
+   * True while the preset rows load. Capabilities load beside it and never
+   * hold it (they arrive in `capabilities`); a load served from the session
+   * cache never sets it.
+   */
   loading: Ref<boolean>;
   /**
    * Load failure from `reload()`, or null. Mutator failures are NOT recorded
@@ -188,6 +193,14 @@ interface UsePresetsReturn {
  * Stateful: holds reactive `presets` / `userConf` / `capabilities` and
  * supports optimistic mutators that re-list after each successful write.
  *
+ * Once the app binds the viewer with `setMetaCacheIdentity()`, loads go
+ * through the browser session cache of `@atscript/ui-table`: a re-mount
+ * applies the cached rows synchronously (no request inside the max age,
+ * a background revalidation after it), capabilities load once per session,
+ * and a write here updates every other mounted consumer of the same
+ * `(url, app, tableKey)` — in this tab directly, in other tabs through a
+ * `BroadcastChannel`.
+ *
  * Active-preset selection (`activePresetId`) is **owned by the caller** —
  * the composable provides the ref but doesn't auto-resolve it on mount;
  * that's the table-state's responsibility (Slice 4) since it depends on
@@ -589,6 +602,14 @@ interface UseTableOptions {
   dragReleaseDebounceMs?: number;
   /** Factory to create a client from a URL. Only honored on the first `useTable`/`resolveValueHelp` call per URL — subsequent callers reuse the cached client. */
   clientFactory?: ClientFactory;
+  /**
+   * Store key for `/meta` revalidation (default: the URL). Pass the route
+   * template of a parametric mount (e.g. `"/api/db/ticket-issue/:key"`) so
+   * every key shares one stored `/meta`: a new key costs a `304`, not the
+   * full body. Only honored on the first call per URL, like `clientFactory`.
+   * Since 0.1.153.
+   */
+  metaKey?: string;
   /** Skin-slot overrides for table chrome (header cells, filter dialog, column menu, etc.). */
   controls?: TAsTableControls;
   /** Cell-type → component dispatch map. Use {@link createDefaultCellTypes} to seed defaults. */
@@ -1121,20 +1142,20 @@ type __VLS_Slots$2 = {} & { [K in NonNullable<typeof __VLS_28>]?: (props: typeof
   'query-loading'?: (props: typeof __VLS_31) => any;
 };
 declare const __VLS_base$2: vue.DefineComponent<__VLS_Props$2, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
-  "main-action": (row: Record<string, unknown>, absIndex: number, event: KeyboardEvent | MouseEvent) => any;
+  "main-action": (row: Record<string, unknown>, absIndex: number, event: MouseEvent | KeyboardEvent) => any;
   "row-click": (row: Record<string, unknown>, event: MouseEvent) => any;
   "row-dblclick": (row: Record<string, unknown>, event: MouseEvent) => any;
 }, string, vue.PublicProps, Readonly<__VLS_Props$2> & Readonly<{
-  "onMain-action"?: ((row: Record<string, unknown>, absIndex: number, event: KeyboardEvent | MouseEvent) => any) | undefined;
+  "onMain-action"?: ((row: Record<string, unknown>, absIndex: number, event: MouseEvent | KeyboardEvent) => any) | undefined;
   "onRow-click"?: ((row: Record<string, unknown>, event: MouseEvent) => any) | undefined;
   "onRow-dblclick"?: ((row: Record<string, unknown>, event: MouseEvent) => any) | undefined;
 }>, {
+  select: SelectionMode;
   stickyHeader: boolean;
   virtualOverscan: number;
   reorderable: boolean;
   resizable: boolean;
   columnMinWidth: number;
-  select: SelectionMode;
   selectOn: SelectOn;
   rowDelete: boolean | RowDeleteOpt;
   rowActionsColumn: RowActionsColumnPlacement | false;
@@ -1256,20 +1277,20 @@ type __VLS_Slots$1 = {} & { [K in NonNullable<typeof __VLS_24>]?: (props: typeof
   'query-loading'?: (props: typeof __VLS_27) => any;
 };
 declare const __VLS_base$1: vue.DefineComponent<__VLS_Props$1, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
-  "main-action": (row: Row, absIndex: number, event: KeyboardEvent | MouseEvent) => any;
+  "main-action": (row: Row, absIndex: number, event: MouseEvent | KeyboardEvent) => any;
   "row-click": (row: Row, event: MouseEvent) => any;
   "row-dblclick": (row: Row, event: MouseEvent) => any;
   error: (error: Error, kind: QueryErrorKind) => any;
 }, string, vue.PublicProps, Readonly<__VLS_Props$1> & Readonly<{
-  "onMain-action"?: ((row: Row, absIndex: number, event: KeyboardEvent | MouseEvent) => any) | undefined;
+  "onMain-action"?: ((row: Row, absIndex: number, event: MouseEvent | KeyboardEvent) => any) | undefined;
   "onRow-click"?: ((row: Row, event: MouseEvent) => any) | undefined;
   "onRow-dblclick"?: ((row: Row, event: MouseEvent) => any) | undefined;
   onError?: ((error: Error, kind: QueryErrorKind) => any) | undefined;
 }>, {
+  select: SelectionMode;
   reorderable: boolean;
   resizable: boolean;
   columnMinWidth: number;
-  select: SelectionMode;
   selectOn: SelectOn;
   rowDelete: boolean | RowDeleteOpt;
   rowActionsColumn: RowActionsColumnPlacement | false;
@@ -1382,7 +1403,14 @@ type __VLS_Props = {
    * a row's `$actions` gated away never appears. Since 0.1.134.
    */
   rowActions?: RowActionsConfig; /** Factory to create a client from a URL. Falls back to the app-wide default set via `setDefaultClientFactory` (or the built-in `new Client(url)` factory if unset). */
-  clientFactory?: ClientFactory; /** Skin-slot overrides for table chrome — header cells, filter dialog, column menu, etc. Use {@link createDefaultControls} to seed defaults. */
+  clientFactory?: ClientFactory;
+  /**
+   * Store key for `/meta` revalidation (default: the URL). Pass the route
+   * template of a parametric mount (e.g. `"/api/db/ticket-issue/:key"`) so
+   * a table opened for a new key revalidates the `/meta` already loaded for
+   * another key (a `304`) instead of downloading it. Since 0.1.153.
+   */
+  metaKey?: string; /** Skin-slot overrides for table chrome — header cells, filter dialog, column menu, etc. Use {@link createDefaultControls} to seed defaults. */
   controls?: TAsTableControls; /** Cell-type → component dispatch map. Use {@link createDefaultCellTypes} to seed defaults. */
   types?: TAsCellTypeComponents; /** Named cell-component overrides — looked up by `@ui.table.component "name"`. */
   components?: Record<string, Component>;
@@ -1554,12 +1582,13 @@ declare const __VLS_base: vue.DefineComponent<__VLS_PublicProps, {
   "update:querySelection": (value: QuerySelection | null) => any;
   "update:urlQuery": (value: string | undefined) => any;
 } & {
+  action: (action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: MouseEvent | KeyboardEvent | undefined) => any;
   "unsupported-filter": (issue: UnsupportedFilter) => any;
   "selection-reset": (event: SelectionResetEvent) => any;
   "fields-dropped": (report: DroppedFieldsReport) => any;
-  "main-action": (row: Record<string, unknown>, absIndex: number, event: KeyboardEvent | MouseEvent) => any;
-  action: (action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: KeyboardEvent | MouseEvent | undefined) => any;
+  "main-action": (row: Record<string, unknown>, absIndex: number, event: MouseEvent | KeyboardEvent) => any;
 }, string, vue.PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+  onAction?: ((action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: MouseEvent | KeyboardEvent | undefined) => any) | undefined;
   "onUnsupported-filter"?: ((issue: UnsupportedFilter) => any) | undefined;
   "onSelection-reset"?: ((event: SelectionResetEvent) => any) | undefined;
   "onFields-dropped"?: ((report: DroppedFieldsReport) => any) | undefined;
@@ -1571,8 +1600,7 @@ declare const __VLS_base: vue.DefineComponent<__VLS_PublicProps, {
   "onUpdate:selectedRows"?: ((value: unknown[]) => any) | undefined;
   "onUpdate:querySelection"?: ((value: QuerySelection | null) => any) | undefined;
   "onUpdate:urlQuery"?: ((value: string | undefined) => any) | undefined;
-  "onMain-action"?: ((row: Record<string, unknown>, absIndex: number, event: KeyboardEvent | MouseEvent) => any) | undefined;
-  onAction?: ((action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: KeyboardEvent | MouseEvent | undefined) => any) | undefined;
+  "onMain-action"?: ((row: Record<string, unknown>, absIndex: number, event: MouseEvent | KeyboardEvent) => any) | undefined;
 }>, {
   localSort: boolean;
   queryOnMount: boolean;

package/dist/as-table.d.cts

@@ -1,2 +1,2 @@
-import { L as _default } from "./as-table-root.vue-Mvmfeg6Y.cjs";
+import { L as _default } from "./as-table-root.vue-CwQtwsIY.cjs";
 export = _default;

package/dist/as-table.d.mts

@@ -1,2 +1,2 @@
-import { L as _default } from "./as-table-root.vue-mhHmNm2I.mjs";
+import { L as _default } from "./as-table-root.vue-D1M2B9A_.mjs";
 export { _default as default };

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

@@ -1,2 +1,2 @@
-import { I as _default } from "./as-table-root.vue-Mvmfeg6Y.cjs";
+import { I as _default } from "./as-table-root.vue-CwQtwsIY.cjs";
 export = _default;

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

@@ -1,2 +1,2 @@
-import { I as _default } from "./as-table-root.vue-mhHmNm2I.mjs";
+import { I as _default } from "./as-table-root.vue-D1M2B9A_.mjs";
 export { _default as default };

package/dist/index.cjs

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_use_table_state = require("./use-table-state-zE3BpeA7.cjs");
 const require_get_cell_value = require("./get-cell-value-CJT4fk4y.cjs");
 const require_use_table_selection = require("./use-table-selection-Cs7-gjHg.cjs");
-const require_use_table = require("./use-table-B3CvWW_y.cjs");
+const require_use_table = require("./use-table-nZElzw2r.cjs");
 const require_use_cell_locale = require("./use-cell-locale-Dy5Rf1yp.cjs");
 const require_use_table_nav_bridge = require("./use-table-nav-bridge-C43u266u.cjs");
 const require_use_table_component = require("./use-table-component-Daap95CE.cjs");
@@ -15,17 +15,17 @@ const require_as_cell_union = require("./as-cell-union-DpCEHLzN.cjs");
 const require_as_column_menu = require("./as-column-menu-ChB7hzmr.cjs");
 const require_as_config_dialog = require("./as-config-dialog-XSkaW1X0.cjs");
 const require_as_confirm_dialog = require("./as-confirm-dialog-pcKkl-Qo.cjs");
-const require_as_filter_field = require("./as-filter-field-BPPMOZ9M.cjs");
+const require_as_filter_field = require("./as-filter-field-BFCTuRAa.cjs");
 const require_as_filter_input = require("./as-filter-input-DZkhoSWO.cjs");
-const require_as_filter_dialog = require("./as-filter-dialog-Cd16xRfM.cjs");
+const require_as_filter_dialog = require("./as-filter-dialog-BB9M5PhT.cjs");
 const require_as_table_header_cell = require("./as-table-header-cell-Ch0J_Axe.cjs");
 const require_as_window_table = require("./as-window-table-BvUfaBj8.cjs");
 const require_as_table_cell_value = require("./as-table-cell-value-CGBk-KWx.cjs");
 const require_as_residual_filter = require("./as-residual-filter-BGz7pSdL.cjs");
-const require_as_filters = require("./as-filters-C22XxgEx.cjs");
+const require_as_filters = require("./as-filters-9kFdHR4q.cjs");
 const require_as_preset_dialog = require("./as-preset-dialog-CFvmrXGP.cjs");
 const require_as_row_actions = require("./as-row-actions-S_IVb5c2.cjs");
-const require_as_table_root = require("./as-table-root-BQ5PA2SL.cjs");
+const require_as_table_root = require("./as-table-root-c2ep1IOv.cjs");
 const require_as_table = require("./as-table-BIKHGH4x.cjs");
 const require_as_table_actions = require("./as-table-actions-CgMktjjD.cjs");
 const require_as_preset_picker = require("./as-preset-picker-DjV1c6Kh.cjs");

package/dist/index.d.cts

@@ -1,8 +1,8 @@
 import { t as _default$11 } from "./as-filters.vue-vH1FHn9L.cjs";
 import { t as _default$13 } from "./as-preset-picker.vue-DfXS3pGl.cjs";
 import { A as RowSelectableHook, B as TableSelection, C as ResolvedRowActions, D as RowClassHook, E as RowAttrsHook, F as TAsCellTypeComponents, I as TAsTableControls, L as TVueTableActionInfo, M as SelectAllState, N as SelectOn, O as RowDeleteOpt, P as SelectionResetEvent, R as TableActionsState, S as ReactiveTableState, T as RowActionsConfig, V as resolveRowActions, _ as MainActionRequest, a as identifierFieldsOf, b as QueryErrorKind, c as ActionResult, d as ConfigTab, g as LocalRowAction, h as InvokeOpts, i as extractIdentifier, j as RowSelectableVerdict, k as RowHookContext, l as ApplyUrlQueryOptions, n as QUERY_TARGET_UNSUPPORTED_REASON, o as queryTargetGate, p as DroppedFieldsReport, r as actionIdentifiers, s as ActionQueryTarget, u as ColumnMenuConfig, v as NavKeyOptions, x as QuerySelection, z as TableNavBridge } from "./intent-scope-CGch9yhy.cjs";
-import { t as _default$16 } from "./as-table-actions.vue-D8KKwLdM.cjs";
-import { $ as ExportProgress, A as getColumnWidth, B as UseAppPrefsReturn, C as getDefaultClientFactory, Ct as UsePresetsOptions, D as setDefaultClientFactory, Dt as UseLocalDraftOptions, E as resolveSystemPresets, Et as StorageLike, F as createDefaultControls, G as TableUrlQueryRouter, H as AS_PRESETS_APP, I as _default$20, J as useTableActions, K as UseTableUrlQueryOptions, L as _default$15, M as provideCellLocale, N as useCellLocale, O as formatCellValue, Ot as UseLocalDraftReturn, P as createDefaultCellTypes, Q as ExportCellFormatter, R as useTableComponent, S as UserConfData, St as ActivePresetView, T as resetDefaultClientFactory, Tt as usePresets, U as injectPresetsApp, V as useAppPrefs, W as TableUrlQueryRoute, X as useTableFilter, Y as useTableSearch, Z as useTableNavBridge, _ as SYSTEM_PRESET_PREFIX, _t as createStaticTableState, a as CsvOptions, at as UseTableOptions, b as SystemPresetInput, bt as useTableContext, c as ExportScalar, ct as SelectionPersistence, d as PresetCapabilities, dt as CreateStaticTableStateOptions, et as ExportResult, f as PresetData, ft as CreateTableStateOptions, g as STANDARD_PRESET_ID, gt as TableStateInternals, h as QueryOptions, ht as TableModelRefs, i as ClientFactory, it as useTableExport, j as CellLocale, k as getCellValue, kt as useLocalDraft, l as PRESET_ASPECTS, lt as useTableSelection, m as PresetSnapshotWire, mt as TableContext, n as AppConfData, nt as UseTableExportReturn, o as DisplayColumnDef, ot as clearTableCache, p as PresetSnapshot, pt as QueryFn, q as useTableUrlQuery, r as AsPresetEntryRow, rt as downloadExport, s as ExportAbortError, st as useTable, t as _default$19, tt as ExportRowsOptions, u as PresetAspect, ut as BuildQueryOptions, v as SelectionQuery, vt as createTableState, w as isSystemPresetId, wt as UsePresetsReturn, x as UrlQuerySync, xt as useTableContextOptional, y as SystemPreset, yt as provideTableContext, z as UseAppPrefsOptions } from "./as-table-root.vue-Mvmfeg6Y.cjs";
+import { t as _default$16 } from "./as-table-actions.vue-Dzi8wX-e.cjs";
+import { $ as ExportProgress, A as getColumnWidth, B as UseAppPrefsReturn, C as getDefaultClientFactory, Ct as UsePresetsOptions, D as setDefaultClientFactory, Dt as UseLocalDraftOptions, E as resolveSystemPresets, Et as StorageLike, F as createDefaultControls, G as TableUrlQueryRouter, H as AS_PRESETS_APP, I as _default$20, J as useTableActions, K as UseTableUrlQueryOptions, L as _default$15, M as provideCellLocale, N as useCellLocale, O as formatCellValue, Ot as UseLocalDraftReturn, P as createDefaultCellTypes, Q as ExportCellFormatter, R as useTableComponent, S as UserConfData, St as ActivePresetView, T as resetDefaultClientFactory, Tt as usePresets, U as injectPresetsApp, V as useAppPrefs, W as TableUrlQueryRoute, X as useTableFilter, Y as useTableSearch, Z as useTableNavBridge, _ as SYSTEM_PRESET_PREFIX, _t as createStaticTableState, a as CsvOptions, at as UseTableOptions, b as SystemPresetInput, bt as useTableContext, c as ExportScalar, ct as SelectionPersistence, d as PresetCapabilities, dt as CreateStaticTableStateOptions, et as ExportResult, f as PresetData, ft as CreateTableStateOptions, g as STANDARD_PRESET_ID, gt as TableStateInternals, h as QueryOptions, ht as TableModelRefs, i as ClientFactory, it as useTableExport, j as CellLocale, k as getCellValue, kt as useLocalDraft, l as PRESET_ASPECTS, lt as useTableSelection, m as PresetSnapshotWire, mt as TableContext, n as AppConfData, nt as UseTableExportReturn, o as DisplayColumnDef, ot as clearTableCache, p as PresetSnapshot, pt as QueryFn, q as useTableUrlQuery, r as AsPresetEntryRow, rt as downloadExport, s as ExportAbortError, st as useTable, t as _default$19, tt as ExportRowsOptions, u as PresetAspect, ut as BuildQueryOptions, v as SelectionQuery, vt as createTableState, w as isSystemPresetId, wt as UsePresetsReturn, x as UrlQuerySync, xt as useTableContextOptional, y as SystemPreset, yt as provideTableContext, z as UseAppPrefsOptions } from "./as-table-root.vue-CwQtwsIY.cjs";
 import { t as _default } from "./as-cell-array.vue-C4BTM8YW.cjs";
 import { t as _default$1 } from "./as-cell-date.vue-DwTSTjsj.cjs";
 import { t as _default$2 } from "./as-cell-json.vue-pwE9uJdv.cjs";

package/dist/index.d.mts

@@ -1,8 +1,8 @@
 import { t as _default$11 } from "./as-filters.vue-Bu4wK0iD.mjs";
 import { t as _default$13 } from "./as-preset-picker.vue-DAUZOlOD.mjs";
 import { A as RowSelectableHook, B as TableSelection, C as ResolvedRowActions, D as RowClassHook, E as RowAttrsHook, F as TAsCellTypeComponents, I as TAsTableControls, L as TVueTableActionInfo, M as SelectAllState, N as SelectOn, O as RowDeleteOpt, P as SelectionResetEvent, R as TableActionsState, S as ReactiveTableState, T as RowActionsConfig, V as resolveRowActions, _ as MainActionRequest, a as identifierFieldsOf, b as QueryErrorKind, c as ActionResult, d as ConfigTab, g as LocalRowAction, h as InvokeOpts, i as extractIdentifier, j as RowSelectableVerdict, k as RowHookContext, l as ApplyUrlQueryOptions, n as QUERY_TARGET_UNSUPPORTED_REASON, o as queryTargetGate, p as DroppedFieldsReport, r as actionIdentifiers, s as ActionQueryTarget, u as ColumnMenuConfig, v as NavKeyOptions, x as QuerySelection, z as TableNavBridge } from "./intent-scope-CvD4YOvf.mjs";
-import { t as _default$16 } from "./as-table-actions.vue-BMC3nQ5z.mjs";
-import { $ as ExportProgress, A as getColumnWidth, B as UseAppPrefsReturn, C as getDefaultClientFactory, Ct as UsePresetsOptions, D as setDefaultClientFactory, Dt as UseLocalDraftOptions, E as resolveSystemPresets, Et as StorageLike, F as createDefaultControls, G as TableUrlQueryRouter, H as AS_PRESETS_APP, I as _default$20, J as useTableActions, K as UseTableUrlQueryOptions, L as _default$15, M as provideCellLocale, N as useCellLocale, O as formatCellValue, Ot as UseLocalDraftReturn, P as createDefaultCellTypes, Q as ExportCellFormatter, R as useTableComponent, S as UserConfData, St as ActivePresetView, T as resetDefaultClientFactory, Tt as usePresets, U as injectPresetsApp, V as useAppPrefs, W as TableUrlQueryRoute, X as useTableFilter, Y as useTableSearch, Z as useTableNavBridge, _ as SYSTEM_PRESET_PREFIX, _t as createStaticTableState, a as CsvOptions, at as UseTableOptions, b as SystemPresetInput, bt as useTableContext, c as ExportScalar, ct as SelectionPersistence, d as PresetCapabilities, dt as CreateStaticTableStateOptions, et as ExportResult, f as PresetData, ft as CreateTableStateOptions, g as STANDARD_PRESET_ID, gt as TableStateInternals, h as QueryOptions, ht as TableModelRefs, i as ClientFactory, it as useTableExport, j as CellLocale, k as getCellValue, kt as useLocalDraft, l as PRESET_ASPECTS, lt as useTableSelection, m as PresetSnapshotWire, mt as TableContext, n as AppConfData, nt as UseTableExportReturn, o as DisplayColumnDef, ot as clearTableCache, p as PresetSnapshot, pt as QueryFn, q as useTableUrlQuery, r as AsPresetEntryRow, rt as downloadExport, s as ExportAbortError, st as useTable, t as _default$19, tt as ExportRowsOptions, u as PresetAspect, ut as BuildQueryOptions, v as SelectionQuery, vt as createTableState, w as isSystemPresetId, wt as UsePresetsReturn, x as UrlQuerySync, xt as useTableContextOptional, y as SystemPreset, yt as provideTableContext, z as UseAppPrefsOptions } from "./as-table-root.vue-mhHmNm2I.mjs";
+import { t as _default$16 } from "./as-table-actions.vue-DNNYGVQW.mjs";
+import { $ as ExportProgress, A as getColumnWidth, B as UseAppPrefsReturn, C as getDefaultClientFactory, Ct as UsePresetsOptions, D as setDefaultClientFactory, Dt as UseLocalDraftOptions, E as resolveSystemPresets, Et as StorageLike, F as createDefaultControls, G as TableUrlQueryRouter, H as AS_PRESETS_APP, I as _default$20, J as useTableActions, K as UseTableUrlQueryOptions, L as _default$15, M as provideCellLocale, N as useCellLocale, O as formatCellValue, Ot as UseLocalDraftReturn, P as createDefaultCellTypes, Q as ExportCellFormatter, R as useTableComponent, S as UserConfData, St as ActivePresetView, T as resetDefaultClientFactory, Tt as usePresets, U as injectPresetsApp, V as useAppPrefs, W as TableUrlQueryRoute, X as useTableFilter, Y as useTableSearch, Z as useTableNavBridge, _ as SYSTEM_PRESET_PREFIX, _t as createStaticTableState, a as CsvOptions, at as UseTableOptions, b as SystemPresetInput, bt as useTableContext, c as ExportScalar, ct as SelectionPersistence, d as PresetCapabilities, dt as CreateStaticTableStateOptions, et as ExportResult, f as PresetData, ft as CreateTableStateOptions, g as STANDARD_PRESET_ID, gt as TableStateInternals, h as QueryOptions, ht as TableModelRefs, i as ClientFactory, it as useTableExport, j as CellLocale, k as getCellValue, kt as useLocalDraft, l as PRESET_ASPECTS, lt as useTableSelection, m as PresetSnapshotWire, mt as TableContext, n as AppConfData, nt as UseTableExportReturn, o as DisplayColumnDef, ot as clearTableCache, p as PresetSnapshot, pt as QueryFn, q as useTableUrlQuery, r as AsPresetEntryRow, rt as downloadExport, s as ExportAbortError, st as useTable, t as _default$19, tt as ExportRowsOptions, u as PresetAspect, ut as BuildQueryOptions, v as SelectionQuery, vt as createTableState, w as isSystemPresetId, wt as UsePresetsReturn, x as UrlQuerySync, xt as useTableContextOptional, y as SystemPreset, yt as provideTableContext, z as UseAppPrefsOptions } from "./as-table-root.vue-D1M2B9A_.mjs";
 import { t as _default } from "./as-cell-array.vue-D4vS7C_D.mjs";
 import { t as _default$1 } from "./as-cell-date.vue-Dyq2-vg9.mjs";
 import { t as _default$2 } from "./as-cell-json.vue-C0_LDvQw.mjs";

package/dist/index.mjs

@@ -1,7 +1,7 @@
 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-DzvCmxEx.mjs";
 import { t as getCellValue } from "./get-cell-value-Cb3X8nUn.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-CTCYFwrE.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-D86LSCnG.mjs";
 import { n as useCellLocale, t as provideCellLocale } from "./use-cell-locale-Bye0ANIP.mjs";
 import { t as useTableNavBridge } from "./use-table-nav-bridge-Ch61msQs.mjs";
 import { t as useTableComponent } from "./use-table-component-B9QRSvoR.mjs";
@@ -14,17 +14,17 @@ 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-DW4WfYEi.mjs";
 import { t as as_confirm_dialog_default } from "./as-confirm-dialog-rWRl5z4R.mjs";
-import { t as as_filter_field_default } from "./as-filter-field-DEBQQy_6.mjs";
+import { t as as_filter_field_default } from "./as-filter-field-BxZwGNoI.mjs";
 import { t as as_filter_input_default } from "./as-filter-input-DeI85XVZ.mjs";
-import { t as as_filter_dialog_default } from "./as-filter-dialog-8xvnKXTd.mjs";
+import { t as as_filter_dialog_default } from "./as-filter-dialog-DA7vdmUO.mjs";
 import { t as as_table_header_cell_default } from "./as-table-header-cell-Bg5wAPHv.mjs";
 import { t as as_window_table_default } from "./as-window-table-Cf523h8Q.mjs";
 import { t as as_table_cell_value_default } from "./as-table-cell-value-BYJd-QRA.mjs";
 import { t as as_residual_filter_default } from "./as-residual-filter-BoeOL9AJ.mjs";
-import { t as as_filters_default } from "./as-filters-CT1ks7gu.mjs";
+import { t as as_filters_default } from "./as-filters-Cu8Hulrv.mjs";
 import { t as as_preset_dialog_default } from "./as-preset-dialog-BXL8yt8O.mjs";
 import { t as as_row_actions_default } from "./as-row-actions-QN_UFuah.mjs";
-import { t as as_table_root_default } from "./as-table-root-BeyqcJUq.mjs";
+import { t as as_table_root_default } from "./as-table-root-_eZRGvAC.mjs";
 import { t as as_table_default } from "./as-table-DEjvo36o.mjs";
 import { t as as_table_actions_default } from "./as-table-actions-m-QLy2Ys.mjs";
 import { t as as_preset_picker_default } from "./as-preset-picker-IVVvFw6r.mjs";

package/dist/{use-table-CTCYFwrE.mjs → use-table-D86LSCnG.mjs}

@@ -1,9 +1,9 @@
 import { l as DEFAULT_AVAILABLE_ASPECTS, n as createTableState, r as provideTableContext } from "./use-table-state-DzvCmxEx.mjs";
 import { n as useTableSelection } from "./use-table-selection-CdaOPo1d.mjs";
 import { n as useCellLocale } from "./use-cell-locale-Bye0ANIP.mjs";
-import { createTableDef, getMetaEntry, resetMetaCache } from "@atscript/ui";
-import { computed, getCurrentInstance, 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";
+import { getMetaEntry, getMetaTableDef, resetMetaCache } from "@atscript/ui";
+import { computed, getCurrentInstance, getCurrentScope, inject, isRef, onScopeDispose, ref, shallowRef, toValue, watch } from "vue";
+import { PresetsClient, STANDARD_PRESET_ID, cachedPresetCapabilities, cachedPresetRows, debounce, deserializeDraft, isEmptyDraft, isPresetsCacheActive, isSystemPresetId, isUnavailableError, loadPresetCapabilities, loadPresetRows, presetsCacheKey, publishPresetsWrite, resolveSystemPresets, serializeDraft, sharedPresetsClient, stableStringify, subscribePresetsCache } from "@atscript/ui-table";
 //#region src/composables/as-presets-app.ts
 /**
 * App-wide injection key for the presets system. The host app calls
@@ -174,6 +174,14 @@ function resolveStorage(provided) {
 * Stateful: holds reactive `presets` / `userConf` / `capabilities` and
 * supports optimistic mutators that re-list after each successful write.
 *
+* Once the app binds the viewer with `setMetaCacheIdentity()`, loads go
+* through the browser session cache of `@atscript/ui-table`: a re-mount
+* applies the cached rows synchronously (no request inside the max age,
+* a background revalidation after it), capabilities load once per session,
+* and a write here updates every other mounted consumer of the same
+* `(url, app, tableKey)` — in this tab directly, in other tabs through a
+* `BroadcastChannel`.
+*
 * Active-preset selection (`activePresetId`) is **owned by the caller** —
 * the composable provides the ref but doesn't auto-resolve it on mount;
 * that's the table-state's responsibility (Slice 4) since it depends on
@@ -182,10 +190,13 @@ function resolveStorage(provided) {
 function usePresets(opts) {
 	const app = injectPresetsApp(opts.app);
 	if (!opts.tableKey) throw new Error("[vue-table] usePresets: `tableKey` is required");
+	const cached = isPresetsCacheActive();
+	const cacheKey = presetsCacheKey(opts.url, app, opts.tableKey);
 	const client = new PresetsClient({
 		url: opts.url,
 		app,
 		tableKey: opts.tableKey,
+		client: cached ? sharedPresetsClient(opts.url, opts.clientFactory) : void 0,
 		clientFactory: opts.clientFactory
 	});
 	const systemPresetsResolved = computed(() => resolveSystemPresets(opts.systemPresets));
@@ -237,11 +248,68 @@ function usePresets(opts) {
 		const me = currentUser.value;
 		return me !== null && row.user === me;
 	}
+	function applyRows(rows) {
+		denied.value = false;
+		presets.value = rows.presets;
+		userConf.value = rows.userConf;
+	}
+	function applyDenied() {
+		denied.value = true;
+		presets.value = [];
+		userConf.value = null;
+		capabilities.value = null;
+	}
+	function applyResult(result) {
+		if (result.denied) applyDenied();
+		else applyRows(result);
+	}
+	const listener = {
+		onRows: applyRows,
+		onCapabilities: (caps) => {
+			if (!denied.value) capabilities.value = caps;
+		},
+		refresh: (full) => {
+			revalidate();
+			if (full) loadCapabilities();
+		}
+	};
+	if (cached && getCurrentScope()) onScopeDispose(subscribePresetsCache(cacheKey, listener));
+	function fetchRows(force) {
+		const fetch = () => client.list({ capabilities: false });
+		return cached ? loadPresetRows(cacheKey, fetch, {
+			force,
+			origin: listener
+		}) : fetch();
+	}
+	/**
+	* Capabilities load beside the rows and never block the first query —
+	* only the rows (default preset) and the table definition do. They only
+	* gate save / publish / limit UI.
+	*/
+	async function loadCapabilities() {
+		const hit = cached ? cachedPresetCapabilities(cacheKey) : void 0;
+		if (hit) {
+			if (!denied.value) capabilities.value = hit;
+			return;
+		}
+		const fetch = () => client.loadCapabilities();
+		try {
+			const caps = await (cached ? loadPresetCapabilities(cacheKey, fetch, listener) : fetch());
+			if (!denied.value) capabilities.value = caps;
+		} catch {
+			capabilities.value = null;
+		}
+	}
+	/** Background row refresh: no `loading`, failures keep what is shown. */
+	async function revalidate() {
+		try {
+			applyResult(await fetchRows(true));
+		} catch {}
+	}
 	/**
 	* @param opts.capabilities — set `false` for refresh-after-mutation calls
 	*   (fav-toggle, save, rename, delete, public-toggle, set-default) where
-	*   role-derived capabilities can't have changed. Default `true`, used
-	*   only on the initial mount load.
+	*   role-derived capabilities can't have changed. Default `true`.
 	*/
 	let batchDepth = 0;
 	let reloadPending = false;
@@ -250,7 +318,12 @@ function usePresets(opts) {
 			reloadPending = true;
 			return;
 		}
+		await reloadAfterWrite();
+	}
+	/** The trailing reload of a write: refreshes the shared entry (other mounted tables follow) and tells other tabs. */
+	async function reloadAfterWrite() {
 		await reload({ capabilities: false });
+		if (cached) publishPresetsWrite(cacheKey);
 	}
 	async function batch(fn) {
 		batchDepth++;
@@ -260,32 +333,23 @@ function usePresets(opts) {
 			batchDepth--;
 			if (batchDepth === 0 && reloadPending) {
 				reloadPending = false;
-				await reload({ capabilities: false });
+				await reloadAfterWrite();
 			}
 		}
 	}
-	async function reload(opts = {}) {
+	async function reload(reloadOpts = {}) {
+		if (reloadOpts.capabilities !== false) loadCapabilities();
+		await load(true);
+	}
+	/** Foreground row load: drives `loading` and `error`. */
+	async function load(force) {
 		loading.value = true;
 		error.value = null;
 		try {
-			const result = await client.list(opts);
-			if (result.denied) {
-				denied.value = true;
-				presets.value = [];
-				userConf.value = null;
-				capabilities.value = null;
-				return;
-			}
-			denied.value = false;
-			presets.value = result.presets;
-			userConf.value = result.userConf;
-			if (result.capabilities !== void 0) capabilities.value = result.capabilities;
+			applyResult(await fetchRows(force));
 		} catch (err) {
 			if (isUnavailableError(err)) {
-				denied.value = true;
-				presets.value = [];
-				userConf.value = null;
-				capabilities.value = null;
+				applyDenied();
 				return;
 			}
 			error.value = err;
@@ -294,6 +358,19 @@ function usePresets(opts) {
 			loading.value = false;
 		}
 	}
+	/**
+	* Initial load. From the session cache when it holds this scope: rows are
+	* applied synchronously (the default preset resolves with no network
+	* wait) and revalidated in the background once past the max age — a
+	* revalidation updates the list but never re-applies the default.
+	*/
+	async function initialLoad() {
+		const hit = cached ? cachedPresetRows(cacheKey) : void 0;
+		if (hit) applyRows(hit.rows);
+		loadCapabilities();
+		if (!hit) await load(false);
+		else if (!hit.fresh) await revalidate();
+	}
 	async function savePreset(snapshot) {
 		const id = activePresetId.value;
 		if (!id) throw new Error("[vue-table] usePresets.savePreset: no active preset");
@@ -352,7 +429,7 @@ function usePresets(opts) {
 		};
 		await maybeReloadAfterMutation();
 	}
-	if (opts.autoLoad !== false) reload();
+	if (opts.autoLoad !== false) initialLoad();
 	return {
 		presets,
 		presetsById,
@@ -409,10 +486,9 @@ function finalizeTableState(state, client, opts) {
 * @param url — Table endpoint URL (e.g. "/db/tables/products")
 */
 function useTable(url, opts) {
-	const entry = getMetaEntry(url, opts?.clientFactory);
-	if (!entry.tableDef) entry.tableDef = Promise.all([entry.meta, entry.type]).then(([meta, type]) => createTableDef(meta, type));
+	const entry = getMetaEntry(url, opts?.clientFactory, { metaKey: opts?.metaKey });
 	const { client } = entry;
-	const defPromise = entry.tableDef;
+	const defPromise = getMetaTableDef(entry);
 	const cellLocale = getCurrentInstance() ? useCellLocale() : void 0;
 	const preset = opts?.preset;
 	const presetsHandle = preset ? usePresets({

package/dist/{use-table-B3CvWW_y.cjs → use-table-nZElzw2r.cjs}

@@ -174,6 +174,14 @@ function resolveStorage(provided) {
 * Stateful: holds reactive `presets` / `userConf` / `capabilities` and
 * supports optimistic mutators that re-list after each successful write.
 *
+* Once the app binds the viewer with `setMetaCacheIdentity()`, loads go
+* through the browser session cache of `@atscript/ui-table`: a re-mount
+* applies the cached rows synchronously (no request inside the max age,
+* a background revalidation after it), capabilities load once per session,
+* and a write here updates every other mounted consumer of the same
+* `(url, app, tableKey)` — in this tab directly, in other tabs through a
+* `BroadcastChannel`.
+*
 * Active-preset selection (`activePresetId`) is **owned by the caller** —
 * the composable provides the ref but doesn't auto-resolve it on mount;
 * that's the table-state's responsibility (Slice 4) since it depends on
@@ -182,10 +190,13 @@ function resolveStorage(provided) {
 function usePresets(opts) {
 	const app = injectPresetsApp(opts.app);
 	if (!opts.tableKey) throw new Error("[vue-table] usePresets: `tableKey` is required");
+	const cached = (0, _atscript_ui_table.isPresetsCacheActive)();
+	const cacheKey = (0, _atscript_ui_table.presetsCacheKey)(opts.url, app, opts.tableKey);
 	const client = new _atscript_ui_table.PresetsClient({
 		url: opts.url,
 		app,
 		tableKey: opts.tableKey,
+		client: cached ? (0, _atscript_ui_table.sharedPresetsClient)(opts.url, opts.clientFactory) : void 0,
 		clientFactory: opts.clientFactory
 	});
 	const systemPresetsResolved = (0, vue.computed)(() => (0, _atscript_ui_table.resolveSystemPresets)(opts.systemPresets));
@@ -237,11 +248,68 @@ function usePresets(opts) {
 		const me = currentUser.value;
 		return me !== null && row.user === me;
 	}
+	function applyRows(rows) {
+		denied.value = false;
+		presets.value = rows.presets;
+		userConf.value = rows.userConf;
+	}
+	function applyDenied() {
+		denied.value = true;
+		presets.value = [];
+		userConf.value = null;
+		capabilities.value = null;
+	}
+	function applyResult(result) {
+		if (result.denied) applyDenied();
+		else applyRows(result);
+	}
+	const listener = {
+		onRows: applyRows,
+		onCapabilities: (caps) => {
+			if (!denied.value) capabilities.value = caps;
+		},
+		refresh: (full) => {
+			revalidate();
+			if (full) loadCapabilities();
+		}
+	};
+	if (cached && (0, vue.getCurrentScope)()) (0, vue.onScopeDispose)((0, _atscript_ui_table.subscribePresetsCache)(cacheKey, listener));
+	function fetchRows(force) {
+		const fetch = () => client.list({ capabilities: false });
+		return cached ? (0, _atscript_ui_table.loadPresetRows)(cacheKey, fetch, {
+			force,
+			origin: listener
+		}) : fetch();
+	}
+	/**
+	* Capabilities load beside the rows and never block the first query —
+	* only the rows (default preset) and the table definition do. They only
+	* gate save / publish / limit UI.
+	*/
+	async function loadCapabilities() {
+		const hit = cached ? (0, _atscript_ui_table.cachedPresetCapabilities)(cacheKey) : void 0;
+		if (hit) {
+			if (!denied.value) capabilities.value = hit;
+			return;
+		}
+		const fetch = () => client.loadCapabilities();
+		try {
+			const caps = await (cached ? (0, _atscript_ui_table.loadPresetCapabilities)(cacheKey, fetch, listener) : fetch());
+			if (!denied.value) capabilities.value = caps;
+		} catch {
+			capabilities.value = null;
+		}
+	}
+	/** Background row refresh: no `loading`, failures keep what is shown. */
+	async function revalidate() {
+		try {
+			applyResult(await fetchRows(true));
+		} catch {}
+	}
 	/**
 	* @param opts.capabilities — set `false` for refresh-after-mutation calls
 	*   (fav-toggle, save, rename, delete, public-toggle, set-default) where
-	*   role-derived capabilities can't have changed. Default `true`, used
-	*   only on the initial mount load.
+	*   role-derived capabilities can't have changed. Default `true`.
 	*/
 	let batchDepth = 0;
 	let reloadPending = false;
@@ -250,7 +318,12 @@ function usePresets(opts) {
 			reloadPending = true;
 			return;
 		}
+		await reloadAfterWrite();
+	}
+	/** The trailing reload of a write: refreshes the shared entry (other mounted tables follow) and tells other tabs. */
+	async function reloadAfterWrite() {
 		await reload({ capabilities: false });
+		if (cached) (0, _atscript_ui_table.publishPresetsWrite)(cacheKey);
 	}
 	async function batch(fn) {
 		batchDepth++;
@@ -260,32 +333,23 @@ function usePresets(opts) {
 			batchDepth--;
 			if (batchDepth === 0 && reloadPending) {
 				reloadPending = false;
-				await reload({ capabilities: false });
+				await reloadAfterWrite();
 			}
 		}
 	}
-	async function reload(opts = {}) {
+	async function reload(reloadOpts = {}) {
+		if (reloadOpts.capabilities !== false) loadCapabilities();
+		await load(true);
+	}
+	/** Foreground row load: drives `loading` and `error`. */
+	async function load(force) {
 		loading.value = true;
 		error.value = null;
 		try {
-			const result = await client.list(opts);
-			if (result.denied) {
-				denied.value = true;
-				presets.value = [];
-				userConf.value = null;
-				capabilities.value = null;
-				return;
-			}
-			denied.value = false;
-			presets.value = result.presets;
-			userConf.value = result.userConf;
-			if (result.capabilities !== void 0) capabilities.value = result.capabilities;
+			applyResult(await fetchRows(force));
 		} catch (err) {
 			if ((0, _atscript_ui_table.isUnavailableError)(err)) {
-				denied.value = true;
-				presets.value = [];
-				userConf.value = null;
-				capabilities.value = null;
+				applyDenied();
 				return;
 			}
 			error.value = err;
@@ -294,6 +358,19 @@ function usePresets(opts) {
 			loading.value = false;
 		}
 	}
+	/**
+	* Initial load. From the session cache when it holds this scope: rows are
+	* applied synchronously (the default preset resolves with no network
+	* wait) and revalidated in the background once past the max age — a
+	* revalidation updates the list but never re-applies the default.
+	*/
+	async function initialLoad() {
+		const hit = cached ? (0, _atscript_ui_table.cachedPresetRows)(cacheKey) : void 0;
+		if (hit) applyRows(hit.rows);
+		loadCapabilities();
+		if (!hit) await load(false);
+		else if (!hit.fresh) await revalidate();
+	}
 	async function savePreset(snapshot) {
 		const id = activePresetId.value;
 		if (!id) throw new Error("[vue-table] usePresets.savePreset: no active preset");
@@ -352,7 +429,7 @@ function usePresets(opts) {
 		};
 		await maybeReloadAfterMutation();
 	}
-	if (opts.autoLoad !== false) reload();
+	if (opts.autoLoad !== false) initialLoad();
 	return {
 		presets,
 		presetsById,
@@ -409,10 +486,9 @@ function finalizeTableState(state, client, opts) {
 * @param url — Table endpoint URL (e.g. "/db/tables/products")
 */
 function useTable(url, opts) {
-	const entry = (0, _atscript_ui.getMetaEntry)(url, opts?.clientFactory);
-	if (!entry.tableDef) entry.tableDef = Promise.all([entry.meta, entry.type]).then(([meta, type]) => (0, _atscript_ui.createTableDef)(meta, type));
+	const entry = (0, _atscript_ui.getMetaEntry)(url, opts?.clientFactory, { metaKey: opts?.metaKey });
 	const { client } = entry;
-	const defPromise = entry.tableDef;
+	const defPromise = (0, _atscript_ui.getMetaTableDef)(entry);
 	const cellLocale = (0, vue.getCurrentInstance)() ? require_use_cell_locale.useCellLocale() : void 0;
 	const preset = opts?.preset;
 	const presetsHandle = preset ? usePresets({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/vue-table",
-  "version": "0.1.152",
+  "version": "0.1.153",
   "description": "Type-driven table components for Atscript with Vue 3",
   "keywords": [
     "atscript",
@@ -167,17 +167,17 @@
     "access": "public"
   },
   "dependencies": {
-    "@atscript/ui": "^0.1.152",
-    "@atscript/vue-form": "^0.1.152",
-    "@atscript/ui-table": "^0.1.152"
+    "@atscript/ui": "^0.1.153",
+    "@atscript/ui-table": "^0.1.153",
+    "@atscript/vue-form": "^0.1.153"
   },
   "devDependencies": {
-    "@atscript/core": "^0.1.102",
-    "@atscript/db-client": "^0.1.151",
-    "@atscript/typescript": "^0.1.102",
+    "@atscript/core": "^0.1.103",
+    "@atscript/db-client": "^0.1.153",
+    "@atscript/typescript": "^0.1.103",
     "@tanstack/vue-virtual": "^3.13.26",
-    "@uniqu/core": "^0.1.14",
-    "@uniqu/url": "^0.1.14",
+    "@uniqu/core": "^0.1.15",
+    "@uniqu/url": "^0.1.15",
     "@vitejs/plugin-vue": "^6",
     "@vue/test-utils": "^2",
     "@vueuse/core": "^14.3.0",
@@ -190,9 +190,9 @@
     "vunor": "^0.3.2"
   },
   "peerDependencies": {
-    "@atscript/db-client": "^0.1.151",
+    "@atscript/db-client": "^0.1.153",
     "@tanstack/vue-virtual": "^3.13.26",
-    "@uniqu/url": "^0.1.14",
+    "@uniqu/url": "^0.1.15",
     "@vueuse/core": "^14.3.0",
     "reka-ui": "^2.9.8",
     "vue": "^3"