@guiexpert/table 1.1.85 → 1.1.86

package/lib/table/render-scope.d.ts

@@ -335,6 +335,11 @@ export declare class RenderScope extends EleScope {
      *
      * @return {undefined}
      */
+    /**
+     * Cancels a pending debounced rendering and calls all renderer cleanup functions
+     * (e.g. unmounts framework components rendered into cells). Used by {@link TableScope.destroy}.
+     */
+    protected disposeRendering(): void;
     protected debounce(fn: () => void, delay?: number): void;
     /**
      * Adjusts the dragging column during a mouse move event.

package/lib/table/resize-handler.d.ts

@@ -8,6 +8,12 @@ import { TableScope } from './table-scope';
 export declare class ResizeHandler {
     protected tableScope: TableScope;
     protected debounceDelay: number;
+    private readonly resizeObserver;
+    private disconnected;
     constructor(tableScope: TableScope, debounceDelay?: number);
+    /**
+     * Stops observing the host element. Called by {@link TableScope.destroy}.
+     */
+    disconnect(): void;
     private handleResize;
 }

package/lib/table/table-api.d.ts

@@ -718,6 +718,20 @@ export declare class TableApi {
      * @returns {void}
      */
     repaint(): void;
+    /**
+     * Releases the table: removes all DOM listeners (incl. the window resize listener), stops the
+     * resize observer, calls the cleanup functions of all cell renderers and clears the host element.
+     * The framework wrappers call it automatically when they are unmounted or receive a new table model.
+     *
+     * @example
+     * // Plain TS: replace the table with a new model
+     * tableApi.destroy();
+     * const scope = new TableScope(hostDiv, newModel, new SimpleDomService(), new TableOptions(), new EventAdapter());
+     * scope.firstInit();
+     *
+     * @returns {void}
+     */
+    destroy(): void;
     /**
      * Performs a complete repaint of the table by triggering a hard repaint on the underlying table scope.
      *

package/lib/table/table-scope.d.ts

@@ -57,6 +57,12 @@ export declare class TableScope extends RenderScope implements OnActionTriggered
     readonly copyService: CopyServiceIf;
     readonly excelService: ExcelServiceIf;
     licenseManager: LicenseManager;
+    /**
+     * Signal for all DOM listeners of this table (host element, scroll viewport, window).
+     * {@link destroy} aborts it, which removes every listener at once.
+     */
+    readonly listenerAbortController: AbortController;
+    private destroyed;
     mouseHandler: MouseHandler;
     inputHandler: InputHandler;
     resizeHandler: ResizeHandler;
@@ -113,6 +119,27 @@ export declare class TableScope extends RenderScope implements OnActionTriggered
      * @returns {TableScope} This instance of the table scope.
      */
     firstInit(): TableScope;
+    /**
+     * Releases the table: removes all DOM listeners (host element, scroll viewport, window resize),
+     * stops the resize observer, unregisters from the selection and focus model, calls the cleanup
+     * functions of all cell renderers and clears the host element.
+     *
+     * Call it before you create a new `TableScope` for the same host element (e.g. when a framework
+     * wrapper receives a new table model) or when the table is removed from the page.
+     * Calling it twice is harmless.
+     *
+     * @example
+     * const scope = new TableScope(hostDiv, tableModel, new SimpleDomService(), new TableOptions(), new EventAdapter());
+     * scope.firstInit();
+     * // later, e.g. when a new model arrives:
+     * scope.destroy();
+     * new TableScope(hostDiv, newTableModel, new SimpleDomService(), new TableOptions(), new EventAdapter()).firstInit();
+     */
+    destroy(): void;
+    /**
+     * Returns `true` once {@link destroy} has been called.
+     */
+    isDestroyed(): boolean;
     /**
      * Creates a GeMouseEvent object based on a MouseEvent.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guiexpert/table",
-  "version": "1.1.85",
+  "version": "1.1.86",
   "license": "MIT",
   "author": "Dr. Marc Kronberg <info@gui.expert> (https://gui.expert)",
   "repository": {