@sheetxl/query 0.7.23-beta.1

package/node/esm/index.mjs

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