@cj-tech-master/excelts 3.1.0 → 4.0.0-canary.20260103013222.0e5d37f

package/dist/types/index.browser.d.ts

@@ -2,18 +2,24 @@
  * Browser entry point - No Node.js dependencies
  * This version is optimized for browser environments with minimal bundle size
  */
-export { Workbook } from "./doc/workbook.browser";
-export { Worksheet } from "./doc/worksheet";
-export { Row } from "./doc/row";
-export { Column } from "./doc/column";
-export { Cell } from "./doc/cell";
-export { Range } from "./doc/range";
-export { Image } from "./doc/image";
-export * from "./doc/anchor";
-export { Table } from "./doc/table";
-export { DataValidations } from "./doc/data-validations";
-export * from "./doc/enums";
-export * from "./types";
-export type { PivotTable, PivotTableModel, PivotTableSource, CacheField, DataField, PivotTableSubtotal, ParsedCacheDefinition, ParsedCacheRecords } from "./doc/pivot-table";
-export * from "./utils/sheet-utils";
-export type { CsvReadOptions, CsvWriteOptions } from "./csv/csv";
+export { Workbook } from "./modules/excel/workbook";
+export { Worksheet } from "./modules/excel/worksheet";
+export { Row } from "./modules/excel/row";
+export { Column } from "./modules/excel/column";
+export { Cell } from "./modules/excel/cell";
+export { Range } from "./modules/excel/range";
+export { Image } from "./modules/excel/image";
+export * from "./modules/excel/anchor";
+export { Table } from "./modules/excel/table";
+export { DataValidations } from "./modules/excel/data-validations";
+export * from "./modules/excel/enums";
+export * from "./modules/excel/types";
+export type { PivotTable, PivotTableModel, PivotTableSource, CacheField, DataField, PivotTableSubtotal, ParsedCacheDefinition, ParsedCacheRecords } from "./modules/excel/pivot-table";
+import { WorkbookWriter } from "./modules/excel/stream/workbook-writer.browser";
+import { WorkbookReader } from "./modules/excel/stream/workbook-reader.browser";
+import { WorksheetWriter } from "./modules/excel/stream/worksheet-writer";
+import { WorksheetReader } from "./modules/excel/stream/worksheet-reader";
+export { WorkbookWriter, WorkbookReader, WorksheetWriter, WorksheetReader };
+export type { CsvReadOptions, CsvWriteOptions, CsvStreamReadOptions, CsvStreamWriteOptions } from "./modules/csv/csv.browser";
+export { CsvParserStream, CsvFormatterStream } from "./modules/csv/csv.browser";
+export * from "./modules/excel/utils/sheet-utils";

package/dist/types/index.d.ts

