@toolbox-web/grid-angular 1.3.1 → 1.4.0

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

@@ -1,9 +1,111 @@
+import { registerFeatureClaim, claimEvent, unregisterFeatureClaim, unclaimEvent, registerEditorMountHook, makeFlushFocusedInput } from '@toolbox-web/grid-angular';
+export { BaseGridEditor, BaseGridEditorCVA, BaseOverlayEditor, GridColumnEditor, GridFormArray, GridLazyForm, TbwEditor, getFormArrayContext, getLazyFormContext } from '@toolbox-web/grid-angular';
 import '@toolbox-web/grid/features/editing';
+import * as i0 from '@angular/core';
+import { inject, ElementRef, input, output, Directive } from '@angular/core';
+
+/**
+ * `GridEditingDirective` — owns `[editing]` and the editing-specific
+ * outputs on `<tbw-grid>`. The shared outputs `cellChange` and `dataChange`
+ * stay on `Grid` because they are emitted by multiple sources, not just
+ * the editing plugin. See `GridFilteringDirective` for full rationale.
+ *
+ * Output type compatibility note: this directive uses the Angular adapter
+ * wrapper types `CellCommitEvent` / `RowCommitEvent` (re-exported from the
+ * package barrel) to stay binary-compatible with apps migrating from the
+ * deprecated bindings on `Grid`.
+ *
+ * @category Directive
+ */
+/**
+ * Owns the binding(s) `[editing], [cellCommit], [cellCancel], [rowCommit], [changedRowsReset], [editOpen], [beforeEditClose], [editClose], [dirtyChange]` on `<tbw-grid>` for the matching feature plugin. See {@link GridFilteringDirective} for the full rationale.
+ *
+ * @category Directive
+ */
+class GridEditingDirective {
+    elementRef = inject((ElementRef));
+    editing = input(...(ngDevMode ? [undefined, { debugName: "editing" }] : /* istanbul ignore next */ []));
+    cellCommit = output();
+    cellCancel = output();
+    rowCommit = output();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    changedRowsReset = output();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    editOpen = output();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    beforeEditClose = output();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    editClose = output();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    dirtyChange = output();
+    listeners = new Map();
+    static EVENTS = [
+        'cell-commit',
+        'cell-cancel',
+        'row-commit',
+        'changed-rows-reset',
+        'edit-open',
+        'before-edit-close',
+        'edit-close',
+        'dirty-change',
+    ];
+    constructor() {
+        const grid = this.elementRef.nativeElement;
+        registerFeatureClaim(grid, 'editing', () => this.editing());
+        for (const ev of GridEditingDirective.EVENTS)
+            claimEvent(grid, ev);
+    }
+    ngOnInit() {
+        const grid = this.elementRef.nativeElement;
+        const wire = (name, out) => {
+            const l = (e) => out.emit(e.detail);
+            grid.addEventListener(name, l);
+            this.listeners.set(name, l);
+        };
+        wire('cell-commit', this.cellCommit);
+        wire('cell-cancel', this.cellCancel);
+        wire('row-commit', this.rowCommit);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        wire('changed-rows-reset', this.changedRowsReset);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        wire('edit-open', this.editOpen);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        wire('before-edit-close', this.beforeEditClose);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        wire('edit-close', this.editClose);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        wire('dirty-change', this.dirtyChange);
+    }
+    ngOnDestroy() {
+        const grid = this.elementRef.nativeElement;
+        for (const [name, l] of this.listeners)
+            grid.removeEventListener(name, l);
+        this.listeners.clear();
+        unregisterFeatureClaim(grid, 'editing');
+        for (const ev of GridEditingDirective.EVENTS)
+            unclaimEvent(grid, ev);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: GridEditingDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "21.2.5", type: GridEditingDirective, isStandalone: true, selector: "tbw-grid[editing], tbw-grid[cellCommit], tbw-grid[cellCancel], tbw-grid[rowCommit], tbw-grid[changedRowsReset], tbw-grid[editOpen], tbw-grid[beforeEditClose], tbw-grid[editClose], tbw-grid[dirtyChange]", inputs: { editing: { classPropertyName: "editing", publicName: "editing", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { cellCommit: "cellCommit", cellCancel: "cellCancel", rowCommit: "rowCommit", changedRowsReset: "changedRowsReset", editOpen: "editOpen", beforeEditClose: "beforeEditClose", editClose: "editClose", dirtyChange: "dirtyChange" }, ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: GridEditingDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: 'tbw-grid[editing], tbw-grid[cellCommit], tbw-grid[cellCancel], tbw-grid[rowCommit], tbw-grid[changedRowsReset], tbw-grid[editOpen], tbw-grid[beforeEditClose], tbw-grid[editClose], tbw-grid[dirtyChange]',
+                    standalone: true,
+                }]
+        }], ctorParameters: () => [], propDecorators: { editing: [{ type: i0.Input, args: [{ isSignal: true, alias: "editing", required: false }] }], cellCommit: [{ type: i0.Output, args: ["cellCommit"] }], cellCancel: [{ type: i0.Output, args: ["cellCancel"] }], rowCommit: [{ type: i0.Output, args: ["rowCommit"] }], changedRowsReset: [{ type: i0.Output, args: ["changedRowsReset"] }], editOpen: [{ type: i0.Output, args: ["editOpen"] }], beforeEditClose: [{ type: i0.Output, args: ["beforeEditClose"] }], editClose: [{ type: i0.Output, args: ["editClose"] }], dirtyChange: [{ type: i0.Output, args: ["dirtyChange"] }] } });
 
 /**
  * Editing feature for @toolbox-web/grid-angular
  *
- * Import this module to enable the `editing` input on Grid directive.
+ * Import this module to enable the `editing` input on Grid directive AND to
+ * install the `before-edit-close` blur bridge that flushes pending input from
+ * Angular editors that commit on `(blur)` before the cell DOM is torn down by
+ * Tab / programmatic row exit.
+ *
+ * Without this import, Angular `(blur)`-committing editors silently lose
+ * pending input on programmatic row exit.
  *
  * @example
  * ```typescript
@@ -14,8 +116,20 @@ import '@toolbox-web/grid/features/editing';
  *
  * @packageDocumentation
  */
+// Bridge the editing plugin's `before-edit-close` event to a synchronous
+// `.blur()` on the focused input/textarea/select inside the editor host.
+// Angular editors that commit on `(blur)` rely on the focused control firing
+// blur naturally, but Tab / programmatic row exit rebuilds the cell DOM
+// synchronously without giving the focused control a chance to blur first.
+registerEditorMountHook(({ container, gridEl }) => {
+    const flush = makeFlushFocusedInput(container);
+    gridEl.addEventListener('before-edit-close', flush);
+    return () => gridEl.removeEventListener('before-edit-close', flush);
+});
 
 /**
  * Generated bundle index. Do not edit.
  */
+
+export { GridEditingDirective };
 //# sourceMappingURL=toolbox-web-grid-angular-features-editing.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"toolbox-web-grid-angular-features-editing.mjs","sources":["../../../../libs/grid-angular/features/editing/src/index.ts","../../../../libs/grid-angular/features/editing/src/toolbox-web-grid-angular-features-editing.ts"],"sourcesContent":["/**\n * Editing feature for @toolbox-web/grid-angular\n *\n * Import this module to enable the `editing` input on Grid directive.\n *\n * @example\n * ```typescript\n * import '@toolbox-web/grid-angular/features/editing';\n *\n * <tbw-grid [editing]=\"'dblclick'\" />\n * ```\n *\n * @packageDocumentation\n */\n\nimport '@toolbox-web/grid/features/editing';\nexport type { _Augmentation as _EditingAugmentation } from '@toolbox-web/grid/features/editing';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;AAAA;;;;;;;;;;;;;AAaG;;ACbH;;AAEG"}
