@cj-tech-master/excelts 1.6.2-canary.20251224015244.0b06ae9 → 1.6.3-canary.20251224124621.73c5d94

package/dist/esm/utils/utils.base.js

@@ -0,0 +1,142 @@
+/**
+ * Base utility functions shared between Node.js and Browser
+ * Platform-independent implementations only
+ */
+// =============================================================================
+// Basic utilities
+// =============================================================================
+export function delay(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+export function nop() { }
+export const inherits = function (cls, superCtor, statics, prototype) {
+    cls.super_ = superCtor;
+    if (!prototype) {
+        prototype = statics;
+        statics = null;
+    }
+    if (statics) {
+        Object.keys(statics).forEach(i => {
+            Object.defineProperty(cls, i, Object.getOwnPropertyDescriptor(statics, i));
+        });
+    }
+    const properties = {
+        constructor: {
+            value: cls,
+            enumerable: false,
+            writable: false,
+            configurable: true
+        }
+    };
+    if (prototype) {
+        Object.keys(prototype).forEach(i => {
+            properties[i] = Object.getOwnPropertyDescriptor(prototype, i);
+        });
+    }
+    cls.prototype = Object.create(superCtor.prototype, properties);
+};
+// =============================================================================
+// Date utilities
+// =============================================================================
+export function dateToExcel(d, date1904) {
+    return 25569 + d.getTime() / (24 * 3600 * 1000) - (date1904 ? 1462 : 0);
+}
+export function excelToDate(v, date1904) {
+    const millisecondSinceEpoch = Math.round((v - 25569 + (date1904 ? 1462 : 0)) * 24 * 3600 * 1000);
+    return new Date(millisecondSinceEpoch);
+}
+export function toIsoDateString(dt) {
+    return dt.toISOString().substr(0, 10);
+}
+export function parsePath(filepath) {
+    const last = filepath.lastIndexOf("/");
+    return {
+        path: filepath.substring(0, last),
+        name: filepath.substring(last + 1)
+    };
+}
+export function getRelsPath(filepath) {
+    const path = parsePath(filepath);
+    return `${path.path}/_rels/${path.name}.rels`;
+}
+// =============================================================================
+// XML utilities
+// =============================================================================
+const xmlDecodingMap = {
+    lt: "<",
+    gt: ">",
+    amp: "&",
+    quot: '"',
+    apos: "'"
+};
+export function xmlDecode(text) {
+    return text.replace(/&(#\d+|#x[0-9A-Fa-f]+|\w+);/g, (match, entity) => {
+        if (entity[0] === "#") {
+            // Numeric character reference
+            const code = entity[1] === "x" ? parseInt(entity.slice(2), 16) : parseInt(entity.slice(1));
+            return String.fromCodePoint(code);
+        }
+        return xmlDecodingMap[entity] || match;
+    });
+}
+// =============================================================================
+// Parsing utilities
+// =============================================================================
+export function validInt(value) {
+    const i = typeof value === "number" ? value : parseInt(value, 10);
+    return Number.isNaN(i) ? 0 : i;
+}
+export function isDateFmt(fmt) {
+    if (!fmt) {
+        return false;
+    }
+    // must not be a string fmt
+    if (fmt.indexOf("@") > -1) {
+        return false;
+    }
+    // must remove all chars inside quotes and []
+    let cleanFmt = fmt.replace(/\[[^\]]*]/g, "");
+    cleanFmt = cleanFmt.replace(/"[^"]*"/g, "");
+    // then check for date formatting chars
+    return cleanFmt.match(/[ymdhMsb]+/) !== null;
+}
+export function parseBoolean(value) {
+    return value === true || value === "true" || value === 1 || value === "1";
+}
+// =============================================================================
+// Collection utilities
+// =============================================================================
+export function* range(start, stop, step = 1) {
+    const compareOrder = step > 0 ? (a, b) => a < b : (a, b) => a > b;
+    for (let value = start; compareOrder(value, stop); value += step) {
+        yield value;
+    }
+}
+export function toSortedArray(values) {
+    const result = Array.from(values);
+    // If all numbers, use numeric sort
+    if (result.every(item => Number.isFinite(item))) {
+        return result.sort((a, b) => a - b);
+    }
+    return result.sort();
+}
+export function objectFromProps(props, value = null) {
+    return props.reduce((result, property) => {
+        result[property] = value;
+        return result;
+    }, {});
+}
+// =============================================================================
+// Buffer utilities (cross-platform)
+// =============================================================================
+const textDecoder = new TextDecoder("utf-8");
+/**
+ * Convert a Buffer, ArrayBuffer, or Uint8Array to a UTF-8 string
+ * Works in both Node.js and browser environments
+ */
+export function bufferToString(chunk) {
+    if (typeof chunk === "string") {
+        return chunk;
+    }
+    return textDecoder.decode(chunk);
+}

