@chestnutlabs/gcode-colors 0.3.0 → 0.4.0

package/dist/colors.d.ts

@@ -12,7 +12,7 @@
  * that read an optional channel (`feature`, `object`, `feedrate`) must be
  * capability-gated by the caller before use — the IR is told, not shown nonsense.
  */
-import type { ToolpathIR } from '@chestnutlabs/toolpath-core';
+import { type ToolpathIR } from '@chestnutlabs/toolpath-core';
 export type RGB = [number, number, number];
 export type ColorMode = {
     mode: 'single';
@@ -44,11 +44,24 @@ export type ColorMode = {
     ramp: RGB[];
     range?: [number, number];
     fallback: RGB;
+} | {
+    mode: 'power';
+    ramp: RGB[];
+    range?: [number, number];
+    fallback: RGB;
+} | {
+    mode: 'moveKind';
+    cut: RGB;
+    travel: RGB;
+    fallback: RGB;
 };
 /** Neutral color used when a mode has no palette / the channel value is unknown. */
 export declare const DEFAULT_FALLBACK: RGB;
 /** Min/max of the IR's defined (non-NaN) feedrates — the auto-range for color-by-speed (#177). */
 export declare function feedrateRange(ir: ToolpathIR): [number, number];
+/** Min/max of the IR's captured (non-NaN) tool-power values — the auto-range for color-by-power
+ *  (#189). Returns `[0, 0]` when the `toolPower` modal channel was not captured. */
+export declare function toolPowerRange(ir: ToolpathIR): [number, number];
 /**
  * Per-layer height (mm): the Z-delta from the previous layer, indexed by layer. Layer 0's height is
  * its absolute Z (its thickness from the bed). Negative deltas (non-monotonic Z, e.g. spiral/vase

package/dist/colors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../src/colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3C,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,GAAG,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,GAAG,EAAE,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,GAAG,EAAE,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAA;CAAE,GAItD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,GAAG,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAA;CAAE,GAG1E;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,GAAG,EAAE,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAKhE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,GAAG,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAA;CAAE,CAAC;AAElF,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,EAAE,GAAqB,CAAC;AAErD,kGAAkG;AAClG,wBAAgB,aAAa,CAAC,EAAE,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAW9D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,UAAU,GAAG,YAAY,CAOzD;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CASjE;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,GAAG,CAWrD;AAkBD,4EAA4E;AAC5E,MAAM,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,GAAG,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,GAAG,cAAc,CAwDpF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,CAEnF"}
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../src/colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAExE,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3C,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,GAAG,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,GAAG,EAAE,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,GAAG,EAAE,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAA;CAAE,GAItD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,GAAG,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAA;CAAE,GAG1E;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,GAAG,EAAE,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAKhE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,GAAG,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAA;CAAE,GAK7E;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,GAAG,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAA;CAAE,GAGvE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAA;CAAE,CAAC;AAE/D,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,EAAE,GAAqB,CAAC;AAErD,kGAAkG;AAClG,wBAAgB,aAAa,CAAC,EAAE,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAW9D;AAED;oFACoF;AACpF,wBAAgB,cAAc,CAAC,EAAE,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAY/D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,UAAU,GAAG,YAAY,CAOzD;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CASjE;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,GAAG,CAWrD;AAkBD,4EAA4E;AAC5E,MAAM,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,GAAG,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,GAAG,cAAc,CA+EpF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,CAEnF"}

package/dist/colors.js

@@ -1,3 +1,18 @@
+/**
+ * Renderer-agnostic per-segment color model (DD-014 D3, extracted from
+ * `gcode-renderer-three` so the 3D and 2D renderers single-source it).
+ *
+ * A color is a pure function of the IR's channels (`tool`/`feature`/`object`/
+ * `feedrate`/`colorChanges`) and a consumer palette — no `three`, no canvas, no
+ * geometry. Each renderer maps the returned {@link RGB} onto its own surface
+ * (a vertex-color buffer for WebGL, a `strokeStyle` for Canvas 2D).
+ *
+ * Honesty is built in: unknown channel values degrade to the mode's `fallback`
+ * (or the neutral default), never a fabricated role/speed/object color. Modes
+ * that read an optional channel (`feature`, `object`, `feedrate`) must be
+ * capability-gated by the caller before use — the IR is told, not shown nonsense.
+ */
+import { MoveKind } from '@chestnutlabs/toolpath-core';
 /** Neutral color used when a mode has no palette / the channel value is unknown. */
 export const DEFAULT_FALLBACK = [0.7, 0.7, 0.7];
 /** Min/max of the IR's defined (non-NaN) feedrates — the auto-range for color-by-speed (#177). */
@@ -16,6 +31,25 @@ export function feedrateRange(ir) {
     }
     return min <= max ? [min, max] : [0, 0];
 }
