@sheetxl/sdk 0.8.0-beta.1 → 0.8.0-beta.11

package/node/esm/CzXT00vrQa1_gvW9.mjs

@@ -0,0 +1,28 @@
+/**
+* @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.8.0-beta.11
+*
+* (C) 2026-present SheetXL Inc. & Michael T. Ford
+* License: The license can be found at https://www.sheetxl.com/license.
+*/
+import { readFile as t } from "node:fs/promises";
+import { fileURLToPath as r } from "node:url";
+import { dirname as o, join as n, parse as e } from "node:path";
+async function i(i) {
+	let p = o(r(import.meta.url));
+	const s = e(p).root;
+	for (;;) {
+		for (const r of [`types/${i}`, `build/types/${i}`]) try {
+			return await t(n(p, r), "utf8");
+		} catch {}
+		if (p === s) break;
+		p = o(p);
+	}
+	throw new Error(`Unable to locate ${i}. Run \`pnpm --filter @sheetxl/sdk build:types-scripting\`.`);
+}
+function p() {
+	return i("scripting.d.ts");
+}
+function s() {
+	return i("scripting-api.json");
+}
+export { s as loadScriptingApi, p as loadScriptingDeclarations };

package/node/esm/D1TKBVmoKGAXf37B.mjs

@@ -0,0 +1,402 @@
+/**
+* @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.8.0-beta.11
+*
+* (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 "./2Kihw_-5lVTEnwMa.mjs";
+import { FormulaError as t } from "@sheetxl/primitives";
+import { messageKey as n } from "@sheetxl/utils";
+var s = ["linkedCell", "listFillRange"], r = /^(?:'((?:[^']|'')+)'|([^'!]+))!([^!]+)$/, i = Object.freeze([]), o = n("op.setControlCaption"), l = n("op.setControlMacro"), a = n("op.setControlLink"), c = n("op.setControlValue"), u = n("op.setControlRange"), d = n("op.setControlItems"), h = class extends e {
+	constructor(t) {
+		const n = t.typeDescription ?? "Control";
+		let s = t.name;
+		!s && t.getMovable && (s = `${n} ${++e.instanceCounter}`), super({
+			...t,
+			name: s
+		}), 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) {
+		const t = this._data()?.shapeId;
+		if ("number" == typeof t) return t;
+		const s = e();
+		return this._set({ shapeId: s }, n("op.connectShape")), s;
+	}
+	getMacro() {
+		return this._data()?.macro ?? null;
+	}
+	setMacro(e, t) {
+		return this._set({ macro: e ?? void 0 }, l, t);
+	}
+	toJSON(e) {
+		const t = this._data();
+		if (!t) return null;
+		const n = { ...t };
+		for (const e of s) {
+			const t = this._reference(e);
+			null !== t && (n[e] = t);
+		}
+		const r = this._linkedState();
+		if (r) for (const e in r) {
+			const t = r[e];
+			void 0 === t ? delete n[e] : n[e] = t;
+		}
+		return n;
+	}
+	get isIFormControl() {
+		return !0;
+	}
+	_data() {
+		return this._getState()?.data ?? null;
+	}
+	_reference(e) {
+		const t = this._data()?.[e];
+		if (!t) return null;
+		const n = this._referenceOf(t), s = n?.formula?.getExpression() ?? null;
+		if (null === s || s === n.wired) return t;
+		if (t.includes("!")) return s;
+		const i = r.exec(s);
+		if (!i) return s;
+		const o = void 0 !== i[1] ? i[1].replace(/''/g, "'") : i[2], l = this.getMovable()?.getRange().getWorksheet().getName();
+		return l && l.toLowerCase() === o.toLowerCase() ? i[3] : s;
+	}
+	_linkedRange(e = this._reference("linkedCell")) {
+		if (!e || e.includes("#REF!")) return null;
+		try {
+			return e.includes("!") ? this._resolveRange(e) : this.getMovable()?.getRange().getWorksheet().getRange(e) ?? null;
+		} catch {
+			return null;
+		}
+	}
+	_linkedValue() {
+		const 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() {
+		const e = this._data(), t = /* @__PURE__ */ new Set();
+		for (const n of s) {
+			const s = e?.[n];
+			"string" == typeof s && s && t.add(s);
+		}
+		for (const e of this._references) t.delete(e.source) ? e.remove || this._watch(e) : e.remove && (e.remove(), e.remove = null);
+		for (const e of t) {
+			const 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);
+		const r = this._data();
+		if (!r) return this;
+		const i = {
+			...r,
+			...e
+		};
+		for (const t in e) void 0 === i[t] && delete i[t];
+		return this._updateState({ data: i }, {
+			...n,
+			description: t
+		}, ["onAnyChange"]), s.some((t) => t in e) && this._reconcileReferences(), this;
+	}
+}, g = class extends h {
+	getCaption() {
+		return this._data()?.caption ?? null;
+	}
+	setCaption(e, t) {
+		return this._set({ caption: e ?? void 0 }, o, t);
+	}
+	getFont() {
+		return this._data()?.font ?? null;
+	}
+}, p = class extends h {
+	getLinkedCell() {
+		return this._reference("linkedCell");
+	}
+	getLinkedRange() {
+		return this._linkedRange(this.getLinkedCell());
+	}
+	setLinkedCell(e, t) {
+		return this._set({ linkedCell: e ?? void 0 }, a, t);
+	}
+}, _ = class extends g {
+	getLinkedCell() {
+		return this._reference("linkedCell");
+	}
+	getLinkedRange() {
+		return this._linkedRange(this.getLinkedCell());
+	}
+	setLinkedCell(e, t) {
+		return this._set({ linkedCell: e ?? void 0 }, a, t);
+	}
+}, f = class extends g {
+	constructor(e) {
+		super({
+			...e,
+			type: "button",
+			typeDescription: "Button"
+		});
+	}
+}, k = class extends g {
+	constructor(e) {
+		super({
+			...e,
+			type: "groupBox",
+			typeDescription: "Group Box"
+		});
+	}
+}, m = class extends g {
+	constructor(e) {
+		super({
+			...e,
+			type: "label",
+			typeDescription: "Label"
+		});
+	}
+}, v = class extends _ {
+	constructor(e) {
+		super({
+			...e,
+			type: "checkBox",
+			typeDescription: "Check Box"
+		});
+	}
+	isChecked() {
+		const e = this._linkedState();
+		return e ? !0 === e.checked : !0 === this._data()?.checked;
+	}
+	setChecked(e, t) {
+		const n = this._linkedRange();
+		return n ? (n.setValue(e, t), this) : this._set({
+			checked: e || void 0,
+			mixed: void 0
+		}, c, t);
+	}
+	isMixed() {
+		const e = this._linkedState();
+		return e ? !0 === e.mixed : !0 === this._data()?.mixed;
+	}
+	setMixed(e, n) {
+		const s = this._linkedRange();
+		return s ? (s.setValue(!!e && t.BuiltIn.NA, n), this) : this._set({ mixed: e || void 0 }, c, n);
+	}
+	_linkedState() {
+		const e = this._linkedValue();
+		return void 0 === e ? null : e?.isFormulaError ? {
+			checked: void 0,
+			mixed: e.getCode() === t.Code.NA || void 0
+		} : {
+			checked: !0 === e || "number" == typeof e && 0 !== e || void 0,
+			mixed: void 0
+		};
+	}
+}, x = class e extends _ {
+	constructor(e) {
+		super({
+			...e,
+			type: "optionButton",
+			typeDescription: "Option Button"
+		});
+	}
+	getLinkedCell() {
+		const e = super.getLinkedCell();
+		if (e) return e;
+		const t = this._group();
+		for (let e = 0; e < t.length; e++) {
+			const n = t[e] === this ? null : t[e]._ownLinkedCell();
+			if (n) return n;
+		}
+		return null;
+	}
+	isChecked() {
+		const e = this._linkedState();
+		return e ? !0 === e.checked : !0 === this._data()?.checked;
+	}
+	setChecked(e, t) {
+		const 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 }, c, t);
+	}
+	_linkedState() {
+		const e = this._linkedRange(this.getLinkedCell());
+		if (!e) return null;
+		const t = e.getValue();
+		return { checked: "number" == typeof t && t === this._group().indexOf(this) + 1 || void 0 };
+	}
+	_ownLinkedCell() {
+		return super.getLinkedCell();
+	}
+	_group() {
+		const t = this.getMovable()?.getRange().getWorksheet().getMovables().getItems() ?? [];
+		let n = [], s = !1;
+		for (let r = 0; r < t.length; r++) {
+			const i = t[r].getContent();
+			if (i instanceof e) {
+				if ("1" === i._data()?.formProps?.firstButton && n.length > 0) {
+					if (s) break;
+					n = [];
+				}
+				n.push(i), i === this && (s = !0);
+			}
+		}
+		return s ? n : [this];
+	}
+}, C = class extends p {
+	getValue() {
+		const e = this._linkedState();
+		return e ? e.value ?? null : this._data()?.value ?? null;
+	}
+	setValue(e, t) {
+		const n = this._linkedRange();
+		return n ? (n.setValue(e, t), this) : this._set({ value: e ?? void 0 }, c, t);
+	}
+	_linkedState() {
+		const e = this._linkedValue();
+		if (void 0 === e) return null;
+		if ("number" != typeof e) return { value: this._data()?.value };
+		const 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);
+	}
+}, R = class extends C {
+	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() {
+		const e = this.getMovable()?.getBounds();
+		return e && e.width > 0 && e.height > 0 ? e.width > e.height : !0 === this._data()?.horizontal;
+	}
+	toJSON(e) {
+		const t = super.toJSON(e);
+		return t ? (this.isHorizontal() ? t.horizontal = !0 : delete t.horizontal, t) : null;
+	}
+}, S = class extends C {
+	constructor(e) {
+		super({
+			...e,
+			type: "spinner",
+			typeDescription: "Spinner"
+		});
+	}
+}, y = class extends p {
+	getItems() {
+		return this._data()?.items ?? i;
+	}
+	setItems(e, t) {
+		return this._set({ items: e.length > 0 ? [...e] : void 0 }, d, t);
+	}
+	getListItems() {
+		if (!this.getListFillRange()) return this.getItems();
+		const e = this.getListSourceRange(), t = e?.getUsedRange({ features: [] });
+		if (!e || !t) return i;
+		const n = e.getCoords(), s = Math.min(t.getCoords().rowEnd, n.rowStart + 32767 - 1);
+		return e.getWorksheet().getRange({
+			rowStart: n.rowStart,
+			colStart: n.colStart,
+			rowEnd: s,
+			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 }, a, t);
+	}
+	getSelectedIndex() {
+		const e = this._linkedState();
+		return e ? e.selectedIndex ?? null : this._data()?.selectedIndex ?? null;
+	}
+	setSelectedIndex(e, t) {
+		const n = this._linkedRange();
+		return n ? (n.setValue(null !== e ? e + 1 : null, t), this) : this._set({ selectedIndex: e ?? void 0 }, c, t);
+	}
+	_linkedState() {
+		const e = this._linkedValue();
+		if (void 0 === e) return null;
+		const t = "number" == typeof e ? Math.trunc(e) : 0;
+		return { selectedIndex: t >= 1 ? t - 1 : void 0 };
+	}
+}, L = class extends y {
+	constructor(e) {
+		super({
+			...e,
+			type: "listBox",
+			typeDescription: "List Box"
+		});
+	}
+}, I = class extends y {
+	constructor(e) {
+		super({
+			...e,
+			type: "dropDown",
+			typeDescription: "Drop Down"
+		});
+	}
+	getDropStyle() {
+		return this._data()?.dropStyle ?? null;
+	}
+	getDropLines() {
+		return this._data()?.dropLines ?? null;
+	}
+};
+export { f as Button, g as CaptionedControl, _ as CaptionedLinkedControl, v as CheckBox, I as DropDown, h as FormControl, k as GroupBox, m as Label, p as LinkedControl, L as ListBox, y as ListControl, x as OptionButton, C as RangedControl, R as ScrollBar, S as Spinner };