@cj-tech-master/excelts 1.6.3 → 2.0.0

package/dist/types/utils/zip/compress.d.ts

@@ -1,49 +1,16 @@
 /**
- * Native compression utilities using platform APIs
+ * Node.js compression utilities using native zlib
  *
- * - Node.js: Uses native zlib module (C++ implementation, fastest)
- * - Browser: Uses CompressionStream API (Chrome 80+, Firefox 113+, Safari 16.4+)
- *
- * Both use "deflate-raw" format which is required for ZIP files
- * (raw DEFLATE without zlib header/trailer)
- */
-import type * as zlibType from "zlib";
-/**
- * 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;
-}
-/**
- * Ensure zlib is loaded (Node.js only)
- * Call this before using sync methods if you need to guarantee availability
+ * Uses zlib module (C++ implementation, fastest) with "deflate-raw" format
+ * (raw DEFLATE without zlib header/trailer, required for ZIP files)
  */
-export declare function ensureZlib(): Promise<typeof zlibType | null>;
+export { type CompressOptions, hasCompressionStream } from "./compress.base";
 /**
- * Check if native zlib is available (Node.js)
+ * Check if native zlib is available (always true in Node.js)
  */
 export declare function hasNativeZlib(): boolean;
 /**
- * Check if CompressionStream is available (Browser/Node.js 17+)
- */
-export declare function hasCompressionStream(): boolean;
-/**
- * Compress data using the best available native method
- *
- * Priority:
- * 1. Node.js zlib (if available) - fastest, supports compression levels
- * 2. CompressionStream (browser/Node.js 17+) - no level support
- * 3. Return uncompressed data (fallback)
+ * Compress data using Node.js native zlib
  *
  * @param data - Data to compress
  * @param options - Compression options
@@ -55,19 +22,21 @@ export declare function hasCompressionStream(): boolean;
  * const compressed = await compress(data, { level: 6 });
  * ```
  */
-export declare function compress(data: Uint8Array, options?: CompressOptions): Promise<Uint8Array>;
+export declare function compress(data: Uint8Array, options?: {
+    level?: number;
+}): Promise<Uint8Array>;
 /**
  * Compress data synchronously using Node.js zlib
- * Only available in Node.js environment
  *
  * @param data - Data to compress
  * @param options - Compression options
  * @returns Compressed data
- * @throws Error if not in Node.js environment
  */
-export declare function compressSync(data: Uint8Array, options?: CompressOptions): Uint8Array;
+export declare function compressSync(data: Uint8Array, options?: {
+    level?: number;
+}): Uint8Array;
 /**
- * Decompress data using the best available native method
+ * Decompress data using Node.js native zlib
  *
  * @param data - Compressed data (deflate-raw format)
  * @returns Decompressed data
@@ -78,6 +47,5 @@ export declare function decompress(data: Uint8Array): Promise<Uint8Array>;
  *
  * @param data - Compressed data (deflate-raw format)
  * @returns Decompressed data
- * @throws Error if not in Node.js environment
  */
 export declare function decompressSync(data: Uint8Array): Uint8Array;

package/dist/types/utils/zip/crc32.browser.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 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
+ */
+/**
+ * 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 declare function crc32(data: Uint8Array): number;
+/**
+ * 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);
+ * ```
+ */
+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 declare function crc32Finalize(crc: number): number;

package/dist/types/utils/zip/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/utils/zip/index.d.ts

@@ -16,7 +16,7 @@
  *
  * @example Basic usage
  * ```ts
- * import { createZip } from "./utils/zip/index.js";
+ * import { createZip } from "./utils/zip/index";
  *
  * const zipData = await createZip([
  *   { name: "hello.txt", data: new TextEncoder().encode("Hello!") },
@@ -29,7 +29,7 @@
  *
  * @example Streaming usage
  * ```ts
- * import { ZipBuilder } from "./utils/zip/index.js";
+ * import { ZipBuilder } from "./utils/zip/index";
  *
  * const builder = new ZipBuilder({ level: 1 });
  *
