@daneren2005/shared-memory-ecs 1.8.0 → 1.8.2

package/README.md

@@ -687,6 +687,12 @@ the following updates, as above). `await world.clear()` instead tears the world
 empty, reusable state: it waits for every system's in-flight worker run to finish so nothing is still reading
 the memory, frees the held blocks immediately, and resolves once the world is ready to load into again.
 
+Prefer `world.load()` over looping `world.loadEntity()` for a large batch. It still emits `entity-added` for every
+entity, but systems ignore those while `world.isBulkLoading` is set and instead join the whole batch once at the end
+through `system.addEntities(batch)`. Entities with the same component keys are grouped, so each query's component
+test runs once per group instead of once per entity; system membership keeps load order. A system that overrides
+`checkAddEntity` (or an `EntityWorkerSystem` that overrides `matchesQuery`) still has it called for each entity.
+
 ## Measuring performance
 
 `PerformanceTiming` watches a world and reports what running it costs. Hand it the world and it hooks itself
@@ -715,6 +721,12 @@ Every entry is an `{ avg, min, max, samples }` over the window just closed:
   than on a frame boundary, so there is no per-frame combined sample to take; these are the per-system figures
   summed at the end of the window, giving what a run of every system costs the main thread between them.
 
+To coordinate reporting with an external clock, construct with `{ autoUpdate: false }` and call
+`timing.flush()` at each reporting boundary. It publishes and returns a snapshot of all collected update,
+worker, and event samples, then starts a fresh window. This also works while paused: windows without work
+report zeroes. Worker results belong to the window in which they arrive. Automatic reporting remains
+enabled by default.
+
 `getSystemStats(name)` pulls one system out of the latest snapshot, `reset()` throws away everything collected
 so far (worth doing after loading a new scene, when the samples either side are not comparable), and
 `destroy()` unhooks it from the world.

package/dist/entity-factory.d.ts

@@ -9,6 +9,7 @@ export default class EntityFactory<C extends ComponentMap = ComponentMap, Cfg =
     };
     classes: EntityClassRegistry;
     private allowedComponents;
+    private forbiddenProperties;
     constructor(configs?: {
         [type: string]: Cfg;
     }, classes?: EntityClassRegistry);
@@ -29,4 +30,6 @@ export default class EntityFactory<C extends ComponentMap = ComponentMap, Cfg =
     private validateResolvedConfig;
     private validateTypeClass;
     private validateComponentTriggers;
+    private getForbiddenProperties;
+    private throwComponentTriggerError;
 }

package/dist/index.d.ts

@@ -19,7 +19,7 @@ export type { ComponentTypedArray } from './memory-component';
 export { default as Component } from './component';
 export type { BaseComponent, ComponentMap, ComponentDefinition, ComponentDefinitionMap, ComponentRegistry, ComponentsOf, EntityConfigOf, RegisteredComponentDefinition, RegisteredComponentRegistry, } from './component-definition';
 export { default as System } from './systems/system';
-export type { SystemConfig, SystemError, SystemErrorPhase } from './systems/system';
+export type { EntityBatch, SystemConfig, SystemError, SystemErrorPhase } from './systems/system';
 export { default as IterableSystem } from './systems/iterable-system';
 export type { IterableSystemConfig } from './systems/iterable-system';
 export { default as EntitySystem } from './systems/entity-system';

package/dist/index.js

@@ -112,6 +112,7 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 		this.currentDelta = 0;
 	}
 	finishLoading() {}
