incanto 0.59.0 → 0.61.0

package/dist/{create-game-BiW8Men_.js → create-game-IX5lEH0P.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-CDrAQqPp.js";
+import { c as parseEnvironment3D, k as diagnose, n as loadScene, s as horizonColorFromSky, u as sunDirectionFromSky, z as registerBehavior } from "./loader-D7jTvDQv.js";
+import { S as qualityRendering, _ as Engine, b as qualityCaps, g as AudioPlayer } from "./register-xuSRyD6b.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-RApWnM1G.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-B6rwJOyS.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 { R as PhysicsBody3D, U as createCausticsQuad, V as Node3D, n as registerGameplayBehaviors } from "./gameplay-Dtzd2itW.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-DRAz5EV9.js";
-import { n as enablePhysics3D } from "./physics-3d-CYxjh-HW.js";
+import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-CNxCuhZF.js";
+import { n as enablePhysics3D } from "./physics-3d-BTUfUSWO.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-CGqAmK2h.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-D7jTvDQv.js";
 //#region src/core/scene/duplicate.ts
 function stripUids(json) {
 	const { uid: _uid, ...rest } = json;

package/dist/editor.js

@@ -2372,7 +2372,8 @@ function Bn(e, t, n) {
 var Vn = [
 	"connections",
 	"input",
-	"multiplayer"
+	"multiplayer",
+	"strings"
 ];
 function Hn(e, t, n) {
 	e.appendChild(Tr("scene")), e.appendChild(Ar("name", String(t.working.name ?? ""), (e) => {

package/dist/{environment-presets-DRAz5EV9.js → environment-presets-CNxCuhZF.js}

@@ -1,11 +1,11 @@
-import { w as diagnose } from "./loader-D8n7TU8W.js";
-import { I as translateOn, t as registerCoreNodes } from "./register-CDrAQqPp.js";
+import { k as diagnose } from "./loader-D7jTvDQv.js";
+import { I as translateOn, t as registerCoreNodes } from "./register-xuSRyD6b.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-WWcQcfMr.js";
+import { i as getNodeSchema, l as registerNode } from "./registry-CF70EArN.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
 import { i as ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, r as validateAnimationAliases, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-CY-mrr1L.js";
-import { B as StaticBody3D, F as WaterCutout3D, G as colliderFootDrop, I as Area3D, L as CharacterBody3D, N as Water3D, R as PhysicsBody3D, V as Node3D, w as tolerateUnknownAction, z as RigidBody3D } from "./gameplay-BBEjPFsR.js";
+import { B as StaticBody3D, F as WaterCutout3D, G as colliderFootDrop, I as Area3D, L as CharacterBody3D, N as Water3D, R as PhysicsBody3D, V as Node3D, w as tolerateUnknownAction, z as RigidBody3D } from "./gameplay-Dtzd2itW.js";
 import { t as checkSheetGrid } from "./sheet-grid-BT6N_Bjs.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
 import { AdditiveBlending, AnimationClip, AnimationMixer, Box3, BoxGeometry, BufferAttribute, BufferGeometry, CanvasTexture, CapsuleGeometry, ClampToEdgeWrapping, Color, ConeGeometry, CylinderGeometry, DataTexture, DirectionalLight, DoubleSide, DynamicDrawUsage, Euler, Group, IcosahedronGeometry, ImageBitmapLoader, InstancedBufferAttribute, InstancedMesh, LinearFilter, LinearMipmapLinearFilter, LoopOnce, LoopRepeat, Matrix4, Mesh, MeshBasicMaterial, MeshDepthMaterial, MeshPhysicalMaterial, MeshStandardMaterial, NearestFilter, NoBlending, NoColorSpace, NormalBlending, PerspectiveCamera, PlaneGeometry, PointLight, Points, PointsMaterial, Quaternion, QuaternionKeyframeTrack, RGBADepthPacking, RGBAFormat, RepeatWrapping, SRGBColorSpace, ShaderChunk, ShaderMaterial, SphereGeometry, Texture, TextureLoader, UniformsLib, UniformsUtils, Vector3, Vector4, VectorKeyframeTrack } from "three";
@@ -727,7 +727,8 @@ var Joint3D = class extends Node3D {
 		},
 		target: {
 			default: "",
-			nodePath: true
+			nodePath: true,
+			required: true
 		},
 		anchor: { default: [
 			0,
@@ -2335,7 +2336,8 @@ var BoneAttachment3D = class extends Node3D {
 		/** Node path to the ModelInstance3D whose skeleton to ride. */
 		target: {
 			default: "",
-			nodePath: true
+			nodePath: true,
+			required: true
 		},
 		/** Bone name ("RightHand", "Head", …). Empty = inert. */
 		bone: { default: "" }
@@ -2428,7 +2430,8 @@ var BoneLookAt3D = class extends Node3D {
 		/** Node path to the ModelInstance3D whose bone to steer. */
 		target: {
 			default: "",
-			nodePath: true
+			nodePath: true,
+			required: true
 		},
 		/** Bone name ("Head", "Neck", "Spine2" — Mixamo spellings matched). */
 		bone: { default: "Head" },
@@ -2440,7 +2443,13 @@ var BoneLookAt3D = class extends Node3D {
 		/** Comfort cone half-angle, degrees — beyond it the head returns to the anim. */
 		maxAngleDeg: { default: 75 },
 		/** Blend weight 0..1 (how far toward the target the bone turns). */
-		weight: { default: .85 },
+		weight: {
+			default: .85,
+			range: {
+				min: 0,
+				max: 1
+			}
+		},
 		/** The bone's local facing axis. */
 		forwardAxis: {
 			default: "+z",
@@ -6449,9 +6458,21 @@ var ModelInstance3D = class extends Node3D {
 	static signals = ["animationFinished"];
 	static props = {
 		...Node3D.props,
-		model: { default: "" },
-		animation: { default: "" },
-		targetHeight: { default: 0 },
+		model: {
+			default: "",
+			asset: {
+				kind: "model",
+				refOnly: true
+			}
+		},
+		animation: {
+			default: "",
+			asset: { kind: "animation" }
+		},
+		targetHeight: {
+			default: 0,
+			range: { min: 0 }
+		},
 		castShadow: { default: false },
 		animationLoop: { default: true },
 		/** Playback rate: 1 = authored speed, 0.5 = half, 2 = double. */
@@ -6466,8 +6487,22 @@ var ModelInstance3D = class extends Node3D {
 		upperBodyRoot: { default: "Spine" },
 		receiveShadow: { default: false },
 		tint: { default: "" },
-		metalness: { default: -1 },
-		roughness: { default: -1 }
+		metalness: {
+			default: -1,
+			range: {
+				min: 0,
+				max: 1,
+				allow: [-1]
+			}
+		},
+		roughness: {
+			default: -1,
+			range: {
+				min: 0,
+				max: 1,
+				allow: [-1]
+			}
+		}
 	};
 	model = "";
 	animation = "";

package/dist/{gameplay-BBEjPFsR.js → gameplay-Dtzd2itW.js}

@@ -1,7 +1,7 @@
-import { C as Node, E as Behavior, b as effectiveOrder, j as registerBehavior, n as loadScene, p as SaveSlots, w as diagnose } from "./loader-D8n7TU8W.js";
+import { O as Node, P as Behavior, _ as SaveSlots, k as diagnose, n as loadScene, w as effectiveOrder, z as registerBehavior } from "./loader-D7jTvDQv.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as jsonClone } from "./json-CwwhxQgb.js";
-import { t as duplicateNode } from "./duplicate-DJQd44CD.js";
+import { t as duplicateNode } from "./duplicate-CGqAmK2h.js";
 import { Color, CubeCamera, DepthTexture, DoubleSide, Euler, FloatType, Frustum, HalfFloatType, LinearMipmapLinearFilter, MathUtils, Matrix4, Mesh, MeshDepthMaterial, Object3D, PerspectiveCamera, Plane, PlaneGeometry, Quaternion, ShaderMaterial, Sphere, Vector2, Vector3, Vector4, WebGLCubeRenderTarget, WebGLRenderTarget } from "three";
 //#region src/3d/frustum.ts
 const scratchFrustum = new Frustum();
@@ -4975,6 +4975,7 @@ var FloatAway = class extends Behavior {
 	onReady() {
 		const node = this.node;
 		this.start = [...node.position ?? []];
+		if (node.opacity === void 0) diagnose(this.node.tree?.engine, "warn", `[incanto] FloatAway on '${this.node.getPath()}' will not fade — ${this.node.constructor.name} has no "opacity" prop, so it pops out at full brightness instead. Use a node that has one (Label, Label3D, Sprite2D, Sprite3D).`);
 	}
 	update(dt) {
 		if (this.done) return;
@@ -5024,9 +5025,18 @@ var FollowCamera = class extends Behavior {
 		/** Constant offset added to the target's position ([x,y] or [x,y,z]). */
 		offset: { default: [] },
 		/** 0..1 retention factor: 0 = snap, higher = smoother chase. */
-		smoothing: { default: 0 },
+		smoothing: {
+			default: 0,
+			range: {
+				min: 0,
+				max: 1
+			}
+		},
 		/** Don't move until the target is at least this far from the desired point. */
-		deadzone: { default: 0 }
+		deadzone: {
+			default: 0,
+			range: { min: 0 }
+		}
 	};
 	static signals = [];
 	target = "";
@@ -5109,7 +5119,6 @@ function tolerateUnknownAction(ctx, action, read, fallback) {
 function restartScene(engine) {
 	const source = engine.scene?.source;
 	if (!source) return;
-	engine.timeScale = 1;
 	engine.setScene(loadScene(jsonClone(source)));
 }
 /**
@@ -5119,7 +5128,6 @@ function restartScene(engine) {
 function goToScene(engine, sceneJson, opts) {
 	const fade = opts?.fadeSeconds ?? .4;
 	const swap = () => {
-		engine.timeScale = 1;
 		engine.setScene(loadScene(jsonClone(sceneJson)));
 	};
 	if (typeof document === "undefined" || fade <= 0) {
@@ -5500,13 +5508,14 @@ function screenFlash(engine, color = "#ffffff", opacity = .35, seconds = .25) {
 */
 function hitStop(engine, seconds = .08) {
 	recordEffect(engine, "hitstop", "", "engine", seconds);
-	const state = hitStops.get(engine);
+	const state = liveHitStop(engine);
 	if (state) {
 		state.until = Math.max(state.until, engine.unscaledTime + seconds);
 		return;
 	}
 	const restore = engine.timeScale;
 	const entry = {
+		startedAt: engine.unscaledTime,
 		until: engine.unscaledTime + seconds,
 		restore,
 		release: () => {}
@@ -5514,12 +5523,35 @@ function hitStop(engine, seconds = .08) {
 	hitStops.set(engine, entry);
 	engine.timeScale = 0;
 	entry.release = engine.updated.connect(() => {
+		if (!liveHitStop(engine)) return;
 		if (engine.unscaledTime < entry.until) return;
 		engine.timeScale = entry.restore;
 		entry.release();
 		hitStops.delete(engine);
 	});
 }
+/**
+* The engine's pending freeze, if the clock it was measured against still runs.
+*
+* `setScene` resets `unscaledTime` to 0, and a freeze deadline is an ABSOLUTE
+* reading of that clock — so a hit-stop taken on the killing blow, two minutes
+* into a level, survived the restart as a deadline two minutes in the future.
+* Measured: `hitStop(engine, 0.08)`, then the restart, then five real seconds
+* of ticks — 2.08 of them frozen, and a level that long freezes that long. The
+* quieter half is the next scene's OWN hit-stop: it found the stale entry,
+* extended a deadline nobody was waiting on, and never froze anything.
+*
+* A clock that reads earlier than the freeze began cannot be the clock the
+* freeze was scheduled on. `setScene` already put `timeScale` back to 1, so
+* there is nothing to restore — just let go.
+*/
+function liveHitStop(engine) {
+	const entry = hitStops.get(engine);
+	if (!entry) return void 0;
+	if (engine.unscaledTime >= entry.startedAt) return entry;
+	entry.release();
+	hitStops.delete(engine);
+}
 const hitStops = /* @__PURE__ */ new Map();
 //#endregion
 //#region src/gameplay/lifetime.ts
@@ -5605,7 +5637,10 @@ function ease(curve, t) {
 var MoveTo = class extends Behavior {
 	static props = {
 		/** Destination position ([x,y] or [x,y,z]). */
-		to: { default: [] },
+		to: {
+			default: [],
+			required: true
+		},
 		/** Seconds the move takes. */
 		duration: { default: 1 },
 		/** Easing curve. */
@@ -5819,7 +5854,10 @@ function distanceBetween(a, b) {
 var Patrol = class extends Behavior {
 	static props = {
 		/** Waypoints: array of position arrays OR node-path strings to read. */
-		points: { default: [] },
+		points: {
+			default: [],
+			required: true
+		},
 		/** Units per second along the path. */
 		speed: { default: 60 },
 		/** Wrap to the first point after the last (ignored in pingpong). */
@@ -6355,7 +6393,8 @@ var Spawner = class extends Behavior {
 		/** Node path of the template to clone. */
 		prefab: {
 			default: "",
-			nodePath: true
+			nodePath: true,
+			required: true
 		},
 		/** Seconds between spawns. */
 		interval: { default: 1 },
@@ -6508,7 +6547,10 @@ var Wander = class extends Behavior {
 var WaveSpawner = class extends Behavior {
 	static props = {
 		/** Array of { prefab, count, interval, delayBefore }. */
-		waves: { default: [] },
+		waves: {
+			default: [],
+			required: true
+		},
 		/** Begin the first wave's countdown at ready. */
 		autoStart: { default: true }
 	};

package/dist/gameplay.d.ts

@@ -1,4 +1,4 @@
-import { At as Node, b as Engine, d as PropSchema, n as BehaviorCtor, t as Behavior } from "./behavior-DWKTUzKI.js";
+import { b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, t as Behavior } from "./behavior-DsgayMsH.js";
 import { c as JsonValue, s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/gameplay/chase.d.ts

package/dist/gameplay.js

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