@cj-tech-master/excelts 3.1.0 → 4.0.0

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

@@ -1,88 +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.hasCompressionStream = hasCompressionStream;
-exports.compressWithStream = compressWithStream;
-exports.decompressWithStream = decompressWithStream;
-/**
- * Check if CompressionStream is available
- */
-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
- */
-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
- */
-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/cjs/utils/zip/compress.browser.js

@@ -1,127 +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 >= 85
- * - Firefox >= 79
- * - Safari >= 14
- * - Edge >= 85
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasCompressionStream = hasCompressionStream;
-exports.hasNativeZlib = hasNativeZlib;
-exports.compress = compress;
-exports.compressSync = compressSync;
-exports.decompress = decompress;
-exports.decompressSync = decompressSync;
-const compress_base_1 = require("./compress.base");
-const deflate_fallback_1 = require("./deflate-fallback");
-/**
- * Check if CompressionStream with "deflate-raw" is available
- * Note: Chrome 80-102 has CompressionStream but not deflate-raw support
- */
-function hasCompressionStream() {
-    if (typeof CompressionStream === "undefined") {
-        return false;
-    }
-    // Test if deflate-raw is supported (not just CompressionStream existence)
-    try {
-        new CompressionStream("deflate-raw");
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-// Cache the detection result for performance
-let _hasDeflateRaw = null;
-/**
- * Check if deflate-raw is supported, with caching for performance.
- * The cache is bypassed if CompressionStream is undefined (for testing).
- */
-function hasDeflateRawSupport() {
-    // If API doesn't exist, return false immediately (bypass cache for tests)
-    if (typeof CompressionStream === "undefined") {
-        return false;
-    }
-    // Use cached result for performance
-    if (_hasDeflateRaw === null) {
-        _hasDeflateRaw = hasCompressionStream();
-    }
-    return _hasDeflateRaw;
-}
-/**
- * Check if native zlib is available (always false in browser)
- */
-function hasNativeZlib() {
-    return false;
-}
-/**
- * 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 ?? 6;
-    // Level 0 means no compression (STORE mode)
-    if (level === 0) {
-        return (0, deflate_fallback_1.deflateRawStore)(data);
-    }
-    // Use native CompressionStream if available
-    if (hasDeflateRawSupport()) {
-        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 ?? 6;
-    // Level 0 means no compression (STORE mode)
-    if (level === 0) {
-        return (0, deflate_fallback_1.deflateRawStore)(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) {
-    // Use native DecompressionStream if available
-    if (hasDeflateRawSupport()) {
-        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);
-}

package/dist/cjs/utils/zip/compress.js

@@ -1,81 +0,0 @@
-"use strict";
-/**
- * Node.js compression utilities using native zlib
- *
- * Uses zlib module (C++ implementation, fastest) with "deflate-raw" format
- * (raw DEFLATE without zlib header/trailer, required for ZIP files)
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasCompressionStream = void 0;
-exports.hasNativeZlib = hasNativeZlib;
-exports.compress = compress;
-exports.compressSync = compressSync;
-exports.decompress = decompress;
-exports.decompressSync = decompressSync;
-const zlib_1 = require("zlib");
-// Re-export shared types and utilities
-var compress_base_1 = require("./compress.base");
-Object.defineProperty(exports, "hasCompressionStream", { enumerable: true, get: function () { return compress_base_1.hasCompressionStream; } });
-/**
- * Check if native zlib is available (always true in Node.js)
- */
-function hasNativeZlib() {
-    return true;
-}
-/**
- * Compress data using Node.js native zlib
- *
- * @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 ?? 6;
-    // Level 0 means no compression
-    if (level === 0) {
-        return data;
-    }
-    const result = (0, zlib_1.deflateRawSync)(Buffer.from(data), { level });
-    return new Uint8Array(result.buffer, result.byteOffset, result.byteLength);
-}
-/**
- * Compress data synchronously using Node.js zlib
- *
- * @param data - Data to compress
- * @param options - Compression options
- * @returns Compressed data
- */
-function compressSync(data, options = {}) {
-    const level = options.level ?? 6;
-    if (level === 0) {
-        return data;
-    }
-    const result = (0, zlib_1.deflateRawSync)(Buffer.from(data), { level });
-    return new Uint8Array(result.buffer, result.byteOffset, result.byteLength);
-}
-/**
- * Decompress data using Node.js native zlib
- *
- * @param data - Compressed data (deflate-raw format)
- * @returns Decompressed data
- */
-async function decompress(data) {
-    const result = (0, zlib_1.inflateRawSync)(Buffer.from(data));
-    return new Uint8Array(result.buffer, result.byteOffset, result.byteLength);
-}
-/**
- * Decompress data synchronously using Node.js zlib
- *
- * @param data - Compressed data (deflate-raw format)
- * @returns Decompressed data
- */
-function decompressSync(data) {
-    const result = (0, zlib_1.inflateRawSync)(Buffer.from(data));
-    return new Uint8Array(result.buffer, result.byteOffset, result.byteLength);
-}

package/dist/cjs/utils/zip/crc32.browser.js

@@ -1,88 +0,0 @@
-"use strict";
-/**
- * CRC32 calculation utility for ZIP files (Browser version)
- *
- * Uses lookup table optimization - no Node.js dependencies
- *
- * The polynomial used is the standard CRC-32 IEEE 802.3:
- * x^32 + x^26 + x^23 + x^22 + x^16 + x^12 + x^11 + x^10 + x^8 + x^7 + x^5 + x^4 + x^2 + x + 1
- * Represented as 0xEDB88320 in reversed (LSB-first) form
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.crc32 = crc32;
-exports.ensureCrc32 = ensureCrc32;
-exports.crc32Update = crc32Update;
-exports.crc32Finalize = crc32Finalize;
-/**
- * Pre-computed CRC32 lookup table (256 entries)
- * Generated using the standard polynomial 0xEDB88320
- */
-const CRC32_TABLE = /* @__PURE__ */ (() => {
-    const table = new Uint32Array(256);
-    for (let i = 0; i < 256; i++) {
-        let crc = i;
-        for (let j = 0; j < 8; j++) {
-            crc = crc & 1 ? 0xedb88320 ^ (crc >>> 1) : crc >>> 1;
-        }
-        table[i] = crc;
-    }
-    return table;
-})();
-/**
- * Calculate CRC32 checksum for the given data
- *
- * @param data - Input data as Uint8Array
- * @returns CRC32 checksum as unsigned 32-bit integer
- *
- * @example
- * ```ts
- * const data = new TextEncoder().encode("Hello, World!");
- * const checksum = crc32(data);
- * console.log(checksum.toString(16)); // "ec4ac3d0"
- * ```
- */
-function crc32(data) {
-    let crc = 0xffffffff;
-    for (let i = 0; i < data.length; i++) {
-        crc = CRC32_TABLE[(crc ^ data[i]) & 0xff] ^ (crc >>> 8);
-    }
-    return (crc ^ 0xffffffff) >>> 0;
-}
-/**
- * Ensure CRC32 is ready (no-op in browser, for API compatibility)
- */
-async function ensureCrc32() {
-    // No-op in browser
-}
-/**
- * Calculate CRC32 incrementally (useful for streaming)
- * Call with initial crc of 0xffffffff, then finalize with crc32Finalize
- *
- * @param crc - Current CRC value (start with 0xffffffff)
- * @param data - Input data chunk
- * @returns Updated CRC value (not finalized)
- *
- * @example
- * ```ts
- * let crc = 0xffffffff;
- * crc = crc32Update(crc, chunk1);
- * crc = crc32Update(crc, chunk2);
- * const checksum = crc32Finalize(crc);
- * ```
- */
-function crc32Update(crc, data) {
-    for (let i = 0; i < data.length; i++) {
-        crc = CRC32_TABLE[(crc ^ data[i]) & 0xff] ^ (crc >>> 8);
-    }
-    return crc;
-}
-/**
- * Finalize CRC32 calculation
- * XOR with 0xffffffff and convert to unsigned 32-bit
- *
- * @param crc - CRC value from crc32Update
- * @returns Final CRC32 checksum
- */
-function crc32Finalize(crc) {
-    return (crc ^ 0xffffffff) >>> 0;
-}

package/dist/cjs/utils/zip/crc32.js

@@ -1,154 +0,0 @@
-"use strict";
-/**
- * CRC32 calculation utility for ZIP files
- *
- * - Node.js: Uses native zlib.crc32 (C++ implementation, ~100x faster)
- * - Browser: Uses lookup table optimization
- *
- * The polynomial used is the standard CRC-32 IEEE 802.3:
- * x^32 + x^26 + x^23 + x^22 + x^16 + x^12 + x^11 + x^10 + x^8 + x^7 + x^5 + x^4 + x^2 + x + 1
- * Represented as 0xEDB88320 in reversed (LSB-first) form
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.crc32 = crc32;
-exports.ensureCrc32 = ensureCrc32;
-exports.crc32Update = crc32Update;
-exports.crc32Finalize = crc32Finalize;
-// Detect Node.js environment
-const isNode = typeof process !== "undefined" && process.versions?.node;
-// Lazy-loaded zlib module for Node.js
-let _zlib = null;
-let _zlibLoading = null;
-// Auto-initialize zlib in Node.js environment
-if (isNode) {
-    _zlibLoading = Promise.resolve().then(() => __importStar(require("zlib"))).then(module => {
-        _zlib = module.default ?? module;
-        return _zlib;
-    })
-        .catch(() => {
-        _zlib = null;
-        return null;
-    });
-}
-/**
- * Pre-computed CRC32 lookup table (256 entries)
- * Generated using the standard polynomial 0xEDB88320
- * Used as fallback when native zlib is not available
- */
-const CRC32_TABLE = /* @__PURE__ */ (() => {
-    const table = new Uint32Array(256);
-    for (let i = 0; i < 256; i++) {
-        let crc = i;
-        for (let j = 0; j < 8; j++) {
-            crc = crc & 1 ? 0xedb88320 ^ (crc >>> 1) : crc >>> 1;
-        }
-        table[i] = crc;
-    }
-    return table;
-})();
-/**
- * JavaScript fallback CRC32 implementation using lookup table
- */
-function crc32JS(data) {
-    let crc = 0xffffffff;
-    for (let i = 0; i < data.length; i++) {
-        crc = CRC32_TABLE[(crc ^ data[i]) & 0xff] ^ (crc >>> 8);
-    }
-    return (crc ^ 0xffffffff) >>> 0;
-}
-/**
- * Calculate CRC32 checksum for the given data
- * Uses native zlib.crc32 in Node.js for ~100x better performance
- *
- * @param data - Input data as Uint8Array or Buffer
- * @returns CRC32 checksum as unsigned 32-bit integer
- *
- * @example
- * ```ts
- * const data = new TextEncoder().encode("Hello, World!");
- * const checksum = crc32(data);
- * console.log(checksum.toString(16)); // "ec4ac3d0"
- * ```
- */
-function crc32(data) {
-    // Use native zlib.crc32 if available (Node.js)
-    if (_zlib && typeof _zlib.crc32 === "function") {
-        return _zlib.crc32(data) >>> 0;
-    }
-    // Fallback to JS implementation
-    return crc32JS(data);
-}
-/**
- * Ensure zlib is loaded (for use before calling crc32)
- */
-async function ensureCrc32() {
-    if (_zlibLoading) {
-        await _zlibLoading;
-    }
-}
-/**
- * Calculate CRC32 incrementally (useful for streaming)
- * Call with initial crc of 0xffffffff, then finalize with crc32Finalize
- * Note: This always uses JS implementation for consistency in streaming
- *
- * @param crc - Current CRC value (start with 0xffffffff)
- * @param data - Input data chunk
- * @returns Updated CRC value (not finalized)
- *
- * @example
- * ```ts
- * let crc = 0xffffffff;
- * crc = crc32Update(crc, chunk1);
- * crc = crc32Update(crc, chunk2);
- * const checksum = crc32Finalize(crc);
- * ```
- */
-function crc32Update(crc, data) {
-    for (let i = 0; i < data.length; i++) {
-        crc = CRC32_TABLE[(crc ^ data[i]) & 0xff] ^ (crc >>> 8);
-    }
-    return crc;
-}
-/**
- * Finalize CRC32 calculation
- * XOR with 0xffffffff and convert to unsigned 32-bit
- *
- * @param crc - CRC value from crc32Update
- * @returns Final CRC32 checksum
- */
-function crc32Finalize(crc) {
-    return (crc ^ 0xffffffff) >>> 0;
-}