@toolbox-web/grid 1.6.2 → 1.8.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 { PluginManifest } from '../../core/plugin/base-plugin';\nimport { BaseGridPlugin, CellClickEvent, CellMouseEvent } from '../../core/plugin/base-plugin';\nimport { isUtilityColumn } from '../../core/plugin/expander-column';\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/**\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    const ranges = [...state.selected].map((rowIndex) => ({\n      from: { row: rowIndex, col: 0 },\n      to: { row: rowIndex, col: colCount - 1 },\n    }));\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 * ## 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.addEventListener('selection-change', (e) => {\n *   const { mode, ranges } = e.detail;\n *   console.log(`Selected ${ranges.length} ranges in ${mode} mode`);\n * });\n * ```\n *\n * @example Programmatic selection control\n * ```ts\n * const plugin = grid.getPlugin(SelectionPlugin);\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 configuration validation rules.\n   * @internal\n   */\n  static override readonly manifest: PluginManifest<SelectionConfig> = {\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    };\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  // #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    const column = colIndex !== undefined ? this.columns[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 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  }\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    const column = this.columns[colIndex];\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: Select entire row - utility column clicks still select the row\n    if (mode === 'row') {\n      if (!this.isRowSelectable(rowIndex)) {\n        return false; // Row is not selectable\n      }\n      // Only emit if selection actually changed\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.lastSelected = rowIndex;\n\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;\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    if (event.key === 'Escape') {\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: Only Up/Down arrows move row selection (but respects selectability)\n    if (mode === 'row' && (event.key === 'ArrowUp' || event.key === 'ArrowDown')) {\n      // Let grid move focus first, then sync row selection\n      queueMicrotask(() => {\n        const focusRow = this.grid._focusRow;\n        // Only select if the row is selectable\n        if (this.isRowSelectable(focusRow)) {\n          this.selected.clear();\n          this.selected.add(focusRow);\n          this.lastSelected = focusRow;\n        } else {\n          // Clear selection when navigating to non-selectable row\n          this.selected.clear();\n        }\n        this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n        this.requestAfterRender();\n      });\n      return false; // Let grid handle navigation\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\n    if (mode === 'range' && event.key === 'a' && (event.ctrlKey || event.metaKey)) {\n      const rowCount = this.rows.length;\n      const colCount = this.columns.length;\n      if (rowCount > 0 && colCount > 0) {\n        // Prevent browser's select-all behavior\n        event.preventDefault();\n        event.stopPropagation();\n\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        return true;\n      }\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    const column = this.columns[event.colIndex];\n    if (column && isUtilityColumn(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    const ctrlKey = event.originalEvent.ctrlKey || event.originalEvent.metaKey;\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    let targetCol = event.colIndex;\n    const column = this.columns[targetCol];\n    if (column && isUtilityColumn(column)) {\n      // Find the first non-utility column\n      const firstDataCol = this.columns.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  /**\n   * Apply selection classes to visible cells/rows.\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      // 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\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          }\n        }\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    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      const normalized = this.activeRange ? normalizeRange(this.activeRange) : null;\n\n      // Find the first non-utility column index for proper .first class application\n      const firstDataColIndex = this.columns.findIndex((col) => !isUtilityColumn(col));\n      const lastDataColIndex = this.columns.length - 1; // Last column is always data\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          const column = this.columns[colIndex];\n          if (column && isUtilityColumn(column)) {\n            return;\n          }\n\n          const inRange = isCellInAnyRange(rowIndex, colIndex, this.ranges);\n\n          if (inRange) {\n            cell.classList.add('selected');\n\n            if (normalized) {\n              if (rowIndex === normalized.startRow) cell.classList.add('top');\n              if (rowIndex === normalized.endRow) cell.classList.add('bottom');\n              // Apply .first to the first data column in range (skip utility columns)\n              const effectiveStartCol = Math.max(normalized.startCol, firstDataColIndex);\n              if (colIndex === effectiveStartCol) cell.classList.add('first');\n              if (colIndex === normalized.endCol) cell.classList.add('last');\n            }\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    // Set data attribute on host for CSS variable scoping\n    (this.grid as unknown as Element).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   * 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","toPublicRange","normalized","toPublicRanges","ranges","isCellInRange","row","col","isCellInAnyRange","getCellsInRange","cells","getAllCellsInRanges","cellMap","cell","createRangeFromAnchor","anchor","current","rangesEqual","a","b","normA","normB","buildSelectionEvent","mode","state","colCount","rowIndex","SelectionPlugin","BaseGridPlugin","config","styles","colIndex","isSelectable","column","event","originalEvent","triggerOn","isUtility","isUtilityColumn","currentCell","#buildEvent","shiftKey","ctrlKey","newRange","currentRange","isNavKey","focusRow","focusCol","isTabKey","shouldExtend","rowCount","allRange","targetCol","firstDataCol","_event","#applySelectionClasses","gridEl","hasSelectableCallback","allRows","clearCellFocus","firstCell","getRowIndexFromCell","firstDataColIndex","effectiveStartCol","container","currentRow","currentCol","r"],"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 { isUtilityColumn } from '../../core/plugin/expander-column';\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/**\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    const ranges = [...state.selected].map((rowIndex) => ({\n      from: { row: rowIndex, col: 0 },\n      to: { row: rowIndex, col: colCount - 1 },\n    }));\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 * ## 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.addEventListener('selection-change', (e) => {\n *   const { mode, ranges } = e.detail;\n *   console.log(`Selected ${ranges.length} ranges in ${mode} mode`);\n * });\n * ```\n *\n * @example Programmatic selection control\n * ```ts\n * const plugin = grid.getPlugin(SelectionPlugin);\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: [{ type: 'getSelection', description: 'Get the current selection state' }],\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    };\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  // #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    const column = colIndex !== undefined ? this.columns[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    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  }\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.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    const column = this.columns[colIndex];\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: Select entire row - utility column clicks still select the row\n    if (mode === 'row') {\n      if (!this.isRowSelectable(rowIndex)) {\n        return false; // Row is not selectable\n      }\n      // Only emit if selection actually changed\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.lastSelected = rowIndex;\n\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;\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    if (event.key === 'Escape') {\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: Only Up/Down arrows move row selection (but respects selectability)\n    if (mode === 'row' && (event.key === 'ArrowUp' || event.key === 'ArrowDown')) {\n      // Let grid move focus first, then sync row selection\n      queueMicrotask(() => {\n        const focusRow = this.grid._focusRow;\n        // Only select if the row is selectable\n        if (this.isRowSelectable(focusRow)) {\n          this.selected.clear();\n          this.selected.add(focusRow);\n          this.lastSelected = focusRow;\n        } else {\n          // Clear selection when navigating to non-selectable row\n          this.selected.clear();\n        }\n        this.emit<SelectionChangeDetail>('selection-change', this.#buildEvent());\n        this.requestAfterRender();\n      });\n      return false; // Let grid handle navigation\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\n    if (mode === 'range' && event.key === 'a' && (event.ctrlKey || event.metaKey)) {\n      const rowCount = this.rows.length;\n      const colCount = this.columns.length;\n      if (rowCount > 0 && colCount > 0) {\n        // Prevent browser's select-all behavior\n        event.preventDefault();\n        event.stopPropagation();\n\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        return true;\n      }\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    const column = this.columns[event.colIndex];\n    if (column && isUtilityColumn(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    const ctrlKey = event.originalEvent.ctrlKey || event.originalEvent.metaKey;\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    let targetCol = event.colIndex;\n    const column = this.columns[targetCol];\n    if (column && isUtilityColumn(column)) {\n      // Find the first non-utility column\n      const firstDataCol = this.columns.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  /**\n   * Apply selection classes to visible cells/rows.\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      // 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\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          }\n        }\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    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      const normalized = this.activeRange ? normalizeRange(this.activeRange) : null;\n\n      // Find the first non-utility column index for proper .first class application\n      const firstDataColIndex = this.columns.findIndex((col) => !isUtilityColumn(col));\n      const lastDataColIndex = this.columns.length - 1; // Last column is always data\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          const column = this.columns[colIndex];\n          if (column && isUtilityColumn(column)) {\n            return;\n          }\n\n          const inRange = isCellInAnyRange(rowIndex, colIndex, this.ranges);\n\n          if (inRange) {\n            cell.classList.add('selected');\n\n            if (normalized) {\n              if (rowIndex === normalized.startRow) cell.classList.add('top');\n              if (rowIndex === normalized.endRow) cell.classList.add('bottom');\n              // Apply .first to the first data column in range (skip utility columns)\n              const effectiveStartCol = Math.max(normalized.startCol, firstDataColIndex);\n              if (colIndex === effectiveStartCol) cell.classList.add('first');\n              if (colIndex === normalized.endCol) cell.classList.add('last');\n            }\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    // Set data attribute on host for CSS variable scoping\n    (this.grid as unknown as Element).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   * 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","toPublicRange","normalized","toPublicRanges","ranges","isCellInRange","row","col","isCellInAnyRange","getCellsInRange","cells","getAllCellsInRanges","cellMap","cell","createRangeFromAnchor","anchor","current","rangesEqual","a","b","normA","normB","buildSelectionEvent","mode","state","colCount","rowIndex","SelectionPlugin","BaseGridPlugin","config","styles","colIndex","isSelectable","column","grid","query","event","originalEvent","triggerOn","isUtility","isUtilityColumn","currentCell","#buildEvent","shiftKey","ctrlKey","newRange","currentRange","isNavKey","focusRow","focusCol","isTabKey","shouldExtend","rowCount","allRange","targetCol","firstDataCol","_event","#applySelectionClasses","gridEl","hasSelectableCallback","allRows","clearCellFocus","firstCell","getRowIndexFromCell","firstDataColIndex","effectiveStartCol","container","currentRow","currentCol","r"],"mappings":"+eAeO,SAASA,EAAeC,EAA6C,CAC1E,MAAO,CACL,SAAU,KAAK,IAAIA,EAAM,SAAUA,EAAM,MAAM,EAC/C,SAAU,KAAK,IAAIA,EAAM,SAAUA,EAAM,MAAM,EAC/C,OAAQ,KAAK,IAAIA,EAAM,SAAUA,EAAM,MAAM,EAC7C,OAAQ,KAAK,IAAIA,EAAM,SAAUA,EAAM,MAAM,CAAA,CAEjD,CAQO,SAASC,EAAcD,EAAqC,CACjE,MAAME,EAAaH,EAAeC,CAAK,EACvC,MAAO,CACL,KAAM,CAAE,IAAKE,EAAW,SAAU,IAAKA,EAAW,QAAA,EAClD,GAAI,CAAE,IAAKA,EAAW,OAAQ,IAAKA,EAAW,MAAA,CAAO,CAEzD,CAQO,SAASC,EAAeC,EAA0C,CACvE,OAAOA,EAAO,IAAIH,CAAa,CACjC,CAUO,SAASI,EAAcC,EAAaC,EAAaP,EAAmC,CACzF,MAAME,EAAaH,EAAeC,CAAK,EACvC,OACEM,GAAOJ,EAAW,UAAYI,GAAOJ,EAAW,QAAUK,GAAOL,EAAW,UAAYK,GAAOL,EAAW,MAE9G,CAUO,SAASM,EAAiBF,EAAaC,EAAaH,EAAsC,CAC/F,OAAOA,EAAO,KAAMJ,GAAUK,EAAcC,EAAKC,EAAKP,CAAK,CAAC,CAC9D,CAQO,SAASS,EAAgBT,EAA+D,CAC7F,MAAMU,EAA6C,CAAA,EAC7CR,EAAaH,EAAeC,CAAK,EAEvC,QAASM,EAAMJ,EAAW,SAAUI,GAAOJ,EAAW,OAAQI,IAC5D,QAASC,EAAML,EAAW,SAAUK,GAAOL,EAAW,OAAQK,IAC5DG,EAAM,KAAK,CAAE,IAAAJ,EAAK,IAAAC,CAAA,CAAK,EAI3B,OAAOG,CACT,CASO,SAASC,EAAoBP,EAAkE,CACpG,MAAMQ,MAAc,IAEpB,UAAWZ,KAASI,EAClB,UAAWS,KAAQJ,EAAgBT,CAAK,EACtCY,EAAQ,IAAI,GAAGC,EAAK,GAAG,IAAIA,EAAK,GAAG,GAAIA,CAAI,EAI/C,MAAO,CAAC,GAAGD,EAAQ,QAAQ,CAC7B,CAuBO,SAASE,EACdC,EACAC,EACmB,CACnB,MAAO,CACL,SAAUD,EAAO,IACjB,SAAUA,EAAO,IACjB,OAAQC,EAAQ,IAChB,OAAQA,EAAQ,GAAA,CAEpB,CAsBO,SAASC,EAAYC,EAAsBC,EAA+B,CAC/E,MAAMC,EAAQrB,EAAemB,CAAC,EACxBG,EAAQtB,EAAeoB,CAAC,EAC9B,OACEC,EAAM,WAAaC,EAAM,UACzBD,EAAM,WAAaC,EAAM,UACzBD,EAAM,SAAWC,EAAM,QACvBD,EAAM,SAAWC,EAAM,MAE3B,szCC5IA,SAASC,EACPC,EACAC,EAKAC,EACuB,CACvB,GAAIF,IAAS,QAAUC,EAAM,aAC3B,MAAO,CACL,KAAAD,EACA,OAAQ,CACN,CACE,KAAM,CAAE,IAAKC,EAAM,aAAa,IAAK,IAAKA,EAAM,aAAa,GAAA,EAC7D,GAAI,CAAE,IAAKA,EAAM,aAAa,IAAK,IAAKA,EAAM,aAAa,GAAA,CAAI,CACjE,CACF,EAIJ,GAAID,IAAS,OAASC,EAAM,SAAS,KAAO,EAAG,CAC7C,MAAMpB,EAAS,CAAC,GAAGoB,EAAM,QAAQ,EAAE,IAAKE,IAAc,CACpD,KAAM,CAAE,IAAKA,EAAU,IAAK,CAAA,EAC5B,GAAI,CAAE,IAAKA,EAAU,IAAKD,EAAW,CAAA,CAAE,EACvC,EACF,MAAO,CAAE,KAAAF,EAAM,OAAAnB,CAAA,CACjB,CAEA,OAAImB,IAAS,SAAWC,EAAM,OAAO,OAAS,EACrC,CAAE,KAAAD,EAAM,OAAQpB,EAAeqB,EAAM,MAAM,CAAA,EAG7C,CAAE,KAAAD,EAAM,OAAQ,EAAC,CAC1B,CAiFO,MAAMI,UAAwBC,EAAAA,cAAgC,CAKnE,OAAyB,SAA4C,CACnE,QAAS,CAAC,CAAE,KAAM,eAAgB,YAAa,kCAAmC,EAClF,YAAa,CACX,CACE,GAAI,2BACJ,SAAU,OACV,QACE;AAAA;AAAA,2EAGF,MAAQC,GAAWA,EAAO,OAAS,SAAWA,EAAO,YAAc,UAAA,CACrE,CACF,EAIO,KAAO,YAEE,OAASC,EAG3B,IAAuB,eAA0C,CAC/D,MAAO,CACL,KAAM,OACN,UAAW,QACX,QAAS,EAAA,CAEb,CAIQ,aAAe,IACf,aAA8B,KAC9B,OAAwB,KAGxB,OAA8B,CAAA,EAC9B,YAAwC,KACxC,WAAkD,KAClD,WAAa,GAGb,sBAAsD,KAGtD,aAAoD,KAUpD,oBAA8B,CAEpC,OAAI,KAAK,OAAO,UAAY,GAAc,GAEnC,KAAK,KAAK,iBAAiB,aAAe,EACnD,CAUQ,gBAAgBJ,EAAkBK,EAA4B,CACpE,KAAM,CAAE,aAAAC,GAAiB,KAAK,OAC9B,GAAI,CAACA,EAAc,MAAO,GAE1B,MAAM1B,EAAM,KAAK,KAAKoB,CAAQ,EAC9B,GAAI,CAACpB,EAAK,MAAO,GAEjB,MAAM2B,EAASF,IAAa,OAAY,KAAK,QAAQA,CAAQ,EAAI,OACjE,OAAOC,EAAa1B,EAAKoB,EAAUO,EAAQF,CAAQ,CACrD,CAKQ,gBAAgBL,EAA2B,CACjD,OAAO,KAAK,gBAAgBA,CAAQ,CACtC,CAKQ,iBAAiBA,EAAkBK,EAA2B,CACpE,OAAO,KAAK,gBAAgBL,EAAUK,CAAQ,CAChD,CAOS,OAAOG,EAAyB,CACvC,MAAM,OAAOA,CAAI,EAIjB,KAAK,GAAG,iBAAkB,IAAM,KAAK,sBAAsB,EAC3D,KAAK,GAAG,wBAAyB,IAAM,KAAK,sBAAsB,EAClE,KAAK,GAAG,oBAAqB,IAAM,KAAK,sBAAsB,CAChE,CAMS,YAAYC,EAA6B,CAChD,GAAIA,EAAM,OAAS,eACjB,OAAO,KAAK,aAAA,CAGhB,CAGS,QAAe,CACtB,KAAK,SAAS,MAAA,EACd,KAAK,OAAS,CAAA,EACd,KAAK,YAAc,KACnB,KAAK,WAAa,KAClB,KAAK,WAAa,GAClB,KAAK,aAAe,KACpB,KAAK,sBAAwB,IAC/B,CAMQ,sBAA6B,CACnC,KAAK,SAAS,MAAA,EACd,KAAK,OAAS,CAAA,EACd,KAAK,YAAc,KACnB,KAAK,WAAa,KAClB,KAAK,aAAe,KACpB,KAAK,aAAe,KACpB,KAAK,OAAS,KACd,KAAK,mBAAA,CACP,CAOS,YAAYC,EAAgC,CAEnD,GAAI,CAAC,KAAK,mBAAA,EAAsB,MAAO,GAEvC,KAAM,CAAE,SAAAV,EAAU,SAAAK,EAAU,cAAAM,CAAA,EAAkBD,EACxC,CAAE,KAAAb,EAAM,UAAAe,EAAY,OAAA,EAAY,KAAK,OAI3C,GAAID,EAAc,OAASC,EACzB,MAAO,GAIT,MAAML,EAAS,KAAK,QAAQF,CAAQ,EAC9BQ,EAAYN,GAAUO,EAAAA,gBAAgBP,CAAM,EAGlD,GAAIV,IAAS,OAAQ,CAInB,GAHIgB,GAGA,CAAC,KAAK,iBAAiBb,EAAUK,CAAQ,EAC3C,MAAO,GAGT,MAAMU,EAAc,KAAK,aACzB,OAAIA,GAAeA,EAAY,MAAQf,GAAYe,EAAY,MAAQV,IAGvE,KAAK,aAAe,CAAE,IAAKL,EAAU,IAAKK,CAAA,EAC1C,KAAK,KAA4B,mBAAoB,KAAKW,GAAA,CAAa,EACvE,KAAK,mBAAA,GACE,EACT,CAGA,GAAInB,IAAS,MAKX,MAJI,CAAC,KAAK,gBAAgBG,CAAQ,GAI9B,KAAK,SAAS,OAAS,GAAK,KAAK,SAAS,IAAIA,CAAQ,IAG1D,KAAK,SAAS,MAAA,EACd,KAAK,SAAS,IAAIA,CAAQ,EAC1B,KAAK,aAAeA,EAEpB,KAAK,KAA4B,mBAAoB,KAAKgB,GAAA,CAAa,EACvE,KAAK,mBAAA,GACE,GAIT,GAAInB,IAAS,QAAS,CAOpB,GALIgB,GAKA,CAAC,KAAK,iBAAiBb,EAAUK,CAAQ,EAC3C,MAAO,GAGT,MAAMY,EAAWN,EAAc,SACzBO,EAAUP,EAAc,SAAWA,EAAc,QAEvD,GAAIM,GAAY,KAAK,WAAY,CAE/B,MAAME,EAAW/B,EAAsB,KAAK,WAAY,CAAE,IAAKY,EAAU,IAAKK,EAAU,EAGlFe,EAAe,KAAK,OAAO,OAAS,EAAI,KAAK,OAAO,KAAK,OAAO,OAAS,CAAC,EAAI,KACpF,GAAIA,GAAgB7B,EAAY6B,EAAcD,CAAQ,EACpD,MAAO,GAGLD,EACE,KAAK,OAAO,OAAS,EACvB,KAAK,OAAO,KAAK,OAAO,OAAS,CAAC,EAAIC,EAEtC,KAAK,OAAO,KAAKA,CAAQ,EAG3B,KAAK,OAAS,CAACA,CAAQ,EAEzB,KAAK,YAAcA,CACrB,SAAWD,EAAS,CAClB,MAAMC,EAA8B,CAClC,SAAUnB,EACV,SAAUK,EACV,OAAQL,EACR,OAAQK,CAAA,EAEV,KAAK,OAAO,KAAKc,CAAQ,EACzB,KAAK,YAAcA,EACnB,KAAK,WAAa,CAAE,IAAKnB,EAAU,IAAKK,CAAA,CAC1C,KAAO,CAEL,MAAMc,EAA8B,CAClC,SAAUnB,EACV,SAAUK,EACV,OAAQL,EACR,OAAQK,CAAA,EAIV,GAAI,KAAK,OAAO,SAAW,GAAKd,EAAY,KAAK,OAAO,CAAC,EAAG4B,CAAQ,EAClE,MAAO,GAGT,KAAK,OAAS,CAACA,CAAQ,EACvB,KAAK,YAAcA,EACnB,KAAK,WAAa,CAAE,IAAKnB,EAAU,IAAKK,CAAA,CAC1C,CAEA,YAAK,KAA4B,mBAAoB,KAAKW,GAAA,CAAa,EAEvE,KAAK,mBAAA,EACE,EACT,CAEA,MAAO,EACT,CAGS,UAAUN,EAA+B,CAEhD,GAAI,CAAC,KAAK,mBAAA,EAAsB,MAAO,GAEvC,KAAM,CAAE,KAAAb,GAAS,KAAK,OAEhBwB,EADU,CAAC,UAAW,YAAa,YAAa,aAAc,MAAO,OAAQ,MAAO,SAAU,UAAU,EACrF,SAASX,EAAM,GAAG,EAG3C,GAAIA,EAAM,MAAQ,SAChB,OAAIb,IAAS,OACX,KAAK,aAAe,KACXA,IAAS,OAClB,KAAK,SAAS,MAAA,EACd,KAAK,OAAS,MACLA,IAAS,UAClB,KAAK,OAAS,CAAA,EACd,KAAK,YAAc,KACnB,KAAK,WAAa,MAEpB,KAAK,KAA4B,mBAAoB,KAAKmB,GAAA,CAAa,EACvE,KAAK,mBAAA,EACE,GAIT,GAAInB,IAAS,QAAUwB,EAErB,sBAAe,IAAM,CACnB,MAAMC,EAAW,KAAK,KAAK,UACrBC,EAAW,KAAK,KAAK,UAEvB,KAAK,iBAAiBD,EAAUC,CAAQ,EAC1C,KAAK,aAAe,CAAE,IAAKD,EAAU,IAAKC,CAAA,EAG1C,KAAK,aAAe,KAEtB,KAAK,KAA4B,mBAAoB,KAAKP,GAAA,CAAa,EACvE,KAAK,mBAAA,CACP,CAAC,EACM,GAIT,GAAInB,IAAS,QAAUa,EAAM,MAAQ,WAAaA,EAAM,MAAQ,aAE9D,sBAAe,IAAM,CACnB,MAAMY,EAAW,KAAK,KAAK,UAEvB,KAAK,gBAAgBA,CAAQ,GAC/B,KAAK,SAAS,MAAA,EACd,KAAK,SAAS,IAAIA,CAAQ,EAC1B,KAAK,aAAeA,GAGpB,KAAK,SAAS,MAAA,EAEhB,KAAK,KAA4B,mBAAoB,KAAKN,GAAA,CAAa,EACvE,KAAK,mBAAA,CACP,CAAC,EACM,GAKT,GAAInB,IAAS,SAAWwB,EAAU,CAEhC,MAAMG,EAAWd,EAAM,MAAQ,MACzBe,EAAef,EAAM,UAAY,CAACc,EAIxC,OAAIC,GAAgB,CAAC,KAAK,aACxB,KAAK,WAAa,CAAE,IAAK,KAAK,KAAK,UAAW,IAAK,KAAK,KAAK,SAAA,GAI/D,KAAK,sBAAwB,CAAE,SAAUA,CAAA,EAKzC,eAAe,IAAM,KAAK,oBAAoB,EAEvC,EACT,CAGA,GAAI5B,IAAS,SAAWa,EAAM,MAAQ,MAAQA,EAAM,SAAWA,EAAM,SAAU,CAC7E,MAAMgB,EAAW,KAAK,KAAK,OACrB3B,EAAW,KAAK,QAAQ,OAC9B,GAAI2B,EAAW,GAAK3B,EAAW,EAAG,CAEhCW,EAAM,eAAA,EACNA,EAAM,gBAAA,EAEN,MAAMiB,EAA8B,CAClC,SAAU,EACV,SAAU,EACV,OAAQD,EAAW,EACnB,OAAQ3B,EAAW,CAAA,EAErB,YAAK,OAAS,CAAC4B,CAAQ,EACvB,KAAK,YAAcA,EACnB,KAAK,KAA4B,mBAAoB,KAAKX,GAAA,CAAa,EACvE,KAAK,mBAAA,EACE,EACT,CACF,CAEA,MAAO,EACT,CAGS,gBAAgBN,EAAuC,CAM9D,GAJI,CAAC,KAAK,sBAEN,KAAK,OAAO,OAAS,SACrBA,EAAM,WAAa,QAAaA,EAAM,WAAa,QACnDA,EAAM,SAAW,EAAG,OAGxB,MAAMH,EAAS,KAAK,QAAQG,EAAM,QAAQ,EAW1C,GAVIH,GAAUO,kBAAgBP,CAAM,GAKhC,CAAC,KAAK,iBAAiBG,EAAM,SAAUA,EAAM,QAAQ,GAKrDA,EAAM,cAAc,UAAY,KAAK,WACvC,OAIF,KAAK,WAAa,GAClB,MAAMV,EAAWU,EAAM,SACjBL,EAAWK,EAAM,SAEjBQ,EAAUR,EAAM,cAAc,SAAWA,EAAM,cAAc,QAE7DS,EAA8B,CAClC,SAAUnB,EACV,SAAUK,EACV,OAAQL,EACR,OAAQK,CAAA,EAIV,MAAI,CAACa,GAAW,KAAK,OAAO,SAAW,GAAK3B,EAAY,KAAK,OAAO,CAAC,EAAG4B,CAAQ,GAE9E,KAAK,WAAa,CAAE,IAAKnB,EAAU,IAAKK,CAAA,EACjC,KAGT,KAAK,WAAa,CAAE,IAAKL,EAAU,IAAKK,CAAA,EAEnCa,IACH,KAAK,OAAS,CAAA,GAGhB,KAAK,OAAO,KAAKC,CAAQ,EACzB,KAAK,YAAcA,EAEnB,KAAK,KAA4B,mBAAoB,KAAKH,GAAA,CAAa,EACvE,KAAK,mBAAA,EACE,GACT,CAGS,gBAAgBN,EAAuC,CAO9D,GALI,CAAC,KAAK,sBAEN,KAAK,OAAO,OAAS,SACrB,CAAC,KAAK,YAAc,CAAC,KAAK,YAC1BA,EAAM,WAAa,QAAaA,EAAM,WAAa,QACnDA,EAAM,SAAW,EAAG,OAGxB,IAAIkB,EAAYlB,EAAM,SACtB,MAAMH,EAAS,KAAK,QAAQqB,CAAS,EACrC,GAAIrB,GAAUO,kBAAgBP,CAAM,EAAG,CAErC,MAAMsB,EAAe,KAAK,QAAQ,UAAWhD,GAAQ,CAACiC,kBAAgBjC,CAAG,CAAC,EACtEgD,GAAgB,IAClBD,EAAYC,EAEhB,CAEA,MAAMV,EAAW/B,EAAsB,KAAK,WAAY,CAAE,IAAKsB,EAAM,SAAU,IAAKkB,EAAW,EAGzFR,EAAe,KAAK,OAAO,OAAS,EAAI,KAAK,OAAO,KAAK,OAAO,OAAS,CAAC,EAAI,KACpF,OAAIA,GAAgB7B,EAAY6B,EAAcD,CAAQ,IAIlD,KAAK,OAAO,OAAS,EACvB,KAAK,OAAO,KAAK,OAAO,OAAS,CAAC,EAAIA,EAEtC,KAAK,OAAO,KAAKA,CAAQ,EAE3B,KAAK,YAAcA,EAEnB,KAAK,KAA4B,mBAAoB,KAAKH,GAAA,CAAa,EACvE,KAAK,mBAAA,GACE,EACT,CAGS,cAAcc,EAAwC,CAE7D,GAAK,KAAK,sBAEN,KAAK,OAAO,OAAS,SACrB,KAAK,WACP,YAAK,WAAa,GACX,EAEX,CAMAC,IAA+B,CAC7B,MAAMC,EAAS,KAAK,YACpB,GAAI,CAACA,EAAQ,OAEb,KAAM,CAAE,KAAAnC,GAAS,KAAK,OAChBoC,EAAwB,CAAC,CAAC,KAAK,OAAO,aAG3BD,EAAO,iBAAiB,OAAO,EACvC,QAAS7C,GAAS,CACzBA,EAAK,UAAU,OAAO,WAAY,MAAO,SAAU,QAAS,MAAM,EAE9D8C,GACF9C,EAAK,gBAAgB,iBAAiB,CAE1C,CAAC,EAED,MAAM+C,EAAUF,EAAO,iBAAiB,gBAAgB,EA4CxD,GA3CAE,EAAQ,QAAStD,GAAQ,CACvBA,EAAI,UAAU,OAAO,WAAY,WAAW,EAExCqD,GACFrD,EAAI,gBAAgB,iBAAiB,CAEzC,CAAC,EAGGiB,IAAS,QAEXsC,EAAAA,eAAeH,CAAM,EAErBE,EAAQ,QAAStD,GAAQ,CACvB,MAAMwD,EAAYxD,EAAI,cAAc,iBAAiB,EAC/CoB,EAAWqC,EAAAA,oBAAoBD,CAAS,EAC1CpC,GAAY,IAEViC,GAAyB,CAAC,KAAK,gBAAgBjC,CAAQ,GACzDpB,EAAI,aAAa,kBAAmB,OAAO,EAEzC,KAAK,SAAS,IAAIoB,CAAQ,GAC5BpB,EAAI,UAAU,IAAI,WAAY,WAAW,EAG/C,CAAC,IAIEiB,IAAS,QAAUA,IAAS,UAAYoC,GAC7BD,EAAO,iBAAiB,2BAA2B,EAC3D,QAAS7C,GAAS,CACtB,MAAMa,EAAW,SAASb,EAAK,aAAa,UAAU,GAAK,KAAM,EAAE,EAC7DkB,EAAW,SAASlB,EAAK,aAAa,UAAU,GAAK,KAAM,EAAE,EAC/Da,GAAY,GAAKK,GAAY,IAC1B,KAAK,iBAAiBL,EAAUK,CAAQ,GAC3ClB,EAAK,aAAa,kBAAmB,OAAO,EAGlD,CAAC,EAICU,IAAS,SAAW,KAAK,OAAO,OAAS,EAAG,CAE9CsC,EAAAA,eAAeH,CAAM,EAErB,MAAMxD,EAAa,KAAK,YAAcH,EAAe,KAAK,WAAW,EAAI,KAGnEiE,EAAoB,KAAK,QAAQ,UAAWzD,GAAQ,CAACiC,kBAAgBjC,CAAG,CAAC,EACtD,KAAK,QAAQ,OAAS,EAEjCmD,EAAO,iBAAiB,2BAA2B,EAC3D,QAAS7C,GAAS,CACtB,MAAMa,EAAW,SAASb,EAAK,aAAa,UAAU,GAAK,KAAM,EAAE,EAC7DkB,EAAW,SAASlB,EAAK,aAAa,UAAU,GAAK,KAAM,EAAE,EACnE,GAAIa,GAAY,GAAKK,GAAY,EAAG,CAElC,MAAME,EAAS,KAAK,QAAQF,CAAQ,EACpC,GAAIE,GAAUO,kBAAgBP,CAAM,EAClC,OAKF,GAFgBzB,EAAiBkB,EAAUK,EAAU,KAAK,MAAM,IAG9DlB,EAAK,UAAU,IAAI,UAAU,EAEzBX,GAAY,CACVwB,IAAaxB,EAAW,UAAUW,EAAK,UAAU,IAAI,KAAK,EAC1Da,IAAaxB,EAAW,QAAQW,EAAK,UAAU,IAAI,QAAQ,EAE/D,MAAMoD,EAAoB,KAAK,IAAI/D,EAAW,SAAU8D,CAAiB,EACrEjC,IAAakC,GAAmBpD,EAAK,UAAU,IAAI,OAAO,EAC1DkB,IAAa7B,EAAW,QAAQW,EAAK,UAAU,IAAI,MAAM,CAC/D,CAEJ,CACF,CAAC,CACH,CAIF,CAGS,aAAoB,CAE3B,GAAI,CAAC,KAAK,qBAAsB,OAEhC,MAAM6C,EAAS,KAAK,YACpB,GAAI,CAACA,EAAQ,OAEb,MAAMQ,EAAYR,EAAO,SAAS,CAAC,EAC7B,CAAE,KAAAnC,GAAS,KAAK,OAItB,GAAI,KAAK,uBAAyBA,IAAS,QAAS,CAClD,KAAM,CAAE,SAAAoB,GAAa,KAAK,sBAC1B,KAAK,sBAAwB,KAE7B,MAAMwB,EAAa,KAAK,KAAK,UACvBC,EAAa,KAAK,KAAK,UAE7B,GAAIzB,GAAY,KAAK,WAAY,CAE/B,MAAME,EAAW/B,EAAsB,KAAK,WAAY,CAAE,IAAKqD,EAAY,IAAKC,EAAY,EAC5F,KAAK,OAAS,CAACvB,CAAQ,EACvB,KAAK,YAAcA,CACrB,MAAYF,IAEV,KAAK,OAAS,CAAA,EACd,KAAK,YAAc,KACnB,KAAK,WAAa,CAAE,IAAKwB,EAAY,IAAKC,CAAA,GAG5C,KAAK,KAA4B,mBAAoB,KAAK1B,GAAA,CAAa,CACzE,CAGC,KAAK,KAA4B,aAAa,sBAAuBnB,CAAI,EAGtE2C,GACFA,EAAU,UAAU,OAAO,YAAa,KAAK,UAAU,EAGzD,KAAKT,GAAA,CACP,CAOS,gBAAuB,CAEzB,KAAK,sBAEV,KAAKA,GAAA,CACP,CAqBA,cAAgC,CAC9B,MAAO,CACL,KAAM,KAAK,OAAO,KAClB,OAAQ,KAAKf,GAAA,EAAc,OAC3B,OAAQ,KAAK,UAAA,CAEjB,CAKA,kBAAwD,CACtD,OAAO/B,EAAoB,KAAK,MAAM,CACxC,CAKA,eAAeL,EAAaC,EAAsB,CAChD,OAAOC,EAAiBF,EAAKC,EAAK,KAAK,MAAM,CAC/C,CAKA,gBAAuB,CACrB,KAAK,aAAe,KACpB,KAAK,SAAS,MAAA,EACd,KAAK,OAAS,KACd,KAAK,OAAS,CAAA,EACd,KAAK,YAAc,KACnB,KAAK,WAAa,KAClB,KAAK,KAA4B,mBAAoB,CAAE,KAAM,KAAK,OAAO,KAAM,OAAQ,CAAA,EAAI,EAC3F,KAAK,mBAAA,CACP,CAKA,UAAUH,EAA2B,CACnC,KAAK,OAASA,EAAO,IAAKiE,IAAO,CAC/B,SAAUA,EAAE,KAAK,IACjB,SAAUA,EAAE,KAAK,IACjB,OAAQA,EAAE,GAAG,IACb,OAAQA,EAAE,GAAG,GAAA,EACb,EACF,KAAK,YAAc,KAAK,OAAO,OAAS,EAAI,KAAK,OAAO,KAAK,OAAO,OAAS,CAAC,EAAI,KAClF,KAAK,KAA4B,mBAAoB,CACnD,KAAM,KAAK,OAAO,KAClB,OAAQlE,EAAe,KAAK,MAAM,CAAA,CACnC,EACD,KAAK,mBAAA,CACP,CAMAuC,IAAqC,CACnC,OAAOpB,EACL,KAAK,OAAO,KACZ,CACE,aAAc,KAAK,aACnB,SAAU,KAAK,SACf,OAAQ,KAAK,MAAA,EAEf,KAAK,QAAQ,MAAA,CAEjB,CAGF"}

