@cj-tech-master/excelts 4.2.1-canary.20260111102127.f808a37 → 4.2.1

package/dist/esm/modules/archive/zip-spec/zip-records.js

@@ -1,126 +0,0 @@
-/**
- * ZIP record builders (PKWARE APPNOTE)
- *
- * Shared by streaming zip writer and buffer zip builder.
- */
-// =============================================================================
-// ZIP format constants (PKWARE APPNOTE)
-// =============================================================================
-// Signatures
-export const LOCAL_FILE_HEADER_SIG = 0x04034b50;
-export const CENTRAL_DIR_HEADER_SIG = 0x02014b50;
-export const END_OF_CENTRAL_DIR_SIG = 0x06054b50;
-export const DATA_DESCRIPTOR_SIG = 0x08074b50;
-export const ZIP64_END_OF_CENTRAL_DIR_SIG = 0x06064b50;
-export const ZIP64_END_OF_CENTRAL_DIR_LOCATOR_SIG = 0x07064b50;
-// Versions
-export const VERSION_NEEDED = 20; // 2.0 - supports DEFLATE
-export const VERSION_MADE_BY = 20; // 2.0
-// Compression methods
-export const COMPRESSION_STORE = 0;
-export const COMPRESSION_DEFLATE = 8;
-// General purpose bit flags
-export const FLAG_UTF8 = 0x0800;
-export const FLAG_DATA_DESCRIPTOR = 0x0008;
-// ZIP64 / sentinel sizes
-export const UINT16_MAX = 0xffff;
-export const UINT32_MAX = 0xffffffff;
-export const ZIP_LOCAL_FILE_HEADER_FIXED_SIZE = 30;
-export const ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE = 46;
-export const ZIP_END_OF_CENTRAL_DIR_FIXED_SIZE = 22;
-export function writeLocalFileHeaderInto(out, view, offset, input) {
-    const versionNeeded = input.versionNeeded ?? VERSION_NEEDED;
-    view.setUint32(offset + 0, LOCAL_FILE_HEADER_SIG, true);
-    view.setUint16(offset + 4, versionNeeded, true);
-    view.setUint16(offset + 6, input.flags, true);
-    view.setUint16(offset + 8, input.compressionMethod, true);
-    view.setUint16(offset + 10, input.dosTime, true);
-    view.setUint16(offset + 12, input.dosDate, true);
-    view.setUint32(offset + 14, input.crc32, true);
-    view.setUint32(offset + 18, input.compressedSize, true);
-    view.setUint32(offset + 22, input.uncompressedSize, true);
-    view.setUint16(offset + 26, input.fileName.length, true);
-    view.setUint16(offset + 28, input.extraField.length, true);
-    out.set(input.fileName, offset + ZIP_LOCAL_FILE_HEADER_FIXED_SIZE);
-    if (input.extraField.length > 0) {
-        out.set(input.extraField, offset + ZIP_LOCAL_FILE_HEADER_FIXED_SIZE + input.fileName.length);
-    }
-    return ZIP_LOCAL_FILE_HEADER_FIXED_SIZE + input.fileName.length + input.extraField.length;
-}
-export function buildLocalFileHeader(input) {
-    const header = new Uint8Array(ZIP_LOCAL_FILE_HEADER_FIXED_SIZE + input.fileName.length + input.extraField.length);
-    const view = new DataView(header.buffer, header.byteOffset, header.byteLength);
-    writeLocalFileHeaderInto(header, view, 0, input);
-    return header;
-}
-export function writeCentralDirectoryHeaderInto(out, view, offset, input) {
-    const versionMadeBy = input.versionMadeBy ?? VERSION_MADE_BY;
-    const versionNeeded = input.versionNeeded ?? VERSION_NEEDED;
-    const externalAttributes = input.externalAttributes ?? 0;
-    view.setUint32(offset + 0, CENTRAL_DIR_HEADER_SIG, true);
-    view.setUint16(offset + 4, versionMadeBy, true);
-    view.setUint16(offset + 6, versionNeeded, true);
-    view.setUint16(offset + 8, input.flags, true);
-    view.setUint16(offset + 10, input.compressionMethod, true);
-    view.setUint16(offset + 12, input.dosTime, true);
-    view.setUint16(offset + 14, input.dosDate, true);
-    view.setUint32(offset + 16, input.crc32, true);
-    view.setUint32(offset + 20, input.compressedSize, true);
-    view.setUint32(offset + 24, input.uncompressedSize, true);
-    view.setUint16(offset + 28, input.fileName.length, true);
-    view.setUint16(offset + 30, input.extraField.length, true);
-    view.setUint16(offset + 32, input.comment.length, true);
-    view.setUint16(offset + 34, 0, true); // disk number start
-    view.setUint16(offset + 36, 0, true); // internal file attributes
-    view.setUint32(offset + 38, externalAttributes, true);
-    view.setUint32(offset + 42, input.localHeaderOffset, true);
-    out.set(input.fileName, offset + ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE);
-    if (input.extraField.length > 0) {
-        out.set(input.extraField, offset + ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE + input.fileName.length);
-    }
-    if (input.comment.length > 0) {
-        out.set(input.comment, offset + ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE + input.fileName.length + input.extraField.length);
-    }
-    return (ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE +
-        input.fileName.length +
-        input.extraField.length +
-        input.comment.length);
-}
-export function buildCentralDirectoryHeader(input) {
-    const header = new Uint8Array(ZIP_CENTRAL_DIR_HEADER_FIXED_SIZE +
-        input.fileName.length +
-        input.extraField.length +
-        input.comment.length);
-    const view = new DataView(header.buffer, header.byteOffset, header.byteLength);
-    writeCentralDirectoryHeaderInto(header, view, 0, input);
-    return header;
-}
-export function writeEndOfCentralDirectoryInto(out, view, offset, input) {
-    view.setUint32(offset + 0, END_OF_CENTRAL_DIR_SIG, true);
-    view.setUint16(offset + 4, 0, true);
-    view.setUint16(offset + 6, 0, true);
-    view.setUint16(offset + 8, input.entryCount, true);
-    view.setUint16(offset + 10, input.entryCount, true);
-    view.setUint32(offset + 12, input.centralDirSize, true);
-    view.setUint32(offset + 16, input.centralDirOffset, true);
-    view.setUint16(offset + 20, input.comment.length, true);
-    if (input.comment.length > 0) {
-        out.set(input.comment, offset + ZIP_END_OF_CENTRAL_DIR_FIXED_SIZE);
-    }
-    return ZIP_END_OF_CENTRAL_DIR_FIXED_SIZE + input.comment.length;
-}
-export function buildEndOfCentralDirectory(input) {
-    const record = new Uint8Array(ZIP_END_OF_CENTRAL_DIR_FIXED_SIZE + input.comment.length);
-    const view = new DataView(record.buffer, record.byteOffset, record.byteLength);
-    writeEndOfCentralDirectoryInto(record, view, 0, input);
-    return record;
-}
-export function buildDataDescriptor(crc32, compressedSize, uncompressedSize) {
-    const descriptor = new Uint8Array(16);
-    const view = new DataView(descriptor.buffer);
-    view.setUint32(0, DATA_DESCRIPTOR_SIG, true);
-    view.setUint32(4, crc32, true);
-    view.setUint32(8, compressedSize, true);
-    view.setUint32(12, uncompressedSize, true);
-    return descriptor;
-}

