@daneren2005/shared-memory-ecs 1.9.0 → 1.10.0

package/README.md

@@ -926,6 +926,52 @@ through `system.addEntities(batch)`. Entities with the same component keys are g
 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.
 
+### Compressing saves
+
+Big maps are mostly entities whose save is a `type` plus a few integers. `compressEntities(entities, definitions)`
+packs each config that fits a definition into a short ASCII string and leaves every other config as an object:
+
+```ts
+import { compressEntities } from '@daneren2005/shared-memory-ecs';
+
+const save = compressEntities(entities, [
+	{ type: 'grass', properties: [
+		// Stored as (value - offset) / step; tile centres become small tile indices.
+		{ name: 'x', type: 'uint', step: 32, offset: 16 },
+		{ name: 'y', type: 'uint', step: 32, offset: 16 },
+		{ name: 'harvestAmount', type: 'uint' },
+		{ name: 'harvestProgress', type: 'uint' },
+	] },
+]);
+// { type: 'grass', x: 7920, y: 15440, harvestProgress: 633000 } becomes '#g(q-!ok{)'; a worker stays an object.
+// => { entityDefinitions: { 0: { type: 'grass', properties: [...] } }, entities: ['#g(q-!ok{)', { type: 'worker', ... }] }
+await world.load({ ...save, gameTime });
+```
+
+`world.load()` expands string entities with the bundled `entityDefinitions`, and `decompressEntities` /
+`decompressEntity` do the same for tools. Property types are `int` (signed), `uint`, `boolean`, `float32` and `string`. `int`
+and `uint` decode as `stored * step / 10 ** decimals + offset` (defaults 1, 0, 0), so `decimals: 2` keeps hundredths.
+`float32` takes any number a `Float32Array` holds exactly, such as positions and velocities read from shared memory. A config stays an
+object when it has a property its definition lacks, or a value that wouldn't decode back exactly. Only definitions some
+string uses are bundled, so defining rare types costs nothing until one appears.
+
+Types with the same properties can share one definition by listing `types` instead of `type`; the save then stores
+the property list once:
+
+```ts
+{ types: ['oak', 'pine', 'birch'], properties: [...] }
+``` Missing values decode as absent. The definitions travel inside the save, so a later build can append,
+reorder or drop properties without breaking older saves.
+
+The string format lets other tools read saves without this library. A string is the definition key, then one field
+per property in definition order. A shared definition saved at key `n` gives its `types` the keys `n`, `n + 1`, ... in
+order, so every type still has its own key and sharing adds nothing to the strings. A field is `!` for absent, or a varint: little-endian base-45 digits, where every
+digit except the last comes from `` PQRSTUVWXYZ[]^_`abcdefghijklmnopqrstuvwxyz{|} `` and the last from
+`#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNO` (digit = position in its alphabet). Fields after the last present
+value are left out. `int` values are zigzag encoded (`n >= 0 ? 2n : -2n - 1`), booleans are 0 or 1, and a `float32` is
+the varint of its 32 IEEE 754 bits. A `string` is a varint length in UTF-16 code units followed by the raw characters,
+which may be any character; length 0 means `null`, and empty strings stay objects.
+
 ## Measuring performance
 
 `PerformanceTiming` watches a world and reports what running it costs. Hand it the world and it hooks itself

package/dist/entity-compression.d.ts

