@toolbox-web/grid 0.3.3 → 0.4.0

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

@@ -8,7 +8,7 @@ const m = {
   dragHandle: "⋮⋮",
   toolPanel: "☰"
 };
-class p {
+class w {
   /** Plugin version - override in subclass if needed */
   version = "1.0.0";
   /** CSS styles to inject into the grid's shadow DOM */
@@ -25,6 +25,12 @@ class p {
   config;
   /** User-provided configuration from constructor */
   userConfig;
+  /**
+   * Plugin-level AbortController for event listener cleanup.
+   * Created fresh in attach(), aborted in detach().
+   * This ensures event listeners are properly cleaned up when plugins are re-attached.
+   */
+  #t;
   /**
    * Default configuration - subclasses should override this getter.
    * Note: This must be a getter (not property initializer) for proper inheritance
@@ -39,19 +45,48 @@ class p {
   /**
    * Called when the plugin is attached to a grid.
    * Override to set up event listeners, initialize state, etc.
+   *
+   * @example
+   * ```ts
+   * attach(grid: GridElement): void {
+   *   super.attach(grid);
+   *   // Set up document-level listeners with auto-cleanup
+   *   document.addEventListener('keydown', this.handleEscape, {
+   *     signal: this.disconnectSignal
+   *   });
+   * }
+   * ```
    */
   attach(t) {
-    this.grid = t, this.config = { ...this.defaultConfig, ...this.userConfig };
+    this.#t?.abort(), this.#t = new AbortController(), this.grid = t, this.config = { ...this.defaultConfig, ...this.userConfig };
   }
   /**
    * Called when the plugin is detached from a grid.
    * Override to clean up event listeners, timers, etc.
+   *
+   * @example
+   * ```ts
+   * detach(): void {
+   *   // Clean up any state not handled by disconnectSignal
+   *   this.selectedRows.clear();
+   *   this.cache = null;
+   * }
+   * ```
    */
   detach() {
+    this.#t?.abort(), this.#t = void 0;
   }
   /**
    * Get another plugin instance from the same grid.
    * Use for inter-plugin communication.
+   *
+   * @example
+   * ```ts
+   * const selection = this.getPlugin(SelectionPlugin);
+   * if (selection) {
+   *   const selectedRows = selection.getSelectedRows();
+   * }
+   * ```
    */
   getPlugin(t) {
     return this.grid?.getPlugin(t);
@@ -125,7 +160,7 @@ class p {
    * document.addEventListener('keydown', handler, { signal: this.disconnectSignal });
    */
   get disconnectSignal() {
-    return this.grid?.disconnectSignal;
+    return this.#t?.signal ?? this.grid?.disconnectSignal;
   }
   /**
    * Get the grid-level icons configuration.
@@ -164,50 +199,50 @@ class p {
   }
   // #endregion
 }
-const a = 100;
-function h(s) {
+const d = 100;
+function u(s) {
   if (s == null)
-    return a;
+    return d;
   if (typeof s == "number")
     return s;
   const t = parseFloat(s);
-  return isNaN(t) ? a : t;
+  return isNaN(t) ? d : t;
 }
 function c(s) {
-  return s.map((t) => h(t.width));
+  return s.map((t) => u(t.width));
 }
 function f(s) {
   const t = [];
   let e = 0;
   for (const i of s)
-    t.push(e), e += h(i.width);
+    t.push(e), e += u(i.width);
   return t;
 }
 function g(s) {
-  return s.reduce((t, e) => t + h(e.width), 0);
+  return s.reduce((t, e) => t + u(e.width), 0);
 }
-function w(s, t, e, i, o) {
+function p(s, t, e, i, o) {
   const r = e.length;
   if (r === 0)
     return { startCol: 0, endCol: 0, visibleColumns: [] };
-  let n = R(s, e, i);
+  let n = b(s, e, i);
   n = Math.max(0, n - o);
   const C = s + t;
-  let u = n;
+  let h = n;
   for (let l = n; l < r; l++) {
     if (e[l] >= C) {
-      u = l - 1;
+      h = l - 1;
       break;
     }
-    u = l;
+    h = l;
   }
-  u = Math.min(r - 1, u + o);
-  const d = [];
-  for (let l = n; l <= u; l++)
-    d.push(l);
-  return { startCol: n, endCol: u, visibleColumns: d };
+  h = Math.min(r - 1, h + o);
+  const a = [];
+  for (let l = n; l <= h; l++)
+    a.push(l);
+  return { startCol: n, endCol: h, visibleColumns: a };
 }
-function R(s, t, e) {
+function b(s, t, e) {
   let i = 0, o = t.length - 1;
   for (; i < o; ) {
     const r = Math.floor((i + o) / 2);
@@ -215,10 +250,10 @@ function R(s, t, e) {
   }
   return i;
 }
-function b(s, t, e) {
+function R(s, t, e) {
   return e ? s > t : !1;
 }
-class W extends p {
+class W extends w {
   name = "columnVirtualization";
   version = "1.0.0";
   get defaultConfig() {
@@ -249,10 +284,10 @@ class W extends p {
   // #endregion
   // #region Hooks
   processColumns(t) {
-    const e = b(t.length, this.config.threshold ?? 30, this.config.autoEnable ?? !0);
+    const e = R(t.length, this.config.threshold ?? 30, this.config.autoEnable ?? !0);
     if (this.isVirtualized = e ?? !1, this.columnWidths = c(t), this.columnOffsets = f(t), this.totalWidth = g(t), !e)
       return this.startCol = 0, this.endCol = t.length - 1, [...t];
-    const i = this.grid.clientWidth || 800, o = w(
+    const i = this.grid.clientWidth || 800, o = p(
       this.scrollLeft,
       i,
       this.columnOffsets,

package/lib/plugins/column-virtualization/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/column-virtualization/column-virtualization.ts","../../../../../../libs/grid/src/lib/plugins/column-virtualization/ColumnVirtualizationPlugin.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  // Custom Styles API\n  /**\n   * Register custom CSS styles to be injected into the grid's shadow DOM.\n   * Use this to style custom cell renderers, editors, or detail panels.\n   * @param id - Unique identifier for the style block (for removal/updates)\n   * @param css - CSS string to inject\n   */\n  registerStyles?: (id: string, css: string) => void;\n  /**\n   * Remove previously registered custom styles.\n   * @param id - The ID used when registering the styles\n   */\n  unregisterStyles?: (id: string) => void;\n  /**\n   * Get list of registered custom style IDs.\n   */\n  getRegisteredStyles?: () => string[];\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 */\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  /**\n   * Optional custom cell renderer function. Alias for `viewRenderer`.\n   * Can return an HTMLElement, a Node, or an HTML string (which will be sanitized).\n   *\n   * @example\n   * ```typescript\n   * // Simple string template\n   * renderer: (ctx) => `<span class=\"badge\">${ctx.value}</span>`\n   *\n   * // DOM element\n   * renderer: (ctx) => {\n   *   const el = document.createElement('span');\n   *   el.textContent = ctx.value;\n   *   return el;\n   * }\n   * ```\n   */\n  renderer?: ColumnViewRenderer<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 programmatically */\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   * The cell DOM element being rendered into.\n   * Framework adapters can use this to cache per-cell state (e.g., React roots).\n   * @internal\n   */\n  cellEl?: HTMLElement;\n}\n\nexport type ColumnViewRenderer<TRow = unknown, TValue = unknown> = (\n  ctx: CellRenderContext<TRow, TValue>,\n) => Node | string | void;\n\n/**\n * Framework adapter interface for handling framework-specific component instantiation.\n * Allows framework libraries (Angular, React, Vue) to register handlers that convert\n * declarative light DOM elements into functional renderers/editors.\n *\n * @example\n * ```typescript\n * // In @toolbox-web/grid-angular\n * class AngularGridAdapter implements FrameworkAdapter {\n *   canHandle(element: HTMLElement): boolean {\n *     return element.tagName.startsWith('APP-');\n *   }\n *   createRenderer(element: HTMLElement): ColumnViewRenderer {\n *     return (ctx) => {\n *       // Angular-specific instantiation logic\n *       const componentRef = createComponent(...);\n *       componentRef.setInput('value', ctx.value);\n *       return componentRef.location.nativeElement;\n *     };\n *   }\n *   createEditor(element: HTMLElement): ColumnEditorSpec {\n *     return (ctx) => {\n *       // Angular-specific editor with commit/cancel\n *       const componentRef = createComponent(...);\n *       componentRef.setInput('value', ctx.value);\n *       // Subscribe to commit/cancel outputs\n *       return componentRef.location.nativeElement;\n *     };\n *   }\n * }\n *\n * // User registers adapter once in their app\n * GridElement.registerAdapter(new AngularGridAdapter(injector, appRef));\n * ```\n */\nexport interface FrameworkAdapter {\n  /**\n   * Determines if this adapter can handle the given element.\n   * Typically checks tag name, attributes, or other conventions.\n   */\n  canHandle(element: HTMLElement): boolean;\n\n  /**\n   * Creates a view renderer function from a light DOM element.\n   * The renderer receives cell context and returns DOM or string.\n   */\n  createRenderer<TRow = unknown, TValue = unknown>(element: HTMLElement): ColumnViewRenderer<TRow, TValue>;\n\n  /**\n   * Creates an editor spec from a light DOM element.\n   * The editor receives context with commit/cancel and returns DOM.\n   */\n  createEditor<TRow = unknown, TValue = unknown>(element: HTMLElement): ColumnEditorSpec<TRow, TValue>;\n\n  /**\n   * Creates a tool panel renderer from a light DOM element.\n   * The renderer receives a container element and optionally returns a cleanup function.\n   */\n  createToolPanelRenderer?(element: HTMLElement): ((container: HTMLElement) => void | (() => void)) | undefined;\n}\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' | false). Set to false to disable editing. Can also be set via `editOn` prop. */\n  editOn?: string | boolean;\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  /**\n   * Grid-wide animation configuration.\n   * Controls animations for expand/collapse, reordering, and other visual transitions.\n   * Individual plugins can override these defaults in their own config.\n   */\n  animation?: AnimationConfig;\n\n  /**\n   * Custom sort handler for full control over sorting behavior.\n   *\n   * When provided, this handler is called instead of the built-in sorting logic.\n   * Enables custom sorting algorithms, server-side sorting, or plugin-specific sorting.\n   *\n   * The handler receives:\n   * - `rows`: Current row array to sort\n   * - `sortState`: Sort field and direction (1 = asc, -1 = desc)\n   * - `columns`: Column configurations (for accessing sortComparator)\n   *\n   * Return the sorted array (sync) or a Promise that resolves to the sorted array (async).\n   * For server-side sorting, return a Promise that resolves when data is fetched.\n   *\n   * @example\n   * ```ts\n   * // Custom stable sort\n   * sortHandler: (rows, state, cols) => {\n   *   return stableSort(rows, (a, b) => compare(a[state.field], b[state.field]) * state.direction);\n   * }\n   *\n   * // Server-side sorting\n   * sortHandler: async (rows, state) => {\n   *   const response = await fetch(`/api/data?sort=${state.field}&dir=${state.direction}`);\n   *   return response.json();\n   * }\n   * ```\n   */\n  sortHandler?: SortHandler<TRow>;\n}\n// #endregion\n\n// #region Animation\n\n/**\n * Sort state passed to custom sort handlers.\n */\nexport interface SortState {\n  /** Field to sort by */\n  field: string;\n  /** Sort direction: 1 = ascending, -1 = descending */\n  direction: 1 | -1;\n}\n\n/**\n * Custom sort handler function signature.\n *\n * @param rows - Current row array to sort\n * @param sortState - Sort field and direction\n * @param columns - Column configurations (for accessing sortComparator)\n * @returns Sorted array (sync) or Promise resolving to sorted array (async)\n */\nexport type SortHandler<TRow = any> = (\n  rows: TRow[],\n  sortState: SortState,\n  columns: ColumnConfig<TRow>[],\n) => TRow[] | Promise<TRow[]>;\n\n/**\n * Animation behavior mode.\n * - `true` or `'on'`: Animations always enabled\n * - `false` or `'off'`: Animations always disabled\n * - `'reduced-motion'`: Respects `prefers-reduced-motion` media query (default)\n */\nexport type AnimationMode = boolean | 'on' | 'off' | 'reduced-motion';\n\n/**\n * Animation style for visual transitions.\n * - `'slide'`: Slide/transform animation (e.g., expand down, slide left/right)\n * - `'fade'`: Opacity fade animation\n * - `'flip'`: FLIP technique for position changes (First, Last, Invert, Play)\n * - `false`: No animation for this specific feature\n */\nexport type AnimationStyle = 'slide' | 'fade' | 'flip' | false;\n\n/**\n * Animation style for expand/collapse operations.\n * Subset of AnimationStyle - excludes 'flip' which is for position changes.\n * - `'slide'`: Slide down/up animation for expanding/collapsing content\n * - `'fade'`: Fade in/out animation\n * - `false`: No animation\n */\nexport type ExpandCollapseAnimation = 'slide' | 'fade' | false;\n\n/**\n * Grid-wide animation configuration.\n * Controls global animation behavior - individual plugins define their own animation styles.\n * Duration and easing values set corresponding CSS variables on the grid element.\n */\nexport interface AnimationConfig {\n  /**\n   * Global animation mode.\n   * @default 'reduced-motion'\n   */\n  mode?: AnimationMode;\n\n  /**\n   * Default animation duration in milliseconds.\n   * Sets `--tbw-animation-duration` CSS variable.\n   * @default 200\n   */\n  duration?: number;\n\n  /**\n   * Default easing function.\n   * Sets `--tbw-animation-easing` CSS variable.\n   * @default 'ease-out'\n   */\n  easing?: string;\n}\n\n/** Default animation configuration */\nexport const DEFAULT_ANIMATION_CONFIG: Required<Omit<AnimationConfig, 'sort'>> = {\n  mode: 'reduced-motion',\n  duration: 200,\n  easing: 'ease-out',\n};\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 *\n * The grid does NOT create buttons - developers have full control over their own buttons.\n * Provide either:\n * - `element`: A ready-made DOM element (grid appends it to toolbar)\n * - `render`: A factory function that receives a container and appends content\n *\n * For declarative HTML buttons, use light-dom instead:\n * ```html\n * <tbw-grid>\n *   <tbw-grid-header>\n *     <button slot=\"toolbar\">My Button</button>\n *   </tbw-grid-header>\n * </tbw-grid>\n * ```\n */\nexport interface ToolbarButtonConfig {\n  /** Unique button ID */\n  id: string;\n  /** Tooltip / aria-label (for accessibility, used when grid generates panel toggle) */\n  label?: string;\n  /** Order priority (lower = first, default: 100) */\n  order?: number;\n\n  /**\n   * User-provided element. Grid appends it to the toolbar.\n   * User is responsible for styling, event handlers, accessibility, etc.\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  /** 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// Re-export shared plugin types for convenience\nexport { PLUGIN_QUERIES } from './types';\nexport type {\n  CellClickEvent,\n  CellCoords,\n  CellEditor,\n  CellMouseEvent,\n  CellRenderer,\n  ContextMenuItem,\n  ContextMenuParams,\n  GridElementRef,\n  HeaderClickEvent,\n  HeaderRenderer,\n  KeyboardModifiers,\n  PluginCellRenderContext,\n  PluginQuery,\n  RowClickEvent,\n  ScrollEvent,\n} from './types';\n\nimport type {\n  CellClickEvent,\n  CellEditor,\n  CellMouseEvent,\n  CellRenderer,\n  GridElementRef,\n  HeaderClickEvent,\n  HeaderRenderer,\n  PluginQuery,\n  RowClickEvent,\n  ScrollEvent,\n} from './types';\n\n/**\n * Grid element interface for plugins.\n * Extends GridElementRef with plugin-specific methods.\n */\nexport interface GridElement extends GridElementRef {\n  getPlugin<T extends BaseGridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined;\n  getPluginByName(name: string): BaseGridPlugin | undefined;\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 * 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 * Column Virtualization Core Logic\n *\n * Pure functions for horizontal column virtualization operations.\n */\n\nimport type { ColumnConfig } from '../../core/types';\nimport type { ColumnVirtualizationViewport } from './types';\n\n/** Default column width when not specified */\nconst DEFAULT_COLUMN_WIDTH = 100;\n\n/**\n * Parse a column width value to pixels.\n * Handles number (px) and string formats.\n *\n * @param width - The width value from column config\n * @returns Width in pixels\n */\nexport function parseColumnWidth(width: string | number | undefined): number {\n  if (width === undefined || width === null) {\n    return DEFAULT_COLUMN_WIDTH;\n  }\n\n  if (typeof width === 'number') {\n    return width;\n  }\n\n  // Handle string values - extract numeric part\n  const numeric = parseFloat(width);\n  if (!isNaN(numeric)) {\n    return numeric;\n  }\n\n  return DEFAULT_COLUMN_WIDTH;\n}\n\n/**\n * Get array of column widths in pixels.\n *\n * @param columns - Column configurations\n * @returns Array of widths in pixels\n */\nexport function getColumnWidths(columns: readonly ColumnConfig[]): number[] {\n  return columns.map((col) => parseColumnWidth(col.width));\n}\n\n/**\n * Compute cumulative left offsets for each column.\n *\n * @param columns - Column configurations\n * @returns Array of left offsets in pixels\n */\nexport function computeColumnOffsets(columns: readonly ColumnConfig[]): number[] {\n  const offsets: number[] = [];\n  let offset = 0;\n\n  for (const col of columns) {\n    offsets.push(offset);\n    offset += parseColumnWidth(col.width);\n  }\n\n  return offsets;\n}\n\n/**\n * Compute total width of all columns.\n *\n * @param columns - Column configurations\n * @returns Total width in pixels\n */\nexport function computeTotalWidth(columns: readonly ColumnConfig[]): number {\n  return columns.reduce((sum, col) => sum + parseColumnWidth(col.width), 0);\n}\n\n/**\n * Find the visible column range based on scroll position.\n * Uses binary search for efficient lookup in large column sets.\n *\n * @param scrollLeft - Current horizontal scroll position\n * @param viewportWidth - Width of the visible viewport\n * @param columnOffsets - Array of column left offsets\n * @param columnWidths - Array of column widths\n * @param overscan - Number of extra columns to render on each side\n * @returns Viewport information with visible column indices\n */\nexport function getVisibleColumnRange(\n  scrollLeft: number,\n  viewportWidth: number,\n  columnOffsets: number[],\n  columnWidths: number[],\n  overscan: number\n): ColumnVirtualizationViewport {\n  const columnCount = columnOffsets.length;\n\n  if (columnCount === 0) {\n    return { startCol: 0, endCol: 0, visibleColumns: [] };\n  }\n\n  // Binary search for first visible column\n  let startCol = binarySearchFirstVisible(scrollLeft, columnOffsets, columnWidths);\n  startCol = Math.max(0, startCol - overscan);\n\n  // Find last visible column (without overscan first)\n  const rightEdge = scrollLeft + viewportWidth;\n  let endCol = startCol;\n\n  for (let i = startCol; i < columnCount; i++) {\n    if (columnOffsets[i] >= rightEdge) {\n      endCol = i - 1;\n      break;\n    }\n    endCol = i;\n  }\n\n  // Apply overscan to end (only once)\n  endCol = Math.min(columnCount - 1, endCol + overscan);\n\n  // Build array of visible column indices\n  const visibleColumns: number[] = [];\n  for (let i = startCol; i <= endCol; i++) {\n    visibleColumns.push(i);\n  }\n\n  return { startCol, endCol, visibleColumns };\n}\n\n/**\n * Binary search to find the first column that is visible.\n *\n * @param scrollLeft - Current scroll position\n * @param columnOffsets - Array of column offsets\n * @param columnWidths - Array of column widths\n * @returns Index of first visible column\n */\nfunction binarySearchFirstVisible(scrollLeft: number, columnOffsets: number[], columnWidths: number[]): number {\n  let low = 0;\n  let high = columnOffsets.length - 1;\n\n  while (low < high) {\n    const mid = Math.floor((low + high) / 2);\n    const colRight = columnOffsets[mid] + columnWidths[mid];\n\n    if (colRight <= scrollLeft) {\n      low = mid + 1;\n    } else {\n      high = mid;\n    }\n  }\n\n  return low;\n}\n\n/**\n * Determine if column virtualization should be active.\n *\n * @param columnCount - Number of columns\n * @param threshold - Column count threshold\n * @param autoEnable - Whether auto-enable is configured\n * @returns True if virtualization should be active\n */\nexport function shouldVirtualize(columnCount: number, threshold: number, autoEnable: boolean): boolean {\n  if (!autoEnable) return false;\n  return columnCount > threshold;\n}\n","/**\n * Column Virtualization Plugin (Class-based)\n *\n * Provides horizontal column virtualization for grids with many columns.\n * Significantly improves rendering performance when dealing with >30 columns.\n */\n\nimport { BaseGridPlugin, ScrollEvent } from '../../core/plugin/base-plugin';\nimport type { ColumnConfig } from '../../core/types';\nimport {\n  computeColumnOffsets,\n  computeTotalWidth,\n  getColumnWidths,\n  getVisibleColumnRange,\n  shouldVirtualize,\n} from './column-virtualization';\nimport type { ColumnVirtualizationConfig } from './types';\n\n/**\n * Column Virtualization Plugin for tbw-grid\n *\n * @example\n * ```ts\n * new ColumnVirtualizationPlugin({ threshold: 30, overscan: 3 })\n * ```\n */\nexport class ColumnVirtualizationPlugin extends BaseGridPlugin<ColumnVirtualizationConfig> {\n  readonly name = 'columnVirtualization';\n  override readonly version = '1.0.0';\n\n  protected override get defaultConfig(): Partial<ColumnVirtualizationConfig> {\n    return {\n      autoEnable: true,\n      threshold: 30,\n      overscan: 3,\n    };\n  }\n\n  // #region Internal State\n  private isVirtualized = false;\n  private startCol = 0;\n  private endCol = 0;\n  private scrollLeft = 0;\n  private totalWidth = 0;\n  private columnWidths: number[] = [];\n  private columnOffsets: number[] = [];\n  // #endregion\n\n  // #region Lifecycle\n\n  override attach(grid: import('../../core/plugin/base-plugin').GridElement): void {\n    super.attach(grid);\n\n    // Initialize state from current columns\n    const columns = this.columns;\n    this.columnWidths = getColumnWidths(columns);\n    this.columnOffsets = computeColumnOffsets(columns);\n    this.totalWidth = computeTotalWidth(columns);\n    this.endCol = columns.length - 1;\n  }\n\n  override detach(): void {\n    this.columnWidths = [];\n    this.columnOffsets = [];\n    this.isVirtualized = false;\n    this.startCol = 0;\n    this.endCol = 0;\n    this.scrollLeft = 0;\n    this.totalWidth = 0;\n  }\n  // #endregion\n\n  // #region Hooks\n\n  override processColumns(columns: readonly ColumnConfig[]): ColumnConfig[] {\n    const isVirtualized = shouldVirtualize(columns.length, this.config.threshold ?? 30, this.config.autoEnable ?? true);\n\n    // Update state with current column metrics\n    this.isVirtualized = isVirtualized ?? false;\n    this.columnWidths = getColumnWidths(columns);\n    this.columnOffsets = computeColumnOffsets(columns);\n    this.totalWidth = computeTotalWidth(columns);\n\n    if (!isVirtualized) {\n      this.startCol = 0;\n      this.endCol = columns.length - 1;\n      return [...columns];\n    }\n\n    // Get viewport width from grid element\n    const viewportWidth = (this.grid as unknown as HTMLElement).clientWidth || 800;\n    const viewport = getVisibleColumnRange(\n      this.scrollLeft,\n      viewportWidth,\n      this.columnOffsets,\n      this.columnWidths,\n      this.config.overscan ?? 3,\n    );\n\n    this.startCol = viewport.startCol;\n    this.endCol = viewport.endCol;\n\n    // Return only visible columns\n    return viewport.visibleColumns.map((i) => columns[i]);\n  }\n\n  override afterRender(): void {\n    if (!this.isVirtualized) return;\n\n    const shadowRoot = this.shadowRoot;\n    if (!shadowRoot) return;\n\n    // Apply left padding to offset scrolled-out columns\n    const leftPadding = this.columnOffsets[this.startCol] ?? 0;\n\n    const headerRow = shadowRoot.querySelector('.header-row');\n    const bodyRows = shadowRoot.querySelectorAll('.data-grid-row');\n\n    if (headerRow) {\n      (headerRow as HTMLElement).style.paddingLeft = `${leftPadding}px`;\n    }\n\n    bodyRows.forEach((row) => {\n      (row as HTMLElement).style.paddingLeft = `${leftPadding}px`;\n    });\n\n    // Set total width for horizontal scrolling on the rows container\n    const rowsContainer = shadowRoot.querySelector('.rows-viewport .rows');\n    if (rowsContainer) {\n      (rowsContainer as HTMLElement).style.width = `${this.totalWidth}px`;\n    }\n  }\n\n  override onScroll(event: ScrollEvent): void {\n    if (!this.isVirtualized) return;\n\n    // Check if horizontal scroll position changed significantly\n    const scrollDelta = Math.abs(event.scrollLeft - this.scrollLeft);\n    if (scrollDelta < 1) return;\n\n    // Update scroll position\n    this.scrollLeft = event.scrollLeft;\n\n    // Recalculate visible columns and request re-render\n    this.requestRender();\n  }\n  // #endregion\n\n  // #region Public API\n\n  /**\n   * Check if column virtualization is currently active.\n   */\n  getIsVirtualized(): boolean {\n    return this.isVirtualized;\n  }\n\n  /**\n   * Get the current visible column range.\n   */\n  getVisibleColumnRange(): { start: number; end: number } {\n    return { start: this.startCol, end: this.endCol };\n  }\n\n  /**\n   * Scroll the grid to bring a specific column into view.\n   * @param columnIndex - Index of the column to scroll to\n   */\n  scrollToColumn(columnIndex: number): void {\n    const offset = this.columnOffsets[columnIndex] ?? 0;\n    const gridEl = this.grid as unknown as HTMLElement;\n    // Scroll the grid element itself (it's the scroll container)\n    gridEl.scrollLeft = offset;\n  }\n\n  /**\n   * Get the left offset for a specific column.\n   * @param columnIndex - Index of the column\n   */\n  getColumnOffset(columnIndex: number): number {\n    return this.columnOffsets[columnIndex] ?? 0;\n  }\n\n  /**\n   * Get the total width of all columns.\n   */\n  getTotalWidth(): number {\n    return this.totalWidth;\n  }\n  // #endregion\n}\n"],"names":["DEFAULT_GRID_ICONS","BaseGridPlugin","config","grid","PluginClass","eventName","detail","userIcons","iconKey","pluginOverride","element","icon","message","DEFAULT_COLUMN_WIDTH","parseColumnWidth","width","numeric","getColumnWidths","columns","col","computeColumnOffsets","offsets","offset","computeTotalWidth","sum","getVisibleColumnRange","scrollLeft","viewportWidth","columnOffsets","columnWidths","overscan","columnCount","startCol","binarySearchFirstVisible","rightEdge","endCol","i","visibleColumns","low","high","mid","shouldVirtualize","threshold","autoEnable","ColumnVirtualizationPlugin","isVirtualized","viewport","shadowRoot","leftPadding","headerRow","bodyRows","row","rowsContainer","event","columnIndex","gridEl"],"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/column-virtualization/column-virtualization.ts","../../../../../../libs/grid/src/lib/plugins/column-virtualization/ColumnVirtualizationPlugin.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  // Custom Styles API\n  /**\n   * Register custom CSS styles to be injected into the grid's shadow DOM.\n   * Use this to style custom cell renderers, editors, or detail panels.\n   * @param id - Unique identifier for the style block (for removal/updates)\n   * @param css - CSS string to inject\n   */\n  registerStyles?: (id: string, css: string) => void;\n  /**\n   * Remove previously registered custom styles.\n   * @param id - The ID used when registering the styles\n   */\n  unregisterStyles?: (id: string) => void;\n  /**\n   * Get list of registered custom style IDs.\n   */\n  getRegisteredStyles?: () => string[];\n}\n\n/**\n * Internal-only augmented interface for DataGrid component.\n *\n * Member prefixes indicate accessibility:\n * - `_underscore` = protected members - private outside core, accessible to plugins. Marked with @internal.\n * - `__doubleUnderscore` = deeply internal members - private outside core, only for internal functions.\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: RowElementInternal[];\n  _resizeController: ResizeController;\n  _sortState: { field: string; direction: 1 | -1 } | null;\n  /** Original unfiltered/unprocessed rows. @internal */\n  sourceRows: T[];\n  /** Framework adapter instance (set by Grid directives). @internal */\n  __frameworkAdapter?: FrameworkAdapter;\n  __originalOrder: T[];\n  __rowRenderEpoch: number;\n  __didInitialAutoSize?: boolean;\n  __lightDomColumnsCache?: ColumnInternal[];\n  __originalColumnNodes?: HTMLElement[];\n  /** Cell display value cache. @internal */\n  __cellDisplayCache?: Map<number, string[]>;\n  /** Cache epoch for cell display values. @internal */\n  __cellCacheEpoch?: number;\n  /** Cached header row count for virtualization. @internal */\n  __cachedHeaderRowCount?: number;\n  /** Cached flag for whether grid has special columns (custom renderers, etc.). @internal */\n  __hasSpecialColumns?: boolean;\n  /** Cached flag for whether any plugin has renderRow hooks. @internal */\n  __hasRenderRowPlugins?: boolean;\n  _gridTemplate: string;\n  _virtualization: VirtualState;\n  _focusRow: number;\n  _focusCol: number;\n  /** Currently active edit row index. Injected by EditingPlugin. @internal */\n  _activeEditRows?: number;\n  /** Snapshots of row data before editing. Injected by EditingPlugin. @internal */\n  _rowEditSnapshots?: Map<number, T>;\n  /** Set of row indices that have been modified. Injected by EditingPlugin. @internal */\n  _changedRowIndices?: Set<number>;\n  /** Get all changed rows. Injected by EditingPlugin. */\n  changedRows?: T[];\n  /** Get indices of all changed rows. Injected by EditingPlugin. */\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  /** Begin bulk edit on a row. Injected by EditingPlugin. */\n  beginBulkEdit?: (rowIndex: number) => void;\n  /** Commit active row edit. Injected by EditingPlugin. */\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 */\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  /** 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  /**\n   * Optional custom cell renderer function. Alias for `viewRenderer`.\n   * Can return an HTMLElement, a Node, or an HTML string (which will be sanitized).\n   *\n   * @example\n   * ```typescript\n   * // Simple string template\n   * renderer: (ctx) => `<span class=\"badge\">${ctx.value}</span>`\n   *\n   * // DOM element\n   * renderer: (ctx) => {\n   *   const el = document.createElement('span');\n   *   el.textContent = ctx.value;\n   *   return el;\n   * }\n   * ```\n   */\n  renderer?: ColumnViewRenderer<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 programmatically */\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   * The cell DOM element being rendered into.\n   * Framework adapters can use this to cache per-cell state (e.g., React roots).\n   * @internal\n   */\n  cellEl?: HTMLElement;\n}\n\nexport type ColumnViewRenderer<TRow = unknown, TValue = unknown> = (\n  ctx: CellRenderContext<TRow, TValue>,\n) => Node | string | void | null;\n\n/**\n * Framework adapter interface for handling framework-specific component instantiation.\n * Allows framework libraries (Angular, React, Vue) to register handlers that convert\n * declarative light DOM elements into functional renderers/editors.\n *\n * @example\n * ```typescript\n * // In @toolbox-web/grid-angular\n * class AngularGridAdapter implements FrameworkAdapter {\n *   canHandle(element: HTMLElement): boolean {\n *     return element.tagName.startsWith('APP-');\n *   }\n *   createRenderer(element: HTMLElement): ColumnViewRenderer {\n *     return (ctx) => {\n *       // Angular-specific instantiation logic\n *       const componentRef = createComponent(...);\n *       componentRef.setInput('value', ctx.value);\n *       return componentRef.location.nativeElement;\n *     };\n *   }\n *   createEditor(element: HTMLElement): ColumnEditorSpec {\n *     return (ctx) => {\n *       // Angular-specific editor with commit/cancel\n *       const componentRef = createComponent(...);\n *       componentRef.setInput('value', ctx.value);\n *       // Subscribe to commit/cancel outputs\n *       return componentRef.location.nativeElement;\n *     };\n *   }\n * }\n *\n * // User registers adapter once in their app\n * GridElement.registerAdapter(new AngularGridAdapter(injector, appRef));\n * ```\n */\nexport interface FrameworkAdapter {\n  /**\n   * Determines if this adapter can handle the given element.\n   * Typically checks tag name, attributes, or other conventions.\n   */\n  canHandle(element: HTMLElement): boolean;\n\n  /**\n   * Creates a view renderer function from a light DOM element.\n   * The renderer receives cell context and returns DOM or string.\n   */\n  createRenderer<TRow = unknown, TValue = unknown>(element: HTMLElement): ColumnViewRenderer<TRow, TValue>;\n\n  /**\n   * Creates an editor spec from a light DOM element.\n   * The editor receives context with commit/cancel and returns DOM.\n   */\n  createEditor<TRow = unknown, TValue = unknown>(element: HTMLElement): ColumnEditorSpec<TRow, TValue>;\n\n  /**\n   * Creates a tool panel renderer from a light DOM element.\n   * The renderer receives a container element and optionally returns a cleanup function.\n   */\n  createToolPanelRenderer?(element: HTMLElement): ((container: HTMLElement) => void | (() => void)) | undefined;\n}\n\n// #region Internal-only augmented types (not re-exported publicly)\n\n/**\n * Column internal properties used during light DOM parsing.\n * Stores attribute-based names before they're resolved to actual functions.\n * @internal\n */\nexport interface ColumnParsedAttributes {\n  /** Editor name from `editor` attribute (resolved later) */\n  __editorName?: string;\n  /** Renderer name from `renderer` attribute (resolved later) */\n  __rendererName?: string;\n}\n\n/**\n * Extended column config used internally.\n * Includes all internal properties needed during grid lifecycle.\n * @internal\n */\nexport interface ColumnInternal<T = any> extends ColumnConfig<T>, ColumnParsedAttributes {\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?: CompiledViewFunction<T>;\n  __compiledEditor?: (ctx: EditorExecContext<T>) => string;\n}\n\n/**\n * Row element with internal tracking properties.\n * Used during virtualization and row pooling.\n * @internal\n */\nexport interface RowElementInternal extends HTMLElement {\n  /** Epoch marker for row render invalidation */\n  __epoch?: number;\n  /** Reference to the row data object for change detection */\n  __rowDataRef?: unknown;\n  /** Count of cells currently in edit mode */\n  __editingCellCount?: number;\n  /** Flag indicating this is a custom-rendered row (group row, etc.) */\n  __isCustomRow?: boolean;\n}\n\n/**\n * Type-safe access to element.part API (DOMTokenList-like).\n * Used for CSS ::part styling support.\n * @internal\n */\nexport interface ElementWithPart {\n  part?: DOMTokenList;\n}\n\n/**\n * Compiled view function type with optional blocked flag.\n * The __blocked flag is set when a template contains unsafe expressions.\n * @internal\n */\nexport interface CompiledViewFunction<T = any> {\n  (ctx: CellContext<T>): string;\n  /** Set to true when template was blocked due to unsafe expressions */\n  __blocked?: boolean;\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\n// RowElementInternal is now defined earlier in the file with all internal properties\n\n/**\n * Union type for input-like elements that have a `value` property.\n * Covers standard form elements and custom elements with value semantics.\n * @internal\n */\nexport type InputLikeElement = HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement | { value: unknown };\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' | false). Set to false to disable editing. Can also be set via `editOn` prop. */\n  editOn?: string | boolean;\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  /**\n   * Grid-wide animation configuration.\n   * Controls animations for expand/collapse, reordering, and other visual transitions.\n   * Individual plugins can override these defaults in their own config.\n   */\n  animation?: AnimationConfig;\n\n  /**\n   * Custom sort handler for full control over sorting behavior.\n   *\n   * When provided, this handler is called instead of the built-in sorting logic.\n   * Enables custom sorting algorithms, server-side sorting, or plugin-specific sorting.\n   *\n   * The handler receives:\n   * - `rows`: Current row array to sort\n   * - `sortState`: Sort field and direction (1 = asc, -1 = desc)\n   * - `columns`: Column configurations (for accessing sortComparator)\n   *\n   * Return the sorted array (sync) or a Promise that resolves to the sorted array (async).\n   * For server-side sorting, return a Promise that resolves when data is fetched.\n   *\n   * @example\n   * ```ts\n   * // Custom stable sort\n   * sortHandler: (rows, state, cols) => {\n   *   return stableSort(rows, (a, b) => compare(a[state.field], b[state.field]) * state.direction);\n   * }\n   *\n   * // Server-side sorting\n   * sortHandler: async (rows, state) => {\n   *   const response = await fetch(`/api/data?sort=${state.field}&dir=${state.direction}`);\n   *   return response.json();\n   * }\n   * ```\n   */\n  sortHandler?: SortHandler<TRow>;\n}\n// #endregion\n\n// #region Animation\n\n/**\n * Sort state passed to custom sort handlers.\n */\nexport interface SortState {\n  /** Field to sort by */\n  field: string;\n  /** Sort direction: 1 = ascending, -1 = descending */\n  direction: 1 | -1;\n}\n\n/**\n * Custom sort handler function signature.\n *\n * @param rows - Current row array to sort\n * @param sortState - Sort field and direction\n * @param columns - Column configurations (for accessing sortComparator)\n * @returns Sorted array (sync) or Promise resolving to sorted array (async)\n */\nexport type SortHandler<TRow = any> = (\n  rows: TRow[],\n  sortState: SortState,\n  columns: ColumnConfig<TRow>[],\n) => TRow[] | Promise<TRow[]>;\n\n/**\n * Animation behavior mode.\n * - `true` or `'on'`: Animations always enabled\n * - `false` or `'off'`: Animations always disabled\n * - `'reduced-motion'`: Respects `prefers-reduced-motion` media query (default)\n */\nexport type AnimationMode = boolean | 'on' | 'off' | 'reduced-motion';\n\n/**\n * Animation style for visual transitions.\n * - `'slide'`: Slide/transform animation (e.g., expand down, slide left/right)\n * - `'fade'`: Opacity fade animation\n * - `'flip'`: FLIP technique for position changes (First, Last, Invert, Play)\n * - `false`: No animation for this specific feature\n */\nexport type AnimationStyle = 'slide' | 'fade' | 'flip' | false;\n\n/**\n * Animation style for expand/collapse operations.\n * Subset of AnimationStyle - excludes 'flip' which is for position changes.\n * - `'slide'`: Slide down/up animation for expanding/collapsing content\n * - `'fade'`: Fade in/out animation\n * - `false`: No animation\n */\nexport type ExpandCollapseAnimation = 'slide' | 'fade' | false;\n\n/**\n * Grid-wide animation configuration.\n * Controls global animation behavior - individual plugins define their own animation styles.\n * Duration and easing values set corresponding CSS variables on the grid element.\n */\nexport interface AnimationConfig {\n  /**\n   * Global animation mode.\n   * @default 'reduced-motion'\n   */\n  mode?: AnimationMode;\n\n  /**\n   * Default animation duration in milliseconds.\n   * Sets `--tbw-animation-duration` CSS variable.\n   * @default 200\n   */\n  duration?: number;\n\n  /**\n   * Default easing function.\n   * Sets `--tbw-animation-easing` CSS variable.\n   * @default 'ease-out'\n   */\n  easing?: string;\n}\n\n/** Default animation configuration */\nexport const DEFAULT_ANIMATION_CONFIG: Required<Omit<AnimationConfig, 'sort'>> = {\n  mode: 'reduced-motion',\n  duration: 200,\n  easing: 'ease-out',\n};\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   * Registered tool panels (from plugins, API, or Light DOM).\n   * These are the actual panel definitions that can be opened.\n   * @internal Set by ConfigManager during merge\n   */\n  toolPanels?: ToolPanelDefinition[];\n  /**\n   * Registered header content sections (from plugins or API).\n   * Content rendered in the center of the shell header.\n   * @internal Set by ConfigManager during merge\n   */\n  headerContents?: HeaderContentDefinition[];\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   * Light DOM header content elements (parsed from <tbw-grid-header> children).\n   * @internal Set by ConfigManager during merge\n   */\n  lightDomContent?: HTMLElement[];\n  /**\n   * Whether a tool buttons container was found in light DOM.\n   * @internal Set by ConfigManager during merge\n   */\n  hasToolButtonsContainer?: boolean;\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 *\n * The grid does NOT create buttons - developers have full control over their own buttons.\n * Provide either:\n * - `element`: A ready-made DOM element (grid appends it to toolbar)\n * - `render`: A factory function that receives a container and appends content\n *\n * For declarative HTML buttons, use light-dom instead:\n * ```html\n * <tbw-grid>\n *   <tbw-grid-header>\n *     <button slot=\"toolbar\">My Button</button>\n *   </tbw-grid-header>\n * </tbw-grid>\n * ```\n */\nexport interface ToolbarButtonConfig {\n  /** Unique button ID */\n  id: string;\n  /** Tooltip / aria-label (for accessibility, used when grid generates panel toggle) */\n  label?: string;\n  /** Order priority (lower = first, default: 100) */\n  order?: number;\n\n  /**\n   * User-provided element. Grid appends it to the toolbar.\n   * User is responsible for styling, event handlers, accessibility, etc.\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  /** 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// Re-export shared plugin types for convenience\nexport { PLUGIN_QUERIES } from './types';\nexport type {\n  CellClickEvent,\n  CellCoords,\n  CellEditor,\n  CellMouseEvent,\n  CellRenderer,\n  ContextMenuItem,\n  ContextMenuParams,\n  GridElementRef,\n  HeaderClickEvent,\n  HeaderRenderer,\n  KeyboardModifiers,\n  PluginCellRenderContext,\n  PluginQuery,\n  RowClickEvent,\n  ScrollEvent,\n} from './types';\n\nimport type {\n  CellClickEvent,\n  CellEditor,\n  CellMouseEvent,\n  CellRenderer,\n  GridElementRef,\n  HeaderClickEvent,\n  HeaderRenderer,\n  PluginQuery,\n  RowClickEvent,\n  ScrollEvent,\n} from './types';\n\n/**\n * Grid element interface for plugins.\n * Extends GridElementRef with plugin-specific methods.\n */\nexport interface GridElement extends GridElementRef {\n  getPlugin<T extends BaseGridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined;\n  getPluginByName(name: string): BaseGridPlugin | undefined;\n  /**\n   * Get a plugin's state by plugin name.\n   * This is a loose-coupling method for plugins to access other plugins' state\n   * without importing the plugin class directly.\n   * @internal Plugin API\n   */\n  getPluginState?(name: string): unknown;\n}\n\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 * 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   * Plugin-level AbortController for event listener cleanup.\n   * Created fresh in attach(), aborted in detach().\n   * This ensures event listeners are properly cleaned up when plugins are re-attached.\n   */\n  #abortController?: AbortController;\n\n  /**\n   * Default configuration - subclasses should override this getter.\n   * Note: This must be a getter (not property initializer) for proper inheritance\n   * since property initializers run after parent constructor.\n   */\n  protected get defaultConfig(): Partial<TConfig> {\n    return {};\n  }\n\n  constructor(config: Partial<TConfig> = {}) {\n    this.userConfig = config;\n  }\n\n  /**\n   * Called when the plugin is attached to a grid.\n   * Override to set up event listeners, initialize state, etc.\n   *\n   * @example\n   * ```ts\n   * attach(grid: GridElement): void {\n   *   super.attach(grid);\n   *   // Set up document-level listeners with auto-cleanup\n   *   document.addEventListener('keydown', this.handleEscape, {\n   *     signal: this.disconnectSignal\n   *   });\n   * }\n   * ```\n   */\n  attach(grid: GridElement): void {\n    // Abort any previous abort controller (in case of re-attach without detach)\n    this.#abortController?.abort();\n    // Create fresh abort controller for this attachment\n    this.#abortController = new AbortController();\n\n    this.grid = grid;\n    // Merge config here (after subclass construction is complete)\n    this.config = { ...this.defaultConfig, ...this.userConfig } as TConfig;\n  }\n\n  /**\n   * Called when the plugin is detached from a grid.\n   * Override to clean up event listeners, timers, etc.\n   *\n   * @example\n   * ```ts\n   * detach(): void {\n   *   // Clean up any state not handled by disconnectSignal\n   *   this.selectedRows.clear();\n   *   this.cache = null;\n   * }\n   * ```\n   */\n  detach(): void {\n    // Abort the plugin's abort controller to clean up all event listeners\n    // registered with { signal: this.disconnectSignal }\n    this.#abortController?.abort();\n    this.#abortController = undefined;\n    // Override in subclass for additional cleanup\n  }\n\n  /**\n   * Called when another plugin is attached to the same grid.\n   * Use for inter-plugin coordination, e.g., to integrate with new plugins.\n   *\n   * @param name - The name of the plugin that was attached\n   * @param plugin - The plugin instance (for direct access if needed)\n   *\n   * @example\n   * ```ts\n   * onPluginAttached(name: string, plugin: BaseGridPlugin): void {\n   *   if (name === 'selection') {\n   *     // Integrate with selection plugin\n   *     this.selectionPlugin = plugin as SelectionPlugin;\n   *   }\n   * }\n   * ```\n   */\n  onPluginAttached?(name: string, plugin: BaseGridPlugin): void;\n\n  /**\n   * Called when another plugin is detached from the same grid.\n   * Use to clean up inter-plugin references.\n   *\n   * @param name - The name of the plugin that was detached\n   *\n   * @example\n   * ```ts\n   * onPluginDetached(name: string): void {\n   *   if (name === 'selection') {\n   *     this.selectionPlugin = undefined;\n   *   }\n   * }\n   * ```\n   */\n  onPluginDetached?(name: string): void;\n\n  /**\n   * Get another plugin instance from the same grid.\n   * Use for inter-plugin communication.\n   *\n   * @example\n   * ```ts\n   * const selection = this.getPlugin(SelectionPlugin);\n   * if (selection) {\n   *   const selectedRows = selection.getSelectedRows();\n   * }\n   * ```\n   */\n  protected getPlugin<T extends BaseGridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined {\n    return this.grid?.getPlugin(PluginClass);\n  }\n\n  /**\n   * Emit a custom event from the grid.\n   */\n  protected emit<T>(eventName: string, detail: T): void {\n    this.grid?.dispatchEvent?.(new CustomEvent(eventName, { detail, bubbles: true }));\n  }\n\n  /**\n   * 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?.sourceRows ?? [];\n  }\n\n  /**\n   * Get the current columns from the grid.\n   */\n  protected get columns(): ColumnConfig[] {\n    return this.grid?.columns ?? [];\n  }\n\n  /**\n   * Get only visible columns from the grid (excludes hidden).\n   * Use this for rendering that needs to match the grid template.\n   */\n  protected get visibleColumns(): ColumnConfig[] {\n    return this.grid?._visibleColumns ?? [];\n  }\n\n  /**\n   * Get the 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 the plugin's own abort signal for proper cleanup on detach/re-attach\n    // Falls back to grid's signal if plugin's controller not yet created\n    return this.#abortController?.signal ?? this.grid?.disconnectSignal;\n  }\n\n  /**\n   * Get the grid-level icons configuration.\n   * Returns merged icons (user config + defaults).\n   */\n  protected get gridIcons(): 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 * Column Virtualization Core Logic\n *\n * Pure functions for horizontal column virtualization operations.\n */\n\nimport type { ColumnConfig } from '../../core/types';\nimport type { ColumnVirtualizationViewport } from './types';\n\n/** Default column width when not specified */\nconst DEFAULT_COLUMN_WIDTH = 100;\n\n/**\n * Parse a column width value to pixels.\n * Handles number (px) and string formats.\n *\n * @param width - The width value from column config\n * @returns Width in pixels\n */\nexport function parseColumnWidth(width: string | number | undefined): number {\n  if (width === undefined || width === null) {\n    return DEFAULT_COLUMN_WIDTH;\n  }\n\n  if (typeof width === 'number') {\n    return width;\n  }\n\n  // Handle string values - extract numeric part\n  const numeric = parseFloat(width);\n  if (!isNaN(numeric)) {\n    return numeric;\n  }\n\n  return DEFAULT_COLUMN_WIDTH;\n}\n\n/**\n * Get array of column widths in pixels.\n *\n * @param columns - Column configurations\n * @returns Array of widths in pixels\n */\nexport function getColumnWidths(columns: readonly ColumnConfig[]): number[] {\n  return columns.map((col) => parseColumnWidth(col.width));\n}\n\n/**\n * Compute cumulative left offsets for each column.\n *\n * @param columns - Column configurations\n * @returns Array of left offsets in pixels\n */\nexport function computeColumnOffsets(columns: readonly ColumnConfig[]): number[] {\n  const offsets: number[] = [];\n  let offset = 0;\n\n  for (const col of columns) {\n    offsets.push(offset);\n    offset += parseColumnWidth(col.width);\n  }\n\n  return offsets;\n}\n\n/**\n * Compute total width of all columns.\n *\n * @param columns - Column configurations\n * @returns Total width in pixels\n */\nexport function computeTotalWidth(columns: readonly ColumnConfig[]): number {\n  return columns.reduce((sum, col) => sum + parseColumnWidth(col.width), 0);\n}\n\n/**\n * Find the visible column range based on scroll position.\n * Uses binary search for efficient lookup in large column sets.\n *\n * @param scrollLeft - Current horizontal scroll position\n * @param viewportWidth - Width of the visible viewport\n * @param columnOffsets - Array of column left offsets\n * @param columnWidths - Array of column widths\n * @param overscan - Number of extra columns to render on each side\n * @returns Viewport information with visible column indices\n */\nexport function getVisibleColumnRange(\n  scrollLeft: number,\n  viewportWidth: number,\n  columnOffsets: number[],\n  columnWidths: number[],\n  overscan: number\n): ColumnVirtualizationViewport {\n  const columnCount = columnOffsets.length;\n\n  if (columnCount === 0) {\n    return { startCol: 0, endCol: 0, visibleColumns: [] };\n  }\n\n  // Binary search for first visible column\n  let startCol = binarySearchFirstVisible(scrollLeft, columnOffsets, columnWidths);\n  startCol = Math.max(0, startCol - overscan);\n\n  // Find last visible column (without overscan first)\n  const rightEdge = scrollLeft + viewportWidth;\n  let endCol = startCol;\n\n  for (let i = startCol; i < columnCount; i++) {\n    if (columnOffsets[i] >= rightEdge) {\n      endCol = i - 1;\n      break;\n    }\n    endCol = i;\n  }\n\n  // Apply overscan to end (only once)\n  endCol = Math.min(columnCount - 1, endCol + overscan);\n\n  // Build array of visible column indices\n  const visibleColumns: number[] = [];\n  for (let i = startCol; i <= endCol; i++) {\n    visibleColumns.push(i);\n  }\n\n  return { startCol, endCol, visibleColumns };\n}\n\n/**\n * Binary search to find the first column that is visible.\n *\n * @param scrollLeft - Current scroll position\n * @param columnOffsets - Array of column offsets\n * @param columnWidths - Array of column widths\n * @returns Index of first visible column\n */\nfunction binarySearchFirstVisible(scrollLeft: number, columnOffsets: number[], columnWidths: number[]): number {\n  let low = 0;\n  let high = columnOffsets.length - 1;\n\n  while (low < high) {\n    const mid = Math.floor((low + high) / 2);\n    const colRight = columnOffsets[mid] + columnWidths[mid];\n\n    if (colRight <= scrollLeft) {\n      low = mid + 1;\n    } else {\n      high = mid;\n    }\n  }\n\n  return low;\n}\n\n/**\n * Determine if column virtualization should be active.\n *\n * @param columnCount - Number of columns\n * @param threshold - Column count threshold\n * @param autoEnable - Whether auto-enable is configured\n * @returns True if virtualization should be active\n */\nexport function shouldVirtualize(columnCount: number, threshold: number, autoEnable: boolean): boolean {\n  if (!autoEnable) return false;\n  return columnCount > threshold;\n}\n","/**\n * Column Virtualization Plugin (Class-based)\n *\n * Provides horizontal column virtualization for grids with many columns.\n * Significantly improves rendering performance when dealing with >30 columns.\n */\n\nimport { BaseGridPlugin, ScrollEvent } from '../../core/plugin/base-plugin';\nimport type { ColumnConfig } from '../../core/types';\nimport {\n  computeColumnOffsets,\n  computeTotalWidth,\n  getColumnWidths,\n  getVisibleColumnRange,\n  shouldVirtualize,\n} from './column-virtualization';\nimport type { ColumnVirtualizationConfig } from './types';\n\n/**\n * Column Virtualization Plugin for tbw-grid\n *\n * @example\n * ```ts\n * new ColumnVirtualizationPlugin({ threshold: 30, overscan: 3 })\n * ```\n */\nexport class ColumnVirtualizationPlugin extends BaseGridPlugin<ColumnVirtualizationConfig> {\n  readonly name = 'columnVirtualization';\n  override readonly version = '1.0.0';\n\n  protected override get defaultConfig(): Partial<ColumnVirtualizationConfig> {\n    return {\n      autoEnable: true,\n      threshold: 30,\n      overscan: 3,\n    };\n  }\n\n  // #region Internal State\n  private isVirtualized = false;\n  private startCol = 0;\n  private endCol = 0;\n  private scrollLeft = 0;\n  private totalWidth = 0;\n  private columnWidths: number[] = [];\n  private columnOffsets: number[] = [];\n  // #endregion\n\n  // #region Lifecycle\n\n  override attach(grid: import('../../core/plugin/base-plugin').GridElement): void {\n    super.attach(grid);\n\n    // Initialize state from current columns\n    const columns = this.columns;\n    this.columnWidths = getColumnWidths(columns);\n    this.columnOffsets = computeColumnOffsets(columns);\n    this.totalWidth = computeTotalWidth(columns);\n    this.endCol = columns.length - 1;\n  }\n\n  override detach(): void {\n    this.columnWidths = [];\n    this.columnOffsets = [];\n    this.isVirtualized = false;\n    this.startCol = 0;\n    this.endCol = 0;\n    this.scrollLeft = 0;\n    this.totalWidth = 0;\n  }\n  // #endregion\n\n  // #region Hooks\n\n  override processColumns(columns: readonly ColumnConfig[]): ColumnConfig[] {\n    const isVirtualized = shouldVirtualize(columns.length, this.config.threshold ?? 30, this.config.autoEnable ?? true);\n\n    // Update state with current column metrics\n    this.isVirtualized = isVirtualized ?? false;\n    this.columnWidths = getColumnWidths(columns);\n    this.columnOffsets = computeColumnOffsets(columns);\n    this.totalWidth = computeTotalWidth(columns);\n\n    if (!isVirtualized) {\n      this.startCol = 0;\n      this.endCol = columns.length - 1;\n      return [...columns];\n    }\n\n    // Get viewport width from grid element\n    const viewportWidth = (this.grid as unknown as HTMLElement).clientWidth || 800;\n    const viewport = getVisibleColumnRange(\n      this.scrollLeft,\n      viewportWidth,\n      this.columnOffsets,\n      this.columnWidths,\n      this.config.overscan ?? 3,\n    );\n\n    this.startCol = viewport.startCol;\n    this.endCol = viewport.endCol;\n\n    // Return only visible columns\n    return viewport.visibleColumns.map((i) => columns[i]);\n  }\n\n  override afterRender(): void {\n    if (!this.isVirtualized) return;\n\n    const shadowRoot = this.shadowRoot;\n    if (!shadowRoot) return;\n\n    // Apply left padding to offset scrolled-out columns\n    const leftPadding = this.columnOffsets[this.startCol] ?? 0;\n\n    const headerRow = shadowRoot.querySelector('.header-row');\n    const bodyRows = shadowRoot.querySelectorAll('.data-grid-row');\n\n    if (headerRow) {\n      (headerRow as HTMLElement).style.paddingLeft = `${leftPadding}px`;\n    }\n\n    bodyRows.forEach((row) => {\n      (row as HTMLElement).style.paddingLeft = `${leftPadding}px`;\n    });\n\n    // Set total width for horizontal scrolling on the rows container\n    const rowsContainer = shadowRoot.querySelector('.rows-viewport .rows');\n    if (rowsContainer) {\n      (rowsContainer as HTMLElement).style.width = `${this.totalWidth}px`;\n    }\n  }\n\n  override onScroll(event: ScrollEvent): void {\n    if (!this.isVirtualized) return;\n\n    // Check if horizontal scroll position changed significantly\n    const scrollDelta = Math.abs(event.scrollLeft - this.scrollLeft);\n    if (scrollDelta < 1) return;\n\n    // Update scroll position\n    this.scrollLeft = event.scrollLeft;\n\n    // Recalculate visible columns and request re-render\n    this.requestRender();\n  }\n  // #endregion\n\n  // #region Public API\n\n  /**\n   * Check if column virtualization is currently active.\n   */\n  getIsVirtualized(): boolean {\n    return this.isVirtualized;\n  }\n\n  /**\n   * Get the current visible column range.\n   */\n  getVisibleColumnRange(): { start: number; end: number } {\n    return { start: this.startCol, end: this.endCol };\n  }\n\n  /**\n   * Scroll the grid to bring a specific column into view.\n   * @param columnIndex - Index of the column to scroll to\n   */\n  scrollToColumn(columnIndex: number): void {\n    const offset = this.columnOffsets[columnIndex] ?? 0;\n    const gridEl = this.grid as unknown as HTMLElement;\n    // Scroll the grid element itself (it's the scroll container)\n    gridEl.scrollLeft = offset;\n  }\n\n  /**\n   * Get the left offset for a specific column.\n   * @param columnIndex - Index of the column\n   */\n  getColumnOffset(columnIndex: number): number {\n    return this.columnOffsets[columnIndex] ?? 0;\n  }\n\n  /**\n   * Get the total width of all columns.\n   */\n  getTotalWidth(): number {\n    return this.totalWidth;\n  }\n  // #endregion\n}\n"],"names":["DEFAULT_GRID_ICONS","BaseGridPlugin","#abortController","config","grid","PluginClass","eventName","detail","userIcons","iconKey","pluginOverride","element","icon","message","DEFAULT_COLUMN_WIDTH","parseColumnWidth","width","numeric","getColumnWidths","columns","col","computeColumnOffsets","offsets","offset","computeTotalWidth","sum","getVisibleColumnRange","scrollLeft","viewportWidth","columnOffsets","columnWidths","overscan","columnCount","startCol","binarySearchFirstVisible","rightEdge","endCol","i","visibleColumns","low","high","mid","shouldVirtualize","threshold","autoEnable","ColumnVirtualizationPlugin","isVirtualized","viewport","shadowRoot","leftPadding","headerRow","bodyRows","row","rowsContainer","event","columnIndex","gridEl"],"mappings":"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"}