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

package/node/esm/BtuY37FumvLE7EBo.mjs

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