@@ -1,24 +1,23 @@
-export { Workbook } from "./doc/workbook";
-export { Worksheet } from "./doc/worksheet";
-export { Row } from "./doc/row";
-export { Column } from "./doc/column";
-export { Cell } from "./doc/cell";
-export { Range } from "./doc/range";
-export { Image } from "./doc/image";
-export * from "./doc/anchor";
-export { Table } from "./doc/table";
-export { DataValidations } from "./doc/data-validations";
-export { WorkbookWriter } from "./stream/xlsx/workbook-writer";
-export { WorkbookReader } from "./stream/xlsx/workbook-reader";
-export { WorksheetWriter } from "./stream/xlsx/worksheet-writer";
-export { WorksheetReader } from "./stream/xlsx/worksheet-reader";
-export { ModelContainer } from "./doc/modelcontainer";
-export * from "./doc/enums";
-export * from "./types";
-export type { PivotTable, PivotTableModel, PivotTableSource, CacheField, DataField, PivotTableSubtotal, ParsedCacheDefinition, ParsedCacheRecords } from "./doc/pivot-table";
-export type { WorkbookReaderOptions, ParseEvent, SharedStringEvent, WorksheetReadyEvent, HyperlinksEvent } from "./stream/xlsx/workbook-reader";
-export type { WorksheetReaderOptions, WorksheetEvent, RowEvent, HyperlinkEvent, WorksheetHyperlink } from "./stream/xlsx/worksheet-reader";
-export type { WorkbookWriterOptions, ZipOptions, ZlibOptions } from "./stream/xlsx/workbook-writer";
-export type { CsvReadOptions, CsvWriteOptions, CsvStreamReadOptions, CsvStreamWriteOptions } from "./csv/csv";
-export { CsvParserStream, CsvFormatterStream } from "./csv/csv";
-export * from "./utils/sheet-utils";
+export { Workbook } from "./modules/excel/workbook";
+export { Worksheet } from "./modules/excel/worksheet";
+export { Row } from "./modules/excel/row";
+export { Column } from "./modules/excel/column";
+export { Cell } from "./modules/excel/cell";
+export { Range } from "./modules/excel/range";
+export { Image } from "./modules/excel/image";
+export * from "./modules/excel/anchor";
+export { Table } from "./modules/excel/table";
+export { DataValidations } from "./modules/excel/data-validations";
+export { WorkbookWriter } from "./modules/excel/stream/workbook-writer";
+export { WorkbookReader } from "./modules/excel/stream/workbook-reader";
+export { WorksheetWriter } from "./modules/excel/stream/worksheet-writer";
+export { WorksheetReader } from "./modules/excel/stream/worksheet-reader";
+export * from "./modules/excel/enums";
+export * from "./modules/excel/types";
+export type { PivotTable, PivotTableModel, PivotTableSource, CacheField, DataField, PivotTableSubtotal, ParsedCacheDefinition, ParsedCacheRecords } from "./modules/excel/pivot-table";
+export type { WorkbookReaderOptions, ParseEvent, SharedStringEvent, WorksheetReadyEvent, HyperlinksEvent } from "./modules/excel/stream/workbook-reader";
+export type { WorksheetReaderOptions, WorksheetEvent, RowEvent, HyperlinkEvent, WorksheetHyperlink } from "./modules/excel/stream/worksheet-reader";
+export type { WorkbookWriterOptions, ZipOptions, ZlibOptions } from "./modules/excel/stream/workbook-writer";
+export type { CsvReadOptions, CsvWriteOptions, CsvStreamReadOptions, CsvStreamWriteOptions } from "./modules/csv/csv";
+export { CsvParserStream, CsvFormatterStream } from "./modules/csv/csv";
+export * from "./modules/excel/utils/sheet-utils";

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

@@ -0,0 +1,18 @@
+export declare class ByteQueue {
+    private static readonly EMPTY;
+    private _buf;
+    private _start;
+    private _end;
+    private _cachedView;
+    private _cachedBuf;
+    private _cachedStart;
+    private _cachedEnd;
+    constructor(initial?: Uint8Array);
+    get length(): number;
+    isEmpty(): boolean;
+    view(): Uint8Array;
+    reset(data?: Uint8Array): void;
+    append(chunk: Uint8Array): void;
+    read(length: number): Uint8Array;
+    discard(length: number): void;
+}

package/dist/types/modules/archive/compress.base.d.ts