package/dist/esm/utils/utils.browser.js

@@ -0,0 +1,68 @@
+/**
+ * Browser utility functions
+ * Re-exports shared utilities and adds browser-specific implementations
+ */
+// Re-export all shared utilities
+export { delay, nop, inherits, dateToExcel, excelToDate, toIsoDateString, parsePath, getRelsPath, xmlDecode, validInt, isDateFmt, parseBoolean, range, toSortedArray, objectFromProps, bufferToString } from "./utils.base.js";
+// =============================================================================
+// XML encoding (Browser version with full Unicode support)
+// =============================================================================
+const xmlEncodingMap = {
+    "<": "&lt;",
+    ">": "&gt;",
+    "&": "&amp;",
+    '"': "&quot;",
+    "'": "&apos;"
+};
+export function xmlEncode(text) {
+    // Handles special characters:
+    // 1. XML entities: < > & " '
+    // 2. Control characters (0x00-0x1F except tab, newline, carriage return)
+    // 3. Invalid XML characters: 0xFFFE, 0xFFFF
+    // 4. Characters that need escaping in attributes
+    // First pass: escape XML entities
+    let result = text.replace(/[<>&"']/g, char => xmlEncodingMap[char] || char);
+    // Second pass: handle control characters and invalid XML characters
+    // Valid XML chars: #x9 | #xA | #xD | [#x20-#xD7FF] | [#xE000-#xFFFD] | [#x10000-#x10FFFF]
+    // oxlint-disable-next-line no-control-regex
+    result = result.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F\uFFFE\uFFFF]/g, char => {
+        const code = char.charCodeAt(0);
+        // For control characters, use numeric character reference
+        return `&#x${code.toString(16).toUpperCase()};`;
+    });
+    // Third pass: handle invalid surrogate pairs
+    result = result.replace(/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/g, () => "\uFFFD" // replacement character
+    );
+    return result;
+}
+// =============================================================================
+// File system utilities (Browser stub - always returns false)
+// =============================================================================
+export function fileExists(_path) {
+    return Promise.resolve(false);
+}
+// =============================================================================
+// Legacy export for backward compatibility
+// =============================================================================
+import { nop, inherits, dateToExcel, excelToDate, parsePath, getRelsPath, xmlDecode, validInt, isDateFmt, toIsoDateString, parseBoolean, range, toSortedArray, objectFromProps } from "./utils.base.js";
+/** @deprecated Import functions directly instead of using the utils object */
+export const utils = {
+    nop,
+    inherits,
+    dateToExcel,
+    excelToDate,
+    parsePath,
+    getRelsPath,
+    xmlEncode,
+    xmlDecode,
+    validInt,
+    isDateFmt,
+    fs: {
+        exists: fileExists
+    },
+    toIsoDateString,
+    parseBoolean,
+    range,
+    toSortedArray,
+    objectFromProps
+};

package/dist/esm/utils/utils.js

@@ -1,53 +1,13 @@
+/**
+ * Node.js utility functions
+ * Re-exports shared utilities and adds Node.js-specific implementations
+ */
 import fs from "fs";
