@skewedaspect/sage 0.10.0 → 0.11.0

package/dist/sage.es.js

@@ -68,7 +68,7 @@ var He = class {
 			configurable: !0
 		});
 	}
-}, j = "0.10.0", Ue = class e {
+}, j = "0.11.0", Ue = class e {
 	canvas;
 	renderEngine;
 	managers;
@@ -838,6 +838,7 @@ var dt = class {
 	_containers = /* @__PURE__ */ new Map();
 	_sourceMeshes = /* @__PURE__ */ new Map();
 	_pendingContainers = /* @__PURE__ */ new Map();
+	_sceneContainers = /* @__PURE__ */ new WeakMap();
 	constructor(e, t, n) {
 		this._bus = e, this._sceneEngine = t, this._log = n?.getLogger("AssetManager") ?? new H("AssetManager");
 	}
@@ -872,6 +873,18 @@ var dt = class {
 			this._pendingContainers.delete(e);
 		}
 	}
+	_containerForScene(e, t) {
+		let n = this._sceneContainers.get(t);
+		n || (n = /* @__PURE__ */ new Map(), this._sceneContainers.set(t, n));
+		let r = n.get(e);
+		if (r) return r;
+		let i = this._sceneEngine.loadModel(e, t);
+		n.set(e, i);
+		let a = n;
+		return i.catch(() => {
+			a.delete(e);
+		}), i;
+	}
 	_findMeshInContainer(e, t, n) {
 		let r = e.meshes.find((e) => e.name === t);
 		if (!r) {
@@ -907,6 +920,16 @@ var dt = class {
 		});
 		return r.metadata = null, r;
 	}
+	async instantiate(e, t) {
+		let { basePath: n, fragment: r } = this._parsePath(e);
+		if (r) throw Error(`Cannot instantiate '${e}': the fragment '${r}' is one mesh. clone() copies one mesh.`);
+		let i = (await this._containerForScene(n, t)).instantiateModelsToScene(void 0, !1, { doNotInstantiate: !0 });
+		for (let e of i.rootNodes) {
+			e.metadata = null;
+			for (let t of e.getDescendants()) t.metadata = null;
+		}
+		return i;
+	}
 	async preload(e) {
 		let t = e.length, n = [], r = 0, i = 0, a = async () => {
 			for (; r < e.length;) {
@@ -1408,7 +1431,26 @@ function Mt(e) {
 function Nt(e, t) {
 	return Math.abs(e) > jt || Math.abs(t) > jt;
 }
-var Pt = class {
+var Pt = /* @__PURE__ */ new Set([
+	"button",
+	"checkbox",
+	"color",
+	"file",
+	"hidden",
+	"image",
+	"radio",
+	"range",
+	"reset",
+	"submit"
+]);
+function Ft(e) {
+	if (!(e instanceof Element)) return !1;
+	if (e instanceof HTMLTextAreaElement) return !0;
+	if (e instanceof HTMLInputElement) return !Pt.has(e.type);
+	let t = e.closest("[contenteditable]");
+	return t !== null && t.getAttribute("contenteditable") !== "false";
+}
+var It = class {
 	actions = new gt();
 	contexts;
 	#e = {};
@@ -1441,7 +1483,7 @@ var Pt = class {
 	#_;
 	constructor(e) {
 		this.contexts = new ht(e), this.#f = (e) => {
-			this.#v("keyboard", "key", e.code) && e.preventDefault(), this.#e[e.code] = !0, this.#E("keyboard"), this.#k({
+			Ft(e.composedPath()[0]) || (this.#v("keyboard", "key", e.code) && e.preventDefault(), this.#e[e.code] = !0, this.#E("keyboard"), this.#k({
 				device: {
 					type: "keyboard",
 					index: 0
@@ -1449,7 +1491,7 @@ var Pt = class {
 				sourceType: "key",
 				sourceKey: e.code,
 				value: !0
-			});
+			}));
 		}, this.#p = (e) => {
 			this.#e[e.code] = !1;
 		}, this.#m = (e) => {
@@ -1650,18 +1692,18 @@ var Pt = class {
 	#k(e) {
 		for (let t of this.#o) t.feed(e);
 	}
-}, Ft = {
+}, Lt = {
 	hable: g.TONEMAPPING_STANDARD,
 	reinhard: g.TONEMAPPING_STANDARD,
 	hejidawson: g.TONEMAPPING_STANDARD,
 	photographic: g.TONEMAPPING_STANDARD,
 	aces: g.TONEMAPPING_ACES
 };
-function It(e, t, n) {
+function Rt(e, t, n) {
 	if (!e.activeCamera) return;
 	t.volumetric && n.warn("Volumetric lighting is recognized and applied by neither backend. Ignored.");
 	let r = new c("sage-default", !0, e, e.cameras);
-	if (t.bloom && (r.bloomEnabled = !0, t.bloom.weight !== void 0 && (r.bloomWeight = t.bloom.weight), t.bloom.threshold !== void 0 && (r.bloomThreshold = t.bloom.threshold), t.bloom.scale !== void 0 && (r.bloomScale = t.bloom.scale), t.bloom.kernel !== void 0 && (r.bloomKernel = t.bloom.kernel)), t.tonemap && (r.imageProcessingEnabled = !0, r.imageProcessing.toneMappingEnabled = !0, t.tonemap.operator && (r.imageProcessing.toneMappingType = Ft[t.tonemap.operator] ?? g.TONEMAPPING_STANDARD)), t.grain && (r.grainEnabled = !0, t.grain.intensity !== void 0 && (r.grain.intensity = t.grain.intensity), t.grain.animated !== void 0 && (r.grain.animated = t.grain.animated)), t.vignette && (r.imageProcessingEnabled = !0, r.imageProcessing.vignetteEnabled = !0, t.vignette.weight !== void 0 && (r.imageProcessing.vignetteWeight = t.vignette.weight), t.vignette.stretch !== void 0 && (r.imageProcessing.vignetteStretch = t.vignette.stretch), t.vignette.color && (r.imageProcessing.vignetteColor = new a(t.vignette.color.r, t.vignette.color.g, t.vignette.color.b, 1))), t.sharpen && (r.sharpenEnabled = !0, t.sharpen.edge !== void 0 && (r.sharpen.edgeAmount = t.sharpen.edge), t.sharpen.color !== void 0 && (r.sharpen.colorAmount = t.sharpen.color)), t.chromaticAberration && (r.chromaticAberrationEnabled = !0, t.chromaticAberration.amount !== void 0 && (r.chromaticAberration.aberrationAmount = t.chromaticAberration.amount)), t.ssao) {
+	if (t.bloom && (r.bloomEnabled = !0, t.bloom.weight !== void 0 && (r.bloomWeight = t.bloom.weight), t.bloom.threshold !== void 0 && (r.bloomThreshold = t.bloom.threshold), t.bloom.scale !== void 0 && (r.bloomScale = t.bloom.scale), t.bloom.kernel !== void 0 && (r.bloomKernel = t.bloom.kernel)), t.tonemap && (r.imageProcessingEnabled = !0, r.imageProcessing.toneMappingEnabled = !0, t.tonemap.operator && (r.imageProcessing.toneMappingType = Lt[t.tonemap.operator] ?? g.TONEMAPPING_STANDARD)), t.grain && (r.grainEnabled = !0, t.grain.intensity !== void 0 && (r.grain.intensity = t.grain.intensity), t.grain.animated !== void 0 && (r.grain.animated = t.grain.animated)), t.vignette && (r.imageProcessingEnabled = !0, r.imageProcessing.vignetteEnabled = !0, t.vignette.weight !== void 0 && (r.imageProcessing.vignetteWeight = t.vignette.weight), t.vignette.stretch !== void 0 && (r.imageProcessing.vignetteStretch = t.vignette.stretch), t.vignette.color && (r.imageProcessing.vignetteColor = new a(t.vignette.color.r, t.vignette.color.g, t.vignette.color.b, 1))), t.sharpen && (r.sharpenEnabled = !0, t.sharpen.edge !== void 0 && (r.sharpen.edgeAmount = t.sharpen.edge), t.sharpen.color !== void 0 && (r.sharpen.colorAmount = t.sharpen.color)), t.chromaticAberration && (r.chromaticAberrationEnabled = !0, t.chromaticAberration.amount !== void 0 && (r.chromaticAberration.aberrationAmount = t.chromaticAberration.amount)), t.ssao) {
 		let n = new fe("sage-ssao", e, {
 			ssaoRatio: .5,
 			blurRatio: 1
@@ -1671,11 +1713,11 @@ function It(e, t, n) {
 }
 //#endregion
 //#region src/handlers/postProcessing.ts
-async function Lt(e, t, n) {
+async function zt(e, t, n) {
 	if (t.renderer === "frameGraph") {
 		let { applyFrameGraphPostProcessing: r } = await import("./postProcessingFrameGraph-Dx3e6D33.js");
 		await r(e, t, n);
-	} else It(e, t, n);
+	} else Rt(e, t, n);
 }
 //#endregion
 //#region src/utils/bounds.ts
@@ -1688,22 +1730,22 @@ function J(e) {
 }
 //#endregion
 //#region src/handlers/collider.ts
-var Y = 1, Rt = [
+var Y = 1, Bt = [
 	"box",
 	"sphere",
 	"mesh",
 	"none"
 ];
-function zt(e, t, n) {
-	for (let e of Rt) if (t === e) return e;
-	n.warn(`Unusable collider on "${e.name}": ${JSON.stringify(t)}. The collider property takes ${Rt.join(", ")}. Building nothing.`);
+function Vt(e, t, n) {
+	for (let e of Bt) if (t === e) return e;
+	n.warn(`Unusable collider on "${e.name}": ${JSON.stringify(t)}. The collider property takes ${Bt.join(", ")}. Building nothing.`);
 }
-function Bt(e, t) {
+function Ht(e, t) {
 	let n = e.metadata?.collider_mass;
 	return n == null ? Y : typeof n != "number" || !Number.isFinite(n) ? (t.warn(`Unusable collider_mass on ${e.name}: ${JSON.stringify(n)}. Using the default of ${Y}.`), Y) : n;
 }
-function Vt(e, t) {
-	let n = Bt(e, t), r = e.metadata?.collider_motion;
+function Ut(e, t) {
+	let n = Ht(e, t), r = e.metadata?.collider_motion;
 	return r === "dynamic" ? {
 		type: S.DYNAMIC,
 		mass: n
@@ -1715,10 +1757,10 @@ function Vt(e, t) {
 		mass: n
 	});
 }
-function Ht(e) {
+function Wt(e) {
 	return e instanceof y && e.getTotalVertices() > 0;
 }
-function Ut(e) {
+function Gt(e) {
 	for (let t of e.getChildMeshes(!1)) if (t.getTotalVertices() > 0) return !0;
 	return !1;
 }
@@ -1735,35 +1777,35 @@ function X(e, t, n, r) {
 	let o = new x(e, t, a, e.getScene());
 	o.body.setMotionType(n.type), n.type === S.ANIMATED && o.body.setPrestepType(C.TELEPORT);
 }
-function Wt(e, t, n) {
-	if (Ht(e)) {
+function Kt(e, t, n) {
+	if (Wt(e)) {
 		X(e, t, n, void 0);
 		return;
 	}
-	if (!Ut(e)) throw Error(`Cannot build a collider on "${e.name}": it has neither a mesh nor anything under it to size a body from.`);
+	if (!Gt(e)) throw Error(`Cannot build a collider on "${e.name}": it has neither a mesh nor anything under it to size a body from.`);
 	X(e, t, n, J(e));
 }
-function Gt(e, t) {
+function qt(e, t) {
 	let n = e;
 	for (let t of e.getChildMeshes(!1)) if (t.metadata?.collider_mesh === !0 && t instanceof y) {
 		t.isVisible = !1, n = t;
 		break;
 	}
-	if (!Ht(n)) throw Error(`Cannot build a "mesh" collider on "${n.name}": a triangle mesh reads vertices, and this node has none of its own.`);
+	if (!Wt(n)) throw Error(`Cannot build a "mesh" collider on "${n.name}": a triangle mesh reads vertices, and this node has none of its own.`);
 	X(n, w.MESH, t, void 0);
 }
-function Kt(e) {
+function Jt(e) {
 	e.registerPropertyHandler("collider", (e, t, n, r) => {
 		if (!n.scene) throw Error("Scene not available for collider handler");
-		let i = zt(e, t, r.logger);
+		let i = Vt(e, t, r.logger);
 		if (i === void 0 || i === "none") return;
-		let a = Vt(e, r.logger);
-		i === "mesh" ? Gt(e, a) : i === "sphere" ? Wt(e, w.SPHERE, a) : Wt(e, w.BOX, a);
+		let a = Ut(e, r.logger);
+		i === "mesh" ? qt(e, a) : i === "sphere" ? Kt(e, w.SPHERE, a) : Kt(e, w.BOX, a);
 	});
 }
 //#endregion
 //#region src/handlers/lod.ts
-function qt(e) {
+function Yt(e) {
 	let t = [];
 	for (let n of e.split(",")) {
 		let e = parseFloat(n.trim());
@@ -1771,10 +1813,10 @@ function qt(e) {
 	}
 	return t;
 }
-function Jt(e) {
+function Xt(e) {
 	e.registerPropertyHandler("lod_distances", (e, t, n, r) => {
 		if (!(e instanceof y)) return;
-		let i = qt(String(t));
+		let i = Yt(String(t));
 		if (i.length === 0) {
 			r.logger.warn(`Unusable lod_distances on "${e.name}": ${JSON.stringify(t)}. No level added.`);
 			return;
@@ -1789,14 +1831,14 @@ function Jt(e) {
 }
 //#endregion
 //#region src/handlers/occlusion.ts
-function Yt(e) {
+function Zt(e) {
 	e.registerPropertyHandler("occlusion", (e, t, n, r) => {
 		e instanceof y && (t === "optimistic" ? e.occlusionType = y.OCCLUSION_TYPE_OPTIMISTIC : t === "strict" ? e.occlusionType = y.OCCLUSION_TYPE_STRICT : r.logger.warn(`Unknown occlusion on "${e.name}": ${JSON.stringify(t)}. The occlusion property takes "optimistic" or "strict".`));
 	});
 }
 //#endregion
 //#region src/utils/metadata.ts
-function Xt(e, t) {
+function Qt(e, t) {
 	let n = {}, r = `${t}_`;
 	for (let [t, i] of Object.entries(e)) if (t.startsWith(r)) {
 		let e = t.slice(r.length);
@@ -1806,11 +1848,11 @@ function Xt(e, t) {
 }
 //#endregion
 //#region src/handlers/sound.ts
-function Zt(e) {
+function $t(e) {
 	e.registerPropertyHandler("sound", async (e, t, n, r) => {
 		let i = t;
 		if (!n.scene) throw Error("Scene not available for sound handler");
-		let a = Xt(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.audioManager;
+		let a = Qt(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.audioManager;
 		if (!f) {
 			r.logger.warn(`No AudioManager available. Sound for "${e.name}" skipped.`);
 			return;
@@ -1828,7 +1870,7 @@ function Zt(e) {
 }
 //#endregion
 //#region src/handlers/trigger.ts
-function Qt(e, n, r, i, a) {
+function en(e, n, r, i, a) {
 	let o = t.OnIntersectionExitTrigger;
 	a === "enter" && (o = t.OnIntersectionEnterTrigger);
 	let s = `trigger:${a}`;
@@ -1846,7 +1888,7 @@ function Qt(e, n, r, i, a) {
 		});
 	}));
 }
-function $t(n) {
+function tn(n) {
 	n.registerPropertyHandler("trigger", (n, r, i, a) => {
 		let o = r, s = i.scene;
 		if (!s) throw Error("Scene not available for trigger handler");
@@ -1860,7 +1902,7 @@ function $t(n) {
 			if (e === n || e.metadata?.trigger) return;
 			let t = [];
 			for (let n of ["enter", "exit"]) {
-				let r = Qt(u, o, c, e, n);
+				let r = en(u, o, c, e, n);
 				r && t.push(r);
 			}
 			let r = e.onDisposeObservable.add(() => {
@@ -1880,7 +1922,7 @@ function $t(n) {
 }
 //#endregion
 //#region src/handlers/visible.ts
-function en(t) {
+function nn(t) {
 	t.registerPropertyHandler("visible", (t, n) => {
 		if (!(t instanceof e)) return;
 		let r = !0;
@@ -1889,7 +1931,7 @@ function en(t) {
 }
 //#endregion
 //#region src/handlers/index.ts
-var tn = [
+var rn = [
 	"collider",
 	"lod_distances",
 	"occlusion",
@@ -1897,12 +1939,12 @@ var tn = [
 	"trigger",
 	"visible"
 ];
-function nn(e) {
-	Kt(e), Jt(e), Yt(e), Zt(e), $t(e), en(e);
+function an(e) {
+	Jt(e), Xt(e), Zt(e), $t(e), tn(e), nn(e);
 }
 //#endregion
 //#region src/classes/level.ts
-var rn = class {
+var on = class {
 	name;
 	_log;
 	_context;
@@ -2002,7 +2044,7 @@ var rn = class {
 	async dispose() {
 		this._scene &&= (this._log.info(`Disposing level: ${this.name}`), this.outlines &&= (this.outlines.dispose(), null), this.clusteredLights &&= (this.clusteredLights.dispose(), null), this._scene.dispose(), null);
 	}
-}, an = class {
+}, sn = class {
 	_scene;
 	_layers = /* @__PURE__ */ new Map();
 	constructor(e, t) {
@@ -2046,7 +2088,7 @@ var rn = class {
 			n.length > 0 && e.layer.addSelection(n);
 		}
 	}
-}, on = class extends rn {
+}, cn = class extends on {
 	_config;
 	_spawnPoints = [];
 	_entityNodes = [];
@@ -2077,9 +2119,9 @@ var rn = class {
 		let n = e.createScene();
 		if (this._scene = n, this.rebuildSimulation(n, this._config.meshSource), 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 Lt(n, this._config.postProcessing, this._log);
+			this._log.info(`Applying post-processing with ${e} renderer`), await zt(n, this._config.postProcessing, this._log);
 		}
-		return this.outlines = new an(n, this._config.outlines), this.$emitProgress(50, "Processing scene properties..."), await this._processNodeProperties(n), this._forRestore || (this.$emitProgress(70, "Spawning entities..."), await this._processSpawnPoints(), this.$emitProgress(85, "Configuring entities..."), this._processEntityNodes()), this._config.sounds && (this.$emitProgress(95, "Loading sounds..."), await this._processLevelSounds()), n;
+		return this.outlines = new sn(n, this._config.outlines), this.$emitProgress(50, "Processing scene properties..."), await this._processNodeProperties(n), this._forRestore || (this.$emitProgress(70, "Spawning entities..."), await this._processSpawnPoints(), this.$emitProgress(85, "Configuring entities..."), this._processEntityNodes()), this._config.sounds && (this.$emitProgress(95, "Loading sounds..."), await this._processLevelSounds()), n;
 	}
 	async _loadSceneFile(e) {
 		let t = this._getScenePath();
@@ -2255,7 +2297,7 @@ var rn = class {
 	}
 	_warnUnhandledProperties(e) {
 		let t = e.metadata;
-		for (let n of tn) n in t && !this.propertyHandlers.has(n) && this._log.warn(`Node '${e.name}' carries '${n}' and no handler is registered for it. Call registerAllPropertyHandlers on the level manager to install the built-in handlers.`);
+		for (let n of rn) n in t && !this.propertyHandlers.has(n) && this._log.warn(`Node '${e.name}' carries '${n}' and no handler is registered for it. Call registerAllPropertyHandlers on the level manager to install the built-in handlers.`);
 	}
 	async _processNodeMetadata(e) {
 		if ("spawn" in e.metadata) {
@@ -2352,7 +2394,7 @@ var rn = class {
 		for (let e of this._levelSounds.values()) e.dispose();
 		this._levelSounds.clear(), this._playingSoundsBeforeDeactivate.clear(), await super.dispose();
 	}
-}, sn = class {
+}, ln = class {
 	_bus;
 	_gameEngine = null;
 	_log;
@@ -2402,7 +2444,10 @@ var rn = class {
 			sceneEngine: t.engines.sceneEngine,
 			assetManager: t.managers.assetManager,
 			audioManager: t.managers.audioManager,
-			rebuildSimulation: (n, r) => t.rebuildSimulation(n, e.name, r),
+			rebuildSimulation: (n, r) => t.rebuildSimulation(n, e.name, {
+				meshSource: r,
+				fixedStepDuration: e.fixedStepDuration
+			}),
 			canvas: t.canvas,
 			largeWorldRendering: t.largeWorldRendering,
 			propertyHandlers: this._propertyHandlers,
@@ -2416,7 +2461,7 @@ var rn = 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 on(e, t);
+		return this._log.debug(`Creating level '${e.name}' using GameLevel`), new cn(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}`);
@@ -2525,7 +2570,7 @@ var rn = class {
 		for (let e of this._loadedLevels.values()) await e.dispose();
 		this._loadedLevels.clear(), this._levelConfigs.clear(), this._currentLevel = null;
 	}
-}, cn = class {
+}, un = class {
 	#e;
 	#t = /* @__PURE__ */ new Map();
 	#n = !1;
@@ -2594,7 +2639,7 @@ var rn = class {
 		if (!t) throw Error(`AudioManager: no channel named "${e}" is declared.`);
 		return t;
 	}
-}, ln = 1, un = class {
+}, dn = 2, fn = class {
 	#e;
 	#t;
 	#n;
@@ -2619,7 +2664,7 @@ var rn = class {
 			t[n] = r;
 		}
 		return {
-			saveFormatVersion: ln,
+			saveFormatVersion: dn,
 			engineVersion: this.#t,
 			level: this.#e.currentLevel?.name ?? "",
 			timestamp: this.#n(),
@@ -2628,7 +2673,7 @@ var rn = class {
 		};
 	}
 	async load(e) {
-		if (e.saveFormatVersion !== ln) throw Error(`The save format version "${e.saveFormatVersion}" is not one this engine knows how to load.`);
+		if (e.saveFormatVersion !== dn) throw Error(`The save format version "${e.saveFormatVersion}" is not one this engine knows how to load.`);
 		this.#a(), await this.#e.transition(e.level, { forRestore: !0 });
 		let t = this.#o().buildFromSnapshot(e.snapshot);
 		return this.#e.$bindSimulation(t), {
@@ -2648,7 +2693,7 @@ var rn = class {
 		if (e === null) throw Error("SimulationSaveManager: the engine holds no simulation.");
 		return e;
 	}
-}, dn = class {
+}, pn = class {
 	_viewer = null;
 	_shown = /* @__PURE__ */ new Map();
 	_materials = /* @__PURE__ */ new Map();
@@ -2687,21 +2732,21 @@ var rn = class {
 };
 //#endregion
 //#region src/utils/graphics.ts
-async function fn() {
+async function mn() {
 	return Ve() ? be.IsSupportedAsync : !1;
 }
-async function pn(e, t) {
+async function hn(e, t) {
 	let n = new be(e, t);
 	return await n.initAsync(), n;
 }
-function mn(e, t) {
+function gn(e, t) {
 	return new u(e, t.antialias, t.options, t.adaptToDeviceRatio);
 }
-function hn(e) {
+function _n(e) {
 	return new te(e);
 }
-async function gn(e, t, n = !1, r = new H("Boot")) {
-	if (e === null) return r.debug("Using Null Engine"), hn(t);
+async function vn(e, t, n = !1, r = new H("Boot")) {
+	if (e === null) return r.debug("Using Null Engine"), _n(t);
 	if (n) {
 		if ("options" in t) {
 			let e = t;
@@ -2719,25 +2764,25 @@ async function gn(e, t, n = !1, r = new H("Boot")) {
 	}
 	let i = t.engine || "auto";
 	if (i === "webgpu") {
-		if (await fn()) try {
-			return r.debug("Using forced WebGPU engine"), await pn(e, t);
+		if (await mn()) try {
+			return r.debug("Using forced WebGPU engine"), await hn(e, t);
 		} catch (e) {
 			throw r.error("Forced WebGPU initialization failed:", e), Error("Forced WebGPU failed to initialize. If WebGPU is required, check browser compatibility.", { cause: e });
 		}
 		throw Error("WebGPU was forced but is not available in this browser.");
 	}
-	if (i === "webgl") return r.debug("Using forced WebGL engine"), mn(e, t);
-	if (await fn()) try {
-		return r.debug("Using WebGPU"), await pn(e, t);
+	if (i === "webgl") return r.debug("Using forced WebGL engine"), gn(e, t);
+	if (await mn()) try {
+		return r.debug("Using WebGPU"), await hn(e, t);
 	} catch (e) {
 		r.warn("WebGPU initialization failed, falling back to WebGL:", e);
 	}
 	else r.warn("WebGPU not supported, falling back to WebGL.");
-	return r.debug("Using WebGL"), mn(e, t);
+	return r.debug("Using WebGL"), gn(e, t);
 }
 //#endregion
 //#region src/utils/timer.ts
-var _n = class {
+var yn = class {
 	_nextId = 0;
 	_delays = [];
 	_intervals = [];
@@ -2801,17 +2846,17 @@ function Z(e) {
 	}
 	return e.simulation;
 }
-function vn(e, t) {
+function bn(e, t) {
 	return typeof e == "string" ? Z(t)?.getEntity(e) : e;
 }
-function yn(e, t) {
+function xn(e, t) {
 	let n = t.managers.gameManager, r = t.managers.levelManager, i = [];
 	e.expose("engine", t), e.expose("events", t.bus), e.expose("physics", { get: () => r.currentLevel?.scene?.getPhysicsEngine() ?? null }), e.expose("colliders", t.debug.colliders), e.expose("entities", new Proxy({}, { get(e, n) {
 		if (typeof n == "symbol") return;
 		let r = Z(t)?.getEntity(n);
 		return r || console.warn(`[sage] Entity not found: ${n}`), r;
 	} })), e.expose("level", { get: () => r.currentLevel }), e.expose("scene", { get: () => r.currentLevel?.scene ?? null }), e.expose("tp", (e, n, r, i) => {
-		let a = vn(e, t);
+		let a = bn(e, t);
 		if (!a) {
 			console.warn(`[sage] Entity not found: ${e}`);
 			return;
@@ -2852,7 +2897,7 @@ function yn(e, t) {
 		});
 		return console.table(a), [...i];
 	}), e.expose("inspect", (e) => {
-		let n = vn(e, t);
+		let n = bn(e, t);
 		if (!n) {
 			console.warn(`[sage] Entity not found: ${e}`);
 			return;
@@ -2885,7 +2930,7 @@ function yn(e, t) {
 }
 //#endregion
 //#region src/interfaces/logger.ts
-var bn = [
+var Sn = [
 	"trace",
 	"debug",
 	"info",
@@ -2895,7 +2940,7 @@ var bn = [
 ];
 //#endregion
 //#region src/entities/defineEntity.ts
-function xn(e, t) {
+function Cn(e, t) {
 	let n = t ?? {}, r = e.tags ?? [], i = n.tags ?? [];
 	return {
 		...e.defaultState,
@@ -2903,13 +2948,13 @@ function xn(e, t) {
 		tags: [.../* @__PURE__ */ new Set([...r, ...i])]
 	};
 }
-function Sn(e) {
+function wn(e) {
 	class t extends B {
 		static behaviors = e.behaviors;
 		static meshConfig = e.mesh;
 		static actions = e.actions;
 		static create(t, n, r, i) {
-			let a = xn(e, r);
+			let a = Cn(e, r);
 			return super.create(t, n, a, i);
 		}
 	}
@@ -2920,12 +2965,12 @@ function Sn(e) {
 function Q(e) {
 	return new i(e.r, e.g, e.b);
 }
-function Cn(e, t, n) {
+function Tn(e, t, n) {
 	let r = `Create${t.charAt(0).toUpperCase()}${t.slice(1)}`, i = b[r];
 	if (typeof i != "function") throw Error(`No Babylon mesh builder provides the primitive shape "${t}".`);
 	return i(t, n ?? {}, e);
 }
-function wn(e, t, n) {
+function En(e, t, n) {
 	if (n.type === "pbr") {
 		let r = new ne(`${t.name}-material`, e);
 		n.color !== void 0 && (r.albedoColor = Q(n.color)), n.emissive !== void 0 && (r.emissiveColor = Q(n.emissive)), n.metallic !== void 0 && (r.metallic = n.metallic), n.roughness !== void 0 && (r.roughness = n.roughness), t.material = r;
@@ -2934,19 +2979,19 @@ function wn(e, t, n) {
 		n.color !== void 0 && (r.diffuseColor = Q(n.color)), n.emissive !== void 0 && (r.emissiveColor = Q(n.emissive)), t.material = r;
 	}
 }
-async function Tn(e, t, n) {
+async function Dn(e, t, n) {
 	let r;
-	return t.source.includes("#") ? (await n.load(t.source), r = n.clone(t.source, e)) : r = Cn(e, t.source, t.params), r.isVisible = t.visible ?? !0, t.material !== void 0 && wn(e, r, t.material), r;
+	return t.source.includes("#") ? (await n.load(t.source), r = n.clone(t.source, e)) : r = Tn(e, t.source, t.params), r.isVisible = t.visible ?? !0, t.material !== void 0 && En(e, r, t.material), r;
 }
-function En(e, t) {
+function On(e, t) {
 	return async (n, r) => {
 		let i = e[r]?.meshConfig;
-		if (i !== void 0) return Tn(n, i, t);
+		if (i !== void 0) return Dn(n, i, t);
 	};
 }
 //#endregion
 //#region src/behaviors/sound.ts
-var Dn = class extends k {
+var kn = class extends k {
 	static ops = ["play", "stop"];
 	defaults = { sounds: {} };
 	#e = /* @__PURE__ */ new Map();
@@ -2988,10 +3033,10 @@ var Dn = class extends k {
 };
 //#endregion
 //#region src/behaviors/physicsBody.ts
-function On(e) {
+function An(e) {
 	return e === "sphere" ? w.SPHERE : e === "cylinder" ? w.CYLINDER : e === "convex" ? w.CONVEX_HULL : e === "mesh" ? w.MESH : w.BOX;
 }
-function kn(e, t) {
+function jn(e, t) {
 	let { extents: n, center: r } = t;
 	return e === "sphere" ? {
 		radius: Math.max(n.x, n.y, n.z) / 2,
@@ -3005,7 +3050,7 @@ function kn(e, t) {
 		center: r
 	};
 }
-function An(e, t) {
+function Mn(e, t) {
 	let { extents: n } = e;
 	if (e.shape === "sphere") return new ce(O.Zero(), n.x / 2, t);
 	if (e.shape === "cylinder") {
@@ -3017,17 +3062,17 @@ function An(e, t) {
 function $(e) {
 	return e === "static" ? S.STATIC : e === "kinematic" ? S.ANIMATED : S.DYNAMIC;
 }
-function jn(e) {
+function Nn(e) {
 	return e === S.STATIC ? "static" : e === S.ANIMATED ? "kinematic" : "dynamic";
 }
-function Mn(e) {
+function Pn(e) {
 	return e === "kinematic" ? C.ACTION : C.TELEPORT;
 }
-function Nn(e) {
+function Fn(e) {
 	for (let t of e.getChildMeshes(!1)) if (t.getTotalVertices() > 0) return !0;
 	return !1;
 }
-var Pn = class extends k {
+var In = class extends k {
 	static ops = ["applyImpulse"];
 	defaults = {
 		shape: "box",
@@ -3088,13 +3133,13 @@ var Pn = class extends k {
 		if (r === "convex" || r === "mesh") {
 			let a = e.mesh;
 			if (!(a instanceof y) || a.getTotalVertices() === 0) throw Error(`HavokPhysicsBodyBehavior: entity "${e.id}" asked for a "${r}" body, which reads vertices, and it has no mesh geometry to read.`);
-			return new x(n, On(r), {
+			return new x(n, An(r), {
 				mass: i,
 				mesh: a
 			}, t);
 		}
-		let a = kn(r, this.#s(e));
-		return new x(n, On(r), {
+		let a = jn(r, this.#s(e));
+		return new x(n, An(r), {
 			mass: i,
 			...a
 		}, t);
@@ -3108,13 +3153,13 @@ var Pn = class extends k {
 				center: e.center.clone()
 			};
 		}
-		if (!Nn(e.node)) throw Error(`HavokPhysicsBodyBehavior: entity "${e.id}" has neither a mesh nor anything under its node to size a body from.`);
+		if (!Fn(e.node)) throw Error(`HavokPhysicsBodyBehavior: entity "${e.id}" has neither a mesh nor anything under its node to size a body from.`);
 		return J(e.node);
 	}
 	#c(e) {
 		let t = new oe(e);
 		for (let n of this.state.parts) {
-			let r = An(n, e);
+			let r = Mn(n, e);
 			t.addChild(r, N(n.position), F(n.rotation)), this.#a.push(r);
 		}
 		return this.#a.push(t), t;
@@ -3149,7 +3194,7 @@ var Pn = class extends k {
 			get: () => s,
 			set: r
 		}), this.computed("motion", {
-			get: () => this.#n ? jn(this.#r) : jn(this.#y().getMotionType()),
+			get: () => this.#n ? Nn(this.#r) : Nn(this.#y().getMotionType()),
 			set: (e) => {
 				if (this.#n) {
 					this.#r = $(e);
@@ -3187,7 +3232,7 @@ var Pn = class extends k {
 	}
 	#d(e, t) {
 		let n = this.#y(), r = n.transformNode;
-		r.position = N(e), r.rotationQuaternion = F(t), !this.#n && (n.setPrestepType(Mn(jn(n.getMotionType()))), this.#b().setPhysicsBodyTransformation(n, r), n.setPrestepType(C.DISABLED));
+		r.position = N(e), r.rotationQuaternion = F(t), !this.#n && (n.setPrestepType(Pn(Nn(n.getMotionType()))), this.#b().setPhysicsBodyTransformation(n, r), n.setPrestepType(C.DISABLED));
 	}
 	#f(e) {
 		if (e !== this.#n) {
@@ -3240,12 +3285,12 @@ var Pn = class extends k {
 		if (this.#t === void 0) throw Error(`HavokPhysicsBodyBehavior: entity "${this.entity.id}" has no physics plugin to answer for.`);
 		return this.#t;
 	}
-}, Fn = new O(0, -1, 0), In = "standing";
-function Ln(e) {
+}, Ln = new O(0, -1, 0), Rn = "standing";
+function zn(e) {
 	let t = Object.keys(e);
 	return t.sort((t, n) => e[n].height - e[t].height), t;
 }
-var Rn = class extends k {
+var Bn = class extends k {
 	defaults = {
 		moveX: 0,
 		moveZ: 0,
@@ -3280,7 +3325,7 @@ var Rn = class extends k {
 			z: 0
 		},
 		grounded: !1,
-		stance: In
+		stance: Rn
 	};
 	#e;
 	#t;
@@ -3290,7 +3335,7 @@ var Rn = class extends k {
 	#a = /* @__PURE__ */ new Map();
 	#o = W();
 	#s = !1;
-	#c = In;
+	#c = Rn;
 	#l = !1;
 	#u;
 	#d = O.Zero();
@@ -3310,7 +3355,7 @@ var Rn = class extends k {
 	onUpdate(e) {
 		let t = this.#e;
 		if (t === void 0) return;
-		let n = t.checkSupport(e, Fn);
+		let n = t.checkSupport(e, Ln);
 		this.#l = n.supportedState === r.SUPPORTED, this.#l ? this.#h = 0 : this.#h += 1, this.#S(), this.#u = this.#O(), this.#E().y <= 0 && (this.#g = !1);
 		let i = this.desiredVelocity(e, n);
 		this.#w(n) && (this.#g = !0, i.y = this.state.jumpSpeed), this.#d = this.#D(), i.addInPlace(this.#d), t.setVelocity(i), t.integrate(e, n, this.#o), this.entity.node.setAbsolutePosition(this.#B(t.getPosition())), this.state.velocity = M(t.getVelocity());
@@ -3356,7 +3401,7 @@ var Rn = class extends k {
 		this.#v(this.state.wantsStance);
 		let e = this.#c;
 		if (this.stanceFits(this.state.wantsStance)) e = this.state.wantsStance;
-		else for (let t of Ln(this.state.stances)) if (this.#_(this.state.stances[t]) && this.stanceFits(t)) {
+		else for (let t of zn(this.state.stances)) if (this.#_(this.state.stances[t]) && this.stanceFits(t)) {
 			e = t;
 			break;
 		}
@@ -3454,7 +3499,7 @@ var Rn = class extends k {
 		return t;
 	}
 	#R() {
-		let e = Ln(this.state.stances);
+		let e = zn(this.state.stances);
 		if (e.length === 0) throw Error(`CharacterControllerBehavior: entity "${this.entity.id}" has no stances to be in, and a character is always in one.`);
 		return e[0];
 	}
@@ -3472,7 +3517,7 @@ var Rn = class extends k {
 		if (this.#e === void 0) throw Error(`CharacterControllerBehavior: entity "${this.entity.id}" has no capsule to answer for.`);
 		return this.#e;
 	}
-}, zn = class {
+}, Vn = class {
 	#e;
 	#t;
 	#n;
@@ -3500,26 +3545,27 @@ var Rn = class extends k {
 };
 //#endregion
 //#region src/input/configuration.ts
-function Bn(e, t, n) {
+function Hn(e, t, n) {
 	return {
 		actions: [...e],
 		bindings: t.map((e) => e.toDefinition()),
 		contexts: [...n]
 	};
 }
-function Vn(e, t, n) {
+function Un(e, t, n) {
 	for (let n of e.actions) t.register(n);
 	for (let t of e.contexts) n.registerContext(t.name, t.exclusive);
 	return [...e.bindings];
 }
 //#endregion
 //#region src/sage.ts
-async function Hn(e, t, n = {}) {
+async function Wn(e, t, n = {}) {
 	let r = new U(n.logLevel || "debug"), i = r.getLogger("SAGE");
 	i.info(`Initializing SAGE Game Engine v${j}...`), i.debug("Creating rendering engine...");
-	let a = await gn(e, {
+	let a = await vn(e, {
 		antialias: !0,
 		adaptToDeviceRatio: !0,
+		enableAllFeatures: !0,
 		...n.renderOptions
 	}, n.largeWorldRendering ?? !1, i);
 	i.debug("Creating event bus...");
@@ -3527,20 +3573,20 @@ async function Hn(e, t, n = {}) {
 	i.debug("Creating scene engine...");
 	let s = new dt(a, r, n.havokBinary);
 	i.debug("Creating managers...");
-	let c = new pt(o, s, r), l = new sn(o, r), u = new un(l, j), d = new mt(a, o, l, r), f = new Pt(r);
+	let c = new pt(o, s, r), l = new ln(o, r), u = new fn(l, j), d = new mt(a, o, l, r), f = new It(r);
 	d.setInputManager(f);
 	let p, m;
-	n.audioChannels && n.audioChannels.length > 0 && (i.debug("Creating audio engine..."), p = new lt(r), await p.initialize(), i.debug("Creating audio manager..."), m = new cn(p, r), await m.initialize(n.audioChannels));
+	n.audioChannels && n.audioChannels.length > 0 && (i.debug("Creating audio engine..."), p = new lt(r), await p.initialize(), i.debug("Creating audio manager..."), m = new un(p, r), await m.initialize(n.audioChannels));
 	let h = n.fixedStepDuration ?? 1 / 60, g = async () => void 0;
 	i.debug("Creating collider debug manager...");
-	let _ = new dn(), ee = (e, n, i) => new ot({
+	let _ = new pn(), ee = (e, n, i) => new ot({
 		id: n,
 		bus: o,
-		fixedStepDuration: h,
+		fixedStepDuration: i?.fixedStepDuration ?? h,
 		entityClasses: t,
 		scene: e,
 		pool: new ct(),
-		loadMesh: i ?? g,
+		loadMesh: i?.meshSource ?? g,
 		audio: m,
 		colliders: _,
 		logger: r.getLogger("NodeSimulation")
@@ -3551,7 +3597,7 @@ async function Hn(e, t, n = {}) {
 		typeof n.debug == "object" && n.debug.namespace !== void 0 && (e = n.debug.namespace), v = new He(e);
 	}
 	i.debug("Creating game timer...");
-	let y = new _n();
+	let y = new yn();
 	d.registerFrameCallback((e) => y.tick(e * 1e3)), i.info(`SAGE Game Engine v${j} initialized successfully.`);
 	let b = new Ue(e, a, o, r, y, ee, {
 		sceneEngine: s,
@@ -3570,9 +3616,9 @@ async function Hn(e, t, n = {}) {
 			v?.expose(e, t);
 		}
 	});
-	return l.$setGameEngine(b), d.$setGameEngine(b), u.$setGameEngine(b), v && yn(v, b), b;
+	return l.$setGameEngine(b), d.$setGameEngine(b), u.$setGameEngine(b), v && xn(v, b), b;
 }
 //#endregion
-export { ht as ActionContextRegistry, gt as ActionRegistry, pt as AssetManager, lt as AudioEngine, cn as AudioManager, tn as BUILT_IN_PROPERTIES, xe as Behavior, Rn as CharacterControllerBehavior, dn as ColliderDebugManager, at as ConsoleBackend, He as DebugConsole, Ot as DeltaBinding, Se as EventBus, Ue as GameEngine, we as GameEntity, on as GameLevel, mt as GameManager, Ee as GameRandom, De as GameSimulation, _n as GameTimer, yt as GamepadReader, Pn as HavokPhysicsBodyBehavior, zn as InputCapture, Pt as InputManager, bt as KeyboardReader, rn as Level, sn as LevelManager, bn as LogLevels, U as LoggingUtility, xt as MouseReader, ke as NamedBehavior, B as NodeEntity, ct as NodePool, ot as NodeSimulation, V as NullBackend, an as OutlineManager, K as ROUTING_LOOP_SENDER_ID, H as SAGELogger, dt as SceneEngine, un as SimulationSaveManager, Dn as SoundBehavior, je as StateMachineBehavior, Et as ToggleBinding, Tt as TriggerBinding, j as VERSION, Dt as ValueBinding, Lt as applyPostProcessing, En as buildStandardMeshSource, J as computeHierarchyBounds, Hn as createGameEngine, Sn as defineEntity, Me as defineStates, _t as deliverAction, Ne as dilationLimit, Pe as drainPassLimit, Bn as exportConfiguration, qe as getCanonicalTransform, Vn as importConfiguration, A as isBrowser, Fe as operationCallDepthLimit, st as poolSizeLimit, wt as readerFor, nn as registerAllPropertyHandlers, yn as registerBuiltins, Kt as registerColliderHandler, Jt as registerLodHandler, Yt as registerOcclusionHandler, Zt as registerSoundHandler, $t as registerTriggerHandler, en as registerVisibleHandler, kt as resolveBinding, G as schemeOf, P as toQuatObject, F as toQuaternion, M as toVec3Object, N as toVector3 };
+export { ht as ActionContextRegistry, gt as ActionRegistry, pt as AssetManager, lt as AudioEngine, un as AudioManager, rn as BUILT_IN_PROPERTIES, xe as Behavior, Bn as CharacterControllerBehavior, pn as ColliderDebugManager, at as ConsoleBackend, He as DebugConsole, Ot as DeltaBinding, Se as EventBus, Ue as GameEngine, we as GameEntity, cn as GameLevel, mt as GameManager, Ee as GameRandom, De as GameSimulation, yn as GameTimer, yt as GamepadReader, In as HavokPhysicsBodyBehavior, Vn as InputCapture, It as InputManager, bt as KeyboardReader, on as Level, ln as LevelManager, Sn as LogLevels, U as LoggingUtility, xt as MouseReader, ke as NamedBehavior, B as NodeEntity, ct as NodePool, ot as NodeSimulation, V as NullBackend, sn as OutlineManager, K as ROUTING_LOOP_SENDER_ID, H as SAGELogger, dt as SceneEngine, fn as SimulationSaveManager, kn as SoundBehavior, je as StateMachineBehavior, Et as ToggleBinding, Tt as TriggerBinding, j as VERSION, Dt as ValueBinding, zt as applyPostProcessing, On as buildStandardMeshSource, J as computeHierarchyBounds, Wn as createGameEngine, wn as defineEntity, Me as defineStates, _t as deliverAction, Ne as dilationLimit, Pe as drainPassLimit, Hn as exportConfiguration, qe as getCanonicalTransform, Un as importConfiguration, A as isBrowser, Fe as operationCallDepthLimit, st as poolSizeLimit, wt as readerFor, an as registerAllPropertyHandlers, xn as registerBuiltins, Jt as registerColliderHandler, Xt as registerLodHandler, Zt as registerOcclusionHandler, $t as registerSoundHandler, tn as registerTriggerHandler, nn as registerVisibleHandler, kt as resolveBinding, G as schemeOf, P as toQuatObject, F as toQuaternion, M as toVec3Object, N as toVector3 };
 
 //# sourceMappingURL=sage.es.js.map