incanto 0.45.1 → 0.47.0

package/dist/3d.js

@@ -1,9 +1,96 @@
 import { A as Water3D, F as PhysicsBody3D, I as RigidBody3D, L as StaticBody3D, M as WaterCutout3D, N as Area3D, P as CharacterBody3D, R as Node3D, V as WATER_MAX_RIPPLES, j as WATER_CUTOUT_MAX } from "./gameplay-BQOeAid6.js";
-import { A as Terrain3D, B as keyboardIntensity, C as resolveFlowerDensity, D as BoneLookAt3D, E as Camera3D, F as InstancedMesh3D, G as acquireTexture, H as rigPose, I as MeshInstance3D, M as TERRAIN_THEMES, N as terrainThemeLayers, O as BoneAttachment3D, P as Joint3D, R as QUARTER_PITCH, S as Flowers3D, T as CharacterController3D, U as TextureCache3D, V as movementState, W as acquireOwnTexture, _ as LoftMesh3D, a as Tree3D, b as Foliage3D, c as buildRiverRings, d as riverCarveChannels, f as riverStepFor, g as ModelInstance3D, h as Particles3D, i as VoxelGrid3D, j as DEFAULT_TERRAIN_TEXTURE_BASE, k as Billboard3D, l as findRiverCoverageGaps, m as traceDownhillPath, n as registerNodes3D, o as Trail3D, p as smoothCourse, r as VOXEL_PALETTE, s as River3D, u as projectToRiver, v as DirectionalLight3D, w as FLOWER_VARIETIES, x as DENSITY_PRESETS, y as OmniLight3D, z as cameraRelative } from "./environment-presets-DUsBqvtk.js";
-import { a as Environment3D, c as parseEnvironment3D, d as AssetStore3D, i as syncTree, l as sunDirectionFromElevationAzimuth, o as setEnvironment3D, r as Renderer3D, s as horizonColorFromSky, t as createGame3D, u as sunDirectionFromSky } from "./create-game-Gifrjhnz.js";
-import { a as frameStats, i as frameSignature, n as diffSignatures, o as frameText, r as diffText, t as SIGNATURE_GRID } from "./frame-report-Lr3VO24R.js";
+import { A as Terrain3D, B as keyboardIntensity, C as resolveFlowerDensity, D as BoneLookAt3D, E as Camera3D, F as InstancedMesh3D, G as acquireTexture, H as rigPose, I as MeshInstance3D, M as TERRAIN_THEMES, N as terrainThemeLayers, O as BoneAttachment3D, P as Joint3D, R as QUARTER_PITCH, S as Flowers3D, T as CharacterController3D, U as TextureCache3D, V as movementState, W as acquireOwnTexture, _ as LoftMesh3D, a as Tree3D, b as Foliage3D, c as buildRiverRings, d as riverCarveChannels, f as riverStepFor, g as ModelInstance3D, h as Particles3D, i as VoxelGrid3D, j as DEFAULT_TERRAIN_TEXTURE_BASE, k as Billboard3D, l as findRiverCoverageGaps, m as traceDownhillPath, n as registerNodes3D, o as Trail3D, p as smoothCourse, r as VOXEL_PALETTE, s as River3D, u as projectToRiver, v as DirectionalLight3D, w as FLOWER_VARIETIES, x as DENSITY_PRESETS, y as OmniLight3D, z as cameraRelative } from "./environment-presets-D1b0ydTS.js";
+import { a as Environment3D, c as parseEnvironment3D, d as AssetStore3D, i as syncTree, l as sunDirectionFromElevationAzimuth, o as setEnvironment3D, r as Renderer3D, s as horizonColorFromSky, t as createGame3D, u as sunDirectionFromSky } from "./create-game-D16MVIPO.js";
+import { a as frameSignature, n as diffSignatures, o as frameStats, r as diffText, s as frameText, t as SIGNATURE_GRID } from "./frame-report-njybhZon.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-DFqMtBUD.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-CSoGjM8P.js";
+//#region src/3d/model-verdict.ts
+/** Mixamo exports every bone as `mixamorigX`; the retargeter binds by that name. */
+const MIXAMO = /^mixamorig[:_]?/i;
+/**
+* Anything outside this is not a character at this scale, and the fix is one
+* prop. Wide on purpose: a 2.4m ogre is a design choice, a 40m one is
+* centimetres.
+*/
+const CHARACTER_HEIGHT = {
+	min: .4,
+	max: 4
+};
+/** What `targetHeight` gets set to when a model is plainly the wrong scale. */
+const DEFAULT_TARGET_HEIGHT = 1.7;
+/** Fraction of the model's own height that its origin may drift before it matters. */
+const ORIGIN_TOLERANCE = .25;
+function rigOf(facts) {
+	if (facts.vrm && facts.vrm.humanBones > 0) return "vrm-humanoid";
+	if (facts.nodes.some((n) => MIXAMO.test(n.name))) return "mixamorig";
+	return facts.skins > 0 ? "other" : "none";
+}
+function modelVerdict(facts, target) {
+	const rig = rigOf(facts);
+	const kind = facts.meshes === 0 && facts.animations.length > 0 ? "animation" : "model";
+	const height = facts.bbox ? facts.bbox.size[1] : 0;
+	const offset = facts.bbox ? [
+		facts.bbox.center[0],
+		facts.bbox.min[1],
+		facts.bbox.center[2]
+	] : [
+		0,
+		0,
+		0
+	];
+	const slack = Math.max(height * ORIGIN_TOLERANCE, .05);
+	const grounded = !facts.bbox || Math.abs(offset[0]) <= slack && Math.abs(offset[1]) <= slack && Math.abs(offset[2]) <= slack;
+	const oddSize = height > 0 && (height < CHARACTER_HEIGHT.min || height > CHARACTER_HEIGHT.max);
+	const props = { model: `$${target?.key ?? "model"}` };
+	if (oddSize) props.targetHeight = DEFAULT_TARGET_HEIGHT;
+	return {
+		kind,
+		rig,
+		takesLibraryClips: kind === "model" && (rig === "mixamorig" || rig === "vrm-humanoid"),
+		height,
+		originOffset: offset,
+		groundedAtOrigin: grounded,
+		embeddedClips: facts.animations.map((a) => a.name),
+		sceneJson: target ? {
+			assets: { [target.key]: {
+				type: kind,
+				url: target.url
+			} },
+			node: kind === "animation" ? null : {
+				name: titleCase(target.key),
+				type: "ModelInstance3D",
+				props
+			}
+		} : null
+	};
+}
+const titleCase = (key) => key.split(/[-_\s]+/).filter(Boolean).map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("") || "Model";
+const round = (n) => String(Math.round(n * 100) / 100);
+/** The verdict as sentences: what to do, and what will bite if you do not. */
+function verdictText(v) {
+	const lines = [];
+	if (v.kind === "animation") {
+		lines.push("an animation CLIP — no mesh of its own. It plays ON a character: declare it as {\"type\":\"animation\"} and point a ModelInstance3D's `animation` at it. Used as a `model` it draws nothing at all, with no error");
+		if (v.embeddedClips.length > 0) lines.push(`clip: ${v.embeddedClips.join(", ")}`);
+		return lines.join("\n");
+	}
+	if (v.rig === "mixamorig") lines.push("mixamorig rig — the 3d/animations clips play on this as they are");
+	else if (v.rig === "vrm-humanoid") lines.push("VRM humanoid — clips are retargeted onto it automatically");
+	else if (v.rig === "other") lines.push("skinned, but NOT a mixamorig rig — the 3d/animations clips will not bind to it (bones are matched by name; a mismatch keeps the bind pose and only warns)");
+	else lines.push("no skeleton — a prop, not a character; `animation` does nothing here");
+	if (v.height > 0) {
+		const odd = v.height < CHARACTER_HEIGHT.min || v.height > CHARACTER_HEIGHT.max;
+		lines.push(`stands ${round(v.height)} units tall` + (odd ? ` — not a character's size; set targetHeight (${DEFAULT_TARGET_HEIGHT}) to fix it` : ""));
+	}
+	if (!v.groundedAtOrigin) {
+		const [x, y, z] = v.originOffset;
+		const where = Math.abs(y) > Math.abs(x) && Math.abs(y) > Math.abs(z) ? `${round(Math.abs(y))} units ${y > 0 ? "above" : "below"} the origin` : `off-centre by [${round(x)}, ${round(y)}, ${round(z)}]`;
+		lines.push(`does NOT stand on its own origin — it sits ${where}. A node at [0,0,0] puts it there too; offset the node, or expect an empty-looking frame`);
+	}
+	if (v.embeddedClips.length > 0) lines.push(`clips in the file: ${v.embeddedClips.join(", ")} (play by name, no asset needed)`);
+	return lines.join("\n");
+}
+//#endregion
 //#region src/3d/terrain-nav.ts
 function buildTerrainNav(terrain, opts) {
 	const cellSize = opts?.cellSize ?? 2;
@@ -115,4 +202,4 @@ function createNavDebugNode(nav, opts) {
 	return node;
 }
 //#endregion
-export { Area3D, AssetStore3D, Billboard3D, BoneAttachment3D, BoneLookAt3D, Camera3D, CharacterBody3D, CharacterController3D, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, Flowers3D, Foliage3D, InstancedMesh3D, Joint3D, LoftMesh3D, MeshInstance3D, ModelInstance3D, Node3D, OmniLight3D, Particles3D, Physics3D, PhysicsBody3D, QUARTER_PITCH, Renderer3D, RigidBody3D, River3D, SIGNATURE_GRID, StaticBody3D, TERRAIN_THEMES, Terrain3D, TextureCache3D, Trail3D, Tree3D, VOXEL_PALETTE, VoxelGrid3D, WATER_CUTOUT_MAX, WATER_MAX_RIPPLES, Water3D, WaterCutout3D, acquireOwnTexture, acquireTexture, buildHeightmap, buildRiverRings, buildTerrainNav, cameraRelative, createGame3D, createNavDebugNode, diffSignatures, diffText, enablePhysics3D, findRiverCoverageGaps, frameSignature, frameStats, frameText, horizonColorFromSky, keyboardIntensity, movementState, parseEnvironment3D, projectToRiver, registerNodes3D, resolveFlowerDensity, rigPose, riverCarveChannels, riverStepFor, setEnvironment3D, smoothCourse, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers, traceDownhillPath };
+export { Area3D, AssetStore3D, Billboard3D, BoneAttachment3D, BoneLookAt3D, Camera3D, CharacterBody3D, CharacterController3D, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, Flowers3D, Foliage3D, InstancedMesh3D, Joint3D, LoftMesh3D, MeshInstance3D, ModelInstance3D, Node3D, OmniLight3D, Particles3D, Physics3D, PhysicsBody3D, QUARTER_PITCH, Renderer3D, RigidBody3D, River3D, SIGNATURE_GRID, StaticBody3D, TERRAIN_THEMES, Terrain3D, TextureCache3D, Trail3D, Tree3D, VOXEL_PALETTE, VoxelGrid3D, WATER_CUTOUT_MAX, WATER_MAX_RIPPLES, Water3D, WaterCutout3D, acquireOwnTexture, acquireTexture, buildHeightmap, buildRiverRings, buildTerrainNav, cameraRelative, createGame3D, createNavDebugNode, diffSignatures, diffText, enablePhysics3D, findRiverCoverageGaps, frameSignature, frameStats, frameText, horizonColorFromSky, keyboardIntensity, modelVerdict, movementState, parseEnvironment3D, projectToRiver, registerNodes3D, resolveFlowerDensity, rigPose, riverCarveChannels, riverStepFor, setEnvironment3D, smoothCourse, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers, traceDownhillPath, verdictText };

package/dist/{create-game-DFRbG0Bj.js → create-game-CniOiWzN.js}

@@ -3,7 +3,7 @@ import { n as loadScene, o as computeViewport, s as resolveViewport, v as diagno
 import { h as Engine, m as AudioPlayer } from "./register-BSXV8T9F.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-BoNg_MnF.js";
-import { a as openBundledEditor, i as devServerLibrary, n as pauseWhenHidden, r as crossFade, t as teardown } from "./teardown-yePMOE1K.js";
+import { a as openBundledEditor, i as devServerLibrary, n as pauseWhenHidden, r as crossFade, t as teardown } from "./teardown-BKTCzLek.js";
 import { n as registerGameplayBehaviors } from "./gameplay-BQOeAid6.js";
 import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-R2JTnIMw.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";

package/dist/{create-game-Gifrjhnz.js → create-game-D16MVIPO.js}

@@ -3,12 +3,12 @@ import { n as loadScene, v as diagnose, w as registerBehavior } from "./loader-r
 import { _ as qualityCaps, h as Engine, m as AudioPlayer, y as qualityRendering } from "./register-BSXV8T9F.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-BoNg_MnF.js";
-import { a as openBundledEditor, i as devServerLibrary, n as pauseWhenHidden, o as poseFromRenderer, r as crossFade, t as teardown } from "./teardown-yePMOE1K.js";
+import { a as openBundledEditor, i as devServerLibrary, n as pauseWhenHidden, o as poseFromRenderer, r as crossFade, t as teardown } from "./teardown-BKTCzLek.js";
 import { B as createCausticsQuad, F as PhysicsBody3D, R as Node3D, n as registerGameplayBehaviors } from "./gameplay-BQOeAid6.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-DUsBqvtk.js";
-import { a as frameStats, i as frameSignature } from "./frame-report-Lr3VO24R.js";
-import { n as enablePhysics3D } from "./physics-3d-DFqMtBUD.js";
+import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-D1b0ydTS.js";
+import { a as frameSignature, i as frameImage, o as frameStats } from "./frame-report-njybhZon.js";
+import { n as enablePhysics3D } from "./physics-3d-CSoGjM8P.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";
@@ -1545,6 +1545,12 @@ function prune(obj, visited) {
 //#endregion
 //#region src/3d/renderer.ts
 /**
+* How long a capture waits for the game's own loop before drawing its own
+* frame. Long enough that a running game answers from its normal loop (16ms),
+* short enough that a paused or occluded tab still answers promptly.
+*/
+const CAPTURE_NUDGE_MS = 120;
+/**
 * WebGL presentation layer: subscribes to `engine.updated`, mirrors the active
 * scene's node tree onto a three.js scene, applies the scene `environment`
 * header (ambient/background/sky/fog/shadows/exposure — see Environment3D),
@@ -1890,6 +1896,14 @@ var Renderer3D = class {
 				resolve,
 				reject
 			});
+			setTimeout(() => {
+				if (this.pendingCaptures.length > 0) try {
+					this.render();
+				} catch (error) {
+					const e = error instanceof Error ? error : new Error(String(error));
+					for (const w of this.pendingCaptures.splice(0)) w.reject(e);
+				}
+			}, CAPTURE_NUDGE_MS);
 		});
 	}
 	pendingCaptures = [];
@@ -2446,11 +2460,16 @@ async function createGame3D(opts) {
 		const onFrameRequest = (data) => {
 			const request = data;
 			const id = request?.id;
+			hot.send("incanto:frame-ack", { id });
 			captureFramePixels().then((shot) => hot.send("incanto:frame-report", {
 				id,
 				report: {
 					...frameStats(shot.pixels, shot.width, shot.height, { grid: request?.grid }),
-					signature: frameSignature(shot.pixels, shot.width, shot.height)
+					signature: frameSignature(shot.pixels, shot.width, shot.height),
+					...request?.image ? { image: frameImage(shot.pixels, shot.width, shot.height, (w, h) => Object.assign(document.createElement("canvas"), {
+						width: w,
+						height: h
+					}), request.image) } : {}
 				}
 			})).catch((error) => hot.send("incanto:frame-report", {
 				id,

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

@@ -60,7 +60,7 @@ type LibrarySearch = (query: {
   keyword?: string;
   page?: number;
   limit?: number;
-}) => Promise<{
+}, token?: string) => Promise<{
   items: unknown[];
   page: number;
   hasNext: boolean;