@mlightcad/mtext-renderer 0.9.4 → 0.10.1

package/lib/renderer/mtext.d.ts

@@ -1,6 +1,6 @@
 import { FontManager } from '../font';
 import { StyleManager } from './styleManager';
-import { CharBox, ColorSettings, MTextData, TextStyle } from './types';
+import { ColorSettings, MTextData, MTextLayout, TextStyle } from './types';
 import * as THREE from 'three';
 /**
  * Represents an AutoCAD MText object in Three.js.
@@ -20,8 +20,8 @@ export declare class MText extends THREE.Object3D {
     private _colorSettings;
     /** The bounding box of the entire MText object */
     private _box;
-    /** Array of per-character bounding boxes with debug chars */
-    private _charBoxes;
+    /** Lazily built layout data (line geometry + char boxes). */
+    private _layoutData;
     /** Raw mtext data to draw on demand */
     private _mtextData;
     /**
@@ -85,21 +85,8 @@ export declare class MText extends THREE.Object3D {
      */
     get box(): THREE.Box3;
     set box(box: THREE.Box3);
-    /**
-     * Gets logical text token boxes for picking/debug.
-     *
-     * Token semantics:
-     * - `CHAR`: `char` is the rendered character, `box` is defined, `children` is empty.
-     * - `NEW_PARAGRAPH`: `char` is `\n`. The `box` represents a zero-width vertical
-     *   line whose height equals the current line height. `children` is empty.
-     * - `STACK`: `char` is empty string (`''`), `box` is the union of stack component boxes,
-     *   and `children` contains the stack sub-components.
-     *
-     * Notes:
-     * - Superscript/subscript stacks (`^`) are emitted as regular `CHAR` entries.
-     * - Fraction stacks (`/`, `#`) are emitted as one `STACK` entry.
-     */
-    get charBoxes(): CharBox[];
+    /** Creates text layout data for cursor/picking/debug usage on demand. */
+    createLayoutData(): MTextLayout;
     /**
      * Calculates intersections between a ray and this MText object.
      * Overrides the base THREE.Object3D raycast method to use the text's bounding boxes.
@@ -135,7 +122,8 @@ export declare class MText extends THREE.Object3D {
      * @param object - The Three.js object to process
      * @param boxes - Array to store the calculated bounding boxes
      */
-    private getBoxes;
+    private getLayout;
+    private updateBoxFromObject;
     /**
      * Remove the specified object from its parent and release geometry and material resource used
      * by the object.

package/lib/renderer/mtextProcessor.d.ts

@@ -1,7 +1,7 @@
 import { ChangedProperties, MTextParagraphAlignment, MTextToken } from '@mlightcad/mtext-parser';
 import { FontManager } from '../font';
 import { StyleManager } from './styleManager';
-import { MTextFlowDirection, TextStyle } from './types';
+import { LineLayout, MTextFlowDirection, TextStyle } from './types';
 import * as THREE from 'three';
 export interface MTextFormatOptions {
     /**
@@ -74,6 +74,9 @@ export declare class MTextProcessor {
     private _lastCharBoxTarget;
     private _lineHasRenderableChar;
     private _pendingEmptyLineFontSizeAdjust?;
+    private _lineLayouts;
+    private _lineBreakIndices;
+    private _processedCharCount;
     private _currentIndent;
     private _currentLeftMargin;
     private _currentRightMargin;
@@ -153,6 +156,7 @@ export declare class MTextProcessor {
      * All of THREE.js objects in current line. It contains objects in all of sections of this line.
      */
     get currentLineObjects(): THREE.Object3D<THREE.Object3DEventMap>[];
+    get lineLayouts(): LineLayout[];
     /**
      * The horizental offset of current character in this line
      */
