@sheetxl/sdk 0.5.1 → 0.6.1

package/README.md

@@ -2,27 +2,66 @@
 
 ![SheetXL](https://www.sheetxl.com/logo-text.svg)
 
-A vectorized, columnar, scriptable, embeddable spreadsheet.
-
-A high-performance, embeddable spreadsheet engine designed for building data-driven applications and integrating
-spreadsheet functionality into existing systems. It handles even extremely large and sparse datasets,
-while providing a powerful calculation engine and a flexible API. As part of the
-[SheetXL](https://www.sheetxl.com) eco system, it seamlessly integrates with ready-to-use UI components and data
-import/export tools.
-
-Learn more about [SheetXL](https://www.sheetxl.com).
-
-| Feature                     | Excel API (JS/Python) | Google Sheets API | pandas | DuckDB | Jupyter Notebooks | NumPy | Sigma Computing | SheetXL 🚀 |
-|-----------------------------|----------------------|-------------------|--------|--------|------------------|-------|----------------|------------|
-| **Spreadsheet-Like?**       | ✅ Yes              | ✅ Yes           | ❌ No UI (table-based) | ❌ No UI | ❌ No real spreadsheet UI | ❌ No UI, array-based | ❌ No true spreadsheet UI | ✅ Yes (Excel-like UI) |
-| **Vectorized Operations?**  | ❌ Mostly scalar    | ❌ Mostly scalar  | ✅ Fully vectorized | ✅ Columnar, vectorized | ✅ Can use pandas/NumPy | ✅ Fully vectorized | ❌ SQL-based (not vectorized) | ✅ Fully vectorized, columnar |
-| **Embeddable?**             | ❌ Not easily embeddable | ✅ Web-based | ❌ Not embeddable | ✅ Can be embedded | ❌ Not embeddable | ❌ Not a spreadsheet | ✅ Cloud-based | ✅ Fully embeddable |
-| **Data Science Capabilities?** | ⚠️ Limited (Python only) | ❌ No real data science | ✅ Strong data science | ✅ SQL-based analytics | ✅ Python data science | ✅ Scientific computing | ✅ BI analytics | ✅ Python & JS scripting |
-
-## Advantages
-
-1. The “Handoff Tax” → IT departments rewrite spreadsheets into web apps, but they lack true spreadsheet functionality. SheetXL removes this tax.
-2. Excel’s API is scalar → Most spreadsheet APIs are slow because they weren’t built for large-scale, vectorized calculations.
-3. BI tools don’t let you “program” the UI → Sigma, Looker, Tableau work for dashboards, but aren’t true programmable spreadsheets.
-4. NumPy is fast, but has no spreadsheet UI → SheetXL gives NumPy performance inside a familiar spreadsheet.
-5. Embeddability is a game-changer → Unlike Excel/Google Sheets, SheetXL is built for web apps, with seamless integration.
+A high-performance, embeddable spreadsheet engine for TypeScript and JavaScript.
+This package provides the **SDK**, designed for embedding spreadsheet functionality directly into applications.
+
+SheetXL handles large and sparse datasets with an efficient columnar model and provides a powerful calculation engine with a clean, flexible API. As a zero-dependency headless library, it integrates easily into any tech stack.
+
+* Read / write cell data
+* Excel-class calculation engine
+* Styling & formatting model
+* Headless execution (bring your own UI)
+* Designed for large, sparse datasets
+
+Part of the [SheetXL ecosystem](https://www.sheetxl.com), which also includes UI components and import/export tools.
+
+---
+
+## Installation
+
+```bash
+pnpm install @sheetxl/sdk
+```
+
+## Quick Start
+
+```ts
+import { Workbook } from "@sheetxl/sdk";
+
+// Create a workbook
+const wb = new Workbook();
+const sheet = wb.addSheet("Demo");
+
+// Write values
+sheet.getRange("A1").setValue(42);
+sheet.getRange("B1").setValue(2);
+
+// Formula
+sheet.getRange("C1").setFormula("=A1*B1");
+
+// Read result
+console.log(sheet.getRange("C1").getValue()); // 84
+
+```
+
+## CLI
+
+For quick scripts or inspection, you can also run SheetXL directly without installation:
+
+```bash
+npx sheetxl
+```
+
+## 🔗 Learn More
+
+Whether you're ready to build, need help, or just want to see more examples, here's where to go next.
+
+* 📘 **[Developer Docs](https://www.sheetxl.com/docs)** - Guides and tutorials.
+* 🔌 **[API Reference](https://api.sheetxl.com)** - Detailed documentation for all packages.
+* 🌐 **[Live Demo Gallery](https://www.sheetxl.com/demos)** - A showcase of interactive examples.
+* ✨ **[Storybook](https://storybook.sheetxl.com)** - Explore and test individual UI components.
+* 💬 **[Join our Discord Community](https://discord.gg/NTKdwUgK9p)** - Get help and connect with the team.
+* ⭐ **[Star us on GitHub](https://github.com/sheetxl)** - If you find SheetXL useful, we'd appreciate a star!
+* 🌐 **[Website](https://www.sheetxl.com)** - Our Website.
+
+---

package/browser/cjs/{CDyqRmM0GCWMYtme.cjs → 2LZKOqV0ujP2JW5B.cjs}

@@ -1,5 +1,5 @@
 "use strict";/**
- * @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.5.1
+ * @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.6.1
  *
  * (C) 2025-present SheetXL Inc. & Michael T. Ford
  * License: The license can be found at https://www.sheetxl.com/license.