@toolbox-web/grid 1.25.1 → 1.26.0

package/umd/plugins/selection.umd.js.map

@@ -1 +1 @@
-{"version":3,"file":"selection.umd.js","sources":["../../../../../libs/grid/src/lib/plugins/selection/range-selection.ts","../../../../../libs/grid/src/lib/plugins/selection/SelectionPlugin.ts"],"sourcesContent":["/**\n * Cell Range Selection Core Logic\n *\n * Pure functions for cell range selection operations.\n */\n\nimport type { InternalCellRange, CellRange } from './types';\n\n/**\n * Normalize a range so startRow/startCol are always <= endRow/endCol.\n * This handles cases where user drags from bottom-right to top-left.\n *\n * @param range - The range to normalize\n * @returns Normalized range with start <= end for both dimensions\n */\nexport function normalizeRange(range: InternalCellRange): InternalCellRange {\n  return {\n    startRow: Math.min(range.startRow, range.endRow),\n    startCol: Math.min(range.startCol, range.endCol),\n    endRow: Math.max(range.startRow, range.endRow),\n    endCol: Math.max(range.startCol, range.endCol),\n  };\n}\n\n/**\n * Convert an internal range to the public event format.\n *\n * @param range - The internal range to convert\n * @returns Public CellRange format with from/to coordinates\n */\nexport function toPublicRange(range: InternalCellRange): CellRange {\n  const normalized = normalizeRange(range);\n  return {\n    from: { row: normalized.startRow, col: normalized.startCol },\n    to: { row: normalized.endRow, col: normalized.endCol },\n  };\n}\n\n/**\n * Convert multiple internal ranges to public format.\n *\n * @param ranges - Array of internal ranges\n * @returns Array of public CellRange format\n */\nexport function toPublicRanges(ranges: InternalCellRange[]): CellRange[] {\n  return ranges.map(toPublicRange);\n}\n\n/**\n * Check if a cell is within a specific range.\n *\n * @param row - The row index to check\n * @param col - The column index to check\n * @param range - The range to check against\n * @returns True if the cell is within the range\n */\nexport function isCellInRange(row: number, col: number, range: InternalCellRange): boolean {\n  const normalized = normalizeRange(range);\n  return (\n    row >= normalized.startRow && row <= normalized.endRow && col >= normalized.startCol && col <= normalized.endCol\n  );\n}\n\n/**\n * Check if a cell is within any of the provided ranges.\n *\n * @param row - The row index to check\n * @param col - The column index to check\n * @param ranges - Array of ranges to check against\n * @returns True if the cell is within any range\n */\nexport function isCellInAnyRange(row: number, col: number, ranges: InternalCellRange[]): boolean {\n  return ranges.some((range) => isCellInRange(row, col, range));\n}\n\n/**\n * Get all cells within a range as an array of {row, col} objects.\n *\n * @param range - The range to enumerate\n * @returns Array of all cell coordinates in the range\n */\nexport function getCellsInRange(range: InternalCellRange): Array<{ row: number; col: number }> {\n  const cells: Array<{ row: number; col: number }> = [];\n  const normalized = normalizeRange(range);\n\n  for (let row = normalized.startRow; row <= normalized.endRow; row++) {\n    for (let col = normalized.startCol; col <= normalized.endCol; col++) {\n      cells.push({ row, col });\n    }\n  }\n\n  return cells;\n}\n\n/**\n * Get all unique cells across multiple ranges.\n * Deduplicates cells that appear in overlapping ranges.\n *\n * @param ranges - Array of ranges to enumerate\n * @returns Array of unique cell coordinates\n */\nexport function getAllCellsInRanges(ranges: InternalCellRange[]): Array<{ row: number; col: number }> {\n  const cellMap = new Map<string, { row: number; col: number }>();\n\n  for (const range of ranges) {\n    for (const cell of getCellsInRange(range)) {\n      cellMap.set(`${cell.row},${cell.col}`, cell);\n    }\n  }\n\n  return [...cellMap.values()];\n}\n\n/**\n * Merge overlapping or adjacent ranges into fewer ranges.\n * Simple implementation - returns ranges as-is for now.\n * More complex merging logic can be added later for optimization.\n *\n * @param ranges - Array of ranges to merge\n * @returns Merged array of ranges\n */\nexport function mergeRanges(ranges: InternalCellRange[]): InternalCellRange[] {\n  // Simple implementation - more complex merging can be added later\n  return ranges;\n}\n\n/**\n * Create a range from an anchor cell to a current cell position.\n * The range is not normalized - it preserves the direction of selection.\n *\n * @param anchor - The anchor cell (where selection started)\n * @param current - The current cell (where selection ends)\n * @returns An InternalCellRange from anchor to current\n */\nexport function createRangeFromAnchor(\n  anchor: { row: number; col: number },\n  current: { row: number; col: number }\n): InternalCellRange {\n  return {\n    startRow: anchor.row,\n    startCol: anchor.col,\n    endRow: current.row,\n    endCol: current.col,\n  };\n}\n\n/**\n * Calculate the number of cells in a range.\n *\n * @param range - The range to measure\n * @returns Total number of cells in the range\n */\nexport function getRangeCellCount(range: InternalCellRange): number {\n  const normalized = normalizeRange(range);\n  const rowCount = normalized.endRow - normalized.startRow + 1;\n  const colCount = normalized.endCol - normalized.startCol + 1;\n  return rowCount * colCount;\n}\n\n/**\n * Check if two ranges are equal (same boundaries).\n *\n * @param a - First range\n * @param b - Second range\n * @returns True if ranges have same boundaries after normalization\n */\nexport function rangesEqual(a: InternalCellRange, b: InternalCellRange): boolean {\n  const normA = normalizeRange(a);\n  const normB = normalizeRange(b);\n  return (\n    normA.startRow === normB.startRow &&\n    normA.startCol === normB.startCol &&\n    normA.endRow === normB.endRow &&\n    normA.endCol === normB.endCol\n  );\n}\n\n/**\n * Check if a range is a single cell (1x1).\n *\n * @param range - The range to check\n * @returns True if the range is exactly one cell\n */\nexport function isSingleCell(range: InternalCellRange): boolean {\n  const normalized = normalizeRange(range);\n  return normalized.startRow === normalized.endRow && normalized.startCol === normalized.endCol;\n}\n","/**\n * Selection Plugin (Class-based)\n *\n * Provides selection functionality for tbw-grid.\n * Supports three modes:\n * - 'cell': Single cell selection (default). No border, just focus highlight.\n * - 'row': Row selection. Clicking a cell selects the entire row.\n * - 'range': Range selection. Shift+click or drag to select rectangular cell ranges.\n */\n\nimport { clearCellFocus, getRowIndexFromCell } from '../../core/internal/utils';\nimport type { GridElement, PluginManifest, PluginQuery } from '../../core/plugin/base-plugin';\nimport { BaseGridPlugin, CellClickEvent, CellMouseEvent } from '../../core/plugin/base-plugin';\nimport { isExpanderColumn, isUtilityColumn } from '../../core/plugin/expander-column';\nimport type { ColumnConfig } from '../../core/types';\nimport {\n  createRangeFromAnchor,\n  getAllCellsInRanges,\n  isCellInAnyRange,\n  normalizeRange,\n  rangesEqual,\n  toPublicRanges,\n} from './range-selection';\nimport styles from './selection.css?inline';\nimport type {\n  CellRange,\n  InternalCellRange,\n  SelectionChangeDetail,\n  SelectionConfig,\n  SelectionMode,\n  SelectionResult,\n} from './types';\n\n/** Special field name for the selection checkbox column */\nconst CHECKBOX_COLUMN_FIELD = '__tbw_checkbox';\n\n/**\n * Build the selection change event detail for the current state.\n */\nfunction buildSelectionEvent(\n  mode: SelectionMode,\n  state: {\n    selectedCell: { row: number; col: number } | null;\n    selected: Set<number>;\n    ranges: InternalCellRange[];\n  },\n  colCount: number,\n): SelectionChangeDetail {\n  if (mode === 'cell' && state.selectedCell) {\n    return {\n      mode,\n      ranges: [\n        {\n          from: { row: state.selectedCell.row, col: state.selectedCell.col },\n          to: { row: state.selectedCell.row, col: state.selectedCell.col },\n        },\n      ],\n    };\n  }\n\n  if (mode === 'row' && state.selected.size > 0) {\n    // Sort rows and merge contiguous indices into minimal ranges\n    const sorted = [...state.selected].sort((a, b) => a - b);\n    const ranges: CellRange[] = [];\n    let start = sorted[0];\n    let end = start;\n    for (let i = 1; i < sorted.length; i++) {\n      if (sorted[i] === end + 1) {\n        end = sorted[i];\n      } else {\n        ranges.push({ from: { row: start, col: 0 }, to: { row: end, col: colCount - 1 } });\n        start = sorted[i];\n        end = start;\n      }\n    }\n    ranges.push({ from: { row: start, col: 0 }, to: { row: end, col: colCount - 1 } });\n    return { mode, ranges };\n  }\n\n  if (mode === 'range' && state.ranges.length > 0) {\n    return { mode, ranges: toPublicRanges(state.ranges) };\n  }\n\n  return { mode, ranges: [] };\n}\n\n/**\n * Selection Plugin for tbw-grid\n *\n * Adds cell, row, and range selection capabilities to the grid with full keyboard support.\n * Whether you need simple cell highlighting or complex multi-range selections, this plugin has you covered.\n *\n * ## Installation\n *\n * ```ts\n * import { SelectionPlugin } from '@toolbox-web/grid/plugins/selection';\n * ```\n *\n * ## Selection Modes\n *\n * Configure the plugin with one of three modes via {@link SelectionConfig}:\n *\n * - **`'cell'`** - Single cell selection (default). Click cells to select individually.\n * - **`'row'`** - Full row selection. Click anywhere in a row to select the entire row.\n * - **`'range'`** - Rectangular selection. Click and drag or Shift+Click to select ranges.\n *\n * ## Keyboard Shortcuts\n *\n * | Shortcut | Action |\n * |----------|--------|\n * | `Arrow Keys` | Move selection |\n * | `Shift + Arrow` | Extend selection (range mode) |\n * | `Ctrl/Cmd + Click` | Toggle selection (multi-select) |\n * | `Shift + Click` | Extend to clicked cell/row |\n * | `Ctrl/Cmd + A` | Select all (range mode) |\n * | `Escape` | Clear selection |\n *\n * > **Note:** When `multiSelect: false`, Ctrl/Shift modifiers are ignored —\n * > clicks always select a single item.\n *\n * ## CSS Custom Properties\n *\n * | Property | Description |\n * |----------|-------------|\n * | `--tbw-focus-background` | Focused row background |\n * | `--tbw-range-selection-bg` | Range selection fill |\n * | `--tbw-range-border-color` | Range selection border |\n *\n * @example Basic row selection\n * ```ts\n * grid.gridConfig = {\n *   columns: [...],\n *   plugins: [new SelectionPlugin({ mode: 'row' })],\n * };\n * ```\n *\n * @example Range selection with event handling\n * ```ts\n * grid.gridConfig = {\n *   plugins: [new SelectionPlugin({ mode: 'range' })],\n * };\n *\n * grid.on('selection-change', ({ mode, ranges }) => {\n *   console.log(`Selected ${ranges.length} ranges in ${mode} mode`);\n * });\n * ```\n *\n * @example Programmatic selection control\n * ```ts\n * const plugin = grid.getPluginByName('selection');\n *\n * // Get current selection\n * const selection = plugin.getSelection();\n * console.log(selection.ranges);\n *\n * // Set selection programmatically\n * plugin.setRanges([{ from: { row: 0, col: 0 }, to: { row: 5, col: 3 } }]);\n *\n * // Clear all selection\n * plugin.clearSelection();\n * ```\n *\n * @see {@link SelectionMode} for detailed mode descriptions\n * @see {@link SelectionConfig} for configuration options\n * @see {@link SelectionResult} for the selection result structure\n * @see [Live Demos](?path=/docs/grid-plugins-selection--docs) for interactive examples\n */\nexport class SelectionPlugin extends BaseGridPlugin<SelectionConfig> {\n  /**\n   * Plugin manifest - declares queries and configuration validation rules.\n   * @internal\n   */\n  static override readonly manifest: PluginManifest<SelectionConfig> = {\n    queries: [\n      { type: 'getSelection', description: 'Get the current selection state' },\n      { type: 'selectRows', description: 'Select specific rows by index (row mode only)' },\n      { type: 'getSelectedRowIndices', description: 'Get sorted array of selected row indices' },\n      { type: 'getSelectedRows', description: 'Get actual row objects for the current selection (works in all modes)' },\n    ],\n    configRules: [\n      {\n        id: 'selection/range-dblclick',\n        severity: 'warn',\n        message:\n          `\"triggerOn: 'dblclick'\" has no effect when mode is \"range\".\\n` +\n          `  → Range selection uses drag interaction (mousedown → mousemove), not click events.\\n` +\n          `  → The \"triggerOn\" option only affects \"cell\" and \"row\" selection modes.`,\n        check: (config) => config.mode === 'range' && config.triggerOn === 'dblclick',\n      },\n    ],\n  };\n\n  /** @internal */\n  readonly name = 'selection';\n  /** @internal */\n  override readonly styles = styles;\n\n  /** @internal */\n  protected override get defaultConfig(): Partial<SelectionConfig> {\n    return {\n      mode: 'cell',\n      triggerOn: 'click',\n      enabled: true,\n      multiSelect: true,\n    };\n  }\n\n  // #region Internal State\n  /** Row selection state (row mode) */\n  private selected = new Set<number>();\n  private lastSelected: number | null = null;\n  private anchor: number | null = null;\n\n  /** Range selection state (range mode) */\n  private ranges: InternalCellRange[] = [];\n  private activeRange: InternalCellRange | null = null;\n  private cellAnchor: { row: number; col: number } | null = null;\n  private isDragging = false;\n\n  /** Pending keyboard navigation update (processed in afterRender) */\n  private pendingKeyboardUpdate: { shiftKey: boolean } | null = null;\n\n  /** Cell selection state (cell mode) */\n  private selectedCell: { row: number; col: number } | null = null;\n\n  /** Last synced focus row — used to detect when grid focus moves so selection follows */\n  private lastSyncedFocusRow = -1;\n  /** Last synced focus col (cell mode) */\n  private lastSyncedFocusCol = -1;\n\n  /** True when selection was explicitly set (click/keyboard) — prevents #syncSelectionToFocus from overwriting */\n  private explicitSelection = false;\n\n  // #endregion\n\n  // #region Private Helpers - Selection Enabled Check\n\n  /**\n   * Check if selection is enabled at the grid level.\n   * Grid-wide `selectable: false` or plugin's `enabled: false` disables all selection.\n   */\n  private isSelectionEnabled(): boolean {\n    // Check plugin config first\n    if (this.config.enabled === false) return false;\n    // Check grid-level config\n    return this.grid.effectiveConfig?.selectable !== false;\n  }\n\n  // #endregion\n\n  // #region Private Helpers - Selectability\n\n  /**\n   * Check if a row/cell is selectable.\n   * Returns true if selectable, false if not.\n   */\n  private checkSelectable(rowIndex: number, colIndex?: number): boolean {\n    const { isSelectable } = this.config;\n    if (!isSelectable) return true; // No callback = all selectable\n\n    const row = this.rows[rowIndex];\n    if (!row) return false;\n\n    // colIndex is a visible-column index (from data-col), so use visibleColumns\n    const column = colIndex !== undefined ? this.visibleColumns[colIndex] : undefined;\n    return isSelectable(row, rowIndex, column, colIndex);\n  }\n\n  /**\n   * Check if an entire row is selectable (for row mode).\n   */\n  private isRowSelectable(rowIndex: number): boolean {\n    return this.checkSelectable(rowIndex);\n  }\n\n  /**\n   * Check if a cell is selectable (for cell/range modes).\n   */\n  private isCellSelectable(rowIndex: number, colIndex: number): boolean {\n    return this.checkSelectable(rowIndex, colIndex);\n  }\n\n  // #endregion\n\n  // #region Lifecycle\n\n  /** @internal */\n  override attach(grid: GridElement): void {\n    super.attach(grid);\n\n    // Subscribe to events that invalidate selection\n    // When rows change due to filtering/grouping/tree operations, selection indices become invalid\n    this.on('filter-applied', () => this.clearSelectionSilent());\n    this.on('grouping-state-change', () => this.clearSelectionSilent());\n    this.on('tree-state-change', () => this.clearSelectionSilent());\n  }\n\n  /**\n   * Handle queries from other plugins.\n   * @internal\n   */\n  override handleQuery(query: PluginQuery): unknown {\n    if (query.type === 'getSelection') {\n      return this.getSelection();\n    }\n    if (query.type === 'getSelectedRowIndices') {\n      return this.getSelectedRowIndices();\n    }\n    if (query.type === 'getSelectedRows') {\n      return this.getSelectedRows();\n    }\n    if (query.type === 'selectRows') {\n      this.selectRows(query.context as number[]);\n      return true;\n    }\n    return undefined;\n  }\n\n  /** @internal */\n  override detach(): void {\n    this.selected.clear();\n    this.ranges = [];\n    this.activeRange = null;\n    this.cellAnchor = null;\n    this.isDragging = false;\n    this.selectedCell = null;\n    this.pendingKeyboardUpdate = null;\n    this.lastSyncedFocusRow = -1;\n    this.lastSyncedFocusCol = -1;\n  }\n\n  /**\n   * Clear selection without emitting an event.\n   * Used when selection is invalidated by external changes (filtering, grouping, etc.)\n   */\n  private clearSelectionSilent(): void {\n    this.selected.clear();\n    this.ranges = [];\n    this.activeRange = null;\n    this.cellAnchor = null;\n    this.selectedCell = null;\n    this.lastSelected = null;\n    this.anchor = null;\n    this.lastSyncedFocusRow = -1;\n    this.lastSyncedFocusCol = -1;\n    this.requestAfterRender();\n  }\n\n  // #endregion\n\n  // #region Event Handlers\n\n  /** @internal */\n  override onCellClick(event: CellClickEvent): boolean {\n    // Skip all selection if disabled at grid level or plugin level\n    if (!this.isSelectionEnabled()) return false;\n\n    const { rowIndex, colIndex, originalEvent } = event;\n    const { mode, triggerOn = 'click' } = this.config;\n\n    // Skip if event type doesn't match configured trigger\n    // This allows dblclick mode to only select on double-click\n    if (originalEvent.type !== triggerOn) {\n      return false;\n    }\n\n    // Check if this is a utility column (expander columns, etc.)\n    // event.column is already resolved from _visibleColumns in the event builder\n    const column = event.column;\n    const isUtility = column && isUtilityColumn(column);\n\n    // CELL MODE: Single cell selection - skip utility columns and non-selectable cells\n    if (mode === 'cell') {\n      if (isUtility) {\n        return false; // Allow event to propagate, but don't select utility cells\n      }\n      if (!this.isCellSelectable(rowIndex, colIndex)) {\n        return false; // Cell is not selectable\n      }\n      // Only emit if selection actually changed\n      const currentCell = this.selectedCell;\n      if (currentCell && currentCell.row === rowIndex && currentCell.col === colIndex) {\n        return false; // Same cell already selected\n      }\n      this.selectedCell = { row: rowIndex, col: colIndex };\n      this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n      this.requestAfterRender();\n      return false;\n    }\n\n    // ROW MODE: Multi-select with Shift/Ctrl, checkbox toggle, or single select\n    if (mode === 'row') {\n      if (!this.isRowSelectable(rowIndex)) {\n        return false; // Row is not selectable\n      }\n\n      const multiSelect = this.config.multiSelect !== false;\n      const shiftKey = originalEvent.shiftKey && multiSelect;\n      const ctrlKey = (originalEvent.ctrlKey || originalEvent.metaKey) && multiSelect;\n      const isCheckbox = column?.meta?.checkboxColumn === true;\n\n      if (shiftKey && this.anchor !== null) {\n        // Shift+Click: Range select from anchor to clicked row\n        const start = Math.min(this.anchor, rowIndex);\n        const end = Math.max(this.anchor, rowIndex);\n        if (!ctrlKey) {\n          this.selected.clear();\n        }\n        for (let i = start; i <= end; i++) {\n          if (this.isRowSelectable(i)) {\n            this.selected.add(i);\n          }\n        }\n      } else if (ctrlKey || (isCheckbox && multiSelect)) {\n        // Ctrl+Click or checkbox click: Toggle individual row\n        if (this.selected.has(rowIndex)) {\n          this.selected.delete(rowIndex);\n        } else {\n          this.selected.add(rowIndex);\n        }\n        this.anchor = rowIndex;\n      } else {\n        // Plain click (or any click when multiSelect is false): select only clicked row\n        if (this.selected.size === 1 && this.selected.has(rowIndex)) {\n          return false; // Same row already selected\n        }\n        this.selected.clear();\n        this.selected.add(rowIndex);\n        this.anchor = rowIndex;\n      }\n\n      this.lastSelected = rowIndex;\n      this.explicitSelection = true;\n      this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n      this.requestAfterRender();\n      return false;\n    }\n\n    // RANGE MODE: Shift+click extends selection, click starts new\n    if (mode === 'range') {\n      // Skip utility columns in range mode - don't start selection from them\n      if (isUtility) {\n        return false;\n      }\n\n      // Skip non-selectable cells in range mode\n      if (!this.isCellSelectable(rowIndex, colIndex)) {\n        return false;\n      }\n\n      const shiftKey = originalEvent.shiftKey;\n      const ctrlKey = (originalEvent.ctrlKey || originalEvent.metaKey) && this.config.multiSelect !== false;\n\n      if (shiftKey && this.cellAnchor) {\n        // Extend selection from anchor\n        const newRange = createRangeFromAnchor(this.cellAnchor, { row: rowIndex, col: colIndex });\n\n        // Check if range actually changed\n        const currentRange = this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] : null;\n        if (currentRange && rangesEqual(currentRange, newRange)) {\n          return false; // Same range already selected\n        }\n\n        if (ctrlKey) {\n          if (this.ranges.length > 0) {\n            this.ranges[this.ranges.length - 1] = newRange;\n          } else {\n            this.ranges.push(newRange);\n          }\n        } else {\n          this.ranges = [newRange];\n        }\n        this.activeRange = newRange;\n      } else if (ctrlKey) {\n        const newRange: InternalCellRange = {\n          startRow: rowIndex,\n          startCol: colIndex,\n          endRow: rowIndex,\n          endCol: colIndex,\n        };\n        this.ranges.push(newRange);\n        this.activeRange = newRange;\n        this.cellAnchor = { row: rowIndex, col: colIndex };\n      } else {\n        // Plain click - check if same single-cell range already selected\n        const newRange: InternalCellRange = {\n          startRow: rowIndex,\n          startCol: colIndex,\n          endRow: rowIndex,\n          endCol: colIndex,\n        };\n\n        // Only emit if selection actually changed\n        if (this.ranges.length === 1 && rangesEqual(this.ranges[0], newRange)) {\n          return false; // Same cell already selected\n        }\n\n        this.ranges = [newRange];\n        this.activeRange = newRange;\n        this.cellAnchor = { row: rowIndex, col: colIndex };\n      }\n\n      this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n\n      this.requestAfterRender();\n      return false;\n    }\n\n    return false;\n  }\n\n  /** @internal */\n  override onKeyDown(event: KeyboardEvent): boolean {\n    // Skip all selection if disabled at grid level or plugin level\n    if (!this.isSelectionEnabled()) return false;\n\n    const { mode } = this.config;\n    const navKeys = ['ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight', 'Tab', 'Home', 'End', 'PageUp', 'PageDown'];\n    const isNavKey = navKeys.includes(event.key);\n\n    // Escape clears selection in all modes\n    // But if editing is active, let the EditingPlugin handle Escape first\n    if (event.key === 'Escape') {\n      const isEditing = this.grid.query<boolean>('isEditing');\n      if (isEditing.some(Boolean)) {\n        return false; // Defer to EditingPlugin to cancel the active edit\n      }\n\n      if (mode === 'cell') {\n        this.selectedCell = null;\n      } else if (mode === 'row') {\n        this.selected.clear();\n        this.anchor = null;\n      } else if (mode === 'range') {\n        this.ranges = [];\n        this.activeRange = null;\n        this.cellAnchor = null;\n      }\n      this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n      this.requestAfterRender();\n      return true;\n    }\n\n    // CELL MODE: Selection follows focus (but respects selectability)\n    if (mode === 'cell' && isNavKey) {\n      // Use queueMicrotask so grid's handler runs first and updates focusRow/focusCol\n      queueMicrotask(() => {\n        const focusRow = this.grid._focusRow;\n        const focusCol = this.grid._focusCol;\n        // Only select if the cell is selectable\n        if (this.isCellSelectable(focusRow, focusCol)) {\n          this.selectedCell = { row: focusRow, col: focusCol };\n        } else {\n          // Clear selection when navigating to non-selectable cell\n          this.selectedCell = null;\n        }\n        this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n        this.requestAfterRender();\n      });\n      return false; // Let grid handle navigation\n    }\n\n    // ROW MODE: Arrow keys move selection, Shift+Arrow extends, Ctrl+A selects all\n    if (mode === 'row') {\n      const multiSelect = this.config.multiSelect !== false;\n\n      if (event.key === 'ArrowUp' || event.key === 'ArrowDown') {\n        const shiftKey = event.shiftKey && multiSelect;\n\n        // Set anchor before grid moves focus\n        if (shiftKey && this.anchor === null) {\n          this.anchor = this.grid._focusRow;\n        }\n\n        // Let grid move focus first, then sync row selection\n        queueMicrotask(() => {\n          const focusRow = this.grid._focusRow;\n\n          if (shiftKey && this.anchor !== null) {\n            // Shift+Arrow: Extend selection from anchor\n            this.selected.clear();\n            const start = Math.min(this.anchor, focusRow);\n            const end = Math.max(this.anchor, focusRow);\n            for (let i = start; i <= end; i++) {\n              if (this.isRowSelectable(i)) {\n                this.selected.add(i);\n              }\n            }\n          } else {\n            // Plain arrow: Single select\n            if (this.isRowSelectable(focusRow)) {\n              this.selected.clear();\n              this.selected.add(focusRow);\n              this.anchor = focusRow;\n            } else {\n              this.selected.clear();\n            }\n          }\n\n          this.lastSelected = focusRow;\n          this.explicitSelection = true;\n          this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n          this.requestAfterRender();\n        });\n        return false; // Let grid handle navigation\n      }\n\n      // Ctrl+A: Select all rows (skip when editing, skip when single-select)\n      if (multiSelect && event.key === 'a' && (event.ctrlKey || event.metaKey)) {\n        const isEditing = this.grid.query<boolean>('isEditing');\n        if (isEditing.some(Boolean)) return false;\n        event.preventDefault();\n        event.stopPropagation();\n        this.selectAll();\n        return true;\n      }\n    }\n\n    // RANGE MODE: Shift+Arrow extends, plain Arrow resets\n    // Tab key always navigates without extending (even with Shift)\n    if (mode === 'range' && isNavKey) {\n      // Tab should not extend selection - it just navigates to the next/previous cell\n      const isTabKey = event.key === 'Tab';\n      const shouldExtend = event.shiftKey && !isTabKey;\n\n      // Capture anchor BEFORE grid moves focus (synchronous)\n      // This ensures the anchor is the starting point, not the destination\n      if (shouldExtend && !this.cellAnchor) {\n        this.cellAnchor = { row: this.grid._focusRow, col: this.grid._focusCol };\n      }\n\n      // Mark pending update - will be processed in afterRender when grid updates focus\n      this.pendingKeyboardUpdate = { shiftKey: shouldExtend };\n\n      // Schedule afterRender to run after grid's keyboard handler completes\n      // Grid's refreshVirtualWindow(false) skips afterRender for performance,\n      // so we explicitly request it to process pendingKeyboardUpdate\n      queueMicrotask(() => this.requestAfterRender());\n\n      return false; // Let grid handle navigation\n    }\n\n    // Ctrl+A selects all in range mode (skip when editing, skip when single-select)\n    if (\n      mode === 'range' &&\n      this.config.multiSelect !== false &&\n      event.key === 'a' &&\n      (event.ctrlKey || event.metaKey)\n    ) {\n      const isEditing = this.grid.query<boolean>('isEditing');\n      if (isEditing.some(Boolean)) return false;\n      event.preventDefault();\n      event.stopPropagation();\n      this.selectAll();\n      return true;\n    }\n\n    return false;\n  }\n\n  /** @internal */\n  override onCellMouseDown(event: CellMouseEvent): boolean | void {\n    // Skip all selection if disabled at grid level or plugin level\n    if (!this.isSelectionEnabled()) return;\n\n    if (this.config.mode !== 'range') return;\n    if (event.rowIndex === undefined || event.colIndex === undefined) return;\n    if (event.rowIndex < 0) return; // Header\n\n    // Skip utility columns (expander columns, etc.)\n    // event.column is already resolved from _visibleColumns in the event builder\n    if (event.column && isUtilityColumn(event.column)) {\n      return; // Don't start selection on utility columns\n    }\n\n    // Skip non-selectable cells - don't start drag from them\n    if (!this.isCellSelectable(event.rowIndex, event.colIndex)) {\n      return;\n    }\n\n    // Let onCellClick handle shift+click for range extension\n    if (event.originalEvent.shiftKey && this.cellAnchor) {\n      return;\n    }\n\n    // Start drag selection\n    this.isDragging = true;\n    const rowIndex = event.rowIndex;\n    const colIndex = event.colIndex;\n\n    // When multiSelect is false, Ctrl+click starts a new single range instead of adding\n    const ctrlKey = (event.originalEvent.ctrlKey || event.originalEvent.metaKey) && this.config.multiSelect !== false;\n\n    const newRange: InternalCellRange = {\n      startRow: rowIndex,\n      startCol: colIndex,\n      endRow: rowIndex,\n      endCol: colIndex,\n    };\n\n    // Check if selection is actually changing (for non-Ctrl clicks)\n    if (!ctrlKey && this.ranges.length === 1 && rangesEqual(this.ranges[0], newRange)) {\n      // Same cell already selected, just update anchor for potential drag\n      this.cellAnchor = { row: rowIndex, col: colIndex };\n      return true;\n    }\n\n    this.cellAnchor = { row: rowIndex, col: colIndex };\n\n    if (!ctrlKey) {\n      this.ranges = [];\n    }\n\n    this.ranges.push(newRange);\n    this.activeRange = newRange;\n\n    this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n    this.requestAfterRender();\n    return true;\n  }\n\n  /** @internal */\n  override onCellMouseMove(event: CellMouseEvent): boolean | void {\n    // Skip all selection if disabled at grid level or plugin level\n    if (!this.isSelectionEnabled()) return;\n\n    if (this.config.mode !== 'range') return;\n    if (!this.isDragging || !this.cellAnchor) return;\n    if (event.rowIndex === undefined || event.colIndex === undefined) return;\n    if (event.rowIndex < 0) return;\n\n    // When dragging, clamp to first data column (skip utility columns)\n    // colIndex from events is a visible-column index (from data-col)\n    let targetCol = event.colIndex;\n    const column = this.visibleColumns[targetCol];\n    if (column && isUtilityColumn(column)) {\n      // Find the first non-utility visible column\n      const firstDataCol = this.visibleColumns.findIndex((col) => !isUtilityColumn(col));\n      if (firstDataCol >= 0) {\n        targetCol = firstDataCol;\n      }\n    }\n\n    const newRange = createRangeFromAnchor(this.cellAnchor, { row: event.rowIndex, col: targetCol });\n\n    // Only update and emit if the range actually changed\n    const currentRange = this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] : null;\n    if (currentRange && rangesEqual(currentRange, newRange)) {\n      return true; // Range unchanged, no need to update\n    }\n\n    if (this.ranges.length > 0) {\n      this.ranges[this.ranges.length - 1] = newRange;\n    } else {\n      this.ranges.push(newRange);\n    }\n    this.activeRange = newRange;\n\n    this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n    this.requestAfterRender();\n    return true;\n  }\n\n  /** @internal */\n  override onCellMouseUp(_event: CellMouseEvent): boolean | void {\n    // Skip all selection if disabled at grid level or plugin level\n    if (!this.isSelectionEnabled()) return;\n\n    if (this.config.mode !== 'range') return;\n    if (this.isDragging) {\n      this.isDragging = false;\n      return true;\n    }\n  }\n\n  // #region Checkbox Column\n\n  /**\n   * Inject checkbox column when `checkbox: true` and mode is `'row'`.\n   * @internal\n   */\n  override processColumns(columns: ColumnConfig[]): ColumnConfig[] {\n    if (this.config.checkbox && this.config.mode === 'row') {\n      // Check if checkbox column already exists\n      if (columns.some((col) => col.field === CHECKBOX_COLUMN_FIELD)) {\n        return columns;\n      }\n      const checkboxCol = this.#createCheckboxColumn();\n      // Insert after expander column if present, otherwise first\n      const expanderIdx = columns.findIndex(isExpanderColumn);\n      const insertAt = expanderIdx >= 0 ? expanderIdx + 1 : 0;\n      return [...columns.slice(0, insertAt), checkboxCol, ...columns.slice(insertAt)];\n    }\n    return columns;\n  }\n\n  /**\n   * Create the checkbox utility column configuration.\n   */\n  #createCheckboxColumn(): ColumnConfig {\n    return {\n      field: CHECKBOX_COLUMN_FIELD,\n      header: '',\n      width: 32,\n      resizable: false,\n      sortable: false,\n      meta: {\n        lockPosition: true,\n        suppressMovable: true,\n        utility: true,\n        checkboxColumn: true,\n      },\n      headerRenderer: () => {\n        const container = document.createElement('div');\n        container.className = 'tbw-checkbox-header';\n        // Hide \"select all\" checkbox in single-select mode\n        if (this.config.multiSelect === false) return container;\n        const checkbox = document.createElement('input');\n        checkbox.type = 'checkbox';\n        checkbox.className = 'tbw-select-all-checkbox';\n        checkbox.addEventListener('click', (e) => {\n          e.stopPropagation(); // Prevent header sort\n          if ((e.target as HTMLInputElement).checked) {\n            this.selectAll();\n          } else {\n            this.clearSelection();\n          }\n        });\n        container.appendChild(checkbox);\n        return container;\n      },\n      renderer: (ctx) => {\n        const checkbox = document.createElement('input');\n        checkbox.type = 'checkbox';\n        checkbox.className = 'tbw-select-row-checkbox';\n        // Set initial checked state from current selection\n        const cellEl = ctx.cellEl;\n        if (cellEl) {\n          const rowIndex = parseInt(cellEl.getAttribute('data-row') ?? '-1', 10);\n          if (rowIndex >= 0) {\n            checkbox.checked = this.selected.has(rowIndex);\n          }\n        }\n        return checkbox;\n      },\n    };\n  }\n\n  /**\n   * Update checkbox checked states to reflect current selection.\n   * Called from #applySelectionClasses.\n   */\n  #updateCheckboxStates(gridEl: HTMLElement): void {\n    // Update row checkboxes\n    const rowCheckboxes = gridEl.querySelectorAll('.tbw-select-row-checkbox') as NodeListOf<HTMLInputElement>;\n    rowCheckboxes.forEach((checkbox) => {\n      const cell = checkbox.closest('.cell');\n      const rowIndex = cell ? getRowIndexFromCell(cell) : -1;\n      if (rowIndex >= 0) {\n        checkbox.checked = this.selected.has(rowIndex);\n      }\n    });\n\n    // Update header select-all checkbox\n    const headerCheckbox = gridEl.querySelector('.tbw-select-all-checkbox') as HTMLInputElement | null;\n    if (headerCheckbox) {\n      const rowCount = this.rows.length;\n      let selectableCount = 0;\n      if (this.config.isSelectable) {\n        for (let i = 0; i < rowCount; i++) {\n          if (this.isRowSelectable(i)) selectableCount++;\n        }\n      } else {\n        selectableCount = rowCount;\n      }\n      const allSelected = selectableCount > 0 && this.selected.size >= selectableCount;\n      const someSelected = this.selected.size > 0;\n      headerCheckbox.checked = allSelected;\n      headerCheckbox.indeterminate = someSelected && !allSelected;\n    }\n  }\n\n  // #endregion\n\n  /**\n   * Sync selection state to the grid's current focus position.\n   * In row mode, keeps `selected` in sync with `_focusRow`.\n   * In cell mode, keeps `selectedCell` in sync with `_focusRow`/`_focusCol`.\n   * Only updates when the focus has changed since the last sync.\n   * Skips when `explicitSelection` is set (click/keyboard set selection directly).\n   */\n  #syncSelectionToFocus(mode: string): void {\n    const focusRow = this.grid._focusRow;\n    const focusCol = this.grid._focusCol;\n\n    if (mode === 'row') {\n      // Skip auto-sync when selection was explicitly set (Shift/Ctrl click, keyboard)\n      if (this.explicitSelection) {\n        this.explicitSelection = false;\n        this.lastSyncedFocusRow = focusRow;\n        return;\n      }\n\n      if (focusRow !== this.lastSyncedFocusRow) {\n        this.lastSyncedFocusRow = focusRow;\n        if (this.isRowSelectable(focusRow)) {\n          if (!this.selected.has(focusRow) || this.selected.size !== 1) {\n            this.selected.clear();\n            this.selected.add(focusRow);\n            this.lastSelected = focusRow;\n            this.anchor = focusRow;\n            this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n          }\n        }\n      }\n    }\n\n    if (mode === 'cell') {\n      if (this.explicitSelection) {\n        this.explicitSelection = false;\n        this.lastSyncedFocusRow = focusRow;\n        this.lastSyncedFocusCol = focusCol;\n        return;\n      }\n\n      if (focusRow !== this.lastSyncedFocusRow || focusCol !== this.lastSyncedFocusCol) {\n        this.lastSyncedFocusRow = focusRow;\n        this.lastSyncedFocusCol = focusCol;\n        if (this.isCellSelectable(focusRow, focusCol)) {\n          const cur = this.selectedCell;\n          if (!cur || cur.row !== focusRow || cur.col !== focusCol) {\n            this.selectedCell = { row: focusRow, col: focusCol };\n            this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n          }\n        }\n      }\n    }\n  }\n\n  /**\n   * Apply CSS selection classes to row/cell elements.\n   * Shared by afterRender and onScrollRender.\n   */\n  #applySelectionClasses(): void {\n    const gridEl = this.gridElement;\n    if (!gridEl) return;\n\n    const { mode } = this.config;\n    const hasSelectableCallback = !!this.config.isSelectable;\n\n    // Clear all selection classes first\n    const allCells = gridEl.querySelectorAll('.cell');\n    allCells.forEach((cell) => {\n      cell.classList.remove('selected', 'top', 'bottom', 'first', 'last');\n      // Clear selectable attribute - will be re-applied below\n      if (hasSelectableCallback) {\n        cell.removeAttribute('data-selectable');\n      }\n    });\n\n    const allRows = gridEl.querySelectorAll('.data-grid-row');\n    allRows.forEach((row) => {\n      row.classList.remove('selected', 'row-focus');\n      row.setAttribute('aria-selected', 'false');\n      // Clear selectable attribute - will be re-applied below\n      if (hasSelectableCallback) {\n        row.removeAttribute('data-selectable');\n      }\n    });\n\n    // ROW MODE: Add row-focus class to selected rows, disable cell-focus, update checkboxes\n    if (mode === 'row') {\n      // In row mode, disable ALL cell-focus styling - row selection takes precedence\n      clearCellFocus(gridEl);\n\n      allRows.forEach((row) => {\n        const firstCell = row.querySelector('.cell[data-row]');\n        const rowIndex = getRowIndexFromCell(firstCell);\n        if (rowIndex >= 0) {\n          // Mark non-selectable rows\n          if (hasSelectableCallback && !this.isRowSelectable(rowIndex)) {\n            row.setAttribute('data-selectable', 'false');\n          }\n          if (this.selected.has(rowIndex)) {\n            row.classList.add('selected', 'row-focus');\n            row.setAttribute('aria-selected', 'true');\n          }\n        }\n      });\n\n      // Update checkbox states if checkbox column is enabled\n      if (this.config.checkbox) {\n        this.#updateCheckboxStates(gridEl);\n      }\n    }\n\n    // CELL/RANGE MODE: Mark non-selectable cells\n    if ((mode === 'cell' || mode === 'range') && hasSelectableCallback) {\n      const cells = gridEl.querySelectorAll('.cell[data-row][data-col]');\n      cells.forEach((cell) => {\n        const rowIndex = parseInt(cell.getAttribute('data-row') ?? '-1', 10);\n        const colIndex = parseInt(cell.getAttribute('data-col') ?? '-1', 10);\n        if (rowIndex >= 0 && colIndex >= 0) {\n          if (!this.isCellSelectable(rowIndex, colIndex)) {\n            cell.setAttribute('data-selectable', 'false');\n          }\n        }\n      });\n    }\n\n    // RANGE MODE: Add selected and edge classes to cells\n    // Uses neighbor-based edge detection for correct multi-range borders\n    if (mode === 'range' && this.ranges.length > 0) {\n      // Clear all cell-focus first - selection plugin manages focus styling in range mode\n      clearCellFocus(gridEl);\n\n      // Pre-normalize ranges for efficient neighbor checks\n      const normalizedRanges = this.ranges.map(normalizeRange);\n\n      // Fast selection check against pre-normalized ranges\n      const isInSelection = (r: number, c: number): boolean => {\n        for (const range of normalizedRanges) {\n          if (r >= range.startRow && r <= range.endRow && c >= range.startCol && c <= range.endCol) {\n            return true;\n          }\n        }\n        return false;\n      };\n\n      const cells = gridEl.querySelectorAll('.cell[data-row][data-col]');\n      cells.forEach((cell) => {\n        const rowIndex = parseInt(cell.getAttribute('data-row') ?? '-1', 10);\n        const colIndex = parseInt(cell.getAttribute('data-col') ?? '-1', 10);\n        if (rowIndex >= 0 && colIndex >= 0) {\n          // Skip utility columns entirely - don't add any selection classes\n          // colIndex from data-col is a visible-column index\n          const column = this.visibleColumns[colIndex];\n          if (column && isUtilityColumn(column)) {\n            return;\n          }\n\n          if (isInSelection(rowIndex, colIndex)) {\n            cell.classList.add('selected');\n            cell.setAttribute('aria-selected', 'true');\n\n            // Edge detection: add border class where neighbor is not selected\n            // This handles single ranges, multi-range, and irregular selections correctly\n            if (!isInSelection(rowIndex - 1, colIndex)) cell.classList.add('top');\n            if (!isInSelection(rowIndex + 1, colIndex)) cell.classList.add('bottom');\n            if (!isInSelection(rowIndex, colIndex - 1)) cell.classList.add('first');\n            if (!isInSelection(rowIndex, colIndex + 1)) cell.classList.add('last');\n          }\n        }\n      });\n    }\n\n    // CELL MODE: Let the grid's native .cell-focus styling handle cell highlighting\n    // No additional action needed - the grid already manages focus styling\n  }\n\n  /** @internal */\n  override afterRender(): void {\n    // Skip rendering selection if disabled at grid level or plugin level\n    if (!this.isSelectionEnabled()) return;\n\n    const gridEl = this.gridElement;\n    if (!gridEl) return;\n\n    const container = gridEl.children[0];\n    const { mode } = this.config;\n\n    // Process pending keyboard navigation update (range mode)\n    // This runs AFTER the grid has updated focusRow/focusCol\n    if (this.pendingKeyboardUpdate && mode === 'range') {\n      const { shiftKey } = this.pendingKeyboardUpdate;\n      this.pendingKeyboardUpdate = null;\n\n      const currentRow = this.grid._focusRow;\n      const currentCol = this.grid._focusCol;\n\n      if (shiftKey && this.cellAnchor) {\n        // Extend selection from anchor to current focus\n        const newRange = createRangeFromAnchor(this.cellAnchor, { row: currentRow, col: currentCol });\n        this.ranges = [newRange];\n        this.activeRange = newRange;\n      } else if (!shiftKey) {\n        // Without shift, clear selection (cell-focus will show instead)\n        this.ranges = [];\n        this.activeRange = null;\n        this.cellAnchor = { row: currentRow, col: currentCol }; // Reset anchor to current position\n      }\n\n      this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n    }\n\n    // Sync selection to grid's focus position.\n    // This ensures selection follows keyboard navigation (Tab, arrows, etc.)\n    // regardless of which plugin moved the focus.\n    this.#syncSelectionToFocus(mode);\n\n    // Set data attribute on host for CSS variable scoping\n    this.gridElement.setAttribute('data-selection-mode', mode);\n\n    // Toggle .selecting class during drag to prevent text selection\n    if (container) {\n      container.classList.toggle('selecting', this.isDragging);\n    }\n\n    this.#applySelectionClasses();\n  }\n\n  /**\n   * Called after scroll-triggered row rendering.\n   * Reapplies selection classes to recycled DOM elements.\n   * @internal\n   */\n  override onScrollRender(): void {\n    // Skip rendering selection classes if disabled\n    if (!this.isSelectionEnabled()) return;\n\n    this.#applySelectionClasses();\n  }\n\n  // #endregion\n\n  // #region Public API\n\n  /**\n   * Get the current selection as a unified result.\n   * Works for all selection modes and always returns ranges.\n   *\n   * @example\n   * ```ts\n   * const selection = plugin.getSelection();\n   * if (selection.ranges.length > 0) {\n   *   const { from, to } = selection.ranges[0];\n   *   // For cell mode: from === to (single cell)\n   *   // For row mode: from.col = 0, to.col = lastCol (full row)\n   *   // For range mode: rectangular selection\n   * }\n   * ```\n   */\n  getSelection(): SelectionResult {\n    return {\n      mode: this.config.mode,\n      ranges: this.#buildEvent().ranges,\n      anchor: this.cellAnchor,\n    };\n  }\n\n  /**\n   * Get all selected cells across all ranges.\n   */\n  getSelectedCells(): Array<{ row: number; col: number }> {\n    return getAllCellsInRanges(this.ranges);\n  }\n\n  /**\n   * Check if a specific cell is in range selection.\n   */\n  isCellSelected(row: number, col: number): boolean {\n    return isCellInAnyRange(row, col, this.ranges);\n  }\n\n  /**\n   * Select all selectable rows (row mode) or all cells (range mode).\n   *\n   * In row mode, selects every row where `isSelectable` returns true (or all rows if no callback).\n   * In range mode, creates a single range spanning all rows and columns.\n   * Has no effect in cell mode.\n   *\n   * @example\n   * ```ts\n   * const plugin = grid.getPluginByName('selection');\n   * plugin.selectAll(); // Selects everything in current mode\n   * ```\n   */\n  selectAll(): void {\n    const { mode, multiSelect } = this.config;\n\n    // Single-select mode: selectAll is a no-op\n    if (multiSelect === false) return;\n\n    if (mode === 'row') {\n      this.selected.clear();\n      for (let i = 0; i < this.rows.length; i++) {\n        if (this.isRowSelectable(i)) {\n          this.selected.add(i);\n        }\n      }\n      this.explicitSelection = true;\n      this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n      this.requestAfterRender();\n    } else if (mode === 'range') {\n      const rowCount = this.rows.length;\n      const colCount = this.columns.length;\n      if (rowCount > 0 && colCount > 0) {\n        const allRange: InternalCellRange = {\n          startRow: 0,\n          startCol: 0,\n          endRow: rowCount - 1,\n          endCol: colCount - 1,\n        };\n        this.ranges = [allRange];\n        this.activeRange = allRange;\n        this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n        this.requestAfterRender();\n      }\n    }\n  }\n\n  /**\n   * Select specific rows by index (row mode only).\n   * Replaces the current selection with the provided row indices.\n   * Indices that are out of bounds or fail the `isSelectable` check are ignored.\n   *\n   * @param indices - Array of row indices to select\n   *\n   * @example\n   * ```ts\n   * const plugin = grid.getPluginByName('selection');\n   * plugin.selectRows([0, 2, 4]); // Select rows 0, 2, and 4\n   * ```\n   */\n  selectRows(indices: number[]): void {\n    if (this.config.mode !== 'row') return;\n    // In single-select mode, only use the last index\n    const effectiveIndices =\n      this.config.multiSelect === false && indices.length > 1 ? [indices[indices.length - 1]] : indices;\n    this.selected.clear();\n    for (const idx of effectiveIndices) {\n      if (idx >= 0 && idx < this.rows.length && this.isRowSelectable(idx)) {\n        this.selected.add(idx);\n      }\n    }\n    this.anchor = effectiveIndices.length > 0 ? effectiveIndices[effectiveIndices.length - 1] : null;\n    this.explicitSelection = true;\n    this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n    this.requestAfterRender();\n  }\n\n  /**\n   * Get the indices of all selected rows (convenience for row mode).\n   * Returns indices sorted in ascending order.\n   *\n   * @example\n   * ```ts\n   * const plugin = grid.getPluginByName('selection');\n   * const rows = plugin.getSelectedRowIndices(); // [0, 2, 4]\n   * ```\n   */\n  getSelectedRowIndices(): number[] {\n    return [...this.selected].sort((a, b) => a - b);\n  }\n\n  /**\n   * Get the actual row objects for the current selection.\n   *\n   * Works across all selection modes:\n   * - **Row mode**: Returns the row objects for all selected rows.\n   * - **Cell mode**: Returns the single row containing the selected cell, or `[]`.\n   * - **Range mode**: Returns the unique row objects that intersect any selected range.\n   *\n   * Row objects are resolved from the grid's processed (sorted/filtered) row array,\n   * so they always reflect the current visual order.\n   *\n   * @example\n   * ```ts\n   * const plugin = grid.getPluginByName('selection');\n   * const selected = plugin.getSelectedRows(); // [{ id: 1, name: 'Alice' }, ...]\n   * ```\n   */\n  getSelectedRows<T = unknown>(): T[] {\n    const { mode } = this.config;\n    const rows = this.rows;\n\n    if (mode === 'row') {\n      return this.getSelectedRowIndices()\n        .filter((i) => i >= 0 && i < rows.length)\n        .map((i) => rows[i]) as T[];\n    }\n\n    if (mode === 'cell' && this.selectedCell) {\n      const { row } = this.selectedCell;\n      return row >= 0 && row < rows.length ? [rows[row] as T] : [];\n    }\n\n    if (mode === 'range' && this.ranges.length > 0) {\n      // Collect unique row indices across all ranges\n      const rowIndices = new Set<number>();\n      for (const range of this.ranges) {\n        const minRow = Math.max(0, Math.min(range.startRow, range.endRow));\n        const maxRow = Math.min(rows.length - 1, Math.max(range.startRow, range.endRow));\n        for (let r = minRow; r <= maxRow; r++) {\n          rowIndices.add(r);\n        }\n      }\n      return [...rowIndices].sort((a, b) => a - b).map((i) => rows[i]) as T[];\n    }\n\n    return [];\n  }\n\n  /**\n   * Clear all selection.\n   */\n  clearSelection(): void {\n    this.selectedCell = null;\n    this.selected.clear();\n    this.anchor = null;\n    this.ranges = [];\n    this.activeRange = null;\n    this.cellAnchor = null;\n    this.emit<SelectionChangeDetail>('selection-change', { mode: this.config.mode, ranges: [] });\n    this.requestAfterRender();\n  }\n\n  /**\n   * Set selected ranges programmatically.\n   */\n  setRanges(ranges: CellRange[]): void {\n    this.ranges = ranges.map((r) => ({\n      startRow: r.from.row,\n      startCol: r.from.col,\n      endRow: r.to.row,\n      endCol: r.to.col,\n    }));\n    this.activeRange = this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] : null;\n    this.emit<SelectionChangeDetail>('selection-change', {\n      mode: this.config.mode,\n      ranges: toPublicRanges(this.ranges),\n    });\n    this.requestAfterRender();\n  }\n\n  // #endregion\n\n  // #region Private Helpers\n\n  #buildEvent(): SelectionChangeDetail {\n    return buildSelectionEvent(\n      this.config.mode,\n      {\n        selectedCell: this.selectedCell,\n        selected: this.selected,\n        ranges: this.ranges,\n      },\n      this.columns.length,\n    );\n  }\n\n  // #endregion\n}\n"],"names":["normalizeRange","range","startRow","Math","min","endRow","startCol","endCol","max","toPublicRange","normalized","from","row","col","to","toPublicRanges","ranges","map","isCellInAnyRange","some","isCellInRange","getCellsInRange","cells","push","createRangeFromAnchor","anchor","current","rangesEqual","a","b","normA","normB","CHECKBOX_COLUMN_FIELD","SelectionPlugin","BaseGridPlugin","static","queries","type","description","configRules","id","severity","message","check","config","mode","triggerOn","name","styles","defaultConfig","enabled","multiSelect","selected","Set","lastSelected","activeRange","cellAnchor","isDragging","pendingKeyboardUpdate","selectedCell","lastSyncedFocusRow","lastSyncedFocusCol","explicitSelection","isSelectionEnabled","this","grid","effectiveConfig","selectable","checkSelectable","rowIndex","colIndex","isSelectable","rows","visibleColumns","isRowSelectable","isCellSelectable","attach","super","on","clearSelectionSilent","handleQuery","query","getSelection","getSelectedRowIndices","getSelectedRows","selectRows","context","detach","clear","requestAfterRender","onCellClick","event","originalEvent","column","isUtility","isUtilityColumn","currentCell","emit","buildEvent","shiftKey","ctrlKey","metaKey","isCheckbox","meta","checkboxColumn","start","end","i","add","has","delete","size","newRange","currentRange","length","onKeyDown","isNavKey","includes","key","Boolean","queueMicrotask","focusRow","_focusRow","focusCol","_focusCol","preventDefault","stopPropagation","selectAll","isTabKey","shouldExtend","onCellMouseDown","onCellMouseMove","targetCol","firstDataCol","findIndex","onCellMouseUp","_event","processColumns","columns","checkbox","field","checkboxCol","createCheckboxColumn","expanderIdx","isExpanderColumn","insertAt","slice","header","width","resizable","sortable","lockPosition","suppressMovable","utility","headerRenderer","container","document","createElement","className","addEventListener","e","target","checked","clearSelection","appendChild","renderer","ctx","cellEl","parseInt","getAttribute","updateCheckboxStates","gridEl","querySelectorAll","forEach","cell","closest","getRowIndexFromCell","headerCheckbox","querySelector","rowCount","selectableCount","allSelected","someSelected","indeterminate","syncSelectionToFocus","cur","applySelectionClasses","gridElement","hasSelectableCallback","classList","remove","removeAttribute","allRows","setAttribute","clearCellFocus","firstCell","normalizedRanges","isInSelection","r","c","afterRender","children","currentRow","currentCol","toggle","onScrollRender","getSelectedCells","cellMap","Map","set","values","getAllCellsInRanges","isCellSelected","colCount","allRange","indices","effectiveIndices","idx","sort","filter","rowIndices","minRow","maxRow","setRanges","state","sorted","buildSelectionEvent"],"mappings":"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"}
+{"version":3,"file":"selection.umd.js","sources":["../../../../../libs/grid/src/lib/plugins/selection/range-selection.ts","../../../../../libs/grid/src/lib/plugins/selection/SelectionPlugin.ts"],"sourcesContent":["/**\n * Cell Range Selection Core Logic\n *\n * Pure functions for cell range selection operations.\n */\n\nimport type { InternalCellRange, CellRange } from './types';\n\n/**\n * Normalize a range so startRow/startCol are always <= endRow/endCol.\n * This handles cases where user drags from bottom-right to top-left.\n *\n * @param range - The range to normalize\n * @returns Normalized range with start <= end for both dimensions\n */\nexport function normalizeRange(range: InternalCellRange): InternalCellRange {\n  return {\n    startRow: Math.min(range.startRow, range.endRow),\n    startCol: Math.min(range.startCol, range.endCol),\n    endRow: Math.max(range.startRow, range.endRow),\n    endCol: Math.max(range.startCol, range.endCol),\n  };\n}\n\n/**\n * Convert an internal range to the public event format.\n *\n * @param range - The internal range to convert\n * @returns Public CellRange format with from/to coordinates\n */\nexport function toPublicRange(range: InternalCellRange): CellRange {\n  const normalized = normalizeRange(range);\n  return {\n    from: { row: normalized.startRow, col: normalized.startCol },\n    to: { row: normalized.endRow, col: normalized.endCol },\n  };\n}\n\n/**\n * Convert multiple internal ranges to public format.\n *\n * @param ranges - Array of internal ranges\n * @returns Array of public CellRange format\n */\nexport function toPublicRanges(ranges: InternalCellRange[]): CellRange[] {\n  return ranges.map(toPublicRange);\n}\n\n/**\n * Check if a cell is within a specific range.\n *\n * @param row - The row index to check\n * @param col - The column index to check\n * @param range - The range to check against\n * @returns True if the cell is within the range\n */\nexport function isCellInRange(row: number, col: number, range: InternalCellRange): boolean {\n  const normalized = normalizeRange(range);\n  return (\n    row >= normalized.startRow && row <= normalized.endRow && col >= normalized.startCol && col <= normalized.endCol\n  );\n}\n\n/**\n * Check if a cell is within any of the provided ranges.\n *\n * @param row - The row index to check\n * @param col - The column index to check\n * @param ranges - Array of ranges to check against\n * @returns True if the cell is within any range\n */\nexport function isCellInAnyRange(row: number, col: number, ranges: InternalCellRange[]): boolean {\n  return ranges.some((range) => isCellInRange(row, col, range));\n}\n\n/**\n * Get all cells within a range as an array of {row, col} objects.\n *\n * @param range - The range to enumerate\n * @returns Array of all cell coordinates in the range\n */\nexport function getCellsInRange(range: InternalCellRange): Array<{ row: number; col: number }> {\n  const cells: Array<{ row: number; col: number }> = [];\n  const normalized = normalizeRange(range);\n\n  for (let row = normalized.startRow; row <= normalized.endRow; row++) {\n    for (let col = normalized.startCol; col <= normalized.endCol; col++) {\n      cells.push({ row, col });\n    }\n  }\n\n  return cells;\n}\n\n/**\n * Get all unique cells across multiple ranges.\n * Deduplicates cells that appear in overlapping ranges.\n *\n * @param ranges - Array of ranges to enumerate\n * @returns Array of unique cell coordinates\n */\nexport function getAllCellsInRanges(ranges: InternalCellRange[]): Array<{ row: number; col: number }> {\n  const cellMap = new Map<string, { row: number; col: number }>();\n\n  for (const range of ranges) {\n    for (const cell of getCellsInRange(range)) {\n      cellMap.set(`${cell.row},${cell.col}`, cell);\n    }\n  }\n\n  return [...cellMap.values()];\n}\n\n/**\n * Merge overlapping or adjacent ranges into fewer ranges.\n * Simple implementation - returns ranges as-is for now.\n * More complex merging logic can be added later for optimization.\n *\n * @param ranges - Array of ranges to merge\n * @returns Merged array of ranges\n */\nexport function mergeRanges(ranges: InternalCellRange[]): InternalCellRange[] {\n  // Simple implementation - more complex merging can be added later\n  return ranges;\n}\n\n/**\n * Create a range from an anchor cell to a current cell position.\n * The range is not normalized - it preserves the direction of selection.\n *\n * @param anchor - The anchor cell (where selection started)\n * @param current - The current cell (where selection ends)\n * @returns An InternalCellRange from anchor to current\n */\nexport function createRangeFromAnchor(\n  anchor: { row: number; col: number },\n  current: { row: number; col: number }\n): InternalCellRange {\n  return {\n    startRow: anchor.row,\n    startCol: anchor.col,\n    endRow: current.row,\n    endCol: current.col,\n  };\n}\n\n/**\n * Calculate the number of cells in a range.\n *\n * @param range - The range to measure\n * @returns Total number of cells in the range\n */\nexport function getRangeCellCount(range: InternalCellRange): number {\n  const normalized = normalizeRange(range);\n  const rowCount = normalized.endRow - normalized.startRow + 1;\n  const colCount = normalized.endCol - normalized.startCol + 1;\n  return rowCount * colCount;\n}\n\n/**\n * Check if two ranges are equal (same boundaries).\n *\n * @param a - First range\n * @param b - Second range\n * @returns True if ranges have same boundaries after normalization\n */\nexport function rangesEqual(a: InternalCellRange, b: InternalCellRange): boolean {\n  const normA = normalizeRange(a);\n  const normB = normalizeRange(b);\n  return (\n    normA.startRow === normB.startRow &&\n    normA.startCol === normB.startCol &&\n    normA.endRow === normB.endRow &&\n    normA.endCol === normB.endCol\n  );\n}\n\n/**\n * Check if a range is a single cell (1x1).\n *\n * @param range - The range to check\n * @returns True if the range is exactly one cell\n */\nexport function isSingleCell(range: InternalCellRange): boolean {\n  const normalized = normalizeRange(range);\n  return normalized.startRow === normalized.endRow && normalized.startCol === normalized.endCol;\n}\n","/**\n * Selection Plugin (Class-based)\n *\n * Provides selection functionality for tbw-grid.\n * Supports three modes:\n * - 'cell': Single cell selection (default). No border, just focus highlight.\n * - 'row': Row selection. Clicking a cell selects the entire row.\n * - 'range': Range selection. Shift+click or drag to select rectangular cell ranges.\n */\n\nimport { clearCellFocus, getRowIndexFromCell } from '../../core/internal/utils';\nimport type { GridElement, PluginManifest, PluginQuery } from '../../core/plugin/base-plugin';\nimport { BaseGridPlugin, CellClickEvent, CellMouseEvent } from '../../core/plugin/base-plugin';\nimport { isExpanderColumn, isUtilityColumn } from '../../core/plugin/expander-column';\nimport type { ColumnConfig } from '../../core/types';\nimport {\n  createRangeFromAnchor,\n  getAllCellsInRanges,\n  isCellInAnyRange,\n  normalizeRange,\n  rangesEqual,\n  toPublicRanges,\n} from './range-selection';\nimport styles from './selection.css?inline';\nimport type {\n  CellRange,\n  InternalCellRange,\n  SelectionChangeDetail,\n  SelectionConfig,\n  SelectionMode,\n  SelectionResult,\n} from './types';\n\n/** Special field name for the selection checkbox column */\nconst CHECKBOX_COLUMN_FIELD = '__tbw_checkbox';\n\n/**\n * Build the selection change event detail for the current state.\n */\nfunction buildSelectionEvent(\n  mode: SelectionMode,\n  state: {\n    selectedCell: { row: number; col: number } | null;\n    selected: Set<number>;\n    ranges: InternalCellRange[];\n  },\n  colCount: number,\n): SelectionChangeDetail {\n  if (mode === 'cell' && state.selectedCell) {\n    return {\n      mode,\n      ranges: [\n        {\n          from: { row: state.selectedCell.row, col: state.selectedCell.col },\n          to: { row: state.selectedCell.row, col: state.selectedCell.col },\n        },\n      ],\n    };\n  }\n\n  if (mode === 'row' && state.selected.size > 0) {\n    // Sort rows and merge contiguous indices into minimal ranges\n    const sorted = [...state.selected].sort((a, b) => a - b);\n    const ranges: CellRange[] = [];\n    let start = sorted[0];\n    let end = start;\n    for (let i = 1; i < sorted.length; i++) {\n      if (sorted[i] === end + 1) {\n        end = sorted[i];\n      } else {\n        ranges.push({ from: { row: start, col: 0 }, to: { row: end, col: colCount - 1 } });\n        start = sorted[i];\n        end = start;\n      }\n    }\n    ranges.push({ from: { row: start, col: 0 }, to: { row: end, col: colCount - 1 } });\n    return { mode, ranges };\n  }\n\n  if (mode === 'range' && state.ranges.length > 0) {\n    return { mode, ranges: toPublicRanges(state.ranges) };\n  }\n\n  return { mode, ranges: [] };\n}\n\n/**\n * Selection Plugin for tbw-grid\n *\n * Adds cell, row, and range selection capabilities to the grid with full keyboard support.\n * Whether you need simple cell highlighting or complex multi-range selections, this plugin has you covered.\n *\n * ## Installation\n *\n * ```ts\n * import { SelectionPlugin } from '@toolbox-web/grid/plugins/selection';\n * ```\n *\n * ## Selection Modes\n *\n * Configure the plugin with one of three modes via {@link SelectionConfig}:\n *\n * - **`'cell'`** - Single cell selection (default). Click cells to select individually.\n * - **`'row'`** - Full row selection. Click anywhere in a row to select the entire row.\n * - **`'range'`** - Rectangular selection. Click and drag or Shift+Click to select ranges.\n *\n * ## Keyboard Shortcuts\n *\n * | Shortcut | Action |\n * |----------|--------|\n * | `Arrow Keys` | Move selection |\n * | `Shift + Arrow` | Extend selection (range mode) |\n * | `Ctrl/Cmd + Click` | Toggle selection (multi-select) |\n * | `Shift + Click` | Extend to clicked cell/row |\n * | `Ctrl/Cmd + A` | Select all (range mode) |\n * | `Escape` | Clear selection |\n *\n * > **Note:** When `multiSelect: false`, Ctrl/Shift modifiers are ignored —\n * > clicks always select a single item.\n *\n * ## CSS Custom Properties\n *\n * | Property | Description |\n * |----------|-------------|\n * | `--tbw-focus-background` | Focused row background |\n * | `--tbw-range-selection-bg` | Range selection fill |\n * | `--tbw-range-border-color` | Range selection border |\n *\n * @example Basic row selection\n * ```ts\n * grid.gridConfig = {\n *   columns: [...],\n *   plugins: [new SelectionPlugin({ mode: 'row' })],\n * };\n * ```\n *\n * @example Range selection with event handling\n * ```ts\n * grid.gridConfig = {\n *   plugins: [new SelectionPlugin({ mode: 'range' })],\n * };\n *\n * grid.on('selection-change', ({ mode, ranges }) => {\n *   console.log(`Selected ${ranges.length} ranges in ${mode} mode`);\n * });\n * ```\n *\n * @example Programmatic selection control\n * ```ts\n * const plugin = grid.getPluginByName('selection');\n *\n * // Get current selection\n * const selection = plugin.getSelection();\n * console.log(selection.ranges);\n *\n * // Set selection programmatically\n * plugin.setRanges([{ from: { row: 0, col: 0 }, to: { row: 5, col: 3 } }]);\n *\n * // Clear all selection\n * plugin.clearSelection();\n * ```\n *\n * @see {@link SelectionMode} for detailed mode descriptions\n * @see {@link SelectionConfig} for configuration options\n * @see {@link SelectionResult} for the selection result structure\n * @see [Live Demos](?path=/docs/grid-plugins-selection--docs) for interactive examples\n */\nexport class SelectionPlugin extends BaseGridPlugin<SelectionConfig> {\n  /**\n   * Plugin manifest - declares queries and configuration validation rules.\n   * @internal\n   */\n  static override readonly manifest: PluginManifest<SelectionConfig> = {\n    queries: [\n      { type: 'getSelection', description: 'Get the current selection state' },\n      { type: 'selectRows', description: 'Select specific rows by index (row mode only)' },\n      { type: 'getSelectedRowIndices', description: 'Get sorted array of selected row indices' },\n      { type: 'getSelectedRows', description: 'Get actual row objects for the current selection (works in all modes)' },\n    ],\n    configRules: [\n      {\n        id: 'selection/range-dblclick',\n        severity: 'warn',\n        message:\n          `\"triggerOn: 'dblclick'\" has no effect when mode is \"range\".\\n` +\n          `  → Range selection uses drag interaction (mousedown → mousemove), not click events.\\n` +\n          `  → The \"triggerOn\" option only affects \"cell\" and \"row\" selection modes.`,\n        check: (config) => config.mode === 'range' && config.triggerOn === 'dblclick',\n      },\n    ],\n  };\n\n  /** @internal */\n  readonly name = 'selection';\n  /** @internal */\n  override readonly styles = styles;\n\n  /** @internal */\n  protected override get defaultConfig(): Partial<SelectionConfig> {\n    return {\n      mode: 'cell',\n      triggerOn: 'click',\n      enabled: true,\n      multiSelect: true,\n    };\n  }\n\n  // #region Internal State\n  /** Row selection state (row mode) */\n  private selected = new Set<number>();\n  private lastSelected: number | null = null;\n  private anchor: number | null = null;\n\n  /** Range selection state (range mode) */\n  private ranges: InternalCellRange[] = [];\n  private activeRange: InternalCellRange | null = null;\n  private cellAnchor: { row: number; col: number } | null = null;\n  private isDragging = false;\n\n  /** Pending keyboard navigation update (processed in afterRender) */\n  private pendingKeyboardUpdate: { shiftKey: boolean } | null = null;\n\n  /** Pending row-mode keyboard update (processed in afterRender) */\n  private pendingRowKeyUpdate: { shiftKey: boolean } | null = null;\n\n  /** Cell selection state (cell mode) */\n  private selectedCell: { row: number; col: number } | null = null;\n\n  /** Last synced focus row — used to detect when grid focus moves so selection follows */\n  private lastSyncedFocusRow = -1;\n  /** Last synced focus col (cell mode) */\n  private lastSyncedFocusCol = -1;\n\n  /** True when selection was explicitly set (click/keyboard) — prevents #syncSelectionToFocus from overwriting */\n  private explicitSelection = false;\n\n  // #endregion\n\n  // #region Private Helpers - Selection Enabled Check\n\n  /**\n   * Check if selection is enabled at the grid level.\n   * Grid-wide `selectable: false` or plugin's `enabled: false` disables all selection.\n   */\n  private isSelectionEnabled(): boolean {\n    // Check plugin config first\n    if (this.config.enabled === false) return false;\n    // Check grid-level config\n    return this.grid.effectiveConfig?.selectable !== false;\n  }\n\n  // #endregion\n\n  // #region Private Helpers - Selectability\n\n  /**\n   * Check if a row/cell is selectable.\n   * Returns true if selectable, false if not.\n   */\n  private checkSelectable(rowIndex: number, colIndex?: number): boolean {\n    const { isSelectable } = this.config;\n    if (!isSelectable) return true; // No callback = all selectable\n\n    const row = this.rows[rowIndex];\n    if (!row) return false;\n\n    // colIndex is a visible-column index (from data-col), so use visibleColumns\n    const column = colIndex !== undefined ? this.visibleColumns[colIndex] : undefined;\n    return isSelectable(row, rowIndex, column, colIndex);\n  }\n\n  /**\n   * Check if an entire row is selectable (for row mode).\n   */\n  private isRowSelectable(rowIndex: number): boolean {\n    return this.checkSelectable(rowIndex);\n  }\n\n  /**\n   * Check if a cell is selectable (for cell/range modes).\n   */\n  private isCellSelectable(rowIndex: number, colIndex: number): boolean {\n    return this.checkSelectable(rowIndex, colIndex);\n  }\n\n  // #endregion\n\n  // #region Lifecycle\n\n  /** @internal */\n  override attach(grid: GridElement): void {\n    super.attach(grid);\n\n    // Subscribe to events that invalidate selection\n    // When rows change due to filtering/grouping/tree operations, selection indices become invalid\n    this.on('filter-applied', () => this.clearSelectionSilent());\n    this.on('grouping-state-change', () => this.clearSelectionSilent());\n    this.on('tree-state-change', () => this.clearSelectionSilent());\n  }\n\n  /**\n   * Handle queries from other plugins.\n   * @internal\n   */\n  override handleQuery(query: PluginQuery): unknown {\n    if (query.type === 'getSelection') {\n      return this.getSelection();\n    }\n    if (query.type === 'getSelectedRowIndices') {\n      return this.getSelectedRowIndices();\n    }\n    if (query.type === 'getSelectedRows') {\n      return this.getSelectedRows();\n    }\n    if (query.type === 'selectRows') {\n      this.selectRows(query.context as number[]);\n      return true;\n    }\n    return undefined;\n  }\n\n  /** @internal */\n  override detach(): void {\n    this.selected.clear();\n    this.ranges = [];\n    this.activeRange = null;\n    this.cellAnchor = null;\n    this.isDragging = false;\n    this.selectedCell = null;\n    this.pendingKeyboardUpdate = null;\n    this.pendingRowKeyUpdate = null;\n    this.lastSyncedFocusRow = -1;\n    this.lastSyncedFocusCol = -1;\n  }\n\n  /**\n   * Clear selection without emitting an event.\n   * Used when selection is invalidated by external changes (filtering, grouping, etc.)\n   */\n  private clearSelectionSilent(): void {\n    this.selected.clear();\n    this.ranges = [];\n    this.activeRange = null;\n    this.cellAnchor = null;\n    this.selectedCell = null;\n    this.lastSelected = null;\n    this.anchor = null;\n    this.lastSyncedFocusRow = -1;\n    this.lastSyncedFocusCol = -1;\n    this.requestAfterRender();\n  }\n\n  // #endregion\n\n  // #region Event Handlers\n\n  /** @internal */\n  override onCellClick(event: CellClickEvent): boolean {\n    // Skip all selection if disabled at grid level or plugin level\n    if (!this.isSelectionEnabled()) return false;\n\n    const { rowIndex, colIndex, originalEvent } = event;\n    const { mode, triggerOn = 'click' } = this.config;\n\n    // Skip if event type doesn't match configured trigger\n    // This allows dblclick mode to only select on double-click\n    if (originalEvent.type !== triggerOn) {\n      return false;\n    }\n\n    // Check if this is a utility column (expander columns, etc.)\n    // event.column is already resolved from _visibleColumns in the event builder\n    const column = event.column;\n    const isUtility = column && isUtilityColumn(column);\n\n    // CELL MODE: Single cell selection - skip utility columns and non-selectable cells\n    if (mode === 'cell') {\n      if (isUtility) {\n        return false; // Allow event to propagate, but don't select utility cells\n      }\n      if (!this.isCellSelectable(rowIndex, colIndex)) {\n        return false; // Cell is not selectable\n      }\n      // Only emit if selection actually changed\n      const currentCell = this.selectedCell;\n      if (currentCell && currentCell.row === rowIndex && currentCell.col === colIndex) {\n        return false; // Same cell already selected\n      }\n      this.selectedCell = { row: rowIndex, col: colIndex };\n      this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n      this.requestAfterRender();\n      return false;\n    }\n\n    // ROW MODE: Multi-select with Shift/Ctrl, checkbox toggle, or single select\n    if (mode === 'row') {\n      if (!this.isRowSelectable(rowIndex)) {\n        return false; // Row is not selectable\n      }\n\n      const multiSelect = this.config.multiSelect !== false;\n      const shiftKey = originalEvent.shiftKey && multiSelect;\n      const ctrlKey = (originalEvent.ctrlKey || originalEvent.metaKey) && multiSelect;\n      const isCheckbox = column?.meta?.checkboxColumn === true;\n\n      if (shiftKey && this.anchor !== null) {\n        // Shift+Click: Range select from anchor to clicked row\n        const start = Math.min(this.anchor, rowIndex);\n        const end = Math.max(this.anchor, rowIndex);\n        if (!ctrlKey) {\n          this.selected.clear();\n        }\n        for (let i = start; i <= end; i++) {\n          if (this.isRowSelectable(i)) {\n            this.selected.add(i);\n          }\n        }\n      } else if (ctrlKey || (isCheckbox && multiSelect)) {\n        // Ctrl+Click or checkbox click: Toggle individual row\n        if (this.selected.has(rowIndex)) {\n          this.selected.delete(rowIndex);\n        } else {\n          this.selected.add(rowIndex);\n        }\n        this.anchor = rowIndex;\n      } else {\n        // Plain click (or any click when multiSelect is false): select only clicked row\n        if (this.selected.size === 1 && this.selected.has(rowIndex)) {\n          return false; // Same row already selected\n        }\n        this.selected.clear();\n        this.selected.add(rowIndex);\n        this.anchor = rowIndex;\n      }\n\n      this.lastSelected = rowIndex;\n      this.explicitSelection = true;\n      this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n      this.requestAfterRender();\n      return false;\n    }\n\n    // RANGE MODE: Shift+click extends selection, click starts new\n    if (mode === 'range') {\n      // Skip utility columns in range mode - don't start selection from them\n      if (isUtility) {\n        return false;\n      }\n\n      // Skip non-selectable cells in range mode\n      if (!this.isCellSelectable(rowIndex, colIndex)) {\n        return false;\n      }\n\n      const shiftKey = originalEvent.shiftKey;\n      const ctrlKey = (originalEvent.ctrlKey || originalEvent.metaKey) && this.config.multiSelect !== false;\n\n      if (shiftKey && this.cellAnchor) {\n        // Extend selection from anchor\n        const newRange = createRangeFromAnchor(this.cellAnchor, { row: rowIndex, col: colIndex });\n\n        // Check if range actually changed\n        const currentRange = this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] : null;\n        if (currentRange && rangesEqual(currentRange, newRange)) {\n          return false; // Same range already selected\n        }\n\n        if (ctrlKey) {\n          if (this.ranges.length > 0) {\n            this.ranges[this.ranges.length - 1] = newRange;\n          } else {\n            this.ranges.push(newRange);\n          }\n        } else {\n          this.ranges = [newRange];\n        }\n        this.activeRange = newRange;\n      } else if (ctrlKey) {\n        const newRange: InternalCellRange = {\n          startRow: rowIndex,\n          startCol: colIndex,\n          endRow: rowIndex,\n          endCol: colIndex,\n        };\n        this.ranges.push(newRange);\n        this.activeRange = newRange;\n        this.cellAnchor = { row: rowIndex, col: colIndex };\n      } else {\n        // Plain click - check if same single-cell range already selected\n        const newRange: InternalCellRange = {\n          startRow: rowIndex,\n          startCol: colIndex,\n          endRow: rowIndex,\n          endCol: colIndex,\n        };\n\n        // Only emit if selection actually changed\n        if (this.ranges.length === 1 && rangesEqual(this.ranges[0], newRange)) {\n          return false; // Same cell already selected\n        }\n\n        this.ranges = [newRange];\n        this.activeRange = newRange;\n        this.cellAnchor = { row: rowIndex, col: colIndex };\n      }\n\n      this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n\n      this.requestAfterRender();\n      return false;\n    }\n\n    return false;\n  }\n\n  /** @internal */\n  override onKeyDown(event: KeyboardEvent): boolean {\n    // Skip all selection if disabled at grid level or plugin level\n    if (!this.isSelectionEnabled()) return false;\n\n    const { mode } = this.config;\n    const navKeys = ['ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight', 'Tab', 'Home', 'End', 'PageUp', 'PageDown'];\n    const isNavKey = navKeys.includes(event.key);\n\n    // Escape clears selection in all modes\n    // But if editing is active, let the EditingPlugin handle Escape first\n    if (event.key === 'Escape') {\n      const isEditing = this.grid.query<boolean>('isEditing');\n      if (isEditing.some(Boolean)) {\n        return false; // Defer to EditingPlugin to cancel the active edit\n      }\n\n      if (mode === 'cell') {\n        this.selectedCell = null;\n      } else if (mode === 'row') {\n        this.selected.clear();\n        this.anchor = null;\n      } else if (mode === 'range') {\n        this.ranges = [];\n        this.activeRange = null;\n        this.cellAnchor = null;\n      }\n      this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n      this.requestAfterRender();\n      return true;\n    }\n\n    // CELL MODE: Selection follows focus (but respects selectability)\n    if (mode === 'cell' && isNavKey) {\n      // Use queueMicrotask so grid's handler runs first and updates focusRow/focusCol\n      queueMicrotask(() => {\n        const focusRow = this.grid._focusRow;\n        const focusCol = this.grid._focusCol;\n        // Only select if the cell is selectable\n        if (this.isCellSelectable(focusRow, focusCol)) {\n          this.selectedCell = { row: focusRow, col: focusCol };\n        } else {\n          // Clear selection when navigating to non-selectable cell\n          this.selectedCell = null;\n        }\n        this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n        this.requestAfterRender();\n      });\n      return false; // Let grid handle navigation\n    }\n\n    // ROW MODE: Arrow/Page/Home/End keys move selection, Shift extends, Ctrl+A selects all\n    if (mode === 'row') {\n      const multiSelect = this.config.multiSelect !== false;\n      const isRowNavKey =\n        event.key === 'ArrowUp' ||\n        event.key === 'ArrowDown' ||\n        event.key === 'PageUp' ||\n        event.key === 'PageDown' ||\n        ((event.ctrlKey || event.metaKey) && (event.key === 'Home' || event.key === 'End'));\n\n      if (isRowNavKey) {\n        const shiftKey = event.shiftKey && multiSelect;\n\n        // Set anchor SYNCHRONOUSLY before grid moves focus\n        if (shiftKey && this.anchor === null) {\n          this.anchor = this.grid._focusRow;\n        }\n\n        // Mark explicit selection SYNCHRONOUSLY so #syncSelectionToFocus\n        // won't overwrite the anchor if afterRender fires before our update\n        this.explicitSelection = true;\n\n        // Store pending update — processed in afterRender when grid has updated focusRow\n        this.pendingRowKeyUpdate = { shiftKey };\n\n        // Schedule afterRender (grid's refreshVirtualWindow(false) may skip it)\n        queueMicrotask(() => this.requestAfterRender());\n        return false; // Let grid handle navigation\n      }\n\n      // Ctrl+A: Select all rows (skip when editing, skip when single-select)\n      if (multiSelect && event.key === 'a' && (event.ctrlKey || event.metaKey)) {\n        const isEditing = this.grid.query<boolean>('isEditing');\n        if (isEditing.some(Boolean)) return false;\n        event.preventDefault();\n        event.stopPropagation();\n        this.selectAll();\n        return true;\n      }\n    }\n\n    // RANGE MODE: Shift+Arrow extends, plain Arrow resets\n    // Tab key always navigates without extending (even with Shift)\n    if (mode === 'range' && isNavKey) {\n      // Tab should not extend selection - it just navigates to the next/previous cell\n      const isTabKey = event.key === 'Tab';\n      const shouldExtend = event.shiftKey && !isTabKey;\n\n      // Capture anchor BEFORE grid moves focus (synchronous)\n      // This ensures the anchor is the starting point, not the destination\n      if (shouldExtend && !this.cellAnchor) {\n        this.cellAnchor = { row: this.grid._focusRow, col: this.grid._focusCol };\n      }\n\n      // Mark pending update - will be processed in afterRender when grid updates focus\n      this.pendingKeyboardUpdate = { shiftKey: shouldExtend };\n\n      // Schedule afterRender to run after grid's keyboard handler completes\n      // Grid's refreshVirtualWindow(false) skips afterRender for performance,\n      // so we explicitly request it to process pendingKeyboardUpdate\n      queueMicrotask(() => this.requestAfterRender());\n\n      return false; // Let grid handle navigation\n    }\n\n    // Ctrl+A selects all in range mode (skip when editing, skip when single-select)\n    if (\n      mode === 'range' &&\n      this.config.multiSelect !== false &&\n      event.key === 'a' &&\n      (event.ctrlKey || event.metaKey)\n    ) {\n      const isEditing = this.grid.query<boolean>('isEditing');\n      if (isEditing.some(Boolean)) return false;\n      event.preventDefault();\n      event.stopPropagation();\n      this.selectAll();\n      return true;\n    }\n\n    return false;\n  }\n\n  /** @internal */\n  override onCellMouseDown(event: CellMouseEvent): boolean | void {\n    // Skip all selection if disabled at grid level or plugin level\n    if (!this.isSelectionEnabled()) return;\n\n    if (this.config.mode !== 'range') return;\n    if (event.rowIndex === undefined || event.colIndex === undefined) return;\n    if (event.rowIndex < 0) return; // Header\n\n    // Skip utility columns (expander columns, etc.)\n    // event.column is already resolved from _visibleColumns in the event builder\n    if (event.column && isUtilityColumn(event.column)) {\n      return; // Don't start selection on utility columns\n    }\n\n    // Skip non-selectable cells - don't start drag from them\n    if (!this.isCellSelectable(event.rowIndex, event.colIndex)) {\n      return;\n    }\n\n    // Let onCellClick handle shift+click for range extension\n    if (event.originalEvent.shiftKey && this.cellAnchor) {\n      return;\n    }\n\n    // Start drag selection\n    this.isDragging = true;\n    const rowIndex = event.rowIndex;\n    const colIndex = event.colIndex;\n\n    // When multiSelect is false, Ctrl+click starts a new single range instead of adding\n    const ctrlKey = (event.originalEvent.ctrlKey || event.originalEvent.metaKey) && this.config.multiSelect !== false;\n\n    const newRange: InternalCellRange = {\n      startRow: rowIndex,\n      startCol: colIndex,\n      endRow: rowIndex,\n      endCol: colIndex,\n    };\n\n    // Check if selection is actually changing (for non-Ctrl clicks)\n    if (!ctrlKey && this.ranges.length === 1 && rangesEqual(this.ranges[0], newRange)) {\n      // Same cell already selected, just update anchor for potential drag\n      this.cellAnchor = { row: rowIndex, col: colIndex };\n      return true;\n    }\n\n    this.cellAnchor = { row: rowIndex, col: colIndex };\n\n    if (!ctrlKey) {\n      this.ranges = [];\n    }\n\n    this.ranges.push(newRange);\n    this.activeRange = newRange;\n\n    this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n    this.requestAfterRender();\n    return true;\n  }\n\n  /** @internal */\n  override onCellMouseMove(event: CellMouseEvent): boolean | void {\n    // Skip all selection if disabled at grid level or plugin level\n    if (!this.isSelectionEnabled()) return;\n\n    if (this.config.mode !== 'range') return;\n    if (!this.isDragging || !this.cellAnchor) return;\n    if (event.rowIndex === undefined || event.colIndex === undefined) return;\n    if (event.rowIndex < 0) return;\n\n    // When dragging, clamp to first data column (skip utility columns)\n    // colIndex from events is a visible-column index (from data-col)\n    let targetCol = event.colIndex;\n    const column = this.visibleColumns[targetCol];\n    if (column && isUtilityColumn(column)) {\n      // Find the first non-utility visible column\n      const firstDataCol = this.visibleColumns.findIndex((col) => !isUtilityColumn(col));\n      if (firstDataCol >= 0) {\n        targetCol = firstDataCol;\n      }\n    }\n\n    const newRange = createRangeFromAnchor(this.cellAnchor, { row: event.rowIndex, col: targetCol });\n\n    // Only update and emit if the range actually changed\n    const currentRange = this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] : null;\n    if (currentRange && rangesEqual(currentRange, newRange)) {\n      return true; // Range unchanged, no need to update\n    }\n\n    if (this.ranges.length > 0) {\n      this.ranges[this.ranges.length - 1] = newRange;\n    } else {\n      this.ranges.push(newRange);\n    }\n    this.activeRange = newRange;\n\n    this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n    this.requestAfterRender();\n    return true;\n  }\n\n  /** @internal */\n  override onCellMouseUp(_event: CellMouseEvent): boolean | void {\n    // Skip all selection if disabled at grid level or plugin level\n    if (!this.isSelectionEnabled()) return;\n\n    if (this.config.mode !== 'range') return;\n    if (this.isDragging) {\n      this.isDragging = false;\n      return true;\n    }\n  }\n\n  // #region Checkbox Column\n\n  /**\n   * Inject checkbox column when `checkbox: true` and mode is `'row'`.\n   * @internal\n   */\n  override processColumns(columns: ColumnConfig[]): ColumnConfig[] {\n    if (this.config.checkbox && this.config.mode === 'row') {\n      // Check if checkbox column already exists\n      if (columns.some((col) => col.field === CHECKBOX_COLUMN_FIELD)) {\n        return columns;\n      }\n      const checkboxCol = this.#createCheckboxColumn();\n      // Insert after expander column if present, otherwise first\n      const expanderIdx = columns.findIndex(isExpanderColumn);\n      const insertAt = expanderIdx >= 0 ? expanderIdx + 1 : 0;\n      return [...columns.slice(0, insertAt), checkboxCol, ...columns.slice(insertAt)];\n    }\n    return columns;\n  }\n\n  /**\n   * Create the checkbox utility column configuration.\n   */\n  #createCheckboxColumn(): ColumnConfig {\n    return {\n      field: CHECKBOX_COLUMN_FIELD,\n      header: '',\n      width: 32,\n      resizable: false,\n      sortable: false,\n      meta: {\n        lockPosition: true,\n        suppressMovable: true,\n        utility: true,\n        checkboxColumn: true,\n      },\n      headerRenderer: () => {\n        const container = document.createElement('div');\n        container.className = 'tbw-checkbox-header';\n        // Hide \"select all\" checkbox in single-select mode\n        if (this.config.multiSelect === false) return container;\n        const checkbox = document.createElement('input');\n        checkbox.type = 'checkbox';\n        checkbox.className = 'tbw-select-all-checkbox';\n        checkbox.addEventListener('click', (e) => {\n          e.stopPropagation(); // Prevent header sort\n          if ((e.target as HTMLInputElement).checked) {\n            this.selectAll();\n          } else {\n            this.clearSelection();\n          }\n        });\n        container.appendChild(checkbox);\n        return container;\n      },\n      renderer: (ctx) => {\n        const checkbox = document.createElement('input');\n        checkbox.type = 'checkbox';\n        checkbox.className = 'tbw-select-row-checkbox';\n        // Set initial checked state from current selection\n        const cellEl = ctx.cellEl;\n        if (cellEl) {\n          const rowIndex = parseInt(cellEl.getAttribute('data-row') ?? '-1', 10);\n          if (rowIndex >= 0) {\n            checkbox.checked = this.selected.has(rowIndex);\n          }\n        }\n        return checkbox;\n      },\n    };\n  }\n\n  /**\n   * Update checkbox checked states to reflect current selection.\n   * Called from #applySelectionClasses.\n   */\n  #updateCheckboxStates(gridEl: HTMLElement): void {\n    // Update row checkboxes\n    const rowCheckboxes = gridEl.querySelectorAll('.tbw-select-row-checkbox') as NodeListOf<HTMLInputElement>;\n    rowCheckboxes.forEach((checkbox) => {\n      const cell = checkbox.closest('.cell');\n      const rowIndex = cell ? getRowIndexFromCell(cell) : -1;\n      if (rowIndex >= 0) {\n        checkbox.checked = this.selected.has(rowIndex);\n      }\n    });\n\n    // Update header select-all checkbox\n    const headerCheckbox = gridEl.querySelector('.tbw-select-all-checkbox') as HTMLInputElement | null;\n    if (headerCheckbox) {\n      const rowCount = this.rows.length;\n      let selectableCount = 0;\n      if (this.config.isSelectable) {\n        for (let i = 0; i < rowCount; i++) {\n          if (this.isRowSelectable(i)) selectableCount++;\n        }\n      } else {\n        selectableCount = rowCount;\n      }\n      const allSelected = selectableCount > 0 && this.selected.size >= selectableCount;\n      const someSelected = this.selected.size > 0;\n      headerCheckbox.checked = allSelected;\n      headerCheckbox.indeterminate = someSelected && !allSelected;\n    }\n  }\n\n  // #endregion\n\n  /**\n   * Sync selection state to the grid's current focus position.\n   * In row mode, keeps `selected` in sync with `_focusRow`.\n   * In cell mode, keeps `selectedCell` in sync with `_focusRow`/`_focusCol`.\n   * Only updates when the focus has changed since the last sync.\n   * Skips when `explicitSelection` is set (click/keyboard set selection directly).\n   */\n  #syncSelectionToFocus(mode: string): void {\n    const focusRow = this.grid._focusRow;\n    const focusCol = this.grid._focusCol;\n\n    if (mode === 'row') {\n      // Skip auto-sync when selection was explicitly set (Shift/Ctrl click, keyboard)\n      if (this.explicitSelection) {\n        this.explicitSelection = false;\n        this.lastSyncedFocusRow = focusRow;\n        return;\n      }\n\n      if (focusRow !== this.lastSyncedFocusRow) {\n        this.lastSyncedFocusRow = focusRow;\n        if (this.isRowSelectable(focusRow)) {\n          if (!this.selected.has(focusRow) || this.selected.size !== 1) {\n            this.selected.clear();\n            this.selected.add(focusRow);\n            this.lastSelected = focusRow;\n            this.anchor = focusRow;\n            this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n          }\n        }\n      }\n    }\n\n    if (mode === 'cell') {\n      if (this.explicitSelection) {\n        this.explicitSelection = false;\n        this.lastSyncedFocusRow = focusRow;\n        this.lastSyncedFocusCol = focusCol;\n        return;\n      }\n\n      if (focusRow !== this.lastSyncedFocusRow || focusCol !== this.lastSyncedFocusCol) {\n        this.lastSyncedFocusRow = focusRow;\n        this.lastSyncedFocusCol = focusCol;\n        if (this.isCellSelectable(focusRow, focusCol)) {\n          const cur = this.selectedCell;\n          if (!cur || cur.row !== focusRow || cur.col !== focusCol) {\n            this.selectedCell = { row: focusRow, col: focusCol };\n            this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n          }\n        }\n      }\n    }\n  }\n\n  /**\n   * Apply CSS selection classes to row/cell elements.\n   * Shared by afterRender and onScrollRender.\n   */\n  #applySelectionClasses(): void {\n    const gridEl = this.gridElement;\n    if (!gridEl) return;\n\n    const { mode } = this.config;\n    const hasSelectableCallback = !!this.config.isSelectable;\n\n    // Clear all selection classes first\n    const allCells = gridEl.querySelectorAll('.cell');\n    allCells.forEach((cell) => {\n      cell.classList.remove('selected', 'top', 'bottom', 'first', 'last');\n      // Clear selectable attribute - will be re-applied below\n      if (hasSelectableCallback) {\n        cell.removeAttribute('data-selectable');\n      }\n    });\n\n    const allRows = gridEl.querySelectorAll('.data-grid-row');\n    allRows.forEach((row) => {\n      row.classList.remove('selected', 'row-focus');\n      row.setAttribute('aria-selected', 'false');\n      // Clear selectable attribute - will be re-applied below\n      if (hasSelectableCallback) {\n        row.removeAttribute('data-selectable');\n      }\n    });\n\n    // ROW MODE: Add row-focus class to selected rows, disable cell-focus, update checkboxes\n    if (mode === 'row') {\n      // In row mode, disable ALL cell-focus styling - row selection takes precedence\n      clearCellFocus(gridEl);\n\n      allRows.forEach((row) => {\n        const firstCell = row.querySelector('.cell[data-row]');\n        const rowIndex = getRowIndexFromCell(firstCell);\n        if (rowIndex >= 0) {\n          // Mark non-selectable rows\n          if (hasSelectableCallback && !this.isRowSelectable(rowIndex)) {\n            row.setAttribute('data-selectable', 'false');\n          }\n          if (this.selected.has(rowIndex)) {\n            row.classList.add('selected', 'row-focus');\n            row.setAttribute('aria-selected', 'true');\n          }\n        }\n      });\n\n      // Update checkbox states if checkbox column is enabled\n      if (this.config.checkbox) {\n        this.#updateCheckboxStates(gridEl);\n      }\n    }\n\n    // CELL/RANGE MODE: Mark non-selectable cells\n    if ((mode === 'cell' || mode === 'range') && hasSelectableCallback) {\n      const cells = gridEl.querySelectorAll('.cell[data-row][data-col]');\n      cells.forEach((cell) => {\n        const rowIndex = parseInt(cell.getAttribute('data-row') ?? '-1', 10);\n        const colIndex = parseInt(cell.getAttribute('data-col') ?? '-1', 10);\n        if (rowIndex >= 0 && colIndex >= 0) {\n          if (!this.isCellSelectable(rowIndex, colIndex)) {\n            cell.setAttribute('data-selectable', 'false');\n          }\n        }\n      });\n    }\n\n    // RANGE MODE: Add selected and edge classes to cells\n    // Uses neighbor-based edge detection for correct multi-range borders\n    if (mode === 'range' && this.ranges.length > 0) {\n      // Clear all cell-focus first - selection plugin manages focus styling in range mode\n      clearCellFocus(gridEl);\n\n      // Pre-normalize ranges for efficient neighbor checks\n      const normalizedRanges = this.ranges.map(normalizeRange);\n\n      // Fast selection check against pre-normalized ranges\n      const isInSelection = (r: number, c: number): boolean => {\n        for (const range of normalizedRanges) {\n          if (r >= range.startRow && r <= range.endRow && c >= range.startCol && c <= range.endCol) {\n            return true;\n          }\n        }\n        return false;\n      };\n\n      const cells = gridEl.querySelectorAll('.cell[data-row][data-col]');\n      cells.forEach((cell) => {\n        const rowIndex = parseInt(cell.getAttribute('data-row') ?? '-1', 10);\n        const colIndex = parseInt(cell.getAttribute('data-col') ?? '-1', 10);\n        if (rowIndex >= 0 && colIndex >= 0) {\n          // Skip utility columns entirely - don't add any selection classes\n          // colIndex from data-col is a visible-column index\n          const column = this.visibleColumns[colIndex];\n          if (column && isUtilityColumn(column)) {\n            return;\n          }\n\n          if (isInSelection(rowIndex, colIndex)) {\n            cell.classList.add('selected');\n            cell.setAttribute('aria-selected', 'true');\n\n            // Edge detection: add border class where neighbor is not selected\n            // This handles single ranges, multi-range, and irregular selections correctly\n            if (!isInSelection(rowIndex - 1, colIndex)) cell.classList.add('top');\n            if (!isInSelection(rowIndex + 1, colIndex)) cell.classList.add('bottom');\n            if (!isInSelection(rowIndex, colIndex - 1)) cell.classList.add('first');\n            if (!isInSelection(rowIndex, colIndex + 1)) cell.classList.add('last');\n          }\n        }\n      });\n    }\n\n    // CELL MODE: Let the grid's native .cell-focus styling handle cell highlighting\n    // No additional action needed - the grid already manages focus styling\n  }\n\n  /** @internal */\n  override afterRender(): void {\n    // Skip rendering selection if disabled at grid level or plugin level\n    if (!this.isSelectionEnabled()) return;\n\n    const gridEl = this.gridElement;\n    if (!gridEl) return;\n\n    const container = gridEl.children[0];\n    const { mode } = this.config;\n\n    // Process pending row keyboard navigation update (row mode)\n    // This runs AFTER the grid has updated focusRow\n    if (this.pendingRowKeyUpdate && mode === 'row') {\n      const { shiftKey } = this.pendingRowKeyUpdate;\n      this.pendingRowKeyUpdate = null;\n\n      const focusRow = this.grid._focusRow;\n\n      if (shiftKey && this.anchor !== null) {\n        // Shift+nav: Extend selection from anchor to new focus\n        this.selected.clear();\n        const start = Math.min(this.anchor, focusRow);\n        const end = Math.max(this.anchor, focusRow);\n        for (let i = start; i <= end; i++) {\n          if (this.isRowSelectable(i)) {\n            this.selected.add(i);\n          }\n        }\n      } else {\n        // Plain nav: Single select\n        if (this.isRowSelectable(focusRow)) {\n          this.selected.clear();\n          this.selected.add(focusRow);\n          this.anchor = focusRow;\n        } else {\n          this.selected.clear();\n        }\n      }\n\n      this.lastSelected = focusRow;\n      this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n    }\n\n    // Process pending keyboard navigation update (range mode)\n    // This runs AFTER the grid has updated focusRow/focusCol\n    if (this.pendingKeyboardUpdate && mode === 'range') {\n      const { shiftKey } = this.pendingKeyboardUpdate;\n      this.pendingKeyboardUpdate = null;\n\n      const currentRow = this.grid._focusRow;\n      const currentCol = this.grid._focusCol;\n\n      if (shiftKey && this.cellAnchor) {\n        // Extend selection from anchor to current focus\n        const newRange = createRangeFromAnchor(this.cellAnchor, { row: currentRow, col: currentCol });\n        this.ranges = [newRange];\n        this.activeRange = newRange;\n      } else if (!shiftKey) {\n        // Without shift, clear selection (cell-focus will show instead)\n        this.ranges = [];\n        this.activeRange = null;\n        this.cellAnchor = { row: currentRow, col: currentCol }; // Reset anchor to current position\n      }\n\n      this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n    }\n\n    // Sync selection to grid's focus position.\n    // This ensures selection follows keyboard navigation (Tab, arrows, etc.)\n    // regardless of which plugin moved the focus.\n    this.#syncSelectionToFocus(mode);\n\n    // Set data attribute on host for CSS variable scoping\n    this.gridElement.setAttribute('data-selection-mode', mode);\n\n    // Toggle .selecting class during drag to prevent text selection\n    if (container) {\n      container.classList.toggle('selecting', this.isDragging);\n    }\n\n    this.#applySelectionClasses();\n  }\n\n  /**\n   * Called after scroll-triggered row rendering.\n   * Reapplies selection classes to recycled DOM elements.\n   * @internal\n   */\n  override onScrollRender(): void {\n    // Skip rendering selection classes if disabled\n    if (!this.isSelectionEnabled()) return;\n\n    this.#applySelectionClasses();\n  }\n\n  // #endregion\n\n  // #region Public API\n\n  /**\n   * Get the current selection as a unified result.\n   * Works for all selection modes and always returns ranges.\n   *\n   * @example\n   * ```ts\n   * const selection = plugin.getSelection();\n   * if (selection.ranges.length > 0) {\n   *   const { from, to } = selection.ranges[0];\n   *   // For cell mode: from === to (single cell)\n   *   // For row mode: from.col = 0, to.col = lastCol (full row)\n   *   // For range mode: rectangular selection\n   * }\n   * ```\n   */\n  getSelection(): SelectionResult {\n    return {\n      mode: this.config.mode,\n      ranges: this.#buildEvent().ranges,\n      anchor: this.cellAnchor,\n    };\n  }\n\n  /**\n   * Get all selected cells across all ranges.\n   */\n  getSelectedCells(): Array<{ row: number; col: number }> {\n    return getAllCellsInRanges(this.ranges);\n  }\n\n  /**\n   * Check if a specific cell is in range selection.\n   */\n  isCellSelected(row: number, col: number): boolean {\n    return isCellInAnyRange(row, col, this.ranges);\n  }\n\n  /**\n   * Select all selectable rows (row mode) or all cells (range mode).\n   *\n   * In row mode, selects every row where `isSelectable` returns true (or all rows if no callback).\n   * In range mode, creates a single range spanning all rows and columns.\n   * Has no effect in cell mode.\n   *\n   * @example\n   * ```ts\n   * const plugin = grid.getPluginByName('selection');\n   * plugin.selectAll(); // Selects everything in current mode\n   * ```\n   */\n  selectAll(): void {\n    const { mode, multiSelect } = this.config;\n\n    // Single-select mode: selectAll is a no-op\n    if (multiSelect === false) return;\n\n    if (mode === 'row') {\n      this.selected.clear();\n      for (let i = 0; i < this.rows.length; i++) {\n        if (this.isRowSelectable(i)) {\n          this.selected.add(i);\n        }\n      }\n      this.explicitSelection = true;\n      this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n      this.requestAfterRender();\n    } else if (mode === 'range') {\n      const rowCount = this.rows.length;\n      const colCount = this.columns.length;\n      if (rowCount > 0 && colCount > 0) {\n        const allRange: InternalCellRange = {\n          startRow: 0,\n          startCol: 0,\n          endRow: rowCount - 1,\n          endCol: colCount - 1,\n        };\n        this.ranges = [allRange];\n        this.activeRange = allRange;\n        this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n        this.requestAfterRender();\n      }\n    }\n  }\n\n  /**\n   * Select specific rows by index (row mode only).\n   * Replaces the current selection with the provided row indices.\n   * Indices that are out of bounds or fail the `isSelectable` check are ignored.\n   *\n   * @param indices - Array of row indices to select\n   *\n   * @example\n   * ```ts\n   * const plugin = grid.getPluginByName('selection');\n   * plugin.selectRows([0, 2, 4]); // Select rows 0, 2, and 4\n   * ```\n   */\n  selectRows(indices: number[]): void {\n    if (this.config.mode !== 'row') return;\n    // In single-select mode, only use the last index\n    const effectiveIndices =\n      this.config.multiSelect === false && indices.length > 1 ? [indices[indices.length - 1]] : indices;\n    this.selected.clear();\n    for (const idx of effectiveIndices) {\n      if (idx >= 0 && idx < this.rows.length && this.isRowSelectable(idx)) {\n        this.selected.add(idx);\n      }\n    }\n    this.anchor = effectiveIndices.length > 0 ? effectiveIndices[effectiveIndices.length - 1] : null;\n    this.explicitSelection = true;\n    this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n    this.requestAfterRender();\n  }\n\n  /**\n   * Get the indices of all selected rows (convenience for row mode).\n   * Returns indices sorted in ascending order.\n   *\n   * @example\n   * ```ts\n   * const plugin = grid.getPluginByName('selection');\n   * const rows = plugin.getSelectedRowIndices(); // [0, 2, 4]\n   * ```\n   */\n  getSelectedRowIndices(): number[] {\n    return [...this.selected].sort((a, b) => a - b);\n  }\n\n  /**\n   * Get the actual row objects for the current selection.\n   *\n   * Works across all selection modes:\n   * - **Row mode**: Returns the row objects for all selected rows.\n   * - **Cell mode**: Returns the single row containing the selected cell, or `[]`.\n   * - **Range mode**: Returns the unique row objects that intersect any selected range.\n   *\n   * Row objects are resolved from the grid's processed (sorted/filtered) row array,\n   * so they always reflect the current visual order.\n   *\n   * @example\n   * ```ts\n   * const plugin = grid.getPluginByName('selection');\n   * const selected = plugin.getSelectedRows(); // [{ id: 1, name: 'Alice' }, ...]\n   * ```\n   */\n  getSelectedRows<T = unknown>(): T[] {\n    const { mode } = this.config;\n    const rows = this.rows;\n\n    if (mode === 'row') {\n      return this.getSelectedRowIndices()\n        .filter((i) => i >= 0 && i < rows.length)\n        .map((i) => rows[i]) as T[];\n    }\n\n    if (mode === 'cell' && this.selectedCell) {\n      const { row } = this.selectedCell;\n      return row >= 0 && row < rows.length ? [rows[row] as T] : [];\n    }\n\n    if (mode === 'range' && this.ranges.length > 0) {\n      // Collect unique row indices across all ranges\n      const rowIndices = new Set<number>();\n      for (const range of this.ranges) {\n        const minRow = Math.max(0, Math.min(range.startRow, range.endRow));\n        const maxRow = Math.min(rows.length - 1, Math.max(range.startRow, range.endRow));\n        for (let r = minRow; r <= maxRow; r++) {\n          rowIndices.add(r);\n        }\n      }\n      return [...rowIndices].sort((a, b) => a - b).map((i) => rows[i]) as T[];\n    }\n\n    return [];\n  }\n\n  /**\n   * Clear all selection.\n   */\n  clearSelection(): void {\n    this.selectedCell = null;\n    this.selected.clear();\n    this.anchor = null;\n    this.ranges = [];\n    this.activeRange = null;\n    this.cellAnchor = null;\n    this.emit<SelectionChangeDetail>('selection-change', { mode: this.config.mode, ranges: [] });\n    this.requestAfterRender();\n  }\n\n  /**\n   * Set selected ranges programmatically.\n   */\n  setRanges(ranges: CellRange[]): void {\n    this.ranges = ranges.map((r) => ({\n      startRow: r.from.row,\n      startCol: r.from.col,\n      endRow: r.to.row,\n      endCol: r.to.col,\n    }));\n    this.activeRange = this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] : null;\n    this.emit<SelectionChangeDetail>('selection-change', {\n      mode: this.config.mode,\n      ranges: toPublicRanges(this.ranges),\n    });\n    this.requestAfterRender();\n  }\n\n  // #endregion\n\n  // #region Private Helpers\n\n  #buildEvent(): SelectionChangeDetail {\n    return buildSelectionEvent(\n      this.config.mode,\n      {\n        selectedCell: this.selectedCell,\n        selected: this.selected,\n        ranges: this.ranges,\n      },\n      this.columns.length,\n    );\n  }\n\n  // #endregion\n}\n"],"names":["normalizeRange","range","startRow","Math","min","endRow","startCol","endCol","max","toPublicRange","normalized","from","row","col","to","toPublicRanges","ranges","map","isCellInAnyRange","some","isCellInRange","getCellsInRange","cells","push","createRangeFromAnchor","anchor","current","rangesEqual","a","b","normA","normB","CHECKBOX_COLUMN_FIELD","SelectionPlugin","BaseGridPlugin","static","queries","type","description","configRules","id","severity","message","check","config","mode","triggerOn","name","styles","defaultConfig","enabled","multiSelect","selected","Set","lastSelected","activeRange","cellAnchor","isDragging","pendingKeyboardUpdate","pendingRowKeyUpdate","selectedCell","lastSyncedFocusRow","lastSyncedFocusCol","explicitSelection","isSelectionEnabled","this","grid","effectiveConfig","selectable","checkSelectable","rowIndex","colIndex","isSelectable","rows","visibleColumns","isRowSelectable","isCellSelectable","attach","super","on","clearSelectionSilent","handleQuery","query","getSelection","getSelectedRowIndices","getSelectedRows","selectRows","context","detach","clear","requestAfterRender","onCellClick","event","originalEvent","column","isUtility","isUtilityColumn","currentCell","emit","buildEvent","shiftKey","ctrlKey","metaKey","isCheckbox","meta","checkboxColumn","start","end","i","add","has","delete","size","newRange","currentRange","length","onKeyDown","isNavKey","includes","key","Boolean","queueMicrotask","focusRow","_focusRow","focusCol","_focusCol","preventDefault","stopPropagation","selectAll","isTabKey","shouldExtend","onCellMouseDown","onCellMouseMove","targetCol","firstDataCol","findIndex","onCellMouseUp","_event","processColumns","columns","checkbox","field","checkboxCol","createCheckboxColumn","expanderIdx","isExpanderColumn","insertAt","slice","header","width","resizable","sortable","lockPosition","suppressMovable","utility","headerRenderer","container","document","createElement","className","addEventListener","e","target","checked","clearSelection","appendChild","renderer","ctx","cellEl","parseInt","getAttribute","updateCheckboxStates","gridEl","querySelectorAll","forEach","cell","closest","getRowIndexFromCell","headerCheckbox","querySelector","rowCount","selectableCount","allSelected","someSelected","indeterminate","syncSelectionToFocus","cur","applySelectionClasses","gridElement","hasSelectableCallback","classList","remove","removeAttribute","allRows","setAttribute","clearCellFocus","firstCell","normalizedRanges","isInSelection","r","c","afterRender","children","currentRow","currentCol","toggle","onScrollRender","getSelectedCells","cellMap","Map","set","values","getAllCellsInRanges","isCellSelected","colCount","allRange","indices","effectiveIndices","idx","sort","filter","rowIndices","minRow","maxRow","setRanges","state","sorted","buildSelectionEvent"],"mappings":"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"}

