@toolbox-web/grid 2.16.0 → 2.16.1

package/lib/plugins/shell/shell-controller.d.ts

@@ -32,6 +32,26 @@ export interface ShellController {
      *   when the panel is currently closed (e.g. `anchor` for dropdown mode).
      */
     toggleToolPanel(options?: OpenToolPanelOptions): void;
+    /**
+     * Re-pair an open dropdown popover onto its (possibly recreated) trigger
+     * after a re-render (`mode: 'dropdown'` only). A column toggle / reorder may
+     * recreate the custom column-header button the popover was anchored to,
+     * leaving the popover's `position-anchor` dangling so the browser drops it to
+     * the corner.
+     *
+     * Behaviour:
+     * - intact pairing → no-op (cheap fast-path, safe to call every render);
+     * - a live `[data-panel-toggle]` exists → re-pair the existing anchor onto it
+     *   IN PLACE (no popover re-show → no flash), or a fixed-coord re-show when
+     *   CSS anchor positioning is unavailable;
+     * - corner-origin dropdown with no trigger → keep it pinned to the corner;
+     * - trigger-origin dropdown whose trigger is transiently absent → leave the
+     *   popover at its last position (the shell's MutationObserver re-pairs it
+     *   before paint once the trigger reappears), rather than flashing to corner.
+     *
+     * No-op when the panel is closed or the mode is not `'dropdown'`.
+     */
+    reanchorOpenDropdown(): void;
     /** Toggle an accordion section */
     toggleToolPanelSection(sectionId: string): void;
     /** Get registered tool panels */

package/lib/plugins/shell/shell.d.ts

@@ -259,6 +259,8 @@ export declare function updateToolbarActiveStates(renderRoot: Element, state: Sh
  * Update tool panel open/close state.
  */
 export declare function updatePanelState(renderRoot: Element, state: ShellState): void;
+/** Whether the current environment supports CSS anchor positioning. */
+export declare function supportsAnchorPositioning(): boolean;
 /**
  * Show the tool panel as an anchored dropdown popover (`mode: 'dropdown'`).
  *
@@ -276,6 +278,25 @@ export declare function showToolPanelDropdown(renderRoot: Element, state: ShellS
  * {@link showToolPanelDropdown}.
  */
 export declare function hideToolPanelDropdown(renderRoot: Element, state: ShellState): void;
+/**
+ * Re-pair an OPEN dropdown's existing anchor onto a freshly resolved trigger
+ * IN PLACE — reusing the already-minted `anchor-name` and leaving the popover
+ * shown — instead of hiding and re-showing it.
+ *
+ * WHY: when an outer framework (e.g. a React column `headerRenderer`) recreates
+ * the `[data-panel-toggle]` trigger on a column toggle, the new node lacks the
+ * `anchor-name`, so the popover's `position-anchor` no longer resolves and the
+ * browser drops it to the corner. Hiding + re-showing (the heavier
+ * {@link showToolPanelDropdown} path) mints a NEW name and re-enters the
+ * Popover API, which flashes the popover to the corner for a frame. Moving the
+ * SAME name to the new node keeps the popover visually anchored with no flash.
+ *
+ * Returns `true` when the re-pair was applied. The caller must ensure CSS
+ * anchor positioning is supported (see {@link supportsAnchorPositioning});
+ * otherwise the fixed-coordinate fallback in {@link showToolPanelDropdown} must
+ * be used instead.
+ */
+export declare function repairDropdownAnchor(renderRoot: Element, state: ShellState, trigger: HTMLElement): boolean;
 /**
  * Prepare shell state for a full re-render.
  * Runs cleanup functions so content (toolbar buttons, panels, headers)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolbox-web/grid",
-  "version": "2.16.0",
+  "version": "2.16.1",
   "description": "Zero-dependency, framework-agnostic data grid web component with virtualization, sorting, filtering, editing, and 20+ plugins. Works in vanilla JS, React, Vue, Angular, and any framework.",
   "type": "module",
   "main": "./index.js",