@cj-tech-master/excelts 4.2.1 → 4.2.2

package/dist/browser/modules/archive/internal/byte-queue.js

@@ -0,0 +1,407 @@
+import { indexOfUint8ArrayPattern } from "../utils/bytes.js";
+export class ByteQueue {
+    constructor(initial) {
+        // Store data as immutable chunks to avoid copying on append.
+        this._chunks = [];
+        this._headOffset = 0;
+        this._length = 0;
+        // Lazily materialized contiguous view (used only by callers that require a single buffer).
+        this._cachedView = null;
+        this._cachedLength = 0;
+        if (initial && initial.length > 0) {
+            this.reset(initial);
+        }
+    }
+    get length() {
+        return this._length;
+    }
+    isEmpty() {
+        return this.length === 0;
+    }
+    view() {
+        if (this._length === 0) {
+            return ByteQueue.EMPTY;
+        }
+        // Fast path: single chunk.
+        if (this._chunks.length === 1) {
+            const c = this._chunks[0];
+            return c.subarray(this._headOffset, this._headOffset + this._length);
+        }
+        if (this._cachedView && this._cachedLength === this._length) {
+            return this._cachedView;
+        }
+        const out = new Uint8Array(this._length);
+        let offset = 0;
+        for (let i = 0; i < this._chunks.length; i++) {
+            const c = this._chunks[i];
+            const start = i === 0 ? this._headOffset : 0;
+            const end = i === this._chunks.length - 1 ? start + (this._length - offset) : c.length;
+            out.set(c.subarray(start, end), offset);
+            offset += end - start;
+            if (offset >= out.length) {
+                break;
+            }
+        }
+        this._cachedView = out;
+        this._cachedLength = this._length;
+        return out;
+    }
+    reset(data) {
+        this._cachedView = null;
+        this._cachedLength = 0;
+        this._chunks = [];
+        this._headOffset = 0;
+        this._length = 0;
+        if (!data || data.length === 0) {
+            return;
+        }
+        // Keep a private copy to ensure future writes cannot mutate the source.
+        const copy = new Uint8Array(data.length);
+        copy.set(data);
+        this._chunks = [copy];
+        this._headOffset = 0;
+        this._length = copy.length;
+    }
+    append(chunk) {
+        if (chunk.length === 0) {
+            return;
+        }
+        this._cachedView = null;
+        this._cachedLength = 0;
+        this._chunks.push(chunk);
+        this._length += chunk.length;
+    }
+    read(length) {
+        if (length <= 0) {
+            return new Uint8Array(0);
+        }
+        if (length > this._length) {
+            throw new RangeError("ByteQueue: read beyond available data");
+        }
+        this._cachedView = null;
+        this._cachedLength = 0;
+        if (this._chunks.length === 1) {
+            const c = this._chunks[0];
+            const start = this._headOffset;
+            const end = start + length;
+            const out = c.subarray(start, end);
+            this._headOffset = end;
+            this._length -= length;
+            if (this._length === 0) {
+                this._chunks = [];
+                this._headOffset = 0;
+            }
+            else if (this._headOffset >= c.length) {
+                this._chunks.shift();
+                this._headOffset = 0;
+            }
+            return out;
+        }
+        // Slow path: spans multiple chunks, copy into a single output buffer.
+        const out = new Uint8Array(length);
+        let outOffset = 0;
+        let remaining = length;
+        while (remaining > 0) {
+            const c = this._chunks[0];
+            const start = this._headOffset;
+            const available = c.length - start;
+            const toCopy = Math.min(available, remaining);
+            out.set(c.subarray(start, start + toCopy), outOffset);
+            outOffset += toCopy;
+            remaining -= toCopy;
+            this._headOffset += toCopy;
+            this._length -= toCopy;
+            if (this._headOffset >= c.length) {
+                this._chunks.shift();
+                this._headOffset = 0;
+            }
+        }
+        if (this._length === 0) {
+            this._chunks = [];
+            this._headOffset = 0;
+        }
+        return out;
+    }
+    /**
+     * Return a list of chunk views totaling `length` bytes without consuming.
+     *
+     * This avoids materializing a contiguous buffer for streaming write paths.
+     */
+    peekChunks(length) {
+        if (length <= 0) {
+            return [];
+        }
+        if (length > this._length) {
+            throw new RangeError("ByteQueue: peek beyond available data");
+        }
+        // Fast path: single chunk.
+        if (this._chunks.length === 1) {
+            const c = this._chunks[0];
+            const start = this._headOffset;
+            return [c.subarray(start, start + length)];
+        }
+        const parts = [];
+        let remaining = length;
+        for (let i = 0; i < this._chunks.length && remaining > 0; i++) {
+            const c = this._chunks[i];
+            const start = i === 0 ? this._headOffset : 0;
+            const avail = c.length - start;
+            if (avail <= 0) {
+                continue;
+            }
+            const toTake = Math.min(avail, remaining);
+            parts.push(c.subarray(start, start + toTake));
+            remaining -= toTake;
+        }
+        return parts;
+    }
+    discard(length) {
+        if (length <= 0) {
+            return;
+        }
+        if (length >= this._length) {
+            this._chunks = [];
+            this._headOffset = 0;
+            this._length = 0;
+            this._cachedView = null;
+            this._cachedLength = 0;
+            return;
+        }
+        this._cachedView = null;
+        this._cachedLength = 0;
+        let remaining = length;
+        while (remaining > 0) {
+            const c = this._chunks[0];
+            const start = this._headOffset;
+            const available = c.length - start;
+            const toDrop = Math.min(available, remaining);
+            this._headOffset += toDrop;
+            this._length -= toDrop;
+            remaining -= toDrop;
+            if (this._headOffset >= c.length) {
+                this._chunks.shift();
+                this._headOffset = 0;
+            }
+        }
+        if (this._length === 0) {
+            this._chunks = [];
+            this._headOffset = 0;
+        }
+    }
+    /**
+     * Find the first index of `pattern` within the queue.
+     *
+     * This avoids materializing a contiguous `view()` for common small patterns
+     * (ZIP signatures are typically 2-4 bytes).
+     */
+    indexOfPattern(pattern, startIndex = 0) {
+        const patLen = pattern.length;
+        if (patLen === 0) {
+            return 0;
+        }
+        const len = this._length;
+        if (patLen > len) {
+            return -1;
+        }
+        let start = startIndex | 0;
+        if (start < 0) {
+            start = 0;
+        }
+        if (start > len - patLen) {
+            return -1;
+        }
+        // Fast path: single chunk.
+        if (this._chunks.length === 1) {
+            const c = this._chunks[0];
+            const base = this._headOffset;
+            const view = c.subarray(base, base + len);
+            // Delegate to native indexOf checks for 1..4 bytes.
+            if (patLen === 1) {
+                return view.indexOf(pattern[0], start);
+            }
+            return indexOfUint8ArrayPattern(view, pattern, start);
+        }
+        // Multi-chunk: optimize only for very common small patterns.
+        if (patLen > 4) {
+            // Rare: materialize view.
+            const v = this.view();
+            return indexOfUint8ArrayPattern(v, pattern, start);
+        }
+        const b0 = pattern[0];
+        const b1 = patLen >= 2 ? pattern[1] : 0;
+        const b2 = patLen >= 3 ? pattern[2] : 0;
+        const b3 = patLen >= 4 ? pattern[3] : 0;
+        const chunks = this._chunks;
+        const peekByteAcrossChunks = (chunkIndex, absoluteIndex) => {
+            let ci = chunkIndex;
+            let idx = absoluteIndex;
+            while (ci < chunks.length) {
+                const c = chunks[ci];
+                if (idx < c.length) {
+                    return c[idx] | 0;
+                }
+                idx -= c.length;
+                ci++;
+            }
+            return null;
+        };
+        let globalBase = 0;
+        for (let ci = 0; ci < chunks.length; ci++) {
+            const c = chunks[ci];
+            const chunkOffset = ci === 0 ? this._headOffset : 0;
+            const chunkLen = c.length - chunkOffset;
+            if (chunkLen <= 0) {
+                continue;
+            }
+            const chunkStartGlobal = globalBase;
+            const chunkEndGlobal = chunkStartGlobal + chunkLen;
+            // Compute local start for this chunk.
+            const localStart = start <= chunkStartGlobal
+                ? chunkOffset
+                : start >= chunkEndGlobal
+                    ? c.length
+                    : chunkOffset + (start - chunkStartGlobal);
+            if (localStart > c.length - 1) {
+                globalBase += chunkLen;
+                continue;
+            }
+            const lastLocal = c.length - 1;
+            let i = c.indexOf(b0, localStart);
+            while (i !== -1 && i <= lastLocal) {
+                const globalPos = chunkStartGlobal + (i - chunkOffset);
+                if (globalPos > len - patLen) {
+                    return -1;
+                }
+                if (patLen === 1) {
+                    return globalPos;
+                }
+                // Fast path: match stays fully inside the current chunk.
+                // Avoid calling peekByte() which walks the chunk list per byte.
+                const staysInChunk = i + patLen <= c.length;
+                if (staysInChunk) {
+                    if (c[i + 1] !== b1) {
+                        i = c.indexOf(b0, i + 1);
+                        continue;
+                    }
+                    if (patLen === 2) {
+                        return globalPos;
+                    }
+                    if (c[i + 2] !== b2) {
+                        i = c.indexOf(b0, i + 1);
+                        continue;
+                    }
+                    if (patLen === 3) {
+                        return globalPos;
+                    }
+                    if (c[i + 3] !== b3) {
+                        i = c.indexOf(b0, i + 1);
+                        continue;
+                    }
+                    return globalPos;
+                }
+                // Slow path: pattern spans chunks.
+                const b1v = peekByteAcrossChunks(ci, i + 1);
+                if (b1v === null || b1v !== b1) {
+                    i = c.indexOf(b0, i + 1);
+                    continue;
+                }
+                if (patLen === 2) {
+                    return globalPos;
+                }
+                const b2v = peekByteAcrossChunks(ci, i + 2);
+                if (b2v === null || b2v !== b2) {
+                    i = c.indexOf(b0, i + 1);
+                    continue;
+                }
+                if (patLen === 3) {
+                    return globalPos;
+                }
+                const b3v = peekByteAcrossChunks(ci, i + 3);
+                if (b3v === null || b3v !== b3) {
+                    i = c.indexOf(b0, i + 1);
+                    continue;
+                }
+                return globalPos;
+            }
+            globalBase += chunkLen;
+        }
+        return -1;
+    }
+    /** Peek a little-endian uint32 at `offset` without consuming bytes. Returns null if not enough bytes. */
+    peekUint32LE(offset) {
+        const off = offset | 0;
+        if (off < 0 || off + 4 > this._length) {
+            return null;
+        }
+        // Try to read contiguously from a single chunk to avoid 4x chunk-walk.
+        const chunks = this._chunks;
+        let remaining = off;
+        for (let i = 0; i < chunks.length; i++) {
+            const c = chunks[i];
+            const start = i === 0 ? this._headOffset : 0;
+            const avail = c.length - start;
+            if (remaining < avail) {
+                const idx = start + remaining;
+                if (idx + 4 <= c.length) {
+                    const b0 = c[idx] | 0;
+                    const b1 = c[idx + 1] | 0;
+                    const b2 = c[idx + 2] | 0;
+                    const b3 = c[idx + 3] | 0;
+                    return (b0 | (b1 << 8) | (b2 << 16) | (b3 << 24)) >>> 0;
+                }
+                // Cross-chunk read (rare): walk forward across chunks once.
+                const b0 = c[idx] | 0;
+                let b1 = 0;
+                let b2 = 0;
+                let b3 = 0;
+                let ci = i;
+                let pos = idx + 1;
+                for (let k = 1; k < 4; k++) {
+                    while (ci < chunks.length) {
+                        const cc = chunks[ci];
+                        if (pos < cc.length) {
+                            const v = cc[pos] | 0;
+                            if (k === 1) {
+                                b1 = v;
+                            }
+                            else if (k === 2) {
+                                b2 = v;
+                            }
+                            else {
+                                b3 = v;
+                            }
+                            pos++;
+                            break;
+                        }
+                        ci++;
+                        pos = 0;
+                    }
+                }
+                return (b0 | (b1 << 8) | (b2 << 16) | (b3 << 24)) >>> 0;
+            }
+            remaining -= avail;
+        }
+        // Should be unreachable due to bounds check above.
+        return null;
+    }
+    /** Peek a single byte at `offset` without consuming bytes. */
+    peekByte(offset) {
+        const off = offset | 0;
+        if (off < 0 || off >= this._length) {
+            throw new RangeError("ByteQueue: peek beyond available data");
+        }
+        let remaining = off;
+        for (let i = 0; i < this._chunks.length; i++) {
+            const c = this._chunks[i];
+            const start = i === 0 ? this._headOffset : 0;
+            const avail = c.length - start;
+            if (remaining < avail) {
+                return c[start + remaining] | 0;
+            }
+            remaining -= avail;
+        }
+        // Should be unreachable.
+        throw new RangeError("ByteQueue: peek beyond available data");
+    }
+}
+ByteQueue.EMPTY = new Uint8Array(0);