package/umd/plugins/tree.umd.js.map

@@ -1 +1 @@
-{"version":3,"file":"tree.umd.js","sources":["../../../../../libs/grid/src/lib/plugins/tree/tree-data.ts","../../../../../libs/grid/src/lib/plugins/tree/tree-detect.ts","../../../../../libs/grid/src/lib/plugins/tree/TreePlugin.ts"],"sourcesContent":["/**\n * Core Tree Data Logic\n *\n * Pure functions for tree flattening, expansion, and traversal.\n */\n\nimport type { FlattenedTreeRow, TreeConfig, TreeRow } from './types';\n\n/**\n * Generates a unique key for a row.\n * Uses row.id if available, otherwise generates from path.\n */\nexport function generateRowKey(row: TreeRow, index: number, parentKey: string | null): string {\n  if (row.id !== undefined) return String(row.id);\n  return parentKey ? `${parentKey}-${index}` : String(index);\n}\n\n/**\n * Flattens a hierarchical tree into a flat array of rows with metadata.\n * Only includes children of expanded nodes.\n */\nexport function flattenTree(\n  rows: readonly TreeRow[],\n  config: TreeConfig,\n  expandedKeys: Set<string>,\n  parentKey: string | null = null,\n  depth = 0,\n): FlattenedTreeRow[] {\n  const childrenField = config.childrenField ?? 'children';\n  const result: FlattenedTreeRow[] = [];\n\n  for (let i = 0; i < rows.length; i++) {\n    const row = rows[i];\n    const key = generateRowKey(row, i, parentKey);\n    const children = row[childrenField];\n    const hasChildren = Array.isArray(children) && children.length > 0;\n    const isExpanded = expandedKeys.has(key);\n\n    result.push({\n      key,\n      data: row,\n      depth,\n      hasChildren,\n      isExpanded,\n      parentKey,\n    });\n\n    // Recursively add children if expanded\n    if (hasChildren && isExpanded) {\n      const childRows = flattenTree(children as TreeRow[], config, expandedKeys, key, depth + 1);\n      result.push(...childRows);\n    }\n  }\n\n  return result;\n}\n\n/**\n * Toggles the expansion state of a row.\n * Returns a new Set with the toggled state.\n */\nexport function toggleExpand(expandedKeys: Set<string>, key: string): Set<string> {\n  const newExpanded = new Set(expandedKeys);\n  if (newExpanded.has(key)) {\n    newExpanded.delete(key);\n  } else {\n    newExpanded.add(key);\n  }\n  return newExpanded;\n}\n\n/**\n * Expands all nodes in the tree.\n * Returns a Set of all parent row keys.\n */\nexport function expandAll(\n  rows: readonly TreeRow[],\n  config: TreeConfig,\n  parentKey: string | null = null,\n  depth = 0,\n): Set<string> {\n  const childrenField = config.childrenField ?? 'children';\n  const keys = new Set<string>();\n\n  for (let i = 0; i < rows.length; i++) {\n    const row = rows[i];\n    const key = generateRowKey(row, i, parentKey);\n    const children = row[childrenField];\n\n    if (Array.isArray(children) && children.length > 0) {\n      keys.add(key);\n      const childKeys = expandAll(children as TreeRow[], config, key, depth + 1);\n      for (const k of childKeys) keys.add(k);\n    }\n  }\n\n  return keys;\n}\n\n/**\n * Collapses all nodes.\n * Returns an empty Set.\n */\nexport function collapseAll(): Set<string> {\n  return new Set();\n}\n\n/**\n * Gets all descendants of a node from the flattened row list.\n * Useful for operations that need to affect an entire subtree.\n */\nexport function getDescendants(flattenedRows: FlattenedTreeRow[], parentKey: string): FlattenedTreeRow[] {\n  const descendants: FlattenedTreeRow[] = [];\n  let collecting = false;\n  let parentDepth = -1;\n\n  for (const row of flattenedRows) {\n    if (row.key === parentKey) {\n      collecting = true;\n      parentDepth = row.depth;\n      continue;\n    }\n\n    if (collecting) {\n      if (row.depth > parentDepth) {\n        descendants.push(row);\n      } else {\n        break; // No longer a descendant\n      }\n    }\n  }\n\n  return descendants;\n}\n\n/**\n * Finds the path from root to a specific row key.\n * Returns an array of keys from root to the target (inclusive).\n */\nexport function getPathToKey(\n  rows: readonly TreeRow[],\n  targetKey: string,\n  config: TreeConfig,\n  parentKey: string | null = null,\n  depth = 0,\n): string[] | null {\n  const childrenField = config.childrenField ?? 'children';\n\n  for (let i = 0; i < rows.length; i++) {\n    const row = rows[i];\n    const key = generateRowKey(row, i, parentKey);\n\n    if (key === targetKey) {\n      return [key];\n    }\n\n    const children = row[childrenField];\n    if (Array.isArray(children) && children.length > 0) {\n      const childPath = getPathToKey(children as TreeRow[], targetKey, config, key, depth + 1);\n      if (childPath) {\n        return [key, ...childPath];\n      }\n    }\n  }\n\n  return null;\n}\n\n/**\n * Expands all ancestors of a specific row to make it visible.\n * Returns a new Set with the required keys added.\n */\nexport function expandToKey(\n  rows: readonly TreeRow[],\n  targetKey: string,\n  config: TreeConfig,\n  existingExpanded: Set<string>,\n): Set<string> {\n  const path = getPathToKey(rows, targetKey, config);\n  if (!path) return existingExpanded;\n\n  const newExpanded = new Set(existingExpanded);\n  // Add all keys except the last one (the target itself)\n  for (let i = 0; i < path.length - 1; i++) {\n    newExpanded.add(path[i]);\n  }\n  return newExpanded;\n}\n","/**\n * Tree Structure Auto-Detection\n *\n * Utilities for detecting hierarchical tree data structures.\n */\n\nimport type { TreeRow } from './types';\n\n/**\n * Detects if the data has a tree structure by checking for children arrays.\n */\nexport function detectTreeStructure(rows: readonly TreeRow[], childrenField = 'children'): boolean {\n  if (!Array.isArray(rows) || rows.length === 0) return false;\n\n  // Check if any row has a non-empty children array\n  for (const row of rows) {\n    if (!row) continue;\n    const children = row[childrenField];\n    if (Array.isArray(children) && children.length > 0) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Attempts to infer the children field name from common patterns.\n * Returns the first field that contains an array with items.\n */\nexport function inferChildrenField(rows: readonly TreeRow[]): string | null {\n  if (!Array.isArray(rows) || rows.length === 0) return null;\n\n  const commonArrayFields = ['children', 'items', 'nodes', 'subRows', 'nested'];\n\n  for (const row of rows) {\n    if (!row || typeof row !== 'object') continue;\n\n    for (const field of commonArrayFields) {\n      const value = row[field];\n      if (Array.isArray(value) && value.length > 0) {\n        return field;\n      }\n    }\n  }\n\n  return null;\n}\n\n/**\n * Calculates the maximum depth of the tree.\n * Useful for layout calculations and virtualization.\n */\nexport function getMaxDepth(rows: readonly TreeRow[], childrenField = 'children', currentDepth = 0): number {\n  if (!Array.isArray(rows) || rows.length === 0) return currentDepth;\n\n  let maxDepth = currentDepth;\n\n  for (const row of rows) {\n    if (!row) continue;\n    const children = row[childrenField];\n    if (Array.isArray(children) && children.length > 0) {\n      const childDepth = getMaxDepth(children as TreeRow[], childrenField, currentDepth + 1);\n      if (childDepth > maxDepth) {\n        maxDepth = childDepth;\n      }\n    }\n  }\n\n  return maxDepth;\n}\n\n/**\n * Counts total nodes in the tree (including all descendants).\n */\nexport function countNodes(rows: readonly TreeRow[], childrenField = 'children'): number {\n  if (!Array.isArray(rows)) return 0;\n\n  let count = 0;\n  for (const row of rows) {\n    if (!row) continue;\n    count++;\n    const children = row[childrenField];\n    if (Array.isArray(children)) {\n      count += countNodes(children as TreeRow[], childrenField);\n    }\n  }\n\n  return count;\n}\n","/**\n * Tree Data Plugin\n *\n * Enables hierarchical tree data with expand/collapse, sorting, and auto-detection.\n */\n\nimport {\n  BaseGridPlugin,\n  CellClickEvent,\n  HeaderClickEvent,\n  type PluginManifest,\n  type PluginQuery,\n} from '../../core/plugin/base-plugin';\nimport type { ColumnConfig, ColumnViewRenderer, GridHost } from '../../core/types';\nimport { collapseAll, expandAll, expandToKey, toggleExpand } from './tree-data';\nimport { detectTreeStructure, inferChildrenField } from './tree-detect';\nimport styles from './tree.css?inline';\nimport type { ExpandCollapseAnimation, FlattenedTreeRow, TreeConfig, TreeExpandDetail, TreeRow } from './types';\n\n/**\n * Tree Data Plugin for tbw-grid\n *\n * Transforms your flat grid into a hierarchical tree view with expandable parent-child\n * relationships. Ideal for file explorers, organizational charts, nested categories,\n * or any data with a natural hierarchy.\n *\n * ## Installation\n *\n * ```ts\n * import { TreePlugin } from '@toolbox-web/grid/plugins/tree';\n * ```\n *\n * ## Configuration Options\n *\n * | Option | Type | Default | Description |\n * |--------|------|---------|-------------|\n * | `childrenField` | `string` | `'children'` | Field containing child array |\n * | `autoDetect` | `boolean` | `true` | Auto-detect tree structure from data |\n * | `defaultExpanded` | `boolean` | `false` | Expand all nodes initially |\n * | `indentWidth` | `number` | `20` | Indentation per level (pixels) |\n * | `showExpandIcons` | `boolean` | `true` | Show expand/collapse toggle icons |\n * | `animation` | `false \\| 'slide' \\| 'fade'` | `'slide'` | Animation style for expand/collapse |\n *\n * ## Programmatic API\n *\n * | Method | Signature | Description |\n * |--------|-----------|-------------|\n * | `expand` | `(nodeId) => void` | Expand a specific node |\n * | `collapse` | `(nodeId) => void` | Collapse a specific node |\n * | `toggle` | `(nodeId) => void` | Toggle a node's expanded state |\n * | `expandAll` | `() => void` | Expand all nodes |\n * | `collapseAll` | `() => void` | Collapse all nodes |\n * | `getExpandedNodes` | `() => Set<string>` | Get currently expanded node keys |\n *\n * ## CSS Custom Properties\n *\n * | Property | Default | Description |\n * |----------|---------|-------------|\n * | `--tbw-tree-toggle-size` | `1.25em` | Toggle icon width |\n * | `--tbw-tree-indent-width` | `var(--tbw-tree-toggle-size)` | Indentation per level |\n * | `--tbw-tree-accent` | `var(--tbw-color-accent)` | Toggle icon hover color |\n * | `--tbw-animation-duration` | `200ms` | Expand/collapse animation duration |\n * | `--tbw-animation-easing` | `ease-out` | Animation curve |\n *\n * @example Basic Tree with Nested Children\n * ```ts\n * import '@toolbox-web/grid';\n * import { TreePlugin } from '@toolbox-web/grid/plugins/tree';\n *\n * const grid = document.querySelector('tbw-grid');\n * grid.gridConfig = {\n *   columns: [\n *     { field: 'name', header: 'Name' },\n *     { field: 'type', header: 'Type' },\n *     { field: 'size', header: 'Size' },\n *   ],\n *   plugins: [new TreePlugin({ childrenField: 'children', indentWidth: 24 })],\n * };\n * grid.rows = [\n *   {\n *     id: 1,\n *     name: 'Documents',\n *     type: 'folder',\n *     children: [\n *       { id: 2, name: 'Report.docx', type: 'file', size: '24 KB' },\n *     ],\n *   },\n * ];\n * ```\n *\n * @example Expanded by Default with Custom Animation\n * ```ts\n * new TreePlugin({\n *   defaultExpanded: true,\n *   animation: 'fade', // 'slide' | 'fade' | false\n *   indentWidth: 32,\n * })\n * ```\n *\n * @see {@link TreeConfig} for all configuration options\n * @see {@link FlattenedTreeRow} for the flattened row structure\n *\n * @internal Extends BaseGridPlugin\n */\nexport class TreePlugin extends BaseGridPlugin<TreeConfig> {\n  static override readonly manifest: PluginManifest = {\n    events: [\n      {\n        type: 'tree-state-change',\n        description: 'Emitted when tree expansion state changes (toggle, expand all, collapse all)',\n      },\n    ],\n    queries: [\n      {\n        type: 'canMoveRow',\n        description: 'Returns false for rows with children (parent nodes cannot be reordered)',\n      },\n    ],\n  };\n\n  /** @internal */\n  readonly name = 'tree';\n  /** @internal */\n  override readonly styles = styles;\n\n  /** @internal */\n  protected override get defaultConfig(): Partial<TreeConfig> {\n    return {\n      childrenField: 'children',\n      autoDetect: true,\n      defaultExpanded: false,\n      indentWidth: 20,\n      showExpandIcons: true,\n      animation: 'slide',\n    };\n  }\n\n  // #region State\n\n  private expandedKeys = new Set<string>();\n  private initialExpansionDone = false;\n  private flattenedRows: FlattenedTreeRow[] = [];\n  private rowKeyMap = new Map<string, FlattenedTreeRow>();\n  private previousVisibleKeys = new Set<string>();\n  private keysToAnimate = new Set<string>();\n  private sortState: { field: string; direction: 1 | -1 } | null = null;\n\n  /** @internal */\n  override detach(): void {\n    this.expandedKeys.clear();\n    this.initialExpansionDone = false;\n    this.flattenedRows = [];\n    this.rowKeyMap.clear();\n    this.previousVisibleKeys.clear();\n    this.keysToAnimate.clear();\n    this.sortState = null;\n  }\n\n  /**\n   * Handle plugin queries.\n   * @internal\n   */\n  override handleQuery(query: PluginQuery): unknown {\n    if (query.type === 'canMoveRow') {\n      // Tree rows with children cannot be reordered\n      const row = query.context as { [key: string]: unknown } | null | undefined;\n      const childrenField = this.config.childrenField ?? 'children';\n      const children = row?.[childrenField];\n      if (Array.isArray(children) && children.length > 0) {\n        return false;\n      }\n    }\n    return undefined;\n  }\n\n  // #endregion\n\n  // #region Animation\n\n  /**\n   * Get expand/collapse animation style from plugin config.\n   * Uses base class isAnimationEnabled to respect grid-level settings.\n   */\n  private get animationStyle(): ExpandCollapseAnimation {\n    if (!this.isAnimationEnabled) return false;\n    return this.config.animation ?? 'slide';\n  }\n\n  // #endregion\n\n  // #region Auto-Detection\n\n  detect(rows: readonly unknown[]): boolean {\n    if (!this.config.autoDetect) return false;\n    const treeRows = rows as readonly TreeRow[];\n    const field = this.config.childrenField ?? inferChildrenField(treeRows) ?? 'children';\n    return detectTreeStructure(treeRows, field);\n  }\n\n  // #endregion\n\n  // #region Data Processing\n\n  /** @internal */\n  override processRows(rows: readonly unknown[]): TreeRow[] {\n    const childrenField = this.config.childrenField ?? 'children';\n    const treeRows = rows as readonly TreeRow[];\n\n    if (!detectTreeStructure(treeRows, childrenField)) {\n      this.flattenedRows = [];\n      this.rowKeyMap.clear();\n      this.previousVisibleKeys.clear();\n      return [...rows] as TreeRow[];\n    }\n\n    // Assign stable keys, then optionally sort\n    let data = this.withStableKeys(treeRows);\n    if (this.sortState) {\n      data = this.sortTree(data, this.sortState.field, this.sortState.direction);\n    }\n\n    // Initialize expansion if needed\n    if (this.config.defaultExpanded && !this.initialExpansionDone) {\n      this.expandedKeys = expandAll(data, this.config);\n      this.initialExpansionDone = true;\n    }\n\n    // Flatten and track animations\n    this.flattenedRows = this.flattenTree(data, this.expandedKeys);\n    this.rowKeyMap.clear();\n    this.keysToAnimate.clear();\n    const currentKeys = new Set<string>();\n\n    for (const row of this.flattenedRows) {\n      this.rowKeyMap.set(row.key, row);\n      currentKeys.add(row.key);\n      if (!this.previousVisibleKeys.has(row.key) && row.depth > 0) {\n        this.keysToAnimate.add(row.key);\n      }\n    }\n    this.previousVisibleKeys = currentKeys;\n\n    return this.flattenedRows.map((r) => ({\n      ...r.data,\n      __treeKey: r.key,\n      __treeDepth: r.depth,\n      __treeHasChildren: r.hasChildren,\n      __treeExpanded: r.isExpanded,\n    }));\n  }\n\n  /** Assign stable keys to rows (preserves key across sort operations) */\n  private withStableKeys(rows: readonly TreeRow[], parentKey: string | null = null): TreeRow[] {\n    const childrenField = this.config.childrenField ?? 'children';\n    return rows.map((row, i) => {\n      const stableKey = row.__stableKey as string | undefined;\n      const key = row.id !== undefined ? String(row.id) : (stableKey ?? (parentKey ? `${parentKey}-${i}` : String(i)));\n      const children = row[childrenField];\n      const hasChildren = Array.isArray(children) && children.length > 0;\n      return {\n        ...row,\n        __stableKey: key,\n        ...(hasChildren ? { [childrenField]: this.withStableKeys(children as TreeRow[], key) } : {}),\n      };\n    });\n  }\n\n  /** Flatten tree using stable keys */\n  private flattenTree(rows: readonly TreeRow[], expanded: Set<string>, depth = 0): FlattenedTreeRow[] {\n    const childrenField = this.config.childrenField ?? 'children';\n    const result: FlattenedTreeRow[] = [];\n\n    for (const row of rows) {\n      const stableKey = row.__stableKey as string | undefined;\n      const key = stableKey ?? String(row.id ?? '?');\n      const children = row[childrenField];\n      const hasChildren = Array.isArray(children) && children.length > 0;\n      const isExpanded = expanded.has(key);\n\n      result.push({\n        key,\n        data: row,\n        depth,\n        hasChildren,\n        isExpanded,\n        parentKey: depth > 0 ? key.substring(0, key.lastIndexOf('-')) || null : null,\n      });\n\n      if (hasChildren && isExpanded) {\n        result.push(...this.flattenTree(children as TreeRow[], expanded, depth + 1));\n      }\n    }\n    return result;\n  }\n\n  /** Sort tree recursively, keeping children with parents */\n  private sortTree(rows: readonly TreeRow[], field: string, dir: 1 | -1): TreeRow[] {\n    const childrenField = this.config.childrenField ?? 'children';\n    const sorted = [...rows].sort((a, b) => {\n      const aVal = a[field],\n        bVal = b[field];\n      if (aVal == null && bVal == null) return 0;\n      if (aVal == null) return -1;\n      if (bVal == null) return 1;\n      return aVal > bVal ? dir : aVal < bVal ? -dir : 0;\n    });\n    return sorted.map((row) => {\n      const children = row[childrenField];\n      return Array.isArray(children) && children.length > 0\n        ? { ...row, [childrenField]: this.sortTree(children as TreeRow[], field, dir) }\n        : row;\n    });\n  }\n\n  /** @internal */\n  override processColumns(columns: readonly ColumnConfig[]): ColumnConfig[] {\n    if (this.flattenedRows.length === 0) return [...columns];\n\n    const cols = [...columns] as ColumnConfig[];\n    if (cols.length === 0) return cols;\n\n    // Wrap the first column's renderer to add tree indentation and expand icons\n    // This is the correct approach for trees because:\n    // 1. Indentation can grow naturally with depth\n    // 2. Expand icons appear inline with content\n    // 3. Works with column reordering (icons stay with first visible column)\n    const firstCol = cols[0];\n    const originalRenderer = firstCol.viewRenderer;\n    const getConfig = () => this.config;\n    const setIcon = this.setIcon.bind(this);\n    const resolveIcon = this.resolveIcon.bind(this);\n\n    const wrappedRenderer: ColumnViewRenderer = (ctx) => {\n      const { row, value } = ctx;\n      const { showExpandIcons = true, indentWidth } = getConfig();\n      const treeRow = row as TreeRow;\n      const depth = treeRow.__treeDepth ?? 0;\n\n      const container = document.createElement('span');\n      container.className = 'tree-cell-wrapper';\n      container.style.setProperty('--tbw-tree-depth', String(depth));\n      // Allow config-based indentWidth to override CSS default\n      if (indentWidth !== undefined) {\n        container.style.setProperty('--tbw-tree-indent-width', `${indentWidth}px`);\n      }\n\n      // Add expand/collapse icon or spacer\n      if (showExpandIcons) {\n        if (treeRow.__treeHasChildren) {\n          const icon = document.createElement('span');\n          icon.className = `tree-toggle${treeRow.__treeExpanded ? ' expanded' : ''}`;\n          setIcon(icon, resolveIcon(treeRow.__treeExpanded ? 'collapse' : 'expand'));\n          icon.setAttribute('data-tree-key', String(treeRow.__treeKey ?? ''));\n          container.appendChild(icon);\n        } else {\n          const spacer = document.createElement('span');\n          spacer.className = 'tree-spacer';\n          container.appendChild(spacer);\n        }\n      }\n\n      // Add the original content\n      const content = document.createElement('span');\n      content.className = 'tree-content';\n      if (originalRenderer) {\n        const result = originalRenderer(ctx);\n        if (result instanceof Node) {\n          content.appendChild(result);\n        } else if (typeof result === 'string') {\n          content.innerHTML = result;\n        }\n      } else {\n        content.textContent = value != null ? String(value) : '';\n      }\n      container.appendChild(content);\n\n      return container;\n    };\n\n    cols[0] = { ...firstCol, viewRenderer: wrappedRenderer };\n    return cols;\n  }\n\n  // #endregion\n\n  // #region Event Handlers\n\n  /** @internal */\n  override onCellClick(event: CellClickEvent): boolean {\n    const target = event.originalEvent?.target as HTMLElement;\n    if (!target?.classList.contains('tree-toggle')) return false;\n\n    const key = target.getAttribute('data-tree-key');\n    if (!key) return false;\n\n    const flatRow = this.rowKeyMap.get(key);\n    if (!flatRow) return false;\n\n    this.expandedKeys = toggleExpand(this.expandedKeys, key);\n    this.emit<TreeExpandDetail>('tree-expand', {\n      key,\n      row: flatRow.data,\n      expanded: this.expandedKeys.has(key),\n      depth: flatRow.depth,\n    });\n    this.requestRender();\n    return true;\n  }\n\n  /** @internal */\n  override onKeyDown(event: KeyboardEvent): boolean | void {\n    // SPACE toggles expansion when on a row with children\n    if (event.key !== ' ') return;\n\n    const focusRow = this.grid._focusRow;\n    const flatRow = this.flattenedRows[focusRow];\n    if (!flatRow?.hasChildren) return;\n\n    event.preventDefault();\n    this.expandedKeys = toggleExpand(this.expandedKeys, flatRow.key);\n    this.emit<TreeExpandDetail>('tree-expand', {\n      key: flatRow.key,\n      row: flatRow.data,\n      expanded: this.expandedKeys.has(flatRow.key),\n      depth: flatRow.depth,\n    });\n    this.requestRenderWithFocus();\n    return true;\n  }\n\n  /** @internal */\n  override onHeaderClick(event: HeaderClickEvent): boolean {\n    if (this.flattenedRows.length === 0 || !event.column.sortable) return false;\n\n    const { field } = event.column;\n    if (!this.sortState || this.sortState.field !== field) {\n      this.sortState = { field, direction: 1 };\n    } else if (this.sortState.direction === 1) {\n      this.sortState = { field, direction: -1 };\n    } else {\n      this.sortState = null;\n    }\n\n    // Sync grid sort indicator\n    const gridEl = this.grid as unknown as GridHost;\n    if (gridEl._sortState !== undefined) {\n      gridEl._sortState = this.sortState ? { ...this.sortState } : null;\n    }\n\n    this.emit('sort-change', { field, direction: this.sortState?.direction ?? 0 });\n    this.requestRender();\n    return true;\n  }\n\n  /** @internal */\n  override afterRender(): void {\n    const body = this.gridElement?.querySelector('.rows');\n    if (!body) return;\n\n    const style = this.animationStyle;\n    const shouldAnimate = style !== false && this.keysToAnimate.size > 0;\n    const animClass = style === 'fade' ? 'tbw-tree-fade-in' : 'tbw-tree-slide-in';\n\n    for (const rowEl of body.querySelectorAll('.data-grid-row')) {\n      const cell = rowEl.querySelector('.cell[data-row]');\n      const idx = cell ? parseInt(cell.getAttribute('data-row') ?? '-1', 10) : -1;\n      const treeRow = this.flattenedRows[idx];\n\n      // Set aria-expanded on parent rows for screen readers\n      if (treeRow?.hasChildren) {\n        rowEl.setAttribute('aria-expanded', String(treeRow.isExpanded));\n      }\n\n      if (shouldAnimate && treeRow?.key && this.keysToAnimate.has(treeRow.key)) {\n        rowEl.classList.add(animClass);\n        rowEl.addEventListener('animationend', () => rowEl.classList.remove(animClass), { once: true });\n      }\n    }\n    this.keysToAnimate.clear();\n  }\n\n  // #endregion\n\n  // #region Public API\n\n  expand(key: string): void {\n    this.expandedKeys.add(key);\n    this.requestRender();\n  }\n\n  collapse(key: string): void {\n    this.expandedKeys.delete(key);\n    this.requestRender();\n  }\n\n  toggle(key: string): void {\n    this.expandedKeys = toggleExpand(this.expandedKeys, key);\n    this.emitPluginEvent('tree-state-change', { expandedKeys: [...this.expandedKeys] });\n    this.requestRender();\n  }\n\n  expandAll(): void {\n    this.expandedKeys = expandAll(this.rows as TreeRow[], this.config);\n    this.emitPluginEvent('tree-state-change', { expandedKeys: [...this.expandedKeys] });\n    this.requestRender();\n  }\n\n  collapseAll(): void {\n    this.expandedKeys = collapseAll();\n    this.emitPluginEvent('tree-state-change', { expandedKeys: [...this.expandedKeys] });\n    this.requestRender();\n  }\n\n  isExpanded(key: string): boolean {\n    return this.expandedKeys.has(key);\n  }\n\n  getExpandedKeys(): string[] {\n    return [...this.expandedKeys];\n  }\n\n  getFlattenedRows(): FlattenedTreeRow[] {\n    return [...this.flattenedRows];\n  }\n\n  getRowByKey(key: string): TreeRow | undefined {\n    return this.rowKeyMap.get(key)?.data;\n  }\n\n  expandToKey(key: string): void {\n    this.expandedKeys = expandToKey(this.rows as TreeRow[], key, this.config, this.expandedKeys);\n    this.requestRender();\n  }\n\n  // #endregion\n}\n"],"names":["generateRowKey","row","index","parentKey","id","String","toggleExpand","expandedKeys","key","newExpanded","Set","has","delete","add","expandAll","rows","config","depth","childrenField","keys","i","length","children","Array","isArray","childKeys","k","getPathToKey","targetKey","childPath","expandToKey","existingExpanded","path","detectTreeStructure","TreePlugin","BaseGridPlugin","static","events","type","description","queries","name","styles","defaultConfig","autoDetect","defaultExpanded","indentWidth","showExpandIcons","animation","initialExpansionDone","flattenedRows","rowKeyMap","Map","previousVisibleKeys","keysToAnimate","sortState","detach","this","clear","handleQuery","query","context","animationStyle","isAnimationEnabled","detect","treeRows","field","commonArrayFields","value","inferChildrenField","processRows","data","withStableKeys","sortTree","direction","flattenTree","currentKeys","set","map","r","__treeKey","__treeDepth","__treeHasChildren","hasChildren","__treeExpanded","isExpanded","stableKey","__stableKey","expanded","result","push","substring","lastIndexOf","dir","sort","a","b","aVal","bVal","processColumns","columns","cols","firstCol","originalRenderer","viewRenderer","getConfig","setIcon","bind","resolveIcon","ctx","treeRow","container","document","createElement","className","style","setProperty","icon","setAttribute","appendChild","spacer","content","Node","innerHTML","textContent","onCellClick","event","target","originalEvent","classList","contains","getAttribute","flatRow","get","emit","requestRender","onKeyDown","focusRow","grid","_focusRow","preventDefault","requestRenderWithFocus","onHeaderClick","column","sortable","gridEl","_sortState","afterRender","body","gridElement","querySelector","shouldAnimate","size","animClass","rowEl","querySelectorAll","cell","idx","parseInt","addEventListener","remove","once","expand","collapse","toggle","emitPluginEvent","collapseAll","getExpandedKeys","getFlattenedRows","getRowByKey"],"mappings":"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"}
+{"version":3,"file":"tree.umd.js","sources":["../../../../../libs/grid/src/lib/plugins/tree/tree-data.ts","../../../../../libs/grid/src/lib/plugins/tree/tree-detect.ts","../../../../../libs/grid/src/lib/plugins/tree/TreePlugin.ts"],"sourcesContent":["/**\n * Core Tree Data Logic\n *\n * Pure functions for tree flattening, expansion, and traversal.\n */\n\nimport type { FlattenedTreeRow, TreeConfig, TreeRow } from './types';\n\n/**\n * Generates a unique key for a row.\n * Uses row.id if available, otherwise generates from path.\n */\nexport function generateRowKey(row: TreeRow, index: number, parentKey: string | null): string {\n  if (row.id !== undefined) return String(row.id);\n  return parentKey ? `${parentKey}-${index}` : String(index);\n}\n\n/**\n * Flattens a hierarchical tree into a flat array of rows with metadata.\n * Only includes children of expanded nodes.\n */\nexport function flattenTree(\n  rows: readonly TreeRow[],\n  config: TreeConfig,\n  expandedKeys: Set<string>,\n  parentKey: string | null = null,\n  depth = 0,\n): FlattenedTreeRow[] {\n  const childrenField = config.childrenField ?? 'children';\n  const result: FlattenedTreeRow[] = [];\n\n  for (let i = 0; i < rows.length; i++) {\n    const row = rows[i];\n    const key = generateRowKey(row, i, parentKey);\n    const children = row[childrenField];\n    const hasChildren = Array.isArray(children) && children.length > 0;\n    const isExpanded = expandedKeys.has(key);\n\n    result.push({\n      key,\n      data: row,\n      depth,\n      hasChildren,\n      isExpanded,\n      parentKey,\n    });\n\n    // Recursively add children if expanded\n    if (hasChildren && isExpanded) {\n      const childRows = flattenTree(children as TreeRow[], config, expandedKeys, key, depth + 1);\n      result.push(...childRows);\n    }\n  }\n\n  return result;\n}\n\n/**\n * Toggles the expansion state of a row.\n * Returns a new Set with the toggled state.\n */\nexport function toggleExpand(expandedKeys: Set<string>, key: string): Set<string> {\n  const newExpanded = new Set(expandedKeys);\n  if (newExpanded.has(key)) {\n    newExpanded.delete(key);\n  } else {\n    newExpanded.add(key);\n  }\n  return newExpanded;\n}\n\n/**\n * Expands all nodes in the tree.\n * Returns a Set of all parent row keys.\n */\nexport function expandAll(\n  rows: readonly TreeRow[],\n  config: TreeConfig,\n  parentKey: string | null = null,\n  depth = 0,\n): Set<string> {\n  const childrenField = config.childrenField ?? 'children';\n  const keys = new Set<string>();\n\n  for (let i = 0; i < rows.length; i++) {\n    const row = rows[i];\n    const key = generateRowKey(row, i, parentKey);\n    const children = row[childrenField];\n\n    if (Array.isArray(children) && children.length > 0) {\n      keys.add(key);\n      const childKeys = expandAll(children as TreeRow[], config, key, depth + 1);\n      for (const k of childKeys) keys.add(k);\n    }\n  }\n\n  return keys;\n}\n\n/**\n * Collapses all nodes.\n * Returns an empty Set.\n */\nexport function collapseAll(): Set<string> {\n  return new Set();\n}\n\n/**\n * Gets all descendants of a node from the flattened row list.\n * Useful for operations that need to affect an entire subtree.\n */\nexport function getDescendants(flattenedRows: FlattenedTreeRow[], parentKey: string): FlattenedTreeRow[] {\n  const descendants: FlattenedTreeRow[] = [];\n  let collecting = false;\n  let parentDepth = -1;\n\n  for (const row of flattenedRows) {\n    if (row.key === parentKey) {\n      collecting = true;\n      parentDepth = row.depth;\n      continue;\n    }\n\n    if (collecting) {\n      if (row.depth > parentDepth) {\n        descendants.push(row);\n      } else {\n        break; // No longer a descendant\n      }\n    }\n  }\n\n  return descendants;\n}\n\n/**\n * Finds the path from root to a specific row key.\n * Returns an array of keys from root to the target (inclusive).\n */\nexport function getPathToKey(\n  rows: readonly TreeRow[],\n  targetKey: string,\n  config: TreeConfig,\n  parentKey: string | null = null,\n  depth = 0,\n): string[] | null {\n  const childrenField = config.childrenField ?? 'children';\n\n  for (let i = 0; i < rows.length; i++) {\n    const row = rows[i];\n    const key = generateRowKey(row, i, parentKey);\n\n    if (key === targetKey) {\n      return [key];\n    }\n\n    const children = row[childrenField];\n    if (Array.isArray(children) && children.length > 0) {\n      const childPath = getPathToKey(children as TreeRow[], targetKey, config, key, depth + 1);\n      if (childPath) {\n        return [key, ...childPath];\n      }\n    }\n  }\n\n  return null;\n}\n\n/**\n * Expands all ancestors of a specific row to make it visible.\n * Returns a new Set with the required keys added.\n */\nexport function expandToKey(\n  rows: readonly TreeRow[],\n  targetKey: string,\n  config: TreeConfig,\n  existingExpanded: Set<string>,\n): Set<string> {\n  const path = getPathToKey(rows, targetKey, config);\n  if (!path) return existingExpanded;\n\n  const newExpanded = new Set(existingExpanded);\n  // Add all keys except the last one (the target itself)\n  for (let i = 0; i < path.length - 1; i++) {\n    newExpanded.add(path[i]);\n  }\n  return newExpanded;\n}\n","/**\n * Tree Structure Auto-Detection\n *\n * Utilities for detecting hierarchical tree data structures.\n */\n\nimport type { TreeRow } from './types';\n\n/**\n * Detects if the data has a tree structure by checking for children arrays.\n */\nexport function detectTreeStructure(rows: readonly TreeRow[], childrenField = 'children'): boolean {\n  if (!Array.isArray(rows) || rows.length === 0) return false;\n\n  // Check if any row has a non-empty children array\n  for (const row of rows) {\n    if (!row) continue;\n    const children = row[childrenField];\n    if (Array.isArray(children) && children.length > 0) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Attempts to infer the children field name from common patterns.\n * Returns the first field that contains an array with items.\n */\nexport function inferChildrenField(rows: readonly TreeRow[]): string | null {\n  if (!Array.isArray(rows) || rows.length === 0) return null;\n\n  const commonArrayFields = ['children', 'items', 'nodes', 'subRows', 'nested'];\n\n  for (const row of rows) {\n    if (!row || typeof row !== 'object') continue;\n\n    for (const field of commonArrayFields) {\n      const value = row[field];\n      if (Array.isArray(value) && value.length > 0) {\n        return field;\n      }\n    }\n  }\n\n  return null;\n}\n\n/**\n * Calculates the maximum depth of the tree.\n * Useful for layout calculations and virtualization.\n */\nexport function getMaxDepth(rows: readonly TreeRow[], childrenField = 'children', currentDepth = 0): number {\n  if (!Array.isArray(rows) || rows.length === 0) return currentDepth;\n\n  let maxDepth = currentDepth;\n\n  for (const row of rows) {\n    if (!row) continue;\n    const children = row[childrenField];\n    if (Array.isArray(children) && children.length > 0) {\n      const childDepth = getMaxDepth(children as TreeRow[], childrenField, currentDepth + 1);\n      if (childDepth > maxDepth) {\n        maxDepth = childDepth;\n      }\n    }\n  }\n\n  return maxDepth;\n}\n\n/**\n * Counts total nodes in the tree (including all descendants).\n */\nexport function countNodes(rows: readonly TreeRow[], childrenField = 'children'): number {\n  if (!Array.isArray(rows)) return 0;\n\n  let count = 0;\n  for (const row of rows) {\n    if (!row) continue;\n    count++;\n    const children = row[childrenField];\n    if (Array.isArray(children)) {\n      count += countNodes(children as TreeRow[], childrenField);\n    }\n  }\n\n  return count;\n}\n","/**\n * Tree Data Plugin\n *\n * Enables hierarchical tree data with expand/collapse, sorting, and auto-detection.\n */\n\nimport {\n  BaseGridPlugin,\n  CellClickEvent,\n  HeaderClickEvent,\n  type PluginManifest,\n  type PluginQuery,\n} from '../../core/plugin/base-plugin';\nimport type { ColumnConfig, ColumnViewRenderer, GridHost } from '../../core/types';\nimport { collapseAll, expandAll, expandToKey, toggleExpand } from './tree-data';\nimport { detectTreeStructure, inferChildrenField } from './tree-detect';\nimport styles from './tree.css?inline';\nimport type { ExpandCollapseAnimation, FlattenedTreeRow, TreeConfig, TreeExpandDetail, TreeRow } from './types';\n\n/**\n * Tree Data Plugin for tbw-grid\n *\n * Transforms your flat grid into a hierarchical tree view with expandable parent-child\n * relationships. Ideal for file explorers, organizational charts, nested categories,\n * or any data with a natural hierarchy.\n *\n * ## Installation\n *\n * ```ts\n * import { TreePlugin } from '@toolbox-web/grid/plugins/tree';\n * ```\n *\n * ## Configuration Options\n *\n * | Option | Type | Default | Description |\n * |--------|------|---------|-------------|\n * | `childrenField` | `string` | `'children'` | Field containing child array |\n * | `autoDetect` | `boolean` | `true` | Auto-detect tree structure from data |\n * | `defaultExpanded` | `boolean` | `false` | Expand all nodes initially |\n * | `indentWidth` | `number` | `20` | Indentation per level (pixels) |\n * | `showExpandIcons` | `boolean` | `true` | Show expand/collapse toggle icons |\n * | `animation` | `false \\| 'slide' \\| 'fade'` | `'slide'` | Animation style for expand/collapse |\n *\n * ## Programmatic API\n *\n * | Method | Signature | Description |\n * |--------|-----------|-------------|\n * | `expand` | `(nodeId) => void` | Expand a specific node |\n * | `collapse` | `(nodeId) => void` | Collapse a specific node |\n * | `toggle` | `(nodeId) => void` | Toggle a node's expanded state |\n * | `expandAll` | `() => void` | Expand all nodes |\n * | `collapseAll` | `() => void` | Collapse all nodes |\n * | `getExpandedNodes` | `() => Set<string>` | Get currently expanded node keys |\n *\n * ## CSS Custom Properties\n *\n * | Property | Default | Description |\n * |----------|---------|-------------|\n * | `--tbw-tree-toggle-size` | `1.25em` | Toggle icon width |\n * | `--tbw-tree-indent-width` | `var(--tbw-tree-toggle-size)` | Indentation per level |\n * | `--tbw-tree-accent` | `var(--tbw-color-accent)` | Toggle icon hover color |\n * | `--tbw-animation-duration` | `200ms` | Expand/collapse animation duration |\n * | `--tbw-animation-easing` | `ease-out` | Animation curve |\n *\n * @example Basic Tree with Nested Children\n * ```ts\n * import { queryGrid } from '@toolbox-web/grid';\n * import { TreePlugin } from '@toolbox-web/grid/plugins/tree';\n *\n * const grid = queryGrid('tbw-grid');\n * grid.gridConfig = {\n *   columns: [\n *     { field: 'name', header: 'Name' },\n *     { field: 'type', header: 'Type' },\n *     { field: 'size', header: 'Size' },\n *   ],\n *   plugins: [new TreePlugin({ childrenField: 'children', indentWidth: 24 })],\n * };\n * grid.rows = [\n *   {\n *     id: 1,\n *     name: 'Documents',\n *     type: 'folder',\n *     children: [\n *       { id: 2, name: 'Report.docx', type: 'file', size: '24 KB' },\n *     ],\n *   },\n * ];\n * ```\n *\n * @example Expanded by Default with Custom Animation\n * ```ts\n * new TreePlugin({\n *   defaultExpanded: true,\n *   animation: 'fade', // 'slide' | 'fade' | false\n *   indentWidth: 32,\n * })\n * ```\n *\n * @see {@link TreeConfig} for all configuration options\n * @see {@link FlattenedTreeRow} for the flattened row structure\n *\n * @internal Extends BaseGridPlugin\n */\nexport class TreePlugin extends BaseGridPlugin<TreeConfig> {\n  static override readonly manifest: PluginManifest = {\n    events: [\n      {\n        type: 'tree-state-change',\n        description: 'Emitted when tree expansion state changes (toggle, expand all, collapse all)',\n      },\n    ],\n    queries: [\n      {\n        type: 'canMoveRow',\n        description: 'Returns false for rows with children (parent nodes cannot be reordered)',\n      },\n    ],\n  };\n\n  /** @internal */\n  readonly name = 'tree';\n  /** @internal */\n  override readonly styles = styles;\n\n  /** @internal */\n  protected override get defaultConfig(): Partial<TreeConfig> {\n    return {\n      childrenField: 'children',\n      autoDetect: true,\n      defaultExpanded: false,\n      indentWidth: 20,\n      showExpandIcons: true,\n      animation: 'slide',\n    };\n  }\n\n  // #region State\n\n  private expandedKeys = new Set<string>();\n  private initialExpansionDone = false;\n  private flattenedRows: FlattenedTreeRow[] = [];\n  private rowKeyMap = new Map<string, FlattenedTreeRow>();\n  private previousVisibleKeys = new Set<string>();\n  private keysToAnimate = new Set<string>();\n  private sortState: { field: string; direction: 1 | -1 } | null = null;\n\n  /** @internal */\n  override detach(): void {\n    this.expandedKeys.clear();\n    this.initialExpansionDone = false;\n    this.flattenedRows = [];\n    this.rowKeyMap.clear();\n    this.previousVisibleKeys.clear();\n    this.keysToAnimate.clear();\n    this.sortState = null;\n  }\n\n  /**\n   * Handle plugin queries.\n   * @internal\n   */\n  override handleQuery(query: PluginQuery): unknown {\n    if (query.type === 'canMoveRow') {\n      // Tree rows with children cannot be reordered\n      const row = query.context as { [key: string]: unknown } | null | undefined;\n      const childrenField = this.config.childrenField ?? 'children';\n      const children = row?.[childrenField];\n      if (Array.isArray(children) && children.length > 0) {\n        return false;\n      }\n    }\n    return undefined;\n  }\n\n  // #endregion\n\n  // #region Animation\n\n  /**\n   * Get expand/collapse animation style from plugin config.\n   * Uses base class isAnimationEnabled to respect grid-level settings.\n   */\n  private get animationStyle(): ExpandCollapseAnimation {\n    if (!this.isAnimationEnabled) return false;\n    return this.config.animation ?? 'slide';\n  }\n\n  // #endregion\n\n  // #region Auto-Detection\n\n  detect(rows: readonly unknown[]): boolean {\n    if (!this.config.autoDetect) return false;\n    const treeRows = rows as readonly TreeRow[];\n    const field = this.config.childrenField ?? inferChildrenField(treeRows) ?? 'children';\n    return detectTreeStructure(treeRows, field);\n  }\n\n  // #endregion\n\n  // #region Data Processing\n\n  /** @internal */\n  override processRows(rows: readonly unknown[]): TreeRow[] {\n    const childrenField = this.config.childrenField ?? 'children';\n    const treeRows = rows as readonly TreeRow[];\n\n    if (!detectTreeStructure(treeRows, childrenField)) {\n      this.flattenedRows = [];\n      this.rowKeyMap.clear();\n      this.previousVisibleKeys.clear();\n      return [...rows] as TreeRow[];\n    }\n\n    // Assign stable keys, then optionally sort\n    let data = this.withStableKeys(treeRows);\n    if (this.sortState) {\n      data = this.sortTree(data, this.sortState.field, this.sortState.direction);\n    }\n\n    // Initialize expansion if needed\n    if (this.config.defaultExpanded && !this.initialExpansionDone) {\n      this.expandedKeys = expandAll(data, this.config);\n      this.initialExpansionDone = true;\n    }\n\n    // Flatten and track animations\n    this.flattenedRows = this.flattenTree(data, this.expandedKeys);\n    this.rowKeyMap.clear();\n    this.keysToAnimate.clear();\n    const currentKeys = new Set<string>();\n\n    for (const row of this.flattenedRows) {\n      this.rowKeyMap.set(row.key, row);\n      currentKeys.add(row.key);\n      if (!this.previousVisibleKeys.has(row.key) && row.depth > 0) {\n        this.keysToAnimate.add(row.key);\n      }\n    }\n    this.previousVisibleKeys = currentKeys;\n\n    return this.flattenedRows.map((r) => ({\n      ...r.data,\n      __treeKey: r.key,\n      __treeDepth: r.depth,\n      __treeHasChildren: r.hasChildren,\n      __treeExpanded: r.isExpanded,\n    }));\n  }\n\n  /** Assign stable keys to rows (preserves key across sort operations) */\n  private withStableKeys(rows: readonly TreeRow[], parentKey: string | null = null): TreeRow[] {\n    const childrenField = this.config.childrenField ?? 'children';\n    return rows.map((row, i) => {\n      const stableKey = row.__stableKey as string | undefined;\n      const key = row.id !== undefined ? String(row.id) : (stableKey ?? (parentKey ? `${parentKey}-${i}` : String(i)));\n      const children = row[childrenField];\n      const hasChildren = Array.isArray(children) && children.length > 0;\n      return {\n        ...row,\n        __stableKey: key,\n        ...(hasChildren ? { [childrenField]: this.withStableKeys(children as TreeRow[], key) } : {}),\n      };\n    });\n  }\n\n  /** Flatten tree using stable keys */\n  private flattenTree(rows: readonly TreeRow[], expanded: Set<string>, depth = 0): FlattenedTreeRow[] {\n    const childrenField = this.config.childrenField ?? 'children';\n    const result: FlattenedTreeRow[] = [];\n\n    for (const row of rows) {\n      const stableKey = row.__stableKey as string | undefined;\n      const key = stableKey ?? String(row.id ?? '?');\n      const children = row[childrenField];\n      const hasChildren = Array.isArray(children) && children.length > 0;\n      const isExpanded = expanded.has(key);\n\n      result.push({\n        key,\n        data: row,\n        depth,\n        hasChildren,\n        isExpanded,\n        parentKey: depth > 0 ? key.substring(0, key.lastIndexOf('-')) || null : null,\n      });\n\n      if (hasChildren && isExpanded) {\n        result.push(...this.flattenTree(children as TreeRow[], expanded, depth + 1));\n      }\n    }\n    return result;\n  }\n\n  /** Sort tree recursively, keeping children with parents */\n  private sortTree(rows: readonly TreeRow[], field: string, dir: 1 | -1): TreeRow[] {\n    const childrenField = this.config.childrenField ?? 'children';\n    const sorted = [...rows].sort((a, b) => {\n      const aVal = a[field],\n        bVal = b[field];\n      if (aVal == null && bVal == null) return 0;\n      if (aVal == null) return -1;\n      if (bVal == null) return 1;\n      return aVal > bVal ? dir : aVal < bVal ? -dir : 0;\n    });\n    return sorted.map((row) => {\n      const children = row[childrenField];\n      return Array.isArray(children) && children.length > 0\n        ? { ...row, [childrenField]: this.sortTree(children as TreeRow[], field, dir) }\n        : row;\n    });\n  }\n\n  /** @internal */\n  override processColumns(columns: readonly ColumnConfig[]): ColumnConfig[] {\n    if (this.flattenedRows.length === 0) return [...columns];\n\n    const cols = [...columns] as ColumnConfig[];\n    if (cols.length === 0) return cols;\n\n    // Wrap the first column's renderer to add tree indentation and expand icons\n    // This is the correct approach for trees because:\n    // 1. Indentation can grow naturally with depth\n    // 2. Expand icons appear inline with content\n    // 3. Works with column reordering (icons stay with first visible column)\n    const firstCol = cols[0];\n    const originalRenderer = firstCol.viewRenderer;\n    const getConfig = () => this.config;\n    const setIcon = this.setIcon.bind(this);\n    const resolveIcon = this.resolveIcon.bind(this);\n\n    const wrappedRenderer: ColumnViewRenderer = (ctx) => {\n      const { row, value } = ctx;\n      const { showExpandIcons = true, indentWidth } = getConfig();\n      const treeRow = row as TreeRow;\n      const depth = treeRow.__treeDepth ?? 0;\n\n      const container = document.createElement('span');\n      container.className = 'tree-cell-wrapper';\n      container.style.setProperty('--tbw-tree-depth', String(depth));\n      // Allow config-based indentWidth to override CSS default\n      if (indentWidth !== undefined) {\n        container.style.setProperty('--tbw-tree-indent-width', `${indentWidth}px`);\n      }\n\n      // Add expand/collapse icon or spacer\n      if (showExpandIcons) {\n        if (treeRow.__treeHasChildren) {\n          const icon = document.createElement('span');\n          icon.className = `tree-toggle${treeRow.__treeExpanded ? ' expanded' : ''}`;\n          setIcon(icon, resolveIcon(treeRow.__treeExpanded ? 'collapse' : 'expand'));\n          icon.setAttribute('data-tree-key', String(treeRow.__treeKey ?? ''));\n          container.appendChild(icon);\n        } else {\n          const spacer = document.createElement('span');\n          spacer.className = 'tree-spacer';\n          container.appendChild(spacer);\n        }\n      }\n\n      // Add the original content\n      const content = document.createElement('span');\n      content.className = 'tree-content';\n      if (originalRenderer) {\n        const result = originalRenderer(ctx);\n        if (result instanceof Node) {\n          content.appendChild(result);\n        } else if (typeof result === 'string') {\n          content.innerHTML = result;\n        }\n      } else {\n        content.textContent = value != null ? String(value) : '';\n      }\n      container.appendChild(content);\n\n      return container;\n    };\n\n    cols[0] = { ...firstCol, viewRenderer: wrappedRenderer };\n    return cols;\n  }\n\n  // #endregion\n\n  // #region Event Handlers\n\n  /** @internal */\n  override onCellClick(event: CellClickEvent): boolean {\n    const target = event.originalEvent?.target as HTMLElement;\n    if (!target?.classList.contains('tree-toggle')) return false;\n\n    const key = target.getAttribute('data-tree-key');\n    if (!key) return false;\n\n    const flatRow = this.rowKeyMap.get(key);\n    if (!flatRow) return false;\n\n    this.expandedKeys = toggleExpand(this.expandedKeys, key);\n    this.emit<TreeExpandDetail>('tree-expand', {\n      key,\n      row: flatRow.data,\n      expanded: this.expandedKeys.has(key),\n      depth: flatRow.depth,\n    });\n    this.requestRender();\n    return true;\n  }\n\n  /** @internal */\n  override onKeyDown(event: KeyboardEvent): boolean | void {\n    // SPACE toggles expansion when on a row with children\n    if (event.key !== ' ') return;\n\n    const focusRow = this.grid._focusRow;\n    const flatRow = this.flattenedRows[focusRow];\n    if (!flatRow?.hasChildren) return;\n\n    event.preventDefault();\n    this.expandedKeys = toggleExpand(this.expandedKeys, flatRow.key);\n    this.emit<TreeExpandDetail>('tree-expand', {\n      key: flatRow.key,\n      row: flatRow.data,\n      expanded: this.expandedKeys.has(flatRow.key),\n      depth: flatRow.depth,\n    });\n    this.requestRenderWithFocus();\n    return true;\n  }\n\n  /** @internal */\n  override onHeaderClick(event: HeaderClickEvent): boolean {\n    if (this.flattenedRows.length === 0 || !event.column.sortable) return false;\n\n    const { field } = event.column;\n    if (!this.sortState || this.sortState.field !== field) {\n      this.sortState = { field, direction: 1 };\n    } else if (this.sortState.direction === 1) {\n      this.sortState = { field, direction: -1 };\n    } else {\n      this.sortState = null;\n    }\n\n    // Sync grid sort indicator\n    const gridEl = this.grid as unknown as GridHost;\n    if (gridEl._sortState !== undefined) {\n      gridEl._sortState = this.sortState ? { ...this.sortState } : null;\n    }\n\n    this.emit('sort-change', { field, direction: this.sortState?.direction ?? 0 });\n    this.requestRender();\n    return true;\n  }\n\n  /** @internal */\n  override afterRender(): void {\n    const body = this.gridElement?.querySelector('.rows');\n    if (!body) return;\n\n    const style = this.animationStyle;\n    const shouldAnimate = style !== false && this.keysToAnimate.size > 0;\n    const animClass = style === 'fade' ? 'tbw-tree-fade-in' : 'tbw-tree-slide-in';\n\n    for (const rowEl of body.querySelectorAll('.data-grid-row')) {\n      const cell = rowEl.querySelector('.cell[data-row]');\n      const idx = cell ? parseInt(cell.getAttribute('data-row') ?? '-1', 10) : -1;\n      const treeRow = this.flattenedRows[idx];\n\n      // Set aria-expanded on parent rows for screen readers\n      if (treeRow?.hasChildren) {\n        rowEl.setAttribute('aria-expanded', String(treeRow.isExpanded));\n      }\n\n      if (shouldAnimate && treeRow?.key && this.keysToAnimate.has(treeRow.key)) {\n        rowEl.classList.add(animClass);\n        rowEl.addEventListener('animationend', () => rowEl.classList.remove(animClass), { once: true });\n      }\n    }\n    this.keysToAnimate.clear();\n  }\n\n  // #endregion\n\n  // #region Public API\n\n  expand(key: string): void {\n    this.expandedKeys.add(key);\n    this.requestRender();\n  }\n\n  collapse(key: string): void {\n    this.expandedKeys.delete(key);\n    this.requestRender();\n  }\n\n  toggle(key: string): void {\n    this.expandedKeys = toggleExpand(this.expandedKeys, key);\n    this.emitPluginEvent('tree-state-change', { expandedKeys: [...this.expandedKeys] });\n    this.requestRender();\n  }\n\n  expandAll(): void {\n    this.expandedKeys = expandAll(this.rows as TreeRow[], this.config);\n    this.emitPluginEvent('tree-state-change', { expandedKeys: [...this.expandedKeys] });\n    this.requestRender();\n  }\n\n  collapseAll(): void {\n    this.expandedKeys = collapseAll();\n    this.emitPluginEvent('tree-state-change', { expandedKeys: [...this.expandedKeys] });\n    this.requestRender();\n  }\n\n  isExpanded(key: string): boolean {\n    return this.expandedKeys.has(key);\n  }\n\n  getExpandedKeys(): string[] {\n    return [...this.expandedKeys];\n  }\n\n  getFlattenedRows(): FlattenedTreeRow[] {\n    return [...this.flattenedRows];\n  }\n\n  getRowByKey(key: string): TreeRow | undefined {\n    return this.rowKeyMap.get(key)?.data;\n  }\n\n  expandToKey(key: string): void {\n    this.expandedKeys = expandToKey(this.rows as TreeRow[], key, this.config, this.expandedKeys);\n    this.requestRender();\n  }\n\n  // #endregion\n}\n"],"names":["generateRowKey","row","index","parentKey","id","String","toggleExpand","expandedKeys","key","newExpanded","Set","has","delete","add","expandAll","rows","config","depth","childrenField","keys","i","length","children","Array","isArray","childKeys","k","getPathToKey","targetKey","childPath","expandToKey","existingExpanded","path","detectTreeStructure","TreePlugin","BaseGridPlugin","static","events","type","description","queries","name","styles","defaultConfig","autoDetect","defaultExpanded","indentWidth","showExpandIcons","animation","initialExpansionDone","flattenedRows","rowKeyMap","Map","previousVisibleKeys","keysToAnimate","sortState","detach","this","clear","handleQuery","query","context","animationStyle","isAnimationEnabled","detect","treeRows","field","commonArrayFields","value","inferChildrenField","processRows","data","withStableKeys","sortTree","direction","flattenTree","currentKeys","set","map","r","__treeKey","__treeDepth","__treeHasChildren","hasChildren","__treeExpanded","isExpanded","stableKey","__stableKey","expanded","result","push","substring","lastIndexOf","dir","sort","a","b","aVal","bVal","processColumns","columns","cols","firstCol","originalRenderer","viewRenderer","getConfig","setIcon","bind","resolveIcon","ctx","treeRow","container","document","createElement","className","style","setProperty","icon","setAttribute","appendChild","spacer","content","Node","innerHTML","textContent","onCellClick","event","target","originalEvent","classList","contains","getAttribute","flatRow","get","emit","requestRender","onKeyDown","focusRow","grid","_focusRow","preventDefault","requestRenderWithFocus","onHeaderClick","column","sortable","gridEl","_sortState","afterRender","body","gridElement","querySelector","shouldAnimate","size","animClass","rowEl","querySelectorAll","cell","idx","parseInt","addEventListener","remove","once","expand","collapse","toggle","emitPluginEvent","collapseAll","getExpandedKeys","getFlattenedRows","getRowByKey"],"mappings":"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"}