package/dist/types/modules/archive/internal/byte-queue.d.ts

@@ -1,33 +0,0 @@
-export declare class ByteQueue {
-    private static readonly EMPTY;
-    private _chunks;
-    private _headOffset;
-    private _length;
-    private _cachedView;
-    private _cachedLength;
-    constructor(initial?: Uint8Array);
-    get length(): number;
-    isEmpty(): boolean;
-    view(): Uint8Array;
-    reset(data?: Uint8Array): void;
-    append(chunk: Uint8Array): void;
-    read(length: number): Uint8Array;
-    /**
-     * Return a list of chunk views totaling `length` bytes without consuming.
-     *
-     * This avoids materializing a contiguous buffer for streaming write paths.
-     */
-    peekChunks(length: number): Uint8Array[];
-    discard(length: number): void;
-    /**
-     * 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: Uint8Array, startIndex?: number): number;
-    /** Peek a little-endian uint32 at `offset` without consuming bytes. Returns null if not enough bytes. */
-    peekUint32LE(offset: number): number | null;
-    /** Peek a single byte at `offset` without consuming bytes. */
-    peekByte(offset: number): number;
-}

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

@@ -1,9 +0,0 @@
-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 isWritableStream(value: unknown): value is WritableStream<Uint8Array>;
-export declare function pipeIterableToSink(iterable: AsyncIterable<Uint8Array>, sink: ArchiveSink): Promise<void>;
-export declare function collect(iterable: AsyncIterable<Uint8Array>): Promise<Uint8Array>;

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

