@opencorestack/opengridx 3.6.0 → 3.7.0

package/lib/types/slots.ts

@@ -0,0 +1,56 @@
+import type { GridToolbarProps } from '../components/Toolbar/GridToolbar';
+import type { PaginationProps } from '../components/Pagination/Pagination';
+import type { GridPaginationModel } from './dataSource';
+import type { GridAggregationModel, GridAggregationResult } from './grouping';
+import type { DataGridProps } from './props';
+import type { GridApi } from './api';
+
+/**
+ * Props the grid passes to `slots.toolbar`, before `slotProps.toolbar` is merged over them: the
+ * `GridToolbarProps` it controls (columns, models and their change handlers) plus `apiRef`.
+ * @since v3.0
+ */
+export interface GridToolbarSlotProps extends GridToolbarProps {
+  apiRef: React.MutableRefObject<GridApi>;
+}
+
+/**
+ * Props the grid passes to `slots.pagination`, before `slotProps.pagination` is merged over them.
+ * @since v3.0
+ */
+export type GridPaginationSlotProps = PaginationProps;
+
+/**
+ * Props of `slots.noRowsOverlay` and `slots.loadingOverlay`: the grid passes none of its own, only
+ * `slotProps.noRowsOverlay` / `slotProps.loadingOverlay`.
+ * @since v3.0
+ */
+export type GridOverlaySlotProps = Record<string, unknown>;
+
+/**
+ * Props the grid passes to `slots.footer`, before `slotProps.footer` is merged over them.
+ * @since v3.0
+ */
+export interface GridFooterSlotProps {
+  apiRef: React.MutableRefObject<GridApi>;
+  /** The active aggregation model (`{}` when none). */
+  aggregationModel: GridAggregationModel;
+  /** The grand-total aggregation result, or `null` when no aggregation is active. */
+  aggregationResult: GridAggregationResult | null;
+  /**
+   * The built-in pager's count: rows after filtering, pinned rows excluded (`rowCount` from the
+   * server in server pagination mode). Under tree data / row grouping: the filtered data rows.
+   */
+  rowCount: number;
+  /** Whether pagination is in effect (false under row grouping and infinite scroll). */
+  pagination: boolean;
+  paginationModel: GridPaginationModel;
+  pageSizeOptions: number[];
+  onPaginationModelChange: (model: GridPaginationModel) => void;
+}
+
+/** The `slots` prop of `DataGrid`: components that replace built-in parts of the grid. */
+export type GridSlots = NonNullable<DataGridProps['slots']>;
+
+/** The `slotProps` prop of `DataGrid`: props for each slot, keyed like `GridSlots`. */
+export type GridSlotProps = NonNullable<DataGridProps['slotProps']>;

package/lib/types/sorting.ts

@@ -0,0 +1,25 @@
+import type { GridRowId, GridRowModel, GridValidRowModel } from './rows';
+
+export type GridSortDirection = 'asc' | 'desc' | null;
+
+/**
+ * Parameters passed to `GridColDef.sortComparator` for each side of a comparison. For a row-grouping
+ * group row, `row` is the synthetic group row and `value` its grouping value.
+ * @since v3.1
+ */
+export interface GridSortCellParams<R extends GridValidRowModel = GridRowModel> {
+  id: GridRowId;
+  field: string;
+  row: R;
+  value: unknown;
+}
+
+export interface GridSortModel {
+  field: string;
+  sort: GridSortDirection;
+}
+
+export interface GridSortItem {
+  field: string;
+  sort: 'asc' | 'desc';
+}

package/lib/types/state.ts

@@ -0,0 +1,35 @@
+import type { GridRowId, GridRowModel, GridPinnedRows } from './rows';
+import type { GridColDef, GridColumnVisibilityModel, GridPinnedColumns } from './columns';
+
+export interface GridInternalState {
+  rows: {
+    idRowsLookup: Map<GridRowId, GridRowModel>;
+    allRows: GridRowId[];
+    /** Row object → its getRowId() key. Rows are stored untouched, so this is how ids are resolved. */
+    idByRow: Map<GridRowModel, GridRowId>;
+  };
+  pagination: {
+    /** Server-reported total (dataSource responses); undefined until one arrives. */
+    rowCount?: number;
+  };
+  columns: {
+    all: GridColDef[];
+    lookup: Map<string, GridColDef>;
+    orderedFields: string[];
+    columnVisibilityModel: GridColumnVisibilityModel;
+  };
+  pinning: {
+    pinnedColumns: GridPinnedColumns;
+    pinnedRows: GridPinnedRows;
+  };
+  dimensions: {
+    rowHeight: number;
+    headerHeight: number;
+    viewportWidth: number;
+    viewportHeight: number;
+  };
+  dataSource: {
+    loading: boolean;
+    error: unknown;
+  };
+}

package/llms.txt

@@ -1,6 +1,6 @@
 # OpenGridX — AI Agent Context
 # Package: @opencorestack/opengridx
-# Version: 3.6.0
+# Version: 3.7.0
 # Docs: https://opencorestack.github.io/OpenGridX/
 # This file is machine-readable. AI developers: start here.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencorestack/opengridx",
-  "version": "3.6.0",
+  "version": "3.7.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",
@@ -59,6 +59,7 @@
     "test:browser": "vitest run --project browser",
     "test:all": "vitest run",
     "test:smoke": "node scripts/smoke.mjs",
+    "test:demo": "npm run build && playwright test --config e2e/playwright.demo.config.ts",
     "bench": "node bench/run.mjs",
     "test:watch": "vitest --project unit",
     "coverage": "vitest run --coverage",
@@ -147,6 +148,7 @@
     "vitest": "^4.1.11"
   },
   "overrides": {
-    "uuid": "^11.1.1"
+    "uuid": "^11.1.1",
+    "source-map-js": "^1.2.2"
   }
 }