@chestnutlabs/toolpath-core 0.1.0 → 0.3.0

package/README.md

@@ -2,7 +2,7 @@
 
 Neutral **`ToolpathIR`** and **capability model** for the Chestnut Labs G-code Preview toolpath stack.
 This is the replacement seam for the whole stack: the parser **writes** it, renderers and analyzers **read**
-it. See [`docs/design/DD-001`](../../docs/design/DD-001-toolpath-ir-and-capability-model.md).
+it. See [`docs/design/DD-001`](https://github.com/ChestnutLabs/gcode-preview/blob/dev/docs/design/DD-001-toolpath-ir-and-capability-model.md).
 
 **Design rules**
 

package/dist/builder.d.ts

@@ -59,10 +59,30 @@ export declare class ToolpathIRBuilder {
     private readonly srcByte;
     private readonly toolsMap;
     private readonly objectsList;
+    private readonly retractionsList;
+    private readonly colorChangesList;
     private readonly warnings;
     private readonly capabilities;
     constructor(opts?: BuilderOptions);
     addSegment(s: SegmentInput): void;
+    /** Record a retraction/unretraction event (DD-009 D1, #148). Position is absolute; stored origin-relative. */
+    addRetraction(r: {
+        x: number;
+        y: number;
+        z: number;
+        kind: 'retract' | 'unretract';
+        srcByte: number;
+        segIndex: number;
+    }): void;
+    /** Record an M600 color-change boundary (DD-009 D2, #147). Position is absolute; stored origin-relative. */
+    addColorChange(c: {
+        x: number;
+        y: number;
+        z: number;
+        segIndex: number;
+        srcByte: number;
+        tool: number;
+    }): void;
     addWarning(w: Warning): void;
     setCapability(name: string, confidence: Confidence): void;
     setTool(info: ToolInfo): void;

package/dist/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,UAAU,EAIf,KAAK,KAAK,EACV,KAAK,IAAI,EACT,KAAK,OAAO,EACb,MAAM,SAAS,CAAC;AAIjB,0GAA0G;AAC1G,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,MAAM,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,oFAAoF;IACpF,YAAY,CAAC,EAAE,IAAI,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;IACtC,OAAO,CAAC,YAAY,CAAc;IAElC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAgB;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAgB;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAgB;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAgB;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAgB;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAgB;IACnC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAgB;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IAExC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;gBAEnD,IAAI,GAAE,cAAmB;IAKrC,UAAU,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI;IAwBjC,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5B,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI;IAIzD,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAI7B,sFAAsF;IACtF,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAKnC,QAAQ,IAAI,UAAU;CA4CvB"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}

package/dist/builder.js

@@ -28,6 +28,8 @@ export class ToolpathIRBuilder {
     srcByte = [];
     toolsMap = new Map();
     objectsList = [];
+    retractionsList = [];
+    colorChangesList = [];
     warnings = [];
     capabilities = {};
     constructor(opts = {}) {
@@ -57,6 +59,30 @@ export class ToolpathIRBuilder {
             this.toolsMap.set(s.tool, { id: s.tool });
         }
     }
+    /** Record a retraction/unretraction event (DD-009 D1, #148). Position is absolute; stored origin-relative. */
+    addRetraction(r) {
+        const o = this.originOffset ?? { x: 0, y: 0, z: 0 };
+        this.retractionsList.push({
+            x: r.x - o.x,
+            y: r.y - o.y,
+            z: r.z - o.z,
+            kind: r.kind,
+            srcByte: r.srcByte,
+            segIndex: r.segIndex
+        });
+    }
+    /** Record an M600 color-change boundary (DD-009 D2, #147). Position is absolute; stored origin-relative. */
+    addColorChange(c) {
+        const o = this.originOffset ?? { x: 0, y: 0, z: 0 };
+        this.colorChangesList.push({
+            x: c.x - o.x,
+            y: c.y - o.y,
+            z: c.z - o.z,
+            segIndex: c.segIndex,
+            srcByte: c.srcByte,
+            tool: c.tool
+        });
+    }
     addWarning(w) {
         this.warnings.push(w);
     }
@@ -111,7 +137,18 @@ export class ToolpathIRBuilder {
             capabilities: this.capabilities
         };
         const tools = [...this.toolsMap.values()].sort((a, b) => a.id - b.id);
-        return { header, segments, layers, tools, objects: this.objectsList, bounds, boundsWithTravel, sourceIndex };
+        return {
+            header,
+            segments,
+            layers,
+            tools,
+            objects: this.objectsList,
+            retractions: this.retractionsList,
+            colorChanges: this.colorChangesList,
+            bounds,
+            boundsWithTravel,
+            sourceIndex
+        };
     }
 }
 /** Group segments into layers by their `layer` index; layer Z is absolute. Assumes dense layer indices. */

package/dist/index.d.ts

@@ -11,4 +11,6 @@ export * from './bounds.js';
 export * from './source-index.js';
 export * from './metadata.js';
 export * from './progress.js';
+export * from './time.js';
+export * from './source-map.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;;;;;;GAMG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -11,3 +11,5 @@ export * from './bounds.js';
 export * from './source-index.js';
 export * from './metadata.js';
 export * from './progress.js';
+export * from './time.js';
+export * from './source-map.js';

package/dist/ir.d.ts

@@ -126,6 +126,43 @@ export interface ObjectInfo {
     id: string;
     name?: string;
 }
+/**
+ * A filament retraction (`retract`) or its reversal (`unretract`) — an E-only move
+ * with no XYZ travel, so it has a *position* but no segment in the main stream
+ * (DD-009 D1 amendment, #148). Kept in a sparse side channel so segment indices,
+ * scrub, and layer ranges are untouched. `segIndex` is the index of the next
+ * segment emitted after the event, for layer/scrub-aligned marker clipping.
+ */
+export interface RetractionEvent {
+    /** Position (same frame as segments: origin-relative). */
+    x: number;
+    y: number;
+    z: number;
+    kind: 'retract' | 'unretract';
+    /** Byte offset in the source for scrub/telemetry alignment. */
+    srcByte: number;
+    /** Segment index at the moment of the event (draw-range clip alignment). */
+    segIndex: number;
+}
+/**
+ * A manual filament-swap color boundary (`M600`) — a marker with a *position* but
+ * no motion segment (DD-009 D2 amendment, #147). Like {@link RetractionEvent} it is
+ * kept in a sparse side channel so segment indices, scrub, and layer ranges are
+ * untouched. The renderer's `colorChange` color mode shades segments by *swap slot*
+ * (the count of color changes at or before a segment), NOT by the `tool` channel.
+ */
+export interface ColorChangeEvent {
+    /** Position (same frame as segments: origin-relative). */
+    x: number;
+    y: number;
+    z: number;
+    /** Index of the first segment emitted after the swap (slot boundary + marker clip). */
+    segIndex: number;
+    /** Byte offset in the source for scrub/telemetry alignment. */
+    srcByte: number;
+    /** Tool active at the swap — provenance only; not used to pick the swap color. */
+    tool: number;
+}
 export interface ToolpathBounds {
     min: Vec3;
     max: Vec3;
@@ -141,6 +178,10 @@ export interface ToolpathIR {
     layers: ToolpathLayer[];
     tools: ToolInfo[];
     objects: ObjectInfo[];
+    /** Sparse retraction/unretraction events (DD-009 D1, #148); empty when none seen. */
+    retractions: RetractionEvent[];
+    /** Sparse M600 filament-swap color-change boundaries (DD-009 D2, #147); empty when none seen. */
+    colorChanges: ColorChangeEvent[];
     /** Bounds over extruding moves only. */
     bounds: ToolpathBounds;
     /** Bounds including travel moves. */

package/dist/ir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"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"}

package/dist/metadata.d.ts

@@ -64,6 +64,39 @@ export interface FilamentInfo {
     color?: string;
     name?: string;
 }
+/**
+ * Slicer-reported filament consumption (#183) — the "info panel" totals a slicer emits as G-code
+ * comments. Absent when the slicer doesn't report it (capability-honest). Aggregate across extruders;
+ * fields are independently optional (a slicer may report length but not weight).
+ */
+export interface FilamentUsage {
+    /** Total filament length in millimetres. */
+    lengthMm?: number;
+    /** Total extruded volume in cm³. */
+    volumeCm3?: number;
+    /** Total filament weight in grams. */
+    weightG?: number;
+    source: {
+        adapterId: string;
+        evidence: string;
+        srcByte?: number;
+    };
+}
+/**
+ * The slicer's own print-time estimate (#183) — the trustworthy figure for a time readout / time
+ * scrub, versus a kinematic estimate. Absent when the slicer doesn't emit it.
+ */
+export interface PrintEstimate {
+    /** Estimated print duration in seconds. */
+    seconds: number;
+    /** Slicer mode label when given (e.g. PrusaSlicer 'normal' / 'silent'). */
+    mode?: string;
+    source: {
+        adapterId: string;
+        evidence: string;
+        srcByte?: number;
+    };
+}
 export interface ThumbnailData {
     width: number;
     height: number;
@@ -80,6 +113,10 @@ export interface DialectMetadata {
     dialects?: DialectDetection[];
     machine?: MachineGeometry;
     filaments?: FilamentInfo[];
+    /** Slicer-reported total filament consumption (#183); absent when not emitted. */
+    filamentUsage?: FilamentUsage;
+    /** The slicer's own print-time estimate (#183); absent when not emitted. */
+    printEstimate?: PrintEstimate;
     thumbnails?: ThumbnailData[];
     /** Whitelisted key/value settings only — bounded, never local paths. */
     raw?: Record<string, string>;

package/dist/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,WAAW,MAAM;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,gEAAgE;AAChE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EACC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAC1C;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GACtD;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC1C,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,UAAU,EAAE,UAAU,CAAC;IACvB,oEAAoE;IACpE,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnE;AAED,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IACxC,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,WAAW,MAAM;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,gEAAgE;AAChE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EACC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAC1C;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GACtD;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC1C,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,UAAU,EAAE,UAAU,CAAC;IACvB,oEAAoE;IACpE,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnE;AAED,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IACxC,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnE;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnE;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,kFAAkF;IAClF,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,4EAA4E;IAC5E,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B"}

package/dist/source-map.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Source-line ↔ segment mapping (#184) — the "G-code debugger" surface: resolve a rendered segment
+ * to the G-code line that produced it, and a source line back to its segment. Framework-free and
+ * built on data the IR already carries (`segments.srcByte`, the byte→segment `sourceIndex`); the only
+ * missing piece is byte↔line, which needs the source text (the IR stores byte offsets, not lines).
+ *
+ * Build a {@link SourceLineIndex} once from the source, then all four lookups are O(log n).
+ */
+import { type SourceIndex } from './ir.js';
+/** Byte offsets of each line start (index 0 = line 1 at byte 0), plus the total length. */
+export interface SourceLineIndex {
+    /** `lineStarts[k]` is the byte offset where line `k + 1` begins. */
+    lineStarts: Uint32Array;
+    /** Total source length in bytes. */
+    byteLength: number;
+}
+/** Build the line index from the raw source (string or the parsed bytes). O(bytes), one pass. */
+export declare function buildSourceLineIndex(source: string | Uint8Array): SourceLineIndex;
+/** 1-based line number containing `byteOffset` (binary search). Clamped to [1, lineCount]. */
+export declare function lineAtByte(index: SourceLineIndex, byteOffset: number): number;
+/** Byte range `[start, end)` of a 1-based `line`; null when out of range. `end` excludes the newline-led next line. */
+export declare function byteRangeOfLine(index: SourceLineIndex, line: number): [number, number] | null;
+/** 1-based source line that produced segment `segIndex`; null when the index is out of range. */
+export declare function sourceLineOfSegment(srcByte: Uint32Array, lineIndex: SourceLineIndex, segIndex: number): number | null;
+/**
+ * The segment produced by a 1-based source `line`, or -1 when the line produced no segment (a comment,
+ * a blank line, or a non-motion command). Resolves to the first segment whose source byte falls within
+ * the line's byte range.
+ */
+export declare function segmentAtSourceLine(sourceIndex: SourceIndex, lineIndex: SourceLineIndex, line: number): number;
+//# sourceMappingURL=source-map.d.ts.map

package/dist/source-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-map.d.ts","sourceRoot":"","sources":["../src/source-map.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,2FAA2F;AAC3F,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,UAAU,EAAE,WAAW,CAAC;IACxB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,iGAAiG;AACjG,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,eAAe,CAYjF;AAED,8FAA8F;AAC9F,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAe7E;AAED,uHAAuH;AACvH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAM7F;AAED,iGAAiG;AACjG,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGrH;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAiB9G"}

package/dist/source-map.js

@@ -0,0 +1,74 @@
+/** Build the line index from the raw source (string or the parsed bytes). O(bytes), one pass. */
+export function buildSourceLineIndex(source) {
+    // TextEncoder is a runtime global (browser + Node); reach it via globalThis so this DOM-free
+    // package (lib: ES2022, types: []) typechecks without pulling the DOM lib.
+    const Enc = globalThis.TextEncoder;
+    const bytes = typeof source === 'string' ? new Enc().encode(source) : source;
+    const starts = [0];
+    // A trailing '\n' ends the last line rather than starting an empty new one (editor convention),
+    // so only record a start when bytes follow the newline.
+    for (let i = 0; i < bytes.length; i++) {
+        if (bytes[i] === 0x0a /* \n */ && i + 1 < bytes.length)
+            starts.push(i + 1);
+    }
+    return { lineStarts: Uint32Array.from(starts), byteLength: bytes.length };
+}
+/** 1-based line number containing `byteOffset` (binary search). Clamped to [1, lineCount]. */
+export function lineAtByte(index, byteOffset) {
+    const starts = index.lineStarts;
+    let lo = 0;
+    let hi = starts.length - 1;
+    let ans = 0;
+    while (lo <= hi) {
+        const mid = (lo + hi) >> 1;
+        if (starts[mid] <= byteOffset) {
+            ans = mid;
+            lo = mid + 1;
+        }
+        else {
+            hi = mid - 1;
+        }
+    }
+    return ans + 1; // 1-based
+}
+/** Byte range `[start, end)` of a 1-based `line`; null when out of range. `end` excludes the newline-led next line. */
+export function byteRangeOfLine(index, line) {
+    const starts = index.lineStarts;
+    if (line < 1 || line > starts.length)
+        return null;
+    const start = starts[line - 1];
+    const end = line < starts.length ? starts[line] : index.byteLength;
+    return [start, end];
+}
+/** 1-based source line that produced segment `segIndex`; null when the index is out of range. */
+export function sourceLineOfSegment(srcByte, lineIndex, segIndex) {
+    if (segIndex < 0 || segIndex >= srcByte.length)
+        return null;
+    return lineAtByte(lineIndex, srcByte[segIndex]);
+}
+/**
+ * The segment produced by a 1-based source `line`, or -1 when the line produced no segment (a comment,
+ * a blank line, or a non-motion command). Resolves to the first segment whose source byte falls within
+ * the line's byte range.
+ */
+export function segmentAtSourceLine(sourceIndex, lineIndex, line) {
+    const range = byteRangeOfLine(lineIndex, line);
+    if (range === null)
+        return -1;
+    // Smallest indexed byte >= range start whose byte is < range end.
+    const offsets = sourceIndex.byteOffsets;
+    let lo = 0;
+    let hi = offsets.length;
+    while (lo < hi) {
+        const mid = (lo + hi) >>> 1;
+        if (offsets[mid] < range[0])
+            lo = mid + 1;
+        else
+            hi = mid;
+    }
+    if (lo < offsets.length && offsets[lo] >= range[0] && offsets[lo] < range[1]) {
+        return sourceIndex.segmentIndices[lo];
+    }
+    // The line produced no segment (comment, blank, or a non-motion command) — honestly -1.
+    return -1;
+}

package/dist/time.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Kinematic time axis over the IR (#181) — a per-segment duration model for a time readout and
+ * time-based scrubbing, derived from geometry the IR already carries.
+ *
+ * Each segment's duration is its 3D length divided by its feedrate (`feedrate` is mm/min). This is a
+ * **kinematic estimate**: constant-velocity per segment, NOT acceleration/jerk-aware, so it slightly
+ * *under*estimates real print time. A segment with an unknown feedrate (NaN, before the first `F`)
+ * contributes zero and flags the estimate as approximate — never a fabricated duration. When the
+ * slicer's own estimate is available (`DialectMetadata.printEstimate`, #183), prefer it; this is the
+ * honest fallback and the axis time-scrub always needs.
+ */
+import type { ToolpathIR } from './ir.js';
+export interface ToolpathTime {
+    /** Cumulative END time (ms) of each segment; length = `segments.count`, monotonic non-decreasing. */
+    cumulativeMs: Float64Array;
+    /** Total kinematic duration (ms). */
+    totalMs: number;
+    /**
+     * True if any moving segment had an unknown feedrate (contributed 0). The estimate is then a lower
+     * bound / approximate — a consumer should disclose it (and prefer the slicer estimate when present).
+     */
+    hasUnknownFeedrate: boolean;
+}
+/** Build the cumulative kinematic time axis for `ir`. O(segments), no allocation beyond the axis. */
+export declare function computeToolpathTime(ir: ToolpathIR): ToolpathTime;
+/**
+ * The number of segments completed at time `ms` — i.e. the count of segments whose cumulative END
+ * time is ≤ `ms` (binary search). 0 before the first segment finishes; `count` at/after the end. This
+ * is exactly a scrub cut position (segments `[0, result)` are done), so it maps straight to a
+ * segment-index scrub.
+ */
+export declare function segmentsCompletedAtTime(cumulativeMs: Float64Array, ms: number): number;
+//# sourceMappingURL=time.d.ts.map

package/dist/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B,qGAAqG;IACrG,YAAY,EAAE,YAAY,CAAC;IAC3B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,qGAAqG;AACrG,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,UAAU,GAAG,YAAY,CAoBhE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAStF"}

package/dist/time.js

@@ -0,0 +1,41 @@
+/** Build the cumulative kinematic time axis for `ir`. O(segments), no allocation beyond the axis. */
+export function computeToolpathTime(ir) {
+    const seg = ir.segments;
+    const n = seg.count;
+    const cumulativeMs = new Float64Array(n);
+    let t = 0;
+    let hasUnknownFeedrate = false;
+    for (let i = 0; i < n; i++) {
+        const dx = seg.x1[i] - seg.x0[i];
+        const dy = seg.y1[i] - seg.y0[i];
+        const dz = seg.z1[i] - seg.z0[i];
+        const dist = Math.hypot(dx, dy, dz);
+        const f = seg.feedrate[i]; // mm/min
+        if (Number.isFinite(f) && f > 0) {
+            t += dist / (f / 60000); // mm ÷ (mm/ms) = ms
+        }
+        else if (dist > 0) {
+            hasUnknownFeedrate = true;
+        }
+        cumulativeMs[i] = t;
+    }
+    return { cumulativeMs, totalMs: t, hasUnknownFeedrate };
+}
+/**
+ * The number of segments completed at time `ms` — i.e. the count of segments whose cumulative END
+ * time is ≤ `ms` (binary search). 0 before the first segment finishes; `count` at/after the end. This
+ * is exactly a scrub cut position (segments `[0, result)` are done), so it maps straight to a
+ * segment-index scrub.
+ */
+export function segmentsCompletedAtTime(cumulativeMs, ms) {
+    let lo = 0;
+    let hi = cumulativeMs.length;
+    while (lo < hi) {
+        const mid = (lo + hi) >>> 1;
+        if (cumulativeMs[mid] <= ms)
+            lo = mid + 1;
+        else
+            hi = mid;
+    }
+    return lo;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chestnutlabs/toolpath-core",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Neutral ToolpathIR and capability model for the Chestnut Labs G-code Preview toolpath stack.",
   "keywords": [
     "gcode",