@@ -1,8 +0,0 @@
-export type ArchiveSource = Uint8Array | ArrayBuffer | string | Blob | AsyncIterable<unknown> | ReadableStream<unknown> | {
-    [Symbol.asyncIterator](): AsyncIterator<unknown>;
-};
-export declare function isReadableStream(value: unknown): value is ReadableStream<unknown>;
-export declare function isAsyncIterable(value: unknown): value is AsyncIterable<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/types/modules/archive/unzip/index.d.ts

@@ -1,40 +0,0 @@
-import { ZipParser, type ZipEntryInfo } from "./zip-parser.js";
-import { type ParseOptions, type ZipEntry as ParseZipEntry } from "./stream.js";
-import { type ArchiveSink } from "../io/archive-sink.js";
-import { type ArchiveSource } from "../io/archive-source.js";
-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;

package/dist/types/modules/archive/utils/async-queue.d.ts

@@ -1,7 +0,0 @@
-export type AsyncQueue<T> = {
-    push: (value: T) => void;
-    fail: (err: Error) => void;
-    close: () => void;
-    iterable: AsyncIterable<T>;
-};
-export declare function createAsyncQueue<T>(): AsyncQueue<T>;

package/dist/types/modules/archive/utils/compressibility.d.ts

@@ -1,10 +0,0 @@
-/**
- * Heuristic: detect incompressible (high-entropy) data.
- *
- * This is a performance optimization: if data looks random, DEFLATE usually
- * wastes CPU and may even produce slightly larger output.
- */
-export declare function isProbablyIncompressible(data: Uint8Array, options?: {
-    sampleBytes?: number;
-    minDecisionBytes?: number;
-}): boolean;

package/dist/types/modules/archive/utils/pattern-scanner.d.ts

@@ -1,21 +0,0 @@
-export interface PatternSearchTarget {
-    indexOfPattern(pattern: Uint8Array, startIndex: number): number;
-}
-/**
- * Stateful helper for incremental pattern scanning in growing buffers.
- *
- * The scanner tracks a `searchFrom` cursor and an `overlap` region so callers
- * can avoid rescanning bytes that cannot start a match.
- */
-export declare class PatternScanner {
-    readonly pattern: Uint8Array;
-    readonly overlap: number;
-    searchFrom: number;
-    constructor(pattern: Uint8Array);
-    /** Find the next match index starting at the current `searchFrom`. */
-    find(target: PatternSearchTarget): number;
-    /** Update `searchFrom` after consuming `consumed` bytes from the front. */
-    onConsume(consumed: number): void;
-    /** Update `searchFrom` after a no-match scan on a buffer of length `bufferLength`. */
-    onNoMatch(bufferLength: number): void;
-}

package/dist/types/modules/archive/zip/index.d.ts

