incanto 0.71.0 → 0.72.0

package/bin/incanto-editor.mjs

@@ -30,7 +30,7 @@
 import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { createServer } from 'node:http';
 import { basename, dirname, extname, join, normalize, relative, resolve, sep } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import { readJson } from './_read-json.mjs';
 
 const PKG_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
@@ -463,7 +463,7 @@ const server = createServer((req, res) => {
       if (!originAllowed(req)) {
         return send(res, 403, JSON.stringify({ error: 'cross-origin write rejected' }));
       }
-      readBody(req, res, (body) => {
+      readBody(req, res, async (body) => {
         // a path with no extension means the usual thing, so `levels/arena` works
         const wanted =
           typeof body?.path === 'string' && body.path && !body.path.endsWith('.json')
@@ -495,14 +495,20 @@ const server = createServer((req, res) => {
          */
         const asked = body?.dimension === '3d' || body?.dimension === '2d' ? body.dimension : null;
         const dimension = asked ?? projectDimension() ?? '2d';
-        const scene = {
-          format: 1,
-          type: 'scene',
-          dimension,
-          name,
-          root: { name, type: dimension === '3d' ? 'Node3D' : 'Node2D' },
-        };
         try {
+          // uid at CREATION, like every node the editor makes: without it the
+          // first save backfills one and the diff carries a line nobody wrote.
+          // Imported here rather than at the top so starting the editor never
+          // pays for `dist` it may not otherwise need — inside the try, so a
+          // missing build is a 400 and not a dead server.
+          const { newUid } = await import(pathToFileURL(join(PKG_ROOT, 'dist', 'index.js')).href);
+          const scene = {
+            format: 1,
+            type: 'scene',
+            dimension,
+            name,
+            root: { name, type: dimension === '3d' ? 'Node3D' : 'Node2D', uid: newUid() },
+          };
           mkdirSync(dirname(abs), { recursive: true });
           writeFileSync(abs, formatSceneJson(scene));
           return send(res, 201, JSON.stringify({ rel: relative(ROOT, abs), abs }));

package/bin/incanto-feel.mjs

@@ -60,7 +60,17 @@ if (args.help || !args.scene) {
                     pushed +x/-y/+y/-x until the player moves)
   --jump ACTION     the button to jump with (default: "jump")
   --json            the report as JSON instead of prose`);
-  process.exit(!args.invalid && args.help && args.scene !== undefined ? 0 : 1);
+  /*
+   * `--help` is a REQUEST, and the answer is the text above.
+   *
+   * The rule used to be "0 only if a scene was also named", so the exact thing
+   * an agent types first — `incanto-playtest --help` — printed the usage and
+   * exited 1, while thirteen sibling bins exited 0 for the same input. A
+   * non-zero exit says "you did it wrong" to someone who did the documented
+   * thing, and under `set -e` it stops the script. A typo still exits 1
+   * (`invalid`), and so does a missing scene when help was not asked for.
+   */
+  process.exit(args.help && !args.invalid ? 0 : 1);
 }
 
 const { facingReport, facingText, feelReport, feelText } = await import(

package/bin/incanto-play.mjs

@@ -69,7 +69,17 @@ if (args.help || !args.scene) {
 
 Headless play: stdin commands (step/press/release/vector/key/mouse/pointer/
 wheel/capture/describe/framing/logs/quit), JSON-line responses on stdout.`);
-  process.exit(!args.invalid && args.help && args.scene !== undefined ? 0 : 1);
+  /*
+   * `--help` is a REQUEST, and the answer is the text above.
+   *
+   * The rule used to be "0 only if a scene was also named", so the exact thing
+   * an agent types first — `incanto-playtest --help` — printed the usage and
+   * exited 1, while thirteen sibling bins exited 0 for the same input. A
+   * non-zero exit says "you did it wrong" to someone who did the documented
+   * thing, and under `set -e` it stops the script. A typo still exits 1
+   * (`invalid`), and so does a missing scene when help was not asked for.
+   */
+  process.exit(args.help && !args.invalid ? 0 : 1);
 }
 
 const out = (obj) => process.stdout.write(`${JSON.stringify(obj)}\n`);

package/bin/incanto-playtest.mjs

@@ -92,7 +92,17 @@ if (args.help || !args.scene) {
 Exits 1 when a run THREW or left the world, or when a win is declared and no
 run reached it. A scene that declares no win, or has nobody to drive, exits 0 —
 the report marks those · rather than ✗, and the exit code says the same.`);
-  process.exit(!args.invalid && args.help && args.scene !== undefined ? 0 : 1);
+  /*
+   * `--help` is a REQUEST, and the answer is the text above.
+   *
+   * The rule used to be "0 only if a scene was also named", so the exact thing
+   * an agent types first — `incanto-playtest --help` — printed the usage and
+   * exited 1, while thirteen sibling bins exited 0 for the same input. A
+   * non-zero exit says "you did it wrong" to someone who did the documented
+   * thing, and under `set -e` it stops the script. A typo still exits 1
+   * (`invalid`), and so does a missing scene when help was not asked for.
+   */
+  process.exit(args.help && !args.invalid ? 0 : 1);
 }
 
 const { playtest, playtestText, playtestFailed, failingReplays } = await import(

package/dist/2d.d.ts

@@ -1,10 +1,10 @@
-import { c as showBootFailure, i as ParticleSim, o as ParticleView, r as SpatialPose, s as isWebGLAvailable } from "./audio-player-L8yccdMP.js";
-import { P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, w as GameStats, x as EngineOptions } from "./behavior-Dcz0fr1S.js";
+import { c as showBootFailure, i as ParticleSim, o as ParticleView, r as SpatialPose, s as isWebGLAvailable } from "./audio-player-ioZ7VKC6.js";
+import { P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, w as GameStats, x as EngineOptions } from "./behavior-Bf9P9oB2.js";
 import { t as DiagnosticSink } from "./diagnostics-Cu85N3tL.js";
 import { a as SceneJson, s as JsonObject } from "./rng-Bb-IutXB.js";
 import { t as EditorSwitchOptions } from "./editor-switch-CFU9mCec.js";
 import { r as FrameStats } from "./frame-report-DNxDAb1w.js";
-import { t as LoadSceneOptions } from "./loader-8-IHvbKD.js";
+import { t as LoadSceneOptions } from "./loader-CBfQzB6S.js";
 import { n as AnimationEntry } from "./sprite-animation-CMr6f1K2.js";
 import { Group, Mesh, Object3D, Scene, Texture } from "three";
 import * as RapierNs from "@dimforge/rapier2d-compat";

package/dist/2d.js

@@ -1,9 +1,9 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as showBootFailure } from "./boot-failure-CKYrEcGF.js";
 import { t as isWebGLAvailable } from "./webgl-unavailable-C8aDbGmR.js";
-import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-CH4kt78v.js";
-import { _ as RigidBody2D, a as parseCells, c as ColorRect2D, d as AnimatedSprite2D, f as Sprite2D, g as PhysicsBody2D, h as CharacterBody2D, i as mergeSolidRects, l as CharacterController2D, m as Area2D, n as UILayer, o as Particles2D, p as Joint2D, r as TileMap2D, s as Label, t as registerNodes2D, u as Camera2D, v as StaticBody2D, y as Node2D } from "./register-BYQCBySi.js";
-import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-FhrXUc6B.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-C9rWqqAC.js";
+import { _ as RigidBody2D, a as parseCells, c as ColorRect2D, d as AnimatedSprite2D, f as Sprite2D, g as PhysicsBody2D, h as CharacterBody2D, i as mergeSolidRects, l as CharacterController2D, m as Area2D, n as UILayer, o as Particles2D, p as Joint2D, r as TileMap2D, s as Label, t as registerNodes2D, u as Camera2D, v as StaticBody2D, y as Node2D } from "./register-C8HuRkOf.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-DrIgTlLk.js";
 //#region src/2d/library-sprite.ts
 /**
 * What a `CharacterController2D`/`3D` will ask a skin to play, and the clip in

package/dist/3d.d.ts

@@ -1,10 +1,10 @@
-import { c as showBootFailure, i as ParticleSim, o as ParticleView, r as SpatialPose, s as isWebGLAvailable } from "./audio-player-L8yccdMP.js";
-import { D as QualityCaps, P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, w as GameStats, x as EngineOptions } from "./behavior-Dcz0fr1S.js";
+import { c as showBootFailure, i as ParticleSim, o as ParticleView, r as SpatialPose, s as isWebGLAvailable } from "./audio-player-ioZ7VKC6.js";
+import { D as QualityCaps, P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, w as GameStats, x as EngineOptions } from "./behavior-Bf9P9oB2.js";
 import { t as DiagnosticSink } from "./diagnostics-Cu85N3tL.js";
 import { a as SceneJson$1, s as JsonObject } from "./rng-Bb-IutXB.js";
 import { t as EditorSwitchOptions } from "./editor-switch-CFU9mCec.js";
 import { a as GridCell, c as diffText, d as frameText, i as FrameStatsOptions, l as frameSignature, n as FrameSignature, o as SIGNATURE_GRID, r as FrameStats, s as diffSignatures, t as FrameDiff, u as frameStats } from "./frame-report-DNxDAb1w.js";
-import { t as LoadSceneOptions } from "./loader-8-IHvbKD.js";
+import { t as LoadSceneOptions } from "./loader-CBfQzB6S.js";
 import { n as PathGrid } from "./pathfinding-_fGrCFmH.js";
 import { AnimationClip, AnimationMixer, BufferGeometry, Color, DirectionalLight, Group, InstancedMesh, Mesh, MeshPhysicalMaterial, Object3D, PerspectiveCamera, Scene, ShaderMaterial, Texture, Vector3, WebGLRenderer } from "three";
 import { VRM } from "@pixiv/three-vrm";

package/dist/3d.js

@@ -1,12 +1,12 @@
-import { C as sunDirectionFromSky, S as sunDirectionFromElevationAzimuth, b as horizonColorFromSky, x as parseEnvironment3D } from "./save-slots-Bvuh2p_r.js";
+import { C as sunDirectionFromSky, S as sunDirectionFromElevationAzimuth, b as horizonColorFromSky, x as parseEnvironment3D } from "./save-slots-CEuJPUle.js";
 import { t as showBootFailure } from "./boot-failure-CKYrEcGF.js";
 import { t as isWebGLAvailable } from "./webgl-unavailable-C8aDbGmR.js";
 import { a as frameSignature, n as diffSignatures, o as frameStats, r as diffText, s as frameText, t as SIGNATURE_GRID } from "./frame-report-D-_7YF2G.js";
-import { G as StaticBody3D, H as CharacterBody3D, K as Node3D, L as Water3D, R as WATER_CUTOUT_MAX, U as PhysicsBody3D, V as Area3D, W as RigidBody3D, Y as WATER_MAX_RIPPLES, z as WaterCutout3D } from "./gameplay-CNULJvwh.js";
-import { A as Terrain3D, B as keyboardIntensity, C as resolveFlowerDensity, D as BoneLookAt3D, E as Camera3D, F as InstancedMesh3D, G as acquireTexture, H as rigPose, I as MeshInstance3D, M as TERRAIN_THEMES, N as terrainThemeLayers, O as BoneAttachment3D, P as Joint3D, R as QUARTER_PITCH, S as Flowers3D, T as CharacterController3D, U as TextureCache3D, V as movementState, W as acquireOwnTexture, _ as LoftMesh3D, a as Tree3D, b as Foliage3D, c as buildRiverRings, d as riverCarveChannels, f as riverStepFor, g as ModelInstance3D, h as Particles3D, i as VoxelGrid3D, j as DEFAULT_TERRAIN_TEXTURE_BASE, k as Billboard3D, l as findRiverCoverageGaps, m as traceDownhillPath, n as registerNodes3D, o as Trail3D, p as smoothCourse, r as VOXEL_PALETTE, s as River3D, u as projectToRiver, v as DirectionalLight3D, w as FLOWER_VARIETIES, x as DENSITY_PRESETS, y as OmniLight3D, z as cameraRelative } from "./environment-presets-99BzP_L-.js";
-import { a as Environment3D, c as AssetStore3D, i as syncTree, o as applyQualityTier3D, r as Renderer3D, s as setEnvironment3D, t as createGame3D } from "./create-game-LCHBLfA4.js";
+import { G as StaticBody3D, H as CharacterBody3D, K as Node3D, L as Water3D, R as WATER_CUTOUT_MAX, U as PhysicsBody3D, V as Area3D, W as RigidBody3D, Y as WATER_MAX_RIPPLES, z as WaterCutout3D } from "./gameplay-BlQe-M07.js";
+import { A as Terrain3D, B as keyboardIntensity, C as resolveFlowerDensity, D as BoneLookAt3D, E as Camera3D, F as InstancedMesh3D, G as acquireTexture, H as rigPose, I as MeshInstance3D, M as TERRAIN_THEMES, N as terrainThemeLayers, O as BoneAttachment3D, P as Joint3D, R as QUARTER_PITCH, S as Flowers3D, T as CharacterController3D, U as TextureCache3D, V as movementState, W as acquireOwnTexture, _ as LoftMesh3D, a as Tree3D, b as Foliage3D, c as buildRiverRings, d as riverCarveChannels, f as riverStepFor, g as ModelInstance3D, h as Particles3D, i as VoxelGrid3D, j as DEFAULT_TERRAIN_TEXTURE_BASE, k as Billboard3D, l as findRiverCoverageGaps, m as traceDownhillPath, n as registerNodes3D, o as Trail3D, p as smoothCourse, r as VOXEL_PALETTE, s as River3D, u as projectToRiver, v as DirectionalLight3D, w as FLOWER_VARIETIES, x as DENSITY_PRESETS, y as OmniLight3D, z as cameraRelative } from "./environment-presets-BeHoaGhy.js";
+import { a as Environment3D, c as AssetStore3D, i as syncTree, o as applyQualityTier3D, r as Renderer3D, s as setEnvironment3D, t as createGame3D } from "./create-game-CmFAtLZp.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-BYgD5Edk.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-CFEGxBXZ.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-BzOCw1VS.js";
 //#region src/3d/model-verdict.ts
 /** Mixamo exports every bone as `mixamorigX`; the retargeter binds by that name. */
 const MIXAMO = /^mixamorig[:_]?/i;

package/dist/{agent8-Cfmd3ar_.js → agent8-BqZ0_O1u.js}

@@ -1,5 +1,5 @@
 import { o as __exportAll } from "./json-CfTjpvW8.js";
-import { Y as diagnose } from "./save-slots-Bvuh2p_r.js";
+import { Y as diagnose } from "./save-slots-CEuJPUle.js";
 //#region src/net/agent8.ts
 var agent8_exports = /* @__PURE__ */ __exportAll({
 	Agent8TransportForTest: () => Agent8Transport,

package/dist/{audio-player-L8yccdMP.d.ts → audio-player-ioZ7VKC6.d.ts}

@@ -1,4 +1,4 @@
-import { d as PropSchema, dt as Listener, jt as Node } from "./behavior-Dcz0fr1S.js";
+import { d as PropSchema, dt as Listener, jt as Node } from "./behavior-Bf9P9oB2.js";
 import { t as Rng } from "./rng-Bb-IutXB.js";
 
 //#region src/core/boot-failure.d.ts

package/dist/{behavior-Dcz0fr1S.d.ts → behavior-Bf9P9oB2.d.ts}

@@ -2297,7 +2297,7 @@ declare class Engine {
   * pass it back. Without that a game using the documented sub-scenes booted
   * fine and threw `UNRESOLVED_INSTANCE` on its first restart.
   */
-  resolveScene?: (path: string) => SceneJson;
+  resolveScene?: (path: string) => SceneJson | null | undefined;
   /**
   * How the current scene was LOADED, for the rebuilds that happen later.
   *

package/dist/{create-game-CH4kt78v.js → create-game-C9rWqqAC.js}

@@ -1,15 +1,15 @@
 import { o as __exportAll } from "./json-CfTjpvW8.js";
-import { D as computeViewport, O as resolveViewport, Y as diagnose, h as loadScene, ot as registerBehavior } from "./save-slots-Bvuh2p_r.js";
-import { C as qualityRendering, _ as AudioPlayer, v as Engine } from "./register-DuVdzxbq.js";
+import { D as computeViewport, O as resolveViewport, R as sceneDimension, Y as diagnose, h as loadScene, ot as registerBehavior } from "./save-slots-CEuJPUle.js";
+import { C as qualityRendering, _ as AudioPlayer, v as Engine } from "./register-5IYfooAN.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as attachTouchControls } from "./touch-BnCyPA0G.js";
 import { n as withWebGLContext, r as resolveRendering } from "./webgl-unavailable-C8aDbGmR.js";
-import { a as devServerLibrary, c as applyDriveStep, d as audioErrors, i as crossFade, l as wireDevChannel, n as teardown, o as openBundledEditor, r as pauseWhenHidden, t as nodeFromHits, u as claimCanvasGestures } from "./picking-DVo7fI13.js";
+import { a as devServerLibrary, c as applyDriveStep, d as audioErrors, i as crossFade, l as wireDevChannel, n as teardown, o as openBundledEditor, r as pauseWhenHidden, t as nodeFromHits, u as claimCanvasGestures } from "./picking-C9McVJrO.js";
 import { o as frameStats } from "./frame-report-D-_7YF2G.js";
-import { n as registerGameplayBehaviors } from "./gameplay-CNULJvwh.js";
-import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-BYQCBySi.js";
+import { n as registerGameplayBehaviors } from "./gameplay-BlQe-M07.js";
+import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-C8HuRkOf.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { n as enablePhysics2D } from "./physics-2d-FhrXUc6B.js";
+import { n as enablePhysics2D } from "./physics-2d-DrIgTlLk.js";
 import { Box3, BufferAttribute, BufferGeometry, Color, LineBasicMaterial, LineSegments, LinearFilter, NearestFilter, OrthographicCamera, Raycaster, SRGBColorSpace, Scene, TextureLoader, Vector2, Vector3, WebGLRenderer } from "three";
 //#region src/2d/assets.ts
 /**
@@ -132,6 +132,34 @@ var AssetStore2D = class {
 	}
 };
 //#endregion
+//#region src/2d/debug-lines.ts
+/**
+* Physics debug segments, moved into the space the 2D renderer draws in.
+*
+* Two coordinate systems meet here and they disagree about Y. Engine 2D is
+* y-DOWN (screen pixels, gravity `+980`, and Rapier's world is built the same
+* way — `kcc.setUp({x: 0, y: -1})`). The three.js scene the renderer paints
+* into is y-UP, which is why every node's own sync writes
+* `o.position.set(x, -y, 0)`.
+*
+* `syncDebugLines` copied Rapier's vertices straight across without that
+* negation, so every collider outline was MIRRORED about the world's y=0 line:
+* a crate at y=120 drew its box at −120, the further from the axis the further
+* off, and a tilemap's merged floor at y=384 drew itself off the top of the
+* canvas entirely. The overlay whose whole promise is "the colliders the
+* ENGINE builds… wherever physics actually puts them" was the one thing in the
+* 2D view that was not where physics put it.
+*/
+function debugLinesToScene(px) {
+	const xyz = new Float32Array(px.length / 2 * 3);
+	for (let i = 0, j = 0; i < px.length; i += 2, j += 3) {
+		xyz[j] = px[i];
+		xyz[j + 1] = -px[i + 1];
+		xyz[j + 2] = 0;
+	}
+	return xyz;
+}
+//#endregion
 //#region src/2d/picking.ts
 function screenFromWorld(view, wx, wy) {
 	return {
@@ -547,12 +575,7 @@ var Renderer2D = class {
 		}
 		this.debugLines.visible = vertices !== null;
 		if (!vertices) return;
-		const xyz = new Float32Array(vertices.length / 2 * 3);
-		for (let i = 0, j = 0; i < vertices.length; i += 2, j += 3) {
-			xyz[j] = vertices[i];
-			xyz[j + 1] = vertices[i + 1];
-			xyz[j + 2] = 0;
-		}
+		const xyz = debugLinesToScene(vertices);
 		this.debugLines.geometry.setAttribute("position", new BufferAttribute(xyz, 3));
 	}
 	render() {
@@ -809,6 +832,7 @@ async function createGame2D(opts) {
 		...opts._scheduler ? { scheduler: opts._scheduler } : {}
 	});
 	const sourceJson = cloneSceneJson(opts.scene);
+	if (sceneDimension(sourceJson) === "3d") throw new IncantoError("WRONG_DIMENSION", `createGame2D was given a 3D scene ('${String(sourceJson.name ?? "scene")}'). Its nodes are never drawn by the 2D renderer and never simulated by 2D physics — you get a blank canvas. Boot it with createGame3D instead.`);
 	const scene = loadScene(cloneSceneJson(sourceJson), {
 		resolveScene: opts.resolveScene,
 		engine

package/dist/{create-game-LCHBLfA4.js → create-game-CmFAtLZp.js}

@@ -1,15 +1,15 @@
 import { o as __exportAll } from "./json-CfTjpvW8.js";
-import { C as sunDirectionFromSky, Y as diagnose, b as horizonColorFromSky, h as loadScene, ot as registerBehavior, x as parseEnvironment3D } from "./save-slots-Bvuh2p_r.js";
-import { C as qualityRendering, S as qualityEnvironment, _ as AudioPlayer, v as Engine, x as qualityCaps } from "./register-DuVdzxbq.js";
+import { C as sunDirectionFromSky, R as sceneDimension, Y as diagnose, b as horizonColorFromSky, h as loadScene, ot as registerBehavior, x as parseEnvironment3D } from "./save-slots-CEuJPUle.js";
+import { C as qualityRendering, S as qualityEnvironment, _ as AudioPlayer, v as Engine, x as qualityCaps } from "./register-5IYfooAN.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as attachTouchControls } from "./touch-BnCyPA0G.js";
 import { n as withWebGLContext, r as resolveRendering } from "./webgl-unavailable-C8aDbGmR.js";
-import { a as devServerLibrary, c as applyDriveStep, d as audioErrors, i as crossFade, l as wireDevChannel, n as teardown, o as openBundledEditor, r as pauseWhenHidden, s as poseFromRenderer, t as nodeFromHits, u as claimCanvasGestures } from "./picking-DVo7fI13.js";
+import { a as devServerLibrary, c as applyDriveStep, d as audioErrors, i as crossFade, l as wireDevChannel, n as teardown, o as openBundledEditor, r as pauseWhenHidden, s as poseFromRenderer, t as nodeFromHits, u as claimCanvasGestures } from "./picking-C9McVJrO.js";
 import { o as frameStats } from "./frame-report-D-_7YF2G.js";
-import { J as createCausticsQuad, K as Node3D, U as PhysicsBody3D, n as registerGameplayBehaviors } from "./gameplay-CNULJvwh.js";
+import { J as createCausticsQuad, K as Node3D, U as PhysicsBody3D, n as registerGameplayBehaviors } from "./gameplay-BlQe-M07.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-99BzP_L-.js";
-import { n as enablePhysics3D } from "./physics-3d-CFEGxBXZ.js";
+import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-BeHoaGhy.js";
+import { n as enablePhysics3D } from "./physics-3d-BzOCw1VS.js";
 import { ACESFilmicToneMapping, AmbientLight, Box3, BufferAttribute, BufferGeometry, Color, DepthTexture, EquirectangularReflectionMapping, FloatType, Fog, HalfFloatType, LineBasicMaterial, LineSegments, LoadingManager, Matrix4, Mesh, PCFShadowMap, PMREMGenerator, PerspectiveCamera, PlaneGeometry, Quaternion, Raycaster, Scene, ShaderMaterial, Vector2, Vector3, WebGLRenderTarget, WebGLRenderer } from "three";
 import { VRMLoaderPlugin, VRMUtils } from "@pixiv/three-vrm";
 import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";
@@ -2253,6 +2253,7 @@ async function createGame3D(opts) {
 		...opts._scheduler ? { scheduler: opts._scheduler } : {}
 	});
 	const sourceJson = cloneSceneJson(opts.scene);
+	if (sceneDimension(sourceJson) === "2d") throw new IncantoError("WRONG_DIMENSION", `createGame3D was given a 2D scene ('${String(sourceJson.name ?? "scene")}'). Its nodes are never drawn by the 3D renderer and never simulated by 3D physics — you get a blank canvas. Boot it with createGame2D instead.`);
 	const scene = loadScene(cloneSceneJson(sourceJson), {
 		resolveScene: opts.resolveScene,
 		engine

package/dist/debug.d.ts

@@ -1,4 +1,4 @@
-import { Ft as LogLevel, T as RendererStats, b as Engine } from "./behavior-Dcz0fr1S.js";
+import { Ft as LogLevel, T as RendererStats, b as Engine } from "./behavior-Bf9P9oB2.js";
 
 //#region src/debug/panel.d.ts
 /** Minimal document surface the overlay needs (injectable for tests). */