@namahapdf/sheets 0.1.0

package/LICENSE

@@ -0,0 +1,16 @@
+NamahaPDF SDK License (Proprietary)
+
+Copyright (c) 2026 NamahaPDF. All rights reserved.
+
+This software (the "SDK") is licensed, not sold. Use of the SDK in any application
+requires a valid commercial license key issued by NamahaPDF. Without a valid key the
+SDK operates in a restricted, watermarked evaluation mode and may not be used in
+production.
+
+You may NOT, except to the extent permitted by your commercial license agreement:
+remove, disable, or circumvent the license enforcement or watermarking; redistribute,
+sublicense, or resell the SDK; or use the SDK beyond the scope (domains, seats,
+features, term) granted by your license.
+
+THE SDK IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND. To obtain a license, see
+https://namahapdf.com/sdk.

package/README.md

@@ -0,0 +1,40 @@
+# @namahapdf/sheets
+
+Headless, in-browser **Excel engine** — parse and render `.xlsx` on a virtualized canvas
+grid, edit with faithful write-back, and project to an AI-readable model. Fully
+on-device, framework-agnostic. Part of the **NamahaPDF SDK**.
+
+```bash
+npm i @namahapdf/sheets
+```
+
+```ts
+import { XlsxEditSession, SheetRenderer, configureLicense } from '@namahapdf/sheets';
+
+// Apply your license key (without one, exports are watermarked + features limited).
+configureLicense({ licenseKey: 'YOUR_KEY' });
+
+// Load a workbook into an editing session, edit by intents, save a faithful .xlsx.
+const session = await XlsxEditSession.load('book.xlsx', bytes);
+await session.apply([
+  { op: 'set-cell', anchor: { fmt: 'xlsx', sheetPart: 'xl/worksheets/sheet1.xml', row: 1, col: 1 }, row: 1, col: 1, newText: '5000000' },
+  { op: 'format-cell', anchor: { fmt: 'xlsx', sheetPart: 'xl/worksheets/sheet1.xml', row: 1, col: 1 }, row: 1, col: 1, format: { bold: true, numFmt: '$#,##0.00' } },
+]);
+const editedBytes = session.bytes;              // still a valid .xlsx
+```
+
+Edits flow through a small, JSON-serializable **`EditPlan`** vocabulary (`set-cell`,
+`clear-cell`, `format-cell`, `set-column-width`) applied as surgical XML splices on the
+original package, so everything the plan doesn't touch is preserved byte-for-byte. The
+same plan an LLM emits (validate it with `validateEditPlan`) is the plan the UI emits.
+
+- **`XlsxDocument`** — `.xlsx` → a sparse `SheetModel` (styles, merges, number formats;
+  formulas carry their cached value — no evaluator by design).
+- **`SheetRenderer`** — a viewport-only virtualized canvas grid (scales to 100k+ rows).
+- **`applyXlsxPlan` / `XlsxEditSession`** — write-back (intent-sourced, undo/redo). A
+  value edit sets `fullCalcOnLoad`, so Excel recalculates dependents on open.
+- **`formatValue`** — the in-house number-format subset (currency, %, dates, …).
+
+Get a license key at **namahapdf.com/sdk**. Free to download but watermarked and
+feature-limited until a valid key is applied. A ready-made React sheet editor in
+**@namahapdf/react** is planned.