@@ -199,7 +203,8 @@ export declare class MTextProcessor {
      */
     private convertTopAlignedVOffset;
     private processBlank;
-    private recordLineBreak;
+    private recordVisualLineBreak;
+    private recordCurrentLineLayout;
     private processChar;
     private processLastLine;
     private initLineParams;
@@ -214,8 +219,8 @@ export declare class MTextProcessor {
      * @returns Return the text shape of the specified character
      */
     private getCharShape;
-    private startNewLine;
     private advanceToNextLine;
+    private countFinalCharBoxes;
     private applyPendingEmptyLineYAdjust;
     private resolveCharBoxTarget;
     /**

package/lib/renderer/types.d.ts

@@ -62,8 +62,6 @@ export declare enum MTextAttachmentPoint {
  *
  * Semantics by {@link CharBoxType}:
  * - `CHAR`: `char` is the rendered character, `box` is defined, `children` is empty.
- * - `NEW_PARAGRAPH`: `char` is `\n`. The `box` represents a zero-width vertical
- *   line whose height equals the current line height. `children` is empty.
  * - `STACK`: `char` is `''`, `box` is the union box of stack components, `children` contains stack parts.
  */
 export interface CharBox {
@@ -71,19 +69,45 @@ export interface CharBox {
     type: CharBoxType;
     /** Token bounding box in local MText coordinates. */
     box: THREE.Box3;
-    /** Token character payload (`''` for `STACK`, `\n` for `NEW_PARAGRAPH`). */
+    /** Token character payload (`''` for `STACK`). */
     char: string;
     /** Nested token components (currently used by `STACK`). */
     children: CharBox[];
 }
+/**
+ * Per-line layout geometry used by text cursor and line hit-testing.
+ */
+export interface LineLayout {
+    /** Line center Y used for cursor placement and hit-testing. */
+    y: number;
+    /** Line height used for cursor size and vertical hit area. */
+    height: number;
+    /**
+     * Visual line-break index in `MTextLayout.chars` for this line.
+     * Index `i` means a break between char `i - 1` and char `i`.
+     *
+     * This is line-boundary data (rendered rows), not paragraph structure.
+     * Duplicated indices are meaningful and represent empty lines.
+     *
+     * This field is `undefined` for the last rendered line.
+     */
+    breakIndex?: number;
+}
+/**
+ * Aggregated layout output for rendered MText.
+ */
+export interface MTextLayout {
+    /** Per-line layout entries. */
+    lines: LineLayout[];
+    /** Logical text token boxes for picking/debug. */
+    chars: CharBox[];
+}
 /**
  * Type of logical token emitted in {@link CharBox} output.
  */
 export declare enum CharBoxType {
     /** Regular rendered character token. */
     CHAR = "CHAR",
-    /** Explicit paragraph break token. */
-    NEW_PARAGRAPH = "NEW_PARAGRAPH",
     /** Stack token (for fraction-style stacked expressions). */
     STACK = "STACK"
 }

package/lib/worker/baseRenderer.d.ts

@@ -1,5 +1,5 @@
 import { StyleManager } from '../renderer/styleManager';
-import { CharBox, ColorSettings, MTextData, TextStyle } from '../renderer/types';
+import { ColorSettings, MTextData, MTextLayout, TextStyle } from '../renderer/types';
 import * as THREE from 'three';
 /**
  * Represents a rendered MText object that extends THREE.Object3D with additional MText-specific properties.
@@ -13,9 +13,10 @@ export interface MTextObject extends THREE.Object3D {
      */
     box: THREE.Box3;
     /**
-     * The list of bounding boxes for each glyph in the MText object.
+     * Create text layout details (lines and logical char boxes) on demand.
+     * The result may be internally cached and reused by subsequent calls.
      */
-    charBoxes: CharBox[];
+    createLayoutData(): MTextLayout;
 }
 /**
  * Defines the common rendering contract for producing Three.js objects from MText content.

package/lib/worker/webWorkerRenderer.d.ts

@@ -1,5 +1,5 @@
 import { StyleManager } from '../renderer/styleManager';
-import { ColorSettings, MTextData, TextStyle } from '../renderer/types';
+import { CharBox, ColorSettings, MTextData, TextStyle } from '../renderer/types';
 import { MTextBaseRenderer, MTextObject } from './baseRenderer';
 /**
  * Configuration options for WebWorkerRenderer
@@ -53,6 +53,23 @@ interface SerializedMText {
     };
     children: SerializedChild[];
 }
+interface SerializedCharBox {
+    type: string;
+    char: string;
+    box: {
+        min: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        max: {
+            x: number;
+            y: number;
+            z: number;
+        };
+    };
+    children: SerializedCharBox[];
+}
 interface SerializedChild {
     type: 'mesh' | 'line';
     position: {
@@ -96,6 +113,13 @@ interface SerializedChild {
         side?: number;
         linewidth?: number;
     };
+    charBoxType?: CharBox['type'];
+    lineLayouts?: Array<{
+        y: number;
+        height: number;
+        breakIndex?: number;
+    }>;
+    charBoxes?: SerializedCharBox[];
 }
 /**
  * Manages communication with the MText web worker
@@ -155,6 +179,8 @@ export declare class WebWorkerRenderer implements MTextBaseRenderer {
      * Reconstruct MText object from JSON serialized data
      */
     reconstructMText(serializedData: SerializedMText, textStyle: TextStyle): MTextObject;
+    private deserializeCharBoxes;
+    private collectLayout;
     /**
      * Terminate the worker
      */

package/package.json

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