@mlightcad/mtext-renderer 0.12.0 → 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/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.12.0",
+  "version": "0.12.1",
   "description": "AutoCAD MText renderer based on Three.js",
   "license": "MIT",
   "author": "MLight Lee <mlight.lee@outlook.com>",