@atscript/ui-table 0.1.138 → 0.1.140

package/dist/index.d.mts

@@ -1,6 +1,6 @@
+import { FilterExpr, Uniquery } from "@uniqu/core";
 import { Client } from "@atscript/db-client";
 import { ColumnDef, PaginationControl, SortControl, TableDef } from "@atscript/ui";
-import { FilterExpr, Uniquery } from "@uniqu/core";
 
 //#region src/filters/filter-types.d.ts
 /** Filter condition type identifiers. */
@@ -44,6 +44,34 @@ type ColumnFilterType = "text" | "number" | "date" | "boolean" | "enum" | "ref";
 declare function conditionsForType(type: ColumnFilterType, nullable?: boolean): readonly FilterConditionType[];
 /** Map a ColumnDef display type string to a ColumnFilterType. */
 declare function columnFilterType(columnType: string): ColumnFilterType;
+/** The `ColumnDef` fields that decide which filter conditions a column offers. */
+type FilterableColumn = Pick<ColumnDef, "type" | "nullable" | "filterable" | "filterOps">;
+/**
+ * Filter conditions a column offers — the one answer every filter UI (column
+ * menu, filter dialog, filter bar, config dialog) reads.
+ *
+ * - Value-filterable (`filterable: true`) → {@link conditionsForType} for its
+ *   display type.
+ * - Existence-only (`filterable: false`, `filterOps` includes `$exists` — a
+ *   JSON-stored column) → `null` / `notNull`: whether a value is present,
+ *   never what it is.
+ * - Otherwise → `[]`: the column takes no filter.
+ *
+ * `null` / `notNull` are dropped for non-nullable columns, so an existence-only
+ * column that is never empty offers nothing.
+ *
+ * @since 0.1.139
+ */
+declare function columnFilterConditions(column: FilterableColumn): readonly FilterConditionType[];
+/**
+ * Whether a column takes any filter at all — value comparisons or the
+ * existence-only `null` / `notNull` pair. Use it (not
+ * `column.filterable`, which is value comparison only) to decide whether to
+ * show a column in a filter UI.
+ *
+ * @since 0.1.139
+ */
+declare function isColumnFilterable(column: FilterableColumn): boolean;
 //#endregion
 //#region src/filters/escape-regex.d.ts
 /** Escape special regex characters in user input for safe embedding in $regex. */
@@ -54,6 +82,14 @@ declare function unescapeRegex(input: string): string;
 //#region src/filters/filter-input-format.d.ts
 /** Default condition type when no symbol matches the input. */
 declare function defaultCondition(columnType: ColumnFilterType): FilterConditionType;
+/**
+ * The condition a column's filter input starts with: its type's
+ * {@link defaultCondition} when the column offers it, otherwise the first
+ * condition it does offer (`null` on an existence-only column).
+ *
+ * @since 0.1.139
+ */
+declare function columnDefaultCondition(column: FilterableColumn): FilterConditionType;
 /**
  * Parse a user-typed filter input string into a FilterCondition.
  *
@@ -77,9 +113,19 @@ declare function defaultCondition(columnType: ColumnFilterType): FilterCondition
  *   number/date/boolean → eq
  *
  * Returns undefined for empty/invalid input or if the parsed operator
- * is not available for the column type.
+ * is not available for the column type. To honour what a specific column
+ * offers (an existence-only column takes only `<empty>` / `!<empty>`), use
+ * {@link parseColumnFilterInput}.
  */
 declare function parseFilterInput(text: string, columnType: ColumnFilterType, nullable?: boolean): FilterCondition | undefined;
