@mlightcad/mtext-renderer 0.13.7 → 0.13.8

package/lib/font/fontManager.d.ts

@@ -319,6 +319,30 @@ export declare class FontManager {
      * Used after primary and optional bigFont lookups per AutoCAD text-style semantics.
      */
     getCharShapeFromDefaults(char: string, size: number): BaseTextShape | undefined;
+    /**
+     * Looks up `char` in every loaded SHX BIGFONT face (and BIGFONT names listed
+     * in {@link defaultFonts}), using each face's own scale factor.
+     *
+     * AutoCAD text styles bind one Big Font file, but when that face's code page
+     * cannot represent a glyph (e.g. simplified Chinese on Japanese `bigfont.shx`)
+     * viewers still find the character in another available Big Font such as
+     * `gbcbig.shx`. A hand-maintained simplified→Japanese character map cannot
+     * cover the repertoire; searching loaded BIGFONT faces does.
+     *
+     * @param char - Character to resolve.
+     * @param layoutSize - MTEXT layout height (cap-height), before per-font scale.
+     * @param excludeFontName - Optional style Big Font already tried.
+     * @returns Shape plus the font that supplied it, or `undefined`.
+     */
+    getCharShapeFromLoadedBigfonts(char: string, layoutSize: number, excludeFontName?: string): {
+        shape: BaseTextShape;
+        fontName: string;
+    } | undefined;
+    /**
+     * Horizontal BIGFONT cell width at `layoutSize` for the named face, or
+     * `undefined` when the face is missing / not a BIGFONT.
+     */
+    getBigfontCellWidth(fontName: string, layoutSize: number): number | undefined;
     /**
      * Gets the text shape from configured GDT / symbol fonts (e.g. `amgdt.shx`)
      * by font-internal character code.

package/lib/renderer/mtextProcessor.d.ts

@@ -485,7 +485,8 @@ export declare class MTextProcessor {
      * Lays out and renders one parser word token, breaking to a new visual line when needed.
      *
      * - CJK / non-Latin: no whole-word wrap — {@link processChar} breaks between
-     *   characters when the next glyph would not fit in the defined width.
+     *   characters when the pen has already reached the defined width (a glyph
+     *   that starts inside may slightly overshoot).
      * - Latin/ASCII: wrap only at word boundaries (spaces). AutoCAD/GstarCAD do
      *   not hyphenate: a token wider than the column stays on one visual line and
      *   overflows the box (e.g. part numbers like `1157*25*1.5`). A short run that
@@ -560,10 +561,14 @@ export declare class MTextProcessor {
      * Renders one character glyph, including decorations and line-break handling.
      *
      * Missing glyphs are treated as spaces. Soft wrap is decided before placement:
-     * if the glyph's advance would not fit in the remaining defined width, break
-     * first (CJK may break between any two characters). Latin/ASCII word tokens
-     * suppress this so they overflow instead of hyphenating. The first glyph on an
-     * empty line is always placed even when wider than the box.
+     * break when the pen has already reached the defined width so the next glyph
+     * cannot *start* inside the column (CJK may break between any two characters).
+     * A glyph that starts inside the column is kept even if its advance slightly
+     * overshoots — AutoCAD title-block cells are often sized to N capital-A CJK
+     * advances within a fraction of a percent, and wrapping on end-past-width
+     * falsely pushes the last ideograph onto the next line. Latin/ASCII word
+     * tokens suppress this so they overflow instead of hyphenating. The first
+     * glyph on an empty line is always placed even when wider than the box.
      *
      * @param char Character to render.
      * @param geometries Mesh geometry accumulator.
@@ -618,15 +623,17 @@ export declare class MTextProcessor {
      */
     private resolvePercentSymbolShape;
     /**
-     * Resolves the text shape for one character using primary font, big font, defaults, and symbol fonts.
+     * Drawing-space glyph size for a specific face.
      *
-     * Updates {@link _maxFontSize} when the active font size exceeds the current line maximum.
-     * Falls back to the not-found glyph when no renderable geometry is available.
-     *
-     * @param char Character to resolve.
-     * @returns Renderable text shape and the font that supplied it.
+     * {@link currentFontSize} is inflated by the *primary* style font's scale
+     * factor (SHX cap-height or TrueType capital-A). BIGFONT / fallback faces
+     * have their own scale — fetching them at the primary size stretches CJK
+     * cells and shifts mixed runs.
      */
+    private shapeSizeForFont;
     private resolveCharShape;
+    /** CJK Unified Ideographs and common compatibility blocks used in CAD text. */
+    private isCjkIdeograph;
     private canProbeFontOwnership;
     private fontHasChar;
     /**

package/package.json

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