@@ -0,0 +1,98 @@
+/**
+ * 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
+ */
+/**
+ * Compression options
+ */
+export interface CompressOptions {
+    /**
+     * Compression level (0-9)
+     * - 0: No compression (STORE)
+     * - 1: Fastest compression
+     * - 6: Default compression (good balance)
+     * - 9: Best compression (slowest)
+     *
+     * Note: CompressionStream does not support level configuration,
+     * it uses a fixed level (~6)
+     */
+    level?: number;
+    /**
+     * Threshold (in bytes) to choose the lower-overhead path.
+     *
+     * - Node.js: inputs <= threshold use sync zlib fast-path (avoid threadpool overhead)
+     * - Browser: inputs <= threshold use the pure-JS fallback (avoid stream scheduling overhead)
+     */
+    thresholdBytes?: number;
+}
+/**
+ * Default threshold (in bytes) to choose the lower-overhead path.
+ *
+ * This is a performance knob, not a correctness requirement.
+ */
+export declare const DEFAULT_COMPRESS_THRESHOLD_BYTES: number;
+/**
+ * Resolve the effective threshold bytes.
+ */
+export declare function resolveCompressThresholdBytes(options: CompressOptions): number;
+/**
+ * Check if CompressionStream is available
+ */
+export declare function hasCompressionStream(): boolean;
+/**
+ * Non-cached probe for CompressionStream("deflate-raw") support.
+ *
+ * Prefer this in code paths that want up-to-date environment checks
+ * (e.g. tests that stub globals).
+ */
+export declare function probeDeflateRawCompressionStream(): boolean;
+/**
+ * Non-cached probe for DecompressionStream("deflate-raw") support.
+ */
+export declare function probeDeflateRawDecompressionStream(): boolean;
+/**
+ * Non-cached probe for full deflate-raw Web Streams support.
+ *
+ * Returns true only if BOTH CompressionStream("deflate-raw") and
+ * DecompressionStream("deflate-raw") are supported.
+ */
+export declare function probeDeflateRawWebStreams(): boolean;
+/**
+ * Check if CompressionStream supports the "deflate-raw" format.
+ *
+ * This is a stricter check than {@link hasCompressionStream} because some
+ * environments expose CompressionStream but do not support "deflate-raw".
+ */
+export declare function hasDeflateRawCompressionStream(): boolean;
+/**
+ * Check if DecompressionStream supports the "deflate-raw" format.
+ */
+export declare function hasDeflateRawDecompressionStream(): boolean;
+/**
+ * Cached check for full deflate-raw Web Streams support.
+ *
+ * Returns true only if BOTH CompressionStream("deflate-raw") and
+ * DecompressionStream("deflate-raw") are supported.
+ */
+export declare function hasDeflateRawWebStreams(): boolean;
+/**
+ * Compress using CompressionStream API
+ * Uses "deflate-raw" format (required for ZIP files)
+ *
+ * @param data - Data to compress
+ * @returns Compressed data
+ */
+export declare function compressWithStream(data: Uint8Array): Promise<Uint8Array>;
+/**
+ * Decompress using DecompressionStream API
+ *
+ * @param data - Compressed data (deflate-raw format)
+ * @returns Decompressed data
+ */
+export declare function decompressWithStream(data: Uint8Array): Promise<Uint8Array>;

package/dist/types/modules/archive/compress.browser.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 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 >= 89
+ * - Firefox >= 102
+ * - Safari >= 14.1
+ * - Edge >= 89
+ */
+import { type CompressOptions } from "./compress.base";
+export { type CompressOptions };
+/**
+ * Check if CompressionStream is available in this environment.
+ *
+ * Note: Some environments may expose CompressionStream but not support
+ * the "deflate-raw" format that ZIP requires.
+ */
+export declare function hasCompressionStream(): boolean;
+/**
+ * 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 });
+ * ```
+ */
+export declare function compress(data: Uint8Array, options?: CompressOptions): Promise<Uint8Array>;
+/**
+ * Compress data synchronously using pure JS implementation
+ *
+ * @param data - Data to compress
+ * @param options - Compression options
+ * @returns Compressed data
+ */
+export declare function compressSync(data: Uint8Array, options?: CompressOptions): Uint8Array;
+/**
+ * Decompress data using browser's native DecompressionStream or JS fallback
+ *
+ * @param data - Compressed data (deflate-raw format)
+ * @returns Decompressed data
+ */
+export declare function decompress(data: Uint8Array, options?: CompressOptions): Promise<Uint8Array>;
+/**
+ * Decompress data synchronously using pure JS implementation
+ *
+ * @param data - Compressed data (deflate-raw format)
+ * @returns Decompressed data
+ */
+export declare function decompressSync(data: Uint8Array): Uint8Array;

