@adobe/data 0.8.6 → 0.9.1

package/dist/ecs/database/database-with-systems.test.js

@@ -0,0 +1,292 @@
+import { describe, it, expect } from "vitest";
+import { Database } from "./database.js";
+describe("Database with systems", () => {
+    it("should create empty database with no systems", () => {
+        const db = Database.create();
+        expect(db.system.functions).toEqual({});
+        expect(db.system.order).toEqual([]);
+    });
+    it("should create database from plugin with systems", () => {
+        const executionLog = [];
+        const plugin = Database.Plugin.create({
+            components: {
+                position: { type: "object", default: { x: 0, y: 0, z: 0 } }
+            }
+        }, {
+            systems: {
+                updateSystem: {
+                    create: (_db) => () => {
+                        executionLog.push("update");
+                    }
+                },
+                renderSystem: {
+                    create: (_db) => () => {
+                        executionLog.push("render");
+                    }
+                }
+            }
+        });
+        const db = Database.create(plugin);
+        expect(db.system.functions.updateSystem).toBeDefined();
+        expect(db.system.functions.renderSystem).toBeDefined();
+        expect(db.system.order).toHaveLength(1);
+        expect(db.system.order[0]).toHaveLength(2);
+        // Execute systems
+        db.system.functions.updateSystem();
+        db.system.functions.renderSystem();
+        expect(executionLog).toEqual(["update", "render"]);
+    });
+    it("should respect system scheduling dependencies", () => {
+        const executionLog = [];
+        const plugin = Database.Plugin.create({
+            components: {
+                position: { type: "object", default: { x: 0, y: 0, z: 0 } }
+            },
+            systems: {
+                inputSystem: {
+                    create: (_db) => () => {
+                        executionLog.push("input");
+                    }
+                },
+                physicsSystem: {
+                    create: (_db) => () => {
+                        executionLog.push("physics");
+                    },
+                    schedule: {
+                        after: ["inputSystem"]
+                    }
+                },
+                renderSystem: {
+                    create: (_db) => () => {
+                        executionLog.push("render");
+                    },
+                    schedule: {
+                        after: ["physicsSystem"]
+                    }
+                }
+            }
+        });
+        const db = Database.create(plugin);
+        // Should have 3 tiers: input -> physics -> render
+        expect(db.system.order).toHaveLength(3);
+        expect(db.system.order[0]).toEqual(["inputSystem"]);
+        expect(db.system.order[1]).toEqual(["physicsSystem"]);
+        expect(db.system.order[2]).toEqual(["renderSystem"]);
+        // Execute in order
+        for (const tier of db.system.order) {
+            for (const systemName of tier) {
+                db.system.functions[systemName]();
+            }
+        }
+        expect(executionLog).toEqual(["input", "physics", "render"]);
+    });
+    it("should support parallel system execution in same tier", () => {
+        const plugin = Database.Plugin.create({
+            components: {},
+            archetypes: {},
+            systems: {
+                system1: {
+                    create: (_db) => () => { }
+                },
+                system2: {
+                    create: (_db) => () => { }
+                },
+                system3: {
+                    create: (_db) => () => { }
+                }
+            }
+        });
+        const db = Database.create(plugin);
+        // All independent systems should be in one tier
+        expect(db.system.order).toHaveLength(1);
+        expect(db.system.order[0]).toHaveLength(3);
+    });
+    it("should support async systems", async () => {
+        const executionLog = [];
+        const plugin = Database.Plugin.create({
+            components: {},
+            archetypes: {},
+            systems: {
+                asyncSystem: {
+                    create: (_db) => async () => {
+                        await new Promise(resolve => setTimeout(resolve, 10));
+                        executionLog.push("async");
+                    }
+                }
+            }
+        });
+        const db = Database.create(plugin);
+        await db.system.functions.asyncSystem();
+        expect(executionLog).toEqual(["async"]);
+    });
+    it("should allow systems to access database", () => {
+        const plugin = Database.Plugin.create({
+            components: {
+                position: { type: "object", default: { x: 0, y: 0, z: 0 } }
+            },
+            resources: {
+                time: { default: 0 }
+            },
+            archetypes: {
+                Entity: ["position"]
+            },
+            systems: {
+                updateSystem: {
+                    create: (db) => () => {
+                        // System can access database
+                        const entities = db.select(["position"]);
+                        expect(Array.isArray(entities)).toBe(true);
+                        expect(db.resources.time).toBe(0);
+                    }
+                }
+            }
+        });
+        const db = Database.create(plugin);
+        db.system.functions.updateSystem();
+    });
+    it("should extend database with new systems", () => {
+        const executionLog = [];
+        const basePlugin = Database.Plugin.create({
+            components: {
+                position: { type: "object", default: { x: 0, y: 0, z: 0 } }
+            },
+            systems: {
+                updateSystem: {
+                    create: (_db) => () => {
+                        executionLog.push("update");
+                    }
+                }
+            }
+        });
+        const extensionPlugin = Database.Plugin.create({
+            components: {
+                velocity: { type: "object", default: { x: 0, y: 0, z: 0 } }
+            },
+            systems: {
+                physicsSystem: {
+                    create: (_db) => () => {
+                        executionLog.push("physics");
+                    }
+                }
+            }
+        });
+        const db = Database.create(basePlugin);
+        const extended = db.extend(extensionPlugin);
+        expect(extended.system.functions.updateSystem).toBeDefined();
+        expect(extended.system.functions.physicsSystem).toBeDefined();
+        // Both systems should be available
+        extended.system.functions.updateSystem();
+        extended.system.functions.physicsSystem();
+        expect(executionLog).toEqual(["update", "physics"]);
+    });
+    it("should maintain system order when extending", () => {
+        const basePlugin = Database.Plugin.create({
+            components: {},
+            archetypes: {},
+            systems: {
+                system1: {
+                    create: (_db) => () => { }
+                }
+            }
+        });
+        const extensionPlugin = Database.Plugin.create({
+            components: {},
+            archetypes: {},
+            systems: {
+                system2: {
+                    create: (_db) => () => { },
+                    schedule: {
+                        after: ["system1"]
+                    }
+                }
+            }
+        });
+        const db = Database.create(basePlugin);
+        const extended = db.extend(extensionPlugin);
+        // system2 should be scheduled after system1
+        expect(extended.system.order).toHaveLength(2);
+        expect(extended.system.order[0]).toEqual(["system1"]);
+        expect(extended.system.order[1]).toEqual(["system2"]);
+    });
+    it("should extend database without systems and return same instance", () => {
+        const plugin = Database.Plugin.create({
+            components: {
+                position: { type: "object", default: { x: 0, y: 0, z: 0 } }
+            }
+        });
+        const extensionPlugin = Database.Plugin.create({
+            components: {
+                velocity: { type: "object", default: { x: 0, y: 0, z: 0 } }
+            }
+        });
+        const db = Database.create(plugin);
+        const extended = db.extend(extensionPlugin);
+        // When no systems involved, should return same instance
+        expect(extended).toBe(db);
+    });
+    it("should create new database instance when extending with systems", () => {
+        const basePlugin = Database.Plugin.create({
+            components: {
+                position: { type: "object", default: { x: 0, y: 0, z: 0 } }
+            },
+            systems: {
+                system1: {
+                    create: (_db) => () => { }
+                }
+            }
+        });
+        const extensionPlugin = Database.Plugin.create({
+            components: {},
+            systems: {
+                system2: {
+                    create: (_db) => () => { }
+                }
+            }
+        });
+        const db = Database.create(basePlugin);
+        const extended = db.extend(extensionPlugin);
+        // When systems are involved, should create new instance
+        expect(extended).not.toBe(db);
+    });
+    it("should support plugin composition through dependencies", () => {
+        const executionLog = [];
+        const inputPlugin = Database.Plugin.create({
+            components: {},
+            systems: {
+                inputSystem: {
+                    create: (_db) => () => {
+                        executionLog.push("input");
+                    }
+                }
+            }
+        });
+        const physicsPlugin = Database.Plugin.create(inputPlugin, {
+            components: {
+                velocity: { type: "object", default: { x: 0, y: 0, z: 0 } }
+            }
+        }, {
+            systems: {
+                physicsSystem: {
+                    create: (_db) => () => {
+                        executionLog.push("physics");
+                    },
+                    schedule: {
+                        after: ["inputSystem"]
+                    }
+                }
+            }
+        });
+        const db = Database.create(physicsPlugin);
+        // Should have both systems
+        expect(db.system.functions.inputSystem).toBeDefined();
+        expect(db.system.functions.physicsSystem).toBeDefined();
+        // Execute in order
+        for (const tier of db.system.order) {
+            for (const systemName of tier) {
+                db.system.functions[systemName]();
+            }
+        }
+        expect(executionLog).toEqual(["input", "physics"]);
+    });
+});
+//# sourceMappingURL=database-with-systems.test.js.map