+	addEntities(e) {}
 	update(e) {
 		if (this.currentDelta += e, this.currentDelta >= this.deltaBetweenRuns || this.firstRun) {
 			let e = 0;
@@ -143,7 +144,14 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 	destroy() {
 		this.removeAllListeners();
 	}
-}, A = class extends k {
+};
+function A(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 j = class extends k {
 	remainingInstancesToRun = [];
 	remainingInstancesStartTime = null;
 	iterationsPerCheck;
@@ -193,12 +201,12 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 	}
 	beforeRunIterables() {}
 	getIterableEntityId(e) {}
-}, j = class extends A {
+}, M = class e extends j {
 	entities = /* @__PURE__ */ new Map();
 	options;
 	constructor(e, t = { name: "EntitySystem" }) {
-		t.iterationsPerCheck ||= 10, t.maxMsPerFrame ||= 4, super(e, t), this.options = t, e.on("entity-added", (e) => {
-			this.checkAddEntity(e) && this.options.updateEntityOnAdd && this.updateEntity(e, 0);
+		t.iterationsPerCheck ||= 10, t.maxMsPerFrame ||= 4, super(e, t), this.options = t, e.on("entity-added", (t) => {
+			e.isBulkLoading || this.onEntityAdded(t);
 		}), e.on("entity-removed", (e) => {
 			this.removeEntity(e);
 		}), e.entities.forEach((e) => {
@@ -223,8 +231,23 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 	isEntityInSystem(e) {
 		return this.entities.has(e.eid);
 	}
+	onEntityAdded(e) {
+		this.checkAddEntity(e) && this.options.updateEntityOnAdd && this.updateEntity(e, 0);
+	}
+	addEntities(t) {
+		if (this.checkAddEntity !== e.prototype.checkAddEntity) {
+			t.entities.forEach((e) => this.onEntityAdded(e));
+			return;
+		}
+		A(t, (e) => this.hasComponents(e), (e) => {
+			this.filterEntity(e) && (this.entities.set(e.eid, e), this.options.updateEntityOnAdd && this.updateEntity(e, 0));
+		});
+	}
+	hasComponents(e) {
+		return !this.options.components || this.options.components.every((t) => !!e.components[t]);
+	}
 	checkAddEntity(e) {
-		return this.options.components && this.options.components.filter((t) => !!e.components[t]).length !== this.options.components.length ? !1 : this.filterEntity(e) ? (this.entities.set(e.eid, e), !0) : !1;
+		return this.hasComponents(e) && this.filterEntity(e) ? (this.entities.set(e.eid, e), !0) : !1;
 	}
 	removeEntity(e) {
 		this.entities.delete(e.eid);
@@ -232,9 +255,9 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 	shouldRun() {
 		return this.isCurrentlyRunning() || this.entities.size > 0;
 	}
-}, M = class {
+}, N = class {
 	onmessage(e, t = []) {}
-}, N = class extends M {
+}, P = class extends N {
 	updateFunction;
 	entities = [];
 	queryEntities = {};
@@ -372,7 +395,7 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 	onMessageTyped(e) {
 		this.onmessage({ data: e });
 	}
-}, P = "___main", F = class extends k {
+}, F = "___main", I = class e extends k {
 	entities = /* @__PURE__ */ new Map();
 	options;
 	worker;
@@ -388,8 +411,8 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 	constructor(e, t) {
 		super(e, t), this.options = t, Object.keys(this.options.queries ?? {}).forEach((e) => {
 			this.queryEntities[e] = /* @__PURE__ */ new Map();
-		}), e.on("entity-added", (e) => {
-			this.checkAddEntity(e);
+		}), e.on("entity-added", (t) => {
+			e.isBulkLoading || this.checkAddEntity(t);
 		}), e.on("entity-removed", (e) => {
 			this.removeEntity(e);
 		}), e.entities.forEach((e) => {
@@ -399,7 +422,7 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 				type: "grow-buffer",
 				buffer: e
 			});
-		})) : (this.worker = new N(t.updateFunction, e, !!t.createsEntities, !!t.addsComponents), this.isWorkerThread = !1), this.initWorker();
+		})) : (this.worker = new P(t.updateFunction, e, !!t.createsEntities, !!t.addsComponents), this.isWorkerThread = !1), this.initWorker();
 	}
 	initWorker() {
 		this.worker.onmessage = (e) => {
@@ -501,7 +524,7 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 			elapsedTime: e
 		};
 		this.addDataToWorld?.(t), this.isRunning = !0;
-		let n = this.buildQueryDelta(P, this.options), r = {};
+		let n = this.buildQueryDelta(F, this.options), r = {};
 		Object.entries(this.options.queries ?? {}).forEach(([e, t]) => {
 			r[e] = this.buildQueryDelta(e, t);
 		});
@@ -542,7 +565,10 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 		return this.entities.has(e.eid);
 	}
 	matchesQuery(e, t) {
-		return !(e.components.entity.dead || t.required.find((t) => !e.components[t]) || t.not?.find((t) => !!e.components[t]) || t.filter && !t.filter(e));
+		return !(e.components.entity.dead || !this.matchesComponents(e, t) || t.filter && !t.filter(e));
+	}
+	matchesComponents(e, t) {
+		return !(t.required.find((t) => !e.components[t]) || t.not?.find((t) => !!e.components[t]));
 	}
 	getQueryDelta(e) {
 		let t = this.queryDeltas[e];
@@ -561,15 +587,34 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 		let i = this.getQueryDelta(e);
 		r ? (t.set(n.eid, n), this.markAdded(i, n)) : t.delete(n.eid) && this.markRemoved(i, n);
 	}
+	get tracksMainQuery() {
+		return !0;
+	}
 	checkAddEntity(e) {
-		let t = this.matchesQuery(e, this.options);
-		return this.updateEntityList(P, this.entities, e, t), Object.entries(this.options.queries ?? {}).forEach(([t, n]) => {
+		let t = this.tracksMainQuery && this.matchesQuery(e, this.options);
+		return this.updateEntityList(F, 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;
 	}
+	addEntities(t) {
+		if (this.checkAddEntity !== e.prototype.checkAddEntity || this.matchesQuery !== e.prototype.matchesQuery) {
+			t.entities.forEach((e) => this.checkAddEntity(e));
+			return;
+		}
+		this.tracksMainQuery && this.addBatchToQuery(F, 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);
+		A(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(P, this.entities, e, !1), Object.entries(this.queryEntities).forEach(([t, n]) => {
+		this.updateEntityList(F, this.entities, e, !1), Object.entries(this.queryEntities).forEach(([t, n]) => {
 			this.updateEntityList(t, n, e, !1);
 		});
 	}
@@ -584,7 +629,7 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 	destroy() {
 		super.destroy(), "terminate" in this.worker && this.worker.terminate();
 	}
-}, I = class extends O.default {
+}, L = class extends O.default {
 	eid;
 	config;
 	world;
@@ -685,11 +730,12 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 	assertComponentPropertyMutable(e, t) {
 		if (e === "entity" && (t === "type" || t === "class")) throw Error(`Entity ${t} is immutable`);
 	}
-}, L = class {
+}, R = class e {
 	world;
 	configs;
 	classes;
 	allowedComponents = /* @__PURE__ */ new Map();
+	forbiddenProperties = /* @__PURE__ */ new Map();
 	constructor(e = {}, t = {}) {
 		this.configs = e, this.classes = t;
 		for (let e of Object.keys(t)) this.allowedComponents.set(e, new Set(t[e].components));
@@ -698,10 +744,10 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 		this.world && this.validateTemplate(e, t), this.configs[e] = t;
 	}
 	setWorld(e) {
-		this.world = e;
+		this.world = e, this.forbiddenProperties.clear();
 		for (let t of Object.keys(this.classes)) {
 			let n = this.classes[t].entity;
-			if (n !== I && !(n.prototype instanceof I)) throw Error(`Entity class ${t} must extend BaseEntity`);
+			if (n !== L && !(n.prototype instanceof L)) 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]);
@@ -718,16 +764,16 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 		} : e;
 		return this.hasClasses && n && this.validateResolvedConfig(n, i), i;
 	}
-	loadEntity(e, t = !0) {
-		let n = e.type, r = this.getConfig(e);
-		this.hasClasses && n && this.validateResolvedConfig(n, r);
-		let i = this.getClassDefinition(r), a = i ? this.constructEntity(i, r) : this.createEntity(r);
-		return this.world.addEntity(a, t);
+	loadEntity(t, n = !0) {
+		let r = t.type, i = this.getConfig(t);
+		this.hasClasses && r && this.getConfig !== e.prototype.getConfig && this.validateResolvedConfig(r, i);
+		let a = this.getClassDefinition(i), o = a ? this.constructEntity(a, i) : this.createEntity(i);
+		return this.world.addEntity(o, n);
 	}
 	createAdoptedEntity(e, t, n) {
 		if (!t) {
 			if (this.hasClasses) throw Error(`Entity type ${e} has no class`);
-			return new I(this.world, void 0, n);
+			return new L(this.world, void 0, n);
 		}
 		let r = this.classes[t];
 		if (!r) throw Error(`Unknown entity class: ${t}`);
@@ -753,7 +799,7 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 		return e ? this.getAllowedComponents(e) : void 0;
 	}
 	createEntity(e) {
-		return new I(this.world, e);
+		return new L(this.world, e);
 	}
 	get hasClasses() {
 		return this.allowedComponents.size > 0;
@@ -793,6 +839,21 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 		if (!n || n.class !== t) throw Error(`Entity type ${e} does not belong to class ${t}`);
 	}
 	validateComponentTriggers(e, t, n) {
+		let r = this.getForbiddenProperties(t);
+		for (let i in n) r.has(i) && this.throwComponentTriggerError(e, t, n);
+	}
+	getForbiddenProperties(e) {
+		let t = this.forbiddenProperties.get(e);
+		if (!t) {
+			let n = this.allowedComponents.get(e), r = /* @__PURE__ */ new Set();
+			for (let e of n) for (let t of this.world.registry[e].loadProperties) r.add(t);
+			let i = /* @__PURE__ */ new Set();
+			for (let e of Object.keys(this.world.registry)) if (!(e === "entity" || n.has(e))) for (let t of this.world.registry[e].loadProperties) r.has(t) || i.add(t);
+			t = i, this.forbiddenProperties.set(e, t);
+		}
+		return t;
+	}
+	throwComponentTriggerError(e, t, n) {
 		let r = this.allowedComponents.get(t), i = /* @__PURE__ */ new Set();
 		for (let e of r) for (let t of this.world.registry[e].loadProperties) i.add(t);
 		let a = n;
@@ -801,8 +862,9 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 			let o = this.world.registry[n].loadProperties.find((e) => e in a && !i.has(e));
 			if (o) throw Error(`Entity type ${e} class ${t} cannot load component ${n} from property ${o}`);
 		}
+		throw Error(`Entity type ${e} class ${t} loads a component outside its class`);
 	}
-}, R = y, z = 1e4, B = class extends O.default {
+}, z = y, B = 1e4, V = class extends O.default {
 	heap;
 	constantStrings;
 	eidCounter;
@@ -816,6 +878,7 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 	paused = !1;
 	destroyed = !1;
 	pristine = !0;
+	isBulkLoading = !1;
 	activeFreeBuffer = {
 		frees: [],
 		waitingSystems: /* @__PURE__ */ new Set(),
@@ -827,7 +890,7 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 		waitElapsed: 0
 	};
 	constructor(t, n = {}) {
-		super(), this.heap = new v({ bufferSize: n.heapSize ?? R }), this.constantStrings = new e(this.heap), this.eidCounter = this.heap.allocUI32(1), this.heap.addOnGrowBufferHandlers((e) => this.emit("grow-buffer", e));
+		super(), this.heap = new v({ bufferSize: n.heapSize ?? z }), this.constantStrings = new e(this.heap), this.eidCounter = this.heap.allocUI32(1), this.heap.addOnGrowBufferHandlers((e) => this.emit("grow-buffer", e));
 		let r = {
 			...t,
 			entity: i
@@ -839,7 +902,7 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 				memoryComponent: new _(this.heap, t.type, t.size)
 			};
 		}
-		this.registry = a, this.factory = n.factory ?? new L(), this.factory.setWorld(this);
+		this.registry = a, this.factory = n.factory ?? new R(), this.factory.setWorld(this);
 	}
 	allocateEid() {
 		return Atomics.add(this.eidCounter.data, 0, 1) + 1;
@@ -856,7 +919,7 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 		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 F && e.isWorkerThread && (!!e.options.createsEntities || !!e.options.addsComponents));
+		return this.systems.some((e) => e instanceof I && e.isWorkerThread && (!!e.options.createsEntities || !!e.options.addsComponents));
 	}
 	async init() {
 		await Promise.all(this.systems.map((e) => e.init()).filter((e) => e instanceof Promise));
@@ -903,11 +966,17 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 		}
 		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);
-		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();
+		this.isBulkLoading = !0;
+		try {
+			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);
+			});
+		} finally {
+			this.isBulkLoading = !1;
+		}
+		let t = H(this.entities.values());
+		this.systems.forEach((e) => e.addEntities(t)), this.gameTime = e.gameTime ?? 0, this.playerTime = e.playerTime ?? 0, this.timeScale = e.timeScale ?? 1, this.finishLoadingSystems();
 	}
 	async clear() {
 		if (!this.pristine) {
@@ -973,9 +1042,9 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 	}
 	checkFreeBufferTimeout(e) {
 		let t = this.activeFreeBuffer;
-		if (t.waitingSystems.size !== 0 && (t.waitElapsed += e, t.waitElapsed >= z)) {
+		if (t.waitingSystems.size !== 0 && (t.waitElapsed += e, t.waitElapsed >= B)) {
 			let e = Array.from(t.waitingSystems).map((e) => e.name).join(", ");
-			console.warn(`shared-memory-ecs: deferred component free waited over ${z}ms on system(s): ${e}; freeing anyway`), t.waitingSystems.clear(), this.processFreeBuffers();
+			console.warn(`shared-memory-ecs: deferred component free waited over ${B}ms on system(s): ${e}; freeing anyway`), t.waitingSystems.clear(), this.processFreeBuffers();
 		}
 	}
 	addSystem(e) {
@@ -1028,13 +1097,13 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 		this.paused = !1;
 	}
 	addEntityToEntityWorkerSystem(e, t) {
-		this.systems.forEach((n) => {
-			(n instanceof j && n.options.components?.includes(t) || n instanceof F && this.componentAffectsEntityWorkerSystem(n, t)) && n.checkAddEntity(e);
+		this.isBulkLoading || this.systems.forEach((n) => {
+			(n instanceof M && n.options.components?.includes(t) || n instanceof I && this.componentAffectsEntityWorkerSystem(n, t)) && n.checkAddEntity(e);
 		});
 	}
 	removeEntityFromEntityWorkerSystem(e, t) {
-		this.systems.forEach((n) => {
-			n instanceof j && n.options.components?.includes(t) ? n.removeEntity(e) : n instanceof F && this.componentAffectsEntityWorkerSystem(n, t) && n.checkAddEntity(e);
+		this.isBulkLoading || this.systems.forEach((n) => {
+			n instanceof M && n.options.components?.includes(t) ? n.removeEntity(e) : n instanceof I && this.componentAffectsEntityWorkerSystem(n, t) && n.checkAddEntity(e);
 		});
 	}
 	componentAffectsEntityWorkerSystem(e, t) {
@@ -1047,29 +1116,41 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 		}), !0);
 	}
 };
+function H(e) {
+	let t = {
+		entities: [],
+		groupIndexes: [],
+		groups: []
+	}, n = /* @__PURE__ */ new Map();
+	for (let r of e) {
+		let e = Object.keys(r.components).sort().join(","), i = n.get(e);
+		i === void 0 && (i = t.groups.push(r) - 1, n.set(e, i)), t.entities.push(r), t.groupIndexes.push(i);
+	}
+	return t;
+}
 //#endregion
 //#region src/entity-class.ts
-function V(e, t) {
+function U(e, t) {
 	return t;
 }
-function H(e, t) {
+function W(e, t) {
 	return t;
 }
 //#endregion
 //#region src/actions/kill-entity.ts
-function U(e) {
+function G(e) {
 	e.components.entity.dead = !0, e.emit("death");
 }
 //#endregion
 //#region src/performance-timing.ts
-var W = 1e3, G = {
+var K = 1e3, q = {
 	avg: 0,
 	min: 0,
 	max: 0,
 	samples: 0
 };
-function K(e) {
-	if (!e.length) return { ...G };
+function J(e) {
+	if (!e.length) return { ...q };
 	let t = 0, n = Infinity, r = 0;
 	for (let i of e) t += i, i < n && (n = i), i > r && (r = i);
 	return {
@@ -1079,21 +1160,22 @@ function K(e) {
 		samples: e.length
 	};
 }
-var q = class extends O.default {
+var Y = class extends O.default {
 	world;
 	ticksBetweenUpdates;
 	stats = {
-		update: { ...G },
+		update: { ...q },
 		systems: [],
-		events: { ...G }
+		events: { ...q }
 	};
+	autoUpdate;
 	ticks = 0;
 	updateStart = 0;
 	updateTimes = [];
 	systemTimings = /* @__PURE__ */ new Map();
 	destroyed = !1;
 	constructor(e, t = {}) {
-		super(), this.world = e, this.ticksBetweenUpdates = t.ticksBetweenUpdates ?? 1e3, e.on("update-started", this.onUpdateStarted), e.on("update-finished", this.onUpdateFinished), e.on("system-added", this.onSystemAdded), e.on("system-removed", this.onSystemRemoved), e.systems.forEach((e) => this.trackSystem(e));
+		super(), this.world = e, this.autoUpdate = t.autoUpdate ?? !0, this.ticksBetweenUpdates = t.ticksBetweenUpdates ?? 1e3, e.on("update-started", this.onUpdateStarted), e.on("update-finished", this.onUpdateFinished), e.on("system-added", this.onSystemAdded), e.on("system-removed", this.onSystemRemoved), e.systems.forEach((e) => this.trackSystem(e));
 	}
 	getSystemStats(e) {
 		return this.stats.systems.find((t) => t.name === e);
@@ -1102,9 +1184,9 @@ var q = class extends O.default {
 		this.ticks = 0, this.updateTimes = [], this.systemTimings.forEach((e) => {
 			e.run = [], e.events = [], e.eventStart = -1;
 		}), this.stats = {
-			update: { ...G },
+			update: { ...q },
 			systems: [],
-			events: { ...G }
+			events: { ...q }
 		};
 	}
 	destroy() {
@@ -1114,7 +1196,7 @@ var q = class extends O.default {
 		this.updateStart = performance.now();
 	};
 	onUpdateFinished = (e) => {
-		this.world.paused || (this.updateTimes.push(performance.now() - this.updateStart), this.ticks += e, this.ticks >= this.ticksBetweenUpdates && this.recalculate());
+		this.world.paused || (this.updateTimes.push(performance.now() - this.updateStart), this.ticks += e, this.autoUpdate && this.ticks >= this.ticksBetweenUpdates && this.flush());
 	};
 	onSystemAdded = (e) => {
 		this.trackSystem(e);
@@ -1141,26 +1223,27 @@ var q = class extends O.default {
 		let t = this.systemTimings.get(e);
 		t && (this.world.off(`system-${e}-worker-finished`, t.onRunFinished), this.world.off(`system-${e}-worker-events-finished`, t.onEventsFinished), this.systemTimings.delete(e));
 	}
-	recalculate() {
+	flush() {
+		if (this.destroyed) return this.stats;
 		let e = this.world.systems.map((e) => {
 			let t = this.systemTimings.get(e.name);
 			return {
 				name: e.name,
-				run: K(t?.run ?? []),
-				events: K(t?.events ?? [])
+				run: J(t?.run ?? []),
+				events: J(t?.events ?? [])
 			};
-		}), t = { ...G };
-		e.forEach((e) => {
+		}), t = { ...q };
+		return 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: K(this.updateTimes),
+			update: J(this.updateTimes),
 			systems: e,
 			events: t
 		}, this.ticks = 0, this.updateTimes = [], this.systemTimings.forEach((e) => {
 			e.run = [], e.events = [];
-		}), this.emit("stats-updated", this.stats);
+		}), this.emit("stats-updated", this.stats), this.stats;
 	}
-}, J = class extends F {
+}, X = class extends I {
 	constructor(e, t) {
 		super(e, {
 			...t,
@@ -1168,17 +1251,14 @@ var q = class extends O.default {
 			updateFunction: u(t.updateFunction)
 		});
 	}
-	checkAddEntity(e) {
-		return 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));
-		}), !1;
+	get tracksMainQuery() {
+		return !1;
 	}
 	shouldRun() {
 		return !0;
 	}
 };
 //#endregion
-export { I as BaseEntity, B as BaseWorld, n as CLASS_INDEX, f as Component, e as ConstantStringCache, c as DEAD_INDEX, W as DEFAULT_TICKS_BETWEEN_UPDATES, L as EntityFactory, j as EntitySystem, N as EntitySystemWebWorker, F as EntityWorkerSystem, A as IterableSystem, _ as MemoryComponent, q as PerformanceTiming, g as STATIC_INDEX, k as System, r as TYPE_INDEX, M as WebWorker, J as WorkerSystem, t as addComponentWorker, p as createEntitySystemWorker, d as createEntityWorker, h as createSystemWorker, V as defineEntityClasses, H as defineEntityConfigs, i as entityDefinition, U as killEntity, m as killEntityWorker, s as removeComponentWorker };
+export { L as BaseEntity, V as BaseWorld, n as CLASS_INDEX, f as Component, e as ConstantStringCache, c as DEAD_INDEX, K as DEFAULT_TICKS_BETWEEN_UPDATES, R as EntityFactory, M as EntitySystem, P as EntitySystemWebWorker, I as EntityWorkerSystem, j as IterableSystem, _ as MemoryComponent, Y as PerformanceTiming, g as STATIC_INDEX, k as System, r as TYPE_INDEX, N as WebWorker, X as WorkerSystem, t as addComponentWorker, p as createEntitySystemWorker, d as createEntityWorker, h as createSystemWorker, U as defineEntityClasses, W as defineEntityConfigs, i as entityDefinition, G as killEntity, m as killEntityWorker, s as removeComponentWorker };
 
 //# sourceMappingURL=index.js.map