+/**
+ * {@link parseFilterInput} for a column: the type comes from the column and
+ * the accepted operators are {@link columnFilterConditions} — the ones the
+ * column's filter UI offers.
+ *
+ * @since 0.1.139
+ */
+declare function parseColumnFilterInput(text: string, column: FilterableColumn): FilterCondition | undefined;
 /**
  * Format a FilterCondition for chip/token display using operator symbols.
  *
@@ -101,17 +147,133 @@ declare function formatFilterCondition(condition: FilterCondition): string;
 declare function filtersToUniqueryFilter(fieldFilters: FieldFilters): FilterExpr | undefined;
 //#endregion
 //#region src/filters/uniquery-to-filters.d.ts
+/**
+ * Why part of a Uniquery filter has no `FieldFilters` equivalent.
+ *
+ * - `"cross-field"` — an `$or` / `$not` that spans several fields
+ *   (`a=1 OR b=2`). The model ANDs fields, so it cannot hold a correlation.
+ * - `"operator"` — an operator or operand no condition type expresses
+ *   (`$nor`, an unknown `$op`, an object value, an empty `$in`, …).
+ * - `"negation"` — a negative inside an `$or`, or a `$not` that is not a
+ *   plain inversion of equality / emptiness.
+ * - `"conjunction"` — a second positive group AND'd onto a field that already
+ *   has one (`a>1 AND a<5`). A field's positive conditions are OR'd.
+ *
+ * @since 0.1.139
+ */
+type UnsupportedFilterReason = "cross-field" | "operator" | "negation" | "conjunction";
+/**
+ * One AND-ed piece of a Uniquery filter that {@link uniqueryFilterToFieldFilters}
+ * left out of its result.
+ *
+ * @since 0.1.139
+ */
+interface UnsupportedFilter {
+  reason: UnsupportedFilterReason;
+  /** The left-out sub-expression, as it appeared in the input. */
+  expr: FilterExpr;
+  /** Field paths the sub-expression references, in order of appearance. */
+  fields: string[];
+}
+/**
+ * Field paths a Uniquery filter expression references, deduped, in order of
+ * appearance (logical operators are walked, operator keys skipped).
+ *
+ * @internal Exported for `@atscript/vue-table`.
+ */
+declare function filterExprFields(expr: unknown): string[];
+/** Options for {@link decomposeUniqueryFilter}. @since 0.1.140 */
+interface DecomposeUniqueryFilterOptions {
+  /**
+   * Field paths the table knows. Pieces on fields outside it are ignored
+   * silently; a piece mixing known and unknown fields is reported, never
+   * carried. Omit to accept every field.
+   */
+  knownFields?: Iterable<string>;
+  /**
+   * Keep left-out pieces whose fields are all known as `residual` instead of
+   * reporting them. Default `false` — the 0.1.139 split. See
+   * [Custom filter conditions](https://ui.atscript.dev/tables/filtering#custom-filter-conditions).
+   */
+  carry?: boolean;
+}
+/** Result of {@link decomposeUniqueryFilter}. @since 0.1.140 */
+interface DecomposedUniqueryFilter {
+  /** The part field filters express exactly. */
+  filters: FieldFilters;
+  /** Carried pieces — AND-ed conditions, deduped, canonical order. `[]` unless `carry` is on. */
+  residual: FilterExpr[];
+  /** Pieces left out and lost — the result is broader by exactly these. */
+  unsupported: UnsupportedFilter[];
+}
+/**
+ * Split a Uniquery `FilterExpr` into what the table's field-filter model
+ * holds exactly (`filters`), what it cannot hold but carries as residual
+ * conditions (`residual`, with `carry`), and what it leaves out
+ * (`unsupported`). Nothing is approximated: `filters AND residual` selects
+ * `expr` minus the `unsupported` pieces and pieces on fields outside
+ * `knownFields`.
+ *
+ * Never throws, never warns — the caller decides how to report.
+ *
+ * @since 0.1.140
+ */
+declare function decomposeUniqueryFilter(expr: FilterExpr | undefined, opts?: DecomposeUniqueryFilterOptions): DecomposedUniqueryFilter;
+/**
+ * Canonical identity of a filter expression — its `@uniqu/url` spelling.
+ * Two expressions with the same key select the same rows.
+ *
+ * @since 0.1.140
+ */
+declare function filterExprKey(expr: FilterExpr): string;
+/**
+ * A residual-condition list with empty expressions and duplicates (by
+ * {@link filterExprKey}) dropped, sorted by key. Sorted, not first-appearance:
+ * the URL parser moves \`$not\`-wrapped clauses (how \`mergeFilters\` spells
+ * a repeated same-field clause) ahead of plain ones, so appearance order would
+ * flip on every round trip.
+ *
+ * @internal Exported for `@atscript/vue-table`.
+ */
+declare function normalizeResidualFilters(exprs: readonly FilterExpr[]): FilterExpr[];
 /**
  * Convert a Uniquery `FilterExpr` back into the UI's `FieldFilters` shape.
  *
- * Inverse of `filtersToUniqueryFilter`. Drops:
- * - conditions on fields not in `knownFields` (when provided)
- * - operators not in the supported `FilterConditionType` union
- * - `$not` branches (no native UI representation; lossy on hand-crafted URLs)
+ * Inverse of `filtersToUniqueryFilter`, and exact for everything that encoder
+ * produces. For any other input, each AND-ed piece is either converted exactly
+ * or left out whole and reported — never approximated:
+ *
+ * - `$in` becomes equality conditions on the field, `$nin` inequality ones.
+ * - A same-field `$or` becomes that field's OR'd conditions.
+ * - A `$not` that inverts equality / emptiness becomes the inverse conditions.
+ * - Fields next to `$and` / `$or` / `$not` in one object are all kept.
+ * - Anything else (see {@link UnsupportedFilterReason}) is left out. Leaving
+ *   an AND-ed piece out only ever widens the match, so the result selects a
+ *   superset of `expr`. Each left-out piece goes to `onUnsupportedFilter`, or
+ *   to a dev-mode `console.warn` when no handler is given. To keep those
+ *   pieces instead, use {@link decomposeUniqueryFilter} with `carry`.
+ *
+ * Conditions on fields outside `knownFields` (when provided) are ignored
+ * silently: they are not this table's (a host page flag, a stale column). A
+ * piece that mixes known and unknown fields is reported.
  *
  * Returns `{}` for an empty/missing expression. Never throws.
  */