+{"version":3,"file":"toolbox-web-grid-angular-features-editing.mjs","sources":["../../../../libs/grid-angular/features/editing/src/grid-editing.directive.ts","../../../../libs/grid-angular/features/editing/src/index.ts","../../../../libs/grid-angular/features/editing/src/toolbox-web-grid-angular-features-editing.ts"],"sourcesContent":["/**\n * `GridEditingDirective` — owns `[editing]` and the editing-specific\n * outputs on `<tbw-grid>`. The shared outputs `cellChange` and `dataChange`\n * stay on `Grid` because they are emitted by multiple sources, not just\n * the editing plugin. See `GridFilteringDirective` for full rationale.\n *\n * Output type compatibility note: this directive uses the Angular adapter\n * wrapper types `CellCommitEvent` / `RowCommitEvent` (re-exported from the\n * package barrel) to stay binary-compatible with apps migrating from the\n * deprecated bindings on `Grid`.\n *\n * @category Directive\n */\nimport { Directive, ElementRef, inject, input, OnDestroy, OnInit, output } from '@angular/core';\nimport type { DataGridElement } from '@toolbox-web/grid';\nimport {\n  type CellCommitEvent,\n  claimEvent,\n  registerFeatureClaim,\n  type RowCommitEvent,\n  unclaimEvent,\n  unregisterFeatureClaim,\n} from '@toolbox-web/grid-angular';\nimport type {\n  BeforeEditCloseDetail,\n  CellCancelDetail,\n  ChangedRowsResetDetail,\n  DirtyChangeDetail,\n  EditCloseDetail,\n  EditingConfig,\n  EditOpenDetail,\n} from '@toolbox-web/grid/plugins/editing';\n\n/**\n * Owns the binding(s) `[editing], [cellCommit], [cellCancel], [rowCommit], [changedRowsReset], [editOpen], [beforeEditClose], [editClose], [dirtyChange]` on `<tbw-grid>` for the matching feature plugin. See {@link GridFilteringDirective} for the full rationale.\n *\n * @category Directive\n */\n@Directive({\n  selector:\n    'tbw-grid[editing], tbw-grid[cellCommit], tbw-grid[cellCancel], tbw-grid[rowCommit], tbw-grid[changedRowsReset], tbw-grid[editOpen], tbw-grid[beforeEditClose], tbw-grid[editClose], tbw-grid[dirtyChange]',\n  standalone: true,\n})\nexport class GridEditingDirective implements OnInit, OnDestroy {\n  private readonly elementRef = inject(ElementRef<DataGridElement>);\n\n  readonly editing = input<boolean | 'click' | 'dblclick' | 'manual' | EditingConfig>();\n  readonly cellCommit = output<CellCommitEvent>();\n  readonly cellCancel = output<CellCancelDetail>();\n  readonly rowCommit = output<RowCommitEvent>();\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  readonly changedRowsReset = output<ChangedRowsResetDetail<any>>();\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  readonly editOpen = output<EditOpenDetail<any>>();\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  readonly beforeEditClose = output<BeforeEditCloseDetail<any>>();\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  readonly editClose = output<EditCloseDetail<any>>();\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  readonly dirtyChange = output<DirtyChangeDetail<any>>();\n\n  private readonly listeners = new Map<string, (e: Event) => void>();\n  private static readonly EVENTS = [\n    'cell-commit',\n    'cell-cancel',\n    'row-commit',\n    'changed-rows-reset',\n    'edit-open',\n    'before-edit-close',\n    'edit-close',\n    'dirty-change',\n  ] as const;\n\n  constructor() {\n    const grid = this.elementRef.nativeElement;\n    registerFeatureClaim(grid, 'editing', () => this.editing());\n    for (const ev of GridEditingDirective.EVENTS) claimEvent(grid, ev);\n  }\n\n  ngOnInit(): void {\n    const grid = this.elementRef.nativeElement;\n    const wire = <T>(name: string, out: { emit: (v: T) => void }): void => {\n      const l = (e: Event): void => out.emit((e as CustomEvent<T>).detail);\n      grid.addEventListener(name, l);\n      this.listeners.set(name, l);\n    };\n    wire<CellCommitEvent>('cell-commit', this.cellCommit);\n    wire<CellCancelDetail>('cell-cancel', this.cellCancel);\n    wire<RowCommitEvent>('row-commit', this.rowCommit);\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    wire<ChangedRowsResetDetail<any>>('changed-rows-reset', this.changedRowsReset);\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    wire<EditOpenDetail<any>>('edit-open', this.editOpen);\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    wire<BeforeEditCloseDetail<any>>('before-edit-close', this.beforeEditClose);\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    wire<EditCloseDetail<any>>('edit-close', this.editClose);\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    wire<DirtyChangeDetail<any>>('dirty-change', this.dirtyChange);\n  }\n\n  ngOnDestroy(): void {\n    const grid = this.elementRef.nativeElement;\n    for (const [name, l] of this.listeners) grid.removeEventListener(name, l);\n    this.listeners.clear();\n    unregisterFeatureClaim(grid, 'editing');\n    for (const ev of GridEditingDirective.EVENTS) unclaimEvent(grid, ev);\n  }\n}\n","/**\n * Editing feature for @toolbox-web/grid-angular\n *\n * Import this module to enable the `editing` input on Grid directive AND to\n * install the `before-edit-close` blur bridge that flushes pending input from\n * Angular editors that commit on `(blur)` before the cell DOM is torn down by\n * Tab / programmatic row exit.\n *\n * Without this import, Angular `(blur)`-committing editors silently lose\n * pending input on programmatic row exit.\n *\n * @example\n * ```typescript\n * import '@toolbox-web/grid-angular/features/editing';\n *\n * <tbw-grid [editing]=\"'dblclick'\" />\n * ```\n *\n * @packageDocumentation\n */\n\nimport { makeFlushFocusedInput, registerEditorMountHook } from '@toolbox-web/grid-angular';\nimport '@toolbox-web/grid/features/editing';\nexport { GridEditingDirective } from './grid-editing.directive';\nexport type { _Augmentation as _EditingAugmentation } from '@toolbox-web/grid/features/editing';\n\n// ---------------------------------------------------------------------------\n// Re-exports from `@toolbox-web/grid-angular` (main entry).\n//\n// These symbols still physically live in the main `@toolbox-web/grid-angular`\n// package today, but they are editing-specific and are re-exported here so\n// consumers can import them from the feature entry that owns the runtime\n// behaviour. The same symbols are marked `@deprecated` on the main entry.\n//\n// In v2.0.0 the source files will physically move into this secondary entry\n// and the deprecated re-exports on the main entry will be removed. Searching\n// for `@deprecated` in `libs/grid-angular/src/` enumerates everything that\n// needs to move at that point.\n// ---------------------------------------------------------------------------\nexport {\n  BaseGridEditor,\n  BaseGridEditorCVA,\n  BaseOverlayEditor,\n  getFormArrayContext,\n  getLazyFormContext,\n  GridColumnEditor,\n  GridFormArray,\n  GridLazyForm,\n  TbwEditor,\n} from '@toolbox-web/grid-angular';\nexport type {\n  FormArrayContext,\n  GridEditorContext,\n  LazyFormFactory,\n  OverlayPosition,\n  RowFormChangeEvent,\n  StructuralEditorContext,\n} from '@toolbox-web/grid-angular';\n\n// Bridge the editing plugin's `before-edit-close` event to a synchronous\n// `.blur()` on the focused input/textarea/select inside the editor host.\n// Angular editors that commit on `(blur)` rely on the focused control firing\n// blur naturally, but Tab / programmatic row exit rebuilds the cell DOM\n// synchronously without giving the focused control a chance to blur first.\nregisterEditorMountHook(({ container, gridEl }) => {\n  const flush = makeFlushFocusedInput(container);\n  gridEl.addEventListener('before-edit-close', flush);\n  return () => gridEl.removeEventListener('before-edit-close', flush);\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-export.mjs

@@ -1,5 +1,58 @@
-import { inject, ElementRef, DestroyRef, signal, afterNextRender } from '@angular/core';
+import * as i0 from '@angular/core';
+import { inject, ElementRef, input, output, Directive, DestroyRef, signal, afterNextRender } from '@angular/core';
 import '@toolbox-web/grid/features/export';
+import { registerFeatureClaim, claimEvent, unregisterFeatureClaim, unclaimEvent } from '@toolbox-web/grid-angular';
+
+/**
+ * `GridExportDirective` — owns the `export` input (template alias of
+ * `exportFeature`) and `(exportComplete)` on `<tbw-grid>`. See
+ * `GridFilteringDirective` for the full rationale.
+ *
+ * The TypeScript field is `exportFeature` (with `alias: 'export'`) because
+ * `export` is a reserved keyword. Templates use `[export]` / `(exportComplete)`
+ * exactly as before.
+ *
+ * @category Directive
+ */
+/**
+ * Owns the binding(s) `[export], [exportComplete]` on `<tbw-grid>` for the matching feature plugin. See {@link GridFilteringDirective} for the full rationale.
+ *
+ * @category Directive
+ */
+class GridExportDirective {
+    elementRef = inject((ElementRef));
+    exportFeature = input(undefined, { ...(ngDevMode ? { debugName: "exportFeature" } : /* istanbul ignore next */ {}), alias: 'export' });
+    exportComplete = output();
+    listener;
+    constructor() {
+        const grid = this.elementRef.nativeElement;
+        registerFeatureClaim(grid, 'export', () => this.exportFeature());
+        claimEvent(grid, 'export-complete');
+    }
+    ngOnInit() {
+        const grid = this.elementRef.nativeElement;
+        this.listener = (e) => this.exportComplete.emit(e.detail);
+        grid.addEventListener('export-complete', this.listener);
+    }
+    ngOnDestroy() {
+        const grid = this.elementRef.nativeElement;
+        if (this.listener) {
+            grid.removeEventListener('export-complete', this.listener);
+            this.listener = undefined;
+        }
+        unregisterFeatureClaim(grid, 'export');
+        unclaimEvent(grid, 'export-complete');
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: GridExportDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "21.2.5", type: GridExportDirective, isStandalone: true, selector: "tbw-grid[export], tbw-grid[exportComplete]", inputs: { exportFeature: { classPropertyName: "exportFeature", publicName: "export", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { exportComplete: "exportComplete" }, ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: GridExportDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: 'tbw-grid[export], tbw-grid[exportComplete]',
+                    standalone: true,
+                }]
+        }], ctorParameters: () => [], propDecorators: { exportFeature: [{ type: i0.Input, args: [{ isSignal: true, alias: "export", required: false }] }], exportComplete: [{ type: i0.Output, args: ["exportComplete"] }] } });
 
 /**
  * Export feature for @toolbox-web/grid-angular
@@ -162,5 +215,5 @@ function injectGridExport(selector = 'tbw-grid') {
  * Generated bundle index. Do not edit.
  */
 