@@ -0,0 +1,40 @@
+export type CompressedPropertyType = 'int' | 'uint' | 'boolean' | 'float32' | 'string';
+export interface CompressedEntityProperty {
+    name: string;
+    type: CompressedPropertyType;
+    step?: number;
+    decimals?: number;
+    offset?: number;
+}
+interface DefinitionProperties {
+    properties: ReadonlyArray<CompressedEntityProperty>;
+}
+export type CompressedEntityDefinition = DefinitionProperties & ({
+    type: string;
+    types?: never;
+} | {
+    types: ReadonlyArray<string>;
+    type?: never;
+});
+export type CompressedEntityDefinitions = Record<string, CompressedEntityDefinition>;
+export interface CompressedEntities<Cfg> {
+    entityDefinitions: CompressedEntityDefinitions;
+    entities: Array<Cfg | string>;
+}
+type CompressibleConfig = object & {
+    type?: string;
+};
+type DecompressedValue = number | boolean | string | null;
+export declare class EntityCompressor {
+    private readonly encoders;
+    private readonly used;
+    constructor(definitions: ReadonlyArray<CompressedEntityDefinition>);
+    get entityDefinitions(): CompressedEntityDefinitions;
+    compress<Cfg extends CompressibleConfig>(config: Cfg): Cfg | string;
+    compressAll<Cfg extends CompressibleConfig>(entities: ReadonlyArray<Cfg>): CompressedEntities<Cfg>;
+    private encode;
+}
+export declare function compressEntities<Cfg extends CompressibleConfig>(entities: ReadonlyArray<Cfg>, definitions: ReadonlyArray<CompressedEntityDefinition>): CompressedEntities<Cfg>;
+export declare function decompressEntity(encoded: string, definitions: CompressedEntityDefinitions): Record<string, DecompressedValue | string>;
+export declare function decompressEntities<Cfg>(entities: ReadonlyArray<Cfg | string>, definitions: CompressedEntityDefinitions | undefined): Array<Cfg>;
+export {};

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export { default as BaseWorld } from './world';
-export type { WorldOptions, WorldConfig } from './world';
+export type { WorldOptions, WorldConfig, CompressedWorldConfig } from './world';
+export { EntityCompressor, compressEntities, decompressEntity, decompressEntities } from './entity-compression';
+export type { CompressedEntities, CompressedEntityDefinition, CompressedEntityDefinitions, CompressedEntityProperty, CompressedPropertyType, } from './entity-compression';
 export { default as DefaultScheduler } from './scheduling/default-scheduler';
 export { default as ConflictScheduler } from './scheduling/conflict-scheduler';
 export type { ConflictSchedule } from './scheduling/conflict-scheduler';

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 g, v as _, y as v } from "./create-system-worker-CNpRs2FO.js";
-import y from "@daneren2005/shared-memory-objects/memory-heap";
-import { MAX_BYTE_OFFSET_LENGTH as b } 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 m, t as ee, u as te, v as h, y as g } from "./create-system-worker-CNpRs2FO.js";
+import ne from "@daneren2005/shared-memory-objects/memory-heap";
+import { MAX_BYTE_OFFSET_LENGTH as _ } from "@daneren2005/shared-memory-objects/utils/pointer";
 //#region \0rolldown/runtime.js
