@cj-tech-master/excelts 3.1.0-canary.20260102041828.82ed571 → 3.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cj-tech-master/excelts",
-  "version": "3.1.0-canary.20260102041828.82ed571",
+  "version": "3.1.0",
   "description": "TypeScript Excel Workbook Manager - Read and Write xlsx and csv Files.",
   "type": "module",
   "publishConfig": {
@@ -11,6 +11,13 @@
     "name": "cjnoname",
     "email": "powerfulj87@gmail.com"
   },
+  "contributors": [
+    {
+      "name": "Guyon Roche",
+      "email": "guyon@live.com",
+      "url": "https://github.com/guyonroche"
+    }
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/cjnoname/excelts.git"
@@ -23,11 +30,11 @@
     "node": ">=20.0.0"
   },
   "browserslist": [
-    "chrome >= 89",
-    "edge >= 89",
-    "firefox >= 102",
-    "safari >= 14.1",
-    "opera >= 75"
+    "chrome >= 85",
+    "edge >= 85",
+    "firefox >= 79",
+    "safari >= 14",
+    "opera >= 71"
   ],
   "exports": {
     ".": {
@@ -49,7 +56,6 @@
   "files": [
     "dist",
     "LICENSE",
-    "THIRD_PARTY_NOTICES.md",
     "README.md",
     "README_zh.md"
   ],
@@ -62,6 +68,7 @@
     "csv",
     "spreadsheet",
     "workbook",
+    "exceljs",
     "font",
     "border",
     "fill",
@@ -86,9 +93,9 @@
   "devDependencies": {
     "@eslint/js": "^9.39.2",
     "@types/node": "^25.0.3",
-    "@typescript-eslint/eslint-plugin": "^8.51.0",
-    "@typescript-eslint/parser": "^8.51.0",
-    "@typescript/native-preview": "^7.0.0-dev.20260101.1",
+    "@typescript-eslint/eslint-plugin": "^8.50.1",
+    "@typescript-eslint/parser": "^8.50.1",
+    "@typescript/native-preview": "^7.0.0-dev.20251225.1",
     "@vitest/browser": "^4.0.16",
     "@vitest/browser-playwright": "^4.0.16",
     "@vitest/ui": "^4.0.16",
@@ -98,16 +105,16 @@
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import-x": "^4.16.1",
-    "eslint-plugin-oxlint": "^1.36.0",
+    "eslint-plugin-oxlint": "^1.35.0",
     "eslint-plugin-unused-imports": "^4.3.0",
     "husky": "^9.1.7",
-    "oxlint": "^1.36.0",
+    "oxlint": "^1.35.0",
     "playwright": "^1.57.0",
     "prettier": "^3.7.4",
     "rimraf": "^6.1.2",
-    "rolldown": "^1.0.0-beta.58",
+    "rolldown": "^1.0.0-beta.57",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.51.0",
+    "typescript-eslint": "^8.50.1",
     "vite-tsconfig-paths": "^6.0.3",
     "vitest": "^4.0.16"
   },
@@ -124,10 +131,9 @@
     "type": "tsgo --noEmit",
     "format": "prettier --write \"**/*.{js,ts,json,md}\"",
     "benchmark": "rimraf dist && npm run build:esm && node --expose-gc scripts/benchmark.js",
-    "benchmark:compress": "rimraf dist && npm run build:esm && node --expose-gc scripts/benchmark-compress.js",
     "build:esm": "tsc --project tsconfig.esm.json && node scripts/fix-esm-imports.mjs",
     "build:cjs": "tsc --project tsconfig.cjs.json && node scripts/fix-cjs-imports.mjs",
-    "build:browser": "rolldown -c rolldown.config.ts",
+    "build:browser": "rolldown -c rolldown.config.js",
     "preversion": "npm run lint && npm run type && npm run build && npm run test"
   }
 }

package/THIRD_PARTY_NOTICES.md

@@ -1,112 +0,0 @@
-# Third-Party Notices
-
-This project includes software developed by third parties. The following notices are provided for attribution and license compliance.
-
----
-
-## Third-party component
-
-ExcelJS is licensed under the MIT License:
-
-The MIT License (MIT)
-
-Copyright (c) 2014-2019 Guyon Roche
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
----
-
-## Third-party component
-
-fast-csv is licensed under the MIT License:
-
-The MIT License (MIT)
-
-Copyright (c) 2011-2025 C2FO
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
----
-
-## Third-party component
-
-unzipper is licensed under the MIT License:
-
-The MIT License (MIT)
-
-Copyright (c) 2012 - 2013 Near Infinity Corporation
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
-Commits in this fork are (c) Ziggy Jonsson (ziggy.jonsson.nyc@gmail.com) and
-fall under same licence structure as the original repo (MIT).
-
----
-
-## Third-party component
-
-saxes is licensed under the ISC License:
-
-The ISC License
-
-Copyright (c) Contributors
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
-IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/dist/cjs/modules/archive/byte-queue.js

