@toolbox-web/grid 2.8.1 → 2.9.0

package/lib/core/internal/dom-builder.d.ts

@@ -42,6 +42,14 @@ export interface ShellHeaderOptions {
     hasPanels: boolean;
     isPanelOpen: boolean;
     toolPanelIcon?: string;
+    /**
+     * Whether to render the built-in tool panel toggle button and the
+     * adjacent separator. Independent of `hasPanels` so panels can remain
+     * registered (and openable via the public API) while the consumer
+     * supplies their own toggle button.
+     * @default true when hasPanels is true
+     */
+    showToggle?: boolean;
     /** Config toolbar contents with render function (pre-sorted by order) */
     configButtons: Array<{
         id: string;

package/lib/core/types.d.ts

@@ -3309,6 +3309,20 @@ export interface ShellHeaderConfig {
     title?: string;
     /** Custom toolbar content (rendered before tool panel toggle) */
     toolbarContents?: ToolbarContentDefinition[];
+    /**
+     * Whether the grid renders its built-in tool panel toggle button
+     * (`button.tbw-toolbar-btn[data-panel-toggle]`) and the auto-inserted
+     * `.tbw-toolbar-separator` between custom toolbar contents and the toggle.
+     *
+     * Set to `false` when you want to provide your own toggle button (e.g. a
+     * design-system button styled to match your application). Wire your button
+     * to call {@link Grid.toggleToolPanel} (or `toggleToolPanelSection(id)` for
+     * a specific section). All tool panels remain functional; only the
+     * built-in toggle button and adjacent separator are suppressed.
+     *
+     * @default true
+     */
+    toolPanelToggle?: boolean;
     /**
      * Light DOM header content elements (parsed from <tbw-grid-header> children).
      * @internal Set by ConfigManager during merge