@adobe/data 0.8.6 → 0.9.1

package/dist/ecs/world/calculate-system-order.test.js

@@ -0,0 +1,168 @@
+/*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 { assert } from "riteway/vitest";
+import { describe, test, expect } from "vitest";
+import { calculateSystemOrder } from "./calculate-system-order.js";
+describe("calculateSystemOrder", () => {
+    test("empty systems object", async () => {
+        const systems = {};
+        const actual = calculateSystemOrder(systems);
+        const expected = [];
+        await assert({
+            given: "empty systems object",
+            should: "return empty order array",
+            actual,
+            expected,
+        });
+    });
+    test("single system with no constraints", async () => {
+        const systems = {
+            renderSystem: { create: () => () => { } },
+        };
+        const actual = calculateSystemOrder(systems);
+        const expected = [["renderSystem"]];
+        await assert({
+            given: "single system with no constraints",
+            should: "return single tier with that system",
+            actual,
+            expected,
+        });
+    });
+    test("multiple systems with no constraints", async () => {
+        const systems = {
+            inputSystem: { create: () => () => { } },
+            physicsSystem: { create: () => () => { } },
+            renderSystem: { create: () => () => { } },
+        };
+        const actual = calculateSystemOrder(systems);
+        const expected = [["inputSystem", "physicsSystem", "renderSystem"]];
+        await assert({
+            given: "multiple systems with no constraints",
+            should: "return single tier with all systems in parallel",
+            actual,
+            expected,
+        });
+    });
+    test("render system scheduled after physics", async () => {
+        const systems = {
+            physicsSystem: { create: () => () => { } },
+            renderSystem: {
+                create: () => () => { },
+                schedule: { after: ["physicsSystem"] }
+            },
+        };
+        const actual = calculateSystemOrder(systems);
+        const expected = [["physicsSystem"], ["renderSystem"]];
+        await assert({
+            given: "render system scheduled after physics",
+            should: "return physics in first tier, render in second",
+            actual,
+            expected,
+        });
+    });
+    test("physics system scheduled before render", async () => {
+        const systems = {
+            physicsSystem: {
+                create: () => () => { },
+                schedule: { before: ["renderSystem"] }
+            },
+            renderSystem: { create: () => () => { } },
+        };
+        const actual = calculateSystemOrder(systems);
+        const expected = [["physicsSystem"], ["renderSystem"]];
+        await assert({
+            given: "physics system scheduled before render",
+            should: "return physics in first tier, render in second",
+            actual,
+            expected,
+        });
+    });
+    test("complex dependency graph with parallel systems", async () => {
+        const systems = {
+            inputSystem: { create: () => () => { } },
+            physicsSystem: {
+                create: () => () => { },
+                schedule: { after: ["inputSystem"] }
+            },
+            aiSystem: {
+                create: () => () => { },
+                schedule: { after: ["inputSystem"] }
+            },
+            renderSystem: {
+                create: () => () => { },
+                schedule: { after: ["physicsSystem", "aiSystem"] }
+            },
+        };
+        const actual = calculateSystemOrder(systems);
+        const expected = [
+            ["inputSystem"],
+            ["aiSystem", "physicsSystem"],
+            ["renderSystem"]
+        ];
+        await assert({
+            given: "complex dependency graph with parallel systems",
+            should: "return correct multi-tier execution order with alphabetical sorting within tiers",
+            actual,
+            expected,
+        });
+    });
+    test("greedy scheduling with mixed independent and dependent systems", async () => {
+        const systems = {
+            systemA: { create: () => () => { } }, // No dependencies
+            systemB: {
+                create: () => () => { },
+                schedule: { after: ["systemA"] } // Depends on A
+            },
+            systemC: { create: () => () => { } }, // Independent! Should run in tier 0
+            systemD: {
+                create: () => () => { },
+                schedule: { after: ["systemB"] } // Depends on B
+            },
+        };
+        const actual = calculateSystemOrder(systems);
+        const expected = [
+            ["systemA", "systemC"], // Both independent, run together ASAP
+            ["systemB"], // Runs after A
+            ["systemD"] // Runs after B
+        ];
+        await assert({
+            given: "mixed independent and dependent systems",
+            should: "schedule independent systems in earliest tier (greedy scheduling)",
+            actual,
+            expected,
+        });
+    });
+    test("circular dependency between systems", () => {
+        const systems = {
+            systemA: {
+                create: () => () => { },
+                schedule: { after: ["systemB"] }
+            },
+            systemB: {
+                create: () => () => { },
+                schedule: { after: ["systemA"] }
+            },
+        };
+        expect(() => calculateSystemOrder(systems)).toThrow("Circular dependency detected in system scheduling");
+    });
+});
+//# sourceMappingURL=calculate-system-order.test.js.map

package/dist/ecs/world/calculate-system-order.test.js.map

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

package/dist/ecs/world/create-world-schema-test.js

@@ -0,0 +1,294 @@
+/*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 { World } from "./world.js";
+const worldSchema = World.Schema.create({
+    components: {
+        velocity: { type: "number" },
+        particle: { type: "boolean" },
+    },
+    resources: {
+        mousePosition: { type: "number", default: 0 },
+        fooPosition: { type: "number", default: 0 },
+    },
+    archetypes: {
+        Particle: ["particle"],
+        DynamicParticle: ["particle", "velocity"],
+    },
+    systems: {
+        renderSystem: {
+            create: (world) => () => { }
+        },
+        updateSystem: {
+            create: (world) => () => { }
+        }
+    }
+});
+// Test world schema dependencies and merging
+const aSchema = World.Schema.create({
+    components: {
+        a: { type: "number" },
+        b: { type: "string" }
+    },
+    resources: {
+        c: { default: "string" }
+    },
+    archetypes: {
+        one: ["a", "b"]
+    },
+    systems: {
+        systemA: {
+            create: (world) => () => { }
+        }
+    }
+});
+const bSchema = World.Schema.create({
+    components: {
+        x: { type: "number" },
+        y: { type: "string" }
+    },
+    resources: {
+        z: { default: "string" }
+    },
+    archetypes: {
+        two: ["x", "y"]
+    },
+    systems: {
+        systemB: {
+            create: (world) => () => { }
+        }
+    }
+});
+const cSchema = World.Schema.create({
+    components: {
+        m: { type: "number" },
+        n: { type: "string" }
+    },
+    resources: {
+        c: { default: "string" }
+    },
+    archetypes: {
+        three: ["m", "n", "x"]
+    },
+    systems: {
+        systemC: {
+            create: (world) => () => { }
+        }
+    }
+}, [aSchema, bSchema]);
+// Note: Systems also includes the 'create' property from the schema
+// type CheckMergedSystems = Assert<Equal<keyof MergedSchemaSystems, "systemA" | "systemB" | "systemC">>;
+// Runtime checks: verify the merged schema contains all properties
+const hasAllComponents = "a" in cSchema.components &&
+    "b" in cSchema.components &&
+    "x" in cSchema.components &&
+    "y" in cSchema.components &&
+    "m" in cSchema.components &&
+    "n" in cSchema.components;
+const hasAllResources = "c" in cSchema.resources &&
+    "z" in cSchema.resources;
+const hasAllArchetypes = "one" in cSchema.archetypes &&
+    "two" in cSchema.archetypes &&
+    "three" in cSchema.archetypes;
+const hasAllSystems = "systemA" in cSchema.systems &&
+    "systemB" in cSchema.systems &&
+    "systemC" in cSchema.systems;
+if (!hasAllComponents) {
+    throw new Error("World schema merging failed: missing components");
+}
+if (!hasAllResources) {
+    throw new Error("World schema merging failed: missing resources");
+}
+if (!hasAllArchetypes) {
+    throw new Error("World schema merging failed: missing archetypes");
+}
+if (!hasAllSystems) {
+    throw new Error("World schema merging failed: missing systems");
+}
+// Test system declarations are present
+const hasAllSystemDeclarations = "systemA" in cSchema.systems &&
+    "systemB" in cSchema.systems &&
+    "systemC" in cSchema.systems &&
+    typeof cSchema.systems.systemA.create === "function" &&
+    typeof cSchema.systems.systemB.create === "function" &&
+    typeof cSchema.systems.systemC.create === "function";
+if (!hasAllSystemDeclarations) {
+    throw new Error("World schema merging failed: missing system declarations");
+}
+// Test that individual system creates work
+const mockDb = {};
+const systemA = cSchema.systems.systemA.create(mockDb);
+const systemB = cSchema.systems.systemB.create(mockDb);
+const systemC = cSchema.systems.systemC.create(mockDb);
+if (typeof systemA !== "function" || typeof systemB !== "function" || typeof systemC !== "function") {
+    throw new Error("System create functions failed to return system functions");
+}
+// Test with more complex dependencies
+const baseSchemaWithSystems = World.Schema.create({
+    components: {
+        position: { type: "number" },
+        health: { type: "number" }
+    },
+    resources: {
+        time: { default: 0 }
+    },
+    transactions: {
+        updateHealth: () => { }
+    },
+    systems: {
+        healthSystem: {
+            create: (world) => () => { }
+        }
+    }
+});
+const extendedSchemaWithSystems = World.Schema.create({
+    components: {
+        velocity: { type: "number" }
+    },
+    resources: {
+        delta: { default: 0 }
+    },
+    archetypes: {
+        Moving: ["position", "velocity"]
+    },
+    transactions: {
+        move: () => { }
+    },
+    systems: {
+        movementSystem: {
+            create: (world) => () => { }
+        },
+        collisionSystem: {
+            create: (world) => () => { }
+        }
+    }
+}, [baseSchemaWithSystems]);
+// Runtime checks for extended schema
+const hasExtendedComponents = "position" in extendedSchemaWithSystems.components &&
+    "health" in extendedSchemaWithSystems.components &&
+    "velocity" in extendedSchemaWithSystems.components;
+const hasExtendedResources = "time" in extendedSchemaWithSystems.resources &&
+    "delta" in extendedSchemaWithSystems.resources;
+const hasExtendedTransactions = "updateHealth" in extendedSchemaWithSystems.transactions &&
+    "move" in extendedSchemaWithSystems.transactions;
+const hasExtendedSystems = "healthSystem" in extendedSchemaWithSystems.systems &&
+    "movementSystem" in extendedSchemaWithSystems.systems &&
+    "collisionSystem" in extendedSchemaWithSystems.systems;
+const hasExtendedArchetypes = "Moving" in extendedSchemaWithSystems.archetypes;
+if (!hasExtendedComponents) {
+    throw new Error("Extended world schema merging failed: missing components");
+}
+if (!hasExtendedResources) {
+    throw new Error("Extended world schema merging failed: missing resources");
+}
+if (!hasExtendedTransactions) {
+    throw new Error("Extended world schema merging failed: missing transactions");
+}
+if (!hasExtendedSystems) {
+    throw new Error("Extended world schema merging failed: missing systems");
+}
+if (!hasExtendedArchetypes) {
+    throw new Error("Extended world schema merging failed: missing archetypes");
+}
+// Test system declarations are present in extended schema
+const hasAllExtendedSystemDeclarations = "healthSystem" in extendedSchemaWithSystems.systems &&
+    "movementSystem" in extendedSchemaWithSystems.systems &&
+    "collisionSystem" in extendedSchemaWithSystems.systems &&
+    typeof extendedSchemaWithSystems.systems.healthSystem.create === "function" &&
+    typeof extendedSchemaWithSystems.systems.movementSystem.create === "function" &&
+    typeof extendedSchemaWithSystems.systems.collisionSystem.create === "function";
+if (!hasAllExtendedSystemDeclarations) {
+    throw new Error("Extended world schema merging failed: missing system declarations");
+}
+// Test that individual system creates work for extended schema
+const healthSystem = extendedSchemaWithSystems.systems.healthSystem.create(mockDb);
+const movementSystem = extendedSchemaWithSystems.systems.movementSystem.create(mockDb);
+const collisionSystem = extendedSchemaWithSystems.systems.collisionSystem.create(mockDb);
+if (typeof healthSystem !== "function" || typeof movementSystem !== "function" || typeof collisionSystem !== "function") {
+    throw new Error("Extended schema system create functions failed to return system functions");
+}
+// Test system schedule type constraints
+const scheduleTestBaseSchema = World.Schema.create({
+    components: {
+        transform: { type: "number" }
+    },
+    systems: {
+        inputSystem: {
+            create: (world) => () => { }
+        },
+        updateSystem: {
+            create: (world) => () => { },
+            // Valid: references system in same schema
+            schedule: {
+                after: ["inputSystem"]
+            }
+        },
+        physicsSystem: {
+            create: (world) => () => { },
+            // Valid: references multiple systems in same schema
+            schedule: {
+                after: ["inputSystem", "updateSystem"]
+            }
+        },
+        renderSystem: {
+            create: (world) => () => { },
+            // Valid: uses both before and after
+            schedule: {
+                after: ["physicsSystem"],
+                before: ["debugSystem"]
+            }
+        },
+        debugSystem: {
+            create: (world) => () => { },
+            // Valid: references system using before
+            schedule: {
+                after: []
+            }
+        }
+    }
+});
+// Test that schedule properties are accessible at runtime
+const hasSchedule = scheduleTestBaseSchema.systems.updateSystem.schedule !== undefined;
+const afterInput = scheduleTestBaseSchema.systems.updateSystem.schedule?.after?.[0] === "inputSystem";
+if (!hasSchedule || !afterInput) {
+    throw new Error("System schedule runtime properties missing");
+}
+// Note: Due to TypeScript's incremental type inference during object literal construction,
+// invalid system names in schedule clauses cannot be perfectly caught at compile time.
+// The type system provides good IDE hints for valid names but doesn't error on invalid ones during construction.
+// Runtime validation would be needed for strict enforcement.
+const invalidScheduleExample = World.Schema.create({
+    systems: {
+        systemA: {
+            create: (world) => () => { },
+        },
+        systemB: {
+            create: (world) => () => { },
+            schedule: {
+                // This would ideally error but TypeScript infers "nonExistentSystem" as a valid name
+                // @ts-expect-error - Type error: "nonExistentSystem" is not assignable to "systemA"
+                after: ["nonExistentSystem"],
+                before: ["systemA"]
+            }
+        }
+    }
+});
+//# sourceMappingURL=create-world-schema-test.js.map

package/dist/ecs/world/create-world-schema-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-world-schema-test.js","sourceRoot":"","sources":["../../../src/ecs/world/create-world-schema-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAIX,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IACpC,UAAU,EAAE;QACR,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;KAChC;IACD,SAAS,EAAE;QACP,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;QAC7C,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;KAC9C;IACD,UAAU,EAAE;QACR,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,eAAe,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;KAC5C;IACD,OAAO,EAAE;QACL,YAAY,EAAE;YACV,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;SAC/B;QACD,YAAY,EAAE;YACV,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;SAC/B;KACJ;CACJ,CAAC,CAAC;AAEH,6CAA6C;AAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IAChC,UAAU,EAAE;QACR,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACrB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACxB;IACD,SAAS,EAAE;QACP,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE;KAC3B;IACD,UAAU,EAAE;QACR,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;KAClB;IACD,OAAO,EAAE;QACL,OAAO,EAAE;YACL,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;SAC/B;KACJ;CACJ,CAAC,CAAC;AAEH,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IAChC,UAAU,EAAE;QACR,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACrB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACxB;IACD,SAAS,EAAE;QACP,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE;KAC3B;IACD,UAAU,EAAE;QACR,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;KAClB;IACD,OAAO,EAAE;QACL,OAAO,EAAE;YACL,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;SAC/B;KACJ;CACJ,CAAC,CAAC;AAEH,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IAChC,UAAU,EAAE;QACR,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACrB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACxB;IACD,SAAS,EAAE;QACP,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE;KAC3B;IACD,UAAU,EAAE;QACR,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;KACzB;IACD,OAAO,EAAE;QACL,OAAO,EAAE;YACL,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;SAC/B;KACJ;CACJ,EACG,CAAC,OAAO,EAAE,OAAO,CAAC,CACrB,CAAC;AAgBF,oEAAoE;AACpE,yGAAyG;AAEzG,mEAAmE;AACnE,MAAM,gBAAgB,GAClB,GAAG,IAAI,OAAO,CAAC,UAAU;IACzB,GAAG,IAAI,OAAO,CAAC,UAAU;IACzB,GAAG,IAAI,OAAO,CAAC,UAAU;IACzB,GAAG,IAAI,OAAO,CAAC,UAAU;IACzB,GAAG,IAAI,OAAO,CAAC,UAAU;IACzB,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;AAE9B,MAAM,eAAe,GACjB,GAAG,IAAI,OAAO,CAAC,SAAS;IACxB,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;AAE7B,MAAM,gBAAgB,GAClB,KAAK,IAAI,OAAO,CAAC,UAAU;IAC3B,KAAK,IAAI,OAAO,CAAC,UAAU;IAC3B,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;AAElC,MAAM,aAAa,GACf,SAAS,IAAI,OAAO,CAAC,OAAO;IAC5B,SAAS,IAAI,OAAO,CAAC,OAAO;IAC5B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;AAEjC,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACpB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;AACvE,CAAC;AAED,IAAI,CAAC,eAAe,EAAE,CAAC;IACnB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;AACtE,CAAC;AAED,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACpB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;AACvE,CAAC;AAED,IAAI,CAAC,aAAa,EAAE,CAAC;IACjB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;AACpE,CAAC;AAED,uCAAuC;AACvC,MAAM,wBAAwB,GAC1B,SAAS,IAAI,OAAO,CAAC,OAAO;IAC5B,SAAS,IAAI,OAAO,CAAC,OAAO;IAC5B,SAAS,IAAI,OAAO,CAAC,OAAO;IAC5B,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,UAAU;IACpD,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,UAAU;IACpD,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC;AAEzD,IAAI,CAAC,wBAAwB,EAAE,CAAC;IAC5B,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;AAChF,CAAC;AAED,2CAA2C;AAC3C,MAAM,MAAM,GAAQ,EAAE,CAAC;AACvB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAEvD,IAAI,OAAO,OAAO,KAAK,UAAU,IAAI,OAAO,OAAO,KAAK,UAAU,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;IAClG,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;AACjF,CAAC;AAED,sCAAsC;AACtC,MAAM,qBAAqB,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IAC9C,UAAU,EAAE;QACR,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC7B;IACD,SAAS,EAAE;QACP,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE;KACvB;IACD,YAAY,EAAE;QACV,YAAY,EAAE,GAAG,EAAE,GAAG,CAAC;KAC1B;IACD,OAAO,EAAE;QACL,YAAY,EAAE;YACV,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;SAC/B;KACJ;CACJ,CAAC,CAAC;AAEH,MAAM,yBAAyB,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IAClD,UAAU,EAAE;QACR,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC/B;IACD,SAAS,EAAE;QACP,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE;KACxB;IACD,UAAU,EAAE;QACR,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;KACnC;IACD,YAAY,EAAE;QACV,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC;KAClB;IACD,OAAO,EAAE;QACL,cAAc,EAAE;YACZ,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;SAC/B;QACD,eAAe,EAAE;YACb,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;SAC/B;KACJ;CACJ,EACG,CAAC,qBAAqB,CAAC,CAC1B,CAAC;AAuBF,qCAAqC;AACrC,MAAM,qBAAqB,GACvB,UAAU,IAAI,yBAAyB,CAAC,UAAU;IAClD,QAAQ,IAAI,yBAAyB,CAAC,UAAU;IAChD,UAAU,IAAI,yBAAyB,CAAC,UAAU,CAAC;AAEvD,MAAM,oBAAoB,GACtB,MAAM,IAAI,yBAAyB,CAAC,SAAS;IAC7C,OAAO,IAAI,yBAAyB,CAAC,SAAS,CAAC;AAEnD,MAAM,uBAAuB,GACzB,cAAc,IAAI,yBAAyB,CAAC,YAAY;IACxD,MAAM,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAErD,MAAM,kBAAkB,GACpB,cAAc,IAAI,yBAAyB,CAAC,OAAO;IACnD,gBAAgB,IAAI,yBAAyB,CAAC,OAAO;IACrD,iBAAiB,IAAI,yBAAyB,CAAC,OAAO,CAAC;AAE3D,MAAM,qBAAqB,GACvB,QAAQ,IAAI,yBAAyB,CAAC,UAAU,CAAC;AAErD,IAAI,CAAC,qBAAqB,EAAE,CAAC;IACzB,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;AAChF,CAAC;AAED,IAAI,CAAC,oBAAoB,EAAE,CAAC;IACxB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;AAC/E,CAAC;AAED,IAAI,CAAC,uBAAuB,EAAE,CAAC;IAC3B,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;AAClF,CAAC;AAED,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACtB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;AAC7E,CAAC;AAED,IAAI,CAAC,qBAAqB,EAAE,CAAC;IACzB,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;AAChF,CAAC;AAED,0DAA0D;AAC1D,MAAM,gCAAgC,GAClC,cAAc,IAAI,yBAAyB,CAAC,OAAO;IACnD,gBAAgB,IAAI,yBAAyB,CAAC,OAAO;IACrD,iBAAiB,IAAI,yBAAyB,CAAC,OAAO;IACtD,OAAO,yBAAyB,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,KAAK,UAAU;IAC3E,OAAO,yBAAyB,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,KAAK,UAAU;IAC7E,OAAO,yBAAyB,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,KAAK,UAAU,CAAC;AAEnF,IAAI,CAAC,gCAAgC,EAAE,CAAC;IACpC,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;AACzF,CAAC;AAED,+DAA+D;AAC/D,MAAM,YAAY,GAAG,yBAAyB,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACnF,MAAM,cAAc,GAAG,yBAAyB,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACvF,MAAM,eAAe,GAAG,yBAAyB,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAEzF,IAAI,OAAO,YAAY,KAAK,UAAU,IAAI,OAAO,cAAc,KAAK,UAAU,IAAI,OAAO,eAAe,KAAK,UAAU,EAAE,CAAC;IACtH,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;AACjG,CAAC;AAED,wCAAwC;AACxC,MAAM,sBAAsB,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IAC/C,UAAU,EAAE;QACR,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAChC;IACD,OAAO,EAAE;QACL,WAAW,EAAE;YACT,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;SAC/B;QACD,YAAY,EAAE;YACV,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YAC5B,0CAA0C;YAC1C,QAAQ,EAAE;gBACN,KAAK,EAAE,CAAC,aAAa,CAAC;aACzB;SACJ;QACD,aAAa,EAAE;YACX,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YAC5B,oDAAoD;YACpD,QAAQ,EAAE;gBACN,KAAK,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC;aACzC;SACJ;QACD,YAAY,EAAE;YACV,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YAC5B,oCAAoC;YACpC,QAAQ,EAAE;gBACN,KAAK,EAAE,CAAC,eAAe,CAAC;gBACxB,MAAM,EAAE,CAAC,aAAa,CAAC;aAC1B;SACJ;QACD,WAAW,EAAE;YACT,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YAC5B,wCAAwC;YACxC,QAAQ,EAAE;gBACN,KAAK,EAAE,EAAE;aACZ;SACJ;KACJ;CACJ,CAAC,CAAC;AAEH,0DAA0D;AAC1D,MAAM,WAAW,GAAG,sBAAsB,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,KAAK,SAAS,CAAC;AACvF,MAAM,UAAU,GAAG,sBAAsB,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC;AAEtG,IAAI,CAAC,WAAW,IAAI,CAAC,UAAU,EAAE,CAAC;IAC9B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;AAClE,CAAC;AAMD,2FAA2F;AAC3F,uFAAuF;AACvF,iHAAiH;AACjH,6DAA6D;AAE7D,MAAM,sBAAsB,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE;QACL,OAAO,EAAE;YACL,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;SAC/B;QACD,OAAO,EAAE;YACL,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YAC5B,QAAQ,EAAE;gBACN,qFAAqF;gBACrF,oFAAoF;gBACpF,KAAK,EAAE,CAAC,mBAAmB,CAAC;gBAC5B,MAAM,EAAE,CAAC,SAAS,CAAC;aACtB;SACJ;KACJ;CACJ,CAAC,CAAC"}

package/dist/ecs/world/create-world-type-test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/ecs/world/create-world-type-test.js

@@ -0,0 +1,129 @@
+/*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 { createWorld } from "./create-world.js";
+import { World } from "./world.js";
+// Type Test 1: Empty World
+const emptyWorld = createWorld();
+// Type Test 2: World from Schema with Components and Systems
+const schema1 = World.Schema.create({
+    components: {
+        position: { type: "vec3", default: { x: 0, y: 0, z: 0 } },
+        velocity: { type: "vec3", default: { x: 0, y: 0, z: 0 } }
+    },
+    resources: {
+        time: { default: { delta: 0, elapsed: 0 } }
+    },
+    systems: {
+        physicsSystem: {
+            create: (db) => () => { }
+        },
+        renderSystem: {
+            create: (db) => () => { }
+        }
+    }
+});
+const world1 = createWorld(schema1);
+// Type Test 3: Extended World Types
+const baseSchema = World.Schema.create({
+    components: {
+        position: { type: "vec3", default: { x: 0, y: 0, z: 0 } }
+    },
+    systems: {
+        systemA: {
+            create: () => () => { }
+        }
+    }
+});
+const extensionSchema = World.Schema.create({
+    components: {
+        velocity: { type: "vec3", default: { x: 0, y: 0, z: 0 } }
+    },
+    systems: {
+        systemB: {
+            create: () => () => { }
+        }
+    }
+});
+const baseWorld = createWorld(baseSchema);
+const extendedWorld = baseWorld.extend(extensionSchema);
+// Type Test 5: System Order Array Type
+const orderedSchema = World.Schema.create({
+    systems: {
+        inputSystem: {
+            create: () => () => { }
+        },
+        physicsSystem: {
+            create: () => () => { },
+            schedule: { after: ["inputSystem"] }
+        },
+        renderSystem: {
+            create: () => () => { },
+            schedule: { after: ["physicsSystem"] }
+        }
+    }
+});
+const orderedWorld = createWorld(orderedSchema);
+// Type Test 6: Database Access in System
+const dbAccessSchema = World.Schema.create({
+    components: {
+        position: { type: "vec3", default: { x: 0, y: 0, z: 0 } }
+    },
+    transactions: {
+        moveEntity: (store, entityId, newPos) => {
+            store.update(entityId, { position: newPos });
+        }
+    },
+    systems: {
+        testSystem: {
+            create: (db) => {
+                // Type check: db should have proper types
+                const _store = db.store;
+                const _transactions = db.transactions;
+                return () => {
+                    // System can access database
+                    const entities = db.select(["position"]);
+                    db.transactions.moveEntity(entities[0] ?? 0, { x: 1, y: 2, z: 3 });
+                };
+            }
+        }
+    }
+});
+const dbWorld = createWorld(dbAccessSchema);
+// Type Test 7: Async System Support
+const asyncSchema = World.Schema.create({
+    systems: {
+        asyncSystem: {
+            create: () => async () => {
+                await Promise.resolve();
+            }
+        },
+        syncSystem: {
+            create: () => () => {
+                // sync
+            }
+        }
+    }
+});
+const asyncWorld = createWorld(asyncSchema);
+// Runtime type check - if this file compiles, all type tests pass!
+console.log("✅ All createWorld type tests passed!");
+//# sourceMappingURL=create-world-type-test.js.map

package/dist/ecs/world/create-world-type-test.js.map

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

package/dist/ecs/world/create-world.d.ts

@@ -1,7 +1,19 @@
+import { FromSchemas } from "../../schema/index.js";
 import { StringKeyof } from "../../types/types.js";
-import { ArchetypeComponents, Database, Store, TransactionFunctions } from "../index.js";
-import { Components } from "../store/components.js";
-import { ResourceComponents } from "../store/resource-components.js";
-import { System } from "./system.js";
+import { ArchetypeComponents, ComponentSchemas, Components, Database, OptionalComponents, ResourceComponents, ResourceSchemas } from "../index.js";
+import { ActionDeclarations, ActionFunctions, ToActionFunctions } from "../store/action-functions.js";
 import { World } from "./world.js";
-export declare function createWorld<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>, T extends TransactionFunctions, SD extends Record<string, System<C, R, A, T, keyof SD & string>>>(store: Store<C, R, A>, database: Database<C, R, A, T>, systems: SD): World<C, R, A, T, keyof SD & string>;
+type SystemFunction = () => void | Promise<void>;
+type SystemDeclaration<C extends Components = any, R extends ResourceComponents = any, A extends ArchetypeComponents<StringKeyof<C & OptionalComponents>> = any, F extends ActionFunctions = any, S extends string = any> = {
+    readonly create: (world: World<C, R, A, F, S>) => SystemFunction;
+    readonly schedule?: {
+        readonly before?: readonly string[];
+        readonly after?: readonly string[];
+    };
+};
+export declare function createWorld(): World<{}, {}, {}, {}, never>;
+export declare function createWorld<CS extends ComponentSchemas, RS extends ResourceSchemas, A extends ArchetypeComponents<StringKeyof<CS>>, TD extends ActionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A>, S extends string>(schema: World.Schema<CS, RS, A, TD, S>): World<FromSchemas<CS>, FromSchemas<RS>, A, ToActionFunctions<TD>, S>;
+export declare function createWorld<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C & OptionalComponents>>, F extends ActionFunctions, S extends string>(database: Database<C, R, A, F>, systemDeclarations: {
+    readonly [K in S]: SystemDeclaration<C, R, A, F, S>;
+}): World<C, R, A, F, S>;
+export {};