@office-kit/xlsx 0.15.0 → 0.17.0

package/dist/{stylesheet-writer-TxsinwbO.mjs → stylesheet-writer-BBYjNSMA.mjs}

@@ -1,23 +1,23 @@
 import { n as OpenXmlError, o as OpenXmlSchemaError } from "./exceptions-D-CFwxgm.mjs";
-import { a as columnLetterFromIndex, g as tupleToCoordinate, i as columnIndexFromLetter, s as coordinateToTuple } from "./coordinate-Bt5Gni2I.mjs";
+import { _ as rowNumberFromAttr, a as columnLetterFromIndex, c as derivedRowNumber, i as columnIndexFromLetter, l as formatSheetQualifiedRef, s as coordinateToTuple, v as tupleToCoordinate } from "./coordinate-CxC88uBk.mjs";
 import { r as normalizeFormulaText, t as ERROR_CODES$1 } from "./inference-BMvv9cUY.mjs";
-import { A as setSharedFormula, E as setArrayFormula, O as setDataTableFormula, c as getCoordinate, k as setFormula } from "./cell-Df3cKRIl.mjs";
+import { A as setSharedFormula, E as setArrayFormula, N as richTextToString, O as setDataTableFormula, c as getCoordinate, k as setFormula } from "./cell-B5OUUdfI.mjs";
 import { C as makeSurface3DChart, S as makeStockChart, _ as makePie3DChart, a as makeArea3DChart, b as makeScatterChart, c as makeBarChart, d as makeBubbleSeries, f as makeChartSpace, g as makeOfPieChart, h as makeLineChart, l as makeBarSeries, m as makeLine3DChart, n as makeChartDrawing, o as makeAreaChart, p as makeDoughnutChart, s as makeBar3DChart, u as makeBubbleChart, v as makePieChart, w as makeSurfaceChart, x as makeScatterSeries, y as makeRadarChart } from "./user-shapes-DfmCGKB0.mjs";
 import { t as makeChartsheet } from "./chartsheet-C3-tqkPy.mjs";
-import { o as makeDrawing } from "./drawing-ZJ3h4VHD.mjs";
+import { o as makeDrawing } from "./drawing-Cv6UtInY.mjs";
 import { n as VALUED_COLOR_MOD_KINDS, r as VALUELESS_COLOR_MOD_KINDS, t as SCHEME_COLOR_NAMES } from "./colors-ovWAwnZI.mjs";
-import { n as escapeXmlAttr$1, r as escapeXmlText$1, t as escapeCellString } from "./escape-rnWSPpWY.mjs";
+import { i as escapeXmlTextVerbatim, n as escapeXmlAttr$1, r as escapeXmlText$1 } from "./escape-rA5UpibT.mjs";
 import { H as DRAWING_NS, I as CX_NS, T as CHART_NS, a as findChildren, bt as X14_NS, dt as SHEET_DRAWING_NS, ft as SHEET_MAIN_NS, i as findChild, jt as qname, lt as REL_NS, n as el, q as MARKUP_COMPAT_NS, w as CHART_DRAWING_NS } from "./tree-BX-sRRVp.mjs";
 import { t as parseXml } from "./parser-By6RWZVW.mjs";
-import { n as toTree, r as defineSchema, t as fromTree } from "./serialize-BC2Wu3bR.mjs";
-import { t as serializeXml } from "./serializer-C6nm0mRJ.mjs";
-import { Q as findById } from "./manifest-pLmx7KYh.mjs";
-import { Dn as makeColor, Zt as makeLegacyComment, cn as multiCellRangeToString, en as makeSheetView, ln as parseMultiCellRange, mn as rangeToString, nn as makeRowDimension, ot as makeWorksheet, tn as makeColumnDimension, un as parseRange, xt as setCell } from "./worksheet-B2NOQ6dM.mjs";
-import { Bt as PATTERN_TYPES, Ft as FONT_SCHEMES, It as UNDERLINE_STYLES, Kt as SIDE_STYLES, Lt as VERT_ALIGNS, Xt as HORIZONTAL_ALIGNMENTS, Zt as VERTICAL_ALIGNMENTS } from "./cell-style-CNsET6WU.mjs";
-import { C as addSharedRichText, O as parseRichString, w as addSharedString } from "./workbook-DQCslHzY.mjs";
-import { a as makeCfRule, i as makeDataValidation, n as makeTableColumn, o as makeConditionalFormatting, r as makeTableDefinition } from "./table-BrP0RwUd.mjs";
+import { i as defineSchema, n as toTree, r as parseXsdBoolean, t as fromTree } from "./serialize-Dmb6Vtt9.mjs";
+import { t as serializeXml } from "./serializer-dhv07Z6F.mjs";
+import { Q as findById } from "./manifest-BHUYpjUG.mjs";
+import { Dn as makeColor, Zt as makeLegacyComment, cn as multiCellRangeToString, en as makeSheetView, ln as parseMultiCellRange, mn as rangeToString, nn as makeRowDimension, ot as makeWorksheet, tn as makeColumnDimension, un as parseRange, xt as setCell } from "./worksheet-Cxn2c-jz.mjs";
+import { Bt as PATTERN_TYPES, Ft as FONT_SCHEMES, It as UNDERLINE_STYLES, Kt as SIDE_STYLES, Lt as VERT_ALIGNS, Xt as HORIZONTAL_ALIGNMENTS, Zt as VERTICAL_ALIGNMENTS } from "./cell-style-DjKKPWDL.mjs";
+import { C as addSharedRichText, O as parseRichString, w as addSharedString } from "./workbook-CMel6UcI.mjs";
+import { a as makeCfRule, i as makeDataValidation, n as makeTableColumn, o as makeConditionalFormatting, r as makeTableDefinition } from "./table-BFi2WmgG.mjs";
 import { i as durationToExcel, r as dateToExcel } from "./datetime-B2ySVlXt.mjs";
