@cj-tech-master/excelts 4.2.0 → 4.2.1

package/dist/cjs/modules/archive/parse.base.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PullStream = exports.parseExtraField = exports.END_OF_CENTRAL_DIRECTORY_FORMAT = exports.CENTRAL_DIRECTORY_FILE_HEADER_FORMAT = exports.DATA_DESCRIPTOR_FORMAT = exports.LOCAL_FILE_HEADER_FORMAT = exports.CRX_HEADER_FORMAT = void 0;
+exports.DEFAULT_PARSE_THRESHOLD_BYTES = exports.PullStream = exports.parseExtraField = exports.END_OF_CENTRAL_DIRECTORY_FORMAT = exports.CENTRAL_DIRECTORY_FILE_HEADER_FORMAT = exports.DATA_DESCRIPTOR_FORMAT = exports.LOCAL_FILE_HEADER_FORMAT = exports.CRX_HEADER_FORMAT = void 0;
 exports.decodeZipEntryPath = decodeZipEntryPath;
 exports.isZipUnicodeFlag = isZipUnicodeFlag;
 exports.isZipDirectoryPath = isZipDirectoryPath;
@@ -521,8 +521,13 @@ function streamUntilValidatedDataDescriptor(options) {
     queueMicrotask(pull);
     return output;
 }
+/**
+ * Default threshold for small file optimization (5MB).
+ */
+exports.DEFAULT_PARSE_THRESHOLD_BYTES = 5 * 1024 * 1024;
 const endDirectorySignature = (0, binary_1.writeUint32LE)(zip_constants_1.END_OF_CENTRAL_DIR_SIG);
