@skewedaspect/sage 0.13.0 → 0.13.1

package/dist/interfaces/game.d.ts

@@ -12,6 +12,8 @@ export interface BabylonEngineOptions {
 export type RenderEngineOptions = (BabylonEngineOptions | NullEngineOptions | WebGPUEngineOptions) & {
     /** Forces `webgl` or `webgpu` in place of the default `auto`. */
     engine?: EngineType;
+    /** How long, in seconds, boot waits to learn whether WebGPU is supported. Three unless set. */
+    webGPUSupportTimeout?: number;
 };
 /**
  * The options a game passes `createGameEngine` (design/engine.md#booting-an-engine).

package/dist/sage.es.js

@@ -68,7 +68,7 @@ var He = class {
 			configurable: !0
 		});
 	}
-}, j = "0.13.0", Ue = class e {
+}, j = "0.13.1", Ue = class e {
 	canvas;
 	renderEngine;
 	managers;
@@ -2518,7 +2518,7 @@ var sn = class {
 			n = t;
 		} else n = e, this.registerLevelConfig(n);
 		let r = this._loadedLevels.get(n.name);
-		if (r) return this._log.warn(`Level '${n.name}' is already loaded`), r;
+		if (r) return this._log.debug(`Level '${n.name}' is already loaded`), r;
 		this._log.debug(`Loading level: ${n.name}`);
 		let i = this._createLevelInstance(n);
 		this._loadingLevel = i;
@@ -2755,24 +2755,30 @@ var sn = class {
 		let n = this._materials.get(e);
 		return n || (n = new E(`sage-collider-debug-${e}`, t.getScene()), n.emissiveColor = i.FromHexString(e), n.disableLighting = !0, n.wireframe = !0, this._materials.set(e, n), n);
 	}
-};
-//#endregion
-//#region src/utils/graphics.ts
-async function hn() {
-	return Ve() ? be.IsSupportedAsync : !1;
-}
+}, hn = 3;
 async function gn(e, t) {
+	if (!Ve()) return !1;
+	let n, r = new Promise((t) => {
+		n = setTimeout(() => {
+			t("ran out");
+		}, e * 1e3);
+	}), i = await Promise.race([be.IsSupportedAsync, r]);
+	return clearTimeout(n), i === "ran out" ? (t.warn(`WebGPU support did not answer within ${e} seconds; treating WebGPU as unsupported.`), !1) : i;
+}
+async function _n(e, t) {
 	let n = new be(e, t);
 	return await n.initAsync(), n;
 }
-function _n(e, t) {
+function vn(e, t) {
 	return new u(e, t.antialias, t.options, t.adaptToDeviceRatio);
 }
-function vn(e) {
+function yn(e) {
 	return new te(e);
 }
-async function yn(e, t, n = !1, r = new H("Boot")) {
-	if (e === null) return r.debug("Using Null Engine"), vn(t);
+async function bn(e, t, n = !1, r = new H("Boot")) {
+	let i = t.webGPUSupportTimeout ?? hn;
+	if (!Number.isFinite(i) || i <= 0) throw RangeError(`webGPUSupportTimeout is a positive, finite number of seconds, got ${i}.`);
+	if (e === null) return r.debug("Using Null Engine"), yn(t);
 	if (n) {
 		if ("options" in t) {
 			let e = t;
@@ -2788,27 +2794,27 @@ async function yn(e, t, n = !1, r = new H("Boot")) {
 			useLargeWorldRendering: !0
 		};
 	}
-	let i = t.engine || "auto";
-	if (i === "webgpu") {
-		if (await hn()) try {
-			return r.debug("Using forced WebGPU engine"), await gn(e, t);
+	let a = t.engine || "auto";
+	if (a === "webgpu") {
+		if (await gn(i, r)) try {
+			return r.debug("Using forced WebGPU engine"), await _n(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"), _n(e, t);
-	if (await hn()) try {
-		return r.debug("Using WebGPU"), await gn(e, t);
+	if (a === "webgl") return r.debug("Using forced WebGL engine"), vn(e, t);
+	if (await gn(i, r)) try {
+		return r.debug("Using WebGPU"), await _n(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"), _n(e, t);
+	return r.debug("Using WebGL"), vn(e, t);
 }
 //#endregion
 //#region src/utils/timer.ts
-var bn = class {
+var xn = class {
 	_nextId = 0;
 	_delays = [];
 	_intervals = [];
@@ -2872,17 +2878,17 @@ function Z(e) {
 	}
 	return e.simulation;
 }
-function xn(e, t) {
+function Sn(e, t) {
 	return typeof e == "string" ? Z(t)?.getEntity(e) : e;
 }
-function Sn(e, t) {
+function Cn(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 = xn(e, t);
+		let a = Sn(e, t);
 		if (!a) {
 			console.warn(`[sage] Entity not found: ${e}`);
 			return;
@@ -2923,7 +2929,7 @@ function Sn(e, t) {
 		});
 		return console.table(a), [...i];
 	}), e.expose("inspect", (e) => {
-		let n = xn(e, t);
+		let n = Sn(e, t);
 		if (!n) {
 			console.warn(`[sage] Entity not found: ${e}`);
 			return;
@@ -2956,7 +2962,7 @@ function Sn(e, t) {
 }
 //#endregion
 //#region src/interfaces/logger.ts
-var Cn = [
+var wn = [
 	"trace",
 	"debug",
 	"info",
@@ -2966,7 +2972,7 @@ var Cn = [
 ];
 //#endregion
 //#region src/entities/defineEntity.ts
-function wn(e, t) {
+function Tn(e, t) {
 	let n = t ?? {}, r = e.tags ?? [], i = n.tags ?? [];
 	return {
 		...e.defaultState,
@@ -2974,13 +2980,13 @@ function wn(e, t) {
 		tags: [.../* @__PURE__ */ new Set([...r, ...i])]
 	};
 }
