incanto 0.67.0 → 0.68.0

package/dist/{create-game-FAXdHta3.js → create-game-DbWtVTxD.js}

@@ -1,15 +1,15 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { c as parseEnvironment3D, k as diagnose, n as loadScene, s as horizonColorFromSky, u as sunDirectionFromSky, z as registerBehavior } from "./loader-KZESOZmE.js";
-import { C as qualityRendering, _ as AudioPlayer, v as Engine, x as qualityCaps } from "./register-Cs53CY7s.js";
+import { c as parseEnvironment3D, k as diagnose, n as loadScene, s as horizonColorFromSky, u as sunDirectionFromSky, z as registerBehavior } from "./loader-BC4PNtJX.js";
+import { C as qualityRendering, _ as AudioPlayer, v as Engine, x as qualityCaps } from "./register-3ta-2Xig.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as attachTouchControls } from "./touch-DEAmqGdf.js";
-import { t as resolveRendering } from "./rendering-options-ByAdi8PF.js";
-import { a as openBundledEditor, c as claimCanvasGestures, i as devServerLibrary, l as audioErrors, n as pauseWhenHidden, o as poseFromRenderer, r as crossFade, s as wireDevChannel, t as teardown } from "./teardown-LB9cTnXJ.js";
+import { n as withWebGLContext, r as resolveRendering } from "./webgl-unavailable-N9nQqesw.js";
+import { a as openBundledEditor, c as claimCanvasGestures, i as devServerLibrary, l as audioErrors, n as pauseWhenHidden, o as poseFromRenderer, r as crossFade, s as wireDevChannel, t as teardown } from "./teardown-D2NEmxPB.js";
 import { o as frameStats } from "./frame-report-BSMny7oe.js";
-import { J as createCausticsQuad, K as Node3D, U as PhysicsBody3D, n as registerGameplayBehaviors } from "./gameplay-CGSv-9XR.js";
+import { J as createCausticsQuad, K as Node3D, U as PhysicsBody3D, n as registerGameplayBehaviors } from "./gameplay-DM1eu_cV.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-C-5g2pMh.js";
-import { n as enablePhysics3D } from "./physics-3d-i1IeAY0F.js";
+import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-CybQXNqS.js";
+import { n as enablePhysics3D } from "./physics-3d-bG3n70Ky.js";
 import { ACESFilmicToneMapping, AmbientLight, Box3, BufferAttribute, BufferGeometry, Color, DepthTexture, EquirectangularReflectionMapping, FloatType, Fog, HalfFloatType, LineBasicMaterial, LineSegments, 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";
@@ -87,22 +87,18 @@ var AssetStore3D = class {
 			url,
 			error
 		});
-		for (const [ref, url] of this.modelKeys) {
-			const entry = this.models.get(url);
-			if (entry?.error) out.push({
-				ref,
-				url,
-				error: String(entry.error)
-			});
-		}
-		for (const [ref, decl] of this.animationKeys) {
-			const entry = this.animations.get(decl.url);
-			if (entry?.error) out.push({
-				ref,
-				url: decl.url,
-				error: String(entry.error)
-			});
-		}
+		const modelRefs = new Map([...this.modelKeys].map(([ref, url]) => [url, ref]));
+		for (const [url, entry] of this.models) if (entry.error) out.push({
+			ref: modelRefs.get(url) ?? url,
+			url,
+			error: String(entry.error)
+		});
+		const clipRefs = new Map([...this.animationKeys].map(([ref, decl]) => [decl.url, ref]));
+		for (const [url, entry] of this.animations) if (entry.error) out.push({
+			ref: clipRefs.get(url) ?? url,
+			url,
+			error: String(entry.error)
+		});
 		return out;
 	}
 	/** Map a scene's `assets` header. */
@@ -1491,11 +1487,11 @@ var Renderer3D = class {
 			pixelRatio: opts.pixelRatio,
 			preserveDrawingBuffer: opts.preserveDrawingBuffer
 		});
-		this.webgl = new WebGLRenderer({
+		this.webgl = withWebGLContext(() => new WebGLRenderer({
 			canvas: opts.canvas,
 			antialias: rendering.antialias,
 			preserveDrawingBuffer: rendering.preserveDrawingBuffer
-		});
+		}));
 		this.webgl.info.autoReset = false;
 		this.engine.picker = (x, y) => this.pick(x, y);
 		this.basePixelRatio = rendering.pixelRatio;

package/dist/{create-game-DMetd3vR.js → create-game-IZIydDwI.js}

@@ -1,15 +1,15 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { d as computeViewport, f as resolveViewport, k as diagnose, n as loadScene, z as registerBehavior } from "./loader-KZESOZmE.js";
-import { _ as AudioPlayer, v as Engine } from "./register-Cs53CY7s.js";
+import { d as computeViewport, f as resolveViewport, k as diagnose, n as loadScene, z as registerBehavior } from "./loader-BC4PNtJX.js";
+import { _ as AudioPlayer, v as Engine } from "./register-3ta-2Xig.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as attachTouchControls } from "./touch-DEAmqGdf.js";
-import { t as resolveRendering } from "./rendering-options-ByAdi8PF.js";
-import { a as openBundledEditor, c as claimCanvasGestures, i as devServerLibrary, l as audioErrors, n as pauseWhenHidden, r as crossFade, s as wireDevChannel, t as teardown } from "./teardown-LB9cTnXJ.js";
+import { n as withWebGLContext, r as resolveRendering } from "./webgl-unavailable-N9nQqesw.js";
+import { a as openBundledEditor, c as claimCanvasGestures, i as devServerLibrary, l as audioErrors, n as pauseWhenHidden, r as crossFade, s as wireDevChannel, t as teardown } from "./teardown-D2NEmxPB.js";
 import { o as frameStats } from "./frame-report-BSMny7oe.js";
-import { n as registerGameplayBehaviors } from "./gameplay-CGSv-9XR.js";
-import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-vIxU3Xbv.js";
+import { n as registerGameplayBehaviors } from "./gameplay-DM1eu_cV.js";
+import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-ibCjm-wH.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { n as enablePhysics2D } from "./physics-2d-_B6zj3zU.js";
+import { n as enablePhysics2D } from "./physics-2d-B7Y6dPZO.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
 /**
@@ -445,11 +445,11 @@ var Renderer2D = class {
 			pixelRatio: 1,
 			preserveDrawingBuffer: false
 		}, globalThis.devicePixelRatio ?? 1, opts);
-		this.webgl = new WebGLRenderer({
+		this.webgl = withWebGLContext(() => new WebGLRenderer({
 			canvas: opts.canvas,
 			antialias: rendering.antialias,
 			preserveDrawingBuffer: rendering.preserveDrawingBuffer
-		});
+		}));
 		this.webgl.info.autoReset = false;
 		this.engine.picker = (x, y) => this.pick(x, y);
 		this.basePixelRatio = rendering.pixelRatio;

package/dist/debug.d.ts

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

package/dist/{duplicate-B8QnX2-r.js → duplicate-IWIqk0HJ.js}

@@ -1,4 +1,4 @@
-import { a as serializeNode, t as buildNodeJson } from "./loader-KZESOZmE.js";
+import { a as serializeNode, t as buildNodeJson } from "./loader-BC4PNtJX.js";
 //#region src/core/scene/duplicate.ts
 function stripUids(json) {
 	const { uid: _uid, ...rest } = json;

package/dist/{editor-switch-DAvWQeld.d.ts → editor-switch-CnIOiyNJ.d.ts}

@@ -1,4 +1,4 @@
-import { s as JsonObject } from "./schema-CFeioQRE.js";
+import { s as JsonObject } from "./schema-B6ugCV1Q.js";
 
 //#region src/core/diagnostics.d.ts
 /** The minimum an engine has to look like to receive a diagnostic. */

