incanto 0.70.0 → 0.72.0

package/dist/{register-Bkk0wSDB.js → register-C8HuRkOf.js}

@@ -1,9 +1,9 @@
-import { K as Node, M as effectiveOrder, q as diagnose } from "./save-slots-BXVg148r.js";
-import { M as translateOn, t as registerCoreNodes } from "./register-6DYnKZcy.js";
+import { J as Node, P as effectiveOrder, Y as diagnose } from "./save-slots-CEuJPUle.js";
+import { M as translateOn, t as registerCoreNodes } from "./register-5IYfooAN.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { c as getNodeSchema, h as didYouMean, p as registerNode } from "./touch-BnCyPA0G.js";
 import { i as ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, r as validateAnimations, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-CqR2o3SA.js";
-import { E as effectRng, X as localFromWorld, Z as worldPosition, w as tolerateUnknownAction } from "./gameplay-BfHkuzVb.js";
+import { D as effectRng, Q as worldPosition, T as tolerateUnknownAction, Z as localFromWorld } from "./gameplay-BlQe-M07.js";
 import { t as checkSheetGrid } from "./sheet-grid-Cea343VO.js";
 import { AdditiveBlending, BufferAttribute, BufferGeometry, CanvasTexture, Color, DynamicDrawUsage, Group, InstancedMesh, MathUtils, Matrix4, Mesh, MeshBasicMaterial, NearestFilter, NormalBlending, Object3D, PlaneGeometry, SRGBColorSpace } from "three";
 //#region src/2d/physics/collider-validate.ts
@@ -1617,6 +1617,15 @@ function mergeSolidRects(grid, solid) {
 //#endregion
 //#region src/2d/nodes/tile-map-2d.ts
 /**
+* Where colour cells live in the index space, above any atlas anyone will draw.
+*
+* A million tiles is 1000×1000 atlas cells; a texture that size does not exist,
+* and the loader refuses `colors` and `texture` together anyway.
+*/
+const COLOR_BASE = 1e6;
+/** `#rgb` or `#rrggbb`, which is what every other colour prop in the engine takes. */
+const HEX = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i;
+/**
 * A whole tile level as ONE node — grid render in a single draw call plus
 * greedy-merged static colliders. Author the level as rows of characters:
 *
@@ -1653,6 +1662,23 @@ var TileMap2D = class extends Node2D {
 		cells: { default: [] },
 		/** char → atlas tile index for non-digit chars. */
 		legend: { default: {} },
+		/**
+		* Char → COLOUR, for a level you author before you have any art.
+		*
+		* `incanto-assets.md` is titled "No art yet? Ship gameplay anyway", and it
+		* was true of everything except the node a grid game is made of: this one
+		* draws from an atlas, so with no texture it rendered nothing at all. A
+		* sokoban built from the published package came out as 24 hand-placed
+		* `ColorRect2D` walls and a `wallAt()` comparing positions — because the
+		* one node that already answers `cellAt`/`tileAt`/`setTile`/`worldAt`, and
+		* merges the colliders, could not be seen.
+		*
+		* A cell painted with one of these chars is a flat quad of that colour, in
+		* the same single draw call. Exclusive with `texture`: one material, one
+		* draw call, and "the art arrived" is a two-line edit rather than a
+		* silently half-textured level.
+		*/
+		colors: { default: {} },
 		/** Tile indices that get merged static colliders. */
 		solid: { default: [] },
 		opacity: {
@@ -1693,6 +1719,42 @@ var TileMap2D = class extends Node2D {
 		this.geometryDirty = true;
 		this.collidersDirty = true;
 	}
+	_colors = {};
+	get colors() {
+		return this._colors;
+	}
+	set colors(value) {
+		this._colors = value;
+		this.geometryDirty = true;
+		this.collidersDirty = true;
+	}
+	/**
+	* The colours, in declaration order — a cell's tile index is `COLOR_BASE + i`.
+	*
+	* A synthetic index rather than a second grid: everything downstream (the
+	* collider merge, `tileAt`, `setTile`, the editor's paint tool) already
+	* speaks in indices, and one number per cell keeps it that way.
+	*/
+	palette() {
+		return Object.values(this._colors);
+	}
+	/** `legend` plus the colour chars, which is what every cell lookup wants. */
+	allChars() {
+		const merged = { ...this._legend };
+		Object.keys(this._colors).forEach((ch, i) => {
+			merged[ch] = COLOR_BASE + i;
+		});
+		return merged;
+	}
+	/** `solid` as INDICES: an entry may name the char that painted the cell. */
+	solidIndices() {
+		const chars = this.allChars();
+		const out = [];
+		for (const entry of this._solid) if (typeof entry === "number") out.push(entry);
+		else if (chars[entry] !== void 0) out.push(chars[entry]);
+		else if (entry.length === 1 && entry >= "0" && entry <= "9") out.push(entry.charCodeAt(0) - 48);
+		return out;
+	}
 	get solid() {
 		return this._solid;
 	}
@@ -1707,11 +1769,16 @@ var TileMap2D = class extends Node2D {
 	/** Loader hook: bad cells fail at LOAD (unknown chars), not at render. */
 	static validateJson(node) {
 		const map = node;
-		parseCells(map._cells, map._legend);
+		for (const [ch, value] of Object.entries(map._colors)) {
+			if (typeof value === "string" && HEX.test(value)) continue;
+			throw new IncantoError("PROP_TYPE_MISMATCH", `TileMap2D '${node.name}': "colors" ['${ch}'] is ${JSON.stringify(value)} — a colour here is \`#rgb\` or \`#rrggbb\`, the same as every other colour prop.`, { prop: "colors" });
+		}
+		if (map.texture !== "" && Object.keys(map._colors).length > 0) throw new IncantoError("PROP_TYPE_MISMATCH", `TileMap2D '${node.name}': "colors" and "texture" are exclusive — colours are for a level authored before the art arrives. Drop one of them.`, { prop: "colors" });
+		parseCells(map._cells, map.allChars());
 	}
 	/** The parsed index grid (test/tooling hook). */
 	grid() {
-		return parseCells(this._cells, this._legend);
+		return parseCells(this._cells, this.allChars());
 	}
 	/**
 	* Which CELL is under this world point — `null` outside the grid.
@@ -1809,7 +1876,7 @@ var TileMap2D = class extends Node2D {
 		if (this._solid.length === 0) return;
 		const ts = this.tileSize;
 		const [sx, sy] = this.builtScale;
-		mergeSolidRects(this.grid(), new Set(this._solid)).forEach((r, i) => {
+		mergeSolidRects(this.grid(), new Set(this.solidIndices())).forEach((r, i) => {
 			const body = new StaticBody2D(`__tileSolid${i}`);
 			body.position = [(r.x + r.w / 2) * ts * sx, (r.y + r.h / 2) * ts * sy];
 			body.collider = {
@@ -1839,6 +1906,23 @@ var TileMap2D = class extends Node2D {
 		super._syncObject2D(assets);
 		const mesh = this._mesh();
 		const mat = mesh.material;
+		if (Object.keys(this._colors).length > 0) {
+			mesh.visible = this.opacity > 0;
+			mesh.renderOrder = this.effectiveRenderOrder;
+			mat.opacity = this.opacity;
+			if (mat.map !== null || !mat.vertexColors) {
+				mat.map = null;
+				mat.vertexColors = true;
+				mat.needsUpdate = true;
+				this.geometryDirty = true;
+			}
+			if (!this.geometryDirty) return;
+			this.geometryDirty = false;
+			this.builtColumns = 1;
+			this.builtRows = 1;
+			this.buildGeometry(mesh.geometry, 1, 1);
+			return;
+		}
 		if (!this.texture || !assets) {
 			mesh.visible = false;
 			return;
@@ -1882,6 +1966,8 @@ var TileMap2D = class extends Node2D {
 		const positions = [];
 		const uvs = [];
 		const indices = [];
+		const palette = this.palette().map((hex) => new Color(hex));
+		const colors = [];
 		for (let y = 0; y < grid.length; y++) {
 			const row = grid[y];
 			for (let x = 0; x < row.length; x++) {
@@ -1893,18 +1979,24 @@ var TileMap2D = class extends Node2D {
 				const y1 = -((y + 1) * ts);
 				const base = positions.length / 3;
 				positions.push(x0, y0, 0, x1, y0, 0, x1, y1, 0, x0, y1, 0);
-				const col = tile % columns;
-				const rowIdx = Math.floor(tile / columns);
+				const col = tile >= COLOR_BASE ? 0 : tile % columns;
+				const rowIdx = tile >= COLOR_BASE ? 0 : Math.floor(tile / columns);
 				const u0 = col / columns;
 				const u1 = (col + 1) / columns;
 				const v0 = 1 - rowIdx / atlasRows;
 				const v1 = 1 - (rowIdx + 1) / atlasRows;
 				uvs.push(u0, v0, u1, v0, u1, v1, u0, v1);
+				const paint = tile >= COLOR_BASE ? palette[tile - COLOR_BASE] : void 0;
+				const r = paint?.r ?? 1;
+				const g = paint?.g ?? 1;
+				const b = paint?.b ?? 1;
+				for (let v = 0; v < 4; v++) colors.push(r, g, b);
 				indices.push(base, base + 2, base + 1, base, base + 3, base + 2);
 			}
 		}
 		geometry.setAttribute("position", new BufferAttribute(new Float32Array(positions), 3));
 		geometry.setAttribute("uv", new BufferAttribute(new Float32Array(uvs), 2));
+		geometry.setAttribute("color", new BufferAttribute(new Float32Array(colors), 3));
 		geometry.setIndex(indices);
 		geometry.computeBoundingSphere();
 	}

package/dist/{replay-Dmw-PKQu.d.ts → replay-CBEChqXq.d.ts}

@@ -1,4 +1,4 @@
-import { b as Engine } from "./behavior-DZExDn9o.js";
+import { b as Engine } from "./behavior-Bf9P9oB2.js";
 import { s as JsonObject } from "./rng-Bb-IutXB.js";
 
 //#region src/core/audit.d.ts
@@ -59,7 +59,7 @@ declare function auditScene(scene: JsonObject, opts?: AuditOptions): string[];
 * Incanto fails loudly with machine-readable codes and messages that list valid
 * alternatives — AI agents self-correct on hard failures, not warnings.
 */
-type IncantoErrorCode = "AMBIGUOUS_HANDLER" | "BAD_FORMAT" | "BAD_NODE_PATH" | "DANGLING_CONNECTION" | "DUPLICATE_BEHAVIOR" | "DUPLICATE_NODE_TYPE" | "DUPLICATE_UNIQUE_NAME" | "DUPLICATE_UID" | "NETWORK_UNAVAILABLE" | "NODE_NOT_FOUND" | "PROP_TYPE_MISMATCH" | "TREE_VIOLATION" | "UNKNOWN_ANIMATION" | "UNKNOWN_ASSET" | "UNKNOWN_CONSTANT" | "UNKNOWN_BEHAVIOR" | "UNKNOWN_HANDLER" | "UNKNOWN_NODE_TYPE" | "UNKNOWN_PROP" | "UNKNOWN_SIGNAL" | "UNRESOLVED_INSTANCE" | "WEBGL_UNAVAILABLE";
+type IncantoErrorCode = "AMBIGUOUS_HANDLER" | "BAD_FORMAT" | "BAD_NODE_PATH" | "DANGLING_CONNECTION" | "DUPLICATE_BEHAVIOR" | "DUPLICATE_NODE_TYPE" | "DUPLICATE_UNIQUE_NAME" | "DUPLICATE_UID" | "NETWORK_UNAVAILABLE" | "NODE_NOT_FOUND" | "PROP_TYPE_MISMATCH" | "TREE_VIOLATION" | "UNKNOWN_ANIMATION" | "UNKNOWN_ASSET" | "UNKNOWN_CONSTANT" | "UNKNOWN_BEHAVIOR" | "UNKNOWN_HANDLER" | "UNKNOWN_NODE_TYPE" | "UNKNOWN_PROP" | "UNKNOWN_SIGNAL" | "UNRESOLVED_INSTANCE" | "WRONG_DIMENSION" | "WEBGL_UNAVAILABLE";
 /**
 * Structured context mirrored from the prose message — tools and agents parse
 * THESE instead of regexing the message (which is for humans and may reword).

package/dist/{replay-DjAkAzMq.js → replay-datiAE-b.js}

@@ -1,5 +1,5 @@
-import { F as handlerShadowWarnings, I as sceneDimension, Y as nodeRefWarnings, z as HudWidgetBase } from "./save-slots-BXVg148r.js";
-import { N as translationKey } from "./register-6DYnKZcy.js";
+import { L as handlerShadowWarnings, R as sceneDimension, V as HudWidgetBase, Z as nodeRefWarnings } from "./save-slots-CEuJPUle.js";
+import { N as translationKey } from "./register-5IYfooAN.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { u as getNodeType } from "./touch-BnCyPA0G.js";
 //#region src/core/audit.ts
@@ -174,7 +174,7 @@ function auditScene(scene, opts = {}) {
 	/** Nodes whose script produces NOTHING but signals — see `SIGNAL_ONLY`. */
 	const silentSignals = [];
 	const groupRefs = [];
-	const walk = (node, path, insideHud, staticRoot, transformed) => {
+	const walk = (node, path, insideHud, staticRoot, transformed, onShelf) => {
 		const type = node.type ?? "";
 		const props = node.props ?? {};
 		const script = node.script?.name;
@@ -189,6 +189,11 @@ function auditScene(scene, opts = {}) {
 			if (props.current === true) currentCameras += 1;
 			if (script === "FollowCamera") followedCameras.push(path);
 		}
+		if (type === "TileMap2D") {
+			const cells = Array.isArray(props.cells) ? props.cells : [];
+			const colours = props.colors ?? {};
+			if (cells.length > 0 && (props.texture ?? "") === "" && Object.keys(colours).length === 0) warnings.push(`${path}: TileMap2D has ${cells.length} row(s) and neither "texture" nor "colors", so nothing of it is drawn. Give it a "colors" entry per legend char to see the level before the art arrives. (If it is meant to be an invisible collision map over scenery you drew yourself, this warning is the price of saying so.)`);
+		}
 		if (type === "CharacterController3D") cameraDrivers.push(path);
 		if (type === "Terrain3D") terrains.push(path);
 		if (DRAPERS.has(type) && (props.terrain ?? "") === "") autoDrapers.push(path);
@@ -219,7 +224,7 @@ function auditScene(scene, opts = {}) {
 			const collider = props.collider;
 			if (!collider || collider.shape === void 0) warnings.push(`${path}: ${type} has no collider — physics will skip it (add "collider": { "shape": ... }).`);
 		}
-		if (isHudWidget(type) && !insideHud) warnings.push(`${path}: ${type} works only as a descendant of a HudLayer — it will not render.`);
+		if (isHudWidget(type) && !insideHud && !onShelf) warnings.push(`${path}: ${type} works only as a descendant of a HudLayer — it will not render.`);
 		if (staticRoot && ANIMATED_TYPES.has(type)) warnings.push(`${path}: ${type} is frozen inside static subtree '${staticRoot}' — it will not animate/update on screen.`);
 		const nextStatic = staticRoot ?? (props.static === true ? node.name ?? path : null);
 		const nextHud = insideHud || type === "HudLayer";
@@ -228,12 +233,14 @@ function auditScene(scene, opts = {}) {
 			path,
 			what: own
 		} : transformed;
-		for (const child of node.children ?? []) walk(child, `${path}/${child.name ?? "?"}`, nextHud, nextStatic, nextTransformed);
+		const nextShelf = onShelf || script === "PrefabShelf";
+		for (const child of node.children ?? []) walk(child, `${path}/${child.name ?? "?"}`, nextHud, nextStatic, nextTransformed, nextShelf);
 	};
-	walk(root, root.name ?? "root", false, root.props?.static === true ? root.name ?? "root" : null, transformOf(root.props ?? {}) ? {
+	const rootTransform = transformOf(root.props ?? {});
+	walk(root, root.name ?? "root", false, root.props?.static === true ? root.name ?? "root" : null, rootTransform ? {
 		path: root.name ?? "root",
-		what: transformOf(root.props ?? {})
-	} : null);
+		what: rootTransform
+	} : null, root.script?.name === "PrefabShelf");
 	if (needUid.length > 0) warnings.push(`these carry state a save keeps and have no uid to key it under, so the save comes back EMPTY and the load reports no problem: ${needUid.join(", ")}. Give each one a "uid" from newUid().`);
 	if (terrains.length > 1 && autoDrapers.length > 0) warnings.push(`${autoDrapers.join(", ")}: this scene has ${terrains.length} Terrain3Ds (${terrains.join(", ")}) and these do not say which one they grow on — with no \`terrain\` path they take the FIRST one in the tree, so the rest drape to the wrong height with nothing reported. Name it: "terrain": "%Name".`);
 	if (cameraDrivers.length > 1) warnings.push(`${cameraDrivers.join(", ")}: ${cameraDrivers.length} CharacterController3Ds drive the SAME camera (each one finds the first \`current\` camera in the tree), so the last of them wins every frame and the others have no view. For local co-op give each player a panel with \`createSplitScreen\` (one engine each); otherwise only one node may carry a controller.`);

package/dist/{save-slots-BXVg148r.js → save-slots-CEuJPUle.js}

@@ -113,7 +113,10 @@ var Behavior = class {
 	*/
 	get engine() {
 		const engine = this.node?.tree?.engine;
-		if (!engine) throw new IncantoError("TREE_VIOLATION", `Behavior on '${this.node?.name ?? "?"}' is not attached to a running engine. If this came from \`onReady\` during a load, the scene does not know its engine yet: pass it — \`loadScene(json, { engine })\` — which is what createGame2D/3D and runScript do. Otherwise the node is not in a scene set on an Engine.`);
+		if (!engine) {
+			if (this.node?.freed) throw new IncantoError("TREE_VIOLATION", `Behavior on '${this.node.name}' has been FREED — a scene swap frees the tree it replaces, so \`this.engine\` (which reads \`this.node.tree\`) is gone with it. Hold it BEFORE the swap: \`const engine = this.engine; goToScene(engine, next);\` and use that afterwards.`);
+			throw new IncantoError("TREE_VIOLATION", `Behavior on '${this.node?.name ?? "?"}' is not attached to a running engine. If this came from \`onReady\` during a load, the scene does not know its engine yet: pass it — \`loadScene(json, { engine })\` — which is what createGame2D/3D and runScript do. Otherwise the node is not in a scene set on an Engine.`);
+		}
 		return engine;
 	}
 	/** Shortcut for `this.engine.input`. */
@@ -669,7 +672,11 @@ var Node = class {
 	*/
 	wiringPath() {
 		const parts = [];
-		for (let n = this; n; n = n._parent) parts.unshift(n._cloneOf ?? n._name);
+		for (let n = this; n; n = n._parent) {
+			const authored = n._authoredPath;
+			if (authored !== void 0) return parts.length === 0 ? authored : `${authored}/${parts.join("/")}`;
+			parts.unshift(n._cloneOf ?? n._name);
+		}
 		return `/${parts.join("/")}`;
 	}
 	getNode(path) {
@@ -874,9 +881,23 @@ var Node = class {
 		if (this._tree) this._tree._queueFree(this);
 		else this.free();
 	}
+	/**
+	* Has this node been torn down?
+	*
+	* A scene swap frees the tree it replaces, so the answer is `true` for every
+	* node of the scene you just left — which is exactly the state a behavior is
+	* in when it runs one more line after `goToScene`. Kept as a flag rather than
+	* inferred from `parent`/`tree`, because a DETACHED node (a prefab on a
+	* shelf, a clone waiting to be added) has neither and is perfectly alive.
+	*/
+	get freed() {
+		return this._freed;
+	}
+	_freed = false;
 	/** Immediately detach and tear down this node and its children. */
 	free() {
 		const tree = this._tree;
+		this._freed = true;
 		for (const child of [...this._children]) child.free();
 		this._parent?.removeChild(this);
 		if (this._tree) this._propagateExitTree();
@@ -2064,6 +2085,36 @@ function inferSceneDimension(root) {
 function sceneDimension(json) {
 	return json.dimension ?? inferSceneDimension(json.root);
 }
+/**
+* Every node whose type name belongs to the OTHER world, with its path.
+*
+* The two halves of the engine are strangers by design: `Renderer2D` walks
+* `Node2D`s and `Physics2D` tracks 2D bodies; the 3D pair do the same for
+* theirs, and neither knows the other's nodes exist. So a `MeshInstance3D`
+* dropped into a 2D scene loads, validates, appears in the tree, opens a full
+* inspector — and is never drawn and never simulated. The editor's add-node
+* list offers all of them, because the LOADER is what says no, and the loader
+* did not.
+*
+* The suffix is the authority here, as it already is for
+* {@link inferSceneDimension} and for the registry's missing-registrar hint.
+*/
+function foreignDimensionNodes(root, dimension) {
+	const wrong = dimension === "2d" ? "3D" : "2D";
+	const out = [];
+	const visit = (n, parent) => {
+		if (typeof n !== "object" || n === null) return;
+		const node = n;
+		const path = `${parent}/${typeof node.name === "string" ? node.name : "?"}`;
+		if (typeof node.type === "string" && node.type.endsWith(wrong)) out.push({
+			path,
+			type: node.type
+		});
+		if (Array.isArray(node.children)) for (const child of node.children) visit(child, path);
+	};
+	visit(root, "");
+	return out;
+}
 //#endregion
 //#region src/core/scene/handler-collision.ts
 /**
@@ -4415,6 +4466,18 @@ function loadScene(json, opts) {
 	validateHeader(sceneJson);
 	validateStrings(sceneJson.strings);
 	const dimension = sceneDimension(sceneJson);
+	if (dimension) {
+		const foreign = foreignDimensionNodes(sceneJson.root, dimension);
+		if (foreign.length > 0) {
+			const first = foreign[0];
+			const others = foreign.length > 1 ? ` (and ${foreign.length - 1} more)` : "";
+			const declared = sceneJson.dimension ? `declared "dimension": "${dimension}"` : `no "dimension" key, and its other nodes make it ${dimension}`;
+			throw new IncantoError("WRONG_DIMENSION", `${first.type} '${first.path}'${others} is a ${dimension === "2d" ? "3D" : "2D"} node in a scene with ${declared}. The ${dimension} renderer never draws it and the ${dimension} physics never simulates it. Use the matching node type, or move it to its own scene.`, {
+				path: first.path,
+				nodeType: first.type
+			});
+		}
+	}
 	validateEnvironment(sceneJson.environment, dimension);
 	inheritedStrings = {};
 	inheritedAssets = {};
@@ -4837,7 +4900,10 @@ function buildNode(nj, opts, stack, parentPath, constants, bands = []) {
 		rejectUnknownKeys(nj, NODE_KEYS, "node", nj.name ?? "");
 		rejectWrongKinds(nj, nj.name ?? "");
 		if (nj.instance !== void 0 && nj.type !== void 0) throw new IncantoError("BAD_FORMAT", `Node '${nj.name}' declares both "type" and "instance" — they are mutually exclusive.`);
-		if (nj.instance !== void 0) return buildInstance(nj, opts, stack, path, constants, bands);
+		if (nj.instance !== void 0) {
+			if (nj.props !== void 0) throw new IncantoError("BAD_FORMAT", `Node '${nj.name}' places an instance and declares "props" — a placement's props go in "overrides", which deep-merge onto the sub-scene root. "props" here is read by nothing.`, { prop: "props" });
+			return buildInstance(nj, opts, stack, path, constants, bands);
+		}
 		if (nj.type === void 0) throw new IncantoError("BAD_FORMAT", `Node '${nj.name}' must declare either "type" or "instance".`);
 		const node = createNode(nj.type, resolveConstants(nj.props, constants), { orderGroup: bands });
 		applyCommon(node, nj, opts, constants);
@@ -5145,6 +5211,7 @@ function duplicateNode(node, opts) {
 	const clone = buildNodeJson(stripUids(serializeNode(node)), opts ?? rebuildOptions(node));
 	markCloned(clone);
 	markTemplateName(clone);
+	markTemplateOrigin(clone, node);
 	return clone;
 }
 /**
@@ -5196,6 +5263,37 @@ function markCloned(node) {
 function markTemplateName(node) {
 	node._cloneOf = node.name;
 }
+/**
+* @internal Where the template this clone came from was AUTHORED.
+*
+* `_cloneOf` (the name) is enough only while clones land where the template
+* was authored — the `Spawner` case (`/Waves/Grunt` template, `/Waves/Grunt2`
+* clone) and no other. A game that clones from a SHELF authors the template at
+* `/Game/Prefabs/Tower` and adds the clone under `/Game/Towers`, so its audio
+* was logged at `/Game/Towers/Tower/Thud`: a path no scene file contains, and
+* one no report that reads the file can ever match. Recording the address
+* itself is what lets `wiringPath` answer with the authored node wherever the
+* clone ends up — including a clone OF a clone, which carries it forward.
+*
+* Taken while the source is still in a tree; a template detached before the
+* first clone (`PrefabShelf`, `SpawnSource`) records its own on the way out.
+*/
+function markTemplateOrigin(clone, source) {
+	const origin = source._authoredPath ?? (source.tree ? source.getPath() : null);
+	if (origin) clone._authoredPath = origin;
+}
+/**
+* @internal Remember where a node was authored, before it leaves the tree.
+*
+* A shelf or a spawner lifts its templates out at enter; from then on the
+* template cannot say where it came from, and neither can anything cloned from
+* it. Called on the way out, while the answer is still there.
+*/
+function rememberAuthoredPath(node) {
+	const at = node;
+	if (at._authoredPath !== void 0) return;
+	if (node.tree || node.parent?.tree) at._authoredPath = node.getPath();
+}
 /** @internal Was this node made at runtime rather than loaded from a file? */
 function isCloned(node) {
 	return node._cloned === true;
@@ -5648,4 +5746,4 @@ function savesWithoutUid(root) {
 	return out;
 }
 //#endregion
-export { StubBehavior as $, resetMemorySaves as A, TAPPABLE as B, isConstRef as C, newUid as D, resolveViewport as E, handlerShadowWarnings as F, requireText as G, UiBar as H, sceneDimension as I, describeRefProblem as J, Node as K, FITS$1 as L, effectiveOrder as M, resolveOrderGroups as N, SceneTree as O, InputMap as P, Behavior as Q, HudLayer as R, CONST_REF_KEY as S, computeViewport as T, UiText as U, UiBanner as V, requireNumber as W, resolveRefInJson as X, nodeRefWarnings as Y, parseNodePath as Z, SCENE_FORMAT as _, restoreBehaviors as a, registeredBehaviors as at, sunDirectionFromElevationAzimuth as b, markCloned as c, stripUids as d, behaviorSchema as et, buildSceneSubtree as f, serializeNode as g, Scene as h, captureBehaviors as i, registerBehavior as it, ORDER_GROUP_BASE as j, createSaveStore as k, markTemplateName as l, loader_exports as m, SaveSlots as n, clearBehaviors as nt, savesWithoutUid as o, Signal as ot, loadScene as p, diagnose as q, behaviorsWithoutSave as r, getBehavior as rt, duplicateNode as s, ENGINE_STATE_KEY as t, behaviorSignals as tt, rebuildOptions as u, horizonColorFromSky as v, resolveConstants as w, sunDirectionFromSky as x, parseEnvironment3D as y, HudWidgetBase as z };
+export { parseNodePath as $, SceneTree as A, HudLayer as B, sunDirectionFromSky as C, computeViewport as D, resolveConstants as E, resolveOrderGroups as F, UiText as G, TAPPABLE as H, InputMap as I, Node as J, requireNumber as K, handlerShadowWarnings as L, resetMemorySaves as M, ORDER_GROUP_BASE as N, resolveViewport as O, effectiveOrder as P, resolveRefInJson as Q, sceneDimension as R, sunDirectionFromElevationAzimuth as S, isConstRef as T, UiBanner as U, HudWidgetBase as V, UiBar as W, describeRefProblem as X, diagnose as Y, nodeRefWarnings as Z, Scene as _, restoreBehaviors as a, getBehavior as at, horizonColorFromSky as b, isCloned as c, Signal as ct, rebuildOptions as d, Behavior as et, rememberAuthoredPath as f, loader_exports as g, loadScene as h, captureBehaviors as i, clearBehaviors as it, createSaveStore as j, newUid as k, markCloned as l, buildSceneSubtree as m, SaveSlots as n, behaviorSchema as nt, savesWithoutUid as o, registerBehavior as ot, stripUids as p, requireText as q, behaviorsWithoutSave as r, behaviorSignals as rt, duplicateNode as s, registeredBehaviors as st, ENGINE_STATE_KEY as t, StubBehavior as tt, markTemplateName as u, serializeNode as v, CONST_REF_KEY as w, parseEnvironment3D as x, SCENE_FORMAT as y, FITS$1 as z };

package/dist/{split-screen-PL78oVXP.js → split-screen-Bm5DTElG.js}

@@ -1,6 +1,6 @@
 import { n as jsonEquals, t as jsonClone } from "./json-CfTjpvW8.js";
-import { K as Node, c as markCloned, d as stripUids, f as buildSceneSubtree, l as markTemplateName, ot as Signal, p as loadScene, q as diagnose, u as rebuildOptions } from "./save-slots-BXVg148r.js";
-import { t as registerCoreNodes, v as Engine } from "./register-6DYnKZcy.js";
+import { J as Node, Y as diagnose, ct as Signal, d as rebuildOptions, h as loadScene, l as markCloned, m as buildSceneSubtree, p as stripUids, u as markTemplateName } from "./save-slots-CEuJPUle.js";
+import { t as registerCoreNodes, v as Engine } from "./register-5IYfooAN.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { p as registerNode } from "./touch-BnCyPA0G.js";
 //#region src/net/loopback.ts
@@ -1150,7 +1150,7 @@ function applySyncPatch(root, patch, setProp, onMissingNode) {
 	}
 }
 async function createDefaultTransport(config, diagnostics) {
-	const { createAgent8Server } = await import("./agent8-CmNF01gA.js").then((n) => n.t);
+	const { createAgent8Server } = await import("./agent8-BqZ0_O1u.js").then((n) => n.t);
 	return createAgent8Server(config, diagnostics);
 }
 //#endregion

package/dist/{split-screen--k-XpBjr.d.ts → split-screen-DkqLng6q.d.ts}

@@ -1,7 +1,7 @@
-import { Lt as Signal, b as Engine, jt as Node } from "./behavior-DZExDn9o.js";
+import { Lt as Signal, b as Engine, jt as Node } from "./behavior-Bf9P9oB2.js";
 import { t as DiagnosticSink } from "./diagnostics-Cu85N3tL.js";
 import { a as SceneJson, c as JsonValue, s as JsonObject } from "./rng-Bb-IutXB.js";
-import { t as LoadSceneOptions } from "./loader-Cff09LMm.js";
+import { t as LoadSceneOptions } from "./loader-CBfQzB6S.js";
 
 //#region src/net/types.d.ts
 type Unsubscribe = () => void;

package/dist/{src-Cxfiv1Hg.js → src-DRSsRleD.js}

@@ -199,6 +199,6 @@ async function preloadSceneAssets(assets, title) {
 //#endregion
 //#region src/index.ts
 /** Engine version. Kept in sync with package.json by the release pipeline. */
-const VERSION = "0.70.0";
+const VERSION = "0.72.0";
 //#endregion
 export { findPath as a, preloadUrls as i, assetUrls as n, gridFromRows as o, preloadSceneAssets as r, VERSION as t };