package/dist/ecs/database/database-with-systems.test.js.map

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

package/dist/ecs/database/database.d.ts

@@ -5,7 +5,7 @@ import { Entity } from "../entity.js";
 import { EntityReadValues } from "../store/core/index.js";
 import { Observe } from "../../observe/index.js";
 import { TransactionResult } from "./transactional-store/index.js";
-import { StringKeyof } from "../../types/types.js";
+import { IntersectTuple, NoInfer, StringKeyof } from "../../types/types.js";
 import { Components } from "../store/components.js";
 import { ArchetypeComponents } from "../store/archetype-components.js";
 import { RequiredComponents } from "../required-components.js";
@@ -13,22 +13,24 @@ import { EntitySelectOptions } from "../store/entity-select-options.js";
 import { Service } from "../../service/service.js";
 import { OptionalComponents } from "../optional-components.js";
 import { createDatabase } from "./public/create-database.js";
-export type TransactionDeclaration<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>, Input extends any | void = any> = (t: Store<C, R, A>, input: Input) => void | Entity;
-export type AsyncArgsProvider<T> = () => Promise<T> | AsyncGenerator<T>;
-export type TransactionDeclarations<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>> = {
-    readonly [K: string]: TransactionDeclaration<C, R, A>;
-};
-/**
- * Converts from TransactionDeclarations to TransactionFunctions by removing the initial store argument.
- */
-export type ToTransactionFunctions<T> = {
-    [K in keyof T]: T[K] extends (t: infer S) => infer R ? R extends void | Entity ? () => R : never : T[K] extends (t: infer S, input: infer Input) => infer R ? R extends void | Entity ? (arg: Input | AsyncArgsProvider<Input>) => R : never : never;
-};
-export type TransactionFunctions = {
-    readonly [K: string]: (args?: any) => void | Entity;
-};
-export interface Database<C extends Components = never, R extends ResourceComponents = never, A extends ArchetypeComponents<StringKeyof<C & OptionalComponents>> = never, T extends TransactionFunctions = never> extends ReadonlyStore<C, R, A>, Service {
-    readonly transactions: T & Service;
+import { ResourceSchemas } from "../resource-schemas.js";
+import { ComponentSchemas } from "../component-schemas.js";
+import { FromSchemas } from "../../schema/index.js";
+import type { ActionDeclarations, ActionFunctions, ToActionFunctions } from "../store/action-functions.js";
+import { createPlugin } from "./create-plugin.js";
+type SystemFunction = () => void | Promise<void>;
+export interface Database<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C & OptionalComponents>>, F extends ActionFunctions, S extends string = never> extends ReadonlyStore<C, R, A>, Service {
+    readonly transactions: F & Service;
+    /**
+     * Provides direct mutable access to the underlying store.
+     */
+    readonly store: Store<C, R, A> & {
+        /**
+         * Provides fast access to the action functions without a transaction wrapper.
+         * This means any calls to them will NOT be observable or undoable.
+         */
+        readonly actions: F;
+    };
     readonly observe: {
         readonly components: {
             readonly [K in StringKeyof<C>]: Observe<void>;
@@ -44,10 +46,53 @@ export interface Database<C extends Components = never, R extends ResourceCompon
         archetype(id: ArchetypeId): Observe<void>;
         select<Include extends StringKeyof<C>, T extends Include>(include: readonly Include[] | ReadonlySet<string>, options?: EntitySelectOptions<C, Pick<C & RequiredComponents, T>>): Observe<readonly Entity[]>;
     };
+    readonly system: {
+        readonly functions: {
+            readonly [K in S]: SystemFunction;
+        };
+        readonly order: S[][];
+    };
     toData(): unknown;
     fromData(data: unknown): void;
-    extend<S extends Store.Schema<any, any, any>>(schema: S): Database<C & (S extends Store.Schema<infer XC, infer XR, infer XA> ? XC : never), R & (S extends Store.Schema<infer XC, infer XR, infer XA> ? XR : never), A & (S extends Store.Schema<infer XC, infer XR, infer XA> ? XA : never), T>;
+    extend<P extends Database.Plugin<any, any, any, any, any>>(plugin: P): Database<C & (P extends Database.Plugin<infer XC, any, any, any, any> ? FromSchemas<XC> : never), R & (P extends Database.Plugin<any, infer XR, any, any, any> ? FromSchemas<XR> : never), A & (P extends Database.Plugin<any, any, infer XA, any, any> ? XA : never), F & (P extends Database.Plugin<any, any, any, infer XTD, any> ? ToActionFunctions<XTD> : never), S | (P extends Database.Plugin<any, any, any, any, infer XS> ? XS : never)>;
 }
 export declare namespace Database {
     const create: typeof createDatabase;
+    type Plugin<CS extends ComponentSchemas = any, RS extends ResourceSchemas = any, A extends ArchetypeComponents<StringKeyof<CS & OptionalComponents>> = any, TD extends ActionDeclarations<FromSchemas<CS>, FromSchemas<RS>, any> = any, S extends string = any> = {
+        readonly components?: CS;
+        readonly resources?: RS;
+        readonly archetypes?: A;
+        readonly transactions?: TD;
+        readonly systems?: {
+            readonly [K in S]: {
+                readonly create: (db: Database<FromSchemas<CS>, FromSchemas<RS>, A, ToActionFunctions<TD>, S>) => SystemFunction;
+                /**
+                 * Scheduling constraints for system execution order.
+                 * - `before`: Hard constraint - this system must run before the listed systems
+                 * - `after`: Hard constraint - this system must run after the listed systems
+                 * - `during`: Soft constraint - prefer to run in the same tier as the listed systems, if dependencies allow
+                 */
+                readonly schedule?: {
+                    readonly before?: readonly NoInfer<Exclude<S, K>>[];
+                    readonly after?: readonly NoInfer<Exclude<S, K>>[];
+                    readonly during?: readonly NoInfer<Exclude<S, K>>[];
+                };
+            };
+        };
+    };
+    namespace Plugin {
+        type Intersect<T extends readonly Plugin<any, any, any, any, any>[]> = Required<Database.Plugin<{} & IntersectTuple<{
+            [K in keyof T]: T[K] extends Plugin<infer C, any, any, any, any> ? (C extends undefined ? {} : C) : never;
+        }>, {} & IntersectTuple<{
+            [K in keyof T]: T[K] extends Plugin<any, infer R, any, any, any> ? (R extends undefined ? {} : R) : never;
+        }>, {} & IntersectTuple<{
+            [K in keyof T]: T[K] extends Plugin<any, any, infer A, any, any> ? (A extends undefined ? {} : A) : never;
+        }>, {} & IntersectTuple<{
+            [K in keyof T]: T[K] extends Plugin<any, any, any, infer TD, any> ? (TD extends undefined ? Record<never, never> : TD) : never;
+        }>, Extract<{
+            [K in keyof T]: T[K] extends Plugin<any, any, any, any, infer S> ? S : never;
+        }[number], string>>>;
+        const create: typeof createPlugin;
+    }
 }
+export {};

package/dist/ecs/database/database.js

@@ -1,6 +1,48 @@
+/*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 { createDatabase } from "./public/create-database.js";
+import { createPlugin } from "./create-plugin.js";
 export var Database;
 (function (Database) {
     Database.create = createDatabase;
+    let Plugin;
+    (function (Plugin) {
+        Plugin.create = createPlugin;
+    })(Plugin = Database.Plugin || (Database.Plugin = {}));
 })(Database || (Database = {}));
+// Test type inference with new overload pattern
+const testBasePlugin = Database.Plugin.create({
+    components: {
+        position: { type: "number" },
+        health: { type: "number" }
+    }
+});
+const testExtendedPlugin = Database.Plugin.create({
+    components: {
+        velocity: { type: "number" }
+    },
+    archetypes: {
+        DynamicEntity: ["position", "velocity"],
+        LivingEntity: ["position", "health"]
+    }
+}, [testBasePlugin]);
 //# sourceMappingURL=database.js.map

package/dist/ecs/database/database.js.map

@@ -1 +1 @@
-{"version":3,"file":"database.js","sourceRoot":"","sources":["../../../src/ecs/database/database.ts"],"names":[],"mappings":"AAmCA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAgE7D,MAAM,KAAW,QAAQ,CAExB;AAFD,WAAiB,QAAQ;IACV,eAAM,GAAG,cAAc,CAAC;AACvC,CAAC,EAFgB,QAAQ,KAAR,QAAQ,QAExB"}
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../../src/ecs/database/database.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAgBX,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAW7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAoDlD,MAAM,KAAW,QAAQ,CA4CxB;AA5CD,WAAiB,QAAQ;IACV,eAAM,GAAG,cAAc,CAAC;IA6BrC,IAAiB,MAAM,CAYtB;IAZD,WAAiB,MAAM;QAWR,aAAM,GAAG,YAAY,CAAC;IACrC,CAAC,EAZgB,MAAM,GAAN,eAAM,KAAN,eAAM,QAYtB;AAEH,CAAC,EA5CgB,QAAQ,KAAR,QAAQ,QA4CxB;AA8CD,gDAAgD;AAChD,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5C,UAAU,EAAE;QACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC3B;CACF,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAC/C;IACE,UAAU,EAAE;QACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC7B;IACD,UAAU,EAAE;QACV,aAAa,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;QACvC,YAAY,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;KACrC;CACF,EACD,CAAC,cAAc,CAAC,CACjB,CAAC"}