-export { injectGridExport };
+export { GridExportDirective, injectGridExport };
 //# sourceMappingURL=toolbox-web-grid-angular-features-export.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"toolbox-web-grid-angular-features-export.mjs","sources":["../../../../libs/grid-angular/features/export/src/index.ts","../../../../libs/grid-angular/features/export/src/toolbox-web-grid-angular-features-export.ts"],"sourcesContent":["/**\n * Export feature for @toolbox-web/grid-angular\n *\n * Import this module to enable the `export` input on Grid directive.\n * Also exports `injectGridExport()` for programmatic export control.\n *\n * @example\n * ```typescript\n * import '@toolbox-web/grid-angular/features/export';\n *\n * <tbw-grid [export]=\"true\" />\n * <tbw-grid [export]=\"{ fileName: 'data.csv' }\" />\n * ```\n *\n * @example Using injectGridExport\n * ```typescript\n * import { injectGridExport } from '@toolbox-web/grid-angular/features/export';\n *\n * @Component({...})\n * export class MyComponent {\n *   private gridExport = injectGridExport();\n *\n *   exportData() {\n *     this.gridExport.exportToCsv('employees.csv');\n *   }\n * }\n * ```\n *\n * @packageDocumentation\n */\n\nimport { afterNextRender, DestroyRef, ElementRef, inject, signal, type Signal } from '@angular/core';\nimport type { DataGridElement } from '@toolbox-web/grid';\nimport '@toolbox-web/grid/features/export';\nimport { ExportPlugin, type ExportFormat, type ExportParams } from '@toolbox-web/grid/plugins/export';\nexport type { _Augmentation as _ExportAugmentation } from '@toolbox-web/grid/features/export';\n\n/**\n * Export methods returned from injectGridExport.\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 ExportMethods {\n  /**\n   * Export grid data to CSV file.\n   * @param filename - Optional filename (defaults to 'export.csv')\n   * @param params - Optional export parameters\n   */\n  exportToCsv: (filename?: string, params?: Partial<ExportParams>) => void;\n\n  /**\n   * Export grid data to Excel file (XML Spreadsheet format).\n   * @param filename - Optional filename (defaults to 'export.xlsx')\n   * @param params - Optional export parameters\n   */\n  exportToExcel: (filename?: string, params?: Partial<ExportParams>) => void;\n\n  /**\n   * Export grid data to JSON file.\n   * @param filename - Optional filename (defaults to 'export.json')\n   * @param params - Optional export parameters\n   */\n  exportToJson: (filename?: string, params?: Partial<ExportParams>) => void;\n\n  /**\n   * Check if an export is currently in progress.\n   */\n  isExporting: () => boolean;\n\n  /**\n   * Get information about the last export.\n   */\n  getLastExport: () => { format: ExportFormat; timestamp: Date } | null;\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 export 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 } from '@angular/core';\n * import { Grid } from '@toolbox-web/grid-angular';\n * import '@toolbox-web/grid-angular/features/export';\n * import { injectGridExport } from '@toolbox-web/grid-angular/features/export';\n *\n * @Component({\n *   selector: 'app-my-grid',\n *   imports: [Grid],\n *   template: `\n *     <button (click)=\"handleExport()\">Export CSV</button>\n *     <tbw-grid [rows]=\"rows\" [export]=\"true\"></tbw-grid>\n *   `\n * })\n * export class MyGridComponent {\n *   gridExport = injectGridExport();\n *\n *   handleExport() {\n *     this.gridExport.exportToCsv('employees.csv');\n *   }\n * }\n * ```\n *\n * @param selector - Optional CSS selector to target a specific grid element.\n *   Defaults to `'tbw-grid'` (first grid in the component). Use when the\n *   component contains multiple grids, e.g. `'tbw-grid.primary'` or `'#my-grid'`.\n */\nexport function injectGridExport(selector = 'tbw-grid'): ExportMethods {\n  const elementRef = inject(ElementRef);\n  const destroyRef = inject(DestroyRef);\n  const isReady = signal(false);\n\n  // Lazy discovery: cached grid reference\n  let cachedGrid: DataGridElement | 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 | null => {\n    if (cachedGrid) return cachedGrid;\n\n    const grid = elementRef.nativeElement.querySelector(selector) as DataGridElement | null;\n    if (grid) {\n      cachedGrid = grid;\n      // Start ready() check only once\n      if (!readyPromiseStarted) {\n        readyPromiseStarted = true;\n        grid.ready?.().then(() => {\n          if (grid.getPluginByName('export')) {\n            isReady.set(true);\n          } else {\n            setTimeout(() => isReady.set(true), 0);\n          }\n        });\n      }\n    }\n    return grid;\n  };\n\n  const getPlugin = (): ExportPlugin | undefined => {\n    return getGrid()?.getPluginByName('export') as ExportPlugin | undefined;\n  };\n\n  // Eagerly discover the grid after the first render so isReady updates\n  // without requiring a programmatic method call. Falls back to a\n  // MutationObserver for lazy-rendered tabs, *ngIf, @defer, etc.\n  afterNextRender(() => {\n    if (getGrid()) return;\n\n    const host = elementRef.nativeElement as HTMLElement;\n    const observer = new MutationObserver(() => {\n      if (getGrid()) observer.disconnect();\n    });\n    observer.observe(host, { childList: true, subtree: true });\n\n    destroyRef.onDestroy(() => observer.disconnect());\n  });\n\n  return {\n    isReady: isReady.asReadonly(),\n\n    exportToCsv: (filename?: string, params?: Partial<ExportParams>) => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:export] ExportPlugin not found.\\n\\n` +\n            `  → Enable export on the grid:\\n` +\n            `    <tbw-grid [export]=\"true\" />`,\n        );\n        return;\n      }\n      plugin.exportCsv({ ...params, fileName: filename ?? params?.fileName ?? 'export.csv' });\n    },\n\n    exportToExcel: (filename?: string, params?: Partial<ExportParams>) => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:export] ExportPlugin not found.\\n\\n` +\n            `  → Enable export on the grid:\\n` +\n            `    <tbw-grid [export]=\"true\" />`,\n        );\n        return;\n      }\n      plugin.exportExcel({ ...params, fileName: filename ?? params?.fileName ?? 'export.xlsx' });\n    },\n\n    exportToJson: (filename?: string, params?: Partial<ExportParams>) => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:export] ExportPlugin not found.\\n\\n` +\n            `  → Enable export on the grid:\\n` +\n            `    <tbw-grid [export]=\"true\" />`,\n        );\n        return;\n      }\n      plugin.exportJson({ ...params, fileName: filename ?? params?.fileName ?? 'export.json' });\n    },\n\n    isExporting: () => {\n      return getPlugin()?.isExporting() ?? false;\n    },\n\n    getLastExport: () => {\n      return getPlugin()?.getLastExport() ?? null;\n    },\n  };\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"toolbox-web-grid-angular-features-export.mjs","sources":["../../../../libs/grid-angular/features/export/src/grid-export.directive.ts","../../../../libs/grid-angular/features/export/src/index.ts","../../../../libs/grid-angular/features/export/src/toolbox-web-grid-angular-features-export.ts"],"sourcesContent":["/**\n * `GridExportDirective` — owns the `export` input (template alias of\n * `exportFeature`) and `(exportComplete)` on `<tbw-grid>`. See\n * `GridFilteringDirective` for the full rationale.\n *\n * The TypeScript field is `exportFeature` (with `alias: 'export'`) because\n * `export` is a reserved keyword. Templates use `[export]` / `(exportComplete)`\n * exactly as before.\n *\n * @category Directive\n */\nimport { Directive, ElementRef, inject, input, OnDestroy, OnInit, output } from '@angular/core';\nimport type { DataGridElement } from '@toolbox-web/grid';\nimport { claimEvent, registerFeatureClaim, unclaimEvent, unregisterFeatureClaim } from '@toolbox-web/grid-angular';\nimport type { ExportCompleteDetail, ExportConfig } from '@toolbox-web/grid/plugins/export';\n\n/**\n * Owns the binding(s) `[export], [exportComplete]` on `<tbw-grid>` for the matching feature plugin. See {@link GridFilteringDirective} for the full rationale.\n *\n * @category Directive\n */\n@Directive({\n  selector: 'tbw-grid[export], tbw-grid[exportComplete]',\n  standalone: true,\n})\nexport class GridExportDirective implements OnInit, OnDestroy {\n  private readonly elementRef = inject(ElementRef<DataGridElement>);\n\n  readonly exportFeature = input<boolean | ExportConfig>(undefined, { alias: 'export' });\n  readonly exportComplete = output<ExportCompleteDetail>();\n\n  private listener?: (e: Event) => void;\n\n  constructor() {\n    const grid = this.elementRef.nativeElement;\n    registerFeatureClaim(grid, 'export', () => this.exportFeature());\n    claimEvent(grid, 'export-complete');\n  }\n\n  ngOnInit(): void {\n    const grid = this.elementRef.nativeElement;\n    this.listener = (e: Event): void => this.exportComplete.emit((e as CustomEvent<ExportCompleteDetail>).detail);\n    grid.addEventListener('export-complete', this.listener);\n  }\n\n  ngOnDestroy(): void {\n    const grid = this.elementRef.nativeElement;\n    if (this.listener) {\n      grid.removeEventListener('export-complete', this.listener);\n      this.listener = undefined;\n    }\n    unregisterFeatureClaim(grid, 'export');\n    unclaimEvent(grid, 'export-complete');\n  }\n}\n","/**\n * Export feature for @toolbox-web/grid-angular\n *\n * Import this module to enable the `export` input on Grid directive.\n * Also exports `injectGridExport()` for programmatic export control.\n *\n * @example\n * ```typescript\n * import '@toolbox-web/grid-angular/features/export';\n *\n * <tbw-grid [export]=\"true\" />\n * <tbw-grid [export]=\"{ fileName: 'data.csv' }\" />\n * ```\n *\n * @example Using injectGridExport\n * ```typescript\n * import { injectGridExport } from '@toolbox-web/grid-angular/features/export';\n *\n * @Component({...})\n * export class MyComponent {\n *   private gridExport = injectGridExport();\n *\n *   exportData() {\n *     this.gridExport.exportToCsv('employees.csv');\n *   }\n * }\n * ```\n *\n * @packageDocumentation\n */\n\nimport { afterNextRender, DestroyRef, ElementRef, inject, signal, type Signal } from '@angular/core';\nimport type { DataGridElement } from '@toolbox-web/grid';\nimport '@toolbox-web/grid/features/export';\nimport { ExportPlugin, type ExportFormat, type ExportParams } from '@toolbox-web/grid/plugins/export';\nexport { GridExportDirective } from './grid-export.directive';\nexport type { _Augmentation as _ExportAugmentation } from '@toolbox-web/grid/features/export';\n\n/**\n * Export methods returned from injectGridExport.\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 ExportMethods {\n  /**\n   * Export grid data to CSV file.\n   * @param filename - Optional filename (defaults to 'export.csv')\n   * @param params - Optional export parameters\n   */\n  exportToCsv: (filename?: string, params?: Partial<ExportParams>) => void;\n\n  /**\n   * Export grid data to Excel file (XML Spreadsheet format).\n   * @param filename - Optional filename (defaults to 'export.xlsx')\n   * @param params - Optional export parameters\n   */\n  exportToExcel: (filename?: string, params?: Partial<ExportParams>) => void;\n\n  /**\n   * Export grid data to JSON file.\n   * @param filename - Optional filename (defaults to 'export.json')\n   * @param params - Optional export parameters\n   */\n  exportToJson: (filename?: string, params?: Partial<ExportParams>) => void;\n\n  /**\n   * Check if an export is currently in progress.\n   */\n  isExporting: () => boolean;\n\n  /**\n   * Get information about the last export.\n   */\n  getLastExport: () => { format: ExportFormat; timestamp: Date } | null;\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 export 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 } from '@angular/core';\n * import { Grid } from '@toolbox-web/grid-angular';\n * import '@toolbox-web/grid-angular/features/export';\n * import { injectGridExport } from '@toolbox-web/grid-angular/features/export';\n *\n * @Component({\n *   selector: 'app-my-grid',\n *   imports: [Grid],\n *   template: `\n *     <button (click)=\"handleExport()\">Export CSV</button>\n *     <tbw-grid [rows]=\"rows\" [export]=\"true\"></tbw-grid>\n *   `\n * })\n * export class MyGridComponent {\n *   gridExport = injectGridExport();\n *\n *   handleExport() {\n *     this.gridExport.exportToCsv('employees.csv');\n *   }\n * }\n * ```\n *\n * @param selector - Optional CSS selector to target a specific grid element.\n *   Defaults to `'tbw-grid'` (first grid in the component). Use when the\n *   component contains multiple grids, e.g. `'tbw-grid.primary'` or `'#my-grid'`.\n */\nexport function injectGridExport(selector = 'tbw-grid'): ExportMethods {\n  const elementRef = inject(ElementRef);\n  const destroyRef = inject(DestroyRef);\n  const isReady = signal(false);\n\n  // Lazy discovery: cached grid reference\n  let cachedGrid: DataGridElement | 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 | null => {\n    if (cachedGrid) return cachedGrid;\n\n    const grid = elementRef.nativeElement.querySelector(selector) as DataGridElement | null;\n    if (grid) {\n      cachedGrid = grid;\n      // Start ready() check only once\n      if (!readyPromiseStarted) {\n        readyPromiseStarted = true;\n        grid.ready?.().then(() => {\n          if (grid.getPluginByName('export')) {\n            isReady.set(true);\n          } else {\n            setTimeout(() => isReady.set(true), 0);\n          }\n        });\n      }\n    }\n    return grid;\n  };\n\n  const getPlugin = (): ExportPlugin | undefined => {\n    return getGrid()?.getPluginByName('export') as ExportPlugin | undefined;\n  };\n\n  // Eagerly discover the grid after the first render so isReady updates\n  // without requiring a programmatic method call. Falls back to a\n  // MutationObserver for lazy-rendered tabs, *ngIf, @defer, etc.\n  afterNextRender(() => {\n    if (getGrid()) return;\n\n    const host = elementRef.nativeElement as HTMLElement;\n    const observer = new MutationObserver(() => {\n      if (getGrid()) observer.disconnect();\n    });\n    observer.observe(host, { childList: true, subtree: true });\n\n    destroyRef.onDestroy(() => observer.disconnect());\n  });\n\n  return {\n    isReady: isReady.asReadonly(),\n\n    exportToCsv: (filename?: string, params?: Partial<ExportParams>) => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:export] ExportPlugin not found.\\n\\n` +\n            `  → Enable export on the grid:\\n` +\n            `    <tbw-grid [export]=\"true\" />`,\n        );\n        return;\n      }\n      plugin.exportCsv({ ...params, fileName: filename ?? params?.fileName ?? 'export.csv' });\n    },\n\n    exportToExcel: (filename?: string, params?: Partial<ExportParams>) => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:export] ExportPlugin not found.\\n\\n` +\n            `  → Enable export on the grid:\\n` +\n            `    <tbw-grid [export]=\"true\" />`,\n        );\n        return;\n      }\n      plugin.exportExcel({ ...params, fileName: filename ?? params?.fileName ?? 'export.xlsx' });\n    },\n\n    exportToJson: (filename?: string, params?: Partial<ExportParams>) => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:export] ExportPlugin not found.\\n\\n` +\n            `  → Enable export on the grid:\\n` +\n            `    <tbw-grid [export]=\"true\" />`,\n        );\n        return;\n      }\n      plugin.exportJson({ ...params, fileName: filename ?? params?.fileName ?? 'export.json' });\n    },\n\n    isExporting: () => {\n      return getPlugin()?.isExporting() ?? false;\n    },\n\n    getLastExport: () => {\n      return getPlugin()?.getLastExport() ?? null;\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-filtering.mjs

