@adobe/data 0.9.0 → 0.9.2

package/ecs/database/transactional-store/coalesce-transactions.test.js

@@ -0,0 +1,433 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+import { describe, it, expect } from "vitest";
+import { shouldCoalesceTransactions, coalesceTransactions } from "./coalesce-actions.js";
+describe("shouldCoalesceTransactions", () => {
+    it("should return true for actions with same coalesce values", () => {
+        const previous = {
+            value: 1,
+            transient: false,
+            undoable: { coalesce: { id: "updateEntity", entity: 123 } },
+            redo: [],
+            undo: [],
+            changedEntities: new Map(),
+            changedComponents: new Set(),
+            changedArchetypes: new Set(),
+        };
+        const current = {
+            value: 2,
+            transient: false,
+            undoable: { coalesce: { id: "updateEntity", entity: 123 } },
+            redo: [],
+            undo: [],
+            changedEntities: new Map(),
+            changedComponents: new Set(),
+            changedArchetypes: new Set(),
+        };
+        expect(shouldCoalesceTransactions(previous, current)).toBe(true);
+    });
+    it("should return false for actions with different coalesce values", () => {
+        const previous = {
+            value: 1,
+            transient: false,
+            undoable: { coalesce: { id: "updateEntity", entity: 123 } },
+            redo: [],
+            undo: [],
+            changedEntities: new Map(),
+            changedComponents: new Set(),
+            changedArchetypes: new Set(),
+        };
+        const current = {
+            value: 2,
+            transient: false,
+            undoable: { coalesce: { id: "updateEntity", entity: 456 } },
+            redo: [],
+            undo: [],
+            changedEntities: new Map(),
+            changedComponents: new Set(),
+            changedArchetypes: new Set(),
+        };
+        expect(shouldCoalesceTransactions(previous, current)).toBe(false);
+    });
+    it("should return false when previous transaction has coalesce: false", () => {
+        const previous = {
+            value: 1,
+            transient: false,
+            undoable: { coalesce: false },
+            redo: [],
+            undo: [],
+            changedEntities: new Map(),
+            changedComponents: new Set(),
+            changedArchetypes: new Set(),
+        };
+        const current = {
+            value: 2,
+            transient: false,
+            undoable: { coalesce: { id: "updateEntity", entity: 123 } },
+            redo: [],
+            undo: [],
+            changedEntities: new Map(),
+            changedComponents: new Set(),
+            changedArchetypes: new Set(),
+        };
+        expect(shouldCoalesceTransactions(previous, current)).toBe(false);
+    });
+    it("should return false when current transaction has coalesce: false", () => {
+        const previous = {
+            value: 1,
+            transient: false,
+            undoable: { coalesce: { id: "updateEntity", entity: 123 } },
+            redo: [],
+            undo: [],
+            changedEntities: new Map(),
+            changedComponents: new Set(),
+            changedArchetypes: new Set(),
+        };
+        const current = {
+            value: 2,
+            transient: false,
+            undoable: { coalesce: false },
+            redo: [],
+            undo: [],
+            changedEntities: new Map(),
+            changedComponents: new Set(),
+            changedArchetypes: new Set(),
+        };
+        expect(shouldCoalesceTransactions(previous, current)).toBe(false);
+    });
+    it("should return false when previous transaction has no undoable", () => {
+        const previous = {
+            value: 1,
+            transient: false,
+            undoable: null,
+            redo: [],
+            undo: [],
+            changedEntities: new Map(),
+            changedComponents: new Set(),
+            changedArchetypes: new Set(),
+        };
+        const current = {
+            value: 2,
+            transient: false,
+            undoable: { coalesce: { id: "updateEntity", entity: 123 } },
+            redo: [],
+            undo: [],
+            changedEntities: new Map(),
+            changedComponents: new Set(),
+            changedArchetypes: new Set(),
+        };
+        expect(shouldCoalesceTransactions(previous, current)).toBe(false);
+    });
+    it("should return false when current transaction has no undoable", () => {
+        const previous = {
+            value: 1,
+            transient: false,
+            undoable: { coalesce: { id: "updateEntity", entity: 123 } },
+            redo: [],
+            undo: [],
+            changedEntities: new Map(),
+            changedComponents: new Set(),
+            changedArchetypes: new Set(),
+        };
+        const current = {
+            value: 2,
+            transient: false,
+            undoable: null,
+            redo: [],
+            undo: [],
+            changedEntities: new Map(),
+            changedComponents: new Set(),
+            changedArchetypes: new Set(),
+        };
+        expect(shouldCoalesceTransactions(previous, current)).toBe(false);
+    });
+});
+describe("coalesceTransactions", () => {
+    it("should combine redo and undo operations", () => {
+        const previous = {
+            value: 1,
+            transient: false,
+            undoable: { coalesce: { id: "updateEntity", entity: 123 } },
+            redo: [{ type: "update", entity: 123, values: { position: { x: 1 } } }],
+            undo: [{ type: "update", entity: 123, values: { position: { x: 0 } } }],
+            changedEntities: new Map([[123, { position: { x: 1 } }]]),
+            changedComponents: new Set(["position"]),
+            changedArchetypes: new Set([1]),
+        };
+        const current = {
+            value: 2,
+            transient: false,
+            undoable: { coalesce: { id: "updateEntity", entity: 123 } },
+            redo: [{ type: "update", entity: 123, values: { position: { y: 2 } } }],
+            undo: [{ type: "update", entity: 123, values: { position: { y: 0 } } }],
+            changedEntities: new Map([[123, { position: { y: 2 } }]]),
+            changedComponents: new Set(["position"]),
+            changedArchetypes: new Set([1]),
+        };
+        const result = coalesceTransactions(previous, current);
+        expect(result.redo).toHaveLength(1);
+        expect(result.redo[0]).toEqual({
+            type: "update",
+            entity: 123,
+            values: { position: { y: 2 } }
+        });
+        expect(result.undo).toHaveLength(1);
+        expect(result.undo[0]).toEqual({
+            type: "update",
+            entity: 123,
+            values: { position: { x: 0 } }
+        });
+    });
+    it("should merge changed entities, components, and archetypes", () => {
+        const previous = {
+            value: 1,
+            transient: false,
+            undoable: { coalesce: { id: "updateEntity", entity: 123 } },
+            redo: [],
+            undo: [],
+            changedEntities: new Map([[123, { position: { x: 1 } }]]),
+            changedComponents: new Set(["position"]),
+            changedArchetypes: new Set([1]),
+        };
+        const current = {
+            value: 2,
+            transient: false,
+            undoable: { coalesce: { id: "updateEntity", entity: 123 } },
+            redo: [],
+            undo: [],
+            changedEntities: new Map([[456, { name: "test" }]]),
+            changedComponents: new Set(["name"]),
+            changedArchetypes: new Set([2]),
+        };
+        const result = coalesceTransactions(previous, current);
+        expect(result.changedEntities.size).toBe(2);
+        expect(result.changedEntities.get(123)).toEqual({ position: { x: 1 } });
+        expect(result.changedEntities.get(456)).toEqual({ name: "test" });
+        expect(result.changedComponents.size).toBe(2);
+        expect(result.changedComponents.has("position")).toBe(true);
+        expect(result.changedComponents.has("name")).toBe(true);
+        expect(result.changedArchetypes.size).toBe(2);
+        expect(result.changedArchetypes.has(1)).toBe(true);
+        expect(result.changedArchetypes.has(2)).toBe(true);
+    });
+    it("should use current transaction's value, transient, and undoable", () => {
+        const previous = {
+            value: 1,
+            transient: false,
+            undoable: { coalesce: { id: "updateEntity", entity: 123 } },
+            redo: [],
+            undo: [],
+            changedEntities: new Map(),
+            changedComponents: new Set(),
+            changedArchetypes: new Set(),
+        };
+        const current = {
+            value: 2,
+            transient: true,
+            undoable: { coalesce: { id: "updateEntity", entity: 123 } },
+            redo: [],
+            undo: [],
+            changedEntities: new Map(),
+            changedComponents: new Set(),
+            changedArchetypes: new Set(),
+        };
+        const result = coalesceTransactions(previous, current);
+        expect(result.value).toBe(2);
+        expect(result.transient).toBe(true);
+        expect(result.undoable).toEqual({ coalesce: { id: "updateEntity", entity: 123 } });
+    });
+    it("should NOT optimize insert + update operations (cannot verify same entity)", () => {
+        const previous = {
+            value: 1,
+            transient: false,
+            undoable: { coalesce: { id: "createEntity", entity: 123 } },
+            redo: [{ type: "insert", values: { position: { x: 1 } } }],
+            undo: [{ type: "delete", entity: 123 }],
+            changedEntities: new Map([[123, { position: { x: 1 } }]]),
+            changedComponents: new Set(["position"]),
+            changedArchetypes: new Set([1]),
+        };
+        const current = {
+            value: 2,
+            transient: false,
+            undoable: { coalesce: { id: "updateEntity", entity: 123 } },
+            redo: [{ type: "update", entity: 123, values: { position: { y: 2 } } }],
+            undo: [{ type: "update", entity: 123, values: { position: { y: 0 } } }],
+            changedEntities: new Map([[123, { position: { y: 2 } }]]),
+            changedComponents: new Set(["position"]),
+            changedArchetypes: new Set([1]),
+        };
+        const result = coalesceTransactions(previous, current);
+        // Cannot safely optimize insert + update since insert doesn't have entity ID
+        expect(result.redo).toHaveLength(2);
+        expect(result.redo[0]).toEqual({
+            type: "insert",
+            values: { position: { x: 1 } }
+        });
+        expect(result.redo[1]).toEqual({
+            type: "update",
+            entity: 123,
+            values: { position: { y: 2 } }
+        });
+    });
+    it("should NOT optimize insert + delete operations (cannot verify same entity)", () => {
+        const previous = {
+            value: 1,
+            transient: false,
+            undoable: { coalesce: { id: "createEntity", entity: 123 } },
+            redo: [{ type: "insert", values: { position: { x: 1 } } }],
+            undo: [{ type: "delete", entity: 123 }],
+            changedEntities: new Map([[123, { position: { x: 1 } }]]),
+            changedComponents: new Set(["position"]),
+            changedArchetypes: new Set([1]),
+        };
+        const current = {
+            value: 2,
+            transient: false,
+            undoable: { coalesce: { id: "deleteEntity", entity: 123 } },
+            redo: [{ type: "delete", entity: 123 }],
+            undo: [{ type: "insert", values: { position: { x: 1 } } }],
+            changedEntities: new Map([[123, null]]),
+            changedComponents: new Set(["position"]),
+            changedArchetypes: new Set([1]),
+        };
+        const result = coalesceTransactions(previous, current);
+        // Cannot safely cancel without knowing if insert and delete are on the same entity
+        // Insert operations don't carry an entity ID, so we can't match them
+        expect(result.redo).toHaveLength(2);
+        expect(result.redo[0]).toEqual({ type: "insert", values: { position: { x: 1 } } });
+        expect(result.redo[1]).toEqual({ type: "delete", entity: 123 });
+        expect(result.undo).toHaveLength(2);
+        expect(result.undo[0]).toEqual({ type: "insert", values: { position: { x: 1 } } });
+        expect(result.undo[1]).toEqual({ type: "delete", entity: 123 });
+    });
+    it("should handle multiple update operations on same entity", () => {
+        const previous = {
+            value: 1,
+            transient: false,
+            undoable: { coalesce: { id: "updateEntity", entity: 123 } },
+            redo: [{ type: "update", entity: 123, values: { position: { x: 1 } } }],
+            undo: [{ type: "update", entity: 123, values: { position: { x: 0 } } }],
+            changedEntities: new Map([[123, { position: { x: 1 } }]]),
+            changedComponents: new Set(["position"]),
+            changedArchetypes: new Set([1]),
+        };
+        const current = {
+            value: 2,
+            transient: false,
+            undoable: { coalesce: { id: "updateEntity", entity: 123 } },
+            redo: [
+                { type: "update", entity: 123, values: { position: { y: 2 } } },
+                { type: "update", entity: 123, values: { name: "test" } }
+            ],
+            undo: [
+                { type: "update", entity: 123, values: { position: { y: 0 } } },
+                { type: "update", entity: 123, values: { name: "" } }
+            ],
+            changedEntities: new Map([[123, { position: { y: 2 }, name: "test" }]]),
+            changedComponents: new Set(["position", "name"]),
+            changedArchetypes: new Set([1]),
+        };
+        const result = coalesceTransactions(previous, current);
+        // Should combine all updates into a single operation
+        expect(result.redo).toHaveLength(1);
+        expect(result.redo[0]).toEqual({
+            type: "update",
+            entity: 123,
+            values: { position: { y: 2 }, name: "test" }
+        });
+        expect(result.undo).toHaveLength(1);
+        expect(result.undo[0]).toEqual({
+            type: "update",
+            entity: 123,
+            values: { position: { x: 0 }, name: "" }
+        });
+    });
+    it("should optimize update + delete operations on same entity", () => {
+        const previous = {
+            value: 1,
+            transient: false,
+            undoable: { coalesce: { id: "updateEntity", entity: 123 } },
+            redo: [{ type: "update", entity: 123, values: { position: { x: 1 } } }],
+            undo: [{ type: "update", entity: 123, values: { position: { x: 0 } } }],
+            changedEntities: new Map([[123, { position: { x: 1 } }]]),
+            changedComponents: new Set(["position"]),
+            changedArchetypes: new Set([1]),
+        };
+        const current = {
+            value: 2,
+            transient: false,
+            undoable: { coalesce: { id: "deleteEntity", entity: 123 } },
+            redo: [{ type: "delete", entity: 123 }],
+            undo: [{ type: "insert", values: { position: { x: 1 } } }],
+            changedEntities: new Map([[123, null]]),
+            changedComponents: new Set(["position"]),
+            changedArchetypes: new Set([1]),
+        };
+        const result = coalesceTransactions(previous, current);
+        // Should optimize to just the delete operation (the update is pointless)
+        expect(result.redo).toHaveLength(1);
+        expect(result.redo[0]).toEqual({
+            type: "delete",
+            entity: 123
+        });
+        // Undo: cannot safely merge insert + update, so we keep both
+        expect(result.undo).toHaveLength(2);
+        expect(result.undo[0]).toEqual({
+            type: "insert",
+            values: { position: { x: 1 } }
+        });
+        expect(result.undo[1]).toEqual({
+            type: "update",
+            entity: 123,
+            values: { position: { x: 0 } }
+        });
+    });
+    it("should NOT merge insert + update on different entities", () => {
+        const previous = {
+            value: 1,
+            transient: false,
+            undoable: { coalesce: { id: "createEntity", entity: 123 } },
+            redo: [{ type: "insert", values: { position: { x: 1 } } }],
+            undo: [{ type: "delete", entity: 123 }],
+            changedEntities: new Map([[123, { position: { x: 1 } }]]),
+            changedComponents: new Set(["position"]),
+            changedArchetypes: new Set([1]),
+        };
+        const current = {
+            value: 2,
+            transient: false,
+            undoable: { coalesce: { id: "updateEntity", entity: 456 } },
+            redo: [{ type: "update", entity: 456, values: { position: { y: 2 } } }],
+            undo: [{ type: "update", entity: 456, values: { position: { y: 0 } } }],
+            changedEntities: new Map([[456, { position: { y: 2 } }]]),
+            changedComponents: new Set(["position"]),
+            changedArchetypes: new Set([1]),
+        };
+        const result = coalesceTransactions(previous, current);
+        // Should NOT merge since we can't verify they're the same entity
+        expect(result.redo).toHaveLength(2);
+        expect(result.redo[0]).toEqual({ type: "insert", values: { position: { x: 1 } } });
+        expect(result.redo[1]).toEqual({ type: "update", entity: 456, values: { position: { y: 2 } } });
+    });
+});
+//# sourceMappingURL=coalesce-transactions.test.js.map

