Skip to content

Commit 08ad5b6

Browse files
committed
chore(release): 3.10.1
1 parent b273a22 commit 08ad5b6

12 files changed

Lines changed: 61 additions & 8 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,11 @@
55

66
---
77

8-
## [Unreleased — 3.10.1]
8+
## [3.10.1] — 2026-10-13
9+
10+
### Fixed
11+
12+
- **RTL: header filter operator symbols are no longer mirrored.** The browser's bidi rules drew `∋` (contains) as `∈` (is any of) in right-to-left grids, so the two operators swapped their look. The operator button is now laid out left to right in every direction.
913

1014
### Performance
1115

@@ -17,6 +21,8 @@
1721

1822
### Internal
1923

24+
- A unit test runs row grouping on 5,000 rows and checks that the whole-dataset pass creates no leaf tree node and that a row's metadata object is made once and reused, so the lazy leaf maps cannot silently turn eager again.
25+
2026
- **Next.js fixture in the package smoke suite** (`e2e/fixtures/nextjs`, `e2e/nextjs.spec.ts`): a Next.js 16 App Router app built with `next build` (Turbopack) against the packed tarball, without the optional export peers and without `next.config` aliases. In Chromium, Firefox and WebKit the server-rendered HTML must contain the grid, the page must hydrate without console errors, sorting must work and `exportToExcelAdvanced` must reject with its install hint. The claims of `docs/features/nextjs.md` were checked once by hand before; CI now re-checks them on every run.
2127

2228
---

‎CLAUDE.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ This file is auto-loaded by Claude Code and other AI coding assistants. It provi
1414
- **Build:** `npm run build:lib` produces the published `dist/opengridx.es.js` / `dist/opengridx.umd.js`. `npm run build` type-checks the lib and builds the **demo site**.
1515
- **Published:** yes — on npm as `@opencorestack/opengridx` with external consumers. Treat public types and behaviour changes as semver-relevant.
1616
- **Lint:** `npm run lint` (ESLint). Must pass before every commit.
17-
- **Current version:** 3.10.0
17+
- **Current version:** 3.10.1
1818

1919
---
2020

‎demo/public/llms.txt‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# OpenGridX — AI Agent Context
22
# Package: @opencorestack/opengridx
3-
# Version: 3.10.0
3+
# Version: 3.10.1
44
# Docs: https://opencorestack.github.io/OpenGridX/
55
# This file is machine-readable. AI developers: start here.
66

@@ -735,3 +735,4 @@ Arrows move between cells (skipping hidden columns); Home/End, Ctrl+Home/End, Pa
735735
27. **Theme keys added in 3.9**: `grid.checkboxCheckedBackground`, `checkboxCheckmark`, `expandIconColor`, `expandIconHoverColor`; `overlays.itemIndicatorColor` (menu selection dot), `itemSelectedIcon`, `iconColor`, `sectionLabelText`, `dividerColor`. The demo's Theme Builder edits all of them.
736736
28. **3.10**: the AI assistant's change chips are `localeText` keys too (`aiAssistantChipSort(field, direction)`, `aiAssistantChipSummary(fn, field)`, …). Select-all at 1M rows takes ~130 ms. The library forbids `as unknown as` outside documented boundaries and `any` everywhere (ESLint), and CI checks that `llms.txt`, CLAUDE.md and the CHANGELOG name the `package.json` version.
737737
29. **Large client-side datasets**: sorting or filtering 1M rows blocks for ~0.4–0.5 s (one native sort). There is no time-sliced mode (measured and rejected: 1.5–2× slower overall). For interactive sorting and filtering at that size use a `dataSource`.
738+
30. **3.10.1**: at 1M rows select-all ~60–90 ms, deselect-all < 50 ms, applying a grouping ~190 ms, the quick filter's first search ~1.6–2 s (later keystrokes ~210 ms). Grouping creates leaf tree nodes and row metadata only when read, still one `params.rowMeta` object per row. A Next.js 16 App Router fixture in the package smoke suite re-checks the Next.js guide on every CI run.

‎docs/features/rtl.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ The column menu is labelled by screen side: in RTL *Pin to Left* adds the column
4343
## Known limitations
4444

