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

package/node/esm/BH1v-E4Ro3bR7Znw.mjs

@@ -0,0 +1,962 @@
+/**
+* @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 } from "./DdFgXl-Ux2cMBTs_.mjs";
+import { t as e } from "./CnSQ7MTXAUAyBOoS.mjs";
+import { O as n, T as r, _ as o, a as s, at as a, c as i, d as l, h, i as c, m as u, ot as d, r as p, st as g, u as m } from "./CT0CN82y0_Qgoryk.mjs";
+import { IGeometry as _, IShape as f, n as w, r as C, t as y } from "./index.mjs";
+import { ExpectedError as S, TypedObject as v, messageKey as b } from "@sheetxl/utils";
+var k = v.PassThrough, j = { properties: {
+	fill: n,
+	stroke: {
+		shorthand: (t) => "string" == typeof t ? { fill: t } : t?.isIStroke ? t.toJSON() : t,
+		properties: {
+			fill: n,
+			width: k,
+			lineJoin: k,
+			lineCap: k,
+			miterLimit: k,
+			headType: k,
+			headWidth: k,
+			headLength: k,
+			tailType: k,
+			tailWidth: k,
+			tailLength: k,
+			dash: k,
+			compound: k,
+			align: k
+		}
+	}
+} }, T = class {
+	constructor(t) {
+		this._h = t;
+	}
+	_parseColor(t) {
+		const e = this._h.getStyles();
+		return e ? e.parseColor(t) : new g(t);
+	}
+	_resolve(t) {
+		return w(t, this._h.getTheme(), y(this._h.getMovable()));
+	}
+	_without(t) {
+		const e = this._h.getData();
+		if (!e) return null;
+		const { [t]: n, ...r } = e;
+		return r;
+	}
+	_fillHost() {
+		return {
+			parseColor: (t) => this._parseColor(t),
+			getBaseFill: () => r(this._fillHost(), [this._resolve(this._without("fill")).fill]),
+			getResource: (t) => this._h.getResource(t),
+			updateFill: (t, e) => (this.setFill(t, e), this.getFill())
+		};
+	}
+	_strokeHost() {
+		return {
+			parseColor: (t) => this._parseColor(t),
+			getBaseStroke: () => new C(this._strokeHost(), [this._resolve(this._without("stroke")).stroke]),
+			getResource: (t) => this._h.getResource(t),
+			updateStroke: (t, e) => (this.setStroke(t, e), this.getStroke())
+		};
+	}
+	getFill() {
+		return r(this._fillHost(), [this._resolve(this._h.getData()).fill]);
+	}
+	setFill(t, e) {
+		return this.update({ fill: t }, {
+			description: b("op.setShapeFill"),
+			...e
+		});
+	}
+	setFillSolid(t) {
+		return this.update({ fill: { type: d.Type.Solid } }, {
+			description: b("op.setFillSolid"),
+			...t
+		}), this.getFill();
+	}
+	setFillGradient(t) {
+		return this.update({ fill: { type: d.Type.Gradient } }, {
+			description: b("op.setFillGradient"),
+			...t
+		}), this.getFill();
+	}
+	setFillPattern(t) {
+		return this.update({ fill: { type: d.Type.Pattern } }, {
+			description: b("op.setFillPattern"),
+			...t
+		}), this.getFill();
+	}
+	setFillNone(t) {
+		return this.update({ fill: { type: d.Type.None } }, {
+			description: b("op.setFillNone"),
+			...t
+		}), this.getFill();
+	}
+	getStroke() {
+		return new C(this._strokeHost(), [this._resolve(this._h.getData()).stroke]);
+	}
+	setStroke(t, e) {
+		return this.update({ stroke: t }, {
+			description: b("op.setShapeStroke"),
+			...e
+		});
+	}
+	setStrokeNone(t) {
+		return this.update({ stroke: { fill: { type: d.Type.None } } }, {
+			description: b("op.setShapeStroke"),
+			...t
+		}), this.getStroke();
+	}
+	update(t, e) {
+		const n = e?.description ?? b("op.setShapeStyle");
+		if (null === t) return this.clear({
+			...e,
+			description: n
+		});
+		const r = t.isIShapeStyle ? t.toJSON() ?? {} : t, o = this._h.getData(), s = {
+			fill: this._resolve(o).fill,
+			stroke: o?.stroke
+		}, a = { ...r };
+		void 0 !== a.stroke && (a.stroke = C.toModifiers(a.stroke));
+		const i = this._h.getStyles(), l = v.resolveTypedUpdates(a, j, i, s) ?? {}, h = {};
+		return "fill" in r && (h.fill = l.fill), "stroke" in r && (h.stroke = l.stroke), 0 === Object.keys(h).length || this._h.write(h, {
+			...e,
+			description: n
+		}), this;
+	}
+	clear(t) {
+		return this.isThemed() || this._h.write({
+			fill: void 0,
+			stroke: void 0
+		}, {
+			description: b("op.clearShapeStyle"),
+			...t
+		}), this;
+	}
+	isThemed() {
+		const t = this._h.getData();
+		return !t?.fill && !t?.stroke;
+	}
+	toJSON() {
+		const t = this._h.getData(), e = {};
+		return t?.fill && (e.fill = t.fill), t?.stroke && (e.stroke = t.stroke), e.fill || e.stroke ? e : null;
+	}
+	get [Symbol.toStringTag]() {
+		return "[ShapeStyle]";
+	}
+	toString() {
+		return "[ShapeStyle]";
+	}
+	get isIShapeStyle() {
+		return !0;
+	}
+};
+function x(t, e) {
+	if (!Number.isFinite(t)) return "0";
+	let n = t.toFixed(e);
+	return n.indexOf(".") >= 0 && (n = n.replace(/\.?0+$/, "")), "-0" === n ? "0" : n;
+}
+var A = [
+	[() => import("./B9ljpEIZg6wOTzRE.mjs"), [
+		"bentConnector2",
+		"bentConnector3",
+		"bentConnector4",
+		"bentConnector5",
+		"curvedConnector2",
+		"curvedConnector3",
+		"curvedConnector4",
+		"curvedConnector5",
+		"line",
+		"lineInv",
+		"straightConnector1"
+	]],
+	[() => import("./D7MfcID2Wf6l6VpC.mjs"), [
+		"rect",
+		"round1Rect",
+		"round2DiagRect",
+		"round2SameRect",
+		"roundRect",
+		"snip1Rect",
+		"snip2DiagRect",
+		"snip2SameRect",
+		"snipRoundRect"
+	]],
+	[() => import("./DefYISWfdZJFx57m.mjs"), [
+		"mathDivide",
+		"mathEqual",
+		"mathMinus",
+		"mathMultiply",
+		"mathNotEqual",
+		"mathPlus"
+	]],
+	[() => import("./BN9j8V9gCExMjVtJ.mjs"), [
+		"flowChartAlternateProcess",
+		"flowChartCollate",
+		"flowChartConnector",
+		"flowChartDecision",
+		"flowChartDelay",
+		"flowChartDisplay",
+		"flowChartDocument",
+		"flowChartExtract",
+		"flowChartInputOutput",
+		"flowChartInternalStorage",
+		"flowChartMagneticDisk",
+		"flowChartMagneticDrum",
+		"flowChartMagneticTape",
+		"flowChartManualInput",
+		"flowChartManualOperation",
+		"flowChartMerge",
+		"flowChartMultidocument",
+		"flowChartOfflineStorage",
+		"flowChartOffpageConnector",
+		"flowChartOnlineStorage",
+		"flowChartOr",
+		"flowChartPredefinedProcess",
+		"flowChartPreparation",
+		"flowChartProcess",
+		"flowChartPunchedCard",
+		"flowChartPunchedTape",
+		"flowChartSort",
+		"flowChartSummingJunction",
+		"flowChartTerminator"
+	]],
+	[() => import("./DCplLG93GfTs1vNw.mjs"), [
+		"bentArrow",
+		"bentUpArrow",
+		"chevron",
+		"circularArrow",
+		"curvedDownArrow",
+		"curvedLeftArrow",
+		"curvedRightArrow",
+		"curvedUpArrow",
+		"downArrow",
+		"downArrowCallout",
+		"homePlate",
+		"leftArrow",
+		"leftArrowCallout",
+		"leftCircularArrow",
+		"leftRightArrow",
+		"leftRightArrowCallout",
+		"leftRightCircularArrow",
+		"leftRightUpArrow",
+		"leftUpArrow",
+		"notchedRightArrow",
+		"quadArrow",
+		"quadArrowCallout",
+		"rightArrow",
+		"rightArrowCallout",
+		"stripedRightArrow",
+		"swooshArrow",
+		"upArrow",
+		"upArrowCallout",
+		"upDownArrow",
+		"upDownArrowCallout",
+		"uturnArrow"
+	]],
+	[() => import("./DMD12JUh7HJw2-jl.mjs"), [
+		"accentBorderCallout1",
+		"accentBorderCallout2",
+		"accentBorderCallout3",
+		"accentCallout1",
+		"accentCallout2",
+		"accentCallout3",
+		"borderCallout1",
+		"borderCallout2",
+		"borderCallout3",
+		"callout1",
+		"callout2",
+		"callout3",
+		"cloudCallout",
+		"wedgeEllipseCallout",
+		"wedgeRectCallout",
+		"wedgeRoundRectCallout"
+	]],
+	[() => import("./B6D7sSetrcOWLsKj.mjs"), [
+		"doubleWave",
+		"ellipseRibbon",
+		"ellipseRibbon2",
+		"horizontalScroll",
+		"irregularSeal1",
+		"irregularSeal2",
+		"leftRightRibbon",
+		"ribbon",
+		"ribbon2",
+		"star10",
+		"star12",
+		"star16",
+		"star24",
+		"star32",
+		"star4",
+		"star5",
+		"star6",
+		"star7",
+		"star8",
+		"verticalScroll",
+		"wave"
+	]],
+	[() => import("./CUQi5ZtMO02nhG0W.mjs"), [
+		"actionButtonBackPrevious",
+		"actionButtonBeginning",
+		"actionButtonBlank",
+		"actionButtonDocument",
+		"actionButtonEnd",
+		"actionButtonForwardNext",
+		"actionButtonHelp",
+		"actionButtonHome",
+		"actionButtonInformation",
+		"actionButtonMovie",
+		"actionButtonReturn",
+		"actionButtonSound",
+		"chartPlus",
+		"chartStar",
+		"chartX",
+		"cornerTabs",
+		"plaqueTabs",
+		"squareTabs"
+	]],
+	[() => import("./MiU4rDOiocmJ-9Ry.mjs"), [
+		"arc",
+		"bevel",
+		"blockArc",
+		"bracePair",
+		"bracketPair",
+		"can",
+		"chord",
+		"cloud",
+		"corner",
+		"cube",
+		"decagon",
+		"diagStripe",
+		"diamond",
+		"dodecagon",
+		"donut",
+		"ellipse",
+		"foldedCorner",
+		"frame",
+		"funnel",
+		"gear6",
+		"gear9",
+		"halfFrame",
+		"heart",
+		"heptagon",
+		"hexagon",
+		"leftBrace",
+		"leftBracket",
+		"lightningBolt",
+		"moon",
+		"noSmoking",
+		"nonIsoscelesTrapezoid",
+		"octagon",
+		"parallelogram",
+		"pentagon",
+		"pie",
+		"pieWedge",
+		"plaque",
+		"plus",
+		"rightBrace",
+		"rightBracket",
+		"rtTriangle",
+		"smileyFace",
+		"sun",
+		"teardrop",
+		"trapezoid",
+		"triangle"
+	]]
+], R = (t) => {
+	let e = null;
+	return () => {
+		if (!e) {
+			const n = t();
+			n.catch(() => {
+				e = null;
+			}), e = n;
+		}
+		return e;
+	};
+}, F = R(() => import("./CD9wbvufChVYYkrI.mjs")), M = R(() => import("./Bqd62L8KFgdS0Vou.mjs")), P = null, B = (t) => {
+	const e = /* @__PURE__ */ new Map();
+	for (const [n, r] of Object.entries(t.BUILT_IN)) {
+		const { cxn: o } = r;
+		e.set(n, "number" == typeof o ? Object.freeze({
+			...r,
+			cxn: t.CXN_SHARED[o]
+		}) : {
+			...r,
+			cxn: o
+		});
+	}
+	return e;
+}, E = () => {
+	if (P) return P;
+	P = /* @__PURE__ */ new Map();
+	for (const [t, e] of A) {
+		const n = R(() => t().then(B));
+		for (const t of e) P.set(t, n);
+	}
+	return P;
+}, D = async (t) => {
+	const e = E().get(t);
+	if (e) return (await e()).get(t);
+}, I = 96 / 72, O = (t) => x(t, 2), N = (t, e, n) => {
+	if (!t || t === a.LineEndType.None) return;
+	const r = { type: t };
+	return e && (r.width = e), n && (r.length = n), r;
+}, H = (t) => {
+	const e = t.stroke;
+	return e?.fill && e.fill.type !== d.Type.None ? L(t) / 2 * Math.SQRT2 : 0;
+}, L = (t) => Math.max(Math.max(0, t.strokeWidth) * I, 1), W = (t, e) => ({
+	r: t,
+	b: e,
+	hc: t / 2,
+	vc: e / 2
+}), $ = (t, e, n) => ({ ...n }), G = {
+	pad: 0,
+	evaluate(t, e) {
+		const { r: n, b: r, hc: o, vc: s } = W(t, e);
+		return {
+			paths: [{
+				d: `M0 0 L${O(n)} 0 L${O(n)} ${O(r)} L0 ${O(r)} Z`,
+				fill: "norm",
+				stroke: !0
+			}],
+			textRect: {
+				l: 0,
+				t: 0,
+				r: t,
+				b: e
+			},
+			pathBounds: {
+				l: 0,
+				t: 0,
+				r: t,
+				b: e
+			},
+			handles: [],
+			connections: [
+				{
+					x: o,
+					y: 0,
+					ang: 270
+				},
+				{
+					x: 0,
+					y: s,
+					ang: 180
+				},
+				{
+					x: o,
+					y: r,
+					ang: 90
+				},
+				{
+					x: n,
+					y: s,
+					ang: 0
+				}
+			],
+			adjustments: {}
+		};
+	},
+	adjustmentsFromHandle: $
+}, z = (t, e, n) => {
+	const r = n ? { line: n } : void 0;
+	return {
+		pad: 0,
+		evaluate: (n, o, s) => t.evaluateGeometry(e, n, o, s, r),
+		adjustmentsFromHandle: (n, r, o, s, a, i) => t.adjustmentsFromHandle(e, n, r, o, s, a, i)
+	};
+}, q = async (t, e) => {
+	const n = w(t, e), r = await J(t, ((t) => {
+		const e = t.stroke;
+		if (!e?.fill || e.fill.type === d.Type.None) return;
+		const n = N(e.headType, e.headWidth, e.headLength), r = N(e.tailType, e.tailWidth, e.tailLength);
+		if (!n && !r) return;
+		const o = { width: L(t) };
+		return e.lineCap && (o.cap = e.lineCap), n && (o.head = n), r && (o.tail = r), o;
+	})(n));
+	return r ? {
+		...r,
+		pad: H(n)
+	} : null;
+}, J = async (t, e) => {
+	const n = t.geometry ?? "rect";
+	if ("rect" === n) return G;
+	if ("line" === n || "straightConnector1" === n) return ((t, e, n) => ({
+		pad: 0,
+		evaluate(r, o) {
+			const { r: s, b: a } = W(r, o), i = `M0 0 L${O(s)} ${O(a)}`, l = "line" === t, h = [], c = {
+				x: 0,
+				y: 0,
+				segments: [{
+					k: "L",
+					x0: 0,
+					y0: 0,
+					x1: s,
+					y1: a
+				}],
+				closed: !1
+			}, u = n && e ? n.decorateSubpaths([c], e) : null;
+			let d = {
+				l: Math.min(0, s),
+				t: Math.min(0, a),
+				r: Math.max(0, s),
+				b: Math.max(0, a)
+			};
+			return u ? (l && h.push({
+				d: i,
+				fill: "norm",
+				stroke: !1
+			}), h.push({
+				d: n.subpathsToSVG(u.stroke, 2),
+				fill: "none",
+				stroke: !0
+			}), h.push({
+				d: n.subpathsToSVG(u.ends, 2),
+				fill: "line",
+				stroke: !1
+			}), d = n.addSubpathsBounds({ ...d }, u.ends)) : h.push({
+				d: i,
+				fill: l ? "norm" : "none",
+				stroke: !0
+			}), {
+				paths: h,
+				textRect: {
+					l: 0,
+					t: 0,
+					r,
+					b: o
+				},
+				pathBounds: d,
+				handles: [],
+				connections: l ? [{
+					x: 0,
+					y: 0,
+					ang: 90
+				}, {
+					x: s,
+					y: a,
+					ang: 270
+				}] : [],
+				adjustments: {}
+			};
+		},
+		adjustmentsFromHandle: $
+	}))(n, e, e ? await M() : null);
+	if ("object" == typeof n) return z(await F(), n, e);
+	if (r = n, !E().has(r)) return null;
+	var r;
+	const [o, s] = await Promise.all([F(), D(n)]);
+	return s ? z(o, s, e) : null;
+}, U = class t {
+	constructor(t, e, n, r) {
+		this._evaluator = t, this._width = e, this._height = n, this._adjustments = r, this._evaluated = t.evaluate(e, n, r);
+	}
+	getWidth() {
+		return this._width;
+	}
+	getHeight() {
+		return this._height;
+	}
+	getTextRect() {
+		return { ...this._evaluated.textRect };
+	}
+	getPathBounds() {
+		return { ...this._evaluated.pathBounds };
+	}
+	_getDrawnRect() {
+		return t = this._evaluated.pathBounds, (e = this._evaluator.pad) > 0 ? {
+			l: t.l - e,
+			t: t.t - e,
+			r: t.r + e,
+			b: t.b + e
+		} : { ...t };
+		var t, e;
+	}
+	forEachPath(t) {
+		let e = 0;
+		((t, e, n) => {
+			const r = (t, r, o) => {
+				e({
+					index: n(),
+					d: t,
+					layer: r,
+					fill: o
+				});
+			};
+			for (const e of t.paths) "" !== e.d && "none" !== e.fill && "line" !== e.fill && r(e.d, _.PathLayer.Fill, e.fill);
+			for (const e of t.paths) "" !== e.d && e.stroke && r(e.d, _.PathLayer.Stroke, "norm");
+			for (const e of t.paths) "" !== e.d && "line" === e.fill && r(e.d, _.PathLayer.Marker, "norm");
+		})(this._evaluated, t, () => e++);
+	}
+	forEachHandle(t) {
+		this._evaluated.handles.forEach(({ type: e, x: n, y: r }, o) => t({
+			type: e,
+			index: o,
+			x: n,
+			y: r
+		}));
+	}
+	forEachConnection(t) {
+		this._evaluated.connections.forEach((e, n) => t({
+			...e,
+			index: n
+		}));
+	}
+	resize(e, n) {
+		return new t(this._evaluator, e, n, this._adjustments);
+	}
+	withAdjustments(e) {
+		return new t(this._evaluator, this._width, this._height, e ?? void 0);
+	}
+	adjustmentsFromHandle(t, e, n) {
+		return this._evaluator.adjustmentsFromHandle(this._width, this._height, this._adjustments, t, e, n);
+	}
+}, V = (t) => t instanceof U ? t._getDrawnRect() : t.getPathBounds(), X = async (t, e, n, r) => {
+	const o = await q(t, e);
+	return o ? new U(o, n, r, t.adjustments) : null;
+}, Q = t({ Shape: () => tt }), Z = Object.freeze({}), K = /^(line|lineInv|straightConnector\d|bentConnector\d|curvedConnector\d)$/, Y = () => {}, tt = class extends e {
+	constructor(t) {
+		super(t), this._textSource = null, this._textFrame = null, this._resources = null, this._connectorFormat = null, this._style = null, this._drawn = null, this._drawnPending = null, this._getStyles = t.getStyles ?? null, t.json && (this._updateState({ data: t.json }), this._resources = it(t.json, t.fromResourceId));
+	}
+	_processAfterStateChange(t, e) {
+		super._processAfterStateChange(t, e), o();
+	}
+	getResource(t) {
+		return this._resources?.get(t) ?? null;
+	}
+	getType() {
+		return "shape";
+	}
+	getShapeType() {
+		const t = (this._getState()?.data)?.geometry;
+		return "string" == typeof t ? t : t ? "custom" : "rect";
+	}
+	setShapeType(t, e) {
+		const n = e?.description ?? b("op.setShapeType");
+		if (this._protectionCheck(n), !t || "string" != typeof t || "custom" === t) throw new S(`Invalid shape type: ${t}.`);
+		if (this.isConnector() !== K.test(t)) throw new S(this.isConnector() ? "A line or connector cannot be changed to another shape." : "A shape cannot be changed to a line or connector.");
+		const r = {
+			...this._getState()?.data ?? {},
+			geometry: t
+		};
+		delete r.adjustments;
+		const o = this._beginCommit(n);
+		try {
+			this._updateState({ data: r }, {
+				...e,
+				description: n
+			}, ["onAnyChange"]), this._notifyPlacementChange(), o.commit();
+		} catch (t) {
+			throw o.rollback(), t;
+		}
+		return this;
+	}
+	getTextFrame() {
+		const t = this._getState()?.data ?? null;
+		if (t === this._textSource) return this._textFrame;
+		const e = st(t);
+		return this._textSource = t, this._textFrame = null === e ? null : Object.freeze({ getText: () => e }), this._textFrame;
+	}
+	getStyle() {
+		return this._style ? this._style : this._style = new T({
+			getData: () => this._getState()?.data ?? null,
+			getStyles: () => this._getStyles?.() ?? null,
+			getTheme: () => this._theme(),
+			getMovable: () => this.getMovable(),
+			getResource: (t) => this.getResource(t),
+			write: (t, e) => this._writeStyle(t, e)
+		});
+	}
+	_writeStyle(t, e) {
+		const n = e.description ?? b("op.setShapeStyle");
+		this._protectionCheck(n);
+		const r = { ...this._getState()?.data ?? {} };
+		for (const e of Object.keys(t)) {
+			const n = t[e];
+			void 0 === n ? delete r[e] : r[e] = n;
+		}
+		this._updateState({ data: r }, {
+			...e,
+			description: n
+		}, ["onAnyChange"]);
+	}
+	getAdjustments() {
+		return (this._getState()?.data)?.adjustments ?? Z;
+	}
+	setAdjustments(t, e) {
+		const n = e?.description ?? b("op.setShapeAdjustments");
+		this._protectionCheck(n);
+		const r = { ...this._getState()?.data ?? {} };
+		t && Object.keys(t).length > 0 ? r.adjustments = { ...t } : delete r.adjustments;
+		const o = this._beginCommit(n);
+		try {
+			this._updateState({ data: r }, {
+				...e,
+				description: n
+			}, ["onAnyChange"]), this._notifyPlacementChange(), o.commit();
+		} catch (t) {
+			throw o.rollback(), t;
+		}
+		return this;
+	}
+	_setRoute(t, e) {
+		const n = {
+			...this._getState()?.data ?? {},
+			geometry: t
+		};
+		e ? n.adjustments = { ...e } : delete n.adjustments, this._updateState({ data: n }, { description: b("op.setShapeAdjustments") }, ["onAnyChange"]);
+	}
+	isConnector() {
+		return (this._getState()?.data)?.type === f.Type.Connector;
+	}
+	getConnectorFormat() {
+		return this.isConnector() ? (this._connectorFormat ??= new et(this), this._connectorFormat) : null;
+	}
+	async getConnectionSiteCount() {
+		const t = await this.getGeometry();
+		let e = 0;
+		return t?.forEachConnection(() => {
+			e++;
+		}), e;
+	}
+	_connectedEnd(t) {
+		return (this._getState()?.data)?.connectorEnds?.[t] ?? null;
+	}
+	_connectedMovable(t) {
+		const e = this._connectedEnd(t), n = this.getMovable()?.getRange().getSheet() ?? null;
+		return e && n ? c(n, e.id) : null;
+	}
+	_connect(t, e, n, r) {
+		const o = r?.description ?? b("op.connectShape");
+		this._protectionCheck(o);
+		const a = this.getMovable(), i = a?.getRange().getSheet() ?? null;
+		if (!a || !i) throw new S("A connector is glued on a sheet.");
+		if (e === a) throw new S("A connector cannot be glued to itself.");
+		if (e.getRange().getSheet() !== i) throw new S("A connector is glued to a movable on the same sheet.");
+		if (!(Number.isInteger(n) && n >= 0)) throw new S(`Invalid connection site: ${n}.`);
+		const h = this._beginCommit(o);
+		try {
+			const c = {
+				id: p(e, () => l(i)),
+				index: n
+			};
+			this._writeEnd(t, c, {
+				...r,
+				description: o
+			});
+			const u = () => {
+				this.isDeleted() || a.isDeleted() || this._amend(() => s(i, a, u));
+			};
+			s(i, a, u), h.commit();
+		} catch (t) {
+			throw h.rollback(), t;
+		}
+	}
+	_disconnect(t, e) {
+		const n = e?.description ?? b("op.connectShape");
+		this._protectionCheck(n), this._connectedEnd(t) && this._writeEnd(t, null, {
+			...e,
+			description: n
+		});
+	}
+	_writeEnd(t, e, n) {
+		const r = { ...this._getState()?.data ?? {} }, o = { ...r.connectorEnds };
+		e ? o[t] = e : delete o[t], o.start || o.end ? r.connectorEnds = o : delete r.connectorEnds, this._updateState({ data: r }, n, ["onAnyChange"]);
+	}
+	_notifyPlacementChange() {
+		this.getMovable()?._notifyPlacementChange?.();
+	}
+	_amend(t) {
+		const e = this._transactions;
+		return e.amend(e.getCurrentCommit(!1).getId(), () => t());
+	}
+	async getGeometry(t, e, n) {
+		if (void 0 === t || void 0 === e) {
+			const n = this.getMovable()?.getBounds();
+			if (!n) return null;
+			t ??= n.width, e ??= n.height;
+		}
+		const r = this._getState()?.data ?? {}, o = n ? nt(r, n) : r, s = await X(o, this._theme(), t, e);
+		return s && o === r && this._getState()?.data === o && !this._drawnPending && (this._drawn = {
+			data: o,
+			width: t,
+			height: e,
+			geometry: s,
+			rect: V(s),
+			connections: rt(s)
+		}), s;
+	}
+	_getDrawnRect(t, e, n) {
+		const r = this._evaluated(t, e, n);
+		if (!r?.rect) return null;
+		const o = r.width > 0 ? t / r.width : 1, s = r.height > 0 ? e / r.height : 1, a = r.rect;
+		return {
+			l: a.l * o,
+			t: a.t * s,
+			r: a.r * o,
+			b: a.b * s
+		};
+	}
+	getConnections(t, e, n) {
+		const r = n?.adjustments, o = this._evaluated(t, e, n?.onReady ?? Y);
+		if (!o) return null;
+		if (void 0 !== r) {
+			const n = o.geometry?.withAdjustments(r) ?? null;
+			return n ? rt(n.getWidth() === t && n.getHeight() === e ? n : n.resize(t, e)) : null;
+		}
+		if (o.width === t && o.height === e) return o.connections;
+		const s = o.width > 0 ? t / o.width : 1, a = o.height > 0 ? e / o.height : 1;
+		return o.connections.map((t) => ({
+			...t,
+			x: t.x * s,
+			y: t.y * a
+		}));
+	}
+	_evaluated(t, e, n) {
+		const r = this._getState()?.data;
+		if (!r) return null;
+		const o = this._drawn;
+		if (!o || o.data !== r || o.width !== t || o.height !== e) {
+			const o = this._drawnPending;
+			if (!o || o.data !== r || o.width !== t || o.height !== e) {
+				const o = {
+					data: r,
+					width: t,
+					height: e
+				};
+				this._drawnPending = o, X(r, this._theme(), t, e).then((t) => {
+					this._drawnPending === o && (this._drawnPending = null, this._drawn = {
+						...o,
+						geometry: t,
+						rect: t ? V(t) : null,
+						connections: t ? rt(t) : []
+					}, n());
+				}, () => {
+					this._drawnPending === o && (this._drawnPending = null);
+				});
+			}
+		}
+		return o;
+	}
+	_theme() {
+		try {
+			return this._getStyles?.()?.getTheme()?.toJSON() ?? null;
+		} catch {
+			return null;
+		}
+	}
+	toJSON(t) {
+		const e = this._getState();
+		let n = null;
+		return e && e.data && (n = t ? lt(e.data, this._resources, t) : e.data), n;
+	}
+	getTypeDescription() {
+		return "Shape";
+	}
+	acceptRotation(t) {
+		return t;
+	}
+	acceptFlip(t) {
+		return t;
+	}
+	get isIShape() {
+		return !0;
+	}
+	get [Symbol.toStringTag]() {
+		return "[Shape]";
+	}
+	toString() {
+		return this.getTypeDescription();
+	}
+}, et = class {
+	constructor(t) {
+		this._shape = t;
+	}
+	getEndPoints(t) {
+		const e = t ?? (this._shape.getMovable() ? m(this._shape.getMovable()) : null);
+		return e ? u(e) : null;
+	}
+	placeEnds(t, e) {
+		return h(t, e, this._shape.getMovable()?.getRotation() || 0);
+	}
+	getGluedRoute(t) {
+		const e = this._shape.getMovable(), n = e?.getRange().getSheet() ?? null;
+		if (!e || !n) return null;
+		const r = i(n, e, t ?? m, Y);
+		return r ? {
+			placement: r.placement,
+			shapeType: r.route?.geometry ?? null,
+			adjustments: r.route?.adjustments ?? null
+		} : null;
+	}
+	getConnectorType() {
+		const t = this._shape.getShapeType();
+		return t.startsWith("bentConnector") ? f.ConnectorType.Elbow : t.startsWith("curvedConnector") ? f.ConnectorType.Curved : f.ConnectorType.Straight;
+	}
+	isStartConnected() {
+		return null !== this._shape._connectedEnd("start");
+	}
+	getStartConnectedMovable() {
+		return this._shape._connectedMovable("start");
+	}
+	getStartConnectionSite() {
+		return this._shape._connectedEnd("start")?.index ?? null;
+	}
+	startConnect(t, e, n) {
+		this._shape._connect("start", t, e, n);
+	}
+	startDisconnect(t) {
+		this._shape._disconnect("start", t);
+	}
+	isEndConnected() {
+		return null !== this._shape._connectedEnd("end");
+	}
+	getEndConnectedMovable() {
+		return this._shape._connectedMovable("end");
+	}
+	getEndConnectionSite() {
+		return this._shape._connectedEnd("end")?.index ?? null;
+	}
+	endConnect(t, e, n) {
+		this._shape._connect("end", t, e, n);
+	}
+	endDisconnect(t) {
+		this._shape._disconnect("end", t);
+	}
+}, nt = (t, e) => {
+	const n = { ...t };
+	return void 0 !== e.shapeType && (n.geometry = e.shapeType), null === e.adjustments ? delete n.adjustments : void 0 !== e.adjustments && (n.adjustments = { ...e.adjustments }), n;
+}, rt = (t) => {
+	const e = [];
+	return t.forEachConnection((t) => e.push(t)), e;
+}, ot = (t) => t.runs.map((t) => t.text ?? "").join(""), st = (t) => t && t.text ? ((t) => {
+	const e = t.paragraphs.map(ot);
+	let n = 0, r = e.length;
+	for (; n < r && "" === e[n].trim();) n++;
+	for (; r > n && "" === e[r - 1].trim();) r--;
+	return e.slice(n, r).join("\n");
+})(t.text) : null, at = (t) => {
+	const e = t.fill;
+	return e?.type === d.Type.Image ? e : void 0;
+}, it = (t, e) => {
+	const n = at(t)?.resId, r = void 0 === n ? void 0 : e?.(n);
+	return r ? /* @__PURE__ */ new Map([[n, r]]) : null;
+}, lt = (t, e, n) => {
+	const r = at(t);
+	if (void 0 === r?.resId) return t;
+	const o = e?.get(r.resId), s = o ? n(o) : null, a = null == s ? void 0 : s;
+	if (a === r.resId) return t;
+	const { resId: i, ...l } = r;
+	return {
+		...t,
+		fill: void 0 === a ? l : {
+			...l,
+			resId: a
+		}
+	};
+};
+export { tt as Shape, x as n, Q as t };