@toolbox-web/grid-angular 1.4.0 → 1.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolbox-web/grid-angular",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Angular adapter for @toolbox-web/grid data grid component",
   "type": "module",
   "keywords": [

package/types/toolbox-web-grid-angular.d.ts

@@ -35,6 +35,7 @@ export { PluginFactory, clearFeatureRegistry, createPluginFromFeature, getFeatur
  *   column = input<unknown>();
  * }
  * ```
+ * @since 0.11.0
  */
 interface CellRenderer<TRow = unknown, TValue = unknown> {
     /** The cell value - use `input<TValue>()` or `input.required<TValue>()` */
@@ -78,6 +79,7 @@ interface CellRenderer<TRow = unknown, TValue = unknown> {
  *   cancel = output<void>();
  * }
  * ```
+ * @since 0.11.0
  */
 interface CellEditor<TRow = unknown, TValue = unknown> extends CellRenderer<TRow, TValue> {
     /** Emit to commit the new value - use `output<TValue>()` */
@@ -120,6 +122,7 @@ interface CellEditor<TRow = unknown, TValue = unknown> extends CellRenderer<TRow
  *   params = input.required<FilterPanelParams>();
  * }
  * ```
+ * @since 0.12.0
  */
 interface FilterPanel {
     /** The filter panel parameters — use `input.required<FilterPanelParams>()` */
@@ -148,6 +151,7 @@ interface FilterPanel {
  *   }
  * };
  * ```
+ * @since 0.10.0
  */
 interface TypeDefault<TRow = unknown> {
     /** Format function for cell display */
@@ -198,6 +202,7 @@ interface TypeDefault<TRow = unknown> {
  *   },
  * ];
  * ```
+ * @since 0.3.0
  */
 interface ColumnConfig<TRow = unknown> extends Omit<ColumnConfig$1<TRow>, 'renderer' | 'editor' | 'headerRenderer' | 'headerLabelRenderer'> {
     /**
@@ -240,8 +245,9 @@ interface ColumnConfig<TRow = unknown> extends Omit<ColumnConfig$1<TRow>, 'rende
  *   plugins: [...],
  * };
  * ```
+ * @since 0.3.0
  */
-interface GridConfig<TRow = unknown> extends Omit<GridConfig$1<TRow>, 'columns' | 'typeDefaults' | 'loadingRenderer'> {
+interface GridConfig<TRow = unknown> extends Omit<GridConfig$1<TRow>, 'columns' | 'typeDefaults' | 'loadingRenderer' | 'emptyRenderer'> {
     columns?: ColumnConfig<TRow>[];
     /** Type-level defaults that can use Angular component classes */
     typeDefaults?: Record<string, TypeDefault<TRow>>;
@@ -251,6 +257,15 @@ interface GridConfig<TRow = unknown> extends Omit<GridConfig$1<TRow>, 'columns'
      * - An Angular component class with a `size` input
      */
     loadingRenderer?: GridConfig$1<TRow>['loadingRenderer'] | Type<unknown>;
+    /**
+     * Custom empty-state renderer shown when the grid has no rows and is not
+     * loading. Can be:
+     * - A function `(ctx: EmptyContext) => HTMLElement | string`
+     * - An Angular component class with `sourceRowCount` and `filteredOut` inputs
+     *
+     * Set explicitly to `null` to suppress the built-in default message.
+     */
+    emptyRenderer?: GridConfig$1<TRow>['emptyRenderer'] | Type<unknown>;
 }
 /**
  * Type guard to check if a value is an Angular component class.
@@ -261,6 +276,7 @@ interface GridConfig<TRow = unknown> extends Omit<GridConfig$1<TRow>, 'columns'
  *
  * Also checks if it's an ES6 class (vs function) by inspecting the
  * string representation.
+ * @since 0.3.0
  */
 declare function isComponentClass(value: unknown): value is Type<unknown>;
 
@@ -281,6 +297,7 @@ declare function isComponentClass(value: unknown): value is Type<unknown>;
 /**
  * Hook called when an editor host is mounted. Returning a function
  * registers a teardown that runs when the editor is released.
+ * @since 1.4.0
  */
 type EditorMountHook = (ctx: {
     container: HTMLElement;
@@ -291,6 +308,7 @@ type EditorMountHook = (ctx: {
  * (e.g. `features/editing`) on import.
  *
  * @internal Plugin API
+ * @since 1.4.0
  */
 declare function registerEditorMountHook(hook: EditorMountHook): void;
 /**
@@ -300,6 +318,7 @@ declare function registerEditorMountHook(hook: EditorMountHook): void;
  * `(blur)` flush their pending value before the cell DOM is torn down by Tab /
  * programmatic row exit.
  * @internal
+ * @since 1.4.0
  */
 declare function makeFlushFocusedInput(host: HTMLElement): () => void;
 
@@ -325,6 +344,7 @@ declare function makeFlushFocusedInput(host: HTMLElement): () => void;
  * the adapter should expose, or undefined if no Angular template is registered
  * for that grid. Used by `features/master-detail` and `features/responsive`.
  * @internal
+ * @since 1.4.0
  */
 type RowRendererBridge = <TRow = unknown>(gridElement: HTMLElement, adapter: GridAdapter) => ((row: TRow, rowIndex: number) => HTMLElement) | undefined;
 /**
@@ -333,18 +353,21 @@ type RowRendererBridge = <TRow = unknown>(gridElement: HTMLElement, adapter: Gri
  * (so the adapter does not depend on filtering types) and returns the
  * imperative `(container, params) => void` form required by core.
  * @internal
+ * @since 1.4.0
  */
 type FilterPanelTypeDefaultBridge = (rendererValue: unknown, adapter: GridAdapter) => NonNullable<TypeDefault$1['filterPanelRenderer']> | undefined;
 /**
  * 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
  */
 declare function registerDetailRendererBridge(bridge: RowRendererBridge): void;
 /**
  * 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
  */
 declare function registerResponsiveCardRendererBridge(bridge: RowRendererBridge): void;
 /**
@@ -353,9 +376,11 @@ declare function registerResponsiveCardRendererBridge(bridge: RowRendererBridge)
  * 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
  */
 declare function registerFilterPanelTypeDefaultBridge(bridge: FilterPanelTypeDefaultBridge): void;
 
+/** @since 0.11.0 */
 declare class GridAdapter implements FrameworkAdapter {
     private injector;
     private appRef;
@@ -569,6 +594,13 @@ declare class GridAdapter implements FrameworkAdapter {
      * @internal
      */
     private createComponentLoadingRenderer;
+    /**
+     * Creates an empty-state renderer function from an Angular component class.
+     *
+     * The component receives `sourceRowCount` and `filteredOut` inputs.
+     * @internal
+     */
+    private createComponentEmptyRenderer;
     /**
      * 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()`.
@@ -664,6 +696,7 @@ declare class GridAdapter implements FrameworkAdapter {
  *   },
  * };
  * ```
+ * @since 0.11.0
  */
 interface TypeDefaultRegistration<TRow = unknown> {
     /** Angular component class for rendering cells of this type */
@@ -683,6 +716,7 @@ interface TypeDefaultRegistration<TRow = unknown> {
 }
 /**
  * Injection token for providing type defaults at app level.
+ * @since 0.3.0
  */
 declare const GRID_TYPE_DEFAULTS: InjectionToken<Record<string, TypeDefaultRegistration<unknown>>>;
 /**
@@ -720,6 +754,7 @@ declare const GRID_TYPE_DEFAULTS: InjectionToken<Record<string, TypeDefaultRegis
  *   }
  * }
  * ```
+ * @since 0.3.0
  */
 declare class GridTypeRegistry {
     private readonly defaults;
@@ -776,6 +811,7 @@ declare class GridTypeRegistry {
  *   ]
  * };
  * ```
+ * @since 0.3.0
  */
 declare function provideGridTypeDefaults(defaults: Record<string, TypeDefaultRegistration>): EnvironmentProviders;
 
@@ -788,6 +824,7 @@ declare function provideGridTypeDefaults(defaults: Record<string, TypeDefaultReg
 
 /**
  * Injection token for providing icon overrides at app level.
+ * @since 0.8.0
  */
 declare const GRID_ICONS: InjectionToken<Partial<GridIcons>>;
 /**
@@ -820,6 +857,7 @@ declare const GRID_ICONS: InjectionToken<Partial<GridIcons>>;
  *   }
  * }
  * ```
+ * @since 0.8.0
  */
 declare class GridIconRegistry {
     private readonly icons;
@@ -890,11 +928,13 @@ declare class GridIconRegistry {
  *   ]
  * };
  * ```
+ * @since 0.8.0
  */
 declare function provideGridIcons(icons: Partial<GridIcons>): EnvironmentProviders;
 
 /**
  * Return type for injectGrid function.
+ * @since 0.6.0
  */
 interface InjectGridReturn<TRow = unknown> {
     /** Direct access to the typed grid element */
@@ -965,6 +1005,7 @@ interface InjectGridReturn<TRow = unknown> {
  *   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
  */
 declare function injectGrid<TRow = unknown>(selector?: string): InjectGridReturn<TRow>;
 
@@ -988,6 +1029,7 @@ declare function injectGrid<TRow = unknown>(selector?: string): InjectGridReturn
 
 /**
  * Feature names supported by the Grid directive.
+ * @since 0.6.0
  */
 type FeatureName = 'selection' | 'editing' | 'clipboard' | 'contextMenu' | 'multiSort' | 'filtering' | 'reorderColumns' | 'visibility' | 'pinnedColumns' | 'groupingColumns' | 'columnVirtualization' | 'reorderRows' | 'rowDragDrop' | 'groupingRows' | 'pinnedRows' | 'tree' | 'masterDetail' | 'responsive' | 'undoRedo' | 'export' | 'print' | 'pivot' | 'serverSide' | 'tooltip';
 
@@ -1040,6 +1082,7 @@ type FeatureName = 'selection' | 'editing' | 'clipboard' | 'contextMenu' | 'mult
  * `@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
  */
 declare abstract class BaseFilterPanel implements FilterPanel {
     /**
@@ -1153,6 +1196,7 @@ declare abstract class BaseFilterPanel implements FilterPanel {
  * `@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
  */
 declare abstract class BaseGridEditor<TRow = unknown, TValue = unknown> {
     protected readonly elementRef: ElementRef<any>;
@@ -1344,6 +1388,7 @@ declare abstract class BaseGridEditor<TRow = unknown, TValue = unknown> {
  * `@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
  */
 declare abstract class BaseGridEditorCVA<TRow = unknown, TValue = unknown> extends BaseGridEditor<TRow, TValue> implements ControlValueAccessor {
     /** Internal onChange callback registered by the form control. */
@@ -1410,6 +1455,7 @@ declare abstract class BaseGridEditorCVA<TRow = unknown, TValue = unknown> exten
  * - `'below-right'` — panel appears below the cell, right-aligned
  * - `'over-top-left'` — panel top-left corner aligns with cell top-left corner (opens downward)
  * - `'over-bottom-left'` — panel bottom-left corner aligns with cell bottom-left corner (opens upward)
+ * @since 0.13.0
  */
 type OverlayPosition = 'below' | 'above' | 'below-right' | 'over-top-left' | 'over-bottom-left';
 /**
@@ -1513,6 +1559,7 @@ type OverlayPosition = 'below' | 'above' | 'below-right' | 'over-top-left' | 'ov
  * 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
  */
 declare abstract class BaseOverlayEditor<TRow = unknown, TValue = unknown> extends BaseGridEditor<TRow, TValue> {
     private readonly _elementRef;
@@ -1675,6 +1722,7 @@ declare abstract class BaseOverlayEditor<TRow = unknown, TValue = unknown> exten
 /**
  * Context object passed to the cell editor template.
  * Contains the cell value, row data, column configuration, and commit/cancel functions.
+ * @since 0.1.0
  */
 interface GridEditorContext<TValue = unknown, TRow = unknown> {
     /** The cell value for this column */
@@ -1778,6 +1826,7 @@ interface GridEditorContext<TValue = unknown, TRow = unknown> {
  * 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
  */
 declare class GridColumnEditor {
     private elementRef;
@@ -1799,6 +1848,7 @@ declare class GridColumnEditor {
 /**
  * Context object passed to the cell renderer template.
  * Contains the cell value, row data, and column configuration.
+ * @since 0.1.0
  */
 interface GridCellContext<TValue = unknown, TRow = unknown> {
     /** The cell value for this column */
@@ -1845,6 +1895,7 @@ interface GridCellContext<TValue = unknown, TRow = unknown> {
  * ```
  *
  * @category Directive
+ * @since 0.1.0
  */
 declare class GridColumnView {
     private elementRef;
@@ -1892,6 +1943,7 @@ declare class GridColumnView {
  * ```
  *
  * @category Directive
+ * @since 0.13.0
  */
 declare class TbwGridColumn {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TbwGridColumn, never>;
@@ -1901,6 +1953,7 @@ declare class TbwGridColumn {
 /**
  * Context object passed to the detail renderer template.
  * Contains the row data for the expanded detail view.
+ * @since 0.1.0
  */
 interface GridDetailContext<TRow = unknown> {
     /** The row data (implicit binding for let-row) */
@@ -1911,6 +1964,7 @@ interface GridDetailContext<TRow = unknown> {
 /**
  * Gets the detail template registered for a given grid element.
  * Used by AngularGridAdapter to retrieve templates at render time.
+ * @since 0.1.0
  */
 declare function getDetailTemplate(gridElement: HTMLElement): TemplateRef<GridDetailContext> | undefined;
 /**
@@ -1961,6 +2015,7 @@ declare function getDetailTemplate(gridElement: HTMLElement): TemplateRef<GridDe
  * ```
  *
  * @category Directive
+ * @since 0.1.0
  */
 declare class GridDetailView {
     private elementRef;
@@ -1986,6 +2041,7 @@ declare class GridDetailView {
 /**
  * Context provided to the grid containing form-related information.
  * This can be accessed by other directives to get form controls.
+ * @since 0.5.0
  */
 interface FormArrayContext {
     /** Get the row data at a specific index */
@@ -2052,6 +2108,7 @@ interface FormArrayContext {
 /**
  * Gets the FormArrayContext from a grid element, if present.
  * @internal
+ * @since 0.5.0
  */
 declare function getFormArrayContext(gridElement: HTMLElement): FormArrayContext | undefined;
 /**
@@ -2120,6 +2177,7 @@ declare function getFormArrayContext(gridElement: HTMLElement): FormArrayContext
  * 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
  */
 declare class GridFormArray implements OnInit, OnDestroy {
     #private;
@@ -2184,6 +2242,7 @@ declare class GridFormArray implements OnInit, OnDestroy {
  * ```
  *
  * @category Directive
+ * @since 0.13.0
  */
 declare class TbwGridHeader {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TbwGridHeader, never>;
@@ -2193,6 +2252,7 @@ declare class TbwGridHeader {
 /**
  * Gets the FormArrayContext from a grid element, if present.
  * @internal
+ * @since 0.11.0
  */
 declare function getLazyFormContext(gridElement: HTMLElement): FormArrayContext | undefined;
 /**
@@ -2203,10 +2263,12 @@ declare function getLazyFormContext(gridElement: HTMLElement): FormArrayContext
  * @param row The row data object
  * @param rowIndex The row index in the grid
  * @returns A FormGroup for the row (only include editable fields)
+ * @since 0.11.0
  */
 type LazyFormFactory<TRow = unknown> = (row: TRow, rowIndex: number) => FormGroup;
 /**
  * Event emitted when a row's form values have changed.
+ * @since 0.11.0
  */
 interface RowFormChangeEvent<TRow = unknown> {
     /** The row index */
@@ -2306,6 +2368,7 @@ interface RowFormChangeEvent<TRow = unknown> {
  * 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
  */
 declare class GridLazyForm<TRow = unknown> implements OnInit, OnDestroy {
     #private;
@@ -2403,6 +2466,7 @@ declare class GridLazyForm<TRow = unknown> implements OnInit, OnDestroy {
  *   </ng-template>
  * </tbw-grid-responsive-card>
  * ```
+ * @since 0.4.0
  */
 interface GridResponsiveCardContext<TRow = unknown> {
     /**
@@ -2423,6 +2487,7 @@ interface GridResponsiveCardContext<TRow = unknown> {
  *
  * @param gridElement - The grid element to look up
  * @returns The template reference or undefined if not found
+ * @since 0.4.0
  */
 declare function getResponsiveCardTemplate(gridElement: HTMLElement): TemplateRef<GridResponsiveCardContext> | undefined;
 /**
@@ -2457,6 +2522,7 @@ declare function getResponsiveCardTemplate(gridElement: HTMLElement): TemplateRe
  *
  * @see ResponsivePlugin
  * @category Directive
+ * @since 0.4.0
  */
 declare class GridResponsiveCard<TRow = unknown> {
     private elementRef;
@@ -2517,6 +2583,7 @@ declare class GridResponsiveCard<TRow = unknown> {
  * ```
  *
  * @category Directive
+ * @since 0.13.0
  */
 declare class TbwGridToolButtons {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TbwGridToolButtons, never>;
@@ -2526,6 +2593,7 @@ declare class TbwGridToolButtons {
 /**
  * Context object passed to the tool panel template.
  * Provides access to grid-related information for the panel content.
+ * @since 0.1.0
  */
 interface GridToolPanelContext {
     /** The grid element (implicit binding) */
@@ -2591,6 +2659,7 @@ interface GridToolPanelContext {
  * ```
  *
  * @category Directive
+ * @since 0.1.0
  */
 declare class GridToolPanel {
     private elementRef;
@@ -2647,6 +2716,7 @@ declare class GridToolPanel {
  * const cols2 = ['id:number', 'name:string', 'email'];
  * const cols3 = [{ field: 'id' }, { field: 'name' }, { field: 'email' }];
  * ```
+ * @since 1.4.0
  */
 type ColumnShorthand<TRow = unknown> = string | ColumnConfig$1<TRow>;
 /**
@@ -2658,6 +2728,7 @@ type ColumnShorthand<TRow = unknown> = string | ColumnConfig$1<TRow>;
  *
  * @param shorthand - The shorthand string (e.g., 'name', 'salary:number')
  * @returns A ColumnConfig object
+ * @since 1.4.0
  */
 declare function parseColumnShorthand<TRow = unknown>(shorthand: string): ColumnConfig$1<TRow>;
 /**
@@ -2665,18 +2736,22 @@ declare function parseColumnShorthand<TRow = unknown>(shorthand: string): Column
  *
  * @param columns - Array of column shorthands (strings or ColumnConfig objects)
  * @returns Array of ColumnConfig objects
+ * @since 1.4.0
  */
 declare function normalizeColumns<TRow = unknown>(columns: ColumnShorthand<TRow>[]): ColumnConfig$1<TRow>[];
 /**
  * Apply column defaults to a list of columns. Individual column properties
  * override defaults.
+ * @since 1.4.0
  */
 declare function applyColumnDefaults<TRow = unknown>(columns: ColumnConfig$1<TRow>[], defaults: Partial<ColumnConfig$1<TRow>> | undefined): ColumnConfig$1<TRow>[];
-/** Check if an array of columns contains any shorthand strings. */
+/** Check if an array of columns contains any shorthand strings. * @since 1.4.0
+ */
 declare function hasColumnShorthands<TRow>(columns: ColumnShorthand<TRow>[]): boolean;
 
 /**
  * Event detail for cell commit events.
+ * @since 0.1.1
  */
 interface CellCommitEvent<TRow = unknown, TValue = unknown> {
     /** The row data object */
@@ -2696,6 +2771,7 @@ interface CellCommitEvent<TRow = unknown, TValue = unknown> {
 }
 /**
  * Event detail for row commit events (bulk editing).
+ * @since 0.1.1
  */
 interface RowCommitEvent<TRow = unknown> {
     /** The row data object */
@@ -2744,6 +2820,7 @@ interface RowCommitEvent<TRow = unknown> {
  * - Handles cleanup on destruction
  *
  * @category Directive
+ * @since 0.1.0
  */
 declare class Grid implements OnInit, AfterContentInit, OnDestroy {
     private elementRef;
@@ -3907,6 +3984,7 @@ declare class Grid implements OnInit, AfterContentInit, OnDestroy {
  * This provides better ergonomics in templates without requiring explicit type annotations.
  *
  * @internal Use `GridCellContext` in application code for stricter typing.
+ * @since 0.1.1
  */
 interface StructuralCellContext<TValue = any, TRow = any> {
     /** The cell value for this column */
@@ -3923,6 +4001,7 @@ interface StructuralCellContext<TValue = any, TRow = any> {
  * This provides better ergonomics in templates without requiring explicit type annotations.
  *
  * @internal Use `GridEditorContext` in application code for stricter typing.
+ * @since 0.1.1
  */
 interface StructuralEditorContext<TValue = any, TRow = any> {
     /** The cell value for this column */
@@ -4001,6 +4080,7 @@ interface StructuralEditorContext<TValue = any, TRow = any> {
  * ```
  *
  * @category Directive
+ * @since 0.1.1
  */
 declare class TbwRenderer implements OnDestroy {
     private template;
@@ -4076,6 +4156,7 @@ declare class TbwRenderer implements OnDestroy {
  * 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
  */
 declare class TbwEditor implements OnDestroy {
     private template;
@@ -4123,6 +4204,7 @@ declare class TbwEditor implements OnDestroy {
 
 /**
  * Options for {@link provideGrid}.
+ * @since 1.4.0
  */
 interface ProvideGridOptions {
     /** Type defaults to register globally. Equivalent to `provideGridTypeDefaults`. */
@@ -4139,6 +4221,7 @@ interface ProvideGridOptions {
  *
  * Equivalent to calling `provideGridTypeDefaults(options.typeDefaults)` and
  * `provideGridIcons(options.icons)` separately.
+ * @since 1.4.0
  */
 declare function provideGrid(options?: ProvideGridOptions): EnvironmentProviders;
 
@@ -4169,6 +4252,7 @@ declare function provideGrid(options?: ProvideGridOptions): EnvironmentProviders
  * Context passed to template bridges.
  *
  * @internal
+ * @since 1.4.0
  */
 interface TemplateBridgeContext {
     /** The `<tbw-grid>` element this directive is attached to. */
@@ -4183,6 +4267,7 @@ interface TemplateBridgeContext {
  * sequentially — they run concurrently.
  *
  * @internal
+ * @since 1.4.0
  */
 type TemplateBridge = (ctx: TemplateBridgeContext) => void | Promise<void>;
 /**
@@ -4194,6 +4279,7 @@ type TemplateBridge = (ctx: TemplateBridgeContext) => void | Promise<void>;
  * by the JS loader.
  *
  * @internal
+ * @since 1.4.0
  */
 declare function registerTemplateBridge(bridge: TemplateBridge): void;
 /**
@@ -4202,6 +4288,7 @@ declare function registerTemplateBridge(bridge: TemplateBridge): void;
  * errors thrown by one bridge do not stop the others.
  *
  * @internal
+ * @since 1.4.0
  */
 declare function runTemplateBridges(ctx: TemplateBridgeContext): void;
 /**
@@ -4215,6 +4302,7 @@ declare function runTemplateBridges(ctx: TemplateBridgeContext): void;
  * reference is fine — preprocessors typically clone-and-augment.
  *
  * @internal
+ * @since 1.4.0
  */
 type FeatureConfigPreprocessor = (config: unknown, adapter: GridAdapter) => unknown;
 /**
@@ -4223,12 +4311,14 @@ type FeatureConfigPreprocessor = (config: unknown, adapter: GridAdapter) => unkn
  * a no-op).
  *
  * @internal
+ * @since 1.4.0
  */
 declare function registerFeatureConfigPreprocessor(name: FeatureName, fn: FeatureConfigPreprocessor): void;
 /**
  * Look up the preprocessor for a feature, if any.
  *
  * @internal
+ * @since 1.4.0
  */
 declare function getFeatureConfigPreprocessor(name: FeatureName): FeatureConfigPreprocessor | undefined;
 
@@ -4268,6 +4358,7 @@ type ClaimableEventName = keyof DataGridEventMap<unknown>;
  * signal inside it establishes reactive dependency tracking — the effect
  * re-runs when the directive's input changes.
  * @internal
+ * @since 1.4.0
  */
 type FeatureConfigGetter = () => unknown;
 /**
@@ -4275,12 +4366,14 @@ type FeatureConfigGetter = () => unknown;
  * the {@link Grid} directive will then use {@link getFeatureClaim} during
  * plugin creation instead of reading its own deprecated input.
  * @internal
+ * @since 1.4.0
  */
 declare function registerFeatureClaim(grid: HTMLElement, name: FeatureName, getConfig: FeatureConfigGetter): void;
 /**
  * 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
  */
 declare function getFeatureClaim(grid: HTMLElement, name: FeatureName): FeatureConfigGetter | undefined;
 /**
@@ -4288,6 +4381,7 @@ declare function getFeatureClaim(grid: HTMLElement, name: FeatureName): FeatureC
  * 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
  */
 declare function unregisterFeatureClaim(grid: HTMLElement, name: FeatureName): void;
 /**
@@ -4295,17 +4389,20 @@ declare function unregisterFeatureClaim(grid: HTMLElement, name: FeatureName): v
  * `setupEventListeners` skips wiring its own deprecated `output()` for any
  * claimed event — the directive owns the listener and the emit.
  * @internal
+ * @since 1.4.0
  */
 declare function claimEvent(grid: HTMLElement, eventName: ClaimableEventName): void;
 /**
  * Returns true if a directive has claimed this event on this grid element.
  * @internal
+ * @since 1.4.0
  */
 declare function isEventClaimed(grid: HTMLElement, eventName: ClaimableEventName): boolean;
 /**
  * Drop an event claim. Pair with {@link claimEvent} in a directive's
  * `ngOnDestroy`.
  * @internal
+ * @since 1.4.0
  */
 declare function unclaimEvent(grid: HTMLElement, eventName: ClaimableEventName): void;