@daneren2005/shared-memory-ecs 1.4.0 → 1.5.1

package/dist/index.js

@@ -1,18 +1,17 @@
-import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "./create-component-worker-vbX3vEia.js";
-import s from "@daneren2005/shared-memory-objects/memory-heap";
-import { MAX_BYTE_OFFSET_LENGTH as c } from "@daneren2005/shared-memory-objects/utils/pointer";
-import l from "@daneren2005/shared-memory-objects/local-pool";
+import { a as e, c as t, d as n, f as r, i, l as a, n as o, o as s, r as c, s as l, t as u, u as d } from "./create-component-worker-BM942gjg.js";
+import f from "@daneren2005/shared-memory-objects/memory-heap";
+import { MAX_BYTE_OFFSET_LENGTH as p } from "@daneren2005/shared-memory-objects/utils/pointer";
 //#region \0rolldown/runtime.js
-var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescriptor, p = Object.getOwnPropertyNames, m = Object.getPrototypeOf, h = Object.prototype.hasOwnProperty, g = (e, t) => () => (t || (e((t = { exports: {} }).exports, t), e = null), t.exports), _ = (e, t, n, r) => {
-	if (t && typeof t == "object" || typeof t == "function") for (var i = p(t), a = 0, o = i.length, s; a < o; a++) s = i[a], !h.call(e, s) && s !== n && d(e, s, {
+var m = Object.create, h = Object.defineProperty, g = Object.getOwnPropertyDescriptor, _ = Object.getOwnPropertyNames, v = Object.getPrototypeOf, y = Object.prototype.hasOwnProperty, b = (e, t) => () => (t || (e((t = { exports: {} }).exports, t), e = null), t.exports), x = (e, t, n, r) => {
+	if (t && typeof t == "object" || typeof t == "function") for (var i = _(t), a = 0, o = i.length, s; a < o; a++) s = i[a], !y.call(e, s) && s !== n && h(e, s, {
 		get: ((e) => t[e]).bind(null, s),
-		enumerable: !(r = f(t, s)) || r.enumerable
+		enumerable: !(r = g(t, s)) || r.enumerable
 	});
 	return e;
-}, v = /* @__PURE__ */ ((e, t, n) => (n = e == null ? {} : u(m(e)), _(t || !e || !e.__esModule ? d(n, "default", {
+}, S = /* @__PURE__ */ ((e, t, n) => (n = e == null ? {} : m(v(e)), x(t || !e || !e.__esModule ? h(n, "default", {
 	value: e,
 	enumerable: !0
-}) : n, e)))((/* @__PURE__ */ g(((e, t) => {
+}) : n, e)))((/* @__PURE__ */ b(((e, t) => {
 	var n = Object.prototype.hasOwnProperty, r = "~";
 	function i() {}
 	Object.create && (i.prototype = Object.create(null), new i().__proto__ || (r = !1));
@@ -99,41 +98,76 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 		var t;
 		return e ? (t = r ? r + e : e, this._events[t] && s(this, t)) : (this._events = new i(), this._eventsCount = 0), this;
 	}, c.prototype.off = c.prototype.removeListener, c.prototype.addListener = c.prototype.on, c.prefixed = r, c.EventEmitter = c, t !== void 0 && (t.exports = c);
-})))(), 1), y = class {
-	heap;
-	pool;
+})))(), 1), C = class extends S.default {
+	eid;
+	config;
+	world;
+	components = {};
 	constructor(e, t, n) {
-		this.heap = e, this.pool = new l(e, {
-			type: t,
-			dataLength: n
-		});
+		super(), this.world = e, this.eid = n ?? e.allocateEid(), n === void 0 && (this.loadComponent("entity", t ?? {}, !1), t && this.load(t));
 	}
-	get length() {
-		return this.pool.length;
+	loadComponent(e, t, n = !0) {
+		let r = this.world.registry[e], i = r.memoryComponent, a = i.create(r.toBlock(t, this)), o = r.attach(this, i, a);
+		return o.block ??= i.getBlock(a), this.components[e] = o, n && this.emit("component-added", e, o), o;
 	}
-	get rawLength() {
-		return this.pool.bufferLength;
+	attachComponent(e, t) {
+		let n = this.world.registry[e], r = n.attach(this, n.memoryComponent, t);
+		return r.block ??= n.memoryComponent.getBlock(t), this.components[e] = r, r;
 	}
-	create(e) {
-		return this.pool.push(e);
+	removeComponent(e) {
+		let t = this.components[e];
+		if (t) {
+			let n = this.world.registry[e];
+			this.world.deferComponentMemoryFree(n.memoryComponent, t.index, n.free ? () => n.free(t) : void 0), delete this.components[e], this.emit("component-removed", e);
+		}
 	}
-	getBlock(e) {
-		return this.pool.at(e);
+	setComponent(e, t, n) {
+		let r = this.components[e];
+		r && (r[t] = n, this.emit("component-property-updated", e, t, n));
 	}
-	get(e, t) {
-		return this.pool.get(e, t);
+	setComponentBulk(e, t) {
+		let n = this.components[e];
+		n && Object.assign(n, t);
 	}
-	set(e, t, n) {
-		let r = this.pool.at(e);
-		r[t] = n;
+	deleteComponent(e, t) {
+		let n = this.components[e];
+		n && (delete n[t], this.emit("component-property-deleted", e, t));
 	}
-	delete(e) {
-		this.pool.deleteIndex(e);
+	deleteAllComponentMemory() {
+		let e = this.world.registry, t = this.components;
+		for (let n of Object.keys(t)) {
+			let r = e[n], i = t[n];
+			i && this.world.deferComponentMemoryFree(r.memoryComponent, i.index, r.free ? () => r.free(i) : void 0);
+		}
 	}
-	clear() {
-		this.pool.clear();
+	load(e) {
+		let t = e, n = this.world.registry;
+		for (let r of Object.keys(n)) {
+			if (r === "entity") continue;
+			let i = n[r];
+			i.loadInFinishLoading || i.loadProperties.some((e) => e in t) && this.loadComponent(r, e, !1);
+		}
+		this.config = e;
 	}
-}, b = class extends v.default {
+	save() {
+		let e = {}, t = this.world.registry, n = this.components;
+		for (let r of Object.keys(n)) {
+			let i = t[r], a = n[r];
+			i.save && a && Object.assign(e, i.save(a));
+		}
+		return e;
+	}
+	finishLoading() {
+		let e = this.config;
+		if (!e) return;
+		let t = e, n = this.world.registry;
+		for (let r of Object.keys(n)) {
+			if (r === "entity") continue;
+			let i = n[r];
+			i.loadInFinishLoading && i.loadProperties.some((e) => e in t) && this.loadComponent(r, e, !1);
+		}
+	}
+}, w = class extends S.default {
 	world;
 	name;
 	currentDelta = 0;
@@ -153,6 +187,17 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 			return this.deltaBetweenRuns > 0 && (e = this.currentDelta % this.deltaBetweenRuns), this.run(this.currentDelta - e), this.currentDelta = e, this.firstRun = !1, this.onRunFinished(), !0;
 		} else return !1;
 	}
+	onError(e, t = {}) {
+		let n = t.entityId === void 0 ? "" : ` (entity ${t.entityId})`;
+		console.error(`Error in system ${this.name}${n}: ${e.message}`, e);
+		let r = {
+			system: this.name,
+			error: e,
+			entityId: t.entityId,
+			phase: t.phase
+		};
+		this.world.emit("system-error", r);
+	}
 	onRunFinished() {
 		this.world.notifySystemRunCompleted(this);
 	}
@@ -166,7 +211,7 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 	destroy() {
 		this.removeAllListeners();
 	}
-}, x = class extends b {
+}, T = class extends w {
 	remainingInstancesToRun = [];
 	remainingInstancesStartTime = null;
 	iterationsPerCheck;
@@ -192,15 +237,31 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 	}
 	runIterables(e, t) {
 		let n = performance.now();
-		this.beforeRunIterables();
-		for (let r = 0; r < e.length; r++) if (this.updateIterable(e[r], t), r % this.iterationsPerCheck === 0 && performance.now() - n >= this.maxMsPerFrame) {
-			this.remainingInstancesToRun = e.slice(r + 1), this.remainingInstancesStartTime = t;
+		try {
+			this.beforeRunIterables();
+		} catch (e) {
+			this.onError(e, { phase: "preRun" }), this.remainingInstancesToRun = [], this.remainingInstancesStartTime = null;
 			return;
 		}
+		for (let r = 0; r < e.length; r++) {
+			try {
+				this.updateIterable(e[r], t);
+			} catch (t) {
+				this.onError(t, {
+					phase: "update",
+					entityId: this.getIterableEntityId(e[r])
+				});
+			}
+			if (r % this.iterationsPerCheck === 0 && performance.now() - n >= this.maxMsPerFrame) {
+				this.remainingInstancesToRun = e.slice(r + 1), this.remainingInstancesStartTime = t;
+				return;
+			}
+		}
 		this.remainingInstancesToRun = [], this.remainingInstancesStartTime = null;
 	}
 	beforeRunIterables() {}
-}, S = class extends x {
+	getIterableEntityId(e) {}
+}, E = class extends T {
 	entities = /* @__PURE__ */ new Map();
 	options;
 	constructor(e, t = { name: "EntitySystem" }) {
@@ -224,6 +285,9 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 	filterEntity(e) {
 		return !e.components.entity.isStatic;
 	}
+	getIterableEntityId(e) {
+		return e.eid;
+	}
 	isEntityInSystem(e) {
 		return this.entities.has(e.eid);
 	}
@@ -236,30 +300,41 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 	shouldRun() {
 		return this.entities.size > 0;
 	}
-}, C = class {
+}, D = class {
 	onmessage(e, t = []) {}
-}, w = class extends C {
+}, O = class extends D {
 	updateFunction;
 	entities = [];
 	queryEntities = {};
 	worldExtension;
-	constructor(e) {
-		super(), this.updateFunction = e;
+	world;
+	allocator;
+	createsEntities;
+	constructor(e, t, n = !1) {
+		super(), this.updateFunction = e, this.world = t, this.createsEntities = n;
+		let r = t.registry;
+		this.allocator = {
+			allocateEid: () => t.allocateEid(),
+			allocateComponentBlock: (e, t) => r[e].memoryComponent.create(t)
+		};
 	}
 	postMessage(e) {
 		if (e.type === "init") this.onMessageTyped({ type: "init-complete" });
 		else if (e.type === "load") this.worldExtension = this.updateFunction.init?.(e.data) ?? void 0, this.onMessageTyped({ type: "loaded" });
 		else if (e.type === "reset") this.entities = [], this.queryEntities = {};
 		else if (e.type === "run") {
-			this.worldExtension && Object.assign(e.world, this.worldExtension);
-			let t = performance.now(), n = [], r = {}, i = [];
-			this.entities = a(this.entities, e.entities);
-			let o = {};
+			if (this.worldExtension && Object.assign(e.world, this.worldExtension), e.world.getString = (e) => this.world.constantStrings.getString(e) ?? "", e.world.heap = this.world.heap, e.world.allocate = this.allocator, this.createsEntities) {
+				let t = this.world.registry;
+				e.world.buildEntityDescriptor = (e) => a(e, this.world.factory.configs, t, this.allocator);
+			}
+			let t = performance.now(), n = [], r = {}, i = [], o = [];
+			this.entities = d(this.entities, e.entities);
+			let s = {};
 			Object.entries(e.queries).forEach(([e, t]) => {
-				let n = a(this.queryEntities[e] ?? [], t);
-				this.queryEntities[e] = n, o[e] = n;
+				let n = d(this.queryEntities[e] ?? [], t);
+				this.queryEntities[e] = n, s[e] = n;
 			});
-			let s = {
+			let c = {
 				entityComponentChanged(e, t, r, i) {
 					n.push({
 						entityId: e,
@@ -291,25 +366,50 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 				createEntity(e) {
 					i.push(e);
 				}
-			};
-			if (this.updateFunction.preRun && this.updateFunction.preRun(e.world, this.entities, o, s), this.entities.forEach((t) => {
-				this.updateFunction(e.world, t.entityId, t.components, o, s);
-			}), this.updateFunction.entityRemoved) for (let t of e.entities.removed) this.updateFunction.entityRemoved(e.world, t, s);
-			let c = performance.now() - t;
+			}, l = !1;
+			if (this.updateFunction.preRun) try {
+				this.updateFunction.preRun(e.world, this.entities, s, c);
+			} catch (e) {
+				l = !0, o.push({
+					error: e,
+					phase: "preRun"
+				});
+			}
+			if (l || this.entities.forEach((t) => {
+				try {
+					this.updateFunction(e.world, t.entityId, t.components, s, c);
+				} catch (e) {
+					o.push({
+						error: e,
+						phase: "update",
+						entityId: t.entityId
+					});
+				}
+			}), this.updateFunction.entityRemoved) for (let t of e.entities.removed) try {
+				this.updateFunction.entityRemoved(e.world, t, c);
+			} catch (e) {
+				o.push({
+					error: e,
+					phase: "entityRemoved",
+					entityId: t
+				});
+			}
+			let u = performance.now() - t;
 			this.onMessageTyped({
 				type: "run-complete",
 				generation: e.generation,
-				runTime: c,
+				runTime: u,
 				events: n,
 				systemEvents: r,
-				created: i
+				created: i,
+				errors: o
 			});
 		}
 	}
 	onMessageTyped(e) {
 		this.onmessage({ data: e });
 	}
-}, T = "___main", E = class extends b {
+}, k = "___main", A = class extends w {
 	entities = /* @__PURE__ */ new Map();
 	options;
 	worker;
@@ -331,16 +431,27 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 			this.removeEntity(e);
 		}), e.entities.forEach((e) => {
 			this.checkAddEntity(e);
-		}), !t.forceMainThread && globalThis.Worker !== void 0 && globalThis.SharedArrayBuffer !== void 0 ? (this.worker = t.getWorker(), this.isWorkerThread = !0) : (this.worker = new w(t.updateFunction), this.isWorkerThread = !1), this.initWorker();
+		}), !t.forceMainThread && globalThis.Worker !== void 0 && globalThis.SharedArrayBuffer !== void 0 ? (this.worker = t.getWorker(), this.isWorkerThread = !0, e.on("grow-buffer", (e) => {
+			this.worker.postMessage({
+				type: "grow-buffer",
+				buffer: e
+			});
+		})) : (this.worker = new O(t.updateFunction, e, !!t.createsEntities), this.isWorkerThread = !1), this.initWorker();
 	}
 	initWorker() {
 		this.worker.onmessage = (e) => {
 			let t = e.data;
 			if (t.type === "init-complete") this.initialized = !0, this.initPromise &&= (this.initPromise.resolve(), null);
 			else if (t.type === "loaded") this.loadingPromise &&= (this.loadingPromise.resolve(), null);
+			else if (t.type === "grow-buffer-from-worker") this.world.addGrownBuffer(t.buffer);
 			else if (t.type === "run-complete") {
 				if (t.generation !== this.generation) return;
-				this.isRunning = !1, this.world.emit(`system-${this.name}-worker-finished`, t.runTime);
+				this.isRunning = !1, this.world.emit(`system-${this.name}-worker-finished`, t.runTime), t.errors.forEach(({ error: e, entityId: t, phase: n }) => {
+					this.onError(e, {
+						entityId: t,
+						phase: n
+					});
+				});
 				for (let e of Object.keys(t.systemEvents)) this.emit(e, t.systemEvents[e]);
 				t.events.forEach((e) => {
 					let t = this.world.getEntityByEid(e.entityId);
@@ -350,7 +461,7 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 					}
 					t.emit(e.event, ...e.args);
 				}), t.created.forEach((e) => {
-					this.world.loadEntity(e);
+					this.world.adoptEntity(e);
 				}), this.world.emit(`system-${this.name}-worker-events-finished`, t.runTime), this.world.notifySystemRunCompleted(this), this.runCompletePromise &&= (this.runCompletePromise.resolve(), null);
 			}
 		}, this.worker.postMessage({ type: "init" });
@@ -372,7 +483,10 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 		};
 		let n = {
 			type: "load",
-			data: this.options.getInitData?.()
+			data: this.options.getInitData?.(),
+			heap: this.isWorkerThread ? this.world.heap.getSharedMemory() : void 0,
+			sharedMemory: this.isWorkerThread ? this.world.getSharedComponentMemory() : void 0,
+			factoryConfigs: this.isWorkerThread && this.options.createsEntities ? this.world.factory.configs : void 0
 		};
 		return this.worker.postMessage(n), e;
 	}
@@ -411,7 +525,7 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 			elapsedTime: e
 		};
 		this.addDataToWorld?.(t), this.isRunning = !0;
-		let n = this.buildQueryDelta(T, this.options), r = {};
+		let n = this.buildQueryDelta(k, this.options), r = {};
 		Object.entries(this.options.queries ?? {}).forEach(([e, t]) => {
 			r[e] = this.buildQueryDelta(e, t);
 		});
@@ -442,10 +556,10 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 		};
 	}
 	buildComponents(e, t) {
-		let n = {}, r = this.world.registry;
+		let n = {};
 		return [...t.required, ...t.optional ?? []].forEach((t) => {
-			let i = e.components[t], a = r[t].memoryComponent;
-			i && a && (n[t] = a.getBlock(i.index));
+			let r = e.components[t]?.block;
+			r && (n[t] = r);
 		}), n;
 	}
 	isEntityInSystem(e) {
@@ -473,89 +587,28 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 	}
 	checkAddEntity(e) {
 		let t = this.matchesQuery(e, this.options);
-		return this.updateEntityList(T, this.entities, e, t), Object.entries(this.options.queries ?? {}).forEach(([t, n]) => {
+		return this.updateEntityList(k, this.entities, e, t), Object.entries(this.options.queries ?? {}).forEach(([t, n]) => {
 			let r = this.queryEntities[t] ?? (this.queryEntities[t] = /* @__PURE__ */ new Map());
 			this.updateEntityList(t, r, e, this.matchesQuery(e, n));
 		}), t;
 	}
 	removeEntity(e) {
-		this.updateEntityList(T, this.entities, e, !1), Object.entries(this.queryEntities).forEach(([t, n]) => {
+		this.updateEntityList(k, this.entities, e, !1), Object.entries(this.queryEntities).forEach(([t, n]) => {
 			this.updateEntityList(t, n, e, !1);
 		});
 	}
+	recheckMembership() {
+		this.world.entities.forEach((e) => {
+			this.checkAddEntity(e);
+		});
+	}
 	shouldRun() {
 		return this.entities.size > 0;
 	}
 	destroy() {
 		super.destroy(), "terminate" in this.worker && this.worker.terminate();
 	}
-}, D = class e extends v.default {
-	static eidCounter = 1;
-	eid;
-	config;
-	world;
-	components = {};
-	constructor(t, n) {
-		super(), this.world = t, this.eid = e.eidCounter++, this.loadComponent("entity", n ?? {}, !1), n && this.load(n);
-	}
-	loadComponent(e, t, n = !0) {
-		let r = this.world.registry[e], i = r.memoryComponent, a = r.load(this, i, t);
-		return this.components[e] = a, n && this.emit("component-added", e, a), a;
-	}
-	removeComponent(e) {
-		let t = this.components[e];
-		if (t) {
-			let n = this.world.registry[e];
-			this.world.deferComponentMemoryFree(n.memoryComponent, t.index, n.free ? () => n.free(t) : void 0), delete this.components[e], this.emit("component-removed", e);
-		}
-	}
-	setComponent(e, t, n) {
-		let r = this.components[e];
-		r && (r[t] = n, this.emit("component-property-updated", e, t, n));
-	}
-	setComponentBulk(e, t) {
-		let n = this.components[e];
-		n && Object.assign(n, t);
-	}
-	deleteComponent(e, t) {
-		let n = this.components[e];
-		n && (delete n[t], this.emit("component-property-deleted", e, t));
-	}
-	deleteAllComponentMemory() {
-		let e = this.world.registry, t = this.components;
-		for (let n of Object.keys(t)) {
-			let r = e[n], i = t[n];
-			i && this.world.deferComponentMemoryFree(r.memoryComponent, i.index, r.free ? () => r.free(i) : void 0);
-		}
-	}
-	load(e) {
-		let t = e, n = this.world.registry;
-		for (let r of Object.keys(n)) {
-			if (r === "entity") continue;
-			let i = n[r];
-			i.loadInFinishLoading || i.loadProperties.some((e) => e in t) && this.loadComponent(r, e, !1);
-		}
-		this.config = e;
-	}
-	save() {
-		let e = {}, t = this.world.registry, n = this.components;
-		for (let r of Object.keys(n)) {
-			let i = t[r], a = n[r];
-			i.save && a && Object.assign(e, i.save(a));
-		}
-		return e;
-	}
-	finishLoading() {
-		let e = this.config;
-		if (!e) return;
-		let t = e, n = this.world.registry;
-		for (let r of Object.keys(n)) {
-			if (r === "entity") continue;
-			let i = n[r];
-			i.loadInFinishLoading && i.loadProperties.some((e) => e in t) && this.loadComponent(r, e, !1);
-		}
-	}
-}, O = class {
+}, j = class {
 	world;
 	configs;
 	constructor(e = {}) {
@@ -576,10 +629,12 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 		return this.world.addEntity(n, t);
 	}
 	createEntity(e) {
-		return new D(this.world, e);
+		return new C(this.world, e);
 	}
-}, k = c, A = 1e4, j = class extends v.default {
+}, M = p, N = 1e4, P = class extends S.default {
 	heap;
+	constantStrings;
+	eidCounter;
 	registry;
 	factory;
 	entities = /* @__PURE__ */ new Map();
@@ -601,19 +656,36 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 		waitElapsed: 0
 	};
 	constructor(e, t = {}) {
-		super(), this.heap = new s({ bufferSize: t.heapSize ?? k });
-		let n = {
+		super(), this.heap = new f({ bufferSize: t.heapSize ?? M }), this.constantStrings = new n(this.heap), this.eidCounter = this.heap.allocUI32(1), this.heap.addOnGrowBufferHandlers((e) => this.emit("grow-buffer", e));
+		let i = {
 			...e,
-			entity: r
-		}, i = {};
-		for (let e of Object.keys(n)) {
-			let t = n[e];
-			i[e] = {
+			entity: l
+		}, a = {};
+		for (let e of Object.keys(i)) {
+			let t = i[e];
+			a[e] = {
 				...t,
-				memoryComponent: new y(this.heap, t.type, t.size)
+				memoryComponent: new r(this.heap, t.type, t.size)
 			};
 		}
-		this.registry = i, this.factory = t.factory ?? new O(), this.factory.world = this;
+		this.registry = a, this.factory = t.factory ?? new j(), this.factory.world = this;
+	}
+	allocateEid() {
+		return Atomics.add(this.eidCounter.data, 0, 1) + 1;
+	}
+	getSharedComponentMemory() {
+		let e = {};
+		for (let t of Object.keys(this.registry)) e[t] = this.registry[t].memoryComponent.getSharedMemory();
+		return {
+			components: e,
+			eidCounter: this.eidCounter.getSharedMemory()
+		};
+	}
+	addGrownBuffer(e) {
+		this.heap.buffers[e.bufferPosition] === void 0 && this.heap.addSharedBuffer(e), this.emit("grow-buffer", e);
+	}
+	get needsSpareBuffer() {
+		return this.systems.some((e) => e instanceof A && e.isWorkerThread && !!e.options.createsEntities);
 	}
 	async init() {
 		await Promise.all(this.systems.map((e) => e.init()).filter((e) => e instanceof Promise));
@@ -633,11 +705,21 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 	loadEntity(e, t = !0) {
 		return this.factory.loadEntity(e, t);
 	}
+	adoptEntity(e) {
+		let t = new C(this, void 0, e.eid);
+		t.loadComponent("entity", {
+			type: e.type,
+			isStatic: e.isStatic
+		}, !1);
+		for (let n of Object.keys(e.components)) t.attachComponent(n, e.components[n]);
+		return this.addEntity(t, !0);
+	}
 	load(e) {
 		if (!this.pristine) {
 			for (let e of Array.from(this.entities.values())) this.removeEntity(e);
 			this.systems.forEach((e) => e.clear()), this.consolidateFreeBuffersForReload();
 		}
+		for (let e of Object.keys(this.factory.configs)) this.constantStrings.getOrCreate(e);
 		let t = e.entities.map((e) => this.loadEntity(e, !1));
 		for (let e of t) e.finishLoading(), this.emit("entity-added", e), e.on("death", () => {
 			this.onEntityDied(e);
@@ -691,9 +773,9 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 	}
 	checkFreeBufferTimeout(e) {
 		let t = this.activeFreeBuffer;
-		if (t.waitingSystems.size !== 0 && (t.waitElapsed += e, t.waitElapsed >= A)) {
+		if (t.waitingSystems.size !== 0 && (t.waitElapsed += e, t.waitElapsed >= N)) {
 			let e = Array.from(t.waitingSystems).map((e) => e.name).join(", ");
-			console.warn(`shared-memory-ecs: deferred component free waited over ${A}ms on system(s): ${e}; freeing anyway`), t.waitingSystems.clear(), this.processFreeBuffers();
+			console.warn(`shared-memory-ecs: deferred component free waited over ${N}ms on system(s): ${e}; freeing anyway`), t.waitingSystems.clear(), this.processFreeBuffers();
 		}
 	}
 	addSystem(e) {
@@ -717,7 +799,7 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 	runUpdate(e) {
 		if (this.playerTime += e, this.paused) return {};
 		let t = e;
-		e = this.timeScale * e, this.gameTime += e, this.processFreeBuffers();
+		e = this.timeScale * e, this.gameTime += e, this.processFreeBuffers(), this.needsSpareBuffer && this.heap.ensureSpareBuffer();
 		let n = null;
 		return this.systems.forEach((t) => {
 			let r = !0, i = !1, a = !1;
@@ -725,8 +807,12 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 			try {
 				r = t.shouldRun(), r && (i = t.update(e));
 			} catch (e) {
-				let t = e;
-				console.error(t.message, t), a = !0, n = t;
+				let r = e;
+				console.error(r.message, r), a = !0, n = r, this.emit("system-error", {
+					system: t.name,
+					error: r,
+					phase: "run"
+				});
 			}
 			this.emit(`system-${t.name}-finished`, {
 				ran: i,
@@ -743,12 +829,12 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 	}
 	addEntityToComponentSystem(e, t) {
 		this.systems.forEach((n) => {
-			(n instanceof S && n.options.components?.includes(t) || n instanceof E && this.componentAffectsComponentSystem(n, t)) && n.checkAddEntity(e);
+			(n instanceof E && n.options.components?.includes(t) || n instanceof A && this.componentAffectsComponentSystem(n, t)) && n.checkAddEntity(e);
 		});
 	}
 	removeEntityFromComponentSystem(e, t) {
 		this.systems.forEach((n) => {
-			n instanceof S && n.options.components?.includes(t) ? n.removeEntity(e) : n instanceof E && this.componentAffectsComponentSystem(n, t) && n.checkAddEntity(e);
+			n instanceof E && n.options.components?.includes(t) ? n.removeEntity(e) : n instanceof A && this.componentAffectsComponentSystem(n, t) && n.checkAddEntity(e);
 		});
 	}
 	componentAffectsComponentSystem(e, t) {
@@ -763,19 +849,19 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 };
 //#endregion
 //#region src/actions/kill-entity.ts
-function M(e) {
+function F(e) {
 	e.components.entity.dead = !0, e.emit("death");
 }
 //#endregion
 //#region src/performance-timing.ts
-var N = 1e3, P = {
+var I = 1e3, L = {
 	avg: 0,
 	min: 0,
 	max: 0,
 	samples: 0
 };
-function F(e) {
-	if (!e.length) return { ...P };
+function R(e) {
+	if (!e.length) return { ...L };
 	let t = 0, n = Infinity, r = 0;
 	for (let i of e) t += i, i < n && (n = i), i > r && (r = i);
 	return {
@@ -785,13 +871,13 @@ function F(e) {
 		samples: e.length
 	};
 }
-var I = class extends v.default {
+var z = class extends S.default {
 	world;
 	ticksBetweenUpdates;
 	stats = {
-		update: { ...P },
+		update: { ...L },
 		systems: [],
-		events: { ...P }
+		events: { ...L }
 	};
 	ticks = 0;
 	updateStart = 0;
@@ -808,9 +894,9 @@ var I = class extends v.default {
 		this.ticks = 0, this.updateTimes = [], this.systemTimings.forEach((e) => {
 			e.run = [], e.events = [], e.eventStart = -1;
 		}), this.stats = {
-			update: { ...P },
+			update: { ...L },
 			systems: [],
-			events: { ...P }
+			events: { ...L }
 		};
 	}
 	destroy() {
@@ -852,14 +938,14 @@ var I = class extends v.default {
 			let t = this.systemTimings.get(e.name);
 			return {
 				name: e.name,
-				run: F(t?.run ?? []),
-				events: F(t?.events ?? [])
+				run: R(t?.run ?? []),
+				events: R(t?.events ?? [])
 			};
-		}), t = { ...P };
+		}), t = { ...L };
 		e.forEach((e) => {
 			t.avg += e.events.avg, t.min += e.events.min, t.max += e.events.max, t.samples += e.events.samples;
 		}), this.stats = {
-			update: F(this.updateTimes),
+			update: R(this.updateTimes),
 			systems: e,
 			events: t
 		}, this.ticks = 0, this.updateTimes = [], this.systemTimings.forEach((e) => {
@@ -868,6 +954,6 @@ var I = class extends v.default {
 	}
 };
 //#endregion
-export { D as BaseEntity, j as BaseWorld, E as ComponentSystem, w as ComponentWebWorker, t as DEAD_INDEX, N as DEFAULT_TICKS_BETWEEN_UPDATES, O as EntityFactory, S as EntitySystem, x as IterableSystem, y as MemoryComponent, I as PerformanceTiming, e as STATIC_INDEX, b as System, C as WebWorker, o as createComponentWorker, n as createEntityWorker, r as entityDefinition, M as killEntity, i as killEntityWorker };
+export { C as BaseEntity, P as BaseWorld, t as Component, A as ComponentSystem, O as ComponentWebWorker, n as ConstantStringCache, i as DEAD_INDEX, I as DEFAULT_TICKS_BETWEEN_UPDATES, j as EntityFactory, E as EntitySystem, T as IterableSystem, r as MemoryComponent, z as PerformanceTiming, e as STATIC_INDEX, w as System, s as TYPE_INDEX, D as WebWorker, u as createComponentWorker, o as createEntityWorker, l as entityDefinition, F as killEntity, c as killEntityWorker };
 
 //# sourceMappingURL=index.js.map