@chestnutlabs/gcode-dialects 0.3.0 → 0.5.0

package/dist/cnc.d.ts

@@ -0,0 +1,10 @@
+import type { DialectAdapter } from './contracts.js';
+export type ValidationTier = 'validated' | 'experimental';
+export type MachineClass = 'laser' | 'mill' | 'plotter';
+/** GRBL diode/CO₂ laser (LightBurn and GRBL-laser post-processors). */
+export declare function grblLaser(): DialectAdapter;
+/** GRBL CNC milling (constant-power spindle). */
+export declare function grblMill(): DialectAdapter;
+/** LinuxCNC / EMC milling. */
+export declare function linuxCnc(): DialectAdapter;
+//# sourceMappingURL=cnc.d.ts.map

package/dist/cnc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cnc.d.ts","sourceRoot":"","sources":["../src/cnc.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAA+B,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAElF,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,cAAc,CAAC;AAC1D,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAoGxD,uEAAuE;AACvE,wBAAgB,SAAS,IAAI,cAAc,CAyB1C;AAED,iDAAiD;AACjD,wBAAgB,QAAQ,IAAI,cAAc,CAoBzC;AAED,8BAA8B;AAC9B,wBAAgB,QAAQ,IAAI,cAAc,CAsBzC"}

package/dist/cnc.js

@@ -0,0 +1,142 @@
+/** Non-extrusion capability claims whose confidence the validation tier governs (DD-012 D6). */
+const NON_EXTRUSION_CAPS = ['cutMoves', 'toolPower', 'cannedCycles'];
+function scoreEvidence(head) {
+    // Strip line comments (';…' and LinuxCNC/RS274 '(…)') so words inside them never score as markers.
+    const code = head
+        .split('\n')
+        .map((l) => l.split(';')[0].replace(/\([^)]*\)/g, ''))
+        .join('\n');
+    const has = (re) => re.test(code);
+    // G-code words run together without spaces (`G1M3`, `g1z-.1`), so a LEADING word-boundary fails.
+    // Match the command by its number + a trailing NON-digit lookahead: `M0*3(?!\d)` matches `M3`/`M03`
+    // (incl. mid-line `s3400 m3` and concatenated `G1M3`) but not `M30`/`M300`.
+    return {
+        // Extrusion = an `E` value on a G0–G3 MOTION line — NOT bare `E` (LinuxCNC laser uses `M67 E0 Q…`
+        // for analog power, which must not be mistaken for FDM extrusion).
+        extrusion: has(/G0*[0-3](?!\d)[^\n;]*E-?[.\d]/i) || has(/M8[23](?!\d)/i),
+        m3: has(/M0*3(?!\d)/i),
+        m4: has(/M0*4(?!\d)/i),
+        power: has(/S\d/i),
+        plunge: has(/Z\s*-\s*[.\d]/i), // negative Z incl. leading-dot decimals (`Z-.1`)
+        lightBurn: /LightBurn/i.test(head), // header-only marker; keep the raw head (comments allowed)
+        laserMode: /\$32\s*=\s*1/.test(code),
+        linuxCnc: /\b(?:LinuxCNC|EMC2?)\b/i.test(head),
+        grblBanner: /\bGrbl\s*[0-9]/i.test(head),
+        oWord: has(/[oO][\s<]*\w*\s*(?:sub|call|if|while|do|repeat|return|endsub)\b/im)
+    };
+}
+function makeCncDialect(spec) {
+    return {
+        id: spec.id,
+        displayName: spec.displayName,
+        kind: 'firmware',
+        detect(input) {
+            const hit = spec.detect(input);
+            return hit === null
+                ? null
+                : { dialectId: spec.id, kind: 'firmware', confidence: hit.confidence, evidence: hit.evidence };
+        },
+        finalize(ir, sink) {
+            sink.setRaw('cnc.controller', spec.id);
+            sink.setRaw('cnc.machineClass', spec.machineClass);
+            sink.setRaw('cnc.validationTier', spec.tier);
+            sink.setRaw('cnc.toolPowerLabel', spec.toolPowerLabel);
+            // Validation tier (DD-012 D6): until hardware-validated, non-extrusion claims are `inferred`,
+            // never `known`. Only downgrade claims the file actually made (present as 'known') — never
+            // fabricate a claim for a feature the file did not use.
+            if (spec.tier === 'experimental') {
+                let downgraded = false;
+                for (const cap of NON_EXTRUSION_CAPS) {
+                    if (ir.header.capabilities[cap] === 'known') {
+                        sink.upgradeCapability(cap, 'inferred');
+                        downgraded = true;
+                    }
+                }
+                if (downgraded) {
+                    sink.warn('cnc-dialect-experimental', `${spec.displayName} support is EXPERIMENTAL (spec-derived, not yet hardware-validated); ` +
+                        `non-extrusion classification is reported as 'inferred'.`);
+                }
+            }
+        }
+    };
+}
+/** GRBL diode/CO₂ laser (LightBurn and GRBL-laser post-processors). */
+export function grblLaser() {
+    return makeCncDialect({
+        id: 'grbl-laser',
+        displayName: 'GRBL laser (LightBurn)',
+        machineClass: 'laser',
+        toolPowerLabel: 'laser power (S)',
+        // Hardware-validated 2026-07-29 (DD-012 D8; see docs/design/DD-012-hardware-validation-log.md):
+        // a real GRBL/LightBurn laser run — 6161 moves incl. fill + offset-fill, full 0–1000 S power ramp —
+        // confirmed machine-class detection, Cut-vs-rapid classification, and the toolPower channel against
+        // the physical cut. Claims report `known`, not `inferred`. (Mill/LinuxCNC remain experimental.)
+        tier: 'validated',
+        detect(input) {
+            const e = scoreEvidence(input.headText);
+            if (e.extrusion || e.linuxCnc)
+                return null;
+            if (e.lightBurn)
+                return { evidence: 'LightBurn header', confidence: 'known' };
+            if (e.laserMode)
+                return { evidence: 'GRBL $32=1 (laser mode)', confidence: 'inferred' };
+            // No-header GRBL laser (the common LaserGRBL case): a tool-on command with power, and NO Z
+            // plunging — lasers are planar; a mill would cut down into Z. Works whether the file uses M3
+            // (constant power) or M4 (dynamic).
+            if ((e.m3 || e.m4) && e.power && !e.plunge) {
+                return { evidence: `${e.m4 ? 'M4 dynamic' : 'M3'} + S power, planar (no Z plunge)`, confidence: 'inferred' };
+            }
+            return null;
+        }
+    });
+}
+/** GRBL CNC milling (constant-power spindle). */
+export function grblMill() {
+    return makeCncDialect({
+        id: 'grbl-mill',
+        displayName: 'GRBL mill',
+        machineClass: 'mill',
+        toolPowerLabel: 'spindle RPM (S)',
+        tier: 'experimental', // → 'validated' after a real GRBL-mill run (DD-012 §8)
+        detect(input) {
+            const e = scoreEvidence(input.headText);
+            if (e.extrusion || e.lightBurn || e.laserMode || e.linuxCnc)
+                return null;
+            // A spindle (M3) that plunges into the material (negative Z) with no extrusion — a milling
+            // fingerprint that distinguishes it from a planar laser. GRBL/family-level, so a banner is a
+            // stronger signal but not required (most CAM output has no banner).
+            if (e.m3 && e.plunge) {
+                const ev = e.grblBanner ? 'Grbl banner + M3 + Z-plunge' : 'M3 spindle + Z-plunge, no extrusion';
+                return { evidence: ev, confidence: 'inferred' };
+            }
+            return null;
+        }
+    });
+}
+/** LinuxCNC / EMC milling. */
+export function linuxCnc() {
+    return makeCncDialect({
+        id: 'linuxcnc',
+        displayName: 'LinuxCNC mill',
+        machineClass: 'mill',
+        toolPowerLabel: 'spindle RPM (S)',
+        tier: 'experimental', // → 'validated' after a real LinuxCNC run (DD-012 §8)
+        detect(input) {
+            const e = scoreEvidence(input.headText);
+            if (e.extrusion)
+                return null;
+            if (e.linuxCnc)
+                return { evidence: 'LinuxCNC/EMC header', confidence: 'known' };
+            // RS274NGC O-word subroutines / flow control (`O100 sub`, `o<name> call`) are the LinuxCNC
+            // family's distinguishing dialect feature — GRBL/TinyG do not have them.
+            if (e.oWord)
+                return { evidence: 'RS274NGC O-word subroutine/flow', confidence: 'inferred' };
+            // A `%` program envelope with a spindle and no extrusion (also common in Fanuc-style output;
+            // reported family-level, not as a specific controller).
+            if (/^\s*%/m.test(input.headText) && e.m3) {
+                return { evidence: '%-program envelope + M3 spindle, no extrusion', confidence: 'inferred' };
+            }
+            return null;
+        }
+    });
+}

