@mlightcad/mtext-renderer 0.12.6 → 0.12.7

package/lib/font/fontManager.d.ts

@@ -224,6 +224,12 @@ export declare class FontManager {
     loadFonts(fonts: FontInfo | FontInfo[]): Promise<FontLoadStatus[]>;
     /**
      * Tries to find the specified font. If not found, uses a replacement font and returns its name.
+     *
+     * When the requested face is not loaded, the original name is recorded in
+     * {@link missedFonts} and {@link events.fontNotFound} is dispatched (once per
+     * miss cycle) so hosts can surface missing-font UI. Lazy loading still
+     * schedules {@link requestFont} for the face that will be fetched.
+     *
      * @param fontName - The font name to find
      * @returns The original font name if found, or the replacement font name if not found
      */
@@ -310,9 +316,40 @@ export declare class FontManager {
      * @returns True if the font is loaded, false otherwise
      */
     isFontLoaded(fontName: string): boolean;
+    /**
+     * Applies a missed-font report from another isolate (e.g. a web worker).
+     * Updates {@link missedFonts} and dispatches {@link events.fontNotFound} on
+     * first sighting. Does not call {@link requestFont} — the remote isolate owns loading.
+     */
+    applyRemoteFontNotFound(fontName: string, count?: number): void;
+    /**
+     * Clears a missed-font entry after a remote isolate reports the font loaded.
+     * Call before dispatching {@link events.fontLoaded} on the main thread.
+     */
+    applyRemoteFontLoaded(fontName: string): void;
+    /**
+     * Replaces session-scoped missed-font bookkeeping without dispatching events.
+     * Entries for faces that are already loaded are dropped.
+     */
+    replaceMissedFonts(fonts: Record<string, number>): void;
+    /**
+     * Clears {@link missedFonts}. Does not unload faces or cancel in-flight loads.
+     */
+    clearMissedFonts(): void;
+    /**
+     * Strips a trailing `.ttf` / `.otf` / `.woff` / `.shx` extension when present.
+     * Matches the normalization used by {@link getFontByName}.
+     */
+    private stripFontFileExtension;
+    /**
+     * Removes {@link missedFonts} entries whose name matches `fontName`
+     * case-insensitively (CAD style names and loaded face names often differ in case).
+     */
+    private clearMissedFontEntry;
     /**
      * Records a font that was requested but not found
      * @param fontName - The name of the font that was not found
+     * @param scheduleLoad - When true (default), also {@link requestFont} on first miss if lazy loading is on
      */
     private recordMissedFonts;
     /**

package/lib/worker/unifiedRenderer.d.ts

@@ -82,6 +82,14 @@ export declare class UnifiedRenderer {
      * any existing worker pool.
      */
     setAwaitFontsBeforeDraw(enabled: boolean): Promise<void>;
+    /**
+     * Replaces session-scoped missed-font bookkeeping on the main thread and workers.
+     * When a worker pool is active, {@link WebWorkerRenderer.replaceMissedFonts}
+     * owns the final main-thread map (intersection of worker-filtered results).
+     */
+    replaceMissedFonts(fonts: Record<string, number>): Promise<void>;
+    /** Clears session-scoped missed-font bookkeeping on the main thread and workers. */
+    clearMissedFonts(): Promise<void>;
     /**
      * Returns font names for a predefined default-font preset.
      */

package/lib/worker/webWorkerRenderer.d.ts

@@ -190,6 +190,17 @@ export declare class WebWorkerRenderer implements MTextBaseRenderer {
      * Mirrors {@link FontManager.awaitFontsBeforeDraw} into every worker isolate.
      */
     setAwaitFontsBeforeDraw(enabled: boolean): Promise<void>;
+    /**
+     * Replaces session-scoped {@link FontManager.missedFonts} on every worker,
+     * then adopts the intersection of worker-filtered maps on the main thread.
+     *
+     * Workers drop faces they have already loaded; in worker-only mode the main
+     * isolate often has an empty {@link FontManager.loadedFontMap}, so the
+     * authoritative "still missing" set comes from the pool responses.
+     */
+    replaceMissedFonts(fonts: Record<string, number>): Promise<void>;
+    /** Clears {@link FontManager.missedFonts} on the main thread and every worker. */
+    clearMissedFonts(): Promise<void>;
     /**
      * Render MText in one worker and return serialized data asynchronously.
      */

package/package.json

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