@@ -47,6 +47,6 @@
  * }
  * ```
  */
-export { crc32, crc32Update, crc32Finalize } from "./crc32.js";
-export { compress, compressSync, decompress, decompressSync, hasNativeZlib, hasCompressionStream, type CompressOptions } from "./compress.js";
-export { createZip, createZipSync, ZipBuilder, type ZipEntry, type ZipOptions } from "./zip-builder.js";
+export { crc32, crc32Update, crc32Finalize } from "./crc32";
+export { compress, compressSync, decompress, decompressSync, hasNativeZlib, hasCompressionStream, type CompressOptions } from "./compress";
+export { createZip, createZipSync, ZipBuilder, type ZipEntry, type ZipOptions } from "./zip-builder";

package/dist/types/utils/zip/streaming-zip.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Streaming ZIP creator - fflate-compatible API
+ *
+ * This module provides a streaming ZIP API compatible with fflate's Zip/ZipDeflate,
+ * but uses native zlib compression for better performance.
+ *
+ * Usage:
+ * ```ts
+ * const zip = new StreamingZip((err, data, final) => {
+ *   if (err) handleError(err);
+ *   else {
+ *     stream.write(data);
+ *     if (final) stream.end();
+ *   }
+ * });
+ *
+ * const file = new ZipDeflateFile("path/file.txt", { level: 6 });
+ * zip.add(file);
+ * file.push(data1);
+ * file.push(data2, true); // true = final chunk
+ *
+ * zip.end();
+ * ```
+ */
+/**
+ * Internal entry info for central directory
+ */
+interface ZipEntryInfo {
+    name: Uint8Array;
+    crc: number;
+    compressedSize: number;
+    uncompressedSize: number;
+    compressionMethod: number;
+    dosTime: number;
+    dosDate: number;
+    offset: number;
+}
+/**
+ * ZipDeflate-compatible file stream
+ * Collects data chunks, compresses on finalization
+ */
+export declare class ZipDeflateFile {
+    private chunks;
+    private totalSize;
+    private finalized;
+    private _ondata;
+    readonly name: string;
+    readonly level: number;
+    constructor(name: string, options?: {
+        level?: number;
+    });
+    /**
+     * Set data callback (called by StreamingZip)
+     */
+    set ondata(cb: (data: Uint8Array, final: boolean) => void);
+    /**
+     * Push data to the file
+     * @param data - Data chunk
+     * @param final - Whether this is the final chunk
+     */
+    push(data: Uint8Array, final?: boolean): void;
+    /**
+     * Flush collected data through compression and emit
+     */
+    private _flush;
+    /**
+     * Get entry info (called by StreamingZip after finalization)
+     */
+    getEntryInfo(): ZipEntryInfo | null;
+}
+/**
+ * Streaming ZIP - fflate Zip-compatible API
+ * Creates ZIP files in a streaming manner
+ */
+export declare class StreamingZip {
+    private callback;
+    private entries;
+    private currentOffset;
+    private ended;
+    /**
+     * Create a streaming ZIP
+     * @param callback - Called with (err, data, final) as data becomes available
+     */
+    constructor(callback: (err: Error | null, data: Uint8Array, final: boolean) => void);
+    /**
+     * Add a file to the ZIP
+     * @param file - ZipDeflateFile instance
+     */
+    add(file: ZipDeflateFile): void;
+    /**
+     * Finalize the ZIP
+     * Writes central directory and end-of-central-directory record
+     */
+    end(): void;
+}
+export { StreamingZip as Zip, ZipDeflateFile as ZipDeflate };

package/dist/types/utils/zip/zip-builder.d.ts

@@ -21,7 +21,7 @@
  * │ End of Central Directory │
  * └──────────────────────────┘
  */
-import { type CompressOptions } from "./compress.js";
+import { type CompressOptions } from "./compress";
 /**
  * ZIP file entry
  */

package/dist/types/utils/zip-stream.browser.d.ts

@@ -0,0 +1,39 @@
+interface ZipWriterOptions {
+    /** Compression method: "DEFLATE" (default) or "STORE" (no compression) */
+    compression?: "DEFLATE" | "STORE";
+    compressionOptions?: {
+        /** Compression level 0-9: 0=none, 1=fast (default), 9=best */
+        level?: number;
+    };
+}
+interface AppendOptions {
+    name: string;
+    base64?: boolean;
+}
+type EventCallback = (...args: any[]) => void;
+declare class ZipWriter {
+    private stream;
+    private zipBuilder;
+    private finalized;
+    private pendingWrites;
+    private events;
+    constructor(options?: ZipWriterOptions);
+    on(event: string, callback: EventCallback): this;
+    once(event: string, callback: EventCallback): this;
+    off(event: string, callback: EventCallback): this;
+    emit(event: string, ...args: any[]): boolean;
+    removeListener(event: string, callback: EventCallback): this;
+    append(data: any, options: AppendOptions): void;
+    push(chunk: any): boolean;
+    finalize(): Promise<void>;
+    read(size?: number): any;
+    setEncoding(encoding: string): any;
+    pause(): any;
+    resume(): any;
+    isPaused(): boolean;
+    pipe(destination: any): any;
+    unpipe(destination?: any): void;
+    unshift(): void;
+    wrap(): void;
+}
+export { ZipWriter };

package/dist/types/xlsx/xform/base-xform.d.ts

@@ -1,4 +1,4 @@
-import { XmlStream } from "../../utils/xml-stream.js";
+import { XmlStream } from "../../utils/xml-stream";
 interface ParseEvent {
     eventType: string;
     value: any;

package/dist/types/xlsx/xform/book/defined-name-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface DefinedNameModel {
     name: string;
     ranges: string[];

package/dist/types/xlsx/xform/book/sheet-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface SheetModel {
     id: number;
     name: string;

package/dist/types/xlsx/xform/book/workbook-calc-properties-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface CalcPropertiesModel {
     fullCalcOnLoad?: boolean;
 }

package/dist/types/xlsx/xform/book/workbook-pivot-cache-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface PivotCacheModel {
     cacheId: string;
     rId: string;

package/dist/types/xlsx/xform/book/workbook-properties-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface WorkbookPropertiesModel {
     date1904?: boolean;
 }

package/dist/types/xlsx/xform/book/workbook-view-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface WorkbookViewModel {
     x?: number;
     y?: number;

package/dist/types/xlsx/xform/book/workbook-xform.d.ts

@@ -1,5 +1,5 @@
-import { BaseXform } from "../base-xform.js";
-import { StaticXform } from "../static-xform.js";
+import { BaseXform } from "../base-xform";
+import { StaticXform } from "../static-xform";
 declare class WorkbookXform extends BaseXform {
     parser: any;
     constructor();

package/dist/types/xlsx/xform/comment/comment-xform.d.ts

@@ -1,5 +1,5 @@
-import { RichTextXform } from "../strings/rich-text-xform.js";
-import { BaseXform } from "../base-xform.js";
+import { RichTextXform } from "../strings/rich-text-xform";
+import { BaseXform } from "../base-xform";
 interface NoteText {
     font?: any;
     text: string;

package/dist/types/xlsx/xform/comment/comments-xform.d.ts

@@ -1,5 +1,5 @@
-import { BaseXform } from "../base-xform.js";
-import { CommentXform } from "./comment-xform.js";
+import { BaseXform } from "../base-xform";
+import { CommentXform } from "./comment-xform";
 interface CommentsModel {
     comments: any[];
 }

package/dist/types/xlsx/xform/comment/style/vml-position-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../../base-xform.js";
+import { BaseXform } from "../../base-xform";
 declare class VmlPositionXform extends BaseXform {
     private _model;
     model: {

package/dist/types/xlsx/xform/comment/style/vml-protection-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../../base-xform.js";
+import { BaseXform } from "../../base-xform";
 declare class VmlProtectionXform extends BaseXform {
     private _model;
     private text;

package/dist/types/xlsx/xform/comment/vml-anchor-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface AnchorModel {
     left: number;
     top: number;

package/dist/types/xlsx/xform/comment/vml-client-data-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface Protection {
     locked?: string;
     lockText?: string;

package/dist/types/xlsx/xform/comment/vml-notes-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface VmlNotesModel {
     comments: any[];
 }

package/dist/types/xlsx/xform/comment/vml-shape-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface ShapeModel {
     note: {
         margins?: {

package/dist/types/xlsx/xform/comment/vml-textbox-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface Margins {
     inset?: number[] | string;
 }

package/dist/types/xlsx/xform/composite-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "./base-xform.js";
+import { BaseXform } from "./base-xform";
 declare class CompositeXform extends BaseXform {
     parser?: any;
     createNewModel(_node?: any): any;

package/dist/types/xlsx/xform/core/app-heading-pairs-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 declare class AppHeadingPairsXform extends BaseXform {
     render(xmlStream: any, model: any[]): void;
     parseOpen(node: any): boolean;

package/dist/types/xlsx/xform/core/app-titles-of-parts-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 declare class AppTitlesOfPartsXform extends BaseXform {
     render(xmlStream: any, model: any[]): void;
     parseOpen(node: any): boolean;

package/dist/types/xlsx/xform/core/app-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface AppModel {
     worksheets: any[];
     company?: string;

package/dist/types/xlsx/xform/core/content-types-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 declare class ContentTypesXform extends BaseXform {
     render(xmlStream: any, model: any): void;
     parseOpen(): boolean;

package/dist/types/xlsx/xform/core/core-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface CoreModel {
     creator?: string;
     title?: string;

package/dist/types/xlsx/xform/core/relationship-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface RelationshipModel {
     Id?: string;
     Type?: string;

package/dist/types/xlsx/xform/core/relationships-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 declare class RelationshipsXform extends BaseXform {
     parser: any;
     private _values?;

package/dist/types/xlsx/xform/drawing/base-cell-anchor-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 declare abstract class BaseCellAnchorXform extends BaseXform {
     map: {
         [key: string]: any;

package/dist/types/xlsx/xform/drawing/blip-fill-xform.d.ts

@@ -1,5 +1,5 @@
-import { BaseXform } from "../base-xform.js";
-import { BlipXform } from "./blip-xform.js";
+import { BaseXform } from "../base-xform";
+import { BlipXform } from "./blip-xform";
 declare class BlipFillXform extends BaseXform {
     map: {
         [key: string]: BlipXform;

package/dist/types/xlsx/xform/drawing/blip-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface BlipModel {
     rId: string;
 }

package/dist/types/xlsx/xform/drawing/c-nv-pic-pr-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 declare class CNvPicPrXform extends BaseXform {
     get tag(): string;
     render(xmlStream: any): void;

package/dist/types/xlsx/xform/drawing/c-nv-pr-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface CNvPrModel {
     index: number;
 }

package/dist/types/xlsx/xform/drawing/cell-position-xform.d.ts

@@ -1,5 +1,5 @@
-import { BaseXform } from "../base-xform.js";
-import { IntegerXform } from "../simple/integer-xform.js";
+import { BaseXform } from "../base-xform";
+import { IntegerXform } from "../simple/integer-xform";
 interface PositionModel {
     nativeCol: number;
     nativeColOff: number;

package/dist/types/xlsx/xform/drawing/drawing-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface DrawingModel {
     anchors: any[];
 }

package/dist/types/xlsx/xform/drawing/ext-lst-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 declare class ExtLstXform extends BaseXform {
     get tag(): string;
     render(xmlStream: any): void;

package/dist/types/xlsx/xform/drawing/ext-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface ExtModel {
     width: number;
     height: number;

package/dist/types/xlsx/xform/drawing/hlink-click-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 declare class HLinkClickXform extends BaseXform {
     model: any;
     constructor();

package/dist/types/xlsx/xform/drawing/nv-pic-pr-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 declare class NvPicPrXform extends BaseXform {
     map: {
         [key: string]: any;

package/dist/types/xlsx/xform/drawing/one-cell-anchor-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseCellAnchorXform } from "./base-cell-anchor-xform.js";
+import { BaseCellAnchorXform } from "./base-cell-anchor-xform";
 interface OneCellModel {
     range: {
         editAs?: string;

package/dist/types/xlsx/xform/drawing/pic-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseXform } from "../base-xform.js";
+import { BaseXform } from "../base-xform";
 interface PicModel {
     index?: number;
     [key: string]: any;

package/dist/types/xlsx/xform/drawing/two-cell-anchor-xform.d.ts

@@ -1,4 +1,4 @@
-import { BaseCellAnchorXform } from "./base-cell-anchor-xform.js";
+import { BaseCellAnchorXform } from "./base-cell-anchor-xform";
 interface TwoCellModel {
     range: {
         editAs?: string;