@sheetxl/sdk 0.7.28-beta.4 → 0.8.0-beta.10

package/browser/esm/o8MFgcVXns987D6_.mjs

@@ -0,0 +1,400 @@
+/**
+* @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.8.0-beta.10
+*
+* (C) 2026-present SheetXL Inc. & Michael T. Ford
+* License: The license can be found at https://www.sheetxl.com/license.
+*/
+import { t as e } from "./D4uVlrG0xEFctsSM.mjs";
+import { FormulaError as t } from "@sheetxl/primitives";
+import { messageKey as n } from "@sheetxl/utils";
+var r = ["linkedCell", "listFillRange"], i = /^(?:'((?:[^']|'')+)'|([^'!]+))!([^!]+)$/, a = Object.freeze([]), o = n("op.setControlCaption"), s = n("op.setControlMacro"), c = n("op.setControlLink"), l = n("op.setControlValue"), u = n("op.setControlRange"), d = n("op.setControlItems"), f = class extends e {
+	constructor(t) {
+		let n = t.typeDescription ?? "Control", r = t.name;
+		!r && t.getMovable && (r = `${n} ${++e.instanceCounter}`), super({
+			...t,
+			name: r
+		}), this._references = [], this._type = t.type, this._typeDescription = n, t.json && (this._updateState({ data: t.json }), this._reconcileReferences());
+	}
+	getType() {
+		return this._type;
+	}
+	getTypeDescription() {
+		return this._typeDescription;
+	}
+	getShapeId() {
+		return this._data()?.shapeId ?? null;
+	}
+	_getSourceId() {
+		return this._data()?.shapeId ?? void 0;
+	}
+	_ensureSourceId(e) {
+		let t = this._data()?.shapeId;
+		if (typeof t == "number") return t;
+		let r = e();
+		return this._set({ shapeId: r }, n("op.connectShape")), r;
+	}
+	getMacro() {
+		return this._data()?.macro ?? null;
+	}
+	setMacro(e, t) {
+		return this._set({ macro: e ?? void 0 }, s, t);
+	}
+	toJSON(e) {
+		let t = this._data();
+		if (!t) return null;
+		let n = { ...t };
+		for (let e of r) {
+			let t = this._reference(e);
+			t !== null && (n[e] = t);
+		}
+		let i = this._linkedState();
+		if (i) for (let e in i) {
+			let t = i[e];
+			t === void 0 ? delete n[e] : n[e] = t;
+		}
+		return n;
+	}
+	get isIFormControl() {
+		return !0;
+	}
+	_data() {
+		return this._getState()?.data ?? null;
+	}
+	_reference(e) {
+		let t = this._data()?.[e];
+		if (!t) return null;
+		let n = this._referenceOf(t), r = n?.formula?.getExpression() ?? null;
+		if (r === null || r === n.wired) return t;
+		if (t.includes("!")) return r;
+		let a = i.exec(r);
+		if (!a) return r;
+		let o = a[1] === void 0 ? a[2] : a[1].replace(/''/g, "'"), s = this.getMovable()?.getRange().getSheet().getName();
+		return s && s.toLowerCase() === o.toLowerCase() ? a[3] : r;
+	}
+	_linkedRange(e = this._reference("linkedCell")) {
+		if (!e || e.includes("#REF!")) return null;
+		try {
+			return e.includes("!") ? this._resolveRange(e) : this.getMovable()?.getRange().getSheet().getRange(e) ?? null;
+		} catch {
+			return null;
+		}
+	}
+	_linkedValue() {
+		let e = this._linkedRange();
+		return e ? e.getValue() : void 0;
+	}
+	_linkedState() {
+		return null;
+	}
+	_referenceOf(e) {
+		for (let t = 0; t < this._references.length; t++) if (this._references[t].source === e) return this._references[t];
+	}
+	_reconcileReferences() {
+		let e = this._data(), t = /* @__PURE__ */ new Set();
+		for (let n of r) {
+			let r = e?.[n];
+			typeof r == "string" && r && t.add(r);
+		}
+		for (let e of this._references) t.delete(e.source) ? e.remove || this._watch(e) : e.remove &&= (e.remove(), null);
+		for (let e of t) {
+			let t = {
+				source: e,
+				formula: null,
+				wired: null,
+				remove: null
+			};
+			this._references.push(t), this._watch(t);
+		}
+	}
+	_watch(e) {
+		e.remove = this._addWatch(e.formula ?? e.source, (t) => {
+			e.formula = t.formula, e.wired ??= t.formula.getExpression();
+		});
+	}
+	_processRestoreOrRevert(e, t) {
+		super._processRestoreOrRevert(e, t), this.isDeleted() || this._reconcileReferences();
+	}
+	_set(e, t, n) {
+		this._protectionCheck(t);
+		let i = this._data();
+		if (!i) return this;
+		let a = {
+			...i,
+			...e
+		};
+		for (let t in e) a[t] === void 0 && delete a[t];
+		return this._updateState({ data: a }, {
+			...n,
+			description: t
+		}, ["onAnyChange"]), r.some((t) => t in e) && this._reconcileReferences(), this;
+	}
+}, p = class extends f {
+	getCaption() {
+		return this._data()?.caption ?? null;
+	}
+	setCaption(e, t) {
+		return this._set({ caption: e ?? void 0 }, o, t);
+	}
+	getFont() {
+		return this._data()?.font ?? null;
+	}
+}, m = class extends f {
+	getLinkedCell() {
+		return this._reference("linkedCell");
+	}
+	getLinkedRange() {
+		return this._linkedRange(this.getLinkedCell());
+	}
+	setLinkedCell(e, t) {
+		return this._set({ linkedCell: e ?? void 0 }, c, t);
+	}
+}, h = class extends p {
+	getLinkedCell() {
+		return this._reference("linkedCell");
+	}
+	getLinkedRange() {
+		return this._linkedRange(this.getLinkedCell());
+	}
+	setLinkedCell(e, t) {
+		return this._set({ linkedCell: e ?? void 0 }, c, t);
+	}
+}, g = class extends p {
+	constructor(e) {
+		super({
+			...e,
+			type: "button",
+			typeDescription: "Button"
+		});
+	}
+}, _ = class extends p {
+	constructor(e) {
+		super({
+			...e,
+			type: "groupBox",
+			typeDescription: "Group Box"
+		});
+	}
+}, v = class extends p {
+	constructor(e) {
+		super({
+			...e,
+			type: "label",
+			typeDescription: "Label"
+		});
+	}
+}, y = class extends h {
+	constructor(e) {
+		super({
+			...e,
+			type: "checkBox",
+			typeDescription: "Check Box"
+		});
+	}
+	isChecked() {
+		let e = this._linkedState();
+		return e ? !0 === e.checked : !0 === this._data()?.checked;
+	}
+	setChecked(e, t) {
+		let n = this._linkedRange();
+		return n ? (n.setValue(e, t), this) : this._set({
+			checked: e || void 0,
+			mixed: void 0
+		}, l, t);
+	}
+	isMixed() {
+		let e = this._linkedState();
+		return e ? !0 === e.mixed : !0 === this._data()?.mixed;
+	}
+	setMixed(e, n) {
+		let r = this._linkedRange();
+		return r ? (r.setValue(!!e && t.BuiltIn.NA, n), this) : this._set({ mixed: e || void 0 }, l, n);
+	}
+	_linkedState() {
+		let e = this._linkedValue();
+		return e === void 0 ? null : e?.isFormulaError ? {
+			checked: void 0,
+			mixed: e.getCode() === t.Code.NA || void 0
+		} : {
+			checked: !0 === e || typeof e == "number" && e !== 0 || void 0,
+			mixed: void 0
+		};
+	}
+}, b = class e extends h {
+	constructor(e) {
+		super({
+			...e,
+			type: "optionButton",
+			typeDescription: "Option Button"
+		});
+	}
+	getLinkedCell() {
+		let e = super.getLinkedCell();
+		if (e) return e;
+		let t = this._group();
+		for (let e = 0; e < t.length; e++) {
+			let n = t[e] === this ? null : t[e]._ownLinkedCell();
+			if (n) return n;
+		}
+		return null;
+	}
+	isChecked() {
+		let e = this._linkedState();
+		return e ? !0 === e.checked : !0 === this._data()?.checked;
+	}
+	setChecked(e, t) {
+		let n = this._linkedRange(this.getLinkedCell());
+		return n ? (e ? n.setValue(this._group().indexOf(this) + 1, t) : this.isChecked() && n.setValue(null, t), this) : this._set({ checked: e || void 0 }, l, t);
+	}
+	_linkedState() {
+		let e = this._linkedRange(this.getLinkedCell());
+		if (!e) return null;
+		let t = e.getValue();
+		return { checked: typeof t == "number" && t === this._group().indexOf(this) + 1 || void 0 };
+	}
+	_ownLinkedCell() {
+		return super.getLinkedCell();
+	}
+	_group() {
+		let t = this.getMovable()?.getRange().getSheet().getMovables().getItems() ?? [], n = [], r = !1;
+		for (let i = 0; i < t.length; i++) {
+			let a = t[i].getContent();
+			if (a instanceof e) {
+				if (a._data()?.formProps?.firstButton === "1" && n.length > 0) {
+					if (r) break;
+					n = [];
+				}
+				n.push(a), a === this && (r = !0);
+			}
+		}
+		return r ? n : [this];
+	}
+}, x = class extends m {
+	getValue() {
+		let e = this._linkedState();
+		return e ? e.value ?? null : this._data()?.value ?? null;
+	}
+	setValue(e, t) {
+		let n = this._linkedRange();
+		return n ? (n.setValue(e, t), this) : this._set({ value: e ?? void 0 }, l, t);
+	}
+	_linkedState() {
+		let e = this._linkedValue();
+		if (e === void 0) return null;
+		if (typeof e != "number") return { value: this._data()?.value };
+		let t = this.getMin() ?? 0, n = this.getMax() ?? 100;
+		return { value: Math.min(Math.max(e, Math.min(t, n)), Math.max(t, n)) };
+	}
+	getMin() {
+		return this._data()?.min ?? null;
+	}
+	setMin(e, t) {
+		return this._set({ min: e ?? void 0 }, u, t);
+	}
+	getMax() {
+		return this._data()?.max ?? null;
+	}
+	setMax(e, t) {
+		return this._set({ max: e ?? void 0 }, u, t);
+	}
+	getIncrement() {
+		return this._data()?.increment ?? null;
+	}
+	setIncrement(e, t) {
+		return this._set({ increment: e ?? void 0 }, u, t);
+	}
+}, S = class extends x {
+	constructor(e) {
+		super({
+			...e,
+			type: "scrollBar",
+			typeDescription: "Scroll Bar"
+		});
+	}
+	getPageIncrement() {
+		return this._data()?.pageIncrement ?? null;
+	}
+	setPageIncrement(e, t) {
+		return this._set({ pageIncrement: e ?? void 0 }, u, t);
+	}
+	isHorizontal() {
+		let e = this.getMovable()?.getBounds();
+		return e && e.width > 0 && e.height > 0 ? e.width > e.height : !0 === this._data()?.horizontal;
+	}
+	toJSON(e) {
+		let t = super.toJSON(e);
+		return t ? (this.isHorizontal() ? t.horizontal = !0 : delete t.horizontal, t) : null;
+	}
+}, C = class extends x {
+	constructor(e) {
+		super({
+			...e,
+			type: "spinner",
+			typeDescription: "Spinner"
+		});
+	}
+}, w = class extends m {
+	getItems() {
+		return this._data()?.items ?? a;
+	}
+	setItems(e, t) {
+		return this._set({ items: e.length > 0 ? [...e] : void 0 }, d, t);
+	}
+	getListItems() {
+		if (!this.getListFillRange()) return this.getItems();
+		let e = this.getListSourceRange(), t = e?.getUsedRange({ features: [] });
+		if (!e || !t) return a;
+		let n = e.getCoords(), r = Math.min(t.getCoords().rowEnd, n.rowStart + 32767 - 1);
+		return e.getSheet().getRange({
+			rowStart: n.rowStart,
+			colStart: n.colStart,
+			rowEnd: r,
+			colEnd: n.colStart
+		}).getCells().map((e) => e[0].getText({ hideStringPrefix: !0 }));
+	}
+	getListFillRange() {
+		return this._reference("listFillRange");
+	}
+	getListSourceRange() {
+		return this._linkedRange(this.getListFillRange());
+	}
+	setListFillRange(e, t) {
+		return this._set({ listFillRange: e ?? void 0 }, c, t);
+	}
+	getSelectedIndex() {
+		let e = this._linkedState();
+		return e ? e.selectedIndex ?? null : this._data()?.selectedIndex ?? null;
+	}
+	setSelectedIndex(e, t) {
+		let n = this._linkedRange();
+		return n ? (n.setValue(e === null ? null : e + 1, t), this) : this._set({ selectedIndex: e ?? void 0 }, l, t);
+	}
+	_linkedState() {
+		let e = this._linkedValue();
+		if (e === void 0) return null;
+		let t = typeof e == "number" ? Math.trunc(e) : 0;
+		return { selectedIndex: t >= 1 ? t - 1 : void 0 };
+	}
+}, T = class extends w {
+	constructor(e) {
+		super({
+			...e,
+			type: "listBox",
+			typeDescription: "List Box"
+		});
+	}
+}, E = class extends w {
+	constructor(e) {
+		super({
+			...e,
+			type: "dropDown",
+			typeDescription: "Drop Down"
+		});
+	}
+	getDropStyle() {
+		return this._data()?.dropStyle ?? null;
+	}
+	getDropLines() {
+		return this._data()?.dropLines ?? null;
+	}
+};
+export { g as Button, p as CaptionedControl, h as CaptionedLinkedControl, y as CheckBox, E as DropDown, f as FormControl, _ as GroupBox, v as Label, m as LinkedControl, T as ListBox, w as ListControl, b as OptionButton, x as RangedControl, S as ScrollBar, C as Spinner };