@mlightcad/mtext-renderer 0.11.1 → 0.11.3

package/lib/cache/fontCacheManager.d.ts

@@ -25,6 +25,13 @@ export declare class FontCacheManager {
      * @returns The font data if found, undefined otherwise
      */
     get(fileName: string): Promise<FontData | undefined>;
+    /**
+     * Finds a font in the cache by primary name or alias.
+     * Font names may include or omit a file extension (e.g. `romans` or `romans.shx`).
+     * @param fontName The font name or alias to look up
+     * @returns The font data if found, undefined otherwise
+     */
+    find(fontName: string): Promise<FontData | undefined>;
     /**
      * Deletes a font from the cache
      * @param fileName The font file name (key)

package/lib/font/fontLoader.d.ts

@@ -15,6 +15,8 @@ export interface FontInfo {
      * https://developer.mozilla.org/en-US/docs/Web/API/Encoding_API/Encodings
      */
     encoding?: string;
+    /** Where this font entry comes from */
+    source?: 'remote' | 'cache';
 }
 /**
  * Represents the status of a font loading operation

package/lib/font/fontManager.d.ts

@@ -128,7 +128,8 @@ export declare class FontManager {
     setFontLoader(fontLoader: FontLoader): void;
     /**
      * Retrieves information about all available fonts in the system.
-     * Loads font metadata from a CDN if not already loaded.
+     * Merges remote font metadata with fonts stored in IndexedDB (cache-only
+     * entries are included; remote entries win when names collide).
      * @returns Promise that resolves to an array of FontInfo objects
      * @throws {Error} If font metadata cannot be loaded from the CDN
      */
