@reforgium/data-grid 2.5.4 → 3.1.0

package/CHANGELOG.md

@@ -0,0 +1,310 @@
+## [3.1.0]: 02.04.2026
+
+### Feat:
+- `DataGrid`: added `columnResizeEnd` output (`GridColumnResizeEndEvent`) — emits the column key and final pixel width when the user finishes a resize drag; use this to persist column widths
+
+### Fix:
+- `DataGrid`: multi-sort — `sortOrder` was left stale (`'desc'`) after removing a sort key because `setSortOrder` was only called when `activeOrder` was truthy; now always resets to `'asc'` when no active order
+- `DataGrid`: multi-sort — `sortField` was not cleared after removing the last sort key, leaving a stale pointer to a column with no active sort; `sortField` is now set to `undefined` when `sorts` becomes empty
+- `DataGrid`: column layout — `roundAndFix` could leave a visual gap when all auto-sized columns had reached their `maxWidth`; remaining rounding pixels are now distributed even if `maxWidth` is exceeded by 1 px each (sub-pixel correction, not a layout concern)
+- `DataGrid`: infinity source parallel prefetch — page data captured in `.then()` immediately on response to prevent Angular effect batching from discarding a page when multiple requests settle before the next effect tick
+- `DataGrid`: infinity source — stale `updatePage()` responses no longer corrupt the buffer; a generation counter is bumped on every `clearBuffer()` and `clearQueue()`, and `.then()` skips writing if the generation has advanced (e.g. source version change, source swap, `clearState`)
+- `DataGrid`: tooltip — first `mouseenter` on a column with `tooltip` was silently dropped when the tooltip feature had not yet been lazy-loaded; the hover args are now retained and forwarded once the feature resolves; hover cancelled before load resolves is correctly discarded
+- `DataGrid`: selection reconcile — `selectChange` was not emitted when the grid automatically pruned selected keys after a data update removed rows that were previously selected; the event is now emitted with the surviving keys whenever the selected set shrinks
+
+### Test:
+- added regression tests for all fixes above
+
+---
+
+## [3.0.0]: 17.03.2026
+
+### Feat:
+- `DataGrid`: added global `provideDataGridHeaderTextResolver(...)` DI hook for resolving plain column/group header text (for example via Presentia) without per-table header templates
+- `DataGrid`: expanded `GridPagedDataSource` with source-level sorting and error state (`sort`, `error`, `updateSort(...)`, `updateSorts(...)`)
+- `DataGrid`: source mode now syncs current sort state from `source.sort` and delegates user sorting directly to source hooks when available
+- `DataGrid`: source page-size changes now use `source.updatePageSize(...)` when supported, which improves direct `PagedQueryStore` integration
+- `DataGrid`: added source mode for page-oriented external stores/sources with internal infinity buffering instead of parent-managed accumulated arrays
+- `DataGrid`: added gap-loader support for source/infinity mode to keep scroll continuity while pages are still loading
+
+### Fix:
+- `DataGrid`: template cell rendering now applies column `align` by default (can still be overridden in custom template markup)
+- `DataGrid`: infinity `pageChange` no longer emits when `total` is empty (`0`) before first data load
+- `DataGrid`: header-group `title` now stays available in VM/template context when `titleTemplate` is used
+- `DataGridPaginator`: page buttons now keep base height but expand horizontally to fit content/custom labels
+- `DataGrid`: source infinity prefetch now defaults to sequential page warming for compatibility with latest-wins sources such as `PagedQueryStore`; opt into `prefetchMode: 'parallel'` only for concurrency-safe sources
+- `DataGrid`: fixed empty-grid infinity request behavior before first load
+- `DataGrid`: fixed sub-header template resolution / rendering for grouped headers
+- `DataGrid`: loading presentation was corrected for the current v3 surface
+- `DataGrid`: added practical ARIA improvements for grid sizing, row/cell indices, expander state, resize handles, tooltip linkage, and live loading/empty announcements
+- `DataGrid`: removed lightweight RxJS-only listener plumbing from resize / scroll feature internals
+
+### Docs:
+- `README`: clarified that `source` mode does not auto-fetch on mount; parent should configure filters/params first and then trigger the initial load explicitly
+- `README`: documented direct `PagedQueryStore` compatibility for source mode, including sort delegation and page-size updates
+- `README`: added global header-text resolver docs and expanded source-mode guidance
+
+---
+
+## [2.5.0]: 26.02.2026
+
+### Feat:
+- `DataGrid`: extensible cell `type` support (`GridBuiltInCellType | string`) for custom type names
+- `DataGrid`: global type registries via DI:
+  - `provideDataGridTypeTransformers(...)` (`type -> transformer`)
+  - `provideDataGridTypeRenderers(...)` (`type -> TemplateRef`)
+- `DataGrid`: type render resolution precedence extended with DI registry (local `reDataGridTypeCell` still has priority over global type renderers)
+- `DataGrid`: callback contexts expanded with row meta (`index`, `col`, `type`, `isPinned`)
+- `DataGrid`: `isPinned` flag added to cell template contexts (`reDataGridTypeCell`, `reDataGridCell`, typed/global templates) and tooltip template context
+
+### DX / API:
+- `GridCellRenderer` (`value`) now supports second argument context: `value(row, ctx)`
+- `GridCellTransformer` standardized as `transformer(row, ctx)`
+- `RenderTemplateData` now includes `isPinned`
+- `GridTooltipContext` now includes `isPinned`
+
+### Docs:
+- `README`: added docs/examples for global type registries, renderer/value precedence, selection guidance for infinity mode, and `isPinned` callback/template context usage
+
+---
+
+## [2.4.0]: 20.02.2026
+
+### Feat:
+- `DataGrid`: added header drag-resize for columns with `resizable` support (`minWidth` / `maxWidth` respected)
+- `DataGrid`: added provider defaults `resizable` and `translations.indexColumnHeader` for global resize behavior and index header text
+
+---
+
+## [2.3.6]: 19.02.2026
+
+### Fix:
+- `ColumnManager`: pin action no longer reorders columns; pin now updates only sticky side while preserving current column order
+- `sort-ic`: added not sorted state
+
+---
+
+## [2.3.5]: 19.02.2026
+
+### Fix:
+- `DataGrid`: fixed expander state reset when `pinnedRows` input changes (expanded groups now stay intact)
+
+---
+
+## [2.3.4]: 19.02.2026
+
+### Fix:
+- `DataGrid`: fixed expander state handling for multiple independent `expandBy` groups (toggling one group no longer resets/opens other groups)
+
+---
+
+## [2.3.3]: 19.02.2026
+
+### Feat:
+- `ColumnManager`: added `showAllLabel` and `hideAllLabel` inputs to customize controls text
+
+### Fix:
+- `ColumnManager`: column visibility now toggles only on eye icon click (row/title click no longer toggles visibility)
+
+---
+
+## [2.3.1]: 18.02.2026
+
+### Fix:
+- `ColumnManager`: custom trigger now supports `ng-template[reDataGridColumnManagerTrigger]` and works correctly with interactive projected content
+
+---
+
+## [2.3.0]: 18.02.2026
+
+### Feat:
+- `ColumnManager`: pin action redesigned into compact current-state button with mini popover selection (`left` / `none` / `right`)
+- `ColumnManager`: custom trigger via projected content marker `reDataGridColumnManagerTrigger`
+- `ColumnManager`: custom column title template via projected `ng-template[reDataGridColumnManagerColumnTitle]`
+- `ColumnManager`: panel positioning now clamps to viewport to prevent right-edge overflow
+
+### Refactor:
+- `ColumnManager`: component split into dedicated `.ts` / `.html` / `.scss` files
+
+### Notes:
+- `ColumnManager`: trigger and list title customization APIs moved to projected content (`reDataGridColumnManagerTrigger`, `reDataGridColumnManagerColumnTitle`)
+
+---
+
+## [2.2.3]
+### Fix:
+- `DataGrid`: fixed declarative columns initialization timing to avoid empty/incorrect state before content refs are ready
+
+---
+
+## [2.2.2]
+### Fix:
+- `DataGrid`: fixed added missed merge columns helper
+
+---
+
+## [2.2.1]
+### Feat:
+- `DataGrid`: `sortMode` with multi-sort flow
+- `DataGrid`: public API methods `clearSelection`, `selectAllLoaded`, `resetSort`, `setSort`, `setMultiSort`
+- `DataGrid`: `isRowDisabled` predicate for row-level disabling
+- `DataGrid`: focus ring support
+- `DataGrid`: ARIA improvements
+- `DataGrid`: auto tooltip by value via `tooltip: true`
+
+### Perf/Opt:
+- `DataGrid`: multi-sort order lookup moved to hash map
+- `DataGrid`: selection and select-all optimizations for infinity mode
+- `DataGrid`: reduced infinity prefetch aggressiveness (`PREFETCH_FACTOR`)
+- `DataGrid`: effect/call orchestration cleanup to reduce unnecessary recalculations
+
+### Refactor:
+- `DataGrid`: split large component logic into feature modules (selection/sort/sticky/tooltip/overlay/virtual-scroll/header/infinity orchestration)
+- `DataGrid`: additional orchestration extraction and cleanup in feature layer
+
+### Fix:
+- `DataGrid`: select-all behavior fixes for loaded-only strategy in infinity scenarios
+- `DataGrid`: sorting behavior fixes (single/multi integration and state sync)
+- `DataGrid`: follow-up fixes for selection and scroll-driven flows
+
+### Test:
+- expanded feature-level tests for refactored modules
+- added surface API tests for `DataGrid` sort methods delegation
+
+---
+
+## [2.1.1]: 11.02.2026
+
+### Feat:
+- `DataGrid`: CSS vars for header/body gap and hover rounding
+
+### Fix:
+- `DataGrid`: pinned rows use the same cell renderer pipeline as regular rows (align/sticky/type/templates/tooltip/width)
+
+---
+
+## [2.1.0]: 11.02.2026
+
+### Feat:
+- `merge` declarative columns with column manager state (visible/disabled/sticky prioritized from state)
+- `DataGrid`: `lockVerticalScroll` flag to disable vertical scrolling
+- `DataGrid`: `defer*` flags to defer rendering
+- expanded public API exports for consumer typing
+
+### Fix:
+- `DataGrid`: fix header width rendering
+- `ColumnManager`: fix hidden state color
+
+### Test:
+- added unit tests for column merge helpers
+
+### Docs:
+- updated README with missing CSS variables (grid + column manager), column manager inputs, and lock/defer inputs
+
+---
+
+## [2.0.1]: 09.02.2026
+### Chore:
+- excluded source maps from the npm package
+
+---
+
+## [2.0.0]: 09.02.2026
+
+### Feat:
+- Header groups (two-level headers)
+- Declarative columns DSL (`<re-dg-column>`)
+- Skeleton loading mode (pagination + infinity)
+- Sticky row + custom row templates
+- Row/cell events: click, context menu, double click
+- Column manager dropdown (reorder, show/hide, pin) + trigger template
+- Tooltip popover per column (`tooltip`: string, fn, or `TemplateRef`)
+- Paginator improvements:
+  - templates for pages
+  - first/last controls
+  - per-page dropdown
+- Grid defaults provider via DI
+- Default value support for cells
+
+### Perf/Opt:
+- Sticky row/column calculations
+- Virtual scrolling performance
+- Resize handling
+- Render / change detection optimizations
+
+### Fix:
+- Sticky column interface (left/right)
+- Type merge issues
+- Header cell template rendering (icons included)
+- Overlay loading mode (spinner) rework
+- Column visibility toggle now switches on first click
+
+### Breaking:
+- `GridColumn.tooltip` is now opt-in popover content (string / fn / TemplateRef), replaces previous implicit tooltip behavior.
+- Column manager introduces new secondary entrypoint `@reforgium/data-grid/column-manager` (no runtime breaking changes, but new public API).
+
+### Docs:
+- updated README (column manager + tooltip)
+
+---
+
+## [1.1.0]: 30.01.2026
+
+### Feat:
+- improved height feature
+- `reDataGridSortIcon`, `reDataGridExpanderIcon`: sort & expander icons ref
+- `reDataGridCell`: data cell ref
+- `DataGridPaginator`: new component
+- `DataGridColumn`: added `typeParams` to typed column's cell
+- `CSS customization`: added expander styling
+- `CSS customization`: added css variables: empty surface
+
+### Fix:
+- code cleanup
+- rewrote sandbox – minimized
+- height setting
+- improved loading and empty state layout
+- updated (corrected) readme
+
+---
+
+## [1.0.3]: 11.01.2026
+
+### Fix:
+- fixed prefixes of directives
+
+### Chore:
+- added more documentation
+
+---
+
+## [1.0.2]: 24.12.2025
+
+### Fix:
+- fixed index forwarding in the template cell
+
+---
+
+## [1.0.1]: 24.12.2025
+
+### Fix:
+- fixed transform types of inputs
+
+---
+
+## [1.0.0]: 24.12.2025
+
+### Feat:
+- added base data grid functionality
+- implemented virtual scrolling for efficient work with large datasets
+- added single-column sorting
+- added pagination and infinite scroll navigation
+- added customizable templates for cells and headers
+- added the ability to pin rows to top and bottom
+- added support for sticky columns on the left and right
+- added text alignment configuration per column
+- added min/max width configuration per column
+- added single and multiple row selection
+- added index column support
+- added customization for empty and loading states
+- added flexible data typing system

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rtommievich
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -59,6 +59,41 @@ export class SomeComponent {
   (pageChange)="loadMore($event)"
 />
 ```
+
+For small and medium lists, `data` remains the simplest contract.
+
+For server-paged lists, you can now pass a page-oriented source instead:
+
+```ts
+import type { GridPagedDataSource } from '@reforgium/data-grid';
+
+type User = { id: number; name: string };
+
+declare const usersSource: GridPagedDataSource<User>;
+```
+
+```html
+<re-data-grid
+  mode="infinity"
+  [source]="usersSource"
+  [columns]="columns"
+  [pageSize]="20"
+/>
+```
+
+In `source` mode, the grid keeps its own internal page buffer for infinity scrolling, so the parent does not need to maintain one ever-growing accumulated `data[]`.
+
+Important:
+
+- The grid does not auto-fetch on mount in `source` mode.
+- The parent should first apply filters / route params / query state and then call the source explicitly (`fetch(...)`, `updatePage(0)`, etc.).
+- After the source is initialized, the grid may call `source.updatePage(...)` for user-driven page changes and infinity buffering.
+- If the source exposes `updatePageSize(...)`, the grid uses it when the page size changes.
+- If the source exposes `sort`, `updateSort(...)`, or `updateSorts(...)`, the grid keeps sort state in sync and can delegate user sorting directly to the source.
+- Infinity buffering uses `prefetchMode: 'sequential'` by default for compatibility with latest-wins sources such as `PagedQueryStore`.
+- Set `prefetchMode: 'parallel'` only for sources that safely support concurrent `updatePage(...)` calls.
+
+`PagedQueryStore` from `@reforgium/statum` fits this contract directly, so `[source]="store"` is enough for the common server-table case.
 ---
 
 ## Configuration
@@ -107,6 +142,38 @@ Supported default fields:
 
 `translations` supports: `emptyState`, `itemsPerPageLabel`, `nextPageLabel`, `prevPageLabel`, `indexColumnHeader`.
 
+### Global header text resolver
+
+If your app keeps column headers as i18n keys, you can resolve them globally via DI without wiring `headerTemplate` for every table.
+
+- `provideDataGridHeaderTextResolver(...)` registers `(text, ctx) => string | Signal<string>`
+- The resolver applies to plain column headers and header-group titles
+- `headerTemplate` / `titleTemplate` still win for markup, but receive already-resolved text in `$implicit`
+- `provideDataGridHeaderTextResolverWithParent(...)` is available for advanced parent-resolver composition
+
+```ts
+import { inject } from '@angular/core';
+import { provideDataGridHeaderTextResolver } from '@reforgium/data-grid';
+import { LangService } from '@reforgium/presentia';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideDataGridHeaderTextResolver(() => {
+      const lang = inject(LangService);
+
+      return (text) => (text.includes('.') ? lang.observe(text) : text);
+    }),
+  ],
+};
+```
+
+```ts
+columns = [
+  { key: 'name', header: 'users.columns.name' },
+  { key: 'email', header: 'users.columns.email' },
+];
+```
+
 ### Type registries (global + local)
 
 You can register type-based transformers and renderers globally via DI.
@@ -200,6 +267,7 @@ columns = [
 | Parameter          | Type                                             | Default            | Description                                                                                     |                  |
 |--------------------|--------------------------------------------------|--------------------|-------------------------------------------------------------------------------------------------|------------------|
 | data               | `T[]`                                            | `[]`               | Data array to render                                                                            |                  |
+| source             | `GridPagedDataSource<T> \| null`                 | `null`             | Optional page-oriented source for pagination/infinity flows                                     | *[NEW in 3.x]*   |
 | columns            | `GridColumn<T>[]`                                | `[]`               | Programmatic column configuration (used when no declarative columns are provided)               |                  |
 | headerGroups       | `GridHeaderGroup<T>[]`                           | `[]`               | Optional top header row groups (`from`..`to`) for 2-level headers                               | *[NEW in 2.0.0]* |
 | pinnedRows         | `GridPinnedRow<T>[]`                             | `[]`               | Top / bottom pinned rows                                                                        |                  |
@@ -230,6 +298,19 @@ Selection mode guidance:
 - Prefer using row selection with `mode="pagination"` for clearer UX and predictable “select all” behavior.
 - In `mode="infinity"`, selection typically applies only to currently loaded rows, so use it only when that behavior is acceptable.
 
+Data source guidance:
+
+- Use `data` when the parent already owns the full rendered collection.
+- Use `source` for server-driven pagination or infinity flows where the parent should expose only the current page.
+- In `mode="infinity"` + `source`, the grid uses `totalElements` for scroll height when available and stores loaded page chunks internally instead of forcing the parent to append rows into one large array.
+- `GridPagedDataSource.totalElements` is optional for infinity sources. If omitted, the grid keeps requesting pages until it receives a short page (`items.length < pageSize`) and then treats that page as the end of the dataset.
+- In `source` mode, initialize the source from the parent after all filters / params are ready; the grid does not perform an automatic first fetch on mount.
+- `GridPagedDataSource.error` is optional and can be used by consumers that want to project source-level error UI near the grid.
+- `GridPagedDataSource.sort`, `updateSort(...)`, and `updateSorts(...)` let the grid use source-owned sort state instead of forcing a separate parent bridge.
+- `GridPagedDataSource.prefetchMode` defaults to `sequential`; keep that default for `PagedQueryStore` and similar latest-wins sources.
+- Use `prefetchMode: 'parallel'` only when the source supports multiple concurrent `updatePage(...)` requests without canceling each other.
+- When `source.version` changes or a new source is assigned, the grid invalidates its internal buffer immediately; any in-flight `updatePage()` responses that arrive after invalidation are discarded and do not overwrite the fresh buffer.
+
 Feature lazy-loading behavior (runtime `import()`):
 
 - Selection feature is loaded when `selection.mode !== 'none'`.
@@ -281,6 +362,7 @@ Row templates:
 | rowClick        | `GridRowClickEvent<T>`        | Emitted when a row is clicked (includes native event)  | *[UPD in 2.0.0]* |
 | rowContext      | `GridRowContextEvent<T>`      | Emitted on row context menu                            | *[NEW in 2.0.0]* |
 | rowDoubleClick  | `GridRowDoubleClickEvent<T>`  | Emitted when a row is double-clicked                   | *[NEW in 2.0.0]* |
+| columnResizeEnd | `GridColumnResizeEndEvent<T>` | Emitted when a column resize drag ends (key + px width); use to persist widths | *[NEW in 3.1.0]* |
 | sortChange      | `GridSortEvent<T>`            | Emitted when single-sort order changes                 |                  |
 | multiSortChange | `GridMultiSortEvent<T>`       | Emitted when multi-sort order changes                  | *[NEW in 2.2.0]* |
 | pageChange      | `GridPageChangeEvent`         | Emitted when requesting data for a new page            |                  |
@@ -289,6 +371,8 @@ Row templates:
 Notes:
 
 - A cell click also triggers the row click event (bubbling), so listen to one or stop propagation if needed.
+- In `source` mode, sort events are still emitted, but if the source implements sort hooks the grid also updates the source directly.
+- `selectChange` is emitted not only on user interaction but also when the grid automatically prunes selected keys after a data update removes rows that were previously selected. Always treat `selectChange` as the authoritative selected state.
 
 ### Public API methods
 
@@ -300,6 +384,28 @@ Notes:
 - `setSort(event)` - applies single-sort state and emits sort events
 - `setMultiSort(items)` - applies multi-sort state and emits sort events
 
+### GridPagedDataSource<T> reference
+
+The optional `source` input accepts a page-oriented contract:
+
+| Field / method | Type | Description |
+|---|---|---|
+| `items` | `Signal<T[]>` | Current page items |
+| `loading` | `Signal<boolean>` | Source loading state |
+| `error` | `Signal<unknown \| null>` | Optional source error state |
+| `page` | `number` | Current page index |
+| `pageSize` | `number` | Current page size |
+| `totalElements` | `number \| undefined` | Optional total size |
+| `sort` | `ReadonlyArray<GridSortItem<T>> \| undefined` | Optional source-owned sort state |
+| `version` | `Signal<number> \| undefined` | Dataset reset marker for local buffer invalidation |
+| `updatePage(page)` | `(page: number) => Promise<unknown>` | Load a page |
+| `updatePageSize(size)` | `((size: number) => Promise<unknown>) \| undefined` | Optional page-size handler |
+| `updateSort(sort)` | `((sort?: GridSortItem<T> \| null) => Promise<unknown>) \| undefined` | Optional single-sort handler |
+| `updateSorts(sort)` | `((sort?: ReadonlyArray<GridSortItem<T>> \| null) => Promise<unknown>) \| undefined` | Optional multi-sort handler |
+| `prefetchMode` | `'sequential' \| 'parallel' \| undefined` | Infinity prefetch strategy |
+
+This contract is intentionally grid-like, not `statum`-specific, but `PagedQueryStore` already matches it well enough to be used directly.
+
 ### GridColumn<T> reference
 
 `columns` accepts `GridColumn<T>[]`, where `GridColumn<T>` is a union of three column variants:
@@ -323,11 +429,11 @@ Common (base) fields:
 
 Renderer-specific fields:
 
-| Variant           | Fields                                                                                                    | Notes                                                                                                 |
-|-------------------|-----------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|
+| Variant                  | Fields                                                                           | Notes                                                                                                                  |
+|--------------------------|----------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------|
 | Built-in / type renderer | `type?: GridBuiltInCellType \| string`, `typeParams?: any`, `defaultValue?: any` | Built-in types are `plain/date/number/index/checkbox`; custom string types can be handled by local/DI type registries. |
-| Value renderer    | `value: (row: T, ctx) => string \| number`, `track: (row: T) => string`                                   | `track` is required for stable row identity and efficient updates. `ctx` includes `col`, `index`, `isPinned`. |
-| Template renderer | `renderTemplate: TemplateRef<...>`, `track: (row: T) => string`                                           | `track` is required when rendering through Angular templates.                                         |
+| Value renderer           | `value: (row: T, ctx) => string \| number`, `track: (row: T) => string`          | `track` is required for stable row identity and efficient updates. `ctx` includes `col`, `index`, `isPinned`.          |
+| Template renderer        | `renderTemplate: TemplateRef<...>`, `track: (row: T) => string`                  | `track` is required when rendering through Angular templates.                                                          |
 
 Cell text wrapping/clamp behavior: