@silurus/ooxml 0.54.0 → 0.55.0

package/README.md

@@ -61,7 +61,7 @@ pptx.nextSlide();
 
 ### Rendering equations
 
-OMML equations (`m:oMath` / `m:oMathPara`) in `.docx` / `.pptx` are rendered with
+OMML equations (`m:oMath` / `m:oMathPara`) in `.docx`, `.pptx` and `.xlsx` are rendered with
 [MathJax](https://www.mathjax.org/) + [STIX Two Math](https://github.com/stipub/stixfonts).
 That engine is ~3 MB, so it is **opt-in**: import the `math` engine from the separate
 `@silurus/ooxml/math` entry and pass it to the viewer. Pass it and equations render;
@@ -78,12 +78,13 @@ const docx = new DocxViewer(canvas, { math }); // ← equations now render
 await docx.load('/paper-with-equations.docx');
 ```
 
-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.
+The same `math` engine works for every viewer (`DocxViewer`, `PptxViewer`,
+`XlsxViewer`) and every headless engine (`DocxDocument`, `PptxPresentation`,
+`XlsxWorkbook`). You inject it **once** where you create the object — the viewer
+constructor or the `.load()` options — and every render reuses it; it is never a
+per-render argument. (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.)
 
 ---
 

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { t as e } from "./xlsx-Bz2w8zCX.js";
-import { t } from "./pptx-CFkdpZJb.js";
+import { t as e } from "./xlsx-B0LYjpRC.js";
+import { t } from "./pptx-BeLN0lIn.js";
 import { t as n } from "./docx-DtI9YHuK.js";
 export { n as docx, t as pptx, e as xlsx };

package/dist/{pptx-CFkdpZJb.js → pptx-BeLN0lIn.js}

@@ -23315,6 +23315,7 @@ var ze = "data:application/wasm;base64,AGFzbQEAAAAB8gIwYAJ/fwBgAn9/AX9gA39/fwBgA
 	_mediaCache = /* @__PURE__ */ new Map();
 	_workerReady = !1;
 	_workerReadyCallbacks = [];
+	_math;
 	constructor() {
 		this._worker = new Re(), this._bridge = new o(this._worker, {
 			correlate: (e) => "id" in e ? e.id : void 0,
@@ -23340,7 +23341,7 @@ var ze = "data:application/wasm;base64,AGFzbQEAAAAB8gIwYAJ/fwBgAn9/AX9gA39/fwBgA
 			if (!e.ok) throw Error(`Failed to fetch: ${e.status} ${e.statusText}`);
 			i = await e.arrayBuffer();
 		} else i = t;
-		await r._parse(i, n.maxZipEntryBytes);
+		r._math = n.math, await r._parse(i, n.maxZipEntryBytes);
 		let o = r._presentation;
 		return n.useGoogleFonts && o && await a([o.majorFont, o.minorFont], Be), r;
 	}
@@ -23378,7 +23379,7 @@ var ze = "data:application/wasm;base64,AGFzbQEAAAAB8gIwYAJ/fwBgAn9/AX9gA39/fwBgA
 			hlinkColor: this._presentation.hlinkColor ?? null,
 			fetchMedia: (e) => this.getMedia(e),
 			skipMediaControls: n.skipMediaControls,
-			math: n.math
+			math: this._math
 		}, n.onTextRun);
 	}
 	async getMedia(e) {
@@ -23419,8 +23420,7 @@ var ze = "data:application/wasm;base64,AGFzbQEAAAAB8gIwYAJ/fwBgAn9/AX9gA39/fwBgA
 				width: a,
 				dpr: i,
 				skipMediaControls: !0,
-				onTextRun: n.onTextRun,
-				math: n.math
+				onTextRun: n.onTextRun
 			})
 		});
 	}
@@ -23444,7 +23444,8 @@ var ze = "data:application/wasm;base64,AGFzbQEAAAAB8gIwYAJ/fwBgAn9/AX9gA39/fwBgA
 		try {
 			this.engine = await Ve.load(e, {
 				useGoogleFonts: this.opts.useGoogleFonts,
-				maxZipEntryBytes: this.opts.maxZipEntryBytes
+				maxZipEntryBytes: this.opts.maxZipEntryBytes,
+				math: this.opts.math
 			}), this.currentSlide = 0, await this.renderCurrentSlide();
 		} catch (e) {
 			let t = e instanceof Error ? e : Error(String(e));
@@ -23481,13 +23482,11 @@ var ze = "data:application/wasm;base64,AGFzbQEAAAAB8gIwYAJ/fwBgAn9/AX9gA39/fwBgA
 		try {
 			this.opts.enableMediaPlayback ? this.handle = await this.engine.presentSlide(this.canvas, this.currentSlide, {
 				width: e,
-				dpr: t,
-				math: this.opts.math
+				dpr: t
 			}) : await this.engine.renderSlide(this.canvas, this.currentSlide, {
 				width: e,
 				dpr: t,
-				onTextRun: a,
-				math: this.opts.math
+				onTextRun: a
 			}), this.opts.onSlideChange?.(this.currentSlide, this.slideCount);
 		} catch (e) {
 			this.opts.onError?.(e instanceof Error ? e : Error(String(e)));

package/dist/pptx.mjs

@@ -1,3 +1,3 @@
 import { r as e } from "./bridge-BFwyMqvY.js";
-import { i as t, n, r } from "./pptx-CFkdpZJb.js";
+import { i as t, n, r } from "./pptx-BeLN0lIn.js";
 export { r as PptxPresentation, n as PptxViewer, e as autoResize, t as renderSlide };

package/dist/types/docx.d.ts

@@ -436,6 +436,16 @@ declare interface LoadOptions_2 {
      * untrusted input. Zero / negative values fall back to the default.
      */
     maxZipEntryBytes?: number;
+    /**
+     * Opt-in OMML equation engine (MathJax + STIX Two Math, ~3 MB). Inject it
+     * **once** here and every render of this document / presentation / workbook
+     * uses it — the same dependency-injection contract across all three formats
+     * and their viewers. Import it from the separate `@silurus/ooxml/math` entry
+     * (`import { math } from '@silurus/ooxml/math'`). Omit it and equations are
+     * skipped and the engine tree-shakes away entirely (no network, no bundle
+     * cost).
+     */
+    math?: MathRenderer;
 }
 
 /** Accent (`m:acc`), e.g. hat, bar, vector arrow over the base. */

package/dist/types/index.d.ts

@@ -1182,6 +1182,16 @@ declare interface LoadOptions_2 {
      * untrusted input. Zero / negative values fall back to the default.
      */
     maxZipEntryBytes?: number;
+    /**
+     * Opt-in OMML equation engine (MathJax + STIX Two Math, ~3 MB). Inject it
+     * **once** here and every render of this document / presentation / workbook
+     * uses it — the same dependency-injection contract across all three formats
+     * and their viewers. Import it from the separate `@silurus/ooxml/math` entry
+     * (`import { math } from '@silurus/ooxml/math'`). Omit it and equations are
+     * skipped and the engine tree-shakes away entirely (no network, no bundle
+     * cost).
+     */
+    math?: MathRenderer;
 }
 
 /** Options for {@link XlsxWorkbook.load}. The shared load-options type from
@@ -1634,6 +1644,10 @@ declare class PptxPresentation {
     private _mediaCache;
     private _workerReady;
     private _workerReadyCallbacks;
+    /** Opt-in OMML equation engine, injected once at {@link load}. Every
+     *  `renderSlide` / `presentSlide` reuses it — equations render when present,
+     *  and are skipped (engine tree-shaken) when omitted. */
+    private _math;
     private constructor();
     /** Parse a PPTX from URL or ArrayBuffer. */
     static load(source: string | ArrayBuffer, opts?: LoadOptions): Promise<PptxPresentation>;
@@ -1737,23 +1751,11 @@ declare class PptxViewer {
     destroy(): void;
 }
 
-declare interface PptxViewerOptions extends RenderOptions {
+declare interface PptxViewerOptions extends RenderOptions, LoadOptions {
     /** Called when a slide finishes rendering */
     onSlideChange?: (index: number, total: number) => void;
     /** Called on parse or render errors */
     onError?: (err: Error) => void;
-    /**
-     * Opt in to loading theme-declared webfonts from Google Fonts. Off by
-     * default — see {@link PptxPresentation.load} for privacy implications.
-     */
-    useGoogleFonts?: boolean;
-    /**
-     * Override the per-entry ZIP decompression cap (bytes) used by the zip-bomb
-     * guard in the Rust parser. Defaults to 512 MiB. Raise this to load decks
-     * with very large embedded media, or lower it to tighten the budget for
-     * untrusted input. Zero / negative values fall back to the default.
-     */
-    maxZipEntryBytes?: number;
     /**
      * Enable interactive audio/video playback. When true, slides are rendered
      * via {@link PptxPresentation.presentSlide} so media elements become
@@ -1834,13 +1836,6 @@ declare interface RenderOptions {
      * the static renderer drawing a duplicate play badge.
      */
     skipMediaControls?: boolean;
-    /**
-     * Opt-in OMML equation engine. Import it from the separate `@silurus/ooxml/math`
-     * entry and pass it in: `import { math } from '@silurus/ooxml/math'`. When
-     * omitted, equations are skipped and the ~3 MB engine tree-shakes out of the
-     * bundle entirely (it is referenced nowhere unless you import it).
-     */
-    math?: MathRenderer;
 }
 
 declare interface RenderPageOptions {
@@ -1868,7 +1863,7 @@ declare interface RenderPageOptions {
  * Render a single slide onto a <canvas> element.
  * Returns the canvas for convenience.
  */
-declare function renderSlide(canvas: HTMLCanvasElement | OffscreenCanvas, slide: Slide, slideWidth: number, slideHeight: number, opts?: RenderOptions, onTextRun?: TextRunCallback): Promise<HTMLCanvasElement | OffscreenCanvas>;
+declare function renderSlide(canvas: HTMLCanvasElement | OffscreenCanvas, slide: Slide, slideWidth: number, slideHeight: number, opts?: SlideRenderOptions, onTextRun?: TextRunCallback): Promise<HTMLCanvasElement | OffscreenCanvas>;
 
 /** Options for rendering a single slide onto a canvas. */
 declare interface RenderSlideOptions {
@@ -1884,12 +1879,6 @@ declare interface RenderSlideOptions {
      * its own play/pause chrome without duplication.
      */
     skipMediaControls?: boolean;
-    /**
-     * Opt-in OMML equation engine. Import it from the separate `@silurus/ooxml/math`
-     * entry and pass it in: `import { math } from '@silurus/ooxml/math'`. When
-     * omitted, equations are skipped and the ~3 MB engine never enters the bundle.
-     */
-    math?: MathRenderer;
 }
 
 declare interface RenderViewportOptions {
@@ -1906,11 +1895,6 @@ declare interface RenderViewportOptions {
     cellScale?: number;
     /** Pre-loaded Image elements keyed by their dataUrl (for ImageAnchor rendering). */
     loadedImages?: Map<string, HTMLImageElement>;
-    /** Opt-in OMML equation engine. Import it from the separate `@silurus/ooxml/math`
-     *  entry and pass it in (`import { math } from '@silurus/ooxml/math'`). When
-     *  omitted, equations in shapes are skipped and the ~3 MB engine never enters
-     *  the bundle. Same DI contract as docx/pptx. */
-    math?: MathRenderer;
     /** Called once per cell that contains text, with canvas-pixel position and cell address. */
     onTextRun?: (info: XlsxTextRunInfo) => void;
     /** Highlighted row range for selected row headers (1-indexed inclusive).
@@ -2295,6 +2279,16 @@ declare interface Slide {
 
 declare type SlideElement = ShapeElement | PictureElement | TableElement | ChartElement | MediaElement;
 
+/**
+ * Internal render options: the shared {@link RenderOptions} plus the opt-in
+ * `math` engine. `math` is internal plumbing — the headless {@link
+ * PptxPresentation} injects it once at load and threads it here on each draw,
+ * so the public `RenderSlideOptions` deliberately does not expose it.
+ */
+declare type SlideRenderOptions = RenderOptions & {
+    math?: MathRenderer;
+};
+
 /** ECMA-376 §20.1.8.31 (CT_SoftEdgesEffect) — feather radius in EMU. */
 declare interface SoftEdge {
     radius: number;
@@ -2929,6 +2923,10 @@ declare class XlsxWorkbook {
     private imageCache;
     private rawData;
     private maxZipEntryBytes;
+    /** Opt-in OMML equation engine, injected once at {@link load}. Every
+     *  `renderViewport` call reuses it — equations in shapes render when present,
+     *  and are skipped (engine tree-shaken) when omitted. */
+    private math;
     private constructor();
     /** Parse an XLSX from a URL or ArrayBuffer. */
     static load(source: string | ArrayBuffer, opts?: LoadOptions_3): Promise<XlsxWorkbook>;

package/dist/types/pptx.d.ts

@@ -376,6 +376,16 @@ declare interface LoadOptions_2 {
      * untrusted input. Zero / negative values fall back to the default.
      */
     maxZipEntryBytes?: number;
+    /**
+     * Opt-in OMML equation engine (MathJax + STIX Two Math, ~3 MB). Inject it
+     * **once** here and every render of this document / presentation / workbook
+     * uses it — the same dependency-injection contract across all three formats
+     * and their viewers. Import it from the separate `@silurus/ooxml/math` entry
+     * (`import { math } from '@silurus/ooxml/math'`). Omit it and equations are
+     * skipped and the engine tree-shakes away entirely (no network, no bundle
+     * cost).
+     */
+    math?: MathRenderer;
 }
 
 /** Accent (`m:acc`), e.g. hat, bar, vector arrow over the base. */
@@ -661,6 +671,10 @@ export declare class PptxPresentation {
     private _mediaCache;
     private _workerReady;
     private _workerReadyCallbacks;
+    /** Opt-in OMML equation engine, injected once at {@link load}. Every
+     *  `renderSlide` / `presentSlide` reuses it — equations render when present,
+     *  and are skipped (engine tree-shaken) when omitted. */
+    private _math;
     private constructor();
     /** Parse a PPTX from URL or ArrayBuffer. */
     static load(source: string | ArrayBuffer, opts?: LoadOptions): Promise<PptxPresentation>;
@@ -764,23 +778,11 @@ export declare class PptxViewer {
     destroy(): void;
 }
 
-export declare interface PptxViewerOptions extends RenderOptions {
+export declare interface PptxViewerOptions extends RenderOptions, LoadOptions {
     /** Called when a slide finishes rendering */
     onSlideChange?: (index: number, total: number) => void;
     /** Called on parse or render errors */
     onError?: (err: Error) => void;
-    /**
-     * Opt in to loading theme-declared webfonts from Google Fonts. Off by
-     * default — see {@link PptxPresentation.load} for privacy implications.
-     */
-    useGoogleFonts?: boolean;
-    /**
-     * Override the per-entry ZIP decompression cap (bytes) used by the zip-bomb
-     * guard in the Rust parser. Defaults to 512 MiB. Raise this to load decks
-     * with very large embedded media, or lower it to tighten the budget for
-     * untrusted input. Zero / negative values fall back to the default.
-     */
-    maxZipEntryBytes?: number;
     /**
      * Enable interactive audio/video playback. When true, slides are rendered
      * via {@link PptxPresentation.presentSlide} so media elements become
@@ -861,20 +863,13 @@ export declare interface RenderOptions {
      * the static renderer drawing a duplicate play badge.
      */
     skipMediaControls?: boolean;
-    /**
-     * Opt-in OMML equation engine. Import it from the separate `@silurus/ooxml/math`
-     * entry and pass it in: `import { math } from '@silurus/ooxml/math'`. When
-     * omitted, equations are skipped and the ~3 MB engine tree-shakes out of the
-     * bundle entirely (it is referenced nowhere unless you import it).
-     */
-    math?: MathRenderer;
 }
 
 /**
  * Render a single slide onto a <canvas> element.
  * Returns the canvas for convenience.
  */
-export declare function renderSlide(canvas: HTMLCanvasElement | OffscreenCanvas, slide: Slide, slideWidth: number, slideHeight: number, opts?: RenderOptions, onTextRun?: TextRunCallback): Promise<HTMLCanvasElement | OffscreenCanvas>;
+export declare function renderSlide(canvas: HTMLCanvasElement | OffscreenCanvas, slide: Slide, slideWidth: number, slideHeight: number, opts?: SlideRenderOptions, onTextRun?: TextRunCallback): Promise<HTMLCanvasElement | OffscreenCanvas>;
 
 /** Options for rendering a single slide onto a canvas. */
 export declare interface RenderSlideOptions {
@@ -890,12 +885,6 @@ export declare interface RenderSlideOptions {
      * its own play/pause chrome without duplication.
      */
     skipMediaControls?: boolean;
-    /**
-     * Opt-in OMML equation engine. Import it from the separate `@silurus/ooxml/math`
-     * entry and pass it in: `import { math } from '@silurus/ooxml/math'`. When
-     * omitted, equations are skipped and the ~3 MB engine never enters the bundle.
-     */
-    math?: MathRenderer;
 }
 
 declare interface Shadow {
@@ -968,6 +957,16 @@ export declare interface Slide {
 
 export declare type SlideElement = ShapeElement | PictureElement | TableElement | ChartElement | MediaElement;
 
+/**
+ * Internal render options: the shared {@link RenderOptions} plus the opt-in
+ * `math` engine. `math` is internal plumbing — the headless {@link
+ * PptxPresentation} injects it once at load and threads it here on each draw,
+ * so the public `RenderSlideOptions` deliberately does not expose it.
+ */
+declare type SlideRenderOptions = RenderOptions & {
+    math?: MathRenderer;
+};
+
 /** ECMA-376 §20.1.8.31 (CT_SoftEdgesEffect) — feather radius in EMU. */
 declare interface SoftEdge {
     radius: number;

package/dist/types/xlsx.d.ts

@@ -464,6 +464,16 @@ declare interface LoadOptions_2 {
      * untrusted input. Zero / negative values fall back to the default.
      */
     maxZipEntryBytes?: number;
+    /**
+     * Opt-in OMML equation engine (MathJax + STIX Two Math, ~3 MB). Inject it
+     * **once** here and every render of this document / presentation / workbook
+     * uses it — the same dependency-injection contract across all three formats
+     * and their viewers. Import it from the separate `@silurus/ooxml/math` entry
+     * (`import { math } from '@silurus/ooxml/math'`). Omit it and equations are
+     * skipped and the engine tree-shakes away entirely (no network, no bundle
+     * cost).
+     */
+    math?: MathRenderer;
 }
 
 declare interface ManualLayout {
@@ -682,11 +692,6 @@ export declare interface RenderViewportOptions {
     cellScale?: number;
     /** Pre-loaded Image elements keyed by their dataUrl (for ImageAnchor rendering). */
     loadedImages?: Map<string, HTMLImageElement>;
-    /** Opt-in OMML equation engine. Import it from the separate `@silurus/ooxml/math`
-     *  entry and pass it in (`import { math } from '@silurus/ooxml/math'`). When
-     *  omitted, equations in shapes are skipped and the ~3 MB engine never enters
-     *  the bundle. Same DI contract as docx/pptx. */
-    math?: MathRenderer;
     /** Called once per cell that contains text, with canvas-pixel position and cell address. */
     onTextRun?: (info: XlsxTextRunInfo) => void;
     /** Highlighted row range for selected row headers (1-indexed inclusive).
@@ -1249,6 +1254,10 @@ export declare class XlsxWorkbook {
     private imageCache;
     private rawData;
     private maxZipEntryBytes;
+    /** Opt-in OMML equation engine, injected once at {@link load}. Every
+     *  `renderViewport` call reuses it — equations in shapes render when present,
+     *  and are skipped (engine tree-shaken) when omitted. */
+    private math;
     private constructor();
     /** Parse an XLSX from a URL or ArrayBuffer. */
     static load(source: string | ArrayBuffer, opts?: LoadOptions): Promise<XlsxWorkbook>;

package/dist/{xlsx-Bz2w8zCX.js → xlsx-B0LYjpRC.js}

@@ -2748,6 +2748,7 @@ var dn = {
 	imageCache = /* @__PURE__ */ new Map();
 	rawData = null;
 	maxZipEntryBytes;
+	math;
 	constructor() {
 		this.worker = new h(), this.bridge = new o(this.worker, {
 			correlate: (e) => e.id,
@@ -2770,7 +2771,7 @@ var dn = {
 			if (!t.ok) throw Error(`Failed to fetch: ${t.status} ${t.statusText}`);
 			n = await t.arrayBuffer();
 		} else n = e;
-		if (this.rawData = n, this.maxZipEntryBytes = t.maxZipEntryBytes, this.parsedWorkbook = (await this.bridge.request((e) => ({
+		if (this.rawData = n, this.maxZipEntryBytes = t.maxZipEntryBytes, this.math = t.math, this.parsedWorkbook = (await this.bridge.request((e) => ({
 			type: "parse",
 			id: e,
 			data: n.slice(0),
@@ -2816,7 +2817,7 @@ var dn = {
 			t.src = e, await new Promise((e, n) => {
 				t.onload = () => e(), t.onerror = () => n(/* @__PURE__ */ Error("image decode failed"));
 			}), this.imageCache.set(e, t);
-		})).catch(() => {}), r.math && Pt(i) && await Ft(i, r.math);
+		})).catch(() => {}), this.math && Pt(i) && await Ft(i, this.math);
 		let s = r.dpr ?? (typeof window < "u" ? window.devicePixelRatio : 1), c = e instanceof HTMLCanvasElement ? e.clientWidth || 800 : e.width, l = e instanceof HTMLCanvasElement ? e.clientHeight || 600 : e.height, u = r.width ?? c, d = r.height ?? l;
 		e.width = Math.round(u * s), e.height = Math.round(d * s), e instanceof HTMLCanvasElement && (e.style.width = `${u}px`, e.style.height = `${d}px`);
 		let f = e.getContext("2d");
@@ -2918,7 +2919,8 @@ var vn = class {
 		try {
 			this.wb = await fn.load(e, {
 				useGoogleFonts: this.opts.useGoogleFonts,
-				maxZipEntryBytes: this.opts.maxZipEntryBytes
+				maxZipEntryBytes: this.opts.maxZipEntryBytes,
+				math: this.opts.math
 			}), this.buildTabs(), this.opts.onReady?.(this.wb.sheetNames), await this.showSheet(0);
 		} catch (e) {
 			let t = e instanceof Error ? e : Error(String(e));
@@ -3366,8 +3368,7 @@ var vn = class {
 			freezeRows: a,
 			freezeCols: o,
 			selectedRowRange: x,
-			selectedColRange: S,
-			math: this.opts.math
+			selectedColRange: S
 		});
 	}
 	computeHeaderHighlight() {

package/dist/xlsx.mjs

@@ -1,3 +1,3 @@
 import { r as e } from "./bridge-BFwyMqvY.js";
-import { n as t, r as n } from "./xlsx-Bz2w8zCX.js";
+import { n as t, r as n } from "./xlsx-B0LYjpRC.js";
 export { t as XlsxViewer, n as XlsxWorkbook, e as autoResize };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silurus/ooxml",
-  "version": "0.54.0",
+  "version": "0.55.0",
   "description": "Browser-based OOXML viewer (docx/xlsx/pptx) — Rust/WASM parser + Canvas renderer",
   "license": "MIT",
   "author": "Yuki Yokotani <silurus.dev@gmail.com>",