@toolbox-web/grid-angular 1.4.0 → 1.5.0

package/fesm2022/toolbox-web-grid-angular-features-master-detail.mjs

@@ -82,6 +82,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImpor
 // `adapter.createDetailRenderer(grid)` and `adapter.parseDetailElement(el)`
 // delegate to. Without this import, both methods return undefined.
 registerDetailRendererBridge((gridElement, adapter) => {
+    // Type inferred from `getDetailTemplate` (same package instance as `adapter`),
+    // not from a local `import type { TemplateRef } from '@angular/core'` — the
+    // latter resolves through Bun's `.bun/` cache during ng-packagr build and
+    // produces a brand-incompatible TemplateRef vs the built adapter `.d.ts`.
     const template = getDetailTemplate(gridElement);
     if (!template)
         return undefined;
@@ -103,18 +107,20 @@ registerTemplateBridge(({ grid }) => {
     const detailElement = grid.querySelector('tbw-grid-detail');
     if (!detailElement)
         return;
-    // The plugin must already have been added to the grid (via [masterDetail] input
-    // or manual gridConfig.plugins). Find it by name to avoid importing the class.
+    // The plugin must already have been attached (via [masterDetail] input,
+    // gridConfig.features.masterDetail, or gridConfig.plugins). Use the runtime
+    // lookup so we don't miss plugins instantiated from `gridConfig.features`,
+    // which never appear in `gridConfig.plugins`.
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const existingPlugin = grid.gridConfig?.plugins?.find((p) => p.name === 'masterDetail');
+    const existingPlugin = grid.getPluginByName?.('masterDetail');
     if (!existingPlugin) {
         // eslint-disable-next-line no-console
         console.warn('[tbw-grid-angular] <tbw-grid-detail> found but MasterDetailPlugin is not configured.\n' +
-            'Add the [masterDetail] input or include MasterDetailPlugin in gridConfig.plugins:\n\n' +
+            'Add the [masterDetail] input, set gridConfig.features.masterDetail, or include\n' +
+            'MasterDetailPlugin in gridConfig.plugins:\n\n' +
             '  <tbw-grid [masterDetail]="{ showExpandColumn: true }">...</tbw-grid>\n\n' +
             'or:\n\n' +
-            '  import { MasterDetailPlugin } from "@toolbox-web/grid/plugins/master-detail";\n' +
-            '  gridConfig = { plugins: [new MasterDetailPlugin({ ... })] };');
+            '  gridConfig = { features: { masterDetail: { showExpandColumn: true } } };');
         return;
     }
     existingPlugin.refreshDetailRenderer?.();

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

@@ -1 +1 @@
-{"version":3,"file":"toolbox-web-grid-angular-features-master-detail.mjs","sources":["../../../../libs/grid-angular/features/master-detail/src/grid-master-detail.directive.ts","../../../../libs/grid-angular/features/master-detail/src/index.ts","../../../../libs/grid-angular/features/master-detail/src/toolbox-web-grid-angular-features-master-detail.ts"],"sourcesContent":["/**\n * `GridMasterDetailDirective` — owns `[masterDetail]` and `(detailExpand)`\n * on `<tbw-grid>`. See `GridFilteringDirective` for the full rationale.\n *\n * Note: this directive is independent of the higher-level\n * `<tbw-grid-detail>` template element + `GridDetailView` wrapper, which\n * uses a different bridging mechanism (template registration). Apps using\n * the template form do not need this directive.\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 { DetailExpandDetail, MasterDetailConfig } from '@toolbox-web/grid/plugins/master-detail';\n\n/**\n * Owns the binding(s) `[masterDetail], [detailExpand]` 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[masterDetail], tbw-grid[detailExpand]',\n  standalone: true,\n})\nexport class GridMasterDetailDirective implements OnInit, OnDestroy {\n  private readonly elementRef = inject(ElementRef<DataGridElement>);\n\n  readonly masterDetail = input<MasterDetailConfig>();\n  readonly detailExpand = output<DetailExpandDetail>();\n\n  private listener?: (e: Event) => void;\n\n  constructor() {\n    const grid = this.elementRef.nativeElement;\n    registerFeatureClaim(grid, 'masterDetail', () => this.masterDetail());\n    claimEvent(grid, 'detail-expand');\n  }\n\n  ngOnInit(): void {\n    const grid = this.elementRef.nativeElement;\n    this.listener = (e: Event): void => this.detailExpand.emit((e as CustomEvent<DetailExpandDetail>).detail);\n    grid.addEventListener('detail-expand', this.listener);\n  }\n\n  ngOnDestroy(): void {\n    const grid = this.elementRef.nativeElement;\n    if (this.listener) {\n      grid.removeEventListener('detail-expand', this.listener);\n      this.listener = undefined;\n    }\n    unregisterFeatureClaim(grid, 'masterDetail');\n    unclaimEvent(grid, 'detail-expand');\n  }\n}\n","/**\n * Master-detail feature for @toolbox-web/grid-angular\n *\n * Import this module to enable the `[masterDetail]` input on the `Grid`\n * directive AND to wire `<tbw-grid-detail>` Angular templates into the\n * MasterDetailPlugin's `detailRenderer`.\n *\n * @example\n * ```typescript\n * // In your bootstrap (e.g. main.ts or app.component.ts):\n * import '@toolbox-web/grid-angular/features/master-detail';\n * ```\n *\n * ```html\n * <tbw-grid [masterDetail]=\"{ showExpandColumn: true }\">\n *   <tbw-grid-detail>\n *     <ng-template let-row>...</ng-template>\n *   </tbw-grid-detail>\n * </tbw-grid>\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { TemplateRef } from '@angular/core';\nimport {\n  getDetailTemplate,\n  registerDetailRendererBridge,\n  registerTemplateBridge,\n  type GridAdapter,\n  type GridDetailContext,\n} from '@toolbox-web/grid-angular';\nimport '@toolbox-web/grid/features/master-detail';\nexport { GridMasterDetailDirective } from './grid-master-detail.directive';\nexport type { _Augmentation as _MasterDetailAugmentation } from '@toolbox-web/grid/features/master-detail';\n\n// ---------------------------------------------------------------------------\n// Re-exports from `@toolbox-web/grid-angular` (main entry).\n//\n// `GridDetailView` (and its `getDetailTemplate` helper / `GridDetailContext`\n// type) still physically live in the main entry today but are master-detail\n// specific. They are re-exported here so consumers can import them from the\n// feature entry that owns the runtime behaviour. The same symbols are\n// `@deprecated` on the main entry; in v2.0.0 the source will physically move\n// into this secondary entry and the deprecated re-exports on the main entry\n// will be removed.\n// ---------------------------------------------------------------------------\nexport { getDetailTemplate, GridDetailView } from '@toolbox-web/grid-angular';\nexport type { GridDetailContext } from '@toolbox-web/grid-angular';\n\n/**\n * Subset of `MasterDetailPlugin` we touch from the bridge. Avoids importing\n * the plugin class itself (would defeat tree-shaking and re-introduce the\n * coupling we just removed from the core directive).\n */\ninterface MasterDetailPluginLike {\n  refreshDetailRenderer?: () => void;\n}\n\n// Install the row renderer bridge on the adapter. This is what\n// `adapter.createDetailRenderer(grid)` and `adapter.parseDetailElement(el)`\n// delegate to. Without this import, both methods return undefined.\nregisterDetailRendererBridge(<TRow = unknown>(gridElement: HTMLElement, adapter: GridAdapter) => {\n  const template = getDetailTemplate(gridElement) as TemplateRef<GridDetailContext<TRow>> | undefined;\n  if (!template) return undefined;\n\n  return (row: TRow) => {\n    const context: GridDetailContext<TRow> = { $implicit: row, row };\n    const viewRef = adapter.createTrackedEmbeddedView(template, context);\n    const container = document.createElement('div');\n    viewRef.rootNodes.forEach((node: Node) => container.appendChild(node));\n    return container;\n  };\n});\n\n// Wire <tbw-grid-detail> Angular templates into the MasterDetailPlugin once\n// content templates are registered. The plugin's `parseLightDomDetail()`\n// already calls back into the adapter via `grid.__frameworkAdapter.parseDetailElement`\n// (which the `Grid` directive set in `ngOnInit`), so all we need to do here\n// is trigger a refresh once Angular's content templates are available.\nregisterTemplateBridge(({ grid }) => {\n  // Only act when the user actually placed a <tbw-grid-detail> in light DOM.\n  const detailElement = grid.querySelector('tbw-grid-detail');\n  if (!detailElement) return;\n\n  // The plugin must already have been added to the grid (via [masterDetail] input\n  // or manual gridConfig.plugins). Find it by name to avoid importing the class.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const existingPlugin = (grid as any).gridConfig?.plugins?.find(\n    (p: { name?: string }) => p.name === 'masterDetail',\n  ) as MasterDetailPluginLike | undefined;\n\n  if (!existingPlugin) {\n    // eslint-disable-next-line no-console\n    console.warn(\n      '[tbw-grid-angular] <tbw-grid-detail> found but MasterDetailPlugin is not configured.\\n' +\n        'Add the [masterDetail] input or include MasterDetailPlugin in gridConfig.plugins:\\n\\n' +\n        '  <tbw-grid [masterDetail]=\"{ showExpandColumn: true }\">...</tbw-grid>\\n\\n' +\n        'or:\\n\\n' +\n        '  import { MasterDetailPlugin } from \"@toolbox-web/grid/plugins/master-detail\";\\n' +\n        '  gridConfig = { plugins: [new MasterDetailPlugin({ ... })] };',\n    );\n    return;\n  }\n\n  existingPlugin.refreshDetailRenderer?.();\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-master-detail.mjs","sources":["../../../../libs/grid-angular/features/master-detail/src/grid-master-detail.directive.ts","../../../../libs/grid-angular/features/master-detail/src/index.ts","../../../../libs/grid-angular/features/master-detail/src/toolbox-web-grid-angular-features-master-detail.ts"],"sourcesContent":["/**\n * `GridMasterDetailDirective` — owns `[masterDetail]` and `(detailExpand)`\n * on `<tbw-grid>`. See `GridFilteringDirective` for the full rationale.\n *\n * Note: this directive is independent of the higher-level\n * `<tbw-grid-detail>` template element + `GridDetailView` wrapper, which\n * uses a different bridging mechanism (template registration). Apps using\n * the template form do not need this directive.\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 { DetailExpandDetail, MasterDetailConfig } from '@toolbox-web/grid/plugins/master-detail';\n\n/**\n * Owns the binding(s) `[masterDetail], [detailExpand]` 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[masterDetail], tbw-grid[detailExpand]',\n  standalone: true,\n})\nexport class GridMasterDetailDirective implements OnInit, OnDestroy {\n  private readonly elementRef = inject(ElementRef<DataGridElement>);\n\n  readonly masterDetail = input<MasterDetailConfig>();\n  readonly detailExpand = output<DetailExpandDetail>();\n\n  private listener?: (e: Event) => void;\n\n  constructor() {\n    const grid = this.elementRef.nativeElement;\n    registerFeatureClaim(grid, 'masterDetail', () => this.masterDetail());\n    claimEvent(grid, 'detail-expand');\n  }\n\n  ngOnInit(): void {\n    const grid = this.elementRef.nativeElement;\n    this.listener = (e: Event): void => this.detailExpand.emit((e as CustomEvent<DetailExpandDetail>).detail);\n    grid.addEventListener('detail-expand', this.listener);\n  }\n\n  ngOnDestroy(): void {\n    const grid = this.elementRef.nativeElement;\n    if (this.listener) {\n      grid.removeEventListener('detail-expand', this.listener);\n      this.listener = undefined;\n    }\n    unregisterFeatureClaim(grid, 'masterDetail');\n    unclaimEvent(grid, 'detail-expand');\n  }\n}\n","/**\n * Master-detail feature for @toolbox-web/grid-angular\n *\n * Import this module to enable the `[masterDetail]` input on the `Grid`\n * directive AND to wire `<tbw-grid-detail>` Angular templates into the\n * MasterDetailPlugin's `detailRenderer`.\n *\n * @example\n * ```typescript\n * // In your bootstrap (e.g. main.ts or app.component.ts):\n * import '@toolbox-web/grid-angular/features/master-detail';\n * ```\n *\n * ```html\n * <tbw-grid [masterDetail]=\"{ showExpandColumn: true }\">\n *   <tbw-grid-detail>\n *     <ng-template let-row>...</ng-template>\n *   </tbw-grid-detail>\n * </tbw-grid>\n * ```\n *\n * @packageDocumentation\n */\n\nimport {\n  getDetailTemplate,\n  registerDetailRendererBridge,\n  registerTemplateBridge,\n  type GridAdapter,\n  type GridDetailContext,\n} from '@toolbox-web/grid-angular';\nimport '@toolbox-web/grid/features/master-detail';\nexport { GridMasterDetailDirective } from './grid-master-detail.directive';\nexport type { _Augmentation as _MasterDetailAugmentation } from '@toolbox-web/grid/features/master-detail';\n\n// ---------------------------------------------------------------------------\n// Re-exports from `@toolbox-web/grid-angular` (main entry).\n//\n// `GridDetailView` (and its `getDetailTemplate` helper / `GridDetailContext`\n// type) still physically live in the main entry today but are master-detail\n// specific. They are re-exported here so consumers can import them from the\n// feature entry that owns the runtime behaviour. The same symbols are\n// `@deprecated` on the main entry; in v2.0.0 the source will physically move\n// into this secondary entry and the deprecated re-exports on the main entry\n// will be removed.\n// ---------------------------------------------------------------------------\nexport { getDetailTemplate, GridDetailView } from '@toolbox-web/grid-angular';\nexport type { GridDetailContext } from '@toolbox-web/grid-angular';\n\n/**\n * Subset of `MasterDetailPlugin` we touch from the bridge. Avoids importing\n * the plugin class itself (would defeat tree-shaking and re-introduce the\n * coupling we just removed from the core directive).\n */\ninterface MasterDetailPluginLike {\n  refreshDetailRenderer?: () => void;\n}\n\n// Install the row renderer bridge on the adapter. This is what\n// `adapter.createDetailRenderer(grid)` and `adapter.parseDetailElement(el)`\n// delegate to. Without this import, both methods return undefined.\nregisterDetailRendererBridge(<TRow = unknown>(gridElement: HTMLElement, adapter: GridAdapter) => {\n  // Type inferred from `getDetailTemplate` (same package instance as `adapter`),\n  // not from a local `import type { TemplateRef } from '@angular/core'` — the\n  // latter resolves through Bun's `.bun/` cache during ng-packagr build and\n  // produces a brand-incompatible TemplateRef vs the built adapter `.d.ts`.\n  const template = getDetailTemplate(gridElement);\n  if (!template) return undefined;\n\n  return (row: TRow) => {\n    const context: GridDetailContext<TRow> = { $implicit: row, row };\n    const viewRef = adapter.createTrackedEmbeddedView(template, context);\n    const container = document.createElement('div');\n    viewRef.rootNodes.forEach((node: Node) => container.appendChild(node));\n    return container;\n  };\n});\n\n// Wire <tbw-grid-detail> Angular templates into the MasterDetailPlugin once\n// content templates are registered. The plugin's `parseLightDomDetail()`\n// already calls back into the adapter via `grid.__frameworkAdapter.parseDetailElement`\n// (which the `Grid` directive set in `ngOnInit`), so all we need to do here\n// is trigger a refresh once Angular's content templates are available.\nregisterTemplateBridge(({ grid }) => {\n  // Only act when the user actually placed a <tbw-grid-detail> in light DOM.\n  const detailElement = grid.querySelector('tbw-grid-detail');\n  if (!detailElement) return;\n\n  // The plugin must already have been attached (via [masterDetail] input,\n  // gridConfig.features.masterDetail, or gridConfig.plugins). Use the runtime\n  // lookup so we don't miss plugins instantiated from `gridConfig.features`,\n  // which never appear in `gridConfig.plugins`.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const existingPlugin = (grid as any).getPluginByName?.('masterDetail') as MasterDetailPluginLike | undefined;\n\n  if (!existingPlugin) {\n    // eslint-disable-next-line no-console\n    console.warn(\n      '[tbw-grid-angular] <tbw-grid-detail> found but MasterDetailPlugin is not configured.\\n' +\n        'Add the [masterDetail] input, set gridConfig.features.masterDetail, or include\\n' +\n        'MasterDetailPlugin in gridConfig.plugins:\\n\\n' +\n        '  <tbw-grid [masterDetail]=\"{ showExpandColumn: true }\">...</tbw-grid>\\n\\n' +\n        'or:\\n\\n' +\n        '  gridConfig = { features: { masterDetail: { showExpandColumn: true } } };',\n    );\n    return;\n  }\n\n  existingPlugin.refreshDetailRenderer?.();\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-responsive.mjs

@@ -77,6 +77,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImpor
 // `adapter.parseResponsiveCardElement(el)` delegate to. Without this import,
 // both methods return undefined.
 registerResponsiveCardRendererBridge((gridElement, adapter) => {
+    // Type inferred from `getResponsiveCardTemplate` (same package instance as
+    // `adapter`), not from a local `import type { TemplateRef } from '@angular/core'`
+    // — the latter resolves through Bun's `.bun/` cache during ng-packagr build
+    // and produces a brand-incompatible TemplateRef vs the built adapter `.d.ts`.
     const template = getResponsiveCardTemplate(gridElement);
     if (!template)
         return undefined;
@@ -100,17 +104,20 @@ registerTemplateBridge(({ grid, adapter }) => {
     const cardRenderer = adapter.createResponsiveCardRenderer(grid);
     if (!cardRenderer)
         return;
-    // Find the plugin by name to avoid importing the class.
+    // The plugin must already have been attached (via [responsive] input,
+    // gridConfig.features.responsive, or gridConfig.plugins). Use the runtime
+    // lookup so we don't miss plugins instantiated from `gridConfig.features`,
+    // which never appear in `gridConfig.plugins`.
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const existingPlugin = grid.gridConfig?.plugins?.find((p) => p.name === 'responsive');
+    const existingPlugin = grid.getPluginByName?.('responsive');
     if (!existingPlugin) {
         // eslint-disable-next-line no-console
         console.warn('[tbw-grid-angular] <tbw-grid-responsive-card> found but ResponsivePlugin is not configured.\n' +
-            'Add the [responsive] input or include ResponsivePlugin in gridConfig.plugins:\n\n' +
+            'Add the [responsive] input, set gridConfig.features.responsive, or include\n' +
+            'ResponsivePlugin in gridConfig.plugins:\n\n' +
             '  <tbw-grid [responsive]="{ breakpoint: 600 }">...</tbw-grid>\n\n' +
             'or:\n\n' +
-            '  import { ResponsivePlugin } from "@toolbox-web/grid/plugins/responsive";\n' +
-            '  gridConfig = { plugins: [new ResponsivePlugin({ breakpoint: 600 })] };');
+            '  gridConfig = { features: { responsive: { breakpoint: 600 } } };');
         return;
     }
     existingPlugin.setCardRenderer?.(cardRenderer);

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

@@ -1 +1 @@
-{"version":3,"file":"toolbox-web-grid-angular-features-responsive.mjs","sources":["../../../../libs/grid-angular/features/responsive/src/grid-responsive.directive.ts","../../../../libs/grid-angular/features/responsive/src/index.ts","../../../../libs/grid-angular/features/responsive/src/toolbox-web-grid-angular-features-responsive.ts"],"sourcesContent":["/**\n * `GridResponsiveDirective` — owns `[responsive]` and `(responsiveChange)`\n * on `<tbw-grid>`. See `GridFilteringDirective` for the full rationale.\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 { ResponsiveChangeDetail, ResponsivePluginConfig } from '@toolbox-web/grid/plugins/responsive';\n\n/**\n * Owns the binding(s) `[responsive], [responsiveChange]` 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[responsive], tbw-grid[responsiveChange]',\n  standalone: true,\n})\nexport class GridResponsiveDirective implements OnInit, OnDestroy {\n  private readonly elementRef = inject(ElementRef<DataGridElement>);\n\n  readonly responsive = input<boolean | ResponsivePluginConfig>();\n  readonly responsiveChange = output<ResponsiveChangeDetail>();\n\n  private listener?: (e: Event) => void;\n\n  constructor() {\n    const grid = this.elementRef.nativeElement;\n    registerFeatureClaim(grid, 'responsive', () => this.responsive());\n    claimEvent(grid, 'responsive-change');\n  }\n\n  ngOnInit(): void {\n    const grid = this.elementRef.nativeElement;\n    this.listener = (e: Event): void => this.responsiveChange.emit((e as CustomEvent<ResponsiveChangeDetail>).detail);\n    grid.addEventListener('responsive-change', this.listener);\n  }\n\n  ngOnDestroy(): void {\n    const grid = this.elementRef.nativeElement;\n    if (this.listener) {\n      grid.removeEventListener('responsive-change', this.listener);\n      this.listener = undefined;\n    }\n    unregisterFeatureClaim(grid, 'responsive');\n    unclaimEvent(grid, 'responsive-change');\n  }\n}\n","/**\n * Responsive feature for @toolbox-web/grid-angular\n *\n * Import this module to enable the `[responsive]` input on the `Grid`\n * directive AND to wire `<tbw-grid-responsive-card>` Angular templates into\n * the ResponsivePlugin's `cardRenderer`.\n *\n * @example\n * ```typescript\n * // In your bootstrap (e.g. main.ts or app.component.ts):\n * import '@toolbox-web/grid-angular/features/responsive';\n * ```\n *\n * ```html\n * <tbw-grid [responsive]=\"{ breakpoint: 768 }\">\n *   <tbw-grid-responsive-card>\n *     <ng-template let-row>...</ng-template>\n *   </tbw-grid-responsive-card>\n * </tbw-grid>\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { TemplateRef } from '@angular/core';\nimport {\n  getResponsiveCardTemplate,\n  registerResponsiveCardRendererBridge,\n  registerTemplateBridge,\n  type GridAdapter,\n  type GridResponsiveCardContext,\n} from '@toolbox-web/grid-angular';\nimport '@toolbox-web/grid/features/responsive';\nexport { GridResponsiveDirective } from './grid-responsive.directive';\nexport type { _Augmentation as _ResponsiveAugmentation } from '@toolbox-web/grid/features/responsive';\n\n/**\n * Subset of `ResponsivePlugin` we touch from the bridge. Avoids importing\n * the plugin class itself.\n */\ninterface ResponsivePluginLike {\n  setCardRenderer?: (renderer: (row: unknown, rowIndex: number) => HTMLElement) => void;\n}\n\n// Install the row renderer bridge on the adapter. This is what\n// `adapter.createResponsiveCardRenderer(grid)` and\n// `adapter.parseResponsiveCardElement(el)` delegate to. Without this import,\n// both methods return undefined.\nregisterResponsiveCardRendererBridge(<TRow = unknown>(gridElement: HTMLElement, adapter: GridAdapter) => {\n  const template = getResponsiveCardTemplate(gridElement) as TemplateRef<GridResponsiveCardContext<TRow>> | undefined;\n  if (!template) return undefined;\n\n  return (row: TRow, rowIndex: number) => {\n    const context: GridResponsiveCardContext<TRow> = { $implicit: row, row, index: rowIndex };\n    const viewRef = adapter.createTrackedEmbeddedView(template, context);\n    const container = document.createElement('div');\n    viewRef.rootNodes.forEach((node: Node) => container.appendChild(node));\n    return container;\n  };\n});\n\n// Wire <tbw-grid-responsive-card> Angular templates into the ResponsivePlugin\n// once content templates are registered. Runs from `Grid.ngAfterContentInit`\n// via the template-bridge registry.\nregisterTemplateBridge(({ grid, adapter }) => {\n  // Only act when the user actually placed a <tbw-grid-responsive-card> in light DOM.\n  const cardElement = grid.querySelector('tbw-grid-responsive-card');\n  if (!cardElement) return;\n\n  // Build a card renderer from the Angular template.\n  const cardRenderer = adapter.createResponsiveCardRenderer(grid);\n  if (!cardRenderer) return;\n\n  // Find the plugin by name to avoid importing the class.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const existingPlugin = (grid as any).gridConfig?.plugins?.find((p: { name?: string }) => p.name === 'responsive') as\n    | ResponsivePluginLike\n    | undefined;\n\n  if (!existingPlugin) {\n    // eslint-disable-next-line no-console\n    console.warn(\n      '[tbw-grid-angular] <tbw-grid-responsive-card> found but ResponsivePlugin is not configured.\\n' +\n        'Add the [responsive] input or include ResponsivePlugin in gridConfig.plugins:\\n\\n' +\n        '  <tbw-grid [responsive]=\"{ breakpoint: 600 }\">...</tbw-grid>\\n\\n' +\n        'or:\\n\\n' +\n        '  import { ResponsivePlugin } from \"@toolbox-web/grid/plugins/responsive\";\\n' +\n        '  gridConfig = { plugins: [new ResponsivePlugin({ breakpoint: 600 })] };',\n    );\n    return;\n  }\n\n  existingPlugin.setCardRenderer?.(cardRenderer as (row: unknown, rowIndex: number) => HTMLElement);\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-responsive.mjs","sources":["../../../../libs/grid-angular/features/responsive/src/grid-responsive.directive.ts","../../../../libs/grid-angular/features/responsive/src/index.ts","../../../../libs/grid-angular/features/responsive/src/toolbox-web-grid-angular-features-responsive.ts"],"sourcesContent":["/**\n * `GridResponsiveDirective` — owns `[responsive]` and `(responsiveChange)`\n * on `<tbw-grid>`. See `GridFilteringDirective` for the full rationale.\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 { ResponsiveChangeDetail, ResponsivePluginConfig } from '@toolbox-web/grid/plugins/responsive';\n\n/**\n * Owns the binding(s) `[responsive], [responsiveChange]` 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[responsive], tbw-grid[responsiveChange]',\n  standalone: true,\n})\nexport class GridResponsiveDirective implements OnInit, OnDestroy {\n  private readonly elementRef = inject(ElementRef<DataGridElement>);\n\n  readonly responsive = input<boolean | ResponsivePluginConfig>();\n  readonly responsiveChange = output<ResponsiveChangeDetail>();\n\n  private listener?: (e: Event) => void;\n\n  constructor() {\n    const grid = this.elementRef.nativeElement;\n    registerFeatureClaim(grid, 'responsive', () => this.responsive());\n    claimEvent(grid, 'responsive-change');\n  }\n\n  ngOnInit(): void {\n    const grid = this.elementRef.nativeElement;\n    this.listener = (e: Event): void => this.responsiveChange.emit((e as CustomEvent<ResponsiveChangeDetail>).detail);\n    grid.addEventListener('responsive-change', this.listener);\n  }\n\n  ngOnDestroy(): void {\n    const grid = this.elementRef.nativeElement;\n    if (this.listener) {\n      grid.removeEventListener('responsive-change', this.listener);\n      this.listener = undefined;\n    }\n    unregisterFeatureClaim(grid, 'responsive');\n    unclaimEvent(grid, 'responsive-change');\n  }\n}\n","/**\n * Responsive feature for @toolbox-web/grid-angular\n *\n * Import this module to enable the `[responsive]` input on the `Grid`\n * directive AND to wire `<tbw-grid-responsive-card>` Angular templates into\n * the ResponsivePlugin's `cardRenderer`.\n *\n * @example\n * ```typescript\n * // In your bootstrap (e.g. main.ts or app.component.ts):\n * import '@toolbox-web/grid-angular/features/responsive';\n * ```\n *\n * ```html\n * <tbw-grid [responsive]=\"{ breakpoint: 768 }\">\n *   <tbw-grid-responsive-card>\n *     <ng-template let-row>...</ng-template>\n *   </tbw-grid-responsive-card>\n * </tbw-grid>\n * ```\n *\n * @packageDocumentation\n */\n\nimport {\n  getResponsiveCardTemplate,\n  registerResponsiveCardRendererBridge,\n  registerTemplateBridge,\n  type GridAdapter,\n  type GridResponsiveCardContext,\n} from '@toolbox-web/grid-angular';\nimport '@toolbox-web/grid/features/responsive';\nexport { GridResponsiveDirective } from './grid-responsive.directive';\nexport type { _Augmentation as _ResponsiveAugmentation } from '@toolbox-web/grid/features/responsive';\n\n/**\n * Subset of `ResponsivePlugin` we touch from the bridge. Avoids importing\n * the plugin class itself.\n */\ninterface ResponsivePluginLike {\n  setCardRenderer?: (renderer: (row: unknown, rowIndex: number) => HTMLElement) => void;\n}\n\n// Install the row renderer bridge on the adapter. This is what\n// `adapter.createResponsiveCardRenderer(grid)` and\n// `adapter.parseResponsiveCardElement(el)` delegate to. Without this import,\n// both methods return undefined.\nregisterResponsiveCardRendererBridge(<TRow = unknown>(gridElement: HTMLElement, adapter: GridAdapter) => {\n  // Type inferred from `getResponsiveCardTemplate` (same package instance as\n  // `adapter`), not from a local `import type { TemplateRef } from '@angular/core'`\n  // — the latter resolves through Bun's `.bun/` cache during ng-packagr build\n  // and produces a brand-incompatible TemplateRef vs the built adapter `.d.ts`.\n  const template = getResponsiveCardTemplate(gridElement);\n  if (!template) return undefined;\n\n  return (row: TRow, rowIndex: number) => {\n    const context: GridResponsiveCardContext<TRow> = { $implicit: row, row, index: rowIndex };\n    const viewRef = adapter.createTrackedEmbeddedView(template, context);\n    const container = document.createElement('div');\n    viewRef.rootNodes.forEach((node: Node) => container.appendChild(node));\n    return container;\n  };\n});\n\n// Wire <tbw-grid-responsive-card> Angular templates into the ResponsivePlugin\n// once content templates are registered. Runs from `Grid.ngAfterContentInit`\n// via the template-bridge registry.\nregisterTemplateBridge(({ grid, adapter }) => {\n  // Only act when the user actually placed a <tbw-grid-responsive-card> in light DOM.\n  const cardElement = grid.querySelector('tbw-grid-responsive-card');\n  if (!cardElement) return;\n\n  // Build a card renderer from the Angular template.\n  const cardRenderer = adapter.createResponsiveCardRenderer(grid);\n  if (!cardRenderer) return;\n\n  // The plugin must already have been attached (via [responsive] input,\n  // gridConfig.features.responsive, or gridConfig.plugins). Use the runtime\n  // lookup so we don't miss plugins instantiated from `gridConfig.features`,\n  // which never appear in `gridConfig.plugins`.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const existingPlugin = (grid as any).getPluginByName?.('responsive') as ResponsivePluginLike | undefined;\n\n  if (!existingPlugin) {\n    // eslint-disable-next-line no-console\n    console.warn(\n      '[tbw-grid-angular] <tbw-grid-responsive-card> found but ResponsivePlugin is not configured.\\n' +\n        'Add the [responsive] input, set gridConfig.features.responsive, or include\\n' +\n        'ResponsivePlugin in gridConfig.plugins:\\n\\n' +\n        '  <tbw-grid [responsive]=\"{ breakpoint: 600 }\">...</tbw-grid>\\n\\n' +\n        'or:\\n\\n' +\n        '  gridConfig = { features: { responsive: { breakpoint: 600 } } };',\n    );\n    return;\n  }\n\n  existingPlugin.setCardRenderer?.(cardRenderer as (row: unknown, rowIndex: number) => HTMLElement);\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.mjs

@@ -18,6 +18,7 @@ import { DataGridElement } from '@toolbox-web/grid';
  *
  * Also checks if it's an ES6 class (vs function) by inspecting the
  * string representation.
+ * @since 0.3.0
  */
 function isComponentClass(value) {
     if (typeof value !== 'function' || value.prototype === undefined) {
@@ -92,6 +93,7 @@ function getEditorTemplate(element) {
  * re-exports from the main `@toolbox-web/grid-angular` entry will be removed
  * at the same time. Consumers should already be importing from the feature
  * entry.
+ * @since 0.1.0
  */
 class GridColumnEditor {
     elementRef = inject((ElementRef));
@@ -166,6 +168,7 @@ function getViewTemplate(element) {
  * ```
  *
  * @category Directive
+ * @since 0.1.0
  */
 class GridColumnView {
     elementRef = inject((ElementRef));
@@ -201,6 +204,7 @@ const FORM_ARRAY_CONTEXT$1 = Symbol('formArrayContext');
 /**
  * Gets the FormArrayContext from a grid element, if present.
  * @internal
+ * @since 0.5.0
  */
 function getFormArrayContext(gridElement) {
     return gridElement[FORM_ARRAY_CONTEXT$1];
@@ -271,6 +275,7 @@ function getFormArrayContext(gridElement) {
  * re-exports from the main `@toolbox-web/grid-angular` entry will be removed
  * at the same time. Consumers should already be importing from the feature
  * entry.
+ * @since 0.5.0
  */
 class GridFormArray {
     destroyRef = inject(DestroyRef);
@@ -760,6 +765,7 @@ function getToolPanelElements(gridElement) {
  * ```
  *
  * @category Directive
+ * @since 0.1.0
  */
 class GridToolPanel {
     elementRef = inject((ElementRef));
@@ -896,6 +902,7 @@ function getStructuralEditorTemplate(columnElement) {
  * ```
  *
  * @category Directive
+ * @since 0.1.1
  */
 class TbwRenderer {
     template = inject((TemplateRef));
@@ -999,6 +1006,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImpor
  * will be removed at the same time. Consumers should already be importing
  * from the feature entry. (`TbwRenderer` stays in the main entry — it is
  * editor-agnostic.)
+ * @since 0.1.1
  */
 class TbwEditor {
     template = inject((TemplateRef));
@@ -1060,6 +1068,7 @@ const editorMountHooks = [];
  * (e.g. `features/editing`) on import.
  *
  * @internal Plugin API
+ * @since 1.4.0
  */
 function registerEditorMountHook(hook) {
     editorMountHooks.push(hook);
@@ -1090,6 +1099,7 @@ function notifyEditorMounted(container, gridEl) {
  * `(blur)` flush their pending value before the cell DOM is torn down by Tab /
  * programmatic row exit.
  * @internal
+ * @since 1.4.0
  */
 function makeFlushFocusedInput(host) {
     return () => {
@@ -1194,6 +1204,7 @@ function wireEditorCallbacks(hostElement, instance, commit, cancel) {
  */
 /**
  * Injection token for providing type defaults at app level.
+ * @since 0.3.0
  */
 const GRID_TYPE_DEFAULTS = new InjectionToken('GRID_TYPE_DEFAULTS');
 /**
@@ -1231,6 +1242,7 @@ const GRID_TYPE_DEFAULTS = new InjectionToken('GRID_TYPE_DEFAULTS');
  *   }
  * }
  * ```
+ * @since 0.3.0
  */
 class GridTypeRegistry {
     defaults = new Map();
@@ -1320,6 +1332,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImpor
  *   ]
  * };
  * ```
+ * @since 0.3.0
  */
 function provideGridTypeDefaults(defaults) {
     return makeEnvironmentProviders([{ provide: GRID_TYPE_DEFAULTS, useValue: defaults }]);
@@ -1348,6 +1361,7 @@ let filterPanelTypeDefaultBridge = null;
  * Install the master-detail row-renderer bridge. Called once on import by
  * `@toolbox-web/grid-angular/features/master-detail`.
  * @internal Plugin API
+ * @since 1.4.0
  */
 function registerDetailRendererBridge(bridge) {
     detailRendererBridge = bridge;
@@ -1356,6 +1370,7 @@ function registerDetailRendererBridge(bridge) {
  * Install the responsive-card row-renderer bridge. Called once on import by
  * `@toolbox-web/grid-angular/features/responsive`.
  * @internal Plugin API
+ * @since 1.4.0
  */
 function registerResponsiveCardRendererBridge(bridge) {
     responsiveCardRendererBridge = bridge;
@@ -1366,6 +1381,7 @@ function registerResponsiveCardRendererBridge(bridge) {
  * type-default and grid-config-level component-class filterPanelRenderers are
  * silently dropped — same precondition as the FilteringPlugin (TBW031).
  * @internal Plugin API
+ * @since 1.4.0
  */
 function registerFilterPanelTypeDefaultBridge(bridge) {
     filterPanelTypeDefaultBridge = bridge;
@@ -1415,6 +1431,7 @@ const templateBridges = [];
  * by the JS loader.
  *
  * @internal
+ * @since 1.4.0
  */
 function registerTemplateBridge(bridge) {
     templateBridges.push(bridge);
@@ -1425,6 +1442,7 @@ function registerTemplateBridge(bridge) {
  * errors thrown by one bridge do not stop the others.
  *
  * @internal
+ * @since 1.4.0
  */
 function runTemplateBridges(ctx) {
     for (const bridge of templateBridges) {
@@ -1450,6 +1468,7 @@ const featureConfigPreprocessors = new Map();
  * a no-op).
  *
  * @internal
+ * @since 1.4.0
  */
 function registerFeatureConfigPreprocessor(name, fn) {
     featureConfigPreprocessors.set(name, fn);
@@ -1458,6 +1477,7 @@ function registerFeatureConfigPreprocessor(name, fn) {
  * Look up the preprocessor for a feature, if any.
  *
  * @internal
+ * @since 1.4.0
  */
 function getFeatureConfigPreprocessor(name) {
     return featureConfigPreprocessors.get(name);
@@ -1577,6 +1597,7 @@ function syncRootNodes(viewRef, container) {
         container.replaceChildren(...rootNodes);
     }
 }
+/** @since 0.11.0 */
 class GridAdapter {
     injector;
     appRef;
@@ -1664,6 +1685,12 @@ class GridAdapter {
         if (angularConfig.loadingRenderer && isComponentClass(angularConfig.loadingRenderer)) {
             result.loadingRenderer = this.createComponentLoadingRenderer(angularConfig.loadingRenderer);
         }
+        // Process emptyRenderer - convert Angular component class to function.
+        // `null` is a valid opt-out value (suppresses the built-in default message);
+        // non-component values (vanilla functions, null) are forwarded unchanged.
+        if (angularConfig.emptyRenderer && isComponentClass(angularConfig.emptyRenderer)) {
+            result.emptyRenderer = this.createComponentEmptyRenderer(angularConfig.emptyRenderer);
+        }
         return result;
     }
     /**
@@ -2168,6 +2195,19 @@ class GridAdapter {
         const mount = this.mountComponentRenderer(componentClass, (ctx) => ({ size: ctx.size }));
         return (ctx) => mount(ctx).hostElement;
     }
+    /**
+     * Creates an empty-state renderer function from an Angular component class.
+     *
+     * The component receives `sourceRowCount` and `filteredOut` inputs.
+     * @internal
+     */
+    createComponentEmptyRenderer(componentClass) {
+        const mount = this.mountComponentRenderer(componentClass, (ctx) => ({
+            sourceRowCount: ctx.sourceRowCount,
+            filteredOut: ctx.filteredOut,
+        }));
+        return (ctx) => mount(ctx).hostElement;
+    }
     /**
      * Create an embedded view from a `TemplateRef` and append-track it on the
      * adapter's view-ref pool so it is cleaned up on `destroy()` / `unmount()`.
@@ -2337,6 +2377,7 @@ class GridAdapter {
  */
 /**
  * Injection token for providing icon overrides at app level.
+ * @since 0.8.0
  */
 const GRID_ICONS = new InjectionToken('GRID_ICONS');
 /**
@@ -2369,6 +2410,7 @@ const GRID_ICONS = new InjectionToken('GRID_ICONS');
  *   }
  * }
  * ```
+ * @since 0.8.0
  */
 class GridIconRegistry {
     icons = new Map();
@@ -2467,6 +2509,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImpor
  *   ]
  * };
  * ```
+ * @since 0.8.0
  */
 function provideGridIcons(icons) {
     return makeEnvironmentProviders([{ provide: GRID_ICONS, useValue: icons }]);
@@ -2511,6 +2554,7 @@ function provideGridIcons(icons) {
  *   Defaults to `'tbw-grid'` (first grid in the component). Use when the
  *   component contains multiple grids, e.g. `'tbw-grid.primary'` or `'#my-grid'`.
  * @returns Object with grid access methods and state signals
+ * @since 0.6.0
  */
 function injectGrid(selector = 'tbw-grid') {
     const elementRef = inject(ElementRef);
@@ -2675,6 +2719,7 @@ function injectGrid(selector = 'tbw-grid') {
  * `@toolbox-web/grid-angular/features/filtering` in v2.0.0; the deprecated
  * re-export from the main `@toolbox-web/grid-angular` entry will be removed at
  * the same time. Consumers should already be importing from the feature entry.
+ * @since 0.13.0
  */
 class BaseFilterPanel {
     /**
@@ -2783,6 +2828,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImpor
  * `@toolbox-web/grid-angular/features/editing` in v2.0.0; the deprecated
  * re-export from the main `@toolbox-web/grid-angular` entry will be removed at
  * the same time. Consumers should already be importing from the feature entry.
+ * @since 0.5.0
  */
 class BaseGridEditor {
     elementRef = inject(ElementRef);
@@ -3090,6 +3136,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImpor
  * `@toolbox-web/grid-angular/features/editing` in v2.0.0; the deprecated
  * re-export from the main `@toolbox-web/grid-angular` entry will be removed at
  * the same time. Consumers should already be importing from the feature entry.
+ * @since 0.13.0
  */
 class BaseGridEditorCVA extends BaseGridEditor {
     // ============================================================================
@@ -3359,6 +3406,7 @@ let anchorCounter = 0;
  * the deprecated re-export from the main `@toolbox-web/grid-angular` entry
  * will be removed at the same time. Consumers should already be importing
  * from the feature entry.
+ * @since 0.13.0
  */
 class BaseOverlayEditor extends BaseGridEditor {
     _elementRef = inject(ElementRef);
@@ -3825,6 +3873,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImpor
  * ```
  *
  * @category Directive
+ * @since 0.13.0
  */
 class TbwGridColumn {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: TbwGridColumn, deps: [], target: i0.ɵɵFactoryTarget.Directive });
@@ -3842,6 +3891,7 @@ const detailTemplateRegistry = new Map();
 /**
  * Gets the detail template registered for a given grid element.
  * Used by AngularGridAdapter to retrieve templates at render time.
+ * @since 0.1.0
  */
 function getDetailTemplate(gridElement) {
     // Look for tbw-grid-detail child and get its template
@@ -3899,6 +3949,7 @@ function getDetailTemplate(gridElement) {
  * ```
  *
  * @category Directive
+ * @since 0.1.0
  */
 class GridDetailView {
     elementRef = inject((ElementRef));
@@ -3959,6 +4010,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImpor
  * ```
  *
  * @category Directive
+ * @since 0.13.0
  */
 class TbwGridHeader {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: TbwGridHeader, deps: [], target: i0.ɵɵFactoryTarget.Directive });
@@ -3976,6 +4028,7 @@ const FORM_ARRAY_CONTEXT = Symbol('formArrayContext');
 /**
  * Gets the FormArrayContext from a grid element, if present.
  * @internal
+ * @since 0.11.0
  */
 function getLazyFormContext(gridElement) {
     return gridElement[FORM_ARRAY_CONTEXT];
@@ -4062,6 +4115,7 @@ function getLazyFormContext(gridElement) {
  * re-exports from the main `@toolbox-web/grid-angular` entry will be removed
  * at the same time. Consumers should already be importing from the feature
  * entry.
+ * @since 0.11.0
  */
 class GridLazyForm {
     elementRef = inject((ElementRef));
@@ -4467,6 +4521,7 @@ const responsiveCardTemplateRegistry = new Map();
  *
  * @param gridElement - The grid element to look up
  * @returns The template reference or undefined if not found
+ * @since 0.4.0
  */
 function getResponsiveCardTemplate(gridElement) {
     // Find the tbw-grid-responsive-card element inside the grid
@@ -4507,6 +4562,7 @@ function getResponsiveCardTemplate(gridElement) {
  *
  * @see ResponsivePlugin
  * @category Directive
+ * @since 0.4.0
  */
 class GridResponsiveCard {
     elementRef = inject((ElementRef));
@@ -4588,6 +4644,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImpor
  * ```
  *
  * @category Directive
+ * @since 0.13.0
  */
 class TbwGridToolButtons {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: TbwGridToolButtons, deps: [], target: i0.ɵɵFactoryTarget.Directive });
@@ -4636,6 +4693,7 @@ const VALID_TYPES = new Set(['string', 'number', 'boolean', 'date', 'datetime',
  *
  * @param shorthand - The shorthand string (e.g., 'name', 'salary:number')
  * @returns A ColumnConfig object
+ * @since 1.4.0
  */
 function parseColumnShorthand(shorthand) {
     const colonIndex = shorthand.lastIndexOf(':');
@@ -4660,6 +4718,7 @@ function parseColumnShorthand(shorthand) {
  *
  * @param columns - Array of column shorthands (strings or ColumnConfig objects)
  * @returns Array of ColumnConfig objects
+ * @since 1.4.0
  */
 function normalizeColumns(columns) {
     return columns.map((col) => (typeof col === 'string' ? parseColumnShorthand(col) : col));
@@ -4667,13 +4726,15 @@ function normalizeColumns(columns) {
 /**
  * Apply column defaults to a list of columns. Individual column properties
  * override defaults.
+ * @since 1.4.0
  */
 function applyColumnDefaults(columns, defaults) {
     if (!defaults)
         return columns;
     return columns.map((col) => ({ ...defaults, ...col }));
 }
-/** Check if an array of columns contains any shorthand strings. */
+/** Check if an array of columns contains any shorthand strings. * @since 1.4.0
+ */
 function hasColumnShorthands(columns) {
     return columns.some((col) => typeof col === 'string');
 }
@@ -4687,6 +4748,7 @@ const eventClaims = new WeakMap();
  * the {@link Grid} directive will then use {@link getFeatureClaim} during
  * plugin creation instead of reading its own deprecated input.
  * @internal
+ * @since 1.4.0
  */
 function registerFeatureClaim(grid, name, getConfig) {
     let map = featureClaims.get(grid);
@@ -4700,6 +4762,7 @@ function registerFeatureClaim(grid, name, getConfig) {
  * Look up a feature claim. Returns the registered config getter, or
  * `undefined` if no directive owns this feature on this element.
  * @internal
+ * @since 1.4.0
  */
 function getFeatureClaim(grid, name) {
     return featureClaims.get(grid)?.get(name);
@@ -4709,6 +4772,7 @@ function getFeatureClaim(grid, name) {
  * that, if the directive is removed (e.g. via `*ngIf`) but the host
  * `<tbw-grid>` survives, {@link Grid}'s deprecated input takes back over.
  * @internal
+ * @since 1.4.0
  */
 function unregisterFeatureClaim(grid, name) {
     featureClaims.get(grid)?.delete(name);
@@ -4718,6 +4782,7 @@ function unregisterFeatureClaim(grid, name) {
  * `setupEventListeners` skips wiring its own deprecated `output()` for any
  * claimed event — the directive owns the listener and the emit.
  * @internal
+ * @since 1.4.0
  */
 function claimEvent(grid, eventName) {
     let set = eventClaims.get(grid);
@@ -4730,6 +4795,7 @@ function claimEvent(grid, eventName) {
 /**
  * Returns true if a directive has claimed this event on this grid element.
  * @internal
+ * @since 1.4.0
  */
 function isEventClaimed(grid, eventName) {
     return eventClaims.get(grid)?.has(eventName) ?? false;
@@ -4738,6 +4804,7 @@ function isEventClaimed(grid, eventName) {
  * Drop an event claim. Pair with {@link claimEvent} in a directive's
  * `ngOnDestroy`.
  * @internal
+ * @since 1.4.0
  */
 function unclaimEvent(grid, eventName) {
     eventClaims.get(grid)?.delete(eventName);
@@ -4778,6 +4845,7 @@ function unclaimEvent(grid, eventName) {
  * - Handles cleanup on destruction
  *
  * @category Directive
+ * @since 0.1.0
  */
 class Grid {
     elementRef = inject((ElementRef));
@@ -6298,6 +6366,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImpor
  *
  * Equivalent to calling `provideGridTypeDefaults(options.typeDefaults)` and
  * `provideGridIcons(options.icons)` separately.
+ * @since 1.4.0
  */
 function provideGrid(options = {}) {
     const providers = [];