@cj-tech-master/excelts 8.1.0 → 8.1.1

package/README.md

@@ -2,7 +2,9 @@
 
 [![Build Status](https://github.com/cjnoname/excelts/actions/workflows/ci.yml/badge.svg?branch=main&event=push)](https://github.com/cjnoname/excelts/actions/workflows/ci.yml)   [中文](README_zh.md)
 
-Zero-dependency, AI-friendly TypeScript toolkit — Excel, PDF, CSV, Markdown, XML, ZIP, and streaming in one library with seven standalone modules.
+The TypeScript ecosystem is heavily fragmented when it comes to document and data processing. To handle Excel, PDF, CSV, XML, ZIP, and streaming, developers often need to pull in a different package for each task — and then yet another set of packages to make them work in the browser, plus separate streaming wrappers on top. These libraries vary in API style, quality, and maintenance status, creating a tax on every project that needs more than one of them.
+
+ExcelTS was built to fix this. One package, one consistent API, one codebase — working identically across Node.js, Bun, and browsers. Streaming is a first-class citizen in every module, not an afterthought bolted on through a third-party adapter. The goal is simple: install once, import what you need, and get the same reliable behavior everywhere — with maximum streaming performance out of the box.
 
 ## About This Project
 
@@ -14,12 +16,6 @@ ExcelTS is a zero-dependency TypeScript toolkit for spreadsheets and documents:
 - **Cross-Platform** — Node.js 22+, Bun, Chrome 89+, Firefox 102+, Safari 14.1+
 - **ESM First** — Native ES Modules with CommonJS compatibility and full tree-shaking
 
-## Motivation
-
-The TypeScript ecosystem is heavily fragmented when it comes to document and data processing. To handle Excel, PDF, CSV, XML, ZIP, and streaming, developers often need to pull in a different package for each task — and then yet another set of packages to make them work in the browser, plus separate streaming wrappers on top. These libraries vary in API style, quality, and maintenance status, creating a tax on every project that needs more than one of them.
-
-ExcelTS was built to fix this. One package, one consistent API, one codebase — working identically across Node.js, Bun, and browsers. Streaming is a first-class citizen in every module, not an afterthought bolted on through a third-party adapter. The goal is simple: install once, import what you need, and get the same reliable behavior everywhere — with maximum streaming performance out of the box.
-
 ## Modules
 
 ExcelTS is organized into seven standalone modules. Each module has its own documentation and runnable examples.

package/README_zh.md

@@ -2,7 +2,9 @@
 
 [![构建状态](https://github.com/cjnoname/excelts/actions/workflows/ci.yml/badge.svg?branch=main&event=push)](https://github.com/cjnoname/excelts/actions/workflows/ci.yml)   [English](README.md)
 
-零依赖、AI 友好的 TypeScript 工具包 — Excel、PDF、CSV、Markdown、XML、ZIP 和流式处理，七大独立模块，一个库搞定。
+TypeScript 生态在文档和数据处理领域长期存在碎片化问题。处理 Excel、PDF、CSV、XML、ZIP 和流式操作，往往需要分别引入不同的包；到了浏览器端又要换一套方案；流式处理还得再额外接入一个适配库。这些库的 API 风格、质量和维护状态参差不齐，给每个需要组合使用它们的项目都带来了额外的负担。
+
+ExcelTS 正是为了解决这个问题而生。一个包、一套 API、一份代码 — 在 Node.js、Bun 和浏览器中行为完全一致。流式处理是每个模块的一等公民，而非通过第三方适配器后期拼装的附属品。目标很简单：安装一次，按需导入，在任何环境下都获得相同的可靠体验 — 同时将流式处理的性能发挥到极致。
 
 ## 关于本项目
 
@@ -14,12 +16,6 @@ ExcelTS 是一个零依赖的 TypeScript 电子表格和文档工具包：
 - **跨平台** — Node.js 22+、Bun、Chrome 89+、Firefox 102+、Safari 14.1+
 - **ESM 优先** — 原生 ES Modules，兼容 CommonJS，完整的 tree-shaking 支持
 
-## 项目初衷
-
-TypeScript 生态在文档和数据处理领域长期存在碎片化问题。处理 Excel、PDF、CSV、XML、ZIP 和流式操作，往往需要分别引入不同的包；到了浏览器端又要换一套方案；流式处理还得再额外接入一个适配库。这些库的 API 风格、质量和维护状态参差不齐，给每个需要组合使用它们的项目都带来了额外的负担。
-
-ExcelTS 正是为了解决这个问题而生。一个包、一套 API、一份代码 — 在 Node.js、Bun 和浏览器中行为完全一致。流式处理是每个模块的一等公民，而非通过第三方适配器后期拼装的附属品。目标很简单：安装一次，按需导入，在任何环境下都获得相同的可靠体验 — 同时将流式处理的性能发挥到极致。
-
 ## 模块
 
 ExcelTS 由七个独立模块组成，每个模块都有自己的文档和可运行示例。

package/dist/browser/modules/pdf/reader/metadata-reader.js

@@ -217,13 +217,14 @@ function extractXmpField(xml, field) {
     }
     return null;
 }
-function decodeXmlEntities(text) {
+/** @internal Exported for testing only. */
+export function decodeXmlEntities(text) {
     return text
-        .replace(/&/g, "&")
         .replace(/&lt;/g, "<")
         .replace(/&gt;/g, ">")
         .replace(/&quot;/g, '"')
-        .replace(/&apos;/g, "'");
+        .replace(/&apos;/g, "'")
+        .replace(/&amp;/g, "&");
 }
 // =============================================================================
 // Page Size

package/dist/cjs/modules/pdf/reader/metadata-reader.js

@@ -16,6 +16,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.extractMetadata = extractMetadata;
+exports.decodeXmlEntities = decodeXmlEntities;
 const pdf_parser_1 = require("./pdf-parser");
 // =============================================================================
 // Public API
@@ -220,13 +221,14 @@ function extractXmpField(xml, field) {
     }
     return null;
 }
+/** @internal Exported for testing only. */
 function decodeXmlEntities(text) {
     return text
-        .replace(/&/g, "&")
         .replace(/&lt;/g, "<")
         .replace(/&gt;/g, ">")
         .replace(/&quot;/g, '"')
-        .replace(/&apos;/g, "'");
+        .replace(/&apos;/g, "'")
+        .replace(/&amp;/g, "&");
 }
 // =============================================================================
 // Page Size

package/dist/esm/modules/pdf/reader/metadata-reader.js

@@ -217,13 +217,14 @@ function extractXmpField(xml, field) {
     }
     return null;
 }
-function decodeXmlEntities(text) {
+/** @internal Exported for testing only. */
+export function decodeXmlEntities(text) {
     return text
-        .replace(/&/g, "&")
         .replace(/&lt;/g, "<")
         .replace(/&gt;/g, ">")
         .replace(/&quot;/g, '"')
-        .replace(/&apos;/g, "'");
+        .replace(/&apos;/g, "'")
+        .replace(/&amp;/g, "&");
 }
 // =============================================================================
 // Page Size

package/dist/iife/excelts.iife.js

@@ -1,5 +1,5 @@
 /*!
-* @cj-tech-master/excelts v8.1.0
+* @cj-tech-master/excelts v8.1.1
 * 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.0
+* @cj-tech-master/excelts v8.1.1
 * 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.0",
+  "version": "8.1.1",
   "description": "Zero-dependency TypeScript toolkit — Excel (XLSX), PDF, CSV, Markdown, XML, ZIP/TAR, and streaming.",
   "type": "module",
   "main": "./dist/cjs/index.js",