Skip to content

Commit f3d2ff1

Browse files
committed
chore(release): 3.5.0
1 parent 21f5612 commit f3d2ff1

11 files changed

Lines changed: 27 additions & 13 deletions

File tree

‎.github/ISSUE_TEMPLATE/bug_report.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ body:
3434
id: version
3535
attributes:
3636
label: OpenGridX version
37-
placeholder: "3.4.0"
37+
placeholder: "3.5.0"
3838
validations:
3939
required: true
4040
- type: dropdown

‎CHANGELOG.md‎

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

66
---
77

8-
## [Unreleased]
8+
## [3.5.0] — 2026-10-09
99

1010
### Added
1111

‎CLAUDE.md‎

Lines changed: 16 additions & 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.4.0
17+
- **Current version:** 3.5.0
1818

1919
---
2020

@@ -153,6 +153,21 @@ The GitHub wiki is generated from `docs/` + `wiki/` by `scripts/build-wiki.mjs`
153153

154154
---
155155

156+
## v3.5.0 — significant changes
157+
158+
Design: `docs/superpowers/specs/2026-10-09-ai-assistant-header-filters-fill-design.md`.
159+
160+
- **AI assistant** (`aiAssistant`): core holds the panel (`useGridAiAssistant`, hook 45a, before `useGridToolbarProps`; UI in `lib/components/AiAssistant/`), `/ai` holds model logic (`createGridAiPromptHandler`, `createGridAgentTools`). The core bundle must contain no AI code and `/ai` no React (`check-bundle`; `/ai` budget 8 kB, ≈ 6.7 kB now). `/ai` strings must never contain the word "react" or a lowercase `import`/`require(` (check-bundle regexes)
161+
- **Brand rule**: `validateGridAiState` brands result and `state` with the non-enumerable `Symbol.for('opengridx.ai.validated')` (`lib/utils/aiBrand.ts`); the grid applies only `isGridAiValidated(result.state)`. Parts the validator emptied are skipped; column visibility is merged; Undo restores a snapshot of touched parts (view undo, separate from `undoRedo`)
162+
- `GridAiState` / `GridAiPart` / `GridAiValidationError` and assistant types live in `lib/types/index.ts`; all `GridAi*` / `GridAgent*` types are exported from `/ai` only (publicApi rule `/^Grid(?:Ai|Agent)[A-Z]/`)
163+
- **Agent tools** are all-or-nothing on validation errors and never throw; `get_row_summary` exists only with `allowRowAccess`. They read `apiRef.current` at call time — create them in a handler/effect, not during render (`react-hooks/refs`)
164+
- `rowGroupingModel` is a controlled/uncontrolled pair (`onRowGroupingModelChange`) in `useGridControlledState`. New `GridApi`: `setSortModel`, `setRowGroupingModel`, `setAggregationModel`, `setColumnVisibilityModel`, `setPivotModel`, `getGridAiState`, `openAiAssistant`, `closeAiAssistant`
165+
- Two buttons swapped by a ternary inside a `<form>` need distinct `key`s, or the click on the outgoing one submits the form (the Stop button re-sent the prompt)
166+
- **Header filters** (`headerFilters`): each cell owns only the root `filterModel` item `id: 'header:<field>'` (`lib/utils/headerFilters.ts`: `getHeaderFilterState`, `setHeaderFilterItem`, which returns the same object for a model it can't show). Custom = `'or'` root with items, field inside a group, or an untagged/second root item on the field. Off in pivot mode
167+
- The filter row renders inside `.ogx__header-wrap` after `.ogx__header`; column cells of both rows must use `getHeaderColumnStyle` (`lib/components/Header/headerColumnStyle.ts`). Focus: `FocusedCell.headerFilter`; column header is row -2 when header filters are on, filter row -1. `useGridAriaRows({ headerFilterRow })`. "Custom filter" opens the panel via `GridToolbarHost.registerFiltersPanel` + `forceFiltersOpen` / `onFiltersPanelClose`
168+
- **Fill handle**: `useGridFillHandle` (hook 36d, after `useGridUndoRedo`) → `rowRenderProps.fillHandle` → `fillHandleCol` on the handle's row only; `RANGE_FILL_HANDLE` (32) flag; `.ogx__cell-fill-handle` (24 px hit area inside the corner cell). Drags go through `cellSelection.startTrackedDrag` (pointer events, touch, auto-scroll, Escape cancels). Pure fill logic in `lib/utils/editing/fill.ts` (no regexes); commits via `applyEdits(edits, 'fill')`; Ctrl/Cmd+D / R always copy
169+
- Smoke suites of parallel agents share ports 4318/4319 — never run two at once
170+
156171
## v3.4.0 — significant changes
157172

158173
- **Batch edits**: paste, range clear, undo and redo commit through `useGridBatchEdit.applyEdits` — one `processRowUpdate` per row (rows in parallel, a failing row reported through `onProcessRowUpdateError` without blocking others) and one `REPLACE_ROWS` store update for all successful rows. `getRow` sees rows stored since the last render. Single edits store through `storeRow`. Shared helpers in `lib/utils/editing/commit.ts`; edit targets (rows × range columns, same indices as `cellSelection.getCurrentRange().resolved`) in `lib/utils/editing/targets.ts`

‎demo/App.tsx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -165,7 +165,7 @@ export default function App() {
165165
<img src={`${import.meta.env.BASE_URL}logo.png`} alt="OpenGridX Logo" className="app-logo" />
166166
<h2 className="app-title">
167167
OpenGridX
168-
<span className="app-version">v3.4.0</span>
168+
<span className="app-version">v3.5.0</span>
169169
</h2>
170170
</div>
171171

‎demo/Home.tsx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ export default function Home(_props: HomeProps) {
6363
<div className="home-logo-hero">
6464
<img src={`${import.meta.env.BASE_URL}banner.png`} alt="OpenGridX Logo" className="home-banner-image" />
6565
</div>
66-
<span className="home-badge">OpenGridX v3.4.0</span>
66+
<span className="home-badge">OpenGridX v3.5.0</span>
6767
<p className="home-subtitle">
6868
The elite, high-performance DataGrid for modern React.
6969
Built to handle massive data with a premium developer experience.

‎demo/public/llms.txt‎

Lines changed: 1 addition & 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.4.0
3+
# Version: 3.5.0
44
# Docs: https://opencorestack.github.io/OpenGridX/
55
# This file is machine-readable. AI developers: start here.
66

‎docs/roadmap.md‎

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ This document tracks the current status of features in `OpenGridX` and outlines
8484
| :--- | :--- | :--- | :--- |
8585
| **3.3.0** ✅ | shipped 7 Oct | **Cell range selection** (opt-in `cellSelection` prop): mouse drag, Shift+click, Shift+arrows; Ctrl+C / Cmd+C copies the block as TSV | Selection status bar (count, sum, average of selected cells); wrapped header text; React Compiler compatibility check |
8686
| **3.4.0** ✅ | shipped 8 Oct | **Paste from Excel / Google Sheets** into the selection, through `processRowUpdate` (values parsed per column type or `valueParser`, non-editable cells skipped, `onClipboardPaste` summary); **Delete clears a range**; built-in inputs and editors use the shared `Input` / `Checkbox` (`Input variant="cell"`). **Undo / redo** for cell edits and pastes (Ctrl+Z, Ctrl+Shift+Z / Ctrl+Y, `apiRef.undo()` / `redo()`) | **AI toolkit, part 1** in a new `@opencorestack/opengridx/ai` entry point: `getGridAiSchema(columns)` (JSON Schema of the filter, sort, grouping, aggregation, pivot and visibility models the columns allow) and `validateGridAiState(json, columns)` (drops unknown fields and operators, coerces values, returns errors) |
87-
| **3.5.0** | 15 Dec | **AI toolkit, part 2**: `aiAssistant={{ onPrompt }}` prompt panel that calls the app's own model, shows the proposed changes as removable chips and applies them with undo; `createGridAgentTools(apiRef, columns)` (plain tool objects for CopilotKit, the Vercel AI SDK or WebMCP) | Header filter row; **fill handle** as a stretch goal (moves to Q1 2027 if 3.3–3.4 run late) |
87+
| **3.5.0** ✅ | shipped 9 Oct | **AI toolkit, part 2**: `aiAssistant={{ onPrompt }}` Ask AI panel (chips, Undo, voice) that calls the app's own model through `createGridAiPromptHandler`; only validated replies apply; `createGridAgentTools(apiRef, columns)` (plain tool objects for CopilotKit, the Vercel AI SDK, provider tool calling or WebMCP) | **Header filter row** (`headerFilters`); **fill handle** (series, Alt copy, Ctrl/Cmd+D / R); `rowGroupingModel` controlled/uncontrolled pair |
8888
| Freeze | 19 Dec – 5 Jan | Bug fixes only | — |
8989

9090
### Across the quarter
@@ -118,7 +118,6 @@ This document tracks the current status of features in `OpenGridX` and outlines
118118
## 🔭 Next (Q1 2027)
119119

120120
* **Row reordering inside tree data and row groups**, touch-friendly (MUI #4821, 405 👍, not in MUI X).
121-
* **Fill handle**, if it does not make 3.5.0.
122121
* **Find & highlight** (Ctrl+F through cells), **right-click context menu**, **Excel-style value (set) filter**.
123122
* **Calculated columns** (`[price] * [qty]` defined by users).
124123
* **Interactive pivot builder**: drag-and-drop panel for pivot and grouping.

‎llms.txt‎

Lines changed: 1 addition & 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.4.0
3+
# Version: 3.5.0
44
# Docs: https://opencorestack.github.io/OpenGridX/
55
# This file is machine-readable. AI developers: start here.
66

‎opengridx-ai-context.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ that uses the `@opencorestack/opengridx` library. Read it in full before writing
88
## What this library is
99

1010
`@opencorestack/opengridx` is a zero-dependency, high-performance React DataGrid component.
11-
Current version: **3.4.0**. It is a full custom implementation — not a wrapper around MUI or any
11+
Current version: **3.5.0**. It is a full custom implementation — not a wrapper around MUI or any
1212
other library.
1313

1414
---

‎package-lock.json‎

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)