@mlightcad/mtext-renderer 0.12.4 → 0.12.5

package/lib/font/defaultFontLoader.d.ts

@@ -9,6 +9,12 @@ export declare class DefaultFontLoader implements FontLoader {
     private _avaiableFonts;
     private _baseUrl;
     private _avaiableFontMap;
+    /**
+     * Shared in-flight metadata fetch. Concurrent {@link getAvailableFonts} /
+     * {@link load} callers (common with lazy per-entity font requests) must not
+     * each hit `fonts.json` independently.
+     */
+    private _availableFontsPromise;
     /**
      * Creates a new instance of DefaultFontLoader
      */
@@ -31,6 +37,8 @@ export declare class DefaultFontLoader implements FontLoader {
     /**
      * Retrieves information about all available fonts in the system.
      * Loads font metadata from a CDN if not already loaded.
+     * Concurrent callers share one in-flight fetch so `fonts.json` is requested
+     * at most once per loader instance / baseUrl.
      * @returns Promise that resolves to an array of FontInfo objects
      * @throws {Error} If font metadata cannot be loaded from the CDN
      */
@@ -43,6 +51,10 @@ export declare class DefaultFontLoader implements FontLoader {
      * @returns Promise that resolves to an array of FontLoadStatus objects
      */
     load(fontNames: readonly string[]): Promise<FontLoadStatus[]>;
+    /**
+     * Fetches and caches remote font metadata for the given base URL.
+     */
+    private fetchAvailableFonts;
     /**
      * Build one font map. The key is font name. The value is font info.
      */

package/lib/font/defaultFontsPresets.d.ts

@@ -9,11 +9,11 @@ export type DefaultFontsPreset =
 'minimal'
 /** Classic R12/R14 stack: SHX basics, GB big font, then mesh CJK and AMGDT. */
  | 'r12r14'
-/** Later-era stack: hztxt big font with simsun and AMGDT symbols. */
+/** Later-era stack: simsun first for Latin metrics, then hztxt big font. */
  | 'modern'
 /** Western SHX fonts plus simsun and AMGDT; no CJK-specific SHX big fonts. */
  | 'international'
-/** Broad CJK coverage: both GB big-font SHX files plus common mesh fallbacks. */
+/** Broad CJK coverage: simsun first, then GB big-font SHX files. */
  | 'cjk';
 /**
  * Predefined text-font fallback chains (primary / big-font substitutes and CJK

package/lib/font/fontManager.d.ts

@@ -228,6 +228,13 @@ export declare class FontManager {
      * @returns The original font name if found, or the replacement font name if not found
      */
     findAndReplaceFont(fontName: string): string;
+    /**
+     * Returns the first loaded font from {@link defaultFonts}.
+     *
+     * @param skipBigfont When true, ignores SHX BIGFONT faces so ASCII/Latin text
+     *   is not forced through fullwidth CJK glyph cells.
+     */
+    private pickLoadedDefaultFont;
     /**
      * Gets font by font name. Return undefined if not found.
      * @param fontName - The font name to find

package/lib/renderer/mtextProcessor.d.ts

@@ -288,6 +288,10 @@ export declare class MTextProcessor {
     private applyColorSnapshotChanges;
     /**
      * Apply width factor changes, resolving relative factors to absolute values.
+     *
+     * Absolute `\Wvalue;` replaces the current width factor. Relative `\Wvaluex;`
+     * multiplies the current width factor (AutoCAD / ezdxf semantics).
+     *
      * @param widthFactor Width factor change data.
      */
     private applyWidthFactorChange;

package/package.json

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