@opencorestack/opengridx 3.9.1 → 3.10.0

package/CHANGELOG.md

@@ -5,6 +5,26 @@
 
 ---
 
+## [3.10.0] — 2026-10-13
+
+### Added
+
+- **The AI assistant's change chips are translatable**: 11 `localeText` keys (`aiAssistantChipSearch`, `ChipNoFilters`, `ChipSort(field, direction)`, `ChipNoSorting`, `ChipGroup`, `ChipNoGrouping`, `ChipSummary(fn, field)`, `ChipNoSummaries`, `ChipPivot`, `ChipNoPivot`, `ChipVisibility(field, visible)`), English by default; filter operators in the chips use `filterPanelOperators`. `buildAiChips` takes the texts as an optional third argument.
+
+### Performance
+
+- **Select all at 1,000,000 rows takes ~130 ms instead of ~260 ms** (deselect ~95 instead of ~120), with no API change. The selection set built for the new model is reused when that array comes back as `rowSelectionModel` (instead of `new Set(model)` again), and a set built by selecting all rows is known to contain them, so the header checkbox's "all selected" count is skipped. The shared selection set is typed `ReadonlySet` internally, so nothing can change it in place.
+
+### Internal
+
+- **Guards that fail CI instead of relying on review:** `check:versions` (llms.txt, CLAUDE.md and CHANGELOG must name the `package.json` version), `check:compiler` (fails on any React Compiler result outside a short allowlist, so a refactor that stops it from optimizing a hook is caught), ESLint `no-explicit-any` turned on (it was off; the library had none, the demo's 9 are now typed) and a rule against new `as unknown as` casts in the library outside the documented boundary files.
+
+- **Refactors (no behaviour change):** `GridToolbar` split into its panels with a shared `useToolbarPanel` (861 → 492 lines); the exporters one file per format; the xlsx cell helpers in `excelCells`; the cell range drag in `useGridCellRangeDrag`; keydown handling in a plain, unit-tested `handleGridKeyDown` function. Type casts `as unknown as` 43 → 15: the row pipeline, data source and grouping are called with the row type, the row store is typed with it, and column widenings go through one documented helper. DOM, styles and behaviour unchanged (theme baseline and the full browser suite in three engines).
+
+- Demo: the source viewer on every example page is syntax-highlighted (`CodeBlock`, prism-react-renderer), and the integration tips under it are corrected (inline columns and handlers are fine since 3.0 / 3.9; replace rows instead of mutating them).
+
+---
+
 ## [3.9.1] — 2026-10-13
 
 ### Fixed

package/dist/index.d.ts

@@ -162,6 +162,39 @@ export declare interface CsvExportOptions<R extends GridValidRowModel = GridRowM
     bom?: boolean;
 }
 
+export declare interface CsvExportOptions<R extends GridValidRowModel = GridRowModel> {
+    fileName?: string;
+    includeHeaders?: boolean;
+    delimiter?: string;
+    /**
+     * Export only these row IDs. A non-empty selection takes precedence over `groupedRows` (the
+     * selected rows are exported flat), and the totals row is recomputed over the selected rows.
+     */
+    selectedRows?: (string | number)[];
+    /**
+     * The grid's `getRowId`, when it has one: `selectedRows` holds those ids, and the grid does not
+     * copy them onto `row.id` (v3.0+). Defaults to `row.id`.
+     */
+    getRowId?: (row: R) => GridRowId;
+    aggregationResult?: Record<string, unknown> | null;
+    aggregationModel?: GridAggregationModel | null;
+    /** When provided, emits group headers, leaf rows, subtotals, and a grand total instead of a flat row list. */
+    groupedRows?: GridGroupedExportRow[];
+    /**
+     * Prefix text cells that start with `=`, `+`, `-`, `@`, tab or carriage return with `'`, so
+     * spreadsheet apps show them as text instead of running them as formulas (CSV injection).
+     * Plain signed numbers are left alone. Default: `true`
+     * @since v3.0
+     */
+    escapeFormulas?: boolean;
+    /**
+     * Start the file with a UTF-8 byte-order mark, so Excel reads non-ASCII text (é, ü, ₹, 中文)
+     * correctly. Default: `true`
+     * @since v3.0
+     */
+    bom?: boolean;
+}
+
 export declare const darkTheme: GridTheme;
 
 /**
@@ -1842,6 +1875,28 @@ export declare interface GridLocaleText {
     aiAssistantFailed?: (message: string) => string;
     /** Error text when a failed request has no message. Default: `"Unknown error"` @since v3.9 */
     aiAssistantUnknownError?: string;
+    /** Change chip for the quick-filter words. Default: `` (w) => `Search: ${w}` `` @since v3.10 */
+    aiAssistantChipSearch?: (words: string) => string;
+    /** Change chip when the reply cleared the filters. Default: `"No filters"` @since v3.10 */
+    aiAssistantChipNoFilters?: string;
+    /** Change chip for one sort key. Default: `` (f, d) => `Sort: ${f}, ascending|descending` `` @since v3.10 */
+    aiAssistantChipSort?: (field: string, direction: 'asc' | 'desc') => string;
+    /** Change chip when the reply cleared the sort. Default: `"No sorting"` @since v3.10 */
+    aiAssistantChipNoSorting?: string;
+    /** Change chip for one grouping field. Default: `` (f) => `Group: ${f}` `` @since v3.10 */
+    aiAssistantChipGroup?: (field: string) => string;
+    /** Change chip when the reply removed grouping. Default: `"No grouping"` @since v3.10 */
+    aiAssistantChipNoGrouping?: string;
+    /** Change chip for one summary; `fn` is the function id (`sum`, `avg`, …). Default: `` (fn, f) => `Sum: ${f}` `` (Sum, Average, Count, Min, Max, Unique) @since v3.10 */
+    aiAssistantChipSummary?: (fn: string, field: string) => string;
+    /** Change chip when the reply removed the summaries. Default: `"No summaries"` @since v3.10 */
+    aiAssistantChipNoSummaries?: string;
+    /** Change chip for the pivot; receives the column labels joined with ", ". Default: `` (f) => `Pivot: ${f}` `` @since v3.10 */
+    aiAssistantChipPivot?: (fields: string) => string;
+    /** Change chip when the reply turned the pivot off. Default: `"No pivot"` @since v3.10 */
+    aiAssistantChipNoPivot?: string;
+    /** Change chip for a column shown or hidden. Default: `` (f, v) => `Show: ${f}` `` / `` `Hide: ${f}` `` @since v3.10 */
+    aiAssistantChipVisibility?: (field: string, visible: boolean) => string;
     /** `aria-label` of the pagination bar. Default: `"Pagination"` @since v3.9 */
     paginationLabel?: string;
     /** Default: `"Go to first page"` @since v3.9 */