incanto 0.27.0 → 0.29.0

package/dist/{register-CvpSUU3O.js → register-DWcWq4QG.js}

@@ -1,5 +1,5 @@
 import { f as Node } from "./loader-BZqOKfI2.js";
-import { t as registerCoreNodes } from "./register-nObreUQR.js";
+import { t as registerCoreNodes } from "./register-BTg0EM7s.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-BVJ2HbCn.js";
@@ -115,7 +115,27 @@ var Node2D = class extends Node {
 * `{shape:'capsule', radius, height}` — never child shape nodes.
 */
 var PhysicsBody2D = class extends Node2D {
-	static props = { collider: { default: {} } };
+	static props = { collider: {
+		default: {},
+		variants: {
+			tag: "shape",
+			byTag: {
+				rect: {
+					shape: "rect",
+					size: [32, 32]
+				},
+				circle: {
+					shape: "circle",
+					radius: 16
+				},
+				capsule: {
+					shape: "capsule",
+					radius: 12,
+					height: 32
+				}
+			}
+		}
+	} };
 	/** The unified collision model: every collider participant can emit these. */
 	static signals = ["triggerEnter", "triggerExit"];
 	_collider = {};

package/dist/{register-BFFE1Mh1.js → register-MelqEdza.js}

@@ -1,5 +1,5 @@
 import { f as Node, t as buildNodeJson, y as Signal } from "./loader-BZqOKfI2.js";
-import { t as registerCoreNodes } from "./register-nObreUQR.js";
+import { t as registerCoreNodes } from "./register-BTg0EM7s.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
 import { l as registerNode } from "./registry-BVJ2HbCn.js";

package/dist/test.d.ts

@@ -1,9 +1,41 @@
 import { c as JsonValue, i as SceneJson } from "./schema-CcoWb32N.js";
-import { $ as Node, T as LogEntry, n as BehaviorCtor, v as Engine, w as Scene } from "./behavior-CPibUfnH.js";
-import { t as LoadSceneOptions } from "./loader-DILt9PGC.js";
+import { $ as Node, T as LogEntry, n as BehaviorCtor, v as Engine, w as Scene } from "./behavior-BAc0erXF.js";
+import { t as LoadSceneOptions } from "./loader-B242FF6N.js";
 import { i as auditScene, t as IncantoError } from "./errors-1dXlIwoR.js";
 
 //#region src/test/index.d.ts
+/** One thing that is not standing where it should be. */
+interface GroundingIssue {
+  /** Scene path, e.g. `/World/Footbridge/PostL0`. */
+  path: string;
+  /** Metres between the node's underside and the ground: + floats, − buried. */
+  gap: number;
+}
+interface GroundingOptions {
+  /** How far a foot may sit off the ground before it is a bug (default 0.1 m). */
+  tolerance?: number;
+  /** Node types to check (default: the ones that read as props on a map). */
+  types?: readonly string[];
+}
+/**
+* Every prop that is floating or buried.
+*
+* THE most repeated mistake in scene authoring, by humans and agents alike, is
+* a hand-computed Y: correct when it is written and wrong the moment anything
+* reshapes the ground under it — a river carving its bed, a new seed, a
+* generator that mirrors a carve slightly differently. This is the check that
+* catches it, and `snapToGround` is the fix that stops it happening.
+*
+* Anything explicitly marked `snapToGround: false` is skipped: that is the
+* author saying "yes, this hangs in the air", which a bridge deck, a lantern
+* and a cloud all legitimately do.
+*
+* ```ts
+* const off = findFloatingProps(gameJson);
+* ok(`nothing floats (${off.length})`, off.length === 0);
+* ```
+*/
+declare function findFloatingProps(json: unknown, opts?: GroundingOptions): GroundingIssue[];
 declare function registerAllNodes(): void;
 interface NodeCapture {
   /** Absolute path ('/Root/Player') — stable, grep-able. */
@@ -149,4 +181,4 @@ interface PlaySession {
 */
 declare function createPlaySession(json: unknown, opts?: PlaySessionOptions): Promise<PlaySession>;
 //#endregion
-export { NodeCapture, PlaySession, PlaySessionOptions, RunContext, RunFailure, RunResult, RunScriptOptions, SceneCapture, ScriptStep, ValidateSceneOptions, ValidationResult, auditScene, captureScene, createPlaySession, describeCapture, registerAllNodes, runScript, validateScene };
+export { GroundingIssue, GroundingOptions, NodeCapture, PlaySession, PlaySessionOptions, RunContext, RunFailure, RunResult, RunScriptOptions, SceneCapture, ScriptStep, ValidateSceneOptions, ValidationResult, auditScene, captureScene, createPlaySession, describeCapture, findFloatingProps, registerAllNodes, runScript, validateScene };

package/dist/test.js

@@ -1,13 +1,13 @@
 import { _ as registerBehavior, n as loadScene } from "./loader-BZqOKfI2.js";
-import { u as Engine } from "./register-nObreUQR.js";
+import { u as Engine } from "./register-BTg0EM7s.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as auditScene } from "./audit-C6rMyict.js";
 import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
 import { i as getNodeSchema, s as mergeStaticProps } from "./registry-BVJ2HbCn.js";
-import { n as registerGameplayBehaviors } from "./gameplay-Ddk13pQ6.js";
-import { t as registerNodes2D } from "./register-CvpSUU3O.js";
-import { t as registerNodes3D } from "./register-DcHXS1MA.js";
-import { t as registerNodesNet } from "./register-BFFE1Mh1.js";
+import { n as registerGameplayBehaviors } from "./gameplay-L05WgWd1.js";
+import { t as registerNodes2D } from "./register-DWcWq4QG.js";
+import { t as registerNodes3D } from "./register-C44aSduO.js";
+import { t as registerNodesNet } from "./register-MelqEdza.js";
 //#region src/test/index.ts
 /**
 * incanto/test — the browserless verification harness.
@@ -25,6 +25,100 @@ import { t as registerNodesNet } from "./register-BFFE1Mh1.js";
 * Deterministic by construction: fixed timestep, seeded `engine.rng`,
 * no requestAnimationFrame.
 */
+/** Node types whose whole job is to sit on the ground. Characters, water,
+* clouds, birds and lights are all legitimately off it. */
+const GROUNDED_TYPES = ["MeshInstance3D", "InstancedMesh3D"];
+/** Under one of these, the BODY owns where the thing stands — a character's
+* skin hangs at whatever offset its rig wants, and is not a floating prop. */
+const BODY_OWNED = new Set([
+	"CharacterBody3D",
+	"RigidBody3D",
+	"StaticBody3D",
+	"AreaBody3D"
+]);
+/**
+* Every prop that is floating or buried.
+*
+* THE most repeated mistake in scene authoring, by humans and agents alike, is
+* a hand-computed Y: correct when it is written and wrong the moment anything
+* reshapes the ground under it — a river carving its bed, a new seed, a
+* generator that mirrors a carve slightly differently. This is the check that
+* catches it, and `snapToGround` is the fix that stops it happening.
+*
+* Anything explicitly marked `snapToGround: false` is skipped: that is the
+* author saying "yes, this hangs in the air", which a bridge deck, a lantern
+* and a cloud all legitimately do.
+*
+* ```ts
+* const off = findFloatingProps(gameJson);
+* ok(`nothing floats (${off.length})`, off.length === 0);
+* ```
+*/
+function findFloatingProps(json, opts = {}) {
+	registerAllNodes();
+	const tolerance = opts.tolerance ?? .1;
+	const types = new Set(opts.types ?? GROUNDED_TYPES);
+	let scene;
+	try {
+		scene = loadScene(json);
+	} catch {
+		return [];
+	}
+	let ground = null;
+	const findGround = (node) => {
+		if (!ground && node.constructor.typeName === "Terrain3D" && typeof node.heightAt === "function") ground = node;
+		for (const child of node.children) findGround(child);
+	};
+	findGround(scene.root);
+	if (!ground) return [];
+	const out = [];
+	const walk = (node, path, ox, oy, oz, yaw, bodyOwned) => {
+		const n = node;
+		let wx = ox;
+		let wy = oy;
+		let wz = oz;
+		let ownYaw = yaw;
+		if (Array.isArray(n.position)) {
+			const c = Math.cos(yaw);
+			const s = Math.sin(yaw);
+			const lx = n.position[0] ?? 0;
+			const lz = n.position[2] ?? 0;
+			wx = ox + lx * c + lz * s;
+			wz = oz - lx * s + lz * c;
+			wy = oy + (n.position[1] ?? 0);
+			ownYaw = yaw + (n.rotation?.[1] ?? 0) * Math.PI / 180;
+		}
+		const type = node.constructor.typeName ?? "";
+		const soil = ground;
+		if (types.has(type) && n.visible !== false && n.snapToGround !== false && !bodyOwned) {
+			const rows = node.transforms;
+			if (Array.isArray(rows) && rows.length > 0) {
+				let worst = null;
+				for (const row of rows) {
+					const scale = row[4] ?? 1;
+					const half = (n.size?.[1] ?? 0) * scale / 2;
+					const gap = wy + (row[1] ?? 0) - half - soil.heightAt(wx + (row[0] ?? 0), wz + (row[2] ?? 0));
+					if (Math.abs(gap) > tolerance && (!worst || Math.abs(gap) > Math.abs(worst.gap))) worst = {
+						path,
+						gap: Math.round(gap * 100) / 100
+					};
+				}
+				if (worst) out.push(worst);
+			} else {
+				const half = (n.size?.[1] ?? 0) / 2;
+				const gap = wy - half - soil.heightAt(wx, wz);
+				if (Math.abs(gap) > tolerance) out.push({
+					path,
+					gap: Math.round(gap * 100) / 100
+				});
+			}
+		}
+		const childBodyOwned = bodyOwned || BODY_OWNED.has(type);
+		for (const child of node.children) walk(child, `${path}/${child.name}`, wx, wy, wz, ownYaw, childBodyOwned);
+	};
+	walk(scene.root, `/${scene.root.name}`, 0, 0, 0, 0, false);
+	return out;
+}
 function registerAllNodes() {
 	registerNodes2D();
 	registerNodes3D();
@@ -124,10 +218,10 @@ async function runScript(json, opts) {
 	engine.setScene(scene);
 	const physics = opts.physics ?? "auto";
 	if (physics === "2d" || physics === "auto" && scene.dimension === "2d") {
-		const { enablePhysics2D } = await import("./physics-2d-DiVFFlH3.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-CCVTrKOd.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-4mGzOZ2J.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-BZZLtwJu.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const failures = [];
@@ -229,10 +323,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-DiVFFlH3.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-CCVTrKOd.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-4mGzOZ2J.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-BZZLtwJu.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);
@@ -267,4 +361,4 @@ async function createPlaySession(json, opts = {}) {
 	};
 }
 //#endregion
-export { auditScene, captureScene, createPlaySession, describeCapture, registerAllNodes, runScript, validateScene };
+export { auditScene, captureScene, createPlaySession, describeCapture, findFloatingProps, registerAllNodes, runScript, validateScene };

package/dist/vite.d.ts

@@ -22,5 +22,57 @@ declare function incantoScenes(opts?: IncantoScenesOptions): {
   name: string;
   handleHotUpdate(ctx: HotUpdateContext): Promise<undefined | never[]>;
 };
+interface DevServer {
+  middlewares: {
+    use(path: string, handler: (req: LibraryReq, res: LibraryRes) => void): void;
+  };
+}
+interface LibraryReq {
+  url?: string | undefined;
+  method?: string | undefined;
+  headers: Record<string, string | string[] | undefined>;
+}
+interface LibraryRes {
+  statusCode: number;
+  setHeader(name: string, value: string): void;
+  end(body?: string): void;
+}
+interface IncantoLibraryOptions {
+  /**
+  * Verse8 access token. Defaults to INCANTO_V8_TOKEN / V8_ACCESS_TOKEN.
+  * Read at request time so a token exported after the server started works.
+  */
+  token?: string;
+  /** Upstream catalog (default: the agent8 backend). */
+  url?: string;
+}
+/**
+* Serve the agent8 asset catalog at `/api/library` on the dev server.
+*
+* The catalog wants a bearer token and does not CORS-allow localhost, so a page
+* cannot call it — but the dev server can, and it is already running. This is
+* the same proxy `incanto-editor` ships, so the editor's 📚 works identically
+* whether it opened as a page or over a running game.
+*
+* DEV ONLY (vite `configureServer`): nothing about it reaches a build, and the
+* token stays in the terminal that started the server.
+*
+* ```ts
+* // vite.config.ts
+* import { incantoLibrary, incantoScenes } from 'incanto/vite';
+* export default defineConfig({ plugins: [incantoScenes(), incantoLibrary()] });
+* ```
+* ```ts
+* // main.ts — the editor then offers the library
+* createGame3D({ ..., debug: DEV, editor: { library: true } });
+* ```
+*/
+declare function incantoLibrary(opts?: IncantoLibraryOptions): {
+  name: string;
+  apply: "serve";
+  configureServer(server: DevServer): void;
+};
+/** @internal Exported for tests — the whole request/response behaviour. */
+declare function serveLibrary(req: LibraryReq, res: LibraryRes, opts?: IncantoLibraryOptions, doFetch?: typeof fetch): Promise<void>;
 //#endregion
-export { IncantoScenesOptions, incantoScenes };
+export { IncantoLibraryOptions, IncantoScenesOptions, incantoLibrary, incantoScenes, serveLibrary };

package/dist/vite.js

@@ -13,7 +13,12 @@ import { dirname, resolve } from "node:path";
 * export default defineConfig({ plugins: [incantoScenes()] });
 * ```
 *
-* Typed structurally (no vite dependency) — the returned object satisfies
+* `incantoLibrary()` is the second half: it puts the agent8 asset catalog on
+* your own dev server, so the editor opened from a running game
+* (`createGame3D({ editor: { library: true } })`) has the same 📚 the
+* standalone `incanto-editor` has.
+*
+* Typed structurally (no vite dependency) — the returned objects satisfy
 * vite's Plugin interface.
 */
 function incantoScenes(opts = {}) {
@@ -53,5 +58,92 @@ function report(ctx, message) {
 		}
 	});
 }
+/**
+* Serve the agent8 asset catalog at `/api/library` on the dev server.
+*
+* The catalog wants a bearer token and does not CORS-allow localhost, so a page
+* cannot call it — but the dev server can, and it is already running. This is
+* the same proxy `incanto-editor` ships, so the editor's 📚 works identically
+* whether it opened as a page or over a running game.
+*
+* DEV ONLY (vite `configureServer`): nothing about it reaches a build, and the
+* token stays in the terminal that started the server.
+*
+* ```ts
+* // vite.config.ts
+* import { incantoLibrary, incantoScenes } from 'incanto/vite';
+* export default defineConfig({ plugins: [incantoScenes(), incantoLibrary()] });
+* ```
+* ```ts
+* // main.ts — the editor then offers the library
+* createGame3D({ ..., debug: DEV, editor: { library: true } });
+* ```
+*/
+function incantoLibrary(opts = {}) {
+	return {
+		name: "incanto-library",
+		apply: "serve",
+		configureServer(server) {
+			server.middlewares.use("/api/library", (req, res) => {
+				serveLibrary(req, res, opts);
+			});
+		}
+	};
+}
+/** @internal Exported for tests — the whole request/response behaviour. */
+async function serveLibrary(req, res, opts = {}, doFetch = fetch) {
+	const send = (status, body) => {
+		res.statusCode = status;
+		res.setHeader("content-type", "application/json; charset=utf-8");
+		res.end(JSON.stringify(body));
+	};
+	if (req.method && req.method !== "GET") return send(405, { error: "method not allowed" });
+	const env = globalThis.process?.env;
+	const header = req.headers["x-incanto-v8-token"];
+	const token = (Array.isArray(header) ? header[0] : header)?.trim() || opts.token || env?.INCANTO_V8_TOKEN || env?.V8_ACCESS_TOKEN || "";
+	if (!token) return send(401, {
+		error: "no Verse8 access token. Pass one to incantoLibrary({ token }) or set INCANTO_V8_TOKEN, or paste one into the library panel.",
+		needsToken: true
+	});
+	const query = new URL(req.url ?? "/", "http://localhost").searchParams;
+	const params = new URLSearchParams({
+		tags: query.get("tags") ?? "",
+		page: query.get("page") ?? "1",
+		limit: query.get("limit") ?? "24"
+	});
+	const keyword = query.get("keyword");
+	if (keyword) params.set("keyword", keyword);
+	const base = opts.url ?? env?.INCANTO_LIBRARY_URL ?? "https://agent8-backend.verse8.io/api/resources";
+	try {
+		const upstream = await doFetch(`${base}?${params}`, { headers: {
+			authorization: `Bearer ${token}`,
+			accept: "application/json"
+		} });
+		if (upstream.status === 401 || upstream.status === 403) return send(401, {
+			error: "the asset library rejected that token (expired or wrong account)",
+			needsToken: true
+		});
+		if (!upstream.ok) return send(502, { error: `asset library: HTTP ${upstream.status}` });
+		const body = await upstream.json();
+		if (body.success === false) return send(502, { error: String(body.error ?? "library error") });
+		send(200, {
+			items: (Array.isArray(body.data) ? body.data : []).map(libraryItem).filter((i) => i.url),
+			page: body.pagination?.page ?? Number(params.get("page")),
+			hasNext: body.pagination?.hasNext === true,
+			...typeof body.pagination?.total === "number" ? { total: body.pagination.total } : {}
+		});
+	} catch (error) {
+		send(502, { error: `asset library unreachable: ${error instanceof Error ? error.message : String(error)}` });
+	}
+}
+function libraryItem(row) {
+	const r = row ?? {};
+	return {
+		id: String(r.id ?? r.url ?? ""),
+		url: typeof r.url === "string" ? r.url : "",
+		description: typeof r.description === "string" ? r.description : "",
+		metadata: r.metadata && typeof r.metadata === "object" ? r.metadata : {}
+	};
+}
 //#endregion
-export { incantoScenes };
+export { incantoLibrary, incantoScenes, serveLibrary };

package/editor/assets/{agent8-DElIPozC.js → agent8-DEVkEa3d.js}

@@ -1 +1 @@
-import{t as e}from"./index-BrneVqN0.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-Bx4UtWYY.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};

package/editor/assets/debug-zGAtpDF0.js

@@ -0,0 +1,2 @@
+import{i as e,r as t,t as n}from"./index-Bx4UtWYY.js";function r(e,t,n,r,i,a,o=180,s=120){let c=Math.max(o,n),l=Math.max(s,r);return{x:Math.min(Math.max(0,e),Math.max(0,i-c)),y:Math.min(Math.max(0,t),Math.max(0,a-l)),w:c,h:l}}function i(e,t){for(let[n,r]of Object.entries(t))e.style[n]=r}var a=`rgba(18, 20, 26, 0.92)`,o=`1px solid rgba(255,255,255,0.14)`,s=`12px ui-monospace, SFMono-Regular, Menlo, monospace`,c=class{host;el;body;onClose=()=>{};x;y;w;h;constructor(e,t,n,r){this.host=t,this.x=r.x,this.y=r.y,this.w=r.w,this.h=r.h,this.el=e.createElement(`div`),i(this.el,{position:`absolute`,background:a,border:o,borderRadius:`8px`,color:`rgba(255,255,255,0.88)`,font:s,display:`flex`,flexDirection:`column`,overflow:`hidden`,zIndex:`40`,pointerEvents:`auto`,boxShadow:`0 8px 28px rgba(0,0,0,0.45)`});let c=e.createElement(`div`);c.textContent=n,i(c,{padding:`6px 28px 6px 10px`,background:`rgba(255,255,255,0.07)`,cursor:`move`,userSelect:`none`,touchAction:`none`,fontWeight:`700`}),this.el.appendChild(c);let l=e.createElement(`div`);l.textContent=`×`,l.title=`close`,i(l,{position:`absolute`,top:`2px`,right:`8px`,cursor:`pointer`,fontSize:`16px`,lineHeight:`20px`,opacity:`0.7`}),l.addEventListener(`click`,()=>this.onClose()),this.el.appendChild(l),this.body=e.createElement(`div`),i(this.body,{flex:`1`,overflow:`auto`,padding:`8px 10px`}),this.el.appendChild(this.body);let u=e.createElement(`div`);u.textContent=`◢`,i(u,{position:`absolute`,right:`2px`,bottom:`0`,cursor:`nwse-resize`,opacity:`0.5`,userSelect:`none`,touchAction:`none`}),this.el.appendChild(u),this.wireDrag(c,(e,t)=>{this.x+=e,this.y+=t,this.layout()}),this.wireDrag(u,(e,t)=>{this.w+=e,this.h+=t,this.layout()}),this.layout(),t.appendChild(this.el)}remove(){this.el.remove()}layout(){let e=this.host.getBoundingClientRect(),t=r(this.x,this.y,this.w,this.h,e.width,e.height);this.x=t.x,this.y=t.y,this.w=t.w,this.h=t.h,i(this.el,{left:`${t.x}px`,top:`${t.y}px`,width:`${t.w}px`,height:`${t.h}px`})}wireDrag(e,t){let n=null,r=0,i=0;e.addEventListener(`pointerdown`,t=>{n=t.pointerId,r=t.clientX,i=t.clientY,e.setPointerCapture?.(t.pointerId)}),e.addEventListener(`pointermove`,e=>{e.pointerId===n&&(t(e.clientX-r,e.clientY-i),r=e.clientX,i=e.clientY)});let a=e=>{e.pointerId===n&&(n=null)};e.addEventListener(`pointerup`,a),e.addEventListener(`pointercancel`,a)}},l=96,u=200,d=8192;function f(e){return Array.isArray(e)?`Array(${e.length})`:`Object(${Object.keys(e).length} keys)`}function p(e,t){if(Array.isArray(e)&&e.some(e=>typeof e==`object`&&!!e)){let t=e.slice(0,u).map(e=>JSON.stringify(e)),n=e.length-u;return t.join(`
+`)+(n>0?`\n… ${n} more`:``)}return t.length>d?`${t.slice(0,d)} … (${t.length-d} more chars)`:t}function m(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function h(e,t={}){let n=t.doc??(typeof document<`u`?document:null);if(!n)return null;let r=t.container??(typeof document<`u`?document.body:null);return!r||typeof r.appendChild!=`function`?null:new v(e,r,n,t.statsSource,t.actions)}var g=300,_=[`log`,`info`,`warn`,`error`,`debug`],v=class{engine;container;doc;statsSource;actions;panels=new Map;cleanups=[];menuButton;dropdown=null;selected=null;collapsedFlags=new Map;statsChip=null;logRows=[];levelEnabled={debug:!0,info:!0,warn:!0,error:!0};consoleCapture=!1;consolePatched=[];frame=0;editing=0;detailOpen=new WeakMap;hovering=!1;constructor(e,t,n,r,a=[]){this.engine=e,this.container=t,this.doc=n,this.statsSource=r,this.actions=a,this.menuButton=n.createElement(`div`),this.menuButton.textContent=`☰ debug`,i(this.menuButton,{position:`absolute`,top:`8px`,left:`8px`,padding:`4px 10px`,background:`rgba(18,20,26,0.85)`,border:`1px solid rgba(255,255,255,0.18)`,borderRadius:`6px`,color:`rgba(255,255,255,0.85)`,font:`12px ui-monospace, Menlo, monospace`,cursor:`pointer`,userSelect:`none`,zIndex:`50`,pointerEvents:`auto`}),this.menuButton.addEventListener(`click`,()=>this.toggleDropdown()),t.style.position||(t.style.position=`relative`),t.appendChild(this.menuButton),this.cleanups.push(e.log.added.connect(e=>{this.pushLog({level:e.level,source:`engine`,text:e.parts.map(x).join(` `)})})),this.cleanups.push(e.sceneChanged.connect(()=>{this.selected=null,this.applyColliderScope(),this.renderExplorer(),this.renderInspector()})),this.cleanups.push(e.updated.connect(()=>{this.frame+=1,this.frame%30==0&&(this.renderExplorer(),this.renderStats(),this.editing===0&&!this.hovering&&this.renderInspector())}))}isOpen(e){return e===`colliders`?this.colliderMode!==`off`:e===`stats`?this.statsChip!==null:this.panels.has(e)}colliderMode=`off`;setColliders(e){this.colliderMode=e,this.applyColliderScope()}applyColliderScope(){let e=this.colliderMode;for(let t of n(`2d`).concat(n(`3d`)))t.debugDraw=e!==`off`,t.debugScope=e===`selected`?this.selected:null}open(e){if(e===`stats`){this.openStatsChip();return}if(this.panels.has(e))return;let t=new c(this.doc,this.container,{explorer:`Explorer`,inspector:`Inspector`,logs:`Logs`}[e],{explorer:{x:12,y:44,w:240,h:320},inspector:{x:264,y:44,w:280,h:320},logs:{x:12,y:380,w:532,h:200}}[e]);t.onClose=()=>this.close(e),e===`inspector`&&(t.body.addEventListener(`pointerenter`,()=>{this.hovering=!0}),t.body.addEventListener(`pointerleave`,()=>{this.hovering=!1})),this.panels.set(e,t),e===`explorer`&&this.renderExplorer(),e===`inspector`&&this.renderInspector(),e===`logs`&&this.renderLogs()}close(e){if(e===`inspector`&&(this.hovering=!1),e===`stats`){this.statsChip?.remove(),this.statsChip=null;return}let t=this.panels.get(e);t&&(t.remove(),this.panels.delete(e))}toggle(e){if(e===`colliders`){this.setColliders({off:`all`,all:`selected`,selected:`off`}[this.colliderMode]);return}this.isOpen(e)?this.close(e):this.open(e)}setLevelEnabled(e,t){this.levelEnabled[e]=t,this.renderLogs()}setConsoleCapture(e){if(e!==this.consoleCapture)if(this.consoleCapture=e,e){this.renderLogs();let e=console;for(let t of _){let n=e[t];e[t]=(...e)=>{n.apply(console,e);let r=t===`log`?`info`:t;this.pushLog({level:r,source:`console`,text:e.map(x).join(` `)})},this.consolePatched.push(()=>{e[t]=n})}}else{for(let e of this.consolePatched)e();this.consolePatched=[],this.renderLogs()}}dispose(){this.engine.debugSelection=null,this.setColliders(`off`),this.setConsoleCapture(!1);for(let e of this.cleanups)e();for(let e of[...this.panels.keys()])this.close(e);this.close(`stats`),this.dropdown?.remove(),this.dropdown=null,this.menuButton.remove()}menuLabel(e,t){let n=e===`colliders`&&this.colliderMode!==`off`?` · ${this.colliderMode}`:``;return`${this.isOpen(e)?`✓ `:``}${t}${n}`}toggleDropdown(){if(this.dropdown){this.dropdown.remove(),this.dropdown=null;return}let e=this.doc.createElement(`div`);i(e,{position:`absolute`,top:`34px`,left:`8px`,background:`rgba(18,20,26,0.95)`,border:`1px solid rgba(255,255,255,0.18)`,borderRadius:`6px`,font:`12px ui-monospace, Menlo, monospace`,color:`rgba(255,255,255,0.85)`,zIndex:`60`,pointerEvents:`auto`,overflow:`hidden`});for(let[t,n]of[[`explorer`,`Explorer`],[`inspector`,`Inspector`],[`logs`,`Logs`],[`stats`,`Stats`],[`colliders`,`Colliders`]]){let r=this.doc.createElement(`div`);r.textContent=this.menuLabel(t,n),i(r,{padding:`6px 14px`,cursor:`pointer`,userSelect:`none`}),r.addEventListener(`click`,()=>{if(this.toggle(t),t===`colliders`){r.textContent=this.menuLabel(t,n);return}this.dropdown?.remove(),this.dropdown=null}),e.appendChild(r)}for(let t of this.actions){let n=this.doc.createElement(`div`);n.textContent=t.label,i(n,{padding:`6px 14px`,cursor:`pointer`,userSelect:`none`,borderTop:`1px solid rgba(255,255,255,0.14)`,color:`rgba(158,232,220,0.95)`}),n.addEventListener(`click`,()=>{this.dropdown?.remove(),this.dropdown=null,t.run()}),e.appendChild(n)}this.container.appendChild(e),this.dropdown=e}openStatsChip(){if(this.statsChip)return;let e=this.doc.createElement(`div`);i(e,{position:`absolute`,top:`8px`,right:`8px`,padding:`4px 10px`,background:`rgba(18,20,26,0.85)`,border:`1px solid rgba(255,255,255,0.18)`,borderRadius:`6px`,color:`rgba(255,255,255,0.85)`,font:`12px ui-monospace, Menlo, monospace`,textAlign:`right`,whiteSpace:`pre`,userSelect:`none`,pointerEvents:`none`,zIndex:`70`}),this.container.appendChild(e),this.statsChip=e,this.renderStats()}renderStats(){let e=this.statsChip;if(!e)return;let t=this.engine.stats(),n=this.statsSource?.()??{},r=[`nodes ${t.nodes}`,...n.triangles===void 0?[]:[`tris ${b(n.triangles)}`],...n.drawCalls===void 0?[]:[`calls ${n.drawCalls}`]].join(` · `);e.textContent=`${Math.round(t.fps)} fps · ${t.frameMs.toFixed(1)} ms\n${r}`}renderExplorer(){let e=this.panels.get(`explorer`);if(!e)return;let t=e.body.scrollTop;y(e.body);let n=this.engine.scene?.root;if(!n){e.body.scrollTop=t;return}let r=(e,t)=>{let n=e.constructor,a=e.children.length>0,o=this.collapsedFlags.get(e)===!0,s=this.doc.createElement(`div`);i(s,{display:`flex`,alignItems:`center`,cursor:`pointer`,padding:`1px 2px`,borderRadius:`3px`,background:e===this.selected?`rgba(110,160,255,0.25)`:`transparent`});let c=this.doc.createElement(`span`);c.textContent=a?o?`▸`:`▾`:`·`,i(c,{width:`14px`,flex:`none`,textAlign:`center`,opacity:a?`0.85`:`0.25`,userSelect:`none`}),a&&c.addEventListener(`click`,t=>{t.stopPropagation?.(),this.collapsedFlags.set(e,!o),this.renderExplorer()}),s.appendChild(c);let l=this.doc.createElement(`span`);l.textContent=e.name,i(l,{whiteSpace:`nowrap`}),s.appendChild(l);let u=this.doc.createElement(`span`);if(u.textContent=` ${n.typeName}`,i(u,{opacity:`0.45`,whiteSpace:`nowrap`,fontSize:`10px`}),s.appendChild(u),a&&o){let t=this.doc.createElement(`span`);t.textContent=` (${e.children.length})`,i(t,{opacity:`0.35`,fontSize:`10px`}),s.appendChild(t)}if(s.addEventListener(`click`,()=>{this.selected=e,this.engine.debugSelection=e,this.applyColliderScope(),this.open(`inspector`),this.renderExplorer(),this.renderInspector()}),t.appendChild(s),a&&!o){let n=this.doc.createElement(`div`);i(n,{marginLeft:`8px`,paddingLeft:`8px`,borderLeft:`1px solid rgba(255,255,255,0.14)`});for(let t of e.children)r(t,n);t.appendChild(n)}};r(n,e.body),e.body.scrollTop=t}renderInspector(){let e=this.panels.get(`inspector`);if(!e)return;let n=e.body.scrollTop;y(e.body);let r=this.selected;if(r&&r.tree===null&&(this.selected=null,this.engine.debugSelection=null,this.applyColliderScope(),r=null),!r){let t=this.doc.createElement(`div`);t.textContent=`select a node in the Explorer`,i(t,{opacity:`0.6`}),e.body.appendChild(t);return}let a=r.constructor,o=this.doc.createElement(`div`);if(o.textContent=`${r.getPath()}  ·  ${a.typeName}${r.uid?`  ·  ${r.uid}`:``}`,i(o,{fontWeight:`700`,marginBottom:`6px`,whiteSpace:`pre-wrap`}),e.body.appendChild(o),r.groups.size>0){let t=this.doc.createElement(`div`);t.textContent=`groups: ${[...r.groups].join(`, `)}`,i(t,{opacity:`0.7`,marginBottom:`6px`}),e.body.appendChild(t)}let s=t(a),c=r;for(let t of Object.keys(s)){let n=s[t];this.renderValueRow(e.body,r,t,{read:()=>c[t],write:e=>{c[t]=e},options:n?.options,variants:n?.variants})}e.body.scrollTop=n}renderValueRow(t,n,r,a){let o=a.read(),s=a.options,c={get[r](){return a.read()},set[r](e){a.write(e)}},u=this.doc.createElement(`div`);i(u,{display:`flex`,gap:`6px`,alignItems:`center`,margin:`2px 0`});let d=this.doc.createElement(`div`);d.textContent=r,i(d,{minWidth:`84px`,opacity:`0.75`}),u.appendChild(d);let h=(e,t)=>{let a=this.doc.createElement(`input`);return a.type=`number`,a.value=String(e),i(a,S(`70px`)),this.trackEditing(a),a.addEventListener(`change`,()=>{let e=Number(a.value);Number.isFinite(e)?t(e):a.value=String(n[r])}),a};if(typeof o==`number`)u.appendChild(h(o,e=>{c[r]=e}));else if(typeof o==`boolean`){let e=this.doc.createElement(`input`);e.type=`checkbox`,e.checked=o,this.trackEditing(e),e.addEventListener(`change`,()=>{c[r]=e.checked}),u.appendChild(e)}else if(typeof o==`string`&&s&&s.length>0){let e=this.doc.createElement(`select`);for(let t of s.includes(o)?s:[o,...s]){let n=this.doc.createElement(`option`);n.value=t,n.textContent=t,t===o&&(n.selected=!0),e.appendChild(n)}e.value=o,this.trackEditing(e),e.addEventListener(`change`,()=>{c[r]=e.value}),i(e,S(`110px`)),u.appendChild(e)}else if(typeof o==`string`){let e=this.doc.createElement(`input`);e.type=`text`,e.value=o,this.trackEditing(e),i(e,S(`140px`)),e.addEventListener(`change`,()=>{c[r]=e.value}),u.appendChild(e)}else if(Array.isArray(o)&&o.length<=8&&o.every(e=>typeof e==`number`))for(let e=0;e<o.length;e++)u.appendChild(h(o[e],t=>{let n=[...c[r]];n[e]=t,c[r]=n}));else if(m(o)){let s=this.doc.createElement(`div`);i(s,{marginLeft:`10px`,paddingLeft:`8px`,borderLeft:`1px solid rgba(255,255,255,0.14)`});let c=a.variants?.tag,l=Object.keys(o);c&&!l.includes(c)&&l.unshift(c);let d=a.path??r;for(let t of l){let r=t===c;this.renderValueRow(s,n,t,{path:`${d}.${t}`,read:()=>a.read()[t]??(r?``:null),write:n=>{if(r&&a.variants){let t=a.variants.byTag[String(n)];if(t!==void 0){a.write(e(t));return}}a.write({...a.read(),[t]:n})},options:r&&a.variants?Object.keys(a.variants.byTag):void 0})}t.appendChild(u),t.appendChild(s);return}else{let s=JSON.stringify(e(o));if(s.length<=l){let e=this.doc.createElement(`div`);e.textContent=s,i(e,{opacity:`0.65`,whiteSpace:`pre-wrap`,wordBreak:`break-all`}),u.appendChild(e)}else{let e=a.path??r,c=this.detailOpen.get(n)?.has(e)??!1,l=this.doc.createElement(`div`);if(l.textContent=`${c?`▾`:`▸`} ${f(o)}`,i(l,{opacity:`0.75`,cursor:`pointer`,userSelect:`none`}),l.addEventListener(`click`,()=>{let t=this.detailOpen.get(n);t||(t=new Set,this.detailOpen.set(n,t)),c?t.delete(e):t.add(e),this.renderInspector()}),u.appendChild(l),t.appendChild(u),c){let e=this.doc.createElement(`div`);e.textContent=p(o,s),i(e,{opacity:`0.6`,whiteSpace:`pre-wrap`,wordBreak:`break-all`,marginLeft:`10px`,paddingLeft:`8px`,borderLeft:`1px solid rgba(255,255,255,0.14)`}),t.appendChild(e)}return}}t.appendChild(u)}trackEditing(e){e.addEventListener(`focus`,()=>{this.editing+=1}),e.addEventListener(`blur`,()=>{this.editing=Math.max(0,this.editing-1)})}pushLog(e){this.logRows.push(e),this.logRows.length>g&&this.logRows.splice(0,this.logRows.length-g),this.renderLogs()}renderLogs(){let e=this.panels.get(`logs`);if(!e)return;y(e.body);let t=this.doc.createElement(`div`);i(t,{display:`flex`,gap:`8px`,marginBottom:`4px`,flexWrap:`wrap`});for(let e of[`debug`,`info`,`warn`,`error`]){let n=this.doc.createElement(`div`);n.textContent=`${this.levelEnabled[e]?`✓`:`·`}${e}`,i(n,{cursor:`pointer`,opacity:this.levelEnabled[e]?`1`:`0.45`}),n.addEventListener(`click`,()=>this.setLevelEnabled(e,!this.levelEnabled[e])),t.appendChild(n)}let n=this.doc.createElement(`div`);n.textContent=`${this.consoleCapture?`✓`:`·`}console`,i(n,{cursor:`pointer`,marginLeft:`auto`}),n.addEventListener(`click`,()=>this.setConsoleCapture(!this.consoleCapture)),t.appendChild(n),e.body.appendChild(t);let r={debug:`rgba(255,255,255,0.5)`,info:`rgba(255,255,255,0.85)`,warn:`#ffc861`,error:`#ff6b6b`};for(let t of this.logRows){if(!this.levelEnabled[t.level])continue;let n=this.doc.createElement(`div`);n.textContent=`[${t.source===`console`?`console`:t.level}] ${t.text}`,i(n,{color:r[t.level],whiteSpace:`pre-wrap`}),e.body.appendChild(n)}}};function y(e){for(let t of[...e.children])t.remove()}function b(e){return e>=1e6?`${(e/1e6).toFixed(1)}M`:e>=1e3?`${(e/1e3).toFixed(1)}k`:String(e)}function x(e){if(typeof e==`string`)return e;try{return JSON.stringify(e)}catch{return String(e)}}function S(e){return{width:e,background:`rgba(255,255,255,0.08)`,border:`1px solid rgba(255,255,255,0.2)`,borderRadius:`4px`,color:`inherit`,font:`inherit`,padding:`2px 4px`}}export{h as attachDebugOverlay};