@atscript/ui-table 0.1.132 → 0.1.133

package/dist/index.cjs

@@ -149,13 +149,22 @@ function unescapeRegex(input) {
 //#region src/filters/filter-input-format.ts
 /**
 * Coerce a raw string value to the appropriate JS type for the column.
-* Number columns get numeric values; everything else stays as string.
+* Number columns get numeric values, boolean columns understand the
+* `true` / `false` vocabulary (case-insensitive) so the condition carries a
+* real boolean and round-trips through the URL as one. Anything else stays
+* a string. Since 0.1.133 for booleans.
 */
 function coerceValue(raw, columnType) {
 	if (columnType === "number") {
 		const n = Number(raw);
 		return Number.isNaN(n) ? raw : n;
 	}
+	if (columnType === "boolean") {
+		const lower = raw.toLowerCase();
+		if (lower === "true") return true;
+		if (lower === "false") return false;
+		return raw;
+	}
 	return raw;
 }
 /** Default condition type when no symbol matches the input. */
@@ -580,6 +589,10 @@ function derivePresetAspects(content) {
 * Convert in-memory dict-form snapshot to the wire form persisted on the
 * server. Entries-arrays are sorted by `field` so consumers (server-side
 * aspect derivation, dirty detection, equality checks) see a stable order.
+*
+* Empty aspects round-trip as empty (since 0.1.133): a saved view with no
+* filters owns `filterOps` and clears them on apply, which is not the same
+* thing as a view that never claimed the aspect.
 */
 function toWireSnapshot(snapshot) {
 	const wire = {};
@@ -592,7 +605,7 @@ function toWireSnapshot(snapshot) {
 				field,
 				width: columnWidths[field]
 			});
-			if (entries.length > 0) columns.columnWidths = entries;
+			columns.columnWidths = entries;
 		}
 		wire.columns = columns;
 	}
@@ -603,7 +616,7 @@ function toWireSnapshot(snapshot) {
 			field,
 			conditions: snapshot.filterOps[field]
 		});
-		if (entries.length > 0) wire.filterOps = entries;
+		wire.filterOps = entries;
 	}
 	if (snapshot.sorters) wire.sorters = snapshot.sorters;
 	if (snapshot.itemsPerPage !== void 0) wire.itemsPerPage = snapshot.itemsPerPage;
