@mlightcad/mtext-renderer 0.12.10 → 0.12.12

package/lib/font/defaultFontLoader.d.ts

@@ -15,6 +15,12 @@ export declare class DefaultFontLoader implements FontLoader {
      * each hit `fonts.json` independently.
      */
     private _availableFontsPromise;
+    /**
+     * At most one forced `fonts.json` revalidation per baseUrl. Used when a
+     * requested face is missing from a possibly stale HTTP-cached catalog
+     * (e.g. jsDelivr `@main` with a long max-age).
+     */
+    private _catalogRefreshAttempted;
     /**
      * Creates a new instance of DefaultFontLoader
      */
@@ -51,6 +57,12 @@ export declare class DefaultFontLoader implements FontLoader {
      * @returns Promise that resolves to an array of FontLoadStatus objects
      */
     load(fontNames: readonly string[]): Promise<FontLoadStatus[]>;
+    private clearAvailableFontsCache;
+    /**
+     * Drops the in-memory catalog and refetches `fonts.json`, bypassing the HTTP
+     * cache so CDN updates are visible after a miss.
+     */
+    private refreshAvailableFontsFromNetwork;
     /**
      * Fetches and caches remote font metadata for the given base URL.
      */

package/lib/font/fontManager.d.ts

@@ -58,8 +58,10 @@ export declare class FontManager {
     /**
      * When true, {@link MText.asyncDraw} / {@link Shape.asyncDraw} wait for fonts
      * referenced by the content and style to finish loading before building
-     * geometry. Useful with {@link lazyFontLoading} when callers prefer a single
-     * draw pass instead of redrawing on {@link events.fontLoaded}.
+     * geometry. Default/symbol fallback chains are still requested in the
+     * background (not awaited) under {@link lazyFontLoading}, so unused preset
+     * faces do not block the draw; redraw on {@link events.fontLoaded} if those
+     * faces are needed for the final glyphs.
      *
      * Has no effect when {@link lazyFontLoading} is false (draw already awaits).
      */

package/lib/renderer/mtext.d.ts

@@ -7,9 +7,10 @@ import * as THREE from 'three';
  */
 export interface MTextDrawOptions {
     /**
-     * Wait for fonts referenced by the content/style — and, when awaiting, the
-     * configured default/symbol fallback chains — to finish loading before
-     * building geometry.
+     * Wait for fonts referenced by the content/style to finish loading before
+     * building geometry. Default/symbol fallback chains are requested in the
+     * background under lazy loading (not awaited) so open-time draws are not
+     * blocked on unused preset faces.
      *
      * Defaults to `true` when {@link FontManager.lazyFontLoading} is false, or
      * when {@link FontManager.awaitFontsBeforeDraw} is true. Otherwise fonts are

package/lib/worker/unifiedRenderer.d.ts

@@ -19,6 +19,8 @@ export declare class UnifiedRenderer {
     private workerLazyFontLoading;
     /** Last awaitFontsBeforeDraw value pushed to the worker pool, if any. */
     private workerAwaitFontsBeforeDraw;
+    /** Last font base URL pushed to the worker pool, if any. */
+    private workerFontUrl;
     /**
      * Constructor
      *

package/package.json

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