@cj-tech-master/excelts 9.2.1 → 9.3.0

package/dist/iife/excelts.iife.js

@@ -1,5 +1,5 @@
 /*!
-* @cj-tech-master/excelts v9.2.1
+* @cj-tech-master/excelts v9.3.0
 * Zero-dependency TypeScript toolkit — Excel (XLSX), PDF, CSV, Markdown, XML, ZIP/TAR, and streaming.
 * (c) 2026 cjnoname
 * Released under the MIT License
@@ -7364,7 +7364,8 @@ var ExcelTS = (function(exports) {
 				this._isSubclassTransform = false;
 				return false;
 			}
-			this._isSubclassTransform = Object.getPrototypeOf(this)._transform !== Transform.prototype._transform;
+			const proto = Object.getPrototypeOf(this);
+			this._isSubclassTransform = proto._transform !== Transform.prototype._transform;
 			return this._isSubclassTransform;
 		}
 		_hasSubclassFlush() {
@@ -7739,34 +7740,36 @@ var ExcelTS = (function(exports) {
 		_getWebStream() {
 			if (this._webStream) return this._webStream;
 			const iterator = this[Symbol.asyncIterator]();
-			this._webStream = {
-				readable: new ReadableStream({
-					pull: async (controller) => {
-						const { done, value } = await iterator.next();
-						if (done) {
-							controller.close();
-							return;
-						}
-						controller.enqueue(value);
-					},
-					cancel: (reason) => {
-						this.destroy(reason instanceof Error ? reason : new Error(String(reason)));
+			const readable = new ReadableStream({
+				pull: async (controller) => {
+					const { done, value } = await iterator.next();
+					if (done) {
+						controller.close();
+						return;
 					}
+					controller.enqueue(value);
+				},
+				cancel: (reason) => {
+					this.destroy(reason instanceof Error ? reason : new Error(String(reason)));
+				}
+			});
+			const writable = new WritableStream({
+				write: (chunk) => new Promise((resolve, reject) => {
+					this.write(chunk, (err) => {
+						if (err) reject(err);
+						else resolve();
+					});
 				}),
-				writable: new WritableStream({
-					write: (chunk) => new Promise((resolve, reject) => {
-						this.write(chunk, (err) => {
-							if (err) reject(err);
-							else resolve();
-						});
-					}),
-					close: () => new Promise((resolve) => {
-						this.end(() => resolve());
-					}),
-					abort: (reason) => {
-						this.destroy(reason instanceof Error ? reason : new Error(String(reason)));
-					}
-				})
+				close: () => new Promise((resolve) => {
+					this.end(() => resolve());
+				}),
+				abort: (reason) => {
+					this.destroy(reason instanceof Error ? reason : new Error(String(reason)));
+				}
+			});
+			this._webStream = {
+				readable,
+				writable
 			};
 			return this._webStream;
 		}
@@ -8461,7 +8464,8 @@ var ExcelTS = (function(exports) {
 			this.options = options;
 			this.chunkSize = options.chunkSize ?? 1e3;
 			this.decoder = new TextDecoder(options.encoding || "utf-8");
-			this.autoDetectDelimiter = (options.delimiter ?? ",") === "";
+			const delimiterOption = options.delimiter ?? ",";
+			this.autoDetectDelimiter = delimiterOption === "";
 			const { config } = createParseConfig({ options });
 			this.parseConfig = config;
 			this.parseState = createParseState(config);
@@ -9611,6 +9615,11 @@ var ExcelTS = (function(exports) {
 				default: throw new InvalidAddressError(String(args.length), "Can only encode with 2 or 4 arguments");
 			}
 		},
+		compareAddress(a, b) {
+			const addrA = colCache.decodeAddress(a);
+			const addrB = colCache.decodeAddress(b);
+			return addrA.col - addrB.col || addrA.row - addrB.row;
+		},
 		inRange(range, address) {
 			const [left, top, , right, bottom] = range;
 			const [col, row] = address;
@@ -9937,11 +9946,179 @@ var ExcelTS = (function(exports) {
 		}
 	};
 	//#endregion
+	//#region src/modules/formula/default-syntax-probe.ts
+	let defaultProbe = null;
+	/**
+	* Retrieve the currently-installed default probe, or `null` if none is
+	* installed. Consumers (chiefly `DefinedNames`) should treat `null` as
+	* a signal to use conservative (opaque) classification rather than
+	* guessing.
+	*/
+	function getDefaultSyntaxProbe() {
+		return defaultProbe;
+	}
+	//#endregion
 	//#region src/modules/excel/defined-names.ts
 	const rangeRegexp = /[$](\w+)[$](\d+)(:[$](\w+)[$](\d+))?/;