+/** Min/max of the IR's captured (non-NaN) tool-power values — the auto-range for color-by-power
+ *  (#189). Returns `[0, 0]` when the `toolPower` modal channel was not captured. */
+export function toolPowerRange(ir) {
+    const p = ir.segments.modal?.toolPower;
+    if (p === undefined)
+        return [0, 0];
+    let min = Infinity;
+    let max = -Infinity;
+    for (let i = 0; i < p.length; i++) {
+        const v = p[i];
+        if (Number.isNaN(v))
+            continue;
+        if (v < min)
+            min = v;
+        if (v > max)
+            max = v;
+    }
+    return min <= max ? [min, max] : [0, 0];
+}
 /**
  * Per-layer height (mm): the Z-delta from the previous layer, indexed by layer. Layer 0's height is
  * its absolute Z (its thickness from the bed). Negative deltas (non-monotonic Z, e.g. spiral/vase
@@ -128,6 +162,31 @@ export function createSegmentColorer(ir, mode) {
             return rampColor(mode.ramp, span > 0 ? (heights[li] - lo) / span : 0);
         };
     }
+    if (mode.mode === 'power') {
+        const power = seg.modal?.toolPower;
+        // The channel wasn't captured (parse didn't request toolPower) → everything is fallback.
+        if (power === undefined) {
+            const fb = mode.fallback;
+            return () => fb;
+        }
+        const [lo, hi] = mode.range ?? toolPowerRange(ir);
+        const span = hi - lo;
+        // NaN (tool off / never engaged) → fallback, never a fabricated power color.
+        return (i) => {
+            const v = power[i];
+            return Number.isNaN(v) ? mode.fallback : rampColor(mode.ramp, span > 0 ? (v - lo) / span : 0);
+        };
+    }
+    if (mode.mode === 'moveKind') {
+        return (i) => {
+            const k = seg.kind[i];
+            if ((k & (MoveKind.Extrude | MoveKind.Cut)) !== 0)
+                return mode.cut; // productive move
+            if ((k & MoveKind.Travel) !== 0)
+                return mode.travel; // rapid
+            return mode.fallback;
+        };
+    }
     // object mode: object 0 = none/unknown → fallback; `only` isolates one object, dimming the rest (#178).
     return (i) => {
         const obj = seg.object[i];

package/dist/index.d.ts

@@ -8,5 +8,5 @@
  * `three`, no canvas, no framework.
  */
 export type { RGB, ColorMode, SegmentColorer } from './colors.js';
-export { DEFAULT_FALLBACK, feedrateRange, layerHeights, layerHeightRange, rampColor, createSegmentColorer, segmentColor } from './colors.js';
+export { DEFAULT_FALLBACK, feedrateRange, toolPowerRange, layerHeights, layerHeightRange, rampColor, createSegmentColorer, segmentColor } from './colors.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,YAAY,EAAE,GAAG,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,oBAAoB,EACpB,YAAY,EACb,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,YAAY,EAAE,GAAG,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,oBAAoB,EACpB,YAAY,EACb,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1 +1 @@
-export { DEFAULT_FALLBACK, feedrateRange, layerHeights, layerHeightRange, rampColor, createSegmentColorer, segmentColor } from './colors.js';
+export { DEFAULT_FALLBACK, feedrateRange, toolPowerRange, layerHeights, layerHeightRange, rampColor, createSegmentColorer, segmentColor } from './colors.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chestnutlabs/gcode-colors",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Renderer-agnostic per-segment color model for the Chestnut Labs G-code toolpath stack (DD-014 D3): the ColorMode union and honest, capability-gated segment coloring over ToolpathIR channels, shared by the 3D and 2D renderers.",
   "keywords": [
     "gcode",
@@ -47,6 +47,6 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@chestnutlabs/toolpath-core": "0.3.0"
+    "@chestnutlabs/toolpath-core": "0.4.0"
   }
 }