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

package/browser/esm/{uyWBMSIxMlt8n5Z3.mjs → CaB7J-xgfKO2uAkG.mjs}

@@ -1,11 +1,11 @@
 /**
-* @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.8.0-beta.1
+* @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.
 */
 async function e() {
-	let e = "@0.8.0-beta.1";
+	let e = "@0.8.0-beta.11";
 	e !== "@local" && e !== "@0.0.0" || (e = "");
 	let t = `https://cdn.jsdelivr.net/npm/@sheetxl/sdk${e}/types/scripting-enums.json`, n = await fetch(t);
 	if (!n.ok) throw Error(`Unable to load script enum runtime (${n.status}) from ${t}.`);

package/browser/esm/CkxWugaJFjDGZNZ-.mjs

@@ -0,0 +1,12 @@
+/**
+* @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.
+*/
+function e(e, t) {
+	if (!Number.isFinite(e)) return "0";
+	let n = e.toFixed(t);
+	return n.indexOf(".") >= 0 && (n = n.replace(/\.?0+$/, "")), n === "-0" ? "0" : n;
+}
+export { e as t };

package/browser/esm/ClPfI4lODvCece29.mjs

@@ -0,0 +1,632 @@
+/**
+* @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 "./CU3DmJ-YnVVrC1_k.mjs";
+import { $t as t, Qt as n, Zi as r, Zt as i, ot as a, st as o, vr as s } from "./C16ycKja6zG0crV_.mjs";
+import { g as c, v as l, w as u, x as d } from "./CV5EGEjG5_-CPpP0.mjs";
+import { CommonUtils as f, CoordUtils as p, ExpectedError as m, messageKey as h, t as g } from "@sheetxl/utils";
+var _ = class extends i {
+	constructor(e) {
+		super(e), this._optionsMember = e;
+	}
+	getParent() {
+		return this._optionsMovable.getParent();
+	}
+	getRange(e) {
+		return this.getParent().getRange(e);
+	}
+	getRanges(e) {
+		return this.getParent().getRanges(e);
+	}
+	isDeleted() {
+		return !!super.isDeleted() || ((this._optionsMovable?.getParent?.())?.isDeleted() ?? !1);
+	}
+	getAnchorType() {
+		return s.Type.Absolute;
+	}
+	setAnchorType(e) {
+		return this;
+	}
+	_getLocalPlacement() {
+		let e = this._getState(), t = e?.pixelBounds;
+		return t ? {
+			bounds: t,
+			rotation: e.rotation ?? 0,
+			flip: {
+				horizontal: e.flipH ?? !1,
+				vertical: e.flipV ?? !1
+			}
+		} : null;
+	}
+	_getDrawnPlacement() {
+		let e = this._getLocalPlacement();
+		return e ? this._optionsMember.place(e) : null;
+	}
+	getBounds() {
+		return this._getDrawnPlacement()?.bounds ?? null;
+	}
+	getRotation() {
+		return this._getDrawnPlacement()?.rotation ?? 0;
+	}
+	getFlip() {
+		return this._getDrawnPlacement()?.flip ?? {
+			horizontal: !1,
+			vertical: !1
+		};
+	}
+	setRotation(e = 0) {
+		let t = this._acceptRotation(e);
+		if (t === null) return this;
+		e = t;
+		let n = this._getDrawnPlacement();
+		if (!n || e === n.rotation) return this;
+		let r = this._optionsMember.unplace({
+			...n,
+			rotation: e
+		});
+		if (!r) return this;
+		let i = h("op.setMovableRotation"), a = this._beginCommit(i);
+		try {
+			this._updateState({
+				rotation: r.rotation,
+				pixelBounds: r.bounds
+			}, { description: i }, ["onBoundsChange"]), this._optionsMember.onMemberPlacementChange?.(), this._notifyPlacementChange(), a.commit();
+		} catch (e) {
+			throw a.rollback(), e;
+		}
+		return this;
+	}
+	setFlip(e, t) {
+		let n = this._getDrawnPlacement();
+		if (!n) return this;
+		let r = this._acceptFlip({
+			horizontal: e.horizontal ?? n.flip.horizontal,
+			vertical: e.vertical ?? n.flip.vertical
+		});
+		if (!r) return this;
+		let { horizontal: i, vertical: a } = r;
+		if (i === n.flip.horizontal && a === n.flip.vertical) return this;
+		let o = this._optionsMember.unplace({
+			...n,
+			flip: {
+				horizontal: i,
+				vertical: a
+			}
+		});
+		if (!o) return this;
+		let s = t?.description ?? h("op.setMovableFlip"), c = this._beginCommit(s);
+		try {
+			this._updateState({
+				flipH: o.flip.horizontal,
+				flipV: o.flip.vertical
+			}, { description: s }), this._notifyPlacementChange(), c.commit();
+		} catch (e) {
+			throw c.rollback(), e;
+		}
+		return this;
+	}
+	_getAnchorBounds() {
+		let e = this._getDrawnPlacement();
+		return e ? u(e.bounds, e.rotation) : null;
+	}
+	_setAnchorBounds(e) {
+		let t = this._getDrawnPlacement();
+		if (!t) return;
+		let n = this._optionsMember.unplace({
+			...t,
+			bounds: u(e, t.rotation)
+		});
+		if (!n) return;
+		let r = this._getLocalPlacement();
+		r && c.isSameBounds(r.bounds, n.bounds) || (this._updateState({ pixelBounds: n.bounds }, { description: h("op.updateMovableBounds") }, ["onBoundsChange"]), this._optionsMember.onMemberPlacementChange?.());
+	}
+	_processContainerLayout() {
+		this._getEmitter().notify("onBoundsChange"), this._forwardLayout();
+	}
+	_fromJSON(e) {
+		let t = e.anchor?.tl ?? f.EmptyObject, n = e.anchor?.br ?? f.EmptyObject;
+		this._updateState({
+			offsets: {
+				tl: {
+					x: 0,
+					y: 0
+				},
+				br: {
+					x: 0,
+					y: 0
+				}
+			},
+			hidden: e.hidden ?? !1,
+			rotation: e.rotation ?? 0,
+			flipH: e.flipH ?? !1,
+			flipV: e.flipV ?? !1,
+			lockAspectRatio: e.lockAspect ?? null,
+			locks: e.locks ?? null,
+			anchorType: s.Type.Absolute,
+			pixelBounds: {
+				x: t.x ?? 0,
+				y: t.y ?? 0,
+				width: n.x ?? 0,
+				height: n.y ?? 0
+			}
+		}, { description: h("op.loadMovable") });
+	}
+	_getAnchorJSON() {
+		let e = this._getState()?.pixelBounds ?? {
+			x: 0,
+			y: 0,
+			width: 0,
+			height: 0
+		}, t = (e) => f.roundAccurately(e, 2);
+		return {
+			tl: {
+				x: t(e.x),
+				y: t(e.y)
+			},
+			br: {
+				x: t(e.width),
+				y: t(e.height)
+			}
+		};
+	}
+	toJSON(e) {
+		let t = super.toJSON(e);
+		return delete t.anchorType, t;
+	}
+}, v = class extends r {
+	constructor(e, t) {
+		super(t), this._group = e;
+	}
+	_getItems(e) {
+		let t = this._group._getMembers(), n = e?.type, r = n === void 0 ? null : Array.isArray(n) ? n : [n], i = [];
+		for (let n of t) {
+			if (e?.ignoreHidden && n.isHidden()) continue;
+			r && !r.includes(n.getContent().getType()) || i.push(n);
+			let t = e?.deep ? n.getMovables() : null;
+			t && i.push(...t.getItems(e));
+		}
+		return i;
+	}
+	getCount() {
+		return this._group._getMembers().length;
+	}
+	add(e) {
+		if (!e) throw new m("No movable options provided");
+		return this._group._addMember(e);
+	}
+	_prepare(e) {
+		if (!e) throw new m("No movable options provided");
+		return this._group._prepareMember(e);
+	}
+	_preparePicture(e, t) {
+		let n = this._group.getMovable();
+		if (!n) throw new m("The group is not placed.");
+		let r = n.getRange().getWorksheet().getResources().add(e);
+		return this._group._prepareMember({
+			description: h("op.insertImage"),
+			...t,
+			type: "picture",
+			json: {
+				...t?.json,
+				resId: 0
+			},
+			fromResourceId: () => r
+		});
+	}
+	_insertNow(e) {
+		return this._group._insertMember(e);
+	}
+	async addPicture(e, t) {
+		return this._insertNow(await this._preparePicture(e, t));
+	}
+	group(e, t) {
+		return this._group._groupMembers(e, t);
+	}
+	updateSelected(e, t) {
+		let n = this._group._getMembers().filter((e) => e.isSelected());
+		n.length !== 0 && this._group.doBatch(() => {
+			for (let t of n) e(t);
+		}, { description: t ?? h("op.updateMovables") });
+	}
+	_notifyChange() {
+		this._notifyCollectionChange();
+	}
+	get isIMovableCollection() {
+		return !0;
+	}
+}, y = (e) => e, b = (e) => e, x = Object.freeze([]), S = class extends e {
+	constructor(e) {
+		super(e), this._memberCallbacks = /* @__PURE__ */ new WeakMap(), this._toldOrder = C, this._createOptions = e, this._members = new v(this, e.transactions);
+		let { members: t, name: n, ...r } = e.json ?? {}, i = [];
+		for (let n of t ?? []) try {
+			i.push(this._createMember(n, e.fromResourceId));
+		} catch (e) {
+			console.warn("Unable to load a group member", n, e);
+		}
+		this._updateState({
+			data: r,
+			members: i
+		}), this._toldOrder = i;
+	}
+	getType() {
+		return "group";
+	}
+	getTypeDescription() {
+		return "Group";
+	}
+	getMovables() {
+		return this._members;
+	}
+	_childBounds() {
+		let e = this._getState()?.data?.childBounds;
+		if (e) return e;
+		let t = this.getMovable()?.getBounds();
+		return {
+			x: 0,
+			y: 0,
+			width: t?.width ?? 0,
+			height: t?.height ?? 0
+		};
+	}
+	_rebound() {
+		let e = this.getMovable(), t = this._drawnPlacement();
+		if (!e || !t) return;
+		let n = [];
+		for (let e of this._members_()) {
+			let t = e._getLocalPlacement();
+			t && n.push(u(t.bounds, t.rotation));
+		}
+		let r = c.unionBounds(n);
+		if (!r) return;
+		let i = this._childBounds();
+		if (c.isSameBounds(r, i)) return;
+		let a = i.width > 0 ? t.bounds.width / i.width : 1, o = i.height > 0 ? t.bounds.height / i.height : 1, s = c.placeInParent(t, i, c.flatPlacement({
+			x: r.x + r.width / 2,
+			y: r.y + r.height / 2,
+			width: 0,
+			height: 0
+		})).bounds, l = r.width * a, d = r.height * o, f = this._getState();
+		this._updateState({ data: {
+			...f.data,
+			childBounds: r
+		} }), e.setBounds({
+			x: s.x - l / 2,
+			y: s.y - d / 2,
+			width: l,
+			height: d
+		});
+	}
+	_drawnPlacement() {
+		let e = this.getMovable();
+		return e ? c.placementOf(e) : null;
+	}
+	getFill() {
+		return this._getState()?.data?.fill ?? null;
+	}
+	getTextFrame() {
+		let e = this._getMembers(), t = !1, n = [];
+		for (let r of e) {
+			let e = r.getContent().getTextFrame?.() ?? null;
+			if (!e) continue;
+			t = !0;
+			let i = e.getText();
+			i !== "" && n.push(i);
+		}
+		if (!t) return null;
+		let r = n.join("\n");
+		return Object.freeze({ getText: () => r });
+	}
+	get acceptRotation() {
+		return this._isEveryMember("acceptRotation") ? y : void 0;
+	}
+	get acceptFlip() {
+		return this._isEveryMember("acceptFlip") ? b : void 0;
+	}
+	_isEveryMember(e) {
+		let t = this._members_();
+		for (let n = 0; n < t.length; n++) if (!t[n].getContent()[e]) return !1;
+		return !0;
+	}
+	async ungroup(e) {
+		let t = this.getMovable();
+		if (!t || this.isDeleted()) return [];
+		let n = e?.description ?? h("op.ungroupDrawings");
+		this._protectionCheck(n);
+		let r = t.getRange().getWorksheet(), i = a(r.getView().getMovableSelection());
+		return await this.doBatch(() => {
+			let t = this._free(this._members_(), n);
+			this.delete(e);
+			let a = this._transactions.getPendingTransaction();
+			return a && o(a, r, t, {
+				autoSelect: e?.autoSelect ?? !0,
+				autoSelectRestore: e?.autoSelectRestore
+			}, i), t;
+		}, { description: n });
+	}
+	_free(e, t) {
+		let n = this.getMovable(), r = n.getParent()?.getMovables() ?? n.getRange().getWorksheet().getMovables(), i = n.getZIndex(), a = this._createOptions.beginPersistResource();
+		try {
+			return e.map((e, n) => {
+				let o = e.toJSON(a.toResourceId.bind(a)), s = c.placementOf(e), l = r._insertNow({
+					type: o.content.type,
+					json: o.content.json,
+					name: o.content.name,
+					altText: o.content.description,
+					bounds: s.bounds,
+					rotation: s.rotation,
+					fromResourceId: a.fromResourceId.bind(a),
+					autoSelect: !1,
+					description: t,
+					zIndex: i + n
+				});
+				return (s.flip.horizontal || s.flip.vertical) && l.setFlip(s.flip), e.isHidden() && l.setHidden(!0), o.lockAspect !== void 0 && l.setLockAspectRatio(o.lockAspect), l;
+			});
+		} finally {
+			a.endPersist();
+		}
+	}
+	getConnections() {
+		return x;
+	}
+	toJSON(e) {
+		let t = { ...this._getState()?.data ?? {} }, n = this._members_();
+		return n.length > 0 && (t.members = n.map((t) => t.toJSON(e))), t;
+	}
+	_getDrawnRect(e, t, n) {
+		let r = this._members_();
+		if (r.length === 0) return null;
+		let i = c.flatPlacement({
+			x: 0,
+			y: 0,
+			width: e,
+			height: t
+		}), a = this._childBounds(), o = 1 / 0, s = 1 / 0, u = -1 / 0, f = -1 / 0, p = !1;
+		for (let e of r) {
+			if (e.isHidden()) continue;
+			let t = e._getLocalPlacement();
+			if (!t) continue;
+			let r = c.placeInParent(i, a, t), m = e.getContent(), h = d(m) ? m._getDrawnRect(r.bounds.width, r.bounds.height, n) : null, g = l(r.bounds, h, r.rotation, r.flip);
+			o = Math.min(o, g.x), s = Math.min(s, g.y), u = Math.max(u, g.x + g.width), f = Math.max(f, g.y + g.height), p = !0;
+		}
+		return p ? {
+			l: o,
+			t: s,
+			r: u,
+			b: f
+		} : null;
+	}
+	_getMembers() {
+		return this._members_();
+	}
+	_members_() {
+		return this._getState()?.members ?? C;
+	}
+	async _addMember(e) {
+		return this._insertMember(await this._prepareMember(e));
+	}
+	async _prepareMember(e) {
+		if (!e?.type) throw new m("A member needs a type.");
+		return this._protectionCheck(h("op.insertDrawing")), await t({
+			type: e.type,
+			json: e.json
+		}), e;
+	}
+	_insertMember(e) {
+		if (!e?.type) throw new m("A member needs a type.");
+		this._protectionCheck(h("op.insertDrawing"));
+		let t = this._drawnPlacement(), n = {
+			...t?.bounds ?? this._childBounds(),
+			...e.bounds
+		}, r = t ? c.placeInChild(t, this._childBounds(), {
+			bounds: n,
+			rotation: e.rotation ?? 0,
+			flip: {
+				horizontal: !1,
+				vertical: !1
+			}
+		}) : {
+			bounds: n,
+			rotation: e.rotation ?? 0,
+			flip: {
+				horizontal: !1,
+				vertical: !1
+			}
+		}, i = {
+			anchor: {
+				tl: {
+					x: r.bounds.x,
+					y: r.bounds.y
+				},
+				br: {
+					x: r.bounds.width,
+					y: r.bounds.height
+				}
+			},
+			content: {
+				type: e.type,
+				json: e.json
+			}
+		};
+		e.name && (i.content.name = e.name);
+		let a = e.altText;
+		a && (i.content.description = a), r.rotation && (i.rotation = r.rotation), r.flip.horizontal && (i.flipH = !0), r.flip.vertical && (i.flipV = !0);
+		let o = this._beginCommit(e.description ?? h("op.insertDrawing"));
+		try {
+			let t = this._createMember(i, e.fromResourceId), n = this._members_().slice();
+			return n.splice(Math.max(0, Math.min(n.length, e.zIndex ?? n.length)), 0, t), this._updateState({ members: n }), this._rebound(), o.commit(), this._members._notifyChange(), t;
+		} catch (e) {
+			throw o.rollback(), e;
+		}
+	}
+	async _groupMembers(e, t) {
+		let n = t?.description ?? h("op.groupDrawings");
+		if (this._protectionCheck(n), !e || e.length < 2) throw new m(g("error.movable.groupTooFew"));
+		let r = this._members_();
+		for (let t of e) if (!r.includes(t)) throw new m(g("error.movable.groupNotSameGroup"));
+		let i = r.filter((t) => e.includes(t));
+		if (i.length === r.length) throw new m(g("error.movable.groupWholeGroup"));
+		let s = this.getMovable();
+		if (!s) throw new m("The group is not placed.");
+		let l = s.getRange().getWorksheet(), d = a(l.getView().getMovableSelection()), f = c.unionBounds(i.map((e) => {
+			let t = e._getLocalPlacement();
+			return u(t.bounds, t.rotation);
+		})), p = this._createOptions.beginPersistResource();
+		try {
+			let e = {
+				anchor: {
+					tl: {
+						x: f.x,
+						y: f.y
+					},
+					br: {
+						x: f.width,
+						y: f.height
+					}
+				},
+				content: {
+					type: "group",
+					json: {
+						childBounds: { ...f },
+						members: i.map((e) => e.toJSON(p.toResourceId.bind(p)))
+					}
+				}
+			};
+			t?.name && (e.content.name = t.name);
+			let a = this._beginCommit(n);
+			try {
+				for (let e of i) e.unselect();
+				let n = this._createMember(e, p.fromResourceId.bind(p)), s = i[i.length - 1], c = [];
+				for (let e of r) e === s ? c.push(n) : i.includes(e) || c.push(e);
+				this._updateState({ members: c });
+				for (let e of i) e.getContent().delete();
+				return this._rebound(), o(a, l, [n], {
+					autoSelect: t?.autoSelect ?? !0,
+					autoSelectRestore: t?.autoSelectRestore
+				}, d), a.commit(), this._members._notifyChange(), n;
+			} catch (e) {
+				throw a.rollback(), e;
+			}
+		} finally {
+			p.endPersist();
+		}
+	}
+	_removeMember(e, t) {
+		let n = this._members_();
+		if (!n.includes(e)) return;
+		e.unselect();
+		let r = this._beginCommit(t?.description ?? h("op.deleteDrawing"));
+		try {
+			let i = n.filter((t) => t !== e);
+			if (this._updateState({ members: i }), i.length === 1 && this.getMovable()) {
+				let e = i[0], n = e.isSelected(), [a] = this._free(i, t?.description ?? h("op.deleteDrawing"));
+				this.delete(t), n && o(r, a.getRange().getWorksheet(), [a], { autoSelect: !0 }, [e]);
+			} else i.length === 0 ? this.delete(t) : this._rebound();
+			r.commit(), this._members._notifyChange();
+		} catch (e) {
+			throw r.rollback(), e;
+		}
+	}
+	_moveMember(e, t, n) {
+		let r = this._members_(), i = r.indexOf(e);
+		if (i === -1 || (t = Math.max(0, Math.min(r.length - 1, t))) === i) return;
+		this._protectionCheck(n);
+		let a = r.slice();
+		a.splice(i, 1), a.splice(t, 0, e), this._updateState({ members: a }, { description: n }), this._members._notifyChange();
+	}
+	_createMember(e, t) {
+		let r = this, i = e.content?.type ?? "custom", a = this._createOptions, o, s = {
+			type: i,
+			transactions: a.transactions,
+			beginPersistResource: a.beginPersistResource,
+			fromResourceId: t,
+			json: e.content?.json,
+			name: e.content?.name ?? null,
+			description: e.content?.description ?? null,
+			isReadOnly: () => r.isReadOnly(),
+			deleteFromContainer: () => {
+				o?._deleteFromContent();
+			},
+			getMovable: () => o,
+			getStyles: a.getStyles,
+			getRange: a.getRange,
+			addWatch: a.addWatch
+		}, l = n(i, s, {
+			getMovable: () => o,
+			amend: (e) => r._amend(e),
+			isClosed: () => r._closed
+		}), u = () => r.getMovable(), d = () => r._members_().indexOf(o), f;
+		return o = new _({
+			content: l,
+			json: e,
+			transactions: a.transactions,
+			beginPersistResource: a.beginPersistResource,
+			fromResourceId: t,
+			getParent: u,
+			onMemberPlacementChange: () => r._rebound(),
+			place: (e) => {
+				let t = r._drawnPlacement();
+				return t ? c.placeInParent(t, r._childBounds(), e) : null;
+			},
+			unplace: (e) => {
+				let t = r._drawnPlacement();
+				return t ? c.placeInChild(t, r._childBounds(), e) : null;
+			},
+			coords: p.EmptyRange,
+			getRanges: (e) => u().getRanges(),
+			getContainerIndex: d,
+			getZIndex: d,
+			getBoundsAtCoords: () => ({
+				x: 0,
+				y: 0,
+				width: 0,
+				height: 0
+			}),
+			getCoordsAtBounds: () => p.EmptyRange,
+			isProtected: () => r.isReadOnly(),
+			moveToBackOnContainer: () => r._moveMember(o, 0, h("op.moveToBack")),
+			moveBackwardOnContainer: () => r._moveMember(o, d() - 1, h("op.moveBackwards")),
+			moveForwardOnContainer: () => r._moveMember(o, d() + 1, h("op.moveForward")),
+			moveToFrontOnContainer: () => r._moveMember(o, r._members_().length - 1, h("op.moveToFront")),
+			deleteFromContainer: (e) => r._removeMember(o, e),
+			setContainerCallbacks: (e) => {
+				e && (f = {
+					...f,
+					...e
+				}), o && f && r._memberCallbacks.set(o, f);
+			},
+			invalidate: () => {
+				r._members._notifyChange();
+			}
+		}), f && this._memberCallbacks.set(o, f), o;
+	}
+	_tellZIndex() {
+		let e = this._members_(), t = this._toldOrder;
+		if (e !== t) {
+			this._toldOrder = e;
+			for (let n = 0; n < e.length; n++) {
+				let r = e[n];
+				t[n] !== r && this._memberCallbacks.get(r)?.processZIndex?.();
+			}
+		}
+	}
+	_amend(e) {
+		let t = this._transactions;
+		return t.amend(t.getCurrentCommit(!1).getId(), () => e());
+	}
+	_processAfterStateChange(e, t) {
+		super._processAfterStateChange(e, t), this._tellZIndex(), this._emitter.notify("onAnyChange"), this._members?._notifyChange(), this.getMovable()?._forwardLayout();
+	}
+	get isIGroup() {
+		return !0;
+	}
+	get [Symbol.toStringTag]() {
+		return "[Group]";
+	}
+	toString() {
+		return this.getTypeDescription();
+	}
+}, C = Object.freeze([]);
+export { S as Group };