@atscript/vue-table 0.1.135 → 0.1.137

package/dist/{types-CyAmAg10.d.cts → types-CuOHiH-S.d.mts}

@@ -1,8 +1,8 @@
+import { ColumnDef, PaginationControl, SortControl, TableDef } from "@atscript/ui";
 import { Component, ComputedRef, MaybeRefOrGetter, Ref, ShallowRef } from "vue";
+import { AsPresetEntryRow, AspectMask, ColumnWidthsMap, ConfigTab, FieldFilters, PresetAspect, PresetCapabilities, PresetSnapshot, SelectionMode, SystemPreset, SystemPresetInput, TableStateMethods } from "@atscript/ui-table";
 import { ClientError, PageResult, TDbActionInfo, TDbActionProcessor, TDbDeleteResult } from "@atscript/db-client";
 import { Uniquery } from "@uniqu/core";
-import { ColumnDef, PaginationControl, SortControl, TableDef } from "@atscript/ui";
-import { AsPresetEntryRow, AspectMask, ColumnWidthsMap, ConfigTab, FieldFilters, PresetAspect, PresetCapabilities, PresetSnapshot, SelectionMode, SystemPreset, SystemPresetInput, TableStateMethods } from "@atscript/ui-table";
 
 //#region src/composables/state/intent-scope.d.ts
 interface ActionBuckets {
@@ -403,6 +403,14 @@ type TAsCellTypeComponents = {
   ref: Component; /** Synthesised row-actions pseudo-column (`:rowActionsColumn` opt-in). */
   __actions?: Component;
 } & Record<string, Component>;
+/**
+ * How `applyUrlQuery` treats filters and sorters the URL does not mention.
+ * @since 0.1.137
+ */
+interface ApplyUrlQueryOptions {
+  /** `"merge"` (default) keeps them, `"replace"` clears them. */
+  mode?: "merge" | "replace";
+}
 /**
  * Reactive table state — Vue implementation of the framework-agnostic
  * TableStateData + TableStateMethods interfaces.
@@ -650,12 +658,20 @@ interface ReactiveTableState extends TableStateMethods {
   releaseActionForm: () => void;
   /**
    * Hydrate state from a URL query string produced by `stateToUrlQueryString`.
-   * Replaces filters / sorters / search / pagination with values decoded from
-   * the URL; unions decoded filter fields into `filterFields`. Echo-guarded
-   * against the bridge's own emissions. Does NOT call `query()` — root
-   * watchers refetch in reaction to the writes.
+   * Writes filters / sorters / search / pagination decoded from the URL and
+   * unions decoded filter fields into `filterFields`. Echo-guarded against the
+   * bridge's own emissions. Does NOT call `query()` — root watchers refetch in
+   * reaction to the writes.
+   *
+   * `mode` decides what happens to filters and sorters the URL does NOT
+   * mention (search and pagination always take the URL's value):
+   * - `"merge"` (default) — they survive. This is mount-time deep-link
+   *   hydration, where the URL overlays a preset baseline it must not wipe.
+   * - `"replace"` (since 0.1.137) — they are cleared, within whatever the
+   *   `urlQuerySync` gates actually serialize. This is history navigation,
+   *   where the URL is a complete snapshot of the synced aspects.
    */
-  applyUrlQuery: (urlString: string) => void;
+  applyUrlQuery: (urlString: string, opts?: ApplyUrlQueryOptions) => void;
   /**
    * Build the Uniquery the table's own fetch would send right now — same
    * filters, sorters, search, force-filters and `$select` projection. Used by
@@ -817,4 +833,4 @@ interface PresetSurface {
   lastError: Ref<Error | null>;
 }
 //#endregion
-export { TableActionsState as C, TVueTableActionInfo as S, extractIdentifier as T, RowHookContext as _, EnterAction as a, TAsCellTypeComponents as b, MainActionRequest as c, QueryErrorKind as d, ReactiveTableState as f, RowDeleteOpt as g, RowClassHook as h, ConfirmOptions as i, NavKeyOptions as l, RowAttrsHook as m, ColumnMenuConfig as n, InvokeOpts as o, RowActionsConfig as p, ConfigTab as r, LocalRowAction as s, ActionResult as t, PresetConfig as u, RowSelectableHook as v, TableNavBridge as w, TAsTableControls as x, RowSelectableVerdict as y };
+export { TVueTableActionInfo as C, extractIdentifier as E, TAsTableControls as S, TableNavBridge as T, RowDeleteOpt as _, ConfirmOptions as a, RowSelectableVerdict as b, LocalRowAction as c, PresetConfig as d, QueryErrorKind as f, RowClassHook as g, RowAttrsHook as h, ConfigTab as i, MainActionRequest as l, RowActionsConfig as m, ApplyUrlQueryOptions as n, EnterAction as o, ReactiveTableState as p, ColumnMenuConfig as r, InvokeOpts as s, ActionResult as t, NavKeyOptions as u, RowHookContext as v, TableActionsState as w, TAsCellTypeComponents as x, RowSelectableHook as y };

package/dist/{types-yS6-QFfT.d.mts → types-n40LWFm_.d.cts}

@@ -1,8 +1,8 @@
-import { ColumnDef, PaginationControl, SortControl, TableDef } from "@atscript/ui";
 import { Component, ComputedRef, MaybeRefOrGetter, Ref, ShallowRef } from "vue";
-import { AsPresetEntryRow, AspectMask, ColumnWidthsMap, ConfigTab, FieldFilters, PresetAspect, PresetCapabilities, PresetSnapshot, SelectionMode, SystemPreset, SystemPresetInput, TableStateMethods } from "@atscript/ui-table";
 import { ClientError, PageResult, TDbActionInfo, TDbActionProcessor, TDbDeleteResult } from "@atscript/db-client";
 import { Uniquery } from "@uniqu/core";
+import { ColumnDef, PaginationControl, SortControl, TableDef } from "@atscript/ui";
+import { AsPresetEntryRow, AspectMask, ColumnWidthsMap, ConfigTab, FieldFilters, PresetAspect, PresetCapabilities, PresetSnapshot, SelectionMode, SystemPreset, SystemPresetInput, TableStateMethods } from "@atscript/ui-table";
 
 //#region src/composables/state/intent-scope.d.ts
 interface ActionBuckets {
@@ -403,6 +403,14 @@ type TAsCellTypeComponents = {
   ref: Component; /** Synthesised row-actions pseudo-column (`:rowActionsColumn` opt-in). */
   __actions?: Component;
 } & Record<string, Component>;
