@lavalogic/scoria 0.37.44 → 0.37.45

package/dist/Components/Table/Types/Context/TableContext.svelte.d.ts

@@ -1,4 +1,6 @@
+import { ClipboardState } from './ClipboardState.svelte.js';
 import { PreferencesState } from './PreferencesState.svelte.js';
+import { QueryValuesState } from './QueryValuesState.svelte.js';
 import { SelectionState } from './SelectionState.svelte.js';
 import { SvelteMap } from 'svelte/reactivity';
 import type { Updater } from 'svelte/store';
@@ -75,10 +77,8 @@ export declare class TableContext<T extends object, RowIdType extends Primitive>
     get paginationRepo(): IDataRepository<T> | undefined;
     set paginationRepo(v: IDataRepository<T> | undefined);
     /**
-     * Delegating accessor preserved for backwards compatibility; reads /
-     * writes through to `_filtering.showQuickFiltering`. The sub-context
-     * owns the `allowQuickFiltering` gate so the setter logic stays
-     * identical to the pre-extraction implementation.
+     * Delegates to `_filtering.showQuickFiltering`. The sub-context owns
+     * the `allowQuickFiltering` gate inside the setter.
      */
     get showQuickFiltering(): boolean;
     set showQuickFiltering(v: boolean);
@@ -86,26 +86,19 @@ export declare class TableContext<T extends object, RowIdType extends Primitive>
     get dataRepo(): IDataRepository<T>;
     private set dataRepo(value);
     /**
-     * Delegating getter preserved for backwards compatibility. Reads
-     * through to `_filtering.remoteFilters`; the parent uses
-     * `_filtering.setRemoteFilters` during column-def setup to write the
-     * caller-supplied value.
+     * Delegates to `_filtering.remoteFilters`. The write path is
+     * `_filtering.setRemoteFilters`, called during column-def setup.
      */
     get remoteFilters(): CustomRemoteFilters<unknown> | undefined;
     /**
-     * Delegating accessor preserved for backwards compatibility; reads /
-     * writes through to `_filtering.showSelectedOnly`. The sub-context
-     * preserves the idempotency short-circuit (re-assigning the same
-     * value is a no-op).
+     * Delegates to `_filtering.showSelectedOnly`. Re-assigning the same
+     * value is a no-op (idempotency short-circuit in the sub-context).
      */
     get showSelectedOnly(): boolean;
     set showSelectedOnly(v: boolean);
     /**
-     * Delegating getters that relay the per-type `FilterFn` from
-     * `_filtering`. The sub-context's `$derived` chain reads through
-     * `paginationRepo` via the thunk so the source of truth stays
-     * with the data repository; consumers that bind these getters
-     * (notably `setupDefaultColumnDefs`) need no migration.
+     * Per-type `FilterFn` getters. Delegate to `_filtering`, which reads
+     * the source-of-truth from `paginationRepo` via thunk.
      */
     get dateFilter(): FilterFn<T, DateFilterValueType> | undefined;
     get numberFilter(): FilterFn<T, NumberFilterValueType> | undefined;
@@ -118,73 +111,43 @@ export declare class TableContext<T extends object, RowIdType extends Primitive>
     private _dragTarget;
     get dragTarget(): ColumnDef<T> | null;
     set dragTarget(v: ColumnDef<T> | null);
-    /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * actual `$state` slot lives on `_columnLayout`; this getter / setter
-     * pair forwards reads and writes so existing consumers need no
-     * migration. See `_columnLayout` below for the sub-context.
-     */
+    /** Delegates to `_columnLayout.columnDefs`. */
     get columnDefs(): Array<ColumnDef<T>>;
     set columnDefs(v: Array<ColumnDef<T>>);
     /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * actual `$state` slot lives on `_preferences._columnPresets`
-     * (Phase 6.4). The setter is private because the consumer-facing
-     * write path goes through `saveColumnPreset` (which also persists
-     * the list to localStorage); internal call sites that need to
+     * Delegates to `_preferences._columnPresets`. The setter is private
+     * because the public write path is `saveColumnPreset` (which also
+     * persists to localStorage); internal call sites that need to
      * mutate the list directly call `_preferences.setPresets(...)`.
      */
     get columnPresets(): ReadonlyArray<ColumnDefSet<T>>;
-    /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * actual `$state` slot lives on `_preferences._selectedPreset`
-     * (Phase 6.4). Reads / writes through to the sub-context.
-     */
+    /** Delegates to `_preferences._selectedPreset`. */
     get selectedPreset(): ColumnDefSet<T> | undefined;
     set selectedPreset(v: ColumnDefSet<T> | undefined);
     /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * `$state` slot lives on `_focus._focusedRowIndices` (Phase 6.6).
-     * Populated by the parent's focus-derived `$effect` through
+     * Delegates to `_focus._focusedRowIndices`. Populated by the
+     * focus-derived `$effect` in the constructor through
      * `_focus.setFocusedDerived(rows, cols)`.
      */
     get focusedRowIndices(): ReadonlySet<number>;