package/dist/browser/modules/archive/io/archive-sink.d.ts

@@ -0,0 +1,8 @@
+export type ArchiveSink = WritableStream<Uint8Array> | {
+    write(chunk: Uint8Array): any;
+    end?(cb?: any): any;
+    on?(event: string, listener: (...args: any[]) => void): any;
+    once?(event: string, listener: (...args: any[]) => void): any;
+};
+export declare function pipeIterableToSink(iterable: AsyncIterable<Uint8Array>, sink: ArchiveSink): Promise<void>;
+export declare function collect(iterable: AsyncIterable<Uint8Array>): Promise<Uint8Array>;

package/dist/browser/modules/archive/io/archive-sink.js

@@ -0,0 +1,45 @@
+import { concatUint8Arrays } from "../../stream/shared.js";
+import { onceEvent } from "../../stream/internal/event-utils.js";
+import { isWritableStream } from "../../stream/internal/type-guards.js";
+export async function pipeIterableToSink(iterable, sink) {
+    if (isWritableStream(sink)) {
+        const writer = sink.getWriter();
+        try {
+            for await (const chunk of iterable) {
+                await writer.write(chunk);
+            }
+            await writer.close();
+        }
+        finally {
+            try {
+                writer.releaseLock();
+            }
+            catch {
+                // Ignore
+            }
+        }
+        return;
+    }
+    // Node-style Writable
+    for await (const chunk of iterable) {
+        const ok = sink.write(chunk);
+        if (ok === false && typeof sink.once === "function") {
+            await onceEvent(sink, "drain");
+        }
+    }
+    if (typeof sink.end === "function") {
+        sink.end();
+    }
+    if (typeof sink.once === "function") {
+        await Promise.race([onceEvent(sink, "finish"), onceEvent(sink, "close")]);
+    }
+}
+export async function collect(iterable) {
+    const chunks = [];
+    let total = 0;
+    for await (const chunk of iterable) {
+        chunks.push(chunk);
+        total += chunk.length;
+    }
+    return concatUint8Arrays(chunks, total);
+}