-import { n as getDxfs } from "./differential-BPKa7wXi.mjs";
+import { n as getDxfs } from "./differential-7KGzbliB.mjs";
 //#region src/drawing/dml/effect.ts
 const PRESET_SHADOW_NAMES = [
 	"shdw1",
@@ -4968,6 +4968,26 @@ function translateFormula(formula, origin, opts = {}) {
 	return out;
 }
 //#endregion
+//#region src/utils/cell-number.ts
+/** How much of an offending value the error echoes. Cell text is untrusted and unbounded. */
+const MAX_QUOTED_LENGTH = 40;
+/**
+* Value of a numeric cell's `<v>`: a finite number, or `null` when the element
+* is absent or blank, which is an empty cell.
+*
+* `Number.parseFloat` answers NaN for text and ±Infinity for an exponent past
+* the double range. The writer refuses to serialise either, so a file carrying
+* one is rejected here, while the sheet and cell that hold it are still known,
+* rather than at the far end of the pipeline on save.
+*/
+function parseCellNumber(raw, sheet, col, row) {
+	if (raw === void 0) return null;
+	const n = Number.parseFloat(raw);
+	if (Number.isFinite(n)) return n;
+	if (raw.trim() === "") return null;
+	throw new OpenXmlSchemaError(`worksheet: <v>${raw.length <= MAX_QUOTED_LENGTH ? raw : `${raw.slice(0, MAX_QUOTED_LENGTH)}... (${raw.length} chars)`}</v> at ${formatSheetQualifiedRef(sheet, tupleToCoordinate(col, row))} is not a finite number`);
+}
+//#endregion
 //#region src/worksheet/reader.ts
 const WORKSHEET_TAG = `{${SHEET_MAIN_NS}}worksheet`;
 const SHEETDATA_TAG = `{${SHEET_MAIN_NS}}sheetData`;
@@ -5079,13 +5099,13 @@ function parseWorksheetXml(bytes, title, ctx) {
 		if (outlineLevelRow !== void 0) ws.outlineLevelRow = outlineLevelRow;
 		const outlineLevelCol = parseIntegerAttr(sheetFormatEl.attrs["outlineLevelCol"]);
 		if (outlineLevelCol !== void 0) ws.outlineLevelCol = outlineLevelCol;
-		const customHeight = parseBoolXmlAttr(sheetFormatEl.attrs["customHeight"]);
+		const customHeight = parseXsdBoolean(sheetFormatEl.attrs["customHeight"]);
 		if (customHeight !== void 0) ws.customHeight = customHeight;
-		const zeroHeight = parseBoolXmlAttr(sheetFormatEl.attrs["zeroHeight"]);
+		const zeroHeight = parseXsdBoolean(sheetFormatEl.attrs["zeroHeight"]);
 		if (zeroHeight !== void 0) ws.zeroHeight = zeroHeight;
-		const thickTop = parseBoolXmlAttr(sheetFormatEl.attrs["thickTop"]);
+		const thickTop = parseXsdBoolean(sheetFormatEl.attrs["thickTop"]);
 		if (thickTop !== void 0) ws.thickTop = thickTop;
-		const thickBottom = parseBoolXmlAttr(sheetFormatEl.attrs["thickBottom"]);
+		const thickBottom = parseXsdBoolean(sheetFormatEl.attrs["thickBottom"]);
 		if (thickBottom !== void 0) ws.thickBottom = thickBottom;
 		const baseColWidth = parseIntegerAttr(sheetFormatEl.attrs["baseColWidth"]);
 		if (baseColWidth !== void 0) ws.baseColWidth = baseColWidth;
@@ -5098,8 +5118,10 @@ function parseWorksheetXml(bytes, title, ctx) {
 	const sheetData = findChild(root, SHEETDATA_TAG);
 	if (sheetData) {
 		const sharedFormulas = /* @__PURE__ */ new Map();
+		let nextRow = 1;
 		for (const rowNode of findChildren(sheetData, ROW_TAG$1)) {
-			const rowIdx = parseRowIndex(rowNode);
+			const rowIdx = parseRowIndex(rowNode, nextRow);
+			nextRow = Math.max(nextRow, rowIdx + 1);
 			maybeRecordRowDimension(ws, rowNode, rowIdx);
 			let nextCol = 1;
 			for (const cNode of findChildren(rowNode, C_TAG)) {
@@ -5215,9 +5237,9 @@ function parseWorksheetXml(bytes, title, ctx) {
 				type,
 				properties: []
 			};
-			const deleted = parseBoolXmlAttr(tagNode.attrs["deleted"]);
+			const deleted = parseXsdBoolean(tagNode.attrs["deleted"]);
 			if (deleted !== void 0) tag.deleted = deleted;
-			const xmlBased = parseBoolXmlAttr(tagNode.attrs["xmlBased"]);
+			const xmlBased = parseXsdBoolean(tagNode.attrs["xmlBased"]);
 			if (xmlBased !== void 0) tag.xmlBased = xmlBased;
 			for (const prop of findChildren(tagNode, CELL_SMART_TAG_PR_TAG)) {
 				const key = prop.attrs["key"];
@@ -5338,9 +5360,9 @@ const parseSortState = (node) => {
 		ref,
 		conditions: []
 	};
-	const cs = parseBoolXmlAttr(node.attrs["columnSort"]);
+	const cs = parseXsdBoolean(node.attrs["columnSort"]);
 	if (cs !== void 0) out.columnSort = cs;
-	const cse = parseBoolXmlAttr(node.attrs["caseSensitive"]);
+	const cse = parseXsdBoolean(node.attrs["caseSensitive"]);
 	if (cse !== void 0) out.caseSensitive = cse;
 	const sm = node.attrs["sortMethod"];
 	if (sm && SORT_METHODS.includes(sm)) out.sortMethod = sm;
@@ -5348,7 +5370,7 @@ const parseSortState = (node) => {
 		const cRef = sc.attrs["ref"];
 		if (!cRef) continue;
 		const c = { ref: cRef };
-		const desc = parseBoolXmlAttr(sc.attrs["descending"]);
+		const desc = parseXsdBoolean(sc.attrs["descending"]);
 		if (desc !== void 0) c.descending = desc;
 		const sb = sc.attrs["sortBy"];
 		if (sb && SORT_BY_VALUES.includes(sb)) c.sortBy = sb;
@@ -5388,9 +5410,9 @@ const parseScenario = (node) => {
 		name,
 		inputCells: []
 	};
-	const locked = parseBoolXmlAttr(node.attrs["locked"]);
+	const locked = parseXsdBoolean(node.attrs["locked"]);
 	if (locked !== void 0) out.locked = locked;
-	const hidden = parseBoolXmlAttr(node.attrs["hidden"]);
+	const hidden = parseXsdBoolean(node.attrs["hidden"]);
 	if (hidden !== void 0) out.hidden = hidden;
 	if (node.attrs["user"] !== void 0) out.user = node.attrs["user"];
 	if (node.attrs["comment"] !== void 0) out.comment = node.attrs["comment"];
@@ -5408,9 +5430,9 @@ const parseScenarioInputCell = (node) => {
 		ref,
 		val
 	};
-	const deleted = parseBoolXmlAttr(node.attrs["deleted"]);
+	const deleted = parseXsdBoolean(node.attrs["deleted"]);
 	if (deleted !== void 0) out.deleted = deleted;
-	const undone = parseBoolXmlAttr(node.attrs["undone"]);
+	const undone = parseXsdBoolean(node.attrs["undone"]);
 	if (undone !== void 0) out.undone = undone;
 	const numFmtId = parseIntegerAttr(node.attrs["numFmtId"]);
 	if (numFmtId !== void 0) out.numFmtId = numFmtId;
@@ -5433,11 +5455,11 @@ const parseDataConsolidate = (node) => {
 	const out = {};
 	const f = node.attrs["function"];
 	if (f && DATA_CONSOLIDATE_FUNCTIONS.includes(f)) out.function = f;
-	const topLabels = parseBoolXmlAttr(node.attrs["topLabels"]);
+	const topLabels = parseXsdBoolean(node.attrs["topLabels"]);
 	if (topLabels !== void 0) out.topLabels = topLabels;
-	const leftLabels = parseBoolXmlAttr(node.attrs["leftLabels"]);
+	const leftLabels = parseXsdBoolean(node.attrs["leftLabels"]);
 	if (leftLabels !== void 0) out.leftLabels = leftLabels;
-	const link = parseBoolXmlAttr(node.attrs["link"]);
+	const link = parseXsdBoolean(node.attrs["link"]);
 	if (link !== void 0) out.link = link;
 	if (node.attrs["startLabels"] !== void 0) out.startLabels = node.attrs["startLabels"];
 	const refsEl = findChild(node, DATA_REFS_TAG);
@@ -5506,7 +5528,7 @@ const parseWebPublishItem = (node) => {
 	if (node.attrs["sourceRef"] !== void 0) out.sourceRef = node.attrs["sourceRef"];
 	if (node.attrs["sourceObject"] !== void 0) out.sourceObject = node.attrs["sourceObject"];
 	if (node.attrs["title"] !== void 0) out.title = node.attrs["title"];
-	const auto = parseBoolXmlAttr(node.attrs["autoRepublish"]);
+	const auto = parseXsdBoolean(node.attrs["autoRepublish"]);
 	if (auto !== void 0) out.autoRepublish = auto;
 	return out;
 };
@@ -5545,7 +5567,7 @@ const parseCustomSheetView = (node) => {
 		"filterUnique",
 		"showRuler"
 	]) {
-		const v = parseBoolXmlAttr(node.attrs[k]);
+		const v = parseXsdBoolean(node.attrs[k]);
 		if (v !== void 0) out[k] = v;
 	}
 	const stateRaw = node.attrs["state"];
@@ -5608,7 +5630,7 @@ const parseOleObject = (node) => {
 	if (node.attrs["link"] !== void 0) out.link = node.attrs["link"];
 	const oleUpdate = node.attrs["oleUpdate"];
 	if (oleUpdate && OLE_UPDATE_MODES.includes(oleUpdate)) out.oleUpdate = oleUpdate;
-	const autoLoad = parseBoolXmlAttr(node.attrs["autoLoad"]);
+	const autoLoad = parseXsdBoolean(node.attrs["autoLoad"]);
 	if (autoLoad !== void 0) out.autoLoad = autoLoad;
 	const objectPr = findChild(node, OBJECT_PR_TAG);
 	if (objectPr) out.objectPr = objectPr;
@@ -5635,9 +5657,9 @@ const parsePageBreak = (node) => {
 	if (min !== void 0) out.min = min;
 	const max = parseIntegerAttr(node.attrs["max"]);
 	if (max !== void 0) out.max = max;
-	const man = parseBoolXmlAttr(node.attrs["man"]);
+	const man = parseXsdBoolean(node.attrs["man"]);
 	if (man !== void 0) out.man = man;
-	const pt = parseBoolXmlAttr(node.attrs["pt"]);
+	const pt = parseXsdBoolean(node.attrs["pt"]);
 	if (pt !== void 0) out.pt = pt;
 	return out;
 };
@@ -5999,24 +6021,19 @@ const parseIntegerAttr = (raw) => {
 	const n = Number.parseInt(raw, 10);
 	return Number.isInteger(n) ? n : void 0;
 };
-const parseBoolXmlAttr = (raw) => {
-	if (raw === void 0) return void 0;
-	if (raw === "1" || raw === "true") return true;
-	if (raw === "0" || raw === "false") return false;
-};
 const parseSheetView$1 = (node) => {
 	const opts = { workbookViewId: parseIntegerAttr(node.attrs["workbookViewId"]) ?? 0 };
-	const tabSelected = parseBoolXmlAttr(node.attrs["tabSelected"]);
+	const tabSelected = parseXsdBoolean(node.attrs["tabSelected"]);
 	if (tabSelected !== void 0) opts.tabSelected = tabSelected;
-	const showGridLines = parseBoolXmlAttr(node.attrs["showGridLines"]);
+	const showGridLines = parseXsdBoolean(node.attrs["showGridLines"]);
 	if (showGridLines !== void 0) opts.showGridLines = showGridLines;
-	const showRowColHeaders = parseBoolXmlAttr(node.attrs["showRowColHeaders"]);
+	const showRowColHeaders = parseXsdBoolean(node.attrs["showRowColHeaders"]);
 	if (showRowColHeaders !== void 0) opts.showRowColHeaders = showRowColHeaders;
-	const showFormulas = parseBoolXmlAttr(node.attrs["showFormulas"]);
+	const showFormulas = parseXsdBoolean(node.attrs["showFormulas"]);
 	if (showFormulas !== void 0) opts.showFormulas = showFormulas;
-	const showZeros = parseBoolXmlAttr(node.attrs["showZeros"]);
+	const showZeros = parseXsdBoolean(node.attrs["showZeros"]);
 	if (showZeros !== void 0) opts.showZeros = showZeros;
-	const rightToLeft = parseBoolXmlAttr(node.attrs["rightToLeft"]);
+	const rightToLeft = parseXsdBoolean(node.attrs["rightToLeft"]);
 	if (rightToLeft !== void 0) opts.rightToLeft = rightToLeft;
 	const view = node.attrs["view"];
 	if (view !== void 0 && SHEET_VIEW_MODES.includes(view)) opts.view = view;
@@ -6051,12 +6068,24 @@ const parseSelection = (node) => {
 	if (node.attrs["sqref"]) sel.sqref = node.attrs["sqref"];
 	return sel;
 };
-const parseRowIndex = (rowNode) => {
+/** Row named by the first cell that carries an `@r`, if the row holds one. */
+const firstLocatedCellRow = (rowNode) => {
+	for (const cNode of rowNode.children) {
+		if (cNode.name !== C_TAG) continue;
+		const ref = cNode.attrs["r"];
+		if (ref) return coordinateToTuple(ref).row;
+	}
+};
+/**
+* Row number for a `<row>`. `@r` is optional on CT_Row (ECMA-376 §18.3.1.73);
+* without it the row is the one its first located cell names, which is the only
+* record a generator that omits `@r` leaves of a gap, and is how openpyxl's
+* reader places such a row too. With neither, the row takes `fallbackRow`.
+*/
+const parseRowIndex = (rowNode, fallbackRow) => {
 	const rAttr = rowNode.attrs["r"];
-	if (rAttr === void 0) throw new OpenXmlSchemaError("worksheet: <row> missing required @r");
-	const r = Number.parseInt(rAttr, 10);
-	if (!Number.isInteger(r) || r < 1) throw new OpenXmlSchemaError(`worksheet: <row r="${rAttr}"> is not a positive integer`);
-	return r;
+	if (rAttr !== void 0) return rowNumberFromAttr(rAttr, "worksheet");
+	return firstLocatedCellRow(rowNode) ?? derivedRowNumber(fallbackRow, "worksheet");
 };
 const parseCellCoord = (cNode, rowIdx, fallbackCol) => {
 	const rAttr = cNode.attrs["r"];
@@ -6065,7 +6094,7 @@ const parseCellCoord = (cNode, rowIdx, fallbackCol) => {
 		col: fallbackCol
 	};
 	const t = coordinateToTuple(rAttr);
-	if (t.row !== rowIdx) throw new OpenXmlSchemaError(`worksheet: <c r="${rAttr}"> row ${t.row} disagrees with <row r="${rowIdx}">`);
+	if (t.row !== rowIdx) throw new OpenXmlSchemaError(`worksheet: <c r="${rAttr}"> row ${t.row} disagrees with row ${rowIdx}`);
 	return {
 		row: t.row,
 		col: t.col
@@ -6081,30 +6110,35 @@ const readCell = (ws, cNode, coord, ctx, sharedFormulas) => {
 	if (fNode) {
 		const cell = setCell(ws, coord.row, coord.col, null, styleId);
 		const cachedRaw = vNode === void 0 ? void 0 : vNode.text ?? "";
-		const cached = decodeCachedValue(cachedRaw, t);
-		handleFormula(cell, fNode, coord, cached, sharedFormulas);
+		const cached = decodeCachedValue(cachedRaw, t, ctx, ws.title, coord);
+		handleFormula(cell, fNode, coord, cached, sharedFormulas, t);
 		return;
 	}
 	let value = null;
 	switch (t) {
 		case "n":
-			value = vNode?.text !== void 0 && vNode.text !== "" ? Number.parseFloat(vNode.text) : null;
+			value = parseCellNumber(vNode?.text, ws.title, coord.col, coord.row);
 			break;
 		case "s": {
 			if (vNode?.text === void 0) throw new OpenXmlSchemaError("worksheet: <c t=\"s\"> missing <v>");
-			const idx = Number.parseInt(vNode.text, 10);
-			if (!Number.isInteger(idx) || idx < 0) throw new OpenXmlSchemaError(`worksheet: <c t="s"><v>${vNode.text}</v> is not a valid index`);
-			const sst = ctx.sharedStrings[idx];
-			if (sst === void 0) throw new OpenXmlSchemaError(`worksheet: shared-string index ${idx} out of range [0, ${ctx.sharedStrings.length})`);
+			const sst = resolveSharedString(vNode.text, ctx);
 			value = typeof sst === "string" ? sst : {
 				kind: "rich-text",
 				runs: sst.runs
 			};
 			break;
 		}
-		case "b":
-			value = vNode?.text === "1";
+		case "b": {
+			const raw = vNode?.text?.trim();
+			if (raw === void 0 || raw === "") {
+				value = null;
+				break;
+			}
+			const parsed = parseXsdBoolean(raw);
+			if (parsed === void 0) throw new OpenXmlSchemaError(`worksheet: <c r="${tupleToCoordinate(coord.col, coord.row)}" t="b"><v>${clipCellText(raw)}</v></c> is not a boolean`);
+			value = parsed;
 			break;
+		}
 		case "e": {
 			const code = vNode?.text;
 			if (code === void 0 || !ERROR_CODES$1.has(code)) throw new OpenXmlSchemaError(`worksheet: unknown error code "${code}" in <c t="e">`);
@@ -6124,6 +6158,16 @@ const readCell = (ws, cNode, coord, ctx, sharedFormulas) => {
 	}
 	setCell(ws, coord.row, coord.col, value, styleId);
 };
+const MAX_REPORTED_TEXT = 40;
+/**
+* Cell text quoted into an error message is untrusted input of unbounded
+* length, and nothing stops it from spanning lines, so keep the message one
+* short line whatever the part holds.
+*/
+const clipCellText = (raw) => {
+	const oneLine = raw.replace(/\s+/g, " ");
+	return oneLine.length > MAX_REPORTED_TEXT ? `${oneLine.slice(0, MAX_REPORTED_TEXT)}…` : oneLine;
+};
 const parseStyleId = (raw) => {
 	const n = Number.parseInt(raw, 10);
 	if (!Number.isInteger(n) || n < 0) throw new OpenXmlSchemaError(`worksheet: <c s="${raw}"> is not a non-negative integer`);
@@ -6143,21 +6187,39 @@ const readInlineString = (isNode) => {
 		runs: entry.runs
 	};
 };
-const decodeCachedValue = (raw, t) => {
+const resolveSharedString = (raw, ctx) => {
+	const idx = Number.parseInt(raw, 10);
+	if (!Number.isInteger(idx) || idx < 0) throw new OpenXmlSchemaError(`worksheet: <c t="s"><v>${raw}</v> is not a valid index`);
+	const sst = ctx.sharedStrings[idx];
+	if (sst === void 0) throw new OpenXmlSchemaError(`worksheet: shared-string index ${idx} out of range [0, ${ctx.sharedStrings.length})`);
+	return sst;
+};
+const decodeCachedValue = (raw, t, ctx, sheet, coord) => {
 	if (raw === void 0) return void 0;
 	switch (t) {
-		case "n": return raw === "" ? void 0 : Number.parseFloat(raw);
-		case "b": return raw === "" ? void 0 : raw === "1";
-		case "str": return raw;
-		case "e": return raw;
-		case "s": return raw;
+		case "n": return parseCellNumber(raw, sheet, coord.col, coord.row) ?? void 0;
+		case "b": {
+			const text = raw.trim();
+			if (text === "") return void 0;
+			const parsed = parseXsdBoolean(text);
+			if (parsed === void 0) throw new OpenXmlSchemaError(`worksheet: <c r="${tupleToCoordinate(coord.col, coord.row)}" t="b"><v>${clipCellText(text)}</v></c> cached result is not a boolean`);
+			return parsed;
+		}
+		case "s": {
+			if (raw === "") return void 0;
+			const sst = resolveSharedString(raw, ctx);
+			return typeof sst === "string" ? sst : richTextToString(sst.runs);
+		}
 		default: return raw;
 	}
 };
-const handleFormula = (cell, fNode, coord, cached, sharedFormulas) => {
+const handleFormula = (cell, fNode, coord, cached, sharedFormulas, cachedType) => {
 	const tAttr = fNode.attrs["t"] ?? "normal";
 	const formula = normalizeFormulaText(fNode.text ?? "");
-	const opts = cached !== void 0 ? { cachedValue: cached } : void 0;
+	const opts = cached !== void 0 ? {
+		cachedValue: cached,
+		...cachedType === "e" ? { cachedValueType: "error" } : {}
+	} : void 0;
 	switch (tAttr) {
 		case "normal":
 			if (formula.length === 0) throw new OpenXmlSchemaError(`worksheet: <f> at ${tupleToCoordinate(coord.col, coord.row)} has no formula text`);
@@ -6194,25 +6256,21 @@ const handleFormula = (cell, fNode, coord, cached, sharedFormulas) => {
 			if (!ref) throw new OpenXmlSchemaError("worksheet: <f t=\"dataTable\"> missing @ref");
 			setDataTableFormula(cell, formula, {
 				ref,
-				...cached !== void 0 ? { cachedValue: cached } : {},
+				...opts,
 				...fNode.attrs["r1"] !== void 0 ? { r1: fNode.attrs["r1"] } : {},
 				...fNode.attrs["r2"] !== void 0 ? { r2: fNode.attrs["r2"] } : {},
-				...parseDataTableBool(fNode.attrs["dt2D"]) ? { dt2D: true } : {},
-				...parseDataTableBool(fNode.attrs["dtr"]) ? { dtr: true } : {},
-				...parseDataTableBool(fNode.attrs["del1"]) ? { del1: true } : {},
-				...parseDataTableBool(fNode.attrs["del2"]) ? { del2: true } : {},
-				...parseDataTableBool(fNode.attrs["aca"]) ? { aca: true } : {},
-				...parseDataTableBool(fNode.attrs["ca"]) ? { ca: true } : {}
+				...parseXsdBoolean(fNode.attrs["dt2D"]) ? { dt2D: true } : {},
+				...parseXsdBoolean(fNode.attrs["dtr"]) ? { dtr: true } : {},
+				...parseXsdBoolean(fNode.attrs["del1"]) ? { del1: true } : {},
+				...parseXsdBoolean(fNode.attrs["del2"]) ? { del2: true } : {},
+				...parseXsdBoolean(fNode.attrs["aca"]) ? { aca: true } : {},
+				...parseXsdBoolean(fNode.attrs["ca"]) ? { ca: true } : {}
 			});
 			return;
 		}
 		default: throw new OpenXmlSchemaError(`worksheet: <f t="${tAttr}"> unknown formula kind`);
 	}
 };
-const parseDataTableBool = (raw) => {
-	if (raw === void 0) return false;
-	return raw === "1" || raw === "true";
-};
 const parseColumnDimension = (node) => {
 	const minRaw = node.attrs["min"];
 	const maxRaw = node.attrs["max"];
@@ -6223,17 +6281,17 @@ const parseColumnDimension = (node) => {
 	const opts = {};
 	const width = parseFloatAttr(node.attrs["width"]);
 	if (width !== void 0) opts.width = width;
-	const customWidth = parseBoolXmlAttr(node.attrs["customWidth"]);
+	const customWidth = parseXsdBoolean(node.attrs["customWidth"]);
 	if (customWidth !== void 0) opts.customWidth = customWidth;
-	const hidden = parseBoolXmlAttr(node.attrs["hidden"]);
+	const hidden = parseXsdBoolean(node.attrs["hidden"]);
 	if (hidden !== void 0) opts.hidden = hidden;
-	const bestFit = parseBoolXmlAttr(node.attrs["bestFit"]);
+	const bestFit = parseXsdBoolean(node.attrs["bestFit"]);
 	if (bestFit !== void 0) opts.bestFit = bestFit;
 	const outlineLevel = parseIntegerAttr(node.attrs["outlineLevel"]);
 	if (outlineLevel !== void 0) opts.outlineLevel = outlineLevel;
 	const style = parseIntegerAttr(node.attrs["style"]);
 	if (style !== void 0) opts.style = style;
-	const collapsed = parseBoolXmlAttr(node.attrs["collapsed"]);
+	const collapsed = parseXsdBoolean(node.attrs["collapsed"]);
 	if (collapsed !== void 0) opts.collapsed = collapsed;
 	return {
 		...makeColumnDimension(min, opts),
@@ -6275,13 +6333,13 @@ const parseDataValidation = (node) => {
 	};
 	const operator = node.attrs["operator"];
 	if (operator && DV_OPERATORS.includes(operator)) opts.operator = operator;
-	const allowBlank = parseBoolXmlAttr(node.attrs["allowBlank"]);
+	const allowBlank = parseXsdBoolean(node.attrs["allowBlank"]);
 	if (allowBlank !== void 0) opts.allowBlank = allowBlank;
-	const showInputMessage = parseBoolXmlAttr(node.attrs["showInputMessage"]);
+	const showInputMessage = parseXsdBoolean(node.attrs["showInputMessage"]);
 	if (showInputMessage !== void 0) opts.showInputMessage = showInputMessage;
-	const showErrorMessage = parseBoolXmlAttr(node.attrs["showErrorMessage"]);
+	const showErrorMessage = parseXsdBoolean(node.attrs["showErrorMessage"]);
 	if (showErrorMessage !== void 0) opts.showErrorMessage = showErrorMessage;
-	const showDropDown = parseBoolXmlAttr(node.attrs["showDropDown"]);
+	const showDropDown = parseXsdBoolean(node.attrs["showDropDown"]);
 	if (showDropDown !== void 0) opts.showDropDown = showDropDown;
 	const errorTitle = node.attrs["errorTitle"];
 	if (errorTitle !== void 0) opts.errorTitle = errorTitle;
@@ -6336,7 +6394,7 @@ const parseConditionalFormatting = (node) => {
 		sqref: parseMultiCellRange(sqrefRaw),
 		rules
 	};
-	const pivot = parseBoolXmlAttr(node.attrs["pivot"]);
+	const pivot = parseXsdBoolean(node.attrs["pivot"]);
 	if (pivot !== void 0) opts.pivot = pivot;
 	return makeConditionalFormatting(opts);
 };
@@ -6354,19 +6412,19 @@ const parseCfRule = (node) => {
 	};
 	const dxf = parseIntegerAttr(node.attrs["dxfId"]);
 	if (dxf !== void 0) opts.dxfId = dxf;
-	const stop = parseBoolXmlAttr(node.attrs["stopIfTrue"]);
+	const stop = parseXsdBoolean(node.attrs["stopIfTrue"]);
 	if (stop !== void 0) opts.stopIfTrue = stop;
 	if (node.attrs["operator"]) opts.operator = node.attrs["operator"];
 	if (node.attrs["text"] !== void 0) opts.text = node.attrs["text"];
-	const percent = parseBoolXmlAttr(node.attrs["percent"]);
+	const percent = parseXsdBoolean(node.attrs["percent"]);
 	if (percent !== void 0) opts.percent = percent;
-	const bottom = parseBoolXmlAttr(node.attrs["bottom"]);
+	const bottom = parseXsdBoolean(node.attrs["bottom"]);
 	if (bottom !== void 0) opts.bottom = bottom;
 	const rank = parseIntegerAttr(node.attrs["rank"]);
 	if (rank !== void 0) opts.rank = rank;
-	const aboveAverage = parseBoolXmlAttr(node.attrs["aboveAverage"]);
+	const aboveAverage = parseXsdBoolean(node.attrs["aboveAverage"]);
 	if (aboveAverage !== void 0) opts.aboveAverage = aboveAverage;
-	const equalAverage = parseBoolXmlAttr(node.attrs["equalAverage"]);
+	const equalAverage = parseXsdBoolean(node.attrs["equalAverage"]);
 	if (equalAverage !== void 0) opts.equalAverage = equalAverage;
 	const stdDev = parseIntegerAttr(node.attrs["stdDev"]);
 	if (stdDev !== void 0) opts.stdDev = stdDev;
@@ -6399,7 +6457,7 @@ const parseAutoFilter = (node) => {
 			const v = f.attrs["val"];
 			if (v !== void 0) values.push(v);
 		}
-		const blank = parseBoolXmlAttr(filtersEl.attrs["blank"]);
+		const blank = parseXsdBoolean(filtersEl.attrs["blank"]);
 		const fc2 = {
 			kind: "filters",
 			colId,
@@ -6432,13 +6490,13 @@ const maybeRecordRowDimension = (ws, node, rowIdx) => {
 	const opts = {};
 	const ht = parseFloatAttr(node.attrs["ht"]);
 	if (ht !== void 0) opts.height = ht;
-	const customHeight = parseBoolXmlAttr(node.attrs["customHeight"]);
+	const customHeight = parseXsdBoolean(node.attrs["customHeight"]);
 	if (customHeight !== void 0) opts.customHeight = customHeight;
-	const hidden = parseBoolXmlAttr(node.attrs["hidden"]);
+	const hidden = parseXsdBoolean(node.attrs["hidden"]);
 	if (hidden !== void 0) opts.hidden = hidden;
 	const outlineLevel = parseIntegerAttr(node.attrs["outlineLevel"]);
 	if (outlineLevel !== void 0) opts.outlineLevel = outlineLevel;
-	const collapsed = parseBoolXmlAttr(node.attrs["collapsed"]);
+	const collapsed = parseXsdBoolean(node.attrs["collapsed"]);
 	if (collapsed !== void 0) opts.collapsed = collapsed;
 	const style = parseIntegerAttr(node.attrs["s"]);
 	if (style !== void 0) opts.style = style;
@@ -6617,11 +6675,10 @@ const colLetters = (n) => {
 * streaming write-only path can emit cells row-by-row without going through the
 * full Worksheet model — see src/streaming/write-only.ts.
 *
-* Only `ctx.sharedStrings` is consulted for plain-string cells; the other
-* context fields are used by the worksheet-level serializer that wraps this
-* helper.
+* String cells use the optional writer or the model's shared-string table.
+* Date cells also consult the shared style pool.
 */
-const serializeCell = (cell, ctx) => {
+const serializeCell = (cell, ctx, stringWriter) => {
 	const ref = getCoordinate(cell);
 	const styleAttr = cell.styleId === 0 ? "" : ` s="${cell.styleId}"`;
 	const value = cell.value;
@@ -6630,26 +6687,37 @@ const serializeCell = (cell, ctx) => {
 	if (typeof value === "object" && value !== null && value.kind === "error") return `<c r="${ref}"${styleAttr} t="e"><v>${value.code}</v></c>`;
 	if (typeof value === "object" && value !== null && value.kind === "rich-text") {
 		const runs = value.runs;
+		if (stringWriter) {
+			const text = stringWriter({
+				kind: "rich-text",
+				runs
+			});
+			return `<c r="${ref}"${styleAttr} t="${text.type}">${text.xml}</c>`;
+		}
 		return `<c r="${ref}"${styleAttr} t="s"><v>${addSharedRichText(ctx.sharedStrings, runs)}</v></c>`;
 	}
-	if (typeof value === "number") {
-		if (!Number.isFinite(value)) throw new OpenXmlSchemaError(`worksheet: cannot serialise non-finite number at ${ref}`);
-		return `<c r="${ref}"${styleAttr}><v>${serializeNumber(value)}</v></c>`;
-	}
+	if (typeof value === "number") return `<c r="${ref}"${styleAttr}><v>${serializeNumber(value, ref)}</v></c>`;
 	if (typeof value === "boolean") return `<c r="${ref}"${styleAttr} t="b"><v>${value ? "1" : "0"}</v></c>`;
-	if (typeof value === "string") return `<c r="${ref}"${styleAttr} t="s"><v>${addSharedString(ctx.sharedStrings, value)}</v></c>`;
+	if (typeof value === "string") {
+		if (stringWriter) {
+			const text = stringWriter(value);
+			return `<c r="${ref}"${styleAttr} t="${text.type}">${text.xml}</c>`;
+		}
+		return `<c r="${ref}"${styleAttr} t="s"><v>${addSharedString(ctx.sharedStrings, value)}</v></c>`;
+	}
 	if (value instanceof Date) {
 		const serial = dateToExcel(value, { epoch: ctx.date1904 ? "mac" : "windows" });
-		return `<c r="${ref}"${styleAttr}><v>${serializeNumber(serial)}</v></c>`;
+		return `<c r="${ref}"${styleAttr}><v>${serializeNumber(serial, ref)}</v></c>`;
 	}
 	if (typeof value === "object" && value !== null && value.kind === "duration") {
 		const ms = value.ms;
 		const serial = durationToExcel(ms);
-		return `<c r="${ref}"${styleAttr}><v>${serializeNumber(serial)}</v></c>`;
+		return `<c r="${ref}"${styleAttr}><v>${serializeNumber(serial, ref)}</v></c>`;
 	}
 	throw new OpenXmlSchemaError(`worksheet: unsupported cell value kind at ${ref}: ${describeValue(value)}`);
 };
-const serializeNumber = (n) => {
+const serializeNumber = (n, ref) => {
+	if (!Number.isFinite(n)) throw new OpenXmlSchemaError(`worksheet: cannot serialise non-finite number at ${ref}`);
 	return Number.isInteger(n) ? n.toFixed(0) : String(n);
 };
 const serializeFormulaCell = (ref, styleAttr, f) => {
@@ -6668,18 +6736,22 @@ const serializeFormulaCell = (ref, styleAttr, f) => {
 	const fAttrStr = fAttrs.length > 0 ? ` ${fAttrs.join(" ")}` : "";
 	const normalized = normalizeFormulaText(f.formula);
 	if ((f.t === "normal" || f.t === "array") && normalized.length === 0) throw new OpenXmlSchemaError(`worksheet: ${f.t} formula must not be empty at ${ref}`);
-	const formulaText = escapeXmlText(escapeCellString(normalized));
+	const formulaText = escapeXmlTextVerbatim(normalized, "worksheet: formula", ref);
 	const fEl = formulaText.length > 0 ? `<f${fAttrStr}>${formulaText}</f>` : `<f${fAttrStr}/>`;
 	let valueAttr = "";
 	let vEl = "";
 	const cached = f.cachedValue;
-	if (cached !== void 0) if (typeof cached === "number") vEl = `<v>${serializeNumber(cached)}</v>`;
+	if (f.cachedValueType === "error") {
+		if (typeof cached !== "string" || !ERROR_CODES$1.has(cached)) throw new OpenXmlSchemaError(`worksheet: invalid cached formula error at ${ref}`);
+		valueAttr = " t=\"e\"";
+		vEl = `<v>${cached}</v>`;
+	} else if (cached !== void 0) if (typeof cached === "number") vEl = `<v>${serializeNumber(cached, ref)}</v>`;
 	else if (typeof cached === "boolean") {
 		valueAttr = " t=\"b\"";
 		vEl = `<v>${cached ? "1" : "0"}</v>`;
 	} else {
 		valueAttr = " t=\"str\"";
-		const text = escapeXmlText(escapeCellString(cached));
+		const text = escapeXmlTextVerbatim(cached, "worksheet: cached formula result", ref);
 		vEl = text.length > 0 ? `<v>${text}</v>` : "<v/>";
 	}
 	return `<c r="${ref}"${styleAttr}${valueAttr}>${fEl}${vEl}</c>`;
@@ -6815,7 +6887,11 @@ const serializeCfRule = (rule) => {
 	if (rule.stdDev !== void 0) attrs += ` stdDev="${rule.stdDev}"`;
 	if (rule.timePeriod !== void 0) attrs += ` timePeriod="${rule.timePeriod}"`;
 	const inner = [];
-	for (const f of rule.formulas) inner.push(`<formula>${escapeXmlText(normalizeFormulaText(f))}</formula>`);
+	for (const f of rule.formulas) {
+		const at = `priority ${rule.priority}`;
+		const text = escapeXmlTextVerbatim(normalizeFormulaText(f), "worksheet: conditional-formatting formula", at);
+		inner.push(`<formula>${text}</formula>`);
+	}
 	if (rule.innerXml) inner.push(rule.innerXml);
 	if (inner.length === 0) return `<cfRule${attrs}/>`;
 	return `<cfRule${attrs}>${inner.join("")}</cfRule>`;
@@ -6838,10 +6914,17 @@ const serializeDataValidation = (dv) => {
 	if (dv.error !== void 0) attrs += ` error="${escapeXmlAttr(dv.error)}"`;
 	if (dv.promptTitle !== void 0) attrs += ` promptTitle="${escapeXmlAttr(dv.promptTitle)}"`;
 	if (dv.prompt !== void 0) attrs += ` prompt="${escapeXmlAttr(dv.prompt)}"`;
-	attrs += ` sqref="${escapeXmlAttr(multiCellRangeToString(dv.sqref))}"`;
+	const sqref = multiCellRangeToString(dv.sqref);
+	attrs += ` sqref="${escapeXmlAttr(sqref)}"`;
 	const formulas = [];
-	if (dv.formula1 !== void 0) formulas.push(`<formula1>${escapeXmlText(normalizeFormulaText(dv.formula1))}</formula1>`);
-	if (dv.formula2 !== void 0) formulas.push(`<formula2>${escapeXmlText(normalizeFormulaText(dv.formula2))}</formula2>`);
+	if (dv.formula1 !== void 0) {
+		const text = escapeXmlTextVerbatim(normalizeFormulaText(dv.formula1), "worksheet: data-validation formula1", sqref);
+		formulas.push(`<formula1>${text}</formula1>`);
+	}
+	if (dv.formula2 !== void 0) {
+		const text = escapeXmlTextVerbatim(normalizeFormulaText(dv.formula2), "worksheet: data-validation formula2", sqref);
+		formulas.push(`<formula2>${text}</formula2>`);
+	}
 	if (formulas.length === 0) return `<dataValidation${attrs}/>`;
 	return `<dataValidation${attrs}>${formulas.join("")}</dataValidation>`;
 };
@@ -8724,6 +8807,6 @@ const cellXfToTree = (xf) => {
 	return node;
 };
 //#endregion
-export { chartExToBytes as C, findUserShapesRId as D, chartToBytes as E, parseChartXml as O, userShapesToBytes as S, parseChartExXml as T, parseChartsheetXml as _, parseCommentsXml as a, parseWorksheetXml as b, NumberFormatSchema as c, BorderSchema as d, AlignmentSchema as f, chartsheetToBytes as g, parseDrawingXml as h, commentsToBytes as i, FontSchema as l, drawingToBytes as m, parseTableXml as n, placeholderVmlDrawing as o, collectRawRelIds as p, tableToBytes as r, ProtectionSchema as s, stylesheetToBytes as t, fillFromTree as u, serializeCell as v, isChartExBytes as w, parseUserShapesXml as x, writeWorksheetXml as y };
+export { userShapesToBytes as C, chartToBytes as D, parseChartExXml as E, findUserShapesRId as O, parseUserShapesXml as S, isChartExBytes as T, parseChartsheetXml as _, parseCommentsXml as a, parseWorksheetXml as b, NumberFormatSchema as c, BorderSchema as d, AlignmentSchema as f, chartsheetToBytes as g, parseDrawingXml as h, commentsToBytes as i, parseChartXml as k, FontSchema as l, drawingToBytes as m, parseTableXml as n, placeholderVmlDrawing as o, collectRawRelIds as p, tableToBytes as r, ProtectionSchema as s, stylesheetToBytes as t, fillFromTree as u, serializeCell as v, chartExToBytes as w, parseCellNumber as x, writeWorksheetXml as y };
 
-//# sourceMappingURL=stylesheet-writer-TxsinwbO.mjs.map
+//# sourceMappingURL=stylesheet-writer-BBYjNSMA.mjs.map