@daneren2005/shared-memory-ecs 1.3.0 → 1.5.0

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-CaB32Dgn.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;
@@ -150,16 +184,23 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 	update(e) {
 		if (this.currentDelta += e, this.currentDelta >= this.deltaBetweenRuns || this.firstRun) {
 			let e = 0;
-			return this.deltaBetweenRuns > 0 && (e = this.currentDelta % this.deltaBetweenRuns), this.run(this.currentDelta - e), this.currentDelta = e, this.firstRun = !1, !0;
+			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;
 	}
+	onRunFinished() {
+		this.world.notifySystemRunCompleted(this);
+	}
+	isCurrentlyRunning() {
+		return !1;
+	}
+	waitForRunToComplete() {}
 	shouldRun() {
 		return !0;
 	}
 	destroy() {
 		this.removeAllListeners();
 	}
-}, x = class extends b {
+}, T = class extends w {
 	remainingInstancesToRun = [];
 	remainingInstancesStartTime = null;
 	iterationsPerCheck;
@@ -171,12 +212,18 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 		super.clear(), this.remainingInstancesToRun = [], this.remainingInstancesStartTime = null;
 	}
 	update(e) {
-		return this.remainingInstancesToRun.length ? (this.runIterables(this.remainingInstancesToRun, this.remainingInstancesStartTime ?? 0), this.currentDelta += e, !0) : super.update(e);
+		return this.remainingInstancesToRun.length ? (this.runIterables(this.remainingInstancesToRun, this.remainingInstancesStartTime ?? 0), this.currentDelta += e, this.remainingInstancesToRun.length || this.onRunFinished(), !0) : super.update(e);
 	}
 	run(e) {
 		let t = this.getIterables();
 		this.runIterables(t, e);
 	}
+	onRunFinished() {
+		this.remainingInstancesToRun.length || super.onRunFinished();
+	}
+	isCurrentlyRunning() {
+		return this.remainingInstancesToRun.length > 0;
+	}
 	runIterables(e, t) {
 		let n = performance.now();
 		this.beforeRunIterables();
@@ -187,7 +234,7 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 		this.remainingInstancesToRun = [], this.remainingInstancesStartTime = null;
 	}
 	beforeRunIterables() {}
-}, S = class extends x {
+}, E = class extends T {
 	entities = /* @__PURE__ */ new Map();
 	options;
 	constructor(e, t = { name: "EntitySystem" }) {
@@ -223,27 +270,38 @@ 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);
+			if (this.worldExtension && Object.assign(e.world, this.worldExtension), e.world.getString = (e) => this.world.constantStrings.getString(e) ?? "", 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 = [];
-			this.entities = a(this.entities, e.entities);
+			this.entities = d(this.entities, e.entities);
 			let o = {};
 			Object.entries(e.queries).forEach(([e, t]) => {
-				let n = a(this.queryEntities[e] ?? [], t);
+				let n = d(this.queryEntities[e] ?? [], t);
 				this.queryEntities[e] = n, o[e] = n;
 			});
 			let s = {
@@ -296,7 +354,7 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 	onMessageTyped(e) {
 		this.onmessage({ data: e });
 	}
-}, T = "___main", E = class extends b {
+}, k = "___main", A = class extends w {
 	entities = /* @__PURE__ */ new Map();
 	options;
 	worker;
@@ -304,6 +362,7 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 	initialized = !1;
 	initPromise = null;
 	loadingPromise = null;
+	runCompletePromise = null;
 	isRunning = !1;
 	generation = 0;
 	queryEntities = {};
@@ -317,13 +376,19 @@ 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);
@@ -336,8 +401,8 @@ 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.emit(`system-${this.name}-worker-events-finished`, t.runTime);
+					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" });
 	}
@@ -358,23 +423,49 @@ 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;
 	}
 	clear() {
-		super.clear(), this.isRunning = !1, this.generation++, this.entities.clear(), Object.values(this.queryEntities).forEach((e) => e.clear()), this.queryDeltas = {}, this.worker.postMessage({ type: "reset" });
+		if (super.clear(), this.isRunning && !this.runCompletePromise) {
+			let { promise: e, resolve: t } = Promise.withResolvers();
+			this.runCompletePromise = {
+				promise: e,
+				resolve: t
+			};
+		}
+		this.isRunning = !1, this.generation++, this.entities.clear(), Object.values(this.queryEntities).forEach((e) => e.clear()), this.queryDeltas = {}, this.worker.postMessage({ type: "reset" });
 	}
 	update(e) {
 		return this.isRunning ? (this.currentDelta += e, !1) : super.update(e);
 	}