-    /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * actual `$state` slot lives on `_selection._highlightedItems`
-     * (Phase 6.5).
-     */
+    /** Delegates to `_selection._highlightedItems`. */
     get highlightedItems(): SvelteMap<RowIdType, T>;
-    /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * `$state` slot lives on `_focus._focusedColumnIds` (Phase 6.6).
-     */
+    /** Delegates to `_focus._focusedColumnIds`. */
     get focusedColumnIds(): ReadonlySet<string>;
-    /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * `$state` slot lives on `_focus._isMousingDown` (Phase 6.6).
-     */
+    /** Delegates to `_focus._isMousingDown`. */
     get isMousingDown(): boolean;
     set isMousingDown(v: boolean);
     /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * `$state` slot lives on `_focus._focusStart` (Phase 6.6). The
-     * setter remains read-only at this surface; the write path is
-     * `moveFocus` / `unfocus` / `tabForward` / `tabBackward` /
-     * `endFocus` / `setFocusEnd` / `startFocus` (all delegated below).
+     * Delegates to `_focus._focusStart`. This surface is read-only; the
+     * write path is `moveFocus` / `unfocus` / `tabForward` /
+     * `tabBackward` / `endFocus` / `setFocusEnd` / `startFocus` (all
+     * delegated below).
      */
     get focusStart(): CellCoordinates | null;
-    /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * `$state` slot lives on `_focus._focusStartIsBeingEdited`
-     * (Phase 6.6).
-     */
+    /** Delegates to `_focus._focusStartIsBeingEdited`. */
     get focusStartIsBeingEdited(): boolean;
     set focusStartIsBeingEdited(v: boolean);
-    /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * `$state` slot lives on `_focus._focusEnd` (Phase 6.6).
-     */
+    /** Delegates to `_focus._focusEnd`. */
     get focusEnd(): CellCoordinates | null;
     set focusEnd(v: CellCoordinates | null);
     private _singleClickEditing;
@@ -199,23 +162,30 @@ export declare class TableContext<T extends object, RowIdType extends Primitive>
     private _alternateRowColours;
     get alternateRowColours(): boolean;
     set alternateRowColours(v: boolean);
-    private _copyWithHeaders;
+    /**
+     * Clipboard sub-context owning the two user-tunable preference flags
+     * (`copyWithHeaders`, `commaSeparatedCopy`) plus the
+     * `copyDataToClipboard` / `copyHighlightedRowsToClipboard` writers and
+     * their cell-serialisation internals. Dependency thunks below close
+     * over the parent reads it needs (column defs, sorted data, focus
+     * coordinates, etc.); the parent never sees the clipboard internals.
+     */
+    readonly _clipboard: ClipboardState<T, RowIdType>;
+    /** Delegates to `_clipboard.copyWithHeaders`. */
     get copyWithHeaders(): boolean;
     set copyWithHeaders(v: boolean);
-    private _commaSeparatedCopy;
+    /** Delegates to `_clipboard.commaSeparatedCopy`. */
     get commaSeparatedCopy(): boolean;
     set commaSeparatedCopy(v: boolean);
     /**
-     * Delegating accessor preserved for backwards compatibility. Reads
-     * through to `_columnLayout.columnSizing`. Per-key mutations (e.g.
+     * Delegates to `_columnLayout.columnSizing`. Per-key mutations (e.g.
      * `this.columnSizing[id] = w` in `autoResize`) work because the
      * underlying `$state` slot is a Svelte proxy.
      */
     get columnSizing(): ColumnSizingState;
     set columnSizing(v: ColumnSizingState);
     /**
-     * Delegating accessor preserved for backwards compatibility. Reads
-     * through to `_columnLayout.columnPinning`. The `setColumnPinning`
+     * Delegates to `_columnLayout.columnPinning`. The `setColumnPinning`
      * updater below honours the `allowColumnReordering` master gate; the
      * direct setter does not, by design (used for preset switches and
      * the init flow where the gate has already been checked).
@@ -223,8 +193,7 @@ export declare class TableContext<T extends object, RowIdType extends Primitive>
     get columnPinning(): ColumnPinningState;
     set columnPinning(v: ColumnPinningState);
     /**
-     * Delegating accessor preserved for backwards compatibility. Reads
-     * through to `_columnLayout.columnVisibility`. Tri-state semantics
+     * Delegates to `_columnLayout.columnVisibility`. Tri-state semantics
      * (`true` / `false` / `undefined`) are preserved.
      */
     get columnVisibility(): VisibilityState;
@@ -234,13 +203,12 @@ export declare class TableContext<T extends object, RowIdType extends Primitive>
      * `col.display({ modal })` modal is currently open, or `null` when no
      * modal is open.
      *
