apex-grid 3.2.0 → 3.3.0

package/controllers/dom.js.map

@@ -1 +1 @@
-{"version":3,"file":"dom.js","sourceRoot":"","sources":["../../src/controllers/dom.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RenderItemFunction } from '@lit-labs/virtualizer/virtualize.js';\nimport { html, type ReactiveController } from 'lit';\nimport { type StyleInfo, styleMap } from 'lit/directives/style-map.js';\nimport type { ColumnConfiguration, GridHost, Keys } from '../internal/types.js';\nimport { applyColumnWidths, getDisplayColumns } from '../internal/utils.js';\nimport type { StateController } from './state.js';\n\nexport class GridDOMController<T extends object> implements ReactiveController {\n  constructor(\n    protected host: GridHost<T>,\n    protected state: StateController<T>\n  ) {\n    this.host.addController(this);\n  }\n\n  #initialSize = () => {\n    setTimeout(() => {\n      this.setScrollOffset();\n      this.recomputePinOffsets();\n      this.recomputeStickyRowOffsets();\n    });\n  };\n\n  #resizeObserver: ResizeObserver | null = null;\n  #observedHeaders = new Set<Element>();\n  #stickyRowObserver: ResizeObserver | null = null;\n  #observedStickyRows = new Set<Element>();\n\n  public get container() {\n    // @ts-expect-error: protected member access\n    return this.host.scrollContainer;\n  }\n\n  /**\n   * Visual render order: `'start'`-pinned columns first, then unpinned, then\n   * `'end'`-pinned. The user-supplied `columns` array is never mutated.\n   */\n  public get displayColumns(): Array<ColumnConfiguration<T>> {\n    return getDisplayColumns(this.host.columns);\n  }\n\n  public columnSizes: StyleInfo = {};\n\n  /**\n   * The resolved inline-start (for `'start'` pin) or inline-end (for `'end'` pin)\n   * pixel offset per pinned column key. Populated after layout by\n   * {@link recomputePinOffsets}.\n   */\n  public pinOffsets = new Map<Keys<T>, number>();\n\n  public rowRenderer: RenderItemFunction<T> = (data: T, index: number) => {\n    const editingCell = this.state.editing.activeCell;\n    const editingKey = editingCell?.rowIndex === index ? editingCell.columnKey : null;\n    // aria-rowindex offset: header row is always row 1; filter row (when\n    // any column has a filter configured) sits at row 2; body rows start\n    // immediately after.\n    const hasFilter = this.host.columns.some((column) => column.filter);\n    const ariaRowOffset = hasFilter ? 2 : 1;\n    return html`\n      <apex-grid-row\n        part=\"row\"\n        style=${styleMap({ ...this.columnSizes, ...this.getActiveRowStyles(index) })}\n        .index=${index}\n        .activeNode=${this.state.active}\n        .data=${data}\n        .columns=${this.displayColumns}\n        .pinOffsets=${this.pinOffsets}\n        .editingKey=${editingKey}\n        .ariaRowOffset=${ariaRowOffset}\n        .decorationVersion=${this.state.decorationVersion}\n      >\n      </apex-grid-row>\n    `;\n  };\n\n  public async hostConnected() {\n    this.setGridColumnSizes();\n    // Wait for the initial paint of the virtualizer and recalculate the scrollbar offset\n    // for the next one\n    await this.host.updateComplete;\n    this.#initialSize();\n    if (typeof ResizeObserver !== 'undefined' && !this.#hostWidthObserver) {\n      this.#hostWidthObserver = new ResizeObserver(() => {\n        requestAnimationFrame(() => this.recomputeHostWidth());\n      });\n      this.#hostWidthObserver.observe(this.host as HTMLElement);\n    }\n    this.recomputeHostWidth();\n  }\n\n  public hostUpdate(): void {\n    this.setScrollOffset();\n    this.setGridColumnSizes();\n  }\n\n  public hostUpdated(): void {\n    this.recomputePinOffsets();\n    this.observeHeaderCells();\n    this.recomputeStickyRowOffsets();\n    this.observeStickyRows();\n  }\n\n  public hostDisconnected(): void {\n    this.#resizeObserver?.disconnect();\n    this.#resizeObserver = null;\n    this.#observedHeaders.clear();\n    this.#stickyRowObserver?.disconnect();\n    this.#stickyRowObserver = null;\n    this.#observedStickyRows.clear();\n    this.#hostWidthObserver?.disconnect();\n    this.#hostWidthObserver = null;\n  }\n\n  /**\n   * Writes the grid host's `clientWidth` into `--apex-host-width`. Used by the\n   * toolbar and paginator to clamp their width to the visible viewport so\n   * horizontal scrolling doesn't drag them off-screen.\n   */\n  public recomputeHostWidth(): void {\n    const host = this.host as HTMLElement;\n    const width = host.clientWidth;\n    if (width === this.#lastHostWidth) return;\n    host.style.setProperty('--apex-host-width', `${width}px`);\n    this.#lastHostWidth = width;\n  }\n\n  public setScrollOffset() {\n    // The grid host now owns vertical scrolling, so the historic per-row\n    // padding-inline-end compensation is no longer needed. Keep the CSS var\n    // set to `0` for forward compatibility with consumer themes that read it.\n    this.host.style.setProperty('--scrollbar-offset', '0px');\n  }\n\n  protected setGridColumnSizes() {\n    this.columnSizes = applyColumnWidths(this.displayColumns, {\n      showSelectionColumn: this.state.selection.showCheckboxColumn,\n      showExpansionColumn: this.state.expansion.showToggleColumn,\n    });\n  }\n\n  public getActiveRowStyles(index: number): StyleInfo {\n    const { row } = this.state.active;\n    return row === index ? { 'z-index': '3' } : {};\n  }\n\n  /**\n   * Measures the rendered widths of pinned header cells and writes cumulative\n   * inline-start / inline-end pixel offsets into {@link pinOffsets}. Called after\n   * each grid update and whenever a header cell is resized.\n   */\n  public recomputePinOffsets(): void {\n    // @ts-expect-error - protected member access\n    const headerRow = this.host.headerRow as\n      | {\n          headers?: Array<{\n            column: ColumnConfiguration<T>;\n            getBoundingClientRect: () => DOMRect;\n          }>;\n        }\n      | undefined;\n    if (!headerRow?.headers) return;\n\n    const next = new Map<Keys<T>, number>();\n    const headersByKey = new Map<Keys<T>, DOMRect>();\n    for (const header of headerRow.headers) {\n      headersByKey.set(header.column.key as Keys<T>, header.getBoundingClientRect());\n    }\n\n    let leftAccum = 0;\n    for (const column of this.displayColumns) {\n      if (column.hidden) continue;\n      if (column.pinned !== 'start') break;\n      next.set(column.key as Keys<T>, leftAccum);\n      const rect = headersByKey.get(column.key as Keys<T>);\n      leftAccum += rect?.width ?? 0;\n    }\n\n    let rightAccum = 0;\n    for (let i = this.displayColumns.length - 1; i >= 0; i--) {\n      const column = this.displayColumns[i];\n      if (column.hidden) continue;\n      if (column.pinned !== 'end') break;\n      next.set(column.key as Keys<T>, rightAccum);\n      const rect = headersByKey.get(column.key as Keys<T>);\n      rightAccum += rect?.width ?? 0;\n    }\n\n    if (!offsetsEqual(this.pinOffsets, next)) {\n      this.pinOffsets = next;\n      this.host.requestUpdate();\n    }\n  }\n\n  protected observeHeaderCells(): void {\n    // @ts-expect-error - protected member access\n    const headerRow = this.host.headerRow as { headers?: Array<Element> } | undefined;\n    if (!headerRow?.headers) return;\n\n    if (!this.#resizeObserver) {\n      this.#resizeObserver = new ResizeObserver(() => {\n        // Defer to a new frame so any layout writes can't synchronously feed back\n        // into this observer (which makes the browser raise the benign\n        // \"ResizeObserver loop completed\" warning).\n        requestAnimationFrame(() => this.recomputePinOffsets());\n      });\n    }\n\n    const next = new Set<Element>(headerRow.headers);\n    for (const element of this.#observedHeaders) {\n      if (!next.has(element)) this.#resizeObserver.unobserve(element);\n    }\n    for (const element of next) {\n      if (!this.#observedHeaders.has(element)) this.#resizeObserver.observe(element);\n    }\n    this.#observedHeaders = next;\n  }\n\n  #lastHeaderTop = -1;\n  #lastFilterTop = -1;\n  #lastHostWidth = -1;\n  #hostWidthObserver: ResizeObserver | null = null;\n\n  /**\n   * Writes the cumulative height of the sticky top rows into CSS custom\n   * properties used by the header/filter rows for their `inset-block-start`\n   * offsets. The toolbar is always at `top: 0`; the header sits below it\n   * (`--apex-row-top-header`) and the filter sits below the header\n   * (`--apex-row-top-filter`). Writes are skipped when the values haven't\n   * changed so the ResizeObserver feedback loop terminates.\n   */\n  public recomputeStickyRowOffsets(): void {\n    const root = (this.host as HTMLElement).shadowRoot;\n    if (!root) return;\n    const toolbar = root.querySelector('apex-grid-toolbar') as HTMLElement | null;\n    const header = root.querySelector('apex-grid-header-row') as HTMLElement | null;\n\n    const toolbarH = toolbar?.offsetHeight ?? 0;\n    const headerH = header?.offsetHeight ?? 0;\n    const headerTop = toolbarH;\n    const filterTop = toolbarH + headerH;\n\n    if (headerTop !== this.#lastHeaderTop) {\n      this.host.style.setProperty('--apex-row-top-header', `${headerTop}px`);\n      this.#lastHeaderTop = headerTop;\n    }\n    if (filterTop !== this.#lastFilterTop) {\n      this.host.style.setProperty('--apex-row-top-filter', `${filterTop}px`);\n      this.#lastFilterTop = filterTop;\n    }\n  }\n\n  protected observeStickyRows(): void {\n    const root = (this.host as HTMLElement).shadowRoot;\n    if (!root) return;\n    const toolbar = root.querySelector('apex-grid-toolbar') as HTMLElement | null;\n    const header = root.querySelector('apex-grid-header-row') as HTMLElement | null;\n\n    if (!this.#stickyRowObserver) {\n      this.#stickyRowObserver = new ResizeObserver(() => {\n        requestAnimationFrame(() => this.recomputeStickyRowOffsets());\n      });\n    }\n\n    const next = new Set<Element>([toolbar, header].filter((el): el is HTMLElement => !!el));\n    for (const element of this.#observedStickyRows) {\n      if (!next.has(element)) this.#stickyRowObserver.unobserve(element);\n    }\n    for (const element of next) {\n      if (!this.#observedStickyRows.has(element)) this.#stickyRowObserver.observe(element);\n    }\n    this.#observedStickyRows = next;\n  }\n}\n\nfunction offsetsEqual<K>(a: Map<K, number>, b: Map<K, number>): boolean {\n  if (a.size !== b.size) return false;\n  for (const [key, value] of a) {\n    if (b.get(key) !== value) return false;\n  }\n  return true;\n}\n"]}
+{"version":3,"file":"dom.js","sourceRoot":"","sources":["../../src/controllers/dom.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RenderItemFunction } from '@lit-labs/virtualizer/virtualize.js';\nimport { html, type ReactiveController } from 'lit';\nimport { type StyleInfo, styleMap } from 'lit/directives/style-map.js';\nimport { SENTINEL_NODE } from '../internal/constants.js';\nimport type { ActiveNode, ColumnConfiguration, GridHost, Keys } from '../internal/types.js';\nimport { applyColumnWidths, getDisplayColumns } from '../internal/utils.js';\nimport type { StateController } from './state.js';\n\nexport class GridDOMController<T extends object> implements ReactiveController {\n  constructor(\n    protected host: GridHost<T>,\n    protected state: StateController<T>\n  ) {\n    this.host.addController(this);\n  }\n\n  #initialSize = () => {\n    setTimeout(() => {\n      this.setScrollOffset();\n      this.recomputePinOffsets();\n      this.recomputeStickyRowOffsets();\n    });\n  };\n\n  #resizeObserver: ResizeObserver | null = null;\n  #observedHeaders = new Set<Element>();\n  #stickyRowObserver: ResizeObserver | null = null;\n  #observedStickyRows = new Set<Element>();\n\n  public get container() {\n    // @ts-expect-error: protected member access\n    return this.host.scrollContainer;\n  }\n\n  /**\n   * Visual render order: `'start'`-pinned columns first, then unpinned, then\n   * `'end'`-pinned. The user-supplied `columns` array is never mutated.\n   */\n  public get displayColumns(): Array<ColumnConfiguration<T>> {\n    return getDisplayColumns(this.host.columns);\n  }\n\n  public columnSizes: StyleInfo = {};\n\n  /**\n   * The resolved inline-start (for `'start'` pin) or inline-end (for `'end'` pin)\n   * pixel offset per pinned column key. Populated after layout by\n   * {@link recomputePinOffsets}.\n   */\n  public pinOffsets = new Map<Keys<T>, number>();\n\n  /**\n   * Number of chrome rows above the body for `aria-rowindex`: an optional group\n   * header row and the column header (always present). The filter panel is a\n   * floating overlay rather than a table row, so it is not counted here.\n   */\n  protected get headerRowCount(): number {\n    return this.host.columnGroupDepth + 1;\n  }\n\n  public rowRenderer: RenderItemFunction<T> = (data: T, index: number) => {\n    const editingCell = this.state.editing.activeCell;\n    const editingKey = editingCell?.rowIndex === index ? editingCell.columnKey : null;\n    // Body rows follow the chrome rows and any pinned-top rows in the\n    // aria-rowindex sequence.\n    const ariaRowOffset = this.headerRowCount + this.state.rowPin.pinnedRows.top.length;\n    return html`\n      <apex-grid-row\n        part=\"row\"\n        style=${styleMap({ ...this.columnSizes, ...this.getActiveRowStyles(index) })}\n        .index=${index}\n        .activeNode=${this.state.active}\n        .data=${data}\n        .columns=${this.displayColumns}\n        .pinOffsets=${this.pinOffsets}\n        .editingKey=${editingKey}\n        .ariaRowOffset=${ariaRowOffset}\n        .decorationVersion=${this.state.decorationVersion}\n        .validationVersion=${this.state.editing.validationVersion}\n        .dragging=${this.state.rowReorder.dragging === data}\n        .grabbed=${this.state.rowReorder.grabbed === data}\n        .coordinateHints=${Boolean(this.host.coordinateHints)}\n      >\n      </apex-grid-row>\n    `;\n  };\n\n  /**\n   * Renders a single pinned row for a sticky band. Reuses {@link ApexGridRow}\n   * so selection / expansion / decoration all work by data reference, but pins a\n   * sentinel {@link ActiveNode} (pinned rows are presentation + selection\n   * surfaces in v1, never the active/edited cell) and renders no editor.\n   *\n   * @param localIndex - position within the band (drives the active sentinel id).\n   * @param ariaRowOffset - so `aria-rowindex` continues the unified sequence.\n   */\n  public pinnedRowRenderer(data: T, localIndex: number, ariaRowOffset: number) {\n    return html`\n      <apex-grid-row\n        part=\"row pinned-row\"\n        style=${styleMap(this.columnSizes)}\n        .index=${localIndex}\n        .activeNode=${SENTINEL_NODE as ActiveNode<T>}\n        .data=${data}\n        .columns=${this.displayColumns}\n        .pinOffsets=${this.pinOffsets}\n        .editingKey=${null}\n        .ariaRowOffset=${ariaRowOffset}\n        .decorationVersion=${this.state.decorationVersion}\n        .validationVersion=${this.state.editing.validationVersion}\n        .coordinateHints=${Boolean(this.host.coordinateHints)}\n      >\n      </apex-grid-row>\n    `;\n  }\n\n  public async hostConnected() {\n    this.setGridColumnSizes();\n    // Wait for the initial paint of the virtualizer and recalculate the scrollbar offset\n    // for the next one\n    await this.host.updateComplete;\n    this.#initialSize();\n    if (typeof ResizeObserver !== 'undefined' && !this.#hostWidthObserver) {\n      this.#hostWidthObserver = new ResizeObserver(() => {\n        requestAnimationFrame(() => this.recomputeHostWidth());\n      });\n      this.#hostWidthObserver.observe(this.host as HTMLElement);\n    }\n    this.recomputeHostWidth();\n  }\n\n  public hostUpdate(): void {\n    this.setScrollOffset();\n    this.setGridColumnSizes();\n  }\n\n  public hostUpdated(): void {\n    this.recomputePinOffsets();\n    this.observeHeaderCells();\n    this.recomputeStickyRowOffsets();\n    this.observeStickyRows();\n  }\n\n  public hostDisconnected(): void {\n    this.#resizeObserver?.disconnect();\n    this.#resizeObserver = null;\n    this.#observedHeaders.clear();\n    this.#stickyRowObserver?.disconnect();\n    this.#stickyRowObserver = null;\n    this.#observedStickyRows.clear();\n    this.#hostWidthObserver?.disconnect();\n    this.#hostWidthObserver = null;\n  }\n\n  /**\n   * Writes the grid host's `clientWidth` into `--apex-host-width`. Used by the\n   * toolbar and paginator to clamp their width to the visible viewport so\n   * horizontal scrolling doesn't drag them off-screen.\n   */\n  public recomputeHostWidth(): void {\n    const host = this.host as HTMLElement;\n    const width = host.clientWidth;\n    if (width === this.#lastHostWidth) return;\n    host.style.setProperty('--apex-host-width', `${width}px`);\n    this.#lastHostWidth = width;\n  }\n\n  public setScrollOffset() {\n    // The grid host now owns vertical scrolling, so the historic per-row\n    // padding-inline-end compensation is no longer needed. Keep the CSS var\n    // set to `0` for forward compatibility with consumer themes that read it.\n    this.host.style.setProperty('--scrollbar-offset', '0px');\n  }\n\n  protected setGridColumnSizes() {\n    this.columnSizes = applyColumnWidths(this.displayColumns, {\n      showSelectionColumn: this.state.selection.showCheckboxColumn,\n      showExpansionColumn: this.state.expansion.showToggleColumn,\n      showReorderHandle: this.state.rowReorder.showHandleColumn,\n      showRowNumbers: Boolean(this.host.coordinateHints),\n    });\n  }\n\n  public getActiveRowStyles(index: number): StyleInfo {\n    const { row } = this.state.active;\n    return row === index ? { 'z-index': '3' } : {};\n  }\n\n  /**\n   * Measures the rendered widths of pinned header cells and writes cumulative\n   * inline-start / inline-end pixel offsets into {@link pinOffsets}. Called after\n   * each grid update and whenever a header cell is resized.\n   */\n  public recomputePinOffsets(): void {\n    // @ts-expect-error - protected member access\n    const headerRow = this.host.headerRow as\n      | {\n          headers?: Array<{\n            column: ColumnConfiguration<T>;\n            getBoundingClientRect: () => DOMRect;\n          }>;\n        }\n      | undefined;\n    if (!headerRow?.headers) return;\n\n    const next = new Map<Keys<T>, number>();\n    const headersByKey = new Map<Keys<T>, DOMRect>();\n    for (const header of headerRow.headers) {\n      headersByKey.set(header.column.key as Keys<T>, header.getBoundingClientRect());\n    }\n\n    let leftAccum = 0;\n    for (const column of this.displayColumns) {\n      if (column.hidden) continue;\n      if (column.pinned !== 'start') break;\n      next.set(column.key as Keys<T>, leftAccum);\n      const rect = headersByKey.get(column.key as Keys<T>);\n      leftAccum += rect?.width ?? 0;\n    }\n\n    let rightAccum = 0;\n    for (let i = this.displayColumns.length - 1; i >= 0; i--) {\n      const column = this.displayColumns[i];\n      if (column.hidden) continue;\n      if (column.pinned !== 'end') break;\n      next.set(column.key as Keys<T>, rightAccum);\n      const rect = headersByKey.get(column.key as Keys<T>);\n      rightAccum += rect?.width ?? 0;\n    }\n\n    if (!offsetsEqual(this.pinOffsets, next)) {\n      this.pinOffsets = next;\n      this.host.requestUpdate();\n    }\n  }\n\n  protected observeHeaderCells(): void {\n    // @ts-expect-error - protected member access\n    const headerRow = this.host.headerRow as { headers?: Array<Element> } | undefined;\n    if (!headerRow?.headers) return;\n\n    if (!this.#resizeObserver) {\n      this.#resizeObserver = new ResizeObserver(() => {\n        // Defer to a new frame so any layout writes can't synchronously feed back\n        // into this observer (which makes the browser raise the benign\n        // \"ResizeObserver loop completed\" warning).\n        requestAnimationFrame(() => this.recomputePinOffsets());\n      });\n    }\n\n    const next = new Set<Element>(headerRow.headers);\n    for (const element of this.#observedHeaders) {\n      if (!next.has(element)) this.#resizeObserver.unobserve(element);\n    }\n    for (const element of next) {\n      if (!this.#observedHeaders.has(element)) this.#resizeObserver.observe(element);\n    }\n    this.#observedHeaders = next;\n  }\n\n  #lastGroupTop = -1;\n  #lastHeaderTop = -1;\n  #lastFilterTop = -1;\n  #lastPinnedTop = -1;\n  #lastPinnedBottom = -1;\n  #lastHostWidth = -1;\n  #hostWidthObserver: ResizeObserver | null = null;\n\n  /**\n   * Writes the cumulative heights of the sticky chrome rows into CSS custom\n   * properties used for their `inset-block-start` / `inset-block-end` offsets.\n   * The toolbar is at `top: 0`; the header sits below it\n   * (`--apex-row-top-header`), the filter below the header\n   * (`--apex-row-top-filter`), and the pinned-top band below the filter\n   * (`--apex-row-top-pinned`). The pinned-bottom band sticks above the\n   * paginator (`--apex-row-bottom-pinned`). Writes are skipped when values are\n   * unchanged so the ResizeObserver feedback loop terminates.\n   */\n  public recomputeStickyRowOffsets(): void {\n    const root = (this.host as HTMLElement).shadowRoot;\n    if (!root) return;\n    const toolbar = root.querySelector('apex-grid-toolbar') as HTMLElement | null;\n    const groupHeader = root.querySelector('apex-grid-group-header-row') as HTMLElement | null;\n    const header = root.querySelector('apex-grid-header-row') as HTMLElement | null;\n    const filter = root.querySelector('apex-filter-row') as HTMLElement | null;\n    const paginator = root.querySelector('apex-grid-paginator') as HTMLElement | null;\n\n    const toolbarH = toolbar?.offsetHeight ?? 0;\n    const groupH = groupHeader?.offsetHeight ?? 0;\n    const headerH = header?.offsetHeight ?? 0;\n    const filterH = filter?.offsetHeight ?? 0;\n    const paginatorH = paginator?.offsetHeight ?? 0;\n    // The group header (when present) sits below the toolbar; the column header\n    // sits below the group header; filter below header; pinned-top below filter.\n    const groupTop = toolbarH;\n    const headerTop = toolbarH + groupH;\n    const filterTop = toolbarH + groupH + headerH;\n    const pinnedTop = toolbarH + groupH + headerH + filterH;\n\n    if (groupTop !== this.#lastGroupTop) {\n      this.host.style.setProperty('--apex-row-top-group', `${groupTop}px`);\n      this.#lastGroupTop = groupTop;\n    }\n    if (headerTop !== this.#lastHeaderTop) {\n      this.host.style.setProperty('--apex-row-top-header', `${headerTop}px`);\n      this.#lastHeaderTop = headerTop;\n    }\n    if (filterTop !== this.#lastFilterTop) {\n      this.host.style.setProperty('--apex-row-top-filter', `${filterTop}px`);\n      this.#lastFilterTop = filterTop;\n    }\n    if (pinnedTop !== this.#lastPinnedTop) {\n      this.host.style.setProperty('--apex-row-top-pinned', `${pinnedTop}px`);\n      this.#lastPinnedTop = pinnedTop;\n    }\n    if (paginatorH !== this.#lastPinnedBottom) {\n      this.host.style.setProperty('--apex-row-bottom-pinned', `${paginatorH}px`);\n      this.#lastPinnedBottom = paginatorH;\n    }\n  }\n\n  protected observeStickyRows(): void {\n    const root = (this.host as HTMLElement).shadowRoot;\n    if (!root) return;\n    const toolbar = root.querySelector('apex-grid-toolbar') as HTMLElement | null;\n    const groupHeader = root.querySelector('apex-grid-group-header-row') as HTMLElement | null;\n    const header = root.querySelector('apex-grid-header-row') as HTMLElement | null;\n    const filter = root.querySelector('apex-filter-row') as HTMLElement | null;\n    const paginator = root.querySelector('apex-grid-paginator') as HTMLElement | null;\n\n    if (!this.#stickyRowObserver) {\n      this.#stickyRowObserver = new ResizeObserver(() => {\n        requestAnimationFrame(() => this.recomputeStickyRowOffsets());\n      });\n    }\n\n    const next = new Set<Element>(\n      [toolbar, groupHeader, header, filter, paginator].filter((el): el is HTMLElement => !!el)\n    );\n    for (const element of this.#observedStickyRows) {\n      if (!next.has(element)) this.#stickyRowObserver.unobserve(element);\n    }\n    for (const element of next) {\n      if (!this.#observedStickyRows.has(element)) this.#stickyRowObserver.observe(element);\n    }\n    this.#observedStickyRows = next;\n  }\n}\n\nfunction offsetsEqual<K>(a: Map<K, number>, b: Map<K, number>): boolean {\n  if (a.size !== b.size) return false;\n  for (const [key, value] of a) {\n    if (b.get(key) !== value) return false;\n  }\n  return true;\n}\n"]}

