@silurus/ooxml 0.70.0 → 0.70.2

package/README.md

@@ -29,11 +29,23 @@ pnpm add @silurus/ooxml
 
 > **Bundler note**: the Rust parsers ship as real `.wasm` asset files next to the
 > JavaScript, referenced with the standard `new URL('…', import.meta.url)` form
-> and fetched (streaming-compiled) at load time. Vite, webpack 5, Rollup,
-> esbuild and Parcel detect that reference and copy the asset automatically — no
-> extra WebAssembly plugin is required. If your bundler cannot emit the asset (or
-> you want to serve the parser WASM from a CDN or a path you control), pass its
-> URL via the `wasmUrl` load option:
+> and fetched (streaming-compiled) at load time. Verified to work with zero
+> config: **webpack 5**, **Next.js** (Turbopack, dev and build), **Vite 8**
+> (dev and build), **Vite 7 production builds**, and a plain
+> `<script type="module">` with no bundler at all. Two setups need a hand:
+>
+> - **Vite 7 dev server**: the dependency optimizer rewrites the asset reference
+>   into its own cache path and the load fails (fixed in Vite 8). Add
+>   `optimizeDeps: { exclude: ['@silurus/ooxml'] }` to your `vite.config` —
+>   production builds are unaffected.
+> - **esbuild / Angular CLI** (whose application builder is esbuild-based):
+>   `new URL` asset references are not processed
+>   ([esbuild#795](https://github.com/evanw/esbuild/issues/795)). Copy the
+>   `.wasm` into your served output and point the viewer at it with the
+>   `wasmUrl` load option — see the [Angular example](#framework-examples) for
+>   the two-step setup.
+>
+> `wasmUrl` also serves the parser WASM from a CDN or any path you control:
 >
 > ```typescript
 > new DocxViewer(canvas, { wasmUrl: 'https://cdn.example.com/docx_parser_bg.wasm' });
@@ -376,6 +388,28 @@ onMounted(async () => {
 <details>
 <summary><strong>Angular 19</strong></summary>
 
+The Angular CLI's esbuild-based builder does not process the `new URL('…', import.meta.url)`
+asset reference the parsers use ([angular-cli#22388](https://github.com/angular/angular-cli/issues/22388)),
+so the `.wasm` never reaches the build output — and under `ng serve` the dependency
+optimizer additionally rewrites the reference into its own cache path. **Both steps
+below are required** (the asset copy alone fixes only production builds; `ng serve`
+still 404s without `wasmUrl`):
+
+```jsonc
+// angular.json — copy the parser WASM into the served root
+// (restart `ng serve` after editing this file)
+"architect": {
+  "build": {
+    "options": {
+      "assets": [
+        { "glob": "*_parser_bg.wasm", "input": "node_modules/@silurus/ooxml/dist", "output": "/" },
+        { "glob": "**/*", "input": "public" }
+      ]
+    }
+  }
+}
+```
+
 ```typescript
 // Angular 19 — standalone component with signal-based state
 import {
@@ -404,6 +438,7 @@ export class PptxViewerComponent implements AfterViewInit {
 
   ngAfterViewInit(): void {
     this.viewer = new PptxViewer(this.canvasEl().nativeElement, {
+      wasmUrl: '/pptx_parser_bg.wasm',
       onSlideChange: (i, t) => { this.current.set(i); this.total.set(t); },
     });
     this.viewer.load('/deck.pptx');
@@ -414,7 +449,10 @@ export class PptxViewerComponent implements AfterViewInit {
 }
 ```
 
-> Add `"allowSyntheticDefaultImports": true` and configure `@angular-builders/custom-webpack` (or use `esbuild` builder) with WASM support in your Angular workspace.
+> The `*_parser_bg.wasm` glob copies all three parsers; narrow it to
+> `pptx_parser_bg.wasm` if you only use one format. If you deploy under a
+> non-root `base href`, adjust `wasmUrl` so it resolves under your base (a
+> relative `wasmUrl` is resolved against the document URL).
 
 </details>
 

package/dist/{docx-DkL5ADAb.js → docx-BKsYFx78.js}

@@ -44,7 +44,7 @@ function ue(e) {
 }
 //#endregion
 //#region packages/docx/src/wasm/docx_parser_bg.wasm?url
-var de = new URL(new URL("docx_parser_bg.wasm", import.meta.url).href, import.meta.url).href, fe = (e) => {
+var de = new URL("docx_parser_bg.wasm", import.meta.url).href, fe = (e) => {
 	let t = e.text;
 	return typeof t == "string" ? t : void 0;
 }, pe = (e) => e.rtl === !0, me = (e) => e.digitsAsAN === !0;
@@ -3549,6 +3549,7 @@ var ii = class {
 	_lastFitWidth = 0;
 	_pageShadow;
 	constructor(e, t = {}) {
+		if (e.tagName === "CANVAS") throw Error("DocxScrollViewer takes a container element (e.g. a <div>), not a <canvas> — the viewer creates and manages its own canvases. Pass a block container; for the single-page canvas API use DocxViewer.");
 		if (this._container = e, this._opts = t, this._pageShadow = t.pageShadow ?? oi, this._injected = !!t.document, this._injected) {
 			let e = t.document;
 			if (t.mode !== void 0 && t.mode !== e.mode) throw Error(`DocxScrollViewer: opts.mode='${t.mode}' conflicts with the injected engine's mode='${e.mode}'. Omit opts.mode when injecting an engine — the engine owns its render mode.`);

package/dist/docx.mjs

@@ -1,3 +1,3 @@
 import { k as e } from "./line-metrics-DG9p1RvA.js";
-import { a as t, i as n, n as r, o as i, r as a } from "./docx-DkL5ADAb.js";
+import { a as t, i as n, n as r, o as i, r as a } from "./docx-BKsYFx78.js";
 export { i as DocxDocument, a as DocxScrollViewer, n as DocxViewer, e as autoResize, t as buildDocxTextLayer, r as noteText };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { t as e } from "./pptx-BU8N1QPE.js";
-import { t } from "./xlsx-CCmtIDr_.js";
-import { t as n } from "./docx-DkL5ADAb.js";
+import { t as e } from "./pptx-B4xa92BQ.js";
+import { t } from "./xlsx-B1XUgnO7.js";
+import { t as n } from "./docx-BKsYFx78.js";
 export { n as docx, e as pptx, t as xlsx };

package/dist/math.mjs

@@ -1,6 +1,6 @@
 import { n as e } from "./mathjax-BRfWlbSJ.js";
 //#region packages/core/assets/mathjax-stix2.js?url
-var t = new URL(new URL("mathjax-stix2.js", import.meta.url).href, import.meta.url).href, n = null;
+var t = new URL("mathjax-stix2.js", import.meta.url).href, n = null;
 function r() {
 	return new URL(t, import.meta.url).href;
 }

package/dist/{pptx-BU8N1QPE.js → pptx-B4xa92BQ.js}

@@ -2661,7 +2661,7 @@ function sr(e) {
 }
 //#endregion
 //#region packages/pptx/src/wasm/pptx_parser_bg.wasm?url
-var cr = new URL(new URL("pptx_parser_bg.wasm", import.meta.url).href, import.meta.url).href, lr = class e {
+var cr = new URL("pptx_parser_bg.wasm", import.meta.url).href, lr = class e {
 	_worker;
 	_bridge;
 	_mode = "main";
@@ -3007,6 +3007,7 @@ var cr = new URL(new URL("pptx_parser_bg.wasm", import.meta.url).href, import.me
 	_lastFitWidth = 0;
 	_pageShadow;
 	constructor(e, t = {}) {
+		if (e.tagName === "CANVAS") throw Error("PptxScrollViewer takes a container element (e.g. a <div>), not a <canvas> — the viewer creates and manages its own canvases. Pass a block container; for the single-slide canvas API use PptxViewer.");
 		if (this._container = e, this._opts = t, this._pageShadow = t.pageShadow ?? pr, this._injected = !!t.presentation, this._injected) {
 			let e = t.presentation;
 			if (t.mode !== void 0 && t.mode !== e.mode) throw Error(`PptxScrollViewer: opts.mode='${t.mode}' conflicts with the injected engine's mode='${e.mode}'. Omit opts.mode when injecting an engine — the engine owns its render mode.`);

package/dist/pptx.mjs

@@ -1,3 +1,3 @@
 import { k as e } from "./line-metrics-DG9p1RvA.js";
-import { a as t, i as n, n as r, o as i, r as a } from "./pptx-BU8N1QPE.js";
+import { a as t, i as n, n as r, o as i, r as a } from "./pptx-B4xa92BQ.js";
 export { n as PptxPresentation, r as PptxScrollViewer, a as PptxViewer, e as autoResize, i as buildPptxTextLayer, t as renderSlide };

package/dist/{xlsx-CCmtIDr_.js → xlsx-B1XUgnO7.js}

@@ -108,7 +108,7 @@ function ae(e) {
 }
 //#endregion
 //#region packages/xlsx/src/wasm/xlsx_parser_bg.wasm?url
-var oe = new URL(new URL("xlsx_parser_bg.wasm", import.meta.url).href, import.meta.url).href;
+var oe = new URL("xlsx_parser_bg.wasm", import.meta.url).href;
 //#endregion
 //#region packages/xlsx/src/sheet-visibility.ts
 function se(e, t) {

package/dist/xlsx.mjs

@@ -1,3 +1,3 @@
 import { k as e } from "./line-metrics-DG9p1RvA.js";
-import { n as t, r as n } from "./xlsx-CCmtIDr_.js";
+import { n as t, r as n } from "./xlsx-B1XUgnO7.js";
 export { t as XlsxViewer, n as XlsxWorkbook, e as autoResize };

package/package.json

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