package/dist/browser/modules/archive/io/archive-source.d.ts

@@ -0,0 +1,6 @@
+export type ArchiveSource = Uint8Array | ArrayBuffer | string | Blob | AsyncIterable<unknown> | ReadableStream<unknown> | {
+    [Symbol.asyncIterator](): AsyncIterator<unknown>;
+};
+export declare function toUint8ArraySync(source: Uint8Array | ArrayBuffer | string): Uint8Array;
+export declare function toUint8Array(source: Uint8Array | ArrayBuffer | string | Blob): Promise<Uint8Array>;
+export declare function toAsyncIterable(source: ArchiveSource): AsyncIterable<Uint8Array>;

package/dist/browser/modules/archive/io/archive-source.js

@@ -0,0 +1,100 @@
+import { encodeUtf8 } from "../utils/text.js";
+import { isAsyncIterable, isReadableStream } from "../../stream/internal/type-guards.js";
+function normalizeChunk(value) {
+    if (!value) {
+        return null;
+    }
+    if (value instanceof Uint8Array) {
+        return value.length ? value : null;
+    }
+    if (typeof value === "string") {
+        const bytes = encodeUtf8(value);
+        return bytes.length ? bytes : null;
+    }
+    if (value instanceof ArrayBuffer) {
+        return value.byteLength ? new Uint8Array(value) : null;
+    }
+    if (ArrayBuffer.isView(value)) {
+        return value.byteLength
+            ? new Uint8Array(value.buffer, value.byteOffset, value.byteLength)
+            : null;
+    }
+    // Best-effort: treat unknown chunk as Uint8Array-like.
+    if (typeof value.length === "number" && value.length) {
+        return value;
+    }
+    return null;
+}
+export function toUint8ArraySync(source) {
+    if (source instanceof Uint8Array) {
+        return source;
+    }
+    if (typeof source === "string") {
+        return encodeUtf8(source);
+    }
+    return new Uint8Array(source);
+}
+export async function toUint8Array(source) {
+    if (source instanceof Uint8Array) {
+        return source;
+    }
+    if (typeof source === "string") {
+        return encodeUtf8(source);
+    }
+    if (source instanceof ArrayBuffer) {
+        return new Uint8Array(source);
+    }
+    const buf = await source.arrayBuffer();
+    return new Uint8Array(buf);
+}
+export async function* toAsyncIterable(source) {
+    if (source instanceof Uint8Array) {
+        yield source;
+        return;
+    }
+    if (typeof source === "string") {
+        yield encodeUtf8(source);
+        return;
+    }
+    if (source instanceof ArrayBuffer) {
+        yield new Uint8Array(source);
+        return;
+    }
+    if (typeof Blob !== "undefined" && source instanceof Blob) {
+        yield await toUint8Array(source);
+        return;
+    }
+    if (isReadableStream(source)) {
+        const reader = source.getReader();
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    return;
+                }
+                const chunk = normalizeChunk(value);
+                if (chunk) {
+                    yield chunk;
+                }
+            }
+        }
+        finally {
+            try {
+                reader.releaseLock();
+            }
+            catch {
+                // Ignore
+            }
+        }
+    }
+    if (isAsyncIterable(source)) {
+        for await (const value of source) {
+            const chunk = normalizeChunk(value);
+            if (chunk) {
+                yield chunk;
+            }
+        }
+        return;
+    }
+    throw new Error("Unsupported archive source");
+}