package/ecs/database/transactional-store/coalesce-transactions.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coalesce-transactions.test.js","sourceRoot":"","sources":["../../../../src/ecs/database/transactional-store/coalesce-transactions.test.ts"],"names":[],"mappings":"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"}

package/ecs/database/type-inference-demo.d.ts

@@ -0,0 +1,75 @@
+import { Database } from "./database.js";
+/**
+ * Demonstration: Type inference with Database.Plugin.create two-parameter form
+ *
+ * Notice how the `db` parameter in the systems callback has NO explicit type annotation,
+ * yet TypeScript correctly infers all components, resources, and methods!
+ */
+declare const PhysicsPlugin: Database.Plugin<{
+    readonly position: {
+        readonly type: "object";
+        readonly default: {
+            readonly x: 0;
+            readonly y: 0;
+            readonly z: 0;
+        };
+    };
+    readonly velocity: {
+        readonly type: "object";
+        readonly default: {
+            readonly x: 0;
+            readonly y: 0;
+            readonly z: 0;
+        };
+    };
+    readonly mass: {
+        readonly type: "number";
+        readonly default: 1;
+    };
+}, {
+    readonly gravity: {
+        readonly default: number;
+    };
+    readonly deltaTime: {
+        readonly default: number;
+    };
+}, import("../index.js").ArchetypeComponents<"position" | "velocity" | "mass">, import("../store/action-functions.js").ActionDeclarations<import("../../schema/from-schemas.js").FromSchemas<{
+    readonly position: {
+        readonly type: "object";
+        readonly default: {
+            readonly x: 0;
+            readonly y: 0;
+            readonly z: 0;
+        };
+    };
+    readonly velocity: {
+        readonly type: "object";
+        readonly default: {
+            readonly x: 0;
+            readonly y: 0;
+            readonly z: 0;
+        };
+    };
+    readonly mass: {
+        readonly type: "number";
+        readonly default: 1;
+    };
+}>, import("../../schema/from-schemas.js").FromSchemas<{
+    readonly gravity: {
+        readonly default: number;
+    };
+    readonly deltaTime: {
+        readonly default: number;
+    };
+}>, import("../index.js").ArchetypeComponents<"position" | "velocity" | "mass">>, "renderSystem" | "physicsSystem">;
+declare const OldPhysicsPlugin: Database.Plugin.Intersect<[Database.Plugin<{
+    readonly position: {
+        readonly type: "object";
+        readonly default: {
+            readonly x: 0;
+            readonly y: 0;
+            readonly z: 0;
+        };
+    };
+}, {}, {}, {}, "physicsSystem">]>;
+export { PhysicsPlugin, OldPhysicsPlugin };

