@toolbox-web/grid 0.0.4 → 0.0.5

package/index.d.ts

@@ -180,6 +180,24 @@ export declare abstract class BaseGridPlugin<TConfig = unknown> {
      * Get the shadow root of the grid.
      */
     protected get shadowRoot(): ShadowRoot | null;
+    /**
+     * Get the disconnect signal for event listener cleanup.
+     * This signal is aborted when the grid disconnects from the DOM.
+     * Use this when adding event listeners that should be cleaned up automatically.
+     *
+     * Best for:
+     * - Document/window-level listeners added in attach()
+     * - Listeners on the grid element itself
+     * - Any listener that should persist across renders
+     *
+     * Not needed for:
+     * - Listeners on elements created in afterRender() (removed with element)
+     *
+     * @example
+     * element.addEventListener('click', handler, { signal: this.disconnectSignal });
+     * document.addEventListener('keydown', handler, { signal: this.disconnectSignal });
+     */
+    protected get disconnectSignal(): AbortSignal;
     /**
      * Log a warning message.
      */
@@ -926,6 +944,14 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
     get editOn(): string | undefined;
     set editOn(value: string | undefined);
     get effectiveConfig(): GridConfig<T>;
+    /**
+     * Get the disconnect signal for event listener cleanup.
+     * This signal is aborted when the grid disconnects from the DOM.
+     * Plugins and internal code can use this for automatic listener cleanup.
+     * @example
+     * element.addEventListener('click', handler, { signal: this.grid.disconnectSignal });
+     */
+    get disconnectSignal(): AbortSignal;
     constructor();
     /**
      * Get a plugin instance by its class.
@@ -1493,6 +1519,8 @@ export declare interface GridElement {
     rows: any[];
     columns: ColumnConfig[];
     gridConfig: any;
+    /** AbortSignal that is aborted when the grid disconnects from the DOM */
+    disconnectSignal: AbortSignal;
     requestRender(): void;
     requestAfterRender(): void;
     forceLayout(): Promise<void>;