incanto 0.67.0 → 0.68.0

package/dist/{physics-2d-_B6zj3zU.js → physics-2d-B7Y6dPZO.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { k as diagnose } from "./loader-KZESOZmE.js";
+import { k as diagnose } from "./loader-BC4PNtJX.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-vIxU3Xbv.js";
+import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-ibCjm-wH.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
 import { n as jointContacts, t as withoutRapierInitNoise } from "./quiet-rapier-C6fW4zcW.js";
 //#region src/2d/physics/physics-2d.ts

package/dist/{physics-3d-i1IeAY0F.js → physics-3d-bG3n70Ky.js}

@@ -1,10 +1,10 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { k as diagnose } from "./loader-KZESOZmE.js";
+import { k as diagnose } from "./loader-BC4PNtJX.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { H as CharacterBody3D, K as Node3D, U as PhysicsBody3D, V as Area3D, W as RigidBody3D, q as validateCollider3D } from "./gameplay-CGSv-9XR.js";
+import { H as CharacterBody3D, K as Node3D, U as PhysicsBody3D, V as Area3D, W as RigidBody3D, q as validateCollider3D } from "./gameplay-DM1eu_cV.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
 import { n as jointContacts, t as withoutRapierInitNoise } from "./quiet-rapier-C6fW4zcW.js";
-import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-C-5g2pMh.js";
+import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-CybQXNqS.js";
 import { Euler, Matrix4, Quaternion, Vector3 } from "three";
 //#region src/3d/physics/collider-lines.ts
 /**

package/dist/react.d.ts

@@ -1,5 +1,5 @@
-import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-ZnfzKDo3.js";
-import { c as JsonValue } from "./schema-CFeioQRE.js";
+import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-DoFPYrgo.js";
+import { c as JsonValue } from "./schema-B6ugCV1Q.js";
 import { CSSProperties, ReactNode } from "react";
 
 //#region src/react/index.d.ts

package/dist/react.js

@@ -156,7 +156,7 @@ function IncantoCanvas(props) {
 				pointer: latest.pointer,
 				...keyboard !== void 0 ? { keyboard } : {}
 			};
-			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-FAXdHta3.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-DMetd3vR.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-DbWtVTxD.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-IZIydDwI.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/dist/{register-Cs53CY7s.js → register-3ta-2Xig.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { C as ORDER_GROUP_BASE, E as InputMap, O as Node, S as createSaveStore, T as resolveOrderGroups, V as Signal, b as restoreBehaviors, k as diagnose, y as captureBehaviors } from "./loader-KZESOZmE.js";
+import { C as ORDER_GROUP_BASE, E as InputMap, O as Node, S as createSaveStore, T as resolveOrderGroups, V as Signal, b as restoreBehaviors, k as diagnose, y as captureBehaviors } from "./loader-BC4PNtJX.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
 import { l as registerNode } from "./registry-CF70EArN.js";
@@ -179,6 +179,11 @@ var WebAudioTrack = class {
 	setLoop(loop) {
 		this.el.loop = loop;
 	}
+	/** The element's own playhead — the clock the sound is actually on. */
+	playhead() {
+		const at = this.el.currentTime;
+		return typeof at === "number" && Number.isFinite(at) ? at : null;
+	}
 	play() {
 		this.el.play().catch((error) => {
 			const name = error?.name ?? "";
@@ -243,7 +248,8 @@ const SILENT_BACKEND = {
 		setGain() {},
 		setLoop() {},
 		play() {},
-		stop() {}
+		stop() {},
+		playhead: () => null
 	}),
 	unlock() {}
 };
@@ -283,6 +289,24 @@ var MusicManager = class {
 	get current() {
 		return this.active?.track.src ?? null;
 	}
+	/**
+	* Seconds into the current track — the playhead of the thing you can HEAR.
+	*
+	* `null` when nothing is playing, or when the backend has no clock (headless,
+	* or a custom backend that does not implement it).
+	*
+	* A game charted to a soundtrack needs this and there was no way to get it:
+	* `current` gave the src and the backend was private, so the only option was
+	* an `engine.time` counter started next to `music.play()` — a different clock
+	* from the one the audio is on, and one that keeps counting through a
+	* gesture-block, a stall or a seek. This is the audio's own answer.
+	*
+	* It is the RAW element time, so a looping track wraps to 0 at each pass:
+	* that is a loop boundary you can chart against, not a fault.
+	*/
+	get playhead() {
+		return this.active?.track.playhead?.() ?? null;
+	}
 	/** Per-manager volume (0..1), on top of the bus gain. */
 	get volume() {
 		return this._volume;
@@ -1036,6 +1060,16 @@ var SfxEngine = class {
 		if (ctx && ctx.state === "suspended") ctx.resume();
 	}
 	/**
+	* The AUDIO clock, in seconds — the one a sound is actually scheduled
+	* against, and the only clock that does not drift relative to what you hear.
+	*
+	* `0` headless and before the first sound, since there is no context yet.
+	* Schedule with a lead: `sfx.play(params, 1, { when: sfx.now + 0.08 })`.
+	*/
+	get now() {
+		return this.ctx?.currentTime ?? 0;
+	}
+	/**
 	* Play a preset at `gain` (0..1, already bus-multiplied by the caller). Each
 	* call spawns its own source so rapid repeats overlap instead of cutting off.
 	* Headless → no-op.
@@ -1077,7 +1111,7 @@ var SfxEngine = class {
 		const source = ctx.createBufferSource();
 		source.buffer = buffer;
 		source.connect(gainNode);
-		source.start();
+		source.start(opts.when === void 0 ? 0 : Math.max(0, opts.when));
 	}
 };
 //#endregion
@@ -3005,10 +3039,32 @@ var AudioPlayer = class extends Node {
 			rolloff: this.rolloff
 		};
 	}
-	play() {
+	/**
+	* Start the sound. `at` schedules it on the AUDIO clock instead of now.
+	*
+	* A frame is a 16.67 ms grid at 60 Hz and 33.33 ms at 30, so a sound fired
+	* from `update()` cannot land closer than one frame to where a chart wants
+	* it — measured 0 of 64 notes scheduled on the documented path. Queue it a
+	* lead ahead of `engine.sfx.now` and the same notes land at |mean| 0.000000
+	* ms:
+	*
+	* ```ts
+	* const lead = 0.08;                        // schedule this far ahead
+	* for (const note of dueSoon(engine.sfx.now + lead)) {
+	*   hit.play(engine.sfx.now + (note.atSec - songSeconds));
+	* }
+	* ```
+	*
+	* PRESETS only — a `src` clip goes through an `<audio>` element, which has no
+	* scheduling clock, and passing `at` for one is ignored rather than silently
+	* approximated. Everything else is unchanged: the bus gain applies, the sound
+	* lands in `engine.audio.recent()`, and `muted` still silences it, none of
+	* which a hand-rolled `AudioContext` scheduler keeps.
+	*/
+	play(at) {
 		if (this.preset !== "custom") {
 			this.note("preset", this.preset);
-			this.playPreset();
+			this.playPreset(at);
 			return;
 		}
 		if (!this.src) return;
@@ -3052,7 +3108,7 @@ var AudioPlayer = class extends Node {
 	* the length is arithmetic, not a device. WebAudio needs a gesture; a
 	* suspended context is resumed by the same unlock listener as `src` players.
 	*/
-	playPreset() {
+	playPreset(at) {
 		const params = SFX_PRESETS[this.preset];
 		if (!params) return;
 		const engine = this.tree?.engine;
@@ -3063,7 +3119,8 @@ var AudioPlayer = class extends Node {
 		sfx.play(params, this.gain(), {
 			pitch: this.pitch,
 			seed: this.seed,
-			spatial: this.spatialPlay()
+			spatial: this.spatialPlay(),
+			when: at
 		});
 	}
 	/**
@@ -3099,6 +3156,10 @@ var AudioPlayer = class extends Node {
 		}
 		if (this.presetEndsAt !== null) {
 			if ((this.tree?.engine?.unscaledTime ?? 0) >= this.presetEndsAt) {
+				if (this.loop) {
+					this.playPreset();
+					return;
+				}
 				this.presetEndsAt = null;
 				this._playing = false;
 				this.emit("finished");

package/dist/{register-vIxU3Xbv.js → register-ibCjm-wH.js}

@@ -1,10 +1,10 @@
-import { O as Node, k as diagnose, w as effectiveOrder } from "./loader-KZESOZmE.js";
-import { L as translateOn, t as registerCoreNodes } from "./register-Cs53CY7s.js";
+import { O as Node, k as diagnose, w as effectiveOrder } 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 { 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 { F as localFromWorld, I as worldPosition } from "./gameplay-CGSv-9XR.js";
+import { F as localFromWorld, I as worldPosition } from "./gameplay-DM1eu_cV.js";
 import { t as checkSheetGrid } from "./sheet-grid-BT6N_Bjs.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

package/dist/{replay-BkpDV51O.js → replay-CYvhVHHN.js}

@@ -1,5 +1,5 @@
-import { D as handlerShadowWarnings, j as nodeRefWarnings } from "./loader-KZESOZmE.js";
-import { R as translationKey, k as HudWidgetBase } from "./register-Cs53CY7s.js";
+import { D as handlerShadowWarnings, j as nodeRefWarnings } from "./loader-BC4PNtJX.js";
+import { R as translationKey, k as HudWidgetBase } from "./register-3ta-2Xig.js";
 import { o as getNodeType } from "./registry-CF70EArN.js";
 //#region src/core/audit.ts
 const ANIMATED_TYPES = new Set([
@@ -104,6 +104,28 @@ function transformOf(props) {
 	if (scaled) return "scale";
 	return null;
 }
+/**
+* Which files in a corpus some OTHER scene embeds with `instance`.
+*
+* A fragment cannot be recognised by looking at itself — `enemy.scene.json` and
+* a broken first level are the same file shape. It is recognised by the project
+* around it, which every tool that audits more than one scene already walks.
+*
+* `resolveRef(fromFile, ref)` turns a scene-relative `instance` path into the
+* same spelling the corpus uses for that file, so the caller owns all path
+* logic and this stays runnable in a browser.
+*/
+function instancedScenes(corpus, resolveRef) {
+	const instanced = /* @__PURE__ */ new Set();
+	const walk = (node, from) => {
+		if (!node || typeof node !== "object") return;
+		const ref = node.instance;
+		if (typeof ref === "string" && ref) instanced.add(resolveRef(from, ref));
+		for (const child of node.children ?? []) walk(child, from);
+	};
+	for (const { path, json } of corpus) walk(json.root, path);
+	return instanced;
+}
 function auditScene(scene, opts = {}) {
 	const warnings = [];
 	const root = scene.root;
@@ -166,8 +188,9 @@ function auditScene(scene, opts = {}) {
 	if (cameraDrivers.length > 0 && followedCameras.length > 0) warnings.push(`${followedCameras.join(", ")}: a FollowCamera writes this camera's position every frame, and so does the CharacterController3D at ${cameraDrivers.join(", ")} — the controller owns the camera in every view it has. Drop one of them: use the controller's own \`view\`/\`camDistance\`, or take the controller off the camera duty.`);
 	if (cameras > 0 && currentCameras === 0) warnings.push("no camera has \"current\": true — the screen renders from a default view, probably not what you framed.");
 	if (currentCameras > 1) warnings.push(`${currentCameras} cameras claim "current": true — only the first found wins.`);
-	const isFragment = cameras === 0;
-	if (scene.dimension === "3d" && !isFragment && lights === 0 && !isLit(scene.environment)) warnings.push("nothing lights this 3D scene — no light node, no environment sky/hdri, and no ambient intensity. It will render black. Add a DirectionalLight3D, or an \"environment\": { \"sky\": { \"type\": \"atmosphere\" } } / { \"preset\": \"...\" }.");
+	const isFragment = opts.instanced === true || scene.fragment === true;
+	if (scene.dimension === "3d" && !isFragment && cameras === 0) warnings.push("this 3D scene has no camera — the screen renders from a default view, which is almost never the shot you want. Add a Camera3D with \"current\": true, or set \"fragment\": true in the scene header if this file is a prefab another scene drops in.");
+	if (scene.dimension === "3d" && !isFragment && lights === 0 && !isLit(scene.environment)) warnings.push("nothing lights this 3D scene — no light node, no environment sky/hdri, and no ambient intensity. It will render black. Add a DirectionalLight3D, or an \"environment\": { \"sky\": { \"type\": \"atmosphere\" } } / { \"preset\": \"...\" } — or set \"fragment\": true if another scene lights this one.");
 	if (damageGroups.length > 0) {
 		const hurtable = hurtableGroups(root);
 		for (const { path, group } of damageGroups) {
@@ -359,4 +382,4 @@ function replay(engine, recording, opts) {
 	}
 }
 //#endregion
-export { startRecording as n, auditScene as r, replay as t };
+export { instancedScenes as i, startRecording as n, auditScene as r, replay as t };

package/dist/{replay-D0GcEHYU.d.ts → replay-Dvn8aeBd.d.ts}

@@ -1,5 +1,5 @@
-import { b as Engine } from "./behavior-ZnfzKDo3.js";
-import { s as JsonObject } from "./schema-CFeioQRE.js";
+import { b as Engine } from "./behavior-DoFPYrgo.js";
+import { s as JsonObject } from "./schema-B6ugCV1Q.js";
 
 //#region src/core/audit.d.ts
 /** Human-readable warnings (empty = clean). Pure JSON walk, no registry. */
@@ -15,7 +15,41 @@ interface AuditOptions {
   * has one.
   */
   declaredElsewhere?: Record<string, Record<string, string>>;
+  /**
+  * Another scene in this project embeds this file with `instance`.
+  *
+  * That, and only that, makes a scene a FRAGMENT — a thing lit and framed by
+  * whatever drops it in, which must not be told it will render black.
+  *
+  * The discriminator used to be "it has no camera", which is the same shape a
+  * beginner's FIRST 3D scene has. Measured on a ground plane and a capsule
+  * with no camera and no light — a guaranteed black screen:
+  *
+  *   $ incanto-check
+  *     ok  src/game.scene.json
+  *   1/1 scene(s) valid
+  *
+  * Not the lighting warning, and not the camera one either. The checker walks
+  * the whole project already (it unions `strings` and `assets` the same way),
+  * so it can answer this by looking instead of guessing.
+  */
+  instanced?: boolean;
 }
+/**
+* Which files in a corpus some OTHER scene embeds with `instance`.
+*
+* A fragment cannot be recognised by looking at itself — `enemy.scene.json` and
+* a broken first level are the same file shape. It is recognised by the project
+* around it, which every tool that audits more than one scene already walks.
+*
+* `resolveRef(fromFile, ref)` turns a scene-relative `instance` path into the
+* same spelling the corpus uses for that file, so the caller owns all path
+* logic and this stays runnable in a browser.
+*/
+declare function instancedScenes(corpus: {
+  path: string;
+  json: JsonObject;
+}[], resolveRef: (fromFile: string, ref: string) => string): Set<string>;
 declare function auditScene(scene: JsonObject, opts?: AuditOptions): string[];
 //#endregion
 //#region src/core/errors.d.ts
@@ -25,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" | "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";
+type IncantoErrorCode = "AMBIGUOUS_HANDLER" | "BAD_FORMAT" | "BAD_NODE_PATH" | "DANGLING_CONNECTION" | "DUPLICATE_BEHAVIOR" | "DUPLICATE_NODE_TYPE" | "DUPLICATE_UNIQUE_NAME" | "DUPLICATE_UID" | "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";
 /**
 * Structured context mirrored from the prose message — tools and agents parse
 * THESE instead of regexing the message (which is for humans and may reword).
@@ -100,4 +134,4 @@ declare function replay(engine: Engine, recording: ReplayJson, opts?: {
   onTick?: (index: number) => void;
 }): void;
 //#endregion
-export { startRecording as a, IncantoErrorDetails as c, replay as i, auditScene as l, ReplayEvent as n, IncantoError as o, ReplayJson as r, IncantoErrorCode as s, Recorder as t };
+export { startRecording as a, IncantoErrorDetails as c, replay as i, auditScene as l, ReplayEvent as n, IncantoError as o, ReplayJson as r, IncantoErrorCode as s, Recorder as t, instancedScenes as u };

package/dist/{schema-CFeioQRE.d.ts → schema-B6ugCV1Q.d.ts}

@@ -74,6 +74,17 @@ interface SceneJson {
   input?: JsonObject;
   /** Physics config — `{gravity: [x,y]}` (2D px/s²) or `{gravity: [x,y,z]}` (3D m/s²). */
   physics?: JsonObject;
+  /**
+  * This scene is a PIECE of another one — a spawner's prefab, an instanced
+  * sub-scene — and is never rendered on its own.
+  *
+  * It exists because no tool can tell a prefab from a broken first level by
+  * looking at the file: both are a small tree with no camera and no light. The
+  * audit used to guess ("no camera means fragment") and so went silent on the
+  * commonest beginner mistake there is. One key, written by the author who
+  * knows, is the honest version. It changes nothing at runtime.
+  */
+  fragment?: boolean;
   /** Multiplayer config (interpreted in M6; preserved verbatim until then). */
   multiplayer?: JsonObject;
   /** Scene-level rendering environment (ambient light, background — interpreted by renderers). */

package/dist/{split-screen-DS8RaUV_.js → split-screen-CYwDkbLF.js}

@@ -1,5 +1,5 @@
-import { O as Node, V as Signal, k as diagnose, n as loadScene, t as buildNodeJson } from "./loader-KZESOZmE.js";
-import { t as registerCoreNodes, v as Engine } from "./register-Cs53CY7s.js";
+import { O as Node, V as Signal, k as diagnose, n as loadScene, t as buildNodeJson } from "./loader-BC4PNtJX.js";
+import { t as registerCoreNodes, v as Engine } from "./register-3ta-2Xig.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as jsonEquals, t as jsonClone } from "./json-CwwhxQgb.js";
 import { l as registerNode } from "./registry-CF70EArN.js";

package/dist/{split-screen-DD5eYIgW.d.ts → split-screen-DhrSzZIB.d.ts}

@@ -1,6 +1,6 @@
-import { Lt as Signal, b as Engine, jt as Node } from "./behavior-ZnfzKDo3.js";
-import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
-import { t as LoadSceneOptions } from "./loader-DyT30ArB.js";
+import { Lt as Signal, b as Engine, jt as Node } from "./behavior-DoFPYrgo.js";
+import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-B6ugCV1Q.js";
+import { t as LoadSceneOptions } from "./loader-CcB533FR.js";
 
 //#region src/net/types.d.ts
 type Unsubscribe = () => void;

package/dist/{src-BLlsGJW9.js → src-D7RIqXYF.js}

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

package/dist/{teardown-LB9cTnXJ.js → teardown-D2NEmxPB.js}

@@ -1,5 +1,5 @@
-import { _ as AudioPlayer } from "./register-Cs53CY7s.js";
-import { i as parseDrive, n as logReport } from "./rendering-options-ByAdi8PF.js";
+import { _ as AudioPlayer } from "./register-3ta-2Xig.js";
+import { i as logReport, o as parseDrive } from "./webgl-unavailable-N9nQqesw.js";
 import { a as frameSignature, i as frameImage, o as frameStats } from "./frame-report-BSMny7oe.js";
 //#region src/core/audio-errors.ts
 /** Every AudioPlayer under `root` whose source could not be played. */

package/dist/{test-81uZ967a.js → test-8hoHeRmo.js}

@@ -1,13 +1,13 @@
-import { f as resolveViewport, n as loadScene, z as registerBehavior } from "./loader-KZESOZmE.js";
-import { v as Engine } from "./register-Cs53CY7s.js";
+import { f as resolveViewport, n as loadScene, z as registerBehavior } from "./loader-BC4PNtJX.js";
+import { v as Engine } from "./register-3ta-2Xig.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as jsonEquals, t as jsonClone } from "./json-CwwhxQgb.js";
 import { i as getNodeSchema, s as mergeStaticProps } from "./registry-CF70EArN.js";
-import { n as startRecording } from "./replay-BkpDV51O.js";
-import { n as registerGameplayBehaviors } from "./gameplay-CGSv-9XR.js";
-import { t as registerNodes2D } from "./register-vIxU3Xbv.js";
-import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-C-5g2pMh.js";
-import { a as NetworkManager, c as readSyncKey, i as sanitizeName, n as registerNodesNet, r as NetworkSpawner, s as findOwnerNode, t as createSplitScreen } from "./split-screen-DS8RaUV_.js";
+import { n as startRecording } from "./replay-CYvhVHHN.js";
+import { n as registerGameplayBehaviors } from "./gameplay-DM1eu_cV.js";
+import { t as registerNodes2D } from "./register-ibCjm-wH.js";
+import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-CybQXNqS.js";
+import { a as NetworkManager, c as readSyncKey, i as sanitizeName, n as registerNodesNet, r as NetworkSpawner, s as findOwnerNode, t as createSplitScreen } from "./split-screen-CYwDkbLF.js";
 import { Box3, Euler, Matrix4, PerspectiveCamera, Quaternion, Vector3 } from "three";
 //#region src/test/framing.ts
 /**
@@ -1812,8 +1812,8 @@ async function playMultiplayer(opts) {
 */
 async function joinLate(server, first, opts) {
 	try {
-		const { Engine } = await import("./register-Cs53CY7s.js").then((n) => n.y);
-		const { loadScene } = await import("./loader-KZESOZmE.js").then((n) => n.r);
+		const { Engine } = await import("./register-3ta-2Xig.js").then((n) => n.y);
+		const { loadScene } = await import("./loader-BC4PNtJX.js").then((n) => n.r);
 		const { jsonClone } = await import("./json-CwwhxQgb.js").then((n) => n.i);
 		const engine = new Engine(opts.seed !== void 0 ? { seed: opts.seed + 999 } : {});
 		engine.setScene(loadScene(jsonClone(opts.scene), opts.load));
@@ -2175,20 +2175,23 @@ async function runScript(json, opts) {
 	if (opts.locale) engine.locale.locale = opts.locale;
 	const physics = opts.physics ?? "auto";
 	if (physics === "2d" || physics === "auto" && scene.dimension === "2d") {
-		const { enablePhysics2D } = await import("./physics-2d-_B6zj3zU.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-B7Y6dPZO.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-i1IeAY0F.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-bG3n70Ky.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const failures = [];
 	const snapshots = [];
+	const live = () => engine.scene ?? scene;
 	const ctx = {
 		engine,
-		scene,
+		get scene() {
+			return live();
+		},
 		timeMs: 0,
-		getNode: (path) => scene.root.getNode(path),
-		capture: () => captureScene(scene)
+		getNode: (path) => live().root.getNode(path),
+		capture: () => captureScene(live())
 	};
 	const applyStep = (step) => {
 		if (step.press) engine.input.pressAction(step.press);
@@ -2226,7 +2229,7 @@ async function runScript(json, opts) {
 		if (t >= nextSnapshot - 1e-6) {
 			snapshots.push({
 				atMs: Math.round(t),
-				capture: captureScene(scene)
+				capture: captureScene(live())
 			});
 			nextSnapshot += opts.snapshotEveryMs;
 		}
@@ -2239,7 +2242,7 @@ async function runScript(json, opts) {
 			message: `step never executed — atMs ${missed.atMs} is beyond the ${opts.durationMs}ms run`
 		});
 	}
-	const finalCapture = captureScene(scene);
+	const finalCapture = captureScene(live());
 	const logs = [...engine.log.entries()];
 	const swallowed = engine.stats().errors;
 	if (swallowed > 0) failures.push({
@@ -2291,10 +2294,10 @@ async function createPlaySession(json, opts = {}) {
 	engine.setScene(scene);
 	const physics = opts.physics ?? "auto";
 	if (physics === "2d" || physics === "auto" && scene.dimension === "2d") {
-		const { enablePhysics2D } = await import("./physics-2d-_B6zj3zU.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-B7Y6dPZO.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-i1IeAY0F.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-bG3n70Ky.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);
@@ -2302,7 +2305,9 @@ async function createPlaySession(json, opts = {}) {
 	let logCursor = 0;
 	return {
 		engine,
-		scene,
+		get scene() {
+			return engine.scene ?? scene;
+		},
 		get timeMs() {
 			return timeMs;
 		},
@@ -2315,10 +2320,10 @@ async function createPlaySession(json, opts = {}) {
 			return scene.toJSON();
 		},
 		describe() {
-			return describeCapture(captureScene(scene));
+			return describeCapture(captureScene(engine.scene ?? scene));
 		},
 		framing() {
-			return framingText(describeFraming(scene));
+			return framingText(describeFraming(engine.scene ?? scene));
 		},
 		drainLogs() {
 			const all = engine.log.entries();

package/dist/test.d.ts

@@ -1,8 +1,8 @@
-import { P as Scene, Pt as LogEntry, b as Engine, jt as Node, n as BehaviorCtor } from "./behavior-ZnfzKDo3.js";
-import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
-import { t as LoadSceneOptions } from "./loader-DyT30ArB.js";
-import { l as auditScene, o as IncantoError, r as ReplayJson } from "./replay-D0GcEHYU.js";
-import { l as LocalGameServerOptions, n as SplitScreenPlayer } from "./split-screen-DD5eYIgW.js";
+import { P as Scene, Pt as LogEntry, b as Engine, jt as Node, n as BehaviorCtor } from "./behavior-DoFPYrgo.js";
+import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-B6ugCV1Q.js";
+import { t as LoadSceneOptions } from "./loader-CcB533FR.js";
+import { l as auditScene, o as IncantoError, r as ReplayJson, u as instancedScenes } from "./replay-Dvn8aeBd.js";
+import { l as LocalGameServerOptions, n as SplitScreenPlayer } from "./split-screen-DhrSzZIB.js";
 
 //#region src/test/facing.d.ts
 interface FacingOptions {
@@ -689,4 +689,4 @@ interface PlaySession {
 */
 declare function createPlaySession(json: unknown, opts?: PlaySessionOptions): Promise<PlaySession>;
 //#endregion
-export { type AgreementSnapshot, type Disagreement, type DisagreementKind, type FacingOptions, type FacingReport, type FeelOptions, type FeelReport, type FramingEntry, type FramingOptions, type FramingReport, GroundingIssue, GroundingOptions, type LadderVerdict, type MultiplayOptions, type MultiplayPlayer, type MultiplayReport, NodeCapture, type Outcome, PlaySession, PlaySessionOptions, type PlaytestOptions, type PlaytestReport, type PlaytestRun, RunContext, RunFailure, RunResult, RunScriptOptions, type RungResult, type RungStatus, SceneCapture, ScriptStep, ValidateSceneOptions, ValidationResult, type Where, agreementProblems, auditScene, captureScene, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, findFloatingProps, findPlayer, framingText, ladderText, ladderVerdict, multiplayProblems, multiplayText, playMultiplayer, playtest, playtestText, registerAllNodes, runScript, takeAgreementSnapshots, validateScene };
+export { type AgreementSnapshot, type Disagreement, type DisagreementKind, type FacingOptions, type FacingReport, type FeelOptions, type FeelReport, type FramingEntry, type FramingOptions, type FramingReport, GroundingIssue, GroundingOptions, type LadderVerdict, type MultiplayOptions, type MultiplayPlayer, type MultiplayReport, NodeCapture, type Outcome, PlaySession, PlaySessionOptions, type PlaytestOptions, type PlaytestReport, type PlaytestRun, RunContext, RunFailure, RunResult, RunScriptOptions, type RungResult, type RungStatus, SceneCapture, ScriptStep, ValidateSceneOptions, ValidationResult, type Where, agreementProblems, auditScene, captureScene, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, findFloatingProps, findPlayer, framingText, instancedScenes, ladderText, ladderVerdict, multiplayProblems, multiplayText, playMultiplayer, playtest, playtestText, registerAllNodes, runScript, takeAgreementSnapshots, validateScene };

package/dist/test.js

@@ -1,3 +1,3 @@
-import { r as auditScene } from "./replay-BkpDV51O.js";
-import { C as describeFraming, S as playtestText, _ as facingReport, a as registerAllNodes, b as findPlayer, c as ladderText, d as multiplayText, f as playMultiplayer, g as agreementProblems, h as takeAgreementSnapshots, i as findFloatingProps, l as ladderVerdict, m as feelText, n as createPlaySession, o as runScript, p as feelReport, r as describeCapture, s as validateScene, t as captureScene, u as multiplayProblems, v as facingText, w as framingText, x as playtest, y as failingReplays } from "./test-81uZ967a.js";
-export { agreementProblems, auditScene, captureScene, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, findFloatingProps, findPlayer, framingText, ladderText, ladderVerdict, multiplayProblems, multiplayText, playMultiplayer, playtest, playtestText, registerAllNodes, runScript, takeAgreementSnapshots, validateScene };
+import { i as instancedScenes, r as auditScene } from "./replay-CYvhVHHN.js";
+import { C as describeFraming, S as playtestText, _ as facingReport, a as registerAllNodes, b as findPlayer, c as ladderText, d as multiplayText, f as playMultiplayer, g as agreementProblems, h as takeAgreementSnapshots, i as findFloatingProps, l as ladderVerdict, m as feelText, n as createPlaySession, o as runScript, p as feelReport, r as describeCapture, s as validateScene, t as captureScene, u as multiplayProblems, v as facingText, w as framingText, x as playtest, y as failingReplays } from "./test-8hoHeRmo.js";
+export { agreementProblems, auditScene, captureScene, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, findFloatingProps, findPlayer, framingText, instancedScenes, ladderText, ladderVerdict, multiplayProblems, multiplayText, playMultiplayer, playtest, playtestText, registerAllNodes, runScript, takeAgreementSnapshots, validateScene };

package/dist/vite.js

@@ -1,6 +1,6 @@
-import { t as VERSION } from "./src-BLlsGJW9.js";
+import { t as VERSION } from "./src-D7RIqXYF.js";
 import { n as diffSignatures } from "./frame-report-BSMny7oe.js";
-import { s as validateScene } from "./test-81uZ967a.js";
+import { s as validateScene } from "./test-8hoHeRmo.js";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, normalize, relative, resolve, sep } from "node:path";
 //#region src/vite/frame-endpoint.ts

package/dist/{rendering-options-ByAdi8PF.js → webgl-unavailable-N9nQqesw.js}

@@ -1,3 +1,4 @@
+import { t as IncantoError } from "./errors-BpWbnbb_.js";
 //#region src/core/drive-script.ts
 const num = (raw) => {
 	if (raw === void 0) return null;
@@ -181,4 +182,47 @@ function resolveRendering(environment, fallback, devicePixelRatio, explicit) {
 	};
 }
 //#endregion
-export { parseDrive as i, logReport as n, logText as r, resolveRendering as t };
+//#region src/core/webgl-unavailable.ts
+/**
+* Turn three's bare "Error creating WebGL context." into something a game can
+* act on.
+*
+* A machine with no GPU acceleration, a locked-down or headless browser, a
+* driver on the blocklist, or simply too many live contexts already: the call
+* throws synchronously from inside `new WebGLRenderer`, and three's message
+* says only that it failed. `createGame2D`/`createGame3D` did not catch it, and
+* every shipped starter removes its `#loading` overlay on the line AFTER the
+* await — so the player watched "100%" forever while the console held a
+* sentence nobody was looking at.
+*
+* Wrapping it costs nothing when WebGL works and gives the failure a code, so a
+* game can tell "this browser cannot run me" apart from "your scene is wrong"
+* without matching on three's wording.
+*/
+function withWebGLContext(make) {
+	try {
+		return make();
+	} catch (cause) {
+		if (cause instanceof IncantoError) throw cause;
+		throw new IncantoError("WEBGL_UNAVAILABLE", `this browser would not give the canvas a WebGL context. Usually one of: hardware acceleration is off, the GPU or driver is blocklisted, the page is running in a headless or locked-down browser, or too many WebGL contexts are already open on this page. Tell the player — a game that cannot draw should say so rather than wait. (three: ${String(cause?.message ?? cause)})`);
+	}
+}
+/**
+* Can this document make a WebGL context at all?
+*
+* The question a game wants BEFORE it boots, so the answer can be a screen
+* instead of an exception. Uses a throwaway canvas and never touches yours;
+* `false` outside a browser, where the question is not meaningful.
+*/
+function isWebGLAvailable() {
+	const doc = globalThis.document;
+	if (!doc) return false;
+	try {
+		const probe = doc.createElement("canvas");
+		return Boolean(probe.getContext("webgl2") ?? probe.getContext("webgl"));
+	} catch {
+		return false;
+	}
+}
+//#endregion
+export { logText as a, logReport as i, withWebGLContext as n, parseDrive as o, resolveRendering as r, isWebGLAvailable as t };

package/editor/assets/{agent8-C2jtNKbx.js → agent8-BrrHOjMJ.js}

@@ -1 +1 @@
-import{n as e}from"./index-CNqHojcC.js";async function t(t){return new n((await e(()=>import(`./GameServer-C56iOUgF.js`),[],import.meta.url)).GameServer,t)}var n=class{raw;active=new Map;reconnecting=!1;disposed=!1;constructor(e,t){this.raw=new e({...t})}get account(){return this.raw.account}get connected(){return this.raw.connected}connect(){return this.raw.connected?Promise.resolve(!0):(this.disposed=!1,this.rawConnect())}rawConnect(){return this.raw.connect({onDisconnect:()=>void this.reconnect()})}disconnect(){this.disposed=!0;for(let e of this.active.values())e.off();return this.active.clear(),this.raw.disconnect()}remoteFunction(e,t,n){return this.raw.remoteFunction(e,t,n)}track(e){let t=Symbol(`sub`),n={make:e,off:e()};return this.active.set(t,n),()=>{n.off(),this.active.delete(t)}}async reconnect(){if(!this.disposed&&!this.reconnecting){this.reconnecting=!0;try{await this.rawConnect();for(let e of this.active.values())e.off(),e.off=e.make()}finally{this.reconnecting=!1}}}subscribeRoomState(e,t){return this.track(()=>this.raw.subscribeRoomState(e,t))}subscribeRoomMyState(e,t){return this.track(()=>this.raw.subscribeRoomMyState(e,t))}subscribeRoomAllUserStates(e,t){return this.track(()=>this.raw.subscribeRoomAllUserStates(e,e=>{let n={};for(let t of e??[]){if(!t||typeof t.account!=`string`||t.__leaved)continue;let{account:e,__updated:r,__leaved:i,...a}=t;n[e]=a}t(n)}))}subscribeRoomCollection(e,t,n){return this.track(()=>this.raw.subscribeRoomCollection(e,t,({items:e})=>{let t={};for(let n of e??[])n&&typeof n.__id==`string`&&(t[n.__id]=n);n(t)}))}onRoomMessage(e,t,n){return this.track(()=>this.raw.onRoomMessage(e,t,n))}onRoomUserJoin(e,t){return this.track(()=>this.raw.onRoomUserJoin(e,t))}onRoomUserLeave(e,t){return this.track(()=>this.raw.onRoomUserLeave(e,t))}subscribeGlobalState(e){return this.track(()=>this.raw.subscribeGlobalState(e))}subscribeGlobalMyState(e){return this.track(()=>this.raw.subscribeGlobalMyState(e))}subscribeGlobalUserState(e,t){return this.track(()=>this.raw.subscribeGlobalUserState(e,t))}subscribeGlobalCollection(e,t){return this.track(()=>this.raw.subscribeGlobalCollection(e,({items:e})=>{let n={};for(let t of e??[])t&&typeof t.__id==`string`&&(n[t.__id]=t);t(n)}))}subscribeAsset(e,t){return this.track(()=>this.raw.subscribeAsset(e,t))}onGlobalMessage(e,t){return this.track(()=>this.raw.onGlobalMessage(e,t))}};export{t as createAgent8Server};
+import{n as e}from"./index-eVd0BToA.js";async function t(t){return new n((await e(()=>import(`./GameServer-C56iOUgF.js`),[],import.meta.url)).GameServer,t)}var n=class{raw;active=new Map;reconnecting=!1;disposed=!1;constructor(e,t){this.raw=new e({...t})}get account(){return this.raw.account}get connected(){return this.raw.connected}connect(){return this.raw.connected?Promise.resolve(!0):(this.disposed=!1,this.rawConnect())}rawConnect(){return this.raw.connect({onDisconnect:()=>void this.reconnect()})}disconnect(){this.disposed=!0;for(let e of this.active.values())e.off();return this.active.clear(),this.raw.disconnect()}remoteFunction(e,t,n){return this.raw.remoteFunction(e,t,n)}track(e){let t=Symbol(`sub`),n={make:e,off:e()};return this.active.set(t,n),()=>{n.off(),this.active.delete(t)}}async reconnect(){if(!this.disposed&&!this.reconnecting){this.reconnecting=!0;try{await this.rawConnect();for(let e of this.active.values())e.off(),e.off=e.make()}finally{this.reconnecting=!1}}}subscribeRoomState(e,t){return this.track(()=>this.raw.subscribeRoomState(e,t))}subscribeRoomMyState(e,t){return this.track(()=>this.raw.subscribeRoomMyState(e,t))}subscribeRoomAllUserStates(e,t){return this.track(()=>this.raw.subscribeRoomAllUserStates(e,e=>{let n={};for(let t of e??[]){if(!t||typeof t.account!=`string`||t.__leaved)continue;let{account:e,__updated:r,__leaved:i,...a}=t;n[e]=a}t(n)}))}subscribeRoomCollection(e,t,n){return this.track(()=>this.raw.subscribeRoomCollection(e,t,({items:e})=>{let t={};for(let n of e??[])n&&typeof n.__id==`string`&&(t[n.__id]=n);n(t)}))}onRoomMessage(e,t,n){return this.track(()=>this.raw.onRoomMessage(e,t,n))}onRoomUserJoin(e,t){return this.track(()=>this.raw.onRoomUserJoin(e,t))}onRoomUserLeave(e,t){return this.track(()=>this.raw.onRoomUserLeave(e,t))}subscribeGlobalState(e){return this.track(()=>this.raw.subscribeGlobalState(e))}subscribeGlobalMyState(e){return this.track(()=>this.raw.subscribeGlobalMyState(e))}subscribeGlobalUserState(e,t){return this.track(()=>this.raw.subscribeGlobalUserState(e,t))}subscribeGlobalCollection(e,t){return this.track(()=>this.raw.subscribeGlobalCollection(e,({items:e})=>{let n={};for(let t of e??[])t&&typeof t.__id==`string`&&(n[t.__id]=t);t(n)}))}subscribeAsset(e,t){return this.track(()=>this.raw.subscribeAsset(e,t))}onGlobalMessage(e,t){return this.track(()=>this.raw.onGlobalMessage(e,t))}};export{t as createAgent8Server};