@atscript/vue-table 0.1.139 → 0.1.140

package/dist/index.mjs

@@ -1,9 +1,9 @@
-import { O as ROW_ACTIONS_TYPE, a as useTableContext, n as createTableState, o as useTableContextOptional, r as provideTableContext, t as createStaticTableState, x as extractIdentifier } from "./use-table-state-BEwXQayO.mjs";
+import { O as ROW_ACTIONS_TYPE, a as useTableContext, n as createTableState, o as useTableContextOptional, r as provideTableContext, t as createStaticTableState, x as extractIdentifier } from "./use-table-state-BzjbnpBA.mjs";
 import { t as getCellValue } from "./get-cell-value-Cb3X8nUn.mjs";
 import { n as useTableSelection } from "./use-table-selection-ULbKT2xW.mjs";
-import { a as useLocalDraft, i as usePresets, o as AS_PRESETS_APP, r as useTable, s as injectPresetsApp, t as clearTableCache } from "./use-table-DUwUfjSZ.mjs";
-import { t as useTableNavBridge } from "./use-table-nav-bridge-DRrvQxXq.mjs";
-import { t as useTableComponent } from "./use-table-component-wfU13P3L.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-2xPxoNRX.mjs";
+import { t as useTableNavBridge } from "./use-table-nav-bridge-BDBnRc4C.mjs";
+import { t as useTableComponent } from "./use-table-component-BYO0zMQj.mjs";
 import { t as as_cell_array_default } from "./as-cell-array-Bgc4GYZf.mjs";
 import { t as as_cell_date_default } from "./as-cell-date-B9mu0OOD.mjs";
 import { n as useCellLocale, t as provideCellLocale } from "./use-cell-locale-MQXoONh5.mjs";
@@ -12,24 +12,26 @@ import { t as as_cell_number_default } from "./as-cell-number-CNDT6gfw.mjs";
 import { t as formatCellValue } from "./format-cell-D1Ziv96Q.mjs";
 import { t as as_cell_union_default } from "./as-cell-union-DMnoa7RM.mjs";
 import { t as as_column_menu_default } from "./as-column-menu-CBtUfYEE.mjs";
-import { t as as_config_dialog_default } from "./as-config-dialog-DrcYlrOh.mjs";
-import { t as as_confirm_dialog_default } from "./as-confirm-dialog-Pnt60ALy.mjs";
+import { t as as_config_dialog_default } from "./as-config-dialog-JXNkCCrh.mjs";
+import { t as as_confirm_dialog_default } from "./as-confirm-dialog-CC6U8nLZ.mjs";
 import { t as as_filter_input_default } from "./as-filter-input-BM23TNeh.mjs";
