documonster 0.0.2 → 0.0.3

package/README.md

@@ -36,7 +36,7 @@ Read, write, and manipulate DOCX files with a full builder, reader, and converte
 
 ### Formula — Excel-Compatible Calculation Engine
 
-Standalone 433-function calculation engine with tokenizer, parser, dependency graph, dynamic-array spill, and `LAMBDA`/`LET`/`MAP`/`REDUCE` support. Ships as a separate subpath so it stays out of bundles that only need to read/write XLSX. **Works in two modes**: paired with `Workbook` via `installFormulaEngine()`, or standalone on any `WorkbookLike` host via `calculateFormulas()` — the engine itself has zero excel runtime dependencies.
+Standalone 433-function calculation engine with tokenizer, parser, dependency graph, dynamic-array spill, and `LAMBDA`/`LET`/`MAP`/`REDUCE` support. Ships as a separate subpath so it stays out of bundles that only need to read/write XLSX. A single pure function, `Formula.calculate()`, evaluates any `WorkbookLike` host in place (including a `Workbook` created by the excel module) — the engine itself has zero excel runtime dependencies.
 
 - [Documentation](src/modules/formula/README.md) | [中文](src/modules/formula/README_zh.md)
 - [Examples](src/modules/formula/examples/)
@@ -98,84 +98,80 @@ Each module is available as a standalone subpath export. All subpaths support `b
 ## Quick Start
 
 ```typescript
-import { Workbook } from "documonster";
+import { Workbook, Worksheet, Row } from "documonster/excel";
 
 // Create
-const workbook = new Workbook();
-const sheet = workbook.addWorksheet("Sheet1");
-sheet.addRow(["Name", "Age"]);
-sheet.addRow(["Alice", 30]);
-await workbook.xlsx.writeFile("output.xlsx");
+const workbook = Workbook.create();
+const sheet = Workbook.addWorksheet(workbook, "Sheet1");
+Worksheet.addRow(sheet, ["Name", "Age"]);
+Worksheet.addRow(sheet, ["Alice", 30]);
+await Workbook.writeFile(workbook, "output.xlsx");
 
 // Read
-const wb = new Workbook();
-await wb.xlsx.readFile("output.xlsx");
-wb.getWorksheet(1).eachRow((row, n) => console.log(n, row.values));
+const wb = Workbook.create();
+await Workbook.readFile(wb, "output.xlsx");
+const readSheet = Workbook.getWorksheet(wb, 1);
+Worksheet.eachRow(readSheet, (_row, n) => console.log(n, Row.getValues(readSheet, n)));
 
 // PDF — generate from data, no Workbook needed