+/**
+ * How `applyUrlQuery` treats filters and sorters the URL does not mention.
+ * @since 0.1.137
+ */
+interface ApplyUrlQueryOptions {
+  /** `"merge"` (default) keeps them, `"replace"` clears them. */
+  mode?: "merge" | "replace";
+}
 /**
  * Reactive table state — Vue implementation of the framework-agnostic
  * TableStateData + TableStateMethods interfaces.
@@ -650,12 +658,20 @@ interface ReactiveTableState extends TableStateMethods {
   releaseActionForm: () => void;
   /**
    * Hydrate state from a URL query string produced by `stateToUrlQueryString`.
-   * Replaces filters / sorters / search / pagination with values decoded from
-   * the URL; unions decoded filter fields into `filterFields`. Echo-guarded
-   * against the bridge's own emissions. Does NOT call `query()` — root
-   * watchers refetch in reaction to the writes.
+   * Writes filters / sorters / search / pagination decoded from the URL and
+   * unions decoded filter fields into `filterFields`. Echo-guarded against the
+   * bridge's own emissions. Does NOT call `query()` — root watchers refetch in
+   * reaction to the writes.
+   *
+   * `mode` decides what happens to filters and sorters the URL does NOT
+   * mention (search and pagination always take the URL's value):
+   * - `"merge"` (default) — they survive. This is mount-time deep-link
+   *   hydration, where the URL overlays a preset baseline it must not wipe.
+   * - `"replace"` (since 0.1.137) — they are cleared, within whatever the
+   *   `urlQuerySync` gates actually serialize. This is history navigation,
+   *   where the URL is a complete snapshot of the synced aspects.
    */
