@toolbox-web/grid 0.2.2 → 0.2.4

package/all.d.ts

@@ -65,7 +65,7 @@ declare type AggregatorMap = Record<string, AggregatorRef_2>;
 /** Map of field names to aggregator references */
 declare type AggregatorMap_2 = Record<string, AggregatorRef_2_2>;
 
-export declare type AggregatorRef = string | ((rows: any[], field: string, column?: any) => any);
+export declare type AggregatorRef = string | ((rows: unknown[], field: string, column?: unknown) => unknown);
 
 declare type AggregatorRef_2 = string | AggregatorFn_2;
 
@@ -133,17 +133,17 @@ export declare interface BaseColumnConfig<TRow = any, TValue = any> {
     /** For select/typeahead types - available options */
     options?: Array<{
         label: string;
-        value: any;
+        value: unknown;
     }> | (() => Array<{
         label: string;
-        value: any;
+        value: unknown;
     }>);
     /** For select/typeahead - allow multi select */
     multi?: boolean;
     /** Optional formatter */
     format?: (value: TValue, row: TRow) => string;
     /** Arbitrary extra metadata */
-    meta?: Record<string, any>;
+    meta?: Record<string, unknown>;
 }
 
 /**
@@ -151,7 +151,7 @@ export declare interface BaseColumnConfig<TRow = any, TValue = any> {
  *
  * @template TConfig - Configuration type for the plugin
  */
