@atscript/ui-table 0.1.141 → 0.1.142

package/dist/index.cjs

@@ -46,6 +46,19 @@ function filledFilterCount(filters) {
 	for (const path in filters) if (filters[path].some(isFilled)) count++;
 	return count;
 }
+/**
+* `filters` without the fields that have no filled condition — the shape
+* table state holds (a field with nothing filled has no entry). Returns
+* `filters` itself when every field has one; never mutates it.
+*
+* @since 0.1.142
+*/
+function compactFieldFilters(filters) {
+	if (filledFilterCount(filters) === Object.keys(filters).length) return filters;
+	const out = {};
+	for (const path in filters) if (filters[path].some(isFilled)) out[path] = filters[path];
+	return out;
+}
 /** Summarize a field's conditions into a human-readable token label. */
 function filterTokenLabel(path, conditions, columnLabel) {
 	const filled = conditions.filter(isFilled);
@@ -1228,6 +1241,45 @@ function prunePresetSnapshot(snapshot, known) {
 	};
 }
 /**
+* Spell a snapshot the way table state holds it, so it compares equal to a
+* capture of the state it produces:
+*
+* - `columns.columnWidths` — an entry equal to its column's default width, or
+*   on a path with no default (not a column), goes; an emptied map is
+*   omitted. Capture writes overrides only.
+* - `filterOps` — a field with no filled condition goes
+*   (`compactFieldFilters`). Table state never holds one.
+*
+* `defaultWidths` maps each column path to its default width — the `d` of
+* its `ColumnWidthsMap` entry. Other aspects pass through. Returns `snapshot`
+* itself when nothing changes; the input is never mutated.
+*
+* @since 0.1.142
+*/
+function canonicalPresetSnapshot(snapshot, defaultWidths) {
+	let out = snapshot;
+	const columns = snapshot.columns;
+	if (columns?.columnWidths) {
+		const entries = Object.entries(columns.columnWidths);
+		const [kept] = partition(entries, ([p, w]) => {
+			const d = defaultWidths[p];
+			return d !== void 0 && d !== w;
+		});
+		if (kept.length !== entries.length || kept.length === 0) out = {
+			...out,
+			columns: columnsAspect(columns.columnNames, Object.fromEntries(kept))
+		};
+	}
+	if (snapshot.filterOps) {
+		const filterOps = compactFieldFilters(snapshot.filterOps);
+		if (filterOps !== snapshot.filterOps) out = {
+			...out,
+			filterOps
+		};
+	}
+	return out;
+}
+/**
 * Split residual filter conditions, in one pass, into the ones that name
 * only `known` fields and the ones that do not. A condition naming any
 * unknown field is dropped WHOLE — never pruned inside an `$or` (that would
@@ -2595,12 +2647,14 @@ exports.appConfId = appConfId;
 exports.arraysEqual = arraysEqual;
 exports.blockStartFor = blockStartFor;
 exports.buildTableQuery = buildTableQuery;
+exports.canonicalPresetSnapshot = canonicalPresetSnapshot;
 exports.cellAsString = cellAsString;
 exports.clampTopIndex = clampTopIndex;
 exports.collectExportRows = collectExportRows;
 exports.columnDefaultCondition = columnDefaultCondition;
 exports.columnFilterConditions = columnFilterConditions;
 exports.columnFilterType = columnFilterType;
+exports.compactFieldFilters = compactFieldFilters;
 exports.computeDefaultColumnWidth = computeDefaultColumnWidth;
 exports.conditionLabel = conditionLabel;
 exports.conditionsForType = conditionsForType;

package/dist/index.d.cts

@@ -31,6 +31,14 @@ declare function isSimpleEq(condition: FilterCondition): boolean;
 declare function conditionLabel(type: FilterConditionType): string;
 /** Count of fields that have at least one filled condition. */
 declare function filledFilterCount(filters: FieldFilters): number;
+/**
+ * `filters` without the fields that have no filled condition — the shape
+ * table state holds (a field with nothing filled has no entry). Returns
+ * `filters` itself when every field has one; never mutates it.
+ *
+ * @since 0.1.142
+ */
+declare function compactFieldFilters(filters: FieldFilters): FieldFilters;
 /** Summarize a field's conditions into a human-readable token label. */
 declare function filterTokenLabel(path: string, conditions: FilterCondition[], columnLabel?: string): string;
 //#endregion
@@ -615,6 +623,23 @@ declare function prunePresetSnapshot(snapshot: PresetSnapshot, known: KnownField
   snapshot: PresetSnapshot;
   dropped: DroppedFields | null;
 };