package/ecs/database/type-inference-demo.js

@@ -0,0 +1,73 @@
+import { Database } from "./database.js";
+/**
+ * Demonstration: Type inference with Database.Plugin.create two-parameter form
+ *
+ * Notice how the `db` parameter in the systems callback has NO explicit type annotation,
+ * yet TypeScript correctly infers all components, resources, and methods!
+ */
+// ✅ NEW WAY: Two-parameter form with automatic type inference
+const PhysicsPlugin = Database.Plugin.create({
+    components: {
+        position: { type: "object", default: { x: 0, y: 0, z: 0 } },
+        velocity: { type: "object", default: { x: 0, y: 0, z: 0 } },
+        mass: { type: "number", default: 1 }
+    },
+    resources: {
+        gravity: { default: 9.81 },
+        deltaTime: { default: 0 }
+    }
+}, (db) => ({
+    // 🎯 NO TYPE ANNOTATION NEEDED! TypeScript infers everything!
+    physicsSystem: {
+        create: () => () => {
+            // All these work with full autocomplete and type checking:
+            const entities = db.select(["position", "velocity", "mass"]);
+            const gravity = db.resources.gravity;
+            const dt = db.resources.deltaTime;
+            for (const entity of entities) {
+                const pos = db.get(entity, "position");
+                const vel = db.get(entity, "velocity");
+                const m = db.get(entity, "mass");
+                // Full type safety - TypeScript knows all these types!
+                if (pos && vel && m) {
+                    vel.y += gravity * dt;
+                    pos.x += vel.x * dt;
+                    pos.y += vel.y * dt;
+                    pos.z += vel.z * dt;
+                }
+            }
+        }
+    },
+    renderSystem: {
+        create: () => () => {
+            // db is still fully typed here too!
+            const entities = db.select(["position"]);
+            for (const entity of entities) {
+                const pos = db.get(entity, "position");
+                if (pos) {
+                    console.log(`Entity ${entity} at (${pos.x}, ${pos.y}, ${pos.z})`);
+                }
+            }
+        },
+        schedule: {
+            after: ["physicsSystem"]
+        }
+    }
+}));
+// ⚠️ OLD WAY: Single-parameter form requires explicit typing
+const OldPhysicsPlugin = Database.Plugin.create({
+    components: {
+        position: { type: "object", default: { x: 0, y: 0, z: 0 } }
+    },
+    systems: {
+        physicsSystem: {
+            // ❌ Must explicitly type db parameter
+            create: (db) => () => {
+                const entities = db.select(["position"]);
+                // Works, but loses type safety with 'any'
+            }
+        }
+    }
+});
+export { PhysicsPlugin, OldPhysicsPlugin };
+//# sourceMappingURL=type-inference-demo.js.map

package/ecs/database/type-inference-demo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-inference-demo.js","sourceRoot":"","sources":["../../../src/ecs/database/type-inference-demo.ts"],"names":[],"mappings":"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"}