@vyaz/core 0.0.2 → 0.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vyaz/core",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -15,12 +15,14 @@
   "dependencies": {
     "@chenglou/pretext": "^0.0.8",
     "@clean-jsdoc-theme/typedoc": "^5.0.6",
-    "@napi-rs/canvas": "^1.0.2",
     "fontkit": "^2.0.4",
     "get-system-fonts": "^2.0.2",
     "js-yaml": "^5.0.0",
     "typedoc": "^0.28.19"
   },
+  "optionalDependencies": {
+    "@napi-rs/canvas": "^1.0.2"
+  },
   "devDependencies": {
     "@types/node": "^26.0.0"
   }

package/src/measure/SystemFontRegistry.ts

@@ -6,10 +6,11 @@
  *   import { systemFontRegistry } from './SystemFontRegistry.js';
  *   await systemFontRegistry.scan();
  *   console.log(systemFontRegistry.getRegisteredFamilies());
+ *
+ * ⚠️ Node.js built-in module imports are dynamic (lazy) to avoid
+ * Vite/Webpack externalization errors in browser builds.
  */
 
-import { readFileSync } from 'node:fs';
-import getSystemFonts from 'get-system-fonts';
 import { fontMetricsProvider } from './FontMetricsProvider.js';
 
 interface ScanResult {
@@ -86,6 +87,15 @@ export class SystemFontRegistry {
    * @returns stats about what was found and registered
    */
   async scan(): Promise<ScanResult> {
+    // Dynamic imports — hidden from bundler static analysis.
+    // Only resolves on Node.js.  No-op in browser.
+    const [{ readFileSync }, getSystemFontsModule] = await Promise.all([
+      // @ts-ignore — 'node:fs' is a Node.js built-in; not resolvable with moduleResolution:bundler.
+      import('node:fs'),
+      import('get-system-fonts') as any,
+    ]);
+    const getSystemFonts = (getSystemFontsModule.default || getSystemFontsModule) as (opts?: any) => Promise<string[]>;
+
     const paths: string[] = await getSystemFonts();
     let registered = 0;
 

package/src/measure/canvas-polyfill.ts

@@ -9,20 +9,40 @@
  *
  * Exports enableOfficeTextMeasure / disableOfficeTextMeasure —
  * ctx.measureText override for fontkit-based measurements in Office mode.
+ *
+ * ⚠️ All Node.js built-in module imports are dynamic (lazy) to avoid
+ * Vite/Webpack externalization errors in browser builds.
  */
-import { createRequire } from 'module';
 
-// ⚠️ Dynamic import — prevents esbuild from resolving @napi-rs/canvas at bundle time.
-// This module is a native Node.js addon. In the browser, Canvas APIs are already available.
+// ── Lazy Node.js module loader ─────────────────────────────────────
+// Dynamic import('module') — hidden from bundler static analysis.
+// Only resolves on Node.js / Bun.  No-op in browser.
+// Use 'any' for process to avoid requiring @types/node in browser contexts.
+const _process: any = typeof globalThis !== 'undefined'
+  ? (globalThis as any).process
+  : undefined;
+
+let _require: ((id: string) => any) | null = null;
 let _createCanvas: ((w: number, h: number) => any) | null = null;
 
-const _require = createRequire(import.meta.url);
-try {
-  const mod: any = _require('@napi-rs/canvas');
-  _createCanvas = mod.createCanvas;
-} catch {
-  // Browser — document.createElement('canvas') is available natively, no polyfill needed
-  _createCanvas = null;
+async function _initNodeDeps(): Promise<void> {
+  try {
+    // @ts-ignore — 'module' is a Node.js built-in; not resolvable with moduleResolution:bundler.
+    // This dynamic import is guarded by a runtime check and never executes in browser.
+    const m: any = await import('module');
+    _require = m.createRequire(import.meta.url);
+    const canvas: any = _require!('@napi-rs/canvas');
+    _createCanvas = canvas.createCanvas;
+  } catch {
+    // Browser or server without @napi-rs/canvas
+    _createCanvas = null;
+  }
+}
+
+// ESM top-level await — guarded by runtime check so bundlers don't
+// attempt to resolve 'module' at compile time.
+if (_process && (_process.versions?.node || _process.versions?.bun)) {
+  await _initNodeDeps();
 }
 
 // ── Polyfill document.createElement('canvas') ────────────────────────────
@@ -174,6 +194,7 @@ function createEmptyMetrics(): TextMetrics {
  * No-op in browser or when @napi-rs/canvas is not available.
  */
 export function registerCanvasFont(fontPath: string, family: string): void {
+  if (!_require) return; // @napi-rs/canvas not available
   try {
     const mod = _require('@napi-rs/canvas');
     if (mod?.registerFont) {