@richardmcquiston01/gcode 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Richard McQuiston
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,26 @@
-# Temporary Holding Version
+# @richardmcquiston01/gcode
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+G-code generation and parsing for laser, CNC and other maker machines: convert vector paths or raster images to G-code, and parse G-code back into moves with bounds.
+
+Part of [maker-image-tools](https://github.com/RichardMcQuiston01/maker-image-tools).
+
+## Install
+
+```sh
+npm i @richardmcquiston01/gcode
+```
+
+## Usage
+
+```ts
+import { computeGcodeBounds, parseGcode, pathsToGcode } from "@richardmcquiston01/gcode";
+
+const gcode: string = pathsToGcode(paths);
+const bounds = computeGcodeBounds(parseGcode(gcode));
+```
+
+ESM only.
+
+## License
+
+MIT

package/dist/generate.d.ts

@@ -0,0 +1,36 @@
+import type { VectorPath } from "@richardmcquiston01/core-vector";
+export interface GcodeGenerationOptions {
+    /** mm/min feed rate for cutting/engraving moves. Default 1000. */
+    feedRate?: number;
+    /** Reserved for future rapid-move tuning; G0 moves carry no F word today. */
+    travelFeedRate?: number;
+    /** Laser S value (0-1000) used for M4. Default 1000. */
+    power?: number;
+    /** Number of times to repeat each path before moving to the next. Default 1. */
+    passes?: number;
+    /** Tolerance passed to flattenPath when converting curves to line segments. Default 0.1. */
+    flattenTolerance?: number;
+    /** Added to every emitted X coordinate. Default 0. */
+    originX?: number;
+    /** Added to every emitted Y coordinate. Default 0. */
+    originY?: number;
+}
+export interface RasterGcodeOptions {
+    /** mm/min feed rate for engraving moves. Default 1000. */
+    feedRate?: number;
+    /** Laser S value at full black (darkest pixel). Default 1000. */
+    maxPower?: number;
+    /** Laser S value at full white that still fires. Default 0. */
+    minPower?: number;
+    /** Physical size of one pixel, in mm. Default 0.1. */
+    pixelSizeMm?: number;
+    /** Added to every emitted X coordinate. Default 0. */
+    originX?: number;
+    /** Added to every emitted Y coordinate. Default 0. */
+    originY?: number;
+    /** Grayscale value (0-255) at or above which a pixel is skipped entirely. Default 250. */
+    whiteThreshold?: number;
+}
+export declare function pathsToGcode(paths: VectorPath[], options?: GcodeGenerationOptions): string;
+export declare function rasterToGcode(image: ImageData, options?: RasterGcodeOptions): string;
+//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAGlE,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0FAA0F;IAC1F,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAaD,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,OAAO,GAAE,sBAA2B,GAAG,MAAM,CAoC9F;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAqFxF"}

package/dist/generate.js

@@ -0,0 +1,117 @@
+import { flattenPath } from "@richardmcquiston01/core-vector";
+const PREAMBLE = ["; Generated by maker-image-tools", "G21", "G90"];
+const POSTAMBLE = ["G0 X0 Y0", "M5"];
+/** Rounds to 3 decimal places and strips trailing zeros / a trailing decimal point. */
+function formatCoord(n) {
+    let rounded = Math.round(n * 1000) / 1000;
+    if (rounded === 0)
+        rounded = 0; // normalize -0 to 0
+    const fixed = rounded.toFixed(3);
+    return fixed.replace(/\.?0+$/, "") || "0";
+}
+export function pathsToGcode(paths, options = {}) {
+    const feedRate = options.feedRate ?? 1000;
+    const power = Math.round(options.power ?? 1000);
+    const passes = options.passes ?? 1;
+    const flattenTolerance = options.flattenTolerance ?? 0.1;
+    const originX = options.originX ?? 0;
+    const originY = options.originY ?? 0;
+    const lines = [...PREAMBLE];
+    for (const path of paths) {
+        const points = flattenPath(path, flattenTolerance);
+        if (points.length < 2)
+            continue;
+        for (let pass = 0; pass < passes; pass++) {
+            const first = points[0];
+            lines.push(`G0 X${formatCoord(first.x + originX)} Y${formatCoord(first.y + originY)}`);
+            lines.push(`M4 S${power}`);
+            // F is modal in real G-code, so it's only emitted on this first G1 of the path-pass.
+            const second = points[1];
+            lines.push(`G1 X${formatCoord(second.x + originX)} Y${formatCoord(second.y + originY)} F${formatCoord(feedRate)}`);
+            for (let i = 2; i < points.length; i++) {
+                const p = points[i];
+                lines.push(`G1 X${formatCoord(p.x + originX)} Y${formatCoord(p.y + originY)}`);
+            }
+            lines.push("M5");
+        }
+    }
+    lines.push(...POSTAMBLE);
+    return lines.join("\n") + "\n";
+}
+export function rasterToGcode(image, options = {}) {
+    const feedRate = options.feedRate ?? 1000;
+    const maxPower = options.maxPower ?? 1000;
+    const minPower = options.minPower ?? 0;
+    const pixelSizeMm = options.pixelSizeMm ?? 0.1;
+    const originX = options.originX ?? 0;
+    const originY = options.originY ?? 0;
+    const whiteThreshold = options.whiteThreshold ?? 250;
+    const lines = [...PREAMBLE];
+    const { width, height, data } = image;
+    if (width > 0 && height > 0) {
+        let laserOn = false;
+        let currentPower = -1;
+        for (let y = 0; y < height; y++) {
+            // Row 0 (the image's top row) maps to the largest world Y.
+            const worldY = originY + (height - 1 - y) * pixelSizeMm;
+            const leftToRight = y % 2 === 0;
+            const cols = [];
+            if (leftToRight) {
+                for (let x = 0; x < width; x++)
+                    cols.push(x);
+            }
+            else {
+                for (let x = width - 1; x >= 0; x--)
+                    cols.push(x);
+            }
+            const powers = cols.map((x) => {
+                const idx = (y * width + x) * 4;
+                const r = data[idx] ?? 0;
+                const g = data[idx + 1] ?? 0;
+                const b = data[idx + 2] ?? 0;
+                const luma = 0.299 * r + 0.587 * g + 0.114 * b;
+                if (luma >= whiteThreshold)
+                    return 0;
+                const raw = minPower + ((maxPower - minPower) * (255 - luma)) / 255;
+                return Math.round(Math.min(Math.max(raw, minPower), maxPower));
+            });
+            let i = 0;
+            let positioned = false;
+            while (i < cols.length) {
+                const runPower = powers[i];
+                let j = i;
+                while (j < cols.length && powers[j] === runPower)
+                    j++;
+                if (runPower === 0) {
+                    if (j < cols.length) {
+                        const afterCol = cols[j];
+                        const worldX = originX + afterCol * pixelSizeMm;
+                        lines.push(`G0 X${formatCoord(worldX)} Y${formatCoord(worldY)}`);
+                    }
+                }
+                else {
+                    const firstCol = cols[i];
+                    const lastCol = cols[j - 1];
+                    if (!positioned) {
+                        const worldXFirst = originX + firstCol * pixelSizeMm;
+                        lines.push(`G0 X${formatCoord(worldXFirst)} Y${formatCoord(worldY)}`);
+                    }
+                    if (!laserOn || currentPower !== runPower) {
+                        lines.push(`M4 S${runPower}`);
+                        laserOn = true;
+                        currentPower = runPower;
+                    }
+                    const worldXLast = originX + lastCol * pixelSizeMm;
+                    lines.push(`G1 X${formatCoord(worldXLast)} Y${formatCoord(worldY)} F${formatCoord(feedRate)}`);
+                }
+                positioned = true;
+                i = j;
+            }
+            lines.push("M5");
+            laserOn = false;
+        }
+    }
+    lines.push(...POSTAMBLE);
+    return lines.join("\n") + "\n";
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./generate.js";
+export * from "./parse.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./generate.js";
+export * from "./parse.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/parse.d.ts

@@ -0,0 +1,12 @@
+import type { BBox, Point } from "@richardmcquiston01/core-vector";
+export interface GcodeMove {
+    type: "rapid" | "cut";
+    from: Point;
+    to: Point;
+    feedRate?: number;
+    power?: number;
+    laserOn: boolean;
+}
+export declare function parseGcode(gcodeText: string): GcodeMove[];
+export declare function computeGcodeBounds(moves: GcodeMove[]): BBox;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAGnE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;IACtB,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,KAAK,CAAC;IACV,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAyCD,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,CAuDzD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAM3D"}

package/dist/parse.js

@@ -0,0 +1,91 @@
+import { boundingBoxOfPoints } from "@richardmcquiston01/core-vector";
+const WORD_RE = /^([A-Za-z])(-?\d+(?:\.\d+)?)$/;
+/** Strip `;` line comments and `(...)` parenthetical comments, then trim. */
+function stripComments(line) {
+    const withoutSemicolon = line.split(";")[0] ?? "";
+    return withoutSemicolon.replace(/\([^)]*\)/g, "").trim();
+}
+function tokenize(line) {
+    const words = [];
+    for (const token of line.split(/\s+/)) {
+        if (token.length === 0)
+            continue;
+        const match = WORD_RE.exec(token);
+        if (!match)
+            continue;
+        const letter = match[1]?.toUpperCase();
+        const value = Number(match[2]);
+        if (!letter || Number.isNaN(value))
+            continue;
+        words.push({ letter, value });
+    }
+    return words;
+}
+function findWord(words, letter) {
+    return words.find((w) => w.letter === letter);
+}
+function hasGCode(words, code) {
+    return words.some((w) => w.letter === "G" && w.value === code);
+}
+function hasMCode(words, code) {
+    return words.some((w) => w.letter === "M" && w.value === code);
+}
+export function parseGcode(gcodeText) {
+    const moves = [];
+    let currentX = 0;
+    let currentY = 0;
+    let currentFeedRate;
+    let currentPower;
+    let laserOn = false;
+    const lines = gcodeText.split(/\r\n|\n/);
+    for (const rawLine of lines) {
+        const line = stripComments(rawLine);
+        if (line.length === 0)
+            continue;
+        const words = tokenize(line);
+        if (words.length === 0)
+            continue;
+        const fWord = findWord(words, "F");
+        if (fWord)
+            currentFeedRate = fWord.value;
+        const sWord = findWord(words, "S");
+        if (sWord)
+            currentPower = sWord.value;
+        if (hasMCode(words, 3) || hasMCode(words, 4))
+            laserOn = true;
+        if (hasMCode(words, 5))
+            laserOn = false;
+        const isRapid = hasGCode(words, 0);
+        const isCut = hasGCode(words, 1) || hasGCode(words, 2) || hasGCode(words, 3);
+        // G2/G3 (arcs) are best-effort only: treated as a straight chord to the
+        // target X/Y, ignoring I/J/R — real arc interpolation is out of scope.
+        if (!isRapid && !isCut)
+            continue;
+        const xWord = findWord(words, "X");
+        const yWord = findWord(words, "Y");
+        const targetX = xWord ? xWord.value : currentX;
+        const targetY = yWord ? yWord.value : currentY;
+        if (targetX !== currentX || targetY !== currentY) {
+            const move = {
+                type: isRapid ? "rapid" : "cut",
+                from: { x: currentX, y: currentY },
+                to: { x: targetX, y: targetY },
+                laserOn,
+                ...(currentFeedRate !== undefined ? { feedRate: currentFeedRate } : {}),
+                ...(currentPower !== undefined ? { power: currentPower } : {}),
+            };
+            moves.push(move);
+        }
+        currentX = targetX;
+        currentY = targetY;
+    }
+    return moves;
+}
+export function computeGcodeBounds(moves) {
+    const points = [];
+    for (const move of moves) {
+        points.push(move.from, move.to);
+    }
+    return boundingBoxOfPoints(points);
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

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

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "@richardmcquiston01/gcode",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "G-code generation and parsing for laser/CNC/maker machines",
+  "keywords": [
+    "gcode",
+    "g-code",
+    "laser",
+    "cnc",
+    "engraving",
+    "grbl",
+    "maker",
+    "typescript"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/RichardMcQuiston01/maker-image-tools#readme",
+  "bugs": {
+    "url": "https://github.com/RichardMcQuiston01/maker-image-tools/issues"
+  },
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RichardMcQuiston01/maker-image-tools.git",
+    "directory": "packages/gcode"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@richardmcquiston01/core-vector": "0.1.1"
+  },
+  "devDependencies": {
+    "jsdom": "^25.0.1",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.4"
+  }
+}