@zip.js/zip.js 2.11.2 → 2.11.3

package/BENCHMARKS.md

@@ -33,7 +33,7 @@ should not trust anyone's benchmark (including this one) without reproducing it.
 | jszip | 3.10.1 |
 | fflate | 0.8.3 |
 | archiver | 8.0.0 |
-| Measured | 2026-09-06, except the 7-Zip section (see its own note) |
+| Measured | 2026-09-06 — the 7-Zip section under Deno 2.9.6, everything else on Node |
 
 ## Method
 
@@ -127,6 +127,11 @@ level (e.g. `{ level: 5 }`) makes zip.js fall back to the WASM zlib codec — wh
 the table, does not parallelize via concurrent `add()`. Keep the default level to keep
 the native-backend parallelism, or pair a custom level with Web Workers (below).
 
+That fallback costs more than a backend switch, and the
+[frontier](#the-frontier--one-axis-both-sides) measures how much: how much speed a lower
+level actually buys depends on how fast the host's own zlib is, and on Deno it buys
+nothing at all — `level: 5` there is slower *and* larger than the default.
+
 ### Parallelism is runtime-dependent
 
 The table above is measured on **Node**, and its "no Web Workers needed" result does
@@ -237,50 +242,153 @@ avoid jszip.
 
 How far is zip.js from a native archiver? [`benchmarks/bench-7z.js`](benchmarks/bench-7z.js)
 compares it against the `7zz` CLI (7-Zip 25.01), disk-to-disk on both sides, under Deno
-2.9.3 and Bun 1.3.14 (both runtimes agree within noise; Deno numbers shown). 7-Zip
-timings include process spawn (~ms). Unlike the tables above, this section and the next
-were measured in July 2026 with zip.js 2.8.29 and have not been re-run; they compare
-zip.js against tools that have not changed, so they age slowly, but treat the zip.js
-columns as a floor rather than as current.
-
-One comparison is impossible to make perfectly fair: **no 7-Zip preset runs zlib's
-algorithm.** `-mx=5+` is a near-optimal parser (much slower, smaller output) and
-`-mx=1..4` a greedy one (faster, larger output) — they bracket zlib level 6. So the
-table carries two anchors: `-mx=6` as the *ratio* anchor and `-mx=1` as the *speed*
-anchor. On this machine the `-mx` ladder on the 256 MB file reads: `-mx=1/3` → 5.9 s,
-`-mx=5/6` → 34 s, `-mx=7` → 85 s — the 6× jump at `-mx=5` is the switch from greedy
-matching to optimal parsing, and it cannot be hidden by threads (one file = one deflate
-stream = one core).
-
-| Workload (compress) | zip.js (workers) | 7-Zip `-mx=6` (mt) | 7-Zip `-mx=1` (mt) |
-|---|--:|--:|--:|
-| Compressible text (20 MB) | **426 ms** / 6.2 MB | 2606 ms / 5.8 MB | 470 ms / 6.8 MB |
-| Incompressible data (20 MB) | **342 ms** | 410 ms | 372 ms |
-| 5,000 files × ~2 KB | 780 ms / 5.5 MB | 199 ms / 4.9 MB | **168 ms** / 5.0 MB |
-| Large file, disk-to-disk (256 MB) | **5.5 s** / 79.5 MB | 33.4 s / 73.6 MB | 5.9 s / 86.7 MB |
+2.9.6. 7-Zip timings include process spawn (~ms).
 
-| Workload (decompress) | zip.js (workers) | 7-Zip (mt) |
-|---|--:|--:|
-| Compressible text (20 MB) | **69 ms** | 88 ms |
-| 5,000 files × ~2 KB | 976 ms | **471 ms** |
-
-- **On single-file streaming, zip.js strictly dominates 7-Zip's speed tier**: a bit
-  faster *and* ~9 % smaller output, because zlib-6's lazy matching is a better
-  speed/ratio point than 7-Zip's greedy fast mode. What `-mx=6` buys for its 6× time is
-  ~7 % more compression — a trade zip.js cannot make, but also one most workloads don't
-  want.
-- **7-Zip legitimately dominates many small files** (~4× on compress, ~2× on
-  decompress): its per-entry cost is near zero, while zip.js pays per-entry
-  orchestration (worker round trips, header writes, one output stream per extracted
-  file). Same lesson as the fflate rows above — tiny-entry workloads are zip.js's cost
-  center, and the codec backend is irrelevant there.
+**No 7-Zip preset runs zlib's algorithm**, so `-mx=6` and level 6 are not the same request
+and a table pairing them by digit is measuring two things at once. This section therefore
+has two parts: the defaults against each other, and then a frontier that varies *one* axis,
+the compression level, on **both** sides at a fixed core budget.
+
+### Defaults against defaults
+
+Level 6 and `-mx=6`, i.e. what each tool does when you do not tune it. Every contender the
+harness measures is listed; time / output size.
+
+| Workload (compress) | zip.js (1 thread) | zip.js (workers) | 7-Zip (1 thread) | 7-Zip `-mx=6` (mt) | 7-Zip `-mx=1` (mt) |
+|---|--:|--:|--:|--:|--:|
+| Compressible text (20 MB) | **418 ms** / 6.2 MB | 428 ms / 6.2 MB | — | 2540 ms / 5.8 MB | 444 ms / 6.8 MB |
+| Incompressible data (20 MB) | **321 ms** / 21.0 MB | 333 ms / 21.0 MB | — | 418 ms / 21.0 MB | 353 ms / 21.0 MB |
+| 8 files × 8 MB | 1308 ms / 19.9 MB | 308 ms / 19.9 MB | 8102 ms / 18.4 MB | 1510 ms / 18.4 MB | **294 ms** / 21.7 MB |
+| 5,000 files × ~2 KB | 1245 ms / 5.2 MB | 825 ms / 5.2 MB | 580 ms / 4.9 MB | 193 ms / 4.9 MB | **173 ms** / 5.0 MB |
+| Large file, disk-to-disk (256 MB) | **5.4 s** / 79.5 MB | 5.5 s / 79.5 MB | — | 33.4 s / 73.6 MB | 5.8 s / 86.7 MB |
+
+| Workload (decompress) | zip.js (1 thread) | zip.js (workers) | 7-Zip (1 thread) | 7-Zip (mt) |
+|---|--:|--:|--:|--:|
+| Compressible text (20 MB) | 83 ms | **61 ms** | — | 81 ms |
+| 8 files × 8 MB | 181 ms | **83 ms** | 241 ms | 247 ms |
+| 5,000 files × ~2 KB | 989 ms | 906 ms | 491 ms | **462 ms** |
+
+`7-Zip (1 thread)` is only listed where it means something: a single file is one deflate
+stream, so `-mmt` changes nothing there and the two 7-Zip columns would measure the same
+run. That is also why zip.js's worker pool does nothing on the single-file rows — the
+parallelism both tools have is *between* entries, never inside one.
+
+### The frontier — one axis, both sides
+
+Levels 1–9 on the zip.js side against `-mx=1,3,5,6,7,9` on the 7-Zip side, sorted by output
+size. A tool is faster than another only where it is faster **at the same size**, and
+`frontier` marks a row that nothing smaller beats on time.
+
+**One thread, one deflate stream on both sides** — 20 MB of text:
+
+| Encoder | Output | Ratio | Time | |
+|---|--:|--:|--:|---|
+| 7-Zip `-mx=9` | 5.7 MB | 3.665 | 14889 ms | frontier |
+| 7-Zip `-mx=7` | 5.7 MB | 3.665 | 6643 ms | frontier |
+| 7-Zip `-mx=5` | 5.8 MB | 3.646 | 2597 ms | frontier |
+| 7-Zip `-mx=6` | 5.8 MB | 3.646 | 2605 ms | |
+| zip.js level 8 | 6.1 MB | 3.429 | 1537 ms | frontier |
+| zip.js level 9 | 6.1 MB | 3.429 | 1544 ms | |
+| zip.js level 7 | 6.1 MB | 3.421 | 1305 ms | frontier |
+| **zip.js level 6 (default)** | 6.2 MB | 3.377 | **418 ms** | frontier |
+| zip.js level 5 | 6.6 MB | 3.196 | 590 ms | |
+| 7-Zip `-mx=1` | 6.8 MB | 3.096 | 458 ms | |
+| 7-Zip `-mx=3` | 6.8 MB | 3.096 | 453 ms | |
+| zip.js level 4 | 6.9 MB | 3.036 | 358 ms | frontier |
+| zip.js level 3 | 7.0 MB | 2.975 | 420 ms | |
+| zip.js level 2 | 7.4 MB | 2.850 | 266 ms | frontier |
+| zip.js level 1 | 7.5 MB | 2.785 | 239 ms | frontier |
+
+**The same 20 MB, one thread, but on Node** — because the zip.js side of that table is not
+one codec. Level 6 is the host's `CompressionStream`, so it changes with the runtime; every
+other level is the bundled WASM codec, which does not (its output is byte-identical on both
+and its times agree within 5 %):
+
+| Encoder | Output | Ratio | Time | |
+|---|--:|--:|--:|---|
+| 7-Zip `-mx=9` | 5.7 MB | 3.665 | 14904 ms | frontier |
+| 7-Zip `-mx=7` | 5.7 MB | 3.665 | 6548 ms | frontier |
+| 7-Zip `-mx=5` | 5.8 MB | 3.646 | 2535 ms | frontier |
+| 7-Zip `-mx=6` | 5.8 MB | 3.646 | 2553 ms | |
+| zip.js level 8 | 6.1 MB | 3.429 | 1474 ms | frontier |
+| zip.js level 9 | 6.1 MB | 3.429 | 1476 ms | |
+| **zip.js level 6 (default)** | 6.1 MB | 3.426 | **696 ms** | frontier |
+| zip.js level 7 | 6.1 MB | 3.421 | 1238 ms | |
+| zip.js level 5 | 6.6 MB | 3.196 | 514 ms | frontier |
+| 7-Zip `-mx=1` | 6.8 MB | 3.096 | 447 ms | frontier |
+| 7-Zip `-mx=3` | 6.8 MB | 3.096 | 445 ms | frontier |
+| zip.js level 4 | 6.9 MB | 3.036 | 304 ms | frontier |
+| zip.js level 3 | 7.0 MB | 2.975 | 375 ms | |
+| zip.js level 2 | 7.4 MB | 2.850 | 221 ms | frontier |
+| zip.js level 1 | 7.5 MB | 2.785 | 200 ms | frontier |
+
+**Every core, both sides** — 8 files × 8 MB, on Deno. It has to be Deno: Node exposes no
+global `Worker`, so `useWebWorkers` cannot spawn one there and only the default level —
+which rides the platform threadpool instead — parallelizes at all. Measured on Node the
+same table reads 617 ms at level 6 against 4090 ms at level 7, i.e. the WASM levels run
+serially, which would make it a comparison of 7-Zip on 8 cores against zip.js on 1.
+
+| Encoder | Output | Ratio | Time | |
+|---|--:|--:|--:|---|
+| 7-Zip `-mx=9` | 18.3 MB | 3.660 | 8625 ms | frontier |
+| 7-Zip `-mx=7` | 18.3 MB | 3.660 | 3796 ms | frontier |
+| 7-Zip `-mx=5` | 18.4 MB | 3.645 | 1510 ms | frontier |
+| 7-Zip `-mx=6` | 18.4 MB | 3.645 | 1540 ms | |
+| zip.js level 9 | 19.6 MB | 3.428 | 971 ms | frontier |
+| zip.js level 8 | 19.6 MB | 3.428 | 991 ms | |
+| zip.js level 7 | 19.6 MB | 3.420 | 852 ms | frontier |
+| **zip.js level 6 (default)** | 19.9 MB | 3.376 | **317 ms** | frontier |
+| zip.js level 5 | 21.0 MB | 3.196 | 405 ms | |
+| 7-Zip `-mx=3` | 21.7 MB | 3.096 | 309 ms | frontier |
+| 7-Zip `-mx=1` | 21.7 MB | 3.096 | 313 ms | |
+| zip.js level 4 | 22.1 MB | 3.037 | 287 ms | frontier |
+| zip.js level 3 | 22.6 MB | 2.975 | 316 ms | |
+| zip.js level 2 | 23.6 MB | 2.849 | 239 ms | frontier |
+| zip.js level 1 | 24.1 MB | 2.784 | 218 ms | frontier |
+
+What the two curves say:
+
+- **zip.js's default is a spike on its own curve, because it is a different codec.** The
+  platform's `CompressionStream` exposes no level control, so **level 6 runs the host's
+  native zlib and every other level drops onto the bundled WASM one**. How big the spike is
+  therefore depends on whose zlib the host ships: 418 ms at ratio 3.377 on Deno's zlib-ng,
+  696 ms at 3.426 on Node's Chromium zlib — ~1.7× faster and ~1.4 % looser.
+- **So whether a lower level buys anything is runtime-dependent, and on Deno it does not.**
+  On Node, `level: 5` costs 514 ms against the default's 696 ms: the ordinary trade, 26 %
+  faster for 7 % more bytes. On Deno the default is already 418 ms, so the same `level: 5`
+  takes 590 ms and produces a *larger* archive — **slower and bigger, strictly worse**. If
+  you reach for a lower level to go faster, measure it on your runtime first.
+- **One level is a bad deal everywhere: `level: 3` loses to `level: 4`** on both time and
+  size (375 ms / 7.0 MB against 304 ms / 6.9 MB on Node; 420 ms against 358 ms on Deno).
+  Both are the same WASM codec, so this one is zlib's own curve, not a fallback artifact.
+- **7-Zip's nine presets are three encoders.** `-mx=1` and `-mx=3` are identical, so are
+  `-mx=5`/`-mx=6` and `-mx=7`/`-mx=9` — **`-mx=9` costs 2.3× the time of `-mx=7` for
+  byte-identical output**. The 5.7× jump from `-mx=3` to `-mx=5` is greedy matching giving
+  way to optimal parsing, and threads cannot hide it.
+- **Against the greedy tier zip.js wins outright.** Single-threaded it is 418 ms / 6.2 MB
+  against 453–458 ms / 6.8 MB: faster *and* 9 % smaller than both `-mx=1` and `-mx=3`. On
+  all cores it ties them on time (317 ms against 309 ms) and is still 8 % smaller.
+- **Against the optimal-parsing tier it has nothing**, at any level. 7-Zip's cheapest route
+  to 3.6 costs 1510 ms where zip.js's best is 971 ms at 3.43; buying that last 6 % of ratio
+  costs 4.8× the default's time. That is a real limit of DEFLATE-as-zlib-writes-it, not a
+  tuning gap.
+- **Threading buys the two sides different amounts**: 4.2× for zip.js on 8 × 8 MB
+  (1308 → 308 ms) against 5.4× for 7-Zip (8102 → 1510 ms). zip.js closes most of that gap
+  because it starts from a much faster single-threaded number.
+- **7-Zip legitimately dominates many small files** (~4× on compress, ~2× on decompress):
+  its per-entry cost is near zero, while zip.js pays per-entry orchestration. Same lesson
+  as the fflate rows above — tiny-entry workloads are zip.js's cost center, and the codec
+  is irrelevant there. Note the reverse on 8 × 8 MB decompression, where entries are large
+  enough for the pool to pay off: 83 ms against 247 ms, zip.js ~3× faster.
 
 ## The runtime's zlib decides zip.js throughput
 
 On bulk data zip.js is a thin wrapper around the platform's `CompressionStream` — it
 adds ~7 % over the raw encoder on the 256 MB stream. That means throughput is decided
 by **which zlib the runtime vendors**, and they differ a lot. Same 256 MB compressible
-file, one thread, level-6-class output everywhere:
+file, one thread, level-6-class output everywhere. This is the one table on this page
+still carrying its July 2026 measurement: it compares runtimes to each other rather than
+zip.js to anything, so it ages with their zlib and not with ours.
 
 | Encoder | Time | Output |
 |---|--:|--:|

package/deno.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zip-js/zip-js",
-	"version": "2.11.2",
+	"version": "2.11.3",
 	"exports": {
 		".": "./index.js",
 		"./external": "./lib/zip-fs-external.js",

package/dist/zip-core-external.js

@@ -6277,6 +6277,7 @@ const ERR_INVALID_ENTRY_NAME = "File entry name exceeds 64KB";
 const ERR_INVALID_VERSION = "Version exceeds 65535";
 const ERR_INVALID_ENCRYPTION_STRENGTH = "The strength must equal 1, 2, or 3";
 const ERR_UNSUPPORTED_ENCRYPTION_USDZ = "Encryption is not supported in USDZ files";
+const ERR_UNSUPPORTED_SPLIT_USDZ = "Split zip files are not supported in USDZ files";
 const ERR_UNSUPPORTED_ENCRYPTION_PASS_THROUGH = "Encryption is not supported when the 'passThrough' option is set";
 const ERR_INVALID_EXTRAFIELD = "Invalid extra field (must be a Map)";
 const ERR_INVALID_EXTRAFIELD_TYPE = "Invalid extra field type (must be integer 0..65535)";
@@ -6291,6 +6292,7 @@ const ERR_UNDEFINED_UNCOMPRESSED_SIZE = "Undefined uncompressed size";
 const ERR_UNDEFINED_COMPRESSION_METHOD = "Undefined compression method";
 const ERR_UNDETERMINED_SIZE = "Undetermined size";
 const ERR_UNDEFINED_READER = "Undefined reader";
+const ERR_INVALID_READER = "Invalid reader (must be a Reader instance, a ReadableStream instance, or an object with a 'readable' property)";
 const ERR_ZIP_NOT_EMPTY = "Zip file not empty";
 const ERR_INVALID_UID = "Invalid uid (must be integer 0..2^32-1)";
 const ERR_INVALID_GID = "Invalid gid (must be integer 0..2^32-1)";
@@ -6322,6 +6324,9 @@ class ZipWriter {
 		const addSplitZipSignature =
 			availableSize > 0 && availableSize !== INFINITY_VALUE &&
 			maxSize > 0 && maxSize !== INFINITY_VALUE;
+		if (addSplitZipSignature && options[OPTION_USDZ]) {
+			throw new Error(ERR_UNSUPPORTED_SPLIT_USDZ);
+		}
 		Object.assign(this, {
 			writer,
 			addSplitZipSignature,
@@ -6437,6 +6442,7 @@ class ZipWriter {
 				}
 				const { offset, diskNumberStart } = entryPositions.get(entry);
 				Object.assign(entry, {
+					zip64Enabled: true,
 					zip64UncompressedSize,
 					zip64CompressedSize,
 					offset,
@@ -7012,6 +7018,9 @@ async function resolveSizes(zipWriter, reader, { resolvedOptions: metadata }, op
 	if (reader) {
 		reader = new GenericReader(reader);
 		await initStream(reader);
+		if (!reader.readable && !reader.readUint8Array) {
+			throw new Error(ERR_INVALID_READER);
+		}
 		({ size: contentSize } = reader);
 	}
 	return Object.assign({ reader }, resolveEntrySizes(zipWriter, Boolean(reader), contentSize, metadata, options));
@@ -7022,6 +7031,7 @@ function resolveEntrySizes(zipWriter, hasContent, contentSize, metadata, options
 	let { dataDescriptor, zip64, level, compressionMethod } = metadata;
 	let maximumCompressedSize = 0;
 	let uncompressedSize = 0;
+	let unknownSize = false;
 	if (passThrough && hasContent) {
 		uncompressedSize = options[PROPERTY_NAME_UNCOMPRESSED_SIZE];
 		if (uncompressedSize === UNDEFINED_VALUE) {
@@ -7047,8 +7057,8 @@ function resolveEntrySizes(zipWriter, hasContent, contentSize, metadata, options
 			if (contentSize === UNDEFINED_VALUE) {
 				dataDescriptor = true;
 				if (zip64 || zip64 === UNDEFINED_VALUE) {
-					zip64 = true;
-					uncompressedSize = maximumCompressedSize = MAX_32_BITS + 1;
+					zip64 = unknownSize = true;
+					maximumCompressedSize = MAX_32_BITS + 1;
 				}
 			} else {
 				options.uncompressedSize = uncompressedSize = contentSize;
@@ -7063,7 +7073,7 @@ function resolveEntrySizes(zipWriter, hasContent, contentSize, metadata, options
 	if (emptyEntry && !zipCrypto && getOptionValue(zipWriter, options, OPTION_DATA_DESCRIPTOR) === UNDEFINED_VALUE) {
 		dataDescriptor = false;
 	}
-	const zip64UncompressedSize = zip64Enabled || uncompressedSize >= MAX_32_BITS;
+	const zip64UncompressedSize = zip64Enabled || unknownSize || uncompressedSize >= MAX_32_BITS;
 	const zip64CompressedSize = zip64Enabled || maximumCompressedSize >= MAX_32_BITS;
 	if (zip64UncompressedSize || zip64CompressedSize) {
 		if (zip64 === false) {
@@ -7079,6 +7089,8 @@ function resolveEntrySizes(zipWriter, hasContent, contentSize, metadata, options
 			dataDescriptor,
 			emptyEntry,
 			zip64,
+			zip64Enabled,
+			unknownSize,
 			zip64UncompressedSize,
 			zip64CompressedSize,
 			uncompressedSize,
@@ -7277,6 +7289,7 @@ async function createFileEntry(reader, writer, { diskNumberStart, lockFileEntry
 		rawPassword,
 		level,
 		zip64,
+		zip64Enabled,
 		zip64UncompressedSize,
 		zip64CompressedSize,
 		zipCrypto,
@@ -7317,6 +7330,7 @@ async function createFileEntry(reader, writer, { diskNumberStart, lockFileEntry
 		lockFileEntry,
 		versionMadeBy,
 		zip64,
+		zip64Enabled,
 		directory: Boolean(directory),
 		executable: Boolean(executable),
 		filenameUTF8: true,
@@ -7460,13 +7474,14 @@ function getHeaderInfo(options) {
 		zip64UncompressedSize,
 		zip64CompressedSize,
 		uncompressedSize,
+		unknownSize,
 		crc32
 	} = options;
 	let { version, compressionMethod } = options;
 	const compressed = !directory && isCompressed(compressionMethod, level);
 	let rawLocalExtraFieldZip64;
 	const uncompressedFile = passThrough || !compressed;
-	const zip64ExtraFieldComplete = zip64 && (options.bufferedWrite || !dataDescriptor || ((!zip64UncompressedSize && !zip64CompressedSize) || uncompressedFile));
+	const zip64ExtraFieldComplete = zip64 && (options.bufferedWrite || !dataDescriptor || ((!zip64UncompressedSize && !zip64CompressedSize) || (uncompressedFile && !unknownSize)));
 	const writeLocalExtraFieldZip64 = zip64ExtraFieldComplete || (zip64 && dataDescriptor && (zip64UncompressedSize || zip64CompressedSize));
 	if (zip64 && (zip64UncompressedSize || zip64CompressedSize)) {
 		const length = 4 + 16;
@@ -7600,6 +7615,10 @@ function getHeaderInfo(options) {
 		throw new Error(ERR_INVALID_EXTRAFIELD_DATA);
 	}
 	const dosLastModDate = new Date(Math.ceil(Math.floor(lastModDate.getTime() / 1000) / 2) * 2000);
+	const clampedLastModDate = dosLastModDate < MIN_DATE ? MIN_DATE : dosLastModDate > MAX_DATE ? MAX_DATE : dosLastModDate;
+	const storedLastModDate = getLength(rawExtraFieldExtendedTimestamp) ?
+		new Date(getTimeUnix(lastModDate) * 1000) :
+		getLength(rawExtraFieldNTFS) ? lastModDate : clampedLastModDate;
 	const {
 		headerArray,
 		headerView,
@@ -7609,7 +7628,7 @@ function getHeaderInfo(options) {
 		bitFlag: getBitFlag(level, useUnicodeFileNames, dataDescriptor, encrypted, compressionMethod),
 		compressionMethod,
 		uncompressedSize,
-		lastModDate: dosLastModDate < MIN_DATE ? MIN_DATE : dosLastModDate > MAX_DATE ? MAX_DATE : dosLastModDate,
+		lastModDate: clampedLastModDate,
 		rawLastModDate: rawLastModDateOption,
 		rawFilename,
 		zip64CompressedSize,
@@ -7644,7 +7663,7 @@ function getHeaderInfo(options) {
 		localHeaderView,
 		headerArray,
 		headerView,
-		lastModDate,
+		lastModDate: storedLastModDate,
 		rawLastModDate,
 		encrypted,
 		compressed,
@@ -7816,14 +7835,15 @@ function updateLocalHeader({
 
 
 async function closeFile(zipWriter, comment, options) {
-	const directoryDataLength = createDirectoryRecords(zipWriter.fileEntries);
+	const { directoryDataLength, zip64Entries } = createDirectoryRecords(zipWriter.fileEntries);
 	const { directoryStart, directoryEnd, directoryArray } = await writeDirectoryRecords(zipWriter, directoryDataLength, options);
 	const signatureLength = await writeDigitalSignatureRecord(zipWriter, directoryArray, options);
-	await writeEndOfDirectoryRecord(zipWriter, comment, options, { directoryStart, directoryEnd, directoryDataLength, signatureLength });
+	await writeEndOfDirectoryRecord(zipWriter, comment, options, { directoryStart, directoryEnd, directoryDataLength, signatureLength, zip64Entries });
 }
 
 function createDirectoryRecords(files) {
 	let directoryDataLength = 0;
+	let zip64Entries = false;
 	for (const [, fileEntry] of files) {
 		const {
 			rawFilename,
@@ -7836,11 +7856,20 @@ function createDirectoryRecords(files) {
 			extendedTimestamp,
 			extraFieldExtendedTimestampFlag,
 			lastModDate,
-			zip64UncompressedSize,
-			zip64CompressedSize,
+			zip64Enabled,
 			uncompressedSize,
 			compressedSize
 		} = fileEntry;
+		let { zip64UncompressedSize, zip64CompressedSize } = fileEntry;
+		if (!zip64Enabled) {
+			if (zip64UncompressedSize && uncompressedSize < MAX_32_BITS) {
+				zip64UncompressedSize = fileEntry.zip64UncompressedSize = false;
+			}
+			if (zip64CompressedSize && compressedSize < MAX_32_BITS) {
+				zip64CompressedSize = fileEntry.zip64CompressedSize = false;
+			}
+		}
+		zip64Entries = zip64Entries || zip64UncompressedSize || zip64CompressedSize;
 		const zip64Offset = fileEntry.offset >= MAX_32_BITS;
 		const zip64DiskNumberStart = fileEntry.diskNumberStart >= MAX_16_BITS;
 		let rawExtraFieldZip64;
@@ -7894,7 +7923,7 @@ function createDirectoryRecords(files) {
 		}
 		directoryDataLength += CENTRAL_FILE_HEADER_LENGTH + getLength(rawFilename, rawComment) + extraFieldLength;
 	}
-	return directoryDataLength;
+	return { directoryDataLength, zip64Entries };
 }
 
 async function writeDirectoryRecords(zipWriter, directoryDataLength, options) {
@@ -8014,7 +8043,7 @@ async function writeDigitalSignatureRecord(zipWriter, directoryArray, options) {
 
 async function writeEndOfDirectoryRecord(zipWriter, comment, options, cdInfo) {
 	const { writer } = zipWriter;
-	const { directoryStart, directoryEnd, signatureLength } = cdInfo;
+	const { directoryStart, directoryEnd, signatureLength, zip64Entries } = cdInfo;
 	let { directoryDataLength } = cdInfo;
 	let fileEntriesLength = zipWriter.fileEntries.size;
 	let diskNumber = directoryStart.diskNumber;
@@ -8034,6 +8063,8 @@ async function writeEndOfDirectoryRecord(zipWriter, comment, options, cdInfo) {
 		} else {
 			zip64 = true;
 		}
+	} else if (zip64 === UNDEFINED_VALUE && zip64Entries) {
+		zip64 = true;
 	}
 	const endOfdirectoryRecord = createRecordWriter(zip64 ? ZIP64_END_OF_CENTRAL_DIR_TOTAL_LENGTH : END_OF_CENTRAL_DIR_LENGTH);
 	if (exceedsAvailableSize(writer, getLength(endOfdirectoryRecord.array) + commentLength)) {
@@ -8537,7 +8568,7 @@ function formatSupported(StreamClass, format) {
  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
-const VERSION = "2.11.2";
+const VERSION = "2.11.3";
 
 /*
  Copyright (c) 2025 Gildas Lormeau. All rights reserved.
@@ -9368,4 +9399,4 @@ function terminateWorkersAndModule() {
 
 configureExternalAssets();
 
-export { BlobReader, BlobWriter, Data64URIReader, Data64URIWriter, ERR_AMBIGUOUS_ARCHIVE, ERR_BAD_FORMAT, ERR_CENTRAL_DIRECTORY_NOT_FOUND, ERR_DUPLICATED_NAME, ERR_ENCRYPTED, ERR_ENCRYPTED_CENTRAL_DIRECTORY, ERR_ENTRY_DATA_OUT_OF_BOUNDS, ERR_EOCDR_LOCATOR_ZIP64_NOT_FOUND, ERR_EOCDR_NOT_FOUND, ERR_EXTRAFIELD_ZIP64_NOT_FOUND, ERR_HTTP_RANGE, ERR_HTTP_RESOURCE_CHANGED, ERR_INVALID_AUTHENTICATION_CODE, ERR_INVALID_CODEC_DEFINITION, ERR_INVALID_CODEC_MODULE, ERR_INVALID_COMMENT, ERR_INVALID_COMMENT_TYPE, ERR_INVALID_COMPRESSED_DATA, ERR_INVALID_CRC32, ERR_INVALID_DATE, ERR_INVALID_ENCRYPTION_STRENGTH, ERR_INVALID_ENTRY_COMMENT, ERR_INVALID_ENTRY_COMMENT_TYPE, ERR_INVALID_ENTRY_NAME, ERR_INVALID_EXTRAFIELD, ERR_INVALID_EXTRAFIELD_DATA, ERR_INVALID_EXTRAFIELD_DATA_TYPE, ERR_INVALID_EXTRAFIELD_TYPE, ERR_INVALID_FILENAME_VALIDATION, ERR_INVALID_FUNCTION_OPTION, ERR_INVALID_GID, ERR_INVALID_LEVEL, ERR_INVALID_MAX_APPENDED_DATA_SIZE, ERR_INVALID_MAX_WORKERS, ERR_INVALID_MSDOS_ATTRIBUTES, ERR_INVALID_MSDOS_DATA, ERR_INVALID_PASSWORD, ERR_INVALID_PASSWORD_TYPE, ERR_INVALID_SIGNAL, ERR_INVALID_SIGNATURE_DATA, ERR_INVALID_STRICTNESS, ERR_INVALID_UID, ERR_INVALID_UNCOMPRESSED_SIZE, ERR_INVALID_UNIX_EXTRA_FIELD_TYPE, ERR_INVALID_UNIX_ID_SIZE, ERR_INVALID_UNIX_MODE, ERR_INVALID_VERSION, ERR_ITERATOR_COMPLETED_TOO_SOON, ERR_LOCAL_FILE_HEADER_NOT_FOUND, ERR_OVERLAPPING_ENTRY, ERR_RESERVED_COMPRESSION_METHOD, ERR_SPLIT_ZIP_FILE, ERR_UNDEFINED_COMPRESSION_METHOD, ERR_UNDEFINED_READER, ERR_UNDEFINED_UNCOMPRESSED_SIZE, ERR_UNDETERMINED_SIZE, ERR_UNSAFE_FILENAME, ERR_UNSUPPORTED_COMPRESSION, ERR_UNSUPPORTED_CONTEXT, ERR_UNSUPPORTED_CRYPTO_API, ERR_UNSUPPORTED_ENCRYPTION, ERR_UNSUPPORTED_ENCRYPTION_PASS_THROUGH, ERR_UNSUPPORTED_ENCRYPTION_USDZ, ERR_UNSUPPORTED_FORMAT, ERR_UNSUPPORTED_UINT64, ERR_WORKER_STARTUP_TIMEOUT, ERR_WRITER_NOT_INITIALIZED, ERR_ZIP_NOT_EMPTY, HttpRangeReader, HttpReader, Reader, SplitDataReader, SplitDataWriter, TextReader, TextWriter, Uint8ArrayReader, Uint8ArrayWriter, VERSION, WARNING_APPENDED_DATA, WARNING_COMPRESSED_PATCHED_DATA, WARNING_DUPLICATE_FILENAME, WARNING_MALFORMED_EXTRA_FIELD, WARNING_MISMATCHED_LOCAL_FILE_HEADER_BIT_FLAG, WARNING_MISMATCHED_LOCAL_FILE_HEADER_COMPRESSION_METHOD, WARNING_MISMATCHED_LOCAL_FILE_HEADER_CRC32_OR_SIZES, WARNING_MISMATCHED_ZIP64_END_OF_CENTRAL_DIRECTORY, WARNING_PREPENDED_CENTRAL_DIRECTORY, WARNING_PREPENDED_DATA, WARNING_TRAILING_CENTRAL_DIRECTORY_DATA, WARNING_UNKNOWN_VERSION, WARNING_UNKNOWN_ZIP64_EXTENSIBLE_DATA, WARNING_UNSORTED_CENTRAL_DIRECTORY, WARNING_WRAPPED_ENTRIES_COUNT, Writer, ZipReader, ZipReaderStream, ZipWriter, ZipWriterStream, configure, createBlobTempStream, createOPFSTempStream, createSyncAccessHandleTempStream, getMimeType, getRegisteredCodecs, getSupportedCompressionMethods, isZipFile, registerCodec, resetConfiguration, terminateWorkersAndModule as terminateWorkers, unregisterCodec };
+export { BlobReader, BlobWriter, Data64URIReader, Data64URIWriter, ERR_AMBIGUOUS_ARCHIVE, ERR_BAD_FORMAT, ERR_CENTRAL_DIRECTORY_NOT_FOUND, ERR_DUPLICATED_NAME, ERR_ENCRYPTED, ERR_ENCRYPTED_CENTRAL_DIRECTORY, ERR_ENTRY_DATA_OUT_OF_BOUNDS, ERR_EOCDR_LOCATOR_ZIP64_NOT_FOUND, ERR_EOCDR_NOT_FOUND, ERR_EXTRAFIELD_ZIP64_NOT_FOUND, ERR_HTTP_RANGE, ERR_HTTP_RESOURCE_CHANGED, ERR_INVALID_AUTHENTICATION_CODE, ERR_INVALID_CODEC_DEFINITION, ERR_INVALID_CODEC_MODULE, ERR_INVALID_COMMENT, ERR_INVALID_COMMENT_TYPE, ERR_INVALID_COMPRESSED_DATA, ERR_INVALID_CRC32, ERR_INVALID_DATE, ERR_INVALID_ENCRYPTION_STRENGTH, ERR_INVALID_ENTRY_COMMENT, ERR_INVALID_ENTRY_COMMENT_TYPE, ERR_INVALID_ENTRY_NAME, ERR_INVALID_EXTRAFIELD, ERR_INVALID_EXTRAFIELD_DATA, ERR_INVALID_EXTRAFIELD_DATA_TYPE, ERR_INVALID_EXTRAFIELD_TYPE, ERR_INVALID_FILENAME_VALIDATION, ERR_INVALID_FUNCTION_OPTION, ERR_INVALID_GID, ERR_INVALID_LEVEL, ERR_INVALID_MAX_APPENDED_DATA_SIZE, ERR_INVALID_MAX_WORKERS, ERR_INVALID_MSDOS_ATTRIBUTES, ERR_INVALID_MSDOS_DATA, ERR_INVALID_PASSWORD, ERR_INVALID_PASSWORD_TYPE, ERR_INVALID_READER, ERR_INVALID_SIGNAL, ERR_INVALID_SIGNATURE_DATA, ERR_INVALID_STRICTNESS, ERR_INVALID_UID, ERR_INVALID_UNCOMPRESSED_SIZE, ERR_INVALID_UNIX_EXTRA_FIELD_TYPE, ERR_INVALID_UNIX_ID_SIZE, ERR_INVALID_UNIX_MODE, ERR_INVALID_VERSION, ERR_ITERATOR_COMPLETED_TOO_SOON, ERR_LOCAL_FILE_HEADER_NOT_FOUND, ERR_OVERLAPPING_ENTRY, ERR_RESERVED_COMPRESSION_METHOD, ERR_SPLIT_ZIP_FILE, ERR_UNDEFINED_COMPRESSION_METHOD, ERR_UNDEFINED_READER, ERR_UNDEFINED_UNCOMPRESSED_SIZE, ERR_UNDETERMINED_SIZE, ERR_UNSAFE_FILENAME, ERR_UNSUPPORTED_COMPRESSION, ERR_UNSUPPORTED_CONTEXT, ERR_UNSUPPORTED_CRYPTO_API, ERR_UNSUPPORTED_ENCRYPTION, ERR_UNSUPPORTED_ENCRYPTION_PASS_THROUGH, ERR_UNSUPPORTED_ENCRYPTION_USDZ, ERR_UNSUPPORTED_FORMAT, ERR_UNSUPPORTED_SPLIT_USDZ, ERR_UNSUPPORTED_UINT64, ERR_WORKER_STARTUP_TIMEOUT, ERR_WRITER_NOT_INITIALIZED, ERR_ZIP_NOT_EMPTY, HttpRangeReader, HttpReader, Reader, SplitDataReader, SplitDataWriter, TextReader, TextWriter, Uint8ArrayReader, Uint8ArrayWriter, VERSION, WARNING_APPENDED_DATA, WARNING_COMPRESSED_PATCHED_DATA, WARNING_DUPLICATE_FILENAME, WARNING_MALFORMED_EXTRA_FIELD, WARNING_MISMATCHED_LOCAL_FILE_HEADER_BIT_FLAG, WARNING_MISMATCHED_LOCAL_FILE_HEADER_COMPRESSION_METHOD, WARNING_MISMATCHED_LOCAL_FILE_HEADER_CRC32_OR_SIZES, WARNING_MISMATCHED_ZIP64_END_OF_CENTRAL_DIRECTORY, WARNING_PREPENDED_CENTRAL_DIRECTORY, WARNING_PREPENDED_DATA, WARNING_TRAILING_CENTRAL_DIRECTORY_DATA, WARNING_UNKNOWN_VERSION, WARNING_UNKNOWN_ZIP64_EXTENSIBLE_DATA, WARNING_UNSORTED_CENTRAL_DIRECTORY, WARNING_WRAPPED_ENTRIES_COUNT, Writer, ZipReader, ZipReaderStream, ZipWriter, ZipWriterStream, configure, createBlobTempStream, createOPFSTempStream, createSyncAccessHandleTempStream, getMimeType, getRegisteredCodecs, getSupportedCompressionMethods, isZipFile, registerCodec, resetConfiguration, terminateWorkersAndModule as terminateWorkers, unregisterCodec };