apex-grid 3.2.0 → 3.4.0

package/controllers/editing.js.map

@@ -1 +1 @@
-{"version":3,"file":"editing.js","sourceRoot":"","sources":["../../src/controllers/editing.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController } from 'lit';\nimport { PIPELINE } from '../internal/constants.js';\nimport type {\n  ColumnConfiguration,\n  EditMode,\n  EditTrigger,\n  GridHost,\n  Keys,\n} from '../internal/types.js';\n\n/**\n * The default editing configuration used when the grid has none set.\n */\nexport const DEFAULT_EDITING_CONFIG = Object.freeze({\n  enabled: false,\n  mode: 'cell' as EditMode,\n  trigger: 'doubleClick' as EditTrigger,\n});\n\ninterface ActiveCell<T> {\n  rowIndex: number;\n  columnKey: Keys<T>;\n  /**\n   * Live reference to the underlying record (preserved through the pipeline so\n   * the source array can be mutated on commit).\n   */\n  data: T;\n}\n\n/**\n * Reactive controller backing inline cell + row editing.\n *\n * @remarks\n * Holds the currently active cell / row, pending values for row-mode edits,\n * and is responsible for emitting the cancellable `cellValueChanging` event\n * and follow-up `cellValueChanged` event. The actual data mutation writes\n * through to {@link ApexGrid.data} so changes survive pipeline runs and\n * propagate to consumers that own the source array.\n */\nexport class EditingController<T extends object> implements ReactiveController {\n  /** The cell currently in edit mode, or `null`. */\n  public activeCell: ActiveCell<T> | null = null;\n\n  /** The row currently in edit mode (row mode only), or `null`. */\n  public activeRow: { rowIndex: number; data: T } | null = null;\n\n  /**\n   * Pending values keyed by column for the currently editing row. Populated in\n   * row mode as the user edits individual cells; flushed on\n   * {@link commitRow}.\n   */\n  public pending: Map<Keys<T>, unknown> = new Map();\n\n  constructor(protected host: GridHost<T>) {\n    this.host.addController(this);\n  }\n\n  public hostConnected() {}\n\n  /**\n   * Whether editing is enabled at the grid level.\n   */\n  public get enabled(): boolean {\n    return Boolean(this.host.editing?.enabled);\n  }\n\n  /**\n   * The resolved edit mode (`'cell'` if unset).\n   */\n  public get mode(): EditMode {\n    return this.host.editing?.mode ?? DEFAULT_EDITING_CONFIG.mode;\n  }\n\n  /**\n   * The resolved edit trigger (`'doubleClick'` if unset).\n   */\n  public get trigger(): EditTrigger {\n    return this.host.editing?.trigger ?? DEFAULT_EDITING_CONFIG.trigger;\n  }\n\n  /**\n   * Whether the given column can be edited.\n   */\n  public isEditable(column: ColumnConfiguration<T>): boolean {\n    return Boolean(this.enabled && column.editable && !column.hidden);\n  }\n\n  /**\n   * Whether the cell `(rowIndex, columnKey)` is currently in edit mode.\n   */\n  public isCellEditing(rowIndex: number, columnKey: Keys<T>): boolean {\n    return this.activeCell?.rowIndex === rowIndex && this.activeCell?.columnKey === columnKey;\n  }\n\n  /**\n   * Whether the given row is currently in edit mode (row mode).\n   */\n  public isRowEditing(rowIndex: number): boolean {\n    return this.activeRow?.rowIndex === rowIndex;\n  }\n\n  /**\n   * Begins editing the cell at `(rowIndex, columnKey)`. Auto-commits any cell\n   * already in edit mode (in cell mode); in row mode it switches the active\n   * cell within the same row and rejects cross-row moves.\n   *\n   * @returns `true` if edit started, `false` if rejected (column not editable\n   * or row-mode constraint violated).\n   */\n  public async editCell(rowIndex: number, columnKey: Keys<T>): Promise<boolean> {\n    if (!this.enabled) return false;\n    const column = this.host.getColumn(columnKey);\n    if (!column || !this.isEditable(column)) return false;\n    const data = this.host.pageItems[rowIndex] as T | undefined;\n    if (!data) return false;\n\n    if (this.mode === 'row') {\n      if (!this.activeRow) {\n        await this.editRow(rowIndex);\n      } else if (this.activeRow.rowIndex !== rowIndex) {\n        // Switching rows in row mode — commit pending edits in the previous row\n        // before starting elsewhere.\n        const committed = await this.commitRow();\n        if (!committed) return false;\n        await this.editRow(rowIndex);\n      }\n    } else if (this.activeCell && !this.isCellEditing(rowIndex, columnKey)) {\n      // Cell mode — commit any in-flight cell before switching.\n      await this.commitCell();\n    }\n\n    this.activeCell = { rowIndex, columnKey, data };\n    this.host.requestUpdate();\n    return true;\n  }\n\n  /**\n   * Begins editing the given row in row mode. Emits `rowEditStarted` on\n   * success. No-op in cell mode.\n   */\n  public async editRow(rowIndex: number): Promise<boolean> {\n    if (!this.enabled || this.mode !== 'row') return false;\n    const data = this.host.pageItems[rowIndex] as T | undefined;\n    if (!data) return false;\n    if (this.activeRow && this.activeRow.rowIndex !== rowIndex) {\n      const committed = await this.commitRow();\n      if (!committed) return false;\n    }\n    if (this.activeRow?.rowIndex === rowIndex) return true;\n    this.activeRow = { rowIndex, data };\n    this.pending.clear();\n    this.host.requestUpdate();\n    this.host.emitEvent('rowEditStarted', { detail: { rowIndex } });\n    return true;\n  }\n\n  /**\n   * Commits a candidate value for the currently editing cell. In cell mode the\n   * value is written through to {@link ApexGrid.data}; in row mode it is staged\n   * in {@link pending} until {@link commitRow} is called.\n   *\n   * @param value - The candidate value.\n   * @returns `true` if accepted (or staged), `false` if rejected by\n   * `cellValueChanging.preventDefault()`.\n   */\n  public async commitCell(value?: unknown): Promise<boolean> {\n    const active = this.activeCell;\n    if (!active) return false;\n    const { rowIndex, columnKey, data } = active;\n    const oldValue = (data as Record<string, unknown>)[columnKey as string];\n    const candidate = value === undefined ? oldValue : value;\n\n    if (this.mode === 'cell') {\n      if (Object.is(candidate, oldValue)) {\n        this.activeCell = null;\n        this.host.requestUpdate();\n        return true;\n      }\n      const proceed = this.host.emitEvent('cellValueChanging', {\n        detail: { key: columnKey, rowIndex, data, oldValue, newValue: candidate },\n        cancelable: true,\n      });\n      if (!proceed) return false;\n      (data as Record<string, unknown>)[columnKey as string] = candidate;\n      this.activeCell = null;\n      this.host.requestUpdate(PIPELINE);\n      await this.host.updateComplete;\n      this.host.emitEvent('cellValueChanged', {\n        detail: { key: columnKey, rowIndex, data, value: candidate },\n      });\n      return true;\n    }\n\n    // Row mode — stage and exit cell edit (row stays open).\n    if (!Object.is(candidate, oldValue)) {\n      this.pending.set(columnKey, candidate);\n    }\n    this.activeCell = null;\n    this.host.requestUpdate();\n    return true;\n  }\n\n  /**\n   * Writes `value` directly to the cell at `(rowIndex, columnKey)` without\n   * entering edit mode. Used by interactive display widgets (e.g. the boolean\n   * checkbox) that handle their own input. Goes through the same\n   * `cellValueChanging` / `cellValueChanged` event path as a normal commit.\n   *\n   * @returns `true` if the value was applied, `false` if rejected by\n   * `cellValueChanging.preventDefault()` or the column is not editable.\n   */\n  public async commitImmediate(\n    rowIndex: number,\n    columnKey: Keys<T>,\n    value: unknown\n  ): Promise<boolean> {\n    if (!this.enabled) return false;\n    const column = this.host.getColumn(columnKey);\n    if (!column || !this.isEditable(column)) return false;\n    const data = this.host.pageItems[rowIndex] as T | undefined;\n    if (!data) return false;\n    const oldValue = (data as Record<string, unknown>)[columnKey as string];\n    if (Object.is(value, oldValue)) return true;\n    const proceed = this.host.emitEvent('cellValueChanging', {\n      detail: { key: columnKey, rowIndex, data, oldValue, newValue: value },\n      cancelable: true,\n    });\n    if (!proceed) return false;\n    (data as Record<string, unknown>)[columnKey as string] = value;\n    this.host.requestUpdate(PIPELINE);\n    await this.host.updateComplete;\n    this.host.emitEvent('cellValueChanged', {\n      detail: { key: columnKey, rowIndex, data, value },\n    });\n    return true;\n  }\n\n  /**\n   * Discards the current cell edit without writing. In row mode the row edit\n   * stays open.\n   */\n  public cancelCell(): void {\n    if (!this.activeCell) return;\n    this.activeCell = null;\n    this.host.requestUpdate();\n  }\n\n  /**\n   * Commits all pending edits for the currently editing row. Emits\n   * `cellValueChanging` for every changed cell and `rowEditEnded` at the end.\n   *\n   * @returns `true` if the row was applied, `false` if any cell change was\n   * cancelled (the row remains in edit mode in that case).\n   */\n  public async commitRow(): Promise<boolean> {\n    const active = this.activeRow;\n    if (!active) return false;\n    const { rowIndex, data } = active;\n\n    // Make sure any open cell editor flushes its pending value first.\n    if (this.activeCell?.rowIndex === rowIndex) {\n      await this.commitCell();\n    }\n\n    for (const [columnKey, candidate] of this.pending) {\n      const oldValue = (data as Record<string, unknown>)[columnKey as string];\n      if (Object.is(candidate, oldValue)) continue;\n      const proceed = this.host.emitEvent('cellValueChanging', {\n        detail: { key: columnKey, rowIndex, data, oldValue, newValue: candidate },\n        cancelable: true,\n      });\n      if (!proceed) return false;\n      (data as Record<string, unknown>)[columnKey as string] = candidate;\n      this.host.emitEvent('cellValueChanged', {\n        detail: { key: columnKey, rowIndex, data, value: candidate },\n      });\n    }\n\n    this.pending.clear();\n    this.activeRow = null;\n    this.host.requestUpdate(PIPELINE);\n    await this.host.updateComplete;\n    this.host.emitEvent('rowEditEnded', { detail: { rowIndex, committed: true } });\n    return true;\n  }\n\n  /**\n   * Discards every pending edit for the active row and exits row edit mode.\n   * Emits `rowEditEnded` with `committed: false`.\n   */\n  public cancelRow(): void {\n    if (!this.activeRow) return;\n    const { rowIndex } = this.activeRow;\n    this.activeCell = null;\n    this.activeRow = null;\n    this.pending.clear();\n    this.host.requestUpdate();\n    this.host.emitEvent('rowEditEnded', { detail: { rowIndex, committed: false } });\n  }\n\n  /**\n   * Returns the current pending or committed value for `(rowIndex, columnKey)`.\n   * Cells in row mode read this so unstaged-but-pending values are reflected\n   * during the edit.\n   */\n  public getValue(rowIndex: number, columnKey: Keys<T>): unknown {\n    if (\n      this.mode === 'row' &&\n      this.activeRow?.rowIndex === rowIndex &&\n      this.pending.has(columnKey)\n    ) {\n      return this.pending.get(columnKey);\n    }\n    const data = this.host.pageItems[rowIndex] as T | undefined;\n    return data ? (data as Record<string, unknown>)[columnKey as string] : undefined;\n  }\n}\n"]}
+{"version":3,"file":"editing.js","sourceRoot":"","sources":["../../src/controllers/editing.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController } from 'lit';\nimport { PIPELINE } from '../internal/constants.js';\nimport type {\n  ColumnConfiguration,\n  EditMode,\n  EditTrigger,\n  GridHost,\n  Keys,\n  Validator,\n  ValidatorContext,\n} from '../internal/types.js';\nimport { runValidators } from '../internal/validators.js';\nimport type { HistoryController } from './history.js';\n\n/**\n * The default editing configuration used when the grid has none set.\n */\nexport const DEFAULT_EDITING_CONFIG = Object.freeze({\n  enabled: false,\n  mode: 'cell' as EditMode,\n  trigger: 'doubleClick' as EditTrigger,\n});\n\ninterface ActiveCell<T> {\n  rowIndex: number;\n  columnKey: Keys<T>;\n  /**\n   * Live reference to the underlying record (preserved through the pipeline so\n   * the source array can be mutated on commit).\n   */\n  data: T;\n}\n\n/**\n * Outcome of a single committed cell edit routed through\n * {@link EditingController.applyCellEdit}.\n *\n * - `'unchanged'` - the candidate equalled the current value; nothing happened.\n * - `'invalid'` - a column validator rejected the candidate; the value was not\n *   written and `cellValidationFailed` fired.\n * - `'cancelled'` - a `cellValueChanging` listener called `preventDefault()`.\n * - `'applied'` - the value was written and `cellValueChanged` fired.\n */\nexport type CellEditResult = 'unchanged' | 'invalid' | 'cancelled' | 'applied';\n\n/**\n * Options for {@link EditingController.applyCellEdit}.\n */\nexport interface ApplyCellEditOptions {\n  /**\n   * Run the column's declarative validators before writing. Defaults to `true`.\n   * Set to `false` for writes that must not be re-validated (e.g. reverting a\n   * previously valid value during undo/redo).\n   */\n  validate?: boolean;\n}\n\n/**\n * Reactive controller backing inline cell + row editing.\n *\n * @remarks\n * Holds the currently active cell / row, pending values for row-mode edits,\n * and is responsible for emitting the cancellable `cellValueChanging` event\n * and follow-up `cellValueChanged` event. The actual data mutation writes\n * through to {@link ApexGrid.data} so changes survive pipeline runs and\n * propagate to consumers that own the source array.\n */\nexport class EditingController<T extends object> implements ReactiveController {\n  /** The cell currently in edit mode, or `null`. */\n  public activeCell: ActiveCell<T> | null = null;\n\n  /** The row currently in edit mode (row mode only), or `null`. */\n  public activeRow: { rowIndex: number; data: T } | null = null;\n\n  /**\n   * Pending values keyed by column for the currently editing row. Populated in\n   * row mode as the user edits individual cells; flushed on\n   * {@link commitRow}.\n   */\n  public pending: Map<Keys<T>, unknown> = new Map();\n\n  /**\n   * Per-record validation errors, keyed by the live data reference and then by\n   * column. Keyed by reference (not row index) so an invalid marker tracks its\n   * row across pipeline runs (sort / filter / paginate).\n   */\n  #invalid: Map<T, Map<Keys<T>, string[]>> = new Map();\n\n  #validationVersion = 0;\n\n  /**\n   * Monotonic token bumped whenever the validation-error set changes. Forwarded\n   * down to each cell as a reactive property so a validation-only change\n   * re-renders the affected cells (toggling `aria-invalid` and the error node)\n   * without re-running the data pipeline. Stays `0` until the first failure.\n   */\n  public get validationVersion(): number {\n    return this.#validationVersion;\n  }\n\n  constructor(\n    protected host: GridHost<T>,\n    protected history?: HistoryController<T>\n  ) {\n    this.host.addController(this);\n  }\n\n  public hostConnected() {}\n\n  /**\n   * Whether editing is enabled at the grid level.\n   */\n  public get enabled(): boolean {\n    return Boolean(this.host.editing?.enabled);\n  }\n\n  /**\n   * The resolved edit mode (`'cell'` if unset).\n   */\n  public get mode(): EditMode {\n    return this.host.editing?.mode ?? DEFAULT_EDITING_CONFIG.mode;\n  }\n\n  /**\n   * The resolved edit trigger (`'doubleClick'` if unset).\n   */\n  public get trigger(): EditTrigger {\n    return this.host.editing?.trigger ?? DEFAULT_EDITING_CONFIG.trigger;\n  }\n\n  /**\n   * Whether the given column can be edited.\n   */\n  public isEditable(column: ColumnConfiguration<T>): boolean {\n    return Boolean(this.enabled && column.editable && !column.hidden);\n  }\n\n  /**\n   * Whether the cell `(rowIndex, columnKey)` is currently in edit mode.\n   */\n  public isCellEditing(rowIndex: number, columnKey: Keys<T>): boolean {\n    return this.activeCell?.rowIndex === rowIndex && this.activeCell?.columnKey === columnKey;\n  }\n\n  /**\n   * Whether the given row is currently in edit mode (row mode).\n   */\n  public isRowEditing(rowIndex: number): boolean {\n    return this.activeRow?.rowIndex === rowIndex;\n  }\n\n  /**\n   * Begins editing the cell at `(rowIndex, columnKey)`. Auto-commits any cell\n   * already in edit mode (in cell mode); in row mode it switches the active\n   * cell within the same row and rejects cross-row moves.\n   *\n   * @returns `true` if edit started, `false` if rejected (column not editable\n   * or row-mode constraint violated).\n   */\n  public async editCell(rowIndex: number, columnKey: Keys<T>): Promise<boolean> {\n    if (!this.enabled) return false;\n    const column = this.host.getColumn(columnKey);\n    if (!column || !this.isEditable(column)) return false;\n    const data = this.host.pageItems[rowIndex] as T | undefined;\n    if (!data) return false;\n\n    if (this.mode === 'row') {\n      if (!this.activeRow) {\n        await this.editRow(rowIndex);\n      } else if (this.activeRow.rowIndex !== rowIndex) {\n        // Switching rows in row mode — commit pending edits in the previous row\n        // before starting elsewhere.\n        const committed = await this.commitRow();\n        if (!committed) return false;\n        await this.editRow(rowIndex);\n      }\n    } else if (this.activeCell && !this.isCellEditing(rowIndex, columnKey)) {\n      // Cell mode — commit any in-flight cell before switching.\n      await this.commitCell();\n    }\n\n    this.activeCell = { rowIndex, columnKey, data };\n    this.host.requestUpdate();\n    return true;\n  }\n\n  /**\n   * Begins editing the given row in row mode. Emits `rowEditStarted` on\n   * success. No-op in cell mode.\n   */\n  public async editRow(rowIndex: number): Promise<boolean> {\n    if (!this.enabled || this.mode !== 'row') return false;\n    const data = this.host.pageItems[rowIndex] as T | undefined;\n    if (!data) return false;\n    if (this.activeRow && this.activeRow.rowIndex !== rowIndex) {\n      const committed = await this.commitRow();\n      if (!committed) return false;\n    }\n    if (this.activeRow?.rowIndex === rowIndex) return true;\n    this.activeRow = { rowIndex, data };\n    this.pending.clear();\n    this.host.requestUpdate();\n    this.host.emitEvent('rowEditStarted', { detail: { rowIndex } });\n    return true;\n  }\n\n  /**\n   * The single choke point for committing a cell value to the backing record.\n   * Short-circuits no-op writes, runs the cancellable `cellValueChanging` gate,\n   * writes the value through to {@link ApexGrid.data}, and emits\n   * `cellValueChanged`. Returns the {@link CellEditResult} so callers can manage\n   * their own UI state (active cell) and batch the render.\n   *\n   * @remarks\n   * Does **not** request a render — callers refresh (once per edit, or once per\n   * batch) so row-mode and bulk edits coalesce into a single pipeline pass.\n   * Every committed edit (single-cell, row-mode, and enterprise paste/fill)\n   * funnels through here so cross-cutting concerns (validation, undo/redo) have\n   * one place to hook the old/new values and the write.\n   */\n  public applyCellEdit(\n    rowIndex: number,\n    columnKey: Keys<T>,\n    data: T,\n    value: unknown,\n    options?: ApplyCellEditOptions\n  ): CellEditResult {\n    const record = data as Record<string, unknown>;\n    const oldValue = record[columnKey as string];\n    if (Object.is(value, oldValue)) {\n      // Re-entering the original value clears any stale invalid marker.\n      this.clearCellErrors(data, columnKey);\n      return 'unchanged';\n    }\n\n    if (options?.validate !== false) {\n      const errors = this.validateCell(rowIndex, columnKey, data, value);\n      if (errors.length > 0) {\n        this.#setCellErrors(data, columnKey, errors);\n        this.host.emitEvent('cellValidationFailed', {\n          detail: { key: columnKey, rowIndex, data, value, errors },\n        });\n        return 'invalid';\n      }\n    }\n\n    const proceed = this.host.emitEvent('cellValueChanging', {\n      detail: { key: columnKey, rowIndex, data, oldValue, newValue: value },\n      cancelable: true,\n    });\n    if (!proceed) return 'cancelled';\n\n    record[columnKey as string] = value;\n    this.clearCellErrors(data, columnKey);\n    this.history?.record({ record: data, key: columnKey, rowIndex, oldValue, newValue: value });\n    this.host.emitEvent('cellValueChanged', {\n      detail: { key: columnKey, rowIndex, data, value },\n    });\n    return 'applied';\n  }\n\n  /**\n   * Runs the column's declarative validators against a candidate value and\n   * returns the collected error messages (empty when the value passes or the\n   * column has no validators).\n   */\n  public validateCell(rowIndex: number, columnKey: Keys<T>, data: T, value: unknown): string[] {\n    const column = this.host.getColumn(columnKey);\n    if (!column?.validators?.length) return [];\n    // `ColumnConfiguration<T>` is a distributive conditional, so `validators`\n    // and `column` widen to a per-key union here; collapse to the base form for\n    // the runner (the runtime shapes are identical).\n    return runValidators(column.validators as Validator<T>[], value, {\n      column,\n      data,\n      rowIndex,\n    } as ValidatorContext<T>);\n  }\n\n  /**\n   * The current validation errors for `(data, columnKey)`, or `null` when the\n   * cell is valid. Read by {@link ApexGridCell} to drive `aria-invalid` and the\n   * inline error node.\n   */\n  public getCellErrors(data: T, columnKey: Keys<T>): readonly string[] | null {\n    return this.#invalid.get(data)?.get(columnKey) ?? null;\n  }\n\n  /**\n   * Clears any validation error recorded for `(data, columnKey)`.\n   */\n  public clearCellErrors(data: T, columnKey: Keys<T>): void {\n    const perColumn = this.#invalid.get(data);\n    if (!perColumn) return;\n    if (perColumn.delete(columnKey)) {\n      if (perColumn.size === 0) this.#invalid.delete(data);\n      this.#validationVersion += 1;\n    }\n  }\n\n  /**\n   * Clears every validation error recorded for a record (all columns).\n   */\n  public clearRecordErrors(data: T): void {\n    if (this.#invalid.delete(data)) {\n      this.#validationVersion += 1;\n    }\n  }\n\n  #setCellErrors(data: T, columnKey: Keys<T>, errors: string[]): void {\n    let perColumn = this.#invalid.get(data);\n    if (!perColumn) {\n      perColumn = new Map();\n      this.#invalid.set(data, perColumn);\n    }\n    perColumn.set(columnKey, errors);\n    this.#validationVersion += 1;\n  }\n\n  /**\n   * Commits a candidate value for the currently editing cell. In cell mode the\n   * value is written through to {@link ApexGrid.data}; in row mode it is staged\n   * in {@link pending} until {@link commitRow} is called.\n   *\n   * @param value - The candidate value.\n   * @returns `true` if accepted (or staged), `false` if rejected by\n   * `cellValueChanging.preventDefault()`.\n   */\n  public async commitCell(value?: unknown): Promise<boolean> {\n    const active = this.activeCell;\n    if (!active) return false;\n    const { rowIndex, columnKey, data } = active;\n    const oldValue = (data as Record<string, unknown>)[columnKey as string];\n    const candidate = value === undefined ? oldValue : value;\n\n    if (this.mode === 'cell') {\n      const result = this.applyCellEdit(rowIndex, columnKey, data, candidate);\n      if (result === 'cancelled') return false;\n      // A failed validation keeps the editor open so the user can correct the\n      // value; re-render to surface `aria-invalid` + the error node.\n      if (result === 'invalid') {\n        this.host.requestUpdate();\n        return false;\n      }\n      // Both 'applied' and 'unchanged' close the editor; only an applied write\n      // needs the data pipeline to re-run.\n      this.activeCell = null;\n      if (result === 'applied') {\n        this.host.requestUpdate(PIPELINE);\n        await this.host.updateComplete;\n      } else {\n        this.host.requestUpdate();\n      }\n      return true;\n    }\n\n    // Row mode — stage and exit cell edit (row stays open).\n    if (!Object.is(candidate, oldValue)) {\n      this.pending.set(columnKey, candidate);\n    }\n    this.activeCell = null;\n    this.host.requestUpdate();\n    return true;\n  }\n\n  /**\n   * Writes `value` directly to the cell at `(rowIndex, columnKey)` without\n   * entering edit mode. Used by interactive display widgets (e.g. the boolean\n   * checkbox) that handle their own input. Goes through the same\n   * `cellValueChanging` / `cellValueChanged` event path as a normal commit.\n   *\n   * @returns `true` if the value was applied, `false` if rejected by\n   * `cellValueChanging.preventDefault()` or the column is not editable.\n   */\n  public async commitImmediate(\n    rowIndex: number,\n    columnKey: Keys<T>,\n    value: unknown\n  ): Promise<boolean> {\n    if (!this.enabled) return false;\n    const column = this.host.getColumn(columnKey);\n    if (!column || !this.isEditable(column)) return false;\n    const data = this.host.pageItems[rowIndex] as T | undefined;\n    if (!data) return false;\n\n    const result = this.applyCellEdit(rowIndex, columnKey, data, value);\n    if (result === 'cancelled') return false;\n    if (result === 'invalid') {\n      this.host.requestUpdate();\n      return false;\n    }\n    if (result === 'applied') {\n      this.host.requestUpdate(PIPELINE);\n      await this.host.updateComplete;\n    }\n    return true;\n  }\n\n  /**\n   * Discards the current cell edit without writing. In row mode the row edit\n   * stays open.\n   */\n  public cancelCell(): void {\n    if (!this.activeCell) return;\n    const { data, columnKey } = this.activeCell;\n    this.activeCell = null;\n    // Abandoning the edit discards any validation error raised for the cell.\n    this.clearCellErrors(data, columnKey);\n    this.host.requestUpdate();\n  }\n\n  /**\n   * Commits all pending edits for the currently editing row. Emits\n   * `cellValueChanging` for every changed cell and `rowEditEnded` at the end.\n   *\n   * @returns `true` if the row was applied, `false` if any cell change was\n   * cancelled (the row remains in edit mode in that case).\n   */\n  public async commitRow(): Promise<boolean> {\n    const active = this.activeRow;\n    if (!active) return false;\n    const { rowIndex, data } = active;\n\n    // Make sure any open cell editor flushes its pending value first.\n    if (this.activeCell?.rowIndex === rowIndex) {\n      await this.commitCell();\n    }\n\n    // Pre-validate every pending cell so a single failure aborts the whole row\n    // commit without a partial write. Each failing cell is marked invalid and\n    // the row stays in edit mode.\n    let hasInvalid = false;\n    for (const [columnKey, candidate] of this.pending) {\n      const errors = this.validateCell(rowIndex, columnKey, data, candidate);\n      if (errors.length > 0) {\n        this.#setCellErrors(data, columnKey, errors);\n        this.host.emitEvent('cellValidationFailed', {\n          detail: { key: columnKey, rowIndex, data, value: candidate, errors },\n        });\n        hasInvalid = true;\n      }\n    }\n    if (hasInvalid) {\n      this.host.requestUpdate();\n      return false;\n    }\n\n    // Coalesce the row's writes into one undo step.\n    this.history?.beginBatch();\n    try {\n      for (const [columnKey, candidate] of this.pending) {\n        // Validation already ran above; a cancelled cell aborts the whole row\n        // commit, leaving it in edit mode.\n        if (\n          this.applyCellEdit(rowIndex, columnKey, data, candidate, { validate: false }) ===\n          'cancelled'\n        ) {\n          return false;\n        }\n      }\n    } finally {\n      this.history?.endBatch();\n    }\n\n    this.pending.clear();\n    this.activeRow = null;\n    this.host.requestUpdate(PIPELINE);\n    await this.host.updateComplete;\n    this.host.emitEvent('rowEditEnded', { detail: { rowIndex, committed: true } });\n    return true;\n  }\n\n  /**\n   * Discards every pending edit for the active row and exits row edit mode.\n   * Emits `rowEditEnded` with `committed: false`.\n   */\n  public cancelRow(): void {\n    if (!this.activeRow) return;\n    const { rowIndex, data } = this.activeRow;\n    this.activeCell = null;\n    this.activeRow = null;\n    this.pending.clear();\n    // Abandoning the row discards every validation error raised for it.\n    this.clearRecordErrors(data);\n    this.host.requestUpdate();\n    this.host.emitEvent('rowEditEnded', { detail: { rowIndex, committed: false } });\n  }\n\n  /**\n   * Returns the current pending or committed value for `(rowIndex, columnKey)`.\n   * Cells in row mode read this so unstaged-but-pending values are reflected\n   * during the edit.\n   */\n  public getValue(rowIndex: number, columnKey: Keys<T>): unknown {\n    if (\n      this.mode === 'row' &&\n      this.activeRow?.rowIndex === rowIndex &&\n      this.pending.has(columnKey)\n    ) {\n      return this.pending.get(columnKey);\n    }\n    const data = this.host.pageItems[rowIndex] as T | undefined;\n    return data ? (data as Record<string, unknown>)[columnKey as string] : undefined;\n  }\n}\n"]}