@@ -1,13 +1,155 @@
-import { inject, ElementRef, DestroyRef, signal, afterNextRender } from '@angular/core';
+import * as i0 from '@angular/core';
+import { inject, ElementRef, input, output, Directive, DestroyRef, signal, afterNextRender } from '@angular/core';
+import { registerFeatureClaim, claimEvent, unregisterFeatureClaim, unclaimEvent, registerFilterPanelTypeDefaultBridge } from '@toolbox-web/grid-angular';
+export { BaseFilterPanel } from '@toolbox-web/grid-angular';
 import '@toolbox-web/grid/features/filtering';
 
+/**
+ * `GridFilteringDirective` — attribute-selector directive that owns the
+ * `filtering` input and the `filterChange` output on `<tbw-grid>`.
+ *
+ * ## Why this exists
+ *
+ * Historically these bindings lived on the central `Grid` directive in
+ * `@toolbox-web/grid-angular`. That meant the typed surface for the
+ * filtering plugin shipped in the core bundle of every consumer, even those
+ * that never imported the filtering feature. Moving them here lets the
+ * surface tree-shake away with the rest of the feature when it is not
+ * imported, matching the philosophy of the React / Vue adapters and the
+ * web-component core (where unloaded plugins simply don't exist on the
+ * element).
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import { Component } from '@angular/core';
+ * import { Grid } from '@toolbox-web/grid-angular';
+ * import { GridFilteringDirective } from '@toolbox-web/grid-angular/features/filtering';
+ *
+ * @Component({
+ *   selector: 'app-grid',
+ *   imports: [Grid, GridFilteringDirective],
+ *   template: `
+ *     <tbw-grid [rows]="rows" [filtering]="true" (filterChange)="onFilter($event)" />
+ *   `,
+ * })
+ * export class AppGridComponent {}
+ * ```
+ *
+ * ## Backward compatibility (v1.x)
+ *
+ * The matching `filtering` input and `filterChange` output also still exist
+ * on `Grid` (marked `@deprecated`) so existing apps that bind them without
+ * importing `GridFilteringDirective` continue to work — those will be
+ * removed in v2.0.0. When both this directive and the deprecated bindings
+ * are present, the directive wins via the per-grid claims registry in
+ * `internal/feature-claims.ts`: `Grid` consults the registry and skips its
+ * own plugin creation + event wiring for any claimed feature.
+ *
+ * @category Directive
+ */
+/**
+ * Owns the `[filtering]` input and `(filterChange)` output on `<tbw-grid>`.
+ *
+ * Selector matches when *either* binding is present so users can pick the
+ * style that suits their template — both go through the same claim and the
+ * same wiring.
+ * @category Directive
+ */
+class GridFilteringDirective {
+    elementRef = inject((ElementRef));
+    /**
+     * Enable column filtering. Identical semantics to the deprecated input on
+     * `Grid` — this directive owns the binding when both are present.
+     *
+     * @example
+     * ```html
+     * <tbw-grid [filtering]="true" />
+     * <tbw-grid [filtering]="{ debounceMs: 200 }" />
+     * ```
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    filtering = input(...(ngDevMode ? [undefined, { debugName: "filtering" }] : /* istanbul ignore next */ []));
+    /**
+     * Emitted when filter values change.
+     *
+     * @example
+     * ```html
+     * <tbw-grid (filterChange)="onFilterChange($event)" />
+     * ```
+     */
+    filterChange = output();
+    // Listener kept so we can detach in `ngOnDestroy`.
+    listener;
+    constructor() {
+        const grid = this.elementRef.nativeElement;
+        // Tell `Grid` we own this feature's input. Reading `this.filtering()`
+        // inside the getter establishes a reactive dependency in `Grid`'s
+        // `createFeaturePlugins` effect — when our input changes, that effect
+        // re-runs and the plugin config is updated.
+        registerFeatureClaim(grid, 'filtering', () => this.filtering());
+        // Tell `Grid` we own the matching event so it doesn't double-emit on
+        // its own deprecated `filterChange` output.
+        claimEvent(grid, 'filter-change');
+    }
+    ngOnInit() {
+        const grid = this.elementRef.nativeElement;
+        this.listener = (e) => {
+            this.filterChange.emit(e.detail);
+        };
+        grid.addEventListener('filter-change', this.listener);
+    }
+    ngOnDestroy() {
+        const grid = this.elementRef.nativeElement;
+        if (this.listener) {
+            grid.removeEventListener('filter-change', this.listener);
+            this.listener = undefined;
+        }
+        // Drop the claims so that, if the directive is removed via *ngIf but
+        // the host `<tbw-grid>` survives, `Grid`'s deprecated bindings take
+        // back over without leaving stale ownership behind.
+        unregisterFeatureClaim(grid, 'filtering');
+        unclaimEvent(grid, 'filter-change');
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: GridFilteringDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "21.2.5", type: GridFilteringDirective, isStandalone: true, selector: "tbw-grid[filtering], tbw-grid[filterChange]", inputs: { filtering: { classPropertyName: "filtering", publicName: "filtering", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { filterChange: "filterChange" }, ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: GridFilteringDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: 'tbw-grid[filtering], tbw-grid[filterChange]',
+                    standalone: true,
+                }]
+        }], ctorParameters: () => [], propDecorators: { filtering: [{ type: i0.Input, args: [{ isSignal: true, alias: "filtering", required: false }] }], filterChange: [{ type: i0.Output, args: ["filterChange"] }] } });
+
 /**
  * Filtering feature for @toolbox-web/grid-angular
  *
- * Import this module to enable the `filtering` input on Grid directive.
- * Also exports `injectGridFiltering()` for programmatic filter control.
+ * Two ways to use:
  *
- * @example
+ * 1. **Recommended (tree-shakeable surface):** add `GridFilteringDirective`
+ *    to your component's `imports`. The directive owns the `[filtering]`
+ *    input and `(filterChange)` output, so the typed surface tree-shakes
+ *    away when the feature is not imported.
+ * 2. **Legacy (non-breaking, deprecated):** side-effect import the feature
+ *    entry; the matching `[filtering]` / `(filterChange)` bindings on the
+ *    central `Grid` directive will work as in v1.x. These bindings on `Grid`
+ *    are marked `@deprecated` and will be removed in v2.0.0.
+ *
+ * Either way `injectGridFiltering()` is available for programmatic control.
+ *
+ * @example Recommended (directive-owned binding)
+ * ```typescript
+ * import { Grid } from '@toolbox-web/grid-angular';
+ * import { GridFilteringDirective } from '@toolbox-web/grid-angular/features/filtering';
+ *
+ * @Component({
+ *   imports: [Grid, GridFilteringDirective],
+ *   template: `<tbw-grid [filtering]="true" (filterChange)="onChange($event)" />`,
+ * })
+ * ```
+ *
+ * @example Legacy (deprecated; works without importing the directive)
  * ```typescript
  * import '@toolbox-web/grid-angular/features/filtering';
  *
@@ -31,6 +173,18 @@ import '@toolbox-web/grid/features/filtering';
  *
  * @packageDocumentation
  */
