@cj-tech-master/excelts 4.2.0-canary.20260110080706.375ff37 → 4.2.0-canary.20260110111632.c88c61c

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

@@ -35,6 +35,7 @@ export interface CompressOptions {
  * Default threshold (in bytes) to choose the lower-overhead path.
  *
  * This is a performance knob, not a correctness requirement.
+ * Default: 8MB.
  */
 export declare const DEFAULT_COMPRESS_THRESHOLD_BYTES: number;
 /**

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

@@ -22,6 +22,9 @@ export declare function hasCompressionStream(): boolean;
 /**
  * Compress data using browser's native CompressionStream or JS fallback
  *
+ * Note: We always prefer native CompressionStream when available because
+ * it's significantly faster than pure JS implementation.
+ *
  * @param data - Data to compress
  * @param options - Compression options
  * @returns Compressed data
@@ -44,7 +47,12 @@ export declare function compressSync(data: Uint8Array, options?: CompressOptions
 /**
  * Decompress data using browser's native DecompressionStream or JS fallback
  *
+ * Note: We always prefer native DecompressionStream when available because
+ * it's significantly faster than pure JS implementation, regardless of data size.
+ * The threshold is only useful for compression where the overhead matters more.
+ *
  * @param data - Compressed data (deflate-raw format)
+ * @param options - Decompression options (kept for API parity; currently unused in browser)
  * @returns Decompressed data
  */
 export declare function decompress(data: Uint8Array, options?: CompressOptions): Promise<Uint8Array>;

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

@@ -142,6 +142,17 @@ export declare function streamUntilValidatedDataDescriptor(options: StreamUntilV
 export interface ParseOptions {
     verbose?: boolean;
     forceStream?: boolean;
+    /**
+     * Threshold (in bytes) for small file optimization.
+     * Files smaller than this will use sync decompression (no stream overhead).
+     *
+     * Note: the optimization is only applied when the entry sizes are trusted
+     * (i.e. no data descriptor) and BOTH compressedSize and uncompressedSize
+     * are below this threshold. This avoids buffering huge highly-compressible
+     * files (e.g. large XML) in memory, which would defeat streaming.
+     * Default: 5MB
+     */
+    thresholdBytes?: number;
 }
 export interface EntryVars {
     versionsNeededToExtract: number | null;
@@ -195,4 +206,14 @@ export interface ParseEmitter {
     emitClose(): void;
 }
 export type InflateFactory = () => Transform | Duplex | PassThrough;
-export declare function runParseLoop(opts: ParseOptions, io: ParseIO, emitter: ParseEmitter, inflateFactory: InflateFactory, state: ParseDriverState): Promise<void>;
+/**
+ * Synchronous inflate function type for small file optimization.
+ * When provided and file size is below threshold, this will be used
+ * instead of streaming decompression for better performance.
+ */
+export type InflateRawSync = (data: Uint8Array) => Uint8Array;
+/**
+ * Default threshold for small file optimization (5MB).
+ */
+export declare const DEFAULT_PARSE_THRESHOLD_BYTES: number;
+export declare function runParseLoop(opts: ParseOptions, io: ParseIO, emitter: ParseEmitter, inflateFactory: InflateFactory, state: ParseDriverState, inflateRawSync?: InflateRawSync): Promise<void>;

package/dist/types/modules/excel/form-control.d.ts

@@ -42,6 +42,8 @@ export interface FormCheckboxModel {
     shapeId: number;
     /** Control property ID (rId in relationships) */
     ctrlPropId: number;
+    /** Relationship id (e.g., rId5) in sheet rels for ctrlProp (set during XLSX prepare) */
+    ctrlPropRelId?: string;
     /** Top-left anchor */
     tl: FormControlAnchor;
     /** Bottom-right anchor */

package/dist/types/modules/stream/streams.browser.d.ts

@@ -456,6 +456,8 @@ export declare class Transform<TInput = Uint8Array, TOutput = Uint8Array> extend
      * Read from the transform stream
      */
     read(size?: number): TOutput | null;
+    /** @internal - list of piped destinations for forwarding auto-consumed data */
+    private _pipeDestinations;
     /**
      * Pipe to another stream (writable, transform, or duplex)
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cj-tech-master/excelts",
-  "version": "4.2.0-canary.20260110080706.375ff37",
+  "version": "4.2.0-canary.20260110111632.c88c61c",
   "description": "TypeScript Excel Workbook Manager - Read and Write xlsx and csv Files.",
   "type": "module",
   "publishConfig": {