@mlightcad/mtext-renderer 0.13.2 → 0.13.3

package/lib/worker/baseRenderer.d.ts

@@ -69,9 +69,14 @@ export interface MTextBaseRenderer {
      * Implementations should load and cache missing fonts; repeated calls should be cheap.
      *
      * @param fonts Font names to load (without extension for built-ins).
-     * @returns A Promise with the list of fonts that were processed.
+     * @param options.scope - Worker pool only: `one` warms a single isolate
+     *   (default); `all` loads into every worker.
+     * @returns Fonts confirmed loaded in the target isolate(s). With
+     *   `scope: 'all'`, only faces present in every worker.
      */
-    loadFonts(fonts: readonly string[]): Promise<{
+    loadFonts(fonts: readonly string[], options?: {
+        scope?: 'one' | 'all';
+    }): Promise<{
         loaded: string[];
     }>;
     /**

package/lib/worker/mainThreadRenderer.d.ts

@@ -39,7 +39,9 @@ export declare class MainThreadRenderer implements MTextBaseRenderer {
     /**
      * Load fonts in the main thread
      */
-    loadFonts(fonts: readonly string[]): Promise<{
+    loadFonts(fonts: readonly string[], _options?: {
+        scope?: 'one' | 'all';
+    }): Promise<{
         loaded: string[];
     }>;
     /**

package/lib/worker/unifiedRenderer.d.ts

@@ -101,9 +101,15 @@ export declare class UnifiedRenderer {
      */
     getSymbolFontsPreset(preset: DefaultFontsPreset): readonly string[];
     /**
-     * Load fonts using the current mode
+     * Load fonts using the current mode.
+     *
+     * In worker mode, `options.scope` defaults to `one` (warm a single isolate).
+     * Pass `{ scope: 'all' }` only when every worker must have the faces;
+     * `loaded` then lists only faces confirmed in every isolate.
      */
-    loadFonts(fonts: readonly string[]): Promise<{
+    loadFonts(fonts: readonly string[], options?: {
+        scope?: 'one' | 'all';
+    }): Promise<{
         loaded: string[];
     }>;
     /**

package/lib/worker/webWorkerRenderer.d.ts

@@ -141,12 +141,14 @@ export declare class WebWorkerRenderer implements MTextBaseRenderer {
     private isInitialized;
     private defaultStyleManager;
     /**
-     * Fonts known to be present in every worker after an explicit loadFonts or
-     * after a lazy fontLoaded was fan-out to the full pool.
+     * Fonts known to be present in a given worker isolate after an explicit
+     * {@link loadFonts} or a lazy `fontLoaded` notification from that worker.
+     *
+     * Intentionally per-worker: fanning a mesh face (e.g. simsun) into every
+     * isolate re-parses tens of MB of opentype data N times and makes worker
+     * mode slower than main-thread rendering.
      */
-    private poolSyncedFonts;
-    /** In-flight pool-wide font syncs keyed by normalized font name. */
-    private poolFontSyncInFlight;
+    private fontsPerWorker;
     /** Fonts already forwarded as main-thread fontLoaded for this pool lifetime. */
     private poolFontLoadedDispatched;
     constructor(config?: WebWorkerRendererConfig);
@@ -160,11 +162,6 @@ export declare class WebWorkerRenderer implements MTextBaseRenderer {
      * Handles messages coming from any worker.
      */
     private handleWorkerMessage;
-    /**
-     * Ensures every worker has `fontName`, then returns whether the main thread
-     * should emit {@link FontManager.events.fontLoaded} for this name.
-     */
-    private syncFontToWorkerPool;
     /**
      * Attaches message and error handlers to a worker.
      */
@@ -212,7 +209,20 @@ export declare class WebWorkerRenderer implements MTextBaseRenderer {
     syncRenderMText(_mtextContent: MTextData, _textStyle: TextStyle, _colorSettings?: ColorSettings): MTextObject;
     asyncRenderShape(_shapeContent: ShapeData, _textStyle: TextStyle, _colorSettings?: ColorSettings): Promise<MTextObject>;
     syncRenderShape(_shapeContent: ShapeData, _textStyle: TextStyle, _colorSettings?: ColorSettings): MTextObject;
-    loadFonts(fonts: readonly string[]): Promise<{
+    /**
+     * Loads fonts into the worker pool.
+     *
+     * @param fonts - Logical font names (extensions stripped by workers).
+     * @param options.scope - `one` (default) warms a single least-loaded /
+     *   already-warm worker so open-time preload does not re-parse large mesh
+     *   fonts into every isolate. Pass `all` only when every worker must have
+     *   the faces before the first draw (rare; expensive for mesh fonts).
+     * @returns Fonts confirmed loaded in the target isolate(s). With
+     *   `scope: 'all'`, only faces present in every worker.
+     */
+    loadFonts(fonts: readonly string[], options?: {
+        scope?: 'one' | 'all';
+    }): Promise<{
         loaded: string[];
     }>;
     getAvailableFonts(): Promise<{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mlightcad/mtext-renderer",
-  "version": "0.13.2",
+  "version": "0.13.3",
   "description": "AutoCAD MText renderer based on Three.js",
   "license": "MIT",
   "author": "MLight Lee <mlight.lee@outlook.com>",