@toolbox-web/grid 0.3.3 → 0.4.1

package/lib/core/internal/shell.d.ts

@@ -1,6 +1,12 @@
 import { HeaderContentDefinition, IconValue, ShellConfig, ToolbarButtonConfig, ToolbarButtonInfo, ToolPanelDefinition } from '../types';
 /**
  * State for managing shell UI.
+ *
+ * NOTE: This interface is being refactored. Config-like properties are moving
+ * to effectiveConfig.shell. Only runtime state should remain here.
+ *
+ * @deprecated Properties that are configuration (toolPanels, headerContents, etc.)
+ * are moving to ShellConfig in types.ts. Use ShellRuntimeState for new code.
  */
 export interface ShellState {
     /** Registered tool panels (from plugins + consumer API) */
@@ -30,14 +36,43 @@ export interface ShellState {
     /** Cleanup functions for toolbar button render returns */
     toolbarButtonCleanups: Map<string, () => void>;
 }
+/**
+ * Runtime-only shell state (not configuration).
+ *
+ * Configuration (toolPanels, headerContents, toolbarButtons, title) lives in
+ * effectiveConfig.shell. This state holds runtime UI state and cleanup functions.
+ */
+export interface ShellRuntimeState {
+    /** Whether the tool panel sidebar is currently open */
+    isPanelOpen: boolean;
+    /** Which accordion sections are currently expanded (by panel ID) */
+    expandedSections: Set<string>;
+    /** Cleanup functions for header content render returns */
+    headerContentCleanups: Map<string, () => void>;
+    /** Cleanup functions for each panel section's render return */
+    panelCleanups: Map<string, () => void>;
+    /** Cleanup functions for toolbar button render returns */
+    toolbarButtonCleanups: Map<string, () => void>;
+    /** IDs of tool panels registered from light DOM (to avoid re-parsing) */
+    lightDomToolPanelIds: Set<string>;
+    /** IDs of tool panels registered via registerToolPanel API */
+    apiToolPanelIds: Set<string>;
+    /** Whether a <tbw-grid-tool-buttons> container was found in light DOM */
+    hasToolButtonsContainer: boolean;
+}
+/**
+ * Create initial shell runtime state.
+ */
+export declare function createShellRuntimeState(): ShellRuntimeState;
 /**
  * Create initial shell state.
  */
 export declare function createShellState(): ShellState;
 /**
  * Determine if shell header should be rendered.
+ * Reads only from effectiveConfig.shell (single source of truth).
  */
-export declare function shouldRenderShellHeader(config: ShellConfig | undefined, state: ShellState): boolean;
+export declare function shouldRenderShellHeader(config: ShellConfig | undefined): boolean;
 /**
  * Render the shell header HTML.
  *
@@ -236,7 +271,10 @@ export declare const GRID_CONTENT_HTML = "\n  <div class=\"tbw-scroll-area\">\n
  * @param icons - Optional icons
  * @returns Whether shell is active (for post-render setup)
  */
-export declare function buildGridDOMIntoShadow(shadowRoot: ShadowRoot, shellConfig: ShellConfig | undefined, state: ShellState, icons?: {
+export declare function buildGridDOMIntoShadow(shadowRoot: ShadowRoot, shellConfig: ShellConfig | undefined, runtimeState: {
+    isPanelOpen: boolean;
+    expandedSections: Set<string>;
+}, icons?: {
     toolPanel?: IconValue;
     expand?: IconValue;
     collapse?: IconValue;

package/lib/core/internal/shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/shell.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/shell.ts"],"names":[],"mappings":"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"}

package/lib/core/internal/validate-config.d.ts

@@ -0,0 +1,25 @@
+import { BaseGridPlugin } from '../plugin';
+import { GridConfig } from '../types';
+/**
+ * Validate that column properties requiring plugins have those plugins loaded.
+ *
+ * @param config - The merged grid configuration
+ * @param plugins - The array of loaded plugins
+ * @throws Error if a plugin-owned property is used without the plugin
+ */
+export declare function validatePluginProperties<T>(config: GridConfig<T>, plugins: readonly BaseGridPlugin[]): void;
+/**
+ * Validate plugin-to-plugin dependencies.
+ * Called by PluginManager when attaching a new plugin.
+ *
+ * Dependencies are read from the plugin's static `dependencies` property.
+ *
+ * For hard dependencies (required: true), throws an error if the dependency is not loaded.
+ * For soft dependencies (required: false), logs an info message but continues.
+ *
+ * @param plugin - The plugin instance being attached
+ * @param loadedPlugins - The array of already-loaded plugins
+ * @throws Error if a required dependency is missing
+ */
+export declare function validatePluginDependencies(plugin: BaseGridPlugin, loadedPlugins: readonly BaseGridPlugin[]): void;
+//# sourceMappingURL=validate-config.d.ts.map

package/lib/core/internal/validate-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-config.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/validate-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,UAAU,CAAC;AAwGzD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI,CAiF3G;AAyCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI,CAmCjH"}

package/lib/core/plugin/base-plugin.d.ts

@@ -9,6 +9,13 @@ export type { CellClickEvent, CellCoords, CellEditor, CellMouseEvent, CellRender
 export interface GridElement extends GridElementRef {
     getPlugin<T extends BaseGridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined;
     getPluginByName(name: string): BaseGridPlugin | undefined;
+    /**
+     * Get a plugin's state by plugin name.
+     * This is a loose-coupling method for plugins to access other plugins' state
+     * without importing the plugin class directly.
+     * @internal Plugin API
+     */
+    getPluginState?(name: string): unknown;
 }
 /**
  * Header render context for plugin header renderers.
@@ -19,12 +26,61 @@ export interface PluginHeaderRenderContext {
     /** Column index */
     colIndex: number;
 }
+/**
+ * Declares a dependency on another plugin.
+ *
+ * @example
+ * ```typescript
+ * export class UndoRedoPlugin extends BaseGridPlugin {
+ *   static readonly dependencies: PluginDependency[] = [
+ *     { name: 'editing', required: true },
+ *   ];
+ * }
+ * ```
+ */
+export interface PluginDependency {
+    /**
+     * The name of the required plugin (matches the plugin's `name` property).
+     * Use string names for loose coupling - avoids static imports.
+     */
+    name: string;
+    /**
+     * Whether this dependency is required (hard) or optional (soft).
+     * - `true`: Plugin cannot function without it. Throws error if missing.
+     * - `false`: Plugin works with reduced functionality. Logs info if missing.
+     * @default true
+     */
+    required?: boolean;
+    /**
+     * Human-readable reason for this dependency.
+     * Shown in error/info messages to help users understand why.
+     * @example "UndoRedoPlugin needs EditingPlugin to track cell edits"
+     */
+    reason?: string;
+}
 /**
  * Abstract base class for all grid plugins.
  *
  * @template TConfig - Configuration type for the plugin
  */
 export declare abstract class BaseGridPlugin<TConfig = unknown> implements GridPlugin {
+    #private;
+    /**
+     * Plugin dependencies - declare other plugins this one requires.
+     *
+     * Dependencies are validated when the plugin is attached.
+     * Required dependencies throw an error if missing.
+     * Optional dependencies log an info message if missing.
+     *
+     * @example
+     * ```typescript
+     * static readonly dependencies: PluginDependency[] = [
+     *   { name: 'editing', required: true, reason: 'Tracks cell edits for undo/redo' },
+     *   { name: 'selection', required: false, reason: 'Enables selection-based undo' },
+     * ];
+     * ```
+     */
+    static readonly dependencies?: PluginDependency[];
     /** Unique plugin identifier (derived from class name by default) */
     abstract readonly name: string;
     /** Plugin version - override in subclass if needed */
@@ -53,16 +109,78 @@ export declare abstract class BaseGridPlugin<TConfig = unknown> implements GridP
     /**
      * Called when the plugin is attached to a grid.
      * Override to set up event listeners, initialize state, etc.
+     *
+     * @example
+     * ```ts
+     * attach(grid: GridElement): void {
+     *   super.attach(grid);
+     *   // Set up document-level listeners with auto-cleanup
+     *   document.addEventListener('keydown', this.handleEscape, {
+     *     signal: this.disconnectSignal
+     *   });
+     * }
+     * ```
      */
     attach(grid: GridElement): void;
     /**
      * Called when the plugin is detached from a grid.
      * Override to clean up event listeners, timers, etc.
+     *
+     * @example
+     * ```ts
+     * detach(): void {
+     *   // Clean up any state not handled by disconnectSignal
+     *   this.selectedRows.clear();
+     *   this.cache = null;
+     * }
+     * ```
      */
     detach(): void;
+    /**
+     * Called when another plugin is attached to the same grid.
+     * Use for inter-plugin coordination, e.g., to integrate with new plugins.
+     *
+     * @param name - The name of the plugin that was attached
+     * @param plugin - The plugin instance (for direct access if needed)
+     *
+     * @example
+     * ```ts
+     * onPluginAttached(name: string, plugin: BaseGridPlugin): void {
+     *   if (name === 'selection') {
+     *     // Integrate with selection plugin
+     *     this.selectionPlugin = plugin as SelectionPlugin;
+     *   }
+     * }
+     * ```
+     */
+    onPluginAttached?(name: string, plugin: BaseGridPlugin): void;
+    /**
+     * Called when another plugin is detached from the same grid.
+     * Use to clean up inter-plugin references.
+     *
+     * @param name - The name of the plugin that was detached
+     *
+     * @example
+     * ```ts
+     * onPluginDetached(name: string): void {
+     *   if (name === 'selection') {
+     *     this.selectionPlugin = undefined;
+     *   }
+     * }
+     * ```
+     */
+    onPluginDetached?(name: string): void;
     /**
      * Get another plugin instance from the same grid.
      * Use for inter-plugin communication.
+     *
+     * @example
+     * ```ts
+     * const selection = this.getPlugin(SelectionPlugin);
+     * if (selection) {
+     *   const selectedRows = selection.getSelectedRows();
+     * }
+     * ```
      */
     protected getPlugin<T extends BaseGridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined;
     /**

package/lib/core/plugin/base-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-plugin.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/plugin/base-plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-plugin.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/plugin/base-plugin.ts"],"names":[],"mappings":"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"}

package/lib/core/plugin/index.d.ts

@@ -7,5 +7,6 @@
 export { BaseGridPlugin, PLUGIN_QUERIES } from './base-plugin';
 export type { CellClickEvent, CellCoords, CellEditor, CellMouseEvent, CellRenderer, ContextMenuItem, ContextMenuParams, GridElement, HeaderClickEvent, HeaderRenderer, KeyboardModifiers, PluginCellRenderContext, PluginHeaderRenderContext, PluginQuery, RowClickEvent, ScrollEvent, } from './base-plugin';
 export { PluginManager } from './plugin-manager';
+export type { PluginDependency } from './base-plugin';
 export type { ColumnConfig } from '../types';
 //# sourceMappingURL=index.d.ts.map

package/lib/core/plugin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EACV,cAAc,EACd,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,EACzB,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAIjD,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EACV,cAAc,EACd,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,EACzB,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAIjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAItD,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/lib/core/plugin/plugin-manager.d.ts

@@ -1,12 +1,17 @@
 import { ColumnConfig } from '../types';
-import { BaseGridPlugin, CellClickEvent, CellEditor, CellMouseEvent, CellRenderer, HeaderClickEvent, HeaderRenderer, PluginQuery, RowClickEvent, ScrollEvent } from './base-plugin';
+import { BaseGridPlugin, CellClickEvent, CellEditor, CellMouseEvent, CellRenderer, GridElement, HeaderClickEvent, HeaderRenderer, PluginQuery, RowClickEvent, ScrollEvent } from './base-plugin';
 /**
  * Manages plugins for a single grid instance.
+ *
+ * Plugins are executed in array order. This is intentional and documented behavior.
+ * Place plugins in the order you want their hooks to execute.
  */
 export declare class PluginManager {
     private grid;
     /** Plugin instances in order of attachment */
     private plugins;
+    /** Get all registered plugins (read-only) */
+    getPlugins(): readonly BaseGridPlugin[];
     /** Map from plugin class to instance for fast lookup */
     private pluginMap;
     /** Cell renderers registered by plugins */
@@ -15,17 +20,19 @@ export declare class PluginManager {
     private headerRenderers;
     /** Cell editors registered by plugins */
     private cellEditors;
-    constructor(grid: any);
+    constructor(grid: GridElement);
     /**
      * Attach all plugins from the config.
      */
     attachAll(plugins: BaseGridPlugin[]): void;
     /**
      * Attach a plugin to this grid.
+     * Validates dependencies and notifies other plugins of the new attachment.
      */
     attach(plugin: BaseGridPlugin): void;
     /**
      * Detach all plugins and clean up.
+     * Notifies plugins of detachment via onPluginDetached hook.
      */
     detachAll(): void;
     /**
@@ -44,6 +51,10 @@ export declare class PluginManager {
      * Get all attached plugins.
      */
     getAll(): readonly BaseGridPlugin[];
+    /**
+     * Get names of all registered plugins (for debugging).
+     */
+    getRegisteredPluginNames(): string[];
     /**
      * Get a cell renderer by type name.
      */

package/lib/core/plugin/plugin-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-manager.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/plugin/plugin-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugin-manager.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/plugin/plugin-manager.ts"],"names":[],"mappings":"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"}

package/lib/core/plugin/types.d.ts

@@ -176,21 +176,35 @@ export interface CellEditor {
 /**
  * Minimal grid interface for plugins.
  * This avoids circular imports with the full DataGridElement.
+ *
+ * Member prefixes indicate accessibility:
+ * - `_underscore` = protected members accessible to plugins (marked @internal in full interface)
  */
 export interface GridElementRef {
     shadowRoot: ShadowRoot | null;
+    /** Current rows (after plugin processing like grouping, filtering). */
     rows: unknown[];
+    /** Original unfiltered/unprocessed rows. */
+    sourceRows: unknown[];
+    /** Column configurations. */
     columns: ColumnConfig[];
+    /** Visible columns only (excludes hidden). Use for rendering. @internal */
+    _visibleColumns: ColumnConfig[];
+    /** Full grid configuration. */
     gridConfig: GridConfig;
-    /** Current focused row index */
+    /** Current focused row index. @internal */
     _focusRow: number;
-    /** Current focused column index */
+    /** Current focused column index. @internal */
     _focusCol: number;
-    /** AbortSignal that is aborted when the grid disconnects from the DOM */
+    /** AbortSignal that is aborted when the grid disconnects from the DOM. */
     disconnectSignal: AbortSignal;
+    /** Request a full re-render of the grid. */
     requestRender(): void;
+    /** Request a lightweight style update without rebuilding DOM. */
     requestAfterRender(): void;
+    /** Force a layout pass. */
     forceLayout(): Promise<void>;
+    /** Dispatch an event from the grid element. */
     dispatchEvent(event: Event): boolean;
 }
 //# sourceMappingURL=types.d.ts.map

package/lib/core/plugin/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/plugin/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/plugin/types.ts"],"names":[],"mappings":"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"}

package/lib/core/types.d.ts

@@ -59,7 +59,11 @@ export interface PublicGrid<T = any> {
     getRegisteredStyles?: () => string[];
 }
 /**
- * Internal-only augmented interface for DataGrid component
+ * Internal-only augmented interface for DataGrid component.
+ *
+ * Member prefixes indicate accessibility:
+ * - `_underscore` = protected members - private outside core, accessible to plugins. Marked with @internal.
+ * - `__doubleUnderscore` = deeply internal members - private outside core, only for internal functions.
  */
 export interface InternalGrid<T = any> extends PublicGrid<T>, GridConfig<T> {
     shadowRoot: ShadowRoot | null;
@@ -69,32 +73,53 @@ export interface InternalGrid<T = any> extends PublicGrid<T>, GridConfig<T> {
     _visibleColumns: ColumnInternal<T>[];
     _headerRowEl: HTMLElement;
     _bodyEl: HTMLElement;
-    _rowPool: HTMLElement[];
+    _rowPool: RowElementInternal[];
     _resizeController: ResizeController;
     _sortState: {
         field: string;
         direction: 1 | -1;
     } | null;
+    /** Original unfiltered/unprocessed rows. @internal */
+    sourceRows: T[];
+    /** Framework adapter instance (set by Grid directives). @internal */
+    __frameworkAdapter?: FrameworkAdapter;
     __originalOrder: T[];
     __rowRenderEpoch: number;
     __didInitialAutoSize?: boolean;
     __lightDomColumnsCache?: ColumnInternal[];
     __originalColumnNodes?: HTMLElement[];
+    /** Cell display value cache. @internal */
+    __cellDisplayCache?: Map<number, string[]>;
+    /** Cache epoch for cell display values. @internal */
+    __cellCacheEpoch?: number;
+    /** Cached header row count for virtualization. @internal */
+    __cachedHeaderRowCount?: number;
+    /** Cached flag for whether grid has special columns (custom renderers, etc.). @internal */
+    __hasSpecialColumns?: boolean;
+    /** Cached flag for whether any plugin has renderRow hooks. @internal */
+    __hasRenderRowPlugins?: boolean;
     _gridTemplate: string;
     _virtualization: VirtualState;
     _focusRow: number;
     _focusCol: number;
-    _activeEditRows: number;
-    _rowEditSnapshots: Map<number, T>;
-    _changedRowIndices: Set<number>;
+    /** Currently active edit row index. Injected by EditingPlugin. @internal */
+    _activeEditRows?: number;
+    /** Snapshots of row data before editing. Injected by EditingPlugin. @internal */
+    _rowEditSnapshots?: Map<number, T>;
+    /** Set of row indices that have been modified. Injected by EditingPlugin. @internal */
+    _changedRowIndices?: Set<number>;
+    /** Get all changed rows. Injected by EditingPlugin. */
     changedRows?: T[];
+    /** Get indices of all changed rows. Injected by EditingPlugin. */
     changedRowIndices?: number[];
     effectiveConfig?: GridConfig<T>;
     findHeaderRow?: () => HTMLElement;
     refreshVirtualWindow: (full: boolean) => void;
     updateTemplate?: () => void;
     findRenderedRowElement?: (rowIndex: number) => HTMLElement | null;
+    /** Begin bulk edit on a row. Injected by EditingPlugin. */
     beginBulkEdit?: (rowIndex: number) => void;
+    /** Commit active row edit. Injected by EditingPlugin. */
     commitActiveRowEdit?: () => void;
     /** Dispatch cell click to plugin system, returns true if handled */
     _dispatchCellClick?: (event: MouseEvent, rowIndex: number, colIndex: number, cellEl: HTMLElement) => boolean;
@@ -137,10 +162,6 @@ export interface BaseColumnConfig<TRow = any, TValue = any> {
     resizable?: boolean;
     /** Optional custom comparator for sorting (a,b) -> number */
     sortComparator?: (a: TValue, b: TValue, rowA: TRow, rowB: TRow) => number;
-    /** Whether the field is editable (enables editors) */
-    editable?: boolean;
-    /** Optional custom editor factory or element tag name */
-    editor?: ColumnEditorSpec<TRow, TValue>;
     /** For select/typeahead types - available options */
     options?: Array<{
         label: string;
@@ -249,7 +270,7 @@ export interface CellRenderContext<TRow = any, TValue = any> {
      */
     cellEl?: HTMLElement;
 }
-export type ColumnViewRenderer<TRow = unknown, TValue = unknown> = (ctx: CellRenderContext<TRow, TValue>) => Node | string | void;
+export type ColumnViewRenderer<TRow = unknown, TValue = unknown> = (ctx: CellRenderContext<TRow, TValue>) => Node | string | void | null;
 /**
  * Framework adapter interface for handling framework-specific component instantiation.
  * Allows framework libraries (Angular, React, Vue) to register handlers that convert
@@ -307,7 +328,23 @@ export interface FrameworkAdapter {
      */
     createToolPanelRenderer?(element: HTMLElement): ((container: HTMLElement) => void | (() => void)) | undefined;
 }
-export interface ColumnInternal<T = any> extends ColumnConfig<T> {
+/**
+ * Column internal properties used during light DOM parsing.
+ * Stores attribute-based names before they're resolved to actual functions.
+ * @internal
+ */
+export interface ColumnParsedAttributes {
+    /** Editor name from `editor` attribute (resolved later) */
+    __editorName?: string;
+    /** Renderer name from `renderer` attribute (resolved later) */
+    __rendererName?: string;
+}
+/**
+ * Extended column config used internally.
+ * Includes all internal properties needed during grid lifecycle.
+ * @internal
+ */
+export interface ColumnInternal<T = any> extends ColumnConfig<T>, ColumnParsedAttributes {
     __autoSized?: boolean;
     __userResized?: boolean;
     __renderedWidth?: number;
@@ -316,9 +353,42 @@ export interface ColumnInternal<T = any> extends ColumnConfig<T> {
     __viewTemplate?: HTMLElement;
     __editorTemplate?: HTMLElement;
     __headerTemplate?: HTMLElement;
-    __compiledView?: (ctx: CellContext<T>) => string;
+    __compiledView?: CompiledViewFunction<T>;
     __compiledEditor?: (ctx: EditorExecContext<T>) => string;
 }
+/**
+ * Row element with internal tracking properties.
+ * Used during virtualization and row pooling.
+ * @internal
+ */
+export interface RowElementInternal extends HTMLElement {
+    /** Epoch marker for row render invalidation */
+    __epoch?: number;
+    /** Reference to the row data object for change detection */
+    __rowDataRef?: unknown;
+    /** Count of cells currently in edit mode */
+    __editingCellCount?: number;
+    /** Flag indicating this is a custom-rendered row (group row, etc.) */
+    __isCustomRow?: boolean;
+}
+/**
+ * Type-safe access to element.part API (DOMTokenList-like).
+ * Used for CSS ::part styling support.
+ * @internal
+ */
+export interface ElementWithPart {
+    part?: DOMTokenList;
+}
+/**
+ * Compiled view function type with optional blocked flag.
+ * The __blocked flag is set when a template contains unsafe expressions.
+ * @internal
+ */
+export interface CompiledViewFunction<T = any> {
+    (ctx: CellContext<T>): string;
+    /** Set to true when template was blocked due to unsafe expressions */
+    __blocked?: boolean;
+}
 /**
  * Runtime cell context used internally for compiled template execution.
  */
@@ -359,6 +429,14 @@ export interface VirtualState {
     /** Spacer element inside faux scrollbar for setting virtual height */
     totalHeightEl: HTMLElement | null;
 }
+/**
+ * Union type for input-like elements that have a `value` property.
+ * Covers standard form elements and custom elements with value semantics.
+ * @internal
+ */
+export type InputLikeElement = HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement | {
+    value: unknown;
+};
 /**
  * Group row rendering customization options.
  * Used within grouping-rows plugin config for presentation of group rows.
@@ -624,6 +702,18 @@ export interface ShellConfig {
     header?: ShellHeaderConfig;
     /** Tool panel configuration */
     toolPanel?: ToolPanelConfig;
+    /**
+     * Registered tool panels (from plugins, API, or Light DOM).
+     * These are the actual panel definitions that can be opened.
+     * @internal Set by ConfigManager during merge
+     */
+    toolPanels?: ToolPanelDefinition[];
+    /**
+     * Registered header content sections (from plugins or API).
+     * Content rendered in the center of the shell header.
+     * @internal Set by ConfigManager during merge
+     */
+    headerContents?: HeaderContentDefinition[];
 }
 /**
  * Shell header bar configuration
@@ -633,6 +723,16 @@ export interface ShellHeaderConfig {
     title?: string;
     /** Custom toolbar buttons (rendered before tool panel toggles) */
     toolbarButtons?: ToolbarButtonConfig[];
+    /**
+     * Light DOM header content elements (parsed from <tbw-grid-header> children).
+     * @internal Set by ConfigManager during merge
+     */
+    lightDomContent?: HTMLElement[];
+    /**
+     * Whether a tool buttons container was found in light DOM.
+     * @internal Set by ConfigManager during merge
+     */
+    hasToolButtonsContainer?: boolean;
 }
 /**
  * Tool panel configuration