@atscript/ui-table 0.1.132 → 0.1.134

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,188 @@ 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 };
+//#region src/export/csv.d.ts
+/** A cell value after export-time resolution — always a spreadsheet scalar. */
+type ExportScalar = string | number | boolean | null;
+/** Options shared by {@link csvCell} and {@link toCsv}. */
+interface CsvOptions {
+  /**
+   * Prepend a UTF-8 byte-order mark. Excel needs it to detect UTF-8 in a
+   * `.csv` opened by double-click; most other tools don't care. Default `false`.
+   */
+  bom?: boolean;
+  /**
+   * Prefix a STRING cell starting with `=`, `+`, `-`, `@`, TAB or CR with a
+   * single quote so a spreadsheet treats it as text instead of a formula
+   * (CSV-injection defence). Numbers and booleans are never touched — a
+   * negative number stays numeric. Default `true`; set `false` when the file
+   * is consumed by a parser rather than a spreadsheet.
+   */
+  escapeFormulas?: boolean;
+  /** Field delimiter. Default `","`. */
+  delimiter?: string;
+}
+/**
+ * Render one value as an RFC 4180 field: formula-escaped (unless opted out),
+ * then quoted when it contains the delimiter, a quote, CR or LF — with inner
+ * quotes doubled.
+ */
+declare function csvCell(value: ExportScalar | undefined, opts?: CsvOptions): string;
+/**
+ * Serialise a header row + data rows to an RFC 4180 CSV string (`\r\n` row
+ * separators, quoted fields where required, optional UTF-8 BOM).
+ *
+ * Pure — no DOM, no framework. See {@link csvCell} for the per-field rules.
+ */
+declare function toCsv(header: readonly string[], rows: readonly (readonly ExportScalar[])[], opts?: CsvOptions): string;
+//#endregion
+//#region src/export/export-paging.d.ts
+/** Default page size used by the export pager when the caller gives none. */
+declare const DEFAULT_EXPORT_PAGE_SIZE = 500;
+/** One page of an export run — the subset of `PageResult` the pager needs. */
+interface ExportPage {
+  data: Record<string, unknown>[];
+  /** Total row count, when the endpoint reports one. */
+  count?: number;
+}
+/** Fetches one page of the export query. Mirrors `client.pages(query, page, size)`. */
+type ExportPageFetcher = (query: Uniquery, page: number, size: number) => Promise<ExportPage>;
+/** Rejection raised when an export is cancelled through its `AbortSignal`. */
+declare class ExportAbortError extends Error {
+  /** Matches the DOM convention so `err.name === "AbortError"` checks work. */
+  readonly name = "AbortError";
+  constructor(message?: string);
+}
+interface CollectExportRowsOptions<T = Record<string, unknown>> {
+  /** The query to page through. Pass it through {@link withStableOrder} first. */
+  query: Uniquery;
+  /** Rows per request. Default {@link DEFAULT_EXPORT_PAGE_SIZE}. */
+  pageSize?: number;
+  fetchPage: ExportPageFetcher;
+  /** Aborts between pages; the returned promise rejects with {@link ExportAbortError}. */
+  signal?: AbortSignal;
+  /** Called after every settled page. `total` comes from the first page's `count`. */
+  onProgress?: (done: number, total?: number) => void;
+  /** Hard ceiling on collected rows — the pager stops once it is reached. */
+  maxRows?: number;
+  /**
+   * Project each row as it arrives — the collected array holds the projection,
+   * not the raw row, so a formatted export never keeps both in memory.
+   * Identity by default.
+   */
+  mapRow?: (row: Record<string, unknown>) => T;
+}
+/**
+ * Append the primary key(s) to a query's `$sort` as a tiebreaker so paging is
+ * stable: two rows equal on every user sorter keep a deterministic relative
+ * order, and no row is skipped or duplicated across page boundaries.
+ *
+ * Existing sort fields are preserved in order and never replaced — a pk the
+ * user already sorts by is left where it is. Returns the input query when
+ * there is nothing to add.
+ */
+declare function withStableOrder(query: Uniquery, primaryKeys: readonly string[]): Uniquery;
+/**
+ * Page through `query` until the endpoint runs out of rows, collecting every
+ * row into one array.
+ *
+ * Stops when a page comes back short (fewer rows than `pageSize`), when the
+ * reported `count` is reached, or when `maxRows` is hit. Checks `signal`
+ * before and after every request so a cancel lands between pages rather than
+ * mid-flight.
+ */
+declare function collectExportRows<T = Record<string, unknown>>(opts: CollectExportRowsOptions<T>): Promise<{
+  rows: T[];
+  total?: number;
+}>;
+//#endregion
+//#region src/export/export-value.d.ts
+/**
+ * Turn a raw cell value into the scalar an export carries, using the same
+ * column metadata the cell renderers read:
+ *
+ * - `null` / `undefined` → `null` (an empty CSV field).
+ * - union / enum columns (`column.options`) → the option's **label**, so the
+ *   file reads like the screen; an unknown key falls back to the raw value.
+ * - `Date` → ISO 8601 (spreadsheet- and re-import-friendly, unlike a
+ *   locale-formatted date).
+ * - arrays → comma-joined scalars; other objects → JSON.
+ * - numbers / booleans pass through untouched so a spreadsheet keeps them
+ *   numeric.
+ *
+ * Callers override per column (`formatters`) or globally (`formatCell`) when
+ * they want different text.
+ */
+declare function resolveExportValue(value: unknown, column?: ColumnDef): ExportScalar;
+//#endregion
+//#region src/columns/display-columns.d.ts
+/**
+ * A client-owned column the app adds on top of the server's `/meta` columns —
+ * a derived value, a count, a link, a widget. It has a label, a width and a
+ * renderer, takes part in column visibility / reordering / presets like any
+ * other column, but never reaches the backend: no `$select`, no server sort,
+ * no filters.
+ *
+ * Since 0.1.134.
+ */
+interface DisplayColumnDef {
+  /**
+   * Stable key. Becomes the column's `path`, so it is what `cell-<key>` /
+   * `header-<key>` slots, the `columnNames` model and presets refer to. Must
+   * not collide with a real field path.
+   */
+  key: string;
+  /** Header label. Unlike `fixed` chrome columns, a display column is labelled. */
+  label: string;
+  /** Default width (any CSS length), e.g. `"8em"`. */
+  width?: string;
+  /** Initial position among the server columns (lower = earlier). Appended when omitted. */
+  order?: number;
+  /**
+   * `'local'` makes the header offer sorting, applied client-side over the
+   * rows currently loaded (page-local). Anything else — including the default
+   * — leaves the column unsortable, since the server cannot sort it.
+   *
+   * Paged tables only: `<AsWindowTable>` caches rows by absolute index, so
+   * there is no page to re-order and the affordance is not offered there.
+   */
+  sortable?: false | "local";
+  /**
+   * The value `sortable: 'local'` orders by. A display column has no server
+   * field behind it, so without this the sorter reads `row[key]` — which is
+   * `undefined` unless the app happens to carry that key on the row. Ignored
+   * when the column is not sorted locally.
+   */
+  sortValue?: (row: Record<string, unknown>) => unknown;
+  /** Named cell component (`components[name]` on the table context). */
+  component?: string;
+  /** Cell type for the `types[type]` dispatch. Default `"text"`. */
+  type?: string;
+}
+/**
+ * Merge client-owned columns into the server's column list, ordered by each
+ * column's `order`. `Array#sort` is stable, so server columns that share an
+ * `order` keep their `/meta` sequence. Returns `base` untouched when there is
+ * nothing to merge.
+ */
+declare function mergeDisplayColumns(base: ColumnDef[], display: readonly DisplayColumnDef[]): ColumnDef[];
+//#endregion
+//#region src/utils/sort-rows.d.ts
+/**
+ * Coerce a primitive cell value to the text used for comparing and matching
+ * cells — the string compare in {@link sortRowsLocally} and the substring
+ * search of an in-memory table. Objects and functions collapse to `""` so
+ * `'[object Object]'` never drives an ordering or matches a search.
+ */
+declare function cellAsString(v: unknown): string;
+/**
+ * Sort rows in memory by `sorters`, numerically when both sides are numbers
+ * and locale-aware otherwise. Returns a NEW array; the input is untouched. A
+ * no-op (returns the input reference) when there is nothing to sort.
+ *
+ * `getValue` reads a sorter's field off a row — pass a dot-path reader for
+ * nested fields; the default is a flat property read.
+ */
+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, 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 };

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,188 @@ 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 };
+//#region src/export/csv.d.ts
+/** A cell value after export-time resolution — always a spreadsheet scalar. */
+type ExportScalar = string | number | boolean | null;
+/** Options shared by {@link csvCell} and {@link toCsv}. */
+interface CsvOptions {
+  /**
+   * Prepend a UTF-8 byte-order mark. Excel needs it to detect UTF-8 in a
+   * `.csv` opened by double-click; most other tools don't care. Default `false`.
+   */
+  bom?: boolean;
+  /**
+   * Prefix a STRING cell starting with `=`, `+`, `-`, `@`, TAB or CR with a
+   * single quote so a spreadsheet treats it as text instead of a formula
+   * (CSV-injection defence). Numbers and booleans are never touched — a
+   * negative number stays numeric. Default `true`; set `false` when the file
+   * is consumed by a parser rather than a spreadsheet.
+   */
+  escapeFormulas?: boolean;
+  /** Field delimiter. Default `","`. */
+  delimiter?: string;
+}
+/**
+ * Render one value as an RFC 4180 field: formula-escaped (unless opted out),
+ * then quoted when it contains the delimiter, a quote, CR or LF — with inner
+ * quotes doubled.
+ */
+declare function csvCell(value: ExportScalar | undefined, opts?: CsvOptions): string;
+/**
+ * Serialise a header row + data rows to an RFC 4180 CSV string (`\r\n` row
+ * separators, quoted fields where required, optional UTF-8 BOM).
+ *
+ * Pure — no DOM, no framework. See {@link csvCell} for the per-field rules.
+ */
+declare function toCsv(header: readonly string[], rows: readonly (readonly ExportScalar[])[], opts?: CsvOptions): string;
+//#endregion
+//#region src/export/export-paging.d.ts
+/** Default page size used by the export pager when the caller gives none. */
+declare const DEFAULT_EXPORT_PAGE_SIZE = 500;
+/** One page of an export run — the subset of `PageResult` the pager needs. */
+interface ExportPage {
+  data: Record<string, unknown>[];
+  /** Total row count, when the endpoint reports one. */
+  count?: number;
+}
+/** Fetches one page of the export query. Mirrors `client.pages(query, page, size)`. */
+type ExportPageFetcher = (query: Uniquery, page: number, size: number) => Promise<ExportPage>;
+/** Rejection raised when an export is cancelled through its `AbortSignal`. */
+declare class ExportAbortError extends Error {
+  /** Matches the DOM convention so `err.name === "AbortError"` checks work. */
+  readonly name = "AbortError";
+  constructor(message?: string);
+}
+interface CollectExportRowsOptions<T = Record<string, unknown>> {
+  /** The query to page through. Pass it through {@link withStableOrder} first. */
+  query: Uniquery;
+  /** Rows per request. Default {@link DEFAULT_EXPORT_PAGE_SIZE}. */
+  pageSize?: number;
+  fetchPage: ExportPageFetcher;
+  /** Aborts between pages; the returned promise rejects with {@link ExportAbortError}. */
+  signal?: AbortSignal;
+  /** Called after every settled page. `total` comes from the first page's `count`. */
+  onProgress?: (done: number, total?: number) => void;
+  /** Hard ceiling on collected rows — the pager stops once it is reached. */
+  maxRows?: number;
+  /**
+   * Project each row as it arrives — the collected array holds the projection,
+   * not the raw row, so a formatted export never keeps both in memory.
+   * Identity by default.
+   */
+  mapRow?: (row: Record<string, unknown>) => T;
+}
+/**
+ * Append the primary key(s) to a query's `$sort` as a tiebreaker so paging is
+ * stable: two rows equal on every user sorter keep a deterministic relative
+ * order, and no row is skipped or duplicated across page boundaries.
+ *
+ * Existing sort fields are preserved in order and never replaced — a pk the
+ * user already sorts by is left where it is. Returns the input query when
+ * there is nothing to add.
+ */
+declare function withStableOrder(query: Uniquery, primaryKeys: readonly string[]): Uniquery;
+/**
+ * Page through `query` until the endpoint runs out of rows, collecting every
+ * row into one array.
+ *
+ * Stops when a page comes back short (fewer rows than `pageSize`), when the
+ * reported `count` is reached, or when `maxRows` is hit. Checks `signal`
+ * before and after every request so a cancel lands between pages rather than
+ * mid-flight.
+ */
+declare function collectExportRows<T = Record<string, unknown>>(opts: CollectExportRowsOptions<T>): Promise<{
+  rows: T[];
+  total?: number;
+}>;
+//#endregion
+//#region src/export/export-value.d.ts
+/**
+ * Turn a raw cell value into the scalar an export carries, using the same
+ * column metadata the cell renderers read:
+ *
+ * - `null` / `undefined` → `null` (an empty CSV field).
+ * - union / enum columns (`column.options`) → the option's **label**, so the
+ *   file reads like the screen; an unknown key falls back to the raw value.
+ * - `Date` → ISO 8601 (spreadsheet- and re-import-friendly, unlike a
+ *   locale-formatted date).
+ * - arrays → comma-joined scalars; other objects → JSON.
+ * - numbers / booleans pass through untouched so a spreadsheet keeps them
+ *   numeric.
+ *
+ * Callers override per column (`formatters`) or globally (`formatCell`) when
+ * they want different text.
+ */
+declare function resolveExportValue(value: unknown, column?: ColumnDef): ExportScalar;
+//#endregion
+//#region src/columns/display-columns.d.ts
+/**
+ * A client-owned column the app adds on top of the server's `/meta` columns —
+ * a derived value, a count, a link, a widget. It has a label, a width and a
+ * renderer, takes part in column visibility / reordering / presets like any
+ * other column, but never reaches the backend: no `$select`, no server sort,
+ * no filters.
+ *
+ * Since 0.1.134.
+ */
+interface DisplayColumnDef {
+  /**
+   * Stable key. Becomes the column's `path`, so it is what `cell-<key>` /
+   * `header-<key>` slots, the `columnNames` model and presets refer to. Must
+   * not collide with a real field path.
+   */
+  key: string;
+  /** Header label. Unlike `fixed` chrome columns, a display column is labelled. */
+  label: string;
+  /** Default width (any CSS length), e.g. `"8em"`. */
+  width?: string;
+  /** Initial position among the server columns (lower = earlier). Appended when omitted. */
+  order?: number;
+  /**
+   * `'local'` makes the header offer sorting, applied client-side over the
+   * rows currently loaded (page-local). Anything else — including the default
+   * — leaves the column unsortable, since the server cannot sort it.
+   *
+   * Paged tables only: `<AsWindowTable>` caches rows by absolute index, so
+   * there is no page to re-order and the affordance is not offered there.
+   */
+  sortable?: false | "local";
+  /**
+   * The value `sortable: 'local'` orders by. A display column has no server
+   * field behind it, so without this the sorter reads `row[key]` — which is
+   * `undefined` unless the app happens to carry that key on the row. Ignored
+   * when the column is not sorted locally.
+   */
+  sortValue?: (row: Record<string, unknown>) => unknown;
+  /** Named cell component (`components[name]` on the table context). */
+  component?: string;
+  /** Cell type for the `types[type]` dispatch. Default `"text"`. */
+  type?: string;
+}
+/**
+ * Merge client-owned columns into the server's column list, ordered by each
+ * column's `order`. `Array#sort` is stable, so server columns that share an
+ * `order` keep their `/meta` sequence. Returns `base` untouched when there is
+ * nothing to merge.
+ */
+declare function mergeDisplayColumns(base: ColumnDef[], display: readonly DisplayColumnDef[]): ColumnDef[];
+//#endregion
+//#region src/utils/sort-rows.d.ts
+/**
+ * Coerce a primitive cell value to the text used for comparing and matching
+ * cells — the string compare in {@link sortRowsLocally} and the substring
+ * search of an in-memory table. Objects and functions collapse to `""` so
+ * `'[object Object]'` never drives an ordering or matches a search.
+ */
+declare function cellAsString(v: unknown): string;
+/**
+ * Sort rows in memory by `sorters`, numerically when both sides are numbers
+ * and locale-aware otherwise. Returns a NEW array; the input is untouched. A
+ * no-op (returns the input reference) when there is nothing to sort.
+ *
+ * `getValue` reads a sorter's field off a row — pass a dot-path reader for
+ * nested fields; the default is a flat property read.
+ */
+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, 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 };