@toolbox-web/grid 2.13.0 → 2.14.0

package/lib/core/grid.d.ts

@@ -10,6 +10,29 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
     static readonly tagName = "tbw-grid";
     /** Version of the grid component, injected at build time from package.json */
     static readonly version: string;
+    /**
+     * Tag name this bundle should render and query for.
+     *
+     * In the common (single-version) case this equals {@link tagName}
+     * (`'tbw-grid'`).
+     *
+     * Resolution rules (see `registerDataGrid()` at the bottom of this file):
+     *  - **No existing registration** → this class registers under `tbw-grid`;
+     *    `activeTag === 'tbw-grid'`.
+     *  - **Existing registration at the SAME version** → this class is NOT
+     *    redefined (the first-loaded bundle's class keeps the registration),
+     *    and `activeTag` still points at `'tbw-grid'` so adapters render the
+     *    shared element. Note that in this branch `customElements.get(activeTag)`
+     *    returns the OTHER bundle's class, not this one.
+     *  - **Existing registration at a DIFFERENT version** → this class
+     *    registers under a version-suffixed tag like `tbw-grid-v2-14-0` and
+     *    `activeTag` reflects that suffixed name; the two implementations
+     *    coexist on the page.
+     *
+     * Adapters and consumers that need to construct or query for the grid
+     * element MUST use this property, not the hard-coded `tagName` literal.
+     */
+    static activeTag: string;
     /**
      * Registry of framework adapters that handle converting light DOM elements
      * to functional renderers/editors. Framework libraries (Angular, React, Vue)

package/lib/core/internal/style-injector.d.ts

@@ -1,11 +1,3 @@
-/**
- * Style Injector Module
- *
- * Handles injection of grid and plugin styles into the document.
- * Uses a singleton pattern to avoid duplicate injection across multiple grid instances.
- *
- * @module internal/style-injector
- */
 /**
  * Add plugin styles to the accumulated plugin styles map.
  * Returns true if any new styles were added.

package/lib/core/types.d.ts

@@ -1607,6 +1607,38 @@ export interface FrameworkAdapter {
      * @param cellEl - The cell element whose content is being released
      */
     releaseCell?(cellEl: HTMLElement): void;
+    /**
+     * Open a teardown batch. Grid core wraps multi-cell teardown sequences
+     * (e.g., `_clearRowPool`, row-pool shrink, full row rebuild) where every
+     * affected cell will be detached from the DOM before the batch ends.
+     *
+     * Adapters that normally synchronously commit framework teardown per
+     * `releaseCell` (React's `flushSync`) should defer those commits until
+     * the matching {@link endBatch} call. Detached containers can then be
+     * pruned without emitting per-cell render warnings.
+     *
+     * Calls may nest; adapters MUST track depth and only flush on the
+     * outermost {@link endBatch}.
+     *
+     * @param gridEl - The grid element whose adapter-managed cells are
+     *   being torn down. Adapters that key state per grid (e.g. one
+     *   PortalManager per grid) should scope the batch to this element.
+     *   Omitted only by callers without a grid reference.
+     *
+     * @since 2.14.0
+     */
+    beginBatch?(gridEl?: HTMLElement): void;
+    /**
+     * Close a teardown batch opened by {@link beginBatch}. Adapters should
+     * flush any deferred framework commits here (or rely on render-time
+     * detached-container filtering for adapters that don't need a flush).
+     *
+     * @param gridEl - Must match the element passed to the paired
+     *   {@link beginBatch} call.
+     *
+     * @since 2.14.0
+     */
+    endBatch?(gridEl?: HTMLElement): void;
     /**
      * Unmount a specific framework container and free its resources.
      *