apex-grid 3.6.0 → 4.0.0-beta.2

package/controllers/selection.d.ts

@@ -19,9 +19,11 @@ export declare const DEFAULT_SELECTION_CONFIG: Readonly<{
  * any selected rows that are no longer present in the new array; consumers
  * should call {@link clear} or re-apply selection after such a change.
  *
- * Only data records are selectable: rows a feature module synthesizes into the
- * view (group headers, a grand-total row; see {@link StateController.isDataRow})
- * are skipped by every mutation and ignored by {@link allSelected}.
+ * Only selectable data records are selected (see {@link isSelectable}): rows
+ * a feature module synthesizes into the view (group headers, a grand-total
+ * row; see {@link StateController.isDataRow}) and rows the
+ * `selection.isRowSelectable` predicate rejects are skipped by every
+ * mutation and ignored by {@link allSelected}.
  *
  * Mutations go through the cancellable `rowSelecting` event and emit a
  * follow-up `rowSelected` event, mirroring the pattern used by editing.
@@ -38,6 +40,14 @@ export declare class SelectionController<T extends object> implements ReactiveCo
     anchor: T | null;
     constructor(host: GridHost<T>);
     hostConnected(): void;
+    /**
+     * Drops selected rows the `isRowSelectable` predicate rejects once
+     * `selection` or `data` is reassigned. Runs after the render, so the
+     * `rowSelecting`/`rowSelected` listeners (and any grid property they
+     * write) start a normal update. Without a predicate nothing is checked,
+     * and a mode switch never trims the selection here.
+     */
+    hostUpdated(): void;
     /**
      * Whether selection is enabled at the grid level.
      */
@@ -54,15 +64,27 @@ export declare class SelectionController<T extends object> implements ReactiveCo
      * Whether the given row is currently selected.
      */
     isSelected(row: T): boolean;
+    /**
+     * Whether `row` can be selected: a data record (see
+     * {@link StateController.isDataRow}) that `selection.isRowSelectable`, when
+     * set, accepts.
+     */
+    isSelectable(row: T): boolean;
+    /**
+     * The selectable rows of `rows` (see {@link isSelectable}), in order.
+     * Returns `rows` itself when nothing filters them (the community grid
+     * without a predicate).
+     */
+    selectable(rows: ReadonlyArray<T>): ReadonlyArray<T>;
     /**
      * Returns the currently selected rows in insertion order.
      */
     selectedRows(): T[];
     /**
-     * Whether every data record the current view covers is selected, including
-     * the leaves of collapsed groups (see {@link StateController.viewRecords}).
-     * `false` when the view covers none. Used by the header checkbox to render
-     * its "all" state.
+     * Whether every selectable record the current view covers is selected,
+     * including the leaves of collapsed groups (see
+     * {@link StateController.viewRecords}). `false` when the view covers none.
+     * Used by the header checkbox to render its "all" state.
      */
     allSelected(): boolean;
     /**
@@ -98,9 +120,9 @@ export declare class SelectionController<T extends object> implements ReactiveCo
      */
     rangeToggle(row: T): Promise<boolean>;
     /**
-     * Selects every data record the current view ({@link ApexGrid.dataView})
-     * covers, including the leaves of collapsed groups. No-op in `'single'`
-     * mode.
+     * Selects every selectable record the current view
+     * ({@link ApexGrid.dataView}) covers, including the leaves of collapsed
+     * groups. No-op in `'single'` mode.
      */
     selectAll(): Promise<boolean>;
     /**

package/controllers/selection.js

@@ -4,13 +4,26 @@ export const DEFAULT_SELECTION_CONFIG = Object.freeze({
     showCheckboxColumn: false,
 });
 export class SelectionController {
+    #seen;
     constructor(host) {
         this.host = host;
         this.selected = new Set();
         this.anchor = null;
+        this.#seen = [undefined, undefined];
         this.host.addController(this);
     }
     hostConnected() { }
+    hostUpdated() {
+        const { selection, data } = this.host;
+        if (selection === this.#seen[0] && data === this.#seen[1])
+            return;
+        this.#seen = [selection, data];
+        if (!this.enabled || !selection?.isRowSelectable)
+            return;
+        const keep = this.selectable(this.selectedRows());
+        if (keep.length < this.selected.size)
+            void this.#commit(new Set(keep));
+    }
     get enabled() {
         return Boolean(this.host.selection?.enabled);
     }
@@ -24,6 +37,16 @@ export class SelectionController {
     isSelected(row) {
         return this.selected.has(row);
     }
+    isSelectable(row) {
+        return ((this.#state?.isDataRow(row) ?? true) && (this.host.selection?.isRowSelectable?.(row) ?? true));
+    }
+    selectable(rows) {
+        return this.#accepted(this.#state?.dataRows(rows) ?? rows);
+    }
+    #accepted(rows) {
+        const accept = this.host.selection?.isRowSelectable;
+        return accept ? rows.filter((row) => accept(row)) : rows;
+    }
     selectedRows() {
         return Array.from(this.selected);
     }
@@ -45,7 +68,7 @@ export class SelectionController {
         return true;
     }
     async toggleRow(row) {
-        if (!this.enabled || !this.#isDataRow(row))
+        if (!this.#togglable(row))
             return false;
         const next = new Set(this.selected);
         if (next.has(row)) {
@@ -60,7 +83,7 @@ export class SelectionController {
         return this.#commit(next);
     }
     async selectRow(row) {
-        if (!this.enabled || !this.#isDataRow(row))
+        if (!this.enabled || !this.isSelectable(row))
             return false;
         const next = new Set(this.mode === 'single' ? [] : this.selected);
         next.add(row);
@@ -77,7 +100,7 @@ export class SelectionController {
         return this.#commit(next);
     }
     async additiveToggle(row) {
-        if (!this.enabled || !this.#isDataRow(row))
+        if (!this.#togglable(row))
             return false;
         if (this.mode === 'single')
             return this.toggleRow(row);
@@ -92,7 +115,7 @@ export class SelectionController {
         return this.#commit(next);
     }
     async rangeToggle(row) {
-        if (!this.enabled || !this.#isDataRow(row))
+        if (!this.enabled || !this.isSelectable(row))
             return false;
         if (this.mode === 'single' || !this.anchor) {
             return this.selectRow(row);
@@ -106,7 +129,7 @@ export class SelectionController {
         const [lo, hi] = startIdx < endIdx ? [startIdx, endIdx] : [endIdx, startIdx];
         const next = new Set(this.selected);
         for (let i = lo; i <= hi; i++) {
-            if (this.#isDataRow(pageItems[i]))
+            if (this.isSelectable(pageItems[i]))
                 next.add(pageItems[i]);
         }
         return this.#commit(next);
@@ -124,19 +147,19 @@ export class SelectionController {
     async replaceSelection(rows) {
         if (!this.enabled)
             return false;
-        const records = this.#state?.dataRows(rows) ?? rows;
+        const records = this.selectable(rows);
         const next = new Set(this.mode === 'single' ? records.slice(0, 1) : records);
         return this.#commit(next);
     }
     get #state() {
         return this.host.stateController;
     }
+    #togglable(row) {
+        return this.enabled && (this.selected.has(row) || this.isSelectable(row));
+    }
     #records() {
         const view = this.host.dataView;
-        return this.#state?.viewRecords(view) ?? view;
-    }
-    #isDataRow(row) {
-        return this.#state?.isDataRow(row) ?? true;
+        return this.#accepted(this.#state?.viewRecords(view) ?? view);
     }
     async #commit(next) {
         const added = [];

package/controllers/selection.js.map

@@ -1 +1 @@
-{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/controllers/selection.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController } from 'lit';\nimport type { GridHost, SelectionMode } from '../internal/types.js';\nimport type { StateController } from './state.js';\n\n/**\n * The default selection configuration used when the grid has none set.\n */\nexport const DEFAULT_SELECTION_CONFIG = Object.freeze({\n  enabled: false,\n  mode: 'multiple' as SelectionMode,\n  showCheckboxColumn: false,\n});\n\n/**\n * Reactive controller backing row selection.\n *\n * @remarks\n * Selection state is reference-based — the controller holds a `Set` of row\n * data references so the selection survives sort / filter / pagination as\n * long as those operations preserve identities (the default in-place\n * pipeline does). Replacing {@link ApexGrid.data} wholesale will invalidate\n * any selected rows that are no longer present in the new array; consumers\n * should call {@link clear} or re-apply selection after such a change.\n *\n * Only data records are selectable: rows a feature module synthesizes into the\n * view (group headers, a grand-total row; see {@link StateController.isDataRow})\n * are skipped by every mutation and ignored by {@link allSelected}.\n *\n * Mutations go through the cancellable `rowSelecting` event and emit a\n * follow-up `rowSelected` event, mirroring the pattern used by editing.\n */\nexport class SelectionController<T extends object> implements ReactiveController {\n  /** Set of currently selected row data references. */\n  public selected: Set<T> = new Set();\n\n  /**\n   * Anchor row for Shift+click range selection. Set whenever a single row\n   * is toggled / picked so a follow-up Shift+click knows where to start.\n   */\n  public anchor: T | null = null;\n\n  constructor(protected host: GridHost<T>) {\n    this.host.addController(this);\n  }\n\n  public hostConnected() {}\n\n  /**\n   * Whether selection is enabled at the grid level.\n   */\n  public get enabled(): boolean {\n    return Boolean(this.host.selection?.enabled);\n  }\n\n  /**\n   * The resolved selection mode (`'multiple'` if unset).\n   */\n  public get mode(): SelectionMode {\n    return this.host.selection?.mode ?? DEFAULT_SELECTION_CONFIG.mode;\n  }\n\n  /**\n   * Whether to render the built-in checkbox column.\n   */\n  public get showCheckboxColumn(): boolean {\n    return (\n      this.enabled &&\n      (this.host.selection?.showCheckboxColumn ?? DEFAULT_SELECTION_CONFIG.showCheckboxColumn)\n    );\n  }\n\n  /**\n   * Whether the given row is currently selected.\n   */\n  public isSelected(row: T): boolean {\n    return this.selected.has(row);\n  }\n\n  /**\n   * Returns the currently selected rows in insertion order.\n   */\n  public selectedRows(): T[] {\n    return Array.from(this.selected);\n  }\n\n  /**\n   * Whether every data record the current view covers is selected, including\n   * the leaves of collapsed groups (see {@link StateController.viewRecords}).\n   * `false` when the view covers none. Used by the header checkbox to render\n   * its \"all\" state.\n   */\n  public allSelected(): boolean {\n    const records = this.#records();\n    if (records.length === 0) return false;\n    for (const row of records) {\n      if (!this.selected.has(row)) return false;\n    }\n    return true;\n  }\n\n  /**\n   * Whether some — but not all — rows in the current view are selected.\n   * Used to render the header checkbox in its indeterminate state.\n   */\n  public someSelected(): boolean {\n    if (this.selected.size === 0) return false;\n    if (this.allSelected()) return false;\n    return true;\n  }\n\n  /**\n   * Toggles selection of `row`. In `'single'` mode this either selects the\n   * row (replacing any previous selection) or deselects it if it was the\n   * only selected row.\n   */\n  public async toggleRow(row: T): Promise<boolean> {\n    if (!this.enabled || !this.#isDataRow(row)) return false;\n    const next = new Set(this.selected);\n    if (next.has(row)) {\n      next.delete(row);\n    } else {\n      if (this.mode === 'single') next.clear();\n      next.add(row);\n    }\n    this.anchor = next.has(row) ? row : null;\n    return this.#commit(next);\n  }\n\n  /**\n   * Adds `row` to the selection. In `'single'` mode the existing selection\n   * is cleared first.\n   */\n  public async selectRow(row: T): Promise<boolean> {\n    if (!this.enabled || !this.#isDataRow(row)) return false;\n    const next = new Set(this.mode === 'single' ? [] : this.selected);\n    next.add(row);\n    this.anchor = row;\n    return this.#commit(next);\n  }\n\n  /**\n   * Removes `row` from the selection.\n   */\n  public async deselectRow(row: T): Promise<boolean> {\n    if (!this.enabled) return false;\n    if (!this.selected.has(row)) return true;\n    const next = new Set(this.selected);\n    next.delete(row);\n    return this.#commit(next);\n  }\n\n  /**\n   * Adds `row` to the selection without affecting other selected rows\n   * (`'multiple'` mode only). In `'single'` mode this behaves like\n   * {@link selectRow}.\n   */\n  public async additiveToggle(row: T): Promise<boolean> {\n    if (!this.enabled || !this.#isDataRow(row)) return false;\n    if (this.mode === 'single') return this.toggleRow(row);\n    const next = new Set(this.selected);\n    if (next.has(row)) {\n      next.delete(row);\n    } else {\n      next.add(row);\n    }\n    this.anchor = next.has(row) ? row : this.anchor;\n    return this.#commit(next);\n  }\n\n  /**\n   * Selects every row between {@link anchor} and `row` (inclusive) in the\n   * current page view. No-op in `'single'` mode or when no anchor is set —\n   * in those cases the call falls back to a plain {@link selectRow}.\n   */\n  public async rangeToggle(row: T): Promise<boolean> {\n    if (!this.enabled || !this.#isDataRow(row)) return false;\n    if (this.mode === 'single' || !this.anchor) {\n      return this.selectRow(row);\n    }\n    const pageItems = this.host.pageItems as ReadonlyArray<T>;\n    const startIdx = pageItems.indexOf(this.anchor);\n    const endIdx = pageItems.indexOf(row);\n    if (startIdx === -1 || endIdx === -1) {\n      return this.selectRow(row);\n    }\n    const [lo, hi] = startIdx < endIdx ? [startIdx, endIdx] : [endIdx, startIdx];\n    const next = new Set(this.selected);\n    for (let i = lo; i <= hi; i++) {\n      if (this.#isDataRow(pageItems[i])) next.add(pageItems[i]);\n    }\n    return this.#commit(next);\n  }\n\n  /**\n   * Selects every data record the current view ({@link ApexGrid.dataView})\n   * covers, including the leaves of collapsed groups. No-op in `'single'`\n   * mode.\n   */\n  public async selectAll(): Promise<boolean> {\n    if (!this.enabled || this.mode === 'single') return false;\n    return this.#commit(new Set(this.#records()));\n  }\n\n  /**\n   * Clears the selection.\n   */\n  public async clear(): Promise<boolean> {\n    if (this.selected.size === 0) return true;\n    return this.#commit(new Set());\n  }\n\n  /**\n   * Replaces the current selection with `rows`. Used by the public\n   * {@link ApexGrid.selectedRows} setter so callers can drive selection\n   * programmatically. Single-mode keeps at most one row.\n   */\n  public async replaceSelection(rows: ReadonlyArray<T>): Promise<boolean> {\n    if (!this.enabled) return false;\n    const records = this.#state?.dataRows(rows) ?? rows;\n    const next = new Set(this.mode === 'single' ? records.slice(0, 1) : records);\n    return this.#commit(next);\n  }\n\n  /** The owning state controller; absent only while the grid is constructing. */\n  get #state(): StateController<T> | undefined {\n    return (this.host as unknown as { stateController?: StateController<T> }).stateController;\n  }\n\n  /** The data records the current view covers, collapsed group leaves included. */\n  #records(): ReadonlyArray<T> {\n    const view = this.host.dataView as ReadonlyArray<T>;\n    return this.#state?.viewRecords(view) ?? view;\n  }\n\n  #isDataRow(row: T): boolean {\n    return this.#state?.isDataRow(row) ?? true;\n  }\n\n  async #commit(next: Set<T>): Promise<boolean> {\n    const added: T[] = [];\n    const removed: T[] = [];\n    for (const row of next) {\n      if (!this.selected.has(row)) added.push(row);\n    }\n    for (const row of this.selected) {\n      if (!next.has(row)) removed.push(row);\n    }\n    if (added.length === 0 && removed.length === 0) return true;\n\n    const proceed = this.host.emitEvent('rowSelecting', {\n      detail: {\n        added,\n        removed,\n        current: Array.from(this.selected),\n        next: Array.from(next),\n      },\n      cancelable: true,\n    });\n    if (!proceed) return false;\n\n    this.selected = next;\n    this.host.requestUpdate();\n\n    const total = this.selected.size;\n    if (total === 0) {\n      this.host.announce(this.host.localize('announce.selectionCleared'));\n    } else if (added.length === 1 && removed.length === 0 && total === 1) {\n      this.host.announce(this.host.localize('announce.rowSelected'));\n    } else {\n      this.host.announce(this.host.localize('announce.rowsSelected', { count: total }));\n    }\n\n    this.host.emitEvent('rowSelected', {\n      detail: { added, removed, selected: Array.from(this.selected) },\n    });\n    return true;\n  }\n}\n"]}
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/controllers/selection.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController } from 'lit';\nimport type { GridHost, SelectionMode } from '../internal/types.js';\nimport type { StateController } from './state.js';\n\n/**\n * The default selection configuration used when the grid has none set.\n */\nexport const DEFAULT_SELECTION_CONFIG = Object.freeze({\n  enabled: false,\n  mode: 'multiple' as SelectionMode,\n  showCheckboxColumn: false,\n});\n\n/**\n * Reactive controller backing row selection.\n *\n * @remarks\n * Selection state is reference-based — the controller holds a `Set` of row\n * data references so the selection survives sort / filter / pagination as\n * long as those operations preserve identities (the default in-place\n * pipeline does). Replacing {@link ApexGrid.data} wholesale will invalidate\n * any selected rows that are no longer present in the new array; consumers\n * should call {@link clear} or re-apply selection after such a change.\n *\n * Only selectable data records are selected (see {@link isSelectable}): rows\n * a feature module synthesizes into the view (group headers, a grand-total\n * row; see {@link StateController.isDataRow}) and rows the\n * `selection.isRowSelectable` predicate rejects are skipped by every\n * mutation and ignored by {@link allSelected}.\n *\n * Mutations go through the cancellable `rowSelecting` event and emit a\n * follow-up `rowSelected` event, mirroring the pattern used by editing.\n */\nexport class SelectionController<T extends object> implements ReactiveController {\n  /** Set of currently selected row data references. */\n  public selected: Set<T> = new Set();\n\n  /**\n   * Anchor row for Shift+click range selection. Set whenever a single row\n   * is toggled / picked so a follow-up Shift+click knows where to start.\n   */\n  public anchor: T | null = null;\n\n  /** The selection config and data the selection was last checked against. */\n  #seen: [unknown, unknown] = [undefined, undefined];\n\n  constructor(protected host: GridHost<T>) {\n    this.host.addController(this);\n  }\n\n  public hostConnected() {}\n\n  /**\n   * Drops selected rows the `isRowSelectable` predicate rejects once\n   * `selection` or `data` is reassigned. Runs after the render, so the\n   * `rowSelecting`/`rowSelected` listeners (and any grid property they\n   * write) start a normal update. Without a predicate nothing is checked,\n   * and a mode switch never trims the selection here.\n   */\n  public hostUpdated() {\n    const { selection, data } = this.host;\n    if (selection === this.#seen[0] && data === this.#seen[1]) return;\n    this.#seen = [selection, data];\n    if (!this.enabled || !selection?.isRowSelectable) return;\n    const keep = this.selectable(this.selectedRows());\n    if (keep.length < this.selected.size) void this.#commit(new Set(keep));\n  }\n\n  /**\n   * Whether selection is enabled at the grid level.\n   */\n  public get enabled(): boolean {\n    return Boolean(this.host.selection?.enabled);\n  }\n\n  /**\n   * The resolved selection mode (`'multiple'` if unset).\n   */\n  public get mode(): SelectionMode {\n    return this.host.selection?.mode ?? DEFAULT_SELECTION_CONFIG.mode;\n  }\n\n  /**\n   * Whether to render the built-in checkbox column.\n   */\n  public get showCheckboxColumn(): boolean {\n    return (\n      this.enabled &&\n      (this.host.selection?.showCheckboxColumn ?? DEFAULT_SELECTION_CONFIG.showCheckboxColumn)\n    );\n  }\n\n  /**\n   * Whether the given row is currently selected.\n   */\n  public isSelected(row: T): boolean {\n    return this.selected.has(row);\n  }\n\n  /**\n   * Whether `row` can be selected: a data record (see\n   * {@link StateController.isDataRow}) that `selection.isRowSelectable`, when\n   * set, accepts.\n   */\n  public isSelectable(row: T): boolean {\n    return (\n      (this.#state?.isDataRow(row) ?? true) && (this.host.selection?.isRowSelectable?.(row) ?? true)\n    );\n  }\n\n  /**\n   * The selectable rows of `rows` (see {@link isSelectable}), in order.\n   * Returns `rows` itself when nothing filters them (the community grid\n   * without a predicate).\n   */\n  public selectable(rows: ReadonlyArray<T>): ReadonlyArray<T> {\n    return this.#accepted(this.#state?.dataRows(rows) ?? rows);\n  }\n\n  /** The rows `selection.isRowSelectable` accepts; `rows` itself when unset. */\n  #accepted(rows: ReadonlyArray<T>): ReadonlyArray<T> {\n    const accept = this.host.selection?.isRowSelectable;\n    return accept ? rows.filter((row) => accept(row)) : rows;\n  }\n\n  /**\n   * Returns the currently selected rows in insertion order.\n   */\n  public selectedRows(): T[] {\n    return Array.from(this.selected);\n  }\n\n  /**\n   * Whether every selectable record the current view covers is selected,\n   * including the leaves of collapsed groups (see\n   * {@link StateController.viewRecords}). `false` when the view covers none.\n   * Used by the header checkbox to render its \"all\" state.\n   */\n  public allSelected(): boolean {\n    const records = this.#records();\n    if (records.length === 0) return false;\n    for (const row of records) {\n      if (!this.selected.has(row)) return false;\n    }\n    return true;\n  }\n\n  /**\n   * Whether some — but not all — rows in the current view are selected.\n   * Used to render the header checkbox in its indeterminate state.\n   */\n  public someSelected(): boolean {\n    if (this.selected.size === 0) return false;\n    if (this.allSelected()) return false;\n    return true;\n  }\n\n  /**\n   * Toggles selection of `row`. In `'single'` mode this either selects the\n   * row (replacing any previous selection) or deselects it if it was the\n   * only selected row.\n   */\n  public async toggleRow(row: T): Promise<boolean> {\n    if (!this.#togglable(row)) return false;\n    const next = new Set(this.selected);\n    if (next.has(row)) {\n      next.delete(row);\n    } else {\n      if (this.mode === 'single') next.clear();\n      next.add(row);\n    }\n    this.anchor = next.has(row) ? row : null;\n    return this.#commit(next);\n  }\n\n  /**\n   * Adds `row` to the selection. In `'single'` mode the existing selection\n   * is cleared first.\n   */\n  public async selectRow(row: T): Promise<boolean> {\n    if (!this.enabled || !this.isSelectable(row)) return false;\n    const next = new Set(this.mode === 'single' ? [] : this.selected);\n    next.add(row);\n    this.anchor = row;\n    return this.#commit(next);\n  }\n\n  /**\n   * Removes `row` from the selection.\n   */\n  public async deselectRow(row: T): Promise<boolean> {\n    if (!this.enabled) return false;\n    if (!this.selected.has(row)) return true;\n    const next = new Set(this.selected);\n    next.delete(row);\n    return this.#commit(next);\n  }\n\n  /**\n   * Adds `row` to the selection without affecting other selected rows\n   * (`'multiple'` mode only). In `'single'` mode this behaves like\n   * {@link selectRow}.\n   */\n  public async additiveToggle(row: T): Promise<boolean> {\n    if (!this.#togglable(row)) return false;\n    if (this.mode === 'single') return this.toggleRow(row);\n    const next = new Set(this.selected);\n    if (next.has(row)) {\n      next.delete(row);\n    } else {\n      next.add(row);\n    }\n    this.anchor = next.has(row) ? row : this.anchor;\n    return this.#commit(next);\n  }\n\n  /**\n   * Selects every row between {@link anchor} and `row` (inclusive) in the\n   * current page view. No-op in `'single'` mode or when no anchor is set —\n   * in those cases the call falls back to a plain {@link selectRow}.\n   */\n  public async rangeToggle(row: T): Promise<boolean> {\n    if (!this.enabled || !this.isSelectable(row)) return false;\n    if (this.mode === 'single' || !this.anchor) {\n      return this.selectRow(row);\n    }\n    const pageItems = this.host.pageItems as ReadonlyArray<T>;\n    const startIdx = pageItems.indexOf(this.anchor);\n    const endIdx = pageItems.indexOf(row);\n    if (startIdx === -1 || endIdx === -1) {\n      return this.selectRow(row);\n    }\n    const [lo, hi] = startIdx < endIdx ? [startIdx, endIdx] : [endIdx, startIdx];\n    const next = new Set(this.selected);\n    for (let i = lo; i <= hi; i++) {\n      if (this.isSelectable(pageItems[i])) next.add(pageItems[i]);\n    }\n    return this.#commit(next);\n  }\n\n  /**\n   * Selects every selectable record the current view\n   * ({@link ApexGrid.dataView}) covers, including the leaves of collapsed\n   * groups. No-op in `'single'` mode.\n   */\n  public async selectAll(): Promise<boolean> {\n    if (!this.enabled || this.mode === 'single') return false;\n    return this.#commit(new Set(this.#records()));\n  }\n\n  /**\n   * Clears the selection.\n   */\n  public async clear(): Promise<boolean> {\n    if (this.selected.size === 0) return true;\n    return this.#commit(new Set());\n  }\n\n  /**\n   * Replaces the current selection with `rows`. Used by the public\n   * {@link ApexGrid.selectedRows} setter so callers can drive selection\n   * programmatically. Single-mode keeps at most one row.\n   */\n  public async replaceSelection(rows: ReadonlyArray<T>): Promise<boolean> {\n    if (!this.enabled) return false;\n    const records = this.selectable(rows);\n    const next = new Set(this.mode === 'single' ? records.slice(0, 1) : records);\n    return this.#commit(next);\n  }\n\n  /** The owning state controller; absent only while the grid is constructing. */\n  get #state(): StateController<T> | undefined {\n    return (this.host as unknown as { stateController?: StateController<T> }).stateController;\n  }\n\n  /**\n   * Whether a toggle may act on `row`: a selected row can always be\n   * deselected, even one the predicate has since come to reject (a row\n   * pinned or edited in place), so it never gets stuck selected.\n   */\n  #togglable(row: T): boolean {\n    return this.enabled && (this.selected.has(row) || this.isSelectable(row));\n  }\n\n  /** The selectable records the current view covers, collapsed group leaves included. */\n  #records(): ReadonlyArray<T> {\n    const view = this.host.dataView as ReadonlyArray<T>;\n    return this.#accepted(this.#state?.viewRecords(view) ?? view);\n  }\n\n  async #commit(next: Set<T>): Promise<boolean> {\n    const added: T[] = [];\n    const removed: T[] = [];\n    for (const row of next) {\n      if (!this.selected.has(row)) added.push(row);\n    }\n    for (const row of this.selected) {\n      if (!next.has(row)) removed.push(row);\n    }\n    if (added.length === 0 && removed.length === 0) return true;\n\n    const proceed = this.host.emitEvent('rowSelecting', {\n      detail: {\n        added,\n        removed,\n        current: Array.from(this.selected),\n        next: Array.from(next),\n      },\n      cancelable: true,\n    });\n    if (!proceed) return false;\n\n    this.selected = next;\n    this.host.requestUpdate();\n\n    const total = this.selected.size;\n    if (total === 0) {\n      this.host.announce(this.host.localize('announce.selectionCleared'));\n    } else if (added.length === 1 && removed.length === 0 && total === 1) {\n      this.host.announce(this.host.localize('announce.rowSelected'));\n    } else {\n      this.host.announce(this.host.localize('announce.rowsSelected', { count: total }));\n    }\n\n    this.host.emitEvent('rowSelected', {\n      detail: { added, removed, selected: Array.from(this.selected) },\n    });\n    return true;\n  }\n}\n"]}

package/controllers/sort.js

@@ -1,5 +1,5 @@
 import { PIPELINE } from '../internal/constants.js';
-import { awaitChildUpdates, playKeyedFlip } from '../internal/flip.js';
+import { playKeyedFlip, settleRowsForFlip } from '../internal/flip.js';
 import { asArray } from '../internal/utils.js';
 export class SortController {
     constructor(host) {
@@ -68,8 +68,7 @@ export class SortController {
         }
         const beforeRects = this.#captureRowRects();
         this._sort(expression);
-        await this.host.pipelineSettled();
-        await awaitChildUpdates(this.host.rows);
+        await settleRowsForFlip(this.host);
         this.#playRowFlip(beforeRects);
         this.#announce(expression, column);
         this.#emitSortedEvent(expression);

package/controllers/sort.js.map

@@ -1 +1 @@
-{"version":3,"file":"sort.js","sourceRoot":"","sources":["../../src/controllers/sort.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController } from 'lit';\nimport { PIPELINE } from '../internal/constants.js';\nimport { awaitChildUpdates, type KeyedFlipEntry, playKeyedFlip } from '../internal/flip.js';\nimport type {\n  ColumnConfiguration,\n  ColumnSortConfiguration,\n  GridHost,\n  Keys,\n} from '../internal/types.js';\nimport { asArray } from '../internal/utils.js';\nimport type { SortExpression, SortingDirection, SortState } from '../operations/sort/types.js';\n\nexport class SortController<T extends object> implements ReactiveController {\n  constructor(protected host: GridHost<T>) {\n    this.host.addController(this);\n  }\n\n  public state: SortState<T> = new Map();\n\n  get #isMultipleSort() {\n    return this.host.sortConfiguration.multiple;\n  }\n\n  get #isTriStateSort() {\n    return this.host.sortConfiguration.triState;\n  }\n\n  /**\n   * Only the options the column config actually sets, so a header click keeps a\n   * comparer or caseSensitive that came in through `grid.sort()` when the column\n   * itself does not define one. The trade-off: a comparer later removed from\n   * the column config stays on the stored expression until that column's sort\n   * is cleared, because its origin is not tracked.\n   */\n  #resolveSortOptions(options?: boolean | ColumnSortConfiguration<T>) {\n    const expr: Partial<SortExpression<T>> = {};\n    if (options && typeof options === 'object') {\n      if (options.caseSensitive !== undefined) expr.caseSensitive = options.caseSensitive;\n      if (options.comparer !== undefined) expr.comparer = options.comparer as any;\n    }\n    return expr;\n  }\n\n  #createDefaultExpression(key: Keys<T>) {\n    const options = this.host.getColumn(key)?.sort;\n\n    return {\n      key,\n      direction: 'ascending',\n      caseSensitive: false,\n      comparer: undefined,\n      ...this.#resolveSortOptions(options),\n    } as SortExpression<T>;\n  }\n\n  #orderBy(dir?: SortingDirection): SortingDirection {\n    return this.#isTriStateSort\n      ? dir === 'ascending'\n        ? 'descending'\n        : dir === 'descending'\n          ? 'none'\n          : 'ascending'\n      : dir === 'ascending'\n        ? 'descending'\n        : 'ascending';\n  }\n\n  #emitSortingEvent(detail: SortExpression<T>) {\n    return this.host.emitEvent('sorting', { detail, cancelable: true });\n  }\n\n  #emitSortedEvent(detail: SortExpression<T>) {\n    return this.host.emitEvent('sorted', { detail });\n  }\n\n  #setExpression(expression: SortExpression<T>) {\n    expression.direction === 'none'\n      ? this.reset(expression.key)\n      : this.state.set(expression.key, { ...expression });\n  }\n\n  public sortFromHeaderClick(column: ColumnConfiguration<T>, additive = false) {\n    return this.sortFromUI(column, { additive });\n  }\n\n  /**\n   * The one path for a sort the user starts from the UI (header click, column\n   * menu): fires the cancelable `sorting` event, replaces the sort unless the\n   * gesture is additive in multi-sort mode, announces, then fires `sorted`.\n   * Without a `direction` the column steps to its next direction.\n   */\n  public async sortFromUI(\n    column: ColumnConfiguration<T>,\n    { direction, additive = false }: { direction?: SortingDirection; additive?: boolean } = {}\n  ) {\n    const expression = this.prepareExpression(column, direction);\n\n    if (!this.#emitSortingEvent(expression)) {\n      return;\n    }\n\n    // A plain click sorts by this column alone, clearing any other sorted\n    // columns. Only a Ctrl/Cmd+click while multi-sort is enabled keeps the\n    // existing sort keys and appends this column as an additional, lower-\n    // priority sort. Without this gate every plain click would accumulate a\n    // key, so a second column added behind a unique primary column would not\n    // change the visible order at all.\n    if (!this.#isMultipleSort || !additive) {\n      this.reset();\n    }\n\n    // Capture visible-row rects keyed by data identity BEFORE the pipeline\n    // runs. After the new render the virtualizer will have repositioned\n    // rows; we use those captured rects as the \"First\" of a FLIP and\n    // animate each row from its old viewport position back to identity.\n    const beforeRects = this.#captureRowRects();\n\n    this._sort(expression);\n\n    // @ts-expect-error - protected member access\n    await this.host.pipelineSettled();\n    // Wait for body row updates so the new data is committed to each row\n    // element before measuring the \"Last\" rect — otherwise the captured-\n    // before and measured-after rects match and the animation no-ops.\n    await awaitChildUpdates(this.host.rows);\n    this.#playRowFlip(beforeRects);\n    this.#announce(expression, column);\n    this.#emitSortedEvent(expression);\n  }\n\n  #announce(expression: SortExpression<T>, column: ColumnConfiguration<T>) {\n    const label = column.headerText ?? String(column.key);\n    const message =\n      expression.direction === 'none'\n        ? this.host.localize('announce.sortCleared', { label })\n        : this.host.localize(\n            expression.direction === 'ascending'\n              ? 'announce.sortedAscending'\n              : 'announce.sortedDescending',\n            { label }\n          );\n    this.host.announce(message);\n  }\n\n  #captureRowRects(): KeyedFlipEntry<T>[] {\n    const entries: KeyedFlipEntry<T>[] = [];\n    for (const row of this.host.rows) {\n      const el = row as unknown as HTMLElement;\n      entries.push({ key: row.data, rect: el.getBoundingClientRect() });\n    }\n    return entries;\n  }\n\n  #playRowFlip(before: ReadonlyArray<KeyedFlipEntry<T>>) {\n    // After sort, the same data may be rendered by a different `<apex-grid-row>`\n    // DOM element (virtualizer recycles rows). Resolve by data identity.\n    const rows = this.host.rows;\n    const byData = new Map<T, HTMLElement>();\n    for (const row of rows) {\n      byData.set(row.data, row as unknown as HTMLElement);\n    }\n    playKeyedFlip(before, (data) => byData.get(data) ?? null, 'y');\n  }\n\n  /**\n   * The expression a UI sort would apply. Always a fresh object: the stored\n   * entry is only replaced once the `sorting` event is not cancelled.\n   */\n  public prepareExpression(\n    { key, sort: options }: ColumnConfiguration<T>,\n    direction?: SortingDirection\n  ): SortExpression<T> {\n    const expr = this.state.get(key);\n\n    return {\n      ...(expr ?? this.#createDefaultExpression(key)),\n      direction: direction ?? this.#orderBy(expr?.direction),\n      ...this.#resolveSortOptions(options),\n    } as SortExpression<T>;\n  }\n\n  /**\n   * Whether the UI offers sorting on `column`: it declares `sort` and no\n   * manual row order is active (sorting and a manual order are mutually\n   * exclusive). The one rule for every sort affordance, built in or a module's.\n   */\n  public isSortable(column: ColumnConfiguration<T>): boolean {\n    return Boolean(column.sort) && !this.#rowReorder?.hasManualOrder;\n  }\n\n  public reset(key?: Keys<T>) {\n    key ? this.state.delete(key) : this.state.clear();\n  }\n\n  get #rowReorder() {\n    // @ts-expect-error - protected member access\n    return this.host.stateController.rowReorder as\n      | { hasManualOrder: boolean; clearManualOrder(announce?: boolean): void }\n      | undefined;\n  }\n\n  protected _sort(expressions: SortExpression<T> | SortExpression<T>[]) {\n    const exprs = asArray(expressions);\n    // Applying a sort is mutually exclusive with a manual row order (F5):\n    // a real sort (any non-`none` direction) clears it, with an announcement.\n    const reorder = this.#rowReorder;\n    if (reorder?.hasManualOrder && exprs.some((expr) => expr.direction !== 'none')) {\n      reorder.clearManualOrder(true);\n    }\n\n    for (const expr of exprs) {\n      this.#setExpression(expr);\n    }\n\n    this.host.requestUpdate(PIPELINE);\n  }\n\n  public sort(expressions: SortExpression<T> | SortExpression<T>[]) {\n    this._sort(\n      asArray(expressions).map(\n        (expr) =>\n          ({\n            ...(this.state.get(expr.key) ?? this.#createDefaultExpression(expr.key)),\n            ...expr,\n          }) as SortExpression<T>\n      )\n    );\n  }\n\n  public hostConnected() {}\n}\n"]}
+{"version":3,"file":"sort.js","sourceRoot":"","sources":["../../src/controllers/sort.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController } from 'lit';\nimport { PIPELINE } from '../internal/constants.js';\nimport { type KeyedFlipEntry, playKeyedFlip, settleRowsForFlip } from '../internal/flip.js';\nimport type {\n  ColumnConfiguration,\n  ColumnSortConfiguration,\n  GridHost,\n  Keys,\n} from '../internal/types.js';\nimport { asArray } from '../internal/utils.js';\nimport type { SortExpression, SortingDirection, SortState } from '../operations/sort/types.js';\n\nexport class SortController<T extends object> implements ReactiveController {\n  constructor(protected host: GridHost<T>) {\n    this.host.addController(this);\n  }\n\n  public state: SortState<T> = new Map();\n\n  get #isMultipleSort() {\n    return this.host.sortConfiguration.multiple;\n  }\n\n  get #isTriStateSort() {\n    return this.host.sortConfiguration.triState;\n  }\n\n  /**\n   * Only the options the column config actually sets, so a header click keeps a\n   * comparer or caseSensitive that came in through `grid.sort()` when the column\n   * itself does not define one. The trade-off: a comparer later removed from\n   * the column config stays on the stored expression until that column's sort\n   * is cleared, because its origin is not tracked.\n   */\n  #resolveSortOptions(options?: boolean | ColumnSortConfiguration<T>) {\n    const expr: Partial<SortExpression<T>> = {};\n    if (options && typeof options === 'object') {\n      if (options.caseSensitive !== undefined) expr.caseSensitive = options.caseSensitive;\n      if (options.comparer !== undefined) expr.comparer = options.comparer as any;\n    }\n    return expr;\n  }\n\n  #createDefaultExpression(key: Keys<T>) {\n    const options = this.host.getColumn(key)?.sort;\n\n    return {\n      key,\n      direction: 'ascending',\n      caseSensitive: false,\n      comparer: undefined,\n      ...this.#resolveSortOptions(options),\n    } as SortExpression<T>;\n  }\n\n  #orderBy(dir?: SortingDirection): SortingDirection {\n    return this.#isTriStateSort\n      ? dir === 'ascending'\n        ? 'descending'\n        : dir === 'descending'\n          ? 'none'\n          : 'ascending'\n      : dir === 'ascending'\n        ? 'descending'\n        : 'ascending';\n  }\n\n  #emitSortingEvent(detail: SortExpression<T>) {\n    return this.host.emitEvent('sorting', { detail, cancelable: true });\n  }\n\n  #emitSortedEvent(detail: SortExpression<T>) {\n    return this.host.emitEvent('sorted', { detail });\n  }\n\n  #setExpression(expression: SortExpression<T>) {\n    expression.direction === 'none'\n      ? this.reset(expression.key)\n      : this.state.set(expression.key, { ...expression });\n  }\n\n  public sortFromHeaderClick(column: ColumnConfiguration<T>, additive = false) {\n    return this.sortFromUI(column, { additive });\n  }\n\n  /**\n   * The one path for a sort the user starts from the UI (header click, column\n   * menu): fires the cancelable `sorting` event, replaces the sort unless the\n   * gesture is additive in multi-sort mode, announces, then fires `sorted`.\n   * Without a `direction` the column steps to its next direction.\n   */\n  public async sortFromUI(\n    column: ColumnConfiguration<T>,\n    { direction, additive = false }: { direction?: SortingDirection; additive?: boolean } = {}\n  ) {\n    const expression = this.prepareExpression(column, direction);\n\n    if (!this.#emitSortingEvent(expression)) {\n      return;\n    }\n\n    // A plain click sorts by this column alone, clearing any other sorted\n    // columns. Only a Ctrl/Cmd+click while multi-sort is enabled keeps the\n    // existing sort keys and appends this column as an additional, lower-\n    // priority sort. Without this gate every plain click would accumulate a\n    // key, so a second column added behind a unique primary column would not\n    // change the visible order at all.\n    if (!this.#isMultipleSort || !additive) {\n      this.reset();\n    }\n\n    // Capture visible-row rects keyed by data identity BEFORE the pipeline\n    // runs. After the new render the virtualizer will have repositioned\n    // rows; we use those captured rects as the \"First\" of a FLIP and\n    // animate each row from its old viewport position back to identity.\n    const beforeRects = this.#captureRowRects();\n\n    this._sort(expression);\n\n    // The rows must show the sorted data before the \"Last\" rects are\n    // measured, otherwise the captured-before and measured-after rects match\n    // and the animation no-ops.\n    await settleRowsForFlip(this.host);\n    this.#playRowFlip(beforeRects);\n    this.#announce(expression, column);\n    this.#emitSortedEvent(expression);\n  }\n\n  #announce(expression: SortExpression<T>, column: ColumnConfiguration<T>) {\n    const label = column.headerText ?? String(column.key);\n    const message =\n      expression.direction === 'none'\n        ? this.host.localize('announce.sortCleared', { label })\n        : this.host.localize(\n            expression.direction === 'ascending'\n              ? 'announce.sortedAscending'\n              : 'announce.sortedDescending',\n            { label }\n          );\n    this.host.announce(message);\n  }\n\n  #captureRowRects(): KeyedFlipEntry<T>[] {\n    const entries: KeyedFlipEntry<T>[] = [];\n    for (const row of this.host.rows) {\n      const el = row as unknown as HTMLElement;\n      entries.push({ key: row.data, rect: el.getBoundingClientRect() });\n    }\n    return entries;\n  }\n\n  #playRowFlip(before: ReadonlyArray<KeyedFlipEntry<T>>) {\n    // After sort, the same data may be rendered by a different `<apex-grid-row>`\n    // DOM element (virtualizer recycles rows). Resolve by data identity.\n    const rows = this.host.rows;\n    const byData = new Map<T, HTMLElement>();\n    for (const row of rows) {\n      byData.set(row.data, row as unknown as HTMLElement);\n    }\n    playKeyedFlip(before, (data) => byData.get(data) ?? null, 'y');\n  }\n\n  /**\n   * The expression a UI sort would apply. Always a fresh object: the stored\n   * entry is only replaced once the `sorting` event is not cancelled.\n   */\n  public prepareExpression(\n    { key, sort: options }: ColumnConfiguration<T>,\n    direction?: SortingDirection\n  ): SortExpression<T> {\n    const expr = this.state.get(key);\n\n    return {\n      ...(expr ?? this.#createDefaultExpression(key)),\n      direction: direction ?? this.#orderBy(expr?.direction),\n      ...this.#resolveSortOptions(options),\n    } as SortExpression<T>;\n  }\n\n  /**\n   * Whether the UI offers sorting on `column`: it declares `sort` and no\n   * manual row order is active (sorting and a manual order are mutually\n   * exclusive). The one rule for every sort affordance, built in or a module's.\n   */\n  public isSortable(column: ColumnConfiguration<T>): boolean {\n    return Boolean(column.sort) && !this.#rowReorder?.hasManualOrder;\n  }\n\n  public reset(key?: Keys<T>) {\n    key ? this.state.delete(key) : this.state.clear();\n  }\n\n  get #rowReorder() {\n    // @ts-expect-error - protected member access\n    return this.host.stateController.rowReorder as\n      | { hasManualOrder: boolean; clearManualOrder(announce?: boolean): void }\n      | undefined;\n  }\n\n  protected _sort(expressions: SortExpression<T> | SortExpression<T>[]) {\n    const exprs = asArray(expressions);\n    // Applying a sort is mutually exclusive with a manual row order (F5):\n    // a real sort (any non-`none` direction) clears it, with an announcement.\n    const reorder = this.#rowReorder;\n    if (reorder?.hasManualOrder && exprs.some((expr) => expr.direction !== 'none')) {\n      reorder.clearManualOrder(true);\n    }\n\n    for (const expr of exprs) {\n      this.#setExpression(expr);\n    }\n\n    this.host.requestUpdate(PIPELINE);\n  }\n\n  public sort(expressions: SortExpression<T> | SortExpression<T>[]) {\n    this._sort(\n      asArray(expressions).map(\n        (expr) =>\n          ({\n            ...(this.state.get(expr.key) ?? this.#createDefaultExpression(expr.key)),\n            ...expr,\n          }) as SortExpression<T>\n      )\n    );\n  }\n\n  public hostConnected() {}\n}\n"]}

package/controllers/state.d.ts

@@ -70,11 +70,6 @@ export declare class StateController<T extends object> implements ReactiveContro
     get scrollContainer(): import("../components/virtualizer.js").default;
     get paginator(): import("../index.js").ApexGridPaginator<T>;
     get toolbar(): import("../index.js").ApexGridToolbar<T>;
-    /**
-     * Cumulative pin offsets (in px) keyed by column key. Populated by the
-     * {@link GridDOMController} after each layout.
-     */
-    get pinOffsets(): Map<unknown, number>;
     constructor(host: GridHost<T>, extraModules?: ReadonlyArray<GridFeatureModule<T>>);
     protected init(): void;
     /**
@@ -119,6 +114,19 @@ export declare class StateController<T extends object> implements ReactiveContro
      * the first non-null result, or `null` when no module owns the row.
      */
     presentRow(row: T, ctx: RowPresenterContext<T>): PresentedRow | null;
+    /**
+     * Columns in the `aria-colindex` sequence: the visible columns plus the
+     * selection and expansion chrome columns. Shared by `aria-colcount` and the
+     * cells that span a whole row.
+     */
+    get colCount(): number;
+    /**
+     * Whether rows carry tree semantics (`aria-level` / `aria-expanded`), which
+     * only a `treegrid` supports: the core tree, master-detail, or a feature
+     * module that reports {@link RowPresenter.hierarchical} (row grouping, a
+     * pivot tree, server-side groups). The grid role is read from here.
+     */
+    get hierarchical(): boolean;
     /**
      * Asks feature modules implementing {@link RowAriaProvider} for ARIA
      * tree/expansion semantics on a normal (cell-rendered) row — e.g. pivoting's
@@ -156,6 +164,11 @@ export declare class StateController<T extends object> implements ReactiveContro
      * for the community grid (no modules).
      */
     get hasColumnMenu(): boolean;
+    /**
+     * Whether any feature module implements {@link CellDecorator}, so a cell can
+     * skip decoration altogether when none does (the community grid).
+     */
+    get hasCellDecorators(): boolean;
     /**
      * Collects per-cell decoration contributed by feature modules implementing
      * {@link CellDecorator}, merging their attribute maps (later modules win on a

package/controllers/state.js

@@ -23,7 +23,7 @@ export class StateController {
             return;
         }
         this.#announceToken = (this.#announceToken + 1) % 2;
-        this.announcement = this.#announceToken ? message : `${message} `;
+        this.announcement = this.#announceToken ? message : `${message}\u200B`;
         this.host.requestUpdate();
     }
     localize(key, params, fallback) {
@@ -50,10 +50,6 @@ export class StateController {
     get toolbar() {
         return this.host.toolbar;
     }
-    get pinOffsets() {
-        const dom = this.host.DOM;
-        return dom?.pinOffsets ?? new Map();
-    }
     constructor(host, extraModules = []) {
         this.host = host;
         this.extraModules = extraModules;
@@ -62,6 +58,7 @@ export class StateController {
         this.#announceToken = 0;
         this.#transformers = [];
         this.#synthesizers = [];
+        this.#hooks = new Map();
         this.#decorationVersion = 0;
         this.dataVersion = 0;
         this.host.addController(this);
@@ -99,6 +96,15 @@ export class StateController {
     }
     #transformers;
     #synthesizers;
+    #hooks;
+    #withHook(guard) {
+        let list = this.#hooks.get(guard);
+        if (!list) {
+            list = [...this.modules.values()].filter(guard);
+            this.#hooks.set(guard, list);
+        }
+        return list;
+    }
     module(id) {
         return this.modules.get(id);
     }
@@ -142,42 +148,49 @@ export class StateController {
         return out;
     }
     presentRow(row, ctx) {
-        for (const controller of this.modules.values()) {
-            if (isRowPresenter(controller)) {
-                const presented = controller.presentRow(row, ctx);
-                if (presented)
-                    return presented;
-            }
+        for (const controller of this.#withHook((isRowPresenter))) {
+            const presented = controller.presentRow(row, ctx);
+            if (presented)
+                return presented;
         }
         return null;
     }
-    describeRow(row, ctx) {
+    get colCount() {
+        return (this.host.columns.filter((column) => !column.hidden).length +
+            (this.selection.showCheckboxColumn ? 1 : 0) +
+            (this.expansion.showToggleColumn ? 1 : 0));
+    }
+    get hierarchical() {
+        if (this.tree.enabled || (this.expansion.enabled && this.host.expansion?.detailTemplate)) {
+            return true;
+        }
         for (const controller of this.modules.values()) {
-            if (isRowAriaProvider(controller)) {
-                const aria = controller.describeRow(row, ctx);
-                if (aria)
-                    return aria;
-            }
+            if (controller.hierarchical)
+                return true;
+        }
+        return false;
+    }
+    describeRow(row, ctx) {
+        for (const controller of this.#withHook((isRowAriaProvider))) {
+            const aria = controller.describeRow(row, ctx);
+            if (aria)
+                return aria;
         }
         return null;
     }
     rowCoordinate(row) {
-        for (const controller of this.modules.values()) {
-            if (isCoordinateLabeler(controller)) {
-                const label = controller.rowCoordinate(row);
-                if (label !== undefined)
-                    return label;
-            }
+        for (const controller of this.#withHook((isCoordinateLabeler))) {
+            const label = controller.rowCoordinate(row);
+            if (label !== undefined)
+                return label;
         }
         return undefined;
     }
     columnCoordinate(key) {
-        for (const controller of this.modules.values()) {
-            if (isCoordinateLabeler(controller)) {
-                const label = controller.columnCoordinate(key);
-                if (label !== undefined)
-                    return label;
-            }
+        for (const controller of this.#withHook((isCoordinateLabeler))) {
+            const label = controller.columnCoordinate(key);
+            if (label !== undefined)
+                return label;
         }
         return undefined;
     }
@@ -190,31 +203,25 @@ export class StateController {
         this.host.requestUpdate();
     }
     get hasColumnMenu() {
-        for (const controller of this.modules.values()) {
-            if (isColumnMenuProvider(controller) && controller.providesColumnMenu()) {
-                return true;
-            }
-        }
-        return false;
+        return this.#withHook(isColumnMenuProvider).some((controller) => controller.providesColumnMenu());
+    }
+    get hasCellDecorators() {
+        return this.#withHook(isCellDecorator).length > 0;
     }
     decorateCell(ctx) {
         let attributes = null;
-        for (const controller of this.modules.values()) {
-            if (isCellDecorator(controller)) {
-                const decoration = controller.decorateCell(ctx);
-                if (decoration) {
-                    attributes ??= {};
-                    Object.assign(attributes, decoration.attributes);
-                }
+        for (const controller of this.#withHook((isCellDecorator))) {
+            const decoration = controller.decorateCell(ctx);
+            if (decoration) {
+                attributes ??= {};
+                Object.assign(attributes, decoration.attributes);
             }
         }
         return attributes ? { attributes } : null;
     }
     handleCellInteraction(interaction) {
-        for (const controller of this.modules.values()) {
-            if (isCellInteractionHandler(controller)) {
-                controller.handleCellInteraction(interaction);
-            }
+        for (const controller of this.#withHook((isCellInteractionHandler))) {
+            controller.handleCellInteraction(interaction);
         }
     }
     serializeModuleState() {