+/**
+ * Spell a snapshot the way table state holds it, so it compares equal to a
+ * capture of the state it produces:
+ *
+ * - `columns.columnWidths` — an entry equal to its column's default width, or
+ *   on a path with no default (not a column), goes; an emptied map is
+ *   omitted. Capture writes overrides only.
+ * - `filterOps` — a field with no filled condition goes
+ *   (`compactFieldFilters`). Table state never holds one.
+ *
+ * `defaultWidths` maps each column path to its default width — the `d` of
+ * its `ColumnWidthsMap` entry. Other aspects pass through. Returns `snapshot`
+ * itself when nothing changes; the input is never mutated.
+ *
+ * @since 0.1.142
+ */
+declare function canonicalPresetSnapshot(snapshot: PresetSnapshot, defaultWidths: Readonly<Record<string, string>>): PresetSnapshot;
 /**
  * Split residual filter conditions, in one pass, into the ones that name
  * only `known` fields and the ones that do not. A condition naming any
@@ -1697,4 +1722,4 @@ declare function sortRowsLocally<T extends Record<string, unknown>>(rows: T[], s
 //#region src/utils/dev.d.ts
 declare const DEV: boolean;
 //#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, type CsvOptions, DEFAULT_EXPORT_PAGE_SIZE, DEFAULT_ROW_HEIGHT_PX, DEV, DRAFT_PERSISTED_ASPECTS, type DateShortcut, type DecomposeUniqueryFilterOptions, type DecomposedUniqueryFilter, type DisplayColumnDef, type DraftPersistedAspect, type DroppedFields, ExportAbortError, type ExportPage, type ExportPageFetcher, type ExportScalar, type FetchPlan, type FetchPlanMode, type FieldFilters, type FilterCondition, type FilterConditionType, type FilterableColumn, type KnownFields, 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, URL_SNAPSHOT_KEY, USER_CONF_PREFIX, type UnknownFilter, type UnsupportedFilter, type UnsupportedFilterReason, type UrlQueryDefaults, type UrlQueryParseOptions, type UrlQueryStateLike, type UrlQueryStateSnapshot, type UrlQuerySync, type UserConfData, appConfId, arraysEqual, blockStartFor, buildTableQuery, cellAsString, clampTopIndex, collectExportRows, columnDefaultCondition, columnFilterConditions, columnFilterType, computeDefaultColumnWidth, conditionLabel, conditionsForType, csvCell, dateShortcuts, debounce, decomposeUniqueryFilter, defaultCondition, derivePresetAspects, deserializeDraft, draftMatchesPreset, escapeRegex, filledFilterCount, filterExprFields, filterExprKey, filterTokenLabel, filtersToUniqueryFilter, formatFilterCondition, formatFilterExpr, fromWireSnapshot, gateOwns, hasSecondValue, isAuthError, isColumnFilterable, isDirtyAgainst, isEmptyDraft, isFilled, isSimpleEq, isSystemPresetId, isUnavailableError, mergeDisplayColumns, mergeFilters, mergeSorters, normaliseSystemPresetId, normalizeResidualFilters, pageAlignedBlocksFor, parseColumnFilterInput, parseFilterInput, planFetch, prunePresetSnapshot, pruneResidualFilters, reconcileColumnWidthDefaults, reorderColumnNames, residualGateOwns, resolveAspectGate, resolveExportValue, resolveSystemPresets, restoreDroppedEntries, rowsToPks, sameColumnSet, serializeDraft, setsEqual, sortRowsLocally, sortersEqual, stableStringify, stateToUrlQueryString, toCsv, toWireSnapshot, togglePk, trimSelection, unescapeRegex, uniqueryFilterToFieldFilters, urlQueryConsumesKey, urlQueryStringToState, userConfId, walkBackwardAbsorb, walkForwardAbsorb, withStableOrder };
+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, type CsvOptions, DEFAULT_EXPORT_PAGE_SIZE, DEFAULT_ROW_HEIGHT_PX, DEV, DRAFT_PERSISTED_ASPECTS, type DateShortcut, type DecomposeUniqueryFilterOptions, type DecomposedUniqueryFilter, type DisplayColumnDef, type DraftPersistedAspect, type DroppedFields, ExportAbortError, type ExportPage, type ExportPageFetcher, type ExportScalar, type FetchPlan, type FetchPlanMode, type FieldFilters, type FilterCondition, type FilterConditionType, type FilterableColumn, type KnownFields, 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, URL_SNAPSHOT_KEY, USER_CONF_PREFIX, type UnknownFilter, type UnsupportedFilter, type UnsupportedFilterReason, type UrlQueryDefaults, type UrlQueryParseOptions, type UrlQueryStateLike, type UrlQueryStateSnapshot, type UrlQuerySync, type UserConfData, appConfId, arraysEqual, blockStartFor, buildTableQuery, canonicalPresetSnapshot, cellAsString, clampTopIndex, collectExportRows, columnDefaultCondition, columnFilterConditions, columnFilterType, compactFieldFilters, computeDefaultColumnWidth, conditionLabel, conditionsForType, csvCell, dateShortcuts, debounce, decomposeUniqueryFilter, defaultCondition, derivePresetAspects, deserializeDraft, draftMatchesPreset, escapeRegex, filledFilterCount, filterExprFields, filterExprKey, filterTokenLabel, filtersToUniqueryFilter, formatFilterCondition, formatFilterExpr, fromWireSnapshot, gateOwns, hasSecondValue, isAuthError, isColumnFilterable, isDirtyAgainst, isEmptyDraft, isFilled, isSimpleEq, isSystemPresetId, isUnavailableError, mergeDisplayColumns, mergeFilters, mergeSorters, normaliseSystemPresetId, normalizeResidualFilters, pageAlignedBlocksFor, parseColumnFilterInput, parseFilterInput, planFetch, prunePresetSnapshot, pruneResidualFilters, reconcileColumnWidthDefaults, reorderColumnNames, residualGateOwns, resolveAspectGate, resolveExportValue, resolveSystemPresets, restoreDroppedEntries, rowsToPks, sameColumnSet, serializeDraft, setsEqual, sortRowsLocally, sortersEqual, stableStringify, stateToUrlQueryString, toCsv, toWireSnapshot, togglePk, trimSelection, unescapeRegex, uniqueryFilterToFieldFilters, urlQueryConsumesKey, urlQueryStringToState, userConfId, walkBackwardAbsorb, walkForwardAbsorb, withStableOrder };

package/dist/index.d.mts

@@ -31,6 +31,14 @@ declare function isSimpleEq(condition: FilterCondition): boolean;
 declare function conditionLabel(type: FilterConditionType): string;
 /** Count of fields that have at least one filled condition. */
 declare function filledFilterCount(filters: FieldFilters): number;
