@reforgium/data-grid 3.2.2 → 3.2.4

package/CHANGELOG.md

@@ -1,13 +1,60 @@
+## [3.2.4] - 16.07.2026
+
+### Added
+
+- `GridPagedDataSource.loadPage()` stateless capability for safe parallel page loading, plus source buffer reset and `sourceError` request diagnostics.
+- Controlled selection keys, explicit source revision/immutability semantics, and disabled paginator navigation support.
+
+### Fixed
+
+- Sorting now performs its page reset atomically without issuing a competing `updatePage()` request.
+- Source request failures, stale responses, infinity buffering, paginator normalization, row identity, and overlay drag cleanup are hardened with regression coverage.
+- Ordinary grid cells no longer create duplicate tab stops; rows own grid navigation focus.
+
+### Deprecated
+
+- `GridColumn.track` and declarative column `track` are not consumed by rendering. Use the grid-level `rowKey` instead.
+
+### Compatibility
+
+- Supported Angular peer range is `>=18.0.0 <22.0.0`; `rxjs` is no longer a peer dependency of `@reforgium/data-grid`.
+
+### Test
+
+- Added a cross-package smoke test using the built `@reforgium/data-grid` artifact with a real `PagedQueryStore` from `@reforgium/statum`.
+
+---
+
+## [3.2.3]: 13.05.2026
+
+### Fix:
+
+- `DataGrid`: source/infinity - `totalRowCount` no longer collapses to `0` (empty state) after the internal page buffer evicts early pages on long scrolls when the source does not return `totalElements`; row-count knowledge is now tracked via a monotonic high-water mark (`knownRowCount`) plus end-of-data state (`endReached` / `confirmedTotal`) updated when each page lands, instead of walking the eviction-bound `sourcePages` map
+- `DataGrid`: source/infinity - buffer eviction now anchors `pageBase` and never evicts it, so `localToAbsolutePage` and contiguous-loaded-row accounting stay correct after scrolling past `MAX_BUFFERED_PAGES`
+
+### Test:
+
+- added regression coverage: monotonic `totalRowCount` without `totalElements` (optimistic probe page, fixed end after short page, post-end full page does not unwind the total), 120-page scroll past `MAX_BUFFERED_PAGES` keeps `totalRowCount` stable, and anchor page survives eviction
+
+### Docs:
+
+- `GridPagedDataSource.version`: tightened JSDoc - without `totalElements` the grid pins end-of-data on the first short/empty page, so the source must bump `version` on dataset growth/replacement to clear the pin; mutating `items()` in place without a bump leaves the grid with a stale row count
+
+---
+
 ## [3.2.1]: 17.04.2026
 
 ### Fix:
+
 - `DataGrid`: source/pagination now respects exact `totalElements` when it is provided instead of collapsing paginator state to the current page payload length
 - `DataGrid`: source/pagination without `totalElements` now exposes one optimistic extra page when the current page is full (`items.length === pageSize`), so the consumer can perform the final probe request and detect the real end on the first short/empty page
 
 ### Docs:
+
 - `README`: documented `GridPagedDataSource.totalElements` behavior for source-driven pagination without a known total
 
 ### Test:
+
 - added regression coverage for source/pagination with exact `totalElements` and for the full-page-without-total probe flow
 
 ---
@@ -15,6 +62,7 @@
 ## [3.2.0]: 14.04.2026
 
 ### Feat:
+
 - `DataGrid`: added `getRowClass` input (`string | ((row: Data, index: number) => string)`) — applies CSS class(es) to data rows based on a static string or a resolver function; works alongside `isRowDisabled` and other row-level predicates
 
 ---
@@ -22,11 +70,13 @@
 ## [3.1.2]: 14.04.2026
 
 ### Fix:
+
 - `DataGrid`: source/infinity lifecycle for long-lived sources was stabilized; remounting a grid against the same `GridPagedDataSource` / `PagedQueryStore` instance now resets component-local source session state instead of reusing stale buffered pages, queued requests, or pending flags from the previous screen lifecycle
 - `DataGrid`: source/infinity now rebases correctly when a reused source reattaches on a non-zero page without `totalElements`; the current source page becomes the local starting point instead of rendering an empty grid
 - `DataGrid`: singleton-like source reuse now settles correctly after empty successful replacements and remounts, so stale rows are cleared and `loading` no longer depends on previous component-local source state
 
 ### Test:
+
 - added regression coverage for same-source remount, empty replacement after remount, non-zero-page reattach without `totalElements`, and source-session reset on version change
 
 ---
@@ -34,6 +84,7 @@
 ## [3.1.1]: 06.04.2026
 
 ### Fix:
+
 - `DataGrid`: source/infinity — grid no longer auto-requests pages before the first external fetch; `ensureBufferedRange` and `drainQueuedPages` are now gated by a `hasReceivedData` flag that is only raised after at least one non-empty page arrives via `sync()` outside of a reset cycle; guards stale-store (singleton re-bind), stale queued pages surviving a `clearBuffer()`, and the `queueMicrotask` drain-loop that ran after a buffer reset
 
 ---
@@ -41,9 +92,11 @@
 ## [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)
@@ -53,6 +106,7 @@
 - `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
 
 ---
@@ -60,6 +114,7 @@
 ## [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
@@ -68,6 +123,7 @@
 - `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
@@ -80,6 +136,7 @@
 - `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
@@ -89,6 +146,7 @@
 ## [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`)
@@ -98,12 +156,14 @@
 - `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
 
 ---
@@ -111,6 +171,7 @@
 ## [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
 
@@ -119,6 +180,7 @@
 ## [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
 
@@ -127,6 +189,7 @@
 ## [2.3.5]: 19.02.2026
 
 ### Fix:
+
 - `DataGrid`: fixed expander state reset when `pinnedRows` input changes (expanded groups now stay intact)
 
 ---
@@ -134,6 +197,7 @@
 ## [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)
 
 ---
@@ -141,9 +205,11 @@
 ## [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)
 
 ---
@@ -151,6 +217,7 @@
 ## [2.3.1]: 18.02.2026
 
 ### Fix:
+
 - `ColumnManager`: custom trigger now supports `ng-template[reDataGridColumnManagerTrigger]` and works correctly with interactive projected content
 
 ---
@@ -158,33 +225,42 @@
 ## [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
@@ -193,21 +269,25 @@
 - `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
 
@@ -216,9 +296,11 @@
 ## [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)
 
 ---
@@ -226,25 +308,31 @@
 ## [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
 
 ---
@@ -252,6 +340,7 @@
 ## [2.0.0]: 09.02.2026
 
 ### Feat:
+
 - Header groups (two-level headers)
 - Declarative columns DSL (`<re-dg-column>`)
 - Skeleton loading mode (pagination + infinity)
@@ -267,12 +356,14 @@
 - 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)
@@ -280,10 +371,12 @@
 - 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)
 
 ---
@@ -291,6 +384,7 @@
 ## [1.1.0]: 30.01.2026
 
 ### Feat:
+
 - improved height feature
 - `reDataGridSortIcon`, `reDataGridExpanderIcon`: sort & expander icons ref
 - `reDataGridCell`: data cell ref
@@ -300,8 +394,9 @@
 - `CSS customization`: added css variables: empty surface
 
 ### Fix:
+
 - code cleanup
-- rewrote sandbox – minimized
+- rewrote sandbox – minimized
 - height setting
 - improved loading and empty state layout
 - updated (corrected) readme
@@ -311,9 +406,11 @@
 ## [1.0.3]: 11.01.2026
 
 ### Fix:
+
 - fixed prefixes of directives
 
 ### Chore:
+
 - added more documentation
 
 ---
@@ -321,6 +418,7 @@
 ## [1.0.2]: 24.12.2025
 
 ### Fix:
+
 - fixed index forwarding in the template cell
 
 ---
@@ -328,6 +426,7 @@
 ## [1.0.1]: 24.12.2025
 
 ### Fix:
+
 - fixed transform types of inputs
 
 ---
@@ -335,6 +434,7 @@
 ## [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