-export declare abstract class BaseGridPlugin<TConfig = unknown> {
+export declare abstract class BaseGridPlugin<TConfig = unknown> implements GridPlugin {
     /** Unique plugin identifier (derived from class name by default) */
     abstract readonly name: string;
     /** Plugin version - override in subclass if needed */
@@ -447,6 +447,33 @@ export declare abstract class BaseGridPlugin<TConfig = unknown> {
      * ```
      */
     renderRow?(row: any, rowEl: HTMLElement, rowIndex: number): boolean | void;
+    /**
+     * Handle queries from other plugins.
+     * This is the generic mechanism for inter-plugin communication.
+     * Plugins can respond to well-known query types or define their own.
+     *
+     * @param query - The query object with type and context
+     * @returns Query-specific response, or undefined if not handling this query
+     *
+     * @example
+     * ```ts
+     * onPluginQuery(query: PluginQuery): unknown {
+     *   switch (query.type) {
+     *     case PLUGIN_QUERIES.CAN_MOVE_COLUMN:
+     *       // Prevent moving pinned columns
+     *       const column = query.context as ColumnConfig;
+     *       if (column.sticky === 'left' || column.sticky === 'right') {
+     *         return false;
+     *       }
+     *       break;
+     *     case PLUGIN_QUERIES.GET_CONTEXT_MENU_ITEMS:
+     *       const params = query.context as ContextMenuParams;
+     *       return [{ id: 'my-action', label: 'My Action', action: () => {} }];
+     *   }
+     * }
+     * ```
+     */
+    onPluginQuery?(query: PluginQuery): unknown;
     /**
      * Handle keyboard events on the grid.
      * Called when a key is pressed while the grid or a cell has focus.
@@ -590,29 +617,6 @@ export declare abstract class BaseGridPlugin<TConfig = unknown> {
      * ```
      */
     onCellMouseUp?(event: CellMouseEvent): boolean | void;
-    /**
-     * Provide context menu items when right-clicking on the grid.
-     * Multiple plugins can contribute items; they are merged into a single menu.
-     *
-     * @param params - Context about where the menu was triggered (row, column, etc.)
-     * @returns Array of menu items to display
-     *
-     * @example
-     * ```ts
-     * getContextMenuItems(params: ContextMenuParams): ContextMenuItem[] {
-     *   if (params.isHeader) {
-     *     return [
-     *       { id: 'sort-asc', label: 'Sort Ascending', action: () => this.sortAsc(params.field) },
-     *       { id: 'sort-desc', label: 'Sort Descending', action: () => this.sortDesc(params.field) },
-     *     ];
-     *   }
-     *   return [
-     *     { id: 'copy', label: 'Copy Cell', action: () => this.copyCell(params) },
-     *   ];
-     * }
-     * ```
-     */
-    getContextMenuItems?(params: ContextMenuParams): ContextMenuItem[];
     /**
      * Contribute plugin-specific state for a column.
      * Called by the grid when collecting column state for serialization.
@@ -655,6 +659,34 @@ export declare abstract class BaseGridPlugin<TConfig = unknown> {
      * ```
      */
     applyColumnState?(field: string, state: ColumnState): void;
+    /**
+     * Report horizontal scroll boundary offsets for this plugin.
+     * Plugins that obscure part of the scroll area (e.g., pinned/sticky columns)
+     * should return how much space they occupy on each side.
+     * The keyboard navigation uses this to ensure focused cells are fully visible.
+     *
+     * @param rowEl - The row element (optional, for calculating widths from rendered cells)
+     * @param focusedCell - The currently focused cell element (optional, to determine if scrolling should be skipped)
+     * @returns Object with left/right pixel offsets and optional skipScroll flag, or undefined if plugin has no offsets
+     *
+     * @example
+     * ```ts
+     * getHorizontalScrollOffsets(rowEl?: HTMLElement, focusedCell?: HTMLElement): { left: number; right: number; skipScroll?: boolean } | undefined {
+     *   // Calculate total width of left-pinned columns
+     *   const leftCells = rowEl?.querySelectorAll('.sticky-left') ?? [];
+     *   let left = 0;
+     *   leftCells.forEach(el => { left += (el as HTMLElement).offsetWidth; });
+     *   // Skip scroll if focused cell is pinned (always visible)
+     *   const skipScroll = focusedCell?.classList.contains('sticky-left');
+     *   return { left, right: 0, skipScroll };
+     * }
+     * ```
+     */
+    getHorizontalScrollOffsets?(rowEl?: HTMLElement, focusedCell?: HTMLElement): {
+        left: number;
+        right: number;
+        skipScroll?: boolean;
+    } | undefined;
     /**
      * Register a tool panel for this plugin.
      * Return undefined if plugin has no tool panel.
@@ -714,7 +746,7 @@ export declare abstract class BaseGridPlugin<TConfig = unknown> {
  *
  * @template TConfig - Configuration type for the plugin
  */
-declare abstract class BaseGridPlugin_2<TConfig = unknown> {
+declare abstract class BaseGridPlugin_2<TConfig = unknown> implements GridPlugin_2 {
     /** Unique plugin identifier (derived from class name by default) */
     abstract readonly name: string;
     /** Plugin version - override in subclass if needed */
@@ -1010,6 +1042,33 @@ declare abstract class BaseGridPlugin_2<TConfig = unknown> {
      * ```
      */
     renderRow?(row: any, rowEl: HTMLElement, rowIndex: number): boolean | void;
+    /**
+     * Handle queries from other plugins.
+     * This is the generic mechanism for inter-plugin communication.
+     * Plugins can respond to well-known query types or define their own.
+     *
+     * @param query - The query object with type and context
+     * @returns Query-specific response, or undefined if not handling this query
+     *
+     * @example
+     * ```ts
+     * onPluginQuery(query: PluginQuery): unknown {
+     *   switch (query.type) {
+     *     case PLUGIN_QUERIES.CAN_MOVE_COLUMN:
+     *       // Prevent moving pinned columns
+     *       const column = query.context as ColumnConfig;
+     *       if (column.sticky === 'left' || column.sticky === 'right') {
+     *         return false;
+     *       }
+     *       break;
+     *     case PLUGIN_QUERIES.GET_CONTEXT_MENU_ITEMS:
+     *       const params = query.context as ContextMenuParams;
+     *       return [{ id: 'my-action', label: 'My Action', action: () => {} }];
+     *   }
+     * }
+     * ```
+     */
+    onPluginQuery?(query: PluginQuery_2): unknown;
     /**
      * Handle keyboard events on the grid.
      * Called when a key is pressed while the grid or a cell has focus.
@@ -1153,29 +1212,6 @@ declare abstract class BaseGridPlugin_2<TConfig = unknown> {
      * ```
      */
     onCellMouseUp?(event: CellMouseEvent_2): boolean | void;
-    /**
-     * Provide context menu items when right-clicking on the grid.
-     * Multiple plugins can contribute items; they are merged into a single menu.
-     *
-     * @param params - Context about where the menu was triggered (row, column, etc.)
-     * @returns Array of menu items to display
-     *
-     * @example
-     * ```ts
-     * getContextMenuItems(params: ContextMenuParams): ContextMenuItem[] {
-     *   if (params.isHeader) {
-     *     return [
-     *       { id: 'sort-asc', label: 'Sort Ascending', action: () => this.sortAsc(params.field) },
-     *       { id: 'sort-desc', label: 'Sort Descending', action: () => this.sortDesc(params.field) },
-     *     ];
-     *   }
-     *   return [
-     *     { id: 'copy', label: 'Copy Cell', action: () => this.copyCell(params) },
-     *   ];
-     * }
-     * ```
-     */
-    getContextMenuItems?(params: ContextMenuParams_2): ContextMenuItem_2[];
     /**
      * Contribute plugin-specific state for a column.
      * Called by the grid when collecting column state for serialization.
@@ -1218,6 +1254,34 @@ declare abstract class BaseGridPlugin_2<TConfig = unknown> {
      * ```
      */
     applyColumnState?(field: string, state: ColumnState_2): void;
+    /**
+     * Report horizontal scroll boundary offsets for this plugin.
+     * Plugins that obscure part of the scroll area (e.g., pinned/sticky columns)
+     * should return how much space they occupy on each side.
+     * The keyboard navigation uses this to ensure focused cells are fully visible.
+     *
+     * @param rowEl - The row element (optional, for calculating widths from rendered cells)
+     * @param focusedCell - The currently focused cell element (optional, to determine if scrolling should be skipped)
+     * @returns Object with left/right pixel offsets and optional skipScroll flag, or undefined if plugin has no offsets
+     *
+     * @example
+     * ```ts
+     * getHorizontalScrollOffsets(rowEl?: HTMLElement, focusedCell?: HTMLElement): { left: number; right: number; skipScroll?: boolean } | undefined {
+     *   // Calculate total width of left-pinned columns
+     *   const leftCells = rowEl?.querySelectorAll('.sticky-left') ?? [];
+     *   let left = 0;
+     *   leftCells.forEach(el => { left += (el as HTMLElement).offsetWidth; });
+     *   // Skip scroll if focused cell is pinned (always visible)
+     *   const skipScroll = focusedCell?.classList.contains('sticky-left');
+     *   return { left, right: 0, skipScroll };
+     * }
+     * ```
+     */
+    getHorizontalScrollOffsets?(rowEl?: HTMLElement, focusedCell?: HTMLElement): {
+        left: number;
+        right: number;
+        skipScroll?: boolean;
+    } | undefined;
     /**
      * Register a tool panel for this plugin.
      * Return undefined if plugin has no tool panel.
@@ -1298,13 +1362,13 @@ declare interface CellClickEvent_2 {
     originalEvent: MouseEvent;
 }
 
-export declare interface CellCommitDetail<TRow = any> {
+export declare interface CellCommitDetail<TRow = unknown> {
     /** The mutated row after commit. */
     row: TRow;
     /** Field name whose value changed. */
     field: string;
     /** New value stored. */
-    value: any;
+    value: unknown;
     /** Index of the row in current data set. */
     rowIndex: number;
     /** All rows that have at least one committed change (snapshot list). */
@@ -1320,7 +1384,7 @@ export declare interface CellCommitDetail<TRow = any> {
  */
 declare interface CellContext<T = any> {
     row: T;
-    value: any;
+    value: unknown;
     field: string;
     column: ColumnInternal<T>;
 }
@@ -1486,7 +1550,7 @@ export declare type CellRenderer = (ctx: PluginCellRenderContext) => string | HT
 declare type CellRenderer_2 = (ctx: PluginCellRenderContext_2) => string | HTMLElement;
 
 /** Emitted when the changed rows tracking set is cleared programmatically. */
-export declare interface ChangedRowsResetDetail<TRow = any> {
+export declare interface ChangedRowsResetDetail<TRow = unknown> {
     /** New (empty) changed rows array after reset. */
     rows: TRow[];
     /** Parallel indices (likely empty). */
@@ -1563,12 +1627,12 @@ export declare interface ColumnConfig<TRow = any> extends BaseColumnConfig<TRow,
     viewRenderer?: ColumnViewRenderer<TRow, any>;
     /** External view spec (lets host app mount any framework component) */
     externalView?: {
-        component: any;
-        props?: Record<string, any>;
+        component: unknown;
+        props?: Record<string, unknown>;
         mount?: (options: {
             placeholder: HTMLElement;
-            context: CellRenderContext<TRow, any>;
-            spec: any;
+            context: CellRenderContext<TRow, unknown>;
+            spec: unknown;
         }) => void | {
             dispose?: () => void;
         };
@@ -1587,12 +1651,12 @@ declare interface ColumnConfig_2<TRow = any> extends BaseColumnConfig<TRow, any>
     viewRenderer?: ColumnViewRenderer_2<TRow, any>;
     /** External view spec (lets host app mount any framework component) */
     externalView?: {
-        component: any;
-        props?: Record<string, any>;
+        component: unknown;
+        props?: Record<string, unknown>;
         mount?: (options: {
             placeholder: HTMLElement;
-            context: CellRenderContext_2<TRow, any>;
-            spec: any;
+            context: CellRenderContext_2<TRow, unknown>;
+            spec: unknown;
         }) => void | {
             dispose?: () => void;
         };
@@ -1624,16 +1688,16 @@ export declare interface ColumnEditorContext<TRow = any, TValue = any> {
 }
 
 /** External editor spec: tag name, factory function, or external mount spec */
-export declare type ColumnEditorSpec<TRow = any, TValue = any> = string | ((context: ColumnEditorContext<TRow, TValue>) => HTMLElement | string) | {
+export declare type ColumnEditorSpec<TRow = unknown, TValue = unknown> = string | ((context: ColumnEditorContext<TRow, TValue>) => HTMLElement | string) | {
     /** Arbitrary component reference (class, function, token) */
-    component: any;
+    component: unknown;
     /** Optional static props passed to mount */
-    props?: Record<string, any>;
+    props?: Record<string, unknown>;
     /** Optional custom mount function; if provided we call it directly instead of emitting an event */
     mount?: (options: {
         placeholder: HTMLElement;
         context: ColumnEditorContext<TRow, TValue>;
-        spec: any;
+        spec: unknown;
     }) => void | {
         dispose?: () => void;
     };
@@ -1744,9 +1808,9 @@ declare interface ColumnState {
     sort?: ColumnSortState_2;
 }
 
-export declare type ColumnViewRenderer<TRow = any, TValue = any> = (ctx: CellRenderContext<TRow, TValue>) => Node | string | void;
+export declare type ColumnViewRenderer<TRow = unknown, TValue = unknown> = (ctx: CellRenderContext<TRow, TValue>) => Node | string | void;
 
-declare type ColumnViewRenderer_2<TRow = any, TValue = any> = (ctx: CellRenderContext_2<TRow, TValue>) => Node | string | void;
+declare type ColumnViewRenderer_2<TRow = unknown, TValue = unknown> = (ctx: CellRenderContext_2<TRow, TValue>) => Node | string | void;
 
 /**
  * Column Virtualization Plugin Types
@@ -1819,11 +1883,11 @@ export declare class ColumnVirtualizationPlugin extends BaseGridPlugin_2<ColumnV
  */
 declare interface ContextMenuConfig {
     /** Menu items - static array or function returning items */
-    items?: ContextMenuItem_3[] | ((params: ContextMenuParams_3) => ContextMenuItem_3[]);
+    items?: ContextMenuItem_2[] | ((params: ContextMenuParams_2) => ContextMenuItem_2[]);
 }
 
 /**
- * Context menu item
+ * Context menu item (used by context-menu plugin query)
  */
 export declare interface ContextMenuItem {
     id: string;
@@ -1835,19 +1899,6 @@ export declare interface ContextMenuItem {
     action?: (params: ContextMenuParams) => void;
 }
 
-/**
- * Context menu item
- */
-declare interface ContextMenuItem_2 {
-    id: string;
-    label: string;
-    icon?: string;
-    disabled?: boolean;
-    separator?: boolean;
-    children?: ContextMenuItem_2[];
-    action?: (params: ContextMenuParams_2) => void;
-}
-
 /**
  * Context Menu Plugin Types
  *
@@ -1857,7 +1908,7 @@ declare interface ContextMenuItem_2 {
  * Context menu item definition.
  * Supports icons, shortcuts, submenus, separators, and dynamic disabled/hidden states.
  */
-declare interface ContextMenuItem_3 {
+declare interface ContextMenuItem_2 {
     /** Unique identifier for the menu item */
     id: string;
     /** Display label for the menu item */
@@ -1867,13 +1918,13 @@ declare interface ContextMenuItem_3 {
     /** Optional keyboard shortcut hint (display only) */
     shortcut?: string;
     /** Whether the item is disabled (static or dynamic) */
-    disabled?: boolean | ((params: ContextMenuParams_3) => boolean);
+    disabled?: boolean | ((params: ContextMenuParams_2) => boolean);
     /** Whether the item is hidden (static or dynamic) */
-    hidden?: boolean | ((params: ContextMenuParams_3) => boolean);
+    hidden?: boolean | ((params: ContextMenuParams_2) => boolean);
     /** Action handler when the item is clicked */
-    action?: (params: ContextMenuParams_3) => void;
+    action?: (params: ContextMenuParams_2) => void;
     /** Nested submenu items */
-    subMenu?: ContextMenuItem_3[];
+    subMenu?: ContextMenuItem_2[];
     /** Whether this is a separator (id and name required but ignored) */
     separator?: boolean;
     /** Optional CSS class to add to the menu item */
@@ -1895,26 +1946,11 @@ export declare interface ContextMenuParams {
     isHeader?: boolean;
 }
 
-/**
- * Context menu parameters
- */
-declare interface ContextMenuParams_2 {
-    x: number;
-    y: number;
-    rowIndex?: number;
-    colIndex?: number;
-    field?: string;
-    value?: any;
-    row?: any;
-    column?: ColumnConfig_2;
-    isHeader?: boolean;
-}
-
 /**
  * Parameters passed to context menu callbacks.
  * Provides context about what element triggered the menu.
  */
-declare interface ContextMenuParams_3 {
+declare interface ContextMenuParams_2 {
     /** The row data object (null for header clicks) */
     row: unknown;
     /** The row index (-1 for header clicks) */
@@ -1971,7 +2007,7 @@ export declare class ContextMenuPlugin extends BaseGridPlugin_2<ContextMenuConfi
      * @param y - Y coordinate
      * @param params - Partial context menu parameters
      */
-    showMenu(x: number, y: number, params: Partial<ContextMenuParams_3>): void;
+    showMenu(x: number, y: number, params: Partial<ContextMenuParams_2>): void;
     /**
      * Hide the context menu.
      */
@@ -1983,36 +2019,37 @@ export declare class ContextMenuPlugin extends BaseGridPlugin_2<ContextMenuConfi
     isMenuOpen(): boolean;
 }
 
-export declare type DataGridCustomEvent<K extends keyof DataGridEventMap<any>, TRow = any> = CustomEvent<DataGridEventMap<TRow>[K]>;
+export declare type DataGridCustomEvent<K extends keyof DataGridEventMap<unknown>, TRow = unknown> = CustomEvent<DataGridEventMap<TRow>[K]>;
 
 export declare class DataGridElement<T = any> extends HTMLElement implements InternalGrid<T> {
     #private;
     static readonly tagName = "tbw-grid";
     static readonly version: string;
+    static get observedAttributes(): string[];
     _rows: T[];
     get _columns(): ColumnInternal<T>[];
     set _columns(value: ColumnInternal<T>[]);
-    get visibleColumns(): ColumnInternal<T>[];
-    rowPool: HTMLElement[];
+    get _visibleColumns(): ColumnInternal<T>[];
+    _headerRowEl: HTMLElement;
+    _bodyEl: HTMLElement;
+    _rowPool: HTMLElement[];
+    _resizeController: ResizeController;
+    _virtualization: VirtualState;
+    _focusRow: number;
+    _focusCol: number;
+    _sortState: {
+        field: string;
+        direction: 1 | -1;
+    } | null;
+    _activeEditRows: number;
+    _rowEditSnapshots: Map<number, T>;
+    _changedRowIndices: Set<number>;
+    _gridTemplate: string;
     __rowRenderEpoch: number;
-    activeEditRows: number;
-    resizeController: ResizeController;
     __didInitialAutoSize: boolean;
     __lightDomColumnsCache?: ColumnInternal[];
     __originalColumnNodes?: HTMLElement[];
-    headerRowEl: HTMLElement;
-    bodyEl: HTMLElement;
-    virtualization: VirtualState;
-    sortState: {
-        field: string;
-        direction: 1 | -1;
-    } | null;
     __originalOrder: T[];
-    focusRow: number;
-    focusCol: number;
-    gridTemplate: string;
-    rowEditSnapshots: Map<number, T>;
-    _changedRowIndices: Set<number>;
     get rows(): T[];
     set rows(value: T[]);
     /**
@@ -2028,63 +2065,54 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
     set fitMode(value: FitMode | undefined);
     get editOn(): string | undefined;
     set editOn(value: string | undefined);
-    get effectiveConfig(): GridConfig<T>;
-    /**
-     * Get the disconnect signal for event listener cleanup.
-     * This signal is aborted when the grid disconnects from the DOM.
-     * Plugins and internal code can use this for automatic listener cleanup.
-     * @example
-     * element.addEventListener('click', handler, { signal: this.grid.disconnectSignal });
-     */
-    get disconnectSignal(): AbortSignal;
+    /* Excluded from this release type: effectiveConfig */
+    /* Excluded from this release type: disconnectSignal */
     constructor();
-    /**
-     * Get a plugin instance by its class.
-     * Used by plugins for inter-plugin communication.
-     */
-    getPlugin<P extends BaseGridPlugin>(PluginClass: new (...args: any[]) => P): P | undefined;
-    /**
-     * Get a plugin instance by its name.
-     * Used for loose coupling between plugins (avoids static imports).
-     */
-    getPluginByName(name: string): BaseGridPlugin | undefined;
-    /**
-     * Request a full re-render of the grid.
-     * Called by plugins when they need the grid to update.
-     * Note: This does NOT reset plugin state - just re-processes rows/columns and renders.
-     */
-    requestRender(): void;
-    /**
-     * Request a lightweight style update without rebuilding DOM.
-     * Called by plugins when they only need to update CSS classes/styles.
-     * This runs all plugin afterRender hooks without rebuilding row/column DOM.
-     */
-    requestAfterRender(): void;
+    /* Excluded from this release type: getPlugin */
+    /* Excluded from this release type: getPluginByName */
+    /* Excluded from this release type: requestRender */
+    /* Excluded from this release type: requestAfterRender */
     connectedCallback(): void;
     disconnectedCallback(): void;
-    emitCellCommit(detail: CellCommitDetail<T>): void;
-    emitRowCommit(detail: RowCommitDetail<T>): void;
-    emitSortChange(detail: SortChangeDetail): void;
-    emitColumnResize(detail: ColumnResizeDetail): void;
-    emitActivateCell(detail: ActivateCellDetail): void;
-    updateTemplate(): void;
-    findHeaderRow(): HTMLElement;
-    findRenderedRowElement(rowIndex: number): HTMLElement | null;
+    /**
+     * Handle HTML attribute changes.
+     * Only processes attribute values when SET (non-null).
+     * Removing an attribute does NOT clear JS-set properties.
+     */
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    _emitCellCommit(detail: CellCommitDetail<T>): void;
+    _emitRowCommit(detail: RowCommitDetail<T>): void;
+    _emitSortChange(detail: SortChangeDetail): void;
+    _emitColumnResize(detail: ColumnResizeDetail): void;
+    _emitActivateCell(detail: ActivateCellDetail): void;
+    /* Excluded from this release type: findHeaderRow */
+    /* Excluded from this release type: findRenderedRowElement */
     /**
      * Dispatch a cell click event to the plugin system.
      * Returns true if any plugin handled the event.
      */
-    dispatchCellClick(event: MouseEvent, rowIndex: number, colIndex: number, cellEl: HTMLElement): boolean;
+    _dispatchCellClick(event: MouseEvent, rowIndex: number, colIndex: number, cellEl: HTMLElement): boolean;
     /**
      * Dispatch a header click event to the plugin system.
      * Returns true if any plugin handled the event.
      */
-    dispatchHeaderClick(event: MouseEvent, colIndex: number, headerEl: HTMLElement): boolean;
+    _dispatchHeaderClick(event: MouseEvent, colIndex: number, headerEl: HTMLElement): boolean;
     /**
      * Dispatch a keyboard event to the plugin system.
      * Returns true if any plugin handled the event.
      */
-    dispatchKeyDown(event: KeyboardEvent): boolean;
+    _dispatchKeyDown(event: KeyboardEvent): boolean;
+    /**
+     * Get horizontal scroll boundary offsets from plugins.
+     * Used by keyboard navigation to ensure focused cells are fully visible
+     * when plugins like pinned columns obscure part of the scroll area.
+     */
+    _getHorizontalScrollOffsets(rowEl?: HTMLElement, focusedCell?: HTMLElement): {
+        left: number;
+        right: number;
+        skipScroll?: boolean;
+    };
+    /* Excluded from this release type: queryPlugins */
     get changedRows(): T[];
     get changedRowIndices(): number[];
     resetChangedRows(silent?: boolean): Promise<void>;
@@ -2154,99 +2182,55 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
      * Get the current column state.
      */
     get columnState(): GridColumnState | undefined;
-    /**
-     * Request a state change event to be emitted.
-     * Called internally after resize, reorder, visibility, or sort changes.
-     * Plugins should call this after changing their state.
-     * The event is debounced to avoid excessive events during drag operations.
-     */
-    requestStateChange(): void;
+    /* Excluded from this release type: requestStateChange */
     /**
      * Reset column state to initial configuration.
      * Clears all user modifications (order, width, visibility, sort).
      */
     resetColumnState(): void;
-    /**
-     * Check if the tool panel is currently open.
-     */
+    /** Check if the tool panel is currently open. */
     get isToolPanelOpen(): boolean;
     /**
      * Get the currently active tool panel ID, or null if none is open.
      * @deprecated Use isToolPanelOpen and expandedToolPanelSections instead.
      */
     get activeToolPanel(): string | null;
-    /**
-     * Get the IDs of expanded accordion sections.
-     */
+    /** Get the IDs of expanded accordion sections. */
     get expandedToolPanelSections(): string[];
-    /**
-     * Open the tool panel (accordion view with all registered panels).
-     */
+    /** Open the tool panel (accordion view with all registered panels). */
     openToolPanel(): void;
-    /**
-     * Close the tool panel.
-     */
+    /** Close the tool panel. */
     closeToolPanel(): void;
-    /**
-     * Toggle the tool panel open/closed.
-     */
+    /** Toggle the tool panel open/closed. */
     toggleToolPanel(): void;
-    /**
-     * Toggle an accordion section expanded/collapsed.
-     * Only one section can be expanded at a time (exclusive accordion).
-     * When there's only one panel, toggling is disabled (always expanded).
-     */
+    /** Toggle an accordion section expanded/collapsed. */
     toggleToolPanelSection(sectionId: string): void;
-    /**
-     * Get registered tool panel definitions.
-     */
+    /** Get registered tool panel definitions. */
     getToolPanels(): ToolPanelDefinition[];
-    /**
-     * Register a custom tool panel (without creating a plugin).
-     */
+    /** Register a custom tool panel (without creating a plugin). */
     registerToolPanel(panel: ToolPanelDefinition): void;
-    /**
-     * Unregister a custom tool panel.
-     */
+    /** Unregister a custom tool panel. */
     unregisterToolPanel(panelId: string): void;
-    /**
-     * Get registered header content definitions.
-     */
+    /** Get registered header content definitions. */
     getHeaderContents(): HeaderContentDefinition[];
-    /**
-     * Register custom header content (without creating a plugin).
-     */
+    /** Register custom header content (without creating a plugin). */
     registerHeaderContent(content: HeaderContentDefinition): void;
-    /**
-     * Unregister custom header content.
-     */
+    /** Unregister custom header content. */
     unregisterHeaderContent(contentId: string): void;
-    /**
-     * Get all registered toolbar buttons.
-     */
+    /** Get all registered toolbar buttons. */
     getToolbarButtons(): ToolbarButtonInfo[];
-    /**
-     * Register a custom toolbar button programmatically.
-     */
+    /** Register a custom toolbar button programmatically. */
     registerToolbarButton(button: ToolbarButtonConfig): void;
-    /**
-     * Unregister a custom toolbar button.
-     */
+    /** Unregister a custom toolbar button. */
     unregisterToolbarButton(buttonId: string): void;
-    /**
-     * Enable/disable a toolbar button by ID.
-     */
+    /** Enable/disable a toolbar button by ID. */
     setToolbarButtonDisabled(buttonId: string, disabled: boolean): void;
     /**
      * Re-parse light DOM shell elements and refresh shell header.
      * Call this after dynamically modifying <tbw-grid-header> children.
      */
     refreshShellHeader(): void;
-    /**
-     * Core virtualization routine. Chooses between bypass (small datasets), grouped window rendering,
-     * or standard row window rendering.
-     */
-    refreshVirtualWindow(force?: boolean): void;
+    /* Excluded from this release type: refreshVirtualWindow */
 }
 
 /**
@@ -2255,7 +2239,7 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
 export declare interface DataGridElementInterface extends PublicGrid, HTMLElement {
 }
 
-export declare interface DataGridEventMap<TRow = any> {
+export declare interface DataGridEventMap<TRow = unknown> {
     'cell-commit': CellCommitDetail<TRow>;
     'row-commit': RowCommitDetail<TRow>;
     'changed-rows-reset': ChangedRowsResetDetail<TRow>;
@@ -2331,7 +2315,7 @@ declare interface EditAction_2 {
  * Internal editor execution context extending the generic cell context with commit helpers.
  */
 declare interface EditorExecContext<T = any> extends CellContext<T> {
-    commit: (newValue: any) => void;
+    commit: (newValue: unknown) => void;
     cancel: () => void;
 }
 
@@ -2450,27 +2434,27 @@ export declare class ExportPlugin extends BaseGridPlugin_2<ExportConfig> {
     } | null;
 }
 
-export declare interface ExternalMountEditorDetail<TRow = any> {
+export declare interface ExternalMountEditorDetail<TRow = unknown> {
     placeholder: HTMLElement;
-    spec: any;
+    spec: unknown;
     context: {
         row: TRow;
-        value: any;
+        value: unknown;
         field: string;
-        column: any;
-        commit: (v: any) => void;
+        column: unknown;
+        commit: (v: unknown) => void;
         cancel: () => void;
     };
 }
 
-export declare interface ExternalMountViewDetail<TRow = any> {
+export declare interface ExternalMountViewDetail<TRow = unknown> {
     placeholder: HTMLElement;
-    spec: any;
+    spec: unknown;
     context: {
         row: TRow;
-        value: any;
+        value: unknown;
         field: string;
-        column: any;
+        column: unknown;
     };
 }
 
@@ -2774,6 +2758,10 @@ export declare function getValueAggregator(aggFunc: string): ValueAggregatorFn;
 /**
  * CSS class names used in the grid's shadow DOM.
  * Use these when adding/removing classes or querying elements.
+ *
+ * Classes are organized by:
+ * - Core: Used by the grid core for structure and basic functionality
+ * - Shared: Used by multiple features/plugins, styled by core CSS
  */
 export declare const GridClasses: {
     readonly ROOT: "tbw-grid-root";
@@ -2859,6 +2847,27 @@ export declare interface GridConfig<TRow = any> {
     fitMode?: FitMode;
     /** Edit activation mode ('click' | 'dblclick'). Can also be set via `editOn` prop. */
     editOn?: string;
+    /**
+     * Row height in pixels for virtualization calculations.
+     * The virtualization system assumes uniform row heights for performance.
+     *
+     * If not specified, the grid measures the first rendered row's height,
+     * which respects the CSS variable `--tbw-row-height` set by themes.
+     *
+     * Set this explicitly when:
+     * - Row content may wrap to multiple lines (also set `--tbw-cell-white-space: normal`)
+     * - Using custom row templates with variable content
+     * - You want to override theme-defined row height
+     *
+     * @default Auto-measured from first row (respects --tbw-row-height CSS variable)
+     *
+     * @example
+     * ```ts
+     * // Fixed height for rows that may wrap to 2 lines
+     * gridConfig = { rowHeight: 56 };
+     * ```
+     */
+    rowHeight?: number;
     /**
      * Array of plugin instances.
      * Each plugin is instantiated with its configuration and attached to this grid.
@@ -2872,7 +2881,7 @@ export declare interface GridConfig<TRow = any> {
      * ]
      * ```
      */
-    plugins?: any[];
+    plugins?: GridPlugin[];
     /**
      * Saved column state to restore on initialization.
      * Includes order, width, visibility, sort, and plugin-contributed state.
@@ -3016,6 +3025,34 @@ declare interface GridIcons_2 {
     toolPanel?: IconValue_2;
 }
 
+/**
+ * Minimal plugin interface for type-checking.
+ * This interface is defined here to avoid circular imports with BaseGridPlugin.
+ * All plugins must satisfy this shape (BaseGridPlugin implements it).
+ */
+export declare interface GridPlugin {
+    /** Unique plugin identifier */
+    readonly name: string;
+    /** Plugin version */
+    readonly version: string;
+    /** CSS styles to inject into grid's shadow DOM */
+    readonly styles?: string;
+}
+
+/**
+ * Minimal plugin interface for type-checking.
+ * This interface is defined here to avoid circular imports with BaseGridPlugin.
+ * All plugins must satisfy this shape (BaseGridPlugin implements it).
+ */
+declare interface GridPlugin_2 {
+    /** Unique plugin identifier */
+    readonly name: string;
+    /** Plugin version */
+    readonly version: string;
+    /** CSS styles to inject into grid's shadow DOM */
+    readonly styles?: string;
+}
+
 /**
  * Common CSS selectors for querying grid elements.
  * Built from the class constants for consistency.
@@ -3377,7 +3414,7 @@ export declare type IconValue = string | HTMLElement;
 declare type IconValue_2 = string | HTMLElement;
 
 /** Result of automatic column inference from sample rows. */
-export declare interface InferredColumnResult<TRow = any> {
+export declare interface InferredColumnResult<TRow = unknown> {
     columns: ColumnConfigMap<TRow>;
     typeMap: Record<string, PrimitiveColumnType>;
 }
@@ -3390,12 +3427,12 @@ declare interface InternalGrid<T = any> extends PublicGrid<T>, GridConfig<T> {
     _rows: T[];
     _columns: ColumnInternal<T>[];
     /** Visible columns only (excludes hidden). Use for rendering. */
-    visibleColumns: ColumnInternal<T>[];
-    headerRowEl: HTMLElement;
-    bodyEl: HTMLElement;
-    rowPool: HTMLElement[];
-    resizeController: ResizeController;
-    sortState: {
+    _visibleColumns: ColumnInternal<T>[];
+    _headerRowEl: HTMLElement;
+    _bodyEl: HTMLElement;
+    _rowPool: HTMLElement[];
+    _resizeController: ResizeController;
+    _sortState: {
         field: string;
         direction: 1 | -1;
     } | null;
@@ -3404,12 +3441,12 @@ declare interface InternalGrid<T = any> extends PublicGrid<T>, GridConfig<T> {
     __didInitialAutoSize?: boolean;
     __lightDomColumnsCache?: ColumnInternal[];
     __originalColumnNodes?: HTMLElement[];
-    gridTemplate: string;
-    virtualization: VirtualState;
-    focusRow: number;
-    focusCol: number;
-    activeEditRows: number;
-    rowEditSnapshots: Map<number, any>;
+    _gridTemplate: string;
+    _virtualization: VirtualState;
+    _focusRow: number;
+    _focusCol: number;
+    _activeEditRows: number;
+    _rowEditSnapshots: Map<number, T>;
     _changedRowIndices: Set<number>;
     changedRows?: T[];
     changedRowIndices?: number[];
@@ -3421,11 +3458,19 @@ declare interface InternalGrid<T = any> extends PublicGrid<T>, GridConfig<T> {
     beginBulkEdit?: (rowIndex: number) => void;
     commitActiveRowEdit?: () => void;
     /** Dispatch cell click to plugin system, returns true if handled */
-    dispatchCellClick?: (event: MouseEvent, rowIndex: number, colIndex: number, cellEl: HTMLElement) => boolean;
+    _dispatchCellClick?: (event: MouseEvent, rowIndex: number, colIndex: number, cellEl: HTMLElement) => boolean;
     /** Dispatch header click to plugin system, returns true if handled */
-    dispatchHeaderClick?: (event: MouseEvent, colIndex: number, headerEl: HTMLElement) => boolean;
+    _dispatchHeaderClick?: (event: MouseEvent, colIndex: number, headerEl: HTMLElement) => boolean;
     /** Dispatch keydown to plugin system, returns true if handled */
-    dispatchKeyDown?: (event: KeyboardEvent) => boolean;
+    _dispatchKeyDown?: (event: KeyboardEvent) => boolean;
+    /** Get horizontal scroll boundary offsets from plugins (e.g., pinned columns) */
+    _getHorizontalScrollOffsets?: (rowEl?: HTMLElement, focusedCell?: HTMLElement) => {
+        left: number;
+        right: number;
+        skipScroll?: boolean;
+    };
+    /** Query all plugins with a generic query and collect responses */
+    queryPlugins?: <T>(query: PluginQuery) => T[];
     /** Request emission of column-state-change event (debounced) */
     requestStateChange?: () => void;
 }
@@ -3652,6 +3697,10 @@ export declare class PinnedColumnsPlugin extends BaseGridPlugin_2<PinnedColumnsC
     }): boolean;
     processColumns(columns: readonly ColumnConfig_2[]): ColumnConfig_2[];
     afterRender(): void;
+    /**
+     * Handle inter-plugin queries.
+     */
+    onPluginQuery(query: PluginQuery_2): unknown;
     /**
      * Re-apply sticky offsets (e.g., after column resize).
      */
@@ -3668,6 +3717,15 @@ export declare class PinnedColumnsPlugin extends BaseGridPlugin_2<PinnedColumnsC
      * Clear all sticky positioning.
      */
     clearStickyPositions(): void;
+    /**
+     * Report horizontal scroll boundary offsets for pinned columns.
+     * Used by keyboard navigation to ensure focused cells aren't hidden behind sticky columns.
+     */
+    getHorizontalScrollOffsets(rowEl?: HTMLElement, focusedCell?: HTMLElement): {
+        left: number;
+        right: number;
+        skipScroll?: boolean;
+    } | undefined;
 }
 
 /** Configuration options for the status bar plugin */
@@ -3981,6 +4039,17 @@ declare interface PivotValueField_2 {
     header?: string;
 }
 
+/**
+ * Well-known plugin query types.
+ * Plugins can define additional query types beyond these.
+ */
+export declare const PLUGIN_QUERIES: {
+    /** Ask if a column can be moved. Context: ColumnConfig. Response: boolean | undefined */
+    readonly CAN_MOVE_COLUMN: "canMoveColumn";
+    /** Get context menu items. Context: ContextMenuParams. Response: ContextMenuItem[] */
+    readonly GET_CONTEXT_MENU_ITEMS: "getContextMenuItems";
+};
+
 /**
  * Cell render context for plugin cell renderers.
  * Provides full context including position and editing state.
@@ -4174,6 +4243,16 @@ export declare class PluginManager {
      * Returns true if any plugin handled the row.
      */
     renderRow(row: any, rowEl: HTMLElement, rowIndex: number): boolean;
+    /**
+     * Query all plugins with a generic query and collect responses.
+     * This enables inter-plugin communication without the core knowing plugin-specific concepts.
+     *
+     * Common query types are defined in PLUGIN_QUERIES, but plugins can define their own.
+     *
+     * @param query - The query object containing type and context
+     * @returns Array of non-undefined responses from plugins
+     */
+    queryPlugins<T>(query: PluginQuery): T[];
     /**
      * Execute onKeyDown hook on all plugins.
      * Returns true if any plugin handled the event.
@@ -4214,9 +4293,18 @@ export declare class PluginManager {
      */
     onCellMouseUp(event: CellMouseEvent): boolean;
     /**
-     * Collect context menu items from all plugins.
-     */
-    getContextMenuItems(params: ContextMenuParams): ContextMenuItem[];
+     * Collect horizontal scroll boundary offsets from all plugins.
+     * Combines offsets from all plugins that report them.
+     *
+     * @param rowEl - The row element (optional, for calculating widths from rendered cells)
+     * @param focusedCell - The currently focused cell element (optional, to determine if scrolling should be skipped)
+     * @returns Combined left and right pixel offsets, plus skipScroll if any plugin requests it
+     */
+    getHorizontalScrollOffsets(rowEl?: HTMLElement, focusedCell?: HTMLElement): {
+        left: number;
+        right: number;
+        skipScroll?: boolean;
+    };
     /**
      * Collect tool panels from all plugins.
      * Returns panels sorted by order (ascending).
@@ -4235,6 +4323,30 @@ export declare class PluginManager {
     }[];
 }
 
+/**
+ * Generic plugin query for inter-plugin communication.
+ * Plugins can define their own query types as string constants
+ * and respond to queries from other plugins.
+ */
+export declare interface PluginQuery<T = unknown> {
+    /** Query type identifier (e.g., 'canMoveColumn', 'getContextMenuItems') */
+    type: string;
+    /** Query-specific context/parameters */
+    context: T;
+}
+
+/**
+ * Generic plugin query for inter-plugin communication.
+ * Plugins can define their own query types as string constants
+ * and respond to queries from other plugins.
+ */
+declare interface PluginQuery_2<T = unknown> {
+    /** Query type identifier (e.g., 'canMoveColumn', 'getContextMenuItems') */
+    type: string;
+    /** Query-specific context/parameters */
+    context: T;
+}
+
 export declare type PrimitiveColumnType = 'number' | 'string' | 'date' | 'boolean' | 'select' | 'typeahead';
 
 /**
@@ -4369,7 +4481,7 @@ declare interface RowClickEvent_2 {
 }
 
 /** Detail payload for a committed row edit (may or may not include changes). */
-export declare interface RowCommitDetail<TRow = any> {
+export declare interface RowCommitDetail<TRow = unknown> {
     /** Row index that lost edit focus. */
     rowIndex: number;
     /** Row object reference. */
@@ -4390,7 +4502,7 @@ export declare interface RowGroupRenderConfig {
     /** If true, group rows span all columns (single full-width cell). Default false. */
     fullWidth?: boolean;
     /** Optional label formatter override. Receives raw group value + depth. */
-    formatLabel?: (value: any, depth: number, key: string) => string;
+    formatLabel?: (value: unknown, depth: number, key: string) => string;
     /** Optional aggregate overrides per field for group summary cells (only when not fullWidth). */
     aggregators?: Record<string, AggregatorRef>;
     /** Additional CSS class applied to each group row root element. */