@skewedaspect/sage-core 0.10.0-beta.2 → 0.10.0-rc.2

package/dist/sage-core.js

@@ -1,38 +1,96 @@
+//#region src/computedState.ts
+var e = /* @__PURE__ */ new WeakMap();
+function t(t) {
+	let n = e.get(t);
+	return n === void 0 && (n = [], e.set(t, n)), n;
+}
+function n(e, n, r) {
+	let i = Object.getOwnPropertyDescriptor(e, n);
+	i === void 0 && (i = {
+		value: void 0,
+		writable: !0,
+		enumerable: !0,
+		configurable: !0
+	}), t(e).push({
+		field: n,
+		beneath: i
+	}), Object.defineProperty(e, n, {
+		get: r.get,
+		set: r.set,
+		enumerable: !0,
+		configurable: !0
+	});
+}
+function r(e) {
+	if (Array.isArray(e)) {
+		let t = [];
+		for (let n of e) t.push(r(n));
+		return t;
+	}
+	if (typeof e == "object" && e) {
+		let t = Object.create(null);
+		for (let [n, i] of Object.entries(e)) t[n] = r(i);
+		return t;
+	}
+	return e;
+}
+function i(t) {
+	let n = e.get(t);
+	if (n !== void 0) {
+		for (let e = n.length - 1; e >= 0; e--) {
+			let i = n[e], a = r(t[i.field]);
+			"value" in i.beneath ? Object.defineProperty(t, i.field, {
+				value: a,
+				writable: !0,
+				enumerable: !0,
+				configurable: !0
+			}) : Object.defineProperty(t, i.field, i.beneath);
+		}
+		n.length = 0;
+	}
+}
+//#endregion
 //#region src/behavior.ts
