incanto 0.60.0 → 0.62.0

package/dist/{behavior-DWKTUzKI.d.ts → behavior-DsgayMsH.d.ts}

@@ -551,6 +551,14 @@ interface SynthOptions {
   seed?: number;
 }
 /**
+* How long a preset lasts, in seconds — the same `attack + sustain + decay`
+* `synthSfx` uses to size its buffer.
+*
+* `pitch` deliberately does not enter into it: it is a frequency multiplier,
+* not a playback rate, so a preset played an octave up is the same length.
+*/
+declare function sfxDuration(params: SfxParams): number;
+/**
 * Render a preset to mono PCM in [-1, 1]. PURE: identical inputs → identical
 * output (the only randomness is the seeded noise generator), so determinism is
 * unit-testable headlessly. Length = ceil((attack+sustain+decay) * sampleRate).
@@ -1780,6 +1788,44 @@ declare class Engine {
   tick(nowMs: number): void;
 }
 //#endregion
+//#region src/core/prop-range.d.ts
+/**
+* The numeric range a prop documents, checked at LOAD.
+*
+* The docs give ranges constantly — `metalness`/`roughness` "0..1 … `-1` = keep
+* authored", `targetHeight` "> 0 uniformly scales the model", `opacity` 0..1 —
+* and the schema had no way to say so, so every one was a type check and
+* nothing more. Measured on `ModelInstance3D`:
+*
+* ```
+* targetHeight: -1.8   NO ERROR (kept -1.8)
+* metalness: 5         NO ERROR (kept 5)
+* roughness: -3        NO ERROR (kept -3)
+* ```
+*
+* The two failure modes differ, which is why neither is noticed. A negative
+* `targetHeight` folds into the same branch as "not set", so the model keeps
+* its authored size and looks like the prop did nothing; `metalness: 5` reaches
+* three and the surface goes wrong. An author who mistypes a decimal point gets
+* a different wrong answer depending on which prop they mistyped it in, and no
+* message in either case.
+*/
+interface PropRange {
+  /** Lowest accepted value. */
+  min?: number;
+  /** Highest accepted value. */
+  max?: number;
+  /** `min` is a bound the value must EXCEED, not reach (`targetHeight > 0`). */
+  exclusiveMin?: boolean;
+  /**
+  * Values outside the range that mean something anyway.
+  *
+  * `metalness: -1` is "keep whatever the GLB authored" — a real value with a
+  * real meaning, and the reason a range cannot just be a clamp.
+  */
+  allow?: readonly number[];
+}
+//#endregion
 //#region src/core/registry.d.ts
 /** A node prop definition. The default both documents and types the prop. */
 interface PropDef {
@@ -1808,6 +1854,38 @@ interface PropDef {
   */
   required?: boolean;
   /**
+  * This prop names an entry in the scene's `assets{}` block.
+  *
+  * Declaring it is what makes a typo a LOAD error. The check already existed —
+  * `AssetStore2D.resolve` throws `UNKNOWN_ASSET` — and it runs inside the
+  * renderer, in a browser, when the texture is first needed. Headless the
+  * scene loaded clean, so `incanto-check` certified a sprite that will draw
+  * nothing, and the docs' promise that "the engine hard-fails on a raw URL"
+  * was not true anywhere an author could see it.
+  *
+  * The same story as `nodePath` and `required`: the rule existed, nothing
+  * routed to it at author time.
+  */
+  /**
+  * The numeric range this prop documents.
+  *
+  * Without it a documented range is prose only: `metalness: 5` and
+  * `targetHeight: -1.8` both passed the kind check and then failed in two
+  * different silent ways. See prop-range.
+  */
+  range?: PropRange;
+  asset?: {
+    /** The `assets{}` entry `type` a `$ref` here must point at. */kind: "texture" | "spritesheet" | "model" | "animation";
+    /**
+    * A value that is not a `$ref` is an error.
+    *
+    * False for props that legitimately take something else — a raw URL
+    * (`UiImage.src`, `Sprite3D.texture`) or the name of a clip baked into a
+    * GLB (`ModelInstance3D.animation`).
+    */
+    refOnly?: boolean;
+  };
+  /**
   * For an OBJECT-valued prop shaped as a tagged union — `collider`, whose
   * `shape` decides which other keys are required. One declaration gives an
   * inspector both the dropdown AND something valid to write when the tag
@@ -1943,4 +2021,4 @@ declare function registeredBehaviors(): string[];
 /** Test isolation helper. */
 declare function clearBehaviors(): void;
 //#endregion
-export { T_PREFIX as $, SettingsValues as A, Node as At, captureBehaviors as B, EngineStats as C, synthSfx as Ct, QualityCaps as D, PlayMusicOptions as Dt, DeviceHints as E, MusicTrack as Et, BehaviorState as F, LogManager as Ft, ORDER_GROUP_BASE as G, savesWithoutUid as H, RestoreReport as I, Signal as It, effectiveOrder as J, OrderGroup as K, SaveSlot as L, SignalListener as Lt, readDeviceHints as M, SceneTree as Mt, suggestQuality as N, LogEntry as Nt, QualityTier as O, AudioBuses as Ot, Scene as P, LogLevel as Pt, Localization as Q, SaveSlots as R, Scheduler as S, SynthOptions as St, RendererStats as T, MusicManager as Tt, SaveStore as U, restoreBehaviors as V, createSaveStore as W, BASE_LOCALE as X, resolveOrderGroups as Y, LocaleTables as Z, mergeStaticSignals as _, spatialPan as _t, clearBehaviors as a, EffectLog as at, Engine as b, SfxParams as bt, registeredBehaviors as c, isAudioContextAvailable as ct, PropSchema as d, Listener as dt, suggestLocale as et, clearRegistry as f, ROLLOFF_MODELS as ft, getNodeType as g, spatialGain as gt, getNodeSignals as h, Vec3 as ht, behaviorSignals as i, EffectKind as it, qualityEnvironment as j, NodeLifecycle as jt, Settings as k, BusName as kt, NodeCtor as l, Voice as lt, getNodeSchema as m, SpatialParams as mt, BehaviorCtor as n, InputMap as nt, getBehavior as o, SfxEngine as ot, createNode as p, RolloffModel as pt, OrderGroupTable as q, behaviorSchema as r, EffectEvent as rt, registerBehavior as s, SfxPlayOptions as st, Behavior as t, translationKey as tt, PropDef as u, VoicePreset as ut, registerNode as v, SFX_PRESETS as vt, GameStats as w, MusicBackend as wt, EngineOptions as x, SfxWave as xt, registeredTypes as y, SFX_PRESET_NAMES as yt, behaviorsWithoutSave as z };
+export { T_PREFIX as $, SettingsValues as A, BusName as At, captureBehaviors as B, EngineStats as C, sfxDuration as Ct, QualityCaps as D, MusicTrack as Dt, DeviceHints as E, MusicManager as Et, BehaviorState as F, LogLevel as Ft, ORDER_GROUP_BASE as G, savesWithoutUid as H, RestoreReport as I, LogManager as It, effectiveOrder as J, OrderGroup as K, SaveSlot as L, Signal as Lt, readDeviceHints as M, NodeLifecycle as Mt, suggestQuality as N, SceneTree as Nt, QualityTier as O, PlayMusicOptions as Ot, Scene as P, LogEntry as Pt, Localization as Q, SaveSlots as R, SignalListener as Rt, Scheduler as S, SynthOptions as St, RendererStats as T, MusicBackend as Tt, SaveStore as U, restoreBehaviors as V, createSaveStore as W, BASE_LOCALE as X, resolveOrderGroups as Y, LocaleTables as Z, mergeStaticSignals as _, spatialPan as _t, clearBehaviors as a, EffectLog as at, Engine as b, SfxParams as bt, registeredBehaviors as c, isAudioContextAvailable as ct, PropSchema as d, Listener as dt, suggestLocale as et, clearRegistry as f, ROLLOFF_MODELS as ft, getNodeType as g, spatialGain as gt, getNodeSignals as h, Vec3 as ht, behaviorSignals as i, EffectKind as it, qualityEnvironment as j, Node as jt, Settings as k, AudioBuses as kt, NodeCtor as l, Voice as lt, getNodeSchema as m, SpatialParams as mt, BehaviorCtor as n, InputMap as nt, getBehavior as o, SfxEngine as ot, createNode as p, RolloffModel as pt, OrderGroupTable as q, behaviorSchema as r, EffectEvent as rt, registerBehavior as s, SfxPlayOptions as st, Behavior as t, translationKey as tt, PropDef as u, VoicePreset as ut, registerNode as v, SFX_PRESETS as vt, GameStats as w, synthSfx as wt, EngineOptions as x, SfxWave as xt, registeredTypes as y, SFX_PRESET_NAMES as yt, behaviorsWithoutSave as z };

package/dist/{create-game-ClnIb_M5.js → create-game-BpunnGPX.js}

@@ -1,14 +1,14 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { c as resolveViewport, j as registerBehavior, n as loadScene, s as computeViewport, w as diagnose } from "./loader-D8n7TU8W.js";
-import { _ as Engine, g as AudioPlayer } from "./register-Da3hXh2H.js";
+import { d as computeViewport, f as resolveViewport, k as diagnose, n as loadScene, z as registerBehavior } from "./loader-DEe272nY.js";
+import { _ as AudioPlayer, v as Engine } from "./register-D3yx8D4r.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-DESwnpOc.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-CTTwhWSe.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-C7qP-dcC.js";
 import { o as frameStats } from "./frame-report-BSMny7oe.js";
-import { n as registerGameplayBehaviors } from "./gameplay-BBEjPFsR.js";
-import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-BSu2dWGC.js";
+import { n as registerGameplayBehaviors } from "./gameplay-CaHqDiQD.js";
+import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-CNh4FlbD.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { n as enablePhysics2D } from "./physics-2d-DqdVp1bt.js";
+import { n as enablePhysics2D } from "./physics-2d-BXmu2i7W.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
 /**
@@ -199,14 +199,19 @@ function selectionOutline2D(node) {
 function createSync2DScratch() {
 	return {
 		visited: /* @__PURE__ */ new Set(),
-		cameras: []
+		cameras: [],
+		emitters: []
 	};
 }
