@lavalogic/scoria 0.37.44 → 0.37.45

package/dist/Components/Table/Types/Context/TableContext.svelte.js

@@ -1,20 +1,15 @@
 import { browser, dev } from '$app/environment';
 import { asyncAll, asyncMap, devCatch, getCanvasContext, isKeyOf, } from '../../../../Helpers/Helpers.svelte.js';
+import { COLUMN_KIND_REGISTRY, resolveDefaultFilter, } from '../../ColumnKindRegistry.js';
+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 { tick, untrack } from 'svelte';
 import { SvelteMap } from 'svelte/reactivity';
 import { ColumnType } from '../Columns/ColumnType.js';
 import { AccessorDef } from '../Columns/Definitions/Accessors/AccessorDef.svelte.js';
-import { CheckboxDef } from '../Columns/Definitions/Accessors/CheckboxDef.svelte.js';
-import { DateInputDef } from '../Columns/Definitions/Accessors/DateInputDef.svelte.js';
 import { NumberInputDef } from '../Columns/Definitions/Accessors/NumberInputDef.svelte.js';
-import { SelectDef } from '../Columns/Definitions/Accessors/SelectDef.svelte.js';
-import { TextInputDef } from '../Columns/Definitions/Accessors/TextInputDef.svelte.js';
-import { BubbleDef } from '../Columns/Definitions/Display/BubbleDef.svelte.js';
-import { DisplayDef } from '../Columns/Definitions/Display/DisplayDef.svelte.js';
-import { ProgressBarDef } from '../Columns/Definitions/Display/ProgressBarDef.svelte.js';
-import { RowSelectionDef } from '../Columns/Definitions/RowSelection/RowSelectionDef.svelte.js';
 import { SortingState } from './SortingState.svelte.js';
 import { FilteringState } from './FilteringState.svelte.js';
 import { ColumnLayoutState } from './ColumnLayoutState.svelte.js';
@@ -24,13 +19,6 @@ import { PaginationType } from '../Pagination/PaginationType.js';
 import { ToolbarPosition } from '../Toolbar/ToolbarPosition.js';
 const SORTING_ICON_WIDTH = 24;
 const InternalSymbol = Symbol();
-const uncopyableColumns = new Set([
-    // RowSelect column is a special case and is handled by tableContext directly
-    ColumnType.Expand,
-    ColumnType.Actions,
-    ColumnType.FilterOnly,
-    ColumnType.Custom,
-]);
 /**
  * Default values applied by `TableContext.init` for any `TableInitOptions`
  * field the consumer omits. Frozen so callers (notably `NestedTable`)
@@ -76,16 +64,12 @@ export class TableContext {
      */
     static init(defaultColumnDefs, tableName, dataRepo, options) {
         const context = new this(InternalSymbol, defaultColumnDefs, tableName, dataRepo, options.allowCopy ?? DEFAULT_TABLE_INIT_OPTIONS.allowCopy, options.enableResize ?? DEFAULT_TABLE_INIT_OPTIONS.enableResize, options.allowColumnReordering ?? DEFAULT_TABLE_INIT_OPTIONS.allowColumnReordering, options.allowQuickFiltering ?? DEFAULT_TABLE_INIT_OPTIONS.allowQuickFiltering, options.showQuickFilterByDefault ?? DEFAULT_TABLE_INIT_OPTIONS.showQuickFilterByDefault, options.allowAdvancedFiltering ?? DEFAULT_TABLE_INIT_OPTIONS.allowAdvancedFiltering, options.toolbar ?? DEFAULT_TABLE_INIT_OPTIONS.toolbar, options.displayFooter ?? DEFAULT_TABLE_INIT_OPTIONS.displayFooter, 
-        // Fallback identity extractor when no `selectionExtractor`
-        // is supplied. The nested-table call path (see
-        // `ColumnFactory.expand`) always passes one through, but
-        // other consumers may construct an options object directly
-        // without it. Returning the row object itself preserves
-        // row identity (the cell wrappers use reference equality
-        // via the keying cache) and avoids the
-        // `tableContext.selectionExtractor is not a function`
-        // crash inside `SelectionState.cachedKey` /
-        // `TableRow.svelte`'s id-resolution effect.
+        // Fallback identity extractor when no `selectionExtractor` is
+        // supplied (some consumers build an options object directly
+        // without one). Returning the row object preserves identity
+        // (cell wrappers compare by reference via the keying cache)
+        // and avoids the `selectionExtractor is not a function` crash
+        // inside `SelectionState.cachedKey` and `TableRow.svelte`.
         options.selectionExtractor ?? ((row) => row), options.getUserId, options.onEditCell, options.debug ?? DEFAULT_TABLE_INIT_OPTIONS.debug);
         return context;
     }
