@toolbox-web/grid-angular 0.9.1 → 0.11.0

package/fesm2022/toolbox-web-grid-angular-features-selection.mjs

@@ -1,10 +1,12 @@
-import { SelectionPlugin } from '@toolbox-web/grid/plugins/selection';
+import { inject, ElementRef, signal } from '@angular/core';
 import { registerFeature } from '@toolbox-web/grid-angular';
+import { SelectionPlugin } from '@toolbox-web/grid/plugins/selection';
 
 /**
  * Selection feature for @toolbox-web/grid-angular
  *
  * Import this module to enable the `selection` input on Grid directive.
+ * Also exports `injectGridSelection()` for programmatic selection control.
  *
  * @example
  * ```typescript
@@ -13,6 +15,24 @@ import { registerFeature } from '@toolbox-web/grid-angular';
  * <tbw-grid [selection]="'range'" />
  * ```
  *
+ * @example Using injectGridSelection
+ * ```typescript
+ * import { injectGridSelection } from '@toolbox-web/grid-angular/features/selection';
+ *
+ * @Component({...})
+ * export class MyComponent {
+ *   private selection = injectGridSelection<Employee>();
+ *
+ *   selectAll() {
+ *     this.selection.selectAll();
+ *   }
+ *
+ *   getSelected() {
+ *     return this.selection.getSelection();
+ *   }
+ * }
+ * ```
+ *
  * @packageDocumentation
  */
 registerFeature('selection', (config) => {
@@ -23,8 +43,120 @@ registerFeature('selection', (config) => {
     // Full config object
     return new SelectionPlugin(config ?? undefined);
 });
+/**
+ * Angular inject function for programmatic selection control.
+ *
+ * Uses **lazy grid discovery** - the grid element is found when methods are called,
+ * not during initialization. This ensures it works reliably with:
+ * - Lazy-rendered tabs
+ * - Conditional rendering (*ngIf)
+ * - Dynamic component loading
+ *
+ * @example
+ * ```typescript
+ * import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
+ * import { Grid } from '@toolbox-web/grid-angular';
+ * import '@toolbox-web/grid-angular/features/selection';
+ * import { injectGridSelection } from '@toolbox-web/grid-angular/features/selection';
+ *
+ * @Component({
+ *   selector: 'app-my-grid',
+ *   imports: [Grid],
+ *   schemas: [CUSTOM_ELEMENTS_SCHEMA],
+ *   template: `
+ *     <button (click)="handleSelectAll()">Select All</button>
+ *     <tbw-grid [rows]="rows" [selection]="'range'"></tbw-grid>
+ *   `
+ * })
+ * export class MyGridComponent {
+ *   selection = injectGridSelection();
+ *
+ *   handleSelectAll() {
+ *     this.selection.selectAll();
+ *   }
+ *
+ *   getSelectedRows() {
+ *     const selection = this.selection.getSelection();
+ *     if (!selection) return [];
+ *     // Derive rows from selection.ranges as needed
+ *   }
+ * }
+ * ```
+ */
+function injectGridSelection() {
+    const elementRef = inject(ElementRef);
+    const isReady = signal(false, ...(ngDevMode ? [{ debugName: "isReady" }] : []));
+    // Lazy discovery: cached grid reference
+    let cachedGrid = null;
+    let readyPromiseStarted = false;
+    /**
+     * Lazily find the grid element. Called on each method invocation.
+     * Caches the reference once found and triggers ready() check.
+     */
+    const getGrid = () => {
+        if (cachedGrid)
+            return cachedGrid;
+        const grid = elementRef.nativeElement.querySelector('tbw-grid');
+        if (grid) {
+            cachedGrid = grid;
+            // Start ready() check only once
+            if (!readyPromiseStarted) {
+                readyPromiseStarted = true;
+                grid.ready?.().then(() => isReady.set(true));
+            }
+        }
+        return grid;
+    };
+    const getPlugin = () => {
+        return getGrid()?.getPlugin(SelectionPlugin);
+    };
+    return {
+        isReady: isReady.asReadonly(),
+        selectAll: () => {
+            const plugin = getPlugin();
+            if (!plugin) {
+                console.warn(`[tbw-grid:selection] SelectionPlugin not found.\n\n` +
+                    `  → Enable selection on the grid:\n` +
+                    `    <tbw-grid [selection]="'range'" />`);
+                return;
+            }
+            const grid = getGrid();
+            // Cast to any to access protected config
+            const mode = plugin.config?.mode;
+            if (mode === 'row') {
+                const rowCount = grid?.rows?.length ?? 0;
+                const allIndices = new Set();
+                for (let i = 0; i < rowCount; i++)
+                    allIndices.add(i);
+                plugin.selected = allIndices;
+                plugin.requestAfterRender?.();
+            }
+            else if (mode === 'range') {
+                const rowCount = grid?.rows?.length ?? 0;
+                const colCount = grid?._columns?.length ?? 0;
+                if (rowCount > 0 && colCount > 0) {
+                    plugin.setRanges([{ from: { row: 0, col: 0 }, to: { row: rowCount - 1, col: colCount - 1 } }]);
+                }
+            }
+        },
+        clearSelection: () => {
+            getPlugin()?.clearSelection();
+        },
+        getSelection: () => {
+            return getPlugin()?.getSelection() ?? null;
+        },
+        isCellSelected: (row, col) => {
+            return getPlugin()?.isCellSelected(row, col) ?? false;
+        },
+        setRanges: (ranges) => {
+            getPlugin()?.setRanges(ranges);
+        },
+    };
+}
 
 /**
  * Generated bundle index. Do not edit.
  */
+
+export { injectGridSelection };
 //# sourceMappingURL=toolbox-web-grid-angular-features-selection.mjs.map

package/fesm2022/toolbox-web-grid-angular-features-selection.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"toolbox-web-grid-angular-features-selection.mjs","sources":["../../../../libs/grid-angular/features/selection/src/index.ts","../../../../libs/grid-angular/features/selection/src/toolbox-web-grid-angular-features-selection.ts"],"sourcesContent":["/**\n * Selection feature for @toolbox-web/grid-angular\n *\n * Import this module to enable the `selection` input on Grid directive.\n *\n * @example\n * ```typescript\n * import '@toolbox-web/grid-angular/features/selection';\n *\n * <tbw-grid [selection]=\"'range'\" />\n * ```\n *\n * @packageDocumentation\n */\n\nimport { SelectionPlugin } from '@toolbox-web/grid/plugins/selection';\nimport { registerFeature } from '@toolbox-web/grid-angular';\n\nregisterFeature('selection', (config) => {\n  // Handle shorthand: 'cell', 'row', 'range'\n  if (config === 'cell' || config === 'row' || config === 'range') {\n    return new SelectionPlugin({ mode: config });\n  }\n  // Full config object\n  return new SelectionPlugin(config ?? undefined);\n});\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;AAaG;AAKH,eAAe,CAAC,WAAW,EAAE,CAAC,MAAM,KAAI;;AAEtC,IAAA,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,OAAO,EAAE;QAC/D,OAAO,IAAI,eAAe,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC9C;;AAEA,IAAA,OAAO,IAAI,eAAe,CAAC,MAAM,IAAI,SAAS,CAAC;AACjD,CAAC,CAAC;;ACzBF;;AAEG"}
+{"version":3,"file":"toolbox-web-grid-angular-features-selection.mjs","sources":["../../../../libs/grid-angular/features/selection/src/index.ts","../../../../libs/grid-angular/features/selection/src/toolbox-web-grid-angular-features-selection.ts"],"sourcesContent":["/**\n * Selection feature for @toolbox-web/grid-angular\n *\n * Import this module to enable the `selection` input on Grid directive.\n * Also exports `injectGridSelection()` for programmatic selection control.\n *\n * @example\n * ```typescript\n * import '@toolbox-web/grid-angular/features/selection';\n *\n * <tbw-grid [selection]=\"'range'\" />\n * ```\n *\n * @example Using injectGridSelection\n * ```typescript\n * import { injectGridSelection } from '@toolbox-web/grid-angular/features/selection';\n *\n * @Component({...})\n * export class MyComponent {\n *   private selection = injectGridSelection<Employee>();\n *\n *   selectAll() {\n *     this.selection.selectAll();\n *   }\n *\n *   getSelected() {\n *     return this.selection.getSelection();\n *   }\n * }\n * ```\n *\n * @packageDocumentation\n */\n\nimport { ElementRef, inject, signal, type Signal } from '@angular/core';\nimport type { DataGridElement } from '@toolbox-web/grid';\nimport { registerFeature } from '@toolbox-web/grid-angular';\nimport { SelectionPlugin, type CellRange, type SelectionResult } from '@toolbox-web/grid/plugins/selection';\n\nregisterFeature('selection', (config) => {\n  // Handle shorthand: 'cell', 'row', 'range'\n  if (config === 'cell' || config === 'row' || config === 'range') {\n    return new SelectionPlugin({ mode: config });\n  }\n  // Full config object\n  return new SelectionPlugin(config ?? undefined);\n});\n\n/**\n * Selection methods returned from injectGridSelection.\n *\n * Uses lazy discovery - the grid is found on first method call, not during initialization.\n * This ensures it works with lazy-rendered tabs, conditional rendering, etc.\n */\nexport interface SelectionMethods {\n  /**\n   * Select all rows (row mode) or all cells (range mode).\n   */\n  selectAll: () => void;\n\n  /**\n   * Clear all selection.\n   */\n  clearSelection: () => void;\n\n  /**\n   * Get the current selection state.\n   * Use this to derive selected rows, indices, etc.\n   */\n  getSelection: () => SelectionResult | null;\n\n  /**\n   * Check if a specific cell is selected.\n   */\n  isCellSelected: (row: number, col: number) => boolean;\n\n  /**\n   * Set selection ranges programmatically.\n   */\n  setRanges: (ranges: CellRange[]) => void;\n\n  /**\n   * Signal indicating if grid is ready.\n   * The grid is discovered lazily, so this updates when first method call succeeds.\n   */\n  isReady: Signal<boolean>;\n}\n\n/**\n * Angular inject function for programmatic selection control.\n *\n * Uses **lazy grid discovery** - the grid element is found when methods are called,\n * not during initialization. This ensures it works reliably with:\n * - Lazy-rendered tabs\n * - Conditional rendering (*ngIf)\n * - Dynamic component loading\n *\n * @example\n * ```typescript\n * import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';\n * import { Grid } from '@toolbox-web/grid-angular';\n * import '@toolbox-web/grid-angular/features/selection';\n * import { injectGridSelection } from '@toolbox-web/grid-angular/features/selection';\n *\n * @Component({\n *   selector: 'app-my-grid',\n *   imports: [Grid],\n *   schemas: [CUSTOM_ELEMENTS_SCHEMA],\n *   template: `\n *     <button (click)=\"handleSelectAll()\">Select All</button>\n *     <tbw-grid [rows]=\"rows\" [selection]=\"'range'\"></tbw-grid>\n *   `\n * })\n * export class MyGridComponent {\n *   selection = injectGridSelection();\n *\n *   handleSelectAll() {\n *     this.selection.selectAll();\n *   }\n *\n *   getSelectedRows() {\n *     const selection = this.selection.getSelection();\n *     if (!selection) return [];\n *     // Derive rows from selection.ranges as needed\n *   }\n * }\n * ```\n */\nexport function injectGridSelection<TRow = unknown>(): SelectionMethods {\n  const elementRef = inject(ElementRef);\n  const isReady = signal(false);\n\n  // Lazy discovery: cached grid reference\n  let cachedGrid: DataGridElement<TRow> | null = null;\n  let readyPromiseStarted = false;\n\n  /**\n   * Lazily find the grid element. Called on each method invocation.\n   * Caches the reference once found and triggers ready() check.\n   */\n  const getGrid = (): DataGridElement<TRow> | null => {\n    if (cachedGrid) return cachedGrid;\n\n    const grid = elementRef.nativeElement.querySelector('tbw-grid') as DataGridElement<TRow> | null;\n    if (grid) {\n      cachedGrid = grid;\n      // Start ready() check only once\n      if (!readyPromiseStarted) {\n        readyPromiseStarted = true;\n        grid.ready?.().then(() => isReady.set(true));\n      }\n    }\n    return grid;\n  };\n\n  const getPlugin = (): SelectionPlugin | undefined => {\n    return getGrid()?.getPlugin(SelectionPlugin);\n  };\n\n  return {\n    isReady: isReady.asReadonly(),\n\n    selectAll: () => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:selection] SelectionPlugin not found.\\n\\n` +\n            `  → Enable selection on the grid:\\n` +\n            `    <tbw-grid [selection]=\"'range'\" />`,\n        );\n        return;\n      }\n      const grid = getGrid();\n      // Cast to any to access protected config\n      const mode = (plugin as any).config?.mode;\n\n      if (mode === 'row') {\n        const rowCount = grid?.rows?.length ?? 0;\n        const allIndices = new Set<number>();\n        for (let i = 0; i < rowCount; i++) allIndices.add(i);\n        (plugin as any).selected = allIndices;\n        (plugin as any).requestAfterRender?.();\n      } else if (mode === 'range') {\n        const rowCount = grid?.rows?.length ?? 0;\n        const colCount = (grid as any)?._columns?.length ?? 0;\n        if (rowCount > 0 && colCount > 0) {\n          plugin.setRanges([{ from: { row: 0, col: 0 }, to: { row: rowCount - 1, col: colCount - 1 } }]);\n        }\n      }\n    },\n\n    clearSelection: () => {\n      getPlugin()?.clearSelection();\n    },\n\n    getSelection: () => {\n      return getPlugin()?.getSelection() ?? null;\n    },\n\n    isCellSelected: (row: number, col: number) => {\n      return getPlugin()?.isCellSelected(row, col) ?? false;\n    },\n\n    setRanges: (ranges: CellRange[]) => {\n      getPlugin()?.setRanges(ranges);\n    },\n  };\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/fesm2022/toolbox-web-grid-angular-features-undo-redo.mjs

@@ -1,10 +1,12 @@
-import { UndoRedoPlugin } from '@toolbox-web/grid/plugins/undo-redo';
+import { inject, ElementRef, signal } from '@angular/core';
 import { registerFeature } from '@toolbox-web/grid-angular';
+import { UndoRedoPlugin } from '@toolbox-web/grid/plugins/undo-redo';
 
 /**
  * Undo/Redo feature for @toolbox-web/grid-angular
  *
  * Import this module to enable the `undoRedo` input on Grid directive.
+ * Also exports `injectGridUndoRedo()` for programmatic undo/redo control.
  * Requires editing feature to be enabled.
  *
  * @example
@@ -15,6 +17,19 @@ import { registerFeature } from '@toolbox-web/grid-angular';
  * <tbw-grid [editing]="'dblclick'" [undoRedo]="true" />
  * ```
  *
+ * @example Using injectGridUndoRedo
+ * ```typescript
+ * import { injectGridUndoRedo } from '@toolbox-web/grid-angular/features/undo-redo';
+ *
+ * @Component({...})
+ * export class MyComponent {
+ *   private undoRedo = injectGridUndoRedo();
+ *
+ *   undo() { this.undoRedo.undo(); }
+ *   redo() { this.undoRedo.redo(); }
+ * }
+ * ```
+ *
  * @packageDocumentation
  */
 registerFeature('undoRedo', (config) => {
@@ -23,8 +38,98 @@ registerFeature('undoRedo', (config) => {
     }
     return new UndoRedoPlugin(config ?? undefined);
 });
+/**
+ * Angular inject function for programmatic undo/redo control.
+ *
+ * Uses **lazy grid discovery** - the grid element is found when methods are called,
+ * not during initialization.
+ *
+ * @example
+ * ```typescript
+ * import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
+ * import { Grid } from '@toolbox-web/grid-angular';
+ * import '@toolbox-web/grid-angular/features/editing';
+ * import '@toolbox-web/grid-angular/features/undo-redo';
+ * import { injectGridUndoRedo } from '@toolbox-web/grid-angular/features/undo-redo';
+ *
+ * @Component({
+ *   selector: 'app-my-grid',
+ *   imports: [Grid],
+ *   schemas: [CUSTOM_ELEMENTS_SCHEMA],
+ *   template: `
+ *     <button (click)="undoRedo.undo()" [disabled]="!undoRedo.canUndo()">Undo</button>
+ *     <button (click)="undoRedo.redo()" [disabled]="!undoRedo.canRedo()">Redo</button>
+ *     <tbw-grid [rows]="rows" [editing]="'dblclick'" [undoRedo]="true"></tbw-grid>
+ *   `
+ * })
+ * export class MyGridComponent {
+ *   undoRedo = injectGridUndoRedo();
+ * }
+ * ```
+ */
+function injectGridUndoRedo() {
+    const elementRef = inject(ElementRef);
+    const isReady = signal(false, ...(ngDevMode ? [{ debugName: "isReady" }] : []));
+    let cachedGrid = null;
+    let readyPromiseStarted = false;
+    const getGrid = () => {
+        if (cachedGrid)
+            return cachedGrid;
+        const grid = elementRef.nativeElement.querySelector('tbw-grid');
+        if (grid) {
+            cachedGrid = grid;
+            if (!readyPromiseStarted) {
+                readyPromiseStarted = true;
+                grid.ready?.().then(() => isReady.set(true));
+            }
+        }
+        return grid;
+    };
+    const getPlugin = () => {
+        return getGrid()?.getPlugin(UndoRedoPlugin);
+    };
+    return {
+        isReady: isReady.asReadonly(),
+        undo: () => {
+            const plugin = getPlugin();
+            if (!plugin) {
+                console.warn(`[tbw-grid:undoRedo] UndoRedoPlugin not found.\n\n` +
+                    `  → Enable undo/redo on the grid:\n` +
+                    `    <tbw-grid [editing]="'dblclick'" [undoRedo]="true" />`);
+                return null;
+            }
+            return plugin.undo();
+        },
+        redo: () => {
+            const plugin = getPlugin();
+            if (!plugin) {
+                console.warn(`[tbw-grid:undoRedo] UndoRedoPlugin not found.\n\n` +
+                    `  → Enable undo/redo on the grid:\n` +
+                    `    <tbw-grid [editing]="'dblclick'" [undoRedo]="true" />`);
+                return null;
+            }
+            return plugin.redo();
+        },
+        canUndo: () => getPlugin()?.canUndo() ?? false,
+        canRedo: () => getPlugin()?.canRedo() ?? false,
+        clearHistory: () => {
+            const plugin = getPlugin();
+            if (!plugin) {
+                console.warn(`[tbw-grid:undoRedo] UndoRedoPlugin not found.\n\n` +
+                    `  → Enable undo/redo on the grid:\n` +
+                    `    <tbw-grid [editing]="'dblclick'" [undoRedo]="true" />`);
+                return;
+            }
+            plugin.clearHistory();
+        },
+        getUndoStack: () => getPlugin()?.getUndoStack() ?? [],
+        getRedoStack: () => getPlugin()?.getRedoStack() ?? [],
+    };
+}
 
 /**
  * Generated bundle index. Do not edit.
  */
+
+export { injectGridUndoRedo };
 //# sourceMappingURL=toolbox-web-grid-angular-features-undo-redo.mjs.map

package/fesm2022/toolbox-web-grid-angular-features-undo-redo.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"toolbox-web-grid-angular-features-undo-redo.mjs","sources":["../../../../libs/grid-angular/features/undo-redo/src/index.ts","../../../../libs/grid-angular/features/undo-redo/src/toolbox-web-grid-angular-features-undo-redo.ts"],"sourcesContent":["/**\n * Undo/Redo feature for @toolbox-web/grid-angular\n *\n * Import this module to enable the `undoRedo` input on Grid directive.\n * Requires editing feature to be enabled.\n *\n * @example\n * ```typescript\n * import '@toolbox-web/grid-angular/features/editing';\n * import '@toolbox-web/grid-angular/features/undo-redo';\n *\n * <tbw-grid [editing]=\"'dblclick'\" [undoRedo]=\"true\" />\n * ```\n *\n * @packageDocumentation\n */\n\nimport { UndoRedoPlugin } from '@toolbox-web/grid/plugins/undo-redo';\nimport { registerFeature } from '@toolbox-web/grid-angular';\n\nregisterFeature('undoRedo', (config) => {\n  if (config === true) {\n    return new UndoRedoPlugin();\n  }\n  return new UndoRedoPlugin(config ?? undefined);\n});\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;AAeG;AAKH,eAAe,CAAC,UAAU,EAAE,CAAC,MAAM,KAAI;AACrC,IAAA,IAAI,MAAM,KAAK,IAAI,EAAE;QACnB,OAAO,IAAI,cAAc,EAAE;IAC7B;AACA,IAAA,OAAO,IAAI,cAAc,CAAC,MAAM,IAAI,SAAS,CAAC;AAChD,CAAC,CAAC;;ACzBF;;AAEG"}
+{"version":3,"file":"toolbox-web-grid-angular-features-undo-redo.mjs","sources":["../../../../libs/grid-angular/features/undo-redo/src/index.ts","../../../../libs/grid-angular/features/undo-redo/src/toolbox-web-grid-angular-features-undo-redo.ts"],"sourcesContent":["/**\n * Undo/Redo feature for @toolbox-web/grid-angular\n *\n * Import this module to enable the `undoRedo` input on Grid directive.\n * Also exports `injectGridUndoRedo()` for programmatic undo/redo control.\n * Requires editing feature to be enabled.\n *\n * @example\n * ```typescript\n * import '@toolbox-web/grid-angular/features/editing';\n * import '@toolbox-web/grid-angular/features/undo-redo';\n *\n * <tbw-grid [editing]=\"'dblclick'\" [undoRedo]=\"true\" />\n * ```\n *\n * @example Using injectGridUndoRedo\n * ```typescript\n * import { injectGridUndoRedo } from '@toolbox-web/grid-angular/features/undo-redo';\n *\n * @Component({...})\n * export class MyComponent {\n *   private undoRedo = injectGridUndoRedo();\n *\n *   undo() { this.undoRedo.undo(); }\n *   redo() { this.undoRedo.redo(); }\n * }\n * ```\n *\n * @packageDocumentation\n */\n\nimport { ElementRef, inject, signal, type Signal } from '@angular/core';\nimport type { DataGridElement } from '@toolbox-web/grid';\nimport { registerFeature } from '@toolbox-web/grid-angular';\nimport { UndoRedoPlugin, type EditAction } from '@toolbox-web/grid/plugins/undo-redo';\n\nregisterFeature('undoRedo', (config) => {\n  if (config === true) {\n    return new UndoRedoPlugin();\n  }\n  return new UndoRedoPlugin(config ?? undefined);\n});\n\n/**\n * Undo/Redo methods returned from injectGridUndoRedo.\n *\n * Uses lazy discovery - the grid is found on first method call, not during initialization.\n */\nexport interface UndoRedoMethods {\n  /**\n   * Undo the last edit action.\n   * @returns The undone action, or null if nothing to undo\n   */\n  undo: () => EditAction | null;\n\n  /**\n   * Redo the last undone action.\n   * @returns The redone action, or null if nothing to redo\n   */\n  redo: () => EditAction | null;\n\n  /**\n   * Check if there are any actions that can be undone.\n   */\n  canUndo: () => boolean;\n\n  /**\n   * Check if there are any actions that can be redone.\n   */\n  canRedo: () => boolean;\n\n  /**\n   * Clear all undo/redo history.\n   */\n  clearHistory: () => void;\n\n  /**\n   * Get a copy of the current undo stack.\n   */\n  getUndoStack: () => EditAction[];\n\n  /**\n   * Get a copy of the current redo stack.\n   */\n  getRedoStack: () => EditAction[];\n\n  /**\n   * Signal indicating if grid is ready.\n   */\n  isReady: Signal<boolean>;\n}\n\n/**\n * Angular inject function for programmatic undo/redo control.\n *\n * Uses **lazy grid discovery** - the grid element is found when methods are called,\n * not during initialization.\n *\n * @example\n * ```typescript\n * import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';\n * import { Grid } from '@toolbox-web/grid-angular';\n * import '@toolbox-web/grid-angular/features/editing';\n * import '@toolbox-web/grid-angular/features/undo-redo';\n * import { injectGridUndoRedo } from '@toolbox-web/grid-angular/features/undo-redo';\n *\n * @Component({\n *   selector: 'app-my-grid',\n *   imports: [Grid],\n *   schemas: [CUSTOM_ELEMENTS_SCHEMA],\n *   template: `\n *     <button (click)=\"undoRedo.undo()\" [disabled]=\"!undoRedo.canUndo()\">Undo</button>\n *     <button (click)=\"undoRedo.redo()\" [disabled]=\"!undoRedo.canRedo()\">Redo</button>\n *     <tbw-grid [rows]=\"rows\" [editing]=\"'dblclick'\" [undoRedo]=\"true\"></tbw-grid>\n *   `\n * })\n * export class MyGridComponent {\n *   undoRedo = injectGridUndoRedo();\n * }\n * ```\n */\nexport function injectGridUndoRedo(): UndoRedoMethods {\n  const elementRef = inject(ElementRef);\n  const isReady = signal(false);\n\n  let cachedGrid: DataGridElement | null = null;\n  let readyPromiseStarted = false;\n\n  const getGrid = (): DataGridElement | null => {\n    if (cachedGrid) return cachedGrid;\n\n    const grid = elementRef.nativeElement.querySelector('tbw-grid') as DataGridElement | null;\n    if (grid) {\n      cachedGrid = grid;\n      if (!readyPromiseStarted) {\n        readyPromiseStarted = true;\n        grid.ready?.().then(() => isReady.set(true));\n      }\n    }\n    return grid;\n  };\n\n  const getPlugin = (): UndoRedoPlugin | undefined => {\n    return getGrid()?.getPlugin(UndoRedoPlugin);\n  };\n\n  return {\n    isReady: isReady.asReadonly(),\n\n    undo: () => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:undoRedo] UndoRedoPlugin not found.\\n\\n` +\n            `  → Enable undo/redo on the grid:\\n` +\n            `    <tbw-grid [editing]=\"'dblclick'\" [undoRedo]=\"true\" />`,\n        );\n        return null;\n      }\n      return plugin.undo();\n    },\n\n    redo: () => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:undoRedo] UndoRedoPlugin not found.\\n\\n` +\n            `  → Enable undo/redo on the grid:\\n` +\n            `    <tbw-grid [editing]=\"'dblclick'\" [undoRedo]=\"true\" />`,\n        );\n        return null;\n      }\n      return plugin.redo();\n    },\n\n    canUndo: () => getPlugin()?.canUndo() ?? false,\n\n    canRedo: () => getPlugin()?.canRedo() ?? false,\n\n    clearHistory: () => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:undoRedo] UndoRedoPlugin not found.\\n\\n` +\n            `  → Enable undo/redo on the grid:\\n` +\n            `    <tbw-grid [editing]=\"'dblclick'\" [undoRedo]=\"true\" />`,\n        );\n        return;\n      }\n      plugin.clearHistory();\n    },\n\n    getUndoStack: () => getPlugin()?.getUndoStack() ?? [],\n\n    getRedoStack: () => getPlugin()?.getRedoStack() ?? [],\n  };\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BG;AAOH,eAAe,CAAC,UAAU,EAAE,CAAC,MAAM,KAAI;AACrC,IAAA,IAAI,MAAM,KAAK,IAAI,EAAE;QACnB,OAAO,IAAI,cAAc,EAAE;IAC7B;AACA,IAAA,OAAO,IAAI,cAAc,CAAC,MAAM,IAAI,SAAS,CAAC;AAChD,CAAC,CAAC;AAmDF;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BG;SACa,kBAAkB,GAAA;AAChC,IAAA,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;AACrC,IAAA,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,mDAAC;IAE7B,IAAI,UAAU,GAA2B,IAAI;IAC7C,IAAI,mBAAmB,GAAG,KAAK;IAE/B,MAAM,OAAO,GAAG,MAA6B;AAC3C,QAAA,IAAI,UAAU;AAAE,YAAA,OAAO,UAAU;QAEjC,MAAM,IAAI,GAAG,UAAU,CAAC,aAAa,CAAC,aAAa,CAAC,UAAU,CAA2B;QACzF,IAAI,IAAI,EAAE;YACR,UAAU,GAAG,IAAI;YACjB,IAAI,CAAC,mBAAmB,EAAE;gBACxB,mBAAmB,GAAG,IAAI;AAC1B,gBAAA,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC9C;QACF;AACA,QAAA,OAAO,IAAI;AACb,IAAA,CAAC;IAED,MAAM,SAAS,GAAG,MAAiC;AACjD,QAAA,OAAO,OAAO,EAAE,EAAE,SAAS,CAAC,cAAc,CAAC;AAC7C,IAAA,CAAC;IAED,OAAO;AACL,QAAA,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE;QAE7B,IAAI,EAAE,MAAK;AACT,YAAA,MAAM,MAAM,GAAG,SAAS,EAAE;YAC1B,IAAI,CAAC,MAAM,EAAE;gBACX,OAAO,CAAC,IAAI,CACV,CAAA,iDAAA,CAAmD;oBACjD,CAAA,mCAAA,CAAqC;AACrC,oBAAA,CAAA,yDAAA,CAA2D,CAC9D;AACD,gBAAA,OAAO,IAAI;YACb;AACA,YAAA,OAAO,MAAM,CAAC,IAAI,EAAE;QACtB,CAAC;QAED,IAAI,EAAE,MAAK;AACT,YAAA,MAAM,MAAM,GAAG,SAAS,EAAE;YAC1B,IAAI,CAAC,MAAM,EAAE;gBACX,OAAO,CAAC,IAAI,CACV,CAAA,iDAAA,CAAmD;oBACjD,CAAA,mCAAA,CAAqC;AACrC,oBAAA,CAAA,yDAAA,CAA2D,CAC9D;AACD,gBAAA,OAAO,IAAI;YACb;AACA,YAAA,OAAO,MAAM,CAAC,IAAI,EAAE;QACtB,CAAC;QAED,OAAO,EAAE,MAAM,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,KAAK;QAE9C,OAAO,EAAE,MAAM,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,KAAK;QAE9C,YAAY,EAAE,MAAK;AACjB,YAAA,MAAM,MAAM,GAAG,SAAS,EAAE;YAC1B,IAAI,CAAC,MAAM,EAAE;gBACX,OAAO,CAAC,IAAI,CACV,CAAA,iDAAA,CAAmD;oBACjD,CAAA,mCAAA,CAAqC;AACrC,oBAAA,CAAA,yDAAA,CAA2D,CAC9D;gBACD;YACF;YACA,MAAM,CAAC,YAAY,EAAE;QACvB,CAAC;QAED,YAAY,EAAE,MAAM,SAAS,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;QAErD,YAAY,EAAE,MAAM,SAAS,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACtD;AACH;;ACpMA;;AAEG;;;;"}