@kanunilabs/pivotgrid-react 1.0.1 → 1.0.3

package/README.md

@@ -1,18 +1,60 @@
-# @kanunilabs/pivotgrid-react
+<p align="center">
+  <a href="https://www.kanunilabs.com"><img src="https://www.kanunilabs.com/logo.png" width="84" alt="KanuniLabs" /></a>
+</p>
 
-React components for KanuniLabs PivotGrid — drag-and-drop field areas, virtualized grid body, header filters, context menus, and theming.
+<h1 align="center">KanuniLabs PivotGrid for React</h1>
 
-## Installation
+<p align="center">
+  A high-performance React pivot table with a Web Worker engine —<br />
+  pivot, filter, and analyze millions of rows without freezing the UI.
+</p>
+
+<p align="center">
+  <a href="https://www.kanunilabs.com">Website</a> ·
+  <a href="https://www.kanunilabs.com/playground/pivotgrid">Live Demos</a> ·
+  <a href="https://www.kanunilabs.com/docs/pivotgrid">Documentation</a> ·
+  <a href="https://www.kanunilabs.com/docs/pivotgrid/api">API Reference</a> ·
+  <a href="https://www.kanunilabs.com/pricing">Pricing</a> ·
+  <a href="https://www.kanunilabs.com/contact">Support</a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@kanunilabs/pivotgrid-react"><img src="https://img.shields.io/npm/v/%40kanunilabs%2Fpivotgrid-react.svg?label=npm" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/@kanunilabs/pivotgrid-react"><img src="https://img.shields.io/npm/dm/%40kanunilabs%2Fpivotgrid-react.svg" alt="npm downloads" /></a>
+  <img src="https://img.shields.io/badge/TypeScript-included-3178c6.svg" alt="TypeScript types included" />
+  <img src="https://img.shields.io/badge/license-Community%20(free)-2ea44f.svg" alt="KanuniLabs Community License" />
+</p>
+
+<p align="center">
+  <a href="https://www.kanunilabs.com/playground/pivotgrid">
+    <img src="https://www.kanunilabs.com/npm/pivotgrid-react.png" alt="KanuniLabs PivotGrid for React — drag-and-drop pivot table with Web Worker aggregation" width="100%" />
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://www.kanunilabs.com/playground/pivotgrid">Try it live in the interactive playground</a> — pivot 2,000,000 rows of sales data right in your browser. No signup, no install.
+</p>
+
+## Why KanuniLabs PivotGrid?
+
+- **Web Worker engine** — columnar storage, dictionary encoding and trie-based grouping run entirely off the main thread. Initial load is pipelined and incremental; re-pivoting (drag a field) reuses the encoded data instead of re-processing it, so even multi-million-row datasets stay interactive.
+- **Virtualized rendering** — row and column virtualization keep the DOM small no matter how large the result matrix gets.
+- **Drag & drop layout** — a familiar field panel plus in-grid area strips: drag fields between Row, Column, Data and Filter areas.
+- **Filtering & sorting** — header filter popups with search, multi-level sorting, custom sort orders.
+- **Summary display modes** — % of grand total / row / column, running totals, rank, index and more, per measure.
+- **Import & export** — CSV, JSON and XML export, clipboard copy, print and PNG snapshot out of the box; file and clipboard import with type detection. (Styled Excel & PDF export ship in the [Enterprise edition](#enterprise-edition).)
+- **Saved views** — capture and restore complete layouts through the built-in report manager.
+- **12 locales + RTL** — en, tr, de, fr, es, it, pt, ru, ar, zh-CN, ja, ko — including full right-to-left support.
+- **Themeable** — CSS-variable driven theming with preset themes and zebra striping. Styles are scoped under `.kanuni-pivot-root`, so nothing leaks into your app (with or without Tailwind).
+- **TypeScript-first & CSP-safe** — complete type definitions; no `eval`, no `new Function`.
+
+## Quick start
 
 ```bash
 npm install @kanunilabs/pivotgrid-react
 ```
 
-(or `yarn add` / `pnpm add` — any package manager works.)
-
-`@kanunilabs/pivotgrid-core` is installed automatically as a dependency.
-
-## Usage
+`@kanunilabs/pivotgrid-core` (the engine) is installed automatically.
 
 ```tsx
 import { BasePivotGrid } from '@kanunilabs/pivotgrid-react';
@@ -32,25 +74,68 @@ function App() {
 }
 ```
 
-The stylesheet is scoped under `.kanuni-pivot-root` — it does not leak into
-your application styles and works with or without Tailwind.
+That's it — aggregation starts in a Web Worker and the grid renders with drag-and-drop, filtering, sorting and export enabled.
+
+### Bundler note: the Web Worker
+
+The engine resolves its worker via `import.meta.url`, which some bundlers can't
+follow into `node_modules`. If the grid renders but never shows data, pass the
+`workerUrl` prop:
+
+**Vite** — import the worker as an asset URL (no manual copying, survives
+`npm update`):
+
+```jsx
+import workerUrl from '@kanunilabs/pivotgrid-core/dist/pivot.worker.js?url';
+
+<BasePivotGrid workerUrl={workerUrl} /* ... */ />
+```
+
+**Next.js / other bundlers** — copy
+`@kanunilabs/pivotgrid-core/dist/pivot.worker.js` into a served path (e.g.
+`public/kanunilabs/`) and pass `workerUrl="/kanunilabs/pivot.worker.js"`. See
+the [Next.js setup guide](https://www.kanunilabs.com/docs/pivotgrid/nextjs).
+
+## Enterprise edition
 
-> **Next.js / bundlers that can't resolve `import.meta.url` workers:** copy
-> `@kanunilabs/pivotgrid-core/dist/pivot.worker.js` into a served path (e.g.
-> `public/kanunilabs/`) and pass it via the `workerUrl` prop.
+Advanced analytics ship in `@kanunilabs/pivotgrid-react-enterprise` — a drop-in
+replacement for `BasePivotGrid` that adds:
 
-## Peer Dependencies
+| Feature | |
+| --- | --- |
+| **Calculated fields** | No-code formula editor with live preview (CSP-safe, no `eval`) |
+| **Chart integration** | Sync any pivot view to charts — column, bar, line, area, pie, scatter & more |
+| **Drill-down** | Open the source records behind any aggregated cell |
+| **Prefilter builder** | Visual condition builder applied inside the worker |
+| **Node context menu** | Right-click bulk expand/collapse on any row or column node |
+| **Styled Excel & PDF export** | Formatted, streaming Excel export and print-ready PDF |
 
-- `react` / `react-dom` >= 18
-- `@dnd-kit/core` — drag-and-drop
-- `lucide-react` — icons
-- `zustand` — state management
-- via core: `xlsx` (import), `file-saver` (export)
+See [Pricing](https://www.kanunilabs.com/pricing) for licenses — this community
+package stays free either way.
 
-npm ≥ 7 and pnpm install these automatically.
+## Compatibility
+
+- React 18 and React 19
+- TypeScript types included (strict-mode clean)
+- All evergreen browsers (Chrome, Edge, Firefox, Safari)
+- Works with Vite, Next.js (App Router), CRA and plain Webpack/Rollup setups
+
+## Resources
+
+- [Live demos & playground](https://www.kanunilabs.com/playground/pivotgrid)
+- [Documentation](https://www.kanunilabs.com/docs/pivotgrid) · [Installation](https://www.kanunilabs.com/docs/pivotgrid/installation) · [Features guide](https://www.kanunilabs.com/docs/pivotgrid/features) · [FAQ](https://www.kanunilabs.com/docs/pivotgrid/faq)
+- [API reference](https://www.kanunilabs.com/docs/pivotgrid/api)
+- [Changelog](https://www.kanunilabs.com/changelog)
+- Questions? [Contact us](https://www.kanunilabs.com/contact) — <hello@kanunilabs.com>
 
 ## License
 
 **KanuniLabs Community License v1.0** — free to use in commercial and
-non-commercial applications; the source code is proprietary. See
-[LICENSE](./LICENSE) for the full terms.
+non-commercial applications; the source code is proprietary (no
+redistribution/modification of the package itself). See [LICENSE](./LICENSE)
+for the full terms. Enterprise features are licensed separately — see
+[kanunilabs.com/pricing](https://www.kanunilabs.com/pricing).
+
+---
+
+<p align="center">© 2026 KanuniLabs · <a href="https://www.kanunilabs.com">kanunilabs.com</a> · <a href="mailto:hello@kanunilabs.com">hello@kanunilabs.com</a></p>

package/package.json

@@ -1,8 +1,39 @@
 {
   "name": "@kanunilabs/pivotgrid-react",
-  "version": "1.0.1",
-  "description": "React components for KanuniLabs PivotGrid",
+  "version": "1.0.3",
+  "description": "High-performance React pivot table with a Web Worker engine — drag-and-drop pivoting, filtering, sorting, theming and export",
+  "keywords": [
+    "react",
+    "react-component",
+    "pivot",
+    "pivot-table",
+    "pivot-grid",
+    "pivotgrid",
+    "data-grid",
+    "datagrid",
+    "table",
+    "olap",
+    "cross-tab",
+    "aggregation",
+    "analytics",
+    "reporting",
+    "business-intelligence",
+    "web-worker",
+    "virtualized",
+    "drag-and-drop",
+    "excel",
+    "export",
+    "i18n",
+    "rtl",
+    "typescript"
+  ],
   "license": "SEE LICENSE IN LICENSE",
+  "author": "KanuniLabs <hello@kanunilabs.com> (https://www.kanunilabs.com)",
+  "homepage": "https://www.kanunilabs.com",
+  "bugs": {
+    "email": "hello@kanunilabs.com",
+    "url": "https://www.kanunilabs.com/contact"
+  },
   "type": "module",
   "exports": {
     ".": {
@@ -29,7 +60,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@kanunilabs/pivotgrid-core": "1.0.1"
+    "@kanunilabs/pivotgrid-core": "1.0.3"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.3.0",
@@ -44,11 +75,6 @@
     "react-dom": ">=18.0.0",
     "zustand": ">=5.0.0"
   },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/kanunilabs/pivotgrid",
-    "directory": "packages/react"
-  },
   "scripts": {
     "build": "tsup && node scripts/build-css.mjs",
     "build:css": "node scripts/build-css.mjs",