@toolbox-web/grid 0.3.3 → 0.4.0

package/lib/core/grid.d.ts

@@ -49,15 +49,22 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
         field: string;
         direction: 1 | -1;
     } | null;
-    _activeEditRows: number;
-    _rowEditSnapshots: Map<number, T>;
-    _changedRowIndices: Set<number>;
     _gridTemplate: string;
     __rowRenderEpoch: number;
     __didInitialAutoSize: boolean;
-    __lightDomColumnsCache?: ColumnInternal[];
-    __originalColumnNodes?: HTMLElement[];
+    /** Light DOM columns cache - delegates to ConfigManager */
+    get __lightDomColumnsCache(): ColumnInternal[] | undefined;
+    set __lightDomColumnsCache(value: ColumnInternal[] | undefined);
+    /** Original column nodes - delegates to ConfigManager */
+    get __originalColumnNodes(): HTMLElement[] | undefined;
+    set __originalColumnNodes(value: HTMLElement[] | undefined);
     __originalOrder: T[];
+    /**
+     * Framework adapter instance set by framework directives (Angular Grid, React DataGrid).
+     * Used to handle framework-specific component rendering.
+     * @internal
+     */
+    __frameworkAdapter?: FrameworkAdapter;
     __rowsBodyEl: HTMLElement | null;
     get rows(): T[];
     set rows(value: T[]);
@@ -186,14 +193,15 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
      * const canMove = !responses.includes(false);
      */
     queryPlugins<T>(query: PluginQuery): T[];
-    get changedRows(): T[];
-    get changedRowIndices(): number[];
-    resetChangedRows(silent?: boolean): Promise<void>;
-    beginBulkEdit(rowIndex: number): Promise<void>;
-    commitActiveRowEdit(): Promise<void>;
-    cancelActiveRowEdit(): Promise<void>;
     ready(): Promise<void>;
     forceLayout(): Promise<void>;
+    /**
+     * Trim the internal row pool to match the current visible window size.
+     *
+     * The grid maintains a pool of reusable row DOM elements for virtualization.
+     * When the dataset shrinks significantly (e.g., after filtering or deleting rows),
+     * the pool may have excess elements that consume memory unnecessarily.
+     *
     /** Public method: returns a frozen snapshot of the merged effective configuration */
     getConfig(): Promise<Readonly<GridConfig<T>>>;
     setColumnVisible(field: string, visible: boolean): boolean;
@@ -281,6 +289,8 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
      * Register custom CSS styles to be injected into the grid's shadow DOM.
      * Use this to style custom cell renderers, editors, or detail panels.
      *
+     * Uses adoptedStyleSheets for efficiency - styles survive shadow DOM rebuilds.
+     *
      * @param id - Unique identifier for the style block (for removal/updates)
      * @param css - CSS string to inject
      *
@@ -312,7 +322,7 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
     /**
      * Re-parse light DOM column elements and refresh the grid.
      * Call this after framework adapters have registered their templates.
-     * Debounced to coalesce multiple calls (e.g., from React StrictMode double-mounting).
+     * Uses the render scheduler to batch with other pending updates.
      * @internal Used by framework integration libraries (Angular, React, Vue)
      */
     refreshColumns(): void;