-  applyUrlQuery: (urlString: string) => void;
+  applyUrlQuery: (urlString: string, opts?: ApplyUrlQueryOptions) => void;
   /**
    * Build the Uniquery the table's own fetch would send right now — same
    * filters, sorters, search, force-filters and `$select` projection. Used by
@@ -817,4 +833,4 @@ interface PresetSurface {
   lastError: Ref<Error | null>;
 }
 //#endregion
-export { TableActionsState as C, TVueTableActionInfo as S, extractIdentifier as T, RowHookContext as _, EnterAction as a, TAsCellTypeComponents as b, MainActionRequest as c, QueryErrorKind as d, ReactiveTableState as f, RowDeleteOpt as g, RowClassHook as h, ConfirmOptions as i, NavKeyOptions as l, RowAttrsHook as m, ColumnMenuConfig as n, InvokeOpts as o, RowActionsConfig as p, ConfigTab as r, LocalRowAction as s, ActionResult as t, PresetConfig as u, RowSelectableHook as v, TableNavBridge as w, TAsTableControls as x, RowSelectableVerdict as y };
+export { TVueTableActionInfo as C, extractIdentifier as E, TAsTableControls as S, TableNavBridge as T, RowDeleteOpt as _, ConfirmOptions as a, RowSelectableVerdict as b, LocalRowAction as c, PresetConfig as d, QueryErrorKind as f, RowClassHook as g, RowAttrsHook as h, ConfigTab as i, MainActionRequest as l, RowActionsConfig as m, ApplyUrlQueryOptions as n, EnterAction as o, ReactiveTableState as p, ColumnMenuConfig as r, InvokeOpts as s, ActionResult as t, NavKeyOptions as u, RowHookContext as v, TableActionsState as w, TAsCellTypeComponents as x, RowSelectableHook as y };

package/dist/{use-table-BVptAnaS.mjs → use-table-DRN4nlZs.mjs}

@@ -1,4 +1,4 @@
-import { n as createTableState, r as provideTableContext, s as DEFAULT_AVAILABLE_ASPECTS } from "./use-table-state-CwfgWmuk.mjs";
+import { n as createTableState, r as provideTableContext, s as DEFAULT_AVAILABLE_ASPECTS } from "./use-table-state-CqU1N4Q9.mjs";
 import { n as useTableSelection } from "./use-table-selection-ULbKT2xW.mjs";
 import { createTableDef, getMetaEntry, resetMetaCache } from "@atscript/ui";
 import { computed, inject, isRef, ref, shallowRef, toValue, watch } from "vue";

package/dist/{use-table-Bm2a0g9D.cjs → use-table-JU7BAX4e.cjs}

@@ -1,4 +1,4 @@
-const require_use_table_state = require("./use-table-state-jljSQQ8m.cjs");
+const require_use_table_state = require("./use-table-state-CoVe_8NI.cjs");
 const require_use_table_selection = require("./use-table-selection-DtCV3rhu.cjs");
 let _atscript_ui = require("@atscript/ui");
 let vue = require("vue");

package/dist/{use-table-component-Bpy5mg_P.cjs → use-table-component-DIWiP_Vs.cjs}

@@ -1,4 +1,4 @@
-const require_use_table_state = require("./use-table-state-jljSQQ8m.cjs");
+const require_use_table_state = require("./use-table-state-CoVe_8NI.cjs");
 //#region src/composables/use-table-component.ts
 /**
 * Resolve a single skin-slot component from the injected `controls` map,

package/dist/{use-table-component-DYzKgCC4.mjs → use-table-component-VUFlxIk-.mjs}

@@ -1,4 +1,4 @@
-import { o as useTableContextOptional } from "./use-table-state-CwfgWmuk.mjs";
+import { o as useTableContextOptional } from "./use-table-state-CqU1N4Q9.mjs";
 //#region src/composables/use-table-component.ts
 /**
 * Resolve a single skin-slot component from the injected `controls` map,

package/dist/{use-table-nav-bridge-qyvyRm6S.cjs → use-table-nav-bridge-BBtXE70x.cjs}

@@ -1,4 +1,4 @@
-const require_use_table_state = require("./use-table-state-jljSQQ8m.cjs");
+const require_use_table_state = require("./use-table-state-CoVe_8NI.cjs");
 //#region src/composables/use-table-nav-bridge.ts
 function isPassthroughKey(event) {
 	const key = event.key;

package/dist/{use-table-nav-bridge-LCL6vq9F.mjs → use-table-nav-bridge-DT8oU-6r.mjs}

@@ -1,4 +1,4 @@
-import { o as useTableContextOptional } from "./use-table-state-CwfgWmuk.mjs";
+import { o as useTableContextOptional } from "./use-table-state-CqU1N4Q9.mjs";
 //#region src/composables/use-table-nav-bridge.ts
 function isPassthroughKey(event) {
 	const key = event.key;

package/dist/{use-table-state-jljSQQ8m.cjs → use-table-state-CoVe_8NI.cjs}

@@ -2111,8 +2111,9 @@ function createTableState(opts) {
 		lastEmittedUrl = next;
 		queryOpts.onUrlQueryChange(next);
 	}
-	function applyUrlQuery(urlString) {
+	function applyUrlQuery(urlString, opts) {
 		if (urlsEquivalent(urlString, lastEmittedUrl)) return;
+		const replace = opts?.mode === "replace";
 		const cols = allColumns.value;
 		const parsed = (0, _atscript_ui_table.urlQueryStringToState)(urlString, {
 			knownFields: cols.length > 0 ? cols.map((c) => c.path) : void 0,
@@ -2125,16 +2126,16 @@ function createTableState(opts) {
 		hydratingFromUrl = true;
 		const filtersGate = (0, _atscript_ui_table.resolveAspectGate)(urlQuerySync?.filters);
 		if (filtersGate !== "none") {
-			const next = { ...filters.value };
+			const next = {};
+			for (const path in filters.value) if (!replace || !(0, _atscript_ui_table.gateOwns)(filtersGate, path)) next[path] = filters.value[path];
 			for (const path in parsed.filters) next[path] = parsed.filters[path];
 			filters.value = next;
 		}
 		const sortersGate = (0, _atscript_ui_table.resolveAspectGate)(urlQuerySync?.sorters);
 		let urlSortersChanged = false;
 		if (sortersGate !== "none") {
-			const urlFields = /* @__PURE__ */ new Set();
-			for (const s of parsed.sorters) urlFields.add(s.field);
-			const merged = [...sorters.value.filter((s) => !urlFields.has(s.field)), ...parsed.sorters];
+			const urlSortFields = new Set(parsed.sorters.map((s) => s.field));
+			const merged = [...sorters.value.filter((s) => !(replace ? (0, _atscript_ui_table.gateOwns)(sortersGate, s.field) : urlSortFields.has(s.field))), ...parsed.sorters];
 			if (!(0, _atscript_ui_table.sortersEqual)(sorters.value, merged)) {
 				sorters.value = merged;
 				urlSortersChanged = true;

package/dist/{use-table-state-CwfgWmuk.mjs → use-table-state-CqU1N4Q9.mjs}

@@ -1,7 +1,7 @@
 import { t as getCellValue } from "./get-cell-value-Cb3X8nUn.mjs";
 import { navigateHrefFor } from "@atscript/ui";
 import { computed, inject, nextTick, onBeforeUnmount, onScopeDispose, provide, ref, shallowRef, toValue, watch } from "vue";
-import { STANDARD_PRESET_ID, blockStartFor, buildTableQuery, cellAsString, debounce, derivePresetAspects, fromWireSnapshot, isDirtyAgainst, isFilled, isSystemPresetId, mergeDisplayColumns, mergeSorters, pageAlignedBlocksFor, planFetch, reconcileColumnWidthDefaults, resolveAspectGate, resolveSystemPresets, rowsToPks, sameColumnSet, sortRowsLocally, sortersEqual, stateToUrlQueryString, togglePk, urlQueryStringToState, walkBackwardAbsorb, walkForwardAbsorb } from "@atscript/ui-table";
+import { STANDARD_PRESET_ID, blockStartFor, buildTableQuery, cellAsString, debounce, derivePresetAspects, fromWireSnapshot, gateOwns, isDirtyAgainst, isFilled, isSystemPresetId, mergeDisplayColumns, mergeSorters, pageAlignedBlocksFor, planFetch, reconcileColumnWidthDefaults, resolveAspectGate, resolveSystemPresets, rowsToPks, sameColumnSet, sortRowsLocally, sortersEqual, stateToUrlQueryString, togglePk, urlQueryStringToState, walkBackwardAbsorb, walkForwardAbsorb } from "@atscript/ui-table";
 import { formatIdentifier } from "@atscript/db-client";
 //#region src/types.ts
 /** UI-side sentinel for the synthesised row-delete processor. */
@@ -2111,8 +2111,9 @@ function createTableState(opts) {
 		lastEmittedUrl = next;
 		queryOpts.onUrlQueryChange(next);
 	}
-	function applyUrlQuery(urlString) {
+	function applyUrlQuery(urlString, opts) {
 		if (urlsEquivalent(urlString, lastEmittedUrl)) return;
+		const replace = opts?.mode === "replace";
 		const cols = allColumns.value;
 		const parsed = urlQueryStringToState(urlString, {
 			knownFields: cols.length > 0 ? cols.map((c) => c.path) : void 0,
@@ -2125,16 +2126,16 @@ function createTableState(opts) {
 		hydratingFromUrl = true;
 		const filtersGate = resolveAspectGate(urlQuerySync?.filters);
 		if (filtersGate !== "none") {
-			const next = { ...filters.value };
+			const next = {};
+			for (const path in filters.value) if (!replace || !gateOwns(filtersGate, path)) next[path] = filters.value[path];
 			for (const path in parsed.filters) next[path] = parsed.filters[path];
 			filters.value = next;
 		}
 		const sortersGate = resolveAspectGate(urlQuerySync?.sorters);
 		let urlSortersChanged = false;
 		if (sortersGate !== "none") {
-			const urlFields = /* @__PURE__ */ new Set();
-			for (const s of parsed.sorters) urlFields.add(s.field);
-			const merged = [...sorters.value.filter((s) => !urlFields.has(s.field)), ...parsed.sorters];
+			const urlSortFields = new Set(parsed.sorters.map((s) => s.field));
+			const merged = [...sorters.value.filter((s) => !(replace ? gateOwns(sortersGate, s.field) : urlSortFields.has(s.field))), ...parsed.sorters];
 			if (!sortersEqual(sorters.value, merged)) {
 				sorters.value = merged;
 				urlSortersChanged = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/vue-table",
-  "version": "0.1.135",
+  "version": "0.1.137",
   "description": "Type-driven table components for Atscript with Vue 3",
   "keywords": [
     "atscript",
@@ -162,12 +162,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@atscript/ui": "^0.1.135",
-    "@atscript/ui-table": "^0.1.135",
-    "@atscript/vue-form": "^0.1.135"
+    "@atscript/ui": "^0.1.137",
+    "@atscript/ui-table": "^0.1.137",
+    "@atscript/vue-form": "^0.1.137"
   },
   "devDependencies": {
-    "@atscript/db-client": "^0.1.129",
+    "@atscript/db-client": "^0.1.131",
     "@atscript/typescript": "^0.1.93",
     "@tanstack/vue-virtual": "^3.13.26",
     "@uniqu/core": "^0.1.8",
@@ -183,7 +183,7 @@
     "vunor": "^0.3.0"
   },
   "peerDependencies": {
-    "@atscript/db-client": "^0.1.129",
+    "@atscript/db-client": "^0.1.131",
     "@tanstack/vue-virtual": "^3.13.26",
     "@vueuse/core": "^14.3.0",
     "reka-ui": "^2.9.8",