@cj-tech-master/excelts 8.1.1 → 8.1.2

package/README.md

@@ -55,7 +55,7 @@ Streaming and buffered XML processing with query engine, namespace support, and
 - [Documentation](src/modules/xml/README.md) | [中文](src/modules/xml/README_zh.md)
 - [Examples](src/modules/xml/examples/)
 
-### Archive — ZIP/TAR Create/Read/Edit
+### Archive — Create/Read/Edit Archives
 
 ZIP and TAR archive creation, reading, editing, streaming, encryption, and compression utilities.
 
@@ -73,8 +73,14 @@ Node.js-compatible Readable/Writable/Transform/Duplex that works identically in
 
 ```bash
 npm install @cj-tech-master/excelts
+# or
+pnpm add @cj-tech-master/excelts
+# or
+bun add @cj-tech-master/excelts
 ```
 
+Each module is available as a standalone subpath export. All subpaths support `browser`, `import` (ESM), and `require` (CJS) conditions.
+
 ## Quick Start
 
 ```typescript
@@ -91,9 +97,7 @@ await workbook.xlsx.writeFile("output.xlsx");
 const wb = new Workbook();
 await wb.xlsx.readFile("output.xlsx");
 wb.getWorksheet(1).eachRow((row, n) => console.log(n, row.values));
-```
 
-```typescript
 // PDF — generate from data, no Workbook needed
 import { pdf } from "@cj-tech-master/excelts/pdf";
 const pdfBytes = pdf([
@@ -125,22 +129,6 @@ import { parseMarkdown, formatMarkdown } from "@cj-tech-master/excelts/markdown"
 const table = parseMarkdown("| A | B |\n|---|---|\n| 1 | 2 |");
 ```
 
-## Subpath Exports
-
-Each module is available as a standalone subpath export:
-
-```typescript
-import { Workbook, WorkbookWriter } from "@cj-tech-master/excelts";
-import { pdf, readPdf, excelToPdf } from "@cj-tech-master/excelts/pdf";
-import { SaxParser, parseXml, XmlWriter, query } from "@cj-tech-master/excelts/xml";
-import { zip, unzip, ZipArchive, compress } from "@cj-tech-master/excelts/zip";
-import { parseCsv, formatCsv, CsvParserStream } from "@cj-tech-master/excelts/csv";
-import { parseMarkdown, formatMarkdown, parseMarkdownAll } from "@cj-tech-master/excelts/markdown";
-import { Readable, pipeline, createTransform } from "@cj-tech-master/excelts/stream";
-```
-
-Each subpath supports `browser`, `import` (ESM), and `require` (CJS) conditions.
-
 ## Browser Support
 
 ExcelTS has native browser support with **zero configuration** for modern bundlers.
@@ -161,6 +149,7 @@ For older browsers without native `CompressionStream` API, ExcelTS automatically
 ## Requirements
 
 - **Node.js >= 22.0.0**
+- **Bun >= 1.0**
 
 | Browser | Minimum Version    |
 | ------- | ------------------ |

package/README_zh.md

@@ -29,7 +29,7 @@ ExcelTS 由七个独立模块组成，每个模块都有自己的文档和可运
 
 ### PDF — 零依赖 PDF 引擎
 
-功能完整的 PDF 生成，支持字体嵌入、加密、图片和 Excel 转 PDF。
+功能完整的 PDF 生成和读取。写入支持字体嵌入、AES-256 加密、图片和 Excel 转 PDF。读取支持从任意 PDF 提取文本、图片、注解、表单字段和元数据。
 
 - [文档](src/modules/pdf/README.md) | [中文](src/modules/pdf/README_zh.md)
 - [示例](src/modules/pdf/examples/)
@@ -55,7 +55,7 @@ ExcelTS 由七个独立模块组成，每个模块都有自己的文档和可运
 - [文档](src/modules/xml/README.md) | [中文](src/modules/xml/README_zh.md)
 - [示例](src/modules/xml/examples/)
 
-### Archive — ZIP/TAR 创建/读取/编辑
+### Archive — 归档创建/读取/编辑
 
 ZIP 和 TAR 归档创建、读取、编辑、流式处理、加密和压缩工具。
 
@@ -73,8 +73,14 @@ ZIP 和 TAR 归档创建、读取、编辑、流式处理、加密和压缩工
 
 ```bash
 npm install @cj-tech-master/excelts
+# or
+pnpm add @cj-tech-master/excelts
+# or
+bun add @cj-tech-master/excelts
 ```
 
+每个模块都可以作为独立的子路径导出使用。所有子路径均支持 `browser`、`import`（ESM）和 `require`（CJS）条件导出。
+
 ## 快速开始
 
 ```typescript
@@ -91,9 +97,7 @@ await workbook.xlsx.writeFile("output.xlsx");
 const wb = new Workbook();
 await wb.xlsx.readFile("output.xlsx");
 wb.getWorksheet(1).eachRow((row, n) => console.log(n, row.values));
-```
 
-```typescript
 // PDF — 直接从数据生成，无需 Workbook
 import { pdf } from "@cj-tech-master/excelts/pdf";
 const pdfBytes = pdf([
@@ -101,6 +105,12 @@ const pdfBytes = pdf([
   ["小工具", 1000]
 ]);
 
+// PDF — 读取任意 PDF 的文本、图片和元数据
+import { readPdf } from "@cj-tech-master/excelts/pdf";
+const result = readPdf(pdfBytes);
+console.log(result.text); // 提取的文本
+console.log(result.metadata); // 标题、作者等
+
 // CSV — 解析和格式化
 import { parseCsv, formatCsv } from "@cj-tech-master/excelts/csv";
 const rows = parseCsv("name,age\nAlice,30", { headers: true });
@@ -119,21 +129,6 @@ import { parseMarkdown, formatMarkdown } from "@cj-tech-master/excelts/markdown"
 const table = parseMarkdown("| A | B |\n|---|---|\n| 1 | 2 |");
 ```
 
