@sheetxl/mcp 0.0.0-stage → 0.8.0-beta.15

package/assets/CvngwB17_ve4W49b.js

@@ -0,0 +1,639 @@
+/**
+* @license @sheetxl/mcp - MCP server exposing SheetXL spreadsheet operations as tools and resources. - v0.8.0-beta.15
+*
+* (C) 2026-present SheetXL Inc. & Michael T. Ford
+* License: The license can be found at https://www.sheetxl.com/license.
+*/
+import { ht as e, ot as t, p as n, tt as o, u as r } from "./BQMDOjNBMjAx9WiW.js";
+import { i as s } from "./_d5XJ7dn1CKKYrep.js";
+import { $t as i, G as a, Zt as c, it as l } from "./iujMYIEPx_v3sdPf.js";
+import { Qt as h, Zt as u, bt as d, pn as m, pr as p, s as g, w as _ } from "./Bh0PNKlrR4VAqnP8.js";
+var b = class extends m {
+	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 h.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 s = r("op.setMovableRotation"), i = this._beginCommit(s);
+		try {
+			this._updateState({
+				rotation: o.rotation,
+				pixelBounds: o.bounds
+			}, { description: s }, ["onBoundsChange"]), this._optionsMember.onMemberPlacementChange?.(), this._notifyPlacementChange(), i.commit();
+		} catch (e) {
+			throw i.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: s, vertical: i } = o;
+		if (s === n.flip.horizontal && i === n.flip.vertical) return this;
+		const a = this._optionsMember.unplace({
+			...n,
+			flip: {
+				horizontal: s,
+				vertical: i
+			}
+		});
+		if (!a) return this;
+		const c = t?.description ?? r("op.setMovableFlip"), l = this._beginCommit(c);
+		try {
+			this._updateState({
+				flipH: a.flip.horizontal,
+				flipV: a.flip.vertical
+			}, { description: c }), this._notifyPlacementChange(), l.commit();
+		} catch (e) {
+			throw l.rollback(), e;
+		}
+		return this;
+	}
+	_getAnchorBounds() {
+		const e = this._getDrawnPlacement();
+		return e ? l(e.bounds, e.rotation) : null;
+	}
+	_setAnchorBounds(e) {
+		const t = this._getDrawnPlacement();
+		if (!t) return;
+		const n = this._optionsMember.unplace({
+			...t,
+			bounds: l(e, t.rotation)
+		});
+		if (!n) return;
+		const o = this._getLocalPlacement();
+		o && a.isSameBounds(o.bounds, n.bounds) || (this._updateState({ pixelBounds: n.bounds }, { description: r("op.updateMovableBounds") }, ["onBoundsChange"]), this._optionsMember.onMemberPlacementChange?.());
+	}
+	_processContainerLayout() {
+		this._getEmitter().notify("onBoundsChange"), this._forwardLayout();
+	}
+	_fromJSON(t) {
+		const n = t.anchor?.tl ?? e.EmptyObject, o = t.anchor?.br ?? e.EmptyObject;
+		this._updateState({
+			offsets: {
+				tl: {
+					x: 0,
+					y: 0
+				},
+				br: {
+					x: 0,
+					y: 0
+				}
+			},
+			hidden: t.hidden ?? !1,
+			rotation: t.rotation ?? 0,
+			flipH: t.flipH ?? !1,
+			flipV: t.flipV ?? !1,
+			lockAspectRatio: t.lockAspect ?? null,
+			locks: t.locks ?? null,
+			anchorType: h.Type.Absolute,
+			pixelBounds: {
+				x: n.x ?? 0,
+				y: n.y ?? 0,
+				width: o.x ?? 0,
+				height: o.y ?? 0
+			}
+		}, { description: r("op.loadMovable") });
+	}
+	_getAnchorJSON() {
+		const t = this._getState()?.pixelBounds ?? {
+			x: 0,
+			y: 0,
+			width: 0,
+			height: 0
+		}, n = (t) => e.roundAccurately(t, 2);
+		return {
+			tl: {
+				x: n(t.x),
+				y: n(t.y)
+			},
+			br: {
+				x: n(t.width),
+				y: n(t.height)
+			}
+		};
+	}
+	toJSON(e) {
+		const t = super.toJSON(e);
+		return delete t.anchorType, t;
+	}
+}, f = class extends u {
+	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 o("No movable options provided");
+		return this._group._addMember(e);
+	}
+	_prepare(e) {
+		if (!e) throw new o("No movable options provided");
+		return this._group._prepareMember(e);
+	}
+	_preparePicture(e, t) {
+		const n = this._group.getMovable();
+		if (!n) throw new o("The group is not placed.");
+		const s = n.getRange().getWorksheet().getResources().add(e);
+		return this._group._prepareMember({
+			description: r("op.insertImage"),
+			...t,
+			type: "picture",
+			json: {
+				...t?.json,
+				resId: 0
+			},
+			fromResourceId: () => s
+		});
+	}
+	_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) {
+		const n = this._group._getMembers().filter((e) => e.isSelected());
+		0 !== n.length && this._group.doBatch(() => {
+			for (const t of n) e(t);
+		}, { description: t ?? r("op.updateMovables") });
+	}
+	_notifyChange() {
+		this._notifyCollectionChange();
+	}
+	get isIMovableCollection() {
+		return !0;
+	}
+}, y = (e) => e, w = (e) => e, M = Object.freeze([]), v = class extends s {
+	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(), t = this._drawnPlacement();
+		if (!e || !t) return;
+		const n = [];
+		for (const e of this._members_()) {
+			const t = e._getLocalPlacement();
+			t && n.push(l(t.bounds, t.rotation));
+		}
+		const o = a.unionBounds(n);
+		if (!o) return;
+		const r = this._childBounds();
+		if (a.isSameBounds(o, r)) return;
+		const s = r.width > 0 ? t.bounds.width / r.width : 1, i = r.height > 0 ? t.bounds.height / r.height : 1, c = a.placeInParent(t, r, a.flatPlacement({
+			x: o.x + o.width / 2,
+			y: o.y + o.height / 2,
+			width: 0,
+			height: 0
+		})).bounds, h = o.width * s, u = o.height * i, d = this._getState();
+		this._updateState({ data: {
+			...d.data,
+			childBounds: o
+		} }), e.setBounds({
+			x: c.x - h / 2,
+			y: c.y - u / 2,
+			width: h,
+			height: u
+		});
+	}
+	_drawnPlacement() {
+		const e = this.getMovable();
+		return e ? a.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 ?? r("op.ungroupDrawings");
+		this._protectionCheck(n);
+		const o = t.getRange().getWorksheet(), s = g(o.getView().getMovableSelection());
+		return await this.doBatch(() => {
+			const t = this._free(this._members_(), n);
+			this.delete(e);
+			const r = this._transactions.getPendingTransaction();
+			return r && p(r, o, t, {
+				autoSelect: e?.autoSelect ?? !0,
+				autoSelectRestore: e?.autoSelectRestore
+			}, s), t;
+		}, { description: n });
+	}
+	_free(e, t) {
+		const n = this.getMovable(), o = n.getParent()?.getMovables() ?? n.getRange().getWorksheet().getMovables(), r = n.getZIndex(), s = this._createOptions.beginPersistResource();
+		try {
+			return e.map((e, n) => {
+				const i = e.toJSON(s.toResourceId.bind(s)), c = a.placementOf(e), l = o._insertNow({
+					type: i.content.type,
+					json: i.content.json,
+					name: i.content.name,
+					altText: i.content.description,
+					bounds: c.bounds,
+					rotation: c.rotation,
+					fromResourceId: s.fromResourceId.bind(s),
+					autoSelect: !1,
+					description: t,
+					zIndex: r + n
+				});
+				return (c.flip.horizontal || c.flip.vertical) && l.setFlip(c.flip), e.isHidden() && l.setHidden(!0), void 0 !== i.lockAspect && l.setLockAspectRatio(i.lockAspect), l;
+			});
+		} finally {
+			s.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, t, n) {
+		const o = this._members_();
+		if (0 === o.length) return null;
+		const r = a.flatPlacement({
+			x: 0,
+			y: 0,
+			width: e,
+			height: t
+		}), s = this._childBounds();
+		let l = 1 / 0, h = 1 / 0, u = -1 / 0, d = -1 / 0, m = !1;
+		for (const e of o) {
+			if (e.isHidden()) continue;
+			const t = e._getLocalPlacement();
+			if (!t) continue;
+			const o = a.placeInParent(r, s, t), p = e.getContent(), g = i(p) ? p._getDrawnRect(o.bounds.width, o.bounds.height, n) : null, _ = c(o.bounds, g, o.rotation, o.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) {
+		return this._insertMember(await this._prepareMember(e));
+	}
+	async _prepareMember(e) {
+		if (!e?.type) throw new o("A member needs a type.");
+		return this._protectionCheck(r("op.insertDrawing")), await d({
+			type: e.type,
+			json: e.json
+		}), e;
+	}
+	_insertMember(e) {
+		if (!e?.type) throw new o("A member needs a type.");
+		this._protectionCheck(r("op.insertDrawing"));
+		const t = this._drawnPlacement(), n = {
+			...t?.bounds ?? this._childBounds(),
+			...e.bounds
+		}, s = t ? a.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: s.bounds.x,
+					y: s.bounds.y
+				},
+				br: {
+					x: s.bounds.width,
+					y: s.bounds.height
+				}
+			},
+			content: {
+				type: e.type,
+				json: e.json
+			}
+		};
+		e.name && (i.content.name = e.name);
+		const c = e.altText;
+		c && (i.content.description = c), s.rotation && (i.rotation = s.rotation), s.flip.horizontal && (i.flipH = !0), s.flip.vertical && (i.flipV = !0);
+		const l = this._beginCommit(e.description ?? r("op.insertDrawing"));
+		try {
+			const 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(), l.commit(), this._members._notifyChange(), t;
+		} catch (e) {
+			throw l.rollback(), e;
+		}
+	}
+	async _groupMembers(e, t) {
+		const s = t?.description ?? r("op.groupDrawings");
+		if (this._protectionCheck(s), !e || e.length < 2) throw new o(n("error.movable.groupTooFew"));
+		const i = this._members_();
+		for (const t of e) if (!i.includes(t)) throw new o(n("error.movable.groupNotSameGroup"));
+		const c = i.filter((t) => e.includes(t));
+		if (c.length === i.length) throw new o(n("error.movable.groupWholeGroup"));
+		const h = this.getMovable();
+		if (!h) throw new o("The group is not placed.");
+		const u = h.getRange().getWorksheet(), d = g(u.getView().getMovableSelection()), m = a.unionBounds(c.map((e) => {
+			const t = e._getLocalPlacement();
+			return l(t.bounds, t.rotation);
+		})), _ = this._createOptions.beginPersistResource();
+		try {
+			const n = {
+				anchor: {
+					tl: {
+						x: m.x,
+						y: m.y
+					},
+					br: {
+						x: m.width,
+						y: m.height
+					}
+				},
+				content: {
+					type: "group",
+					json: {
+						childBounds: { ...m },
+						members: c.map((e) => e.toJSON(_.toResourceId.bind(_)))
+					}
+				}
+			};
+			t?.name && (n.content.name = t.name);
+			const o = this._beginCommit(s);
+			try {
+				for (const e of c) e.unselect();
+				const e = this._createMember(n, _.fromResourceId.bind(_)), r = c[c.length - 1], s = [];
+				for (const t of i) t === r ? s.push(e) : c.includes(t) || s.push(t);
+				this._updateState({ members: s });
+				for (const e of c) e.getContent().delete();
+				return this._rebound(), p(o, u, [e], {
+					autoSelect: t?.autoSelect ?? !0,
+					autoSelectRestore: t?.autoSelectRestore
+				}, d), o.commit(), this._members._notifyChange(), e;
+			} catch (e) {
+				throw o.rollback(), e;
+			}
+		} finally {
+			_.endPersist();
+		}
+	}
+	_removeMember(e, t) {
+		const n = this._members_();
+		if (!n.includes(e)) return;
+		e.unselect();
+		const o = this._beginCommit(t?.description ?? r("op.deleteDrawing"));
+		try {
+			const s = n.filter((t) => t !== e);
+			if (this._updateState({ members: s }), 1 === s.length && this.getMovable()) {
+				const e = s[0], n = e.isSelected(), [i] = this._free(s, t?.description ?? r("op.deleteDrawing"));
+				this.delete(t), n && p(o, i.getRange().getWorksheet(), [i], { autoSelect: !0 }, [e]);
+			} else 0 === s.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, s = e.content?.type ?? "custom", i = this._createOptions;
+		let c;
+		const l = {
+			type: s,
+			transactions: i.transactions,
+			beginPersistResource: i.beginPersistResource,
+			fromResourceId: n,
+			json: e.content?.json,
+			name: e.content?.name ?? null,
+			description: e.content?.description ?? null,
+			isReadOnly: () => o.isReadOnly(),
+			deleteFromContainer: () => {
+				c?._deleteFromContent();
+			},
+			getMovable: () => c,
+			getStyles: i.getStyles,
+			getRange: i.getRange,
+			addWatch: i.addWatch
+		}, h = _(s, l, {
+			getMovable: () => c,
+			amend: (e) => o._amend(e),
+			isClosed: () => o._closed
+		}), u = () => o.getMovable(), d = () => o._members_().indexOf(c);
+		let m;
+		return c = new b({
+			content: h,
+			json: e,
+			transactions: i.transactions,
+			beginPersistResource: i.beginPersistResource,
+			fromResourceId: n,
+			getParent: u,
+			onMemberPlacementChange: () => o._rebound(),
+			place: (e) => {
+				const t = o._drawnPlacement();
+				return t ? a.placeInParent(t, o._childBounds(), e) : null;
+			},
+			unplace: (e) => {
+				const t = o._drawnPlacement();
+				return t ? a.placeInChild(t, o._childBounds(), e) : null;
+			},
+			coords: t.EmptyRange,
+			getRanges: (e) => u().getRanges(),
+			getContainerIndex: d,
+			getZIndex: d,
+			getBoundsAtCoords: () => ({
+				x: 0,
+				y: 0,
+				width: 0,
+				height: 0
+			}),
+			getCoordsAtBounds: () => t.EmptyRange,
+			isProtected: () => o.isReadOnly(),
+			moveToBackOnContainer: () => o._moveMember(c, 0, r("op.moveToBack")),
+			moveBackwardOnContainer: () => o._moveMember(c, d() - 1, r("op.moveBackwards")),
+			moveForwardOnContainer: () => o._moveMember(c, d() + 1, r("op.moveForward")),
+			moveToFrontOnContainer: () => o._moveMember(c, o._members_().length - 1, r("op.moveToFront")),
+			deleteFromContainer: (e) => o._removeMember(c, e),
+			setContainerCallbacks: (e) => {
+				e && (m = {
+					...m,
+					...e
+				}), c && m && o._memberCallbacks.set(c, m);
+			},
+			invalidate: () => {
+				o._members._notifyChange();
+			}
+		}), m && this._memberCallbacks.set(c, m), c;
+	}
+	_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 };

