create-babylonjs 9.13.0 → 9.15.0

package/dist/generators/gitignore.d.ts

@@ -0,0 +1,2 @@
+import type { ProjectOptions } from "../index";
+export declare function generateGitignore(_options: ProjectOptions): string;

package/dist/generators/gitignore.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateGitignore = generateGitignore;
+function generateGitignore(_options) {
+    return `# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# Editor directories and files
+.idea/
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# TypeScript
+*.tsbuildinfo
+`;
+}

package/dist/generators/indexHtml.js

@@ -4,17 +4,15 @@ exports.generateIndexHtml = generateIndexHtml;
 function generateIndexHtml(options) {
     const { bundler, moduleFormat } = options;
     const styles = `
-        html, body {
-            overflow: hidden;
-            width: 100%;
-            height: 100%;
+        body {
             margin: 0;
             padding: 0;
         }
 
         #renderCanvas {
-            width: 100%;
-            height: 100%;
+            display: block;
+            width: 100dvw;
+            height: 100dvh;
             touch-action: none;
         }`;
     // CDN-only (no bundler, UMD)
@@ -39,13 +37,28 @@ function generateIndexHtml(options) {
         const createScene = async function () {
             const scene = new BABYLON.Scene(engine);
 
-            // Load a glTF model
-            await BABYLON.AppendSceneAsync("https://assets.babylonjs.com/meshes/boombox.glb", scene);
+            try {
+                // Load a glTF model
+                await BABYLON.AppendSceneAsync("https://assets.babylonjs.com/meshes/boombox.glb", scene);
 
-            // Create a default camera that frames the loaded model
-            scene.createDefaultCamera(true, true, true);
-            // Rotate the camera to face the front of the model
-            scene.activeCamera.alpha += Math.PI;
+                // Create a default camera, and event caught by the controls will call preventdefault(),
+                // such as wheel event
+                scene.createDefaultCamera(true, true, true);
+                // Rotate the camera to face the front of the model
+                scene.activeCamera.alpha += Math.PI;
+            } catch {
+                // Fallback: when loading fails
+                // Create a default box mesh
+                BABYLON.CreateBox("box", {}, scene);
+
+                scene.createDefaultCamera(true, true, true);
+                const camera = scene.activeCamera;
+                camera.setPosition(new BABYLON.Vector3(3, 3, 3));
+                camera.setTarget(new BABYLON.Vector3(0, 0, 0));
+
+                // Create a default light for the scene
+                scene.createDefaultLight(true);
+            }
 
             // Create a default environment (skybox + ground + environment lighting)
             scene.createDefaultEnvironment({

package/dist/generators/sceneCode.js

@@ -1,15 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateSceneCode = generateSceneCode;
-const GLTF_MODEL_URL = "https://assets.babylonjs.com/meshes/boombox.glb";
 // ES6 scene code — tree-shakeable imports
 function es6Scene(language) {
     const canvasCast = language === "ts" ? " as HTMLCanvasElement" : "";
     const arcCamImport = language === "ts" ? '\nimport { ArcRotateCamera } from "@babylonjs/core/Cameras/arcRotateCamera";' : "";
-    const alphaCast = language === "ts" ? "(scene.activeCamera as ArcRotateCamera)" : "scene.activeCamera";
+    const cameraCast = language === "ts" ? " as ArcRotateCamera" : "";
     return `import { Engine } from "@babylonjs/core/Engines/engine";
 import { Scene } from "@babylonjs/core/scene";
-import { AppendSceneAsync } from "@babylonjs/core/Loading/sceneLoader";${arcCamImport}
+import { AppendSceneAsync } from "@babylonjs/core/Loading/sceneLoader";
+import { CreateBox } from "@babylonjs/core/Meshes/Builders/boxBuilder";${arcCamImport}
+import { Vector3 } from "@babylonjs/core/Maths/math.vector";
 
 // Side-effect imports: these register plugins and augment prototypes at load time
 import "@babylonjs/core/Loading/loadingScreen";
@@ -22,25 +23,40 @@ import "@babylonjs/loaders/glTF";
 const canvas = document.getElementById("renderCanvas")${canvasCast};
 const engine = new Engine(canvas, true);
 
-const createScene = async () => {
-    const scene = new Scene(engine);
-
-    // Load a glTF model
-    await AppendSceneAsync("${GLTF_MODEL_URL}", scene);
-
-    // Create a default camera that frames the loaded model
-    scene.createDefaultCamera(true, true, true);
-    // Rotate the camera to face the front of the model
-    ${alphaCast}.alpha += Math.PI;
-
-    // Create a default environment (skybox + ground + environment lighting)
-    scene.createDefaultEnvironment({
-        createGround: true,
-        createSkybox: true,
-    });
-
-    return scene;
-};
+    const createScene = async () => {
+        const scene = new Scene(engine);
+
+        try {
+            // Load a glTF model
+            await AppendSceneAsync("https://assets.babylonjs.com/meshes/boombox.glb", scene);
+
+            // Create a default camera, and event caught by the controls will call preventdefault(),
+            // such as wheel event
+            scene.createDefaultCamera(true, true, true);
+            // Rotate the camera to face the front of the model
+            (scene.activeCamera${cameraCast}).alpha += Math.PI;
+        } catch {
+            // Fallback: when loading fails
+            // Create a default box mesh
+            CreateBox("box", {}, scene);
+
+            scene.createDefaultCamera(true, true, true);
+            const camera = scene.activeCamera${cameraCast};
+            camera.setPosition(new Vector3(3, 3, 3));
+            camera.setTarget(new Vector3(0, 0, 0));
+
+            // Create a default light for the scene
+            scene.createDefaultLight(true);
+        }
+
+        // Create a default environment (skybox + ground + environment lighting)
+        scene.createDefaultEnvironment({
+            createGround: true,
+            createSkybox: true,
+        });
+
+        return scene;
+    };
 
 createScene().then((scene) => {
     engine.runRenderLoop(() => {
@@ -65,13 +81,28 @@ const engine = new BABYLON.Engine(canvas, true);
 const createScene = async (): Promise<BABYLON.Scene> => {
     const scene = new BABYLON.Scene(engine);
 
-    // Load a glTF model
-    await BABYLON.AppendSceneAsync("${GLTF_MODEL_URL}", scene);
-
-    // Create a default camera that frames the loaded model
-    scene.createDefaultCamera(true, true, true);
-    // Rotate the camera to face the front of the model
-    (scene.activeCamera as BABYLON.ArcRotateCamera).alpha += Math.PI;
+    try {
+        // Load a glTF model
+        await BABYLON.AppendSceneAsync("https://assets.babylonjs.com/meshes/boombox.glb", scene);
+
+        // Create a default camera, and event caught by the controls will call preventdefault(),
+        // such as wheel event
+        scene.createDefaultCamera(true, true, true);
+        // Rotate the camera to face the front of the model
+        (scene.activeCamera as BABYLON.ArcRotateCamera).alpha += Math.PI;
+    } catch {
+        // Fallback: when loading fails
+        // Create a default box mesh
+        BABYLON.CreateBox("box", {}, scene);
+
+        scene.createDefaultCamera(true, true, true);
+        const camera = scene.activeCamera as BABYLON.ArcRotateCamera;
+        camera.setPosition(new BABYLON.Vector3(3, 3, 3));
+        camera.setTarget(new BABYLON.Vector3(0, 0, 0));
+
+        // Create a default light for the scene
+        scene.createDefaultLight(true);
+    }
 
     // Create a default environment (skybox + ground + environment lighting)
     scene.createDefaultEnvironment({
@@ -104,13 +135,28 @@ const engine = new BABYLON.Engine(canvas, true);
 const createScene = async () => {
     const scene = new BABYLON.Scene(engine);
 
-    // Load a glTF model
-    await BABYLON.AppendSceneAsync("${GLTF_MODEL_URL}", scene);
-
-    // Create a default camera that frames the loaded model
-    scene.createDefaultCamera(true, true, true);
-    // Rotate the camera to face the front of the model
-    scene.activeCamera.alpha += Math.PI;
+    try {
+        // Load a glTF model
+        await BABYLON.AppendSceneAsync("https://assets.babylonjs.com/meshes/boombox.glb", scene);
+
+        // Create a default camera, and event caught by the controls will call preventdefault(),
+        // such as wheel event
+        scene.createDefaultCamera(true, true, true);
+        // Rotate the camera to face the front of the model
+        scene.activeCamera.alpha += Math.PI;
+    } catch {
+        // Fallback: when loading fails
+        // Create a default box mesh
+        BABYLON.CreateBox("box", {}, scene);
+
+        scene.createDefaultCamera(true, true, true);
+        const camera = scene.activeCamera;
+        camera.setPosition(new BABYLON.Vector3(3, 3, 3));
+        camera.setTarget(new BABYLON.Vector3(0, 0, 0));
+
+        // Create a default light for the scene
+        scene.createDefaultLight(true);
+    }
 
     // Create a default environment (skybox + ground + environment lighting)
     scene.createDefaultEnvironment({

package/dist/generators/tsConfig.js

@@ -3,23 +3,32 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateTsConfig = generateTsConfig;
 function generateTsConfig(options) {
     const { bundler, moduleFormat } = options;
-    const base = {
-        compilerOptions: {
-            target: "ES2020",
-            module: bundler === "vite" ? "ESNext" : "ES2020",
-            moduleResolution: bundler === "vite" ? "bundler" : "node",
-            strict: true,
-            esModuleInterop: true,
-            skipLibCheck: true,
-            forceConsistentCasingInFileNames: true,
-            outDir: "./dist",
-            sourceMap: true,
-        },
-        include: ["src"],
+    const types = [];
+    const compilerOptions = {
+        target: "ES2020",
+        module: bundler === "vite" ? "ESNext" : "ES2020",
+        moduleResolution: bundler === "vite" ? "bundler" : "node",
+        strict: true,
+        esModuleInterop: true,
+        skipLibCheck: true,
+        forceConsistentCasingInFileNames: true,
+        sourceMap: true,
     };
+    if (bundler === "vite") {
+        // Vite handles the actual bundling, so TypeScript only needs to type-check without emitting output
+        compilerOptions.noEmit = true;
+        // Add Vite client type declarations (e.g., import.meta.env, asset imports)
+        types.push("vite/client");
+    }
+    else {
+        compilerOptions.outDir = "./dist";
+    }
     // UMD packages ship their own typings via the `babylonjs` package
     if (moduleFormat === "umd") {
-        base.compilerOptions.types = ["babylonjs"];
+        types.push("babylonjs");
+    }
+    if (types.length > 0) {
+        compilerOptions.types = types;
     }
-    return JSON.stringify(base, null, 2) + "\n";
+    return JSON.stringify({ compilerOptions, include: ["src"] }, null, 2) + "\n";
 }

package/dist/index.js

@@ -12,6 +12,7 @@ const indexHtml_1 = require("./generators/indexHtml");
 const sceneCode_1 = require("./generators/sceneCode");
 const bundlerConfig_1 = require("./generators/bundlerConfig");
 const tsConfig_1 = require("./generators/tsConfig");
+const gitignore_1 = require("./generators/gitignore");
 async function main() {
     console.log("\n🏗️  Create Babylon.js Project\n");
     const response = await (0, prompts_1.default)([
@@ -96,6 +97,8 @@ async function main() {
 }
 function scaffoldProject(targetDir, options) {
     fs_1.default.mkdirSync(targetDir, { recursive: true });
+    // All projects get a .gitignore
+    writeFile(targetDir, ".gitignore", (0, gitignore_1.generateGitignore)(options));
     if (options.bundler === "none") {
         // CDN-only: just an HTML file
         writeFile(targetDir, "index.html", (0, indexHtml_1.generateIndexHtml)(options));

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "create-babylonjs",
-    "version": "9.13.0",
+    "version": "9.15.0",
     "description": "Scaffold a new Babylon.js project with your choice of module format, language, and bundler.",
     "bin": {
         "create-babylonjs": "./dist/index.js"