-export function delay(ms) {
-    return new Promise(resolve => setTimeout(resolve, ms));
-}
-export function nop() { }
-// useful stuff
-export const inherits = function (cls, superCtor, statics, prototype) {
-    cls.super_ = superCtor;
-    if (!prototype) {
-        prototype = statics;
-        statics = null;
-    }
-    if (statics) {
-        Object.keys(statics).forEach(i => {
-            Object.defineProperty(cls, i, Object.getOwnPropertyDescriptor(statics, i));
-        });
-    }
-    const properties = {
-        constructor: {
-            value: cls,
-            enumerable: false,
-            writable: false,
-            configurable: true
-        }
-    };
-    if (prototype) {
-        Object.keys(prototype).forEach(i => {
-            properties[i] = Object.getOwnPropertyDescriptor(prototype, i);
-        });
-    }
-    cls.prototype = Object.create(superCtor.prototype, properties);
-};
-export function dateToExcel(d, date1904) {
-    return 25569 + d.getTime() / (24 * 3600 * 1000) - (date1904 ? 1462 : 0);
-}
-export function excelToDate(v, date1904) {
-    const millisecondSinceEpoch = Math.round((v - 25569 + (date1904 ? 1462 : 0)) * 24 * 3600 * 1000);
-    return new Date(millisecondSinceEpoch);
-}
-export function parsePath(filepath) {
-    const last = filepath.lastIndexOf("/");
-    return {
-        path: filepath.substring(0, last),
-        name: filepath.substring(last + 1)
-    };
-}
-export function getRelsPath(filepath) {
-    const path = parsePath(filepath);
-    return `${path.path}/_rels/${path.name}.rels`;
-}
+// Re-export all shared utilities
+export { delay, nop, inherits, dateToExcel, excelToDate, toIsoDateString, parsePath, getRelsPath, xmlDecode, validInt, isDateFmt, parseBoolean, range, toSortedArray, objectFromProps, bufferToString } from "./utils.base.js";
+// =============================================================================
+// XML encoding (Node.js optimized version)
+// =============================================================================
 // oxlint-disable-next-line no-control-regex -- Control characters are intentionally matched for XML encoding
 const xmlDecodeRegex = /[<>&'"\x7F\x00-\x08\x0B-\x0C\x0E-\x1F]/;
 export function xmlEncode(text) {
@@ -101,39 +61,9 @@ export function xmlEncode(text) {
     }
     return result;
 }
-export function xmlDecode(text) {
-    return text.replace(/&([a-z]*);/g, c => {
-        switch (c) {
-            case "&lt;":
-                return "<";
-            case "&gt;":
-                return ">";
-            case "&amp;":
-                return "&";
-            case "&apos;":
-                return "'";
-            case "&quot;":
-                return '"';
-            default:
-                return c;
-        }
-    });
-}
-export function validInt(value) {
-    const i = parseInt(value, 10);
-    return !Number.isNaN(i) ? i : 0;
-}
-export function isDateFmt(fmt) {
-    if (!fmt) {
-        return false;
-    }
-    // must remove all chars inside quotes and []
-    fmt = fmt.replace(/\[[^\]]*]/g, "");
-    fmt = fmt.replace(/"[^"]*"/g, "");
-    // then check for date formatting chars
-    const result = fmt.match(/[ymdhMsb]+/) !== null;
-    return result;
-}
+// =============================================================================
+// File system utilities (Node.js only)
+// =============================================================================
 export function fileExists(path) {
     return new Promise(resolve => {
         fs.access(path, fs.constants.F_OK, err => {
@@ -141,36 +71,10 @@ export function fileExists(path) {
         });
     });
 }
-export function toIsoDateString(dt) {
-    return dt.toISOString().substr(0, 10);
-}
-export function parseBoolean(value) {
-    return value === true || value === "true" || value === 1 || value === "1";
-}
-export function* range(start, stop, step = 1) {
-    const compareOrder = step > 0 ? (a, b) => a < b : (a, b) => a > b;
-    for (let value = start; compareOrder(value, stop); value += step) {
-        yield value;
-    }
-}
-export function toSortedArray(values) {
-    const result = Array.from(values);
-    // Note: per default, `Array.prototype.sort()` converts values
-    // to strings when comparing. Here, if we have numbers, we use
-    // numeric sort.
-    if (result.every(item => Number.isFinite(item))) {
-        const compareNumbers = (a, b) => a - b;
-        return result.sort(compareNumbers);
-    }
-    return result.sort();
-}
-export function objectFromProps(props, value = null) {
-    return props.reduce((result, property) => {
-        result[property] = value;
-        return result;
-    }, {});
-}
+// =============================================================================
 // Legacy export for backward compatibility
+// =============================================================================
+import { nop, inherits, dateToExcel, excelToDate, parsePath, getRelsPath, xmlDecode, validInt, isDateFmt, toIsoDateString, parseBoolean, range, toSortedArray, objectFromProps } from "./utils.base.js";
 /** @deprecated Import functions directly instead of using the utils object */
 export const utils = {
     nop,
@@ -192,15 +96,3 @@ export const utils = {
     toSortedArray,
     objectFromProps
 };
-// TextDecoder is available in ES2020+ and all modern browsers/Node.js
-const textDecoder = new TextDecoder("utf-8");
-/**
- * Convert a Buffer or ArrayBuffer to a UTF-8 string
- * Works in both Node.js and browser environments
- */
-export function bufferToString(chunk) {
-    if (typeof chunk === "string") {
-        return chunk;
-    }
-    return textDecoder.decode(chunk);
-}

package/dist/esm/utils/zip/compress.base.js

@@ -0,0 +1,80 @@
+/**
+ * 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)
+ */
+/**
+ * Check if CompressionStream is available
+ */
+export function hasCompressionStream() {
+    return typeof CompressionStream !== "undefined";
+}
+/**
+ * Compress using CompressionStream API
+ * Uses "deflate-raw" format (required for ZIP files)
+ *
+ * @param data - Data to compress
+ * @returns Compressed data
+ */
+export async function compressWithStream(data) {
+    const cs = new CompressionStream("deflate-raw");
+    const writer = cs.writable.getWriter();
+    const reader = cs.readable.getReader();
+    // Write data and close
+    writer.write(new Uint8Array(data.buffer, data.byteOffset, data.byteLength));
+    writer.close();
+    // Read all compressed chunks
+    const chunks = [];
+    let totalLength = 0;
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done) {
+            break;
+        }
+        chunks.push(value);
+        totalLength += value.length;
+    }
+    // Combine chunks into single array
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return result;
+}
+/**
+ * Decompress using DecompressionStream API
+ *
+ * @param data - Compressed data (deflate-raw format)
+ * @returns Decompressed data
+ */
+export async function decompressWithStream(data) {
+    const ds = new DecompressionStream("deflate-raw");
+    const writer = ds.writable.getWriter();
+    const reader = ds.readable.getReader();
+    // Write data and close
+    writer.write(new Uint8Array(data.buffer, data.byteOffset, data.byteLength));
+    writer.close();
+    // Read all decompressed chunks
+    const chunks = [];
+    let totalLength = 0;
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done) {
+            break;
+        }
+        chunks.push(value);
+        totalLength += value.length;
+    }
+    // Combine chunks into single array
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return result;
+}

