@reforgium/data-grid 2.5.4 → 3.1.0

package/types/reforgium-data-grid.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { TemplateRef, InjectionToken, EnvironmentProviders, ElementRef } from '@angular/core';
+import { TemplateRef, Signal, InjectionToken, EnvironmentProviders, ElementRef } from '@angular/core';
 import * as _reforgium_data_grid from '@reforgium/data-grid';
 
 /**
@@ -232,7 +232,7 @@ type BaseGridColumn<Data extends AnyDict = AnyDict> = {
     /**
      * Optional alternative key for sorting (if different from a display key).
      */
-    sortKey?: string;
+    sortKey?: DataKey<Data>;
     /**
      * Column header text string.
      */
@@ -550,6 +550,148 @@ declare class DataGridExpanderIconDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DataGridExpanderIconDirective, "ng-template[reDataGridExpanderIcon]", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * Event emitted when pagination changes in the data grid.
+ *
+ * Contains information about the current page, page size, and optional sorting parameters.
+ * Property names are compatible with PrimeNG table component conventions.
+ */
+type GridPageChangeEvent = {
+    page: number;
+    /** `pageSize`, named `rows` for compatibility with PrimeNG */
+    rows: number;
+    /** for compatibility with PrimeNG */
+    sortField?: string;
+    /** for compatibility with PrimeNG */
+    sortOrder?: GridSortOrder;
+};
+/**
+ * Event emitted when column sorting changes in the data grid.
+ *
+ * Contains information about the sorted column key and the sort direction.
+ * The `key` property is type-safe and corresponds to actual data object keys.
+ *
+ * @template Data - Type of data objects in the grid
+ */
+type GridSortEvent<Data = AnyDict> = {
+    sort?: DataKey<Data>;
+    order?: GridSortOrder;
+};
+/**
+ * Single sort item used for multi-column sorting.
+ *
+ * @template Data - Type of data objects in the grid
+ */
+type GridSortItem<Data = AnyDict> = {
+    sort: DataKey<Data>;
+    order: GridSortOrder;
+};
+/**
+ * Event emitted when multi-column sorting changes in the data grid.
+ *
+ * Contains an ordered list of sort items, where the order reflects
+ * the priority of sorting (first item has highest priority).
+ *
+ * @template Data - Type of data objects in the grid
+ */
+type GridMultiSortEvent<Data = AnyDict> = {
+    sort: ReadonlyArray<GridSortItem<Data>>;
+};
+/**
+ * Event emitted when row selection changes in the data grid.
+ *
+ * Contains an array of selected values, which can be either string identifiers
+ * or actual data values from the specified key column.
+ *
+ * @template Data - Type of data objects in the grid
+ */
+type GridSelectEvent<Data extends AnyDict = AnyDict> = {
+    selected: (string | Data[DataKey<Data>])[];
+};
+/**
+ * Event emitted when a row is clicked in the data grid.
+ *
+ * Provides access to the clicked row's data object and its numeric index position
+ * within the current grid data set.
+ *
+ * @template Data - Type of data objects in the grid
+ */
+type GridRowClickEvent<Data extends AnyDict = AnyDict> = {
+    row: Data;
+    index: number;
+    event: Event;
+};
+/**
+ * Event emitted when a specific cell is clicked in the data grid.
+ *
+ * Provides detailed information about the clicked cell, including the row data,
+ * column configuration, and the row's numeric index position.
+ *
+ * @template Data - Type of data objects in the grid
+ */
+type GridCellClickEvent<Data extends AnyDict = AnyDict> = {
+    row: Data;
+    col: GridColumn<Data>;
+    index: number;
+    event: Event;
+};
+/**
+ * Event emitted when a row is right-clicked (context menu) in the data grid.
+ *
+ * Provides access to the clicked row's data object, its index, and the native mouse event.
+ */
+type GridRowContextEvent<Data extends AnyDict = AnyDict> = {
+    row: Data;
+    index: number;
+    event: MouseEvent;
+};
+/**
+ * Event emitted when a specific cell is right-clicked (context menu) in the data grid.
+ *
+ * Provides access to the clicked cell, row data, index, and the native mouse event.
+ */
+type GridCellContextEvent<Data extends AnyDict = AnyDict> = {
+    row: Data;
+    col: GridColumn<Data>;
+    index: number;
+    event: MouseEvent;
+};
+/**
+ * Event emitted when a row is double-clicked in the data grid.
+ *
+ * Provides access to the clicked row's data object, its index, and the native mouse event.
+ */
+type GridRowDoubleClickEvent<Data extends AnyDict = AnyDict> = {
+    row: Data;
+    index: number;
+    event: MouseEvent;
+};
+/**
+ * Event emitted when a specific cell is double-clicked in the data grid.
+ *
+ * Provides access to the clicked cell, row data, index, and the native mouse event.
+ */
+type GridCellDoubleClickEvent<Data extends AnyDict = AnyDict> = {
+    row: Data;
+    col: GridColumn<Data>;
+    index: number;
+    event: MouseEvent;
+};
+/**
+ * Event emitted when a column resize drag ends in the data grid.
+ *
+ * Provides the column key and the final pixel width after the user releases the resize handle.
+ * Use this to persist column widths (e.g. to localStorage or a user preferences API).
+ *
+ * @template Data - Type of data objects in the grid
+ */
+type GridColumnResizeEndEvent<Data extends AnyDict = AnyDict> = {
+    /** Key of the resized column. */
+    key: DataKey<Data>;
+    /** Final column width in pixels. */
+    width: number;
+};
+
 /**
  * Defines how pagination is displayed and handled in the data grid.
  *
@@ -595,6 +737,51 @@ type GridSortOrder = 'asc' | 'desc';
  * @template Data - Type of data objects displayed in the grid rows
  */
 type GridPinnedRows<Data extends AnyDict = AnyDict> = GridPinnedRow<Data>[];
