@toolbox-web/grid 0.0.1

package/lib/plugins/context-menu/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../../../libs/grid/src/lib/core/plugin/base-plugin.ts","../../../../../../libs/grid/src/lib/plugins/context-menu/menu.ts","../../../../../../libs/grid/src/lib/plugins/context-menu/ContextMenuPlugin.ts"],"sourcesContent":["/**\r\n * Base Grid Plugin Class\r\n *\r\n * All plugins extend this abstract class.\r\n * Plugins are instantiated per-grid and manage their own state.\r\n */\r\n\r\nimport type { ColumnConfig, ColumnState, HeaderContentDefinition, ToolPanelDefinition } from '../types';\r\n\r\n// Forward declare to avoid circular imports\r\nexport interface GridElement {\r\n  shadowRoot: ShadowRoot | null;\r\n  rows: any[];\r\n  columns: ColumnConfig[];\r\n  gridConfig: any;\r\n  requestRender(): void;\r\n  requestAfterRender(): void;\r\n  forceLayout(): Promise<void>;\r\n  getPlugin<T extends BaseGridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined;\r\n  getPluginByName(name: string): BaseGridPlugin | undefined;\r\n  dispatchEvent(event: Event): boolean;\r\n}\r\n\r\n/**\r\n * Keyboard modifier flags\r\n */\r\nexport interface KeyboardModifiers {\r\n  ctrl?: boolean;\r\n  shift?: boolean;\r\n  alt?: boolean;\r\n  meta?: boolean;\r\n}\r\n\r\n/**\r\n * Cell coordinates\r\n */\r\nexport interface CellCoords {\r\n  row: number;\r\n  col: number;\r\n}\r\n\r\n/**\r\n * Cell click event\r\n */\r\nexport interface CellClickEvent {\r\n  rowIndex: number;\r\n  colIndex: number;\r\n  field: string;\r\n  value: any;\r\n  row: any;\r\n  cellEl: HTMLElement;\r\n  originalEvent: MouseEvent;\r\n}\r\n\r\n/**\r\n * Row click event\r\n */\r\nexport interface RowClickEvent {\r\n  rowIndex: number;\r\n  row: any;\r\n  rowEl: HTMLElement;\r\n  originalEvent: MouseEvent;\r\n}\r\n\r\n/**\r\n * Header click event\r\n */\r\nexport interface HeaderClickEvent {\r\n  colIndex: number;\r\n  field: string;\r\n  column: ColumnConfig;\r\n  headerEl: HTMLElement;\r\n  originalEvent: MouseEvent;\r\n}\r\n\r\n/**\r\n * Scroll event\r\n */\r\nexport interface ScrollEvent {\r\n  scrollTop: number;\r\n  scrollLeft: number;\r\n  scrollHeight: number;\r\n  scrollWidth: number;\r\n  clientHeight: number;\r\n  clientWidth: number;\r\n  originalEvent?: Event;\r\n}\r\n\r\n/**\r\n * Cell mouse event (for drag operations, selection, etc.)\r\n */\r\nexport interface CellMouseEvent {\r\n  /** Event type: mousedown, mousemove, or mouseup */\r\n  type: 'mousedown' | 'mousemove' | 'mouseup';\r\n  /** Row index, undefined if not over a data cell */\r\n  rowIndex?: number;\r\n  /** Column index, undefined if not over a cell */\r\n  colIndex?: number;\r\n  /** Field name, undefined if not over a cell */\r\n  field?: string;\r\n  /** Cell value, undefined if not over a data cell */\r\n  value?: unknown;\r\n  /** Row data object, undefined if not over a data row */\r\n  row?: unknown;\r\n  /** Column configuration, undefined if not over a column */\r\n  column?: ColumnConfig;\r\n  /** The cell element, undefined if not over a cell */\r\n  cellElement?: HTMLElement;\r\n  /** The row element, undefined if not over a row */\r\n  rowElement?: HTMLElement;\r\n  /** Whether the event is over a header cell */\r\n  isHeader: boolean;\r\n  /** Cell coordinates if over a valid data cell */\r\n  cell?: CellCoords;\r\n  /** The original mouse event */\r\n  originalEvent: MouseEvent;\r\n}\r\n\r\n/**\r\n * Context menu parameters\r\n */\r\nexport interface ContextMenuParams {\r\n  x: number;\r\n  y: number;\r\n  rowIndex?: number;\r\n  colIndex?: number;\r\n  field?: string;\r\n  value?: any;\r\n  row?: any;\r\n  column?: ColumnConfig;\r\n  isHeader?: boolean;\r\n}\r\n\r\n/**\r\n * Context menu item\r\n */\r\nexport interface ContextMenuItem {\r\n  id: string;\r\n  label: string;\r\n  icon?: string;\r\n  disabled?: boolean;\r\n  separator?: boolean;\r\n  children?: ContextMenuItem[];\r\n  action?: (params: ContextMenuParams) => void;\r\n}\r\n\r\n/**\r\n * Cell render context for plugin cell renderers.\r\n * Provides full context including position and editing state.\r\n *\r\n * Note: This differs from the core `CellRenderContext` in types.ts which is\r\n * simpler and used for column view renderers. This version provides additional\r\n * context needed by plugins that register custom cell renderers.\r\n */\r\nexport interface PluginCellRenderContext {\r\n  /** The cell value */\r\n  value: any;\r\n  /** The field/column key */\r\n  field: string;\r\n  /** The row data object */\r\n  row: any;\r\n  /** Row index in the data array */\r\n  rowIndex: number;\r\n  /** Column index */\r\n  colIndex: number;\r\n  /** Column configuration */\r\n  column: ColumnConfig;\r\n  /** Whether the cell is currently in edit mode */\r\n  isEditing: boolean;\r\n}\r\n\r\n/**\r\n * Header render context for plugin header renderers.\r\n */\r\nexport interface PluginHeaderRenderContext {\r\n  /** Column configuration */\r\n  column: ColumnConfig;\r\n  /** Column index */\r\n  colIndex: number;\r\n}\r\n\r\n/**\r\n * Cell renderer function type for plugins.\r\n */\r\nexport type CellRenderer = (ctx: PluginCellRenderContext) => string | HTMLElement;\r\n\r\n/**\r\n * Header renderer function type for plugins.\r\n */\r\nexport type HeaderRenderer = (ctx: PluginHeaderRenderContext) => string | HTMLElement;\r\n\r\n/**\r\n * Cell editor interface for plugins.\r\n */\r\nexport interface CellEditor {\r\n  create(ctx: PluginCellRenderContext, commitFn: (value: any) => void, cancelFn: () => void): HTMLElement;\r\n  getValue?(element: HTMLElement): any;\r\n  focus?(element: HTMLElement): void;\r\n}\r\n\r\n/**\r\n * Abstract base class for all grid plugins.\r\n *\r\n * @template TConfig - Configuration type for the plugin\r\n */\r\nexport abstract class BaseGridPlugin<TConfig = unknown> {\r\n  /** Unique plugin identifier (derived from class name by default) */\r\n  abstract readonly name: string;\r\n\r\n  /** Plugin version - override in subclass if needed */\r\n  readonly version: string = '1.0.0';\r\n\r\n  /** CSS styles to inject into the grid's shadow DOM */\r\n  readonly styles?: string;\r\n\r\n  /** Custom cell renderers keyed by type name */\r\n  readonly cellRenderers?: Record<string, CellRenderer>;\r\n\r\n  /** Custom header renderers keyed by type name */\r\n  readonly headerRenderers?: Record<string, HeaderRenderer>;\r\n\r\n  /** Custom cell editors keyed by type name */\r\n  readonly cellEditors?: Record<string, CellEditor>;\r\n\r\n  /** The grid instance this plugin is attached to */\r\n  protected grid!: GridElement;\r\n\r\n  /** Plugin configuration - merged with defaults in attach() */\r\n  protected config!: TConfig;\r\n\r\n  /** User-provided configuration from constructor */\r\n  private readonly userConfig: Partial<TConfig>;\r\n\r\n  /**\r\n   * Default configuration - subclasses should override this getter.\r\n   * Note: This must be a getter (not property initializer) for proper inheritance\r\n   * since property initializers run after parent constructor.\r\n   */\r\n  protected get defaultConfig(): Partial<TConfig> {\r\n    return {};\r\n  }\r\n\r\n  constructor(config: Partial<TConfig> = {}) {\r\n    this.userConfig = config;\r\n  }\r\n\r\n  /**\r\n   * Called when the plugin is attached to a grid.\r\n   * Override to set up event listeners, initialize state, etc.\r\n   */\r\n  attach(grid: GridElement): void {\r\n    this.grid = grid;\r\n    // Merge config here (after subclass construction is complete)\r\n    this.config = { ...this.defaultConfig, ...this.userConfig } as TConfig;\r\n  }\r\n\r\n  /**\r\n   * Called when the plugin is detached from a grid.\r\n   * Override to clean up event listeners, timers, etc.\r\n   */\r\n  detach(): void {\r\n    // Override in subclass\r\n  }\r\n\r\n  /**\r\n   * Get another plugin instance from the same grid.\r\n   * Use for inter-plugin communication.\r\n   */\r\n  protected getPlugin<T extends BaseGridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined {\r\n    return this.grid?.getPlugin(PluginClass);\r\n  }\r\n\r\n  /**\r\n   * Emit a custom event from the grid.\r\n   */\r\n  protected emit<T>(eventName: string, detail: T): void {\r\n    this.grid?.dispatchEvent?.(new CustomEvent(eventName, { detail, bubbles: true }));\r\n  }\r\n\r\n  /**\r\n   * Request a re-render of the grid.\r\n   */\r\n  protected requestRender(): void {\r\n    this.grid?.requestRender?.();\r\n  }\r\n\r\n  /**\r\n   * Request a lightweight style update without rebuilding DOM.\r\n   * Use this instead of requestRender() when only CSS classes need updating.\r\n   */\r\n  protected requestAfterRender(): void {\r\n    this.grid?.requestAfterRender?.();\r\n  }\r\n\r\n  /**\r\n   * Get the current rows from the grid.\r\n   */\r\n  protected get rows(): any[] {\r\n    return this.grid?.rows ?? [];\r\n  }\r\n\r\n  /**\r\n   * Get the original unfiltered/unprocessed rows from the grid.\r\n   * Use this when you need all source data regardless of active filters.\r\n   */\r\n  protected get sourceRows(): any[] {\r\n    return (this.grid as any)?.sourceRows ?? [];\r\n  }\r\n\r\n  /**\r\n   * Get the current columns from the grid.\r\n   */\r\n  protected get columns(): ColumnConfig[] {\r\n    return this.grid?.columns ?? [];\r\n  }\r\n\r\n  /**\r\n   * Get only visible columns from the grid (excludes hidden).\r\n   * Use this for rendering that needs to match the grid template.\r\n   */\r\n  protected get visibleColumns(): ColumnConfig[] {\r\n    return (this.grid as any)?.visibleColumns ?? [];\r\n  }\r\n\r\n  /**\r\n   * Get the shadow root of the grid.\r\n   */\r\n  protected get shadowRoot(): ShadowRoot | null {\r\n    return this.grid?.shadowRoot ?? null;\r\n  }\r\n\r\n  /**\r\n   * Log a warning message.\r\n   */\r\n  protected warn(message: string): void {\r\n    console.warn(`[tbw-grid:${this.name}] ${message}`);\r\n  }\r\n\r\n  // ===== Lifecycle Hooks (override as needed) =====\r\n\r\n  /**\r\n   * Transform rows before rendering.\r\n   * Called during each render cycle before rows are rendered to the DOM.\r\n   * Use this to filter, sort, or add computed properties to rows.\r\n   *\r\n   * @param rows - The current rows array (readonly to encourage returning a new array)\r\n   * @returns The modified rows array to render\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * processRows(rows: readonly any[]): any[] {\r\n   *   // Filter out hidden rows\r\n   *   return rows.filter(row => !row._hidden);\r\n   * }\r\n   * ```\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * processRows(rows: readonly any[]): any[] {\r\n   *   // Add computed properties\r\n   *   return rows.map(row => ({\r\n   *     ...row,\r\n   *     _fullName: `${row.firstName} ${row.lastName}`\r\n   *   }));\r\n   * }\r\n   * ```\r\n   */\r\n  processRows?(rows: readonly any[]): any[];\r\n\r\n  /**\r\n   * Transform columns before rendering.\r\n   * Called during each render cycle before column headers and cells are rendered.\r\n   * Use this to add, remove, or modify column definitions.\r\n   *\r\n   * @param columns - The current columns array (readonly to encourage returning a new array)\r\n   * @returns The modified columns array to render\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * processColumns(columns: readonly ColumnConfig[]): ColumnConfig[] {\r\n   *   // Add a selection checkbox column\r\n   *   return [\r\n   *     { field: '_select', header: '', width: 40 },\r\n   *     ...columns\r\n   *   ];\r\n   * }\r\n   * ```\r\n   */\r\n  processColumns?(columns: readonly ColumnConfig[]): ColumnConfig[];\r\n\r\n  /**\r\n   * Called before each render cycle begins.\r\n   * Use this to prepare state or cache values needed during rendering.\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * beforeRender(): void {\r\n   *   this.visibleRowCount = this.calculateVisibleRows();\r\n   * }\r\n   * ```\r\n   */\r\n  beforeRender?(): void;\r\n\r\n  /**\r\n   * Called after each render cycle completes.\r\n   * Use this for DOM manipulation, adding event listeners to rendered elements,\r\n   * or applying visual effects like selection highlights.\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * afterRender(): void {\r\n   *   // Apply selection styling to rendered rows\r\n   *   const rows = this.shadowRoot?.querySelectorAll('.data-row');\r\n   *   rows?.forEach((row, i) => {\r\n   *     row.classList.toggle('selected', this.selectedRows.has(i));\r\n   *   });\r\n   * }\r\n   * ```\r\n   */\r\n  afterRender?(): void;\r\n\r\n  /**\r\n   * Render a custom row, bypassing the default row rendering.\r\n   * Use this for special row types like group headers, detail rows, or footers.\r\n   *\r\n   * @param row - The row data object\r\n   * @param rowEl - The row DOM element to render into\r\n   * @param rowIndex - The index of the row in the data array\r\n   * @returns `true` if the plugin handled rendering (prevents default), `false`/`void` for default rendering\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * renderRow(row: any, rowEl: HTMLElement, rowIndex: number): boolean | void {\r\n   *   if (row._isGroupHeader) {\r\n   *     rowEl.innerHTML = `<div class=\"group-header\">${row._groupLabel}</div>`;\r\n   *     return true; // Handled - skip default rendering\r\n   *   }\r\n   *   // Return void to let default rendering proceed\r\n   * }\r\n   * ```\r\n   */\r\n  renderRow?(row: any, rowEl: HTMLElement, rowIndex: number): boolean | void;\r\n\r\n  // ===== Interaction Hooks (override as needed) =====\r\n\r\n  /**\r\n   * Handle keyboard events on the grid.\r\n   * Called when a key is pressed while the grid or a cell has focus.\r\n   *\r\n   * @param event - The native KeyboardEvent\r\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * onKeyDown(event: KeyboardEvent): boolean | void {\r\n   *   // Handle Ctrl+A for select all\r\n   *   if (event.ctrlKey && event.key === 'a') {\r\n   *     this.selectAllRows();\r\n   *     return true; // Prevent default browser select-all\r\n   *   }\r\n   * }\r\n   * ```\r\n   */\r\n  onKeyDown?(event: KeyboardEvent): boolean | void;\r\n\r\n  /**\r\n   * Handle cell click events.\r\n   * Called when a data cell is clicked (not headers).\r\n   *\r\n   * @param event - Cell click event with row/column context\r\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * onCellClick(event: CellClickEvent): boolean | void {\r\n   *   if (event.field === '_select') {\r\n   *     this.toggleRowSelection(event.rowIndex);\r\n   *     return true; // Handled\r\n   *   }\r\n   * }\r\n   * ```\r\n   */\r\n  onCellClick?(event: CellClickEvent): boolean | void;\r\n\r\n  /**\r\n   * Handle row click events.\r\n   * Called when any part of a data row is clicked.\r\n   * Note: This is called in addition to onCellClick, not instead of.\r\n   *\r\n   * @param event - Row click event with row context\r\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * onRowClick(event: RowClickEvent): boolean | void {\r\n   *   if (this.config.mode === 'row') {\r\n   *     this.selectRow(event.rowIndex, event.originalEvent);\r\n   *     return true;\r\n   *   }\r\n   * }\r\n   * ```\r\n   */\r\n  onRowClick?(event: RowClickEvent): boolean | void;\r\n\r\n  /**\r\n   * Handle header click events.\r\n   * Called when a column header is clicked. Commonly used for sorting.\r\n   *\r\n   * @param event - Header click event with column context\r\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * onHeaderClick(event: HeaderClickEvent): boolean | void {\r\n   *   if (event.column.sortable !== false) {\r\n   *     this.toggleSort(event.field);\r\n   *     return true;\r\n   *   }\r\n   * }\r\n   * ```\r\n   */\r\n  onHeaderClick?(event: HeaderClickEvent): boolean | void;\r\n\r\n  /**\r\n   * Handle scroll events on the grid viewport.\r\n   * Called during scrolling. Note: This may be called frequently; debounce if needed.\r\n   *\r\n   * @param event - Scroll event with scroll position and viewport dimensions\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * onScroll(event: ScrollEvent): void {\r\n   *   // Update sticky column positions\r\n   *   this.updateStickyPositions(event.scrollLeft);\r\n   * }\r\n   * ```\r\n   */\r\n  onScroll?(event: ScrollEvent): void;\r\n\r\n  /**\r\n   * Handle cell mousedown events.\r\n   * Used for initiating drag operations like range selection or column resize.\r\n   *\r\n   * @param event - Mouse event with cell context\r\n   * @returns `true` to indicate drag started (prevents text selection), `false`/`void` otherwise\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * onCellMouseDown(event: CellMouseEvent): boolean | void {\r\n   *   if (event.rowIndex !== undefined && this.config.mode === 'range') {\r\n   *     this.startDragSelection(event.rowIndex, event.colIndex);\r\n   *     return true; // Prevent text selection\r\n   *   }\r\n   * }\r\n   * ```\r\n   */\r\n  onCellMouseDown?(event: CellMouseEvent): boolean | void;\r\n\r\n  /**\r\n   * Handle cell mousemove events during drag operations.\r\n   * Only called when a drag is in progress (after mousedown returned true).\r\n   *\r\n   * @param event - Mouse event with current cell context\r\n   * @returns `true` to continue handling the drag, `false`/`void` otherwise\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * onCellMouseMove(event: CellMouseEvent): boolean | void {\r\n   *   if (this.isDragging && event.rowIndex !== undefined) {\r\n   *     this.extendSelection(event.rowIndex, event.colIndex);\r\n   *     return true;\r\n   *   }\r\n   * }\r\n   * ```\r\n   */\r\n  onCellMouseMove?(event: CellMouseEvent): boolean | void;\r\n\r\n  /**\r\n   * Handle cell mouseup events to end drag operations.\r\n   *\r\n   * @param event - Mouse event with final cell context\r\n   * @returns `true` if drag was finalized, `false`/`void` otherwise\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * onCellMouseUp(event: CellMouseEvent): boolean | void {\r\n   *   if (this.isDragging) {\r\n   *     this.finalizeDragSelection();\r\n   *     this.isDragging = false;\r\n   *     return true;\r\n   *   }\r\n   * }\r\n   * ```\r\n   */\r\n  onCellMouseUp?(event: CellMouseEvent): boolean | void;\r\n\r\n  /**\r\n   * Provide context menu items when right-clicking on the grid.\r\n   * Multiple plugins can contribute items; they are merged into a single menu.\r\n   *\r\n   * @param params - Context about where the menu was triggered (row, column, etc.)\r\n   * @returns Array of menu items to display\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * getContextMenuItems(params: ContextMenuParams): ContextMenuItem[] {\r\n   *   if (params.isHeader) {\r\n   *     return [\r\n   *       { id: 'sort-asc', label: 'Sort Ascending', action: () => this.sortAsc(params.field) },\r\n   *       { id: 'sort-desc', label: 'Sort Descending', action: () => this.sortDesc(params.field) },\r\n   *     ];\r\n   *   }\r\n   *   return [\r\n   *     { id: 'copy', label: 'Copy Cell', action: () => this.copyCell(params) },\r\n   *   ];\r\n   * }\r\n   * ```\r\n   */\r\n  getContextMenuItems?(params: ContextMenuParams): ContextMenuItem[];\r\n\r\n  // ===== Column State Hooks (override as needed) =====\r\n\r\n  /**\r\n   * Contribute plugin-specific state for a column.\r\n   * Called by the grid when collecting column state for serialization.\r\n   * Plugins can add their own properties to the column state.\r\n   *\r\n   * @param field - The field name of the column\r\n   * @returns Partial column state with plugin-specific properties, or undefined if no state to contribute\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * getColumnState(field: string): Partial<ColumnState> | undefined {\r\n   *   const filterModel = this.filterModels.get(field);\r\n   *   if (filterModel) {\r\n   *     // Uses module augmentation to add filter property to ColumnState\r\n   *     return { filter: filterModel } as Partial<ColumnState>;\r\n   *   }\r\n   *   return undefined;\r\n   * }\r\n   * ```\r\n   */\r\n  getColumnState?(field: string): Partial<ColumnState> | undefined;\r\n\r\n  /**\r\n   * Apply plugin-specific state to a column.\r\n   * Called by the grid when restoring column state from serialized data.\r\n   * Plugins should restore their internal state based on the provided state.\r\n   *\r\n   * @param field - The field name of the column\r\n   * @param state - The column state to apply (may contain plugin-specific properties)\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * applyColumnState(field: string, state: ColumnState): void {\r\n   *   // Check for filter property added via module augmentation\r\n   *   const filter = (state as any).filter;\r\n   *   if (filter) {\r\n   *     this.filterModels.set(field, filter);\r\n   *     this.applyFilter();\r\n   *   }\r\n   * }\r\n   * ```\r\n   */\r\n  applyColumnState?(field: string, state: ColumnState): void;\r\n\r\n  // ===== Shell Integration Hooks (override as needed) =====\r\n\r\n  /**\r\n   * Register a tool panel for this plugin.\r\n   * Return undefined if plugin has no tool panel.\r\n   * The shell will create a toolbar toggle button and render the panel content\r\n   * when the user opens the panel.\r\n   *\r\n   * @returns Tool panel definition, or undefined if plugin has no panel\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * getToolPanel(): ToolPanelDefinition | undefined {\r\n   *   return {\r\n   *     id: 'columns',\r\n   *     title: 'Columns',\r\n   *     icon: '☰',\r\n   *     tooltip: 'Show/hide columns',\r\n   *     order: 10,\r\n   *     render: (container) => {\r\n   *       this.renderColumnList(container);\r\n   *       return () => this.cleanup();\r\n   *     },\r\n   *   };\r\n   * }\r\n   * ```\r\n   */\r\n  getToolPanel?(): ToolPanelDefinition | undefined;\r\n\r\n  /**\r\n   * Register content for the shell header center section.\r\n   * Return undefined if plugin has no header content.\r\n   * Examples: search input, selection summary, status indicators.\r\n   *\r\n   * @returns Header content definition, or undefined if plugin has no header content\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * getHeaderContent(): HeaderContentDefinition | undefined {\r\n   *   return {\r\n   *     id: 'quick-filter',\r\n   *     order: 10,\r\n   *     render: (container) => {\r\n   *       const input = document.createElement('input');\r\n   *       input.type = 'text';\r\n   *       input.placeholder = 'Search...';\r\n   *       input.addEventListener('input', this.handleInput);\r\n   *       container.appendChild(input);\r\n   *       return () => input.removeEventListener('input', this.handleInput);\r\n   *     },\r\n   *   };\r\n   * }\r\n   * ```\r\n   */\r\n  getHeaderContent?(): HeaderContentDefinition | undefined;\r\n}\r\n","/**\n * Context Menu Rendering Logic\n *\n * Pure functions for building and positioning context menus.\n */\n\nimport type { ContextMenuItem, ContextMenuParams } from './types';\n\n/**\n * Build the visible menu items by resolving dynamic items and filtering hidden ones.\n *\n * @param items - Menu items configuration (array or factory function)\n * @param params - Context menu parameters for evaluating dynamic properties\n * @returns Filtered array of visible menu items\n */\nexport function buildMenuItems(\n  items: ContextMenuItem[] | ((params: ContextMenuParams) => ContextMenuItem[]),\n  params: ContextMenuParams\n): ContextMenuItem[] {\n  const menuItems = typeof items === 'function' ? items(params) : items;\n\n  return menuItems.filter((item) => {\n    if (item.hidden === true) return false;\n    if (typeof item.hidden === 'function' && item.hidden(params)) return false;\n    return true;\n  });\n}\n\n/**\n * Check if a menu item is disabled.\n *\n * @param item - The menu item to check\n * @param params - Context menu parameters for evaluating dynamic disabled state\n * @returns True if the item is disabled\n */\nexport function isItemDisabled(item: ContextMenuItem, params: ContextMenuParams): boolean {\n  if (item.disabled === true) return true;\n  if (typeof item.disabled === 'function') return item.disabled(params);\n  return false;\n}\n\n/**\n * Create the menu DOM element from a list of menu items.\n *\n * @param items - Array of menu items to render\n * @param params - Context menu parameters for evaluating dynamic properties\n * @param onAction - Callback when a menu item action is triggered\n * @returns The created menu element\n */\nexport function createMenuElement(\n  items: ContextMenuItem[],\n  params: ContextMenuParams,\n  onAction: (item: ContextMenuItem) => void\n): HTMLElement {\n  const menu = document.createElement('div');\n  menu.className = 'tbw-context-menu';\n  menu.setAttribute('role', 'menu');\n\n  for (const item of items) {\n    if (item.separator) {\n      const separator = document.createElement('div');\n      separator.className = 'tbw-context-menu-separator';\n      separator.setAttribute('role', 'separator');\n      menu.appendChild(separator);\n      continue;\n    }\n\n    const menuItem = document.createElement('div');\n    menuItem.className = 'tbw-context-menu-item';\n    if (item.cssClass) menuItem.classList.add(item.cssClass);\n    menuItem.setAttribute('role', 'menuitem');\n    menuItem.setAttribute('data-id', item.id);\n\n    const disabled = isItemDisabled(item, params);\n    if (disabled) {\n      menuItem.classList.add('disabled');\n      menuItem.setAttribute('aria-disabled', 'true');\n    }\n\n    if (item.icon) {\n      const icon = document.createElement('span');\n      icon.className = 'tbw-context-menu-icon';\n      icon.innerHTML = item.icon;\n      menuItem.appendChild(icon);\n    }\n\n    const label = document.createElement('span');\n    label.className = 'tbw-context-menu-label';\n    label.textContent = item.name;\n    menuItem.appendChild(label);\n\n    if (item.shortcut) {\n      const shortcut = document.createElement('span');\n      shortcut.className = 'tbw-context-menu-shortcut';\n      shortcut.textContent = item.shortcut;\n      menuItem.appendChild(shortcut);\n    }\n\n    if (item.subMenu?.length) {\n      const arrow = document.createElement('span');\n      arrow.className = 'tbw-context-menu-arrow';\n      arrow.textContent = '▶';\n      menuItem.appendChild(arrow);\n\n      // Add submenu on hover\n      menuItem.addEventListener('mouseenter', () => {\n        const existingSubMenu = menuItem.querySelector('.tbw-context-menu');\n        if (existingSubMenu) return;\n        if (!item.subMenu) return;\n\n        const subMenuItems = buildMenuItems(item.subMenu, params);\n        const subMenu = createMenuElement(subMenuItems, params, onAction);\n        subMenu.classList.add('tbw-context-submenu');\n        subMenu.style.position = 'absolute';\n        subMenu.style.left = '100%';\n        subMenu.style.top = '0';\n        menuItem.style.position = 'relative';\n        menuItem.appendChild(subMenu);\n      });\n\n      menuItem.addEventListener('mouseleave', () => {\n        const subMenu = menuItem.querySelector('.tbw-context-menu');\n        if (subMenu) subMenu.remove();\n      });\n    }\n\n    if (!disabled && item.action && !item.subMenu) {\n      menuItem.addEventListener('click', (e) => {\n        e.stopPropagation();\n        onAction(item);\n      });\n    }\n\n    menu.appendChild(menuItem);\n  }\n\n  return menu;\n}\n\n/**\n * Position the menu at the given viewport coordinates.\n * Menu is rendered in document.body with fixed positioning for top-layer behavior.\n *\n * @param menu - The menu element to position\n * @param x - Desired X coordinate (viewport)\n * @param y - Desired Y coordinate (viewport)\n */\nexport function positionMenu(menu: HTMLElement, x: number, y: number): void {\n  // Use fixed positioning for top-layer behavior\n  menu.style.position = 'fixed';\n  menu.style.left = `${x}px`;\n  menu.style.top = `${y}px`;\n  menu.style.visibility = 'hidden';\n  menu.style.zIndex = '10000';\n\n  // Force layout to get dimensions\n  const menuRect = menu.getBoundingClientRect();\n\n  // Calculate visible area within viewport\n  const viewportWidth = window.innerWidth;\n  const viewportHeight = window.innerHeight;\n\n  let left = x;\n  let top = y;\n\n  // Check if menu overflows right edge of viewport\n  if (x + menuRect.width > viewportWidth) {\n    left = x - menuRect.width;\n  }\n  // Check if menu overflows bottom edge of viewport\n  if (y + menuRect.height > viewportHeight) {\n    top = y - menuRect.height;\n  }\n\n  // Ensure we don't go negative\n  left = Math.max(0, left);\n  top = Math.max(0, top);\n\n  menu.style.left = `${left}px`;\n  menu.style.top = `${top}px`;\n  menu.style.visibility = 'visible';\n}\n","/**\n * Context Menu Plugin (Class-based)\n *\n * Provides right-click context menu functionality for tbw-grid.\n * Supports custom menu items, submenus, icons, shortcuts, and dynamic item generation.\n */\n\nimport { BaseGridPlugin } from '../../core/plugin/base-plugin';\nimport { buildMenuItems, createMenuElement, positionMenu } from './menu';\nimport type { ContextMenuConfig, ContextMenuItem, ContextMenuParams } from './types';\n\n/** Global click handler reference for cleanup */\nlet globalClickHandler: ((e: Event) => void) | null = null;\n/** Global keydown handler reference for cleanup */\nlet globalKeydownHandler: ((e: KeyboardEvent) => void) | null = null;\n/** Global stylesheet for context menu (injected once) */\nlet globalStyleSheet: HTMLStyleElement | null = null;\n\n/** Context menu styles for light DOM rendering */\nconst contextMenuStyles = `\n  .tbw-context-menu {\n    position: fixed;\n    background: light-dark(#f5f5f5, #2a2a2a);\n    color: light-dark(#222, #eee);\n    border: 1px solid light-dark(#d0d0d4, #454545);\n    border-radius: 4px;\n    box-shadow: 0 2px 10px rgba(0, 0, 0, 0.15);\n    min-width: 160px;\n    padding: 4px 0;\n    z-index: 10000;\n    font-size: 13px;\n    font-family: system-ui, sans-serif;\n  }\n  .tbw-context-menu-item {\n    display: flex;\n    align-items: center;\n    padding: 6px 12px;\n    cursor: pointer;\n    gap: 8px;\n  }\n  .tbw-context-menu-item:hover:not(.disabled) {\n    background: light-dark(#e8e8e8, #3a3a3a);\n  }\n  .tbw-context-menu-item.disabled {\n    opacity: 0.5;\n    cursor: default;\n  }\n  .tbw-context-menu-item.danger {\n    color: light-dark(#c00, #f66);\n  }\n  .tbw-context-menu-icon {\n    width: 16px;\n    text-align: center;\n  }\n  .tbw-context-menu-label {\n    flex: 1;\n  }\n  .tbw-context-menu-shortcut {\n    color: light-dark(#888, #888);\n    font-size: 11px;\n  }\n  .tbw-context-menu-arrow {\n    font-size: 10px;\n    color: light-dark(#888, #888);\n  }\n  .tbw-context-menu-separator {\n    height: 1px;\n    background: light-dark(#d0d0d4, #454545);\n    margin: 4px 0;\n  }\n`;\n\n/** Default menu items when none are configured */\nconst defaultItems: ContextMenuItem[] = [\n  {\n    id: 'copy',\n    name: 'Copy',\n    shortcut: 'Ctrl+C',\n    action: (params) => {\n      const grid = (params as ContextMenuParams & { grid?: { plugins?: { clipboard?: { copy?: () => void } } } }).grid;\n      grid?.plugins?.clipboard?.copy?.();\n    },\n  },\n  { separator: true, id: 'sep1', name: '' },\n  {\n    id: 'export-csv',\n    name: 'Export CSV',\n    action: (params) => {\n      const grid = (params as ContextMenuParams & { grid?: { plugins?: { export?: { exportCsv?: () => void } } } })\n        .grid;\n      grid?.plugins?.export?.exportCsv?.();\n    },\n  },\n];\n\n/**\n * Context Menu Plugin for tbw-grid\n *\n * @example\n * ```ts\n * new ContextMenuPlugin({\n *   enabled: true,\n *   items: [\n *     { id: 'edit', name: 'Edit', action: (params) => console.log('Edit', params) },\n *     { separator: true, id: 'sep', name: '' },\n *     { id: 'delete', name: 'Delete', action: (params) => console.log('Delete', params) },\n *   ],\n * })\n * ```\n */\nexport class ContextMenuPlugin extends BaseGridPlugin<ContextMenuConfig> {\n  readonly name = 'contextMenu';\n  override readonly version = '1.0.0';\n\n  protected override get defaultConfig(): Partial<ContextMenuConfig> {\n    return {\n      enabled: true,\n      items: defaultItems,\n    };\n  }\n\n  // ===== Internal State =====\n  private isOpen = false;\n  private position = { x: 0, y: 0 };\n  private params: ContextMenuParams | null = null;\n  private menuElement: HTMLElement | null = null;\n\n  // ===== Lifecycle =====\n\n  override attach(grid: import('../../core/plugin/base-plugin').GridElement): void {\n    super.attach(grid);\n    this.installGlobalHandlers();\n  }\n\n  override detach(): void {\n    if (this.menuElement) {\n      this.menuElement.remove();\n      this.menuElement = null;\n    }\n    this.isOpen = false;\n    this.params = null;\n  }\n\n  // ===== Private Methods =====\n\n  private installGlobalHandlers(): void {\n    // Inject global stylesheet for context menu (once)\n    if (!globalStyleSheet && typeof document !== 'undefined') {\n      globalStyleSheet = document.createElement('style');\n      globalStyleSheet.id = 'tbw-context-menu-styles';\n      globalStyleSheet.textContent = contextMenuStyles;\n      document.head.appendChild(globalStyleSheet);\n    }\n\n    // Close menu on click outside\n    if (!globalClickHandler) {\n      globalClickHandler = () => {\n        const menus = document.querySelectorAll('.tbw-context-menu');\n        menus.forEach((menu) => menu.remove());\n      };\n      document.addEventListener('click', globalClickHandler);\n    }\n\n    // Close on escape\n    if (!globalKeydownHandler) {\n      globalKeydownHandler = (e: KeyboardEvent) => {\n        if (e.key === 'Escape') {\n          const menus = document.querySelectorAll('.tbw-context-menu');\n          menus.forEach((menu) => menu.remove());\n        }\n      };\n      document.addEventListener('keydown', globalKeydownHandler);\n    }\n  }\n\n  // ===== Hooks =====\n\n  override afterRender(): void {\n    if (!this.config.enabled) return;\n\n    const shadowRoot = this.shadowRoot;\n    if (!shadowRoot) return;\n\n    const container = shadowRoot.children[0];\n    if (!container) return;\n\n    // Check if handler already attached\n    if (container.getAttribute('data-context-menu-bound') === 'true') return;\n    container.setAttribute('data-context-menu-bound', 'true');\n\n    container.addEventListener('contextmenu', (e: Event) => {\n      if (!this.config.enabled) return;\n\n      const event = e as MouseEvent;\n      event.preventDefault();\n\n      const target = event.target as HTMLElement;\n      const cell = target.closest('[data-row][data-col]');\n      const header = target.closest('.header-cell');\n\n      let params: ContextMenuParams;\n\n      if (cell) {\n        const rowIndex = parseInt(cell.getAttribute('data-row') ?? '-1', 10);\n        const colIndex = parseInt(cell.getAttribute('data-col') ?? '-1', 10);\n        const column = this.columns[colIndex];\n        const row = this.rows[rowIndex];\n\n        params = {\n          row,\n          rowIndex,\n          column,\n          columnIndex: colIndex,\n          field: column?.field ?? '',\n          value: row?.[column?.field as keyof typeof row] ?? null,\n          isHeader: false,\n          event,\n        };\n      } else if (header) {\n        const colIndex = parseInt(header.getAttribute('data-col') ?? '-1', 10);\n        const column = this.columns[colIndex];\n\n        params = {\n          row: null,\n          rowIndex: -1,\n          column,\n          columnIndex: colIndex,\n          field: column?.field ?? '',\n          value: null,\n          isHeader: true,\n          event,\n        };\n      } else {\n        return;\n      }\n\n      this.params = params;\n      this.position = { x: event.clientX, y: event.clientY };\n\n      const items = buildMenuItems(this.config.items ?? defaultItems, params);\n      if (!items.length) return;\n\n      if (this.menuElement) {\n        this.menuElement.remove();\n      }\n\n      this.menuElement = createMenuElement(items, params, (item) => {\n        if (item.action) {\n          item.action(params);\n        }\n        this.menuElement?.remove();\n        this.menuElement = null;\n        this.isOpen = false;\n      });\n\n      document.body.appendChild(this.menuElement);\n      positionMenu(this.menuElement, event.clientX, event.clientY);\n      this.isOpen = true;\n\n      this.emit('context-menu-open', { params, items });\n    });\n  }\n\n  // ===== Public API =====\n\n  /**\n   * Programmatically show the context menu at the specified position.\n   * @param x - X coordinate\n   * @param y - Y coordinate\n   * @param params - Partial context menu parameters\n   */\n  showMenu(x: number, y: number, params: Partial<ContextMenuParams>): void {\n    const fullParams: ContextMenuParams = {\n      row: params.row ?? null,\n      rowIndex: params.rowIndex ?? -1,\n      column: params.column ?? null,\n      columnIndex: params.columnIndex ?? -1,\n      field: params.field ?? '',\n      value: params.value ?? null,\n      isHeader: params.isHeader ?? false,\n      event: params.event ?? new MouseEvent('contextmenu'),\n    };\n\n    const items = buildMenuItems(this.config.items ?? defaultItems, fullParams);\n\n    if (this.menuElement) {\n      this.menuElement.remove();\n    }\n\n    this.menuElement = createMenuElement(items, fullParams, (item) => {\n      if (item.action) item.action(fullParams);\n      this.menuElement?.remove();\n      this.menuElement = null;\n      this.isOpen = false;\n    });\n\n    document.body.appendChild(this.menuElement);\n    positionMenu(this.menuElement, x, y);\n    this.isOpen = true;\n  }\n\n  /**\n   * Hide the context menu.\n   */\n  hideMenu(): void {\n    if (this.menuElement) {\n      this.menuElement.remove();\n      this.menuElement = null;\n      this.isOpen = false;\n    }\n  }\n\n  /**\n   * Check if the context menu is currently open.\n   * @returns Whether the menu is open\n   */\n  isMenuOpen(): boolean {\n    return this.isOpen;\n  }\n\n  // Styles are injected globally via installGlobalHandlers() since menu renders in document.body\n}\n"],"names":["BaseGridPlugin","config","grid","PluginClass","eventName","detail","message","buildMenuItems","items","params","item","isItemDisabled","createMenuElement","onAction","menu","separator","menuItem","disabled","icon","label","shortcut","arrow","subMenuItems","subMenu","e","positionMenu","x","y","menuRect","viewportWidth","viewportHeight","left","top","globalClickHandler","globalKeydownHandler","globalStyleSheet","contextMenuStyles","defaultItems","ContextMenuPlugin","shadowRoot","container","event","target","cell","header","rowIndex","colIndex","column","row","fullParams"],"mappings":"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"}