package/dist/index.d.ts

@@ -15,6 +15,8 @@ export { prusaSlicer } from './prusaslicer.js';
 export { orcaBambu } from './orca-bambu.js';
 export { cura } from './cura.js';
 export { klipper, marlin, repRap } from './firmware.js';
+export { grblLaser, grblMill, linuxCnc } from './cnc.js';
+export type { ValidationTier, MachineClass } from './cnc.js';
 export { segAtOrAfterByte, applyMarkerRanges, parseKeyValue, parseAreaPoints, bedFromPoints, decodeBase64, ThumbnailCollector } from './annotate.js';
 export type { RangeMarker } from './annotate.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,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAChG,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACzG,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,aAAa,EACb,YAAY,EACZ,kBAAkB,EACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAChG,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACzG,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,aAAa,EACb,YAAY,EACZ,kBAAkB,EACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -4,4 +4,5 @@ export { prusaSlicer } from './prusaslicer.js';
 export { orcaBambu } from './orca-bambu.js';
 export { cura } from './cura.js';
 export { klipper, marlin, repRap } from './firmware.js';
+export { grblLaser, grblMill, linuxCnc } from './cnc.js';
 export { segAtOrAfterByte, applyMarkerRanges, parseKeyValue, parseAreaPoints, bedFromPoints, decodeBase64, ThumbnailCollector } from './annotate.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chestnutlabs/gcode-dialects",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Slicer/firmware dialect adapters for ToolpathIR annotation (DD-005). Adapters annotate metadata and optional channels — they can never alter geometry.",
   "keywords": [
     "gcode",
@@ -45,6 +45,6 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@chestnutlabs/toolpath-core": "0.3.0"
+    "@chestnutlabs/toolpath-core": "0.5.0"
   }
 }