@benev/archimedes 0.1.0-4 → 0.1.0-5

package/README.md

@@ -21,7 +21,7 @@ npm install @benev/archimedes
 ## 🧩 ecs — entities, components, systems
 
 ```ts
-import {Entities, asSystems, change, executeSystems} from "@benev/archimedes"
+import {Entities, asSystems, makeId, executeSystems} from "@benev/archimedes"
 ```
 
 1. ***define components.*** json-friendly data that entities could have.
@@ -31,45 +31,41 @@ import {Entities, asSystems, change, executeSystems} from "@benev/archimedes"
       bleed: number
     }
     ```
-1. ***create entities map.*** fancy caching for speedy-fast lookups.
+1. ***create entities map.*** indexed for speedy-fast lookups.
     ```ts
-    export const entitiesWritable = new Entities<MyComponents>()
-
-    // only let systems touch the readonly variant!
-    export const entities = entitiesWritable.readonly()
+    export const entities = new Entities<MyComponents>()
     ```
-1. ***define systems.*** select entities by components. yields changes.
+1. ***define systems.*** select entities by components. formal changes.
     ```ts
     const systems = asSystems<MyComponents>(
-      function* bleeding() {
+      function bleeding(entities, change) {
         for (const [id, components] of entities.select("health", "bleed")) {
-          if (components.bleed >= 0) {
+          if (components.bleed > 0) {
             const health = components.health - components.bleed
-            const bleed = components.bleed - 1
-            yield change.merge(id, {health, bleed})
+            change.merge(id, {health})
           }
         }
       },
 
-      function* death() {
+      function death(entities, change) {
         for (const [id, components] of entities.select("health")) {
           if (components.health <= 0)
-            yield change.delete(id)
+            change.delete(id)
         }
       },
     )
     ```
-1. ***create your first entity.***
+1. ***manually insert your first entity.***
     ```ts
     const wizardId = makeId()
-    entitiesWritable.set(wizardId, {health: 100, bleed: 2})
+    entities.set(wizardId, {health: 100, bleed: 2})
 
     console.log(entities.get(wizardId)?.health)
       // 100
     ```
 1. ***execute systems to simulate each tick.***
     ```ts
-    executeSystems(entitiesWritable, systems)
+    executeSystems(entities, systems)
 
     console.log(entities.get(wizardId)?.health)
       // 98
@@ -91,5 +87,3 @@ import {Entities, asSystems, change, executeSystems} from "@benev/archimedes"
 
 *coming soon*
 
-
-

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@benev/archimedes",
-	"version": "0.1.0-4",
+	"version": "0.1.0-5",
 	"description": "game ecs with auto networking",
 	"license": "MIT",
 	"type": "module",

package/s/ecs/index.ts

@@ -1,5 +1,5 @@
 
-export * from "./parts/apply-change.js"
+export * from "./parts/apply-delta.js"
 export * from "./parts/change.js"
 export * from "./parts/entities.js"
 export * from "./parts/execute-systems.js"

package/s/ecs/parts/apply-delta.ts

@@ -0,0 +1,37 @@
+
+import {Entities} from "./entities.js"
+import {DeltaSet, Delta, Components, DeltaKind, DeltaMerge, DeltaDrop} from "./types.js"
+
+export function applyDelta<C extends Components>(entities: Entities<C>, delta: Delta<C>) {
+	switch (delta[0]) {
+		case DeltaKind.Set: return applySet<C>(entities, <DeltaSet<C>>delta)
+		case DeltaKind.Merge: return applyMerge<C>(entities, <DeltaMerge<C>>delta)
+		case DeltaKind.Drop: return applyDrop<C>(entities, <DeltaDrop<C>>delta)
+		default: throw new Error(`unknown delta kind "${delta[0]}"`)
+	}
+}
+
+function applySet<C extends Components>(entities: Entities<C>, [, id, components]: DeltaSet<C>) {
+	if (components) entities.set(id, components as Partial<C>)
+	else entities.delete(id)
+	return id
+}
+
+function applyMerge<C extends Components>(entities: Entities<C>, [, id, patch]: DeltaMerge<C>) {
+	const components = entities.get(id)
+	if (!components)
+		return id
+	Object.assign(components, patch)
+	entities.set(id, components)
+	return id
+}
+
+function applyDrop<C extends Components>(entities: Entities<C>, [, id, keys]: DeltaDrop<C>) {
+	const components = entities.get(id)
+	if (!components)
+		return id
+	for (const key of keys) delete components[key]
+	entities.set(id, components)
+	return id
+}
+

package/s/ecs/parts/change.ts

@@ -1,27 +1,39 @@
 
 import {makeId} from "./make-id.js"
-import {Components, ChangeSet, ChangeMerge, Id, ChangeKind, ChangeDrop} from "./types.js"
+import {Components, Id, DeltaKind, Delta} from "./types.js"
 
-export const change = {
+export class Change<C extends Components> {
+	constructor(private commit: (delta: Delta<C>) => void) {}
 
 	/** create a new entity with the given components */
-	create: (components: Partial<Components>): ChangeSet<Components> =>
-		[ChangeKind.Set, makeId(), components],
+	create(components: Partial<C>) {
+		const id = makeId()
+		this.commit([DeltaKind.Set, id, components])
+		return id
+	}
 
 	/** overwrite a whole entity to the given components */
-	set: (id: Id, components: Partial<Components>): ChangeSet<Components> =>
-		[ChangeKind.Set, id, components],
+	set(id: Id, components: Partial<C>) {
+		this.commit([DeltaKind.Set, id, components])
+		return id
+	}
 
 	/** remove the entity */
-	delete: (id: Id): ChangeSet<Components> =>
-		[ChangeKind.Set, id],
+	delete(id: Id) {
+		this.commit([DeltaKind.Set, id])
+		return id
+	}
 
 	/** update or add the given components onto the entity */
-	merge: (id: Id, components: Partial<Components>): ChangeMerge<Components> =>
-		[ChangeKind.Merge, id, components],
+	merge(id: Id, components: Partial<C>) {
+		this.commit([DeltaKind.Merge, id, components])
+		return id
+	}
 
 	/** delete specific components off the entity */
-	drop: <C extends Components>(id: Id, ...keys: (keyof C)[]): ChangeDrop<C> =>
-		[ChangeKind.Drop, id, keys],
+	drop(id: Id, ...keys: (keyof C)[]) {
+		this.commit([DeltaKind.Drop, id, keys])
+		return id
+	}
 }
 

package/s/ecs/parts/execute-systems.ts

@@ -1,18 +1,21 @@
 
+import {Change} from "./change.js"
 import {Entities} from "./entities.js"
-import {applyChange} from "./apply-change.js"
-import {Change, Components, System} from "./types.js"
+import {applyDelta} from "./apply-delta.js"
+import {Delta, Components, System} from "./types.js"
 
 export function executeSystems<C extends Components>(entities: Entities<C>, systems: System<C>[]) {
-	const changes: Change<C>[] = []
+	const entitiesReadonly = entities.readonly()
+	const deltas: Delta<C>[] = []
 
-	for (const system of systems) {
-		for (const change of system()) {
-			applyChange(entities, change)
-			changes.push(change)
-		}
-	}
+	const change = new Change<C>(delta => {
+		applyDelta(entities, delta)
+		deltas.push(delta)
+	})
 
-	return changes
+	for (const system of systems)
+		system(entitiesReadonly, change)
+
+	return deltas
 }
 

package/s/ecs/parts/lifecycle.ts

@@ -1,30 +1,29 @@
 
 import {GMap} from "@e280/stz"
-import {EntitiesReadonly} from "./entities.js"
-import {Components, Id, LifecycleCallbacks, LifecycleEnter} from "./types.js"
+import {Components, Id, LifecycleCallbacks, LifecycleEnter, System} from "./types.js"
 
 export function lifecycle<C extends Components, K extends keyof C>(
-		entities: EntitiesReadonly<C>,
 		componentKeys: K[],
 		enter: LifecycleEnter<C, K>
-	) {
+	): System<C> {
 
 	const alive = new GMap<Id, LifecycleCallbacks<C, K>>()
-	const sel = () => entities.select(...componentKeys)
 
-	return function*() {
-		const current = new Map(sel())
+	return (entities, commit) => {
 
+		// add fresh entities
+		for (const [id, components] of entities.select(...componentKeys)) {
+			const callbacks = alive.guarantee(id, () => enter(id, components, commit))
+			callbacks.tick(id, components)
+		}
+
+		// delete stale entities
+		const currentIds = new Set([...entities.select(...componentKeys)].map(([id]) => id))
 		for (const [id, callbacks] of alive) {
-			if (current.has(id)) continue
+			if (currentIds.has(id)) continue
 			alive.delete(id)
 			callbacks.exit(id)
 		}
-
-		for (const [id, components] of current) {
-			const callbacks = alive.guarantee(id, () => enter(id, components))
-			callbacks.tick(id, components)
-		}
 	}
 }
 

package/s/ecs/parts/types.ts

@@ -1,25 +1,28 @@
 
+import {Change} from "./change.js"
+import {EntitiesReadonly} from "./entities.js"
+
 export type Id = string
 export type Components = Record<string, unknown>
 export type AsComponents<C extends Components> = C
 export type Select<C extends Components, K extends keyof C> = Pick<C, K> & Partial<C>
-export type System<C extends Components> = () => Generator<Change<C>>
 
+export enum DeltaKind {Set, Merge, Drop}
+export type DeltaSet<C extends Components> = [kind: DeltaKind.Set, id: Id, components?: Partial<C>]
+export type DeltaMerge<C extends Components> = [kind: DeltaKind.Merge, id: Id, patch: Partial<C>]
+export type DeltaDrop<C extends Components> = [kind: DeltaKind.Drop, id: Id, keys: (keyof C)[]]
+export type Delta<C extends Components> = DeltaSet<C> | DeltaMerge<C> | DeltaDrop<C>
+
+export type System<C extends Components> = (entities: EntitiesReadonly<C>, change: Change<C>) => void
 export const asSystem = <C extends Components>(system: System<C>) => system
 export const asSystems = <C extends Components>(...systems: System<C>[]) => systems
 
-export enum ChangeKind {Set, Merge, Drop}
-export type ChangeSet<C extends Components> = [kind: ChangeKind.Set, id: Id, components?: Partial<C>]
-export type ChangeMerge<C extends Components> = [kind: ChangeKind.Merge, id: Id, patch: Partial<C>]
-export type ChangeDrop<C extends Components> = [kind: ChangeKind.Drop, id: Id, keys: (keyof C)[]]
-export type Change<C extends Components> = ChangeSet<C> | ChangeMerge<C> | ChangeDrop<C>
-
 export type LifecycleCallbacks<C extends Components, K extends keyof C> = {
 	tick: (id: Id, components: Select<C, K>) => void
 	exit: (id: Id) => void
 }
 
 export type LifecycleEnter<C extends Components, K extends keyof C> = (
-	(id: Id, components: Select<C, K>) => LifecycleCallbacks<C, K>
+	(id: Id, components: Select<C, K>, change: Change<C>) => LifecycleCallbacks<C, K>
 )
 

package/s/ecs/test/setup-example.ts

@@ -1,7 +1,8 @@
 
-import {change} from "../parts/change.js"
+import {Change} from "../parts/change.js"
 import {asSystems} from "../parts/types.js"
 import {Entities} from "../parts/entities.js"
+import {applyDelta} from "../parts/apply-delta.js"
 
 export function setupExample() {
 	type MyComponents = {
@@ -11,39 +12,39 @@ export function setupExample() {
 		manaRegen: number
 	}
 
-	const writableEntities = new Entities<MyComponents>()
-	const entities = writableEntities.readonly()
-
 	const systems = asSystems<MyComponents>(
-		function* manaRegen() {
+		function manaRegen(entities, change) {
 			for (const [id, components] of entities.select("mana", "manaRegen")) {
 				if (components.manaRegen !== 0) {
 					const mana = components.mana + components.manaRegen
-					yield change.merge(id, {mana})
+					change.merge(id, {mana})
 				}
 			}
 		},
 
-		function* bleeding() {
+		function bleeding(entities, change) {
 			for (const [id, components] of entities.select("health", "bleed")) {
 				if (components.bleed >= 0) {
 					const health = components.health - components.bleed
 					const bleed = components.bleed - 1
-					yield change.merge(id, {health, bleed})
+					change.merge(id, {health, bleed})
 				}
 				if (components.bleed <= 0)
-					yield change.drop(id, "bleed")
+					change.drop(id, "bleed")
 			}
 		},
 
-		function* death() {
+		function death(entities, change) {
 			for (const [id, components] of entities.select("health")) {
 				if (components.health <= 0)
-					yield change.delete(id)
+					change.delete(id)
 			}
 		},
 	)
 
-	return {entities: writableEntities, systems}
+	const entities = new Entities<MyComponents>()
+	const change = new Change<MyComponents>(delta => applyDelta(entities, delta))
+
+	return {systems, entities, change}
 }
 

package/s/ecs/test.ts

@@ -1,93 +1,107 @@
 
 import {suite, test, expect} from "@e280/science"
-import {change} from "./parts/change.js"
 import {lifecycle} from "./parts/lifecycle.js"
-import {applyChange} from "./parts/apply-change.js"
 import {setupExample} from "./test/setup-example.js"
 import {executeSystems} from "./parts/execute-systems.js"
 import {setupLifecycleCounts} from "./test/setup-lifecycle-counts.js"
 
 export default suite({
 	"create an entity": test(async() => {
-		const {entities} = setupExample()
+		const {entities, change} = setupExample()
 		expect(entities.size).is(0)
-		applyChange(entities, change.create({health: 100}))
+		change.create({health: 100})
 		expect(entities.size).is(1)
 	}),
 
 	"delete an entity": test(async() => {
-		const {entities} = setupExample()
-		const id = applyChange(entities, change.create({health: 100}))
+		const {entities, change} = setupExample()
+		const id = change.create({health: 100})
 		expect(entities.size).is(1)
-		applyChange(entities, change.delete(id))
+		change.delete(id)
 		expect(entities.size).is(0)
 	}),
 
 	"merge components into entity": test(async() => {
-		const {entities} = setupExample()
-		const id = applyChange(entities, change.create({health: 100, mana: 100}))
+		const {entities, change} = setupExample()
+		const id = change.create({health: 100, mana: 100})
 		expect(entities.require(id).health).is(100)
-		applyChange(entities, change.merge(id, {health: 99}))
+		change.merge(id, {health: 99})
 		expect(entities.require(id).health).is(99)
 		expect(entities.require(id).mana).is(100)
 	}),
 
+	"ignore merge after delete": test(async() => {
+		const {entities, change} = setupExample()
+		const id = change.create({health: 100, mana: 100})
+		expect(entities.get(id)).ok()
+		change.delete(id)
+		expect(entities.get(id)).not.ok()
+		change.merge(id, {health: 99})
+		expect(entities.get(id)).not.ok()
+	}),
+
+	"ignore drop after delete": test(async() => {
+		const {entities, change} = setupExample()
+		const id = change.create({health: 100, mana: 100})
+		expect(entities.get(id)).ok()
+		change.delete(id)
+		expect(entities.get(id)).not.ok()
+		change.drop(id, "health")
+		expect(entities.get(id)).not.ok()
+	}),
+
 	"select an entity": test(async() => {
-		const {entities} = setupExample()
-		applyChange(entities, change.create({health: 100}))
+		const {entities, change} = setupExample()
+		change.create({health: 100})
 		expect([...entities.select("health")].length).is(1)
 	}),
 
 	"drop components from entity": test(async() => {
-		const {entities} = setupExample()
-		const id = applyChange(entities, change.create({health: 100, mana: 100}))
+		const {entities, change} = setupExample()
+		const id = change.create({health: 100, mana: 100})
 		expect([...entities.select("health", "mana")].length).is(1)
-		applyChange(entities, change.drop(id, "mana"))
+		change.drop(id, "mana")
 		expect("mana" in entities.require(id)).is(false)
 		expect([...entities.select("health", "mana")].length).is(0)
 	}),
 
 	"select two entities": test(async() => {
-		const {entities} = setupExample()
-		applyChange(entities, change.create({health: 100}))
-		applyChange(entities, change.create({health: 100}))
+		const {entities, change} = setupExample()
+		change.create({health: 100})
+		change.create({health: 100})
 		expect([...entities.select("health")].length).is(2)
 	}),
 
 	"select with no component keys selects all": test(async() => {
-		const {entities} = setupExample()
-		applyChange(entities, change.create({health: 100}))
-		applyChange(entities, change.create({health: 100}))
+		const {entities, change} = setupExample()
+		change.create({health: 100})
+		change.create({health: 100})
 		expect([...entities.select()].length).is(2)
 	}),
 
 	"select doesn't include non-match": test(async() => {
-		const {entities} = setupExample()
-		applyChange(entities, change.create({health: 100}))
+		const {entities, change} = setupExample()
+		change.create({health: 100})
 		expect([...entities.select("mana")].length).is(0)
 	}),
 
 	"select includes entities with extra components": test(async() => {
-		const {entities} = setupExample()
-		applyChange(entities, change.create({health: 100, mana: 100}))
+		const {entities, change} = setupExample()
+		change.create({health: 100, mana: 100})
 		expect([...entities.select("health")].length).is(1)
 	}),
 
 	"wizard regens mana": test(async() => {
-		const {entities, systems} = setupExample()
-		const creating = change.create({health: 100, mana: 50, manaRegen: 1})
-		const wizardId = creating[1]
-		applyChange(entities, creating)
+		const {entities, change, systems} = setupExample()
+		const wizardId = change.create({health: 100, mana: 50, manaRegen: 1})
 		const changes = executeSystems(entities, systems)
 		expect(changes.length).is(1)
 		expect(entities.require(wizardId).mana).is(51)
 	}),
 
 	"death by bleeding": test(async() => {
-		const {entities, systems} = setupExample()
-		const creating = change.create({health: 3, bleed: 2})
-		const wizardId = creating[1]
-		applyChange(entities, creating)
+		const {entities, change, systems} = setupExample()
+		const wizardId = change.create({health: 3, bleed: 2})
 		expect(entities.require(wizardId).health).is(3)
 		executeSystems(entities, systems)
 		expect(entities.require(wizardId).health).is(1)
@@ -96,9 +110,9 @@ export default suite({
 	}),
 
 	"lifecycles": test(async() => {
-		const {entities} = setupExample()
+		const {entities, change} = setupExample()
 		const counts = setupLifecycleCounts()
-		const system = lifecycle(entities.readonly(), ["health"], () => {
+		const system = lifecycle(["health"], () => {
 			counts.enters++
 			return {
 				tick: () => void counts.ticks++,
@@ -107,20 +121,49 @@ export default suite({
 		})
 		counts.expect(0, 0, 0)
 
-		const creating = change.create({health: 100, mana: 50})
-		const wizardId = creating[1]
-		applyChange(entities, creating)
+		const wizardId = change.create({health: 100, mana: 50})
 		executeSystems(entities, [system])
 		counts.expect(1, 1, 0)
 
-		applyChange(entities, change.merge(wizardId, {health: 100, mana: 100}))
+		change.merge(wizardId, {health: 100, mana: 100})
 		executeSystems(entities, [system])
 		counts.expect(1, 2, 0)
 
-		applyChange(entities, change.delete(wizardId))
+		change.delete(wizardId)
 		executeSystems(entities, [system])
 		counts.expect(1, 2, 1)
 		expect(entities.size).is(0)
 	}),
+
+	"lifecycle can commit": test(async() => {
+		const {entities, change} = setupExample()
+		const system = lifecycle(["health"], (_id, _components, change) => {
+			change.create({mana: 50})
+			return {
+				tick: () => {},
+				exit: () => {},
+			}
+		})
+		change.create({health: 100})
+		executeSystems(entities, [system])
+		expect([...entities.select("mana")].length).is(1)
+	}),
+
+	"lifecycle self-deletion immediate cleanup": test(async() => {
+		const {entities, change} = setupExample()
+		let ranExit = 0
+		const system = lifecycle(["health"], (id, _components, change) => {
+			return {
+				tick: () => change.delete(id),
+				exit: () => { ranExit++ },
+			}
+		})
+		change.create({health: 100})
+		expect([...entities.select("health")].length).is(1)
+		expect(ranExit).is(0)
+		executeSystems(entities, [system])
+		expect(ranExit).is(1)
+		expect([...entities.select("health")].length).is(0)
+	}),
 })
 

package/x/ecs/index.d.ts

@@ -1,4 +1,4 @@
-export * from "./parts/apply-change.js";
+export * from "./parts/apply-delta.js";
 export * from "./parts/change.js";
 export * from "./parts/entities.js";
 export * from "./parts/execute-systems.js";

package/x/ecs/index.js

@@ -1,4 +1,4 @@
-export * from "./parts/apply-change.js";
+export * from "./parts/apply-delta.js";
 export * from "./parts/change.js";
 export * from "./parts/entities.js";
 export * from "./parts/execute-systems.js";

package/x/ecs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../s/ecs/index.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../s/ecs/index.ts"],"names":[],"mappings":"AACA,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA"}

package/x/ecs/parts/apply-delta.d.ts

@@ -0,0 +1,3 @@
+import { Entities } from "./entities.js";
+import { Delta, Components } from "./types.js";
+export declare function applyDelta<C extends Components>(entities: Entities<C>, delta: Delta<C>): string;

package/x/ecs/parts/apply-delta.js

@@ -0,0 +1,34 @@
+import { DeltaKind } from "./types.js";
+export function applyDelta(entities, delta) {
+    switch (delta[0]) {
+        case DeltaKind.Set: return applySet(entities, delta);
+        case DeltaKind.Merge: return applyMerge(entities, delta);
+        case DeltaKind.Drop: return applyDrop(entities, delta);
+        default: throw new Error(`unknown delta kind "${delta[0]}"`);
+    }
+}
+function applySet(entities, [, id, components]) {
+    if (components)
+        entities.set(id, components);
+    else
+        entities.delete(id);
+    return id;
+}
+function applyMerge(entities, [, id, patch]) {
+    const components = entities.get(id);
+    if (!components)
+        return id;
+    Object.assign(components, patch);
+    entities.set(id, components);
+    return id;
+}
+function applyDrop(entities, [, id, keys]) {
+    const components = entities.get(id);
+    if (!components)
+        return id;
+    for (const key of keys)
+        delete components[key];
+    entities.set(id, components);
+    return id;
+}
+//# sourceMappingURL=apply-delta.js.map

package/x/ecs/parts/apply-delta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-delta.js","sourceRoot":"","sources":["../../../s/ecs/parts/apply-delta.ts"],"names":[],"mappings":"AAEA,OAAO,EAA8B,SAAS,EAAwB,MAAM,YAAY,CAAA;AAExF,MAAM,UAAU,UAAU,CAAuB,QAAqB,EAAE,KAAe;IACtF,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAClB,KAAK,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,QAAQ,CAAI,QAAQ,EAAe,KAAK,CAAC,CAAA;QACpE,KAAK,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,UAAU,CAAI,QAAQ,EAAiB,KAAK,CAAC,CAAA;QAC1E,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,SAAS,CAAI,QAAQ,EAAgB,KAAK,CAAC,CAAA;QACvE,OAAO,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IAC7D,CAAC;AACF,CAAC;AAED,SAAS,QAAQ,CAAuB,QAAqB,EAAE,CAAC,EAAE,EAAE,EAAE,UAAU,CAAc;IAC7F,IAAI,UAAU;QAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,UAAwB,CAAC,CAAA;;QACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACxB,OAAO,EAAE,CAAA;AACV,CAAC;AAED,SAAS,UAAU,CAAuB,QAAqB,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,CAAgB;IAC5F,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACnC,IAAI,CAAC,UAAU;QACd,OAAO,EAAE,CAAA;IACV,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAA;IAC5B,OAAO,EAAE,CAAA;AACV,CAAC;AAED,SAAS,SAAS,CAAuB,QAAqB,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,CAAe;IACzF,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACnC,IAAI,CAAC,UAAU;QACd,OAAO,EAAE,CAAA;IACV,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAA;IAC9C,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAA;IAC5B,OAAO,EAAE,CAAA;AACV,CAAC"}

package/x/ecs/parts/change.d.ts

@@ -1,13 +1,15 @@
-import { Components, ChangeSet, ChangeMerge, Id, ChangeDrop } from "./types.js";
-export declare const change: {
+import { Components, Id, Delta } from "./types.js";
+export declare class Change<C extends Components> {
+    private commit;
+    constructor(commit: (delta: Delta<C>) => void);
     /** create a new entity with the given components */
-    create: (components: Partial<Components>) => ChangeSet<Components>;
+    create(components: Partial<C>): string;
     /** overwrite a whole entity to the given components */
-    set: (id: Id, components: Partial<Components>) => ChangeSet<Components>;
+    set(id: Id, components: Partial<C>): string;
     /** remove the entity */
-    delete: (id: Id) => ChangeSet<Components>;
+    delete(id: Id): string;
     /** update or add the given components onto the entity */
-    merge: (id: Id, components: Partial<Components>) => ChangeMerge<Components>;
+    merge(id: Id, components: Partial<C>): string;
     /** delete specific components off the entity */
-    drop: <C extends Components>(id: Id, ...keys: (keyof C)[]) => ChangeDrop<C>;
-};
+    drop(id: Id, ...keys: (keyof C)[]): string;
+}