scad-gltf 0.1.4 → 0.2.2

package/bin/scad-play.js

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { execSync, spawn } from "node:child_process";
+import { getGodotBin } from "../src/godot-utils.js";
+
+function main() {
+  const packedScriptPath = process.argv[2];
+
+  if (!packedScriptPath) {
+    console.error(
+      "❌ Error: Path to the packed Node.js generator script is required.",
+    );
+    console.error(
+      "Usage: node bin/scad-play.js <path_to_generated_project.js>",
+    );
+    process.exit(1);
+  }
+
+  const absScriptPath = path.resolve(process.cwd(), packedScriptPath);
+  if (!fs.existsSync(absScriptPath)) {
+    console.error(`❌ Error: File not found: ${absScriptPath}`);
+    process.exit(1);
+  }
+
+  // 1. Create a unique temporary directory
+  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "scad-play-"));
+  console.log(`📦 Unpacking script to temporary directory...\n   ${tempDir}`);
+
+  let appProcess = null;
+
+  // Ensure cleanup happens on exit
+  const cleanup = () => {
+    if (fs.existsSync(tempDir)) {
+      console.log(`\n🧹 Cleaning up temporary directory...`);
+      try {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+      } catch (e) {
+        console.error(`⚠️ Failed to fully clean up temp dir: ${e.message}`);
+      }
+    }
+  };
+
+  process.on("SIGINT", () => {
+    if (appProcess) appProcess.kill("SIGINT");
+    cleanup();
+    process.exit(0);
+  });
+
+  process.on("SIGTERM", () => {
+    if (appProcess) appProcess.kill("SIGTERM");
+    cleanup();
+    process.exit(0);
+  });
+
+  try {
+    // 2. Execute the packed Node.js script inside the temp directory
+    console.log(
+      `\n⚙️  Running generator script: ${path.basename(absScriptPath)}`,
+    );
+    execSync(`node "${absScriptPath}"`, { cwd: tempDir, stdio: "inherit" });
+
+    // 3. Find the resulting project folder and determine its type
+    let projectDir = null;
+    let projectType = null; // 'godot' | 'web'
+    let latestTime = 0;
+
+    const items = fs.readdirSync(tempDir);
+    for (const item of items) {
+      const itemPath = path.join(tempDir, item);
+      if (fs.statSync(itemPath).isDirectory()) {
+        const isGodot = fs.existsSync(path.join(itemPath, "project.godot"));
+        const isWeb = fs.existsSync(path.join(itemPath, "package.json"));
+        const isBevy = fs.existsSync(path.join(itemPath, "Cargo.toml"));
+
+        if (isGodot || isWeb || isBevy) {
+          const mtime = fs.statSync(itemPath).mtimeMs;
+          if (mtime > latestTime) {
+            latestTime = mtime;
+            projectDir = itemPath;
+            projectType = isGodot ? "godot" : isBevy ? "bevy" : "web";
+          }
+        }
+      }
+    }
+
+    if (!projectDir || !projectType) {
+      console.error("\n❌ Error: Could not find a valid generated project.");
+      console.error(
+        "The script did not produce a folder containing 'project.godot' or 'package.json'.",
+      );
+      cleanup();
+      process.exit(1);
+    }
+
+    console.log(
+      `\n✔️  Found generated ${projectType.toUpperCase()} project: ${path.basename(projectDir)}`,
+    );
+
+    // 4. Boot the corresponding environment
+    if (projectType === "godot") {
+      const godotBin = getGodotBin();
+
+      console.log(`\n⚙️  Importing Godot assets (this may take a moment)...`);
+      try {
+        // Force Godot to build the .godot/imported cache before attempting to run the game
+        execSync(`"${godotBin}" --headless --editor --quit`, {
+          cwd: projectDir,
+          stdio: "inherit",
+        });
+      } catch (e) {
+        console.log(
+          "⚠️ Asset import finished with non-zero exit code (continuing...)",
+        );
+      }
+
+      console.log(`\n🎮 Launching Godot Engine...`);
+      appProcess = spawn(godotBin, ["--path", projectDir], {
+        stdio: "inherit",
+      });
+    } else if (projectType === "web") {
+      console.log(
+        `\n🌐 Installing NPM dependencies (this may take a moment)...`,
+      );
+      try {
+        execSync("npm install", { cwd: projectDir, stdio: "inherit" });
+      } catch (e) {
+        console.log(
+          "⚠️ npm install failed or showed errors, attempting to continue anyway...",
+        );
+      }
+
+      console.log(`\n🌐 Starting Vite dev server...`);
+      const npmCmd = process.platform === "win32" ? "npm.cmd" : "npm";
+
+      appProcess = spawn(npmCmd, ["run", "dev"], {
+        cwd: projectDir,
+        stdio: "inherit",
+      });
+    } else if (projectType === "bevy") {
+      console.log(
+        `\n🦀 Compiling and starting Rust Bevy game (this may take a moment)...`,
+      );
+      const cargoCmd = process.platform === "win32" ? "cargo.exe" : "cargo";
+      appProcess = spawn(cargoCmd, ["run"], {
+        cwd: projectDir,
+        stdio: "inherit",
+      });
+    }
+
+    // 5. Handle lifecycle events
+    appProcess.on("close", (code) => {
+      console.log(`\n🏁 Process exited with code ${code}.`);
+      cleanup();
+      process.exit(code || 0);
+    });
+
+    appProcess.on("error", (err) => {
+      console.error(`\n❌ Failed to start the application: ${err.message}`);
+      cleanup();
+      process.exit(1);
+    });
+  } catch (err) {
+    console.error(`\n❌ An error occurred during execution:\n`, err.message);
+    cleanup();
+    process.exit(1);
+  }
+}
+
+main();