@@ -149,6 +150,27 @@ export declare class FontManager {
      * @returns Promise that resolves to an array of font load statuses
      */
     loadFontsByNames(names: string | readonly string[]): Promise<FontLoadStatus[]>;
+    /**
+     * Parses a user-uploaded font file, registers it for rendering, and stores
+     * it in IndexedDB when {@link enableFontCache} is true.
+     *
+     * Supported formats: `.shx`, `.ttf`, `.otf`, `.woff`.
+     *
+     * @param data - Font file contents or a browser `File` selected by the user
+     * @param fileName - Font file name (e.g. `custom.shx`, `simkai.ttf`). Required when `data` is an `ArrayBuffer`
+     * @param aliases - Optional alias names for the font (e.g. AutoCAD style names)
+     * @param encoding - Optional character encoding for SHX bigfonts
+     * @returns Promise that resolves to the font load status
+     */
+    cacheFont(data: ArrayBuffer | File, fileName?: string, aliases?: string[], encoding?: string): Promise<FontLoadStatus>;
+    /**
+     * Loads a font from IndexedDB by primary name or alias.
+     * No-op when {@link enableFontCache} is false.
+     *
+     * @param fontName - Font name or alias (with or without file extension)
+     * @returns True if the font was found in cache and registered for rendering
+     */
+    loadFontFromCache(fontName: string): Promise<boolean>;
     /**
      * Loads the specified fonts from URLs
      * @param urls - URLs of font files to load.
@@ -198,10 +220,14 @@ export declare class FontManager {
      */
     getCharShapeFromDefaults(char: string, size: number): BaseTextShape | undefined;
     /**
-     * Gets the text shape from configured GDT / symbol fonts (e.g. `amgdt.shx`).
-     * Used for AutoCAD percent codes and other symbol-font code points.
+     * Gets the text shape from configured GDT / symbol fonts (e.g. `amgdt.shx`)
+     * by font-internal character code.
+     *
+     * AutoCAD `%%` symbols resolve against SHX code points (e.g. 126, 129, 132),
+     * not Unicode text semantics. Use {@link BaseFont.getCodeShape} so BIGFONT and
+     * Unicode SHX fonts are queried consistently.
      */
-    getCharShapeFromSymbolFonts(char: string, size: number): BaseTextShape | undefined;
+    getCodeShapeFromSymbolFonts(code: number, size: number): BaseTextShape | undefined;
     /**
      * Gets the scale factor for a specific font
      * @param fontName - The name of the font
@@ -241,6 +267,9 @@ export declare class FontManager {
      * Loads all fonts from the cache
      */
     getAllFontsFromCache(): Promise<void>;
+    private cachedFontDataToFontInfo;
+    private resolveUploadedFontType;
+    private buildUploadedFontAliases;
     /**
      * Registers a loaded font under its primary name and all aliases.
      */

package/lib/renderer/mtextProcessor.d.ts

@@ -305,6 +305,7 @@ export declare class MTextProcessor {
     private processBlank;
     private recordVisualLineBreak;
     private recordCurrentLineLayout;
+    private processPercentSymbol;
     private processChar;
     private processLastLine;
     private initLineParams;
@@ -319,6 +320,7 @@ export declare class MTextProcessor {
      * @returns Return the text shape of the specified character
      */
     private shapeHasStrokeGeometry;
+    private resolvePercentSymbolShape;
     private getCharShape;
     private advanceToNextLine;
     private captureCurrentLineAdvance;

package/lib/renderer/shxSymbolControlCodes.d.ts

@@ -1,46 +1,21 @@
+import { PercentSymbolData } from '@mlightcad/mtext-parser';
 /**
  * AutoCAD percent-sign symbol codes (`%%c`, `%%d`, `%%p`) and their SHX
  * symbol-font code points.
  *
- * Named percent codes are expanded by {@link @mlightcad/mtext-parser} into Unicode
- * before rendering. AutoCAD itself does not rely on those Unicode code points in
- * the primary text font; it resolves the symbols through GDT / symbol SHX fonts
- * such as `amgdt.shx` using legacy control-code code points.
- *
- * References:
- * - AutoCAD "Text Symbols and Special Characters"
- * - AutoCAD "Control Codes and Special Characters" (`%%nnn`)
- * - Legacy SHX convention: 127 = degree, 128 = plus/minus, 129 = diameter
- * - Modern `amgdt.shx`: degree at 126/176, ± at 177, diameter at U+2205 (∅);
- *   code 130 = angle (∠). Legacy bytes 127–128 must not be used when CJK mesh
- *   fonts in the fallback chain expose unrelated glyphs at those code points.
+ * When {@link MTextParserOptions.yieldPercentSymbols} is enabled, the parser
+ * emits {@link TokenType.PERCENT_SYMBOL} tokens for these codes. AutoCAD itself
+ * does not rely on the Unicode expansions in the primary text font; it resolves
+ * the symbols through GDT / symbol SHX fonts such as `amgdt.shx` using legacy
+ * control-code code points.
  */
 export type AutoCadPercentSymbolCode = 'c' | 'd' | 'p';
 /**
  * Ordered SHX byte-code candidates for each named AutoCAD percent symbol.
- * Earlier entries are preferred when present in the symbol-font fallback chain
  * Earlier entries are preferred when present in {@link FontManager.symbolFonts}.
  */
 export declare const AUTOCAD_PERCENT_SYMBOL_CONTROL_CODES: Readonly<Record<AutoCadPercentSymbolCode, readonly number[]>>;
 /**
- * Returns whether a character originated from an AutoCAD named percent symbol.
- */
-export declare function isAutoCadPercentSymbolChar(char: string): boolean;
-/**
- * Returns whether a character likely came from an AutoCAD numeric percent code
- * (`%%ddd`) expanded by mtext-parser into {@link String.fromCharCode}.
- *
- * AutoCAD resolves these byte-oriented SHX code points from GDT / symbol fonts
- * (e.g. `amgdt.shx`), not from the primary text font—even when the text font
- * defines a glyph at the same code (as with `txt.shx` at code 132).
- */
-export declare function isAutoCadNumericPercentControlCodeChar(char: string): boolean;
-/**
- * Returns ordered SHX control-code characters to try in symbol-font fallbacks
- * for an AutoCAD percent-symbol Unicode expansion.
- */
-export declare function getShxControlCodeCandidates(char: string): readonly string[];
-/**
- * @deprecated Use {@link getShxControlCodeCandidates} instead.
+ * Returns ordered font code points to try for a parser-emitted percent symbol.
  */
-export declare function getShxControlCodeChar(char: string): string | undefined;
+export declare function getPercentSymbolLookupCodes(data: PercentSymbolData): readonly number[];

package/lib/worker/unifiedRenderer.d.ts

@@ -1,4 +1,4 @@
-import { DefaultFontsPreset } from '../font';
+import { DefaultFontsPreset, FontLoadStatus } from '../font';
 import { StyleManager } from '../renderer';
 import { ColorSettings, MTextData, ShapeData, TextStyle } from '../renderer/types';
 import { MTextObject } from './baseRenderer';
@@ -12,6 +12,8 @@ export declare class UnifiedRenderer {
     private mainThreadRenderer;
     private renderer;
     private defaultMode;
+    private workerConfig;
+    private webWorkerConfigured;
     /**
      * Constructor
      *
@@ -20,6 +22,8 @@ export declare class UnifiedRenderer {
      *                     when render mode is 'worker'.
      */
     constructor(defaultMode?: RenderMode, workerConfig?: WebWorkerRendererConfig);
+    private ensureWebWorkerRenderer;
+    private activateWebWorkerRenderer;
     /**
      * Sets one new style manager to override the default style manager.
      *
@@ -85,6 +89,20 @@ export declare class UnifiedRenderer {
             name: string[];
         }>;
     }>;
+    /**
+     * Parse and cache a user-uploaded font file in IndexedDB.
+     * Always runs on the main-thread {@link FontManager} so the cache is shared
+     * with the web worker renderer.
+     */
+    cacheFont(data: ArrayBuffer | File, fileName?: string, aliases?: string[], encoding?: string): Promise<FontLoadStatus>;
+    /**
+     * Terminate web workers and release their memory.
+     *
+     * The unified renderer keeps working on the main thread. Workers are
+     * recreated lazily the next time worker rendering is requested.
+     * Safe to call when no workers were created.
+     */
+    terminateWorkers(): void;
     /**
      * Clean up resources
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mlightcad/mtext-renderer",
-  "version": "0.11.1",
+  "version": "0.11.3",
   "description": "AutoCAD MText renderer based on Three.js",
   "license": "MIT",
   "author": "MLight Lee <mlight.lee@outlook.com>",
@@ -24,6 +24,16 @@
     "README.md",
     "package.json"
   ],
+  "nx": {
+    "targets": {
+      "build": {
+        "outputs": [
+          "{projectRoot}/dist",
+          "{projectRoot}/lib"
+        ]
+      }
+    }
+  },
   "keywords": [
     "autocad",
     "mtext",
@@ -33,7 +43,7 @@
     "3d-text"
   ],
   "dependencies": {
-    "@mlightcad/mtext-parser": "^1.4.1",
+    "@mlightcad/mtext-parser": "^1.5.0",
     "@mlightcad/shx-parser": "^1.3.4",
     "iconv-lite": "^0.7.0",
     "idb": "^8.0.3",