package/dist/browser/modules/archive/{extract.d.ts → unzip/extract.d.ts}

@@ -3,7 +3,7 @@
  * Provides easy-to-use Promise-based API for extracting ZIP files
  * Works in both Node.js and browser environments
  */
-import { type ZipEntryInfo } from "@archive/zip-parser";
+import { type ZipEntryInfo } from "@archive/unzip/zip-parser";
 /**
  * Extracted file entry
  */
@@ -91,4 +91,4 @@ export declare function listFiles(zipData: Uint8Array | ArrayBuffer): Promise<st
  * ```
  */
 export declare function forEachEntry(zipData: Uint8Array | ArrayBuffer, callback: (path: string, getData: () => Promise<Uint8Array>, entry: ZipEntryInfo) => Promise<boolean | void>): Promise<void>;
-export { ZipParser, type ZipEntryInfo, type ZipParseOptions } from "@archive/zip-parser";
+export { ZipParser, type ZipEntryInfo, type ZipParseOptions } from "@archive/unzip/zip-parser";

package/dist/browser/modules/archive/unzip/index.d.ts

@@ -0,0 +1,40 @@
+import { ZipParser, type ZipEntryInfo } from "@archive/unzip/zip-parser";
+import { type ParseOptions, type ZipEntry as ParseZipEntry } from "@archive/unzip/stream";
+import { type ArchiveSink } from "@archive/io/archive-sink";
+import { type ArchiveSource } from "@archive/io/archive-source";
+export interface UnzipOptions {
+    decodeStrings?: boolean;
+    parse?: ParseOptions;
+}
+export declare class UnzipEntry {
+    readonly path: string;
+    readonly isDirectory: boolean;
+    private readonly _info?;
+    private readonly _parser?;
+    private readonly _parseEntry?;
+    constructor(args: {
+        kind: "buffer";
+        parser: ZipParser;
+        info: ZipEntryInfo;
+    } | {
+        kind: "stream";
+        entry: ParseZipEntry;
+    });
+    bytes(): Promise<Uint8Array>;
+    stream(): AsyncIterable<Uint8Array>;
+    pipeTo(sink: ArchiveSink): Promise<void>;
+    text(encoding?: string): Promise<string>;
+    discard(): void;
+}
+export declare class ZipReader {
+    private readonly _source;
+    private readonly _options;
+    private _bufferParser;
+    constructor(source: ArchiveSource, options?: UnzipOptions);
+    private _ensureBufferParser;
+    get(path: string): Promise<UnzipEntry | null>;
+    entries(): AsyncIterable<UnzipEntry>;
+    bytes(path: string): Promise<Uint8Array | null>;
+    close(): Promise<void>;
+}
+export declare function unzip(source: ArchiveSource, options?: UnzipOptions): ZipReader;