-function Tn(e) {
+function En(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 = wn(e, r);
+			let a = Tn(e, r);
 			return super.create(t, n, a, i);
 		}
 	}
@@ -2991,12 +2997,12 @@ function Tn(e) {
 function Q(e) {
 	return new i(e.r, e.g, e.b);
 }
-function En(e, t, n) {
+function Dn(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 Dn(e, t, n) {
+function On(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;
@@ -3005,19 +3011,19 @@ function Dn(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 On(e, t, n) {
+async function kn(e, t, n) {
 	let r;
-	return t.source.includes("#") ? (await n.load(t.source), r = n.clone(t.source, e)) : r = En(e, t.source, t.params), r.isVisible = t.visible ?? !0, t.material !== void 0 && Dn(e, r, t.material), r;
+	return t.source.includes("#") ? (await n.load(t.source), r = n.clone(t.source, e)) : r = Dn(e, t.source, t.params), r.isVisible = t.visible ?? !0, t.material !== void 0 && On(e, r, t.material), r;
 }
-function kn(e, t) {
+function An(e, t) {
 	return async (n, r) => {
 		let i = e[r]?.meshConfig;
-		if (i !== void 0) return On(n, i, t);
+		if (i !== void 0) return kn(n, i, t);
 	};
 }
 //#endregion
 //#region src/behaviors/sound.ts
-var An = class extends k {
+var jn = class extends k {
 	static ops = ["play", "stop"];
 	defaults = { sounds: {} };
 	#e = /* @__PURE__ */ new Map();
@@ -3059,10 +3065,10 @@ var An = class extends k {
 };
 //#endregion
 //#region src/behaviors/physicsBody.ts
-function jn(e) {
+function Mn(e) {
 	return e === "sphere" ? w.SPHERE : e === "cylinder" ? w.CYLINDER : e === "convex" ? w.CONVEX_HULL : e === "mesh" ? w.MESH : w.BOX;
 }
-function Mn(e, t) {
+function Nn(e, t) {
 	let { extents: n, center: r } = t;
 	return e === "sphere" ? {
 		radius: Math.max(n.x, n.y, n.z) / 2,
@@ -3076,7 +3082,7 @@ function Mn(e, t) {
 		center: r
 	};
 }
-function Nn(e, t) {
+function Pn(e, t) {
 	let { extents: n } = e;
 	if (e.shape === "sphere") return new ce(O.Zero(), n.x / 2, t);
 	if (e.shape === "cylinder") {
@@ -3088,17 +3094,17 @@ function Nn(e, t) {
 function $(e) {
 	return e === "static" ? S.STATIC : e === "kinematic" ? S.ANIMATED : S.DYNAMIC;
 }
-function Pn(e) {
+function Fn(e) {
 	return e === S.STATIC ? "static" : e === S.ANIMATED ? "kinematic" : "dynamic";
 }
-function Fn(e) {
+function In(e) {
 	return e === "kinematic" ? C.ACTION : C.TELEPORT;
 }
-function In(e) {
+function Ln(e) {
 	for (let t of e.getChildMeshes(!1)) if (t.getTotalVertices() > 0) return !0;
 	return !1;
 }
-var Ln = class extends k {
+var Rn = class extends k {
 	static ops = ["applyImpulse"];
 	defaults = {
 		shape: "box",
@@ -3159,13 +3165,13 @@ var Ln = 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, jn(r), {
+			return new x(n, Mn(r), {
 				mass: i,
 				mesh: a
 			}, t);
 		}
-		let a = Mn(r, this.#s(e));
-		return new x(n, jn(r), {
+		let a = Nn(r, this.#s(e));
+		return new x(n, Mn(r), {
 			mass: i,
 			...a
 		}, t);
@@ -3179,13 +3185,13 @@ var Ln = class extends k {
 				center: e.center.clone()
 			};
 		}
-		if (!In(e.node)) throw Error(`HavokPhysicsBodyBehavior: entity "${e.id}" has neither a mesh nor anything under its node to size a body from.`);
+		if (!Ln(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 = Nn(n, e);
+			let r = Pn(n, e);
 			t.addChild(r, N(n.position), F(n.rotation)), this.#a.push(r);
 		}
 		return this.#a.push(t), t;
@@ -3220,7 +3226,7 @@ var Ln = class extends k {
 			get: () => s,
 			set: r
 		}), this.computed("motion", {
-			get: () => this.#n ? Pn(this.#r) : Pn(this.#y().getMotionType()),
+			get: () => this.#n ? Fn(this.#r) : Fn(this.#y().getMotionType()),
 			set: (e) => {
 				if (this.#n) {
 					this.#r = $(e);
@@ -3258,7 +3264,7 @@ var Ln = 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(Fn(Pn(n.getMotionType()))), this.#b().setPhysicsBodyTransformation(n, r), n.setPrestepType(C.DISABLED));
+		r.position = N(e), r.rotationQuaternion = F(t), !this.#n && (n.setPrestepType(In(Fn(n.getMotionType()))), this.#b().setPhysicsBodyTransformation(n, r), n.setPrestepType(C.DISABLED));
 	}
 	#f(e) {
 		if (e !== this.#n) {
@@ -3311,12 +3317,12 @@ var Ln = 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;
 	}
-}, Rn = new O(0, -1, 0), zn = "standing";
-function Bn(e) {
+}, zn = new O(0, -1, 0), Bn = "standing";
+function Vn(e) {
 	let t = Object.keys(e);
 	return t.sort((t, n) => e[n].height - e[t].height), t;
 }
-var Vn = class extends k {
+var Hn = class extends k {
 	defaults = {
 		moveX: 0,
 		moveZ: 0,
@@ -3351,7 +3357,7 @@ var Vn = class extends k {
 			z: 0
 		},
 		grounded: !1,
-		stance: zn
+		stance: Bn
 	};
 	#e;
 	#t;
@@ -3361,7 +3367,7 @@ var Vn = class extends k {
 	#a = /* @__PURE__ */ new Map();
 	#o = W();
 	#s = !1;
-	#c = zn;
+	#c = Bn;
 	#l = !1;
 	#u;
 	#d = O.Zero();
@@ -3381,7 +3387,7 @@ var Vn = class extends k {
 	onUpdate(e) {
 		let t = this.#e;
 		if (t === void 0) return;
-		let n = t.checkSupport(e, Rn);
+		let n = t.checkSupport(e, zn);
 		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());
@@ -3427,7 +3433,7 @@ var Vn = 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 Bn(this.state.stances)) if (this.#_(this.state.stances[t]) && this.stanceFits(t)) {
+		else for (let t of Vn(this.state.stances)) if (this.#_(this.state.stances[t]) && this.stanceFits(t)) {
 			e = t;
 			break;
 		}
@@ -3525,7 +3531,7 @@ var Vn = class extends k {
 		return t;
 	}
 	#R() {
-		let e = Bn(this.state.stances);
+		let e = Vn(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];
 	}
@@ -3543,7 +3549,7 @@ var Vn = class extends k {
 		if (this.#e === void 0) throw Error(`CharacterControllerBehavior: entity "${this.entity.id}" has no capsule to answer for.`);
 		return this.#e;
 	}
-}, Hn = class {
+}, Un = class {
 	#e;
 	#t;
 	#n;
@@ -3571,24 +3577,24 @@ var Vn = class extends k {
 };
 //#endregion
 //#region src/input/configuration.ts
-function Un(e, t, n) {
+function Wn(e, t, n) {
 	return {
 		actions: [...e],
 		bindings: t.map((e) => e.toDefinition()),
 		contexts: [...n]
 	};
 }
-function Wn(e, t, n) {
+function Gn(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 Gn(e, t, n = {}) {
+async function Kn(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 yn(e, {
+	let a = await bn(e, {
 		antialias: !0,
 		adaptToDeviceRatio: !0,
 		enableAllFeatures: !0,
@@ -3623,7 +3629,7 @@ async function Gn(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 bn();
+	let y = new xn();
 	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,
@@ -3642,9 +3648,9 @@ async function Gn(e, t, n = {}) {
 			v?.expose(e, t);
 		}
 	});
-	return l.$setGameEngine(b), d.$setGameEngine(b), u.$setGameEngine(b), v && Sn(v, b), b;
+	return l.$setGameEngine(b), d.$setGameEngine(b), u.$setGameEngine(b), v && Cn(v, b), b;
 }
 //#endregion
-export { ht as ActionContextRegistry, gt as ActionRegistry, pt as AssetManager, lt as AudioEngine, dn as AudioManager, an as BUILT_IN_PROPERTIES, xe as Behavior, Vn as CharacterControllerBehavior, mn as ColliderDebugManager, at as ConsoleBackend, He as DebugConsole, Ot as DeltaBinding, Se as EventBus, Ue as GameEngine, we as GameEntity, ln as GameLevel, mt as GameManager, Ee as GameRandom, De as GameSimulation, bn as GameTimer, yt as GamepadReader, Ln as HavokPhysicsBodyBehavior, Hn as InputCapture, Lt as InputManager, bt as KeyboardReader, sn as Level, un as LevelManager, Cn as LogLevels, U as LoggingUtility, xt as MouseReader, ke as NamedBehavior, B as NodeEntity, ct as NodePool, ot as NodeSimulation, V as NullBackend, cn as OutlineManager, K as ROUTING_LOOP_SENDER_ID, H as SAGELogger, dt as SceneEngine, pn as SimulationSaveManager, An as SoundBehavior, je as StateMachineBehavior, Et as ToggleBinding, Tt as TriggerBinding, j as VERSION, Dt as ValueBinding, Bt as applyPostProcessing, kn as buildStandardMeshSource, J as computeHierarchyBounds, Gn as createGameEngine, Tn as defineEntity, Me as defineStates, _t as deliverAction, Ne as dilationLimit, Pe as drainPassLimit, Un as exportConfiguration, qe as getCanonicalTransform, Wn as importConfiguration, A as isBrowser, Fe as operationCallDepthLimit, st as poolSizeLimit, wt as readerFor, on as registerAllPropertyHandlers, Sn as registerBuiltins, Yt as registerColliderHandler, Zt as registerLodHandler, Qt as registerOcclusionHandler, en as registerSoundHandler, nn as registerTriggerHandler, rn 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, dn as AudioManager, an as BUILT_IN_PROPERTIES, xe as Behavior, Hn as CharacterControllerBehavior, mn as ColliderDebugManager, at as ConsoleBackend, He as DebugConsole, Ot as DeltaBinding, Se as EventBus, Ue as GameEngine, we as GameEntity, ln as GameLevel, mt as GameManager, Ee as GameRandom, De as GameSimulation, xn as GameTimer, yt as GamepadReader, Rn as HavokPhysicsBodyBehavior, Un as InputCapture, Lt as InputManager, bt as KeyboardReader, sn as Level, un as LevelManager, wn as LogLevels, U as LoggingUtility, xt as MouseReader, ke as NamedBehavior, B as NodeEntity, ct as NodePool, ot as NodeSimulation, V as NullBackend, cn as OutlineManager, K as ROUTING_LOOP_SENDER_ID, H as SAGELogger, dt as SceneEngine, pn as SimulationSaveManager, jn as SoundBehavior, je as StateMachineBehavior, Et as ToggleBinding, Tt as TriggerBinding, j as VERSION, Dt as ValueBinding, Bt as applyPostProcessing, An as buildStandardMeshSource, J as computeHierarchyBounds, Kn as createGameEngine, En as defineEntity, Me as defineStates, _t as deliverAction, Ne as dilationLimit, Pe as drainPassLimit, Wn as exportConfiguration, qe as getCanonicalTransform, Gn as importConfiguration, A as isBrowser, Fe as operationCallDepthLimit, st as poolSizeLimit, wt as readerFor, on as registerAllPropertyHandlers, Cn as registerBuiltins, Yt as registerColliderHandler, Zt as registerLodHandler, Qt as registerOcclusionHandler, en as registerSoundHandler, nn as registerTriggerHandler, rn 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