chore(release): 3.3.0

Author: asif7774

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -34,7 +34,7 @@ body:
     id: version
     attributes:
       label: OpenGridX version
-      placeholder: "3.2.2"
+      placeholder: "3.3.0"
     validations:
       required: true
   - type: dropdown

CHANGELOG.md

@@ -5,7 +5,7 @@
 
 ---
 
-## [Unreleased]
+## [3.3.0] — 2026-10-07
 
 ### Added
 

CLAUDE.md

@@ -14,7 +14,7 @@ This file is auto-loaded by Claude Code and other AI coding assistants. It provi
 - **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**.
 - **Published:** yes — on npm as `@opencorestack/opengridx` with external consumers. Treat public types and behaviour changes as semver-relevant.
 - **Lint:** `npm run lint` (ESLint). Must pass before every commit.
-- **Current version:** 3.2.2
+- **Current version:** 3.3.0
 
 ---
 
@@ -153,6 +153,17 @@ The GitHub wiki is generated from `docs/` + `wiki/` by `scripts/build-wiki.mjs`
 
 ---
 
+## v3.3.0 — significant changes
+
+- **Cell range selection** (`cellSelection`, design: `docs/superpowers/specs/2026-10-01-cell-range-selection-design.md`). `useGridCellSelection` runs after `useGridSpanning` and before `useGridKeyboardNavigation` (feeds it `cellSelection.keyboard`); `useGridCellSelectionApi` runs after `useGridPointerFocusHandlers`, keeps the anchor in sync with `focusedCell` and installs the six `apiRef` methods. Pure helpers in `lib/utils/cellSelection.ts`
+- The model stores corner row ids + fields and is resolved each render against `allRenderableRows` and the data columns of `navigationColumns`, so a range follows sorting; a missing corner clears it with reason `'dataChange'`. Only the first range is used. `isRangeColumnField` excludes system fields and `__group__`; synthetic rows are highlighted but skipped by copy and `getSelectedCells`
+- `Row` is `React.memo` (`areRowPropsEqual`, `cellRange` compared by value); row renderers pass `getRowCellRange(...)`, `null` outside the range. **Handlers passed to rows must keep a stable identity**, or every row re-renders
+- With `cellSelection` on, the Ctrl/Cmd+C shortcut copies the range (or the focused cell) through `useGridClipboard`'s `getShortcutText`, no header line; `copySelectedRows` is unchanged. A drag clears the page text selection (WebKit otherwise extends it outside the grid and takes over Ctrl+C)
+- Browser tests drive held-mouse drags with the Playwright-backed `commands.pointerMoveTo` / `pointerDown` / `pointerUp` from `vitest.config.ts`
+- **Wrapped header text**: `wrapHeaderText` (grid) and `GridColDef.wrapHeaderText` (column wins); `lib/utils/headerWrap.ts` (`getHeaderLineClamp`, `HEADER_WRAP_LINE_HEIGHT` 16 must match `Header.css`). The header never grows; class `ogx__header-cell--wrap`
+- **React Compiler**: ESLint runs `react-hooks` `recommended-latest` (only `set-state-in-effect` off). `npm run check:compiler` should report only `useGridDataSource` (try/finally) plus the two `'use no memo'` wrappers (`InlineToolbar`, `CellRenderTarget` — they call consumer functions that may use hooks). `REACT_COMPILER=1 npx vitest run …` tests `lib/` compiled. In components and hooks: no `?.`/`??`/`||`/ternaries inside `try` (use `attempt()` from `lib/utils/attempt.ts`), no `try/finally`, no callback naming itself (go through a ref), default array/object props as module-level constants
+- Vitest's unit project excludes `.claude/**` (agent worktrees)
+
 ## v3.2.2 — significant changes
 
 - Regexes that run on cell text or consumer input must be linear (CodeQL scans every push): no adjacent overlapping quantifiers such as `\s*(px)?\s*` or `[\d\s]*\d[\d\s]*`; use a lookahead, trim first, or a plain loop. Tests in `lib/utils/export/exportShared.test.ts` time 50k-char worst cases

demo/App.tsx

@@ -151,7 +151,7 @@ export default function App() {
                         <img src={`${import.meta.env.BASE_URL}logo.png`} alt="OpenGridX Logo" className="app-logo" />
                         <h2 className="app-title">
                             OpenGridX
-                            <span className="app-version">v3.2.2</span>
+                            <span className="app-version">v3.3.0</span>
                         </h2>
                     </div>
 

demo/Home.tsx

@@ -63,7 +63,7 @@ export default function Home(_props: HomeProps) {
                 <div className="home-logo-hero">
                     <img src={`${import.meta.env.BASE_URL}banner.png`} alt="OpenGridX Logo" className="home-banner-image" />
                 </div>
-                <span className="home-badge">OpenGridX v3.2.2</span>
+                <span className="home-badge">OpenGridX v3.3.0</span>
                 <p className="home-subtitle">
                     The elite, high-performance DataGrid for modern React.
                     Built to handle massive data with a premium developer experience.

demo/public/llms.txt

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

docs/roadmap.md

@@ -82,7 +82,7 @@ This document tracks the current status of features in `OpenGridX` and outlines
 
 | Release | Target | Headline | Also in it |
 | :--- | :--- | :--- | :--- |
-| **3.3.0** | 30 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 |
+| **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 |
 | **3.4.0** | 20 Nov | **Paste from Excel / Google Sheets** into the selection, through `processRowUpdate` (values parsed per column type, non-editable cells skipped, `onClipboardPasteError`). **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) |
 | **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)` (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) |
 | Freeze | 19 Dec – 5 Jan | Bug fixes only | — |

llms.txt

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

opengridx-ai-context.md

@@ -8,7 +8,7 @@ that uses the `@opencorestack/opengridx` library. Read it in full before writing
 ## What this library is
 
 `@opencorestack/opengridx` is a zero-dependency, high-performance React DataGrid component.
-Current version: **3.2.2**. It is a full custom implementation — not a wrapper around MUI or any
+Current version: **3.3.0**. It is a full custom implementation — not a wrapper around MUI or any
 other library.
 
 ---