@sheetxl/studio-vanilla 0.8.0-beta.10 → 0.8.0-beta.12

package/browser/esm/DasqwTiX41sYA-Z5.mjs

@@ -0,0 +1,496 @@
+/**
+* @license @sheetxl/studio-vanilla - SheetXL Studio - Vanilla entry point for integrating SheetXL UI. - v0.8.0-beta.12
+*
+* (C) 2026-present SheetXL Inc. & Michael T. Ford
+* License: The license can be found at https://www.sheetxl.com/license.
+*/
+import { r as e } from "./Cf_c9xyOrFxlsKq6.mjs";
+import { i as t, r as n } from "./D29bSsh1Lz8891Rs.mjs";
+import { l as r, m as i } from "./Cif0315haNLmyMj-.mjs";
+import { r as a } from "./BoYTs2k2yWAKW5LM.mjs";
+import { bt as o, dt as s, et as c, z as l } from "./B1mhVM8eRIyuL-VB.mjs";
+import { t as u } from "./CuuWjNFFRxXfbQnD.mjs";
+import { tt as d } from "./COPR5sXYEAeM73Ep.mjs";
+import { t as f } from "./DAOjpr33PSwrKpc0.mjs";
+import { E as p, M as m, O as h, V as g, f as _ } from "./DJpfJorMrLhI9gOT.mjs";
+import { t as v } from "./BIX8xNwuEM4TocmY.mjs";
+import { t as y } from "./Bs9KvD8n3018Rkew.mjs";
+import { n as b, t as x } from "./IHk5INXMVCzM8mcG.mjs";
+import { t as S } from "./CrIHwDDOUDcx5WSM.mjs";
+import { n as C } from "./BqPEItNoP2iZ2lkz.mjs";
+import { n as w } from "./D9ukH57ON841L8l9.mjs";
+import { i as T } from "./Ovh5ic9JtH6cyxub.mjs";
+import { c as E } from "./CASTsylgIqgqFwk2.mjs";
+import { t as D } from "./BvcoyRz135FDHoTf.mjs";
+var O = e(t(), 1), k = e(n(), 1), A = (e) => e.getType() === "formula", j = (e) => {
+	try {
+		return A(e) ? String(e.getValue() ?? "") : e.getRanges?.()?.toString() ?? "";
+	} catch {
+		return "";
+	}
+}, M = (e) => {
+	try {
+		return e.getRanges(e.getWorksheet().getSelectedRange()).getFixed(!0).toString();
+	} catch {
+		return "";
+	}
+}, N = (e, t) => t ? {
+	name: t.getName(),
+	expression: j(t),
+	scope: t.getScope(),
+	comment: t.getComment() ?? "",
+	hidden: t.isHidden(),
+	editable: A(t)
+} : {
+	name: e.getNames().findValidName("Name"),
+	expression: M(e),
+	scope: null,
+	comment: "",
+	hidden: !1,
+	editable: !0
+}, P = (e, t, n) => {
+	let i = t.name.trim(), a = t.expression.trim().replace(/^=\s*/, "").trim(), o = t.comment.trim(), s = t.scope || null;
+	if (!i) throw Error(r("error.named.nameEmpty"));
+	if (!a) throw Error(r("named.expressionRequired"));
+	if (n !== null) {
+		if (i.toLowerCase() !== n.getName().toLowerCase() && e.getNames().validateName(i, s ?? void 0), (n.getScope() ?? null) !== s) {
+			if (!t.editable || !n.delete) throw Error(r("error.named.nameReadonly"));
+			let c = e.getTransactions().beginCommit({ description: r("op.updateNamed", { name: i }) });
+			try {
+				n.delete(), e.getCalculation().getNamedFormulas().add({
+					name: i,
+					expression: a,
+					scope: s,
+					comment: o || void 0,
+					hidden: t.hidden || void 0
+				}), c.commit();
+			} catch (e) {
+				throw c.rollback(), e;
+			}
+			return;
+		}
+		n.doBatch(() => {
+			i !== n.getName() && n.setName(i), t.editable && a !== j(n) && n.setExpression(a), (n.getComment() ?? "") !== o && n.setComment(o || null), n.isHidden() !== t.hidden && n.setHidden?.(t.hidden);
+		}, { description: r("op.updateNamed", { name: i }) });
+	} else e.getCalculation().getNamedFormulas().add({
+		name: i,
+		expression: a,
+		scope: s,
+		comment: o || void 0,
+		hidden: t.hidden || void 0
+	});
+}, F = {
+	table: "Table",
+	range: "NamedRange",
+	formula: "Function"
+}, I = {
+	table: i("named.kindTable"),
+	range: i("named.kindRange"),
+	formula: i("named.kindFormula")
+}, L = (e) => {
+	if (!A(e)) return "table";
+	try {
+		return e.getRanges?.() ? "range" : "formula";
+	} catch {
+		return "formula";
+	}
+}, R = (0, O.memo)((e) => {
+	let { kind: t, size: n = 28, ...r } = e, i = s();
+	return (0, k.jsx)(C, {
+		className: "sxl-named-kind-chip",
+		title: i(I[t]),
+		sx: {
+			width: "auto",
+			minWidth: 1.7 * n + "px",
+			height: `${n}px`,
+			color: t === "table" ? "primary.main" : "text.secondary"
+		},
+		...r,
+		children: (0, k.jsx)(a, {
+			iconKey: F[t],
+			size: Math.round(.7 * n)
+		})
+	});
+});
+R.displayName = "NamedKindChip";
+var z = "
workbook", B = (0, O.memo)((e) => {
+	let { draft: t, workbook: n } = e, r = s(), [i] = (0, O.useState)(() => t.name), [a] = (0, O.useState)(() => t.expression), [o, c] = (0, O.useState)(null), [u, d] = (0, O.useState)(() => t.scope), [p, h] = (0, O.useState)(() => t.comment), [_, C] = (0, O.useState)(() => t.hidden), [D, A] = (0, O.useState)(() => t.editable ? ((e, t) => {
+		let n = t.trim().replace(/^=\s*/, "");
+		if (!n) return "formula";
+		try {
+			return e.createFormula(n, void 0, { target: "display" }).isReferenceOnly() ? "range" : "formula";
+		} catch {
+			return "formula";
+		}
+	})(n, t.expression) : "table"), j = !t.editable, M = l((e) => {
+		e.trim().toLowerCase() !== i.toLowerCase() && n.getNames().validateName(e.trim(), u ?? void 0);
+	}, [
+		n,
+		i,
+		u
+	]), N = (0, O.useMemo)(() => {
+		try {
+			return n.getWorksheets().getItems().map((e) => e.getName());
+		} catch {
+			return [];
+		}
+	}, [n]);
+	return (0, k.jsx)(g, {
+		tabIndex: 0,
+		className: T["editor-panel"],
+		sx: {
+			gap: (e) => e.spacing(1),
+			paddingTop: (e) => e.spacing(1.25),
+			paddingBottom: (e) => e.spacing(2),
+			paddingLeft: (e) => e.spacing(1.5),
+			paddingRight: (e) => e.spacing(1.5),
+			border: (e) => `1px solid ${e.palette.divider}`,
+			borderRadius: (e) => e.spacing(1.25),
+			overflow: "auto"
+		},
+		children: (0, k.jsxs)(f, {
+			sx: {
+				display: "flex",
+				flexDirection: "column",
+				gap: (e) => e.spacing(2),
+				margin: (e) => e.spacing(1.25)
+			},
+			children: [
+				(0, k.jsxs)(f, { children: [(0, k.jsxs)(f, {
+					sx: {
+						display: "flex",
+						alignItems: "flex-end",
+						gap: (e) => e.spacing(1.5)
+					},
+					children: [(0, k.jsx)(R, {
+						kind: D,
+						size: 48
+					}), (0, k.jsx)(E, {
+						label: r("named.name"),
+						sx: {
+							flex: "1 1 auto",
+							minWidth: 0
+						},
+						helperText: null,
+						showError: !1,
+						onChangeError: c,
+						disabled: j,
+						value: i,
+						onValidate: M,
+						onChangeText: (e) => {
+							t.name = e;
+						}
+					})]
+				}), (0, k.jsx)(b, {
+					error: !!o,
+					sx: {
+						marginTop: (e) => e.spacing(.5),
+						marginX: "14px"
+					},
+					children: o ? r(o) : " "
+				})] }),
+				(0, k.jsx)(w, {
+					label: r("named.refersTo"),
+					value: a,
+					workbook: n,
+					disabled: j,
+					helperText: r("named.refersToHelp"),
+					equals: "required",
+					pickAs: "absolute",
+					onChangeText: (e) => {
+						t.expression = e;
+					},
+					onChangeInput: (e) => {
+						e && A(e.isReferenceOnly() ? "range" : "formula");
+					}
+				}),
+				(0, k.jsxs)(x, {
+					label: r("named.scope"),
+					size: "small",
+					fullWidth: !0,
+					select: !0,
+					disabled: j,
+					value: u ?? z,
+					helperText: r("named.scopeHelp"),
+					onChange: (e) => {
+						let n = e.target.value === z ? null : e.target.value;
+						d(n), t.scope = n;
+					},
+					children: [(0, k.jsx)(S, {
+						value: z,
+						children: r("named.scopeWorkbook")
+					}), N.map((e) => (0, k.jsx)(S, {
+						value: e,
+						children: e
+					}, e))]
+				}),
+				(0, k.jsx)(x, {
+					label: r("named.comment"),
+					size: "small",
+					fullWidth: !0,
+					multiline: !0,
+					minRows: 2,
+					maxRows: 4,
+					disabled: j,
+					value: p,
+					onChange: (e) => {
+						h(e.target.value), t.comment = e.target.value;
+					}
+				}),
+				(0, k.jsx)(y, {
+					control: (0, k.jsx)(v, {
+						size: "small",
+						disabled: j,
+						checked: _,
+						onChange: (e) => {
+							C(e.target.checked), t.hidden = e.target.checked;
+						}
+					}),
+					label: (0, k.jsx)(m, {
+						variant: "body2",
+						children: r("named.hidden")
+					})
+				}),
+				(0, k.jsx)(m, {
+					variant: "caption",
+					sx: {
+						color: "text.secondary",
+						marginTop: "-12px"
+					},
+					children: r("named.hiddenHelp")
+				}),
+				j ? (0, k.jsx)(m, {
+					variant: "caption",
+					sx: {
+						color: "text.secondary",
+						fontStyle: "italic"
+					},
+					children: r("named.derivedReadOnly")
+				}) : null
+			]
+		})
+	});
+});
+B.displayName = "NamedEditorPanel";
+var V = (0, O.memo)((e) => {
+	let { named: t, label: n, helperText: r } = e, i = s(), a = c(), l = d();
+	u(t, ["onAnyChange", "onRangesChange"]);
+	let f = A(t) && !t.isReadOnly() && (l?.getProtection().isStructureAllowed() ?? !0), p = (0, O.useCallback)((e, n) => {
+		if (n.reason !== "accept") return;
+		let r = e?.getExpression()?.trim();
+		if (r && r !== j(t)) try {
+			t.setExpression(r);
+		} catch (e) {
+			a.showMessage?.(e.message, { type: o.Error });
+		}
+	}, [t, a]);
+	return (0, k.jsx)(w, {
+		value: j(t),
+		equals: "required",
+		pickAs: "absolute",
+		changeOn: "done",
+		onDone: p,
+		label: n === void 0 ? i("named.refersTo") : n,
+		helperText: r,
+		disabled: !f
+	});
+});
+V.displayName = "NamedExpressionField";
+var H = /^_xlnm\./i, U = ({ item: e, workbook: t }) => {
+	let n = s(), r = ((e, t) => {
+		let [n, r] = (0, O.useState)(null);
+		return (0, O.useEffect)(() => {
+			let n = e;
+			if (typeof n.getDirectDependents != "function") return;
+			let i = !0, a = () => {
+				n.getDirectDependents().then((e) => {
+					i && r(((e) => {
+						if (!e) return 0;
+						let t = e.getCoords(), n = 0;
+						for (let r = 0; r < e.getCount(); r++) {
+							if (e.at(r).isINamedRange) {
+								n++;
+								continue;
+							}
+							let i = t[r];
+							n += (i.rowEnd - i.rowStart + 1) * (i.colEnd - i.colStart + 1);
+						}
+						return n;
+					})(e));
+				}).catch(() => {});
+			};
+			a();
+			let o = t.getCalculation().addListeners({ onComplete: a }, { transactional: !1 });
+			return () => {
+				i = !1, o?.();
+			};
+		}, [e, t]), n;
+	})(e, t), i = e.getScope(), a = e.getComment(), o = r !== null && !H.test(e.getName()), c = [i ? n("named.scopedTo", { scope: i }) : n("named.scopeWorkbook")];
+	return e.isHidden() && c.push(n("named.hidden")), (0, k.jsxs)(k.Fragment, { children: [(0, k.jsxs)(f, {
+		sx: {
+			display: "flex",
+			alignItems: "center",
+			gap: 1
+		},
+		children: [(0, k.jsx)(m, {
+			variant: "caption",
+			sx: {
+				flex: "1 1 auto",
+				color: (e) => e.palette.text.secondary
+			},
+			children: c.join(" · ")
+		}), o ? (0, k.jsx)(_, {
+			disableInteractive: !0,
+			title: n("named.references", { count: r }),
+			children: (0, k.jsx)(h, {
+				size: "small",
+				variant: "outlined",
+				label: r.toLocaleString(),
+				"aria-label": n("named.references", { count: r }),
+				sx: {
+					height: 20,
+					color: r === 0 ? "text.disabled" : void 0
+				}
+			})
+		}) : null]
+	}), a ? (0, k.jsx)(m, {
+		variant: "caption",
+		sx: {
+			color: (e) => e.palette.text.secondary,
+			fontStyle: "italic"
+		},
+		children: a
+	}) : null] });
+}, W = (0, O.memo)((0, O.forwardRef)((e, t) => {
+	let { workbook: n, args: r, ...a } = e, l = s(), u = c(), d = ((e) => {
+		let [t, n] = (0, O.useState)(0), [r, i] = (0, O.useState)(0);
+		return (0, O.useEffect)(() => {
+			let t = () => i((e) => e + 1), n = e.getNames().addListeners({
+				onCollectionChange: t,
+				onInvalidated: t
+			}, { transactional: !1 }), r = e.getCalculation().addListeners({ onComplete: t }, { transactional: !1 });
+			return () => {
+				n?.(), r?.();
+			};
+		}, [e]), (0, O.useEffect)(() => {
+			if (!e.getProtection().isStructureAllowed()) return void n(0);
+			let t = !0;
+			return e.getNames().removeUnused({
+				hiddenOnly: !0,
+				dryRun: !0
+			}).then((e) => {
+				t && n(e);
+			}).catch(() => {}), () => {
+				t = !1;
+			};
+		}, [e, r]), {
+			count: t,
+			remove: (0, O.useCallback)(async () => {
+				await e.getNames().removeUnused({ hiddenOnly: !0 });
+			}, [e])
+		};
+	})(n), f = (0, O.useMemo)(() => ((e) => ({
+		key: "named",
+		messageKeys: {
+			none: i("named.none"),
+			addPrompt: i("named.addPrompt"),
+			heading: i("named.heading"),
+			insert: i("named.insert"),
+			new: i("named.new"),
+			edit: i("named.edit"),
+			delete: i("named.delete"),
+			cancel: i("named.cancel"),
+			save: i("named.save"),
+			search: i("named.search"),
+			clearSearch: i("named.clearSearch"),
+			noMatches: i("named.noMatches")
+		},
+		getItems: (e) => e.getNames().getItems(),
+		subscribe: (e, t) => {
+			let n = e.getNames().addListeners({
+				onCollectionChange: () => t.onChange(),
+				onInvalidated: () => t.onChange()
+			}, { transactional: !1 }), r = e.addListeners({
+				onSheetsChange: () => t.onChange(),
+				onProtectionChange: () => t.onChange()
+			}, { transactional: !1 });
+			return () => {
+				n?.(), r?.();
+			};
+		},
+		isReadOnly: (e) => !e.getProtection().isStructureAllowed(),
+		isItemReadOnly: (e, t) => !t.getProtection().isStructureAllowed() || L(e) === "table" || e.isReadOnly(),
+		getItemKey: (e) => e.getId(),
+		subscribeItem: (e, t) => e.addListeners({
+			onAnyChange: () => t(),
+			onInvalidated: () => t()
+		}, { transactional: !1 }),
+		createDraft: N,
+		save: P,
+		delete: (e) => {
+			e.delete?.();
+		},
+		select: (e) => {
+			Promise.resolve(e.select()).catch(() => {});
+		},
+		getSearchText: (e, t) => [
+			e.getName(),
+			j(e),
+			e.getScope() ?? t("named.scopeWorkbook"),
+			e.getComment() ?? ""
+		].join("\n"),
+		getCardTitle: (e) => e.getName(),
+		CardMedia: ({ item: e }) => (0, k.jsx)(R, {
+			kind: L(e),
+			size: 32
+		}),
+		CardSubtitle: ({ item: e }) => (0, k.jsx)(V, {
+			named: e,
+			label: null,
+			helperText: null
+		}),
+		CardBody: (t) => (0, k.jsx)(U, {
+			...t,
+			workbook: e
+		}),
+		EditorBody: ({ draft: e, workbook: t }) => (0, k.jsx)(B, {
+			draft: e,
+			workbook: t
+		})
+	}))(n), [n]), m = (0, O.useMemo)(() => d.count === 0 ? null : (0, k.jsx)(p, {
+		size: "small",
+		sx: {
+			textTransform: "none",
+			width: "100%"
+		},
+		onClick: () => {
+			d.remove().catch((e) => {
+				u.showMessage?.(e.message, { type: o.Error });
+			});
+		},
+		children: l("named.removeUnusedHidden", { count: d.count })
+	}), [
+		d,
+		u,
+		l
+	]);
+	return (0, k.jsx)(D, {
+		ref: t,
+		workbook: n,
+		descriptor: f,
+		args: r,
+		footer: m,
+		...a
+	});
+}));
+W.displayName = "NamedDetailsPanel";
+var G = (e) => {
+	let { model: t, entryKey: n, frame: r, args: i, ref: a, ...o } = e;
+	return (0, k.jsx)(W, {
+		ref: a,
+		workbook: t,
+		args: i,
+		...o
+	});
+};
+export { G as NamedDetailsTaskPane };