@angular-bootstrap/ngbootstrap 2.0.2 → 2.1.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 2.1.0 - 2026-07-25
+
+### Added
+
+- Added DataGrid grouping with `groupable`, `group`, `groupChange`, and grouped `dataStateChange` support for local or manual/server-driven workflows.
+- Added group panel interactions so users can group by dragging column headers, reorder grouped fields, and remove active groups without duplicating descriptors.
+- Added grouped rendering helpers for nested group headers, expand/collapse behavior, aggregates, custom group header/footer templates, and sticky group headers/footers.
+- Added grouping-focused docs, API coverage, examples, and library tests for grouping, aggregates, templates, and sticky group overlays.
+
+### Changed
+
+- Updated DataGrid docs and package positioning to emphasize Angular UI for data-heavy apps, including DataGrid depth and Angular-native Form Builder workflows.
+- Expanded the public package README and release notes to document grouping, aggregate templates, and dependency-free export defaults more clearly.
+
+### Fixed
+
+- Fixed grouped sorting and grouped render paths so sorting continues to work correctly across grouping examples and grouped datasets.
+- Fixed several DataGrid behavior regressions surfaced during the docs pass, including in-cell editing activation, sticky column behavior, and column reordering/data alignment.
+
+## 2.0.3 - 2026-07-05
+
+### Fixed
+
+- Replaced the default PDF export implementation with a dependency-free browser PDF writer so Angular apps do not need jsPDF optional HTML/canvas dependencies for basic table export.
+- Removed `jspdf` and `jspdf-autotable` from optional peer dependencies.
+
 ## 2.0.2 - 2026-07-05
 
 ### Fixed

package/README.md

@@ -1,10 +1,11 @@
 # @angular-bootstrap/ngbootstrap
 
-Standalone Angular UI components with Bootstrap-friendly styling.
+Angular UI for data-heavy apps, with a focus on DataGrid depth, Angular-native Form Builder workflows, and practical standalone components that fit naturally into Bootstrap-based Angular projects.
 
 ## What Is Included
 
 - DataGrid
+- DataGrid grouping, aggregates, and custom group templates
 - Pagination
 - Typeahead
 - Tree
@@ -12,6 +13,13 @@ Standalone Angular UI components with Bootstrap-friendly styling.
 - Stepper
 - Chips
 - Drag and drop
+- Angular-native Form Builder workflows
+
+## Positioning
+
+This project is not affiliated with `ng-bootstrap` or `ngx-bootstrap`.
+
+Those projects focus mainly on Bootstrap components for Angular. `@angular-bootstrap/ngbootstrap` focuses more on practical Angular UI for data-heavy apps, including DataGrid workflows, grouping, drag and drop, Form Builder scenarios, and documentation examples that map to real library APIs.
 
 ## Requirements
 
@@ -29,15 +37,21 @@ npm install @angular-bootstrap/ngbootstrap bootstrap bootstrap-icons
 Optional integrations are installed only when you use those features:
 
 ```bash
-npm install chart.js jspdf jspdf-autotable
+npm install chart.js
 ```
 
+PDF and Excel export are dependency-free by default.
+
 Excel export is dependency-free by default. The built-in `BrowserExcelExportAdapter`
 generates an Excel-compatible workbook in the browser and avoids unmaintained
 spreadsheet writer dependencies. It is intended for visible column values and
 basic scalar cell types; use a custom `ExcelExportAdapter` for formulas, charts,
 multiple sheets, workbook styling, or other advanced workbook features.
 
+The built-in PDF adapter generates a simple table PDF in the browser. Provide a custom
+`PdfExportAdapter` when your product needs branded PDFs, images, charts, advanced layout,
+rich typography, headers, footers, or more precise pagination.
+
 ## Use
 
 Import standalone components directly in your Angular component.
@@ -56,6 +70,8 @@ import { NgbDatagridComponent, type ColumnDef } from '@angular-bootstrap/ngboots
       [columns]="columns"
       [enableSorting]="true"
       filterable="row"
+      [groupable]="true"
+      [group]="[{ field: 'role', dir: 'asc' }]"
       [enablePagination]="true"
       [pageSize]="10"
     />
@@ -75,6 +91,13 @@ export class UsersGridComponent {
 }
 ```
 
+## DataGrid Highlights
+
+- Sorting, filtering, pagination, editing, export, sticky rows and columns, and row detail workflows
+- Grouping by one or more fields with grouped state events for local or server-driven data flows
+- Custom group header/footer templates, aggregate output, and sticky group headers/footers
+- Dependency-free PDF and Excel export defaults for common table export scenarios
+
 ## Development
 
 ```bash

package/RELEASE_NOTES.md

@@ -1,18 +1,27 @@
-# @angular-bootstrap/ngbootstrap 2.0.2
+# @angular-bootstrap/ngbootstrap 2.1.0
 
-This patch fixes PDF export bundling for Angular browser apps.
+This release expands the DataGrid with first-class grouping support and rounds out several related grid behaviors and docs updates.
+
+## Added
+
+- DataGrid grouping with `groupable` and `group` inputs for single-field or multi-field grouping.
+- `groupChange` and grouped `dataStateChange` payloads for manual or server-side grouping flows.
+- Drag-to-group interactions, grouped rows, expand/collapse behavior, aggregate output, and custom group header/footer templates.
+- Sticky group headers and sticky group footers for larger grouped datasets.
+
+## Changed
+
+- Docs, package copy, and examples now position ngbootstrap as Angular UI for data-heavy apps.
+- Grouping examples now build on a shared realistic dataset and extend it across automatic grouping, manual grouping, aggregates, templates, and sticky group examples.
 
 ## Fixed
 
-- `JsPdfAdapter` now loads jsPDF from its browser UMD bundle.
-- This avoids forcing consuming apps to resolve jsPDF optional ESM dependencies such as HTML/canvas sanitization helpers when they only need table PDF export.
+- Sorting continues to behave correctly in grouped scenarios.
+- In-cell editing activation is more reliable.
+- Sticky columns and column reordering behavior were corrected in the DataGrid docs and integration flow.
 
 ## Notes
 
-Applications using PDF export should keep both maintained PDF integrations installed:
-
-```bash
-npm install jspdf jspdf-autotable
-```
+PDF and Excel export remain dependency-free by default.
 
-Excel export remains dependency-free through `BrowserExcelExportAdapter`.
+Use a custom `PdfExportAdapter` or `ExcelExportAdapter` when your product needs branded documents, advanced workbook generation, charts, images, or other highly customized export output.