package/dist/types/modules/archive/compress.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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)
+ */
+export { type CompressOptions, hasCompressionStream } from "./compress.base";
+import type { CompressOptions } from "./compress.base";
+/**
+ * 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 });
+ * ```
+ */
+export declare function compress(data: Uint8Array, options?: CompressOptions): Promise<Uint8Array>;
+/**
+ * Compress data synchronously using Node.js zlib
+ *
+ * @param data - Data to compress
+ * @param options - Compression options
+ * @returns Compressed data
+ */
+export declare function compressSync(data: Uint8Array, options?: CompressOptions): Uint8Array;
+/**
+ * Decompress data using Node.js native zlib
+ *
+ * @param data - Compressed data (deflate-raw format)
+ * @returns Decompressed data
+ */
+export declare function decompress(data: Uint8Array, options?: CompressOptions): Promise<Uint8Array>;
+/**
+ * Decompress data synchronously using Node.js zlib
+ *
+ * @param data - Compressed data (deflate-raw format)
+ * @returns Decompressed data
+ */
+export declare function decompressSync(data: Uint8Array): Uint8Array;

package/dist/types/modules/archive/crc32.base.d.ts

@@ -0,0 +1,25 @@
+/**
+ * CRC32 calculation core (shared between Node.js and browser).
+ *
+ * Implements CRC-32 IEEE 802.3 using the reversed polynomial 0xEDB88320.
+ *
+ * Notes:
+ * - Uses a lazily-initialized 256-entry lookup table.
+ * - Exposes an incremental update API for streaming use cases.
+ */
+/**
+ * Update a CRC32 value with a new data chunk.
+ *
+ * The CRC state here is the non-finalized (inverted) form:
+ * - initial state: 0xffffffff
+ * - finalize: xor with 0xffffffff
+ */
+export declare function crc32UpdateJS(crc: number, data: Uint8Array): number;
+/**
+ * Finalize CRC32 calculation.
+ */
+export declare function crc32Finalize(crc: number): number;
+/**
+ * Compute CRC32 for the full input using the JS table implementation.
+ */
+export declare function crc32JS(data: Uint8Array): number;

package/dist/types/modules/archive/crc32.browser.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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
+ */
+export { crc32JS as crc32, crc32UpdateJS as crc32Update, crc32Finalize } from "./crc32.base";
+/**
+ * Ensure CRC32 is ready (no-op in browser, for API compatibility)
+ */
+export declare function ensureCrc32(): Promise<void>;
+/**
+ * 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);
+ * ```
+ */

package/dist/types/modules/archive/crc32.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 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
+ */
+import { crc32Finalize } from "./crc32.base";
+/**
+ * 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"
+ * ```
+ */
+export declare function crc32(data: Uint8Array): number;
+/**
+ * Ensure zlib is loaded (for use before calling crc32)
+ */
+export declare function ensureCrc32(): Promise<void>;
+/**
+ * Calculate CRC32 incrementally (useful for streaming)
+ * Call with initial crc of 0xffffffff, then finalize with crc32Finalize
+ * In Node.js, this uses native zlib.crc32 when available for performance.
+ * The internal CRC state remains the same as the JS table implementation:
+ * - initial state: 0xffffffff
+ * - finalize: xor with 0xffffffff
+ *
+ * @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 declare function crc32Update(crc: number, data: Uint8Array): number;
+/**
+ * Finalize CRC32 calculation
+ * XOR with 0xffffffff and convert to unsigned 32-bit
+ *
+ * @param crc - CRC value from crc32Update
+ * @returns Final CRC32 checksum
+ */
+export { crc32Finalize };

package/dist/types/modules/archive/defaults.d.ts

@@ -0,0 +1,4 @@
+import type { ZipTimestampMode } from "./utils/timestamps";
+export declare const DEFAULT_COMPRESS_LEVEL = 6;
+export declare const DEFAULT_ZIP_LEVEL = 6;
+export declare const DEFAULT_ZIP_TIMESTAMPS: ZipTimestampMode;