+	onRunFinished() {}
+	isCurrentlyRunning() {
+		return this.isRunning;
+	}
+	waitForRunToComplete() {
+		if (this.isRunning) {
+			if (!this.runCompletePromise) {
+				let { promise: e, resolve: t } = Promise.withResolvers();
+				this.runCompletePromise = {
+					promise: e,
+					resolve: t
+				};
+			}
+			return this.runCompletePromise.promise;
+		}
+	}
 	run(e) {
 		let t = {
 			gameTime: this.world.gameTime,
 			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);
 		});
@@ -405,10 +496,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) {
@@ -436,86 +527,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];
-		t && (this.world.registry[e].memoryComponent.delete(t.index), 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;
-		for (let t of Object.keys(this.components)) {
-			let n = this.components[t];
-			n && e[t].memoryComponent.delete(n.index);
-		}
-	}
-	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 = {}) {
@@ -536,10 +569,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 = class extends v.default {
+}, M = p, N = 1e4, P = class extends S.default {
 	heap;
+	constantStrings;
+	eidCounter;
 	registry;
 	factory;
 	entities = /* @__PURE__ */ new Map();
@@ -549,20 +584,45 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 	timeScale = 1;
 	paused = !1;
 	destroyed = !1;
+	pristine = !0;
+	activeFreeBuffer = {
+		frees: [],
+		waitingSystems: /* @__PURE__ */ new Set(),
+		waitElapsed: 0
+	};
+	nextFreeBuffer = {
+		frees: [],
+		waitingSystems: /* @__PURE__ */ new Set(),
+		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);
 	}
 	async init() {
 		await Promise.all(this.systems.map((e) => e.init()).filter((e) => e instanceof Promise));
@@ -571,7 +631,7 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 		return Promise.all(this.systems.map((e) => e.finishLoading()).filter((e) => e instanceof Promise));
 	}
 	addEntity(e, t = !0) {
-		return this.entities.set(e.eid, e), e.world = this, e.on("component-added", (t) => {
+		return this.entities.set(e.eid, e), e.world = this, this.pristine = !1, e.on("component-added", (t) => {
 			this.addEntityToComponentSystem(e, t);
 		}), e.on("component-removed", (t) => {
 			this.removeEntityFromComponentSystem(e, t);
@@ -582,15 +642,33 @@ 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) {
-		for (let e of Array.from(this.entities.values())) this.removeEntity(e);
-		this.systems.forEach((e) => e.clear());
+		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);
 		});
 		this.gameTime = e.gameTime ?? 0, this.playerTime = e.playerTime ?? 0, this.timeScale = e.timeScale ?? 1, this.finishLoadingSystems();
 	}
+	async clear() {
+		if (!this.pristine) {
+			for (let e of Array.from(this.entities.values())) this.removeEntity(e);
+			this.systems.forEach((e) => e.clear()), await Promise.all(this.systems.map((e) => e.waitForRunToComplete()).filter((e) => e instanceof Promise)), this.freeAllPendingBuffers(), this.pristine = !0;
+		}
+	}
 	removeEntity(e) {
 		this.entities.delete(e.eid) && this.emit("entity-removed", e), e.deleteAllComponentMemory();
 	}
@@ -600,6 +678,43 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 	getEntityByEid(e) {
 		return this.entities.get(e);
 	}
+	deferComponentMemoryFree(e, t, n) {
+		this.nextFreeBuffer.frees.push({
+			memoryComponent: e,
+			index: t,
+			free: n
+		});
+	}
+	notifySystemRunCompleted(e) {
+		this.activeFreeBuffer.waitingSystems.delete(e) && this.activeFreeBuffer.waitingSystems.size === 0 && this.processFreeBuffers();
+	}
+	processFreeBuffers() {
+		for (; this.activeFreeBuffer.waitingSystems.size === 0 && (this.activeFreeBuffer.frees.length > 0 && this.performFrees(this.activeFreeBuffer), this.nextFreeBuffer.frees.length !== 0);) this.promoteNextFreeBuffer();
+	}
+	promoteNextFreeBuffer() {
+		let e = this.activeFreeBuffer;
+		this.activeFreeBuffer = this.nextFreeBuffer, this.nextFreeBuffer = e;
+		let t = this.activeFreeBuffer;
+		t.waitElapsed = 0, t.waitingSystems.clear();
+		for (let e of this.systems) (e.shouldRun() || e.isCurrentlyRunning()) && t.waitingSystems.add(e);
+	}
+	consolidateFreeBuffersForReload() {
+		this.activeFreeBuffer.frees.length > 0 && (this.nextFreeBuffer.frees.push(...this.activeFreeBuffer.frees), this.activeFreeBuffer.frees.length = 0), this.activeFreeBuffer.waitingSystems.clear(), this.activeFreeBuffer.waitElapsed = 0;
+	}
+	freeAllPendingBuffers() {
+		this.performFrees(this.activeFreeBuffer), this.performFrees(this.nextFreeBuffer), this.activeFreeBuffer.waitingSystems.clear(), this.activeFreeBuffer.waitElapsed = 0, this.nextFreeBuffer.waitingSystems.clear(), this.nextFreeBuffer.waitElapsed = 0;
+	}
+	performFrees(e) {
+		for (let t of e.frees) t.free?.(), t.memoryComponent.delete(t.index);
+		e.frees.length = 0;
+	}
+	checkFreeBufferTimeout(e) {
+		let t = this.activeFreeBuffer;
+		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 ${N}ms on system(s): ${e}; freeing anyway`), t.waitingSystems.clear(), this.processFreeBuffers();
+		}
+	}
 	addSystem(e) {
 		return this.systems.push(e), this.emit("system-added", e), e;
 	}
@@ -620,23 +735,24 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 	}
 	runUpdate(e) {
 		if (this.playerTime += e, this.paused) return {};
-		e = this.timeScale * e, this.gameTime += e;
-		let t = null;
-		return this.systems.forEach((n) => {
+		let t = e;
+		e = this.timeScale * e, this.gameTime += e, this.processFreeBuffers();
+		let n = null;
+		return this.systems.forEach((t) => {
 			let r = !0, i = !1, a = !1;
-			this.emit(`system-${n.name}-started`);
+			this.emit(`system-${t.name}-started`);
 			try {
-				r = n.shouldRun(), r && (i = n.update(e));
+				r = t.shouldRun(), r && (i = t.update(e));
 			} catch (e) {
-				let n = e;
-				console.error(n.message, n), a = !0, t = n;
+				let t = e;
+				console.error(t.message, t), a = !0, n = t;
 			}
-			this.emit(`system-${n.name}-finished`, {
+			this.emit(`system-${t.name}-finished`, {
 				ran: i,
 				shouldRun: r,
 				failed: a
 			});
-		}), { lastSystemError: t };
+		}), this.checkFreeBufferTimeout(t), { lastSystemError: n };
 	}
 	pause() {
 		this.paused = !0;
@@ -646,12 +762,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) {
@@ -666,19 +782,19 @@ var u = Object.create, d = Object.defineProperty, f = Object.getOwnPropertyDescr
 };
 //#endregion
 //#region src/actions/kill-entity.ts
-function j(e) {
+function F(e) {
 	e.components.entity.dead = !0, e.emit("death");
 }
 //#endregion
 //#region src/performance-timing.ts
-var M = 1e3, N = {
+var I = 1e3, L = {
 	avg: 0,
 	min: 0,
 	max: 0,
 	samples: 0
 };
-function P(e) {
-	if (!e.length) return { ...N };
+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 {
@@ -688,13 +804,13 @@ function P(e) {
 		samples: e.length
 	};
 }
-var F = class extends v.default {
+var z = class extends S.default {
 	world;
 	ticksBetweenUpdates;
 	stats = {
-		update: { ...N },
+		update: { ...L },
 		systems: [],
-		events: { ...N }
+		events: { ...L }
 	};
 	ticks = 0;
 	updateStart = 0;
@@ -711,9 +827,9 @@ var F = class extends v.default {
 		this.ticks = 0, this.updateTimes = [], this.systemTimings.forEach((e) => {
 			e.run = [], e.events = [], e.eventStart = -1;
 		}), this.stats = {
-			update: { ...N },
+			update: { ...L },
 			systems: [],
-			events: { ...N }
+			events: { ...L }
 		};
 	}
 	destroy() {
@@ -755,14 +871,14 @@ var F = class extends v.default {
 			let t = this.systemTimings.get(e.name);
 			return {
 				name: e.name,
-				run: P(t?.run ?? []),
-				events: P(t?.events ?? [])
+				run: R(t?.run ?? []),
+				events: R(t?.events ?? [])
 			};
-		}), t = { ...N };
+		}), 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: P(this.updateTimes),
+			update: R(this.updateTimes),
 			systems: e,
 			events: t
 		}, this.ticks = 0, this.updateTimes = [], this.systemTimings.forEach((e) => {
@@ -771,6 +887,6 @@ var F = class extends v.default {
 	}
 };
 //#endregion
-export { D as BaseEntity, A as BaseWorld, E as ComponentSystem, w as ComponentWebWorker, t as DEAD_INDEX, M as DEFAULT_TICKS_BETWEEN_UPDATES, O as EntityFactory, S as EntitySystem, x as IterableSystem, y as MemoryComponent, F as PerformanceTiming, e as STATIC_INDEX, b as System, C as WebWorker, o as createComponentWorker, n as createEntityWorker, r as entityDefinition, j 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