@@ -1,129 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ByteQueue = void 0;
-class ByteQueue {
-    constructor(initial) {
-        this._start = 0;
-        this._end = 0;
-        this._cachedView = null;
-        this._cachedBuf = null;
-        this._cachedStart = 0;
-        this._cachedEnd = 0;
-        this._buf = new Uint8Array(0);
-        if (initial && initial.length > 0) {
-            this.reset(initial);
-        }
-    }
-    get length() {
-        return this._end - this._start;
-    }
-    isEmpty() {
-        return this.length === 0;
-    }
-    view() {
-        if (this._start === this._end) {
-            return ByteQueue.EMPTY;
-        }
-        if (this._cachedView &&
-            this._cachedBuf === this._buf &&
-            this._cachedStart === this._start &&
-            this._cachedEnd === this._end) {
-            return this._cachedView;
-        }
-        const view = this._buf.subarray(this._start, this._end);
-        this._cachedView = view;
-        this._cachedBuf = this._buf;
-        this._cachedStart = this._start;
-        this._cachedEnd = this._end;
-        return view;
-    }
-    reset(data) {
-        this._cachedView = null;
-        this._cachedBuf = null;
-        if (!data || data.length === 0) {
-            this._buf = ByteQueue.EMPTY;
-            this._start = 0;
-            this._end = 0;
-            return;
-        }
-        // Keep a private copy to ensure future writes cannot mutate the source.
-        const copy = new Uint8Array(data.length);
-        copy.set(data);
-        this._buf = copy;
-        this._start = 0;
-        this._end = copy.length;
-    }
-    append(chunk) {
-        if (chunk.length === 0) {
-            return;
-        }
-        this._cachedView = null;
-        this._cachedBuf = null;
-        const unread = this.length;
-        // Fast path: enough tail room.
-        if (this._end + chunk.length <= this._buf.length) {
-            this._buf.set(chunk, this._end);
-            this._end += chunk.length;
-            return;
-        }
-        // Allocate a new buffer and copy unread bytes (never compacts in-place).
-        const required = unread + chunk.length;
-        const nextSize = this._buf.length === 0 ? required : Math.max(this._buf.length * 2, required);
-        const next = new Uint8Array(nextSize);
-        if (unread > 0) {
-            next.set(this._buf.subarray(this._start, this._end), 0);
-        }
-        next.set(chunk, unread);
-        this._buf = next;
-        this._start = 0;
-        this._end = required;
-    }
-    read(length) {
-        if (length <= 0) {
-            return new Uint8Array(0);
-        }
-        if (length > this.length) {
-            throw new RangeError("ByteQueue: read beyond available data");
-        }
-        // Return a view for performance.
-        // To keep this safe for async consumers, we must ensure we never write into
-        // the same backing buffer again after it becomes fully consumed.
-        const out = this._buf.subarray(this._start, this._start + length);
-        this._start += length;
-        this._cachedView = null;
-        this._cachedBuf = null;
-        if (this._start === this._end) {
-            // Release backing storage to avoid reusing memory that might still be
-            // referenced by previously returned views.
-            this._buf = ByteQueue.EMPTY;
-            this._start = 0;
-            this._end = 0;
-        }
-        return out;
-    }
-    discard(length) {
-        if (length <= 0) {
-            return;
-        }
-        if (length >= this.length) {
-            // Release backing storage for the same reason as read(): previously
-            // returned views may still be referenced by consumers.
-            this._buf = ByteQueue.EMPTY;
-            this._start = 0;
-            this._end = 0;
-            this._cachedView = null;
-            this._cachedBuf = null;
-            return;
-        }
-        this._start += length;
-        this._cachedView = null;
-        this._cachedBuf = null;
-        if (this._start === this._end) {
-            this._buf = ByteQueue.EMPTY;
-            this._start = 0;
-            this._end = 0;
-        }
-    }
-}
-exports.ByteQueue = ByteQueue;
-ByteQueue.EMPTY = new Uint8Array(0);

package/dist/cjs/modules/archive/compress.base.js