+/**
+ * `filters` without the fields that have no filled condition — the shape
+ * table state holds (a field with nothing filled has no entry). Returns
+ * `filters` itself when every field has one; never mutates it.
+ *
+ * @since 0.1.142
+ */
+declare function compactFieldFilters(filters: FieldFilters): FieldFilters;
 /** Summarize a field's conditions into a human-readable token label. */
 declare function filterTokenLabel(path: string, conditions: FilterCondition[], columnLabel?: string): string;
 //#endregion
@@ -615,6 +623,23 @@ declare function prunePresetSnapshot(snapshot: PresetSnapshot, known: KnownField
   snapshot: PresetSnapshot;
   dropped: DroppedFields | null;
 };
+/**
+ * Spell a snapshot the way table state holds it, so it compares equal to a
+ * capture of the state it produces:
+ *
+ * - `columns.columnWidths` — an entry equal to its column's default width, or
+ *   on a path with no default (not a column), goes; an emptied map is
+ *   omitted. Capture writes overrides only.
+ * - `filterOps` — a field with no filled condition goes
+ *   (`compactFieldFilters`). Table state never holds one.
+ *
+ * `defaultWidths` maps each column path to its default width — the `d` of
+ * its `ColumnWidthsMap` entry. Other aspects pass through. Returns `snapshot`
+ * itself when nothing changes; the input is never mutated.
+ *
+ * @since 0.1.142
+ */
+declare function canonicalPresetSnapshot(snapshot: PresetSnapshot, defaultWidths: Readonly<Record<string, string>>): PresetSnapshot;
 /**
  * Split residual filter conditions, in one pass, into the ones that name
  * only `known` fields and the ones that do not. A condition naming any
@@ -1697,4 +1722,4 @@ declare function sortRowsLocally<T extends Record<string, unknown>>(rows: T[], s
 //#region src/utils/dev.d.ts
 declare const DEV: boolean;
 //#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, type CsvOptions, DEFAULT_EXPORT_PAGE_SIZE, DEFAULT_ROW_HEIGHT_PX, DEV, DRAFT_PERSISTED_ASPECTS, type DateShortcut, type DecomposeUniqueryFilterOptions, type DecomposedUniqueryFilter, type DisplayColumnDef, type DraftPersistedAspect, type DroppedFields, ExportAbortError, type ExportPage, type ExportPageFetcher, type ExportScalar, type FetchPlan, type FetchPlanMode, type FieldFilters, type FilterCondition, type FilterConditionType, type FilterableColumn, type KnownFields, 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, URL_SNAPSHOT_KEY, USER_CONF_PREFIX, type UnknownFilter, type UnsupportedFilter, type UnsupportedFilterReason, type UrlQueryDefaults, type UrlQueryParseOptions, type UrlQueryStateLike, type UrlQueryStateSnapshot, type UrlQuerySync, type UserConfData, appConfId, arraysEqual, blockStartFor, buildTableQuery, cellAsString, clampTopIndex, collectExportRows, columnDefaultCondition, columnFilterConditions, columnFilterType, computeDefaultColumnWidth, conditionLabel, conditionsForType, csvCell, dateShortcuts, debounce, decomposeUniqueryFilter, defaultCondition, derivePresetAspects, deserializeDraft, draftMatchesPreset, escapeRegex, filledFilterCount, filterExprFields, filterExprKey, filterTokenLabel, filtersToUniqueryFilter, formatFilterCondition, formatFilterExpr, fromWireSnapshot, gateOwns, hasSecondValue, isAuthError, isColumnFilterable, isDirtyAgainst, isEmptyDraft, isFilled, isSimpleEq, isSystemPresetId, isUnavailableError, mergeDisplayColumns, mergeFilters, mergeSorters, normaliseSystemPresetId, normalizeResidualFilters, pageAlignedBlocksFor, parseColumnFilterInput, parseFilterInput, planFetch, prunePresetSnapshot, pruneResidualFilters, reconcileColumnWidthDefaults, reorderColumnNames, residualGateOwns, resolveAspectGate, resolveExportValue, resolveSystemPresets, restoreDroppedEntries, rowsToPks, sameColumnSet, serializeDraft, setsEqual, sortRowsLocally, sortersEqual, stableStringify, stateToUrlQueryString, toCsv, toWireSnapshot, togglePk, trimSelection, unescapeRegex, uniqueryFilterToFieldFilters, urlQueryConsumesKey, urlQueryStringToState, userConfId, walkBackwardAbsorb, walkForwardAbsorb, withStableOrder };
+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, type CsvOptions, DEFAULT_EXPORT_PAGE_SIZE, DEFAULT_ROW_HEIGHT_PX, DEV, DRAFT_PERSISTED_ASPECTS, type DateShortcut, type DecomposeUniqueryFilterOptions, type DecomposedUniqueryFilter, type DisplayColumnDef, type DraftPersistedAspect, type DroppedFields, ExportAbortError, type ExportPage, type ExportPageFetcher, type ExportScalar, type FetchPlan, type FetchPlanMode, type FieldFilters, type FilterCondition, type FilterConditionType, type FilterableColumn, type KnownFields, 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, URL_SNAPSHOT_KEY, USER_CONF_PREFIX, type UnknownFilter, type UnsupportedFilter, type UnsupportedFilterReason, type UrlQueryDefaults, type UrlQueryParseOptions, type UrlQueryStateLike, type UrlQueryStateSnapshot, type UrlQuerySync, type UserConfData, appConfId, arraysEqual, blockStartFor, buildTableQuery, canonicalPresetSnapshot, cellAsString, clampTopIndex, collectExportRows, columnDefaultCondition, columnFilterConditions, columnFilterType, compactFieldFilters, computeDefaultColumnWidth, conditionLabel, conditionsForType, csvCell, dateShortcuts, debounce, decomposeUniqueryFilter, defaultCondition, derivePresetAspects, deserializeDraft, draftMatchesPreset, escapeRegex, filledFilterCount, filterExprFields, filterExprKey, filterTokenLabel, filtersToUniqueryFilter, formatFilterCondition, formatFilterExpr, fromWireSnapshot, gateOwns, hasSecondValue, isAuthError, isColumnFilterable, isDirtyAgainst, isEmptyDraft, isFilled, isSimpleEq, isSystemPresetId, isUnavailableError, mergeDisplayColumns, mergeFilters, mergeSorters, normaliseSystemPresetId, normalizeResidualFilters, pageAlignedBlocksFor, parseColumnFilterInput, parseFilterInput, planFetch, prunePresetSnapshot, pruneResidualFilters, reconcileColumnWidthDefaults, reorderColumnNames, residualGateOwns, resolveAspectGate, resolveExportValue, resolveSystemPresets, restoreDroppedEntries, rowsToPks, sameColumnSet, serializeDraft, setsEqual, sortRowsLocally, sortersEqual, stableStringify, stateToUrlQueryString, toCsv, toWireSnapshot, togglePk, trimSelection, unescapeRegex, uniqueryFilterToFieldFilters, urlQueryConsumesKey, urlQueryStringToState, userConfId, walkBackwardAbsorb, walkForwardAbsorb, withStableOrder };

package/dist/index.mjs

@@ -45,6 +45,19 @@ function filledFilterCount(filters) {
 	for (const path in filters) if (filters[path].some(isFilled)) count++;
 	return count;
 }
+/**
+* `filters` without the fields that have no filled condition — the shape
+* table state holds (a field with nothing filled has no entry). Returns
+* `filters` itself when every field has one; never mutates it.
+*
+* @since 0.1.142
+*/
+function compactFieldFilters(filters) {
+	if (filledFilterCount(filters) === Object.keys(filters).length) return filters;
+	const out = {};
+	for (const path in filters) if (filters[path].some(isFilled)) out[path] = filters[path];
+	return out;
+}
 /** Summarize a field's conditions into a human-readable token label. */
 function filterTokenLabel(path, conditions, columnLabel) {
 	const filled = conditions.filter(isFilled);
@@ -1227,6 +1240,45 @@ function prunePresetSnapshot(snapshot, known) {
 	};
 }
 /**
+* Spell a snapshot the way table state holds it, so it compares equal to a
+* capture of the state it produces:
+*
+* - `columns.columnWidths` — an entry equal to its column's default width, or
+*   on a path with no default (not a column), goes; an emptied map is
+*   omitted. Capture writes overrides only.
+* - `filterOps` — a field with no filled condition goes
+*   (`compactFieldFilters`). Table state never holds one.
+*
+* `defaultWidths` maps each column path to its default width — the `d` of
+* its `ColumnWidthsMap` entry. Other aspects pass through. Returns `snapshot`
+* itself when nothing changes; the input is never mutated.
+*
+* @since 0.1.142
+*/
+function canonicalPresetSnapshot(snapshot, defaultWidths) {
+	let out = snapshot;
+	const columns = snapshot.columns;
+	if (columns?.columnWidths) {
+		const entries = Object.entries(columns.columnWidths);
+		const [kept] = partition(entries, ([p, w]) => {
+			const d = defaultWidths[p];
+			return d !== void 0 && d !== w;
+		});
+		if (kept.length !== entries.length || kept.length === 0) out = {
+			...out,
+			columns: columnsAspect(columns.columnNames, Object.fromEntries(kept))
+		};
+	}
+	if (snapshot.filterOps) {
+		const filterOps = compactFieldFilters(snapshot.filterOps);
+		if (filterOps !== snapshot.filterOps) out = {
+			...out,
+			filterOps
+		};
+	}
+	return out;
+}
+/**
 * Split residual filter conditions, in one pass, into the ones that name
 * only `known` fields and the ones that do not. A condition naming any
 * unknown field is dropped WHOLE — never pruned inside an `$or` (that would
@@ -2573,4 +2625,4 @@ function sortRowsLocally(rows, sorters, getValue = (row, field) => row[field]) {
 	});
 }
 //#endregion
-export { APP_CONF_PREFIX, AppPrefsClient, DEFAULT_EXPORT_PAGE_SIZE, DEFAULT_ROW_HEIGHT_PX, DEV, DRAFT_PERSISTED_ASPECTS, ExportAbortError, MAX_DEFAULT_COLUMN_WIDTH_PX, NULL_OPS, PRESET_ASPECTS, PresetsClient, PresetsHttpError, RESERVED_ID_PREFIXES, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, URL_SNAPSHOT_KEY, USER_CONF_PREFIX, appConfId, arraysEqual, blockStartFor, buildTableQuery, cellAsString, clampTopIndex, collectExportRows, columnDefaultCondition, columnFilterConditions, columnFilterType, computeDefaultColumnWidth, conditionLabel, conditionsForType, csvCell, dateShortcuts, debounce, decomposeUniqueryFilter, defaultCondition, derivePresetAspects, deserializeDraft, draftMatchesPreset, escapeRegex, filledFilterCount, filterExprFields, filterExprKey, filterTokenLabel, filtersToUniqueryFilter, formatFilterCondition, formatFilterExpr, fromWireSnapshot, gateOwns, hasSecondValue, isAuthError, isColumnFilterable, isDirtyAgainst, isEmptyDraft, isFilled, isSimpleEq, isSystemPresetId, isUnavailableError, mergeDisplayColumns, mergeFilters, mergeSorters, normaliseSystemPresetId, normalizeResidualFilters, pageAlignedBlocksFor, parseColumnFilterInput, parseFilterInput, planFetch, prunePresetSnapshot, pruneResidualFilters, reconcileColumnWidthDefaults, reorderColumnNames, residualGateOwns, resolveAspectGate, resolveExportValue, resolveSystemPresets, restoreDroppedEntries, rowsToPks, sameColumnSet, serializeDraft, setsEqual, sortRowsLocally, sortersEqual, stableStringify, stateToUrlQueryString, toCsv, toWireSnapshot, togglePk, trimSelection, unescapeRegex, uniqueryFilterToFieldFilters, urlQueryConsumesKey, urlQueryStringToState, userConfId, walkBackwardAbsorb, walkForwardAbsorb, withStableOrder };
+export { APP_CONF_PREFIX, AppPrefsClient, DEFAULT_EXPORT_PAGE_SIZE, DEFAULT_ROW_HEIGHT_PX, DEV, DRAFT_PERSISTED_ASPECTS, ExportAbortError, MAX_DEFAULT_COLUMN_WIDTH_PX, NULL_OPS, PRESET_ASPECTS, PresetsClient, PresetsHttpError, RESERVED_ID_PREFIXES, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, URL_SNAPSHOT_KEY, USER_CONF_PREFIX, appConfId, arraysEqual, blockStartFor, buildTableQuery, canonicalPresetSnapshot, cellAsString, clampTopIndex, collectExportRows, columnDefaultCondition, columnFilterConditions, columnFilterType, compactFieldFilters, computeDefaultColumnWidth, conditionLabel, conditionsForType, csvCell, dateShortcuts, debounce, decomposeUniqueryFilter, defaultCondition, derivePresetAspects, deserializeDraft, draftMatchesPreset, escapeRegex, filledFilterCount, filterExprFields, filterExprKey, filterTokenLabel, filtersToUniqueryFilter, formatFilterCondition, formatFilterExpr, fromWireSnapshot, gateOwns, hasSecondValue, isAuthError, isColumnFilterable, isDirtyAgainst, isEmptyDraft, isFilled, isSimpleEq, isSystemPresetId, isUnavailableError, mergeDisplayColumns, mergeFilters, mergeSorters, normaliseSystemPresetId, normalizeResidualFilters, pageAlignedBlocksFor, parseColumnFilterInput, parseFilterInput, planFetch, prunePresetSnapshot, pruneResidualFilters, reconcileColumnWidthDefaults, reorderColumnNames, residualGateOwns, resolveAspectGate, resolveExportValue, resolveSystemPresets, restoreDroppedEntries, rowsToPks, sameColumnSet, serializeDraft, setsEqual, sortRowsLocally, sortersEqual, stableStringify, stateToUrlQueryString, toCsv, toWireSnapshot, togglePk, trimSelection, unescapeRegex, uniqueryFilterToFieldFilters, urlQueryConsumesKey, urlQueryStringToState, userConfId, walkBackwardAbsorb, walkForwardAbsorb, withStableOrder };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/ui-table",
-  "version": "0.1.141",
+  "version": "0.1.142",
   "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.141"
+    "@atscript/ui": "0.1.142"
   },
   "devDependencies": {
-    "@atscript/db-client": "^0.1.133",
-    "@uniqu/core": "^0.1.10",
-    "@uniqu/url": "^0.1.10",
+    "@atscript/db-client": "^0.1.136",
+    "@uniqu/core": "^0.1.11",
+    "@uniqu/url": "^0.1.11",
     "vitest": "npm:@voidzero-dev/vite-plus-test@0.1.14"
   },
   "peerDependencies": {
-    "@atscript/db-client": "^0.1.133",
-    "@uniqu/core": "^0.1.10",
-    "@uniqu/url": "^0.1.10"
+    "@atscript/db-client": "^0.1.136",
+    "@uniqu/core": "^0.1.11",
+    "@uniqu/url": "^0.1.11"
   },
   "scripts": {
     "build": "vp pack",