@svgrid/grid 3.0.0 → 3.0.2

package/CHANGELOG.md

@@ -4,6 +4,34 @@ Releases above 1.2.3 are generated from the commit subjects in each release tag
 (`node tools/build-changelog.mjs`), so they describe what changed rather than
 reading as polished release notes. Entries from 1.2.3 down are hand-written.
 
+## 3.0.0
+
+_2026-09-07_
+
+- Release 3.0.0 across the suite
+- Record the versions published from this tree
+- Docs: teach the 3.0 tool names and what the server now does
+- migrate: handle createColumnHelper columns
+- Measure the MCP server instead of asserting it is good
+- Hosted MCP server reaches parity, and answers its own aliases
+- MCP 3.0: a small, verified, offline surface
+
+## 2.6.23
+
+_2026-09-07_
+
+- Framework docs use the wrapper, not the raw element
+- Guard the Angular / TypeScript pairing the sandbox depends on
+- Framework wrappers for grid-wc, runnable examples, and a web-components docs category
+
+## 2.6.22
+
+_2026-09-04_
+
+- docs updates
+- row and column resizing props and updated docs
+- MCP Server Updates
+
 ## 2.6.21
 
 _2026-08-31_
@@ -318,91 +346,91 @@ _2026-07-07_
 
 <!-- build-changelog: hand-written entries below this line -->
 
