@toolbox-web/grid 2.10.0 → 2.11.0

package/lib/core/grid.d.ts

@@ -1372,15 +1372,26 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
      * Each section can be expanded/collapsed independently.
      *
      * @group Tool Panel
+     * @param panelId - Optional ID of the section to expand on open. When provided,
+     *   takes precedence over `shell.toolPanel.defaultOpen`. If the panel is already
+     *   open with a different section expanded, switches to the requested section.
+     *   If the panel ID is not registered, a warning is emitted and the call falls
+     *   back to default behavior (auto-expand `defaultOpen` or first registered panel).
+     *
      * @example
      * ```typescript
-     * // Open the tool panel when a toolbar button is clicked
+     * // Open the tool panel with the default / first section expanded.
      * settingsButton.addEventListener('click', () => {
      *   grid.openToolPanel();
      * });
+     *
+     * // Open the tool panel and jump straight to a specific section.
+     * filtersButton.addEventListener('click', () => {
+     *   grid.openToolPanel('filters');
+     * });
      * ```
      */
-    openToolPanel(): void;
+    openToolPanel(panelId?: string): void;
     /**
      * Close the tool panel sidebar.
      *

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

@@ -12,8 +12,15 @@ export interface ShellController {
     readonly isPanelOpen: boolean;
     /** Get IDs of expanded accordion sections */
     readonly expandedSections: string[];
-    /** Open the tool panel */
-    openToolPanel(): void;
+    /**
+     * Open the tool panel.
+     * @param panelId - Optional ID of the section to expand on open. When provided,
+     *   takes precedence over `shell.toolPanel.defaultOpen`. If the panel is already
+     *   open with a different section expanded, switches to the requested section.
+     *   If the panel ID is not registered, a `TBW072` warning is emitted and the
+     *   call falls back to default behavior (auto-expand `defaultOpen` or first by order).
+     */
+    openToolPanel(panelId?: string): void;
     /** Close the tool panel */
     closeToolPanel(): void;
     /** Toggle the tool panel */

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

@@ -21,6 +21,16 @@ export interface ShellState {
     lightDomTitle: string | null;
     /** IDs of tool panels registered from light DOM (to avoid re-parsing) */
     lightDomToolPanelIds: Set<string>;
+    /**
+     * IDs of light DOM tool panels whose `render` has already been bound to a
+     * framework-adapter renderer. Used by `parseLightDomToolPanels` to detect
+     * the FIRST adapter attach (which legitimately needs to swap the vanilla
+     * fallback for the real adapter renderer and tear down any in-progress
+     * render) vs. subsequent re-parses (which must NOT tear down — doing so
+     * unmounts the user's React/Vue/Angular component, losing local state and
+     * resetting scroll position inside the panel).
+     */
+    adapterBoundToolPanelIds: Set<string>;
     /** IDs of toolbar content registered from light DOM (to avoid re-parsing) */
     lightDomToolbarContentIds: Set<string>;
     /** IDs of tool panels registered via registerToolPanel API */

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

@@ -475,8 +475,11 @@ export interface GridElementRef {
     readonly expandedToolPanelSections: string[];
     /**
      * Open the tool panel sidebar (accordion view with all registered panels).
+     * @param panelId - Optional ID of the section to expand on open. Takes precedence
+     *   over `shell.toolPanel.defaultOpen`. If the panel ID is unknown, the call
+     *   falls back to default behavior with a `TBW072` warning.
      */
-    openToolPanel(): void;
+    openToolPanel(panelId?: string): void;
     /**
      * Close the tool panel sidebar.
      */

package/lib/core/types.d.ts

@@ -167,8 +167,11 @@ export interface PublicGrid<T = any> {
     unregisterToolPanel?(panelId: string): void;
     /**
      * Open the tool panel sidebar.
+     * @param panelId - Optional ID of the section to expand on open. Takes precedence
+     *   over `shell.toolPanel.defaultOpen`. Falls back to default behavior with a
+     *   warning if the ID is not registered.
      */
-    openToolPanel?(): void;
+    openToolPanel?(panelId?: string): void;
     /**
      * Close the tool panel sidebar.
      */