-     * Keyed on the **row object reference**, not on visible index, so the
-     * open-modal state is stable across pagination, sort, and filter
-     * changes - the cell renderer matches via `cell.row.original ===
-     * openModalCell.row`. Visible-index-based keying (the old
-     * `CellCoordinatesWithoutColumn` shape) silently re-targeted the modal
-     * to whichever row happened to occupy the same index after a page
-     * change.
+     * Keyed on the **row object reference** (NOT on visible index) so
+     * the open-modal state is stable across pagination, sort, and filter
+     * changes; the cell renderer matches via
+     * `cell.row.original === openModalCell.row`. Visible-index keying
+     * would silently re-target the modal to whichever row happened to
+     * occupy the same index after a page change.
      */
     private _openModalCell;
     get openModalCell(): {
@@ -255,30 +223,23 @@ export declare class TableContext<T extends object, RowIdType extends Primitive>
     get shownActionsPopup(): symbol | undefined;
     set shownActionsPopup(v: symbol | undefined);
     /**
-     * Delegating getter preserved for backwards compatibility. The
-     * actual `$derived` chain (and the async-result cache) live on
-     * `_selection.allSelectedInCurrentPage` (Phase 6.5).
+     * Delegates to `_selection.allSelectedInCurrentPage` (the `$derived`
+     * chain and the async-result cache live there).
      */
     get allSelectedInCurrentPage(): boolean;
     /**
-     * Delegating getter preserved for backwards compatibility. Reads
-     * through to `_selection.allHighlighted`; the value is published by
-     * the `_allHighlightedEffect` below which lives on this class
-     * because it reads `paginationRepo.pageStartIndex` / `pageEndIndexExclusive`
-     * directly.
+     * Delegates to `_selection.allHighlighted`. The value is published
+     * by the `_allHighlightedEffect` below (which lives on this class
+     * because it reads `paginationRepo.pageStartIndex` /
+     * `pageEndIndexExclusive` directly).
      */
     get allHighlighted(): boolean;
-    /**
-     * Delegating getter preserved for backwards compatibility. The
-     * `$derived` lives on `_selection.hasHighlightedItems` (Phase 6.5).
-     */
+    /** Delegates to `_selection.hasHighlightedItems`. */
     get hasHighlightedItems(): boolean;
     /**
-     * Delegating accessors preserved for backwards compatibility. The
-     * `$state` slots live on `_selection` (Phase 6.5). `selectedItems`
-     * is read-only at this surface; the consumer-facing writers are
-     * `toggleSelected` / `setSelected` / `resetSelectedItems` /
-     * `setSelectionMap` below.
+     * Delegates to `_selection.selectedItems`. Read-only at this surface;
+     * the public writers are `toggleSelected` / `setSelected` /
+     * `resetSelectedItems` / `setSelectionMap` below.
      */
     get selectedItems(): SvelteMap<RowIdType, T>;
     get invalidValues(): SvelteMap<RowIdType, T>;
@@ -287,22 +248,18 @@ export declare class TableContext<T extends object, RowIdType extends Primitive>
     get hasInvalidSelectedItems(): boolean;
     private set hasInvalidSelectedItems(value);
     /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * id->def lookup map is owned by `_columnLayout.columnDefsById`
-     * (Phase 6.3); previously this was a `$derived` private field on
-     * `TableContext`. Made `public get` (instead of the previous
-     * `private` field) so the dependent sub-contexts (`SortingState`)
-     * and helpers (`generateTableOptions`) can read it through the
-     * legacy surface without piercing the sub-context boundary.
+     * Delegates to `_columnLayout.columnDefsById`. `public get` (rather
+     * than a private field) so dependent sub-contexts (`SortingState`)
+     * and helpers (`generateTableOptions`) can read it without piercing
+     * the sub-context boundary.
      */
     get columnDefsById(): ReadonlyMap<string, ColumnDef<T>>;
     /**
-     * Phase 6.3 sub-context that owns the column-layout state:
-     * `columnDefs`, `columnSizing`, `columnPinning`, `columnVisibility`,
-     * the `columnDefsById` reverse-lookup map, the `visualColumns`
-     * cached array (and the paired `visualColumnIndexById` O(1) lookup),
-     * the gated `setColumnPinning` updater, the `updateDefsBasedOnPinning`
-     * helper, and the `setNewPinningState` helper.
+     * Column-layout sub-context: `columnDefs`, `columnSizing`,
+     * `columnPinning`, `columnVisibility`, the `columnDefsById`
+     * reverse-lookup map, the `visualColumns` cached array (and paired
+     * `visualColumnIndexById` O(1) lookup), the gated `setColumnPinning`
+     * updater, `updateDefsBasedOnPinning`, and `setNewPinningState`.
      *
      * Dependencies are passed as thunks so the sub-context never holds
      * a reference to the parent. The `allowColumnReordering` thunk
@@ -311,101 +268,99 @@ export declare class TableContext<T extends object, RowIdType extends Primitive>
      */
     readonly _columnLayout: ColumnLayoutState<T>;
     /**
-     * Phase 6.2 sub-context that owns the filtering-related state: the
-     * per-row filter result (`filteredIndices`), the `filteredData`
-     * derived chain, the user-facing toggles (`showQuickFiltering`,
-     * `showSelectedOnly`), the per-type `FilterFn` relays, the
-     * remote-filter slot, and the `updateFilters` `OnChangeFn` slot.
+     * Filtering sub-context: per-row filter result
+     * (`filteredIndices`), the `filteredData` derived chain, user-facing
+     * toggles (`showQuickFiltering`, `showSelectedOnly`), the per-type
+     * `FilterFn` relays, the remote-filter slot, and the `updateFilters`
+     * `OnChangeFn` slot.
      *
-     * Dependencies are passed as thunks so the sub-context never holds
-     * a reference to the parent; the population effect for
-     * `_filteredIndices` stays in `TableContext` because it calls
-     * `this.createRow` (parent concern) - the effect publishes its
+     * Dependencies are thunks so the sub-context never holds a parent
+     * reference. The population effect for `_filteredIndices` lives on
+     * `TableContext` because it calls `this.createRow`; it publishes its
      * result via `this._filtering.setFilteredIndices`.
      */
     readonly _filtering: FilteringState<T>;
     /**
-     * Delegating getter preserved for backwards compatibility. Reads
-     * through to `_filtering.filteredIndices`, which is populated by
-     * the per-row filter `$effect` in this class (the effect calls
-     * `this.createRow` and must stay where `createRow` lives).
+     * Delegates to `_filtering.filteredIndices`. Populated by the per-row
+     * filter `$effect` in this class (which calls `this.createRow` and
+     * must stay where `createRow` lives).
      */
     get filteredIndices(): ReadonlyArray<number>;
     /**
-     * Delegating getter preserved for backwards compatibility. Reads
-     * through to `_filtering.filteredData`, which owns the local /
+     * Delegates to `_filtering.filteredData`, which owns the local /
      * remote / show-selected-only branching.
      */
     get filteredData(): Array<T>;
     /**
-     * Phase 6.1 sub-context that owns the sort-related derived chain and
-     * the per-`ColumnDef` comparator dispatch. The dependency thunks
-     * close over `this.columnDefsById` / `this.filteredData` /
-     * `this.dataRepo` / `this.paginationRepo` / `this.debug`, so the
-     * sub-context never holds a direct reference to the parent and the
-     * reactivity graph remains threaded through `$derived` only.
+     * Typeahead-echo cache for QuerySelect-backed filter inputs. Keyed by
+     * `ColumnDef` so reads and writes cannot diverge on the key (a recurring
+     * regression from the legacy `Map<string, unknown>` shape). See
+     * `QueryValuesState` for the rationale.
+     */
+    readonly _queryValues: QueryValuesState<T>;
+    /** Public alias for `_queryValues`, used by filter input components. */
+    get queryValues(): QueryValuesState<T>;
+    /**
+     * Sort sub-context: owns the sort-related derived chain and the
+     * per-`ColumnDef` comparator dispatch. Dependency thunks close over
+     * `this.columnDefsById` / `this.filteredData` / `this.dataRepo` /
+     * `this.paginationRepo` / `this.debug`, so the sub-context never
+     * holds a parent reference and reactivity stays in `$derived`.
      *
-     * Exposed as a public field so future consumers can read sorting
-     * state directly; the legacy `sortedData` getter below preserves the
-     * pre-decomposition surface for backwards compatibility.
+     * Public field so consumers can read sorting state directly; the
+     * `sortedData` getter below preserves the legacy surface.
      */
     readonly _sorting: SortingState<T>;
     /**
-     * Phase 6.4 sub-context that owns every persistence / preferences
-     * concern previously held directly on `TableContext`:
+     * Persistence / preferences sub-context:
      *
-     * - the saved column-presets list and currently-selected preset
+     * - saved column-presets list and currently-selected preset
      *   (`columnPresets`, `selectedPreset`);
-     * - the `userIdSegment` `$derived` (used to namespace every
+     * - `userIdSegment` `$derived` (namespaces every
      *   `scoria-table:<user>:<tableName>:<suffix>` storage key);
-     * - the `saveColumnPreset` / `setSelectedPreset` writers (which
-     *   apply the layout AND persist);
-     * - the `loadPresets` / `loadSelectedPresetName` /
-     *   `loadSavedSettings` boot-time hydration helpers;
-     * - the `persistSettings` writer used by the in-app settings
-     *   toggles (`setIsCompact`, `setAlternateRowColours`, etc.);
-     * - the schema-validation typeguards (exported alongside the
-     *   sub-context for unit testing).
+     * - `saveColumnPreset` / `setSelectedPreset` writers (apply layout
+     *   AND persist);
+     * - `loadPresets` / `loadSelectedPresetName` / `loadSavedSettings`
+     *   boot-time hydration helpers;
+     * - `persistSettings` writer used by the in-app settings toggles
+     *   (`setIsCompact`, `setAlternateRowColours`, etc.);
+     * - schema-validation typeguards (exported alongside the sub-context
+     *   for unit testing).
      *
      * The settings fields themselves (`isCompact`, `singleClickEditing`,
      * `alternateRowColours`, etc.) stay on `TableContext` because each
-     * one drives reactive UI; only the localStorage round-trip moved.
-     * `TableContext` retains delegating getters/setters/methods for
-     * every legacy surface (`columnPresets`, `selectedPreset`,
-     * `saveColumnPreset`, `setSelectedPreset`, `setIsCompact`, etc.).
+     * drives reactive UI; only the localStorage round-trip lives here.
+     * Delegating getters / setters / methods on `TableContext` cover the
+     * full surface (`columnPresets`, `selectedPreset`, `saveColumnPreset`,
+     * `setSelectedPreset`, `setIsCompact`, etc.).
      */
     readonly _preferences: PreferencesState<T>;
     /**
-     * Phase 6.5 sub-context that owns every selection + highlighting +
-     * key-cache concern previously held directly on `TableContext`:
+     * Selection + highlighting + key-cache sub-context:
      *
      * - `selectedItems` / `invalidValues` / `highlightedItems`
      *   (`SvelteMap` slots, keyed by `selectionExtractor(item)`);
-     * - the `WeakMap<T, RowIdType>` key-cache that memoises the
-     *   extractor result for each row reference;
-     * - the pending-flush buffer and its debounced microtask
+     * - `WeakMap<T, RowIdType>` key-cache memoising the extractor result
+     *   per row reference;
+     * - pending-flush buffer and its debounced microtask
      *   (`_pendingSelectionChanges` -> `tick().then(flush)`);
-     * - the `allSelectedInCurrentPage` `$derived` (with the async-
-     *   result cache for promise-returning `selectionExtractor` /
+     * - `allSelectedInCurrentPage` `$derived` (with the async-result
+     *   cache for promise-returning `selectionExtractor` /
      *   `RowSelectionDef.isSelectable`);
-     * - the `selectAllInCurrentPage` / `updateSelectedItems` /
+     * - `selectAllInCurrentPage` / `updateSelectedItems` /
      *   `onHighlightAll` flows;
-     * - the `handleItemMutation` split that powers the parent's
-     *   `onEditCell` - the sub-context owns the key-cache delete +
-     *   selection rebind; the user-supplied callback stays on this
-     *   class.
+     * - `handleItemMutation` split that powers the parent's `onEditCell`:
+     *   the sub-context owns the key-cache delete + selection rebind; the
+     *   user-supplied callback stays on this class.
      *
-     * Dependencies are passed as thunks so the sub-context never holds
-     * a direct reference to `TableContext`. The two `$effect`s that
-     * historically lived on this class continue to live here (they
-     * read `paginationRepo` directly) but publish their results
-     * through `_selection.setAllHighlighted(...)` and
-     * `_selection.updateSelectedItems()`.
+     * Dependencies are thunks so the sub-context never holds a parent
+     * reference. The two `$effect`s that read `paginationRepo` directly
+     * stay on `TableContext` and publish via `_selection.setAllHighlighted`
+     * and `_selection.updateSelectedItems`.
      */
     readonly _selection: SelectionState<T, RowIdType>;
     /**
-     * Phase 6.6 sub-context that owns every focus + keyboard-navigation
-     * concern previously held directly on `TableContext`:
+     * Focus + keyboard-navigation sub-context:
      *
      * - `focusStart` / `focusEnd` / `focusStartIsBeingEdited` /
      *   `isMousingDown` (the `$state` slots that define the focused
@@ -435,25 +390,23 @@ export declare class TableContext<T extends object, RowIdType extends Primitive>
      * because it reads `paginationRowModel` + `_visualColumns` directly;
      * it calls `_focus.setFocusedDerived(rows, cols)` to publish.
      *
-     * Group 2 Item C (per-cell `TableFocusDetails` reuse cache) is
-     * deferred for Phase 6.6 - see the class-level JSDoc on
-     * `FocusState` for the deferral rationale.
+     * Per-cell `TableFocusDetails` reuse cache is deferred; see the
+     * class-level JSDoc on `FocusState` for the rationale.
      */
     readonly _focus: FocusState<T>;
     /**
-     * Phase 7.4 row-virtualisation sub-context. Owns the visible-row
-     * window plus the top / bottom spacer-height derived chain that
-     * `TableBody.svelte` renders. Threshold defaults to 100 rows
-     * (below that the legacy code path renders every row directly);
-     * overscan defaults to 10 rows above and below the viewport so a
-     * fast flick of the wheel does not surface a blank band before
-     * the next paint.
+     * Row-virtualisation sub-context. Owns the visible-row window plus
+     * the top / bottom spacer-height derived chain that
+     * `TableBody.svelte` renders. Below the 100-row threshold every row
+     * is rendered directly; above it, overscan rows above and below the
+     * viewport stay rendered so a fast wheel flick does not surface a
+     * blank band.
      *
-     * Dependencies are thunks - the sub-context reads
-     * `paginationRowModel.rows` through `getRows`, the max-side
-     * observed height from the `_columnLayout` row-height pool
-     * through `getRowHeight`, and the per-table-density estimate
-     * through `getEstimatedRowHeight`.
+     * Dependencies are thunks: `getRows` reads
+     * `paginationRowModel.rows`, `getRowHeight` returns the max-side
+     * observed height from the row-height pool (currently a no-op
+     * pending re-introduction), and `getEstimatedRowHeight` returns the
+     * per-table-density estimate.
      */
     /**
      * Rendered widths of header cells, keyed by columnId. TableHead
@@ -471,12 +424,8 @@ export declare class TableContext<T extends object, RowIdType extends Primitive>
     readonly _columnRenderedWidths: SvelteMap<string, number>;
     readonly _virtualisation: VirtualisationState<T>;
     /**
-     * Delegating getter preserved for backwards compatibility. Reads
-     * through to `_sorting.sortedData`, which owns the comparator-hoist
-     * optimisation and the `AbortController` short-circuit. Consumers
-     * inside `src/lib` already point at `tableContext.sortedData`; the
-     * delegation will be removed once Phase 6 v-next migrates every
-     * reader to `tableContext._sorting.sortedData` directly.
+     * Delegates to `_sorting.sortedData`, which owns the comparator-hoist
+     * optimisation and the `AbortController` short-circuit.
      */
     get sortedData(): Array<T>;
     private _sortedRowModel;
@@ -489,20 +438,17 @@ export declare class TableContext<T extends object, RowIdType extends Primitive>
     private _paginationRowModel;
     get paginationRowModel(): RowModel<T>;
     /**
-     * Delegating wrapper preserved for backwards compatibility. The
-     * key-extraction cache lives on `_selection` (Phase 6.5); this
-     * method forwards to `_selection.cachedKey(item)` so legacy call
-     * sites in `getHighlightedRowData` / `getFocusElementData` /
-     * `originalRowIndices` / `sortedRowModel` / `onHighlightAll` see
-     * no behavioural change.
+     * Forwards to `_selection.cachedKey(item)` (the key-extraction cache
+     * lives there). Used by `getHighlightedRowData` /
+     * `getFocusElementData` / `originalRowIndices` / `sortedRowModel` /
+     * `onHighlightAll`.
      */
     private _cachedKey;
-    /** Delegating accessor preserved for backwards compatibility. The
-     *  implementation lives on `_selection.selectionContains` (Phase 6.5). */
+    /** Delegates to `_selection.selectionContains`. */
     readonly selectionContains: (item: T) => boolean | Promise<boolean>;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_selection.addInvalidValue`. */
     readonly addInvalidValue: (item: T) => void | Promise<void>;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_selection.removeInvalidValue`. */
     readonly removeInvalidValue: (item: T) => void | Promise<void>;
     /**
      * Stores or clears the cell whose per-cell modal is currently open.
@@ -516,23 +462,23 @@ export declare class TableContext<T extends object, RowIdType extends Primitive>
         row: T;
         columnId: string;
     } | null) => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly toggleHighlightedRow: (item: T) => void | Promise<void>;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly resetHighlightedRows: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly toggleSelected: (item: T) => void | Promise<void>;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly setSelected: (item: T, selected: boolean) => void | Promise<void>;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     setSelectionMap: (set: SvelteMap<RowIdType, T>) => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly updateSelectedItems: () => Promise<void>;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly resetSelectedItems: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly selectAllInCurrentPage: () => Promise<void>;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly onHighlightAll: () => void | Promise<void>;
     /**
      * Invoked by every editable cell on commit. Split between this
@@ -544,11 +490,10 @@ export declare class TableContext<T extends object, RowIdType extends Primitive>
      */
     readonly onEditCell: (item: T, coords: CellCoordinates, value: unknown) => Promise<void>;
     /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * implementation lives on `_focus.handleTdKeydown` (Phase 6.6).
-     * Bound to the root `<table>` container's `onkeydown` listener;
-     * routes Ctrl+F / Escape / Tab synchronously and dispatches the
-     * arrow-key / Home / End / Ctrl+A / Ctrl+C path asynchronously.
+     * Delegates to `_focus.handleTdKeydown`. Bound to the root
+     * `<table>` container's `onkeydown` listener; routes Ctrl+F /
+     * Escape / Tab synchronously and dispatches the arrow-key / Home /
+     * End / Ctrl+A / Ctrl+C path asynchronously.
      */
     readonly handleTdKeydown: (e: KeyboardEvent) => void;
     /** Toggles quick-filtering visibility and refocuses the matching cell. */
@@ -559,12 +504,7 @@ export declare class TableContext<T extends object, RowIdType extends Primitive>
      * enforces the `allowColumnReordering` master gate.
      */
     readonly setColumnPinning: (updater: Updater<ColumnPinningState>) => void;
-    /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * actual `$state` slot lives on `_filtering`; this getter / setter
-     * pair forwards reads and writes so existing consumers (notably
-     * `generateTableOptions`) need no migration.
-     */
+    /** Delegates to `_filtering.updateFilters`. */
     get updateFilters(): OnChangeFn<ColumnFiltersState> | undefined;
     set updateFilters(v: OnChangeFn<ColumnFiltersState> | undefined);
     updateVisibility: OnChangeFn<VisibilityState>;
@@ -588,56 +528,53 @@ export declare class TableContext<T extends object, RowIdType extends Primitive>
      * reordering is disabled or indices are out of range / unchanged.
      */
     moveColumnTo: (currentIndex: number, newIndex: number) => void;
-    /** Copies the highlighted rows to the OS clipboard as TSV / CSV. */
+    /** Delegates to `_clipboard.copyHighlightedRowsToClipboard`. */
     copyHighlightedRowsToClipboard: () => Promise<void>;
-    /** Copies the currently focused cell range to the OS clipboard. */
+    /** Delegates to `_clipboard.copyDataToClipboard`. */
     copyDataToClipboard: () => Promise<void>;
-    private _performRowCopy;
-    /** Delegating accessor preserved for backwards compatibility. The
-     *  implementation lives on `_focus.startFocus` (Phase 6.6). */
+    /** Delegates to `_focus.startFocus`. */
     readonly startFocus: (coords: CellCoordinates) => void;
-    /** Delegating accessor preserved for backwards compatibility. The
-     *  implementation lives on `_focus.moveFocus` (Phase 6.6). */
+    /** Delegates to `_focus.moveFocus`. */
     readonly moveFocus: (coords: CellCoordinates, startEditing?: boolean) => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly unfocus: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly focusToTop: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly focusToBottom: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly moveToBottom: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly moveToTop: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly moveFocusUp: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly setFocusUp: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly tabForward: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly tabBackward: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly focusToStart: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly moveToStart: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly focusToEnd: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly moveToEnd: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly moveFocusDown: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly setFocusDown: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly moveFocusLeft: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly setFocusLeft: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly moveFocusRight: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly setFocusRight: () => void;
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     readonly endFocus: (coords: CellCoordinates) => void;
     /** Toggles compact row sizing and persists to localStorage. */
     readonly setIsCompact: (value: boolean) => void;
@@ -652,49 +589,41 @@ export declare class TableContext<T extends object, RowIdType extends Primitive>
     /** Toggles CSV vs TSV copy-to-clipboard separator and persists. */
     readonly setCommaSeparatedCopy: (value: boolean) => void;
     /**
-     * Delegating method preserved for backwards compatibility. Applies
-     * the preset to the live column layout, forwards the preset's
-     * `sortingState` to the data-repository updater, and persists the
-     * selected name. The underlying implementation lives on
-     * `_preferences.setSelectedPreset` (Phase 6.4).
+     * Applies the preset to the live column layout, forwards the
+     * preset's `sortingState` to the data-repository updater, and
+     * persists the selected name. Delegates to
+     * `_preferences.setSelectedPreset`.
      *
-     * The pre-extraction debug warning ("no sorting state found") was
-     * emitted unconditionally when `paginationRepo.updateSorting` was
-     * absent; the sub-context skips that warning because the
-     * `applySortingState` thunk already no-ops in that case. The
-     * warning is reinstated below so the surface is byte-identical.
+     * The "no sorting state found" debug warning is emitted here (not
+     * inside the sub-context) so the public surface stays byte-identical
+     * - `_preferences.applySortingState` already no-ops when
+     * `paginationRepo.updateSorting` is absent.
      */
     readonly setSelectedPreset: (preset: ColumnDefSet<T>) => void;
     /**
-     * Delegating method preserved for backwards compatibility. Adds or
-     * replaces a saved preset for the current column layout and
+     * Adds or replaces a saved preset for the current column layout and
      * persists the full preset list to localStorage. Delegates to
-     * `_preferences.saveColumnPreset` (Phase 6.4).
+     * `_preferences.saveColumnPreset`.
      */
     readonly saveColumnPreset: (name: string) => void;
     /**
-     * This listener should be added and removed based on isMousingDown
+     * Delegates to `_focus.setFocusEnd`. This listener should be added
+     * and removed based on `isMousingDown`.
      */
-    /** Delegating accessor preserved for backwards compatibility. The
-     *  implementation lives on `_focus.setFocusEnd` (Phase 6.6). */
     readonly setFocusEnd: (coords: CellCoordinates) => void;
     private createRow;
-    private columnDefReturnsTextValue;
     /**
-     * Builds the user-controlled settings blob from the current
-     * `$state` slots and delegates the actual `localStorage.setItem`
-     * call to `_preferences.persistSettings` (Phase 6.4). The settings
-     * field set (`isCompact`, `singleClickEditing`, etc.) still lives
-     * on `TableContext` because each one drives reactive UI; only the
-     * persistence side of the boundary moved.
+     * Build the user-controlled settings blob from the current `$state`
+     * slots and delegate the `localStorage.setItem` call to
+     * `_preferences.persistSettings`. The settings fields themselves
+     * live on `TableContext` because each drives reactive UI; only the
+     * persistence boundary lives in the sub-context.
      */
     private _updateLocalStorageSettings;
     /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * cached visual-column array and its paired O(1) id->index map now
-     * live on `_columnLayout` (Phase 6.3). The underscore prefix is
-     * preserved on `TableContext` to keep the existing read sites in
-     * `tabForward` / `focusToStart` / `moveFocusLeft` / etc. untouched.
+     * Delegates to `_columnLayout.visualColumns`. The underscore prefix
+     * is preserved so the existing read sites in `tabForward` /
+     * `focusToStart` / `moveFocusLeft` / etc. stay untouched.
      */
     get _visualColumns(): Array<ColumnDef<T>>;
     /** Returns the visual index of the column with the given id, or
@@ -702,71 +631,29 @@ export declare class TableContext<T extends object, RowIdType extends Primitive>
      *  which provides the O(1) lookup. */
     columnVisualIndex(id: string): VisualColumnIndex;
     /**
-     * Delegating getter preserved for backwards compatibility. The
-     * implementation lives on `_focus.focusStartVisualColumn`
-     * (Phase 6.6); the visual-index lookup itself is owned by
-     * `_columnLayout.columnVisualIndex` (Phase 6.3).
+     * Delegates to `_focus.focusStartVisualColumn`; the visual-index
+     * lookup is owned by `_columnLayout.columnVisualIndex`.
      */
     get focusStartVisualColumn(): VisualColumnIndex;
-    /**
-     * Delegating getter preserved for backwards compatibility. The
-     * implementation lives on `_focus.focusEndVisualColumn`
-     * (Phase 6.6).
-     */
+    /** Delegates to `_focus.focusEndVisualColumn`. */
     get focusEndVisualColumn(): VisualColumnIndex;
-    private getHighlightedRowData;
-    private getFocusElementData;
     private updateDefsBasedOnPinning;
     private assertNoDuplicateIds;
     private setupDefaultColumnDefs;
     /**
-     * Reads the persisted per-table user-settings blob through
-     * `_preferences.loadSavedSettings` (Phase 6.4) and applies each
-     * field to the live `$state` slot. Field defaults mirror the
-     * pre-extraction behaviour:
+     * Read the persisted per-table user-settings blob through
+     * `_preferences.loadSavedSettings` and apply each field to the live
+     * `$state` slot. Field defaults:
      *
      * - missing slot: `singleClickEditing` defaults to `true`; every
      *   other field keeps its constructor default.
-     * - present slot: each field is applied if it would deviate from
+     * - present slot: a field is applied only if it would deviate from
      *   the constructor default (the "only alter when the user
-     *   explicitly disabled" semantics are preserved verbatim).
+     *   explicitly disabled it" semantic).
      */
     private _getUserDefaults;
     private _setNewPinningState;
     readonly getToggleSortingHandler: (def: ColumnDef<T>) => () => void;
     private reassignDefsToPresets;
 }
