@skewedaspect/sage 0.9.1 → 0.9.3

package/dist/sage.es.js

@@ -1,10 +1,65 @@
-import { AbstractMesh as e, ActionManager as t, ArcRotateCamera as n, Color3 as r, Color4 as i, CreateAudioEngineAsync as a, CubeTexture as o, DefaultRenderingPipeline as s, DirectionalLight as c, Engine as l, ExecuteCodeAction as u, FreeCamera as d, HDRCubeTexture as f, HavokPlugin as p, HemisphericLight as m, ImageProcessingConfiguration as h, ImportMeshAsync as g, LoadAssetContainerAsync as _, Mesh as v, MeshBuilder as y, NullEngine as b, PBRMaterial as x, PhysicsAggregate as ee, PhysicsShapeType as S, PointLight as C, Quaternion as te, RectAreaLight as w, SSAO2RenderingPipeline as ne, Scene as re, SelectionOutlineLayer as ie, SoundState as ae, SpotLight as oe, StandardMaterial as se, Texture as ce, TransformNode as le, UniversalCamera as ue, Vector3 as T, WebGPUEngine as de } from "@babylonjs/core";
-import { registerBuiltInLoaders as fe } from "@babylonjs/loaders/dynamic";
-import { GeospatialCamera as E } from "@babylonjs/core/Cameras/geospatialCamera";
-import { ClusteredLightContainer as D } from "@babylonjs/core/Lights/Clustered/clusteredLightContainer";
-import pe from "@babylonjs/havok";
-//#region src/utils/version.ts
-var O = "0.9.1", k = class {
+import { AbstractMesh as e, ActionManager as t, ArcRotateCamera as n, Color3 as r, Color4 as i, CreateAudioEngineAsync as a, CubeTexture as o, DefaultRenderingPipeline as s, DirectionalLight as c, Engine as l, ExecuteCodeAction as u, FreeCamera as d, HDRCubeTexture as f, HavokPlugin as p, HemisphericLight as m, ImageProcessingConfiguration as h, ImportMeshAsync as g, LoadAssetContainerAsync as _, Matrix as v, Mesh as y, MeshBuilder as b, NullEngine as x, PBRMaterial as S, PhysicsAggregate as C, PhysicsShapeType as w, PointLight as ee, Quaternion as T, RectAreaLight as te, SSAO2RenderingPipeline as ne, Scene as re, SelectionOutlineLayer as ie, SoundState as ae, SpotLight as oe, StandardMaterial as E, Texture as se, TransformNode as D, UniversalCamera as ce, Vector3 as O, WebGPUEngine as le } from "@babylonjs/core";
+import { registerBuiltInLoaders as ue } from "@babylonjs/loaders/dynamic";
+import { GeospatialCamera as de } from "@babylonjs/core/Cameras/geospatialCamera";
+import { ClusteredLightContainer as fe } from "@babylonjs/core/Lights/Clustered/clusteredLightContainer";
+import { PhysicsViewer as pe } from "@babylonjs/core/Debug/physicsViewer";
+import me from "@babylonjs/havok";
+//#region src/classes/debugConsole.ts
+var he = class {
+	_namespaceName;
+	_entries = /* @__PURE__ */ new Map();
+	_disposed = !1;
+	constructor(e = "sage") {
+		this._namespaceName = e, this._installNamespace();
+	}
+	expose(e, t) {
+		this._disposed || (this._isDynamicGetter(t) ? (this._entries.set(e, { getter: t.get }), this._defineGetter(e, t.get)) : (this._entries.set(e, { value: t }), this._defineValue(e, t)));
+	}
+	setNamespace(e) {
+		if (!(this._disposed || e === this._namespaceName)) {
+			this._removeNamespace(), this._namespaceName = e, this._installNamespace();
+			for (let [e, t] of this._entries) t.getter ? this._defineGetter(e, t.getter) : this._defineValue(e, t.value);
+		}
+	}
+	get namespaceName() {
+		return this._namespaceName;
+	}
+	dispose() {
+		this._disposed ||= (this._removeNamespace(), this._entries.clear(), !0);
+	}
+	async $teardown() {
+		this.dispose();
+	}
+	_isDynamicGetter(e) {
+		return typeof e == "object" && !!e && "get" in e && typeof e.get == "function";
+	}
+	_getNamespace() {
+		return Reflect.get(window, this._namespaceName);
+	}
+	_installNamespace() {
+		typeof window > "u" || Reflect.set(window, this._namespaceName, {});
+	}
+	_removeNamespace() {
+		typeof window > "u" || Reflect.deleteProperty(window, this._namespaceName);
+	}
+	_defineGetter(e, t) {
+		let n = this._getNamespace();
+		n && Object.defineProperty(n, e, {
+			get: t,
+			enumerable: !0,
+			configurable: !0
+		});
+	}
+	_defineValue(e, t) {
+		let n = this._getNamespace();
+		n && Object.defineProperty(n, e, {
+			value: t,
+			writable: !0,
+			enumerable: !0,
+			configurable: !0
+		});
+	}
+}, k = "0.9.3", A = class {
 	canvas;
 	renderEngine;
 	physics;
@@ -14,14 +69,19 @@ var O = "0.9.1", k = class {
 	logger;
 	raycast;
 	timer;
+	debug;
 	largeWorldRendering;
 	started = !1;
 	_log;
 	_beforeStartHook = null;
 	_onStartHook = null;
 	_onTeardownHook = null;
-	constructor(e, t, n, r, i, a, o, s, c, l = !1) {
-		this.canvas = e, this.renderEngine = t, this.physics = n, this.eventBus = r, this.logger = i, this.raycast = a, this.timer = o, this.engines = s, this.managers = c, this.largeWorldRendering = l, this._log = i.getLogger("GameEngine");
+	constructor(e, t, n, r, i, a, o, s, c, l = !1, u) {
+		this.canvas = e, this.renderEngine = t, this.physics = n, this.eventBus = r, this.logger = i, this.raycast = a, this.timer = o, this.engines = s, this.managers = c, this.debug = u ?? {
+			colliders: void 0,
+			console: null,
+			expose: () => {}
+		}, this.largeWorldRendering = l, this._log = i.getLogger("GameEngine");
 	}
 	onBeforeStart(e) {
 		if (this._beforeStartHook !== null) throw Error("A beforeStart hook is already registered. Only one hook is allowed per lifecycle event.");
@@ -42,17 +102,18 @@ var O = "0.9.1", k = class {
 		return this.eventBus.subscribe(`action:${e}`, t);
 	}
 	async start() {
-		this.started ? this._log.warn("Game engine is already started. Skipping start.") : (this._log.info(`Starting SkewedAspect Game Engine (Version: ${O})...`), this._beforeStartHook && (this._log.debug("Executing beforeStart hook..."), await this._beforeStartHook(this)), await this.managers.gameManager.start(), this._log.info("Game engine started successfully"), this._onStartHook && (this._log.debug("Executing onStart hook..."), await this._onStartHook(this)), this.started = !0);
+		this.started ? this._log.warn("Game engine is already started. Skipping start.") : (this._log.info(`Starting SkewedAspect Game Engine (Version: ${k})...`), this._beforeStartHook && (this._log.debug("Executing beforeStart hook..."), await this._beforeStartHook(this)), await this.managers.gameManager.start(), this._log.info("Game engine started successfully"), this._onStartHook && (this._log.debug("Executing onStart hook..."), await this._onStartHook(this)), this.started = !0);
 	}
 	async stop() {
 		if (this.started) {
-			this._log.info(`Stopping SkewedAspect Game Engine (Version: ${O})...`);
+			this._log.info(`Stopping SkewedAspect Game Engine (Version: ${k})...`);
 			let e = null;
 			if (this._onTeardownHook) try {
 				this._log.debug("Executing onTeardown hook..."), await this._onTeardownHook(this);
 			} catch (t) {
 				this._log.error(`Error in onTeardown hook: ${t}`), e ||= t;
 			}
+			this.debug.console && this.debug.console.dispose();
 			for (let t of Object.keys(this.managers)) {
 				let n = this.managers[t];
 				if (n) try {
@@ -72,7 +133,7 @@ var O = "0.9.1", k = class {
 			if (this.started = !1, this._log.info("Game engine stopped successfully"), e) throw e;
 		} else this._log.warn("Game engine is not started. Skipping stop.");
 	}
-}, A = class {
+}, j = class {
 	timers;
 	constructor() {
 		this.timers = /* @__PURE__ */ new Map();
@@ -131,7 +192,7 @@ var O = "0.9.1", k = class {
 			console.info(`${a} Timer '${t}' completed in ${i.toFixed(2)}ms`, o, s, c);
 		} else console.warn(`[${e}]: Timer '${t}' does not exist`);
 	}
-}, j = class {
+}, M = class {
 	trace(e, t, ...n) {}
 	debug(e, t, ...n) {}
 	info(e, t, ...n) {}
@@ -139,11 +200,11 @@ var O = "0.9.1", k = class {
 	error(e, t, ...n) {}
 	time(e, t) {}
 	timeEnd(e, t) {}
-}, M = class {
+}, N = class {
 	category;
 	backend;
 	minLevel;
-	constructor(e, t = "none", n = new j()) {
+	constructor(e, t = "none", n = new M()) {
 		this.category = e, this.backend = n, this.minLevel = t;
 	}
 	updateSettings(e, t) {
@@ -181,21 +242,21 @@ var O = "0.9.1", k = class {
 			default: return !1;
 		}
 	}
-}, N = class {
+}, P = class {
 	backend;
 	level;
 	loggers;
-	constructor(e = "debug", t = new A()) {
+	constructor(e = "debug", t = new j()) {
 		this.backend = t, this.level = e, this.loggers = /* @__PURE__ */ new Map();
 	}
 	setBackend(e) {
 		this.backend = e, this.loggers.forEach((e) => {
-			e instanceof M && e.updateSettings(this.backend, this.level);
+			e instanceof N && e.updateSettings(this.backend, this.level);
 		});
 	}
 	setLevel(e) {
 		this.level = e, this.loggers.forEach((e) => {
-			e instanceof M && e.updateSettings(this.backend, this.level);
+			e instanceof N && e.updateSettings(this.backend, this.level);
 		});
 	}
 	getLevel() {
@@ -203,14 +264,14 @@ var O = "0.9.1", k = class {
 	}
 	getLogger(e) {
 		let t = this.loggers.get(e);
-		return t || (t = new M(e, this.level, this.backend), this.loggers.set(e, t)), t;
+		return t || (t = new N(e, this.level, this.backend), this.loggers.set(e, t)), t;
 	}
-}, P = class {
+}, F = class {
 	directMap = /* @__PURE__ */ new Map();
 	patternSubs = /* @__PURE__ */ new Set();
 	_log;
 	constructor(e) {
-		this._log = e?.getLogger("EventBus") || new M("EventBus");
+		this._log = e?.getLogger("EventBus") || new N("EventBus");
 	}
 	subscribe(e, t) {
 		return this._log.trace(`Subscribe request for: ${e.toString()}`), e instanceof RegExp || typeof e == "string" && e.includes("*") ? this.subscribePattern(e, t) : this.subscribeExact(e, t);
@@ -255,7 +316,7 @@ var O = "0.9.1", k = class {
 	async $teardown() {
 		this._log.debug("Tearing down EventBus"), this.directMap.clear(), this.patternSubs.clear();
 	}
-}, F = class {
+}, I = class {
 	_engine = null;
 	_mainBus = null;
 	_buses = /* @__PURE__ */ new Map();
@@ -299,8 +360,8 @@ var O = "0.9.1", k = class {
 };
 //#endregion
 //#region src/engines/scene.ts
-fe();
-var I = class {
+ue();
+var L = class {
 	_canvas;
 	_engine;
 	_havok;
@@ -311,14 +372,14 @@ var I = class {
 	createScene() {
 		return new re(this._engine);
 	}
-	enablePhysics(e, t = new T(0, -9.8, 0), n) {
+	enablePhysics(e, t = new O(0, -9.8, 0), n) {
 		this._log.debug(`Enabling physics with gravity (${t.x}, ${t.y}, ${t.z})...`);
 		let r = n === void 0 ? void 0 : { floatingOriginWorldRadius: n }, i = new p(!0, this._havok, r);
 		e.enablePhysics(t, i);
 	}
 	createFreeCamera(e, t, n, r) {
 		let i = new d(e, t, n);
-		return i.setTarget(T.Zero()), r ??= this._canvas, r && i.attachControl(r, !0), i;
+		return i.setTarget(O.Zero()), r ??= this._canvas, r && i.attachControl(r, !0), i;
 	}
 	createHemisphericLight(e, t, n, r = .7) {
 		let i = new m(e, t, n);
@@ -329,7 +390,7 @@ var I = class {
 		return i.intensity = r, i;
 	}
 	createPointLight(e, t, n, r = 1) {
-		let i = new C(e, t, n);
+		let i = new ee(e, t, n);
 		return i.intensity = r, i;
 	}
 	createSpotLight(e, t, n, r, i, a, o = 1) {
@@ -337,24 +398,24 @@ var I = class {
 		return s.intensity = o, s;
 	}
 	createRectAreaLight(e, t, n, r, i, a = 1) {
-		let o = new w(e, t, n, r, i);
+		let o = new te(e, t, n, r, i);
 		return o.intensity = a, o;
 	}
 	createSphere(e, t = {}, n) {
-		return y.CreateSphere(e, {
+		return b.CreateSphere(e, {
 			diameter: 1,
 			segments: 32,
 			...t
 		}, n);
 	}
 	createBox(e, t = {}, n) {
-		return y.CreateBox(e, {
+		return b.CreateBox(e, {
 			size: 1,
 			...t
 		}, n);
 	}
 	createGround(e, t = {}, n) {
-		return y.CreateGround(e, {
+		return b.CreateGround(e, {
 			width: 6,
 			height: 6,
 			subdivisions: 2,
@@ -362,7 +423,7 @@ var I = class {
 		}, n);
 	}
 	createCylinder(e, t = {}, n) {
-		return y.CreateCylinder(e, {
+		return b.CreateCylinder(e, {
 			height: 2,
 			diameterTop: 1,
 			diameterBottom: 1,
@@ -370,7 +431,7 @@ var I = class {
 		}, n);
 	}
 	addPhysics(e, t, n = {}, r) {
-		return new ee(e, t, {
+		return new C(e, t, {
 			mass: 1,
 			restitution: .75,
 			friction: .5,
@@ -398,14 +459,14 @@ var I = class {
 	async $teardown() {
 		this._log.info("Tearing down SceneEngine"), this._log.info("SceneEngine torn down successfully");
 	}
-}, L = class {
+}, R = class {
 	_eventBus;
 	_sceneEngine;
 	_log;
 	_containers = /* @__PURE__ */ new Map();
 	_sourceMeshes = /* @__PURE__ */ new Map();
 	constructor(e, t, n) {
-		this._eventBus = e, this._sceneEngine = t, this._log = n?.getLogger("AssetManager") ?? new M("AssetManager");
+		this._eventBus = e, this._sceneEngine = t, this._log = n?.getLogger("AssetManager") ?? new N("AssetManager");
 	}
 	_parsePath(e) {
 		let t = e.indexOf("#");
@@ -491,16 +552,16 @@ var I = class {
 	async $teardown() {
 		this.disposeAll();
 	}
-}, R = [
+}, z = [
 	"trigger",
 	"toggle",
 	"value"
-], me = [
+], ge = [
 	"keyboard",
 	"mouse",
 	"gamepad"
 ];
-function z(e) {
+function _e(e) {
 	return e.type === "keyboard";
 }
 function B(e) {
@@ -511,7 +572,7 @@ function V(e) {
 }
 //#endregion
 //#region src/classes/bindings/trigger.ts
-var he = class {
+var ve = class {
 	type = "trigger";
 	action;
 	context;
@@ -582,7 +643,7 @@ var he = class {
 			options: this.options
 		};
 	}
-}, ge = class {
+}, ye = class {
 	type = "toggle";
 	action;
 	context;
@@ -656,7 +717,7 @@ var he = class {
 			options: this.options
 		};
 	}
-}, _e = class {
+}, be = class {
 	type = "value";
 	action;
 	context;
@@ -719,7 +780,7 @@ var he = class {
 			options: this.options
 		};
 	}
-}, ve = class e {
+}, xe = class e {
 	sourceType = "key";
 	sourceKey;
 	useDelta;
@@ -742,7 +803,7 @@ var he = class {
 			options: { useDelta: this.useDelta }
 		};
 	}
-}, ye = class e {
+}, Se = class e {
 	sourceType;
 	sourceKey;
 	constructor(e, t) {
@@ -777,7 +838,7 @@ var he = class {
 			sourceKey: this.sourceKey
 		};
 	}
-}, be = class e {
+}, Ce = class e {
 	sourceType;
 	sourceKey;
 	useAnalogValue;
@@ -816,7 +877,7 @@ var he = class {
 			}
 		};
 	}
-}, xe = .05, Se = .5, Ce = class {
+}, we = .05, Te = .5, Ee = class {
 	_bindings = /* @__PURE__ */ new Map();
 	_actions = /* @__PURE__ */ new Map();
 	_contexts = /* @__PURE__ */ new Map();
@@ -831,7 +892,7 @@ var he = class {
 		this._eventBus = e, this._inputUnsubscribe = this._eventBus.subscribe("input:changed", (e) => {
 			let t = e.payload;
 			t && this.$handleInput(t.device, t.state);
-		}), this._log = t?.getLogger("BindingManager") || new M("BindingManager"), this._log.debug("BindingManager initialized");
+		}), this._log = t?.getLogger("BindingManager") || new N("BindingManager"), this._log.debug("BindingManager initialized");
 	}
 	_isBindingContextActive(e) {
 		return e.context ? this._activeContexts.has(e.context) : !0;
@@ -849,22 +910,22 @@ var he = class {
 		return t;
 	}
 	_shouldUpdateActiveDevice(e) {
-		return B(e) ? Object.values(e.buttons).some((e) => e.pressed) || e.wheel !== void 0 : V(e) ? Object.values(e.buttons).some((e) => e.pressed) || Object.values(e.axes).some((e) => Math.abs(e) > xe) : !0;
+		return B(e) ? Object.values(e.buttons).some((e) => e.pressed) || e.wheel !== void 0 : V(e) ? Object.values(e.buttons).some((e) => e.pressed) || Object.values(e.axes).some((e) => Math.abs(e) > we) : !0;
 	}
 	_createBindingFromDefinition(e) {
 		let t = this._actions.get(e.action);
 		if (!t) return this._log.warn(`Cannot create binding: Action "${e.action}" not found.`), null;
 		let { deviceID: n, ...r } = e.input;
 		switch (e.type) {
-			case "trigger": return new he(t, n, e.input.type, this._createInputSourceFromDefinition(r), {
+			case "trigger": return new ve(t, n, e.input.type, this._createInputSourceFromDefinition(r), {
 				...e.options || {},
 				context: e.context
 			});
-			case "toggle": return new ge(t, n, e.input.type, this._createInputSourceFromDefinition(r), {
+			case "toggle": return new ye(t, n, e.input.type, this._createInputSourceFromDefinition(r), {
 				...e.options || {},
 				context: e.context
 			});
-			case "value": return new _e(t, n, e.input.type, this._createInputSourceFromDefinition(r), {
+			case "value": return new be(t, n, e.input.type, this._createInputSourceFromDefinition(r), {
 				...e.options || {},
 				context: e.context
 			});
@@ -873,16 +934,16 @@ var he = class {
 	}
 	_createInputSourceFromDefinition(e) {
 		switch (e.type) {
-			case "keyboard": return new ve(e.sourceKey, e.options);
+			case "keyboard": return new xe(e.sourceKey, e.options);
 			case "mouse": {
 				let t = e.sourceType;
 				if (!(t === "button" || t === "position" || t === "wheel")) throw Error(`Invalid mouse source type: ${t}`);
-				return new ye(t, e.sourceKey);
+				return new Se(t, e.sourceKey);
 			}
 			case "gamepad": {
 				let t = e.sourceType;
 				if (!(t === "button" || t === "axis")) throw Error(`Invalid gamepad source type: ${t}`);
-				return new be(t, e.sourceKey, e.options);
+				return new Ce(t, e.sourceKey, e.options);
 			}
 			default: throw Error(`Unsupported input source type: ${e.type}`);
 		}
@@ -893,7 +954,7 @@ var he = class {
 		let { options: r } = n;
 		if (!r.deviceTypes.includes(e.type)) return;
 		let i = null;
-		if (z(t)) {
+		if (_e(t)) {
 			if (t.event?.repeat === !0) return;
 			for (let n of Object.keys(t.delta)) if (t.delta[n] === !0) {
 				i = {
@@ -925,7 +986,7 @@ var he = class {
 				break;
 			}
 			if (!i) {
-				for (let n of Object.keys(t.axes)) if (Math.abs(t.axes[n]) > Se) {
+				for (let n of Object.keys(t.axes)) if (Math.abs(t.axes[n]) > Te) {
 					i = {
 						type: "gamepad",
 						sourceType: "axis",
@@ -1040,7 +1101,7 @@ var he = class {
 		return this._contexts.get(e) || null;
 	}
 	$registerBinding(e) {
-		if (!R.includes(e.type)) throw Error(`Invalid binding type: ${e.type}`);
+		if (!z.includes(e.type)) throw Error(`Invalid binding type: ${e.type}`);
 		e.context && !this._contexts.has(e.context) && this.registerContext(e.context), this._bindings.has(e.deviceID) || this._bindings.set(e.deviceID, []), this._bindings.get(e.deviceID)?.push(e), this._log.debug(`Registered ${e.type} binding for "${e.action.name}" in context "${e.context || null}"`);
 	}
 	registerBinding(e) {
@@ -1113,12 +1174,12 @@ var he = class {
 function H() {
 	return typeof window < "u" && window.document !== void 0;
 }
-function U() {
+function De() {
 	return H() && !!window.navigator.gpu;
 }
 //#endregion
 //#region node_modules/hexoid/dist/index.mjs
-for (var we = class {
+for (var Oe = class {
 	_engine;
 	_eventBus;
 	_entityManager;
@@ -1132,7 +1193,7 @@ for (var we = class {
 	_paused = !1;
 	started = !1;
 	constructor(e, t, n, r, i, a) {
-		this._engine = e, this._eventBus = t, this._entityManager = n, this._inputManager = r, this._levelManager = i, this._log = a?.getLogger("GameManager") || new M("GameManager"), this._boundRenderLoop = this._renderLoop.bind(this), this._boundResizeHandler = this._resizeHandler.bind(this), H() && window.addEventListener("resize", this._boundResizeHandler);
+		this._engine = e, this._eventBus = t, this._entityManager = n, this._inputManager = r, this._levelManager = i, this._log = a?.getLogger("GameManager") || new N("GameManager"), this._boundRenderLoop = this._renderLoop.bind(this), this._boundResizeHandler = this._resizeHandler.bind(this), H() && window.addEventListener("resize", this._boundResizeHandler);
 	}
 	get currentScene() {
 		return this._levelManager.currentLevel?.scene ?? null;
@@ -1194,21 +1255,21 @@ for (var we = class {
 	async $teardown() {
 		this._log.info("Tearing down GameManager"), this.started && await this.stop(), H() && window.removeEventListener("resize", this._boundResizeHandler), this._frameCallbacks = [], this._log.info("GameManager torn down successfully");
 	}
-}, W = 256, G = []; W--;) G[W] = (W + 256).toString(16).substring(1);
-function Te(e) {
+}, U = 256, W = []; U--;) W[U] = (U + 256).toString(16).substring(1);
+function ke(e) {
 	e ||= 16;
 	var t = "", n = 0;
 	return function() {
 		if (!t || n === 256) {
-			for (t = "", n = (1 + e) / 2 | 0; n--;) t += G[256 * Math.random() | 0];
+			for (t = "", n = (1 + e) / 2 | 0; n--;) t += W[256 * Math.random() | 0];
 			t = t.substring(n = 0, e - 2);
 		}
-		return t + G[n++];
+		return t + W[n++];
 	};
 }
 //#endregion
 //#region src/utils/id.ts
-var Ee = Te(16), K = class {
+var Ae = ke(16), G = class {
 	entity = null;
 	$emit(e) {
 		if (!this.entity) throw Error("Entity is not set for this behavior.");
@@ -1229,7 +1290,7 @@ var Ee = Te(16), K = class {
 	$setEntity(e) {
 		this.entity = e;
 	}
-}, De = class {
+}, je = class {
 	id;
 	type;
 	name;
@@ -1244,7 +1305,7 @@ var Ee = Te(16), K = class {
 	_tags = /* @__PURE__ */ new Set();
 	subscriptions = /* @__PURE__ */ new Map();
 	constructor(e, t, n, r, i) {
-		this.id = Ee(), this.type = e, this.name = i, this.state = n, this.eventBus = t;
+		this.id = Ae(), this.type = e, this.name = i, this.state = n, this.eventBus = t;
 		for (let e of r) this.attachBehavior(new e());
 	}
 	get tags() {
@@ -1287,6 +1348,51 @@ var Ee = Te(16), K = class {
 		let t = this._gameEngine?.managers?.levelManager?.currentLevel?.outlines;
 		t && (e ? t.unhighlightEntity(e, this) : t.unhighlightEntityAll(this));
 	}
+	showCollider(e, t) {
+		if (!this.node || !this._gameEngine) return;
+		let n = this._gameEngine.debug?.colliders;
+		if (!n) return;
+		let r = this._getPhysicsNodes();
+		if (e === void 0 || e === !0) {
+			for (let e of r) n.showColliderForNode(e, void 0);
+			return;
+		}
+		if (typeof e == "string") {
+			if (e.startsWith("#")) {
+				for (let t of r) n.showColliderForNode(t, e);
+				return;
+			}
+			let i = r.find((t) => t.name === e);
+			i && n.showColliderForNode(i, t);
+			return;
+		}
+		if (typeof e == "object") {
+			let t = e;
+			for (let e of r) {
+				let r = t[e.name];
+				r && n.showColliderForNode(e, r);
+			}
+		}
+	}
+	hideCollider(e) {
+		if (!this.node || !this._gameEngine) return;
+		let t = this._gameEngine.debug?.colliders;
+		if (!t) return;
+		let n = this._getPhysicsNodes();
+		if (e === void 0) {
+			for (let e of n) t.hideColliderForNode(e);
+			return;
+		}
+		let r = n.find((t) => t.name === e);
+		r && t.hideColliderForNode(r);
+	}
+	_getPhysicsNodes() {
+		if (!this.node) return [];
+		let e = [];
+		this.node.physicsBody && e.push(this.node);
+		for (let t of this.node.getChildTransformNodes(!1)) t.physicsBody && e.push(t);
+		return e;
+	}
 	$addChild(e) {
 		this.children.push(e), e.parent = this, this.node && e.node && (e.node.parent = this.node);
 	}
@@ -1413,7 +1519,7 @@ var Ee = Te(16), K = class {
 		}
 		return this.behaviors.splice(t, 1), n.$setEntity(null), !0;
 	}
-}, Oe = class {
+}, Me = class {
 	eventBus;
 	entities = /* @__PURE__ */ new Map();
 	entityDefinitions = /* @__PURE__ */ new Map();
@@ -1426,7 +1532,7 @@ var Ee = Te(16), K = class {
 	_entitiesByNode = /* @__PURE__ */ new Map();
 	_pools = /* @__PURE__ */ new Map();
 	constructor(e, t, n) {
-		this.eventBus = e, this.bindingManager = n, this._log = t?.getLogger("EntityManager") || new M("EntityManager"), this._log.info("EntityManager initialized");
+		this.eventBus = e, this.bindingManager = n, this._log = t?.getLogger("EntityManager") || new N("EntityManager"), this._log.info("EntityManager initialized");
 	}
 	$setGameEngine(e) {
 		this._gameEngine = e;
@@ -1537,7 +1643,7 @@ var Ee = Te(16), K = class {
 			let t = await n.onBeforeCreate(r);
 			t !== void 0 && (r = t);
 		}
-		let i = t.name ?? n.name, a = new De(n.type, this.eventBus, r, n.behaviors, i);
+		let i = t.name ?? n.name, a = new je(n.type, this.eventBus, r, n.behaviors, i);
 		if (a.$setEntityManager(this), t.node && a.$attachToNode(t.node, this._engine), n.tags) for (let e of n.tags) a.$addTag(e);
 		if (t.tags) for (let e of t.tags) a.$addTag(e);
 		if (this.entities.set(a.id, a), this._indexEntity(a), this._log.debug(`Entity created with ID: ${a.id}${i ? ` (name: ${i})` : ""}`), n.onCreate) {
@@ -1707,18 +1813,18 @@ var Ee = Te(16), K = class {
 		}
 		this.entityDefinitions.clear(), this._entitiesByName.clear(), this._entitiesByType.clear(), this._entitiesByTag.clear(), this._entitiesByNode.clear(), this._log.info("EntityManager torn down successfully");
 	}
-}, ke = {
+}, Ne = {
 	hable: h.TONEMAPPING_STANDARD,
 	reinhard: h.TONEMAPPING_STANDARD,
 	hejidawson: h.TONEMAPPING_STANDARD,
 	photographic: h.TONEMAPPING_STANDARD,
 	aces: h.TONEMAPPING_ACES
 };
-function Ae(e, t) {
+function Pe(e, t) {
 	if (!e.activeCamera) return;
 	t.volumetric && console.warn("[SAGE] Volumetric lighting requires renderer: \"frameGraph\". Ignored in pipeline mode.");
 	let n = new s("sage-default", !0, e, e.cameras);
-	if (t.bloom && (n.bloomEnabled = !0, t.bloom.weight !== void 0 && (n.bloomWeight = t.bloom.weight), t.bloom.threshold !== void 0 && (n.bloomThreshold = t.bloom.threshold), t.bloom.scale !== void 0 && (n.bloomScale = t.bloom.scale), t.bloom.kernel !== void 0 && (n.bloomKernel = t.bloom.kernel)), t.tonemap && (n.imageProcessingEnabled = !0, n.imageProcessing.toneMappingEnabled = !0, t.tonemap.operator && (n.imageProcessing.toneMappingType = ke[t.tonemap.operator] ?? h.TONEMAPPING_STANDARD)), t.grain && (n.grainEnabled = !0, t.grain.intensity !== void 0 && (n.grain.intensity = t.grain.intensity), t.grain.animated !== void 0 && (n.grain.animated = t.grain.animated)), t.vignette && (n.imageProcessingEnabled = !0, n.imageProcessing.vignetteEnabled = !0, t.vignette.weight !== void 0 && (n.imageProcessing.vignetteWeight = t.vignette.weight), t.vignette.stretch !== void 0 && (n.imageProcessing.vignetteStretch = t.vignette.stretch), t.vignette.color && (n.imageProcessing.vignetteColor = new i(t.vignette.color.r, t.vignette.color.g, t.vignette.color.b, 1))), t.sharpen && (n.sharpenEnabled = !0, t.sharpen.edge !== void 0 && (n.sharpen.edgeAmount = t.sharpen.edge), t.sharpen.color !== void 0 && (n.sharpen.colorAmount = t.sharpen.color)), t.chromaticAberration && (n.chromaticAberrationEnabled = !0, t.chromaticAberration.amount !== void 0 && (n.chromaticAberration.aberrationAmount = t.chromaticAberration.amount)), t.ssao) {
+	if (t.bloom && (n.bloomEnabled = !0, t.bloom.weight !== void 0 && (n.bloomWeight = t.bloom.weight), t.bloom.threshold !== void 0 && (n.bloomThreshold = t.bloom.threshold), t.bloom.scale !== void 0 && (n.bloomScale = t.bloom.scale), t.bloom.kernel !== void 0 && (n.bloomKernel = t.bloom.kernel)), t.tonemap && (n.imageProcessingEnabled = !0, n.imageProcessing.toneMappingEnabled = !0, t.tonemap.operator && (n.imageProcessing.toneMappingType = Ne[t.tonemap.operator] ?? h.TONEMAPPING_STANDARD)), t.grain && (n.grainEnabled = !0, t.grain.intensity !== void 0 && (n.grain.intensity = t.grain.intensity), t.grain.animated !== void 0 && (n.grain.animated = t.grain.animated)), t.vignette && (n.imageProcessingEnabled = !0, n.imageProcessing.vignetteEnabled = !0, t.vignette.weight !== void 0 && (n.imageProcessing.vignetteWeight = t.vignette.weight), t.vignette.stretch !== void 0 && (n.imageProcessing.vignetteStretch = t.vignette.stretch), t.vignette.color && (n.imageProcessing.vignetteColor = new i(t.vignette.color.r, t.vignette.color.g, t.vignette.color.b, 1))), t.sharpen && (n.sharpenEnabled = !0, t.sharpen.edge !== void 0 && (n.sharpen.edgeAmount = t.sharpen.edge), t.sharpen.color !== void 0 && (n.sharpen.colorAmount = t.sharpen.color)), t.chromaticAberration && (n.chromaticAberrationEnabled = !0, t.chromaticAberration.amount !== void 0 && (n.chromaticAberration.aberrationAmount = t.chromaticAberration.amount)), t.ssao) {
 		let n = new ne("sage-ssao", e, {
 			ssaoRatio: .5,
 			blurRatio: 1
@@ -1728,25 +1834,25 @@ function Ae(e, t) {
 }
 //#endregion
 //#region src/handlers/postProcessing.ts
-async function je(e, t) {
+async function Fe(e, t) {
 	if (t.renderer === "frameGraph") {
 		let { applyFrameGraphPostProcessing: n } = await import("./postProcessingFrameGraph-CaMgQzR-.js");
 		await n(e, t);
-	} else Ae(e, t);
+	} else Pe(e, t);
 }
 //#endregion
 //#region src/utils/vectors.ts
-function q(e) {
+function K(e) {
 	return {
 		x: e.x,
 		y: e.y,
 		z: e.z
 	};
 }
-function J(e) {
-	return new T(e.x, e.y, e.z);
+function q(e) {
+	return new O(e.x, e.y, e.z);
 }
-function Me(e) {
+function Ie(e) {
 	return {
 		x: e.x,
 		y: e.y,
@@ -1754,12 +1860,27 @@ function Me(e) {
 		w: e.w
 	};
 }
-function Ne(e) {
-	return new te(e.x, e.y, e.z, e.w);
+function Le(e) {
+	return new T(e.x, e.y, e.z, e.w);
+}
+function Re(e) {
+	e.computeWorldMatrix(!0);
+	let t = e.getWorldMatrix().clone(), n = e.parent;
+	for (; n;) {
+		n.computeWorldMatrix(!0);
+		let e = n.getWorldMatrix(), r = n.parent, i;
+		r ? (r.computeWorldMatrix(!0), i = e.multiply(v.Invert(r.getWorldMatrix()))) : i = e, i.determinant() < 0 && (t = v.Invert(i).multiply(t)), n = r;
+	}
+	let r = new O(), i = new T(), a = new O();
+	return t.decompose(a, i, r), {
+		position: r,
+		rotation: i,
+		scaling: a
+	};
 }
 //#endregion
 //#region src/classes/level.ts
-var Pe = class {
+var ze = class {
 	name;
 	_log;
 	_context;
@@ -1767,7 +1888,7 @@ var Pe = class {
 	clusteredLights = null;
 	outlines = null;
 	constructor(e, t) {
-		this.name = e.name, this._context = t, this._log = t.logger?.getLogger(`Level:${e.name}`) ?? new M(`Level:${e.name}`, "info");
+		this.name = e.name, this._context = t, this._log = t.logger?.getLogger(`Level:${e.name}`) ?? new N(`Level:${e.name}`, "info");
 	}
 	get scene() {
 		return this._scene;
@@ -1822,7 +1943,7 @@ var Pe = class {
 			this.outlines &&= (this.outlines.dispose(), null), this.clusteredLights &&= (this.clusteredLights.dispose(), null), this._scene.dispose(), this._scene = null;
 		}
 	}
-}, Fe = class {
+}, Be = class {
 	_scene;
 	_layers = /* @__PURE__ */ new Map();
 	constructor(e, t) {
@@ -1866,7 +1987,7 @@ var Pe = class {
 			n.length > 0 && e.layer.addSelection(n);
 		}
 	}
-}, Ie = class extends Pe {
+}, Ve = class extends ze {
 	_config;
 	_spawnPoints = [];
 	_entityNodes = [];
@@ -1888,9 +2009,9 @@ var Pe = class {
 		let n = e.createScene();
 		if (this._scene = n, this._config.physics && (this.$emitProgress(5, "Initializing physics..."), await this._enablePhysics(n)), this._config.scene && (this.$emitProgress(10, "Loading scene file..."), await this._loadSceneFile(n)), this._config.environment && (this.$emitProgress(15, "Setting up environment..."), this._processEnvironment(n)), this._processCameras(n), this._processLights(n), this._setupClustering(n), this._config.postProcessing) {
 			let e = this._config.postProcessing.renderer ?? "pipeline";
-			this._log.info(`Applying post-processing with ${e} renderer`), await je(n, this._config.postProcessing);
+			this._log.info(`Applying post-processing with ${e} renderer`), await Fe(n, this._config.postProcessing);
 		}
-		return this.outlines = new Fe(n, this._config.outlines), this.$emitProgress(50, "Processing scene properties..."), await this._processNodeProperties(n), this.$emitProgress(70, "Spawning entities..."), await this._processSpawnPoints(), this.$emitProgress(85, "Configuring entities..."), await this._processEntityNodes(), this._config.sounds && (this.$emitProgress(95, "Loading sounds..."), await this._processLevelSounds()), n;
+		return this.outlines = new Be(n, this._config.outlines), this.$emitProgress(50, "Processing scene properties..."), await this._processNodeProperties(n), this.$emitProgress(70, "Spawning entities..."), await this._processSpawnPoints(), this.$emitProgress(85, "Configuring entities..."), await this._processEntityNodes(), this._config.sounds && (this.$emitProgress(95, "Loading sounds..."), await this._processLevelSounds()), n;
 	}
 	async _loadSceneFile(e) {
 		let t = this._getScenePath();
@@ -1921,11 +2042,11 @@ var Pe = class {
 					}
 					e.environmentTexture && e.createDefaultSkybox(e.environmentTexture, !0, t.skyboxSize ?? 1e3, 0, !1);
 				} else {
-					let n = t.skyboxSize ?? 1e3, r = y.CreateSphere("skybox", {
+					let n = t.skyboxSize ?? 1e3, r = b.CreateSphere("skybox", {
 						diameter: n,
 						segments: 32
-					}, e), i = new se("skybox-mat", e);
-					i.backFaceCulling = !1, i.disableLighting = !0, i.emissiveTexture = new ce(t.skybox, e), r.material = i, r.infiniteDistance = !0;
+					}, e), i = new E("skybox-mat", e);
+					i.backFaceCulling = !1, i.disableLighting = !0, i.emissiveTexture = new se(t.skybox, e), r.material = i, r.infiniteDistance = !0;
 				}
 				this._log.debug(`Skybox set from: ${t.skybox}`);
 			}
@@ -1961,20 +2082,20 @@ var Pe = class {
 		}
 	}
 	_createCamera(e, t, r) {
-		let i = t.position ? J(t.position) : T.Zero(), a;
+		let i = t.position ? q(t.position) : O.Zero(), a;
 		switch (t.type) {
 			case "arcRotate": {
-				let i = t.target ? J(t.target) : T.Zero();
+				let i = t.target ? q(t.target) : O.Zero();
 				a = new n(e, t.alpha ?? Math.PI / 2, t.beta ?? Math.PI / 3, t.radius ?? 10, i, r);
 				break;
 			}
 			case "universal":
-				a = new ue(e, i, r);
+				a = new ce(e, i, r);
 				break;
 			case "geospatial": {
-				if (!t.planetRadius) return this._log.warn(`Geospatial camera "${e}" requires planetRadius -- skipping`), new d(e, T.Zero(), r);
-				let n = new E(e, r, { planetRadius: t.planetRadius });
-				t.center && (n.center = J(t.center)), t.yaw !== void 0 && (n.yaw = t.yaw), t.pitch !== void 0 && (n.pitch = t.pitch), t.radius !== void 0 && (n.radius = t.radius), t.checkCollisions !== void 0 && (n.checkCollisions = t.checkCollisions), t.radiusMin !== void 0 && (n.limits.radiusMin = t.radiusMin), t.radiusMax !== void 0 && (n.limits.radiusMax = t.radiusMax), t.pitchMin !== void 0 && (n.limits.pitchMin = t.pitchMin), t.pitchMax !== void 0 && (n.limits.pitchMax = t.pitchMax), t.yawMin !== void 0 && (n.limits.yawMin = t.yawMin), t.yawMax !== void 0 && (n.limits.yawMax = t.yawMax), a = n;
+				if (!t.planetRadius) return this._log.warn(`Geospatial camera "${e}" requires planetRadius -- skipping`), new d(e, O.Zero(), r);
+				let n = new de(e, r, { planetRadius: t.planetRadius });
+				t.center && (n.center = q(t.center)), t.yaw !== void 0 && (n.yaw = t.yaw), t.pitch !== void 0 && (n.pitch = t.pitch), t.radius !== void 0 && (n.radius = t.radius), t.checkCollisions !== void 0 && (n.checkCollisions = t.checkCollisions), t.radiusMin !== void 0 && (n.limits.radiusMin = t.radiusMin), t.radiusMax !== void 0 && (n.limits.radiusMax = t.radiusMax), t.pitchMin !== void 0 && (n.limits.pitchMin = t.pitchMin), t.pitchMax !== void 0 && (n.limits.pitchMax = t.pitchMax), t.yawMin !== void 0 && (n.limits.yawMin = t.yawMin), t.yawMax !== void 0 && (n.limits.yawMax = t.yawMax), a = n;
 				break;
 			}
 			default:
@@ -1984,7 +2105,7 @@ var Pe = class {
 		return this._applyCameraConfig(a, t), a;
 	}
 	_applyCameraConfig(e, t) {
-		t.fov !== void 0 && (e.fov = t.fov), t.position && (e.position = J(t.position)), t.minZ !== void 0 && (e.minZ = t.minZ), t.maxZ !== void 0 && (e.maxZ = t.maxZ), e instanceof d && (t.speed !== void 0 && (e.speed = t.speed), t.rotation && (e.rotation = J(t.rotation))), e instanceof n && (t.target && e.setTarget(J(t.target)), t.lowerRadiusLimit !== void 0 && (e.lowerRadiusLimit = t.lowerRadiusLimit), t.upperRadiusLimit !== void 0 && (e.upperRadiusLimit = t.upperRadiusLimit), t.lowerBetaLimit !== void 0 && (e.lowerBetaLimit = t.lowerBetaLimit), t.upperBetaLimit !== void 0 && (e.upperBetaLimit = t.upperBetaLimit), t.wheelPrecision !== void 0 && (e.wheelPrecision = t.wheelPrecision)), e instanceof E && (t.yaw !== void 0 && (e.yaw = t.yaw), t.pitch !== void 0 && (e.pitch = t.pitch), t.radius !== void 0 && (e.radius = t.radius), t.center && (e.center = J(t.center)), t.checkCollisions !== void 0 && (e.checkCollisions = t.checkCollisions), t.radiusMin !== void 0 && (e.limits.radiusMin = t.radiusMin), t.radiusMax !== void 0 && (e.limits.radiusMax = t.radiusMax), t.pitchMin !== void 0 && (e.limits.pitchMin = t.pitchMin), t.pitchMax !== void 0 && (e.limits.pitchMax = t.pitchMax));
+		t.fov !== void 0 && (e.fov = t.fov), t.position && (e.position = q(t.position)), t.minZ !== void 0 && (e.minZ = t.minZ), t.maxZ !== void 0 && (e.maxZ = t.maxZ), e instanceof d && (t.speed !== void 0 && (e.speed = t.speed), t.rotation && (e.rotation = q(t.rotation))), e instanceof n && (t.target && e.setTarget(q(t.target)), t.lowerRadiusLimit !== void 0 && (e.lowerRadiusLimit = t.lowerRadiusLimit), t.upperRadiusLimit !== void 0 && (e.upperRadiusLimit = t.upperRadiusLimit), t.lowerBetaLimit !== void 0 && (e.lowerBetaLimit = t.lowerBetaLimit), t.upperBetaLimit !== void 0 && (e.upperBetaLimit = t.upperBetaLimit), t.wheelPrecision !== void 0 && (e.wheelPrecision = t.wheelPrecision)), e instanceof de && (t.yaw !== void 0 && (e.yaw = t.yaw), t.pitch !== void 0 && (e.pitch = t.pitch), t.radius !== void 0 && (e.radius = t.radius), t.center && (e.center = q(t.center)), t.checkCollisions !== void 0 && (e.checkCollisions = t.checkCollisions), t.radiusMin !== void 0 && (e.limits.radiusMin = t.radiusMin), t.radiusMax !== void 0 && (e.limits.radiusMax = t.radiusMax), t.pitchMin !== void 0 && (e.limits.pitchMin = t.pitchMin), t.pitchMax !== void 0 && (e.limits.pitchMax = t.pitchMax));
 	}
 	_processLights(e) {
 		let t = this._config.lights;
@@ -1994,7 +2115,7 @@ var Pe = class {
 		}
 	}
 	_createLight(e, t, n) {
-		let r = t.direction ? J(t.direction) : new T(0, -1, 0), i = t.position ? J(t.position) : T.Zero();
+		let r = t.direction ? q(t.direction) : new O(0, -1, 0), i = t.position ? q(t.position) : O.Zero();
 		switch (t.type) {
 			case "hemispheric": {
 				let i = new m(e, r, n);
@@ -2007,7 +2128,7 @@ var Pe = class {
 				break;
 			}
 			case "point": {
-				let r = new C(e, i, n);
+				let r = new ee(e, i, n);
 				this._applyLightConfig(r, t);
 				break;
 			}
@@ -2017,10 +2138,10 @@ var Pe = class {
 				break;
 			}
 			case "rectarea": {
-				let a = new w(e, i, t.width ?? 1, t.height ?? 1, n);
+				let a = new te(e, i, t.width ?? 1, t.height ?? 1, n);
 				if (this._applyLightConfig(a, t), t.direction) {
-					let t = new le(`${e}_pivot`, n);
-					t.position = a.position.clone(), a.position = T.Zero(), a.parent = t, t.lookAt(t.position.subtract(r));
+					let t = new D(`${e}_pivot`, n);
+					t.position = a.position.clone(), a.position = O.Zero(), a.parent = t, t.lookAt(t.position.subtract(r));
 				}
 				break;
 			}
@@ -2032,22 +2153,22 @@ var Pe = class {
 	_setupClustering(e) {
 		let t = this._config.clustering;
 		if (!t?.enabled) return;
-		let n = e.lights.filter((e) => D.IsLightSupported(e));
+		let n = e.lights.filter((e) => fe.IsLightSupported(e));
 		if (n.length === 0) {
 			this._log.debug("Clustering enabled but no eligible lights found");
 			return;
 		}
 		for (let t of n) e.removeLight(t);
-		let r = new D("sage-clustered", n, e);
+		let r = new fe("sage-clustered", n, e);
 		t.horizontalTiles !== void 0 && (r.horizontalTiles = t.horizontalTiles), t.verticalTiles !== void 0 && (r.verticalTiles = t.verticalTiles), t.depthSlices !== void 0 && (r.depthSlices = t.depthSlices), t.maxRange !== void 0 && (r.maxRange = t.maxRange), this.clusteredLights = r, this._log.debug(`Clustered lighting enabled: ${n.length} lights, ${r.horizontalTiles}x${r.verticalTiles} tiles, ${r.depthSlices} depth slices`);
-		for (let t of e.materials) t instanceof x && (t.useGLTFLightFalloff = !0);
+		for (let t of e.materials) t instanceof S && (t.useGLTFLightFalloff = !0);
 	}
 	_toColor3(e) {
 		return new r(e.r, e.g, e.b);
 	}
 	async _enablePhysics(e) {
-		let t = this._config.physics, n = new T(0, -9.81, 0);
-		typeof t == "object" && t.gravity && (n = new T(t.gravity.x, t.gravity.y, t.gravity.z));
+		let t = this._config.physics, n = new O(0, -9.81, 0);
+		typeof t == "object" && t.gravity && (n = new O(t.gravity.x, t.gravity.y, t.gravity.z));
 		let r = this.gameEngine.largeWorldRendering ? 1e5 : void 0;
 		this._log.debug(`Enabling physics with gravity: ${n.toString()}`), await this.gameEngine.engines.sceneEngine.enablePhysics(e, n, r);
 	}
@@ -2068,13 +2189,17 @@ var Pe = class {
 		return t ? { ...t } : e.metadata;
 	}
 	async _processNodeMetadata(e) {
-		"spawn" in e.metadata && this._spawnPoints.push({
-			name: e.metadata.spawn,
-			position: e.getAbsolutePosition(),
-			rotation: e.absoluteRotationQuaternion.clone(),
-			scaling: e.scaling.clone(),
-			node: e
-		}), "entity" in e.metadata && this._entityNodes.push({
+		if ("spawn" in e.metadata) {
+			let { position: t, rotation: n, scaling: r } = Re(e);
+			this._spawnPoints.push({
+				name: e.metadata.spawn,
+				position: t,
+				rotation: n,
+				scaling: r,
+				node: e
+			});
+		}
+		"entity" in e.metadata && this._entityNodes.push({
 			type: e.metadata.entity,
 			node: e
 		}), await this._runPropertyHandlers(e);
@@ -2095,17 +2220,21 @@ var Pe = class {
 	async _processSpawnPoint(e, t) {
 		try {
 			let n = await this._spawnEntity(t, e);
-			this._spawnedEntities.push(n), e.node.dispose(), this._log.debug(`Spawned entity '${t.entity}' at spawn point '${e.name}'`);
+			this._spawnedEntities.push(n), this._applyDebugCollider(n, t.debugCollider), e.node.dispose(), this._log.debug(`Spawned entity '${t.entity}' at spawn point '${e.name}'`);
 		} catch (t) {
 			this._log.error(`Failed to spawn entity at spawn point '${e.name}':`, t);
 		}
 	}
+	_applyDebugCollider(e, t) {
+		let n = this.gameEngine.managers.entityManager.getDefinition(e.type)?.debugCollider, r = t ?? n;
+		r && e.showCollider(r);
+	}
 	async _spawnEntity(e, t) {
 		let n = {
 			...e.config,
-			position: q(t.position),
-			rotation: Me(t.rotation),
-			scaling: q(t.scaling)
+			position: K(t.position),
+			rotation: Ie(t.rotation),
+			scaling: K(t.scaling)
 		}, r = await this.gameEngine.managers.entityManager.createEntity(e.entity, {
 			name: e.name,
 			tags: e.tags,
@@ -2117,12 +2246,10 @@ var Pe = class {
 		if (!this._scene) return;
 		let n = this.gameEngine.managers.entityManager.getDefinition(e.type);
 		if (!n?.mesh) return;
-		let r = n.mesh, i = this._scene, a = new le(`entity-${e.id}`, i);
-		a.position.copyFrom(t.position), a.rotationQuaternion = t.rotation.clone(), a.scaling.copyFrom(t.scaling);
-		let o;
+		let r = n.mesh, i = this._scene, a = new D(`entity-${e.id}`, i), o;
 		switch (r.source) {
 			case "box":
-				o = [y.CreateBox(`${e.type}-mesh`, {
+				o = [b.CreateBox(`${e.type}-mesh`, {
 					size: r.params?.size ?? 1,
 					width: r.params?.width,
 					height: r.params?.height,
@@ -2130,19 +2257,19 @@ var Pe = class {
 				}, i)];
 				break;
 			case "sphere":
-				o = [y.CreateSphere(`${e.type}-mesh`, {
+				o = [b.CreateSphere(`${e.type}-mesh`, {
 					diameter: r.params?.diameter ?? 1,
 					segments: r.params?.segments ?? 16
 				}, i)];
 				break;
 			case "capsule":
-				o = [y.CreateCapsule(`${e.type}-mesh`, {
+				o = [b.CreateCapsule(`${e.type}-mesh`, {
 					height: r.params?.height ?? 1.8,
 					radius: r.params?.radius ?? .4
 				}, i)];
 				break;
 			case "cylinder":
-				o = [y.CreateCylinder(`${e.type}-mesh`, {
+				o = [b.CreateCylinder(`${e.type}-mesh`, {
 					height: r.params?.height ?? 1,
 					diameter: r.params?.diameter ?? 1
 				}, i)];
@@ -2159,21 +2286,21 @@ var Pe = class {
 			}
 		}
 		for (let e of o) e.parent ||= a;
-		r.scale && (typeof r.scale == "number" ? a.scaling.setAll(r.scale) : a.scaling.set(r.scale.x, r.scale.y, r.scale.z));
+		a.position.copyFrom(t.position), a.rotationQuaternion = t.rotation.clone(), a.scaling.copyFrom(t.scaling), r.scale && (typeof r.scale == "number" ? a.scaling.setAll(r.scale) : a.scaling.set(r.scale.x, r.scale.y, r.scale.z));
 		let s = r.material;
 		if (s?.color) {
 			let t = s.color;
 			if (s.type === "pbr") {
-				let n = new x(`${e.type}-material`, i);
+				let n = new S(`${e.type}-material`, i);
 				n.albedoColor = this._toColor3(t), s.emissive && (n.emissiveColor = this._toColor3(s.emissive)), n.metallic = s.metallic ?? 0, n.roughness = s.roughness ?? 1;
 				for (let e of o) e.material = n;
 			} else {
-				let n = new se(`${e.type}-material`, i);
+				let n = new E(`${e.type}-material`, i);
 				n.diffuseColor = this._toColor3(t), s.emissive && (n.emissiveColor = this._toColor3(s.emissive));
 				for (let e of o) e.material = n;
 			}
 		}
-		let c = [...o, ...a.getChildren()];
+		let c = a.getDescendants(!1).filter((e) => e instanceof D);
 		for (let e of c) {
 			let t = this._getNormalizedMetadata(e);
 			t && Object.keys(t).length > 0 && (e.metadata = {
@@ -2191,14 +2318,14 @@ var Pe = class {
 		try {
 			let n = {
 				...t?.config,
-				position: q(e.node.position)
+				position: K(e.node.position)
 			}, r = await this.gameEngine.managers.entityManager.createEntity(e.type, {
 				name: t?.name ?? e.node.name,
 				tags: t?.tags,
 				initialState: n,
 				node: e.node
 			});
-			this._spawnedEntities.push(r), this._log.debug(`Created entity '${e.type}' for node '${e.node.name}'`);
+			this._spawnedEntities.push(r), this._applyDebugCollider(r, t?.debugCollider), this._log.debug(`Created entity '${e.type}' for node '${e.node.name}'`);
 		} catch (t) {
 			this._log.error(`Failed to create entity for node '${e.node.name}':`, t);
 		}
@@ -2243,7 +2370,7 @@ var Pe = class {
 		for (let e of this._levelSounds.values()) e.dispose();
 		this._levelSounds.clear(), this._playingSoundsBeforeDeactivate.clear(), await super.$dispose();
 	}
-}, Le = class {
+}, He = class {
 	_eventBus;
 	_gameEngine = null;
 	_log;
@@ -2261,7 +2388,7 @@ var Pe = class {
 		return this._propertyHandlers;
 	}
 	constructor(e, t) {
-		this._eventBus = e, this._logger = t, this._log = t?.getLogger("LevelManager") || new M("LevelManager"), this._eventUnsubscribers.push(this._eventBus.subscribe("level:progress", (e) => {
+		this._eventBus = e, this._logger = t, this._log = t?.getLogger("LevelManager") || new N("LevelManager"), this._eventUnsubscribers.push(this._eventBus.subscribe("level:progress", (e) => {
 			this._handleProgress(e.payload);
 		})), this._eventUnsubscribers.push(this._eventBus.subscribe("level:complete", (e) => {
 			this._handleComplete(e.payload);
@@ -2296,7 +2423,7 @@ var Pe = class {
 			if (!n) throw Error(`Level class '${e.class}' is not registered.`);
 			return this._log.debug(`Creating level '${e.name}' using class '${e.class}'`), new n(e, t);
 		}
-		return this._log.debug(`Creating level '${e.name}' using GameLevel`), new Ie(e, t);
+		return this._log.debug(`Creating level '${e.name}' using GameLevel`), new Ve(e, t);
 	}
 	registerLevelConfig(e) {
 		this._levelConfigs.has(e.name) && this._log.warn(`Level config '${e.name}' is already registered. Overwriting.`), this._levelConfigs.set(e.name, e), this._log.info(`Registered level config: ${e.name}`);
@@ -2382,7 +2509,7 @@ var Pe = class {
 		for (let e of this._loadedLevels.values()) await e.$dispose();
 		this._loadedLevels.clear(), this._levelConfigs.clear(), this._currentLevel = null;
 	}
-}, Re = class {
+}, Ue = class {
 	_audioEngine;
 	_channels = /* @__PURE__ */ new Map();
 	_masterMuted = !1;
@@ -2453,14 +2580,14 @@ var Pe = class {
 	getChannels() {
 		return Array.from(this._channels.keys());
 	}
-}, ze = class {
+}, We = class {
 	_entityManager;
 	_levelManager;
 	_log;
 	_beforeSerializeHooks = [];
 	_afterDeserializeHooks = [];
 	constructor(e, t, n) {
-		this._entityManager = e, this._levelManager = t, this._log = n?.getLogger("SaveManager") || new M("SaveManager"), this._log.info("SaveManager initialized");
+		this._entityManager = e, this._levelManager = t, this._log = n?.getLogger("SaveManager") || new N("SaveManager"), this._log.info("SaveManager initialized");
 	}
 	onBeforeSerialize(e) {
 		this._beforeSerializeHooks.push(e);
@@ -2543,7 +2670,46 @@ var Pe = class {
 	async $teardown() {
 		this._beforeSerializeHooks = [], this._afterDeserializeHooks = [], this._log.info("SaveManager torn down");
 	}
-}, Be = class {
+}, Ge = class {
+	_viewer = null;
+	_shown = /* @__PURE__ */ new Map();
+	_materials = /* @__PURE__ */ new Map();
+	showColliderForNode(e, t) {
+		if (!e.physicsBody || this._shown.has(e)) return;
+		let n = this._getViewer(e).showBody(e.physicsBody);
+		if (!n) return;
+		let r = { debugMesh: n };
+		if (t) {
+			let i = this._getColorMaterial(t, e);
+			n.material = i, r.colorMaterial = i;
+		}
+		this._shown.set(e, r);
+	}
+	hideColliderForNode(e) {
+		!this._shown.get(e) || !this._viewer || (e.physicsBody && this._viewer.hideBody(e.physicsBody), this._shown.delete(e));
+	}
+	hideAll() {
+		for (let [e] of this._shown) this.hideColliderForNode(e);
+	}
+	isShown(e) {
+		return this._shown.has(e);
+	}
+	async $teardown() {
+		this.dispose();
+	}
+	dispose() {
+		this._viewer &&= (this.hideAll(), this._viewer.dispose(), null), this._shown.clear();
+		for (let e of this._materials.values()) e.dispose();
+		this._materials.clear();
+	}
+	_getViewer(e) {
+		return this._viewer ||= new pe(e.getScene()), this._viewer;
+	}
+	_getColorMaterial(e, t) {
+		let n = this._materials.get(e);
+		return n || (n = new E(`sage-collider-debug-${e}`, t.getScene()), n.emissiveColor = r.FromHexString(e), n.disableLighting = !0, n.wireframe = !0, this._materials.set(e, n), n);
+	}
+}, Ke = class {
 	_keyboardDevice;
 	_keysState = {};
 	_onDeviceConnected;
@@ -2608,7 +2774,7 @@ var Pe = class {
 	_notifyInputChanged(e) {
 		this._onInputChanged && this._onInputChanged(this._keyboardDevice, e);
 	}
-}, Ve = class {
+}, qe = class {
 	_targetElement;
 	_mouseDevice;
 	_buttonState = {};
@@ -2727,7 +2893,7 @@ var Pe = class {
 	_notifyInputChanged(e) {
 		this._onInputChanged && this._onInputChanged(this._mouseDevice, e);
 	}
-}, He = class {
+}, Je = class {
 	_gamepadDevices = {};
 	_buttonStates = {};
 	_axesStates = {};
@@ -2861,14 +3027,14 @@ var Pe = class {
 	_notifyInputChanged(e, t) {
 		this._onInputChanged && this._onInputChanged(e, t);
 	}
-}, Ue = class {
+}, Ye = class {
 	_eventBus;
 	_keyboardRA;
 	_mouseRA;
 	_gamepadRA;
 	_log;
 	constructor(e, t, n) {
-		this._eventBus = e, this._log = n?.getLogger("UserInputManager") || new M("UserInputManager"), this._log.info("Initializing UserInputManager"), this._log.debug("Initializing input resource access classes"), this._keyboardRA = new Be(), this._mouseRA = new Ve(t), this._gamepadRA = new He(), this._log.debug("Registering input event callbacks"), this._keyboardRA.onDeviceConnected(this._publishDeviceConnected.bind(this)), this._keyboardRA.onInputChanged(this._publishInputChanged.bind(this)), this._mouseRA.onDeviceConnected(this._publishDeviceConnected.bind(this)), this._mouseRA.onInputChanged(this._publishInputChanged.bind(this)), this._gamepadRA.onDeviceConnected(this._publishDeviceConnected.bind(this)), this._gamepadRA.onDeviceDisconnected(this._publishDeviceDisconnected.bind(this)), this._gamepadRA.onInputChanged(this._publishInputChanged.bind(this)), this._log.info("UserInputManager initialized successfully");
+		this._eventBus = e, this._log = n?.getLogger("UserInputManager") || new N("UserInputManager"), this._log.info("Initializing UserInputManager"), this._log.debug("Initializing input resource access classes"), this._keyboardRA = new Ke(), this._mouseRA = new qe(t), this._gamepadRA = new Je(), this._log.debug("Registering input event callbacks"), this._keyboardRA.onDeviceConnected(this._publishDeviceConnected.bind(this)), this._keyboardRA.onInputChanged(this._publishInputChanged.bind(this)), this._mouseRA.onDeviceConnected(this._publishDeviceConnected.bind(this)), this._mouseRA.onInputChanged(this._publishInputChanged.bind(this)), this._gamepadRA.onDeviceConnected(this._publishDeviceConnected.bind(this)), this._gamepadRA.onDeviceDisconnected(this._publishDeviceDisconnected.bind(this)), this._gamepadRA.onInputChanged(this._publishInputChanged.bind(this)), this._log.info("UserInputManager initialized successfully");
 	}
 	_publishDeviceConnected(e) {
 		this._log.debug(`Device connected: ${e.id} (${e.name})`), this._eventBus.publish({
@@ -2921,18 +3087,18 @@ var Pe = class {
 };
 //#endregion
 //#region src/utils/graphics.ts
-async function We(e, t) {
-	let n = new de(e, t);
+async function Xe(e, t) {
+	let n = new le(e, t);
 	return await n.initAsync(), n;
 }
-function Y(e, t) {
+function J(e, t) {
 	return new l(e, t.antialias, t.options, t.adaptToDeviceRatio);
 }
-function Ge(e) {
-	return new b(e);
+function Ze(e) {
+	return new x(e);
 }
-async function Ke(e, t, n = !1) {
-	if (e === null) return console.debug("Using Null Engine"), Ge(t);
+async function Qe(e, t, n = !1) {
+	if (e === null) return console.debug("Using Null Engine"), Ze(t);
 	if (n) if ("options" in t) {
 		let e = t;
 		t = {
@@ -2947,32 +3113,32 @@ async function Ke(e, t, n = !1) {
 		useLargeWorldRendering: !0
 	};
 	let r = t.engine || "auto";
-	if (r === "webgpu") if (U()) try {
-		return console.debug("Using forced WebGPU engine"), await We(e, t);
+	if (r === "webgpu") if (De()) try {
+		return console.debug("Using forced WebGPU engine"), await Xe(e, t);
 	} catch (e) {
 		throw console.error("Forced WebGPU initialization failed:", e), Error("Forced WebGPU failed to initialize. If WebGPU is required, check browser compatibility.", { cause: e });
 	}
 	else throw Error("WebGPU was forced but is not available in this browser.");
-	if (r === "webgl") return console.debug("Using forced WebGL engine"), Y(e, t);
-	if (U()) try {
-		return console.debug("Using WebGPU"), We(e, t).catch((n) => (console.warn("WebGPU initialization failed, falling back to WebGL:", n), Y(e, t)));
+	if (r === "webgl") return console.debug("Using forced WebGL engine"), J(e, t);
+	if (De()) try {
+		return console.debug("Using WebGPU"), Xe(e, t).catch((n) => (console.warn("WebGPU initialization failed, falling back to WebGL:", n), J(e, t)));
 	} catch (e) {
 		console.warn("WebGPU initialization failed, falling back to WebGL:", e);
 	}
 	else console.warn("WebGPU not supported, falling back to WebGL.");
-	return console.debug("Using WebGL"), Y(e, t);
+	return console.debug("Using WebGL"), J(e, t);
 }
 //#endregion
 //#region src/utils/physics.ts
-async function qe() {
-	return await pe();
+async function $e() {
+	return await me();
 }
-function Je(e) {
+function et(e) {
 	return new p(!0, e);
 }
 //#endregion
 //#region src/utils/raycast.ts
-var Ye = class {
+var tt = class {
 	_entityManager;
 	constructor(e) {
 		this._entityManager = e;
@@ -3038,7 +3204,7 @@ var Ye = class {
 			pickingInfo: e
 		};
 	}
-}, Xe = class {
+}, nt = class {
 	_nextId = 0;
 	_delays = [];
 	_intervals = [];
@@ -3093,21 +3259,120 @@ var Ye = class {
 		for (let t of this._intervals) for (t.elapsed += e; t.elapsed >= t.periodMs;) t.callback(), t.elapsed -= t.periodMs;
 		for (let t of this._cooldowns) t.remaining > 0 && (t.remaining = Math.max(0, t.remaining - e));
 	}
-}, Ze = [
+};
+//#endregion
+//#region src/utils/entityProxy.ts
+function rt(e) {
+	return new Proxy(e, { get(e, t) {
+		if (typeof t == "symbol") return Reflect.get(e, t);
+		if (t in e) {
+			let n = Reflect.get(e, t);
+			return typeof n == "function" ? n.bind(e) : n;
+		}
+		return e.getByName(t);
+	} });
+}
+//#endregion
+//#region src/debug/builtins.ts
+function it(e, t) {
+	return typeof e == "string" ? t.managers.entityManager.getByName(e) : e;
+}
+function at(e, t) {
+	let n = t.managers.entityManager;
+	if (e === void 0) return [...n.getAllEntities()];
+	if (typeof e != "string") return [e];
+	let r = n.getByName(e);
+	if (r) return [r];
+	let i = n.getByType(e);
+	return i.length > 0 ? i : (console.warn(`[sage] No entity found with name or type "${e}"`), []);
+}
+function ot(e, t) {
+	let n = t.managers.entityManager, r = t.managers.gameManager, i = t.managers.levelManager, a = [];
+	e.expose("engine", t), e.expose("events", t.eventBus), e.expose("physics", t.physics), e.expose("colliders", t.debug.colliders), e.expose("entities", rt(n)), e.expose("level", { get: () => i.currentLevel }), e.expose("scene", { get: () => i.currentLevel?.scene ?? null }), e.expose("tp", (e, n, r, i) => {
+		let a = it(e, t);
+		if (!a) {
+			console.warn(`[sage] Entity not found: ${e}`);
+			return;
+		}
+		if (!a.node) {
+			console.warn(`[sage] Entity "${a.name ?? a.id}" has no node`);
+			return;
+		}
+		a.node.position.x = n, a.node.position.y = r, a.node.position.z = i, console.log(`[sage] Teleported "${a.name ?? a.id}" to (${n}, ${r}, ${i})`);
+	}), e.expose("spawn", async (e, t, r, i) => {
+		let a = await n.createEntity(e, { initialState: { position: {
+			x: t,
+			y: r,
+			z: i
+		} } });
+		return console.log(`[sage] Spawned "${e}" (${a.id}) at (${t}, ${r}, ${i})`), a;
+	}), e.expose("list", (e) => {
+		let t;
+		t = e ? n.getByType(e) : [...n.getAllEntities()];
+		let r = t.map((e) => ({
+			id: e.id,
+			type: e.type,
+			name: e.name ?? "(unnamed)",
+			node: e.node?.name ?? "(no node)"
+		}));
+		return console.table(r), t;
+	}), e.expose("inspect", (e) => {
+		let n = it(e, t);
+		if (!n) {
+			console.warn(`[sage] Entity not found: ${e}`);
+			return;
+		}
+		let r = {
+			id: n.id,
+			type: n.type,
+			name: n.name,
+			state: n.state,
+			behaviors: n.behaviors.map((e) => e.name),
+			node: n.node?.name ?? null,
+			position: n.node?.position ?? null
+		};
+		return console.log("[sage] Entity info:", r), r;
+	}), e.expose("showColliders", (e) => {
+		let n = at(e, t);
+		for (let e of n) e.showCollider();
+		console.log(`[sage] Showing colliders for ${n.length} entity(s)`);
+	}), e.expose("hideColliders", (e) => {
+		let n = at(e, t);
+		for (let e of n) e.hideCollider();
+		console.log(`[sage] Hiding colliders for ${n.length} entity(s)`);
+	}), e.expose("logEvents", (e) => {
+		let n = e ?? "*", r = t.eventBus.subscribe(n, (e) => {
+			console.log(`[sage] Event: ${e.type}`, e.payload);
+		});
+		return a.push(r), console.log(`[sage] Logging events matching "${n}"`), r;
+	}), e.expose("stopLogging", () => {
+		for (let e of a) e();
+		console.log(`[sage] Stopped ${a.length} event logger(s)`), a.length = 0;
+	}), e.expose("pause", () => {
+		r.pause("debug console"), console.log("[sage] Game paused");
+	}), e.expose("resume", () => {
+		r.resume("debug console"), console.log("[sage] Game resumed");
+	}), e.expose("slow", (e) => {
+		t.renderEngine.timeStep = 1 / 60 / e, console.log(`[sage] Time scale set to ${e}x (timeStep=${1 / 60 / e})`);
+	});
+}
+//#endregion
+//#region src/interfaces/logger.ts
+var st = [
 	"trace",
 	"debug",
 	"info",
 	"warn",
 	"error",
 	"none"
-], Qe = class extends K {
+], ct = class extends G {
 	name = "sound";
 	eventSubscriptions = [];
 	_sounds = /* @__PURE__ */ new Map();
 	_initialized = !1;
 	_audioManager = null;
 	_node = null;
-	_log = new M("SoundBehavior");
+	_log = new N("SoundBehavior");
 	onNodeAttached(e, t) {
 		if (this._initialized) return;
 		if (this._node = e, this._initialized = !0, this._log = t.logger.getLogger("SoundBehavior"), t.managers.audioManager) this._audioManager = t.managers.audioManager;
@@ -3190,7 +3455,7 @@ var Ye = class {
 		if (e) return this._sounds.get(e);
 		if (this._sounds.size === 1) return this._sounds.values().next().value;
 	}
-}, X = class {
+}, Y = class {
 	_currentState;
 	transitions = /* @__PURE__ */ new Map();
 	wildcardTransitions = /* @__PURE__ */ new Map();
@@ -3245,13 +3510,13 @@ var Ye = class {
 			}
 		});
 	}
-}, $e = class extends K {
+}, lt = class extends G {
 	name = "stateMachine";
 	eventSubscriptions = [];
 	stateMachine;
 	stateKey;
 	constructor() {
-		super(), this.stateMachine = new X(""), this.stateKey = "";
+		super(), this.stateMachine = new Y(""), this.stateKey = "";
 	}
 	get currentState() {
 		return this.stateMachine.currentState;
@@ -3264,67 +3529,75 @@ var Ye = class {
 	}
 	static create(e) {
 		let { initialState: t, stateKey: n, transitions: r, wildcardTransitions: i } = e;
-		class a extends $e {
+		class a extends lt {
 			constructor() {
-				super(), this.stateKey = n, this.stateMachine = new X(t);
+				super(), this.stateKey = n, this.stateMachine = new Y(t);
 				for (let e of r) this.stateMachine.addTransition(e.from, e.to, e.guard);
 				if (i) for (let e of i) this.stateMachine.addTransitionFromAny(e.to, e.guard);
 			}
 		}
 		return a;
 	}
-}, Z = new M("ColliderHandler");
-function Q(e, t, n) {
-	let r = e.getScene();
-	new ee(e, t, { mass: n }, r);
+}, X = new N("ColliderHandler");
+function ut(e) {
+	let { min: t, max: n } = e.getHierarchyBoundingVectors(!0), r = n.subtract(t), i = t.add(n).scale(.5).subtract(e.absolutePosition), a = e.absoluteRotationQuaternion, o = T.Inverse(a), s = new O();
+	return i.rotateByQuaternionToRef(o, s), {
+		extents: r,
+		center: s
+	};
+}
+function Z(e, t, n) {
+	let r = e.getScene(), i = { mass: n };
+	if (!(e instanceof y) && (t === w.BOX || t === w.SPHERE)) {
+		let { extents: n, center: r } = ut(e);
+		i.center = r, t === w.BOX ? i.extents = n : i.radius = Math.max(n.x, n.y, n.z) / 2;
+	}
+	new C(e, t, i, r);
 }
-function et(e, t) {
+function dt(e, t) {
 	let n = e.getChildMeshes().find((e) => e.metadata?.collider_mesh === !0);
-	n instanceof v ? (n.isVisible = !1, Q(n, S.MESH, t)) : Q(e, S.MESH, t);
+	n instanceof y ? (n.isVisible = !1, Z(n, w.MESH, t)) : Z(e, w.MESH, t);
 }
-function tt(t) {
+function ft(t) {
 	t.registerPropertyHandler("collider", (t, n, r, i) => {
 		let a = n;
-		if (Z.debug(`Processing collider: ${t.name} -> ${a} (isMesh: ${t instanceof v})`), !r.scene) throw Error("Scene not available for collider handler");
-		if (!(t instanceof v) && a === "mesh") {
-			Z.warn(`Skipping mesh collider for ${t.name}: not a Mesh instance`);
+		if (X.debug(`Processing collider: ${t.name} -> ${a} (isMesh: ${t instanceof y})`), !r.scene) throw Error("Scene not available for collider handler");
+		if (!(t instanceof y) && a === "mesh") {
+			X.warn(`Skipping mesh collider for ${t.name}: not a Mesh instance`);
 			return;
 		}
 		let o = t.metadata?.collider_mass ?? 0;
 		switch (a) {
 			case "box":
-				Q(t, S.BOX, o);
+				Z(t, w.BOX, o);
 				break;
 			case "sphere":
-				Q(t, S.SPHERE, o);
+				Z(t, w.SPHERE, o);
 				break;
 			case "mesh":
-				et(t, o);
+				dt(t, o);
 				break;
 			case "none":
 				t instanceof e && (t.checkCollisions = !1);
 				break;
-			default: Z.warn(`Unknown collider type: ${a}`);
-		}
-		if (t.metadata?.collider_kinematic) {
-			let e = t;
-			e.physicsBody && (e.physicsBody.disablePreStep = !1);
+			default: X.warn(`Unknown collider type: ${a}`);
 		}
+		t.metadata?.collider_kinematic && t instanceof e && t.physicsBody && (t.physicsBody.disablePreStep = !1);
 	});
 }
 //#endregion
 //#region src/handlers/lod.ts
-var nt = new M("LodHandler");
-function rt(e) {
+var pt = new N("LodHandler");
+function mt(e) {
 	return e.split(",").map((e) => parseFloat(e.trim())).filter((e) => !isNaN(e));
 }
-function it(e) {
+function ht(e) {
 	e.registerPropertyHandler("lod_distances", (e, t, n, r) => {
 		let i = t;
-		if (!(e instanceof v)) return;
-		let a = rt(i);
+		if (!(e instanceof y)) return;
+		let a = mt(i);
 		if (a.length === 0) {
-			nt.warn(`Invalid lod_distances value: ${i}`);
+			pt.warn(`Invalid lod_distances value: ${i}`);
 			return;
 		}
 		let o = e.getChildMeshes(!0), s = Math.min(a.length, o.length);
@@ -3335,14 +3608,14 @@ function it(e) {
 }
 //#endregion
 //#region src/handlers/occluder.ts
-function $(e) {
+function gt(e) {
 	e.registerPropertyHandler("occluder", (e, t, n, r) => {
-		t && e instanceof v && (e.isOccluder = !0, e.isVisible = !1);
+		t && e instanceof y && (e.isOccluder = !0, e.isVisible = !1);
 	});
 }
 //#endregion
 //#region src/utils/metadata.ts
-function at(e, t) {
+function _t(e, t) {
 	let n = {}, r = `${t}_`;
 	for (let [t, i] of Object.entries(e)) if (t.startsWith(r)) {
 		let e = t.slice(r.length);
@@ -3352,14 +3625,14 @@ function at(e, t) {
 }
 //#endregion
 //#region src/handlers/sound.ts
-var ot = new M("SoundHandler");
-function st(e) {
+var vt = new N("SoundHandler");
+function yt(e) {
 	e.registerPropertyHandler("sound", (e, t, n, r) => {
 		let i = t;
 		if (!n.scene) throw Error("Scene not available for sound handler");
-		let a = at(e.metadata, "sound"), o = a.volume ?? 1, s = a.loop ?? !0, c = a.spatial ?? !0, l = a.distance ?? 100, u = a.autoplay ?? !0, d = a.channel ?? "ambient", f = r.managers.audioManager;
+		let a = _t(e.metadata, "sound"), o = a.volume ?? 1, s = a.loop ?? !0, c = a.spatial ?? !0, l = a.distance ?? 100, u = a.autoplay ?? !0, d = a.channel ?? "ambient", f = r.managers.audioManager;
 		if (!f) {
-			ot.warn(`No AudioManager available. Sound for "${e.name}" skipped.`);
+			vt.warn(`No AudioManager available. Sound for "${e.name}" skipped.`);
 			return;
 		}
 		f.createSound(`${e.name}_sound`, i, d, {
@@ -3372,13 +3645,13 @@ function st(e) {
 		}).then((t) => {
 			c && t.spatial.attach(e);
 		}).catch((t) => {
-			ot.error(`Failed to create sound for node "${e.name}": ${t}`);
+			vt.error(`Failed to create sound for node "${e.name}": ${t}`);
 		});
 	});
 }
 //#endregion
 //#region src/handlers/trigger.ts
-function ct(e, n, r, i, a) {
+function Q(e, n, r, i, a) {
 	let o = a === "enter" ? t.OnIntersectionEnterTrigger : t.OnIntersectionExitTrigger, s = `trigger:${a}`;
 	e.registerAction(new u({
 		trigger: o,
@@ -3393,10 +3666,10 @@ function ct(e, n, r, i, a) {
 		});
 	}));
 }
-function lt(e, t, n, r) {
-	ct(e, t, n, r, "enter"), ct(e, t, n, r, "exit");
+function bt(e, t, n, r) {
+	Q(e, t, n, r, "enter"), Q(e, t, n, r, "exit");
 }
-function ut(n) {
+function xt(n) {
 	n.registerPropertyHandler("trigger", (n, r, i, a) => {
 		let o = r, s = i.scene;
 		if (!s) throw Error("Scene not available for trigger handler");
@@ -3405,9 +3678,9 @@ function ut(n) {
 		n.isVisible = !1, n.checkCollisions = !0;
 		let l = n.actionManager ?? new t(s);
 		n.actionManager = l;
-		for (let e of s.meshes) e !== n && !e.metadata?.trigger && lt(l, o, c, e);
+		for (let e of s.meshes) e !== n && !e.metadata?.trigger && bt(l, o, c, e);
 		let u = s.onNewMeshAddedObservable.add((e) => {
-			e !== n && !e.metadata?.trigger && lt(l, o, c, e);
+			e !== n && !e.metadata?.trigger && bt(l, o, c, e);
 		});
 		n.onDisposeObservable.add(() => {
 			s.onNewMeshAddedObservable.remove(u);
@@ -3416,7 +3689,7 @@ function ut(n) {
 }
 //#endregion
 //#region src/handlers/visible.ts
-function dt(t) {
+function $(t) {
 	t.registerPropertyHandler("visible", (t, n, r, i) => {
 		if (!(t instanceof e)) return;
 		let a = !0;
@@ -3425,39 +3698,41 @@ function dt(t) {
 }
 //#endregion
 //#region src/handlers/index.ts
-function ft(e) {
-	tt(e), it(e), $(e), st(e), ut(e), dt(e);
+function St(e) {
+	ft(e), ht(e), gt(e), yt(e), xt(e), $(e);
 }
 //#endregion
 //#region src/sage.ts
-async function pt(e, t, n = {}) {
-	let r = new N(n.logLevel || "debug"), i = r.getLogger("SAGE");
-	i.info(`Initializing SAGE Game Engine v${O}...`), i.debug("Creating rendering engine...");
-	let a = await Ke(e, {
+async function Ct(e, t, n = {}) {
+	let r = new P(n.logLevel || "debug"), i = r.getLogger("SAGE");
+	i.info(`Initializing SAGE Game Engine v${k}...`), i.debug("Creating rendering engine...");
+	let a = await Qe(e, {
 		antialias: !0,
 		adaptToDeviceRatio: !0,
 		...n.renderOptions
 	}, n.largeWorldRendering ?? !1);
 	i.debug("Creating physics engine...");
-	let o = await qe(), s = Je(o);
+	let o = await $e(), s = et(o);
 	i.debug("Creating event bus...");
-	let c = new P(r);
+	let c = new F(r);
 	i.debug("Creating scene engine...");
-	let l = new I(e, a, o, r);
+	let l = new L(e, a, o, r);
 	i.debug("Creating managers...");
-	let u = new L(c, l, r), d = new Ue(c, e, r), f = new Ce(c, r), p = new Oe(c, r, f), m = new Le(c, r), h = new ze(p, m, r), g = new we(a, c, p, d, m, r);
+	let u = new R(c, l, r), d = new Ye(c, e, r), f = new Ee(c, r), p = new Me(c, r, f), m = new He(c, r), h = new We(p, m, r), g = new Oe(a, c, p, d, m, r), _ = null;
+	n.debug !== !1 && (i.debug("Creating debug console..."), _ = new he((typeof n.debug == "object" ? n.debug.namespace : void 0) ?? "sage")), i.debug("Creating collider debug manager...");
+	let v = new Ge();
 	i.debug("Creating raycast helper...");
-	let _ = new Ye(p);
+	let y = new tt(p);
 	i.debug("Creating game timer...");
-	let v = new Xe();
-	g.registerFrameCallback((e) => v.tick(e * 1e3));
-	let y, b;
-	n.audioChannels && n.audioChannels.length > 0 && (i.debug("Creating audio engine..."), y = new F(r), await y.initialize(), i.debug("Creating audio manager..."), b = new Re(y, r), await b.initialize(n.audioChannels)), i.info(`SAGE Game Engine v${O} initialized successfully.`), i.debug("Loading entities...");
+	let b = new nt();
+	g.registerFrameCallback((e) => b.tick(e * 1e3));
+	let x, S;
+	n.audioChannels && n.audioChannels.length > 0 && (i.debug("Creating audio engine..."), x = new I(r), await x.initialize(), i.debug("Creating audio manager..."), S = new Ue(x, r), await S.initialize(n.audioChannels)), i.info(`SAGE Game Engine v${k} initialized successfully.`), i.debug("Loading entities...");
 	for (let e of t) p.registerEntityDefinition(e);
 	if (i.debug("Registering default input bindings..."), n.bindings) for (let e of n.bindings) f.registerBinding(e);
-	let x = new k(e, a, s, c, r, _, v, {
+	let C = new A(e, a, s, c, r, y, b, {
 		sceneEngine: l,
-		audioEngine: y
+		audioEngine: x
 	}, {
 		assetManager: u,
 		bindingManager: f,
@@ -3466,11 +3741,17 @@ async function pt(e, t, n = {}) {
 		inputManager: d,
 		levelManager: m,
 		saveManager: h,
-		audioManager: b
-	}, n.largeWorldRendering ?? !1);
-	return p.$setGameEngine(x), m.$setGameEngine(x), x;
+		audioManager: S
+	}, n.largeWorldRendering ?? !1, {
+		colliders: v,
+		console: _,
+		expose: (e, t) => {
+			_?.expose(e, t);
+		}
+	});
+	return p.$setGameEngine(C), m.$setGameEngine(C), _ && ot(_, C), C;
 }
 //#endregion
-export { L as AssetManager, F as AudioEngine, Re as AudioManager, A as ConsoleBackend, k as GameEngine, De as GameEntity, K as GameEntityBehavior, P as GameEventBus, Ie as GameLevel, Xe as GameTimer, Pe as Level, Ze as LogLevels, N as LoggingUtility, j as NullBackend, Fe as OutlineManager, Ye as RaycastHelper, M as SAGELogger, ze as SaveManager, I as SceneEngine, Qe as SoundBehavior, X as StateMachine, $e as StateMachineBehavior, O as VERSION, je as applyPostProcessing, R as bindingTypes, at as collectPrefixedProperties, pt as createGameEngine, Ee as generateId, V as isGamepadState, z as isKeyboardState, B as isMouseState, ft as registerAllPropertyHandlers, tt as registerColliderHandler, it as registerLodHandler, $ as registerOccluderHandler, st as registerSoundHandler, ut as registerTriggerHandler, dt as registerVisibleHandler, Me as toQuatObject, Ne as toQuaternion, q as toVec3Object, J as toVector3, me as validDeviceTypes };
+export { R as AssetManager, I as AudioEngine, Ue as AudioManager, Ge as ColliderDebugManager, j as ConsoleBackend, he as DebugConsole, A as GameEngine, je as GameEntity, G as GameEntityBehavior, F as GameEventBus, Ve as GameLevel, nt as GameTimer, ze as Level, st as LogLevels, P as LoggingUtility, M as NullBackend, Be as OutlineManager, tt as RaycastHelper, N as SAGELogger, We as SaveManager, L as SceneEngine, ct as SoundBehavior, Y as StateMachine, lt as StateMachineBehavior, k as VERSION, Fe as applyPostProcessing, z as bindingTypes, _t as collectPrefixedProperties, rt as createEntityProxy, Ct as createGameEngine, Ae as generateId, Re as getCanonicalTransform, V as isGamepadState, _e as isKeyboardState, B as isMouseState, St as registerAllPropertyHandlers, ft as registerColliderHandler, ht as registerLodHandler, gt as registerOccluderHandler, yt as registerSoundHandler, xt as registerTriggerHandler, $ as registerVisibleHandler, Ie as toQuatObject, Le as toQuaternion, K as toVec3Object, q as toVector3, ge as validDeviceTypes };
 
 //# sourceMappingURL=sage.es.js.map