@toolbox-web/grid 3.8.3 → 3.9.0

package/lib/plugins/row-drag-drop/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../../../libs/grid/src/lib/core/constants.ts","../../../../../../libs/grid/src/lib/core/internal/drag-drop-registry.ts","../../../../../../libs/grid/src/lib/core/internal/utils.ts","../../../../../../libs/grid/src/lib/core/internal/virtualization.ts","../../../../../../libs/grid/src/lib/core/internal/keyboard.ts","../../../../../../libs/grid/src/lib/core/defaults.ts","../../../../../../libs/grid/src/lib/core/internal/diagnostics.ts","../../../../../../libs/grid/src/lib/core/internal/sanitize.ts","../../../../../../libs/grid/src/lib/core/plugin/base-plugin.ts","../../../../../../libs/grid/src/lib/plugins/shared/drag-alternative-menu.ts","../../../../../../libs/grid/src/lib/plugins/shared/drag-drop-protocol.ts","../../../../../../libs/grid/src/lib/plugins/row-drag-drop/row-drag-drop.css?inline","../../../../../../libs/grid/src/lib/plugins/row-drag-drop/row-drag-drop-plugin.ts"],"sourcesContent":["/**\n * Grid DOM Constants\n *\n * Centralized constants for CSS classes, data attributes, and selectors\n * used throughout the grid. Use these instead of magic strings.\n *\n * Note: Some constants here are used by plugins but defined in core because:\n * 1. The core CSS needs to style these elements (e.g., sticky positioning)\n * 2. Multiple plugins may share the same class names\n *\n * Plugins can define their own additional constants and export them.\n * See each plugin's index.ts for plugin-specific exports.\n */\n\n/**\n * CSS selector for focusable editor elements within a cell.\n * Used by EditingPlugin, UndoRedoPlugin, and keyboard navigation. Defined here\n * (a leaf module) rather than in `rows.ts` so `keyboard.ts` can consume it\n * without creating a rows ↔ keyboard import cycle.\n */\nexport const FOCUSABLE_EDITOR_SELECTOR =\n  'input,select,textarea,[contenteditable=\"true\"],[contenteditable=\"\"],[tabindex]:not([tabindex=\"-1\"])';\n\n// #region CSS Classes\n\n/**\n * CSS class names used in the grid's DOM.\n * Use these when adding/removing classes or querying elements.\n *\n * Classes are organized by:\n * - Core: Used by the grid core for structure and basic functionality\n * - Shared: Used by multiple features/plugins, styled by core CSS\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport const GridClasses = {\n  // ─── Core Structure ───────────────────────────────────────────────\n  ROOT: 'tbw-grid-root',\n  HEADER: 'header',\n  HEADER_ROW: 'header-row',\n  HEADER_CELL: 'header-cell',\n\n  // Body structure\n  ROWS_VIEWPORT: 'rows-viewport',\n  ROWS_SPACER: 'rows-spacer',\n  ROWS_CONTAINER: 'rows',\n\n  // Row elements\n  DATA_ROW: 'data-grid-row',\n  GROUP_ROW: 'group-row',\n\n  // Cell elements\n  DATA_CELL: 'cell',\n\n  // ─── Core States ──────────────────────────────────────────────────\n  SELECTED: 'selected',\n  FOCUSED: 'focused',\n  EDITING: 'editing',\n  EXPANDED: 'expanded',\n  COLLAPSED: 'collapsed',\n  DRAGGING: 'dragging',\n  RESIZING: 'resizing',\n\n  // Sorting (core feature)\n  SORTABLE: 'sortable',\n  SORTED_ASC: 'sorted-asc',\n  SORTED_DESC: 'sorted-desc',\n\n  // Visibility\n  HIDDEN: 'hidden',\n\n  // ─── Shared Classes (used by plugins, styled by core CSS) ────────\n  // These are defined here because core CSS provides the base styling.\n  // Plugins apply these classes; core CSS defines how they look.\n\n  // Sticky positioning (PinnedColumnsPlugin applies, core CSS styles)\n  STICKY_LEFT: 'sticky-left',\n  STICKY_RIGHT: 'sticky-right',\n\n  // Pinned rows (PinnedRowsPlugin applies, core CSS styles)\n  PINNED_TOP: 'pinned-top',\n  PINNED_BOTTOM: 'pinned-bottom',\n\n  // Tree structure (TreePlugin applies, core CSS styles)\n  TREE_TOGGLE: 'tree-toggle',\n  TREE_INDENT: 'tree-indent',\n\n  // Grouping (GroupingRowsPlugin applies, core CSS styles)\n  GROUP_TOGGLE: 'group-toggle',\n  GROUP_LABEL: 'group-label',\n  GROUP_COUNT: 'group-count',\n\n  // Selection (SelectionPlugin applies, core CSS styles)\n  RANGE_SELECTION: 'range-selection',\n  SELECTION_OVERLAY: 'selection-overlay',\n} as const;\n\n// #endregion\n\n// #region Data Attributes\n\n/**\n * Data attribute names used on grid elements.\n * Use these when getting/setting data attributes.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport const GridDataAttrs = {\n  // ─── Core Attributes ──────────────────────────────────────────────\n  FIELD: 'data-field',\n\n  /**\n   * Marks a `title` the grid itself put on a cell to reveal ellipsised text\n   * (WCAG SC 1.4.12). Anything that sets its own `title` on a cell must clear\n   * this, or the grid will later mistake that title for its own and replace it.\n   *\n   * @since 3.6.0\n   */\n  TRUNCATED: 'data-tbw-truncated',\n\n  // ─── Shared Attributes (used by plugins) ──────────────────────────\n  GROUP_KEY: 'data-group-key', // GroupingRowsPlugin\n} as const;\n\n// #endregion\n\n// #region Selectors\n\n/**\n * Common CSS selectors for querying grid elements.\n * Built from the class constants for consistency.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport const GridSelectors = {\n  ROOT: `.${GridClasses.ROOT}`,\n  HEADER: `.${GridClasses.HEADER}`,\n  HEADER_ROW: `.${GridClasses.HEADER_ROW}`,\n  HEADER_CELL: `.${GridClasses.HEADER_CELL}`,\n  ROWS_VIEWPORT: `.${GridClasses.ROWS_VIEWPORT}`,\n  ROWS_CONTAINER: `.${GridClasses.ROWS_CONTAINER}`,\n  DATA_ROW: `.${GridClasses.DATA_ROW}`,\n  DATA_CELL: `.${GridClasses.DATA_CELL}`,\n  GROUP_ROW: `.${GridClasses.GROUP_ROW}`,\n\n  // By data attribute\n  CELL_BY_FIELD: (field: string) => `.${GridClasses.DATA_CELL}[${GridDataAttrs.FIELD}=\"${field}\"]`,\n\n  // State selectors\n  SELECTED_ROWS: `.${GridClasses.DATA_ROW}.${GridClasses.SELECTED}`,\n  EDITING_CELL: `.${GridClasses.DATA_CELL}.${GridClasses.EDITING}`,\n} as const;\n\n// #endregion\n\n// #region CSS Custom Properties\n\n/**\n * CSS custom property names for theming.\n * Use these when programmatically setting styles.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport const GridCSSVars = {\n  // Colors\n  COLOR_BG: '--tbw-color-bg',\n  COLOR_FG: '--tbw-color-fg',\n  COLOR_FG_MUTED: '--tbw-color-fg-muted',\n  COLOR_BORDER: '--tbw-color-border',\n  COLOR_ACCENT: '--tbw-color-accent',\n  COLOR_HEADER_BG: '--tbw-color-header-bg',\n  COLOR_HEADER_FG: '--tbw-color-header-fg',\n  COLOR_SELECTION: '--tbw-color-selection',\n  COLOR_ROW_HOVER: '--tbw-color-row-hover',\n  COLOR_ROW_ALT: '--tbw-color-row-alt',\n\n  // Sizing\n  ROW_HEIGHT: '--tbw-row-height',\n  HEADER_HEIGHT: '--tbw-header-height',\n  CELL_PADDING: '--tbw-cell-padding',\n\n  // Typography\n  FONT_FAMILY: '--tbw-font-family',\n  FONT_SIZE: '--tbw-font-size',\n\n  // Borders\n  BORDER_RADIUS: '--tbw-border-radius',\n  FOCUS_OUTLINE: '--tbw-focus-outline',\n} as const;\n\n// #endregion\n\n// Type helpers\n\n/**\n * Union of all CSS class names used in the grid's DOM.\n * Use `GridClasses` to access individual values by key.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport type GridClassName = (typeof GridClasses)[keyof typeof GridClasses];\n\n/**\n * Union of all `data-*` attribute names used on grid elements.\n * Use `GridDataAttrs` to access individual values by key.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport type GridDataAttr = (typeof GridDataAttrs)[keyof typeof GridDataAttrs];\n\n/**\n * Union of all CSS custom property names (`--tbw-*`) available for theming.\n * Use `GridCSSVars` to access individual values by key.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport type GridCSSVar = (typeof GridCSSVars)[keyof typeof GridCSSVars];\n","/**\n * Drag-Drop Registry\n *\n * Module-level singleton that holds live (WeakRef) references to row objects\n * being dragged across grids in the same JS heap. Used by `RowDragDropPlugin`\n * to recover live references on drop, avoiding any serialization cost when\n * source and target grids share a heap.\n *\n * Lives in `core/internal/` (not in the plugin bundle) so that two copies of\n * `@toolbox-web/grid` loaded via different entry points (e.g. `/all` vs\n * per-plugin imports) cannot end up with two separate registries that silently\n * fall back to JSON.\n *\n * Cross-window / cross-origin-iframe drags do NOT go through this registry —\n * they fall back to `dataTransfer` JSON.\n *\n * @internal\n */\n\ninterface RegistryEntry {\n  readonly refs: ReadonlyArray<WeakRef<object>>;\n  /** True when one or more registered rows were primitives (not objects). */\n  readonly hasPrimitives: boolean;\n}\n\nconst registry = new Map<string, RegistryEntry>();\n\n/**\n * Register a drag session's live row references.\n *\n * Object rows are stored as `WeakRef<object>`; primitive rows cannot be held\n * weakly and would either need a sentinel (which corrupts the row value on\n * recovery) or be omitted (which misaligns indices). We instead flag the\n * session as containing primitives — `lookupDragSession()` then returns\n * `undefined` so callers fall back to the JSON payload, which round-trips\n * primitives losslessly.\n *\n * @param sessionId - Unique drag session identifier (typically a UUID).\n * @param rows      - Rows being dragged.\n */\nexport function registerDragSession(sessionId: string, rows: readonly unknown[]): void {\n  const refs: WeakRef<object>[] = [];\n  let hasPrimitives = false;\n  for (const row of rows) {\n    if (row !== null && typeof row === 'object') {\n      refs.push(new WeakRef(row as object));\n    } else {\n      hasPrimitives = true;\n    }\n  }\n  registry.set(sessionId, { refs, hasPrimitives });\n}\n\n/**\n * Look up the live row references for a drag session.\n *\n * Returns `undefined` when the caller MUST fall back to the JSON payload:\n *   - the session is unknown,\n *   - any registered reference has been garbage-collected (partial recovery\n *     would silently corrupt cross-grid moves), or\n *   - the session contains primitive rows (which cannot be held weakly).\n */\nexport function lookupDragSession<T = unknown>(sessionId: string): T[] | undefined {\n  const entry = registry.get(sessionId);\n  if (!entry) return undefined;\n  if (entry.hasPrimitives) return undefined; // primitives — caller falls back to JSON\n  const result: unknown[] = [];\n  for (const ref of entry.refs) {\n    const obj = ref.deref();\n    if (obj === undefined) return undefined; // GC'd — caller falls back to JSON\n    result.push(obj);\n  }\n  return result as T[];\n}\n\n/**\n * Clear a drag session from the registry.\n * Should be called from `dragend` on the source grid.\n */\nexport function clearDragSession(sessionId: string): void {\n  registry.delete(sessionId);\n}\n\n/**\n * @internal Test-only — clear all sessions.\n */\nexport function _clearAllDragSessions(): void {\n  registry.clear();\n}\n\n/**\n * Generate a unique drag session identifier.\n *\n * Used as a Map key to recover live row references for in-process drags; this\n * is **not** a security context. Uses `crypto.randomUUID()` when available\n * (modern browsers in secure contexts, Node 19+, Bun) and falls back to\n * `crypto.getRandomValues()` for older non-secure contexts. `Math.random()`\n * is intentionally avoided to keep CodeQL clean.\n */\nexport function newDragSessionId(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return crypto.randomUUID();\n  }\n  if (typeof crypto !== 'undefined' && typeof crypto.getRandomValues === 'function') {\n    const buf = new Uint32Array(2);\n    crypto.getRandomValues(buf);\n    return `drag-${Date.now().toString(36)}-${buf[0].toString(36)}${buf[1].toString(36)}`;\n  }\n  // Final fallback: timestamp + monotonically incrementing counter (no PRNG).\n  // Sufficient because the registry is in-process and lives only for the\n  // duration of a single drag.\n  return `drag-${Date.now().toString(36)}-${(++fallbackCounter).toString(36)}`;\n}\n\nlet fallbackCounter = 0;\n","// #region Environment Helpers\n\n/**\n * Check if we're running in a development environment.\n * Returns true for localhost or when NODE_ENV !== 'production'.\n * Used to show warnings only in development.\n */\nexport function isDevelopment(): boolean {\n  // Check for localhost (browser environment)\n  if (typeof window !== 'undefined' && window.location) {\n    const hostname = window.location.hostname;\n    if (hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '::1') {\n      return true;\n    }\n  }\n  // Check for NODE_ENV (build-time or SSR)\n  if (typeof process !== 'undefined' && process.env?.NODE_ENV !== 'production') {\n    return true;\n  }\n  return false;\n}\n\n// #endregion\n\n// #region Cell Rendering Helpers\n\n/**\n * Generate accessible HTML for a boolean cell.\n * Uses role=\"checkbox\" with proper aria attributes.\n */\nexport function booleanCellHTML(value: boolean): string {\n  return `<span role=\"checkbox\" aria-checked=\"${value}\" aria-label=\"${value}\">${value ? '&#x1F5F9;' : '&#9744;'}</span>`;\n}\n\n/**\n * Format a date value for display.\n * Handles Date objects, timestamps, and date strings.\n * Returns empty string for invalid dates.\n */\nexport function formatDateValue(value: unknown): string {\n  if (value == null || value === '') return '';\n  if (value instanceof Date) {\n    return isNaN(value.getTime()) ? '' : value.toLocaleDateString();\n  }\n  if (typeof value === 'number' || typeof value === 'string') {\n    const d = new Date(value);\n    return isNaN(d.getTime()) ? '' : d.toLocaleDateString();\n  }\n  return '';\n}\n\n/**\n * Get the row index from a cell element's data-row attribute.\n * Falls back to calculating from parent row's DOM position if data-row is missing.\n * Returns -1 if no valid row index is found.\n */\nexport function getRowIndexFromCell(cell: Element | null): number {\n  if (!cell) return -1;\n  const attr = cell.getAttribute('data-row');\n  if (attr) return parseInt(attr, 10);\n\n  // Fallback: find the parent .data-grid-row and calculate index from siblings\n  const rowEl = cell.closest('.data-grid-row');\n  if (!rowEl) return -1;\n\n  const parent = rowEl.parentElement;\n  if (!parent) return -1;\n\n  // Get all data-grid-row siblings and find this row's index\n  const rows = parent.querySelectorAll(':scope > .data-grid-row');\n  for (let i = 0; i < rows.length; i++) {\n    if (rows[i] === rowEl) return i;\n  }\n  return -1;\n}\n\n/**\n * Get the column index from a cell element's data-col attribute.\n * Returns -1 if no valid column index is found.\n */\nexport function getColIndexFromCell(cell: Element | null): number {\n  if (!cell) return -1;\n  const attr = cell.getAttribute('data-col');\n  return attr ? parseInt(attr, 10) : -1;\n}\n\n/**\n * Clear all cell-focus styling from a root element.\n * Used when changing focus or when selection plugin takes over focus management.\n */\nexport function clearCellFocus(root: Element | null): void {\n  if (!root) return;\n  root.querySelectorAll('.cell-focus').forEach((el) => el.classList.remove('cell-focus'));\n}\n// #endregion\n\n// #region RTL Helpers\n\n/** Text direction */\nexport type TextDirection = 'ltr' | 'rtl';\n\n/**\n * Get the text direction for an element.\n * Reads from the computed style, which respects the `dir` attribute on the element\n * or any ancestor, as well as CSS `direction` property.\n *\n * @param element - The element to check direction for\n * @returns 'ltr' or 'rtl'\n *\n * @example\n * ```typescript\n * // Detect grid's direction\n * const dir = getDirection(gridElement);\n * if (dir === 'rtl') {\n *   // Handle RTL layout\n * }\n * ```\n */\nexport function getDirection(element: Element): TextDirection {\n  // Try computed style first (works in real browsers)\n  try {\n    const computedDir = getComputedStyle(element).direction;\n    if (computedDir === 'rtl') return 'rtl';\n  } catch {\n    // getComputedStyle may fail in some test environments\n  }\n\n  // Fallback: check dir attribute on element or ancestors\n  // This handles test environments where getComputedStyle may not reflect dir attribute\n  try {\n    const dirAttr = element.closest?.('[dir]')?.getAttribute('dir');\n    if (dirAttr === 'rtl') return 'rtl';\n  } catch {\n    // closest may not be available on mock elements\n  }\n\n  return 'ltr';\n}\n\n/**\n * Check if an element is in RTL mode.\n *\n * @param element - The element to check\n * @returns true if the element's text direction is right-to-left\n */\nexport function isRTL(element: Element): boolean {\n  return getDirection(element) === 'rtl';\n}\n\n/**\n * Resolve a logical inline position to a physical position based on text direction.\n *\n * - `'start'` → `'left'` in LTR, `'right'` in RTL\n * - `'end'` → `'right'` in LTR, `'left'` in RTL\n * - `'left'` / `'right'` → unchanged (physical values)\n *\n * @param position - Logical or physical position\n * @param direction - Text direction ('ltr' or 'rtl')\n * @returns Physical position ('left' or 'right')\n *\n * @example\n * ```typescript\n * resolveInlinePosition('start', 'ltr'); // 'left'\n * resolveInlinePosition('start', 'rtl'); // 'right'\n * resolveInlinePosition('left', 'rtl');  // 'left' (unchanged)\n * ```\n */\nexport function resolveInlinePosition(\n  position: 'left' | 'right' | 'start' | 'end',\n  direction: TextDirection,\n): 'left' | 'right' {\n  if (position === 'left' || position === 'right') {\n    return position;\n  }\n  if (direction === 'rtl') {\n    return position === 'start' ? 'right' : 'left';\n  }\n  return position === 'start' ? 'left' : 'right';\n}\n// #endregion\n","/**\n * Row Virtualization Module\n *\n * Provides all virtualization-related functionality for the grid:\n *\n * 1. **Position Cache** (index-based): Maps row index → {offset, height, measured}\n *    - Rebuilt when row count changes (expand/collapse, filter)\n *    - Used for scroll position → row index lookups (binary search)\n *\n * 2. **Height Cache** (identity-based): Maps row identity → height\n *    - Persists across expand/collapse\n *    - Uses rowId string keys when available, WeakMap otherwise\n *    - Synthetic rows use __rowCacheKey for stable identity\n *\n * 3. **Virtual Window**: Computes which rows to render based on scroll position\n *\n * 4. **Row Measurement**: Measures rendered row heights from DOM\n */\n\n// #region Types\n\n/**\n * Position entry for a single row in the position cache.\n * @category Plugin Development\n */\nexport interface RowPosition {\n  /** Cumulative offset from top in pixels */\n  offset: number;\n  /** Row height in pixels */\n  height: number;\n  /** Whether this is a measured value (true) or estimate (false) */\n  measured: boolean;\n}\n\n/**\n * Height cache that persists row heights across position cache rebuilds.\n * Uses dual storage: Map for string keys (rowId, __rowCacheKey) and WeakMap for object refs.\n * @category Plugin Development\n */\nexport interface HeightCache {\n  /** Heights keyed by string (for synthetic rows with __rowCacheKey or rowId-keyed rows) */\n  byKey: Map<string, number>;\n  /** Heights keyed by object reference (for data rows without rowId) */\n  byRef: WeakMap<object, number>;\n}\n\n/**\n * Configuration for the position cache.\n */\nexport interface PositionCacheConfig<T = unknown> {\n  /** Function to get row ID (if configured) */\n  rowId?: (row: T) => string | number;\n}\n\n// #endregion\n\n// #region Height Cache Operations\n\n/**\n * Create a new empty height cache.\n */\nexport function createHeightCache(): HeightCache {\n  return {\n    byKey: new Map(),\n    byRef: new WeakMap(),\n  };\n}\n\n/**\n * Get the cache key for a row.\n * Returns string for synthetic rows (__rowCacheKey) or rowId-keyed rows,\n * or the row object itself for WeakMap lookup.\n */\nexport function getRowCacheKey<T>(row: T, rowId?: (row: T) => string | number): string | T {\n  if (!row || typeof row !== 'object') return row;\n\n  // 1. Synthetic rows: plugins MUST add __rowCacheKey\n  if ('__rowCacheKey' in row) {\n    return (row as { __rowCacheKey: string }).__rowCacheKey;\n  }\n\n  // 2. rowId property directly on the row (common pattern)\n  if ('rowId' in row && (row as { rowId: string | number }).rowId != null) {\n    return `id:${(row as { rowId: string | number }).rowId}`;\n  }\n\n  // 3. User-provided rowId function (if configured)\n  if (rowId) {\n    return `id:${rowId(row)}`;\n  }\n\n  // 4. Object identity (for WeakMap)\n  return row;\n}\n\n/**\n * Get cached height for a row.\n * @returns Cached height or undefined if not cached\n */\nexport function getCachedHeight<T>(\n  cache: HeightCache,\n  row: T,\n  rowId?: (row: T) => string | number,\n): number | undefined {\n  const key = getRowCacheKey(row, rowId);\n\n  if (typeof key === 'string') {\n    return cache.byKey.get(key);\n  }\n\n  // Object key - use WeakMap\n  if (key && typeof key === 'object') {\n    return cache.byRef.get(key);\n  }\n\n  return undefined;\n}\n\n/**\n * Set cached height for a row.\n */\nexport function setCachedHeight<T>(\n  cache: HeightCache,\n  row: T,\n  height: number,\n  rowId?: (row: T) => string | number,\n): void {\n  const key = getRowCacheKey(row, rowId);\n\n  if (typeof key === 'string') {\n    cache.byKey.set(key, height);\n  } else if (key && typeof key === 'object') {\n    cache.byRef.set(key, height);\n  }\n}\n\n// #endregion\n\n// #region Position Cache Operations\n\n/**\n * Rebuild position cache preserving known heights from height cache.\n * Called when row count changes (expand/collapse, filter, data change).\n *\n * @param rows - Array of row data\n * @param heightCache - Height cache with persisted measurements\n * @param estimatedHeight - Estimated height for unmeasured rows\n * @param config - Position cache configuration\n * @param getPluginHeight - Optional function to get height from plugins\n * @returns New position cache\n */\nexport function rebuildPositionCache<T>(\n  rows: T[],\n  heightCache: HeightCache,\n  estimatedHeight: number,\n  config: PositionCacheConfig<T>,\n  getPluginHeight?: (row: T, index: number) => number | undefined,\n): RowPosition[] {\n  const cache: RowPosition[] = new Array(rows.length);\n  let offset = 0;\n\n  for (let i = 0; i < rows.length; i++) {\n    const row = rows[i];\n\n    // Height resolution order:\n    // 1. Plugin's getRowHeight() (for synthetic rows with known heights)\n    let height = getPluginHeight?.(row, i);\n    let measured = height !== undefined;\n\n    // 2. Cached height from previous measurements\n    if (height === undefined) {\n      height = getCachedHeight(heightCache, row, config.rowId);\n      measured = height !== undefined;\n    }\n\n    // 3. Fall back to estimate\n    if (height === undefined) {\n      height = estimatedHeight;\n      measured = false;\n    }\n\n    cache[i] = { offset, height, measured };\n    offset += height;\n  }\n\n  return cache;\n}\n\n/**\n * Update a single row's height in the position cache.\n * Recalculates offsets for all subsequent rows.\n *\n * @param cache - Position cache to update\n * @param index - Row index to update\n * @param newHeight - New measured height\n */\nexport function updateRowHeight(cache: RowPosition[], index: number, newHeight: number): void {\n  if (index < 0 || index >= cache.length) return;\n\n  const entry = cache[index];\n  const heightDiff = newHeight - entry.height;\n\n  // Latch `measured` even when the height is unchanged, otherwise callers that enqueue on\n  // `!measured` re-measure the same row on every render pass.\n  entry.measured = true;\n\n  if (heightDiff === 0) return;\n\n  // Update this row\n  entry.height = newHeight;\n\n  // Recalculate offsets for all subsequent rows\n  for (let i = index + 1; i < cache.length; i++) {\n    cache[i].offset += heightDiff;\n  }\n}\n\nexport interface RowHeightChange {\n  /** Row index into the position cache. */\n  index: number;\n  /** Measured height in pixels. */\n  height: number;\n}\n\n/**\n * Update multiple row heights while recalculating the affected cache suffix once.\n *\n * @param cache - Position cache to update (mutated in place)\n * @param changes - Height changes in any order; each row index should occur at most once\n */\nexport function updateRowHeights(cache: RowPosition[], changes: RowHeightChange[]): void {\n  if (changes.length === 0 || cache.length === 0) return;\n\n  // Callers usually collect in DOM order, which is already ascending — skip the copy then.\n  let sortedChanges = changes;\n  for (let i = 1; i < changes.length; i++) {\n    if (changes[i].index < changes[i - 1].index) {\n      sortedChanges = [...changes].sort((a, b) => a.index - b.index);\n      break;\n    }\n  }\n\n  let changeIndex = 0;\n  while (changeIndex < sortedChanges.length && sortedChanges[changeIndex].index < 0) changeIndex++;\n  if (changeIndex >= sortedChanges.length || sortedChanges[changeIndex].index >= cache.length) return;\n\n  let cumulativeDiff = 0;\n  const firstChangedIndex = sortedChanges[changeIndex].index;\n  for (let index = firstChangedIndex; index < cache.length; index++) {\n    const entry = cache[index];\n    entry.offset += cumulativeDiff;\n\n    while (changeIndex < sortedChanges.length && sortedChanges[changeIndex].index === index) {\n      const height = sortedChanges[changeIndex].height;\n      const heightDiff = height - entry.height;\n      entry.measured = true;\n      if (heightDiff !== 0) {\n        entry.height = height;\n        cumulativeDiff += heightDiff;\n      }\n      changeIndex++;\n    }\n  }\n}\n\n/**\n * Get total content height from position cache.\n *\n * @param cache - Position cache\n * @returns Total height in pixels\n */\nexport function getTotalHeight(cache: RowPosition[]): number {\n  if (cache.length === 0) return 0;\n  const last = cache[cache.length - 1];\n  return last.offset + last.height;\n}\n\n// #endregion\n\n// #region Binary Search\n\n/**\n * Find the row index at a given scroll offset using binary search.\n * Returns the index of the row that contains the given pixel offset.\n *\n * @param cache - Position cache\n * @param targetOffset - Scroll offset in pixels\n * @returns Row index at that offset, or -1 if cache is empty\n */\nexport function getRowIndexAtOffset(cache: RowPosition[], targetOffset: number): number {\n  if (cache.length === 0) return -1;\n  if (targetOffset <= 0) return 0;\n\n  let low = 0;\n  let high = cache.length - 1;\n\n  while (low <= high) {\n    const mid = Math.floor((low + high) / 2);\n    const entry = cache[mid];\n    const entryEnd = entry.offset + entry.height;\n\n    if (targetOffset < entry.offset) {\n      high = mid - 1;\n    } else if (targetOffset >= entryEnd) {\n      low = mid + 1;\n    } else {\n      // targetOffset is within this row\n      return mid;\n    }\n  }\n\n  // Return the closest row (low will be just past the target)\n  return Math.max(0, Math.min(low, cache.length - 1));\n}\n\n// #endregion\n\n// #region Statistics\n\n/**\n * Calculate the average measured height.\n * Used for estimating unmeasured rows.\n *\n * @param cache - Position cache\n * @param defaultHeight - Default height to use if no measurements\n * @returns Average measured height\n */\nexport function calculateAverageHeight(cache: RowPosition[], defaultHeight: number): number {\n  let totalHeight = 0;\n  let measuredCount = 0;\n\n  for (const entry of cache) {\n    if (entry.measured) {\n      totalHeight += entry.height;\n      measuredCount++;\n    }\n  }\n\n  return measuredCount > 0 ? totalHeight / measuredCount : defaultHeight;\n}\n\n/**\n * Count how many rows have been measured.\n *\n * @param cache - Position cache\n * @returns Number of measured rows\n */\nexport function countMeasuredRows(cache: RowPosition[]): number {\n  let count = 0;\n  for (const entry of cache) {\n    if (entry.measured) count++;\n  }\n  return count;\n}\n\n// #endregion\n// #region Row Measurement\n\n/**\n * Result of measuring rendered row heights.\n */\nexport interface RowMeasurementResult {\n  /** Whether any heights changed */\n  hasChanges: boolean;\n  /** Updated measured row count */\n  measuredCount: number;\n  /** Updated average height */\n  averageHeight: number;\n}\n\n/**\n * Context for measuring rendered rows.\n */\nexport interface RowMeasurementContext<T> {\n  /** Position cache to update */\n  positionCache: RowPosition[];\n  /** Height cache for persistence */\n  heightCache: HeightCache;\n  /** Row data array */\n  rows: T[];\n  /** Default row height */\n  defaultHeight: number;\n  /** Start index of rendered window */\n  start: number;\n  /** End index of rendered window (exclusive) */\n  end: number;\n  /** Function to get plugin height for a row */\n  getPluginHeight?: (row: T, index: number) => number | undefined;\n  /** Function to get row ID for height cache keying */\n  getRowId?: (row: T) => string | number;\n}\n\n/**\n * Measure rendered row heights from DOM elements and update caches.\n * Returns measurement statistics for updating virtualization state.\n *\n * @param context - Measurement context with all dependencies\n * @param rowElements - NodeList of rendered row elements\n * @returns Measurement result with flags and statistics\n */\nexport function measureRenderedRowHeights<T>(\n  context: RowMeasurementContext<T>,\n  rowElements: NodeListOf<Element>,\n): RowMeasurementResult {\n  const { positionCache, heightCache, rows, start, end, getPluginHeight, getRowId } = context;\n\n  let hasChanges = false;\n  const heightChanges: RowHeightChange[] = [];\n\n  rowElements.forEach((rowEl) => {\n    const rowIndexStr = (rowEl as HTMLElement).dataset.rowIndex;\n    if (!rowIndexStr) return;\n\n    const rowIndex = parseInt(rowIndexStr, 10);\n    if (rowIndex < start || rowIndex >= end || rowIndex >= rows.length) return;\n\n    const row = rows[rowIndex];\n\n    // Check if a plugin provides the height for this row\n    const pluginHeight = getPluginHeight?.(row, rowIndex);\n\n    if (pluginHeight !== undefined) {\n      // Plugin provides height - use it for position cache\n      const currentEntry = positionCache[rowIndex];\n      if (!currentEntry.measured || Math.abs(currentEntry.height - pluginHeight) > 1) {\n        heightChanges.push({ index: rowIndex, height: pluginHeight });\n        hasChanges = true;\n      }\n      return; // Don't measure DOM for plugin-managed rows\n    }\n\n    // No plugin height - use DOM measurement\n    const measuredHeight = (rowEl as HTMLElement).offsetHeight;\n\n    if (measuredHeight > 0) {\n      const currentEntry = positionCache[rowIndex];\n\n      // Only update if height differs significantly (> 1px to avoid oscillation)\n      if (!currentEntry.measured || Math.abs(currentEntry.height - measuredHeight) > 1) {\n        heightChanges.push({ index: rowIndex, height: measuredHeight });\n        setCachedHeight(heightCache, row, measuredHeight, getRowId);\n        hasChanges = true;\n      }\n    }\n  });\n\n  updateRowHeights(positionCache, heightChanges);\n\n  // Recompute stats\n  const measuredCount = hasChanges ? countMeasuredRows(positionCache) : 0;\n  const averageHeight = hasChanges ? calculateAverageHeight(positionCache, context.defaultHeight) : 0;\n\n  return { hasChanges, measuredCount, averageHeight };\n}\n\n/**\n * Compute measurement statistics for a position cache, excluding plugin-managed rows.\n * Used after rebuilding position cache to get accurate averages for non-plugin rows.\n *\n * @param cache - Position cache\n * @param rows - Row data array\n * @param defaultHeight - Default height if no measurements\n * @param getPluginHeight - Function to check if plugin manages row height\n * @returns Object with measured count and average height\n */\nexport function computeAverageExcludingPluginRows<T>(\n  cache: RowPosition[],\n  rows: T[],\n  defaultHeight: number,\n  getPluginHeight?: (row: T, index: number) => number | undefined,\n): { measuredCount: number; averageHeight: number } {\n  let measuredCount = 0;\n  let totalMeasured = 0;\n\n  for (let i = 0; i < cache.length; i++) {\n    const entry = cache[i];\n    if (entry.measured) {\n      // Only include in average if plugin doesn't provide height for this row\n      const pluginHeight = getPluginHeight?.(rows[i], i);\n      if (pluginHeight === undefined) {\n        totalMeasured += entry.height;\n        measuredCount++;\n      }\n    }\n  }\n\n  return {\n    measuredCount,\n    averageHeight: measuredCount > 0 ? totalMeasured / measuredCount : defaultHeight,\n  };\n}\n\n// #endregion\n\n// #region Scroll Mapping (max element-height cap)\n\n/**\n * Maximum spacer element height (px) before browsers cap the rendered height.\n *\n * Chromium's hard cap is `2^25 = 33,554,432` px; Firefox/Safari are similar or larger.\n * We pick `33,500,000` — ~54 KB of headroom under Chromium's cap so that floating-point\n * drift in the fractional mapping math (`scrollTop * rMax / sMax`) cannot push a computed\n * spacer position past the engine cap and silently truncate.\n *\n * For datasets where `totalRows * rowHeight` exceeds this value, the faux-vscroll\n * spacer would silently truncate, making the tail of the dataset unreachable via\n * the native scrollbar / `Ctrl+End`. The grid switches to fractional scroll mapping\n * above this threshold — see {@link computeScrollMapping}.\n *\n * @category Plugin Development\n * @since 2.13.0\n */\nexport const MAX_ELEMENT_HEIGHT_PX = 33_500_000;\n\n/**\n * Mapping between native `scrollTop` (clamped spacer space) and \"virtual\" scroll\n * position (raw row-content space). See {@link computeScrollMapping}.\n *\n * @category Plugin Development\n * @since 2.13.0\n */\nexport interface ScrollMapping {\n  /** Raw row-content height in pixels (totalRows * rowHeight or sum of variable heights). */\n  rawContentHeight: number;\n  /** Effective spacer DOM height — `min(rawContentHeight, maxSpacerHeight)`. */\n  spacerHeight: number;\n  /** Viewport height used for computing scrollable extents. */\n  viewportHeight: number;\n  /** True when `rawContentHeight > maxSpacerHeight` — fractional mapping is active. */\n  capped: boolean;\n}\n\n/**\n * Compute a mapping between the spacer's native scrollTop and the virtual\n * row-content scroll offset.\n *\n * For datasets within `maxSpacerHeight`, mapping is identity (no transform).\n * Above the cap, the spacer is clamped and `scrollTop` units no longer equal\n * row-content units — call {@link toVirtualScrollTop} / {@link fromVirtualScrollTop}\n * to translate between the two coordinate spaces.\n *\n * @category Plugin Development\n * @since 2.13.0\n */\nexport function computeScrollMapping(\n  rawContentHeight: number,\n  viewportHeight: number,\n  maxSpacerHeight = MAX_ELEMENT_HEIGHT_PX,\n): ScrollMapping {\n  const spacerHeight = Math.min(rawContentHeight, maxSpacerHeight);\n  return {\n    rawContentHeight,\n    spacerHeight,\n    viewportHeight,\n    capped: rawContentHeight > maxSpacerHeight,\n  };\n}\n\n/**\n * Translate a native `scrollTop` (spacer space) into a virtual scroll offset\n * in raw row-content space. Identity when the mapping is not capped.\n *\n * The result is clamped to `[0, rawContentHeight - viewportHeight]` so callers\n * never index past the dataset, even when the spacer's actual scrollable extent\n * slightly exceeds `spacerHeight - viewportHeight` (e.g. when a horizontal scrollbar\n * adds bottom padding to the faux spacer).\n *\n * @category Plugin Development\n * @since 2.13.0\n */\nexport function toVirtualScrollTop(scrollTop: number, mapping: ScrollMapping): number {\n  if (!mapping.capped) return scrollTop;\n  const sMax = mapping.spacerHeight - mapping.viewportHeight;\n  const rMax = mapping.rawContentHeight - mapping.viewportHeight;\n  if (sMax <= 0 || rMax <= 0) return scrollTop;\n  const virtual = (scrollTop * rMax) / sMax;\n  if (virtual < 0) return 0;\n  if (virtual > rMax) return rMax;\n  return virtual;\n}\n\n/**\n * Translate a virtual scroll offset (raw row-content space) into a native\n * `scrollTop` value (spacer space). Identity when the mapping is not capped.\n *\n * @category Plugin Development\n * @since 2.13.0\n */\nexport function fromVirtualScrollTop(virtualTop: number, mapping: ScrollMapping): number {\n  if (!mapping.capped) return virtualTop;\n  const sMax = mapping.spacerHeight - mapping.viewportHeight;\n  const rMax = mapping.rawContentHeight - mapping.viewportHeight;\n  if (sMax <= 0 || rMax <= 0) return virtualTop;\n  return (virtualTop * sMax) / rMax;\n}\n\n/**\n * Identity scroll mapping (no cap applied). Useful as a default in places that\n * don't yet know the dataset extents. `viewportHeight` is `0` until the first\n * `calculateTotalSpacerHeight` call populates the real extents — safe because\n * `capped: false` short-circuits both translation helpers before they read it.\n *\n * @category Plugin Development\n * @since 2.13.0\n */\nexport function createIdentityScrollMapping(): ScrollMapping {\n  return { rawContentHeight: 0, spacerHeight: 0, viewportHeight: 0, capped: false };\n}\n\n// #endregion\n\n// #region Scroll Transform\n\n/**\n * Sub-pixel `translateY` for the `.rows` element at a given native scroll position.\n *\n * Bypass mode (all rows rendered) tracks the raw scroll offset directly. Virtualized mode\n * offsets only the remainder past the window's first row, and rounds that start down to an\n * even index so DOM `nth-child(even)` zebra parity keeps matching data-row parity.\n *\n * @param v Virtual state (structural subset of `VirtualState`).\n * @param rawScrollTop Native `scrollTop` of the faux scrollbar (clamped spacer space).\n */\nexport function computeRowsTranslateY(\n  v: {\n    rowHeight: number;\n    bypassThreshold: number;\n    variableHeights: boolean;\n    positionCache: RowPosition[] | null;\n    scrollMapping: ScrollMapping;\n  },\n  totalRows: number,\n  rawScrollTop: number,\n): number {\n  if (totalRows <= v.bypassThreshold) return -rawScrollTop;\n\n  const currentScrollTop = toVirtualScrollTop(rawScrollTop, v.scrollMapping);\n  const cache = v.positionCache;\n  let startRowOffset: number;\n\n  if (v.variableHeights && cache && cache.length > 0) {\n    let rawStart = getRowIndexAtOffset(cache, currentScrollTop);\n    if (rawStart === -1) rawStart = 0;\n    const evenAlignedStart = rawStart - (rawStart % 2);\n    startRowOffset = cache[evenAlignedStart]?.offset ?? evenAlignedStart * v.rowHeight;\n  } else {\n    const rawStart = Math.floor(currentScrollTop / v.rowHeight);\n    startRowOffset = (rawStart - (rawStart % 2)) * v.rowHeight;\n  }\n\n  return -(currentScrollTop - startRowOffset);\n}\n\n// #endregion\n\n// #region Fixed-Height Virtual Window\n\n/**\n * Result of computing a virtual window for fixed-height rows.\n * Used by plugins like FilteringPlugin for virtualized dropdowns.\n */\nexport interface VirtualWindow {\n  /** First row index to render (inclusive) */\n  start: number;\n  /** Last row index to render (exclusive) */\n  end: number;\n  /** Pixel offset to apply to the rows container (translateY) */\n  offsetY: number;\n  /**\n   * Effective spacer DOM height — use this for the scrollable spacer element.\n   * Equal to `min(totalRows * rowHeight, maxSpacerHeight)`. Above the cap this\n   * is clamped; use {@link VirtualWindow.rawContentHeight} for the un-clamped value.\n   */\n  totalHeight: number;\n  /**\n   * Raw, un-clamped row-content height (`totalRows * rowHeight`). Equal to\n   * `totalHeight` when the dataset is below `maxSpacerHeight`.\n   *\n   * @since 2.13.0\n   */\n  rawContentHeight: number;\n}\n\n/** Parameters for computing the virtual window */\nexport interface VirtualWindowParams {\n  /** Total number of rows */\n  totalRows: number;\n  /** Height of the viewport in pixels */\n  viewportHeight: number;\n  /** Current scroll top position */\n  scrollTop: number;\n  /** Height of each row in pixels */\n  rowHeight: number;\n  /** Number of extra rows to render above/below viewport */\n  overscan: number;\n  /**\n   * Optional cap on the spacer's DOM height. When `totalRows * rowHeight` exceeds\n   * this value, `scrollTop` is treated as a spacer-space position and translated\n   * to virtual row-content space via fractional mapping. Defaults to {@link MAX_ELEMENT_HEIGHT_PX}.\n   * Pass `Infinity` to disable.\n   *\n   * @since 2.13.0\n   */\n  maxSpacerHeight?: number;\n}\n\n/**\n * Compute the virtual row window based on scroll position and viewport.\n * Simple fixed-height implementation for plugins needing basic virtualization.\n *\n * For datasets where `totalRows * rowHeight > maxSpacerHeight`, scroll position\n * is mapped fractionally so the entire dataset stays reachable past the browser's\n * single-element height cap (Chromium ~33.5M px). See {@link computeScrollMapping}.\n *\n * @param params - Parameters for computing the window\n * @returns VirtualWindow with start/end indices and transforms\n */\nexport function computeVirtualWindow(params: VirtualWindowParams): VirtualWindow {\n  const { totalRows, viewportHeight, scrollTop, rowHeight, overscan, maxSpacerHeight = MAX_ELEMENT_HEIGHT_PX } = params;\n\n  const visibleRows = Math.ceil(viewportHeight / rowHeight);\n  const rawContentHeight = totalRows * rowHeight;\n  const mapping = computeScrollMapping(rawContentHeight, viewportHeight, maxSpacerHeight);\n  const virtualScrollTop = toVirtualScrollTop(scrollTop, mapping);\n\n  // Render overscan rows in each direction (total window = visible + 2*overscan)\n  let start = Math.floor(virtualScrollTop / rowHeight) - overscan;\n  if (start < 0) start = 0;\n\n  let end = start + visibleRows + overscan * 2;\n  if (end > totalRows) end = totalRows;\n\n  // Ensure start is adjusted if we hit the end\n  if (end === totalRows && start > 0) {\n    start = Math.max(0, end - visibleRows - overscan * 2);\n  }\n\n  return {\n    start,\n    end,\n    offsetY: start * rowHeight,\n    totalHeight: mapping.spacerHeight,\n    rawContentHeight,\n  };\n}\n\n/**\n * Determine if virtualization should be bypassed for small datasets.\n * When there are very few items, the overhead of virtualization isn't worth it.\n *\n * @param totalRows - Total number of items\n * @param threshold - Bypass threshold (skip virtualization if totalRows <= threshold)\n * @returns True if virtualization should be bypassed\n */\nexport function shouldBypassVirtualization(totalRows: number, threshold: number): boolean {\n  return totalRows <= threshold;\n}\n\n// #endregion\n","/**\n * Central keyboard handler attached to the host element. Manages navigation, paging,\n * and edit lifecycle triggers while respecting active form field interactions.\n */\nimport { FOCUSABLE_EDITOR_SELECTOR, GridClasses } from '../constants';\nimport type { GridHost } from '../types';\nimport { clearCellFocus, isRTL } from './utils';\nimport { readCellField } from './value-accessor';\nimport { fromVirtualScrollTop, getRowIndexAtOffset, toVirtualScrollTop } from './virtualization';\n\n/** Commit active row edit if the editing plugin provides this method. */\nfunction tryCommitEdit(grid: GridHost): void {\n  if (typeof grid.commitActiveRowEdit === 'function') grid.commitActiveRowEdit();\n}\n\nfunction isFormField(el: HTMLElement | null): boolean {\n  if (!el) return false;\n  const tag = el.tagName;\n  if (tag === 'INPUT' || tag === 'SELECT' || tag === 'TEXTAREA') return true;\n  if (el.isContentEditable) return true;\n  return false;\n}\n\n/** True while a row-scoped edit session is active. */\nfunction isRowEditing(grid: GridHost): boolean {\n  return grid._activeEditRows !== undefined && grid._activeEditRows !== -1;\n}\n\n// #region Keyboard Handler\n/**\n * Guard chain deciding whether this keydown belongs to something other than\n * cell navigation and must be left alone.\n */\nfunction shouldIgnoreKeyDown(grid: GridHost, e: KeyboardEvent, target: HTMLElement | null): boolean {\n  // Keyboard events whose target lives inside the grid host but OUTSIDE the\n  // rows body (toolpanel inputs/buttons, shell-header controls, light-DOM\n  // children of <tbw-grid>) own their own keyboard interactions. Treating\n  // ArrowUp/ArrowDown/Enter on such a target as cell navigation steals the\n  // user's actual interaction target on the very next render cycle.\n  // Cells and the grid host itself remain valid navigation targets.\n  if (target && target !== grid && !target.closest?.('.rows-body')) return true;\n\n  if (isFormField(target)) {\n    switch (e.key) {\n      // Home/End and horizontal arrows navigate within the text input; Enter\n      // and Escape are handled by the input's own handlers first.\n      case 'Home':\n      case 'End':\n      case 'ArrowLeft':\n      case 'ArrowRight':\n      case 'Enter':\n      case 'Escape':\n        return true;\n      case 'ArrowUp':\n      case 'ArrowDown':\n        // Number spinners own the vertical arrows; other fields fall through.\n        if ((target as HTMLInputElement).tagName === 'INPUT' && (target as HTMLInputElement).type === 'number') {\n          return true;\n        }\n        break;\n    }\n  }\n\n  const colType = grid._visibleColumns[grid._focusCol]?.type;\n  return isRowEditing(grid) && colType === 'select' && (e.key === 'ArrowDown' || e.key === 'ArrowUp');\n}\n\n/** Tab / Shift+Tab: advance one cell, wrapping to the next/previous row. */\nfunction navigateTab(grid: GridHost, e: KeyboardEvent, maxRow: number, maxCol: number): void {\n  e.preventDefault();\n  if (!e.shiftKey) {\n    if (grid._focusCol < maxCol) {\n      grid._focusCol += 1;\n      return;\n    }\n    tryCommitEdit(grid);\n    if (grid._focusRow < maxRow) {\n      grid._focusRow += 1;\n      grid._focusCol = 0;\n    }\n    return;\n  }\n  if (grid._focusCol > 0) {\n    grid._focusCol -= 1;\n  } else if (grid._focusRow > 0) {\n    if (grid._activeEditRows === grid._focusRow) tryCommitEdit(grid);\n    grid._focusRow -= 1;\n    grid._focusCol = maxCol;\n  }\n}\n\n/**\n * ArrowLeft/ArrowRight. `towardEnd` is the LOGICAL direction (ArrowRight); in\n * RTL the physical arrow maps to the opposite column index.\n */\nfunction navigateHorizontal(grid: GridHost, e: KeyboardEvent, maxCol: number, towardEnd: boolean): void {\n  const forward = isRTL(grid) ? !towardEnd : towardEnd;\n  grid._focusCol = forward ? Math.min(maxCol, grid._focusCol + 1) : Math.max(0, grid._focusCol - 1);\n  e.preventDefault();\n}\n\n/** Commit any active row edit, then focus the first/last row (column unchanged). */\nfunction jumpToRowEdge(grid: GridHost, maxRow: number, toEnd: boolean): void {\n  if (isRowEditing(grid)) tryCommitEdit(grid);\n  grid._focusRow = toEnd ? maxRow : 0;\n}\n\n/** ArrowUp/ArrowDown: one row, or the first/last row with Ctrl/Cmd. */\nfunction navigateVertical(grid: GridHost, e: KeyboardEvent, maxRow: number, down: boolean): void {\n  if (e.ctrlKey || e.metaKey) jumpToRowEdge(grid, maxRow, down);\n  else {\n    if (isRowEditing(grid)) tryCommitEdit(grid);\n    grid._focusRow = down ? Math.min(maxRow, grid._focusRow + 1) : Math.max(0, grid._focusRow - 1);\n  }\n  e.preventDefault();\n}\n\n/**\n * PageUp/PageDown target: one viewport of rows (less any overlay band), so an\n * unconstrained grid pages straight to its edge. 20 rows until layout exists.\n */\nfunction pageTargetRow(grid: GridHost, maxRow: number, down: boolean): number {\n  const from = grid._focusRow;\n  const virt = grid._virtualization;\n  const viewportH = virt?.viewportEl?.clientHeight ?? virt?.container?.clientHeight ?? 0;\n  const offsets = grid._getVerticalScrollOffsets?.(from);\n  const usable = viewportH - Math.max(0, offsets?.top ?? 0) - Math.max(0, offsets?.bottom ?? 0);\n  const pc = virt?.variableHeights ? virt.positionCache : null;\n  let target: number;\n  if (usable > 0 && pc?.[from]) {\n    target = getRowIndexAtOffset(pc, pc[from].offset + (down ? usable : -usable));\n    // A row taller than the viewport would otherwise pin focus in place.\n    if (target === from) target = from + (down ? 1 : -1);\n  } else {\n    const rowH = virt?.rowHeight ?? 0;\n    const step = usable > 0 && rowH > 0 ? Math.max(1, Math.floor(usable / rowH)) : 20;\n    target = from + (down ? step : -step);\n  }\n  return Math.max(0, Math.min(maxRow, target));\n}\n\n/** Home/End (plus Ctrl/Cmd variants which also jump to the first/last row). */\nfunction navigateRowEdge(grid: GridHost, e: KeyboardEvent, maxRow: number, maxCol: number, toEnd: boolean): void {\n  if (e.ctrlKey || e.metaKey) jumpToRowEdge(grid, maxRow, toEnd);\n  grid._focusCol = toEnd ? maxCol : 0;\n  e.preventDefault();\n  ensureCellVisible(grid, toEnd ? { forceScrollRight: true } : { forceScrollLeft: true });\n}\n\n/** Dispatch the unified `cell-activate` event. Returns true when cancelled. */\nfunction emitCellActivate(grid: GridHost, e: KeyboardEvent): boolean {\n  const rowIndex = grid._focusRow;\n  const colIndex = grid._focusCol;\n  const column = grid._visibleColumns[colIndex];\n  const row = grid._rows[rowIndex];\n  const field = column?.field ?? '';\n  const activateEvent = new CustomEvent('cell-activate', {\n    cancelable: true,\n    detail: {\n      rowIndex,\n      colIndex,\n      column,\n      field,\n      value: field && row ? readCellField(row, field) : undefined,\n      row,\n      cellEl: grid.querySelector(`[data-row=\"${rowIndex}\"][data-col=\"${colIndex}\"]`) as HTMLElement | undefined,\n      trigger: 'keyboard' as const,\n      originalEvent: e,\n    },\n  });\n  grid.dispatchEvent(activateEvent);\n  return activateEvent.defaultPrevented;\n}\n\nexport function handleGridKeyDown(grid: GridHost, e: KeyboardEvent): void {\n  // Dispatch to plugin system first - if any plugin handles it, stop here\n  if (grid._dispatchKeyDown?.(e)) return;\n\n  const path = e.composedPath?.() ?? [];\n  const target = (path.length ? path[0] : e.target) as HTMLElement | null;\n  if (shouldIgnoreKeyDown(grid, e, target)) return;\n\n  const maxRow = grid._rows.length - 1;\n  const maxCol = grid._visibleColumns.length - 1;\n\n  switch (e.key) {\n    case 'Tab':\n      navigateTab(grid, e, maxRow, maxCol);\n      break;\n    case 'ArrowDown':\n      navigateVertical(grid, e, maxRow, true);\n      break;\n    case 'ArrowUp':\n      navigateVertical(grid, e, maxRow, false);\n      break;\n    case 'ArrowRight':\n      navigateHorizontal(grid, e, maxCol, true);\n      break;\n    case 'ArrowLeft':\n      navigateHorizontal(grid, e, maxCol, false);\n      break;\n    case 'Home':\n      navigateRowEdge(grid, e, maxRow, maxCol, false);\n      return;\n    case 'End':\n      navigateRowEdge(grid, e, maxRow, maxCol, true);\n      return;\n    case 'PageDown':\n      grid._focusRow = pageTargetRow(grid, maxRow, true);\n      e.preventDefault();\n      break;\n    case 'PageUp':\n      grid._focusRow = pageTargetRow(grid, maxRow, false);\n      e.preventDefault();\n      break;\n    // NOTE: Enter is normally handled by EditingPlugin. If no plugin handled\n    // it, dispatch the unified cell-activate event for custom handling.\n    case 'Enter':\n      if (emitCellActivate(grid, e)) {\n        e.preventDefault();\n        return;\n      }\n      break;\n    default:\n      return;\n  }\n  ensureCellVisible(grid);\n}\n// #endregion\n\n// #region Cell Visibility\n/**\n * Options for ensureCellVisible to control scroll behavior.\n */\ninterface EnsureCellVisibleOptions {\n  /** Force scroll to the leftmost position (for Home key) */\n  forceScrollLeft?: boolean;\n  /** Force scroll to the rightmost position (for End key) */\n  forceScrollRight?: boolean;\n  /** Force horizontal scroll even in edit mode (for Tab navigation) */\n  forceHorizontalScroll?: boolean;\n}\n\n/**\n * Vertical: scroll the virtualized container so the focused row is in view.\n *\n * `y` is in raw row-content space (rowHeight × index). Above the browser height\n * cap (#326), `scrollEl.scrollTop` is in clamped spacer space — the two\n * coordinate systems are not interchangeable, so translate scrollTop into\n * virtual space for the comparison and back into native space when writing.\n * For sub-cap datasets the mapping is identity, so this is a no-op.\n *\n * Plugins that paint over the viewport (sticky rows) report the space they\n * obscure via `_getVerticalScrollOffsets`, so the row lands clear of the\n * overlay instead of underneath it — WCAG 2.2 SC 2.4.11 Focus Not Obscured.\n */\nfunction scrollFocusedRowIntoView(grid: GridHost): void {\n  if (!grid._virtualization?.enabled) return;\n  const { rowHeight, container, viewportEl, scrollMapping } = grid._virtualization;\n  // container is the faux scrollbar element that handles actual scrolling;\n  // viewportEl is the visible area element that has the correct height.\n  const scrollEl = container as HTMLElement | undefined;\n  const visibleHeight = viewportEl?.clientHeight ?? scrollEl?.clientHeight ?? 0;\n  if (!scrollEl || visibleHeight <= 0) return;\n\n  const offsets = grid._getVerticalScrollOffsets?.(grid._focusRow) ?? { top: 0, bottom: 0 };\n  if (offsets.skipScroll) return;\n  // A malformed or oversized report must never invert the visible band.\n  const top = Math.max(0, offsets.top);\n  const bottom = Math.max(0, offsets.bottom);\n  const usableHeight = visibleHeight - top - bottom;\n  if (usableHeight <= 0) return;\n\n  const y = grid._focusRow * rowHeight;\n  const virtualScrollTop = scrollMapping ? toVirtualScrollTop(scrollEl.scrollTop, scrollMapping) : scrollEl.scrollTop;\n  if (y < virtualScrollTop + top) {\n    const target = Math.max(0, y - top);\n    scrollEl.scrollTop = scrollMapping ? fromVirtualScrollTop(target, scrollMapping) : target;\n  } else if (y + rowHeight > virtualScrollTop + top + usableHeight) {\n    const target = Math.max(0, y - usableHeight + rowHeight - top);\n    scrollEl.scrollTop = scrollMapping ? fromVirtualScrollTop(target, scrollMapping) : target;\n  }\n}\n\n/**\n * Resolve the rendered cell for the focused row/col, or `undefined` when the\n * focused row is outside the current virtual window.\n */\nfunction findFocusedCell(grid: GridHost): { rowEl: HTMLElement | null; cell: HTMLElement } | undefined {\n  const rowIndex = grid._focusRow;\n  const vStart = grid._virtualization.start ?? 0;\n  const vEnd = grid._virtualization.end ?? grid._rows.length;\n  if (rowIndex < vStart || rowIndex >= vEnd) return undefined;\n\n  const rowEl = grid._bodyEl.querySelectorAll('.data-grid-row')[rowIndex - vStart] as HTMLElement | null;\n  // Try exact column match first, then query by data-col, then fall back to the\n  // first cell (full-width group rows).\n  let cell = rowEl?.children[grid._focusCol] as HTMLElement | undefined;\n  if (!cell || !cell.classList?.contains('cell')) {\n    cell = (rowEl?.querySelector(`.cell[data-col=\"${grid._focusCol}\"]`) ?? rowEl?.querySelector('.cell[data-col]')) as\n      HTMLElement | undefined;\n  }\n  return cell ? { rowEl: rowEl ?? null, cell } : undefined;\n}\n\n/** Horizontal: bring the focused cell into the `.tbw-scroll-area` viewport. */\nfunction scrollCellIntoViewHorizontally(\n  grid: GridHost,\n  rowEl: HTMLElement | null,\n  cell: HTMLElement,\n  options?: EnsureCellVisibleOptions,\n): void {\n  const scrollArea = grid.querySelector('.tbw-scroll-area') as HTMLElement | null;\n  if (!scrollArea) return;\n\n  // Home/End always scroll to the edge.\n  if (options?.forceScrollLeft) {\n    scrollArea.scrollLeft = 0;\n    return;\n  }\n  if (options?.forceScrollRight) {\n    scrollArea.scrollLeft = scrollArea.scrollWidth - scrollArea.clientWidth;\n    return;\n  }\n\n  // Plugins (e.g. pinned columns) report how much of the scroll area they\n  // obscure, and whether the focused cell should skip scrolling entirely\n  // (pinned cells are always visible).\n  const offsets = grid._getHorizontalScrollOffsets?.(rowEl ?? undefined, cell) ?? { left: 0, right: 0 };\n  if (offsets.skipScroll) return;\n\n  const cellRect = cell.getBoundingClientRect();\n  const scrollAreaRect = scrollArea.getBoundingClientRect();\n  const cellLeft = cellRect.left - scrollAreaRect.left + scrollArea.scrollLeft;\n  const cellRight = cellLeft + cellRect.width;\n  const visibleLeft = scrollArea.scrollLeft + offsets.left;\n  const visibleRight = scrollArea.scrollLeft + scrollArea.clientWidth - offsets.right;\n  if (cellLeft < visibleLeft) {\n    scrollArea.scrollLeft = cellLeft - offsets.left;\n  } else if (cellRight > visibleRight) {\n    scrollArea.scrollLeft = cellRight - scrollArea.clientWidth + offsets.right;\n  }\n}\n\n/** Move real DOM focus to the editor, the cell, or the grid host. */\nfunction applyFocusTarget(grid: GridHost, cell: HTMLElement, isEditing: boolean): void {\n  if (isEditing && cell.classList.contains(GridClasses.EDITING)) {\n    // Editing cell: focus the editor input inside it\n    const focusTarget = cell.querySelector(FOCUSABLE_EDITOR_SELECTOR) as HTMLElement | null;\n    if (focusTarget && document.activeElement !== focusTarget) {\n      try {\n        focusTarget.focus({ preventScroll: true });\n      } catch {\n        /* empty */\n      }\n    }\n    return;\n  }\n\n  if (isEditing) {\n    // Active edit row but this cell isn't the editing cell — focus it so Tab\n    // navigation within the row can attach editors.\n    if (cell.contains(document.activeElement)) return;\n    if (!cell.hasAttribute('tabindex')) cell.setAttribute('tabindex', '-1');\n    try {\n      cell.focus({ preventScroll: true });\n    } catch {\n      /* empty */\n    }\n    return;\n  }\n\n  // NOT editing: keep focus on the grid element (tabindex=0) rather than\n  // individual cells. In a virtualized grid, cells can be detached by\n  // subsequent render cycles (e.g., SelectionPlugin's requestAfterRender\n  // → RAF → row recycling). A detached focused cell causes activeElement\n  // to revert to <body>, breaking keyboard navigation.\n  // Visual focus is managed by the .cell-focus CSS class + data-has-focus.\n  //\n  // BUT: don't steal focus from a real focused descendant (toolpanel\n  // input, shell-header button, registered overlay control). Cell focus\n  // is virtual; if the user is actively typing in a non-cell input, we\n  // must leave that input alone. We only reclaim focus when nothing\n  // meaningful inside the grid currently holds it (active element is\n  // outside grid, on the grid host itself, or on a bare cell).\n  const active = document.activeElement;\n  const meaningful =\n    active instanceof HTMLElement &&\n    active !== grid &&\n    typeof grid.contains === 'function' &&\n    grid.contains(active) &&\n    !active.classList.contains('cell') &&\n    !active.closest('.cell');\n  if (!meaningful && active !== grid) {\n    grid.focus({ preventScroll: true });\n  }\n}\n\n/**\n * Scroll the viewport (virtualized or static) so the focused cell's row is visible\n * and apply visual focus styling / tabindex management.\n */\nexport function ensureCellVisible(grid: GridHost, options?: EnsureCellVisibleOptions): void {\n  scrollFocusedRowIntoView(grid);\n\n  const isEditing = isRowEditing(grid) || !!grid._isGridEditMode;\n  // Skip refreshVirtualWindow when in edit mode to avoid wiping editors\n  if (!isEditing) grid.refreshVirtualWindow(false);\n\n  clearCellFocus(grid._bodyEl);\n  // Clear previous aria-selected markers\n  Array.from(grid._bodyEl.querySelectorAll('[aria-selected=\"true\"]')).forEach((el) => {\n    el.setAttribute('aria-selected', 'false');\n  });\n\n  const focused = findFocusedCell(grid);\n  if (!focused) return;\n  const { rowEl, cell } = focused;\n\n  cell.classList.add('cell-focus');\n  cell.setAttribute('aria-selected', 'true');\n\n  // Skip horizontal scrolling in edit mode to prevent scroll jumps when editors\n  // are created — unless forceHorizontalScroll is set (Tab while editing).\n  if (!isEditing || options?.forceHorizontalScroll) {\n    scrollCellIntoViewHorizontally(grid, rowEl, cell, options);\n  }\n\n  applyFocusTarget(grid, cell, isEditing);\n}\n// #endregion\n","/**\n * Runtime default values for grid configuration.\n *\n * Kept out of `core/types.ts` so that file stays type-only apart from the two\n * enum-like consts whose `type` aliases are derived from them via `typeof`.\n * Import types from `./types`; import the values that back them from here.\n */\n\nimport type { A11yMessages, AnimationConfig, GridIcons } from './types';\n\n/**\n * Default English announcement messages.\n * Used when no custom messages are provided via {@link A11yConfig.messages}.\n * @since 2.0.0\n */\nexport const DEFAULT_A11Y_MESSAGES: Required<A11yMessages> = {\n  sortApplied: (column, direction) => `Sorted by ${column}, ${direction}`,\n  sortCleared: () => 'Sort cleared',\n  filterApplied: (column) => `Filter applied on ${column}`,\n  filterCleared: (column) => `Filter cleared from ${column}`,\n  allFiltersCleared: () => 'All filters cleared',\n  groupExpanded: (name, count) => `Group ${name} expanded, ${count} rows`,\n  groupCollapsed: (name) => `Group ${name} collapsed`,\n  selectionChanged: (count) => `${count} rows selected`,\n  selectAllRows: () => 'Select all rows',\n  selectRow: (rowIndex) => `Select row ${rowIndex + 1}`,\n  columnSelected: (label) => `Column ${label} selected`,\n  columnSelectionChanged: (count) => `${count} columns selected`,\n  columnSelectionCleared: () => 'Column selection cleared',\n  selectionAxisChanged: (toAxis) =>\n    toAxis === 'column'\n      ? 'Row selection cleared, column selection active'\n      : 'Column selection cleared, row selection active',\n  rangeSpanSelected: (axis, count) =>\n    count === 1 ? `${axis === 'row' ? 'Row' : 'Column'} selected` : `${count} ${axis}s selected`,\n  editingStarted: (rowIndex) => `Editing row ${rowIndex + 1}`,\n  editingCommitted: (rowIndex) => `Row ${rowIndex + 1} saved`,\n  dataLoaded: (count) => `${count} rows loaded`,\n};\n\n/**\n * Default animation configuration\n * @since 0.2.7\n */\nexport const DEFAULT_ANIMATION_CONFIG: Required<Omit<AnimationConfig, 'sort'>> = {\n  mode: 'reduced-motion',\n  duration: 200,\n  easing: 'ease-out',\n};\n\n/**\n * Default icons used when not overridden. Most entries are short text/emoji;\n * `filter` and `filterActive` are empty strings because the actual rendering\n * is driven by the `--tbw-icon-filter[-active]-mask` CSS custom properties\n * (see `core/styles/variables.css`). Userland that wants an HTML/SVG fallback\n * via `gridConfig.icons.filter = '<svg…>'` is unaffected — that path overrides this default.\n * @since 0.1.1\n */\nexport const DEFAULT_GRID_ICONS: Required<GridIcons> = {\n  expand: '▶',\n  collapse: '▼',\n  sortAsc: '▲',\n  sortDesc: '▼',\n  sortNone: '⇅',\n  submenuArrow: '▶',\n  dragHandle: '⋮⋮',\n  toolPanel: '☰',\n  filter: '',\n  filterActive: '',\n  print: '🖨️',\n};\n","/**\n * Centralized diagnostic messages for @toolbox-web/grid.\n *\n * Every user-facing warning, error, or info message in the grid has a unique\n * diagnostic code (e.g. `TBW001`). Each code maps to a section on the online\n * troubleshooting page, giving developers a direct link to resolution steps.\n *\n * ## Usage\n *\n * ```ts\n * import { MISSING_BREAKPOINT, warnDiagnostic, throwDiagnostic } from './diagnostics';\n *\n * // Warn with a code\n * warnDiagnostic(MISSING_BREAKPOINT, 'Set a breakpoint...', gridId);\n *\n * // Throw with a code\n * throwDiagnostic(MISSING_ROW_ID, 'Configure getRowId...', gridId);\n * ```\n *\n * Plugins should prefer `this.warn(MISSING_BREAKPOINT, message)` via BaseGridPlugin\n * instead of importing this module directly.\n *\n * @internal\n */\n\n// #region Grid Prefix\n\n/**\n * Build the `[tbw-grid]` or `[tbw-grid#my-id]` log prefix.\n * Pass `pluginName` for a scoped prefix like `[tbw-grid:SelectionPlugin]`.\n */\nexport function gridPrefix(gridId?: string, pluginName?: string): string {\n  const id = gridId ? `#${gridId}` : '';\n  const plugin = pluginName ? `:${pluginName}` : '';\n  return `[tbw-grid${id}${plugin}]`;\n}\n\n// #endregion\n\n// #region Diagnostic Codes\n\n/**\n * Diagnostic codes used across the grid library.\n *\n * Each code is an individual export so that unused codes are tree-shaken\n * from bundles that don't reference them (esbuild can't tree-shake\n * properties from a single object).\n *\n * Naming: TBW + 3-digit number.\n * Ranges:\n *   001–019  Configuration validation (missing plugins, bad config)\n *   020–029  Plugin lifecycle (dependencies, incompatibilities, alias collapse)\n *   030–039  Feature registry\n *   040–049  Row operations (row ID, row mutations)\n *   050–059  Column operations (width, template)\n *   060–069  Rendering (callbacks, formatters, external views)\n *   070–079  Shell (tool panels, header/toolbar content)\n *   080–089  Editing & editors\n *   090–099  Print\n *   100–109  Clipboard\n *   110–119  Plugin-specific (responsive, undo-redo, grouping-columns)\n *   120–129  Style injection\n *   130–139  Attribute parsing\n *   140–149  DataSource / ServerSide\n */\n\n// --- Config validation (001–019) ---\n/** Column uses a plugin-owned property but the plugin is not loaded. */\nexport const MISSING_PLUGIN = 'TBW001' as const;\n/** Grid config uses a plugin-owned property but the plugin is not loaded. */\nexport const MISSING_PLUGIN_CONFIG = 'TBW002' as const;\n/** Plugin config rule violation (error severity). */\nexport const CONFIG_RULE_ERROR = 'TBW003' as const;\n/** Plugin config rule violation (warning severity). */\nexport const CONFIG_RULE_WARN = 'TBW004' as const;\n\n// --- Plugin lifecycle (020–029) ---\n/** Required plugin dependency is missing. */\nexport const MISSING_DEPENDENCY = 'TBW020' as const;\n/** Optional plugin dependency is missing. */\nexport const OPTIONAL_DEPENDENCY = 'TBW021' as const;\n/** Two loaded plugins are incompatible. */\nexport const INCOMPATIBLE_PLUGINS = 'TBW022' as const;\n/** Two plugin instances resolve to the same canonical name (alias collapse). */\nexport const PLUGIN_ALIAS_COLLAPSE = 'TBW023' as const;\n/** Error thrown inside a plugin event handler. */\nexport const PLUGIN_EVENT_ERROR = 'TBW024' as const;\n/** Conflicting config values found while merging alias-collapsed plugin instances. */\nexport const PLUGIN_ALIAS_CONFIG_CONFLICT = 'TBW025' as const;\n\n// --- Feature registry (030–039) ---\n/** Feature was re-registered (overwritten). */\nexport const FEATURE_REREGISTERED = 'TBW030' as const;\n/** Feature configured but not imported. */\nexport const FEATURE_NOT_IMPORTED = 'TBW031' as const;\n/** Feature depends on another feature that is not enabled. */\nexport const FEATURE_MISSING_DEP = 'TBW032' as const;\n\n// --- Row operations (040–049) ---\n/** Cannot determine row ID (no getRowId and no id property). */\nexport const MISSING_ROW_ID = 'TBW040' as const;\n/** Row with given ID not found. */\nexport const ROW_NOT_FOUND = 'TBW041' as const;\n\n// --- Column operations (050–059) ---\n/** Column has an invalid CSS width value. */\nexport const INVALID_COLUMN_WIDTH = 'TBW050' as const;\n\n// --- Rendering callbacks (060–069) ---\n/** rowClass callback threw an error. */\nexport const ROW_CLASS_ERROR = 'TBW060' as const;\n/** cellClass callback threw an error. */\nexport const CELL_CLASS_ERROR = 'TBW061' as const;\n/** Column format function threw an error. */\nexport const FORMAT_ERROR = 'TBW062' as const;\n/** External view mount() threw an error. */\nexport const VIEW_MOUNT_ERROR = 'TBW063' as const;\n/** External view event dispatch error. */\nexport const VIEW_DISPATCH_ERROR = 'TBW064' as const;\n\n// --- Shell (070–079) ---\n/** Tool panel missing required id. */\nexport const TOOL_PANEL_MISSING_ATTR = 'TBW070' as const;\n/** No tool panels registered. */\nexport const NO_TOOL_PANELS = 'TBW071' as const;\n/** Tool panel section not found. */\nexport const TOOL_PANEL_NOT_FOUND = 'TBW072' as const;\n/** Tool panel already registered. */\nexport const TOOL_PANEL_DUPLICATE = 'TBW073' as const;\n/** Header content already registered. */\nexport const HEADER_CONTENT_DUPLICATE = 'TBW074' as const;\n/** Toolbar content already registered. */\nexport const TOOLBAR_CONTENT_DUPLICATE = 'TBW075' as const;\n\n// --- Editing & editors (080–089) ---\n/** External editor mount() threw an error. */\nexport const EDITOR_MOUNT_ERROR = 'TBW080' as const;\n\n// --- Print (090–099) ---\n/** Print already in progress. */\nexport const PRINT_IN_PROGRESS = 'TBW090' as const;\n/** Grid not available for printing. */\nexport const PRINT_NO_GRID = 'TBW091' as const;\n/** Print operation failed. */\nexport const PRINT_FAILED = 'TBW092' as const;\n/** Multiple elements share the same grid ID (print isolation issue). */\nexport const PRINT_DUPLICATE_ID = 'TBW093' as const;\n\n// --- Clipboard (100–109) ---\n/** Clipboard API write failed. */\nexport const CLIPBOARD_FAILED = 'TBW100' as const;\n\n// --- Plugin-specific (110–119) ---\n/** ResponsivePlugin: no breakpoint configured. */\nexport const MISSING_BREAKPOINT = 'TBW110' as const;\n/** UndoRedoPlugin: transaction already in progress. */\nexport const TRANSACTION_IN_PROGRESS = 'TBW111' as const;\n/** UndoRedoPlugin: no transaction in progress. */\nexport const NO_TRANSACTION = 'TBW112' as const;\n/** GroupingColumnsPlugin: missing id or header on column group definition. */\nexport const COLUMN_GROUP_NO_ID = 'TBW113' as const;\n/** GroupingColumnsPlugin: conflicting columnGroups sources. */\nexport const COLUMN_GROUPS_CONFLICT = 'TBW114' as const;\n\n// --- Style injection (120–129) ---\n/** Failed to extract grid.css from document stylesheets. */\nexport const STYLE_EXTRACT_FAILED = 'TBW120' as const;\n/** Could not find grid.css in document.styleSheets. */\nexport const STYLE_NOT_FOUND = 'TBW121' as const;\n\n// --- Attribute parsing (130–139) ---\n/** Invalid JSON in an HTML attribute. */\nexport const INVALID_ATTRIBUTE_JSON = 'TBW130' as const;\n\n// --- DataSource / ServerSide (140–149) ---\n/** ServerSidePlugin: getRows() rejected. */\nexport const DATASOURCE_FETCH_ERROR = 'TBW140' as const;\n/** ServerSidePlugin: getChildRows() rejected. */\nexport const DATASOURCE_CHILD_FETCH_ERROR = 'TBW141' as const;\n/** ServerSidePlugin: getChildRows() not implemented but a plugin queried for children. */\nexport const DATASOURCE_NO_CHILD_HANDLER = 'TBW142' as const;\n/** ServerSidePlugin: concurrent request limit reached, request deferred. */\nexport const DATASOURCE_THROTTLED = 'TBW143' as const;\n\nexport type DiagnosticCode =\n  | typeof MISSING_PLUGIN\n  | typeof MISSING_PLUGIN_CONFIG\n  | typeof CONFIG_RULE_ERROR\n  | typeof CONFIG_RULE_WARN\n  | typeof MISSING_DEPENDENCY\n  | typeof OPTIONAL_DEPENDENCY\n  | typeof INCOMPATIBLE_PLUGINS\n  | typeof PLUGIN_ALIAS_COLLAPSE\n  | typeof PLUGIN_EVENT_ERROR\n  | typeof PLUGIN_ALIAS_CONFIG_CONFLICT\n  | typeof FEATURE_REREGISTERED\n  | typeof FEATURE_NOT_IMPORTED\n  | typeof FEATURE_MISSING_DEP\n  | typeof MISSING_ROW_ID\n  | typeof ROW_NOT_FOUND\n  | typeof INVALID_COLUMN_WIDTH\n  | typeof ROW_CLASS_ERROR\n  | typeof CELL_CLASS_ERROR\n  | typeof FORMAT_ERROR\n  | typeof VIEW_MOUNT_ERROR\n  | typeof VIEW_DISPATCH_ERROR\n  | typeof TOOL_PANEL_MISSING_ATTR\n  | typeof NO_TOOL_PANELS\n  | typeof TOOL_PANEL_NOT_FOUND\n  | typeof TOOL_PANEL_DUPLICATE\n  | typeof HEADER_CONTENT_DUPLICATE\n  | typeof TOOLBAR_CONTENT_DUPLICATE\n  | typeof EDITOR_MOUNT_ERROR\n  | typeof PRINT_IN_PROGRESS\n  | typeof PRINT_NO_GRID\n  | typeof PRINT_FAILED\n  | typeof PRINT_DUPLICATE_ID\n  | typeof CLIPBOARD_FAILED\n  | typeof MISSING_BREAKPOINT\n  | typeof TRANSACTION_IN_PROGRESS\n  | typeof NO_TRANSACTION\n  | typeof COLUMN_GROUP_NO_ID\n  | typeof COLUMN_GROUPS_CONFLICT\n  | typeof STYLE_EXTRACT_FAILED\n  | typeof STYLE_NOT_FOUND\n  | typeof INVALID_ATTRIBUTE_JSON\n  | typeof DATASOURCE_FETCH_ERROR\n  | typeof DATASOURCE_CHILD_FETCH_ERROR\n  | typeof DATASOURCE_NO_CHILD_HANDLER\n  | typeof DATASOURCE_THROTTLED;\n\n// #endregion\n\n// #region Docs URL\n\nconst DOCS_BASE = 'https://toolboxjs.com/grid/errors';\n\n/** Build a direct link to the troubleshooting section for a code. */\nfunction docsUrl(code: DiagnosticCode): string {\n  return `${DOCS_BASE}#${code.toLowerCase()}`;\n}\n\n// #endregion\n\n// #region Formatting\n\n/**\n * Format a diagnostic message with prefix, code, and docs link.\n *\n * Output format:\n * ```\n * [tbw-grid#my-id] TBW001: Your message here.\n *\n *   → More info: https://toolboxjs.com/grid/errors#tbw001\n * ```\n */\nexport function formatDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): string {\n  const prefix = gridPrefix(gridId, pluginName);\n  return `${prefix} ${code}: ${message}\\n\\n  → More info: ${docsUrl(code)}`;\n}\n\n// #endregion\n\n// #region Public API\n\n/**\n * Throw an error with a diagnostic code and docs link.\n * Use for configuration errors and API misuse that should halt execution.\n */\nexport function throwDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): never {\n  throw new Error(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n/**\n * Log a warning with a diagnostic code and docs link.\n * Use for recoverable issues the developer should fix.\n */\nexport function warnDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void {\n  console.warn(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n/**\n * Log a debug message with a diagnostic code and docs link.\n * Use for optional/soft dependency notifications — visible only when\n * the browser DevTools \"Verbose\" log level is enabled.\n */\nexport function debugDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void {\n  console.debug(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n/**\n * Log an error with a diagnostic code and docs link.\n * Use for non-throwing errors (e.g., failed async operations).\n */\nexport function errorDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void {\n  console.error(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n// #endregion\n","// Centralized template expression evaluation & sanitization utilities.\n// Responsible for safely interpolating {{ }} expressions while blocking\n// access to dangerous globals / reflective capabilities.\nimport type { CompiledViewFunction, EvalContext } from '../types';\n\n// #region Constants\nconst EXPR_RE = /{{\\s*([^}]+)\\s*}}/g;\nconst EMPTY_SENTINEL = '__DG_EMPTY__';\nconst SAFE_EXPR = /^[\\w$. '?+\\-*/%:()!<>=,&|]+$/;\n\n// Forbidden identifiers built at runtime to avoid static analysis scanners\n// from flagging string literals (e.g. socket.dev \"network access\" / \"uses eval\").\n// Stored as reversed, pipe-delimited tokens — reversed back when constructing the regex.\nconst _F =\n  '__otorp__|__retteGenifed__|__retteSenifed__|rotcurtsnoc|wodniw|sihTlabolg|labolg|ssecorp|noitcnuF|tropmi|lave|tcelfeR|yxorP|rorrE|stnemugra|tnemucod|noitacol|eikooc|egarotSlacol|egarotSnoisses|BDdexedni|hctef|tseuqeRpttHLMX|tekcoSbeW|rekroW|rekroWderahS|rekroWecivreS|renepo|tnerap|pot|semarf|fles'\n    .split('|')\n    .map((s) => s.split('').reverse().join(''));\nconst FORBIDDEN = new RegExp(`__(proto|defineGetter|defineSetter)|${_F.slice(3).join('|')}|this\\\\b`);\n// #endregion\n\n// #region HTML Sanitization\n\n/**\n * Escape a plain text string for safe insertion into HTML.\n * Converts special HTML characters to their entity equivalents.\n *\n * @param text - Plain text string to escape\n * @returns HTML-safe string\n */\nexport function escapeHtml(text: string): string {\n  if (!text || typeof text !== 'string') return '';\n  return text\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&#39;');\n}\n\n/**\n * Tags that are considered dangerous and will be completely removed.\n * These can execute scripts, load external resources, or manipulate the page.\n */\nconst DANGEROUS_TAGS = new Set(\n  'script|iframe|object|embed|form|input|button|textarea|select|link|meta|base|style|template|slot|portal|frame|frameset|applet|noscript|noembed|plaintext|xmp|listing|math'.split(\n    '|',\n  ),\n);\n\n/**\n * Attributes that are considered dangerous - event handlers and data loading.\n */\nconst DANGEROUS_ATTR_PATTERN = /^on\\w+$/i;\n\n/**\n * Attributes that can contain URLs which might be javascript: or data: URIs.\n */\nconst URL_ATTRS = new Set('href|src|action|formaction|data|srcdoc|xlink:href|poster|srcset'.split('|'));\n\n/**\n * Protocol patterns that are dangerous in URLs.\n */\nconst DANGEROUS_URL_PROTOCOL = /^\\s*(javascript|vbscript|data|blob):/i;\n\n/**\n * Sanitize an HTML string by removing dangerous tags and attributes.\n *\n * Prefer {@link setSanitizedHTML} wherever the result is destined for an\n * element: this function has to re-serialize the sanitized tree back to a\n * string, and the caller's `innerHTML =` then re-parses it. That\n * parse→serialize→parse round trip is the classic mutation-XSS vector, and it\n * costs a second parse. Use this overload only when a string is genuinely\n * required (e.g. the value is stored, compared, or handed to another API).\n *\n * @param html - Raw HTML string to sanitize\n * @returns Sanitized HTML string safe for innerHTML\n */\nexport function sanitizeHTML(html: string): string {\n  if (!html || typeof html !== 'string') return '';\n\n  // Fast path: if no HTML tags at all, return as-is (already safe)\n  if (html.indexOf('<') === -1) return html;\n\n  const template = document.createElement('template');\n  template.innerHTML = html;\n\n  sanitizeNode(template.content);\n\n  return template.innerHTML;\n}\n\n/**\n * Parse and sanitize an HTML string into a detached {@link DocumentFragment}.\n *\n * This is the primitive {@link setSanitizedHTML} builds on, exposed for callers\n * that need to inspect or relocate the nodes before insertion.\n *\n * @param html - Raw HTML string to sanitize\n * @returns Fragment containing the sanitized nodes (empty for falsy input)\n */\nexport function sanitizeToFragment(html: string): DocumentFragment {\n  const template = document.createElement('template');\n  if (html && typeof html === 'string') {\n    template.innerHTML = html;\n    sanitizeNode(template.content);\n  }\n  return template.content;\n}\n\n/**\n * Replace an element's children with the sanitized parse of `html`.\n *\n * **This is the canonical sink for user-supplied markup** — cell/header/group\n * renderer string returns, `gridConfig.icons.*`, light-DOM tool panel fallback\n * content, and any new extension point that turns a user string into markup.\n * `textContent` is wrong here (it renders SVG icon strings as literal text) and\n * raw `innerHTML` is wrong (it is an XSS sink).\n *\n * Nodes are moved from the parse fragment rather than re-serialized, so the\n * sanitized tree is exactly what lands in the document.\n *\n * @param el - Element whose children are replaced\n * @param html - Raw HTML string to sanitize and insert\n */\nexport function setSanitizedHTML(el: Element, html: string): void {\n  if (!html || typeof html !== 'string') {\n    el.replaceChildren();\n    return;\n  }\n  // Nothing for the parser to do: no markup and no entities to decode.\n  if (html.indexOf('<') === -1 && html.indexOf('&') === -1) {\n    el.textContent = html;\n    return;\n  }\n  el.replaceChildren(sanitizeToFragment(html));\n}\n\n/**\n * Recursively sanitize a DOM node tree.\n */\nfunction sanitizeNode(root: DocumentFragment | Element): void {\n  const toRemove: Element[] = [];\n\n  // Use querySelectorAll to find all elements, then filter\n  const elements = root.querySelectorAll('*');\n\n  for (const el of elements) {\n    const tagName = el.tagName.toLowerCase();\n\n    // Check if tag is dangerous\n    if (DANGEROUS_TAGS.has(tagName)) {\n      toRemove.push(el);\n      continue;\n    }\n\n    // SVG elements need special handling - they can contain script-like behavior\n    if (tagName === 'svg' || el.namespaceURI === 'http://www.w3.org/2000/svg') {\n      // Remove entire SVG if it has any suspicious attributes\n      const hasDangerousContent = Array.from(el.attributes).some(\n        (attr) => DANGEROUS_ATTR_PATTERN.test(attr.name) || attr.name === 'href' || attr.name === 'xlink:href',\n      );\n      if (hasDangerousContent) {\n        toRemove.push(el);\n        continue;\n      }\n    }\n\n    // Check and remove dangerous attributes\n    const attrsToRemove: string[] = [];\n    for (const attr of el.attributes) {\n      const attrName = attr.name.toLowerCase();\n\n      // Event handlers (onclick, onerror, onload, etc.)\n      if (DANGEROUS_ATTR_PATTERN.test(attrName)) {\n        attrsToRemove.push(attr.name);\n        continue;\n      }\n\n      // `is=` upgrades a plain tag into a registered customized built-in, so it\n      // can smuggle behaviour past the tag-name check above.\n      if (attrName === 'is') {\n        attrsToRemove.push(attr.name);\n        continue;\n      }\n\n      // URL attributes with dangerous protocols\n      if (URL_ATTRS.has(attrName) && DANGEROUS_URL_PROTOCOL.test(attr.value)) {\n        attrsToRemove.push(attr.name);\n        continue;\n      }\n\n      // style attribute can contain expressions (IE) or url() with javascript:\n      if (attrName === 'style' && /expression\\s*\\(|javascript:|behavior\\s*:/i.test(attr.value)) {\n        attrsToRemove.push(attr.name);\n        continue;\n      }\n    }\n\n    attrsToRemove.forEach((name) => el.removeAttribute(name));\n  }\n\n  // Remove dangerous elements (do this after iteration to avoid modifying during traversal)\n  toRemove.forEach((el) => el.remove());\n}\n\n// #endregion\n\n// #region Template Evaluation\n\n// #region Safe Expression Evaluator\n// A minimal recursive-descent evaluator for the token set allowed by SAFE_EXPR.\n// Replaces `new Function()` to avoid dynamic code execution warnings from\n// static analysis tools (socket.dev, npm audit) while maintaining identical\n// functionality for expressions that pass the allowlist guards.\n//\n// Supported grammar (matching SAFE_EXPR = /^[\\w$. '?+\\-*/%:()!<>=,&|]+$/):\n//   ternary     → logicalOr ('?' ternary ':' ternary)?\n//   logicalOr   → logicalAnd ('||' logicalAnd)*\n//   logicalAnd  → equality ('&&' equality)*\n//   equality    → comparison (('==' | '!=' | '===' | '!==') comparison)*\n//   comparison  → additive (('<' | '>' | '<=' | '>=') additive)*\n//   additive    → multiplicative (('+' | '-') multiplicative)*\n//   multiplicative → unary (('*' | '/' | '%') unary)*\n//   unary       → '!' unary | primary\n//   primary     → NUMBER | STRING | IDENT ('.' IDENT)? | '(' ternary ')'\n\ntype Token =\n  { type: 'num'; v: number } | { type: 'str'; v: string } | { type: 'id'; v: string } | { type: 'op'; v: string };\n\nfunction tokenize(expr: string): Token[] | null {\n  const tokens: Token[] = [];\n  let i = 0;\n  while (i < expr.length) {\n    const ch = expr[i];\n    if (ch === ' ') {\n      i++;\n      continue;\n    }\n\n    // Numbers\n    if ((ch >= '0' && ch <= '9') || (ch === '.' && i + 1 < expr.length && expr[i + 1] >= '0' && expr[i + 1] <= '9')) {\n      const start = i;\n      while (i < expr.length && ((expr[i] >= '0' && expr[i] <= '9') || expr[i] === '.')) i++;\n      tokens.push({ type: 'num', v: Number(expr.slice(start, i)) });\n      continue;\n    }\n\n    // String literals (single-quoted only, per SAFE_EXPR)\n    if (ch === \"'\") {\n      let s = '';\n      i++; // skip opening quote\n      while (i < expr.length && expr[i] !== \"'\") s += expr[i++];\n      if (i >= expr.length) return null; // unterminated\n      i++; // skip closing quote\n      tokens.push({ type: 'str', v: s });\n      continue;\n    }\n\n    // Identifiers (value, row, row.field)\n    if ((ch >= 'a' && ch <= 'z') || (ch >= 'A' && ch <= 'Z') || ch === '_' || ch === '$') {\n      const start = i;\n      while (i < expr.length && /[\\w$.]/.test(expr[i])) i++;\n      tokens.push({ type: 'id', v: expr.slice(start, i) });\n      continue;\n    }\n\n    // Multi-char operators\n    if (i + 2 < expr.length) {\n      const tri = expr.slice(i, i + 3);\n      if (tri === '===' || tri === '!==') {\n        tokens.push({ type: 'op', v: tri });\n        i += 3;\n        continue;\n      }\n    }\n    if (i + 1 < expr.length) {\n      const bi = expr.slice(i, i + 2);\n      if (bi === '==' || bi === '!=' || bi === '<=' || bi === '>=' || bi === '&&' || bi === '||') {\n        tokens.push({ type: 'op', v: bi });\n        i += 2;\n        continue;\n      }\n    }\n\n    // Single-char operators\n    if ('+-*/%<>!?:(),'.includes(ch)) {\n      tokens.push({ type: 'op', v: ch });\n      i++;\n      continue;\n    }\n\n    return null; // unexpected character\n  }\n  return tokens;\n}\n\nfunction safeEval(expr: string, ctx: EvalContext): unknown {\n  const toks = tokenize(expr);\n  if (!toks) return undefined;\n  const tokens: Token[] = toks;\n  let pos = 0;\n\n  function peek(): Token | undefined {\n    return tokens[pos];\n  }\n  function advance(): Token {\n    return tokens[pos++];\n  }\n  function match(type: string, val?: string): boolean {\n    const t = peek();\n    if (!t) return false;\n    if (t.type !== type) return false;\n    if (val !== undefined && t.v !== val) return false;\n    return true;\n  }\n\n  function resolveId(name: string): unknown {\n    if (name === 'value') return ctx.value;\n    if (name.startsWith('row.')) {\n      const key = name.slice(4);\n      return ctx.row ? ctx.row[key] : undefined;\n    }\n    if (name.startsWith('typeDefault.')) {\n      const key = name.slice('typeDefault.'.length);\n      return ctx.typeDefault ? ctx.typeDefault[key] : undefined;\n    }\n    // bare 'row' reference\n    if (name === 'row') return ctx.row;\n    if (name === 'typeDefault') return ctx.typeDefault;\n    return undefined;\n  }\n\n  function parseTernary(): unknown {\n    const result = parseLogicalOr();\n    if (match('op', '?')) {\n      advance(); // consume '?'\n      const consequent = parseTernary();\n      if (!match('op', ':')) return undefined;\n      advance(); // consume ':'\n      const alternate = parseTernary();\n      return result ? consequent : alternate;\n    }\n    return result;\n  }\n\n  function parseLogicalOr(): unknown {\n    let left = parseLogicalAnd();\n    while (match('op', '||')) {\n      advance();\n      left = left || parseLogicalAnd();\n    }\n    return left;\n  }\n\n  function parseLogicalAnd(): unknown {\n    let left = parseEquality();\n    while (match('op', '&&')) {\n      advance();\n      left = left && parseEquality();\n    }\n    return left;\n  }\n\n  function parseEquality(): unknown {\n    let left = parseComparison();\n    while (true) {\n      const t = peek();\n      if (!t || t.type !== 'op') break;\n      if (t.v === '===') {\n        advance();\n        left = left === parseComparison();\n      } else if (t.v === '!==') {\n        advance();\n        left = left !== parseComparison();\n      } else if (t.v === '==') {\n        advance();\n        left = left == parseComparison();\n      } else if (t.v === '!=') {\n        advance();\n        left = left != parseComparison();\n      } else break;\n    }\n    return left;\n  }\n\n  function parseComparison(): unknown {\n    let left = parseAdditive();\n    while (true) {\n      const t = peek();\n      if (!t || t.type !== 'op') break;\n      if (t.v === '<') {\n        advance();\n        left = (left as number) < (parseAdditive() as number);\n      } else if (t.v === '>') {\n        advance();\n        left = (left as number) > (parseAdditive() as number);\n      } else if (t.v === '<=') {\n        advance();\n        left = (left as number) <= (parseAdditive() as number);\n      } else if (t.v === '>=') {\n        advance();\n        left = (left as number) >= (parseAdditive() as number);\n      } else break;\n    }\n    return left;\n  }\n\n  function parseAdditive(): unknown {\n    let left = parseMultiplicative();\n    while (true) {\n      const t = peek();\n      if (!t || t.type !== 'op') break;\n      if (t.v === '+') {\n        advance();\n        left = (left as number) + (parseMultiplicative() as number);\n      } else if (t.v === '-') {\n        advance();\n        left = (left as number) - (parseMultiplicative() as number);\n      } else break;\n    }\n    return left;\n  }\n\n  function parseMultiplicative(): unknown {\n    let left = parseUnary();\n    while (true) {\n      const t = peek();\n      if (!t || t.type !== 'op') break;\n      if (t.v === '*') {\n        advance();\n        left = (left as number) * (parseUnary() as number);\n      } else if (t.v === '/') {\n        advance();\n        left = (left as number) / (parseUnary() as number);\n      } else if (t.v === '%') {\n        advance();\n        left = (left as number) % (parseUnary() as number);\n      } else break;\n    }\n    return left;\n  }\n\n  function parseUnary(): unknown {\n    if (match('op', '!')) {\n      advance();\n      return !parseUnary();\n    }\n    return parsePrimary();\n  }\n\n  function parsePrimary(): unknown {\n    const t = peek();\n    if (!t) return undefined;\n    if (t.type === 'num') {\n      advance();\n      return t.v;\n    }\n    if (t.type === 'str') {\n      advance();\n      return t.v;\n    }\n    if (t.type === 'id') {\n      advance();\n      return resolveId(t.v as string);\n    }\n    if (t.type === 'op' && t.v === '(') {\n      advance(); // consume '('\n      const result = parseTernary();\n      if (match('op', ')')) advance(); // consume ')'\n      return result;\n    }\n    // Unary minus for negative numbers\n    if (t.type === 'op' && t.v === '-') {\n      advance();\n      return -(parsePrimary() as number);\n    }\n    return undefined;\n  }\n\n  const result = parseTernary();\n  // Ensure all tokens were consumed\n  if (pos < tokens.length) return undefined;\n  return result;\n}\n// #endregion\n\nexport function evalTemplateString(raw: string, ctx: EvalContext): string {\n  if (!raw || raw.indexOf('{{') === -1) return raw; // fast path (no expressions)\n  const parts: { expr: string; result: string }[] = [];\n  const evaluated = raw.replace(EXPR_RE, (_m, expr) => {\n    const res = evalSingle(expr, ctx);\n    parts.push({ expr: expr.trim(), result: res });\n    // The template markup is author-controlled; the interpolated data is not.\n    // Escaping here stops row data from injecting elements or breaking out of\n    // an attribute (sanitizeHTML downstream only strips *dangerous* markup).\n    return res === EMPTY_SENTINEL ? res : escapeHtml(res);\n  });\n  const finalStr = postProcess(evaluated);\n  // If every part evaluated to EMPTY_SENTINEL we treat this as intentionally blank.\n  // If any expression was blocked due to forbidden token (EMPTY_SENTINEL) we *still* only output ''\n  // but do not escalate to BLOCKED_SENTINEL unless the original contained explicit forbidden tokens.\n  const allEmpty = parts.length && parts.every((p) => p.result === '' || p.result === EMPTY_SENTINEL);\n  const hadForbidden = REFLECTIVE_RE.test(raw);\n  if (hadForbidden || allEmpty) return '';\n  return finalStr;\n}\n\nfunction evalSingle(expr: string, ctx: EvalContext): string {\n  expr = (expr || '').trim();\n  if (!expr) return EMPTY_SENTINEL;\n  if (REFLECTIVE_RE.test(expr)) return EMPTY_SENTINEL;\n  if (expr === 'value') return ctx.value == null ? EMPTY_SENTINEL : String(ctx.value);\n  if (expr.startsWith('row.') && !/[()?]/.test(expr) && !expr.includes(':')) {\n    const key = expr.slice(4);\n    const v = ctx.row ? ctx.row[key] : undefined;\n    return v == null ? EMPTY_SENTINEL : String(v);\n  }\n  if (expr.startsWith('typeDefault.') && !/[()?]/.test(expr) && !expr.includes(':')) {\n    const key = expr.slice('typeDefault.'.length);\n    const v = ctx.typeDefault ? ctx.typeDefault[key] : undefined;\n    return v == null ? EMPTY_SENTINEL : String(v);\n  }\n  if (expr.length > 80) return EMPTY_SENTINEL;\n  if (!SAFE_EXPR.test(expr) || FORBIDDEN.test(expr)) return EMPTY_SENTINEL;\n  const dotChain = expr.match(/\\./g);\n  if (dotChain && dotChain.length > 1) return EMPTY_SENTINEL;\n  try {\n    const out = safeEval(expr, ctx);\n    const str = out == null ? '' : String(out);\n    if (REFLECTIVE_RE.test(str)) return EMPTY_SENTINEL;\n    return str || EMPTY_SENTINEL;\n  } catch {\n    return EMPTY_SENTINEL;\n  }\n}\n// #endregion\n\n// #region Cell Scrubbing\n/** Pattern matching reflective/introspective APIs that must be stripped from output. */\nconst REFLECTIVE_RE = /Reflect|Proxy|ownKeys/;\n\nfunction postProcess(s: string): string {\n  if (!s) return s;\n  return s.replace(new RegExp(EMPTY_SENTINEL, 'g'), '').replace(/Reflect\\.[^<>{}\\s]+|\\bProxy\\b|ownKeys\\([^)]*\\)/g, '');\n}\n\nexport function finalCellScrub(cell: HTMLElement): void {\n  if (!REFLECTIVE_RE.test(cell.textContent || '')) return;\n  // First pass: clear only text nodes containing forbidden tokens\n  for (const n of cell.childNodes) {\n    if (n.nodeType === Node.TEXT_NODE && REFLECTIVE_RE.test(n.textContent || '')) n.textContent = '';\n  }\n  // If forbidden tokens persist in element nodes, nuke everything\n  if (REFLECTIVE_RE.test(cell.textContent || '')) {\n    cell.textContent = '';\n  }\n}\n// #endregion\n\n// #region Template Compilation\nexport function compileTemplate(raw: string) {\n  if (REFLECTIVE_RE.test(raw)) {\n    const fn = (() => '') as CompiledViewFunction;\n    fn.__blocked = true;\n    return fn;\n  }\n  const fn = ((ctx: EvalContext) => evalTemplateString(raw, ctx)) as CompiledViewFunction;\n  fn.__blocked = false;\n  return fn;\n}\n// #endregion\n","/**\n * Base Grid Plugin Class\n *\n * All plugins extend this abstract class.\n * Plugins are instantiated per-grid and manage their own state.\n */\n\n// Injected by Vite at build time from package.json (same as grid.ts)\ndeclare const __GRID_VERSION__: string;\n\nimport type { HeaderContentDefinition, ToolPanelDefinition } from '../../plugins/shell/types';\nimport { DEFAULT_GRID_ICONS } from '../defaults';\nimport {\n  type DiagnosticCode,\n  PLUGIN_ALIAS_CONFIG_CONFLICT,\n  formatDiagnostic,\n  gridPrefix,\n} from '../internal/diagnostics';\nimport { setSanitizedHTML } from '../internal/sanitize';\nimport type {\n  ColumnConfig,\n  ColumnState,\n  GridConfig,\n  GridIcons,\n  GridPlugin,\n  IconValue,\n  PluginNameMap,\n  Translate,\n} from '../types';\n\n// Re-export shared plugin types for convenience\nexport type {\n  AfterCellRenderContext,\n  AfterRowRenderContext,\n  CellClickEvent,\n  CellCoords,\n  CellEditor,\n  CellMouseEvent,\n  CellRenderer,\n  ContextMenuItem,\n  ContextMenuParams,\n  GridElementRef,\n  HeaderClickEvent,\n  HeaderRenderer,\n  KeyboardModifiers,\n  PluginCellRenderContext,\n  PluginQuery,\n  RowClickEvent,\n  ScrollEvent,\n} from './types';\n\nimport type {\n  AfterCellRenderContext,\n  AfterRowRenderContext,\n  CellClickEvent,\n  CellEditor,\n  CellMouseEvent,\n  CellRenderer,\n  GridElementRef,\n  HeaderClickEvent,\n  HeaderRenderer,\n  PluginQuery,\n  RowClickEvent,\n  ScrollEvent,\n} from './types';\n\n/**\n * Grid element interface for plugins.\n * Extends GridElementRef with plugin-specific methods.\n * Note: effectiveConfig is already available from GridElementRef.\n */\nexport interface GridElement extends GridElementRef {\n  getPlugin<T extends GridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined;\n  getPluginByName<K extends string>(\n    name: K,\n  ): (K extends keyof PluginNameMap ? PluginNameMap[K] : BaseGridPlugin) | undefined;\n  /**\n   * Get a plugin's state by plugin name.\n   * This is a loose-coupling method for plugins to access other plugins' state\n   * without importing the plugin class directly.\n   * @internal Plugin API\n   */\n  getPluginState?(name: string): unknown;\n\n  // Focus Management\n  /** Register an external DOM element as a logical focus container. @internal Plugin API */\n  registerExternalFocusContainer?(el: Element): void;\n  /** Unregister a previously registered external focus container. @internal Plugin API */\n  unregisterExternalFocusContainer?(el: Element): void;\n  /** Check whether focus is logically inside this grid (own DOM + external containers). @internal Plugin API */\n  containsFocus?(node?: Node | null): boolean;\n}\n\n/**\n * Header render context for plugin header renderers.\n */\nexport interface PluginHeaderRenderContext {\n  /** Column configuration */\n  column: ColumnConfig;\n  /** Column index */\n  colIndex: number;\n}\n\n// ============================================================================\n// Plugin Dependency Types\n// ============================================================================\n\n/**\n * Declares a dependency on another plugin.\n *\n * @category Plugin Development\n * @example\n * ```typescript\n * export class UndoRedoPlugin extends BaseGridPlugin {\n *   static readonly dependencies: PluginDependency[] = [\n *     { name: 'editing', required: true },\n *   ];\n * }\n * ```\n * @since 0.4.1\n */\nexport interface PluginDependency {\n  /**\n   * The name of the required plugin (matches the plugin's `name` property).\n   * Use string names for loose coupling - avoids static imports.\n   */\n  name: string;\n\n  /**\n   * Whether this dependency is required (hard) or optional (soft).\n   * - `true`: Plugin cannot function without it. Throws error if missing.\n   * - `false`: Plugin works with reduced functionality. Silent if missing\n   *   (set {@link severity} to `'warn'` or `'info'` to opt into a message).\n   * @default true\n   */\n  required?: boolean;\n\n  /**\n   * Explicit severity when this dependency is missing. Overrides the default\n   * derived from {@link required}.\n   * - `'error'`: throw (halts grid setup). Default when `required` is not `false`.\n   * - `'warn'`: log a console warning and continue (development only).\n   * - `'info'`: log a verbose console.debug message and continue (development only).\n   *\n   * When omitted, a missing hard dependency throws and a missing soft\n   * dependency is silent — preserving backward-compatible behavior.\n   * @since 2.16.0\n   */\n  severity?: 'error' | 'warn' | 'info';\n\n  /**\n   * Optional predicate that gates whether this dependency applies, evaluated\n   * against the depending plugin's own resolved configuration (defaults merged\n   * with user config). Return `false` to skip the dependency entirely.\n   *\n   * Lets a plugin require/recommend another plugin only under certain config\n   * — e.g. a plugin that needs a tool-panel host only when its tool panel is\n   * enabled. When omitted, the dependency always applies.\n   * @example when: (cfg: PivotConfig) => cfg.showToolPanel === true\n   * @since 2.16.0\n   */\n  when?: (pluginConfig: unknown) => boolean;\n\n  /**\n   * Human-readable reason for this dependency.\n   * Shown in error/info messages to help users understand why.\n   * @example \"UndoRedoPlugin needs EditingPlugin to track cell edits\"\n   */\n  reason?: string;\n}\n\n/**\n * Declares an incompatibility between plugins.\n * When both plugins are loaded, a warning is logged to help users understand the conflict.\n *\n * @category Plugin Development\n */\nexport interface PluginIncompatibility {\n  /**\n   * The name of the incompatible plugin (matches the plugin's `name` property).\n   */\n  name: string;\n\n  /**\n   * Human-readable reason for the incompatibility.\n   * Should explain why the plugins conflict and any workarounds.\n   * @example \"Both transform the entire row model in different ways\"\n   */\n  reason: string;\n}\n\n// ============================================================================\n// Plugin Query & Event Definitions\n// ============================================================================\n\n/**\n * Defines a query that a plugin can handle.\n * Other plugins or the grid can send this query type to retrieve data.\n *\n * @category Plugin Development\n *\n * @example\n * ```typescript\n * // In manifest\n * queries: [\n *   {\n *     type: 'canMoveColumn',\n *     description: 'Check if a column can be moved/reordered',\n *   },\n * ]\n *\n * // In plugin class\n * handleQuery(query: PluginQuery): unknown {\n *   if (query.type === 'canMoveColumn') {\n *     return this.canMoveColumn(query.context);\n *   }\n * }\n * ```\n * @since 1.8.0\n */\nexport interface QueryDefinition {\n  /**\n   * The query type identifier (e.g., 'canMoveColumn', 'getContextMenuItems').\n   * Should be unique across all plugins.\n   */\n  type: string;\n\n  /**\n   * Human-readable description of what the query does.\n   */\n  description?: string;\n}\n\n/**\n * Defines an event that a plugin can emit.\n * Other plugins can subscribe to these events via the Event Bus.\n *\n * @category Plugin Development\n *\n * @example\n * ```typescript\n * // In manifest\n * events: [\n *   {\n *     type: 'filter-change',\n *     description: 'Emitted when filter criteria change',\n *   },\n * ]\n *\n * // In plugin class - emit\n * this.emitPluginEvent('filter-change', { field: 'name', value: 'Alice' });\n *\n * // In another plugin - subscribe\n * this.on('filter-change', (detail) => console.log('Filter changed:', detail));\n * ```\n * @since 1.8.0\n */\nexport interface EventDefinition {\n  /**\n   * The event type identifier (e.g., 'filter-change', 'selection-change').\n   * Used when emitting and subscribing to events.\n   */\n  type: string;\n\n  /**\n   * Human-readable description of what the event represents.\n   */\n  description?: string;\n\n  /**\n   * Whether this event is cancelable via `event.preventDefault()`.\n   * @default false\n   */\n  cancelable?: boolean;\n}\n\n// ============================================================================\n// Plugin Manifest Types\n// ============================================================================\n\n/**\n * Defines a property that a plugin \"owns\" - used for configuration validation.\n * When this property is used without the owning plugin loaded, an error is thrown.\n *\n * @category Plugin Development\n */\nexport interface PluginPropertyDefinition {\n  /** The property name on column or grid config */\n  property: string;\n  /** Whether this is a column-level or config-level property */\n  level: 'column' | 'config';\n  /** Human-readable description for error messages (e.g., 'the \"editable\" column property') */\n  description: string;\n  /** Import path hint for error messages (e.g., \"import { EditingPlugin } from '@toolbox-web/grid/plugins/editing';\") */\n  importHint?: string;\n  /** Custom check for whether property is considered \"used\" (default: truthy value check) */\n  isUsed?: (value: unknown) => boolean;\n}\n\n/**\n * A configuration validation rule for detecting invalid/conflicting settings.\n * Plugins declare rules in their manifest; the validator executes them during grid initialization.\n *\n * @category Plugin Development\n * @template TConfig - The plugin's configuration type\n */\nexport interface PluginConfigRule<TConfig = unknown> {\n  /** Rule identifier for debugging (e.g., 'selection/range-dblclick') */\n  id: string;\n  /** Severity: 'error' throws, 'warn' logs warning */\n  severity: 'error' | 'warn';\n  /** Human-readable message shown when rule is violated */\n  message: string;\n  /** Predicate returning true if the rule is VIOLATED (i.e., config is invalid) */\n  check: (pluginConfig: TConfig) => boolean;\n}\n\n/**\n * Hook names that can have execution priority configured.\n *\n * @category Plugin Development\n */\nexport type HookName =\n  | 'processColumns'\n  | 'processConfig'\n  | 'processRows'\n  | 'afterStructuralRender'\n  | 'afterRender'\n  | 'afterCellRender'\n  | 'afterRowRender'\n  | 'onCellClick'\n  | 'onCellMouseDown'\n  | 'onCellMouseMove'\n  | 'onCellMouseUp'\n  | 'onHeaderClick'\n  | 'onKeyDown'\n  | 'onRowClick'\n  | 'onScroll'\n  | 'onScrollRender';\n\n/**\n * Static metadata about a plugin's capabilities and requirements.\n * Declared as a static property on plugin classes.\n *\n * @category Plugin Development\n * @template TConfig - The plugin's configuration type\n *\n * @example\n * ```typescript\n * export class MyPlugin extends BaseGridPlugin<MyConfig> {\n *   static override readonly manifest: PluginManifest<MyConfig> = {\n *     ownedProperties: [\n *       { property: 'myProp', level: 'column', description: 'the \"myProp\" column property' },\n *     ],\n *     configRules: [\n *       { id: 'my-plugin/invalid-combo', severity: 'warn', message: '...', check: (c) => c.a && c.b },\n *     ],\n *   };\n *   readonly name = 'myPlugin';\n * }\n * ```\n * @since 1.1.0\n */\nexport interface PluginManifest<TConfig = unknown> {\n  /**\n   * Properties this plugin owns - validated by validate-config.ts.\n   * If a user uses one of these properties without loading the plugin, an error is thrown.\n   */\n  ownedProperties?: PluginPropertyDefinition[];\n\n  /**\n   * Hook execution priority (higher = later, default 0).\n   * Use negative values to run earlier, positive to run later.\n   */\n  hookPriority?: Partial<Record<HookName, number>>;\n\n  /**\n   * Configuration validation rules - checked during grid initialization.\n   * Rules with severity 'error' throw, 'warn' logs to console.\n   */\n  configRules?: PluginConfigRule<TConfig>[];\n\n  /**\n   * Plugins that are incompatible with this plugin.\n   * When both plugins are loaded together, a warning is shown.\n   *\n   * @example\n   * ```typescript\n   * incompatibleWith: [\n   *   { name: 'tree', reason: 'Both transform the entire row model in different ways' },\n   * ],\n   * ```\n   */\n  incompatibleWith?: PluginIncompatibility[];\n\n  /**\n   * Queries this plugin can handle.\n   * Declares what query types this plugin responds to via `handleQuery()`.\n   * This replaces the centralized PLUGIN_QUERIES approach with manifest-declared queries.\n   *\n   * @example\n   * ```typescript\n   * queries: [\n   *   { type: 'canMoveColumn', description: 'Check if a column can be moved' },\n   * ],\n   * ```\n   */\n  queries?: QueryDefinition[];\n\n  /**\n   * Events this plugin can emit.\n   * Declares what event types other plugins can subscribe to via `on()`.\n   *\n   * @example\n   * ```typescript\n   * events: [\n   *   { type: 'filter-change', description: 'Emitted when filter criteria change' },\n   * ],\n   * ```\n   */\n  events?: EventDefinition[];\n\n  /**\n   * Whether this plugin's `processRows` hook injects or removes rows\n   * (group headers, tree nodes, pivot aggregates, placeholders, etc.).\n   *\n   * When true, the core sorting module delegates to the render scheduler\n   * instead of sorting `_rows` in-place, because `_rows` may contain\n   * plugin-generated marker objects that would be corrupted by a direct sort.\n   *\n   * Plugins that only **filter** or **reorder** existing rows (e.g. Filtering,\n   * MultiSort) should leave this unset or set it to `false`.\n   */\n  modifiesRowStructure?: boolean;\n}\n\n/** Convert camelCase icon key to kebab-case data-icon attribute value. */\nexport function toIconAttr(key: string): string {\n  return key.replace(/([A-Z])/g, '-$1').toLowerCase();\n}\n\n/**\n * Abstract base class for all grid plugins.\n *\n * @category Plugin Development\n * @template TConfig - Configuration type for the plugin\n * @since 0.1.1\n */\nexport abstract class BaseGridPlugin<TConfig = unknown> implements GridPlugin {\n  /**\n   * Plugin dependencies - declare other plugins this one requires.\n   *\n   * Dependencies are validated when the plugin is attached.\n   * Required dependencies throw an error if missing. Optional dependencies are\n   * silent by default; set a {@link PluginDependency.severity} of `'warn'` or\n   * `'info'` to opt into a development-only log.\n   *\n   * @example\n   * ```typescript\n   * static readonly dependencies: PluginDependency[] = [\n   *   { name: 'editing', required: true, reason: 'Tracks cell edits for undo/redo' },\n   *   { name: 'selection', required: false, reason: 'Enables selection-based undo' },\n   * ];\n   * ```\n   */\n  static readonly dependencies?: PluginDependency[];\n\n  /**\n   * Plugin manifest - declares owned properties, config rules, and hook priorities.\n   *\n   * This is read by the configuration validator to:\n   * - Validate that required plugins are loaded when their properties are used\n   * - Execute configRules to detect invalid/conflicting settings\n   * - Order hook execution based on priority\n   *\n   * @example\n   * ```typescript\n   * static override readonly manifest: PluginManifest<MyConfig> = {\n   *   ownedProperties: [\n   *     { property: 'myProp', level: 'column', description: 'the \"myProp\" column property' },\n   *   ],\n   *   configRules: [\n   *     { id: 'myPlugin/conflict', severity: 'warn', message: '...', check: (c) => c.a && c.b },\n   *   ],\n   * };\n   * ```\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static readonly manifest?: PluginManifest<any>;\n\n  /** Unique plugin identifier (derived from class name by default) */\n  abstract readonly name: string;\n\n  /**\n   * Alternative names for backward compatibility.\n   * `getPluginByName()` matches against both `name` and `aliases`.\n   * @internal\n   */\n  readonly aliases?: readonly string[];\n\n  /**\n   * Plugin version - defaults to grid version for built-in plugins.\n   * Third-party plugins can override with their own semver.\n   */\n  readonly version: string = typeof __GRID_VERSION__ !== 'undefined' ? __GRID_VERSION__ : 'dev';\n\n  /** CSS styles to inject via `document.adoptedStyleSheets` */\n  readonly styles?: string;\n\n  /** Custom cell renderers keyed by type name */\n  readonly cellRenderers?: Record<string, CellRenderer>;\n\n  /** Custom header renderers keyed by type name */\n  readonly headerRenderers?: Record<string, HeaderRenderer>;\n\n  /** Custom cell editors keyed by type name */\n  readonly cellEditors?: Record<string, CellEditor>;\n\n  /** The grid instance this plugin is attached to */\n  protected grid!: GridElement;\n\n  /** Plugin configuration - merged with defaults in attach() */\n  protected config!: TConfig;\n\n  /** User-provided configuration from constructor */\n  protected readonly userConfig: Partial<TConfig>;\n\n  /**\n   * Plugin-level AbortController for event listener cleanup.\n   * Created fresh in attach(), aborted in detach().\n   * This ensures event listeners are properly cleaned up when plugins are re-attached.\n   */\n  #abortController?: AbortController;\n\n  /**\n   * Default configuration - subclasses should override this getter.\n   * Note: This must be a getter (not property initializer) for proper inheritance\n   * since property initializers run after parent constructor.\n   */\n  protected get defaultConfig(): Partial<TConfig> {\n    return {};\n  }\n\n  constructor(config: Partial<TConfig> = {}) {\n    this.userConfig = config;\n  }\n\n  /**\n   * Effective configuration (defaults merged with user config), resolved\n   * eagerly so it is available **before** {@link attach} runs. Dependency\n   * validation happens before `attach()` merges {@link config}, so config\n   * -conditional dependency `when` predicates evaluate against this getter.\n   *\n   * While attached, returns the already-merged {@link config}; otherwise\n   * recomputes `defaultConfig` + `userConfig` fresh. `config` is intentionally\n   * **not** trusted when detached because {@link detach} does not clear it — a\n   * re-validated plugin would otherwise see stale config from a prior\n   * attachment. The {@link attach}-managed abort controller is the\n   * attached/detached signal.\n   * @internal Plugin infrastructure (used by `validatePluginDependencies`).\n   */\n  get resolvedConfig(): TConfig {\n    return (this.#abortController ? this.config : { ...this.defaultConfig, ...this.userConfig }) as TConfig;\n  }\n\n  /**\n   * Merge user-supplied configuration from other plugin instances into this\n   * plugin's `userConfig`. Used by `PluginManager.attachAll()`'s alias-collapse\n   * pre-pass: when a consumer instantiates the same plugin more than once (or\n   * under an alias name), only one instance is attached, and the other\n   * instances' configs are folded in via this method.\n   *\n   * Merge rules (shallow):\n   *\n   * - Same key, **same value** → silent.\n   * - Same key, **different values** (incl. function vs function) → throws\n   *   a diagnostic naming the conflicting key. Conflicting callbacks\n   *   (`canDrag`, `canDrop`, etc.) cannot be reconciled automatically.\n   * - **Disjoint keys** → merged cleanly.\n   *\n   * Subclasses may override to implement custom deep-merge logic, but should\n   * call `super.mergeConfigsFrom(others)` to inherit the conflict-detection.\n   *\n   * @internal Plugin infrastructure (used by `PluginManager.attachAll`).\n   * @throws Error with diagnostic code `TBW025` when configs conflict.\n   */\n  mergeConfigsFrom(others: readonly BaseGridPlugin<TConfig>[]): void {\n    if (others.length === 0) return;\n    const merged = { ...this.userConfig } as Record<string, unknown>;\n    const sources: Record<string, BaseGridPlugin<TConfig>> = {};\n    for (const key of Object.keys(merged)) sources[key] = this;\n    for (const other of others) {\n      const otherConfig = other.userConfig as Record<string, unknown>;\n      for (const [key, value] of Object.entries(otherConfig)) {\n        if (value === undefined) continue;\n        if (!(key in merged)) {\n          merged[key] = value;\n          sources[key] = other;\n          continue;\n        }\n        if (merged[key] === value) continue;\n        // Conflict\n        const ownerA = sources[key]?.constructor.name ?? this.constructor.name;\n        const ownerB = other.constructor.name;\n        const code = formatDiagnostic(\n          PLUGIN_ALIAS_CONFIG_CONFLICT,\n          `Cannot merge plugin configs for \"${this.name}\": conflicting value for \"${key}\" supplied by both ${ownerA} and ${ownerB}. Pass the option on a single instance, or remove the duplicate.`,\n          undefined,\n          this.name,\n        );\n        throw new Error(code);\n      }\n    }\n    // Mutate userConfig in place so re-attach picks it up via attach().\n    // `userConfig` is declared `readonly` to prevent reassigning the binding,\n    // but the object's own properties are intentionally mutable for this\n    // alias-collapse pre-pass. A single cast to a record is enough — no\n    // `as unknown as` double-cast needed.\n    Object.assign(this.userConfig as Record<string, unknown>, merged);\n  }\n\n  /**\n   * Replace this plugin's `userConfig` with a freshly-resolved sibling\n   * instance's config. Used by the grid's per-grid feature-instance gate\n   * (`#initializePlugins`): when a feature is re-resolved across a config\n   * change, the **existing** instance is reused — so its accumulated state\n   * survives — but it must adopt the latest `gridConfig.features.<name>`\n   * value. Unlike {@link mergeConfigsFrom}, this is last-write-wins with no\n   * conflict detection: the re-resolved instance is authoritative.\n   *\n   * `attach()` recomputes {@link config} from `userConfig`, so updating\n   * `userConfig` here is enough for the reused instance to pick up the new\n   * config on its next attach during the same `#initializePlugins` pass.\n   *\n   * @internal Plugin infrastructure (used by the grid feature gate).\n   */\n  refreshUserConfigFrom(other: BaseGridPlugin<TConfig>): void {\n    const target = this.userConfig as Record<string, unknown>;\n    // Snapshot the source BEFORE clearing `target`. A feature factory may\n    // store the consumer's config object by reference (e.g. `new\n    // ContextMenuPlugin(config)`), and a consumer that passes the *same* config\n    // object across re-resolutions (common when `gridConfig` is a recomputed\n    // Angular `computed()`) makes `this.userConfig === other.userConfig`.\n    // Without this snapshot, the `delete` loop below would empty that shared\n    // object first, then `Object.assign` would copy back nothing — silently\n    // wiping the config and falling back to plugin defaults. (#contextMenu)\n    const source = { ...(other.userConfig as Record<string, unknown>) };\n    for (const key of Object.keys(target)) delete target[key];\n    Object.assign(target, source);\n  }\n\n  /**\n   * Called when the plugin is attached to a grid.\n   * Override to set up event listeners, initialize state, etc.\n   *\n   * @example\n   * ```ts\n   * attach(grid: GridElement): void {\n   *   super.attach(grid);\n   *   // Set up document-level listeners with auto-cleanup\n   *   document.addEventListener('keydown', this.handleEscape, {\n   *     signal: this.disconnectSignal\n   *   });\n   * }\n   * ```\n   */\n  attach(grid: GridElement): void {\n    // Abort any previous abort controller (in case of re-attach without detach)\n    this.#abortController?.abort();\n    // Create fresh abort controller for this attachment\n    this.#abortController = new AbortController();\n\n    this.grid = grid;\n    // Merge config here (after subclass construction is complete)\n    this.config = { ...this.defaultConfig, ...this.userConfig } as TConfig;\n  }\n\n  /**\n   * Called when the plugin is detached from a grid.\n   * Override to clean up event listeners, timers, etc.\n   *\n   * @example\n   * ```ts\n   * detach(): void {\n   *   // Clean up any state not handled by disconnectSignal\n   *   this.selectedRows.clear();\n   *   this.cache = null;\n   * }\n   * ```\n   */\n  detach(): void {\n    // Abort the plugin's abort controller to clean up all event listeners\n    // registered with { signal: this.disconnectSignal }\n    this.#abortController?.abort();\n    this.#abortController = undefined;\n    // Override in subclass for additional cleanup\n  }\n\n  /**\n   * Called when another plugin is attached to the same grid.\n   * Use for inter-plugin coordination, e.g., to integrate with new plugins.\n   *\n   * @param name - The name of the plugin that was attached\n   * @param plugin - The plugin instance (for direct access if needed)\n   *\n   * @example\n   * ```ts\n   * onPluginAttached(name: string, plugin: BaseGridPlugin): void {\n   *   if (name === 'selection') {\n   *     // Integrate with selection plugin\n   *     this.selectionPlugin = plugin as SelectionPlugin;\n   *   }\n   * }\n   * ```\n   */\n  onPluginAttached?(name: string, plugin: BaseGridPlugin): void;\n\n  /**\n   * Called when another plugin is detached from the same grid.\n   * Use to clean up inter-plugin references.\n   *\n   * @param name - The name of the plugin that was detached\n   *\n   * @example\n   * ```ts\n   * onPluginDetached(name: string): void {\n   *   if (name === 'selection') {\n   *     this.selectionPlugin = undefined;\n   *   }\n   * }\n   * ```\n   */\n  onPluginDetached?(name: string): void;\n\n  /**\n   * Get another plugin instance from the same grid.\n   * Use for inter-plugin communication.\n   *\n   * **Prefer {@link BaseGridPlugin.grid grid.getPluginByName()}** when you don't need the class import.\n   *\n   * @example\n   * ```ts\n   * // Preferred: by name\n   * const selection = this.grid?.getPluginByName('selection');\n   *\n   * // Alternative: by class\n   * const selection = this.getPlugin(SelectionPlugin);\n   * if (selection) {\n   *   const selectedRows = selection.getSelectedRows();\n   * }\n   * ```\n   */\n  protected getPlugin<T extends BaseGridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined {\n    return this.grid?.getPlugin(PluginClass);\n  }\n\n  /**\n   * Emit a custom event from the grid.\n   */\n  protected emit<T>(eventName: string, detail: T): void {\n    this.grid?.dispatchEvent?.(new CustomEvent(eventName, { detail, bubbles: true }));\n  }\n\n  /**\n   * Emit a cancelable custom event from the grid.\n   * @returns `true` if the event was cancelled (preventDefault called), `false` otherwise\n   */\n  protected emitCancelable<T>(eventName: string, detail: T): boolean {\n    const event = new CustomEvent(eventName, { detail, bubbles: true, cancelable: true });\n    this.grid?.dispatchEvent?.(event);\n    return event.defaultPrevented;\n  }\n\n  // =========================================================================\n  // Event Bus - Plugin-to-Plugin Communication\n  // =========================================================================\n\n  /**\n   * Subscribe to an event from another plugin.\n   * The subscription is automatically cleaned up when this plugin is detached.\n   *\n   * @category Plugin Development\n   * @param eventType - The event type to listen for (e.g., 'filter-change')\n   * @param callback - The callback to invoke when the event is emitted\n   *\n   * @example\n   * ```typescript\n   * // In attach() or other initialization\n   * this.on('filter-change', (detail) => {\n   *   console.log('Filter changed:', detail);\n   * });\n   * ```\n   */\n  protected on<T = unknown>(eventType: string, callback: (detail: T) => void): void {\n    this.grid?._pluginManager?.subscribe(this, eventType, callback as (detail: unknown) => void);\n  }\n\n  /**\n   * Unsubscribe from a plugin event.\n   *\n   * @category Plugin Development\n   * @param eventType - The event type to stop listening for\n   *\n   * @example\n   * ```typescript\n   * this.off('filter-change');\n   * ```\n   */\n  protected off(eventType: string): void {\n    this.grid?._pluginManager?.unsubscribe(this, eventType);\n  }\n\n  /**\n   * Emit an event to other plugins via the Event Bus.\n   * This is for inter-plugin communication only; it does NOT dispatch DOM events.\n   * Use `emit()` to dispatch DOM events that external consumers can listen to.\n   *\n   * @category Plugin Development\n   * @param eventType - The event type to emit (should be declared in manifest.events)\n   * @param detail - The event payload\n   *\n   * @example\n   * ```typescript\n   * // Emit to other plugins (not DOM)\n   * this.emitPluginEvent('filter-change', { field: 'name', value: 'Alice' });\n   *\n   * // For DOM events that consumers can addEventListener to:\n   * this.emit('filter-change', { field: 'name', value: 'Alice' });\n   * ```\n   */\n  protected emitPluginEvent<T>(eventType: string, detail: T): void {\n    this.grid?._pluginManager?.emitPluginEvent(eventType, detail);\n  }\n\n  /**\n   * Emit an event to **both** the plugin Event Bus (for inter-plugin communication)\n   * **and** the DOM (for external consumers via `addEventListener`).\n   *\n   * Use this when a state change is relevant to both other plugins and external\n   * consumers. For example, `sort-change` needs to invalidate Selection (plugin bus)\n   * and notify the host application (DOM event).\n   *\n   * @category Plugin Development\n   * @param eventType - The event type to broadcast\n   * @param detail - The event payload\n   *\n   * @example\n   * ```typescript\n   * // Notify both plugins and consumers of a sort change\n   * this.broadcast('sort-change', { sortModel: [...this.sortModel] });\n   * ```\n   */\n  protected broadcast<T>(eventType: string, detail: T): void {\n    this.emitPluginEvent(eventType, detail);\n    this.emit(eventType, detail);\n  }\n\n  /**\n   * Run a yes/no plugin query and reduce the responses to a single boolean.\n   *\n   * `grid.query()` always returns an **array** of responses (empty when no\n   * plugin handles the query), and `[]` is truthy in JavaScript — so testing\n   * the raw result directly (`if (grid.query(...))`) is always `true` and\n   * silently takes the \"some plugin said yes\" branch even when nothing\n   * answered. Always route boolean queries through this helper.\n   *\n   * @category Plugin Development\n   * @param type - The query type to dispatch\n   * @param context - Optional query context passed to the handlers\n   * @returns `true` only when at least one plugin answered truthily\n   *\n   * @example\n   * ```typescript\n   * if (this.queryBoolean('datasource:is-active')) {\n   *   // A ServerSide data source really is installed\n   * }\n   * ```\n   * @since 3.4.0\n   */\n  protected queryBoolean(type: string, context: unknown = null): boolean {\n    const responses = this.grid?.query?.(type, context);\n    // Tolerate hosts/tests that hand back a bare value instead of the array.\n    return Array.isArray(responses) ? responses.some(Boolean) : !!responses;\n  }\n\n  /**\n   * Request a re-render of the grid.\n   * Uses ROWS phase - does NOT trigger processColumns hooks.\n   */\n  protected requestRender(): void {\n    this.grid?.requestRender?.();\n  }\n\n  /**\n   * Request a columns re-render of the grid.\n   * Uses COLUMNS phase - triggers processColumns hooks.\n   * Use this when your plugin needs to reprocess column configuration.\n   */\n  protected requestColumnsRender(): void {\n    (this.grid as { requestColumnsRender?: () => void })?.requestColumnsRender?.();\n  }\n\n  /**\n   * Request a re-render and restore focus styling afterward.\n   * Use this when a plugin action (like expand/collapse) triggers a render\n   * but needs to maintain keyboard navigation focus.\n   */\n  protected requestRenderWithFocus(): void {\n    this.grid?.requestRenderWithFocus?.();\n  }\n\n  /**\n   * Request a lightweight style update without rebuilding DOM.\n   * Use this instead of requestRender() when only CSS classes need updating.\n   */\n  protected requestAfterRender(): void {\n    this.grid?.requestAfterRender?.();\n  }\n\n  /**\n   * Re-render visible rows without rebuilding the row model or recalculating geometry.\n   * Use this when row data has been updated in-place (e.g., server-side block loads)\n   * and only the visible viewport needs to re-render.\n   */\n  protected requestVirtualRefresh(): void {\n    this.grid?.requestVirtualRefresh?.();\n  }\n\n  /**\n   * Get the current rows from the grid.\n   */\n  protected get rows(): any[] {\n    return this.grid?.rows ?? [];\n  }\n\n  /**\n   * Get the original unfiltered/unprocessed rows from the grid.\n   * Use this when you need all source data regardless of active filters.\n   */\n  protected get sourceRows(): any[] {\n    return this.grid?.sourceRows ?? [];\n  }\n\n  /**\n   * Get the current columns from the grid.\n   */\n  protected get columns(): ColumnConfig[] {\n    return this.grid?.columns ?? [];\n  }\n\n  /**\n   * Get only visible columns from the grid (excludes hidden).\n   * Use this for rendering that needs to match the grid template.\n   */\n  protected get visibleColumns(): ColumnConfig[] {\n    return this.grid?._visibleColumns ?? [];\n  }\n\n  /**\n   * Get the grid as an HTMLElement for direct DOM operations.\n   * Use sparingly - prefer the typed GridElementRef API when possible.\n   *\n   * @example\n   * ```ts\n   * const width = this.gridElement.clientWidth;\n   * this.gridElement.classList.add('my-plugin-active');\n   * ```\n   */\n  protected get gridElement(): HTMLElement {\n    return this.grid?._hostElement;\n  }\n\n  /**\n   * Get the disconnect signal for event listener cleanup.\n   * This signal is aborted when the grid disconnects from the DOM.\n   * Use this when adding event listeners that should be cleaned up automatically.\n   *\n   * Best for:\n   * - Document/window-level listeners added in attach()\n   * - Listeners on the grid element itself\n   * - Any listener that should persist across renders\n   *\n   * Not needed for:\n   * - Listeners on elements created in afterRender() (removed with element)\n   *\n   * @example\n   * element.addEventListener('click', handler, { signal: this.disconnectSignal });\n   * document.addEventListener('keydown', handler, { signal: this.disconnectSignal });\n   */\n  protected get disconnectSignal(): AbortSignal {\n    // Return the plugin's own abort signal for proper cleanup on detach/re-attach\n    // Falls back to grid's signal if plugin's controller not yet created\n    return this.#abortController?.signal ?? this.grid?.disconnectSignal;\n  }\n\n  /**\n   * Get the grid-level icons configuration.\n   * Returns merged icons (user config + defaults).\n   */\n  protected get gridIcons(): Required<GridIcons> {\n    const userIcons = this.grid?.gridConfig?.icons ?? {};\n    return { ...DEFAULT_GRID_ICONS, ...userIcons };\n  }\n\n  /**\n   * Resolve a user-visible string from {@link GridConfig.locale}, falling back to\n   * the English default supplied at the call site.\n   *\n   * The fallback is passed inline rather than read from a shipped default map so\n   * that a plugin's strings live in the plugin's own chunk.\n   *\n   * @param key - Namespaced message id, e.g. `'filter.apply'`.\n   * @param fallback - English text used when the key is not overridden.\n   * @since 3.5.0\n   *\n   * @example\n   * ```ts\n   * applyBtn.textContent = this.t('filter.apply', 'Apply');\n   * ```\n   */\n  protected t(key: string, fallback: string): string {\n    return this.grid?.effectiveConfig?.locale?.[key] ?? fallback;\n  }\n\n  /**\n   * A bound `t()` suitable for handing to standalone renderer\n   * helpers and public renderer callbacks.\n   * @since 3.5.0\n   */\n  protected get translate(): Translate {\n    return (key, fallback) => this.t(key, fallback);\n  }\n\n  // #region Animation Helpers\n\n  /**\n   * Check if animations are enabled at the grid level.\n   * Respects gridConfig.animation.mode and the CSS variable set by the grid.\n   *\n   * Plugins should use this to skip animations when:\n   * - Animation mode is 'off' or `false`\n   * - User prefers reduced motion and mode is 'reduced-motion' (default)\n   *\n   * @example\n   * ```ts\n   * private get animationStyle(): 'slide' | 'fade' | false {\n   *   if (!this.isAnimationEnabled) return false;\n   *   return this.config.animation ?? 'slide';\n   * }\n   * ```\n   */\n  protected get isAnimationEnabled(): boolean {\n    const mode = this.grid?.effectiveConfig?.animation?.mode ?? 'reduced-motion';\n\n    // Explicit off = disabled\n    if (mode === false || mode === 'off') return false;\n\n    // Explicit on = always enabled\n    if (mode === true || mode === 'on') return true;\n\n    // reduced-motion: check CSS variable (set by grid based on media query)\n    const host = this.gridElement;\n    if (host) {\n      const enabled = getComputedStyle(host).getPropertyValue('--tbw-animation-enabled').trim();\n      return enabled !== '0';\n    }\n\n    return true; // Default to enabled\n  }\n\n  /**\n   * Get the animation duration in milliseconds from CSS variable.\n   * Falls back to 200ms if not set.\n   *\n   * Plugins can use this for their animation timing to stay consistent\n   * with the grid-level animation.duration setting.\n   *\n   * @example\n   * ```ts\n   * element.animate(keyframes, { duration: this.animationDuration });\n   * ```\n   */\n  protected get animationDuration(): number {\n    const host = this.gridElement;\n    if (host) {\n      const durationStr = getComputedStyle(host).getPropertyValue('--tbw-animation-duration').trim();\n      const parsed = parseInt(durationStr, 10);\n      if (!isNaN(parsed)) return parsed;\n    }\n    return 200; // Default\n  }\n\n  // #endregion\n\n  /**\n   * Set an icon on an element using the CSS-first hybrid approach.\n   *\n   * Sets `data-icon` for CSS pseudo-element rendering and `data-expanded` for\n   * expand/collapse toggle elements. Only injects DOM content when a JS override\n   * is present (via `gridConfig.icons` or `pluginOverride`), which naturally\n   * suppresses the CSS `::before` via the `:empty` selector.\n   *\n   * @param element - The element to set the icon on\n   * @param iconKey - The icon key in GridIcons (e.g., 'expand', 'collapse')\n   * @param pluginOverride - Optional plugin-level override (string or HTMLElement)\n   */\n  protected setIcon(element: HTMLElement, iconKey: keyof GridIcons, pluginOverride?: IconValue): void {\n    // Set data-icon attribute for CSS targeting (always)\n    element.dataset.icon = toIconAttr(iconKey);\n\n    // Set data-expanded for toggle elements (tree, group, master-detail)\n    if (iconKey === 'collapse') {\n      element.dataset.expanded = '';\n    } else if (iconKey === 'expand') {\n      delete element.dataset.expanded;\n    }\n\n    // Resolve JS-only icon (returns undefined when CSS default should be used)\n    const jsIcon = this.#resolveJsIcon(iconKey, pluginOverride);\n\n    if (jsIcon !== undefined) {\n      // JS override: inject content (suppresses CSS ::before via :empty)\n      if (typeof jsIcon === 'string') {\n        setSanitizedHTML(element, jsIcon);\n      } else if (jsIcon instanceof HTMLElement) {\n        element.replaceChildren(jsIcon.cloneNode(true));\n      }\n    } else {\n      // CSS path: ensure element is empty so ::before renders\n      element.innerHTML = '';\n    }\n  }\n\n  /**\n   * Resolve JS-only icon override. Returns undefined if CSS default should render.\n   * Only returns a value when the user explicitly set gridConfig.icons[key] or\n   * the plugin passed an override.\n   */\n  #resolveJsIcon(iconKey: keyof GridIcons, pluginOverride?: IconValue): IconValue | undefined {\n    if (pluginOverride !== undefined) return pluginOverride;\n    return this.grid?.gridConfig?.icons?.[iconKey];\n  }\n\n  /**\n   * Create or replace a sort indicator on a header cell.\n   *\n   * Handles the full lifecycle: removes any existing indicator, creates a new\n   * `<span part=\"sort-indicator\" class=\"sort-indicator\">` with the appropriate\n   * icon, sets `aria-sort` / `data-sort` attributes, and inserts it before the\n   * filter button or resize handle.\n   *\n   * Plugins decide **which** cells and **when** — this method handles **how**.\n   *\n   * @param cell - The header cell element\n   * @param direction - `'asc'` | `'desc'` for sorted, `null` for unsorted idle state\n   * @returns The created indicator element (useful for appending badges, etc.)\n   */\n  protected updateSortIndicator(cell: Element, direction: 'asc' | 'desc' | null): HTMLElement {\n    // Remove any existing indicator (core uses part, plugins use class)\n    cell.querySelector('[part~=\"sort-indicator\"], .sort-indicator')?.remove();\n\n    const indicator = document.createElement('span');\n    indicator.setAttribute('part', 'sort-indicator');\n    indicator.className = 'sort-indicator';\n\n    if (direction) {\n      cell.setAttribute('aria-sort', direction === 'asc' ? 'ascending' : 'descending');\n      cell.setAttribute('data-sort', direction);\n      this.setIcon(indicator, direction === 'asc' ? 'sortAsc' : 'sortDesc');\n    } else {\n      cell.setAttribute('aria-sort', 'none');\n      cell.removeAttribute('data-sort');\n      this.setIcon(indicator, 'sortNone');\n    }\n\n    // Insert before filter button or resize handle to maintain DOM order\n    const insertBefore = cell.querySelector('.tbw-filter-btn') ?? cell.querySelector('.resize-handle');\n    if (insertBefore) {\n      cell.insertBefore(indicator, insertBefore);\n    } else {\n      cell.appendChild(indicator);\n    }\n\n    return indicator;\n  }\n\n  /**\n   * Log a warning with an optional diagnostic code.\n   *\n   * When a diagnostic code is provided, the message is formatted with the code\n   * and a link to the troubleshooting docs.\n   *\n   * @example\n   * ```ts\n   * this.warn('Something went wrong');                          // plain\n   * this.warn(MISSING_BREAKPOINT, 'Set a breakpoint'); // with code + docs link\n   * ```\n   */\n  protected warn(message: string): void;\n  protected warn(code: DiagnosticCode, message: string): void;\n  protected warn(codeOrMessage: DiagnosticCode | string, message?: string): void {\n    if (message !== undefined) {\n      // Called with (code, message)\n      console.warn(formatDiagnostic(codeOrMessage as DiagnosticCode, message, this.gridElement.id, this.name));\n    } else {\n      // Called with (message) — plain warning, no diagnostic code\n      console.warn(`${gridPrefix(this.gridElement.id, this.name)} ${codeOrMessage}`);\n    }\n  }\n\n  /**\n   * Throw an error with a diagnostic code and docs link.\n   * Use for configuration errors and API misuse that should halt execution.\n   */\n  protected throwDiagnostic(code: DiagnosticCode, message: string): never {\n    throw new Error(formatDiagnostic(code, message, this.gridElement.id, this.name));\n  }\n\n  // #region Lifecycle Hooks\n\n  /**\n   * Transform rows before rendering.\n   * Called during each render cycle before rows are rendered to the DOM.\n   * Use this to filter, sort, or add computed properties to rows.\n   *\n   * @param rows - The current rows array (readonly to encourage returning a new array)\n   * @returns The modified rows array to render\n   *\n   * @example\n   * ```ts\n   * processRows(rows: readonly any[]): any[] {\n   *   // Filter out hidden rows\n   *   return rows.filter(row => !row._hidden);\n   * }\n   * ```\n   *\n   * @example\n   * ```ts\n   * processRows(rows: readonly any[]): any[] {\n   *   // Add computed properties\n   *   return rows.map(row => ({\n   *     ...row,\n   *     _fullName: `${row.firstName} ${row.lastName}`\n   *   }));\n   * }\n   * ```\n   */\n  processRows?(rows: readonly any[]): any[];\n\n  /**\n   * Contribute to the grid's effective configuration during each config merge.\n   * Called by {@link ConfigManager.merge} after the base config is assembled,\n   * before it becomes `effectiveConfig`. Mutate `config` in place to inject\n   * plugin-derived settings (e.g. the shell plugin folds its light-DOM /\n   * API-registered state into `config.shell`).\n   *\n   * This is the config-pipeline counterpart to {@link processColumns} /\n   * {@link processRows}: it keeps the core config merge free of any plugin\n   * knowledge — each plugin owns the shape it contributes.\n   *\n   * @param config - The mutable base config being assembled into effectiveConfig.\n   *\n   * @example\n   * ```ts\n   * processConfig(config: GridConfig): void {\n   *   config.shell = { ...config.shell, header: { title: this.#title } };\n   * }\n   * ```\n   */\n  processConfig?(config: GridConfig): void;\n\n  /**\n   * Transform columns before rendering.\n   * Called during each render cycle before column headers and cells are rendered.\n   * Use this to add, remove, or modify column definitions.\n   *\n   * @param columns - The current columns array (readonly to encourage returning a new array)\n   * @returns The modified columns array to render\n   *\n   * @example\n   * ```ts\n   * processColumns(columns: readonly ColumnConfig[]): ColumnConfig[] {\n   *   // Add a selection checkbox column\n   *   return [\n   *     { field: '_select', header: '', width: 40 },\n   *     ...columns\n   *   ];\n   * }\n   * ```\n   */\n  processColumns?(columns: readonly ColumnConfig[]): ColumnConfig[];\n\n  /**\n   * Called before each render cycle begins.\n   * Use this to prepare state or cache values needed during rendering.\n   *\n   * **Note:** This hook is currently a placeholder for future implementation.\n   * It is defined in the interface but not yet invoked by the grid's render pipeline.\n   * If you need this functionality, please open an issue or contribute an implementation.\n   *\n   * @example\n   * ```ts\n   * beforeRender(): void {\n   *   this.visibleRowCount = this.calculateVisibleRows();\n   * }\n   * ```\n   */\n  beforeRender?(): void;\n\n  /**\n   * Called after each render cycle completes.\n   * Use this for DOM manipulation, adding event listeners to rendered elements,\n   * or applying visual effects like selection highlights.\n   *\n   * @example\n   * ```ts\n   * afterRender(): void {\n   *   // Apply selection styling to rendered rows\n   *   const rows = this.gridElement?.querySelectorAll('.data-grid-row');\n   *   rows?.forEach((row, i) => {\n   *     row.classList.toggle('selected', this.selectedRows.has(i));\n   *   });\n   * }\n   * ```\n   */\n  afterRender?(): void;\n\n  /**\n   * Called synchronously immediately after the grid (re)builds its root DOM\n   * structure, before the browser has a chance to paint.\n   *\n   * Unlike {@link afterRender} (which runs in the scheduler's STYLE phase and\n   * may be deferred), this hook fires inside the same task as the structural\n   * DOM build. It is the correct place for plugins that need to wrap, relocate,\n   * or augment the freshly built grid DOM without a flash of unstyled/unwrapped\n   * content — e.g. a shell that moves the grid content into a chrome wrapper.\n   *\n   * The grid emits this hook every time it performs a full structural rebuild\n   * (initial connect and structural changes), but NOT on the scroll/data hot\n   * path. Implementations MUST be idempotent: a full rebuild discards any DOM a\n   * previous invocation produced, so re-create it, and no-op when the desired\n   * structure is already present.\n   *\n   * @example\n   * ```ts\n   * afterStructuralRender(): void {\n   *   const root = this.grid?._renderRoot;\n   *   if (!root || root.querySelector('.my-wrapper > .tbw-grid-content')) return;\n   *   // build wrapper, move .tbw-grid-content inside it\n   * }\n   * ```\n   */\n  afterStructuralRender?(): void;\n\n  /**\n   * Called synchronously by the grid immediately before it tears down and\n   * rebuilds its root DOM structure (a structural re-render). Plugins that\n   * relocated existing light-DOM nodes into their own chrome (e.g. a shell that\n   * moves toolbar buttons into the header bar) use this to move those nodes back\n   * to their original container so they survive the rebuild. Generic\n   * counterpart to {@link afterStructuralRender}. MUST be idempotent.\n   */\n  beforeStructuralRender?(): void;\n\n  /**\n   * Called by the grid after a config merge to ask whether the change requires a\n   * full structural re-render (rather than a cheaper in-place update). A plugin\n   * returns `true` when its rendered DOM signature no longer matches the new\n   * effective config — e.g. a shell header appearing/disappearing or a tool\n   * panel's count/position/mode changing. The grid performs a structural\n   * re-render if ANY plugin returns `true`. MUST be side-effect free.\n   */\n  needsStructuralRerender?(): boolean;\n\n  /**\n   * Called by the grid to let a plugin (re-)parse its own light-DOM\n   * contributions into plugin state ahead of a config merge. Generic seam that\n   * keeps core free of plugin-specific light-DOM tag knowledge (the plugin reads\n   * `this.grid._hostElement`). MUST be idempotent.\n   */\n  parseLightDom?(): void;\n\n  /**\n   * Called by the grid (from `refreshColumns` and the light-DOM observer) to\n   * let a plugin re-parse its light-DOM contributions AND refresh any\n   * already-rendered chrome in place when something changed — e.g. a shell\n   * title or tool buttons that a framework projected asynchronously after the\n   * initial render. Distinct from {@link parseLightDom}, which only updates\n   * plugin state. Generic seam — core holds no plugin-specific knowledge. MUST\n   * be idempotent and a no-op when the plugin's chrome is not yet rendered.\n   */\n  syncLightDom?(): void;\n\n  /**\n   * Called after each cell is rendered.\n   * This hook is more efficient than `afterRender()` for cell-level modifications\n   * because you receive the cell context directly - no DOM queries needed.\n   *\n   * Use cases:\n   * - Adding selection/highlight classes to specific cells\n   * - Injecting badges or decorations\n   * - Applying conditional styling based on cell value\n   *\n   * Performance note: Called for every visible cell during render. Keep implementation fast.\n   * This hook is also called during scroll when cells are recycled.\n   *\n   * @param context - The cell render context with row, column, value, and elements\n   *\n   * @example\n   * ```ts\n   * afterCellRender(context: AfterCellRenderContext): void {\n   *   // Add selection class without DOM queries\n   *   if (this.isSelected(context.rowIndex, context.colIndex)) {\n   *     context.cellElement.classList.add('selected');\n   *   }\n   *\n   *   // Add validation error styling\n   *   if (this.hasError(context.row, context.column.field)) {\n   *     context.cellElement.classList.add('has-error');\n   *   }\n   * }\n   * ```\n   */\n  afterCellRender?(context: AfterCellRenderContext): void;\n\n  /**\n   * Called after a row is fully rendered (all cells complete).\n   * Use this for row-level decorations, styling, or ARIA attributes.\n   *\n   * Common use cases:\n   * - Adding selection classes to entire rows (row-focus, selected)\n   * - Setting row-level ARIA attributes\n   * - Applying row validation highlighting\n   * - Tree indentation styling\n   *\n   * Performance note: Called for every visible row during render. Keep implementation fast.\n   * This hook is also called during scroll when rows are recycled.\n   *\n   * @param context - The row render context with row data and element\n   *\n   * @example\n   * ```ts\n   * afterRowRender(context: AfterRowRenderContext): void {\n   *   // Add row selection class without DOM queries\n   *   if (this.isRowSelected(context.rowIndex)) {\n   *     context.rowElement.classList.add('selected', 'row-focus');\n   *   }\n   *\n   *   // Add validation error styling\n   *   if (this.rowHasErrors(context.row)) {\n   *     context.rowElement.classList.add('has-errors');\n   *   }\n   * }\n   * ```\n   */\n  afterRowRender?(context: AfterRowRenderContext): void;\n\n  /**\n   * Called after scroll-triggered row rendering completes.\n   * This is a lightweight hook for applying visual state to recycled DOM elements.\n   * Use this instead of afterRender when you need to reapply styling during scroll.\n   *\n   * Performance note: This is called frequently during scroll. Keep implementation fast.\n   *\n   * @example\n   * ```ts\n   * onScrollRender(): void {\n   *   // Reapply selection state to visible cells\n   *   this.applySelectionToVisibleCells();\n   * }\n   * ```\n   */\n  onScrollRender?(): void;\n\n  /**\n   * Get the height of a specific row.\n   * Used for synthetic rows (group headers, detail panels, etc.) that have fixed heights.\n   * Return undefined if this plugin does not manage the height for this row.\n   *\n   * This hook is called during position cache rebuilds for variable row height virtualization.\n   * Plugins that create synthetic rows should implement this to provide accurate heights.\n   *\n   * @param row - The row data\n   * @param index - The row index in the processed rows array\n   * @returns The row height in pixels, or undefined if not managed by this plugin\n   */\n  getRowHeight?(row: unknown, index: number): number | undefined;\n\n  /**\n   * Adjust the virtualization start index to render additional rows before the visible range.\n   * Use this when expanded content (like detail rows) needs its parent row to remain rendered\n   * even when the parent row itself has scrolled above the viewport.\n   *\n   * @param start - The calculated start row index\n   * @param scrollTop - The current scroll position\n   * @param rowHeight - The height of a single row\n   * @returns The adjusted start index (lower than or equal to original start)\n   *\n   * @example\n   * ```ts\n   * adjustVirtualStart(start: number, scrollTop: number, rowHeight: number): number {\n   *   // If row 5 is expanded and scrolled partially, keep it rendered\n   *   for (const expandedRowIndex of this.expandedRowIndices) {\n   *     const expandedRowTop = expandedRowIndex * rowHeight;\n   *     const expandedRowBottom = expandedRowTop + rowHeight + this.detailHeight;\n   *     if (expandedRowBottom > scrollTop && expandedRowIndex < start) {\n   *       return expandedRowIndex;\n   *     }\n   *   }\n   *   return start;\n   * }\n   * ```\n   */\n  adjustVirtualStart?(start: number, scrollTop: number, rowHeight: number): number;\n\n  /**\n   * Render a custom row, bypassing the default row rendering.\n   * Use this for special row types like group headers, detail rows, or footers.\n   *\n   * @param row - The row data object\n   * @param rowEl - The row DOM element to render into\n   * @param rowIndex - The index of the row in the data array\n   * @returns `true` if the plugin handled rendering (prevents default), `false`/`void` for default rendering\n   *\n   * @example\n   * ```ts\n   * renderRow(row: any, rowEl: HTMLElement, rowIndex: number): boolean | void {\n   *   if (row._isGroupHeader) {\n   *     rowEl.innerHTML = `<div class=\"group-header\">${row._groupLabel}</div>`;\n   *     return true; // Handled - skip default rendering\n   *   }\n   *   // Return void to let default rendering proceed\n   * }\n   * ```\n   */\n  renderRow?(row: any, rowEl: HTMLElement, rowIndex: number): boolean | void;\n\n  // #endregion\n\n  // #region Inter-Plugin Communication\n\n  /**\n   * Handle queries from other plugins or the grid.\n   *\n   * Queries are declared in `manifest.queries` and dispatched via `grid.query()`.\n   * This enables type-safe, discoverable inter-plugin communication.\n   *\n   * @category Plugin Development\n   * @param query - The query object with type and context\n   * @returns Query-specific response, or undefined if not handling this query\n   *\n   * @example\n   * ```ts\n   * // In manifest\n   * static override readonly manifest: PluginManifest = {\n   *   queries: [\n   *     { type: 'canMoveColumn', description: 'Check if a column can be moved' },\n   *   ],\n   * };\n   *\n   * // In plugin class\n   * handleQuery(query: PluginQuery): unknown {\n   *   if (query.type === 'canMoveColumn') {\n   *     const column = query.context as ColumnConfig;\n   *     return !column.sticky; // Can't move sticky columns\n   *   }\n   * }\n   * ```\n   */\n  handleQuery?(query: PluginQuery): unknown;\n\n  // #endregion\n\n  // #region Interaction Hooks\n\n  /**\n   * Handle keyboard events on the grid.\n   * Called when a key is pressed while the grid or a cell has focus.\n   *\n   * @param event - The native KeyboardEvent\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\n   *\n   * @example\n   * ```ts\n   * onKeyDown(event: KeyboardEvent): boolean | void {\n   *   // Handle Ctrl+A for select all\n   *   if (event.ctrlKey && event.key === 'a') {\n   *     this.selectAllRows();\n   *     return true; // Prevent default browser select-all\n   *   }\n   * }\n   * ```\n   */\n  onKeyDown?(event: KeyboardEvent): boolean | void;\n\n  /**\n   * Handle cell click events.\n   * Called when a data cell is clicked (not headers).\n   *\n   * @param event - Cell click event with row/column context\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\n   *\n   * @example\n   * ```ts\n   * onCellClick(event: CellClickEvent): boolean | void {\n   *   if (event.field === '_select') {\n   *     this.toggleRowSelection(event.rowIndex);\n   *     return true; // Handled\n   *   }\n   * }\n   * ```\n   */\n  onCellClick?(event: CellClickEvent): boolean | void;\n\n  /**\n   * Handle row click events.\n   * Called when any part of a data row is clicked.\n   * Note: This is called in addition to onCellClick, not instead of.\n   *\n   * @param event - Row click event with row context\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\n   *\n   * @example\n   * ```ts\n   * onRowClick(event: RowClickEvent): boolean | void {\n   *   if (this.config.mode === 'row') {\n   *     this.selectRow(event.rowIndex, event.originalEvent);\n   *     return true;\n   *   }\n   * }\n   * ```\n   */\n  onRowClick?(event: RowClickEvent): boolean | void;\n\n  /**\n   * Handle header click events.\n   * Called when a column header is clicked. Commonly used for sorting.\n   *\n   * @param event - Header click event with column context\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\n   *\n   * @example\n   * ```ts\n   * onHeaderClick(event: HeaderClickEvent): boolean | void {\n   *   if (event.column.sortable !== false) {\n   *     this.toggleSort(event.field);\n   *     return true;\n   *   }\n   * }\n   * ```\n   */\n  onHeaderClick?(event: HeaderClickEvent): boolean | void;\n\n  /**\n   * Handle scroll events on the grid viewport.\n   * Called during scrolling. Note: This may be called frequently; debounce if needed.\n   *\n   * @param event - Scroll event with scroll position and viewport dimensions\n   *\n   * @example\n   * ```ts\n   * onScroll(event: ScrollEvent): void {\n   *   // Update sticky column positions\n   *   this.updateStickyPositions(event.scrollLeft);\n   * }\n   * ```\n   */\n  onScroll?(event: ScrollEvent): void;\n\n  /**\n   * Handle cell mousedown events.\n   * Used for initiating drag operations like range selection or column resize.\n   *\n   * @param event - Mouse event with cell context\n   * @returns `true` to indicate drag started (prevents text selection), `false`/`void` otherwise\n   *\n   * @example\n   * ```ts\n   * onCellMouseDown(event: CellMouseEvent): boolean | void {\n   *   if (event.rowIndex !== undefined && this.config.mode === 'range') {\n   *     this.startDragSelection(event.rowIndex, event.colIndex);\n   *     return true; // Prevent text selection\n   *   }\n   * }\n   * ```\n   */\n  onCellMouseDown?(event: CellMouseEvent): boolean | void;\n\n  /**\n   * Handle cell mousemove events during drag operations.\n   * Only called when a drag is in progress (after mousedown returned true).\n   *\n   * @param event - Mouse event with current cell context\n   * @returns `true` to continue handling the drag, `false`/`void` otherwise\n   *\n   * @example\n   * ```ts\n   * onCellMouseMove(event: CellMouseEvent): boolean | void {\n   *   if (this.isDragging && event.rowIndex !== undefined) {\n   *     this.extendSelection(event.rowIndex, event.colIndex);\n   *     return true;\n   *   }\n   * }\n   * ```\n   */\n  onCellMouseMove?(event: CellMouseEvent): boolean | void;\n\n  /**\n   * Handle cell mouseup events to end drag operations.\n   *\n   * @param event - Mouse event with final cell context\n   * @returns `true` if drag was finalized, `false`/`void` otherwise\n   *\n   * @example\n   * ```ts\n   * onCellMouseUp(event: CellMouseEvent): boolean | void {\n   *   if (this.isDragging) {\n   *     this.finalizeDragSelection();\n   *     this.isDragging = false;\n   *     return true;\n   *   }\n   * }\n   * ```\n   */\n  onCellMouseUp?(event: CellMouseEvent): boolean | void;\n\n  // Note: Context menu items are provided via handleQuery('getContextMenuItems').\n  // This keeps the core decoupled from the context-menu plugin specifics.\n\n  // #endregion\n\n  // #region Column State Hooks\n\n  /**\n   * Contribute plugin-specific state for a column.\n   * Called by the grid when collecting column state for serialization.\n   * Plugins can add their own properties to the column state.\n   *\n   * @param field - The field name of the column\n   * @returns Partial column state with plugin-specific properties, or undefined if no state to contribute\n   *\n   * @example\n   * ```ts\n   * getColumnState(field: string): Partial<ColumnState> | undefined {\n   *   const filterModel = this.filterModels.get(field);\n   *   if (filterModel) {\n   *     // Uses module augmentation to add filter property to ColumnState\n   *     return { filter: filterModel } as Partial<ColumnState>;\n   *   }\n   *   return undefined;\n   * }\n   * ```\n   */\n  getColumnState?(field: string): Partial<ColumnState> | undefined;\n\n  /**\n   * Apply plugin-specific state to a column.\n   * Called by the grid when restoring column state from serialized data.\n   * Plugins should restore their internal state based on the provided state.\n   *\n   * @param field - The field name of the column\n   * @param state - The column state to apply (may contain plugin-specific properties)\n   *\n   * @example\n   * ```ts\n   * applyColumnState(field: string, state: ColumnState): void {\n   *   // Check for filter property added via module augmentation\n   *   const filter = (state as any).filter;\n   *   if (filter) {\n   *     this.filterModels.set(field, filter);\n   *     this.applyFilter();\n   *   }\n   * }\n   * ```\n   */\n  applyColumnState?(field: string, state: ColumnState): void;\n\n  // #endregion\n\n  // #region Scroll Boundary Hooks\n\n  /**\n   * Report horizontal scroll boundary offsets for this plugin.\n   * Plugins that obscure part of the scroll area (e.g., pinned/sticky columns)\n   * should return how much space they occupy on each side.\n   * The keyboard navigation uses this to ensure focused cells are fully visible.\n   *\n   * @param rowEl - The row element (optional, for calculating widths from rendered cells)\n   * @param focusedCell - The currently focused cell element (optional, to determine if scrolling should be skipped)\n   * @returns Object with left/right pixel offsets and optional skipScroll flag, or undefined if plugin has no offsets\n   *\n   * @example\n   * ```ts\n   * getHorizontalScrollOffsets(rowEl?: HTMLElement, focusedCell?: HTMLElement): { left: number; right: number; skipScroll?: boolean } | undefined {\n   *   // Calculate total width of left-pinned columns\n   *   const leftCells = rowEl?.querySelectorAll('.sticky-left') ?? [];\n   *   let left = 0;\n   *   leftCells.forEach(el => { left += (el as HTMLElement).offsetWidth; });\n   *   // Skip scroll if focused cell is pinned (always visible)\n   *   const skipScroll = focusedCell?.classList.contains('sticky-left');\n   *   return { left, right: 0, skipScroll };\n   * }\n   * ```\n   */\n  getHorizontalScrollOffsets?(\n    rowEl?: HTMLElement,\n    focusedCell?: HTMLElement,\n  ): { left: number; right: number; skipScroll?: boolean } | undefined;\n\n  /**\n   * Report vertical scroll boundary offsets for this plugin.\n   * Plugins that overlay the top or bottom of the rows viewport (e.g. sticky\n   * row clones) should return how much space they obscure on each edge, so\n   * keyboard navigation can scroll a focused row clear of the overlay rather\n   * than leaving it hidden underneath — WCAG 2.2 SC 2.4.11 Focus Not Obscured.\n   *\n   * Only report space that is painted *over* the scrollable rows. Content that\n   * takes part in normal flow (pinned-row bars, the column header) already\n   * shrinks the viewport and must NOT be reported here, or rows would scroll\n   * twice as far as needed.\n   *\n   * @param focusedRowIndex - Index of the row being scrolled into view, so a plugin can report `skipScroll` when it already renders that row in a permanently visible overlay\n   * @returns Object with top/bottom pixel offsets and optional skipScroll flag, or undefined if plugin obscures nothing\n   *\n   * @example\n   * ```ts\n   * getVerticalScrollOffsets(focusedRowIndex?: number): { top: number; bottom: number; skipScroll?: boolean } | undefined {\n   *   if (!this.overlayEl) return undefined;\n   *   // The row is already pinned in the overlay — it is visible where it is.\n   *   if (focusedRowIndex != null && this.stuckIndices.includes(focusedRowIndex)) {\n   *     return { top: 0, bottom: 0, skipScroll: true };\n   *   }\n   *   return { top: this.overlayEl.offsetHeight, bottom: 0 };\n   * }\n   * ```\n   *\n   * @since 3.6.0\n   */\n  getVerticalScrollOffsets?(\n    focusedRowIndex?: number,\n  ): { top: number; bottom: number; skipScroll?: boolean } | undefined;\n\n  // #endregion\n\n  // #region Shell Integration Hooks\n\n  /**\n   * Register a tool panel for this plugin.\n   * Return undefined if plugin has no tool panel.\n   * The shell will create a toolbar toggle button and render the panel content\n   * when the user opens the panel.\n   *\n   * @returns Tool panel definition, or undefined if plugin has no panel\n   *\n   * @example\n   * ```ts\n   * getToolPanel(): ToolPanelDefinition | undefined {\n   *   return {\n   *     id: 'columns',\n   *     title: 'Columns',\n   *     icon: '☰',\n   *     tooltip: 'Show/hide columns',\n   *     order: 10,\n   *     render: (container) => {\n   *       this.renderColumnList(container);\n   *       return () => this.cleanup();\n   *     },\n   *   };\n   * }\n   * ```\n   */\n  getToolPanel?(): ToolPanelDefinition | undefined;\n\n  /**\n   * Register content for the shell header center section.\n   * Return undefined if plugin has no header content.\n   * Examples: search input, selection summary, status indicators.\n   *\n   * @returns Header content definition, or undefined if plugin has no header content\n   *\n   * @example\n   * ```ts\n   * getHeaderContent(): HeaderContentDefinition | undefined {\n   *   return {\n   *     id: 'quick-filter',\n   *     order: 10,\n   *     render: (container) => {\n   *       const input = document.createElement('input');\n   *       input.type = 'text';\n   *       input.placeholder = 'Search...';\n   *       input.addEventListener('input', this.handleInput);\n   *       container.appendChild(input);\n   *       return () => input.removeEventListener('input', this.handleInput);\n   *     },\n   *   };\n   * }\n   * ```\n   */\n  getHeaderContent?(): HeaderContentDefinition | undefined;\n\n  // #endregion\n}\n","/**\n * Generic click-only action menu — the shared building block for WCAG 2.2\n * SC 2.5.7 \"Dragging Movements\" alternatives in plugins.\n *\n * Every drag affordance in the grid needs a path that works with plain clicks\n * or taps. A keyboard equivalent is **not** enough: SC 2.5.7 is specifically\n * about pointer input, and the W3C Understanding text calls out \"a pop-up menu\n * after tap\" as a conforming alternative. This module is that pop-up.\n *\n * Lives under `plugins/shared/` on purpose: each plugin bundle is built\n * self-contained, so this code is duplicated into the plugins that use it and\n * never lands in the core `index.js` budget.\n *\n * @since 3.6.0\n * @internal\n */\n\n/** Gap between the anchor element and the menu, in px. */\nconst ANCHOR_GAP_PX = 6;\n\n/** Runtime check — happy-dom and older browsers may lack the Popover API. */\nfunction supportsPopover(): boolean {\n  return typeof HTMLElement.prototype?.showPopover === 'function';\n}\n\nlet hoverlessQuery: MediaQueryList | null | undefined;\n\n/** Whether the primary pointer cannot hover (touch, most switch devices). */\nfunction isHoverless(): boolean {\n  if (hoverlessQuery === undefined) hoverlessQuery = globalThis.matchMedia?.('(hover: none)') ?? null;\n  return hoverlessQuery?.matches ?? false;\n}\n\n/**\n * Whether a plugin should also expose its drag alternative as a dedicated\n * inline control, on top of the menu that is always available.\n *\n * Hover-less pointers get one unconditionally — a control revealed on hover is\n * unreachable when nothing can hover, and long-press is the wrong fallback for\n * the tremor and low-dexterity users SC 2.5.7 exists for.\n *\n * Driven by `a11y.dragAlternatives` on the grid config.\n */\nexport function prefersInlineDragAlternative(grid: {\n  effectiveConfig?: { a11y?: { dragAlternatives?: 'menu' | 'inline' } };\n}): boolean {\n  return grid.effectiveConfig?.a11y?.dragAlternatives === 'inline' || isHoverless();\n}\n\n/** One clickable entry in the menu. */\nexport interface DragAlternativeAction {\n  /** Visible text, also the accessible name. */\n  label: string;\n  /** Render the entry but refuse the click (e.g. \"Move up\" on the first row). */\n  disabled?: boolean;\n  /** Invoked on click; the menu closes first so focus handling is predictable. */\n  run(): void;\n}\n\nexport interface DragAlternativeMenu {\n  /**\n   * Show `actions` anchored to `anchor`, with `label` as the group's accessible\n   * name. Mounted inside the anchor's grid host so it inherits theme tokens.\n   */\n  open(anchor: HTMLElement, label: string, actions: readonly DragAlternativeAction[]): void;\n  /** Hide the menu. Safe to call when already closed. */\n  close(): void;\n  /** Remove the element and every document-level listener. */\n  dispose(): void;\n  /** The menu element, or `null` before the first {@link DragAlternativeMenu.open}. */\n  readonly element: HTMLElement | null;\n}\n\n/**\n * Create a menu instance.\n *\n * @param id - DOM id for the menu element, unique per owning plugin.\n * @param className - Root class name, so each plugin can style its own menu.\n */\nexport function createDragAlternativeMenu(id: string, className: string): DragAlternativeMenu {\n  let root: HTMLDivElement | null = null;\n  let opened = false;\n  let disposed = false;\n  const abort = new AbortController();\n\n  function close(): void {\n    if (!opened || !root) return;\n    opened = false;\n    if (supportsPopover()) root.hidePopover();\n    root.hidden = true;\n  }\n\n  function build(): HTMLDivElement {\n    const el = document.createElement('div');\n    el.id = id;\n    el.className = className;\n    el.setAttribute('popover', 'manual');\n    el.setAttribute('role', 'group');\n    // Without the Popover API there is no UA `display: none`, so hide it here.\n    el.hidden = true;\n    // Tabbing past either end dismisses instead of stranding the user — the\n    // menu has no visible trigger to tab back to. A null `relatedTarget` (click\n    // focus in Firefox/Safari, focus leaving the document) is ignored.\n    el.addEventListener(\n      'focusout',\n      (e) => {\n        const next = (e as FocusEvent).relatedTarget;\n        if (next instanceof Node && !el.contains(next)) close();\n      },\n      { signal: abort.signal },\n    );\n    return el;\n  }\n\n  /**\n   * Position against the anchor in viewport coordinates. The menu lives in the\n   * top layer, so its containing block is the viewport regardless of where the\n   * anchor sits in the DOM.\n   */\n  function place(anchor: HTMLElement): void {\n    if (!root) return;\n    const a = anchor.getBoundingClientRect();\n    const box = root.getBoundingClientRect();\n    const left = Math.max(4, Math.min(a.left, window.innerWidth - box.width - 4));\n    const below = a.bottom + ANCHOR_GAP_PX;\n    const top = below + box.height <= window.innerHeight ? below : Math.max(4, a.top - ANCHOR_GAP_PX - box.height);\n    root.style.left = `${Math.round(left)}px`;\n    root.style.top = `${Math.round(top)}px`;\n  }\n\n  // Any pointer press outside the menu dismisses it. Capture phase so the press\n  // that lands on a grid cell still reaches its own handler afterwards.\n  document.addEventListener(\n    'pointerdown',\n    (e) => {\n      if (opened && root && !e.composedPath().includes(root)) close();\n    },\n    { capture: true, signal: abort.signal },\n  );\n  document.addEventListener(\n    'keydown',\n    (e) => {\n      if ((e as KeyboardEvent).key === 'Escape') close();\n    },\n    { capture: true, signal: abort.signal },\n  );\n\n  return {\n    get element() {\n      return root;\n    },\n    open(anchor, label, actions) {\n      if (disposed || actions.length === 0) return;\n      if (!root) root = build();\n      // Mount inside the grid host (light DOM) so theme custom properties and\n      // `color-scheme` cascade in; the top layer keeps it out of overflow.\n      const host = anchor.closest<HTMLElement>('tbw-grid, [data-tbw-grid]') ?? document.body;\n      if (root.parentNode !== host) host.appendChild(root);\n      root.setAttribute('aria-label', label);\n      root.replaceChildren();\n      for (const action of actions) {\n        const btn = document.createElement('button');\n        btn.type = 'button';\n        btn.className = `${className}-item`;\n        btn.textContent = action.label;\n        btn.disabled = action.disabled === true;\n        btn.addEventListener('click', () => {\n          close();\n          action.run();\n        });\n        root.appendChild(btn);\n      }\n      root.hidden = false;\n      if (!opened && supportsPopover()) root.showPopover();\n      opened = true;\n      place(anchor);\n      root.querySelector<HTMLButtonElement>('button:not([disabled])')?.focus();\n    },\n    close,\n    dispose() {\n      disposed = true;\n      close();\n      abort.abort();\n      root?.remove();\n      root = null;\n    },\n  };\n}\n","/**\n * Drag-Drop Protocol — shared utilities for cross-grid row drag-and-drop.\n *\n * Used by `RowDragDropPlugin` (and any future plugin that participates in the\n * tbw row-drag protocol). Centralises:\n *\n *   - MIME type constants and zone tagging (visible in `dataTransfer.types`)\n *   - Payload codec for cross-window / cross-iframe transfers\n *   - Drop-position math (midpoint algorithm)\n *   - Auto-scroll engine (rAF loop, edge detection, boundary clamp)\n *   - Plain-text TSV fallback for drags out to Notepad / Excel / Slack\n *\n * @internal Plugin shared utility (not part of the public API).\n */\n\nimport type { ColumnConfig } from '../../core/types';\n\n// ---------------------------------------------------------------------------\n// Same-window current-session tracker\n// ---------------------------------------------------------------------------\n\n/**\n * Module-level \"active drag session\" — set on dragstart by the source grid,\n * cleared on dragend. Lets target grids read the full payload synchronously\n * during `dragover` (browsers hide `dataTransfer.getData()` during dragover\n * for security). Cross-window drags don't have access to this module and\n * fall back to a generic accept-check followed by a drop-time canDrop call.\n *\n * @internal\n */\nlet currentSession: { sessionId: string; payload: RowDragPayload<unknown> } | null = null;\n\n/** @internal */\nexport function setCurrentDragSession<T>(sessionId: string, payload: RowDragPayload<T>): void {\n  currentSession = { sessionId, payload: payload as RowDragPayload<unknown> };\n}\n\n/** @internal */\nexport function getCurrentDragSession<T = unknown>(): { sessionId: string; payload: RowDragPayload<T> } | null {\n  return currentSession as { sessionId: string; payload: RowDragPayload<T> } | null;\n}\n\n/** @internal */\nexport function clearCurrentDragSession(): void {\n  currentSession = null;\n}\n\n// ---------------------------------------------------------------------------\n// MIME types\n// ---------------------------------------------------------------------------\n\n/** Base MIME type carried on `dataTransfer` for tbw row drags. */\nexport const TBW_ROW_DRAG_MIME = 'application/x-tbw-grid-rows+json';\n\n/** Build a zone-tagged MIME type, visible in `dataTransfer.types` during dragover. */\nexport function mimeForZone(zone: string): string {\n  return `${TBW_ROW_DRAG_MIME};zone=${encodeURIComponent(zone)}`;\n}\n\n/** Extract the zone from a tagged MIME, or `null` if untagged. */\nexport function parseZoneFromMime(mime: string): string | null {\n  const match = mime.match(/^application\\/x-tbw-grid-rows\\+json;zone=(.*)$/);\n  if (!match) return null;\n  try {\n    return decodeURIComponent(match[1]);\n  } catch {\n    return match[1];\n  }\n}\n\n/**\n * Find the first MIME entry in `types` whose zone matches `zone`.\n * Used during `dragover` for the accept-check (browsers hide `getData()`\n * during dragover, but `types` is always visible).\n */\nexport function findMatchingZoneMime(types: readonly string[], zone: string): string | null {\n  for (const t of types) {\n    if (parseZoneFromMime(t) === zone) return t;\n  }\n  return null;\n}\n\n/** Returns true if any tbw row-drag MIME is present in `types`. */\nexport function hasAnyRowDragMime(types: readonly string[]): boolean {\n  for (const t of types) {\n    if (t === TBW_ROW_DRAG_MIME || t.startsWith(`${TBW_ROW_DRAG_MIME};`)) return true;\n  }\n  return false;\n}\n\n// ---------------------------------------------------------------------------\n// Payload\n// ---------------------------------------------------------------------------\n\n/**\n * Cross-grid drag payload, carried on `dataTransfer` and (for same-window\n * recovery) keyed in the WeakRef registry by `sessionId`.\n *\n * Re-exported as public API from `plugins/row-drag-drop`.\n * @since 2.4.0\n */\nexport interface RowDragPayload<T = unknown> {\n  /** Drag session id (matches the WeakRef registry key). */\n  sessionId: string;\n  /** Source grid id (`grid.id` or auto-generated UUID). */\n  sourceGridId: string;\n  /** Drop zone the source grid is participating in. */\n  dropZone: string;\n  /** Serialized row payload (JSON-safe). For same-window drops, recovered live via the registry. */\n  rows: T[];\n  /** Original indices in the source grid's `_rows` array. */\n  rowIndices: number[];\n  /** Move (default) removes from source; copy leaves source intact. */\n  operation: 'move' | 'copy';\n}\n\n/** Encode a payload to the JSON string written to `dataTransfer`. */\nexport function encodePayload<T>(payload: RowDragPayload<T>): string {\n  return JSON.stringify(payload);\n}\n\n/** Decode a payload from the JSON string read off `dataTransfer`. */\nexport function decodePayload<T = unknown>(raw: string): RowDragPayload<T> | null {\n  if (!raw) return null;\n  try {\n    const parsed = JSON.parse(raw) as RowDragPayload<T>;\n    if (\n      typeof parsed?.sessionId !== 'string' ||\n      typeof parsed?.sourceGridId !== 'string' ||\n      typeof parsed?.dropZone !== 'string' ||\n      !Array.isArray(parsed?.rows) ||\n      !Array.isArray(parsed?.rowIndices) ||\n      (parsed.operation !== 'move' && parsed.operation !== 'copy')\n    ) {\n      return null;\n    }\n    // `rowIndices` is later used for sorting and splicing — reject anything\n    // that isn't a finite, non-negative integer to avoid JS coercion bugs\n    // (NaN ordering, float splice indices, string concatenation, etc.).\n    for (const idx of parsed.rowIndices) {\n      if (typeof idx !== 'number' || !Number.isInteger(idx) || idx < 0) return null;\n    }\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Drop position math\n// ---------------------------------------------------------------------------\n\nexport interface DropPosition {\n  /** Target visual row index that the cursor is over, or `null` for empty area. */\n  overIndex: number | null;\n  /** Final insertion index in the target grid's `_rows`. */\n  insertIndex: number;\n  /** True when the cursor is above the row midpoint. */\n  isBefore: boolean;\n}\n\n/**\n * Compute the insertion index for a drop, given the row element under the\n * cursor (if any), the cursor's clientY, and the total row count when the\n * cursor is in empty space below the last row.\n *\n * - Cursor above row midpoint → insert at `targetIndex`\n * - Cursor below row midpoint → insert at `targetIndex + 1`\n * - Cursor over empty area below the last row → append (`insertIndex = totalRows`)\n */\nexport function computeDropPosition(\n  rowEl: HTMLElement | null,\n  clientY: number,\n  rowIndexResolver: (el: HTMLElement) => number,\n  totalRows: number,\n): DropPosition {\n  if (!rowEl) {\n    return { overIndex: null, insertIndex: totalRows, isBefore: false };\n  }\n  const targetIndex = rowIndexResolver(rowEl);\n  if (targetIndex < 0) {\n    return { overIndex: null, insertIndex: totalRows, isBefore: false };\n  }\n  const rect = rowEl.getBoundingClientRect();\n  const midY = rect.top + rect.height / 2;\n  const isBefore = clientY < midY;\n  return {\n    overIndex: targetIndex,\n    insertIndex: isBefore ? targetIndex : targetIndex + 1,\n    isBefore,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Auto-scroll engine\n// ---------------------------------------------------------------------------\n\nexport interface AutoScrollOptions {\n  /** Pixels from the top/bottom edge that activate auto-scroll. */\n  edgeSize?: number;\n  /** Base scroll speed in pixels-per-frame near the edge. */\n  speed?: number;\n  /** Max speed at the very edge (linear ramp from `speed` → `maxSpeed`). */\n  maxSpeed?: number;\n}\n\nexport interface AutoScroller {\n  /** Update pointer position; starts the rAF loop if needed. */\n  onPointerMove(clientY: number): void;\n  /** Stop the rAF loop and reset state. */\n  stop(): void;\n  /** True when actively auto-scrolling. */\n  readonly isScrolling: boolean;\n}\n\n/**\n * Create an auto-scroller for a viewport element.\n *\n * The scroller runs a `requestAnimationFrame` loop only while the pointer is\n * within `edgeSize` of the viewport's top or bottom and there is room to\n * scroll. Speed ramps linearly from `speed` (at the edge boundary) to\n * `maxSpeed` (at the very edge).\n */\nexport function createAutoScroller(\n  viewport: HTMLElement,\n  options: AutoScrollOptions = {},\n  onScrollChange?: (active: boolean) => void,\n): AutoScroller {\n  const edgeSize = options.edgeSize ?? 60;\n  const baseSpeed = options.speed ?? 8;\n  const maxSpeed = options.maxSpeed ?? 24;\n\n  let rafId: number | null = null;\n  let pointerY: number | null = null;\n  let active = false;\n\n  const setActive = (next: boolean): void => {\n    if (next === active) return;\n    active = next;\n    onScrollChange?.(next);\n  };\n\n  const tick = (): void => {\n    rafId = null;\n    if (pointerY === null) {\n      setActive(false);\n      return;\n    }\n    const rect = viewport.getBoundingClientRect();\n    let delta = 0;\n\n    if (pointerY < rect.top + edgeSize) {\n      const distance = Math.max(0, pointerY - rect.top);\n      const ratio = 1 - distance / edgeSize;\n      delta = -Math.round(baseSpeed + (maxSpeed - baseSpeed) * ratio);\n    } else if (pointerY > rect.bottom - edgeSize) {\n      const distance = Math.max(0, rect.bottom - pointerY);\n      const ratio = 1 - distance / edgeSize;\n      delta = Math.round(baseSpeed + (maxSpeed - baseSpeed) * ratio);\n    }\n\n    if (delta === 0) {\n      setActive(false);\n      return;\n    }\n\n    const before = viewport.scrollTop;\n    viewport.scrollTop = before + delta;\n\n    // Stop if we hit a boundary (no movement happened)\n    if (viewport.scrollTop === before) {\n      setActive(false);\n      return;\n    }\n\n    setActive(true);\n    rafId = requestAnimationFrame(tick);\n  };\n\n  return {\n    onPointerMove(clientY: number): void {\n      pointerY = clientY;\n      if (rafId === null) {\n        rafId = requestAnimationFrame(tick);\n      }\n    },\n    stop(): void {\n      if (rafId !== null) {\n        cancelAnimationFrame(rafId);\n        rafId = null;\n      }\n      pointerY = null;\n      setActive(false);\n    },\n    get isScrolling(): boolean {\n      return active;\n    },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// TSV fallback\n// ---------------------------------------------------------------------------\n\n/**\n * Format rows as a TSV string for the `text/plain` drag fallback.\n * Used when the drop target is an external app (Excel, Notepad, Slack).\n *\n * - One row per line, fields separated by `\\t`.\n * - Tabs and newlines in cell values are replaced with spaces.\n * - Skips columns flagged as `utility` (drag handle, checkbox, etc.).\n */\nexport function formatRowsAsTSV<T extends Record<string, unknown>>(\n  rows: readonly T[],\n  columns: readonly ColumnConfig[],\n): string {\n  const dataColumns = columns.filter(\n    (c) => !(c as { utility?: boolean }).utility && typeof c.field === 'string' && c.field !== '',\n  );\n  const lines: string[] = [];\n  for (const row of rows) {\n    const cells = dataColumns.map((col) => {\n      const value = row[col.field];\n      if (value === null || value === undefined) return '';\n      const str = String(value);\n      return str.replace(/[\\t\\r\\n]+/g, ' ');\n    });\n    lines.push(cells.join('\\t'));\n  }\n  return lines.join('\\n');\n}\n","/**\n * Row Drag-Drop Plugin CSS\n *\n * Styles for drag handle, drop indicators (intra- and cross-grid), grid-level\n * drag/drop state classes, and FLIP animation on landing rows.\n */\n\n@layer tbw-plugins {\n  /* ------------------------------------------------------------------ */\n  /* Drag handle column                                                 */\n  /* ------------------------------------------------------------------ */\n  [data-field='__tbw_row_drag'] {\n    display: flex;\n    align-items: center;\n    justify-content: center;\n  }\n\n  .dg-row-drag-handle {\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    min-width: 1em;\n    min-height: 1em;\n    cursor: grab;\n    user-select: none;\n    color: var(--tbw-row-reorder-handle-color, var(--tbw-color-fg-muted));\n    transition: color var(--tbw-transition-duration, 120ms) var(--tbw-transition-ease, ease);\n    font-size: var(--tbw-font-size, 1em);\n    letter-spacing: -2px;\n\n    /* SC 2.5.8: grow the target, not the box, so the row keeps its height. */\n    position: relative;\n\n    &::after {\n      content: '';\n      position: absolute;\n      inset-block-start: 50%;\n      inset-inline-start: 50%;\n      translate: -50% -50%;\n      inline-size: var(--tbw-touch-target-min, 24px);\n      block-size: var(--tbw-touch-target-min, 24px);\n    }\n\n    &:hover {\n      color: var(--tbw-row-reorder-handle-hover, var(--tbw-color-fg));\n    }\n\n    &:active {\n      cursor: grabbing;\n    }\n  }\n\n  /* Coarse pointer (touch): handle always in active colour and large enough to tap */\n  @media (hover: none) {\n    .dg-row-drag-handle {\n      color: var(--tbw-row-reorder-handle-hover, var(--tbw-color-fg));\n    }\n  }\n\n  @media (pointer: coarse) {\n    .dg-row-drag-handle {\n      min-width: var(--tbw-touch-target-min, 24px);\n      min-height: var(--tbw-touch-target-min, 24px);\n    }\n  }\n\n  /* ------------------------------------------------------------------ */\n  /* Source row state                                                   */\n  /* ------------------------------------------------------------------ */\n  .data-grid-row.dragging {\n    opacity: 0.6;\n  }\n\n  /* When the row itself is the drag handle, hint at the affordance.    */\n  .data-grid-row[draggable='true'] {\n    cursor: grab;\n  }\n\n  .data-grid-row[draggable='true'].dragging {\n    cursor: grabbing;\n  }\n\n  /* Off-screen full-row clone used as the HTML5 drag image.            */\n  /* The browser already applies its own translucency to the snapshot,  */\n  /* so this clone keeps full opacity and skips the box-shadow — both   */\n  /* would otherwise composite on top of the browser's effect and make  */\n  /* the drag image look washed-out / fade at the edges.                */\n  .tbw-row-drag-clone {\n    position: fixed;\n    top: -10000px;\n    left: -10000px;\n    pointer-events: none;\n  }\n\n  /* Multi-row drag count badge */\n  .tbw-row-drag-count {\n    position: fixed;\n    top: -1000px; /* off-screen until the browser snapshots it */\n    left: -1000px;\n    pointer-events: none;\n    background: var(--tbw-row-reorder-indicator, var(--tbw-color-accent));\n    color: var(--tbw-color-accent-fg);\n    font:\n      600 12px/1.4 system-ui,\n      sans-serif;\n    border-radius: 999px;\n    padding: 2px 8px;\n    box-shadow: 0 2px 6px var(--tbw-color-shadow);\n    z-index: 9999;\n  }\n\n  /* ------------------------------------------------------------------ */\n  /* Drop position indicator (rows under cursor)                        */\n  /* ------------------------------------------------------------------ */\n  .data-grid-row.drop-target {\n    position: relative;\n\n    &.drop-before::before,\n    &.drop-after::after {\n      content: '';\n      position: absolute;\n      left: 0;\n      right: 0;\n      height: var(--tbw-drop-indicator-width, 2px);\n      background-color: var(--tbw-drop-indicator-color, var(--tbw-row-reorder-indicator, var(--tbw-color-accent)));\n      z-index: 10;\n      pointer-events: none;\n    }\n\n    &.drop-before::before {\n      top: 0;\n    }\n\n    &.drop-after::after {\n      bottom: 0;\n    }\n  }\n\n  /* ------------------------------------------------------------------ */\n  /* Grid-level state classes                                           */\n  /* ------------------------------------------------------------------ */\n\n  /* Source grid while a drag originating here is in progress */\n  .tbw-grid--drag-source {\n    /* Reserved hook for consumer styling. */\n  }\n\n  /* Target grid while a valid drag hovers (matching dropZone, canDrop ok) */\n  .tbw-grid--drop-target-active {\n    outline: 2px dashed var(--tbw-drop-indicator-color, var(--tbw-color-accent));\n    outline-offset: -2px;\n  }\n\n  /* Briefly applied when a drop attempt is rejected */\n  .tbw-grid--drop-target-rejected {\n    outline: 2px dashed var(--tbw-color-danger);\n    outline-offset: -2px;\n  }\n\n  /* Applied while the auto-scroll engine is actively scrolling this grid */\n  .tbw-grid--auto-scrolling {\n    cursor: ns-resize;\n  }\n\n  /* ------------------------------------------------------------------ */\n  /* FLIP animation on landing rows                                     */\n  /* ------------------------------------------------------------------ */\n  .data-grid-row.flip-animating {\n    transition: transform var(--tbw-animation-duration, 200ms) ease-out;\n    will-change: transform;\n    z-index: 1;\n  }\n\n  /* ------------------------------------------------------------------ */\n  /* Click-only move menu (WCAG 2.2 SC 2.5.7)                           */\n  /* ------------------------------------------------------------------ */\n  /* Rendered into `document.body` and promoted to the top layer, so it sits\n     outside the grid's custom-property scope — every var needs a literal\n     fallback here, the same way the tooltip popover does it. */\n  .tbw-row-move-menu {\n    position: fixed;\n    margin: 0;\n    display: flex;\n    flex-direction: column;\n    min-width: 10rem;\n    padding: var(--tbw-spacing-xs, 0.25rem);\n    background: var(--tbw-color-panel-bg, light-dark(#fff, #1f1f1f));\n    color: var(--tbw-color-fg, light-dark(#1a1a1a, #f0f0f0));\n    border: 1px solid var(--tbw-color-border, light-dark(#d0d0d0, #3a3a3a));\n    border-radius: var(--tbw-border-radius, 0.25rem);\n    box-shadow: var(--tbw-shadow-md, 0 4px 12px rgb(0 0 0 / 25%));\n    font: inherit;\n    z-index: 10001;\n\n    &[hidden] {\n      display: none;\n    }\n  }\n\n  .tbw-row-move-menu-item {\n    min-height: var(--tbw-touch-target-min, 24px);\n    padding: var(--tbw-spacing-xs, 0.25rem) var(--tbw-spacing-sm, 0.5rem);\n    text-align: start;\n    background: none;\n    border: none;\n    /* Themes set radii for much larger surfaces (Material uses 12px), which\n       turns a 24px row into a lozenge. */\n    border-radius: min(var(--tbw-border-radius, 0.25rem), 6px);\n    color: inherit;\n    font: inherit;\n    cursor: pointer;\n\n    &:hover:not(:disabled) {\n      background: var(--tbw-color-row-hover, light-dark(#f0f0f0, #2a2a2a));\n    }\n\n    &:disabled {\n      opacity: 0.5;\n      cursor: default;\n    }\n  }\n}\n","/**\n * Row Drag-Drop Plugin\n *\n * Drag rows within a single grid **and** between grids that share a\n * `dropZone`.\n *\n * Architecture overview is documented in the issue body and in\n * `.github/knowledge/grid-plugins.md`. Key invariants:\n *\n * - Mutations write to `grid._rows`; the user's input `sourceRows` array is\n *   never mutated on either side. Persistence is consumer-driven via the\n *   `row-move` (intra-grid) and `row-transfer` (cross-grid) events.\n * - Same-window cross-grid drops use the WeakRef registry in\n *   `core/internal/drag-drop-registry` to recover live row references.\n *   Cross-window drops fall back to `JSON.parse(JSON.stringify(row))` (or the\n *   `serializeRow`/`deserializeRow` hooks for non-JSON values).\n * - Duplicate instances of this plugin collapse via the PluginManager\n *   alias-collapse pre-pass, which merges their configs.\n *\n * @see {@link RowDragDropConfig} for all configuration options.\n */\n\nimport { GridClasses } from '../../core/constants';\nimport {\n  clearDragSession,\n  lookupDragSession,\n  newDragSessionId,\n  registerDragSession,\n} from '../../core/internal/drag-drop-registry';\nimport { ensureCellVisible } from '../../core/internal/keyboard';\nimport { BaseGridPlugin, type GridElement, type PluginManifest } from '../../core/plugin/base-plugin';\nimport type { ColumnConfig, GridHost } from '../../core/types';\nimport {\n  type DragAlternativeAction,\n  type DragAlternativeMenu,\n  createDragAlternativeMenu,\n} from '../shared/drag-alternative-menu';\nimport {\n  type AutoScroller,\n  type RowDragPayload,\n  TBW_ROW_DRAG_MIME,\n  clearCurrentDragSession,\n  computeDropPosition,\n  createAutoScroller,\n  decodePayload,\n  encodePayload,\n  findMatchingZoneMime,\n  formatRowsAsTSV,\n  getCurrentDragSession,\n  hasAnyRowDragMime,\n  mimeForZone,\n  setCurrentDragSession,\n} from '../shared/drag-drop-protocol';\nimport styles from './row-drag-drop.css?inline';\nimport type {\n  PendingMove,\n  RowDragDropConfig,\n  RowDragEndDetail,\n  RowDragStartDetail,\n  RowDropDetail,\n  RowMoveDetail,\n  RowTransferDetail,\n} from './types';\n\n/**\n * Field name for the drag handle column.\n *\n * @since 2.4.0\n */\nexport const ROW_DRAG_HANDLE_FIELD = '__tbw_row_drag';\n\n// ---------------------------------------------------------------------------\n// Cross-window coordination via BroadcastChannel\n// ---------------------------------------------------------------------------\n//\n// Same-window cross-grid drops can locate the source grid and its plugin via\n// `document.getElementById(sourceGridId)` — the target plugin handles both\n// sides of the transfer in `onDrop` (insert into target + remove from source\n// + emit `row-transfer` on both grids).\n//\n// Cross-window drops can't reach the source DOM that way. The target window\n// broadcasts a `tbw-row-drag-drop:transfer` message; each window has a single\n// channel and fans the message out to every attached plugin instance, which\n// matches on `sourceGridId === this.gridId` and runs the source-side path\n// (row removal on `move`, `row-transfer` emit, `dragAccepted` flip).\n//\n// The channel is created lazily on the first plugin that needs it and shared\n// across all instances in the window. It's torn down when the last instance\n// detaches so we don't leak a handle in environments where the plugin is\n// repeatedly attached/detached.\n\n/** @internal */\ninterface RemoteTransferMessage {\n  type: 'tbw-row-drag-drop:transfer';\n  sessionId: string;\n  sourceGridId: string;\n  toGridId: string;\n  dropZone: string;\n  rowIndices: number[];\n  toIndex: number;\n  operation: 'move' | 'copy';\n  /** Pre-serialized rows (the same shape `serializeRow` produced on dragstart). */\n  serializedRows: unknown[];\n}\n\ntype RemoteTransferListener = (msg: RemoteTransferMessage) => void;\n\nconst CROSS_WINDOW_CHANNEL_NAME = 'tbw-row-drag-drop';\nlet sharedChannel: BroadcastChannel | null = null;\nconst remoteListeners = new Set<RemoteTransferListener>();\n\nfunction ensureCrossWindowChannel(): BroadcastChannel | null {\n  if (typeof BroadcastChannel === 'undefined') return null;\n  if (sharedChannel) return sharedChannel;\n  try {\n    sharedChannel = new BroadcastChannel(CROSS_WINDOW_CHANNEL_NAME);\n    sharedChannel.addEventListener('message', (event: MessageEvent) => {\n      const data = event.data as RemoteTransferMessage | undefined;\n      if (!data || data.type !== 'tbw-row-drag-drop:transfer') return;\n      // Snapshot to tolerate listeners that detach during dispatch.\n      for (const listener of Array.from(remoteListeners)) {\n        try {\n          listener(data);\n        } catch {\n          /* listener errors must not break sibling listeners */\n        }\n      }\n    });\n  } catch {\n    sharedChannel = null;\n  }\n  return sharedChannel;\n}\n\nfunction registerRemoteTransferListener(listener: RemoteTransferListener): void {\n  remoteListeners.add(listener);\n  ensureCrossWindowChannel();\n}\n\n/**\n * Every plugin instance attached in this window.\n *\n * Drag-and-drop discovers its target from the pointer position, so it never\n * needed a registry. The click-only transfer control (WCAG 2.2 SC 2.5.7) does:\n * it has to *list* the grids a row can be sent to before the user picks one.\n *\n * Typed as `unknown` because the class is generic over the row type and every\n * instance in the window may have a different one; `peersInDropZone()` narrows.\n */\nconst attachedPlugins = new Set<unknown>();\n\nfunction unregisterRemoteTransferListener(listener: RemoteTransferListener): void {\n  remoteListeners.delete(listener);\n  if (remoteListeners.size === 0 && sharedChannel) {\n    try {\n      sharedChannel.close();\n    } catch {\n      /* noop */\n    }\n    sharedChannel = null;\n  }\n}\n\nfunction broadcastRemoteTransfer(msg: RemoteTransferMessage): void {\n  const channel = ensureCrossWindowChannel();\n  if (!channel) return;\n  try {\n    channel.postMessage(msg);\n  } catch {\n    /* postMessage may throw on uncloneable payloads — acceptable; user can\n     * supply `serializeRow` to provide a structured-cloneable shape. */\n  }\n}\n\n/**\n * Row Drag-Drop Plugin for `<tbw-grid>`.\n *\n * @example Intra-grid reordering\n * ```ts\n * import { RowDragDropPlugin } from '@toolbox-web/grid/plugins/row-drag-drop';\n *\n * grid.gridConfig = {\n *   plugins: [new RowDragDropPlugin()],\n * };\n * ```\n *\n * @example Cross-grid transfer list\n * ```ts\n * gridA.gridConfig = { plugins: [new RowDragDropPlugin({ dropZone: 'tasks' })] };\n * gridB.gridConfig = { plugins: [new RowDragDropPlugin({ dropZone: 'tasks' })] };\n *\n * gridA.addEventListener('row-transfer', (e) => persist(e.detail));\n * gridB.addEventListener('row-transfer', (e) => persist(e.detail));\n * ```\n *\n * @category Plugin\n */\nexport class RowDragDropPlugin<T = unknown> extends BaseGridPlugin<RowDragDropConfig<T>> {\n  /** @internal */\n  readonly name = 'rowDragDrop';\n\n  /** @internal */\n  override readonly styles = styles;\n\n  /** @internal */\n  static override readonly manifest: PluginManifest<RowDragDropConfig> = {\n    events: [\n      { type: 'row-move', description: 'Intra-grid row reorder.', cancelable: true },\n      { type: 'row-drag-start', description: 'Cross-grid drag started on this grid.', cancelable: true },\n      { type: 'row-drag-end', description: 'Drag finished on this grid (regardless of outcome).' },\n      { type: 'row-drop', description: 'Cross-grid drop landing on this grid.', cancelable: true },\n      { type: 'row-transfer', description: 'Cross-grid transfer completed (fires on both grids).' },\n    ],\n  };\n\n  /** @internal */\n  protected override get defaultConfig(): Partial<RowDragDropConfig<T>> {\n    return {\n      enableKeyboard: true,\n      // `showDragHandle` default depends on `dragFrom` — resolved by\n      // `shouldRenderDragHandle()` rather than here so a single `dragFrom`\n      // change reshapes both at once.\n      dragHandlePosition: 'left',\n      dragHandleWidth: 40,\n      debounceMs: 150,\n      animation: 'flip',\n      operation: 'move',\n      autoScroll: true,\n      dragFrom: 'handle',\n    };\n  }\n\n  /**\n   * Resolve whether the grip column should be rendered. The handle is shown\n   * unless the user explicitly set `showDragHandle: false`, OR `dragFrom`\n   * is `'row'` and `showDragHandle` was not explicitly set to `true`.\n   */\n  private shouldRenderDragHandle(): boolean {\n    const explicit = this.config.showDragHandle;\n    if (explicit === false) return false;\n    if (explicit === true) return true;\n    return this.config.dragFrom !== 'row';\n  }\n\n  /** Whether the row element itself should accept native HTML5 drag. */\n  private get rowIsDraggable(): boolean {\n    return this.config.dragFrom === 'row' || this.config.dragFrom === 'both';\n  }\n\n  /** Resolve animation type from plugin config (respects grid-level reduced-motion). */\n  private get animationType(): false | 'flip' {\n    if (!this.isAnimationEnabled) return false;\n    if (this.config.animation !== undefined) return this.config.animation;\n    return 'flip';\n  }\n\n  // #region Internal State\n  private isDragging = false;\n  private draggedRowIndex: number | null = null;\n  private draggedRows: T[] = [];\n  private draggedIndices: number[] = [];\n  private dragSessionId: string | null = null;\n  private dragAccepted = false;\n  private dropRowIndex: number | null = null;\n  private pendingMove: PendingMove | null = null;\n  private debounceTimer: ReturnType<typeof setTimeout> | null = null;\n  private lastFocusCol = 0;\n  private autoScroller: AutoScroller | null = null;\n  /** Stable id for this grid instance (used as `sourceGridId` in payloads). */\n  private gridId = '';\n\n  /** Bound listener so we can register/unregister the same reference. */\n  private readonly remoteTransferListener: RemoteTransferListener = (msg) => this.onRemoteTransfer(msg);\n\n  /** Click-only move menu (WCAG 2.2 SC 2.5.7), created lazily on first tap. */\n  private moveMenu: DragAlternativeMenu | null = null;\n\n  /** Typed internal grid accessor. */\n  private get internalGrid(): GridHost {\n    return this.grid;\n  }\n  // #endregion\n\n  // #region Lifecycle\n  /** @internal */\n  override attach(grid: GridElement): void {\n    super.attach(grid);\n    const host = this.gridElement;\n    if (host) {\n      this.gridId = host.id || `tbw-grid-${newDragSessionId().slice(0, 8)}`;\n      if (!host.id) host.id = this.gridId;\n      this.setupDelegatedDragListeners();\n      registerRemoteTransferListener(this.remoteTransferListener);\n      attachedPlugins.add(this);\n    }\n  }\n\n  /** @internal */\n  override detach(): void {\n    this.clearDebounceTimer();\n    this.autoScroller?.stop();\n    this.autoScroller = null;\n    unregisterRemoteTransferListener(this.remoteTransferListener);\n    attachedPlugins.delete(this);\n    this.moveMenu?.dispose();\n    this.moveMenu = null;\n    if (this.dragSessionId) clearDragSession(this.dragSessionId);\n    clearCurrentDragSession();\n    this.resetDragState();\n    super.detach();\n  }\n  // #endregion\n\n  // #region Hooks\n\n  /** @internal */\n  override processColumns(columns: readonly ColumnConfig[]): ColumnConfig[] {\n    if (!this.shouldRenderDragHandle()) return [...columns];\n\n    const dragHandleColumn: ColumnConfig = {\n      field: ROW_DRAG_HANDLE_FIELD,\n      header: '',\n      width: this.config.dragHandleWidth ?? 40,\n      resizable: false,\n      sortable: false,\n      filterable: false,\n      lockPosition: true,\n      utility: true,\n      viewRenderer: () => {\n        const container = document.createElement('div');\n        container.className = 'dg-row-drag-handle';\n        container.setAttribute('aria-label', 'Drag to reorder, or activate for move options');\n        container.setAttribute('role', 'button');\n        container.setAttribute('tabindex', '-1');\n        container.draggable = true;\n        // Press-and-release without moving is a tap, not a drag — HTML5 DnD\n        // only fires `dragstart` on a real drag, so a plain `click` here means\n        // the pointer user could not (or chose not to) drag. Offer the\n        // click-only alternative instead (WCAG 2.2 SC 2.5.7).\n        container.addEventListener('click', (e) => {\n          e.stopPropagation();\n          this.openMoveMenu(container);\n        });\n        this.setIcon(container, 'dragHandle');\n        return container;\n      },\n    };\n\n    return this.config.dragHandlePosition === 'right' ? [...columns, dragHandleColumn] : [dragHandleColumn, ...columns];\n  }\n\n  /** @internal */\n  override afterRender(): void {\n    this.applyRowDraggable();\n  }\n\n  /** @internal */\n  override onScrollRender(): void {\n    // Virtualization recycles row DOM elements during scroll; re-apply the\n    // `draggable` attribute so newly-shown rows still accept HTML5 drag.\n    this.applyRowDraggable();\n  }\n\n  /**\n   * Set or clear the `draggable` attribute on every visible row, depending on\n   * `config.dragFrom`. Idempotent and cheap (one attribute write per row).\n   */\n  private applyRowDraggable(): void {\n    const body = this.internalGrid._bodyEl;\n    if (!body) return;\n    const wantDraggable = this.rowIsDraggable;\n    const rows = body.querySelectorAll<HTMLElement>('.data-grid-row');\n    for (const row of rows) {\n      if (wantDraggable) {\n        if (row.getAttribute('draggable') !== 'true') row.setAttribute('draggable', 'true');\n      } else if (row.hasAttribute('draggable')) {\n        row.removeAttribute('draggable');\n      }\n    }\n  }\n\n  /** @internal */\n  override onKeyDown(event: KeyboardEvent): boolean | void {\n    if (!this.config.enableKeyboard) return;\n    // Ctrl is deprecated (macOS reserves Ctrl+↑/↓); remove in the next major.\n    if (!(event.altKey || event.ctrlKey) || (event.key !== 'ArrowUp' && event.key !== 'ArrowDown')) return;\n    if (this.#isKeyboardMoveBlocked(event)) return;\n\n    const grid = this.internalGrid;\n    const focusRow = grid._focusRow;\n    const rows = grid._rows ?? this.sourceRows;\n    if (focusRow < 0 || focusRow >= rows.length) return;\n\n    const direction = event.key === 'ArrowUp' ? 'up' : 'down';\n    const toIndex = direction === 'up' ? focusRow - 1 : focusRow + 1;\n    if (toIndex < 0 || toIndex >= rows.length) return;\n\n    const row = rows[focusRow];\n    if (!this.canMoveRow(focusRow, toIndex)) return;\n\n    this.handleKeyboardMove(row, focusRow, toIndex, grid._focusCol);\n    event.preventDefault();\n    event.stopPropagation();\n    return true;\n  }\n\n  /** Editors, form controls and non-body chrome own the chord (e.g. `<select>` Alt+↓ opens it). */\n  #isKeyboardMoveBlocked(event: KeyboardEvent): boolean {\n    if (this.queryBoolean('isEditing')) return true;\n    const target = (event.composedPath?.()[0] ?? event.target) as HTMLElement | null;\n    if (!target?.closest || target === this.gridElement) return false;\n    if (!target.closest('.rows-body')) return true;\n    const tag = target.tagName;\n    return tag === 'INPUT' || tag === 'SELECT' || tag === 'TEXTAREA' || target.isContentEditable;\n  }\n\n  /** @internal */\n  override onCellClick(): void {\n    this.flushPendingMove();\n  }\n  // #endregion\n\n  // #region Public API\n  /** Move a row to a new position programmatically (intra-grid). */\n  moveRow(fromIndex: number, toIndex: number): void {\n    const rows = [...this.sourceRows];\n    if (fromIndex < 0 || fromIndex >= rows.length) return;\n    if (toIndex < 0 || toIndex >= rows.length) return;\n    if (fromIndex === toIndex) return;\n    if (!this.canMoveRow(fromIndex, toIndex)) return;\n    this.executeIntraGridMove(rows[fromIndex], fromIndex, toIndex, 'keyboard');\n  }\n\n  /**\n   * Check if a row can be moved within this grid.\n   * Consults the `canDrag` veto for the source row, the plugin query system\n   * (`canMoveRow`), and `canDrop` for the target.\n   */\n  canMoveRow(fromIndex: number, toIndex: number): boolean {\n    // During debounced keyboard moves, `grid._rows` diverges from\n    // `sourceRows` (the user-facing snapshot) because the plugin mutates\n    // resolves the focused row from `_rows ?? sourceRows`, so validation must\n    // read from the same array — otherwise we'd run `canDrag`/queries against\n    // the wrong row.\n    const rows = this.internalGrid._rows ?? this.sourceRows;\n    if (fromIndex < 0 || fromIndex >= rows.length) return false;\n    if (toIndex < 0 || toIndex >= rows.length) return false;\n    if (fromIndex === toIndex) return false;\n\n    // Plugin query veto (Tree, GroupingRows)\n    const row = rows[fromIndex] as T;\n    const queryResults = this.grid?.query?.<boolean>('canMoveRow', row);\n    if (Array.isArray(queryResults) && queryResults.includes(false)) return false;\n\n    // canDrag veto (dragstart side)\n    if (this.config.canDrag && !this.config.canDrag(row, fromIndex)) return false;\n\n    // canDrop callback (intra-grid synthesised payload)\n    if (this.config.canDrop) {\n      const payload: RowDragPayload<T> = {\n        sessionId: 'intra',\n        sourceGridId: this.gridId,\n        dropZone: this.config.dropZone ?? '',\n        rows: [row],\n        rowIndices: [fromIndex],\n        operation: 'move',\n      };\n      if (!this.config.canDrop(payload, toIndex)) return false;\n    }\n\n    return true;\n  }\n  // #endregion\n\n  // #region Drag Setup\n\n  private setupDelegatedDragListeners(): void {\n    const gridEl = this.gridElement;\n    if (!gridEl) return;\n    const signal = this.disconnectSignal;\n\n    gridEl.addEventListener('dragstart', (e) => this.onDragStart(e as DragEvent), { signal });\n    gridEl.addEventListener('dragend', () => this.onDragEnd(), { signal });\n    gridEl.addEventListener('dragover', (e) => this.onDragOver(e as DragEvent), { signal });\n    gridEl.addEventListener('dragleave', (e) => this.onDragLeave(e as DragEvent), { signal });\n    gridEl.addEventListener('drop', (e) => this.onDrop(e as DragEvent), { signal });\n  }\n\n  private onDragStart(de: DragEvent): void {\n    const target = de.target as HTMLElement | null;\n    if (!target) return;\n\n    // Resolve the row element being picked up. Order matters: a click on the\n    // grip column inside a row-draggable grid should still go through the\n    // handle path so the cursor offset feels right.\n    const handle = target.closest('.dg-row-drag-handle') as HTMLElement | null;\n    let rowEl: HTMLElement | null = null;\n    let initiatedFromHandle = false;\n    if (handle) {\n      rowEl = handle.closest('.data-grid-row') as HTMLElement | null;\n      initiatedFromHandle = true;\n    } else if (this.rowIsDraggable) {\n      // Row-as-handle: any cell may start the drag, but interactive\n      // descendants (inputs, buttons, anchors, contenteditable, open\n      // editors, selection checkboxes) keep their native behaviour.\n      if (this.isInteractiveDragOrigin(target)) return;\n      rowEl = target.closest('.data-grid-row') as HTMLElement | null;\n    }\n    if (!rowEl) return;\n\n    const rowIndex = this.getRowIndex(rowEl);\n    if (rowIndex < 0) return;\n\n    // Resolve the rows being dragged: whole selection if dragged row is selected.\n    const { rows, indices } = this.resolveDraggedRows(rowIndex);\n    if (rows.length === 0) return;\n\n    // canDrag veto on the originating row\n    if (this.config.canDrag && !this.config.canDrag(rows[0], rowIndex)) {\n      de.preventDefault();\n      return;\n    }\n\n    const operation = this.config.operation ?? 'move';\n    const dropZone = this.config.dropZone ?? '';\n    const sessionId = newDragSessionId();\n\n    // Emit cancelable row-drag-start (source-side veto)\n    const startDetail: RowDragStartDetail<T> = { rows, indices, operation, dropZone };\n    if (this.emitCancelable('row-drag-start', startDetail)) {\n      de.preventDefault();\n      return;\n    }\n\n    this.isDragging = true;\n    this.draggedRowIndex = rowIndex;\n    this.draggedRows = rows;\n    this.draggedIndices = indices;\n    this.dragSessionId = sessionId;\n    this.dragAccepted = false;\n\n    // Build the cross-grid payload (always built, even when dropZone is empty —\n    // intra-grid drops still benefit from the registry round-trip)\n    const serialize = this.config.serializeRow ?? ((r: T) => r);\n    const payload: RowDragPayload<T> = {\n      sessionId,\n      sourceGridId: this.gridId,\n      dropZone,\n      rows: rows.map(serialize) as T[],\n      rowIndices: indices,\n      operation,\n    };\n\n    if (de.dataTransfer) {\n      de.dataTransfer.effectAllowed = operation === 'copy' ? 'copyMove' : 'move';\n      try {\n        de.dataTransfer.setData(TBW_ROW_DRAG_MIME, encodePayload(payload));\n        if (dropZone) de.dataTransfer.setData(mimeForZone(dropZone), encodePayload(payload));\n        // Plain-text TSV fallback for external drop targets\n        de.dataTransfer.setData('text/plain', formatRowsAsTSV(rows as Record<string, unknown>[], this.columns));\n      } catch {\n        /* JSDOM/happy-dom may throw on setData; harmless */\n      }\n\n      // Drag image: full-row clone for single-row drags (more legible than\n      // the handle alone); count badge for multi-row drags.\n      if (rows.length > 1) {\n        const badge = document.createElement('div');\n        badge.className = 'tbw-row-drag-count';\n        badge.textContent = `${rows.length} rows`;\n        document.body.appendChild(badge);\n        try {\n          de.dataTransfer.setDragImage(badge, 10, 10);\n        } catch {\n          /* ignore */\n        }\n        setTimeout(() => badge.remove(), 0);\n      } else {\n        this.attachRowCloneDragImage(de, rowEl, initiatedFromHandle ? handle : null);\n      }\n    }\n\n    // Same-window registry + current-session marker\n    registerDragSession(sessionId, rows as unknown[]);\n    setCurrentDragSession(sessionId, payload);\n\n    rowEl.classList.add(GridClasses.DRAGGING);\n    this.gridElement.classList.add('tbw-grid--drag-source');\n  }\n\n  /**\n   * Selectors whose dragstart should NOT initiate a row drag in `dragFrom: 'row'`\n   * mode. Keeps native interactions (text input, button clicks, link drag,\n   * cell editing, selection checkboxes) working unchanged.\n   */\n  private static readonly INTERACTIVE_DRAG_SELECTORS =\n    'input,textarea,select,button,a,[contenteditable=\"\"],[contenteditable=\"true\"],.dg-cell-editor,.tbw-checkbox-cell';\n\n  /** @internal */\n  private isInteractiveDragOrigin(target: HTMLElement): boolean {\n    return target.closest(RowDragDropPlugin.INTERACTIVE_DRAG_SELECTORS) !== null;\n  }\n\n  /**\n   * Build a full-row drag image by cloning `rowEl` so the user sees the\n   * actual row — not just the grip icon — while dragging.\n   *\n   * The clone is appended off-screen, snapshotted by the browser via\n   * `setDragImage`, then removed on the next tick (after the snapshot).\n   * The cursor offset is preserved relative to where the user pressed.\n   */\n  private attachRowCloneDragImage(de: DragEvent, rowEl: HTMLElement, handle: HTMLElement | null): void {\n    if (!de.dataTransfer) return;\n    const rect = rowEl.getBoundingClientRect();\n    const clone = rowEl.cloneNode(true) as HTMLElement;\n    clone.classList.add('tbw-row-drag-clone');\n    // Strip transient classes that would look wrong in the drag image.\n    clone.classList.remove('dragging', 'drop-target', 'drop-before', 'drop-after', 'flip-animating', 'row-focus');\n    clone.removeAttribute('aria-selected');\n    // Preserve the actual rendered width so cells don't reflow in the snapshot.\n    clone.style.width = `${rect.width}px`;\n    clone.style.height = `${rect.height}px`;\n    // The clone MUST stay inside the grid host: every core row/cell rule is\n    // scoped under `tbw-grid …` (see core/styles/*.css), and the\n    // `--tbw-column-template` custom property is set on the host. If the\n    // clone is moved to `document.body`, none of those rules match and the\n    // drag image collapses to an empty box. Off-screen positioning via\n    // `position: fixed` works the same regardless of the DOM parent.\n    this.gridElement.appendChild(clone);\n    // Cursor offset: where the user pressed inside the source row. Falls\n    // back to the centre of the handle when initiated from the grip.\n    let offsetX = de.clientX - rect.left;\n    let offsetY = de.clientY - rect.top;\n    if (handle) {\n      const handleRect = handle.getBoundingClientRect();\n      offsetX = handleRect.left - rect.left + handleRect.width / 2;\n      offsetY = handleRect.top - rect.top + handleRect.height / 2;\n    }\n    // Clamp into the row bounds so the cursor stays inside the drag image.\n    offsetX = Math.max(0, Math.min(rect.width, offsetX));\n    offsetY = Math.max(0, Math.min(rect.height, offsetY));\n    try {\n      de.dataTransfer.setDragImage(clone, offsetX, offsetY);\n    } catch {\n      /* JSDOM/happy-dom: harmless */\n    }\n    setTimeout(() => clone.remove(), 0);\n  }\n\n  private onDragOver(de: DragEvent): void {\n    const dt = de.dataTransfer;\n    if (!dt) return;\n\n    // Identify whether a tbw row drag is in progress and whether it matches our zone.\n    const types = dt.types ? Array.from(dt.types) : [];\n    if (!hasAnyRowDragMime(types) && !this.isDragging) return;\n\n    const dropZone = this.config.dropZone ?? '';\n    const session = getCurrentDragSession<T>();\n\n    // For cross-grid drags we require a matching zone-tagged MIME OR the\n    // session payload's dropZone must match ours.\n    const isIntra = this.isDragging && session?.payload.sourceGridId === this.gridId;\n    if (!isIntra) {\n      if (!dropZone) return; // intra-grid only — ignore external drags\n      const matchingMime = findMatchingZoneMime(types, dropZone);\n      if (!matchingMime && !(session && session.payload.dropZone === dropZone)) return;\n    }\n\n    de.preventDefault();\n    if (dt) dt.dropEffect = (session?.payload.operation ?? this.config.operation ?? 'move') as 'copy' | 'move';\n\n    // Compute drop position\n    const rowEl = (de.target as HTMLElement).closest('.data-grid-row') as HTMLElement | null;\n    const rows = this.internalGrid._rows ?? [];\n    const pos = computeDropPosition(rowEl, de.clientY, (el) => this.getRowIndex(el), rows.length);\n\n    // Same-row no-op for intra-grid\n    if (isIntra && pos.overIndex !== null && pos.overIndex === this.draggedRowIndex) {\n      this.clearDropTargetClasses();\n      return;\n    }\n\n    // canDrop check (same-window only — payload visible)\n    if (session && this.config.canDrop) {\n      const accepted = this.config.canDrop(session.payload, pos.insertIndex);\n      this.gridElement.classList.toggle('tbw-grid--drop-target-active', accepted);\n      this.gridElement.classList.toggle('tbw-grid--drop-target-rejected', !accepted);\n      if (!accepted) {\n        this.clearDropTargetClasses();\n        return;\n      }\n    } else {\n      this.gridElement.classList.add('tbw-grid--drop-target-active');\n    }\n\n    this.dropRowIndex = pos.insertIndex;\n    this.applyDropPositionClasses(rowEl, pos.isBefore);\n\n    // Auto-scroll the target viewport\n    if (this.config.autoScroll !== false) {\n      this.ensureAutoScroller();\n      this.autoScroller?.onPointerMove(de.clientY);\n    }\n  }\n\n  private onDragLeave(de: DragEvent): void {\n    const rowEl = (de.target as HTMLElement).closest('.data-grid-row') as HTMLElement | null;\n    if (rowEl) rowEl.classList.remove('drop-target', 'drop-before', 'drop-after');\n    // Tear down grid-level state when the cursor leaves the grid entirely\n    if (de.currentTarget && !this.gridElement.contains(de.relatedTarget as Node)) {\n      this.gridElement.classList.remove('tbw-grid--drop-target-active', 'tbw-grid--drop-target-rejected');\n      this.autoScroller?.stop();\n    }\n  }\n\n  private onDrop(de: DragEvent): void {\n    de.preventDefault();\n    this.autoScroller?.stop();\n    this.gridElement.classList.remove('tbw-grid--drop-target-active', 'tbw-grid--drop-target-rejected');\n    this.clearDropTargetClasses();\n\n    const dt = de.dataTransfer;\n    if (!dt) return;\n\n    // Resolve payload — prefer same-window session, fall back to dataTransfer JSON\n    const session = getCurrentDragSession<T>();\n    let payload: RowDragPayload<T> | null = session?.payload ?? null;\n    let liveRows: T[] | null = null;\n\n    if (payload) {\n      const lookup = lookupDragSession<T>(payload.sessionId);\n      if (lookup) liveRows = lookup;\n    } else {\n      const raw = dt.getData(TBW_ROW_DRAG_MIME);\n      payload = decodePayload<T>(raw);\n      if (payload) {\n        const lookup = lookupDragSession<T>(payload.sessionId);\n        if (lookup) liveRows = lookup;\n      }\n    }\n    if (!payload) return;\n\n    // Drop position (recompute in case dragover wasn't called for a few frames)\n    const rowEl = (de.target as HTMLElement).closest('.data-grid-row') as HTMLElement | null;\n    const rows = this.internalGrid._rows ?? [];\n    const pos = computeDropPosition(rowEl, de.clientY, (el) => this.getRowIndex(el), rows.length);\n    let targetIndex = this.dropRowIndex ?? pos.insertIndex;\n\n    const isIntra = payload.sourceGridId === this.gridId;\n    const dropZone = this.config.dropZone ?? '';\n\n    if (isIntra) {\n      // Intra-grid path — emit `row-move`.\n      const fromIndex = payload.rowIndices[0];\n      // Adjust toIndex when dropping after the dragged row (single-row only)\n      if (payload.rowIndices.length === 1 && targetIndex > fromIndex) targetIndex--;\n      if (fromIndex === targetIndex) return;\n      const row = (liveRows ?? payload.rows)[0];\n      if (!this.canMoveRow(fromIndex, targetIndex)) return;\n      this.executeIntraGridMove(row, fromIndex, targetIndex, 'drag');\n      return;\n    }\n\n    // Cross-grid path\n    if (!dropZone || dropZone !== payload.dropZone) return;\n\n    // canDrop final check\n    if (this.config.canDrop && !this.config.canDrop(payload, targetIndex)) {\n      this.gridElement.classList.add('tbw-grid--drop-target-rejected');\n      setTimeout(() => this.gridElement.classList.remove('tbw-grid--drop-target-rejected'), 200);\n      return;\n    }\n\n    // Resolve final row references — live (same-window) or deserialized JSON\n    const deserialize = this.config.deserializeRow ?? ((r: unknown) => r as T);\n    const incomingRows: T[] = liveRows ?? payload.rows.map((r) => deserialize(r as unknown));\n\n    const dropDetail: RowDropDetail<T> = {\n      payload,\n      sourceGridId: payload.sourceGridId,\n      targetIndex,\n      operation: payload.operation,\n    };\n    if (this.emitCancelable('row-drop', dropDetail)) return;\n\n    // Insert into target grid's _rows\n    const targetRows = [...rows];\n    targetRows.splice(targetIndex, 0, ...(incomingRows as unknown[]));\n    this.grid.rows = targetRows;\n\n    // Locate the source plugin in THIS window. If it's here we handle the\n    // source-side mutation directly; if it isn't, we broadcast a message and\n    // let the source-window plugin (if any) handle removal + transfer emit.\n    const sourcePlugin = this.findPeerOnGrid(payload.sourceGridId);\n\n    // Remove from source grid's _rows when operation === 'move' (same-window)\n    if (payload.operation === 'move' && sourcePlugin) {\n      const sourceGrid = document.getElementById(payload.sourceGridId) as\n        (HTMLElement & { rows?: unknown[]; _rows?: unknown[] }) | null;\n      if (sourceGrid) {\n        const srcRows = (sourceGrid._rows ?? sourceGrid.rows ?? []).slice();\n        // Remove from highest index down so earlier indices stay stable\n        const sortedIndices = [...payload.rowIndices].sort((a, b) => b - a);\n        for (const idx of sortedIndices) {\n          if (idx >= 0 && idx < srcRows.length) srcRows.splice(idx, 1);\n        }\n        sourceGrid.rows = srcRows;\n      }\n    }\n\n    // Mark accepted on the source plugin so dragend knows (same-window only —\n    // cross-window source flips its own flag in `onRemoteTransfer`).\n    if (sourcePlugin) sourcePlugin.dragAccepted = true;\n\n    // Emit row-transfer on the target. The source's `row-transfer` is fired\n    // either here (same-window) or by the source plugin in `onRemoteTransfer`\n    // (cross-window).\n    const transferDetail: RowTransferDetail<T> = {\n      rows: incomingRows,\n      fromGridId: payload.sourceGridId,\n      toGridId: this.gridId,\n      fromIndices: payload.rowIndices,\n      toIndex: targetIndex,\n      operation: payload.operation,\n    };\n    this.emit('row-transfer', transferDetail);\n\n    if (sourcePlugin) {\n      sourcePlugin.emitTransfer(transferDetail);\n    } else {\n      // Cross-window: broadcast so the source window can finish its half of\n      // the transfer (row removal on `move`, `row-transfer` emit, accepted flip).\n      broadcastRemoteTransfer({\n        type: 'tbw-row-drag-drop:transfer',\n        sessionId: payload.sessionId,\n        sourceGridId: payload.sourceGridId,\n        toGridId: this.gridId,\n        dropZone,\n        rowIndices: payload.rowIndices,\n        toIndex: targetIndex,\n        operation: payload.operation,\n        // Re-use the payload's already-serialized rows so the source side can\n        // round-trip them through `deserializeRow` for its `row-transfer` event.\n        serializedRows: payload.rows as unknown[],\n      });\n    }\n  }\n\n  /**\n   * Source-window handler for a remote `row-transfer` broadcast from a target\n   * window. Only runs on the plugin instance whose grid id matches the message.\n   * @internal\n   */\n  private onRemoteTransfer(msg: RemoteTransferMessage): void {\n    if (msg.sourceGridId !== this.gridId) return;\n    // Defensive: only act when the message zone matches our zone. This prevents\n    // a stray message from a grid sharing the same id but a different zone\n    // (e.g. independent demos in different tabs) from mutating our rows.\n    const dropZone = this.config.dropZone ?? '';\n    if (!dropZone || msg.dropZone !== dropZone) return;\n\n    // Resolve incoming rows (for the `row-transfer` event payload).\n    const deserialize = this.config.deserializeRow ?? ((r: unknown) => r as T);\n    const incomingRows: T[] = msg.serializedRows.map((r) => deserialize(r));\n\n    if (msg.operation === 'move') {\n      const srcRows = (this.internalGrid._rows ?? this.sourceRows).slice();\n      const sortedIndices = [...msg.rowIndices].sort((a, b) => b - a);\n      for (const idx of sortedIndices) {\n        if (idx >= 0 && idx < srcRows.length) srcRows.splice(idx, 1);\n      }\n      this.grid.rows = srcRows as unknown[];\n    }\n\n    // Flip accepted before dragend (best-effort — the message may arrive after\n    // dragend has already fired with `accepted: false`; `row-transfer` is the\n    // authoritative success signal).\n    this.dragAccepted = true;\n\n    this.emit('row-transfer', {\n      rows: incomingRows,\n      fromGridId: msg.sourceGridId,\n      toGridId: msg.toGridId,\n      fromIndices: msg.rowIndices,\n      toIndex: msg.toIndex,\n      operation: msg.operation,\n    } as RowTransferDetail<T>);\n  }\n\n  private onDragEnd(): void {\n    if (this.dragSessionId) clearDragSession(this.dragSessionId);\n    clearCurrentDragSession();\n    this.autoScroller?.stop();\n    this.gridElement.classList.remove('tbw-grid--drag-source');\n\n    if (this.isDragging) {\n      const endDetail: RowDragEndDetail<T> = {\n        rows: this.draggedRows,\n        indices: this.draggedIndices,\n        accepted: this.dragAccepted,\n      };\n      this.emit('row-drag-end', endDetail);\n    }\n    this.clearDragClasses();\n    this.resetDragState();\n  }\n  // #endregion\n\n  // #region Helpers\n\n  /** Public wrapper so a peer plugin can dispatch `row-transfer` on this grid. @internal */\n  emitTransfer(detail: RowTransferDetail<T>): void {\n    this.emit('row-transfer', detail);\n  }\n\n  /** Find the peer `RowDragDropPlugin` instance on another grid by id. */\n  private findPeerOnGrid(gridId: string): RowDragDropPlugin<T> | null {\n    const peerEl = document.getElementById(gridId) as\n      (HTMLElement & { getPluginByName?: (name: string) => RowDragDropPlugin<T> | undefined }) | null;\n    if (!peerEl?.getPluginByName) return null;\n    return peerEl.getPluginByName('rowDragDrop') ?? null;\n  }\n\n  // #region Click-only move menu (WCAG 2.2 SC 2.5.7)\n\n  /** Grids in this window sharing our (non-empty) `dropZone`. */\n  private peersInDropZone(): RowDragDropPlugin<T>[] {\n    const dropZone = this.config.dropZone ?? '';\n    if (!dropZone) return [];\n    const peers: RowDragDropPlugin<T>[] = [];\n    for (const candidate of attachedPlugins) {\n      const peer = candidate as RowDragDropPlugin<T>;\n      if (peer === this) continue;\n      if ((peer.config.dropZone ?? '') === dropZone) peers.push(peer);\n    }\n    return peers;\n  }\n\n  /** Human-readable name for this grid, used in the transfer menu. */\n  private get gridLabel(): string {\n    const host = this.gridElement;\n    return host?.getAttribute('aria-label') || host?.id || 'grid';\n  }\n\n  /**\n   * Open the click-only alternative to dragging a row: reorder within this grid\n   * and, when a `dropZone` is configured, send the row to a peer grid — all\n   * with single clicks or taps, no press-hold-move gesture.\n   */\n  private openMoveMenu(handle: HTMLElement): void {\n    const rowEl = handle.closest('.data-grid-row') as HTMLElement | null;\n    if (!rowEl) return;\n    const rowIndex = this.getRowIndex(rowEl);\n    if (rowIndex < 0) return;\n\n    const rows = this.internalGrid._rows ?? this.sourceRows;\n    const actions: DragAlternativeAction[] = [\n      {\n        label: 'Move up',\n        disabled: rowIndex === 0 || !this.canMoveRow(rowIndex, rowIndex - 1),\n        run: () => this.moveRow(rowIndex, rowIndex - 1),\n      },\n      {\n        label: 'Move down',\n        disabled: rowIndex >= rows.length - 1 || !this.canMoveRow(rowIndex, rowIndex + 1),\n        run: () => this.moveRow(rowIndex, rowIndex + 1),\n      },\n      {\n        label: 'Move to top',\n        disabled: rowIndex === 0 || !this.canMoveRow(rowIndex, 0),\n        run: () => this.moveRow(rowIndex, 0),\n      },\n      {\n        label: 'Move to bottom',\n        disabled: rowIndex >= rows.length - 1 || !this.canMoveRow(rowIndex, rows.length - 1),\n        run: () => this.moveRow(rowIndex, rows.length - 1),\n      },\n    ];\n\n    const verb = (this.config.operation ?? 'move') === 'copy' ? 'Copy to' : 'Send to';\n    for (const peer of this.peersInDropZone()) {\n      actions.push({\n        label: `${verb} ${peer.gridLabel}`,\n        run: () => this.transferToPeer(peer, rowIndex),\n      });\n    }\n\n    this.moveMenu ??= createDragAlternativeMenu('tbw-row-move-menu', 'tbw-row-move-menu');\n    this.moveMenu.open(handle, `Move row ${rowIndex + 1}`, actions);\n  }\n\n  /**\n   * Click-only equivalent of dropping the row onto `peer`. Runs the same vetoes\n   * and emits the same events as the drag path (`row-drag-start`, `row-drop`,\n   * `row-transfer`) so consumers cannot tell the two apart.\n   */\n  private transferToPeer(peer: RowDragDropPlugin<T>, rowIndex: number): void {\n    const dropZone = this.config.dropZone ?? '';\n    if (!dropZone) return;\n\n    const { rows, indices } = this.resolveDraggedRows(rowIndex);\n    if (rows.length === 0) return;\n    if (this.config.canDrag && !this.config.canDrag(rows[0], rowIndex)) return;\n\n    const operation = this.config.operation ?? 'move';\n    if (this.emitCancelable('row-drag-start', { rows, indices, operation, dropZone } as RowDragStartDetail<T>)) return;\n\n    const serialize = this.config.serializeRow ?? ((r: T) => r);\n    const payload: RowDragPayload<T> = {\n      sessionId: newDragSessionId(),\n      sourceGridId: this.gridId,\n      dropZone,\n      rows: rows.map(serialize) as T[],\n      rowIndices: indices,\n      operation,\n    };\n\n    const toIndex = peer.acceptTransfer(payload, rows);\n    if (toIndex < 0) return;\n\n    if (operation === 'move') {\n      const srcRows = [...(this.internalGrid._rows ?? this.sourceRows)];\n      for (const idx of [...indices].sort((a, b) => b - a)) {\n        if (idx >= 0 && idx < srcRows.length) srcRows.splice(idx, 1);\n      }\n      this.grid.rows = srcRows as unknown[];\n    }\n\n    const detail: RowTransferDetail<T> = {\n      rows,\n      fromGridId: this.gridId,\n      toGridId: peer.gridId,\n      fromIndices: indices,\n      toIndex,\n      operation,\n    };\n    peer.emitTransfer(detail);\n    this.emit('row-transfer', detail);\n  }\n\n  /**\n   * Target half of {@link RowDragDropPlugin.transferToPeer}. Returns the insert\n   * index, or `-1` when the transfer was rejected (zone mismatch, `canDrop`\n   * veto, or a cancelled `row-drop`).\n   *\n   * @internal\n   */\n  acceptTransfer(payload: RowDragPayload<T>, liveRows: readonly T[]): number {\n    const dropZone = this.config.dropZone ?? '';\n    if (!dropZone || dropZone !== payload.dropZone) return -1;\n\n    const rows = this.internalGrid._rows ?? this.sourceRows;\n    const targetIndex = rows.length;\n    if (this.config.canDrop && !this.config.canDrop(payload, targetIndex)) return -1;\n\n    const dropDetail: RowDropDetail<T> = {\n      payload,\n      sourceGridId: payload.sourceGridId,\n      targetIndex,\n      operation: payload.operation,\n    };\n    if (this.emitCancelable('row-drop', dropDetail)) return -1;\n\n    this.grid.rows = [...(rows as unknown[]), ...(liveRows as unknown[])];\n    return targetIndex;\n  }\n  // #endregion\n\n  private resolveDraggedRows(originIndex: number): { rows: T[]; indices: number[] } {\n    const rows = this.internalGrid._rows ?? this.sourceRows;\n    const originRow = rows[originIndex] as T;\n\n    // If a selection plugin is loaded and the dragged row is selected, drag the whole selection.\n    const selection = this.grid?.getPluginByName?.('selection') as\n      { getSelectedRowIndices?: () => number[]; getSelectedRows?: <U>() => U[] } | undefined;\n    if (selection?.getSelectedRowIndices) {\n      const selectedIndices = selection.getSelectedRowIndices();\n      if (selectedIndices.includes(originIndex) && selectedIndices.length > 1) {\n        const sorted = [...selectedIndices].sort((a, b) => a - b);\n        return {\n          rows: sorted.map((i) => rows[i] as T),\n          indices: sorted,\n        };\n      }\n    }\n    return { rows: [originRow], indices: [originIndex] };\n  }\n\n  private ensureAutoScroller(): void {\n    if (this.autoScroller) return;\n    const viewport = this.gridElement.querySelector<HTMLElement>('.rows-viewport');\n    if (!viewport) return;\n    const opts = typeof this.config.autoScroll === 'object' ? this.config.autoScroll : undefined;\n    this.autoScroller = createAutoScroller(viewport, opts, (active) => {\n      this.gridElement.classList.toggle('tbw-grid--auto-scrolling', active);\n    });\n  }\n\n  private applyDropPositionClasses(rowEl: HTMLElement | null, isBefore: boolean): void {\n    this.clearDropTargetClasses();\n    if (!rowEl) return;\n    rowEl.classList.add('drop-target');\n    rowEl.classList.toggle('drop-before', isBefore);\n    rowEl.classList.toggle('drop-after', !isBefore);\n  }\n\n  private clearDropTargetClasses(): void {\n    this.gridElement?.querySelectorAll('.data-grid-row.drop-target').forEach((row) => {\n      row.classList.remove('drop-target', 'drop-before', 'drop-after');\n    });\n  }\n\n  private clearDragClasses(): void {\n    this.gridElement?.querySelectorAll('.data-grid-row').forEach((row) => {\n      row.classList.remove(GridClasses.DRAGGING, 'drop-target', 'drop-before', 'drop-after');\n    });\n  }\n\n  private resetDragState(): void {\n    this.isDragging = false;\n    this.draggedRowIndex = null;\n    this.draggedRows = [];\n    this.draggedIndices = [];\n    this.dragSessionId = null;\n    this.dragAccepted = false;\n    this.dropRowIndex = null;\n    this.pendingMove = null;\n  }\n\n  private getRowIndex(rowEl: HTMLElement): number {\n    const cell = rowEl.querySelector('.cell[data-row]');\n    return cell ? parseInt(cell.getAttribute('data-row') ?? '-1', 10) : -1;\n  }\n\n  private clearDebounceTimer(): void {\n    if (this.debounceTimer) {\n      clearTimeout(this.debounceTimer);\n      this.debounceTimer = null;\n    }\n  }\n\n  // #endregion\n\n  // #region Intra-Grid Move\n\n  private handleKeyboardMove(row: T, fromIndex: number, toIndex: number, focusCol: number): void {\n    if (!this.pendingMove) {\n      this.pendingMove = { originalIndex: fromIndex, currentIndex: toIndex, row };\n    } else {\n      this.pendingMove.currentIndex = toIndex;\n    }\n    this.lastFocusCol = focusCol;\n\n    const grid = this.internalGrid;\n    const rows = [...(grid._rows ?? this.sourceRows)];\n    const [movedRow] = rows.splice(fromIndex, 1);\n    rows.splice(toIndex, 0, movedRow);\n\n    grid._rows = rows;\n    grid._focusRow = toIndex;\n    grid._focusCol = focusCol;\n    grid.refreshVirtualWindow(true);\n    ensureCellVisible(grid);\n\n    this.clearDebounceTimer();\n    this.debounceTimer = setTimeout(() => this.flushPendingMove(), this.config.debounceMs ?? 300);\n  }\n\n  private flushPendingMove(): void {\n    this.clearDebounceTimer();\n    if (!this.pendingMove) return;\n    const { originalIndex, currentIndex, row: movedRow } = this.pendingMove;\n    this.pendingMove = null;\n    if (originalIndex === currentIndex) return;\n\n    const grid = this.internalGrid;\n    // `grid._rows` already reflects the post-move order (mutated incrementally\n    // by `handleKeyboardMove`); report it as `detail.rows` so consumers see\n    // the actual reordered array, not the original `sourceRows` snapshot.\n    const postMoveRows = (grid._rows ?? this.sourceRows) as T[];\n    const detail: RowMoveDetail<T> = {\n      row: movedRow as T,\n      fromIndex: originalIndex,\n      toIndex: currentIndex,\n      rows: [...postMoveRows],\n      source: 'keyboard',\n    };\n    const cancelled = this.emitCancelable('row-move', detail);\n    if (cancelled) {\n      // Revert: restore the original snapshot. `sourceRows` was never mutated\n      // during the pending move (only `grid._rows` was), so resetting from it\n      // is the correct rollback regardless of how many incremental keyboard\n      // moves accumulated.\n      grid._rows = [...this.sourceRows];\n      grid._focusRow = originalIndex;\n      grid._focusCol = this.lastFocusCol;\n      grid.refreshVirtualWindow(true);\n      ensureCellVisible(grid);\n    }\n  }\n\n  private executeIntraGridMove(row: unknown, fromIndex: number, toIndex: number, source: 'keyboard' | 'drag'): void {\n    const rows = [...this.sourceRows];\n    const [movedRow] = rows.splice(fromIndex, 1);\n    rows.splice(toIndex, 0, movedRow);\n    const detail: RowMoveDetail<T> = {\n      row: row as T,\n      fromIndex,\n      toIndex,\n      rows: rows as T[],\n      source,\n    };\n    const cancelled = this.emitCancelable('row-move', detail);\n    if (cancelled) return;\n    if (this.animationType === 'flip' && this.gridElement) {\n      const oldPositions = this.captureRowPositions();\n      this.grid.rows = rows;\n      requestAnimationFrame(() => {\n        void this.gridElement.offsetHeight;\n        this.animateFLIP(oldPositions, fromIndex, toIndex);\n      });\n    } else {\n      this.grid.rows = rows;\n    }\n  }\n\n  private captureRowPositions(): Map<number, number> {\n    const positions = new Map<number, number>();\n    this.gridElement?.querySelectorAll('.data-grid-row').forEach((row) => {\n      const rowIndex = this.getRowIndex(row as HTMLElement);\n      if (rowIndex >= 0) positions.set(rowIndex, row.getBoundingClientRect().top);\n    });\n    return positions;\n  }\n\n  private animateFLIP(oldPositions: Map<number, number>, fromIndex: number, toIndex: number): void {\n    const gridEl = this.gridElement;\n    if (!gridEl || oldPositions.size === 0) return;\n\n    const minIndex = Math.min(fromIndex, toIndex);\n    const maxIndex = Math.max(fromIndex, toIndex);\n    const rowsToAnimate: { el: HTMLElement; deltaY: number }[] = [];\n\n    gridEl.querySelectorAll('.data-grid-row').forEach((row) => {\n      const rowEl = row as HTMLElement;\n      const newRowIndex = this.getRowIndex(rowEl);\n      if (newRowIndex < 0 || newRowIndex < minIndex || newRowIndex > maxIndex) return;\n      let oldIndex: number;\n      if (newRowIndex === toIndex) oldIndex = fromIndex;\n      else if (fromIndex < toIndex) oldIndex = newRowIndex + 1;\n      else oldIndex = newRowIndex - 1;\n      const oldTop = oldPositions.get(oldIndex);\n      if (oldTop === undefined) return;\n      const newTop = rowEl.getBoundingClientRect().top;\n      const deltaY = oldTop - newTop;\n      if (Math.abs(deltaY) > 1) rowsToAnimate.push({ el: rowEl, deltaY });\n    });\n\n    if (rowsToAnimate.length === 0) return;\n\n    rowsToAnimate.forEach(({ el, deltaY }) => {\n      el.style.transform = `translateY(${deltaY}px)`;\n    });\n    void gridEl.offsetHeight;\n\n    const duration = this.animationDuration;\n    requestAnimationFrame(() => {\n      rowsToAnimate.forEach(({ el }) => {\n        el.classList.add('flip-animating');\n        el.style.transform = '';\n      });\n      setTimeout(() => {\n        rowsToAnimate.forEach(({ el }) => {\n          el.style.transform = '';\n          el.classList.remove('flip-animating');\n        });\n      }, duration + 50);\n    });\n  }\n\n  // #endregion\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../../libs/grid/src/lib/core/constants.ts","../../../../../../libs/grid/src/lib/core/internal/drag-drop-registry.ts","../../../../../../libs/grid/src/lib/core/internal/utils.ts","../../../../../../libs/grid/src/lib/core/internal/virtualization.ts","../../../../../../libs/grid/src/lib/core/internal/keyboard.ts","../../../../../../libs/grid/src/lib/core/defaults.ts","../../../../../../libs/grid/src/lib/core/internal/diagnostics.ts","../../../../../../libs/grid/src/lib/core/internal/sanitize.ts","../../../../../../libs/grid/src/lib/core/plugin/base-plugin.ts","../../../../../../libs/grid/src/lib/plugins/shared/drag-alternative-menu.ts","../../../../../../libs/grid/src/lib/plugins/shared/drag-drop-protocol.ts","../../../../../../libs/grid/src/lib/plugins/row-drag-drop/row-drag-drop.css?inline","../../../../../../libs/grid/src/lib/plugins/row-drag-drop/row-drag-drop-plugin.ts"],"sourcesContent":["/**\n * Grid DOM Constants\n *\n * Centralized constants for CSS classes, data attributes, and selectors\n * used throughout the grid. Use these instead of magic strings.\n *\n * Note: Some constants here are used by plugins but defined in core because:\n * 1. The core CSS needs to style these elements (e.g., sticky positioning)\n * 2. Multiple plugins may share the same class names\n *\n * Plugins can define their own additional constants and export them.\n * See each plugin's index.ts for plugin-specific exports.\n */\n\n/**\n * CSS selector for focusable editor elements within a cell.\n * Used by EditingPlugin, UndoRedoPlugin, and keyboard navigation. Defined here\n * (a leaf module) rather than in `rows.ts` so `keyboard.ts` can consume it\n * without creating a rows ↔ keyboard import cycle.\n */\nexport const FOCUSABLE_EDITOR_SELECTOR =\n  'input,select,textarea,[contenteditable=\"true\"],[contenteditable=\"\"],[tabindex]:not([tabindex=\"-1\"])';\n\n// #region CSS Classes\n\n/**\n * CSS class names used in the grid's DOM.\n * Use these when adding/removing classes or querying elements.\n *\n * Classes are organized by:\n * - Core: Used by the grid core for structure and basic functionality\n * - Shared: Used by multiple features/plugins, styled by core CSS\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport const GridClasses = {\n  // ─── Core Structure ───────────────────────────────────────────────\n  ROOT: 'tbw-grid-root',\n  HEADER: 'header',\n  HEADER_ROW: 'header-row',\n  HEADER_CELL: 'header-cell',\n\n  // Body structure\n  ROWS_VIEWPORT: 'rows-viewport',\n  ROWS_SPACER: 'rows-spacer',\n  ROWS_CONTAINER: 'rows',\n\n  // Row elements\n  DATA_ROW: 'data-grid-row',\n  GROUP_ROW: 'group-row',\n\n  // Cell elements\n  DATA_CELL: 'cell',\n\n  // ─── Core States ──────────────────────────────────────────────────\n  SELECTED: 'selected',\n  FOCUSED: 'focused',\n  EDITING: 'editing',\n  EXPANDED: 'expanded',\n  COLLAPSED: 'collapsed',\n  DRAGGING: 'dragging',\n  RESIZING: 'resizing',\n\n  // Sorting (core feature)\n  SORTABLE: 'sortable',\n  SORTED_ASC: 'sorted-asc',\n  SORTED_DESC: 'sorted-desc',\n\n  // Visibility\n  HIDDEN: 'hidden',\n\n  // ─── Shared Classes (used by plugins, styled by core CSS) ────────\n  // These are defined here because core CSS provides the base styling.\n  // Plugins apply these classes; core CSS defines how they look.\n\n  // Sticky positioning (PinnedColumnsPlugin applies, core CSS styles)\n  STICKY_LEFT: 'sticky-left',\n  STICKY_RIGHT: 'sticky-right',\n\n  // Pinned rows (PinnedRowsPlugin applies, core CSS styles)\n  PINNED_TOP: 'pinned-top',\n  PINNED_BOTTOM: 'pinned-bottom',\n\n  // Tree structure (TreePlugin applies, core CSS styles)\n  TREE_TOGGLE: 'tree-toggle',\n  TREE_INDENT: 'tree-indent',\n\n  // Grouping (GroupingRowsPlugin applies, core CSS styles)\n  GROUP_TOGGLE: 'group-toggle',\n  GROUP_LABEL: 'group-label',\n  GROUP_COUNT: 'group-count',\n\n  // Selection (SelectionPlugin applies, core CSS styles)\n  RANGE_SELECTION: 'range-selection',\n  SELECTION_OVERLAY: 'selection-overlay',\n} as const;\n\n// #endregion\n\n// #region Data Attributes\n\n/**\n * Data attribute names used on grid elements.\n * Use these when getting/setting data attributes.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport const GridDataAttrs = {\n  // ─── Core Attributes ──────────────────────────────────────────────\n  FIELD: 'data-field',\n\n  /**\n   * Marks a `title` the grid itself put on a cell to reveal ellipsised text\n   * (WCAG SC 1.4.12). Anything that sets its own `title` on a cell must clear\n   * this, or the grid will later mistake that title for its own and replace it.\n   *\n   * @since 3.6.0\n   */\n  TRUNCATED: 'data-tbw-truncated',\n\n  // ─── Shared Attributes (used by plugins) ──────────────────────────\n  GROUP_KEY: 'data-group-key', // GroupingRowsPlugin\n} as const;\n\n// #endregion\n\n// #region Selectors\n\n/**\n * Common CSS selectors for querying grid elements.\n * Built from the class constants for consistency.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport const GridSelectors = {\n  ROOT: `.${GridClasses.ROOT}`,\n  HEADER: `.${GridClasses.HEADER}`,\n  HEADER_ROW: `.${GridClasses.HEADER_ROW}`,\n  HEADER_CELL: `.${GridClasses.HEADER_CELL}`,\n  ROWS_VIEWPORT: `.${GridClasses.ROWS_VIEWPORT}`,\n  ROWS_CONTAINER: `.${GridClasses.ROWS_CONTAINER}`,\n  DATA_ROW: `.${GridClasses.DATA_ROW}`,\n  DATA_CELL: `.${GridClasses.DATA_CELL}`,\n  GROUP_ROW: `.${GridClasses.GROUP_ROW}`,\n\n  // By data attribute\n  CELL_BY_FIELD: (field: string) => `.${GridClasses.DATA_CELL}[${GridDataAttrs.FIELD}=\"${field}\"]`,\n\n  // State selectors\n  SELECTED_ROWS: `.${GridClasses.DATA_ROW}.${GridClasses.SELECTED}`,\n  EDITING_CELL: `.${GridClasses.DATA_CELL}.${GridClasses.EDITING}`,\n} as const;\n\n// #endregion\n\n// #region CSS Custom Properties\n\n/**\n * CSS custom property names for theming.\n * Use these when programmatically setting styles.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport const GridCSSVars = {\n  // Colors\n  COLOR_BG: '--tbw-color-bg',\n  COLOR_FG: '--tbw-color-fg',\n  COLOR_FG_MUTED: '--tbw-color-fg-muted',\n  COLOR_BORDER: '--tbw-color-border',\n  COLOR_ACCENT: '--tbw-color-accent',\n  COLOR_HEADER_BG: '--tbw-color-header-bg',\n  COLOR_HEADER_FG: '--tbw-color-header-fg',\n  COLOR_SELECTION: '--tbw-color-selection',\n  COLOR_ROW_HOVER: '--tbw-color-row-hover',\n  COLOR_ROW_ALT: '--tbw-color-row-alt',\n\n  // Sizing\n  ROW_HEIGHT: '--tbw-row-height',\n  HEADER_HEIGHT: '--tbw-header-height',\n  CELL_PADDING: '--tbw-cell-padding',\n\n  // Typography\n  FONT_FAMILY: '--tbw-font-family',\n  FONT_SIZE: '--tbw-font-size',\n\n  // Borders\n  BORDER_RADIUS: '--tbw-border-radius',\n  FOCUS_OUTLINE: '--tbw-focus-outline',\n} as const;\n\n// #endregion\n\n// Type helpers\n\n/**\n * Union of all CSS class names used in the grid's DOM.\n * Use `GridClasses` to access individual values by key.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport type GridClassName = (typeof GridClasses)[keyof typeof GridClasses];\n\n/**\n * Union of all `data-*` attribute names used on grid elements.\n * Use `GridDataAttrs` to access individual values by key.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport type GridDataAttr = (typeof GridDataAttrs)[keyof typeof GridDataAttrs];\n\n/**\n * Union of all CSS custom property names (`--tbw-*`) available for theming.\n * Use `GridCSSVars` to access individual values by key.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport type GridCSSVar = (typeof GridCSSVars)[keyof typeof GridCSSVars];\n","/**\n * Drag-Drop Registry\n *\n * Module-level singleton that holds live (WeakRef) references to row objects\n * being dragged across grids in the same JS heap. Used by `RowDragDropPlugin`\n * to recover live references on drop, avoiding any serialization cost when\n * source and target grids share a heap.\n *\n * Lives in `core/internal/` (not in the plugin bundle) so that two copies of\n * `@toolbox-web/grid` loaded via different entry points (e.g. `/all` vs\n * per-plugin imports) cannot end up with two separate registries that silently\n * fall back to JSON.\n *\n * Cross-window / cross-origin-iframe drags do NOT go through this registry —\n * they fall back to `dataTransfer` JSON.\n *\n * @internal\n */\n\ninterface RegistryEntry {\n  readonly refs: ReadonlyArray<WeakRef<object>>;\n  /** True when one or more registered rows were primitives (not objects). */\n  readonly hasPrimitives: boolean;\n}\n\nconst registry = new Map<string, RegistryEntry>();\n\n/**\n * Register a drag session's live row references.\n *\n * Object rows are stored as `WeakRef<object>`; primitive rows cannot be held\n * weakly and would either need a sentinel (which corrupts the row value on\n * recovery) or be omitted (which misaligns indices). We instead flag the\n * session as containing primitives — `lookupDragSession()` then returns\n * `undefined` so callers fall back to the JSON payload, which round-trips\n * primitives losslessly.\n *\n * @param sessionId - Unique drag session identifier (typically a UUID).\n * @param rows      - Rows being dragged.\n */\nexport function registerDragSession(sessionId: string, rows: readonly unknown[]): void {\n  const refs: WeakRef<object>[] = [];\n  let hasPrimitives = false;\n  for (const row of rows) {\n    if (row !== null && typeof row === 'object') {\n      refs.push(new WeakRef(row as object));\n    } else {\n      hasPrimitives = true;\n    }\n  }\n  registry.set(sessionId, { refs, hasPrimitives });\n}\n\n/**\n * Look up the live row references for a drag session.\n *\n * Returns `undefined` when the caller MUST fall back to the JSON payload:\n *   - the session is unknown,\n *   - any registered reference has been garbage-collected (partial recovery\n *     would silently corrupt cross-grid moves), or\n *   - the session contains primitive rows (which cannot be held weakly).\n */\nexport function lookupDragSession<T = unknown>(sessionId: string): T[] | undefined {\n  const entry = registry.get(sessionId);\n  if (!entry) return undefined;\n  if (entry.hasPrimitives) return undefined; // primitives — caller falls back to JSON\n  const result: unknown[] = [];\n  for (const ref of entry.refs) {\n    const obj = ref.deref();\n    if (obj === undefined) return undefined; // GC'd — caller falls back to JSON\n    result.push(obj);\n  }\n  return result as T[];\n}\n\n/**\n * Clear a drag session from the registry.\n * Should be called from `dragend` on the source grid.\n */\nexport function clearDragSession(sessionId: string): void {\n  registry.delete(sessionId);\n}\n\n/**\n * @internal Test-only — clear all sessions.\n */\nexport function _clearAllDragSessions(): void {\n  registry.clear();\n}\n\n/**\n * Generate a unique drag session identifier.\n *\n * Used as a Map key to recover live row references for in-process drags; this\n * is **not** a security context. Uses `crypto.randomUUID()` when available\n * (modern browsers in secure contexts, Node 19+, Bun) and falls back to\n * `crypto.getRandomValues()` for older non-secure contexts. `Math.random()`\n * is intentionally avoided to keep CodeQL clean.\n */\nexport function newDragSessionId(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return crypto.randomUUID();\n  }\n  if (typeof crypto !== 'undefined' && typeof crypto.getRandomValues === 'function') {\n    const buf = new Uint32Array(2);\n    crypto.getRandomValues(buf);\n    return `drag-${Date.now().toString(36)}-${buf[0].toString(36)}${buf[1].toString(36)}`;\n  }\n  // Final fallback: timestamp + monotonically incrementing counter (no PRNG).\n  // Sufficient because the registry is in-process and lives only for the\n  // duration of a single drag.\n  return `drag-${Date.now().toString(36)}-${(++fallbackCounter).toString(36)}`;\n}\n\nlet fallbackCounter = 0;\n","// #region Environment Helpers\n\n/**\n * Check if we're running in a development environment.\n * Returns true for localhost or when NODE_ENV !== 'production'.\n * Used to show warnings only in development.\n */\nexport function isDevelopment(): boolean {\n  // Check for localhost (browser environment)\n  if (typeof window !== 'undefined' && window.location) {\n    const hostname = window.location.hostname;\n    if (hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '::1') {\n      return true;\n    }\n  }\n  // Check for NODE_ENV (build-time or SSR)\n  if (typeof process !== 'undefined' && process.env?.NODE_ENV !== 'production') {\n    return true;\n  }\n  return false;\n}\n\n// #endregion\n\n// #region Cell Rendering Helpers\n\n/**\n * Generate accessible HTML for a boolean cell.\n * Uses role=\"checkbox\" with proper aria attributes.\n */\nexport function booleanCellHTML(value: boolean): string {\n  return `<span role=\"checkbox\" aria-checked=\"${value}\" aria-label=\"${value}\">${value ? '&#x1F5F9;' : '&#9744;'}</span>`;\n}\n\n/**\n * Format a date value for display.\n * Handles Date objects, timestamps, and date strings.\n * Returns empty string for invalid dates.\n */\nexport function formatDateValue(value: unknown): string {\n  if (value == null || value === '') return '';\n  if (value instanceof Date) {\n    return isNaN(value.getTime()) ? '' : value.toLocaleDateString();\n  }\n  if (typeof value === 'number' || typeof value === 'string') {\n    const d = new Date(value);\n    return isNaN(d.getTime()) ? '' : d.toLocaleDateString();\n  }\n  return '';\n}\n\n/**\n * Get the row index from a cell element's data-row attribute.\n * Falls back to calculating from parent row's DOM position if data-row is missing.\n * Returns -1 if no valid row index is found.\n */\nexport function getRowIndexFromCell(cell: Element | null): number {\n  if (!cell) return -1;\n  const attr = cell.getAttribute('data-row');\n  if (attr) return parseInt(attr, 10);\n\n  // Fallback: find the parent .data-grid-row and calculate index from siblings\n  const rowEl = cell.closest('.data-grid-row');\n  if (!rowEl) return -1;\n\n  const parent = rowEl.parentElement;\n  if (!parent) return -1;\n\n  // Get all data-grid-row siblings and find this row's index\n  const rows = parent.querySelectorAll(':scope > .data-grid-row');\n  for (let i = 0; i < rows.length; i++) {\n    if (rows[i] === rowEl) return i;\n  }\n  return -1;\n}\n\n/**\n * Get the column index from a cell element's data-col attribute.\n * Returns -1 if no valid column index is found.\n */\nexport function getColIndexFromCell(cell: Element | null): number {\n  if (!cell) return -1;\n  const attr = cell.getAttribute('data-col');\n  return attr ? parseInt(attr, 10) : -1;\n}\n\n/**\n * Clear all cell-focus styling from a root element.\n * Used when changing focus or when selection plugin takes over focus management.\n */\nexport function clearCellFocus(root: Element | null): void {\n  if (!root) return;\n  root.querySelectorAll('.cell-focus').forEach((el) => el.classList.remove('cell-focus'));\n}\n// #endregion\n\n// #region RTL Helpers\n\n/** Text direction */\nexport type TextDirection = 'ltr' | 'rtl';\n\n/**\n * Get the text direction for an element.\n * Reads from the computed style, which respects the `dir` attribute on the element\n * or any ancestor, as well as CSS `direction` property.\n *\n * @param element - The element to check direction for\n * @returns 'ltr' or 'rtl'\n *\n * @example\n * ```typescript\n * // Detect grid's direction\n * const dir = getDirection(gridElement);\n * if (dir === 'rtl') {\n *   // Handle RTL layout\n * }\n * ```\n */\nexport function getDirection(element: Element): TextDirection {\n  // Try computed style first (works in real browsers)\n  try {\n    const computedDir = getComputedStyle(element).direction;\n    if (computedDir === 'rtl') return 'rtl';\n  } catch {\n    // getComputedStyle may fail in some test environments\n  }\n\n  // Fallback: check dir attribute on element or ancestors\n  // This handles test environments where getComputedStyle may not reflect dir attribute\n  try {\n    const dirAttr = element.closest?.('[dir]')?.getAttribute('dir');\n    if (dirAttr === 'rtl') return 'rtl';\n  } catch {\n    // closest may not be available on mock elements\n  }\n\n  return 'ltr';\n}\n\n/**\n * Check if an element is in RTL mode.\n *\n * @param element - The element to check\n * @returns true if the element's text direction is right-to-left\n */\nexport function isRTL(element: Element): boolean {\n  return getDirection(element) === 'rtl';\n}\n\n/**\n * Resolve a logical inline position to a physical position based on text direction.\n *\n * - `'start'` → `'left'` in LTR, `'right'` in RTL\n * - `'end'` → `'right'` in LTR, `'left'` in RTL\n * - `'left'` / `'right'` → unchanged (physical values)\n *\n * @param position - Logical or physical position\n * @param direction - Text direction ('ltr' or 'rtl')\n * @returns Physical position ('left' or 'right')\n *\n * @example\n * ```typescript\n * resolveInlinePosition('start', 'ltr'); // 'left'\n * resolveInlinePosition('start', 'rtl'); // 'right'\n * resolveInlinePosition('left', 'rtl');  // 'left' (unchanged)\n * ```\n */\nexport function resolveInlinePosition(\n  position: 'left' | 'right' | 'start' | 'end',\n  direction: TextDirection,\n): 'left' | 'right' {\n  if (position === 'left' || position === 'right') {\n    return position;\n  }\n  if (direction === 'rtl') {\n    return position === 'start' ? 'right' : 'left';\n  }\n  return position === 'start' ? 'left' : 'right';\n}\n// #endregion\n","/**\n * Row Virtualization Module\n *\n * Provides all virtualization-related functionality for the grid:\n *\n * 1. **Position Cache** (index-based): Maps row index → {offset, height, measured}\n *    - Rebuilt when row count changes (expand/collapse, filter)\n *    - Used for scroll position → row index lookups (binary search)\n *\n * 2. **Height Cache** (identity-based): Maps row identity → height\n *    - Persists across expand/collapse\n *    - Uses rowId string keys when available, WeakMap otherwise\n *    - Synthetic rows use __rowCacheKey for stable identity\n *\n * 3. **Virtual Window**: Computes which rows to render based on scroll position\n *\n * 4. **Row Measurement**: Measures rendered row heights from DOM\n */\n\n// #region Types\n\n/**\n * Position entry for a single row in the position cache.\n * @category Plugin Development\n */\nexport interface RowPosition {\n  /** Cumulative offset from top in pixels */\n  offset: number;\n  /** Row height in pixels */\n  height: number;\n  /** Whether this is a measured value (true) or estimate (false) */\n  measured: boolean;\n}\n\n/**\n * Height cache that persists row heights across position cache rebuilds.\n * Uses dual storage: Map for string keys (rowId, __rowCacheKey) and WeakMap for object refs.\n * @category Plugin Development\n */\nexport interface HeightCache {\n  /** Heights keyed by string (for synthetic rows with __rowCacheKey or rowId-keyed rows) */\n  byKey: Map<string, number>;\n  /** Heights keyed by object reference (for data rows without rowId) */\n  byRef: WeakMap<object, number>;\n}\n\n/**\n * Configuration for the position cache.\n */\nexport interface PositionCacheConfig<T = unknown> {\n  /** Function to get row ID (if configured) */\n  rowId?: (row: T) => string | number;\n}\n\n// #endregion\n\n// #region Height Cache Operations\n\n/**\n * Create a new empty height cache.\n */\nexport function createHeightCache(): HeightCache {\n  return {\n    byKey: new Map(),\n    byRef: new WeakMap(),\n  };\n}\n\n/**\n * Get the cache key for a row.\n * Returns string for synthetic rows (__rowCacheKey) or rowId-keyed rows,\n * or the row object itself for WeakMap lookup.\n */\nexport function getRowCacheKey<T>(row: T, rowId?: (row: T) => string | number): string | T {\n  if (!row || typeof row !== 'object') return row;\n\n  // 1. Synthetic rows: plugins MUST add __rowCacheKey\n  if ('__rowCacheKey' in row) {\n    return (row as { __rowCacheKey: string }).__rowCacheKey;\n  }\n\n  // 2. rowId property directly on the row (common pattern)\n  if ('rowId' in row && (row as { rowId: string | number }).rowId != null) {\n    return `id:${(row as { rowId: string | number }).rowId}`;\n  }\n\n  // 3. User-provided rowId function (if configured)\n  if (rowId) {\n    return `id:${rowId(row)}`;\n  }\n\n  // 4. Object identity (for WeakMap)\n  return row;\n}\n\n/**\n * Get cached height for a row.\n * @returns Cached height or undefined if not cached\n */\nexport function getCachedHeight<T>(\n  cache: HeightCache,\n  row: T,\n  rowId?: (row: T) => string | number,\n): number | undefined {\n  const key = getRowCacheKey(row, rowId);\n\n  if (typeof key === 'string') {\n    return cache.byKey.get(key);\n  }\n\n  // Object key - use WeakMap\n  if (key && typeof key === 'object') {\n    return cache.byRef.get(key);\n  }\n\n  return undefined;\n}\n\n/**\n * Set cached height for a row.\n */\nexport function setCachedHeight<T>(\n  cache: HeightCache,\n  row: T,\n  height: number,\n  rowId?: (row: T) => string | number,\n): void {\n  const key = getRowCacheKey(row, rowId);\n\n  if (typeof key === 'string') {\n    cache.byKey.set(key, height);\n  } else if (key && typeof key === 'object') {\n    cache.byRef.set(key, height);\n  }\n}\n\n// #endregion\n\n// #region Position Cache Operations\n\n/**\n * Rebuild position cache preserving known heights from height cache.\n * Called when row count changes (expand/collapse, filter, data change).\n *\n * @param rows - Array of row data\n * @param heightCache - Height cache with persisted measurements\n * @param estimatedHeight - Estimated height for unmeasured rows\n * @param config - Position cache configuration\n * @param getPluginHeight - Optional function to get height from plugins\n * @returns New position cache\n */\nexport function rebuildPositionCache<T>(\n  rows: T[],\n  heightCache: HeightCache,\n  estimatedHeight: number,\n  config: PositionCacheConfig<T>,\n  getPluginHeight?: (row: T, index: number) => number | undefined,\n): RowPosition[] {\n  const cache: RowPosition[] = new Array(rows.length);\n  let offset = 0;\n\n  for (let i = 0; i < rows.length; i++) {\n    const row = rows[i];\n\n    // Height resolution order:\n    // 1. Plugin's getRowHeight() (for synthetic rows with known heights)\n    let height = getPluginHeight?.(row, i);\n    let measured = height !== undefined;\n\n    // 2. Cached height from previous measurements\n    if (height === undefined) {\n      height = getCachedHeight(heightCache, row, config.rowId);\n      measured = height !== undefined;\n    }\n\n    // 3. Fall back to estimate\n    if (height === undefined) {\n      height = estimatedHeight;\n      measured = false;\n    }\n\n    cache[i] = { offset, height, measured };\n    offset += height;\n  }\n\n  return cache;\n}\n\n/**\n * Update a single row's height in the position cache.\n * Recalculates offsets for all subsequent rows.\n *\n * @param cache - Position cache to update\n * @param index - Row index to update\n * @param newHeight - New measured height\n */\nexport function updateRowHeight(cache: RowPosition[], index: number, newHeight: number): void {\n  if (index < 0 || index >= cache.length) return;\n\n  const entry = cache[index];\n  const heightDiff = newHeight - entry.height;\n\n  // Latch `measured` even when the height is unchanged, otherwise callers that enqueue on\n  // `!measured` re-measure the same row on every render pass.\n  entry.measured = true;\n\n  if (heightDiff === 0) return;\n\n  // Update this row\n  entry.height = newHeight;\n\n  // Recalculate offsets for all subsequent rows\n  for (let i = index + 1; i < cache.length; i++) {\n    cache[i].offset += heightDiff;\n  }\n}\n\nexport interface RowHeightChange {\n  /** Row index into the position cache. */\n  index: number;\n  /** Measured height in pixels. */\n  height: number;\n}\n\n/**\n * Update multiple row heights while recalculating the affected cache suffix once.\n *\n * @param cache - Position cache to update (mutated in place)\n * @param changes - Height changes in any order; each row index should occur at most once\n */\nexport function updateRowHeights(cache: RowPosition[], changes: RowHeightChange[]): void {\n  if (changes.length === 0 || cache.length === 0) return;\n\n  // Callers usually collect in DOM order, which is already ascending — skip the copy then.\n  let sortedChanges = changes;\n  for (let i = 1; i < changes.length; i++) {\n    if (changes[i].index < changes[i - 1].index) {\n      sortedChanges = [...changes].sort((a, b) => a.index - b.index);\n      break;\n    }\n  }\n\n  let changeIndex = 0;\n  while (changeIndex < sortedChanges.length && sortedChanges[changeIndex].index < 0) changeIndex++;\n  if (changeIndex >= sortedChanges.length || sortedChanges[changeIndex].index >= cache.length) return;\n\n  let cumulativeDiff = 0;\n  const firstChangedIndex = sortedChanges[changeIndex].index;\n  for (let index = firstChangedIndex; index < cache.length; index++) {\n    const entry = cache[index];\n    entry.offset += cumulativeDiff;\n\n    while (changeIndex < sortedChanges.length && sortedChanges[changeIndex].index === index) {\n      const height = sortedChanges[changeIndex].height;\n      const heightDiff = height - entry.height;\n      entry.measured = true;\n      if (heightDiff !== 0) {\n        entry.height = height;\n        cumulativeDiff += heightDiff;\n      }\n      changeIndex++;\n    }\n  }\n}\n\n/**\n * Get total content height from position cache.\n *\n * @param cache - Position cache\n * @returns Total height in pixels\n */\nexport function getTotalHeight(cache: RowPosition[]): number {\n  if (cache.length === 0) return 0;\n  const last = cache[cache.length - 1];\n  return last.offset + last.height;\n}\n\n// #endregion\n\n// #region Binary Search\n\n/**\n * Find the row index at a given scroll offset using binary search.\n * Returns the index of the row that contains the given pixel offset.\n *\n * @param cache - Position cache\n * @param targetOffset - Scroll offset in pixels\n * @returns Row index at that offset, or -1 if cache is empty\n */\nexport function getRowIndexAtOffset(cache: RowPosition[], targetOffset: number): number {\n  if (cache.length === 0) return -1;\n  if (targetOffset <= 0) return 0;\n\n  let low = 0;\n  let high = cache.length - 1;\n\n  while (low <= high) {\n    const mid = Math.floor((low + high) / 2);\n    const entry = cache[mid];\n    const entryEnd = entry.offset + entry.height;\n\n    if (targetOffset < entry.offset) {\n      high = mid - 1;\n    } else if (targetOffset >= entryEnd) {\n      low = mid + 1;\n    } else {\n      // targetOffset is within this row\n      return mid;\n    }\n  }\n\n  // Return the closest row (low will be just past the target)\n  return Math.max(0, Math.min(low, cache.length - 1));\n}\n\n// #endregion\n\n// #region Statistics\n\n/**\n * Calculate the average measured height.\n * Used for estimating unmeasured rows.\n *\n * @param cache - Position cache\n * @param defaultHeight - Default height to use if no measurements\n * @returns Average measured height\n */\nexport function calculateAverageHeight(cache: RowPosition[], defaultHeight: number): number {\n  let totalHeight = 0;\n  let measuredCount = 0;\n\n  for (const entry of cache) {\n    if (entry.measured) {\n      totalHeight += entry.height;\n      measuredCount++;\n    }\n  }\n\n  return measuredCount > 0 ? totalHeight / measuredCount : defaultHeight;\n}\n\n/**\n * Count how many rows have been measured.\n *\n * @param cache - Position cache\n * @returns Number of measured rows\n */\nexport function countMeasuredRows(cache: RowPosition[]): number {\n  let count = 0;\n  for (const entry of cache) {\n    if (entry.measured) count++;\n  }\n  return count;\n}\n\n// #endregion\n// #region Row Measurement\n\n/**\n * Result of measuring rendered row heights.\n */\nexport interface RowMeasurementResult {\n  /** Whether any heights changed */\n  hasChanges: boolean;\n  /** Updated measured row count */\n  measuredCount: number;\n  /** Updated average height */\n  averageHeight: number;\n}\n\n/**\n * Context for measuring rendered rows.\n */\nexport interface RowMeasurementContext<T> {\n  /** Position cache to update */\n  positionCache: RowPosition[];\n  /** Height cache for persistence */\n  heightCache: HeightCache;\n  /** Row data array */\n  rows: T[];\n  /** Default row height */\n  defaultHeight: number;\n  /** Start index of rendered window */\n  start: number;\n  /** End index of rendered window (exclusive) */\n  end: number;\n  /** Function to get plugin height for a row */\n  getPluginHeight?: (row: T, index: number) => number | undefined;\n  /** Function to get row ID for height cache keying */\n  getRowId?: (row: T) => string | number;\n}\n\n/**\n * Measure rendered row heights from DOM elements and update caches.\n * Returns measurement statistics for updating virtualization state.\n *\n * @param context - Measurement context with all dependencies\n * @param rowElements - NodeList of rendered row elements\n * @returns Measurement result with flags and statistics\n */\nexport function measureRenderedRowHeights<T>(\n  context: RowMeasurementContext<T>,\n  rowElements: NodeListOf<Element>,\n): RowMeasurementResult {\n  const { positionCache, heightCache, rows, start, end, getPluginHeight, getRowId } = context;\n\n  let hasChanges = false;\n  const heightChanges: RowHeightChange[] = [];\n\n  rowElements.forEach((rowEl) => {\n    const rowIndexStr = (rowEl as HTMLElement).dataset.rowIndex;\n    if (!rowIndexStr) return;\n\n    const rowIndex = parseInt(rowIndexStr, 10);\n    if (rowIndex < start || rowIndex >= end || rowIndex >= rows.length) return;\n\n    const row = rows[rowIndex];\n\n    // Check if a plugin provides the height for this row\n    const pluginHeight = getPluginHeight?.(row, rowIndex);\n\n    if (pluginHeight !== undefined) {\n      // Plugin provides height - use it for position cache\n      const currentEntry = positionCache[rowIndex];\n      if (!currentEntry.measured || Math.abs(currentEntry.height - pluginHeight) > 1) {\n        heightChanges.push({ index: rowIndex, height: pluginHeight });\n        hasChanges = true;\n      }\n      return; // Don't measure DOM for plugin-managed rows\n    }\n\n    // No plugin height - use DOM measurement\n    const measuredHeight = (rowEl as HTMLElement).offsetHeight;\n\n    if (measuredHeight > 0) {\n      const currentEntry = positionCache[rowIndex];\n\n      // Only update if height differs significantly (> 1px to avoid oscillation)\n      if (!currentEntry.measured || Math.abs(currentEntry.height - measuredHeight) > 1) {\n        heightChanges.push({ index: rowIndex, height: measuredHeight });\n        setCachedHeight(heightCache, row, measuredHeight, getRowId);\n        hasChanges = true;\n      }\n    }\n  });\n\n  updateRowHeights(positionCache, heightChanges);\n\n  // Recompute stats\n  const measuredCount = hasChanges ? countMeasuredRows(positionCache) : 0;\n  const averageHeight = hasChanges ? calculateAverageHeight(positionCache, context.defaultHeight) : 0;\n\n  return { hasChanges, measuredCount, averageHeight };\n}\n\n/**\n * Compute measurement statistics for a position cache, excluding plugin-managed rows.\n * Used after rebuilding position cache to get accurate averages for non-plugin rows.\n *\n * @param cache - Position cache\n * @param rows - Row data array\n * @param defaultHeight - Default height if no measurements\n * @param getPluginHeight - Function to check if plugin manages row height\n * @returns Object with measured count and average height\n */\nexport function computeAverageExcludingPluginRows<T>(\n  cache: RowPosition[],\n  rows: T[],\n  defaultHeight: number,\n  getPluginHeight?: (row: T, index: number) => number | undefined,\n): { measuredCount: number; averageHeight: number } {\n  let measuredCount = 0;\n  let totalMeasured = 0;\n\n  for (let i = 0; i < cache.length; i++) {\n    const entry = cache[i];\n    if (entry.measured) {\n      // Only include in average if plugin doesn't provide height for this row\n      const pluginHeight = getPluginHeight?.(rows[i], i);\n      if (pluginHeight === undefined) {\n        totalMeasured += entry.height;\n        measuredCount++;\n      }\n    }\n  }\n\n  return {\n    measuredCount,\n    averageHeight: measuredCount > 0 ? totalMeasured / measuredCount : defaultHeight,\n  };\n}\n\n// #endregion\n\n// #region Scroll Mapping (max element-height cap)\n\n/**\n * Maximum spacer element height (px) before browsers cap the rendered height.\n *\n * Chromium's hard cap is `2^25 = 33,554,432` px; Firefox/Safari are similar or larger.\n * We pick `33,500,000` — ~54 KB of headroom under Chromium's cap so that floating-point\n * drift in the fractional mapping math (`scrollTop * rMax / sMax`) cannot push a computed\n * spacer position past the engine cap and silently truncate.\n *\n * For datasets where `totalRows * rowHeight` exceeds this value, the faux-vscroll\n * spacer would silently truncate, making the tail of the dataset unreachable via\n * the native scrollbar / `Ctrl+End`. The grid switches to fractional scroll mapping\n * above this threshold — see {@link computeScrollMapping}.\n *\n * @category Plugin Development\n * @since 2.13.0\n */\nexport const MAX_ELEMENT_HEIGHT_PX = 33_500_000;\n\n/**\n * Mapping between native `scrollTop` (clamped spacer space) and \"virtual\" scroll\n * position (raw row-content space). See {@link computeScrollMapping}.\n *\n * @category Plugin Development\n * @since 2.13.0\n */\nexport interface ScrollMapping {\n  /** Raw row-content height in pixels (totalRows * rowHeight or sum of variable heights). */\n  rawContentHeight: number;\n  /** Effective spacer DOM height — `min(rawContentHeight, maxSpacerHeight)`. */\n  spacerHeight: number;\n  /** Viewport height used for computing scrollable extents. */\n  viewportHeight: number;\n  /** True when `rawContentHeight > maxSpacerHeight` — fractional mapping is active. */\n  capped: boolean;\n}\n\n/**\n * Compute a mapping between the spacer's native scrollTop and the virtual\n * row-content scroll offset.\n *\n * For datasets within `maxSpacerHeight`, mapping is identity (no transform).\n * Above the cap, the spacer is clamped and `scrollTop` units no longer equal\n * row-content units — call {@link toVirtualScrollTop} / {@link fromVirtualScrollTop}\n * to translate between the two coordinate spaces.\n *\n * @category Plugin Development\n * @since 2.13.0\n */\nexport function computeScrollMapping(\n  rawContentHeight: number,\n  viewportHeight: number,\n  maxSpacerHeight = MAX_ELEMENT_HEIGHT_PX,\n): ScrollMapping {\n  const spacerHeight = Math.min(rawContentHeight, maxSpacerHeight);\n  return {\n    rawContentHeight,\n    spacerHeight,\n    viewportHeight,\n    capped: rawContentHeight > maxSpacerHeight,\n  };\n}\n\n/**\n * Translate a native `scrollTop` (spacer space) into a virtual scroll offset\n * in raw row-content space. Identity when the mapping is not capped.\n *\n * The result is clamped to `[0, rawContentHeight - viewportHeight]` so callers\n * never index past the dataset, even when the spacer's actual scrollable extent\n * slightly exceeds `spacerHeight - viewportHeight` (e.g. when a horizontal scrollbar\n * adds bottom padding to the faux spacer).\n *\n * @category Plugin Development\n * @since 2.13.0\n */\nexport function toVirtualScrollTop(scrollTop: number, mapping: ScrollMapping): number {\n  if (!mapping.capped) return scrollTop;\n  const sMax = mapping.spacerHeight - mapping.viewportHeight;\n  const rMax = mapping.rawContentHeight - mapping.viewportHeight;\n  if (sMax <= 0 || rMax <= 0) return scrollTop;\n  const virtual = (scrollTop * rMax) / sMax;\n  if (virtual < 0) return 0;\n  if (virtual > rMax) return rMax;\n  return virtual;\n}\n\n/**\n * Translate a virtual scroll offset (raw row-content space) into a native\n * `scrollTop` value (spacer space). Identity when the mapping is not capped.\n *\n * @category Plugin Development\n * @since 2.13.0\n */\nexport function fromVirtualScrollTop(virtualTop: number, mapping: ScrollMapping): number {\n  if (!mapping.capped) return virtualTop;\n  const sMax = mapping.spacerHeight - mapping.viewportHeight;\n  const rMax = mapping.rawContentHeight - mapping.viewportHeight;\n  if (sMax <= 0 || rMax <= 0) return virtualTop;\n  return (virtualTop * sMax) / rMax;\n}\n\n/**\n * Identity scroll mapping (no cap applied). Useful as a default in places that\n * don't yet know the dataset extents. `viewportHeight` is `0` until the first\n * `calculateTotalSpacerHeight` call populates the real extents — safe because\n * `capped: false` short-circuits both translation helpers before they read it.\n *\n * @category Plugin Development\n * @since 2.13.0\n */\nexport function createIdentityScrollMapping(): ScrollMapping {\n  return { rawContentHeight: 0, spacerHeight: 0, viewportHeight: 0, capped: false };\n}\n\n// #endregion\n\n// #region Scroll Transform\n\n/**\n * Sub-pixel `translateY` for the `.rows` element at a given native scroll position.\n *\n * Bypass mode (all rows rendered) tracks the raw scroll offset directly. Virtualized mode\n * offsets only the remainder past the window's first row, and rounds that start down to an\n * even index so DOM `nth-child(even)` zebra parity keeps matching data-row parity.\n *\n * @param v Virtual state (structural subset of `VirtualState`).\n * @param rawScrollTop Native `scrollTop` of the faux scrollbar (clamped spacer space).\n */\nexport function computeRowsTranslateY(\n  v: {\n    rowHeight: number;\n    bypassThreshold: number;\n    variableHeights: boolean;\n    positionCache: RowPosition[] | null;\n    scrollMapping: ScrollMapping;\n  },\n  totalRows: number,\n  rawScrollTop: number,\n): number {\n  if (totalRows <= v.bypassThreshold) return -rawScrollTop;\n\n  const currentScrollTop = toVirtualScrollTop(rawScrollTop, v.scrollMapping);\n  const cache = v.positionCache;\n  let startRowOffset: number;\n\n  if (v.variableHeights && cache && cache.length > 0) {\n    let rawStart = getRowIndexAtOffset(cache, currentScrollTop);\n    if (rawStart === -1) rawStart = 0;\n    const evenAlignedStart = rawStart - (rawStart % 2);\n    startRowOffset = cache[evenAlignedStart]?.offset ?? evenAlignedStart * v.rowHeight;\n  } else {\n    const rawStart = Math.floor(currentScrollTop / v.rowHeight);\n    startRowOffset = (rawStart - (rawStart % 2)) * v.rowHeight;\n  }\n\n  return -(currentScrollTop - startRowOffset);\n}\n\n// #endregion\n\n// #region Fixed-Height Virtual Window\n\n/**\n * Result of computing a virtual window for fixed-height rows.\n * Used by plugins like FilteringPlugin for virtualized dropdowns.\n */\nexport interface VirtualWindow {\n  /** First row index to render (inclusive) */\n  start: number;\n  /** Last row index to render (exclusive) */\n  end: number;\n  /** Pixel offset to apply to the rows container (translateY) */\n  offsetY: number;\n  /**\n   * Effective spacer DOM height — use this for the scrollable spacer element.\n   * Equal to `min(totalRows * rowHeight, maxSpacerHeight)`. Above the cap this\n   * is clamped; use {@link VirtualWindow.rawContentHeight} for the un-clamped value.\n   */\n  totalHeight: number;\n  /**\n   * Raw, un-clamped row-content height (`totalRows * rowHeight`). Equal to\n   * `totalHeight` when the dataset is below `maxSpacerHeight`.\n   *\n   * @since 2.13.0\n   */\n  rawContentHeight: number;\n}\n\n/** Parameters for computing the virtual window */\nexport interface VirtualWindowParams {\n  /** Total number of rows */\n  totalRows: number;\n  /** Height of the viewport in pixels */\n  viewportHeight: number;\n  /** Current scroll top position */\n  scrollTop: number;\n  /** Height of each row in pixels */\n  rowHeight: number;\n  /** Number of extra rows to render above/below viewport */\n  overscan: number;\n  /**\n   * Optional cap on the spacer's DOM height. When `totalRows * rowHeight` exceeds\n   * this value, `scrollTop` is treated as a spacer-space position and translated\n   * to virtual row-content space via fractional mapping. Defaults to {@link MAX_ELEMENT_HEIGHT_PX}.\n   * Pass `Infinity` to disable.\n   *\n   * @since 2.13.0\n   */\n  maxSpacerHeight?: number;\n}\n\n/**\n * Compute the virtual row window based on scroll position and viewport.\n * Simple fixed-height implementation for plugins needing basic virtualization.\n *\n * For datasets where `totalRows * rowHeight > maxSpacerHeight`, scroll position\n * is mapped fractionally so the entire dataset stays reachable past the browser's\n * single-element height cap (Chromium ~33.5M px). See {@link computeScrollMapping}.\n *\n * @param params - Parameters for computing the window\n * @returns VirtualWindow with start/end indices and transforms\n */\nexport function computeVirtualWindow(params: VirtualWindowParams): VirtualWindow {\n  const { totalRows, viewportHeight, scrollTop, rowHeight, overscan, maxSpacerHeight = MAX_ELEMENT_HEIGHT_PX } = params;\n\n  const visibleRows = Math.ceil(viewportHeight / rowHeight);\n  const rawContentHeight = totalRows * rowHeight;\n  const mapping = computeScrollMapping(rawContentHeight, viewportHeight, maxSpacerHeight);\n  const virtualScrollTop = toVirtualScrollTop(scrollTop, mapping);\n\n  // Render overscan rows in each direction (total window = visible + 2*overscan)\n  let start = Math.floor(virtualScrollTop / rowHeight) - overscan;\n  if (start < 0) start = 0;\n\n  let end = start + visibleRows + overscan * 2;\n  if (end > totalRows) end = totalRows;\n\n  // Ensure start is adjusted if we hit the end\n  if (end === totalRows && start > 0) {\n    start = Math.max(0, end - visibleRows - overscan * 2);\n  }\n\n  return {\n    start,\n    end,\n    offsetY: start * rowHeight,\n    totalHeight: mapping.spacerHeight,\n    rawContentHeight,\n  };\n}\n\n/**\n * Determine if virtualization should be bypassed for small datasets.\n * When there are very few items, the overhead of virtualization isn't worth it.\n *\n * @param totalRows - Total number of items\n * @param threshold - Bypass threshold (skip virtualization if totalRows <= threshold)\n * @returns True if virtualization should be bypassed\n */\nexport function shouldBypassVirtualization(totalRows: number, threshold: number): boolean {\n  return totalRows <= threshold;\n}\n\n// #endregion\n","/**\n * Central keyboard handler attached to the host element. Manages navigation, paging,\n * and edit lifecycle triggers while respecting active form field interactions.\n */\nimport { FOCUSABLE_EDITOR_SELECTOR, GridClasses } from '../constants';\nimport type { GridHost } from '../types';\nimport { clearCellFocus, isRTL } from './utils';\nimport { readCellField } from './value-accessor';\nimport { fromVirtualScrollTop, getRowIndexAtOffset, toVirtualScrollTop } from './virtualization';\n\n/** Commit active row edit if the editing plugin provides this method. */\nfunction tryCommitEdit(grid: GridHost): void {\n  if (typeof grid.commitActiveRowEdit === 'function') grid.commitActiveRowEdit();\n}\n\nfunction isFormField(el: HTMLElement | null): boolean {\n  if (!el) return false;\n  const tag = el.tagName;\n  if (tag === 'INPUT' || tag === 'SELECT' || tag === 'TEXTAREA') return true;\n  if (el.isContentEditable) return true;\n  return false;\n}\n\n/** True while a row-scoped edit session is active. */\nfunction isRowEditing(grid: GridHost): boolean {\n  return grid._activeEditRows !== undefined && grid._activeEditRows !== -1;\n}\n\n// #region Keyboard Handler\n/**\n * Guard chain deciding whether this keydown belongs to something other than\n * cell navigation and must be left alone.\n */\nfunction shouldIgnoreKeyDown(grid: GridHost, e: KeyboardEvent, target: HTMLElement | null): boolean {\n  // Keyboard events whose target lives inside the grid host but OUTSIDE the\n  // rows body (toolpanel inputs/buttons, shell-header controls, light-DOM\n  // children of <tbw-grid>) own their own keyboard interactions. Treating\n  // ArrowUp/ArrowDown/Enter on such a target as cell navigation steals the\n  // user's actual interaction target on the very next render cycle.\n  // Cells and the grid host itself remain valid navigation targets.\n  if (target && target !== grid && !target.closest?.('.rows-body')) return true;\n\n  if (isFormField(target)) {\n    switch (e.key) {\n      // Home/End and horizontal arrows navigate within the text input; Enter\n      // and Escape are handled by the input's own handlers first.\n      case 'Home':\n      case 'End':\n      case 'ArrowLeft':\n      case 'ArrowRight':\n      case 'Enter':\n      case 'Escape':\n        return true;\n      case 'ArrowUp':\n      case 'ArrowDown':\n        // Number spinners own the vertical arrows; other fields fall through.\n        if ((target as HTMLInputElement).tagName === 'INPUT' && (target as HTMLInputElement).type === 'number') {\n          return true;\n        }\n        break;\n    }\n  }\n\n  const colType = grid._visibleColumns[grid._focusCol]?.type;\n  return isRowEditing(grid) && colType === 'select' && (e.key === 'ArrowDown' || e.key === 'ArrowUp');\n}\n\n/** Tab / Shift+Tab: advance one cell, wrapping to the next/previous row. */\nfunction navigateTab(grid: GridHost, e: KeyboardEvent, maxRow: number, maxCol: number): void {\n  e.preventDefault();\n  if (!e.shiftKey) {\n    if (grid._focusCol < maxCol) {\n      grid._focusCol += 1;\n      return;\n    }\n    tryCommitEdit(grid);\n    if (grid._focusRow < maxRow) {\n      grid._focusRow += 1;\n      grid._focusCol = 0;\n    }\n    return;\n  }\n  if (grid._focusCol > 0) {\n    grid._focusCol -= 1;\n  } else if (grid._focusRow > 0) {\n    if (grid._activeEditRows === grid._focusRow) tryCommitEdit(grid);\n    grid._focusRow -= 1;\n    grid._focusCol = maxCol;\n  }\n}\n\n/**\n * ArrowLeft/ArrowRight. `towardEnd` is the LOGICAL direction (ArrowRight); in\n * RTL the physical arrow maps to the opposite column index.\n */\nfunction navigateHorizontal(grid: GridHost, e: KeyboardEvent, maxCol: number, towardEnd: boolean): void {\n  const forward = isRTL(grid) ? !towardEnd : towardEnd;\n  grid._focusCol = forward ? Math.min(maxCol, grid._focusCol + 1) : Math.max(0, grid._focusCol - 1);\n  e.preventDefault();\n}\n\n/** Commit any active row edit, then focus the first/last row (column unchanged). */\nfunction jumpToRowEdge(grid: GridHost, maxRow: number, toEnd: boolean): void {\n  if (isRowEditing(grid)) tryCommitEdit(grid);\n  grid._focusRow = toEnd ? maxRow : 0;\n}\n\n/** ArrowUp/ArrowDown: one row, or the first/last row with Ctrl/Cmd. */\nfunction navigateVertical(grid: GridHost, e: KeyboardEvent, maxRow: number, down: boolean): void {\n  if (e.ctrlKey || e.metaKey) jumpToRowEdge(grid, maxRow, down);\n  else {\n    if (isRowEditing(grid)) tryCommitEdit(grid);\n    grid._focusRow = down ? Math.min(maxRow, grid._focusRow + 1) : Math.max(0, grid._focusRow - 1);\n  }\n  e.preventDefault();\n}\n\n/**\n * PageUp/PageDown target: one viewport of rows (less any overlay band), so an\n * unconstrained grid pages straight to its edge. 20 rows until layout exists.\n */\nfunction pageTargetRow(grid: GridHost, maxRow: number, down: boolean): number {\n  const from = grid._focusRow;\n  const virt = grid._virtualization;\n  const viewportH = virt?.viewportEl?.clientHeight ?? virt?.container?.clientHeight ?? 0;\n  const offsets = grid._getVerticalScrollOffsets?.(from);\n  const usable = viewportH - Math.max(0, offsets?.top ?? 0) - Math.max(0, offsets?.bottom ?? 0);\n  const pc = virt?.variableHeights ? virt.positionCache : null;\n  let target: number;\n  if (usable > 0 && pc?.[from]) {\n    target = getRowIndexAtOffset(pc, pc[from].offset + (down ? usable : -usable));\n    // A row taller than the viewport would otherwise pin focus in place.\n    if (target === from) target = from + (down ? 1 : -1);\n  } else {\n    const rowH = virt?.rowHeight ?? 0;\n    const step = usable > 0 && rowH > 0 ? Math.max(1, Math.floor(usable / rowH)) : 20;\n    target = from + (down ? step : -step);\n  }\n  return Math.max(0, Math.min(maxRow, target));\n}\n\n/** Home/End (plus Ctrl/Cmd variants which also jump to the first/last row). */\nfunction navigateRowEdge(grid: GridHost, e: KeyboardEvent, maxRow: number, maxCol: number, toEnd: boolean): void {\n  if (e.ctrlKey || e.metaKey) jumpToRowEdge(grid, maxRow, toEnd);\n  grid._focusCol = toEnd ? maxCol : 0;\n  e.preventDefault();\n  ensureCellVisible(grid, toEnd ? { forceScrollRight: true } : { forceScrollLeft: true });\n}\n\n/** Dispatch the unified `cell-activate` event. Returns true when cancelled. */\nfunction emitCellActivate(grid: GridHost, e: KeyboardEvent): boolean {\n  const rowIndex = grid._focusRow;\n  const colIndex = grid._focusCol;\n  const column = grid._visibleColumns[colIndex];\n  const row = grid._rows[rowIndex];\n  const field = column?.field ?? '';\n  const activateEvent = new CustomEvent('cell-activate', {\n    cancelable: true,\n    detail: {\n      rowIndex,\n      colIndex,\n      column,\n      field,\n      value: field && row ? readCellField(row, field) : undefined,\n      row,\n      cellEl: grid.querySelector(`[data-row=\"${rowIndex}\"][data-col=\"${colIndex}\"]`) as HTMLElement | undefined,\n      trigger: 'keyboard' as const,\n      originalEvent: e,\n    },\n  });\n  grid.dispatchEvent(activateEvent);\n  return activateEvent.defaultPrevented;\n}\n\nexport function handleGridKeyDown(grid: GridHost, e: KeyboardEvent): void {\n  // Dispatch to plugin system first - if any plugin handles it, stop here\n  if (grid._dispatchKeyDown?.(e)) return;\n\n  const path = e.composedPath?.() ?? [];\n  const target = (path.length ? path[0] : e.target) as HTMLElement | null;\n  if (shouldIgnoreKeyDown(grid, e, target)) return;\n\n  const maxRow = grid._rows.length - 1;\n  const maxCol = grid._visibleColumns.length - 1;\n\n  switch (e.key) {\n    case 'Tab':\n      navigateTab(grid, e, maxRow, maxCol);\n      break;\n    case 'ArrowDown':\n      navigateVertical(grid, e, maxRow, true);\n      break;\n    case 'ArrowUp':\n      navigateVertical(grid, e, maxRow, false);\n      break;\n    case 'ArrowRight':\n      navigateHorizontal(grid, e, maxCol, true);\n      break;\n    case 'ArrowLeft':\n      navigateHorizontal(grid, e, maxCol, false);\n      break;\n    case 'Home':\n      navigateRowEdge(grid, e, maxRow, maxCol, false);\n      return;\n    case 'End':\n      navigateRowEdge(grid, e, maxRow, maxCol, true);\n      return;\n    case 'PageDown':\n      grid._focusRow = pageTargetRow(grid, maxRow, true);\n      e.preventDefault();\n      break;\n    case 'PageUp':\n      grid._focusRow = pageTargetRow(grid, maxRow, false);\n      e.preventDefault();\n      break;\n    // NOTE: Enter is normally handled by EditingPlugin. If no plugin handled\n    // it, dispatch the unified cell-activate event for custom handling.\n    case 'Enter':\n      if (emitCellActivate(grid, e)) {\n        e.preventDefault();\n        return;\n      }\n      break;\n    default:\n      return;\n  }\n  ensureCellVisible(grid);\n}\n// #endregion\n\n// #region Cell Visibility\n/**\n * Options for ensureCellVisible to control scroll behavior.\n */\ninterface EnsureCellVisibleOptions {\n  /** Force scroll to the leftmost position (for Home key) */\n  forceScrollLeft?: boolean;\n  /** Force scroll to the rightmost position (for End key) */\n  forceScrollRight?: boolean;\n  /** Force horizontal scroll even in edit mode (for Tab navigation) */\n  forceHorizontalScroll?: boolean;\n}\n\n/**\n * Vertical: scroll the virtualized container so the focused row is in view.\n *\n * `y` is in raw row-content space (rowHeight × index). Above the browser height\n * cap (#326), `scrollEl.scrollTop` is in clamped spacer space — the two\n * coordinate systems are not interchangeable, so translate scrollTop into\n * virtual space for the comparison and back into native space when writing.\n * For sub-cap datasets the mapping is identity, so this is a no-op.\n *\n * Plugins that paint over the viewport (sticky rows) report the space they\n * obscure via `_getVerticalScrollOffsets`, so the row lands clear of the\n * overlay instead of underneath it — WCAG 2.2 SC 2.4.11 Focus Not Obscured.\n */\nfunction scrollFocusedRowIntoView(grid: GridHost): void {\n  if (!grid._virtualization?.enabled) return;\n  const { rowHeight, container, viewportEl, scrollMapping } = grid._virtualization;\n  // container is the faux scrollbar element that handles actual scrolling;\n  // viewportEl is the visible area element that has the correct height.\n  const scrollEl = container as HTMLElement | undefined;\n  const visibleHeight = viewportEl?.clientHeight ?? scrollEl?.clientHeight ?? 0;\n  if (!scrollEl || visibleHeight <= 0) return;\n\n  const offsets = grid._getVerticalScrollOffsets?.(grid._focusRow) ?? { top: 0, bottom: 0 };\n  if (offsets.skipScroll) return;\n  // A malformed or oversized report must never invert the visible band.\n  const top = Math.max(0, offsets.top);\n  const bottom = Math.max(0, offsets.bottom);\n  const usableHeight = visibleHeight - top - bottom;\n  if (usableHeight <= 0) return;\n\n  const y = grid._focusRow * rowHeight;\n  const virtualScrollTop = scrollMapping ? toVirtualScrollTop(scrollEl.scrollTop, scrollMapping) : scrollEl.scrollTop;\n  if (y < virtualScrollTop + top) {\n    const target = Math.max(0, y - top);\n    scrollEl.scrollTop = scrollMapping ? fromVirtualScrollTop(target, scrollMapping) : target;\n  } else if (y + rowHeight > virtualScrollTop + top + usableHeight) {\n    const target = Math.max(0, y - usableHeight + rowHeight - top);\n    scrollEl.scrollTop = scrollMapping ? fromVirtualScrollTop(target, scrollMapping) : target;\n  }\n}\n\n/**\n * Resolve the rendered cell for the focused row/col, or `undefined` when the\n * focused row is outside the current virtual window.\n */\nfunction findFocusedCell(grid: GridHost): { rowEl: HTMLElement | null; cell: HTMLElement } | undefined {\n  const rowIndex = grid._focusRow;\n  const vStart = grid._virtualization.start ?? 0;\n  const vEnd = grid._virtualization.end ?? grid._rows.length;\n  if (rowIndex < vStart || rowIndex >= vEnd) return undefined;\n\n  const rowEl = grid._bodyEl.querySelectorAll('.data-grid-row')[rowIndex - vStart] as HTMLElement | null;\n  // Try exact column match first, then query by data-col, then fall back to the\n  // first cell (full-width group rows).\n  let cell = rowEl?.children[grid._focusCol] as HTMLElement | undefined;\n  if (!cell || !cell.classList?.contains('cell')) {\n    cell = (rowEl?.querySelector(`.cell[data-col=\"${grid._focusCol}\"]`) ?? rowEl?.querySelector('.cell[data-col]')) as\n      HTMLElement | undefined;\n  }\n  return cell ? { rowEl: rowEl ?? null, cell } : undefined;\n}\n\n/** Horizontal: bring the focused cell into the `.tbw-scroll-area` viewport. */\nfunction scrollCellIntoViewHorizontally(\n  grid: GridHost,\n  rowEl: HTMLElement | null,\n  cell: HTMLElement,\n  options?: EnsureCellVisibleOptions,\n): void {\n  const scrollArea = grid.querySelector('.tbw-scroll-area') as HTMLElement | null;\n  if (!scrollArea) return;\n\n  // Home/End always scroll to the edge.\n  if (options?.forceScrollLeft) {\n    scrollArea.scrollLeft = 0;\n    return;\n  }\n  if (options?.forceScrollRight) {\n    scrollArea.scrollLeft = scrollArea.scrollWidth - scrollArea.clientWidth;\n    return;\n  }\n\n  // Plugins (e.g. pinned columns) report how much of the scroll area they\n  // obscure, and whether the focused cell should skip scrolling entirely\n  // (pinned cells are always visible).\n  const offsets = grid._getHorizontalScrollOffsets?.(rowEl ?? undefined, cell) ?? { left: 0, right: 0 };\n  if (offsets.skipScroll) return;\n\n  const cellRect = cell.getBoundingClientRect();\n  const scrollAreaRect = scrollArea.getBoundingClientRect();\n  const cellLeft = cellRect.left - scrollAreaRect.left + scrollArea.scrollLeft;\n  const cellRight = cellLeft + cellRect.width;\n  const visibleLeft = scrollArea.scrollLeft + offsets.left;\n  const visibleRight = scrollArea.scrollLeft + scrollArea.clientWidth - offsets.right;\n  if (cellLeft < visibleLeft) {\n    scrollArea.scrollLeft = cellLeft - offsets.left;\n  } else if (cellRight > visibleRight) {\n    scrollArea.scrollLeft = cellRight - scrollArea.clientWidth + offsets.right;\n  }\n}\n\n/** Move real DOM focus to the editor, the cell, or the grid host. */\nfunction applyFocusTarget(grid: GridHost, cell: HTMLElement, isEditing: boolean): void {\n  if (isEditing && cell.classList.contains(GridClasses.EDITING)) {\n    // Editing cell: focus the editor input inside it\n    const focusTarget = cell.querySelector(FOCUSABLE_EDITOR_SELECTOR) as HTMLElement | null;\n    if (focusTarget && document.activeElement !== focusTarget) {\n      try {\n        focusTarget.focus({ preventScroll: true });\n      } catch {\n        /* empty */\n      }\n    }\n    return;\n  }\n\n  if (isEditing) {\n    // Active edit row but this cell isn't the editing cell — focus it so Tab\n    // navigation within the row can attach editors.\n    if (cell.contains(document.activeElement)) return;\n    if (!cell.hasAttribute('tabindex')) cell.setAttribute('tabindex', '-1');\n    try {\n      cell.focus({ preventScroll: true });\n    } catch {\n      /* empty */\n    }\n    return;\n  }\n\n  // NOT editing: keep focus on the grid element (tabindex=0) rather than\n  // individual cells. In a virtualized grid, cells can be detached by\n  // subsequent render cycles (e.g., SelectionPlugin's requestAfterRender\n  // → RAF → row recycling). A detached focused cell causes activeElement\n  // to revert to <body>, breaking keyboard navigation.\n  // Visual focus is managed by the .cell-focus CSS class + data-has-focus.\n  //\n  // BUT: don't steal focus from a real focused descendant (toolpanel\n  // input, shell-header button, registered overlay control). Cell focus\n  // is virtual; if the user is actively typing in a non-cell input, we\n  // must leave that input alone. We only reclaim focus when nothing\n  // meaningful inside the grid currently holds it (active element is\n  // outside grid, on the grid host itself, or on a bare cell).\n  const active = document.activeElement;\n  const meaningful =\n    active instanceof HTMLElement &&\n    active !== grid &&\n    typeof grid.contains === 'function' &&\n    grid.contains(active) &&\n    !active.classList.contains('cell') &&\n    !active.closest('.cell');\n  if (!meaningful && active !== grid) {\n    grid.focus({ preventScroll: true });\n  }\n}\n\n/**\n * Scroll the viewport (virtualized or static) so the focused cell's row is visible\n * and apply visual focus styling / tabindex management.\n */\nexport function ensureCellVisible(grid: GridHost, options?: EnsureCellVisibleOptions): void {\n  scrollFocusedRowIntoView(grid);\n\n  const isEditing = isRowEditing(grid) || !!grid._isGridEditMode;\n  // Skip refreshVirtualWindow when in edit mode to avoid wiping editors\n  if (!isEditing) grid.refreshVirtualWindow(false);\n\n  clearCellFocus(grid._bodyEl);\n  // Clear previous aria-selected markers\n  Array.from(grid._bodyEl.querySelectorAll('[aria-selected=\"true\"]')).forEach((el) => {\n    el.setAttribute('aria-selected', 'false');\n  });\n\n  const focused = findFocusedCell(grid);\n  if (!focused) return;\n  const { rowEl, cell } = focused;\n\n  cell.classList.add('cell-focus');\n  cell.setAttribute('aria-selected', 'true');\n\n  // Skip horizontal scrolling in edit mode to prevent scroll jumps when editors\n  // are created — unless forceHorizontalScroll is set (Tab while editing).\n  if (!isEditing || options?.forceHorizontalScroll) {\n    scrollCellIntoViewHorizontally(grid, rowEl, cell, options);\n  }\n\n  applyFocusTarget(grid, cell, isEditing);\n}\n// #endregion\n","/**\n * Runtime default values for grid configuration.\n *\n * Kept out of `core/types.ts` so that file stays type-only apart from the two\n * enum-like consts whose `type` aliases are derived from them via `typeof`.\n * Import types from `./types`; import the values that back them from here.\n */\n\nimport type { A11yMessages, AnimationConfig, GridIcons } from './types';\n\n/**\n * Default English announcement messages.\n * Used when no custom messages are provided via {@link A11yConfig.messages}.\n * @since 2.0.0\n */\nexport const DEFAULT_A11Y_MESSAGES: Required<A11yMessages> = {\n  sortApplied: (column, direction) => `Sorted by ${column}, ${direction}`,\n  sortCleared: () => 'Sort cleared',\n  filterApplied: (column) => `Filter applied on ${column}`,\n  filterCleared: (column) => `Filter cleared from ${column}`,\n  allFiltersCleared: () => 'All filters cleared',\n  groupExpanded: (name, count) => `Group ${name} expanded, ${count} rows`,\n  groupCollapsed: (name) => `Group ${name} collapsed`,\n  selectionChanged: (count) => `${count} rows selected`,\n  selectAllRows: () => 'Select all rows',\n  selectRow: (rowIndex) => `Select row ${rowIndex + 1}`,\n  columnSelected: (label) => `Column ${label} selected`,\n  columnSelectionChanged: (count) => `${count} columns selected`,\n  columnSelectionCleared: () => 'Column selection cleared',\n  selectionAxisChanged: (toAxis) =>\n    toAxis === 'column'\n      ? 'Row selection cleared, column selection active'\n      : 'Column selection cleared, row selection active',\n  rangeSpanSelected: (axis, count) =>\n    count === 1 ? `${axis === 'row' ? 'Row' : 'Column'} selected` : `${count} ${axis}s selected`,\n  editingStarted: (rowIndex) => `Editing row ${rowIndex + 1}`,\n  editingCommitted: (rowIndex) => `Row ${rowIndex + 1} saved`,\n  dataLoaded: (count) => `${count} rows loaded`,\n};\n\n/**\n * Default animation configuration\n * @since 0.2.7\n */\nexport const DEFAULT_ANIMATION_CONFIG: Required<Omit<AnimationConfig, 'sort'>> = {\n  mode: 'reduced-motion',\n  duration: 200,\n  easing: 'ease-out',\n};\n\n/**\n * Default icons used when not overridden. Most entries are short text/emoji;\n * `filter` and `filterActive` are empty strings because the actual rendering\n * is driven by the `--tbw-icon-filter[-active]-mask` CSS custom properties\n * (see `core/styles/variables.css`). Userland that wants an HTML/SVG fallback\n * via `gridConfig.icons.filter = '<svg…>'` is unaffected — that path overrides this default.\n * @since 0.1.1\n */\nexport const DEFAULT_GRID_ICONS: Required<GridIcons> = {\n  expand: '▶',\n  collapse: '▼',\n  sortAsc: '▲',\n  sortDesc: '▼',\n  sortNone: '⇅',\n  submenuArrow: '▶',\n  dragHandle: '⋮⋮',\n  toolPanel: '☰',\n  filter: '',\n  filterActive: '',\n  print: '🖨️',\n};\n","/**\n * Centralized diagnostic messages for @toolbox-web/grid.\n *\n * Every user-facing warning, error, or info message in the grid has a unique\n * diagnostic code (e.g. `TBW001`). Each code maps to a section on the online\n * troubleshooting page, giving developers a direct link to resolution steps.\n *\n * ## Usage\n *\n * ```ts\n * import { MISSING_BREAKPOINT, warnDiagnostic, throwDiagnostic } from './diagnostics';\n *\n * // Warn with a code\n * warnDiagnostic(MISSING_BREAKPOINT, 'Set a breakpoint...', gridId);\n *\n * // Throw with a code\n * throwDiagnostic(MISSING_ROW_ID, 'Configure getRowId...', gridId);\n * ```\n *\n * Plugins should prefer `this.warn(MISSING_BREAKPOINT, message)` via BaseGridPlugin\n * instead of importing this module directly.\n *\n * @internal\n */\n\n// #region Grid Prefix\n\n/**\n * Build the `[tbw-grid]` or `[tbw-grid#my-id]` log prefix.\n * Pass `pluginName` for a scoped prefix like `[tbw-grid:SelectionPlugin]`.\n */\nexport function gridPrefix(gridId?: string, pluginName?: string): string {\n  const id = gridId ? `#${gridId}` : '';\n  const plugin = pluginName ? `:${pluginName}` : '';\n  return `[tbw-grid${id}${plugin}]`;\n}\n\n// #endregion\n\n// #region Diagnostic Codes\n\n/**\n * Diagnostic codes used across the grid library.\n *\n * Each code is an individual export so that unused codes are tree-shaken\n * from bundles that don't reference them (esbuild can't tree-shake\n * properties from a single object).\n *\n * Naming: TBW + 3-digit number.\n * Ranges:\n *   001–019  Configuration validation (missing plugins, bad config)\n *   020–029  Plugin lifecycle (dependencies, incompatibilities, alias collapse)\n *   030–039  Feature registry\n *   040–049  Row operations (row ID, row mutations)\n *   050–059  Column operations (width, template)\n *   060–069  Rendering (callbacks, formatters, external views)\n *   070–079  Shell (tool panels, header/toolbar content)\n *   080–089  Editing & editors\n *   090–099  Print\n *   100–109  Clipboard\n *   110–119  Plugin-specific (responsive, undo-redo, grouping-columns)\n *   120–129  Style injection\n *   130–139  Attribute parsing\n *   140–149  DataSource / ServerSide\n */\n\n// --- Config validation (001–019) ---\n/** Column uses a plugin-owned property but the plugin is not loaded. */\nexport const MISSING_PLUGIN = 'TBW001' as const;\n/** Grid config uses a plugin-owned property but the plugin is not loaded. */\nexport const MISSING_PLUGIN_CONFIG = 'TBW002' as const;\n/** Plugin config rule violation (error severity). */\nexport const CONFIG_RULE_ERROR = 'TBW003' as const;\n/** Plugin config rule violation (warning severity). */\nexport const CONFIG_RULE_WARN = 'TBW004' as const;\n\n// --- Plugin lifecycle (020–029) ---\n/** Required plugin dependency is missing. */\nexport const MISSING_DEPENDENCY = 'TBW020' as const;\n/** Optional plugin dependency is missing. */\nexport const OPTIONAL_DEPENDENCY = 'TBW021' as const;\n/** Two loaded plugins are incompatible. */\nexport const INCOMPATIBLE_PLUGINS = 'TBW022' as const;\n/** Two plugin instances resolve to the same canonical name (alias collapse). */\nexport const PLUGIN_ALIAS_COLLAPSE = 'TBW023' as const;\n/** Error thrown inside a plugin event handler. */\nexport const PLUGIN_EVENT_ERROR = 'TBW024' as const;\n/** Conflicting config values found while merging alias-collapsed plugin instances. */\nexport const PLUGIN_ALIAS_CONFIG_CONFLICT = 'TBW025' as const;\n\n// --- Feature registry (030–039) ---\n/** Feature was re-registered (overwritten). */\nexport const FEATURE_REREGISTERED = 'TBW030' as const;\n/** Feature configured but not imported. */\nexport const FEATURE_NOT_IMPORTED = 'TBW031' as const;\n/** Feature depends on another feature that is not enabled. */\nexport const FEATURE_MISSING_DEP = 'TBW032' as const;\n\n// --- Row operations (040–049) ---\n/** Cannot determine row ID (no getRowId and no id property). */\nexport const MISSING_ROW_ID = 'TBW040' as const;\n/** Row with given ID not found. */\nexport const ROW_NOT_FOUND = 'TBW041' as const;\n\n// --- Column operations (050–059) ---\n/** Column has an invalid CSS width value. */\nexport const INVALID_COLUMN_WIDTH = 'TBW050' as const;\n\n// --- Rendering callbacks (060–069) ---\n/** rowClass callback threw an error. */\nexport const ROW_CLASS_ERROR = 'TBW060' as const;\n/** cellClass callback threw an error. */\nexport const CELL_CLASS_ERROR = 'TBW061' as const;\n/** Column format function threw an error. */\nexport const FORMAT_ERROR = 'TBW062' as const;\n/** External view mount() threw an error. */\nexport const VIEW_MOUNT_ERROR = 'TBW063' as const;\n/** External view event dispatch error. */\nexport const VIEW_DISPATCH_ERROR = 'TBW064' as const;\n\n// --- Shell (070–079) ---\n/** Tool panel missing required id. */\nexport const TOOL_PANEL_MISSING_ATTR = 'TBW070' as const;\n/** No tool panels registered. */\nexport const NO_TOOL_PANELS = 'TBW071' as const;\n/** Tool panel section not found. */\nexport const TOOL_PANEL_NOT_FOUND = 'TBW072' as const;\n/** Tool panel already registered. */\nexport const TOOL_PANEL_DUPLICATE = 'TBW073' as const;\n/** Header content already registered. */\nexport const HEADER_CONTENT_DUPLICATE = 'TBW074' as const;\n/** Toolbar content already registered. */\nexport const TOOLBAR_CONTENT_DUPLICATE = 'TBW075' as const;\n\n// --- Editing & editors (080–089) ---\n/** External editor mount() threw an error. */\nexport const EDITOR_MOUNT_ERROR = 'TBW080' as const;\n\n// --- Print (090–099) ---\n/** Print already in progress. */\nexport const PRINT_IN_PROGRESS = 'TBW090' as const;\n/** Grid not available for printing. */\nexport const PRINT_NO_GRID = 'TBW091' as const;\n/** Print operation failed. */\nexport const PRINT_FAILED = 'TBW092' as const;\n/** Multiple elements share the same grid ID (print isolation issue). */\nexport const PRINT_DUPLICATE_ID = 'TBW093' as const;\n\n// --- Clipboard (100–109) ---\n/** Clipboard API write failed. */\nexport const CLIPBOARD_FAILED = 'TBW100' as const;\n\n// --- Plugin-specific (110–119) ---\n/** ResponsivePlugin: no breakpoint configured. */\nexport const MISSING_BREAKPOINT = 'TBW110' as const;\n/** UndoRedoPlugin: transaction already in progress. */\nexport const TRANSACTION_IN_PROGRESS = 'TBW111' as const;\n/** UndoRedoPlugin: no transaction in progress. */\nexport const NO_TRANSACTION = 'TBW112' as const;\n/** GroupingColumnsPlugin: missing id or header on column group definition. */\nexport const COLUMN_GROUP_NO_ID = 'TBW113' as const;\n/** GroupingColumnsPlugin: conflicting columnGroups sources. */\nexport const COLUMN_GROUPS_CONFLICT = 'TBW114' as const;\n\n// --- Style injection (120–129) ---\n/** Failed to extract grid.css from document stylesheets. */\nexport const STYLE_EXTRACT_FAILED = 'TBW120' as const;\n/** Could not find grid.css in document.styleSheets. */\nexport const STYLE_NOT_FOUND = 'TBW121' as const;\n\n// --- Attribute parsing (130–139) ---\n/** Invalid JSON in an HTML attribute. */\nexport const INVALID_ATTRIBUTE_JSON = 'TBW130' as const;\n\n// --- DataSource / ServerSide (140–149) ---\n/** ServerSidePlugin: getRows() rejected. */\nexport const DATASOURCE_FETCH_ERROR = 'TBW140' as const;\n/** ServerSidePlugin: getChildRows() rejected. */\nexport const DATASOURCE_CHILD_FETCH_ERROR = 'TBW141' as const;\n/** ServerSidePlugin: getChildRows() not implemented but a plugin queried for children. */\nexport const DATASOURCE_NO_CHILD_HANDLER = 'TBW142' as const;\n/** ServerSidePlugin: concurrent request limit reached, request deferred. */\nexport const DATASOURCE_THROTTLED = 'TBW143' as const;\n\nexport type DiagnosticCode =\n  | typeof MISSING_PLUGIN\n  | typeof MISSING_PLUGIN_CONFIG\n  | typeof CONFIG_RULE_ERROR\n  | typeof CONFIG_RULE_WARN\n  | typeof MISSING_DEPENDENCY\n  | typeof OPTIONAL_DEPENDENCY\n  | typeof INCOMPATIBLE_PLUGINS\n  | typeof PLUGIN_ALIAS_COLLAPSE\n  | typeof PLUGIN_EVENT_ERROR\n  | typeof PLUGIN_ALIAS_CONFIG_CONFLICT\n  | typeof FEATURE_REREGISTERED\n  | typeof FEATURE_NOT_IMPORTED\n  | typeof FEATURE_MISSING_DEP\n  | typeof MISSING_ROW_ID\n  | typeof ROW_NOT_FOUND\n  | typeof INVALID_COLUMN_WIDTH\n  | typeof ROW_CLASS_ERROR\n  | typeof CELL_CLASS_ERROR\n  | typeof FORMAT_ERROR\n  | typeof VIEW_MOUNT_ERROR\n  | typeof VIEW_DISPATCH_ERROR\n  | typeof TOOL_PANEL_MISSING_ATTR\n  | typeof NO_TOOL_PANELS\n  | typeof TOOL_PANEL_NOT_FOUND\n  | typeof TOOL_PANEL_DUPLICATE\n  | typeof HEADER_CONTENT_DUPLICATE\n  | typeof TOOLBAR_CONTENT_DUPLICATE\n  | typeof EDITOR_MOUNT_ERROR\n  | typeof PRINT_IN_PROGRESS\n  | typeof PRINT_NO_GRID\n  | typeof PRINT_FAILED\n  | typeof PRINT_DUPLICATE_ID\n  | typeof CLIPBOARD_FAILED\n  | typeof MISSING_BREAKPOINT\n  | typeof TRANSACTION_IN_PROGRESS\n  | typeof NO_TRANSACTION\n  | typeof COLUMN_GROUP_NO_ID\n  | typeof COLUMN_GROUPS_CONFLICT\n  | typeof STYLE_EXTRACT_FAILED\n  | typeof STYLE_NOT_FOUND\n  | typeof INVALID_ATTRIBUTE_JSON\n  | typeof DATASOURCE_FETCH_ERROR\n  | typeof DATASOURCE_CHILD_FETCH_ERROR\n  | typeof DATASOURCE_NO_CHILD_HANDLER\n  | typeof DATASOURCE_THROTTLED;\n\n// #endregion\n\n// #region Docs URL\n\nconst DOCS_BASE = 'https://toolboxjs.com/grid/errors';\n\n/** Build a direct link to the troubleshooting section for a code. */\nfunction docsUrl(code: DiagnosticCode): string {\n  return `${DOCS_BASE}#${code.toLowerCase()}`;\n}\n\n// #endregion\n\n// #region Formatting\n\n/**\n * Format a diagnostic message with prefix, code, and docs link.\n *\n * Output format:\n * ```\n * [tbw-grid#my-id] TBW001: Your message here.\n *\n *   → More info: https://toolboxjs.com/grid/errors#tbw001\n * ```\n */\nexport function formatDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): string {\n  const prefix = gridPrefix(gridId, pluginName);\n  return `${prefix} ${code}: ${message}\\n\\n  → More info: ${docsUrl(code)}`;\n}\n\n// #endregion\n\n// #region Public API\n\n/**\n * Throw an error with a diagnostic code and docs link.\n * Use for configuration errors and API misuse that should halt execution.\n */\nexport function throwDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): never {\n  throw new Error(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n/**\n * Log a warning with a diagnostic code and docs link.\n * Use for recoverable issues the developer should fix.\n */\nexport function warnDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void {\n  console.warn(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n/**\n * Log a debug message with a diagnostic code and docs link.\n * Use for optional/soft dependency notifications — visible only when\n * the browser DevTools \"Verbose\" log level is enabled.\n */\nexport function debugDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void {\n  console.debug(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n/**\n * Log an error with a diagnostic code and docs link.\n * Use for non-throwing errors (e.g., failed async operations).\n */\nexport function errorDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void {\n  console.error(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n// #endregion\n","// Centralized template expression evaluation & sanitization utilities.\n// Responsible for safely interpolating {{ }} expressions while blocking\n// access to dangerous globals / reflective capabilities.\nimport type { CompiledViewFunction, EvalContext } from '../types';\n\n// #region Constants\nconst EXPR_RE = /{{\\s*([^}]+)\\s*}}/g;\nconst EMPTY_SENTINEL = '__DG_EMPTY__';\nconst SAFE_EXPR = /^[\\w$. '?+\\-*/%:()!<>=,&|]+$/;\n\n// Forbidden identifiers built at runtime to avoid static analysis scanners\n// from flagging string literals (e.g. socket.dev \"network access\" / \"uses eval\").\n// Stored as reversed, pipe-delimited tokens — reversed back when constructing the regex.\nconst _F =\n  '__otorp__|__retteGenifed__|__retteSenifed__|rotcurtsnoc|wodniw|sihTlabolg|labolg|ssecorp|noitcnuF|tropmi|lave|tcelfeR|yxorP|rorrE|stnemugra|tnemucod|noitacol|eikooc|egarotSlacol|egarotSnoisses|BDdexedni|hctef|tseuqeRpttHLMX|tekcoSbeW|rekroW|rekroWderahS|rekroWecivreS|renepo|tnerap|pot|semarf|fles'\n    .split('|')\n    .map((s) => s.split('').reverse().join(''));\nconst FORBIDDEN = new RegExp(`__(proto|defineGetter|defineSetter)|${_F.slice(3).join('|')}|this\\\\b`);\n// #endregion\n\n// #region HTML Sanitization\n\n/**\n * Escape a plain text string for safe insertion into HTML.\n * Converts special HTML characters to their entity equivalents.\n *\n * @param text - Plain text string to escape\n * @returns HTML-safe string\n */\nexport function escapeHtml(text: string): string {\n  if (!text || typeof text !== 'string') return '';\n  return text\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&#39;');\n}\n\n/**\n * Tags that are considered dangerous and will be completely removed.\n * These can execute scripts, load external resources, or manipulate the page.\n */\nconst DANGEROUS_TAGS = new Set(\n  'script|iframe|object|embed|form|input|button|textarea|select|link|meta|base|style|template|slot|portal|frame|frameset|applet|noscript|noembed|plaintext|xmp|listing|math'.split(\n    '|',\n  ),\n);\n\n/**\n * Attributes that are considered dangerous - event handlers and data loading.\n */\nconst DANGEROUS_ATTR_PATTERN = /^on\\w+$/i;\n\n/**\n * Attributes that can contain URLs which might be javascript: or data: URIs.\n */\nconst URL_ATTRS = new Set('href|src|action|formaction|data|srcdoc|xlink:href|poster|srcset'.split('|'));\n\n/**\n * Protocol patterns that are dangerous in URLs.\n */\nconst DANGEROUS_URL_PROTOCOL = /^\\s*(javascript|vbscript|data|blob):/i;\n\n/**\n * Sanitize an HTML string by removing dangerous tags and attributes.\n *\n * Prefer {@link setSanitizedHTML} wherever the result is destined for an\n * element: this function has to re-serialize the sanitized tree back to a\n * string, and the caller's `innerHTML =` then re-parses it. That\n * parse→serialize→parse round trip is the classic mutation-XSS vector, and it\n * costs a second parse. Use this overload only when a string is genuinely\n * required (e.g. the value is stored, compared, or handed to another API).\n *\n * @param html - Raw HTML string to sanitize\n * @returns Sanitized HTML string safe for innerHTML\n */\nexport function sanitizeHTML(html: string): string {\n  if (!html || typeof html !== 'string') return '';\n\n  // Fast path: if no HTML tags at all, return as-is (already safe)\n  if (html.indexOf('<') === -1) return html;\n\n  const template = document.createElement('template');\n  template.innerHTML = html;\n\n  sanitizeNode(template.content);\n\n  return template.innerHTML;\n}\n\n/**\n * Parse and sanitize an HTML string into a detached {@link DocumentFragment}.\n *\n * This is the primitive {@link setSanitizedHTML} builds on, exposed for callers\n * that need to inspect or relocate the nodes before insertion.\n *\n * @param html - Raw HTML string to sanitize\n * @returns Fragment containing the sanitized nodes (empty for falsy input)\n */\nexport function sanitizeToFragment(html: string): DocumentFragment {\n  const template = document.createElement('template');\n  if (html && typeof html === 'string') {\n    template.innerHTML = html;\n    sanitizeNode(template.content);\n  }\n  return template.content;\n}\n\n/**\n * Replace an element's children with the sanitized parse of `html`.\n *\n * **This is the canonical sink for user-supplied markup** — cell/header/group\n * renderer string returns, `gridConfig.icons.*`, light-DOM tool panel fallback\n * content, and any new extension point that turns a user string into markup.\n * `textContent` is wrong here (it renders SVG icon strings as literal text) and\n * raw `innerHTML` is wrong (it is an XSS sink).\n *\n * Nodes are moved from the parse fragment rather than re-serialized, so the\n * sanitized tree is exactly what lands in the document.\n *\n * @param el - Element whose children are replaced\n * @param html - Raw HTML string to sanitize and insert\n */\nexport function setSanitizedHTML(el: Element, html: string): void {\n  if (!html || typeof html !== 'string') {\n    el.replaceChildren();\n    return;\n  }\n  // Nothing for the parser to do: no markup and no entities to decode.\n  if (html.indexOf('<') === -1 && html.indexOf('&') === -1) {\n    el.textContent = html;\n    return;\n  }\n  el.replaceChildren(sanitizeToFragment(html));\n}\n\n/**\n * Recursively sanitize a DOM node tree.\n */\nfunction sanitizeNode(root: DocumentFragment | Element): void {\n  const toRemove: Element[] = [];\n\n  // Use querySelectorAll to find all elements, then filter\n  const elements = root.querySelectorAll('*');\n\n  for (const el of elements) {\n    const tagName = el.tagName.toLowerCase();\n\n    // Check if tag is dangerous\n    if (DANGEROUS_TAGS.has(tagName)) {\n      toRemove.push(el);\n      continue;\n    }\n\n    // SVG elements need special handling - they can contain script-like behavior\n    if (tagName === 'svg' || el.namespaceURI === 'http://www.w3.org/2000/svg') {\n      // Remove entire SVG if it has any suspicious attributes\n      const hasDangerousContent = Array.from(el.attributes).some(\n        (attr) => DANGEROUS_ATTR_PATTERN.test(attr.name) || attr.name === 'href' || attr.name === 'xlink:href',\n      );\n      if (hasDangerousContent) {\n        toRemove.push(el);\n        continue;\n      }\n    }\n\n    // Check and remove dangerous attributes\n    const attrsToRemove: string[] = [];\n    for (const attr of el.attributes) {\n      const attrName = attr.name.toLowerCase();\n\n      // Event handlers (onclick, onerror, onload, etc.)\n      if (DANGEROUS_ATTR_PATTERN.test(attrName)) {\n        attrsToRemove.push(attr.name);\n        continue;\n      }\n\n      // `is=` upgrades a plain tag into a registered customized built-in, so it\n      // can smuggle behaviour past the tag-name check above.\n      if (attrName === 'is') {\n        attrsToRemove.push(attr.name);\n        continue;\n      }\n\n      // URL attributes with dangerous protocols\n      if (URL_ATTRS.has(attrName) && DANGEROUS_URL_PROTOCOL.test(attr.value)) {\n        attrsToRemove.push(attr.name);\n        continue;\n      }\n\n      // style attribute can contain expressions (IE) or url() with javascript:\n      if (attrName === 'style' && /expression\\s*\\(|javascript:|behavior\\s*:/i.test(attr.value)) {\n        attrsToRemove.push(attr.name);\n        continue;\n      }\n    }\n\n    attrsToRemove.forEach((name) => el.removeAttribute(name));\n  }\n\n  // Remove dangerous elements (do this after iteration to avoid modifying during traversal)\n  toRemove.forEach((el) => el.remove());\n}\n\n// #endregion\n\n// #region Template Evaluation\n\n// #region Safe Expression Evaluator\n// A minimal recursive-descent evaluator for the token set allowed by SAFE_EXPR.\n// Replaces `new Function()` to avoid dynamic code execution warnings from\n// static analysis tools (socket.dev, npm audit) while maintaining identical\n// functionality for expressions that pass the allowlist guards.\n//\n// Supported grammar (matching SAFE_EXPR = /^[\\w$. '?+\\-*/%:()!<>=,&|]+$/):\n//   ternary     → logicalOr ('?' ternary ':' ternary)?\n//   logicalOr   → logicalAnd ('||' logicalAnd)*\n//   logicalAnd  → equality ('&&' equality)*\n//   equality    → comparison (('==' | '!=' | '===' | '!==') comparison)*\n//   comparison  → additive (('<' | '>' | '<=' | '>=') additive)*\n//   additive    → multiplicative (('+' | '-') multiplicative)*\n//   multiplicative → unary (('*' | '/' | '%') unary)*\n//   unary       → '!' unary | primary\n//   primary     → NUMBER | STRING | IDENT ('.' IDENT)? | '(' ternary ')'\n\ntype Token =\n  { type: 'num'; v: number } | { type: 'str'; v: string } | { type: 'id'; v: string } | { type: 'op'; v: string };\n\nfunction tokenize(expr: string): Token[] | null {\n  const tokens: Token[] = [];\n  let i = 0;\n  while (i < expr.length) {\n    const ch = expr[i];\n    if (ch === ' ') {\n      i++;\n      continue;\n    }\n\n    // Numbers\n    if ((ch >= '0' && ch <= '9') || (ch === '.' && i + 1 < expr.length && expr[i + 1] >= '0' && expr[i + 1] <= '9')) {\n      const start = i;\n      while (i < expr.length && ((expr[i] >= '0' && expr[i] <= '9') || expr[i] === '.')) i++;\n      tokens.push({ type: 'num', v: Number(expr.slice(start, i)) });\n      continue;\n    }\n\n    // String literals (single-quoted only, per SAFE_EXPR)\n    if (ch === \"'\") {\n      let s = '';\n      i++; // skip opening quote\n      while (i < expr.length && expr[i] !== \"'\") s += expr[i++];\n      if (i >= expr.length) return null; // unterminated\n      i++; // skip closing quote\n      tokens.push({ type: 'str', v: s });\n      continue;\n    }\n\n    // Identifiers (value, row, row.field)\n    if ((ch >= 'a' && ch <= 'z') || (ch >= 'A' && ch <= 'Z') || ch === '_' || ch === '$') {\n      const start = i;\n      while (i < expr.length && /[\\w$.]/.test(expr[i])) i++;\n      tokens.push({ type: 'id', v: expr.slice(start, i) });\n      continue;\n    }\n\n    // Multi-char operators\n    if (i + 2 < expr.length) {\n      const tri = expr.slice(i, i + 3);\n      if (tri === '===' || tri === '!==') {\n        tokens.push({ type: 'op', v: tri });\n        i += 3;\n        continue;\n      }\n    }\n    if (i + 1 < expr.length) {\n      const bi = expr.slice(i, i + 2);\n      if (bi === '==' || bi === '!=' || bi === '<=' || bi === '>=' || bi === '&&' || bi === '||') {\n        tokens.push({ type: 'op', v: bi });\n        i += 2;\n        continue;\n      }\n    }\n\n    // Single-char operators\n    if ('+-*/%<>!?:(),'.includes(ch)) {\n      tokens.push({ type: 'op', v: ch });\n      i++;\n      continue;\n    }\n\n    return null; // unexpected character\n  }\n  return tokens;\n}\n\nfunction safeEval(expr: string, ctx: EvalContext): unknown {\n  const toks = tokenize(expr);\n  if (!toks) return undefined;\n  const tokens: Token[] = toks;\n  let pos = 0;\n\n  function peek(): Token | undefined {\n    return tokens[pos];\n  }\n  function advance(): Token {\n    return tokens[pos++];\n  }\n  function match(type: string, val?: string): boolean {\n    const t = peek();\n    if (!t) return false;\n    if (t.type !== type) return false;\n    if (val !== undefined && t.v !== val) return false;\n    return true;\n  }\n\n  function resolveId(name: string): unknown {\n    if (name === 'value') return ctx.value;\n    if (name.startsWith('row.')) {\n      const key = name.slice(4);\n      return ctx.row ? ctx.row[key] : undefined;\n    }\n    if (name.startsWith('typeDefault.')) {\n      const key = name.slice('typeDefault.'.length);\n      return ctx.typeDefault ? ctx.typeDefault[key] : undefined;\n    }\n    // bare 'row' reference\n    if (name === 'row') return ctx.row;\n    if (name === 'typeDefault') return ctx.typeDefault;\n    return undefined;\n  }\n\n  function parseTernary(): unknown {\n    const result = parseLogicalOr();\n    if (match('op', '?')) {\n      advance(); // consume '?'\n      const consequent = parseTernary();\n      if (!match('op', ':')) return undefined;\n      advance(); // consume ':'\n      const alternate = parseTernary();\n      return result ? consequent : alternate;\n    }\n    return result;\n  }\n\n  function parseLogicalOr(): unknown {\n    let left = parseLogicalAnd();\n    while (match('op', '||')) {\n      advance();\n      left = left || parseLogicalAnd();\n    }\n    return left;\n  }\n\n  function parseLogicalAnd(): unknown {\n    let left = parseEquality();\n    while (match('op', '&&')) {\n      advance();\n      left = left && parseEquality();\n    }\n    return left;\n  }\n\n  function parseEquality(): unknown {\n    let left = parseComparison();\n    while (true) {\n      const t = peek();\n      if (!t || t.type !== 'op') break;\n      if (t.v === '===') {\n        advance();\n        left = left === parseComparison();\n      } else if (t.v === '!==') {\n        advance();\n        left = left !== parseComparison();\n      } else if (t.v === '==') {\n        advance();\n        left = left == parseComparison();\n      } else if (t.v === '!=') {\n        advance();\n        left = left != parseComparison();\n      } else break;\n    }\n    return left;\n  }\n\n  function parseComparison(): unknown {\n    let left = parseAdditive();\n    while (true) {\n      const t = peek();\n      if (!t || t.type !== 'op') break;\n      if (t.v === '<') {\n        advance();\n        left = (left as number) < (parseAdditive() as number);\n      } else if (t.v === '>') {\n        advance();\n        left = (left as number) > (parseAdditive() as number);\n      } else if (t.v === '<=') {\n        advance();\n        left = (left as number) <= (parseAdditive() as number);\n      } else if (t.v === '>=') {\n        advance();\n        left = (left as number) >= (parseAdditive() as number);\n      } else break;\n    }\n    return left;\n  }\n\n  function parseAdditive(): unknown {\n    let left = parseMultiplicative();\n    while (true) {\n      const t = peek();\n      if (!t || t.type !== 'op') break;\n      if (t.v === '+') {\n        advance();\n        left = (left as number) + (parseMultiplicative() as number);\n      } else if (t.v === '-') {\n        advance();\n        left = (left as number) - (parseMultiplicative() as number);\n      } else break;\n    }\n    return left;\n  }\n\n  function parseMultiplicative(): unknown {\n    let left = parseUnary();\n    while (true) {\n      const t = peek();\n      if (!t || t.type !== 'op') break;\n      if (t.v === '*') {\n        advance();\n        left = (left as number) * (parseUnary() as number);\n      } else if (t.v === '/') {\n        advance();\n        left = (left as number) / (parseUnary() as number);\n      } else if (t.v === '%') {\n        advance();\n        left = (left as number) % (parseUnary() as number);\n      } else break;\n    }\n    return left;\n  }\n\n  function parseUnary(): unknown {\n    if (match('op', '!')) {\n      advance();\n      return !parseUnary();\n    }\n    return parsePrimary();\n  }\n\n  function parsePrimary(): unknown {\n    const t = peek();\n    if (!t) return undefined;\n    if (t.type === 'num') {\n      advance();\n      return t.v;\n    }\n    if (t.type === 'str') {\n      advance();\n      return t.v;\n    }\n    if (t.type === 'id') {\n      advance();\n      return resolveId(t.v as string);\n    }\n    if (t.type === 'op' && t.v === '(') {\n      advance(); // consume '('\n      const result = parseTernary();\n      if (match('op', ')')) advance(); // consume ')'\n      return result;\n    }\n    // Unary minus for negative numbers\n    if (t.type === 'op' && t.v === '-') {\n      advance();\n      return -(parsePrimary() as number);\n    }\n    return undefined;\n  }\n\n  const result = parseTernary();\n  // Ensure all tokens were consumed\n  if (pos < tokens.length) return undefined;\n  return result;\n}\n// #endregion\n\nexport function evalTemplateString(raw: string, ctx: EvalContext): string {\n  if (!raw || raw.indexOf('{{') === -1) return raw; // fast path (no expressions)\n  const parts: { expr: string; result: string }[] = [];\n  const evaluated = raw.replace(EXPR_RE, (_m, expr) => {\n    const res = evalSingle(expr, ctx);\n    parts.push({ expr: expr.trim(), result: res });\n    // The template markup is author-controlled; the interpolated data is not.\n    // Escaping here stops row data from injecting elements or breaking out of\n    // an attribute (sanitizeHTML downstream only strips *dangerous* markup).\n    return res === EMPTY_SENTINEL ? res : escapeHtml(res);\n  });\n  const finalStr = postProcess(evaluated);\n  // If every part evaluated to EMPTY_SENTINEL we treat this as intentionally blank.\n  // If any expression was blocked due to forbidden token (EMPTY_SENTINEL) we *still* only output ''\n  // but do not escalate to BLOCKED_SENTINEL unless the original contained explicit forbidden tokens.\n  const allEmpty = parts.length && parts.every((p) => p.result === '' || p.result === EMPTY_SENTINEL);\n  const hadForbidden = REFLECTIVE_RE.test(raw);\n  if (hadForbidden || allEmpty) return '';\n  return finalStr;\n}\n\nfunction evalSingle(expr: string, ctx: EvalContext): string {\n  expr = (expr || '').trim();\n  if (!expr) return EMPTY_SENTINEL;\n  if (REFLECTIVE_RE.test(expr)) return EMPTY_SENTINEL;\n  if (expr === 'value') return ctx.value == null ? EMPTY_SENTINEL : String(ctx.value);\n  if (expr.startsWith('row.') && !/[()?]/.test(expr) && !expr.includes(':')) {\n    const key = expr.slice(4);\n    const v = ctx.row ? ctx.row[key] : undefined;\n    return v == null ? EMPTY_SENTINEL : String(v);\n  }\n  if (expr.startsWith('typeDefault.') && !/[()?]/.test(expr) && !expr.includes(':')) {\n    const key = expr.slice('typeDefault.'.length);\n    const v = ctx.typeDefault ? ctx.typeDefault[key] : undefined;\n    return v == null ? EMPTY_SENTINEL : String(v);\n  }\n  if (expr.length > 80) return EMPTY_SENTINEL;\n  if (!SAFE_EXPR.test(expr) || FORBIDDEN.test(expr)) return EMPTY_SENTINEL;\n  const dotChain = expr.match(/\\./g);\n  if (dotChain && dotChain.length > 1) return EMPTY_SENTINEL;\n  try {\n    const out = safeEval(expr, ctx);\n    const str = out == null ? '' : String(out);\n    if (REFLECTIVE_RE.test(str)) return EMPTY_SENTINEL;\n    return str || EMPTY_SENTINEL;\n  } catch {\n    return EMPTY_SENTINEL;\n  }\n}\n// #endregion\n\n// #region Cell Scrubbing\n/** Pattern matching reflective/introspective APIs that must be stripped from output. */\nconst REFLECTIVE_RE = /Reflect|Proxy|ownKeys/;\n\nfunction postProcess(s: string): string {\n  if (!s) return s;\n  return s.replace(new RegExp(EMPTY_SENTINEL, 'g'), '').replace(/Reflect\\.[^<>{}\\s]+|\\bProxy\\b|ownKeys\\([^)]*\\)/g, '');\n}\n\nexport function finalCellScrub(cell: HTMLElement): void {\n  if (!REFLECTIVE_RE.test(cell.textContent || '')) return;\n  // First pass: clear only text nodes containing forbidden tokens\n  for (const n of cell.childNodes) {\n    if (n.nodeType === Node.TEXT_NODE && REFLECTIVE_RE.test(n.textContent || '')) n.textContent = '';\n  }\n  // If forbidden tokens persist in element nodes, nuke everything\n  if (REFLECTIVE_RE.test(cell.textContent || '')) {\n    cell.textContent = '';\n  }\n}\n// #endregion\n\n// #region Template Compilation\nexport function compileTemplate(raw: string) {\n  if (REFLECTIVE_RE.test(raw)) {\n    const fn = (() => '') as CompiledViewFunction;\n    fn.__blocked = true;\n    return fn;\n  }\n  const fn = ((ctx: EvalContext) => evalTemplateString(raw, ctx)) as CompiledViewFunction;\n  fn.__blocked = false;\n  return fn;\n}\n// #endregion\n","/**\n * Base Grid Plugin Class\n *\n * All plugins extend this abstract class.\n * Plugins are instantiated per-grid and manage their own state.\n */\n\n// Injected by Vite at build time from package.json (same as grid.ts)\ndeclare const __GRID_VERSION__: string;\n\nimport type { HeaderContentDefinition, ToolPanelDefinition } from '../../plugins/shell/types';\nimport { DEFAULT_GRID_ICONS } from '../defaults';\nimport {\n  type DiagnosticCode,\n  PLUGIN_ALIAS_CONFIG_CONFLICT,\n  formatDiagnostic,\n  gridPrefix,\n} from '../internal/diagnostics';\nimport { setSanitizedHTML } from '../internal/sanitize';\nimport type {\n  ColumnConfig,\n  ColumnState,\n  GridConfig,\n  GridIcons,\n  GridPlugin,\n  IconValue,\n  PluginNameMap,\n  Translate,\n} from '../types';\n\n// Re-export shared plugin types for convenience\nexport type {\n  AfterCellRenderContext,\n  AfterRowRenderContext,\n  CellClickEvent,\n  CellCoords,\n  CellEditor,\n  CellMouseEvent,\n  CellRenderer,\n  ContextMenuItem,\n  ContextMenuParams,\n  GridElementRef,\n  HeaderClickEvent,\n  HeaderRenderer,\n  KeyboardModifiers,\n  PluginCellRenderContext,\n  PluginQuery,\n  RowClickEvent,\n  ScrollEvent,\n} from './types';\n\nimport type {\n  AfterCellRenderContext,\n  AfterRowRenderContext,\n  CellClickEvent,\n  CellEditor,\n  CellMouseEvent,\n  CellRenderer,\n  GridElementRef,\n  HeaderClickEvent,\n  HeaderRenderer,\n  PluginQuery,\n  RowClickEvent,\n  ScrollEvent,\n} from './types';\n\n/**\n * Grid element interface for plugins.\n * Extends GridElementRef with plugin-specific methods.\n * Note: effectiveConfig is already available from GridElementRef.\n */\nexport interface GridElement extends GridElementRef {\n  getPlugin<T extends GridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined;\n  getPluginByName<K extends string>(\n    name: K,\n  ): (K extends keyof PluginNameMap ? PluginNameMap[K] : BaseGridPlugin) | undefined;\n  /**\n   * Get a plugin's state by plugin name.\n   * This is a loose-coupling method for plugins to access other plugins' state\n   * without importing the plugin class directly.\n   * @internal Plugin API\n   */\n  getPluginState?(name: string): unknown;\n\n  // Focus Management\n  /** Register an external DOM element as a logical focus container. @internal Plugin API */\n  registerExternalFocusContainer?(el: Element): void;\n  /** Unregister a previously registered external focus container. @internal Plugin API */\n  unregisterExternalFocusContainer?(el: Element): void;\n  /** Check whether focus is logically inside this grid (own DOM + external containers). @internal Plugin API */\n  containsFocus?(node?: Node | null): boolean;\n}\n\n/**\n * Header render context for plugin header renderers.\n */\nexport interface PluginHeaderRenderContext {\n  /** Column configuration */\n  column: ColumnConfig;\n  /** Column index */\n  colIndex: number;\n}\n\n// ============================================================================\n// Plugin Dependency Types\n// ============================================================================\n\n/**\n * Declares a dependency on another plugin.\n *\n * @category Plugin Development\n * @example\n * ```typescript\n * export class UndoRedoPlugin extends BaseGridPlugin {\n *   static readonly dependencies: PluginDependency[] = [\n *     { name: 'editing', required: true },\n *   ];\n * }\n * ```\n * @since 0.4.1\n */\nexport interface PluginDependency {\n  /**\n   * The name of the required plugin (matches the plugin's `name` property).\n   * Use string names for loose coupling - avoids static imports.\n   */\n  name: string;\n\n  /**\n   * Whether this dependency is required (hard) or optional (soft).\n   * - `true`: Plugin cannot function without it. Throws error if missing.\n   * - `false`: Plugin works with reduced functionality. Silent if missing\n   *   (set {@link severity} to `'warn'` or `'info'` to opt into a message).\n   * @default true\n   */\n  required?: boolean;\n\n  /**\n   * Explicit severity when this dependency is missing. Overrides the default\n   * derived from {@link required}.\n   * - `'error'`: throw (halts grid setup). Default when `required` is not `false`.\n   * - `'warn'`: log a console warning and continue (development only).\n   * - `'info'`: log a verbose console.debug message and continue (development only).\n   *\n   * When omitted, a missing hard dependency throws and a missing soft\n   * dependency is silent — preserving backward-compatible behavior.\n   * @since 2.16.0\n   */\n  severity?: 'error' | 'warn' | 'info';\n\n  /**\n   * Optional predicate that gates whether this dependency applies, evaluated\n   * against the depending plugin's own resolved configuration (defaults merged\n   * with user config). Return `false` to skip the dependency entirely.\n   *\n   * Lets a plugin require/recommend another plugin only under certain config\n   * — e.g. a plugin that needs a tool-panel host only when its tool panel is\n   * enabled. When omitted, the dependency always applies.\n   * @example when: (cfg: PivotConfig) => cfg.showToolPanel === true\n   * @since 2.16.0\n   */\n  when?: (pluginConfig: unknown) => boolean;\n\n  /**\n   * Factory for a default instance of the dependency. When the dependency is\n   * missing, the grid attaches the instance this returns (once per grid,\n   * before the depending plugin) instead of reporting an error, so consumers\n   * never have to add it themselves. An explicitly configured instance always\n   * wins.\n   *\n   * Import the dependency's plugin module statically so it ships with the\n   * depending plugin's module graph — never with `import()`.\n   *\n   * @example provide: () => new HierarchyPlugin()\n   * @since 3.9.0\n   */\n  provide?: () => BaseGridPlugin;\n\n  /**\n   * Human-readable reason for this dependency.\n   * Shown in error/info messages to help users understand why.\n   * @example \"UndoRedoPlugin needs EditingPlugin to track cell edits\"\n   */\n  reason?: string;\n}\n\n/**\n * Declares an incompatibility between plugins.\n * When both plugins are loaded, a warning is logged to help users understand the conflict.\n *\n * @category Plugin Development\n */\nexport interface PluginIncompatibility {\n  /**\n   * The name of the incompatible plugin (matches the plugin's `name` property).\n   */\n  name: string;\n\n  /**\n   * Human-readable reason for the incompatibility.\n   * Should explain why the plugins conflict and any workarounds.\n   * @example \"Both transform the entire row model in different ways\"\n   */\n  reason: string;\n}\n\n// ============================================================================\n// Plugin Query & Event Definitions\n// ============================================================================\n\n/**\n * Defines a query that a plugin can handle.\n * Other plugins or the grid can send this query type to retrieve data.\n *\n * @category Plugin Development\n *\n * @example\n * ```typescript\n * // In manifest\n * queries: [\n *   {\n *     type: 'canMoveColumn',\n *     description: 'Check if a column can be moved/reordered',\n *   },\n * ]\n *\n * // In plugin class\n * handleQuery(query: PluginQuery): unknown {\n *   if (query.type === 'canMoveColumn') {\n *     return this.canMoveColumn(query.context);\n *   }\n * }\n * ```\n * @since 1.8.0\n */\nexport interface QueryDefinition {\n  /**\n   * The query type identifier (e.g., 'canMoveColumn', 'getContextMenuItems').\n   * Should be unique across all plugins.\n   */\n  type: string;\n\n  /**\n   * Human-readable description of what the query does.\n   */\n  description?: string;\n}\n\n/**\n * Defines an event that a plugin can emit.\n * Other plugins can subscribe to these events via the Event Bus.\n *\n * @category Plugin Development\n *\n * @example\n * ```typescript\n * // In manifest\n * events: [\n *   {\n *     type: 'filter-change',\n *     description: 'Emitted when filter criteria change',\n *   },\n * ]\n *\n * // In plugin class - emit\n * this.emitPluginEvent('filter-change', { field: 'name', value: 'Alice' });\n *\n * // In another plugin - subscribe\n * this.on('filter-change', (detail) => console.log('Filter changed:', detail));\n * ```\n * @since 1.8.0\n */\nexport interface EventDefinition {\n  /**\n   * The event type identifier (e.g., 'filter-change', 'selection-change').\n   * Used when emitting and subscribing to events.\n   */\n  type: string;\n\n  /**\n   * Human-readable description of what the event represents.\n   */\n  description?: string;\n\n  /**\n   * Whether this event is cancelable via `event.preventDefault()`.\n   * @default false\n   */\n  cancelable?: boolean;\n}\n\n// ============================================================================\n// Plugin Manifest Types\n// ============================================================================\n\n/**\n * Defines a property that a plugin \"owns\" - used for configuration validation.\n * When this property is used without the owning plugin loaded, an error is thrown.\n *\n * @category Plugin Development\n */\nexport interface PluginPropertyDefinition {\n  /** The property name on column or grid config */\n  property: string;\n  /** Whether this is a column-level or config-level property */\n  level: 'column' | 'config';\n  /** Human-readable description for error messages (e.g., 'the \"editable\" column property') */\n  description: string;\n  /** Import path hint for error messages (e.g., \"import { EditingPlugin } from '@toolbox-web/grid/plugins/editing';\") */\n  importHint?: string;\n  /** Custom check for whether property is considered \"used\" (default: truthy value check) */\n  isUsed?: (value: unknown) => boolean;\n}\n\n/**\n * A configuration validation rule for detecting invalid/conflicting settings.\n * Plugins declare rules in their manifest; the validator executes them during grid initialization.\n *\n * @category Plugin Development\n * @template TConfig - The plugin's configuration type\n */\nexport interface PluginConfigRule<TConfig = unknown> {\n  /** Rule identifier for debugging (e.g., 'selection/range-dblclick') */\n  id: string;\n  /** Severity: 'error' throws, 'warn' logs warning */\n  severity: 'error' | 'warn';\n  /** Human-readable message shown when rule is violated */\n  message: string;\n  /** Predicate returning true if the rule is VIOLATED (i.e., config is invalid) */\n  check: (pluginConfig: TConfig) => boolean;\n}\n\n/**\n * Hook names that can have execution priority configured.\n *\n * @category Plugin Development\n */\nexport type HookName =\n  | 'processColumns'\n  | 'processConfig'\n  | 'processRows'\n  | 'afterStructuralRender'\n  | 'afterRender'\n  | 'afterCellRender'\n  | 'afterRowRender'\n  | 'onCellClick'\n  | 'onCellMouseDown'\n  | 'onCellMouseMove'\n  | 'onCellMouseUp'\n  | 'onHeaderClick'\n  | 'onKeyDown'\n  | 'onRowClick'\n  | 'onScroll'\n  | 'onScrollRender';\n\n/**\n * Static metadata about a plugin's capabilities and requirements.\n * Declared as a static property on plugin classes.\n *\n * @category Plugin Development\n * @template TConfig - The plugin's configuration type\n *\n * @example\n * ```typescript\n * export class MyPlugin extends BaseGridPlugin<MyConfig> {\n *   static override readonly manifest: PluginManifest<MyConfig> = {\n *     ownedProperties: [\n *       { property: 'myProp', level: 'column', description: 'the \"myProp\" column property' },\n *     ],\n *     configRules: [\n *       { id: 'my-plugin/invalid-combo', severity: 'warn', message: '...', check: (c) => c.a && c.b },\n *     ],\n *   };\n *   readonly name = 'myPlugin';\n * }\n * ```\n * @since 1.1.0\n */\nexport interface PluginManifest<TConfig = unknown> {\n  /**\n   * Properties this plugin owns - validated by validate-config.ts.\n   * If a user uses one of these properties without loading the plugin, an error is thrown.\n   */\n  ownedProperties?: PluginPropertyDefinition[];\n\n  /**\n   * Hook execution priority (higher = later, default 0).\n   * Use negative values to run earlier, positive to run later.\n   */\n  hookPriority?: Partial<Record<HookName, number>>;\n\n  /**\n   * Configuration validation rules - checked during grid initialization.\n   * Rules with severity 'error' throw, 'warn' logs to console.\n   */\n  configRules?: PluginConfigRule<TConfig>[];\n\n  /**\n   * Plugins that are incompatible with this plugin.\n   * When both plugins are loaded together, a warning is shown.\n   *\n   * @example\n   * ```typescript\n   * incompatibleWith: [\n   *   { name: 'tree', reason: 'Both transform the entire row model in different ways' },\n   * ],\n   * ```\n   */\n  incompatibleWith?: PluginIncompatibility[];\n\n  /**\n   * Queries this plugin can handle.\n   * Declares what query types this plugin responds to via `handleQuery()`.\n   * This replaces the centralized PLUGIN_QUERIES approach with manifest-declared queries.\n   *\n   * @example\n   * ```typescript\n   * queries: [\n   *   { type: 'canMoveColumn', description: 'Check if a column can be moved' },\n   * ],\n   * ```\n   */\n  queries?: QueryDefinition[];\n\n  /**\n   * Events this plugin can emit.\n   * Declares what event types other plugins can subscribe to via `on()`.\n   *\n   * @example\n   * ```typescript\n   * events: [\n   *   { type: 'filter-change', description: 'Emitted when filter criteria change' },\n   * ],\n   * ```\n   */\n  events?: EventDefinition[];\n\n  /**\n   * Whether this plugin's `processRows` hook injects or removes rows\n   * (group headers, tree nodes, pivot aggregates, placeholders, etc.).\n   *\n   * When true, the core sorting module delegates to the render scheduler\n   * instead of sorting `_rows` in-place, because `_rows` may contain\n   * plugin-generated marker objects that would be corrupted by a direct sort.\n   *\n   * Plugins that only **filter** or **reorder** existing rows (e.g. Filtering,\n   * MultiSort) should leave this unset or set it to `false`.\n   */\n  modifiesRowStructure?: boolean;\n}\n\n/** Convert camelCase icon key to kebab-case data-icon attribute value. */\nexport function toIconAttr(key: string): string {\n  return key.replace(/([A-Z])/g, '-$1').toLowerCase();\n}\n\n/**\n * Abstract base class for all grid plugins.\n *\n * @category Plugin Development\n * @template TConfig - Configuration type for the plugin\n * @since 0.1.1\n */\nexport abstract class BaseGridPlugin<TConfig = unknown> implements GridPlugin {\n  /**\n   * Plugin dependencies - declare other plugins this one requires.\n   *\n   * Dependencies are validated when the plugin is attached.\n   * Required dependencies throw an error if missing. Optional dependencies are\n   * silent by default; set a {@link PluginDependency.severity} of `'warn'` or\n   * `'info'` to opt into a development-only log.\n   *\n   * @example\n   * ```typescript\n   * static readonly dependencies: PluginDependency[] = [\n   *   { name: 'editing', required: true, reason: 'Tracks cell edits for undo/redo' },\n   *   { name: 'selection', required: false, reason: 'Enables selection-based undo' },\n   * ];\n   * ```\n   */\n  static readonly dependencies?: PluginDependency[];\n\n  /**\n   * Plugin manifest - declares owned properties, config rules, and hook priorities.\n   *\n   * This is read by the configuration validator to:\n   * - Validate that required plugins are loaded when their properties are used\n   * - Execute configRules to detect invalid/conflicting settings\n   * - Order hook execution based on priority\n   *\n   * @example\n   * ```typescript\n   * static override readonly manifest: PluginManifest<MyConfig> = {\n   *   ownedProperties: [\n   *     { property: 'myProp', level: 'column', description: 'the \"myProp\" column property' },\n   *   ],\n   *   configRules: [\n   *     { id: 'myPlugin/conflict', severity: 'warn', message: '...', check: (c) => c.a && c.b },\n   *   ],\n   * };\n   * ```\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static readonly manifest?: PluginManifest<any>;\n\n  /** Unique plugin identifier (derived from class name by default) */\n  abstract readonly name: string;\n\n  /**\n   * Alternative names for backward compatibility.\n   * `getPluginByName()` matches against both `name` and `aliases`.\n   * @internal\n   */\n  readonly aliases?: readonly string[];\n\n  /**\n   * Plugin version - defaults to grid version for built-in plugins.\n   * Third-party plugins can override with their own semver.\n   */\n  readonly version: string = typeof __GRID_VERSION__ !== 'undefined' ? __GRID_VERSION__ : 'dev';\n\n  /** CSS styles to inject via `document.adoptedStyleSheets` */\n  readonly styles?: string;\n\n  /** Custom cell renderers keyed by type name */\n  readonly cellRenderers?: Record<string, CellRenderer>;\n\n  /** Custom header renderers keyed by type name */\n  readonly headerRenderers?: Record<string, HeaderRenderer>;\n\n  /** Custom cell editors keyed by type name */\n  readonly cellEditors?: Record<string, CellEditor>;\n\n  /** The grid instance this plugin is attached to */\n  protected grid!: GridElement;\n\n  /** Plugin configuration - merged with defaults in attach() */\n  protected config!: TConfig;\n\n  /** User-provided configuration from constructor */\n  protected readonly userConfig: Partial<TConfig>;\n\n  /**\n   * Plugin-level AbortController for event listener cleanup.\n   * Created fresh in attach(), aborted in detach().\n   * This ensures event listeners are properly cleaned up when plugins are re-attached.\n   */\n  #abortController?: AbortController;\n\n  /**\n   * Default configuration - subclasses should override this getter.\n   * Note: This must be a getter (not property initializer) for proper inheritance\n   * since property initializers run after parent constructor.\n   */\n  protected get defaultConfig(): Partial<TConfig> {\n    return {};\n  }\n\n  constructor(config: Partial<TConfig> = {}) {\n    this.userConfig = config;\n  }\n\n  /**\n   * Effective configuration (defaults merged with user config), resolved\n   * eagerly so it is available **before** {@link attach} runs. Dependency\n   * validation happens before `attach()` merges {@link config}, so config\n   * -conditional dependency `when` predicates evaluate against this getter.\n   *\n   * While attached, returns the already-merged {@link config}; otherwise\n   * recomputes `defaultConfig` + `userConfig` fresh. `config` is intentionally\n   * **not** trusted when detached because {@link detach} does not clear it — a\n   * re-validated plugin would otherwise see stale config from a prior\n   * attachment. The {@link attach}-managed abort controller is the\n   * attached/detached signal.\n   * @internal Plugin infrastructure (used by `validatePluginDependencies`).\n   */\n  get resolvedConfig(): TConfig {\n    return (this.#abortController ? this.config : { ...this.defaultConfig, ...this.userConfig }) as TConfig;\n  }\n\n  /**\n   * Merge user-supplied configuration from other plugin instances into this\n   * plugin's `userConfig`. Used by `PluginManager.attachAll()`'s alias-collapse\n   * pre-pass: when a consumer instantiates the same plugin more than once (or\n   * under an alias name), only one instance is attached, and the other\n   * instances' configs are folded in via this method.\n   *\n   * Merge rules (shallow):\n   *\n   * - Same key, **same value** → silent.\n   * - Same key, **different values** (incl. function vs function) → throws\n   *   a diagnostic naming the conflicting key. Conflicting callbacks\n   *   (`canDrag`, `canDrop`, etc.) cannot be reconciled automatically.\n   * - **Disjoint keys** → merged cleanly.\n   *\n   * Subclasses may override to implement custom deep-merge logic, but should\n   * call `super.mergeConfigsFrom(others)` to inherit the conflict-detection.\n   *\n   * @internal Plugin infrastructure (used by `PluginManager.attachAll`).\n   * @throws Error with diagnostic code `TBW025` when configs conflict.\n   */\n  mergeConfigsFrom(others: readonly BaseGridPlugin<TConfig>[]): void {\n    if (others.length === 0) return;\n    const merged = { ...this.userConfig } as Record<string, unknown>;\n    const sources: Record<string, BaseGridPlugin<TConfig>> = {};\n    for (const key of Object.keys(merged)) sources[key] = this;\n    for (const other of others) {\n      const otherConfig = other.userConfig as Record<string, unknown>;\n      for (const [key, value] of Object.entries(otherConfig)) {\n        if (value === undefined) continue;\n        if (!(key in merged)) {\n          merged[key] = value;\n          sources[key] = other;\n          continue;\n        }\n        if (merged[key] === value) continue;\n        // Conflict\n        const ownerA = sources[key]?.constructor.name ?? this.constructor.name;\n        const ownerB = other.constructor.name;\n        const code = formatDiagnostic(\n          PLUGIN_ALIAS_CONFIG_CONFLICT,\n          `Cannot merge plugin configs for \"${this.name}\": conflicting value for \"${key}\" supplied by both ${ownerA} and ${ownerB}. Pass the option on a single instance, or remove the duplicate.`,\n          undefined,\n          this.name,\n        );\n        throw new Error(code);\n      }\n    }\n    // Mutate userConfig in place so re-attach picks it up via attach().\n    // `userConfig` is declared `readonly` to prevent reassigning the binding,\n    // but the object's own properties are intentionally mutable for this\n    // alias-collapse pre-pass. A single cast to a record is enough — no\n    // `as unknown as` double-cast needed.\n    Object.assign(this.userConfig as Record<string, unknown>, merged);\n  }\n\n  /**\n   * Replace this plugin's `userConfig` with a freshly-resolved sibling\n   * instance's config. Used by the grid's per-grid feature-instance gate\n   * (`#initializePlugins`): when a feature is re-resolved across a config\n   * change, the **existing** instance is reused — so its accumulated state\n   * survives — but it must adopt the latest `gridConfig.features.<name>`\n   * value. Unlike {@link mergeConfigsFrom}, this is last-write-wins with no\n   * conflict detection: the re-resolved instance is authoritative.\n   *\n   * `attach()` recomputes {@link config} from `userConfig`, so updating\n   * `userConfig` here is enough for the reused instance to pick up the new\n   * config on its next attach during the same `#initializePlugins` pass.\n   *\n   * @internal Plugin infrastructure (used by the grid feature gate).\n   */\n  refreshUserConfigFrom(other: BaseGridPlugin<TConfig>): void {\n    const target = this.userConfig as Record<string, unknown>;\n    // Snapshot the source BEFORE clearing `target`. A feature factory may\n    // store the consumer's config object by reference (e.g. `new\n    // ContextMenuPlugin(config)`), and a consumer that passes the *same* config\n    // object across re-resolutions (common when `gridConfig` is a recomputed\n    // Angular `computed()`) makes `this.userConfig === other.userConfig`.\n    // Without this snapshot, the `delete` loop below would empty that shared\n    // object first, then `Object.assign` would copy back nothing — silently\n    // wiping the config and falling back to plugin defaults. (#contextMenu)\n    const source = { ...(other.userConfig as Record<string, unknown>) };\n    for (const key of Object.keys(target)) delete target[key];\n    Object.assign(target, source);\n  }\n\n  /**\n   * Called when the plugin is attached to a grid.\n   * Override to set up event listeners, initialize state, etc.\n   *\n   * @example\n   * ```ts\n   * attach(grid: GridElement): void {\n   *   super.attach(grid);\n   *   // Set up document-level listeners with auto-cleanup\n   *   document.addEventListener('keydown', this.handleEscape, {\n   *     signal: this.disconnectSignal\n   *   });\n   * }\n   * ```\n   */\n  attach(grid: GridElement): void {\n    // Abort any previous abort controller (in case of re-attach without detach)\n    this.#abortController?.abort();\n    // Create fresh abort controller for this attachment\n    this.#abortController = new AbortController();\n\n    this.grid = grid;\n    // Merge config here (after subclass construction is complete)\n    this.config = { ...this.defaultConfig, ...this.userConfig } as TConfig;\n  }\n\n  /**\n   * Called when the plugin is detached from a grid.\n   * Override to clean up event listeners, timers, etc.\n   *\n   * @example\n   * ```ts\n   * detach(): void {\n   *   // Clean up any state not handled by disconnectSignal\n   *   this.selectedRows.clear();\n   *   this.cache = null;\n   * }\n   * ```\n   */\n  detach(): void {\n    // Abort the plugin's abort controller to clean up all event listeners\n    // registered with { signal: this.disconnectSignal }\n    this.#abortController?.abort();\n    this.#abortController = undefined;\n    // Override in subclass for additional cleanup\n  }\n\n  /**\n   * Called when another plugin is attached to the same grid.\n   * Use for inter-plugin coordination, e.g., to integrate with new plugins.\n   *\n   * @param name - The name of the plugin that was attached\n   * @param plugin - The plugin instance (for direct access if needed)\n   *\n   * @example\n   * ```ts\n   * onPluginAttached(name: string, plugin: BaseGridPlugin): void {\n   *   if (name === 'selection') {\n   *     // Integrate with selection plugin\n   *     this.selectionPlugin = plugin as SelectionPlugin;\n   *   }\n   * }\n   * ```\n   */\n  onPluginAttached?(name: string, plugin: BaseGridPlugin): void;\n\n  /**\n   * Called when another plugin is detached from the same grid.\n   * Use to clean up inter-plugin references.\n   *\n   * @param name - The name of the plugin that was detached\n   *\n   * @example\n   * ```ts\n   * onPluginDetached(name: string): void {\n   *   if (name === 'selection') {\n   *     this.selectionPlugin = undefined;\n   *   }\n   * }\n   * ```\n   */\n  onPluginDetached?(name: string): void;\n\n  /**\n   * Get another plugin instance from the same grid.\n   * Use for inter-plugin communication.\n   *\n   * **Prefer {@link BaseGridPlugin.grid grid.getPluginByName()}** when you don't need the class import.\n   *\n   * @example\n   * ```ts\n   * // Preferred: by name\n   * const selection = this.grid?.getPluginByName('selection');\n   *\n   * // Alternative: by class\n   * const selection = this.getPlugin(SelectionPlugin);\n   * if (selection) {\n   *   const selectedRows = selection.getSelectedRows();\n   * }\n   * ```\n   */\n  protected getPlugin<T extends BaseGridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined {\n    return this.grid?.getPlugin(PluginClass);\n  }\n\n  /**\n   * Emit a custom event from the grid.\n   */\n  protected emit<T>(eventName: string, detail: T): void {\n    this.grid?.dispatchEvent?.(new CustomEvent(eventName, { detail, bubbles: true }));\n  }\n\n  /**\n   * Emit a cancelable custom event from the grid.\n   * @returns `true` if the event was cancelled (preventDefault called), `false` otherwise\n   */\n  protected emitCancelable<T>(eventName: string, detail: T): boolean {\n    const event = new CustomEvent(eventName, { detail, bubbles: true, cancelable: true });\n    this.grid?.dispatchEvent?.(event);\n    return event.defaultPrevented;\n  }\n\n  // =========================================================================\n  // Event Bus - Plugin-to-Plugin Communication\n  // =========================================================================\n\n  /**\n   * Subscribe to an event from another plugin.\n   * The subscription is automatically cleaned up when this plugin is detached.\n   *\n   * @category Plugin Development\n   * @param eventType - The event type to listen for (e.g., 'filter-change')\n   * @param callback - The callback to invoke when the event is emitted\n   *\n   * @example\n   * ```typescript\n   * // In attach() or other initialization\n   * this.on('filter-change', (detail) => {\n   *   console.log('Filter changed:', detail);\n   * });\n   * ```\n   */\n  protected on<T = unknown>(eventType: string, callback: (detail: T) => void): void {\n    this.grid?._pluginManager?.subscribe(this, eventType, callback as (detail: unknown) => void);\n  }\n\n  /**\n   * Unsubscribe from a plugin event.\n   *\n   * @category Plugin Development\n   * @param eventType - The event type to stop listening for\n   *\n   * @example\n   * ```typescript\n   * this.off('filter-change');\n   * ```\n   */\n  protected off(eventType: string): void {\n    this.grid?._pluginManager?.unsubscribe(this, eventType);\n  }\n\n  /**\n   * Emit an event to other plugins via the Event Bus.\n   * This is for inter-plugin communication only; it does NOT dispatch DOM events.\n   * Use `emit()` to dispatch DOM events that external consumers can listen to.\n   *\n   * @category Plugin Development\n   * @param eventType - The event type to emit (should be declared in manifest.events)\n   * @param detail - The event payload\n   *\n   * @example\n   * ```typescript\n   * // Emit to other plugins (not DOM)\n   * this.emitPluginEvent('filter-change', { field: 'name', value: 'Alice' });\n   *\n   * // For DOM events that consumers can addEventListener to:\n   * this.emit('filter-change', { field: 'name', value: 'Alice' });\n   * ```\n   */\n  protected emitPluginEvent<T>(eventType: string, detail: T): void {\n    this.grid?._pluginManager?.emitPluginEvent(eventType, detail);\n  }\n\n  /**\n   * Emit an event to **both** the plugin Event Bus (for inter-plugin communication)\n   * **and** the DOM (for external consumers via `addEventListener`).\n   *\n   * Use this when a state change is relevant to both other plugins and external\n   * consumers. For example, `sort-change` needs to invalidate Selection (plugin bus)\n   * and notify the host application (DOM event).\n   *\n   * @category Plugin Development\n   * @param eventType - The event type to broadcast\n   * @param detail - The event payload\n   *\n   * @example\n   * ```typescript\n   * // Notify both plugins and consumers of a sort change\n   * this.broadcast('sort-change', { sortModel: [...this.sortModel] });\n   * ```\n   */\n  protected broadcast<T>(eventType: string, detail: T): void {\n    this.emitPluginEvent(eventType, detail);\n    this.emit(eventType, detail);\n  }\n\n  /**\n   * Run a yes/no plugin query and reduce the responses to a single boolean.\n   *\n   * `grid.query()` always returns an **array** of responses (empty when no\n   * plugin handles the query), and `[]` is truthy in JavaScript — so testing\n   * the raw result directly (`if (grid.query(...))`) is always `true` and\n   * silently takes the \"some plugin said yes\" branch even when nothing\n   * answered. Always route boolean queries through this helper.\n   *\n   * @category Plugin Development\n   * @param type - The query type to dispatch\n   * @param context - Optional query context passed to the handlers\n   * @returns `true` only when at least one plugin answered truthily\n   *\n   * @example\n   * ```typescript\n   * if (this.queryBoolean('datasource:is-active')) {\n   *   // A ServerSide data source really is installed\n   * }\n   * ```\n   * @since 3.4.0\n   */\n  protected queryBoolean(type: string, context: unknown = null): boolean {\n    const responses = this.grid?.query?.(type, context);\n    // Tolerate hosts/tests that hand back a bare value instead of the array.\n    return Array.isArray(responses) ? responses.some(Boolean) : !!responses;\n  }\n\n  /**\n   * Request a re-render of the grid.\n   * Uses ROWS phase - does NOT trigger processColumns hooks.\n   */\n  protected requestRender(): void {\n    this.grid?.requestRender?.();\n  }\n\n  /**\n   * Request a columns re-render of the grid.\n   * Uses COLUMNS phase - triggers processColumns hooks.\n   * Use this when your plugin needs to reprocess column configuration.\n   */\n  protected requestColumnsRender(): void {\n    (this.grid as { requestColumnsRender?: () => void })?.requestColumnsRender?.();\n  }\n\n  /**\n   * Request a re-render and restore focus styling afterward.\n   * Use this when a plugin action (like expand/collapse) triggers a render\n   * but needs to maintain keyboard navigation focus.\n   */\n  protected requestRenderWithFocus(): void {\n    this.grid?.requestRenderWithFocus?.();\n  }\n\n  /**\n   * Request a lightweight style update without rebuilding DOM.\n   * Use this instead of requestRender() when only CSS classes need updating.\n   */\n  protected requestAfterRender(): void {\n    this.grid?.requestAfterRender?.();\n  }\n\n  /**\n   * Re-render visible rows without rebuilding the row model or recalculating geometry.\n   * Use this when row data has been updated in-place (e.g., server-side block loads)\n   * and only the visible viewport needs to re-render.\n   */\n  protected requestVirtualRefresh(): void {\n    this.grid?.requestVirtualRefresh?.();\n  }\n\n  /**\n   * Get the current rows from the grid.\n   */\n  protected get rows(): any[] {\n    return this.grid?.rows ?? [];\n  }\n\n  /**\n   * Get the original unfiltered/unprocessed rows from the grid.\n   * Use this when you need all source data regardless of active filters.\n   */\n  protected get sourceRows(): any[] {\n    return this.grid?.sourceRows ?? [];\n  }\n\n  /**\n   * Get the current columns from the grid.\n   */\n  protected get columns(): ColumnConfig[] {\n    return this.grid?.columns ?? [];\n  }\n\n  /**\n   * Get only visible columns from the grid (excludes hidden).\n   * Use this for rendering that needs to match the grid template.\n   */\n  protected get visibleColumns(): ColumnConfig[] {\n    return this.grid?._visibleColumns ?? [];\n  }\n\n  /**\n   * Get the grid as an HTMLElement for direct DOM operations.\n   * Use sparingly - prefer the typed GridElementRef API when possible.\n   *\n   * @example\n   * ```ts\n   * const width = this.gridElement.clientWidth;\n   * this.gridElement.classList.add('my-plugin-active');\n   * ```\n   */\n  protected get gridElement(): HTMLElement {\n    return this.grid?._hostElement;\n  }\n\n  /**\n   * Get the disconnect signal for event listener cleanup.\n   * This signal is aborted when the grid disconnects from the DOM.\n   * Use this when adding event listeners that should be cleaned up automatically.\n   *\n   * Best for:\n   * - Document/window-level listeners added in attach()\n   * - Listeners on the grid element itself\n   * - Any listener that should persist across renders\n   *\n   * Not needed for:\n   * - Listeners on elements created in afterRender() (removed with element)\n   *\n   * @example\n   * element.addEventListener('click', handler, { signal: this.disconnectSignal });\n   * document.addEventListener('keydown', handler, { signal: this.disconnectSignal });\n   */\n  protected get disconnectSignal(): AbortSignal {\n    // Return the plugin's own abort signal for proper cleanup on detach/re-attach\n    // Falls back to grid's signal if plugin's controller not yet created\n    return this.#abortController?.signal ?? this.grid?.disconnectSignal;\n  }\n\n  /**\n   * Get the grid-level icons configuration.\n   * Returns merged icons (user config + defaults).\n   */\n  protected get gridIcons(): Required<GridIcons> {\n    const userIcons = this.grid?.gridConfig?.icons ?? {};\n    return { ...DEFAULT_GRID_ICONS, ...userIcons };\n  }\n\n  /**\n   * Resolve a user-visible string from {@link GridConfig.locale}, falling back to\n   * the English default supplied at the call site.\n   *\n   * The fallback is passed inline rather than read from a shipped default map so\n   * that a plugin's strings live in the plugin's own chunk.\n   *\n   * @param key - Namespaced message id, e.g. `'filter.apply'`.\n   * @param fallback - English text used when the key is not overridden.\n   * @since 3.5.0\n   *\n   * @example\n   * ```ts\n   * applyBtn.textContent = this.t('filter.apply', 'Apply');\n   * ```\n   */\n  protected t(key: string, fallback: string): string {\n    return this.grid?.effectiveConfig?.locale?.[key] ?? fallback;\n  }\n\n  /**\n   * A bound `t()` suitable for handing to standalone renderer\n   * helpers and public renderer callbacks.\n   * @since 3.5.0\n   */\n  protected get translate(): Translate {\n    return (key, fallback) => this.t(key, fallback);\n  }\n\n  // #region Animation Helpers\n\n  /**\n   * Check if animations are enabled at the grid level.\n   * Respects gridConfig.animation.mode and the CSS variable set by the grid.\n   *\n   * Plugins should use this to skip animations when:\n   * - Animation mode is 'off' or `false`\n   * - User prefers reduced motion and mode is 'reduced-motion' (default)\n   *\n   * @example\n   * ```ts\n   * private get animationStyle(): 'slide' | 'fade' | false {\n   *   if (!this.isAnimationEnabled) return false;\n   *   return this.config.animation ?? 'slide';\n   * }\n   * ```\n   */\n  protected get isAnimationEnabled(): boolean {\n    const mode = this.grid?.effectiveConfig?.animation?.mode ?? 'reduced-motion';\n\n    // Explicit off = disabled\n    if (mode === false || mode === 'off') return false;\n\n    // Explicit on = always enabled\n    if (mode === true || mode === 'on') return true;\n\n    // reduced-motion: check CSS variable (set by grid based on media query)\n    const host = this.gridElement;\n    if (host) {\n      const enabled = getComputedStyle(host).getPropertyValue('--tbw-animation-enabled').trim();\n      return enabled !== '0';\n    }\n\n    return true; // Default to enabled\n  }\n\n  /**\n   * Get the animation duration in milliseconds from CSS variable.\n   * Falls back to 200ms if not set.\n   *\n   * Plugins can use this for their animation timing to stay consistent\n   * with the grid-level animation.duration setting.\n   *\n   * @example\n   * ```ts\n   * element.animate(keyframes, { duration: this.animationDuration });\n   * ```\n   */\n  protected get animationDuration(): number {\n    const host = this.gridElement;\n    if (host) {\n      const durationStr = getComputedStyle(host).getPropertyValue('--tbw-animation-duration').trim();\n      const parsed = parseInt(durationStr, 10);\n      if (!isNaN(parsed)) return parsed;\n    }\n    return 200; // Default\n  }\n\n  // #endregion\n\n  /**\n   * Set an icon on an element using the CSS-first hybrid approach.\n   *\n   * Sets `data-icon` for CSS pseudo-element rendering and `data-expanded` for\n   * expand/collapse toggle elements. Only injects DOM content when a JS override\n   * is present (via `gridConfig.icons` or `pluginOverride`), which naturally\n   * suppresses the CSS `::before` via the `:empty` selector.\n   *\n   * @param element - The element to set the icon on\n   * @param iconKey - The icon key in GridIcons (e.g., 'expand', 'collapse')\n   * @param pluginOverride - Optional plugin-level override (string or HTMLElement)\n   */\n  protected setIcon(element: HTMLElement, iconKey: keyof GridIcons, pluginOverride?: IconValue): void {\n    // Set data-icon attribute for CSS targeting (always)\n    element.dataset.icon = toIconAttr(iconKey);\n\n    // Set data-expanded for toggle elements (tree, group, master-detail)\n    if (iconKey === 'collapse') {\n      element.dataset.expanded = '';\n    } else if (iconKey === 'expand') {\n      delete element.dataset.expanded;\n    }\n\n    // Resolve JS-only icon (returns undefined when CSS default should be used)\n    const jsIcon = this.#resolveJsIcon(iconKey, pluginOverride);\n\n    if (jsIcon !== undefined) {\n      // JS override: inject content (suppresses CSS ::before via :empty)\n      if (typeof jsIcon === 'string') {\n        setSanitizedHTML(element, jsIcon);\n      } else if (jsIcon instanceof HTMLElement) {\n        element.replaceChildren(jsIcon.cloneNode(true));\n      }\n    } else {\n      // CSS path: ensure element is empty so ::before renders\n      element.innerHTML = '';\n    }\n  }\n\n  /**\n   * Resolve JS-only icon override. Returns undefined if CSS default should render.\n   * Only returns a value when the user explicitly set gridConfig.icons[key] or\n   * the plugin passed an override.\n   */\n  #resolveJsIcon(iconKey: keyof GridIcons, pluginOverride?: IconValue): IconValue | undefined {\n    if (pluginOverride !== undefined) return pluginOverride;\n    return this.grid?.gridConfig?.icons?.[iconKey];\n  }\n\n  /**\n   * Create or replace a sort indicator on a header cell.\n   *\n   * Handles the full lifecycle: removes any existing indicator, creates a new\n   * `<span part=\"sort-indicator\" class=\"sort-indicator\">` with the appropriate\n   * icon, sets `aria-sort` / `data-sort` attributes, and inserts it before the\n   * filter button or resize handle.\n   *\n   * Plugins decide **which** cells and **when** — this method handles **how**.\n   *\n   * @param cell - The header cell element\n   * @param direction - `'asc'` | `'desc'` for sorted, `null` for unsorted idle state\n   * @returns The created indicator element (useful for appending badges, etc.)\n   */\n  protected updateSortIndicator(cell: Element, direction: 'asc' | 'desc' | null): HTMLElement {\n    // Remove any existing indicator (core uses part, plugins use class)\n    cell.querySelector('[part~=\"sort-indicator\"], .sort-indicator')?.remove();\n\n    const indicator = document.createElement('span');\n    indicator.setAttribute('part', 'sort-indicator');\n    indicator.className = 'sort-indicator';\n\n    if (direction) {\n      cell.setAttribute('aria-sort', direction === 'asc' ? 'ascending' : 'descending');\n      cell.setAttribute('data-sort', direction);\n      this.setIcon(indicator, direction === 'asc' ? 'sortAsc' : 'sortDesc');\n    } else {\n      cell.setAttribute('aria-sort', 'none');\n      cell.removeAttribute('data-sort');\n      this.setIcon(indicator, 'sortNone');\n    }\n\n    // Insert before filter button or resize handle to maintain DOM order\n    const insertBefore = cell.querySelector('.tbw-filter-btn') ?? cell.querySelector('.resize-handle');\n    if (insertBefore) {\n      cell.insertBefore(indicator, insertBefore);\n    } else {\n      cell.appendChild(indicator);\n    }\n\n    return indicator;\n  }\n\n  /**\n   * Log a warning with an optional diagnostic code.\n   *\n   * When a diagnostic code is provided, the message is formatted with the code\n   * and a link to the troubleshooting docs.\n   *\n   * @example\n   * ```ts\n   * this.warn('Something went wrong');                          // plain\n   * this.warn(MISSING_BREAKPOINT, 'Set a breakpoint'); // with code + docs link\n   * ```\n   */\n  protected warn(message: string): void;\n  protected warn(code: DiagnosticCode, message: string): void;\n  protected warn(codeOrMessage: DiagnosticCode | string, message?: string): void {\n    if (message !== undefined) {\n      // Called with (code, message)\n      console.warn(formatDiagnostic(codeOrMessage as DiagnosticCode, message, this.gridElement.id, this.name));\n    } else {\n      // Called with (message) — plain warning, no diagnostic code\n      console.warn(`${gridPrefix(this.gridElement.id, this.name)} ${codeOrMessage}`);\n    }\n  }\n\n  /**\n   * Throw an error with a diagnostic code and docs link.\n   * Use for configuration errors and API misuse that should halt execution.\n   */\n  protected throwDiagnostic(code: DiagnosticCode, message: string): never {\n    throw new Error(formatDiagnostic(code, message, this.gridElement.id, this.name));\n  }\n\n  // #region Lifecycle Hooks\n\n  /**\n   * Transform rows before rendering.\n   * Called during each render cycle before rows are rendered to the DOM.\n   * Use this to filter, sort, or add computed properties to rows.\n   *\n   * @param rows - The current rows array (readonly to encourage returning a new array)\n   * @returns The modified rows array to render\n   *\n   * @example\n   * ```ts\n   * processRows(rows: readonly any[]): any[] {\n   *   // Filter out hidden rows\n   *   return rows.filter(row => !row._hidden);\n   * }\n   * ```\n   *\n   * @example\n   * ```ts\n   * processRows(rows: readonly any[]): any[] {\n   *   // Add computed properties\n   *   return rows.map(row => ({\n   *     ...row,\n   *     _fullName: `${row.firstName} ${row.lastName}`\n   *   }));\n   * }\n   * ```\n   */\n  processRows?(rows: readonly any[]): any[];\n\n  /**\n   * Contribute to the grid's effective configuration during each config merge.\n   * Called by {@link ConfigManager.merge} after the base config is assembled,\n   * before it becomes `effectiveConfig`. Mutate `config` in place to inject\n   * plugin-derived settings (e.g. the shell plugin folds its light-DOM /\n   * API-registered state into `config.shell`).\n   *\n   * This is the config-pipeline counterpart to {@link processColumns} /\n   * {@link processRows}: it keeps the core config merge free of any plugin\n   * knowledge — each plugin owns the shape it contributes.\n   *\n   * @param config - The mutable base config being assembled into effectiveConfig.\n   *\n   * @example\n   * ```ts\n   * processConfig(config: GridConfig): void {\n   *   config.shell = { ...config.shell, header: { title: this.#title } };\n   * }\n   * ```\n   */\n  processConfig?(config: GridConfig): void;\n\n  /**\n   * Transform columns before rendering.\n   * Called during each render cycle before column headers and cells are rendered.\n   * Use this to add, remove, or modify column definitions.\n   *\n   * @param columns - The current columns array (readonly to encourage returning a new array)\n   * @returns The modified columns array to render\n   *\n   * @example\n   * ```ts\n   * processColumns(columns: readonly ColumnConfig[]): ColumnConfig[] {\n   *   // Add a selection checkbox column\n   *   return [\n   *     { field: '_select', header: '', width: 40 },\n   *     ...columns\n   *   ];\n   * }\n   * ```\n   */\n  processColumns?(columns: readonly ColumnConfig[]): ColumnConfig[];\n\n  /**\n   * Called before each render cycle begins.\n   * Use this to prepare state or cache values needed during rendering.\n   *\n   * **Note:** This hook is currently a placeholder for future implementation.\n   * It is defined in the interface but not yet invoked by the grid's render pipeline.\n   * If you need this functionality, please open an issue or contribute an implementation.\n   *\n   * @example\n   * ```ts\n   * beforeRender(): void {\n   *   this.visibleRowCount = this.calculateVisibleRows();\n   * }\n   * ```\n   */\n  beforeRender?(): void;\n\n  /**\n   * Called after each render cycle completes.\n   * Use this for DOM manipulation, adding event listeners to rendered elements,\n   * or applying visual effects like selection highlights.\n   *\n   * @example\n   * ```ts\n   * afterRender(): void {\n   *   // Apply selection styling to rendered rows\n   *   const rows = this.gridElement?.querySelectorAll('.data-grid-row');\n   *   rows?.forEach((row, i) => {\n   *     row.classList.toggle('selected', this.selectedRows.has(i));\n   *   });\n   * }\n   * ```\n   */\n  afterRender?(): void;\n\n  /**\n   * Called synchronously immediately after the grid (re)builds its root DOM\n   * structure, before the browser has a chance to paint.\n   *\n   * Unlike {@link afterRender} (which runs in the scheduler's STYLE phase and\n   * may be deferred), this hook fires inside the same task as the structural\n   * DOM build. It is the correct place for plugins that need to wrap, relocate,\n   * or augment the freshly built grid DOM without a flash of unstyled/unwrapped\n   * content — e.g. a shell that moves the grid content into a chrome wrapper.\n   *\n   * The grid emits this hook every time it performs a full structural rebuild\n   * (initial connect and structural changes), but NOT on the scroll/data hot\n   * path. Implementations MUST be idempotent: a full rebuild discards any DOM a\n   * previous invocation produced, so re-create it, and no-op when the desired\n   * structure is already present.\n   *\n   * @example\n   * ```ts\n   * afterStructuralRender(): void {\n   *   const root = this.grid?._renderRoot;\n   *   if (!root || root.querySelector('.my-wrapper > .tbw-grid-content')) return;\n   *   // build wrapper, move .tbw-grid-content inside it\n   * }\n   * ```\n   */\n  afterStructuralRender?(): void;\n\n  /**\n   * Called synchronously by the grid immediately before it tears down and\n   * rebuilds its root DOM structure (a structural re-render). Plugins that\n   * relocated existing light-DOM nodes into their own chrome (e.g. a shell that\n   * moves toolbar buttons into the header bar) use this to move those nodes back\n   * to their original container so they survive the rebuild. Generic\n   * counterpart to {@link afterStructuralRender}. MUST be idempotent.\n   */\n  beforeStructuralRender?(): void;\n\n  /**\n   * Called by the grid after a config merge to ask whether the change requires a\n   * full structural re-render (rather than a cheaper in-place update). A plugin\n   * returns `true` when its rendered DOM signature no longer matches the new\n   * effective config — e.g. a shell header appearing/disappearing or a tool\n   * panel's count/position/mode changing. The grid performs a structural\n   * re-render if ANY plugin returns `true`. MUST be side-effect free.\n   */\n  needsStructuralRerender?(): boolean;\n\n  /**\n   * Called by the grid to let a plugin (re-)parse its own light-DOM\n   * contributions into plugin state ahead of a config merge. Generic seam that\n   * keeps core free of plugin-specific light-DOM tag knowledge (the plugin reads\n   * `this.grid._hostElement`). MUST be idempotent.\n   */\n  parseLightDom?(): void;\n\n  /**\n   * Called by the grid (from `refreshColumns` and the light-DOM observer) to\n   * let a plugin re-parse its light-DOM contributions AND refresh any\n   * already-rendered chrome in place when something changed — e.g. a shell\n   * title or tool buttons that a framework projected asynchronously after the\n   * initial render. Distinct from {@link parseLightDom}, which only updates\n   * plugin state. Generic seam — core holds no plugin-specific knowledge. MUST\n   * be idempotent and a no-op when the plugin's chrome is not yet rendered.\n   */\n  syncLightDom?(): void;\n\n  /**\n   * Called after each cell is rendered.\n   * This hook is more efficient than `afterRender()` for cell-level modifications\n   * because you receive the cell context directly - no DOM queries needed.\n   *\n   * Use cases:\n   * - Adding selection/highlight classes to specific cells\n   * - Injecting badges or decorations\n   * - Applying conditional styling based on cell value\n   *\n   * Performance note: Called for every visible cell during render. Keep implementation fast.\n   * This hook is also called during scroll when cells are recycled.\n   *\n   * @param context - The cell render context with row, column, value, and elements\n   *\n   * @example\n   * ```ts\n   * afterCellRender(context: AfterCellRenderContext): void {\n   *   // Add selection class without DOM queries\n   *   if (this.isSelected(context.rowIndex, context.colIndex)) {\n   *     context.cellElement.classList.add('selected');\n   *   }\n   *\n   *   // Add validation error styling\n   *   if (this.hasError(context.row, context.column.field)) {\n   *     context.cellElement.classList.add('has-error');\n   *   }\n   * }\n   * ```\n   */\n  afterCellRender?(context: AfterCellRenderContext): void;\n\n  /**\n   * Called after a row is fully rendered (all cells complete).\n   * Use this for row-level decorations, styling, or ARIA attributes.\n   *\n   * Common use cases:\n   * - Adding selection classes to entire rows (row-focus, selected)\n   * - Setting row-level ARIA attributes\n   * - Applying row validation highlighting\n   * - Tree indentation styling\n   *\n   * Performance note: Called for every visible row during render. Keep implementation fast.\n   * This hook is also called during scroll when rows are recycled.\n   *\n   * @param context - The row render context with row data and element\n   *\n   * @example\n   * ```ts\n   * afterRowRender(context: AfterRowRenderContext): void {\n   *   // Add row selection class without DOM queries\n   *   if (this.isRowSelected(context.rowIndex)) {\n   *     context.rowElement.classList.add('selected', 'row-focus');\n   *   }\n   *\n   *   // Add validation error styling\n   *   if (this.rowHasErrors(context.row)) {\n   *     context.rowElement.classList.add('has-errors');\n   *   }\n   * }\n   * ```\n   */\n  afterRowRender?(context: AfterRowRenderContext): void;\n\n  /**\n   * Called after scroll-triggered row rendering completes.\n   * This is a lightweight hook for applying visual state to recycled DOM elements.\n   * Use this instead of afterRender when you need to reapply styling during scroll.\n   *\n   * Performance note: This is called frequently during scroll. Keep implementation fast.\n   *\n   * @example\n   * ```ts\n   * onScrollRender(): void {\n   *   // Reapply selection state to visible cells\n   *   this.applySelectionToVisibleCells();\n   * }\n   * ```\n   */\n  onScrollRender?(): void;\n\n  /**\n   * Get the height of a specific row.\n   * Used for synthetic rows (group headers, detail panels, etc.) that have fixed heights.\n   * Return undefined if this plugin does not manage the height for this row.\n   *\n   * This hook is called during position cache rebuilds for variable row height virtualization.\n   * Plugins that create synthetic rows should implement this to provide accurate heights.\n   *\n   * @param row - The row data\n   * @param index - The row index in the processed rows array\n   * @returns The row height in pixels, or undefined if not managed by this plugin\n   */\n  getRowHeight?(row: unknown, index: number): number | undefined;\n\n  /**\n   * Adjust the virtualization start index to render additional rows before the visible range.\n   * Use this when expanded content (like detail rows) needs its parent row to remain rendered\n   * even when the parent row itself has scrolled above the viewport.\n   *\n   * @param start - The calculated start row index\n   * @param scrollTop - The current scroll position\n   * @param rowHeight - The height of a single row\n   * @returns The adjusted start index (lower than or equal to original start)\n   *\n   * @example\n   * ```ts\n   * adjustVirtualStart(start: number, scrollTop: number, rowHeight: number): number {\n   *   // If row 5 is expanded and scrolled partially, keep it rendered\n   *   for (const expandedRowIndex of this.expandedRowIndices) {\n   *     const expandedRowTop = expandedRowIndex * rowHeight;\n   *     const expandedRowBottom = expandedRowTop + rowHeight + this.detailHeight;\n   *     if (expandedRowBottom > scrollTop && expandedRowIndex < start) {\n   *       return expandedRowIndex;\n   *     }\n   *   }\n   *   return start;\n   * }\n   * ```\n   */\n  adjustVirtualStart?(start: number, scrollTop: number, rowHeight: number): number;\n\n  /**\n   * Render a custom row, bypassing the default row rendering.\n   * Use this for special row types like group headers, detail rows, or footers.\n   *\n   * @param row - The row data object\n   * @param rowEl - The row DOM element to render into\n   * @param rowIndex - The index of the row in the data array\n   * @returns `true` if the plugin handled rendering (prevents default), `false`/`void` for default rendering\n   *\n   * @example\n   * ```ts\n   * renderRow(row: any, rowEl: HTMLElement, rowIndex: number): boolean | void {\n   *   if (row._isGroupHeader) {\n   *     rowEl.innerHTML = `<div class=\"group-header\">${row._groupLabel}</div>`;\n   *     return true; // Handled - skip default rendering\n   *   }\n   *   // Return void to let default rendering proceed\n   * }\n   * ```\n   */\n  renderRow?(row: any, rowEl: HTMLElement, rowIndex: number): boolean | void;\n\n  // #endregion\n\n  // #region Inter-Plugin Communication\n\n  /**\n   * Handle queries from other plugins or the grid.\n   *\n   * Queries are declared in `manifest.queries` and dispatched via `grid.query()`.\n   * This enables type-safe, discoverable inter-plugin communication.\n   *\n   * @category Plugin Development\n   * @param query - The query object with type and context\n   * @returns Query-specific response, or undefined if not handling this query\n   *\n   * @example\n   * ```ts\n   * // In manifest\n   * static override readonly manifest: PluginManifest = {\n   *   queries: [\n   *     { type: 'canMoveColumn', description: 'Check if a column can be moved' },\n   *   ],\n   * };\n   *\n   * // In plugin class\n   * handleQuery(query: PluginQuery): unknown {\n   *   if (query.type === 'canMoveColumn') {\n   *     const column = query.context as ColumnConfig;\n   *     return !column.sticky; // Can't move sticky columns\n   *   }\n   * }\n   * ```\n   */\n  handleQuery?(query: PluginQuery): unknown;\n\n  // #endregion\n\n  // #region Interaction Hooks\n\n  /**\n   * Handle keyboard events on the grid.\n   * Called when a key is pressed while the grid or a cell has focus.\n   *\n   * @param event - The native KeyboardEvent\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\n   *\n   * @example\n   * ```ts\n   * onKeyDown(event: KeyboardEvent): boolean | void {\n   *   // Handle Ctrl+A for select all\n   *   if (event.ctrlKey && event.key === 'a') {\n   *     this.selectAllRows();\n   *     return true; // Prevent default browser select-all\n   *   }\n   * }\n   * ```\n   */\n  onKeyDown?(event: KeyboardEvent): boolean | void;\n\n  /**\n   * Handle cell click events.\n   * Called when a data cell is clicked (not headers).\n   *\n   * @param event - Cell click event with row/column context\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\n   *\n   * @example\n   * ```ts\n   * onCellClick(event: CellClickEvent): boolean | void {\n   *   if (event.field === '_select') {\n   *     this.toggleRowSelection(event.rowIndex);\n   *     return true; // Handled\n   *   }\n   * }\n   * ```\n   */\n  onCellClick?(event: CellClickEvent): boolean | void;\n\n  /**\n   * Handle row click events.\n   * Called when any part of a data row is clicked.\n   * Note: This is called in addition to onCellClick, not instead of.\n   *\n   * @param event - Row click event with row context\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\n   *\n   * @example\n   * ```ts\n   * onRowClick(event: RowClickEvent): boolean | void {\n   *   if (this.config.mode === 'row') {\n   *     this.selectRow(event.rowIndex, event.originalEvent);\n   *     return true;\n   *   }\n   * }\n   * ```\n   */\n  onRowClick?(event: RowClickEvent): boolean | void;\n\n  /**\n   * Handle header click events.\n   * Called when a column header is clicked. Commonly used for sorting.\n   *\n   * @param event - Header click event with column context\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\n   *\n   * @example\n   * ```ts\n   * onHeaderClick(event: HeaderClickEvent): boolean | void {\n   *   if (event.column.sortable !== false) {\n   *     this.toggleSort(event.field);\n   *     return true;\n   *   }\n   * }\n   * ```\n   */\n  onHeaderClick?(event: HeaderClickEvent): boolean | void;\n\n  /**\n   * Handle scroll events on the grid viewport.\n   * Called during scrolling. Note: This may be called frequently; debounce if needed.\n   *\n   * @param event - Scroll event with scroll position and viewport dimensions\n   *\n   * @example\n   * ```ts\n   * onScroll(event: ScrollEvent): void {\n   *   // Update sticky column positions\n   *   this.updateStickyPositions(event.scrollLeft);\n   * }\n   * ```\n   */\n  onScroll?(event: ScrollEvent): void;\n\n  /**\n   * Handle cell mousedown events.\n   * Used for initiating drag operations like range selection or column resize.\n   *\n   * @param event - Mouse event with cell context\n   * @returns `true` to indicate drag started (prevents text selection), `false`/`void` otherwise\n   *\n   * @example\n   * ```ts\n   * onCellMouseDown(event: CellMouseEvent): boolean | void {\n   *   if (event.rowIndex !== undefined && this.config.mode === 'range') {\n   *     this.startDragSelection(event.rowIndex, event.colIndex);\n   *     return true; // Prevent text selection\n   *   }\n   * }\n   * ```\n   */\n  onCellMouseDown?(event: CellMouseEvent): boolean | void;\n\n  /**\n   * Handle cell mousemove events during drag operations.\n   * Only called when a drag is in progress (after mousedown returned true).\n   *\n   * @param event - Mouse event with current cell context\n   * @returns `true` to continue handling the drag, `false`/`void` otherwise\n   *\n   * @example\n   * ```ts\n   * onCellMouseMove(event: CellMouseEvent): boolean | void {\n   *   if (this.isDragging && event.rowIndex !== undefined) {\n   *     this.extendSelection(event.rowIndex, event.colIndex);\n   *     return true;\n   *   }\n   * }\n   * ```\n   */\n  onCellMouseMove?(event: CellMouseEvent): boolean | void;\n\n  /**\n   * Handle cell mouseup events to end drag operations.\n   *\n   * @param event - Mouse event with final cell context\n   * @returns `true` if drag was finalized, `false`/`void` otherwise\n   *\n   * @example\n   * ```ts\n   * onCellMouseUp(event: CellMouseEvent): boolean | void {\n   *   if (this.isDragging) {\n   *     this.finalizeDragSelection();\n   *     this.isDragging = false;\n   *     return true;\n   *   }\n   * }\n   * ```\n   */\n  onCellMouseUp?(event: CellMouseEvent): boolean | void;\n\n  // Note: Context menu items are provided via handleQuery('getContextMenuItems').\n  // This keeps the core decoupled from the context-menu plugin specifics.\n\n  // #endregion\n\n  // #region Column State Hooks\n\n  /**\n   * Contribute plugin-specific state for a column.\n   * Called by the grid when collecting column state for serialization.\n   * Plugins can add their own properties to the column state.\n   *\n   * @param field - The field name of the column\n   * @returns Partial column state with plugin-specific properties, or undefined if no state to contribute\n   *\n   * @example\n   * ```ts\n   * getColumnState(field: string): Partial<ColumnState> | undefined {\n   *   const filterModel = this.filterModels.get(field);\n   *   if (filterModel) {\n   *     // Uses module augmentation to add filter property to ColumnState\n   *     return { filter: filterModel } as Partial<ColumnState>;\n   *   }\n   *   return undefined;\n   * }\n   * ```\n   */\n  getColumnState?(field: string): Partial<ColumnState> | undefined;\n\n  /**\n   * Apply plugin-specific state to a column.\n   * Called by the grid when restoring column state from serialized data.\n   * Plugins should restore their internal state based on the provided state.\n   *\n   * @param field - The field name of the column\n   * @param state - The column state to apply (may contain plugin-specific properties)\n   *\n   * @example\n   * ```ts\n   * applyColumnState(field: string, state: ColumnState): void {\n   *   // Check for filter property added via module augmentation\n   *   const filter = (state as any).filter;\n   *   if (filter) {\n   *     this.filterModels.set(field, filter);\n   *     this.applyFilter();\n   *   }\n   * }\n   * ```\n   */\n  applyColumnState?(field: string, state: ColumnState): void;\n\n  // #endregion\n\n  // #region Scroll Boundary Hooks\n\n  /**\n   * Report horizontal scroll boundary offsets for this plugin.\n   * Plugins that obscure part of the scroll area (e.g., pinned/sticky columns)\n   * should return how much space they occupy on each side.\n   * The keyboard navigation uses this to ensure focused cells are fully visible.\n   *\n   * @param rowEl - The row element (optional, for calculating widths from rendered cells)\n   * @param focusedCell - The currently focused cell element (optional, to determine if scrolling should be skipped)\n   * @returns Object with left/right pixel offsets and optional skipScroll flag, or undefined if plugin has no offsets\n   *\n   * @example\n   * ```ts\n   * getHorizontalScrollOffsets(rowEl?: HTMLElement, focusedCell?: HTMLElement): { left: number; right: number; skipScroll?: boolean } | undefined {\n   *   // Calculate total width of left-pinned columns\n   *   const leftCells = rowEl?.querySelectorAll('.sticky-left') ?? [];\n   *   let left = 0;\n   *   leftCells.forEach(el => { left += (el as HTMLElement).offsetWidth; });\n   *   // Skip scroll if focused cell is pinned (always visible)\n   *   const skipScroll = focusedCell?.classList.contains('sticky-left');\n   *   return { left, right: 0, skipScroll };\n   * }\n   * ```\n   */\n  getHorizontalScrollOffsets?(\n    rowEl?: HTMLElement,\n    focusedCell?: HTMLElement,\n  ): { left: number; right: number; skipScroll?: boolean } | undefined;\n\n  /**\n   * Report vertical scroll boundary offsets for this plugin.\n   * Plugins that overlay the top or bottom of the rows viewport (e.g. sticky\n   * row clones) should return how much space they obscure on each edge, so\n   * keyboard navigation can scroll a focused row clear of the overlay rather\n   * than leaving it hidden underneath — WCAG 2.2 SC 2.4.11 Focus Not Obscured.\n   *\n   * Only report space that is painted *over* the scrollable rows. Content that\n   * takes part in normal flow (pinned-row bars, the column header) already\n   * shrinks the viewport and must NOT be reported here, or rows would scroll\n   * twice as far as needed.\n   *\n   * @param focusedRowIndex - Index of the row being scrolled into view, so a plugin can report `skipScroll` when it already renders that row in a permanently visible overlay\n   * @returns Object with top/bottom pixel offsets and optional skipScroll flag, or undefined if plugin obscures nothing\n   *\n   * @example\n   * ```ts\n   * getVerticalScrollOffsets(focusedRowIndex?: number): { top: number; bottom: number; skipScroll?: boolean } | undefined {\n   *   if (!this.overlayEl) return undefined;\n   *   // The row is already pinned in the overlay — it is visible where it is.\n   *   if (focusedRowIndex != null && this.stuckIndices.includes(focusedRowIndex)) {\n   *     return { top: 0, bottom: 0, skipScroll: true };\n   *   }\n   *   return { top: this.overlayEl.offsetHeight, bottom: 0 };\n   * }\n   * ```\n   *\n   * @since 3.6.0\n   */\n  getVerticalScrollOffsets?(\n    focusedRowIndex?: number,\n  ): { top: number; bottom: number; skipScroll?: boolean } | undefined;\n\n  // #endregion\n\n  // #region Shell Integration Hooks\n\n  /**\n   * Register a tool panel for this plugin.\n   * Return undefined if plugin has no tool panel.\n   * The shell will create a toolbar toggle button and render the panel content\n   * when the user opens the panel.\n   *\n   * @returns Tool panel definition, or undefined if plugin has no panel\n   *\n   * @example\n   * ```ts\n   * getToolPanel(): ToolPanelDefinition | undefined {\n   *   return {\n   *     id: 'columns',\n   *     title: 'Columns',\n   *     icon: '☰',\n   *     tooltip: 'Show/hide columns',\n   *     order: 10,\n   *     render: (container) => {\n   *       this.renderColumnList(container);\n   *       return () => this.cleanup();\n   *     },\n   *   };\n   * }\n   * ```\n   */\n  getToolPanel?(): ToolPanelDefinition | undefined;\n\n  /**\n   * Register content for the shell header center section.\n   * Return undefined if plugin has no header content.\n   * Examples: search input, selection summary, status indicators.\n   *\n   * @returns Header content definition, or undefined if plugin has no header content\n   *\n   * @example\n   * ```ts\n   * getHeaderContent(): HeaderContentDefinition | undefined {\n   *   return {\n   *     id: 'quick-filter',\n   *     order: 10,\n   *     render: (container) => {\n   *       const input = document.createElement('input');\n   *       input.type = 'text';\n   *       input.placeholder = 'Search...';\n   *       input.addEventListener('input', this.handleInput);\n   *       container.appendChild(input);\n   *       return () => input.removeEventListener('input', this.handleInput);\n   *     },\n   *   };\n   * }\n   * ```\n   */\n  getHeaderContent?(): HeaderContentDefinition | undefined;\n\n  // #endregion\n}\n","/**\n * Generic click-only action menu — the shared building block for WCAG 2.2\n * SC 2.5.7 \"Dragging Movements\" alternatives in plugins.\n *\n * Every drag affordance in the grid needs a path that works with plain clicks\n * or taps. A keyboard equivalent is **not** enough: SC 2.5.7 is specifically\n * about pointer input, and the W3C Understanding text calls out \"a pop-up menu\n * after tap\" as a conforming alternative. This module is that pop-up.\n *\n * Lives under `plugins/shared/` on purpose: each plugin bundle is built\n * self-contained, so this code is duplicated into the plugins that use it and\n * never lands in the core `index.js` budget.\n *\n * @since 3.6.0\n * @internal\n */\n\n/** Gap between the anchor element and the menu, in px. */\nconst ANCHOR_GAP_PX = 6;\n\n/** Runtime check — happy-dom and older browsers may lack the Popover API. */\nfunction supportsPopover(): boolean {\n  return typeof HTMLElement.prototype?.showPopover === 'function';\n}\n\nlet hoverlessQuery: MediaQueryList | null | undefined;\n\n/** Whether the primary pointer cannot hover (touch, most switch devices). */\nfunction isHoverless(): boolean {\n  if (hoverlessQuery === undefined) hoverlessQuery = globalThis.matchMedia?.('(hover: none)') ?? null;\n  return hoverlessQuery?.matches ?? false;\n}\n\n/**\n * Whether a plugin should also expose its drag alternative as a dedicated\n * inline control, on top of the menu that is always available.\n *\n * Hover-less pointers get one unconditionally — a control revealed on hover is\n * unreachable when nothing can hover, and long-press is the wrong fallback for\n * the tremor and low-dexterity users SC 2.5.7 exists for.\n *\n * Driven by `a11y.dragAlternatives` on the grid config.\n */\nexport function prefersInlineDragAlternative(grid: {\n  effectiveConfig?: { a11y?: { dragAlternatives?: 'menu' | 'inline' } };\n}): boolean {\n  return grid.effectiveConfig?.a11y?.dragAlternatives === 'inline' || isHoverless();\n}\n\n/** One clickable entry in the menu. */\nexport interface DragAlternativeAction {\n  /** Visible text, also the accessible name. */\n  label: string;\n  /** Render the entry but refuse the click (e.g. \"Move up\" on the first row). */\n  disabled?: boolean;\n  /** Invoked on click; the menu closes first so focus handling is predictable. */\n  run(): void;\n}\n\nexport interface DragAlternativeMenu {\n  /**\n   * Show `actions` anchored to `anchor`, with `label` as the group's accessible\n   * name. Mounted inside the anchor's grid host so it inherits theme tokens.\n   */\n  open(anchor: HTMLElement, label: string, actions: readonly DragAlternativeAction[]): void;\n  /** Hide the menu. Safe to call when already closed. */\n  close(): void;\n  /** Remove the element and every document-level listener. */\n  dispose(): void;\n  /** The menu element, or `null` before the first {@link DragAlternativeMenu.open}. */\n  readonly element: HTMLElement | null;\n}\n\n/**\n * Create a menu instance.\n *\n * @param id - DOM id for the menu element, unique per owning plugin.\n * @param className - Root class name, so each plugin can style its own menu.\n */\nexport function createDragAlternativeMenu(id: string, className: string): DragAlternativeMenu {\n  let root: HTMLDivElement | null = null;\n  let opened = false;\n  let disposed = false;\n  const abort = new AbortController();\n\n  function close(): void {\n    if (!opened || !root) return;\n    opened = false;\n    if (supportsPopover()) root.hidePopover();\n    root.hidden = true;\n  }\n\n  function build(): HTMLDivElement {\n    const el = document.createElement('div');\n    el.id = id;\n    el.className = className;\n    el.setAttribute('popover', 'manual');\n    el.setAttribute('role', 'group');\n    // Without the Popover API there is no UA `display: none`, so hide it here.\n    el.hidden = true;\n    // Tabbing past either end dismisses instead of stranding the user — the\n    // menu has no visible trigger to tab back to. A null `relatedTarget` (click\n    // focus in Firefox/Safari, focus leaving the document) is ignored.\n    el.addEventListener(\n      'focusout',\n      (e) => {\n        const next = (e as FocusEvent).relatedTarget;\n        if (next instanceof Node && !el.contains(next)) close();\n      },\n      { signal: abort.signal },\n    );\n    return el;\n  }\n\n  /**\n   * Position against the anchor in viewport coordinates. The menu lives in the\n   * top layer, so its containing block is the viewport regardless of where the\n   * anchor sits in the DOM.\n   */\n  function place(anchor: HTMLElement): void {\n    if (!root) return;\n    const a = anchor.getBoundingClientRect();\n    const box = root.getBoundingClientRect();\n    const left = Math.max(4, Math.min(a.left, window.innerWidth - box.width - 4));\n    const below = a.bottom + ANCHOR_GAP_PX;\n    const top = below + box.height <= window.innerHeight ? below : Math.max(4, a.top - ANCHOR_GAP_PX - box.height);\n    root.style.left = `${Math.round(left)}px`;\n    root.style.top = `${Math.round(top)}px`;\n  }\n\n  // Any pointer press outside the menu dismisses it. Capture phase so the press\n  // that lands on a grid cell still reaches its own handler afterwards.\n  document.addEventListener(\n    'pointerdown',\n    (e) => {\n      if (opened && root && !e.composedPath().includes(root)) close();\n    },\n    { capture: true, signal: abort.signal },\n  );\n  document.addEventListener(\n    'keydown',\n    (e) => {\n      if ((e as KeyboardEvent).key === 'Escape') close();\n    },\n    { capture: true, signal: abort.signal },\n  );\n\n  return {\n    get element() {\n      return root;\n    },\n    open(anchor, label, actions) {\n      if (disposed || actions.length === 0) return;\n      if (!root) root = build();\n      // Mount inside the grid host (light DOM) so theme custom properties and\n      // `color-scheme` cascade in; the top layer keeps it out of overflow.\n      const host = anchor.closest<HTMLElement>('tbw-grid, [data-tbw-grid]') ?? document.body;\n      if (root.parentNode !== host) host.appendChild(root);\n      root.setAttribute('aria-label', label);\n      root.replaceChildren();\n      for (const action of actions) {\n        const btn = document.createElement('button');\n        btn.type = 'button';\n        btn.className = `${className}-item`;\n        btn.textContent = action.label;\n        btn.disabled = action.disabled === true;\n        btn.addEventListener('click', () => {\n          close();\n          action.run();\n        });\n        root.appendChild(btn);\n      }\n      root.hidden = false;\n      if (!opened && supportsPopover()) root.showPopover();\n      opened = true;\n      place(anchor);\n      root.querySelector<HTMLButtonElement>('button:not([disabled])')?.focus();\n    },\n    close,\n    dispose() {\n      disposed = true;\n      close();\n      abort.abort();\n      root?.remove();\n      root = null;\n    },\n  };\n}\n","/**\n * Drag-Drop Protocol — shared utilities for cross-grid row drag-and-drop.\n *\n * Used by `RowDragDropPlugin` (and any future plugin that participates in the\n * tbw row-drag protocol). Centralises:\n *\n *   - MIME type constants and zone tagging (visible in `dataTransfer.types`)\n *   - Payload codec for cross-window / cross-iframe transfers\n *   - Drop-position math (midpoint algorithm)\n *   - Auto-scroll engine (rAF loop, edge detection, boundary clamp)\n *   - Plain-text TSV fallback for drags out to Notepad / Excel / Slack\n *\n * @internal Plugin shared utility (not part of the public API).\n */\n\nimport type { ColumnConfig } from '../../core/types';\n\n// ---------------------------------------------------------------------------\n// Same-window current-session tracker\n// ---------------------------------------------------------------------------\n\n/**\n * Module-level \"active drag session\" — set on dragstart by the source grid,\n * cleared on dragend. Lets target grids read the full payload synchronously\n * during `dragover` (browsers hide `dataTransfer.getData()` during dragover\n * for security). Cross-window drags don't have access to this module and\n * fall back to a generic accept-check followed by a drop-time canDrop call.\n *\n * @internal\n */\nlet currentSession: { sessionId: string; payload: RowDragPayload<unknown> } | null = null;\n\n/** @internal */\nexport function setCurrentDragSession<T>(sessionId: string, payload: RowDragPayload<T>): void {\n  currentSession = { sessionId, payload: payload as RowDragPayload<unknown> };\n}\n\n/** @internal */\nexport function getCurrentDragSession<T = unknown>(): { sessionId: string; payload: RowDragPayload<T> } | null {\n  return currentSession as { sessionId: string; payload: RowDragPayload<T> } | null;\n}\n\n/** @internal */\nexport function clearCurrentDragSession(): void {\n  currentSession = null;\n}\n\n// ---------------------------------------------------------------------------\n// MIME types\n// ---------------------------------------------------------------------------\n\n/** Base MIME type carried on `dataTransfer` for tbw row drags. */\nexport const TBW_ROW_DRAG_MIME = 'application/x-tbw-grid-rows+json';\n\n/** Build a zone-tagged MIME type, visible in `dataTransfer.types` during dragover. */\nexport function mimeForZone(zone: string): string {\n  return `${TBW_ROW_DRAG_MIME};zone=${encodeURIComponent(zone)}`;\n}\n\n/** Extract the zone from a tagged MIME, or `null` if untagged. */\nexport function parseZoneFromMime(mime: string): string | null {\n  const match = mime.match(/^application\\/x-tbw-grid-rows\\+json;zone=(.*)$/);\n  if (!match) return null;\n  try {\n    return decodeURIComponent(match[1]);\n  } catch {\n    return match[1];\n  }\n}\n\n/**\n * Find the first MIME entry in `types` whose zone matches `zone`.\n * Used during `dragover` for the accept-check (browsers hide `getData()`\n * during dragover, but `types` is always visible).\n */\nexport function findMatchingZoneMime(types: readonly string[], zone: string): string | null {\n  for (const t of types) {\n    if (parseZoneFromMime(t) === zone) return t;\n  }\n  return null;\n}\n\n/** Returns true if any tbw row-drag MIME is present in `types`. */\nexport function hasAnyRowDragMime(types: readonly string[]): boolean {\n  for (const t of types) {\n    if (t === TBW_ROW_DRAG_MIME || t.startsWith(`${TBW_ROW_DRAG_MIME};`)) return true;\n  }\n  return false;\n}\n\n// ---------------------------------------------------------------------------\n// Payload\n// ---------------------------------------------------------------------------\n\n/**\n * Cross-grid drag payload, carried on `dataTransfer` and (for same-window\n * recovery) keyed in the WeakRef registry by `sessionId`.\n *\n * Re-exported as public API from `plugins/row-drag-drop`.\n * @since 2.4.0\n */\nexport interface RowDragPayload<T = unknown> {\n  /** Drag session id (matches the WeakRef registry key). */\n  sessionId: string;\n  /** Source grid id (`grid.id` or auto-generated UUID). */\n  sourceGridId: string;\n  /** Drop zone the source grid is participating in. */\n  dropZone: string;\n  /** Serialized row payload (JSON-safe). For same-window drops, recovered live via the registry. */\n  rows: T[];\n  /** Original indices in the source grid's `_rows` array. */\n  rowIndices: number[];\n  /** Move (default) removes from source; copy leaves source intact. */\n  operation: 'move' | 'copy';\n}\n\n/** Encode a payload to the JSON string written to `dataTransfer`. */\nexport function encodePayload<T>(payload: RowDragPayload<T>): string {\n  return JSON.stringify(payload);\n}\n\n/** Decode a payload from the JSON string read off `dataTransfer`. */\nexport function decodePayload<T = unknown>(raw: string): RowDragPayload<T> | null {\n  if (!raw) return null;\n  try {\n    const parsed = JSON.parse(raw) as RowDragPayload<T>;\n    if (\n      typeof parsed?.sessionId !== 'string' ||\n      typeof parsed?.sourceGridId !== 'string' ||\n      typeof parsed?.dropZone !== 'string' ||\n      !Array.isArray(parsed?.rows) ||\n      !Array.isArray(parsed?.rowIndices) ||\n      (parsed.operation !== 'move' && parsed.operation !== 'copy')\n    ) {\n      return null;\n    }\n    // `rowIndices` is later used for sorting and splicing — reject anything\n    // that isn't a finite, non-negative integer to avoid JS coercion bugs\n    // (NaN ordering, float splice indices, string concatenation, etc.).\n    for (const idx of parsed.rowIndices) {\n      if (typeof idx !== 'number' || !Number.isInteger(idx) || idx < 0) return null;\n    }\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Drop position math\n// ---------------------------------------------------------------------------\n\nexport interface DropPosition {\n  /** Target visual row index that the cursor is over, or `null` for empty area. */\n  overIndex: number | null;\n  /** Final insertion index in the target grid's `_rows`. */\n  insertIndex: number;\n  /** True when the cursor is above the row midpoint. */\n  isBefore: boolean;\n}\n\n/**\n * Compute the insertion index for a drop, given the row element under the\n * cursor (if any), the cursor's clientY, and the total row count when the\n * cursor is in empty space below the last row.\n *\n * - Cursor above row midpoint → insert at `targetIndex`\n * - Cursor below row midpoint → insert at `targetIndex + 1`\n * - Cursor over empty area below the last row → append (`insertIndex = totalRows`)\n */\nexport function computeDropPosition(\n  rowEl: HTMLElement | null,\n  clientY: number,\n  rowIndexResolver: (el: HTMLElement) => number,\n  totalRows: number,\n): DropPosition {\n  if (!rowEl) {\n    return { overIndex: null, insertIndex: totalRows, isBefore: false };\n  }\n  const targetIndex = rowIndexResolver(rowEl);\n  if (targetIndex < 0) {\n    return { overIndex: null, insertIndex: totalRows, isBefore: false };\n  }\n  const rect = rowEl.getBoundingClientRect();\n  const midY = rect.top + rect.height / 2;\n  const isBefore = clientY < midY;\n  return {\n    overIndex: targetIndex,\n    insertIndex: isBefore ? targetIndex : targetIndex + 1,\n    isBefore,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Auto-scroll engine\n// ---------------------------------------------------------------------------\n\nexport interface AutoScrollOptions {\n  /** Pixels from the top/bottom edge that activate auto-scroll. */\n  edgeSize?: number;\n  /** Base scroll speed in pixels-per-frame near the edge. */\n  speed?: number;\n  /** Max speed at the very edge (linear ramp from `speed` → `maxSpeed`). */\n  maxSpeed?: number;\n}\n\nexport interface AutoScroller {\n  /** Update pointer position; starts the rAF loop if needed. */\n  onPointerMove(clientY: number): void;\n  /** Stop the rAF loop and reset state. */\n  stop(): void;\n  /** True when actively auto-scrolling. */\n  readonly isScrolling: boolean;\n}\n\n/**\n * Create an auto-scroller for a viewport element.\n *\n * The scroller runs a `requestAnimationFrame` loop only while the pointer is\n * within `edgeSize` of the viewport's top or bottom and there is room to\n * scroll. Speed ramps linearly from `speed` (at the edge boundary) to\n * `maxSpeed` (at the very edge).\n */\nexport function createAutoScroller(\n  viewport: HTMLElement,\n  options: AutoScrollOptions = {},\n  onScrollChange?: (active: boolean) => void,\n): AutoScroller {\n  const edgeSize = options.edgeSize ?? 60;\n  const baseSpeed = options.speed ?? 8;\n  const maxSpeed = options.maxSpeed ?? 24;\n\n  let rafId: number | null = null;\n  let pointerY: number | null = null;\n  let active = false;\n\n  const setActive = (next: boolean): void => {\n    if (next === active) return;\n    active = next;\n    onScrollChange?.(next);\n  };\n\n  const tick = (): void => {\n    rafId = null;\n    if (pointerY === null) {\n      setActive(false);\n      return;\n    }\n    const rect = viewport.getBoundingClientRect();\n    let delta = 0;\n\n    if (pointerY < rect.top + edgeSize) {\n      const distance = Math.max(0, pointerY - rect.top);\n      const ratio = 1 - distance / edgeSize;\n      delta = -Math.round(baseSpeed + (maxSpeed - baseSpeed) * ratio);\n    } else if (pointerY > rect.bottom - edgeSize) {\n      const distance = Math.max(0, rect.bottom - pointerY);\n      const ratio = 1 - distance / edgeSize;\n      delta = Math.round(baseSpeed + (maxSpeed - baseSpeed) * ratio);\n    }\n\n    if (delta === 0) {\n      setActive(false);\n      return;\n    }\n\n    const before = viewport.scrollTop;\n    viewport.scrollTop = before + delta;\n\n    // Stop if we hit a boundary (no movement happened)\n    if (viewport.scrollTop === before) {\n      setActive(false);\n      return;\n    }\n\n    setActive(true);\n    rafId = requestAnimationFrame(tick);\n  };\n\n  return {\n    onPointerMove(clientY: number): void {\n      pointerY = clientY;\n      if (rafId === null) {\n        rafId = requestAnimationFrame(tick);\n      }\n    },\n    stop(): void {\n      if (rafId !== null) {\n        cancelAnimationFrame(rafId);\n        rafId = null;\n      }\n      pointerY = null;\n      setActive(false);\n    },\n    get isScrolling(): boolean {\n      return active;\n    },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// TSV fallback\n// ---------------------------------------------------------------------------\n\n/**\n * Format rows as a TSV string for the `text/plain` drag fallback.\n * Used when the drop target is an external app (Excel, Notepad, Slack).\n *\n * - One row per line, fields separated by `\\t`.\n * - Tabs and newlines in cell values are replaced with spaces.\n * - Skips columns flagged as `utility` (drag handle, checkbox, etc.).\n */\nexport function formatRowsAsTSV<T extends Record<string, unknown>>(\n  rows: readonly T[],\n  columns: readonly ColumnConfig[],\n): string {\n  const dataColumns = columns.filter(\n    (c) => !(c as { utility?: boolean }).utility && typeof c.field === 'string' && c.field !== '',\n  );\n  const lines: string[] = [];\n  for (const row of rows) {\n    const cells = dataColumns.map((col) => {\n      const value = row[col.field];\n      if (value === null || value === undefined) return '';\n      const str = String(value);\n      return str.replace(/[\\t\\r\\n]+/g, ' ');\n    });\n    lines.push(cells.join('\\t'));\n  }\n  return lines.join('\\n');\n}\n","/**\n * Row Drag-Drop Plugin CSS\n *\n * Styles for drag handle, drop indicators (intra- and cross-grid), grid-level\n * drag/drop state classes, and FLIP animation on landing rows.\n */\n\n@layer tbw-plugins {\n  /* ------------------------------------------------------------------ */\n  /* Drag handle column                                                 */\n  /* ------------------------------------------------------------------ */\n  [data-field='__tbw_row_drag'] {\n    display: flex;\n    align-items: center;\n    justify-content: center;\n  }\n\n  .dg-row-drag-handle {\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    min-width: 1em;\n    min-height: 1em;\n    cursor: grab;\n    user-select: none;\n    color: var(--tbw-row-reorder-handle-color, var(--tbw-color-fg-muted));\n    transition: color var(--tbw-transition-duration, 120ms) var(--tbw-transition-ease, ease);\n    font-size: var(--tbw-font-size, 1em);\n    letter-spacing: -2px;\n\n    /* SC 2.5.8: grow the target, not the box, so the row keeps its height. */\n    position: relative;\n\n    &::after {\n      content: '';\n      position: absolute;\n      inset-block-start: 50%;\n      inset-inline-start: 50%;\n      translate: -50% -50%;\n      inline-size: var(--tbw-touch-target-min, 24px);\n      block-size: var(--tbw-touch-target-min, 24px);\n    }\n\n    &:hover {\n      color: var(--tbw-row-reorder-handle-hover, var(--tbw-color-fg));\n    }\n\n    &:active {\n      cursor: grabbing;\n    }\n  }\n\n  /* Coarse pointer (touch): handle always in active colour and large enough to tap */\n  @media (hover: none) {\n    .dg-row-drag-handle {\n      color: var(--tbw-row-reorder-handle-hover, var(--tbw-color-fg));\n    }\n  }\n\n  @media (pointer: coarse) {\n    .dg-row-drag-handle {\n      min-width: var(--tbw-touch-target-min, 24px);\n      min-height: var(--tbw-touch-target-min, 24px);\n    }\n  }\n\n  /* ------------------------------------------------------------------ */\n  /* Source row state                                                   */\n  /* ------------------------------------------------------------------ */\n  .data-grid-row.dragging {\n    opacity: 0.6;\n  }\n\n  /* When the row itself is the drag handle, hint at the affordance.    */\n  .data-grid-row[draggable='true'] {\n    cursor: grab;\n  }\n\n  .data-grid-row[draggable='true'].dragging {\n    cursor: grabbing;\n  }\n\n  /* Off-screen full-row clone used as the HTML5 drag image.            */\n  /* The browser already applies its own translucency to the snapshot,  */\n  /* so this clone keeps full opacity and skips the box-shadow — both   */\n  /* would otherwise composite on top of the browser's effect and make  */\n  /* the drag image look washed-out / fade at the edges.                */\n  .tbw-row-drag-clone {\n    position: fixed;\n    top: -10000px;\n    left: -10000px;\n    pointer-events: none;\n  }\n\n  /* Multi-row drag count badge */\n  .tbw-row-drag-count {\n    position: fixed;\n    top: -1000px; /* off-screen until the browser snapshots it */\n    left: -1000px;\n    pointer-events: none;\n    background: var(--tbw-row-reorder-indicator, var(--tbw-color-accent));\n    color: var(--tbw-color-accent-fg);\n    font:\n      600 12px/1.4 system-ui,\n      sans-serif;\n    border-radius: 999px;\n    padding: 2px 8px;\n    box-shadow: 0 2px 6px var(--tbw-color-shadow);\n    z-index: 9999;\n  }\n\n  /* ------------------------------------------------------------------ */\n  /* Drop position indicator (rows under cursor)                        */\n  /* ------------------------------------------------------------------ */\n  .data-grid-row.drop-target {\n    position: relative;\n\n    &.drop-before::before,\n    &.drop-after::after {\n      content: '';\n      position: absolute;\n      left: 0;\n      right: 0;\n      height: var(--tbw-drop-indicator-width, 2px);\n      background-color: var(--tbw-drop-indicator-color, var(--tbw-row-reorder-indicator, var(--tbw-color-accent)));\n      z-index: 10;\n      pointer-events: none;\n    }\n\n    &.drop-before::before {\n      top: 0;\n    }\n\n    &.drop-after::after {\n      bottom: 0;\n    }\n  }\n\n  /* ------------------------------------------------------------------ */\n  /* Grid-level state classes                                           */\n  /* ------------------------------------------------------------------ */\n\n  /* Source grid while a drag originating here is in progress */\n  .tbw-grid--drag-source {\n    /* Reserved hook for consumer styling. */\n  }\n\n  /* Target grid while a valid drag hovers (matching dropZone, canDrop ok) */\n  .tbw-grid--drop-target-active {\n    outline: 2px dashed var(--tbw-drop-indicator-color, var(--tbw-color-accent));\n    outline-offset: -2px;\n  }\n\n  /* Briefly applied when a drop attempt is rejected */\n  .tbw-grid--drop-target-rejected {\n    outline: 2px dashed var(--tbw-color-danger);\n    outline-offset: -2px;\n  }\n\n  /* Applied while the auto-scroll engine is actively scrolling this grid */\n  .tbw-grid--auto-scrolling {\n    cursor: ns-resize;\n  }\n\n  /* ------------------------------------------------------------------ */\n  /* FLIP animation on landing rows                                     */\n  /* ------------------------------------------------------------------ */\n  .data-grid-row.flip-animating {\n    transition: transform var(--tbw-animation-duration, 200ms) ease-out;\n    will-change: transform;\n    z-index: 1;\n  }\n\n  /* ------------------------------------------------------------------ */\n  /* Click-only move menu (WCAG 2.2 SC 2.5.7)                           */\n  /* ------------------------------------------------------------------ */\n  /* Rendered into `document.body` and promoted to the top layer, so it sits\n     outside the grid's custom-property scope — every var needs a literal\n     fallback here, the same way the tooltip popover does it. */\n  .tbw-row-move-menu {\n    position: fixed;\n    margin: 0;\n    display: flex;\n    flex-direction: column;\n    min-width: 10rem;\n    padding: var(--tbw-spacing-xs, 0.25rem);\n    background: var(--tbw-color-panel-bg, light-dark(#fff, #1f1f1f));\n    color: var(--tbw-color-fg, light-dark(#1a1a1a, #f0f0f0));\n    border: 1px solid var(--tbw-color-border, light-dark(#d0d0d0, #3a3a3a));\n    border-radius: var(--tbw-border-radius, 0.25rem);\n    box-shadow: var(--tbw-shadow-md, 0 4px 12px rgb(0 0 0 / 25%));\n    font: inherit;\n    z-index: 10001;\n\n    &[hidden] {\n      display: none;\n    }\n  }\n\n  .tbw-row-move-menu-item {\n    min-height: var(--tbw-touch-target-min, 24px);\n    padding: var(--tbw-spacing-xs, 0.25rem) var(--tbw-spacing-sm, 0.5rem);\n    text-align: start;\n    background: none;\n    border: none;\n    /* Themes set radii for much larger surfaces (Material uses 12px), which\n       turns a 24px row into a lozenge. */\n    border-radius: min(var(--tbw-border-radius, 0.25rem), 6px);\n    color: inherit;\n    font: inherit;\n    cursor: pointer;\n\n    &:hover:not(:disabled) {\n      background: var(--tbw-color-row-hover, light-dark(#f0f0f0, #2a2a2a));\n    }\n\n    &:disabled {\n      opacity: 0.5;\n      cursor: default;\n    }\n  }\n}\n","/**\n * Row Drag-Drop Plugin\n *\n * Drag rows within a single grid **and** between grids that share a\n * `dropZone`.\n *\n * Architecture overview is documented in the issue body and in\n * `.github/knowledge/grid-plugins.md`. Key invariants:\n *\n * - Mutations write to `grid._rows`; the user's input `sourceRows` array is\n *   never mutated on either side. Persistence is consumer-driven via the\n *   `row-move` (intra-grid) and `row-transfer` (cross-grid) events.\n * - Same-window cross-grid drops use the WeakRef registry in\n *   `core/internal/drag-drop-registry` to recover live row references.\n *   Cross-window drops fall back to `JSON.parse(JSON.stringify(row))` (or the\n *   `serializeRow`/`deserializeRow` hooks for non-JSON values).\n * - Duplicate instances of this plugin collapse via the PluginManager\n *   alias-collapse pre-pass, which merges their configs.\n *\n * @see {@link RowDragDropConfig} for all configuration options.\n */\n\nimport { GridClasses } from '../../core/constants';\nimport {\n  clearDragSession,\n  lookupDragSession,\n  newDragSessionId,\n  registerDragSession,\n} from '../../core/internal/drag-drop-registry';\nimport { ensureCellVisible } from '../../core/internal/keyboard';\nimport { BaseGridPlugin, type GridElement, type PluginManifest } from '../../core/plugin/base-plugin';\nimport type { ColumnConfig, GridHost } from '../../core/types';\nimport {\n  type DragAlternativeAction,\n  type DragAlternativeMenu,\n  createDragAlternativeMenu,\n} from '../shared/drag-alternative-menu';\nimport {\n  type AutoScroller,\n  type RowDragPayload,\n  TBW_ROW_DRAG_MIME,\n  clearCurrentDragSession,\n  computeDropPosition,\n  createAutoScroller,\n  decodePayload,\n  encodePayload,\n  findMatchingZoneMime,\n  formatRowsAsTSV,\n  getCurrentDragSession,\n  hasAnyRowDragMime,\n  mimeForZone,\n  setCurrentDragSession,\n} from '../shared/drag-drop-protocol';\nimport styles from './row-drag-drop.css?inline';\nimport type {\n  PendingMove,\n  RowDragDropConfig,\n  RowDragEndDetail,\n  RowDragStartDetail,\n  RowDropDetail,\n  RowMoveDetail,\n  RowTransferDetail,\n} from './types';\n\n/**\n * Field name for the drag handle column.\n *\n * @since 2.4.0\n */\nexport const ROW_DRAG_HANDLE_FIELD = '__tbw_row_drag';\n\n// ---------------------------------------------------------------------------\n// Cross-window coordination via BroadcastChannel\n// ---------------------------------------------------------------------------\n//\n// Same-window cross-grid drops can locate the source grid and its plugin via\n// `document.getElementById(sourceGridId)` — the target plugin handles both\n// sides of the transfer in `onDrop` (insert into target + remove from source\n// + emit `row-transfer` on both grids).\n//\n// Cross-window drops can't reach the source DOM that way. The target window\n// broadcasts a `tbw-row-drag-drop:transfer` message; each window has a single\n// channel and fans the message out to every attached plugin instance, which\n// matches on `sourceGridId === this.gridId` and runs the source-side path\n// (row removal on `move`, `row-transfer` emit, `dragAccepted` flip).\n//\n// The channel is created lazily on the first plugin that needs it and shared\n// across all instances in the window. It's torn down when the last instance\n// detaches so we don't leak a handle in environments where the plugin is\n// repeatedly attached/detached.\n\n/** @internal */\ninterface RemoteTransferMessage {\n  type: 'tbw-row-drag-drop:transfer';\n  sessionId: string;\n  sourceGridId: string;\n  toGridId: string;\n  dropZone: string;\n  rowIndices: number[];\n  toIndex: number;\n  operation: 'move' | 'copy';\n  /** Pre-serialized rows (the same shape `serializeRow` produced on dragstart). */\n  serializedRows: unknown[];\n}\n\ntype RemoteTransferListener = (msg: RemoteTransferMessage) => void;\n\nconst CROSS_WINDOW_CHANNEL_NAME = 'tbw-row-drag-drop';\nlet sharedChannel: BroadcastChannel | null = null;\nconst remoteListeners = new Set<RemoteTransferListener>();\n\nfunction ensureCrossWindowChannel(): BroadcastChannel | null {\n  if (typeof BroadcastChannel === 'undefined') return null;\n  if (sharedChannel) return sharedChannel;\n  try {\n    sharedChannel = new BroadcastChannel(CROSS_WINDOW_CHANNEL_NAME);\n    sharedChannel.addEventListener('message', (event: MessageEvent) => {\n      const data = event.data as RemoteTransferMessage | undefined;\n      if (!data || data.type !== 'tbw-row-drag-drop:transfer') return;\n      // Snapshot to tolerate listeners that detach during dispatch.\n      for (const listener of Array.from(remoteListeners)) {\n        try {\n          listener(data);\n        } catch {\n          /* listener errors must not break sibling listeners */\n        }\n      }\n    });\n  } catch {\n    sharedChannel = null;\n  }\n  return sharedChannel;\n}\n\nfunction registerRemoteTransferListener(listener: RemoteTransferListener): void {\n  remoteListeners.add(listener);\n  ensureCrossWindowChannel();\n}\n\n/**\n * Every plugin instance attached in this window.\n *\n * Drag-and-drop discovers its target from the pointer position, so it never\n * needed a registry. The click-only transfer control (WCAG 2.2 SC 2.5.7) does:\n * it has to *list* the grids a row can be sent to before the user picks one.\n *\n * Typed as `unknown` because the class is generic over the row type and every\n * instance in the window may have a different one; `peersInDropZone()` narrows.\n */\nconst attachedPlugins = new Set<unknown>();\n\nfunction unregisterRemoteTransferListener(listener: RemoteTransferListener): void {\n  remoteListeners.delete(listener);\n  if (remoteListeners.size === 0 && sharedChannel) {\n    try {\n      sharedChannel.close();\n    } catch {\n      /* noop */\n    }\n    sharedChannel = null;\n  }\n}\n\nfunction broadcastRemoteTransfer(msg: RemoteTransferMessage): void {\n  const channel = ensureCrossWindowChannel();\n  if (!channel) return;\n  try {\n    channel.postMessage(msg);\n  } catch {\n    /* postMessage may throw on uncloneable payloads — acceptable; user can\n     * supply `serializeRow` to provide a structured-cloneable shape. */\n  }\n}\n\n/**\n * Row Drag-Drop Plugin for `<tbw-grid>`.\n *\n * @example Intra-grid reordering\n * ```ts\n * import { RowDragDropPlugin } from '@toolbox-web/grid/plugins/row-drag-drop';\n *\n * grid.gridConfig = {\n *   plugins: [new RowDragDropPlugin()],\n * };\n * ```\n *\n * @example Cross-grid transfer list\n * ```ts\n * gridA.gridConfig = { plugins: [new RowDragDropPlugin({ dropZone: 'tasks' })] };\n * gridB.gridConfig = { plugins: [new RowDragDropPlugin({ dropZone: 'tasks' })] };\n *\n * gridA.addEventListener('row-transfer', (e) => persist(e.detail));\n * gridB.addEventListener('row-transfer', (e) => persist(e.detail));\n * ```\n *\n * @category Plugin\n */\nexport class RowDragDropPlugin<T = unknown> extends BaseGridPlugin<RowDragDropConfig<T>> {\n  /** @internal */\n  readonly name = 'rowDragDrop';\n\n  /** @internal */\n  override readonly styles = styles;\n\n  /** @internal */\n  static override readonly manifest: PluginManifest<RowDragDropConfig> = {\n    events: [\n      { type: 'row-move', description: 'Intra-grid row reorder.', cancelable: true },\n      { type: 'row-drag-start', description: 'Cross-grid drag started on this grid.', cancelable: true },\n      { type: 'row-drag-end', description: 'Drag finished on this grid (regardless of outcome).' },\n      { type: 'row-drop', description: 'Cross-grid drop landing on this grid.', cancelable: true },\n      { type: 'row-transfer', description: 'Cross-grid transfer completed (fires on both grids).' },\n    ],\n  };\n\n  /** @internal */\n  protected override get defaultConfig(): Partial<RowDragDropConfig<T>> {\n    return {\n      enableKeyboard: true,\n      // `showDragHandle` default depends on `dragFrom` — resolved by\n      // `shouldRenderDragHandle()` rather than here so a single `dragFrom`\n      // change reshapes both at once.\n      dragHandlePosition: 'left',\n      dragHandleWidth: 40,\n      debounceMs: 150,\n      animation: 'flip',\n      operation: 'move',\n      autoScroll: true,\n      dragFrom: 'handle',\n    };\n  }\n\n  /**\n   * Resolve whether the grip column should be rendered. The handle is shown\n   * unless the user explicitly set `showDragHandle: false`, OR `dragFrom`\n   * is `'row'` and `showDragHandle` was not explicitly set to `true`.\n   */\n  private shouldRenderDragHandle(): boolean {\n    const explicit = this.config.showDragHandle;\n    if (explicit === false) return false;\n    if (explicit === true) return true;\n    return this.config.dragFrom !== 'row';\n  }\n\n  /** Whether the row element itself should accept native HTML5 drag. */\n  private get rowIsDraggable(): boolean {\n    return this.config.dragFrom === 'row' || this.config.dragFrom === 'both';\n  }\n\n  /** Resolve animation type from plugin config (respects grid-level reduced-motion). */\n  private get animationType(): false | 'flip' {\n    if (!this.isAnimationEnabled) return false;\n    if (this.config.animation !== undefined) return this.config.animation;\n    return 'flip';\n  }\n\n  // #region Internal State\n  private isDragging = false;\n  private draggedRowIndex: number | null = null;\n  private draggedRows: T[] = [];\n  private draggedIndices: number[] = [];\n  private dragSessionId: string | null = null;\n  private dragAccepted = false;\n  private dropRowIndex: number | null = null;\n  private pendingMove: PendingMove | null = null;\n  private debounceTimer: ReturnType<typeof setTimeout> | null = null;\n  private lastFocusCol = 0;\n  private autoScroller: AutoScroller | null = null;\n  /** Stable id for this grid instance (used as `sourceGridId` in payloads). */\n  private gridId = '';\n\n  /** Bound listener so we can register/unregister the same reference. */\n  private readonly remoteTransferListener: RemoteTransferListener = (msg) => this.onRemoteTransfer(msg);\n\n  /** Click-only move menu (WCAG 2.2 SC 2.5.7), created lazily on first tap. */\n  private moveMenu: DragAlternativeMenu | null = null;\n\n  /** Typed internal grid accessor. */\n  private get internalGrid(): GridHost {\n    return this.grid;\n  }\n  // #endregion\n\n  // #region Lifecycle\n  /** @internal */\n  override attach(grid: GridElement): void {\n    super.attach(grid);\n    const host = this.gridElement;\n    if (host) {\n      this.gridId = host.id || `tbw-grid-${newDragSessionId().slice(0, 8)}`;\n      if (!host.id) host.id = this.gridId;\n      this.setupDelegatedDragListeners();\n      registerRemoteTransferListener(this.remoteTransferListener);\n      attachedPlugins.add(this);\n    }\n  }\n\n  /** @internal */\n  override detach(): void {\n    this.clearDebounceTimer();\n    this.autoScroller?.stop();\n    this.autoScroller = null;\n    unregisterRemoteTransferListener(this.remoteTransferListener);\n    attachedPlugins.delete(this);\n    this.moveMenu?.dispose();\n    this.moveMenu = null;\n    if (this.dragSessionId) clearDragSession(this.dragSessionId);\n    clearCurrentDragSession();\n    this.resetDragState();\n    super.detach();\n  }\n  // #endregion\n\n  // #region Hooks\n\n  /** @internal */\n  override processColumns(columns: readonly ColumnConfig[]): ColumnConfig[] {\n    if (!this.shouldRenderDragHandle()) return [...columns];\n\n    const dragHandleColumn: ColumnConfig = {\n      field: ROW_DRAG_HANDLE_FIELD,\n      header: '',\n      width: this.config.dragHandleWidth ?? 40,\n      resizable: false,\n      sortable: false,\n      filterable: false,\n      lockPosition: true,\n      utility: true,\n      viewRenderer: () => {\n        const container = document.createElement('div');\n        container.className = 'dg-row-drag-handle';\n        container.setAttribute('aria-label', 'Drag to reorder, or activate for move options');\n        container.setAttribute('role', 'button');\n        container.setAttribute('tabindex', '-1');\n        container.draggable = true;\n        // Press-and-release without moving is a tap, not a drag — HTML5 DnD\n        // only fires `dragstart` on a real drag, so a plain `click` here means\n        // the pointer user could not (or chose not to) drag. Offer the\n        // click-only alternative instead (WCAG 2.2 SC 2.5.7).\n        container.addEventListener('click', (e) => {\n          e.stopPropagation();\n          this.openMoveMenu(container);\n        });\n        this.setIcon(container, 'dragHandle');\n        return container;\n      },\n    };\n\n    return this.config.dragHandlePosition === 'right' ? [...columns, dragHandleColumn] : [dragHandleColumn, ...columns];\n  }\n\n  /** @internal */\n  override afterRender(): void {\n    this.applyRowDraggable();\n  }\n\n  /** @internal */\n  override onScrollRender(): void {\n    // Virtualization recycles row DOM elements during scroll; re-apply the\n    // `draggable` attribute so newly-shown rows still accept HTML5 drag.\n    this.applyRowDraggable();\n  }\n\n  /**\n   * Set or clear the `draggable` attribute on every visible row, depending on\n   * `config.dragFrom`. Idempotent and cheap (one attribute write per row).\n   */\n  private applyRowDraggable(): void {\n    const body = this.internalGrid._bodyEl;\n    if (!body) return;\n    const wantDraggable = this.rowIsDraggable;\n    const rows = body.querySelectorAll<HTMLElement>('.data-grid-row');\n    for (const row of rows) {\n      if (wantDraggable) {\n        if (row.getAttribute('draggable') !== 'true') row.setAttribute('draggable', 'true');\n      } else if (row.hasAttribute('draggable')) {\n        row.removeAttribute('draggable');\n      }\n    }\n  }\n\n  /** @internal */\n  override onKeyDown(event: KeyboardEvent): boolean | void {\n    if (!this.config.enableKeyboard) return;\n    // Ctrl is deprecated (macOS reserves Ctrl+↑/↓); remove in the next major.\n    if (!(event.altKey || event.ctrlKey) || (event.key !== 'ArrowUp' && event.key !== 'ArrowDown')) return;\n    if (this.#isKeyboardMoveBlocked(event)) return;\n\n    const grid = this.internalGrid;\n    const focusRow = grid._focusRow;\n    const rows = grid._rows ?? this.sourceRows;\n    if (focusRow < 0 || focusRow >= rows.length) return;\n\n    const direction = event.key === 'ArrowUp' ? 'up' : 'down';\n    const toIndex = direction === 'up' ? focusRow - 1 : focusRow + 1;\n    if (toIndex < 0 || toIndex >= rows.length) return;\n\n    const row = rows[focusRow];\n    if (!this.canMoveRow(focusRow, toIndex)) return;\n\n    this.handleKeyboardMove(row, focusRow, toIndex, grid._focusCol);\n    event.preventDefault();\n    event.stopPropagation();\n    return true;\n  }\n\n  /** Editors, form controls and non-body chrome own the chord (e.g. `<select>` Alt+↓ opens it). */\n  #isKeyboardMoveBlocked(event: KeyboardEvent): boolean {\n    if (this.queryBoolean('isEditing')) return true;\n    const target = (event.composedPath?.()[0] ?? event.target) as HTMLElement | null;\n    if (!target?.closest || target === this.gridElement) return false;\n    if (!target.closest('.rows-body')) return true;\n    const tag = target.tagName;\n    return tag === 'INPUT' || tag === 'SELECT' || tag === 'TEXTAREA' || target.isContentEditable;\n  }\n\n  /** @internal */\n  override onCellClick(): void {\n    this.flushPendingMove();\n  }\n  // #endregion\n\n  // #region Public API\n  /** Move a row to a new position programmatically (intra-grid). */\n  moveRow(fromIndex: number, toIndex: number): void {\n    const rows = [...this.sourceRows];\n    if (fromIndex < 0 || fromIndex >= rows.length) return;\n    if (toIndex < 0 || toIndex >= rows.length) return;\n    if (fromIndex === toIndex) return;\n    if (!this.canMoveRow(fromIndex, toIndex)) return;\n    this.executeIntraGridMove(rows[fromIndex], fromIndex, toIndex, 'keyboard');\n  }\n\n  /**\n   * Check if a row can be moved within this grid.\n   * Consults the `canDrag` veto for the source row, the plugin query system\n   * (`canMoveRow`), and `canDrop` for the target.\n   */\n  canMoveRow(fromIndex: number, toIndex: number): boolean {\n    // During debounced keyboard moves, `grid._rows` diverges from\n    // `sourceRows` (the user-facing snapshot) because the plugin mutates\n    // resolves the focused row from `_rows ?? sourceRows`, so validation must\n    // read from the same array — otherwise we'd run `canDrag`/queries against\n    // the wrong row.\n    const rows = this.internalGrid._rows ?? this.sourceRows;\n    if (fromIndex < 0 || fromIndex >= rows.length) return false;\n    if (toIndex < 0 || toIndex >= rows.length) return false;\n    if (fromIndex === toIndex) return false;\n\n    // Plugin query veto (Tree, GroupingRows)\n    const row = rows[fromIndex] as T;\n    const queryResults = this.grid?.query?.<boolean>('canMoveRow', row);\n    if (Array.isArray(queryResults) && queryResults.includes(false)) return false;\n\n    // canDrag veto (dragstart side)\n    if (this.config.canDrag && !this.config.canDrag(row, fromIndex)) return false;\n\n    // canDrop callback (intra-grid synthesised payload)\n    if (this.config.canDrop) {\n      const payload: RowDragPayload<T> = {\n        sessionId: 'intra',\n        sourceGridId: this.gridId,\n        dropZone: this.config.dropZone ?? '',\n        rows: [row],\n        rowIndices: [fromIndex],\n        operation: 'move',\n      };\n      if (!this.config.canDrop(payload, toIndex)) return false;\n    }\n\n    return true;\n  }\n  // #endregion\n\n  // #region Drag Setup\n\n  private setupDelegatedDragListeners(): void {\n    const gridEl = this.gridElement;\n    if (!gridEl) return;\n    const signal = this.disconnectSignal;\n\n    gridEl.addEventListener('dragstart', (e) => this.onDragStart(e as DragEvent), { signal });\n    gridEl.addEventListener('dragend', () => this.onDragEnd(), { signal });\n    gridEl.addEventListener('dragover', (e) => this.onDragOver(e as DragEvent), { signal });\n    gridEl.addEventListener('dragleave', (e) => this.onDragLeave(e as DragEvent), { signal });\n    gridEl.addEventListener('drop', (e) => this.onDrop(e as DragEvent), { signal });\n  }\n\n  private onDragStart(de: DragEvent): void {\n    const target = de.target as HTMLElement | null;\n    if (!target) return;\n\n    // Resolve the row element being picked up. Order matters: a click on the\n    // grip column inside a row-draggable grid should still go through the\n    // handle path so the cursor offset feels right.\n    const handle = target.closest('.dg-row-drag-handle') as HTMLElement | null;\n    let rowEl: HTMLElement | null = null;\n    let initiatedFromHandle = false;\n    if (handle) {\n      rowEl = handle.closest('.data-grid-row') as HTMLElement | null;\n      initiatedFromHandle = true;\n    } else if (this.rowIsDraggable) {\n      // Row-as-handle: any cell may start the drag, but interactive\n      // descendants (inputs, buttons, anchors, contenteditable, open\n      // editors, selection checkboxes) keep their native behaviour.\n      if (this.isInteractiveDragOrigin(target)) return;\n      rowEl = target.closest('.data-grid-row') as HTMLElement | null;\n    }\n    if (!rowEl) return;\n\n    const rowIndex = this.getRowIndex(rowEl);\n    if (rowIndex < 0) return;\n\n    // Resolve the rows being dragged: whole selection if dragged row is selected.\n    const { rows, indices } = this.resolveDraggedRows(rowIndex);\n    if (rows.length === 0) return;\n\n    // canDrag veto on the originating row\n    if (this.config.canDrag && !this.config.canDrag(rows[0], rowIndex)) {\n      de.preventDefault();\n      return;\n    }\n\n    const operation = this.config.operation ?? 'move';\n    const dropZone = this.config.dropZone ?? '';\n    const sessionId = newDragSessionId();\n\n    // Emit cancelable row-drag-start (source-side veto)\n    const startDetail: RowDragStartDetail<T> = { rows, indices, operation, dropZone };\n    if (this.emitCancelable('row-drag-start', startDetail)) {\n      de.preventDefault();\n      return;\n    }\n\n    this.isDragging = true;\n    this.draggedRowIndex = rowIndex;\n    this.draggedRows = rows;\n    this.draggedIndices = indices;\n    this.dragSessionId = sessionId;\n    this.dragAccepted = false;\n\n    // Build the cross-grid payload (always built, even when dropZone is empty —\n    // intra-grid drops still benefit from the registry round-trip)\n    const serialize = this.config.serializeRow ?? ((r: T) => r);\n    const payload: RowDragPayload<T> = {\n      sessionId,\n      sourceGridId: this.gridId,\n      dropZone,\n      rows: rows.map(serialize) as T[],\n      rowIndices: indices,\n      operation,\n    };\n\n    if (de.dataTransfer) {\n      de.dataTransfer.effectAllowed = operation === 'copy' ? 'copyMove' : 'move';\n      try {\n        de.dataTransfer.setData(TBW_ROW_DRAG_MIME, encodePayload(payload));\n        if (dropZone) de.dataTransfer.setData(mimeForZone(dropZone), encodePayload(payload));\n        // Plain-text TSV fallback for external drop targets\n        de.dataTransfer.setData('text/plain', formatRowsAsTSV(rows as Record<string, unknown>[], this.columns));\n      } catch {\n        /* JSDOM/happy-dom may throw on setData; harmless */\n      }\n\n      // Drag image: full-row clone for single-row drags (more legible than\n      // the handle alone); count badge for multi-row drags.\n      if (rows.length > 1) {\n        const badge = document.createElement('div');\n        badge.className = 'tbw-row-drag-count';\n        badge.textContent = `${rows.length} rows`;\n        document.body.appendChild(badge);\n        try {\n          de.dataTransfer.setDragImage(badge, 10, 10);\n        } catch {\n          /* ignore */\n        }\n        setTimeout(() => badge.remove(), 0);\n      } else {\n        this.attachRowCloneDragImage(de, rowEl, initiatedFromHandle ? handle : null);\n      }\n    }\n\n    // Same-window registry + current-session marker\n    registerDragSession(sessionId, rows as unknown[]);\n    setCurrentDragSession(sessionId, payload);\n\n    rowEl.classList.add(GridClasses.DRAGGING);\n    this.gridElement.classList.add('tbw-grid--drag-source');\n  }\n\n  /**\n   * Selectors whose dragstart should NOT initiate a row drag in `dragFrom: 'row'`\n   * mode. Keeps native interactions (text input, button clicks, link drag,\n   * cell editing, selection checkboxes) working unchanged.\n   */\n  private static readonly INTERACTIVE_DRAG_SELECTORS =\n    'input,textarea,select,button,a,[contenteditable=\"\"],[contenteditable=\"true\"],.dg-cell-editor,.tbw-checkbox-cell';\n\n  /** @internal */\n  private isInteractiveDragOrigin(target: HTMLElement): boolean {\n    return target.closest(RowDragDropPlugin.INTERACTIVE_DRAG_SELECTORS) !== null;\n  }\n\n  /**\n   * Build a full-row drag image by cloning `rowEl` so the user sees the\n   * actual row — not just the grip icon — while dragging.\n   *\n   * The clone is appended off-screen, snapshotted by the browser via\n   * `setDragImage`, then removed on the next tick (after the snapshot).\n   * The cursor offset is preserved relative to where the user pressed.\n   */\n  private attachRowCloneDragImage(de: DragEvent, rowEl: HTMLElement, handle: HTMLElement | null): void {\n    if (!de.dataTransfer) return;\n    const rect = rowEl.getBoundingClientRect();\n    const clone = rowEl.cloneNode(true) as HTMLElement;\n    clone.classList.add('tbw-row-drag-clone');\n    // Strip transient classes that would look wrong in the drag image.\n    clone.classList.remove('dragging', 'drop-target', 'drop-before', 'drop-after', 'flip-animating', 'row-focus');\n    clone.removeAttribute('aria-selected');\n    // Preserve the actual rendered width so cells don't reflow in the snapshot.\n    clone.style.width = `${rect.width}px`;\n    clone.style.height = `${rect.height}px`;\n    // The clone MUST stay inside the grid host: every core row/cell rule is\n    // scoped under `tbw-grid …` (see core/styles/*.css), and the\n    // `--tbw-column-template` custom property is set on the host. If the\n    // clone is moved to `document.body`, none of those rules match and the\n    // drag image collapses to an empty box. Off-screen positioning via\n    // `position: fixed` works the same regardless of the DOM parent.\n    this.gridElement.appendChild(clone);\n    // Cursor offset: where the user pressed inside the source row. Falls\n    // back to the centre of the handle when initiated from the grip.\n    let offsetX = de.clientX - rect.left;\n    let offsetY = de.clientY - rect.top;\n    if (handle) {\n      const handleRect = handle.getBoundingClientRect();\n      offsetX = handleRect.left - rect.left + handleRect.width / 2;\n      offsetY = handleRect.top - rect.top + handleRect.height / 2;\n    }\n    // Clamp into the row bounds so the cursor stays inside the drag image.\n    offsetX = Math.max(0, Math.min(rect.width, offsetX));\n    offsetY = Math.max(0, Math.min(rect.height, offsetY));\n    try {\n      de.dataTransfer.setDragImage(clone, offsetX, offsetY);\n    } catch {\n      /* JSDOM/happy-dom: harmless */\n    }\n    setTimeout(() => clone.remove(), 0);\n  }\n\n  private onDragOver(de: DragEvent): void {\n    const dt = de.dataTransfer;\n    if (!dt) return;\n\n    // Identify whether a tbw row drag is in progress and whether it matches our zone.\n    const types = dt.types ? Array.from(dt.types) : [];\n    if (!hasAnyRowDragMime(types) && !this.isDragging) return;\n\n    const dropZone = this.config.dropZone ?? '';\n    const session = getCurrentDragSession<T>();\n\n    // For cross-grid drags we require a matching zone-tagged MIME OR the\n    // session payload's dropZone must match ours.\n    const isIntra = this.isDragging && session?.payload.sourceGridId === this.gridId;\n    if (!isIntra) {\n      if (!dropZone) return; // intra-grid only — ignore external drags\n      const matchingMime = findMatchingZoneMime(types, dropZone);\n      if (!matchingMime && !(session && session.payload.dropZone === dropZone)) return;\n    }\n\n    de.preventDefault();\n    if (dt) dt.dropEffect = (session?.payload.operation ?? this.config.operation ?? 'move') as 'copy' | 'move';\n\n    // Compute drop position\n    const rowEl = (de.target as HTMLElement).closest('.data-grid-row') as HTMLElement | null;\n    const rows = this.internalGrid._rows ?? [];\n    const pos = computeDropPosition(rowEl, de.clientY, (el) => this.getRowIndex(el), rows.length);\n\n    // Same-row no-op for intra-grid\n    if (isIntra && pos.overIndex !== null && pos.overIndex === this.draggedRowIndex) {\n      this.clearDropTargetClasses();\n      return;\n    }\n\n    // canDrop check (same-window only — payload visible)\n    if (session && this.config.canDrop) {\n      const accepted = this.config.canDrop(session.payload, pos.insertIndex);\n      this.gridElement.classList.toggle('tbw-grid--drop-target-active', accepted);\n      this.gridElement.classList.toggle('tbw-grid--drop-target-rejected', !accepted);\n      if (!accepted) {\n        this.clearDropTargetClasses();\n        return;\n      }\n    } else {\n      this.gridElement.classList.add('tbw-grid--drop-target-active');\n    }\n\n    this.dropRowIndex = pos.insertIndex;\n    this.applyDropPositionClasses(rowEl, pos.isBefore);\n\n    // Auto-scroll the target viewport\n    if (this.config.autoScroll !== false) {\n      this.ensureAutoScroller();\n      this.autoScroller?.onPointerMove(de.clientY);\n    }\n  }\n\n  private onDragLeave(de: DragEvent): void {\n    const rowEl = (de.target as HTMLElement).closest('.data-grid-row') as HTMLElement | null;\n    if (rowEl) rowEl.classList.remove('drop-target', 'drop-before', 'drop-after');\n    // Tear down grid-level state when the cursor leaves the grid entirely\n    if (de.currentTarget && !this.gridElement.contains(de.relatedTarget as Node)) {\n      this.gridElement.classList.remove('tbw-grid--drop-target-active', 'tbw-grid--drop-target-rejected');\n      this.autoScroller?.stop();\n    }\n  }\n\n  private onDrop(de: DragEvent): void {\n    de.preventDefault();\n    this.autoScroller?.stop();\n    this.gridElement.classList.remove('tbw-grid--drop-target-active', 'tbw-grid--drop-target-rejected');\n    this.clearDropTargetClasses();\n\n    const dt = de.dataTransfer;\n    if (!dt) return;\n\n    // Resolve payload — prefer same-window session, fall back to dataTransfer JSON\n    const session = getCurrentDragSession<T>();\n    let payload: RowDragPayload<T> | null = session?.payload ?? null;\n    let liveRows: T[] | null = null;\n\n    if (payload) {\n      const lookup = lookupDragSession<T>(payload.sessionId);\n      if (lookup) liveRows = lookup;\n    } else {\n      const raw = dt.getData(TBW_ROW_DRAG_MIME);\n      payload = decodePayload<T>(raw);\n      if (payload) {\n        const lookup = lookupDragSession<T>(payload.sessionId);\n        if (lookup) liveRows = lookup;\n      }\n    }\n    if (!payload) return;\n\n    // Drop position (recompute in case dragover wasn't called for a few frames)\n    const rowEl = (de.target as HTMLElement).closest('.data-grid-row') as HTMLElement | null;\n    const rows = this.internalGrid._rows ?? [];\n    const pos = computeDropPosition(rowEl, de.clientY, (el) => this.getRowIndex(el), rows.length);\n    let targetIndex = this.dropRowIndex ?? pos.insertIndex;\n\n    const isIntra = payload.sourceGridId === this.gridId;\n    const dropZone = this.config.dropZone ?? '';\n\n    if (isIntra) {\n      // Intra-grid path — emit `row-move`.\n      const fromIndex = payload.rowIndices[0];\n      // Adjust toIndex when dropping after the dragged row (single-row only)\n      if (payload.rowIndices.length === 1 && targetIndex > fromIndex) targetIndex--;\n      if (fromIndex === targetIndex) return;\n      const row = (liveRows ?? payload.rows)[0];\n      if (!this.canMoveRow(fromIndex, targetIndex)) return;\n      this.executeIntraGridMove(row, fromIndex, targetIndex, 'drag');\n      return;\n    }\n\n    // Cross-grid path\n    if (!dropZone || dropZone !== payload.dropZone) return;\n\n    // canDrop final check\n    if (this.config.canDrop && !this.config.canDrop(payload, targetIndex)) {\n      this.gridElement.classList.add('tbw-grid--drop-target-rejected');\n      setTimeout(() => this.gridElement.classList.remove('tbw-grid--drop-target-rejected'), 200);\n      return;\n    }\n\n    // Resolve final row references — live (same-window) or deserialized JSON\n    const deserialize = this.config.deserializeRow ?? ((r: unknown) => r as T);\n    const incomingRows: T[] = liveRows ?? payload.rows.map((r) => deserialize(r as unknown));\n\n    const dropDetail: RowDropDetail<T> = {\n      payload,\n      sourceGridId: payload.sourceGridId,\n      targetIndex,\n      operation: payload.operation,\n    };\n    if (this.emitCancelable('row-drop', dropDetail)) return;\n\n    // Insert into target grid's _rows\n    const targetRows = [...rows];\n    targetRows.splice(targetIndex, 0, ...(incomingRows as unknown[]));\n    this.grid.rows = targetRows;\n\n    // Locate the source plugin in THIS window. If it's here we handle the\n    // source-side mutation directly; if it isn't, we broadcast a message and\n    // let the source-window plugin (if any) handle removal + transfer emit.\n    const sourcePlugin = this.findPeerOnGrid(payload.sourceGridId);\n\n    // Remove from source grid's _rows when operation === 'move' (same-window)\n    if (payload.operation === 'move' && sourcePlugin) {\n      const sourceGrid = document.getElementById(payload.sourceGridId) as\n        (HTMLElement & { rows?: unknown[]; _rows?: unknown[] }) | null;\n      if (sourceGrid) {\n        const srcRows = (sourceGrid._rows ?? sourceGrid.rows ?? []).slice();\n        // Remove from highest index down so earlier indices stay stable\n        const sortedIndices = [...payload.rowIndices].sort((a, b) => b - a);\n        for (const idx of sortedIndices) {\n          if (idx >= 0 && idx < srcRows.length) srcRows.splice(idx, 1);\n        }\n        sourceGrid.rows = srcRows;\n      }\n    }\n\n    // Mark accepted on the source plugin so dragend knows (same-window only —\n    // cross-window source flips its own flag in `onRemoteTransfer`).\n    if (sourcePlugin) sourcePlugin.dragAccepted = true;\n\n    // Emit row-transfer on the target. The source's `row-transfer` is fired\n    // either here (same-window) or by the source plugin in `onRemoteTransfer`\n    // (cross-window).\n    const transferDetail: RowTransferDetail<T> = {\n      rows: incomingRows,\n      fromGridId: payload.sourceGridId,\n      toGridId: this.gridId,\n      fromIndices: payload.rowIndices,\n      toIndex: targetIndex,\n      operation: payload.operation,\n    };\n    this.emit('row-transfer', transferDetail);\n\n    if (sourcePlugin) {\n      sourcePlugin.emitTransfer(transferDetail);\n    } else {\n      // Cross-window: broadcast so the source window can finish its half of\n      // the transfer (row removal on `move`, `row-transfer` emit, accepted flip).\n      broadcastRemoteTransfer({\n        type: 'tbw-row-drag-drop:transfer',\n        sessionId: payload.sessionId,\n        sourceGridId: payload.sourceGridId,\n        toGridId: this.gridId,\n        dropZone,\n        rowIndices: payload.rowIndices,\n        toIndex: targetIndex,\n        operation: payload.operation,\n        // Re-use the payload's already-serialized rows so the source side can\n        // round-trip them through `deserializeRow` for its `row-transfer` event.\n        serializedRows: payload.rows as unknown[],\n      });\n    }\n  }\n\n  /**\n   * Source-window handler for a remote `row-transfer` broadcast from a target\n   * window. Only runs on the plugin instance whose grid id matches the message.\n   * @internal\n   */\n  private onRemoteTransfer(msg: RemoteTransferMessage): void {\n    if (msg.sourceGridId !== this.gridId) return;\n    // Defensive: only act when the message zone matches our zone. This prevents\n    // a stray message from a grid sharing the same id but a different zone\n    // (e.g. independent demos in different tabs) from mutating our rows.\n    const dropZone = this.config.dropZone ?? '';\n    if (!dropZone || msg.dropZone !== dropZone) return;\n\n    // Resolve incoming rows (for the `row-transfer` event payload).\n    const deserialize = this.config.deserializeRow ?? ((r: unknown) => r as T);\n    const incomingRows: T[] = msg.serializedRows.map((r) => deserialize(r));\n\n    if (msg.operation === 'move') {\n      const srcRows = (this.internalGrid._rows ?? this.sourceRows).slice();\n      const sortedIndices = [...msg.rowIndices].sort((a, b) => b - a);\n      for (const idx of sortedIndices) {\n        if (idx >= 0 && idx < srcRows.length) srcRows.splice(idx, 1);\n      }\n      this.grid.rows = srcRows as unknown[];\n    }\n\n    // Flip accepted before dragend (best-effort — the message may arrive after\n    // dragend has already fired with `accepted: false`; `row-transfer` is the\n    // authoritative success signal).\n    this.dragAccepted = true;\n\n    this.emit('row-transfer', {\n      rows: incomingRows,\n      fromGridId: msg.sourceGridId,\n      toGridId: msg.toGridId,\n      fromIndices: msg.rowIndices,\n      toIndex: msg.toIndex,\n      operation: msg.operation,\n    } as RowTransferDetail<T>);\n  }\n\n  private onDragEnd(): void {\n    if (this.dragSessionId) clearDragSession(this.dragSessionId);\n    clearCurrentDragSession();\n    this.autoScroller?.stop();\n    this.gridElement.classList.remove('tbw-grid--drag-source');\n\n    if (this.isDragging) {\n      const endDetail: RowDragEndDetail<T> = {\n        rows: this.draggedRows,\n        indices: this.draggedIndices,\n        accepted: this.dragAccepted,\n      };\n      this.emit('row-drag-end', endDetail);\n    }\n    this.clearDragClasses();\n    this.resetDragState();\n  }\n  // #endregion\n\n  // #region Helpers\n\n  /** Public wrapper so a peer plugin can dispatch `row-transfer` on this grid. @internal */\n  emitTransfer(detail: RowTransferDetail<T>): void {\n    this.emit('row-transfer', detail);\n  }\n\n  /** Find the peer `RowDragDropPlugin` instance on another grid by id. */\n  private findPeerOnGrid(gridId: string): RowDragDropPlugin<T> | null {\n    const peerEl = document.getElementById(gridId) as\n      (HTMLElement & { getPluginByName?: (name: string) => RowDragDropPlugin<T> | undefined }) | null;\n    if (!peerEl?.getPluginByName) return null;\n    return peerEl.getPluginByName('rowDragDrop') ?? null;\n  }\n\n  // #region Click-only move menu (WCAG 2.2 SC 2.5.7)\n\n  /** Grids in this window sharing our (non-empty) `dropZone`. */\n  private peersInDropZone(): RowDragDropPlugin<T>[] {\n    const dropZone = this.config.dropZone ?? '';\n    if (!dropZone) return [];\n    const peers: RowDragDropPlugin<T>[] = [];\n    for (const candidate of attachedPlugins) {\n      const peer = candidate as RowDragDropPlugin<T>;\n      if (peer === this) continue;\n      if ((peer.config.dropZone ?? '') === dropZone) peers.push(peer);\n    }\n    return peers;\n  }\n\n  /** Human-readable name for this grid, used in the transfer menu. */\n  private get gridLabel(): string {\n    const host = this.gridElement;\n    return host?.getAttribute('aria-label') || host?.id || 'grid';\n  }\n\n  /**\n   * Open the click-only alternative to dragging a row: reorder within this grid\n   * and, when a `dropZone` is configured, send the row to a peer grid — all\n   * with single clicks or taps, no press-hold-move gesture.\n   */\n  private openMoveMenu(handle: HTMLElement): void {\n    const rowEl = handle.closest('.data-grid-row') as HTMLElement | null;\n    if (!rowEl) return;\n    const rowIndex = this.getRowIndex(rowEl);\n    if (rowIndex < 0) return;\n\n    const rows = this.internalGrid._rows ?? this.sourceRows;\n    const actions: DragAlternativeAction[] = [\n      {\n        label: 'Move up',\n        disabled: rowIndex === 0 || !this.canMoveRow(rowIndex, rowIndex - 1),\n        run: () => this.moveRow(rowIndex, rowIndex - 1),\n      },\n      {\n        label: 'Move down',\n        disabled: rowIndex >= rows.length - 1 || !this.canMoveRow(rowIndex, rowIndex + 1),\n        run: () => this.moveRow(rowIndex, rowIndex + 1),\n      },\n      {\n        label: 'Move to top',\n        disabled: rowIndex === 0 || !this.canMoveRow(rowIndex, 0),\n        run: () => this.moveRow(rowIndex, 0),\n      },\n      {\n        label: 'Move to bottom',\n        disabled: rowIndex >= rows.length - 1 || !this.canMoveRow(rowIndex, rows.length - 1),\n        run: () => this.moveRow(rowIndex, rows.length - 1),\n      },\n    ];\n\n    const verb = (this.config.operation ?? 'move') === 'copy' ? 'Copy to' : 'Send to';\n    for (const peer of this.peersInDropZone()) {\n      actions.push({\n        label: `${verb} ${peer.gridLabel}`,\n        run: () => this.transferToPeer(peer, rowIndex),\n      });\n    }\n\n    this.moveMenu ??= createDragAlternativeMenu('tbw-row-move-menu', 'tbw-row-move-menu');\n    this.moveMenu.open(handle, `Move row ${rowIndex + 1}`, actions);\n  }\n\n  /**\n   * Click-only equivalent of dropping the row onto `peer`. Runs the same vetoes\n   * and emits the same events as the drag path (`row-drag-start`, `row-drop`,\n   * `row-transfer`) so consumers cannot tell the two apart.\n   */\n  private transferToPeer(peer: RowDragDropPlugin<T>, rowIndex: number): void {\n    const dropZone = this.config.dropZone ?? '';\n    if (!dropZone) return;\n\n    const { rows, indices } = this.resolveDraggedRows(rowIndex);\n    if (rows.length === 0) return;\n    if (this.config.canDrag && !this.config.canDrag(rows[0], rowIndex)) return;\n\n    const operation = this.config.operation ?? 'move';\n    if (this.emitCancelable('row-drag-start', { rows, indices, operation, dropZone } as RowDragStartDetail<T>)) return;\n\n    const serialize = this.config.serializeRow ?? ((r: T) => r);\n    const payload: RowDragPayload<T> = {\n      sessionId: newDragSessionId(),\n      sourceGridId: this.gridId,\n      dropZone,\n      rows: rows.map(serialize) as T[],\n      rowIndices: indices,\n      operation,\n    };\n\n    const toIndex = peer.acceptTransfer(payload, rows);\n    if (toIndex < 0) return;\n\n    if (operation === 'move') {\n      const srcRows = [...(this.internalGrid._rows ?? this.sourceRows)];\n      for (const idx of [...indices].sort((a, b) => b - a)) {\n        if (idx >= 0 && idx < srcRows.length) srcRows.splice(idx, 1);\n      }\n      this.grid.rows = srcRows as unknown[];\n    }\n\n    const detail: RowTransferDetail<T> = {\n      rows,\n      fromGridId: this.gridId,\n      toGridId: peer.gridId,\n      fromIndices: indices,\n      toIndex,\n      operation,\n    };\n    peer.emitTransfer(detail);\n    this.emit('row-transfer', detail);\n  }\n\n  /**\n   * Target half of {@link RowDragDropPlugin.transferToPeer}. Returns the insert\n   * index, or `-1` when the transfer was rejected (zone mismatch, `canDrop`\n   * veto, or a cancelled `row-drop`).\n   *\n   * @internal\n   */\n  acceptTransfer(payload: RowDragPayload<T>, liveRows: readonly T[]): number {\n    const dropZone = this.config.dropZone ?? '';\n    if (!dropZone || dropZone !== payload.dropZone) return -1;\n\n    const rows = this.internalGrid._rows ?? this.sourceRows;\n    const targetIndex = rows.length;\n    if (this.config.canDrop && !this.config.canDrop(payload, targetIndex)) return -1;\n\n    const dropDetail: RowDropDetail<T> = {\n      payload,\n      sourceGridId: payload.sourceGridId,\n      targetIndex,\n      operation: payload.operation,\n    };\n    if (this.emitCancelable('row-drop', dropDetail)) return -1;\n\n    this.grid.rows = [...(rows as unknown[]), ...(liveRows as unknown[])];\n    return targetIndex;\n  }\n  // #endregion\n\n  private resolveDraggedRows(originIndex: number): { rows: T[]; indices: number[] } {\n    const rows = this.internalGrid._rows ?? this.sourceRows;\n    const originRow = rows[originIndex] as T;\n\n    // If a selection plugin is loaded and the dragged row is selected, drag the whole selection.\n    const selection = this.grid?.getPluginByName?.('selection') as\n      { getSelectedRowIndices?: () => number[]; getSelectedRows?: <U>() => U[] } | undefined;\n    if (selection?.getSelectedRowIndices) {\n      const selectedIndices = selection.getSelectedRowIndices();\n      if (selectedIndices.includes(originIndex) && selectedIndices.length > 1) {\n        const sorted = [...selectedIndices].sort((a, b) => a - b);\n        return {\n          rows: sorted.map((i) => rows[i] as T),\n          indices: sorted,\n        };\n      }\n    }\n    return { rows: [originRow], indices: [originIndex] };\n  }\n\n  private ensureAutoScroller(): void {\n    if (this.autoScroller) return;\n    const viewport = this.gridElement.querySelector<HTMLElement>('.rows-viewport');\n    if (!viewport) return;\n    const opts = typeof this.config.autoScroll === 'object' ? this.config.autoScroll : undefined;\n    this.autoScroller = createAutoScroller(viewport, opts, (active) => {\n      this.gridElement.classList.toggle('tbw-grid--auto-scrolling', active);\n    });\n  }\n\n  private applyDropPositionClasses(rowEl: HTMLElement | null, isBefore: boolean): void {\n    this.clearDropTargetClasses();\n    if (!rowEl) return;\n    rowEl.classList.add('drop-target');\n    rowEl.classList.toggle('drop-before', isBefore);\n    rowEl.classList.toggle('drop-after', !isBefore);\n  }\n\n  private clearDropTargetClasses(): void {\n    this.gridElement?.querySelectorAll('.data-grid-row.drop-target').forEach((row) => {\n      row.classList.remove('drop-target', 'drop-before', 'drop-after');\n    });\n  }\n\n  private clearDragClasses(): void {\n    this.gridElement?.querySelectorAll('.data-grid-row').forEach((row) => {\n      row.classList.remove(GridClasses.DRAGGING, 'drop-target', 'drop-before', 'drop-after');\n    });\n  }\n\n  private resetDragState(): void {\n    this.isDragging = false;\n    this.draggedRowIndex = null;\n    this.draggedRows = [];\n    this.draggedIndices = [];\n    this.dragSessionId = null;\n    this.dragAccepted = false;\n    this.dropRowIndex = null;\n    this.pendingMove = null;\n  }\n\n  private getRowIndex(rowEl: HTMLElement): number {\n    const cell = rowEl.querySelector('.cell[data-row]');\n    return cell ? parseInt(cell.getAttribute('data-row') ?? '-1', 10) : -1;\n  }\n\n  private clearDebounceTimer(): void {\n    if (this.debounceTimer) {\n      clearTimeout(this.debounceTimer);\n      this.debounceTimer = null;\n    }\n  }\n\n  // #endregion\n\n  // #region Intra-Grid Move\n\n  private handleKeyboardMove(row: T, fromIndex: number, toIndex: number, focusCol: number): void {\n    if (!this.pendingMove) {\n      this.pendingMove = { originalIndex: fromIndex, currentIndex: toIndex, row };\n    } else {\n      this.pendingMove.currentIndex = toIndex;\n    }\n    this.lastFocusCol = focusCol;\n\n    const grid = this.internalGrid;\n    const rows = [...(grid._rows ?? this.sourceRows)];\n    const [movedRow] = rows.splice(fromIndex, 1);\n    rows.splice(toIndex, 0, movedRow);\n\n    grid._rows = rows;\n    grid._focusRow = toIndex;\n    grid._focusCol = focusCol;\n    grid.refreshVirtualWindow(true);\n    ensureCellVisible(grid);\n\n    this.clearDebounceTimer();\n    this.debounceTimer = setTimeout(() => this.flushPendingMove(), this.config.debounceMs ?? 300);\n  }\n\n  private flushPendingMove(): void {\n    this.clearDebounceTimer();\n    if (!this.pendingMove) return;\n    const { originalIndex, currentIndex, row: movedRow } = this.pendingMove;\n    this.pendingMove = null;\n    if (originalIndex === currentIndex) return;\n\n    const grid = this.internalGrid;\n    // `grid._rows` already reflects the post-move order (mutated incrementally\n    // by `handleKeyboardMove`); report it as `detail.rows` so consumers see\n    // the actual reordered array, not the original `sourceRows` snapshot.\n    const postMoveRows = (grid._rows ?? this.sourceRows) as T[];\n    const detail: RowMoveDetail<T> = {\n      row: movedRow as T,\n      fromIndex: originalIndex,\n      toIndex: currentIndex,\n      rows: [...postMoveRows],\n      source: 'keyboard',\n    };\n    const cancelled = this.emitCancelable('row-move', detail);\n    if (cancelled) {\n      // Revert: restore the original snapshot. `sourceRows` was never mutated\n      // during the pending move (only `grid._rows` was), so resetting from it\n      // is the correct rollback regardless of how many incremental keyboard\n      // moves accumulated.\n      grid._rows = [...this.sourceRows];\n      grid._focusRow = originalIndex;\n      grid._focusCol = this.lastFocusCol;\n      grid.refreshVirtualWindow(true);\n      ensureCellVisible(grid);\n    }\n  }\n\n  private executeIntraGridMove(row: unknown, fromIndex: number, toIndex: number, source: 'keyboard' | 'drag'): void {\n    const rows = [...this.sourceRows];\n    const [movedRow] = rows.splice(fromIndex, 1);\n    rows.splice(toIndex, 0, movedRow);\n    const detail: RowMoveDetail<T> = {\n      row: row as T,\n      fromIndex,\n      toIndex,\n      rows: rows as T[],\n      source,\n    };\n    const cancelled = this.emitCancelable('row-move', detail);\n    if (cancelled) return;\n    if (this.animationType === 'flip' && this.gridElement) {\n      const oldPositions = this.captureRowPositions();\n      this.grid.rows = rows;\n      requestAnimationFrame(() => {\n        void this.gridElement.offsetHeight;\n        this.animateFLIP(oldPositions, fromIndex, toIndex);\n      });\n    } else {\n      this.grid.rows = rows;\n    }\n  }\n\n  private captureRowPositions(): Map<number, number> {\n    const positions = new Map<number, number>();\n    this.gridElement?.querySelectorAll('.data-grid-row').forEach((row) => {\n      const rowIndex = this.getRowIndex(row as HTMLElement);\n      if (rowIndex >= 0) positions.set(rowIndex, row.getBoundingClientRect().top);\n    });\n    return positions;\n  }\n\n  private animateFLIP(oldPositions: Map<number, number>, fromIndex: number, toIndex: number): void {\n    const gridEl = this.gridElement;\n    if (!gridEl || oldPositions.size === 0) return;\n\n    const minIndex = Math.min(fromIndex, toIndex);\n    const maxIndex = Math.max(fromIndex, toIndex);\n    const rowsToAnimate: { el: HTMLElement; deltaY: number }[] = [];\n\n    gridEl.querySelectorAll('.data-grid-row').forEach((row) => {\n      const rowEl = row as HTMLElement;\n      const newRowIndex = this.getRowIndex(rowEl);\n      if (newRowIndex < 0 || newRowIndex < minIndex || newRowIndex > maxIndex) return;\n      let oldIndex: number;\n      if (newRowIndex === toIndex) oldIndex = fromIndex;\n      else if (fromIndex < toIndex) oldIndex = newRowIndex + 1;\n      else oldIndex = newRowIndex - 1;\n      const oldTop = oldPositions.get(oldIndex);\n      if (oldTop === undefined) return;\n      const newTop = rowEl.getBoundingClientRect().top;\n      const deltaY = oldTop - newTop;\n      if (Math.abs(deltaY) > 1) rowsToAnimate.push({ el: rowEl, deltaY });\n    });\n\n    if (rowsToAnimate.length === 0) return;\n\n    rowsToAnimate.forEach(({ el, deltaY }) => {\n      el.style.transform = `translateY(${deltaY}px)`;\n    });\n    void gridEl.offsetHeight;\n\n    const duration = this.animationDuration;\n    requestAnimationFrame(() => {\n      rowsToAnimate.forEach(({ el }) => {\n        el.classList.add('flip-animating');\n        el.style.transform = '';\n      });\n      setTimeout(() => {\n        rowsToAnimate.forEach(({ el }) => {\n          el.style.transform = '';\n          el.classList.remove('flip-animating');\n        });\n      }, duration + 50);\n    });\n  }\n\n  // #endregion\n}\n"],"mappings":"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"}