4545
- ~~Menu and panel labels are hard-coded English~~: since v3.9 every built-in string, including the column menu (`columnMenuPinLeft`, `columnMenuSortAscending`, …), is a `localeText` key. See *Locale text for every UI string* in [`API_REFERENCE.md`](../API_REFERENCE.md).
46-
- **Header filter operator symbols** are mirrored by the browser's bidi rules (`∋` shows as `∈`), as in any RTL text.
46+
- ~~Header filter operator symbols are mirrored by the bidi rules~~: since v3.10.1 the operator button is laid out left to right, so `∋` (contains) and `∈` (is any of) look the same in both directions.
4747
- **`direction` set through CSS** (a class or stylesheet, not the `dir` attribute) and changed at runtime is not detected; scroll the grid or remount it with a `key`.
4848
- **Headless Chromium tests:** Playwright launches Chromium with `--hide-scrollbars`. With classic scrollbars (Linux) `scrollbar-gutter: stable` still reserves the gutter, and in RTL Chromium then cannot scroll the last gutter-width of the start into view (`scrollLeft` stops at minus the gutter). A plain scroller without the grid does the same and real browsers with visible scrollbars do not. Tests must compare with the browser's scroll origin, as `DataGrid.rtl.browser.test.tsx` does. To reproduce on macOS: `defaults write chrome-headless-shell AppleShowScrollBars Always` (undo with `defaults delete chrome-headless-shell`).
4949

‎docs/roadmap.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,7 @@ This document tracks the current status of features in `OpenGridX` and outlines
9494
| **3.9.0** ✅ | shipped 13 Oct | **`localeText` for every UI string** (~200 keys) | 9 theme keys + Theme Builder controls; rows stay memoised through selection and editing; demo sidebar by priority |
9595
| **3.9.1** ✅ | shipped 13 Oct | **npm package no longer ships 1.6 MB of test baselines** | `check:package` guard in CI; version badges read `package.json`; docs brought up to date |
9696
| **3.10.0** ✅ | shipped 13 Oct | **Backlog cleared**: refactors (R4–R6), CI guards, select-all ~2× faster | AI change chips translatable; demo syntax highlighting |
97+
| **3.10.1** ✅ | shipped 13 Oct | **1M-row performance**: select-all ~60–90 ms, grouping ~190 ms, quick filter first search ~1.6–2 s | Next.js smoke fixture; RTL operator symbols not mirrored |
9798
| Freeze | 19 Dec – 5 Jan | Bug fixes only | — |
9899

99100
### Now: backlog first (feature hold since 13 Oct; backlog cleared in 3.10)

‎lib/components/HeaderFilter/HeaderFilter.test.tsx‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -423,3 +423,12 @@ describe('header filter row — keyboard', () => {
423423
expect(document.activeElement?.closest('[role="row"]')?.getAttribute('data-rowindex')).toBe('0');
424424
});
425425
});
426+
427+
describe('header filter operator symbol in RTL (3.10.1)', () => {
428+
it('lays the operator button out left to right, so the bidi rules do not mirror its symbol', () => {
429+
const { container } = render(<div dir="rtl"><DataGrid rows={ROWS} columns={COLS} headerFilters /></div>);
430+
const buttons = container.querySelectorAll('.ogx__header-filter-operator');
431+
expect(buttons.length).toBeGreaterThan(0);
432+
buttons.forEach(b => expect(b.getAttribute('dir')).toBe('ltr'));
433+
});
434+
});

