@silurus/ooxml 0.48.0 → 0.49.0

package/dist/pptx.mjs

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

package/dist/types/docx.d.ts

@@ -396,9 +396,17 @@ declare interface LineSpacing {
     explicit?: boolean;
 }
 
-/** Options for {@link DocxDocument.load}. The shared load-options type from
- *  `@silurus/ooxml-core` (`useGoogleFonts`, `maxZipEntryBytes`). */
-export declare type LoadOptions = LoadOptions_2;
+/** Options for {@link DocxDocument.load}. Extends the shared load-options type
+ *  from `@silurus/ooxml-core` (`useGoogleFonts`, `maxZipEntryBytes`) with the
+ *  opt-in math engine. */
+export declare interface LoadOptions extends LoadOptions_2 {
+    /**
+     * 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;
+}
 
 /**
  * Common load-time options shared by the docx / pptx / xlsx
@@ -518,6 +526,27 @@ declare interface MathRadical {
     radicand: MathNode[];
 }
 
+/**
+ * The math engine contract a viewer needs to render equations. Satisfied by the
+ * `math` named export of the separate `@silurus/ooxml/math` entry point, which
+ * the consumer opts into:
+ *
+ * ```ts
+ * import { DocxViewer } from '@silurus/ooxml/docx';
+ * import { math } from '@silurus/ooxml/math';
+ * new DocxViewer(canvas, { math });
+ * ```
+ *
+ * Omit it and the equation engine (MathJax + STIX Two Math, ~3 MB) is never
+ * imported, so a bundler drops it entirely.
+ */
+declare interface MathRenderer {
+    /** Preload the engine. Called once before converting equations. */
+    loadMathJax(): Promise<void>;
+    /** MathML string → standalone SVG + baseline-relative em extents. */
+    mathMLToSvg(mathml: string): Promise<MathSvg>;
+}
+
 declare interface MathRun {
     kind: 'run';
     text: string;
@@ -533,6 +562,15 @@ declare interface MathScript {
 
 declare type MathStyle = 'roman' | 'italic' | 'bold' | 'boldItalic';
 
+declare interface MathSvg {
+    /** standalone `<svg>…</svg>` markup. */
+    svg: string;
+    /** extents in em (the SVG viewBox uses 1em = 1000 units). */
+    widthEm: number;
+    ascentEm: number;
+    descentEm: number;
+}
+
 declare interface NumberingInfo {
     numId: number;
     level: number;

package/dist/types/index.d.ts

@@ -1188,9 +1188,17 @@ declare interface LoadOptions_2 {
  *  `@silurus/ooxml-core` (`useGoogleFonts`, `maxZipEntryBytes`). */
 declare type LoadOptions_3 = LoadOptions_2;
 
-/** Options for {@link DocxDocument.load}. The shared load-options type from
- *  `@silurus/ooxml-core` (`useGoogleFonts`, `maxZipEntryBytes`). */
-declare type LoadOptions_4 = LoadOptions_2;
+/** Options for {@link DocxDocument.load}. Extends the shared load-options type
+ *  from `@silurus/ooxml-core` (`useGoogleFonts`, `maxZipEntryBytes`) with the
+ *  opt-in math engine. */
+declare interface LoadOptions_4 extends LoadOptions_2 {
+    /**
+     * 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 ManualLayout {
     xMode: string;
@@ -1290,6 +1298,27 @@ declare interface MathRadical {
     radicand: MathNode[];
 }
 
+/**
+ * The math engine contract a viewer needs to render equations. Satisfied by the
+ * `math` named export of the separate `@silurus/ooxml/math` entry point, which
+ * the consumer opts into:
+ *
+ * ```ts
+ * import { DocxViewer } from '@silurus/ooxml/docx';
+ * import { math } from '@silurus/ooxml/math';
+ * new DocxViewer(canvas, { math });
+ * ```
+ *
+ * Omit it and the equation engine (MathJax + STIX Two Math, ~3 MB) is never
+ * imported, so a bundler drops it entirely.
+ */
+declare interface MathRenderer {
+    /** Preload the engine. Called once before converting equations. */
+    loadMathJax(): Promise<void>;
+    /** MathML string → standalone SVG + baseline-relative em extents. */
+    mathMLToSvg(mathml: string): Promise<MathSvg>;
+}
+
 declare interface MathRun {
     kind: 'run';
     text: string;
@@ -1305,6 +1334,15 @@ declare interface MathScript {
 
 declare type MathStyle = 'roman' | 'italic' | 'bold' | 'boldItalic';
 
+declare interface MathSvg {
+    /** standalone `<svg>…</svg>` markup. */
+    svg: string;
+    /** extents in em (the SVG viewBox uses 1em = 1000 units). */
+    widthEm: number;
+    ascentEm: number;
+    descentEm: number;
+}
+
 declare interface MediaElement {
     type: 'media';
     x: number;
@@ -1796,6 +1834,13 @@ 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 {
@@ -1839,6 +1884,12 @@ 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 {

package/dist/types/math.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The OMML equation engine (MathJax + STIX Two Math). Pass it to a viewer's
+ * `math` option to enable equation rendering. Self-contained: no network, no
+ * cross-origin requests.
+ */
+export declare const math: MathRenderer;
+
+/**
+ * The math engine contract a viewer needs to render equations. Satisfied by the
+ * `math` named export of the separate `@silurus/ooxml/math` entry point, which
+ * the consumer opts into:
+ *
+ * ```ts
+ * import { DocxViewer } from '@silurus/ooxml/docx';
+ * import { math } from '@silurus/ooxml/math';
+ * new DocxViewer(canvas, { math });
+ * ```
+ *
+ * Omit it and the equation engine (MathJax + STIX Two Math, ~3 MB) is never
+ * imported, so a bundler drops it entirely.
+ */
+export declare interface MathRenderer {
+    /** Preload the engine. Called once before converting equations. */
+    loadMathJax(): Promise<void>;
+    /** MathML string → standalone SVG + baseline-relative em extents. */
+    mathMLToSvg(mathml: string): Promise<MathSvg>;
+}
+
+export declare interface MathSvg {
+    /** standalone `<svg>…</svg>` markup. */
+    svg: string;
+    /** extents in em (the SVG viewBox uses 1em = 1000 units). */
+    widthEm: number;
+    ascentEm: number;
+    descentEm: number;
+}
+
+export { }

package/dist/types/pptx.d.ts

@@ -466,6 +466,27 @@ declare interface MathRadical {
     radicand: MathNode[];
 }
 
+/**
+ * The math engine contract a viewer needs to render equations. Satisfied by the
+ * `math` named export of the separate `@silurus/ooxml/math` entry point, which
+ * the consumer opts into:
+ *
+ * ```ts
+ * import { DocxViewer } from '@silurus/ooxml/docx';
+ * import { math } from '@silurus/ooxml/math';
+ * new DocxViewer(canvas, { math });
+ * ```
+ *
+ * Omit it and the equation engine (MathJax + STIX Two Math, ~3 MB) is never
+ * imported, so a bundler drops it entirely.
+ */
+declare interface MathRenderer {
+    /** Preload the engine. Called once before converting equations. */
+    loadMathJax(): Promise<void>;
+    /** MathML string → standalone SVG + baseline-relative em extents. */
+    mathMLToSvg(mathml: string): Promise<MathSvg>;
+}
+
 declare interface MathRun {
     kind: 'run';
     text: string;
@@ -481,6 +502,15 @@ declare interface MathScript {
 
 declare type MathStyle = 'roman' | 'italic' | 'bold' | 'boldItalic';
 
+declare interface MathSvg {
+    /** standalone `<svg>…</svg>` markup. */
+    svg: string;
+    /** extents in em (the SVG viewBox uses 1em = 1000 units). */
+    widthEm: number;
+    ascentEm: number;
+    descentEm: number;
+}
+
 declare interface MediaElement {
     type: 'media';
     x: number;
@@ -831,6 +861,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;
 }
 
 /**
@@ -853,6 +890,12 @@ 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 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silurus/ooxml",
-  "version": "0.48.0",
+  "version": "0.49.0",
   "description": "Browser-based OOXML viewer (docx/xlsx/pptx) — Rust/WASM parser + Canvas renderer",
   "license": "MIT",
   "author": "Yuki Yokotani <silurus.dev@gmail.com>",
@@ -49,6 +49,10 @@
     "./pptx": {
       "import": "./dist/pptx.mjs",
       "types": "./dist/types/pptx.d.ts"
+    },
+    "./math": {
+      "import": "./dist/math.mjs",
+      "types": "./dist/types/math.d.ts"
     }
   },
   "devDependencies": {