-## 子路径导出
-
-每个模块都可以作为独立的子路径导出使用：
-
-```typescript
-import { Workbook, WorkbookWriter } from "@cj-tech-master/excelts";
-import { SaxParser, parseXml, XmlWriter, query } from "@cj-tech-master/excelts/xml";
-import { zip, unzip, ZipArchive, compress } from "@cj-tech-master/excelts/zip";
-import { parseCsv, formatCsv, CsvParserStream } from "@cj-tech-master/excelts/csv";
-import { parseMarkdown, formatMarkdown, parseMarkdownAll } from "@cj-tech-master/excelts/markdown";
-import { Readable, pipeline, createTransform } from "@cj-tech-master/excelts/stream";
-```
-
-每个子路径均支持 `browser`、`import`（ESM）和 `require`（CJS）条件导出。
-
 ## 浏览器支持
 
 ExcelTS 原生支持浏览器，现代打包工具**零配置**即可使用。
@@ -154,6 +149,7 @@ const buffer = await new Workbook().addWorksheet("S1").workbook.xlsx.writeBuffer
 ## 系统要求
 
 - **Node.js >= 22.0.0**
+- **Bun >= 1.0**
 
 | 浏览器  | 最低版本           |
 | ------- | ------------------ |

package/dist/iife/excelts.iife.js

@@ -1,5 +1,5 @@
 /*!
-* @cj-tech-master/excelts v8.1.1
+* @cj-tech-master/excelts v8.1.2
 * Zero-dependency TypeScript toolkit — Excel (XLSX), PDF, CSV, Markdown, XML, ZIP/TAR, and streaming.
 * (c) 2026 cjnoname
 * Released under the MIT License

package/dist/iife/excelts.iife.min.js

@@ -1,5 +1,5 @@
 /*!
-* @cj-tech-master/excelts v8.1.1
+* @cj-tech-master/excelts v8.1.2
 * Zero-dependency TypeScript toolkit — Excel (XLSX), PDF, CSV, Markdown, XML, ZIP/TAR, and streaming.
 * (c) 2026 cjnoname
 * Released under the MIT License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cj-tech-master/excelts",
-  "version": "8.1.1",
+  "version": "8.1.2",
   "description": "Zero-dependency TypeScript toolkit — Excel (XLSX), PDF, CSV, Markdown, XML, ZIP/TAR, and streaming.",
   "type": "module",
   "main": "./dist/cjs/index.js",
@@ -107,6 +107,20 @@
         "default": "./dist/cjs/modules/stream/index.js"
       }
     },
+    "./pdf": {
+      "browser": {
+        "types": "./dist/browser/modules/pdf/index.d.ts",
+        "default": "./dist/browser/modules/pdf/index.js"
+      },
+      "import": {
+        "types": "./dist/types/modules/pdf/index.d.ts",
+        "default": "./dist/esm/modules/pdf/index.js"
+      },
+      "require": {
+        "types": "./dist/types/modules/pdf/index.d.ts",
+        "default": "./dist/cjs/modules/pdf/index.js"
+      }
+    },
     "./xml": {
       "browser": {
         "types": "./dist/browser/modules/xml/index.d.ts",
@@ -145,6 +159,9 @@
       "stream": [
         "dist/types/modules/stream/index.d.ts"
       ],
+      "pdf": [
+        "dist/types/modules/pdf/index.d.ts"
+      ],
       "xml": [
         "dist/types/modules/xml/index.d.ts"
       ],
@@ -229,7 +246,7 @@
     "test:browser": "npm run generate:csv-worker && rimraf dist && npm run build:browser:bundle && vitest run --config vitest.browser.config.ts",
     "test:watch": "vitest",
     "build": "npm run generate:csv-worker && rimraf dist && concurrently \"npm run build:esm\" \"npm run build:cjs\" \"npm run build:browser\" \"npm run build:browser:bundle\" && npm run build:verify",
-    "build:verify": "tsc --noEmit --ignoreConfig --module NodeNext --moduleResolution NodeNext --lib ESNext,DOM --types node dist/types/index.d.ts dist/types/modules/archive/index.d.ts dist/types/modules/csv/index.d.ts dist/types/modules/markdown/index.d.ts dist/types/modules/stream/index.d.ts dist/types/modules/xml/index.d.ts",
+    "build:verify": "tsc --noEmit --ignoreConfig --module NodeNext --moduleResolution NodeNext --lib ESNext,DOM --types node dist/types/index.d.ts dist/types/modules/archive/index.d.ts dist/types/modules/csv/index.d.ts dist/types/modules/markdown/index.d.ts dist/types/modules/pdf/index.d.ts dist/types/modules/stream/index.d.ts dist/types/modules/xml/index.d.ts",
     "verify:treeshake": "node scripts/treeshake-verify.ts",
     "analyze:browser": "rimraf dist && node --input-type=module -e \"import { execSync } from 'node:child_process'; process.env.ANALYZE='true'; execSync('rolldown -c rolldown.config.ts', { stdio: 'inherit' });\"",
     "clean": "pnpm dlx --reporter=silent rimraf \"**/node_modules\" pnpm-lock.yaml \"**/dist\" -g && pnpm i",