-import { t as as_filter_dialog_default } from "./as-filter-dialog-CUzahpd_.mjs";
-import { t as as_table_header_cell_default } from "./as-table-header-cell-CUs-sSBm.mjs";
-import { t as as_window_table_default } from "./as-window-table-CjYMF0aX.mjs";
-import { t as as_filter_field_default } from "./as-filter-field-3DJh_ICs.mjs";
-import { t as as_filters_default } from "./as-filters-D0DWDyiv.mjs";
-import { t as as_preset_dialog_default } from "./as-preset-dialog-H98DeOMM.mjs";
-import { t as as_row_actions_default } from "./as-row-actions-BvJWHf3j.mjs";
-import { t as as_table_cell_value_default } from "./as-table-cell-value-D1eLiQKJ.mjs";
-import { t as as_table_root_default } from "./as-table-root-C61wrFd9.mjs";
-import { t as as_table_default } from "./as-table-D5mMZKKg.mjs";
-import { t as as_table_actions_default } from "./as-table-actions-C6moFlxt.mjs";
-import { t as as_preset_picker_default } from "./as-preset-picker-Cw7LB7o1.mjs";
+import { t as as_filter_dialog_default } from "./as-filter-dialog-C3wltqrN.mjs";
+import { t as as_table_header_cell_default } from "./as-table-header-cell-Ccf06b2_.mjs";
+import { t as as_window_table_default } from "./as-window-table-KyS6YUpa.mjs";
+import { t as as_filter_field_default } from "./as-filter-field-D_6DlFcp.mjs";
+import { t as as_residual_filter_default } from "./as-residual-filter-C65QsWxr.mjs";
+import { t as as_filters_default } from "./as-filters-BDzQ2SM_.mjs";
+import { t as as_preset_dialog_default } from "./as-preset-dialog-D_w4cxKS.mjs";
+import { t as as_row_actions_default } from "./as-row-actions-xQ9M1PrO.mjs";
+import { t as as_table_cell_value_default } from "./as-table-cell-value-DoH8Mieo.mjs";
+import { t as as_table_root_default } from "./as-table-root-CG7bLzcQ.mjs";
+import { t as as_table_default } from "./as-table-B49x0hDM.mjs";
+import { t as as_table_actions_default } from "./as-table-actions-B2Hy3h7v.mjs";
+import { t as as_preset_picker_default } from "./as-preset-picker-B8d6l3U1.mjs";
 import { getDefaultClientFactory, resetDefaultClientFactory, setDefaultClientFactory } from "@atscript/ui";
 import { computed, effectScope, ref, shallowRef } from "vue";
 import { AppPrefsClient, ExportAbortError, PRESET_ASPECTS, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, collectExportRows, columnDefaultCondition, columnFilterConditions, columnFilterType, isFilled, isSystemPresetId, isUnavailableError, resolveExportValue, resolveSystemPresets, toCsv, urlQueryConsumesKey, withStableOrder } from "@atscript/ui-table";
+import { splitUrlSegments } from "@uniqu/url";
 import { StorageSerializers, useEventBus, useStorage } from "@vueuse/core";
 //#region src/composables/use-table-export.ts
 /**
@@ -292,35 +294,6 @@ function useTableActions() {
 }
 //#endregion
 //#region src/composables/use-table-url-query.ts
-/**
-* Split a uniqu URL string on top-level `&` separators, respecting
-* single-quoted string literals (`name='foo&bar'` is one segment, not two).
-* Within a quote, `\'` escapes a literal apostrophe per @uniqu/url's encoder.
-* Empty segments (from leading/trailing/double `&`) are dropped.
-*/
-function splitSegments(urlString) {
-	if (!urlString) return [];
-	const out = [];
-	let start = 0;
-	let inQuote = false;
-	const push = (end) => {
-		if (end > start) out.push(urlString.slice(start, end));
-	};
-	for (let i = 0; i < urlString.length; i++) {
-		const c = urlString[i];
-		if (c === "\\" && inQuote) {
-			i++;
-			continue;
-		}
-		if (c === "'") inQuote = !inQuote;
-		else if (c === "&" && !inQuote) {
-			push(i);
-			start = i + 1;
-		}
-	}
-	push(urlString.length);
-	return out;
-}
 const KEY_CHAR = /[A-Za-z0-9_.$-]/;
 /**
 * Index of `=` if every char before it is URL-key-safe. Returns -1 when any
@@ -396,7 +369,8 @@ function useTableUrlQuery(route, router, opts = {}) {
 		},
 		set: (urlString) => {
 			const serialized = /* @__PURE__ */ new Map();
