@guiexpert/table 1.1.85 → 1.1.88

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/selection/selection-service.d.ts

@@ -11,7 +11,22 @@ export declare class SelectionService implements OnActionTriggeredIf {
     getSelectionModel?: GetT<SelectionModelIf>;
     getFocusModel?: GetT<FocusModelIf>;
     protected previousEvt?: GeMouseEvent;
+    /** A drag selection ends with a click on another cell – that click must not clear the new range. */
+    protected ignoreNextClick: boolean;
     constructor(tableScope: TableScope);
+    /**
+     * Called on mouse down: a new gesture starts.
+     */
+    onMouseDown(): void;
+    /**
+     * Selects a range by dragging the mouse over body cells (selection type "range").
+     * The cell where the drag started stays the anchor, so a following shift-click extends from there.
+     *
+     * @param {GeMouseEvent} evt - the current mouse position
+     * @param {GeMouseEvent} startEvt - the mouse down event that started the drag
+     * @returns {boolean} true if the selection changed (repaint needed)
+     */
+    onMouseDragging(evt: GeMouseEvent, startEvt: GeMouseEvent | undefined): boolean;
     onMouseClicked(evt: GeMouseEvent, _previousEvt: GeMouseEvent | undefined): boolean;
     onActionTriggered(actionId: ActionId): boolean;
     private createRangeByEvents;

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;
@@ -74,6 +80,8 @@ export declare class TableScope extends RenderScope implements OnActionTriggered
     private lastDragFrom;
     private lastDragTo;
     private firstDraggingRendering;
+    /** Last comparator passed to `sort()`; re-applied after filtering. Cleared by a header sort. */
+    private lastSortCompareFn?;
     constructor(hostElement: HTMLDivElement, tableModel: TableModelIf, domService: DomServiceIf, tableOptions: TableOptionsIf, eventListener: EventListenerIf, copyService?: CopyServiceIf, excelService?: ExcelServiceIf);
     /**
      * Creates a TableScope instance.
@@ -113,6 +121,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.
      *
@@ -294,12 +323,27 @@ export declare class TableScope extends RenderScope implements OnActionTriggered
      * @private
      */
     private autoRestoreCollapsedExpandedState;
+    /**
+     * Calculates a width per column that fits the widest text of header, body and footer.
+     *
+     * The text is measured with the font and padding of a rendered cell label (canvas `measureText`),
+     * so dates, numbers and long names are no longer cut off. To stay fast with millions of rows, the body
+     * is scanned once by character length and only the longest candidates per column are measured.
+     * Without a canvas (e.g. in tests) it falls back to 8 px per character.
+     *
+     * @returns {number[]} one width in px per column (at least 50 px)
+     */
     calcAutoColumnWidths(): number[];
     setColumnWidth(columnIndex: number, width: number): void;
     autoResizeColumns(recalcWrappers?: boolean): void;
     recalcWrappers(): void;
     reSort(): void;
     sort(compareFn: (a: any, b: any) => number): void;
+    /**
+     * Sorts the (freshly filtered) body rows again, so a filter keeps the current order:
+     * the last `sort(compareFn)` call, otherwise the columns with a `sortState` (header icons).
+     */
+    protected reapplySorting(): void;
     /**
      * Ensures that a specific row is visible in the viewport by scrolling if necessary.
      * This method checks if the target row is within the currently visible range and

package/package.json

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