package/controllers/editing.d.ts

@@ -1,5 +1,6 @@
 import type { ReactiveController } from 'lit';
 import type { ColumnConfiguration, EditMode, EditTrigger, GridHost, Keys } from '../internal/types.js';
+import type { HistoryController } from './history.js';
 /**
  * The default editing configuration used when the grid has none set.
  */
@@ -17,6 +18,28 @@ interface ActiveCell<T> {
      */
     data: T;
 }
+/**
+ * Outcome of a single committed cell edit routed through
+ * {@link EditingController.applyCellEdit}.
+ *
+ * - `'unchanged'` - the candidate equalled the current value; nothing happened.
+ * - `'invalid'` - a column validator rejected the candidate; the value was not
+ *   written and `cellValidationFailed` fired.
+ * - `'cancelled'` - a `cellValueChanging` listener called `preventDefault()`.
+ * - `'applied'` - the value was written and `cellValueChanged` fired.
+ */
+export type CellEditResult = 'unchanged' | 'invalid' | 'cancelled' | 'applied';
+/**
+ * Options for {@link EditingController.applyCellEdit}.
+ */
+export interface ApplyCellEditOptions {
+    /**
+     * Run the column's declarative validators before writing. Defaults to `true`.
+     * Set to `false` for writes that must not be re-validated (e.g. reverting a
+     * previously valid value during undo/redo).
+     */
+    validate?: boolean;
+}
 /**
  * Reactive controller backing inline cell + row editing.
  *
@@ -28,7 +51,9 @@ interface ActiveCell<T> {
  * propagate to consumers that own the source array.
  */
 export declare class EditingController<T extends object> implements ReactiveController {
+    #private;
     protected host: GridHost<T>;
+    protected history?: HistoryController<T> | undefined;
     /** The cell currently in edit mode, or `null`. */
     activeCell: ActiveCell<T> | null;
     /** The row currently in edit mode (row mode only), or `null`. */
@@ -42,7 +67,14 @@ export declare class EditingController<T extends object> implements ReactiveCont
      * {@link commitRow}.
      */
     pending: Map<Keys<T>, unknown>;
-    constructor(host: GridHost<T>);
+    /**
+     * Monotonic token bumped whenever the validation-error set changes. Forwarded
+     * down to each cell as a reactive property so a validation-only change
+     * re-renders the affected cells (toggling `aria-invalid` and the error node)
+     * without re-running the data pipeline. Stays `0` until the first failure.
+     */
+    get validationVersion(): number;
+    constructor(host: GridHost<T>, history?: HistoryController<T> | undefined);
     hostConnected(): void;
     /**
      * Whether editing is enabled at the grid level.
@@ -82,6 +114,41 @@ export declare class EditingController<T extends object> implements ReactiveCont
      * success. No-op in cell mode.
      */
     editRow(rowIndex: number): Promise<boolean>;
+    /**
+     * The single choke point for committing a cell value to the backing record.
+     * Short-circuits no-op writes, runs the cancellable `cellValueChanging` gate,
+     * writes the value through to {@link ApexGrid.data}, and emits
+     * `cellValueChanged`. Returns the {@link CellEditResult} so callers can manage
+     * their own UI state (active cell) and batch the render.
+     *
+     * @remarks
+     * Does **not** request a render — callers refresh (once per edit, or once per
+     * batch) so row-mode and bulk edits coalesce into a single pipeline pass.
+     * Every committed edit (single-cell, row-mode, and enterprise paste/fill)
+     * funnels through here so cross-cutting concerns (validation, undo/redo) have
+     * one place to hook the old/new values and the write.
+     */
+    applyCellEdit(rowIndex: number, columnKey: Keys<T>, data: T, value: unknown, options?: ApplyCellEditOptions): CellEditResult;
+    /**
+     * Runs the column's declarative validators against a candidate value and
+     * returns the collected error messages (empty when the value passes or the
+     * column has no validators).
+     */
+    validateCell(rowIndex: number, columnKey: Keys<T>, data: T, value: unknown): string[];
+    /**
+     * The current validation errors for `(data, columnKey)`, or `null` when the
+     * cell is valid. Read by {@link ApexGridCell} to drive `aria-invalid` and the
+     * inline error node.
+     */
+    getCellErrors(data: T, columnKey: Keys<T>): readonly string[] | null;
+    /**
+     * Clears any validation error recorded for `(data, columnKey)`.
+     */
+    clearCellErrors(data: T, columnKey: Keys<T>): void;
+    /**
+     * Clears every validation error recorded for a record (all columns).
+     */
+    clearRecordErrors(data: T): void;
     /**
      * Commits a candidate value for the currently editing cell. In cell mode the
      * value is written through to {@link ApexGrid.data}; in row mode it is staged

package/controllers/editing.js

@@ -1,15 +1,24 @@
 import { PIPELINE } from '../internal/constants.js';
+import { runValidators } from '../internal/validators.js';
 export const DEFAULT_EDITING_CONFIG = Object.freeze({
     enabled: false,
     mode: 'cell',
     trigger: 'doubleClick',
 });
 export class EditingController {
-    constructor(host) {
+    #invalid;
+    #validationVersion;
+    get validationVersion() {
+        return this.#validationVersion;
+    }
+    constructor(host, history) {
         this.host = host;
+        this.history = history;
         this.activeCell = null;
         this.activeRow = null;
         this.pending = new Map();
+        this.#invalid = new Map();
+        this.#validationVersion = 0;
         this.host.addController(this);
     }
     hostConnected() { }
@@ -77,6 +86,74 @@ export class EditingController {
         this.host.emitEvent('rowEditStarted', { detail: { rowIndex } });
         return true;
     }
+    applyCellEdit(rowIndex, columnKey, data, value, options) {
+        const record = data;
+        const oldValue = record[columnKey];
+        if (Object.is(value, oldValue)) {
+            this.clearCellErrors(data, columnKey);
+            return 'unchanged';
+        }
+        if (options?.validate !== false) {
+            const errors = this.validateCell(rowIndex, columnKey, data, value);
+            if (errors.length > 0) {
+                this.#setCellErrors(data, columnKey, errors);
+                this.host.emitEvent('cellValidationFailed', {
+                    detail: { key: columnKey, rowIndex, data, value, errors },
+                });
+                return 'invalid';
+            }
+        }
+        const proceed = this.host.emitEvent('cellValueChanging', {
+            detail: { key: columnKey, rowIndex, data, oldValue, newValue: value },
+            cancelable: true,
+        });
+        if (!proceed)
+            return 'cancelled';
+        record[columnKey] = value;
+        this.clearCellErrors(data, columnKey);
+        this.history?.record({ record: data, key: columnKey, rowIndex, oldValue, newValue: value });
+        this.host.emitEvent('cellValueChanged', {
+            detail: { key: columnKey, rowIndex, data, value },
+        });
+        return 'applied';
+    }
+    validateCell(rowIndex, columnKey, data, value) {
+        const column = this.host.getColumn(columnKey);
+        if (!column?.validators?.length)
+            return [];
+        return runValidators(column.validators, value, {
+            column,
+            data,
+            rowIndex,
+        });
+    }
+    getCellErrors(data, columnKey) {
+        return this.#invalid.get(data)?.get(columnKey) ?? null;
+    }
+    clearCellErrors(data, columnKey) {
+        const perColumn = this.#invalid.get(data);
+        if (!perColumn)
+            return;
+        if (perColumn.delete(columnKey)) {
+            if (perColumn.size === 0)
+                this.#invalid.delete(data);
+            this.#validationVersion += 1;
+        }
+    }
+    clearRecordErrors(data) {
+        if (this.#invalid.delete(data)) {
+            this.#validationVersion += 1;
+        }
+    }
+    #setCellErrors(data, columnKey, errors) {
+        let perColumn = this.#invalid.get(data);
+        if (!perColumn) {
+            perColumn = new Map();
+            this.#invalid.set(data, perColumn);
+        }
+        perColumn.set(columnKey, errors);
+        this.#validationVersion += 1;
+    }
     async commitCell(value) {
         const active = this.activeCell;
         if (!active)
@@ -85,24 +162,21 @@ export class EditingController {
         const oldValue = data[columnKey];
         const candidate = value === undefined ? oldValue : value;
         if (this.mode === 'cell') {
-            if (Object.is(candidate, oldValue)) {
-                this.activeCell = null;
+            const result = this.applyCellEdit(rowIndex, columnKey, data, candidate);
+            if (result === 'cancelled')
+                return false;
+            if (result === 'invalid') {
                 this.host.requestUpdate();
-                return true;
-            }
-            const proceed = this.host.emitEvent('cellValueChanging', {
-                detail: { key: columnKey, rowIndex, data, oldValue, newValue: candidate },
-                cancelable: true,
-            });
-            if (!proceed)
                 return false;
-            data[columnKey] = candidate;
+            }
             this.activeCell = null;
-            this.host.requestUpdate(PIPELINE);
-            await this.host.updateComplete;
-            this.host.emitEvent('cellValueChanged', {
-                detail: { key: columnKey, rowIndex, data, value: candidate },
-            });
+            if (result === 'applied') {
+                this.host.requestUpdate(PIPELINE);
+                await this.host.updateComplete;
+            }
+            else {
+                this.host.requestUpdate();
+            }
             return true;
         }
         if (!Object.is(candidate, oldValue)) {
@@ -121,27 +195,25 @@ export class EditingController {
         const data = this.host.pageItems[rowIndex];
         if (!data)
             return false;
-        const oldValue = data[columnKey];
-        if (Object.is(value, oldValue))
-            return true;
-        const proceed = this.host.emitEvent('cellValueChanging', {
-            detail: { key: columnKey, rowIndex, data, oldValue, newValue: value },
-            cancelable: true,
-        });
-        if (!proceed)
+        const result = this.applyCellEdit(rowIndex, columnKey, data, value);
+        if (result === 'cancelled')
             return false;
-        data[columnKey] = value;
-        this.host.requestUpdate(PIPELINE);
-        await this.host.updateComplete;
-        this.host.emitEvent('cellValueChanged', {
-            detail: { key: columnKey, rowIndex, data, value },
-        });
+        if (result === 'invalid') {
+            this.host.requestUpdate();
+            return false;
+        }
+        if (result === 'applied') {
+            this.host.requestUpdate(PIPELINE);
+            await this.host.updateComplete;
+        }
         return true;
     }
     cancelCell() {
         if (!this.activeCell)
             return;
+        const { data, columnKey } = this.activeCell;
         this.activeCell = null;
+        this.clearCellErrors(data, columnKey);
         this.host.requestUpdate();
     }
     async commitRow() {
@@ -152,20 +224,32 @@ export class EditingController {
         if (this.activeCell?.rowIndex === rowIndex) {
             await this.commitCell();
         }
+        let hasInvalid = false;
         for (const [columnKey, candidate] of this.pending) {
-            const oldValue = data[columnKey];
-            if (Object.is(candidate, oldValue))
-                continue;
-            const proceed = this.host.emitEvent('cellValueChanging', {
-                detail: { key: columnKey, rowIndex, data, oldValue, newValue: candidate },
-                cancelable: true,
-            });
-            if (!proceed)
-                return false;
-            data[columnKey] = candidate;
-            this.host.emitEvent('cellValueChanged', {
-                detail: { key: columnKey, rowIndex, data, value: candidate },
-            });
+            const errors = this.validateCell(rowIndex, columnKey, data, candidate);
+            if (errors.length > 0) {
+                this.#setCellErrors(data, columnKey, errors);
+                this.host.emitEvent('cellValidationFailed', {
+                    detail: { key: columnKey, rowIndex, data, value: candidate, errors },
+                });
+                hasInvalid = true;
+            }
+        }
+        if (hasInvalid) {
+            this.host.requestUpdate();
+            return false;
+        }
+        this.history?.beginBatch();
+        try {
+            for (const [columnKey, candidate] of this.pending) {
+                if (this.applyCellEdit(rowIndex, columnKey, data, candidate, { validate: false }) ===
+                    'cancelled') {
+                    return false;
+                }
+            }
+        }
+        finally {
+            this.history?.endBatch();
         }
         this.pending.clear();
         this.activeRow = null;
@@ -177,10 +261,11 @@ export class EditingController {
     cancelRow() {
         if (!this.activeRow)
             return;
-        const { rowIndex } = this.activeRow;
+        const { rowIndex, data } = this.activeRow;
         this.activeCell = null;
         this.activeRow = null;
         this.pending.clear();
+        this.clearRecordErrors(data);
         this.host.requestUpdate();
         this.host.emitEvent('rowEditEnded', { detail: { rowIndex, committed: false } });
     }

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/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);