-			for (const segment of splitSegments(urlString)) {
+			for (const segment of splitUrlSegments(urlString)) {
+				if (!segment) continue;
 				const eqIdx = findCleanEq(segment);
 				const key = eqIdx > 0 ? `${prefix}${segment.slice(0, eqIdx)}` : `${prefix}${segment}`;
 				serialized.set(key, eqIdx > 0 ? segment.slice(eqIdx + 1) : null);
@@ -637,6 +611,7 @@ function createDefaultControls() {
 		filterDialog: as_filter_dialog_default,
 		filterInput: as_filter_input_default,
 		filterField: as_filter_field_default,
+		residualFilter: as_residual_filter_default,
 		configDialog: as_config_dialog_default,
 		confirmDialog: as_confirm_dialog_default
 	};

package/dist/{types-B6N5NDx_.d.cts → types-BCixOa8x.d.cts}

@@ -1,6 +1,6 @@
 import { Component, ComputedRef, MaybeRefOrGetter, Ref, ShallowRef } from "vue";
 import { ClientError, PageResult, TDbActionInfo, TDbActionProcessor, TDbDeleteResult } from "@atscript/db-client";
-import { Uniquery } from "@uniqu/core";
+import { FilterExpr, 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";
 
@@ -369,6 +369,11 @@ interface TAsTableControls {
   filterDialog?: Component;
   filterField?: Component;
   filterValueHelp?: Component;
+  /**
+   * One residual filter condition's chip in `<AsFilters>` — receives
+   * `expr` and `index`. Default `AsResidualFilter`. Since 0.1.140.
+   */
+  residualFilter?: Component;
   configDialog?: Component;
   fieldsSelector?: Component;
   sortersConfig?: Component;
@@ -442,6 +447,15 @@ interface ReactiveTableState extends TableStateMethods {
   columnWidths: Ref<ColumnWidthsMap>;
   filterFields: ShallowRef<string[]>;
   filters: ShallowRef<FieldFilters>;
+  /**
+   * Residual filter conditions — AND-ed Uniquery conjuncts the field-filter
+   * model cannot hold (a cross-field `$or`, a second range on one field, …).
+   * AND'd after `filters` into every query, carried through the URL, shown
+   * as "custom filter" chips by `<AsFilters>`. Replace wholesale (or use
+   * `setResidualFilters` / `removeResidualFilter`); `resetFilters()`
+   * clears them. Not saved in presets. Since 0.1.140.
+   */
+  residualFilters: ShallowRef<FilterExpr[]>;
   sorters: ShallowRef<SortControl[]>;
   results: ShallowRef<Record<string, unknown>[]>;
   /** Absolute index where `results[0]` sits. */
@@ -686,6 +700,11 @@ interface ReactiveTableState extends TableStateMethods {
    *   the baseline.
    *
    * `opts.mode` overrides the marker either way. Since 0.1.139.
+   *
+   * Filter pieces the field-filter model cannot hold are restored as
+   * `residualFilters` (since 0.1.140). A URL owns every path it mentions —
+   * in a field filter or inside such a condition — so on merge the
+   * baseline's filters and residual conditions on those paths give way.
    */
   applyUrlQuery: (urlString: string, opts?: ApplyUrlQueryOptions) => void;
   /**

package/dist/{types-CgdpcJdd.d.mts → types-D7qVxU_y.d.mts}

@@ -2,7 +2,7 @@ import { ColumnDef, PaginationControl, SortControl, TableDef } from "@atscript/u
 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 { FilterExpr, Uniquery } from "@uniqu/core";
 
 //#region src/composables/state/intent-scope.d.ts
 interface ActionBuckets {
@@ -369,6 +369,11 @@ interface TAsTableControls {
   filterDialog?: Component;
   filterField?: Component;
   filterValueHelp?: Component;
+  /**
+   * One residual filter condition's chip in `<AsFilters>` — receives
+   * `expr` and `index`. Default `AsResidualFilter`. Since 0.1.140.
+   */
+  residualFilter?: Component;
   configDialog?: Component;
   fieldsSelector?: Component;
   sortersConfig?: Component;
@@ -442,6 +447,15 @@ interface ReactiveTableState extends TableStateMethods {
   columnWidths: Ref<ColumnWidthsMap>;
   filterFields: ShallowRef<string[]>;
   filters: ShallowRef<FieldFilters>;
+  /**
+   * Residual filter conditions — AND-ed Uniquery conjuncts the field-filter
+   * model cannot hold (a cross-field `$or`, a second range on one field, …).
+   * AND'd after `filters` into every query, carried through the URL, shown
+   * as "custom filter" chips by `<AsFilters>`. Replace wholesale (or use
+   * `setResidualFilters` / `removeResidualFilter`); `resetFilters()`
+   * clears them. Not saved in presets. Since 0.1.140.
+   */
+  residualFilters: ShallowRef<FilterExpr[]>;
   sorters: ShallowRef<SortControl[]>;
   results: ShallowRef<Record<string, unknown>[]>;
   /** Absolute index where `results[0]` sits. */
@@ -686,6 +700,11 @@ interface ReactiveTableState extends TableStateMethods {
    *   the baseline.
    *
    * `opts.mode` overrides the marker either way. Since 0.1.139.
+   *
+   * Filter pieces the field-filter model cannot hold are restored as
+   * `residualFilters` (since 0.1.140). A URL owns every path it mentions —
+   * in a field filter or inside such a condition — so on merge the
+   * baseline's filters and residual conditions on those paths give way.
    */
   applyUrlQuery: (urlString: string, opts?: ApplyUrlQueryOptions) => void;
   /**

package/dist/{use-table-DUwUfjSZ.mjs → use-table-2xPxoNRX.mjs}

@@ -1,4 +1,4 @@
-import { c as DEFAULT_AVAILABLE_ASPECTS, n as createTableState, r as provideTableContext } from "./use-table-state-BEwXQayO.mjs";
+import { c as DEFAULT_AVAILABLE_ASPECTS, n as createTableState, r as provideTableContext } from "./use-table-state-BzjbnpBA.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-c4ku22Mx.cjs → use-table-B45WZLwg.cjs}

@@ -1,4 +1,4 @@
-const require_use_table_state = require("./use-table-state-Cnxv0w_E.cjs");
+const require_use_table_state = require("./use-table-state-pF_9gnTG.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-column-handlers-eKHCfUm_.mjs → use-table-column-handlers-p_xK-l0e.mjs}

@@ -1,4 +1,4 @@
-import { D as ROW_ACTIONS_PATH, O as ROW_ACTIONS_TYPE } from "./use-table-state-BEwXQayO.mjs";
+import { D as ROW_ACTIONS_PATH, O as ROW_ACTIONS_TYPE } from "./use-table-state-BzjbnpBA.mjs";
 import { computed, watch } from "vue";
 import { reorderColumnNames } from "@atscript/ui-table";
 //#region src/composables/use-row-actions-column.ts

package/dist/{use-table-column-handlers-Do0Z-R9D.cjs → use-table-column-handlers-rqFo9HLz.cjs}

@@ -1,4 +1,4 @@
-const require_use_table_state = require("./use-table-state-Cnxv0w_E.cjs");
+const require_use_table_state = require("./use-table-state-pF_9gnTG.cjs");
 let vue = require("vue");
 let _atscript_ui_table = require("@atscript/ui-table");
 //#region src/composables/use-row-actions-column.ts

package/dist/{use-table-component-wfU13P3L.mjs → use-table-component-BYO0zMQj.mjs}

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

package/dist/{use-table-component-DbQDINoa.cjs → use-table-component-XQ-Qt_sp.cjs}

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

package/dist/{use-table-nav-bridge-DRrvQxXq.mjs → use-table-nav-bridge-BDBnRc4C.mjs}

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

package/dist/{use-table-nav-bridge-BLLVGR1r.cjs → use-table-nav-bridge-DvrsPanF.cjs}

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

package/dist/{use-table-state-BEwXQayO.mjs → use-table-state-BzjbnpBA.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 { DEV, 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 { DEV, STANDARD_PRESET_ID, arraysEqual, blockStartFor, buildTableQuery, cellAsString, debounce, derivePresetAspects, filterExprFields, filterExprKey, fromWireSnapshot, gateOwns, isDirtyAgainst, isFilled, isSystemPresetId, mergeDisplayColumns, mergeSorters, normalizeResidualFilters, pageAlignedBlocksFor, planFetch, reconcileColumnWidthDefaults, residualGateOwns, 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. */
@@ -1023,6 +1023,7 @@ function createPresetState(opts) {
 			apply(o, value, isSystem) {
 				if (!value && !isSystem) return;
 				o.filters.value = value ? { ...value } : {};
+				if (o.residualFilters?.value.length) o.residualFilters.value = [];
 			},
 			expandDefault: () => ({})
 		},
@@ -1151,7 +1152,7 @@ function createPresetState(opts) {
 		const wire = row.data?.content;
 		return wire ? fromWireSnapshot(wire) : {};
 	});
-	const isDirty = computed(() => isDirtyAgainst(activeSnapshot.value, captureSnapshot()));
+	const isDirty = computed(() => isDirtyAgainst(activeSnapshot.value, captureSnapshot()) || activeSnapshot.value.filterOps !== void 0 && !!opts.residualFilters?.value.length);
 	function requirePresets() {
 		if (!opts.presetsHandle) throw new Error("[vue-table] presets feature not configured (preset.url missing)");
 		return opts.presetsHandle;
@@ -1594,6 +1595,10 @@ const cloneSorter = (s) => ({
 	field: s.field,
 	direction: s.direction
 });
+/** Same residual conditions, in the same (canonical) order. */
+function sameResidualFilters(a, b) {
+	return arraysEqual(a.map(filterExprKey), b.map(filterExprKey));
+}
 /**
 * The report for a restored URL's filter piece when nobody handles it
 * (`onUnsupportedFilter` / `@unsupported-filter`): a dev-mode warning.
@@ -1638,6 +1643,7 @@ function createTableState(opts) {
 	*/
 	const rowActionsPolicy = computed(() => compileRowActionsConfig(rowActions.value));
 	const filters = shallowRef({});
+	const residualFilters = shallowRef([]);
 	const results = shallowRef([]);
 	const resultsStart = ref(0);
 	const querying = ref(false);
@@ -1680,6 +1686,7 @@ function createTableState(opts) {
 		columnWidths,
 		filterFields,
 		filters,
+		residualFilters,
 		sorters,
 		pagination,
 		allColumns,
@@ -1778,6 +1785,7 @@ function createTableState(opts) {
 			sorters: splitSorters.value.server,
 			forceSorters: queryOpts?.forceSorters,
 			filters: filters.value,
+			residualFilters: residualFilters.value,
 			forceFilters: queryOpts?.forceFilters,
 			search: searchTerm.value || void 0,
 			ignoreSorters: sortersIgnored(),
@@ -1964,6 +1972,10 @@ function createTableState(opts) {
 			}
 		};
 	}
+	function setResidualFilters(exprs) {
+		const next = normalizeResidualFilters(exprs);
+		if (!sameResidualFilters(next, residualFilters.value)) residualFilters.value = next;
+	}
 	const state = {
 		tableDef,
 		loadingMetadata,
@@ -1973,6 +1985,7 @@ function createTableState(opts) {
 		columnWidths,
 		filterFields,
 		filters,
+		residualFilters,
 		sorters,
 		results,
 		resultsStart,
@@ -2047,8 +2060,14 @@ function createTableState(opts) {
 		loadingAt,
 		errorAt,
 		resetFilters() {
-			if (Object.keys(filters.value).length === 0) return;
-			filters.value = {};
+			if (Object.keys(filters.value).length > 0) filters.value = {};
+			if (residualFilters.value.length > 0) residualFilters.value = [];
+		},
+		setResidualFilters,
+		removeResidualFilter(index) {
+			const list = residualFilters.value;
+			if (index < 0 || index >= list.length) return;
+			residualFilters.value = list.filter((_, i) => i !== index);
 		},
 		showConfigDialog(tab) {
 			configTab.value = tab ?? "columns";
@@ -2099,6 +2118,7 @@ function createTableState(opts) {
 	function serializeStateForUrl() {
 		return stateToUrlQueryString({
 			filters: filters.value,
+			residualFilters: residualFilters.value,
 			sorters: sorters.value,
 			page: pagination.value.page,
 			itemsPerPage: pagination.value.itemsPerPage,
@@ -2129,6 +2149,8 @@ function createTableState(opts) {
 	}
 	const filtersGate = resolveAspectGate(urlQuerySync?.filters);
 	const sortersGate = resolveAspectGate(urlQuerySync?.sorters);
+	const residualSync = urlQuerySync?.residual !== false;
+	const urlOwnsResidual = (expr) => residualSync && residualGateOwns(filtersGate, expr);
 	let urlBaseline = null;
 	function captureUrlBaseline() {
 		if (urlBaseline) return;
@@ -2139,6 +2161,7 @@ function createTableState(opts) {
 		}
 		urlBaseline = {
 			filters: owned,
+			residual: residualFilters.value.filter(urlOwnsResidual),
 			sorters: sorters.value.filter((s) => gateOwns(sortersGate, s.field)).map(cloneSorter)
 		};
 	}
@@ -2158,10 +2181,12 @@ function createTableState(opts) {
 		if (urlsEquivalent(urlString, lastEmittedUrl)) return;
 		const cols = allColumns.value;
 		const parsed = urlQueryStringToState(urlString, {
-			knownFields: cols.length > 0 ? cols.map((c) => c.path) : void 0,
+			knownFields: cols.length > 0 ? cols.filter((c) => !c.local).map((c) => c.path) : void 0,
 			sync: urlQuerySync
 		});
 		for (const issue of parsed.unsupported ?? []) (queryOpts?.onUnsupportedFilter ?? warnUnsupportedFilter)(issue);
+		const urlResidual = parsed.residual ?? [];
+		const residualPaths = new Set(urlResidual.flatMap((expr) => filterExprFields(expr)));
 		const base = (opts?.mode ? opts.mode === "replace" : parsed.snapshot === true) ? null : urlBaseline;
 		const currentItemsPerPage = pagination.value.itemsPerPage;
 		const skip = parsed.skip ?? 0;
@@ -2170,12 +2195,24 @@ function createTableState(opts) {
 		hydratingFromUrl = true;
 		if (filtersGate !== "none") {
 			const next = {};
+			const fromBase = (path) => !!base?.filters[path] && !residualPaths.has(path);
 			for (const path in filters.value) if (!gateOwns(filtersGate, path)) next[path] = filters.value[path];
-			else if (base?.filters[path]) next[path] = cloneConditions(base.filters[path]);
-			if (base) for (const path in base.filters) next[path] ??= cloneConditions(base.filters[path]);
+			else if (fromBase(path)) next[path] = cloneConditions(base.filters[path]);
+			if (base) {
+				for (const path in base.filters) if (fromBase(path)) next[path] ??= cloneConditions(base.filters[path]);
+			}
 			for (const path in parsed.filters) next[path] = parsed.filters[path];
 			filters.value = next;
 		}
+		if (residualSync) {
+			const mentioned = new Set([...Object.keys(parsed.filters), ...residualPaths]);
+			const next = residualFilters.value.filter((expr) => !urlOwnsResidual(expr));
+			if (base) {
+				for (const expr of base.residual) if (!filterExprFields(expr).some((f) => mentioned.has(f))) next.push(expr);
+			}
+			next.push(...urlResidual);
+			setResidualFilters(next);
+		}
 		let urlSortersChanged = false;
 		if (sortersGate !== "none") {
 			const urlSortFields = new Set(parsed.sorters.map((s) => s.field));
@@ -2220,7 +2257,11 @@ function createTableState(opts) {
 	const debouncedFilterQuery = debounce(() => {
 		if (queryDetected) scheduleQuery();
 	}, FILTER_DEBOUNCE_MS);
-	watch([() => filters.value, () => searchTerm.value], () => {
+	watch([
+		() => filters.value,
+		() => residualFilters.value,
+		() => searchTerm.value
+	], () => {
 		if (hydratingFromUrl) return;
 		if (!queryDetected) return;
 		mustRefresh.value = true;
@@ -2267,6 +2308,7 @@ function createTableState(opts) {
 	});
 	watch([
 		() => filters.value,
+		() => residualFilters.value,
 		() => sorters.value,
 		() => searchTerm.value,
 		() => pagination.value,

package/dist/{use-table-state-Cnxv0w_E.cjs → use-table-state-pF_9gnTG.cjs}

@@ -1023,6 +1023,7 @@ function createPresetState(opts) {
 			apply(o, value, isSystem) {
 				if (!value && !isSystem) return;
 				o.filters.value = value ? { ...value } : {};
+				if (o.residualFilters?.value.length) o.residualFilters.value = [];
 			},
 			expandDefault: () => ({})
 		},
@@ -1151,7 +1152,7 @@ function createPresetState(opts) {
 		const wire = row.data?.content;
 		return wire ? (0, _atscript_ui_table.fromWireSnapshot)(wire) : {};
 	});
-	const isDirty = (0, vue.computed)(() => (0, _atscript_ui_table.isDirtyAgainst)(activeSnapshot.value, captureSnapshot()));
+	const isDirty = (0, vue.computed)(() => (0, _atscript_ui_table.isDirtyAgainst)(activeSnapshot.value, captureSnapshot()) || activeSnapshot.value.filterOps !== void 0 && !!opts.residualFilters?.value.length);
 	function requirePresets() {
 		if (!opts.presetsHandle) throw new Error("[vue-table] presets feature not configured (preset.url missing)");
 		return opts.presetsHandle;
@@ -1594,6 +1595,10 @@ const cloneSorter = (s) => ({
 	field: s.field,
 	direction: s.direction
 });
+/** Same residual conditions, in the same (canonical) order. */
+function sameResidualFilters(a, b) {
+	return (0, _atscript_ui_table.arraysEqual)(a.map(_atscript_ui_table.filterExprKey), b.map(_atscript_ui_table.filterExprKey));
+}
 /**
 * The report for a restored URL's filter piece when nobody handles it
 * (`onUnsupportedFilter` / `@unsupported-filter`): a dev-mode warning.
@@ -1638,6 +1643,7 @@ function createTableState(opts) {
 	*/
 	const rowActionsPolicy = (0, vue.computed)(() => compileRowActionsConfig(rowActions.value));
 	const filters = (0, vue.shallowRef)({});
+	const residualFilters = (0, vue.shallowRef)([]);
 	const results = (0, vue.shallowRef)([]);
 	const resultsStart = (0, vue.ref)(0);
 	const querying = (0, vue.ref)(false);
@@ -1680,6 +1686,7 @@ function createTableState(opts) {
 		columnWidths,
 		filterFields,
 		filters,
+		residualFilters,
 		sorters,
 		pagination,
 		allColumns,
@@ -1778,6 +1785,7 @@ function createTableState(opts) {
 			sorters: splitSorters.value.server,
 			forceSorters: queryOpts?.forceSorters,
 			filters: filters.value,
+			residualFilters: residualFilters.value,
 			forceFilters: queryOpts?.forceFilters,
 			search: searchTerm.value || void 0,
 			ignoreSorters: sortersIgnored(),
@@ -1964,6 +1972,10 @@ function createTableState(opts) {
 			}
 		};
 	}
+	function setResidualFilters(exprs) {
+		const next = (0, _atscript_ui_table.normalizeResidualFilters)(exprs);
+		if (!sameResidualFilters(next, residualFilters.value)) residualFilters.value = next;
+	}
 	const state = {
 		tableDef,
 		loadingMetadata,
@@ -1973,6 +1985,7 @@ function createTableState(opts) {
 		columnWidths,
 		filterFields,
 		filters,
+		residualFilters,
 		sorters,
 		results,
 		resultsStart,
@@ -2047,8 +2060,14 @@ function createTableState(opts) {
 		loadingAt,
 		errorAt,
 		resetFilters() {
-			if (Object.keys(filters.value).length === 0) return;
-			filters.value = {};
+			if (Object.keys(filters.value).length > 0) filters.value = {};
+			if (residualFilters.value.length > 0) residualFilters.value = [];
+		},
+		setResidualFilters,
+		removeResidualFilter(index) {
+			const list = residualFilters.value;
+			if (index < 0 || index >= list.length) return;
+			residualFilters.value = list.filter((_, i) => i !== index);
 		},
 		showConfigDialog(tab) {
 			configTab.value = tab ?? "columns";
@@ -2099,6 +2118,7 @@ function createTableState(opts) {
 	function serializeStateForUrl() {
 		return (0, _atscript_ui_table.stateToUrlQueryString)({
 			filters: filters.value,
+			residualFilters: residualFilters.value,
 			sorters: sorters.value,
 			page: pagination.value.page,
 			itemsPerPage: pagination.value.itemsPerPage,
@@ -2129,6 +2149,8 @@ function createTableState(opts) {
 	}
 	const filtersGate = (0, _atscript_ui_table.resolveAspectGate)(urlQuerySync?.filters);
 	const sortersGate = (0, _atscript_ui_table.resolveAspectGate)(urlQuerySync?.sorters);
+	const residualSync = urlQuerySync?.residual !== false;
+	const urlOwnsResidual = (expr) => residualSync && (0, _atscript_ui_table.residualGateOwns)(filtersGate, expr);
 	let urlBaseline = null;
 	function captureUrlBaseline() {
 		if (urlBaseline) return;
@@ -2139,6 +2161,7 @@ function createTableState(opts) {
 		}
 		urlBaseline = {
 			filters: owned,
+			residual: residualFilters.value.filter(urlOwnsResidual),
 			sorters: sorters.value.filter((s) => (0, _atscript_ui_table.gateOwns)(sortersGate, s.field)).map(cloneSorter)
 		};
 	}
@@ -2158,10 +2181,12 @@ function createTableState(opts) {
 		if (urlsEquivalent(urlString, lastEmittedUrl)) return;
 		const cols = allColumns.value;
 		const parsed = (0, _atscript_ui_table.urlQueryStringToState)(urlString, {
-			knownFields: cols.length > 0 ? cols.map((c) => c.path) : void 0,
+			knownFields: cols.length > 0 ? cols.filter((c) => !c.local).map((c) => c.path) : void 0,
 			sync: urlQuerySync
 		});
 		for (const issue of parsed.unsupported ?? []) (queryOpts?.onUnsupportedFilter ?? warnUnsupportedFilter)(issue);
+		const urlResidual = parsed.residual ?? [];
+		const residualPaths = new Set(urlResidual.flatMap((expr) => (0, _atscript_ui_table.filterExprFields)(expr)));
 		const base = (opts?.mode ? opts.mode === "replace" : parsed.snapshot === true) ? null : urlBaseline;
 		const currentItemsPerPage = pagination.value.itemsPerPage;
 		const skip = parsed.skip ?? 0;
@@ -2170,12 +2195,24 @@ function createTableState(opts) {
 		hydratingFromUrl = true;
 		if (filtersGate !== "none") {
 			const next = {};
+			const fromBase = (path) => !!base?.filters[path] && !residualPaths.has(path);
 			for (const path in filters.value) if (!(0, _atscript_ui_table.gateOwns)(filtersGate, path)) next[path] = filters.value[path];
-			else if (base?.filters[path]) next[path] = cloneConditions(base.filters[path]);
-			if (base) for (const path in base.filters) next[path] ??= cloneConditions(base.filters[path]);
+			else if (fromBase(path)) next[path] = cloneConditions(base.filters[path]);
+			if (base) {
+				for (const path in base.filters) if (fromBase(path)) next[path] ??= cloneConditions(base.filters[path]);
+			}
 			for (const path in parsed.filters) next[path] = parsed.filters[path];
 			filters.value = next;
 		}
+		if (residualSync) {
+			const mentioned = new Set([...Object.keys(parsed.filters), ...residualPaths]);
+			const next = residualFilters.value.filter((expr) => !urlOwnsResidual(expr));
+			if (base) {
+				for (const expr of base.residual) if (!(0, _atscript_ui_table.filterExprFields)(expr).some((f) => mentioned.has(f))) next.push(expr);
+			}
+			next.push(...urlResidual);
+			setResidualFilters(next);
+		}
 		let urlSortersChanged = false;
 		if (sortersGate !== "none") {
 			const urlSortFields = new Set(parsed.sorters.map((s) => s.field));
@@ -2220,7 +2257,11 @@ function createTableState(opts) {
 	const debouncedFilterQuery = (0, _atscript_ui_table.debounce)(() => {
 		if (queryDetected) scheduleQuery();
 	}, FILTER_DEBOUNCE_MS);
-	(0, vue.watch)([() => filters.value, () => searchTerm.value], () => {
+	(0, vue.watch)([
+		() => filters.value,
+		() => residualFilters.value,
+		() => searchTerm.value
+	], () => {
 		if (hydratingFromUrl) return;
 		if (!queryDetected) return;
 		mustRefresh.value = true;
@@ -2267,6 +2308,7 @@ function createTableState(opts) {
 	});
 	(0, vue.watch)([
 		() => filters.value,
+		() => residualFilters.value,
 		() => sorters.value,
 		() => searchTerm.value,
 		() => pagination.value,