scad-gltf 0.3.2 → 0.3.3

package/bin/gen.js

@@ -3,7 +3,7 @@
 import { runCliApp } from "../src/cli-utils.js";
 import { getProjectPrompts } from "../src/project-prompts.js";
 
-const VALID_TYPES = ["scad", "bevy", "web", "godot"];
+const VALID_TYPES = ["scad", "bevy", "wgpu", "web", "godot"];
 
 async function main() {
   const projectType = process.argv[2];
@@ -14,7 +14,7 @@ async function main() {
       `Usage: scad-gltf gen <${VALID_TYPES.join("|")}> "<description>" [options_json]`,
     );
     console.error(
-      `Example: scad-gltf gen godot "A 3D racing game" '{"openaiModel": "gpt-4o"}'`,
+      `Example: scad-gltf gen godot "A 3D physics simulation" '{"openaiModel": "gpt-4o"}'`,
     );
     process.exit(1);
   }

package/bin/mcp.js

@@ -201,7 +201,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       {
         name: "test_godot_project",
         description:
-          "Runs a specified Godot project for a short duration to detect script errors, missing resources, or runtime crashes. Returns the console output logs and a visual screenshot of the gameplay.",
+          "Runs a specified Godot project for a short duration to detect script errors, missing resources, or runtime crashes. Returns the console output logs and a visual screenshot of the running project.",
         inputSchema: {
           type: "object",
           properties: {
@@ -793,7 +793,7 @@ func _ready():
         }
         fs.writeFileSync(projectGodotPath, tempProjectGodot, "utf8");
 
-        // 2. Play Game Step
+        // 2. Run Project Step
         // Always try windowed first to get the screenshot.
         // If the environment lacks a display server, we'll catch the error and fallback.
         let playArgs = [

package/bin/play.js

@@ -62,7 +62,7 @@ function main() {
 
     // 3. Find the resulting project folder and determine its type
     let projectDir = null;
-    let projectType = null; // 'godot' | 'web' | 'bevy'
+    let projectType = null; // 'godot' | 'web' | 'rust'
     let latestTime = 0;
 
     const items = fs.readdirSync(tempDir);
@@ -71,14 +71,14 @@ function main() {
       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"));
+        const isRust = fs.existsSync(path.join(itemPath, "Cargo.toml"));
 
-        if (isGodot || isWeb || isBevy) {
+        if (isGodot || isWeb || isRust) {
           const mtime = fs.statSync(itemPath).mtimeMs;
           if (mtime > latestTime) {
             latestTime = mtime;
             projectDir = itemPath;
-            projectType = isGodot ? "godot" : isBevy ? "bevy" : "web";
+            projectType = isGodot ? "godot" : isRust ? "rust" : "web";
           }
         }
       }
@@ -87,7 +87,7 @@ function main() {
     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'.",
+        "The script did not produce a folder containing 'project.godot', 'package.json', or 'Cargo.toml'.",
       );
       cleanup();
       process.exit(1);
@@ -103,7 +103,7 @@ function main() {
 
       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
+        // Force Godot to build the .godot/imported cache before attempting to run the project
         execSync(`"${godotBin}" --headless --editor --quit`, {
           cwd: projectDir,
           stdio: "inherit",
@@ -137,9 +137,9 @@ function main() {
         cwd: projectDir,
         stdio: "inherit",
       });
-    } else if (projectType === "bevy") {
+    } else if (projectType === "rust") {
       console.log(
-        `\n🦀 Compiling and starting Rust Bevy game (this may take a moment)...`,
+        `\n🦀 Compiling and starting Rust project (this may take a moment)...`,
       );
       const cargoCmd = process.platform === "win32" ? "cargo.exe" : "cargo";
       appProcess = spawn(cargoCmd, ["run"], {

package/bin/scad-gltf.js

@@ -17,7 +17,7 @@ if (!command || !commands[command]) {
   console.error("  serve     Start local API server and Web Editor");
   console.error("  mcp       Start the Model Context Protocol (MCP) server");
   console.error(
-    "  gen       Automated AI generation of 3D models and game projects",
+    "  gen       Automated AI generation of 3D models, simulations, and interactive projects",
   );
   console.error("  play      Test and launch generated Node.js scripts");
   process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scad-gltf",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "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",

package/src/cli-utils.js

@@ -495,8 +495,11 @@ export async function runAutomatedAIFlow(
               const isBevy =
                 projectType === "bevy" &&
                 fs.existsSync(path.join(itemPath, "Cargo.toml"));
+              const isWgpu =
+                projectType === "wgpu" &&
+                fs.existsSync(path.join(itemPath, "Cargo.toml"));
 
-              if (isGodot || isWeb || isBevy) {
+              if (isGodot || isWeb || isBevy || isWgpu) {
                 const mtime = fs.statSync(itemPath).mtimeMs;
                 if (mtime > latestTime) {
                   latestTime = mtime;
@@ -511,7 +514,7 @@ export async function runAutomatedAIFlow(
             const expectedFile =
               projectType === "godot"
                 ? "project.godot"
-                : projectType === "bevy"
+                : projectType === "bevy" || projectType === "wgpu"
                   ? "Cargo.toml"
                   : "package.json";
             messages.push({
@@ -554,9 +557,10 @@ export async function runAutomatedAIFlow(
             });
 
             await new Promise((resolve) => setTimeout(resolve, 2000));
-          } else if (projectType === "bevy") {
+          } else if (projectType === "bevy" || projectType === "wgpu") {
+            const fwName = projectType === "bevy" ? "Bevy" : "wgpu";
             console.log(
-              `\n🦀 Building and running Bevy project: ${path.basename(projectDir)}...`,
+              `\n🦀 Building and running ${fwName} project: ${path.basename(projectDir)}...`,
             );
             const cargoCmd =
               process.platform === "win32" ? "cargo.exe" : "cargo";
@@ -670,7 +674,7 @@ export async function runCliApp({
       );
     } else {
       console.error(
-        `  scad-gltf gen ${projectType} "A simple 3D game" '{"openaiApiKey": "sk-...", "openaiModel": "gpt-4o"}'`,
+        `  scad-gltf gen ${projectType} "A simple 3D simulation" '{"openaiApiKey": "sk-...", "openaiModel": "gpt-4o"}'`,
       );
     }
     process.exit(1);
@@ -704,7 +708,7 @@ export async function runCliApp({
   try {
     const { generatePrompt } = await import("./prompt.js");
     promptRules = generatePrompt(
-      isRawScad ? task : "the 3D assets for the game",
+      isRawScad ? task : "the 3D assets for the project",
       options,
     );
   } catch (e) {

package/src/project-prompts.js

@@ -22,19 +22,23 @@ CRITICAL WORKFLOW:
     };
   }
 
-  if (projectType === "bevy") {
+  if (projectType === "bevy" || projectType === "wgpu") {
+    const isBevy = projectType === "bevy";
+    const frameworkName = isBevy ? "Bevy" : "wgpu";
+    const depName = isBevy ? "bevy" : "wgpu";
+
     return {
       buildSystemPrompt: (
         promptRules,
-      ) => `You are an expert Rust Bevy engine game developer and procedural 3D technical artist.
+      ) => `You are an expert Rust ${frameworkName} developer and procedural 3D technical artist.
 
 NAMING CONVENTION REQUIREMENT:
 - All generated files, directories, models, scripts, and root folders MUST strictly use snake_case (lowercase with underscores, e.g. \`player_character.rs\`, \`enemy_walker.scad\`).
 - NEVER use hyphens/minus signs (\`-\`) or spaces in any file or folder names.
 
 What to generate:
-1. 3D Game Assets (.scad):
-   - Generate procedural 3D models for the game using OpenSCAD.
+1. 3D Assets (.scad):
+   - Generate procedural 3D models for the project 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:
 
@@ -42,10 +46,10 @@ What to generate:
 ${promptRules}
 =============================
 
-2. Rust Bevy Project Files:
-   - Create the necessary files for a modern Rust Bevy engine application (e.g., \`Cargo.toml\`, \`build.rs\`, \`src/main.rs\`).
-   - In \`Cargo.toml\`, include \`bevy\` as a dependency.
-   - You MUST include this EXACT \`build.rs\` script at the root of the project to automatically compile the \`.scad\` files into \`.glb\` format inside the \`assets/models\` folder before running the game via Cargo:
+2. Rust ${frameworkName} Project Files:
+   - Create the necessary files for a modern Rust ${frameworkName} application (e.g., \`Cargo.toml\`, \`build.rs\`, \`src/main.rs\`).
+   - In \`Cargo.toml\`, include \`${depName}\` as a dependency.
+   - You MUST include this EXACT \`build.rs\` script at the root of the project to automatically compile the \`.scad\` files into \`.glb\` format inside the \`assets/models\` folder before running the application via Cargo:
      \`\`\`rust
      use std::process::Command;
 
@@ -70,7 +74,11 @@ ${promptRules}
          }
      }
      \`\`\`
-   - Write the core application logic in \`src/main.rs\` to load and display the converted \`.glb\` files interactively. Provide standard Bevy game systems (camera, lights, movement, etc.).
+   - Write the core application logic in \`src/main.rs\` to load and display the converted \`.glb\` files interactively.${
+     isBevy
+       ? " Provide standard Bevy systems (camera, lights, movement, etc.)."
+       : ""
+   }
 
 3. Delivery Format (Single Node.js Script):
    - Output exactly ONE self-contained Node.js script. Do not output manual setup instructions.
@@ -78,10 +86,10 @@ ${promptRules}
    - When executed, this script must programmatically create the entire project directory structure and write all the files to disk using the \`fs\` module.
    - The script must embed and write:
      - Your generated \`.scad\` 3D assets.
-     - Your generated Rust Bevy project files (\`Cargo.toml\`, \`build.rs\`, \`src/main.rs\`).
+     - Your generated Rust ${frameworkName} project files (\`Cargo.toml\`, \`build.rs\`, \`src/main.rs\`).
    - Ensure all string file contents inside the Node.js script are properly escaped.`,
       buildInputRequest: (task) =>
-        `Design and implement a Rust Bevy engine game for the following concept: "${task}"`,
+        `Design and implement a Rust ${frameworkName} project for the following concept: "${task}"`,
       allowedTools: ["render_scad_model", "compile_rust_project"],
     };
   }
@@ -94,7 +102,7 @@ ${promptRules}
 
 What to generate:
 1. 3D Web Assets (.scad):
-   - Generate procedural 3D models for the game using OpenSCAD.
+   - Generate procedural 3D models for the project 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:
 
@@ -104,14 +112,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 game'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 project's requirements.
    - In \`package.json\`, you MUST include the scad to gltf converter tool as a dev dependency:
      \`"scad-gltf": "^0.3.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-gltf convert ./scad ./public/models --cache"\`
      \`"prebuild": "scad-gltf convert ./scad ./public/models --cache"\`
-   - Write the core game logic to load and display the converted \`.glb\` files interactively.
+   - Write the core application 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.
@@ -122,7 +130,7 @@ ${promptRules}
      - Your generated Vite web project files.
    - 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}"`,
+        `Design and implement a web-based 3D glTF project using Vite for the following concept: "${task}"`,
       allowedTools: ["render_scad_model"],
     };
   }
@@ -133,15 +141,15 @@ ${promptRules}
         const hasUserScadFiles =
           Array.isArray(options.scadFiles) && options.scadFiles.length > 0;
 
-        const systemPrompt = `You are an expert Godot 4 game developer and procedural 3D technical artist.
+        const systemPrompt = `You are an expert Godot 4 developer and procedural 3D technical artist.
 
 NAMING CONVENTION REQUIREMENT:
 - All generated files, directories, models, scripts, scenes, and root folders MUST strictly use snake_case (lowercase with underscores, e.g. \`player_character.gd\`, \`main_scene.tscn\`, \`enemy_walker.scad\`).
 - NEVER use hyphens/minus signs (\`-\`) or spaces in any file or folder names.
 
 What to generate:
-1. 3D Game Assets (.scad):
-   - Generate procedural 3D models for the game using OpenSCAD.
+1. 3D Assets (.scad):
+   - Generate procedural 3D models for the project using OpenSCAD.
    - Scale & Units: 1 OpenSCAD unit = 1 Godot meter. Design your models using realistic meter-based scales (e.g., a character should be ~1.8 units tall). DO NOT use millimeter-based scaling.
    - Coordinate System & Forward Convention: Write standard OpenSCAD Z-up code (+Z is UP, XY plane is ground). Build objects standing upright and facing Front (Positive Y-axis).
    - Left/Right Convention: Always name and position "left" and "right" components (e.g., LeftArm, RightEye) based on the object's anatomical point of view (facing Forward towards +Y), NOT the camera/viewer's screen perspective. Because the object faces +Y, the object's Left side is along the -X axis, and the object's Right side is along the +X axis.
@@ -159,7 +167,7 @@ ${promptRules}
 =============================
 
 2. Godot 4 Project Files:
-   - Create the necessary GDScript (\`.gd\`) and scene (\`.tscn\`) files to implement the game logic, responsive player input controls, and a core gameplay loop.
+   - Create the necessary GDScript (\`.gd\`) and scene (\`.tscn\`) files to implement the project logic, responsive user input controls, and a core interaction loop.
    - The scenes should directly instance the generated \`.scad\` files (the provided addon will handle importing them as 3D scenes).
    - GDScript Coordinate, Forward, and Left/Right Conventions:
      * Forward is -Z: In Godot, \`Vector3.FORWARD\` is \`Vector3(0, 0, -1)\`. A 3D node's local forward direction is \`-transform.basis.z\` (or \`-global_transform.basis.z\`). In character movement, forward input (e.g., W or ui_up) must translate along \`-transform.basis.z\`. Never treat +Z as forward.
@@ -170,14 +178,14 @@ ${promptRules}
      * Natural Model Alignment: Because OpenSCAD models face +Y (Forward), they automatically import facing Godot's Forward direction (-Z). Built-in Godot methods like \`look_at()\` orient the node's -Z axis toward the target, which perfectly aligns with the model's front. Do NOT apply compensation rotations (e.g., \`rotate_y(PI)\`) in GDScript to compensate for model orientation.
    - Generate a \`project.godot\` file. It must configure the project and automatically enable the \`scad_importer\` plugin.
    - Generate a \`.gitignore\` file that ignores the \`.godot/\` folder.
-   - Generate a \`README.md\` file that documents the project, gameplay mechanics, and controls.
+   - Generate a \`README.md\` file that documents the project, mechanics/features, and controls.
 
 3. Delivery Format (Single Node.js Script):
    - Output exactly ONE self-contained Node.js script. Do not output manual setup instructions.
-   - CRITICAL: The generated Node.js script MUST first create a root project folder (named using snake_case with underscores, e.g., \`my_game_project\`) and output all files and folders inside this newly created project folder.
+   - CRITICAL: The generated Node.js script MUST first create a root project folder (named using snake_case with underscores, e.g., \`my_project\`) and output all files and folders inside this newly created project folder.
    - When executed, this script must programmatically create the entire project directory structure and write all the files to disk using the \`fs\` module.
    - The script must embed and write:
-     - Your generated \`.scad\` game assets.
+     - Your generated \`.scad\` assets.
      - Your generated Godot project files.
      - The exact source code of the provided \`addons/scad_importer/*\` files, placed in their correct respective paths.${
        hasUserScadFiles
@@ -226,7 +234,7 @@ ${promptRules}
 
         if (hasUserScadFiles) {
           systemClipboardOutput += `=== USER PROVIDED OPENSCAD FILES ===\n`;
-          systemClipboardOutput += `The following .scad files are provided as reference or base assets. You MUST embed and write them into the generated project, modifying them if necessary to fit the game logic.\n\n`;
+          systemClipboardOutput += `The following .scad files are provided as reference or base assets. You MUST embed and write them into the generated project, modifying them if necessary to fit the project logic.\n\n`;
           for (const file of options.scadFiles) {
             try {
               const content = fs
@@ -247,7 +255,7 @@ ${promptRules}
         return systemClipboardOutput.trimEnd() + "\n";
       },
       buildInputRequest: (task) =>
-        `Design and implement a Godot 4 project for the following game concept: "${task}"`,
+        `Design and implement a Godot 4 project for the following concept: "${task}"`,
       allowedTools: ["render_scad_model", "test_godot_project"],
     };
   }