package/bin/scad-web.js

@@ -1,141 +1,17 @@
 #!/usr/bin/env node
 
-import fs from "node:fs";
-import path from "node:path";
-import url from "node:url";
-import readline from "node:readline";
-
-// Safely resolve symlinks to find the actual package directory
-const __filename = fs.realpathSync(url.fileURLToPath(import.meta.url));
-const __dirname = path.dirname(__filename);
-const DIR = path.resolve(__dirname, "..");
-
-// Safely detect if actual data is being piped into the script via STDIN
-function hasStdinData() {
-  try {
-    const stat = fs.fstatSync(0); // 0 is the file descriptor for STDIN
-    // isFIFO means piped (echo "foo" | script)
-    // isFile means redirected (script < foo.txt)
-    return stat.isFIFO() || stat.isFile();
-  } catch (e) {
-    return false;
-  }
-}
-
-// Writes text to system clipboard
-async function writeToClipboard(text) {
-  const clipboardy = (await import("clipboardy")).default;
-  await clipboardy.write(text);
-}
-
-function waitForEnter(message) {
-  return new Promise((resolve) => {
-    // If standard input was piped/redirected, we need to bypass it and read from the actual terminal
-    if (!process.stdin.isTTY) {
-      try {
-        const tty = process.platform === "win32" ? "CONIN$" : "/dev/tty";
-        const fd = fs.openSync(tty, "rs");
-        process.stdout.write(message);
-        const buf = Buffer.alloc(1);
-        fs.readSync(fd, buf, 0, 1, null);
-        fs.closeSync(fd);
-        console.log();
-        resolve();
-        return;
-      } catch (e) {
-        console.log(
-          message +
-            " (Auto-continuing due to non-interactive terminal environment)",
-        );
-        resolve();
-        return;
-      }
-    }
-
-    // For standard TTY terminals
-    const rl = readline.createInterface({
-      input: process.stdin,
-      output: process.stdout,
-    });
-    rl.question(message, () => {
-      rl.close();
-      resolve();
-    });
-  });
-}
+import { runCliApp } from "../src/cli-utils.js";
 
 async function main() {
-  let task = "";
-  let optionsStr = "{}";
-
-  // 1. Read TASK and OPTIONS
-  if (hasStdinData()) {
-    try {
-      task = fs.readFileSync(0, "utf-8").trim();
-    } catch (e) {
-      console.error("Error reading from STDIN:", e);
-    }
-    if (process.argv[2]) optionsStr = process.argv[2];
-  } else {
-    if (process.argv[2]) task = process.argv[2];
-    if (process.argv[3]) optionsStr = process.argv[3];
-  }
-
-  if (!task) {
-    console.error("Error: Task parameter is required.");
-    console.error(
-      'Usage: scad-web "<description of the web app to generate>" [options_json]',
-    );
-    console.error('   or: echo "<description>" | scad-web [options_json]');
-    console.error("");
-    console.error("Example with JSON options:");
-    console.error(
-      '  scad-web "3D Car Configurator Web App" \'{"animation": false}\'',
-    );
-    process.exit(1);
-  }
-
-  // 2. Parse Options JSON
-  let options = {};
-  if (optionsStr) {
-    try {
-      options = JSON.parse(optionsStr);
-    } catch (e) {
-      console.error(`Invalid JSON options: ${optionsStr}`);
-      process.exit(1);
-    }
-  }
-
-  // Disable the modelName instructions specifically for this wrapper context
-  options.modelName = false;
-
-  // 3. Dynamically import and generate prompt rules from src/prompt.js
-  let generatePrompt;
-  try {
-    const promptJsPath = path.join(DIR, "src", "prompt.js");
-    const promptModuleUrl = url.pathToFileURL(promptJsPath).href;
-    const m = await import(promptModuleUrl);
-    generatePrompt = m.generatePrompt;
-  } catch (e) {
-    console.error(`Error loading ${path.join("src", "prompt.js")}:`, e);
-    process.exit(1);
-  }
-
-  let promptRules = "";
-  try {
-    promptRules = generatePrompt("the 3D assets for the web app", options);
-  } catch (e) {
-    console.error("Error generating prompt rules from prompt.js:");
-    console.error(e);
-    process.exit(1);
-  }
-
-  // 4. Construct the Main Web Prompt System Text (System Instructions)
-  const systemPrompt = `You are an expert Web 3D developer and procedural 3D technical artist.
+  await runCliApp({
+    projectType: "web",
+    buildSystemPrompt: (
+      promptRules,
+    ) => `You are an expert Web 3D developer and procedural 3D technical artist.
 
 What to generate:
 1. 3D Web Assets (.scad):
-   - Generate procedural 3D models for the web app using OpenSCAD.
+   - Generate procedural 3D models for the game using OpenSCAD.
    - CRITICAL: The SCAD to glTF converter automatically converts OpenSCAD's Z-up coordinate system to the standard glTF Y-up coordinate system. Design your models naturally in OpenSCAD.
    - CRITICAL: You must use the custom OpenSCAD glTF extensions for PBR materials (e.g., \`roughness\`, \`metalness\`, \`emissive\`) and Hierarchical Node Animations (\`armature()\`, \`bone()\`). The rules and syntax for these features are provided below:
 
@@ -145,14 +21,14 @@ ${promptRules}
 
 2. Vite Web Project Files (npm based):
    - Create the necessary files for a modern web application (e.g., \`package.json\`, \`index.html\`, \`main.js\`).
-   - You can use ANY web 3D library with glTF support (e.g., Three.js, Babylon.js, @google/model-viewer, PlayCanvas, A-Frame, etc.) that fits the app's requirements.
+   - You can use ANY web 3D library with glTF support (e.g., Three.js, Babylon.js, @google/model-viewer, PlayCanvas, A-Frame, etc.) that fits the game's requirements.
    - In \`package.json\`, you MUST include the scad to gltf converter tool as a dev dependency:
      \`"scad-gltf": "^0.1.0"\`
    - In \`package.json\`, add npm scripts to automatically compile the \`.scad\` files into \`.glb\` format inside the \`public/\` folder before Vite runs its dev or build steps.
      For example:
      \`"predev": "scad-convert ./scad ./public/models --cache"\`
      \`"prebuild": "scad-convert ./scad ./public/models --cache"\`
-   - Write the core application logic to load and display the converted \`.glb\` files interactively.
+   - Write the core game logic to load and display the converted \`.glb\` files interactively.
 
 3. Delivery Format (Single Node.js Script):
    - Output exactly ONE self-contained Node.js script. Do not output manual setup instructions.
@@ -161,39 +37,11 @@ ${promptRules}
    - The script must embed and write:
      - Your generated \`.scad\` 3D assets.
      - Your generated Vite web project files.
-   - Ensure all string file contents inside the Node.js script are properly escaped.`;
-
-  // 5. Format the input request output
-  const inputRequestOutput = `Design and implement a web-based 3D glTF app using Vite for the following concept: "${task}"`;
-
-  // 6. Write to System Clipboard (Part 1: System Instructions)
-  try {
-    await writeToClipboard(systemPrompt);
-    console.log("✔️  System instructions have been copied to the clipboard.");
-  } catch (err) {
-    console.error(
-      "Error: Failed to copy system instructions to the clipboard.",
-    );
-    console.error(err.message);
-    process.exit(1);
-  }
-
-  // 7. Await user confirmation
-  await waitForEnter(
-    "Please paste the system instructions into your LLM, then press ENTER to copy your input request...",
-  );
-
-  // 8. Write to System Clipboard (Part 2: Input Request)
-  try {
-    await writeToClipboard(inputRequestOutput);
-    console.log(
-      "✔️  Input request has been copied to the clipboard. You can now paste it into your LLM.",
-    );
-  } catch (err) {
-    console.error("Error: Failed to copy input request to the clipboard.");
-    console.error(err.message);
-    process.exit(1);
-  }
+   - Ensure all string file contents inside the Node.js script are properly escaped.`,
+    buildInputRequest: (task) =>
+      `Design and implement a web-based 3D glTF game using Vite for the following concept: "${task}"`,
+    allowedTools: ["render_scad_model"],
+  });
 }
 
 // Execute and handle unhandled runtime errors

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scad-gltf",
-  "version": "0.1.4",
+  "version": "0.2.2",
   "description": "WASM build of a custom OpenSCAD fork that compiles .scad scripts directly to glTF/GLB with PBR and animation support",
   "type": "module",
   "main": "./src/ext/openscad.js",
@@ -22,6 +22,7 @@
     "3d",
     "cad",
     "godot",
+    "bevy",
     "mcp",
     "ai"
   ],
@@ -29,6 +30,7 @@
     "bin",
     "src",
     "godot",
+    "bevy",
     "editor/dist"
   ],
   "bin": {
@@ -36,7 +38,10 @@
     "scad-serve": "./bin/scad-serve.js",
     "scad-mcp": "./bin/scad-mcp.js",
     "scad-godot": "./bin/scad-godot.js",
-    "scad-web": "./bin/scad-web.js"
+    "scad-web": "./bin/scad-web.js",
+    "scad-bevy": "./bin/scad-bevy.js",
+    "scad-gen": "./bin/scad-gen.js",
+    "scad-play": "./bin/scad-play.js"
   },
   "exports": {
     ".": "./src/ext/openscad.js",