@mlightcad/mtext-renderer 0.11.10 → 0.12.1

package/lib/renderer/colorUtils.d.ts

@@ -1,10 +1,30 @@
+import { MTextColor } from '@mlightcad/mtext-parser';
 import { ColorSettings } from './types';
 export declare function resolveMTextColor(colorSettings: ColorSettings): number;
+/** Wire-format for an `MTextColor` carried on worker glyph payloads. */
+export interface SerializedMTextColor {
+    aci?: number | null;
+    rgbValue?: number | null;
+}
+/**
+ * Serializes an `MTextColor` for worker → main-thread transfer.
+ *
+ * Prefer this over baking only the resolved RGB: ACI 7 (canvas foreground) and
+ * ACI 255 (literal white) both resolve to `0xffffff` on a dark canvas, but only
+ * ACI 7 must invert when the background flips.
+ */
+export declare function serializeMTextColor(color: MTextColor): SerializedMTextColor;
+/** Revives a wire-format color into a real `MTextColor` instance. */
+export declare function deserializeMTextColor(serialized?: SerializedMTextColor | null): MTextColor | undefined;
 /**
  * Rebuild ColorSettings for a worker-deserialized glyph material.
  *
- * Worker meshes already carry the final resolved RGB in their serialized
- * material. When the entity base color is ByLayer, preserve that semantic only
- * for glyphs that match the layer fallback color.
+ * Prefer {@link serializedColor} when the worker attached the original segment
+ * color (ACI / RGB). Falling back to resolved RGB alone cannot distinguish
+ * ACI 7 from ACI 255.
+ *
+ * Without a serialized color, preserve ByLayer / ByBlock / entity ACI when the
+ * glyph RGB still matches the entity base resolution; otherwise bake RGB for
+ * true inline overrides.
  */
-export declare function buildWorkerMaterialColorSettings(base: ColorSettings, resolvedColor: number, baseByLayer: boolean): ColorSettings;
+export declare function buildWorkerMaterialColorSettings(base: ColorSettings, resolvedColor: number, baseByLayer: boolean, serializedColor?: SerializedMTextColor | null): ColorSettings;

package/lib/renderer/constants.d.ts

@@ -1,8 +1,15 @@
 /**
- * Scale applied with `lineSpaceFactor` when computing the extra vertical gap
- * between MTEXT lines in {@link MTextProcessor}.
+ * AutoCAD single-line spacing as a multiple of text height ("3-on-5").
+ *
+ * DXF group 44 (`lineSpaceFactor`) is a ratio relative to this single spacing,
+ * so baseline-to-baseline distance =
+ * `lineSpaceFactor × LINE_SPACING_SCALE_FACTOR × textHeight`.
  */
-export declare const LINE_SPACING_SCALE_FACTOR = 1.666666;
+export declare const LINE_SPACING_SCALE_FACTOR: number;
+/**
+ * Default DXF group-44 line spacing factor (AutoCAD single spacing).
+ */
+export declare const DEFAULT_LINE_SPACE_FACTOR = 1;
 /**
  * Vertical compensation needed after switching normal glyph placement from
  * top-anchored to baseline-anchored coordinates.

package/lib/renderer/mtextProcessor.d.ts

@@ -16,7 +16,8 @@ export interface MTextFormatOptions {
      */
     widthFactor: number;
     /**
-     * The line space factor.
+     * AutoCAD DXF group-44 line spacing factor: ratio of actual line spacing to
+     * single spacing (`5/3` of text height). Default is `1.0`.
      */
     lineSpaceFactor: number;
     /**
@@ -165,7 +166,8 @@ export declare class MTextProcessor {
      */
     get defaultFontSize(): number;
     /**
-     * The default line space factor
+     * AutoCAD DXF group-44 line spacing factor (multiple of single spacing).
+     * Single spacing is {@link LINE_SPACING_SCALE_FACTOR} × text height.
      */
     get defaultLineSpaceFactor(): number;
     /**
@@ -191,7 +193,11 @@ export declare class MTextProcessor {
      */
     get currentLayoutFontSize(): number;
     /**
-     * The height of current line of texts
+     * Baseline-to-baseline advance for the current line (AutoCAD MTEXT semantics).
+     *
+     * Single spacing is `5/3` of the drawing-space text height; `lineSpaceFactor`
+     * (DXF group 44) scales that distance. Font glyph scale factors must not
+     * affect this layout metric — use {@link currentLayoutFontSize}.
      */
     get currentLineHeight(): number;
     /**

package/lib/renderer/types.d.ts

@@ -170,7 +170,11 @@ export interface MTextData {
     attachmentPoint?: MTextAttachmentPoint;
     /** Determines the primary direction in which text flows */
     drawingDirection?: MTextFlowDirection;
-    /** Factor that controls the spacing between text lines. Default is 1.0 */
+    /**
+     * AutoCAD DXF group-44 line spacing factor.
+     * Ratio of actual baseline spacing to single spacing (`5/3` of text height).
+     * Default is `1.0`.
+     */
     lineSpaceFactor?: number;
     /** The width scaling factor applied to each character. Default is 1.0 */
     widthFactor?: number;

package/lib/worker/webWorkerRenderer.d.ts

@@ -113,6 +113,11 @@ interface SerializedChild {
         opacity: number;
         side?: number;
         linewidth?: number;
+        /** Original segment colour when the worker preserved ACI/RGB semantics. */
+        mtextColor?: {
+            aci?: number | null;
+            rgbValue?: number | null;
+        };
     };
     charBoxType?: CharBox['type'];
     lineLayouts?: Array<{

package/package.json

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