@silurus/ooxml 0.50.0 → 0.51.0

package/README.md

@@ -30,7 +30,7 @@ pnpm add @silurus/ooxml
 
 > **Bundler note**: this package embeds `.wasm` files. With Vite add [`vite-plugin-wasm`](https://github.com/Menci/vite-plugin-wasm); with webpack use [`experiments.asyncWebAssembly`](https://webpack.js.org/configuration/experiments/).
 
-> **Bundle size note**: the package is ESM-only (`.mjs`). npm's *Unpacked Size* sums all four entry bundles, including the **opt-in** math engine (MathJax + STIX Two Math, ~3 MB). What actually lands in your app is much smaller — import only the format you need (e.g. `@silurus/ooxml/pptx`). The math engine is a **separate entry** (`@silurus/ooxml/math`): it is bundled **only if you import it and pass it to a viewer** (see [Rendering equations](#rendering-equations)). Viewers that never receive a `math` engine — and all xlsx usage — tree-shake the ~3 MB away entirely.
+> **Bundle size note**: the package is ESM-only (`.mjs`). npm's *Unpacked Size* sums all four entry bundles, including the **opt-in** math engine (MathJax + STIX Two Math, ~3 MB). What actually lands in your app is much smaller — import only the format you need (e.g. `@silurus/ooxml/pptx`). The math engine is a **separate entry** (`@silurus/ooxml/math`): it is bundled **only if you import it and pass it to a viewer** (see [Rendering equations](#rendering-equations)). Viewers that never receive a `math` engine tree-shake the ~3 MB away entirely.
 
 ---
 
@@ -78,9 +78,12 @@ const docx = new DocxViewer(canvas, { math }); // ← equations now render
 await docx.load('/paper-with-equations.docx');
 ```
 
-The same `math` engine works for `PptxViewer` and the headless `DocxDocument` /
-`PptxPresentation` APIs (which take `math` in their options). xlsx has no equation
-support and never references the engine.
+The same `math` engine works for `PptxViewer`, `XlsxViewer`, and the headless
+`DocxDocument` / `PptxPresentation` APIs (which take `math` in their options).
+Excel stores "Insert > Equation" as OMML inside the shared DrawingML `<xdr:txBody>`
+grammar, so `XlsxViewer` renders equations embedded in shapes / text boxes the same
+way — pass `math` and they render; omit it and those equations are skipped and the
+engine is tree-shaken away.
 
 ---
 
@@ -446,6 +449,7 @@ export const PptxViewerComponent = component$<{ src: string }>(({ src }) => {
 | | Hidden rows / columns | ✅ |
 | **Elements** | Images (`<xdr:twoCellAnchor>`) | ✅ |
 | | Drawing shapes / text boxes (`xdr:sp`, `xdr:txBody`) | ✅ |
+| | Math equations in shapes (OMML `m:oMath` / `m:oMathPara` in `xdr:txBody`, incl. `a14:m` / `mc:AlternateContent`; rendered via MathJax — opt-in `@silurus/ooxml/math`) | ✅ |
 | | Charts (bar, line, area, radar, scatter / bubble) | ✅ |
 | | Chart markers (circle / square / diamond / triangle / x / plus / star / dot / dash, per-point `<c:dPt>` overrides) | ✅ |
 | | Chart data labels (`<c:dLbl>` per-point with CELLRANGE / VALUE / SERIESNAME / CATEGORYNAME field references, position `l`/`r`/`t`/`b`/`ctr`/`outEnd`) | ✅ |

package/dist/bridge-BFwyMqvY.js

@@ -0,0 +1,228 @@
+//#region \0rolldown/runtime.js
+var e = Object.defineProperty, t = (t, n) => {
+	let r = {};
+	for (var i in t) e(r, i, {
+		get: t[i],
+		enumerable: !0
+	});
+	return n || e(r, Symbol.toStringTag, { value: "Module" }), r;
+}, n = 3e3, r = 20, i = 25;
+async function a(e, t) {
+	if (typeof document > "u") return;
+	let a = /* @__PURE__ */ new Set(), o = /* @__PURE__ */ new Set();
+	for (let n of e) {
+		if (!n) continue;
+		let e = n.toLowerCase();
+		if (a.has(e)) continue;
+		a.add(e);
+		let r = t[e];
+		if (r) {
+			if (!document.querySelector(`link[href="${r.url}"]`)) try {
+				let e = document.createElement("link");
+				e.rel = "stylesheet", e.href = r.url, document.head.appendChild(e);
+			} catch {}
+			o.add((r.loadFamily ?? n).toLowerCase());
+		}
+	}
+	if (o.size === 0) return;
+	let s = [];
+	for (let e = 0; e < i && (s = [...document.fonts].filter((e) => o.has(e.family.toLowerCase())), !(s.length > 0)); e++) await new Promise((e) => setTimeout(e, r));
+	await Promise.race([Promise.allSettled(s.map((e) => e.load())).then(() => document.fonts.ready), new Promise((e) => setTimeout(e, n))]);
+}
+//#endregion
+//#region packages/core/src/units.ts
+var o = 12700, s = 9525, c = 4 / 3;
+//#endregion
+//#region packages/core/src/autoResize.ts
+function l(e, t, n = {}) {
+	let r = n.pauseWhenHidden ?? !0, i = null, a = 0, o = 0, s = null, c = !1, l = !1, u = () => {
+		if (!l && !(r && typeof document < "u" && document.hidden)) {
+			if (s) {
+				c = !0;
+				return;
+			}
+			i === null && (i = requestAnimationFrame(d));
+		}
+	}, d = async () => {
+		if (i = null, l) return;
+		let t = a, n = o;
+		try {
+			let r = e(t, n);
+			s = r instanceof Promise ? r : Promise.resolve(), await s;
+		} catch (e) {
+			console.error("[autoResize] render failed:", e);
+		} finally {
+			s = null, c && !l && (c = !1, u());
+		}
+	}, f = new ResizeObserver((e) => {
+		for (let t of e) {
+			let e = t.contentRect;
+			a = e.width, o = e.height;
+		}
+		u();
+	});
+	f.observe(t);
+	let p = () => {
+		typeof document < "u" && !document.hidden && u();
+	};
+	return r && typeof document < "u" && document.addEventListener("visibilitychange", p), () => {
+		l = !0, f.disconnect(), i !== null && (cancelAnimationFrame(i), i = null), r && typeof document < "u" && document.removeEventListener("visibilitychange", p);
+	};
+}
+//#endregion
+//#region packages/core/src/math/mathml.ts
+var u = {
+	"&": "&amp;",
+	"<": "&lt;",
+	">": "&gt;",
+	"\"": "&quot;"
+}, d = (e) => e.replace(/[&<>"]/g, (e) => u[e]);
+function f(e) {
+	switch (e) {
+		case "roman": return "normal";
+		case "bold": return "bold";
+		case "boldItalic": return "bold-italic";
+		case "italic": return null;
+	}
+}
+var p = new Set([..."⏞⏟⎴⎵︷︸⏜⏝{}[]()¯_‾"]), m = "+−±∓×÷·∗⋅∘∙*/", h = "=≠<>≤≥≈≡∼≅≃→←↔⇒∈∉⊂⊆⊃⊇∝≪≫⊥≔", g = "([{⟨⌈⌊", _ = ")]}⟩⌉⌋", v = ",;";
+function y(e, t) {
+	let n = f(t), r = n ? ` mathvariant="${n}"` : "", i = "", a = "", o = () => {
+		a &&= (i += `<mn${r}>${d(a)}</mn>`, "");
+	};
+	for (let t of e) {
+		if (t === " ") {
+			o();
+			continue;
+		}
+		if (t >= "0" && t <= "9") {
+			a += t;
+			continue;
+		}
+		o(), m.includes(t) || h.includes(t) || v.includes(t) ? i += `<mo>${d(t)}</mo>` : g.includes(t) || _.includes(t) ? i += `<mo fence="true" stretchy="false">${d(t)}</mo>` : i += `<mi${r}>${d(t)}</mi>`;
+	}
+	return o(), i;
+}
+function b(e) {
+	return e.map(S).join("");
+}
+function x(e) {
+	return `<mrow>${b(e)}</mrow>`;
+}
+function S(e) {
+	switch (e.kind) {
+		case "run": return y(e.text, e.style);
+		case "group": return x(e.items);
+		case "fraction": return `<mfrac${e.bar === !1 ? " linethickness=\"0\"" : ""}>${x(e.num)}${x(e.den)}</mfrac>`;
+		case "sup": return `<msup>${x(e.base)}${x(e.sup ?? [])}</msup>`;
+		case "sub": return `<msub>${x(e.base)}${x(e.sub ?? [])}</msub>`;
+		case "subSup": return `<msubsup>${x(e.base)}${x(e.sub ?? [])}${x(e.sup ?? [])}</msubsup>`;
+		case "nary": return k(e);
+		case "delimiter": return A(e);
+		case "radical": return e.index && e.index.length ? `<mroot>${x(e.radicand)}${x(e.index)}</mroot>` : `<msqrt>${b(e.radicand)}</msqrt>`;
+		case "limit": return E(e);
+		case "array": return D(e);
+		case "groupChr": {
+			let t = x(e.base), n = p.has(e.char), r = e.pos === "top" ? "mover" : "munder", i = `<mo stretchy="${n}">${d(e.char)}</mo>`;
+			return n ? `<${r}>${t}${i}</${r}>` : `<${r} accent="true">${t}${i}</${r}>`;
+		}
+		case "bar": {
+			let t = x(e.base), n = "<mo stretchy=\"true\">&#x2015;</mo>";
+			return e.pos === "bot" ? `<munder>${t}${n}</munder>` : `<mover>${t}${n}</mover>`;
+		}
+		case "accent": return T(e);
+		case "func": return `<mrow>${x(e.name)}<mo>&#x2061;</mo>${x(e.arg)}</mrow>`;
+	}
+}
+var C = {
+	"̀": "`",
+	"́": "´",
+	"̂": "^",
+	"̃": "~",
+	"̆": "˘",
+	"̇": "˙",
+	"̈": "¨",
+	"̌": "ˇ",
+	"⃗": "→",
+	"⃖": "←"
+}, w = new Set([
+	"̅",
+	"̄",
+	"¯",
+	"‾",
+	"̲",
+	"̳"
+]);
+function T(e) {
+	let t = x(e.base);
+	if (w.has(e.char)) return `<mover>${t}<mo stretchy="true">&#x2015;</mo></mover>`;
+	let n = C[e.char] ?? e.char;
+	return `<mover accent="true">${t}<mo stretchy="${n === "→" || n === "←" ? "true" : "false"}">${d(n)}</mo></mover>`;
+}
+function E(e) {
+	let t = x(e.base), n = e.lower && e.lower.length ? x(e.lower) : null, r = e.upper && e.upper.length ? x(e.upper) : null;
+	return n && r ? `<munderover>${t}${n}${r}</munderover>` : n ? `<munder>${t}${n}</munder>` : r ? `<mover>${t}${r}</mover>` : t;
+}
+function D(e) {
+	let t = Math.max(1, ...e.rows.map((e) => e.length)), n;
+	n = e.align === "eq" ? Array.from({ length: t }, (e, t) => t % 2 == 0 ? "right" : "left").join(" ") : e.align === "left" ? "left" : "center";
+	let r = e.rows.map((e) => `<mtr>${e.map((e) => `<mtd>${b(e)}</mtd>`).join("")}</mtr>`).join("");
+	return `<mtable columnalign="${n}" rowspacing="0.2em" columnspacing="0.3em">${r}</mtable>`;
+}
+var O = new Set([..."∫∬∭∮∯∰∱∲∳⨌⨍⨎⨏⨐⨑⨒⨓⨔⨕⨖⨗"]);
+function k(e) {
+	let t = e.limLoc === "subSup" ? !0 : e.limLoc === "undOvr" ? !1 : O.has(e.op), n = `<mo largeop="true">${d(e.op)}</mo>`, r = e.sub ?? [], i = e.sup ?? [], a;
+	return a = t ? r.length && i.length ? `<msubsup>${n}${x(r)}${x(i)}</msubsup>` : r.length ? `<msub>${n}${x(r)}</msub>` : i.length ? `<msup>${n}${x(i)}</msup>` : n : r.length && i.length ? `<munderover>${n}${x(r)}${x(i)}</munderover>` : r.length ? `<munder>${n}${x(r)}</munder>` : i.length ? `<mover>${n}${x(i)}</mover>` : n, `<mrow>${a}${b(e.body)}</mrow>`;
+}
+function A(e) {
+	let t = (e) => `<mo fence="true" stretchy="true">${d(e)}</mo>`, n = e.items.map((e) => x(e)).join("<mo separator=\"true\">,</mo>");
+	return `<mrow>${t(e.begChar)}${n}${t(e.endChar)}</mrow>`;
+}
+function j(e, t) {
+	return `<math xmlns="http://www.w3.org/1998/Math/MathML" display="${t ? "block" : "inline"}">${b(e)}</math>`;
+}
+//#endregion
+//#region packages/core/src/worker/bridge.ts
+var M = class {
+	_worker;
+	_opts;
+	_pending = /* @__PURE__ */ new Map();
+	_nextId = 1;
+	constructor(e, t) {
+		this._worker = e, this._opts = t, this._worker.addEventListener("message", this._handle);
+	}
+	_handle = (e) => {
+		let t = e.data, n = this._opts.correlate(t);
+		if (n === void 0) {
+			this._opts.onUnsolicited?.(t);
+			return;
+		}
+		let r = this._pending.get(n);
+		if (!r) return;
+		this._pending.delete(n);
+		let i = this._opts.toError?.(t);
+		i === void 0 ? r.resolve(t) : r.reject(Error(i));
+	};
+	nextId() {
+		return this._nextId++;
+	}
+	request(e, t) {
+		let n = this._nextId++;
+		return new Promise((r, i) => {
+			this._pending.set(n, {
+				resolve: r,
+				reject: i
+			}), this._worker.postMessage(e(n), t);
+		});
+	}
+	post(e, t) {
+		this._worker.postMessage(e, t);
+	}
+	terminate() {
+		this._worker.removeEventListener("message", this._handle), this._worker.terminate();
+		for (let e of this._pending.values()) e.reject(/* @__PURE__ */ Error("Worker terminated"));
+		this._pending.clear();
+	}
+};
+//#endregion
+export { s as a, t as c, o as i, j as n, c as o, l as r, a as s, M as t };