+function isSpatialConsumer(node) {
+	return node.spatial === true && typeof node._setSpatialPose === "function";
+}
 function syncTree2D(root, world, ui, assets, uiSize, scratch, opts) {
 	const s = scratch ?? createSync2DScratch();
 	s.visited.clear();
 	s.cameras.length = 0;
-	walk(root, world, ui, false, s.visited, s.cameras, assets, uiSize, opts?.ignoreStatic === true);
+	s.emitters.length = 0;
+	walk(root, world, ui, false, s.visited, s.cameras, s.emitters, assets, uiSize, opts?.ignoreStatic === true);
 	prune(world, s.visited);
 	prune(ui, s.visited);
 	let current = null;
@@ -218,9 +223,66 @@ function syncTree2D(root, world, ui, assets, uiSize, scratch, opts) {
 		}
 	}
 	if (!current) current = s.cameras[0] ?? null;
+	feedSpatialEmitters2D(s.emitters, current);
 	return { activeCamera: current };
 }
-function walk(node, parentObj, ui, inUi, visited, cameras, assets, uiSize, ignoreStatic) {
+const emitterScratch = new Vector3();
+const listenerScratch = new Vector3();
+const upScratch = new Vector3();
+/**
+* Give a 2D scene's spatial AudioPlayers the same per-frame pose the 3D sync
+* gives its own.
+*
+* `spatial`, `refDistance`, `maxDistance` and `rolloff` have been props of
+* `AudioPlayer` since positional audio landed, and in a 2D scene all four did
+* NOTHING: the node only attenuates when an adapter pushes it a pose, and only
+* the 3D one ever did. The scene loaded, `incanto check` said valid, and the
+* sound played at full volume from the far side of the level.
+*
+* The listener is the active `Camera2D` — its world position is the view
+* centre, its own rotation turns the stereo image with it, and the view looks
+* down −Z like every other camera. Distances are therefore in the same units
+* the rest of a 2D scene is in: PIXELS. `refDistance: 1` / `maxDistance: 50`
+* are metre-shaped defaults and read as "silent one sprite away" here, so a 2D
+* scene has to set them; `auditScene` says so when it sees the defaults.
+*/
+function feedSpatialEmitters2D(emitters, camera) {
+	if (emitters.length === 0 || !camera) return;
+	const view = camera._ensureObject2D();
+	view.updateWorldMatrix(true, false);
+	view.getWorldPosition(listenerScratch);
+	upScratch.set(0, 1, 0).applyQuaternion(view.quaternion);
+	const listener = {
+		position: [
+			listenerScratch.x,
+			listenerScratch.y,
+			0
+		],
+		forward: [
+			0,
+			0,
+			-1
+		],
+		up: [
+			upScratch.x,
+			upScratch.y,
+			upScratch.z
+		]
+	};
+	for (const { node, parent } of emitters) {
+		parent.updateWorldMatrix(true, false);
+		parent.getWorldPosition(emitterScratch);
+		node._setSpatialPose({
+			position: [
+				emitterScratch.x,
+				emitterScratch.y,
+				0
+			],
+			listener
+		});
+	}
+}
+function walk(node, parentObj, ui, inUi, visited, cameras, emitters, assets, uiSize, ignoreStatic) {
 	let nextParent = parentObj;
 	let nextInUi = inUi;
 	if (node instanceof Node2D && !(node instanceof UILayer)) {
@@ -249,11 +311,14 @@ function walk(node, parentObj, ui, inUi, visited, cameras, assets, uiSize, ignor
 		visited.add(obj);
 		if (node instanceof Camera2D && !inUi) cameras.push(node);
 		nextParent = obj;
-	}
-	for (const child of node.children) walk(child, nextParent, ui, nextInUi, visited, cameras, assets, uiSize, ignoreStatic);
+	} else if (isSpatialConsumer(node)) emitters.push({
+		node,
+		parent: nextParent
+	});
+	for (const child of node.children) walk(child, nextParent, ui, nextInUi, visited, cameras, emitters, assets, uiSize, ignoreStatic);
 	if (node instanceof Node2D && !(node instanceof UILayer)) {
 		const obj = node._ensureObject2D();
-		if (node.static && !ignoreStatic) {
+		if (node.static && !ignoreStatic && node._staticReady(assets)) {
 			obj.userData.incantoStaticSynced = true;
 			obj.userData.incantoStatic = true;
 		} else if (obj.userData.incantoStaticSynced === true) {
@@ -474,7 +539,7 @@ var Renderer2D = class {
 		const { activeCamera } = syncTree2D(scene.root, this.worldScene, this.uiScene, this.assets, {
 			width: uiW,
 			height: uiH
-		}, this.syncScratch);
+		}, this.syncScratch, { ignoreStatic: this.ignoreStatic });
 		let center = vp ? {
 			x: vp.design[0] / 2,
 			y: vp.design[1] / 2

package/dist/{create-game-BCm38FJV.js → create-game-Caut3bqN.js}

@@ -1,14 +1,14 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { j as registerBehavior, n as loadScene, w as diagnose } from "./loader-D8n7TU8W.js";
-import { S as qualityRendering, _ as Engine, b as qualityCaps, g as AudioPlayer } from "./register-Da3hXh2H.js";
+import { c as parseEnvironment3D, k as diagnose, n as loadScene, s as horizonColorFromSky, u as sunDirectionFromSky, z as registerBehavior } from "./loader-DEe272nY.js";
+import { C as qualityRendering, _ as AudioPlayer, v as Engine, x as qualityCaps } from "./register-D3yx8D4r.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-DESwnpOc.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-CTTwhWSe.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-C7qP-dcC.js";
 import { o as frameStats } from "./frame-report-BSMny7oe.js";
-import { R as PhysicsBody3D, U as createCausticsQuad, V as Node3D, n as registerGameplayBehaviors } from "./gameplay-BBEjPFsR.js";
+import { K as createCausticsQuad, V as PhysicsBody3D, W as Node3D, n as registerGameplayBehaviors } from "./gameplay-CaHqDiQD.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-8cjF3t6w.js";
-import { n as enablePhysics3D } from "./physics-3d-BP0DZb_1.js";
+import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-BAWeOeqf.js";
+import { n as enablePhysics3D } from "./physics-3d-ClxP6Uv7.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";
@@ -125,6 +125,10 @@ var AssetStore3D = class {
 			} else entry.scene = gltf.scene;
 			entry.animations = gltf.animations ?? [];
 			entry.status = "ready";
+			if (!hasAnyMesh(entry.scene)) {
+				entry.error = "loaded, but it contains no meshes — this is an animation-only GLB. A clip file belongs in `animation`, not `model`.";
+				diagnose(this.engine, "error", `incanto: '${url}' ${entry.error}`);
+			}
 		}, void 0, (error) => {
 			entry.status = "error";
 			entry.error = error instanceof Error ? error.message : String(error);
@@ -172,6 +176,16 @@ var AssetStore3D = class {
 		this.animations.clear();
 	}
 };
+/** Does this loaded scene graph contain anything that will actually draw? */
+function hasAnyMesh(scene) {
+	const walk = scene?.traverse;
+	if (!walk) return true;
+	let found = false;
+	walk.call(scene, (o) => {
+		if (o.isMesh) found = true;
+	});
+	return found;
+}
 //#endregion
 //#region src/core/yield-frame.ts
 /**
@@ -226,293 +240,6 @@ function yieldToFrame(maxWaitMs = DEFAULT_MAX_WAIT_MS, raf = typeof requestAnima
 	});
 }
 //#endregion
-//#region src/3d/environment.ts
-const SKY_KEYS = [
-	"type",
-	"sunPosition",
-	"elevationDeg",
-	"azimuthDeg",
-	"turbidity",
-	"rayleigh"
-];
-const FOG_KEYS = [
-	"color",
-	"near",
-	"far"
-];
-const CLOUD_KEYS = [
-	"coverage",
-	"density",
-	"base",
-	"top",
-	"color",
-	"shadeColor",
-	"speed",
-	"scale"
-];
-const BLOOM_KEYS = ["threshold", "strength"];
-const POST_KEYS = [
-	"vignette",
-	"saturation",
-	"contrast"
-];
-const SHADOW_KEYS = [
-	"mapSize",
-	"radius",
-	"static"
-];
-const SHADOW_MAP_SIZES = [1024, 2048];
-const DEFAULT_TURBIDITY = 2;
-const DEFAULT_RAYLEIGH = 1;
-const DEFAULT_FOG_NEAR = 50;
-const DEFAULT_FOG_FAR = 800;
-/** Fallback haze when fog is declared without a sky to derive a horizon from. */
-const DEFAULT_FOG_COLOR = "#cfd8e0";
-const DEG2RAD = Math.PI / 180;
-/** Parse + hard-validate the 3D slice of a scene's `environment` header. */
-function parseEnvironment3D(env) {
-	return {
-		exposure: parseExposure(env?.exposure),
-		sky: parseSky(env?.sky),
-		fog: parseFog(env?.fog, env?.sky !== void 0),
-		clouds: parseClouds(env?.clouds),
-		bloom: parseBloom(env?.bloom),
-		post: parsePost(env?.post),
-		shadows: parseShadows(env?.shadows)
-	};
-}
-/**
-* elevation/azimuth (degrees) → unit direction. Matches three's Sky example
-* (`Vector3.setFromSphericalCoords`): azimuth 0 = +Z, 90 = +X; elevation 90 =
-* straight up.
-*/
-function sunDirectionFromElevationAzimuth(elevationDeg, azimuthDeg) {
-	const phi = (90 - elevationDeg) * DEG2RAD;
-	const theta = azimuthDeg * DEG2RAD;
-	return [
-		Math.sin(phi) * Math.sin(theta),
-		Math.cos(phi),
-		Math.sin(phi) * Math.cos(theta)
-	];
-}
-/** The sky's sun as a UNIT vector — what Water3D/Foliage3D uniforms consume. */
-function sunDirectionFromSky(sky) {
-	const [x, y, z] = sky.sunPosition;
-	const len = Math.hypot(x, y, z) || 1;
-	return [
-		x / len,
-		y / len,
-		z / len
-	];
-}
-/**
-* A horizon-ish haze color derived from the sky config — the default fog
-* color. Cheap model, judged by eye: clear skies haze blue-grey, turbid skies
-* whiten, and a low sun warms the band toward amber.
-*/
-function horizonColorFromSky(sky) {
-	const clear = [
-		191,
-		213,
-		232
-	];
-	const hazy = [
-		233,
-		228,
-		217
-	];
-	const warm = [
-		242,
-		201,
-		150
-	];
-	const t = clamp01((sky.turbidity - DEFAULT_TURBIDITY) / 8);
-	const dir = sunDirectionFromSky(sky);
-	const w = clamp01((18 - Math.asin(clamp(dir[1], -1, 1)) / DEG2RAD) / 18) * .8;
-	const mix = (i) => Math.round(lerp(lerp(clear[i], hazy[i], t), warm[i], w));
-	return `#${[
-		mix(0),
-		mix(1),
-		mix(2)
-	].map((c) => c.toString(16).padStart(2, "0")).join("")}`;
-}
-function parseExposure(value) {
-	if (value === void 0) return 1;
-	if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) throw new IncantoError("BAD_FORMAT", `environment.exposure must be a finite number > 0 (tone-mapping exposure, default 1), got ${JSON.stringify(value)}.`, { prop: "exposure" });
-	return value;
-}
-function parseSky(value) {
-	if (value === void 0) return null;
-	if (typeof value !== "object" || value === null || Array.isArray(value)) throw new IncantoError("BAD_FORMAT", `environment.sky must be an object ({ type?: "atmosphere", sunPosition? | elevationDeg?+azimuthDeg?, turbidity?, rayleigh? }), got ${JSON.stringify(value)}.`, { prop: "sky" });
-	const sky = value;
-	for (const key of Object.keys(sky)) if (!SKY_KEYS.includes(key)) throw new IncantoError("BAD_FORMAT", `environment.sky has unknown key '${key}'. Valid keys: [${SKY_KEYS.join(", ")}].`, {
-		prop: "sky",
-		validOptions: SKY_KEYS
-	});
-	if (sky.type !== void 0 && sky.type !== "atmosphere") throw new IncantoError("BAD_FORMAT", `environment.sky.type must be 'atmosphere' (the only sky type so far), got ${JSON.stringify(sky.type)}.`, {
-		prop: "sky",
-		validOptions: ["atmosphere"]
-	});
-	const hasAngles = sky.elevationDeg !== void 0 || sky.azimuthDeg !== void 0;
-	if (sky.sunPosition !== void 0 && hasAngles) throw new IncantoError("BAD_FORMAT", `environment.sky takes sunPosition OR elevationDeg/azimuthDeg, not both.`, {
-		prop: "sky",
-		validOptions: ["sunPosition", "elevationDeg+azimuthDeg"]
-	});
-	let sunPosition;
-	if (sky.sunPosition !== void 0) {
-		const sp = sky.sunPosition;
-		if (!Array.isArray(sp) || sp.length !== 3 || !sp.every((v) => typeof v === "number" && Number.isFinite(v)) || Math.hypot(sp[0], sp[1], sp[2]) === 0) throw new IncantoError("BAD_FORMAT", `environment.sky.sunPosition must be a non-zero [x, y, z] vector, got ${JSON.stringify(sp)}.`, { prop: "sky" });
-		sunPosition = [
-			sp[0],
-			sp[1],
-			sp[2]
-		];
-	} else {
-		const elevation = numberOr(sky.elevationDeg, 32, "sky.elevationDeg");
-		const azimuth = numberOr(sky.azimuthDeg, 135, "sky.azimuthDeg");
-		if (elevation < -90 || elevation > 90) throw new IncantoError("BAD_FORMAT", `environment.sky.elevationDeg must be in [-90, 90] (degrees above the horizon), got ${elevation}.`, { prop: "sky" });
-		sunPosition = sunDirectionFromElevationAzimuth(elevation, azimuth);
-	}
-	const turbidity = numberOr(sky.turbidity, DEFAULT_TURBIDITY, "sky.turbidity");
-	if (turbidity <= 0) throw new IncantoError("BAD_FORMAT", `environment.sky.turbidity must be > 0 (atmospheric haze; 2 ≈ clear day), got ${turbidity}.`, { prop: "sky" });
-	const rayleigh = numberOr(sky.rayleigh, DEFAULT_RAYLEIGH, "sky.rayleigh");
-	if (rayleigh < 0) throw new IncantoError("BAD_FORMAT", `environment.sky.rayleigh must be >= 0 (Rayleigh scattering; 1 ≈ earth-like), got ${rayleigh}.`, { prop: "sky" });
-	return {
-		sunPosition,
-		turbidity,
-		rayleigh
-	};
-}
-function parseFog(value, hasSky) {
-	if (value === void 0) return null;
-	if (typeof value !== "object" || value === null || Array.isArray(value)) throw new IncantoError("BAD_FORMAT", `environment.fog must be an object ({ color?, near?, far? }), got ${JSON.stringify(value)}.`, { prop: "fog" });
-	const fog = value;
-	for (const key of Object.keys(fog)) if (!FOG_KEYS.includes(key)) throw new IncantoError("BAD_FORMAT", `environment.fog has unknown key '${key}'. Valid keys: [${FOG_KEYS.join(", ")}].`, {
-		prop: "fog",
-		validOptions: FOG_KEYS
-	});
-	if (fog.color !== void 0 && typeof fog.color !== "string") throw new IncantoError("BAD_FORMAT", `environment.fog.color must be a hex color string, got ${JSON.stringify(fog.color)}.`, { prop: "fog" });
-	const near = numberOr(fog.near, DEFAULT_FOG_NEAR, "fog.near");
-	const far = numberOr(fog.far, DEFAULT_FOG_FAR, "fog.far");
-	if (near < 0) throw new IncantoError("BAD_FORMAT", `environment.fog.near must be >= 0 meters, got ${near}.`, { prop: "fog" });
-	if (far <= near) throw new IncantoError("BAD_FORMAT", `environment.fog.far must be > near (got near ${near}, far ${far}).`, { prop: "fog" });
-	return {
-		color: fog.color ?? (hasSky ? "" : DEFAULT_FOG_COLOR),
-		near,
-		far
-	};
-}
-function parseClouds(value) {
-	if (value === void 0) return null;
-	if (typeof value !== "object" || value === null || Array.isArray(value)) throw new IncantoError("BAD_FORMAT", `environment.clouds must be an object ({ coverage?, density?, base?, top?, color?, shadeColor?, speed?, scale? }), got ${JSON.stringify(value)}.`, { prop: "clouds" });
-	const c = value;
-	for (const key of Object.keys(c)) if (!CLOUD_KEYS.includes(key)) throw new IncantoError("BAD_FORMAT", `environment.clouds has unknown key '${key}'. Valid keys: [${CLOUD_KEYS.join(", ")}].`, {
-		prop: "clouds",
-		validOptions: CLOUD_KEYS
-	});
-	for (const k of ["color", "shadeColor"]) if (c[k] !== void 0 && typeof c[k] !== "string") throw new IncantoError("BAD_FORMAT", `environment.clouds.${k} must be a hex color string, got ${JSON.stringify(c[k])}.`, { prop: "clouds" });
-	const coverage = numberOr(c.coverage, .5, "clouds.coverage");
-	if (coverage < 0 || coverage > 1) throw new IncantoError("BAD_FORMAT", `environment.clouds.coverage must be in [0, 1] (how much sky is cloudy), got ${coverage}.`, { prop: "clouds" });
-	const density = numberOr(c.density, 1, "clouds.density");
-	if (density < 0) throw new IncantoError("BAD_FORMAT", `environment.clouds.density must be >= 0 (optical thickness), got ${density}.`, { prop: "clouds" });
-	const base = numberOr(c.base, 120, "clouds.base");
-	const top = numberOr(c.top, 320, "clouds.top");
-	if (top <= base) throw new IncantoError("BAD_FORMAT", `environment.clouds.top must be > base (got base ${base}, top ${top}).`, { prop: "clouds" });
-	const speed = numberOr(c.speed, 1, "clouds.speed");
-	const scale = numberOr(c.scale, 240, "clouds.scale");
-	if (scale <= 0) throw new IncantoError("BAD_FORMAT", `environment.clouds.scale must be > 0 (feature size in world units), got ${scale}.`, { prop: "clouds" });
-	return {
-		coverage,
-		density,
-		base,
-		top,
-		color: c.color ?? "#ffffff",
-		shadeColor: c.shadeColor ?? "#9fb0c8",
-		speed,
-		scale
-	};
-}
-function parseBloom(value) {
-	if (value === void 0) return null;
-	if (typeof value !== "object" || value === null || Array.isArray(value)) throw new IncantoError("BAD_FORMAT", `environment.bloom must be an object ({ threshold?, strength? }), got ${JSON.stringify(value)}.`, { prop: "bloom" });
-	const b = value;
-	for (const key of Object.keys(b)) if (!BLOOM_KEYS.includes(key)) throw new IncantoError("BAD_FORMAT", `environment.bloom has unknown key '${key}'. Valid keys: [${BLOOM_KEYS.join(", ")}].`, {
-		prop: "bloom",
-		validOptions: BLOOM_KEYS
-	});
-	const threshold = numberOr(b.threshold, 1, "bloom.threshold");
-	if (threshold < 0 || threshold > 8) throw new IncantoError("BAD_FORMAT", `environment.bloom.threshold must be in [0, 8] (linear-HDR luminance; 1 = white), got ${threshold}.`, { prop: "bloom" });
-	const strength = numberOr(b.strength, .8, "bloom.strength");
-	if (strength < 0) throw new IncantoError("BAD_FORMAT", `environment.bloom.strength must be >= 0, got ${strength}.`, { prop: "bloom" });
-	return {
-		threshold,
-		strength
-	};
-}
-function parsePost(value) {
-	if (value === void 0) return null;
-	if (typeof value !== "object" || value === null || Array.isArray(value)) throw new IncantoError("BAD_FORMAT", `environment.post must be an object ({ vignette?, saturation?, contrast? }), got ${JSON.stringify(value)}.`, { prop: "post" });
-	const p = value;
-	for (const key of Object.keys(p)) if (!POST_KEYS.includes(key)) throw new IncantoError("BAD_FORMAT", `environment.post has unknown key '${key}'. Valid keys: [${POST_KEYS.join(", ")}].`, {
-		prop: "post",
-		validOptions: POST_KEYS
-	});
-	const vignette = numberOr(p.vignette, 0, "post.vignette");
-	if (vignette < 0 || vignette > 1) throw new IncantoError("BAD_FORMAT", `environment.post.vignette must be in [0, 1], got ${vignette}.`, { prop: "post" });
-	const saturation = numberOr(p.saturation, 1, "post.saturation");
-	if (saturation < 0 || saturation > 4) throw new IncantoError("BAD_FORMAT", `environment.post.saturation must be in [0, 4] (1 = neutral), got ${saturation}.`, { prop: "post" });
-	const contrast = numberOr(p.contrast, 1, "post.contrast");
-	if (contrast < .2 || contrast > 3) throw new IncantoError("BAD_FORMAT", `environment.post.contrast must be in [0.2, 3] (1 = neutral), got ${contrast}.`, { prop: "post" });
-	return {
-		vignette,
-		saturation,
-		contrast
-	};
-}
-function parseShadows(value) {
-	if (value === void 0) return null;
-	if (value === false) return false;
-	if (value === true) return {
-		mapSize: 2048,
-		radius: 1,
-		static: false
-	};
-	if (typeof value !== "object" || value === null || Array.isArray(value)) throw new IncantoError("BAD_FORMAT", `environment.shadows must be true, false or an object ({ mapSize?, radius? }), got ${JSON.stringify(value)}.`, { prop: "shadows" });
-	const shadows = value;
-	for (const key of Object.keys(shadows)) if (!SHADOW_KEYS.includes(key)) throw new IncantoError("BAD_FORMAT", `environment.shadows has unknown key '${key}'. Valid keys: [${SHADOW_KEYS.join(", ")}].`, {
-		prop: "shadows",
-		validOptions: SHADOW_KEYS
-	});
-	const mapSize = shadows.mapSize === void 0 ? 2048 : shadows.mapSize;
-	if (!SHADOW_MAP_SIZES.includes(mapSize)) throw new IncantoError("BAD_FORMAT", `environment.shadows.mapSize must be one of [${SHADOW_MAP_SIZES.join(", ")}], got ${JSON.stringify(shadows.mapSize)}.`, {
-		prop: "shadows",
-		validOptions: SHADOW_MAP_SIZES.map(String)
-	});
-	const radius = numberOr(shadows.radius, 1, "shadows.radius");
-	if (radius < 0) throw new IncantoError("BAD_FORMAT", `environment.shadows.radius must be >= 0, got ${radius}.`, { prop: "shadows" });
-	const staticShadows = shadows.static === void 0 ? false : shadows.static;
-	if (typeof staticShadows !== "boolean") throw new IncantoError("BAD_FORMAT", `environment.shadows.static must be a boolean, got ${JSON.stringify(shadows.static)}.`, { prop: "shadows" });
-	return {
-		mapSize,
-		radius,
-		static: staticShadows
-	};
-}
-function numberOr(value, fallback, at) {
-	if (value === void 0) return fallback;
-	if (typeof value !== "number" || !Number.isFinite(value)) throw new IncantoError("BAD_FORMAT", `environment.${at} must be a finite number, got ${JSON.stringify(value)}.`, { prop: at });
-	return value;
-}
-function clamp(v, min, max) {
-	return Math.min(Math.max(v, min), max);
-}
-function clamp01(v) {
-	return clamp(v, 0, 1);
-}
-function lerp(a, b, t) {
-	return a + (b - a) * t;
-}
-//#endregion
 //#region src/3d/environment-runtime.ts
 /**
 * Live environment editing — the renderer re-applies `scene.environment`
@@ -2666,4 +2393,4 @@ function wireAudioUnlock(engine, root, canvas) {
 	return detachAll;
 }
 //#endregion
-export { Environment3D as a, parseEnvironment3D as c, AssetStore3D as d, syncTree as i, sunDirectionFromElevationAzimuth as l, create_game_exports as n, setEnvironment3D as o, Renderer3D as r, horizonColorFromSky as s, createGame3D as t, sunDirectionFromSky as u };
+export { Environment3D as a, syncTree as i, create_game_exports as n, setEnvironment3D as o, Renderer3D as r, AssetStore3D as s, createGame3D as t };

package/dist/debug.d.ts

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

package/dist/debug.js

@@ -1,5 +1,5 @@
 import { t as jsonClone } from "./json-CwwhxQgb.js";
-import { s as mergeStaticProps } from "./registry-WWcQcfMr.js";
+import { s as mergeStaticProps } from "./registry-CF70EArN.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
 //#region src/debug/capture.ts
 /**

package/dist/{duplicate-DJQd44CD.js → duplicate-E4FUs5Bn.js}

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