@cj-tech-master/excelts 1.6.3 → 2.0.0-canary.20251228013952.4f2c3c6

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

@@ -0,0 +1,352 @@
+import { StringBuf } from "./string-buf.js";
+// =============================================================================
+// Data chunks - encapsulating incoming data
+class StringChunk {
+    constructor(data, encoding) {
+        this._data = data;
+        this._encoding = encoding;
+    }
+    get length() {
+        return this.toBuffer().length;
+    }
+    copy(target, targetOffset, offset, length) {
+        const buf = this.toBuffer();
+        const bytesToCopy = Math.min(length, buf.length - offset);
+        target.set(buf.subarray(offset, offset + bytesToCopy), targetOffset);
+        return bytesToCopy;
+    }
+    toBuffer() {
+        if (!this._buffer) {
+            this._buffer = new TextEncoder().encode(this._data);
+        }
+        return this._buffer;
+    }
+}
+class StringBufChunk {
+    constructor(data) {
+        this._data = data;
+    }
+    get length() {
+        return this._data.length;
+    }
+    copy(target, targetOffset, offset, length) {
+        const buf = this.toBuffer();
+        const bytesToCopy = Math.min(length, buf.length - offset);
+        target.set(buf.subarray(offset, offset + bytesToCopy), targetOffset);
+        return bytesToCopy;
+    }
+    toBuffer() {
+        return this._data.toBuffer();
+    }
+}
+class BufferChunk {
+    constructor(data) {
+        this._data = data;
+    }
+    get length() {
+        return this._data.length;
+    }
+    copy(target, targetOffset, offset, length) {
+        const bytesToCopy = Math.min(length, this._data.length - offset);
+        target.set(this._data.subarray(offset, offset + bytesToCopy), targetOffset);
+    }
+    toBuffer() {
+        return this._data;
+    }
+}
+// =============================================================================
+// ReadWriteBuf - a single buffer supporting simple read-write
+class ReadWriteBuf {
+    constructor(size) {
+        this.size = size;
+        this.buffer = new Uint8Array(size);
+        this.iRead = 0;
+        this.iWrite = 0;
+    }
+    toBuffer() {
+        if (this.iRead === 0 && this.iWrite === this.size) {
+            return this.buffer;
+        }
+        return this.buffer.slice(this.iRead, this.iWrite);
+    }
+    get length() {
+        return this.iWrite - this.iRead;
+    }
+    get eod() {
+        return this.iRead === this.iWrite;
+    }
+    get full() {
+        return this.iWrite === this.size;
+    }
+    read(size) {
+        if (size === 0) {
+            return null;
+        }
+        if (size === undefined || size >= this.length) {
+            const buf = this.toBuffer();
+            this.iRead = this.iWrite;
+            return buf;
+        }
+        const buf = this.buffer.slice(this.iRead, this.iRead + size);
+        this.iRead += size;
+        return buf;
+    }
+    write(chunk, offset, length) {
+        const size = Math.min(length, this.size - this.iWrite);
+        chunk.copy(this.buffer, this.iWrite, offset, offset + size);
+        this.iWrite += size;
+        return size;
+    }
+}
+// =============================================================================
+// StreamBuf - Browser version without Node.js stream dependency
+// A simple buffer manager that mimics stream behavior for xlsx writing
+class StreamBuf {
+    constructor(options) {
+        options = options || {};
+        this.bufSize = options.bufSize || 1024 * 1024;
+        this.buffers = [];
+        this.batch = options.batch || false;
+        this.corked = false;
+        this.paused = false;
+        this.encoding = null;
+        this.pipes = [];
+        this.events = new Map();
+    }
+    // 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);
+    }
+    toBuffer() {
+        switch (this.buffers.length) {
+            case 0:
+                return null;
+            case 1:
+                return this.buffers[0].toBuffer();
+            default: {
+                const totalLength = this.buffers.reduce((acc, buf) => acc + buf.length, 0);
+                const result = new Uint8Array(totalLength);
+                let offset = 0;
+                for (const rwBuf of this.buffers) {
+                    const buf = rwBuf.toBuffer();
+                    result.set(buf, offset);
+                    offset += buf.length;
+                }
+                return result;
+            }
+        }
+    }
+    _getWritableBuffer() {
+        if (this.buffers.length) {
+            const last = this.buffers[this.buffers.length - 1];
+            if (!last.full) {
+                return last;
+            }
+        }
+        const buf = new ReadWriteBuf(this.bufSize);
+        this.buffers.push(buf);
+        return buf;
+    }
+    async _pipe(chunk) {
+        const write = (pipe) => {
+            return new Promise(resolve => {
+                pipe.write(chunk.toBuffer(), () => {
+                    resolve();
+                });
+            });
+        };
+        await Promise.all(this.pipes.map(write));
+    }
+    _writeToBuffers(chunk) {
+        let inPos = 0;
+        const inLen = chunk.length;
+        while (inPos < inLen) {
+            const buffer = this._getWritableBuffer();
+            inPos += buffer.write(chunk, inPos, inLen - inPos);
+        }
+    }
+    async write(data, encoding, callback) {
+        const nop = () => { };
+        if (encoding instanceof Function) {
+            callback = encoding;
+            encoding = "utf8";
+        }
+        callback = callback || nop;
+        let chunk;
+        if (data instanceof StringBuf || (data && data.constructor?.name === "StringBuf")) {
+            chunk = new StringBufChunk(data);
+        }
+        else if (data instanceof Uint8Array) {
+            chunk = new BufferChunk(data);
+        }
+        else if (ArrayBuffer.isView(data)) {
+            chunk = new BufferChunk(new Uint8Array(data.buffer, data.byteOffset, data.byteLength));
+        }
+        else if (data instanceof ArrayBuffer) {
+            chunk = new BufferChunk(new Uint8Array(data));
+        }
+        else if (typeof data === "string" || data instanceof String) {
+            chunk = new StringChunk(String(data), encoding);
+        }
+        else {
+            throw new Error("Chunk must be one of type String, Uint8Array, ArrayBuffer or StringBuf.");
+        }
+        if (this.pipes.length) {
+            if (this.batch) {
+                this._writeToBuffers(chunk);
+                while (!this.corked && this.buffers.length > 1) {
+                    await this._pipe(new BufferChunk(this.buffers.shift().toBuffer()));
+                }
+            }
+            else if (!this.corked) {
+                await this._pipe(chunk);
+                callback();
+            }
+            else {
+                this._writeToBuffers(chunk);
+                queueMicrotask(() => callback());
+            }
+        }
+        else {
+            if (!this.paused) {
+                this.emit("data", chunk.toBuffer());
+            }
+            this._writeToBuffers(chunk);
+            this.emit("readable");
+        }
+        return true;
+    }
+    cork() {
+        this.corked = true;
+    }
+    _flush() {
+        if (this.pipes.length) {
+            while (this.buffers.length) {
+                this._pipe(new BufferChunk(this.buffers.shift().toBuffer()));
+            }
+        }
+    }
+    uncork() {
+        this.corked = false;
+        this._flush();
+    }
+    end(chunk, encoding, callback) {
+        const writeComplete = (error) => {
+            if (error) {
+                callback?.(error);
+            }
+            else {
+                this._flush();
+                this.pipes.forEach((pipe) => {
+                    pipe.end();
+                });
+                this.emit("finish");
+            }
+        };
+        if (chunk) {
+            this.write(chunk, encoding, writeComplete);
+        }
+        else {
+            writeComplete();
+        }
+    }
+    read(size) {
+        let buffers;
+        if (size) {
+            buffers = [];
+            while (size && this.buffers.length && !this.buffers[0].eod) {
+                const first = this.buffers[0];
+                const buffer = first.read(size);
+                if (buffer) {
+                    size -= buffer.length;
+                    buffers.push(buffer);
+                }
+                if (first.eod && first.full) {
+                    this.buffers.shift();
+                }
+            }
+            return concatUint8Arrays(buffers);
+        }
+        buffers = this.buffers.map(buf => buf.toBuffer()).filter(Boolean);
+        this.buffers = [];
+        return concatUint8Arrays(buffers);
+    }
+    setEncoding(encoding) {
+        this.encoding = encoding;
+    }
+    pause() {
+        this.paused = true;
+    }
+    resume() {
+        this.paused = false;
+    }
+    isPaused() {
+        return this.paused;
+    }
+    pipe(destination) {
+        this.pipes.push(destination);
+        if (!this.paused && this.buffers.length) {
+            this.end();
+        }
+        return destination;
+    }
+    unpipe(destination) {
+        this.pipes = this.pipes.filter((pipe) => pipe !== destination);
+    }
+    unshift() {
+        throw new Error("Not Implemented");
+    }
+    wrap() {
+        throw new Error("Not Implemented");
+    }
+    push(chunk) {
+        if (chunk !== null) {
+            this.write(chunk);
+        }
+        return true;
+    }
+}
+// Helper function to concatenate Uint8Arrays
+function concatUint8Arrays(arrays) {
+    if (arrays.length === 0) {
+        return new Uint8Array(0);
+    }
+    if (arrays.length === 1) {
+        return arrays[0];
+    }
+    const totalLength = arrays.reduce((acc, arr) => acc + arr.length, 0);
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const arr of arrays) {
+        result.set(arr, offset);
+        offset += arr.length;
+    }
+    return result;
+}
+export { StreamBuf };

package/dist/esm/utils/unzip/zip-parser.js

@@ -427,6 +427,17 @@ export class ZipParser {
         }
         return result;
     }
+    /**
+     * Extract all files (sync, Node.js only)
+     * Returns object with file paths as keys and Uint8Array content as values
+     */
+    extractAllSync() {
+        const result = {};
+        for (const entry of this.entries) {
+            result[entry.path] = extractEntryDataSync(this.data, entry);
+        }
+        return result;
+    }
     /**
      * Iterate over entries with async callback
      */

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
+};