package/dist/editor.js

@@ -2398,19 +2398,25 @@ function Hn(e, t, n) {
 		t.mutate(() => {
 			t.working.dimension = r.value;
 		});
-	}), e.appendChild(B("dimension", r)), e.appendChild(Tr("physics", "physics"));
-	let i = (t.working.physics ?? {}).gravity ?? (t.working.dimension === "3d" ? [
+	}), e.appendChild(B("dimension", r));
+	let i = document.createElement("input");
+	i.type = "checkbox", i.checked = t.working.fragment === !0, i.addEventListener("change", () => {
+		t.mutate(() => {
+			i.checked ? t.working.fragment = !0 : delete t.working.fragment;
+		});
+	}), e.appendChild(B("fragment", i)), e.appendChild(Tr("physics", "physics"));
+	let a = (t.working.physics ?? {}).gravity ?? (t.working.dimension === "3d" ? [
 		0,
 		-9.81,
 		0
-	] : [0, 980]), a = t.working.dimension === "3d" ? [
+	] : [0, 980]), o = t.working.dimension === "3d" ? [
 		0,
 		-9.81,
 		0
 	] : [0, 980];
-	e.appendChild(Mr("gravity", i, (e) => {
+	e.appendChild(Mr("gravity", a, (e) => {
 		t.mutate(() => {
-			if (JSON.stringify(e) === JSON.stringify(a)) {
+			if (JSON.stringify(e) === JSON.stringify(o)) {
 				let e = { ...t.working.physics };
 				delete e.gravity, Object.keys(e).length === 0 ? delete t.working.physics : t.working.physics = e;
 			} else t.working.physics = {

package/dist/env.d.ts

@@ -1,4 +1,4 @@
-import { a as Rng, i as SceneJson, n as NodeJson, s as JsonObject } from "./schema-CFeioQRE.js";
+import { a as Rng, i as SceneJson, n as NodeJson, s as JsonObject } from "./schema-B6ugCV1Q.js";
 
 //#region src/env/arena.d.ts
 /** Valid `generateArena` themes — drives the catalog options AND validation. */

package/dist/{environment-presets-C-5g2pMh.js → environment-presets-CybQXNqS.js}

@@ -1,11 +1,11 @@
-import { k as diagnose } from "./loader-KZESOZmE.js";
-import { L as translateOn, t as registerCoreNodes } from "./register-Cs53CY7s.js";
+import { k as diagnose } from "./loader-BC4PNtJX.js";
+import { L as translateOn, t as registerCoreNodes } from "./register-3ta-2Xig.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
 import { i as getNodeSchema, l as registerNode } from "./registry-CF70EArN.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
 import { i as ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, r as validateAnimationAliases, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-CY-mrr1L.js";
-import { B as rejectScale, G as StaticBody3D, H as CharacterBody3D, K as Node3D, L as Water3D, U as PhysicsBody3D, V as Area3D, W as RigidBody3D, X as colliderFootDrop, w as tolerateUnknownAction, z as WaterCutout3D } from "./gameplay-CGSv-9XR.js";
+import { B as rejectScale, G as StaticBody3D, H as CharacterBody3D, I as worldPosition, K as Node3D, L as Water3D, U as PhysicsBody3D, V as Area3D, W as RigidBody3D, X as colliderFootDrop, w as tolerateUnknownAction, z as WaterCutout3D } from "./gameplay-DM1eu_cV.js";
 import { t as checkSheetGrid } from "./sheet-grid-BT6N_Bjs.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
 import { AdditiveBlending, AnimationClip, AnimationMixer, Box3, BoxGeometry, BufferAttribute, BufferGeometry, CanvasTexture, CapsuleGeometry, ClampToEdgeWrapping, Color, ConeGeometry, CylinderGeometry, DataTexture, DirectionalLight, DoubleSide, DynamicDrawUsage, Euler, Group, IcosahedronGeometry, ImageBitmapLoader, InstancedBufferAttribute, InstancedMesh, LinearFilter, LinearMipmapLinearFilter, LoopOnce, LoopRepeat, Matrix4, Mesh, MeshBasicMaterial, MeshDepthMaterial, MeshPhysicalMaterial, MeshStandardMaterial, NearestFilter, NoBlending, NoColorSpace, NormalBlending, PerspectiveCamera, PlaneGeometry, PointLight, Points, PointsMaterial, Quaternion, QuaternionKeyframeTrack, RGBADepthPacking, RGBAFormat, RepeatWrapping, SRGBColorSpace, ShaderChunk, ShaderMaterial, SphereGeometry, Texture, TextureLoader, UniformsLib, UniformsUtils, Vector3, Vector4, VectorKeyframeTrack } from "three";
@@ -2714,6 +2714,7 @@ var CharacterController3D = class extends Node3D {
 		pitchMin: { default: -1.3 },
 		pitchMax: { default: 1.5 },
 		cameraCollision: { default: true },
+		platformCarry: { default: true },
 		turnSpeed: { default: 100 },
 		camLerp: { default: 25 },
 		moveAction: { default: "move" },
@@ -2766,6 +2767,43 @@ var CharacterController3D = class extends Node3D {
 	pitchMax = 1.5;
 	/** Spring-arm: pull the orbit camera in front of walls/ground instead of clipping. */
 	cameraCollision = true;
+	/**
+	* Ride whatever you are standing on.
+	*
+	* `false` restores the old behaviour: the controller steers toward a target
+	* velocity in WORLD space, so standing still on a moving floor brakes you off
+	* it. Turn it off for a conveyor you want to be scenery.
+	*/
+	platformCarry = true;
+	/** The node the ground probe hit last step, and where it was. */
+	carriedBy = null;
+	carriedFrom = [0, 0];
+	/**
+	* How fast the floor is moving, in world units per second.
+	*
+	* From the POSITION DELTA, not `linearVelocity`, because the documented way
+	* to author a platform is to move its `position` — a behavior, a `PathFollow`,
+	* an `Oscillate` — and that path calls `body.setTranslation`, which teleports
+	* and carries no momentum at all. The delta sees both kinds.
+	*
+	* Only while grounded on the SAME node two steps running: the first step on a
+	* new platform has nothing to compare against, and inventing a velocity there
+	* would fling the player on every step onto one.
+	*/
+	groundCarry(ground, dt) {
+		if (!this.platformCarry || !this.grounded || !ground || dt <= 0) {
+			this.carriedBy = ground;
+			if (ground) this.carriedFrom = groundXZ(ground);
+			return [0, 0];
+		}
+		const at = groundXZ(ground);
+		const same = this.carriedBy === ground;
+		const was = this.carriedFrom;
+		this.carriedBy = ground;
+		this.carriedFrom = at;
+		if (!same) return [0, 0];
+		return [(at[0] - was[0]) / dt, (at[1] - was[1]) / dt];
+	}
 	turnSpeed = 100;
 	/** Camera smoothing rate (1-exp(-rate·dt)); side view uses 5. */
 	camLerp = 25;
@@ -2830,6 +2868,8 @@ var CharacterController3D = class extends Node3D {
 		const rayLen = radius + 2;
 		const originY = pos[1] - halfHeight;
 		let toi = null;
+		/** What the probe landed on — the platform, when there is one. */
+		let ground = null;
 		for (const [ox, oz] of [
 			[0, 0],
 			[radius, 0],
@@ -2848,11 +2888,15 @@ var CharacterController3D = class extends Node3D {
 			], rayLen, body);
 			if (hit) {
 				const d = hit.distance;
-				toi = toi === null ? d : Math.min(toi, d);
+				if (toi === null || d < toi) {
+					toi = d;
+					ground = hit.node;
+				}
 				if (ox === 0 && oz === 0) break;
 			}
 		}
 		this.grounded = toi !== null && toi < floatingDis * 2;
+		const carry = this.groundCarry(ground, dt);
 		const footed = toi !== null && toi < floatingDis * 1.3 && (vel[1] ?? 0) <= .5;
 		let mx = 0;
 		let mz = 0;
@@ -2877,17 +2921,17 @@ var CharacterController3D = class extends Node3D {
 		const speedMultiplier = 1 + (this.sprintMultiplier - 1) * intensity;
 		const targetSpeed = moving ? this.maxSpeed * speedMultiplier : 0;
 		const control = this.grounded ? 1 : this.airControl;
-		const ax = (mx * targetSpeed - vel[0]) / ACC_DELTA_TIME * control;
-		const az = (mz * targetSpeed - vel[2]) / ACC_DELTA_TIME * control;
+		const ax = (mx * targetSpeed + carry[0] - vel[0]) / ACC_DELTA_TIME * control;
+		const az = (mz * targetSpeed + carry[1] - vel[2]) / ACC_DELTA_TIME * control;
 		body.applyImpulse([
 			ax * mass,
 			0,
 			az * mass
 		]);
 		if (!moving && this.grounded) body.applyImpulse([
-			-vel[0] * DRAG_DAMPING * mass,
+			-(vel[0] - carry[0]) * DRAG_DAMPING * mass,
 			0,
-			-vel[2] * DRAG_DAMPING * mass
+			-(vel[2] - carry[1]) * DRAG_DAMPING * mass
 		]);
 		let springToi = toi;
 		if (this.stepHeight > 0 && moving && toi !== null && !this.jumping && (vel[1] ?? 0) <= .5) {
@@ -3137,6 +3181,11 @@ function worldOf(node) {
 * coyote time incoherent (a held button would re-fire through the whole
 * window). Undeclared actions are tolerated, and reported once.
 */
+/** A node's world x/z — the platform may itself be parented to something. */
+function groundXZ(node) {
+	const world = worldPosition(node);
+	return [world[0] ?? 0, world[2] ?? 0];
+}
 //#endregion
 //#region src/3d/vegetation/grass-placement.ts
 const NOISE_SCALE = .15;

package/dist/{gameplay-CGSv-9XR.js → gameplay-DM1eu_cV.js}

@@ -1,7 +1,7 @@
-import { O as Node, P as Behavior, _ as SaveSlots, k as diagnose, n as loadScene, w as effectiveOrder, z as registerBehavior } from "./loader-KZESOZmE.js";
+import { O as Node, P as Behavior, _ as SaveSlots, k as diagnose, n as loadScene, w as effectiveOrder, z as registerBehavior } from "./loader-BC4PNtJX.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as jsonClone } from "./json-CwwhxQgb.js";
-import { t as duplicateNode } from "./duplicate-B8QnX2-r.js";
+import { t as duplicateNode } from "./duplicate-IWIqk0HJ.js";
 import { Color, CubeCamera, DepthTexture, DoubleSide, Euler, FloatType, Frustum, HalfFloatType, LinearMipmapLinearFilter, MathUtils, Matrix4, Mesh, MeshDepthMaterial, Object3D, PerspectiveCamera, Plane, PlaneGeometry, Quaternion, ShaderMaterial, Sphere, Vector2, Vector3, Vector4, WebGLCubeRenderTarget, WebGLRenderTarget } from "three";
 //#region src/3d/frustum.ts
 const scratchFrustum = new Frustum();
@@ -6675,6 +6675,20 @@ var SavePoint = class extends Behavior {
 		this.slots ??= new SaveSlots(this.game);
 		return this.slots;
 	}
+	/**
+	* Has this run already said the saves are going nowhere?
+	*
+	* `saved(slot)` is the engine's own instrument for "it saved", and it fired
+	* identically in a private window where the write landed in a Map that dies
+	* with the tab. In-session everything looked healthy — the slot read back,
+	* `slotScene()` answered — and across the reload the score went 5 to 0 and
+	* `list()` went `["1"]` to `[]`, with `engine.log.entries().length = 0` and
+	* `stats().errors = 0` in every phase. Byte-identical to a healthy control.
+	*
+	* So it goes through `engine.log`, not just the console: that is what
+	* `incanto-logs` reads and what the `says` rung reports.
+	*/
+	warnedVolatile = false;
 	pendingRestore = false;
 	pendingProbe = false;
 	onReady() {
@@ -6734,6 +6748,10 @@ var SavePoint = class extends Behavior {
 			savedAt: Date.now(),
 			playtime: Math.round(this.elapsed)
 		});
+		if (!this.store().persistent && !this.warnedVolatile) {
+			this.warnedVolatile = true;
+			engine.log.warn(`SavePoint wrote slot '${this.slot}' to memory, not to disk — this browser refused localStorage (private window, storage disabled, or quota exhausted), so the run is lost when the page closes. \`SaveSlots.persistent\` is how a game asks before promising the player anything.`);
+		}
 		this.emit("saved", this.slot);
 	}
 	/**

package/dist/gameplay.d.ts

@@ -1,5 +1,5 @@
-import { b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, t as Behavior } from "./behavior-ZnfzKDo3.js";
-import { c as JsonValue, s as JsonObject } from "./schema-CFeioQRE.js";
+import { b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, t as Behavior } from "./behavior-DoFPYrgo.js";
+import { c as JsonValue, s as JsonObject } from "./schema-B6ugCV1Q.js";
 
 //#region src/gameplay/chase.d.ts
 /**
@@ -558,6 +558,20 @@ declare class SavePoint extends Behavior {
   private elapsed;
   private slots;
   private store;
+  /**
+  * Has this run already said the saves are going nowhere?
+  *
+  * `saved(slot)` is the engine's own instrument for "it saved", and it fired
+  * identically in a private window where the write landed in a Map that dies
+  * with the tab. In-session everything looked healthy — the slot read back,
+  * `slotScene()` answered — and across the reload the score went 5 to 0 and
+  * `list()` went `["1"]` to `[]`, with `engine.log.entries().length = 0` and
+  * `stats().errors = 0` in every phase. Byte-identical to a healthy control.
+  *
+  * So it goes through `engine.log`, not just the console: that is what
+  * `incanto-logs` reads and what the `says` rung reports.
+  */
+  private warnedVolatile;
   private pendingRestore;
   private pendingProbe;
   override onReady(): void;
@@ -1071,6 +1085,40 @@ declare class PathFollow extends Behavior {
   override update(dt: number): void;
 }
 //#endregion
+//#region src/gameplay/spatial.d.ts
+/**
+* A node's position with every spatial ancestor's added in.
+*
+* The tree composes transforms for DRAWING — three does it for free — and every
+* piece of engine logic that reads `node.position` gets the LOCAL number
+* instead. Physics already knew (`worldPosition2D`/`worldPosition3D` in the
+* adapters); the camera did not, and neither did anything that chases a target.
+*
+* A camera parented to the player is the Godot and Phaser idiom, and the
+* authoring skill explicitly permits it — *"EVERY node type can hold children …
+* any node works as a grouping container"*. Measured on exactly that scene:
+*
+* ```
+* player world position : [1400, 900]
+* renderer view centre  : {"x":0,"y":0}
+* framing               : camera /Level/Player/Cam centred [1400, 900]
+*                         1 in view, 0 outside it
+* ```
+*
+* The renderer drew empty world 1600 px from the player while `framing` — the
+* instrument the skills tell you to trust before handing a game back —
+* certified the player on screen.
+*
+* Arity comes from the node itself: a 2D node has two components, a 3D node
+* three, and an ancestor that is neither contributes nothing.
+*/
+declare function worldPosition(node: Node): number[];
+/**
+* Turn a world position into the local one `node.position` has to hold for the
+* node to END UP there — the inverse of `worldPosition` for its parent chain.
+*/
+declare function localFromWorld(node: Node, world: readonly number[]): number[];
+//#endregion
 //#region src/gameplay/index.d.ts
 /** Every built-in gameplay behavior, keyed by its registration name. */
 declare const GAMEPLAY_BEHAVIORS: Readonly<Record<string, BehaviorCtor>>;
@@ -1083,4 +1131,4 @@ declare function registerGameplayBehaviors(opts?: {
   replace?: boolean;
 }): void;
 //#endregion
-export { CameraShake, Chase, Collector, Cooldown, Currency, DamageOnContact, DayNight, type DayPhase, FaceTarget, FloatAway, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, type GameFlowState, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, SavePoint, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };
+export { CameraShake, Chase, Collector, Cooldown, Currency, DamageOnContact, DayNight, type DayPhase, FaceTarget, FloatAway, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, type GameFlowState, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, SavePoint, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, localFromWorld, phaseOf, registerGameplayBehaviors, restartScene, screenFlash, worldPosition };

package/dist/gameplay.js

@@ -1,2 +1,2 @@
-import { A as DamageOnContact, C as restartScene, D as FaceTarget, E as FloatAway, M as Currency, N as Collector, O as DayNight, P as Chase, S as goToScene, T as FollowCamera, _ as Cooldown, a as Wander, b as Interactable, c as SavePoint, d as Patrol, f as PathFollow, g as CameraShake, h as Lifetime, i as WaveSpawner, j as Health, k as phaseOf, l as Projectile, m as MoveTo, n as registerGameplayBehaviors, o as Spawner, p as Oscillate, r as ZombieAI, s as ScoreKeeper, t as GAMEPLAY_BEHAVIORS, u as Pickup, v as hitStop, x as GameFlow, y as screenFlash } from "./gameplay-CGSv-9XR.js";
-export { CameraShake, Chase, Collector, Cooldown, Currency, DamageOnContact, DayNight, FaceTarget, FloatAway, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, SavePoint, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };
+import { A as DamageOnContact, C as restartScene, D as FaceTarget, E as FloatAway, F as localFromWorld, I as worldPosition, M as Currency, N as Collector, O as DayNight, P as Chase, S as goToScene, T as FollowCamera, _ as Cooldown, a as Wander, b as Interactable, c as SavePoint, d as Patrol, f as PathFollow, g as CameraShake, h as Lifetime, i as WaveSpawner, j as Health, k as phaseOf, l as Projectile, m as MoveTo, n as registerGameplayBehaviors, o as Spawner, p as Oscillate, r as ZombieAI, s as ScoreKeeper, t as GAMEPLAY_BEHAVIORS, u as Pickup, v as hitStop, x as GameFlow, y as screenFlash } from "./gameplay-DM1eu_cV.js";
+export { CameraShake, Chase, Collector, Cooldown, Currency, DamageOnContact, DayNight, FaceTarget, FloatAway, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, SavePoint, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, localFromWorld, phaseOf, registerGameplayBehaviors, restartScene, screenFlash, worldPosition };

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { $ as T_PREFIX, A as SettingsValues, At as BusName, B as captureBehaviors, C as EngineStats, Ct as sfxDuration, Dt as MusicTrack, E as DeviceHints, Et as MusicManager, F as BehaviorState, Ft as LogLevel, G as ORDER_GROUP_BASE, H as savesWithoutUid, I as RestoreReport, It as LogManager, J as effectiveOrder, K as OrderGroup, L as SaveSlot, Lt as Signal, M as readDeviceHints, Mt as NodeLifecycle, N as suggestQuality, Nt as SceneTree, O as QualityTier, Ot as PlayMusicOptions, P as Scene, Pt as LogEntry, Q as Localization, R as SaveSlots, Rt as SignalListener, S as Scheduler, St as SynthOptions, T as RendererStats, Tt as MusicBackend, U as SaveStore, V as restoreBehaviors, W as createSaveStore, X as BASE_LOCALE, Y as resolveOrderGroups, Z as LocaleTables, _ as mergeStaticSignals, _t as spatialPan, a as clearBehaviors, at as EffectLog, b as Engine, bt as SfxParams, c as registeredBehaviors, ct as isAudioContextAvailable, d as PropSchema, dt as Listener, et as suggestLocale, f as clearRegistry, ft as ROLLOFF_MODELS, g as getNodeType, gt as spatialGain, h as getNodeSignals, ht as Vec3, i as behaviorSignals, it as EffectKind, j as qualityEnvironment, jt as Node, k as Settings, kt as AudioBuses, l as NodeCtor, lt as Voice, m as getNodeSchema, mt as SpatialParams, n as BehaviorCtor, nt as InputMap, o as getBehavior, ot as SfxEngine, p as createNode, pt as RolloffModel, q as OrderGroupTable, r as behaviorSchema, rt as EffectEvent, s as registerBehavior, st as SfxPlayOptions, t as Behavior, tt as translationKey, u as PropDef, ut as VoicePreset, v as registerNode, vt as SFX_PRESETS, w as GameStats, wt as synthSfx, x as EngineOptions, xt as SfxWave, y as registeredTypes, yt as SFX_PRESET_NAMES, z as behaviorsWithoutSave } from "./behavior-ZnfzKDo3.js";
-import { a as Rng, c as JsonValue, d as jsonKind, i as SceneJson, l as jsonClone, n as NodeJson, o as JsonKind, r as SCENE_FORMAT, s as JsonObject, t as ConnectionJson, u as jsonEquals } from "./schema-CFeioQRE.js";
-import { n as loadScene, t as LoadSceneOptions } from "./loader-DyT30ArB.js";
+import { a as ParticleSimConfig, c as showBootFailure, i as ParticleSim, n as AudioPlayer, o as ParticleView, s as isWebGLAvailable, t as AudioElementLike } from "./audio-player-DOrq7sP-.js";
+import { $ as T_PREFIX, A as SettingsValues, At as BusName, B as captureBehaviors, C as EngineStats, Ct as sfxDuration, Dt as MusicTrack, E as DeviceHints, Et as MusicManager, F as BehaviorState, Ft as LogLevel, G as ORDER_GROUP_BASE, H as savesWithoutUid, I as RestoreReport, It as LogManager, J as effectiveOrder, K as OrderGroup, L as SaveSlot, Lt as Signal, M as readDeviceHints, Mt as NodeLifecycle, N as suggestQuality, Nt as SceneTree, O as QualityTier, Ot as PlayMusicOptions, P as Scene, Pt as LogEntry, Q as Localization, R as SaveSlots, Rt as SignalListener, S as Scheduler, St as SynthOptions, T as RendererStats, Tt as MusicBackend, U as SaveStore, V as restoreBehaviors, W as createSaveStore, X as BASE_LOCALE, Y as resolveOrderGroups, Z as LocaleTables, _ as mergeStaticSignals, _t as spatialPan, a as clearBehaviors, at as EffectLog, b as Engine, bt as SfxParams, c as registeredBehaviors, ct as isAudioContextAvailable, d as PropSchema, dt as Listener, et as suggestLocale, f as clearRegistry, ft as ROLLOFF_MODELS, g as getNodeType, gt as spatialGain, h as getNodeSignals, ht as Vec3, i as behaviorSignals, it as EffectKind, j as qualityEnvironment, jt as Node, k as Settings, kt as AudioBuses, l as NodeCtor, lt as Voice, m as getNodeSchema, mt as SpatialParams, n as BehaviorCtor, nt as InputMap, o as getBehavior, ot as SfxEngine, p as createNode, pt as RolloffModel, q as OrderGroupTable, r as behaviorSchema, rt as EffectEvent, s as registerBehavior, st as SfxPlayOptions, t as Behavior, tt as translationKey, u as PropDef, ut as VoicePreset, v as registerNode, vt as SFX_PRESETS, w as GameStats, wt as synthSfx, x as EngineOptions, xt as SfxWave, y as registeredTypes, yt as SFX_PRESET_NAMES, z as behaviorsWithoutSave } from "./behavior-DoFPYrgo.js";
+import { a as Rng, c as JsonValue, d as jsonKind, i as SceneJson, l as jsonClone, n as NodeJson, o as JsonKind, r as SCENE_FORMAT, s as JsonObject, t as ConnectionJson, u as jsonEquals } from "./schema-B6ugCV1Q.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-CcB533FR.js";
 import { i as resolveFrames, n as AnimationEntry, r as resolveAnimation, t as AnimationDef } from "./sprite-animation-CMr6f1K2.js";
-import { a as ParticleSimConfig, i as ParticleSim, n as AudioPlayer, o as ParticleView, t as AudioElementLike } from "./audio-player-BNUHo0JF.js";
 import { i as gridFromRows, n as PathGrid, r as findPath, t as FindPathOptions } from "./pathfinding-_fGrCFmH.js";
-import { a as startRecording, c as IncantoErrorDetails, i as replay, l as auditScene, n as ReplayEvent, o as IncantoError, r as ReplayJson, s as IncantoErrorCode, t as Recorder } from "./replay-D0GcEHYU.js";
+import { a as startRecording, c as IncantoErrorDetails, i as replay, l as auditScene, n as ReplayEvent, o as IncantoError, r as ReplayJson, s as IncantoErrorCode, t as Recorder } from "./replay-Dvn8aeBd.js";
 
 //#region src/core/audio/crossfade.d.ts
 /**
@@ -1309,4 +1309,4 @@ declare function computeViewport(canvasW: number, canvasH: number, viewport: {
 /** Engine version. Kept in sync with package.json by the release pipeline. */
 declare const VERSION: string;
 //#endregion
-export { type AnimationDef, type AnimationEntry, type AssetFailure, AudioBuses, type AudioElementLike, AudioPlayer, BASE_LOCALE, Behavior, type BehaviorCtor, type BehaviorState, type BusName, CONST_REF_KEY, type ComputedViewport, type ConnectionJson, type CrossfadeGains, type DebugLineSource, type DeviceHints, type DriveScript, type DriveStep, type EffectEvent, type EffectKind, EffectLog, Engine, type EngineOptions, type EngineStats, type FindPathOptions, type GameStats, type GroupedLog, type HudAnchor, HudLayer, IncantoError, type IncantoErrorCode, type IncantoErrorDetails, InputMap, type JsonKind, type JsonObject, type JsonValue, type Listener, type LiveInput, type LiveReport, type LoadSceneOptions, type LocaleTables, Localization, type LogEntry, type LogLevel, LogManager, type MusicBackend, MusicManager, type MusicTrack, Node, type NodeCtor, type NodeJson, type NodeLifecycle, ORDER_GROUP_BASE, type OrderGroup, type OrderGroupTable, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, type ParsedNodePath, type ParticlePresetValues, ParticleSim, type ParticleSimConfig, type ParticleView, type PathGrid, type PlayMusicOptions, type PreloadResult, type PropDef, type PropSchema, type QualityTier, ROLLOFF_MODELS, type Recorder, type RefNode, type RefProblem, type RefResult, type RendererStats, type ReplayEvent, type ReplayJson, type ResolvedRendering, type ResolvedViewport, Respawn, type RestoreReport, Rng, type RolloffModel, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, type SaveSlot, SaveSlots, type SaveStore, Scene, type SceneJson, SceneTree, type Scheduler, Settings, type SettingsValues, SfxEngine, type SfxParams, type SfxPlayOptions, type SfxWave, Signal, type SignalListener, type SpatialParams, type SynthOptions, T_PREFIX, Timer, TouchControls, type TouchControlsOptions, UiBanner, UiBar, UiButton, UiDialogue, UiFrameCapSelect, UiImage, UiLanguageSelect, UiMuteToggle, UiPanel, UiQualitySelect, UiRenderScaleSelect, UiSelect, UiSlider, UiText, UiToggle, UiVolumeSlider, VERSION, type Vec3, type ViewportFit, type Voice, type VoicePreset, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, describeRefProblem, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, logReport, logText, mergeStaticSignals, newUid, nodeRefWarnings, parseDrive, parseNodePath, preloadSceneAssets, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveAnimation, resolveConstants, resolveFrames, resolveOrderGroups, resolveRefInJson, resolveRendering, resolveViewport, restoreBehaviors, savesWithoutUid, serializeNode, sfxDuration, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };
+export { type AnimationDef, type AnimationEntry, type AssetFailure, AudioBuses, type AudioElementLike, AudioPlayer, BASE_LOCALE, Behavior, type BehaviorCtor, type BehaviorState, type BusName, CONST_REF_KEY, type ComputedViewport, type ConnectionJson, type CrossfadeGains, type DebugLineSource, type DeviceHints, type DriveScript, type DriveStep, type EffectEvent, type EffectKind, EffectLog, Engine, type EngineOptions, type EngineStats, type FindPathOptions, type GameStats, type GroupedLog, type HudAnchor, HudLayer, IncantoError, type IncantoErrorCode, type IncantoErrorDetails, InputMap, type JsonKind, type JsonObject, type JsonValue, type Listener, type LiveInput, type LiveReport, type LoadSceneOptions, type LocaleTables, Localization, type LogEntry, type LogLevel, LogManager, type MusicBackend, MusicManager, type MusicTrack, Node, type NodeCtor, type NodeJson, type NodeLifecycle, ORDER_GROUP_BASE, type OrderGroup, type OrderGroupTable, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, type ParsedNodePath, type ParticlePresetValues, ParticleSim, type ParticleSimConfig, type ParticleView, type PathGrid, type PlayMusicOptions, type PreloadResult, type PropDef, type PropSchema, type QualityTier, ROLLOFF_MODELS, type Recorder, type RefNode, type RefProblem, type RefResult, type RendererStats, type ReplayEvent, type ReplayJson, type ResolvedRendering, type ResolvedViewport, Respawn, type RestoreReport, Rng, type RolloffModel, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, type SaveSlot, SaveSlots, type SaveStore, Scene, type SceneJson, SceneTree, type Scheduler, Settings, type SettingsValues, SfxEngine, type SfxParams, type SfxPlayOptions, type SfxWave, Signal, type SignalListener, type SpatialParams, type SynthOptions, T_PREFIX, Timer, TouchControls, type TouchControlsOptions, UiBanner, UiBar, UiButton, UiDialogue, UiFrameCapSelect, UiImage, UiLanguageSelect, UiMuteToggle, UiPanel, UiQualitySelect, UiRenderScaleSelect, UiSelect, UiSlider, UiText, UiToggle, UiVolumeSlider, VERSION, type Vec3, type ViewportFit, type Voice, type VoicePreset, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, describeRefProblem, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, isWebGLAvailable, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, logReport, logText, mergeStaticSignals, newUid, nodeRefWarnings, parseDrive, parseNodePath, preloadSceneAssets, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveAnimation, resolveConstants, resolveFrames, resolveOrderGroups, resolveRefInJson, resolveRendering, resolveViewport, restoreBehaviors, savesWithoutUid, serializeNode, sfxDuration, showBootFailure, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/index.js

@@ -1,14 +1,15 @@
-import { A as describeRefProblem, B as registeredBehaviors, C as ORDER_GROUP_BASE, E as InputMap, F as behaviorSchema, I as behaviorSignals, L as clearBehaviors, M as resolveRefInJson, N as parseNodePath, O as Node, P as Behavior, R as getBehavior, S as createSaveStore, T as resolveOrderGroups, V as Signal, _ as SaveSlots, a as serializeNode, b as restoreBehaviors, d as computeViewport, f as resolveViewport, g as resolveConstants, h as isConstRef, i as Scene, j as nodeRefWarnings, m as CONST_REF_KEY, n as loadScene, o as SCENE_FORMAT, p as SceneTree, v as behaviorsWithoutSave, w as effectiveOrder, x as savesWithoutUid, y as captureBehaviors, z as registerBehavior } from "./loader-KZESOZmE.js";
-import { A as UiBanner, B as isAudioContextAvailable, D as EffectLog, E as LogManager, F as T_PREFIX, G as SFX_PRESET_NAMES, H as spatialGain, I as suggestLocale, J as MusicManager, K as sfxDuration, M as UiText, N as BASE_LOCALE, O as HudLayer, P as Localization, Q as AudioBuses, R as translationKey, S as qualityEnvironment, T as suggestQuality, U as spatialPan, V as ROLLOFF_MODELS, W as SFX_PRESETS, X as crossfadeGains, Y as WebAudioMusicBackend, Z as fadeGain, _ as AudioPlayer, a as UiMuteToggle, b as Settings, c as UiRenderScaleSelect, d as UiToggle, f as UiVolumeSlider, g as UiDialogue, h as UiButton, i as UiLanguageSelect, j as UiBar, l as UiSelect, m as Respawn, n as UiFrameCapSelect, o as UiPanel, p as Timer, q as synthSfx, r as UiImage, s as UiQualitySelect, t as registerCoreNodes, u as UiSlider, v as Engine, w as readDeviceHints, z as SfxEngine } from "./register-Cs53CY7s.js";
+import { A as describeRefProblem, B as registeredBehaviors, C as ORDER_GROUP_BASE, E as InputMap, F as behaviorSchema, I as behaviorSignals, L as clearBehaviors, M as resolveRefInJson, N as parseNodePath, O as Node, P as Behavior, R as getBehavior, S as createSaveStore, T as resolveOrderGroups, V as Signal, _ as SaveSlots, a as serializeNode, b as restoreBehaviors, d as computeViewport, f as resolveViewport, g as resolveConstants, h as isConstRef, i as Scene, j as nodeRefWarnings, m as CONST_REF_KEY, n as loadScene, o as SCENE_FORMAT, p as SceneTree, v as behaviorsWithoutSave, w as effectiveOrder, x as savesWithoutUid, y as captureBehaviors, z as registerBehavior } from "./loader-BC4PNtJX.js";
+import { A as UiBanner, B as isAudioContextAvailable, D as EffectLog, E as LogManager, F as T_PREFIX, G as SFX_PRESET_NAMES, H as spatialGain, I as suggestLocale, J as MusicManager, K as sfxDuration, M as UiText, N as BASE_LOCALE, O as HudLayer, P as Localization, Q as AudioBuses, R as translationKey, S as qualityEnvironment, T as suggestQuality, U as spatialPan, V as ROLLOFF_MODELS, W as SFX_PRESETS, X as crossfadeGains, Y as WebAudioMusicBackend, Z as fadeGain, _ as AudioPlayer, a as UiMuteToggle, b as Settings, c as UiRenderScaleSelect, d as UiToggle, f as UiVolumeSlider, g as UiDialogue, h as UiButton, i as UiLanguageSelect, j as UiBar, l as UiSelect, m as Respawn, n as UiFrameCapSelect, o as UiPanel, p as Timer, q as synthSfx, r as UiImage, s as UiQualitySelect, t as registerCoreNodes, u as UiSlider, v as Engine, w as readDeviceHints, z as SfxEngine } from "./register-3ta-2Xig.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
 import { n as jsonEquals, r as jsonKind, t as jsonClone } from "./json-CwwhxQgb.js";
 import { a as getNodeSignals, c as mergeStaticSignals, i as getNodeSchema, l as registerNode, n as clearRegistry, o as getNodeType, r as createNode, u as registeredTypes } from "./registry-CF70EArN.js";
 import { i as joystickVector, n as attachTouchControls, t as TouchControls } from "./touch-DEAmqGdf.js";
-import { n as startRecording, r as auditScene, t as replay } from "./replay-BkpDV51O.js";
-import { i as parseDrive, n as logReport, r as logText, t as resolveRendering } from "./rendering-options-ByAdi8PF.js";
+import { n as startRecording, r as auditScene, t as replay } from "./replay-CYvhVHHN.js";
+import { t as showBootFailure } from "./boot-failure-CKYrEcGF.js";
+import { a as logText, i as logReport, o as parseDrive, r as resolveRendering, t as isWebGLAvailable } from "./webgl-unavailable-N9nQqesw.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
 import { a as PARTICLE_PRESETS, i as ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-CY-mrr1L.js";
-import { a as preloadUrls, i as preloadSceneAssets, n as newUid, o as findPath, r as assetUrls, s as gridFromRows, t as VERSION } from "./src-BLlsGJW9.js";
-import { t as duplicateNode } from "./duplicate-B8QnX2-r.js";
-export { AudioBuses, AudioPlayer, BASE_LOCALE, Behavior, CONST_REF_KEY, EffectLog, Engine, HudLayer, IncantoError, InputMap, Localization, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Respawn, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, SaveSlots, Scene, SceneTree, Settings, SfxEngine, Signal, T_PREFIX, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiFrameCapSelect, UiImage, UiLanguageSelect, UiMuteToggle, UiPanel, UiQualitySelect, UiRenderScaleSelect, UiSelect, UiSlider, UiText, UiToggle, UiVolumeSlider, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, describeRefProblem, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, logReport, logText, mergeStaticSignals, newUid, nodeRefWarnings, parseDrive, parseNodePath, preloadSceneAssets, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveAnimation, resolveConstants, resolveFrames, resolveOrderGroups, resolveRefInJson, resolveRendering, resolveViewport, restoreBehaviors, savesWithoutUid, serializeNode, sfxDuration, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };
+import { a as preloadUrls, i as preloadSceneAssets, n as newUid, o as findPath, r as assetUrls, s as gridFromRows, t as VERSION } from "./src-D7RIqXYF.js";
+import { t as duplicateNode } from "./duplicate-IWIqk0HJ.js";
+export { AudioBuses, AudioPlayer, BASE_LOCALE, Behavior, CONST_REF_KEY, EffectLog, Engine, HudLayer, IncantoError, InputMap, Localization, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Respawn, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, SaveSlots, Scene, SceneTree, Settings, SfxEngine, Signal, T_PREFIX, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiFrameCapSelect, UiImage, UiLanguageSelect, UiMuteToggle, UiPanel, UiQualitySelect, UiRenderScaleSelect, UiSelect, UiSlider, UiText, UiToggle, UiVolumeSlider, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, describeRefProblem, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, isWebGLAvailable, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, logReport, logText, mergeStaticSignals, newUid, nodeRefWarnings, parseDrive, parseNodePath, preloadSceneAssets, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveAnimation, resolveConstants, resolveFrames, resolveOrderGroups, resolveRefInJson, resolveRendering, resolveViewport, restoreBehaviors, savesWithoutUid, serializeNode, sfxDuration, showBootFailure, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/{loader-KZESOZmE.js → loader-BC4PNtJX.js}

@@ -1570,10 +1570,16 @@ function effectiveOrder(group, renderOrder, table = ORDER_GROUP_BASE) {
 //#endregion
 //#region src/core/save.ts
 const memoryStores = /* @__PURE__ */ new Map();
+/** Namespaces already warned about, so a per-frame save cannot spam the console. */
+const warnedVolatile = /* @__PURE__ */ new Set();
 function createSaveStore(namespace) {
 	const prefix = `incanto:${namespace}:`;
 	const local = storageOrNull();
 	if (!local) {
+		if (typeof localStorage !== "undefined" && !warnedVolatile.has(namespace)) {
+			warnedVolatile.add(namespace);
+			console.warn(`[incanto] this browser refused localStorage, so saves for '${namespace}' live in memory and are lost when the page closes (private window, storage disabled, or quota exhausted). Check \`store.persistent\` and tell the player.`);
+		}
 		let mem = memoryStores.get(namespace);
 		if (!mem) {
 			mem = /* @__PURE__ */ new Map();
@@ -1581,6 +1587,7 @@ function createSaveStore(namespace) {
 		}
 		const backing = mem;
 		return {
+			persistent: false,
 			get: (key, fallback) => parse(backing.get(key), fallback),
 			set: (key, value) => void backing.set(key, JSON.stringify(value)),
 			remove: (key) => void backing.delete(key),
@@ -1588,6 +1595,7 @@ function createSaveStore(namespace) {
 		};
 	}
 	return {
+		persistent: true,
 		get: (key, fallback) => parse(local.getItem(prefix + key) ?? void 0, fallback),
 		set: (key, value) => local.setItem(prefix + key, JSON.stringify(value)),
 		remove: (key) => local.removeItem(prefix + key),
@@ -1834,6 +1842,17 @@ var SaveSlots = class {
 	constructor(namespace = "saves", store) {
 		this.store = store ?? createSaveStore(namespace);
 	}
+	/**
+	* Will these slots survive the page closing?
+	*
+	* `false` in a private window, with storage disabled, or headless — every
+	* write still succeeds and every read still answers, for as long as the tab
+	* lives. A load menu should say so instead of offering a slot that will not
+	* be there tomorrow.
+	*/
+	get persistent() {
+		return this.store.persistent !== false;
+	}
 	/** Slot ids that have a save, newest first. */
 	list() {
 		const rows = this.store.get(INDEX_KEY, []).map((id) => ({
@@ -2850,6 +2869,8 @@ var Scene = class {
 	orderGroups;
 	/** Physics config (gravity etc. — interpreted by the physics modules). */
 	physics;
+	/** Declared piece of another scene — see `SceneJson.fragment`. */
+	fragment;
 	/** Multiplayer config (room etc. — interpreted by incanto/net). */
 	multiplayer;
 	/** Design-resolution viewport (consumed by renderers via resolveViewport). */
@@ -2869,6 +2890,7 @@ var Scene = class {
 		this.orderGroups = source.orderGroups ? { ...source.orderGroups } : void 0;
 		this.strings = source.strings ? jsonClone(source.strings) : void 0;
 		this.physics = source.physics ? jsonClone(source.physics) : void 0;
+		this.fragment = source.fragment === true ? true : void 0;
 		this.multiplayer = source.multiplayer ? jsonClone(source.multiplayer) : void 0;
 		this.environment = source.environment ? jsonClone(source.environment) : void 0;
 		this.viewport = source.viewport ? jsonClone(source.viewport) : void 0;
@@ -2887,6 +2909,7 @@ var Scene = class {
 			...this.orderGroups ? { orderGroups: { ...this.orderGroups } } : {},
 			...this.strings ? { strings: jsonClone(this.strings) } : {},
 			...this.physics ? { physics: jsonClone(this.physics) } : {},
+			...this.fragment ? { fragment: true } : {},
 			...this.multiplayer ? { multiplayer: jsonClone(this.multiplayer) } : {},
 			...this.environment ? { environment: jsonClone(this.environment) } : {},
 			...this.viewport ? { viewport: jsonClone(this.viewport) } : {},
@@ -3063,6 +3086,7 @@ function validateHeader(json) {
 	if (json.format !== 1) throw new IncantoError("BAD_FORMAT", `Unsupported scene format ${JSON.stringify(json.format)}; this engine reads format 1.`);
 	if (json.type !== "scene") throw new IncantoError("BAD_FORMAT", `Expected "type": "scene", got ${JSON.stringify(json.type)}.`);
 	if (typeof json.name !== "string" || json.name === "") throw new IncantoError("BAD_FORMAT", "Scene \"name\" must be a non-empty string.");
+	if (json.fragment !== void 0 && typeof json.fragment !== "boolean") throw new IncantoError("BAD_FORMAT", `Scene "fragment" must be true or false, got ${JSON.stringify(json.fragment)}.`);
 	if (json.dimension !== void 0 && json.dimension !== "2d" && json.dimension !== "3d") throw new IncantoError("BAD_FORMAT", `Scene "dimension" must be "2d" or "3d", got ${JSON.stringify(json.dimension)}.`);
 	if (typeof json.root !== "object" || json.root === null) throw new IncantoError("BAD_FORMAT", "Scene \"root\" must be a node object.");
 	resolveViewport(json.viewport);
@@ -3154,10 +3178,11 @@ const SCENE_KEYS = [
 	"environment",
 	"strings",
 	"physics",
+	"fragment",
 	"root",
 	"connections"
 ];
-/** Closest known key by edit distance — only a genuinely близкая one. */
+/** Closest known key by edit distance — only a genuinely near one. */
 function nearestKey(key, known) {
 	const lower = key.toLowerCase();
 	let best = null;

package/dist/{loader-DyT30ArB.d.ts → loader-CcB533FR.d.ts}

@@ -1,5 +1,5 @@
-import { P as Scene, b as Engine } from "./behavior-ZnfzKDo3.js";
-import { i as SceneJson } from "./schema-CFeioQRE.js";
+import { P as Scene, b as Engine } from "./behavior-DoFPYrgo.js";
+import { i as SceneJson } from "./schema-B6ugCV1Q.js";
 
 //#region src/core/scene/loader.d.ts
 interface LoadSceneOptions {

package/dist/net.d.ts

@@ -1,5 +1,5 @@
-import { d as PropSchema, jt as Node } from "./behavior-ZnfzKDo3.js";
-import { a as NetworkManagerOptions, c as LocalGameServer, d as ServerClass, f as createLocalGameServer, g as Unsubscribe, h as NetworkTransport, i as NetworkManager, l as LocalGameServerOptions, m as LoopbackTransport, n as SplitScreenPlayer, o as applySyncPatch, p as LoopbackHub, r as createSplitScreen, s as CollectionOptions, t as SplitScreenOptions, u as LocalGameServerTransport } from "./split-screen-DD5eYIgW.js";
+import { d as PropSchema, jt as Node } from "./behavior-DoFPYrgo.js";
+import { a as NetworkManagerOptions, c as LocalGameServer, d as ServerClass, f as createLocalGameServer, g as Unsubscribe, h as NetworkTransport, i as NetworkManager, l as LocalGameServerOptions, m as LoopbackTransport, n as SplitScreenPlayer, o as applySyncPatch, p as LoopbackHub, r as createSplitScreen, s as CollectionOptions, t as SplitScreenOptions, u as LocalGameServerTransport } from "./split-screen-DhrSzZIB.js";
 
 //#region src/net/agent8.d.ts
 /**

package/dist/net.js

@@ -1,3 +1,3 @@
 import { n as createAgent8Server } from "./agent8-CvsfVskX.js";
-import { a as NetworkManager, d as createLocalGameServer, f as LoopbackHub, l as LocalGameServer, n as registerNodesNet, o as applySyncPatch, p as LoopbackTransport, r as NetworkSpawner, t as createSplitScreen, u as LocalGameServerTransport } from "./split-screen-DS8RaUV_.js";
+import { a as NetworkManager, d as createLocalGameServer, f as LoopbackHub, l as LocalGameServer, n as registerNodesNet, o as applySyncPatch, p as LoopbackTransport, r as NetworkSpawner, t as createSplitScreen, u as LocalGameServerTransport } from "./split-screen-CYwDkbLF.js";
 export { LocalGameServer, LocalGameServerTransport, LoopbackHub, LoopbackTransport, NetworkManager, NetworkSpawner, applySyncPatch, createAgent8Server, createLocalGameServer, createSplitScreen, registerNodesNet };