package/dist/esm/utils/zip/compress.browser.js

@@ -0,0 +1,76 @@
+/**
+ * Browser compression utilities using Web Streams API
+ *
+ * Uses CompressionStream API (Chrome 80+, Firefox 113+, Safari 16.4+)
+ * with "deflate-raw" format (required for ZIP files)
+ */
+import { hasCompressionStream, compressWithStream, decompressWithStream } from "./compress.base.js";
+// Re-export shared types and utilities
+export { hasCompressionStream };
+/**
+ * Check if native zlib is available (always false in browser)
+ */
+export function hasNativeZlib() {
+    return false;
+}
+/**
+ * Compress data using browser's native CompressionStream
+ *
+ * @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 });
+ * ```
+ */
+export async function compress(data, options = {}) {
+    const level = options.level ?? 6;
+    // Level 0 means no compression
+    if (level === 0) {
+        return data;
+    }
+    // Use CompressionStream
+    if (typeof CompressionStream !== "undefined") {
+        return compressWithStream(data);
+    }
+    // No compression available - return original data
+    console.warn("No native compression available, returning uncompressed data");
+    return data;
+}
+/**
+ * Compress data synchronously
+ * Not available in browser - throws error
+ *
+ * @param _data - Data to compress
+ * @param _options - Compression options
+ * @throws Error always - sync compression not available in browser
+ */
+export function compressSync(_data, _options = {}) {
+    throw new Error("Synchronous compression is not available in browser environment");
+}
+/**
+ * Decompress data using browser's native DecompressionStream
+ *
+ * @param data - Compressed data (deflate-raw format)
+ * @returns Decompressed data
+ */
+export async function decompress(data) {
+    // Use DecompressionStream
+    if (typeof DecompressionStream !== "undefined") {
+        return decompressWithStream(data);
+    }
+    throw new Error("No native decompression available in browser");
+}
+/**
+ * Decompress data synchronously
+ * Not available in browser - throws error
+ *
+ * @param _data - Compressed data
+ * @throws Error always - sync decompression not available in browser
+ */
+export function decompressSync(_data) {
+    throw new Error("Synchronous decompression is not available in browser environment");
+}