@@ -1,42 +0,0 @@
-import type { ZipTimestampMode } from "../utils/timestamps.js";
-import { type ArchiveSink } from "../io/archive-sink.js";
-import { type ArchiveSource } from "../io/archive-source.js";
-export interface ZipOptions {
-    level?: number;
-    timestamps?: ZipTimestampMode;
-    comment?: string;
-    /**
-     * Default modification time for entries that don't specify `modTime`.
-     *
-     * If you need stable output across runs, either pass this explicitly or use `reproducible: true`.
-     */
-    modTime?: Date;
-    /**
-     * If true, bias defaults toward reproducible output:
-     * - default `modTime` becomes 1980-01-01 00:00:00 (local time)
-     * - default `timestamps` becomes "dos" (no UTC extra field)
-     */
-    reproducible?: boolean;
-    /**
-     * If true (default), automatically STORE incompressible data.
-     * If false, always follow `level` (DEFLATE when level > 0).
-     */
-    smartStore?: boolean;
-}
-export interface ZipEntryOptions {
-    level?: number;
-    modTime?: Date;
-    comment?: string;
-}
-export declare class ZipArchive {
-    private readonly _options;
-    private readonly _entries;
-    private _sealed;
-    constructor(options?: ZipOptions);
-    add(name: string, source: ArchiveSource, options?: ZipEntryOptions): this;
-    stream(): AsyncIterable<Uint8Array>;
-    bytes(): Promise<Uint8Array>;
-    bytesSync(): Uint8Array;
-    pipeTo(sink: ArchiveSink): Promise<void>;
-}
-export declare function zip(options?: ZipOptions): ZipArchive;

package/dist/types/modules/archive/zip/zip-bytes.d.ts

@@ -1,73 +0,0 @@
-/**
- * ZIP file format encoder (single-buffer output)
- *
- * Implements ZIP file structure according to PKWARE's APPNOTE.TXT specification
- * https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT
- *
- * This module focuses on producing a complete ZIP as a single Uint8Array.
- * For true streaming (push chunks while reading sources), use `zip()` / `ZipArchive.stream()`.
- */
-import { type CompressOptions } from "../compression/compress.js";
-import { type ZipTimestampMode } from "../utils/timestamps.js";
-/**
- * ZIP file entry
- */
-export interface ZipEntry {
-    /** File name (can include directory path, use forward slashes) */
-    name: string;
-    /** File data (will be compressed unless level=0) */
-    data: Uint8Array;
-    /** Optional per-entry compression level override */
-    level?: number;
-    /** File modification time (optional, defaults to current time) */
-    modTime?: Date;
-    /** File comment (optional) */
-    comment?: string;
-}
-/**
- * ZIP encoder options
- */
-export interface ZipOptions extends CompressOptions {
-    /** ZIP file comment (optional) */
-    comment?: string;
-    /**
-     * Default modification time for entries that don't specify `modTime`.
-     *
-     * If you need stable output across runs, either pass this explicitly or use `reproducible: true`.
-     */
-    modTime?: Date;
-    /**
-     * If true, bias defaults toward reproducible output:
-     * - default `modTime` becomes 1980-01-01 00:00:00 (local time)
-     * - default `timestamps` becomes "dos" (no UTC extra field)
-     */
-    reproducible?: boolean;
-    /**
-     * Max number of entries to compress concurrently in `createZip()`.
-     * This helps avoid zlib threadpool saturation / memory spikes with many files.
-     *
-     * Defaults to 4.
-     */
-    concurrency?: number;
-    /**
-     * If true (default), automatically STORE incompressible data.
-     * If false, always follow `level` (DEFLATE when level > 0).
-     */
-    smartStore?: boolean;
-    /**
-     * Timestamp writing strategy.
-     * - "dos": only write DOS date/time fields (smallest output)
-     * - "dos+utc": also write UTC mtime in 0x5455 extra field
-     */
-    timestamps?: ZipTimestampMode;
-}
-/**
- * Create a ZIP file from entries (async)
- */
-export declare function createZip(entries: ZipEntry[], options?: ZipOptions): Promise<Uint8Array>;
-/**
- * Create a ZIP file from entries (sync)
- *
- * This is supported in both Node.js and browser builds.
- */
-export declare function createZipSync(entries: ZipEntry[], options?: ZipOptions): Uint8Array;