-## 1.2.3
-
-### Fixed
-
-- **Pinned columns no longer disappear when column virtualization is on.** A
-  pinned column is `position: sticky`, so it only stays pinned while its cell is
-  in the DOM - but column virtualization dropped it once it scrolled out of the
-  window, so scrolling far enough sideways made the frozen column vanish (the
-  workaround was `columnVirtualization={false}`). The rendered column window now
-  stays contiguous through the pinned-left prefix and pinned-right suffix, so
-  pinned cells are always rendered and pinning + column virtualization work
-  together. No API change.
-- **No more "ResizeObserver loop completed with undelivered notifications"
-  console noise.** The grid's internal `ResizeObserver`s (header height, root
-  size, viewport size, and the custom scrollbar) mutated layout state
-  synchronously inside the observe callback, which the browser reports with that
-  benign-but-noisy warning - most visibly when a whole grid is swapped at once
-  (e.g. switching demos in the playground). The callbacks now coalesce onto the
-  next animation frame, so each delivery cycle finishes cleanly and the warning
-  is gone. Behaviour is unchanged; the remeasure just happens one frame later.
-
-## 1.2.2
-
-### Fixed
-
-- **The grid now themes itself out of the box.** Styling that previously lived
-  only in the examples' host stylesheet is now shipped in the grid's own CSS, so
-  a bare `@svgrid/grid` install (or the single-file / CDN builds) renders a
-  complete grid with no extra stylesheet:
-  - **Cell grid lines** (per-cell right + bottom borders, clean outer edge),
-  - **Row hover** tint,
-  - **Pagination footer** (layout, page-size select, prev/next buttons, labels)
-    - `GridFooter.svelte` shipped with no styles at all before,
-  - **Filter inputs** - the header filter row, per-column filter, global search
-    box, and menu search/condition inputs now get a tokenized background +
-    border out of the box (previously only the inline cell editor + menu inputs
-    were styled), with a calm box-shadow focus instead of a hard outline.
-  - **Column menu + filter chrome** - the filter-operator `<select>`, the
-    "search values" magnifier, the facet checklist's native checkboxes
-    (accent-colored), the submenu chevron, the filter/choose-columns popover
-    widths, the filter-menu spacing, and the active-filter funnel tint are now
-    themed by the grid (were host-only, so bare consumers saw unstyled menus).
-  - **Selection checkbox** fills with the accent (was the lighter selection
-    tint); **column resize handle** shows an accent center pill on hover/drag;
-    scrollbar-corner divider, group-row label, and a few operator/button states
-    now use tokens instead of hardcoded values.
-
-  All driven by the existing `--sg-*` tokens with sensible fallbacks; consumer
-  overrides still win, so the examples/site look unchanged. Every redundant
-  `.sv-grid-*` override was removed from the examples' + website's host
-  stylesheets - they now carry only demo helpers, no grid chrome.
-
-- **Pinned columns were semi-transparent.** The default pinned-cell tint used
-  `color-mix(... 70%, ... 8%)` whose percentages sum to 78%, which per spec
-  yields a 78%-opaque colour - so scrolling rows bled through the frozen column.
-  The mixes now sum to 100% (`92%/8%`, `86%/14%`) and are fully opaque.
-- **Right-aligned values hid under the vertical scrollbar.** The custom
-  scrollbar overlays the right 16px of the viewport, and the scrollbar-width
-  reservation only ran in `fitColumns` mode. The last column's right-aligned
-  content now gets 16px of extra right padding whenever the vertical scrollbar
-  is visible, so numbers stay clear of it.
-
-## 1.2.0
-
-### Added
-
-- **CDN bundles.** Pre-compiled ESM bundles under `dist/cdn/` (CSS inlined):
-  - `svgrid.js` - Svelte runtime bundled in; a self-contained drop-in exposed
-    via the `unpkg` / `jsdelivr` fields and the `./cdn` export.
-  - `svgrid.svelte-external.js` - Svelte kept external (`./cdn/svelte-external`
-    export), so a page that compiles its own component can share ONE Svelte
-    runtime with the grid. Powers the website's "copy runnable Svelte HTML"
-    single-file export.
-
-  The main `exports` still ship the Svelte-source library, so npm + Vite /
-  SvelteKit consumers keep tree-shaking and normal compilation - nothing
-  changes for them.
-
-### Fixed
-
-- **Smaller install.** Test artifacts (`*.test.*`, `*.spec.*`, `test-setup.*`,
-  `test-fixtures/`) are stripped from the published `dist/` (~130 files that
-  were previously shipped to every installer).
-- **Valid HTML / accessibility.** The multi-select dropdown no longer nests a
-  `<button>` (the chip "remove" control) inside the trigger `<button>` - the
-  remove control is now a `role="button"` span with identical behaviour. The
-  Excel fill handle carries an explicit `tabindex`, and a stray tabindex lint on
-  the free-form chips editor was resolved.
+## 1.2.3
+
+### Fixed
+
+- **Pinned columns no longer disappear when column virtualization is on.** A
+  pinned column is `position: sticky`, so it only stays pinned while its cell is
+  in the DOM - but column virtualization dropped it once it scrolled out of the
+  window, so scrolling far enough sideways made the frozen column vanish (the
+  workaround was `columnVirtualization={false}`). The rendered column window now
+  stays contiguous through the pinned-left prefix and pinned-right suffix, so
+  pinned cells are always rendered and pinning + column virtualization work
+  together. No API change.
+- **No more "ResizeObserver loop completed with undelivered notifications"
+  console noise.** The grid's internal `ResizeObserver`s (header height, root
+  size, viewport size, and the custom scrollbar) mutated layout state
+  synchronously inside the observe callback, which the browser reports with that
+  benign-but-noisy warning - most visibly when a whole grid is swapped at once
+  (e.g. switching demos in the playground). The callbacks now coalesce onto the
+  next animation frame, so each delivery cycle finishes cleanly and the warning
+  is gone. Behaviour is unchanged; the remeasure just happens one frame later.
+
+## 1.2.2
+
+### Fixed
+
+- **The grid now themes itself out of the box.** Styling that previously lived
+  only in the examples' host stylesheet is now shipped in the grid's own CSS, so
+  a bare `@svgrid/grid` install (or the single-file / CDN builds) renders a
+  complete grid with no extra stylesheet:
+  - **Cell grid lines** (per-cell right + bottom borders, clean outer edge),
+  - **Row hover** tint,
+  - **Pagination footer** (layout, page-size select, prev/next buttons, labels)
+    - `GridFooter.svelte` shipped with no styles at all before,
+  - **Filter inputs** - the header filter row, per-column filter, global search
+    box, and menu search/condition inputs now get a tokenized background +
+    border out of the box (previously only the inline cell editor + menu inputs
+    were styled), with a calm box-shadow focus instead of a hard outline.
+  - **Column menu + filter chrome** - the filter-operator `<select>`, the
+    "search values" magnifier, the facet checklist's native checkboxes
+    (accent-colored), the submenu chevron, the filter/choose-columns popover
+    widths, the filter-menu spacing, and the active-filter funnel tint are now
+    themed by the grid (were host-only, so bare consumers saw unstyled menus).
+  - **Selection checkbox** fills with the accent (was the lighter selection
+    tint); **column resize handle** shows an accent center pill on hover/drag;
+    scrollbar-corner divider, group-row label, and a few operator/button states
+    now use tokens instead of hardcoded values.
+
+  All driven by the existing `--sg-*` tokens with sensible fallbacks; consumer
+  overrides still win, so the examples/site look unchanged. Every redundant
+  `.sv-grid-*` override was removed from the examples' + website's host
+  stylesheets - they now carry only demo helpers, no grid chrome.
+
+- **Pinned columns were semi-transparent.** The default pinned-cell tint used
+  `color-mix(... 70%, ... 8%)` whose percentages sum to 78%, which per spec
+  yields a 78%-opaque colour - so scrolling rows bled through the frozen column.
+  The mixes now sum to 100% (`92%/8%`, `86%/14%`) and are fully opaque.
+- **Right-aligned values hid under the vertical scrollbar.** The custom
+  scrollbar overlays the right 16px of the viewport, and the scrollbar-width
+  reservation only ran in `fitColumns` mode. The last column's right-aligned
+  content now gets 16px of extra right padding whenever the vertical scrollbar
+  is visible, so numbers stay clear of it.
+
+## 1.2.0
+
+### Added
+
+- **CDN bundles.** Pre-compiled ESM bundles under `dist/cdn/` (CSS inlined):
+  - `svgrid.js` - Svelte runtime bundled in; a self-contained drop-in exposed
+    via the `unpkg` / `jsdelivr` fields and the `./cdn` export.
+  - `svgrid.svelte-external.js` - Svelte kept external (`./cdn/svelte-external`
+    export), so a page that compiles its own component can share ONE Svelte
+    runtime with the grid. Powers the website's "copy runnable Svelte HTML"
+    single-file export.
+
+  The main `exports` still ship the Svelte-source library, so npm + Vite /
+  SvelteKit consumers keep tree-shaking and normal compilation - nothing
+  changes for them.
+
+### Fixed
+
+- **Smaller install.** Test artifacts (`*.test.*`, `*.spec.*`, `test-setup.*`,
+  `test-fixtures/`) are stripped from the published `dist/` (~130 files that
+  were previously shipped to every installer).
+- **Valid HTML / accessibility.** The multi-select dropdown no longer nests a
+  `<button>` (the chip "remove" control) inside the trigger `<button>` - the
+  remove control is now a `role="button"` span with identical behaviour. The
+  Excel fill handle carries an explicit `tabindex`, and a stray tabindex lint on
+  the free-form chips editor was resolved.

