three-text 0.4.4 → 0.4.5

package/README.md

@@ -195,6 +195,12 @@ self.onmessage = (e) => {
 
 The library will prioritize the buffer if both a path and a buffer have been set
 
+#### Platform-specific notes
+
+**NW.js with CommonJS:** If using `require()` to load the CJS build in NW.js, use Option 2 (buffer-based loading). NW.js's [dual-context architecture](https://docs.nwjs.io/For%20Users/Advanced/JavaScript%20Contexts%20in%20NW.js/#separate-context-mode) causes path resolution issues in this specific scenario. ESM imports and bundled code work normally
+
+**Electron with `file://` protocol:** If loading HTML directly from the filesystem (not via a dev server), use Option 2 (buffer-based loading) or enable `nodeIntegration` in your BrowserWindow
+
 ### Hyphenation patterns
 
 **For ES Modules (recommended):** Import and register only the languages you need:

package/dist/index.cjs

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.4.4
+ * three-text v0.4.5
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -2212,7 +2212,6 @@ async function loadPattern(language, patternsPath) {
     }
 }
 
-// Bector and bounding box types for core
 // 2D Vector
 class Vec2 {
     constructor(x = 0, y = 0) {
@@ -4811,6 +4810,41 @@ class TextShaper {
     }
 }
 
+// Fetch with fs fallback for Electron file:// and Node.js environments
+async function loadBinary(filePath) {
+    try {
+        const res = await fetch(filePath);
+        if (!res.ok) {
+            throw new Error(`HTTP ${res.status}`);
+        }
+        return await res.arrayBuffer();
+    }
+    catch (fetchError) {
+        const req = globalThis.require;
+        if (typeof req !== 'function') {
+            throw new Error(`Failed to fetch ${filePath}: ${fetchError}`);
+        }
+        try {
+            const fs = req('fs');
+            const nodePath = req('path');
+            // file:// URLs need path resolution relative to the HTML document
+            let resolvedPath = filePath;
+            if (typeof window !== 'undefined' &&
+                window.location?.protocol === 'file:') {
+                const dir = nodePath.dirname(window.location.pathname);
+                resolvedPath = nodePath.join(dir, filePath);
+            }
+            const buffer = fs.readFileSync(resolvedPath);
+            if (buffer instanceof ArrayBuffer)
+                return buffer;
+            return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+        }
+        catch (fsError) {
+            throw new Error(`Failed to load ${filePath}: fetch failed (${fetchError}), fs.readFileSync failed (${fsError})`);
+        }
+    }
+}
+
 var hb = {exports: {}};
 
 var fs = {};
@@ -5401,11 +5435,9 @@ try {
 var hbjsExports = hbjs$2.exports;
 var hbjs$1 = /*@__PURE__*/getDefaultExportFromCjs(hbjsExports);
 
-// These will be bundled by Rollup
-// @ts-expect-error - no declarations for harfbuzzjs/hb.js
 let harfbuzzPromise = null;
 let wasmPath = null;
-let wasmBuffer = null; // Add buffer option
+let wasmBuffer = null;
 const HarfBuzzLoader = {
     setWasmPath(path) {
         wasmPath = path;
@@ -5428,12 +5460,7 @@ const HarfBuzzLoader = {
                     moduleConfig.wasmBinary = wasmBuffer;
                 }
                 else if (wasmPath) {
-                    moduleConfig.locateFile = (path, scriptDirectory) => {
-                        if (path.endsWith('.wasm')) {
-                            return wasmPath;
-                        }
-                        return scriptDirectory + path;
-                    };
+                    moduleConfig.wasmBinary = await loadBinary(wasmPath);
                 }
                 else {
                     throw new Error('HarfBuzz WASM path or buffer must be set before initialization.');
@@ -5730,14 +5757,7 @@ class Text {
             Text.hbInitPromise = HarfBuzzLoader.getHarfBuzz();
         }
         await Text.hbInitPromise;
-        const fontBuffer = typeof fontSrc === 'string'
-            ? await fetch(fontSrc).then((res) => {
-                if (!res.ok) {
-                    throw new Error(`Failed to load font from ${fontSrc}: HTTP ${res.status} ${res.statusText}`);
-                }
-                return res.arrayBuffer();
-            })
-            : fontSrc;
+        const fontBuffer = typeof fontSrc === 'string' ? await loadBinary(fontSrc) : fontSrc;
         try {
             if (this.loadedFont) {
                 this.destroy();

package/dist/index.js

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.4.4
+ * three-text v0.4.5
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -2209,7 +2209,6 @@ async function loadPattern(language, patternsPath) {
     }
 }
 
-// Bector and bounding box types for core
 // 2D Vector
 class Vec2 {
     constructor(x = 0, y = 0) {
@@ -4808,6 +4807,41 @@ class TextShaper {
     }
 }
 
+// Fetch with fs fallback for Electron file:// and Node.js environments
+async function loadBinary(filePath) {
+    try {
+        const res = await fetch(filePath);
+        if (!res.ok) {
+            throw new Error(`HTTP ${res.status}`);
+        }
+        return await res.arrayBuffer();
+    }
+    catch (fetchError) {
+        const req = globalThis.require;
+        if (typeof req !== 'function') {
+            throw new Error(`Failed to fetch ${filePath}: ${fetchError}`);
+        }
+        try {
+            const fs = req('fs');
+            const nodePath = req('path');
+            // file:// URLs need path resolution relative to the HTML document
+            let resolvedPath = filePath;
+            if (typeof window !== 'undefined' &&
+                window.location?.protocol === 'file:') {
+                const dir = nodePath.dirname(window.location.pathname);
+                resolvedPath = nodePath.join(dir, filePath);
+            }
+            const buffer = fs.readFileSync(resolvedPath);
+            if (buffer instanceof ArrayBuffer)
+                return buffer;
+            return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+        }
+        catch (fsError) {
+            throw new Error(`Failed to load ${filePath}: fetch failed (${fetchError}), fs.readFileSync failed (${fsError})`);
+        }
+    }
+}
+
 var hb = {exports: {}};
 
 var fs = {};
@@ -5398,11 +5432,9 @@ try {
 var hbjsExports = hbjs$2.exports;
 var hbjs$1 = /*@__PURE__*/getDefaultExportFromCjs(hbjsExports);
 
-// These will be bundled by Rollup
-// @ts-expect-error - no declarations for harfbuzzjs/hb.js
 let harfbuzzPromise = null;
 let wasmPath = null;
-let wasmBuffer = null; // Add buffer option
+let wasmBuffer = null;
 const HarfBuzzLoader = {
     setWasmPath(path) {
         wasmPath = path;
@@ -5425,12 +5457,7 @@ const HarfBuzzLoader = {
                     moduleConfig.wasmBinary = wasmBuffer;
                 }
                 else if (wasmPath) {
-                    moduleConfig.locateFile = (path, scriptDirectory) => {
-                        if (path.endsWith('.wasm')) {
-                            return wasmPath;
-                        }
-                        return scriptDirectory + path;
-                    };
+                    moduleConfig.wasmBinary = await loadBinary(wasmPath);
                 }
                 else {
                     throw new Error('HarfBuzz WASM path or buffer must be set before initialization.');
@@ -5727,14 +5754,7 @@ class Text {
             Text.hbInitPromise = HarfBuzzLoader.getHarfBuzz();
         }
         await Text.hbInitPromise;
-        const fontBuffer = typeof fontSrc === 'string'
-            ? await fetch(fontSrc).then((res) => {
-                if (!res.ok) {
-                    throw new Error(`Failed to load font from ${fontSrc}: HTTP ${res.status} ${res.statusText}`);
-                }
-                return res.arrayBuffer();
-            })
-            : fontSrc;
+        const fontBuffer = typeof fontSrc === 'string' ? await loadBinary(fontSrc) : fontSrc;
         try {
             if (this.loadedFont) {
                 this.destroy();