-export declare function isSearchable<T extends object, FilterValueType, FilterOptionsType, CD extends ColumnDef<T, FilterValueType, FilterOptionsType>>(def: CD): def is CD & HasCustomFilterFunction;
-/**
- * Neutralises CSV / TSV formula-injection prefixes recognised by Excel,
- * LibreOffice Calc, Google Sheets, and Apple Numbers.
- *
- * When a clipboard payload reaches a spreadsheet, any cell whose first
- * character is one of `=`, `+`, `-`, `@`, `\t`, `\r` is treated as a
- * formula and evaluated in the user's context. Untrusted row data
- * containing `=cmd|'/c calc'!A1` (or DDE / web-query equivalents) is the
- * canonical attack vector. Prefixing such a value with a single quote
- * (`'`) makes the spreadsheet interpret the cell as a literal string
- * instead.
- *
- * Trade-off: the leading apostrophe is invisible in the rendered cell of
- * every major spreadsheet, but the underlying cell value differs from the
- * source when read back by another formula referencing the cell. This is
- * the accepted industry mitigation (OWASP CSV Injection cheat sheet).
- *
- * Private helper - keep this colocated with `encapsulate` so every
- * clipboard-bound string flows through both functions before being
- * written to the OS clipboard.
- */
-declare function escapeForSpreadsheet(value: string): string;
-declare function encapsulate(value: string): string;
-/**
- * Internal exports for tests. Not part of the public API; do not import
- * from consumer code. Allows the clipboard formula-escape regression test
- * to call the module-private helpers directly.
- */
-export declare const _internal: {
-    escapeForSpreadsheet: typeof escapeForSpreadsheet;
-    encapsulate: typeof encapsulate;
-};
-export {};
+export declare function isSearchable<T extends object, FilterValueType, CD extends ColumnDef<T, FilterValueType>>(def: CD): def is CD & HasCustomFilterFunction;