-var e = class {}, t = class extends e {
+var a = class {
+	computed(e, t) {
+		n(this.state, e, t);
+	}
+}, o = class extends a {
 	defaults = { displayName: "" };
 };
 //#endregion
 //#region src/stateMachineBehavior.ts
-function n(e, t) {
+function s(e, t) {
 	return t;
 }
-var r = class extends e {
+var c = class extends a {
 	static ops = ["transitionTo"];
 	onUpdate(e) {
 		let t = this.state.currentState;
+		if (!Object.hasOwn(this.states, t)) throw Error(`StateMachineBehavior on entity "${this.entity.id}": currentState is "${t}", which states does not declare.`);
 		this.states[t].update?.call(this, e);
 	}
 	transitionTo(e) {
-		if (!(e in this.states)) throw Error(`StateMachineBehavior: no state named "${e}" is declared.`);
+		if (!Object.hasOwn(this.states, e)) throw Error(`StateMachineBehavior: no state named "${e}" is declared.`);
 		if (e === this.state.currentState) return;
 		let t = this.state.currentState;
 		this.states[t].exit?.call(this, e), this.state.currentState = e, this.states[e].enter?.call(this, t);
 	}
-}, i = 32, a = 64, o = 5;
+}, l = 32, u = 64, d = 5;
 //#endregion
 //#region src/events.ts
-function s(e) {
+function f(e) {
 	let t = e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace(/\\\*/g, ".*");
 	return RegExp(`^${t}$`);
 }
 //#endregion
 //#region src/eventBus.ts
-var c = class e {
+var p = class e {
 	#e = [];
 	#t = [];
 	#n = /* @__PURE__ */ new Map();
 	#r = /* @__PURE__ */ new Map();
+	#i = 0;
 	register(e, t) {
 		if (this.#n.has(e.id)) throw Error(`A subscriber is already registered under the ID "${e.id}".`);
 		this.#n.set(e.id, e);
@@ -41,13 +99,26 @@ var c = class e {
 			let t = i;
 			if (t.endsWith(":*")) {
 				let n = {
-					pattern: s(t),
+					pattern: f(t),
 					subscriber: e
 				};
 				r.push(n), this.#t.push(n);
-			} else n.includes(t) || (n.push(t), this.#i(t, e));
+			} else n.includes(t) || (n.push(t), this.#a(t, e));
 		}
-		return this.#o(e, n, r);
+		return this.#s(e, n, r);
+	}
+	on(e, t) {
+		this.#i += 1;
+		let n = {
+			id: this.mintSubscriberID(this.#i),
+			receive(e) {
+				return t(e), !1;
+			}
+		};
+		return this.register(n, [e]);
+	}
+	mintSubscriberID(e) {
+		return `subscriber-${e}`;
 	}
 	emit(e) {
 		this.#e.push(e);
@@ -61,45 +132,54 @@ var c = class e {
 			}
 			let n = this.#e;
 			this.#e = [];
-			for (let t of n) this.#s(t, e);
+			for (let t of n) this.#c(t, e);
 		}
 		if (e.length > 0) throw AggregateError(e, "The drain raised.");
 	}
-	#i(e, t) {
+	takeQueuedEvents() {
+		let e = this.#e;
+		return this.#e = [], e;
+	}
+	static reclaimQueuedEvents(e, t) {
+		let n = [], r = [];
+		for (let i of e.#e) t.includes(i) ? n.push(i) : r.push(i);
+		return e.#e = r, n;
+	}
+	#a(e, t) {
 		let n = this.#r.get(e) ?? [];
 		n.push(t), this.#r.set(e, n);
 	}
-	#a(e, t) {
+	#o(e, t) {
 		let n = this.#r.get(e);
 		if (n === void 0) return;
 		let r = n.indexOf(t);
 		r >= 0 && n.splice(r, 1), n.length === 0 && this.#r.delete(e);
 	}
-	#o(e, t, n) {
+	#s(e, t, n) {
 		let r = !0;
 		return () => {
 			if (!r) return;
 			r = !1, this.#n.get(e.id) === e && this.#n.delete(e.id);
-			for (let n of t) this.#a(n, e);
+			for (let n of t) this.#o(n, e);
 			let i = [];
 			for (let e of this.#t) n.includes(e) || i.push(e);
 			this.#t = i;
 		};
 	}
-	#s(t, n) {
+	#c(t, n) {
 		if (t.targetID !== void 0) {
 			let r = this.#n.get(t.targetID);
-			r !== void 0 && e.#l(r, t, n);
+			r !== void 0 && e.#u(r, t, n);
 			return;
 		}
 		let r = /* @__PURE__ */ new Set();
-		for (let i of [...this.#r.get(t.type) ?? []]) e.#c(i, t, r, n);
-		for (let i of [...this.#t]) i.pattern.test(t.type) && e.#c(i.subscriber, t, r, n);
+		for (let i of [...this.#r.get(t.type) ?? []]) e.#l(i, t, r, n);
+		for (let i of [...this.#t]) i.pattern.test(t.type) && e.#l(i.subscriber, t, r, n);
 	}
-	static #c(t, n, r, i) {
-		r.has(t) || (r.add(t), e.#l(t, n, i));
+	static #l(t, n, r, i) {
+		r.has(t) || (r.add(t), e.#u(t, n, i));
 	}
-	static #l(e, t, n) {
+	static #u(e, t, n) {
 		try {
 			e.receive(t);
 		} catch (e) {
@@ -109,57 +189,60 @@ var c = class e {
 };
 //#endregion
 //#region src/gameEntity.ts
-function l(e, t) {
+function m(e, t) {
 	throw TypeError(`Entity "${e}" state holds a value that is not finite JSON-compatible data at "${t}".`);
 }
-function u(e, t, n, r) {
+function h(e, t, n, r) {
 	if (e === null || typeof e == "string" || typeof e == "boolean") return e;
-	if (typeof e == "number") return Number.isFinite(e) || l(t, n), e;
+	if (typeof e == "number") return Number.isFinite(e) || m(t, n), e;
 	if (Array.isArray(e)) {
-		r.has(e) && l(t, n), r.add(e);
+		r.has(e) && m(t, n), r.add(e);
 		let i = [];
-		for (let [a, o] of e.entries()) i.push(u(o, t, `${n}[${a}]`, r));
+		for (let [a, o] of e.entries()) i.push(h(o, t, `${n}[${a}]`, r));
 		return r.delete(e), i;
 	}
 	if (typeof e == "object") {
 		let i = Object.getPrototypeOf(e);
-		(i !== Object.prototype && i !== null || r.has(e)) && l(t, n), r.add(e);
+		(i !== Object.prototype && i !== null || r.has(e)) && m(t, n), r.add(e);
 		let a = Object.create(null);
-		for (let [i, o] of Object.entries(e)) a[i] = u(o, t, n === "" ? i : `${n}.${i}`, r);
+		for (let [i, o] of Object.entries(e)) {
+			let e = `${n}.${i}`;
+			n === "" && (e = i), a[i] = h(o, t, e, r);
+		}
 		return r.delete(e), a;
 	}
-	return l(t, n);
+	return m(t, n);
 }
-function d(e, t) {
-	return u(e, t, "", /* @__PURE__ */ new Set());
+function g(e, t) {
+	return h(e, t, "", /* @__PURE__ */ new Set());
 }
-var f = class e {
+var _ = class e {
 	id;
 	name;
 	context;
 	state;
 	ops;
-	eventSubscriptions;
 	static behaviors = [];
 	#e = [];
 	#t = [];
 	#n;
 	#r = 0;
 	#i;
+	#a = !1;
 	static create(t, n, r, i) {
-		return e.#a(this, t, n, r ?? {}, !0, i);
+		return e.#o(this, t, n, r ?? {}, !0, i);
 	}
 	static restore(t, n, r, i) {
-		return e.#a(this, t, n, r, !1, i);
+		return e.#o(this, t, n, r, !1, i);
 	}
-	static #a(e, t, n, r, i, a) {
+	static #o(e, t, n, r, i, a) {
 		return new e(t, n, r, i, a);
 	}
 	constructor(t, n, r, i, a) {
 		this.id = t, this.name = a ?? new.target.name, this.context = n;
 		let o = new.target.behaviors;
 		for (let e of o) this.#e.push(new e());
-		this.state = e.#u(this.#e, r, t);
+		this.state = e.#d(this.#e, r, t);
 		let s = Object.create(null);
 		this.ops = s;
 		let c = [];
@@ -169,9 +252,11 @@ var f = class e {
 				state: this.state,
 				ops: s,
 				entity: this
-			}), this.#o(n, t, s), this.#s(n, t, c));
+			}), this.#s(n, t, s), this.#c(n, t, c));
 		}
-		this.eventSubscriptions = c, this.#n = n.bus.register(this, c), i && this.#l();
+		this.declareComputedState(r);
+		for (let e of this.#e) e.onStateReady?.();
+		this.#n = n.bus.register(this, c), i && this.#u();
 	}
 	hasBehavior(e) {
 		for (let t of this.#e) if (t instanceof e) return !0;
@@ -194,32 +279,39 @@ var f = class e {
 		this.context.bus.emit(r);
 	}
 	update(e) {
-		for (let t of this.#e) t.onUpdate?.(e);
+		for (let t of this.#e) if (t.onUpdate?.(e), this.#a) return;
 	}
 	receive(t) {
 		let n = t;
-		for (let r of this.#t) if (e.#f(r, n.type) && r.instance.onEvent?.(t) === !0) return !0;
+		for (let r of this.#t) if (e.#p(r, n.type) && r.instance.onEvent?.(t) === !0) return !0;
 		return !1;
 	}
 	destroy() {
-		this.#n();
+		this.#a = !0, this.removeComputedState(), this.#n();
+	}
+	declareComputedState(e) {}
+	computed(e, t) {
+		n(this.state, e, t);
+	}
+	removeComputedState() {
+		i(this.state);
 	}
 	attachedBehaviors() {
 		return [...this.#e];
 	}
-	#o(e, t, n) {
+	#s(e, t, n) {
 		for (let r of t.ops ?? []) {
 			if (Object.hasOwn(n, r)) throw Error(`Two behaviors on entity "${this.id}" expose the operation "${String(r)}".`);
 			let i = e[r];
 			if (typeof i != "function") throw Error(`Behavior "${t.name}" declares the operation "${String(r)}" with no method behind it.`);
-			n[r] = this.#c(r, i, e);
+			n[r] = this.#l(r, i, e);
 		}
 	}
-	#s(e, t, n) {
+	#c(e, t, n) {
 		let r = [], i = [];
 		for (let e of t.events ?? []) {
 			let t = e;
-			t.endsWith(":*") ? i.push(s(t)) : r.push(t), n.includes(e) || n.push(e);
+			t.endsWith(":*") ? i.push(f(t)) : r.push(t), n.includes(e) || n.push(e);
 		}
 		(r.length > 0 || i.length > 0) && this.#t.push({
 			instance: e,
@@ -227,7 +319,7 @@ var f = class e {
 			patterns: i
 		});
 	}
-	#c(e, t, n) {
+	#l(e, t, n) {
 		return (...r) => {
 			this.#r += 1;
 			try {
@@ -238,7 +330,7 @@ var f = class e {
 			}
 		};
 	}
-	#l() {
+	#u() {
 		this.#i = [];
 		try {
 			for (let e of this.#e) e.onCreate?.();
@@ -249,13 +341,13 @@ var f = class e {
 		this.#i = void 0;
 		for (let t of e) this.context.bus.emit(t);
 	}
-	static #u(t, n, r) {
+	static #d(t, n, r) {
 		let i = Object.create(null);
 		i.tags = [];
-		for (let e of t) Object.assign(i, d(e.defaults, r));
-		return Object.assign(i, d(n, r)), e.#d(i, r), i;
+		for (let e of t) Object.assign(i, g(e.defaults, r));
+		return Object.assign(i, g(n, r)), e.#f(i, r), i;
 	}
-	static #d(e, t) {
+	static #f(e, t) {
 		let n = e.tags;
 		if (!Array.isArray(n)) throw TypeError(`Entity "${t}" tags must be a list of strings.`);
 		let r = [];
@@ -265,120 +357,233 @@ var f = class e {
 			r.push(e);
 		}
 	}
-	static #f(e, t) {
+	static #p(e, t) {
 		if (e.exact.includes(t)) return !0;
 		for (let n of e.patterns) if (n.test(t)) return !0;
 		return !1;
 	}
-}, p = class e {
-	#e = new c();
+}, v = class extends p {
+	#e;
+	#t;
+	#n = [];
+	#r;
+	#i = [];
+	constructor(e, t) {
+		super(), this.#e = e, this.#t = t;
+	}
+	get attached() {
+		return this.#r !== void 0;
+	}
+	mintSubscriberID(e) {
+		return `${this.#e}-subscriber-${e}`;
+	}
+	register(e, t) {
+		let n = this.#a(), r;
+		r = n === void 0 ? super.register(e, t) : n.register(e, t);
+		let i = {
+			subscriber: e,
+			subscriptions: t,
+			teardown: r
+		};
+		return this.#n.push(i), () => {
+			let e = this.#n.indexOf(i);
+			e < 0 || (this.#n.splice(e, 1), i.teardown());
+		};
+	}
+	emit(e) {
+		let t = this.#a();
+		t === void 0 ? super.emit(e) : (this.#i.push(e), t.emit(e));
+	}
+	drain() {
+		let e = this.#a();
+		if (e !== void 0) try {
+			e.drain();
+		} finally {
+			this.#i = [];
+		}
+		else super.drain();
+	}
+	attach() {
+		if (this.#t === void 0) throw Error(`The simulation "${this.#e}" was built with no engine bus to attach to.`);
+		if (this.#r === void 0) {
+			this.#r = this.#t.register({
+				id: this.#e,
+				receive: () => !1
+			}, []);
+			for (let e of this.#n) e.teardown(), e.teardown = this.#t.register(e.subscriber, e.subscriptions);
+			for (let e of this.takeQueuedEvents()) this.#t.emit(e);
+		}
+	}
+	detach() {
+		if (this.#r === void 0) return;
+		for (let e of this.#n) e.teardown(), e.teardown = super.register(e.subscriber, e.subscriptions);
+		let e = this.#t;
+		if (e !== void 0) for (let t of p.reclaimQueuedEvents(e, this.#i)) super.emit(t);
+		this.#i = [], this.#r(), this.#r = void 0;
+	}
+	#a() {
+		if (this.#r !== void 0) return this.#t;
+	}
+}, y = "global", b = 128 * 2 ** -52, x = class e {
+	#e;
 	#t;
 	#n;
 	#r;
-	#i = 0;
-	#a = 0;
+	#i;
+	#a;
 	#o = 0;
-	#s = [];
+	#s = 0;
+	#c = 0;
+	#l = [];
+	#u = /* @__PURE__ */ new Map();
+	#d = /* @__PURE__ */ new Set();
 	constructor(e) {
-		if (this.#t = e.fixedStepDuration, this.#n = e.entityClasses, this.#r = e.allocator, !Number.isFinite(this.#t) || this.#t <= 0) throw RangeError("A fixed step duration must be a finite number greater than zero.");
+		if (this.#e = e.id, this.#r = e.fixedStepDuration, this.#i = e.entityClasses, this.#a = e.allocator, this.#n = e.bus, this.#t = new v(e.id, e.bus), this.#e === y) throw Error(`The simulation name "${y}" is reserved for the persistent simulation.`);
+		if (!Number.isFinite(this.#r) || this.#r <= 0) throw RangeError("A fixed step duration must be a finite number greater than zero.");
 	}
-	get bus() {
+	get id() {
 		return this.#e;
 	}
+	get bus() {
+		return this.#t;
+	}
+	get attached() {
+		return this.#t.attached;
+	}
 	get tick() {
-		return this.#i;
+		return this.#o;
 	}
 	get entities() {
-		return [...this.#s];
+		return [...this.#l];
+	}
+	attach() {
+		this.#t.attach();
+	}
+	detach() {
+		this.#t.detach();
 	}
 	spawn(e, t, n) {
-		let r = this.#f(e), i = t;
-		if (i === void 0 && (i = this.#d()), this.getEntity(i) !== void 0) throw Error(`The simulation already holds an entity under the ID "${i}".`);
-		let a = r.create(i, this, n ?? {}, e);
-		return this.#s.push(a), a;
+		return this.spawnByName(e, t, n);
+	}
+	spawnByName(e, t, n) {
+		let r = this.#b(e), i = n;
+		if (i === void 0 && (i = this.#_()), this.#u.has(i)) throw Error(`The simulation already holds an entity under the ID "${i}".`);
+		if (this.#d.has(i)) throw Error(`The simulation already retired the ID "${i}"; an ID is never reused.`);
+		let a = r.create(i, this.#y(), t ?? {}, e);
+		return this.#l.push(a), this.#u.set(i, a), a;
 	}
 	despawn(e) {
-		let t = this.#s.findIndex((t) => t.id === e);
-		if (t < 0) return;
-		let n = this.#s[t];
-		n !== void 0 && (n.destroy(), this.#s.splice(t, 1));
+		return this.#f(e, /* @__PURE__ */ new Set());
+	}
+	#f(e, t) {
+		let n = this.#u.get(e);
+		if (n === void 0) return !1;
+		t.add(e);
+		for (let n of this.#g(e)) t.has(n.id) || this.#f(n.id, t);
+		return n.destroy(), this.#l.splice(this.#l.indexOf(n), 1), this.#u.delete(e), this.#d.add(e), !0;
 	}
 	getEntity(e) {
-		return this.#s.find((t) => t.id === e);
+		return this.#u.get(e);
 	}
 	getEntitiesByTag(t) {
 		let n = [];
-		for (let r of this.#s) e.#p(r).tags.includes(t) && n.push(r);
+		for (let r of this.#l) e.#x(r).tags.includes(t) && n.push(r);
 		return n;
 	}
+	getEntitiesOfClass(e) {
+		let t = [];
+		for (let n of this.#l) n instanceof e && t.push(n);
+		return t;
+	}
 	runStepsForElapsedTime(e) {
 		if (!Number.isFinite(e) || e < 0) throw RangeError("Elapsed time must be a finite number of zero or more.");
-		this.#o += e;
+		this.#c += e;
 		let t = 0;
-		for (; this.#l() && t < 5;) this.#u(), t += 1;
-		t === 5 && this.#l() && (this.#o %= this.#t);
+		for (; this.#m() && t < 5;) this.#h(), t += 1;
+		t === 5 && this.#m() && (this.#c %= this.#r);
 	}
 	snapshot() {
 		let e = [];
-		for (let t of this.#s) e.push({
+		for (let t of this.#l) e.push({
 			id: t.id,
 			name: t.name,
-			state: d(t.state, t.id)
+			state: g(t.state, t.id)
 		});
 		return {
-			tick: this.#i,
-			idCounter: this.#a,
+			id: this.#e,
+			tick: this.#o,
+			idCounter: this.#s,
 			entities: e
 		};
 	}
-	fromSnapshot(e) {
+	buildFromSnapshot(e) {
 		let t = this.buildReplacementSimulation({
-			fixedStepDuration: this.#t,
-			entityClasses: this.#n,
-			allocator: this.#r
+			id: e.id,
+			fixedStepDuration: this.#r,
+			entityClasses: this.#i,
+			allocator: this.#a,
+			bus: this.#n
 		});
-		return t.#c(e), t;
+		return t.#p(e), t;
 	}
 	buildReplacementSimulation(t) {
 		return new e(t);
 	}
-	#c(e) {
+	#p(e) {
 		let t = [];
 		try {
 			for (let n of e.entities) {
-				let e = this.#f(n.name).restore(n.id, this, n.state, n.name);
+				let e = this.#b(n.name).restore(n.id, this.#y(), n.state, n.name);
 				t.push(e);
 			}
 		} catch (e) {
 			for (let e of t) e.destroy();
 			throw e;
 		}
-		this.#s = t, this.#i = e.tick, this.#a = e.idCounter;
-	}
-	#l() {
-		return this.#o + 2 ** -52 >= this.#t;
-	}
-	#u() {
-		for (let e of [...this.#s]) e.update(this.#t);
+		this.#l = t, this.#u = /* @__PURE__ */ new Map();
+		for (let e of t) this.#u.set(e.id, e);
+		this.#o = e.tick, this.#s = e.idCounter;
+	}
+	#m() {
+		let e = b * this.#r;
+		return this.#c + e >= this.#r;
+	}
+	advanceFixedStep(e) {}
+	#h() {
+		for (let e of [...this.#l]) this.#u.get(e.id) === e && e.update(this.#r);
+		this.advanceFixedStep(this.#r);
 		try {
-			this.#e.drain();
+			this.#t.drain();
 		} finally {
-			this.#o -= this.#t, Math.abs(this.#o) <= 2 ** -52 && (this.#o = 0), this.#i += 1;
+			this.#c -= this.#r, Math.abs(this.#c) <= b * this.#r && (this.#c = 0), this.#o += 1;
 		}
 	}
-	#d() {
-		return this.#r === void 0 ? (this.#a += 1, `entity-${this.#a}`) : this.#r();
+	#g(e) {
+		let t = [];
+		for (let n of this.#l) n.state.parentID === e && t.push(n);
+		return t;
+	}
+	#_() {
+		if (this.#a !== void 0) return this.#a();
+		for (this.#s += 1; this.#v(`${this.#e}-${this.#s}`);) this.#s += 1;
+		return `${this.#e}-${this.#s}`;
+	}
+	#v(e) {
+		return this.#u.has(e) || this.#d.has(e);
+	}
+	#y() {
+		return this;
 	}
-	#f(e) {
-		let t = this.#n[e];
-		if (t === void 0) throw Error(`The entity class table holds no class named "${e}".`);
+	#b(e) {
+		let t = this.#i[e];
+		if (t === void 0) throw Error(`The entity registry holds no class named "${e}".`);
 		return t;
 	}
-	static #p(e) {
+	static #x(e) {
 		return e.state;
 	}
 };
 //#endregion
-export { e as Behavior, c as EventBus, f as GameEntity, p as GameSimulationManager, t as NamedBehavior, r as StateMachineBehavior, n as defineStates, o as dilationLimit, a as drainPassLimit, i as operationCallDepthLimit };
+export { a as Behavior, p as EventBus, _ as GameEntity, x as GameSimulationManager, o as NamedBehavior, c as StateMachineBehavior, s as defineStates, d as dilationLimit, u as drainPassLimit, l as operationCallDepthLimit };
 
 //# sourceMappingURL=sage-core.js.map