@opencorestack/opengridx 1.3.0 → 2.0.1

package/CHANGELOG.md

@@ -5,6 +5,59 @@
 
 ---
 
+## [2.0.1] — 2026-09-08
+
+### Documentation
+
+- **`unique` aggregation function documented in changelog** — `unique` (count of distinct non-null
+  values via `Set`) has been a built-in aggregation function since v1. The v2.0.0 changelog entry
+  for `availableAggregationFunctions` now explicitly lists all six built-in names: `sum`, `avg`,
+  `count`, `min`, `max`, `unique`.
+
+---
+
+## [2.0.0] — 2026-09-08
+
+### Breaking
+
+- **Removed dead public API:** `onPinnedRowsChange` and `onRowGroupingModelChange` are removed from
+  `DataGridProps`. Both props accepted callbacks that were never invoked — no pin/unpin-row UI and no
+  drag-to-group UI exist. Callers that passed these callbacks should simply remove them; grid
+  behavior is unchanged.
+
+### Added
+
+- **`density` wired** — `density?: 'compact' | 'standard' | 'comfortable'` now sets the
+  `--ogx-row-height` CSS variable (compact = 32 px, standard = `rowHeight`, comfortable = 72 px).
+  Previously accepted but silently discarded.
+- **`disableRowSelectionOnClick`** — clicking a row no longer triggers selection when this prop is
+  `true`. Previously wired to internal state only; `onRowSelectionModelChange` is now also fired.
+- **`disableMultipleRowSelection`** — clicking a row while this prop is `true` caps selection to
+  that single row (deselects others). Clicking an already-selected row deselects it.
+- **`groupingColDef` implemented** — passing `groupingColDef` when `rowGroupingModel` is active now
+  creates a dedicated `__group__` column at position 0, auto-pinned left. Previously the prop was
+  accepted but had no runtime effect.
+- **`groupable: false` honored** — columns with `groupable: false` are now skipped when building the
+  grouping tree in `useRowGrouping`. Previously this flag was silently ignored.
+- **`groupingValueFormatter` on `GridColDef`** — new optional field
+  `groupingValueFormatter?: (params: { field: string; value: unknown }) => string` customizes the
+  label shown for group-header rows at that level. The formatted string flows through
+  `GridRowMeta.groupLabel`. Falls back to `"${field}: ${value}"` when omitted.
+- **`availableAggregationFunctions` honored** — per-column `availableAggregationFunctions?: string[]`
+  now gates which aggregation functions are computed in `useAggregation`. Functions not in the
+  allowed list are skipped for that field. Built-in function names (all available since v1):
+  `sum`, `avg`, `count`, `min`, `max`, `unique` (count of distinct non-null values).
+- **`multiSort` prop** — new `multiSort?: boolean` on `DataGrid`. When `true`, every click on a
+  sortable column header appends/cycles that column in the sort model instead of replacing it — no
+  Shift key required. Shift+click continues to work as an append gesture regardless of this prop.
+- **Multi-sort shift-click** — shift-clicking a column header appends the column to `sortModel`
+  rather than replacing it. A numbered priority badge appears next to the sort arrow when more than
+  one sort key is active. Plain click still replaces with a single-key sort (unless `multiSort` is set).
+- **`description` tooltip** — `description?: string` on `GridColDef` now renders as the native
+  `title` attribute on the header cell, providing a browser tooltip on hover.
+
+---
+
 ## [1.3.0] — 2026-09-08
 
 ### Added

package/dist/index.d.ts

@@ -108,6 +108,13 @@ export declare interface DataGridProps<R extends GridRowModel = GridRowModel> {
     sortModel?: GridSortItem[];
     /** Callback fired when the sorting model changes. */
     onSortModelChange?: (model: GridSortItem[]) => void;
+    /**
+     * When true, clicking any sortable column header appends/cycles that column in the
+     * sort model instead of replacing it — no Shift key required. Plain click still
+     * cycles asc → desc → removed for that column while all other active sort keys stay.
+     * Shift+click continues to work regardless of this prop.
+     */
+    multiSort?: boolean;
     /** Filtering mode: 'client' (default) or 'server'. */
     filterMode?: 'client' | 'server';
     /** The current filter model. */
@@ -136,8 +143,6 @@ export declare interface DataGridProps<R extends GridRowModel = GridRowModel> {
     onColumnVisibilityModelChange?: (model: GridColumnVisibilityModel) => void;
     /** Defines which rows are pinned to the top or bottom. */
     pinnedRows?: GridRowPinning;
-    /** Callback fired when row pinning changes. */
-    onPinnedRowsChange?: (model: GridRowPinning) => void;
     /** If true, a column of checkboxes is added for row selection. */
     checkboxSelection?: boolean;
     /** If true, the checkbox column remains visible during horizontal scrolling. */
@@ -204,8 +209,6 @@ export declare interface DataGridProps<R extends GridRowModel = GridRowModel> {
     defaultGroupingExpansionDepth?: number;
     /** Controlled state for row grouping. */
     rowGroupingModel?: GridRowGroupingModel;
-    /** Callback fired when row grouping changes. */
-    onRowGroupingModelChange?: (model: GridRowGroupingModel) => void;
     /** Controlled state for data aggregation (e.g., { salary: 'sum' }). */
     aggregationModel?: GridAggregationModel;
     /** Callback fired when aggregation model changes. */
@@ -486,13 +489,22 @@ export declare interface GridColDef<R extends GridRowModel = GridRowModel> {
     field: string;
     /** Text displayed in the column header. */
     headerName?: string;
-    /** Tooltip or accessible description for the header. */
+    /** Tooltip shown on header hover — used as the column's accessibility label. */
     description?: string;
     /** If true, this column can be used as a grouping dimension. */
     groupable?: boolean;
+    /**
+     * Custom formatter for the group-header label when this column is used as a grouping field.
+     * Receives the field name and grouped value; return the string to display.
+     * Falls back to `"field: value"` when omitted.
+     */
+    groupingValueFormatter?: (params: {
+        field: string;
+        value: unknown;
+    }) => string;
     /** If true, this column can be summarized using aggregation functions. */
     aggregable?: boolean;
-    /** List of allowed aggregation functions (e.g., ['sum', 'avg']). */
+    /** Restricts which aggregation functions are offered for this column (e.g., ['sum', 'avg']). */
     availableAggregationFunctions?: string[];
     /** Width in pixels or a percentage string. Defaults to automatic calculation. */
     width?: number | string;
@@ -819,6 +831,7 @@ export declare interface GridRowMeta {
     treeDepth?: number;
     groupingField?: string;
     groupingValue?: unknown;
+    groupLabel?: string;
     descendantCount?: number;
     isExpanded?: boolean;
     isGroupRow?: boolean;
@@ -1186,6 +1199,8 @@ declare interface HeaderProps<R extends GridRowModel = GridRowModel> {
         field: string;
     } | null;
     onHeaderClick?: (field: string) => void;
+    onSortAdd?: (field: string, direction: GridSortDirection) => void;
+    multiSort?: boolean;
     onHideColumn?: (field: string) => void;
     onPinColumn?: (field: string, side: 'left' | 'right' | null) => void;
     onManageColumns?: () => void;
@@ -1380,6 +1395,7 @@ export declare function useAggregation<R extends GridRowModel>(params: UseAggreg
 
 export declare interface UseAggregationParams<R extends GridRowModel> {
     rows: R[];
+    columns?: GridColDef[];
     aggregationModel: GridAggregationModel;
     isServerSide: boolean;
     dataSource?: GridDataSource<R>;