package/umd/plugins/tree.umd.js

@@ -1,2 +1,2 @@
-(function(u,y){typeof exports=="object"&&typeof module<"u"?y(exports,require("../../core/plugin/base-plugin")):typeof define=="function"&&define.amd?define(["exports","../../core/plugin/base-plugin"],y):(u=typeof globalThis<"u"?globalThis:u||self,y(u.TbwGridPlugin_tree={},u.TbwGrid))})(this,(function(u,y){"use strict";function m(o,e,t){return o.id!==void 0?String(o.id):t?`${t}-${e}`:String(e)}function b(o,e){const t=new Set(o);return t.has(e)?t.delete(e):t.add(e),t}function x(o,e,t=null,n=0){const r=e.childrenField??"children",s=new Set;for(let i=0;i<o.length;i++){const d=o[i],a=m(d,i,t),l=d[r];if(Array.isArray(l)&&l.length>0){s.add(a);const h=x(l,e,a,n+1);for(const f of h)s.add(f)}}return s}function _(){return new Set}function K(o,e,t,n=null,r=0){const s=t.childrenField??"children";for(let i=0;i<o.length;i++){const d=o[i],a=m(d,i,n);if(a===e)return[a];const l=d[s];if(Array.isArray(l)&&l.length>0){const h=K(l,e,t,a,r+1);if(h)return[a,...h]}}return null}function A(o,e,t,n){const r=K(o,e,t);if(!r)return n;const s=new Set(n);for(let i=0;i<r.length-1;i++)s.add(r[i]);return s}function S(o,e="children"){if(!Array.isArray(o)||o.length===0)return!1;for(const t of o){if(!t)continue;const n=t[e];if(Array.isArray(n)&&n.length>0)return!0}return!1}function k(o){if(!Array.isArray(o)||o.length===0)return null;const e=["children","items","nodes","subRows","nested"];for(const t of o)if(!(!t||typeof t!="object"))for(const n of e){const r=t[n];if(Array.isArray(r)&&r.length>0)return n}return null}const v="@layer tbw-plugins{tbw-grid .cell[data-field=__tbw_expander]{border-right:none!important;padding:0;display:flex;align-items:center;justify-content:flex-start}tbw-grid .header-row .cell[data-field=__tbw_expander]{display:none}tbw-grid .header-row .cell[data-field=__tbw_expander]+.cell{grid-column:1 / 3}tbw-grid .tree-cell-wrapper{display:inline-flex;align-items:center;padding-left:calc(var(--tbw-tree-depth, 0) * var(--tbw-tree-indent-width, var(--tbw-tree-toggle-size, 1.25em)))}tbw-grid .tree-expander{display:flex;align-items:center;justify-content:flex-start;width:100%;height:100%;box-sizing:border-box}tbw-grid .tree-toggle{cursor:pointer;-webkit-user-select:none;user-select:none;display:inline-flex;align-items:center;justify-content:center;width:var(--tbw-tree-toggle-size, 1.25em);height:var(--tbw-tree-toggle-size, 1.25em);flex-shrink:0}tbw-grid .tree-toggle:hover{color:var(--tbw-tree-accent, var(--tbw-color-accent))}tbw-grid .tree-spacer{width:var(--tbw-tree-toggle-size, 1.25em);display:inline-block;flex-shrink:0}tbw-grid .data-grid-row.tbw-tree-slide-in{animation:tbw-tree-slide-in var(--tbw-animation-duration, .2s) var(--tbw-animation-easing, ease-out) forwards}tbw-grid .data-grid-row.tbw-tree-fade-in{animation:tbw-tree-fade-in var(--tbw-animation-duration, .2s) var(--tbw-animation-easing, ease-out) forwards}@keyframes tbw-tree-slide-in{0%{opacity:0;transform:translate(-8px)}to{opacity:1;transform:translate(0)}}@keyframes tbw-tree-fade-in{0%{opacity:0}to{opacity:1}}}";class E extends y.BaseGridPlugin{name="tree";styles=v;get defaultConfig(){return{childrenField:"children",autoDetect:!0,defaultExpanded:!1,indentWidth:20,showExpandIcons:!0,animation:"slide"}}expandedKeys=new Set;initialExpansionDone=!1;flattenedRows=[];rowKeyMap=new Map;previousVisibleKeys=new Set;keysToAnimate=new Set;sortState=null;detach(){this.expandedKeys.clear(),this.initialExpansionDone=!1,this.flattenedRows=[],this.rowKeyMap.clear(),this.previousVisibleKeys.clear(),this.keysToAnimate.clear(),this.sortState=null}get animationStyle(){return this.isAnimationEnabled?this.config.animation??"slide":!1}detect(e){if(!this.config.autoDetect)return!1;const t=e,n=this.config.childrenField??k(t)??"children";return S(t,n)}processRows(e){const t=this.config.childrenField??"children",n=e;if(!S(n,t))return this.flattenedRows=[],this.rowKeyMap.clear(),this.previousVisibleKeys.clear(),[...e];let r=this.withStableKeys(n);this.sortState&&(r=this.sortTree(r,this.sortState.field,this.sortState.direction)),this.config.defaultExpanded&&!this.initialExpansionDone&&(this.expandedKeys=x(r,this.config),this.initialExpansionDone=!0),this.flattenedRows=this.flattenTree(r,this.expandedKeys),this.rowKeyMap.clear(),this.keysToAnimate.clear();const s=new Set;for(const i of this.flattenedRows)this.rowKeyMap.set(i.key,i),s.add(i.key),!this.previousVisibleKeys.has(i.key)&&i.depth>0&&this.keysToAnimate.add(i.key);return this.previousVisibleKeys=s,this.flattenedRows.map(i=>({...i.data,__treeKey:i.key,__treeDepth:i.depth,__treeHasChildren:i.hasChildren,__treeExpanded:i.isExpanded}))}withStableKeys(e,t=null){const n=this.config.childrenField??"children";return e.map((r,s)=>{const i=r.__stableKey,d=r.id!==void 0?String(r.id):i??(t?`${t}-${s}`:String(s)),a=r[n],l=Array.isArray(a)&&a.length>0;return{...r,__stableKey:d,...l?{[n]:this.withStableKeys(a,d)}:{}}})}flattenTree(e,t,n=0){const r=this.config.childrenField??"children",s=[];for(const i of e){const a=i.__stableKey??String(i.id??"?"),l=i[r],h=Array.isArray(l)&&l.length>0,f=t.has(a);s.push({key:a,data:i,depth:n,hasChildren:h,isExpanded:f,parentKey:n>0&&a.substring(0,a.lastIndexOf("-"))||null}),h&&f&&s.push(...this.flattenTree(l,t,n+1))}return s}sortTree(e,t,n){const r=this.config.childrenField??"children";return[...e].sort((i,d)=>{const a=i[t],l=d[t];return a==null&&l==null?0:a==null?-1:l==null?1:a>l?n:a<l?-n:0}).map(i=>{const d=i[r];return Array.isArray(d)&&d.length>0?{...i,[r]:this.sortTree(d,t,n)}:i})}processColumns(e){if(this.flattenedRows.length===0)return[...e];const t=[...e];if(t.length===0)return t;const n=t[0],r=n.viewRenderer,s=()=>this.config,i=this.setIcon.bind(this),d=this.resolveIcon.bind(this),a=l=>{const{row:h,value:f}=l,{showExpandIcons:T=!0,indentWidth:R}=s(),g=h,C=g.__treeDepth??0,p=document.createElement("span");if(p.className="tree-cell-wrapper",p.style.setProperty("--tbw-tree-depth",String(C)),R!==void 0&&p.style.setProperty("--tbw-tree-indent-width",`${R}px`),T)if(g.__treeHasChildren){const c=document.createElement("span");c.className=`tree-toggle${g.__treeExpanded?" expanded":""}`,i(c,d(g.__treeExpanded?"collapse":"expand")),c.setAttribute("data-tree-key",String(g.__treeKey??"")),p.appendChild(c)}else{const c=document.createElement("span");c.className="tree-spacer",p.appendChild(c)}const w=document.createElement("span");if(w.className="tree-content",r){const c=r(l);c instanceof Node?w.appendChild(c):typeof c=="string"&&(w.innerHTML=c)}else w.textContent=f!=null?String(f):"";return p.appendChild(w),p};return t[0]={...n,viewRenderer:a},t}onCellClick(e){const t=e.originalEvent?.target;if(!t?.classList.contains("tree-toggle"))return!1;const n=t.getAttribute("data-tree-key");if(!n)return!1;const r=this.rowKeyMap.get(n);return r?(this.expandedKeys=b(this.expandedKeys,n),this.emit("tree-expand",{key:n,row:r.data,expanded:this.expandedKeys.has(n),depth:r.depth}),this.requestRender(),!0):!1}onKeyDown(e){if(e.key!==" ")return;const t=this.grid._focusRow,n=this.flattenedRows[t];if(n?.hasChildren)return e.preventDefault(),this.expandedKeys=b(this.expandedKeys,n.key),this.emit("tree-expand",{key:n.key,row:n.data,expanded:this.expandedKeys.has(n.key),depth:n.depth}),this.requestRenderWithFocus(),!0}onHeaderClick(e){if(this.flattenedRows.length===0||!e.column.sortable)return!1;const{field:t}=e.column;!this.sortState||this.sortState.field!==t?this.sortState={field:t,direction:1}:this.sortState.direction===1?this.sortState={field:t,direction:-1}:this.sortState=null;const n=this.grid;return n._sortState!==void 0&&(n._sortState=this.sortState?{...this.sortState}:null),this.emit("sort-change",{field:t,direction:this.sortState?.direction??0}),this.requestRender(),!0}afterRender(){const e=this.animationStyle;if(e===!1||this.keysToAnimate.size===0)return;const t=this.gridElement?.querySelector(".rows");if(!t)return;const n=e==="fade"?"tbw-tree-fade-in":"tbw-tree-slide-in";for(const r of t.querySelectorAll(".data-grid-row")){const s=r.querySelector(".cell[data-row]"),i=s?parseInt(s.getAttribute("data-row")??"-1",10):-1,d=this.flattenedRows[i]?.key;d&&this.keysToAnimate.has(d)&&(r.classList.add(n),r.addEventListener("animationend",()=>r.classList.remove(n),{once:!0}))}this.keysToAnimate.clear()}expand(e){this.expandedKeys.add(e),this.requestRender()}collapse(e){this.expandedKeys.delete(e),this.requestRender()}toggle(e){this.expandedKeys=b(this.expandedKeys,e),this.requestRender()}expandAll(){this.expandedKeys=x(this.rows,this.config),this.requestRender()}collapseAll(){this.expandedKeys=_(),this.requestRender()}isExpanded(e){return this.expandedKeys.has(e)}getExpandedKeys(){return[...this.expandedKeys]}getFlattenedRows(){return[...this.flattenedRows]}getRowByKey(e){return this.rowKeyMap.get(e)?.data}expandToKey(e){this.expandedKeys=A(this.rows,e,this.config,this.expandedKeys),this.requestRender()}}u.TreePlugin=E,Object.defineProperty(u,Symbol.toStringTag,{value:"Module"})}));
+(function(u,y){typeof exports=="object"&&typeof module<"u"?y(exports,require("../../core/plugin/base-plugin")):typeof define=="function"&&define.amd?define(["exports","../../core/plugin/base-plugin"],y):(u=typeof globalThis<"u"?globalThis:u||self,y(u.TbwGridPlugin_tree={},u.TbwGrid))})(this,(function(u,y){"use strict";function m(o,e,t){return o.id!==void 0?String(o.id):t?`${t}-${e}`:String(e)}function b(o,e){const t=new Set(o);return t.has(e)?t.delete(e):t.add(e),t}function x(o,e,t=null,n=0){const s=e.childrenField??"children",r=new Set;for(let i=0;i<o.length;i++){const l=o[i],a=m(l,i,t),d=l[s];if(Array.isArray(d)&&d.length>0){r.add(a);const h=x(d,e,a,n+1);for(const f of h)r.add(f)}}return r}function v(){return new Set}function K(o,e,t,n=null,s=0){const r=t.childrenField??"children";for(let i=0;i<o.length;i++){const l=o[i],a=m(l,i,n);if(a===e)return[a];const d=l[r];if(Array.isArray(d)&&d.length>0){const h=K(d,e,t,a,s+1);if(h)return[a,...h]}}return null}function _(o,e,t,n){const s=K(o,e,t);if(!s)return n;const r=new Set(n);for(let i=0;i<s.length-1;i++)r.add(s[i]);return r}function S(o,e="children"){if(!Array.isArray(o)||o.length===0)return!1;for(const t of o){if(!t)continue;const n=t[e];if(Array.isArray(n)&&n.length>0)return!0}return!1}function A(o){if(!Array.isArray(o)||o.length===0)return null;const e=["children","items","nodes","subRows","nested"];for(const t of o)if(!(!t||typeof t!="object"))for(const n of e){const s=t[n];if(Array.isArray(s)&&s.length>0)return n}return null}const k="@layer tbw-plugins{tbw-grid .cell[data-field=__tbw_expander]{border-right:none!important;padding:0;display:flex;align-items:center;justify-content:flex-start}tbw-grid .header-row .cell[data-field=__tbw_expander]{display:none}tbw-grid .header-row .cell[data-field=__tbw_expander]+.cell{grid-column:1 / 3}tbw-grid .tree-cell-wrapper{display:inline-flex;align-items:center;padding-left:calc(var(--tbw-tree-depth, 0) * var(--tbw-tree-indent-width, var(--tbw-tree-toggle-size, 1.25em)))}tbw-grid .tree-expander{display:flex;align-items:center;justify-content:flex-start;width:100%;height:100%;box-sizing:border-box}tbw-grid .tree-toggle{cursor:pointer;-webkit-user-select:none;user-select:none;display:inline-flex;align-items:center;justify-content:center;width:var(--tbw-tree-toggle-size, 1.25em);height:var(--tbw-tree-toggle-size, 1.25em);flex-shrink:0}tbw-grid .tree-toggle:hover{color:var(--tbw-tree-accent, var(--tbw-color-accent))}tbw-grid .tree-spacer{width:var(--tbw-tree-toggle-size, 1.25em);display:inline-block;flex-shrink:0}tbw-grid .data-grid-row.tbw-tree-slide-in{animation:tbw-tree-slide-in var(--tbw-animation-duration, .2s) var(--tbw-animation-easing, ease-out) forwards}tbw-grid .data-grid-row.tbw-tree-fade-in{animation:tbw-tree-fade-in var(--tbw-animation-duration, .2s) var(--tbw-animation-easing, ease-out) forwards}@keyframes tbw-tree-slide-in{0%{opacity:0;transform:translate(-8px)}to{opacity:1;transform:translate(0)}}@keyframes tbw-tree-fade-in{0%{opacity:0}to{opacity:1}}}";class E extends y.BaseGridPlugin{static manifest={events:[{type:"tree-state-change",description:"Emitted when tree expansion state changes (toggle, expand all, collapse all)"}],queries:[{type:"canMoveRow",description:"Returns false for rows with children (parent nodes cannot be reordered)"}]};name="tree";styles=k;get defaultConfig(){return{childrenField:"children",autoDetect:!0,defaultExpanded:!1,indentWidth:20,showExpandIcons:!0,animation:"slide"}}expandedKeys=new Set;initialExpansionDone=!1;flattenedRows=[];rowKeyMap=new Map;previousVisibleKeys=new Set;keysToAnimate=new Set;sortState=null;detach(){this.expandedKeys.clear(),this.initialExpansionDone=!1,this.flattenedRows=[],this.rowKeyMap.clear(),this.previousVisibleKeys.clear(),this.keysToAnimate.clear(),this.sortState=null}handleQuery(e){if(e.type==="canMoveRow"){const t=e.context;if(t&&t[this.config.childrenField??"children"]?.length>0)return!1}}get animationStyle(){return this.isAnimationEnabled?this.config.animation??"slide":!1}detect(e){if(!this.config.autoDetect)return!1;const t=e,n=this.config.childrenField??A(t)??"children";return S(t,n)}processRows(e){const t=this.config.childrenField??"children",n=e;if(!S(n,t))return this.flattenedRows=[],this.rowKeyMap.clear(),this.previousVisibleKeys.clear(),[...e];let s=this.withStableKeys(n);this.sortState&&(s=this.sortTree(s,this.sortState.field,this.sortState.direction)),this.config.defaultExpanded&&!this.initialExpansionDone&&(this.expandedKeys=x(s,this.config),this.initialExpansionDone=!0),this.flattenedRows=this.flattenTree(s,this.expandedKeys),this.rowKeyMap.clear(),this.keysToAnimate.clear();const r=new Set;for(const i of this.flattenedRows)this.rowKeyMap.set(i.key,i),r.add(i.key),!this.previousVisibleKeys.has(i.key)&&i.depth>0&&this.keysToAnimate.add(i.key);return this.previousVisibleKeys=r,this.flattenedRows.map(i=>({...i.data,__treeKey:i.key,__treeDepth:i.depth,__treeHasChildren:i.hasChildren,__treeExpanded:i.isExpanded}))}withStableKeys(e,t=null){const n=this.config.childrenField??"children";return e.map((s,r)=>{const i=s.__stableKey,l=s.id!==void 0?String(s.id):i??(t?`${t}-${r}`:String(r)),a=s[n],d=Array.isArray(a)&&a.length>0;return{...s,__stableKey:l,...d?{[n]:this.withStableKeys(a,l)}:{}}})}flattenTree(e,t,n=0){const s=this.config.childrenField??"children",r=[];for(const i of e){const a=i.__stableKey??String(i.id??"?"),d=i[s],h=Array.isArray(d)&&d.length>0,f=t.has(a);r.push({key:a,data:i,depth:n,hasChildren:h,isExpanded:f,parentKey:n>0&&a.substring(0,a.lastIndexOf("-"))||null}),h&&f&&r.push(...this.flattenTree(d,t,n+1))}return r}sortTree(e,t,n){const s=this.config.childrenField??"children";return[...e].sort((i,l)=>{const a=i[t],d=l[t];return a==null&&d==null?0:a==null?-1:d==null?1:a>d?n:a<d?-n:0}).map(i=>{const l=i[s];return Array.isArray(l)&&l.length>0?{...i,[s]:this.sortTree(l,t,n)}:i})}processColumns(e){if(this.flattenedRows.length===0)return[...e];const t=[...e];if(t.length===0)return t;const n=t[0],s=n.viewRenderer,r=()=>this.config,i=this.setIcon.bind(this),l=this.resolveIcon.bind(this),a=d=>{const{row:h,value:f}=d,{showExpandIcons:T=!0,indentWidth:R}=r(),g=h,C=g.__treeDepth??0,p=document.createElement("span");if(p.className="tree-cell-wrapper",p.style.setProperty("--tbw-tree-depth",String(C)),R!==void 0&&p.style.setProperty("--tbw-tree-indent-width",`${R}px`),T)if(g.__treeHasChildren){const c=document.createElement("span");c.className=`tree-toggle${g.__treeExpanded?" expanded":""}`,i(c,l(g.__treeExpanded?"collapse":"expand")),c.setAttribute("data-tree-key",String(g.__treeKey??"")),p.appendChild(c)}else{const c=document.createElement("span");c.className="tree-spacer",p.appendChild(c)}const w=document.createElement("span");if(w.className="tree-content",s){const c=s(d);c instanceof Node?w.appendChild(c):typeof c=="string"&&(w.innerHTML=c)}else w.textContent=f!=null?String(f):"";return p.appendChild(w),p};return t[0]={...n,viewRenderer:a},t}onCellClick(e){const t=e.originalEvent?.target;if(!t?.classList.contains("tree-toggle"))return!1;const n=t.getAttribute("data-tree-key");if(!n)return!1;const s=this.rowKeyMap.get(n);return s?(this.expandedKeys=b(this.expandedKeys,n),this.emit("tree-expand",{key:n,row:s.data,expanded:this.expandedKeys.has(n),depth:s.depth}),this.requestRender(),!0):!1}onKeyDown(e){if(e.key!==" ")return;const t=this.grid._focusRow,n=this.flattenedRows[t];if(n?.hasChildren)return e.preventDefault(),this.expandedKeys=b(this.expandedKeys,n.key),this.emit("tree-expand",{key:n.key,row:n.data,expanded:this.expandedKeys.has(n.key),depth:n.depth}),this.requestRenderWithFocus(),!0}onHeaderClick(e){if(this.flattenedRows.length===0||!e.column.sortable)return!1;const{field:t}=e.column;!this.sortState||this.sortState.field!==t?this.sortState={field:t,direction:1}:this.sortState.direction===1?this.sortState={field:t,direction:-1}:this.sortState=null;const n=this.grid;return n._sortState!==void 0&&(n._sortState=this.sortState?{...this.sortState}:null),this.emit("sort-change",{field:t,direction:this.sortState?.direction??0}),this.requestRender(),!0}afterRender(){const e=this.animationStyle;if(e===!1||this.keysToAnimate.size===0)return;const t=this.gridElement?.querySelector(".rows");if(!t)return;const n=e==="fade"?"tbw-tree-fade-in":"tbw-tree-slide-in";for(const s of t.querySelectorAll(".data-grid-row")){const r=s.querySelector(".cell[data-row]"),i=r?parseInt(r.getAttribute("data-row")??"-1",10):-1,l=this.flattenedRows[i]?.key;l&&this.keysToAnimate.has(l)&&(s.classList.add(n),s.addEventListener("animationend",()=>s.classList.remove(n),{once:!0}))}this.keysToAnimate.clear()}expand(e){this.expandedKeys.add(e),this.requestRender()}collapse(e){this.expandedKeys.delete(e),this.requestRender()}toggle(e){this.expandedKeys=b(this.expandedKeys,e),this.emitPluginEvent("tree-state-change",{expandedKeys:[...this.expandedKeys]}),this.requestRender()}expandAll(){this.expandedKeys=x(this.rows,this.config),this.emitPluginEvent("tree-state-change",{expandedKeys:[...this.expandedKeys]}),this.requestRender()}collapseAll(){this.expandedKeys=v(),this.emitPluginEvent("tree-state-change",{expandedKeys:[...this.expandedKeys]}),this.requestRender()}isExpanded(e){return this.expandedKeys.has(e)}getExpandedKeys(){return[...this.expandedKeys]}getFlattenedRows(){return[...this.flattenedRows]}getRowByKey(e){return this.rowKeyMap.get(e)?.data}expandToKey(e){this.expandedKeys=_(this.rows,e,this.config,this.expandedKeys),this.requestRender()}}u.TreePlugin=E,Object.defineProperty(u,Symbol.toStringTag,{value:"Module"})}));
 //# sourceMappingURL=tree.umd.js.map

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 { BaseGridPlugin, CellClickEvent, HeaderClickEvent } from '../../core/plugin/base-plugin';\nimport type { ColumnConfig, ColumnViewRenderer } 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\ninterface GridWithSortState {\n  _sortState?: { field: string; direction: 1 | -1 } | null;\n}\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  /** @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  // #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 GridWithSortState;\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 style = this.animationStyle;\n    if (style === false || this.keysToAnimate.size === 0) return;\n\n    const body = this.gridElement?.querySelector('.rows');\n    if (!body) return;\n\n    const animClass = style === 'fade' ? 'tbw-tree-fade-in' : 'tbw-tree-slide-in';\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 key = this.flattenedRows[idx]?.key;\n\n      if (key && this.keysToAnimate.has(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.requestRender();\n  }\n\n  expandAll(): void {\n    this.expandedKeys = expandAll(this.rows as TreeRow[], this.config);\n    this.requestRender();\n  }\n\n  collapseAll(): void {\n    this.expandedKeys = collapseAll();\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","toggleExpand","expandedKeys","key","newExpanded","expandAll","rows","config","depth","childrenField","keys","children","childKeys","k","collapseAll","getPathToKey","targetKey","childPath","expandToKey","existingExpanded","path","detectTreeStructure","inferChildrenField","commonArrayFields","field","value","TreePlugin","BaseGridPlugin","styles","treeRows","data","currentKeys","r","i","stableKey","hasChildren","expanded","result","isExpanded","dir","a","b","aVal","bVal","columns","cols","firstCol","originalRenderer","getConfig","setIcon","resolveIcon","wrappedRenderer","ctx","showExpandIcons","indentWidth","treeRow","container","icon","spacer","content","event","target","flatRow","focusRow","gridEl","style","body","animClass","rowEl","cell","idx"],"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 } 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\ninterface GridWithSortState {\n  _sortState?: { field: string; direction: 1 | -1 } | null;\n}\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 any;\n      if (row && row[this.config.childrenField ?? '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 GridWithSortState;\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 style = this.animationStyle;\n    if (style === false || this.keysToAnimate.size === 0) return;\n\n    const body = this.gridElement?.querySelector('.rows');\n    if (!body) return;\n\n    const animClass = style === 'fade' ? 'tbw-tree-fade-in' : 'tbw-tree-slide-in';\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 key = this.flattenedRows[idx]?.key;\n\n      if (key && this.keysToAnimate.has(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","toggleExpand","expandedKeys","key","newExpanded","expandAll","rows","config","depth","childrenField","keys","children","childKeys","k","collapseAll","getPathToKey","targetKey","childPath","expandToKey","existingExpanded","path","detectTreeStructure","inferChildrenField","commonArrayFields","field","value","TreePlugin","BaseGridPlugin","styles","query","treeRows","data","currentKeys","r","i","stableKey","hasChildren","expanded","result","isExpanded","dir","a","b","aVal","bVal","columns","cols","firstCol","originalRenderer","getConfig","setIcon","resolveIcon","wrappedRenderer","ctx","showExpandIcons","indentWidth","treeRow","container","icon","spacer","content","event","target","flatRow","focusRow","gridEl","style","body","animClass","rowEl","cell","idx"],"mappings":"gUAYO,SAASA,EAAeC,EAAcC,EAAeC,EAAkC,CAC5F,OAAIF,EAAI,KAAO,OAAkB,OAAOA,EAAI,EAAE,EACvCE,EAAY,GAAGA,CAAS,IAAID,CAAK,GAAK,OAAOA,CAAK,CAC3D,CA8CO,SAASE,EAAaC,EAA2BC,EAA0B,CAChF,MAAMC,EAAc,IAAI,IAAIF,CAAY,EACxC,OAAIE,EAAY,IAAID,CAAG,EACrBC,EAAY,OAAOD,CAAG,EAEtBC,EAAY,IAAID,CAAG,EAEdC,CACT,CAMO,SAASC,EACdC,EACAC,EACAP,EAA2B,KAC3BQ,EAAQ,EACK,CACb,MAAMC,EAAgBF,EAAO,eAAiB,WACxCG,MAAW,IAEjB,QAAS,EAAI,EAAG,EAAIJ,EAAK,OAAQ,IAAK,CACpC,MAAMR,EAAMQ,EAAK,CAAC,EACZH,EAAMN,EAAeC,EAAK,EAAGE,CAAS,EACtCW,EAAWb,EAAIW,CAAa,EAElC,GAAI,MAAM,QAAQE,CAAQ,GAAKA,EAAS,OAAS,EAAG,CAClDD,EAAK,IAAIP,CAAG,EACZ,MAAMS,EAAYP,EAAUM,EAAuBJ,EAAQJ,EAAKK,EAAQ,CAAC,EACzE,UAAWK,KAAKD,EAAWF,EAAK,IAAIG,CAAC,CACvC,CACF,CAEA,OAAOH,CACT,CAMO,SAASI,GAA2B,CACzC,WAAW,GACb,CAkCO,SAASC,EACdT,EACAU,EACAT,EACAP,EAA2B,KAC3BQ,EAAQ,EACS,CACjB,MAAMC,EAAgBF,EAAO,eAAiB,WAE9C,QAAS,EAAI,EAAG,EAAID,EAAK,OAAQ,IAAK,CACpC,MAAMR,EAAMQ,EAAK,CAAC,EACZH,EAAMN,EAAeC,EAAK,EAAGE,CAAS,EAE5C,GAAIG,IAAQa,EACV,MAAO,CAACb,CAAG,EAGb,MAAMQ,EAAWb,EAAIW,CAAa,EAClC,GAAI,MAAM,QAAQE,CAAQ,GAAKA,EAAS,OAAS,EAAG,CAClD,MAAMM,EAAYF,EAAaJ,EAAuBK,EAAWT,EAAQJ,EAAKK,EAAQ,CAAC,EACvF,GAAIS,EACF,MAAO,CAACd,EAAK,GAAGc,CAAS,CAE7B,CACF,CAEA,OAAO,IACT,CAMO,SAASC,EACdZ,EACAU,EACAT,EACAY,EACa,CACb,MAAMC,EAAOL,EAAaT,EAAMU,EAAWT,CAAM,EACjD,GAAI,CAACa,EAAM,OAAOD,EAElB,MAAMf,EAAc,IAAI,IAAIe,CAAgB,EAE5C,QAAS,EAAI,EAAG,EAAIC,EAAK,OAAS,EAAG,IACnChB,EAAY,IAAIgB,EAAK,CAAC,CAAC,EAEzB,OAAOhB,CACT,CChLO,SAASiB,EAAoBf,EAA0BG,EAAgB,WAAqB,CACjG,GAAI,CAAC,MAAM,QAAQH,CAAI,GAAKA,EAAK,SAAW,EAAG,MAAO,GAGtD,UAAWR,KAAOQ,EAAM,CACtB,GAAI,CAACR,EAAK,SACV,MAAMa,EAAWb,EAAIW,CAAa,EAClC,GAAI,MAAM,QAAQE,CAAQ,GAAKA,EAAS,OAAS,EAC/C,MAAO,EAEX,CAEA,MAAO,EACT,CAMO,SAASW,EAAmBhB,EAAyC,CAC1E,GAAI,CAAC,MAAM,QAAQA,CAAI,GAAKA,EAAK,SAAW,EAAG,OAAO,KAEtD,MAAMiB,EAAoB,CAAC,WAAY,QAAS,QAAS,UAAW,QAAQ,EAE5E,UAAWzB,KAAOQ,EAChB,GAAI,GAACR,GAAO,OAAOA,GAAQ,UAE3B,UAAW0B,KAASD,EAAmB,CACrC,MAAME,EAAQ3B,EAAI0B,CAAK,EACvB,GAAI,MAAM,QAAQC,CAAK,GAAKA,EAAM,OAAS,EACzC,OAAOD,CAEX,CAGF,OAAO,IACT,k+CC6DO,MAAME,UAAmBC,EAAAA,cAA2B,CACzD,OAAyB,SAA2B,CAClD,OAAQ,CACN,CACE,KAAM,oBACN,YAAa,8EAAA,CACf,EAEF,QAAS,CACP,CACE,KAAM,aACN,YAAa,yEAAA,CACf,CACF,EAIO,KAAO,OAEE,OAASC,EAG3B,IAAuB,eAAqC,CAC1D,MAAO,CACL,cAAe,WACf,WAAY,GACZ,gBAAiB,GACjB,YAAa,GACb,gBAAiB,GACjB,UAAW,OAAA,CAEf,CAIQ,iBAAmB,IACnB,qBAAuB,GACvB,cAAoC,CAAA,EACpC,cAAgB,IAChB,wBAA0B,IAC1B,kBAAoB,IACpB,UAAyD,KAGxD,QAAe,CACtB,KAAK,aAAa,MAAA,EAClB,KAAK,qBAAuB,GAC5B,KAAK,cAAgB,CAAA,EACrB,KAAK,UAAU,MAAA,EACf,KAAK,oBAAoB,MAAA,EACzB,KAAK,cAAc,MAAA,EACnB,KAAK,UAAY,IACnB,CAMS,YAAYC,EAA6B,CAChD,GAAIA,EAAM,OAAS,aAAc,CAE/B,MAAM/B,EAAM+B,EAAM,QAClB,GAAI/B,GAAOA,EAAI,KAAK,OAAO,eAAiB,UAAU,GAAG,OAAS,EAChE,MAAO,EAEX,CAEF,CAUA,IAAY,gBAA0C,CACpD,OAAK,KAAK,mBACH,KAAK,OAAO,WAAa,QADK,EAEvC,CAMA,OAAOQ,EAAmC,CACxC,GAAI,CAAC,KAAK,OAAO,WAAY,MAAO,GACpC,MAAMwB,EAAWxB,EACXkB,EAAQ,KAAK,OAAO,eAAiBF,EAAmBQ,CAAQ,GAAK,WAC3E,OAAOT,EAAoBS,EAAUN,CAAK,CAC5C,CAOS,YAAYlB,EAAqC,CACxD,MAAMG,EAAgB,KAAK,OAAO,eAAiB,WAC7CqB,EAAWxB,EAEjB,GAAI,CAACe,EAAoBS,EAAUrB,CAAa,EAC9C,YAAK,cAAgB,CAAA,EACrB,KAAK,UAAU,MAAA,EACf,KAAK,oBAAoB,MAAA,EAClB,CAAC,GAAGH,CAAI,EAIjB,IAAIyB,EAAO,KAAK,eAAeD,CAAQ,EACnC,KAAK,YACPC,EAAO,KAAK,SAASA,EAAM,KAAK,UAAU,MAAO,KAAK,UAAU,SAAS,GAIvE,KAAK,OAAO,iBAAmB,CAAC,KAAK,uBACvC,KAAK,aAAe1B,EAAU0B,EAAM,KAAK,MAAM,EAC/C,KAAK,qBAAuB,IAI9B,KAAK,cAAgB,KAAK,YAAYA,EAAM,KAAK,YAAY,EAC7D,KAAK,UAAU,MAAA,EACf,KAAK,cAAc,MAAA,EACnB,MAAMC,MAAkB,IAExB,UAAWlC,KAAO,KAAK,cACrB,KAAK,UAAU,IAAIA,EAAI,IAAKA,CAAG,EAC/BkC,EAAY,IAAIlC,EAAI,GAAG,EACnB,CAAC,KAAK,oBAAoB,IAAIA,EAAI,GAAG,GAAKA,EAAI,MAAQ,GACxD,KAAK,cAAc,IAAIA,EAAI,GAAG,EAGlC,YAAK,oBAAsBkC,EAEpB,KAAK,cAAc,IAAKC,IAAO,CACpC,GAAGA,EAAE,KACL,UAAWA,EAAE,IACb,YAAaA,EAAE,MACf,kBAAmBA,EAAE,YACrB,eAAgBA,EAAE,UAAA,EAClB,CACJ,CAGQ,eAAe3B,EAA0BN,EAA2B,KAAiB,CAC3F,MAAMS,EAAgB,KAAK,OAAO,eAAiB,WACnD,OAAOH,EAAK,IAAI,CAACR,EAAKoC,IAAM,CAC1B,MAAMC,EAAYrC,EAAI,YAChBK,EAAML,EAAI,KAAO,OAAY,OAAOA,EAAI,EAAE,EAAKqC,IAAcnC,EAAY,GAAGA,CAAS,IAAIkC,CAAC,GAAK,OAAOA,CAAC,GACvGvB,EAAWb,EAAIW,CAAa,EAC5B2B,EAAc,MAAM,QAAQzB,CAAQ,GAAKA,EAAS,OAAS,EACjE,MAAO,CACL,GAAGb,EACH,YAAaK,EACb,GAAIiC,EAAc,CAAE,CAAC3B,CAAa,EAAG,KAAK,eAAeE,EAAuBR,CAAG,GAAM,CAAA,CAAC,CAE9F,CAAC,CACH,CAGQ,YAAYG,EAA0B+B,EAAuB7B,EAAQ,EAAuB,CAClG,MAAMC,EAAgB,KAAK,OAAO,eAAiB,WAC7C6B,EAA6B,CAAA,EAEnC,UAAWxC,KAAOQ,EAAM,CAEtB,MAAMH,EADYL,EAAI,aACG,OAAOA,EAAI,IAAM,GAAG,EACvCa,EAAWb,EAAIW,CAAa,EAC5B2B,EAAc,MAAM,QAAQzB,CAAQ,GAAKA,EAAS,OAAS,EAC3D4B,EAAaF,EAAS,IAAIlC,CAAG,EAEnCmC,EAAO,KAAK,CACV,IAAAnC,EACA,KAAML,EACN,MAAAU,EACA,YAAA4B,EACA,WAAAG,EACA,UAAW/B,EAAQ,GAAIL,EAAI,UAAU,EAAGA,EAAI,YAAY,GAAG,CAAC,GAAK,IAAO,CACzE,EAEGiC,GAAeG,GACjBD,EAAO,KAAK,GAAG,KAAK,YAAY3B,EAAuB0B,EAAU7B,EAAQ,CAAC,CAAC,CAE/E,CACA,OAAO8B,CACT,CAGQ,SAAShC,EAA0BkB,EAAegB,EAAwB,CAChF,MAAM/B,EAAgB,KAAK,OAAO,eAAiB,WASnD,MARe,CAAC,GAAGH,CAAI,EAAE,KAAK,CAACmC,EAAGC,IAAM,CACtC,MAAMC,EAAOF,EAAEjB,CAAK,EAClBoB,EAAOF,EAAElB,CAAK,EAChB,OAAImB,GAAQ,MAAQC,GAAQ,KAAa,EACrCD,GAAQ,KAAa,GACrBC,GAAQ,KAAa,EAClBD,EAAOC,EAAOJ,EAAMG,EAAOC,EAAO,CAACJ,EAAM,CAClD,CAAC,EACa,IAAK1C,GAAQ,CACzB,MAAMa,EAAWb,EAAIW,CAAa,EAClC,OAAO,MAAM,QAAQE,CAAQ,GAAKA,EAAS,OAAS,EAChD,CAAE,GAAGb,EAAK,CAACW,CAAa,EAAG,KAAK,SAASE,EAAuBa,EAAOgB,CAAG,GAC1E1C,CACN,CAAC,CACH,CAGS,eAAe+C,EAAkD,CACxE,GAAI,KAAK,cAAc,SAAW,EAAG,MAAO,CAAC,GAAGA,CAAO,EAEvD,MAAMC,EAAO,CAAC,GAAGD,CAAO,EACxB,GAAIC,EAAK,SAAW,EAAG,OAAOA,EAO9B,MAAMC,EAAWD,EAAK,CAAC,EACjBE,EAAmBD,EAAS,aAC5BE,EAAY,IAAM,KAAK,OACvBC,EAAU,KAAK,QAAQ,KAAK,IAAI,EAChCC,EAAc,KAAK,YAAY,KAAK,IAAI,EAExCC,EAAuCC,GAAQ,CACnD,KAAM,CAAE,IAAAvD,EAAK,MAAA2B,CAAA,EAAU4B,EACjB,CAAE,gBAAAC,EAAkB,GAAM,YAAAC,CAAA,EAAgBN,EAAA,EAC1CO,EAAU1D,EACVU,EAAQgD,EAAQ,aAAe,EAE/BC,EAAY,SAAS,cAAc,MAAM,EAS/C,GARAA,EAAU,UAAY,oBACtBA,EAAU,MAAM,YAAY,mBAAoB,OAAOjD,CAAK,CAAC,EAEzD+C,IAAgB,QAClBE,EAAU,MAAM,YAAY,0BAA2B,GAAGF,CAAW,IAAI,EAIvED,EACF,GAAIE,EAAQ,kBAAmB,CAC7B,MAAME,EAAO,SAAS,cAAc,MAAM,EAC1CA,EAAK,UAAY,cAAcF,EAAQ,eAAiB,YAAc,EAAE,GACxEN,EAAQQ,EAAMP,EAAYK,EAAQ,eAAiB,WAAa,QAAQ,CAAC,EACzEE,EAAK,aAAa,gBAAiB,OAAOF,EAAQ,WAAa,EAAE,CAAC,EAClEC,EAAU,YAAYC,CAAI,CAC5B,KAAO,CACL,MAAMC,EAAS,SAAS,cAAc,MAAM,EAC5CA,EAAO,UAAY,cACnBF,EAAU,YAAYE,CAAM,CAC9B,CAIF,MAAMC,EAAU,SAAS,cAAc,MAAM,EAE7C,GADAA,EAAQ,UAAY,eAChBZ,EAAkB,CACpB,MAAMV,EAASU,EAAiBK,CAAG,EAC/Bf,aAAkB,KACpBsB,EAAQ,YAAYtB,CAAM,EACjB,OAAOA,GAAW,WAC3BsB,EAAQ,UAAYtB,EAExB,MACEsB,EAAQ,YAAcnC,GAAS,KAAO,OAAOA,CAAK,EAAI,GAExD,OAAAgC,EAAU,YAAYG,CAAO,EAEtBH,CACT,EAEA,OAAAX,EAAK,CAAC,EAAI,CAAE,GAAGC,EAAU,aAAcK,CAAA,EAChCN,CACT,CAOS,YAAYe,EAAgC,CACnD,MAAMC,EAASD,EAAM,eAAe,OACpC,GAAI,CAACC,GAAQ,UAAU,SAAS,aAAa,EAAG,MAAO,GAEvD,MAAM3D,EAAM2D,EAAO,aAAa,eAAe,EAC/C,GAAI,CAAC3D,EAAK,MAAO,GAEjB,MAAM4D,EAAU,KAAK,UAAU,IAAI5D,CAAG,EACtC,OAAK4D,GAEL,KAAK,aAAe9D,EAAa,KAAK,aAAcE,CAAG,EACvD,KAAK,KAAuB,cAAe,CACzC,IAAAA,EACA,IAAK4D,EAAQ,KACb,SAAU,KAAK,aAAa,IAAI5D,CAAG,EACnC,MAAO4D,EAAQ,KAAA,CAChB,EACD,KAAK,cAAA,EACE,IAVc,EAWvB,CAGS,UAAUF,EAAsC,CAEvD,GAAIA,EAAM,MAAQ,IAAK,OAEvB,MAAMG,EAAW,KAAK,KAAK,UACrBD,EAAU,KAAK,cAAcC,CAAQ,EAC3C,GAAKD,GAAS,YAEd,OAAAF,EAAM,eAAA,EACN,KAAK,aAAe5D,EAAa,KAAK,aAAc8D,EAAQ,GAAG,EAC/D,KAAK,KAAuB,cAAe,CACzC,IAAKA,EAAQ,IACb,IAAKA,EAAQ,KACb,SAAU,KAAK,aAAa,IAAIA,EAAQ,GAAG,EAC3C,MAAOA,EAAQ,KAAA,CAChB,EACD,KAAK,uBAAA,EACE,EACT,CAGS,cAAcF,EAAkC,CACvD,GAAI,KAAK,cAAc,SAAW,GAAK,CAACA,EAAM,OAAO,SAAU,MAAO,GAEtE,KAAM,CAAE,MAAArC,GAAUqC,EAAM,OACpB,CAAC,KAAK,WAAa,KAAK,UAAU,QAAUrC,EAC9C,KAAK,UAAY,CAAE,MAAAA,EAAO,UAAW,CAAA,EAC5B,KAAK,UAAU,YAAc,EACtC,KAAK,UAAY,CAAE,MAAAA,EAAO,UAAW,EAAA,EAErC,KAAK,UAAY,KAInB,MAAMyC,EAAS,KAAK,KACpB,OAAIA,EAAO,aAAe,SACxBA,EAAO,WAAa,KAAK,UAAY,CAAE,GAAG,KAAK,WAAc,MAG/D,KAAK,KAAK,cAAe,CAAE,MAAAzC,EAAO,UAAW,KAAK,WAAW,WAAa,EAAG,EAC7E,KAAK,cAAA,EACE,EACT,CAGS,aAAoB,CAC3B,MAAM0C,EAAQ,KAAK,eACnB,GAAIA,IAAU,IAAS,KAAK,cAAc,OAAS,EAAG,OAEtD,MAAMC,EAAO,KAAK,aAAa,cAAc,OAAO,EACpD,GAAI,CAACA,EAAM,OAEX,MAAMC,EAAYF,IAAU,OAAS,mBAAqB,oBAC1D,UAAWG,KAASF,EAAK,iBAAiB,gBAAgB,EAAG,CAC3D,MAAMG,EAAOD,EAAM,cAAc,iBAAiB,EAC5CE,EAAMD,EAAO,SAASA,EAAK,aAAa,UAAU,GAAK,KAAM,EAAE,EAAI,GACnEnE,EAAM,KAAK,cAAcoE,CAAG,GAAG,IAEjCpE,GAAO,KAAK,cAAc,IAAIA,CAAG,IACnCkE,EAAM,UAAU,IAAID,CAAS,EAC7BC,EAAM,iBAAiB,eAAgB,IAAMA,EAAM,UAAU,OAAOD,CAAS,EAAG,CAAE,KAAM,EAAA,CAAM,EAElG,CACA,KAAK,cAAc,MAAA,CACrB,CAMA,OAAOjE,EAAmB,CACxB,KAAK,aAAa,IAAIA,CAAG,EACzB,KAAK,cAAA,CACP,CAEA,SAASA,EAAmB,CAC1B,KAAK,aAAa,OAAOA,CAAG,EAC5B,KAAK,cAAA,CACP,CAEA,OAAOA,EAAmB,CACxB,KAAK,aAAeF,EAAa,KAAK,aAAcE,CAAG,EACvD,KAAK,gBAAgB,oBAAqB,CAAE,aAAc,CAAC,GAAG,KAAK,YAAY,EAAG,EAClF,KAAK,cAAA,CACP,CAEA,WAAkB,CAChB,KAAK,aAAeE,EAAU,KAAK,KAAmB,KAAK,MAAM,EACjE,KAAK,gBAAgB,oBAAqB,CAAE,aAAc,CAAC,GAAG,KAAK,YAAY,EAAG,EAClF,KAAK,cAAA,CACP,CAEA,aAAoB,CAClB,KAAK,aAAeS,EAAA,EACpB,KAAK,gBAAgB,oBAAqB,CAAE,aAAc,CAAC,GAAG,KAAK,YAAY,EAAG,EAClF,KAAK,cAAA,CACP,CAEA,WAAWX,EAAsB,CAC/B,OAAO,KAAK,aAAa,IAAIA,CAAG,CAClC,CAEA,iBAA4B,CAC1B,MAAO,CAAC,GAAG,KAAK,YAAY,CAC9B,CAEA,kBAAuC,CACrC,MAAO,CAAC,GAAG,KAAK,aAAa,CAC/B,CAEA,YAAYA,EAAkC,CAC5C,OAAO,KAAK,UAAU,IAAIA,CAAG,GAAG,IAClC,CAEA,YAAYA,EAAmB,CAC7B,KAAK,aAAee,EAAY,KAAK,KAAmBf,EAAK,KAAK,OAAQ,KAAK,YAAY,EAC3F,KAAK,cAAA,CACP,CAGF"}

package/umd/plugins/undo-redo.umd.js

@@ -1,2 +1,2 @@
-(function(i,d){typeof exports=="object"&&typeof module<"u"?d(exports,require("../../core/plugin/base-plugin")):typeof define=="function"&&define.amd?define(["exports","../../core/plugin/base-plugin"],d):(i=typeof globalThis<"u"?globalThis:i||self,d(i.TbwGridPlugin_undoRedo={},i.TbwGrid))})(this,(function(i,d){"use strict";function S(e,t,n){const c=[...e.undoStack,t];for(;c.length>n;)c.shift();return{undoStack:c,redoStack:[]}}function r(e){if(e.undoStack.length===0)return{newState:e,action:null};const t=[...e.undoStack],n=t.pop();return n?{newState:{undoStack:t,redoStack:[...e.redoStack,n]},action:n}:{newState:e,action:null}}function u(e){if(e.redoStack.length===0)return{newState:e,action:null};const t=[...e.redoStack],n=t.pop();return n?{newState:{undoStack:[...e.undoStack,n],redoStack:t},action:n}:{newState:e,action:null}}function k(e){return e.undoStack.length>0}function h(e){return e.redoStack.length>0}function l(){return{undoStack:[],redoStack:[]}}function f(e,t,n,c){return{type:"cell-edit",rowIndex:e,field:t,oldValue:n,newValue:c,timestamp:Date.now()}}class w extends d.BaseGridPlugin{static dependencies=[{name:"editing",required:!0,reason:"UndoRedoPlugin tracks cell edit history"}];name="undoRedo";get defaultConfig(){return{maxHistorySize:100}}undoStack=[];redoStack=[];detach(){this.undoStack=[],this.redoStack=[]}onKeyDown(t){const n=(t.ctrlKey||t.metaKey)&&t.key==="z"&&!t.shiftKey,c=(t.ctrlKey||t.metaKey)&&(t.key==="y"||t.key==="z"&&t.shiftKey);if(n){const o=r({undoStack:this.undoStack,redoStack:this.redoStack});if(o.action){const a=this.rows;a[o.action.rowIndex]&&(a[o.action.rowIndex][o.action.field]=o.action.oldValue),this.undoStack=o.newState.undoStack,this.redoStack=o.newState.redoStack,this.emit("undo",{action:o.action,type:"undo"}),this.requestRender()}return!0}if(c){const o=u({undoStack:this.undoStack,redoStack:this.redoStack});if(o.action){const a=this.rows;a[o.action.rowIndex]&&(a[o.action.rowIndex][o.action.field]=o.action.newValue),this.undoStack=o.newState.undoStack,this.redoStack=o.newState.redoStack,this.emit("redo",{action:o.action,type:"redo"}),this.requestRender()}return!0}return!1}recordEdit(t,n,c,o){const a=f(t,n,c,o),s=S({undoStack:this.undoStack,redoStack:this.redoStack},a,this.config.maxHistorySize??100);this.undoStack=s.undoStack,this.redoStack=s.redoStack}undo(){const t=r({undoStack:this.undoStack,redoStack:this.redoStack});if(t.action){const n=this.rows;n[t.action.rowIndex]&&(n[t.action.rowIndex][t.action.field]=t.action.oldValue),this.undoStack=t.newState.undoStack,this.redoStack=t.newState.redoStack,this.requestRender()}return t.action}redo(){const t=u({undoStack:this.undoStack,redoStack:this.redoStack});if(t.action){const n=this.rows;n[t.action.rowIndex]&&(n[t.action.rowIndex][t.action.field]=t.action.newValue),this.undoStack=t.newState.undoStack,this.redoStack=t.newState.redoStack,this.requestRender()}return t.action}canUndo(){return k({undoStack:this.undoStack,redoStack:this.redoStack})}canRedo(){return h({undoStack:this.undoStack,redoStack:this.redoStack})}clearHistory(){const t=l();this.undoStack=t.undoStack,this.redoStack=t.redoStack}getUndoStack(){return[...this.undoStack]}getRedoStack(){return[...this.redoStack]}}i.UndoRedoPlugin=w,Object.defineProperty(i,Symbol.toStringTag,{value:"Module"})}));
+(function(i,d){typeof exports=="object"&&typeof module<"u"?d(exports,require("../../core/plugin/base-plugin")):typeof define=="function"&&define.amd?define(["exports","../../core/plugin/base-plugin"],d):(i=typeof globalThis<"u"?globalThis:i||self,d(i.TbwGridPlugin_undoRedo={},i.TbwGrid))})(this,(function(i,d){"use strict";function S(n,t,e){const c=[...n.undoStack,t];for(;c.length>e;)c.shift();return{undoStack:c,redoStack:[]}}function r(n){if(n.undoStack.length===0)return{newState:n,action:null};const t=[...n.undoStack],e=t.pop();return e?{newState:{undoStack:t,redoStack:[...n.redoStack,e]},action:e}:{newState:n,action:null}}function u(n){if(n.redoStack.length===0)return{newState:n,action:null};const t=[...n.redoStack],e=t.pop();return e?{newState:{undoStack:[...n.undoStack,e],redoStack:t},action:e}:{newState:n,action:null}}function k(n){return n.undoStack.length>0}function h(n){return n.redoStack.length>0}function l(){return{undoStack:[],redoStack:[]}}function f(n,t,e,c){return{type:"cell-edit",rowIndex:n,field:t,oldValue:e,newValue:c,timestamp:Date.now()}}class w extends d.BaseGridPlugin{static dependencies=[{name:"editing",required:!0,reason:"UndoRedoPlugin tracks cell edit history"}];name="undoRedo";get defaultConfig(){return{maxHistorySize:100}}undoStack=[];redoStack=[];attach(t){super.attach(t),this.on("cell-edit-committed",e=>{this.recordEdit(e.rowIndex,e.field,e.oldValue,e.newValue)})}detach(){this.undoStack=[],this.redoStack=[]}onKeyDown(t){const e=(t.ctrlKey||t.metaKey)&&t.key==="z"&&!t.shiftKey,c=(t.ctrlKey||t.metaKey)&&(t.key==="y"||t.key==="z"&&t.shiftKey);if(e){const o=r({undoStack:this.undoStack,redoStack:this.redoStack});if(o.action){const a=this.rows;a[o.action.rowIndex]&&(a[o.action.rowIndex][o.action.field]=o.action.oldValue),this.undoStack=o.newState.undoStack,this.redoStack=o.newState.redoStack,this.emit("undo",{action:o.action,type:"undo"}),this.requestRender()}return!0}if(c){const o=u({undoStack:this.undoStack,redoStack:this.redoStack});if(o.action){const a=this.rows;a[o.action.rowIndex]&&(a[o.action.rowIndex][o.action.field]=o.action.newValue),this.undoStack=o.newState.undoStack,this.redoStack=o.newState.redoStack,this.emit("redo",{action:o.action,type:"redo"}),this.requestRender()}return!0}return!1}recordEdit(t,e,c,o){const a=f(t,e,c,o),s=S({undoStack:this.undoStack,redoStack:this.redoStack},a,this.config.maxHistorySize??100);this.undoStack=s.undoStack,this.redoStack=s.redoStack}undo(){const t=r({undoStack:this.undoStack,redoStack:this.redoStack});if(t.action){const e=this.rows;e[t.action.rowIndex]&&(e[t.action.rowIndex][t.action.field]=t.action.oldValue),this.undoStack=t.newState.undoStack,this.redoStack=t.newState.redoStack,this.requestRender()}return t.action}redo(){const t=u({undoStack:this.undoStack,redoStack:this.redoStack});if(t.action){const e=this.rows;e[t.action.rowIndex]&&(e[t.action.rowIndex][t.action.field]=t.action.newValue),this.undoStack=t.newState.undoStack,this.redoStack=t.newState.redoStack,this.requestRender()}return t.action}canUndo(){return k({undoStack:this.undoStack,redoStack:this.redoStack})}canRedo(){return h({undoStack:this.undoStack,redoStack:this.redoStack})}clearHistory(){const t=l();this.undoStack=t.undoStack,this.redoStack=t.redoStack}getUndoStack(){return[...this.undoStack]}getRedoStack(){return[...this.redoStack]}}i.UndoRedoPlugin=w,Object.defineProperty(i,Symbol.toStringTag,{value:"Module"})}));
 //# sourceMappingURL=undo-redo.umd.js.map

package/umd/plugins/undo-redo.umd.js.map

@@ -1 +1 @@
-{"version":3,"file":"undo-redo.umd.js","sources":["../../../../../libs/grid/src/lib/plugins/undo-redo/history.ts","../../../../../libs/grid/src/lib/plugins/undo-redo/UndoRedoPlugin.ts"],"sourcesContent":["/**\n * Undo/Redo History Management\n *\n * Pure functions for managing the undo/redo stacks.\n * These functions are stateless and return new state objects.\n */\n\nimport type { EditAction, UndoRedoState } from './types';\n\n/**\n * Push a new action onto the undo stack.\n * Clears the redo stack since new actions invalidate redo history.\n *\n * @param state - Current undo/redo state\n * @param action - The action to add\n * @param maxSize - Maximum history size\n * @returns New state with the action added\n */\nexport function pushAction(state: UndoRedoState, action: EditAction, maxSize: number): UndoRedoState {\n  const undoStack = [...state.undoStack, action];\n\n  // Trim oldest actions if over max size\n  while (undoStack.length > maxSize) {\n    undoStack.shift();\n  }\n\n  return {\n    undoStack,\n    redoStack: [], // Clear redo on new action\n  };\n}\n\n/**\n * Undo the most recent action.\n * Moves the action from undo stack to redo stack.\n *\n * @param state - Current undo/redo state\n * @returns New state and the action that was undone (or null if nothing to undo)\n */\nexport function undo(state: UndoRedoState): {\n  newState: UndoRedoState;\n  action: EditAction | null;\n} {\n  if (state.undoStack.length === 0) {\n    return { newState: state, action: null };\n  }\n\n  const undoStack = [...state.undoStack];\n  const action = undoStack.pop();\n\n  // This should never happen due to the length check above,\n  // but TypeScript needs the explicit check\n  if (!action) {\n    return { newState: state, action: null };\n  }\n\n  return {\n    newState: {\n      undoStack,\n      redoStack: [...state.redoStack, action],\n    },\n    action,\n  };\n}\n\n/**\n * Redo the most recently undone action.\n * Moves the action from redo stack back to undo stack.\n *\n * @param state - Current undo/redo state\n * @returns New state and the action that was redone (or null if nothing to redo)\n */\nexport function redo(state: UndoRedoState): {\n  newState: UndoRedoState;\n  action: EditAction | null;\n} {\n  if (state.redoStack.length === 0) {\n    return { newState: state, action: null };\n  }\n\n  const redoStack = [...state.redoStack];\n  const action = redoStack.pop();\n\n  // This should never happen due to the length check above,\n  // but TypeScript needs the explicit check\n  if (!action) {\n    return { newState: state, action: null };\n  }\n\n  return {\n    newState: {\n      undoStack: [...state.undoStack, action],\n      redoStack,\n    },\n    action,\n  };\n}\n\n/**\n * Check if there are any actions that can be undone.\n *\n * @param state - Current undo/redo state\n * @returns True if undo is available\n */\nexport function canUndo(state: UndoRedoState): boolean {\n  return state.undoStack.length > 0;\n}\n\n/**\n * Check if there are any actions that can be redone.\n *\n * @param state - Current undo/redo state\n * @returns True if redo is available\n */\nexport function canRedo(state: UndoRedoState): boolean {\n  return state.redoStack.length > 0;\n}\n\n/**\n * Clear all history, returning an empty state.\n *\n * @returns Fresh empty state\n */\nexport function clearHistory(): UndoRedoState {\n  return { undoStack: [], redoStack: [] };\n}\n\n/**\n * Create a new edit action with the current timestamp.\n *\n * @param rowIndex - The row index where the edit occurred\n * @param field - The field (column key) that was edited\n * @param oldValue - The value before the edit\n * @param newValue - The value after the edit\n * @returns A new EditAction object\n */\nexport function createEditAction(rowIndex: number, field: string, oldValue: unknown, newValue: unknown): EditAction {\n  return {\n    type: 'cell-edit',\n    rowIndex,\n    field,\n    oldValue,\n    newValue,\n    timestamp: Date.now(),\n  };\n}\n","/**\n * Undo/Redo Plugin (Class-based)\n *\n * Provides undo/redo functionality for cell edits in tbw-grid.\n * Supports Ctrl+Z/Cmd+Z for undo and Ctrl+Y/Cmd+Y (or Ctrl+Shift+Z) for redo.\n */\n\nimport { BaseGridPlugin, type PluginDependency } from '../../core/plugin/base-plugin';\nimport { canRedo, canUndo, clearHistory, createEditAction, pushAction, redo, undo } from './history';\nimport type { EditAction, UndoRedoConfig, UndoRedoDetail } from './types';\n\n/**\n * Undo/Redo Plugin for tbw-grid\n *\n * Tracks all cell edits and lets users revert or replay changes with familiar keyboard\n * shortcuts (Ctrl+Z / Ctrl+Y). Maintains an in-memory history stack with configurable\n * depth—perfect for data entry workflows where mistakes happen.\n *\n * > **Required Dependency:** This plugin requires EditingPlugin to be loaded first.\n * > UndoRedo tracks the edit history that EditingPlugin creates.\n *\n * ## Installation\n *\n * ```ts\n * import { EditingPlugin } from '@toolbox-web/grid/plugins/editing';\n * import { UndoRedoPlugin } from '@toolbox-web/grid/plugins/undo-redo';\n * ```\n *\n * ## Configuration Options\n *\n * | Option | Type | Default | Description |\n * |--------|------|---------|-------------|\n * | `maxHistorySize` | `number` | `100` | Maximum actions in history stack |\n *\n * ## Keyboard Shortcuts\n *\n * | Shortcut | Action |\n * |----------|--------|\n * | `Ctrl+Z` / `Cmd+Z` | Undo last edit |\n * | `Ctrl+Y` / `Cmd+Shift+Z` | Redo last undone edit |\n *\n * ## Programmatic API\n *\n * | Method | Signature | Description |\n * |--------|-----------|-------------|\n * | `undo` | `() => void` | Undo the last edit |\n * | `redo` | `() => void` | Redo the last undone edit |\n * | `canUndo` | `() => boolean` | Check if undo is available |\n * | `canRedo` | `() => boolean` | Check if redo is available |\n * | `clearHistory` | `() => void` | Clear the entire history stack |\n *\n * @example Basic Usage with EditingPlugin\n * ```ts\n * import '@toolbox-web/grid';\n * import { EditingPlugin } from '@toolbox-web/grid/plugins/editing';\n * import { UndoRedoPlugin } from '@toolbox-web/grid/plugins/undo-redo';\n *\n * const grid = document.querySelector('tbw-grid');\n * grid.gridConfig = {\n *   columns: [\n *     { field: 'name', header: 'Name', editable: true },\n *     { field: 'price', header: 'Price', type: 'number', editable: true },\n *   ],\n *   plugins: [\n *     new EditingPlugin({ editOn: 'dblclick' }), // Required - must be first\n *     new UndoRedoPlugin({ maxHistorySize: 50 }),\n *   ],\n * };\n * ```\n *\n * @see {@link UndoRedoConfig} for configuration options\n * @see {@link EditingPlugin} for the required dependency\n *\n * @internal Extends BaseGridPlugin\n */\nexport class UndoRedoPlugin extends BaseGridPlugin<UndoRedoConfig> {\n  /**\n   * Plugin dependencies - UndoRedoPlugin requires EditingPlugin to track edits.\n   *\n   * The EditingPlugin must be loaded BEFORE this plugin in the plugins array.\n   * @internal\n   */\n  static override readonly dependencies: PluginDependency[] = [\n    { name: 'editing', required: true, reason: 'UndoRedoPlugin tracks cell edit history' },\n  ];\n\n  /** @internal */\n  readonly name = 'undoRedo';\n\n  /** @internal */\n  protected override get defaultConfig(): Partial<UndoRedoConfig> {\n    return {\n      maxHistorySize: 100,\n    };\n  }\n\n  // State as class properties\n  private undoStack: EditAction[] = [];\n  private redoStack: EditAction[] = [];\n\n  /**\n   * Clean up state when plugin is detached.\n   * @internal\n   */\n  override detach(): void {\n    this.undoStack = [];\n    this.redoStack = [];\n  }\n\n  /**\n   * Handle keyboard shortcuts for undo/redo.\n   * - Ctrl+Z / Cmd+Z: Undo\n   * - Ctrl+Y / Cmd+Y / Ctrl+Shift+Z / Cmd+Shift+Z: Redo\n   * @internal\n   */\n  override onKeyDown(event: KeyboardEvent): boolean {\n    const isUndo = (event.ctrlKey || event.metaKey) && event.key === 'z' && !event.shiftKey;\n    const isRedo = (event.ctrlKey || event.metaKey) && (event.key === 'y' || (event.key === 'z' && event.shiftKey));\n\n    if (isUndo) {\n      const result = undo({ undoStack: this.undoStack, redoStack: this.redoStack });\n      if (result.action) {\n        // Apply undo - restore old value\n        const rows = this.rows as Record<string, unknown>[];\n        if (rows[result.action.rowIndex]) {\n          rows[result.action.rowIndex][result.action.field] = result.action.oldValue;\n        }\n\n        // Update state from result\n        this.undoStack = result.newState.undoStack;\n        this.redoStack = result.newState.redoStack;\n\n        this.emit<UndoRedoDetail>('undo', {\n          action: result.action,\n          type: 'undo',\n        });\n\n        this.requestRender();\n      }\n      return true;\n    }\n\n    if (isRedo) {\n      const result = redo({ undoStack: this.undoStack, redoStack: this.redoStack });\n      if (result.action) {\n        // Apply redo - restore new value\n        const rows = this.rows as Record<string, unknown>[];\n        if (rows[result.action.rowIndex]) {\n          rows[result.action.rowIndex][result.action.field] = result.action.newValue;\n        }\n\n        // Update state from result\n        this.undoStack = result.newState.undoStack;\n        this.redoStack = result.newState.redoStack;\n\n        this.emit<UndoRedoDetail>('redo', {\n          action: result.action,\n          type: 'redo',\n        });\n\n        this.requestRender();\n      }\n      return true;\n    }\n\n    return false;\n  }\n\n  // #region Public API Methods\n\n  /**\n   * Record a cell edit for undo/redo tracking.\n   * Call this when a cell value changes.\n   *\n   * @param rowIndex - The row index where the edit occurred\n   * @param field - The field (column key) that was edited\n   * @param oldValue - The value before the edit\n   * @param newValue - The value after the edit\n   */\n  recordEdit(rowIndex: number, field: string, oldValue: unknown, newValue: unknown): void {\n    const action = createEditAction(rowIndex, field, oldValue, newValue);\n    const newState = pushAction(\n      { undoStack: this.undoStack, redoStack: this.redoStack },\n      action,\n      this.config.maxHistorySize ?? 100,\n    );\n    this.undoStack = newState.undoStack;\n    this.redoStack = newState.redoStack;\n  }\n\n  /**\n   * Programmatically undo the last action.\n   *\n   * @returns The undone action, or null if nothing to undo\n   */\n  undo(): EditAction | null {\n    const result = undo({ undoStack: this.undoStack, redoStack: this.redoStack });\n    if (result.action) {\n      const rows = this.rows as Record<string, unknown>[];\n      if (rows[result.action.rowIndex]) {\n        rows[result.action.rowIndex][result.action.field] = result.action.oldValue;\n      }\n      this.undoStack = result.newState.undoStack;\n      this.redoStack = result.newState.redoStack;\n      this.requestRender();\n    }\n    return result.action;\n  }\n\n  /**\n   * Programmatically redo the last undone action.\n   *\n   * @returns The redone action, or null if nothing to redo\n   */\n  redo(): EditAction | null {\n    const result = redo({ undoStack: this.undoStack, redoStack: this.redoStack });\n    if (result.action) {\n      const rows = this.rows as Record<string, unknown>[];\n      if (rows[result.action.rowIndex]) {\n        rows[result.action.rowIndex][result.action.field] = result.action.newValue;\n      }\n      this.undoStack = result.newState.undoStack;\n      this.redoStack = result.newState.redoStack;\n      this.requestRender();\n    }\n    return result.action;\n  }\n\n  /**\n   * Check if there are any actions that can be undone.\n   */\n  canUndo(): boolean {\n    return canUndo({ undoStack: this.undoStack, redoStack: this.redoStack });\n  }\n\n  /**\n   * Check if there are any actions that can be redone.\n   */\n  canRedo(): boolean {\n    return canRedo({ undoStack: this.undoStack, redoStack: this.redoStack });\n  }\n\n  /**\n   * Clear all undo/redo history.\n   */\n  clearHistory(): void {\n    const newState = clearHistory();\n    this.undoStack = newState.undoStack;\n    this.redoStack = newState.redoStack;\n  }\n\n  /**\n   * Get a copy of the current undo stack.\n   */\n  getUndoStack(): EditAction[] {\n    return [...this.undoStack];\n  }\n\n  /**\n   * Get a copy of the current redo stack.\n   */\n  getRedoStack(): EditAction[] {\n    return [...this.redoStack];\n  }\n  // #endregion\n}\n"],"names":["pushAction","state","action","maxSize","undoStack","undo","redo","redoStack","canUndo","canRedo","clearHistory","createEditAction","rowIndex","field","oldValue","newValue","UndoRedoPlugin","BaseGridPlugin","event","isUndo","isRedo","result","rows","newState"],"mappings":"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"}
+{"version":3,"file":"undo-redo.umd.js","sources":["../../../../../libs/grid/src/lib/plugins/undo-redo/history.ts","../../../../../libs/grid/src/lib/plugins/undo-redo/UndoRedoPlugin.ts"],"sourcesContent":["/**\n * Undo/Redo History Management\n *\n * Pure functions for managing the undo/redo stacks.\n * These functions are stateless and return new state objects.\n */\n\nimport type { EditAction, UndoRedoState } from './types';\n\n/**\n * Push a new action onto the undo stack.\n * Clears the redo stack since new actions invalidate redo history.\n *\n * @param state - Current undo/redo state\n * @param action - The action to add\n * @param maxSize - Maximum history size\n * @returns New state with the action added\n */\nexport function pushAction(state: UndoRedoState, action: EditAction, maxSize: number): UndoRedoState {\n  const undoStack = [...state.undoStack, action];\n\n  // Trim oldest actions if over max size\n  while (undoStack.length > maxSize) {\n    undoStack.shift();\n  }\n\n  return {\n    undoStack,\n    redoStack: [], // Clear redo on new action\n  };\n}\n\n/**\n * Undo the most recent action.\n * Moves the action from undo stack to redo stack.\n *\n * @param state - Current undo/redo state\n * @returns New state and the action that was undone (or null if nothing to undo)\n */\nexport function undo(state: UndoRedoState): {\n  newState: UndoRedoState;\n  action: EditAction | null;\n} {\n  if (state.undoStack.length === 0) {\n    return { newState: state, action: null };\n  }\n\n  const undoStack = [...state.undoStack];\n  const action = undoStack.pop();\n\n  // This should never happen due to the length check above,\n  // but TypeScript needs the explicit check\n  if (!action) {\n    return { newState: state, action: null };\n  }\n\n  return {\n    newState: {\n      undoStack,\n      redoStack: [...state.redoStack, action],\n    },\n    action,\n  };\n}\n\n/**\n * Redo the most recently undone action.\n * Moves the action from redo stack back to undo stack.\n *\n * @param state - Current undo/redo state\n * @returns New state and the action that was redone (or null if nothing to redo)\n */\nexport function redo(state: UndoRedoState): {\n  newState: UndoRedoState;\n  action: EditAction | null;\n} {\n  if (state.redoStack.length === 0) {\n    return { newState: state, action: null };\n  }\n\n  const redoStack = [...state.redoStack];\n  const action = redoStack.pop();\n\n  // This should never happen due to the length check above,\n  // but TypeScript needs the explicit check\n  if (!action) {\n    return { newState: state, action: null };\n  }\n\n  return {\n    newState: {\n      undoStack: [...state.undoStack, action],\n      redoStack,\n    },\n    action,\n  };\n}\n\n/**\n * Check if there are any actions that can be undone.\n *\n * @param state - Current undo/redo state\n * @returns True if undo is available\n */\nexport function canUndo(state: UndoRedoState): boolean {\n  return state.undoStack.length > 0;\n}\n\n/**\n * Check if there are any actions that can be redone.\n *\n * @param state - Current undo/redo state\n * @returns True if redo is available\n */\nexport function canRedo(state: UndoRedoState): boolean {\n  return state.redoStack.length > 0;\n}\n\n/**\n * Clear all history, returning an empty state.\n *\n * @returns Fresh empty state\n */\nexport function clearHistory(): UndoRedoState {\n  return { undoStack: [], redoStack: [] };\n}\n\n/**\n * Create a new edit action with the current timestamp.\n *\n * @param rowIndex - The row index where the edit occurred\n * @param field - The field (column key) that was edited\n * @param oldValue - The value before the edit\n * @param newValue - The value after the edit\n * @returns A new EditAction object\n */\nexport function createEditAction(rowIndex: number, field: string, oldValue: unknown, newValue: unknown): EditAction {\n  return {\n    type: 'cell-edit',\n    rowIndex,\n    field,\n    oldValue,\n    newValue,\n    timestamp: Date.now(),\n  };\n}\n","/**\n * Undo/Redo Plugin (Class-based)\n *\n * Provides undo/redo functionality for cell edits in tbw-grid.\n * Supports Ctrl+Z/Cmd+Z for undo and Ctrl+Y/Cmd+Y (or Ctrl+Shift+Z) for redo.\n */\n\nimport { BaseGridPlugin, type GridElement, type PluginDependency } from '../../core/plugin/base-plugin';\nimport { canRedo, canUndo, clearHistory, createEditAction, pushAction, redo, undo } from './history';\nimport type { EditAction, UndoRedoConfig, UndoRedoDetail } from './types';\n\n/**\n * Undo/Redo Plugin for tbw-grid\n *\n * Tracks all cell edits and lets users revert or replay changes with familiar keyboard\n * shortcuts (Ctrl+Z / Ctrl+Y). Maintains an in-memory history stack with configurable\n * depth—perfect for data entry workflows where mistakes happen.\n *\n * > **Required Dependency:** This plugin requires EditingPlugin to be loaded first.\n * > UndoRedo tracks the edit history that EditingPlugin creates.\n *\n * ## Installation\n *\n * ```ts\n * import { EditingPlugin } from '@toolbox-web/grid/plugins/editing';\n * import { UndoRedoPlugin } from '@toolbox-web/grid/plugins/undo-redo';\n * ```\n *\n * ## Configuration Options\n *\n * | Option | Type | Default | Description |\n * |--------|------|---------|-------------|\n * | `maxHistorySize` | `number` | `100` | Maximum actions in history stack |\n *\n * ## Keyboard Shortcuts\n *\n * | Shortcut | Action |\n * |----------|--------|\n * | `Ctrl+Z` / `Cmd+Z` | Undo last edit |\n * | `Ctrl+Y` / `Cmd+Shift+Z` | Redo last undone edit |\n *\n * ## Programmatic API\n *\n * | Method | Signature | Description |\n * |--------|-----------|-------------|\n * | `undo` | `() => void` | Undo the last edit |\n * | `redo` | `() => void` | Redo the last undone edit |\n * | `canUndo` | `() => boolean` | Check if undo is available |\n * | `canRedo` | `() => boolean` | Check if redo is available |\n * | `clearHistory` | `() => void` | Clear the entire history stack |\n *\n * @example Basic Usage with EditingPlugin\n * ```ts\n * import '@toolbox-web/grid';\n * import { EditingPlugin } from '@toolbox-web/grid/plugins/editing';\n * import { UndoRedoPlugin } from '@toolbox-web/grid/plugins/undo-redo';\n *\n * const grid = document.querySelector('tbw-grid');\n * grid.gridConfig = {\n *   columns: [\n *     { field: 'name', header: 'Name', editable: true },\n *     { field: 'price', header: 'Price', type: 'number', editable: true },\n *   ],\n *   plugins: [\n *     new EditingPlugin({ editOn: 'dblclick' }), // Required - must be first\n *     new UndoRedoPlugin({ maxHistorySize: 50 }),\n *   ],\n * };\n * ```\n *\n * @see {@link UndoRedoConfig} for configuration options\n * @see {@link EditingPlugin} for the required dependency\n *\n * @internal Extends BaseGridPlugin\n */\nexport class UndoRedoPlugin extends BaseGridPlugin<UndoRedoConfig> {\n  /**\n   * Plugin dependencies - UndoRedoPlugin requires EditingPlugin to track edits.\n   *\n   * The EditingPlugin must be loaded BEFORE this plugin in the plugins array.\n   * @internal\n   */\n  static override readonly dependencies: PluginDependency[] = [\n    { name: 'editing', required: true, reason: 'UndoRedoPlugin tracks cell edit history' },\n  ];\n\n  /** @internal */\n  readonly name = 'undoRedo';\n\n  /** @internal */\n  protected override get defaultConfig(): Partial<UndoRedoConfig> {\n    return {\n      maxHistorySize: 100,\n    };\n  }\n\n  // State as class properties\n  private undoStack: EditAction[] = [];\n  private redoStack: EditAction[] = [];\n\n  /**\n   * Subscribe to cell-edit-committed events from EditingPlugin.\n   * @internal\n   */\n  override attach(grid: GridElement): void {\n    super.attach(grid);\n    // Auto-record edits via Event Bus\n    this.on(\n      'cell-edit-committed',\n      (detail: { rowIndex: number; field: string; oldValue: unknown; newValue: unknown }) => {\n        this.recordEdit(detail.rowIndex, detail.field, detail.oldValue, detail.newValue);\n      },\n    );\n  }\n\n  /**\n   * Clean up state when plugin is detached.\n   * @internal\n   */\n  override detach(): void {\n    this.undoStack = [];\n    this.redoStack = [];\n  }\n\n  /**\n   * Handle keyboard shortcuts for undo/redo.\n   * - Ctrl+Z / Cmd+Z: Undo\n   * - Ctrl+Y / Cmd+Y / Ctrl+Shift+Z / Cmd+Shift+Z: Redo\n   * @internal\n   */\n  override onKeyDown(event: KeyboardEvent): boolean {\n    const isUndo = (event.ctrlKey || event.metaKey) && event.key === 'z' && !event.shiftKey;\n    const isRedo = (event.ctrlKey || event.metaKey) && (event.key === 'y' || (event.key === 'z' && event.shiftKey));\n\n    if (isUndo) {\n      const result = undo({ undoStack: this.undoStack, redoStack: this.redoStack });\n      if (result.action) {\n        // Apply undo - restore old value\n        const rows = this.rows as Record<string, unknown>[];\n        if (rows[result.action.rowIndex]) {\n          rows[result.action.rowIndex][result.action.field] = result.action.oldValue;\n        }\n\n        // Update state from result\n        this.undoStack = result.newState.undoStack;\n        this.redoStack = result.newState.redoStack;\n\n        this.emit<UndoRedoDetail>('undo', {\n          action: result.action,\n          type: 'undo',\n        });\n\n        this.requestRender();\n      }\n      return true;\n    }\n\n    if (isRedo) {\n      const result = redo({ undoStack: this.undoStack, redoStack: this.redoStack });\n      if (result.action) {\n        // Apply redo - restore new value\n        const rows = this.rows as Record<string, unknown>[];\n        if (rows[result.action.rowIndex]) {\n          rows[result.action.rowIndex][result.action.field] = result.action.newValue;\n        }\n\n        // Update state from result\n        this.undoStack = result.newState.undoStack;\n        this.redoStack = result.newState.redoStack;\n\n        this.emit<UndoRedoDetail>('redo', {\n          action: result.action,\n          type: 'redo',\n        });\n\n        this.requestRender();\n      }\n      return true;\n    }\n\n    return false;\n  }\n\n  // #region Public API Methods\n\n  /**\n   * Record a cell edit for undo/redo tracking.\n   * Call this when a cell value changes.\n   *\n   * @param rowIndex - The row index where the edit occurred\n   * @param field - The field (column key) that was edited\n   * @param oldValue - The value before the edit\n   * @param newValue - The value after the edit\n   */\n  recordEdit(rowIndex: number, field: string, oldValue: unknown, newValue: unknown): void {\n    const action = createEditAction(rowIndex, field, oldValue, newValue);\n    const newState = pushAction(\n      { undoStack: this.undoStack, redoStack: this.redoStack },\n      action,\n      this.config.maxHistorySize ?? 100,\n    );\n    this.undoStack = newState.undoStack;\n    this.redoStack = newState.redoStack;\n  }\n\n  /**\n   * Programmatically undo the last action.\n   *\n   * @returns The undone action, or null if nothing to undo\n   */\n  undo(): EditAction | null {\n    const result = undo({ undoStack: this.undoStack, redoStack: this.redoStack });\n    if (result.action) {\n      const rows = this.rows as Record<string, unknown>[];\n      if (rows[result.action.rowIndex]) {\n        rows[result.action.rowIndex][result.action.field] = result.action.oldValue;\n      }\n      this.undoStack = result.newState.undoStack;\n      this.redoStack = result.newState.redoStack;\n      this.requestRender();\n    }\n    return result.action;\n  }\n\n  /**\n   * Programmatically redo the last undone action.\n   *\n   * @returns The redone action, or null if nothing to redo\n   */\n  redo(): EditAction | null {\n    const result = redo({ undoStack: this.undoStack, redoStack: this.redoStack });\n    if (result.action) {\n      const rows = this.rows as Record<string, unknown>[];\n      if (rows[result.action.rowIndex]) {\n        rows[result.action.rowIndex][result.action.field] = result.action.newValue;\n      }\n      this.undoStack = result.newState.undoStack;\n      this.redoStack = result.newState.redoStack;\n      this.requestRender();\n    }\n    return result.action;\n  }\n\n  /**\n   * Check if there are any actions that can be undone.\n   */\n  canUndo(): boolean {\n    return canUndo({ undoStack: this.undoStack, redoStack: this.redoStack });\n  }\n\n  /**\n   * Check if there are any actions that can be redone.\n   */\n  canRedo(): boolean {\n    return canRedo({ undoStack: this.undoStack, redoStack: this.redoStack });\n  }\n\n  /**\n   * Clear all undo/redo history.\n   */\n  clearHistory(): void {\n    const newState = clearHistory();\n    this.undoStack = newState.undoStack;\n    this.redoStack = newState.redoStack;\n  }\n\n  /**\n   * Get a copy of the current undo stack.\n   */\n  getUndoStack(): EditAction[] {\n    return [...this.undoStack];\n  }\n\n  /**\n   * Get a copy of the current redo stack.\n   */\n  getRedoStack(): EditAction[] {\n    return [...this.redoStack];\n  }\n  // #endregion\n}\n"],"names":["pushAction","state","action","maxSize","undoStack","undo","redo","redoStack","canUndo","canRedo","clearHistory","createEditAction","rowIndex","field","oldValue","newValue","UndoRedoPlugin","BaseGridPlugin","grid","detail","event","isUndo","isRedo","result","rows","newState"],"mappings":"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"}