@sheetxl/query 0.7.23-beta.1

package/browser/esm/index.mjs

@@ -0,0 +1,1994 @@
+/**
+* @license @sheetxl/query - SheetXL - Workbook read surface and renderers (grep, reports) — capabilities declared once, adapted by any host surface - v0.7.23-beta.1
+*
+* (C) 2026-present SheetXL Inc. & Michael T. Ford
+* License: The license can be found at https://www.sheetxl.com/license.
+*/
+import { AddressUtils as e, FormulaError as t, IAnchored as n, ICellRange as r, ICondition as i, IConditionalFormat as a, IDataValidation as o, IFill as s, IFont as c, ISheet as l, InteropScalarType as u, NumberFormat as d, ScalarType as f } from "@sheetxl/sdk";
+var p;
+(p ||= {}).Mode = {
+	Display: "display",
+	Value: "value"
+};
+function m(e) {
+	return Number.isFinite(e) ? function(e) {
+		let t = e.indexOf("e");
+		if (t === -1) return e;
+		let n = e.substring(t + 2);
+		return `${e.substring(0, t)}E${e[t + 1]}${n.length < 2 ? "0" + n : n}`;
+	}(String(Number(e.toPrecision(15)))) : String(e);
+}
+function h(e, t) {
+	if (!Number.isFinite(e)) return String(e);
+	if (!t || t === "General") return m(e);
+	try {
+		let n = d.getEngine().format(t, e)?.text;
+		return n ? n.trim() : m(e);
+	} catch {
+		return m(e);
+	}
+}
+function g(e, t) {
+	let n = t === p.Mode.Value, r = e.getText({
+		hideStringPrefix: !0,
+		useFormattingCategory: n
+	});
+	return r ? {
+		match: r,
+		display: e.getText({ useFormattingCategory: n })
+	} : null;
+}
+function _(e) {
+	if (e == null) return null;
+	if (typeof e == "string") return {
+		match: e,
+		display: `'${e}`
+	};
+	if (typeof e == "boolean") {
+		let t = e ? "TRUE" : "FALSE";
+		return {
+			match: t,
+			display: t
+		};
+	}
+	if (typeof e == "number") {
+		let t = m(e);
+		return {
+			match: t,
+			display: t
+		};
+	}
+	if (t.isError(e)) {
+		let t = e.getLabel();
+		return {
+			match: t,
+			display: t
+		};
+	}
+	let n = e.toString();
+	return {
+		match: n,
+		display: n
+	};
+}
+var v = {
+	Display: "display",
+	Value: "value",
+	Raw: "raw",
+	Formula: "formula",
+	Hyperlink: "hyperlink",
+	NumberFormat: "numberFormat"
+}, y = [
+	"display",
+	"value",
+	"raw",
+	"formula",
+	"hyperlink",
+	"numberFormat"
+], b = [
+	"display",
+	"value",
+	"formula"
+], x = (e) => e.getVisibility() === "visible", ee = (e, t, n) => {
+	let r = e.getSheets().getItems({ visibility: "veryHidden" }), i = t?.trim();
+	if (!i) return r.filter((e) => n || x(e)).map((e) => ({
+		sheet: e,
+		address: null
+	}));
+	let a = /^'(.*)'!(.+)$/.exec(i) ?? /^([^!]+)!(.+)$/.exec(i);
+	if (a) {
+		let [, e, t] = a, n = r.find((t) => t.getName() === e);
+		if (!n) throw Error(`Sheet not found: ${e}`);
+		return [{
+			sheet: n,
+			address: t
+		}];
+	}
+	let o = r.find((e) => e.getName() === i);
+	if (o) return [{
+		sheet: o,
+		address: null
+	}];
+	if (/[*?]/.test(i)) {
+		let e = ((e) => {
+			let t = e.replace(/[.*+?^${}()|[\]\\]/g, (e) => e === "*" ? ".*" : e === "?" ? "." : `\\${e}`);
+			return RegExp(`^${t}$`);
+		})(i), t = r.filter((t) => e.test(t.getName()) && (n || x(t)));
+		if (t.length === 0) throw Error(`No sheets match ${JSON.stringify(i)}. Sheets: ${r.map((e) => e.getName()).join(", ")}`);
+		return t.map((e) => ({
+			sheet: e,
+			address: null
+		}));
+	}
+	let s = r.filter((e) => n || x(e));
+	try {
+		s[0]?.getRange(i);
+	} catch {
+		throw Error(`Unknown scope ${JSON.stringify(i)}: not a sheet name or a range. Sheets: ${r.map((e) => e.getName()).join(", ")}`);
+	}
+	return s.map((e) => ({
+		sheet: e,
+		address: i
+	}));
+}, te = (e, t) => {
+	switch (t) {
+		case "display": return g(e, p.Mode.Display);
+		case "value": return g(e, p.Mode.Value);
+		case "raw": return _(e.getValue());
+		case "formula": {
+			let t = e.getFormulaText();
+			return t ? {
+				match: `=${t}`,
+				display: `=${t}`
+			} : null;
+		}
+		case "hyperlink": {
+			let t = e.getHyperlink()?.getAddress() ?? null;
+			return t ? {
+				match: t,
+				display: t
+			} : null;
+		}
+		case "numberFormat": {
+			let t = e.getStyle().getNumberFormat();
+			return t && t !== "General" ? {
+				match: t,
+				display: t
+			} : null;
+		}
+		default: return null;
+	}
+}, ne = ["hyperlink", "numberFormat"], S = (e, t, n) => {
+	let r = null, i = (e) => ({
+		range: `${t}!${e.getRange().toString()}`,
+		table: e.getName()
+	});
+	return { resolve(a, o) {
+		let s = ((e) => e.getTable())(a);
+		if (e === "table") return s ? i(s) : void 0;
+		if (r === null) {
+			r = [];
+			for (let e of n.getRegions()) {
+				let n = e.getCoords();
+				n.rowStart === n.rowEnd && n.colStart === n.colEnd || r.push({
+					coords: n,
+					address: `${t}!${e.toString()}`
+				});
+			}
+		}
+		let c = r.find(({ coords: e }) => o.rowIndex >= e.rowStart && o.rowIndex <= e.rowEnd && o.colIndex >= e.colStart && o.colIndex <= e.colEnd);
+		return c ? {
+			range: c.address,
+			...s ? { table: s.getName() } : {}
+		} : s ? i(s) : void 0;
+	} };
+};
+async function C(e, t) {
+	if (!t.pattern) throw Error("grep requires a pattern");
+	let n = t.fields?.length ? t.fields : b, r = t.output ?? "content", i = t.maxCount ?? 200, a = !0 === t.invert, o = !0 === t.hidden, s = ((e) => {
+		if (e === void 0 || !1 === e) return null;
+		if (!0 === e) return "contentful";
+		if (e === "contentful" || e === "table") return e;
+		throw Error(`Invalid context ${JSON.stringify(e)}: expected 'contentful' or 'table'. Context is the enclosing block, not a line count — a grid has no ±N lines.`);
+	})(t.context), c = ((e) => {
+		let t = e.fixedStrings ? ((e) => e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"))(e.pattern) : e.pattern;
+		e.word && (t = `(?<!\\w)(?:${t})(?!\\w)`);
+		let n = e.ignoreCase ? "iu" : "u";
+		try {
+			return new RegExp(t, n);
+		} catch {
+			try {
+				return new RegExp(t, n.replace("u", ""));
+			} catch (t) {
+				throw Error(`Invalid regex ${JSON.stringify(e.pattern)}: ${t instanceof Error ? t.message : String(t)}. Use fixedStrings (-F) to search for the literal text.`);
+			}
+		}
+	})(t), l = ee(e, t.scope, o), u = !n.some((e) => ne.includes(e)), d = n.includes("display") && n.includes("value"), f = r === "content" || r === "addresses", p = [], m = [], h = 0, g = 0, _ = !1;
+	for (let { sheet: e, address: t } of l) {
+		if (_) continue;
+		let l = e.getName();
+		g++, await e.getCalculation().ready();
+		let v = t === null ? e.getUsedRange() : e.getRange(t);
+		if (!v) continue;
+		let y = s && r === "content" ? S(s, l, v) : null, b = 0;
+		v.forEach((e, t) => {
+			if (u && e == null) return;
+			let o = t.getCell(), s = [], m, g = null;
+			for (let e of n) {
+				let t = te(o, e);
+				if (e === "display" && (m = t?.match ?? null), t !== null && (e !== "value" || !d || (m === void 0 && (m = te(o, "display")?.match ?? null), t.match !== m)) && (g === null && (g = {
+					field: e,
+					text: t.display
+				}), c.test(t.match) && (s.push({
+					field: e,
+					text: t.display
+				}), r === "addresses" && !a))) break;
+			}
+			if (!(a ? s.length > 0 || g === null : s.length === 0)) {
+				if (i > 0 && h >= i) return _ = !0, { break: !0 };
+				if (h++, b++, f) {
+					let e = a ? [g] : r === "addresses" ? s.slice(0, 1) : s, n = y?.resolve(o, t.getCoords()), i = t.getAddress();
+					for (let t of e) p.push({
+						sheet: l,
+						address: i,
+						field: t.field,
+						text: t.text,
+						...n ? { context: n } : {}
+					});
+				}
+			}
+		}, o ? void 0 : { ignoreHidden: !0 }), b > 0 && m.push({
+			sheet: l,
+			cells: b
+		});
+	}
+	return {
+		pattern: t.pattern,
+		fields: n,
+		scope: t.scope?.trim() || "workbook",
+		matches: p,
+		cellCount: h,
+		sheets: m,
+		sheetsSearched: g,
+		sheetsMatched: m.length,
+		truncated: _,
+		output: r
+	};
+}
+var re = (e) => {
+	let t = e.replace(/\s+/g, " ").trim();
+	return t.length > 120 ? `${t.slice(0, 119)}…` : t;
+}, ie = (e, t, n, r) => {
+	let i = t.map((e) => r ? `${e.sheet}!${e.address}` : e.address), a = Math.max(...i.map((e) => e.length)), o = Math.max(...t.map((e) => e.field.length));
+	for (let r = 0; r < t.length; r++) {
+		let s = t[r];
+		e.push(`${n}${i[r].padEnd(a)}  ${s.field.padEnd(o)}  ${re(s.text)}`);
+	}
+};
+function w(e) {
+	let { pattern: t, fields: n, scope: r, matches: i, cellCount: a, sheetsSearched: o, sheetsMatched: s } = e, c = [`grep "${t}" · ${r} · fields ${n.join(",")} · ${a} ${a === 1 ? "cell" : "cells"} in ${s} of ${o} ${o === 1 ? "sheet" : "sheets"}`];
+	if (e.output === "count") for (let t of e.sheets) c.push(`  ${t.sheet}: ${t.cells}`);
+	else if (e.output === "sheets") {
+		for (let t of e.sheets) c.push(`  ${t.sheet}`);
+		e.sheets.length === 0 && c.push("  no matches");
+	} else if (i.length === 0) c.push("  no matches");
+	else if (e.output === "addresses") for (let e of i) c.push(`  ${e.sheet}!${e.address}`);
+	else {
+		let e = [], t = /* @__PURE__ */ new Map();
+		for (let n of i) {
+			let r = n.context?.range ?? "", i = t.get(r);
+			i || (i = {
+				key: r,
+				heading: n.context ? n.context.table ? `${n.context.range} · ${n.context.table}` : n.context.range : null,
+				rows: []
+			}, t.set(r, i), e.push(i)), i.rows.push(n);
+		}
+		for (let t of e) t.heading ? (c.push(`  ${t.heading}`), ie(c, t.rows, "    ", !1)) : ie(c, t.rows, "  ", !0);
+	}
+	return e.truncated && c.push(`  …truncated at ${a} ${a === 1 ? "cell" : "cells"} · narrow the pattern, or scope the search to one sheet or range`), c.join("\n");
+}
+var T = {
+	name: "grep",
+	description: "Search cell contents by pattern across a workbook. Returns grid-anchored matches, each tagged with the cell layer it matched. Selection by attribute (fills, formats, features) is the regions read, not grep.",
+	params: [
+		{
+			name: "pattern",
+			type: "string",
+			description: "The regular expression to search for (literal with fixedStrings).",
+			required: !0,
+			positional: 0
+		},
+		{
+			name: "fields",
+			type: "enum[]",
+			values: y,
+			defaultValue: b,
+			description: "Cell layers to search: display (number format applied), value (as the formula bar shows it; duplicate of display suppressed per cell), raw (the stored scalar — dates as serials), formula, hyperlink, numberFormat (the format code, e.g. \"0.00%\")."
+		},
+		{
+			name: "fixedStrings",
+			type: "boolean",
+			alias: "F",
+			defaultValue: !1,
+			description: "Treat the pattern as a literal string, not a regular expression."
+		},
+		{
+			name: "ignoreCase",
+			type: "boolean",
+			alias: "i",
+			defaultValue: !1,
+			description: "Case-insensitive matching."
+		},
+		{
+			name: "word",
+			type: "boolean",
+			alias: "w",
+			defaultValue: !1,
+			description: "Require the match to fall on word boundaries (text edges count as edges)."
+		},
+		{
+			name: "invert",
+			type: "boolean",
+			alias: "v",
+			defaultValue: !1,
+			description: "Report cells where no requested field matched. Only cells with text in a requested field are considered — blanks are not findings."
+		},
+		{
+			name: "scope",
+			type: "string",
+			description: "Where to search: a sheet name (globs allowed: \"Q*\"), a sheet-qualified range (Sheet1!A1:D9), or a bare range applied to every sheet. Defaults to every used range."
+		},
+		{
+			name: "hidden",
+			type: "boolean",
+			defaultValue: !1,
+			description: "Search hidden rows, columns and sheets, which are excluded by default. Naming a hidden sheet in scope always searches it."
+		},
+		{
+			name: "context",
+			type: "enum",
+			values: ["contentful", "table"],
+			alias: "C",
+			valueOptional: !0,
+			description: "Annotate and group matches by the block they sit in: contentful (the uniform data region; bare -C means this) or table (enclosing table only). Not a line count — a grid has no ±N lines."
+		},
+		{
+			name: "maxCount",
+			type: "number",
+			alias: "m",
+			defaultValue: 200,
+			description: "Stop after this many matching cells (0 = unlimited). Truncation is always reported, and only when a further match actually exists."
+		},
+		{
+			name: "output",
+			type: "enum",
+			values: [
+				"content",
+				"addresses",
+				"count",
+				"sheets"
+			],
+			defaultValue: "content",
+			description: "What to return: content (address, layer and text), addresses (one per matched cell), count (per sheet), or sheets (names with a match)."
+		}
+	],
+	run: C,
+	render: w
+}, E = (e, t) => e <= t + 3 ? e : t, D = (e) => {
+	if (!e) return null;
+	let t = String(e.toHex?.() ?? "");
+	if (!t) return e.toString();
+	let n = /^#FF/i.test(t) && t.length === 9 ? `#${t.slice(3)}` : t, r = e.toString();
+	if (!r) return n;
+	let i = r.toLowerCase().replace(/^#/, "");
+	return i === n.slice(1).toLowerCase() || i === t.slice(1).toLowerCase() ? n : `${n} (${r.replace(/\d+\.\d{4,}/g, (e) => String(parseFloat(Number(e).toFixed(2))))})`;
+}, ae = (e) => {
+	let t = e.getFill(), n = t.getType();
+	if (n === s.Type.None) return null;
+	if (n === s.Type.Pattern) {
+		let e = t, n = e.getPatternType();
+		if (n === s.BuiltInSheetPattern.None) return null;
+		let r = D(e.getForeground());
+		if (n === s.BuiltInSheetPattern.Solid) return r ? `solid ${r}` : "solid";
+		let i = D(e.getBackground());
+		return [
+			`${n} pattern`,
+			r,
+			i ? `on ${i}` : null
+		].filter(Boolean).join(" ");
+	}
+	let r = D(t.getColor?.());
+	return r ? `${n} ${r}` : n;
+}, oe = (e) => {
+	let t = ce(e);
+	return t.length > 0 ? t.join(" · ") : null;
+}, se = /* @__PURE__ */ new Set([
+	"top",
+	"left",
+	"bottom",
+	"right"
+]), ce = (e) => {
+	let t = e.getBorder(), n = [
+		["top", t.getTop()],
+		["left", t.getLeft()],
+		["bottom", t.getBottom()],
+		["right", t.getRight()],
+		["horizontal", t.getHorizontal()],
+		["vertical", t.getVertical()],
+		["diagonalUp", t.getDiagonalUp()],
+		["diagonalDown", t.getDiagonalDown()]
+	], r = /* @__PURE__ */ new Map();
+	for (let [e, t] of n) {
+		let n = t?.getStyle?.();
+		if (!n || n === "none") continue;
+		let i = D(t?.getColor?.()), a = i ? `${n} ${i}` : n, o = r.get(a);
+		o ? o.push(e) : r.set(a, [e]);
+	}
+	let i = [];
+	for (let [e, t] of r) {
+		let n = t.length === 4 && t.every((e) => se.has(e));
+		i.push(`${n ? "outline" : t.join("+")} ${e}`);
+	}
+	return i;
+}, le = (e) => {
+	let t = e.getNumberFormat();
+	return t && t !== "General" ? t : null;
+}, ue = (e, t) => {
+	let n = e.getAlignment(), r = t.getAlignment(), i = [];
+	return n.getHorizontal() !== r.getHorizontal() && i.push(`h ${n.getHorizontal()}`), n.getVertical() !== r.getVertical() && i.push(`v ${n.getVertical()}`), n.getOverflow() !== r.getOverflow() && i.push(n.getOverflow()), n.getIndent() !== r.getIndent() && i.push(`indent ${n.getIndent()}`), n.getRotation() !== r.getRotation() && i.push(`rotation ${n.getRotation()}`), i.length > 0 ? i.join(" · ") : null;
+}, de = (e, t) => {
+	let n = e.getFont(), r = t.getFont(), i = [];
+	n.getBold() !== r.getBold() && i.push(n.getBold() ? "bold" : "not bold"), n.getItalic() !== r.getItalic() && i.push(n.getItalic() ? "italic" : "not italic"), n.getUnderline() !== r.getUnderline() && i.push(`underline ${n.getUnderline()}`), n.getStrike() !== r.getStrike() && i.push(n.getStrike() ? "strike" : "not strike"), n.getSize() !== r.getSize() && i.push(`${n.getSize()}pt`), n.getFamily() !== r.getFamily() && i.push(n.getFamily());
+	let a = D(n.getColor());
+	return a !== D(r.getColor()) && i.push(a ?? "no color"), i.length > 0 ? i.join(" · ") : null;
+}, fe = (e, t) => e.length > t ? `${e.slice(0, t - 1)}…` : e, O = (e) => {
+	if (!e) return null;
+	if (typeof e != "string") return D(e);
+	let t = e.replace(/^#/, "");
+	return /^[0-9a-f]{6}$/i.test(t) || /^[0-9a-f]{8}$/i.test(t) ? `#${(t.length === 8 && /^ff/i.test(t) ? t.slice(2) : t).toUpperCase()}` : e;
+}, pe = (e) => {
+	if (!e) return null;
+	let t = [], n = ((e) => {
+		if (!e) return null;
+		if (typeof e == "string") return O(e);
+		let t = e.type;
+		if (t === s.Type.None) return null;
+		if (t === s.Type.Gradient) return "gradient";
+		let n = e, r = O(n.foreground ?? e.color ?? n.background), i = n.patternType;
+		return [i && i !== s.BuiltInSheetPattern.Solid ? `${i} pattern` : null, r].filter(Boolean).join(" ") || null;
+	})(e.fill);
+	n && t.push(`fill ${n}`);
+	let r = e.font;
+	if (r) {
+		let e = [];
+		(r.weight === void 0 ? !0 === r.bold : r.weight >= 600) && e.push("bold"), (r.style === void 0 ? !0 === r.italic : r.style === c.Style.Italic) && e.push("italic"), r.strike && e.push("strike"), r.underline && r.underline !== c.UnderlineStyle.None && e.push(`underline ${r.underline}`);
+		let n = r.color === "auto" ? null : O(r.color);
+		n && e.push(`text ${n}`), e.length > 0 && t.push(e.join(" "));
+	}
+	if (e.numberFormat !== void 0 && e.numberFormat !== null) {
+		let n = typeof e.numberFormat == "number" ? `numFmt ${e.numberFormat}` : String(e.numberFormat);
+		n && t.push(n);
+	}
+	return e.border && t.push("border"), e.alignment && t.push("alignment"), t.length > 0 ? t.join(" · ") : null;
+}, me = (e) => {
+	let t = e.type ?? a.ColorStopType.Num, n = e.value, r = n == null || n === "" ? t : `${t} ${n}`, i = O(e.color);
+	return i ? `${r} ${i}` : r;
+}, he = (e) => {
+	let t = e.type;
+	if (e.type === a.ScaleType.DataBar) {
+		let n = O(e.color);
+		n && (t += ` ${n}`);
+	} else e.type === a.ScaleType.IconSet && (e.iconSet && (t += ` ${e.iconSet}`), e.reverse && (t += " reversed"));
+	let n = (e.stops ?? []).map(me).join(" → ");
+	return n ? `${t} · ${n}` : t;
+}, ge = "(no rule)", k = (e) => {
+	let t = e.getScale(), n = [];
+	if (t) n.push(he(t));
+	else {
+		n.push(e.getCondition()?.toString() || ge);
+		let t = pe(e.getStyle());
+		t && n.push(`→ ${t}`);
+	}
+	return e.isStopIfTrue() && n.push("· stop if true"), fe(n.join(" "), 90);
+}, _e = (e) => {
+	let t = [e.getCondition()?.toString() || ge], n = e.getAlertStyle();
+	return n && t.push(n), e.isIncludeBlanks() && t.push("blanks allowed"), e.isHideDropdown() && t.push("no dropdown"), fe(t.join(" · "), 90);
+}, ve = (e) => {
+	if (e?.getOperator()?.getName() !== i.BuiltInOperatorNames.InSet) return null;
+	let t = e.getParam()?.items;
+	if (!t) return null;
+	if (typeof t == "string") return t;
+	let n = t.slice(0, 20).map((e) => _(e)?.match ?? ""), r = t.length - n.length;
+	return r > 0 ? `${n.join(", ")}, +${r} more` : n.join(", ");
+}, A = (e, t) => {
+	if (e.length === 0) return null;
+	let n = e.slice(0, 3).map(t), r = e.length - n.length;
+	return r > 0 ? `${n.join(" | ")} | +${r} more` : n.join(" | ");
+}, j = r.Feature;
+function M(e, t) {
+	let n = t?.maxSeries ?? 24, r = t?.maxProfileCells ?? 2e4, i = t?.maxCategories ?? 3, a = e.getRowCount(), o = e.getColumnCount();
+	if (a === 1 && o === 1) return {
+		shape: "cell",
+		summary: `cell · ${g(e.getCell(), p.Mode.Display)?.display ?? "(blank)"}`,
+		series: []
+	};
+	let s = e.getRange(), c = s.getCoords(), l = a >= o;
+	if (a === 1 || o === 1) return {
+		shape: "list",
+		summary: `list · ${xe(s, i)}`,
+		series: []
+	};
+	let u = function(e, t) {
+		let n = e.getRange(), r = n.getCoords(), i = e.getCell().getTable();
+		if (i) {
+			let e = i.getColumns().map((e) => e.getName());
+			return {
+				present: !0,
+				inside: !0,
+				note: `table "${i.getName()}"`,
+				names: t ? e : null
+			};
+		}
+		let a = t ? r.rowStart + 1 : r.colStart + 1, o = N(t ? n.getRangeAt(a, r.colStart, r.rowEnd, r.colEnd) : n.getRangeAt(r.rowStart, a, r.rowEnd, r.colEnd)), s = t ? n.getRangeAt(r.rowStart, r.colStart, r.rowStart, r.colEnd) : n.getRangeAt(r.rowStart, r.colStart, r.rowEnd, r.colStart);
+		if (N(s) && !o) return {
+			present: !0,
+			inside: !0,
+			note: "header " + (t ? `row ${r.rowStart + 1}` : `column ${we(r.colStart)}`),
+			names: ye(s, e, t)
+		};
+		let c = (t ? r.rowStart : r.colStart) - 1;
+		if (c >= 0 && !N(n)) {
+			let i = t ? n.getRangeAt(c, r.colStart, c, r.colEnd) : n.getRangeAt(r.rowStart, c, r.rowEnd, c);
+			if (N(i)) return {
+				present: !0,
+				inside: !1,
+				note: `header ${t ? `row ${c + 1}` : `column ${we(c)}`} (above this block)`,
+				names: ye(i, e, t)
+			};
+		}
+		return {
+			present: !1,
+			inside: !1,
+			note: "no header detected",
+			names: null
+		};
+	}(e, l), d = l ? o : a, f = l ? "" : " · by row", m = u.present && u.inside, h = l && m ? c.rowStart + 1 : c.rowStart, _ = !l && m ? c.colStart + 1 : c.colStart, v = c.rowEnd - h + 1, y = c.colEnd - _ + 1, b = v * y > r, x = b && l ? Math.max(1, Math.floor(r / Math.max(1, y))) : v, ee = b && !l ? Math.max(1, Math.floor(r / Math.max(1, v))) : y, te = Math.min(c.rowEnd, h + x - 1), ne = Math.min(c.colEnd, _ + ee - 1), S = Math.min(d, n), C = [], re = [];
+	for (let t = 0; t < S; t++) {
+		let n = l ? s.getRangeAt(h, c.colStart + t, te, c.colStart + t) : s.getRangeAt(c.rowStart + t, _, c.rowStart + t, ne);
+		C.push(be(e, l, t, u.names)), re.push(xe(n, i));
+	}
+	let ie = C.length ? Math.max(...C.map((e) => e.length)) : 0, w = C.map((e, t) => `${e.padEnd(ie)}  ${re[t]}`);
+	d > S && w.push(`…${d - S} more ${l ? "columns" : "rows"} not profiled · read them with getStats()`);
+	let T = [u.present ? `table${f}` : `block${f}`, u.note];
+	return b && T.push(`profiled from the first ${l ? `${x} rows` : `${ee} columns`} of ${l ? v : y}`), {
+		shape: u.present ? "table" : "block",
+		summary: T.filter(Boolean).join(" · "),
+		series: w
+	};
+}
+function N(e) {
+	let t = e.getStats({ onError: "ignore" }), n = t.getCount();
+	return n > 0 && (t.getTypedCounts()[f.String] ?? 0) === n;
+}
+function ye(e, t, n) {
+	let r = t.getRange().getCoords(), i = e.getCoords(), a = n ? r.colEnd - r.colStart + 1 : r.rowEnd - r.rowStart + 1, o = [];
+	for (let t = 0; t < a; t++) {
+		let a = n ? e.getRangeAt(i.rowStart, r.colStart + t).getCell() : e.getRangeAt(r.rowStart + t, i.colStart).getCell();
+		o.push(g(a, p.Mode.Display)?.match ?? "");
+	}
+	return o;
+}
+function be(e, t, n, r) {
+	let i = e.getRange().getCoords(), a = t ? we(i.colStart + n) : String(i.rowStart + n + 1), o = r?.[n];
+	return o ? `${a}  ${o}` : a;
+}
+function xe(e, t = 3) {
+	let n = e.getStats({ onError: "ignore" }), r = n.getTypedCounts(), i = n.getCount(), a = n.getSize(), o = a - i;
+	if (i === 0) return `${a} cells, all blank`;
+	let s = e.getCounts([j.Formula])[j.Formula] ?? 0, c = P(e), l = r[f.Number] ?? 0, u = r[f.String] ?? 0, d = r[f.Error] ?? 0, p = [String(i)], m = !1;
+	if (s === i) {
+		let t = [...e.getRegions(j.Formula)];
+		if (t.length === 1) {
+			let e = t[0].getCell().getFormulaText();
+			p.push("formula", e ? `=${e}` : "(uniform)");
+		} else p.push("formula", `${t.length} distinct`);
+	} else if (c === i) p.push("date", F(n, e));
+	else if (l === i) p.push("number", F(n, e), ...Ce(n, e));
+	else if (u === i) p.push("text", I(n, t));
+	else {
+		let e = [
+			l ? `number ${l}` : null,
+			u ? `text ${u}` : null,
+			r[f.Boolean] ? `boolean ${r[f.Boolean]}` : null,
+			d ? `error ${d}` : null
+		].filter(Boolean);
+		p.push("mixed", e.join(" · ")), m = !0;
+	}
+	let h = [
+		d > 0 && !m ? `error ${d}` : null,
+		o > 0 ? `${o} blank` : null,
+		s > 0 && s !== i ? `${s} formula` : null
+	].filter(Boolean), g = p.filter(Boolean).join("  ");
+	return h.length ? `${g}  · ${h.join(" · ")}` : g;
+}
+function Se(e, t = 3) {
+	let n = e.getStats({ onError: "ignore" }), r = n.getTypedCounts(), i = [], a = r[f.Number] ?? 0;
+	if (a > 0) {
+		let t = [F(n, e), ...Ce(n, e)].filter(Boolean);
+		i.push(`Number: ${a}  ${t.join("  ")}`.trimEnd());
+	}
+	let o = r[f.String] ?? 0;
+	if (o > 0) {
+		let e = I(n, t, (e) => typeof e == "string");
+		i.push(`String: ${o}  ${e}`.trimEnd());
+	}
+	let s = r[f.Boolean] ?? 0;
+	if (s > 0) {
+		let e = I(n, t, (e) => typeof e == "boolean");
+		i.push(`Boolean: ${s}  ${e}`.trimEnd());
+	}
+	return i;
+}
+function P(e) {
+	let t = 0;
+	return e.forEach((e, n) => {
+		n.getInteropType() === u.Date && t++;
+	}), t;
+}
+function F(e, t) {
+	let n = e.getAggregates({ onError: "ignore" });
+	if (n.min === null || n.max === null) return "";
+	let r = t.getStyle().getNumberFormat(), i = h(n.min, r), a = h(n.max, r);
+	return i === a ? i : `${i} … ${a}`;
+}
+function Ce(e, t) {
+	let n = e.getAggregates({ onError: "ignore" }), r = t.getStyle().getNumberFormat(), i = [];
+	return n.sum !== null && i.push(`Σ ${h(n.sum, r)}`), n.average !== null && i.push(`x̄ ${h(n.average, r)}`), i;
+}
+function I(e, t, n) {
+	let r = e.getFrequencies(n ? { filterFn: n } : void 0), i = r.getUniqueCount();
+	if (i === 0) return "";
+	if (i === r.getTotalCount()) return `${i} distinct, no repeats`;
+	let a = Array.from(r.getValueCounts()).slice(0, t);
+	return `${i} unique (${a.map(([e, t]) => `${e} ${t}`).join(" · ")}${i > a.length ? " · …" : ""})`;
+}
+function we(e) {
+	let t = e, n = "";
+	do
+		n = String.fromCharCode(65 + t % 26) + n, t = Math.floor(t / 26) - 1;
+	while (t >= 0);
+	return n;
+}
+var L = r.Feature, R = (e) => e.getRange().getStyle(), Te = (e) => g(e.getCell(), p.Mode.Display)?.display ?? null;
+function Ee(e, t) {
+	switch (e) {
+		case L.Formula: return (e) => {
+			let t = e.getCell().getFormulaText();
+			return t ? `=${t}` : null;
+		};
+		case L.Error: return Te;
+		case L.CalcError: return (e) => {
+			let t = Te(e) ?? "", n = e.getCell().getFormulaText();
+			return (n ? `${t}  =${n}` : t).trim() || null;
+		};
+		case L.Merge: return Te;
+		case L.Comments: return (e) => {
+			let t = e.getCell().getComments()?.content;
+			if (typeof t != "string") return null;
+			let n = t.replace(/\s+/g, " ").trim();
+			return n ? n.length > 60 ? `${n.slice(0, 59)}…` : n : null;
+		};
+		case L.Spills: return (e) => e.getCell().getSpill()?.getValuesRange().toString() ?? null;
+		case L.Hyperlink: return (e) => e.getCell().getHyperlink()?.getAddress() ?? null;
+		case L.Table: return (e) => e.getCell().getTable()?.getName() ?? null;
+		case L.Fill: return (e) => ae(R(e));
+		case L.Border: return (e) => oe(R(e));
+		case L.NumberFormat: return (e) => le(R(e));
+		case L.Alignment: return t ? (e) => ue(R(e), t) : void 0;
+		case L.Font: return t ? (e) => de(R(e), t) : void 0;
+		case L.Conditionals: return (e) => A(e.getRange().getConditionalFormats(), k);
+		case L.DataValidations: return (e) => A(e.getRange().getDataValidations(), _e);
+		case L.Contentful: return (e) => Se(e.getRange()).join("  ") || null;
+		default: return;
+	}
+}
+function De(e, t) {
+	let n = e.map((e) => Ee(e, t)).filter((e) => !!e);
+	if (n.length !== 0) return n.length === 1 ? n[0] : (e) => {
+		let t = n.map((t) => t(e)).filter(Boolean);
+		return t.length > 0 ? t.join("  ") : null;
+	};
+}
+var z = class {
+	constructor() {
+		this._lines = [], this._headingOffset = 0;
+	}
+	setHeadingOffset(e) {
+		return this._headingOffset = e, this;
+	}
+	_heading(e, t) {
+		return this._lines.push(`${"#".repeat(Math.min(6, e + this._headingOffset))} ${t}`), this;
+	}
+	h1(e) {
+		return this._heading(1, e);
+	}
+	h2(e) {
+		return this._heading(2, e);
+	}
+	h3(e) {
+		return this._heading(3, e);
+	}
+	text(e) {
+		return this._lines.push(e), this;
+	}
+	blank() {
+		return this._lines.push(""), this;
+	}
+	bullet(e) {
+		return typeof e == "string" ? this._lines.push(`- ${e}`) : e.forEach((e) => this._lines.push(`- ${e}`)), this;
+	}
+	fact(e) {
+		return typeof e == "string" ? this._lines.push(`  ${e}`) : e.forEach((e) => this._lines.push(`  ${e}`)), this;
+	}
+	bold(e) {
+		return `**${e}**`;
+	}
+	codespan(e) {
+		return `\`${e}\``;
+	}
+	code(e, t = "") {
+		return `\`\`\`${t}\n${e}\n\`\`\``;
+	}
+	beginFrame(e) {
+		return new Oe(this, e);
+	}
+	_addLines(e) {
+		this._lines.push(...e);
+	}
+	toLines() {
+		return [...this._lines];
+	}
+}, Oe = class {
+	constructor(e, t) {
+		this._parent = e, this._headers = t, this._indexWidth = 0, this._rows = [], this._colWidths = t.map((e) => e.length);
+	}
+	addRow(e, t) {
+		let n = e.map((e) => typeof e == "string" ? { text: e } : e);
+		return n.forEach((e, t) => {
+			this._colWidths[t] = Math.max(this._colWidths[t] ?? 0, e.text.length);
+		}), t !== void 0 && (this._indexWidth = Math.max(this._indexWidth, t.length)), this._rows.push({
+			index: t,
+			cells: n
+		}), this;
+	}
+	endFrame() {
+		return this._parent._addLines(this._renderLines()), this._parent;
+	}
+	_columnAlignment(e) {
+		let t = 0, n = 0;
+		for (let r of this._rows) {
+			let i = r.cells[e];
+			i && i.text && (n++, i.alignment === "right" && t++);
+		}
+		return n > 0 && 2 * t >= n ? "right" : void 0;
+	}
+	_renderLines() {
+		let e = this._indexWidth > 0 ? " ".repeat(this._indexWidth) : "", t = this._colWidths.map((e, t) => this._columnAlignment(t)), n = [];
+		if (this._headers.some((e) => e.length > 0)) {
+			let r = this._headers.map((e, n) => ke(e, this._colWidths[n], t[n])).join("  ");
+			n.push(`${e}${e ? "  " : ""}${r}`.trimEnd());
+		}
+		for (let e of this._rows) {
+			let t = e.cells.map((e, t) => ke(e.text, this._colWidths[t], e.alignment)).join("  "), r = this._indexWidth > 0 ? (e.index ?? "").padStart(this._indexWidth) + "  " : "";
+			n.push(`${r}${t}`.trimEnd());
+		}
+		return n;
+	}
+}, ke = (e, t, n) => {
+	if (e.length >= t) return e;
+	let r = t - e.length;
+	return n === "right" ? e.padStart(t) : n === "center" ? " ".repeat(Math.floor(r / 2)) + e + " ".repeat(Math.ceil(r / 2)) : e.padEnd(t);
+};
+function Ae(e, t, n) {
+	let r = E(t.length, n?.maxRegions ?? 200), i = t.length > r ? t.slice(0, r) : t, a = i.length < t.length;
+	if (i.length === 0) return void e.text("None");
+	let o = i.map((e) => e.toString()), s = Math.max(...o.map((e) => e.length)), c = i.map((e) => `${e.getRowCount()}×${e.getColumnCount()}`), l = Math.max(...c.map((e) => e.length)), u = n?.profile ? n?.maxProfiled ?? 12 : 0;
+	for (let t = 0; t < i.length; t++) {
+		let r = i[t], a = n?.payload?.(r), d = r.isClipped() ? "  ✂ clipped at the query edge — the block continues" : "", f = `  ${o[t].padEnd(s)}  ${c[t].padEnd(l)}`;
+		if (t < u) {
+			let t = M(r, n);
+			e.text(`${f}  ${t.summary}${d}`);
+			for (let n of t.series) e.text(`      ${n}`);
+			continue;
+		}
+		e.text(a ? `${f}  ${a}${d}` : `${f}${d}`.trimEnd());
+	}
+	if (u > 0 && i.length > u && e.text(`  …${i.length - u} more regions listed but not profiled · profile one with getRange().getStats(), or loop them in code`), a) {
+		let i = n?.recovery ?? "narrow the range, or loop the regions in code — this listing is a report, not the query";
+		e.text(`  …truncated at ${r} of ${t.length} regions · ${i}`);
+	}
+}
+function je(e, t) {
+	let n = [...e], i = e.getFeatures(), a = i.join(", "), o = i.length === 1 && i[0] === r.Feature.Contentful, s = e.getRange().getSheet().getWorkbook()?.getStyles().getNormal() ?? null, c = new z();
+	return c.h1(`Regions — ${a} (${n.length})`), Ae(c, n, {
+		...t,
+		profile: o,
+		payload: o ? void 0 : De(i, s)
+	}), c.toLines().join("\n").trimEnd();
+}
+function Me(e, t) {
+	let n = t.getRange();
+	e.text(`Name: ${t.getName()}`);
+	let r = t.getDescription();
+	r && e.text(`Description: ${r}`);
+	let i = n.getRowCount(), a = n.getColumnCount();
+	e.text(`Location: ${n.toString()},  ${i} row${i === 1 ? "" : "s"} x ${a} column${a === 1 ? "" : "s"}`);
+	let o = t.getColumns().map((e) => e.getName());
+	e.text(`Columns (${o.length}): ${o.join(", ")}`), e.text("Headers: " + (t.isShowHeaders() ? "shown" : "hidden")), e.text("Totals: " + (t.isShowTotals() ? "shown" : "hidden"));
+}
+function Ne(e) {
+	let t = new z();
+	return t.h1(`Table — ${e.getName()}`), t.text(`Sheet: ${H(e.getRange().getSheet().getName())}`), t.blank(), Me(t, e), t.toLines().join("\n").trimEnd();
+}
+var B = r.Feature, Pe = [
+	B.Error,
+	B.CalcError,
+	B.Contentful,
+	B.Formula,
+	B.Spills,
+	B.Merge,
+	B.Table,
+	B.AutoTable,
+	B.Hyperlink,
+	B.Comments,
+	B.Unlock,
+	B.NumberFormat,
+	B.Font,
+	B.Fill,
+	B.Border,
+	B.Alignment,
+	B.Conditionals,
+	B.DataValidations
+], Fe = new Map(Object.entries(B).map(([e, t]) => [t, e])), Ie = (e) => Fe.get(e) ?? e;
+function Le(e) {
+	let t = new Map(Object.values(B).map((e) => [e.toLowerCase(), e])), n = [];
+	for (let r of e.split(",")) {
+		let e = r.trim();
+		if (!e) continue;
+		let i = t.get(e.toLowerCase());
+		if (!i) throw Error(`Unknown feature '${e}'. Features: ${Object.values(B).join(", ")}.`);
+		n.push(i);
+	}
+	return n;
+}
+var V = (e) => `${e.toString()}, ${e.getRowCount()}×${e.getColumnCount()}`, H = (t) => e.sheetNameToString(t) ?? "Untitled", Re = (e) => `wb.getSheet(${JSON.stringify(e.getSheet().getName())})`, ze = (e) => ((e) => {
+	if (!e.includes("$")) return e;
+	let t = "", n = !1;
+	for (let r of e) {
+		if (r === "'") n = !n;
+		else if (r === "$" && !n) continue;
+		t += r;
+	}
+	return t;
+})(e.getAddress()), Be = (e) => {
+	let t = ze(e);
+	return t.includes("!") ? t : `${H(e.getSheet().getName())}!${t}`;
+}, U = (e) => {
+	let t = e.toString();
+	return `${t.includes("!") ? t : `${H(e.getSheet().getName())}!${t}`}, ${e.getRowCount()}×${e.getColumnCount()}`;
+};
+function W(e, t) {
+	let n = t.getStats({ onError: "ignore" }), r = n.getTypedCounts(), i = P(t), a = [
+		["Error", r[f.Error] ?? 0],
+		["Number", r[f.Number] ?? 0],
+		["String", r[f.String] ?? 0],
+		["Date", i],
+		["Boolean", r[f.Boolean] ?? 0],
+		["RichData", r[f.RichData] ?? 0]
+	].filter(([, e]) => e > 0), o = n.getCount();
+	e.h2(`Kind (${o} cell${o === 1 ? "" : "s"} · ${a.length} kind${a.length === 1 ? "" : "s"})`);
+	for (let [t, n] of a) e.fact(`${t}: ${n}`);
+	a.length === 0 && e.fact("None"), e.blank();
+}
+function Ve(e, t, n) {
+	let r = t.getSheet().getWorkbook()?.getStyles().getNormal() ?? null, i = n?.features === void 0 ? null : new Set(typeof n.features == "string" ? [n.features] : n.features), a = Pe.filter((e) => !i || i.has(e));
+	if (a.length === 0) return;
+	let o = t.getCounts(a);
+	for (let i of a) {
+		let a = [...t.getRegions(i)];
+		if (a.length === 0) continue;
+		let s = !!n?.profile && i === B.Contentful;
+		e.h2(`${Ie(i)} (${He(a.length, o[i])})`), Ae(e, a, {
+			maxRegions: n?.maxRegions,
+			maxProfiled: n?.maxProfiled,
+			profile: s,
+			payload: s ? void 0 : Ee(i, r),
+			recovery: `${Re(t)}.getRegions(${JSON.stringify(i)}) lists all ${a.length}`
+		}), e.blank();
+	}
+}
+var He = (e, t) => `${t} cell${t === 1 ? "" : "s"} · ${e} region${e === 1 ? "" : "s"}`, Ue = (e, t) => e.length > t ? `${e.slice(0, t - 1)}…` : e, We = (e) => e.isIFormula ? e : null, G = (e) => {
+	let t = e.getScope();
+	return t ? `${H(t)}!${e.getName()}` : e.getName();
+}, Ge = (e) => {
+	let t = e.getAddress();
+	return t.includes("!") ? t : `${H(e.getSheet().getName())}!${t}`;
+};
+function Ke(e) {
+	let t = We(e), n;
+	return n = t ? "=" + t.getExpression() : e.getRanges?.()?.getAddress() ?? "", t?.isVolatile() && (n += " (volatile)"), n.trim();
+}
+var qe = /* @__PURE__ */ new Set([t.Code.Ref, t.Code.Name]), Je = (e) => {
+	let n = e.value, r = t.isError(n) ? n : n?.error;
+	return r && qe.has(r.getCode()) ? r.getCode() === t.Code.Name ? "#NAME?" : "#REF!" : null;
+}, Ye = /* @__PURE__ */ new Set(), Xe = (e) => {
+	let t = e.value;
+	return typeof t == "object" && t?.name ? t.name : e.text ?? "";
+};
+function Ze(e) {
+	let t = null;
+	for (let n = 0; n < e.length; n++) {
+		let r = e[n];
+		if (r.type !== "named" || !r.context) continue;
+		let i = r.context.name?.toUpperCase();
+		if (i !== "LAMBDA" && (i !== "LET" || r.context.argIndex % 2 != 0)) continue;
+		let a = n + 1;
+		for (; a < e.length && e[a].type === "whitespace";) a++;
+		if (e[a]?.type !== "separator") continue;
+		let o = Xe(r).toLowerCase();
+		o && (t ??= /* @__PURE__ */ new Set()).add(o);
+	}
+	return t ?? Ye;
+}
+function K(e, t, n) {
+	if (t.length === 0) return;
+	let r = /* @__PURE__ */ new Set();
+	for (let e of n?.symbols ?? t) r.add(e.getName().toLowerCase());
+	let i = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Set();
+	for (let e of t) i.set(e.getId(), e), e.getScope() && a.add(e.getName().toLowerCase());
+	let o = t.map((e) => {
+		let t = function(e, t) {
+			let n = We(e), r = [];
+			if (n) {
+				let e = n.getTokens(), i = null, a = null;
+				for (let n of e) {
+					if (n.type === "error") {
+						a ??= Je(n);
+						continue;
+					}
+					if (n.type !== "named") continue;
+					let o = Xe(n);
+					o && !t.has(o.toLowerCase()) && (i ??= Ze(e), i.has(o.toLowerCase()) || r.includes(o) || r.push(o));
+				}
+				if (a || r.length > 0) return {
+					broken: !0,
+					missing: r,
+					error: r.length > 0 ? `#NAME?: ${r.join(", ")}` : a
+				};
+				if (!n.isReferenceOnly()) return {
+					broken: !1,
+					missing: r,
+					error: ""
+				};
+			}
+			let i = null;
+			try {
+				i = e.getRanges?.() ?? null;
+			} catch {
+				return {
+					broken: !0,
+					missing: r,
+					error: "#REF!"
+				};
+			}
+			let a = !i || i.isInvalidAny();
+			return {
+				broken: a,
+				missing: r,
+				error: a ? "#REF!" : ""
+			};
+		}(e, r), n = We(e), o = n ? function(e, t) {
+			let n = e.getDirectDependents(), r = 0, i = [], a = /* @__PURE__ */ new Set(), o = [];
+			if (n) {
+				let e = n.getCoords(), s = n.getCount();
+				for (let c = 0; c < s; c++) {
+					let s = n.at(c);
+					if (s.isINamedRange) {
+						let e = s;
+						if (a.has(e.getId())) continue;
+						a.add(e.getId());
+						let n = t.get(e.getId());
+						i.push(n ? G(n) : e.getName());
+					} else {
+						let t = e[c];
+						r += (t.rowEnd - t.rowStart + 1) * (t.colEnd - t.colStart + 1), o.push(Ge(s));
+					}
+				}
+			}
+			let s = r + i.length;
+			if (s === 0) return {
+				text: "unused",
+				weight: s
+			};
+			let c = [...i, ...o], l = [], u = 0;
+			for (let e = 0; e < c.length; e++) {
+				let t = (l.length > 0 ? 2 : 0) + c[e].length;
+				if (l.length > 0 && u + t > 60) break;
+				l.push(l.length === 0 ? Ue(c[e], 60) : c[e]), u += t;
+			}
+			let d = c.length - l.length, f = d > 0 ? `, +${d} more` : "";
+			return {
+				text: `${s} · ${l.join(", ")}${f}`,
+				weight: s
+			};
+		}(n, i) : null;
+		o?.weight === 0 && !e.getScope() && a.has(e.getName().toLowerCase()) && (o = {
+			...o,
+			text: "unused · shadowed"
+		});
+		let s = e.getComment() ?? "", c = G(e);
+		return {
+			name: c,
+			refersTo: Ke(e),
+			dependents: o,
+			hidden: e.isHidden(),
+			comment: Ue(s, 60),
+			broken: t.broken,
+			error: t.error,
+			sortKey: c.toLowerCase().replace(/'/g, "")
+		};
+	}), s = (e, t) => {
+		let n = (t.dependents?.weight ?? 0) - (e.dependents?.weight ?? 0);
+		return n === 0 ? e.sortKey.localeCompare(t.sortKey) : n;
+	}, c = [...o.filter((e) => e.broken).sort(s), ...o.filter((e) => !e.broken).sort(s)], l = E(c.length, n?.maxNames ?? 200), u = c.length > l ? c.slice(0, l) : c, d = u.filter((e) => e.broken), f = u.filter((e) => !e.broken);
+	e.h2(`${n?.heading ?? "Names"} (${o.length})`);
+	let p = (t, n) => {
+		let r = t.some((e) => e.hidden), i = t.some((e) => e.comment.length > 0), a = t.some((e) => e.dependents !== null), o = ["Name", "Refers To"];
+		n && o.push("Error"), a && o.push("Dependents"), r && o.push("Hidden"), i && o.push("Comment");
+		let s = e.beginFrame(o);
+		for (let e of t) {
+			let t = [{ text: e.name }, { text: e.refersTo }];
+			n && t.push({ text: e.error }), a && t.push({ text: e.dependents?.text ?? "" }), r && t.push({ text: e.hidden ? "hidden" : "" }), i && t.push({ text: e.comment }), s.addRow(t);
+		}
+		s.endFrame();
+	};
+	if (d.length > 0) {
+		let t = c.reduce((e, t) => e + +!!t.broken, 0);
+		e.text(`${t} ${t === 1 ? "does" : "do"} not resolve:`), p(d, !0), e.blank();
+	}
+	if (f.length > 0 && p(f, !1), u.length < o.length) {
+		let t = n?.recovery ?? "getByName('Name') renders one in full";
+		e.text(`  …and ${o.length - u.length} more · ${t}`);
+	}
+	e.blank();
+}
+function q(e, t, n) {
+	$e(e, "Precedents", t, "precedents", n), $e(e, "Dependents", t, "dependents", n);
+}
+function Qe(e) {
+	let t = e.isINamedRange ? e.getId() : null;
+	if (t) return `name:${t}`;
+	let n = e.getCoords();
+	return `${e.getSheet()?.getName() ?? ""}!${n.rowStart},${n.colStart},${n.rowEnd},${n.colEnd}`;
+}
+function $e(e, t, n, r, i) {
+	let a = i?.maxDepth ?? 3, o = i?.maxNodes ?? 50, s = [], c = /* @__PURE__ */ new Set(), l = /* @__PURE__ */ new Set(), u = !1, d = !1, f = !1, p = (e, t) => {
+		let n = ((e) => r === "precedents" ? e.getDirectPrecedents() : e.getDirectDependents())(e);
+		if (n && n.length !== 0) if (t > a) u = !0;
+		else for (let e = 0; e < n.length; e++) {
+			if (s.length >= o) return void (d = !0);
+			let r = n.at(e), { address: i, sheet: a, isName: u } = et(r), m = "  ".repeat(t), h = Qe(r), g = {
+				indent: m,
+				sheet: a,
+				isName: u,
+				label: `${m}${i}`
+			};
+			l.has(h) ? (s.push({
+				...g,
+				detail: "↺ circular"
+			}), f = !0) : c.has(h) ? s.push({
+				...g,
+				detail: "↑ shown above"
+			}) : (c.add(h), l.add(h), s.push({
+				...g,
+				detail: tt(r)
+			}), p(r, t + 1), l.delete(h));
+		}
+	};
+	if (p(n, 0), s.length === 0) return;
+	let m = s.filter((e) => !e.isName);
+	if (m.length > 0 && m.some((e) => e.sheet !== m[0].sheet)) for (let e of s) e.isName || (e.label = `${e.indent}${e.sheet}!${e.label.slice(e.indent.length)}`);
+	e.h2(t);
+	let h = Math.max(...s.map((e) => e.label.length));
+	for (let t of s) e.text(`  ${t.label.padEnd(h)}  ${t.detail}`.trimEnd());
+	f && e.text("  ↺ circular reference — the chain returns to a cell already on this branch");
+	let g = r === "precedents" ? "getPrecedents()" : "getDependents()";
+	if (u && e.text(`  …deeper levels not walked · ${g} is the whole reach, flat`), d) {
+		let t = r === "precedents" ? "getDirectPrecedents()" : "getDirectDependents()";
+		e.text(`  …truncated at ${o} nodes · re-root on one node and walk it — its ${t}`);
+	}
+	e.blank();
+}
+function et(e) {
+	let t = e.getSheet()?.getName() ?? "";
+	if (e.isINamedRange) return {
+		address: e.getName(),
+		sheet: t,
+		isName: !0
+	};
+	let n = e.getAddress(), r = n.lastIndexOf("!");
+	return {
+		address: r >= 0 && r < n.length - 1 ? n.slice(r + 1) : n,
+		sheet: t,
+		isName: !1
+	};
+}
+function tt(e) {
+	if (e.isINamedRange) {
+		let t = e.getRanges();
+		return t ? `name → ${t.getAddress()}` : "name";
+	}
+	if (e.isSingleCell()) {
+		let t = e.getCell(), n = g(t, p.Mode.Display), r = t.getFormulaText(), i = n ? n.display : "(empty)";
+		return r ? `${i}  =${r}` : i;
+	}
+	let t = `${e.getRowCount()}×${e.getColumnCount()}`, n = [...e.getRegions(B.Formula)];
+	if (n.length === 1 && n[0].getRange().isEqual(e)) {
+		let e = n[0].getCell().getFormulaText();
+		if (e) return `${t}  =${e}`;
+	}
+	return t;
+}
+function nt(e, t, n) {
+	let r = n.getCoords().min, i = [], a = 0, o = 0;
+	if (n.forEachSpan((e, t) => {
+		let s = t.getCoords();
+		if (o++, a += s.max - s.min + 1, i.length >= 100) return;
+		let c = n.at(s.min - r).getText(), l = n.at(s.max - r).getText();
+		i.push({
+			address: `${c}:${l}`,
+			count: s.max - s.min + 1
+		});
+	}, {
+		visibility: "hidden",
+		includeEmpty: !0
+	}), a === 0) return;
+	e.h2(`${t} (${a})`);
+	let s = Math.max(...i.map((e) => e.address.length));
+	for (let t of i) e.text(`  ${t.address.padEnd(s)}  ${t.count}`);
+	o > i.length && e.text(`  …and ${o - i.length} more`), e.blank();
+}
+function rt(e, t, n, r) {
+	if (n.length === 0) return;
+	let i = n.length > 50 ? n.slice(0, 50) : n, a = i.map((e) => ({
+		address: Ue(ze(e.getRanges()), 40),
+		rule: r(e)
+	}));
+	e.h2(`${t} (${n.length})`);
+	let o = Math.max(...a.map((e) => e.address.length));
+	for (let t of a) e.text(`  ${t.address.padEnd(o)}  ${t.rule}`.trimEnd());
+	i.length < n.length && e.text(`  …and ${n.length - i.length} more`), e.blank();
+}
+function J(e, t) {
+	let n = t.getSheet(), r = t.getCoords(), i = n.getName(), a = [];
+	for (let e of n.getNames().getItems({
+		type: "formula",
+		includeHidden: !0
+	}) ?? []) {
+		let t = null;
+		try {
+			t = e.getRanges?.() ?? null;
+		} catch {}
+		t ? t.getCoords().some((e) => {
+			return (!e.scope || e.scope === i) && (n = e, (t = r).rowStart <= n.rowEnd && n.rowStart <= t.rowEnd && t.colStart <= n.colEnd && n.colStart <= t.colEnd);
+			var t, n;
+		}) && a.push(e) : e.getScope() === i && a.push(e);
+	}
+	K(e, a, { symbols: n.getWorkbook()?.getNames().getItems({ includeHidden: !0 }) ?? n.getNames().getItems({ includeHidden: !0 }) ?? [] });
+	let o = t.getColumnHeaders(), s = t.getRowHeaders();
+	nt(e, "Hidden Columns", o), nt(e, "Hidden Rows", s);
+	let c = t.getTables();
+	c.length > 0 && (e.h2("Tables"), c.forEach((t, n) => {
+		n > 0 && e.blank(), Me(e, t);
+	}), e.blank());
+}
+var it = {
+	features: (e) => Le(e),
+	mode: (e, t) => function(e, t, n) {
+		let r = new Map(Object.values(n).map((e) => [e.toLowerCase(), e])).get(e.trim().toLowerCase());
+		if (!r) throw Error(`Unknown ${t} '${e}'. Values: ${Object.values(n).join(", ")}.`);
+		return r;
+	}(e, t, p.Mode)
+}, at = Object.keys(it);
+function ot(e) {
+	let t = {};
+	for (let [n, r] of Object.entries(e)) {
+		let e = it[n];
+		if (!e) throw Error(`Unknown report option '${n}'. Options: ${at.join(", ")}.`);
+		t[n] = e(r, n);
+	}
+	return t;
+}
+function st(e, t) {
+	e = e.getSheet().getRange(e.getCoords()).getCell();
+	let n = new z();
+	return n.h1(`Cell — ${H(e.getSheet().getName())}!${e.getAddress()}`), n.blank(), function(e, t) {
+		let n = g(t, p.Mode.Display), r = g(t, p.Mode.Value), i = t.getFormulaText(), a = e.toLines().length;
+		(n || i) && (e.fact(`Type: ${t.getType()}`), n && e.fact(`Display: ${n.display}`), r && r.match !== n?.match && e.fact(`Value: ${r.display}`), i && e.fact(`Formula: ${e.codespan(`=${i}`)}`));
+		let o = t.getHyperlink();
+		o && e.fact(`Hyperlink: ${o.getAddress()}`);
+		let s = t.getSpans(), c = !t.isTopLeft();
+		if (c || s.height > 1 || s.width > 1) {
+			let n = t.getRange().toString();
+			e.fact(`Merge: ${n} · ${s.height}×${s.width}`), c && e.fact("Merge Anchor: false — this cell is covered; the value lives at the top-left");
+		}
+		let l = t.getSpill();
+		l && e.fact(`Spill: ${l.toString()}`), t.isSpillOverflow() && e.fact("Spill Overflow: true — the anchor formula is elsewhere");
+		let u = t.getTable();
+		u && e.fact(`Table: ${u.getName()}`);
+		let d = t.getErrors();
+		d.length > 0 && e.fact(`Errors: ${d.join("; ")}`);
+		let f = t.getWarnings();
+		f.length > 0 && e.fact(`Warnings: ${f.join("; ")}`), e.toLines().length > a && e.blank();
+	}(n, e), function(e, t) {
+		let n = t.getStyle(), r = t.getSheet().getWorkbook()?.getStyles().getNormal() ?? null, i = le(n), a = r ? de(n, r) : null, o = ae(n), s = ce(n), c = r ? ue(n, r) : null, l = n.getNamed().getName();
+		if (l !== (r?.getNamed().getName() ?? "Normal") || i || a || o || c || s.length !== 0) {
+			if (e.h2("Style"), e.fact(`Named: ${l}`), i && e.fact(`Number Format: ${i}`), a && e.fact(`Font: ${a}`), o && e.fact(`Fill: ${o}`), s.length === 1) e.fact(`Border: ${s[0]}`);
+			else if (s.length > 1) {
+				e.fact("Border:");
+				for (let t of s) e.fact(`  ${t}`);
+			}
+			c && e.fact(`Alignment: ${c}`), e.blank();
+		}
+	}(n, e), q(n, e, t), n.toLines().join("\n").trimEnd();
+}
+var ct = /* @__PURE__ */ new Set(["picture"]), lt = (e) => e.replace(/[\r\n]+/g, " ").trim(), ut = (e) => {
+	switch (e.getType()) {
+		case "chart": {
+			let t = [], n = e.getChartType?.();
+			n && n !== "unknown" && t.push(n);
+			let r = e.getChartTitle?.();
+			return r && t.push(`"${r}"`), t.length > 0 ? t.join(" · ") : null;
+		}
+		case "picture": return e.getResource?.()?.getName() || null;
+		default: return null;
+	}
+}, dt = (e) => {
+	let t = e.getContent(), n = [], r = ut(t);
+	r && n.push(r);
+	let i = e.getDescription();
+	i && n.push(lt(i));
+	let a = e.getName() || "(unnamed)", o = n.length > 0 ? `${a} — ${n.join(" · ")}` : a;
+	return c = 90, ((s = o).length > c ? `${s.slice(0, c - 1)}…` : s) + (e.isHidden() ? "  (hidden)" : "");
+	var s, c;
+};
+function ft(e, t) {
+	if (t.length === 0) return;
+	let n = t.length > 50 ? t.slice(0, 50) : t, r = n.map((e) => ({
+		address: e.getRange().toString(),
+		type: e.getContent().getType(),
+		summary: dt(e)
+	}));
+	e.h2(`Movables (${t.length})`);
+	let i = Math.max(...r.map((e) => e.address.length)), a = Math.max(...r.map((e) => e.type.length));
+	for (let t of r) e.text(`  ${t.address.padEnd(i)}  ${t.type.padEnd(a)}  ${t.summary}`.trimEnd());
+	n.length < t.length && e.text(`  …and ${t.length - n.length} more`);
+	let o = [...new Set(r.map((e) => e.type).filter((e) => !ct.has(e)))];
+	o.length > 0 && e.text(`  Not drawn: ${o.join(", ")} — SheetXL shows a labeled placeholder for these in the UI.`), e.blank();
+}
+function pt(e) {
+	let t = new z(), r = e.getRange(), i = e.getContent(), a = i.getType();
+	t.h1(`Movable — ${U(r)}`), t.blank(), t.fact(`Name: ${e.getName() || "(unnamed)"}`), t.fact(`Type: ${a}`);
+	let o = ut(i);
+	o && t.fact(`Content: ${o}`);
+	let s = e.getDescription();
+	s && t.fact(`Alt Text: ${lt(s)}`), t.fact(`Anchor: ${V(r)}, ${((e) => {
+		switch (e) {
+			case n.Type.Absolute: return "absolute — stays put when rows or columns move";
+			case n.Type.OneCell: return "oneCell — moves with the cells, keeps its size";
+			default: return "twoCell — moves and resizes with the cells";
+		}
+	})(e.getAnchorType?.())}`), t.fact(`Bounds: ${((e) => {
+		let t = e.getBounds();
+		if (!t) return "not laid out";
+		let n = (e) => Math.round(e);
+		return `${n(t.width)}×${n(t.height)} px at (${n(t.x)}, ${n(t.y)})`;
+	})(e)}`), e.isHidden() && t.fact("Hidden: true — this object is not visible in the UI");
+	let c = e.getRotation();
+	return c !== 0 && t.fact(`Rotation: ${c}°`), t.fact(`Z-Order: ${e.getZIndex()}`), t.fact(`Display: ${((e) => ct.has(e) ? "drawn" : `placeholder — SheetXL frames the ${e} at this position but does not draw its content`)(a)}`), t.blank(), t.text(`Sheet: ${H(r.getSheet().getName())}`), t.toLines().join("\n").trimEnd();
+}
+function mt(e, t) {
+	let n = new z();
+	n.h1(`Cell Range — ${U(e)}`), n.blank(), W(n, e), function(e, t, n) {
+		if (!1 === n?.profile || t.isSingleCell() || !t.isContentful()) return;
+		let r = M({
+			getRowCount: () => t.getRowCount(),
+			getColumnCount: () => t.getColumnCount(),
+			getCell: () => t.getCell(),
+			getRange: () => t
+		}, n);
+		e.h2("Profile"), e.text(r.summary);
+		for (let t of r.series) e.text(`  ${t}`);
+		e.blank();
+	}(n, e, t);
+	let i = function(e, t, n) {
+		let r = n?.mode ?? p.Mode.Display, i = n?.maxCells ?? 1e3, { rowStart: a, colStart: o } = t.getCoords(), s = t.getRowHeaders(), c = t.getColumnHeaders(), l = /* @__PURE__ */ new Map(), u = [], d = 0, f = !1;
+		t.forEach((e, t) => {
+			if (d >= i) return f = !0, { break: !0 };
+			let n = t.getCell(), a = n.getFormulaText(), o = g(n, r);
+			if (!o && !a) return;
+			let s = {
+				text: (o?.display ?? "").replace(/\|/g, "\\|").replace(/[\r\n]+/g, " "),
+				alignment: n.getRenderHorizontalAlignment()
+			}, c = n.getSpill();
+			c && u.push({
+				address: n.getAddress(),
+				valuesRange: c.getValuesRange().toString()
+			});
+			let { rowIndex: p, colIndex: m } = t.getCoords(), h = l.get(p);
+			h || (h = /* @__PURE__ */ new Map(), l.set(p, h)), h.set(m, s), d++;
+		});
+		let m = Array.from(l.keys()).sort((e, t) => e - t), h = /* @__PURE__ */ new Set();
+		l.forEach((e) => e.forEach((e, t) => h.add(t)));
+		let _ = Array.from(h).sort((e, t) => e - t);
+		if (m.length === 0) return { spills: u };
+		let v = t.getIntersect({
+			rowStart: m[0],
+			rowEnd: m[m.length - 1],
+			colStart: _[0],
+			colEnd: _[_.length - 1]
+		}), y = `${d} cell${d === 1 ? "" : "s"}`, b = v.toString() !== t.toString();
+		e.h2(`Values (${b ? `${V(v)} · ` : ""}${y})`);
+		let x = e.beginFrame(_.map((e) => c.at(e - o).getText()));
+		for (let e of m) {
+			let t = l.get(e);
+			x.addRow(_.map((e) => t?.get(e) ?? { text: "" }), s.at(e - a).getText());
+		}
+		return x.endFrame(), f && e.text(`…truncated at ${i} cells · narrow the address, or summarize the whole range with getStats()`), e.blank(), { spills: u };
+	}(n, e, t);
+	return function(e, t, n) {
+		let i = [];
+		for (let e of t.getRegions(r.Feature.Formula)) {
+			let t = e.getCell().getFormulaText();
+			if (t && (i.push({
+				address: e.getAddress(),
+				size: `${e.getRowCount()}×${e.getColumnCount()}`,
+				formula: `=${t}`
+			}), i.length >= (n?.maxRegions ?? 100))) break;
+		}
+		if (i.length === 0) return;
+		e.h2("Formulas");
+		let a = Math.max(...i.map((e) => e.address.length)), o = Math.max(...i.map((e) => e.size.length));
+		for (let t of i) e.text(`  ${t.address.padEnd(a)}  ${t.size.padEnd(o)}  ${t.formula}`);
+		e.blank();
+	}(n, e, t), function(e, t) {
+		if (t.length === 0) return;
+		e.h2("Spills");
+		let n = Math.max(...t.map((e) => e.address.length));
+		for (let { address: r, valuesRange: i } of t) e.text(`  ${r.padEnd(n)}  ${i}`);
+		e.blank();
+	}(n, i.spills), J(n, e), ft(n, e.getMovables()), rt(n, "Conditional Formats", e.getConditionalFormats(), k), rt(n, "Data Validations", e.getDataValidations(), _e), q(n, e, t), n.toLines().join("\n").trimEnd();
+}
+function ht(e) {
+	let t = new z(), n = e.getRanges();
+	t.h1(`Conditional Format — ${Be(n)}`), t.blank(), t.fact(`Order: ${e.getIndex() + 1}`);
+	let r = e.getScale();
+	if (r) t.fact(`Rule: ${he(r)}`);
+	else {
+		let n = e.getCondition();
+		t.fact(`Rule: ${n?.toString() || "none — this rule tests nothing"}`);
+		let r = pe(e.getStyle());
+		r && t.fact(`Format: ${r}`);
+	}
+	return e.isStopIfTrue() && t.fact("Stop If True: true — later rules are not evaluated where this one matches"), t.fact(`Cells: ${n.size}`), t.toLines().join("\n").trimEnd();
+}
+function gt(e) {
+	let t = new z();
+	t.h1("Counts");
+	let n = !1;
+	for (let [r, i] of Object.entries(e)) i > 0 && (t.fact(`${r}: ${i}`), n = !0);
+	return n || t.fact("None"), t.toLines().join("\n").trimEnd();
+}
+function _t(e) {
+	let t = new z(), n = e.getRanges();
+	t.h1(`Data Validation — ${Be(n)}`), t.blank();
+	let r = e.getCondition();
+	t.fact(`Rule: ${r?.toString() || "none — anything is accepted here"}`);
+	let i = ve(r);
+	i && t.fact(`Allowed: ${i}`), t.fact("Blanks: " + (e.isIncludeBlanks() ? "allowed" : "rejected"));
+	let a = e.getAlertStyle();
+	if (t.fact(`Alert: ${a}${a === o.AlertStyle.Stop ? " — the entry is refused" : " — the entry is accepted anyway"}`), e.isShowAlertMessage()) {
+		let n = vt(e.getAlertTitle(), e.getAlertMessage());
+		n && t.fact(`Alert Message: ${n}`);
+	}
+	if (e.isShowPromptMessage()) {
+		let n = vt(e.getPromptTitle(), e.getPromptMessage());
+		n && t.fact(`Prompt: ${n}`);
+	}
+	return e.isHideDropdown() && t.fact("Dropdown: hidden"), t.fact(`Cells: ${n.size}`), t.toLines().join("\n").trimEnd();
+}
+var vt = (e, t) => {
+	let n = [e?.trim(), t?.trim()].filter(Boolean);
+	return n.length > 0 ? n.join(" — ") : null;
+}, yt = "function", bt = "named", xt = "tableReference", St = "tableColumn", Ct = "externalReference", wt = [["isReferenceOnly", "reference-only"], ["isVolatile", "volatile"]], Tt = (e, t) => e ? ` (${H(e)}!${t})` : "";
+function Et(e, t, n, r) {
+	if (e === "external") return "another workbook — not resolvable from here";
+	if (!n) return "";
+	switch (e) {
+		case "function": {
+			let e = n.getCalculation().getFunctions().getByName(t);
+			return e ? e.isBuiltIn() ? "built-in" : "custom" : "unknown — evaluates to #NAME?";
+		}
+		case "named": return function(e, t) {
+			let n = t.getNames(), r = n.getByName(e) ?? n.getByName(e, !0);
+			if (r) {
+				let e = Tt(r.getScope(), r.getName()), t = r.getRanges?.();
+				return !t || t.isInvalid() ? `defined name — reference does not resolve${e}` : `${t.toString()}${e}`;
+			}
+			let i = t.getCalculation().getNamedFormulas().getByName(e);
+			return i ? `=${i.getExpression()}${Tt(i.getScope(), i.getName())}` : "unknown — evaluates to #NAME?";
+		}(t, n);
+		case "table": {
+			let e = n.getTables().getByName(t) ?? n.getWorkbook()?.getSheets().getItems().map((e) => e.getTables().getByName(t)).find(Boolean) ?? null;
+			return e ? ((e, t) => {
+				let n = e.getSheet(), r = e.toString();
+				return !n || t && n.getName() === t.getName() || r.includes("!") ? r : `${H(n.getName())}!${r}`;
+			})(e.getRange(), n) : "unknown — evaluates to #NAME?";
+		}
+		case "column": {
+			if (!r) return "column of the enclosing table";
+			let e = n.getTables().getByName(r);
+			if (!e) return `column of ${r}`;
+			let i = t.replace(/^\[|\]$/g, "").trim();
+			return e.getColumns().find((e) => e.getName() === i) ? `${r} column` : `no such column in ${r} — evaluates to #REF!`;
+		}
+	}
+	return "";
+}
+async function Dt(e, t) {
+	let n = t?.maxTokens ?? 200, r = new z(), i = ((e) => e.isINamed ? e : null)(e);
+	if (r.h1(i ? `Name — ${G(i)}` : "Formula"), r.text(r.codespan("=" + e.getExpression())), r.blank(), i) {
+		i.isHidden() && r.fact("Hidden: true — not offered in the UI; formulas resolve it normally");
+		let e = i.getComment();
+		e && r.fact(`Comment: ${e}`);
+		let t = i.getRanges?.();
+		r.fact(`Refers to: ${t ? t.getAddress() : "no range — this name holds an expression"}`);
+	}
+	await async function(e, t) {
+		let n;
+		try {
+			n = await t.evaluate();
+		} catch (t) {
+			e.fact(`Value: did not evaluate — ${t?.message ?? String(t)}`);
+			return;
+		}
+		if ((r = n) && typeof r == "object" && !0 === r.isIRange) return void e.fact(`Value: spills ${n.getRowCount()}×${n.getColumnCount()} — an array result`);
+		var r;
+		let i = _(n);
+		e.fact(`Value: ${i ? i.display : "(empty)"}`);
+	}(r, e), r.fact(`Status: ${e.getCalculationStatus()}`), e.isValid() || r.fact("Valid: false — the text did not parse as a complete expression");
+	let a = wt.filter(([t]) => e[t]()).map(([, e]) => e);
+	a.length > 0 && r.fact(`Flags: ${a.join(" · ")}`), r.blank();
+	let o = e.getReferences(), s = t?.context ?? o?.getSheet() ?? null, c = function(e, t) {
+		let n = /* @__PURE__ */ new Map(), r = null;
+		for (let i of e) {
+			let e = i.text?.trim();
+			if (!e) continue;
+			let a;
+			switch (i.type) {
+				case yt:
+					a = "function";
+					break;
+				case bt:
+					a = "named";
+					break;
+				case xt:
+					a = "table", r = e;
+					break;
+				case St:
+					a = "column";
+					break;
+				case Ct:
+					a = "external";
+					break;
+				default: continue;
+			}
+			let o = `${a}${e.toLowerCase()}`, s = n.get(o);
+			s ? s.uses++ : n.set(o, {
+				kind: a,
+				text: e,
+				uses: 1,
+				resolution: Et(a, e, t, r)
+			});
+		}
+		return [...n.values()];
+	}(e.getTokens(), s);
+	if (c.length > 0) {
+		r.h2(`Symbols (${c.length})`);
+		let e = r.beginFrame([
+			"Kind",
+			"Symbol",
+			"Uses",
+			"Resolves to"
+		]);
+		for (let t of c) e.addRow([
+			t.kind,
+			t.text,
+			String(t.uses),
+			t.resolution
+		]);
+		e.endFrame(), s || r.text("…no sheet context — pass `context` to resolve these"), r.blank();
+	}
+	if (r.h2("References"), o && o.length !== 0) for (let e = 0; e < o.length; e++) r.text(`  ${String(e).padStart(2)}  ${o.at(e).getAddress()}`);
+	else r.text("None");
+	r.blank(), i && function(e, t) {
+		t.getDirectDependents() || (e.h2("Dependents (0)"), e.text("  None — no formula references this name"), e.blank()), q(e, t);
+	}(r, i);
+	let l = e.getTokens();
+	if (r.h2("Tokens"), l.length === 0) r.text("None");
+	else {
+		let e = l.length > n ? l.slice(0, n) : l, t = r.beginFrame([
+			"#",
+			"Type",
+			"Text",
+			"Enclosing",
+			"Arg"
+		]);
+		for (let n = 0; n < e.length; n++) {
+			let r = e[n], i = r.context;
+			t.addRow([
+				{
+					text: String(n),
+					alignment: "right"
+				},
+				r.type ?? "",
+				r.text ?? "",
+				i?.name ?? "",
+				i && i.argIndex >= 0 ? String(i.argIndex) : ""
+			]);
+		}
+		t.endFrame(), e.length < l.length && r.text(`…truncated at ${e.length} of ${l.length} tokens · search getTokens() directly`);
+	}
+	return r.toLines().join("\n").trimEnd();
+}
+var Ot = [["formula", "Names"], ["table", "Tables"]];
+function kt(e, t) {
+	let n = new z(), r = e.getItems({ includeHidden: !0 }) ?? [];
+	if (n.h1(`Names — ${r.length} item${r.length === 1 ? "" : "s"}`), n.blank(), r.length === 0) return n.text("None"), n.toLines().join("\n").trimEnd();
+	let i = new Set(Ot.map(([e]) => e));
+	for (let [e, i] of Ot) K(n, r.filter((t) => t.getType() === e), {
+		...t,
+		heading: i,
+		symbols: r
+	});
+	let a = r.filter((e) => !i.has(e.getType())), o = [...new Set(a.map((e) => e.getType()))].sort();
+	for (let e of o) K(n, a.filter((t) => t.getType() === e), {
+		...t,
+		heading: e,
+		symbols: r
+	});
+	return n.toLines().join("\n").trimEnd();
+}
+var Y = (e) => {
+	if (!e || typeof e != "object" || Array.isArray(e)) return !1;
+	let t = Object.getPrototypeOf(e);
+	return t === Object.prototype || t === null;
+};
+function At(e, t) {
+	let n = t?.maxCells ?? 1e3, r = Array.isArray(e) ? e : [e], i = new z();
+	if (i.h1("Records"), i.text(`Count: ${r.length}`), i.blank(), r.length === 0) return i.text("None"), i.toLines().join("\n").trimEnd();
+	let a = (e) => {
+		let t = [], n = /* @__PURE__ */ new Set();
+		for (let r of e) for (let e of Object.keys(r ?? {})) n.has(e) || (n.add(e), t.push(e));
+		return t;
+	}, o = Math.max(1, a(r).length), s = E(r.length, Math.max(1, Math.floor(n / o))), c = r.length > s ? r.slice(0, s) : r, l = c.length === r.length ? a(r) : a(c);
+	if (l.length === 0) return i.text("No fields"), i.toLines().join("\n").trimEnd();
+	let u = i.beginFrame(l);
+	for (let e of c) u.addRow(l.map((t) => jt(e?.[t])));
+	return u.endFrame(), c.length < r.length && i.text(`…truncated at ${c.length} of ${r.length} records · filter, sort or aggregate the array in the expression`), i.toLines().join("\n").trimEnd();
+}
+var jt = (e) => {
+	if (e == null) return { text: "" };
+	if (typeof e == "function") return { text: "[Function]" };
+	if (typeof e == "bigint" || typeof e == "symbol") return { text: X(String(e)) };
+	if (typeof e == "object") {
+		if (e instanceof Date) return { text: e.toISOString() };
+		let t = e;
+		if (!0 === t.isFormulaError || !0 === t.isIRichData) return { text: X(Mt(e)) };
+		if (Y(e) || Array.isArray(e)) {
+			let t;
+			try {
+				t = JSON.stringify(e) ?? String(e);
+			} catch {
+				t = "[circular]";
+			}
+			return { text: X(t) };
+		}
+		return { text: X(String(e)) };
+	}
+	let t = X(Mt(e).replace(/[\r\n]+/g, " "));
+	return typeof e == "number" ? {
+		text: t,
+		alignment: "right"
+	} : { text: t };
+}, Mt = (e) => {
+	try {
+		return _(e)?.match ?? String(e);
+	} catch {
+		return String(e);
+	}
+}, X = (e) => e.length > 80 ? `${e.slice(0, 79)}…` : e;
+function Nt(e, t) {
+	let n = e.length, r = E(n, t?.maxRanges ?? 100), i = Math.min(n, r), a = [];
+	for (let t = 0; t < i; t++) {
+		let n = e.at(t);
+		a.push({
+			...et(n),
+			detail: tt(n)
+		});
+	}
+	let o = a.filter((e) => !e.isName), s = o.length > 0 && o.some((e) => e.sheet !== o[0].sheet), c = o.length > 0 ? o[0].sheet : e.getSheet()?.getName(), l = new z(), u = a.length > 0 && !s && !!c;
+	if (l.h1(u ? `Ranges — ${H(c)} (${n})` : `Ranges (${n})`), a.length === 0) return l.text("none"), l.toLines().join("\n").trimEnd();
+	let d = a.map((e) => s && !e.isName ? `${H(e.sheet)}!${e.address}` : e.address), f = Math.max(...d.map((e) => e.length));
+	for (let e = 0; e < a.length; e++) l.text(`  ${d[e].padEnd(f)}  ${a[e].detail}`.trimEnd());
+	return i < n && l.text(`  …and ${n - i} more · loop the collection in code to see them all`), l.toLines().join("\n").trimEnd();
+}
+function Pt(e, t) {
+	let n = new z(), r = e.getSelectedRange(), i = e.getUsedRange();
+	n.h1(`Sheet — ${H(e.getName())}${function(e) {
+		let t = e.getWorkbook(), n = "";
+		t && t.getSelectedSheet()?.getId() === e.getId() && (n += " (selected)");
+		let r = e.getVisibility();
+		return r === l.Visibility.Hidden ? n += " (hidden)" : r === l.Visibility.VeryHidden && (n += " (very hidden)"), n;
+	}(e)}`), n.text(`Used: ${i ? V(i) : "empty"}`), n.text(`Selection: ${V(r)}`), n.blank();
+	let a = i ?? r;
+	return W(n, a), Ve(n, a, {
+		profile: !0,
+		...t
+	}), J(n, a), ft(n, e.getMovables().getItems()), n.toLines().join("\n").trimEnd();
+}
+var Ft = [
+	["numericalCount", "Numbers"],
+	["sum", "Sum"],
+	["min", "Min"],
+	["max", "Max"],
+	["average", "Average"],
+	["stdDev", "StdDev"]
+];
+function It(e) {
+	let t = new z();
+	t.h1("Stats");
+	let n = e.getTypedCounts();
+	t.fact(`Cells: ${e.getSize()}`), t.fact(`Values: ${e.getCount()}`);
+	let r = n[f.Error] ?? 0;
+	r > 0 && t.fact(`Errors: ${r}`);
+	let i = e.getAggregates({ onError: "ignore" });
+	for (let [e, n] of Ft) {
+		let r = i[e];
+		r != null && t.fact(`${n}: ${m(r)}`);
+	}
+	let a = [];
+	for (let [e, t] of Object.entries(n)) e !== f.Null && t && a.push(`${e.charAt(0).toUpperCase()}${e.slice(1)}: ${t}`);
+	return a.length > 0 && (t.blank(), t.h2("Type"), t.fact(a)), t.toLines().join("\n").trimEnd();
+}
+function Lt(e) {
+	let t = new z();
+	t.h1("Style"), t.text(`Named: ${e.getNamed().getName()}`), t.blank();
+	let n = e.toJSON(), r = n ? Object.entries(n).filter(([, e]) => e !== void 0) : [];
+	if (r.length === 0) t.fact("No direct styling (inherits the named style)");
+	else for (let [e, n] of r) t.fact(`${e}: ${t.codespan(typeof n == "string" ? n : JSON.stringify(n))}`);
+	return t.toLines().join("\n").trimEnd();
+}
+function Rt(e, t) {
+	let n = t?.maxCells ?? 1e3, r = zt(e) ? e.getValues() : e, i = r.length, a = r.reduce((e, t) => Math.max(e, t?.length ?? 0), 0), o = new z();
+	if (o.h1("Values"), o.text(`Size: ${i}×${a}`), o.blank(), i === 0 || a === 0) return o.text("None"), o.toLines().join("\n").trimEnd();
+	let s = E(i, Math.max(1, Math.floor(n / a))), c = i > s ? r.slice(0, s) : r, l = o.beginFrame(Array(a).fill(""));
+	for (let e of c) l.addRow(Array.from({ length: a }, (t, n) => Bt(e?.[n])));
+	return l.endFrame(), c.length < i && o.text(`…truncated at ${c.length} of ${i} rows · slice or aggregate in the expression before returning it`), o.toLines().join("\n").trimEnd();
+}
+var zt = (e) => !!e && typeof e == "object" && !0 === e.isIRange, Bt = (e) => {
+	if (e == null) return { text: "" };
+	let t = (_(e)?.display ?? "").replace(/[\r\n]+/g, " ");
+	return typeof e == "number" ? {
+		text: t,
+		alignment: "right"
+	} : { text: t };
+}, Z = r.Feature;
+function Vt(e, t) {
+	let n = new z();
+	n.h1(`Workbook — ${e.getName() ?? "Untitled"}`), n.text(`Locale: ${e.getRuntime().getLocale()}`), n.blank();
+	let r = e.getSheets().getItems({ visibility: l.Visibility.VeryHidden }), i = e.getSelectedSheet(), a = [];
+	for (let e of r) {
+		let t = e.getUsedRange();
+		a.push({
+			sheet: e,
+			label: Ht(e, e.getId() === i.getId()),
+			used: t?.toString() ?? "empty",
+			counts: t?.getCounts([
+				Z.Contentful,
+				Z.Formula,
+				Z.Error,
+				Z.CalcError
+			]) ?? null
+		});
+	}
+	let o = a;
+	if (a.length > 50) {
+		o = a.slice(0, 50);
+		let e = a.find((e) => e.sheet.getId() === i.getId());
+		e && !o.includes(e) && (o[o.length - 1] = e);
+	}
+	n.h2(`Sheets (${a.length})`);
+	let s = n.beginFrame([
+		"Sheet",
+		"Used",
+		"Cells",
+		"Formulas",
+		"Errors"
+	]);
+	for (let e of o) s.addRow([
+		{ text: e.label },
+		{ text: e.used },
+		{
+			text: String(e.counts?.[Z.Contentful] ?? 0),
+			alignment: "right"
+		},
+		{
+			text: String(e.counts?.[Z.Formula] ?? 0),
+			alignment: "right"
+		},
+		{
+			text: String(e.counts?.[Z.Error] ?? 0),
+			alignment: "right"
+		}
+	]);
+	if (a.length > 1) {
+		let e = (e) => a.reduce((t, n) => t + (n.counts?.[e] ?? 0), 0);
+		s.addRow([
+			{ text: "Total" },
+			{ text: "" },
+			{
+				text: String(e(Z.Contentful)),
+				alignment: "right"
+			},
+			{
+				text: String(e(Z.Formula)),
+				alignment: "right"
+			},
+			{
+				text: String(e(Z.Error)),
+				alignment: "right"
+			}
+		]);
+	}
+	s.endFrame(), o.length < a.length && n.text(`  …and ${a.length - o.length} more sheets · the totals include them · wb.getSheets().getItems() lists all`), n.blank(), Ut(n, "Errors", a, Z.Error), Ut(n, "Calc Failures", a, Z.CalcError), K(n, e.getNames().getItems({
+		type: "formula",
+		includeHidden: !0
+	}) ?? [], {
+		maxNames: t?.maxNames ?? 30,
+		recovery: "wb.getNames() renders the full view",
+		symbols: e.getNames().getItems({ includeHidden: !0 }) ?? []
+	});
+	let c = t?.maxSheets ?? 8, u = a.filter((e) => e.sheet.getUsedRange() !== null), d = u.slice(0, c), f = u.find((e) => e.sheet.getId() === i.getId());
+	f && !d.includes(f) && (d[d.length - 1] = f), n.setHeadingOffset(1);
+	for (let e of d) {
+		let r = e.sheet.getUsedRange();
+		r && (n.h1(`Sheet — ${e.label}`), W(n, r), Ve(n, r, {
+			features: t?.features,
+			maxRegions: t?.maxRegions ?? 25,
+			profile: !0,
+			maxProfiled: t?.maxProfiled ?? 4
+		}), J(n, r));
+	}
+	return n.setHeadingOffset(0), d.length < u.length && n.text(`…and ${u.length - d.length} more sheets not expanded · a sheet report (\`wb.getSheet('Name')\`) renders one in full`), n.toLines().join("\n").trimEnd();
+}
+function Ht(e, t) {
+	let n = e.getVisibility(), r = "";
+	return t && (r += " (selected)"), n === l.Visibility.Hidden ? r += " (hidden)" : n === l.Visibility.VeryHidden && (r += " (very hidden)"), `${H(e.getName())}${r}`;
+}
+function Ut(e, t, n, r) {
+	let i = n.reduce((e, t) => e + (t.counts?.[r] ?? 0), 0);
+	if (i === 0) return;
+	let a = [], o = 0;
+	for (let e of n) {
+		if (!e.counts?.[r]) continue;
+		let t = e.sheet.getUsedRange();
+		if (!t) continue;
+		let n = H(e.sheet.getName());
+		for (let e of t.getRegions(r)) o++, a.length >= 20 || a.push({
+			address: `${n}!${e.toString()}`,
+			size: `${e.getRowCount()}×${e.getColumnCount()}`,
+			payload: Wt(e)
+		});
+	}
+	e.h2(`${t} (${i})`);
+	let s = Math.max(0, ...a.map((e) => e.address.length)), c = Math.max(0, ...a.map((e) => e.size.length));
+	for (let t of a) e.text(`  ${t.address.padEnd(s)}  ${t.size.padEnd(c)}  ${t.payload}`.trimEnd());
+	o > a.length && e.text(`  …and ${o - a.length} more · getRegions('${r}') on a sheet's used range lists the rest`), e.blank();
+}
+function Wt(e) {
+	let t = e.getCell(), n = g(t, p.Mode.Display)?.display ?? "", r = t.getFormulaText();
+	return r ? `${n}  =${r}`.trim() : n;
+}
+var Q = (e, t) => !!e && typeof e == "object" && !0 === e[t], Gt = [
+	{
+		kind: "workbook",
+		is: (e) => Q(e, "isIWorkbook"),
+		render: (e, t) => Vt(e, t)
+	},
+	{
+		kind: "sheet",
+		is: (e) => Q(e, "isISheet"),
+		render: (e, t) => Pt(e, t)
+	},
+	{
+		kind: "cell",
+		is: (e) => Q(e, "isICell"),
+		render: (e, t) => st(e, t)
+	},
+	{
+		kind: "names",
+		is: (e) => Q(e, "isINamedCollection"),
+		render: (e, t) => kt(e, t)
+	},
+	{
+		kind: "formula",
+		is: (e) => Q(e, "isIFormula"),
+		render: (e, t) => Dt(e, t)
+	},
+	{
+		kind: "table",
+		is: (e) => Q(e, "isITable"),
+		render: (e) => Ne(e)
+	},
+	{
+		kind: "movable",
+		is: (e) => Q(e, "isIMovable"),
+		render: (e) => pt(e)
+	},
+	{
+		kind: "conditionalFormat",
+		is: (e) => Q(e, "isIConditionalFormat"),
+		render: (e) => ht(e)
+	},
+	{
+		kind: "dataValidation",
+		is: (e) => Q(e, "isIDataValidation"),
+		render: (e) => _t(e)
+	},
+	{
+		kind: "stats",
+		is: (e) => Q(e, "isIRangeStats"),
+		render: (e) => It(e)
+	},
+	{
+		kind: "counts",
+		is: (e) => Q(e, "isICellRangeCounts"),
+		render: (e) => gt(e)
+	},
+	{
+		kind: "style",
+		is: (e) => Q(e, "isIStyle"),
+		render: (e) => Lt(e)
+	},
+	{
+		kind: "regions",
+		is: (e) => Q(e, "isICellRegions"),
+		render: (e, t) => je(e, t)
+	},
+	{
+		kind: "cellRange",
+		is: (e) => Q(e, "isICellRange"),
+		render: (e, t) => mt(e, t)
+	},
+	{
+		kind: "ranges",
+		is: (e) => Q(e, "isICellRanges"),
+		render: (e, t) => Nt(e, t)
+	},
+	{
+		kind: "range",
+		is: (e) => Q(e, "isIRange"),
+		render: (e, t) => Rt(e, t)
+	},
+	{
+		kind: "values",
+		is: (e) => Array.isArray(e) && e.length > 0 && e.every((e) => Array.isArray(e)),
+		render: (e, t) => Rt(e, t)
+	},
+	{
+		kind: "records",
+		is: (e) => Array.isArray(e) && e.length > 0 && e.every(Y),
+		render: (e, t) => At(e, t)
+	},
+	{
+		kind: "record",
+		is: (e) => Y(e),
+		render: (e, t) => At(e, t)
+	},
+	{
+		kind: "items",
+		is: (e) => Array.isArray(e) && e.length > 0 && e.every((e) => !!$(e)),
+		render: async (e, t) => {
+			let n = e.length > 20 ? e.slice(0, 20) : e, r = [];
+			for (let e of n) r.push(await $(e).render(e, t));
+			return n.length < e.length && r.push(`…and ${e.length - n.length} more · render one at a time to see them`), r.join("\n\n");
+		}
+	}
+], Kt = class extends Error {
+	constructor(e) {
+		super(e), this.name = "NoRendererError";
+	}
+};
+function $(e) {
+	for (let t of Gt) if (t.is(e)) return t;
+	return null;
+}
+async function qt(e, t, n) {
+	await e?.getCalculation().ready();
+	let r = $(t), i = t;
+	if (!r && i && typeof i == "object" && !Array.isArray(i) && typeof i[Symbol.iterator] == "function") {
+		let e = [];
+		for (let t of i) if (e.push(t), e.length >= 1e3) break;
+		i = e, r = $(i);
+	}
+	if (!r) throw new Kt(`No markdown renderer for this value. Renderable kinds: ${Gt.map((e) => e.kind).join(", ")}.`);
+	return r.render(i, n);
+}
+async function Jt(e, t, n) {
+	if (t === void 0) return {
+		text: void 0,
+		rendered: !0
+	};
+	if (typeof t == "string") return {
+		text: t,
+		rendered: !0
+	};
+	if (typeof t == "object" && t) try {
+		return {
+			text: await qt(e, t, n),
+			rendered: !0
+		};
+	} catch (e) {
+		if (!(e instanceof Kt)) throw e;
+	}
+	return function(e) {
+		if (e === null) return {
+			text: "null",
+			rendered: !0
+		};
+		switch (typeof e) {
+			case "number":
+			case "boolean": return {
+				text: _(e)?.display ?? String(e),
+				rendered: !0
+			};
+			case "bigint":
+			case "symbol": return {
+				text: String(e),
+				rendered: !0
+			};
+			case "function": return {
+				text: "[Function]",
+				rendered: !0
+			};
+		}
+		let t = e;
+		if (!0 === t.isFormulaError || !0 === t.isIRichData) return {
+			text: _(e)?.display ?? "",
+			rendered: !0
+		};
+		let n;
+		try {
+			n = String(e);
+		} catch {
+			n = "[object Object]";
+		}
+		return {
+			text: n,
+			rendered: !1
+		};
+	}(t);
+}
+var Yt = [T];
+export { p as CellEncoding, y as GREP_FIELDS, b as GREP_FIELDS_DEFAULT, v as GrepField, z as MarkdownBuilder, Oe as MarkdownFrameSection, Kt as NoRendererError, Gt as RENDERERS, at as RENDER_OPTION_KEYS, Pe as REPORTED_FEATURES, Yt as TOOLS, q as appendDependencies, W as appendKinds, ft as appendMovables, K as appendNames, Ae as appendRegionList, Ve as appendRegions, rt as appendRules, J as appendSheetObjects, Me as appendTableDetails, P as countDates, ue as describeAlignment, ve as describeAllowedValues, oe as describeBorder, ce as describeBorderParts, D as describeColor, k as describeConditionalFormat, _e as describeDataValidation, V as describeExtent, ae as describeFill, de as describeFont, tt as describeNode, et as describeNodeLabel, le as describeNumberFormat, U as describeQualifiedExtent, G as describeQualifiedName, Be as describeQualifiedRanges, ze as describeRanges, pe as describeRuleStyle, A as describeRules, he as describeScale, Re as describeSheetCall, H as describeSheetName, g as encodeCell, h as encodeFormattedNumber, m as encodeNumber, _ as encodeScalar, C as grep, T as grepTool, Y as isPlainRecord, Le as parseFeatures, ot as parseRenderOptions, Se as profileKinds, M as profileRegion, Ee as regionPayload, De as regionPayloads, st as renderCell, mt as renderCellRange, ht as renderConditionalFormat, gt as renderCounts, _t as renderDataValidation, Dt as renderFormula, w as renderGrep, qt as renderMarkdown, pt as renderMovable, kt as renderNames, Nt as renderRanges, At as renderRecords, je as renderRegions, Jt as renderResult, Pt as renderSheet, It as renderStats, Lt as renderStyle, Ne as renderTable, Rt as renderValues, Vt as renderWorkbook, $ as resolveRenderer };