-import { pdf } from "documonster/pdf";
-const pdfBytes = await pdf([
+import { Pdf } from "documonster/pdf";
+const pdfBytes = await Pdf.create([
   ["Product", "Revenue"],
   ["Widget", 1000]
 ]);
 
 // PDF — read text, images, and metadata from any PDF
-import { readPdf } from "documonster/pdf";
-const result = await readPdf(pdfBytes);
+const result = await Pdf.read(pdfBytes);
 console.log(result.text); // extracted text
 console.log(result.metadata); // title, author, etc.
 
 // PDF — build free-form PDFs with text, shapes, SVG paths
-import { PdfDocumentBuilder } from "documonster/pdf";
-const doc = new PdfDocumentBuilder();
+const doc = new Pdf.Builder();
 const page = doc.addPage();
 page.drawText("Hello!", { x: 72, y: 770, fontSize: 24 });
 page.drawSvgPath("M10 10 L90 10 L50 80 Z", { fill: { r: 1, g: 0, b: 0 } });
 page.addAnnotation({ type: "Highlight", rect: [72, 765, 150, 785] });
 
 // PDF — edit existing PDFs (overlay, merge, fill forms)
-import { PdfEditor } from "documonster/pdf";
-const editor = PdfEditor.load(existingPdf);
+const editor = Pdf.Editor.load(existingPdf);
 editor.getPage(0).drawText("Stamp", { x: 200, y: 400, fontSize: 36 });
 editor.setFormField("name", "Jane");
 editor.copyPagesFrom(otherPdf);
 
 // CSV — parse and format
-import { parseCsv, formatCsv } from "documonster/csv";
-const rows = parseCsv("name,age\nAlice,30", { headers: true });
-const csv = formatCsv([{ name: "Bob", age: 25 }], { headers: true });
+import { Csv } from "documonster/csv";
+const rows = Csv.parse("name,age\nAlice,30", { headers: true });
+const csv = Csv.format([{ name: "Bob", age: 25 }], { headers: true });
 
 // XML — parse, query, write
-import { parseXml, queryAll, XmlWriter } from "documonster/xml";
-const titles = queryAll(parseXml(xmlString).root, "book/title");
+import { Xml } from "documonster/xml";
+const titles = Xml.queryAll(Xml.parse(xmlString).root, "book/title");
 
 // ZIP — create and extract
-import { zip, unzip } from "documonster/zip";
-const archive = await zip().add("hello.txt", "Hello!").bytes();
+import { Archive } from "documonster/archive";
+const archive = await Archive.zip().add("hello.txt", "Hello!").bytes();
 
 // Markdown — parse and format tables
-import { parseMarkdown, formatMarkdown } from "documonster/markdown";
-const table = parseMarkdown("| A | B |\n|---|---|\n| 1 | 2 |");
+import { Markdown } from "documonster/markdown";
+const table = Markdown.parse("| A | B |\n|---|---|\n| 1 | 2 |");
 
 // Word — create, read, and convert DOCX
-import { Document, toBuffer, readDocx } from "documonster/word";
+import { Document, Io } from "documonster/word";
 const wdoc = Document.create();
 Document.addHeading(wdoc, "Report", 1);
 Document.addParagraph(wdoc, "Generated by Documonster.");
-const docxBytes = await toBuffer(Document.build(wdoc));
-const parsedDocx = await readDocx(docxBytes); // round-trip read
+const docxBytes = await Io.toBuffer(Document.build(wdoc));
+const parsedDocx = await Io.read(docxBytes); // round-trip read
 
 // Formula — opt-in calculation engine (kept out of the base bundle)
-//
-// Mode A: paired with Workbook — enables wb.calculateFormulas()
-import { installFormulaEngine } from "documonster/formula";
-installFormulaEngine(); // once at startup
-sheet.getCell("A4").value = { formula: "SUM(A1:A3)" };
-workbook.calculateFormulas(); // now populates cell.result
-
-// Mode B: standalone — pure function, zero excel runtime, any WorkbookLike
-import { calculateFormulas } from "documonster/formula";
-calculateFormulas(anyWorkbookLikeObject);
+// Pure function: populates cell results on any WorkbookLike object.
+import { Formula } from "documonster/formula";
+import { Cell } from "documonster/excel";
+Cell.setValue(sheet, "A4", { formula: "SUM(A1:A3)" });
+Formula.calculate(workbook); // now populates cell results
+
+// Also works standalone on any WorkbookLike object
+Formula.calculate(anyWorkbookLikeObject);
 ```
 
 ## Browser Support
@@ -184,8 +180,10 @@ Documonster has native browser support with **zero configuration** for modern bu
 
 ```typescript
 // Bundlers (Vite, Webpack, Rollup, esbuild) — just import
-import { Workbook } from "documonster";
-const buffer = await new Workbook().addWorksheet("S1").workbook.xlsx.writeBuffer();
+import { Workbook } from "documonster/excel";
+const wb = Workbook.create();
+Workbook.addWorksheet(wb, "S1");
+const buffer = await Workbook.toBuffer(wb);
 ```
 
 ```html
@@ -194,8 +192,7 @@ const buffer = await new Workbook().addWorksheet("S1").workbook.xlsx.writeBuffer
 ```
 
 > The IIFE bundle does not include the formula calculation engine. Use
-> ESM + `documonster/formula` if you need
-> `Workbook.calculateFormulas()`.
+> ESM + `documonster/formula` if you need `Formula.calculate()`.
 
 For older browsers without native `CompressionStream` API, Documonster automatically uses a built-in pure JavaScript DEFLATE implementation — no polyfills needed.
 

package/README_zh.md

@@ -36,7 +36,7 @@ Documonster 由九个独立模块组成,每个模块都有自己的文档和可
 
 ### Formula — Excel 兼容公式引擎
 
-独立的 433 函数计算引擎,包含 tokenizer、parser、依赖图、动态数组 spill,支持 `LAMBDA`/`LET`/`MAP`/`REDUCE`。作为单独的 subpath 发布,不会被打进只读写 XLSX 的 bundle。**两种使用模式**:通过 `installFormulaEngine()` 和 `Workbook` 配合使用,或通过 `calculateFormulas()` 对任意 `WorkbookLike` 宿主单独使用 — 引擎本身**零 excel 运行时依赖**。
+独立的 433 函数计算引擎,包含 tokenizer、parser、依赖图、动态数组 spill,支持 `LAMBDA`/`LET`/`MAP`/`REDUCE`。作为单独的 subpath 发布,不会被打进只读写 XLSX 的 bundle。仅需一个纯函数 `Formula.calculate()` 即可就地对任意 `WorkbookLike` 宿主(包括 excel 模块创建的 `Workbook`)求值 — 引擎本身**零 excel 运行时依赖**。
 
 - [文档](src/modules/formula/README.md) | [中文](src/modules/formula/README_zh.md)
 - [示例](src/modules/formula/examples/)
@@ -98,69 +98,67 @@ bun add documonster
 ## 快速开始
 
 ```typescript
-import { Workbook } from "documonster";
+import { Workbook, Worksheet, Row } from "documonster/excel";
 
 // 创建
-const workbook = new Workbook();
-const sheet = workbook.addWorksheet("Sheet1");
-sheet.addRow(["姓名", "年龄"]);
-sheet.addRow(["Alice", 30]);
-await workbook.xlsx.writeFile("output.xlsx");
+const workbook = Workbook.create();
+const sheet = Workbook.addWorksheet(workbook, "Sheet1");
+Worksheet.addRow(sheet, ["姓名", "年龄"]);
+Worksheet.addRow(sheet, ["Alice", 30]);
+await Workbook.writeFile(workbook, "output.xlsx");
 
 // 读取
-const wb = new Workbook();
-await wb.xlsx.readFile("output.xlsx");
-wb.getWorksheet(1).eachRow((row, n) => console.log(n, row.values));
+const wb = Workbook.create();
+await Workbook.readFile(wb, "output.xlsx");
+const readSheet = Workbook.getWorksheet(wb, 1);
+Worksheet.eachRow(readSheet, (_row, n) => console.log(n, Row.getValues(readSheet, n)));
 
 // PDF — 直接从数据生成，无需 Workbook
-import { pdf } from "documonster/pdf";
-const pdfBytes = await pdf([
+import { Pdf } from "documonster/pdf";
+const pdfBytes = await Pdf.create([
   ["产品", "收入"],
   ["小工具", 1000]
 ]);
 
 // PDF — 读取任意 PDF 的文本、图片和元数据
-import { readPdf } from "documonster/pdf";
-const result = await readPdf(pdfBytes);
+const result = await Pdf.read(pdfBytes);
 console.log(result.text); // 提取的文本
 console.log(result.metadata); // 标题、作者等
 
 // CSV — 解析和格式化
-import { parseCsv, formatCsv } from "documonster/csv";
-const rows = parseCsv("name,age\nAlice,30", { headers: true });
-const csv = formatCsv([{ name: "Bob", age: 25 }], { headers: true });
+import { Csv } from "documonster/csv";
+const rows = Csv.parse("name,age\nAlice,30", { headers: true });
+const csv = Csv.format([{ name: "Bob", age: 25 }], { headers: true });
 
 // XML — 解析、查询、写入
-import { parseXml, queryAll, XmlWriter } from "documonster/xml";
-const titles = queryAll(parseXml(xmlString).root, "book/title");
+import { Xml } from "documonster/xml";
+const titles = Xml.queryAll(Xml.parse(xmlString).root, "book/title");
 
 // ZIP — 创建和解压
-import { zip, unzip } from "documonster/zip";
-const archive = await zip().add("hello.txt", "Hello!").bytes();
+import { Archive } from "documonster/archive";
+const archive = await Archive.zip().add("hello.txt", "Hello!").bytes();
 
 // Markdown — 解析和格式化表格
-import { parseMarkdown, formatMarkdown } from "documonster/markdown";
-const table = parseMarkdown("| A | B |\n|---|---|\n| 1 | 2 |");
+import { Markdown } from "documonster/markdown";
+const table = Markdown.parse("| A | B |\n|---|---|\n| 1 | 2 |");
 
 // Word — 创建、读取和转换 DOCX
-import { Document, toBuffer, readDocx } from "documonster/word";
+import { Document, Io } from "documonster/word";
 const wdoc = Document.create();
 Document.addHeading(wdoc, "报告", 1);
 Document.addParagraph(wdoc, "由 Documonster 生成。");
-const docxBytes = await toBuffer(Document.build(wdoc));
-const parsedDocx = await readDocx(docxBytes); // 往返读取
+const docxBytes = await Io.toBuffer(Document.build(wdoc));
+const parsedDocx = await Io.read(docxBytes); // 往返读取
 
 // Formula — 可选的公式引擎(默认不打进主 bundle)
-//
-// 模式 A: 配合 Workbook — 启用 wb.calculateFormulas()
-import { installFormulaEngine } from "documonster/formula";
-installFormulaEngine(); // 启动时调用一次
-sheet.getCell("A4").value = { formula: "SUM(A1:A3)" };
-workbook.calculateFormulas(); // 现在能填 cell.result 了
-
-// 模式 B: 单独使用 — 纯函数,零 excel 运行时,接受任意 WorkbookLike
-import { calculateFormulas } from "documonster/formula";
-calculateFormulas(anyWorkbookLikeObject);
+// 纯函数：为任意 WorkbookLike 对象填充单元格计算结果。
+import { Formula } from "documonster/formula";
+import { Cell } from "documonster/excel";
+Cell.setValue(sheet, "A4", { formula: "SUM(A1:A3)" });
+Formula.calculate(workbook); // 现在能填充单元格计算结果了
+
+// 同样可单独作用于任意 WorkbookLike 对象
+Formula.calculate(anyWorkbookLikeObject);
 ```
 
 ## 浏览器支持
@@ -169,8 +167,10 @@ Documonster 原生支持浏览器，现代打包工具**零配置**即可使用
 
 ```typescript
 // 打包工具（Vite、Webpack、Rollup、esbuild）— 直接导入
-import { Workbook } from "documonster";
-const buffer = await new Workbook().addWorksheet("S1").workbook.xlsx.writeBuffer();
+import { Workbook } from "documonster/excel";
+const wb = Workbook.create();
+Workbook.addWorksheet(wb, "S1");
+const buffer = await Workbook.toBuffer(wb);
 ```
 
 ```html
@@ -179,7 +179,7 @@ const buffer = await new Workbook().addWorksheet("S1").workbook.xlsx.writeBuffer
 ```
 
 > IIFE 打包产物不包含公式计算引擎。如果需要调用
-> `Workbook.calculateFormulas()`，请改用 ESM + 导入
+> `Formula.calculate()`，请改用 ESM + 导入
 > `documonster/formula`。
 
 对于不支持原生 `CompressionStream` API 的旧版浏览器，Documonster 自动使用内置的纯 JavaScript DEFLATE 实现 — 无需 polyfill。

package/dist/iife/documonster.archive.iife.js

@@ -1,5 +1,5 @@
 /*!
-* documonster v0.0.2
+* documonster v0.0.3
 * Zero-dependency TypeScript toolkit for Excel, Word, PDF, CSV, Markdown, XML & ZIP — one API across Node.js, Bun & browsers.
 * (c) 2026 cjnoname
 * Released under the Apache-2.0 License

package/dist/iife/documonster.archive.iife.min.js

@@ -1,5 +1,5 @@
 /*!
-* documonster v0.0.2
+* documonster v0.0.3
 * Zero-dependency TypeScript toolkit for Excel, Word, PDF, CSV, Markdown, XML & ZIP — one API across Node.js, Bun & browsers.
 * (c) 2026 cjnoname
 * Released under the Apache-2.0 License

package/dist/iife/documonster.csv.iife.js

@@ -1,5 +1,5 @@
 /*!
-* documonster v0.0.2
+* documonster v0.0.3
 * Zero-dependency TypeScript toolkit for Excel, Word, PDF, CSV, Markdown, XML & ZIP — one API across Node.js, Bun & browsers.
 * (c) 2026 cjnoname
 * Released under the Apache-2.0 License

package/dist/iife/documonster.csv.iife.min.js

@@ -1,5 +1,5 @@
 /*!
-* documonster v0.0.2
+* documonster v0.0.3
 * Zero-dependency TypeScript toolkit for Excel, Word, PDF, CSV, Markdown, XML & ZIP — one API across Node.js, Bun & browsers.
 * (c) 2026 cjnoname
 * Released under the Apache-2.0 License

package/dist/iife/documonster.excel.iife.js

@@ -1,5 +1,5 @@
 /*!
-* documonster v0.0.2
+* documonster v0.0.3
 * Zero-dependency TypeScript toolkit for Excel, Word, PDF, CSV, Markdown, XML & ZIP — one API across Node.js, Bun & browsers.
 * (c) 2026 cjnoname
 * Released under the Apache-2.0 License
@@ -44874,7 +44874,6 @@ self.onmessage = async function(event) {
 	var WRITE_AFTER_END_ERROR, AsyncStreamCodec, BufferedCodec;
 	var init_streaming_compress_browser = __esmMin((() => {
 		init_compress_base();
-		init_compress_browser();
 		init_deflate_fallback();
 		init_index_browser();
 		init_defaults();