@@ -614,7 +627,7 @@ function fromWireSnapshot(wire) {
 	if (wire.columns) {
 		const { columnNames, columnWidths } = wire.columns;
 		const columns = { columnNames };
-		if (columnWidths && columnWidths.length > 0) {
+		if (columnWidths) {
 			const dict = {};
 			for (const entry of columnWidths) dict[entry.field] = entry.width;
 			columns.columnWidths = dict;
@@ -622,7 +635,7 @@ function fromWireSnapshot(wire) {
 		snapshot.columns = columns;
 	}
 	if (wire.filters) snapshot.filters = wire.filters;
-	if (wire.filterOps && wire.filterOps.length > 0) {
+	if (wire.filterOps) {
 		const dict = {};
 		for (const entry of wire.filterOps) dict[entry.field] = entry.conditions;
 		snapshot.filterOps = dict;
@@ -819,7 +832,7 @@ function draftMatchesPreset(draft, presetSnapshot, availableAspects) {
 /**
 * Framework-agnostic wrapper over `@atscript/db-client`'s `Client` for the
 * `AsPresetEntry` table. Handles wire serialisation, list-splitting by
-* `type`, capabilities side-channel, and 401/403 → `denied` semantics.
+* `type`, capabilities side-channel, and 401/403/404 → `denied` semantics.
 *
 * Stateless: every method is a fresh request. The Vue composable layer
 * holds reactive state; this class only translates intent → HTTP.
@@ -845,8 +858,8 @@ var PresetsClient = class {
 	* `(app, tableKey)`. By default also fetches `capabilities` in parallel —
 	* pass `{ capabilities: false }` for refresh-after-mutation calls (fav
 	* toggle, default change, save/save-as, public toggle, rename, delete)
-	* where role-derived capabilities can't have changed. Auth errors
-	* (401/403) collapse to `denied: true` with empty data so the UI hides
+	* where role-derived capabilities can't have changed. Unavailable
+	* responses (401/403/404) collapse to `denied: true` with empty data so the UI hides
 	* itself silently.
 	*/
 	async list(opts = {}) {
@@ -858,7 +871,7 @@ var PresetsClient = class {
 		};
 		try {
 			const [rows, capabilities] = await Promise.all([this.client.query({ filter }), fetchCapabilities ? this.loadCapabilities().catch((err) => {
-				if (isAuthError(err)) throw err;
+				if (isUnavailableError(err)) throw err;
 				return null;
 			}) : Promise.resolve(void 0)]);
 			const presets = [];
@@ -872,7 +885,7 @@ var PresetsClient = class {
 				denied: false
 			};
 		} catch (err) {
-			if (isAuthError(err)) return {
+			if (isUnavailableError(err)) return {
 				presets: [],
 				userConf: null,
 				capabilities: null,
@@ -988,12 +1001,22 @@ var PresetsHttpError = class extends Error {
 		this.name = "PresetsHttpError";
 	}
 };
-/** True for HTTP 401/403 across both `ClientError` and `PresetsHttpError`. */
-function isAuthError(err) {
-	if (err instanceof _atscript_db_client.ClientError && (err.status === 401 || err.status === 403)) return true;
-	if (err instanceof PresetsHttpError && (err.status === 401 || err.status === 403)) return true;
-	return false;
+/**
+* True when the presets/app-prefs surface is simply not available to this
+* client: HTTP 401/403 (not signed in / not permitted) or 404 (the
+* controller is not mounted on this server). All three collapse to
+* `denied: true` — the UI hides itself silently instead of surfacing an
+* error. Covers both `ClientError` and `PresetsHttpError`.
+*/
+function isUnavailableError(err) {
+	const status = err instanceof _atscript_db_client.ClientError || err instanceof PresetsHttpError ? err.status : void 0;
+	return status === 401 || status === 403 || status === 404;
 }
+/**
+* @deprecated Renamed to `isUnavailableError` in 0.1.133 — it also covers
+* 404 (feature not mounted), not just auth failures.
+*/
+const isAuthError = isUnavailableError;
 //#endregion
 //#region src/presets/app-prefs-client.ts
 /**
@@ -1026,7 +1049,7 @@ var AppPrefsClient = class {
 				denied: false
 			};
 		} catch (err) {
-			if (isAuthError(err)) return {
+			if (isUnavailableError(err)) return {
 				row: null,
 				prefs: null,
 				denied: true
@@ -1232,6 +1255,36 @@ function stateToUrlQueryString(state, defaults) {
 	return (0, _uniqu_url_builder.buildUrl)(query);
 }
 /**
+* The `$`-controls {@link urlQueryStringToState} actually reads. Any other
+* `$key` is ignored by the parser, so it is NOT the table's to remove.
+*/
+const CONSUMED_CONTROLS = new Set([
+	"$sort",
+	"$search",
+	"$relevance",
+	"$skip"
+]);
+/** Characters that can only appear in a uniqu filter key, never in a page flag. */
+const FILTER_OPERATOR_CHAR = /[<>!~]/;
+/**
+* Whether {@link urlQueryStringToState} would consume the query key `key` —
+* i.e. whether the key belongs to the table rather than to the page hosting
+* it. This is the ownership rule the `useTableUrlQuery` router bridge reads
+* and writes by, so both directions agree: a key the parser ignores is never
+* removed, and a key it reads is the table's to remove.
+*
+* Shape-only, and deliberately conservative for bare `field=value` keys: a
+* filter on a column and a host flag are indistinguishable without the table
+* definition, so those are owned only once the bridge has written them
+* itself (or once a `prefix` namespaces them).
+*
+* @since 0.1.133
+*/
+function urlQueryConsumesKey(key) {
+	if (key.startsWith("$")) return CONSUMED_CONTROLS.has(key);
+	return FILTER_OPERATOR_CHAR.test(key);
+}
+/**
 * Parse a URL query string back into the table state subset.
 *
 * Robust by design — schema drift and copy-paste errors must not break the
@@ -1669,6 +1722,7 @@ exports.isEmptyDraft = isEmptyDraft;
 exports.isFilled = isFilled;
 exports.isSimpleEq = isSimpleEq;
 exports.isSystemPresetId = isSystemPresetId;
+exports.isUnavailableError = isUnavailableError;
 exports.mergeFilters = mergeFilters;
 exports.mergeSorters = mergeSorters;
 exports.normaliseSystemPresetId = normaliseSystemPresetId;
@@ -1691,6 +1745,7 @@ exports.togglePk = togglePk;
 exports.trimSelection = trimSelection;
 exports.unescapeRegex = unescapeRegex;
 exports.uniqueryFilterToFieldFilters = uniqueryFilterToFieldFilters;
+exports.urlQueryConsumesKey = urlQueryConsumesKey;
 exports.urlQueryStringToState = urlQueryStringToState;
 exports.userConfId = userConfId;
 exports.walkBackwardAbsorb = walkBackwardAbsorb;

package/dist/index.d.cts

@@ -197,6 +197,10 @@ declare function derivePresetAspects(content: unknown): PresetAspect[];
  * Convert in-memory dict-form snapshot to the wire form persisted on the
  * server. Entries-arrays are sorted by `field` so consumers (server-side
  * aspect derivation, dirty detection, equality checks) see a stable order.
+ *
+ * Empty aspects round-trip as empty (since 0.1.133): a saved view with no
+ * filters owns `filterOps` and clears them on apply, which is not the same
+ * thing as a view that never claimed the aspect.
  */
 declare function toWireSnapshot(snapshot: PresetSnapshot): PresetSnapshotWire;
 declare function fromWireSnapshot(wire: PresetSnapshotWire): PresetSnapshot;
@@ -454,7 +458,7 @@ interface PresetsListResult {
    * untouched.
    */
   capabilities: PresetCapabilities | null | undefined;
-  /** True when the controller responded 401/403 — UI silently hides. */
+  /** True when the controller responded 401/403/404 — UI silently hides. */
   denied: boolean;
 }
 interface PresetsSaveAsOptions {
@@ -466,7 +470,7 @@ interface PresetsSaveResult {
 /**
  * Framework-agnostic wrapper over `@atscript/db-client`'s `Client` for the
  * `AsPresetEntry` table. Handles wire serialisation, list-splitting by
- * `type`, capabilities side-channel, and 401/403 → `denied` semantics.
+ * `type`, capabilities side-channel, and 401/403/404 → `denied` semantics.
  *
  * Stateless: every method is a fresh request. The Vue composable layer
  * holds reactive state; this class only translates intent → HTTP.
@@ -483,8 +487,8 @@ declare class PresetsClient {
    * `(app, tableKey)`. By default also fetches `capabilities` in parallel —
    * pass `{ capabilities: false }` for refresh-after-mutation calls (fav
    * toggle, default change, save/save-as, public toggle, rename, delete)
-   * where role-derived capabilities can't have changed. Auth errors
-   * (401/403) collapse to `denied: true` with empty data so the UI hides
+   * where role-derived capabilities can't have changed. Unavailable
+   * responses (401/403/404) collapse to `denied: true` with empty data so the UI hides
    * itself silently.
    */
   list(opts?: {
@@ -525,8 +529,19 @@ declare class PresetsHttpError extends Error {
   readonly status: number;
   constructor(status: number, message: string);
 }
-/** True for HTTP 401/403 across both `ClientError` and `PresetsHttpError`. */
-declare function isAuthError(err: unknown): boolean;
+/**
+ * True when the presets/app-prefs surface is simply not available to this
+ * client: HTTP 401/403 (not signed in / not permitted) or 404 (the
+ * controller is not mounted on this server). All three collapse to
+ * `denied: true` — the UI hides itself silently instead of surfacing an
+ * error. Covers both `ClientError` and `PresetsHttpError`.
+ */
+declare function isUnavailableError(err: unknown): boolean;
+/**
+ * @deprecated Renamed to `isUnavailableError` in 0.1.133 — it also covers
+ * 404 (feature not mounted), not just auth failures.
+ */
+declare const isAuthError: typeof isUnavailableError;
 //#endregion
 //#region src/presets/app-prefs-client.d.ts
 /**
@@ -547,7 +562,7 @@ interface AppPrefsLoadResult {
   row: AsPresetEntryRow | null;
   /** Convenience accessor for `row.data` (the typed prefs payload), or `null`. */
   prefs: AppConfData | null;
-  /** True when the controller responded 401/403. */
+  /** True when the controller responded 401/403/404 (not mounted). */
   denied: boolean;
 }
 /**
@@ -734,6 +749,21 @@ declare function resolveAspectGate(value: boolean | string[] | undefined): Aspec
  * Returns `""` (no leading `?`) for the default view.
  */
 declare function stateToUrlQueryString(state: UrlQueryStateLike, defaults: UrlQueryDefaults): string;
+/**
+ * Whether {@link urlQueryStringToState} would consume the query key `key` —
+ * i.e. whether the key belongs to the table rather than to the page hosting
+ * it. This is the ownership rule the `useTableUrlQuery` router bridge reads
+ * and writes by, so both directions agree: a key the parser ignores is never
+ * removed, and a key it reads is the table's to remove.
+ *
+ * Shape-only, and deliberately conservative for bare `field=value` keys: a
+ * filter on a column and a host flag are indistinguishable without the table
+ * definition, so those are owned only once the bridge has written them
+ * itself (or once a `prefix` namespaces them).
+ *
+ * @since 0.1.133
+ */
+declare function urlQueryConsumesKey(key: string): boolean;
 interface UrlQueryParseOptions {
   /**
    * Field paths the table knows about. Conditions on fields outside this set
@@ -1076,4 +1106,4 @@ type ColumnReorderPosition = "before" | "after";
  */
 declare function reorderColumnNames(names: string[], fromPath: string, toPath: string, position: ColumnReorderPosition): string[];
 //#endregion
-export { APP_CONF_PREFIX, type AppConfData, AppPrefsClient, type AppPrefsClientConfig, type AppPrefsLoadResult, type AsPresetEntryData, type AsPresetEntryRow, type AsPresetsErrorCode, type AspectGate, type AspectMask, type BuildTableQueryOptions, type ColumnFilterType, type ColumnReorderPosition, type ColumnWidthEntry, type ColumnWidthsMap, type ConfigTab, DEFAULT_ROW_HEIGHT_PX, DRAFT_PERSISTED_ASPECTS, type DateShortcut, type DraftPersistedAspect, type FetchPlan, type FetchPlanMode, type FieldFilters, type FilterCondition, type FilterConditionType, MAX_DEFAULT_COLUMN_WIDTH_PX, type MergeResult, NULL_OPS, PRESET_ASPECTS, type PageAlignedBlock, type PlanFetchArgs, type PresetAspect, type PresetCapabilities, type PresetColumnWidthEntry, type PresetData, type PresetDraft, type PresetFilterOpEntry, type PresetLimitReachedBody, type PresetSnapshot, type PresetSnapshotWire, type PresetSorterEntry, PresetsClient, type PresetsClientConfig, PresetsHttpError, type PresetsListResult, type PresetsSaveAsOptions, type PresetsSaveResult, type QueryOptions, RESERVED_ID_PREFIXES, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, type SelectionMode, type SystemPreset, type SystemPresetInput, type TableStateData, type TableStateMethods, USER_CONF_PREFIX, type UrlQueryDefaults, type UrlQueryParseOptions, type UrlQueryStateLike, type UrlQueryStateSnapshot, type UrlQuerySync, type UserConfData, appConfId, arraysEqual, blockStartFor, buildTableQuery, clampTopIndex, columnFilterType, computeDefaultColumnWidth, conditionLabel, conditionsForType, dateShortcuts, debounce, defaultCondition, derivePresetAspects, deserializeDraft, draftMatchesPreset, escapeRegex, filledFilterCount, filterTokenLabel, filtersToUniqueryFilter, formatFilterCondition, fromWireSnapshot, hasSecondValue, isAuthError, isDirtyAgainst, isEmptyDraft, isFilled, isSimpleEq, isSystemPresetId, mergeFilters, mergeSorters, normaliseSystemPresetId, pageAlignedBlocksFor, parseFilterInput, planFetch, reconcileColumnWidthDefaults, reorderColumnNames, resolveAspectGate, resolveSystemPresets, rowsToPks, sameColumnSet, serializeDraft, setsEqual, sortersEqual, stableStringify, stateToUrlQueryString, toWireSnapshot, togglePk, trimSelection, unescapeRegex, uniqueryFilterToFieldFilters, urlQueryStringToState, userConfId, walkBackwardAbsorb, walkForwardAbsorb };
+export { APP_CONF_PREFIX, type AppConfData, AppPrefsClient, type AppPrefsClientConfig, type AppPrefsLoadResult, type AsPresetEntryData, type AsPresetEntryRow, type AsPresetsErrorCode, type AspectGate, type AspectMask, type BuildTableQueryOptions, type ColumnFilterType, type ColumnReorderPosition, type ColumnWidthEntry, type ColumnWidthsMap, type ConfigTab, DEFAULT_ROW_HEIGHT_PX, DRAFT_PERSISTED_ASPECTS, type DateShortcut, type DraftPersistedAspect, type FetchPlan, type FetchPlanMode, type FieldFilters, type FilterCondition, type FilterConditionType, MAX_DEFAULT_COLUMN_WIDTH_PX, type MergeResult, NULL_OPS, PRESET_ASPECTS, type PageAlignedBlock, type PlanFetchArgs, type PresetAspect, type PresetCapabilities, type PresetColumnWidthEntry, type PresetData, type PresetDraft, type PresetFilterOpEntry, type PresetLimitReachedBody, type PresetSnapshot, type PresetSnapshotWire, type PresetSorterEntry, PresetsClient, type PresetsClientConfig, PresetsHttpError, type PresetsListResult, type PresetsSaveAsOptions, type PresetsSaveResult, type QueryOptions, RESERVED_ID_PREFIXES, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, type SelectionMode, type SystemPreset, type SystemPresetInput, type TableStateData, type TableStateMethods, USER_CONF_PREFIX, type UrlQueryDefaults, type UrlQueryParseOptions, type UrlQueryStateLike, type UrlQueryStateSnapshot, type UrlQuerySync, type UserConfData, appConfId, arraysEqual, blockStartFor, buildTableQuery, clampTopIndex, columnFilterType, computeDefaultColumnWidth, conditionLabel, conditionsForType, dateShortcuts, debounce, defaultCondition, derivePresetAspects, deserializeDraft, draftMatchesPreset, escapeRegex, filledFilterCount, filterTokenLabel, filtersToUniqueryFilter, formatFilterCondition, fromWireSnapshot, hasSecondValue, isAuthError, isDirtyAgainst, isEmptyDraft, isFilled, isSimpleEq, isSystemPresetId, isUnavailableError, mergeFilters, mergeSorters, normaliseSystemPresetId, pageAlignedBlocksFor, parseFilterInput, planFetch, reconcileColumnWidthDefaults, reorderColumnNames, resolveAspectGate, resolveSystemPresets, rowsToPks, sameColumnSet, serializeDraft, setsEqual, sortersEqual, stableStringify, stateToUrlQueryString, toWireSnapshot, togglePk, trimSelection, unescapeRegex, uniqueryFilterToFieldFilters, urlQueryConsumesKey, urlQueryStringToState, userConfId, walkBackwardAbsorb, walkForwardAbsorb };

package/dist/index.d.mts

@@ -197,6 +197,10 @@ declare function derivePresetAspects(content: unknown): PresetAspect[];
  * Convert in-memory dict-form snapshot to the wire form persisted on the
  * server. Entries-arrays are sorted by `field` so consumers (server-side
  * aspect derivation, dirty detection, equality checks) see a stable order.
+ *
+ * Empty aspects round-trip as empty (since 0.1.133): a saved view with no
+ * filters owns `filterOps` and clears them on apply, which is not the same
+ * thing as a view that never claimed the aspect.
  */
 declare function toWireSnapshot(snapshot: PresetSnapshot): PresetSnapshotWire;
 declare function fromWireSnapshot(wire: PresetSnapshotWire): PresetSnapshot;
@@ -454,7 +458,7 @@ interface PresetsListResult {
    * untouched.
    */
   capabilities: PresetCapabilities | null | undefined;
-  /** True when the controller responded 401/403 — UI silently hides. */
+  /** True when the controller responded 401/403/404 — UI silently hides. */
   denied: boolean;
 }
 interface PresetsSaveAsOptions {
@@ -466,7 +470,7 @@ interface PresetsSaveResult {
 /**
  * Framework-agnostic wrapper over `@atscript/db-client`'s `Client` for the
  * `AsPresetEntry` table. Handles wire serialisation, list-splitting by
- * `type`, capabilities side-channel, and 401/403 → `denied` semantics.
+ * `type`, capabilities side-channel, and 401/403/404 → `denied` semantics.
  *
  * Stateless: every method is a fresh request. The Vue composable layer
  * holds reactive state; this class only translates intent → HTTP.
@@ -483,8 +487,8 @@ declare class PresetsClient {
    * `(app, tableKey)`. By default also fetches `capabilities` in parallel —
    * pass `{ capabilities: false }` for refresh-after-mutation calls (fav
    * toggle, default change, save/save-as, public toggle, rename, delete)
-   * where role-derived capabilities can't have changed. Auth errors
-   * (401/403) collapse to `denied: true` with empty data so the UI hides
+   * where role-derived capabilities can't have changed. Unavailable
+   * responses (401/403/404) collapse to `denied: true` with empty data so the UI hides
    * itself silently.
    */
   list(opts?: {
@@ -525,8 +529,19 @@ declare class PresetsHttpError extends Error {
   readonly status: number;
   constructor(status: number, message: string);
 }
-/** True for HTTP 401/403 across both `ClientError` and `PresetsHttpError`. */
-declare function isAuthError(err: unknown): boolean;
+/**
+ * True when the presets/app-prefs surface is simply not available to this
+ * client: HTTP 401/403 (not signed in / not permitted) or 404 (the
+ * controller is not mounted on this server). All three collapse to
+ * `denied: true` — the UI hides itself silently instead of surfacing an
+ * error. Covers both `ClientError` and `PresetsHttpError`.
+ */
+declare function isUnavailableError(err: unknown): boolean;
+/**
+ * @deprecated Renamed to `isUnavailableError` in 0.1.133 — it also covers
+ * 404 (feature not mounted), not just auth failures.
+ */
+declare const isAuthError: typeof isUnavailableError;
 //#endregion
 //#region src/presets/app-prefs-client.d.ts
 /**
@@ -547,7 +562,7 @@ interface AppPrefsLoadResult {
   row: AsPresetEntryRow | null;
   /** Convenience accessor for `row.data` (the typed prefs payload), or `null`. */
   prefs: AppConfData | null;
-  /** True when the controller responded 401/403. */
+  /** True when the controller responded 401/403/404 (not mounted). */
   denied: boolean;
 }
 /**
@@ -734,6 +749,21 @@ declare function resolveAspectGate(value: boolean | string[] | undefined): Aspec
  * Returns `""` (no leading `?`) for the default view.
  */
 declare function stateToUrlQueryString(state: UrlQueryStateLike, defaults: UrlQueryDefaults): string;
+/**
+ * Whether {@link urlQueryStringToState} would consume the query key `key` —
+ * i.e. whether the key belongs to the table rather than to the page hosting
+ * it. This is the ownership rule the `useTableUrlQuery` router bridge reads
+ * and writes by, so both directions agree: a key the parser ignores is never
+ * removed, and a key it reads is the table's to remove.
+ *
+ * Shape-only, and deliberately conservative for bare `field=value` keys: a
+ * filter on a column and a host flag are indistinguishable without the table
+ * definition, so those are owned only once the bridge has written them
+ * itself (or once a `prefix` namespaces them).
+ *
+ * @since 0.1.133
+ */
+declare function urlQueryConsumesKey(key: string): boolean;
 interface UrlQueryParseOptions {
   /**
    * Field paths the table knows about. Conditions on fields outside this set
@@ -1076,4 +1106,4 @@ type ColumnReorderPosition = "before" | "after";
  */
 declare function reorderColumnNames(names: string[], fromPath: string, toPath: string, position: ColumnReorderPosition): string[];
 //#endregion
-export { APP_CONF_PREFIX, type AppConfData, AppPrefsClient, type AppPrefsClientConfig, type AppPrefsLoadResult, type AsPresetEntryData, type AsPresetEntryRow, type AsPresetsErrorCode, type AspectGate, type AspectMask, type BuildTableQueryOptions, type ColumnFilterType, type ColumnReorderPosition, type ColumnWidthEntry, type ColumnWidthsMap, type ConfigTab, DEFAULT_ROW_HEIGHT_PX, DRAFT_PERSISTED_ASPECTS, type DateShortcut, type DraftPersistedAspect, type FetchPlan, type FetchPlanMode, type FieldFilters, type FilterCondition, type FilterConditionType, MAX_DEFAULT_COLUMN_WIDTH_PX, type MergeResult, NULL_OPS, PRESET_ASPECTS, type PageAlignedBlock, type PlanFetchArgs, type PresetAspect, type PresetCapabilities, type PresetColumnWidthEntry, type PresetData, type PresetDraft, type PresetFilterOpEntry, type PresetLimitReachedBody, type PresetSnapshot, type PresetSnapshotWire, type PresetSorterEntry, PresetsClient, type PresetsClientConfig, PresetsHttpError, type PresetsListResult, type PresetsSaveAsOptions, type PresetsSaveResult, type QueryOptions, RESERVED_ID_PREFIXES, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, type SelectionMode, type SystemPreset, type SystemPresetInput, type TableStateData, type TableStateMethods, USER_CONF_PREFIX, type UrlQueryDefaults, type UrlQueryParseOptions, type UrlQueryStateLike, type UrlQueryStateSnapshot, type UrlQuerySync, type UserConfData, appConfId, arraysEqual, blockStartFor, buildTableQuery, clampTopIndex, columnFilterType, computeDefaultColumnWidth, conditionLabel, conditionsForType, dateShortcuts, debounce, defaultCondition, derivePresetAspects, deserializeDraft, draftMatchesPreset, escapeRegex, filledFilterCount, filterTokenLabel, filtersToUniqueryFilter, formatFilterCondition, fromWireSnapshot, hasSecondValue, isAuthError, isDirtyAgainst, isEmptyDraft, isFilled, isSimpleEq, isSystemPresetId, mergeFilters, mergeSorters, normaliseSystemPresetId, pageAlignedBlocksFor, parseFilterInput, planFetch, reconcileColumnWidthDefaults, reorderColumnNames, resolveAspectGate, resolveSystemPresets, rowsToPks, sameColumnSet, serializeDraft, setsEqual, sortersEqual, stableStringify, stateToUrlQueryString, toWireSnapshot, togglePk, trimSelection, unescapeRegex, uniqueryFilterToFieldFilters, urlQueryStringToState, userConfId, walkBackwardAbsorb, walkForwardAbsorb };
+export { APP_CONF_PREFIX, type AppConfData, AppPrefsClient, type AppPrefsClientConfig, type AppPrefsLoadResult, type AsPresetEntryData, type AsPresetEntryRow, type AsPresetsErrorCode, type AspectGate, type AspectMask, type BuildTableQueryOptions, type ColumnFilterType, type ColumnReorderPosition, type ColumnWidthEntry, type ColumnWidthsMap, type ConfigTab, DEFAULT_ROW_HEIGHT_PX, DRAFT_PERSISTED_ASPECTS, type DateShortcut, type DraftPersistedAspect, type FetchPlan, type FetchPlanMode, type FieldFilters, type FilterCondition, type FilterConditionType, MAX_DEFAULT_COLUMN_WIDTH_PX, type MergeResult, NULL_OPS, PRESET_ASPECTS, type PageAlignedBlock, type PlanFetchArgs, type PresetAspect, type PresetCapabilities, type PresetColumnWidthEntry, type PresetData, type PresetDraft, type PresetFilterOpEntry, type PresetLimitReachedBody, type PresetSnapshot, type PresetSnapshotWire, type PresetSorterEntry, PresetsClient, type PresetsClientConfig, PresetsHttpError, type PresetsListResult, type PresetsSaveAsOptions, type PresetsSaveResult, type QueryOptions, RESERVED_ID_PREFIXES, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, type SelectionMode, type SystemPreset, type SystemPresetInput, type TableStateData, type TableStateMethods, USER_CONF_PREFIX, type UrlQueryDefaults, type UrlQueryParseOptions, type UrlQueryStateLike, type UrlQueryStateSnapshot, type UrlQuerySync, type UserConfData, appConfId, arraysEqual, blockStartFor, buildTableQuery, clampTopIndex, columnFilterType, computeDefaultColumnWidth, conditionLabel, conditionsForType, dateShortcuts, debounce, defaultCondition, derivePresetAspects, deserializeDraft, draftMatchesPreset, escapeRegex, filledFilterCount, filterTokenLabel, filtersToUniqueryFilter, formatFilterCondition, fromWireSnapshot, hasSecondValue, isAuthError, isDirtyAgainst, isEmptyDraft, isFilled, isSimpleEq, isSystemPresetId, isUnavailableError, mergeFilters, mergeSorters, normaliseSystemPresetId, pageAlignedBlocksFor, parseFilterInput, planFetch, reconcileColumnWidthDefaults, reorderColumnNames, resolveAspectGate, resolveSystemPresets, rowsToPks, sameColumnSet, serializeDraft, setsEqual, sortersEqual, stableStringify, stateToUrlQueryString, toWireSnapshot, togglePk, trimSelection, unescapeRegex, uniqueryFilterToFieldFilters, urlQueryConsumesKey, urlQueryStringToState, userConfId, walkBackwardAbsorb, walkForwardAbsorb };

package/dist/index.mjs

@@ -148,13 +148,22 @@ function unescapeRegex(input) {
 //#region src/filters/filter-input-format.ts
 /**
 * Coerce a raw string value to the appropriate JS type for the column.
-* Number columns get numeric values; everything else stays as string.
+* Number columns get numeric values, boolean columns understand the
+* `true` / `false` vocabulary (case-insensitive) so the condition carries a
+* real boolean and round-trips through the URL as one. Anything else stays
+* a string. Since 0.1.133 for booleans.
 */
 function coerceValue(raw, columnType) {
 	if (columnType === "number") {
 		const n = Number(raw);
 		return Number.isNaN(n) ? raw : n;
 	}
+	if (columnType === "boolean") {
+		const lower = raw.toLowerCase();
+		if (lower === "true") return true;
+		if (lower === "false") return false;
+		return raw;
+	}
 	return raw;
 }
 /** Default condition type when no symbol matches the input. */
@@ -579,6 +588,10 @@ function derivePresetAspects(content) {
 * Convert in-memory dict-form snapshot to the wire form persisted on the
 * server. Entries-arrays are sorted by `field` so consumers (server-side
 * aspect derivation, dirty detection, equality checks) see a stable order.
+*
+* Empty aspects round-trip as empty (since 0.1.133): a saved view with no
+* filters owns `filterOps` and clears them on apply, which is not the same
+* thing as a view that never claimed the aspect.
 */
 function toWireSnapshot(snapshot) {
 	const wire = {};
@@ -591,7 +604,7 @@ function toWireSnapshot(snapshot) {
 				field,
 				width: columnWidths[field]
 			});
-			if (entries.length > 0) columns.columnWidths = entries;
+			columns.columnWidths = entries;
 		}
 		wire.columns = columns;
 	}
@@ -602,7 +615,7 @@ function toWireSnapshot(snapshot) {
 			field,
 			conditions: snapshot.filterOps[field]
 		});
-		if (entries.length > 0) wire.filterOps = entries;
+		wire.filterOps = entries;
 	}
 	if (snapshot.sorters) wire.sorters = snapshot.sorters;
 	if (snapshot.itemsPerPage !== void 0) wire.itemsPerPage = snapshot.itemsPerPage;
@@ -613,7 +626,7 @@ function fromWireSnapshot(wire) {
 	if (wire.columns) {
 		const { columnNames, columnWidths } = wire.columns;
 		const columns = { columnNames };
-		if (columnWidths && columnWidths.length > 0) {
+		if (columnWidths) {
 			const dict = {};
 			for (const entry of columnWidths) dict[entry.field] = entry.width;
 			columns.columnWidths = dict;
@@ -621,7 +634,7 @@ function fromWireSnapshot(wire) {
 		snapshot.columns = columns;
 	}
 	if (wire.filters) snapshot.filters = wire.filters;
-	if (wire.filterOps && wire.filterOps.length > 0) {
+	if (wire.filterOps) {
 		const dict = {};
 		for (const entry of wire.filterOps) dict[entry.field] = entry.conditions;
 		snapshot.filterOps = dict;
@@ -818,7 +831,7 @@ function draftMatchesPreset(draft, presetSnapshot, availableAspects) {
 /**
 * Framework-agnostic wrapper over `@atscript/db-client`'s `Client` for the
 * `AsPresetEntry` table. Handles wire serialisation, list-splitting by
-* `type`, capabilities side-channel, and 401/403 → `denied` semantics.
+* `type`, capabilities side-channel, and 401/403/404 → `denied` semantics.
 *
 * Stateless: every method is a fresh request. The Vue composable layer
 * holds reactive state; this class only translates intent → HTTP.
@@ -844,8 +857,8 @@ var PresetsClient = class {
 	* `(app, tableKey)`. By default also fetches `capabilities` in parallel —
 	* pass `{ capabilities: false }` for refresh-after-mutation calls (fav
 	* toggle, default change, save/save-as, public toggle, rename, delete)
-	* where role-derived capabilities can't have changed. Auth errors
-	* (401/403) collapse to `denied: true` with empty data so the UI hides
+	* where role-derived capabilities can't have changed. Unavailable
+	* responses (401/403/404) collapse to `denied: true` with empty data so the UI hides
 	* itself silently.
 	*/
 	async list(opts = {}) {
@@ -857,7 +870,7 @@ var PresetsClient = class {
 		};
 		try {
 			const [rows, capabilities] = await Promise.all([this.client.query({ filter }), fetchCapabilities ? this.loadCapabilities().catch((err) => {
-				if (isAuthError(err)) throw err;
+				if (isUnavailableError(err)) throw err;
 				return null;
 			}) : Promise.resolve(void 0)]);
 			const presets = [];
@@ -871,7 +884,7 @@ var PresetsClient = class {
 				denied: false
 			};
 		} catch (err) {
-			if (isAuthError(err)) return {
+			if (isUnavailableError(err)) return {
 				presets: [],
 				userConf: null,
 				capabilities: null,
@@ -987,12 +1000,22 @@ var PresetsHttpError = class extends Error {
 		this.name = "PresetsHttpError";
 	}
 };
-/** True for HTTP 401/403 across both `ClientError` and `PresetsHttpError`. */
-function isAuthError(err) {
-	if (err instanceof ClientError && (err.status === 401 || err.status === 403)) return true;
-	if (err instanceof PresetsHttpError && (err.status === 401 || err.status === 403)) return true;
-	return false;
+/**
+* True when the presets/app-prefs surface is simply not available to this
+* client: HTTP 401/403 (not signed in / not permitted) or 404 (the
+* controller is not mounted on this server). All three collapse to
+* `denied: true` — the UI hides itself silently instead of surfacing an
+* error. Covers both `ClientError` and `PresetsHttpError`.
+*/
+function isUnavailableError(err) {
+	const status = err instanceof ClientError || err instanceof PresetsHttpError ? err.status : void 0;
+	return status === 401 || status === 403 || status === 404;
 }
+/**
+* @deprecated Renamed to `isUnavailableError` in 0.1.133 — it also covers
+* 404 (feature not mounted), not just auth failures.
+*/
+const isAuthError = isUnavailableError;
 //#endregion
 //#region src/presets/app-prefs-client.ts
 /**
@@ -1025,7 +1048,7 @@ var AppPrefsClient = class {
 				denied: false
 			};
 		} catch (err) {
-			if (isAuthError(err)) return {
+			if (isUnavailableError(err)) return {
 				row: null,
 				prefs: null,
 				denied: true
@@ -1231,6 +1254,36 @@ function stateToUrlQueryString(state, defaults) {
 	return buildUrl(query);
 }
 /**
+* The `$`-controls {@link urlQueryStringToState} actually reads. Any other
+* `$key` is ignored by the parser, so it is NOT the table's to remove.
+*/
+const CONSUMED_CONTROLS = new Set([
+	"$sort",
+	"$search",
+	"$relevance",
+	"$skip"
+]);
+/** Characters that can only appear in a uniqu filter key, never in a page flag. */
+const FILTER_OPERATOR_CHAR = /[<>!~]/;
+/**
+* Whether {@link urlQueryStringToState} would consume the query key `key` —
+* i.e. whether the key belongs to the table rather than to the page hosting
+* it. This is the ownership rule the `useTableUrlQuery` router bridge reads
+* and writes by, so both directions agree: a key the parser ignores is never
+* removed, and a key it reads is the table's to remove.
+*
+* Shape-only, and deliberately conservative for bare `field=value` keys: a
+* filter on a column and a host flag are indistinguishable without the table
+* definition, so those are owned only once the bridge has written them
+* itself (or once a `prefix` namespaces them).
+*
+* @since 0.1.133
+*/
+function urlQueryConsumesKey(key) {
+	if (key.startsWith("$")) return CONSUMED_CONTROLS.has(key);
+	return FILTER_OPERATOR_CHAR.test(key);
+}
+/**
 * Parse a URL query string back into the table state subset.
 *
 * Robust by design — schema drift and copy-paste errors must not break the
@@ -1627,4 +1680,4 @@ function reorderColumnNames(names, fromPath, toPath, position) {
 	return without.slice(0, insertAt).concat(fromPath, without.slice(insertAt));
 }
 //#endregion
-export { APP_CONF_PREFIX, AppPrefsClient, DEFAULT_ROW_HEIGHT_PX, DRAFT_PERSISTED_ASPECTS, MAX_DEFAULT_COLUMN_WIDTH_PX, NULL_OPS, PRESET_ASPECTS, PresetsClient, PresetsHttpError, RESERVED_ID_PREFIXES, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, USER_CONF_PREFIX, appConfId, arraysEqual, blockStartFor, buildTableQuery, clampTopIndex, columnFilterType, computeDefaultColumnWidth, conditionLabel, conditionsForType, dateShortcuts, debounce, defaultCondition, derivePresetAspects, deserializeDraft, draftMatchesPreset, escapeRegex, filledFilterCount, filterTokenLabel, filtersToUniqueryFilter, formatFilterCondition, fromWireSnapshot, hasSecondValue, isAuthError, isDirtyAgainst, isEmptyDraft, isFilled, isSimpleEq, isSystemPresetId, mergeFilters, mergeSorters, normaliseSystemPresetId, pageAlignedBlocksFor, parseFilterInput, planFetch, reconcileColumnWidthDefaults, reorderColumnNames, resolveAspectGate, resolveSystemPresets, rowsToPks, sameColumnSet, serializeDraft, setsEqual, sortersEqual, stableStringify, stateToUrlQueryString, toWireSnapshot, togglePk, trimSelection, unescapeRegex, uniqueryFilterToFieldFilters, urlQueryStringToState, userConfId, walkBackwardAbsorb, walkForwardAbsorb };
+export { APP_CONF_PREFIX, AppPrefsClient, DEFAULT_ROW_HEIGHT_PX, DRAFT_PERSISTED_ASPECTS, MAX_DEFAULT_COLUMN_WIDTH_PX, NULL_OPS, PRESET_ASPECTS, PresetsClient, PresetsHttpError, RESERVED_ID_PREFIXES, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, USER_CONF_PREFIX, appConfId, arraysEqual, blockStartFor, buildTableQuery, clampTopIndex, columnFilterType, computeDefaultColumnWidth, conditionLabel, conditionsForType, dateShortcuts, debounce, defaultCondition, derivePresetAspects, deserializeDraft, draftMatchesPreset, escapeRegex, filledFilterCount, filterTokenLabel, filtersToUniqueryFilter, formatFilterCondition, fromWireSnapshot, hasSecondValue, isAuthError, isDirtyAgainst, isEmptyDraft, isFilled, isSimpleEq, isSystemPresetId, isUnavailableError, mergeFilters, mergeSorters, normaliseSystemPresetId, pageAlignedBlocksFor, parseFilterInput, planFetch, reconcileColumnWidthDefaults, reorderColumnNames, resolveAspectGate, resolveSystemPresets, rowsToPks, sameColumnSet, serializeDraft, setsEqual, sortersEqual, stableStringify, stateToUrlQueryString, toWireSnapshot, togglePk, trimSelection, unescapeRegex, uniqueryFilterToFieldFilters, urlQueryConsumesKey, urlQueryStringToState, userConfId, walkBackwardAbsorb, walkForwardAbsorb };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/ui-table",
-  "version": "0.1.132",
+  "version": "0.1.133",
   "description": "Framework-agnostic filter model, filter-to-Uniquery conversion, and preset serialization for atscript tables",
   "keywords": [
     "atscript",
@@ -42,18 +42,18 @@
     "access": "public"
   },
   "dependencies": {
-    "@atscript/ui": "0.1.132"
+    "@atscript/ui": "0.1.133"
   },
   "devDependencies": {
-    "@atscript/db-client": "^0.1.127",
-    "@uniqu/core": "^0.1.7",
-    "@uniqu/url": "^0.1.7",
+    "@atscript/db-client": "^0.1.129",
+    "@uniqu/core": "^0.1.8",
+    "@uniqu/url": "^0.1.8",
     "vitest": "npm:@voidzero-dev/vite-plus-test@0.1.14"
   },
   "peerDependencies": {
-    "@atscript/db-client": "^0.1.127",
-    "@uniqu/core": "^0.1.7",
-    "@uniqu/url": "^0.1.7"
+    "@atscript/db-client": "^0.1.129",
+    "@uniqu/core": "^0.1.8",
+    "@uniqu/url": "^0.1.8"
   },
   "scripts": {
     "build": "vp pack",