package/lib/plugins/export/index.js

@@ -0,0 +1,305 @@
+class x {
+  /** Plugin version - override in subclass if needed */
+  version = "1.0.0";
+  /** CSS styles to inject into the grid's shadow DOM */
+  styles;
+  /** Custom cell renderers keyed by type name */
+  cellRenderers;
+  /** Custom header renderers keyed by type name */
+  headerRenderers;
+  /** Custom cell editors keyed by type name */
+  cellEditors;
+  /** The grid instance this plugin is attached to */
+  grid;
+  /** Plugin configuration - merged with defaults in attach() */
+  config;
+  /** User-provided configuration from constructor */
+  userConfig;
+  /**
+   * Default configuration - subclasses should override this getter.
+   * Note: This must be a getter (not property initializer) for proper inheritance
+   * since property initializers run after parent constructor.
+   */
+  get defaultConfig() {
+    return {};
+  }
+  constructor(t = {}) {
+    this.userConfig = t;
+  }
+  /**
+   * Called when the plugin is attached to a grid.
+   * Override to set up event listeners, initialize state, etc.
+   */
+  attach(t) {
+    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.
+   */
+  detach() {
+  }
+  /**
+   * Get another plugin instance from the same grid.
+   * Use for inter-plugin communication.
+   */
+  getPlugin(t) {
+    return this.grid?.getPlugin(t);
+  }
+  /**
+   * Emit a custom event from the grid.
+   */
+  emit(t, e) {
+    this.grid?.dispatchEvent?.(new CustomEvent(t, { detail: e, bubbles: !0 }));
+  }
+  /**
+   * Request a re-render of the grid.
+   */
+  requestRender() {
+    this.grid?.requestRender?.();
+  }
+  /**
+   * Request a lightweight style update without rebuilding DOM.
+   * Use this instead of requestRender() when only CSS classes need updating.
+   */
+  requestAfterRender() {
+    this.grid?.requestAfterRender?.();
+  }
+  /**
+   * Get the current rows from the grid.
+   */
+  get rows() {
+    return this.grid?.rows ?? [];
+  }
+  /**
+   * Get the original unfiltered/unprocessed rows from the grid.
+   * Use this when you need all source data regardless of active filters.
+   */
+  get sourceRows() {
+    return this.grid?.sourceRows ?? [];
+  }
+  /**
+   * Get the current columns from the grid.
+   */
+  get columns() {
+    return this.grid?.columns ?? [];
+  }
+  /**
+   * Get only visible columns from the grid (excludes hidden).
+   * Use this for rendering that needs to match the grid template.
+   */
+  get visibleColumns() {
+    return this.grid?.visibleColumns ?? [];
+  }
+  /**
+   * Get the shadow root of the grid.
+   */
+  get shadowRoot() {
+    return this.grid?.shadowRoot ?? null;
+  }
+  /**
+   * Log a warning message.
+   */
+  warn(t) {
+    console.warn(`[tbw-grid:${this.name}] ${t}`);
+  }
+}
+function m(i, t = !0) {
+  if (i == null) return "";
+  if (i instanceof Date) return i.toISOString();
+  if (typeof i == "object") return JSON.stringify(i);
+  const e = String(i);
+  return t && (e.includes(",") || e.includes('"') || e.includes(`
+`) || e.includes("\r")) ? `"${e.replace(/"/g, '""')}"` : e;
+}
+function w(i, t, e, s = {}) {
+  const c = s.delimiter ?? ",", l = s.newline ?? `
+`, n = [], r = s.bom ? "\uFEFF" : "";
+  if (e.includeHeaders !== !1) {
+    const o = t.map((u) => {
+      const d = u.header || u.field, f = e.processHeader ? e.processHeader(d, u.field) : d;
+      return m(f);
+    });
+    n.push(o.join(c));
+  }
+  for (const o of i) {
+    const u = t.map((d) => {
+      let f = o[d.field];
+      return e.processCell && (f = e.processCell(f, d.field, o)), m(f);
+    });
+    n.push(u.join(c));
+  }
+  return r + n.join(l);
+}
+function h(i, t) {
+  const e = URL.createObjectURL(i), s = document.createElement("a");
+  s.href = e, s.download = t, s.style.display = "none", document.body.appendChild(s), s.click(), document.body.removeChild(s), URL.revokeObjectURL(e);
+}
+function C(i, t) {
+  const e = new Blob([i], { type: "text/csv;charset=utf-8;" });
+  h(e, t);
+}
+function b(i) {
+  return i.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function y(i, t, e) {
+  let s = `<?xml version="1.0" encoding="UTF-8"?>
+<?mso-application progid="Excel.Sheet"?>
+<Workbook xmlns="urn:schemas-microsoft-com:office:spreadsheet"
+  xmlns:ss="urn:schemas-microsoft-com:office:spreadsheet">
+<Worksheet ss:Name="Sheet1">
+<Table>`;
+  if (e.includeHeaders !== !1) {
+    s += `
+<Row>`;
+    for (const c of t) {
+      const l = c.header || c.field, n = e.processHeader ? e.processHeader(l, c.field) : l;
+      s += `<Cell><Data ss:Type="String">${b(n)}</Data></Cell>`;
+    }
+    s += "</Row>";
+  }
+  for (const c of i) {
+    s += `
+<Row>`;
+    for (const l of t) {
+      let n = c[l.field];
+      e.processCell && (n = e.processCell(n, l.field, c));
+      let r = "String", o = "";
+      n == null ? o = "" : typeof n == "number" && !isNaN(n) ? (r = "Number", o = String(n)) : n instanceof Date ? (r = "DateTime", o = n.toISOString()) : o = b(String(n)), s += `<Cell><Data ss:Type="${r}">${o}</Data></Cell>`;
+    }
+    s += "</Row>";
+  }
+  return s += `
+</Table>
+</Worksheet>
+</Workbook>`, s;
+}
+function E(i, t) {
+  const e = t.endsWith(".xls") ? t : `${t}.xls`, s = new Blob([i], {
+    type: "application/vnd.ms-excel;charset=utf-8;"
+  });
+  h(s, e);
+}
+class S extends x {
+  name = "export";
+  version = "1.0.0";
+  get defaultConfig() {
+    return {
+      enabled: !0,
+      fileName: "export",
+      includeHeaders: !0,
+      onlyVisible: !0,
+      onlySelected: !1
+    };
+  }
+  // ===== Internal State =====
+  isExportingFlag = !1;
+  lastExportInfo = null;
+  // ===== Private Methods =====
+  performExport(t, e) {
+    const s = this.config, c = {
+      format: t,
+      fileName: e?.fileName ?? s.fileName ?? "export",
+      includeHeaders: e?.includeHeaders ?? s.includeHeaders,
+      processCell: e?.processCell,
+      processHeader: e?.processHeader,
+      columns: e?.columns,
+      rowIndices: e?.rowIndices
+    };
+    let l = [...this.columns];
+    if (s.onlyVisible && (l = l.filter((o) => !o.hidden && !o.field.startsWith("__"))), e?.columns) {
+      const o = new Set(e.columns);
+      l = l.filter((u) => o.has(u.field));
+    }
+    let n = [...this.rows];
+    if (s.onlySelected) {
+      const o = this.getSelectionState();
+      o?.selected?.size && (n = [...o.selected].sort((d, f) => d - f).map((d) => this.rows[d]).filter(Boolean));
+    }
+    e?.rowIndices && (n = e.rowIndices.map((o) => this.rows[o]).filter(Boolean)), this.isExportingFlag = !0;
+    let r = c.fileName;
+    try {
+      switch (t) {
+        case "csv": {
+          const o = w(n, l, c, { bom: !0 });
+          r = r.endsWith(".csv") ? r : `${r}.csv`, C(o, r);
+          break;
+        }
+        case "excel": {
+          const o = y(n, l, c);
+          r = r.endsWith(".xls") ? r : `${r}.xls`, E(o, r);
+          break;
+        }
+        case "json": {
+          const o = n.map((f) => {
+            const p = {};
+            for (const a of l) {
+              let g = f[a.field];
+              c.processCell && (g = c.processCell(g, a.field, f)), p[a.field] = g;
+            }
+            return p;
+          }), u = JSON.stringify(o, null, 2);
+          r = r.endsWith(".json") ? r : `${r}.json`;
+          const d = new Blob([u], { type: "application/json" });
+          h(d, r);
+          break;
+        }
+      }
+      this.lastExportInfo = { format: t, timestamp: /* @__PURE__ */ new Date() }, this.emit("export-complete", {
+        format: t,
+        fileName: r,
+        rowCount: n.length,
+        columnCount: l.length
+      });
+    } finally {
+      this.isExportingFlag = !1;
+    }
+  }
+  getSelectionState() {
+    try {
+      return this.grid?.getPluginState?.("selection") ?? null;
+    } catch {
+      return null;
+    }
+  }
+  // ===== Public API =====
+  /**
+   * Export data to CSV format.
+   * @param params - Optional export parameters
+   */
+  exportCsv(t) {
+    this.performExport("csv", t);
+  }
+  /**
+   * Export data to Excel format (XML Spreadsheet).
+   * @param params - Optional export parameters
+   */
+  exportExcel(t) {
+    this.performExport("excel", t);
+  }
+  /**
+   * Export data to JSON format.
+   * @param params - Optional export parameters
+   */
+  exportJson(t) {
+    this.performExport("json", t);
+  }
+  /**
+   * Check if an export is currently in progress.
+   * @returns Whether export is in progress
+   */
+  isExporting() {
+    return this.isExportingFlag;
+  }
+  /**
+   * Get information about the last export.
+   * @returns Export info or null if no export has occurred
+   */
+  getLastExport() {
+    return this.lastExportInfo;
+  }
+}
+export {
+  S as ExportPlugin
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../../../libs/grid/src/lib/core/plugin/base-plugin.ts","../../../../../../libs/grid/src/lib/plugins/export/csv.ts","../../../../../../libs/grid/src/lib/plugins/export/excel.ts","../../../../../../libs/grid/src/lib/plugins/export/ExportPlugin.ts"],"sourcesContent":["/**\r\n * Base Grid Plugin Class\r\n *\r\n * All plugins extend this abstract class.\r\n * Plugins are instantiated per-grid and manage their own state.\r\n */\r\n\r\nimport type { ColumnConfig, ColumnState, HeaderContentDefinition, ToolPanelDefinition } from '../types';\r\n\r\n// Forward declare to avoid circular imports\r\nexport interface GridElement {\r\n  shadowRoot: ShadowRoot | null;\r\n  rows: any[];\r\n  columns: ColumnConfig[];\r\n  gridConfig: any;\r\n  requestRender(): void;\r\n  requestAfterRender(): void;\r\n  forceLayout(): Promise<void>;\r\n  getPlugin<T extends BaseGridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined;\r\n  getPluginByName(name: string): BaseGridPlugin | undefined;\r\n  dispatchEvent(event: Event): boolean;\r\n}\r\n\r\n/**\r\n * Keyboard modifier flags\r\n */\r\nexport interface KeyboardModifiers {\r\n  ctrl?: boolean;\r\n  shift?: boolean;\r\n  alt?: boolean;\r\n  meta?: boolean;\r\n}\r\n\r\n/**\r\n * Cell coordinates\r\n */\r\nexport interface CellCoords {\r\n  row: number;\r\n  col: number;\r\n}\r\n\r\n/**\r\n * Cell click event\r\n */\r\nexport interface CellClickEvent {\r\n  rowIndex: number;\r\n  colIndex: number;\r\n  field: string;\r\n  value: any;\r\n  row: any;\r\n  cellEl: HTMLElement;\r\n  originalEvent: MouseEvent;\r\n}\r\n\r\n/**\r\n * Row click event\r\n */\r\nexport interface RowClickEvent {\r\n  rowIndex: number;\r\n  row: any;\r\n  rowEl: HTMLElement;\r\n  originalEvent: MouseEvent;\r\n}\r\n\r\n/**\r\n * Header click event\r\n */\r\nexport interface HeaderClickEvent {\r\n  colIndex: number;\r\n  field: string;\r\n  column: ColumnConfig;\r\n  headerEl: HTMLElement;\r\n  originalEvent: MouseEvent;\r\n}\r\n\r\n/**\r\n * Scroll event\r\n */\r\nexport interface ScrollEvent {\r\n  scrollTop: number;\r\n  scrollLeft: number;\r\n  scrollHeight: number;\r\n  scrollWidth: number;\r\n  clientHeight: number;\r\n  clientWidth: number;\r\n  originalEvent?: Event;\r\n}\r\n\r\n/**\r\n * Cell mouse event (for drag operations, selection, etc.)\r\n */\r\nexport interface CellMouseEvent {\r\n  /** Event type: mousedown, mousemove, or mouseup */\r\n  type: 'mousedown' | 'mousemove' | 'mouseup';\r\n  /** Row index, undefined if not over a data cell */\r\n  rowIndex?: number;\r\n  /** Column index, undefined if not over a cell */\r\n  colIndex?: number;\r\n  /** Field name, undefined if not over a cell */\r\n  field?: string;\r\n  /** Cell value, undefined if not over a data cell */\r\n  value?: unknown;\r\n  /** Row data object, undefined if not over a data row */\r\n  row?: unknown;\r\n  /** Column configuration, undefined if not over a column */\r\n  column?: ColumnConfig;\r\n  /** The cell element, undefined if not over a cell */\r\n  cellElement?: HTMLElement;\r\n  /** The row element, undefined if not over a row */\r\n  rowElement?: HTMLElement;\r\n  /** Whether the event is over a header cell */\r\n  isHeader: boolean;\r\n  /** Cell coordinates if over a valid data cell */\r\n  cell?: CellCoords;\r\n  /** The original mouse event */\r\n  originalEvent: MouseEvent;\r\n}\r\n\r\n/**\r\n * Context menu parameters\r\n */\r\nexport interface ContextMenuParams {\r\n  x: number;\r\n  y: number;\r\n  rowIndex?: number;\r\n  colIndex?: number;\r\n  field?: string;\r\n  value?: any;\r\n  row?: any;\r\n  column?: ColumnConfig;\r\n  isHeader?: boolean;\r\n}\r\n\r\n/**\r\n * Context menu item\r\n */\r\nexport interface ContextMenuItem {\r\n  id: string;\r\n  label: string;\r\n  icon?: string;\r\n  disabled?: boolean;\r\n  separator?: boolean;\r\n  children?: ContextMenuItem[];\r\n  action?: (params: ContextMenuParams) => void;\r\n}\r\n\r\n/**\r\n * Cell render context for plugin cell renderers.\r\n * Provides full context including position and editing state.\r\n *\r\n * Note: This differs from the core `CellRenderContext` in types.ts which is\r\n * simpler and used for column view renderers. This version provides additional\r\n * context needed by plugins that register custom cell renderers.\r\n */\r\nexport interface PluginCellRenderContext {\r\n  /** The cell value */\r\n  value: any;\r\n  /** The field/column key */\r\n  field: string;\r\n  /** The row data object */\r\n  row: any;\r\n  /** Row index in the data array */\r\n  rowIndex: number;\r\n  /** Column index */\r\n  colIndex: number;\r\n  /** Column configuration */\r\n  column: ColumnConfig;\r\n  /** Whether the cell is currently in edit mode */\r\n  isEditing: boolean;\r\n}\r\n\r\n/**\r\n * Header render context for plugin header renderers.\r\n */\r\nexport interface PluginHeaderRenderContext {\r\n  /** Column configuration */\r\n  column: ColumnConfig;\r\n  /** Column index */\r\n  colIndex: number;\r\n}\r\n\r\n/**\r\n * Cell renderer function type for plugins.\r\n */\r\nexport type CellRenderer = (ctx: PluginCellRenderContext) => string | HTMLElement;\r\n\r\n/**\r\n * Header renderer function type for plugins.\r\n */\r\nexport type HeaderRenderer = (ctx: PluginHeaderRenderContext) => string | HTMLElement;\r\n\r\n/**\r\n * Cell editor interface for plugins.\r\n */\r\nexport interface CellEditor {\r\n  create(ctx: PluginCellRenderContext, commitFn: (value: any) => void, cancelFn: () => void): HTMLElement;\r\n  getValue?(element: HTMLElement): any;\r\n  focus?(element: HTMLElement): void;\r\n}\r\n\r\n/**\r\n * Abstract base class for all grid plugins.\r\n *\r\n * @template TConfig - Configuration type for the plugin\r\n */\r\nexport abstract class BaseGridPlugin<TConfig = unknown> {\r\n  /** Unique plugin identifier (derived from class name by default) */\r\n  abstract readonly name: string;\r\n\r\n  /** Plugin version - override in subclass if needed */\r\n  readonly version: string = '1.0.0';\r\n\r\n  /** CSS styles to inject into the grid's shadow DOM */\r\n  readonly styles?: string;\r\n\r\n  /** Custom cell renderers keyed by type name */\r\n  readonly cellRenderers?: Record<string, CellRenderer>;\r\n\r\n  /** Custom header renderers keyed by type name */\r\n  readonly headerRenderers?: Record<string, HeaderRenderer>;\r\n\r\n  /** Custom cell editors keyed by type name */\r\n  readonly cellEditors?: Record<string, CellEditor>;\r\n\r\n  /** The grid instance this plugin is attached to */\r\n  protected grid!: GridElement;\r\n\r\n  /** Plugin configuration - merged with defaults in attach() */\r\n  protected config!: TConfig;\r\n\r\n  /** User-provided configuration from constructor */\r\n  private readonly userConfig: Partial<TConfig>;\r\n\r\n  /**\r\n   * Default configuration - subclasses should override this getter.\r\n   * Note: This must be a getter (not property initializer) for proper inheritance\r\n   * since property initializers run after parent constructor.\r\n   */\r\n  protected get defaultConfig(): Partial<TConfig> {\r\n    return {};\r\n  }\r\n\r\n  constructor(config: Partial<TConfig> = {}) {\r\n    this.userConfig = config;\r\n  }\r\n\r\n  /**\r\n   * Called when the plugin is attached to a grid.\r\n   * Override to set up event listeners, initialize state, etc.\r\n   */\r\n  attach(grid: GridElement): void {\r\n    this.grid = grid;\r\n    // Merge config here (after subclass construction is complete)\r\n    this.config = { ...this.defaultConfig, ...this.userConfig } as TConfig;\r\n  }\r\n\r\n  /**\r\n   * Called when the plugin is detached from a grid.\r\n   * Override to clean up event listeners, timers, etc.\r\n   */\r\n  detach(): void {\r\n    // Override in subclass\r\n  }\r\n\r\n  /**\r\n   * Get another plugin instance from the same grid.\r\n   * Use for inter-plugin communication.\r\n   */\r\n  protected getPlugin<T extends BaseGridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined {\r\n    return this.grid?.getPlugin(PluginClass);\r\n  }\r\n\r\n  /**\r\n   * Emit a custom event from the grid.\r\n   */\r\n  protected emit<T>(eventName: string, detail: T): void {\r\n    this.grid?.dispatchEvent?.(new CustomEvent(eventName, { detail, bubbles: true }));\r\n  }\r\n\r\n  /**\r\n   * Request a re-render of the grid.\r\n   */\r\n  protected requestRender(): void {\r\n    this.grid?.requestRender?.();\r\n  }\r\n\r\n  /**\r\n   * Request a lightweight style update without rebuilding DOM.\r\n   * Use this instead of requestRender() when only CSS classes need updating.\r\n   */\r\n  protected requestAfterRender(): void {\r\n    this.grid?.requestAfterRender?.();\r\n  }\r\n\r\n  /**\r\n   * Get the current rows from the grid.\r\n   */\r\n  protected get rows(): any[] {\r\n    return this.grid?.rows ?? [];\r\n  }\r\n\r\n  /**\r\n   * Get the original unfiltered/unprocessed rows from the grid.\r\n   * Use this when you need all source data regardless of active filters.\r\n   */\r\n  protected get sourceRows(): any[] {\r\n    return (this.grid as any)?.sourceRows ?? [];\r\n  }\r\n\r\n  /**\r\n   * Get the current columns from the grid.\r\n   */\r\n  protected get columns(): ColumnConfig[] {\r\n    return this.grid?.columns ?? [];\r\n  }\r\n\r\n  /**\r\n   * Get only visible columns from the grid (excludes hidden).\r\n   * Use this for rendering that needs to match the grid template.\r\n   */\r\n  protected get visibleColumns(): ColumnConfig[] {\r\n    return (this.grid as any)?.visibleColumns ?? [];\r\n  }\r\n\r\n  /**\r\n   * Get the shadow root of the grid.\r\n   */\r\n  protected get shadowRoot(): ShadowRoot | null {\r\n    return this.grid?.shadowRoot ?? null;\r\n  }\r\n\r\n  /**\r\n   * Log a warning message.\r\n   */\r\n  protected warn(message: string): void {\r\n    console.warn(`[tbw-grid:${this.name}] ${message}`);\r\n  }\r\n\r\n  // ===== Lifecycle Hooks (override as needed) =====\r\n\r\n  /**\r\n   * Transform rows before rendering.\r\n   * Called during each render cycle before rows are rendered to the DOM.\r\n   * Use this to filter, sort, or add computed properties to rows.\r\n   *\r\n   * @param rows - The current rows array (readonly to encourage returning a new array)\r\n   * @returns The modified rows array to render\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * processRows(rows: readonly any[]): any[] {\r\n   *   // Filter out hidden rows\r\n   *   return rows.filter(row => !row._hidden);\r\n   * }\r\n   * ```\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * processRows(rows: readonly any[]): any[] {\r\n   *   // Add computed properties\r\n   *   return rows.map(row => ({\r\n   *     ...row,\r\n   *     _fullName: `${row.firstName} ${row.lastName}`\r\n   *   }));\r\n   * }\r\n   * ```\r\n   */\r\n  processRows?(rows: readonly any[]): any[];\r\n\r\n  /**\r\n   * Transform columns before rendering.\r\n   * Called during each render cycle before column headers and cells are rendered.\r\n   * Use this to add, remove, or modify column definitions.\r\n   *\r\n   * @param columns - The current columns array (readonly to encourage returning a new array)\r\n   * @returns The modified columns array to render\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * processColumns(columns: readonly ColumnConfig[]): ColumnConfig[] {\r\n   *   // Add a selection checkbox column\r\n   *   return [\r\n   *     { field: '_select', header: '', width: 40 },\r\n   *     ...columns\r\n   *   ];\r\n   * }\r\n   * ```\r\n   */\r\n  processColumns?(columns: readonly ColumnConfig[]): ColumnConfig[];\r\n\r\n  /**\r\n   * Called before each render cycle begins.\r\n   * Use this to prepare state or cache values needed during rendering.\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * beforeRender(): void {\r\n   *   this.visibleRowCount = this.calculateVisibleRows();\r\n   * }\r\n   * ```\r\n   */\r\n  beforeRender?(): void;\r\n\r\n  /**\r\n   * Called after each render cycle completes.\r\n   * Use this for DOM manipulation, adding event listeners to rendered elements,\r\n   * or applying visual effects like selection highlights.\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * afterRender(): void {\r\n   *   // Apply selection styling to rendered rows\r\n   *   const rows = this.shadowRoot?.querySelectorAll('.data-row');\r\n   *   rows?.forEach((row, i) => {\r\n   *     row.classList.toggle('selected', this.selectedRows.has(i));\r\n   *   });\r\n   * }\r\n   * ```\r\n   */\r\n  afterRender?(): void;\r\n\r\n  /**\r\n   * Render a custom row, bypassing the default row rendering.\r\n   * Use this for special row types like group headers, detail rows, or footers.\r\n   *\r\n   * @param row - The row data object\r\n   * @param rowEl - The row DOM element to render into\r\n   * @param rowIndex - The index of the row in the data array\r\n   * @returns `true` if the plugin handled rendering (prevents default), `false`/`void` for default rendering\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * renderRow(row: any, rowEl: HTMLElement, rowIndex: number): boolean | void {\r\n   *   if (row._isGroupHeader) {\r\n   *     rowEl.innerHTML = `<div class=\"group-header\">${row._groupLabel}</div>`;\r\n   *     return true; // Handled - skip default rendering\r\n   *   }\r\n   *   // Return void to let default rendering proceed\r\n   * }\r\n   * ```\r\n   */\r\n  renderRow?(row: any, rowEl: HTMLElement, rowIndex: number): boolean | void;\r\n\r\n  // ===== Interaction Hooks (override as needed) =====\r\n\r\n  /**\r\n   * Handle keyboard events on the grid.\r\n   * Called when a key is pressed while the grid or a cell has focus.\r\n   *\r\n   * @param event - The native KeyboardEvent\r\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * onKeyDown(event: KeyboardEvent): boolean | void {\r\n   *   // Handle Ctrl+A for select all\r\n   *   if (event.ctrlKey && event.key === 'a') {\r\n   *     this.selectAllRows();\r\n   *     return true; // Prevent default browser select-all\r\n   *   }\r\n   * }\r\n   * ```\r\n   */\r\n  onKeyDown?(event: KeyboardEvent): boolean | void;\r\n\r\n  /**\r\n   * Handle cell click events.\r\n   * Called when a data cell is clicked (not headers).\r\n   *\r\n   * @param event - Cell click event with row/column context\r\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * onCellClick(event: CellClickEvent): boolean | void {\r\n   *   if (event.field === '_select') {\r\n   *     this.toggleRowSelection(event.rowIndex);\r\n   *     return true; // Handled\r\n   *   }\r\n   * }\r\n   * ```\r\n   */\r\n  onCellClick?(event: CellClickEvent): boolean | void;\r\n\r\n  /**\r\n   * Handle row click events.\r\n   * Called when any part of a data row is clicked.\r\n   * Note: This is called in addition to onCellClick, not instead of.\r\n   *\r\n   * @param event - Row click event with row context\r\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * onRowClick(event: RowClickEvent): boolean | void {\r\n   *   if (this.config.mode === 'row') {\r\n   *     this.selectRow(event.rowIndex, event.originalEvent);\r\n   *     return true;\r\n   *   }\r\n   * }\r\n   * ```\r\n   */\r\n  onRowClick?(event: RowClickEvent): boolean | void;\r\n\r\n  /**\r\n   * Handle header click events.\r\n   * Called when a column header is clicked. Commonly used for sorting.\r\n   *\r\n   * @param event - Header click event with column context\r\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * onHeaderClick(event: HeaderClickEvent): boolean | void {\r\n   *   if (event.column.sortable !== false) {\r\n   *     this.toggleSort(event.field);\r\n   *     return true;\r\n   *   }\r\n   * }\r\n   * ```\r\n   */\r\n  onHeaderClick?(event: HeaderClickEvent): boolean | void;\r\n\r\n  /**\r\n   * Handle scroll events on the grid viewport.\r\n   * Called during scrolling. Note: This may be called frequently; debounce if needed.\r\n   *\r\n   * @param event - Scroll event with scroll position and viewport dimensions\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * onScroll(event: ScrollEvent): void {\r\n   *   // Update sticky column positions\r\n   *   this.updateStickyPositions(event.scrollLeft);\r\n   * }\r\n   * ```\r\n   */\r\n  onScroll?(event: ScrollEvent): void;\r\n\r\n  /**\r\n   * Handle cell mousedown events.\r\n   * Used for initiating drag operations like range selection or column resize.\r\n   *\r\n   * @param event - Mouse event with cell context\r\n   * @returns `true` to indicate drag started (prevents text selection), `false`/`void` otherwise\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * onCellMouseDown(event: CellMouseEvent): boolean | void {\r\n   *   if (event.rowIndex !== undefined && this.config.mode === 'range') {\r\n   *     this.startDragSelection(event.rowIndex, event.colIndex);\r\n   *     return true; // Prevent text selection\r\n   *   }\r\n   * }\r\n   * ```\r\n   */\r\n  onCellMouseDown?(event: CellMouseEvent): boolean | void;\r\n\r\n  /**\r\n   * Handle cell mousemove events during drag operations.\r\n   * Only called when a drag is in progress (after mousedown returned true).\r\n   *\r\n   * @param event - Mouse event with current cell context\r\n   * @returns `true` to continue handling the drag, `false`/`void` otherwise\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * onCellMouseMove(event: CellMouseEvent): boolean | void {\r\n   *   if (this.isDragging && event.rowIndex !== undefined) {\r\n   *     this.extendSelection(event.rowIndex, event.colIndex);\r\n   *     return true;\r\n   *   }\r\n   * }\r\n   * ```\r\n   */\r\n  onCellMouseMove?(event: CellMouseEvent): boolean | void;\r\n\r\n  /**\r\n   * Handle cell mouseup events to end drag operations.\r\n   *\r\n   * @param event - Mouse event with final cell context\r\n   * @returns `true` if drag was finalized, `false`/`void` otherwise\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * onCellMouseUp(event: CellMouseEvent): boolean | void {\r\n   *   if (this.isDragging) {\r\n   *     this.finalizeDragSelection();\r\n   *     this.isDragging = false;\r\n   *     return true;\r\n   *   }\r\n   * }\r\n   * ```\r\n   */\r\n  onCellMouseUp?(event: CellMouseEvent): boolean | void;\r\n\r\n  /**\r\n   * Provide context menu items when right-clicking on the grid.\r\n   * Multiple plugins can contribute items; they are merged into a single menu.\r\n   *\r\n   * @param params - Context about where the menu was triggered (row, column, etc.)\r\n   * @returns Array of menu items to display\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * getContextMenuItems(params: ContextMenuParams): ContextMenuItem[] {\r\n   *   if (params.isHeader) {\r\n   *     return [\r\n   *       { id: 'sort-asc', label: 'Sort Ascending', action: () => this.sortAsc(params.field) },\r\n   *       { id: 'sort-desc', label: 'Sort Descending', action: () => this.sortDesc(params.field) },\r\n   *     ];\r\n   *   }\r\n   *   return [\r\n   *     { id: 'copy', label: 'Copy Cell', action: () => this.copyCell(params) },\r\n   *   ];\r\n   * }\r\n   * ```\r\n   */\r\n  getContextMenuItems?(params: ContextMenuParams): ContextMenuItem[];\r\n\r\n  // ===== Column State Hooks (override as needed) =====\r\n\r\n  /**\r\n   * Contribute plugin-specific state for a column.\r\n   * Called by the grid when collecting column state for serialization.\r\n   * Plugins can add their own properties to the column state.\r\n   *\r\n   * @param field - The field name of the column\r\n   * @returns Partial column state with plugin-specific properties, or undefined if no state to contribute\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * getColumnState(field: string): Partial<ColumnState> | undefined {\r\n   *   const filterModel = this.filterModels.get(field);\r\n   *   if (filterModel) {\r\n   *     // Uses module augmentation to add filter property to ColumnState\r\n   *     return { filter: filterModel } as Partial<ColumnState>;\r\n   *   }\r\n   *   return undefined;\r\n   * }\r\n   * ```\r\n   */\r\n  getColumnState?(field: string): Partial<ColumnState> | undefined;\r\n\r\n  /**\r\n   * Apply plugin-specific state to a column.\r\n   * Called by the grid when restoring column state from serialized data.\r\n   * Plugins should restore their internal state based on the provided state.\r\n   *\r\n   * @param field - The field name of the column\r\n   * @param state - The column state to apply (may contain plugin-specific properties)\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * applyColumnState(field: string, state: ColumnState): void {\r\n   *   // Check for filter property added via module augmentation\r\n   *   const filter = (state as any).filter;\r\n   *   if (filter) {\r\n   *     this.filterModels.set(field, filter);\r\n   *     this.applyFilter();\r\n   *   }\r\n   * }\r\n   * ```\r\n   */\r\n  applyColumnState?(field: string, state: ColumnState): void;\r\n\r\n  // ===== Shell Integration Hooks (override as needed) =====\r\n\r\n  /**\r\n   * Register a tool panel for this plugin.\r\n   * Return undefined if plugin has no tool panel.\r\n   * The shell will create a toolbar toggle button and render the panel content\r\n   * when the user opens the panel.\r\n   *\r\n   * @returns Tool panel definition, or undefined if plugin has no panel\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * getToolPanel(): ToolPanelDefinition | undefined {\r\n   *   return {\r\n   *     id: 'columns',\r\n   *     title: 'Columns',\r\n   *     icon: '☰',\r\n   *     tooltip: 'Show/hide columns',\r\n   *     order: 10,\r\n   *     render: (container) => {\r\n   *       this.renderColumnList(container);\r\n   *       return () => this.cleanup();\r\n   *     },\r\n   *   };\r\n   * }\r\n   * ```\r\n   */\r\n  getToolPanel?(): ToolPanelDefinition | undefined;\r\n\r\n  /**\r\n   * Register content for the shell header center section.\r\n   * Return undefined if plugin has no header content.\r\n   * Examples: search input, selection summary, status indicators.\r\n   *\r\n   * @returns Header content definition, or undefined if plugin has no header content\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * getHeaderContent(): HeaderContentDefinition | undefined {\r\n   *   return {\r\n   *     id: 'quick-filter',\r\n   *     order: 10,\r\n   *     render: (container) => {\r\n   *       const input = document.createElement('input');\r\n   *       input.type = 'text';\r\n   *       input.placeholder = 'Search...';\r\n   *       input.addEventListener('input', this.handleInput);\r\n   *       container.appendChild(input);\r\n   *       return () => input.removeEventListener('input', this.handleInput);\r\n   *     },\r\n   *   };\r\n   * }\r\n   * ```\r\n   */\r\n  getHeaderContent?(): HeaderContentDefinition | undefined;\r\n}\r\n","/**\n * CSV Export Utilities\n *\n * Functions for building and downloading CSV content.\n */\n\nimport type { ColumnConfig } from '../../core/types';\nimport type { ExportParams } from './types';\n\n/** CSV export options */\nexport interface CsvOptions {\n  /** Field delimiter (default: ',') */\n  delimiter?: string;\n  /** Line separator (default: '\\n') */\n  newline?: string;\n  /** Whether to quote strings containing special characters (default: true) */\n  quoteStrings?: boolean;\n  /** Add UTF-8 BOM for Excel compatibility (default: false) */\n  bom?: boolean;\n}\n\n/**\n * Format a value for CSV output.\n * Handles null, Date, objects, and strings with special characters.\n */\nexport function formatCsvValue(value: any, quote = true): string {\n  if (value == null) return '';\n  if (value instanceof Date) return value.toISOString();\n  if (typeof value === 'object') return JSON.stringify(value);\n\n  const str = String(value);\n\n  // Quote if contains special characters (comma, quote, newline)\n  if (quote && (str.includes(',') || str.includes('\"') || str.includes('\\n') || str.includes('\\r'))) {\n    return `\"${str.replace(/\"/g, '\"\"')}\"`;\n  }\n\n  return str;\n}\n\n/**\n * Build CSV content from rows and columns.\n */\nexport function buildCsv(rows: any[], columns: ColumnConfig[], params: ExportParams, options: CsvOptions = {}): string {\n  const delimiter = options.delimiter ?? ',';\n  const newline = options.newline ?? '\\n';\n  const lines: string[] = [];\n\n  // UTF-8 BOM for Excel compatibility\n  const bom = options.bom ? '\\uFEFF' : '';\n\n  // Build header row\n  if (params.includeHeaders !== false) {\n    const headerRow = columns.map((col) => {\n      const header = col.header || col.field;\n      const processed = params.processHeader ? params.processHeader(header, col.field) : header;\n      return formatCsvValue(processed);\n    });\n    lines.push(headerRow.join(delimiter));\n  }\n\n  // Build data rows\n  for (const row of rows) {\n    const cells = columns.map((col) => {\n      let value = row[col.field];\n      if (params.processCell) {\n        value = params.processCell(value, col.field, row);\n      }\n      return formatCsvValue(value);\n    });\n    lines.push(cells.join(delimiter));\n  }\n\n  return bom + lines.join(newline);\n}\n\n/**\n * Download a Blob as a file.\n */\nexport function downloadBlob(blob: Blob, fileName: string): void {\n  const url = URL.createObjectURL(blob);\n  const link = document.createElement('a');\n  link.href = url;\n  link.download = fileName;\n  link.style.display = 'none';\n  document.body.appendChild(link);\n  link.click();\n  document.body.removeChild(link);\n  URL.revokeObjectURL(url);\n}\n\n/**\n * Download CSV content as a file.\n */\nexport function downloadCsv(content: string, fileName: string): void {\n  const blob = new Blob([content], { type: 'text/csv;charset=utf-8;' });\n  downloadBlob(blob, fileName);\n}\n","/**\n * Excel Export Utilities\n *\n * Simple Excel XML format export (no external dependencies).\n * Produces XML Spreadsheet 2003 format which opens in Excel.\n */\n\nimport type { ColumnConfig } from '../../core/types';\nimport type { ExportParams } from './types';\nimport { downloadBlob } from './csv';\n\n/**\n * Escape XML special characters.\n */\nfunction escapeXml(str: string): string {\n  return str\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&apos;');\n}\n\n/**\n * Build Excel XML content from rows and columns.\n * Uses XML Spreadsheet 2003 format for broad compatibility.\n */\nexport function buildExcelXml(rows: any[], columns: ColumnConfig[], params: ExportParams): string {\n  let xml = `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<?mso-application progid=\"Excel.Sheet\"?>\n<Workbook xmlns=\"urn:schemas-microsoft-com:office:spreadsheet\"\n  xmlns:ss=\"urn:schemas-microsoft-com:office:spreadsheet\">\n<Worksheet ss:Name=\"Sheet1\">\n<Table>`;\n\n  // Build header row\n  if (params.includeHeaders !== false) {\n    xml += '\\n<Row>';\n    for (const col of columns) {\n      const header = col.header || col.field;\n      const processed = params.processHeader ? params.processHeader(header, col.field) : header;\n      xml += `<Cell><Data ss:Type=\"String\">${escapeXml(processed)}</Data></Cell>`;\n    }\n    xml += '</Row>';\n  }\n\n  // Build data rows\n  for (const row of rows) {\n    xml += '\\n<Row>';\n    for (const col of columns) {\n      let value = row[col.field];\n      if (params.processCell) {\n        value = params.processCell(value, col.field, row);\n      }\n\n      // Determine cell type based on value\n      let type: 'Number' | 'String' | 'DateTime' = 'String';\n      let displayValue = '';\n\n      if (value == null) {\n        displayValue = '';\n      } else if (typeof value === 'number' && !isNaN(value)) {\n        type = 'Number';\n        displayValue = String(value);\n      } else if (value instanceof Date) {\n        type = 'DateTime';\n        displayValue = value.toISOString();\n      } else {\n        displayValue = escapeXml(String(value));\n      }\n\n      xml += `<Cell><Data ss:Type=\"${type}\">${displayValue}</Data></Cell>`;\n    }\n    xml += '</Row>';\n  }\n\n  xml += '\\n</Table>\\n</Worksheet>\\n</Workbook>';\n  return xml;\n}\n\n/**\n * Download Excel XML content as a file.\n */\nexport function downloadExcel(content: string, fileName: string): void {\n  const finalName = fileName.endsWith('.xls') ? fileName : `${fileName}.xls`;\n  const blob = new Blob([content], {\n    type: 'application/vnd.ms-excel;charset=utf-8;',\n  });\n  downloadBlob(blob, finalName);\n}\n","/**\n * Export Plugin (Class-based)\n *\n * Provides data export functionality for tbw-grid.\n * Supports CSV, Excel (XML), and JSON formats.\n */\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport { BaseGridPlugin } from '../../core/plugin/base-plugin';\nimport type { ColumnConfig } from '../../core/types';\nimport { buildCsv, downloadBlob, downloadCsv } from './csv';\nimport { buildExcelXml, downloadExcel } from './excel';\nimport type { ExportCompleteDetail, ExportConfig, ExportFormat, ExportParams } from './types';\n\n/** Selection plugin state interface for type safety */\ninterface SelectionPluginState {\n  selected: Set<number>;\n}\n\n/**\n * Export Plugin for tbw-grid\n *\n * @example\n * ```ts\n * new ExportPlugin({\n *   enabled: true,\n *   fileName: 'my-data',\n *   includeHeaders: true,\n *   onlyVisible: true,\n * })\n * ```\n */\nexport class ExportPlugin extends BaseGridPlugin<ExportConfig> {\n  readonly name = 'export';\n  override readonly version = '1.0.0';\n\n  protected override get defaultConfig(): Partial<ExportConfig> {\n    return {\n      enabled: true,\n      fileName: 'export',\n      includeHeaders: true,\n      onlyVisible: true,\n      onlySelected: false,\n    };\n  }\n\n  // ===== Internal State =====\n  private isExportingFlag = false;\n  private lastExportInfo: { format: ExportFormat; timestamp: Date } | null = null;\n\n  // ===== Private Methods =====\n\n  private performExport(format: ExportFormat, params?: Partial<ExportParams>): void {\n    const config = this.config;\n\n    // Build full params with defaults\n    const fullParams: ExportParams = {\n      format,\n      fileName: params?.fileName ?? config.fileName ?? 'export',\n      includeHeaders: params?.includeHeaders ?? config.includeHeaders,\n      processCell: params?.processCell,\n      processHeader: params?.processHeader,\n      columns: params?.columns,\n      rowIndices: params?.rowIndices,\n    };\n\n    // Get columns to export\n    let columns = [...this.columns] as ColumnConfig[];\n    if (config.onlyVisible) {\n      columns = columns.filter((c) => !c.hidden && !c.field.startsWith('__'));\n    }\n    if (params?.columns) {\n      const colSet = new Set(params.columns);\n      columns = columns.filter((c) => colSet.has(c.field));\n    }\n\n    // Get rows to export\n    let rows = [...this.rows] as any[];\n    if (config.onlySelected) {\n      const selectionState = this.getSelectionState();\n      if (selectionState?.selected?.size) {\n        const sortedIndices = [...selectionState.selected].sort((a, b) => a - b);\n        rows = sortedIndices.map((i) => this.rows[i]).filter(Boolean);\n      }\n    }\n    if (params?.rowIndices) {\n      rows = params.rowIndices.map((i) => this.rows[i]).filter(Boolean);\n    }\n\n    this.isExportingFlag = true;\n    let fileName = fullParams.fileName!;\n\n    try {\n      switch (format) {\n        case 'csv': {\n          const content = buildCsv(rows, columns, fullParams, { bom: true });\n          fileName = fileName.endsWith('.csv') ? fileName : `${fileName}.csv`;\n          downloadCsv(content, fileName);\n          break;\n        }\n\n        case 'excel': {\n          const content = buildExcelXml(rows, columns, fullParams);\n          fileName = fileName.endsWith('.xls') ? fileName : `${fileName}.xls`;\n          downloadExcel(content, fileName);\n          break;\n        }\n\n        case 'json': {\n          const jsonData = rows.map((row) => {\n            const obj: Record<string, any> = {};\n            for (const col of columns) {\n              let value = row[col.field];\n              if (fullParams.processCell) {\n                value = fullParams.processCell(value, col.field, row);\n              }\n              obj[col.field] = value;\n            }\n            return obj;\n          });\n          const content = JSON.stringify(jsonData, null, 2);\n          fileName = fileName.endsWith('.json') ? fileName : `${fileName}.json`;\n          const blob = new Blob([content], { type: 'application/json' });\n          downloadBlob(blob, fileName);\n          break;\n        }\n      }\n\n      this.lastExportInfo = { format, timestamp: new Date() };\n\n      this.emit<ExportCompleteDetail>('export-complete', {\n        format,\n        fileName,\n        rowCount: rows.length,\n        columnCount: columns.length,\n      });\n    } finally {\n      this.isExportingFlag = false;\n    }\n  }\n\n  private getSelectionState(): SelectionPluginState | null {\n    try {\n      const grid = this.grid as any;\n      return grid?.getPluginState?.('selection') ?? null;\n    } catch {\n      return null;\n    }\n  }\n\n  // ===== Public API =====\n\n  /**\n   * Export data to CSV format.\n   * @param params - Optional export parameters\n   */\n  exportCsv(params?: Partial<ExportParams>): void {\n    this.performExport('csv', params);\n  }\n\n  /**\n   * Export data to Excel format (XML Spreadsheet).\n   * @param params - Optional export parameters\n   */\n  exportExcel(params?: Partial<ExportParams>): void {\n    this.performExport('excel', params);\n  }\n\n  /**\n   * Export data to JSON format.\n   * @param params - Optional export parameters\n   */\n  exportJson(params?: Partial<ExportParams>): void {\n    this.performExport('json', params);\n  }\n\n  /**\n   * Check if an export is currently in progress.\n   * @returns Whether export is in progress\n   */\n  isExporting(): boolean {\n    return this.isExportingFlag;\n  }\n\n  /**\n   * Get information about the last export.\n   * @returns Export info or null if no export has occurred\n   */\n  getLastExport(): { format: ExportFormat; timestamp: Date } | null {\n    return this.lastExportInfo;\n  }\n}\n"],"names":["BaseGridPlugin","config","grid","PluginClass","eventName","detail","message","formatCsvValue","value","quote","str","buildCsv","rows","columns","params","options","delimiter","newline","lines","bom","headerRow","col","header","processed","row","cells","downloadBlob","blob","fileName","url","link","downloadCsv","content","escapeXml","buildExcelXml","xml","type","displayValue","downloadExcel","finalName","ExportPlugin","format","fullParams","c","colSet","selectionState","a","b","i","jsonData","obj"],"mappings":"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"}