goatdee-canvas 0.0.75 → 0.0.76

package/dist/index.cjs

@@ -1935,13 +1935,25 @@ class Manager {
         }
     }
     /**
-     * 缓存一份字体 buffer，留给导出 worker 内部的独立 wasm 实例使用。
+     * 缓存字体 buffer，留给导出 worker 内部的独立 wasm 实例使用。
      * 与主 wasm 的字体注册无关：主 wasm 已经吃掉自己那份副本。
+     * 同名会覆盖；须为独立 ArrayBuffer，便于 transfer 给 worker。
      */
-    cacheFontBuffers(fonts) {
+    appendExportWorkerFontBuffers(fonts) {
         if (!fonts || fonts.length === 0)
             return;
-        this.exportWorkerFontBuffers_ = fonts.slice();
+        for (const font of fonts) {
+            if (!(font === null || font === void 0 ? void 0 : font.name) || !font.buffer)
+                continue;
+            const idx = this.exportWorkerFontBuffers_.findIndex((f) => f.name === font.name);
+            const entry = { name: font.name, buffer: font.buffer };
+            if (idx >= 0) {
+                this.exportWorkerFontBuffers_[idx] = entry;
+            }
+            else {
+                this.exportWorkerFontBuffers_.push(entry);
+            }
+        }
     }
     getExportWorkerFontBuffers() {
         return this.exportWorkerFontBuffers_;
@@ -1958,22 +1970,31 @@ const manager = Manager.getInstance();
 // ———————————————————— 导出 API ————————————————————
 // exportImageClient 的 lazy import 句柄；首次访问后才把 worker chunk 拉下来。
 let exportImageClientPromise_ = null;
+function configureExportImageClient(client) {
+    const license = manager.getExportWorkerSessionLicense();
+    const fonts = manager.getExportWorkerFontBuffers();
+    client.configure({
+        sessionLicense: license !== null && license !== void 0 ? license : undefined,
+        fonts: fonts.length > 0 ? fonts : undefined,
+    });
+}
 async function getExportImageClient() {
     if (!exportImageClientPromise_) {
         exportImageClientPromise_ = Promise.resolve().then(function () { return exportImage_client; }).then((mod) => {
             const client = mod.exportImageClient;
-            // 把 manager 上缓存的 license / 字体一次性同步过去
-            const license = manager.getExportWorkerSessionLicense();
-            const fonts = manager.getExportWorkerFontBuffers();
-            client.configure({
-                sessionLicense: license !== null && license !== void 0 ? license : undefined,
-                fonts: fonts && fonts.length > 0 ? fonts : undefined,
-            });
+            configureExportImageClient(client);
             return client;
         });
     }
     return exportImageClientPromise_;
 }
+/** registerFonts 等场景下，把最新字体列表同步给已 lazy 加载的 export worker。 */
+async function syncExportWorkerFonts() {
+    if (!exportImageClientPromise_)
+        return;
+    const client = await exportImageClientPromise_;
+    configureExportImageClient(client);
+}
 /**
  * 平移画布。
  * @category 画布操作
@@ -2382,6 +2403,12 @@ const registerFonts = async (fonts) => {
                 await registerFontToBrowser({ name: font.fontName, buffer });
                 await manager.getCanvas().registerFont(font.fontName, new Uint8Array(buffer));
                 manager.addRegisteredFont(font.fontName);
+                // 导出 worker 使用独立 wasm，须单独缓存字体二进制（见 fontManager BUILD_SINGLE_THREAD）
+                const standaloneBuffer = buffer.slice(0);
+                manager.appendExportWorkerFontBuffers([
+                    { name: font.fontName, buffer: standaloneBuffer },
+                ]);
+                void syncExportWorkerFonts();
             }
             catch (error) {
                 console.warn(`${font.fontName} 字体注册失败:`, error);
@@ -6127,19 +6154,42 @@ const TGFXBind = (module) => {
  *
  * 副作用：把字体 buffer 复制一份缓存到 manager，供导出 worker（exportImageClient）
  * 在它自己的 wasm 实例里再注册一次。
+ *
+ * ⚠️ 必须同时显式声明 `.wasm` 的 `new URL` 引用，否则消费者 bundler（webpack/vite/rspack）
+ *    只会 emit `.js`，Emscripten 运行时按 sibling 路径 fetch `.wasm` 会拿到 SPA fallback
+ *    的 HTML，报 "expected magic word 00 61 73 6d, found 3c 21 44 4f"。
+ *    解析出的 URL 通过 emscripten `locateFile` 钩子注入，覆盖默认 sibling 推断。
  */
 async function loadWasmModule() {
     let wasmModule = null;
+    let wasmBinaryUrl = null;
     {
         wasmModule = await Promise.resolve().then(function () { return ZHCanvasCore; });
+        try {
+            wasmBinaryUrl = new URL("../../wasm/ZHCanvasCore.wasm", (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href))).href;
+        }
+        catch (_b) {
+            wasmBinaryUrl = null;
+        }
     }
     // 使用单例：避免多线程下重复创建 pthread workers
     let infiniteCanvas;
     try {
         infiniteCanvas = manager.getModule();
     }
-    catch (_a) {
-        manager.registerModuleFactory(() => wasmModule.default());
+    catch (_c) {
+        manager.registerModuleFactory(() => {
+            const opts = {};
+            if (wasmBinaryUrl) {
+                // 关键：覆盖 emscripten 默认的 sibling 推断，强制用 bundler emit 出的带 hash URL。
+                opts.locateFile = (path, prefix) => {
+                    if (path.endsWith(".wasm"))
+                        return wasmBinaryUrl;
+                    return prefix + path;
+                };
+            }
+            return wasmModule.default(opts);
+        });
         infiniteCanvas = await manager.getOrCreateModule();
     }
     TGFXBind(infiniteCanvas);
@@ -6156,7 +6206,7 @@ async function loadWasmModule() {
     // 注意：必须用独立的 ArrayBuffer，避免后续 transfer 让主线程的 fontData.array 失效。
     try {
         const standaloneBuffer = fontData.sourceHan.array.slice().buffer;
-        manager.cacheFontBuffers([
+        manager.appendExportWorkerFontBuffers([
             { name: fontData.sourceHan.name, buffer: standaloneBuffer },
         ]);
     }
@@ -6604,10 +6654,13 @@ class ExportImageClient {
         }
         const { jsUrl: wasmUrl, wasmBinaryUrl } = this.wasmUrls_;
         const sessionLicense = this.sessionLicense_;
-        const fonts = this.fonts_;
-        this.initPromise_ = this.postRequest({ type: 'INIT', wasmUrl, wasmBinaryUrl, sessionLicense, fonts }, 
-        // 字体 buffer 主 wasm 已 copy 到 heap，这里 transfer 给 worker 后主线程不再使用。
-        fonts.map((f) => f.buffer))
+        // 拷贝后再 transfer：避免 postMessage transfer 把 manager 里缓存的 buffer detach，
+        // 否则 worker reset 后无法再次 INIT。
+        const fonts = this.fonts_.map((f) => ({
+            name: f.name,
+            buffer: f.buffer.slice(0),
+        }));
+        this.initPromise_ = this.postRequest({ type: 'INIT', wasmUrl, wasmBinaryUrl, sessionLicense, fonts }, fonts.map((f) => f.buffer))
             .then(() => undefined)
             .catch((e) => {
             this.initPromise_ = null;