+	const cellRangeRegexp = /^[$]?[A-Za-z]{1,3}[$]?\d+(:[$]?[A-Za-z]{1,3}[$]?\d+)?$/;
+	const rowRangeRegexp = /^[$]?\d+:[$]?\d+$/;
+	const colRangeRegexp = /^[$]?[A-Za-z]{1,3}:[$]?[A-Za-z]{1,3}$/;
+	function isValidRange(range) {
+		if (range.startsWith("{") || range.endsWith("}")) return false;
+		const cellRef = range.split("!").pop() ?? "";
+		if (!cellRangeRegexp.test(cellRef) && !rowRangeRegexp.test(cellRef) && !colRangeRegexp.test(cellRef)) return false;
+		try {
+			const decoded = colCache.decodeEx(range);
+			if ("row" in decoded && typeof decoded.row === "number" || "top" in decoded && typeof decoded.top === "number" || "left" in decoded && typeof decoded.left === "number") return true;
+			return false;
+		} catch {
+			return false;
+		}
+	}
+	/**
+	* Extract valid cell/range references from a raw defined name text string.
+	* Handles comma-separated ranges and quoted sheet names that may contain commas.
+	*/
+	function extractRanges(parsedText) {
+		const trimmed = parsedText.trim();
+		if (trimmed.startsWith("{") && trimmed.endsWith("}")) return [];
+		const ranges = [];
+		let quotesOpened = false;
+		let last = "";
+		parsedText.split(",").forEach((item) => {
+			if (!item) return;
+			const quotes = (item.match(/'/g) ?? []).length;
+			if (!quotes) {
+				if (quotesOpened) last += `${item},`;
+				else if (isValidRange(item)) ranges.push(item);
+				return;
+			}
+			const quotesEven = quotes % 2 === 0;
+			if (!quotesOpened && quotesEven && isValidRange(item)) ranges.push(item);
+			else if (quotesOpened && !quotesEven) {
+				quotesOpened = false;
+				if (isValidRange(last + item)) ranges.push(last + item);
+				last = "";
+			} else {
+				quotesOpened = true;
+				last += `${item},`;
+			}
+		});
+		return ranges;
+	}
+	/**
+	* Check whether a string contains a '(' character outside of single-quoted
+	* sheet name segments. Sheet names in cell references use single quotes:
+	* e.g. `'Sheet (1)'!$A$1` — the '(' is inside quotes and does NOT indicate
+	* a function call. A genuine formula like `OFFSET(Sheet1!$A$1,0,0,3,1)`
+	* has '(' outside of any quotes.
+	*/
+	function hasUnquotedParen(s) {
+		let inQuote = false;
+		for (let i = 0; i < s.length; i++) {
+			const ch = s[i];
+			if (ch === "'") inQuote = !inQuote;
+			else if (ch === "(" && !inQuote) return true;
+		}
+		return false;
+	}
+	/**
+	* Classify a raw defined name text into one of three categories:
+	* 1. **reference** — pure cell/range union (goes into matrixMap)
+	* 2. **formula** — parseable expression (goes into formulaMap)
+	* 3. **opaque** — unrecognised content preserved for round-trip
+	*
+	* Classification order matters:
+	* - If the text contains an unquoted `(`, it is likely a formula — try the
+	*   formula parser first (this prevents `extractRanges` from misinterpreting
+	*   function arguments as partial range references).
+	* - Otherwise try to extract ranges (pure cell references).
+	* - If neither works, fall back to opaque.
+	*
+	* **Probe semantics:** `probe` is the formula tokenizer+parser oracle. It
+	* is the *only* authority for deciding whether a non-range, non-wrapper
+	* string is a formula. When `probe` is `null` (no formula engine
+	* installed and no probe injected), any such string is classified as
+	* **opaque** — we have no evidence it is a formula, and leaving it
+	* opaque preserves round-trip bytes via `rawText`.
+	*
+	* This function is pure: the classification of a given input depends
+	* entirely on (rawText, ranges, probe) and no global state. Two calls
+	* with the same arguments always produce the same result.
+	*/
+	function classifyDefinedName(rawText, ranges, probe) {
+		if (rawText === void 0) {
+			if (ranges.length > 0) return {
+				kind: "reference",
+				ranges
+			};
+			return {
+				kind: "opaque",
+				ranges: []
+			};
+		}
+		const trimmed = rawText.trim();
+		if (trimmed.length === 0) return {
+			kind: "opaque",
+			ranges: []
+		};
+		const isArrayConst = trimmed.startsWith("{") && trimmed.endsWith("}");
+		const isStringLit = trimmed.startsWith("\"") && trimmed.endsWith("\"");
+		const isErrorVal = trimmed.startsWith("#");
+		const isOpaqueWrapper = isArrayConst || isStringLit || isErrorVal;
+		if (hasUnquotedParen(trimmed) && !isOpaqueWrapper) {
+			if (probe && probe(trimmed)) return {
+				kind: "formula",
+				ranges: [trimmed],
+				formulaExpression: trimmed
+			};
+			return {
+				kind: "opaque",
+				ranges: []
+			};
+		}
+		const extracted = extractRanges(rawText);
+		if (extracted.length > 0) return {
+			kind: "reference",
+			ranges: extracted
+		};
+		if (isOpaqueWrapper) return {
+			kind: "opaque",
+			ranges: []
+		};
+		if (probe && probe(trimmed)) return {
+			kind: "formula",
+			ranges: [trimmed],
+			formulaExpression: trimmed
+		};
+		return {
+			kind: "opaque",
+			ranges: []
+		};
+	}
+	/**
+	* Build the internal storage key for a defined name entry.
+	* Workbook-scoped: just the bare name.
+	* Sheet-scoped: `"name\0sheetId"` (null char separator avoids collisions).
+	*/
+	function storageKey(name, localSheetId) {
+		return localSheetId !== void 0 ? `${name}\0${localSheetId}` : name;
+	}
 	var DefinedNames = class {
-		constructor() {
+		/**
+		* @param probe Optional formula-syntax probe used when classifying
+		*   defined-name text. Injecting a probe here makes classification
+		*   deterministic for this instance regardless of process-global
+		*   `installFormulaEngine()` state. When omitted, the instance defers
+		*   to the default probe at classification time (see `set model`).
+		*/
+		constructor(probe) {
 			this.matrixMap = {};
+			this.formulaMap = {};
+			this.localSheetIdMap = {};
+			this.opaqueMap = {};
+			this.nameForKey = {};
+			this._explicitProbe = probe ?? null;
 		}
 		getMatrix(name) {
 			return this.matrixMap[name] || (this.matrixMap[name] = new CellMatrix());
@@ -9949,6 +10126,9 @@ var ExcelTS = (function(exports) {
 		add(locStr, name) {
 			const location = colCache.decodeEx(locStr);
 			if ("error" in location) return;
+			delete this.formulaMap[name];
+			delete this.opaqueMap[name];
+			this.nameForKey[name] = name;
 			this.addEx(location, name);
 		}
 		addEx(location, name) {
@@ -9964,6 +10144,22 @@ var ExcelTS = (function(exports) {
 			}
 			else matrix.addCellEx(location);
 		}
+		/**
+		* Register a formula-based defined name.
+		*
+		* Unlike `add()` which binds a name to a cell/range reference, this binds
+		* a name to an arbitrary formula expression that will be evaluated at
+		* calculation time.
+		*
+		* @param name - The defined name (e.g. "MyArray")
+		* @param expression - The formula expression (e.g. "{1,2;3,4}", "LAMBDA(x,y,x+y)")
+		*/
+		addFormula(name, expression) {
+			delete this.matrixMap[name];
+			delete this.opaqueMap[name];
+			this.nameForKey[name] = name;
+			this.formulaMap[name] = expression;
+		}
 		remove(locStr, name) {
 			const location = colCache.decodeEx(locStr);
 			if ("error" in location) return;
@@ -9991,9 +10187,10 @@ var ExcelTS = (function(exports) {
 			});
 		}
 		forEach(callback) {
-			Object.entries(this.matrixMap).forEach(([name, matrix]) => {
+			Object.entries(this.matrixMap).forEach(([sKey, matrix]) => {
+				const bareName = this.nameForKey[sKey] ?? sKey;
 				matrix.forEach((cell) => {
-					callback(name, cell);
+					callback(bareName, cell);
 				});
 			});
 		}
@@ -10003,7 +10200,63 @@ var ExcelTS = (function(exports) {
 			return this.getNamesEx(location);
 		}
 		getNamesEx(address) {
-			return Object.entries(this.matrixMap).map(([name, matrix]) => matrix.findCellEx(address, false) && name).filter((name) => Boolean(name));
+			return Object.entries(this.matrixMap).map(([sKey, matrix]) => matrix.findCellEx(address, false) && (this.nameForKey[sKey] ?? sKey)).filter((name) => Boolean(name));
+		}
+		/**
+		* Return all defined name entries in this collection, including scope info.
+		* Each entry has the bare name and optional localSheetId.
+		* Same bare name may appear multiple times with different scopes.
+		*/
+		getAllNames() {
+			return this.getAllEntries().map((e) => e.localSheetId !== void 0 ? {
+				name: e.name,
+				localSheetId: e.localSheetId
+			} : { name: e.name });
+		}
+		/**
+		* Return all defined name entries with full details (name, ranges, scope).
+		*
+		* This is the primary enumeration API. Each entry is self-contained —
+		* no second lookup is needed. Same bare name may appear multiple times
+		* with different scopes.
+		*/
+		getAllEntries() {
+			const result = [];
+			const seen = /* @__PURE__ */ new Set();
+			for (const sKey of Object.keys(this.matrixMap)) {
+				if (seen.has(sKey)) continue;
+				seen.add(sKey);
+				const model = this.getRanges(sKey);
+				const localSheetId = this.localSheetIdMap[sKey];
+				result.push(localSheetId !== void 0 ? {
+					...model,
+					localSheetId
+				} : model);
+			}
+			for (const sKey of Object.keys(this.formulaMap)) {
+				if (seen.has(sKey)) continue;
+				seen.add(sKey);
+				const model = this.getRanges(sKey);
+				const localSheetId = this.localSheetIdMap[sKey];
+				result.push(localSheetId !== void 0 ? {
+					...model,
+					localSheetId
+				} : model);
+			}
+			for (const sKey of Object.keys(this.opaqueMap)) {
+				if (seen.has(sKey)) continue;
+				seen.add(sKey);
+				const bareName = this.nameForKey[sKey] ?? sKey;
+				const entry = this.opaqueMap[sKey];
+				result.push({
+					name: bareName,
+					ranges: [],
+					rawText: entry.rawText,
+					localSheetId: entry.localSheetId,
+					kind: "opaque"
+				});
+			}
+			return result;
 		}
 		_explore(matrix, cell) {
 			cell.mark = false;
@@ -10038,17 +10291,37 @@ var ExcelTS = (function(exports) {
 			for (x = cell.col + 1; hGrow(x, "right"); x++);
 			return range;
 		}
+		/**
+		* Get ranges for a specific scoped entry.
+		*
+		* Unlike `getRanges(name)` which uses the bare name (and may hit the
+		* wrong scope when the same name exists both globally and locally),
+		* this method uses the internal `storageKey` to look up the exact entry.
+		*/
+		getRangesScoped(name, localSheetId) {
+			const sKey = storageKey(name, localSheetId);
+			return this.getRanges(sKey);
+		}
 		getRanges(name, matrix) {
+			const formula = this.formulaMap[name];
 			matrix = matrix || this.matrixMap[name];
-			if (!matrix) return {
-				name,
-				ranges: []
-			};
+			const bareName = this.nameForKey[name] ?? name;
+			if (!matrix) {
+				if (formula) return {
+					name: bareName,
+					ranges: [formula],
+					formulaExpression: formula
+				};
+				return {
+					name: bareName,
+					ranges: []
+				};
+			}
 			matrix.forEach((cell) => {
 				cell.mark = true;
 			});
 			return {
-				name,
+				name: bareName,
 				ranges: matrix.map((cell) => cell.mark && this._explore(matrix, cell)).filter((range) => Boolean(range)).map((range) => range.$shortRange)
 			};
 		}
@@ -10076,16 +10349,84 @@ var ExcelTS = (function(exports) {
 			});
 		}
 		get model() {
-			return Object.entries(this.matrixMap).map(([name, matrix]) => this.getRanges(name, matrix)).filter((definedName) => definedName.ranges.length);
+			const cellNames = Object.entries(this.matrixMap).map(([sKey, matrix]) => {
+				const result = this.getRanges(sKey, matrix);
+				const localSheetId = this.localSheetIdMap[sKey];
+				if (localSheetId !== void 0) return {
+					...result,
+					localSheetId
+				};
+				return result;
+			}).filter((definedName) => definedName.ranges.length);
+			const formulaNames = Object.entries(this.formulaMap).filter(([sKey]) => !this.matrixMap[sKey]).map(([sKey, expression]) => {
+				const result = {
+					name: this.nameForKey[sKey] ?? sKey,
+					ranges: [expression],
+					formulaExpression: expression
+				};
+				const localSheetId = this.localSheetIdMap[sKey];
+				if (localSheetId !== void 0) return {
+					...result,
+					localSheetId
+				};
+				return result;
+			});
+			const opaqueNames = Object.entries(this.opaqueMap).map(([sKey, entry]) => {
+				return {
+					name: this.nameForKey[sKey] ?? sKey,
+					ranges: [],
+					rawText: entry.rawText,
+					localSheetId: entry.localSheetId,
+					kind: "opaque"
+				};
+			});
+			return [
+				...cellNames,
+				...formulaNames,
+				...opaqueNames
+			];
 		}
+		/**
+		* Deserialise an array of `DefinedNameModel` entries (typically from XLSX parsing).
+		*
+		* Stage 2 of the two-phase design: each entry's `rawText` is classified
+		* into reference / formula / opaque by `classifyDefinedName()`.  Entries
+		* that arrive without `rawText` (programmatic API) fall back to inspecting
+		* the existing `ranges` and `formulaExpression` fields for compatibility.
+		*/
 		set model(value) {
 			const matrixMap = this.matrixMap = {};
-			value.forEach((definedName) => {
-				const matrix = matrixMap[definedName.name] = new CellMatrix();
-				definedName.ranges.forEach((rangeStr) => {
-					if (rangeRegexp.test(rangeStr.split("!").pop() ?? "")) matrix.addCell(rangeStr);
-				});
-			});
+			const formulaMap = this.formulaMap = {};
+			const localSheetIdMap = this.localSheetIdMap = {};
+			const opaqueMap = this.opaqueMap = {};
+			const nameForKeyMap = this.nameForKey = {};
+			const probe = this._explicitProbe ?? getDefaultSyntaxProbe();
+			for (const definedName of value) {
+				const sKey = storageKey(definedName.name, definedName.localSheetId);
+				nameForKeyMap[sKey] = definedName.name;
+				if (definedName.localSheetId !== void 0) localSheetIdMap[sKey] = definedName.localSheetId;
+				if (definedName.formulaExpression && definedName.rawText === void 0) {
+					formulaMap[sKey] = definedName.formulaExpression;
+					continue;
+				}
+				const classified = classifyDefinedName(definedName.rawText, definedName.ranges, probe);
+				switch (classified.kind) {
+					case "reference": {
+						const matrix = matrixMap[sKey] = new CellMatrix();
+						for (const rangeStr of classified.ranges) if (rangeRegexp.test(rangeStr.split("!").pop() ?? "")) matrix.addCell(rangeStr);
+						break;
+					}
+					case "formula":
+						formulaMap[sKey] = classified.formulaExpression;
+						break;
+					case "opaque":
+						if (definedName.rawText) opaqueMap[sKey] = {
+							rawText: definedName.rawText,
+							localSheetId: definedName.localSheetId
+						};
+						break;
+				}
+			}
 		}
 	};
 	//#endregion
@@ -15225,7 +15566,10 @@ onmessage = async (ev) => {
 		PivotCacheRecords: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotCacheRecords",
 		PivotTable: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotTable",
 		FeaturePropertyBag: "http://schemas.microsoft.com/office/2022/11/relationships/FeaturePropertyBag",
-		CtrlProp: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/ctrlProp"
+		CtrlProp: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/ctrlProp",
+		SheetMetadata: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/sheetMetadata",
+		ExternalLink: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/externalLink",
+		ExternalLinkPath: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/externalLinkPath"
 	};
 	//#endregion
 	//#region src/modules/xml/errors.ts
@@ -16643,7 +16987,7 @@ onmessage = async (ev) => {
 					const attributes = node.attributes;
 					if (attributes.Type !== RelType.Hyperlink) return;
 					const relationship = {
-						type: Enums.RelationshipType.Hyperlink,
+						type: 7,
 						rId: attributes.Id,
 						target: attributes.Target,
 						targetMode: attributes.TargetMode
@@ -16939,7 +17283,7 @@ onmessage = async (ev) => {
 		get values() {
 			const v = [];
 			this.eachCell((cell, rowNumber) => {
-				if (cell && cell.type !== Enums.ValueType.Null) v[rowNumber] = cell.value;
+				if (cell && cell.type !== 0) v[rowNumber] = cell.value;
 			});
 			return v;
 		}
@@ -17151,6 +17495,40 @@ onmessage = async (ev) => {
 	//#endregion
 	//#region src/modules/excel/cell.ts
 	const hasOwnKeys = (v) => !!v && (typeof v !== "object" || Object.keys(v).length > 0);
+	/**
+	* Flatten a rich-text array into its plain-text representation by
+	* concatenating each run's `text`. Missing/null runs contribute "".
+	*/
+	function flattenRichText(runs) {
+		let out = "";
+		for (const run of runs) if (run && typeof run.text === "string") out += run.text;
+		return out;
+	}
+	/**
+	* Normalize a CellHyperlinkValue so the {@link NormalizedHyperlink} invariants
+	* hold.
+	*
+	* - If the caller supplied `richText` but no `text`, text is derived.
+	* - If the caller supplied `text` but no `richText`, richText stays absent.
+	* - If both are supplied, `richText` wins and `text` is regenerated
+	*   (to keep `text === flatten(richText)`).
+	* - An empty `richText: []` is dropped (treated as "no rich text").
+	*/
+	function normalizeHyperlinkValue(value) {
+		let text;
+		let richText;
+		if (Array.isArray(value.richText) && value.richText.length > 0) {
+			richText = value.richText;
+			text = flattenRichText(richText);
+		} else text = typeof value.text === "string" ? value.text : "";
+		const out = {
+			text,
+			hyperlink: typeof value.hyperlink === "string" ? value.hyperlink : ""
+		};
+		if (richText) out.richText = richText;
+		if (typeof value.tooltip === "string" && value.tooltip.length > 0) out.tooltip = value.tooltip;
+		return out;
+	}
 	var Cell = class Cell {
 		static {
 			this.Types = Enums.ValueType;
@@ -17322,10 +17700,25 @@ onmessage = async (ev) => {
 		}
 		/** @internal */
 		_upgradeToHyperlink(hyperlink) {
-			if (this.type === Cell.Types.String) this._value = Value.create(Cell.Types.Hyperlink, this, {
-				text: String(this._value.value),
-				hyperlink
-			});
+			switch (this.type) {
+				case Cell.Types.String:
+					this._value = Value.create(Cell.Types.Hyperlink, this, {
+						text: String(this._value.value),
+						hyperlink
+					});
+					break;
+				case Cell.Types.RichText: {
+					const current = this._value.value;
+					const runs = current && Array.isArray(current.richText) ? current.richText : [];
+					this._value = Value.create(Cell.Types.Hyperlink, this, {
+						text: flattenRichText(runs),
+						richText: runs.length > 0 ? runs : void 0,
+						hyperlink
+					});
+					break;
+				}
+				default: break;
+			}
 		}
 		get formula() {
 			return this._value.formula;
@@ -17333,8 +17726,11 @@ onmessage = async (ev) => {
 		get result() {
 			return this._value.result;
 		}
+		set result(value) {
+			if (this.type === Cell.Types.Formula) this._value.result = value;
+		}
 		get formulaType() {
-			return this._value.formulaType ?? Enums.FormulaType.None;
+			return this._value.formulaType ?? 0;
 		}
 		get fullAddress() {
 			const { worksheet } = this._row;
@@ -17572,30 +17968,60 @@ onmessage = async (ev) => {
 		constructor(cell, value) {
 			this.model = {
 				address: cell.address,
-				type: Cell.Types.Hyperlink,
-				text: value ? value.text : void 0,
-				hyperlink: value ? value.hyperlink : void 0
+				type: Cell.Types.Hyperlink
 			};
-			if (value && value.tooltip) this.model.tooltip = value.tooltip;
+			if (value) {
+				if ("formula" in value && typeof value.formula === "string") {
+					const fh = value;
+					const display = fh.result === void 0 || fh.result === null ? "" : String(fh.result);
+					this.model.text = display;
+					this.model.hyperlink = fh.hyperlink ?? "";
+					if (fh.tooltip !== void 0) this.model.tooltip = fh.tooltip;
+					this.model.formula = fh.formula;
+					if (fh.result !== void 0) this.model.result = fh.result;
+					return;
+				}
+				const normalized = normalizeHyperlinkValue(value);
+				this.model.text = normalized.text;
+				this.model.hyperlink = normalized.hyperlink;
+				if (normalized.richText) this.model.richText = normalized.richText;
+				if (normalized.tooltip !== void 0) this.model.tooltip = normalized.tooltip;
+			}
 		}
 		get value() {
-			return {
+			const out = {
 				text: this.model.text ?? "",
-				hyperlink: this.model.hyperlink ?? "",
-				tooltip: this.model.tooltip
+				hyperlink: this.model.hyperlink ?? ""
 			};
+			if (this.model.richText && this.model.richText.length > 0) out.richText = this.model.richText;
+			if (this.model.tooltip !== void 0) out.tooltip = this.model.tooltip;
+			return out;
 		}
 		set value(value) {
-			this.model.text = value.text;
-			this.model.hyperlink = value.hyperlink;
-			if (value.tooltip) this.model.tooltip = value.tooltip;
+			const normalized = normalizeHyperlinkValue(value);
+			this.model.text = normalized.text;
+			this.model.hyperlink = normalized.hyperlink;
+			if (normalized.richText) this.model.richText = normalized.richText;
+			else delete this.model.richText;
+			if (normalized.tooltip !== void 0) this.model.tooltip = normalized.tooltip;
+			else delete this.model.tooltip;
 		}
 		get text() {
 			return this.model.text;
 		}
 		set text(value) {
+			if (this.model.richText) delete this.model.richText;
 			this.model.text = value;
 		}
+		get richText() {
+			return this.model.richText;
+		}
+		set richText(value) {
+			if (Array.isArray(value) && value.length > 0) {
+				this.model.richText = value;
+				this.model.text = flattenRichText(value);
+			} else delete this.model.richText;
+		}
 		get hyperlink() {
 			return this.model.hyperlink;
 		}
@@ -17680,7 +18106,8 @@ onmessage = async (ev) => {
 				ref: value ? value.ref : void 0,
 				formula: value ? value.formula : void 0,
 				sharedFormula: value ? value.sharedFormula : void 0,
-				result: value ? value.result : void 0
+				result: value ? value.result : void 0,
+				isDynamicArray: value ? value.isDynamicArray : void 0
 			};
 		}
 		_copyModel(model) {
@@ -17690,6 +18117,7 @@ onmessage = async (ev) => {
 			if (model.ref) copy.ref = model.ref;
 			if (model.shareType) copy.shareType = model.shareType;
 			if (model.sharedFormula) copy.sharedFormula = model.sharedFormula;
+			if (model.isDynamicArray) copy.isDynamicArray = model.isDynamicArray;
 			return copy;
 		}
 		get value() {
@@ -17701,6 +18129,7 @@ onmessage = async (ev) => {
 			if (value.ref) this.model.ref = value.ref;
 			if (value.shareType) this.model.shareType = value.shareType;
 			if (value.sharedFormula) this.model.sharedFormula = value.sharedFormula;
+			if (value.isDynamicArray !== void 0) this.model.isDynamicArray = value.isDynamicArray;
 		}
 		validate(value) {
 			switch (Value.getType(value)) {
@@ -17726,9 +18155,9 @@ onmessage = async (ev) => {
 			this.model.formula = value;
 		}
 		get formulaType() {
-			if (this.model.formula) return Enums.FormulaType.Master;
-			if (this.model.sharedFormula) return Enums.FormulaType.Shared;
-			return Enums.FormulaType.None;
+			if (this.model.formula) return 1;
+			if (this.model.sharedFormula) return 2;
+			return 0;
 		}
 		get result() {
 			return this.model.result;
@@ -17741,12 +18170,12 @@ onmessage = async (ev) => {
 		}
 		get effectiveType() {
 			const v = this.model.result;
-			if (v === null || v === void 0) return Enums.ValueType.Null;
-			if (typeof v === "string") return Enums.ValueType.String;
-			if (typeof v === "number") return Enums.ValueType.Number;
-			if (v instanceof Date) return Enums.ValueType.Date;
-			if (typeof v === "object" && "error" in v) return Enums.ValueType.Error;
-			return Enums.ValueType.Null;
+			if (v === null || v === void 0) return 0;
+			if (typeof v === "string") return 3;
+			if (typeof v === "number") return 2;
+			if (v instanceof Date) return 4;
+			if (typeof v === "object" && "error" in v) return 10;
+			return 0;
 		}
 		get address() {
 			return this.model.address;
@@ -17951,9 +18380,14 @@ onmessage = async (ev) => {
 			if (value instanceof Date) return Cell.Types.Date;
 			if (typeof value === "object") {
 				if ("checkbox" in value && typeof value.checkbox === "boolean") return Cell.Types.Checkbox;
-				if ("text" in value && value.text && "hyperlink" in value && value.hyperlink) return Cell.Types.Hyperlink;
+				if ("hyperlink" in value && typeof value.hyperlink === "string" && value.hyperlink) {
+					const hasText = "text" in value && typeof value.text === "string" && value.text.length > 0;
+					const hasRichText = "richText" in value && Array.isArray(value.richText) && value.richText.length > 0;
+					const hasFormula = "formula" in value && typeof value.formula === "string";
+					if (hasText || hasRichText || hasFormula) return Cell.Types.Hyperlink;
+				}
 				if ("formula" in value && value.formula || "sharedFormula" in value && value.sharedFormula) return Cell.Types.Formula;
-				if ("richText" in value && value.richText) return Cell.Types.RichText;
+				if ("richText" in value && Array.isArray(value.richText) && value.richText.length > 0) return Cell.Types.RichText;
 				if ("sharedString" in value && value.sharedString) return Cell.Types.SharedString;
 				if ("error" in value && value.error) return Cell.Types.Error;
 			}
@@ -18142,7 +18576,7 @@ onmessage = async (ev) => {
 				const n = this._cells.length;
 				for (let i = 1; i <= n; i++) callback(this.getCell(i), i);
 			} else this._cells.forEach((cell, index) => {
-				if (cell && cell.type !== Enums.ValueType.Null) callback(cell, index + 1);
+				if (cell && cell.type !== 0) callback(cell, index + 1);
 			});
 		}
 		addPageBreak(lft, rght) {
@@ -18163,7 +18597,7 @@ onmessage = async (ev) => {
 		get values() {
 			const values = [];
 			this._cells.forEach((cell) => {
-				if (cell && cell.type !== Enums.ValueType.Null) values[cell.col] = cell.value;
+				if (cell && cell.type !== 0) values[cell.col] = cell.value;
 			});
 			return values;
 		}
@@ -18199,7 +18633,7 @@ onmessage = async (ev) => {
 		getValues() {
 			const values = [];
 			this._cells.forEach((cell) => {
-				if (cell && cell.type !== Enums.ValueType.Null) values[cell.col - 1] = cell.value;
+				if (cell && cell.type !== 0) values[cell.col - 1] = cell.value;
 			});
 			return values;
 		}
@@ -18215,7 +18649,7 @@ onmessage = async (ev) => {
 		* Returns true if the row includes at least one cell with a value
 		*/
 		get hasValues() {
-			return this._cells.some((cell) => cell && cell.type !== Enums.ValueType.Null);
+			return this._cells.some((cell) => cell && cell.type !== 0);
 		}
 		/**
 		* Number of cells including empty ones
@@ -18240,7 +18674,7 @@ onmessage = async (ev) => {
 			let min = 0;
 			let max = 0;
 			this._cells.forEach((cell) => {
-				if (cell && cell.type !== Enums.ValueType.Null) {
+				if (cell && cell.type !== 0) {
 					if (!min || min > cell.col) min = cell.col;
 					if (max < cell.col) max = cell.col;
 				}
@@ -18944,10 +19378,12 @@ onmessage = async (ev) => {
 					case "c":
 						if (row) {
 							const styleAttr = node.attributes.s;
+							const cmAttr = node.attributes.cm;
 							c = {
 								ref: node.attributes.r,
 								s: styleAttr !== void 0 ? parseInt(styleAttr, 10) : void 0,
-								t: node.attributes.t
+								t: node.attributes.t,
+								cm: cmAttr !== void 0 ? parseInt(cmAttr, 10) : void 0
 							};
 						}
 						break;
@@ -19025,6 +19461,12 @@ onmessage = async (ev) => {
 								const cellValue = { formula: c.f.text };
 								if (c.v) if (c.t === "str") cellValue.result = c.v.text;
 								else cellValue.result = parseFloat(c.v.text);
+								if (c.cm !== void 0) {
+									const { workbook: wb } = this;
+									if (wb.dynamicArrayCmIndices) {
+										if (wb.dynamicArrayCmIndices.has(c.cm)) cellValue.isDynamicArray = true;
+									} else if (wb.hasDynamicArrayMetadata) cellValue.isDynamicArray = true;
+								}
 								cell.value = cellValue;
 							} else if (c.v) switch (c.t) {
 								case "s": {
@@ -19130,7 +19572,8 @@ onmessage = async (ev) => {
 					});
 				} else {
 					stream.pause();
-					yield contents.shift();
+					const data = contents.shift();
+					if (data !== void 0) yield data;
 				}
 				if (error) throw toError(error);
 			}
@@ -19152,7 +19595,8 @@ onmessage = async (ev) => {
 		xlSharedStrings: "xl/sharedStrings.xml",
 		xlStyles: "xl/styles.xml",
 		xlTheme1: "xl/theme/theme1.xml",
-		xlFeaturePropertyBag: "xl/featurePropertyBag/featurePropertyBag.xml"
+		xlFeaturePropertyBag: "xl/featurePropertyBag/featurePropertyBag.xml",
+		xlMetadata: "xl/metadata.xml"
 	};
 	const worksheetXmlRegex = /^xl\/worksheets\/sheet(\d+)[.]xml$/;
 	const worksheetRelsXmlRegex = /^xl\/worksheets\/_rels\/sheet(\d+)[.]xml[.]rels$/;
@@ -19169,6 +19613,8 @@ onmessage = async (ev) => {
 	const pivotCacheDefinitionXmlRegex = /^xl\/pivotCache\/(pivotCacheDefinition\d+)[.]xml$/;
 	const pivotCacheDefinitionRelsXmlRegex = /^xl\/pivotCache\/_rels\/(pivotCacheDefinition\d+)[.]xml[.]rels$/;
 	const pivotCacheRecordsXmlRegex = /^xl\/pivotCache\/(pivotCacheRecords\d+)[.]xml$/;
+	const externalLinkXmlRegex = /^xl\/externalLinks\/externalLink(\d+)[.]xml$/;
+	const externalLinkRelsXmlRegex = /^xl\/externalLinks\/_rels\/externalLink(\d+)[.]xml[.]rels$/;
 	function normalizeZipPath$1(path) {
 		return path.startsWith("/") ? path.slice(1) : path;
 	}
@@ -19243,6 +19689,22 @@ onmessage = async (ev) => {
 		const match = pivotCacheRecordsXmlRegex.exec(path);
 		return match ? match[1] : void 0;
 	}
+	/**
+	* Extract the 1-based index `N` from `xl/externalLinks/externalLink{N}.xml`.
+	* Returns the raw integer (e.g. `1` for externalLink1.xml) or undefined.
+	*/
+	function getExternalLinkIndexFromPath(path) {
+		const match = externalLinkXmlRegex.exec(path);
+		return match ? parseInt(match[1], 10) : void 0;
+	}
+	/**
+	* Extract the 1-based index `N` from
+	* `xl/externalLinks/_rels/externalLink{N}.xml.rels`.
+	*/
+	function getExternalLinkIndexFromRelsPath(path) {
+		const match = externalLinkRelsXmlRegex.exec(path);
+		return match ? parseInt(match[1], 10) : void 0;
+	}
 	function toContentTypesPartName(zipPath) {
 		return zipPath.startsWith("/") ? zipPath : `/${zipPath}`;
 	}
@@ -19303,6 +19765,19 @@ onmessage = async (ev) => {
 	function pivotTableRelsPath(n) {
 		return `xl/pivotTables/_rels/pivotTable${n}.xml.rels`;
 	}
+	function externalLinkPath(n) {
+		return `xl/externalLinks/externalLink${n}.xml`;
+	}
+	function externalLinkRelsPath(n) {
+		return `xl/externalLinks/_rels/externalLink${n}.xml.rels`;
+	}
+	/**
+	* Build the `Target` value for an externalLink relationship inside
+	* `xl/_rels/workbook.xml.rels` (base: `xl/`).
+	*/
+	function externalLinkRelTargetFromWorkbook(n) {
+		return `externalLinks/externalLink${n}.xml`;
+	}
 	function pivotCacheDefinitionRelTargetFromPivotTable(n) {
 		return `../pivotCache/pivotCacheDefinition${n}.xml`;
 	}
@@ -19310,7 +19785,8 @@ onmessage = async (ev) => {
 		workbookStyles: "styles.xml",
 		workbookSharedStrings: "sharedStrings.xml",
 		workbookTheme1: "theme/theme1.xml",
-		workbookFeaturePropertyBag: "featurePropertyBag/featurePropertyBag.xml"
+		workbookFeaturePropertyBag: "featurePropertyBag/featurePropertyBag.xml",
+		workbookMetadata: "metadata.xml"
 	};
 	function pivotCacheDefinitionRelTargetFromWorkbook(n) {
 		return `pivotCache/pivotCacheDefinition${n}.xml`;
@@ -19788,7 +20264,8 @@ onmessage = async (ev) => {
 				name: model.name,
 				localSheetId: model.localSheetId
 			});
-			xmlStream.writeText(model.ranges.join(","));
+			if (model.kind === "opaque" && model.rawText) xmlStream.writeText(model.rawText);
+			else xmlStream.writeText(model.ranges.join(","));
 			xmlStream.closeNode();
 		}
 		parseOpen(node) {
@@ -19804,57 +20281,47 @@ onmessage = async (ev) => {
 		parseText(text) {
 			this._parsedText.push(text);
 		}
+		/**
+		* Stage 1 of the two-phase defined name design: the XLSX layer only
+		* preserves the raw XML text.  Semantic classification (reference vs
+		* formula vs opaque) is deferred to `DefinedNames.set model()`.
+		*/
 		parseClose() {
-			this.model = {
+			const rawText = this._parsedText.join("");
+			const model = {
 				name: this._parsedName,
-				ranges: extractRanges(this._parsedText.join(""))
+				ranges: [],
+				rawText: rawText.trim() || void 0
 			};
-			if (this._parsedLocalSheetId !== void 0) this.model.localSheetId = parseInt(this._parsedLocalSheetId, 10);
+			if (this._parsedLocalSheetId !== void 0) model.localSheetId = parseInt(this._parsedLocalSheetId, 10);
+			this.model = model;
 			return false;
 		}
 	};
-	const cellRangeRegexp = /^[$]?[A-Za-z]{1,3}[$]?\d+(:[$]?[A-Za-z]{1,3}[$]?\d+)?$/;
-	const rowRangeRegexp = /^[$]?\d+:[$]?\d+$/;
-	const colRangeRegexp = /^[$]?[A-Za-z]{1,3}:[$]?[A-Za-z]{1,3}$/;
-	function isValidRange(range) {
-		if (range.startsWith("{") || range.endsWith("}")) return false;
-		const cellRef = range.split("!").pop() ?? "";
-		if (!cellRangeRegexp.test(cellRef) && !rowRangeRegexp.test(cellRef) && !colRangeRegexp.test(cellRef)) return false;
-		try {
-			const decoded = colCache.decodeEx(range);
-			if ("row" in decoded && typeof decoded.row === "number" || "top" in decoded && typeof decoded.top === "number" || "left" in decoded && typeof decoded.left === "number") return true;
+	//#endregion
+	//#region src/modules/excel/xlsx/xform/book/external-reference-xform.ts
+	/**
+	* Xform for a single `<externalReference r:id="..."/>` element inside
+	* `<externalReferences>` in `xl/workbook.xml`. Each `<externalReference>`
+	* maps positionally (in document order, 1-based) to an `[N]Sheet!Ref`
+	* prefix in formula strings.
+	*/
+	var ExternalReferenceXform = class extends BaseXform {
+		render(xmlStream, model) {
+			xmlStream.leafNode("externalReference", { "r:id": model.rId });
+		}
+		parseOpen(node) {
+			if (node.name === "externalReference") {
+				this.model = { rId: node.attributes["r:id"] ?? "" };
+				return true;
+			}
 			return false;
-		} catch {
+		}
+		parseText() {}
+		parseClose() {
 			return false;
 		}
-	}
-	function extractRanges(parsedText) {
-		const trimmed = parsedText.trim();
-		if (trimmed.startsWith("{") && trimmed.endsWith("}")) return [];
-		const ranges = [];
-		let quotesOpened = false;
-		let last = "";
-		parsedText.split(",").forEach((item) => {
-			if (!item) return;
-			const quotes = (item.match(/'/g) ?? []).length;
-			if (!quotes) {
-				if (quotesOpened) last += `${item},`;
-				else if (isValidRange(item)) ranges.push(item);
-				return;
-			}
-			const quotesEven = quotes % 2 === 0;
-			if (!quotesOpened && quotesEven && isValidRange(item)) ranges.push(item);
-			else if (quotesOpened && !quotesEven) {
-				quotesOpened = false;
-				if (isValidRange(last + item)) ranges.push(last + item);
-				last = "";
-			} else {
-				quotesOpened = true;
-				last += `${item},`;
-			}
-		});
-		return ranges;
-	}
+	};
 	//#endregion
 	//#region src/modules/excel/xlsx/xform/book/sheet-xform.ts
 	const VALID_STATES = new Set([
@@ -19898,12 +20365,21 @@ onmessage = async (ev) => {
 		render(xmlStream, model) {
 			xmlStream.leafNode("calcPr", {
 				calcId: 171027,
-				fullCalcOnLoad: model.fullCalcOnLoad ? 1 : void 0
+				fullCalcOnLoad: model.fullCalcOnLoad ? 1 : void 0,
+				iterate: model.iterate ? 1 : void 0,
+				iterateCount: model.iterateCount !== void 0 ? model.iterateCount : void 0,
+				iterateDelta: model.iterateDelta !== void 0 ? model.iterateDelta : void 0
 			});
 		}
 		parseOpen(node) {
 			if (node.name === "calcPr") {
-				this.model = {};
+				const attrs = node.attributes ?? {};
+				this.model = {
+					fullCalcOnLoad: attrs.fullCalcOnLoad === "1",
+					iterate: attrs.iterate === "1" ? true : void 0,
+					iterateCount: attrs.iterateCount !== void 0 ? parseInt(attrs.iterateCount, 10) : void 0,
+					iterateDelta: attrs.iterateDelta !== void 0 ? parseFloat(attrs.iterateDelta) : void 0
+				};
 				return true;
 			}
 			return false;
@@ -19959,6 +20435,55 @@ onmessage = async (ev) => {
 		}
 	};
 	//#endregion
+	//#region src/modules/excel/xlsx/xform/book/workbook-protection-xform.ts
+	var WorkbookProtectionXform = class extends BaseXform {
+		get tag() {
+			return "workbookProtection";
+		}
+		render(xmlStream, model) {
+			if (!model) return;
+			const attributes = {};
+			if (model.lockStructure) attributes.lockStructure = "1";
+			if (model.lockWindows) attributes.lockWindows = "1";
+			if (model.lockRevision) attributes.lockRevision = "1";
+			if (model.workbookPassword) attributes.workbookPassword = model.workbookPassword;
+			if (model.revisionsPassword) attributes.revisionsPassword = model.revisionsPassword;
+			if (model.algorithmName) {
+				attributes.workbookAlgorithmName = model.algorithmName;
+				attributes.workbookHashValue = model.hashValue;
+				attributes.workbookSaltValue = model.saltValue;
+				attributes.workbookSpinCount = model.spinCount?.toString();
+			}
+			if (Object.values(attributes).some((v) => v !== void 0)) xmlStream.leafNode(this.tag, attributes);
+		}
+		parseOpen(node) {
+			switch (node.name) {
+				case this.tag: {
+					const a = node.attributes;
+					this.model = {
+						lockStructure: a.lockStructure === "1" || void 0,
+						lockWindows: a.lockWindows === "1" || void 0,
+						lockRevision: a.lockRevision === "1" || void 0,
+						workbookPassword: a.workbookPassword || void 0,
+						revisionsPassword: a.revisionsPassword || void 0
+					};
+					if (a.workbookAlgorithmName) {
+						this.model.algorithmName = a.workbookAlgorithmName;
+						this.model.hashValue = a.workbookHashValue;
+						this.model.saltValue = a.workbookSaltValue;
+						this.model.spinCount = a.workbookSpinCount ? parseInt(a.workbookSpinCount, 10) : void 0;
+					}
+					return true;
+				}
+				default: return false;
+			}
+		}
+		parseText() {}
+		parseClose() {
+			return false;
+		}
+	};
+	//#endregion
 	//#region src/modules/excel/xlsx/xform/book/workbook-view-xform.ts
 	var WorkbookViewXform = class extends BaseXform {
 		render(xmlStream, model) {
@@ -20115,6 +20640,7 @@ onmessage = async (ev) => {
 			this.map = {
 				fileVersion: WorkbookXform.STATIC_XFORMS.fileVersion,
 				workbookPr: new WorkbookPropertiesXform(),
+				workbookProtection: new WorkbookProtectionXform(),
 				bookViews: new ListXform({
 					tag: "bookViews",
 					count: false,
@@ -20135,6 +20661,11 @@ onmessage = async (ev) => {
 					tag: "pivotCaches",
 					count: false,
 					childXform: new WorkbookPivotCacheXform()
+				}),
+				externalReferences: new ListXform({
+					tag: "externalReferences",
+					count: false,
+					childXform: new ExternalReferenceXform()
 				})
 			};
 		}
@@ -20187,6 +20718,7 @@ onmessage = async (ev) => {
 			xmlStream.openNode("workbook", WorkbookXform.WORKBOOK_ATTRIBUTES);
 			this.map.fileVersion.render(xmlStream);
 			this.map.workbookPr.render(xmlStream, model.properties);
+			this.map.workbookProtection.render(xmlStream, model.protection);
 			this.map.bookViews.render(xmlStream, model.views);
 			this.map.sheets.render(xmlStream, model.sheets);
 			this.map.definedNames.render(xmlStream, model.definedNames);
@@ -20199,6 +20731,11 @@ onmessage = async (ev) => {
 				return true;
 			});
 			this.map.pivotCaches.render(xmlStream, uniquePivotCaches);
+			const externalLinks = model.externalLinks ?? [];
+			if (externalLinks.length > 0) {
+				const externalReferenceModels = externalLinks.map((link) => ({ rId: link.rId }));
+				this.map.externalReferences.render(xmlStream, externalReferenceModels);
+			}
 			xmlStream.closeNode();
 		}
 		parseOpen(node) {
@@ -20227,11 +20764,13 @@ onmessage = async (ev) => {
 					this.model = {
 						sheets: this.map.sheets.model,
 						properties: this.map.workbookPr.model || {},
+						protection: this.map.workbookProtection.model,
 						views: this.map.bookViews.model,
-						calcProperties: {}
+						calcProperties: this.map.calcPr.model || {}
 					};
 					if (this.map.definedNames.model) this.model.definedNames = this.map.definedNames.model;
 					if (this.map.pivotCaches.model && this.map.pivotCaches.model.length > 0) this.model.pivotCaches = this.map.pivotCaches.model;
+					if (this.map.externalReferences.model && this.map.externalReferences.model.length > 0) this.model.externalReferences = this.map.externalReferences.model;
 					return false;
 				default: return true;
 			}
@@ -20257,18 +20796,19 @@ onmessage = async (ev) => {
 			});
 			const definedNames = [];
 			if (model.definedNames) model.definedNames.forEach((definedName) => {
+				const effectiveRanges = definedName.ranges?.length > 0 ? definedName.ranges : definedName.rawText ? [definedName.rawText] : [];
 				if (definedName.name === "_xlnm.Print_Area") {
 					worksheet = worksheets[definedName.localSheetId];
-					if (worksheet && definedName.ranges?.length > 0) {
+					if (worksheet && effectiveRanges.length > 0) {
 						if (!worksheet.pageSetup) worksheet.pageSetup = {};
-						const range = colCache.decodeEx(definedName.ranges[0]);
+						const range = colCache.decodeEx(effectiveRanges[0]);
 						worksheet.pageSetup.printArea = worksheet.pageSetup.printArea ? `${worksheet.pageSetup.printArea}&&${range.dimensions}` : range.dimensions;
 					}
 				} else if (definedName.name === "_xlnm.Print_Titles") {
 					worksheet = worksheets[definedName.localSheetId];
-					if (worksheet && definedName.ranges?.length > 0) {
+					if (worksheet && effectiveRanges.length > 0) {
 						if (!worksheet.pageSetup) worksheet.pageSetup = {};
-						const rangeString = definedName.ranges.join(",");
+						const rangeString = effectiveRanges.join(",");
 						const dollarRegex = /\$/g;
 						const rowRangeMatches = rangeString.match(/\$\d+:\$\d+/);
 						if (rowRangeMatches && rowRangeMatches.length) {
@@ -20310,6 +20850,135 @@ onmessage = async (ev) => {
 		}
 	};
 	//#endregion
+	//#region src/modules/excel/xlsx/xform/core/metadata-xform.ts
+	const NS_SPREADSHEETML = "http://schemas.openxmlformats.org/spreadsheetml/2006/main";
+	const NS_DYNAMIC_ARRAY = "http://schemas.microsoft.com/office/spreadsheetml/2017/dynamicarray";
+	const XLDAPR_EXT_URI = "{bdbb8cdc-fa1e-496e-a857-3c3f30c029c3}";
+	var MetadataXform = class extends BaseXform {
+		constructor(..._args) {
+			super(..._args);
+			this._metadataTypeNames = [];
+			this._cellMetadataTypeRefs = [];
+			this._inCellMetadata = false;
+			this._currentRcType = void 0;
+		}
+		get tag() {
+			return "metadata";
+		}
+		/**
+		* Render xl/metadata.xml for the given model.
+		* Only emits content when dynamicArrayCount > 0.
+		*/
+		render(xmlStream, model) {
+			if (!model || model.dynamicArrayCount <= 0) return;
+			xmlStream.openXml(StdDocAttributes);
+			xmlStream.openNode("metadata", {
+				xmlns: NS_SPREADSHEETML,
+				"xmlns:xda": NS_DYNAMIC_ARRAY
+			});
+			xmlStream.openNode("metadataTypes", { count: "1" });
+			xmlStream.leafNode("metadataType", {
+				name: "XLDAPR",
+				minSupportedVersion: "120000",
+				copy: "1",
+				pasteAll: "1",
+				pasteValues: "1",
+				merge: "1",
+				splitFirst: "1",
+				rowColShift: "1",
+				clearFormats: "1",
+				clearComments: "1",
+				assign: "1",
+				coerce: "1",
+				adjust: "1",
+				cellMeta: "1"
+			});
+			xmlStream.closeNode();
+			xmlStream.openNode("futureMetadata", {
+				name: "XLDAPR",
+				count: "1"
+			});
+			xmlStream.openNode("bk");
+			xmlStream.openNode("extLst");
+			xmlStream.openNode("ext", { uri: XLDAPR_EXT_URI });
+			xmlStream.leafNode("xda:dynamicArrayProperties", {
+				fDynamic: "1",
+				fCollapsed: "0"
+			});
+			xmlStream.closeNode();
+			xmlStream.closeNode();
+			xmlStream.closeNode();
+			xmlStream.closeNode();
+			xmlStream.openNode("cellMetadata", { count: "1" });
+			xmlStream.openNode("bk");
+			xmlStream.leafNode("rc", {
+				t: "1",
+				v: "0"
+			});
+			xmlStream.closeNode();
+			xmlStream.closeNode();
+			xmlStream.closeNode();
+		}
+		reset() {
+			this._metadataTypeNames = [];
+			this._cellMetadataTypeRefs = [];
+			this._inCellMetadata = false;
+			this._currentRcType = void 0;
+		}
+		parseOpen(node) {
+			switch (node.name) {
+				case "metadata":
+					this.reset();
+					return true;
+				case "metadataType":
+					this._metadataTypeNames.push(node.attributes.name || "");
+					return true;
+				case "cellMetadata":
+					this._inCellMetadata = true;
+					return true;
+				case "bk":
+					if (this._inCellMetadata) this._currentRcType = void 0;
+					return true;
+				case "rc":
+					if (this._inCellMetadata && node.attributes.t !== void 0) this._currentRcType = parseInt(node.attributes.t, 10);
+					return true;
+				case "metadataTypes":
+				case "futureMetadata":
+				case "extLst":
+				case "ext":
+				case "xda:dynamicArrayProperties": return true;
+				default: return false;
+			}
+		}
+		parseText() {}
+		parseClose(name) {
+			switch (name) {
+				case "bk":
+					if (this._inCellMetadata) {
+						this._cellMetadataTypeRefs.push(this._currentRcType ?? 0);
+						this._currentRcType = void 0;
+					}
+					return true;
+				case "cellMetadata":
+					this._inCellMetadata = false;
+					return true;
+				case "metadata": {
+					const dynamicArrayCmIndices = /* @__PURE__ */ new Set();
+					for (let i = 0; i < this._cellMetadataTypeRefs.length; i++) {
+						const typeIndex = this._cellMetadataTypeRefs[i];
+						if (this._metadataTypeNames[typeIndex - 1] === "XLDAPR") dynamicArrayCmIndices.add(i + 1);
+					}
+					this.model = {
+						hasDynamicArrays: dynamicArrayCmIndices.size > 0,
+						dynamicArrayCmIndices
+					};
+					return false;
+				}
+				default: return true;
+			}
+		}
+	};
+	//#endregion
 	//#region src/modules/excel/xlsx/xform/core/relationship-xform.ts
 	var RelationshipXform = class extends BaseXform {
 		render(xmlStream, model) {
@@ -20564,11 +21233,13 @@ onmessage = async (ev) => {
 				return true;
 			}
 			if (name === "border") {
-				const model = this.model = {};
+				const model = {};
+				let hasContent = false;
 				const add = (key, edgeModel, extensions) => {
 					if (edgeModel) {
 						if (extensions) Object.assign(edgeModel, extensions);
 						model[key] = edgeModel;
+						hasContent = true;
 					}
 				};
 				add("left", this.map.left.model);
@@ -20579,6 +21250,7 @@ onmessage = async (ev) => {
 					up: this.diagonalUp,
 					down: this.diagonalDown
 				});
+				this.model = hasContent ? model : void 0;
 			}
 			return false;
 		}
@@ -21507,7 +22179,8 @@ onmessage = async (ev) => {
 				locked: !(node.attributes.locked === "0"),
 				hidden: node.attributes.hidden === "1"
 			};
-			this.model = !model.locked || model.hidden ? model : null;
+			const isSignificant = !model.locked || model.hidden;
+			this.model = isSignificant ? model : null;
 		}
 		parseText() {}
 		parseClose() {
@@ -21911,15 +22584,15 @@ onmessage = async (ev) => {
 				family: 2,
 				scheme: "minor"
 			});
-			const type = cellType || Enums.ValueType.Number;
-			if (type !== Enums.ValueType.Checkbox && this.weakMap && this.weakMap.has(model)) return this.weakMap.get(model);
+			const type = cellType || 2;
+			if (type !== 12 && this.weakMap && this.weakMap.has(model)) return this.weakMap.get(model);
 			const style = {};
 			if (model.numFmt) style.numFmtId = this._addNumFmtStr(model.numFmt);
 			else switch (type) {
-				case Enums.ValueType.Number:
+				case 2:
 					style.numFmtId = this._addNumFmtStr("General");
 					break;
-				case Enums.ValueType.Date:
+				case 4:
 					style.numFmtId = this._addNumFmtStr("mm-dd-yy");
 					break;
 				default: break;
@@ -21938,14 +22611,14 @@ onmessage = async (ev) => {
 				"applyAlignment",
 				"applyProtection"
 			]) if (model[flag]) style[flag] = true;
-			if (type === Enums.ValueType.Checkbox) {
+			if (type === 12) {
 				this._hasCheckboxes = true;
 				style.alignment = style.alignment || {};
 				style.checkbox = true;
 				style.xfComplementIndex = 0;
 			}
 			const styleId = this._addStyle(style);
-			if (type !== Enums.ValueType.Checkbox && this.weakMap) this.weakMap.set(model, styleId);
+			if (type !== 12 && this.weakMap) this.weakMap.set(model, styleId);
 			return styleId;
 		}
 		getStyleModel(id) {
@@ -22137,8 +22810,8 @@ onmessage = async (ev) => {
 		}
 		addStyleModel(model, cellType) {
 			switch (cellType) {
-				case Enums.ValueType.Checkbox: throw new ExcelNotSupportedError("Checkbox cells", "require styles to be enabled (useStyles: true)");
-				case Enums.ValueType.Date: return this.dateStyleId;
+				case 12: throw new ExcelNotSupportedError("Checkbox cells", "require styles to be enabled (useStyles: true)");
+				case 4: return this.dateStyleId;
 				default: return 0;
 			}
 		}
@@ -22182,6 +22855,7 @@ onmessage = async (ev) => {
 		}
 		constructor(input, options, WorksheetReaderClass, HyperlinkReaderClass) {
 			super();
+			this.hasDynamicArrayMetadata = false;
 			this._totalBufferedBytes = 0;
 			this.input = input;
 			this.WorksheetReaderClass = WorksheetReaderClass;
@@ -22275,7 +22949,8 @@ onmessage = async (ev) => {
 			if (this.options.entries === "emit") this.emit("entry", payload);
 		}
 		async _parseRels(entry) {
-			this.workbookRels = await new RelationshipsXform().parseStream(iterateStream(entry));
+			const xform = new RelationshipsXform();
+			this.workbookRels = await xform.parseStream(iterateStream(entry));
 			this._workbookRelIdByTarget = Object.create(null);
 			for (const rel of this.workbookRels ?? []) if (rel?.Target && rel?.Id) this._workbookRelIdByTarget[rel.Target] = rel.Id;
 		}
@@ -22516,6 +23191,13 @@ onmessage = async (ev) => {
 				await this.styles.parseStream(iterateStream(entry));
 			}
 		}
+		async _parseMetadata(entry) {
+			const result = await new MetadataXform().parseStream(iterateStream(entry));
+			if (result) {
+				this.hasDynamicArrayMetadata = !!result.hasDynamicArrays;
+				this.dynamicArrayCmIndices = result.dynamicArrayCmIndices;
+			}
+		}
 		*_parseWorksheet(iterator, sheetNo) {
 			this._emitEntry({
 				type: "worksheet",
@@ -22586,6 +23268,9 @@ onmessage = async (ev) => {
 					case OOXML_PATHS.xlStyles:
 						await this._parseStyles(entry);
 						break;
+					case OOXML_PATHS.xlMetadata:
+						await this._parseMetadata(entry);
+						break;
 					default:
 						sheetNo = getWorksheetNoFromWorksheetPath(normalizedPath)?.toString();
 						if (sheetNo) if (!!this.workbookRels && !!this.model && (this.options.sharedStrings !== "cache" || !!this.sharedStrings)) {
@@ -24638,13 +25323,14 @@ self.onmessage = async function(event) {
 				this._localHeader = null;
 				return;
 			}
-			this._deflateWanted = !isProbablyIncompressibleChunks((function* (pending, current) {
+			const store = isProbablyIncompressibleChunks((function* (pending, current) {
 				for (const c of pending) if (c.length) yield c;
 				if (current.length) yield current;
 			})(this._pendingChunks, dataForDecision), {
 				sampleBytes: SMART_STORE_DECIDE_BYTES,
 				minDecisionBytes: SMART_STORE_DECIDE_BYTES
 			});
+			this._deflateWanted = !store;
 			this._sampleLen = 0;
 			this._compressionMethod = this._buildCompressionMethod(this._deflateWanted);
 			this._localHeader = null;
@@ -24892,7 +25578,8 @@ self.onmessage = async function(event) {
 			if (this._inputPos > 0) {
 				const flushData = this._inputBuf.slice(0, this._inputPos);
 				this._inputPos = 0;
-				const promise = this._pushChain = this._pushAsync(flushData, false).then(() => this._pushUnchained(data, final, callback), () => this._pushUnchained(data, final, callback));
+				const flushPromise = this._pushAsync(flushData, false);
+				const promise = this._pushChain = flushPromise.then(() => this._pushUnchained(data, final, callback), () => this._pushUnchained(data, final, callback));
 				promise.catch(() => {});
 				return promise;
 			}
@@ -26049,6 +26736,7 @@ self.onmessage = async function(event) {
 	function filterDrawingAnchors(anchors) {
 		return anchors.filter((a) => {
 			if (a == null) return false;
+			if (a.range?.pos !== void 0) return !!a.picture;
 			if (a.range?.br && a.shape) return true;
 			if (!a.range?.br && !a.picture) return false;
 			if (a.range?.br && !a.picture && !a.shape) return false;
@@ -26984,7 +27672,7 @@ self.onmessage = async function(event) {
 			address,
 			dataValidation,
 			marked: false
-		})).sort((a, b) => a.address.localeCompare(b.address));
+		})).sort((a, b) => colCache.compareAddress(a.address, b.address));
 		const dvMap = Object.fromEntries(dvList.map((dv) => [dv.address, dv]));
 		const matchCol = (addr, height, col) => {
 			for (let i = 0; i < height; i++) {
@@ -27712,6 +28400,69 @@ self.onmessage = async function(event) {
 		}
 	};
 	//#endregion
+	//#region src/modules/excel/xlsx/xform/sheet/ignored-errors-xform.ts
+	/**
+	* Boolean attribute names supported on <ignoredError> elements.
+	* These correspond to the OOXML spec CT_IgnoredError attributes.
+	*/
+	const BOOL_ATTRS = [
+		"numberStoredAsText",
+		"formula",
+		"formulaRange",
+		"unlockedFormula",
+		"emptyCellReference",
+		"listDataValidation",
+		"calculatedColumn",
+		"evalError",
+		"twoDigitTextYear"
+	];
+	/**
+	* Xform for the <ignoredErrors> element in a worksheet.
+	*
+	* Renders:
+	* ```xml
+	* <ignoredErrors>
+	*   <ignoredError sqref="A1:B10" numberStoredAsText="1" />
+	* </ignoredErrors>
+	* ```
+	*/
+	var IgnoredErrorsXform = class extends BaseXform {
+		get tag() {
+			return "ignoredErrors";
+		}
+		render(xmlStream, model) {
+			if (!model || model.length === 0) return;
+			xmlStream.openNode("ignoredErrors");
+			for (const entry of model) {
+				const attrs = { sqref: entry.ref };
+				for (const attr of BOOL_ATTRS) if (entry[attr]) attrs[attr] = 1;
+				xmlStream.leafNode("ignoredError", attrs);
+			}
+			xmlStream.closeNode();
+		}
+		parseOpen(node) {
+			switch (node.name) {
+				case "ignoredErrors":
+					this.model = [];
+					return true;
+				case "ignoredError": {
+					const entry = { ref: node.attributes.sqref ?? "" };
+					for (const attr of BOOL_ATTRS) if (node.attributes[attr] === "1" || node.attributes[attr] === "true") entry[attr] = true;
+					this.model.push(entry);
+					return true;
+				}
+				default: return true;
+			}
+		}
+		parseText() {}
+		parseClose(name) {
+			switch (name) {
+				case "ignoredErrors": return false;
+				default: return true;
+			}
+		}
+	};
+	//#endregion
 	//#region src/modules/excel/xlsx/xform/sheet/page-margins-xform.ts
 	var PageMarginsXform = class extends BaseXform {
 		get tag() {
@@ -27892,22 +28643,62 @@ self.onmessage = async function(event) {
 	//#endregion
 	//#region src/modules/excel/xlsx/xform/sheet/cell-xform.ts
 	function getValueType(v) {
-		if (v === null || v === void 0) return Enums.ValueType.Null;
-		if (v instanceof String || typeof v === "string") return Enums.ValueType.String;
-		if (typeof v === "number") return Enums.ValueType.Number;
-		if (typeof v === "boolean") return Enums.ValueType.Boolean;
-		if (v instanceof Date) return Enums.ValueType.Date;
-		if (v.text && v.hyperlink) return Enums.ValueType.Hyperlink;
-		if (v.formula) return Enums.ValueType.Formula;
-		if (v.error) return Enums.ValueType.Error;
+		if (v === null || v === void 0) return 0;
+		if (v instanceof String || typeof v === "string") return 3;
+		if (typeof v === "number") return 2;
+		if (typeof v === "boolean") return 9;
+		if (v instanceof Date) return 4;
+		if (v.text && v.hyperlink) return 5;
+		if (v.formula) return 6;
+		if (v.error) return 10;
 		throw new InvalidValueTypeError(typeof v, "Could not understand type of value");
 	}
 	function getEffectiveCellType(cell) {
 		switch (cell.type) {
-			case Enums.ValueType.Formula: return getValueType(cell.result);
+			case 6: return getValueType(cell.result);
 			default: return cell.type;
 		}
 	}
+	/**
+	* Extract the display form of a hyperlink cell value that came either from
+	* a shared-string rich-text payload (`{ richText: [...] }`) or from a
+	* plain scalar.
+	*
+	* Input comes from the XML parser (`raw: unknown`), so every nested value is
+	* treated defensively — the public `RichText` shape is only produced after
+	* runtime validation, never asserted.
+	*
+	* Returns:
+	*  - `text`:     always a string (flattened rich-text or `String(raw)`)
+	*  - `richText`: preserved if the source was a rich-text payload, else undefined
+	*
+	* This keeps the CellHyperlinkValue.text: string public contract intact while
+	* also letting the Hyperlink value class retain the formatted runs
+	* (see https://github.com/cjnoname/excelts/issues/142).
+	*/
+	function extractHyperlinkDisplay(raw) {
+		if (raw === null || raw === void 0) return { text: "" };
+		if (typeof raw === "string") return { text: raw };
+		if (typeof raw === "number" || typeof raw === "boolean") return { text: String(raw) };
+		if (typeof raw === "object") {
+			const obj = raw;
+			if (Array.isArray(obj.richText)) {
+				if (obj.richText.length === 0) return { text: "" };
+				const runs = obj.richText.map((rawRun) => {
+					const run = rawRun;
+					const normalized = { text: typeof run?.text === "string" ? run.text : "" };
+					if (run?.font !== null && typeof run?.font === "object") normalized.font = run.font;
+					return normalized;
+				});
+				return {
+					text: runs.map((r) => r.text).join(""),
+					richText: runs
+				};
+			}
+			if (typeof obj.error === "string") return { text: obj.error };
+		}
+		return { text: String(raw) };
+	}
 	var CellXform = class extends BaseXform {
 		constructor() {
 			super();
@@ -27924,26 +28715,35 @@ self.onmessage = async function(event) {
 				ref: model.address
 			});
 			switch (model.type) {
-				case Enums.ValueType.String:
-				case Enums.ValueType.RichText:
+				case 3:
+				case 8:
 					if (options.sharedStrings) model.ssId = options.sharedStrings.add(model.value);
 					break;
-				case Enums.ValueType.Date:
+				case 4:
 					if (options.date1904) model.date1904 = true;
 					break;
-				case Enums.ValueType.Hyperlink:
-					if (options.sharedStrings && model.text !== void 0 && model.text !== null) model.ssId = options.sharedStrings.add(model.text);
+				case 5:
+					if (options.sharedStrings) {
+						if (Array.isArray(model.richText) && model.richText.length > 0) model.ssId = options.sharedStrings.add({ richText: model.richText });
+						else if (model.text !== void 0 && model.text !== null) model.ssId = options.sharedStrings.add(model.text);
+					}
 					options.hyperlinks.push({
 						address: model.address,
 						target: model.hyperlink,
 						tooltip: model.tooltip
 					});
 					break;
-				case Enums.ValueType.Merge:
+				case 1:
 					options.merges.add(model);
 					break;
-				case Enums.ValueType.Formula:
+				case 6:
 					if (options.date1904) model.date1904 = true;
+					if (model.isDynamicArray) model.cm = 1;
+					if (model.hyperlink) options.hyperlinks.push({
+						address: model.address,
+						target: model.hyperlink,
+						tooltip: model.tooltip
+					});
 					if (model.shareType === "shared") model.si = options.siFormulae++;
 					if (model.formula) options.formulae[model.address] = model;
 					else if (model.sharedFormula) {
@@ -27984,29 +28784,29 @@ self.onmessage = async function(event) {
 					break;
 			}
 			switch (getValueType(model.result)) {
-				case Enums.ValueType.Null:
+				case 0:
 					xmlStream.leafNode("f", attrs, model.formula);
 					break;
-				case Enums.ValueType.String:
+				case 3:
 					xmlStream.addAttribute("t", "str");
 					xmlStream.leafNode("f", attrs, model.formula);
 					xmlStream.leafNode("v", null, model.result);
 					break;
-				case Enums.ValueType.Number:
+				case 2:
 					xmlStream.leafNode("f", attrs, model.formula);
 					xmlStream.leafNode("v", null, model.result);
 					break;
-				case Enums.ValueType.Boolean:
+				case 9:
 					xmlStream.addAttribute("t", "b");
 					xmlStream.leafNode("f", attrs, model.formula);
 					xmlStream.leafNode("v", null, model.result ? 1 : 0);
 					break;
-				case Enums.ValueType.Error:
+				case 10:
 					xmlStream.addAttribute("t", "e");
 					xmlStream.leafNode("f", attrs, model.formula);
 					xmlStream.leafNode("v", null, model.result.error);
 					break;
-				case Enums.ValueType.Date:
+				case 4:
 					xmlStream.leafNode("f", attrs, model.formula);
 					xmlStream.leafNode("v", null, dateToExcel(model.result, model.date1904));
 					break;
@@ -28014,29 +28814,30 @@ self.onmessage = async function(event) {
 			}
 		}
 		render(xmlStream, model) {
-			if (model.type === Enums.ValueType.Null && !model.styleId) return;
+			if (model.type === 0 && !model.styleId) return;
 			xmlStream.openNode("c");
 			xmlStream.addAttribute("r", model.address);
 			if (model.styleId) xmlStream.addAttribute("s", model.styleId);
+			if (model.cm) xmlStream.addAttribute("cm", model.cm);
 			switch (model.type) {
-				case Enums.ValueType.Null: break;
-				case Enums.ValueType.Number:
+				case 0: break;
+				case 2:
 					xmlStream.leafNode("v", null, model.value);
 					break;
-				case Enums.ValueType.Boolean:
+				case 9:
 					xmlStream.addAttribute("t", "b");
 					xmlStream.leafNode("v", null, model.value ? "1" : "0");
 					break;
-				case Enums.ValueType.Checkbox:
+				case 12:
 					xmlStream.addAttribute("t", "b");
 					xmlStream.leafNode("v", null, model.value ? "1" : "0");
 					break;
-				case Enums.ValueType.Error:
+				case 10:
 					xmlStream.addAttribute("t", "e");
 					xmlStream.leafNode("v", null, model.value.error);
 					break;
-				case Enums.ValueType.String:
-				case Enums.ValueType.RichText:
+				case 3:
+				case 8:
 					if (model.ssId !== void 0) {
 						xmlStream.addAttribute("t", "s");
 						xmlStream.leafNode("v", null, model.ssId);
@@ -28052,22 +28853,30 @@ self.onmessage = async function(event) {
 						xmlStream.leafNode("v", null, model.value);
 					}
 					break;
-				case Enums.ValueType.Date:
+				case 4:
 					xmlStream.leafNode("v", null, dateToExcel(model.value, model.date1904));
 					break;
-				case Enums.ValueType.Hyperlink:
-					if (model.ssId !== void 0) {
+				case 5:
+					if (model.formula || model.sharedFormula) this.renderFormula(xmlStream, model);
+					else if (model.ssId !== void 0) {
 						xmlStream.addAttribute("t", "s");
 						xmlStream.leafNode("v", null, model.ssId);
+					} else if (Array.isArray(model.richText) && model.richText.length > 0) {
+						xmlStream.addAttribute("t", "inlineStr");
+						xmlStream.openNode("is");
+						model.richText.forEach((text) => {
+							this.richTextXform.render(xmlStream, text);
+						});
+						xmlStream.closeNode("is");
 					} else {
 						xmlStream.addAttribute("t", "str");
 						xmlStream.leafNode("v", null, model.text);
 					}
 					break;
-				case Enums.ValueType.Formula:
+				case 6:
 					this.renderFormula(xmlStream, model);
 					break;
-				case Enums.ValueType.Merge: break;
+				case 1: break;
 				default: break;
 			}
 			xmlStream.closeNode();
@@ -28082,6 +28891,7 @@ self.onmessage = async function(event) {
 					this.model = { address: node.attributes.r };
 					this.t = node.attributes.t;
 					if (node.attributes.s) this.model.styleId = parseInt(node.attributes.s, 10);
+					if (node.attributes.cm) this.model.cm = parseInt(node.attributes.cm, 10);
 					return true;
 				case "f":
 					this.currentNode = "f";
@@ -28124,7 +28934,7 @@ self.onmessage = async function(event) {
 				case "c": {
 					const { model } = this;
 					if (model.formula || model.shareType) {
-						model.type = Enums.ValueType.Formula;
+						model.type = 6;
 						if (model.value) {
 							if (this.t === "str") model.result = model.value;
 							else if (this.t === "b") model.result = parseInt(model.value, 10) !== 0;
@@ -28134,35 +28944,35 @@ self.onmessage = async function(event) {
 						}
 					} else if (model.value !== void 0) switch (this.t) {
 						case "s":
-							model.type = Enums.ValueType.String;
+							model.type = 3;
 							model.value = parseInt(model.value, 10);
 							break;
 						case "str":
-							model.type = Enums.ValueType.String;
+							model.type = 3;
 							break;
 						case "inlineStr":
-							model.type = Enums.ValueType.String;
+							model.type = 3;
 							if (typeof model.value === "string" && model.value.includes("_x")) model.value = decodeOoxmlEscape(model.value);
 							break;
 						case "b":
-							model.type = Enums.ValueType.Boolean;
+							model.type = 9;
 							model.value = parseInt(model.value, 10) !== 0;
 							break;
 						case "e":
-							model.type = Enums.ValueType.Error;
+							model.type = 10;
 							model.value = { error: model.value };
 							break;
 						case "d":
-							model.type = Enums.ValueType.Date;
+							model.type = 4;
 							model.value = new Date(model.value);
 							break;
 						default:
-							model.type = Enums.ValueType.Number;
+							model.type = 2;
 							model.value = parseFloat(model.value);
 							break;
 					}
-					else if (model.styleId) model.type = Enums.ValueType.Null;
-					else model.type = Enums.ValueType.Merge;
+					else if (model.styleId) model.type = 0;
+					else model.type = 1;
 					return false;
 				}
 				case "f":
@@ -28197,19 +29007,23 @@ self.onmessage = async function(event) {
 			if (style) model.style = style;
 			if (model.styleId !== void 0) model.styleId = void 0;
 			switch (model.type) {
-				case Enums.ValueType.String:
+				case 3:
 					if (typeof model.value === "number") {
-						if (options.sharedStrings) model.value = options.sharedStrings.getString(model.value);
+						if (options.sharedStrings) {
+							const ssIndex = model.value;
+							model.value = options.sharedStrings.getString(ssIndex);
+							if (model.value === void 0) throw new ExcelError(`Invalid shared string index ${ssIndex} in cell ${model.address}: the xlsx file appears to be corrupted`);
+						}
 					}
-					if (model.value.richText) model.type = Enums.ValueType.RichText;
+					if (model.value && model.value.richText) model.type = 8;
 					break;
-				case Enums.ValueType.Number:
+				case 2:
 					if (style && isDateFmt(style.numFmt)) {
-						model.type = Enums.ValueType.Date;
+						model.type = 4;
 						model.value = excelToDate(model.value, options.date1904);
 					}
 					break;
-				case Enums.ValueType.Formula:
+				case 6:
 					if (model.result !== void 0 && typeof model.result === "number" && style && isDateFmt(style.numFmt)) model.result = excelToDate(model.result, options.date1904);
 					if (model.shareType === "shared") {
 						if (model.ref) options.formulae[model.si] = model.address;
@@ -28219,19 +29033,28 @@ self.onmessage = async function(event) {
 						}
 						delete model.si;
 					}
+					if (model.cm) {
+						if (options.dynamicArrayCmIndices) {
+							if (options.dynamicArrayCmIndices.has(model.cm)) model.isDynamicArray = true;
+						} else if (options.hasDynamicArrayMetadata) model.isDynamicArray = true;
+					}
+					delete model.cm;
 					break;
 				default: break;
 			}
 			const hyperlink = options.hyperlinkMap[model.address];
 			if (hyperlink) {
-				if (model.type === Enums.ValueType.Formula) {
-					model.text = model.result;
-					model.result = void 0;
-				} else {
-					model.text = model.value;
+				let source;
+				if (model.type === 6) source = model.result;
+				else {
+					source = model.value;
 					model.value = void 0;
 				}
-				model.type = Enums.ValueType.Hyperlink;
+				const display = extractHyperlinkDisplay(source);
+				model.text = display.text;
+				if (display.richText) model.richText = display.richText;
+				else delete model.richText;
+				model.type = 5;
 				model.hyperlink = hyperlink;
 			}
 			const comment = options.commentsMap && options.commentsMap[model.address];
@@ -28301,8 +29124,9 @@ self.onmessage = async function(event) {
 					spanMin = parseInt(spans, 10);
 					spanMax = colonIdx > -1 ? parseInt(spans.substring(colonIdx + 1), 10) : void 0;
 				}
+				const rowNumber = node.attributes.r ? parseInt(node.attributes.r, 10) : this.numRowsSeen;
 				const model = this.model = {
-					number: node.attributes.r ? parseInt(node.attributes.r, 10) : this.numRowsSeen,
+					number: rowNumber,
 					min: spanMin,
 					max: spanMax,
 					cells: []
@@ -28786,6 +29610,7 @@ self.onmessage = async function(event) {
 		drawing: new DrawingXform$1(),
 		conditionalFormattings: new ConditionalFormattingsXform(),
 		extLst: new ExtLstXform$1(),
+		ignoredErrors: new IgnoredErrorsXform(),
 		headerFooter: new HeaderFooterXform(),
 		rowBreaks: new RowBreaksXform(),
 		colBreaks: new ColBreaksXform()
@@ -28810,6 +29635,7 @@ self.onmessage = async function(event) {
 			this._formulae = {};
 			this._siFormulae = 0;
 			this.conditionalFormatting = [];
+			this.ignoredErrors = [];
 			this.rowBreaks = [];
 			this.colBreaks = [];
 			this.properties = Object.assign({}, {
@@ -28900,6 +29726,7 @@ self.onmessage = async function(event) {
 			this._writeDrawing();
 			this._writeBackground();
 			this._writeLegacyData();
+			this._writeIgnoredErrors();
 			this._writeExtLst();
 			this._writeCloseWorksheet();
 			this.stream.end();
@@ -29146,17 +29973,33 @@ self.onmessage = async function(event) {
 				};
 				throw new Error(`Invalid image range: "${range}". Expected a range like "A1:C3".`);
 			}
-			return {
+			if ("pos" in range && range.pos) return {
 				type: "image",
 				imageId,
 				range: {
-					tl: new Anchor(this, range.tl, 0).model,
-					br: range.br ? new Anchor(this, range.br, 0).model : void 0,
+					tl: {
+						nativeCol: 0,
+						nativeColOff: 0,
+						nativeRow: 0,
+						nativeRowOff: 0
+					},
 					ext: range.ext,
-					editAs: range.editAs
+					pos: range.pos
 				},
 				hyperlinks: range.hyperlinks
 			};
+			const cellRange = range;
+			return {
+				type: "image",
+				imageId,
+				range: {
+					tl: new Anchor(this, cellRange.tl, 0).model,
+					br: cellRange.br ? new Anchor(this, cellRange.br, 0).model : void 0,
+					ext: cellRange.ext,
+					editAs: cellRange.editAs
+				},
+				hyperlinks: cellRange.hyperlinks
+			};
 		}
 		async protect(password, options) {
 			this.sheetProtection = { sheet: true };
@@ -29215,6 +30058,7 @@ self.onmessage = async function(event) {
 			}
 			if (row.hasValues || row.height != null) {
 				const { model } = row;
+				if (!model) return;
 				const options = {
 					styles: this._workbook.styles,
 					sharedStrings: this.useSharedStrings ? this._workbook.sharedStrings : void 0,
@@ -29226,6 +30070,9 @@ self.onmessage = async function(event) {
 				};
 				xform.row.prepare(model, options);
 				this.stream.write(xform.row.toXml(model));
+				if (model.cells) {
+					for (const cell of model.cells) if (cell && cell.isDynamicArray) this._workbook.dynamicArrayCount++;
+				}
 				if (options.comments.length) {
 					this.hasComments = true;
 					this._sheetCommentsWriter.addComments(options.comments);
@@ -29268,6 +30115,9 @@ self.onmessage = async function(event) {
 			const model = { conditionalFormattings: this.conditionalFormatting };
 			this.stream.write(xform.extLst.toXml(model));
 		}
+		_writeIgnoredErrors() {
+			if (this.ignoredErrors.length > 0) this.stream.write(xform.ignoredErrors.toXml(this.ignoredErrors));
+		}
 		_writeRowBreaks() {
 			this.stream.write(xform.rowBreaks.toXml(this.rowBreaks));
 		}
@@ -29330,6 +30180,7 @@ self.onmessage = async function(event) {
 			if (this._background) {
 				if (this._background.imageId !== void 0) {
 					const image = this._workbook.getImage(this._background.imageId);
+					if (!image) return;
 					const pictureId = this._sheetRelsWriter.addMedia({
 						Target: mediaRelTargetFromRels(image.name),
 						Type: RelType.Image
@@ -29356,6 +30207,20 @@ self.onmessage = async function(event) {
 	};
 	//#endregion
 	//#region src/modules/excel/utils/shared-strings.ts
+	/**
+	* Canonical JSON serializer with sorted object keys.
+	*
+	* Used to derive an insertion-order-independent dedupe key for rich-text
+	* shared-string entries. Two semantically identical run/font objects must
+	* map to the same key regardless of the order their properties were assigned.
+	*/
+	function canonicalStringify(value) {
+		if (value === null || typeof value !== "object") return JSON.stringify(value);
+		if (Array.isArray(value)) return `[${value.map(canonicalStringify).join(",")}]`;
+		const keys = Object.keys(value).sort();
+		const obj = value;
+		return `{${keys.map((k) => `${JSON.stringify(k)}:${canonicalStringify(obj[k])}`).join(",")}}`;
+	}
 	var SharedStrings = class {
 		constructor() {
 			this._values = [];
@@ -29375,9 +30240,10 @@ self.onmessage = async function(event) {
 			return this._values[index];
 		}
 		add(value) {
-			let index = this._hash[value];
+			const key = typeof value === "string" ? `s:${value}` : `r:${canonicalStringify(value.richText)}`;
+			let index = this._hash[key];
 			if (index === void 0) {
-				index = this._hash[value] = this._values.length;
+				index = this._hash[key] = this._values.length;
 				this._values.push(value);
 			}
 			this._totalRefs++;
@@ -29773,6 +30639,33 @@ self.onmessage = async function(event) {
 		return result;
 	}
 	//#endregion
+	//#region src/modules/excel/utils/workbook-protection.ts
+	/**
+	* Build a workbook-protection object with optional password hashing.
+	*
+	* This is the shared implementation used by both `Workbook.protect()` and
+	* `WorkbookWriter.protect()`. The caller is responsible for assigning the
+	* result to its own `protection` field.
+	*
+	* @param password - Optional password to hash
+	* @param options  - Optional protection flags (lockStructure, lockWindows, lockRevision, spinCount)
+	* @returns A fully-populated workbook-protection object
+	*/
+	async function buildWorkbookProtection(password, options) {
+		const protection = {
+			lockStructure: options?.lockStructure ?? true,
+			lockWindows: options?.lockWindows,
+			lockRevision: options?.lockRevision
+		};
+		if (password) {
+			protection.algorithmName = "SHA-512";
+			protection.saltValue = uint8ArrayToBase64(Encryptor.randomBytes(16));
+			protection.spinCount = options?.spinCount != null && Number.isFinite(options.spinCount) ? Math.round(Math.max(0, options.spinCount)) : 1e5;
+			protection.hashValue = await Encryptor.convertPasswordToHash(password, "SHA-512", protection.saltValue, protection.spinCount);
+		}
+		return protection;
+	}
+	//#endregion
 	//#region src/modules/excel/xlsx/xform/core/app-heading-pairs-xform.ts
 	var AppHeadingPairsXform = class extends BaseXform {
 		render(xmlStream, model) {
@@ -29966,10 +30859,18 @@ self.onmessage = async function(event) {
 				PartName: toContentTypesPartName(OOXML_PATHS.xlStyles),
 				ContentType: "application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml"
 			});
+			if (model.externalLinks && model.externalLinks.length > 0) for (const link of model.externalLinks) xmlStream.leafNode("Override", {
+				PartName: toContentTypesPartName(externalLinkPath(link.index)),
+				ContentType: "application/vnd.openxmlformats-officedocument.spreadsheetml.externalLink+xml"
+			});
 			if (model.hasCheckboxes) xmlStream.leafNode("Override", {
 				PartName: toContentTypesPartName(OOXML_PATHS.xlFeaturePropertyBag),
 				ContentType: "application/vnd.ms-excel.featurepropertybag+xml"
 			});
+			if (model.hasDynamicArrayFormulas) xmlStream.leafNode("Override", {
+				PartName: toContentTypesPartName(OOXML_PATHS.xlMetadata),
+				ContentType: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheetMetadata+xml"
+			});
 			if (model.sharedStrings && model.sharedStrings.count) xmlStream.leafNode("Override", {
 				PartName: toContentTypesPartName(OOXML_PATHS.xlSharedStrings),
 				ContentType: "application/vnd.openxmlformats-officedocument.spreadsheetml.sharedStrings+xml"
@@ -30236,7 +31137,9 @@ self.onmessage = async function(event) {
 		}
 		reconcilePicture(model, options) {
 			if (model && model.rId) {
-				const match = options.rels[model.rId].Target.match(/.*\/media\/(.+[.][a-zA-Z]{3,4})/);
+				const rel = options.rels[model.rId];
+				if (!rel) return;
+				const match = rel.Target.match(/.*\/media\/(.+[.][a-zA-Z]{3,4})/);
 				if (match) {
 					const name = match[1];
 					const mediaId = options.mediaIndex[name];
@@ -30251,85 +31154,9 @@ self.onmessage = async function(event) {
 		}
 	};
 	//#endregion
-	//#region src/modules/excel/xlsx/xform/drawing/cell-position-xform.ts
-	var CellPositionXform = class extends BaseXform {
-		constructor(options) {
-			super();
-			this.tag = options.tag;
-			this.map = {
-				"xdr:col": new IntegerXform({
-					tag: "xdr:col",
-					zero: true
-				}),
-				"xdr:colOff": new IntegerXform({
-					tag: "xdr:colOff",
-					zero: true
-				}),
-				"xdr:row": new IntegerXform({
-					tag: "xdr:row",
-					zero: true
-				}),
-				"xdr:rowOff": new IntegerXform({
-					tag: "xdr:rowOff",
-					zero: true
-				})
-			};
-			this.model = {
-				nativeCol: 0,
-				nativeColOff: 0,
-				nativeRow: 0,
-				nativeRowOff: 0
-			};
-		}
-		render(xmlStream, model) {
-			xmlStream.openNode(this.tag);
-			this.map["xdr:col"].render(xmlStream, model.nativeCol);
-			this.map["xdr:colOff"].render(xmlStream, model.nativeColOff);
-			this.map["xdr:row"].render(xmlStream, model.nativeRow);
-			this.map["xdr:rowOff"].render(xmlStream, model.nativeRowOff);
-			xmlStream.closeNode();
-		}
-		parseOpen(node) {
-			if (this.parser) {
-				this.parser.parseOpen(node);
-				return true;
-			}
-			switch (node.name) {
-				case this.tag:
-					this.reset();
-					break;
-				default:
-					this.parser = this.map[node.name];
-					if (this.parser) this.parser.parseOpen(node);
-					break;
-			}
-			return true;
-		}
-		parseText(text) {
-			if (this.parser) this.parser.parseText(text);
-		}
-		parseClose(name) {
-			if (this.parser) {
-				if (!this.parser.parseClose(name)) this.parser = void 0;
-				return true;
-			}
-			switch (name) {
-				case this.tag:
-					this.model = {
-						nativeCol: this.map["xdr:col"].model,
-						nativeColOff: this.map["xdr:colOff"].model,
-						nativeRow: this.map["xdr:row"].model,
-						nativeRowOff: this.map["xdr:rowOff"].model
-					};
-					return false;
-				default: return true;
-			}
-		}
-	};
-	//#endregion
 	//#region src/modules/excel/xlsx/xform/drawing/ext-xform.ts
 	/** https://en.wikipedia.org/wiki/Office_Open_XML_file_formats#DrawingML */
-	const EMU_PER_PIXEL_AT_96_DPI = 9525;
+	const EMU_PER_PIXEL_AT_96_DPI$1 = 9525;
 	var ExtXform = class extends BaseXform {
 		constructor(options) {
 			super();
@@ -30342,8 +31169,8 @@ self.onmessage = async function(event) {
 		}
 		render(xmlStream, model) {
 			xmlStream.openNode(this.tag);
-			const width = Math.floor(model.width * EMU_PER_PIXEL_AT_96_DPI);
-			const height = Math.floor(model.height * EMU_PER_PIXEL_AT_96_DPI);
+			const width = Math.floor(model.width * EMU_PER_PIXEL_AT_96_DPI$1);
+			const height = Math.floor(model.height * EMU_PER_PIXEL_AT_96_DPI$1);
 			xmlStream.addAttribute("cx", width);
 			xmlStream.addAttribute("cy", height);
 			xmlStream.closeNode();
@@ -30351,8 +31178,8 @@ self.onmessage = async function(event) {
 		parseOpen(node) {
 			if (node.name === this.tag) {
 				this.model = {
-					width: parseInt(node.attributes.cx ?? "0", 10) / EMU_PER_PIXEL_AT_96_DPI,
-					height: parseInt(node.attributes.cy ?? "0", 10) / EMU_PER_PIXEL_AT_96_DPI
+					width: parseInt(node.attributes.cx ?? "0", 10) / EMU_PER_PIXEL_AT_96_DPI$1,
+					height: parseInt(node.attributes.cy ?? "0", 10) / EMU_PER_PIXEL_AT_96_DPI$1
 				};
 				return true;
 			}
@@ -30729,6 +31556,182 @@ self.onmessage = async function(event) {
 		}
 	};
 	//#endregion
+	//#region src/modules/excel/xlsx/xform/drawing/absolute-anchor-xform.ts
+	/** https://en.wikipedia.org/wiki/Office_Open_XML_file_formats#DrawingML */
+	const EMU_PER_PIXEL_AT_96_DPI = 9525;
+	/**
+	* Xform for the <xdr:pos> element (absolute position in EMU).
+	* Converts between EMU (in XML) and pixels (in model).
+	*/
+	var PosXform = class extends BaseXform {
+		constructor() {
+			super();
+			this.map = {};
+			this.model = {
+				x: 0,
+				y: 0
+			};
+		}
+		get tag() {
+			return "xdr:pos";
+		}
+		render(xmlStream, model) {
+			xmlStream.leafNode(this.tag, {
+				x: Math.floor(model.x * EMU_PER_PIXEL_AT_96_DPI),
+				y: Math.floor(model.y * EMU_PER_PIXEL_AT_96_DPI)
+			});
+		}
+		parseOpen(node) {
+			if (node.name === this.tag) {
+				this.model = {
+					x: parseInt(node.attributes.x ?? "0", 10) / EMU_PER_PIXEL_AT_96_DPI,
+					y: parseInt(node.attributes.y ?? "0", 10) / EMU_PER_PIXEL_AT_96_DPI
+				};
+				return true;
+			}
+			return false;
+		}
+		parseText() {}
+		parseClose() {
+			return false;
+		}
+	};
+	/**
+	* Xform for <xdr:absoluteAnchor> — images positioned by absolute coordinates
+	* rather than cell references.
+	*
+	* Structure:
+	* ```xml
+	* <xdr:absoluteAnchor>
+	*   <xdr:pos x="0" y="0"/>
+	*   <xdr:ext cx="1000000" cy="1000000"/>
+	*   <xdr:pic>...</xdr:pic>
+	*   <xdr:clientData/>
+	* </xdr:absoluteAnchor>
+	* ```
+	*/
+	var AbsoluteAnchorXform = class extends BaseCellAnchorXform {
+		constructor() {
+			super();
+			this.map = {
+				"xdr:pos": new PosXform(),
+				"xdr:ext": new ExtXform({ tag: "xdr:ext" }),
+				"xdr:pic": new PicXform(),
+				"xdr:clientData": new StaticXform({ tag: "xdr:clientData" })
+			};
+		}
+		get tag() {
+			return "xdr:absoluteAnchor";
+		}
+		prepare(model, options) {
+			if (model.picture) this.map["xdr:pic"].prepare(model.picture, options);
+		}
+		render(xmlStream, model) {
+			xmlStream.openNode(this.tag);
+			this.map["xdr:pos"].render(xmlStream, model.range.pos ?? {
+				x: 0,
+				y: 0
+			});
+			this.map["xdr:ext"].render(xmlStream, model.range.ext);
+			if (model.picture) this.map["xdr:pic"].render(xmlStream, model.picture);
+			this.map["xdr:clientData"].render(xmlStream, {});
+			xmlStream.closeNode();
+		}
+		parseClose(name) {
+			if (this.parser) {
+				if (!this.parser.parseClose(name)) this.parser = void 0;
+				return true;
+			}
+			switch (name) {
+				case this.tag:
+					this.model.range.pos = this.map["xdr:pos"].model;
+					this.model.range.ext = this.map["xdr:ext"].model;
+					this.model.picture = this.map["xdr:pic"].model;
+					return false;
+				default: return true;
+			}
+		}
+		reconcile(model, options) {
+			model.medium = this.reconcilePicture(model.picture, options);
+		}
+	};
+	//#endregion
+	//#region src/modules/excel/xlsx/xform/drawing/cell-position-xform.ts
+	var CellPositionXform = class extends BaseXform {
+		constructor(options) {
+			super();
+			this.tag = options.tag;
+			this.map = {
+				"xdr:col": new IntegerXform({
+					tag: "xdr:col",
+					zero: true
+				}),
+				"xdr:colOff": new IntegerXform({
+					tag: "xdr:colOff",
+					zero: true
+				}),
+				"xdr:row": new IntegerXform({
+					tag: "xdr:row",
+					zero: true
+				}),
+				"xdr:rowOff": new IntegerXform({
+					tag: "xdr:rowOff",
+					zero: true
+				})
+			};
+			this.model = {
+				nativeCol: 0,
+				nativeColOff: 0,
+				nativeRow: 0,
+				nativeRowOff: 0
+			};
+		}
+		render(xmlStream, model) {
+			xmlStream.openNode(this.tag);
+			this.map["xdr:col"].render(xmlStream, model.nativeCol);
+			this.map["xdr:colOff"].render(xmlStream, model.nativeColOff);
+			this.map["xdr:row"].render(xmlStream, model.nativeRow);
+			this.map["xdr:rowOff"].render(xmlStream, model.nativeRowOff);
+			xmlStream.closeNode();
+		}
+		parseOpen(node) {
+			if (this.parser) {
+				this.parser.parseOpen(node);
+				return true;
+			}
+			switch (node.name) {
+				case this.tag:
+					this.reset();
+					break;
+				default:
+					this.parser = this.map[node.name];
+					if (this.parser) this.parser.parseOpen(node);
+					break;
+			}
+			return true;
+		}
+		parseText(text) {
+			if (this.parser) this.parser.parseText(text);
+		}
+		parseClose(name) {
+			if (this.parser) {
+				if (!this.parser.parseClose(name)) this.parser = void 0;
+				return true;
+			}
+			switch (name) {
+				case this.tag:
+					this.model = {
+						nativeCol: this.map["xdr:col"].model,
+						nativeColOff: this.map["xdr:colOff"].model,
+						nativeRow: this.map["xdr:row"].model,
+						nativeRowOff: this.map["xdr:rowOff"].model
+					};
+					return false;
+				default: return true;
+			}
+		}
+	};
+	//#endregion
 	//#region src/modules/excel/xlsx/xform/drawing/one-cell-anchor-xform.ts
 	var OneCellAnchorXform = class extends BaseCellAnchorXform {
 		constructor() {
@@ -30961,14 +31964,17 @@ self.onmessage = async function(event) {
 	//#endregion
 	//#region src/modules/excel/xlsx/xform/drawing/drawing-xform.ts
 	function getAnchorType(model) {
-		return (typeof model.range === "string" ? colCache.decode(model.range) : model.range).br ? "xdr:twoCellAnchor" : "xdr:oneCellAnchor";
+		const range = typeof model.range === "string" ? colCache.decode(model.range) : model.range;
+		if (range.pos !== void 0) return "xdr:absoluteAnchor";
+		return range.br ? "xdr:twoCellAnchor" : "xdr:oneCellAnchor";
 	}
 	var DrawingXform = class DrawingXform extends BaseXform {
 		constructor() {
 			super();
 			this.map = {
 				"xdr:twoCellAnchor": new TwoCellAnchorXform(),
-				"xdr:oneCellAnchor": new OneCellAnchorXform()
+				"xdr:oneCellAnchor": new OneCellAnchorXform(),
+				"xdr:absoluteAnchor": new AbsoluteAnchorXform()
 			};
 			this.model = { anchors: [] };
 		}
@@ -31025,7 +32031,8 @@ self.onmessage = async function(event) {
 		}
 		reconcile(model, options) {
 			model.anchors.forEach((anchor) => {
-				if (anchor.br) this.map["xdr:twoCellAnchor"].reconcile(anchor, options);
+				if (anchor.range?.pos !== void 0) this.map["xdr:absoluteAnchor"].reconcile(anchor, options);
+				else if (anchor.br) this.map["xdr:twoCellAnchor"].reconcile(anchor, options);
 				else this.map["xdr:oneCellAnchor"].reconcile(anchor, options);
 			});
 		}
@@ -31308,6 +32315,7 @@ self.onmessage = async function(event) {
 			this.compressionLevel = Math.max(0, Math.min(9, level));
 			this.media = [];
 			this.commentRefs = [];
+			this.dynamicArrayCount = 0;
 			this._trueStreaming = options.trueStreaming ?? false;
 			this.zip = new StreamingZip((err, data, final) => {
 				if (err) this.stream.emit("error", err);
@@ -31329,6 +32337,16 @@ self.onmessage = async function(event) {
 		get definedNames() {
 			return this._definedNames;
 		}
+		/**
+		* The default font for the workbook (fontId=0 / "Normal" style).
+		* Must be set before any worksheet rows are committed.
+		*/
+		get defaultFont() {
+			return this.styles.defaultFont;
+		}
+		set defaultFont(font) {
+			if (this.styles.setDefaultFont) this.styles.setDefaultFont(font);
+		}
 		/** @internal */
 		_openStream(path) {
 			const stream = new StreamBuf({
@@ -31380,6 +32398,7 @@ self.onmessage = async function(event) {
 				this.addSharedStrings(),
 				this.addStyles(),
 				this.addFeaturePropertyBag(),
+				this.addMetadata(),
 				this.addWorkbookRels()
 			]);
 			await this.addWorkbook();
@@ -31402,6 +32421,19 @@ self.onmessage = async function(event) {
 		getImage(id) {
 			return this.media[id];
 		}
+		/**
+		* Protect the workbook structure with an optional password.
+		* Prevents users from adding, deleting, renaming, moving, or copying worksheets.
+		*/
+		async protect(password, options) {
+			this.protection = await buildWorkbookProtection(password, options);
+		}
+		/**
+		* Remove workbook structure protection.
+		*/
+		unprotect() {
+			this.protection = void 0;
+		}
 		addWorksheet(name, options) {
 			const opts = options || {};
 			const useSharedStrings = opts.useSharedStrings !== void 0 ? opts.useSharedStrings : this.useSharedStrings;
@@ -31485,7 +32517,8 @@ self.onmessage = async function(event) {
 					commentRefs: this.commentRefs,
 					media: this.media,
 					drawings,
-					hasCheckboxes: this.styles.hasCheckboxes
+					hasCheckboxes: this.styles.hasCheckboxes,
+					hasDynamicArrayFormulas: this.dynamicArrayCount > 0
 				};
 				const xform = new ContentTypesXform();
 				this._addFile(xform.toXml(model), OOXML_PATHS.contentTypes);
@@ -31565,6 +32598,12 @@ self.onmessage = async function(event) {
 			}
 			return Promise.resolve();
 		}
+		addMetadata() {
+			if (this.dynamicArrayCount <= 0) return Promise.resolve();
+			const xform = new MetadataXform();
+			this._addFile(xform.toXml({ dynamicArrayCount: this.dynamicArrayCount }), OOXML_PATHS.xlMetadata);
+			return Promise.resolve();
+		}
 		addWorkbookRels() {
 			let count = 1;
 			const relationships = [{
@@ -31586,6 +32625,11 @@ self.onmessage = async function(event) {
 				Type: RelType.FeaturePropertyBag,
 				Target: OOXML_REL_TARGETS.workbookFeaturePropertyBag
 			});
+			if (this.dynamicArrayCount > 0) relationships.push({
+				Id: `rId${count++}`,
+				Type: RelType.SheetMetadata,
+				Target: OOXML_REL_TARGETS.workbookMetadata
+			});
 			this._worksheets.forEach((ws) => {
 				if (ws) {
 					ws.rId = `rId${count++}`;
@@ -31608,6 +32652,7 @@ self.onmessage = async function(event) {
 				definedNames: this._definedNames.model,
 				views: this.views,
 				properties: {},
+				protection: this.protection,
 				calcProperties: {}
 			};
 			return new Promise((resolve) => {
@@ -31922,6 +32967,21 @@ self.onmessage = async function(event) {
 				case "image": {
 					const range = this.range;
 					if (!range) throw new ImageError("Image has no range");
+					if (range.pos) return {
+						type: this.type,
+						imageId: this.imageId ?? "",
+						hyperlinks: range.hyperlinks,
+						range: {
+							tl: {
+								nativeCol: 0,
+								nativeColOff: 0,
+								nativeRow: 0,
+								nativeRowOff: 0
+							},
+							ext: range.ext,
+							pos: range.pos
+						}
+					};
 					return {
 						type: this.type,
 						imageId: this.imageId ?? "",
@@ -31958,7 +33018,13 @@ self.onmessage = async function(event) {
 						}, 0),
 						editAs: "oneCell"
 					};
-				} else if (range) this.range = {
+				} else if (range && "pos" in range && range.pos) this.range = {
+					tl: new Anchor(this.worksheet, null, 0),
+					ext: range.ext,
+					hyperlinks: hyperlinks || ("hyperlinks" in range ? range.hyperlinks : void 0),
+					pos: range.pos
+				};
+				else if (range) this.range = {
 					tl: new Anchor(this.worksheet, range.tl, 0),
 					br: range.br ? new Anchor(this.worksheet, range.br, 0) : void 0,
 					ext: range.ext,
@@ -31981,7 +33047,8 @@ self.onmessage = async function(event) {
 				br: this.range.br ? this.range.br.clone(target) : void 0,
 				ext: this.range.ext ? { ...this.range.ext } : void 0,
 				editAs: this.range.editAs,
-				hyperlinks: this.range.hyperlinks ? { ...this.range.hyperlinks } : void 0
+				hyperlinks: this.range.hyperlinks ? { ...this.range.hyperlinks } : void 0,
+				pos: this.range.pos ? { ...this.range.pos } : void 0
 			};
 			return cloned;
 		}
@@ -32436,8 +33503,8 @@ self.onmessage = async function(event) {
 				count: 103,
 				max: 104,
 				min: 105,
-				stdDev: 106,
-				var: 107,
+				stdDev: 107,
+				var: 110,
 				sum: 109
 			};
 		}
@@ -37779,7 +38846,7 @@ self.onmessage = async function(event) {
 	function getCellTextWidthPx(cell) {
 		const cellType = cell.effectiveType;
 		const font = cell.font;
-		if (cellType === ValueType.RichText) {
+		if (cellType === 8) {
 			const value = cell.value;
 			if (value && typeof value === "object" && "richText" in value) return measureRichTextWidthPx(value.richText, font);
 		}
@@ -37799,7 +38866,7 @@ self.onmessage = async function(event) {
 	function getCellHeightPt(cell, mdw, columnWidthPx) {
 		const font = cell.font;
 		const alignment = cell.alignment;
-		if (cell.effectiveType === ValueType.RichText) {
+		if (cell.effectiveType === 8) {
 			const value = cell.value;
 			if (value && typeof value === "object" && "richText" in value) return calculateRichTextAutoFitHeight(value.richText, font, alignment, columnWidthPx);
 		}
@@ -37879,6 +38946,7 @@ self.onmessage = async function(event) {
 			this.pivotTables = [];
 			this.conditionalFormattings = [];
 			this.formControls = [];
+			this.ignoredErrors = [];
 			this._watermark = null;
 		}
 		get name() {
@@ -37992,7 +39060,7 @@ self.onmessage = async function(event) {
 		spliceColumns(start, count, ...inserts) {
 			for (const merge of Object.values(this._merges)) for (let r = merge.top; r <= merge.bottom; r++) for (let c = merge.left; c <= merge.right; c++) {
 				const cell = this.findCell(r, c);
-				if (cell && cell.type === Enums.ValueType.Merge) cell.unmerge();
+				if (cell && cell.type === 1) cell.unmerge();
 			}
 			const nRows = this._rows.length;
 			if (inserts.length > 0) for (let i = 0; i < nRows; i++) {
@@ -38215,7 +39283,7 @@ self.onmessage = async function(event) {
 		spliceRows(start, count, ...inserts) {
 			for (const merge of Object.values(this._merges)) for (let r = merge.top; r <= merge.bottom; r++) for (let c = merge.left; c <= merge.right; c++) {
 				const cell = this.findCell(r, c);
-				if (cell && cell.type === Enums.ValueType.Merge) cell.unmerge();
+				if (cell && cell.type === 1) cell.unmerge();
 			}
 			const nKeep = start + count;
 			const nInserts = inserts.length;
@@ -38403,7 +39471,7 @@ self.onmessage = async function(event) {
 			for (let i = dimensions.top; i <= dimensions.bottom; i++) for (let j = dimensions.left; j <= dimensions.right; j++) {
 				const cell = this.findCell(i, j);
 				if (cell) {
-					if (cell.type === Enums.ValueType.Merge) this._unMergeMaster(cell.master);
+					if (cell.type === 1) this._unMergeMaster(cell.master);
 					else if (this._merges[cell.address]) this._unMergeMaster(cell);
 				}
 			}
@@ -38578,7 +39646,11 @@ self.onmessage = async function(event) {
 		*/
 		addTable(model) {
 			const table = new Table(this, model);
+			const nameKey = table.name.toLowerCase();
+			if (this.tables[table.name]) throw new TableError(`Table name "${table.name}" already exists in worksheet "${this.name}".`);
+			if (this.workbook._tableNames.has(nameKey)) throw new TableError(`Table name "${table.name}" already exists in another worksheet. Table names must be unique across the entire workbook (case-insensitive).`);
 			this.tables[table.name] = table;
+			this.workbook._tableNames.add(nameKey);
 			return table;
 		}
 		/**
@@ -38591,6 +39663,7 @@ self.onmessage = async function(event) {
 		* Delete table by name
 		*/
 		removeTable(name) {
+			if (this.tables[name]) this.workbook._tableNames.delete(name.toLowerCase());
 			delete this.tables[name];
 		}
 		/**
@@ -38684,7 +39757,7 @@ self.onmessage = async function(event) {
 				if (row.hidden) return;
 				const cell = row.findCell(colNum);
 				if (!cell) return;
-				if (cell.type === Enums.ValueType.Merge) return;
+				if (cell.type === 1) return;
 				if (cell.isMerged) {
 					const mergeRange = this._merges[cell.address];
 					if (mergeRange && mergeRange.left !== mergeRange.right) return;
@@ -38711,7 +39784,7 @@ self.onmessage = async function(event) {
 			const mdw = getMaxDigitWidth();
 			let maxHeightPt = 0;
 			row.eachCell((cell) => {
-				if (cell.type === Enums.ValueType.Merge) return;
+				if (cell.type === 1) return;
 				if (cell.isMerged) {
 					const mergeRange = this._merges[cell.address];
 					if (mergeRange && mergeRange.top !== mergeRange.bottom) return;
@@ -38765,6 +39838,7 @@ self.onmessage = async function(event) {
 				pivotTables: this.pivotTables,
 				conditionalFormattings: this.conditionalFormattings,
 				formControls: this.formControls.map((fc) => fc.model),
+				ignoredErrors: this.ignoredErrors,
 				watermark: this._watermark,
 				drawing: this._drawing
 			};
@@ -38833,10 +39907,12 @@ self.onmessage = async function(event) {
 				const t = new Table(this, table);
 				t.model = table;
 				tables[table.name] = t;
+				this.workbook._tableNames.add(table.name.toLowerCase());
 				return tables;
 			}, {});
 			this.pivotTables = value.pivotTables;
 			this.conditionalFormattings = value.conditionalFormattings;
+			this.ignoredErrors = value.ignoredErrors ?? [];
 			this.formControls = [];
 			this._drawing = value.drawing;
 		}
@@ -39673,6 +40749,144 @@ self.onmessage = async function(event) {
 		}
 	};
 	//#endregion
+	//#region src/modules/excel/utils/external-link-formula.ts
+	/**
+	* Utilities for manipulating the external-workbook prefix in formula strings.
+	*
+	* Excel formula strings containing external workbook references have the
+	* shape `[<workbook>]Sheet!Ref` where `<workbook>` is either
+	*
+	*   - a 1-based numeric index  — `[1]Sheet1!A1`  (the canonical on-disk form
+	*     stored inside `<f>` elements of worksheet XML), or
+	*   - a filename / relative path — `[测试.xlsx]Sheet1!A1`  (what Excel
+	*     displays in the formula bar; not part of the OOXML storage contract,
+	*     but produced by hand-written formulas and some older tools).
+	*
+	* When writing, excelts always emits the numeric form — indices map
+	* positionally into the workbook's `<externalReferences>` list. When a
+	* formula arrives with the filename form, the writer assigns (or reuses) an
+	* ExternalLinkModel with that filename as its `target` and rewrites the
+	* formula to the numeric form. This matches how Excel itself stores formulas
+	* and makes them round-trippable.
+	*
+	* The quoted variant `'[file.xlsx]Sheet with space'!A1` is handled too — Excel
+	* wraps the `[name]Sheet` segment in single quotes when the sheet name needs
+	* quoting. The matching logic here recognises both the unquoted and quoted
+	* forms, rewriting inside the quotes when needed.
+	*
+	* Edge cases we explicitly *do not* treat as external refs:
+	*   - `[@Column]`, `[#Headers]`, `[Column Name]` — table structured refs
+	*     (no `]Sheet!` tail). The regex requires the `]<sheet>!` follow-up,
+	*     which structured refs never have.
+	*   - Array literals `{1,2;3,4}` use `{}`, not `[]`.
+	*   - String literals `"[Book]Sheet!A1"` — handled by scanning only outside
+	*     string literal regions.
+	*/
+	const UNQUOTED_EXTERNAL_REF = /\[([^\]\\/:*?"<>|\s]+)\]([A-Za-z_\u00A1-\uFFFF][A-Za-z0-9_\u00A1-\uFFFF.]*)!/g;
+	const QUOTED_EXTERNAL_REF = /'\[([^\]]+)\]((?:''|[^'])+)'!/g;
+	/**
+	* Scan a formula string for all external-workbook references. String
+	* literals (inside `"..."`) are skipped so that a string value like
+	* `"[Book]Sheet!A1"` is not misidentified as a ref.
+	*
+	* The returned matches are in source order. If a formula contains no
+	* external refs, the array is empty.
+	*/
+	function findExternalRefs(formula) {
+		if (formula.indexOf("[") === -1) return [];
+		const matches = [];
+		const safeRegions = stringLiteralRegions(formula);
+		const addMatch = (start, end, workbook, sheet, quoted, match) => {
+			if (insideAnyRegion(start, safeRegions)) return;
+			const numeric = /^\d+$/.test(workbook);
+			matches.push({
+				match,
+				workbook,
+				numeric,
+				index: numeric ? parseInt(workbook, 10) : null,
+				sheet: unquoteSheetName(sheet),
+				quoted,
+				start,
+				end
+			});
+		};
+		UNQUOTED_EXTERNAL_REF.lastIndex = 0;
+		let m;
+		while ((m = UNQUOTED_EXTERNAL_REF.exec(formula)) !== null) addMatch(m.index, m.index + m[0].length, m[1], m[2], false, m[0]);
+		QUOTED_EXTERNAL_REF.lastIndex = 0;
+		while ((m = QUOTED_EXTERNAL_REF.exec(formula)) !== null) addMatch(m.index, m.index + m[0].length, m[1], m[2], true, m[0]);
+		matches.sort((a, b) => a.start - b.start);
+		const out = [];
+		let lastEnd = -1;
+		for (const ref of matches) if (ref.start >= lastEnd) {
+			out.push(ref);
+			lastEnd = ref.end;
+		}
+		return out;
+	}
+	/**
+	* Replace every external-workbook token in `formula` using the supplied
+	* resolver. The resolver is called once per match and returns the numeric
+	* index to substitute; returning `null` leaves the match unchanged (useful
+	* when the caller cannot resolve a particular filename).
+	*
+	* Returns the rewritten formula. Offsets inside the original formula are
+	* adjusted correctly even when multiple rewrites change the total length.
+	*/
+	function rewriteExternalRefs(formula, resolve) {
+		const refs = findExternalRefs(formula);
+		if (refs.length === 0) return formula;
+		let out = "";
+		let cursor = 0;
+		for (const ref of refs) {
+			const index = resolve(ref);
+			if (index === null) continue;
+			out += formula.slice(cursor, ref.start);
+			if (ref.quoted) {
+				const inner = formula.slice(ref.start + 1, ref.end - 2);
+				out += "'" + inner.replace(/^\[[^\]]*\]/, `[${index}]`) + "'!";
+			} else out += `[${index}]${ref.match.slice(ref.match.indexOf("]") + 1)}`;
+			cursor = ref.end;
+		}
+		out += formula.slice(cursor);
+		return out;
+	}
+	/**
+	* Return the spans of string literal regions in a formula, as half-open
+	* [start, end) intervals (exclusive of the surrounding quotes themselves).
+	* Used to skip external-ref matches that fall inside a string value.
+	*/
+	function stringLiteralRegions(formula) {
+		if (formula.indexOf("\"") === -1) return [];
+		const regions = [];
+		const len = formula.length;
+		let i = 0;
+		while (i < len) if (formula[i] === "\"") {
+			const start = i;
+			i++;
+			while (i < len) {
+				if (formula[i] === "\"") {
+					if (i + 1 < len && formula[i + 1] === "\"") {
+						i += 2;
+						continue;
+					}
+					i++;
+					break;
+				}
+				i++;
+			}
+			regions.push([start, i]);
+		} else i++;
+		return regions;
+	}
+	function insideAnyRegion(pos, regions) {
+		for (const [a, b] of regions) if (pos >= a && pos < b) return true;
+		return false;
+	}
+	function unquoteSheetName(sheet) {
+		return sheet.replace(/''/g, "'");
+	}
+	//#endregion
 	//#region src/modules/excel/utils/passthrough-manager.ts
 	/**
 	* Content type definitions for passthrough files
@@ -39781,6 +40995,232 @@ self.onmessage = async function(event) {
 		}
 	};
 	//#endregion
+	//#region src/modules/excel/xlsx/xform/book/external-link-xform.ts
+	/** Pretty attribute constant used on the root element. */
+	const ROOT_ATTRIBUTES = {
+		xmlns: "http://schemas.openxmlformats.org/spreadsheetml/2006/main",
+		"xmlns:r": "http://schemas.openxmlformats.org/officeDocument/2006/relationships"
+	};
+	var ExternalLinkXform = class extends BaseXform {
+		constructor(..._args) {
+			super(..._args);
+			this.sheetNamesByIndex = [];
+			this.currentSheetCells = null;
+			this.currentSheetName = null;
+			this.currentCellAddress = null;
+			this.currentCellType = "n";
+			this.currentCellValue = null;
+			this.inV = false;
+		}
+		get tag() {
+			return "externalLink";
+		}
+		reset() {
+			super.reset();
+			this.sheetNamesByIndex = [];
+			this.currentSheetCells = null;
+			this.currentSheetName = null;
+			this.currentCellAddress = null;
+			this.currentCellType = "n";
+			this.currentCellValue = null;
+			this.inV = false;
+		}
+		render(xmlStream, model) {
+			xmlStream.openXml(StdDocAttributes);
+			xmlStream.openNode("externalLink", ROOT_ATTRIBUTES);
+			xmlStream.openNode("externalBook", { "r:id": "rId1" });
+			if (model.sheetNames.length > 0) {
+				xmlStream.openNode("sheetNames");
+				for (const name of model.sheetNames) xmlStream.leafNode("sheetName", { val: name });
+				xmlStream.closeNode();
+			}
+			const cache = model.cachedValues ?? {};
+			if (Object.keys(cache).some((name) => {
+				const sheet = cache[name];
+				return sheet && Object.keys(sheet).length > 0;
+			})) {
+				xmlStream.openNode("sheetDataSet");
+				for (let i = 0; i < model.sheetNames.length; i++) {
+					const cells = cache[model.sheetNames[i]];
+					if (!cells || Object.keys(cells).length === 0) continue;
+					renderSheetData(xmlStream, i, cells);
+				}
+				xmlStream.closeNode();
+			}
+			xmlStream.closeNode();
+			xmlStream.closeNode();
+		}
+		parseOpen(node) {
+			switch (node.name) {
+				case "externalLink":
+					this.model = {
+						externalBookRId: "",
+						sheetNames: [],
+						cachedValues: {}
+					};
+					this.sheetNamesByIndex = [];
+					return true;
+				case "externalBook":
+					if (this.model) this.model.externalBookRId = node.attributes["r:id"] ?? "";
+					return true;
+				case "sheetName":
+					if (this.model) {
+						const val = node.attributes.val ?? "";
+						this.model.sheetNames.push(val);
+						this.sheetNamesByIndex.push(val);
+					}
+					return true;
+				case "sheetData": {
+					const sheetIdRaw = node.attributes.sheetId;
+					const sheetId = sheetIdRaw !== void 0 ? parseInt(sheetIdRaw, 10) : NaN;
+					this.currentSheetName = Number.isFinite(sheetId) ? this.sheetNamesByIndex[sheetId] ?? null : null;
+					this.currentSheetCells = this.currentSheetName ? {} : null;
+					return true;
+				}
+				case "cell":
+					this.currentCellAddress = node.attributes.r ?? null;
+					this.currentCellType = node.attributes.t ?? "n";
+					this.currentCellValue = null;
+					return true;
+				case "v":
+					this.inV = true;
+					this.currentCellValue = "";
+					return true;
+				default: return false;
+			}
+		}
+		parseText(text) {
+			if (this.inV) this.currentCellValue = (this.currentCellValue ?? "") + text;
+		}
+		parseClose(name) {
+			switch (name) {
+				case "v":
+					this.inV = false;
+					return true;
+				case "cell":
+					if (this.model && this.currentSheetCells && this.currentCellAddress) this.currentSheetCells[this.currentCellAddress.toUpperCase()] = decodePrimitive(this.currentCellType, this.currentCellValue);
+					this.currentCellAddress = null;
+					this.currentCellType = "n";
+					this.currentCellValue = null;
+					return true;
+				case "sheetData":
+					if (this.model && this.currentSheetName && this.currentSheetCells && Object.keys(this.currentSheetCells).length > 0) this.model.cachedValues[this.currentSheetName] = this.currentSheetCells;
+					this.currentSheetName = null;
+					this.currentSheetCells = null;
+					return true;
+				case "externalLink": return false;
+				default: return true;
+			}
+		}
+	};
+	function renderSheetData(xmlStream, sheetIdx, cells) {
+		const rows = groupByRow(cells);
+		xmlStream.openNode("sheetData", { sheetId: sheetIdx });
+		for (const row of rows) {
+			xmlStream.openNode("row", { r: row.rowNum });
+			for (const { address, value } of row.cells) renderCell(xmlStream, address, value);
+			xmlStream.closeNode();
+		}
+		xmlStream.closeNode();
+	}
+	function groupByRow(cells) {
+		const byRow = /* @__PURE__ */ new Map();
+		for (const rawAddress of Object.keys(cells)) {
+			const address = rawAddress.toUpperCase();
+			const rowNum = extractRowNumber(address);
+			if (rowNum === void 0) continue;
+			let bucket = byRow.get(rowNum);
+			if (!bucket) {
+				bucket = {
+					rowNum,
+					cells: []
+				};
+				byRow.set(rowNum, bucket);
+			}
+			bucket.cells.push({
+				address: stripAbsoluteMarkers(address),
+				value: cells[rawAddress]
+			});
+		}
+		return [...byRow.values()].sort((a, b) => a.rowNum - b.rowNum);
+	}
+	function extractRowNumber(address) {
+		const match = /^\$?[A-Z]+\$?(\d+)$/.exec(address);
+		return match ? parseInt(match[1], 10) : void 0;
+	}
+	function stripAbsoluteMarkers(address) {
+		return address.replace(/\$/g, "");
+	}
+	function renderCell(xmlStream, address, value) {
+		if (value === null || value === void 0) {
+			xmlStream.leafNode("cell", { r: address });
+			return;
+		}
+		if (typeof value === "number") {
+			xmlStream.openNode("cell", { r: address });
+			xmlStream.leafNode("v", void 0, String(value));
+			xmlStream.closeNode();
+			return;
+		}
+		if (typeof value === "boolean") {
+			xmlStream.openNode("cell", {
+				r: address,
+				t: "b"
+			});
+			xmlStream.leafNode("v", void 0, value ? "1" : "0");
+			xmlStream.closeNode();
+			return;
+		}
+		if (isErrorLiteral(value)) {
+			xmlStream.openNode("cell", {
+				r: address,
+				t: "e"
+			});
+			xmlStream.leafNode("v", void 0, value);
+			xmlStream.closeNode();
+			return;
+		}
+		xmlStream.openNode("cell", {
+			r: address,
+			t: "str"
+		});
+		xmlStream.leafNode("v", void 0, value);
+		xmlStream.closeNode();
+	}
+	/** Excel error literals that should be written with `t="e"`. */
+	const ERROR_LITERALS = new Set([
+		"#NULL!",
+		"#DIV/0!",
+		"#VALUE!",
+		"#REF!",
+		"#NAME?",
+		"#NUM!",
+		"#N/A",
+		"#GETTING_DATA",
+		"#SPILL!",
+		"#CALC!",
+		"#CONNECT!",
+		"#BLOCKED!",
+		"#UNKNOWN!",
+		"#FIELD!",
+		"#PYTHON!"
+	]);
+	function isErrorLiteral(value) {
+		return ERROR_LITERALS.has(value);
+	}
+	function decodePrimitive(type, raw) {
+		if (raw === null || raw === "") return null;
+		switch (type) {
+			case "b": return raw !== "0" && raw.toLowerCase() !== "false";
+			case "e": return raw;
+			case "str": return raw;
+			default: {
+				const n = Number(raw);
+				return Number.isFinite(n) ? n : raw;
+			}
+		}
+	}
+	//#endregion
 	//#region src/modules/excel/xlsx/xform/comment/comments-xform.ts
 	var CommentsXform = class CommentsXform extends BaseXform {
 		constructor() {
@@ -41897,10 +43337,10 @@ self.onmessage = async function(event) {
 					for (let j = dimensions.left; j <= dimensions.right; j++) {
 						const cell = row.cells[j - 1];
 						if (!cell) row.cells[j] = {
-							type: Enums.ValueType.Null,
+							type: 0,
 							address: colCache.encodeAddress(i, j)
 						};
-						else if (cell.type === Enums.ValueType.Merge) cell.master = dimensions.tl;
+						else if (cell.type === 1) cell.master = dimensions.tl;
 					}
 				}
 			});
@@ -42066,7 +43506,8 @@ self.onmessage = async function(event) {
 					childXform: new TablePartXform()
 				}),
 				conditionalFormatting: new ConditionalFormattingsXform(),
-				extLst: new ExtLstXform$1()
+				extLst: new ExtLstXform$1(),
+				ignoredErrors: new IgnoredErrorsXform()
 			};
 		}
 		prepare(model, options) {
@@ -42449,6 +43890,7 @@ self.onmessage = async function(event) {
 				xmlStream.leafNode("mc:Fallback");
 				xmlStream.closeNode();
 			}
+			this.map.ignoredErrors.render(xmlStream, model.ignoredErrors);
 			this.map.tableParts.render(xmlStream, model.tables);
 			this.map.extLst.render(xmlStream, model);
 			xmlStream.closeNode();
@@ -42505,7 +43947,8 @@ self.onmessage = async function(event) {
 						tables: this.map.tableParts.model,
 						conditionalFormattings,
 						rowBreaks: this.map.rowBreaks.model ?? [],
-						colBreaks: this.map.colBreaks.model ?? []
+						colBreaks: this.map.colBreaks.model ?? [],
+						ignoredErrors: this.map.ignoredErrors.model ?? []
 					};
 					if (this.map.autoFilter.model) this.model.autoFilter = this.map.autoFilter.model;
 					if (this.map.sheetProtection.model) this.model.sheetProtection = this.map.sheetProtection.model;
@@ -43335,6 +44778,27 @@ self.onmessage = async function(event) {
 		}
 	};
 	/**
+	* Extract the trailing integer from a workbook-rels Target like
+	* `"externalLinks/externalLink12.xml"` (a path relative to `xl/`). Mirror
+	* of {@link getExternalLinkIndexFromPath} which takes the full
+	* `xl/externalLinks/…` form. Used during reconcile to bridge the
+	* workbook.xml.rels entry to the parsed externalLinkN.xml part.
+	*/
+	function externalLinkIndexFromRelTarget(target) {
+		const match = /(?:^|\/)externalLink(\d+)[.]xml$/.exec(target);
+		return match ? parseInt(match[1], 10) : void 0;
+	}
+	/**
+	* Add `sheetName` to an ExternalLinkModel's `sheetNames` list if it isn't
+	* already present. Ordering is preserved — the first-seen sheet wins
+	* position 0, which matches what Excel does when writing externalLinks
+	* itself.
+	*/
+	function upsertSheet(link, sheetName) {
+		if (!sheetName) return;
+		if (!link.sheetNames.includes(sheetName)) link.sheetNames.push(sheetName);
+	}
+	/**
 	* XLSX class - handles Excel file operations
 	* Works in both Node.js and Browser environments
 	*/
@@ -43396,10 +44860,12 @@ self.onmessage = async function(event) {
 			await this.addDrawings(zip, model);
 			await this.addTables(zip, model);
 			await this.addPivotTables(zip, model);
+			await this.addExternalLinks(zip, model);
 			this.addPassthrough(zip, model);
 			await this.addThemes(zip, model);
 			await this.addStyles(zip, model);
 			await this.addFeaturePropertyBag(zip, model);
+			await this.addMetadata(zip, model);
 			await this.addMedia(zip, model);
 			await this.addApp(zip, model);
 			await this.addCore(zip, model);
@@ -43444,16 +44910,27 @@ self.onmessage = async function(event) {
 			return this._finalize(zip);
 		}
 		/**
-		* Load workbook from buffer/ArrayBuffer/Uint8Array
+		* Load a workbook from binary data.
+		*
+		* Accepted inputs:
+		*  - `Uint8Array` (and `Buffer`, which is a Uint8Array at runtime)
+		*  - `ArrayBuffer` / `SharedArrayBuffer`
+		*  - Any `ArrayBufferView` (DataView, Int8Array, Float32Array, …) — the
+		*    underlying bytes are reinterpreted as a zip archive
+		*  - `string` — treated as base64-encoded data when `options.base64 === true`;
+		*    raw binary cannot be round-tripped through a JS string and is rejected
+		*    to prevent silent corruption.
 		*/
 		async load(data, options) {
+			if (data === null || data === void 0) throw new ExcelFileError("<input>", "read", "Can't read the data of 'the loaded zip file'. Is it in a supported JavaScript type (String, Blob, ArrayBuffer, etc) ?");
 			let buffer;
-			const isBuffer = typeof Buffer !== "undefined" ? Buffer.isBuffer(data) : false;
-			if (!data || typeof data === "object" && !isBuffer && !(data instanceof Uint8Array) && !(data instanceof ArrayBuffer)) throw new ExcelFileError("<input>", "read", "Can't read the data of 'the loaded zip file'. Is it in a supported JavaScript type (String, Blob, ArrayBuffer, etc) ?");
-			if (options && options.base64) buffer = base64ToUint8Array(data.toString());
+			if (typeof data === "string") {
+				if (!options?.base64) throw new ExcelFileError("<input>", "read", "Can't read the data of 'the loaded zip file'. Is it in a supported JavaScript type (String, Blob, ArrayBuffer, etc) ? String input requires options.base64 === true (base64-encoded zip archive).");
+				buffer = base64ToUint8Array(data);
+			} else if (data instanceof Uint8Array) buffer = data;
 			else if (data instanceof ArrayBuffer) buffer = new Uint8Array(data);
-			else if (data instanceof Uint8Array) buffer = data;
-			else buffer = new Uint8Array(data);
+			else if (ArrayBuffer.isView(data)) buffer = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+			else throw new ExcelFileError("<input>", "read", "Can't read the data of 'the loaded zip file'. Is it in a supported JavaScript type (String, Blob, ArrayBuffer, etc) ?");
 			return this.loadBuffer(buffer, options);
 		}
 		/**
@@ -43493,7 +44970,9 @@ self.onmessage = async function(event) {
 				pivotTableRels: {},
 				pivotCacheDefinitions: {},
 				pivotCacheRecords: {},
-				passthrough: {}
+				passthrough: {},
+				externalLinksByIndex: {},
+				externalLinkRelsByIndex: {}
 			};
 		}
 		/**
@@ -43546,8 +45025,10 @@ self.onmessage = async function(event) {
 					model.definedNames = workbook.definedNames;
 					model.views = workbook.views;
 					model.properties = workbook.properties;
+					model.protection = workbook.protection;
 					model.calcProperties = workbook.calcProperties;
 					model.pivotCaches = workbook.pivotCaches;
+					model.externalReferences = workbook.externalReferences;
 					return true;
 				}
 				case OOXML_PATHS.xlSharedStrings:
@@ -43574,6 +45055,11 @@ self.onmessage = async function(event) {
 					model.styles = new StylesXform();
 					await model.styles.parseStream(stream);
 					return true;
+				case OOXML_PATHS.xlMetadata: {
+					const metadataResult = await new MetadataXform().parseStream(stream);
+					if (metadataResult) model.metadata = metadataResult;
+					return true;
+				}
 				default: return false;
 			}
 		}
@@ -43703,12 +45189,15 @@ self.onmessage = async function(event) {
 				comments: model.comments,
 				tables: model.tables,
 				vmlDrawings: model.vmlDrawings,
-				pivotTables: model.pivotTablesIndexed
+				pivotTables: model.pivotTablesIndexed,
+				hasDynamicArrayMetadata: !!model.metadata?.hasDynamicArrays,
+				dynamicArrayCmIndices: model.metadata?.dynamicArrayCmIndices
 			};
 			model.worksheets.forEach((worksheet) => {
 				worksheet.relationships = model.worksheetRels[worksheet.sheetNo];
 				worksheetXform.reconcile(worksheet, sheetOptions);
 			});
+			this._reconcileExternalLinks(model);
 			delete model.worksheetHash;
 			delete model.worksheetRels;
 			delete model.globalRels;
@@ -43722,6 +45211,127 @@ self.onmessage = async function(event) {
 			delete model.drawingRels;
 			delete model.vmlDrawings;
 			delete model.pivotTableRels;
+			delete model.metadata;
+			delete model.externalReferences;
+			delete model.externalLinksByIndex;
+			delete model.externalLinkRelsByIndex;
+		}
+		/**
+		* Join the three on-disk sources that together describe external workbook
+		* references into a single dense `model.externalLinks: ExternalLinkModel[]`.
+		*
+		* Sources:
+		*   - `<externalReferences>` list in workbook.xml (declaration order)
+		*   - `xl/_rels/workbook.xml.rels` (rId → internal path)
+		*   - `xl/externalLinks/externalLink{N}.xml` (sheet names, cached values)
+		*   - `xl/externalLinks/_rels/externalLink{N}.xml.rels` (target, TargetMode)
+		*
+		* The 1-based index of each resulting ExternalLinkModel matches the `[N]`
+		* used in formula strings — this is the single source of truth formula
+		* code should rely on.
+		*/
+		_reconcileExternalLinks(model) {
+			const refs = model.externalReferences;
+			if (!refs || refs.length === 0) {
+				if (!model.externalLinks) model.externalLinks = [];
+				return;
+			}
+			const rels = model.workbookRels ?? [];
+			const relById = /* @__PURE__ */ new Map();
+			for (const rel of rels) if (rel.Type === RelType.ExternalLink) relById.set(rel.Id, rel);
+			const externalLinks = [];
+			for (let i = 0; i < refs.length; i++) {
+				const ref = refs[i];
+				const rel = relById.get(ref.rId);
+				if (!rel) continue;
+				const partIndex = externalLinkIndexFromRelTarget(rel.Target);
+				if (partIndex === void 0) continue;
+				const parsed = model.externalLinksByIndex[partIndex];
+				const partRels = model.externalLinkRelsByIndex[partIndex] ?? [];
+				const pathRel = partRels.find((r) => r.Type === RelType.ExternalLinkPath) ?? partRels.find((r) => r.TargetMode === "External");
+				externalLinks.push({
+					index: i + 1,
+					rId: ref.rId,
+					target: pathRel?.Target ?? "",
+					targetMode: pathRel?.TargetMode ?? "External",
+					sheetNames: parsed?.sheetNames ?? [],
+					cachedValues: parsed?.cachedValues ?? {}
+				});
+			}
+			model.externalLinks = externalLinks;
+		}
+		/**
+		* Write-time pass that brings the workbook model into a shape the writer
+		* can serialise cleanly. Two concerns:
+		*
+		*   1. Build the final external-link list for this write, combining
+		*      user-declared links (`wb.externalLinks`) with auto-discovered
+		*      ones from previous writes (cached on the Workbook). The result
+		*      is assigned to `model.externalLinks` and consumed by the writer;
+		*      `wb.externalLinks` is **not** modified.
+		*
+		*   2. Scan every formula cell for `[Book]Sheet!` prefixes. Filename-form
+		*      references that don't match an existing link trigger
+		*      `_recordAutoExternalLink()` on the Workbook, which adds the target
+		*      to the private writer cache (so subsequent writes are fixed-point
+		*      stable) but leaves `wb.externalLinks` untouched.
+		*
+		*   3. Rewrite every external-ref formula so it uses the numeric `[N]`
+		*      form, the canonical OOXML storage form. This mutation lands on
+		*      the cell's model object — matching the library's existing
+		*      write-time pattern for `ssId`, `styleId`, `si`, and `cm`.
+		*      Subsequent writes see the `[N]` form directly and resolve it
+		*      against `model.externalLinks`, giving idempotent output.
+		*/
+		_normaliseExternalLinks(model) {
+			const links = this.workbook._collectExternalLinksForWrite();
+			const byTarget = /* @__PURE__ */ new Map();
+			for (const link of links) if (link.target) byTarget.set(link.target.toLowerCase(), link);
+			const scratch = {
+				links,
+				byTarget,
+				workbook: this.workbook
+			};
+			for (const worksheet of model.worksheets ?? []) for (const row of worksheet.rows ?? []) for (const cell of row.cells ?? []) {
+				if (typeof cell?.formula === "string" && cell.formula.length > 0) cell.formula = this._normaliseFormulaExternalRefs(cell.formula, scratch);
+				if (typeof cell?.sharedFormula === "string" && cell.sharedFormula.length > 0) cell.sharedFormula = this._normaliseFormulaExternalRefs(cell.sharedFormula, scratch);
+			}
+			model.externalLinks = links;
+		}
+		/**
+		* Rewrite a single formula so every external-ref prefix uses the numeric
+		* `[N]` form. When an unknown filename-form reference is found we record
+		* it on the workbook's private writer cache (so the next write can still
+		* resolve it) and append a local link to `scratch.links` so subsequent
+		* refs in the same formula see the freshly-assigned index.
+		*/
+		_normaliseFormulaExternalRefs(formula, scratch) {
+			return rewriteExternalRefs(formula, (ref) => {
+				if (ref.numeric) {
+					if (ref.index !== null && ref.index >= 1 && ref.index <= scratch.links.length) {
+						upsertSheet(scratch.links[ref.index - 1], ref.sheet);
+						return ref.index;
+					}
+					return null;
+				}
+				const key = ref.workbook.toLowerCase();
+				let link = scratch.byTarget.get(key);
+				if (!link) {
+					link = {
+						index: scratch.workbook._recordAutoExternalLink(ref.workbook, ref.sheet),
+						target: ref.workbook,
+						targetMode: "External",
+						sheetNames: ref.sheet ? [ref.sheet] : [],
+						cachedValues: {}
+					};
+					scratch.links.push(link);
+					scratch.byTarget.set(key, link);
+				} else {
+					upsertSheet(link, ref.sheet);
+					if (ref.sheet) scratch.workbook._recordAutoExternalLink(ref.workbook, ref.sheet);
+				}
+				return link.index;
+			});
 		}
 		/**
 		* Reconcile pivot tables by linking them to worksheets and their cache data.
@@ -43931,6 +45541,26 @@ self.onmessage = async function(event) {
 			const cacheRecords = await new PivotCacheRecordsXform().parseStream(stream);
 			if (cacheRecords) model.pivotCacheRecords[name] = cacheRecords;
 		}
+		/**
+		* Parse `xl/externalLinks/externalLink{N}.xml` into the intermediate
+		* ParsedExternalLink shape. Reconciliation (joining with the rels file
+		* and the workbook's `<externalReferences>` list) happens later in
+		* {@link reconcile}.
+		*/
+		async _processExternalLinkEntry(stream, model, index) {
+			const parsed = await new ExternalLinkXform().parseStream(stream);
+			if (parsed) model.externalLinksByIndex[index] = parsed;
+		}
+		/**
+		* Parse `xl/externalLinks/_rels/externalLink{N}.xml.rels`. The Target /
+		* TargetMode carried here is what Excel uses to locate the actual external
+		* file at open time, so we must preserve it verbatim (including relative
+		* paths like `"测试.xlsx"`).
+		*/
+		async _processExternalLinkRelsEntry(stream, model, index) {
+			const relationships = await this.parseRels(stream);
+			model.externalLinkRelsByIndex[index] = relationships ?? [];
+		}
 		async loadFromFiles(zipData, options) {
 			const model = this.createEmptyModel();
 			const entries = Object.keys(zipData).map((name) => ({
@@ -44018,6 +45648,16 @@ self.onmessage = async function(event) {
 				await this._processPivotCacheRecordsEntry(stream, model, pivotCacheRecordsName);
 				return true;
 			}
+			const externalLinkIndex = getExternalLinkIndexFromPath(entryName);
+			if (externalLinkIndex !== void 0) {
+				await this._processExternalLinkEntry(stream, model, externalLinkIndex);
+				return true;
+			}
+			const externalLinkRelsIndex = getExternalLinkIndexFromRelsPath(entryName);
+			if (externalLinkRelsIndex !== void 0) {
+				await this._processExternalLinkRelsEntry(stream, model, externalLinkRelsIndex);
+				return true;
+			}
 			if (PassthroughManager.isPassthroughPath(entryName)) {
 				if (rawData) model.passthrough[entryName] = rawData;
 				else await this._processPassthroughEntry(stream, model, entryName);
@@ -44101,6 +45741,11 @@ self.onmessage = async function(event) {
 				Type: XLSX.RelType.FeaturePropertyBag,
 				Target: OOXML_REL_TARGETS.workbookFeaturePropertyBag
 			});
+			if (model.hasDynamicArrayFormulas) relationships.push({
+				Id: `rId${count++}`,
+				Type: XLSX.RelType.SheetMetadata,
+				Target: OOXML_REL_TARGETS.workbookMetadata
+			});
 			const seenCacheIds = /* @__PURE__ */ new Map();
 			(model.pivotTables ?? []).forEach((pivotTable) => {
 				const existing = seenCacheIds.get(pivotTable.cacheId);
@@ -44123,6 +45768,15 @@ self.onmessage = async function(event) {
 					Target: worksheetRelTarget(worksheet.fileIndex)
 				});
 			});
+			const externalLinks = model.externalLinks ?? [];
+			for (const link of externalLinks) {
+				link.rId = `rId${count++}`;
+				relationships.push({
+					Id: link.rId,
+					Type: XLSX.RelType.ExternalLink,
+					Target: externalLinkRelTargetFromWorkbook(link.index)
+				});
+			}
 			const xform = new RelationshipsXform();
 			await this._renderToZip(zip, OOXML_PATHS.xlWorkbookRels, xform, relationships);
 		}
@@ -44130,6 +45784,10 @@ self.onmessage = async function(event) {
 			if (!model.hasCheckboxes) return;
 			await this._renderToZip(zip, OOXML_PATHS.xlFeaturePropertyBag, new FeaturePropertyBagXform(), {});
 		}
+		async addMetadata(zip, model) {
+			if (!model.hasDynamicArrayFormulas) return;
+			await this._renderToZip(zip, OOXML_PATHS.xlMetadata, new MetadataXform(), { dynamicArrayCount: model.dynamicArrayCount });
+		}
 		async addSharedStrings(zip, model) {
 			if (model.sharedStrings && model.sharedStrings.count) await this._renderToZip(zip, OOXML_PATHS.xlSharedStrings, model.sharedStrings, model.sharedStrings.model);
 		}
@@ -44211,6 +45869,34 @@ self.onmessage = async function(event) {
 			}
 		}
 		/**
+		* Write every external workbook reference into the archive. For each
+		* {@link ExternalLinkModel} in `model.externalLinks` we emit two files:
+		*
+		*   xl/externalLinks/externalLink{index}.xml          — sheet names + cache
+		*   xl/externalLinks/_rels/externalLink{index}.xml.rels — target path
+		*
+		* The target-path rel carries `TargetMode="External"` with a **bare
+		* relative** `Target` whenever the user supplied one. This is the single
+		* line that makes Office / WPS resolve the referenced workbook relative
+		* to the current file's directory (not the `%USERPROFILE%\Documents`
+		* fallback) — the root of the behaviour reported in exceljs#3039.
+		*/
+		async addExternalLinks(zip, model) {
+			const externalLinks = model.externalLinks ?? [];
+			if (externalLinks.length === 0) return;
+			const externalLinkXform = new ExternalLinkXform();
+			const relsXform = new RelationshipsXform();
+			for (const link of externalLinks) {
+				await this._renderToZip(zip, externalLinkPath(link.index), externalLinkXform, link);
+				await this._renderToZip(zip, externalLinkRelsPath(link.index), relsXform, [{
+					Id: "rId1",
+					Type: XLSX.RelType.ExternalLinkPath,
+					Target: link.target,
+					TargetMode: link.targetMode ?? "External"
+				}]);
+			}
+		}
+		/**
 		* Write passthrough files (charts, etc.) that were preserved during read.
 		* These files are written back unchanged to preserve unsupported features.
 		*/
@@ -44280,6 +45966,7 @@ self.onmessage = async function(event) {
 			const workbookXform = new WorkbookXform();
 			const worksheetXform = new WorkSheetXform();
 			workbookXform.prepare(model);
+			this._normaliseExternalLinks(model);
 			const worksheetOptions = {
 				sharedStrings: model.sharedStrings,
 				styles: model.styles,
@@ -44293,9 +45980,14 @@ self.onmessage = async function(event) {
 			model.hasHeaderWatermark = false;
 			let tableCount = 0;
 			model.tables = [];
+			const tableNameMap = /* @__PURE__ */ new Map();
 			model.worksheets.forEach((worksheet, index) => {
 				worksheet.fileIndex = index + 1;
 				worksheet.tables.forEach((table) => {
+					const nameKey = table.name.toLowerCase();
+					const existingSheet = tableNameMap.get(nameKey);
+					if (existingSheet !== void 0) throw new TableError(`Duplicate table name "${table.name}": already used in worksheet "${existingSheet}". Table names must be unique across the entire workbook (case-insensitive).`);
+					tableNameMap.set(nameKey, worksheet.name);
 					tableCount++;
 					table.target = `table${tableCount}.xml`;
 					table.id = tableCount;
@@ -44304,6 +45996,16 @@ self.onmessage = async function(event) {
 				worksheetXform.prepare(worksheet, worksheetOptions);
 			});
 			model.hasCheckboxes = model.styles.hasCheckboxes;
+			let dynamicArrayCount = 0;
+			model.worksheets.forEach((worksheet) => {
+				(worksheet.rows ?? []).forEach((row) => {
+					(row.cells ?? []).forEach((cell) => {
+						if (cell.isDynamicArray) dynamicArrayCount++;
+					});
+				});
+			});
+			model.hasDynamicArrayFormulas = dynamicArrayCount > 0;
+			model.dynamicArrayCount = dynamicArrayCount;
 			if (worksheetOptions.hasHeaderWatermark) model.hasHeaderWatermark = true;
 			const passthrough = model.passthrough || {};
 			const passthroughManager = new PassthroughManager();
@@ -44311,6 +46013,22 @@ self.onmessage = async function(event) {
 			model.passthroughContentTypes = passthroughManager.getContentTypes();
 		}
 	};
+	/**
+	* Invoke the registered engine on `workbook`. Throws a descriptive error
+	* if no engine has been installed.
+	*/
+	function invokeFormulaEngine(workbook) {
+		throw new Error("No formula engine is installed. Call `installFormulaEngine()` from `@cj-tech-master/excelts/formula` once at startup to enable `Workbook.calculateFormulas()` and automatic recalculation during `excelToPdf()`.");
+	}
+	/**
+	* Like {@link invokeFormulaEngine} but returns silently when no engine is
+	* installed. Used by `excelToPdf()` so that PDF export still works for
+	* workbooks whose cached formula results are already up to date (the
+	* common case when the XLSX was saved by Excel itself).
+	*/
+	function tryInvokeFormulaEngine(workbook) {
+		return false;
+	}
 	//#endregion
 	//#region src/modules/markdown/constants.ts
 	/**
@@ -44950,29 +46668,48 @@ self.onmessage = async function(event) {
 				const datumNumber = Number(datum);
 				if (!Number.isNaN(datumNumber) && datumNumber !== Infinity) return datumNumber;
 			}
-			const date = dateParser.parse(datum);
-			if (date) return date;
-			const special = SpecialValues[datum];
-			if (special !== void 0) return special;
+			if (typeof datum === "string") {
+				const date = dateParser.parse(datum);
+				if (date) return date;
+				const special = SpecialValues[datum];
+				if (special !== void 0) return special;
+			}
 			return datum;
 		};
 	}
 	/**
 	* Create a value mapper for writing Excel values to CSV format.
-	* Handles hyperlinks, formulas, rich text, dates, errors, and objects.
+	*
+	* Branches below correspond to each member of the `CellValue` union, in an
+	* order that prefers the most specific shape:
+	*   1. Hyperlink   — emit the URL (falling back to display text)
+	*   2. Formula / SharedFormula / ArrayFormula — emit the evaluated `result`
+	*   3. RichText    — flatten runs to plain text
+	*   4. Checkbox    — emit the boolean state
+	*   5. Error       — emit the Excel error token (e.g. "#N/A")
+	*   6. Date        — format via the configured DateFormatter
+	*   7. Primitive   — pass through (`string | number | boolean | null | undefined`)
+	*
+	* An object that does not match any of the above is stringified as JSON so
+	* the CSV remains round-trippable rather than producing `[object Object]`.
 	*/
 	function createDefaultWriteMapper(dateFormat, dateUTC) {
 		const formatter = dateFormat ? DateFormatter.create(dateFormat, { utc: dateUTC }) : DateFormatter.iso(dateUTC);
 		return function mapValue(value) {
-			if (value) {
-				if (value.text || value.hyperlink) return value.hyperlink || value.text || "";
-				if (value.formula || value.result) return value.result || "";
-				if (value.richText && Array.isArray(value.richText)) return value.richText.map((r) => r.text).join("");
-				if (value instanceof Date) return formatter.format(value);
-				if (value.error) return value.error;
-				if (typeof value === "object") return JSON.stringify(value);
-			}
-			return value;
+			if (value === null || value === void 0) return value;
+			if (value instanceof Date) return formatter.format(value);
+			if (typeof value !== "object") return value;
+			const maybeLink = value;
+			if (typeof maybeLink.hyperlink === "string" || typeof maybeLink.text === "string") {
+				const url = typeof maybeLink.hyperlink === "string" ? maybeLink.hyperlink : "";
+				const text = typeof maybeLink.text === "string" ? maybeLink.text : "";
+				return url || text || "";
+			}
+			if ("formula" in value || "sharedFormula" in value) return value.result ?? "";
+			if ("richText" in value && Array.isArray(value.richText)) return value.richText.map((r) => r.text).join("");
+			if ("checkbox" in value && typeof value.checkbox === "boolean") return value.checkbox;
+			if ("error" in value && typeof value.error === "string") return value.error;
+			return JSON.stringify(value);
 		};
 	}
 	/**
@@ -45064,7 +46801,17 @@ self.onmessage = async function(event) {
 		static {
 			this.Reader = WorkbookReader;
 		}
-		constructor() {
+		/**
+		* @param options Optional construction options.
+		*   - `formulaSyntaxProbe`: An explicit tokenizer+parser probe used to
+		*     classify defined-name text during XLSX load. Providing this makes
+		*     classification deterministic for *this* workbook regardless of
+		*     whether `installFormulaEngine()` has been called. Most callers
+		*     don't need it — `installFormulaEngine()` registers a
+		*     process-wide default probe that is picked up automatically.
+		*/
+		constructor(options) {
+			this._tableNames = /* @__PURE__ */ new Set();
 			this.category = "";
 			this.company = "";
 			this.created = /* @__PURE__ */ new Date();
@@ -45080,9 +46827,30 @@ self.onmessage = async function(event) {
 			this.views = [];
 			this.media = [];
 			this.pivotTables = [];
+			this.externalLinks = [];
 			this._passthrough = {};
 			this._rawDrawings = {};
-			this._definedNames = new DefinedNames();
+			this._writerExternalLinkCache = /* @__PURE__ */ new Map();
+			this._definedNames = new DefinedNames(options?.formulaSyntaxProbe);
+		}
+		/**
+		* The default font for the workbook (fontId=0 / "Normal" style).
+		* Cells without explicit font styles will inherit this font in Excel.
+		*
+		* @example
+		* ```ts
+		* wb.defaultFont = { name: "Arial", size: 12 };
+		* ```
+		*
+		* When reading an existing XLSX file, this preserves the original default font
+		* for round-trip fidelity. Setting it on a new workbook changes the default
+		* from Calibri 11 to your chosen font.
+		*/
+		get defaultFont() {
+			return this._defaultFont;
+		}
+		set defaultFont(font) {
+			this._defaultFont = font;
 		}
 		/**
 		* Import a worksheet from another workbook (or a standalone worksheet).
@@ -45105,6 +46873,22 @@ self.onmessage = async function(event) {
 			return newWs;
 		}
 		/**
+		* Protect the workbook structure with an optional password.
+		* Prevents users from adding, deleting, renaming, moving, or copying worksheets.
+		*
+		* @param password - Optional password to protect the structure
+		* @param options  - Optional protection flags (lockStructure, lockWindows, lockRevision)
+		*/
+		async protect(password, options) {
+			this.protection = await buildWorkbookProtection(password, options);
+		}
+		/**
+		* Remove workbook structure protection.
+		*/
+		unprotect() {
+			this.protection = void 0;
+		}
+		/**
 		* xlsx file format operations
 		* Node.js: readFile, writeFile, read (stream), write (stream), load (buffer), writeBuffer
 		* Browser: load (buffer), writeBuffer
@@ -45615,6 +47399,47 @@ self.onmessage = async function(event) {
 		get definedNames() {
 			return this._definedNames;
 		}
+		/**
+		* Recalculate all formula cells in this workbook.
+		*
+		* Evaluates every formula cell using the built-in calculation engine and updates
+		* each cell's cached `result` value in-place. Formulas are evaluated with
+		* recursive dependency resolution, memoization, and circular reference detection.
+		*
+		* Call this after programmatically modifying cell values that are referenced by
+		* formulas, to ensure formula results reflect the latest data.
+		*
+		* Unsupported functions preserve their original cached result if one exists.
+		*
+		* ## Tree-shaking note
+		*
+		* The formula engine ships ~200KB of code (433 Excel functions, parser,
+		* evaluator, dependency graph, spill materialiser). To keep it out of
+		* bundles that don't need it, the engine is registered at runtime
+		* rather than imported by the core `Workbook` module. Call
+		* {@link installFormulaEngine} once at startup before the first call
+		* to this method, or a clear error will be thrown explaining what to do.
+		*
+		* ```ts
+		* import { installFormulaEngine } from "@cj-tech-master/excelts/formula";
+		*
+		* installFormulaEngine();                   // once, at startup
+		*
+		* sheet.getCell("A1").value = 100;
+		* workbook.calculateFormulas();             // now works
+		* ```
+		*
+		* Callers who prefer a zero-side-effect, tree-shakeable surface can
+		* use the functional equivalent directly:
+		*
+		* ```ts
+		* import { calculateFormulas } from "@cj-tech-master/excelts/formula";
+		* calculateFormulas(workbook);
+		* ```
+		*/
+		calculateFormulas() {
+			invokeFormulaEngine(this);
+		}
 		clearThemes() {
 			this._themes = void 0;
 		}
@@ -45632,6 +47457,119 @@ self.onmessage = async function(event) {
 		getImage(id) {
 			return this.media[Number(id)];
 		}
+		/**
+		* Declare that formulas in this workbook may reference an external
+		* workbook. Registers the target so the output file contains the required
+		* `xl/externalLinks/externalLink{N}.xml` part plus its `.rels` sibling
+		* and Office/WPS can resolve the reference correctly.
+		*
+		* When Office opens the file, it resolves a relative `target` like
+		* `"测试.xlsx"` **relative to the current workbook's directory** — which
+		* is the exact behaviour the user expects when they write
+		* `=[测试.xlsx]Sheet1!A1`. Absolute `file:///…` or `http(s)://…` URIs
+		* are accepted and written through unchanged.
+		*
+		* @returns the registered {@link ExternalLinkModel}. Its `index` field is
+		*   the 1-based number used inside the `[N]` prefix of on-disk formula
+		*   strings (the library rewrites `[target]` forms to `[index]` at write
+		*   time automatically).
+		*
+		* @example
+		* ```ts
+		* const wb = new Workbook();
+		* const ws = wb.addWorksheet("Main");
+		*
+		* // Declare the link once — sheet names and cached values are optional
+		* // but improve interoperability (Excel displays cached values when the
+		* // external file is unavailable).
+		* wb.addExternalLink({
+		*   target: "测试.xlsx",
+		*   sheetNames: ["Sheet1"],
+		*   cachedValues: { Sheet1: { A1: 42 } }
+		* });
+		*
+		* // Write the formula using either the target name OR the numeric index;
+		* // the library normalises both to the on-disk `[N]` form.
+		* ws.getCell("A1").value = { formula: "=[测试.xlsx]Sheet1!A1", result: 42 };
+		* ```
+		*/
+		addExternalLink(input) {
+			const link = {
+				index: this.externalLinks.length + 1,
+				target: input.target,
+				targetMode: input.targetMode ?? "External",
+				sheetNames: input.sheetNames ? [...input.sheetNames] : [],
+				cachedValues: input.cachedValues ? { ...input.cachedValues } : {}
+			};
+			this.externalLinks.push(link);
+			return link;
+		}
+		/**
+		* Retrieve an external link by its 1-based on-disk index (the number
+		* inside the `[N]` formula prefix) or by matching target path.
+		*/
+		getExternalLink(indexOrTarget) {
+			if (typeof indexOrTarget === "number") return this.externalLinks[indexOrTarget - 1];
+			const lower = indexOrTarget.toLowerCase();
+			return this.externalLinks.find((link) => link.target.toLowerCase() === lower);
+		}
+		/**
+		* @internal — used by the writer to obtain the full list of external
+		* links to serialise, including entries auto-discovered from formula
+		* strings during earlier writes. User-visible `externalLinks` always
+		* comes first (in declaration order) so explicit `addExternalLink()`
+		* indices are stable across writes.
+		*/
+		_collectExternalLinksForWrite() {
+			const userLower = new Set(this.externalLinks.map((l) => l.target.toLowerCase()));
+			const combined = this.externalLinks.map((link, i) => ({
+				...link,
+				index: i + 1,
+				sheetNames: [...link.sheetNames ?? []],
+				cachedValues: { ...link.cachedValues ?? {} },
+				targetMode: link.targetMode ?? "External"
+			}));
+			for (const cached of this._writerExternalLinkCache.values()) {
+				if (userLower.has(cached.target.toLowerCase())) continue;
+				combined.push({
+					...cached,
+					index: combined.length + 1,
+					sheetNames: [...cached.sheetNames],
+					cachedValues: { ...cached.cachedValues }
+				});
+			}
+			return combined;
+		}
+		/**
+		* @internal — record an auto-discovered external link (seen in a
+		* formula but not explicitly declared). Idempotent by target; the
+		* sheet name is upserted onto the existing cached entry when present.
+		* Returns the 1-based index the link will carry in the output file.
+		*/
+		_recordAutoExternalLink(target, sheetName) {
+			const lower = target.toLowerCase();
+			const existingUserIdx = this.externalLinks.findIndex((l) => l.target.toLowerCase() === lower);
+			if (existingUserIdx !== -1) return existingUserIdx + 1;
+			let cached = this._writerExternalLinkCache.get(lower);
+			if (!cached) {
+				cached = {
+					index: 0,
+					target,
+					targetMode: "External",
+					sheetNames: [],
+					cachedValues: {}
+				};
+				this._writerExternalLinkCache.set(lower, cached);
+			}
+			if (sheetName && !cached.sheetNames.includes(sheetName)) cached.sheetNames.push(sheetName);
+			const userCount = this.externalLinks.length;
+			let cacheIdx = 0;
+			for (const key of this._writerExternalLinkCache.keys()) {
+				cacheIdx++;
+				if (key === lower) return userCount + cacheIdx;
+			}
+			return userCount + this._writerExternalLinkCache.size;
+		}
 		get model() {
 			return {
 				creator: this.creator || "Unknown",
@@ -45640,6 +47578,7 @@ self.onmessage = async function(event) {
 				created: this.created,
 				modified: this.modified,
 				properties: this.properties,
+				protection: this.protection,
 				worksheets: this.worksheets.map((worksheet) => worksheet.model),
 				sheets: this.worksheets.map((ws) => ws.model).filter(Boolean),
 				definedNames: this._definedNames.model,
@@ -45660,7 +47599,8 @@ self.onmessage = async function(event) {
 				calcProperties: this.calcProperties,
 				passthrough: this._passthrough,
 				rawDrawings: this._rawDrawings,
-				defaultFont: this._defaultFont
+				defaultFont: this._defaultFont,
+				externalLinks: this.externalLinks
 			};
 		}
 		set model(value) {
@@ -45680,8 +47620,10 @@ self.onmessage = async function(event) {
 			this.revision = value.revision;
 			this.contentStatus = value.contentStatus;
 			this.properties = value.properties;
+			this.protection = value.protection;
 			this.calcProperties = value.calcProperties;
 			this._worksheets = [];
+			this._tableNames.clear();
 			value.worksheets.forEach((worksheetModel) => {
 				const { id, name, state } = worksheetModel;
 				const orderNo = value.sheets && value.sheets.findIndex((ws) => ws.id === id);
@@ -45702,6 +47644,8 @@ self.onmessage = async function(event) {
 			this._passthrough = value.passthrough || {};
 			this._rawDrawings = value.rawDrawings || {};
 			this._defaultFont = value.defaultFont;
+			this.externalLinks = value.externalLinks ? [...value.externalLinks] : [];
+			this._writerExternalLinkCache = /* @__PURE__ */ new Map();
 		}
 	};
 	//#endregion
@@ -52434,22 +54378,6 @@ self.onmessage = async function(event) {
 	//#endregion
 	//#region src/modules/pdf/excel-bridge.ts
 	/**
-	* Excel-to-PDF Bridge
-	*
-	* Converts Excel Workbook data into the PDF module's independent data model.
-	* This is the ONLY file in the PDF module that imports from @excel.
-	*
-	* @example
-	* ```typescript
-	* import { Workbook } from "excelts";
-	* import { excelToPdf } from "excelts/pdf";
-	*
-	* const workbook = new Workbook();
-	* // ... build workbook ...
-	* const pdf = await excelToPdf(workbook);
-	* ```
-	*/
-	/**
 	* Export an Excel Workbook directly to PDF.
 	*
 	* This is a convenience function that converts the Workbook to the PDF module's
@@ -52461,6 +54389,7 @@ self.onmessage = async function(event) {
 	* @returns Promise of PDF file as a Uint8Array
 	*/
 	async function excelToPdf(workbook, options) {
+		tryInvokeFormulaEngine(workbook);
 		return exportPdf(excelWorkbookToPdf(workbook), options);
 	}
 	/**
@@ -52502,7 +54431,7 @@ self.onmessage = async function(event) {
 			if (!row) continue;
 			const cells = /* @__PURE__ */ new Map();
 			row.eachCell({ includeEmpty: true }, (cell) => {
-				const hasValue = cell.type !== ValueType.Null && cell.type !== ValueType.Merge;
+				const hasValue = cell.type !== 0 && cell.type !== 1;
 				const hasStyle = cell.style && (cell.style.border && (cell.style.border.top || cell.style.border.right || cell.style.border.bottom || cell.style.border.left) || cell.style.fill || cell.style.font);
 				if (hasValue || hasStyle) cells.set(cell.col, convertCell(cell));
 			});
@@ -52589,17 +54518,17 @@ self.onmessage = async function(event) {
 	}
 	function mapValueType(vt) {
 		switch (vt) {
-			case ValueType.Null: return PdfCellType.Empty;
-			case ValueType.Merge: return PdfCellType.Merge;
-			case ValueType.Number: return PdfCellType.Number;
-			case ValueType.String:
-			case ValueType.SharedString: return PdfCellType.String;
-			case ValueType.Date: return PdfCellType.Date;
-			case ValueType.Hyperlink: return PdfCellType.Hyperlink;
-			case ValueType.Formula: return PdfCellType.Formula;
-			case ValueType.RichText: return PdfCellType.RichText;
-			case ValueType.Boolean: return PdfCellType.Boolean;
-			case ValueType.Error: return PdfCellType.Error;
+			case 0: return PdfCellType.Empty;
+			case 1: return PdfCellType.Merge;
+			case 2: return PdfCellType.Number;
+			case 3:
+			case 7: return PdfCellType.String;
+			case 4: return PdfCellType.Date;
+			case 5: return PdfCellType.Hyperlink;
+			case 6: return PdfCellType.Formula;
+			case 8: return PdfCellType.RichText;
+			case 9: return PdfCellType.Boolean;
+			case 10: return PdfCellType.Error;
 			default: return PdfCellType.String;
 		}
 	}
@@ -52609,12 +54538,12 @@ self.onmessage = async function(event) {
 	function getCellDisplayText(cell) {
 		if (!cell) return "";
 		switch (cell.type) {
-			case ValueType.Null:
-			case ValueType.Merge: return "";
-			case ValueType.RichText:
-			case ValueType.Hyperlink: return cell.text ?? "";
-			case ValueType.Error: return cell.value?.error ?? cell.text ?? "";
-			case ValueType.Formula: {
+			case 0:
+			case 1: return "";
+			case 8:
+			case 5: return cell.text ?? "";
+			case 10: return cell.value?.error ?? cell.text ?? "";
+			case 6: {
 				const result = cell.result;
 				if (result !== void 0 && result !== null) {
 					if (typeof result === "object" && "error" in result) return result.error;
@@ -52638,7 +54567,7 @@ self.onmessage = async function(event) {
 		return String(value);
 	}
 	function convertCellValue(cell) {
-		if (cell.type === ValueType.RichText) {
+		if (cell.type === 8) {
 			const rtValue = cell.value;
 			if (rtValue?.richText) return { richText: rtValue.richText.map((run) => ({
 				text: run.text,