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

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

@@ -1,142 +0,0 @@
-/**
- * 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

@@ -1,68 +0,0 @@
-/**
- * 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/zip/compress.base.js

@@ -1,80 +0,0 @@
-/**
- * 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

@@ -1,76 +0,0 @@
-/**
- * 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");
-}

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

@@ -1,82 +0,0 @@
-/**
- * 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
- */
-/**
- * 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"
- * ```
- */
-export 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)
- */
-export 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);
- * ```
- */
-export 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
- */
-export function crc32Finalize(crc) {
-    return (crc ^ 0xffffffff) >>> 0;
-}

package/dist/esm/utils/zip-stream.browser.js

@@ -1,132 +0,0 @@
-import { ZipBuilder } from "./zip/zip-builder.js";
-import { StreamBuf } from "./stream-buf.browser.js";
-// Helper function for base64 decoding in browser
-function base64ToUint8Array(base64) {
-    const binaryString = atob(base64);
-    const bytes = new Uint8Array(binaryString.length);
-    for (let i = 0; i < binaryString.length; i++) {
-        bytes[i] = binaryString.charCodeAt(i);
-    }
-    return bytes;
-}
-// =============================================================================
-// The ZipWriter class - Browser version without Node.js events dependency
-// Packs streamed data into an output zip stream
-class ZipWriter {
-    constructor(options) {
-        this.finalized = false;
-        this.pendingWrites = [];
-        this.events = new Map();
-        const level = options?.compression === "STORE"
-            ? 0
-            : Math.max(0, Math.min(9, options?.compressionOptions?.level ?? 1));
-        this.stream = new StreamBuf();
-        this.zipBuilder = new ZipBuilder({ level });
-    }
-    // Event emitter methods
-    on(event, callback) {
-        const callbacks = this.events.get(event) || [];
-        callbacks.push(callback);
-        this.events.set(event, callbacks);
-        return this;
-    }
-    once(event, callback) {
-        const onceCallback = (...args) => {
-            this.off(event, onceCallback);
-            callback(...args);
-        };
-        return this.on(event, onceCallback);
-    }
-    off(event, callback) {
-        const callbacks = this.events.get(event) || [];
-        const index = callbacks.indexOf(callback);
-        if (index !== -1) {
-            callbacks.splice(index, 1);
-        }
-        return this;
-    }
-    emit(event, ...args) {
-        const callbacks = this.events.get(event) || [];
-        callbacks.forEach(cb => cb(...args));
-        return callbacks.length > 0;
-    }
-    removeListener(event, callback) {
-        return this.off(event, callback);
-    }
-    append(data, options) {
-        let buffer;
-        if (Object.prototype.hasOwnProperty.call(options, "base64") && options.base64) {
-            const base64Data = typeof data === "string" ? data : String(data);
-            buffer = base64ToUint8Array(base64Data);
-        }
-        else if (typeof data === "string") {
-            buffer = new TextEncoder().encode(data);
-        }
-        else if (data instanceof Uint8Array) {
-            buffer = data;
-        }
-        else if (ArrayBuffer.isView(data)) {
-            buffer = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
-        }
-        else if (data instanceof ArrayBuffer) {
-            buffer = new Uint8Array(data);
-        }
-        else {
-            buffer = data;
-        }
-        const writePromise = this.zipBuilder
-            .addFile({ name: options.name, data: buffer })
-            .then(chunks => {
-            for (const chunk of chunks) {
-                this.stream.write(new Uint8Array(chunk));
-            }
-        });
-        this.pendingWrites.push(writePromise);
-    }
-    push(chunk) {
-        return this.stream.push(chunk);
-    }
-    async finalize() {
-        if (this.finalized) {
-            return;
-        }
-        this.finalized = true;
-        await Promise.all(this.pendingWrites);
-        const finalChunks = this.zipBuilder.finalize();
-        for (const chunk of finalChunks) {
-            this.stream.write(new Uint8Array(chunk));
-        }
-        this.stream.end();
-        this.emit("finish");
-    }
-    // ==========================================================================
-    // Stream.Readable interface
-    read(size) {
-        return this.stream.read(size);
-    }
-    setEncoding(encoding) {
-        return this.stream.setEncoding(encoding);
-    }
-    pause() {
-        return this.stream.pause();
-    }
-    resume() {
-        return this.stream.resume();
-    }
-    isPaused() {
-        return this.stream.isPaused();
-    }
-    pipe(destination) {
-        return this.stream.pipe(destination);
-    }
-    unpipe(destination) {
-        return this.stream.unpipe(destination);
-    }
-    unshift() {
-        return this.stream.unshift();
-    }
-    wrap() {
-        return this.stream.wrap();
-    }
-}
-export { ZipWriter };