apex-grid 3.0.0 → 3.1.0

package/CHANGELOG.md

@@ -0,0 +1,90 @@
+# Changelog — apex-grid
+
+All notable changes to the `apex-grid` (community) package are documented here.
+This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
+and the format is based on [Keep a Changelog](https://keepachangelog.com/).
+
+## [3.1.0] — 2026-06-19
+
+Additive, backward-compatible release. The public `apex-grid` `.` / `./define`
+API and the runtime behavior of `<apex-grid>` are unchanged; everything added
+here is **inert for the community grid** and surfaced only on the unstable
+`apex-grid/internal` subpath for the first-party `apex-grid-enterprise` package.
+
+### Added
+- **Feature-module seam.** `GridFeatureModule` contract plus a `StateController`
+  module registry (`modules`, `module<C>(id)`) and a `createStateController()`
+  factory override point, so a subclass can layer in extra features without
+  forking core. The built-in controller set and `new StateController(host)`
+  remain behavior-identical (an empty module set is a no-op).
+- **Row seams** (`apex-grid/internal`): `RowTransformer.processRows()` (inject /
+  reorder rows after filter → sort → tree, before pagination) and
+  `RowPresenter.presentRow()` (render a row full-width, like the detail panel,
+  with aria-level / expanded).
+- **Cell seams** (`apex-grid/internal`): `CellDecorator.decorateCell()` (a module
+  reflects `data-*` attributes onto individual cells; cells re-evaluate on a
+  `decorationVersion` token bumped via `bumpDecoration()`) and
+  `CellInteractionHandler.handleCellInteraction()` (the grid body forwards
+  pointer down/over/up on cells to modules, gated on `modules.size` so the
+  community grid pays nothing).
+- Inert, variable-driven cell range / fill-handle styling in `body-cell.scss`,
+  keyed off `data-range*` attributes and fully transparent until a theme sets
+  the `--apex-range-*` custom properties.
+
+### Fixed
+- Row render no longer dereferences `undefined` when a row index transiently
+  falls beyond the current `data` (e.g. while a server-side / infinite row model
+  resizes the array on a filter or sort change); the row renders nothing for
+  that frame and re-renders with the real item.
+
+### Notes
+- `apex-grid/internal` is an **unstable, first-party-only** support surface; its
+  shape may change in any release. The community `.` and `./define` exports stay
+  frozen.
+
+## [3.0.1] — 2026-06-10
+
+Documentation-only patch (no runtime or API changes).
+
+### Documentation
+- Documented the `--ag-grid-shadow` theming hook and the flat-by-default grid
+  edge (1px hairline ring; opt back into the elevated card with
+  `--ag-grid-shadow: var(--ag-shadow-card)`, or remove it with `none`).
+- Added `@cssprop` JSDoc for the public `--ag-*` design tokens (incl.
+  `--ag-grid-shadow`) and a `@csspart` entry on the grid root, so the generated
+  Custom Elements Manifest / API reference list the theming surface.
+- Completed the class `@fires` list — added the row- and tree-expansion events
+  (`rowExpanding`, `rowExpanded`, `treeRowExpanding`, `treeRowExpanded`) and
+  attached the missing `rowSelecting` event description.
+- Corrected the stale "getting started" block in the `ApexGrid` JSDoc: theming
+  is via `--ag-*` CSS custom properties (no `configureTheme()` / theme-CSS
+  import required).
+- Fixed an incorrect package name (`@apexcharts/grid-enterprise` →
+  `apex-grid-enterprise`) in export JSDoc.
+
+## [3.0.0] — 2026-06-09
+
+### Changed
+- **BREAKING: Excel (XLSX) export removed from core.** It now lives in
+  [`apex-grid-enterprise`](https://www.npmjs.com/package/apex-grid-enterprise).
+  Core keeps **CSV export** (`exportToCSV`). The toolbar export menu is now
+  driven by a generic seam — `exportFormats` getter + `exportAs(formatId, opts)`
+  — so derived grids can add formats. Migrate `grid.exportToXLSX(...)` calls by
+  switching to `<apex-grid-enterprise>` (see its README).
+- **Theming is now CSS-variable based.** The grid styles itself out of the box
+  through `--ag-*` custom properties — no theme import or `configureTheme()`
+  call is required. When `igniteui-webcomponents` is present, brand tokens
+  auto-tint from its palette.
+- **Neutral restyle**: grayscale chrome with brand color reserved for state and
+  accents.
+- **Flat grid edge by default.** The host no longer paints a heavy floating-card
+  shadow; it shows a flat 1px hairline edge. Restore the prior look with
+  `--ag-grid-shadow: var(--ag-shadow-card)`.
+
+### Project
+- Repository converted to an npm-workspaces monorepo; this package publishes
+  from `packages/core`.
+
+[3.1.0]: https://github.com/apexcharts/apex-grid/releases
+[3.0.1]: https://github.com/apexcharts/apex-grid/releases
+[3.0.0]: https://github.com/apexcharts/apex-grid/releases

package/README.md

@@ -119,6 +119,13 @@ apex-grid {
 
 See [`src/styles/_tokens.scss`](src/styles/_tokens.scss) for the full token list (brand, surfaces, text, semantic state colors, typography, spacing, motion).
 
+**Grid edge / shadow.** By default the grid shows a flat 1px hairline edge (no drop shadow). Control it with the `--ag-grid-shadow` hook — this is an opt-in override, not one of the `_tokens.scss` defaults:
+
+```css
+apex-grid { --ag-grid-shadow: var(--ag-shadow-card); } /* elevated floating-card look */
+apex-grid { --ag-grid-shadow: none; }                  /* remove the edge entirely */
+```
+
 If you embed the grid alongside `igniteui-webcomponents`, the brand tokens automatically re-tint from the igniteui palette (`--ig-primary-500`) — no configuration needed.
 
 ### 4. Size the host

package/components/cell.d.ts

@@ -46,6 +46,13 @@ export default class ApexGridCell<T extends object> extends LitElement {
      * auto-rendered selection + expansion columns ahead of the data columns.
      */
     colindex: number;
+    /**
+     * Reactive token forwarded from {@link StateController.decorationVersion}.
+     * Changing it re-runs {@link willUpdate} so module-driven cell decoration is
+     * re-evaluated when it changes (e.g. while dragging a selection range). Stays
+     * `0` for the community grid, so cells are never re-decorated there.
+     */
+    decorationVersion: number;
     connectedCallback(): void;
     disconnectedCallback(): void;
     protected willUpdate(): void;

package/components/cell.js

@@ -18,6 +18,8 @@ export default class ApexGridCell extends LitElement {
         this.active = false;
         this.editing = false;
         this.colindex = 0;
+        this.decorationVersion = 0;
+        this.#decoratedKeys = [];
         this.#handleClick = (event) => {
             if (this.isEditing) {
                 event.stopPropagation();
@@ -145,6 +147,7 @@ export default class ApexGridCell extends LitElement {
             return false;
         return this.editingController.isEditable(this.column);
     }
+    #decoratedKeys;
     connectedCallback() {
         super.connectedCallback();
         this.setAttribute('role', 'gridcell');
@@ -181,6 +184,33 @@ export default class ApexGridCell extends LitElement {
         else {
             this.removeAttribute('data-tree-expanded');
         }
+        this.#applyDecoration();
+    }
+    #applyDecoration() {
+        const decoration = this.state && this.row
+            ? this.state.decorateCell({
+                row: this.row.data,
+                rowIndex: this.row.index,
+                column: this.column,
+                value: this.value,
+            })
+            : null;
+        const next = decoration?.attributes ?? {};
+        for (const key of this.#decoratedKeys) {
+            if (next[key] == null)
+                this.removeAttribute(key);
+        }
+        const applied = [];
+        for (const [key, value] of Object.entries(next)) {
+            if (value == null) {
+                this.removeAttribute(key);
+            }
+            else {
+                this.setAttribute(key, value);
+                applied.push(key);
+            }
+        }
+        this.#decoratedKeys = applied;
     }
     updated() {
         if (this.isEditing) {
@@ -373,4 +403,7 @@ __decorate([
 __decorate([
     property({ attribute: false, type: Number })
 ], ApexGridCell.prototype, "colindex", void 0);
+__decorate([
+    property({ attribute: false, type: Number })
+], ApexGridCell.prototype, "decorationVersion", void 0);
 //# sourceMappingURL=cell.js.map

package/components/cell.js.map

@@ -1 +1 @@
-{"version":3,"file":"cell.js","sourceRoot":"","sources":["../../src/components/cell.ts"],"names":[],"mappings":"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","sourcesContent":["import { consume } from '@lit/context';\nimport { html, LitElement } from 'lit';\nimport { property, query } from 'lit/decorators.js';\nimport { gridStateContext, type StateController } from '../controllers/state.js';\nimport { getColumnTypeRenderer } from '../internal/column-types.js';\nimport { registerComponent } from '../internal/register.js';\nimport { GRID_CELL_TAG } from '../internal/tags.js';\nimport type {\n  ApexCellContext,\n  ApexEditorContext,\n  ColumnConfiguration,\n  PropertyType,\n} from '../internal/types.js';\nimport { styles } from '../styles/body-cell/body-cell.css.js';\nimport type ApexGridRow from './row.js';\n\n/**\n * Component representing a DOM cell of the Apex grid.\n *\n * @csspart cell - The cell host element.\n * @csspart editor - The editor wrapper rendered while the cell is in edit mode.\n */\nexport default class ApexGridCell<T extends object> extends LitElement {\n  public static get tagName() {\n    return GRID_CELL_TAG;\n  }\n\n  public static override styles = styles;\n\n  public static register(): void {\n    registerComponent(ApexGridCell);\n  }\n\n  /**\n   * The value which will be rendered by the component.\n   */\n  @property({ attribute: false })\n  public value!: PropertyType<T>;\n\n  /**\n   * A reference to the column configuration object.\n   */\n  @property({ attribute: false })\n  public column!: ColumnConfiguration<T>;\n\n  /**\n   * Indicates whether this is the active cell in the grid.\n   *\n   */\n  @property({ type: Boolean, reflect: true })\n  public active = false;\n\n  /**\n   * Whether the cell is currently in edit mode. Set by the parent row from the\n   * editing controller's state so cells re-render on edit state changes.\n   */\n  @property({ type: Boolean, reflect: true })\n  public editing = false;\n\n  @consume({ context: gridStateContext, subscribe: true })\n  @property({ attribute: false })\n  public state!: StateController<T>;\n\n  /**\n   * The parent row component holding this cell.\n   */\n  public row!: ApexGridRow<T>;\n\n  @query('input, [data-apex-editor]')\n  protected editorElement!: HTMLElement | null;\n\n  protected get context(): ApexCellContext<T> {\n    const ctx = {\n      parent: this,\n      row: this.row,\n      column: this.column,\n      value: this.value,\n    } as unknown as {\n      parent: ApexGridCell<T>;\n      row: ApexGridRow<T>;\n      column: ColumnConfiguration<T>;\n      value: PropertyType<T>;\n      commit?: (value: unknown) => Promise<boolean>;\n    };\n    // Only expose `commit` when the column is editable — non-editable\n    // interactive widgets should render as read-only.\n    if (this.isEditable) {\n      ctx.commit = (next: unknown) =>\n        this.editingController.commitImmediate(this.row.index, this.column.key, next);\n    }\n    return ctx as unknown as ApexCellContext<T>;\n  }\n\n  protected get editingController() {\n    return this.state.editing;\n  }\n\n  protected get isEditing(): boolean {\n    return this.editing;\n  }\n\n  protected get isEditable(): boolean {\n    if (!this.editingController) return false;\n    return this.editingController.isEditable(this.column);\n  }\n\n  /**\n   * 1-based column index used to populate `aria-colindex`. Accounts for the\n   * auto-rendered selection + expansion columns ahead of the data columns.\n   */\n  @property({ attribute: false, type: Number })\n  public colindex = 0;\n\n  public override connectedCallback(): void {\n    super.connectedCallback();\n    this.setAttribute('role', 'gridcell');\n    this.addEventListener('click', this.#handleClick);\n    this.addEventListener('dblclick', this.#handleDoubleClick);\n    this.addEventListener('keydown', this.#handleCellKeydown);\n    this.addEventListener('focusout', this.#handleCellFocusOut);\n  }\n\n  public override disconnectedCallback(): void {\n    this.removeEventListener('click', this.#handleClick);\n    this.removeEventListener('dblclick', this.#handleDoubleClick);\n    this.removeEventListener('keydown', this.#handleCellKeydown);\n    this.removeEventListener('focusout', this.#handleCellFocusOut);\n    super.disconnectedCallback();\n  }\n\n  protected override willUpdate() {\n    if (this.colindex > 0) {\n      this.setAttribute('aria-colindex', String(this.colindex));\n    } else {\n      this.removeAttribute('aria-colindex');\n    }\n    if (this.active) {\n      this.setAttribute('aria-current', 'true');\n    } else {\n      this.removeAttribute('aria-current');\n    }\n    // Reflect tree-expanded state on the group cell so the SCSS chevron\n    // rotation triggers from this attribute (cheaper than per-render style\n    // mutations and keeps the SVG transform purely declarative).\n    const tree = this.state?.tree;\n    const isGroup = tree?.enabled && this.row?.data && tree.isGroupColumn(this.column.key);\n    if (isGroup && tree.isExpanded(this.row.data)) {\n      this.setAttribute('data-tree-expanded', '');\n    } else {\n      this.removeAttribute('data-tree-expanded');\n    }\n  }\n\n  protected override updated() {\n    if (this.isEditing) {\n      const editor = this.editorElement;\n      editor?.focus();\n      if (editor instanceof HTMLInputElement) {\n        if (editor.type === 'text' || editor.type === 'number') {\n          editor.select();\n        }\n      }\n    }\n  }\n\n  #handleClick = (event: MouseEvent) => {\n    if (this.isEditing) {\n      // Don't let clicks inside the editor bubble into navigation / outside-click commits.\n      event.stopPropagation();\n      return;\n    }\n    if (!this.isEditable) return;\n    // Boolean cells handle interaction in their display widget — clicking the\n    // checkbox commits inline via `ctx.commit`. We never enter edit mode for\n    // booleans, which avoids the visual reflow between display/editor markup\n    // and lets a single click toggle the value.\n    if (this.column.type === 'boolean') return;\n    if (this.editingController.trigger !== 'click') return;\n    this.#startEdit();\n  };\n\n  #handleDoubleClick = (event: MouseEvent) => {\n    if (this.isEditing) {\n      event.stopPropagation();\n      return;\n    }\n    if (!this.isEditable) return;\n    if (this.column.type === 'boolean') return;\n    if (this.editingController.trigger !== 'doubleClick') return;\n    this.#startEdit();\n  };\n\n  #startEdit() {\n    if (!this.row) return;\n    this.editingController.editCell(this.row.index, this.column.key);\n  }\n\n  #pendingValue: unknown;\n\n  #commitWith = async (value?: unknown): Promise<boolean> => {\n    return this.editingController.commitCell(value ?? this.#pendingValue);\n  };\n\n  #cancel = () => {\n    this.editingController.cancelCell();\n  };\n\n  #handleKeydown = (event: KeyboardEvent) => {\n    event.stopPropagation();\n    switch (event.key) {\n      case 'Enter':\n        event.preventDefault();\n        this.#commitWith();\n        return;\n      case 'Escape':\n        event.preventDefault();\n        this.#cancel();\n        return;\n      case 'Tab':\n        // Commit first; navigation moves to the next/prev cell. Editing of the\n        // landed cell stays manual (Enter to re-edit) for predictability.\n        event.preventDefault();\n        this.#commitWith();\n        return;\n      default:\n        return;\n    }\n  };\n\n  #handleBlur = () => {\n    if (!this.isEditing) return;\n    if (this.editingController.mode === 'cell') {\n      this.#commitWith();\n    } else {\n      // Row mode — stash the value and exit the cell editor; the row stays open.\n      this.editingController.commitCell(this.#pendingValue);\n    }\n  };\n\n  /**\n   * Cell-level keydown that catches keys bubbling out of registry-built\n   * editors (the default editor stops propagation on its own input).\n   *\n   * - Escape always cancels the edit.\n   * - Tab commits (or closes when there's no draft — `commitCell()` with\n   *   `undefined` value is treated as \"no change\" by the controller).\n   *\n   * Per-editor `keydown` handlers that need to consume Enter (e.g. the\n   * built-in `<select>` editor) still get the first crack — they call\n   * `event.stopPropagation()` and we never see those keys here.\n   */\n  #handleCellKeydown = (event: KeyboardEvent) => {\n    if (!this.isEditing) return;\n    if (event.key === 'Escape') {\n      event.preventDefault();\n      this.#cancel();\n      return;\n    }\n    if (event.key === 'Tab') {\n      event.preventDefault();\n      this.#commitWith();\n    }\n  };\n\n  /**\n   * Cell-level focus-out: commits the active edit when focus truly leaves\n   * the cell (clicking another cell, tabbing past the editor, blurring to\n   * the document body). The default editor's input also has `@blur` which\n   * commits first; by that time `isEditing` is false and this is a no-op.\n   *\n   * For built-in registry editors `commitCell()` with no explicit value\n   * resolves to the current data value — same shape as \"no change\", so\n   * losing focus without picking discards the open editor without writing\n   * spurious data.\n   */\n  #handleCellFocusOut = (event: FocusEvent) => {\n    if (!this.isEditing) return;\n    const next = event.relatedTarget as Node | null;\n    if (next && (this.contains(next) || this.shadowRoot?.contains(next))) return;\n    if (this.editingController.mode === 'cell') {\n      this.#commitWith();\n    } else {\n      this.editingController.commitCell(this.#pendingValue);\n    }\n  };\n\n  #handleTextInput = (event: Event) => {\n    const target = event.target as HTMLInputElement;\n    this.#pendingValue = this.column.type === 'number' ? target.valueAsNumber : target.value;\n  };\n\n  #handleCheckboxChange = (event: Event) => {\n    const target = event.target as HTMLInputElement;\n    this.#pendingValue = target.checked;\n    // Booleans commit immediately — toggling is the whole interaction.\n    this.#commitWith(target.checked);\n  };\n\n  protected renderDefaultEditor() {\n    const value = this.value as unknown;\n    if (this.column.type === 'boolean') {\n      this.#pendingValue = Boolean(value);\n      return html`<input\n        type=\"checkbox\"\n        part=\"editor\"\n        data-apex-editor\n        ?checked=${Boolean(value)}\n        @change=${this.#handleCheckboxChange}\n        @keydown=${this.#handleKeydown}\n        @blur=${this.#handleBlur}\n      />`;\n    }\n    if (this.column.type === 'number') {\n      this.#pendingValue = value;\n      return html`<input\n        type=\"number\"\n        part=\"editor\"\n        data-apex-editor\n        .value=${value == null ? '' : String(value)}\n        @input=${this.#handleTextInput}\n        @keydown=${this.#handleKeydown}\n        @blur=${this.#handleBlur}\n      />`;\n    }\n    this.#pendingValue = value;\n    return html`<input\n      type=\"text\"\n      part=\"editor\"\n      data-apex-editor\n      .value=${value == null ? '' : String(value)}\n      @input=${this.#handleTextInput}\n      @keydown=${this.#handleKeydown}\n      @blur=${this.#handleBlur}\n    />`;\n  }\n\n  protected renderEditor() {\n    const template = this.column.editorTemplate;\n    const ctx = {\n      parent: this,\n      row: this.row,\n      column: this.column,\n      value: this.value,\n      commit: (next: unknown) => this.editingController.commitCell(next),\n      cancel: () => this.editingController.cancelCell(),\n    };\n    if (template) {\n      // For custom editors we don't know the draft shape; reset pending so\n      // cell-level commit doesn't write a stale value from a previous edit.\n      this.#pendingValue = this.value;\n      return template(ctx as unknown as ApexEditorContext<T> as never);\n    }\n    const typeRenderer = getColumnTypeRenderer<T>(this.column.type);\n    if (typeRenderer?.editor) {\n      this.#pendingValue = this.value;\n      return typeRenderer.editor(ctx as never);\n    }\n    return this.renderDefaultEditor();\n  }\n\n  /**\n   * Renders the tree affordance — depth-based indent + a chevron toggle (or\n   * leaf spacer) — that prefixes the group cell when {@link ApexGrid.tree}\n   * is enabled. Returns `nothing` for every other cell.\n   */\n  protected renderTreeAffordance() {\n    const tree = this.state?.tree;\n    if (!tree?.enabled) return null;\n    if (!this.row?.data) return null;\n    if (!tree.isGroupColumn(this.column.key)) return null;\n\n    const data = this.row.data;\n    const meta = tree.getMeta(data);\n    if (!meta) return null;\n\n    const indent = meta.depth * tree.childIndent;\n    const expanded = tree.isExpanded(data);\n    const handleClick = (event: MouseEvent) => {\n      event.stopPropagation();\n      if (!meta.hasChildren) return;\n      void tree.toggleRow(data);\n    };\n\n    const chevron = meta.hasChildren\n      ? html`<button\n          type=\"button\"\n          part=\"tree-toggle\"\n          aria-label=${expanded ? 'Collapse row' : 'Expand row'}\n          aria-expanded=${expanded ? 'true' : 'false'}\n          @click=${handleClick}\n        >\n          <svg\n            part=\"tree-chevron\"\n            viewBox=\"0 0 24 24\"\n            aria-hidden=\"true\"\n            width=\"14\"\n            height=\"14\"\n          >\n            <path\n              d=\"M9 6l6 6-6 6\"\n              fill=\"none\"\n              stroke=\"currentColor\"\n              stroke-width=\"2\"\n              stroke-linecap=\"round\"\n              stroke-linejoin=\"round\"\n            />\n          </svg>\n        </button>`\n      : html`<span part=\"tree-spacer\" aria-hidden=\"true\"></span>`;\n\n    return html`<span\n        part=\"tree-indent\"\n        aria-hidden=\"true\"\n        style=${`inline-size: ${indent}px`}\n      ></span>${chevron}`;\n  }\n\n  /**\n   * Resolves the value to display for the cell. Synthesized tree parents\n   * (those that appear only as a path segment with no backing data) render\n   * their last path segment in the group column and nothing elsewhere.\n   */\n  protected resolveDisplayValue(): unknown {\n    const tree = this.state?.tree;\n    if (tree?.enabled && this.row?.data && tree.isSynthesized(this.row.data)) {\n      return tree.isGroupColumn(this.column.key) ? tree.getLabel(this.row.data) : '';\n    }\n    return this.value;\n  }\n\n  protected renderCellBody() {\n    if (this.column.cellTemplate) {\n      return this.column.cellTemplate(this.context as ApexCellContext<T> as never);\n    }\n    const typeRenderer = getColumnTypeRenderer<T>(this.column.type);\n    if (typeRenderer?.display) {\n      // Synthesized parents have no real backing data — route them through\n      // a plain text render instead of the typed renderer.\n      const tree = this.state?.tree;\n      if (tree?.enabled && this.row?.data && tree.isSynthesized(this.row.data)) {\n        return html`${this.resolveDisplayValue()}`;\n      }\n      return typeRenderer.display(this.context as never);\n    }\n    return html`${this.resolveDisplayValue()}`;\n  }\n\n  protected override render() {\n    if (this.isEditing) {\n      return this.renderEditor();\n    }\n    const affordance = this.renderTreeAffordance();\n    if (affordance) {\n      return html`${affordance}<span part=\"tree-cell-content\">${this.renderCellBody()}</span>`;\n    }\n    return this.renderCellBody();\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    [ApexGridCell.tagName]: ApexGridCell<object>;\n  }\n}\n"]}
+{"version":3,"file":"cell.js","sourceRoot":"","sources":["../../src/components/cell.ts"],"names":[],"mappings":"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","sourcesContent":["import { consume } from '@lit/context';\nimport { html, LitElement } from 'lit';\nimport { property, query } from 'lit/decorators.js';\nimport { gridStateContext, type StateController } from '../controllers/state.js';\nimport { getColumnTypeRenderer } from '../internal/column-types.js';\nimport { registerComponent } from '../internal/register.js';\nimport { GRID_CELL_TAG } from '../internal/tags.js';\nimport type {\n  ApexCellContext,\n  ApexEditorContext,\n  ColumnConfiguration,\n  PropertyType,\n} from '../internal/types.js';\nimport { styles } from '../styles/body-cell/body-cell.css.js';\nimport type ApexGridRow from './row.js';\n\n/**\n * Component representing a DOM cell of the Apex grid.\n *\n * @csspart cell - The cell host element.\n * @csspart editor - The editor wrapper rendered while the cell is in edit mode.\n */\nexport default class ApexGridCell<T extends object> extends LitElement {\n  public static get tagName() {\n    return GRID_CELL_TAG;\n  }\n\n  public static override styles = styles;\n\n  public static register(): void {\n    registerComponent(ApexGridCell);\n  }\n\n  /**\n   * The value which will be rendered by the component.\n   */\n  @property({ attribute: false })\n  public value!: PropertyType<T>;\n\n  /**\n   * A reference to the column configuration object.\n   */\n  @property({ attribute: false })\n  public column!: ColumnConfiguration<T>;\n\n  /**\n   * Indicates whether this is the active cell in the grid.\n   *\n   */\n  @property({ type: Boolean, reflect: true })\n  public active = false;\n\n  /**\n   * Whether the cell is currently in edit mode. Set by the parent row from the\n   * editing controller's state so cells re-render on edit state changes.\n   */\n  @property({ type: Boolean, reflect: true })\n  public editing = false;\n\n  @consume({ context: gridStateContext, subscribe: true })\n  @property({ attribute: false })\n  public state!: StateController<T>;\n\n  /**\n   * The parent row component holding this cell.\n   */\n  public row!: ApexGridRow<T>;\n\n  @query('input, [data-apex-editor]')\n  protected editorElement!: HTMLElement | null;\n\n  protected get context(): ApexCellContext<T> {\n    const ctx = {\n      parent: this,\n      row: this.row,\n      column: this.column,\n      value: this.value,\n    } as unknown as {\n      parent: ApexGridCell<T>;\n      row: ApexGridRow<T>;\n      column: ColumnConfiguration<T>;\n      value: PropertyType<T>;\n      commit?: (value: unknown) => Promise<boolean>;\n    };\n    // Only expose `commit` when the column is editable — non-editable\n    // interactive widgets should render as read-only.\n    if (this.isEditable) {\n      ctx.commit = (next: unknown) =>\n        this.editingController.commitImmediate(this.row.index, this.column.key, next);\n    }\n    return ctx as unknown as ApexCellContext<T>;\n  }\n\n  protected get editingController() {\n    return this.state.editing;\n  }\n\n  protected get isEditing(): boolean {\n    return this.editing;\n  }\n\n  protected get isEditable(): boolean {\n    if (!this.editingController) return false;\n    return this.editingController.isEditable(this.column);\n  }\n\n  /**\n   * 1-based column index used to populate `aria-colindex`. Accounts for the\n   * auto-rendered selection + expansion columns ahead of the data columns.\n   */\n  @property({ attribute: false, type: Number })\n  public colindex = 0;\n\n  /**\n   * Reactive token forwarded from {@link StateController.decorationVersion}.\n   * Changing it re-runs {@link willUpdate} so module-driven cell decoration is\n   * re-evaluated when it changes (e.g. while dragging a selection range). Stays\n   * `0` for the community grid, so cells are never re-decorated there.\n   */\n  @property({ attribute: false, type: Number })\n  public decorationVersion = 0;\n\n  /** Decoration attribute keys applied on the previous update, for cleanup. */\n  #decoratedKeys: string[] = [];\n\n  public override connectedCallback(): void {\n    super.connectedCallback();\n    this.setAttribute('role', 'gridcell');\n    this.addEventListener('click', this.#handleClick);\n    this.addEventListener('dblclick', this.#handleDoubleClick);\n    this.addEventListener('keydown', this.#handleCellKeydown);\n    this.addEventListener('focusout', this.#handleCellFocusOut);\n  }\n\n  public override disconnectedCallback(): void {\n    this.removeEventListener('click', this.#handleClick);\n    this.removeEventListener('dblclick', this.#handleDoubleClick);\n    this.removeEventListener('keydown', this.#handleCellKeydown);\n    this.removeEventListener('focusout', this.#handleCellFocusOut);\n    super.disconnectedCallback();\n  }\n\n  protected override willUpdate() {\n    if (this.colindex > 0) {\n      this.setAttribute('aria-colindex', String(this.colindex));\n    } else {\n      this.removeAttribute('aria-colindex');\n    }\n    if (this.active) {\n      this.setAttribute('aria-current', 'true');\n    } else {\n      this.removeAttribute('aria-current');\n    }\n    // Reflect tree-expanded state on the group cell so the SCSS chevron\n    // rotation triggers from this attribute (cheaper than per-render style\n    // mutations and keeps the SVG transform purely declarative).\n    const tree = this.state?.tree;\n    const isGroup = tree?.enabled && this.row?.data && tree.isGroupColumn(this.column.key);\n    if (isGroup && tree.isExpanded(this.row.data)) {\n      this.setAttribute('data-tree-expanded', '');\n    } else {\n      this.removeAttribute('data-tree-expanded');\n    }\n\n    this.#applyDecoration();\n  }\n\n  /**\n   * Reflects module-contributed decoration attributes (see {@link CellDecorator})\n   * onto the cell host, reconciling against the previous update so attributes\n   * that are no longer present are removed. Inert for the community grid:\n   * `state.decorateCell` returns `null` with no modules, so nothing is set.\n   */\n  #applyDecoration(): void {\n    const decoration =\n      this.state && this.row\n        ? this.state.decorateCell({\n            row: this.row.data,\n            rowIndex: this.row.index,\n            column: this.column,\n            value: this.value as unknown,\n          })\n        : null;\n    const next = decoration?.attributes ?? {};\n\n    // Remove anything we set last time that's gone (or explicitly cleared).\n    for (const key of this.#decoratedKeys) {\n      if (next[key] == null) this.removeAttribute(key);\n    }\n\n    const applied: string[] = [];\n    for (const [key, value] of Object.entries(next)) {\n      if (value == null) {\n        this.removeAttribute(key);\n      } else {\n        this.setAttribute(key, value);\n        applied.push(key);\n      }\n    }\n    this.#decoratedKeys = applied;\n  }\n\n  protected override updated() {\n    if (this.isEditing) {\n      const editor = this.editorElement;\n      editor?.focus();\n      if (editor instanceof HTMLInputElement) {\n        if (editor.type === 'text' || editor.type === 'number') {\n          editor.select();\n        }\n      }\n    }\n  }\n\n  #handleClick = (event: MouseEvent) => {\n    if (this.isEditing) {\n      // Don't let clicks inside the editor bubble into navigation / outside-click commits.\n      event.stopPropagation();\n      return;\n    }\n    if (!this.isEditable) return;\n    // Boolean cells handle interaction in their display widget — clicking the\n    // checkbox commits inline via `ctx.commit`. We never enter edit mode for\n    // booleans, which avoids the visual reflow between display/editor markup\n    // and lets a single click toggle the value.\n    if (this.column.type === 'boolean') return;\n    if (this.editingController.trigger !== 'click') return;\n    this.#startEdit();\n  };\n\n  #handleDoubleClick = (event: MouseEvent) => {\n    if (this.isEditing) {\n      event.stopPropagation();\n      return;\n    }\n    if (!this.isEditable) return;\n    if (this.column.type === 'boolean') return;\n    if (this.editingController.trigger !== 'doubleClick') return;\n    this.#startEdit();\n  };\n\n  #startEdit() {\n    if (!this.row) return;\n    this.editingController.editCell(this.row.index, this.column.key);\n  }\n\n  #pendingValue: unknown;\n\n  #commitWith = async (value?: unknown): Promise<boolean> => {\n    return this.editingController.commitCell(value ?? this.#pendingValue);\n  };\n\n  #cancel = () => {\n    this.editingController.cancelCell();\n  };\n\n  #handleKeydown = (event: KeyboardEvent) => {\n    event.stopPropagation();\n    switch (event.key) {\n      case 'Enter':\n        event.preventDefault();\n        this.#commitWith();\n        return;\n      case 'Escape':\n        event.preventDefault();\n        this.#cancel();\n        return;\n      case 'Tab':\n        // Commit first; navigation moves to the next/prev cell. Editing of the\n        // landed cell stays manual (Enter to re-edit) for predictability.\n        event.preventDefault();\n        this.#commitWith();\n        return;\n      default:\n        return;\n    }\n  };\n\n  #handleBlur = () => {\n    if (!this.isEditing) return;\n    if (this.editingController.mode === 'cell') {\n      this.#commitWith();\n    } else {\n      // Row mode — stash the value and exit the cell editor; the row stays open.\n      this.editingController.commitCell(this.#pendingValue);\n    }\n  };\n\n  /**\n   * Cell-level keydown that catches keys bubbling out of registry-built\n   * editors (the default editor stops propagation on its own input).\n   *\n   * - Escape always cancels the edit.\n   * - Tab commits (or closes when there's no draft — `commitCell()` with\n   *   `undefined` value is treated as \"no change\" by the controller).\n   *\n   * Per-editor `keydown` handlers that need to consume Enter (e.g. the\n   * built-in `<select>` editor) still get the first crack — they call\n   * `event.stopPropagation()` and we never see those keys here.\n   */\n  #handleCellKeydown = (event: KeyboardEvent) => {\n    if (!this.isEditing) return;\n    if (event.key === 'Escape') {\n      event.preventDefault();\n      this.#cancel();\n      return;\n    }\n    if (event.key === 'Tab') {\n      event.preventDefault();\n      this.#commitWith();\n    }\n  };\n\n  /**\n   * Cell-level focus-out: commits the active edit when focus truly leaves\n   * the cell (clicking another cell, tabbing past the editor, blurring to\n   * the document body). The default editor's input also has `@blur` which\n   * commits first; by that time `isEditing` is false and this is a no-op.\n   *\n   * For built-in registry editors `commitCell()` with no explicit value\n   * resolves to the current data value — same shape as \"no change\", so\n   * losing focus without picking discards the open editor without writing\n   * spurious data.\n   */\n  #handleCellFocusOut = (event: FocusEvent) => {\n    if (!this.isEditing) return;\n    const next = event.relatedTarget as Node | null;\n    if (next && (this.contains(next) || this.shadowRoot?.contains(next))) return;\n    if (this.editingController.mode === 'cell') {\n      this.#commitWith();\n    } else {\n      this.editingController.commitCell(this.#pendingValue);\n    }\n  };\n\n  #handleTextInput = (event: Event) => {\n    const target = event.target as HTMLInputElement;\n    this.#pendingValue = this.column.type === 'number' ? target.valueAsNumber : target.value;\n  };\n\n  #handleCheckboxChange = (event: Event) => {\n    const target = event.target as HTMLInputElement;\n    this.#pendingValue = target.checked;\n    // Booleans commit immediately — toggling is the whole interaction.\n    this.#commitWith(target.checked);\n  };\n\n  protected renderDefaultEditor() {\n    const value = this.value as unknown;\n    if (this.column.type === 'boolean') {\n      this.#pendingValue = Boolean(value);\n      return html`<input\n        type=\"checkbox\"\n        part=\"editor\"\n        data-apex-editor\n        ?checked=${Boolean(value)}\n        @change=${this.#handleCheckboxChange}\n        @keydown=${this.#handleKeydown}\n        @blur=${this.#handleBlur}\n      />`;\n    }\n    if (this.column.type === 'number') {\n      this.#pendingValue = value;\n      return html`<input\n        type=\"number\"\n        part=\"editor\"\n        data-apex-editor\n        .value=${value == null ? '' : String(value)}\n        @input=${this.#handleTextInput}\n        @keydown=${this.#handleKeydown}\n        @blur=${this.#handleBlur}\n      />`;\n    }\n    this.#pendingValue = value;\n    return html`<input\n      type=\"text\"\n      part=\"editor\"\n      data-apex-editor\n      .value=${value == null ? '' : String(value)}\n      @input=${this.#handleTextInput}\n      @keydown=${this.#handleKeydown}\n      @blur=${this.#handleBlur}\n    />`;\n  }\n\n  protected renderEditor() {\n    const template = this.column.editorTemplate;\n    const ctx = {\n      parent: this,\n      row: this.row,\n      column: this.column,\n      value: this.value,\n      commit: (next: unknown) => this.editingController.commitCell(next),\n      cancel: () => this.editingController.cancelCell(),\n    };\n    if (template) {\n      // For custom editors we don't know the draft shape; reset pending so\n      // cell-level commit doesn't write a stale value from a previous edit.\n      this.#pendingValue = this.value;\n      return template(ctx as unknown as ApexEditorContext<T> as never);\n    }\n    const typeRenderer = getColumnTypeRenderer<T>(this.column.type);\n    if (typeRenderer?.editor) {\n      this.#pendingValue = this.value;\n      return typeRenderer.editor(ctx as never);\n    }\n    return this.renderDefaultEditor();\n  }\n\n  /**\n   * Renders the tree affordance — depth-based indent + a chevron toggle (or\n   * leaf spacer) — that prefixes the group cell when {@link ApexGrid.tree}\n   * is enabled. Returns `nothing` for every other cell.\n   */\n  protected renderTreeAffordance() {\n    const tree = this.state?.tree;\n    if (!tree?.enabled) return null;\n    if (!this.row?.data) return null;\n    if (!tree.isGroupColumn(this.column.key)) return null;\n\n    const data = this.row.data;\n    const meta = tree.getMeta(data);\n    if (!meta) return null;\n\n    const indent = meta.depth * tree.childIndent;\n    const expanded = tree.isExpanded(data);\n    const handleClick = (event: MouseEvent) => {\n      event.stopPropagation();\n      if (!meta.hasChildren) return;\n      void tree.toggleRow(data);\n    };\n\n    const chevron = meta.hasChildren\n      ? html`<button\n          type=\"button\"\n          part=\"tree-toggle\"\n          aria-label=${expanded ? 'Collapse row' : 'Expand row'}\n          aria-expanded=${expanded ? 'true' : 'false'}\n          @click=${handleClick}\n        >\n          <svg\n            part=\"tree-chevron\"\n            viewBox=\"0 0 24 24\"\n            aria-hidden=\"true\"\n            width=\"14\"\n            height=\"14\"\n          >\n            <path\n              d=\"M9 6l6 6-6 6\"\n              fill=\"none\"\n              stroke=\"currentColor\"\n              stroke-width=\"2\"\n              stroke-linecap=\"round\"\n              stroke-linejoin=\"round\"\n            />\n          </svg>\n        </button>`\n      : html`<span part=\"tree-spacer\" aria-hidden=\"true\"></span>`;\n\n    return html`<span\n        part=\"tree-indent\"\n        aria-hidden=\"true\"\n        style=${`inline-size: ${indent}px`}\n      ></span>${chevron}`;\n  }\n\n  /**\n   * Resolves the value to display for the cell. Synthesized tree parents\n   * (those that appear only as a path segment with no backing data) render\n   * their last path segment in the group column and nothing elsewhere.\n   */\n  protected resolveDisplayValue(): unknown {\n    const tree = this.state?.tree;\n    if (tree?.enabled && this.row?.data && tree.isSynthesized(this.row.data)) {\n      return tree.isGroupColumn(this.column.key) ? tree.getLabel(this.row.data) : '';\n    }\n    return this.value;\n  }\n\n  protected renderCellBody() {\n    if (this.column.cellTemplate) {\n      return this.column.cellTemplate(this.context as ApexCellContext<T> as never);\n    }\n    const typeRenderer = getColumnTypeRenderer<T>(this.column.type);\n    if (typeRenderer?.display) {\n      // Synthesized parents have no real backing data — route them through\n      // a plain text render instead of the typed renderer.\n      const tree = this.state?.tree;\n      if (tree?.enabled && this.row?.data && tree.isSynthesized(this.row.data)) {\n        return html`${this.resolveDisplayValue()}`;\n      }\n      return typeRenderer.display(this.context as never);\n    }\n    return html`${this.resolveDisplayValue()}`;\n  }\n\n  protected override render() {\n    if (this.isEditing) {\n      return this.renderEditor();\n    }\n    const affordance = this.renderTreeAffordance();\n    if (affordance) {\n      return html`${affordance}<span part=\"tree-cell-content\">${this.renderCellBody()}</span>`;\n    }\n    return this.renderCellBody();\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    [ApexGridCell.tagName]: ApexGridCell<object>;\n  }\n}\n"]}

package/components/filter-row.d.ts

@@ -28,7 +28,7 @@ export default class ApexFilterRow<T extends object> extends LitElement {
     connectedCallback(): void;
     disconnectedCallback(): void;
     protected activeChanged(): void;
-    protected renderCriteriaButton(expr: FilterExpression<T>, index: number): typeof nothing | import("lit-html").TemplateResult<1>;
+    protected renderCriteriaButton(expr: FilterExpression<T>, index: number): import("lit-html").TemplateResult<1> | typeof nothing;
     protected renderExpressionChip(props: ExpressionChipProps<T>): import("lit-html").TemplateResult<1>;
     protected renderActiveChips(): typeof nothing | import("lit-html").TemplateResult<1>[];
     protected renderFilterActions(): import("lit-html").TemplateResult<1>;

package/components/grid.d.ts

@@ -463,16 +463,6 @@ export interface ApexGridEventMap<T extends object> {
      * @event
      */
     rowEditEnded: CustomEvent<ApexRowEditEndedEvent>;
-    /**
-     * Emitted before the row selection set changes.
-     *
-     * @remarks
-     * Cancellable — calling `preventDefault()` aborts the selection change.
-     * Fires for every selection-mutating call (toggle, range select, select-all,
-     * programmatic `selectedRows = ...`).
-     *
-     * @event
-     */
     /**
      * Emitted before the tree-row expansion set changes.
      *
@@ -507,6 +497,16 @@ export interface ApexGridEventMap<T extends object> {
      * @event
      */
     rowExpanded: CustomEvent<ApexRowExpandedEvent<T>>;
+    /**
+     * Emitted before the row selection set changes.
+     *
+     * @remarks
+     * Cancellable — calling `preventDefault()` aborts the selection change.
+     * Fires for every selection-mutating call (toggle, range select, select-all,
+     * programmatic `selectedRows = ...`).
+     *
+     * @event
+     */
     rowSelecting: CustomEvent<ApexRowSelectingEvent<T>>;
     /**
      * Emitted after a row-selection change has been applied.
@@ -522,18 +522,18 @@ export interface ApexGridEventMap<T extends object> {
  * the ability to template cells and headers and column hiding.
  *
  * @remarks
- * A working, styled grid requires four setup steps:
+ * A working, styled grid requires three things:
  *  1. Register the element: `import 'apex-grid/define'` (or `ApexGrid.register()`).
- *  2. Configure an Ignite UI theme + import the matching CSS, e.g.
- *     `import { configureTheme } from 'igniteui-webcomponents';`
- *     `import 'igniteui-webcomponents/themes/light/bootstrap.css';`
- *     `configureTheme('bootstrap');`
- *  3. Give the host element a bounded height, e.g. `apex-grid { height: 480px }` —
+ *  2. Give the host element a bounded height, e.g. `apex-grid { height: 480px }` —
  *     the virtualizer collapses without one.
- *  4. Do NOT set `display` on the host — the component declares `:host { display: grid }`
+ *  3. Do NOT set `display` on the host — the component declares `:host { display: grid }`
  *     internally and any override breaks the track layout.
  *
- * See the README "Getting Started" section for the full example.
+ * The grid is styled out of the box through `--ag-*` CSS custom properties —
+ * there is no theme to import and no `configureTheme()` call. Override `--ag-*`
+ * tokens on the host (or any ancestor) to rebrand; when `igniteui-webcomponents`
+ * is present, the brand tokens auto-tint from its palette. See the README
+ * "Getting Started" and "Theming" sections for the full example and token list.
  *
  * @element apex-grid
  *
@@ -555,7 +555,32 @@ export interface ApexGridEventMap<T extends object> {
  * @fires rowEditEnded - Emitted when a row leaves edit mode (row mode only).
  * @fires rowSelecting - Cancellable. Emitted before a selection-set change is applied.
  * @fires rowSelected - Emitted after a selection-set change has been applied.
+ * @fires rowExpanding - Cancellable. Emitted before the row-expansion set changes (master-detail).
+ * @fires rowExpanded - Emitted after a row-expansion change has been applied.
+ * @fires treeRowExpanding - Cancellable. Emitted before a tree-row expansion change (tree mode).
+ * @fires treeRowExpanded - Emitted after a tree-row expansion change has been applied.
+ *
+ * @csspart live-region - Visually-hidden ARIA live region used for screen-reader announcements.
  *
+ * @cssprop [--ag-brand] - Brand color for selection, focus rings, and accents. Auto-tints from `--ig-primary-500` when igniteui is present.
+ * @cssprop [--ag-brand-strong] - Brand color for hover / pressed states.
+ * @cssprop [--ag-grid-shadow] - Grid edge/shadow override. Default is a flat 1px hairline edge; set to `var(--ag-shadow-card)` for the elevated card look, or `none` to remove it.
+ * @cssprop [--ag-surface] - Grid card background (must be opaque).
+ * @cssprop [--ag-surface-alt] - Alternating row tint.
+ * @cssprop [--ag-surface-elevated] - Header background.
+ * @cssprop [--ag-hairline] - Header / structural gridline color.
+ * @cssprop [--ag-border] - Row separator color.
+ * @cssprop [--ag-text] - Primary text color.
+ * @cssprop [--ag-text-body] - Row text color.
+ * @cssprop [--ag-text-muted] - Muted text (roles, labels).
+ * @cssprop [--ag-row-hover] - Row hover wash.
+ * @cssprop [--ag-row-h] - Row height.
+ * @cssprop [--ag-header-h] - Header height.
+ * @cssprop [--ag-radius] - Outer card corner radius.
+ * @cssprop [--ag-font] - Grid font family.
+ * @cssprop [--ag-fs-cell] - Cell font size.
+ *
+ * @see {@link https://github.com/apexcharts/apex-grid/blob/main/packages/core/src/styles/_tokens.scss | _tokens.scss} for the complete `--ag-*` token list.
  */
 export declare class ApexGrid<T extends object> extends EventEmitterBase<ApexGridEventMap<T>> {
     static get tagName(): string;
@@ -1147,11 +1172,19 @@ export declare class ApexGrid<T extends object> extends EventEmitterBase<ApexGri
     moveColumn(fromKey: Keys<T>, toKey: Keys<T>, position?: ColumnDropPosition): Promise<boolean>;
     protected bodyClickHandler(event: MouseEvent): void;
     protected bodyKeydownHandler(event: KeyboardEvent): void;
+    /**
+     * Forwards body-cell pointer interactions (press / drag-over / release) to
+     * feature modules via {@link StateController.handleCellInteraction}. Gated on
+     * there being at least one registered module so the community grid does no
+     * per-event work (it registers none). The seam a range-selection feature
+     * builds on.
+     */
+    protected bodyPointerHandler(event: PointerEvent): void;
     protected renderHeaderRow(): import("lit-html").TemplateResult<1>;
     protected renderBody(): import("lit-html").TemplateResult<1>;
-    protected renderFilterRow(): typeof nothing | import("lit-html").TemplateResult<1>;
-    protected renderToolbar(): typeof nothing | import("lit-html").TemplateResult<1>;
-    protected renderPaginator(): typeof nothing | import("lit-html").TemplateResult<1>;
+    protected renderFilterRow(): import("lit-html").TemplateResult<1> | typeof nothing;
+    protected renderToolbar(): import("lit-html").TemplateResult<1> | typeof nothing;
+    protected renderPaginator(): import("lit-html").TemplateResult<1> | typeof nothing;
     /**
      * Renders a visually-hidden polite live region. Status messages set via
      * {@link announce} land here; screen readers will read them aloud without

package/components/grid.js

@@ -196,7 +196,7 @@ export class ApexGrid extends EventEmitterBase {
         if (this.stateController?.tree?.enabled) {
             next = this.stateController.tree.process(next);
         }
-        this.dataState = next;
+        this.dataState = this.stateController ? this.stateController.applyModuleTransforms(next) : next;
         if (this.hasUpdated) {
             this.pipeline();
         }
@@ -435,6 +435,24 @@ export class ApexGrid extends EventEmitterBase {
             this.stateController.navigation.navigate(event);
         }
     }
+    bodyPointerHandler(event) {
+        if (this.stateController.modules.size === 0)
+            return;
+        const target = event.composedPath().find((el) => el instanceof ApexGridCell);
+        if (!target?.row)
+            return;
+        const kind = event.type === 'pointerdown' ? 'down' : event.type === 'pointerup' ? 'up' : 'over';
+        this.stateController.handleCellInteraction({
+            kind,
+            row: target.row.data,
+            rowIndex: target.row.index,
+            column: target.column,
+            shiftKey: event.shiftKey,
+            ctrlKey: event.ctrlKey,
+            metaKey: event.metaKey,
+            originalEvent: event,
+        });
+    }
     renderHeaderRow() {
         return html `
       <apex-grid-header-row
@@ -451,6 +469,9 @@ export class ApexGrid extends EventEmitterBase {
         .renderItem=${this.DOM.rowRenderer}
         @click=${this.bodyClickHandler}
         @keydown=${this.bodyKeydownHandler}
+        @pointerdown=${this.bodyPointerHandler}
+        @pointerover=${this.bodyPointerHandler}
+        @pointerup=${this.bodyPointerHandler}
       ></apex-virtualizer>
     `;
     }