package/README.md

@@ -1,170 +1,170 @@
-<p align="center">
-  <img src="https://svgrid.com/brand/svgrid-logo-icon-1200.png" alt="SvGrid" width="100" height="100" />
-</p>
-
-<h1 align="center">@svgrid/grid</h1>
-
-<p align="center"><strong>The Svelte 5 native data grid. Headless-first. Render-ready.</strong></p>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/@svgrid/grid"><img src="https://img.shields.io/npm/v/%40svgrid%2Fgrid.svg?label=%40svgrid%2Fgrid" alt="npm version" /></a>
-  <a href="https://www.npmjs.com/package/@svgrid/grid"><img src="https://img.shields.io/npm/dm/%40svgrid%2Fgrid.svg" alt="npm downloads" /></a>
-  <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-brightgreen.svg" alt="MIT License" /></a>
-  <a href="https://www.npmjs.com/package/@svgrid/grid"><img src="https://img.shields.io/badge/types-included-blue.svg" alt="TypeScript" /></a>
-  <a href="https://svelte.dev"><img src="https://img.shields.io/badge/svelte-5-ff3e00.svg" alt="Svelte 5" /></a>
-</p>
-
-<p align="center">
-  <a href="https://svgrid.com">Website</a> ·
-  <a href="https://svgrid.com/docs/">Docs</a> ·
-  <a href="https://svgrid.com/demos/">370+ Demos</a> ·
-  <a href="https://svgrid.com/pricing/">Pricing</a> ·
-  <a href="https://svgrid.com/roadmap/">Roadmap</a>
-</p>
-
----
-
-A production-grade **Svelte 5 data grid and data table** built from the first line for **runes**, not a
-React grid wrapped in a Svelte shim. Virtual scrolling over 100k+ rows, Excel-style filtering, inline
-editing, row grouping, tree data, and server-side data. Compose the headless engine yourself, or drop in
-the full `<SvGrid />` render component and ship. The MIT core has **zero feature gating**: no license key,
-no watermark, no row-count cap.
-
-<p align="center">
-  <img src="https://svgrid.com/brand/svgrid-hero.png" alt="A SvGrid trading desk: KPI cards, sector filter chips, and a virtualized data table with sparkline trend columns, conditional colour, and pinned columns." width="100%" />
-</p>
-
-## Install
-
-Scaffold a working Vite + Svelte 5 app with SvGrid wired up:
-
-```bash
-npm create @svgrid@latest
-```
-
-Or add it to an existing app:
-
-```bash
-npm install @svgrid/grid
-```
-
-## Quick start
-
-```svelte
-<script lang="ts">
-  import { SvGrid, type ColumnDef } from '@svgrid/grid'
-
-  const rows = [
-    { firstName: 'Ada',   age: 36, status: 'active' },
-    { firstName: 'Linus', age: 54, status: 'active' },
-    { firstName: 'Grace', age: 85, status: 'inactive' },
-  ]
-  const columns: ColumnDef<{}, (typeof rows)[number]>[] = [
-    { field: 'firstName', header: 'First name' },
-    { field: 'age',       header: 'Age' },
-    { field: 'status',    header: 'Status' },
-  ]
-</script>
-
-<SvGrid data={rows} columns={columns} />
-```
-
-That is a real, accessible grid. Sorting, filtering, virtualization, cell selection, and inline editing
-all wire up the moment you turn on the matching prop.
-
-## Quick facts
-
-| | |
-|---|---|
-| **License** | MIT, free for commercial use |
-| **Requires** | `svelte@^5` (peer dependency), Node 16+ |
-| **Bundle (gzip)** | ~2 KB headless core, ~80 KB full `<SvGrid>` + ~9 KB CSS |
-| **Types** | Bundled, no `@types/` package needed |
-| **Module format** | ESM, plus a CDN build at `@svgrid/grid/cdn` |
-| **SSR** | Works under SvelteKit SSR and static builds |
-| **Theming** | `--sg-*` CSS custom properties, dark mode + high contrast |
-
-## Capabilities
-
-- **Virtual scrolling** - row + column windowing; 100k x 100 stays smooth, with a 1M-row demo.
-- **Filtering** - Excel-style filter menu, inline filter row, set / value-list filter, locale-aware matching, between operators.
-- **Editing** - 15 built-in `editorType`s (text, number, date, datetime, time, select, rich-select with typeahead, autocomplete, textarea, color, checkbox, list, chips, rating, password), plus `date-native` / `datetime-native` / `time-native` to opt out of the rich pickers, and a `cellEditor` snippet slot for anything custom.
-- **Selection** - cell-range click+drag and Shift+arrows, copy/paste as TSV, Excel-style fill handle, row selection.
-- **Views** - row grouping with aggregation, tree data, master/detail, full-width detail rows, spreadsheet mode with formulas.
-- **Layout** - row + column pinning, sticky header + first column, header drag-to-reorder, autosize, keyboard-accessible column sizing, zebra rows, responsive mode.
-- **Data operations** - find in grid (Ctrl+F), undo / redo, transaction API, optimistic updates, server-side row model with sort / filter / group pushdown.
-- **AI helpers, free** - natural-language filter, smart fill, summarize, classify, anomaly detection, and "chart this". Model-agnostic: register one provider, nothing is bundled.
-- **UI components** - a Svelte 5 component suite ships in the package (inputs, selection, date/time, overlays, layout, feedback), standalone or as grid cell editors.
-- **Accessibility** - WAI-ARIA grid roles, full keyboard navigation, RTL, high-contrast theme.
-- **Engineered for production** - first-class TypeScript types, CSP / Trusted-Types safe rendering, SSR-friendly, themeable via `--sg-*` CSS tokens.
-
-## Headless or render-ready
-
-SvGrid ships two layers from one package, so you can choose how much control you want:
-
-```ts
-import {
-  // Drop-in render component
-  SvGrid,
-  // Headless engine + row-model factories
-  createSvGrid,
-  createCoreRowModel,
-  createFilteredRowModel,
-  createSortedRowModel,
-  createGroupedRowModel,
-  createExpandedRowModel,
-  createPaginatedRowModel,
-  // Feature modules
-  tableFeatures,
-  rowSortingFeature,
-  columnFilteringFeature,
-  columnGroupingFeature,
-  rowExpandingFeature,
-  rowPaginationFeature,
-  rowSelectionFeature,
-  // Cell renderers
-  renderSnippet,
-  renderComponent,
-  type ColumnDef,
-  type SvGridApi,
-} from '@svgrid/grid'
-```
-
-- **Headless** - drive `createSvGrid` and the row-model factories, render your own markup.
-  `getGrid*A11yProps` helpers keep custom markup accessible. About 2 KB gzipped.
-- **Render-ready** - `<SvGrid />` is a complete, accessible, themeable grid you configure with props.
-
-Compatibility aliases are provided for the framework-neutral names: `createGrid`, `createGridState`,
-`subscribeGrid`.
-
-## AI-native
-
-SvGrid publishes an [MCP server](https://www.npmjs.com/package/@svgrid/mcp) plus
-[llms.txt](https://svgrid.com/llms.txt) and [llms-full.txt](https://svgrid.com/llms-full.txt), so Claude,
-Cursor, and Zed answer with accurate, version-pinned APIs and all 370+ demo sources as context rather
-than hallucinated methods.
-
-```bash
-claude mcp add svgrid -- npx -y @svgrid/mcp
-npx skills add sv-grid/sv-grid    # always-on house-style rules
-```
-
-See [Use sv-grid docs as LLM context](https://svgrid.com/docs/help/llm-grounding/).
-
-## Enterprise features
-
-The MIT core is free for any use, including commercial, with **no feature gating**. Sorting, filtering,
-editing, virtualization, the **server-side row model**, and the **AI helpers** all ship in the free
-package. The optional [`@svgrid/enterprise`](https://www.npmjs.com/package/@svgrid/enterprise) pack layers
-on the export- and analytics-heavy features teams tend to need last:
-
-- **Excel / PDF / CSV / TSV / HTML export** plus paginated print.
-- **Excel / CSV / TSV / JSON import** with auto-mapping and per-row validation.
-- **Pivot tables** with a drag-and-drop pivot Designer.
-- **Kanban board and scheduler / calendar renderers** for the `board` and `scheduler` props.
-
-OSS projects receive an Enterprise key free. See [Pricing](https://svgrid.com/pricing/).
-
+<p align="center">
+  <img src="https://svgrid.com/brand/svgrid-logo-icon-1200.png" alt="SvGrid" width="100" height="100" />
+</p>
+
+<h1 align="center">@svgrid/grid</h1>
+
+<p align="center"><strong>The Svelte 5 native data grid. Headless-first. Render-ready.</strong></p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@svgrid/grid"><img src="https://img.shields.io/npm/v/%40svgrid%2Fgrid.svg?label=%40svgrid%2Fgrid" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/@svgrid/grid"><img src="https://img.shields.io/npm/dm/%40svgrid%2Fgrid.svg" alt="npm downloads" /></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-brightgreen.svg" alt="MIT License" /></a>
+  <a href="https://www.npmjs.com/package/@svgrid/grid"><img src="https://img.shields.io/badge/types-included-blue.svg" alt="TypeScript" /></a>
+  <a href="https://svelte.dev"><img src="https://img.shields.io/badge/svelte-5-ff3e00.svg" alt="Svelte 5" /></a>
+</p>
+
+<p align="center">
+  <a href="https://svgrid.com">Website</a> ·
+  <a href="https://svgrid.com/docs/">Docs</a> ·
+  <a href="https://svgrid.com/demos/">370+ Demos</a> ·
+  <a href="https://svgrid.com/pricing/">Pricing</a> ·
+  <a href="https://svgrid.com/roadmap/">Roadmap</a>
+</p>
+
+---
+
+A production-grade **Svelte 5 data grid and data table** built from the first line for **runes**, not a
+React grid wrapped in a Svelte shim. Virtual scrolling over 100k+ rows, Excel-style filtering, inline
+editing, row grouping, tree data, and server-side data. Compose the headless engine yourself, or drop in
+the full `<SvGrid />` render component and ship. The MIT core has **zero feature gating**: no license key,
+no watermark, no row-count cap.
+
+<p align="center">
+  <img src="https://svgrid.com/brand/svgrid-hero.png" alt="A SvGrid trading desk: KPI cards, sector filter chips, and a virtualized data table with sparkline trend columns, conditional colour, and pinned columns." width="100%" />
+</p>
+
+## Install
+
+Scaffold a working Vite + Svelte 5 app with SvGrid wired up:
+
+```bash
+npm create @svgrid@latest
+```
+
+Or add it to an existing app:
+
+```bash
+npm install @svgrid/grid
+```
+
+## Quick start
+
+```svelte
+<script lang="ts">
+  import { SvGrid, type ColumnDef } from '@svgrid/grid'
+
+  const rows = [
+    { firstName: 'Ada',   age: 36, status: 'active' },
+    { firstName: 'Linus', age: 54, status: 'active' },
+    { firstName: 'Grace', age: 85, status: 'inactive' },
+  ]
+  const columns: ColumnDef<{}, (typeof rows)[number]>[] = [
+    { field: 'firstName', header: 'First name' },
+    { field: 'age',       header: 'Age' },
+    { field: 'status',    header: 'Status' },
+  ]
+</script>
+
+<SvGrid data={rows} columns={columns} />
+```
+
+That is a real, accessible grid. Sorting, filtering, virtualization, cell selection, and inline editing
+all wire up the moment you turn on the matching prop.
+
+## Quick facts
+
+| | |
+|---|---|
+| **License** | MIT, free for commercial use |
+| **Requires** | `svelte@^5` (peer dependency), Node 16+ |
+| **Bundle (gzip)** | ~2 KB headless core, ~80 KB full `<SvGrid>` + ~9 KB CSS |
+| **Types** | Bundled, no `@types/` package needed |
+| **Module format** | ESM, plus a CDN build at `@svgrid/grid/cdn` |
+| **SSR** | Works under SvelteKit SSR and static builds |
+| **Theming** | `--sg-*` CSS custom properties, dark mode + high contrast |
+
+## Capabilities
+
+- **Virtual scrolling** - row + column windowing; 100k x 100 stays smooth, with a 1M-row demo.
+- **Filtering** - Excel-style filter menu, inline filter row, set / value-list filter, locale-aware matching, between operators.
+- **Editing** - 15 built-in `editorType`s (text, number, date, datetime, time, select, rich-select with typeahead, autocomplete, textarea, color, checkbox, list, chips, rating, password), plus `date-native` / `datetime-native` / `time-native` to opt out of the rich pickers, and a `cellEditor` snippet slot for anything custom.
+- **Selection** - cell-range click+drag and Shift+arrows, copy/paste as TSV, Excel-style fill handle, row selection.
+- **Views** - row grouping with aggregation, tree data, master/detail, full-width detail rows, spreadsheet mode with formulas.
+- **Layout** - row + column pinning, sticky header + first column, header drag-to-reorder, autosize, keyboard-accessible column sizing, zebra rows, responsive mode.
+- **Data operations** - find in grid (Ctrl+F), undo / redo, transaction API, optimistic updates, server-side row model with sort / filter / group pushdown.
+- **AI helpers, free** - natural-language filter, smart fill, summarize, classify, anomaly detection, and "chart this". Model-agnostic: register one provider, nothing is bundled.
+- **UI components** - a Svelte 5 component suite ships in the package (inputs, selection, date/time, overlays, layout, feedback), standalone or as grid cell editors.
+- **Accessibility** - WAI-ARIA grid roles, full keyboard navigation, RTL, high-contrast theme.
+- **Engineered for production** - first-class TypeScript types, CSP / Trusted-Types safe rendering, SSR-friendly, themeable via `--sg-*` CSS tokens.
+
+## Headless or render-ready
+
+SvGrid ships two layers from one package, so you can choose how much control you want:
+
+```ts
+import {
+  // Drop-in render component
+  SvGrid,
+  // Headless engine + row-model factories
+  createSvGrid,
+  createCoreRowModel,
+  createFilteredRowModel,
+  createSortedRowModel,
+  createGroupedRowModel,
+  createExpandedRowModel,
+  createPaginatedRowModel,
+  // Feature modules
+  tableFeatures,
+  rowSortingFeature,
+  columnFilteringFeature,
+  columnGroupingFeature,
+  rowExpandingFeature,
+  rowPaginationFeature,
+  rowSelectionFeature,
+  // Cell renderers
+  renderSnippet,
+  renderComponent,
+  type ColumnDef,
+  type SvGridApi,
+} from '@svgrid/grid'
+```
+
+- **Headless** - drive `createSvGrid` and the row-model factories, render your own markup.
+  `getGrid*A11yProps` helpers keep custom markup accessible. About 2 KB gzipped.
+- **Render-ready** - `<SvGrid />` is a complete, accessible, themeable grid you configure with props.
+
+Compatibility aliases are provided for the framework-neutral names: `createGrid`, `createGridState`,
+`subscribeGrid`.
+
+## AI-native
+
+SvGrid publishes an [MCP server](https://www.npmjs.com/package/@svgrid/mcp) plus
+[llms.txt](https://svgrid.com/llms.txt) and [llms-full.txt](https://svgrid.com/llms-full.txt), so Claude,
+Cursor, and Zed answer with accurate, version-pinned APIs and all 370+ demo sources as context rather
+than hallucinated methods.
+
+```bash
+claude mcp add svgrid -- npx -y @svgrid/mcp
+npx skills add sv-grid/sv-grid    # always-on house-style rules
+```
+
+See [Use sv-grid docs as LLM context](https://svgrid.com/docs/help/llm-grounding/).
+
+## Enterprise features
+
+The MIT core is free for any use, including commercial, with **no feature gating**. Sorting, filtering,
+editing, virtualization, the **server-side row model**, and the **AI helpers** all ship in the free
+package. The optional [`@svgrid/enterprise`](https://www.npmjs.com/package/@svgrid/enterprise) pack layers
+on the export- and analytics-heavy features teams tend to need last:
+
+- **Excel / PDF / CSV / TSV / HTML export** plus paginated print.
+- **Excel / CSV / TSV / JSON import** with auto-mapping and per-row validation.
+- **Pivot tables** with a drag-and-drop pivot Designer.
+- **Kanban board and scheduler / calendar renderers** for the `board` and `scheduler` props.
+
+OSS projects receive an Enterprise key free. See [Pricing](https://svgrid.com/pricing/).
+
 ## Also in the box
 
 The grid is the hero, but it is not everything in the package. The component suite below already ships
@@ -187,35 +187,35 @@ inside `@svgrid/grid`; the tools after it install separately and are entirely op
 - **[SvGrid Studio](https://svgrid.com/docs/studio/)** (commercial) - visual designer that generates a
   SvelteKit CRUD app from a database schema: screens, forms, API routes, auth. Code you own, no runtime.
 
-## Comparison
-
-| | SvGrid | AG Grid Community | TanStack Table |
-|---|---|---|---|
-| **Svelte 5 runes native** | Yes | No, JS core + wrapper | Adapter only |
-| **Ships a renderer** | Yes, plus headless | Yes | No, headless only |
-| **Bundle (gzip)** | ~2 KB headless / ~80 KB full | ~340 KB | ~12-14 KB |
-| **Master/detail, tree, range selection** | Free | Enterprise only | Build it yourself |
-
-Full detail: [SvGrid vs AG Grid vs TanStack Table](https://svgrid.com/docs/help/comparison/) ·
-[Migrating from AG Grid](https://svgrid.com/docs/help/migrating-from-ag-grid/)
-
-## Documentation
-
-- [Getting started](https://svgrid.com/docs/getting-started/) - end-to-end walkthrough.
-- [370+ live demos](https://svgrid.com/demos/) - copy-paste recipes for every feature.
-- [Why headless?](https://svgrid.com/docs/why-headless/) - when to compose vs. drop in.
-- [Theming and Tailwind](https://svgrid.com/docs/help/tailwind/) - re-skin via `--sg-*` tokens and dark mode.
-- [Accessibility](https://svgrid.com/docs/help/accessibility/) - the WAI-ARIA grid pattern as implemented.
-- [Bundle size](https://svgrid.com/docs/reference/bundle-size/) - measured numbers and how to reproduce them.
-
-## Who's behind it
-
-SvGrid is built by [jQWidgets](https://www.jqwidgets.com), shipping UI components since 2011 to 5,000+
-companies including Samsung, Boeing, NVIDIA, Microsoft, Nokia, and Intel. SvGrid is our Svelte 5 native
-effort.
-
-## License & trademark
-
-The source code is **MIT-licensed** - see [LICENSE](./LICENSE). It is free for commercial use.
-SvGrid&trade; and sv-grid&trade; are trademarks of jQWidgets Ltd; the license covers the code only, not
-the name or logo.
+## Comparison
+
+| | SvGrid | AG Grid Community | TanStack Table |
+|---|---|---|---|
+| **Svelte 5 runes native** | Yes | No, JS core + wrapper | Adapter only |
+| **Ships a renderer** | Yes, plus headless | Yes | No, headless only |
+| **Bundle (gzip)** | ~2 KB headless / ~80 KB full | ~340 KB | ~12-14 KB |
+| **Master/detail, tree, range selection** | Free | Enterprise only | Build it yourself |
+
+Full detail: [SvGrid vs AG Grid vs TanStack Table](https://svgrid.com/docs/help/comparison/) ·
+[Migrating from AG Grid](https://svgrid.com/docs/help/migrating-from-ag-grid/)
+
+## Documentation
+
+- [Getting started](https://svgrid.com/docs/getting-started/) - end-to-end walkthrough.
+- [370+ live demos](https://svgrid.com/demos/) - copy-paste recipes for every feature.
+- [Why headless?](https://svgrid.com/docs/why-headless/) - when to compose vs. drop in.
+- [Theming and Tailwind](https://svgrid.com/docs/help/tailwind/) - re-skin via `--sg-*` tokens and dark mode.
+- [Accessibility](https://svgrid.com/docs/help/accessibility/) - the WAI-ARIA grid pattern as implemented.
+- [Bundle size](https://svgrid.com/docs/reference/bundle-size/) - measured numbers and how to reproduce them.
+
+## Who's behind it
+
+SvGrid is built by [jQWidgets](https://www.jqwidgets.com), shipping UI components since 2011 to 5,000+
+companies including Samsung, Boeing, NVIDIA, Microsoft, Nokia, and Intel. SvGrid is our Svelte 5 native
+effort.
+
+## License & trademark
+
+The source code is **MIT-licensed** - see [LICENSE](./LICENSE). It is free for commercial use.
+SvGrid&trade; and sv-grid&trade; are trademarks of jQWidgets Ltd; the license covers the code only, not
+the name or logo.