‎lib/components/HeaderFilter/HeaderFilterCell.tsx‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -281,6 +281,9 @@ export function HeaderFilterCell({ colDef, state, style, className, ariaColIndex
281281
type="button"
282282
className={`ogx__header-filter-operator${menuAnchor ? ' ogx__header-filter-operator--open' : ''}`}
283283
tabIndex={-1}
284+
// The operator symbol is a glyph, not text: left-to-right in every direction, so the
285+
// bidi rules do not mirror it in RTL (∋ "contains" would show as ∈ "is any of").
286+
dir="ltr"
284287
aria-haspopup="menu"
285288
aria-expanded={menuAnchor !== null}
286289
aria-label={locale.operatorButtonLabel(label, operatorLabel)}

‎lib/hooks/useRowGrouping.test.ts‎

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -481,3 +481,30 @@ describe('useRowGrouping — models passed inline', () => {
481481
expect(result.current.treeNodes).toBe(treeNodes);
482482
});
483483
});
484+
485+
describe('useRowGrouping — leaf objects are made lazily (3.10.1)', () => {
486+
it('getVisibleRows over every row makes no leaf node or metadata; reading a few makes only those', async () => {
487+
const { LazyLeafTreeNodes } = await import('../utils/grouping/lazyLeafMaps');
488+
const rows = Array.from({ length: 5000 }, (_, i) => ({ id: i, dept: `d${i % 5}`, name: `n${i}` }));
489+
const { result } = renderHook(() => useRowGrouping({
490+
rows,
491+
getRowId: (r: { id: number }) => r.id,
492+
columns: [{ field: 'dept' }, { field: 'name' }],
493+
rowGroupingModel: ['dept'],
494+
defaultGroupingExpansionDepth: -1,
495+
}));
496+
const visible = result.current.getVisibleRows();
497+
expect(visible?.length).toBe(5005);
498+
const nodes = result.current.treeNodes;
499+
expect(nodes).toBeInstanceOf(LazyLeafTreeNodes);
500+
// The whole-dataset pass (row pipeline) must not touch the leaves' objects.
501+
expect((nodes as InstanceType<typeof LazyLeafTreeNodes>).madeLeafCount).toBe(0);
502+
// Rendering reads the metadata of the rows on screen only: one object per row, the same on
503+
// every read, so writes to params.rowMeta stay on that row.
504+
const first = result.current.rowMetaMap.get(7);
505+
expect(first).toEqual({ hasChildren: false, treeDepth: 1, isGroupRow: false });
506+
expect(result.current.rowMetaMap.get(7)).toBe(first);
507+
expect(result.current.rowMetaMap.get(8)).not.toBe(first);
508+
expect((nodes as InstanceType<typeof LazyLeafTreeNodes>).madeLeafCount).toBe(0);
509+
});
510+
});

‎lib/utils/grouping/lazyLeafMaps.ts‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -76,6 +76,11 @@ export class LazyLeafTreeNodes extends Map<GridRowId, GridTreeNode> {
7676
return super.has(id) || this.leafIndex.has(id);
7777
}
7878

79+
/** How many leaf nodes were made so far (tests: rendering must not make one per row). */
80+
get madeLeafCount(): number {
81+
return this.leaves.size;
82+
}
83+
7984
override get size(): number {
8085
return super.size + this.leafIndex.size;
8186
}

‎llms.txt‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# OpenGridX — AI Agent Context
22
# Package: @opencorestack/opengridx
3-
# Version: 3.10.0
3+
# Version: 3.10.1
44
# Docs: https://opencorestack.github.io/OpenGridX/
55
# This file is machine-readable. AI developers: start here.
66

@@ -735,3 +735,4 @@ Arrows move between cells (skipping hidden columns); Home/End, Ctrl+Home/End, Pa
735735
27. **Theme keys added in 3.9**: `grid.checkboxCheckedBackground`, `checkboxCheckmark`, `expandIconColor`, `expandIconHoverColor`; `overlays.itemIndicatorColor` (menu selection dot), `itemSelectedIcon`, `iconColor`, `sectionLabelText`, `dividerColor`. The demo's Theme Builder edits all of them.
736736
28. **3.10**: the AI assistant's change chips are `localeText` keys too (`aiAssistantChipSort(field, direction)`, `aiAssistantChipSummary(fn, field)`, …). Select-all at 1M rows takes ~130 ms. The library forbids `as unknown as` outside documented boundaries and `any` everywhere (ESLint), and CI checks that `llms.txt`, CLAUDE.md and the CHANGELOG name the `package.json` version.
737737
29. **Large client-side datasets**: sorting or filtering 1M rows blocks for ~0.4–0.5 s (one native sort). There is no time-sliced mode (measured and rejected: 1.5–2× slower overall). For interactive sorting and filtering at that size use a `dataSource`.
738+
30. **3.10.1**: at 1M rows select-all ~60–90 ms, deselect-all < 50 ms, applying a grouping ~190 ms, the quick filter's first search ~1.6–2 s (later keystrokes ~210 ms). Grouping creates leaf tree nodes and row metadata only when read, still one `params.rowMeta` object per row. A Next.js 16 App Router fixture in the package smoke suite re-checks the Next.js guide on every CI run.

0 commit comments

Comments
 (0)