package/dist/types/modules/archive/deflate-fallback.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Pure JavaScript DEFLATE implementation for browsers without CompressionStream support
+ *
+ * This fallback supports:
+ * - Decompression: Full DEFLATE decompression (RFC 1951)
+ * - Compression: STORE mode only (no compression, but valid DEFLATE format)
+ *
+ * Used automatically when CompressionStream with "deflate-raw" is unavailable:
+ * - Firefox < 113
+ * - Safari < 16.4
+ * - Chrome < 103
+ */
+/**
+ * Decompress DEFLATE data (raw format, no zlib header)
+ *
+ * @param data - Compressed data in deflate-raw format
+ * @returns Decompressed data
+ */
+export declare function inflateRaw(data: Uint8Array): Uint8Array;
+/**
+ * Compress data using DEFLATE STORE mode (no compression)
+ *
+ * This creates valid DEFLATE data but without actual compression.
+ * Files will be larger but this works on all browsers.
+ *
+ * @param data - Data to "compress"
+ * @returns DEFLATE-formatted data (stored, not compressed)
+ */
+export declare function deflateRawStore(data: Uint8Array): Uint8Array;
+/**
+ * Compress data using DEFLATE with fixed Huffman codes
+ *
+ * This provides real compression using LZ77 + fixed Huffman codes.
+ * Not as efficient as full DEFLATE but much better than STORE mode.
+ *
+ * @param data - Data to compress
+ * @returns Compressed data in deflate-raw format
+ */
+export declare function deflateRawCompressed(data: Uint8Array): Uint8Array;

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

@@ -0,0 +1,11 @@
+/**
+ * Archive (ZIP) module - shared exports.
+ *
+ * This module contains exports that are identical across Node.js and browser.
+ * Platform-specific entrypoints (index.ts / index.browser.ts) should re-export
+ * from this file and then layer their platform-specific bindings.
+ */
+export { createZip, createZipSync, ZipBuilder, type ZipEntry, type ZipOptions } from "./zip-builder";
+export { StreamingZip, ZipDeflateFile, Zip, ZipDeflate } from "./streaming-zip";
+export { extractAll, extractFile, listFiles, forEachEntry, ZipParser, type ExtractedFile, type ZipParseOptions } from "./extract";
+export type { ZipEntryInfo } from "./zip-entry-info";

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

@@ -0,0 +1,11 @@
+/**
+ * Archive (ZIP) module - unified ZIP + Unzip implementation (browser type surface).
+ *
+ * This file mirrors [src/modules/archive/index.ts] but explicitly re-exports
+ * browser-specific implementations so we can enforce export-surface parity.
+ */
+export * from "./index.base";
+export { crc32, crc32Update, crc32Finalize } from "./crc32.browser";
+export { compress, compressSync, decompress, decompressSync, hasCompressionStream, type CompressOptions } from "./compress.browser";
+export { createDeflateStream, createInflateStream, hasDeflateRaw, type StreamCompressOptions } from "./streaming-compress.browser";
+export { Parse, createParse, type ParseOptions, type ZipEntry as StreamZipEntry } from "./parse.browser";

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

@@ -0,0 +1,11 @@
+/**
+ * Archive (ZIP) module - unified ZIP + Unzip implementation.
+ *
+ * This module is intended to be extractable as a standalone package.
+ * It groups all ZIP creation and extraction utilities in one place.
+ */
+export * from "./index.base";
+export { crc32, crc32Update, crc32Finalize } from "./crc32";
+export { compress, compressSync, decompress, decompressSync, hasCompressionStream, type CompressOptions } from "./compress";
+export { createDeflateStream, createInflateStream, hasDeflateRaw, type StreamCompressOptions } from "./streaming-compress";
+export { Parse, createParse, type ParseOptions, type ZipEntry as StreamZipEntry } from "./parse";