@opencorestack/opengridx 1.0.7 → 1.1.0

package/lib/hooks/useRowGrouping.ts

@@ -1,12 +1,13 @@
 import { useState, useMemo, useEffect, useCallback } from 'react';
-import type { 
-    GridRowModel, 
-    GridRowId, 
-    GridRowGroupingModel, 
-    GridAggregationModel, 
+import type {
+    GridRowModel,
+    GridRowId,
+    GridRowGroupingModel,
+    GridAggregationModel,
     GridTreeNode,
     GridFilterModel,
-    GridSortItem
+    GridSortItem,
+    GridRowMeta
 } from '../types';
 import { isRowMatchingFilter } from '../utils/filtering';
 import { compareValues } from '../utils/sorting';
@@ -27,12 +28,18 @@ const defaultGetAggregationPosition = (groupNode: GridTreeNode | null): 'inline'
     return groupNode?.depth === -1 ? 'footer' : 'inline';
 };
 
+// Stable empty defaults — module-level constants prevent new object identity
+// on every render, which would otherwise invalidate useMemo deps and cause
+// infinite re-render loops when callers omit optional params.
+const EMPTY_ROW_GROUPING_MODEL: GridRowGroupingModel = [];
+const EMPTY_AGGREGATION_MODEL: GridAggregationModel = {};
+
 export function useRowGrouping<R extends GridRowModel>(params: UseRowGroupingParams<R>) {
-    const { 
-        rows, 
-        getRowId, 
-        rowGroupingModel = [], 
-        aggregationModel = {}, 
+    const {
+        rows,
+        getRowId,
+        rowGroupingModel = EMPTY_ROW_GROUPING_MODEL,
+        aggregationModel = EMPTY_AGGREGATION_MODEL,
         defaultGroupingExpansionDepth = 0,
         filterModel,
         sortModel,
@@ -291,12 +298,30 @@ export function useRowGrouping<R extends GridRowModel>(params: UseRowGroupingPar
 
     const getNode = useCallback((id: GridRowId) => treeNodes.get(id), [treeNodes]);
 
+    const rowMetaMap = useMemo<Map<GridRowId, GridRowMeta>>(() => {
+        const map = new Map<GridRowId, GridRowMeta>();
+        treeNodes.forEach((node, id) => {
+            const isGroup = Boolean(node.children && node.children.length > 0);
+            map.set(id, {
+                hasChildren: isGroup,
+                treeDepth: node.depth,
+                groupingField: node.groupingField,
+                groupingValue: node.groupingValue,
+                descendantCount: node.descendantCount,
+                isGroupRow: isGroup,
+                isExpanded: isGroup ? expandedGroupIds.has(id) : undefined,
+            });
+        });
+        return map;
+    }, [treeNodes, expandedGroupIds]);
+
     return useMemo(() => ({
         treeNodes,
         groupingRows,
         toggleExpansion,
         isGroupExpanded,
         getVisibleRows,
-        getNode
-    }), [treeNodes, groupingRows, toggleExpansion, isGroupExpanded, getVisibleRows, getNode]);
+        getNode,
+        rowMetaMap,
+    }), [treeNodes, groupingRows, toggleExpansion, isGroupExpanded, getVisibleRows, getNode, rowMetaMap]);
 }

package/lib/hooks/useTreeData.ts

@@ -1,5 +1,6 @@
 import { useMemo, useState, useCallback, useEffect } from 'react';
 import { GridRowModel, GridRowId, GridTreeNode, GridFilterModel, GridSortItem } from '../types';
+import type { GridRowMeta } from '../types';
 import { isRowMatchingFilter } from '../utils/filtering';
 import { compareValues } from '../utils/sorting';
 
@@ -311,6 +312,24 @@ export function useTreeData<R extends GridRowModel>(props: UseTreeDataProps<R>)
         return path;
     }, [treeNodes]);
 
+    const rowMetaMap = useMemo<Map<GridRowId, GridRowMeta>>(() => {
+        const map = new Map<GridRowId, GridRowMeta>();
+        const groupRowIds = new Set(groupingRows.map(r => r.id));
+        treeNodes.forEach((node, id) => {
+            map.set(id, {
+                hasChildren: Boolean(
+                    (node.children && node.children.length > 0) ||
+                    (node.serverChildrenCount && node.serverChildrenCount > 0)
+                ),
+                treeDepth: node.depth,
+                descendantCount: node.children ? node.children.length : undefined,
+                isGroupRow: groupRowIds.has(id),
+                isExpanded: expandedGroupIds.has(id),
+            });
+        });
+        return map;
+    }, [treeNodes, groupingRows, expandedGroupIds]);
+
     return useMemo(() => ({
         treeNodes,
         groupingRows,
@@ -318,6 +337,7 @@ export function useTreeData<R extends GridRowModel>(props: UseTreeDataProps<R>)
         isGroupExpanded,
         getVisibleRows,
         getNode,
-        getNodePath
-    }), [treeNodes, groupingRows, toggleExpansion, isGroupExpanded, getVisibleRows, getNode, getNodePath]);
+        getNodePath,
+        rowMetaMap,
+    }), [treeNodes, groupingRows, toggleExpansion, isGroupExpanded, getVisibleRows, getNode, getNodePath, rowMetaMap]);
 }

