@mlightcad/mtext-renderer 0.12.4 → 0.12.6

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/lib/renderer/unicodeEscapes.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Replaces AutoCAD `\U+XXXX` (exactly four hex digits) with the corresponding
+ * Unicode character so a following hex digit is not absorbed into the code point.
+ */
+export declare function expandUnicodeEscapes(text: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mlightcad/mtext-renderer",
-  "version": "0.12.4",
+  "version": "0.12.6",
   "description": "AutoCAD MText renderer based on Three.js",
   "license": "MIT",
   "author": "MLight Lee <mlight.lee@outlook.com>",
@@ -43,7 +43,7 @@
     "3d-text"
   ],
   "dependencies": {
-    "@mlightcad/mtext-parser": "^1.5.0",
+    "@mlightcad/mtext-parser": "^1.5.1",
     "@mlightcad/shx-parser": "^1.4.5",
     "iconv-lite": "^0.7.0",
     "idb": "^8.0.3",