+// Bridge any Angular component classes used as `filterPanelRenderer` (in
+// `gridConfig.typeDefaults` or via `provideGridTypeDefaults`) to the
+// `(container, params) => void` form required by FilteringPlugin. Without
+// this import, component-class filterPanelRenderers are silently dropped \u2014
+// the same precondition as the FilteringPlugin itself (TBW031).
+registerFilterPanelTypeDefaultBridge((rendererValue, adapter) => {
+    const componentClass = rendererValue;
+    const mount = adapter.mountComponentRenderer(componentClass, (params) => ({ params }));
+    return (container, params) => {
+        container.appendChild(mount(params).hostElement);
+    };
+});
 /**
  * Angular inject function for programmatic filter control.
  *
@@ -181,5 +335,5 @@ function injectGridFiltering(selector = 'tbw-grid') {
  * Generated bundle index. Do not edit.
  */
 
-export { injectGridFiltering };
+export { GridFilteringDirective, injectGridFiltering };
 //# sourceMappingURL=toolbox-web-grid-angular-features-filtering.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"toolbox-web-grid-angular-features-filtering.mjs","sources":["../../../../libs/grid-angular/features/filtering/src/index.ts","../../../../libs/grid-angular/features/filtering/src/toolbox-web-grid-angular-features-filtering.ts"],"sourcesContent":["/**\n * Filtering feature for @toolbox-web/grid-angular\n *\n * Import this module to enable the `filtering` input on Grid directive.\n * Also exports `injectGridFiltering()` for programmatic filter control.\n *\n * @example\n * ```typescript\n * import '@toolbox-web/grid-angular/features/filtering';\n *\n * <tbw-grid [filtering]=\"true\" />\n * <tbw-grid [filtering]=\"{ debounceMs: 200 }\" />\n * ```\n *\n * @example Using injectGridFiltering\n * ```typescript\n * import { injectGridFiltering } from '@toolbox-web/grid-angular/features/filtering';\n *\n * @Component({...})\n * export class MyComponent {\n *   private filtering = injectGridFiltering();\n *\n *   filterByStatus(status: string) {\n *     this.filtering.setFilter('status', { operator: 'equals', value: status });\n *   }\n * }\n * ```\n *\n * @packageDocumentation\n */\n\nimport { afterNextRender, DestroyRef, ElementRef, inject, signal, type Signal } from '@angular/core';\nimport type { DataGridElement } from '@toolbox-web/grid';\nimport '@toolbox-web/grid/features/filtering';\nimport { FilteringPlugin, type BlankMode, type FilterModel } from '@toolbox-web/grid/plugins/filtering';\nexport type { _Augmentation as _FilteringAugmentation } from '@toolbox-web/grid/features/filtering';\n\n/**\n * Filtering methods returned from injectGridFiltering.\n *\n * Uses lazy discovery - the grid is found on first method call, not during initialization.\n */\nexport interface FilteringMethods {\n  /**\n   * Set a filter on a specific field.\n   * @param field - The field name to filter\n   * @param filter - Filter configuration, or null to remove\n   * @param options - `{ silent: true }` applies the filter without emitting `filter-change`\n   */\n  setFilter: (field: string, filter: Omit<FilterModel, 'field'> | null, options?: { silent?: boolean }) => void;\n\n  /**\n   * Get the current filter for a field.\n   */\n  getFilter: (field: string) => FilterModel | undefined;\n\n  /**\n   * Get all active filters.\n   */\n  getFilters: () => FilterModel[];\n\n  /**\n   * Set all filters at once (replaces existing).\n   * @param options - `{ silent: true }` applies filters without emitting `filter-change`\n   */\n  setFilterModel: (filters: FilterModel[], options?: { silent?: boolean }) => void;\n\n  /**\n   * Clear all active filters.\n   * @param options - `{ silent: true }` clears filters without emitting `filter-change`\n   */\n  clearAllFilters: (options?: { silent?: boolean }) => void;\n\n  /**\n   * Clear filter for a specific field.\n   * @param options - `{ silent: true }` clears filter without emitting `filter-change`\n   */\n  clearFieldFilter: (field: string, options?: { silent?: boolean }) => void;\n\n  /**\n   * Check if a field has an active filter.\n   */\n  isFieldFiltered: (field: string) => boolean;\n\n  /**\n   * Get the count of rows after filtering.\n   */\n  getFilteredRowCount: () => number;\n\n  /**\n   * Get unique values for a field (for building filter dropdowns).\n   */\n  getUniqueValues: (field: string) => unknown[];\n\n  /**\n   * Get set filters whose values no longer match any rows in the current data.\n   */\n  getStaleFilters: () => FilterModel[];\n\n  /**\n   * Get the current blank mode for a field.\n   */\n  getBlankMode: (field: string) => BlankMode;\n\n  /**\n   * Toggle blank filter mode for a field.\n   */\n  toggleBlankFilter: (field: string, mode: BlankMode) => void;\n\n  /**\n   * Signal indicating if grid is ready.\n   */\n  isReady: Signal<boolean>;\n}\n\n/**\n * Angular inject function for programmatic filter 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 } from '@angular/core';\n * import { Grid } from '@toolbox-web/grid-angular';\n * import '@toolbox-web/grid-angular/features/filtering';\n * import { injectGridFiltering } from '@toolbox-web/grid-angular/features/filtering';\n *\n * @Component({\n *   selector: 'app-my-grid',\n *   imports: [Grid],\n *   template: `\n *     <input (input)=\"applyFilter($event)\" placeholder=\"Filter by name...\" />\n *     <span>{{ filtering.getFilteredRowCount() }} results</span>\n *     <button (click)=\"filtering.clearAllFilters()\">Clear</button>\n *     <tbw-grid [rows]=\"rows\" [filtering]=\"true\"></tbw-grid>\n *   `\n * })\n * export class MyGridComponent {\n *   filtering = injectGridFiltering();\n *\n *   applyFilter(event: Event) {\n *     const value = (event.target as HTMLInputElement).value;\n *     this.filtering.setFilter('name', value ? { operator: 'contains', value } : null);\n *   }\n * }\n * ```\n *\n * @param selector - Optional CSS selector to target a specific grid element.\n *   Defaults to `'tbw-grid'` (first grid in the component). Use when the\n *   component contains multiple grids, e.g. `'tbw-grid.primary'` or `'#my-grid'`.\n */\nexport function injectGridFiltering(selector = 'tbw-grid'): FilteringMethods {\n  const elementRef = inject(ElementRef);\n  const destroyRef = inject(DestroyRef);\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(selector) as DataGridElement | null;\n    if (grid) {\n      cachedGrid = grid;\n      if (!readyPromiseStarted) {\n        readyPromiseStarted = true;\n        grid.ready?.().then(() => {\n          // If the plugin is already attached, signal readiness immediately.\n          // Otherwise, Angular's Grid directive may not have applied gridConfig\n          // yet (it uses effect + queueMicrotask). Defer to let pending\n          // microtasks flush before signaling readiness.\n          if (grid.getPluginByName('filtering')) {\n            isReady.set(true);\n          } else {\n            setTimeout(() => isReady.set(true), 0);\n          }\n        });\n      }\n    }\n    return grid;\n  };\n\n  const getPlugin = (): FilteringPlugin | undefined => {\n    return getGrid()?.getPluginByName('filtering') as FilteringPlugin | undefined;\n  };\n\n  // Eagerly discover the grid after the first render so isReady updates\n  // without requiring a programmatic method call. Falls back to a\n  // MutationObserver for lazy-rendered tabs, *ngIf, @defer, etc.\n  afterNextRender(() => {\n    if (getGrid()) return;\n\n    const host = elementRef.nativeElement as HTMLElement;\n    const observer = new MutationObserver(() => {\n      if (getGrid()) observer.disconnect();\n    });\n    observer.observe(host, { childList: true, subtree: true });\n\n    destroyRef.onDestroy(() => observer.disconnect());\n  });\n\n  return {\n    isReady: isReady.asReadonly(),\n\n    setFilter: (field: string, filter: Omit<FilterModel, 'field'> | null, options?: { silent?: boolean }) => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:filtering] FilteringPlugin not found.\\n\\n` +\n            `  → Enable filtering on the grid:\\n` +\n            `    <tbw-grid [filtering]=\"true\" />`,\n        );\n        return;\n      }\n      plugin.setFilter(field, filter, options);\n    },\n\n    getFilter: (field: string) => getPlugin()?.getFilter(field),\n\n    getFilters: () => getPlugin()?.getFilters() ?? [],\n\n    setFilterModel: (filters: FilterModel[], options?: { silent?: boolean }) => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:filtering] FilteringPlugin not found.\\n\\n` +\n            `  → Enable filtering on the grid:\\n` +\n            `    <tbw-grid [filtering]=\"true\" />`,\n        );\n        return;\n      }\n      plugin.setFilterModel(filters, options);\n    },\n\n    clearAllFilters: (options?: { silent?: boolean }) => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:filtering] FilteringPlugin not found.\\n\\n` +\n            `  → Enable filtering on the grid:\\n` +\n            `    <tbw-grid [filtering]=\"true\" />`,\n        );\n        return;\n      }\n      plugin.clearAllFilters(options);\n    },\n\n    clearFieldFilter: (field: string, options?: { silent?: boolean }) => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:filtering] FilteringPlugin not found.\\n\\n` +\n            `  → Enable filtering on the grid:\\n` +\n            `    <tbw-grid [filtering]=\"true\" />`,\n        );\n        return;\n      }\n      plugin.clearFieldFilter(field, options);\n    },\n\n    isFieldFiltered: (field: string) => getPlugin()?.isFieldFiltered(field) ?? false,\n\n    getFilteredRowCount: () => getPlugin()?.getFilteredRowCount() ?? 0,\n\n    getUniqueValues: (field: string) => getPlugin()?.getUniqueValues(field) ?? [],\n\n    getStaleFilters: () => getPlugin()?.getStaleFilters() ?? [],\n\n    getBlankMode: (field: string) => getPlugin()?.getBlankMode(field) ?? 'all',\n\n    toggleBlankFilter: (field: string, mode: BlankMode) => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:filtering] FilteringPlugin not found.\\n\\n` +\n            `  → Enable filtering on the grid:\\n` +\n            `    <tbw-grid [filtering]=\"true\" />`,\n        );\n        return;\n      }\n      plugin.toggleBlankFilter(field, mode);\n    },\n  };\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"toolbox-web-grid-angular-features-filtering.mjs","sources":["../../../../libs/grid-angular/features/filtering/src/grid-filtering.directive.ts","../../../../libs/grid-angular/features/filtering/src/index.ts","../../../../libs/grid-angular/features/filtering/src/toolbox-web-grid-angular-features-filtering.ts"],"sourcesContent":["/**\n * `GridFilteringDirective` — attribute-selector directive that owns the\n * `filtering` input and the `filterChange` output on `<tbw-grid>`.\n *\n * ## Why this exists\n *\n * Historically these bindings lived on the central `Grid` directive in\n * `@toolbox-web/grid-angular`. That meant the typed surface for the\n * filtering plugin shipped in the core bundle of every consumer, even those\n * that never imported the filtering feature. Moving them here lets the\n * surface tree-shake away with the rest of the feature when it is not\n * imported, matching the philosophy of the React / Vue adapters and the\n * web-component core (where unloaded plugins simply don't exist on the\n * element).\n *\n * ## Usage\n *\n * ```typescript\n * import { Component } from '@angular/core';\n * import { Grid } from '@toolbox-web/grid-angular';\n * import { GridFilteringDirective } from '@toolbox-web/grid-angular/features/filtering';\n *\n * @Component({\n *   selector: 'app-grid',\n *   imports: [Grid, GridFilteringDirective],\n *   template: `\n *     <tbw-grid [rows]=\"rows\" [filtering]=\"true\" (filterChange)=\"onFilter($event)\" />\n *   `,\n * })\n * export class AppGridComponent {}\n * ```\n *\n * ## Backward compatibility (v1.x)\n *\n * The matching `filtering` input and `filterChange` output also still exist\n * on `Grid` (marked `@deprecated`) so existing apps that bind them without\n * importing `GridFilteringDirective` continue to work — those will be\n * removed in v2.0.0. When both this directive and the deprecated bindings\n * are present, the directive wins via the per-grid claims registry in\n * `internal/feature-claims.ts`: `Grid` consults the registry and skips its\n * own plugin creation + event wiring for any claimed feature.\n *\n * @category Directive\n */\nimport { Directive, ElementRef, inject, input, OnDestroy, OnInit, output } from '@angular/core';\nimport type { DataGridElement } from '@toolbox-web/grid';\nimport { claimEvent, registerFeatureClaim, unclaimEvent, unregisterFeatureClaim } from '@toolbox-web/grid-angular';\nimport type { FilterChangeDetail, FilterConfig } from '@toolbox-web/grid/plugins/filtering';\n\n/**\n * Owns the `[filtering]` input and `(filterChange)` output on `<tbw-grid>`.\n *\n * Selector matches when *either* binding is present so users can pick the\n * style that suits their template — both go through the same claim and the\n * same wiring.\n * @category Directive\n */\n@Directive({\n  selector: 'tbw-grid[filtering], tbw-grid[filterChange]',\n  standalone: true,\n})\nexport class GridFilteringDirective implements OnInit, OnDestroy {\n  private readonly elementRef = inject(ElementRef<DataGridElement>);\n\n  /**\n   * Enable column filtering. Identical semantics to the deprecated input on\n   * `Grid` — this directive owns the binding when both are present.\n   *\n   * @example\n   * ```html\n   * <tbw-grid [filtering]=\"true\" />\n   * <tbw-grid [filtering]=\"{ debounceMs: 200 }\" />\n   * ```\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  readonly filtering = input<boolean | FilterConfig<any>>();\n\n  /**\n   * Emitted when filter values change.\n   *\n   * @example\n   * ```html\n   * <tbw-grid (filterChange)=\"onFilterChange($event)\" />\n   * ```\n   */\n  readonly filterChange = output<FilterChangeDetail>();\n\n  // Listener kept so we can detach in `ngOnDestroy`.\n  private listener?: (e: Event) => void;\n\n  constructor() {\n    const grid = this.elementRef.nativeElement;\n    // Tell `Grid` we own this feature's input. Reading `this.filtering()`\n    // inside the getter establishes a reactive dependency in `Grid`'s\n    // `createFeaturePlugins` effect — when our input changes, that effect\n    // re-runs and the plugin config is updated.\n    registerFeatureClaim(grid, 'filtering', () => this.filtering());\n    // Tell `Grid` we own the matching event so it doesn't double-emit on\n    // its own deprecated `filterChange` output.\n    claimEvent(grid, 'filter-change');\n  }\n\n  ngOnInit(): void {\n    const grid = this.elementRef.nativeElement;\n    this.listener = (e: Event) => {\n      this.filterChange.emit((e as CustomEvent<FilterChangeDetail>).detail);\n    };\n    grid.addEventListener('filter-change', this.listener);\n  }\n\n  ngOnDestroy(): void {\n    const grid = this.elementRef.nativeElement;\n    if (this.listener) {\n      grid.removeEventListener('filter-change', this.listener);\n      this.listener = undefined;\n    }\n    // Drop the claims so that, if the directive is removed via *ngIf but\n    // the host `<tbw-grid>` survives, `Grid`'s deprecated bindings take\n    // back over without leaving stale ownership behind.\n    unregisterFeatureClaim(grid, 'filtering');\n    unclaimEvent(grid, 'filter-change');\n  }\n}\n","/**\n * Filtering feature for @toolbox-web/grid-angular\n *\n * Two ways to use:\n *\n * 1. **Recommended (tree-shakeable surface):** add `GridFilteringDirective`\n *    to your component's `imports`. The directive owns the `[filtering]`\n *    input and `(filterChange)` output, so the typed surface tree-shakes\n *    away when the feature is not imported.\n * 2. **Legacy (non-breaking, deprecated):** side-effect import the feature\n *    entry; the matching `[filtering]` / `(filterChange)` bindings on the\n *    central `Grid` directive will work as in v1.x. These bindings on `Grid`\n *    are marked `@deprecated` and will be removed in v2.0.0.\n *\n * Either way `injectGridFiltering()` is available for programmatic control.\n *\n * @example Recommended (directive-owned binding)\n * ```typescript\n * import { Grid } from '@toolbox-web/grid-angular';\n * import { GridFilteringDirective } from '@toolbox-web/grid-angular/features/filtering';\n *\n * @Component({\n *   imports: [Grid, GridFilteringDirective],\n *   template: `<tbw-grid [filtering]=\"true\" (filterChange)=\"onChange($event)\" />`,\n * })\n * ```\n *\n * @example Legacy (deprecated; works without importing the directive)\n * ```typescript\n * import '@toolbox-web/grid-angular/features/filtering';\n *\n * <tbw-grid [filtering]=\"true\" />\n * <tbw-grid [filtering]=\"{ debounceMs: 200 }\" />\n * ```\n *\n * @example Using injectGridFiltering\n * ```typescript\n * import { injectGridFiltering } from '@toolbox-web/grid-angular/features/filtering';\n *\n * @Component({...})\n * export class MyComponent {\n *   private filtering = injectGridFiltering();\n *\n *   filterByStatus(status: string) {\n *     this.filtering.setFilter('status', { operator: 'equals', value: status });\n *   }\n * }\n * ```\n *\n * @packageDocumentation\n */\n\nimport { afterNextRender, DestroyRef, ElementRef, inject, signal, type Signal, type Type } from '@angular/core';\nimport type { DataGridElement } from '@toolbox-web/grid';\nimport { registerFilterPanelTypeDefaultBridge, type GridAdapter } from '@toolbox-web/grid-angular';\nimport '@toolbox-web/grid/features/filtering';\nimport {\n  FilteringPlugin,\n  type BlankMode,\n  type FilterModel,\n  type FilterPanelParams,\n} from '@toolbox-web/grid/plugins/filtering';\nexport type { _Augmentation as _FilteringAugmentation } from '@toolbox-web/grid/features/filtering';\n\n// Attribute-selector directive that owns the `[filtering]` input and\n// `(filterChange)` output on `<tbw-grid>`. Add to your component's `imports`\n// alongside `Grid` to opt into the feature directly via the binding. The\n// matching deprecated bindings on `Grid` remain as a v1.x compatibility\n// shim and will be removed in v2.0.0.\nexport { GridFilteringDirective } from './grid-filtering.directive';\n\n// ---------------------------------------------------------------------------\n// Re-exports from `@toolbox-web/grid-angular` (main entry).\n//\n// `BaseFilterPanel` is filtering-specific (implements `FilterPanel` from the\n// filtering plugin). It still physically lives in the main entry today, but\n// is re-exported here so consumers can import it from the feature entry that\n// owns the runtime behaviour. The same symbol is `@deprecated` on the main\n// entry; in v2.0.0 the source will physically move into this secondary entry\n// and the deprecated re-export on the main entry will be removed.\n// ---------------------------------------------------------------------------\nexport { BaseFilterPanel } from '@toolbox-web/grid-angular';\n\n// Bridge any Angular component classes used as `filterPanelRenderer` (in\n// `gridConfig.typeDefaults` or via `provideGridTypeDefaults`) to the\n// `(container, params) => void` form required by FilteringPlugin. Without\n// this import, component-class filterPanelRenderers are silently dropped \\u2014\n// the same precondition as the FilteringPlugin itself (TBW031).\nregisterFilterPanelTypeDefaultBridge((rendererValue: unknown, adapter: GridAdapter) => {\n  const componentClass = rendererValue as Type<unknown>;\n  const mount = adapter.mountComponentRenderer<FilterPanelParams>(componentClass, (params) => ({ params }));\n  return (container: HTMLElement, params: FilterPanelParams) => {\n    container.appendChild(mount(params).hostElement);\n  };\n});\n\n/**\n * Filtering methods returned from injectGridFiltering.\n *\n * Uses lazy discovery - the grid is found on first method call, not during initialization.\n */\nexport interface FilteringMethods {\n  /**\n   * Set a filter on a specific field.\n   * @param field - The field name to filter\n   * @param filter - Filter configuration, or null to remove\n   * @param options - `{ silent: true }` applies the filter without emitting `filter-change`\n   */\n  setFilter: (field: string, filter: Omit<FilterModel, 'field'> | null, options?: { silent?: boolean }) => void;\n\n  /**\n   * Get the current filter for a field.\n   */\n  getFilter: (field: string) => FilterModel | undefined;\n\n  /**\n   * Get all active filters.\n   */\n  getFilters: () => FilterModel[];\n\n  /**\n   * Set all filters at once (replaces existing).\n   * @param options - `{ silent: true }` applies filters without emitting `filter-change`\n   */\n  setFilterModel: (filters: FilterModel[], options?: { silent?: boolean }) => void;\n\n  /**\n   * Clear all active filters.\n   * @param options - `{ silent: true }` clears filters without emitting `filter-change`\n   */\n  clearAllFilters: (options?: { silent?: boolean }) => void;\n\n  /**\n   * Clear filter for a specific field.\n   * @param options - `{ silent: true }` clears filter without emitting `filter-change`\n   */\n  clearFieldFilter: (field: string, options?: { silent?: boolean }) => void;\n\n  /**\n   * Check if a field has an active filter.\n   */\n  isFieldFiltered: (field: string) => boolean;\n\n  /**\n   * Get the count of rows after filtering.\n   */\n  getFilteredRowCount: () => number;\n\n  /**\n   * Get unique values for a field (for building filter dropdowns).\n   */\n  getUniqueValues: (field: string) => unknown[];\n\n  /**\n   * Get set filters whose values no longer match any rows in the current data.\n   */\n  getStaleFilters: () => FilterModel[];\n\n  /**\n   * Get the current blank mode for a field.\n   */\n  getBlankMode: (field: string) => BlankMode;\n\n  /**\n   * Toggle blank filter mode for a field.\n   */\n  toggleBlankFilter: (field: string, mode: BlankMode) => void;\n\n  /**\n   * Signal indicating if grid is ready.\n   */\n  isReady: Signal<boolean>;\n}\n\n/**\n * Angular inject function for programmatic filter 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 } from '@angular/core';\n * import { Grid } from '@toolbox-web/grid-angular';\n * import '@toolbox-web/grid-angular/features/filtering';\n * import { injectGridFiltering } from '@toolbox-web/grid-angular/features/filtering';\n *\n * @Component({\n *   selector: 'app-my-grid',\n *   imports: [Grid],\n *   template: `\n *     <input (input)=\"applyFilter($event)\" placeholder=\"Filter by name...\" />\n *     <span>{{ filtering.getFilteredRowCount() }} results</span>\n *     <button (click)=\"filtering.clearAllFilters()\">Clear</button>\n *     <tbw-grid [rows]=\"rows\" [filtering]=\"true\"></tbw-grid>\n *   `\n * })\n * export class MyGridComponent {\n *   filtering = injectGridFiltering();\n *\n *   applyFilter(event: Event) {\n *     const value = (event.target as HTMLInputElement).value;\n *     this.filtering.setFilter('name', value ? { operator: 'contains', value } : null);\n *   }\n * }\n * ```\n *\n * @param selector - Optional CSS selector to target a specific grid element.\n *   Defaults to `'tbw-grid'` (first grid in the component). Use when the\n *   component contains multiple grids, e.g. `'tbw-grid.primary'` or `'#my-grid'`.\n */\nexport function injectGridFiltering(selector = 'tbw-grid'): FilteringMethods {\n  const elementRef = inject(ElementRef);\n  const destroyRef = inject(DestroyRef);\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(selector) as DataGridElement | null;\n    if (grid) {\n      cachedGrid = grid;\n      if (!readyPromiseStarted) {\n        readyPromiseStarted = true;\n        grid.ready?.().then(() => {\n          // If the plugin is already attached, signal readiness immediately.\n          // Otherwise, Angular's Grid directive may not have applied gridConfig\n          // yet (it uses effect + queueMicrotask). Defer to let pending\n          // microtasks flush before signaling readiness.\n          if (grid.getPluginByName('filtering')) {\n            isReady.set(true);\n          } else {\n            setTimeout(() => isReady.set(true), 0);\n          }\n        });\n      }\n    }\n    return grid;\n  };\n\n  const getPlugin = (): FilteringPlugin | undefined => {\n    return getGrid()?.getPluginByName('filtering') as FilteringPlugin | undefined;\n  };\n\n  // Eagerly discover the grid after the first render so isReady updates\n  // without requiring a programmatic method call. Falls back to a\n  // MutationObserver for lazy-rendered tabs, *ngIf, @defer, etc.\n  afterNextRender(() => {\n    if (getGrid()) return;\n\n    const host = elementRef.nativeElement as HTMLElement;\n    const observer = new MutationObserver(() => {\n      if (getGrid()) observer.disconnect();\n    });\n    observer.observe(host, { childList: true, subtree: true });\n\n    destroyRef.onDestroy(() => observer.disconnect());\n  });\n\n  return {\n    isReady: isReady.asReadonly(),\n\n    setFilter: (field: string, filter: Omit<FilterModel, 'field'> | null, options?: { silent?: boolean }) => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:filtering] FilteringPlugin not found.\\n\\n` +\n            `  → Enable filtering on the grid:\\n` +\n            `    <tbw-grid [filtering]=\"true\" />`,\n        );\n        return;\n      }\n      plugin.setFilter(field, filter, options);\n    },\n\n    getFilter: (field: string) => getPlugin()?.getFilter(field),\n\n    getFilters: () => getPlugin()?.getFilters() ?? [],\n\n    setFilterModel: (filters: FilterModel[], options?: { silent?: boolean }) => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:filtering] FilteringPlugin not found.\\n\\n` +\n            `  → Enable filtering on the grid:\\n` +\n            `    <tbw-grid [filtering]=\"true\" />`,\n        );\n        return;\n      }\n      plugin.setFilterModel(filters, options);\n    },\n\n    clearAllFilters: (options?: { silent?: boolean }) => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:filtering] FilteringPlugin not found.\\n\\n` +\n            `  → Enable filtering on the grid:\\n` +\n            `    <tbw-grid [filtering]=\"true\" />`,\n        );\n        return;\n      }\n      plugin.clearAllFilters(options);\n    },\n\n    clearFieldFilter: (field: string, options?: { silent?: boolean }) => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:filtering] FilteringPlugin not found.\\n\\n` +\n            `  → Enable filtering on the grid:\\n` +\n            `    <tbw-grid [filtering]=\"true\" />`,\n        );\n        return;\n      }\n      plugin.clearFieldFilter(field, options);\n    },\n\n    isFieldFiltered: (field: string) => getPlugin()?.isFieldFiltered(field) ?? false,\n\n    getFilteredRowCount: () => getPlugin()?.getFilteredRowCount() ?? 0,\n\n    getUniqueValues: (field: string) => getPlugin()?.getUniqueValues(field) ?? [],\n\n    getStaleFilters: () => getPlugin()?.getStaleFilters() ?? [],\n\n    getBlankMode: (field: string) => getPlugin()?.getBlankMode(field) ?? 'all',\n\n    toggleBlankFilter: (field: string, mode: BlankMode) => {\n      const plugin = getPlugin();\n      if (!plugin) {\n        console.warn(\n          `[tbw-grid:filtering] FilteringPlugin not found.\\n\\n` +\n            `  → Enable filtering on the grid:\\n` +\n            `    <tbw-grid [filtering]=\"true\" />`,\n        );\n        return;\n      }\n      plugin.toggleBlankFilter(field, mode);\n    },\n  };\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}