-async function runParseLoop(opts, io, emitter, inflateFactory, state) {
+async function runParseLoop(opts, io, emitter, inflateFactory, state, inflateRawSync) {
+    const thresholdBytes = opts.thresholdBytes ?? exports.DEFAULT_PARSE_THRESHOLD_BYTES;
     while (true) {
         const sigBytes = await io.pull(4);
         if (sigBytes.length === 0) {
@@ -536,7 +541,7 @@ async function runParseLoop(opts, io, emitter, inflateFactory, state) {
             continue;
         }
         if (signature === zip_constants_1.LOCAL_FILE_HEADER_SIG) {
-            await readFileRecord(opts, io, emitter, inflateFactory, state);
+            await readFileRecord(opts, io, emitter, inflateFactory, state, thresholdBytes, inflateRawSync);
             continue;
         }
         if (signature === zip_constants_1.CENTRAL_DIR_HEADER_SIG) {
@@ -565,7 +570,7 @@ async function runParseLoop(opts, io, emitter, inflateFactory, state) {
         return;
     }
 }
-async function readFileRecord(opts, io, emitter, inflateFactory, state) {
+async function readFileRecord(opts, io, emitter, inflateFactory, state, thresholdBytes, inflateRawSync) {
     const { vars: headerVars, fileNameBuffer, extraFieldData } = await readLocalFileHeader(async (l) => io.pull(l));
     const vars = headerVars;
     if (state.crxHeader) {
@@ -621,6 +626,35 @@ async function readFileRecord(opts, io, emitter, inflateFactory, state) {
             extraFields: entry.extraFields
         });
     }
+    // Small file optimization: use sync decompression if:
+    // 1. Entry sizes are trusted (no data descriptor)
+    // 2. File size is known and below threshold
+    // 3. inflateRawSync is provided
+    // 4. File needs decompression (compressionMethod != 0)
+    // 5. Not autodraining
+    //
+    // We require BOTH compressedSize and uncompressedSize <= thresholdBytes.
+    // This prevents materializing large highly-compressible files in memory,
+    // which can cause massive peak RSS and negate streaming backpressure.
+    const sizesTrusted = !hasDataDescriptorFlag(vars.flags);
+    const compressedSize = vars.compressedSize || 0;
+    const uncompressedSize = vars.uncompressedSize || 0;
+    const useSmallFileOptimization = sizesTrusted &&
+        fileSizeKnown &&
+        inflateRawSync &&
+        vars.compressionMethod !== 0 &&
+        !autodraining &&
+        compressedSize <= thresholdBytes &&
+        uncompressedSize <= thresholdBytes;
+    if (useSmallFileOptimization) {
+        // Read compressed data directly and decompress synchronously
+        const compressedData = await io.pull(compressedSize);
+        const decompressedData = inflateRawSync(compressedData);
+        entry.end(decompressedData);
+        // Wait for entry stream write to complete (not for read/consume)
+        await (0, _stream_1.finished)(entry, { readable: false });
+        return;
+    }
     const inflater = vars.compressionMethod && !autodraining ? inflateFactory() : new _stream_1.PassThrough();
     if (fileSizeKnown) {
         await (0, _stream_1.pipeline)(io.stream(vars.compressedSize || 0), inflater, entry);

package/dist/cjs/modules/archive/parse.browser.js

@@ -346,7 +346,12 @@ function createParseClass(createInflateRawFn) {
                 }
             };
             queueMicrotask(() => {
-                this._parsingDone = (0, parse_base_1.runParseLoop)(this._opts, io, emitter, () => createInflateRawFn(), this._driverState);
+                // NOTE: We intentionally do NOT pass inflateRawSync to runParseLoop in browser.
+                // Browser's native DecompressionStream is faster than our pure-JS fallback,
+                // so we always use the streaming path for decompression in browsers.
+                this._parsingDone = (0, parse_base_1.runParseLoop)(this._opts, io, emitter, () => createInflateRawFn(), this._driverState
+                // No inflateRawSync - always use streaming DecompressionStream in browser
+                );
                 this._parsingDone.catch((e) => {
                     if (!this.__emittedError || this.__emittedError !== e) {
                         this.__emittedError = e;

package/dist/cjs/modules/archive/parse.js

@@ -58,7 +58,7 @@ function createParseClass(createInflateRawFn) {
                 }
             };
             // Parse records as data arrives. Only emit `close` when parsing is complete.
-            (0, parse_base_1.runParseLoop)(this._opts, io, emitter, createInflateRawFn, this._driverState).catch((e) => {
+            (0, parse_base_1.runParseLoop)(this._opts, io, emitter, createInflateRawFn, this._driverState, (data) => zlib_1.default.inflateRawSync(data)).catch((e) => {
                 if (!this.__emittedError || this.__emittedError !== e) {
                     this.emit("error", e);
                 }

package/dist/cjs/modules/excel/form-control.js

@@ -109,25 +109,63 @@ class FormCheckbox {
         let tl;
         let br;
         if (typeof range === "string") {
-            // Parse cell reference like "B2" or "B2:D3"
-            const decoded = col_cache_1.colCache.decode(range);
-            if ("top" in decoded) {
-                // It's a range like "B2:D3"
-                tl = {
-                    col: decoded.left - 1, // Convert to 0-based
-                    colOff: DEFAULT_COL_OFF,
-                    row: decoded.top - 1,
-                    rowOff: DEFAULT_ROW_OFF
-                };
-                br = {
-                    col: decoded.right - 1,
-                    colOff: DEFAULT_END_COL_OFF,
-                    row: decoded.bottom - 1,
-                    rowOff: DEFAULT_END_ROW_OFF
-                };
+            // Parse cell reference like "B2" or range like "B2:D3"
+            const isRange = range.includes(":");
+            if (isRange) {
+                const decoded = col_cache_1.colCache.decode(range);
+                if ("top" in decoded) {
+                    // Treat 1-cell ranges (e.g., "J4:J4") as a single cell with default checkbox size.
+                    if (decoded.left === decoded.right && decoded.top === decoded.bottom) {
+                        const col = decoded.left - 1;
+                        const row = decoded.top - 1;
+                        tl = {
+                            col,
+                            colOff: DEFAULT_COL_OFF,
+                            row,
+                            rowOff: DEFAULT_ROW_OFF
+                        };
+                        br = {
+                            col: col + 2,
+                            colOff: DEFAULT_END_COL_OFF,
+                            row: row + 1,
+                            rowOff: DEFAULT_END_ROW_OFF
+                        };
+                    }
+                    else {
+                        // Regular range
+                        tl = {
+                            col: decoded.left - 1, // Convert to 0-based
+                            colOff: DEFAULT_COL_OFF,
+                            row: decoded.top - 1,
+                            rowOff: DEFAULT_ROW_OFF
+                        };
+                        br = {
+                            col: decoded.right - 1,
+                            colOff: DEFAULT_END_COL_OFF,
+                            row: decoded.bottom - 1,
+                            rowOff: DEFAULT_END_ROW_OFF
+                        };
+                    }
+                }
+                else {
+                    // Defensive fallback: if the cache returns an address, treat it like a single-cell ref.
+                    tl = {
+                        col: decoded.col - 1,
+                        colOff: DEFAULT_COL_OFF,
+                        row: decoded.row - 1,
+                        rowOff: DEFAULT_ROW_OFF
+                    };
+                    br = {
+                        col: decoded.col + 1,
+                        colOff: DEFAULT_END_COL_OFF,
+                        row: decoded.row,
+                        rowOff: DEFAULT_END_ROW_OFF
+                    };
+                }
             }
             else {
                 // Single cell reference - create default size checkbox
+                const decoded = col_cache_1.colCache.decodeAddress(range);
                 tl = {
                     col: decoded.col - 1,
                     colOff: DEFAULT_COL_OFF,

package/dist/cjs/modules/excel/xlsx/xform/sheet/worksheet-xform.js

@@ -293,8 +293,10 @@ class WorkSheetXform extends base_xform_1.BaseXform {
             for (const control of model.formControls) {
                 const globalCtrlPropId = options.formControlRefs.length + 1;
                 control.ctrlPropId = globalCtrlPropId;
+                const relId = nextRid(rels);
+                control.ctrlPropRelId = relId;
                 rels.push({
-                    Id: nextRid(rels),
+                    Id: relId,
                     Type: rel_type_1.RelType.CtrlProp,
                     Target: (0, ooxml_paths_1.ctrlPropRelTargetFromWorksheet)(globalCtrlPropId)
                 });
@@ -357,15 +359,27 @@ class WorkSheetXform extends base_xform_1.BaseXform {
         this.map.drawing.render(xmlStream, model.drawing); // Note: must be after rowBreaks/colBreaks
         this.map.picture.render(xmlStream, model.background); // Note: must be after drawing
         this.map.tableParts.render(xmlStream, model.tables);
-        this.map.extLst.render(xmlStream, model);
+        // Controls section for legacy form controls (checkboxes, etc.)
+        // Excel expects <controls> entries that reference ctrlProp relationships.
+        if (model.formControls && model.formControls.length > 0) {
+            xmlStream.openNode("controls");
+            for (const control of model.formControls) {
+                if (control.ctrlPropRelId) {
+                    xmlStream.leafNode("control", { shapeId: control.shapeId, "r:id": control.ctrlPropRelId });
+                }
+            }
+            xmlStream.closeNode();
+        }
         if (model.rels) {
-            // add a <legacyDrawing /> node for each comment
+            // Add a <legacyDrawing /> node for each VML drawing relationship (comments and/or form controls).
             model.rels.forEach(rel => {
                 if (rel.Type === rel_type_1.RelType.VmlDrawing) {
                     xmlStream.leafNode("legacyDrawing", { "r:id": rel.Id });
                 }
             });
         }
+        // extLst should be the last element in the worksheet.
+        this.map.extLst.render(xmlStream, model);
         xmlStream.closeNode();
     }
     parseOpen(node) {

package/dist/cjs/modules/stream/streams.browser.js

@@ -425,55 +425,58 @@ class Readable extends event_emitter_1.EventEmitter {
         // causing `instanceof Transform/Writable/Duplex` to fail even when the object
         // is a valid destination.
         const dest = destination;
-        // Get the actual writable target.
-        // Prefer internal `_writable` (Transform/Duplex wrappers), else treat the destination as writable-like.
-        const candidate = dest?._writable ?? dest;
-        const hasWrite = typeof candidate?.write === "function";
-        const hasEnd = typeof candidate?.end === "function";
-        const hasOn = typeof candidate?.on === "function";
-        const hasOnce = typeof candidate?.once === "function";
-        const hasOff = typeof candidate?.off === "function";
-        if (!hasWrite || !hasEnd || (!hasOnce && !hasOn) || (!hasOff && !candidate?.removeListener)) {
+        // For event handling (drain, once, off), we need the object that emits events.
+        // For write/end, we must call the destination's own write()/end() methods,
+        // NOT the internal _writable, because Transform.write() has important logic
+        // (like auto-consume) that _writable.write() bypasses.
+        const eventTarget = dest;
+        const hasWrite = typeof dest?.write === "function";
+        const hasEnd = typeof dest?.end === "function";
+        const hasOn = typeof eventTarget?.on === "function";
+        const hasOnce = typeof eventTarget?.once === "function";
+        const hasOff = typeof eventTarget?.off === "function";
+        if (!hasWrite || !hasEnd || (!hasOnce && !hasOn) || (!hasOff && !eventTarget?.removeListener)) {
             throw new Error("Readable.pipe: invalid destination");
         }
-        const target = candidate;
-        this._pipeTo.push(target);
+        this._pipeTo.push(dest);
         // Create listeners that we can later remove
         const dataListener = (chunk) => {
-            const canWrite = target.write(chunk);
+            // Call destination's write() method (not internal _writable.write())
+            // This ensures Transform.write() logic runs properly
+            const canWrite = dest.write(chunk);
             if (!canWrite) {
                 this.pause();
-                if (typeof target.once === "function") {
-                    target.once("drain", () => this.resume());
+                if (typeof eventTarget.once === "function") {
+                    eventTarget.once("drain", () => this.resume());
                 }
                 else {
                     const resumeOnce = () => {
-                        if (typeof target.off === "function") {
-                            target.off("drain", resumeOnce);
+                        if (typeof eventTarget.off === "function") {
+                            eventTarget.off("drain", resumeOnce);
                         }
-                        else if (typeof target.removeListener === "function") {
-                            target.removeListener("drain", resumeOnce);
+                        else if (typeof eventTarget.removeListener === "function") {
+                            eventTarget.removeListener("drain", resumeOnce);
                         }
                         this.resume();
                     };
-                    target.on("drain", resumeOnce);
+                    eventTarget.on("drain", resumeOnce);
                 }
             }
         };
         const endListener = () => {
-            target.end();
+            dest.end();
         };
         const errorListener = (err) => {
-            if (typeof target.destroy === "function") {
-                target.destroy(err);
+            if (typeof dest.destroy === "function") {
+                dest.destroy(err);
             }
             else {
                 // Best-effort: forward error to the destination if it supports events.
-                target.emit?.("error", err);
+                eventTarget.emit?.("error", err);
             }
         };
         // Store listeners for later removal in unpipe
-        this._pipeListeners.set(target, {
+        this._pipeListeners.set(dest, {
             data: dataListener,
             end: endListener,
             error: errorListener
@@ -1401,6 +1404,8 @@ class Transform extends event_emitter_1.EventEmitter {
         this._autoConsumeEnded = false;
         /** @internal - promise that resolves when auto-consume finishes */
         this._autoConsumePromise = null;
+        /** @internal - list of piped destinations for forwarding auto-consumed data */
+        this._pipeDestinations = [];
         this.objectMode = options?.objectMode ?? false;
         const userTransform = options?.transform;
         const userFlush = options?.flush;
@@ -1667,10 +1672,18 @@ class Transform extends event_emitter_1.EventEmitter {
                 for await (const chunk of this._readable) {
                     // Buffer the data for later retrieval
                     this._autoConsumedBuffer.push(chunk);
+                    // Forward to any piped destinations
+                    for (const dest of this._pipeDestinations) {
+                        dest.write(chunk);
+                    }
                     // Also emit data event for listeners
                     this.emit("data", chunk);
                 }
                 this._autoConsumeEnded = true;
+                // End all piped destinations
+                for (const dest of this._pipeDestinations) {
+                    dest.end();
+                }
                 this.emit("end");
             }
             catch (err) {
@@ -1720,8 +1733,28 @@ class Transform extends event_emitter_1.EventEmitter {
      * Pipe to another stream (writable, transform, or duplex)
      */
     pipe(destination) {
-        // Mark as having consumer to prevent auto-consume conflict
+        // Mark as having consumer to prevent new auto-consume from starting
         this._hasDataConsumer = true;
+        // Get the writable target - handle both Transform (with internal _writable) and plain Writable
+        const dest = destination;
+        const target = dest?._writable ?? dest;
+        // Register destination for forwarding
+        this._pipeDestinations.push(target);
+        // If auto-consume is running or has run, we need to handle buffered data ourselves
+        if (this._readableConsuming) {
+            // Forward any buffered data from auto-consume to the destination
+            for (let i = 0; i < this._autoConsumedBuffer.length; i++) {
+                target.write(this._autoConsumedBuffer[i]);
+            }
+            // If auto-consume has ended, end the destination too
+            if (this._autoConsumeEnded) {
+                target.end();
+            }
+            // Don't call _readable.pipe() - auto-consume already consumed _readable
+            // Future data will be forwarded via the 'data' event listener below
+            return destination;
+        }
+        // No auto-consume running - use normal pipe through _readable
         return this._readable.pipe(destination);
     }
     /**

package/dist/esm/modules/archive/compress.base.js

@@ -13,6 +13,7 @@ import { ByteQueue } from "./byte-queue.js";
  * Default threshold (in bytes) to choose the lower-overhead path.
  *
  * This is a performance knob, not a correctness requirement.
+ * Default: 8MB.
  */
 export const DEFAULT_COMPRESS_THRESHOLD_BYTES = 8 * 1024 * 1024;
 /**

package/dist/esm/modules/archive/compress.browser.js

@@ -10,7 +10,7 @@
  * - Safari >= 14.1
  * - Edge >= 89
  */
-import { compressWithStream, decompressWithStream, hasDeflateRawCompressionStream, hasDeflateRawDecompressionStream, resolveCompressThresholdBytes } from "./compress.base.js";
+import { compressWithStream, decompressWithStream, hasDeflateRawCompressionStream, hasDeflateRawDecompressionStream } from "./compress.base.js";
 import { inflateRaw, deflateRawCompressed } from "./deflate-fallback.js";
 import { DEFAULT_COMPRESS_LEVEL } from "./defaults.js";
 // Re-export shared types
@@ -27,6 +27,9 @@ export function hasCompressionStream() {
 /**
  * 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
@@ -39,16 +42,15 @@ export function hasCompressionStream() {
  */
 export async function compress(data, options = {}) {
     const level = options.level ?? DEFAULT_COMPRESS_LEVEL;
-    const thresholdBytes = resolveCompressThresholdBytes(options);
     // Level 0 means no compression
     if (level === 0) {
         return data;
     }
-    // Use native CompressionStream only for larger inputs.
-    if (hasDeflateRawCompressionStream() && data.byteLength > thresholdBytes) {
+    // Always use native CompressionStream when available - it's much faster than JS
+    if (hasDeflateRawCompressionStream()) {
         return compressWithStream(data);
     }
-    // Fallback to pure JS implementation
+    // Fallback to pure JS implementation only when native is unavailable
     return deflateRawCompressed(data);
 }
 /**
@@ -70,16 +72,21 @@ export function compressSync(data, options = {}) {
 /**
  * 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 async function decompress(data, options = {}) {
-    const thresholdBytes = resolveCompressThresholdBytes(options);
-    // Use native DecompressionStream only for larger inputs.
-    if (hasDeflateRawDecompressionStream() && data.byteLength > thresholdBytes) {
+    void options;
+    // Always use native DecompressionStream when available - it's much faster than JS
+    if (hasDeflateRawDecompressionStream()) {
         return decompressWithStream(data);
     }
-    // Fallback to pure JS implementation
+    // Fallback to pure JS implementation only when native is unavailable
     return inflateRaw(data);
 }
 /**

package/dist/esm/modules/archive/parse.base.js

@@ -1,5 +1,5 @@
 import { parseDosDateTimeUTC, resolveZipLastModifiedDateFromUnixSeconds } from "./utils/timestamps.js";
-import { Duplex, PassThrough, Transform, concatUint8Arrays, pipeline } from "../stream/index.js";
+import { Duplex, PassThrough, Transform, concatUint8Arrays, pipeline, finished } from "../stream/index.js";
 import { parseTyped as parseBuffer } from "./utils/parse-buffer.js";
 import { ByteQueue } from "./byte-queue.js";
 import { indexOfUint8ArrayPattern } from "./utils/bytes.js";
@@ -499,8 +499,13 @@ export function streamUntilValidatedDataDescriptor(options) {
     queueMicrotask(pull);
     return output;
 }
+/**
+ * Default threshold for small file optimization (5MB).
+ */
+export const DEFAULT_PARSE_THRESHOLD_BYTES = 5 * 1024 * 1024;
 const endDirectorySignature = writeUint32LE(END_OF_CENTRAL_DIR_SIG);
-export async function runParseLoop(opts, io, emitter, inflateFactory, state) {
+export async function runParseLoop(opts, io, emitter, inflateFactory, state, inflateRawSync) {
+    const thresholdBytes = opts.thresholdBytes ?? DEFAULT_PARSE_THRESHOLD_BYTES;
     while (true) {
         const sigBytes = await io.pull(4);
         if (sigBytes.length === 0) {
@@ -514,7 +519,7 @@ export async function runParseLoop(opts, io, emitter, inflateFactory, state) {
             continue;
         }
         if (signature === LOCAL_FILE_HEADER_SIG) {
-            await readFileRecord(opts, io, emitter, inflateFactory, state);
+            await readFileRecord(opts, io, emitter, inflateFactory, state, thresholdBytes, inflateRawSync);
             continue;
         }
         if (signature === CENTRAL_DIR_HEADER_SIG) {
@@ -543,7 +548,7 @@ export async function runParseLoop(opts, io, emitter, inflateFactory, state) {
         return;
     }
 }
-async function readFileRecord(opts, io, emitter, inflateFactory, state) {
+async function readFileRecord(opts, io, emitter, inflateFactory, state, thresholdBytes, inflateRawSync) {
     const { vars: headerVars, fileNameBuffer, extraFieldData } = await readLocalFileHeader(async (l) => io.pull(l));
     const vars = headerVars;
     if (state.crxHeader) {
@@ -599,6 +604,35 @@ async function readFileRecord(opts, io, emitter, inflateFactory, state) {
             extraFields: entry.extraFields
         });
     }
+    // Small file optimization: use sync decompression if:
+    // 1. Entry sizes are trusted (no data descriptor)
+    // 2. File size is known and below threshold
+    // 3. inflateRawSync is provided
+    // 4. File needs decompression (compressionMethod != 0)
+    // 5. Not autodraining
+    //
+    // We require BOTH compressedSize and uncompressedSize <= thresholdBytes.
+    // This prevents materializing large highly-compressible files in memory,
+    // which can cause massive peak RSS and negate streaming backpressure.
+    const sizesTrusted = !hasDataDescriptorFlag(vars.flags);
+    const compressedSize = vars.compressedSize || 0;
+    const uncompressedSize = vars.uncompressedSize || 0;
+    const useSmallFileOptimization = sizesTrusted &&
+        fileSizeKnown &&
+        inflateRawSync &&
+        vars.compressionMethod !== 0 &&
+        !autodraining &&
+        compressedSize <= thresholdBytes &&
+        uncompressedSize <= thresholdBytes;
+    if (useSmallFileOptimization) {
+        // Read compressed data directly and decompress synchronously
+        const compressedData = await io.pull(compressedSize);
+        const decompressedData = inflateRawSync(compressedData);
+        entry.end(decompressedData);
+        // Wait for entry stream write to complete (not for read/consume)
+        await finished(entry, { readable: false });
+        return;
+    }
     const inflater = vars.compressionMethod && !autodraining ? inflateFactory() : new PassThrough();
     if (fileSizeKnown) {
         await pipeline(io.stream(vars.compressedSize || 0), inflater, entry);

package/dist/esm/modules/archive/parse.browser.js

@@ -341,7 +341,12 @@ export function createParseClass(createInflateRawFn) {
                 }
             };
             queueMicrotask(() => {
-                this._parsingDone = runParseLoop(this._opts, io, emitter, () => createInflateRawFn(), this._driverState);
+                // NOTE: We intentionally do NOT pass inflateRawSync to runParseLoop in browser.
+                // Browser's native DecompressionStream is faster than our pure-JS fallback,
+                // so we always use the streaming path for decompression in browsers.
+                this._parsingDone = runParseLoop(this._opts, io, emitter, () => createInflateRawFn(), this._driverState
+                // No inflateRawSync - always use streaming DecompressionStream in browser
+                );
                 this._parsingDone.catch((e) => {
                     if (!this.__emittedError || this.__emittedError !== e) {
                         this.__emittedError = e;

package/dist/esm/modules/archive/parse.js

@@ -50,7 +50,7 @@ export function createParseClass(createInflateRawFn) {
                 }
             };
             // Parse records as data arrives. Only emit `close` when parsing is complete.
-            runParseLoop(this._opts, io, emitter, createInflateRawFn, this._driverState).catch((e) => {
+            runParseLoop(this._opts, io, emitter, createInflateRawFn, this._driverState, (data) => zlib.inflateRawSync(data)).catch((e) => {
                 if (!this.__emittedError || this.__emittedError !== e) {
                     this.emit("error", e);
                 }

package/dist/esm/modules/excel/form-control.js

@@ -106,25 +106,63 @@ class FormCheckbox {
         let tl;
         let br;
         if (typeof range === "string") {
-            // Parse cell reference like "B2" or "B2:D3"
-            const decoded = colCache.decode(range);
-            if ("top" in decoded) {
-                // It's a range like "B2:D3"
-                tl = {
-                    col: decoded.left - 1, // Convert to 0-based
-                    colOff: DEFAULT_COL_OFF,
-                    row: decoded.top - 1,
-                    rowOff: DEFAULT_ROW_OFF
-                };
-                br = {
-                    col: decoded.right - 1,
-                    colOff: DEFAULT_END_COL_OFF,
-                    row: decoded.bottom - 1,
-                    rowOff: DEFAULT_END_ROW_OFF
-                };
+            // Parse cell reference like "B2" or range like "B2:D3"
+            const isRange = range.includes(":");
+            if (isRange) {
+                const decoded = colCache.decode(range);
+                if ("top" in decoded) {
+                    // Treat 1-cell ranges (e.g., "J4:J4") as a single cell with default checkbox size.
+                    if (decoded.left === decoded.right && decoded.top === decoded.bottom) {
+                        const col = decoded.left - 1;
+                        const row = decoded.top - 1;
+                        tl = {
+                            col,
+                            colOff: DEFAULT_COL_OFF,
+                            row,
+                            rowOff: DEFAULT_ROW_OFF
+                        };
+                        br = {
+                            col: col + 2,
+                            colOff: DEFAULT_END_COL_OFF,
+                            row: row + 1,
+                            rowOff: DEFAULT_END_ROW_OFF
+                        };
+                    }
+                    else {
+                        // Regular range
+                        tl = {
+                            col: decoded.left - 1, // Convert to 0-based
+                            colOff: DEFAULT_COL_OFF,
+                            row: decoded.top - 1,
+                            rowOff: DEFAULT_ROW_OFF
+                        };
+                        br = {
+                            col: decoded.right - 1,
+                            colOff: DEFAULT_END_COL_OFF,
+                            row: decoded.bottom - 1,
+                            rowOff: DEFAULT_END_ROW_OFF
+                        };
+                    }
+                }
+                else {
+                    // Defensive fallback: if the cache returns an address, treat it like a single-cell ref.
+                    tl = {
+                        col: decoded.col - 1,
+                        colOff: DEFAULT_COL_OFF,
+                        row: decoded.row - 1,
+                        rowOff: DEFAULT_ROW_OFF
+                    };
+                    br = {
+                        col: decoded.col + 1,
+                        colOff: DEFAULT_END_COL_OFF,
+                        row: decoded.row,
+                        rowOff: DEFAULT_END_ROW_OFF
+                    };
+                }
             }
             else {
                 // Single cell reference - create default size checkbox
+                const decoded = colCache.decodeAddress(range);
                 tl = {
                     col: decoded.col - 1,
                     colOff: DEFAULT_COL_OFF,