package/controllers/expansion.js

@@ -106,16 +106,16 @@ export class ExpansionController {
         this.expanded = next;
         this.host.requestUpdate();
         if (added.length === 1 && removed.length === 0) {
-            this.host.announce('Row expanded');
+            this.host.announce(this.host.localize('announce.rowExpanded'));
         }
         else if (added.length === 0 && removed.length === 1) {
-            this.host.announce('Row collapsed');
+            this.host.announce(this.host.localize('announce.rowCollapsed'));
         }
         else if (added.length > 0 && next.size === added.length + this.expanded.size - added.length) {
-            this.host.announce(`${added.length} rows expanded`);
+            this.host.announce(this.host.localize('announce.rowsExpanded', { count: added.length }));
         }
         else if (removed.length > 0 && next.size === 0) {
-            this.host.announce('All rows collapsed');
+            this.host.announce(this.host.localize('announce.allRowsCollapsed'));
         }
         this.host.emitEvent('rowExpanded', {
             detail: { added, removed, expanded: Array.from(this.expanded) },

package/controllers/expansion.js.map

@@ -1 +1 @@
-{"version":3,"file":"expansion.js","sourceRoot":"","sources":["../../src/controllers/expansion.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController } from 'lit';\nimport type { GridHost } from '../internal/types.js';\n\n/**\n * The default expansion configuration used when the grid has none set.\n *\n * @remarks\n * `detailTemplate` defaults to `null` here — the controller will refuse to\n * toggle rows when the configuration is missing or no template is provided.\n */\nexport const DEFAULT_EXPANSION_CONFIG = Object.freeze({\n  enabled: false,\n  showToggleColumn: true,\n});\n\n/**\n * Reactive controller backing row expansion (master-detail).\n *\n * @remarks\n * Expansion state is reference-based — the controller holds a `Set` of row\n * data references so the expansion set survives sort / filter / pagination as\n * long as those operations preserve row identity (the default in-place\n * pipeline does). Replacing {@link ApexGrid.data} wholesale invalidates any\n * expanded rows that are no longer present; consumers should call\n * {@link collapseAll} or re-apply expansion afterwards.\n *\n * Mutations go through the cancellable `rowExpanding` event and emit a\n * follow-up `rowExpanded` event, mirroring the pattern used by selection\n * and editing.\n */\nexport class ExpansionController<T extends object> implements ReactiveController {\n  /** Set of currently expanded row data references. */\n  public expanded: Set<T> = new Set();\n\n  constructor(protected host: GridHost<T>) {\n    this.host.addController(this);\n  }\n\n  public hostConnected() {}\n\n  /** Whether expansion is enabled at the grid level. */\n  public get enabled(): boolean {\n    return Boolean(this.host.expansion?.enabled);\n  }\n\n  /** Whether the built-in chevron toggle column should be rendered. */\n  public get showToggleColumn(): boolean {\n    return (\n      this.enabled &&\n      (this.host.expansion?.showToggleColumn ?? DEFAULT_EXPANSION_CONFIG.showToggleColumn)\n    );\n  }\n\n  /** Whether `row` is currently expanded. */\n  public isExpanded(row: T): boolean {\n    return this.expanded.has(row);\n  }\n\n  /**\n   * Whether `row` is permitted to expand. Combines the grid-wide `enabled`\n   * flag, the presence of a `detailTemplate`, and the optional per-row\n   * `isExpandable` predicate.\n   */\n  public canExpand(row: T): boolean {\n    if (!this.enabled) return false;\n    if (typeof this.host.expansion?.detailTemplate !== 'function') return false;\n    const predicate = this.host.expansion?.isExpandable;\n    return predicate ? Boolean(predicate(row)) : true;\n  }\n\n  /** Snapshot of currently expanded rows in insertion order. */\n  public expandedRows(): T[] {\n    return Array.from(this.expanded);\n  }\n\n  /** Toggles the expansion of `row`. */\n  public async toggleRow(row: T): Promise<boolean> {\n    if (!this.canExpand(row) && !this.expanded.has(row)) return false;\n    const next = new Set(this.expanded);\n    if (next.has(row)) next.delete(row);\n    else next.add(row);\n    return this.#commit(next);\n  }\n\n  /** Expands `row`. No-op when the row is already expanded or not expandable. */\n  public async expandRow(row: T): Promise<boolean> {\n    if (this.expanded.has(row)) return true;\n    if (!this.canExpand(row)) return false;\n    const next = new Set(this.expanded);\n    next.add(row);\n    return this.#commit(next);\n  }\n\n  /** Collapses `row`. No-op when the row is not expanded. */\n  public async collapseRow(row: T): Promise<boolean> {\n    if (!this.expanded.has(row)) return true;\n    const next = new Set(this.expanded);\n    next.delete(row);\n    return this.#commit(next);\n  }\n\n  /**\n   * Expands every expandable row in {@link ApexGrid.dataView}. Skips rows\n   * the optional `isExpandable` predicate rejects.\n   */\n  public async expandAll(): Promise<boolean> {\n    if (!this.enabled || typeof this.host.expansion?.detailTemplate !== 'function') return false;\n    const predicate = this.host.expansion?.isExpandable;\n    const next = new Set(this.expanded);\n    for (const row of this.host.dataView as ReadonlyArray<T>) {\n      if (!predicate || predicate(row)) next.add(row);\n    }\n    return this.#commit(next);\n  }\n\n  /** Collapses every currently expanded row. */\n  public async collapseAll(): Promise<boolean> {\n    if (this.expanded.size === 0) return true;\n    return this.#commit(new Set());\n  }\n\n  /**\n   * Replaces the expansion set with `rows`. Used by the public\n   * {@link ApexGrid.expandedRows} setter for programmatic control.\n   */\n  public async replaceExpansion(rows: ReadonlyArray<T>): Promise<boolean> {\n    if (!this.enabled) return false;\n    const predicate = this.host.expansion?.isExpandable;\n    const next = new Set(predicate ? rows.filter((row) => predicate(row)) : rows);\n    return this.#commit(next);\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.expanded.has(row)) added.push(row);\n    }\n    for (const row of this.expanded) {\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('rowExpanding', {\n      detail: {\n        added,\n        removed,\n        current: Array.from(this.expanded),\n        next: Array.from(next),\n      },\n      cancelable: true,\n    });\n    if (!proceed) return false;\n\n    this.expanded = next;\n    this.host.requestUpdate();\n\n    if (added.length === 1 && removed.length === 0) {\n      this.host.announce('Row expanded');\n    } else if (added.length === 0 && removed.length === 1) {\n      this.host.announce('Row collapsed');\n    } else if (added.length > 0 && next.size === added.length + this.expanded.size - added.length) {\n      this.host.announce(`${added.length} rows expanded`);\n    } else if (removed.length > 0 && next.size === 0) {\n      this.host.announce('All rows collapsed');\n    }\n\n    this.host.emitEvent('rowExpanded', {\n      detail: { added, removed, expanded: Array.from(this.expanded) },\n    });\n    return true;\n  }\n}\n"]}
+{"version":3,"file":"expansion.js","sourceRoot":"","sources":["../../src/controllers/expansion.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController } from 'lit';\nimport type { GridHost } from '../internal/types.js';\n\n/**\n * The default expansion configuration used when the grid has none set.\n *\n * @remarks\n * `detailTemplate` defaults to `null` here — the controller will refuse to\n * toggle rows when the configuration is missing or no template is provided.\n */\nexport const DEFAULT_EXPANSION_CONFIG = Object.freeze({\n  enabled: false,\n  showToggleColumn: true,\n});\n\n/**\n * Reactive controller backing row expansion (master-detail).\n *\n * @remarks\n * Expansion state is reference-based — the controller holds a `Set` of row\n * data references so the expansion set survives sort / filter / pagination as\n * long as those operations preserve row identity (the default in-place\n * pipeline does). Replacing {@link ApexGrid.data} wholesale invalidates any\n * expanded rows that are no longer present; consumers should call\n * {@link collapseAll} or re-apply expansion afterwards.\n *\n * Mutations go through the cancellable `rowExpanding` event and emit a\n * follow-up `rowExpanded` event, mirroring the pattern used by selection\n * and editing.\n */\nexport class ExpansionController<T extends object> implements ReactiveController {\n  /** Set of currently expanded row data references. */\n  public expanded: Set<T> = new Set();\n\n  constructor(protected host: GridHost<T>) {\n    this.host.addController(this);\n  }\n\n  public hostConnected() {}\n\n  /** Whether expansion is enabled at the grid level. */\n  public get enabled(): boolean {\n    return Boolean(this.host.expansion?.enabled);\n  }\n\n  /** Whether the built-in chevron toggle column should be rendered. */\n  public get showToggleColumn(): boolean {\n    return (\n      this.enabled &&\n      (this.host.expansion?.showToggleColumn ?? DEFAULT_EXPANSION_CONFIG.showToggleColumn)\n    );\n  }\n\n  /** Whether `row` is currently expanded. */\n  public isExpanded(row: T): boolean {\n    return this.expanded.has(row);\n  }\n\n  /**\n   * Whether `row` is permitted to expand. Combines the grid-wide `enabled`\n   * flag, the presence of a `detailTemplate`, and the optional per-row\n   * `isExpandable` predicate.\n   */\n  public canExpand(row: T): boolean {\n    if (!this.enabled) return false;\n    if (typeof this.host.expansion?.detailTemplate !== 'function') return false;\n    const predicate = this.host.expansion?.isExpandable;\n    return predicate ? Boolean(predicate(row)) : true;\n  }\n\n  /** Snapshot of currently expanded rows in insertion order. */\n  public expandedRows(): T[] {\n    return Array.from(this.expanded);\n  }\n\n  /** Toggles the expansion of `row`. */\n  public async toggleRow(row: T): Promise<boolean> {\n    if (!this.canExpand(row) && !this.expanded.has(row)) return false;\n    const next = new Set(this.expanded);\n    if (next.has(row)) next.delete(row);\n    else next.add(row);\n    return this.#commit(next);\n  }\n\n  /** Expands `row`. No-op when the row is already expanded or not expandable. */\n  public async expandRow(row: T): Promise<boolean> {\n    if (this.expanded.has(row)) return true;\n    if (!this.canExpand(row)) return false;\n    const next = new Set(this.expanded);\n    next.add(row);\n    return this.#commit(next);\n  }\n\n  /** Collapses `row`. No-op when the row is not expanded. */\n  public async collapseRow(row: T): Promise<boolean> {\n    if (!this.expanded.has(row)) return true;\n    const next = new Set(this.expanded);\n    next.delete(row);\n    return this.#commit(next);\n  }\n\n  /**\n   * Expands every expandable row in {@link ApexGrid.dataView}. Skips rows\n   * the optional `isExpandable` predicate rejects.\n   */\n  public async expandAll(): Promise<boolean> {\n    if (!this.enabled || typeof this.host.expansion?.detailTemplate !== 'function') return false;\n    const predicate = this.host.expansion?.isExpandable;\n    const next = new Set(this.expanded);\n    for (const row of this.host.dataView as ReadonlyArray<T>) {\n      if (!predicate || predicate(row)) next.add(row);\n    }\n    return this.#commit(next);\n  }\n\n  /** Collapses every currently expanded row. */\n  public async collapseAll(): Promise<boolean> {\n    if (this.expanded.size === 0) return true;\n    return this.#commit(new Set());\n  }\n\n  /**\n   * Replaces the expansion set with `rows`. Used by the public\n   * {@link ApexGrid.expandedRows} setter for programmatic control.\n   */\n  public async replaceExpansion(rows: ReadonlyArray<T>): Promise<boolean> {\n    if (!this.enabled) return false;\n    const predicate = this.host.expansion?.isExpandable;\n    const next = new Set(predicate ? rows.filter((row) => predicate(row)) : rows);\n    return this.#commit(next);\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.expanded.has(row)) added.push(row);\n    }\n    for (const row of this.expanded) {\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('rowExpanding', {\n      detail: {\n        added,\n        removed,\n        current: Array.from(this.expanded),\n        next: Array.from(next),\n      },\n      cancelable: true,\n    });\n    if (!proceed) return false;\n\n    this.expanded = next;\n    this.host.requestUpdate();\n\n    if (added.length === 1 && removed.length === 0) {\n      this.host.announce(this.host.localize('announce.rowExpanded'));\n    } else if (added.length === 0 && removed.length === 1) {\n      this.host.announce(this.host.localize('announce.rowCollapsed'));\n    } else if (added.length > 0 && next.size === added.length + this.expanded.size - added.length) {\n      this.host.announce(this.host.localize('announce.rowsExpanded', { count: added.length }));\n    } else if (removed.length > 0 && next.size === 0) {\n      this.host.announce(this.host.localize('announce.allRowsCollapsed'));\n    }\n\n    this.host.emitEvent('rowExpanded', {\n      detail: { added, removed, expanded: Array.from(this.expanded) },\n    });\n    return true;\n  }\n}\n"]}

package/controllers/filter.d.ts

@@ -12,7 +12,7 @@ export declare class FilterController<T extends object> implements ReactiveContr
     hostUpdate(): void;
     get(key: Keys<T>): import("../operations/filter/tree.js").FilterExpressionTree<T> | undefined;
     reset(key?: Keys<T>): void;
-    setActiveColumn(column?: ColumnConfiguration<T>): void;
+    setActiveColumn(column?: ColumnConfiguration<T>, triggerRect?: DOMRect): void;
     getDefaultExpression(column: ColumnConfiguration<T>): FilterExpression<T>;
     removeAllExpressions(key: Keys<T>): Promise<void>;
     removeExpression(expression: FilterExpression<T>): Promise<void>;

package/controllers/filter.js

@@ -43,12 +43,23 @@ export class FilterController {
     reset(key) {
         key ? this.state.delete(key) : this.state.clear();
     }
-    setActiveColumn(column) {
-        if (column?.filter && this.filterRow?.active) {
-            this.filterRow.column = column;
-            this.filterRow.expression = this.getDefaultExpression(column);
-            this.host.requestUpdate();
+    setActiveColumn(column, triggerRect) {
+        const filterRow = this.filterRow;
+        if (!filterRow)
+            return;
+        if (!column?.filter) {
+            filterRow.active = false;
+            return;
         }
+        if (filterRow.active && filterRow.column?.key === column.key) {
+            filterRow.active = false;
+            return;
+        }
+        filterRow.triggerRect = triggerRect ?? null;
+        filterRow.column = column;
+        filterRow.expression = this.getDefaultExpression(column);
+        filterRow.active = true;
+        this.host.requestUpdate();
     }
     getDefaultExpression(column) {
         const caseSensitive = typeof column.filter === 'boolean' ? false : Boolean(column.filter?.caseSensitive);
@@ -75,6 +86,7 @@ export class FilterController {
         this.reset(key);
         this.#filter([]);
         await this.host.updateComplete;
+        this.#announce(key, 'cleared');
         this.#emitFilteredEvent({ key, state: this.get(key)?.all ?? [] });
     }
     async removeExpression(expression) {
@@ -88,6 +100,7 @@ export class FilterController {
         }
         this.#filter([]);
         await this.host.updateComplete;
+        this.#announce(expression.key, 'cleared');
         this.#emitFilteredEvent({ key: expression.key, state: state?.all ?? [] });
     }
     async filterWithEvent(expression, type) {
@@ -96,8 +109,17 @@ export class FilterController {
         }
         this.#filter(expression);
         await this.host.updateComplete;
+        if (type === 'add')
+            this.#announce(expression.key, 'applied');
         this.#emitFilteredEvent({ key: expression.key, state: this.get(expression.key)?.all ?? [] });
     }
+    #announce(key, kind) {
+        const column = this.host.getColumn(key);
+        const label = column?.headerText ?? String(key);
+        this.host.announce(this.host.localize(kind === 'applied' ? 'announce.filtered' : 'announce.filterCleared', {
+            label,
+        }));
+    }
     filter(expression) {
         this.#filter(asArray(expression).map((expr) => Object.assign(this.getDefaultExpression(this.host.getColumn(expr.key)), expr)));
     }

package/controllers/filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../src/controllers/filter.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController } from 'lit';\nimport type { ApexFilteredEvent } from '../components/grid.js';\nimport { PIPELINE } from '../internal/constants.js';\nimport type { ColumnConfiguration, GridHost, Keys } from '../internal/types.js';\nimport { asArray, getFilterOperandsFor } from '../internal/utils.js';\nimport { FilterState } from '../operations/filter/state.js';\nimport type { FilterExpression } from '../operations/filter/types.js';\n\nexport class FilterController<T extends object> implements ReactiveController {\n  constructor(protected host: GridHost<T>) {\n    this.host.addController(this);\n  }\n\n  public state: FilterState<T> = new FilterState();\n\n  public get filterRow() {\n    // @ts-expect-error - protected access\n    return this.host.filterRow;\n  }\n\n  get #virtualizer() {\n    // @ts-expect-error - protected access\n    return this.host.scrollContainer;\n  }\n\n  #emitFilteringEvent(expression: FilterExpression<T>, type: 'add' | 'modify' | 'remove') {\n    return this.host.emitEvent('filtering', {\n      detail: {\n        key: expression.key,\n        expressions: [expression],\n        type,\n      },\n      cancelable: true,\n    });\n  }\n\n  #emitFilteredEvent(detail?: ApexFilteredEvent<T>) {\n    return this.host.emitEvent('filtered', { detail });\n  }\n\n  #filter(expression: FilterExpression<T> | FilterExpression<T>[]) {\n    for (const expr of asArray(expression)) {\n      this.state.set(expr);\n    }\n\n    // HACK: In the case where the scrollTop is a large and amount and a big chunk of data is filtered out\n    // HACK: the virtualizer can't recalculate its scroll position correctly. Thus, we reset the scrollTop state.\n    this.#virtualizer?.scrollTo({ top: 0 });\n    this.host.requestUpdate(PIPELINE);\n  }\n\n  public hostConnected() {}\n\n  public hostUpdate(): void {\n    this.filterRow?.requestUpdate();\n  }\n\n  public get(key: Keys<T>) {\n    return this.state.get(key);\n  }\n\n  public reset(key?: Keys<T>) {\n    key ? this.state.delete(key) : this.state.clear();\n  }\n\n  public setActiveColumn(column?: ColumnConfiguration<T>) {\n    if (column?.filter && this.filterRow?.active) {\n      this.filterRow.column = column;\n      this.filterRow.expression = this.getDefaultExpression(column);\n      this.host.requestUpdate();\n    }\n  }\n\n  public getDefaultExpression(column: ColumnConfiguration<T>) {\n    const caseSensitive =\n      typeof column.filter === 'boolean' ? false : Boolean(column.filter?.caseSensitive);\n    const operands = getFilterOperandsFor(column);\n    const keys = Object.keys(operands) as Keys<typeof operands>[];\n\n    // XXX: Types\n    return {\n      key: column.key,\n      condition: operands[keys[0]],\n      caseSensitive,\n    } as unknown as FilterExpression<T>;\n  }\n\n  public async removeAllExpressions(key: Keys<T>) {\n    const state = this.get(key)?.all ?? [];\n\n    if (\n      !this.host.emitEvent('filtering', {\n        detail: {\n          key,\n          expressions: state,\n          type: 'remove',\n        },\n        cancelable: true,\n      })\n    ) {\n      return;\n    }\n\n    this.reset(key);\n    this.#filter([]);\n\n    await this.host.updateComplete;\n    this.#emitFilteredEvent({ key, state: this.get(key)?.all ?? [] });\n  }\n\n  public async removeExpression(expression: FilterExpression<T>) {\n    const state = this.get(expression.key);\n\n    if (!this.#emitFilteringEvent(expression, 'remove')) {\n      return;\n    }\n\n    state?.remove(expression);\n\n    if (state?.empty) {\n      this.reset(state.key);\n    }\n\n    this.#filter([]);\n\n    await this.host.updateComplete;\n    this.#emitFilteredEvent({ key: expression.key, state: state?.all ?? [] });\n  }\n\n  public async filterWithEvent(expression: FilterExpression<T>, type: 'add' | 'modify' | 'remove') {\n    if (!this.#emitFilteringEvent(expression, type)) {\n      return;\n    }\n\n    this.#filter(expression);\n\n    await this.host.updateComplete;\n    this.#emitFilteredEvent({ key: expression.key, state: this.get(expression.key)?.all ?? [] });\n  }\n\n  public filter(expression: FilterExpression<T> | FilterExpression<T>[]) {\n    this.#filter(\n      asArray(expression).map((expr) =>\n        Object.assign(this.getDefaultExpression(this.host.getColumn(expr.key)!), expr)\n      )\n    );\n  }\n}\n"]}
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../src/controllers/filter.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController } from 'lit';\nimport type { ApexFilteredEvent } from '../components/grid.js';\nimport { PIPELINE } from '../internal/constants.js';\nimport type { ColumnConfiguration, GridHost, Keys } from '../internal/types.js';\nimport { asArray, getFilterOperandsFor } from '../internal/utils.js';\nimport { FilterState } from '../operations/filter/state.js';\nimport type { FilterExpression } from '../operations/filter/types.js';\n\nexport class FilterController<T extends object> implements ReactiveController {\n  constructor(protected host: GridHost<T>) {\n    this.host.addController(this);\n  }\n\n  public state: FilterState<T> = new FilterState();\n\n  public get filterRow() {\n    // @ts-expect-error - protected access\n    return this.host.filterRow;\n  }\n\n  get #virtualizer() {\n    // @ts-expect-error - protected access\n    return this.host.scrollContainer;\n  }\n\n  #emitFilteringEvent(expression: FilterExpression<T>, type: 'add' | 'modify' | 'remove') {\n    return this.host.emitEvent('filtering', {\n      detail: {\n        key: expression.key,\n        expressions: [expression],\n        type,\n      },\n      cancelable: true,\n    });\n  }\n\n  #emitFilteredEvent(detail?: ApexFilteredEvent<T>) {\n    return this.host.emitEvent('filtered', { detail });\n  }\n\n  #filter(expression: FilterExpression<T> | FilterExpression<T>[]) {\n    for (const expr of asArray(expression)) {\n      this.state.set(expr);\n    }\n\n    // HACK: In the case where the scrollTop is a large and amount and a big chunk of data is filtered out\n    // HACK: the virtualizer can't recalculate its scroll position correctly. Thus, we reset the scrollTop state.\n    this.#virtualizer?.scrollTo({ top: 0 });\n    this.host.requestUpdate(PIPELINE);\n  }\n\n  public hostConnected() {}\n\n  public hostUpdate(): void {\n    this.filterRow?.requestUpdate();\n  }\n\n  public get(key: Keys<T>) {\n    return this.state.get(key);\n  }\n\n  public reset(key?: Keys<T>) {\n    key ? this.state.delete(key) : this.state.clear();\n  }\n\n  public setActiveColumn(column?: ColumnConfiguration<T>, triggerRect?: DOMRect) {\n    const filterRow = this.filterRow;\n    if (!filterRow) return;\n\n    if (!column?.filter) {\n      filterRow.active = false;\n      return;\n    }\n\n    // Toggle: clicking the same column's filter while the panel is open closes it.\n    if (filterRow.active && filterRow.column?.key === column.key) {\n      filterRow.active = false;\n      return;\n    }\n\n    filterRow.triggerRect = triggerRect ?? null;\n    filterRow.column = column;\n    filterRow.expression = this.getDefaultExpression(column);\n    filterRow.active = true;\n    this.host.requestUpdate();\n  }\n\n  public getDefaultExpression(column: ColumnConfiguration<T>) {\n    const caseSensitive =\n      typeof column.filter === 'boolean' ? false : Boolean(column.filter?.caseSensitive);\n    const operands = getFilterOperandsFor(column);\n    const keys = Object.keys(operands) as Keys<typeof operands>[];\n\n    // XXX: Types\n    return {\n      key: column.key,\n      condition: operands[keys[0]],\n      caseSensitive,\n    } as unknown as FilterExpression<T>;\n  }\n\n  public async removeAllExpressions(key: Keys<T>) {\n    const state = this.get(key)?.all ?? [];\n\n    if (\n      !this.host.emitEvent('filtering', {\n        detail: {\n          key,\n          expressions: state,\n          type: 'remove',\n        },\n        cancelable: true,\n      })\n    ) {\n      return;\n    }\n\n    this.reset(key);\n    this.#filter([]);\n\n    await this.host.updateComplete;\n    this.#announce(key, 'cleared');\n    this.#emitFilteredEvent({ key, state: this.get(key)?.all ?? [] });\n  }\n\n  public async removeExpression(expression: FilterExpression<T>) {\n    const state = this.get(expression.key);\n\n    if (!this.#emitFilteringEvent(expression, 'remove')) {\n      return;\n    }\n\n    state?.remove(expression);\n\n    if (state?.empty) {\n      this.reset(state.key);\n    }\n\n    this.#filter([]);\n\n    await this.host.updateComplete;\n    this.#announce(expression.key, 'cleared');\n    this.#emitFilteredEvent({ key: expression.key, state: state?.all ?? [] });\n  }\n\n  public async filterWithEvent(expression: FilterExpression<T>, type: 'add' | 'modify' | 'remove') {\n    if (!this.#emitFilteringEvent(expression, type)) {\n      return;\n    }\n\n    this.#filter(expression);\n\n    await this.host.updateComplete;\n    // Announce only on `add`: `modify` fires per keystroke while typing a\n    // filter value and would flood the live region.\n    if (type === 'add') this.#announce(expression.key, 'applied');\n    this.#emitFilteredEvent({ key: expression.key, state: this.get(expression.key)?.all ?? [] });\n  }\n\n  #announce(key: Keys<T>, kind: 'applied' | 'cleared') {\n    const column = this.host.getColumn(key);\n    const label = column?.headerText ?? String(key);\n    this.host.announce(\n      this.host.localize(kind === 'applied' ? 'announce.filtered' : 'announce.filterCleared', {\n        label,\n      })\n    );\n  }\n\n  public filter(expression: FilterExpression<T> | FilterExpression<T>[]) {\n    this.#filter(\n      asArray(expression).map((expr) =>\n        Object.assign(this.getDefaultExpression(this.host.getColumn(expr.key)!), expr)\n      )\n    );\n  }\n}\n"]}

package/controllers/history.d.ts

@@ -0,0 +1,86 @@
+import type { ReactiveController } from 'lit';
+import type { GridHost, Keys } from '../internal/types.js';
+/**
+ * A single recorded cell mutation: the record reference, its column, and the
+ * before / after values. `rowIndex` is the view-relative index at record time
+ * and is used only for the replayed `cellValueChanged` event (the live record
+ * reference is authoritative).
+ */
+export interface CellChange<T extends object> {
+    record: T;
+    key: Keys<T>;
+    rowIndex: number;
+    oldValue: unknown;
+    newValue: unknown;
+}
+/**
+ * A reversible unit of work on the history stacks.
+ *
+ * @remarks
+ * `apply` re-performs the change (redo); `revert` undoes it. Cell-data edits use
+ * {@link CellEditCommand}; the interface is deliberately open so later command
+ * kinds (e.g. view-state) can join the same stacks.
+ */
+export interface EditCommand {
+    apply(): void;
+    revert(): void;
+}
+/**
+ * One or more cell mutations that undo / redo as a single step. A single-cell
+ * edit holds one change; a row-mode commit or a bulk paste / fill holds many so
+ * one Ctrl+Z reverts the whole batch.
+ */
+export declare class CellEditCommand<T extends object> implements EditCommand {
+    #private;
+    private host;
+    readonly changes: ReadonlyArray<CellChange<T>>;
+    constructor(host: GridHost<T>, changes: ReadonlyArray<CellChange<T>>);
+    apply(): void;
+    revert(): void;
+}
+/**
+ * Reactive controller owning the undo / redo stacks for cell-data edits.
+ *
+ * @remarks
+ * Recording is driven from the {@link EditingController.applyCellEdit} choke
+ * point: every successful write calls {@link record}. Single edits push one
+ * command; {@link beginBatch} / {@link endBatch} coalesce a row-mode commit or a
+ * bulk paste / fill into one command. Disabled unless
+ * `editing.history.enabled` is set, so the community grid pays nothing.
+ */
+export declare class HistoryController<T extends object> implements ReactiveController {
+    #private;
+    protected host: GridHost<T>;
+    constructor(host: GridHost<T>);
+    hostConnected(): void;
+    /** Whether undo / redo tracking is enabled. */
+    get enabled(): boolean;
+    /** Maximum number of commands retained on the undo stack. */
+    get stackSize(): number;
+    /** Whether there is at least one command to undo. */
+    get canUndo(): boolean;
+    /** Whether there is at least one command to redo. */
+    get canRedo(): boolean;
+    /**
+     * Records a single cell mutation. Routed to the open batch when one is active,
+     * otherwise pushed immediately as a standalone command. No-op when history is
+     * disabled.
+     */
+    record(change: CellChange<T>): void;
+    /**
+     * Opens a batch so subsequent {@link record} calls coalesce into one command.
+     * Nestable calls are flattened (the outermost {@link endBatch} commits).
+     */
+    beginBatch(): void;
+    /**
+     * Closes the open batch, pushing it as a single command when it captured any
+     * changes.
+     */
+    endBatch(): void;
+    /** Reverts the most recent command. No-op when the undo stack is empty. */
+    undo(): void;
+    /** Re-applies the most recently undone command. No-op when nothing to redo. */
+    redo(): void;
+    /** Clears both stacks (e.g. after a data reset). */
+    clear(): void;
+}

package/controllers/history.js

@@ -0,0 +1,125 @@
+import { PIPELINE } from '../internal/constants.js';
+const DEFAULT_STACK_SIZE = 100;
+export class CellEditCommand {
+    constructor(host, changes) {
+        this.host = host;
+        this.changes = changes;
+    }
+    apply() {
+        for (const change of this.changes) {
+            this.#write(change, change.newValue);
+        }
+    }
+    revert() {
+        for (let i = this.changes.length - 1; i >= 0; i -= 1) {
+            this.#write(this.changes[i], this.changes[i].oldValue);
+        }
+    }
+    #write(change, value) {
+        change.record[change.key] = value;
+        const liveIndex = this.host.pageItems.indexOf(change.record);
+        this.host.emitEvent('cellValueChanged', {
+            detail: {
+                key: change.key,
+                rowIndex: liveIndex >= 0 ? liveIndex : change.rowIndex,
+                data: change.record,
+                value,
+            },
+        });
+    }
+}
+export class HistoryController {
+    #undo = [];
+    #redo = [];
+    #batch = null;
+    constructor(host) {
+        this.host = host;
+        this.host.addController(this);
+    }
+    hostConnected() { }
+    get enabled() {
+        return Boolean(this.host.editing?.history?.enabled);
+    }
+    get stackSize() {
+        const size = this.host.editing?.history?.stackSize;
+        return typeof size === 'number' && size > 0 ? size : DEFAULT_STACK_SIZE;
+    }
+    get canUndo() {
+        return this.#undo.length > 0;
+    }
+    get canRedo() {
+        return this.#redo.length > 0;
+    }
+    record(change) {
+        if (!this.enabled)
+            return;
+        if (this.#batch) {
+            this.#batch.push(change);
+            return;
+        }
+        this.#push(new CellEditCommand(this.host, [change]));
+    }
+    beginBatch() {
+        if (!this.enabled)
+            return;
+        this.#batch ??= [];
+    }
+    endBatch() {
+        const batch = this.#batch;
+        this.#batch = null;
+        if (batch && batch.length > 0) {
+            this.#push(new CellEditCommand(this.host, batch));
+        }
+    }
+    undo() {
+        const command = this.#undo.pop();
+        if (!command)
+            return;
+        command.revert();
+        this.#redo.push(command);
+        this.#afterReplay(command, 'undo');
+    }
+    redo() {
+        const command = this.#redo.pop();
+        if (!command)
+            return;
+        command.apply();
+        this.#undo.push(command);
+        this.#afterReplay(command, 'redo');
+    }
+    clear() {
+        if (this.#undo.length === 0 && this.#redo.length === 0)
+            return;
+        this.#undo = [];
+        this.#redo = [];
+        this.#batch = null;
+        this.#emitChanged();
+    }
+    #push(command) {
+        this.#undo.push(command);
+        this.#redo = [];
+        while (this.#undo.length > this.stackSize) {
+            this.#undo.shift();
+        }
+        this.#emitChanged();
+    }
+    #afterReplay(command, kind) {
+        this.host.requestUpdate(PIPELINE);
+        const count = command instanceof CellEditCommand ? command.changes.length : 1;
+        const key = kind === 'undo'
+            ? count === 1
+                ? 'announce.undoOne'
+                : 'announce.undoMany'
+            : count === 1
+                ? 'announce.redoOne'
+                : 'announce.redoMany';
+        this.host.announce(this.host.localize(key, { count }));
+        this.#emitChanged();
+    }
+    #emitChanged() {
+        this.host.emitEvent('historyChanged', {
+            detail: { canUndo: this.canUndo, canRedo: this.canRedo },
+        });
+    }
+}
+//# sourceMappingURL=history.js.map

package/controllers/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/controllers/history.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController } from 'lit';\nimport { PIPELINE } from '../internal/constants.js';\nimport type { GridHost, Keys } from '../internal/types.js';\n\n/** Default number of commands retained on the undo stack. */\nconst DEFAULT_STACK_SIZE = 100;\n\n/**\n * A single recorded cell mutation: the record reference, its column, and the\n * before / after values. `rowIndex` is the view-relative index at record time\n * and is used only for the replayed `cellValueChanged` event (the live record\n * reference is authoritative).\n */\nexport interface CellChange<T extends object> {\n  record: T;\n  key: Keys<T>;\n  rowIndex: number;\n  oldValue: unknown;\n  newValue: unknown;\n}\n\n/**\n * A reversible unit of work on the history stacks.\n *\n * @remarks\n * `apply` re-performs the change (redo); `revert` undoes it. Cell-data edits use\n * {@link CellEditCommand}; the interface is deliberately open so later command\n * kinds (e.g. view-state) can join the same stacks.\n */\nexport interface EditCommand {\n  apply(): void;\n  revert(): void;\n}\n\n/**\n * One or more cell mutations that undo / redo as a single step. A single-cell\n * edit holds one change; a row-mode commit or a bulk paste / fill holds many so\n * one Ctrl+Z reverts the whole batch.\n */\nexport class CellEditCommand<T extends object> implements EditCommand {\n  constructor(\n    private host: GridHost<T>,\n    public readonly changes: ReadonlyArray<CellChange<T>>\n  ) {}\n\n  public apply(): void {\n    for (const change of this.changes) {\n      this.#write(change, change.newValue);\n    }\n  }\n\n  public revert(): void {\n    // Revert in reverse so overlapping writes to the same cell unwind cleanly.\n    for (let i = this.changes.length - 1; i >= 0; i -= 1) {\n      this.#write(this.changes[i], this.changes[i].oldValue);\n    }\n  }\n\n  #write(change: CellChange<T>, value: unknown): void {\n    (change.record as Record<string, unknown>)[change.key as string] = value;\n    // Re-emit `cellValueChanged` (never the cancellable `cellValueChanging`) so\n    // data-bound consumers stay in sync. Validation and history recording are\n    // intentionally skipped on replay. Prefer the record's current view index\n    // when it is on the page; fall back to the recorded one.\n    const liveIndex = this.host.pageItems.indexOf(change.record);\n    this.host.emitEvent('cellValueChanged', {\n      detail: {\n        key: change.key,\n        rowIndex: liveIndex >= 0 ? liveIndex : change.rowIndex,\n        data: change.record,\n        value,\n      },\n    });\n  }\n}\n\n/**\n * Reactive controller owning the undo / redo stacks for cell-data edits.\n *\n * @remarks\n * Recording is driven from the {@link EditingController.applyCellEdit} choke\n * point: every successful write calls {@link record}. Single edits push one\n * command; {@link beginBatch} / {@link endBatch} coalesce a row-mode commit or a\n * bulk paste / fill into one command. Disabled unless\n * `editing.history.enabled` is set, so the community grid pays nothing.\n */\nexport class HistoryController<T extends object> implements ReactiveController {\n  #undo: EditCommand[] = [];\n  #redo: EditCommand[] = [];\n  #batch: CellChange<T>[] | null = null;\n\n  constructor(protected host: GridHost<T>) {\n    this.host.addController(this);\n  }\n\n  public hostConnected(): void {}\n\n  /** Whether undo / redo tracking is enabled. */\n  public get enabled(): boolean {\n    return Boolean(this.host.editing?.history?.enabled);\n  }\n\n  /** Maximum number of commands retained on the undo stack. */\n  public get stackSize(): number {\n    const size = this.host.editing?.history?.stackSize;\n    return typeof size === 'number' && size > 0 ? size : DEFAULT_STACK_SIZE;\n  }\n\n  /** Whether there is at least one command to undo. */\n  public get canUndo(): boolean {\n    return this.#undo.length > 0;\n  }\n\n  /** Whether there is at least one command to redo. */\n  public get canRedo(): boolean {\n    return this.#redo.length > 0;\n  }\n\n  /**\n   * Records a single cell mutation. Routed to the open batch when one is active,\n   * otherwise pushed immediately as a standalone command. No-op when history is\n   * disabled.\n   */\n  public record(change: CellChange<T>): void {\n    if (!this.enabled) return;\n    if (this.#batch) {\n      this.#batch.push(change);\n      return;\n    }\n    this.#push(new CellEditCommand(this.host, [change]));\n  }\n\n  /**\n   * Opens a batch so subsequent {@link record} calls coalesce into one command.\n   * Nestable calls are flattened (the outermost {@link endBatch} commits).\n   */\n  public beginBatch(): void {\n    if (!this.enabled) return;\n    this.#batch ??= [];\n  }\n\n  /**\n   * Closes the open batch, pushing it as a single command when it captured any\n   * changes.\n   */\n  public endBatch(): void {\n    const batch = this.#batch;\n    this.#batch = null;\n    if (batch && batch.length > 0) {\n      this.#push(new CellEditCommand(this.host, batch));\n    }\n  }\n\n  /** Reverts the most recent command. No-op when the undo stack is empty. */\n  public undo(): void {\n    const command = this.#undo.pop();\n    if (!command) return;\n    command.revert();\n    this.#redo.push(command);\n    this.#afterReplay(command, 'undo');\n  }\n\n  /** Re-applies the most recently undone command. No-op when nothing to redo. */\n  public redo(): void {\n    const command = this.#redo.pop();\n    if (!command) return;\n    command.apply();\n    this.#undo.push(command);\n    this.#afterReplay(command, 'redo');\n  }\n\n  /** Clears both stacks (e.g. after a data reset). */\n  public clear(): void {\n    if (this.#undo.length === 0 && this.#redo.length === 0) return;\n    this.#undo = [];\n    this.#redo = [];\n    this.#batch = null;\n    this.#emitChanged();\n  }\n\n  #push(command: EditCommand): void {\n    this.#undo.push(command);\n    // A fresh edit invalidates the redo branch.\n    this.#redo = [];\n    // Evict the oldest commands once the stack exceeds its cap.\n    while (this.#undo.length > this.stackSize) {\n      this.#undo.shift();\n    }\n    this.#emitChanged();\n  }\n\n  #afterReplay(command: EditCommand, kind: 'undo' | 'redo'): void {\n    this.host.requestUpdate(PIPELINE);\n    const count = command instanceof CellEditCommand ? command.changes.length : 1;\n    const key =\n      kind === 'undo'\n        ? count === 1\n          ? 'announce.undoOne'\n          : 'announce.undoMany'\n        : count === 1\n          ? 'announce.redoOne'\n          : 'announce.redoMany';\n    this.host.announce(this.host.localize(key, { count }));\n    this.#emitChanged();\n  }\n\n  #emitChanged(): void {\n    this.host.emitEvent('historyChanged', {\n      detail: { canUndo: this.canUndo, canRedo: this.canRedo },\n    });\n  }\n}\n"]}

package/controllers/navigation.d.ts

@@ -1,8 +1,8 @@
 import type { ReactiveController } from 'lit';
-import type { ActiveNode, GridHost, Keys } from '../internal/types.js';
+import type { ActiveNode, ColumnConfiguration, GridHost, Keys } from '../internal/types.js';
 export declare class NavigationController<T extends object> implements ReactiveController {
     protected host: GridHost<T>;
-    protected handlers: Map<string, (() => void) | (() => void) | (() => void) | (() => void) | (() => void) | (() => void) | (() => void)>;
+    protected handlers: Map<string, (() => void) | (() => void) | (() => void) | (() => void) | (() => void) | (() => void) | (() => void) | (() => void) | (() => void)>;
     protected get virtualizer(): import("../components/virtualizer.js").default;
     protected state: Map<import("../internal/types.js").NavigationState, ActiveNode<any>>;
     protected _active: Readonly<ActiveNode<any>>;
@@ -22,11 +22,33 @@ export declare class NavigationController<T extends object> implements ReactiveC
     protected getPreviousColumn(key: Keys<T>): Keys<T>;
     protected getNextColumn(key: Keys<T>): Keys<T>;
     protected scrollToCell(node: ActiveNode<T>): void;
+    protected findActiveCell(): import("../components/cell.js").default<T> | undefined;
+    /**
+     * Moves real DOM focus to the active cell (the grid body's roving tab stop),
+     * so screen readers track keyboard navigation. Waits for the host render to
+     * commit the cell's `active` state, then retries once on the next frame to
+     * cover virtualizer re-materialization after a long jump. No-op while no
+     * cell is active (the scroll container keeps focus as the entry point).
+     */
+    focusActiveCell(): void;
     get active(): ActiveNode<T>;
     set active(node: ActiveNode<T>);
     constructor(host: GridHost<T>);
+    /** Home moves to the first cell in the row (ARIA grid pattern). */
     protected home(): void;
+    /** End moves to the last cell in the row (ARIA grid pattern). */
     protected end(): void;
+    /** Ctrl/Cmd+Home moves to the first cell of the grid. */
+    protected ctrlHome(): void;
+    /** Ctrl/Cmd+End moves to the last cell of the grid. */
+    protected ctrlEnd(): void;
+    /**
+     * Rows per Page Up/Down step, derived from the host viewport and the height
+     * of a rendered row (fallback: 10 rows when nothing is measurable yet).
+     */
+    protected pageStep(): number;
+    protected pageUp(): void;
+    protected pageDown(): void;
     protected arrowDown(): void;
     protected arrowUp(): void;
     protected arrowLeft(): void;
@@ -34,5 +56,30 @@ export declare class NavigationController<T extends object> implements ReactiveC
     protected toggleSelection(): void;
     hostConnected(): void;
     hostDisconnected(): void;
+    protected get editing(): {
+        enabled: boolean;
+        isEditable(column: ColumnConfiguration<T>): boolean;
+        editCell(rowIndex: number, columnKey: Keys<T>): Promise<boolean>;
+    } | undefined;
+    /**
+     * Enter / F2 on the active cell opens its editor (the keyboard path into
+     * edit mode). Returns `true` when the event was consumed.
+     */
+    protected handleEditKey(event: KeyboardEvent): boolean;
+    protected get rowReorder(): {
+        enabled: boolean;
+        isGrabbing: boolean;
+        grab(rowIndex: number): boolean;
+        moveGrabbed(direction: -1 | 1): number;
+        drop(): void;
+        cancelGrab(): void;
+    } | undefined;
+    /**
+     * Keyboard row reorder: Space grabs the active row, arrows move it, Space /
+     * Enter drops, Escape cancels. Returns `true` when the event was consumed.
+     * Only active when `rowReordering.enabled` (so it never shadows Space-to-select
+     * on grids without reordering).
+     */
+    protected handleReorderKey(event: KeyboardEvent): boolean;
     navigate(event: KeyboardEvent): void;
 }