-var x = Object.create, S = Object.defineProperty, C = Object.getOwnPropertyDescriptor, w = Object.getOwnPropertyNames, T = Object.getPrototypeOf, E = Object.prototype.hasOwnProperty, D = (e, t) => () => (t || (e((t = { exports: {} }).exports, t), e = null), t.exports), O = (e, t, n, r) => {
-	if (t && typeof t == "object" || typeof t == "function") for (var i = w(t), a = 0, o = i.length, s; a < o; a++) s = i[a], !E.call(e, s) && s !== n && S(e, s, {
+var v = Object.create, y = Object.defineProperty, re = Object.getOwnPropertyDescriptor, b = Object.getOwnPropertyNames, x = Object.getPrototypeOf, S = Object.prototype.hasOwnProperty, ie = (e, t) => () => (t || (e((t = { exports: {} }).exports, t), e = null), t.exports), ae = (e, t, n, r) => {
+	if (t && typeof t == "object" || typeof t == "function") for (var i = b(t), a = 0, o = i.length, s; a < o; a++) s = i[a], !S.call(e, s) && s !== n && y(e, s, {
 		get: ((e) => t[e]).bind(null, s),
-		enumerable: !(r = C(t, s)) || r.enumerable
+		enumerable: !(r = re(t, s)) || r.enumerable
 	});
 	return e;
-}, k = /* @__PURE__ */ ((e, t, n) => (n = e == null ? {} : x(T(e)), O(t || !e || !e.__esModule || !E.call(e, "default") ? S(n, "default", {
+}, C = /* @__PURE__ */ ((e, t, n) => (n = e == null ? {} : v(x(e)), ae(t || !e || !e.__esModule || !S.call(e, "default") ? y(n, "default", {
 	value: e,
 	enumerable: !0
-}) : n, e)))((/* @__PURE__ */ D(((e, t) => {
+}) : n, e)))((/* @__PURE__ */ ie(((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 x = Object.create, S = Object.defineProperty, C = 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), A = class extends k.default {
+})))(), 1), w = class extends C.default {
 	world;
 	name;
 	currentDelta = 0;
@@ -174,13 +174,13 @@ var x = Object.create, S = Object.defineProperty, C = Object.getOwnPropertyDescr
 		this.removeAllListeners();
 	}
 };
-function j(e, t, n) {
+function T(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 M = class extends A {
+var E = class extends w {
 	remainingInstancesToRun = [];
 	remainingInstancesStartTime = null;
 	iterationsPerCheck;
@@ -230,7 +230,7 @@ var M = class extends A {
 	}
 	beforeRunIterables() {}
 	getIterableEntityId(e) {}
-}, N = class e extends M {
+}, D = class e extends E {
 	entities = /* @__PURE__ */ new Map();
 	options;
 	constructor(e, t = { name: "EntitySystem" }) {
@@ -268,7 +268,7 @@ var M = class extends A {
 			t.entities.forEach((e) => this.onEntityAdded(e));
 			return;
 		}
-		j(t, (e) => this.hasComponents(e), (e) => {
+		T(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 M = class extends A {
 			...this.reads ?? []
 		] : void 0;
 	}
-}, P = class {
+}, O = class {
 	onmessage(e, t = []) {}
-}, F = class extends P {
+}, k = class extends O {
 	updateFunction;
 	entities = [];
 	workState = new a();
@@ -460,7 +460,7 @@ var M = class extends A {
 	onMessageTyped(e) {
 		this.onmessage({ data: e });
 	}
-}, I = "___main", L = class e extends A {
+}, A = "___main", j = class e extends w {
 	entities = /* @__PURE__ */ new Map();
 	options;
 	worker;
@@ -493,13 +493,13 @@ var M = class extends A {
 				type: "grow-buffer",
 				buffer: e
 			});
-		})) : (this.worker = new F(t.updateFunction, e, !!t.createsEntities, !!t.addsComponents), this.isWorkerThread = !1), this.initWorker();
+		})) : (this.worker = new k(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 F)) {
+		if (!(this.worker instanceof k)) {
 			let t = (t) => {
 				e(Error(`Worker ${this.name} failed to load`, { cause: t }));
 			};
@@ -604,7 +604,7 @@ var M = class extends A {
 			type: "load",
 			data: this.options.getInitData?.(),
 			gameTime: this.gameTime,
-			entities: this.buildQueryDelta(I, this.options),
+			entities: this.buildQueryDelta(A, this.options),
 			queries: n,
 			heap: this.isWorkerThread ? this.world.heap.getSharedMemory() : void 0,
 			sharedMemory: this.isWorkerThread ? this.world.getSharedComponentMemory() : void 0,
@@ -704,7 +704,7 @@ var M = class extends A {
 			first: t.first,
 			last: t.last
 		}, this.isRunning = !0, this.completeEffects = this.world.scheduler.prepareEffects?.(this.world, this);
-		let i = this.buildQueryDelta(I, this.options), a = {};
+		let i = this.buildQueryDelta(A, this.options), a = {};
 		Object.entries(this.options.queries ?? {}).forEach(([e, t]) => {
 			a[e] = this.buildQueryDelta(e, t);
 		});
@@ -773,7 +773,7 @@ var M = class extends A {
 	}
 	checkAddEntity(e) {
 		let t = this.tracksMainQuery && this.matchesQuery(e, this.options);
-		return this.updateEntityList(I, this.entities, e, t), Object.entries(this.options.queries ?? {}).forEach(([t, n]) => {
+		return this.updateEntityList(A, 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;
@@ -783,19 +783,19 @@ var M = class extends A {
 			t.entities.forEach((e) => this.checkAddEntity(e));
 			return;
 		}
-		this.tracksMainQuery && this.addBatchToQuery(I, this.entities, this.options, t), Object.entries(this.options.queries ?? {}).forEach(([e, n]) => {
+		this.tracksMainQuery && this.addBatchToQuery(A, 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);
-		j(r, (e) => this.matchesComponents(e, n), (e) => {
+		T(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(I, this.entities, e, !1), Object.entries(this.queryEntities).forEach(([t, n]) => {
+		this.updateEntityList(A, this.entities, e, !1), Object.entries(this.queryEntities).forEach(([t, n]) => {
 			this.updateEntityList(t, n, e, !1);
 		});
 	}
@@ -810,7 +810,7 @@ var M = class extends A {
 	destroy() {
 		super.destroy(), this.pendingEffects?.discard(), "terminate" in this.worker && this.worker.terminate();
 	}
-}, R = class extends k.default {
+}, M = class extends C.default {
 	eid;
 	config;
 	world;
@@ -911,7 +911,7 @@ var M = class extends A {
 	assertComponentPropertyMutable(e, t) {
 		if (e === "entity" && (t === "type" || t === "class")) throw Error(`Entity ${t} is immutable`);
 	}
-}, z = class e {
+}, N = class e {
 	world;
 	configs;
 	classes;
@@ -928,7 +928,7 @@ var M = class extends A {
 		this.world = e, this.forbiddenProperties.clear();
 		for (let t of Object.keys(this.classes)) {
 			let n = this.classes[t].entity;
-			if (n !== R && !(n.prototype instanceof R)) throw Error(`Entity class ${t} must extend BaseEntity`);
+			if (n !== M && !(n.prototype instanceof M)) 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]);
@@ -954,7 +954,7 @@ var M = class extends A {
 	createAdoptedEntity(e, t, n) {
 		if (!t) {
 			if (this.hasClasses) throw Error(`Entity type ${e} has no class`);
-			return new R(this.world, void 0, n);
+			return new M(this.world, void 0, n);
 		}
 		let r = this.classes[t];
 		if (!r) throw Error(`Unknown entity class: ${t}`);
@@ -980,7 +980,7 @@ var M = class extends A {
 		return e ? this.getAllowedComponents(e) : void 0;
 	}
 	createEntity(e) {
-		return new R(this.world, e);
+		return new M(this.world, e);
 	}
 	get hasClasses() {
 		return this.allowedComponents.size > 0;
@@ -1045,7 +1045,160 @@ var M = class extends A {
 		}
 		throw Error(`Entity type ${e} class ${t} loads a component outside its class`);
 	}
-}, B = class {
+}, P = 45, F = "!", I = "#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNO", L = "PQRSTUVWXYZ[]^_`abcdefghijklmnopqrstuvwxyz{|}", R = (/* @__PURE__ */ new Int8Array(128)).fill(-1);
+for (let e = 0; e < P; e++) R[I.charCodeAt(e)] = e, R[L.charCodeAt(e)] = e + P;
+function z(e) {
+	let t = "";
+	for (; e >= P;) t += L[e % P], e = Math.floor(e / P);
+	return t + I[e];
+}
+var B = /* @__PURE__ */ new Float32Array(1), V = new Uint32Array(B.buffer);
+function oe(e, t) {
+	switch (e.type) {
+		case "boolean": return typeof t == "boolean" ? I[Number(t)] : void 0;
+		case "string": return t === null ? I[0] : typeof t == "string" && t.length ? z(t.length) + t : void 0;
+		case "float32": return typeof t != "number" || !Number.isFinite(t) || Math.fround(t) !== t ? void 0 : (B[0] = t, z(V[0]));
+		default: {
+			let n = se(e, t);
+			return n === void 0 ? void 0 : z(n);
+		}
+	}
+}
+function se(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 (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) {
+	return t * (e.step ?? 1) / 10 ** (e.decimals ?? 0) + (e.offset ?? 0);
+}
+function U(e, t) {
+	switch (e.type) {
+		case "boolean": return t !== 0;
+		case "float32": return V[0] = t, B[0];
+		case "uint": return H(e, t);
+		default: return H(e, t % 2 == 0 ? t / 2 : -(t + 1) / 2);
+	}
+}
+function W(e) {
+	return e.types === void 0 ? [e.type] : e.types;
+}
+var G = class {
+	encoders = /* @__PURE__ */ new Map();
+	used = /* @__PURE__ */ new Set();
+	constructor(e) {
+		let t = 0;
+		for (let n of e) {
+			let e = {
+				key: t,
+				definition: n,
+				indices: new Map(n.properties.map((e, t) => [e.name, t]))
+			};
+			for (let r of W(n)) {
+				if (this.encoders.has(r)) throw Error(`Duplicate compressed entity definition for ${r}`);
+				this.encoders.set(r, {
+					prefix: z(t++),
+					group: e
+				});
+			}
+		}
+	}
+	get entityDefinitions() {
+		let e = {};
+		for (let t of this.used) e[t.key] = t.definition;
+		return e;
+	}
+	compress(e) {
+		let t = e.type === void 0 ? void 0 : this.encoders.get(e.type), n = t && this.encode(t, e);
+		return !t || n === void 0 ? e : (this.used.add(t.group), n);
+	}
+	compressAll(e) {
+		let t = e.map((e) => this.compress(e));
+		return {
+			entityDefinitions: this.entityDefinitions,
+			entities: t
+		};
+	}
+	encode(e, t) {
+		let n = [];
+		for (let [r, i] of Object.entries(t)) {
+			if (r === "type" || i === void 0) continue;
+			let t = e.group.indices.get(r);
+			if (t === void 0) return;
+			let a = oe(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] ?? F;
+		return r;
+	}
+};
+function ce(e, t) {
+	return new G(t).compressAll(e);
+}
+var K = /* @__PURE__ */ new WeakMap();
+function le(e) {
+	let t = K.get(e);
+	if (t) return t;
+	t = /* @__PURE__ */ new Map();
+	for (let [n, r] of Object.entries(e)) {
+		let e = W(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, {
+				type: e[i],
+				properties: r.properties
+			});
+		}
+	}
+	return K.set(e, t), t;
+}
+function q(e, t) {
+	let n = 0, r = () => {
+		if (e[n] === F) {
+			n++;
+			return;
+		}
+		let t = 0, r = 1;
+		for (; n < e.length;) {
+			let i = e.charCodeAt(n++), a = i < 128 ? R[i] : -1;
+			if (a < 0) throw Error(`Invalid compressed entity ${e}`);
+			if (a < P) return t + a * r;
+			t += (a - P) * r, r *= P;
+		}
+		throw Error(`Truncated compressed entity ${e}`);
+	}, i = r(), a = i === void 0 ? void 0 : le(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++) {
+		let i = a.properties[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);
+			else if (s === 0) o[i.name] = null;
+			else {
+				if (n + s > e.length) throw Error(`Truncated compressed entity ${e}`);
+				o[i.name] = e.slice(n, n += s);
+			}
+		}
+	}
+	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);
+	});
+}
+//#endregion
+//#region src/scheduling/default-scheduler.ts
+var Y = class {
 	update(e, t) {
 		let n = null;
 		return e.systems.forEach((r) => {
@@ -1068,7 +1221,7 @@ var M = class extends A {
 			});
 		}), { lastSystemError: n };
 	}
-}, V = b, H = 1e4, U = class extends k.default {
+}, ue = _, X = 1e4, de = class extends C.default {
 	heap;
 	constantStrings;
 	eidCounter;
@@ -1096,7 +1249,7 @@ var M = class extends A {
 	};
 	clearing = !1;
 	constructor(e, t = {}) {
-		super(), this.scheduler = t.scheduler ?? new B(), this.heap = new y({ bufferSize: t.heapSize ?? V }), this.constantStrings = new _(this.heap), this.eidCounter = this.heap.allocUI32(1), this.heap.addOnGrowBufferHandlers((e) => this.emit("grow-buffer", e));
+		super(), this.scheduler = t.scheduler ?? new Y(), this.heap = new ne({ bufferSize: t.heapSize ?? ue }), this.constantStrings = new h(this.heap), this.eidCounter = this.heap.allocUI32(1), this.heap.addOnGrowBufferHandlers((e) => this.emit("grow-buffer", e));
 		let n = {
 			...e,
 			entity: i
@@ -1105,10 +1258,10 @@ var M = class extends A {
 			let t = n[e];
 			r[e] = {
 				...t,
-				memoryComponent: new v(this.heap, t.type, t.size)
+				memoryComponent: new g(this.heap, t.type, t.size)
 			};
 		}
-		this.registry = r, this.factory = t.factory ?? new z(), this.factory.setWorld(this);
+		this.registry = r, this.factory = t.factory ?? new N(), this.factory.setWorld(this);
 	}
 	allocateEid() {
 		return Atomics.add(this.eidCounter.data, 0, 1) + 1;
@@ -1125,7 +1278,7 @@ var M = class extends A {
 		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 L && e.isWorkerThread && (!!e.options.createsEntities || !!e.options.addsComponents));
+		return this.systems.some((e) => e instanceof j && e.isWorkerThread && (!!e.options.createsEntities || !!e.options.addsComponents));
 	}
 	async init() {
 		await Promise.all(this.systems.map((e) => e.init()).filter((e) => e instanceof Promise));
@@ -1174,14 +1327,14 @@ var M = class extends A {
 		for (let e of Object.keys(this.factory.classes)) this.constantStrings.getOrCreate(e);
 		this.isBulkLoading = !0;
 		try {
-			let t = e.entities.map((e) => this.loadEntity(e, !1));
+			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);
 			});
 		} finally {
 			this.isBulkLoading = !1;
 		}
-		let t = W(this.entities.values());
+		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();
 	}
 	async clear() {
@@ -1253,9 +1406,9 @@ var M = class extends A {
 	}
 	checkFreeBufferTimeout(e) {
 		let t = this.activeFreeBuffer;
-		if (t.waitingSystems.size !== 0 && (t.waitElapsed += e, t.waitElapsed >= H)) {
+		if (t.waitingSystems.size !== 0 && (t.waitElapsed += e, t.waitElapsed >= X)) {
 			let e = Array.from(t.waitingSystems).map((e) => e.name).join(", ");
-			console.warn(`shared-memory-ecs: deferred component free waited over ${H}ms on system(s): ${e}; freeing anyway`), t.waitingSystems.clear(), this.processFreeBuffers();
+			console.warn(`shared-memory-ecs: deferred component free waited over ${X}ms on system(s): ${e}; freeing anyway`), t.waitingSystems.clear(), this.processFreeBuffers();
 		}
 	}
 	addSystem(e) {
@@ -1303,12 +1456,12 @@ var M = class extends A {
 	}
 	addEntityToEntityWorkerSystem(e, t) {
 		this.isBulkLoading || this.systems.forEach((n) => {
-			(n instanceof N && n.options.components?.includes(t) || n instanceof L && this.componentAffectsEntityWorkerSystem(n, t)) && n.checkAddEntity(e);
+			(n instanceof D && n.options.components?.includes(t) || n instanceof j && this.componentAffectsEntityWorkerSystem(n, t)) && n.checkAddEntity(e);
 		});
 	}
 	removeEntityFromEntityWorkerSystem(e, t) {
 		this.isBulkLoading || this.systems.forEach((n) => {
-			n instanceof N && n.options.components?.includes(t) ? n.removeEntity(e) : n instanceof L && this.componentAffectsEntityWorkerSystem(n, t) && n.checkAddEntity(e);
+			n instanceof D && n.options.components?.includes(t) ? n.removeEntity(e) : n instanceof j && this.componentAffectsEntityWorkerSystem(n, t) && n.checkAddEntity(e);
 		});
 	}
 	componentAffectsEntityWorkerSystem(e, t) {
@@ -1321,7 +1474,7 @@ var M = class extends A {
 		}), this.scheduler.destroy?.(this), !0);
 	}
 };
-function W(e) {
+function fe(e) {
 	let t = {
 		entities: [],
 		groupIndexes: [],
@@ -1335,7 +1488,7 @@ function W(e) {
 }
 //#endregion
 //#region src/scheduling/conflict-scheduler.ts
-var G = class {
+var pe = class {
 	compiled = Object.freeze({
 		order: Object.freeze([]),
 		batches: Object.freeze([])
@@ -1418,7 +1571,7 @@ var G = class {
 		}, 0);
 	}
 	isSliced(e) {
-		return e.system instanceof M && e.system.remainingInstancesToRun.length > 0;
+		return e.system instanceof E && e.system.remainingInstancesToRun.length > 0;
 	}
 	reset() {
 		this.continuationTimer !== void 0 && (clearTimeout(this.continuationTimer), this.continuationTimer = void 0);
@@ -1586,27 +1739,27 @@ var G = class {
 };
 //#endregion
 //#region src/entity-class.ts
-function K(e, t) {
+function me(e, t) {
 	return t;
 }
-function q(e, t) {
+function Z(e, t) {
 	return t;
 }
 //#endregion
 //#region src/actions/kill-entity.ts
-function J(e) {
+function he(e) {
 	e.components.entity.dead = !0, e.emit("death");
 }
 //#endregion
 //#region src/performance-timing.ts
-var Y = 1e3, X = {
+var ge = 1e3, Q = {
 	avg: 0,
 	min: 0,
 	max: 0,
 	samples: 0
 };
-function Z(e) {
-	if (!e.length) return { ...X };
+function $(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 {
@@ -1616,13 +1769,13 @@ function Z(e) {
 		samples: e.length
 	};
 }
-var Q = class extends k.default {
+var _e = class extends C.default {
 	world;
 	ticksBetweenUpdates;
 	stats = {
-		update: { ...X },
+		update: { ...Q },
 		systems: [],
-		events: { ...X }
+		events: { ...Q }
 	};
 	autoUpdate;
 	ticks = 0;
@@ -1640,9 +1793,9 @@ var Q = class extends k.default {
 		this.ticks = 0, this.updateTimes = [], this.systemTimings.forEach((e) => {
 			e.run = [], e.events = [], e.eventStart = -1, e.pendingRun = 0, e.pendingEvents = 0;
 		}), this.stats = {
-			update: { ...X },
+			update: { ...Q },
 			systems: [],
-			events: { ...X }
+			events: { ...Q }
 		};
 	}
 	destroy() {
@@ -1687,21 +1840,21 @@ var Q = class extends k.default {
 			let t = this.systemTimings.get(e.name);
 			return {
 				name: e.name,
-				run: Z(t?.run ?? []),
-				events: Z(t?.events ?? [])
+				run: $(t?.run ?? []),
+				events: $(t?.events ?? [])
 			};
-		}), t = { ...X };
+		}), 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: Z(this.updateTimes),
+			update: $(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.stats;
 	}
-}, $ = class extends L {
+}, ve = class extends j {
 	constructor(e, t) {
 		super(e, {
 			...t,
@@ -1717,6 +1870,6 @@ var Q = class extends k.default {
 	}
 };
 //#endregion
-export { R as BaseEntity, U as BaseWorld, n as CLASS_INDEX, f as Component, G as ConflictScheduler, _ as ConstantStringCache, c as DEAD_INDEX, Y as DEFAULT_TICKS_BETWEEN_UPDATES, B as DefaultScheduler, z as EntityFactory, N as EntitySystem, F as EntitySystemWebWorker, L as EntityWorkerSystem, M as IterableSystem, v as MemoryComponent, Q as PerformanceTiming, g as STATIC_INDEX, A as System, r as TYPE_INDEX, P as WebWorker, $ as WorkerSystem, t as addComponentWorker, p as createEntitySystemWorker, d as createEntityWorker, h as createSystemWorker, K as defineEntityClasses, q as defineEntityConfigs, i as entityDefinition, J as killEntity, m as killEntityWorker, s as removeComponentWorker };
+export { M as BaseEntity, de as BaseWorld, n as CLASS_INDEX, f as Component, pe as ConflictScheduler, h as ConstantStringCache, c as DEAD_INDEX, ge as DEFAULT_TICKS_BETWEEN_UPDATES, Y as DefaultScheduler, G as EntityCompressor, N as EntityFactory, D as EntitySystem, k as EntitySystemWebWorker, j as EntityWorkerSystem, E as IterableSystem, g as MemoryComponent, _e as PerformanceTiming, te as STATIC_INDEX, w as System, r as TYPE_INDEX, O as WebWorker, ve as WorkerSystem, t as addComponentWorker, ce as compressEntities, p as createEntitySystemWorker, d as createEntityWorker, ee 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 };
 
 //# sourceMappingURL=index.js.map