package/lib/index.ts

@@ -103,4 +103,6 @@ export type {
     GridApi,
     GridTreeNode,
     GridDetailPanelParams,
+    GridRowMeta,
+    GridLocaleText,
 } from './types';

package/lib/types/index.ts

@@ -7,26 +7,33 @@ export type GridRowId = string | number;
 export interface GridRowModel {
   /** Uniquely identifies the row. */
   id: GridRowId;
-  /** Internal: row has child nodes (tree data / row grouping). */
-  _hasChildren?: boolean;
   /** Internal: row is a skeleton placeholder during infinite-scroll loading. */
   _isSkeleton?: boolean;
-  /** Internal: depth in the tree or grouping hierarchy. */
-  _treeDepth?: number;
-  /** Internal: whether the group/tree node is currently expanded. */
-  _isExpanded?: boolean;
-  /** Internal: field used for grouping at this level. */
-  _groupingField?: string;
-  /** Internal: grouping field value at this level. */
-  _groupingValue?: unknown;
-  /** Internal: total descendant count for tree/grouping nodes. */
-  _descendantCount?: number;
   /** Internal: server-reported child count for lazy-loaded tree nodes. */
   serverChildrenCount?: number;
   /** Any other dynamic row properties. */
   [key: string]: unknown;
 }
 
+/**
+ * Internal hierarchy metadata for a row. Exposed via `params.rowMeta` in `renderCell`.
+ * Not present (`undefined`) for flat rows with no active tree-data or row-grouping.
+ *
+ * @since v1.1 — replaces the `_hasChildren` / `_treeDepth` / `_groupingField` etc.
+ * properties that were previously (and incorrectly) typed on `GridRowModel`.
+ * Those underscore fields remain on the row object at runtime in v1.1 for
+ * backward compatibility; they will be removed from the runtime in v2.0.
+ */
+export interface GridRowMeta {
+    hasChildren?: boolean;
+    treeDepth?: number;
+    groupingField?: string;
+    groupingValue?: unknown;
+    descendantCount?: number;
+    isExpanded?: boolean;
+    isGroupRow?: boolean;
+}
+
 export type GridAlignment = 'left' | 'center' | 'right';
 
 /** Represents a row node in the grid's hierarchical tree structure. */
@@ -231,6 +238,11 @@ export interface GridRenderCellParams<R extends GridRowModel = GridRowModel> {
   rowIndex: number;
   /** The index of the column. */
   colIndex: number;
+  /**
+   * Hierarchy metadata for this row. `undefined` for flat rows (no tree-data or row-grouping active).
+   * @since v1.1
+   */
+  rowMeta?: GridRowMeta;
 }
 
 export interface GridRenderHeaderParams {
@@ -463,6 +475,18 @@ export interface GridRowScrollEndParams {
   viewportHeight: number;
 }
 
+/** Overrideable user-visible strings for internationalisation. All fields are optional; defaults match the built-in English strings. */
+export interface GridLocaleText {
+    /** Label before the rows-per-page select. Default: `"Rows per page:"` */
+    paginationRowsPerPage?: string;
+    /** Range label. Receives (from, to, count). Default: `` (f, t, c) => `${f}–${t} of ${c}` `` */
+    paginationOf?: (from: number, to: number, count: number) => string;
+    /** Page counter label. Receives (page, pageCount). Default: `` (p, pc) => `Page ${p} of ${pc}` `` */
+    paginationPage?: (page: number, pageCount: number) => string;
+    /** Empty-state label. When set, overrides the `noRowsLabel` prop on DataGrid. Default: `"No Data"` */
+    noRowsLabel?: string;
+}
+
 /**
  * Main properties for the DataGrid component.
  */
@@ -555,6 +579,8 @@ export interface DataGridProps<R extends GridRowModel = GridRowModel> {
   ariaLabel?: string;
   /** Message displayed when there are no rows to show. */
   noRowsLabel?: string;
+  /** Overrides for user-visible strings (i18n). All fields are optional. */
+  localeText?: GridLocaleText;
 
   /** Advanced: The starting internal state of the grid. */
   initialState?: import('../state/types').GridInitialState;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencorestack/opengridx",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "description": "OpenGridX: High-performance React data infrastructure. Unlock advanced Row Grouping, Excel Export, and Column Pinning without the usual \"Pro\" gatekeeping. Built for speed, scale, and complete architectural freedom. Fully open, virtualization-ready, and feature-complete.",
   "type": "module",
   "main": "./dist/opengridx.umd.js",