-declare function uniqueryFilterToFieldFilters(expr: FilterExpr | undefined, knownFields?: Iterable<string> | Set<string>): FieldFilters;
+declare function uniqueryFilterToFieldFilters(expr: FilterExpr | undefined, knownFields?: Iterable<string> | Set<string>, onUnsupportedFilter?: (issue: UnsupportedFilter) => void): FieldFilters;
+//#endregion
+//#region src/filters/format-filter-expr.d.ts
+/**
+ * Human-readable rendering of a Uniquery filter expression, worded like the
+ * filter-field chips: `(Status equals shipped and Total greater than 500) or
+ * (Status equals pending and Total less or equal 50)`. `and` binds tighter
+ * than `or`; groups are parenthesized only where needed. Operators without a
+ * wording fall back to their `@uniqu/url` spelling.
+ *
+ * @param labelOf — display label for a field path (e.g. the column label);
+ *   the path itself when omitted or when it returns `undefined`.
+ * @since 0.1.140
+ */
+declare function formatFilterExpr(expr: FilterExpr, labelOf?: (path: string) => string | undefined): string;
 //#endregion
 //#region src/filters/date-shortcuts.d.ts
 /** A date shortcut produces a label and a [start, end] ISO date range. */
@@ -608,6 +770,12 @@ interface BuildTableQueryOptions {
   ignoreSorters?: boolean;
   /** User-configured field filters. */
   filters: FieldFilters;
+  /**
+   * Residual filter conditions — AND-ed conjuncts the field-filter model
+   * cannot hold (a cross-field `$or`, a second range on one field, …). AND'd
+   * after `filters`. Since 0.1.140.
+   */
+  residualFilters?: FilterExpr[];
   /** Always-applied Uniquery filter (AND'd with user filters). */
   forceFilters?: FilterExpr;
   /** Full-text search term. */
@@ -626,7 +794,8 @@ interface BuildTableQueryOptions {
  * Build a Uniquery object from table UI state.
  *
  * Pure function — no framework dependencies.
- * Combines user filters with force filters, merges sorters,
+ * Combines user filters (field filters, then residual conditions) with force
+ * filters, merges sorters,
  * projects visible columns, and applies pagination.
  */
 declare function buildTableQuery(opts: BuildTableQueryOptions): Uniquery;
@@ -642,8 +811,9 @@ declare function mergeSorters(forceSorters: SortControl[], userSorters: SortCont
 //#endregion
 //#region src/query/merge-filters.d.ts
 /**
- * AND-merge two filter expressions, producing a wire shape that survives
- * `@uniqu/url`'s `mergeConjunction` parser collapse.
+ * AND-merge filter expressions (`undefined` ones skipped), producing a wire
+ * shape that survives `@uniqu/url`'s `mergeConjunction` parser collapse.
+ * Variadic since 0.1.140.
  *
  * The collapse problem: when two `$and` siblings target the same field
  * with the same op (e.g. `{status: 'cancelled'}` AND `{status: 'shipped'}`),
@@ -656,12 +826,17 @@ declare function mergeSorters(forceSorters: SortControl[], userSorters: SortCont
  * and `!!p ≡ p` is a semantic identity, so the server evaluator sees the
  * same AND. Non-colliding merges produce the canonical `$and` shape.
  */
-declare function mergeFilters(a: FilterExpr | undefined, b: FilterExpr | undefined): FilterExpr | undefined;
+declare function mergeFilters(...exprs: (FilterExpr | undefined)[]): FilterExpr | undefined;
 //#endregion
 //#region src/query/url-query.d.ts
 /** State subset that round-trips through the URL bridge. */
 interface UrlQueryStateLike {
   filters: FieldFilters;
+  /**
+   * Residual filter conditions, AND-ed after `filters`. Only the ones the
+   * filter gate owns are written (see {@link residualGateOwns}). Since 0.1.140.
+   */
+  residualFilters?: FilterExpr[];
   sorters: SortControl[];
   /** 1-based page number. `1` is the default and is omitted from the URL. */
   page?: number;
@@ -678,10 +853,41 @@ interface UrlQueryStateLike {
    */
   ignoreSorters?: boolean;
 }
+/**
+ * The URL control that marks a query string as a complete snapshot of the
+ * table's filters and sorters. Restoring a URL that carries it clears every
+ * filter and sorter the URL owns before applying its own, so nothing the URL
+ * omits survives (empty `$sort` included). A URL without it is an overlay:
+ * its filters and sorters are laid over the table's starting ones.
+ *
+ * The encoder writes it bare (`…&$snapshot`) on every URL; the decoder goes
+ * by presence alone, whatever the value. `UrlQuerySync.snapshot: false` turns
+ * both off.
+ *
+ * @since 0.1.139
+ */
+declare const URL_SNAPSHOT_KEY = "$snapshot";
 /** Snapshot recovered from a URL string — partial on purpose so callers can layer it onto state. */
 interface UrlQueryStateSnapshot {
   filters: FieldFilters;
   sorters: SortControl[];
+  /**
+   * `true` when the URL carried {@link URL_SNAPSHOT_KEY} (and `sync.snapshot`
+   * is not `false`). Omitted otherwise. Since 0.1.139.
+   */
+  snapshot?: true;
+  /**
+   * Pieces of the URL's filter that are left out because field filters
+   * cannot express them — see `uniqueryFilterToFieldFilters`. Since 0.1.140
+   * only the pieces NOT carried in `residual`. Omitted when none. Since 0.1.139.
+   */
+  unsupported?: UnsupportedFilter[];
+  /**
+   * Filter pieces field filters cannot express, carried as residual
+   * conditions (see `decomposeUniqueryFilter`). Omitted when there are none
+   * or `sync.residual` is `false`. Since 0.1.140.
+   */
+  residual?: FilterExpr[];
   /**
    * Raw record offset from `$skip` (omitted when no `$skip` in URL). The
    * decoder does NOT compute a page index — that requires `itemsPerPage`,
@@ -719,6 +925,21 @@ interface UrlQuerySync {
   search?: boolean;
   /** Whether pagination (`$skip` + `$limit`) syncs. Page and limit are coupled — one knob. */
   pagination?: boolean;
+  /**
+   * Whether the encoder writes {@link URL_SNAPSHOT_KEY} and the decoder
+   * honours it. Default `true`; `false` makes every URL an overlay.
+   * Since 0.1.139.
+   */
+  snapshot?: boolean;
+  /**
+   * Whether filter pieces the field-filter model cannot hold travel as
+   * residual conditions. Default `true`: the encoder writes
+   * `UrlQueryStateLike.residualFilters` and the decoder returns them as
+   * `residual`. `false`: neither — the 0.1.139 behaviour, where such
+   * pieces are left out and reported. Inert when `filters` is off.
+   * Since 0.1.140.
+   */
+  residual?: boolean;
 }
 interface UrlQueryDefaults {
   /** Consumer's `:limit` prop. Used to omit `$limit` from the URL when state matches it. */
@@ -755,6 +976,14 @@ declare function resolveAspectGate(value: boolean | string[] | undefined): Aspec
  * @since 0.1.137
  */
 declare function gateOwns(gate: AspectGate, path: string): boolean;
+/**
+ * Does a URL under `gate` own the residual condition `expr`? Only when it
+ * owns every field the condition references — a condition that touches a
+ * private field stays private as a whole.
+ *
+ * @internal Exported for `@atscript/vue-table`.
+ */
+declare function residualGateOwns(gate: AspectGate, expr: FilterExpr): boolean;
 /**
  * Serialize the table state subset into a URL query string.
  *
@@ -762,7 +991,9 @@ declare function gateOwns(gate: AspectGate, path: string): boolean;
  * `$actions`, `forceFilters`, `forceSorters` — those are not user state) and
  * appends `$skip` / `$limit` for pagination.
  *
- * Returns `""` (no leading `?`) for the default view.
+ * Stamps {@link URL_SNAPSHOT_KEY} unless `defaults.sync.snapshot` is `false`
+ * (or neither filters nor sorters sync), so the default view serializes to
+ * `"$snapshot"`; with the marker off it serializes to `""` (no leading `?`).
  */
 declare function stateToUrlQueryString(state: UrlQueryStateLike, defaults: UrlQueryDefaults): string;
 /**
@@ -796,7 +1027,11 @@ interface UrlQueryParseOptions {
  * Robust by design — schema drift and copy-paste errors must not break the
  * recipient's view:
  * - unknown fields (not in `knownFields`) → silently dropped
- * - unsupported operators → silently dropped
+ * - filter pieces field filters cannot express (cross-field OR, unknown
+ *   operator, …) → left out of `filters` and listed in `unsupported`, never
+ *   approximated (the parser does not warn — the caller decides). Unless
+ *   `sync.residual` is `false`, those whose fields are all known come back
+ *   in `residual` instead
  * - unknown controls (e.g. `$weird=42`) → silently ignored
  * - malformed query → `{ filters: {}, sorters: [], searchTerm: "" }`
  *
@@ -891,6 +1126,13 @@ interface TableStateData {
   filterFields: string[];
   /** Active field filters. */
   filters: FieldFilters;
+  /**
+   * Residual filter conditions — AND-ed Uniquery conjuncts the field-filter
+   * model cannot hold (a cross-field `$or`, a second range on one field, …),
+   * applied after `filters`. Restored from URLs, shown as "custom filter"
+   * chips. Since 0.1.140.
+   */
+  residualFilters: FilterExpr[];
   /** Active sorters. */
   sorters: SortControl[];
   /**
@@ -1011,8 +1253,18 @@ interface TableStateMethods {
   loadingAt(absIdx: number): boolean;
   /** Returns the last error attached to the block covering `absIdx`, or null. */
   errorAt(absIdx: number): Error | null;
-  /** Clear all applied filters. Does not touch `filterFields`. */
+  /**
+   * Clear all applied filters — field filters and residual conditions. Does
+   * not touch `filterFields`.
+   */
   resetFilters(): void;
+  /**
+   * Replace the residual filter conditions (AND-ed Uniquery conjuncts).
+   * Empty expressions and duplicates are dropped. Since 0.1.140.
+   */
+  setResidualFilters(exprs: FilterExpr[]): void;
+  /** Remove the residual condition at `index`. Since 0.1.140. */
+  removeResidualFilter(index: number): void;
   /** Open the config dialog (optionally to a specific tab). */
   showConfigDialog(tab?: ConfigTab): void;
   /** Append a field to the displayed filter fields (deduped). */
@@ -1306,4 +1558,7 @@ declare function cellAsString(v: unknown): string;
  */
 declare function sortRowsLocally<T extends Record<string, unknown>>(rows: T[], sorters: readonly SortControl[], getValue?: (row: T, field: string) => unknown): T[];
 //#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, DRAFT_PERSISTED_ASPECTS, type DateShortcut, type DisplayColumnDef, type DraftPersistedAspect, ExportAbortError, type ExportPage, type ExportPageFetcher, type ExportScalar, 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, cellAsString, clampTopIndex, collectExportRows, columnFilterType, computeDefaultColumnWidth, conditionLabel, conditionsForType, csvCell, dateShortcuts, debounce, defaultCondition, derivePresetAspects, deserializeDraft, draftMatchesPreset, escapeRegex, filledFilterCount, filterTokenLabel, filtersToUniqueryFilter, formatFilterCondition, fromWireSnapshot, gateOwns, hasSecondValue, isAuthError, isDirtyAgainst, isEmptyDraft, isFilled, isSimpleEq, isSystemPresetId, isUnavailableError, mergeDisplayColumns, mergeFilters, mergeSorters, normaliseSystemPresetId, pageAlignedBlocksFor, parseFilterInput, planFetch, reconcileColumnWidthDefaults, reorderColumnNames, resolveAspectGate, resolveExportValue, resolveSystemPresets, rowsToPks, sameColumnSet, serializeDraft, setsEqual, sortRowsLocally, sortersEqual, stableStringify, stateToUrlQueryString, toCsv, toWireSnapshot, togglePk, trimSelection, unescapeRegex, uniqueryFilterToFieldFilters, urlQueryConsumesKey, urlQueryStringToState, userConfId, walkBackwardAbsorb, walkForwardAbsorb, withStableOrder };
+//#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, ExportAbortError, type ExportPage, type ExportPageFetcher, type ExportScalar, type FetchPlan, type FetchPlanMode, type FieldFilters, type FilterCondition, type FilterConditionType, type FilterableColumn, 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 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, reconcileColumnWidthDefaults, reorderColumnNames, residualGateOwns, resolveAspectGate, resolveExportValue, resolveSystemPresets, rowsToPks, sameColumnSet, serializeDraft, setsEqual, sortRowsLocally, sortersEqual, stableStringify, stateToUrlQueryString, toCsv, toWireSnapshot, togglePk, trimSelection, unescapeRegex, uniqueryFilterToFieldFilters, urlQueryConsumesKey, urlQueryStringToState, userConfId, walkBackwardAbsorb, walkForwardAbsorb, withStableOrder };