@@ -276,22 +260,17 @@ export class TableContext {
                 if (current !== latest_sortedRowModel) {
                     throw new Error(`stale data`);
                 }
-                // Do NOT throw when `originalIndex` is missing. The
-                // `originalRowIndices` effect and this one both
-                // re-derive asynchronously on `dataRepo.data`
-                // changes; when a row is added (e.g. the
-                // auto-pushed empty pod line that fires after a
-                // user picks an SKU), the sortedRowModel rebuild
-                // can win the race and run against a still-stale
-                // `ori` map that does not yet contain the new
-                // row's key. The previous `throw` rejected the
-                // `Promise.all` for the entire rebuild, which
-                // left `_sortedRowModel` pinned to the pre-edit
-                // snapshot and stopped editable cells from
-                // reflecting their post-edit state - the visible
-                // symptom on Receipt's SKU cell. Falling back to
-                // `unsortedIndex = index` is a fine approximation
-                // for the missing entry; the next reactive pass
+                // Do NOT throw when `originalIndex` is missing.
+                // `originalRowIndices` and the sortedRowModel
+                // rebuild re-derive asynchronously on
+                // `dataRepo.data` changes; on a row addition the
+                // sortedRowModel can win the race and run against
+                // a still-stale `ori` map. Throwing would reject
+                // the whole `Promise.all` and pin
+                // `_sortedRowModel` to the pre-edit snapshot, so
+                // editable cells would not reflect post-edit
+                // state. Falling back to `unsortedIndex = index`
+                // is a fine approximation; the next reactive pass
                 // (after `originalRowIndices` catches up) refines
                 // it.
                 return this.createRow(item, index, unsortedIndex);
@@ -436,10 +415,8 @@ export class TableContext {
         this._paginationRepo = v;
     }
     /**
-     * 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() {
         return this._filtering.showQuickFiltering;
@@ -455,19 +432,15 @@ export class TableContext {
         this._dataRepo = v;
     }
     /**
-     * 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() {
         return this._filtering.remoteFilters;
     }
     /**
-     * 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() {
         return this._filtering.showSelectedOnly;
@@ -476,11 +449,8 @@ export class TableContext {
         this._filtering.showSelectedOnly = v;
     }
     /**
-     * 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() {
         return this._filtering.dateFilter;
@@ -511,12 +481,7 @@ export class TableContext {
     set dragTarget(v) {
         this._dragTarget = v;
     }
-    /**
-     * 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() {
         return this._columnLayout.columnDefs;
     }
@@ -524,21 +489,15 @@ export class TableContext {
         this._columnLayout.columnDefs = v;
     }
     /**
-     * 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() {
         return this._preferences.columnPresets;
     }
-    /**
-     * 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() {
         return this._preferences.selectedPreset;
     }
@@ -546,33 +505,22 @@ export class TableContext {
         this._preferences.selectedPreset = v;
     }
     /**
-     * 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() {
         return this._focus.focusedRowIndices;
     }
-    /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * actual `$state` slot lives on `_selection._highlightedItems`
-     * (Phase 6.5).
-     */
+    /** Delegates to `_selection._highlightedItems`. */
     get highlightedItems() {
         return this._selection.highlightedItems;
     }
-    /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * `$state` slot lives on `_focus._focusedColumnIds` (Phase 6.6).
-     */
+    /** Delegates to `_focus._focusedColumnIds`. */
     get focusedColumnIds() {
         return this._focus.focusedColumnIds;
     }
-    /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * `$state` slot lives on `_focus._isMousingDown` (Phase 6.6).
-     */
+    /** Delegates to `_focus._isMousingDown`. */
     get isMousingDown() {
         return this._focus.isMousingDown;
     }
@@ -580,30 +528,22 @@ export class TableContext {
         this._focus.isMousingDown = v;
     }
     /**
-     * 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() {
         return this._focus.focusStart;
     }
-    /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * `$state` slot lives on `_focus._focusStartIsBeingEdited`
-     * (Phase 6.6).
-     */
+    /** Delegates to `_focus._focusStartIsBeingEdited`. */
     get focusStartIsBeingEdited() {
         return this._focus.focusStartIsBeingEdited;
     }
     set focusStartIsBeingEdited(v) {
         this._focus.focusStartIsBeingEdited = v;
     }
-    /**
-     * Delegating accessor preserved for backwards compatibility. The
-     * `$state` slot lives on `_focus._focusEnd` (Phase 6.6).
-     */
+    /** Delegates to `_focus._focusEnd`. */
     get focusEnd() {
         return this._focus.focusEnd;
     }
@@ -638,23 +578,48 @@ export class TableContext {
     set alternateRowColours(v) {
         this._alternateRowColours = v;
     }
-    _copyWithHeaders = $state(true);
+    /**
+     * 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.
+     */
+    _clipboard = new ClipboardState({
+        getColumnDefs: () => this.columnDefs,
+        getColumnVisibility: () => this.columnVisibility,
+        getHighlightedItems: () => this.highlightedItems,
+        getSelectedItems: () => this.selectedItems,
+        getSortedData: () => this.sortedData,
+        getCurrentPageData: () => this.currentPageData,
+        getPaginationRowModel: () => this.paginationRowModel,
+        getVisualColumns: () => this._visualColumns,
+        getFocusStart: () => this.focusStart,
+        getFocusEnd: () => this.focusEnd,
+        cachedKey: (item) => this._cachedKey(item),
+        columnVisualIndex: (id) => this.columnVisualIndex(id),
+        getAllowCopy: () => this.allowCopy,
+        persistSettings: () => {
+            this._updateLocalStorageSettings();
+        },
+    });
+    /** Delegates to `_clipboard.copyWithHeaders`. */
     get copyWithHeaders() {
-        return this._copyWithHeaders;
+        return this._clipboard.copyWithHeaders;
     }
     set copyWithHeaders(v) {
-        this._copyWithHeaders = v;
+        this._clipboard.copyWithHeaders = v;
     }
-    _commaSeparatedCopy = $state(false);
+    /** Delegates to `_clipboard.commaSeparatedCopy`. */
     get commaSeparatedCopy() {
-        return this._commaSeparatedCopy;
+        return this._clipboard.commaSeparatedCopy;
     }
     set commaSeparatedCopy(v) {
-        this._commaSeparatedCopy = v;
+        this._clipboard.commaSeparatedCopy = v;
     }
     /**
-     * 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.
      */
@@ -665,8 +630,7 @@ export class TableContext {
         this._columnLayout.columnSizing = v;
     }
     /**
-     * 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).
@@ -678,8 +642,7 @@ export class TableContext {
         this._columnLayout.columnPinning = v;
     }
     /**
-     * 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() {
@@ -693,13 +656,12 @@ export class TableContext {
      * `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.
      */
     _openModalCell = $state(null);
     get openModalCell() {
@@ -708,10 +670,9 @@ export class TableContext {
     set openModalCell(v) {
         this._openModalCell = v;
     }
-    // Per-table identifier of the ActionsCell that currently has its popup open.
-    // Lives on the context rather than at module scope so multiple tables on the
-    // same page do not share open-popup state (security: cross-table state
-    // poisoning).
+    // Per-table identifier of the ActionsCell that currently has its popup
+    // open. Lives on the context (NOT at module scope) so multiple tables
+    // on the same page do not share open-popup state.
     _shownActionsPopup = $state();
     get shownActionsPopup() {
         return this._shownActionsPopup;
@@ -720,36 +681,29 @@ export class TableContext {
         this._shownActionsPopup = v;
     }
     /**
-     * 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() {
         return this._selection.allSelectedInCurrentPage;
     }
     /**
-     * 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() {
         return this._selection.allHighlighted;
     }
-    /**
-     * Delegating getter preserved for backwards compatibility. The
-     * `$derived` lives on `_selection.hasHighlightedItems` (Phase 6.5).
-     */
+    /** Delegates to `_selection.hasHighlightedItems`. */
     get hasHighlightedItems() {
         return this._selection.hasHighlightedItems;
     }
     /**
-     * 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() {
         return this._selection.selectedItems;
@@ -768,24 +722,20 @@ export class TableContext {
         this._hasInvalidSelectedItems = v;
     }
     /**
-     * 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() {
         return this._columnLayout.columnDefsById;
     }
     /**
-     * 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
@@ -797,16 +747,15 @@ export class TableContext {
         getDebug: () => this.debug,
     });
     /**
-     * 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`.
      */
     _filtering = new FilteringState({
@@ -822,33 +771,40 @@ export class TableContext {
         getDebug: () => this.debug,
     });
     /**
-     * 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() {
         return this._filtering.filteredIndices;
     }
     /**
-     * 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() {
         return this._filtering.filteredData;
     }
     /**
-     * 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.
+     */
+    _queryValues = new QueryValuesState();
+    /** Public alias for `_queryValues`, used by filter input components. */
+    get queryValues() {
+        return this._queryValues;
+    }
+    /**
+     * 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.
      */
     _sorting = new SortingState({
         getColumnDefsById: () => this.columnDefsById,
@@ -859,28 +815,27 @@ export class TableContext {
         getDebug: () => this.debug,
     });
     /**
-     * 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.).
      */
     _preferences = new PreferencesState({
         getTableName: () => this.tableName,
@@ -904,31 +859,27 @@ export class TableContext {
         getDebug: () => this.debug,
     });
     /**
-     * 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`.
      */
     _selection = new SelectionState({
         getSortedData: () => this.sortedData,
@@ -941,8 +892,7 @@ export class TableContext {
         getDebug: () => this.debug,
     });
     /**
-     * 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
@@ -972,9 +922,8 @@ export class TableContext {
      * 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.
      */
     _focus = new FocusState({
         getAllowCopy: () => this.allowCopy,
@@ -996,26 +945,24 @@ export class TableContext {
             this.tabBackward();
         },
         getDebug: () => this.debug,
-        // Phase 7.1 Item C - `getFocusDetailsFor` needs the parent
-        // `TableContext` to construct `TableFocusDetails` on cache-miss.
-        // Pass via a thunk so the sub-context never closes over `this`
-        // at construction time.
+        // `getFocusDetailsFor` needs the parent `TableContext` to
+        // construct `TableFocusDetails` on cache miss. Pass via a thunk
+        // so the sub-context never closes over `this` at construction.
         getTableContextRef: () => this,
     });
     /**
-     * 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
@@ -1043,12 +990,8 @@ export class TableContext {
         getEstimatedRowHeight: () => (this.isCompact ? 28 : 48),
     });
     /**
-     * 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() {
         return this._sorting.sortedData;
@@ -1233,26 +1176,23 @@ export class TableContext {
     // #endregion
     // #region public methods
     /**
-     * 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`.
      */
     _cachedKey(item) {
         return this._selection.cachedKey(item);
     }
-    /** Delegating accessor preserved for backwards compatibility. The
-     *  implementation lives on `_selection.selectionContains` (Phase 6.5). */
+    /** Delegates to `_selection.selectionContains`. */
     selectionContains = (item) => {
         return this._selection.selectionContains(item);
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_selection.addInvalidValue`. */
     addInvalidValue = (item) => {
         return this._selection.addInvalidValue(item);
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_selection.removeInvalidValue`. */
     removeInvalidValue = (item) => {
         return this._selection.removeInvalidValue(item);
     };
@@ -1267,39 +1207,39 @@ export class TableContext {
     setOpenModalCell = (cell) => {
         this.openModalCell = cell ? { row: cell.row, columnId: cell.columnId } : null;
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     toggleHighlightedRow = (item) => {
         return this._selection.toggleHighlightedRow(item);
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     resetHighlightedRows = () => {
         this._selection.resetHighlightedRows();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     toggleSelected = (item) => {
         return this._selection.toggleSelected(item);
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     setSelected = (item, selected) => {
         return this._selection.setSelected(item, selected);
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     setSelectionMap = (set) => {
         this._selection.setSelectionMap(set);
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     updateSelectedItems = async () => {
         await this._selection.updateSelectedItems();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     resetSelectedItems = () => {
         this._selection.resetSelectedItems();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     selectAllInCurrentPage = async () => {
         await this._selection.selectAllInCurrentPage();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     onHighlightAll = () => {
         return this._selection.onHighlightAll();
     };
@@ -1317,11 +1257,10 @@ export class TableContext {
         });
     };
     /**
-     * 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.
      */
     handleTdKeydown = (e) => {
         this._focus.handleTdKeydown(e);
@@ -1352,12 +1291,7 @@ export class TableContext {
     setColumnPinning = (updater) => {
         this._columnLayout.setColumnPinning(updater);
     };
-    /**
-     * 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() {
         return this._filtering.updateFilters;
     }
@@ -1534,173 +1468,99 @@ export class TableContext {
         this.unfocus();
         this.columnDefs = newDefs;
     };
-    /** Copies the highlighted rows to the OS clipboard as TSV / CSV. */
-    copyHighlightedRowsToClipboard = async () => {
-        // NOTE: False Positive. Clipboard does not exist in http environments
-        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
-        if (!navigator.clipboard) {
-            alert('cannot copy in an insecure connection');
-            return;
-        }
-        return this._performRowCopy(await this.getHighlightedRowData());
+    /** Delegates to `_clipboard.copyHighlightedRowsToClipboard`. */
+    copyHighlightedRowsToClipboard = () => {
+        return this._clipboard.copyHighlightedRowsToClipboard();
     };
-    /** Copies the currently focused cell range to the OS clipboard. */
-    copyDataToClipboard = async () => {
-        // NOTE: False Positive. Clipboard does not exist in http environments
-        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
-        if (!navigator.clipboard) {
-            alert('cannot copy in an insecure connection');
-            return;
-        }
-        return this._performRowCopy(await this.getFocusElementData());
+    /** Delegates to `_clipboard.copyDataToClipboard`. */
+    copyDataToClipboard = () => {
+        return this._clipboard.copyDataToClipboard();
     };
-    _performRowCopy = async ({ items, indicesByItem, focusedElementData, affectedColumns, }) => {
-        const focusedColumnIds = affectedColumns.map((it) => encapsulate(typeof it.header === 'string' ? it.header : it.id));
-        const value = await (async () => {
-            // eslint-disable-next-line svelte/prefer-svelte-reactivity
-            const selectColumns = new Map();
-            for (let i = affectedColumns.length - 1; i > -1; i--) {
-                const columnDef = affectedColumns[i];
-                if (columnDef instanceof SelectDef) {
-                    const item = items[i];
-                    const defOptions = indicesByItem.get(item);
-                    selectColumns.set(i, await (defOptions
-                        ? (columnDef.getSpecificOptions?.(item, defOptions) ?? columnDef.getOptions())
-                        : columnDef.getOptions()));
-                }
-            }
-            const separator = this.commaSeparatedCopy ? ',' : '\t';
-            const shouldCopyHeaders = this.copyWithHeaders &&
-                (focusedElementData.length !== 1 || focusedElementData[0].length !== 1);
-            // transform to TSV
-            if (focusedElementData.length === 1 && focusedElementData[0].length === 1) {
-                if (selectColumns.has(0)) {
-                    const columnOptions = selectColumns.get(0);
-                    const value = columnOptions?.find((it) => it.value === focusedElementData[0][0])?.label ??
-                        focusedElementData[0][0]?.toString() ??
-                        '';
-                    // Single-cell copy bypasses TSV/CSV wrapping but still lands
-                    // in a spreadsheet; neutralise formula-injection prefixes.
-                    return escapeForSpreadsheet(value);
-                }
-                else {
-                    const value = focusedElementData[0][0]?.toString().trim() ?? '';
-                    return escapeForSpreadsheet(value);
-                }
-            }
-            return `${shouldCopyHeaders ? `${focusedColumnIds.join(separator)}\n` : ''}${focusedElementData
-                .map((it) => it
-                .map((toCopy, i) => {
-                if (toCopy instanceof Date) {
-                    return toCopy.toLocaleDateString();
-                }
-                if (selectColumns.has(i)) {
-                    const columnOptions = selectColumns.get(i);
-                    if (dev && !columnOptions) {
-                        console.warn(`could not find colum with index ${i}`);
-                    }
-                    const value = columnOptions?.find((it) => it.value === toCopy)?.label ??
-                        toCopy?.toString() ??
-                        '';
-                    return encapsulate(value);
-                }
-                else {
-                    const value = toCopy?.toString().trim() ?? '';
-                    return encapsulate(value);
-                }
-            })
-                .join(separator))
-                .join('\n')}`;
-        })();
-        navigator.clipboard.writeText(value).catch(devCatch);
-    };
-    /** Delegating accessor preserved for backwards compatibility. The
-     *  implementation lives on `_focus.startFocus` (Phase 6.6). */
+    /** Delegates to `_focus.startFocus`. */
     startFocus = (coords) => {
         this._focus.startFocus(coords);
     };
-    /** Delegating accessor preserved for backwards compatibility. The
-     *  implementation lives on `_focus.moveFocus` (Phase 6.6). */
+    /** Delegates to `_focus.moveFocus`. */
     moveFocus = (coords, startEditing = false) => {
         this._focus.moveFocus(coords, startEditing);
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     unfocus = () => {
         this._focus.unfocus();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     focusToTop = () => {
         this._focus.focusToTop();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     focusToBottom = () => {
         this._focus.focusToBottom();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     moveToBottom = () => {
         this._focus.moveToBottom();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     moveToTop = () => {
         this._focus.moveToTop();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     moveFocusUp = () => {
         this._focus.moveFocusUp();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     setFocusUp = () => {
         this._focus.setFocusUp();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     tabForward = () => {
         this._focus.tabForward();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     tabBackward = () => {
         this._focus.tabBackward();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     focusToStart = () => {
         this._focus.focusToStart();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     moveToStart = () => {
         this._focus.moveToStart();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     focusToEnd = () => {
         this._focus.focusToEnd();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     moveToEnd = () => {
         this._focus.moveToEnd();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     moveFocusDown = () => {
         this._focus.moveFocusDown();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     setFocusDown = () => {
         this._focus.setFocusDown();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     moveFocusLeft = () => {
         this._focus.moveFocusLeft();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     setFocusLeft = () => {
         this._focus.setFocusLeft();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     moveFocusRight = () => {
         this._focus.moveFocusRight();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     setFocusRight = () => {
         this._focus.setFocusRight();
     };
-    /** Delegating accessor preserved for backwards compatibility. */
+    /** Delegates to `_focus`. */
     endFocus = (coords) => {
         this._focus.endFocus(coords);
     };
@@ -1752,17 +1612,15 @@ export class TableContext {
     // 	}
     // };
     /**
-     * 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.
      */
     setSelectedPreset = (preset) => {
         if (!this.paginationRepo?.updateSorting) {
@@ -1771,19 +1629,17 @@ export class TableContext {
         this._preferences.setSelectedPreset(preset);
     };
     /**
-     * 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`.
      */
     saveColumnPreset = (name) => {
         this._preferences.saveColumnPreset(name);
     };
     /**
-     * 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). */
     setFocusEnd = (coords) => {
         this._focus.setFocusEnd(coords);
     };
@@ -1888,18 +1744,12 @@ export class TableContext {
             .map(makeRow));
         return row;
     }
-    columnDefReturnsTextValue = (it) => {
-        return ('index' in it &&
-            this.columnVisibility[it.id] !== false &&
-            !uncopyableColumns.has(it.columnType));
-    };
     /**
-     * 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.
      */
     _updateLocalStorageSettings() {
         const settingsObject = {
@@ -1913,11 +1763,9 @@ export class TableContext {
         this._preferences.persistSettings(settingsObject);
     }
     /**
-     * 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() {
         return this._columnLayout.visualColumns;
@@ -1929,166 +1777,16 @@ export class TableContext {
         return this._columnLayout.columnVisualIndex(id);
     }
     /**
-     * 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() {
         return this._focus.focusStartVisualColumn;
     }
-    /**
-     * Delegating getter preserved for backwards compatibility. The
-     * implementation lives on `_focus.focusEndVisualColumn`
-     * (Phase 6.6).
-     */
+    /** Delegates to `_focus.focusEndVisualColumn`. */
     get focusEndVisualColumn() {
         return this._focus.focusEndVisualColumn;
     }
-    async getHighlightedRowData() {
-        const affectedColumns = this.columnDefs.filter(this.columnDefReturnsTextValue);
-        // eslint-disable-next-line svelte/prefer-svelte-reactivity
-        const indices = new Map();
-        const selectedRows = [...this.highlightedItems.values()];
-        const sortedData = this.sortedData;
-        for (const item of selectedRows) {
-            const rowIndex = sortedData.indexOf(item);
-            if (rowIndex == -1) {
-                console.warn(`row index for highlighted row data not found`);
-                continue;
-            }
-            indices.set(item, rowIndex);
-        }
-        selectedRows.sort((left, right) => {
-            return (indices.get(left) ?? -1) - (indices.get(right) ?? -1);
-        });
-        // TODO somewhere between here and the ending of the copy functionality, we end up with issues where instead of it using the accessor fn, it tries to pick up the select option, and ends up using the value ("1", etc)
-        const selectedCells = [];
-        const rowLength = selectedRows.length;
-        for (let rowIndex = 0; rowIndex < rowLength; rowIndex++) {
-            const item = selectedRows[rowIndex];
-            const rawKey = this._cachedKey(item);
-            const key = rawKey instanceof Promise ? await rawKey : rawKey;
-            selectedCells[rowIndex] = [];
-            const targetRow = selectedCells[rowIndex];
-            const colLength = affectedColumns.length;
-            for (let colIndex = 0; colIndex < colLength; colIndex++) {
-                const columnDef = affectedColumns[colIndex];
-                if (columnDef instanceof RowSelectionDef) {
-                    targetRow.push(this.selectedItems.has(key) ? 'true' : 'false');
-                    continue;
-                }
-                if (uncopyableColumns.has(columnDef.columnType)) {
-                    continue;
-                }
-                const x = (await columnDef.getDisplayValue?.(item, sortedData.lastIndexOf(item))) ||
-                    ('accessorFn' in columnDef &&
-                        (await columnDef.accessorFn?.(item, sortedData.indexOf(item))));
-                if (x && typeof x === 'string') {
-                    targetRow.push(x);
-                    continue;
-                }
-                if (x && Array.isArray(x) && typeof x[0] === 'string') {
-                    targetRow.push(x.join(', '));
-                    continue;
-                }
-                const toCopy = columnDef.id && columnDef.id in item ? item[columnDef.id] : null;
-                const y = toCopy && typeof toCopy === 'object' && toCopy instanceof Date
-                    ? toCopy.toLocaleDateString()
-                    : (toCopy?.toString() ?? '');
-                targetRow.push(y);
-            }
-        }
-        return {
-            items: selectedRows,
-            indicesByItem: indices,
-            focusedElementData: selectedCells,
-            affectedColumns,
-        };
-    }
-    async getFocusElementData() {
-        if (this.focusStart && this.focusEnd) {
-            const { row: startRowIndexId } = this.focusStart;
-            const { row: endRowIndexId } = this.focusEnd;
-            // const model = this._currentPageData;
-            const model = this.paginationRowModel;
-            const startRowIndex = model.rows.findIndex((row) => row.visibleIndex === startRowIndexId);
-            const endRowIndex = model.rows.findIndex((row) => row.visibleIndex === endRowIndexId);
-            if (!this.currentPageData.length || startRowIndex == -1 || endRowIndex == -1) {
-                throw new Error(`copy was missing one of the two indices. First: ${startRowIndex}, second: ${endRowIndex}`);
-            }
-            const minRowIndex = Math.min(startRowIndex, endRowIndex);
-            const maxRowIndex = Math.max(startRowIndex, endRowIndex);
-            const startVisualIndex = this.columnVisualIndex(this.focusStart.id);
-            const endVisualIndex = this.columnVisualIndex(this.focusEnd.id);
-            const minVisualIndex = Math.min(startVisualIndex, endVisualIndex);
-            const maxVisualIndex = Math.max(startVisualIndex, endVisualIndex);
-            const affectedColumns = this._visualColumns
-                .slice(minVisualIndex, maxVisualIndex + 1)
-                .filter((it) => this.columnDefReturnsTextValue(it));
-            const selectedRows = [];
-            // eslint-disable-next-line svelte/prefer-svelte-reactivity
-            const indices = new Map();
-            for (let i = minRowIndex; i <= maxRowIndex; i++) {
-                const row = model.rows[i];
-                const item = row.original;
-                const itemIndex = row.originalIndex;
-                selectedRows.push(item);
-                indices.set(item, itemIndex);
-            }
-            // TODO somewhere between here and the ending of the copy functionality, we end up with issues where instead of it using the accessor fn, it tries to pick up the select option, and ends up using the value ("1", etc)
-            const selectedCells = [];
-            const rowLength = selectedRows.length;
-            const sortedData = this.sortedData;
-            for (let rowIndex = 0; rowIndex < rowLength; rowIndex++) {
-                const item = selectedRows[rowIndex];
-                const rawKey = this._cachedKey(item);
-                const key = rawKey instanceof Promise ? await rawKey : rawKey;
-                selectedCells[rowIndex] = [];
-                const targetRow = selectedCells[rowIndex];
-                const colLength = affectedColumns.length;
-                for (let colIndex = 0; colIndex < colLength; colIndex++) {
-                    const columnDef = affectedColumns[colIndex];
-                    if (columnDef instanceof RowSelectionDef) {
-                        targetRow.push(this.selectedItems.has(key) ? 'true' : 'false');
-                        continue;
-                    }
-                    if (uncopyableColumns.has(columnDef.columnType)) {
-                        continue;
-                    }
-                    const x = (await columnDef.getDisplayValue?.(item, sortedData.lastIndexOf(item))) ||
-                        ('accessorFn' in columnDef &&
-                            (await columnDef.accessorFn?.(item, sortedData.indexOf(item))));
-                    if (x && typeof x === 'string') {
-                        targetRow.push(x);
-                        continue;
-                    }
-                    if (x && Array.isArray(x) && typeof x[0] === 'string') {
-                        targetRow.push(x.join(', '));
-                        continue;
-                    }
-                    const toCopy = columnDef.id && columnDef.id in item ? item[columnDef.id] : null;
-                    const y = toCopy && typeof toCopy === 'object' && toCopy instanceof Date
-                        ? toCopy.toLocaleDateString()
-                        : (toCopy?.toString() ?? '');
-                    targetRow.push(y);
-                }
-            }
-            return {
-                items: selectedRows,
-                indicesByItem: indices,
-                focusedElementData: selectedCells,
-                affectedColumns,
-            };
-        }
-        return {
-            items: [],
-            // eslint-disable-next-line svelte/prefer-svelte-reactivity
-            indicesByItem: new Map(),
-            focusedElementData: [],
-            affectedColumns: [],
-        };
-    }
     updateDefsBasedOnPinning = () => {
         return this._columnLayout.updateDefsBasedOnPinning();
     };
@@ -2105,17 +1803,28 @@ export class TableContext {
     // eslint-disable-next-line @typescript-eslint/require-await
     async setupDefaultColumnDefs() {
         this.assertNoDuplicateIds();
+        // Snapshot the locally-available filter functions once per pass so
+        // `resolveDefaultFilter` can index into them by name.
+        const localFilters = {
+            stringFilter: this.stringFilter,
+            numberFilter: this.numberFilter,
+            selectFilter: this.selectFilter,
+            boolFilter: this.boolFilter,
+            dateFilter: this.dateFilter,
+        };
         const adjustedDefsPromises = this.defaultColumnDefs.defs.map((def) => {
-            if (def instanceof AccessorDef) {
+            const entry = def.kind != null ? COLUMN_KIND_REGISTRY[def.kind] : undefined;
+            // Accessor columns get a header-width minSize floor so the
+            // header text never wraps under its declared width. Falls
+            // back to 120px when the header is a Snippet rather than a
+            // plain string (cannot canvas-measure).
+            if (entry?.category === 'accessor') {
                 if (!def.allowFiltering) {
                     if (def.debug) {
                         console.log(`${def.id}: does not allow filtering`, def);
                     }
                     return def;
                 }
-                if (def.debug) {
-                    console.log(`${def.id}: is an accessor def`, def);
-                }
                 if (!('minSize' in def) || !def.minSize) {
                     if (typeof def.header === 'string') {
                         const minWidth = this.measureHeaderWidth(def);
@@ -2126,103 +1835,26 @@ export class TableContext {
                         def.minSize = 120;
                     }
                 }
-                // code smell...
-                if (def instanceof TextInputDef) {
-                    def.filterFn = this.stringFilter;
-                    if (def.debug) {
-                        console.log(`${def.id}: given a string filter`, def);
-                    }
-                }
-                else if (def instanceof NumberInputDef) {
-                    def.filterFn = this.numberFilter;
-                    if (def.debug) {
-                        console.log(`${def.id}: given a number filter`, def);
-                    }
-                }
-                else if (def instanceof SelectDef) {
-                    def.filterFn = this.selectFilter;
-                    if (def.debug) {
-                        console.log(`${def.id}: given a select filter`, def);
-                    }
-                }
-                else if (def instanceof CheckboxDef) {
-                    def.filterFn = this.boolFilter;
-                    if (def.debug) {
-                        console.log(`${def.id}: given a bool filter`, def);
-                    }
-                }
-                else if (def instanceof DateInputDef) {
-                    def.filterFn = this.dateFilter;
-                    if (def.debug) {
-                        console.log(`${def.id}: given a date filter`, def);
-                    }
-                }
-                else if (def.debug) {
-                    console.log(`${def.id}: was not a text,number,select,checkbox,or date accessor, and was not given a filter`, def);
-                }
             }
-            else if (
-            // this.paginationRepo?.paginationType == PaginationType.Local &&
-            !def.filterFn &&
-                def.allowFiltering) {
-                if (def instanceof DisplayDef) {
-                    if (def.debug) {
-                        console.log(`${def.id}: is a display def`, def);
-                    }
-                    switch (def.filterValueType) {
-                        case undefined:
-                        case 'String': {
-                            def.filterFn = this.stringFilter;
-                            if (def.debug) {
-                                console.log(`${def.id}: given a string filter`, def);
-                            }
-                            break;
-                        }
-                        case 'Bool': {
-                            def.filterFn = this.boolFilter;
-                            if (def.debug) {
-                                console.log(`${def.id}: given a bool filter`, def);
-                            }
-                            break;
-                        }
-                        case 'Date': {
-                            def.filterFn = this.dateFilter;
-                            if (def.debug) {
-                                console.log(`${def.id}: given a date filter`, def);
-                            }
-                            break;
-                        }
-                        case 'Number': {
-                            def.filterFn = this.numberFilter;
-                            if (def.debug) {
-                                console.log(`${def.id}: given a number filter`, def);
-                            }
-                            break;
-                        }
-                        case 'Select': {
-                            def.filterFn = this.selectFilter;
-                            if (def.debug) {
-                                console.log(`${def.id}: given a select filter`, def);
-                            }
-                            break;
+            // Wire the default filter function for kinds the registry knows
+            // about. Accessor kinds replace any pre-existing filterFn;
+            // display kinds (Display / Bubble / Progress) only fill in when
+            // nothing was set. Structural kinds (rowSelection, actions,
+            // expand, validity, filterOnly) skip entirely.
+            if (def.allowFiltering) {
+                const isAccessor = entry?.category === 'accessor';
+                if (isAccessor || !def.filterFn) {
+                    const resolved = resolveDefaultFilter(def, localFilters);
+                    if (resolved !== undefined) {
+                        def.filterFn = resolved;
+                        if (def.debug) {
+                            console.log(`${def.id}: assigned default ${def.kind ?? '<unknown>'} filter`, def);
                         }
                     }
-                }
-                else if (def instanceof BubbleDef) {
-                    def.filterFn = this.stringFilter;
-                    if (def.debug) {
-                        console.log(`${def.id}: is a bubble def. given a string filter`, def);
-                    }
-                }
-                else if (def instanceof ProgressBarDef) {
-                    def.filterFn = this.numberFilter;
-                    if (def.debug) {
-                        console.log(`${def.id}: is a progress def. given a number filter`, def);
+                    else if (def.debug && entry !== undefined && entry.category !== 'structural') {
+                        console.log(`${def.id}: kind has no default filter and none assigned`, def);
                     }
                 }
-                else if (def.debug) {
-                    console.log(`${def.id}: is not a display, bubble, or progressbar def, and was not given a filter`, def);
-                }
             }
             else if (def.debug) {
                 console.log(`${def.id}: no filtering matched`, def);
@@ -2239,16 +1871,15 @@ export class TableContext {
         return adjustedDefs;
     }
     /**
-     * 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).
      */
     _getUserDefaults() {
         const saved = this._preferences.loadSavedSettings();
@@ -2365,51 +1996,6 @@ export function isSearchable(def) {
 function hasPagination(repository) {
     return 'setPage' in repository;
 }
-/**
- * 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.
- */
-function escapeForSpreadsheet(value) {
-    if (value.length === 0) {
-        return value;
-    }
-    const first = value.charCodeAt(0);
-    // '=' 61, '+' 43, '-' 45, '@' 64, '\t' 9, '\r' 13
-    if (first === 61 || first === 43 || first === 45 || first === 64 || first === 9 || first === 13) {
-        return `'${value}`;
-    }
-    return value;
-}
-function encapsulate(value) {
-    const safe = escapeForSpreadsheet(value);
-    return `"${safe.replace(/[\n]/gm, ' ').replace(/["]/g, '""')}"`;
-}
-/**
- * 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 const _internal = {
-    escapeForSpreadsheet,
-    encapsulate,
-};
 function generateTableOptions(contextObj) {
     const _pagination = $derived.by(() => {
         void contextObj.paginationRepo?.paginationState.pageSize;