@@ -1,186 +0,0 @@
-"use strict";
-/**
- * Base compression utilities using Web Streams API
- * Shared between Node.js and Browser implementations
- *
- * Uses CompressionStream/DecompressionStream API with "deflate-raw" format
- * (raw DEFLATE without zlib header/trailer, required for ZIP files)
- *
- * Browser fallback: For browsers without deflate-raw support (Firefox < 113, Safari < 16.4),
- * see deflate-fallback.ts for pure JS implementation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_COMPRESS_THRESHOLD_BYTES = void 0;
-exports.resolveCompressThresholdBytes = resolveCompressThresholdBytes;
-exports.hasCompressionStream = hasCompressionStream;
-exports.probeDeflateRawCompressionStream = probeDeflateRawCompressionStream;
-exports.probeDeflateRawDecompressionStream = probeDeflateRawDecompressionStream;
-exports.probeDeflateRawWebStreams = probeDeflateRawWebStreams;
-exports.hasDeflateRawCompressionStream = hasDeflateRawCompressionStream;
-exports.hasDeflateRawDecompressionStream = hasDeflateRawDecompressionStream;
-exports.hasDeflateRawWebStreams = hasDeflateRawWebStreams;
-exports.compressWithStream = compressWithStream;
-exports.decompressWithStream = decompressWithStream;
-const byte_queue_1 = require("@archive/byte-queue");
-/**
- * Default threshold (in bytes) to choose the lower-overhead path.
- *
- * This is a performance knob, not a correctness requirement.
- */
-exports.DEFAULT_COMPRESS_THRESHOLD_BYTES = 8 * 1024 * 1024;
-/**
- * Resolve the effective threshold bytes.
- */
-function resolveCompressThresholdBytes(options) {
-    const value = options.thresholdBytes;
-    if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
-        return exports.DEFAULT_COMPRESS_THRESHOLD_BYTES;
-    }
-    return value;
-}
-/**
- * Check if CompressionStream is available
- */
-function hasCompressionStream() {
-    return typeof CompressionStream !== "undefined";
-}
-/**
- * Non-cached probe for CompressionStream("deflate-raw") support.
- *
- * Prefer this in code paths that want up-to-date environment checks
- * (e.g. tests that stub globals).
- */
-function probeDeflateRawCompressionStream() {
-    try {
-        if (typeof CompressionStream === "undefined") {
-            return false;
-        }
-        new CompressionStream("deflate-raw");
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Non-cached probe for DecompressionStream("deflate-raw") support.
- */
-function probeDeflateRawDecompressionStream() {
-    try {
-        if (typeof DecompressionStream === "undefined") {
-            return false;
-        }
-        new DecompressionStream("deflate-raw");
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Non-cached probe for full deflate-raw Web Streams support.
- *
- * Returns true only if BOTH CompressionStream("deflate-raw") and
- * DecompressionStream("deflate-raw") are supported.
- */
-function probeDeflateRawWebStreams() {
-    return probeDeflateRawCompressionStream() && probeDeflateRawDecompressionStream();
-}
-let _hasDeflateRawCompressionStream = null;
-let _hasDeflateRawDecompressionStream = null;
-/**
- * Check if CompressionStream supports the "deflate-raw" format.
- *
- * This is a stricter check than {@link hasCompressionStream} because some
- * environments expose CompressionStream but do not support "deflate-raw".
- */
-function hasDeflateRawCompressionStream() {
-    if (typeof CompressionStream === "undefined") {
-        return false;
-    }
-    if (_hasDeflateRawCompressionStream !== null) {
-        return _hasDeflateRawCompressionStream;
-    }
-    _hasDeflateRawCompressionStream = probeDeflateRawCompressionStream();
-    return _hasDeflateRawCompressionStream;
-}
-/**
- * Check if DecompressionStream supports the "deflate-raw" format.
- */
-function hasDeflateRawDecompressionStream() {
-    if (typeof DecompressionStream === "undefined") {
-        return false;
-    }
-    if (_hasDeflateRawDecompressionStream !== null) {
-        return _hasDeflateRawDecompressionStream;
-    }
-    _hasDeflateRawDecompressionStream = probeDeflateRawDecompressionStream();
-    return _hasDeflateRawDecompressionStream;
-}
-/**
- * Cached check for full deflate-raw Web Streams support.
- *
- * Returns true only if BOTH CompressionStream("deflate-raw") and
- * DecompressionStream("deflate-raw") are supported.
- */
-function hasDeflateRawWebStreams() {
-    return hasDeflateRawCompressionStream() && hasDeflateRawDecompressionStream();
-}
-async function streamToUint8Array(reader) {
-    const out = new byte_queue_1.ByteQueue();
-    while (true) {
-        const { done, value } = await reader.read();
-        if (done) {
-            break;
-        }
-        out.append(value);
-    }
-    return out.read(out.length);
-}
-async function transformWithStream(data, stream) {
-    const writer = stream.writable.getWriter();
-    const reader = stream.readable.getReader();
-    try {
-        // Start reading immediately to avoid potential backpressure deadlocks
-        // (writer.write/close may wait for the readable side to be consumed).
-        const readPromise = streamToUint8Array(reader);
-        await writer.write(data);
-        await writer.close();
-        return await readPromise;
-    }
-    finally {
-        try {
-            writer.releaseLock();
-        }
-        catch {
-            // ignore
-        }
-        try {
-            reader.releaseLock();
-        }
-        catch {
-            // ignore
-        }
-    }
-}
-/**
- * Compress using CompressionStream API
- * Uses "deflate-raw" format (required for ZIP files)
- *
- * @param data - Data to compress
- * @returns Compressed data
- */
-async function compressWithStream(data) {
-    const cs = new CompressionStream("deflate-raw");
-    return transformWithStream(data, cs);
-}
-/**
- * Decompress using DecompressionStream API
- *
- * @param data - Compressed data (deflate-raw format)
- * @returns Decompressed data
- */
-async function decompressWithStream(data) {
-    const ds = new DecompressionStream("deflate-raw");
-    return transformWithStream(data, ds);
-}

package/dist/cjs/modules/archive/compress.browser.js

@@ -1,98 +0,0 @@
-"use strict";
-/**
- * Browser compression utilities
- *
- * Primary: CompressionStream API (Chrome 103+, Firefox 113+, Safari 16.4+)
- * Fallback: Pure JS DEFLATE implementation for older browsers
- *
- * Supported browsers with fallback:
- * - Chrome >= 89
- * - Firefox >= 102
- * - Safari >= 14.1
- * - Edge >= 89
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasCompressionStream = hasCompressionStream;
-exports.compress = compress;
-exports.compressSync = compressSync;
-exports.decompress = decompress;
-exports.decompressSync = decompressSync;
-const compress_base_1 = require("@archive/compress.base");
-const deflate_fallback_1 = require("@archive/deflate-fallback");
-const defaults_1 = require("@archive/defaults");
-/**
- * Check if CompressionStream is available in this environment.
- *
- * Note: Some environments may expose CompressionStream but not support
- * the "deflate-raw" format that ZIP requires.
- */
-function hasCompressionStream() {
-    return typeof CompressionStream !== "undefined";
-}
-/**
- * Compress data using browser's native CompressionStream or JS fallback
- *
- * @param data - Data to compress
- * @param options - Compression options
- * @returns Compressed data
- *
- * @example
- * ```ts
- * const data = new TextEncoder().encode("Hello, World!");
- * const compressed = await compress(data, { level: 6 });
- * ```
- */
-async function compress(data, options = {}) {
-    const level = options.level ?? defaults_1.DEFAULT_COMPRESS_LEVEL;
-    const thresholdBytes = (0, compress_base_1.resolveCompressThresholdBytes)(options);
-    // Level 0 means no compression
-    if (level === 0) {
-        return data;
-    }
-    // Use native CompressionStream only for larger inputs.
-    if ((0, compress_base_1.hasDeflateRawCompressionStream)() && data.byteLength > thresholdBytes) {
-        return (0, compress_base_1.compressWithStream)(data);
-    }
-    // Fallback to pure JS implementation
-    return (0, deflate_fallback_1.deflateRawCompressed)(data);
-}
-/**
- * Compress data synchronously using pure JS implementation
- *
- * @param data - Data to compress
- * @param options - Compression options
- * @returns Compressed data
- */
-function compressSync(data, options = {}) {
-    const level = options.level ?? defaults_1.DEFAULT_COMPRESS_LEVEL;
-    // Level 0 means no compression
-    if (level === 0) {
-        return data;
-    }
-    // Pure JS implementation
-    return (0, deflate_fallback_1.deflateRawCompressed)(data);
-}
-/**
- * Decompress data using browser's native DecompressionStream or JS fallback
- *
- * @param data - Compressed data (deflate-raw format)
- * @returns Decompressed data
- */
-async function decompress(data, options = {}) {
-    const thresholdBytes = (0, compress_base_1.resolveCompressThresholdBytes)(options);
-    // Use native DecompressionStream only for larger inputs.
-    if ((0, compress_base_1.hasDeflateRawDecompressionStream)() && data.byteLength > thresholdBytes) {
-        return (0, compress_base_1.decompressWithStream)(data);
-    }
-    // Fallback to pure JS implementation
-    return (0, deflate_fallback_1.inflateRaw)(data);
-}
-/**
- * Decompress data synchronously using pure JS implementation
- *
- * @param data - Compressed data (deflate-raw format)
- * @returns Decompressed data
- */
-function decompressSync(data) {
-    return (0, deflate_fallback_1.inflateRaw)(data);
-}