@toolbox-web/grid 0.2.4 → 0.2.6

package/lib/plugins/clipboard/index.js

@@ -99,7 +99,7 @@ class I {
    * Use this for rendering that needs to match the grid template.
    */
   get visibleColumns() {
-    return this.grid?.visibleColumns ?? [];
+    return this.grid?._visibleColumns ?? [];
   }
   /**
    * Get the shadow root of the grid.

package/lib/plugins/clipboard/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../../../libs/grid/src/lib/core/types.ts","../../../../../../libs/grid/src/lib/core/plugin/base-plugin.ts","../../../../../../libs/grid/src/lib/plugins/clipboard/copy.ts","../../../../../../libs/grid/src/lib/plugins/clipboard/paste.ts","../../../../../../libs/grid/src/lib/plugins/clipboard/ClipboardPlugin.ts"],"sourcesContent":["import type { PluginQuery } from './plugin/base-plugin';\n\n/**\n * The compiled webcomponent interface for DataGrid\n */\nexport interface DataGridElement extends PublicGrid, HTMLElement {}\n\n/**\n * Public API interface for DataGrid component.\n *\n * **Property Getters vs Setters:**\n *\n * Property getters return the EFFECTIVE (resolved) value after merging all config sources.\n * This is the \"current situation\" - what consumers and plugins need to know.\n *\n * Property setters accept input values which are merged into the effective config.\n * Multiple sources can contribute (gridConfig, columns prop, light DOM, individual props).\n *\n * For example:\n * - `grid.fitMode` returns the resolved fitMode (e.g., 'stretch' even if you set undefined)\n * - `grid.columns` returns the effective columns after merging\n * - `grid.gridConfig` returns the full effective config\n */\nexport interface PublicGrid<T = any> {\n  /**\n   * Full config object. Setter merges with other inputs per precedence rules.\n   * Getter returns the effective (resolved) config.\n   */\n  gridConfig?: GridConfig<T>;\n  /**\n   * Column definitions.\n   * Getter returns effective columns (after merging config, light DOM, inference).\n   */\n  columns?: ColumnConfig<T>[];\n  /** Current row data (after plugin processing like grouping, filtering). */\n  rows?: T[];\n  /** Resolves once the component has finished initial work (layout, inference). */\n  ready?: () => Promise<void>;\n  /** Force a layout / measurement pass (e.g. after container resize). */\n  forceLayout?: () => Promise<void>;\n  /** Return effective resolved config (after inference & precedence). */\n  getConfig?: () => Promise<Readonly<GridConfig<T>>>;\n  /** Toggle expansion state of a group row by its generated key. */\n  toggleGroup?: (key: string) => Promise<void>;\n}\n\n/**\n * Internal-only augmented interface for DataGrid component\n */\nexport interface InternalGrid<T = any> extends PublicGrid<T>, GridConfig<T> {\n  shadowRoot: ShadowRoot | null;\n  _rows: T[];\n  _columns: ColumnInternal<T>[];\n  /** Visible columns only (excludes hidden). Use for rendering. */\n  _visibleColumns: ColumnInternal<T>[];\n  _headerRowEl: HTMLElement;\n  _bodyEl: HTMLElement;\n  _rowPool: HTMLElement[];\n  _resizeController: ResizeController;\n  _sortState: { field: string; direction: 1 | -1 } | null;\n  __originalOrder: T[];\n  __rowRenderEpoch: number;\n  __didInitialAutoSize?: boolean;\n  __lightDomColumnsCache?: ColumnInternal[];\n  __originalColumnNodes?: HTMLElement[];\n  _gridTemplate: string;\n  _virtualization: VirtualState;\n  _focusRow: number;\n  _focusCol: number;\n  _activeEditRows: number;\n  _rowEditSnapshots: Map<number, T>;\n  _changedRowIndices: Set<number>;\n  changedRows?: T[];\n  changedRowIndices?: number[];\n  effectiveConfig?: GridConfig<T>;\n  findHeaderRow?: () => HTMLElement;\n  refreshVirtualWindow: (full: boolean) => void;\n  updateTemplate?: () => void;\n  findRenderedRowElement?: (rowIndex: number) => HTMLElement | null;\n  beginBulkEdit?: (rowIndex: number) => void;\n  commitActiveRowEdit?: () => void;\n  /** Dispatch cell click to plugin system, returns true if handled */\n  _dispatchCellClick?: (event: MouseEvent, rowIndex: number, colIndex: number, cellEl: HTMLElement) => boolean;\n  /** Dispatch header click to plugin system, returns true if handled */\n  _dispatchHeaderClick?: (event: MouseEvent, colIndex: number, headerEl: HTMLElement) => boolean;\n  /** Dispatch keydown to plugin system, returns true if handled */\n  _dispatchKeyDown?: (event: KeyboardEvent) => boolean;\n  /** Get horizontal scroll boundary offsets from plugins (e.g., pinned columns) */\n  _getHorizontalScrollOffsets?: (\n    rowEl?: HTMLElement,\n    focusedCell?: HTMLElement,\n  ) => { left: number; right: number; skipScroll?: boolean };\n  /** Query all plugins with a generic query and collect responses */\n  queryPlugins?: <T>(query: PluginQuery) => T[];\n  /** Request emission of column-state-change event (debounced) */\n  requestStateChange?: () => void;\n}\n\nexport type PrimitiveColumnType = 'number' | 'string' | 'date' | 'boolean' | 'select' | 'typeahead';\n\n/**\n * Base contract for a column. Public; kept intentionally lean so host apps can extend via intersection types.\n * Prefer adding optional properties here only when broadly useful to most grids.\n */\nexport interface BaseColumnConfig<TRow = any, TValue = any> {\n  /** Unique field key referencing property in row objects */\n  field: keyof TRow & string;\n  /** Visible header label; defaults to capitalized field */\n  header?: string;\n  /** Column data type; inferred if omitted */\n  type?: PrimitiveColumnType;\n  /** Column width in pixels; fixed size (no flexibility) */\n  width?: string | number;\n  /** Minimum column width in pixels (stretch mode only); when set, column uses minmax(minWidth, 1fr) */\n  minWidth?: number;\n  /** Whether column can be sorted */\n  sortable?: boolean;\n  /** Whether column can be resized by user */\n  resizable?: boolean;\n  /** Optional custom comparator for sorting (a,b) -> number */\n  sortComparator?: (a: TValue, b: TValue, rowA: TRow, rowB: TRow) => number;\n  /** Whether the field is editable (enables editors) */\n  editable?: boolean;\n  /** Optional custom editor factory or element tag name */\n  editor?: ColumnEditorSpec<TRow, TValue>;\n  /** For select/typeahead types - available options */\n  options?: Array<{ label: string; value: unknown }> | (() => Array<{ label: string; value: unknown }>);\n  /** For select/typeahead - allow multi select */\n  multi?: boolean;\n  /** Optional formatter */\n  format?: (value: TValue, row: TRow) => string;\n  /** Arbitrary extra metadata */\n  meta?: Record<string, unknown>;\n}\n\n/**\n * Full column configuration including optional custom view/renderer & grouping metadata.\n */\nexport interface ColumnConfig<TRow = any> extends BaseColumnConfig<TRow, any> {\n  /** Optional custom view renderer used instead of default text rendering */\n  viewRenderer?: ColumnViewRenderer<TRow, any>;\n  /** External view spec (lets host app mount any framework component) */\n  externalView?: {\n    component: unknown;\n    props?: Record<string, unknown>;\n    mount?: (options: {\n      placeholder: HTMLElement;\n      context: CellRenderContext<TRow, unknown>;\n      spec: unknown;\n    }) => void | { dispose?: () => void };\n  };\n  /** Whether the column is initially hidden */\n  hidden?: boolean;\n  /** Prevent this column from being hidden by the visibility plugin */\n  lockVisible?: boolean;\n}\n\nexport type ColumnConfigMap<TRow = any> = ColumnConfig<TRow>[];\n\n/** External editor spec: tag name, factory function, or external mount spec */\nexport type ColumnEditorSpec<TRow = unknown, TValue = unknown> =\n  | string // custom element tag name\n  | ((context: ColumnEditorContext<TRow, TValue>) => HTMLElement | string)\n  | {\n      /** Arbitrary component reference (class, function, token) */\n      component: unknown;\n      /** Optional static props passed to mount */\n      props?: Record<string, unknown>;\n      /** Optional custom mount function; if provided we call it directly instead of emitting an event */\n      mount?: (options: {\n        placeholder: HTMLElement;\n        context: ColumnEditorContext<TRow, TValue>;\n        spec: unknown;\n      }) => void | { dispose?: () => void };\n    };\n\n/**\n * Context object provided to editor factories allowing mutation (commit/cancel) of a cell value.\n */\nexport interface ColumnEditorContext<TRow = any, TValue = any> {\n  /** Underlying full row object for the active edit. */\n  row: TRow;\n  /** Current cell value (mutable only via commit). */\n  value: TValue;\n  /** Field name being edited. */\n  field: keyof TRow & string;\n  /** Column configuration reference. */\n  column: ColumnConfig<TRow>;\n  /** Accept the edit; triggers change tracking + rerender. */\n  commit: (newValue: TValue) => void;\n  /** Abort edit without persisting changes. */\n  cancel: () => void;\n}\n\n/**\n * Context passed to custom view renderers (pure display – no commit helpers).\n */\nexport interface CellRenderContext<TRow = any, TValue = any> {\n  /** Row object for the cell being rendered. */\n  row: TRow;\n  /** Value at field. */\n  value: TValue;\n  /** Field key. */\n  field: keyof TRow & string;\n  /** Column configuration reference. */\n  column: ColumnConfig<TRow>;\n}\n\nexport type ColumnViewRenderer<TRow = unknown, TValue = unknown> = (\n  ctx: CellRenderContext<TRow, TValue>,\n) => Node | string | void;\n\n// #region Internal-only augmented types (not re-exported publicly)\nexport interface ColumnInternal<T = any> extends ColumnConfig<T> {\n  __autoSized?: boolean;\n  __userResized?: boolean;\n  __renderedWidth?: number;\n  __viewTemplate?: HTMLElement;\n  __editorTemplate?: HTMLElement;\n  __headerTemplate?: HTMLElement;\n  __compiledView?: (ctx: CellContext<T>) => string;\n  __compiledEditor?: (ctx: EditorExecContext<T>) => string;\n}\n\n/**\n * Runtime cell context used internally for compiled template execution.\n */\nexport interface CellContext<T = any> {\n  row: T;\n  value: unknown;\n  field: string;\n  column: ColumnInternal<T>;\n}\n\n/**\n * Internal editor execution context extending the generic cell context with commit helpers.\n */\nexport interface EditorExecContext<T = any> extends CellContext<T> {\n  commit: (newValue: unknown) => void;\n  cancel: () => void;\n}\n\n/** Controller managing drag-based column resize lifecycle. */\nexport interface ResizeController {\n  start: (e: MouseEvent, colIndex: number, cell: HTMLElement) => void;\n  dispose: () => void;\n  /** True while a resize drag is in progress (used to suppress header click/sort). */\n  isResizing: boolean;\n}\n\n/** Virtual window bookkeeping; modified in-place as scroll position changes. */\nexport interface VirtualState {\n  enabled: boolean;\n  rowHeight: number;\n  /** Threshold for bypassing virtualization (renders all rows if totalRows <= bypassThreshold) */\n  bypassThreshold: number;\n  start: number;\n  end: number;\n  /** Faux scrollbar element that provides scroll events (AG Grid pattern) */\n  container: HTMLElement | null;\n  /** Rows viewport element for measuring visible area height */\n  viewportEl: HTMLElement | null;\n  /** Spacer element inside faux scrollbar for setting virtual height */\n  totalHeightEl: HTMLElement | null;\n}\n// #endregion\n\n// #region Grouping & Footer Public Types\n/**\n * Group row rendering customization options.\n * Used within grouping-rows plugin config for presentation of group rows.\n */\nexport interface RowGroupRenderConfig {\n  /** If true, group rows span all columns (single full-width cell). Default false. */\n  fullWidth?: boolean;\n  /** Optional label formatter override. Receives raw group value + depth. */\n  formatLabel?: (value: unknown, depth: number, key: string) => string;\n  /** Optional aggregate overrides per field for group summary cells (only when not fullWidth). */\n  aggregators?: Record<string, AggregatorRef>;\n  /** Additional CSS class applied to each group row root element. */\n  class?: string;\n}\n\nexport type AggregatorRef = string | ((rows: unknown[], field: string, column?: unknown) => unknown);\n\n/** Result of automatic column inference from sample rows. */\nexport interface InferredColumnResult<TRow = unknown> {\n  columns: ColumnConfigMap<TRow>;\n  typeMap: Record<string, PrimitiveColumnType>;\n}\n\nexport const FitModeEnum = {\n  STRETCH: 'stretch',\n  FIXED: 'fixed',\n} as const;\nexport type FitMode = (typeof FitModeEnum)[keyof typeof FitModeEnum]; // evaluates to 'stretch' | 'fixed'\n// #endregion\n\n// #region Plugin Interface\n/**\n * Minimal plugin interface for type-checking.\n * This interface is defined here to avoid circular imports with BaseGridPlugin.\n * All plugins must satisfy this shape (BaseGridPlugin implements it).\n */\nexport interface GridPlugin {\n  /** Unique plugin identifier */\n  readonly name: string;\n  /** Plugin version */\n  readonly version: string;\n  /** CSS styles to inject into grid's shadow DOM */\n  readonly styles?: string;\n}\n// #endregion\n\n// #region Grid Config\n/**\n * Grid configuration object - the **single source of truth** for grid behavior.\n *\n * Users can configure the grid via multiple input methods, all of which converge\n * into an effective `GridConfig` internally:\n *\n * **Configuration Input Methods:**\n * - `gridConfig` property - direct assignment of this object\n * - `columns` property - shorthand for `gridConfig.columns`\n * - `fitMode` property - shorthand for `gridConfig.fitMode`\n * - `editOn` property - shorthand for `gridConfig.editOn`\n * - Light DOM `<tbw-grid-column>` - declarative columns (merged into `columns`)\n * - Light DOM `<tbw-grid-header>` - declarative shell header (merged into `shell.header`)\n *\n * **Precedence (when same property set multiple ways):**\n * Individual props (`fitMode`, `editOn`) > `columns` prop > Light DOM > `gridConfig`\n *\n * @example\n * ```ts\n * // Via gridConfig (recommended for complex setups)\n * grid.gridConfig = {\n *   columns: [{ field: 'name' }, { field: 'age' }],\n *   fitMode: 'stretch',\n *   plugins: [new SelectionPlugin()],\n *   shell: { header: { title: 'My Grid' } }\n * };\n *\n * // Via individual props (convenience for simple cases)\n * grid.columns = [{ field: 'name' }, { field: 'age' }];\n * grid.fitMode = 'stretch';\n * ```\n */\nexport interface GridConfig<TRow = any> {\n  /** Column definitions. Can also be set via `columns` prop or `<tbw-grid-column>` light DOM. */\n  columns?: ColumnConfigMap<TRow>;\n  /** Sizing mode for columns. Can also be set via `fitMode` prop. */\n  fitMode?: FitMode;\n  /** Edit activation mode ('click' | 'dblclick'). Can also be set via `editOn` prop. */\n  editOn?: string;\n  /**\n   * Row height in pixels for virtualization calculations.\n   * The virtualization system assumes uniform row heights for performance.\n   *\n   * If not specified, the grid measures the first rendered row's height,\n   * which respects the CSS variable `--tbw-row-height` set by themes.\n   *\n   * Set this explicitly when:\n   * - Row content may wrap to multiple lines (also set `--tbw-cell-white-space: normal`)\n   * - Using custom row templates with variable content\n   * - You want to override theme-defined row height\n   *\n   * @default Auto-measured from first row (respects --tbw-row-height CSS variable)\n   *\n   * @example\n   * ```ts\n   * // Fixed height for rows that may wrap to 2 lines\n   * gridConfig = { rowHeight: 56 };\n   * ```\n   */\n  rowHeight?: number;\n  /**\n   * Array of plugin instances.\n   * Each plugin is instantiated with its configuration and attached to this grid.\n   *\n   * @example\n   * ```ts\n   * plugins: [\n   *   new SelectionPlugin({ mode: 'range' }),\n   *   new MultiSortPlugin(),\n   *   new FilteringPlugin({ debounceMs: 150 }),\n   * ]\n   * ```\n   */\n  plugins?: GridPlugin[];\n\n  /**\n   * Saved column state to restore on initialization.\n   * Includes order, width, visibility, sort, and plugin-contributed state.\n   */\n  columnState?: GridColumnState;\n\n  /**\n   * Shell configuration for header bar and tool panels.\n   * When configured, adds an optional wrapper with title, toolbar, and collapsible side panels.\n   */\n  shell?: ShellConfig;\n\n  /**\n   * Grid-wide icon configuration.\n   * Provides consistent icons across all plugins (tree, grouping, sorting, etc.).\n   * Plugins will use these by default but can override with their own config.\n   */\n  icons?: GridIcons;\n}\n// #endregion\n\n// #region Grid Icons\n\n/** Icon value - can be a string (text/HTML) or HTMLElement */\nexport type IconValue = string | HTMLElement;\n\n/**\n * Grid-wide icon configuration.\n * All icons are optional - sensible defaults are used when not specified.\n */\nexport interface GridIcons {\n  /** Expand icon for collapsed items (trees, groups, details). Default: '▶' */\n  expand?: IconValue;\n  /** Collapse icon for expanded items (trees, groups, details). Default: '▼' */\n  collapse?: IconValue;\n  /** Sort ascending indicator. Default: '▲' */\n  sortAsc?: IconValue;\n  /** Sort descending indicator. Default: '▼' */\n  sortDesc?: IconValue;\n  /** Sort neutral/unsorted indicator. Default: '⇅' */\n  sortNone?: IconValue;\n  /** Submenu arrow for context menus. Default: '▶' */\n  submenuArrow?: IconValue;\n  /** Drag handle icon for reordering. Default: '⋮⋮' */\n  dragHandle?: IconValue;\n  /** Tool panel toggle icon in toolbar. Default: '☰' */\n  toolPanel?: IconValue;\n}\n\n/** Default icons used when not overridden */\nexport const DEFAULT_GRID_ICONS: Required<GridIcons> = {\n  expand: '▶',\n  collapse: '▼',\n  sortAsc: '▲',\n  sortDesc: '▼',\n  sortNone: '⇅',\n  submenuArrow: '▶',\n  dragHandle: '⋮⋮',\n  toolPanel: '☰',\n};\n// #endregion\n\n// #region Shell Configuration\n\n/**\n * Shell configuration for the grid's optional header bar and tool panels.\n */\nexport interface ShellConfig {\n  /** Shell header bar configuration */\n  header?: ShellHeaderConfig;\n  /** Tool panel configuration */\n  toolPanel?: ToolPanelConfig;\n}\n\n/**\n * Shell header bar configuration\n */\nexport interface ShellHeaderConfig {\n  /** Grid title displayed on the left (optional) */\n  title?: string;\n  /** Custom toolbar buttons (rendered before tool panel toggles) */\n  toolbarButtons?: ToolbarButtonConfig[];\n}\n\n/**\n * Tool panel configuration\n */\nexport interface ToolPanelConfig {\n  /** Panel position: 'left' | 'right' (default: 'right') */\n  position?: 'left' | 'right';\n  /** Default panel width in pixels (default: 280) */\n  width?: number;\n  /** Panel ID to open by default on load */\n  defaultOpen?: string;\n  /** Whether to persist open/closed state (requires Column State Events) */\n  persistState?: boolean;\n}\n\n/**\n * Toolbar button defined via config (programmatic approach).\n * Supports three modes:\n * - Simple: provide `icon` + `action` for grid to create button\n * - Element: provide `element` for user-created DOM\n * - Render: provide `render` function for complex widgets\n */\nexport interface ToolbarButtonConfig {\n  /** Unique button ID */\n  id: string;\n  /** Tooltip / aria-label (required for accessibility) */\n  label: string;\n  /** Order priority (lower = first, default: 100) */\n  order?: number;\n  /** Whether button is disabled (only applies to grid-rendered buttons) */\n  disabled?: boolean;\n\n  // ===== Option A: Simple - Grid renders the button =====\n  /** Button content: SVG string, emoji, or text. Grid creates <button> with this. */\n  icon?: string;\n  /** Click handler (required when using icon) */\n  action?: () => void;\n\n  // ===== Option B: Custom DOM - User provides element or render function =====\n  /**\n   * User-provided element. Grid wraps it but doesn't modify it.\n   * User is responsible for event handlers.\n   */\n  element?: HTMLElement;\n  /**\n   * Render function called once. Receives container, user appends their DOM.\n   * User is responsible for event handlers.\n   * Return a cleanup function (optional).\n   */\n  render?: (container: HTMLElement) => void | (() => void);\n}\n\n/**\n * Toolbar button info returned by getToolbarButtons().\n */\nexport interface ToolbarButtonInfo {\n  id: string;\n  label: string;\n  disabled: boolean;\n  /** Source of this button: 'config' | 'light-dom' | 'panel-toggle' */\n  source: 'config' | 'light-dom' | 'panel-toggle';\n  /** For panel toggles, the associated panel ID */\n  panelId?: string;\n}\n\n/**\n * Tool panel definition registered by plugins or consumers.\n */\nexport interface ToolPanelDefinition {\n  /** Unique panel ID */\n  id: string;\n  /** Panel title shown in accordion header */\n  title: string;\n  /** Icon for accordion section header (optional, emoji or SVG) */\n  icon?: string;\n  /** Tooltip for accordion section header */\n  tooltip?: string;\n  /** Panel content factory - called when panel section opens */\n  render: (container: HTMLElement) => void | (() => void);\n  /** Called when panel closes (for cleanup) */\n  onClose?: () => void;\n  /** Panel order priority (lower = first, default: 100) */\n  order?: number;\n}\n\n/**\n * Header content definition for plugins contributing to shell header center section.\n */\nexport interface HeaderContentDefinition {\n  /** Unique content ID */\n  id: string;\n  /** Content factory - called once when shell header renders */\n  render: (container: HTMLElement) => void | (() => void);\n  /** Called when content is removed (for cleanup) */\n  onDestroy?: () => void;\n  /** Order priority (lower = first, default: 100) */\n  order?: number;\n}\n// #endregion\n\n// #region Column State (Persistence)\n\n/**\n * State for a single column. Captures user-driven changes at runtime.\n * Plugins can extend this interface via module augmentation to add their own state.\n *\n * @example\n * ```ts\n * // In filtering plugin\n * declare module '@toolbox-web/grid' {\n *   interface ColumnState {\n *     filter?: FilterValue;\n *   }\n * }\n * ```\n */\nexport interface ColumnState {\n  /** Column field identifier */\n  field: string;\n  /** Position index after reordering (0-based) */\n  order: number;\n  /** Width in pixels (undefined = use default) */\n  width?: number;\n  /** Visibility state */\n  visible: boolean;\n  /** Sort state (undefined = not sorted) */\n  sort?: ColumnSortState;\n}\n\n/**\n * Sort state for a column\n */\nexport interface ColumnSortState {\n  /** Sort direction */\n  direction: 'asc' | 'desc';\n  /** Priority for multi-sort (0 = primary, 1 = secondary, etc.) */\n  priority: number;\n}\n\n/**\n * Complete grid column state for persistence.\n * Contains state for all columns, including plugin-contributed properties.\n */\nexport interface GridColumnState {\n  columns: ColumnState[];\n}\n// #endregion\n\n// #region Public Event Detail Interfaces\nexport interface CellCommitDetail<TRow = unknown> {\n  /** The mutated row after commit. */\n  row: TRow;\n  /** Field name whose value changed. */\n  field: string;\n  /** New value stored. */\n  value: unknown;\n  /** Index of the row in current data set. */\n  rowIndex: number;\n  /** All rows that have at least one committed change (snapshot list). */\n  changedRows: TRow[];\n  /** Indices parallel to changedRows. */\n  changedRowIndices: number[];\n  /** True if this row just entered the changed set. */\n  firstTimeForRow: boolean;\n}\n\n/** Detail payload for a committed row edit (may or may not include changes). */\nexport interface RowCommitDetail<TRow = unknown> {\n  /** Row index that lost edit focus. */\n  rowIndex: number;\n  /** Row object reference. */\n  row: TRow;\n  /** Whether any cell changes were actually committed in this row during the session. */\n  changed: boolean;\n  /** Current changed row collection. */\n  changedRows: TRow[];\n  /** Indices of changed rows. */\n  changedRowIndices: number[];\n}\n\n/** Emitted when the changed rows tracking set is cleared programmatically. */\nexport interface ChangedRowsResetDetail<TRow = unknown> {\n  /** New (empty) changed rows array after reset. */\n  rows: TRow[];\n  /** Parallel indices (likely empty). */\n  indices: number[];\n}\n\n/** Detail for a sort change (direction 0 indicates cleared sort). */\nexport interface SortChangeDetail {\n  /** Sorted field key. */\n  field: string;\n  /** Direction: 1 ascending, -1 descending, 0 cleared. */\n  direction: 1 | -1 | 0;\n}\n\n/** Column resize event detail containing final pixel width. */\nexport interface ColumnResizeDetail {\n  /** Resized column field key. */\n  field: string;\n  /** New width in pixels. */\n  width: number;\n}\n\n/** Fired when keyboard navigation or programmatic focus changes active cell. */\nexport interface ActivateCellDetail {\n  /** Zero-based row index now focused. */\n  row: number;\n  /** Zero-based column index now focused. */\n  col: number;\n}\n\nexport interface ExternalMountViewDetail<TRow = unknown> {\n  placeholder: HTMLElement;\n  spec: unknown;\n  context: { row: TRow; value: unknown; field: string; column: unknown };\n}\n\nexport interface ExternalMountEditorDetail<TRow = unknown> {\n  placeholder: HTMLElement;\n  spec: unknown;\n  context: {\n    row: TRow;\n    value: unknown;\n    field: string;\n    column: unknown;\n    commit: (v: unknown) => void;\n    cancel: () => void;\n  };\n}\n\nexport interface DataGridEventMap<TRow = unknown> {\n  'cell-commit': CellCommitDetail<TRow>;\n  'row-commit': RowCommitDetail<TRow>;\n  'changed-rows-reset': ChangedRowsResetDetail<TRow>;\n  'mount-external-view': ExternalMountViewDetail<TRow>;\n  'mount-external-editor': ExternalMountEditorDetail<TRow>;\n  'sort-change': SortChangeDetail;\n  'column-resize': ColumnResizeDetail;\n  'activate-cell': ActivateCellDetail;\n  'column-state-change': GridColumnState;\n}\n\nexport type DataGridEventDetail<K extends keyof DataGridEventMap<unknown>, TRow = unknown> = DataGridEventMap<TRow>[K];\nexport type DataGridCustomEvent<K extends keyof DataGridEventMap<unknown>, TRow = unknown> = CustomEvent<\n  DataGridEventMap<TRow>[K]\n>;\n\n// Internal code now reuses the public ColumnEditorContext; provide alias for backward compatibility\nexport type EditorContext<T = unknown> = ColumnEditorContext<T, unknown>;\n\nexport interface EvalContext {\n  value: unknown;\n  row: Record<string, unknown> | null;\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\nimport type {\n  ColumnConfig,\n  ColumnState,\n  GridPlugin,\n  HeaderContentDefinition,\n  IconValue,\n  ToolPanelDefinition,\n} from '../types';\nimport { DEFAULT_GRID_ICONS } from '../types';\n\n// Forward declare to avoid circular imports\nexport interface GridElement {\n  shadowRoot: ShadowRoot | null;\n  rows: any[];\n  columns: ColumnConfig[];\n  gridConfig: any;\n  /** Current focused row index */\n  focusRow: number;\n  /** Current focused column index */\n  focusCol: number;\n  /** AbortSignal that is aborted when the grid disconnects from the DOM */\n  disconnectSignal: AbortSignal;\n  requestRender(): void;\n  requestAfterRender(): void;\n  forceLayout(): Promise<void>;\n  getPlugin<T extends BaseGridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined;\n  getPluginByName(name: string): BaseGridPlugin | undefined;\n  dispatchEvent(event: Event): boolean;\n}\n\n/**\n * Keyboard modifier flags\n */\nexport interface KeyboardModifiers {\n  ctrl?: boolean;\n  shift?: boolean;\n  alt?: boolean;\n  meta?: boolean;\n}\n\n/**\n * Cell coordinates\n */\nexport interface CellCoords {\n  row: number;\n  col: number;\n}\n\n/**\n * Cell click event\n */\nexport interface CellClickEvent {\n  rowIndex: number;\n  colIndex: number;\n  field: string;\n  value: any;\n  row: any;\n  cellEl: HTMLElement;\n  originalEvent: MouseEvent;\n}\n\n/**\n * Row click event\n */\nexport interface RowClickEvent {\n  rowIndex: number;\n  row: any;\n  rowEl: HTMLElement;\n  originalEvent: MouseEvent;\n}\n\n/**\n * Header click event\n */\nexport interface HeaderClickEvent {\n  colIndex: number;\n  field: string;\n  column: ColumnConfig;\n  headerEl: HTMLElement;\n  originalEvent: MouseEvent;\n}\n\n/**\n * Scroll event\n */\nexport interface ScrollEvent {\n  scrollTop: number;\n  scrollLeft: number;\n  scrollHeight: number;\n  scrollWidth: number;\n  clientHeight: number;\n  clientWidth: number;\n  originalEvent?: Event;\n}\n\n/**\n * Cell mouse event (for drag operations, selection, etc.)\n */\nexport interface CellMouseEvent {\n  /** Event type: mousedown, mousemove, or mouseup */\n  type: 'mousedown' | 'mousemove' | 'mouseup';\n  /** Row index, undefined if not over a data cell */\n  rowIndex?: number;\n  /** Column index, undefined if not over a cell */\n  colIndex?: number;\n  /** Field name, undefined if not over a cell */\n  field?: string;\n  /** Cell value, undefined if not over a data cell */\n  value?: unknown;\n  /** Row data object, undefined if not over a data row */\n  row?: unknown;\n  /** Column configuration, undefined if not over a column */\n  column?: ColumnConfig;\n  /** The cell element, undefined if not over a cell */\n  cellElement?: HTMLElement;\n  /** The row element, undefined if not over a row */\n  rowElement?: HTMLElement;\n  /** Whether the event is over a header cell */\n  isHeader: boolean;\n  /** Cell coordinates if over a valid data cell */\n  cell?: CellCoords;\n  /** The original mouse event */\n  originalEvent: MouseEvent;\n}\n\n/**\n * Context menu parameters\n */\nexport interface ContextMenuParams {\n  x: number;\n  y: number;\n  rowIndex?: number;\n  colIndex?: number;\n  field?: string;\n  value?: any;\n  row?: any;\n  column?: ColumnConfig;\n  isHeader?: boolean;\n}\n\n/**\n * Context menu item (used by context-menu plugin query)\n */\nexport interface ContextMenuItem {\n  id: string;\n  label: string;\n  icon?: string;\n  disabled?: boolean;\n  separator?: boolean;\n  children?: ContextMenuItem[];\n  action?: (params: ContextMenuParams) => void;\n}\n\n/**\n * Generic plugin query for inter-plugin communication.\n * Plugins can define their own query types as string constants\n * and respond to queries from other plugins.\n */\nexport interface PluginQuery<T = unknown> {\n  /** Query type identifier (e.g., 'canMoveColumn', 'getContextMenuItems') */\n  type: string;\n  /** Query-specific context/parameters */\n  context: T;\n}\n\n/**\n * Well-known plugin query types.\n * Plugins can define additional query types beyond these.\n */\nexport const PLUGIN_QUERIES = {\n  /** Ask if a column can be moved. Context: ColumnConfig. Response: boolean | undefined */\n  CAN_MOVE_COLUMN: 'canMoveColumn',\n  /** Get context menu items. Context: ContextMenuParams. Response: ContextMenuItem[] */\n  GET_CONTEXT_MENU_ITEMS: 'getContextMenuItems',\n} as const;\n\n/**\n * Cell render context for plugin cell renderers.\n * Provides full context including position and editing state.\n *\n * Note: This differs from the core `CellRenderContext` in types.ts which is\n * simpler and used for column view renderers. This version provides additional\n * context needed by plugins that register custom cell renderers.\n */\nexport interface PluginCellRenderContext {\n  /** The cell value */\n  value: any;\n  /** The field/column key */\n  field: string;\n  /** The row data object */\n  row: any;\n  /** Row index in the data array */\n  rowIndex: number;\n  /** Column index */\n  colIndex: number;\n  /** Column configuration */\n  column: ColumnConfig;\n  /** Whether the cell is currently in edit mode */\n  isEditing: 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 * Cell renderer function type for plugins.\n */\nexport type CellRenderer = (ctx: PluginCellRenderContext) => string | HTMLElement;\n\n/**\n * Header renderer function type for plugins.\n */\nexport type HeaderRenderer = (ctx: PluginHeaderRenderContext) => string | HTMLElement;\n\n/**\n * Cell editor interface for plugins.\n */\nexport interface CellEditor {\n  create(ctx: PluginCellRenderContext, commitFn: (value: any) => void, cancelFn: () => void): HTMLElement;\n  getValue?(element: HTMLElement): any;\n  focus?(element: HTMLElement): void;\n}\n\n/**\n * Abstract base class for all grid plugins.\n *\n * @template TConfig - Configuration type for the plugin\n */\nexport abstract class BaseGridPlugin<TConfig = unknown> implements GridPlugin {\n  /** Unique plugin identifier (derived from class name by default) */\n  abstract readonly name: string;\n\n  /** Plugin version - override in subclass if needed */\n  readonly version: string = '1.0.0';\n\n  /** CSS styles to inject into the grid's shadow DOM */\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  private readonly userConfig: Partial<TConfig>;\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   * Called when the plugin is attached to a grid.\n   * Override to set up event listeners, initialize state, etc.\n   */\n  attach(grid: GridElement): void {\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  detach(): void {\n    // Override in subclass\n  }\n\n  /**\n   * Get another plugin instance from the same grid.\n   * Use for inter-plugin communication.\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   * Request a re-render of the grid.\n   */\n  protected requestRender(): void {\n    this.grid?.requestRender?.();\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   * 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 as any)?.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 as any)?.visibleColumns ?? [];\n  }\n\n  /**\n   * Get the shadow root of the grid.\n   */\n  protected get shadowRoot(): ShadowRoot | null {\n    return this.grid?.shadowRoot ?? null;\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 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(): typeof DEFAULT_GRID_ICONS {\n    const userIcons = this.grid?.gridConfig?.icons ?? {};\n    return { ...DEFAULT_GRID_ICONS, ...userIcons };\n  }\n\n  /**\n   * Resolve an icon value to string or HTMLElement.\n   * Checks plugin config first, then grid-level icons, then defaults.\n   *\n   * @param iconKey - The icon key in GridIcons (e.g., 'expand', 'collapse')\n   * @param pluginOverride - Optional plugin-level override\n   * @returns The resolved icon value\n   */\n  protected resolveIcon(iconKey: keyof typeof DEFAULT_GRID_ICONS, pluginOverride?: IconValue): IconValue {\n    // Plugin override takes precedence\n    if (pluginOverride !== undefined) {\n      return pluginOverride;\n    }\n    // Then grid-level config\n    return this.gridIcons[iconKey];\n  }\n\n  /**\n   * Set an icon value on an element.\n   * Handles both string (text/HTML) and HTMLElement values.\n   *\n   * @param element - The element to set the icon on\n   * @param icon - The icon value (string or HTMLElement)\n   */\n  protected setIcon(element: HTMLElement, icon: IconValue): void {\n    if (typeof icon === 'string') {\n      element.innerHTML = icon;\n    } else if (icon instanceof HTMLElement) {\n      element.innerHTML = '';\n      element.appendChild(icon.cloneNode(true));\n    }\n  }\n\n  /**\n   * Log a warning message.\n   */\n  protected warn(message: string): void {\n    console.warn(`[tbw-grid:${this.name}] ${message}`);\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   * 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   * @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.shadowRoot?.querySelectorAll('.data-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 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   * Return extra height contributed by this plugin (e.g., expanded detail rows).\n   * Used to adjust scrollbar height calculations for virtualization.\n   *\n   * @returns Total extra height in pixels\n   *\n   * @example\n   * ```ts\n   * getExtraHeight(): number {\n   *   return this.expandedRows.size * this.detailHeight;\n   * }\n   * ```\n   */\n  getExtraHeight?(): number;\n\n  /**\n   * Return extra height that appears before a given row index.\n   * Used by virtualization to correctly calculate scroll positions when\n   * there's variable height content (like expanded detail rows) above the viewport.\n   *\n   * @param beforeRowIndex - The row index to calculate extra height before\n   * @returns Extra height in pixels that appears before this row\n   *\n   * @example\n   * ```ts\n   * getExtraHeightBefore(beforeRowIndex: number): number {\n   *   let height = 0;\n   *   for (const expandedRowIndex of this.expandedRowIndices) {\n   *     if (expandedRowIndex < beforeRowIndex) {\n   *       height += this.getDetailHeight(expandedRowIndex);\n   *     }\n   *   }\n   *   return height;\n   * }\n   * ```\n   */\n  getExtraHeightBefore?(beforeRowIndex: number): number;\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.\n   * This is the generic mechanism for inter-plugin communication.\n   * Plugins can respond to well-known query types or define their own.\n   *\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   * onPluginQuery(query: PluginQuery): unknown {\n   *   switch (query.type) {\n   *     case PLUGIN_QUERIES.CAN_MOVE_COLUMN:\n   *       // Prevent moving pinned columns\n   *       const column = query.context as ColumnConfig;\n   *       if (column.sticky === 'left' || column.sticky === 'right') {\n   *         return false;\n   *       }\n   *       break;\n   *     case PLUGIN_QUERIES.GET_CONTEXT_MENU_ITEMS:\n   *       const params = query.context as ContextMenuParams;\n   *       return [{ id: 'my-action', label: 'My Action', action: () => {} }];\n   *   }\n   * }\n   * ```\n   */\n  onPluginQuery?(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 now provided via onPluginQuery with PLUGIN_QUERIES.GET_CONTEXT_MENU_ITEMS\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  // #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 * Clipboard Copy Logic\n *\n * Pure functions for copying grid data to clipboard.\n */\n\nimport type { ColumnConfig } from '../../core/types';\nimport type { ClipboardConfig } from './types';\n\n/** Parameters for building clipboard text */\nexport interface CopyParams {\n  /** All grid rows */\n  rows: unknown[];\n  /** Column configurations */\n  columns: ColumnConfig[];\n  /** Selected row indices */\n  selectedIndices: Set<number> | number[];\n  /** Clipboard configuration */\n  config: ClipboardConfig;\n}\n\n/**\n * Format a cell value for clipboard output.\n *\n * Uses custom processCell if provided, otherwise applies default formatting:\n * - null/undefined → empty string\n * - Date → ISO string\n * - Object → JSON string\n * - Other → String conversion with optional quoting\n *\n * @param value - The cell value to format\n * @param field - The field name\n * @param row - The full row object\n * @param config - Clipboard configuration\n * @returns Formatted string value\n */\nexport function formatCellValue(value: unknown, field: string, row: unknown, config: ClipboardConfig): string {\n  if (config.processCell) {\n    return config.processCell(value, field, row);\n  }\n\n  if (value == null) return '';\n  if (value instanceof Date) return value.toISOString();\n  if (typeof value === 'object') return JSON.stringify(value);\n\n  const str = String(value);\n  const delimiter = config.delimiter ?? '\\t';\n  const newline = config.newline ?? '\\n';\n\n  // Quote if contains delimiter, newline, or quotes (or if quoteStrings is enabled)\n  if (config.quoteStrings || str.includes(delimiter) || str.includes(newline) || str.includes('\"')) {\n    return `\"${str.replace(/\"/g, '\"\"')}\"`;\n  }\n\n  return str;\n}\n\n/**\n * Build clipboard text from selected rows and columns.\n *\n * @param params - Copy parameters including rows, columns, selection, and config\n * @returns Tab-separated (or custom delimiter) text ready for clipboard\n */\nexport function buildClipboardText(params: CopyParams): string {\n  const { rows, columns, selectedIndices, config } = params;\n  const delimiter = config.delimiter ?? '\\t';\n  const newline = config.newline ?? '\\n';\n\n  // Filter to visible columns (not hidden, not internal __ prefixed)\n  const visibleColumns = columns.filter((c) => !c.hidden && !c.field.startsWith('__'));\n\n  const lines: string[] = [];\n\n  // Add header row if configured\n  if (config.includeHeaders) {\n    const headerCells = visibleColumns.map((c) => {\n      const header = c.header || c.field;\n      // Quote headers if they contain special characters\n      if (header.includes(delimiter) || header.includes(newline) || header.includes('\"')) {\n        return `\"${header.replace(/\"/g, '\"\"')}\"`;\n      }\n      return header;\n    });\n    lines.push(headerCells.join(delimiter));\n  }\n\n  // Convert indices to sorted array\n  const indices = selectedIndices instanceof Set ? [...selectedIndices] : selectedIndices;\n  const sortedIndices = [...indices].sort((a, b) => a - b);\n\n  // Build data rows\n  for (const idx of sortedIndices) {\n    const row = rows[idx];\n    if (!row) continue;\n\n    const cells = visibleColumns.map((col) =>\n      formatCellValue((row as Record<string, unknown>)[col.field], col.field, row, config)\n    );\n    lines.push(cells.join(delimiter));\n  }\n\n  return lines.join(newline);\n}\n\n/**\n * Copy text to the system clipboard.\n *\n * Uses the modern Clipboard API when available, with fallback\n * to execCommand for older browsers.\n *\n * @param text - The text to copy\n * @returns Promise resolving to true if successful, false otherwise\n */\nexport async function copyToClipboard(text: string): Promise<boolean> {\n  try {\n    await navigator.clipboard.writeText(text);\n    return true;\n  } catch {\n    // Fallback for older browsers or when Clipboard API is not available\n    const textarea = document.createElement('textarea');\n    textarea.value = text;\n    textarea.style.position = 'fixed';\n    textarea.style.opacity = '0';\n    textarea.style.pointerEvents = 'none';\n    document.body.appendChild(textarea);\n    textarea.select();\n    const success = document.execCommand('copy');\n    document.body.removeChild(textarea);\n    return success;\n  }\n}\n","/**\n * Clipboard Paste Logic\n *\n * Pure functions for reading and parsing clipboard data.\n */\n\nimport type { ClipboardConfig } from './types';\n\n/**\n * Parse clipboard text into a 2D array of cell values.\n *\n * Handles:\n * - Quoted values (with escaped double quotes \"\")\n * - Multi-line quoted values (newlines within quotes are preserved)\n * - Custom delimiters and newlines\n * - Empty lines (filtered out only if they contain no data)\n *\n * @param text - Raw clipboard text\n * @param config - Clipboard configuration\n * @returns 2D array where each sub-array is a row of cell values\n */\nexport function parseClipboardText(text: string, config: ClipboardConfig): string[][] {\n  const delimiter = config.delimiter ?? '\\t';\n  const newline = config.newline ?? '\\n';\n\n  // Handle Windows CRLF line endings\n  const normalizedText = text.replace(/\\r\\n/g, '\\n').replace(/\\r/g, '\\n');\n\n  // Parse the entire text handling quoted fields that may span multiple lines\n  const rows: string[][] = [];\n  let currentRow: string[] = [];\n  let currentCell = '';\n  let inQuotes = false;\n\n  for (let i = 0; i < normalizedText.length; i++) {\n    const char = normalizedText[i];\n\n    if (char === '\"' && !inQuotes) {\n      // Start of quoted field\n      inQuotes = true;\n    } else if (char === '\"' && inQuotes) {\n      // Check for escaped quote (\"\")\n      if (normalizedText[i + 1] === '\"') {\n        currentCell += '\"';\n        i++; // Skip the second quote\n      } else {\n        // End of quoted field\n        inQuotes = false;\n      }\n    } else if (char === delimiter && !inQuotes) {\n      // Field separator\n      currentRow.push(currentCell);\n      currentCell = '';\n    } else if (char === newline && !inQuotes) {\n      // Row separator (only if not inside quotes)\n      currentRow.push(currentCell);\n      currentCell = '';\n      // Only add non-empty rows (at least one non-empty cell or multiple cells)\n      if (currentRow.length > 1 || currentRow.some((c) => c.trim() !== '')) {\n        rows.push(currentRow);\n      }\n      currentRow = [];\n    } else {\n      currentCell += char;\n    }\n  }\n\n  // Handle the last cell and row\n  currentRow.push(currentCell);\n  if (currentRow.length > 1 || currentRow.some((c) => c.trim() !== '')) {\n    rows.push(currentRow);\n  }\n\n  return rows;\n}\n\n/**\n * Read text from the system clipboard.\n *\n * Uses the modern Clipboard API. Returns empty string if\n * the API is not available or permission is denied.\n *\n * @returns Promise resolving to clipboard text or empty string\n */\nexport async function readFromClipboard(): Promise<string> {\n  try {\n    return await navigator.clipboard.readText();\n  } catch {\n    // Permission denied or API not available\n    return '';\n  }\n}\n","/**\n * Clipboard Plugin (Class-based)\n *\n * Provides copy/paste functionality for tbw-grid.\n * Supports Ctrl+C/Cmd+C for copying and Ctrl+V/Cmd+V for pasting.\n *\n * **With Selection plugin:** Copy selected rows as a range\n * - includeHeaders: true → adds header row at top\n * - includeHeaders: false → data rows only\n *\n * **Without Selection plugin:** Copy focused cell only\n * - includeHeaders: true → \"Header: value\" format\n * - includeHeaders: false → value only\n */\n\nimport { BaseGridPlugin } from '../../core/plugin/base-plugin';\nimport { buildClipboardText, copyToClipboard } from './copy';\nimport { parseClipboardText, readFromClipboard } from './paste';\nimport type { ClipboardConfig, CopyDetail, PasteDetail } from './types';\n\n/**\n * Clipboard Plugin for tbw-grid\n *\n * @example\n * ```ts\n * new ClipboardPlugin({ includeHeaders: true })\n * ```\n */\nexport class ClipboardPlugin extends BaseGridPlugin<ClipboardConfig> {\n  readonly name = 'clipboard';\n  override readonly version = '1.0.0';\n\n  protected override get defaultConfig(): Partial<ClipboardConfig> {\n    return {\n      includeHeaders: false,\n      delimiter: '\\t',\n      newline: '\\n',\n      quoteStrings: false,\n    };\n  }\n\n  // #region Internal State\n  /** The last copied text (for reference/debugging) */\n  private lastCopied: { text: string; timestamp: number } | null = null;\n  // #endregion\n\n  // #region Lifecycle\n\n  override detach(): void {\n    this.lastCopied = null;\n  }\n  // #endregion\n\n  // #region Event Handlers\n\n  override onKeyDown(event: KeyboardEvent): boolean {\n    const isCopy = (event.ctrlKey || event.metaKey) && event.key === 'c';\n    const isPaste = (event.ctrlKey || event.metaKey) && event.key === 'v';\n\n    if (isCopy) {\n      this.#handleCopy(event.target as HTMLElement);\n      return true; // Prevent default browser behavior\n    }\n\n    if (isPaste) {\n      this.#handlePaste();\n      return true; // Prevent default browser behavior\n    }\n\n    return false;\n  }\n  // #endregion\n\n  // #region Private Methods\n\n  /**\n   * Handle copy operation\n   */\n  #handleCopy(target: HTMLElement): void {\n    // Try to get selection from selection plugin (if available)\n    // Use dynamic import to avoid circular dependency issues\n    const selectionPlugin = this.#getSelectionPlugin();\n\n    // Check for different selection types\n    const selectedRows = selectionPlugin?.getSelectedRows() ?? [];\n    const hasRowSelection = selectedRows.length > 0;\n    const ranges = selectionPlugin?.getRanges() ?? [];\n    const hasRangeSelection = ranges.length > 0;\n    const hasCellSelection = selectionPlugin?.getSelectedCell() != null;\n\n    let text: string;\n    let rowCount: number;\n    let columnCount: number;\n\n    if (hasRowSelection && selectionPlugin) {\n      // Row selection mode - copy full rows\n      text = buildClipboardText({\n        rows: this.rows as unknown[],\n        columns: [...this.columns],\n        selectedIndices: selectedRows,\n        config: this.config,\n      });\n      rowCount = selectedRows.length;\n      columnCount = this.columns.filter((c) => !c.hidden && !c.field.startsWith('__')).length;\n    } else if (hasRangeSelection && selectionPlugin) {\n      // Range selection mode - copy rectangular range (use last range as active)\n      const range = ranges[ranges.length - 1];\n      const result = this.#buildRangeText({\n        startRow: range.from.row,\n        startCol: range.from.col,\n        endRow: range.to.row,\n        endCol: range.to.col,\n      });\n      text = result.text;\n      rowCount = result.rowCount;\n      columnCount = result.columnCount;\n    } else if (hasCellSelection && selectionPlugin) {\n      // Cell selection mode - copy single cell\n      const cell = selectionPlugin.getSelectedCell()!;\n      const result = this.#buildCellText(cell.row, cell.col);\n      if (!result) return;\n      text = result.text;\n      rowCount = 1;\n      columnCount = 1;\n    } else {\n      // Fallback: try to find focused cell from DOM\n      const result = this.#buildSingleCellText(target);\n      if (!result) return;\n      text = result.text;\n      rowCount = 1;\n      columnCount = 1;\n    }\n\n    copyToClipboard(text).then(() => {\n      this.lastCopied = { text, timestamp: Date.now() };\n      this.emit<CopyDetail>('copy', { text, rowCount, columnCount });\n    });\n  }\n\n  /**\n   * Handle paste operation\n   */\n  #handlePaste(): void {\n    readFromClipboard().then((text) => {\n      if (!text) return;\n      const parsed = parseClipboardText(text, this.config);\n      this.emit<PasteDetail>('paste', { rows: parsed, text });\n    });\n  }\n\n  /**\n   * Get the selection plugin instance if available.\n   */\n  #getSelectionPlugin(): SelectionPluginInterface | undefined {\n    // Dynamically get the SelectionPlugin class to avoid import order issues\n    try {\n      // Use getPlugin with the class - this requires the class to be imported\n      // For now, we'll use a duck-typing approach via the grid's plugin registry\n      const grid = this.grid as any;\n      if (grid?._plugins) {\n        for (const plugin of grid._plugins) {\n          if (plugin.name === 'selection') {\n            return plugin as SelectionPluginInterface;\n          }\n        }\n      }\n    } catch {\n      // Selection plugin not available\n    }\n    return undefined;\n  }\n\n  /**\n   * Build text for a single cell by row/col index.\n   */\n  #buildCellText(rowIndex: number, colIndex: number): { text: string } | null {\n    const rowData = this.rows[rowIndex] as Record<string, unknown> | undefined;\n    if (!rowData) return null;\n\n    const column = this.columns[colIndex];\n    if (!column) return null;\n\n    const value = rowData[column.field];\n    const header = column.header || column.field;\n\n    let text: string;\n    if (this.config.includeHeaders) {\n      const formattedValue = value == null ? '' : String(value);\n      text = `${header}: ${formattedValue}`;\n    } else {\n      text = value == null ? '' : String(value);\n    }\n\n    return { text };\n  }\n\n  /**\n   * Build text for a rectangular range of cells.\n   */\n  #buildRangeText(range: { startRow: number; startCol: number; endRow: number; endCol: number }): {\n    text: string;\n    rowCount: number;\n    columnCount: number;\n  } {\n    const { startRow, startCol, endRow, endCol } = range;\n    const minRow = Math.min(startRow, endRow);\n    const maxRow = Math.max(startRow, endRow);\n    const minCol = Math.min(startCol, endCol);\n    const maxCol = Math.max(startCol, endCol);\n\n    const delimiter = this.config.delimiter ?? '\\t';\n    const newline = this.config.newline ?? '\\n';\n    const lines: string[] = [];\n\n    // Get columns in the range\n    const rangeColumns = this.columns.slice(minCol, maxCol + 1);\n\n    // Add header row if configured\n    if (this.config.includeHeaders) {\n      const headerCells = rangeColumns.map((c) => c.header || c.field);\n      lines.push(headerCells.join(delimiter));\n    }\n\n    // Add data rows\n    for (let r = minRow; r <= maxRow; r++) {\n      const rowData = this.rows[r] as Record<string, unknown> | undefined;\n      if (!rowData) continue;\n\n      const cells = rangeColumns.map((col) => {\n        const value = rowData[col.field];\n        if (value == null) return '';\n        if (value instanceof Date) return value.toISOString();\n        return String(value);\n      });\n      lines.push(cells.join(delimiter));\n    }\n\n    return {\n      text: lines.join(newline),\n      rowCount: maxRow - minRow + 1,\n      columnCount: maxCol - minCol + 1,\n    };\n  }\n\n  /**\n   * Build text for a single focused cell from DOM.\n   * Used when selection plugin is not available or no rows are selected.\n   */\n  #buildSingleCellText(target: HTMLElement): { text: string; field: string; value: unknown } | null {\n    // Find the cell element - cells use data-field-cache for the field name\n    const cell = target.closest('[data-field-cache]') as HTMLElement | null;\n    if (!cell) return null;\n\n    const field = cell.dataset.fieldCache;\n    if (!field) return null;\n\n    // Get row index from data-row attribute on the cell\n    const rowIndexStr = cell.dataset.row;\n    if (!rowIndexStr) return null;\n\n    const rowIndex = parseInt(rowIndexStr, 10);\n    if (isNaN(rowIndex)) return null;\n\n    const rowData = this.rows[rowIndex] as Record<string, unknown> | undefined;\n    if (!rowData) return null;\n\n    const value = rowData[field];\n    const column = this.columns.find((c) => c.field === field);\n    const header = column?.header || field;\n\n    // Format the text based on includeHeaders config\n    let text: string;\n    if (this.config.includeHeaders) {\n      // Format: \"{header}: {value}\"\n      const formattedValue = value == null ? '' : String(value);\n      text = `${header}: ${formattedValue}`;\n    } else {\n      // Just the value\n      text = value == null ? '' : String(value);\n    }\n\n    return { text, field, value };\n  }\n  // #endregion\n\n  // #region Public API\n\n  /**\n   * Copy currently selected rows to clipboard.\n   * @returns The copied text\n   */\n  async copy(): Promise<string> {\n    const selectionPlugin = this.#getSelectionPlugin();\n    const indices = selectionPlugin?.getSelectedRows() ?? [];\n\n    const text = buildClipboardText({\n      rows: this.rows as unknown[],\n      columns: [...this.columns],\n      selectedIndices: indices,\n      config: this.config,\n    });\n\n    await copyToClipboard(text);\n    this.lastCopied = { text, timestamp: Date.now() };\n    return text;\n  }\n\n  /**\n   * Copy specific rows by index to clipboard.\n   * @param indices - Array of row indices to copy\n   * @returns The copied text\n   */\n  async copyRows(indices: number[]): Promise<string> {\n    const text = buildClipboardText({\n      rows: this.rows as unknown[],\n      columns: [...this.columns],\n      selectedIndices: indices,\n      config: this.config,\n    });\n\n    await copyToClipboard(text);\n    this.lastCopied = { text, timestamp: Date.now() };\n    return text;\n  }\n\n  /**\n   * Read and parse clipboard content.\n   * @returns Parsed 2D array of cell values, or null if clipboard is empty\n   */\n  async paste(): Promise<string[][] | null> {\n    const text = await readFromClipboard();\n    if (!text) return null;\n    return parseClipboardText(text, this.config);\n  }\n\n  /**\n   * Get the last copied text and timestamp.\n   * @returns The last copied info or null\n   */\n  getLastCopied(): { text: string; timestamp: number } | null {\n    return this.lastCopied;\n  }\n  // #endregion\n}\n\n// #region Internal Types\n\n/**\n * Interface for SelectionPlugin methods we need.\n * This avoids circular imports while providing type safety.\n */\ninterface SelectionPluginInterface {\n  name: string;\n  /** Get selected row indices (row mode) */\n  getSelectedRows(): number[];\n  /** Get all selected cell ranges (range mode) */\n  getRanges(): Array<{ from: { row: number; col: number }; to: { row: number; col: number } }>;\n  /** Get selected cell (cell mode) */\n  getSelectedCell(): { row: number; col: number } | null;\n}\n// #endregion\n\n// Re-export types\nexport type { ClipboardConfig, CopyDetail, PasteDetail } from './types';\n"],"names":["DEFAULT_GRID_ICONS","BaseGridPlugin","config","grid","PluginClass","eventName","detail","userIcons","iconKey","pluginOverride","element","icon","message","formatCellValue","value","field","row","str","delimiter","newline","buildClipboardText","params","rows","columns","selectedIndices","visibleColumns","c","lines","headerCells","header","sortedIndices","a","b","idx","cells","col","copyToClipboard","text","textarea","success","parseClipboardText","normalizedText","currentRow","currentCell","inQuotes","i","char","readFromClipboard","ClipboardPlugin","event","isCopy","isPaste","#handleCopy","#handlePaste","target","selectionPlugin","#getSelectionPlugin","selectedRows","hasRowSelection","ranges","hasRangeSelection","hasCellSelection","rowCount","columnCount","range","result","#buildRangeText","cell","#buildCellText","#buildSingleCellText","parsed","plugin","rowIndex","colIndex","rowData","column","formattedValue","startRow","startCol","endRow","endCol","minRow","maxRow","minCol","maxCol","rangeColumns","r","rowIndexStr","indices"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../../../../libs/grid/src/lib/core/types.ts","../../../../../../libs/grid/src/lib/core/plugin/base-plugin.ts","../../../../../../libs/grid/src/lib/plugins/clipboard/copy.ts","../../../../../../libs/grid/src/lib/plugins/clipboard/paste.ts","../../../../../../libs/grid/src/lib/plugins/clipboard/ClipboardPlugin.ts"],"sourcesContent":["import type { PluginQuery } from './plugin/base-plugin';\n\n/**\n * The compiled webcomponent interface for DataGrid\n */\nexport interface DataGridElement extends PublicGrid, HTMLElement {}\n\n/**\n * Public API interface for DataGrid component.\n *\n * **Property Getters vs Setters:**\n *\n * Property getters return the EFFECTIVE (resolved) value after merging all config sources.\n * This is the \"current situation\" - what consumers and plugins need to know.\n *\n * Property setters accept input values which are merged into the effective config.\n * Multiple sources can contribute (gridConfig, columns prop, light DOM, individual props).\n *\n * For example:\n * - `grid.fitMode` returns the resolved fitMode (e.g., 'stretch' even if you set undefined)\n * - `grid.columns` returns the effective columns after merging\n * - `grid.gridConfig` returns the full effective config\n */\nexport interface PublicGrid<T = any> {\n  /**\n   * Full config object. Setter merges with other inputs per precedence rules.\n   * Getter returns the effective (resolved) config.\n   */\n  gridConfig?: GridConfig<T>;\n  /**\n   * Column definitions.\n   * Getter returns effective columns (after merging config, light DOM, inference).\n   */\n  columns?: ColumnConfig<T>[];\n  /** Current row data (after plugin processing like grouping, filtering). */\n  rows?: T[];\n  /** Resolves once the component has finished initial work (layout, inference). */\n  ready?: () => Promise<void>;\n  /** Force a layout / measurement pass (e.g. after container resize). */\n  forceLayout?: () => Promise<void>;\n  /** Return effective resolved config (after inference & precedence). */\n  getConfig?: () => Promise<Readonly<GridConfig<T>>>;\n  /** Toggle expansion state of a group row by its generated key. */\n  toggleGroup?: (key: string) => Promise<void>;\n}\n\n/**\n * Internal-only augmented interface for DataGrid component\n */\nexport interface InternalGrid<T = any> extends PublicGrid<T>, GridConfig<T> {\n  shadowRoot: ShadowRoot | null;\n  _rows: T[];\n  _columns: ColumnInternal<T>[];\n  /** Visible columns only (excludes hidden). Use for rendering. */\n  _visibleColumns: ColumnInternal<T>[];\n  _headerRowEl: HTMLElement;\n  _bodyEl: HTMLElement;\n  _rowPool: HTMLElement[];\n  _resizeController: ResizeController;\n  _sortState: { field: string; direction: 1 | -1 } | null;\n  __originalOrder: T[];\n  __rowRenderEpoch: number;\n  __didInitialAutoSize?: boolean;\n  __lightDomColumnsCache?: ColumnInternal[];\n  __originalColumnNodes?: HTMLElement[];\n  _gridTemplate: string;\n  _virtualization: VirtualState;\n  _focusRow: number;\n  _focusCol: number;\n  _activeEditRows: number;\n  _rowEditSnapshots: Map<number, T>;\n  _changedRowIndices: Set<number>;\n  changedRows?: T[];\n  changedRowIndices?: number[];\n  effectiveConfig?: GridConfig<T>;\n  findHeaderRow?: () => HTMLElement;\n  refreshVirtualWindow: (full: boolean) => void;\n  updateTemplate?: () => void;\n  findRenderedRowElement?: (rowIndex: number) => HTMLElement | null;\n  beginBulkEdit?: (rowIndex: number) => void;\n  commitActiveRowEdit?: () => void;\n  /** Dispatch cell click to plugin system, returns true if handled */\n  _dispatchCellClick?: (event: MouseEvent, rowIndex: number, colIndex: number, cellEl: HTMLElement) => boolean;\n  /** Dispatch row click to plugin system, returns true if handled */\n  _dispatchRowClick?: (event: MouseEvent, rowIndex: number, row: any, rowEl: HTMLElement) => boolean;\n  /** Dispatch header click to plugin system, returns true if handled */\n  _dispatchHeaderClick?: (event: MouseEvent, colIndex: number, headerEl: HTMLElement) => boolean;\n  /** Dispatch keydown to plugin system, returns true if handled */\n  _dispatchKeyDown?: (event: KeyboardEvent) => boolean;\n  /** Get horizontal scroll boundary offsets from plugins (e.g., pinned columns) */\n  _getHorizontalScrollOffsets?: (\n    rowEl?: HTMLElement,\n    focusedCell?: HTMLElement,\n  ) => { left: number; right: number; skipScroll?: boolean };\n  /** Query all plugins with a generic query and collect responses */\n  queryPlugins?: <T>(query: PluginQuery) => T[];\n  /** Request emission of column-state-change event (debounced) */\n  requestStateChange?: () => void;\n}\n\nexport type PrimitiveColumnType = 'number' | 'string' | 'date' | 'boolean' | 'select' | 'typeahead';\n\n/**\n * Base contract for a column. Public; kept intentionally lean so host apps can extend via intersection types.\n * Prefer adding optional properties here only when broadly useful to most grids.\n */\nexport interface BaseColumnConfig<TRow = any, TValue = any> {\n  /** Unique field key referencing property in row objects */\n  field: keyof TRow & string;\n  /** Visible header label; defaults to capitalized field */\n  header?: string;\n  /** Column data type; inferred if omitted */\n  type?: PrimitiveColumnType;\n  /** Column width in pixels; fixed size (no flexibility) */\n  width?: string | number;\n  /** Minimum column width in pixels (stretch mode only); when set, column uses minmax(minWidth, 1fr) */\n  minWidth?: number;\n  /** Whether column can be sorted */\n  sortable?: boolean;\n  /** Whether column can be resized by user */\n  resizable?: boolean;\n  /** Optional custom comparator for sorting (a,b) -> number */\n  sortComparator?: (a: TValue, b: TValue, rowA: TRow, rowB: TRow) => number;\n  /** Whether the field is editable (enables editors) */\n  editable?: boolean;\n  /** Optional custom editor factory or element tag name */\n  editor?: ColumnEditorSpec<TRow, TValue>;\n  /** For select/typeahead types - available options */\n  options?: Array<{ label: string; value: unknown }> | (() => Array<{ label: string; value: unknown }>);\n  /** For select/typeahead - allow multi select */\n  multi?: boolean;\n  /** Optional formatter */\n  format?: (value: TValue, row: TRow) => string;\n  /** Arbitrary extra metadata */\n  meta?: Record<string, unknown>;\n}\n\n/**\n * Full column configuration including optional custom view/renderer & grouping metadata.\n */\nexport interface ColumnConfig<TRow = any> extends BaseColumnConfig<TRow, any> {\n  /** Optional custom view renderer used instead of default text rendering */\n  viewRenderer?: ColumnViewRenderer<TRow, any>;\n  /** External view spec (lets host app mount any framework component) */\n  externalView?: {\n    component: unknown;\n    props?: Record<string, unknown>;\n    mount?: (options: {\n      placeholder: HTMLElement;\n      context: CellRenderContext<TRow, unknown>;\n      spec: unknown;\n    }) => void | { dispose?: () => void };\n  };\n  /** Whether the column is initially hidden */\n  hidden?: boolean;\n  /** Prevent this column from being hidden by the visibility plugin */\n  lockVisible?: boolean;\n}\n\nexport type ColumnConfigMap<TRow = any> = ColumnConfig<TRow>[];\n\n/** External editor spec: tag name, factory function, or external mount spec */\nexport type ColumnEditorSpec<TRow = unknown, TValue = unknown> =\n  | string // custom element tag name\n  | ((context: ColumnEditorContext<TRow, TValue>) => HTMLElement | string)\n  | {\n      /** Arbitrary component reference (class, function, token) */\n      component: unknown;\n      /** Optional static props passed to mount */\n      props?: Record<string, unknown>;\n      /** Optional custom mount function; if provided we call it directly instead of emitting an event */\n      mount?: (options: {\n        placeholder: HTMLElement;\n        context: ColumnEditorContext<TRow, TValue>;\n        spec: unknown;\n      }) => void | { dispose?: () => void };\n    };\n\n/**\n * Context object provided to editor factories allowing mutation (commit/cancel) of a cell value.\n */\nexport interface ColumnEditorContext<TRow = any, TValue = any> {\n  /** Underlying full row object for the active edit. */\n  row: TRow;\n  /** Current cell value (mutable only via commit). */\n  value: TValue;\n  /** Field name being edited. */\n  field: keyof TRow & string;\n  /** Column configuration reference. */\n  column: ColumnConfig<TRow>;\n  /** Accept the edit; triggers change tracking + rerender. */\n  commit: (newValue: TValue) => void;\n  /** Abort edit without persisting changes. */\n  cancel: () => void;\n}\n\n/**\n * Context passed to custom view renderers (pure display – no commit helpers).\n */\nexport interface CellRenderContext<TRow = any, TValue = any> {\n  /** Row object for the cell being rendered. */\n  row: TRow;\n  /** Value at field. */\n  value: TValue;\n  /** Field key. */\n  field: keyof TRow & string;\n  /** Column configuration reference. */\n  column: ColumnConfig<TRow>;\n}\n\nexport type ColumnViewRenderer<TRow = unknown, TValue = unknown> = (\n  ctx: CellRenderContext<TRow, TValue>,\n) => Node | string | void;\n\n// #region Internal-only augmented types (not re-exported publicly)\nexport interface ColumnInternal<T = any> extends ColumnConfig<T> {\n  __autoSized?: boolean;\n  __userResized?: boolean;\n  __renderedWidth?: number;\n  /** Original configured width (for reset on double-click) */\n  __originalWidth?: number;\n  __viewTemplate?: HTMLElement;\n  __editorTemplate?: HTMLElement;\n  __headerTemplate?: HTMLElement;\n  __compiledView?: (ctx: CellContext<T>) => string;\n  __compiledEditor?: (ctx: EditorExecContext<T>) => string;\n}\n\n/**\n * Runtime cell context used internally for compiled template execution.\n */\nexport interface CellContext<T = any> {\n  row: T;\n  value: unknown;\n  field: string;\n  column: ColumnInternal<T>;\n}\n\n/**\n * Internal editor execution context extending the generic cell context with commit helpers.\n */\nexport interface EditorExecContext<T = any> extends CellContext<T> {\n  commit: (newValue: unknown) => void;\n  cancel: () => void;\n}\n\n/** Controller managing drag-based column resize lifecycle. */\nexport interface ResizeController {\n  start: (e: MouseEvent, colIndex: number, cell: HTMLElement) => void;\n  /** Reset a column to its configured width (or auto-size if none configured). */\n  resetColumn: (colIndex: number) => void;\n  dispose: () => void;\n  /** True while a resize drag is in progress (used to suppress header click/sort). */\n  isResizing: boolean;\n}\n\n/** Virtual window bookkeeping; modified in-place as scroll position changes. */\nexport interface VirtualState {\n  enabled: boolean;\n  rowHeight: number;\n  /** Threshold for bypassing virtualization (renders all rows if totalRows <= bypassThreshold) */\n  bypassThreshold: number;\n  start: number;\n  end: number;\n  /** Faux scrollbar element that provides scroll events (AG Grid pattern) */\n  container: HTMLElement | null;\n  /** Rows viewport element for measuring visible area height */\n  viewportEl: HTMLElement | null;\n  /** Spacer element inside faux scrollbar for setting virtual height */\n  totalHeightEl: HTMLElement | null;\n}\n// #endregion\n\n// #region Grouping & Footer Public Types\n/**\n * Group row rendering customization options.\n * Used within grouping-rows plugin config for presentation of group rows.\n */\nexport interface RowGroupRenderConfig {\n  /** If true, group rows span all columns (single full-width cell). Default false. */\n  fullWidth?: boolean;\n  /** Optional label formatter override. Receives raw group value + depth. */\n  formatLabel?: (value: unknown, depth: number, key: string) => string;\n  /** Optional aggregate overrides per field for group summary cells (only when not fullWidth). */\n  aggregators?: Record<string, AggregatorRef>;\n  /** Additional CSS class applied to each group row root element. */\n  class?: string;\n}\n\nexport type AggregatorRef = string | ((rows: unknown[], field: string, column?: unknown) => unknown);\n\n/** Result of automatic column inference from sample rows. */\nexport interface InferredColumnResult<TRow = unknown> {\n  columns: ColumnConfigMap<TRow>;\n  typeMap: Record<string, PrimitiveColumnType>;\n}\n\nexport const FitModeEnum = {\n  STRETCH: 'stretch',\n  FIXED: 'fixed',\n} as const;\nexport type FitMode = (typeof FitModeEnum)[keyof typeof FitModeEnum]; // evaluates to 'stretch' | 'fixed'\n// #endregion\n\n// #region Plugin Interface\n/**\n * Minimal plugin interface for type-checking.\n * This interface is defined here to avoid circular imports with BaseGridPlugin.\n * All plugins must satisfy this shape (BaseGridPlugin implements it).\n */\nexport interface GridPlugin {\n  /** Unique plugin identifier */\n  readonly name: string;\n  /** Plugin version */\n  readonly version: string;\n  /** CSS styles to inject into grid's shadow DOM */\n  readonly styles?: string;\n}\n// #endregion\n\n// #region Grid Config\n/**\n * Grid configuration object - the **single source of truth** for grid behavior.\n *\n * Users can configure the grid via multiple input methods, all of which converge\n * into an effective `GridConfig` internally:\n *\n * **Configuration Input Methods:**\n * - `gridConfig` property - direct assignment of this object\n * - `columns` property - shorthand for `gridConfig.columns`\n * - `fitMode` property - shorthand for `gridConfig.fitMode`\n * - `editOn` property - shorthand for `gridConfig.editOn`\n * - Light DOM `<tbw-grid-column>` - declarative columns (merged into `columns`)\n * - Light DOM `<tbw-grid-header>` - declarative shell header (merged into `shell.header`)\n *\n * **Precedence (when same property set multiple ways):**\n * Individual props (`fitMode`, `editOn`) > `columns` prop > Light DOM > `gridConfig`\n *\n * @example\n * ```ts\n * // Via gridConfig (recommended for complex setups)\n * grid.gridConfig = {\n *   columns: [{ field: 'name' }, { field: 'age' }],\n *   fitMode: 'stretch',\n *   plugins: [new SelectionPlugin()],\n *   shell: { header: { title: 'My Grid' } }\n * };\n *\n * // Via individual props (convenience for simple cases)\n * grid.columns = [{ field: 'name' }, { field: 'age' }];\n * grid.fitMode = 'stretch';\n * ```\n */\nexport interface GridConfig<TRow = any> {\n  /** Column definitions. Can also be set via `columns` prop or `<tbw-grid-column>` light DOM. */\n  columns?: ColumnConfigMap<TRow>;\n  /** Sizing mode for columns. Can also be set via `fitMode` prop. */\n  fitMode?: FitMode;\n  /** Edit activation mode ('click' | 'dblclick'). Can also be set via `editOn` prop. */\n  editOn?: string;\n  /**\n   * Row height in pixels for virtualization calculations.\n   * The virtualization system assumes uniform row heights for performance.\n   *\n   * If not specified, the grid measures the first rendered row's height,\n   * which respects the CSS variable `--tbw-row-height` set by themes.\n   *\n   * Set this explicitly when:\n   * - Row content may wrap to multiple lines (also set `--tbw-cell-white-space: normal`)\n   * - Using custom row templates with variable content\n   * - You want to override theme-defined row height\n   *\n   * @default Auto-measured from first row (respects --tbw-row-height CSS variable)\n   *\n   * @example\n   * ```ts\n   * // Fixed height for rows that may wrap to 2 lines\n   * gridConfig = { rowHeight: 56 };\n   * ```\n   */\n  rowHeight?: number;\n  /**\n   * Array of plugin instances.\n   * Each plugin is instantiated with its configuration and attached to this grid.\n   *\n   * @example\n   * ```ts\n   * plugins: [\n   *   new SelectionPlugin({ mode: 'range' }),\n   *   new MultiSortPlugin(),\n   *   new FilteringPlugin({ debounceMs: 150 }),\n   * ]\n   * ```\n   */\n  plugins?: GridPlugin[];\n\n  /**\n   * Saved column state to restore on initialization.\n   * Includes order, width, visibility, sort, and plugin-contributed state.\n   */\n  columnState?: GridColumnState;\n\n  /**\n   * Shell configuration for header bar and tool panels.\n   * When configured, adds an optional wrapper with title, toolbar, and collapsible side panels.\n   */\n  shell?: ShellConfig;\n\n  /**\n   * Grid-wide icon configuration.\n   * Provides consistent icons across all plugins (tree, grouping, sorting, etc.).\n   * Plugins will use these by default but can override with their own config.\n   */\n  icons?: GridIcons;\n}\n// #endregion\n\n// #region Grid Icons\n\n/** Icon value - can be a string (text/HTML) or HTMLElement */\nexport type IconValue = string | HTMLElement;\n\n/**\n * Grid-wide icon configuration.\n * All icons are optional - sensible defaults are used when not specified.\n */\nexport interface GridIcons {\n  /** Expand icon for collapsed items (trees, groups, details). Default: '▶' */\n  expand?: IconValue;\n  /** Collapse icon for expanded items (trees, groups, details). Default: '▼' */\n  collapse?: IconValue;\n  /** Sort ascending indicator. Default: '▲' */\n  sortAsc?: IconValue;\n  /** Sort descending indicator. Default: '▼' */\n  sortDesc?: IconValue;\n  /** Sort neutral/unsorted indicator. Default: '⇅' */\n  sortNone?: IconValue;\n  /** Submenu arrow for context menus. Default: '▶' */\n  submenuArrow?: IconValue;\n  /** Drag handle icon for reordering. Default: '⋮⋮' */\n  dragHandle?: IconValue;\n  /** Tool panel toggle icon in toolbar. Default: '☰' */\n  toolPanel?: IconValue;\n}\n\n/** Default icons used when not overridden */\nexport const DEFAULT_GRID_ICONS: Required<GridIcons> = {\n  expand: '▶',\n  collapse: '▼',\n  sortAsc: '▲',\n  sortDesc: '▼',\n  sortNone: '⇅',\n  submenuArrow: '▶',\n  dragHandle: '⋮⋮',\n  toolPanel: '☰',\n};\n// #endregion\n\n// #region Shell Configuration\n\n/**\n * Shell configuration for the grid's optional header bar and tool panels.\n */\nexport interface ShellConfig {\n  /** Shell header bar configuration */\n  header?: ShellHeaderConfig;\n  /** Tool panel configuration */\n  toolPanel?: ToolPanelConfig;\n}\n\n/**\n * Shell header bar configuration\n */\nexport interface ShellHeaderConfig {\n  /** Grid title displayed on the left (optional) */\n  title?: string;\n  /** Custom toolbar buttons (rendered before tool panel toggles) */\n  toolbarButtons?: ToolbarButtonConfig[];\n}\n\n/**\n * Tool panel configuration\n */\nexport interface ToolPanelConfig {\n  /** Panel position: 'left' | 'right' (default: 'right') */\n  position?: 'left' | 'right';\n  /** Default panel width in pixels (default: 280) */\n  width?: number;\n  /** Panel ID to open by default on load */\n  defaultOpen?: string;\n  /** Whether to persist open/closed state (requires Column State Events) */\n  persistState?: boolean;\n}\n\n/**\n * Toolbar button defined via config (programmatic approach).\n * Supports three modes:\n * - Simple: provide `icon` + `action` for grid to create button\n * - Element: provide `element` for user-created DOM\n * - Render: provide `render` function for complex widgets\n */\nexport interface ToolbarButtonConfig {\n  /** Unique button ID */\n  id: string;\n  /** Tooltip / aria-label (required for accessibility) */\n  label: string;\n  /** Order priority (lower = first, default: 100) */\n  order?: number;\n  /** Whether button is disabled (only applies to grid-rendered buttons) */\n  disabled?: boolean;\n\n  // ===== Option A: Simple - Grid renders the button =====\n  /** Button content: SVG string, emoji, or text. Grid creates <button> with this. */\n  icon?: string;\n  /** Click handler (required when using icon) */\n  action?: () => void;\n\n  // ===== Option B: Custom DOM - User provides element or render function =====\n  /**\n   * User-provided element. Grid wraps it but doesn't modify it.\n   * User is responsible for event handlers.\n   */\n  element?: HTMLElement;\n  /**\n   * Render function called once. Receives container, user appends their DOM.\n   * User is responsible for event handlers.\n   * Return a cleanup function (optional).\n   */\n  render?: (container: HTMLElement) => void | (() => void);\n}\n\n/**\n * Toolbar button info returned by getToolbarButtons().\n */\nexport interface ToolbarButtonInfo {\n  id: string;\n  label: string;\n  disabled: boolean;\n  /** Source of this button: 'config' | 'light-dom' | 'panel-toggle' */\n  source: 'config' | 'light-dom' | 'panel-toggle';\n  /** For panel toggles, the associated panel ID */\n  panelId?: string;\n}\n\n/**\n * Tool panel definition registered by plugins or consumers.\n */\nexport interface ToolPanelDefinition {\n  /** Unique panel ID */\n  id: string;\n  /** Panel title shown in accordion header */\n  title: string;\n  /** Icon for accordion section header (optional, emoji or SVG) */\n  icon?: string;\n  /** Tooltip for accordion section header */\n  tooltip?: string;\n  /** Panel content factory - called when panel section opens */\n  render: (container: HTMLElement) => void | (() => void);\n  /** Called when panel closes (for cleanup) */\n  onClose?: () => void;\n  /** Panel order priority (lower = first, default: 100) */\n  order?: number;\n}\n\n/**\n * Header content definition for plugins contributing to shell header center section.\n */\nexport interface HeaderContentDefinition {\n  /** Unique content ID */\n  id: string;\n  /** Content factory - called once when shell header renders */\n  render: (container: HTMLElement) => void | (() => void);\n  /** Called when content is removed (for cleanup) */\n  onDestroy?: () => void;\n  /** Order priority (lower = first, default: 100) */\n  order?: number;\n}\n// #endregion\n\n// #region Column State (Persistence)\n\n/**\n * State for a single column. Captures user-driven changes at runtime.\n * Plugins can extend this interface via module augmentation to add their own state.\n *\n * @example\n * ```ts\n * // In filtering plugin\n * declare module '@toolbox-web/grid' {\n *   interface ColumnState {\n *     filter?: FilterValue;\n *   }\n * }\n * ```\n */\nexport interface ColumnState {\n  /** Column field identifier */\n  field: string;\n  /** Position index after reordering (0-based) */\n  order: number;\n  /** Width in pixels (undefined = use default) */\n  width?: number;\n  /** Visibility state */\n  visible: boolean;\n  /** Sort state (undefined = not sorted) */\n  sort?: ColumnSortState;\n}\n\n/**\n * Sort state for a column\n */\nexport interface ColumnSortState {\n  /** Sort direction */\n  direction: 'asc' | 'desc';\n  /** Priority for multi-sort (0 = primary, 1 = secondary, etc.) */\n  priority: number;\n}\n\n/**\n * Complete grid column state for persistence.\n * Contains state for all columns, including plugin-contributed properties.\n */\nexport interface GridColumnState {\n  columns: ColumnState[];\n}\n// #endregion\n\n// #region Public Event Detail Interfaces\nexport interface CellCommitDetail<TRow = unknown> {\n  /** The mutated row after commit. */\n  row: TRow;\n  /** Field name whose value changed. */\n  field: string;\n  /** New value stored. */\n  value: unknown;\n  /** Index of the row in current data set. */\n  rowIndex: number;\n  /** All rows that have at least one committed change (snapshot list). */\n  changedRows: TRow[];\n  /** Indices parallel to changedRows. */\n  changedRowIndices: number[];\n  /** True if this row just entered the changed set. */\n  firstTimeForRow: boolean;\n}\n\n/** Detail payload for a committed row edit (may or may not include changes). */\nexport interface RowCommitDetail<TRow = unknown> {\n  /** Row index that lost edit focus. */\n  rowIndex: number;\n  /** Row object reference. */\n  row: TRow;\n  /** Whether any cell changes were actually committed in this row during the session. */\n  changed: boolean;\n  /** Current changed row collection. */\n  changedRows: TRow[];\n  /** Indices of changed rows. */\n  changedRowIndices: number[];\n}\n\n/** Emitted when the changed rows tracking set is cleared programmatically. */\nexport interface ChangedRowsResetDetail<TRow = unknown> {\n  /** New (empty) changed rows array after reset. */\n  rows: TRow[];\n  /** Parallel indices (likely empty). */\n  indices: number[];\n}\n\n/** Detail for a sort change (direction 0 indicates cleared sort). */\nexport interface SortChangeDetail {\n  /** Sorted field key. */\n  field: string;\n  /** Direction: 1 ascending, -1 descending, 0 cleared. */\n  direction: 1 | -1 | 0;\n}\n\n/** Column resize event detail containing final pixel width. */\nexport interface ColumnResizeDetail {\n  /** Resized column field key. */\n  field: string;\n  /** New width in pixels. */\n  width: number;\n}\n\n/** Fired when keyboard navigation or programmatic focus changes active cell. */\nexport interface ActivateCellDetail {\n  /** Zero-based row index now focused. */\n  row: number;\n  /** Zero-based column index now focused. */\n  col: number;\n}\n\nexport interface ExternalMountViewDetail<TRow = unknown> {\n  placeholder: HTMLElement;\n  spec: unknown;\n  context: { row: TRow; value: unknown; field: string; column: unknown };\n}\n\nexport interface ExternalMountEditorDetail<TRow = unknown> {\n  placeholder: HTMLElement;\n  spec: unknown;\n  context: {\n    row: TRow;\n    value: unknown;\n    field: string;\n    column: unknown;\n    commit: (v: unknown) => void;\n    cancel: () => void;\n  };\n}\n\nexport interface DataGridEventMap<TRow = unknown> {\n  'cell-commit': CellCommitDetail<TRow>;\n  'row-commit': RowCommitDetail<TRow>;\n  'changed-rows-reset': ChangedRowsResetDetail<TRow>;\n  'mount-external-view': ExternalMountViewDetail<TRow>;\n  'mount-external-editor': ExternalMountEditorDetail<TRow>;\n  'sort-change': SortChangeDetail;\n  'column-resize': ColumnResizeDetail;\n  'activate-cell': ActivateCellDetail;\n  'column-state-change': GridColumnState;\n}\n\nexport type DataGridEventDetail<K extends keyof DataGridEventMap<unknown>, TRow = unknown> = DataGridEventMap<TRow>[K];\nexport type DataGridCustomEvent<K extends keyof DataGridEventMap<unknown>, TRow = unknown> = CustomEvent<\n  DataGridEventMap<TRow>[K]\n>;\n\n// Internal code now reuses the public ColumnEditorContext; provide alias for backward compatibility\nexport type EditorContext<T = unknown> = ColumnEditorContext<T, unknown>;\n\nexport interface EvalContext {\n  value: unknown;\n  row: Record<string, unknown> | null;\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\nimport type {\n  ColumnConfig,\n  ColumnState,\n  GridPlugin,\n  HeaderContentDefinition,\n  IconValue,\n  ToolPanelDefinition,\n} from '../types';\nimport { DEFAULT_GRID_ICONS } from '../types';\n\n// Forward declare to avoid circular imports\nexport interface GridElement {\n  shadowRoot: ShadowRoot | null;\n  rows: any[];\n  columns: ColumnConfig[];\n  gridConfig: any;\n  /**\n   * Current focused row index\n   * @internal Plugin API\n   */\n  _focusRow: number;\n  /**\n   * Current focused column index\n   * @internal Plugin API\n   */\n  _focusCol: number;\n  /** AbortSignal that is aborted when the grid disconnects from the DOM */\n  disconnectSignal: AbortSignal;\n  requestRender(): void;\n  requestAfterRender(): void;\n  forceLayout(): Promise<void>;\n  getPlugin<T extends BaseGridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined;\n  getPluginByName(name: string): BaseGridPlugin | undefined;\n  dispatchEvent(event: Event): boolean;\n}\n\n/**\n * Keyboard modifier flags\n */\nexport interface KeyboardModifiers {\n  ctrl?: boolean;\n  shift?: boolean;\n  alt?: boolean;\n  meta?: boolean;\n}\n\n/**\n * Cell coordinates\n */\nexport interface CellCoords {\n  row: number;\n  col: number;\n}\n\n/**\n * Cell click event\n */\nexport interface CellClickEvent {\n  rowIndex: number;\n  colIndex: number;\n  field: string;\n  value: any;\n  row: any;\n  cellEl: HTMLElement;\n  originalEvent: MouseEvent;\n}\n\n/**\n * Row click event\n */\nexport interface RowClickEvent {\n  rowIndex: number;\n  row: any;\n  rowEl: HTMLElement;\n  originalEvent: MouseEvent;\n}\n\n/**\n * Header click event\n */\nexport interface HeaderClickEvent {\n  colIndex: number;\n  field: string;\n  column: ColumnConfig;\n  headerEl: HTMLElement;\n  originalEvent: MouseEvent;\n}\n\n/**\n * Scroll event\n */\nexport interface ScrollEvent {\n  scrollTop: number;\n  scrollLeft: number;\n  scrollHeight: number;\n  scrollWidth: number;\n  clientHeight: number;\n  clientWidth: number;\n  originalEvent?: Event;\n}\n\n/**\n * Cell mouse event (for drag operations, selection, etc.)\n */\nexport interface CellMouseEvent {\n  /** Event type: mousedown, mousemove, or mouseup */\n  type: 'mousedown' | 'mousemove' | 'mouseup';\n  /** Row index, undefined if not over a data cell */\n  rowIndex?: number;\n  /** Column index, undefined if not over a cell */\n  colIndex?: number;\n  /** Field name, undefined if not over a cell */\n  field?: string;\n  /** Cell value, undefined if not over a data cell */\n  value?: unknown;\n  /** Row data object, undefined if not over a data row */\n  row?: unknown;\n  /** Column configuration, undefined if not over a column */\n  column?: ColumnConfig;\n  /** The cell element, undefined if not over a cell */\n  cellElement?: HTMLElement;\n  /** The row element, undefined if not over a row */\n  rowElement?: HTMLElement;\n  /** Whether the event is over a header cell */\n  isHeader: boolean;\n  /** Cell coordinates if over a valid data cell */\n  cell?: CellCoords;\n  /** The original mouse event */\n  originalEvent: MouseEvent;\n}\n\n/**\n * Context menu parameters\n */\nexport interface ContextMenuParams {\n  x: number;\n  y: number;\n  rowIndex?: number;\n  colIndex?: number;\n  field?: string;\n  value?: any;\n  row?: any;\n  column?: ColumnConfig;\n  isHeader?: boolean;\n}\n\n/**\n * Context menu item (used by context-menu plugin query)\n */\nexport interface ContextMenuItem {\n  id: string;\n  label: string;\n  icon?: string;\n  disabled?: boolean;\n  separator?: boolean;\n  children?: ContextMenuItem[];\n  action?: (params: ContextMenuParams) => void;\n}\n\n/**\n * Generic plugin query for inter-plugin communication.\n * Plugins can define their own query types as string constants\n * and respond to queries from other plugins.\n */\nexport interface PluginQuery<T = unknown> {\n  /** Query type identifier (e.g., 'canMoveColumn', 'getContextMenuItems') */\n  type: string;\n  /** Query-specific context/parameters */\n  context: T;\n}\n\n/**\n * Well-known plugin query types.\n * Plugins can define additional query types beyond these.\n */\nexport const PLUGIN_QUERIES = {\n  /** Ask if a column can be moved. Context: ColumnConfig. Response: boolean | undefined */\n  CAN_MOVE_COLUMN: 'canMoveColumn',\n  /** Get context menu items. Context: ContextMenuParams. Response: ContextMenuItem[] */\n  GET_CONTEXT_MENU_ITEMS: 'getContextMenuItems',\n} as const;\n\n/**\n * Cell render context for plugin cell renderers.\n * Provides full context including position and editing state.\n *\n * Note: This differs from the core `CellRenderContext` in types.ts which is\n * simpler and used for column view renderers. This version provides additional\n * context needed by plugins that register custom cell renderers.\n */\nexport interface PluginCellRenderContext {\n  /** The cell value */\n  value: any;\n  /** The field/column key */\n  field: string;\n  /** The row data object */\n  row: any;\n  /** Row index in the data array */\n  rowIndex: number;\n  /** Column index */\n  colIndex: number;\n  /** Column configuration */\n  column: ColumnConfig;\n  /** Whether the cell is currently in edit mode */\n  isEditing: 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 * Cell renderer function type for plugins.\n */\nexport type CellRenderer = (ctx: PluginCellRenderContext) => string | HTMLElement;\n\n/**\n * Header renderer function type for plugins.\n */\nexport type HeaderRenderer = (ctx: PluginHeaderRenderContext) => string | HTMLElement;\n\n/**\n * Cell editor interface for plugins.\n */\nexport interface CellEditor {\n  create(ctx: PluginCellRenderContext, commitFn: (value: any) => void, cancelFn: () => void): HTMLElement;\n  getValue?(element: HTMLElement): any;\n  focus?(element: HTMLElement): void;\n}\n\n/**\n * Abstract base class for all grid plugins.\n *\n * @template TConfig - Configuration type for the plugin\n */\nexport abstract class BaseGridPlugin<TConfig = unknown> implements GridPlugin {\n  /** Unique plugin identifier (derived from class name by default) */\n  abstract readonly name: string;\n\n  /** Plugin version - override in subclass if needed */\n  readonly version: string = '1.0.0';\n\n  /** CSS styles to inject into the grid's shadow DOM */\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   * 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   * Called when the plugin is attached to a grid.\n   * Override to set up event listeners, initialize state, etc.\n   */\n  attach(grid: GridElement): void {\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  detach(): void {\n    // Override in subclass\n  }\n\n  /**\n   * Get another plugin instance from the same grid.\n   * Use for inter-plugin communication.\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   * Request a re-render of the grid.\n   */\n  protected requestRender(): void {\n    this.grid?.requestRender?.();\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   * 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 as any)?.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 as any)?._visibleColumns ?? [];\n  }\n\n  /**\n   * Get the shadow root of the grid.\n   */\n  protected get shadowRoot(): ShadowRoot | null {\n    return this.grid?.shadowRoot ?? null;\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 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(): typeof DEFAULT_GRID_ICONS {\n    const userIcons = this.grid?.gridConfig?.icons ?? {};\n    return { ...DEFAULT_GRID_ICONS, ...userIcons };\n  }\n\n  /**\n   * Resolve an icon value to string or HTMLElement.\n   * Checks plugin config first, then grid-level icons, then defaults.\n   *\n   * @param iconKey - The icon key in GridIcons (e.g., 'expand', 'collapse')\n   * @param pluginOverride - Optional plugin-level override\n   * @returns The resolved icon value\n   */\n  protected resolveIcon(iconKey: keyof typeof DEFAULT_GRID_ICONS, pluginOverride?: IconValue): IconValue {\n    // Plugin override takes precedence\n    if (pluginOverride !== undefined) {\n      return pluginOverride;\n    }\n    // Then grid-level config\n    return this.gridIcons[iconKey];\n  }\n\n  /**\n   * Set an icon value on an element.\n   * Handles both string (text/HTML) and HTMLElement values.\n   *\n   * @param element - The element to set the icon on\n   * @param icon - The icon value (string or HTMLElement)\n   */\n  protected setIcon(element: HTMLElement, icon: IconValue): void {\n    if (typeof icon === 'string') {\n      element.innerHTML = icon;\n    } else if (icon instanceof HTMLElement) {\n      element.innerHTML = '';\n      element.appendChild(icon.cloneNode(true));\n    }\n  }\n\n  /**\n   * Log a warning message.\n   */\n  protected warn(message: string): void {\n    console.warn(`[tbw-grid:${this.name}] ${message}`);\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   * 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   * @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.shadowRoot?.querySelectorAll('.data-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 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   * Return extra height contributed by this plugin (e.g., expanded detail rows).\n   * Used to adjust scrollbar height calculations for virtualization.\n   *\n   * @returns Total extra height in pixels\n   *\n   * @example\n   * ```ts\n   * getExtraHeight(): number {\n   *   return this.expandedRows.size * this.detailHeight;\n   * }\n   * ```\n   */\n  getExtraHeight?(): number;\n\n  /**\n   * Return extra height that appears before a given row index.\n   * Used by virtualization to correctly calculate scroll positions when\n   * there's variable height content (like expanded detail rows) above the viewport.\n   *\n   * @param beforeRowIndex - The row index to calculate extra height before\n   * @returns Extra height in pixels that appears before this row\n   *\n   * @example\n   * ```ts\n   * getExtraHeightBefore(beforeRowIndex: number): number {\n   *   let height = 0;\n   *   for (const expandedRowIndex of this.expandedRowIndices) {\n   *     if (expandedRowIndex < beforeRowIndex) {\n   *       height += this.getDetailHeight(expandedRowIndex);\n   *     }\n   *   }\n   *   return height;\n   * }\n   * ```\n   */\n  getExtraHeightBefore?(beforeRowIndex: number): number;\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.\n   * This is the generic mechanism for inter-plugin communication.\n   * Plugins can respond to well-known query types or define their own.\n   *\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   * onPluginQuery(query: PluginQuery): unknown {\n   *   switch (query.type) {\n   *     case PLUGIN_QUERIES.CAN_MOVE_COLUMN:\n   *       // Prevent moving pinned columns\n   *       const column = query.context as ColumnConfig;\n   *       if (column.sticky === 'left' || column.sticky === 'right') {\n   *         return false;\n   *       }\n   *       break;\n   *     case PLUGIN_QUERIES.GET_CONTEXT_MENU_ITEMS:\n   *       const params = query.context as ContextMenuParams;\n   *       return [{ id: 'my-action', label: 'My Action', action: () => {} }];\n   *   }\n   * }\n   * ```\n   */\n  onPluginQuery?(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 now provided via onPluginQuery with PLUGIN_QUERIES.GET_CONTEXT_MENU_ITEMS\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  // #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 * Clipboard Copy Logic\n *\n * Pure functions for copying grid data to clipboard.\n */\n\nimport type { ColumnConfig } from '../../core/types';\nimport type { ClipboardConfig } from './types';\n\n/** Parameters for building clipboard text */\nexport interface CopyParams {\n  /** All grid rows */\n  rows: unknown[];\n  /** Column configurations */\n  columns: ColumnConfig[];\n  /** Selected row indices */\n  selectedIndices: Set<number> | number[];\n  /** Clipboard configuration */\n  config: ClipboardConfig;\n}\n\n/**\n * Format a cell value for clipboard output.\n *\n * Uses custom processCell if provided, otherwise applies default formatting:\n * - null/undefined → empty string\n * - Date → ISO string\n * - Object → JSON string\n * - Other → String conversion with optional quoting\n *\n * @param value - The cell value to format\n * @param field - The field name\n * @param row - The full row object\n * @param config - Clipboard configuration\n * @returns Formatted string value\n */\nexport function formatCellValue(value: unknown, field: string, row: unknown, config: ClipboardConfig): string {\n  if (config.processCell) {\n    return config.processCell(value, field, row);\n  }\n\n  if (value == null) return '';\n  if (value instanceof Date) return value.toISOString();\n  if (typeof value === 'object') return JSON.stringify(value);\n\n  const str = String(value);\n  const delimiter = config.delimiter ?? '\\t';\n  const newline = config.newline ?? '\\n';\n\n  // Quote if contains delimiter, newline, or quotes (or if quoteStrings is enabled)\n  if (config.quoteStrings || str.includes(delimiter) || str.includes(newline) || str.includes('\"')) {\n    return `\"${str.replace(/\"/g, '\"\"')}\"`;\n  }\n\n  return str;\n}\n\n/**\n * Build clipboard text from selected rows and columns.\n *\n * @param params - Copy parameters including rows, columns, selection, and config\n * @returns Tab-separated (or custom delimiter) text ready for clipboard\n */\nexport function buildClipboardText(params: CopyParams): string {\n  const { rows, columns, selectedIndices, config } = params;\n  const delimiter = config.delimiter ?? '\\t';\n  const newline = config.newline ?? '\\n';\n\n  // Filter to visible columns (not hidden, not internal __ prefixed)\n  const visibleColumns = columns.filter((c) => !c.hidden && !c.field.startsWith('__'));\n\n  const lines: string[] = [];\n\n  // Add header row if configured\n  if (config.includeHeaders) {\n    const headerCells = visibleColumns.map((c) => {\n      const header = c.header || c.field;\n      // Quote headers if they contain special characters\n      if (header.includes(delimiter) || header.includes(newline) || header.includes('\"')) {\n        return `\"${header.replace(/\"/g, '\"\"')}\"`;\n      }\n      return header;\n    });\n    lines.push(headerCells.join(delimiter));\n  }\n\n  // Convert indices to sorted array\n  const indices = selectedIndices instanceof Set ? [...selectedIndices] : selectedIndices;\n  const sortedIndices = [...indices].sort((a, b) => a - b);\n\n  // Build data rows\n  for (const idx of sortedIndices) {\n    const row = rows[idx];\n    if (!row) continue;\n\n    const cells = visibleColumns.map((col) =>\n      formatCellValue((row as Record<string, unknown>)[col.field], col.field, row, config)\n    );\n    lines.push(cells.join(delimiter));\n  }\n\n  return lines.join(newline);\n}\n\n/**\n * Copy text to the system clipboard.\n *\n * Uses the modern Clipboard API when available, with fallback\n * to execCommand for older browsers.\n *\n * @param text - The text to copy\n * @returns Promise resolving to true if successful, false otherwise\n */\nexport async function copyToClipboard(text: string): Promise<boolean> {\n  try {\n    await navigator.clipboard.writeText(text);\n    return true;\n  } catch {\n    // Fallback for older browsers or when Clipboard API is not available\n    const textarea = document.createElement('textarea');\n    textarea.value = text;\n    textarea.style.position = 'fixed';\n    textarea.style.opacity = '0';\n    textarea.style.pointerEvents = 'none';\n    document.body.appendChild(textarea);\n    textarea.select();\n    const success = document.execCommand('copy');\n    document.body.removeChild(textarea);\n    return success;\n  }\n}\n","/**\n * Clipboard Paste Logic\n *\n * Pure functions for reading and parsing clipboard data.\n */\n\nimport type { ClipboardConfig } from './types';\n\n/**\n * Parse clipboard text into a 2D array of cell values.\n *\n * Handles:\n * - Quoted values (with escaped double quotes \"\")\n * - Multi-line quoted values (newlines within quotes are preserved)\n * - Custom delimiters and newlines\n * - Empty lines (filtered out only if they contain no data)\n *\n * @param text - Raw clipboard text\n * @param config - Clipboard configuration\n * @returns 2D array where each sub-array is a row of cell values\n */\nexport function parseClipboardText(text: string, config: ClipboardConfig): string[][] {\n  const delimiter = config.delimiter ?? '\\t';\n  const newline = config.newline ?? '\\n';\n\n  // Handle Windows CRLF line endings\n  const normalizedText = text.replace(/\\r\\n/g, '\\n').replace(/\\r/g, '\\n');\n\n  // Parse the entire text handling quoted fields that may span multiple lines\n  const rows: string[][] = [];\n  let currentRow: string[] = [];\n  let currentCell = '';\n  let inQuotes = false;\n\n  for (let i = 0; i < normalizedText.length; i++) {\n    const char = normalizedText[i];\n\n    if (char === '\"' && !inQuotes) {\n      // Start of quoted field\n      inQuotes = true;\n    } else if (char === '\"' && inQuotes) {\n      // Check for escaped quote (\"\")\n      if (normalizedText[i + 1] === '\"') {\n        currentCell += '\"';\n        i++; // Skip the second quote\n      } else {\n        // End of quoted field\n        inQuotes = false;\n      }\n    } else if (char === delimiter && !inQuotes) {\n      // Field separator\n      currentRow.push(currentCell);\n      currentCell = '';\n    } else if (char === newline && !inQuotes) {\n      // Row separator (only if not inside quotes)\n      currentRow.push(currentCell);\n      currentCell = '';\n      // Only add non-empty rows (at least one non-empty cell or multiple cells)\n      if (currentRow.length > 1 || currentRow.some((c) => c.trim() !== '')) {\n        rows.push(currentRow);\n      }\n      currentRow = [];\n    } else {\n      currentCell += char;\n    }\n  }\n\n  // Handle the last cell and row\n  currentRow.push(currentCell);\n  if (currentRow.length > 1 || currentRow.some((c) => c.trim() !== '')) {\n    rows.push(currentRow);\n  }\n\n  return rows;\n}\n\n/**\n * Read text from the system clipboard.\n *\n * Uses the modern Clipboard API. Returns empty string if\n * the API is not available or permission is denied.\n *\n * @returns Promise resolving to clipboard text or empty string\n */\nexport async function readFromClipboard(): Promise<string> {\n  try {\n    return await navigator.clipboard.readText();\n  } catch {\n    // Permission denied or API not available\n    return '';\n  }\n}\n","/**\n * Clipboard Plugin (Class-based)\n *\n * Provides copy/paste functionality for tbw-grid.\n * Supports Ctrl+C/Cmd+C for copying and Ctrl+V/Cmd+V for pasting.\n *\n * **With Selection plugin:** Copy selected rows as a range\n * - includeHeaders: true → adds header row at top\n * - includeHeaders: false → data rows only\n *\n * **Without Selection plugin:** Copy focused cell only\n * - includeHeaders: true → \"Header: value\" format\n * - includeHeaders: false → value only\n */\n\nimport { BaseGridPlugin } from '../../core/plugin/base-plugin';\nimport { buildClipboardText, copyToClipboard } from './copy';\nimport { parseClipboardText, readFromClipboard } from './paste';\nimport type { ClipboardConfig, CopyDetail, PasteDetail } from './types';\n\n/**\n * Clipboard Plugin for tbw-grid\n *\n * @example\n * ```ts\n * new ClipboardPlugin({ includeHeaders: true })\n * ```\n */\nexport class ClipboardPlugin extends BaseGridPlugin<ClipboardConfig> {\n  readonly name = 'clipboard';\n  override readonly version = '1.0.0';\n\n  protected override get defaultConfig(): Partial<ClipboardConfig> {\n    return {\n      includeHeaders: false,\n      delimiter: '\\t',\n      newline: '\\n',\n      quoteStrings: false,\n    };\n  }\n\n  // #region Internal State\n  /** The last copied text (for reference/debugging) */\n  private lastCopied: { text: string; timestamp: number } | null = null;\n  // #endregion\n\n  // #region Lifecycle\n\n  override detach(): void {\n    this.lastCopied = null;\n  }\n  // #endregion\n\n  // #region Event Handlers\n\n  override onKeyDown(event: KeyboardEvent): boolean {\n    const isCopy = (event.ctrlKey || event.metaKey) && event.key === 'c';\n    const isPaste = (event.ctrlKey || event.metaKey) && event.key === 'v';\n\n    if (isCopy) {\n      this.#handleCopy(event.target as HTMLElement);\n      return true; // Prevent default browser behavior\n    }\n\n    if (isPaste) {\n      this.#handlePaste();\n      return true; // Prevent default browser behavior\n    }\n\n    return false;\n  }\n  // #endregion\n\n  // #region Private Methods\n\n  /**\n   * Handle copy operation\n   */\n  #handleCopy(target: HTMLElement): void {\n    // Try to get selection from selection plugin (if available)\n    // Use dynamic import to avoid circular dependency issues\n    const selectionPlugin = this.#getSelectionPlugin();\n\n    // Check for different selection types\n    const selectedRows = selectionPlugin?.getSelectedRows() ?? [];\n    const hasRowSelection = selectedRows.length > 0;\n    const ranges = selectionPlugin?.getRanges() ?? [];\n    const hasRangeSelection = ranges.length > 0;\n    const hasCellSelection = selectionPlugin?.getSelectedCell() != null;\n\n    let text: string;\n    let rowCount: number;\n    let columnCount: number;\n\n    if (hasRowSelection && selectionPlugin) {\n      // Row selection mode - copy full rows\n      text = buildClipboardText({\n        rows: this.rows as unknown[],\n        columns: [...this.columns],\n        selectedIndices: selectedRows,\n        config: this.config,\n      });\n      rowCount = selectedRows.length;\n      columnCount = this.columns.filter((c) => !c.hidden && !c.field.startsWith('__')).length;\n    } else if (hasRangeSelection && selectionPlugin) {\n      // Range selection mode - copy rectangular range (use last range as active)\n      const range = ranges[ranges.length - 1];\n      const result = this.#buildRangeText({\n        startRow: range.from.row,\n        startCol: range.from.col,\n        endRow: range.to.row,\n        endCol: range.to.col,\n      });\n      text = result.text;\n      rowCount = result.rowCount;\n      columnCount = result.columnCount;\n    } else if (hasCellSelection && selectionPlugin) {\n      // Cell selection mode - copy single cell\n      const cell = selectionPlugin.getSelectedCell()!;\n      const result = this.#buildCellText(cell.row, cell.col);\n      if (!result) return;\n      text = result.text;\n      rowCount = 1;\n      columnCount = 1;\n    } else {\n      // Fallback: try to find focused cell from DOM\n      const result = this.#buildSingleCellText(target);\n      if (!result) return;\n      text = result.text;\n      rowCount = 1;\n      columnCount = 1;\n    }\n\n    copyToClipboard(text).then(() => {\n      this.lastCopied = { text, timestamp: Date.now() };\n      this.emit<CopyDetail>('copy', { text, rowCount, columnCount });\n    });\n  }\n\n  /**\n   * Handle paste operation\n   */\n  #handlePaste(): void {\n    readFromClipboard().then((text) => {\n      if (!text) return;\n      const parsed = parseClipboardText(text, this.config);\n      this.emit<PasteDetail>('paste', { rows: parsed, text });\n    });\n  }\n\n  /**\n   * Get the selection plugin instance if available.\n   */\n  #getSelectionPlugin(): SelectionPluginInterface | undefined {\n    // Dynamically get the SelectionPlugin class to avoid import order issues\n    try {\n      // Use getPlugin with the class - this requires the class to be imported\n      // For now, we'll use a duck-typing approach via the grid's plugin registry\n      const grid = this.grid as any;\n      if (grid?._plugins) {\n        for (const plugin of grid._plugins) {\n          if (plugin.name === 'selection') {\n            return plugin as SelectionPluginInterface;\n          }\n        }\n      }\n    } catch {\n      // Selection plugin not available\n    }\n    return undefined;\n  }\n\n  /**\n   * Build text for a single cell by row/col index.\n   */\n  #buildCellText(rowIndex: number, colIndex: number): { text: string } | null {\n    const rowData = this.rows[rowIndex] as Record<string, unknown> | undefined;\n    if (!rowData) return null;\n\n    const column = this.columns[colIndex];\n    if (!column) return null;\n\n    const value = rowData[column.field];\n    const header = column.header || column.field;\n\n    let text: string;\n    if (this.config.includeHeaders) {\n      const formattedValue = value == null ? '' : String(value);\n      text = `${header}: ${formattedValue}`;\n    } else {\n      text = value == null ? '' : String(value);\n    }\n\n    return { text };\n  }\n\n  /**\n   * Build text for a rectangular range of cells.\n   */\n  #buildRangeText(range: { startRow: number; startCol: number; endRow: number; endCol: number }): {\n    text: string;\n    rowCount: number;\n    columnCount: number;\n  } {\n    const { startRow, startCol, endRow, endCol } = range;\n    const minRow = Math.min(startRow, endRow);\n    const maxRow = Math.max(startRow, endRow);\n    const minCol = Math.min(startCol, endCol);\n    const maxCol = Math.max(startCol, endCol);\n\n    const delimiter = this.config.delimiter ?? '\\t';\n    const newline = this.config.newline ?? '\\n';\n    const lines: string[] = [];\n\n    // Get columns in the range\n    const rangeColumns = this.columns.slice(minCol, maxCol + 1);\n\n    // Add header row if configured\n    if (this.config.includeHeaders) {\n      const headerCells = rangeColumns.map((c) => c.header || c.field);\n      lines.push(headerCells.join(delimiter));\n    }\n\n    // Add data rows\n    for (let r = minRow; r <= maxRow; r++) {\n      const rowData = this.rows[r] as Record<string, unknown> | undefined;\n      if (!rowData) continue;\n\n      const cells = rangeColumns.map((col) => {\n        const value = rowData[col.field];\n        if (value == null) return '';\n        if (value instanceof Date) return value.toISOString();\n        return String(value);\n      });\n      lines.push(cells.join(delimiter));\n    }\n\n    return {\n      text: lines.join(newline),\n      rowCount: maxRow - minRow + 1,\n      columnCount: maxCol - minCol + 1,\n    };\n  }\n\n  /**\n   * Build text for a single focused cell from DOM.\n   * Used when selection plugin is not available or no rows are selected.\n   */\n  #buildSingleCellText(target: HTMLElement): { text: string; field: string; value: unknown } | null {\n    // Find the cell element - cells use data-field-cache for the field name\n    const cell = target.closest('[data-field-cache]') as HTMLElement | null;\n    if (!cell) return null;\n\n    const field = cell.dataset.fieldCache;\n    if (!field) return null;\n\n    // Get row index from data-row attribute on the cell\n    const rowIndexStr = cell.dataset.row;\n    if (!rowIndexStr) return null;\n\n    const rowIndex = parseInt(rowIndexStr, 10);\n    if (isNaN(rowIndex)) return null;\n\n    const rowData = this.rows[rowIndex] as Record<string, unknown> | undefined;\n    if (!rowData) return null;\n\n    const value = rowData[field];\n    const column = this.columns.find((c) => c.field === field);\n    const header = column?.header || field;\n\n    // Format the text based on includeHeaders config\n    let text: string;\n    if (this.config.includeHeaders) {\n      // Format: \"{header}: {value}\"\n      const formattedValue = value == null ? '' : String(value);\n      text = `${header}: ${formattedValue}`;\n    } else {\n      // Just the value\n      text = value == null ? '' : String(value);\n    }\n\n    return { text, field, value };\n  }\n  // #endregion\n\n  // #region Public API\n\n  /**\n   * Copy currently selected rows to clipboard.\n   * @returns The copied text\n   */\n  async copy(): Promise<string> {\n    const selectionPlugin = this.#getSelectionPlugin();\n    const indices = selectionPlugin?.getSelectedRows() ?? [];\n\n    const text = buildClipboardText({\n      rows: this.rows as unknown[],\n      columns: [...this.columns],\n      selectedIndices: indices,\n      config: this.config,\n    });\n\n    await copyToClipboard(text);\n    this.lastCopied = { text, timestamp: Date.now() };\n    return text;\n  }\n\n  /**\n   * Copy specific rows by index to clipboard.\n   * @param indices - Array of row indices to copy\n   * @returns The copied text\n   */\n  async copyRows(indices: number[]): Promise<string> {\n    const text = buildClipboardText({\n      rows: this.rows as unknown[],\n      columns: [...this.columns],\n      selectedIndices: indices,\n      config: this.config,\n    });\n\n    await copyToClipboard(text);\n    this.lastCopied = { text, timestamp: Date.now() };\n    return text;\n  }\n\n  /**\n   * Read and parse clipboard content.\n   * @returns Parsed 2D array of cell values, or null if clipboard is empty\n   */\n  async paste(): Promise<string[][] | null> {\n    const text = await readFromClipboard();\n    if (!text) return null;\n    return parseClipboardText(text, this.config);\n  }\n\n  /**\n   * Get the last copied text and timestamp.\n   * @returns The last copied info or null\n   */\n  getLastCopied(): { text: string; timestamp: number } | null {\n    return this.lastCopied;\n  }\n  // #endregion\n}\n\n// #region Internal Types\n\n/**\n * Interface for SelectionPlugin methods we need.\n * This avoids circular imports while providing type safety.\n */\ninterface SelectionPluginInterface {\n  name: string;\n  /** Get selected row indices (row mode) */\n  getSelectedRows(): number[];\n  /** Get all selected cell ranges (range mode) */\n  getRanges(): Array<{ from: { row: number; col: number }; to: { row: number; col: number } }>;\n  /** Get selected cell (cell mode) */\n  getSelectedCell(): { row: number; col: number } | null;\n}\n// #endregion\n\n// Re-export types\nexport type { ClipboardConfig, CopyDetail, PasteDetail } from './types';\n"],"names":["DEFAULT_GRID_ICONS","BaseGridPlugin","config","grid","PluginClass","eventName","detail","userIcons","iconKey","pluginOverride","element","icon","message","formatCellValue","value","field","row","str","delimiter","newline","buildClipboardText","params","rows","columns","selectedIndices","visibleColumns","c","lines","headerCells","header","sortedIndices","a","b","idx","cells","col","copyToClipboard","text","textarea","success","parseClipboardText","normalizedText","currentRow","currentCell","inQuotes","i","char","readFromClipboard","ClipboardPlugin","event","isCopy","isPaste","#handleCopy","#handlePaste","target","selectionPlugin","#getSelectionPlugin","selectedRows","hasRowSelection","ranges","hasRangeSelection","hasCellSelection","rowCount","columnCount","range","result","#buildRangeText","cell","#buildCellText","#buildSingleCellText","parsed","plugin","rowIndex","colIndex","rowData","column","formattedValue","startRow","startCol","endRow","endCol","minRow","maxRow","minCol","maxCol","rangeColumns","r","rowIndexStr","indices"],"mappings":"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"}

package/lib/plugins/column-virtualization/index.js

@@ -99,7 +99,7 @@ class p {
    * Use this for rendering that needs to match the grid template.
    */
   get visibleColumns() {
-    return this.grid?.visibleColumns ?? [];
+    return this.grid?._visibleColumns ?? [];
   }
   /**
    * Get the shadow root of the grid.