xlvane 1.0.0 → 1.1.0

package/dist/{rows-Cwte1t8m.js → rows-DKwlr0rg.js}

@@ -1,4 +1,4 @@
-import { $t as MAX_COLUMNS, At as mergeStyles, B as tokenize, Dt as parseStyles, Et as EMPTY_STYLES, Ft as resolveLimits, I as WarningCollector, It as suggest, M as openZip, Mt as stableKey, Nt as isDateFormat, Ot as READING_ORDERS, Pt as DEFAULT_READ_LIMITS, Qt as relationshipTypes, Sn as XlvError, U as attr, V as DEFAULT_FONT, W as borderXml, X as fontXml, Xt as SML_NS, Y as fillXml, Z as formatNumber, Zt as classifyRelationship, _ as isoDate, _n as encodeXstring, _t as parseSharedStrings, an as parseRange, b as readWorkbook, bt as partKey, ct as stringItemXml, dn as childrenNamed, en as MAX_ROWS, f as createWorkbook, fn as parseXmlTree, gn as parseXml, gt as parseIsoDateTime, h as detectHeader, hn as normalizeLineEnds, i as readOptions, in as parseCellRef, jt as normalizeStyle, kt as checkStyleCount, m as writeWorkbook, mn as decodeXml, mt as writeZip, n as oneOfOption, nn as formatCellRef, r as openInput, rn as formatRange, t as booleanOption, tn as columnLetters, tt as reusableBuiltinNumFmt, un as childNamed, ut as textElement, vn as escapeAttr, vt as openPackage, x as toBytes, xt as zipNameToPartName, yn as escapeText, yt as relationshipsPartName, z as shiftFormula } from "./options-B7UhudO_.js";
+import { $ as fillXml, At as EMPTY_STYLES, B as tokenize, Bt as suggest, Cn as escapeText, Ct as relationshipsPartName, En as XlvError, Ft as normalizeStyle, G as DEFAULT_FONT, H as X14_DV_URI, I as WarningCollector, It as stableKey, J as borderXml, Lt as isDateFormat, M as openZip, Mt as READING_ORDERS, Nt as checkStyleCount, Pt as mergeStyles, Rt as DEFAULT_READ_LIMITS, Sn as escapeAttr, St as openPackage, Tt as zipNameToPartName, V as X14_CF_URI, _ as isoDate, an as columnLetters, at as reusableBuiltinNumFmt, b as readWorkbook, bn as parseXml, bt as parseIsoDateTime, cn as parseCellRef, en as SML_NS, et as fontXml, f as createWorkbook, ft as stringItemXml, gn as parseXmlTree, h as detectHeader, hn as childrenNamed, i as readOptions, in as MAX_ROWS, jt as parseStyles, ln as parseRange, m as writeWorkbook, mn as childNamed, mt as textElement, n as oneOfOption, nn as relationshipTypes, on as formatCellRef, q as attr, r as openInput, rn as MAX_COLUMNS, sn as formatRange, t as booleanOption, tn as classifyRelationship, tt as formatNumber, vn as decodeXml, vt as writeZip, wt as partKey, x as toBytes, xn as encodeXstring, xt as parseSharedStrings, yn as normalizeLineEnds, z as shiftFormula, zt as resolveLimits } from "./options-CwSp2pA4.js";
 // src/table.ts
 const READ_OPTIONS = [
 	"sheet",
@@ -1030,7 +1030,7 @@ function withPrefix(xml, prefix) {
 /** Sets (or adds) an attribute in a start tag given as source text. */
 function setAttr(tag, name, value) {
 	const pattern = new RegExp(`(\\s${name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\s*=\\s*)("[^"]*"|'[^']*')`);
-	if (pattern.test(tag)) return tag.replace(pattern, `$1"${escapeAttr(value)}"`);
+	if (pattern.test(tag)) return tag.replace(pattern, (_m, head) => `${head}"${escapeAttr(value)}"`);
 	const close = tag.endsWith("/>") ? tag.length - 2 : tag.length - 1;
 	return `${tag.slice(0, close)} ${name}="${escapeAttr(value)}"${tag.slice(close)}`;
 }
@@ -1078,14 +1078,15 @@ function scan(text, part, limits, keep) {
 	const names = [];
 	let root = null;
 	parseXml(text, {
-		start(_ns, local, attrs, span) {
+		start(ns, local, attrs, span) {
 			const depth = names.length + 1;
 			const parent = names[names.length - 1] ?? "";
 			names.push(local);
 			let element = null;
-			if (depth === 1 || keep(local, depth, parent)) {
+			if (depth === 1 || keep(local, depth, parent, ns)) {
 				element = {
 					local,
+					ns,
 					depth,
 					attrs,
 					start: span,
@@ -2649,10 +2650,27 @@ function notSupported(message, location, details) {
 function adjustText(raw, c, formulaSheet) {
 	if (raw.includes("<")) return null;
 	const text = decodeEntities(raw);
-	const out = adjustFormula(text, refChange(c, formulaSheet));
-	if (out === null) return formulaSheet.toLowerCase() !== c.sheet.toLowerCase() && !text.includes("!") ? raw : null;
+	const out = adjustDecoded(text, c, formulaSheet);
+	if (out === null) return null;
 	return out === text ? raw : escapeText(out);
 }
+/** {@link adjustText} for formula text that is already decoded, such as an attribute value. */
+function adjustDecoded(text, c, formulaSheet) {
+	const out = adjustFormula(text, refChange(c, formulaSheet));
+	if (out === null) return formulaSheet.toLowerCase() !== c.sheet.toLowerCase() && !text.includes("!") ? text : null;
+	return out;
+}
+/** `ext@uri` values of the worksheet extensions whose ranges and formulas are rewritten (SR-40, D-F04). */
+const KNOWN_EXTENSIONS = new Set([X14_CF_URI, X14_DV_URI].map((u) => u.toLowerCase()));
+const isKnownExtension = (e) => KNOWN_EXTENSIONS.has((e.attrs.get("uri") ?? "").trim().toLowerCase());
+/** Start tags named `f` or `sqref`, with any prefix: the formulas and ranges an extension can hold. */
+const FORMULA_OR_RANGE_TAG = /<(?:[\w.-]+:)?(?:f|sqref)[\s/>]/g;
+const CFVO_PARENTS = /* @__PURE__ */ new Set([
+	"colorScale",
+	"dataBar",
+	"iconSet"
+]);
+const within = (outer, inner) => inner.start.start >= outer.start.start && inner.end.end <= outer.end.end;
 /**
 * Applies non-overlapping replacements in one pass (linear in the text size, unlike edit.ts
 * `splice`, which matters for sheets with many moved cells). An edit inside an earlier replaced
@@ -2683,7 +2701,7 @@ const KEEP_DEPTH3 = /* @__PURE__ */ new Set([
 ]);
 /** Rewrites one worksheet part: references everywhere, and row positions on the changed sheet. */
 function rewriteSheet(text, part, sheet, c, target, style, limits) {
-	const { elements } = scan(text, part, limits, (local, depth, parent) => depth === 2 || depth === 3 && KEEP_DEPTH3.has(local) || depth === 4 && (local === "c" && parent === "row" || local === "formula" && parent === "cfRule" || (local === "formula1" || local === "formula2") && parent === "dataValidation") || depth === 5 && local === "f" && parent === "c");
+	const { elements } = scan(text, part, limits, (local, depth, parent, ns) => depth === 2 || depth === 3 && (KEEP_DEPTH3.has(local) || local === "ext" && parent === "extLst") || depth === 4 && (local === "c" && parent === "row" || local === "formula" && parent === "cfRule" || (local === "formula1" || local === "formula2") && parent === "dataValidation") || depth === 5 && (local === "f" && parent === "c" || local === "cfvo" && CFVO_PARENTS.has(parent)) || ns === "http://schemas.microsoft.com/office/spreadsheetml/2009/9/main" && (depth === 4 && (local === "conditionalFormattings" || local === "dataValidations") || depth === 5 && (local === "conditionalFormatting" || local === "dataValidation") || depth === 6 && (local === "cfRule" || local === "id" && parent === "ext")) || ns === "http://schemas.microsoft.com/office/excel/2006/main" && (depth === 6 && local === "sqref" || depth >= 7 && local === "f"));
 	const edits = [];
 	const tagOf = (e) => text.slice(e.start.start, e.start.end);
 	const replaceTag = (e, tag) => {
@@ -2712,11 +2730,26 @@ function rewriteSheet(text, part, sheet, c, target, style, limits) {
 		if (e.depth !== 2) continue;
 		const what = REFUSED_ELEMENTS[e.local];
 		if (what !== void 0) throw notSupported(`Sheet "${sheet.name}" has ${what}, which xlvane cannot move with its rows yet.`, where(), { element: e.local });
-		if (e.local === "extLst" && /sqref|<xm:f|sparkline|slicer/i.test(text.slice(e.start.start, e.end.end))) throw notSupported(`Sheet "${sheet.name}" has extended content (such as data bars, sparklines or slicers) that refers to cells, which xlvane cannot move with its rows yet.`, where(), { element: "extLst" });
 	}
-	else {
-		const ext = elements.find((e) => e.depth === 2 && e.local === "extLst");
-		if (ext && /<xm:f|sparkline/i.test(text.slice(ext.start.start, ext.end.end)) && text.slice(ext.start.start, ext.end.end).toLowerCase().includes(c.sheet.toLowerCase())) throw notSupported(`Sheet "${sheet.name}" has extended content (such as sparklines) that may refer to sheet "${c.sheet}", which xlvane cannot rewrite yet.`, where(), { element: "extLst" });
+	const knownExts = /* @__PURE__ */ new Set();
+	{
+		let current = null;
+		let found = 0;
+		const close = () => {
+			if (current !== null && (text.slice(current.start.start, current.end.end).match(FORMULA_OR_RANGE_TAG) ?? []).length === found) knownExts.add(current);
+		};
+		for (const e of elements) if (e.depth === 3 && e.local === "ext") {
+			close();
+			current = isKnownExtension(e) ? e : null;
+			found = 0;
+		} else if (current !== null && e.ns === "http://schemas.microsoft.com/office/excel/2006/main" && (e.depth === 6 && e.local === "sqref" || e.depth >= 7 && e.local === "f") && within(current, e)) found++;
+		close();
+	}
+	for (const ext of elements) {
+		if (ext.depth !== 3 || ext.local !== "ext" || knownExts.has(ext)) continue;
+		const body = text.slice(ext.start.start, ext.end.end);
+		if (target && /sqref|<xm:f|sparkline|slicer/i.test(body)) throw notSupported(`Sheet "${sheet.name}" has extended content (such as sparklines or slicers) that refers to cells, which xlvane cannot move with its rows yet.`, where(), { element: "extLst" });
+		if (!target && /<xm:f|sparkline/i.test(body) && body.toLowerCase().includes(c.sheet.toLowerCase())) throw notSupported(`Sheet "${sheet.name}" has extended content (such as sparklines) that may refer to sheet "${c.sheet}", which xlvane cannot rewrite yet.`, where(), { element: "extLst" });
 	}
 	const rows = [];
 	let current = null;
@@ -2732,64 +2765,83 @@ function rewriteSheet(text, part, sheet, c, target, style, limits) {
 		});
 	};
 	let hasFormulas = false;
-	for (const e of elements) if (e.depth === 3 && e.local === "row") {
-		const r = e.attrs.get("r");
-		const n = r === void 0 ? currentRow + 1 : /^[0-9]{1,7}$/.test(r.trim()) ? Number(r.trim()) : NaN;
-		if (!Number.isInteger(n) || n < 1 || n > 1048576) invalidRef(r ?? String(n));
-		currentRow = n;
-		current = {
-			number: n,
-			hasR: r !== void 0,
-			element: e,
-			cells: []
-		};
-		rows.push(current);
-		lastCol = 0;
-	} else if (e.depth === 4 && e.local === "c" && current) {
-		const r = e.attrs.get("r");
-		const address = r === void 0 || r === "" ? null : parseCellRef(r);
-		if (r !== void 0 && r !== "" && address === null) invalidRef(r);
-		const col = address?.col ?? lastCol + 1;
-		lastCol = col;
-		lastCell = {
-			col,
-			hasR: r !== void 0 && r !== "",
-			element: e,
-			f: null
-		};
-		current.cells.push(lastCell);
-	} else if (e.depth === 5 && e.local === "f" && lastCell && current) {
-		lastCell.f = e;
-		hasFormulas = true;
-		formulas.push({
-			cell: lastCell,
-			row: current
-		});
-	} else if (e.depth === 4 && (e.local === "formula" || e.local === "formula1" || e.local === "formula2")) {
-		const raw = content(text, e);
-		const out = adjustText(raw, c, sheet.name);
-		if (out === null) throw notSupported(`A ${e.local === "formula" ? "conditional format" : "data validation"} formula of sheet "${sheet.name}" cannot be adjusted safely: "${decodeEntities(raw).slice(0, 60)}".`, where(), { formula: decodeEntities(raw).slice(0, 80) });
-		if (out !== raw) edits.push([
-			e.start.end,
-			e.end.start,
-			out
-		]);
-	} else if (e.depth === 3 && e.local === "hyperlink") {
-		const location = e.attrs.get("location");
-		let tag = tagOf(e);
-		if (location !== void 0) {
-			const out = adjustFormula(location, refChange(c, sheet.name));
-			if (out !== null && out !== location) tag = setAttr(tag, "location", out);
-		}
-		if (target) {
-			const ref = adjustRange(e.attrs.get("ref") ?? "", refChange(c, sheet.name));
-			if (ref === "") {
-				removeElement(e);
-				continue;
+	let extension = null;
+	for (const e of elements) {
+		if (e.depth === 3 && e.local === "ext") extension = knownExts.has(e) ? e : null;
+		if (e.depth === 3 && e.local === "row") {
+			const r = e.attrs.get("r");
+			const n = r === void 0 ? currentRow + 1 : /^[0-9]{1,7}$/.test(r.trim()) ? Number(r.trim()) : NaN;
+			if (!Number.isInteger(n) || n < 1 || n > 1048576) invalidRef(r ?? String(n));
+			currentRow = n;
+			current = {
+				number: n,
+				hasR: r !== void 0,
+				element: e,
+				cells: []
+			};
+			rows.push(current);
+			lastCol = 0;
+		} else if (e.depth === 4 && e.local === "c" && current) {
+			const r = e.attrs.get("r");
+			const address = r === void 0 || r === "" ? null : parseCellRef(r);
+			if (r !== void 0 && r !== "" && address === null) invalidRef(r);
+			const col = address?.col ?? lastCol + 1;
+			lastCol = col;
+			lastCell = {
+				col,
+				hasR: r !== void 0 && r !== "",
+				element: e,
+				f: null
+			};
+			current.cells.push(lastCell);
+		} else if (e.depth === 5 && e.local === "f" && lastCell && current) {
+			lastCell.f = e;
+			hasFormulas = true;
+			formulas.push({
+				cell: lastCell,
+				row: current
+			});
+		} else if (e.depth === 4 && (e.local === "formula" || e.local === "formula1" || e.local === "formula2")) {
+			const raw = content(text, e);
+			const out = adjustText(raw, c, sheet.name);
+			if (out === null) throw notSupported(`A ${e.local === "formula" ? "conditional format" : "data validation"} formula of sheet "${sheet.name}" cannot be adjusted safely: "${decodeEntities(raw).slice(0, 60)}".`, where(), { formula: decodeEntities(raw).slice(0, 80) });
+			if (out !== raw) edits.push([
+				e.start.end,
+				e.end.start,
+				out
+			]);
+		} else if (e.depth === 5 && e.local === "cfvo") {
+			const val = e.attrs.get("val");
+			if (val === void 0) continue;
+			const out = adjustDecoded(val, c, sheet.name);
+			if (out === null) throw notSupported(`A conditional format threshold of sheet "${sheet.name}" cannot be adjusted safely: "${val.slice(0, 60)}".`, where(), { formula: val.slice(0, 80) });
+			if (out !== val) replaceTag(e, setAttr(tagOf(e), "val", out));
+		} else if (e.ns === "http://schemas.microsoft.com/office/excel/2006/main" && e.local === "f" && extension !== null && within(extension, e)) {
+			const raw = content(text, e);
+			const out = adjustText(raw, c, sheet.name);
+			if (out === null) throw notSupported(`A ${(extension.attrs.get("uri") ?? "").toLowerCase() === "{CCE6A557-97BC-4B89-ADB6-D9C93CAAB3DF}".toLowerCase() ? "data validation" : "conditional format"} formula of sheet "${sheet.name}" cannot be adjusted safely: "${decodeEntities(raw).slice(0, 60)}".`, where(), { formula: decodeEntities(raw).slice(0, 80) });
+			if (out !== raw) edits.push([
+				e.start.end,
+				e.end.start,
+				out
+			]);
+		} else if (e.depth === 3 && e.local === "hyperlink") {
+			const location = e.attrs.get("location");
+			let tag = tagOf(e);
+			if (location !== void 0) {
+				const out = adjustFormula(location, refChange(c, sheet.name));
+				if (out !== null && out !== location) tag = setAttr(tag, "location", out);
 			}
-			if (ref !== null && ref !== e.attrs.get("ref")) tag = setAttr(tag, "ref", ref);
+			if (target) {
+				const ref = adjustRange(e.attrs.get("ref") ?? "", refChange(c, sheet.name));
+				if (ref === "") {
+					removeElement(e);
+					continue;
+				}
+				if (ref !== null && ref !== e.attrs.get("ref")) tag = setAttr(tag, "ref", ref);
+			}
+			if (tag !== tagOf(e)) replaceTag(e, tag);
 		}
-		if (tag !== tagOf(e)) replaceTag(e, tag);
 	}
 	const masters = /* @__PURE__ */ new Map();
 	for (const { cell, row } of formulas) {
@@ -2917,6 +2969,15 @@ function rewriteSheet(text, part, sheet, c, target, style, limits) {
 			}
 		}
 	}
+	const removedIds = /* @__PURE__ */ new Set();
+	const linkIds = /* @__PURE__ */ new Map();
+	let format = null;
+	for (const e of elements) if (e.depth === 2) format = e.local === "conditionalFormatting" ? e : null;
+	else if (format !== null && e.depth === 6 && e.ns === "http://schemas.microsoft.com/office/spreadsheetml/2009/9/main" && e.local === "id") {
+		const list = linkIds.get(format) ?? [];
+		list.push(content(text, e).trim().toLowerCase());
+		linkIds.set(format, list);
+	}
 	const containers = /* @__PURE__ */ new Map();
 	let parent2 = null;
 	for (const e of elements) {
@@ -2934,8 +2995,10 @@ function rewriteSheet(text, part, sheet, c, target, style, limits) {
 				const sqref = e.attrs.get("sqref") ?? "";
 				const out = adjustRange(sqref, refChange(c, sheet.name));
 				if (out === null) throw notSupported(`A conditional format of sheet "${sheet.name}" has a range xlvane cannot adjust: "${sqref.slice(0, 60)}".`, where());
-				if (out === "") removeElement(e);
-				else if (out !== sqref) replaceTag(e, setAttr(tagOf(e), "sqref", out));
+				if (out === "") {
+					removeElement(e);
+					for (const id of linkIds.get(e) ?? []) removedIds.add(id);
+				} else if (out !== sqref) replaceTag(e, setAttr(tagOf(e), "sqref", out));
 			}
 			continue;
 		}
@@ -3007,6 +3070,7 @@ function rewriteSheet(text, part, sheet, c, target, style, limits) {
 			if (tag !== tagOf(container)) replaceTag(container, tag);
 		}
 	}
+	rewriteExtensionRanges(text, elements, knownExts, c, sheet, removedIds, edits, where);
 	const result = applyEdits(text, edits);
 	return {
 		text: /sortState/.test(result) ? rewriteSortStates(result, part, sheet, c, limits) : result,
@@ -3014,6 +3078,90 @@ function rewriteSheet(text, part, sheet, c, target, style, limits) {
 	};
 }
 /**
+* Moves the ranges (`xm:sqref`) of the extension conditional formats and data validations of the
+* changed sheet (SR-40, SR-44; R-20; D-F04). An item whose cells are all deleted is removed, as is
+* an extension rule linked to a removed classic rule (SR-41); emptied containers, `ext` and
+* `extLst` elements are removed, and `x14:dataValidations@count` is updated.
+*/
+function rewriteExtensionRanges(text, elements, knownExts, c, sheet, removedIds, edits, where) {
+	const roots = [];
+	const stack = [];
+	for (const e of elements) {
+		if (!(e.depth === 2 && e.local === "extLst" || e.depth === 3 && e.local === "ext" || e.ns === "http://schemas.microsoft.com/office/spreadsheetml/2009/9/main" && e.depth >= 4 && e.depth <= 6 || e.ns === "http://schemas.microsoft.com/office/excel/2006/main" && e.depth === 6 && e.local === "sqref")) continue;
+		while (stack.length > 0 && !within(stack[stack.length - 1].e, e)) stack.pop();
+		const node = {
+			e,
+			children: []
+		};
+		(stack.length > 0 ? stack[stack.length - 1].children : roots).push(node);
+		stack.push(node);
+	}
+	const tagOf = (e) => text.slice(e.start.start, e.start.end);
+	const remove = (e) => {
+		edits.push([
+			e.start.start,
+			e.end.end,
+			""
+		]);
+	};
+	for (const list of roots) {
+		if (list.e.local !== "extLst") continue;
+		let extsKept = 0;
+		for (const ext of list.children) {
+			if (ext.e.local !== "ext" || !knownExts.has(ext.e)) {
+				extsKept++;
+				continue;
+			}
+			let containersKept = 0;
+			let containersTotal = 0;
+			for (const container of ext.children) {
+				if (container.e.depth !== 4 || container.e.ns !== "http://schemas.microsoft.com/office/spreadsheetml/2009/9/main") continue;
+				containersTotal++;
+				let kept = 0;
+				let total = 0;
+				for (const item of container.children) {
+					if (item.e.depth !== 5 || item.e.ns !== "http://schemas.microsoft.com/office/spreadsheetml/2009/9/main") continue;
+					total++;
+					let gone = false;
+					const sqref = item.children.find((n) => n.e.ns === "http://schemas.microsoft.com/office/excel/2006/main" && n.e.local === "sqref")?.e;
+					if (sqref) {
+						const normal = decodeEntities(content(text, sqref)).trim().split(/\s+/).join(" ");
+						const out = normal === "" ? "" : adjustRange(normal, refChange(c, sheet.name));
+						if (out === null) throw notSupported(`An extension ${item.e.local === "dataValidation" ? "data validation" : "conditional format"} of sheet "${sheet.name}" has a range xlvane cannot adjust: "${normal.slice(0, 60)}".`, where());
+						if (out === "" && normal !== "") gone = true;
+						else if (out !== normal) edits.push([
+							sqref.start.end,
+							sqref.end.start,
+							escapeText(out)
+						]);
+					}
+					if (!gone && removedIds.size > 0) {
+						const rules = item.children.filter((n) => n.e.ns === "http://schemas.microsoft.com/office/spreadsheetml/2009/9/main" && n.e.local === "cfRule").map((n) => n.e);
+						const linked = rules.filter((r) => removedIds.has((r.attrs.get("id") ?? "").trim().toLowerCase()));
+						if (linked.length > 0 && linked.length === rules.length) gone = true;
+						else for (const r of linked) remove(r);
+					}
+					if (gone) remove(item.e);
+					else kept++;
+				}
+				if (kept === 0 && total > 0) {
+					remove(container.e);
+					continue;
+				}
+				containersKept++;
+				if (kept < total && container.e.attrs.has("count")) edits.push([
+					container.e.start.start,
+					container.e.start.end,
+					setAttr(tagOf(container.e), "count", String(kept))
+				]);
+			}
+			if (containersTotal > 0 && containersKept === 0) remove(ext.e);
+			else extsKept++;
+		}
+		if (list.children.length > 0 && extsKept === 0) remove(list.e);
+	}
+}
+/**
 * Moves the sort ranges of the changed sheet (`sortState` at sheet level or inside `autoFilter`,
 * and their `sortCondition`s) as ranges move (D-B01). A sort range that is deleted entirely is
 * removed; one that cannot be adjusted is refused. Runs on the text after the other edits, so
@@ -3449,15 +3597,14 @@ function changeRows(input, sheetName, at, count, style, limits) {
 * Inserts empty rows into a sheet of an existing XLSX file and returns the new file. Rows below
 * move down, and every reference follows them as in a spreadsheet application: formulas on all
 * sheets (ranges that the new rows fall into grow), merged cells, hyperlinks, notes, the
-* autofilter, conditional formats, data validation, page breaks, defined names, tables (which
-* grow when rows are inserted inside them) and pictures placed on the sheet. Every other part of
-* the file stays exactly as it was.
+* autofilter, conditional formats (also those of the [MS-XLSX] extension, and thresholds that
+* refer to cells), data validation (also of the extension), page breaks, defined names, tables
+* (which grow when rows are inserted inside them) and pictures placed on the sheet. Every other
+* part of the file stays exactly as it was.
 *
 * Refused with `XLV_E_NOT_SUPPORTED`, leaving the file unchanged: a drawing that holds charts,
 * shapes or anything besides pictures; embedded objects, form controls, scenarios, cell watches,
-* custom sheet views, extended content that refers to cells (data bars, sparklines, slicers -
-* including the extended data bar settings and the icon sets `3Stars`, `3Triangles`, `5Boxes`, `NoIcons`
-* that xlvane itself writes) and
+* custom sheet views, other extended content that refers to cells (sparklines, slicers) and
 * other related parts xlvane does not know; charts or pivot tables anywhere in the workbook that
 * may refer to the sheet; data tables; an array formula the change would split; and formulas it
 * cannot rewrite safely (docs/facts/ref-adjust.md).

package/dist/{stream-write-CTgWff2P.js → stream-write-BKppyMz0.js}

@@ -1,4 +1,4 @@
-import { $ as nameTitles, $t as MAX_COLUMNS, A as limitExceeded, C as Bytes, Ct as normalizeTable, D as TAIL_BYTES, E as NotLoaded, F as validateLocalHeaders, Ft as resolveLimits, G as buildStyles, Gt as MediaParts, H as SheetRels, I as WarningCollector, J as createSharedStrings, Jt as metricsOf, K as cellXml, Kt as drawingParts, L as sheetNotFound, Lt as printNames, N as readCentralDirectory, O as checkSource$1, P as unsupported, Pt as DEFAULT_READ_LIMITS, Q as hyperlinksXml, R as createWorksheetParser, Rt as printXml, S as workbookPartsToLoad, Sn as XlvError, St as TABLE_CONTENT_TYPE, T as HEAD_BYTES, Tt as checkUniqueName, Ut as DRAWING_CONTENT_TYPE, Wt as IMAGE_CONTENT_TYPES, Yt as resolveImage, Zt as classifyRelationship, _ as isoDate, a as DATE_FORMAT, at as sheetRelsPartName, cn as appPropertiesXml, d as convertCellInput, dt as workbookRelsXml, en as MAX_ROWS, et as noteParts, f as createWorkbook, ft as workbookXml, h as detectHeader, ht as crc32, i as readOptions, it as sheetHead, j as locateCentralDirectory, jt as normalizeStyle, k as corrupt, ln as corePropertiesXml, lt as tableParts, n as oneOfOption, nn as formatCellRef, nt as rootRelsXml, o as DATE_TIME_FORMAT, on as APP_PROPERTIES_PART, ot as sheetRulesXml, p as sortedNotes, pn as createXmlByteStreamParser, pt as FormulaGroups, q as contentTypesXml, rt as rowStart, sn as CORE_PROPERTIES_PART, st as sheetTail, tn as columnLetters, u as checkBookViews, v as analyzeWorkbook, vt as openPackage, w as CORRUPT_HINT, wt as checkDefinedName, y as readNotes, zt as sheetProtectionXml } from "./options-B7UhudO_.js";
+import { $t as resolveImage, A as limitExceeded, C as Bytes, D as TAIL_BYTES, Dt as normalizeTable, E as NotLoaded, En as XlvError, Et as TABLE_CONTENT_TYPE, F as validateLocalHeaders, Ft as normalizeStyle, Ht as printXml, I as WarningCollector, Jt as IMAGE_CONTENT_TYPES, K as SheetRels, L as sheetNotFound, N as readCentralDirectory, O as checkSource$1, Ot as checkDefinedName, P as unsupported, Q as createSharedStrings, Qt as metricsOf, R as createWorksheetParser, Rt as DEFAULT_READ_LIMITS, S as workbookPartsToLoad, St as openPackage, T as HEAD_BYTES, Ut as sheetProtectionXml, Vt as printNames, X as cellXml, Xt as drawingParts, Y as buildStyles, Yt as MediaParts, Z as contentTypesXml, _ as isoDate, _n as createXmlByteStreamParser, _t as FormulaGroups, a as DATE_FORMAT, an as columnLetters, ct as sheetHead, d as convertCellInput, dn as CORE_PROPERTIES_PART, dt as sheetTail, f as createWorkbook, fn as appPropertiesXml, gt as workbookXml, h as detectHeader, ht as workbookRelsXml, i as readOptions, in as MAX_ROWS, it as noteParts, j as locateCentralDirectory, k as corrupt, kt as checkUniqueName, lt as sheetRelsPartName, n as oneOfOption, nt as hyperlinksXml, o as DATE_TIME_FORMAT, on as formatCellRef, ot as rootRelsXml, p as sortedNotes, pn as corePropertiesXml, pt as tableParts, qt as DRAWING_CONTENT_TYPE, rn as MAX_COLUMNS, rt as nameTitles, st as rowStart, tn as classifyRelationship, u as checkBookViews, un as APP_PROPERTIES_PART, ut as sheetRulesXml, v as analyzeWorkbook, w as CORRUPT_HINT, y as readNotes, yt as crc32, zt as resolveLimits } from "./options-CwSp2pA4.js";
 import { Deflate, Inflate } from "fflate";
 // src/zip/stream.ts
 /**
@@ -571,6 +571,7 @@ async function openWorkbookStream(source, options) {
 		sheets: info.sheets.map((s) => ({
 			name: s.name,
 			index: s.index,
+			sheetId: s.sheetId,
 			kind: s.kind,
 			state: s.state
 		})),
@@ -850,6 +851,7 @@ function writeWorkbookStream(options) {
 		const s = readOptions(raw, [
 			"name",
 			"state",
+			"sheetId",
 			"columns",
 			"freeze",
 			"tabColor",
@@ -872,7 +874,11 @@ function writeWorkbookStream(options) {
 			"rows"
 		], `sheets[${String(i)}]`);
 		const state = s.get("state");
-		const sheet = book.addSheet(s.get("name"), state === void 0 ? void 0 : { state });
+		const sheetId = s.get("sheetId");
+		const sheet = book.addSheet(s.get("name"), {
+			...state === void 0 ? {} : { state },
+			...sheetId === void 0 ? {} : { sheetId }
+		});
 		const columns = s.get("columns");
 		if (columns !== void 0) {
 			if (!Array.isArray(columns)) throw new XlvError("XLV_E_INVALID_OPTION", `sheets[${String(i)}].columns must be an array.`, {
@@ -1188,6 +1194,7 @@ function writeWorkbookStream(options) {
 			data: encoder.encode(workbookXml(prepared.map((p) => ({
 				name: p.sheet.name,
 				state: p.sheet.state,
+				sheetId: p.sheet.sheetId,
 				autoFilter: p.filterRange
 			})), book.dateSystem, allNames(), book.workbookProtection, {
 				bookViews: book.bookViews,

package/dist/{stream-write-Q-sef804.d.ts → stream-write-GJXORYQ2.d.ts}

@@ -2413,13 +2413,19 @@ type SheetLayout = "normal" | "pageBreakPreview" | "pageLayout";
  * ```ts
  * import type { SplitPanes } from 'xlvane';
  *
- * const split: SplitPanes = { x: 120, y: 60 };
- * console.log(split.x);
+ * const split: SplitPanes = { x: 120, y: 60, topLeftCell: 'H20' };
+ * console.log(split.x, split.topLeftCell);
  * ```
  */
 interface SplitPanes {
   readonly x: number;
   readonly y: number;
+  /**
+   * The top-left visible cell of the bottom-right pane (`pane@topLeftCell`): its column is the
+   * first one shown right of the vertical bar, its row the first one shown below the horizontal
+   * bar. Absent when the file does not set it.
+   */
+  readonly topLeftCell?: string;
 }
 /**
  * Display settings of a sheet's view (`sheetView`, ECMA-376 Part 1 §18.3.1.87, W2-51). Frozen
@@ -2580,6 +2586,12 @@ interface Sheet {
   readonly name: string;
   /** 0-based position in the workbook. */
   readonly index: number;
+  /**
+   * The sheet's id in the file (`sheet@sheetId`), which does not depend on its position; `null`
+   * when the file has none, an invalid one or one repeated from an earlier sheet (reported as
+   * `XLV_W_INVALID_VALUE`).
+   */
+  readonly sheetId: number | null;
   readonly kind: SheetKind;
   readonly state: SheetState;
   /** Part name of the sheet, for example `/xl/worksheets/sheet1.xml`; `null` if it is missing. */
@@ -2943,6 +2955,8 @@ interface InspectColumn {
 interface InspectSheet {
   readonly name: string;
   readonly index: number;
+  /** The sheet's id in the file (`Sheet.sheetId`), or `null` when it is missing, invalid or repeated. */
+  readonly sheetId: number | null;
   readonly kind: SheetKind;
   readonly state: SheetState;
   /** Range declared in the file, or `null`. */
@@ -3091,6 +3105,8 @@ declare function inspect(input: Uint8Array | ArrayBuffer | Workbook, options?: I
 interface WriteSheetData {
   readonly name: string;
   readonly state: SheetState;
+  /** The given sheet id, or `null` for the lowest unused one (D-F03). */
+  readonly sheetId?: number | null;
   readonly cells: ReadonlyMap<number, ReadonlyMap<number, StoredCell>>;
   /** Width, visibility and interned style id (0 = none) by column number. */
   readonly columns: ReadonlyMap<number, {
@@ -3228,13 +3244,19 @@ interface CreateWorkbookOptions {
  * ```ts
  * import { createWorkbook, type AddSheetOptions } from 'xlvane';
  *
- * const options: AddSheetOptions = { state: 'hidden' };
+ * const options: AddSheetOptions = { state: 'hidden', sheetId: 3 };
  * createWorkbook().addSheet('Lookup', options);
  * ```
  */
 interface AddSheetOptions {
   /** Visibility. Default `"visible"`. */
   readonly state?: SheetState;
+  /**
+   * The sheet's id in the file (`sheet@sheetId`), a whole number from 1 to 65534, unique in the
+   * workbook. It does not change the sheet's position. Sheets without one get the lowest unused
+   * ids when the workbook is written, so a workbook without given ids has the ids 1, 2, 3, ….
+   */
+  readonly sheetId?: number;
 }
 /**
  * Options for {@link NewSheet.column}.
@@ -3423,8 +3445,10 @@ interface SheetViewOptions {
   readonly layout?: SheetLayout;
   /**
    * Splits the window (without freezing) at `x` points from the left and `y` points from the
-   * top; a missing one is 0, but not both. `null` removes the split. A split replaces frozen
-   * panes, and {@link NewSheet.freeze} replaces a split.
+   * top; a missing one is 0, but not both. `topLeftCell` (optional) is the top-left visible cell
+   * of the bottom-right pane: the first column shown right of the vertical bar and the first row
+   * below the horizontal bar. `null` removes the split. A split replaces frozen panes, and
+   * {@link NewSheet.freeze} replaces a split.
    */
   readonly split?: Partial<SplitPanes> | null;
   /** The top-left visible cell (`sheetView@topLeftCell`), e.g. `"C10"`; `null` for the default. */
@@ -3506,6 +3530,8 @@ declare class NewSheet {
   private readonly book;
   /** Visibility of the sheet. */
   readonly state: SheetState;
+  /** The id given to {@link NewWorkbook.addSheet}, or `null` when the lowest unused id is taken when writing. */
+  readonly sheetId: number | null;
   /** @internal */
   readonly cellMap: Map<number, Map<number, StoredCell>>;
   /** @internal */
@@ -3564,7 +3590,7 @@ declare class NewSheet {
   readonly tableList: NormalizedTable[];
   private count;
   /** @internal Use {@link NewWorkbook.addSheet}. */
-  constructor(name: string, state: SheetState, book: NewWorkbook);
+  constructor(name: string, state: SheetState, book: NewWorkbook, sheetId?: number | null);
   /** Number of cells that have a value or a style. */
   get cellCount(): number;
   private address;
@@ -4006,7 +4032,7 @@ declare class NewWorkbook {
    *
    * const workbook = createWorkbook();
    * workbook.addSheet('Data');
-   * workbook.addSheet('Lookup', { state: 'hidden' });
+   * workbook.addSheet('Lookup', { state: 'hidden', sheetId: 5 });
    * ```
    */
   addSheet(name: string, options?: AddSheetOptions): NewSheet;
@@ -4549,6 +4575,8 @@ interface StreamRow {
 interface StreamSheetInfo {
   readonly name: string;
   readonly index: number;
+  /** `sheet@sheetId`, as `Sheet.sheetId`. */
+  readonly sheetId: number | null;
   readonly kind: SheetKind;
   readonly state: SheetState;
 }
@@ -4753,6 +4781,8 @@ type StreamRowInput = readonly CellInput[] | {
 interface StreamSheetSpec {
   readonly name: string;
   readonly state?: SheetState;
+  /** The sheet's id in the file, as for `addSheet` (1 to 65534, unique; D-F03). */
+  readonly sheetId?: number;
   /** Column options by position (column A first); `undefined` entries keep the default. */
   readonly columns?: readonly (ColumnOptions | undefined)[];
   readonly freeze?: FreezeOptions;

package/docs/cli-json/inspect.schema.json

@@ -104,6 +104,13 @@
                     "type": "integer",
                     "minimum": 0
                   },
+                  "sheetId": {
+                    "type": [
+                      "integer",
+                      "null"
+                    ],
+                    "minimum": 0
+                  },
                   "kind": {
                     "enum": [
                       "worksheet",
@@ -454,6 +461,7 @@
                 "required": [
                   "name",
                   "index",
+                  "sheetId",
                   "kind",
                   "state",
                   "dimension",

package/docs/errors.md

@@ -255,7 +255,7 @@ The CSV text given to `fromCSV` has a quoted field that is never closed, text ri
 `hashPassword` and `verifyPassword` throw it for a hash algorithm other than SHA-1, SHA-256, SHA-384 and SHA-512, and `hashPassword` without a `salt` throws it in a runtime that has no `crypto.getRandomValues` (pass your own random salt there; SR-50, D-C08).
 `editCells` throws it for an array or shared formula in an edit (it writes plain formulas only), and for a cell inside an array formula's range or the master of a shared formula with other cells in its range (D-E02); `details.cell` names it.
 `appendRows` throws it when a table ends with a totals row on the sheet's last used row (the new rows would fall below the totals row; the hint gives the `insertRows` call that grows the table instead), or when growing a table for the new rows would overlap another table (D-R03).
-`insertRows` and `deleteRows` (and `xlvane edit --insert-rows` / `--delete-rows`) also throw it when the sheet has content whose cell references xlvane cannot move yet: tables, charts, shapes and other drawing objects (pictures alone are moved, and deleting rows that would cut a picture is refused), pivot tables, form controls, embedded objects, custom sheet views, threaded comments, extended content such as data bars or sparklines, a chart or pivot cache elsewhere that names the sheet, a data table, an array formula the change would split, or a formula or defined name that cannot be adjusted safely (for example a 3-D reference such as `Jan:Mar!A1` that includes the sheet, D-B01). The message names the part or the cell, and `details` gives the element, relationship type or formula.
+`insertRows` and `deleteRows` (and `xlvane edit --insert-rows` / `--delete-rows`) also throw it when the sheet has content whose cell references xlvane cannot move yet: tables, charts, shapes and other drawing objects (pictures alone are moved, and deleting rows that would cut a picture is refused), pivot tables, form controls, embedded objects, custom sheet views, threaded comments, extended content such as sparklines or slicers (the conditional formats and data validations of the [MS-XLSX] extension are moved, D-F04), a chart or pivot cache elsewhere that names the sheet, a data table, an array formula the change would split, or a formula or defined name that cannot be adjusted safely (for example a 3-D reference such as `Jan:Mar!A1` that includes the sheet, D-B01). The message names the part or the cell, and `details` gives the element, relationship type or formula.
 **Fix:** for `@xlvane/compat`, see docs/exceljs-compat.md for the supported subset; remove the call, or keep using exceljs for files that need the feature.
 For `insertRows`/`deleteRows`, insert or delete the rows in a spreadsheet application, or remove the named content first.