package/lib/core/grid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../../../../../libs/grid/src/lib/core/grid.ts"],"names":[],"mappings":"AAwDA,OAAO,KAAK,EACV,cAAc,EAGd,WAAW,EAEZ,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAEV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,OAAO,EACP,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,uBAAuB,EACvB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACb,MAAM,SAAS,CAAC;AAmDjB,qBAAa,eAAe,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,WAAY,YAAW,YAAY,CAAC,CAAC,CAAC;;IAElF,MAAM,CAAC,QAAQ,CAAC,OAAO,cAAc;IACrC,MAAM,CAAC,QAAQ,CAAC,OAAO,SAAsE;IAG7F;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IAEjD;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAIvD;;;OAGG;IACH,MAAM,CAAC,WAAW,IAAI,SAAS,gBAAgB,EAAE;IAIjD;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAK5B,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAgFD,KAAK,EAAE,CAAC,EAAE,CAAM;IAShB,IAAI,QAAQ,IAAI,cAAc,CAAC,CAAC,CAAC,EAAE,CAElC;IACD,IAAI,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,EAEtC;IAID,IAAI,eAAe,IAAI,cAAc,CAAC,CAAC,CAAC,EAAE,CAEzC;IAKD,YAAY,EAAG,WAAW,CAAC;IAC3B,OAAO,EAAG,WAAW,CAAC;IACtB,QAAQ,EAAE,WAAW,EAAE,CAAM;IAC7B,iBAAiB,EAAG,gBAAgB,CAAC;IAGrC,eAAe,EAAE,YAAY,CAS3B;IAGF,SAAS,SAAK;IACd,SAAS,SAAK;IAGd,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;KAAE,GAAG,IAAI,CAAQ;IAG/D,eAAe,SAAM;IACrB,iBAAiB,iBAAwB;IACzC,kBAAkB,cAAqB;IAGvC,aAAa,SAAM;IAInB,gBAAgB,SAAK;IACrB,oBAAoB,UAAS;IAC7B,sBAAsB,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1C,qBAAqB,CAAC,EAAE,WAAW,EAAE,CAAC;IACtC,eAAe,EAAE,CAAC,EAAE,CAAM;IAG1B,YAAY,EAAE,WAAW,GAAG,IAAI,CAAQ;IAQxC,IAAI,IAAI,IAAI,CAAC,EAAE,CAEd;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAMlB;IAED;;;OAGG;IACH,IAAI,UAAU,IAAI,CAAC,EAAE,CAEpB;IAED,IAAI,OAAO,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,CAE/B;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,EAMpE;IAED,IAAI,UAAU,IAAI,UAAU,CAAC,CAAC,CAAC,CAE9B;IACD,IAAI,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,EAS9C;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,EAMrC;IAED,IAAI,MAAM,IAAI,MAAM,GAAG,OAAO,GAAG,SAAS,CAEzC;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,EAM7C;IAED;;;;;OAKG;IACH,IAAI,eAAe,IAAI,UAAU,CAAC,CAAC,CAAC,CAEnC;IAED;;;;;;;OAOG;IACH,IAAI,gBAAgB,IAAI,WAAW,CAMlC;;IAiFD;;;;OAIG;IACH,SAAS,CAAC,CAAC,SAAS,cAAc,EAAE,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS;IAI1F;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIzD;;;;;OAKG;IACH,aAAa,IAAI,IAAI;IAQrB;;;;OAIG;IACH,cAAc,IAAI,IAAI;IAItB;;;;;OAKG;IACH,kBAAkB,IAAI,IAAI;IAsJ1B,iBAAiB,IAAI,IAAI;IAwDzB,oBAAoB,IAAI,IAAI;IAmE5B;;;;OAIG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAu4B9F;;;;OAIG;IACH,aAAa,IAAI,WAAW;IAI5B;;;;;;OAMG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAS5D;;;OAGG;IACH,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO;IAkBvG;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO;IAa7F;;;OAGG;IACH,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO;IAezF;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAI/C;;;;OAIG;IACH,2BAA2B,CACzB,KAAK,CAAC,EAAE,WAAW,EACnB,WAAW,CAAC,EAAE,WAAW,GACxB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE;IAIxD;;;;;;;;;OASG;IACH,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,GAAG,CAAC,EAAE;IA4GxC,IAAI,WAAW,IAAI,CAAC,EAAE,CAErB;IAED,IAAI,iBAAiB,IAAI,MAAM,EAAE,CAEhC;IAEK,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9C,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC,qFAAqF;IAC/E,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAmBnD,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAI1D,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI9C,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIvC,cAAc,IAAI,IAAI;IAItB,aAAa,IAAI,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAIlG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAQrC,cAAc,IAAI,MAAM,EAAE;IAM1B;;;OAGG;IACH,cAAc,IAAI,eAAe;IAKjC;;;OAGG;IACH,IAAI,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,EAUjD;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,eAAe,GAAG,SAAS,CAE7C;IAkBD;;;;;;OAMG;IACH,kBAAkB,IAAI,IAAI;IAW1B;;;OAGG;IACH,gBAAgB,IAAI,IAAI;IA0CxB,iDAAiD;IACjD,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;;OAGG;IACH,IAAI,eAAe,IAAI,MAAM,GAAG,IAAI,CAEnC;IAED,kDAAkD;IAClD,IAAI,yBAAyB,IAAI,MAAM,EAAE,CAExC;IAED,uEAAuE;IACvE,aAAa,IAAI,IAAI;IAIrB,4BAA4B;IAC5B,cAAc,IAAI,IAAI;IAItB,yCAAyC;IACzC,eAAe,IAAI,IAAI;IAIvB,sDAAsD;IACtD,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI/C,6CAA6C;IAC7C,aAAa,IAAI,mBAAmB,EAAE;IAItC,gEAAgE;IAChE,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAKnD,sCAAsC;IACtC,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK1C,iDAAiD;IACjD,iBAAiB,IAAI,uBAAuB,EAAE;IAI9C,kEAAkE;IAClE,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAI7D,wCAAwC;IACxC,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIhD,0CAA0C;IAC1C,iBAAiB,IAAI,iBAAiB,EAAE;IAIxC,yDAAyD;IACzD,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAIxD,0CAA0C;IAC1C,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI/C,6CAA6C;IAC7C,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAInE;;;OAGG;IACH,kBAAkB,IAAI,IAAI;IAe1B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAY7C;;;OAGG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQlC;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAyG/B;;;;;OAKG;IACH,cAAc,IAAI,IAAI;IA+FtB;;;;OAIG;IACH,oBAAoB,CAAC,KAAK,UAAQ,GAAG,IAAI;CA8L1C;AAWD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,eAAe,CAAC;KAC7B;CACF"}
+{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../../../../../libs/grid/src/lib/core/grid.ts"],"names":[],"mappings":"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"}

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

@@ -17,15 +17,6 @@ export declare function mergeColumns(programmatic: ColumnConfig[] | undefined, d
  * without duplicating values. Falls back to string manipulation if `el.part` API isn't present.
  */
 export declare function addPart(el: HTMLElement, token: string): void;
-/**
- * Resolve the effective column list for the grid by combining:
- * 1. Programmatic columns (`grid._columns`)
- * 2. Light DOM `<tbw-grid-column>` definitions (cached)
- * 3. Inferred columns (if none provided)
- * Also compiles inline template expressions into fast functions.
- * Columns with `hidden: true` in config are added to hidden tracking.
- */
-export declare function getColumnConfiguration(grid: InternalGrid): void;
 /**
  * Measure rendered header + visible cell content to assign initial pixel widths
  * to columns when in `content` fit mode. Runs only once unless fit mode changes.

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

@@ -1 +1 @@
-{"version":3,"file":"columns.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/columns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAK3E;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,EAAE,CAyFxE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,YAAY,EAAE,GAAG,SAAS,EACxC,GAAG,EAAE,YAAY,EAAE,GAAG,SAAS,GAC9B,cAAc,EAAE,CA+DlB;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAS5D;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAqB/D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CA4BxD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CA0BvD"}
+{"version":3,"file":"columns.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/columns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAmB,YAAY,EAAuB,MAAM,UAAU,CAAC;AAYjH;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,EAAE,CA0FxE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,YAAY,EAAE,GAAG,SAAS,EACxC,GAAG,EAAE,YAAY,EAAE,GAAG,SAAS,GAC9B,cAAc,EAAE,CA+DlB;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAS5D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CA4BxD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CA0BvD"}

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

@@ -0,0 +1,236 @@
+import { BaseGridPlugin } from '../plugin';
+import { ColumnConfig, ColumnConfigMap, ColumnInternal, FitMode, GridColumnState, GridConfig, HeaderContentDefinition, ToolbarButtonConfig, ToolPanelDefinition } from '../types';
+/**
+ * Callbacks for ConfigManager to notify the grid of changes.
+ */
+export interface ConfigManagerCallbacks<T> {
+    /** Get current rows for column inference */
+    getRows: () => T[];
+    /** Get current sort state */
+    getSortState: () => {
+        field: string;
+        direction: 1 | -1;
+    } | null;
+    /** Set sort state */
+    setSortState: (state: {
+        field: string;
+        direction: 1 | -1;
+    } | null) => void;
+    /** Notify that config changed and re-render is needed */
+    onConfigChange: () => void;
+    /** Emit a custom event */
+    emit: (eventName: string, detail: unknown) => void;
+    /** Clear row pool for visibility changes */
+    clearRowPool: () => void;
+    /** Run setup after state changes */
+    setup: () => void;
+    /** Render header */
+    renderHeader: () => void;
+    /** Update column template */
+    updateTemplate: () => void;
+    /** Refresh virtual window */
+    refreshVirtualWindow: () => void;
+    /** Get virtualization state for row height application */
+    getVirtualization: () => {
+        rowHeight: number;
+    };
+    /** Set row height on virtualization state */
+    setRowHeight: (height: number) => void;
+    /** Apply animation config to host element */
+    applyAnimationConfig: (config: GridConfig<T>) => void;
+    /** Get light DOM title from shell state (synced from parseLightDomShell) */
+    getShellLightDomTitle: () => string | null;
+    /** Get registered tool panels from shell state */
+    getShellToolPanels: () => Map<string, ToolPanelDefinition>;
+    /** Get registered header contents from shell state */
+    getShellHeaderContents: () => Map<string, HeaderContentDefinition>;
+    /** Get registered toolbar buttons from shell state */
+    getShellToolbarButtons: () => Map<string, ToolbarButtonConfig>;
+    /** Get light DOM header content elements */
+    getShellLightDomHeaderContent: () => HTMLElement[];
+    /** Get whether a tool buttons container was found in light DOM */
+    getShellHasToolButtonsContainer: () => boolean;
+}
+/**
+ * ConfigManager handles all configuration lifecycle for the grid.
+ *
+ * Manages:
+ * - Source collection (gridConfig, columns, attributes, Light DOM)
+ * - Effective config (merged from all sources)
+ * - State persistence (collectState, applyState, resetState)
+ * - Column visibility and ordering
+ */
+export declare class ConfigManager<T = unknown> {
+    #private;
+    constructor(callbacks: ConfigManagerCallbacks<T>);
+    /** Get the frozen original config (compiled from sources, immutable) */
+    get original(): GridConfig<T>;
+    /** Get the mutable effective config (current runtime state) */
+    get effective(): GridConfig<T>;
+    /** Get columns from effective config */
+    get columns(): ColumnInternal<T>[];
+    /** Set columns on effective config */
+    set columns(value: ColumnInternal<T>[]);
+    /** Get light DOM columns cache */
+    get lightDomColumnsCache(): ColumnInternal<T>[] | undefined;
+    /** Set light DOM columns cache */
+    set lightDomColumnsCache(value: ColumnInternal<T>[] | undefined);
+    /** Get original column nodes */
+    get originalColumnNodes(): HTMLElement[] | undefined;
+    /** Set original column nodes */
+    set originalColumnNodes(value: HTMLElement[] | undefined);
+    /** Get light DOM title */
+    get lightDomTitle(): string | undefined;
+    /** Set light DOM title */
+    set lightDomTitle(value: string | undefined);
+    /** Get initial column state */
+    get initialColumnState(): GridColumnState | undefined;
+    /** Set initial column state */
+    set initialColumnState(value: GridColumnState | undefined);
+    /**
+     * Check if sources have changed since last merge.
+     */
+    get sourcesChanged(): boolean;
+    /**
+     * Mark that sources have changed and need re-merging.
+     * Call this when external state (shell maps, etc.) that feeds into
+     * collectAllSources() has been updated.
+     */
+    markSourcesChanged(): void;
+    /** Set gridConfig source */
+    setGridConfig(config: GridConfig<T> | undefined): void;
+    /** Get the raw gridConfig source */
+    getGridConfig(): GridConfig<T> | undefined;
+    /** Set columns source */
+    setColumns(columns: ColumnConfig<T>[] | ColumnConfigMap<T> | undefined): void;
+    /** Get the raw columns source */
+    getColumns(): ColumnConfig<T>[] | ColumnConfigMap<T> | undefined;
+    /** Set fitMode source */
+    setFitMode(mode: FitMode | undefined): void;
+    /** Get the raw fitMode source */
+    getFitMode(): FitMode | undefined;
+    /** Set editOn source */
+    setEditOn(editOn: string | boolean | undefined): void;
+    /** Get the raw editOn source */
+    getEditOn(): string | boolean | undefined;
+    /**
+     * Merge all sources into effective config.
+     * Also applies post-merge operations (rowHeight, fixed mode widths, animation).
+     *
+     * Called by RenderScheduler's mergeConfig phase.
+     *
+     * Two-layer architecture:
+     * 1. Sources → #originalConfig (frozen, immutable)
+     * 2. Clone → #effectiveConfig (mutable, runtime changes)
+     *
+     * When sources change, both layers are rebuilt.
+     * When sources haven't changed AND columns exist, this is a no-op.
+     * Runtime mutations only affect effectiveConfig.
+     * resetState() clones originalConfig back to effectiveConfig.
+     */
+    merge(): void;
+    /**
+     * Collect current column state by diffing original vs effective.
+     * Returns only the changes from the original configuration.
+     */
+    collectState(plugins: BaseGridPlugin[]): GridColumnState;
+    /**
+     * Apply column state to the grid.
+     */
+    applyState(state: GridColumnState, plugins: BaseGridPlugin[]): void;
+    /**
+     * Reset state to original configuration.
+     *
+     * Two-layer architecture: Clones #originalConfig back to #effectiveConfig.
+     * This discards all runtime changes (hidden, width, order) and restores
+     * the state to what was compiled from sources.
+     */
+    resetState(plugins: BaseGridPlugin[]): void;
+    /**
+     * Request a debounced state change event.
+     */
+    requestStateChange(plugins: BaseGridPlugin[]): void;
+    /**
+     * Set the visibility of a column.
+     * @returns true if visibility changed, false otherwise
+     */
+    setColumnVisible(field: string, visible: boolean): boolean;
+    /**
+     * Toggle column visibility.
+     */
+    toggleColumnVisibility(field: string): boolean;
+    /**
+     * Check if a column is visible.
+     */
+    isColumnVisible(field: string): boolean;
+    /**
+     * Show all columns.
+     */
+    showAllColumns(): void;
+    /**
+     * Get all columns with visibility info.
+     */
+    getAllColumns(): Array<{
+        field: string;
+        header: string;
+        visible: boolean;
+        lockVisible?: boolean;
+    }>;
+    /**
+     * Get current column order.
+     */
+    getColumnOrder(): string[];
+    /**
+     * Set column order.
+     */
+    setColumnOrder(order: string[]): void;
+    /**
+     * Parse light DOM columns from host element.
+     */
+    parseLightDomColumns(host: HTMLElement): void;
+    /**
+     * Clear the light DOM columns cache.
+     */
+    clearLightDomCache(): void;
+    /**
+     * Register a handler for Light DOM element changes.
+     * When elements matching the tag name are added/removed/changed,
+     * the callback will be invoked (debounced).
+     *
+     * @param tagName - The lowercase tag name to watch (e.g., 'tbw-grid-header')
+     * @param callback - Called when matching elements change
+     */
+    registerLightDomHandler(tagName: string, callback: () => void): void;
+    /**
+     * Unregister a Light DOM element handler.
+     */
+    unregisterLightDomHandler(tagName: string): void;
+    /**
+     * Set up MutationObserver to watch for Light DOM changes.
+     * This is generic infrastructure - specific handling is done via registered handlers.
+     *
+     * When Light DOM elements are added/removed/changed, the observer:
+     * 1. Identifies which registered tag names were affected
+     * 2. Debounces multiple mutations into a single callback per handler
+     * 3. Invokes the registered callbacks
+     *
+     * This mechanism allows plugins to register their own Light DOM elements
+     * and handle parsing themselves, then hand config to ConfigManager.
+     *
+     * @param host - The host element to observe (the grid element)
+     */
+    observeLightDOM(host: HTMLElement): void;
+    /**
+     * Register a change listener.
+     */
+    onChange(callback: () => void): void;
+    /**
+     * Notify all change listeners.
+     */
+    notifyChange(): void;
+    /**
+     * Dispose of the ConfigManager and clean up resources.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=config-manager.d.ts.map

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

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

package/lib/core/internal/event-delegation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-delegation.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/event-delegation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,UAAU,CAAC;AA6J3D;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAmF3G"}
+{"version":3,"file":"event-delegation.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/event-delegation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AA+B7C;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAe3G"}

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

@@ -1 +1 @@
-{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/header.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAA2B,YAAY,EAAE,MAAM,UAAU,CAAC;AAiBtE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CA2FrD"}
+{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/header.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAA6B,YAAY,EAAE,MAAM,UAAU,CAAC;AAiBxE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CA2FrD"}

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

@@ -1 +1 @@
-{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/keyboard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAI7C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,aAAa,GAAG,IAAI,CA0H5E;AAED;;GAEG;AACH,UAAU,wBAAwB;IAChC,2DAA2D;IAC3D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,IAAI,CA2F9F"}
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/keyboard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAI7C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,aAAa,GAAG,IAAI,CAuH5E;AAED;;GAEG;AACH,UAAU,wBAAwB;IAChC,2DAA2D;IAC3D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,IAAI,CA2F9F"}

package/lib/core/internal/render-scheduler.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Centralized Render Scheduler for the Grid component.
+ *
+ * This scheduler batches all rendering work into a single requestAnimationFrame,
+ * eliminating race conditions between different parts of the grid (ResizeObserver,
+ * framework adapters, virtualization, etc.) that previously scheduled independent RAFs.
+ *
+ * ## Design Principles
+ *
+ * 1. **Single RAF per frame**: All render requests are batched into one RAF callback
+ * 2. **Phase-based execution**: Work is organized into ordered phases that run sequentially
+ * 3. **Highest-phase wins**: Multiple requests merge to the highest requested phase
+ * 4. **Framework-agnostic timing**: Eliminates need for "double RAF" hacks
+ *
+ * ## Render Phases (execute in order)
+ *
+ * - STYLE (1): Lightweight style/class updates, plugin afterRender hooks
+ * - VIRTUALIZATION (2): Virtual window recalculation (scroll, resize)
+ * - HEADER (3): Header re-render only
+ * - ROWS (4): Row model rebuild + header + template + virtual window
+ * - COLUMNS (5): Column processing + rows phase work
+ * - FULL (6): Complete render including config merge
+ *
+ * @example
+ * ```typescript
+ * const scheduler = new RenderScheduler({
+ *   mergeConfig: () => this.#mergeEffectiveConfig(),
+ *   processColumns: () => this.#processColumns(),
+ *   processRows: () => this.#rebuildRowModel(),
+ *   renderHeader: () => renderHeader(this),
+ *   updateTemplate: () => updateTemplate(this),
+ *   renderVirtualWindow: () => this.refreshVirtualWindow(true),
+ *   afterRender: () => this.#pluginManager?.afterRender(),
+ *   isConnected: () => this.isConnected && this.#connected,
+ * });
+ *
+ * // Request a full render
+ * scheduler.requestPhase(RenderPhase.FULL, 'initial-setup');
+ *
+ * // Wait for render to complete
+ * await scheduler.whenReady();
+ * ```
+ */
+/**
+ * Render phases in order of execution.
+ * Higher phases include all lower phase work.
+ */
+export declare enum RenderPhase {
+    /** Lightweight style updates only (plugin afterRender hooks) */
+    STYLE = 1,
+    /** Virtual window recalculation (includes STYLE) */
+    VIRTUALIZATION = 2,
+    /** Header re-render (includes VIRTUALIZATION) */
+    HEADER = 3,
+    /** Row model rebuild (includes HEADER) */
+    ROWS = 4,
+    /** Column processing (includes ROWS) */
+    COLUMNS = 5,
+    /** Full render including config merge (includes COLUMNS) */
+    FULL = 6
+}
+/**
+/**
+ * Callbacks that the scheduler invokes during flush.
+ * Each callback corresponds to work done in a specific phase.
+ */
+export interface RenderCallbacks {
+    /** Merge effective config (FULL phase) */
+    mergeConfig: () => void;
+    /** Process columns through plugins (COLUMNS phase) */
+    processColumns: () => void;
+    /** Rebuild row model through plugins (ROWS phase) */
+    processRows: () => void;
+    /** Render header DOM (HEADER phase) */
+    renderHeader: () => void;
+    /** Update CSS grid template (ROWS phase) */
+    updateTemplate: () => void;
+    /** Recalculate virtual window (VIRTUALIZATION phase) */
+    renderVirtualWindow: () => void;
+    /** Run plugin afterRender hooks (STYLE phase) */
+    afterRender: () => void;
+    /** Check if grid is still connected to DOM */
+    isConnected: () => boolean;
+}
+/**
+ * Centralized render scheduler that batches all grid rendering into single RAF.
+ */
+export declare class RenderScheduler {
+    #private;
+    constructor(callbacks: RenderCallbacks);
+    /**
+     * Request a render at the specified phase.
+     * Multiple requests are batched - the highest phase wins.
+     *
+     * @param phase - The render phase to execute
+     * @param _source - Debug identifier for what triggered this request (unused, kept for API compatibility)
+     */
+    requestPhase(phase: RenderPhase, _source: string): void;
+    /**
+     * Returns a promise that resolves when the current render cycle completes.
+     * If no render is pending, returns an already-resolved promise.
+     */
+    whenReady(): Promise<void>;
+    /**
+     * Set the initial ready resolver (called once on first render).
+     * This connects to the grid's `ready()` promise.
+     */
+    setInitialReadyResolver(resolver: () => void): void;
+    /**
+     * Cancel any pending render.
+     * Useful for cleanup when component disconnects.
+     */
+    cancel(): void;
+    /**
+     * Check if a render is currently pending.
+     */
+    get isPending(): boolean;
+    /**
+     * Get the current pending phase (0 if none).
+     */
+    get pendingPhase(): RenderPhase | 0;
+}
+//# sourceMappingURL=render-scheduler.d.ts.map

package/lib/core/internal/render-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-scheduler.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/render-scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH;;;GAGG;AACH,oBAAY,WAAW;IACrB,gEAAgE;IAChE,KAAK,IAAI;IACT,oDAAoD;IACpD,cAAc,IAAI;IAClB,iDAAiD;IACjD,MAAM,IAAI;IACV,0CAA0C;IAC1C,IAAI,IAAI;IACR,wCAAwC;IACxC,OAAO,IAAI;IACX,4DAA4D;IAC5D,IAAI,IAAI;CACT;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,sDAAsD;IACtD,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,qDAAqD;IACrD,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,uCAAuC;IACvC,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,wDAAwD;IACxD,mBAAmB,EAAE,MAAM,IAAI,CAAC;IAChC,iDAAiD;IACjD,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,eAAe;;gBAiBd,SAAS,EAAE,eAAe;IAItC;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAavD;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAO1B;;;OAGG;IACH,uBAAuB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAInD;;;OAGG;IACH,MAAM,IAAI,IAAI;IAed;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,WAAW,GAAG,CAAC,CAElC;CAwFF"}

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

@@ -1,6 +1,11 @@
 import { InternalGrid } from '../types';
 /** Callback type for plugin row rendering hook */
 export type RenderRowHook = (row: any, rowEl: HTMLElement, rowIndex: number) => boolean;
+/**
+ * CSS selector for focusable editor elements within a cell.
+ * Used by EditingPlugin and keyboard navigation.
+ */
+export declare const FOCUSABLE_EDITOR_SELECTOR = "input,select,textarea,[contenteditable=\"true\"],[contenteditable=\"\"],[tabindex]:not([tabindex=\"-1\"])";
 /**
  * Create a row element from template. Significantly faster than createElement + setAttribute.
  */
@@ -23,8 +28,8 @@ export declare function renderVisibleRows(grid: InternalGrid, start: number, end
  */
 export declare function renderInlineRow(grid: InternalGrid, rowEl: HTMLElement, rowData: any, rowIndex: number): void;
 /**
- * Handle click / double click interaction to focus cells and optionally start row editing
- * according to the grid's configured edit activation mode.
+ * Handle click / double click interaction to focus cells.
+ * Edit triggering is handled by EditingPlugin via onCellClick hook.
  */
-export declare function handleRowClick(grid: InternalGrid, e: MouseEvent, rowEl: HTMLElement, isDbl: boolean): void;
+export declare function handleRowClick(grid: InternalGrid, e: MouseEvent, rowEl: HTMLElement, _isDbl: boolean): void;
 //# sourceMappingURL=rows.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,UAAU,CAAC;AAY3D,kDAAkD;AAClD,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;AA2BxF;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,cAAc,CAEtD;AAuFD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAI5D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,aAAa,GAC5B,IAAI,CAyLN;AAoJD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAmK5G;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CA8G1G"}
+{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,UAAU,CAAC;AAKjE,kDAAkD;AAClD,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;AAMxF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,8GACiE,CAAC;AA+CxG;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,cAAc,CAEtD;AAID;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAI5D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,aAAa,GAC5B,IAAI,CAwJN;AAwJD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAwK5G;AAED;;;GAGG;AAEH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CA+C3G"}

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

@@ -1,4 +1,4 @@
-import { EvalContext } from '../types';
+import { CompiledViewFunction, EvalContext } from '../types';
 /**
  * Escape a plain text string for safe insertion into HTML.
  * Converts special HTML characters to their entity equivalents.
@@ -17,5 +17,5 @@ export declare function escapeHtml(text: string): string;
 export declare function sanitizeHTML(html: string): string;
 export declare function evalTemplateString(raw: string, ctx: EvalContext): string;
 export declare function finalCellScrub(cell: HTMLElement): void;
-export declare function compileTemplate(raw: string): (ctx: EvalContext) => string;
+export declare function compileTemplate(raw: string): CompiledViewFunction<any>;
 //# sourceMappingURL=sanitize.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/sanitize.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAU5C;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ/C;AAgDD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYjD;AAiED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAgBxE;AAoCD,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAetD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,SAExB,WAAW,YAO7B"}
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/sanitize.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAUlE;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ/C;AAgDD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYjD;AAiED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAgBxE;AAoCD,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAetD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,6BAS1C"}

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;