@mlightcad/mtext-renderer 0.9.0 → 0.9.2

package/lib/renderer/charBoxUtils.d.ts

@@ -0,0 +1,4 @@
+import { CharBox, CharBoxType } from './types';
+import * as THREE from 'three';
+export declare function normalizeBox(box?: THREE.Box3): THREE.Box3 | undefined;
+export declare function buildCharBoxesFromObject(objectCharBoxes: CharBox[], matrixWorld: THREE.Matrix4, charBoxType?: CharBoxType): CharBox[];

package/lib/renderer/mtext.charBoxes.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/renderer/mtext.d.ts

@@ -90,7 +90,8 @@ export declare class MText extends THREE.Object3D {
      *
      * Token semantics:
      * - `CHAR`: `char` is the rendered character, `box` is defined, `children` is empty.
-     * - `NEW_PARAGRAPH`: `char` is `\n`, `box` is `undefined`, `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.
      *

package/lib/renderer/mtextProcessor.d.ts

@@ -3,7 +3,6 @@ import { FontManager } from '../font';
 import { StyleManager } from './styleManager';
 import { MTextFlowDirection, TextStyle } from './types';
 import * as THREE from 'three';
-export declare const STACK_DIVIDER_CHAR = "\uE000";
 export interface MTextFormatOptions {
     /**
      * Font size.

package/lib/renderer/types.d.ts

@@ -62,14 +62,15 @@ 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`, `box` is `undefined`, `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 {
     /** Token type. */
     type: CharBoxType;
-    /** Token bounding box in local MText coordinates (undefined for `NEW_PARAGRAPH`). */
-    box?: THREE.Box3;
+    /** Token bounding box in local MText coordinates. */
+    box: THREE.Box3;
     /** Token character payload (`''` for `STACK`, `\n` for `NEW_PARAGRAPH`). */
     char: string;
     /** Nested token components (currently used by `STACK`). */
@@ -86,6 +87,10 @@ export declare enum CharBoxType {
     /** Stack token (for fraction-style stacked expressions). */
     STACK = "STACK"
 }
+/**
+ * Sentinel character used internally to represent a stack divider line.
+ */
+export declare const STACK_DIVIDER_CHAR = "\uE000";
 export interface StyleTraits {
     /**
      * Optional layer name. Material is identified by layer and color. So it means different

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mlightcad/mtext-renderer",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "AutoCAD MText renderer based on Three.js",
   "license": "MIT",
   "author": "MLight Lee <mlight.lee@outlook.com>",
@@ -41,7 +41,8 @@
   },
   "devDependencies": {
     "@types/opentype.js": "^1.3.8",
-    "@types/three": "^0.172.0"
+    "@types/three": "^0.172.0",
+    "vitest": "^3.2.4"
   },
   "peerDependencies": {
     "three": "^0.172.0"
@@ -52,6 +53,7 @@
     "build:worker": "vite build -c vite.config.worker.ts",
     "clean": "rimraf dist lib tsconfig.tsbuildinfo",
     "lint": "eslint src/",
-    "lint:fix": "eslint --fix --quiet src/"
+    "lint:fix": "eslint --fix --quiet src/",
+    "test": "vitest run"
   }
 }