@daneren2005/shared-memory-ecs 1.10.2 → 1.10.4

package/dist/index.js

@@ -1,17 +1,17 @@
-import { _ as e, a as t, c as n, d as r, f as i, g as a, h as o, i as s, l as c, m as l, n as u, o as d, p as f, r as p, s as m, t as h, u as ee, v as g, y as _ } from "./create-system-worker-BU5CnyVh.js";
-import te from "@daneren2005/shared-memory-objects/memory-heap";
-import { MAX_BYTE_OFFSET_LENGTH as v } from "@daneren2005/shared-memory-objects/utils/pointer";
+import { _ as e, a as t, c as n, d as r, f as i, g as a, h as o, i as s, l as c, m as l, n as u, o as d, p as f, r as p, s as ee, t as te, u as ne, v as m, y as h } from "./create-system-worker-BU5CnyVh.js";
+import re from "@daneren2005/shared-memory-objects/memory-heap";
+import { MAX_BYTE_OFFSET_LENGTH as ie } from "@daneren2005/shared-memory-objects/utils/pointer";
 //#region \0rolldown/runtime.js
-var y = Object.create, b = Object.defineProperty, ne = Object.getOwnPropertyDescriptor, re = Object.getOwnPropertyNames, ie = Object.getPrototypeOf, x = Object.prototype.hasOwnProperty, ae = (e, t) => () => (t || (e((t = { exports: {} }).exports, t), e = null), t.exports), oe = (e, t, n, r) => {
-	if (t && typeof t == "object" || typeof t == "function") for (var i = re(t), a = 0, o = i.length, s; a < o; a++) s = i[a], !x.call(e, s) && s !== n && b(e, s, {
+var ae = Object.create, g = Object.defineProperty, _ = Object.getOwnPropertyDescriptor, oe = Object.getOwnPropertyNames, v = Object.getPrototypeOf, y = Object.prototype.hasOwnProperty, b = (e, t) => () => (t || (e((t = { exports: {} }).exports, t), e = null), t.exports), se = (e, t, n, r) => {
+	if (t && typeof t == "object" || typeof t == "function") for (var i = oe(t), a = 0, o = i.length, s; a < o; a++) s = i[a], !y.call(e, s) && s !== n && g(e, s, {
 		get: ((e) => t[e]).bind(null, s),
-		enumerable: !(r = ne(t, s)) || r.enumerable
+		enumerable: !(r = _(t, s)) || r.enumerable
 	});
 	return e;
-}, S = /* @__PURE__ */ ((e, t, n) => (n = e == null ? {} : y(ie(e)), oe(t || !e || !e.__esModule || !x.call(e, "default") ? b(n, "default", {
+}, x = /* @__PURE__ */ ((e, t, n) => (n = e == null ? {} : ae(v(e)), se(t || !e || !e.__esModule || !y.call(e, "default") ? g(n, "default", {
 	value: e,
 	enumerable: !0
-}) : n, e)))((/* @__PURE__ */ ae(((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));
@@ -98,7 +98,7 @@ var y = Object.create, b = Object.defineProperty, ne = Object.getOwnPropertyDesc
 		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), C = class extends S.default {
+})))(), 1), S = class extends x.default {
 	world;
 	name;
 	currentDelta = 0;
@@ -174,13 +174,13 @@ var y = Object.create, b = Object.defineProperty, ne = Object.getOwnPropertyDesc
 		this.removeAllListeners();
 	}
 };
-function w(e, t, n) {
+function C(e, t, n) {
 	let r = e.groups.map(t);
 	for (let t = 0; t < e.entities.length; t++) r[e.groupIndexes[t]] && n(e.entities[t]);
 }
 //#endregion
 //#region src/systems/iterable-system.ts
-var T = class extends C {
+var w = class extends S {
 	remainingInstancesToRun = [];
 	remainingInstancesStartTime = null;
 	iterationsPerCheck;
@@ -230,7 +230,7 @@ var T = class extends C {
 	}
 	beforeRunIterables() {}
 	getIterableEntityId(e) {}
-}, E = class e extends T {
+}, T = class e extends w {
 	entities = /* @__PURE__ */ new Map();
 	options;
 	constructor(e, t = { name: "EntitySystem" }) {
@@ -268,7 +268,7 @@ var T = class extends C {
 			t.entities.forEach((e) => this.onEntityAdded(e));
 			return;
 		}
-		w(t, (e) => this.hasComponents(e), (e) => {
+		C(t, (e) => this.hasComponents(e), (e) => {
 			this.filterEntity(e) && (this.entities.set(e.eid, e), this.options.updateEntityOnAdd && this.updateEntity(e, 0));
 		});
 	}
@@ -300,9 +300,9 @@ var T = class extends C {
 			...this.reads ?? []
 		] : void 0;
 	}
-}, D = class {
+}, E = class {
 	onmessage(e, t = []) {}
-}, O = class extends D {
+}, D = class extends E {
 	updateFunction;
 	entities = new e();
 	workState = new a();
@@ -461,7 +461,7 @@ var T = class extends C {
 	onMessageTyped(e) {
 		this.onmessage({ data: e });
 	}
-}, k = "___main", A = class e extends C {
+}, O = "___main", k = class e extends S {
 	entities = /* @__PURE__ */ new Map();
 	options;
 	worker;
@@ -494,13 +494,13 @@ var T = class extends C {
 				type: "grow-buffer",
 				buffer: e
 			});
-		})) : (this.worker = new O(t.updateFunction, e, !!t.createsEntities, !!t.addsComponents), this.isWorkerThread = !1), this.initWorker();
+		})) : (this.worker = new D(t.updateFunction, e, !!t.createsEntities, !!t.addsComponents), this.isWorkerThread = !1), this.initWorker();
 	}
 	initWorker() {
 		let e = (e) => {
 			console.error(e, e.cause), this.initialized || (this.initError = e, this.initPromise?.reject(e));
 		};
-		if (!(this.worker instanceof O)) {
+		if (!(this.worker instanceof D)) {
 			let t = (t) => {
 				e(Error(`Worker ${this.name} failed to load`, { cause: t }));
 			};
@@ -514,7 +514,7 @@ var T = class extends C {
 			else if (n.type === "grow-buffer-from-worker") this.world.addGrownBuffer(n.buffer);
 			else if (n.type === "run-complete") {
 				if (n.generation !== this.generation) {
-					this.world.scheduler.prepareEffects && this.discardWorkerAllocations(n);
+					this.world.scheduler.prepareEffects && this.discardWorkerAllocations(n), this.world.notifyAbandonedRunFinished(this);
 					return;
 				}
 				let e = this.timingBatch && {
@@ -605,7 +605,7 @@ var T = class extends C {
 			type: "load",
 			data: this.options.getInitData?.(),
 			gameTime: this.gameTime,
-			entities: this.buildQueryDelta(k, this.options),
+			entities: this.buildQueryDelta(O, this.options),
 			queries: n,
 			heap: this.isWorkerThread ? this.world.heap.getSharedMemory() : void 0,
 			sharedMemory: this.isWorkerThread ? this.world.getSharedComponentMemory() : void 0,
@@ -705,7 +705,7 @@ var T = class extends C {
 			first: t.first,
 			last: t.last
 		}, this.isRunning = !0, this.completeEffects = this.world.scheduler.prepareEffects?.(this.world, this);
-		let i = this.buildQueryDelta(k, this.options), a = {};
+		let i = this.buildQueryDelta(O, this.options), a = {};
 		Object.entries(this.options.queries ?? {}).forEach(([e, t]) => {
 			a[e] = this.buildQueryDelta(e, t);
 		});
@@ -774,7 +774,7 @@ var T = class extends C {
 	}
 	checkAddEntity(e) {
 		let t = this.tracksMainQuery && this.matchesQuery(e, this.options);
-		return this.updateEntityList(k, this.entities, e, t), Object.entries(this.options.queries ?? {}).forEach(([t, n]) => {
+		return this.updateEntityList(O, 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;
@@ -784,19 +784,19 @@ var T = class extends C {
 			t.entities.forEach((e) => this.checkAddEntity(e));
 			return;
 		}
-		this.tracksMainQuery && this.addBatchToQuery(k, this.entities, this.options, t), Object.entries(this.options.queries ?? {}).forEach(([e, n]) => {
+		this.tracksMainQuery && this.addBatchToQuery(O, this.entities, this.options, t), Object.entries(this.options.queries ?? {}).forEach(([e, n]) => {
 			let r = this.queryEntities[e] ?? (this.queryEntities[e] = /* @__PURE__ */ new Map());
 			this.addBatchToQuery(e, r, n, t);
 		});
 	}
 	addBatchToQuery(e, t, n, r) {
 		let i = this.getQueryDelta(e);
-		w(r, (e) => this.matchesComponents(e, n), (e) => {
+		C(r, (e) => this.matchesComponents(e, n), (e) => {
 			e.components.entity.dead || n.filter && !n.filter(e) || (t.set(e.eid, e), this.markAdded(i, e));
 		});
 	}
 	removeEntity(e) {
-		this.updateEntityList(k, this.entities, e, !1), Object.entries(this.queryEntities).forEach(([t, n]) => {
+		this.updateEntityList(O, this.entities, e, !1), Object.entries(this.queryEntities).forEach(([t, n]) => {
 			this.updateEntityList(t, n, e, !1);
 		});
 	}
@@ -811,7 +811,7 @@ var T = class extends C {
 	destroy() {
 		super.destroy(), this.pendingEffects?.discard(), "terminate" in this.worker && this.worker.terminate();
 	}
-}, j = class extends S.default {
+}, A = class extends x.default {
 	eid;
 	config;
 	world;
@@ -912,7 +912,7 @@ var T = class extends C {
 	assertComponentPropertyMutable(e, t) {
 		if (e === "entity" && (t === "type" || t === "class")) throw Error(`Entity ${t} is immutable`);
 	}
-}, M = class e {
+}, j = class e {
 	world;
 	configs;
 	classes;
@@ -929,7 +929,7 @@ var T = class extends C {
 		this.world = e, this.forbiddenProperties.clear();
 		for (let t of Object.keys(this.classes)) {
 			let n = this.classes[t].entity;
-			if (n !== j && !(n.prototype instanceof j)) throw Error(`Entity class ${t} must extend BaseEntity`);
+			if (n !== A && !(n.prototype instanceof A)) throw Error(`Entity class ${t} must extend BaseEntity`);
 			for (let n of this.classes[t].components) if (n === "entity" || !(n in e.registry)) throw Error(`Entity class ${t} contains unknown or reserved component ${n}`);
 		}
 		for (let e of Object.keys(this.configs)) this.validateTemplate(e, this.configs[e]);
@@ -955,7 +955,7 @@ var T = class extends C {
 	createAdoptedEntity(e, t, n) {
 		if (!t) {
 			if (this.hasClasses) throw Error(`Entity type ${e} has no class`);
-			return new j(this.world, void 0, n);
+			return new A(this.world, void 0, n);
 		}
 		let r = this.classes[t];
 		if (!r) throw Error(`Unknown entity class: ${t}`);
@@ -981,7 +981,7 @@ var T = class extends C {
 		return e ? this.getAllowedComponents(e) : void 0;
 	}
 	createEntity(e) {
-		return new j(this.world, e);
+		return new A(this.world, e);
 	}
 	get hasClasses() {
 		return this.allowedComponents.size > 0;
@@ -1046,48 +1046,48 @@ var T = class extends C {
 		}
 		throw Error(`Entity type ${e} class ${t} loads a component outside its class`);
 	}
-}, N = 45, P = "!", F = "#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNO", I = "PQRSTUVWXYZ[]^_`abcdefghijklmnopqrstuvwxyz{|}", L = (/* @__PURE__ */ new Int8Array(128)).fill(-1);
-for (let e = 0; e < N; e++) L[F.charCodeAt(e)] = e, L[I.charCodeAt(e)] = e + N;
-function R(e) {
+}, M = 45, N = "!", P = "#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNO", F = "PQRSTUVWXYZ[]^_`abcdefghijklmnopqrstuvwxyz{|}", I = (/* @__PURE__ */ new Int8Array(128)).fill(-1);
+for (let e = 0; e < M; e++) I[P.charCodeAt(e)] = e, I[F.charCodeAt(e)] = e + M;
+function L(e) {
 	let t = "";
-	for (; e >= N;) t += I[e % N], e = Math.floor(e / N);
-	return t + F[e];
+	for (; e >= M;) t += F[e % M], e = Math.floor(e / M);
+	return t + P[e];
 }
-var z = /* @__PURE__ */ new Float32Array(1), B = new Uint32Array(z.buffer);
-function se(e, t) {
+var R = /* @__PURE__ */ new Float32Array(1), z = new Uint32Array(R.buffer);
+function ce(e, t) {
 	switch (e.type) {
-		case "boolean": return typeof t == "boolean" ? F[Number(t)] : void 0;
-		case "string": return t === null ? F[0] : typeof t == "string" && t.length ? R(t.length) + t : void 0;
-		case "float32": return typeof t != "number" || !Number.isFinite(t) || Math.fround(t) !== t ? void 0 : (z[0] = t, R(B[0]));
+		case "boolean": return typeof t == "boolean" ? P[Number(t)] : void 0;
+		case "string": return t === null ? P[0] : typeof t == "string" && t.length ? L(t.length) + t : void 0;
+		case "float32": return typeof t != "number" || !Number.isFinite(t) || Math.fround(t) !== t ? void 0 : (R[0] = t, L(z[0]));
 		default: {
-			let n = V(e, t);
-			return n === void 0 ? void 0 : R(n);
+			let n = le(e, t);
+			return n === void 0 ? void 0 : L(n);
 		}
 	}
 }
-function V(e, t) {
+function le(e, t) {
 	if (typeof t != "number") return;
 	let n = Math.round((t - (e.offset ?? 0)) * 10 ** (e.decimals ?? 0) / (e.step ?? 1));
-	if (!Number.isSafeInteger(n) || H(e, n) !== t) return;
+	if (!Number.isSafeInteger(n) || B(e, n) !== t) return;
 	if (e.type === "uint") return n >= 0 ? n : void 0;
 	let r = n >= 0 ? n * 2 : -n * 2 - 1;
 	return Number.isSafeInteger(r) ? r : void 0;
 }
-function H(e, t) {
+function B(e, t) {
 	return t * (e.step ?? 1) / 10 ** (e.decimals ?? 0) + (e.offset ?? 0);
 }
-function U(e, t) {
+function V(e, t) {
 	switch (e.type) {
 		case "boolean": return t !== 0;
-		case "float32": return B[0] = t, z[0];
-		case "uint": return H(e, t);
-		default: return H(e, t % 2 == 0 ? t / 2 : -(t + 1) / 2);
+		case "float32": return z[0] = t, R[0];
+		case "uint": return B(e, t);
+		default: return B(e, t % 2 == 0 ? t / 2 : -(t + 1) / 2);
 	}
 }
-function W(e) {
+function H(e) {
 	return e.types === void 0 ? [e.type] : e.types;
 }
-var G = class {
+var U = class {
 	encoders = /* @__PURE__ */ new Map();
 	used = /* @__PURE__ */ new Set();
 	constructor(e) {
@@ -1098,10 +1098,10 @@ var G = class {
 				definition: n,
 				indices: new Map(n.properties.map((e, t) => [e.name, t]))
 			};
-			for (let r of W(n)) {
+			for (let r of H(n)) {
 				if (this.encoders.has(r)) throw Error(`Duplicate compressed entity definition for ${r}`);
 				this.encoders.set(r, {
-					prefix: R(t++),
+					prefix: L(t++),
 					group: e
 				});
 			}
@@ -1129,25 +1129,25 @@ var G = class {
 			if (r === "type" || i === void 0) continue;
 			let t = e.group.indices.get(r);
 			if (t === void 0) return;
-			let a = se(e.group.definition.properties[t], i);
+			let a = ce(e.group.definition.properties[t], i);
 			if (a === void 0) return;
 			n[t] = a;
 		}
 		let r = e.prefix;
-		for (let e = 0; e < n.length; e++) r += n[e] ?? P;
+		for (let e = 0; e < n.length; e++) r += n[e] ?? N;
 		return r;
 	}
 };
-function ce(e, t) {
-	return new G(t).compressAll(e);
+function ue(e, t) {
+	return new U(t).compressAll(e);
 }
-var K = /* @__PURE__ */ new WeakMap();
-function le(e) {
-	let t = K.get(e);
+var W = /* @__PURE__ */ new WeakMap();
+function de(e) {
+	let t = W.get(e);
 	if (t) return t;
 	t = /* @__PURE__ */ new Map();
 	for (let [n, r] of Object.entries(e)) {
-		let e = W(r);
+		let e = H(r);
 		for (let i = 0; i < e.length; i++) {
 			if (t.has(Number(n) + i)) throw Error(`Compressed entity definitions overlap at key ${Number(n) + i}`);
 			t.set(Number(n) + i, {
@@ -1156,23 +1156,23 @@ function le(e) {
 			});
 		}
 	}
-	return K.set(e, t), t;
+	return W.set(e, t), t;
 }
-function q(e, t) {
+function G(e, t) {
 	let n = 0, r = () => {
-		if (e[n] === P) {
+		if (e[n] === N) {
 			n++;
 			return;
 		}
 		let t = 0, r = 1;
 		for (; n < e.length;) {
-			let i = e.charCodeAt(n++), a = i < 128 ? L[i] : -1;
+			let i = e.charCodeAt(n++), a = i < 128 ? I[i] : -1;
 			if (a < 0) throw Error(`Invalid compressed entity ${e}`);
-			if (a < N) return t + a * r;
-			t += (a - N) * r, r *= N;
+			if (a < M) return t + a * r;
+			t += (a - M) * r, r *= M;
 		}
 		throw Error(`Truncated compressed entity ${e}`);
-	}, i = r(), a = i === void 0 ? void 0 : le(t).get(i);
+	}, i = r(), a = i === void 0 ? void 0 : de(t).get(i);
 	if (!a) throw Error(`No compressed entity definition for ${e}`);
 	let o = { type: a.type };
 	for (let t = 0; n < e.length; t++) {
@@ -1180,7 +1180,7 @@ function q(e, t) {
 		if (!i) throw Error(`Compressed entity ${e} has more values than ${a.type} defines`);
 		let s = r();
 		if (s !== void 0) {
-			if (i.type !== "string") o[i.name] = U(i, s);
+			if (i.type !== "string") o[i.name] = V(i, s);
 			else if (s === 0) o[i.name] = null;
 			else {
 				if (n + s > e.length) throw Error(`Truncated compressed entity ${e}`);
@@ -1190,23 +1190,24 @@ function q(e, t) {
 	}
 	return o;
 }
-function J(e, t) {
-	return e.map((e) => {
-		if (typeof e != "string") return e;
-		if (!t) throw Error("Compressed entities need entityDefinitions to load");
-		return q(e, t);
-	});
+function fe(e, t) {
+	return e.map((e) => K(e, t));
+}
+function K(e, t) {
+	if (typeof e != "string") return e;
+	if (!t) throw Error("Compressed entities need entityDefinitions to load");
+	return G(e, t);
 }
 //#endregion
 //#region src/scheduling/default-scheduler.ts
-var Y = class {
+var q = class {
 	update(e, t) {
 		let n = null;
 		return e.systems.forEach((r) => {
 			let i = !0, a = !1, o = !1;
 			e.emit(`system-${r.name}-started`);
 			try {
-				i = r.shouldRun(), i ? a = r.update(t) : e.systemSkipped?.(r);
+				i = r.shouldRun(), i && (a = r.update(t));
 			} catch (t) {
 				let i = t;
 				console.error(i.message, i), o = !0, n = i, e.emit("system-error", {
@@ -1222,7 +1223,24 @@ var Y = class {
 			});
 		}), { lastSystemError: n };
 	}
-}, ue = v, X = 1e4, de = class extends S.default {
+}, pe = ie, J = 1e4, me = {
+	entities: {
+		start: 0,
+		weight: .6
+	},
+	linking: {
+		start: .6,
+		weight: .1
+	},
+	systems: {
+		start: .7,
+		weight: .1
+	},
+	workers: {
+		start: .8,
+		weight: .2
+	}
+}, Y = 256, he = class extends x.default {
 	heap;
 	constantStrings;
 	eidCounter;
@@ -1238,6 +1256,8 @@ var Y = class {
 	destroyed = !1;
 	pristine = !0;
 	isBulkLoading = !1;
+	isLoading = !1;
+	activeLoad;
 	activeFreeBuffer = {
 		frees: [],
 		waitingSystems: /* @__PURE__ */ new Set(),
@@ -1250,7 +1270,7 @@ var Y = class {
 	};
 	clearing = !1;
 	constructor(e, t = {}) {
-		super(), this.scheduler = t.scheduler ?? new Y(), this.heap = new te({ bufferSize: t.heapSize ?? ue }), this.constantStrings = new g(this.heap), this.eidCounter = this.heap.allocUI32(1), this.heap.addOnGrowBufferHandlers((e) => this.emit("grow-buffer", e));
+		super(), this.scheduler = t.scheduler ?? new q(), this.heap = new re({ bufferSize: t.heapSize ?? pe }), this.constantStrings = new m(this.heap), this.eidCounter = this.heap.allocUI32(1), this.heap.addOnGrowBufferHandlers((e) => this.emit("grow-buffer", e));
 		let n = {
 			...e,
 			entity: i
@@ -1259,10 +1279,10 @@ var Y = class {
 			let t = n[e];
 			r[e] = {
 				...t,
-				memoryComponent: new _(this.heap, t.type, t.size)
+				memoryComponent: new h(this.heap, t.type, t.size)
 			};
 		}
-		this.registry = r, this.factory = t.factory ?? new M(), this.factory.setWorld(this);
+		this.registry = r, this.factory = t.factory ?? new j(), this.factory.setWorld(this);
 	}
 	allocateEid() {
 		return Atomics.add(this.eidCounter.data, 0, 1) + 1;
@@ -1279,14 +1299,11 @@ var Y = class {
 		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 || !!e.options.addsComponents));
+		return this.systems.some((e) => e instanceof k && e.isWorkerThread && (!!e.options.createsEntities || !!e.options.addsComponents));
 	}
 	async init() {
 		await Promise.all(this.systems.map((e) => e.init()).filter((e) => e instanceof Promise));
 	}
-	async finishLoadingSystems() {
-		await 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, this.pristine = !1, e.on("component-added", (t) => {
 			this.addEntityToEntityWorkerSystem(e, t);
@@ -1319,27 +1336,81 @@ var Y = class {
 			throw r;
 		}
 	}
-	load(e) {
-		if (!this.pristine || this.scheduler.prepareEffects && this.systems.some((e) => e.isCurrentlyRunning())) {
+	load(e, t = {}) {
+		if (this.abortActiveLoad(), !this.pristine || this.scheduler.prepareEffects && this.systems.some((e) => e.isCurrentlyRunning())) {
+			let e = this.systems.filter((e) => e.isCurrentlyRunning());
 			for (let e of Array.from(this.entities.values())) this.removeEntity(e);
-			this.systems.forEach((e) => e.clear()), this.scheduler.reset?.(this), this.consolidateFreeBuffersForReload();
+			this.systems.forEach((e) => e.clear()), this.scheduler.reset?.(this), this.consolidateFreeBuffersForReload(e);
 		}
 		for (let e of Object.keys(this.factory.configs)) this.constantStrings.getOrCreate(e);
 		for (let e of Object.keys(this.factory.classes)) this.constantStrings.getOrCreate(e);
+		this.isLoading = !0;
+		let n = this.loadSteps(e);
+		if (t.sliceMs === void 0) {
+			let e;
+			try {
+				for (; !(e = n.next()).done;) t.onProgress?.(e.value);
+			} finally {
+				this.isLoading = !1;
+			}
+			return t.onEntitiesReady?.(), this.awaitWorkers(e.value, t.onProgress, t.signal);
+		}
+		let r = new AbortController();
+		this.activeLoad = r;
+		let i = t.signal ? AbortSignal.any([r.signal, t.signal]) : r.signal;
+		return this.loadSliced(n, t.sliceMs, r, i, t);
+	}
+	async loadSliced(e, t, n, r, i) {
+		let a = i.yieldTo ?? Z;
+		try {
+			r.throwIfAborted();
+			let n = performance.now(), o = e.next();
+			for (; !o.done;) i.onProgress?.(o.value), performance.now() - n >= t && (await a(), r.throwIfAborted(), n = performance.now()), o = e.next();
+			this.isLoading = !1, i.onEntitiesReady?.(), await this.awaitWorkers(o.value, i.onProgress, r);
+		} catch (e) {
+			throw this.activeLoad === n && (this.activeLoad = void 0, this.isBulkLoading = !1, this.isLoading = !1), e;
+		}
+		this.activeLoad === n && (this.activeLoad = void 0);
+	}
+	*loadSteps(e) {
+		let t = "entityDefinitions" in e ? e.entityDefinitions : void 0, n = e.entities, r = [];
 		this.isBulkLoading = !0;
 		try {
-			let t = ("entityDefinitions" in e ? J(e.entities, e.entityDefinitions) : 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);
-			});
+			for (let e = 0; e < n.length; e++) r.push(this.loadEntity(K(n[e], t), !1)), (e + 1) % Y === 0 && (yield X("entities", e + 1, n.length));
+			yield X("entities", n.length, n.length);
+			for (let e = 0; e < r.length; e++) {
+				let t = r[e];
+				t.finishLoading(), this.emit("entity-added", t), t.on("death", () => {
+					this.onEntityDied(t);
+				}), (e + 1) % Y === 0 && (yield X("linking", e + 1, r.length));
+			}
+			yield X("linking", r.length, r.length);
 		} finally {
 			this.isBulkLoading = !1;
 		}
-		let t = fe(this.entities.values());
-		return this.systems.forEach((e) => e.addEntities(t)), this.gameTime = e.gameTime ?? 0, this.playerTime = e.playerTime ?? 0, this.timeScale = e.timeScale ?? 1, this.finishLoadingSystems();
+		let i = _e(this.entities.values()), a = this.systems.slice(), o = a.length * 2;
+		for (let e = 0; e < a.length; e++) a[e].addEntities(i), yield X("systems", e + 1, o);
+		this.gameTime = e.gameTime ?? 0, this.playerTime = e.playerTime ?? 0, this.timeScale = e.timeScale ?? 1;
+		let s = [];
+		for (let e = 0; e < a.length; e++) {
+			let t = a[e].finishLoading();
+			t instanceof Promise && s.push(t), yield X("systems", a.length + e + 1, o);
+		}
+		return s;
+	}
+	async awaitWorkers(e, t, n) {
+		let r = 0;
+		t?.(X("workers", 0, e.length));
+		let i = Promise.all(e.map(async (n) => {
+			await n, t?.(X("workers", ++r, e.length));
+		}));
+		n ? await Promise.race([i, ge(n)]) : await i;
+	}
+	abortActiveLoad() {
+		this.activeLoad && (this.activeLoad.abort(), this.activeLoad = void 0, this.isBulkLoading = !1, this.isLoading = !1);
 	}
 	async clear() {
-		if (!this.pristine || this.scheduler.beforeClear) {
+		if (this.abortActiveLoad(), !this.pristine || this.scheduler.beforeClear) {
 			this.clearing = !0;
 			try {
 				this.scheduler.beforeClear?.(this), await Promise.all(this.systems.map((e) => e.waitForRunToComplete()).filter((e) => e instanceof Promise));
@@ -1385,7 +1456,7 @@ var Y = class {
 	notifySystemRunCompleted(e) {
 		this.activeFreeBuffer.waitingSystems.delete(e) && this.activeFreeBuffer.waitingSystems.size === 0 && this.processFreeBuffers(), this.scheduler.runCompleted?.(this, e);
 	}
-	systemSkipped(e) {
+	notifyAbandonedRunFinished(e) {
 		e.isCurrentlyRunning() || this.activeFreeBuffer.waitingSystems.delete(e) && this.activeFreeBuffer.waitingSystems.size === 0 && this.processFreeBuffers();
 	}
 	processFreeBuffers() {
@@ -1396,10 +1467,11 @@ var Y = class {
 		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);
+		for (let e of this.systems) 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;
+	consolidateFreeBuffersForReload(e) {
+		let t = this.activeFreeBuffer;
+		t.frees.push(...this.nextFreeBuffer.frees), this.nextFreeBuffer.frees.length = 0, t.waitingSystems.clear(), e.forEach((e) => t.waitingSystems.add(e)), t.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;
@@ -1410,9 +1482,9 @@ var Y = class {
 	}
 	checkFreeBufferTimeout(e) {
 		let t = this.activeFreeBuffer;
-		if (t.waitingSystems.size !== 0 && (t.waitElapsed += e, t.waitElapsed >= X)) {
+		if (t.waitingSystems.size !== 0 && (t.waitElapsed += e, t.waitElapsed >= J)) {
 			let e = Array.from(t.waitingSystems).map((e) => e.name).join(", ");
-			console.warn(`shared-memory-ecs: deferred component free waited over ${X}ms on system(s): ${e}; freeing anyway`), t.waitingSystems.clear(), this.processFreeBuffers();
+			console.warn(`shared-memory-ecs: deferred component free waited over ${J}ms on system(s): ${e}; freeing anyway`), t.waitingSystems.clear(), this.processFreeBuffers();
 		}
 	}
 	addSystem(e) {
@@ -1429,6 +1501,7 @@ var Y = class {
 		}
 	}
 	update(e) {
+		if (this.isLoading) return {};
 		this.emit("update-started", e);
 		let t = this.runUpdate(e);
 		return this.emit("update-finished", e), t;
@@ -1460,12 +1533,12 @@ var Y = class {
 	}
 	addEntityToEntityWorkerSystem(e, t) {
 		this.isBulkLoading || this.systems.forEach((n) => {
-			(n instanceof E && n.options.components?.includes(t) || n instanceof A && this.queriesReferenceComponent(n.options, t)) && n.checkAddEntity(e);
+			(n instanceof T && n.options.components?.includes(t) || n instanceof k && this.queriesReferenceComponent(n.options, t)) && n.checkAddEntity(e);
 		});
 	}
 	removeEntityFromEntityWorkerSystem(e, t) {
 		this.isBulkLoading || this.systems.forEach((n) => {
-			n instanceof E && n.options.components?.includes(t) ? n.removeEntity(e) : n instanceof A && this.queriesReferenceComponent(n.options, t) && n.checkAddEntity(e);
+			n instanceof T && n.options.components?.includes(t) ? n.removeEntity(e) : n instanceof k && this.queriesReferenceComponent(n.options, t) && n.checkAddEntity(e);
 		});
 	}
 	queriesReferenceComponent(e, t) {
@@ -1473,12 +1546,30 @@ var Y = class {
 		return n || r;
 	}
 	destroy() {
-		this.destroyed ||= (this.systems.forEach((e) => {
+		this.destroyed ||= (this.abortActiveLoad(), this.systems.forEach((e) => {
 			e.destroy();
 		}), this.scheduler.destroy?.(this), !0);
 	}
 };
-function fe(e) {
+function X(e, t, n) {
+	let { start: r, weight: i } = me[e];
+	return {
+		phase: e,
+		done: t,
+		total: n,
+		fraction: r + i * (n === 0 ? 1 : t / n)
+	};
+}
+function Z() {
+	let e = globalThis.scheduler;
+	return e?.yield ? e.yield() : new Promise((e) => setTimeout(e, 0));
+}
+function ge(e) {
+	return new Promise((t, n) => {
+		e.aborted ? n(e.reason) : e.addEventListener("abort", () => n(e.reason), { once: !0 });
+	});
+}
+function _e(e) {
 	let t = {
 		entities: [],
 		groupIndexes: [],
@@ -1492,7 +1583,7 @@ function fe(e) {
 }
 //#endregion
 //#region src/scheduling/conflict-scheduler.ts
-var pe = class {
+var ve = class {
 	compiled = Object.freeze({
 		order: Object.freeze([]),
 		batches: Object.freeze([])
@@ -1575,7 +1666,7 @@ var pe = class {
 		}, 0);
 	}
 	isSliced(e) {
-		return e.system instanceof T && e.system.remainingInstancesToRun.length > 0;
+		return e.system instanceof w && e.system.remainingInstancesToRun.length > 0;
 	}
 	reset() {
 		this.continuationTimer !== void 0 && (clearTimeout(this.continuationTimer), this.continuationTimer = void 0);
@@ -1588,10 +1679,14 @@ var pe = class {
 	prepareEffects(e, t) {
 		let n = this.running.get(t), r = this.generation;
 		return (e) => {
-			if (!n || r !== this.generation || !this.nodes.has(n)) {
+			if (r !== this.generation || n && !this.nodes.has(n)) {
 				e.discard();
 				return;
 			}
+			if (!n) {
+				e.apply();
+				return;
+			}
 			n.effects = e, this.publications.add(n), n.publicationDependencies === 0 && this.publicationReady.push(n), this.publish();
 		};
 	}
@@ -1707,7 +1802,7 @@ var pe = class {
 		let i = this.generation, a = !0, o = !1, s = !1, c = null;
 		if (e.emit(`system-${r.name}-started`), this.nodes.has(t) && this.dispatchAllowed(e)) {
 			try {
-				if (!r.withGameTime(t.gameTime, () => (a = n || r.shouldRun(), !this.nodes.has(t) || !this.dispatchAllowed(e) ? !1 : (a ? (t.state = "running", this.running.set(r, t), o = r.update(n ? 0 : t.elapsedTime), i === this.generation && !r.isCurrentlyRunning() && this.complete(t)) : (this.complete(t), e.systemSkipped?.(r)), !0)))) return;
+				if (!r.withGameTime(t.gameTime, () => (a = n || r.shouldRun(), !this.nodes.has(t) || !this.dispatchAllowed(e) ? !1 : (a ? (t.state = "running", this.running.set(r, t), o = r.update(n ? 0 : t.elapsedTime), i === this.generation && !r.isCurrentlyRunning() && this.complete(t)) : this.complete(t), !0)))) return;
 			} catch (n) {
 				let a = n;
 				console.error(a.message, a), s = !0, c = a, i === this.generation && (r.isCurrentlyRunning() ? (t.state = "running", this.running.set(r, t)) : this.complete(t)), e.emit("system-error", {
@@ -1743,20 +1838,20 @@ var pe = class {
 };
 //#endregion
 //#region src/entity-class.ts
-function me(e, t) {
+function ye(e, t) {
 	return t;
 }
-function Z(e, t) {
+function be(e, t) {
 	return t;
 }
 //#endregion
 //#region src/actions/kill-entity.ts
-function he(e) {
+function xe(e) {
 	e.components.entity.dead = !0, e.emit("death");
 }
 //#endregion
 //#region src/performance-timing.ts
-var ge = 1e3, Q = {
+var Se = 1e3, Q = {
 	avg: 0,
 	min: 0,
 	max: 0,
@@ -1773,7 +1868,7 @@ function $(e) {
 		samples: e.length
 	};
 }
-var _e = class extends S.default {
+var Ce = class extends x.default {
 	world;
 	ticksBetweenUpdates;
 	stats = {
@@ -1858,7 +1953,7 @@ var _e = class extends S.default {
 			e.run = [], e.events = [];
 		}), this.emit("stats-updated", this.stats), this.stats;
 	}
-}, ve = class extends A {
+}, we = class extends k {
 	constructor(e, t) {
 		super(e, {
 			...t,
@@ -1874,6 +1969,6 @@ var _e = class extends S.default {
 	}
 };
 //#endregion
-export { j as BaseEntity, de as BaseWorld, n as CLASS_INDEX, f as Component, pe as ConflictScheduler, g as ConstantStringCache, c as DEAD_INDEX, ge as DEFAULT_TICKS_BETWEEN_UPDATES, Y as DefaultScheduler, G as EntityCompressor, M as EntityFactory, E as EntitySystem, O as EntitySystemWebWorker, A as EntityWorkerSystem, T as IterableSystem, _ as MemoryComponent, _e as PerformanceTiming, ee as STATIC_INDEX, C as System, r as TYPE_INDEX, D as WebWorker, ve as WorkerSystem, t as addComponentWorker, ce as compressEntities, p as createEntitySystemWorker, d as createEntityWorker, h as createSystemWorker, J as decompressEntities, q as decompressEntity, me as defineEntityClasses, Z as defineEntityConfigs, i as entityDefinition, he as killEntity, m as killEntityWorker, s as removeComponentWorker };
+export { A as BaseEntity, he as BaseWorld, n as CLASS_INDEX, f as Component, ve as ConflictScheduler, m as ConstantStringCache, c as DEAD_INDEX, Se as DEFAULT_TICKS_BETWEEN_UPDATES, q as DefaultScheduler, U as EntityCompressor, j as EntityFactory, T as EntitySystem, D as EntitySystemWebWorker, k as EntityWorkerSystem, w as IterableSystem, h as MemoryComponent, Ce as PerformanceTiming, ne as STATIC_INDEX, S as System, r as TYPE_INDEX, E as WebWorker, we as WorkerSystem, t as addComponentWorker, ue as compressEntities, p as createEntitySystemWorker, d as createEntityWorker, te as createSystemWorker, fe as decompressEntities, G as decompressEntity, ye as defineEntityClasses, be as defineEntityConfigs, i as entityDefinition, xe as killEntity, ee as killEntityWorker, s as removeComponentWorker };
 
 //# sourceMappingURL=index.js.map