+/**
+ * Page-oriented source contract for grids that fetch data externally.
+ *
+ * Intended for pagination/infinity scenarios where the grid should request pages
+ * directly instead of receiving one ever-growing accumulated array.
+ *
+ * @template Data - Type of data objects displayed in the grid rows
+ */
+interface GridPagedDataSource<Data extends AnyDict = AnyDict> {
+    /** Current page payload. */
+    items: Signal<Data[]>;
+    /** Loading flag of the current request lifecycle. */
+    loading: Signal<boolean>;
+    /** Optional last request error. */
+    error?: Signal<unknown | null>;
+    /** Current page index (0-based). */
+    page: number;
+    /** Current page size. */
+    pageSize: number;
+    /**
+     * Total number of rows available in the dataset.
+     *
+     * Optional in infinity mode. When omitted, the grid treats the dataset as open-ended
+     * until it receives a short page (`items.length < pageSize`) and then fixes the final size.
+     */
+    totalElements?: number;
+    /** Optional dataset revision signal. Increment to force the grid to clear its local page buffer. */
+    version?: Signal<number>;
+    /** Current source-side sort state. */
+    sort?: ReadonlyArray<GridSortItem<Data>>;
+    /**
+     * Optional prefetch strategy for infinity mode page buffering.
+     * - `sequential` (default) is safest for latest-wins sources such as `PagedQueryStore`
+     * - `parallel` warms nearby pages faster when the source supports concurrent `updatePage(...)` calls
+     */
+    prefetchMode?: 'sequential' | 'parallel';
+    /** Load a specific page. */
+    updatePage: (page: number) => Promise<unknown>;
+    /** Update page size and load the first page. */
+    updatePageSize?: (size: number) => Promise<unknown>;
+    /** Update single-column sort and refresh the source. */
+    updateSort?: (sort?: GridSortItem<Data> | null) => Promise<unknown>;
+    /** Update multi-column sort and refresh the source. */
+    updateSorts?: (sort?: ReadonlyArray<GridSortItem<Data>> | null) => Promise<unknown>;
+}
 /**
  * Union type representing grid selection configuration.
  *
@@ -663,6 +850,57 @@ type GridPinnedRow<Data extends AnyDict = AnyDict> = {
     }>;
 };
 
+type HeaderTitleContent = {
+    title: string;
+    titleTemplate?: TemplateRef<HeaderTemplateData>;
+} | {
+    title?: string;
+    titleTemplate: TemplateRef<HeaderTemplateData>;
+};
+type HeaderPresentation = {
+    align?: GridCellAlign;
+};
+/**
+ * Defines a header group configuration for grouping multiple columns under a single header.
+ *
+ * @template Data - The data type of the grid rows
+ *
+ * @property {string} key - Unique identifier for the header group
+ * @property {DataKey<Data>} from - The starting column key where the header group begins
+ * @property {DataKey<Data>} [to] - Optional ending column key where the header group ends.
+ *  If not provided, the group spans only the 'from' column
+ * @property {string} [title] - Plain text title for the header group (when using PlainHeader)
+ * @property {GridCellAlign} [align] - Text alignment for the header group title (when using PlainHeader)
+ * @property {TemplateRef<HeaderTemplateData>} [titleTemplate] - Custom template for rendering the header group title
+ *  (when using TemplatedHeader)
+ */
+type GridHeaderGroup<Data extends AnyDict = AnyDict> = {
+    key: string;
+    from: DataKey<Data>;
+    to?: DataKey<Data>;
+} & HeaderTitleContent & HeaderPresentation;
+/**
+ * Internal normalized representation of a header group after processing.
+ * Used by the grid component to render header groups with calculated dimensions.
+ *
+ * @property {string} key - Unique identifier for the normalized header
+ * @property {string} [title] - Plain text title for the header
+ * @property {TemplateRef<HeaderTemplateData>} [titleTemplate] - Custom template for rendering the header title
+ * @property {GridCellAlign} [align] - Text alignment for the header title
+ * @property {number} widthPx - Calculated width of the header in pixels
+ * @property {string} [startKey] - Column key where the header group starts
+ * @property {string} [endKey] - Column key where the header group ends
+ */
+type NormalizedHeader = {
+    key: string;
+    title?: string;
+    titleTemplate?: TemplateRef<HeaderTemplateData>;
+    align?: GridCellAlign;
+    widthPx: number;
+    startKey?: string;
+    endKey?: string;
+};
+
 type DataGridTranslations = {
     emptyState: string;
     itemsPerPageLabel: string;
@@ -730,8 +968,19 @@ declare const DEFAULT_DATA_GRID_DEFAULTS: DataGridConfigProvider;
 declare const DATA_GRID_CONFIG: InjectionToken<DataGridConfigProvider>;
 type DataGridTypeTransformers<Data extends AnyDict = AnyDict> = Partial<Record<GridCellRendererType, GridCellTransformer<Data>>>;
 type DataGridTypeRenderers<Data extends AnyDict = AnyDict> = Partial<Record<GridCellRendererType, TemplateRef<RenderTemplateData<Data>>>>;
+type DataGridHeaderTextContext<Data extends AnyDict = AnyDict> = {
+    kind: 'column';
+    column: GridColumn<Data>;
+} | {
+    kind: 'group';
+    group: NormalizedHeader | Pick<NormalizedHeader, 'key' | 'title' | 'align'> | {
+        title?: string;
+    };
+};
+type DataGridHeaderTextResolver<Data extends AnyDict = AnyDict> = (text: string, context: DataGridHeaderTextContext<Data>) => string | Signal<string>;
 declare const DATA_GRID_TYPE_TRANSFORMERS: InjectionToken<Partial<Record<string, GridCellTransformer<AnyDict>>>>;
 declare const DATA_GRID_TYPE_RENDERERS: InjectionToken<Partial<Record<string, TemplateRef<RenderTemplateData<AnyDict>>>>>;
+declare const DATA_GRID_HEADER_TEXT_RESOLVER: InjectionToken<DataGridHeaderTextResolver<AnyDict>>;
 /**
  * Provides a default configuration for Data Grid, overriding base settings.
  *
@@ -751,189 +1000,24 @@ declare function provideDataGridTypeTransformers<Data extends AnyDict = AnyDict>
  * Registrations are merged with parent injector registrations, and later providers override earlier ones.
  */
 declare function provideDataGridTypeRenderers<Data extends AnyDict = AnyDict>(renderers: DataGridTypeRenderers<Data>): EnvironmentProviders;
-
-type DeclarativeColumnsResult<Data extends AnyDict = AnyDict> = {
-    columns: GridColumns<Data>;
-    rowCellTemplatesByKey: Map<string, TemplateRef<AnyType>>;
-};
-
-/**
- * Event emitted when pagination changes in the data grid.
- *
- * Contains information about the current page, page size, and optional sorting parameters.
- * Property names are compatible with PrimeNG table component conventions.
- */
-type GridPageChangeEvent = {
-    page: number;
-    /** `pageSize`, named `rows` for compatibility with PrimeNG */
-    rows: number;
-    /** for compatibility with PrimeNG */
-    sortField?: string;
-    /** for compatibility with PrimeNG */
-    sortOrder?: GridSortOrder;
-};
-/**
- * Event emitted when column sorting changes in the data grid.
- *
- * Contains information about the sorted column key and the sort direction.
- * The `key` property is type-safe and corresponds to actual data object keys.
- *
- * @template Data - Type of data objects in the grid
- */
-type GridSortEvent<Data = AnyDict> = {
-    key: DataKey<Data>;
-    order?: GridSortOrder;
-};
 /**
- * Single sort item used for multi-column sorting.
+ * Provides a global header text resolver for all `re-data-grid` instances in the current injector scope.
  *
- * @template Data - Type of data objects in the grid
+ * Useful for integrating i18n layers without coupling the grid package to a specific translation library.
+ * The factory runs in Angular DI context, so it may use `inject(...)` to access consumer-side services.
  */
-type GridSortItem<Data = AnyDict> = {
-    key: DataKey<Data>;
-    order: GridSortOrder;
-};
+declare function provideDataGridHeaderTextResolver<Data extends AnyDict = AnyDict>(factory: () => DataGridHeaderTextResolver<Data>): EnvironmentProviders;
 /**
- * Event emitted when multi-column sorting changes in the data grid.
+ * Advanced variant of `provideDataGridHeaderTextResolver(...)` that composes with the parent injector resolver.
  *
- * Contains an ordered list of sort items, where the order reflects
- * the priority of sorting (first item has highest priority).
- *
- * @template Data - Type of data objects in the grid
- */
-type GridMultiSortEvent<Data = AnyDict> = {
-    sorts: ReadonlyArray<GridSortItem<Data>>;
-};
-/**
- * Event emitted when row selection changes in the data grid.
- *
- * Contains an array of selected values, which can be either string identifiers
- * or actual data values from the specified key column.
- *
- * @template Data - Type of data objects in the grid
- */
-type GridSelectEvent<Data extends AnyDict = AnyDict> = {
-    selected: (string | Data[DataKey<Data>])[];
-};
-/**
- * Event emitted when a row is clicked in the data grid.
- *
- * Provides access to the clicked row's data object and its numeric index position
- * within the current grid data set.
- *
- * @template Data - Type of data objects in the grid
- */
-type GridRowClickEvent<Data extends AnyDict = AnyDict> = {
-    row: Data;
-    index: number;
-    event: Event;
-};
-/**
- * Event emitted when a specific cell is clicked in the data grid.
- *
- * Provides detailed information about the clicked cell, including the row data,
- * column configuration, and the row's numeric index position.
- *
- * @template Data - Type of data objects in the grid
- */
-type GridCellClickEvent<Data extends AnyDict = AnyDict> = {
-    row: Data;
-    col: GridColumn<Data>;
-    index: number;
-    event: Event;
-};
-/**
- * Event emitted when a row is right-clicked (context menu) in the data grid.
- *
- * Provides access to the clicked row's data object, its index, and the native mouse event.
+ * Use this only when the current scope should extend or wrap an existing header resolver
+ * instead of replacing it completely.
  */
-type GridRowContextEvent<Data extends AnyDict = AnyDict> = {
-    row: Data;
-    index: number;
-    event: MouseEvent;
-};
-/**
- * Event emitted when a specific cell is right-clicked (context menu) in the data grid.
- *
- * Provides access to the clicked cell, row data, index, and the native mouse event.
- */
-type GridCellContextEvent<Data extends AnyDict = AnyDict> = {
-    row: Data;
-    col: GridColumn<Data>;
-    index: number;
-    event: MouseEvent;
-};
-/**
- * Event emitted when a row is double-clicked in the data grid.
- *
- * Provides access to the clicked row's data object, its index, and the native mouse event.
- */
-type GridRowDoubleClickEvent<Data extends AnyDict = AnyDict> = {
-    row: Data;
-    index: number;
-    event: MouseEvent;
-};
-/**
- * Event emitted when a specific cell is double-clicked in the data grid.
- *
- * Provides access to the clicked cell, row data, index, and the native mouse event.
- */
-type GridCellDoubleClickEvent<Data extends AnyDict = AnyDict> = {
-    row: Data;
-    col: GridColumn<Data>;
-    index: number;
-    event: MouseEvent;
-};
+declare function provideDataGridHeaderTextResolverWithParent<Data extends AnyDict = AnyDict>(factory: (parent: DataGridHeaderTextResolver<Data>) => DataGridHeaderTextResolver<Data>): EnvironmentProviders;
 
-type HeaderTitleContent = {
-    title: string;
-    titleTemplate?: TemplateRef<HeaderTemplateData>;
-} | {
-    title?: string;
-    titleTemplate: TemplateRef<HeaderTemplateData>;
-};
-type HeaderPresentation = {
-    align?: GridCellAlign;
-};
-/**
- * Defines a header group configuration for grouping multiple columns under a single header.
- *
- * @template Data - The data type of the grid rows
- *
- * @property {string} key - Unique identifier for the header group
- * @property {DataKey<Data>} from - The starting column key where the header group begins
- * @property {DataKey<Data>} [to] - Optional ending column key where the header group ends.
- *  If not provided, the group spans only the 'from' column
- * @property {string} [title] - Plain text title for the header group (when using PlainHeader)
- * @property {GridCellAlign} [align] - Text alignment for the header group title (when using PlainHeader)
- * @property {TemplateRef<HeaderTemplateData>} [titleTemplate] - Custom template for rendering the header group title
- *  (when using TemplatedHeader)
- */
-type GridHeaderGroup<Data extends AnyDict = AnyDict> = {
-    key: string;
-    from: DataKey<Data>;
-    to?: DataKey<Data>;
-} & HeaderTitleContent & HeaderPresentation;
-/**
- * Internal normalized representation of a header group after processing.
- * Used by the grid component to render header groups with calculated dimensions.
- *
- * @property {string} key - Unique identifier for the normalized header
- * @property {string} [title] - Plain text title for the header
- * @property {TemplateRef<HeaderTemplateData>} [titleTemplate] - Custom template for rendering the header title
- * @property {GridCellAlign} [align] - Text alignment for the header title
- * @property {number} widthPx - Calculated width of the header in pixels
- * @property {string} [startKey] - Column key where the header group starts
- * @property {string} [endKey] - Column key where the header group ends
- */
-type NormalizedHeader = {
-    key: string;
-    title?: string;
-    titleTemplate?: TemplateRef<HeaderTemplateData>;
-    align?: GridCellAlign;
-    widthPx: number;
-    startKey?: string;
-    endKey?: string;
+type DeclarativeColumnsResult<Data extends AnyDict = AnyDict> = {
+    columns: GridColumns<Data>;
+    rowCellTemplatesByKey: Map<string, TemplateRef<AnyType>>;
 };
 
 /**
@@ -1208,7 +1292,10 @@ type TooltipState = {
  * ```
  */
 declare class DataGrid<Data extends AnyDict> {
+    private static nextAriaId;
     protected defaults: _reforgium_data_grid.DataGridConfigProvider;
+    protected headerTextResolver: DataGridHeaderTextResolver<Data>;
+    private resolvedHeaderTextCache;
     /**
      * Array of data to display in the table.
      *
@@ -1216,6 +1303,14 @@ declare class DataGrid<Data extends AnyDict> {
      * only visible rows using virtual scrolling.
      */
     data: _angular_core.InputSignal<Data[]>;
+    /**
+     * Optional page-oriented source for direct grid/store integration.
+     *
+     * When provided, the grid reads rows from the source, requests pages directly,
+     * and in infinity mode keeps its own internal page buffer instead of requiring
+     * an ever-growing accumulated `data` array from the parent.
+     */
+    source: _angular_core.InputSignal<GridPagedDataSource<Data> | null>;
     /**
      * Column configuration for the table.
      *
@@ -1378,7 +1473,7 @@ declare class DataGrid<Data extends AnyDict> {
      * @example
      * ```typescript
      * onSortChange(event: GridSortEvent<User>) {
-     *   this.data = sortBy(this.data, event.key, event.order);
+     *   this.data = sortBy(this.data, event.sort, event.order);
      * }
      * ```
      */
@@ -1427,6 +1522,11 @@ declare class DataGrid<Data extends AnyDict> {
      * Contains the clicked row, column configuration, row index, and the native mouse event.
      */
     cellDoubleClick: _angular_core.OutputEmitterRef<GridCellDoubleClickEvent<Data>>;
+    /**
+     * Emitted when the user finishes resizing a column (on mouseup).
+     * Use this to persist column widths across sessions.
+     */
+    columnResizeEnd: _angular_core.OutputEmitterRef<GridColumnResizeEndEvent<Data>>;
     vm: DataGridVm<Data>;
     selector: Selector<Data>;
     private sortFeature;
@@ -1438,11 +1538,13 @@ declare class DataGrid<Data extends AnyDict> {
     private selectionReconcileFeature;
     private gridApiFeature;
     private tooltipAdapterFeature;
+    private sourceDataFeature;
     private virtualScrollFeature;
     private resizeObserverFeature;
     private scrollLoopFeature;
     private lifecycleInitFeature;
     private stickyOrchestrationFeature;
+    private gapLoaderFeature;
     private headerMeasureFeature;
     private selectionFeatureRef?;
     private selectionFeaturePromise?;
@@ -1466,12 +1568,12 @@ declare class DataGrid<Data extends AnyDict> {
     private expanderIcSlotRefs;
     private stickyRowSlotRefs;
     private rowSlotRefs;
-    protected emptyTpl: _angular_core.Signal<DataGridCellEmptyDirective | undefined>;
-    protected loadingTpl: _angular_core.Signal<DataGridCellLoadingDirective>;
-    protected sortTpl: _angular_core.Signal<DataGridSortIconDirective | undefined>;
-    protected expanderTpl: _angular_core.Signal<DataGridExpanderIconDirective | undefined>;
-    protected stickyRowTpl: _angular_core.Signal<DataGridStickyRowDirective<any> | undefined>;
-    protected rowTpl: _angular_core.Signal<DataGridRowDirective<any> | undefined>;
+    protected emptyTpl: Signal<DataGridCellEmptyDirective | undefined>;
+    protected loadingTpl: Signal<DataGridCellLoadingDirective>;
+    protected sortTpl: Signal<DataGridSortIconDirective | undefined>;
+    protected expanderTpl: Signal<DataGridExpanderIconDirective | undefined>;
+    protected stickyRowTpl: Signal<DataGridStickyRowDirective<any> | undefined>;
+    protected rowTpl: Signal<DataGridRowDirective<any> | undefined>;
     protected renderSlots: _angular_core.WritableSignal<number[]>;
     protected renderCount: number;
     private lastStartIndex;
@@ -1480,21 +1582,30 @@ declare class DataGrid<Data extends AnyDict> {
     protected headerHeight: _angular_core.WritableSignal<number>;
     private tooltipEl;
     protected tooltipState: _angular_core.WritableSignal<TooltipState>;
+    protected activeTooltipCellId: _angular_core.WritableSignal<string | null>;
+    protected readonly tooltipId: string;
+    protected readonly expanderRegionId: string;
     protected stickyRowIndex: _angular_core.WritableSignal<number | null>;
     protected stickyRowTopPx: _angular_core.WritableSignal<number>;
-    protected stickyRowData: _angular_core.Signal<Data | null>;
+    protected stickyRowData: Signal<Data | null>;
     private stickyIndexes;
     private contentInitialized;
     protected isColumnResizing: _angular_core.WritableSignal<boolean>;
     protected expanderMap: _angular_core.WritableSignal<Map<DataKey<Data>, boolean>>;
-    protected declarativeColumns: _angular_core.Signal<DeclarativeColumnsResult<Data>>;
-    protected sourceColumns: _angular_core.Signal<GridColumn<Data>[]>;
+    protected declarativeColumns: Signal<DeclarativeColumnsResult<Data>>;
+    protected sourceColumns: Signal<GridColumn<Data>[]>;
     private slotsFeature;
-    protected extendedColumns: _angular_core.Signal<GridColumn<Data>[]>;
+    protected extendedColumns: Signal<GridColumn<Data>[]>;
     /**
      * Computed CSS height value based on height setting.
      */
-    styleHeight: _angular_core.Signal<string>;
+    styleHeight: Signal<string>;
+    protected resolvedLoading: Signal<boolean>;
+    protected totalRowCount: Signal<number>;
+    protected selectionRows: Signal<Data[]>;
+    protected ariaColCount: Signal<number>;
+    protected ariaHeaderRowCount: Signal<number>;
+    protected ariaRowCount: Signal<number>;
     private hideSbTimeout?;
     private scrollbarRafId;
     private stickyRafId;
@@ -1502,7 +1613,7 @@ declare class DataGrid<Data extends AnyDict> {
     currentSortOrder: GridSortOrder;
     currentSorts: GridSortItem<Data>[];
     private currentSortMap;
-    private subscription;
+    private cleanupCallbacks;
     constructor();
     /** Clears current selection and emits `selectChange`. */
     clearSelection(): void;
@@ -1589,8 +1700,42 @@ declare class DataGrid<Data extends AnyDict> {
     protected isActiveSort(col: GridColumn<Data>): boolean;
     protected showTooltip(event: MouseEvent, row: Data, col: GridColumn<Data>, index: number): void;
     protected hideTooltip(): void;
+    protected onTooltipEnter(event: MouseEvent, row: Data, col: GridColumn<Data>, index: number, cellId: string): void;
     protected isStickyRowIndex(index: number): boolean;
     protected resolveRowTemplate(row: Data, index: number): TemplateRef<AnyType> | null;
+    protected rowAt(index: number): Data | null;
+    protected shouldRenderLoadingRow(index: number, topGap: {
+        start: number;
+        count: number;
+    } | null, bottomGap: {
+        start: number;
+        count: number;
+    } | null): boolean;
+    protected topGapLoader(): {
+        start: number;
+        count: number;
+    } | null;
+    protected bottomGapLoader(): {
+        start: number;
+        count: number;
+    } | null;
+    protected resolveHeaderText(col: GridColumn<Data>): string;
+    protected ariaDataRowIndex(index: number): number;
+    protected ariaPinnedTopRowIndex(index: number): number;
+    protected ariaPinnedBottomRowIndex(index: number): number;
+    protected ariaSortLabel(col: GridColumn<Data>): string;
+    protected ariaExpandLabel(col: GridColumn<Data>): string;
+    protected ariaResizeLabel(col: GridColumn<Data>): string;
+    protected ariaHeaderGroupColIndex(group: NormalizedHeader): number | null;
+    protected cellAriaId(colKey: string, rowIndex: number, isPinned: boolean): string;
+    protected isTooltipTarget(cellId: string): boolean;
+    protected resolveHeaderGroupTitle(group: GridHeaderGroup<Data>): string;
+    protected resolveHeaderGroupTitle(group: {
+        title?: string;
+    }): string;
+    private readResolvedHeaderText;
+    private activePageSize;
+    private requestPage;
     private initVm;
     private initSelector;
     private initRefs;
@@ -1599,6 +1744,7 @@ declare class DataGrid<Data extends AnyDict> {
     private initObserver;
     private initExpander;
     private setCurrentSorts;
+    private syncSortFromSource;
     private loadSelectionFeature;
     private loadTooltipFeature;
     private loadOverlayScrollFeature;
@@ -1613,9 +1759,9 @@ declare class DataGrid<Data extends AnyDict> {
     private updateStickyRow;
     private updateStickyFromScroll;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DataGrid<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DataGrid<any>, "re-data-grid", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "pinnedRows": { "alias": "pinnedRows"; "required": false; "isSignal": true; }; "isRowSticky": { "alias": "isRowSticky"; "required": false; "isSignal": true; }; "isRowDisabled": { "alias": "isRowDisabled"; "required": false; "isSignal": true; }; "getRowTemplate": { "alias": "getRowTemplate"; "required": false; "isSignal": true; }; "hasIndexColumn": { "alias": "hasIndexColumn"; "required": false; "isSignal": true; }; "selection": { "alias": "selection"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "rowHeight": { "alias": "rowHeight"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "virtualBuffer": { "alias": "virtualBuffer"; "required": false; "isSignal": true; }; "lockVerticalScroll": { "alias": "lockVerticalScroll"; "required": false; "isSignal": true; }; "headerGroups": { "alias": "headerGroups"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "loadingMode": { "alias": "loadingMode"; "required": false; "isSignal": true; }; "deferContent": { "alias": "deferContent"; "required": false; "isSignal": true; }; "deferHeader": { "alias": "deferHeader"; "required": false; "isSignal": true; }; "deferPinned": { "alias": "deferPinned"; "required": false; "isSignal": true; }; "deferCells": { "alias": "deferCells"; "required": false; "isSignal": true; }; "deferIcons": { "alias": "deferIcons"; "required": false; "isSignal": true; }; "deferTooltip": { "alias": "deferTooltip"; "required": false; "isSignal": true; }; "rowKey": { "alias": "rowKey"; "required": false; "isSignal": true; }; "pageStartFromZero": { "alias": "pageStartFromZero"; "required": false; "isSignal": true; }; "sortMode": { "alias": "sortMode"; "required": false; "isSignal": true; }; }, { "pageChange": "pageChange"; "sortChange": "sortChange"; "multiSortChange": "multiSortChange"; "selectChange": "selectChange"; "rowClick": "rowClick"; "rowContext": "rowContext"; "rowDoubleClick": "rowDoubleClick"; "cellClick": "cellClick"; "cellContext": "cellContext"; "cellDoubleClick": "cellDoubleClick"; }, ["cellTypedSlotRefs", "cellDataSlotRefs", "declarativeColumnRefs", "headerSlotRefs", "emptySlotRefs", "loadingSlotRefs", "sortIcSlotRefs", "expanderIcSlotRefs", "stickyRowSlotRefs", "rowSlotRefs"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DataGrid<any>, "re-data-grid", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "source": { "alias": "source"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "pinnedRows": { "alias": "pinnedRows"; "required": false; "isSignal": true; }; "isRowSticky": { "alias": "isRowSticky"; "required": false; "isSignal": true; }; "isRowDisabled": { "alias": "isRowDisabled"; "required": false; "isSignal": true; }; "getRowTemplate": { "alias": "getRowTemplate"; "required": false; "isSignal": true; }; "hasIndexColumn": { "alias": "hasIndexColumn"; "required": false; "isSignal": true; }; "selection": { "alias": "selection"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "rowHeight": { "alias": "rowHeight"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "virtualBuffer": { "alias": "virtualBuffer"; "required": false; "isSignal": true; }; "lockVerticalScroll": { "alias": "lockVerticalScroll"; "required": false; "isSignal": true; }; "headerGroups": { "alias": "headerGroups"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "loadingMode": { "alias": "loadingMode"; "required": false; "isSignal": true; }; "deferContent": { "alias": "deferContent"; "required": false; "isSignal": true; }; "deferHeader": { "alias": "deferHeader"; "required": false; "isSignal": true; }; "deferPinned": { "alias": "deferPinned"; "required": false; "isSignal": true; }; "deferCells": { "alias": "deferCells"; "required": false; "isSignal": true; }; "deferIcons": { "alias": "deferIcons"; "required": false; "isSignal": true; }; "deferTooltip": { "alias": "deferTooltip"; "required": false; "isSignal": true; }; "rowKey": { "alias": "rowKey"; "required": false; "isSignal": true; }; "pageStartFromZero": { "alias": "pageStartFromZero"; "required": false; "isSignal": true; }; "sortMode": { "alias": "sortMode"; "required": false; "isSignal": true; }; }, { "pageChange": "pageChange"; "sortChange": "sortChange"; "multiSortChange": "multiSortChange"; "selectChange": "selectChange"; "rowClick": "rowClick"; "rowContext": "rowContext"; "rowDoubleClick": "rowDoubleClick"; "cellClick": "cellClick"; "cellContext": "cellContext"; "cellDoubleClick": "cellDoubleClick"; "columnResizeEnd": "columnResizeEnd"; }, ["cellTypedSlotRefs", "cellDataSlotRefs", "declarativeColumnRefs", "headerSlotRefs", "emptySlotRefs", "loadingSlotRefs", "sortIcSlotRefs", "expanderIcSlotRefs", "stickyRowSlotRefs", "rowSlotRefs"], never, true, never>;
 }
 
-export { DATA_GRID_CONFIG, DATA_GRID_TYPE_RENDERERS, DATA_GRID_TYPE_TRANSFORMERS, DEFAULT_DATA_GRID_DEFAULTS, DataGrid, DataGridCellEmptyDirective, DataGridCellLoadingDirective, DataGridCellTemplateDirective, DataGridDeclarativeCellDirective, DataGridDeclarativeColumn, DataGridDeclarativeHeaderDirective, DataGridExpanderIconDirective, DataGridHeaderTemplateDirective, DataGridRowDirective, DataGridSortIconDirective, DataGridStickyRowDirective, DataGridTypeCellTemplateDirective, provideDataGridDefaults, provideDataGridTypeRenderers, provideDataGridTypeTransformers };
-export type { BaseGridColumn, DataGridConfigProvider, DataGridRowTemplateContext, DataGridStickyRowTemplateContext, DataGridTypeRenderers, DataGridTypeTransformers, DeclarativeColumnDef, GridBuiltInCellType, GridCellAlign, GridCellClickEvent, GridCellContextEvent, GridCellDoubleClickEvent, GridCellRenderer, GridCellRendererType, GridCellTransformer, GridCellTransformerContext, GridCellValueContext, GridColumn, GridColumnTooltip, GridColumns, GridHeaderGroup, GridMultiSortEvent, GridPageChangeEvent, GridPaginationMode, GridPinnedPosition, GridPinnedRow, GridPinnedRows, GridRowClickEvent, GridRowContextEvent, GridRowDoubleClickEvent, GridSelectEvent, GridSelectMode, GridSelection, GridSortEvent, GridSortItem, GridSortMode, GridSortOrder, GridStickySide, GridTooltipContext, HeaderTemplateData, RenderTemplateData };
+export { DATA_GRID_CONFIG, DATA_GRID_HEADER_TEXT_RESOLVER, DATA_GRID_TYPE_RENDERERS, DATA_GRID_TYPE_TRANSFORMERS, DEFAULT_DATA_GRID_DEFAULTS, DataGrid, DataGridCellEmptyDirective, DataGridCellLoadingDirective, DataGridCellTemplateDirective, DataGridDeclarativeCellDirective, DataGridDeclarativeColumn, DataGridDeclarativeHeaderDirective, DataGridExpanderIconDirective, DataGridHeaderTemplateDirective, DataGridRowDirective, DataGridSortIconDirective, DataGridStickyRowDirective, DataGridTypeCellTemplateDirective, provideDataGridDefaults, provideDataGridHeaderTextResolver, provideDataGridHeaderTextResolverWithParent, provideDataGridTypeRenderers, provideDataGridTypeTransformers };
+export type { BaseGridColumn, DataGridConfigProvider, DataGridHeaderTextContext, DataGridHeaderTextResolver, DataGridRowTemplateContext, DataGridStickyRowTemplateContext, DataGridTypeRenderers, DataGridTypeTransformers, DeclarativeColumnDef, GridBuiltInCellType, GridCellAlign, GridCellClickEvent, GridCellContextEvent, GridCellDoubleClickEvent, GridCellRenderer, GridCellRendererType, GridCellTransformer, GridCellTransformerContext, GridCellValueContext, GridColumn, GridColumnResizeEndEvent, GridColumnTooltip, GridColumns, GridHeaderGroup, GridMultiSortEvent, GridPageChangeEvent, GridPagedDataSource, GridPaginationMode, GridPinnedPosition, GridPinnedRow, GridPinnedRows, GridRowClickEvent, GridRowContextEvent, GridRowDoubleClickEvent, GridSelectEvent, GridSelectMode, GridSelection, GridSortEvent, GridSortItem, GridSortMode, GridSortOrder, GridStickySide, GridTooltipContext, HeaderTemplateData, RenderTemplateData };
 //# sourceMappingURL=reforgium-data-grid.d.ts.map