package/assets/CwPBmcY6xSP8dNlh.js

@@ -0,0 +1,51 @@
+/**
+* @license @sheetxl/mcp - MCP server exposing SheetXL spreadsheet operations as tools and resources. - v0.8.0-beta.15
+*
+* (C) 2026-present SheetXL Inc. & Michael T. Ford
+* License: The license can be found at https://www.sheetxl.com/license.
+*/
+import { P as e } from "./jadLBUNBVR9mbZ35.js";
+import { n as t } from "./BZPTaa0WjpoUAbgZ.js";
+var r = async (r, n) => {
+	let o = r;
+	(function(e) {
+		if (e.byteLength < 4) return !1;
+		const t = new Uint8Array(e), r = {
+			gzip: [31, 139],
+			zip: [
+				80,
+				75,
+				3,
+				4
+			],
+			bz2: [
+				66,
+				90,
+				104
+			],
+			br: [
+				206,
+				178,
+				207,
+				129
+			]
+		}, n = Object.keys(r);
+		for (let e = 0; e < n.length; e++) {
+			const o = n[e], a = r[o];
+			let s = !0;
+			for (let e = 0; e < a.length; e++) if (t[e] !== a[e]) {
+				s = !1;
+				break;
+			}
+			if (s) return o;
+		}
+		return !1;
+	})(o) && (o = await t(o));
+	let a = new TextDecoder().decode(o);
+	const s = JSON.parse(a), i = {
+		...n?.createWorkbookOptions ?? {},
+		json: s
+	};
+	return new e(i);
+};
+export { r as readSXL };