@adobe/data 0.8.6 → 0.9.0

package/dist/ecs/database/calculate-system-order.d.ts

@@ -0,0 +1,18 @@
+type SystemDeclaration = {
+    readonly create: (...args: any[]) => any;
+    readonly schedule?: {
+        readonly before?: readonly string[];
+        readonly after?: readonly string[];
+    };
+};
+/**
+ * Calculates the execution order for systems based on their scheduling constraints.
+ * Returns a 2D array where each sub-array represents a tier of systems that can
+ * execute in parallel.
+ *
+ * @param systems - Object mapping system names to their declarations
+ * @returns Array of tiers, where each tier is an array of system names that can run in parallel
+ * @throws Error if circular dependencies are detected
+ */
+export declare const calculateSystemOrder: <S extends string>(systems: { readonly [K in S]: SystemDeclaration; }) => S[][];
+export {};

package/dist/ecs/database/calculate-system-order.js

@@ -0,0 +1,113 @@
+/*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.*/
+/**
+ * Calculates the execution order for systems based on their scheduling constraints.
+ * Returns a 2D array where each sub-array represents a tier of systems that can
+ * execute in parallel.
+ *
+ * @param systems - Object mapping system names to their declarations
+ * @returns Array of tiers, where each tier is an array of system names that can run in parallel
+ * @throws Error if circular dependencies are detected
+ */
+export const calculateSystemOrder = (systems) => {
+    const systemNames = Object.keys(systems);
+    if (systemNames.length === 0) {
+        return [];
+    }
+    // Build dependency graph: dependsOn[system] = set of systems that must run before it
+    const dependsOn = new Map();
+    for (const name of systemNames) {
+        dependsOn.set(name, new Set());
+    }
+    // Process scheduling constraints
+    for (const name of systemNames) {
+        const system = systems[name];
+        const schedule = system.schedule;
+        if (schedule?.after) {
+            for (const dep of schedule.after) {
+                dependsOn.get(name).add(dep);
+            }
+        }
+        if (schedule?.before) {
+            for (const dependent of schedule.before) {
+                dependsOn.get(dependent).add(name);
+            }
+        }
+    }
+    // Topological sort with tier grouping
+    const tiers = [];
+    const processed = new Set();
+    const inProgress = new Set();
+    const detectCycle = (node, visited, stack) => {
+        if (stack.has(node)) {
+            return true;
+        }
+        if (visited.has(node)) {
+            return false;
+        }
+        visited.add(node);
+        stack.add(node);
+        const deps = dependsOn.get(node);
+        for (const dep of deps) {
+            if (detectCycle(dep, visited, stack)) {
+                return true;
+            }
+        }
+        stack.delete(node);
+        return false;
+    };
+    // Check for cycles
+    const visited = new Set();
+    const stack = new Set();
+    for (const name of systemNames) {
+        if (detectCycle(name, visited, stack)) {
+            throw new Error("Circular dependency detected in system scheduling");
+        }
+    }
+    // Build tiers
+    while (processed.size < systemNames.length) {
+        const currentTier = [];
+        for (const name of systemNames) {
+            if (processed.has(name)) {
+                continue;
+            }
+            // Check if all dependencies are processed
+            const deps = dependsOn.get(name);
+            const allDepsProcessed = Array.from(deps).every(dep => processed.has(dep));
+            if (allDepsProcessed) {
+                currentTier.push(name);
+            }
+        }
+        if (currentTier.length === 0) {
+            // Should never happen if cycle detection works
+            throw new Error("Unable to resolve system dependencies");
+        }
+        // Sort tier alphabetically for deterministic output
+        currentTier.sort();
+        tiers.push(currentTier);
+        for (const name of currentTier) {
+            processed.add(name);
+        }
+    }
+    return tiers;
+};
+//# sourceMappingURL=calculate-system-order.js.map

package/dist/ecs/database/calculate-system-order.js.map

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

package/dist/ecs/database/calculate-system-order.test.d.ts

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

package/dist/ecs/database/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/database/calculate-system-order.test.js.map

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

package/dist/ecs/database/create-plugin.d.ts

@@ -0,0 +1,67 @@
+import type { Database } from "./database.js";
+import type { ComponentSchemas } from "../component-schemas.js";
+import type { ResourceSchemas } from "../resource-schemas.js";
+import type { ArchetypeComponents } from "../store/archetype-components.js";
+import type { ActionDeclarations, ToActionFunctions } from "../store/action-functions.js";
+import type { FromSchemas } from "../../schema/index.js";
+import type { StringKeyof, IntersectTuple } from "../../types/types.js";
+import type { OptionalComponents } from "../optional-components.js";
+type SystemFunction = () => void | Promise<void>;
+type RemoveIndexSignature<T> = {
+    [K in keyof T as string extends K ? never : number extends K ? never : symbol extends K ? never : K]: T[K];
+};
+type ExtractSystemNames<P> = P extends Database.Plugin<any, any, any, any, infer S> ? S : never;
+type PluginDatabase<CS extends ComponentSchemas, RS extends ResourceSchemas, A extends ArchetypeComponents<StringKeyof<CS & OptionalComponents>>, TD extends ActionDeclarations<any, any, any>, S extends string> = Database<FromSchemas<RemoveIndexSignature<CS>>, FromSchemas<RemoveIndexSignature<RS>>, RemoveIndexSignature<{
+    readonly [K in keyof A as string extends K ? never : K]: A[K];
+} & ArchetypeComponents<StringKeyof<FromSchemas<RemoveIndexSignature<CS>> & OptionalComponents>>>, ToActionFunctions<TD>, S>;
+type MergeDependencies<D extends readonly Database.Plugin<any, any, any, any, any>[]> = {
+    components: {} & IntersectTuple<{
+        [K in keyof D]: D[K] extends Database.Plugin<infer C, any, any, any, any> ? (C extends undefined ? {} : C) : never;
+    }>;
+    resources: {} & IntersectTuple<{
+        [K in keyof D]: D[K] extends Database.Plugin<any, infer R, any, any, any> ? (R extends undefined ? {} : R) : never;
+    }>;
+    archetypes: {} & IntersectTuple<{
+        [K in keyof D]: D[K] extends Database.Plugin<any, any, infer A, any, any> ? (A extends undefined ? {} : A) : never;
+    }>;
+    transactions: {} & IntersectTuple<{
+        [K in keyof D]: D[K] extends Database.Plugin<any, any, any, infer TD, any> ? (TD extends undefined ? Record<never, never> : TD) : never;
+    }>;
+    systemNames: Extract<{
+        [K in keyof D]: ExtractSystemNames<D[K]>;
+    }[number], string>;
+};
+export declare function createPlugin<const CS extends ComponentSchemas, const RS extends ResourceSchemas, const A extends ArchetypeComponents<StringKeyof<CS & OptionalComponents>>, const TD extends ActionDeclarations<any, any, any>, const SYS extends {
+    readonly [K in string]: {
+        readonly create: (db: PluginDatabase<CS, RS, A, TD, string>) => SystemFunction;
+        readonly schedule?: {
+            readonly before?: readonly Extract<keyof SYS, string>[];
+            readonly after?: readonly Extract<keyof SYS, string>[];
+        };
+    };
+}>(descriptor: {
+    components?: CS;
+    resources?: RS;
+    archetypes?: A;
+    transactions?: TD;
+    systems?: SYS;
+}): Required<Database.Plugin<CS, RS, A, TD, StringKeyof<SYS>>>;
+export declare function createPlugin<const D extends readonly any[], const CS extends ComponentSchemas, const RS extends ResourceSchemas, const A extends ArchetypeComponents<StringKeyof<CS & MergeDependencies<D>['components'] & OptionalComponents>>, const TD extends ActionDeclarations<any, any, any>, const SYS extends {
+    readonly [K in string]: {
+        readonly create: (db: PluginDatabase<CS & MergeDependencies<D>['components'], RS & MergeDependencies<D>['resources'], A, TD & MergeDependencies<D>['transactions'], MergeDependencies<D>['systemNames'] | string>) => SystemFunction;
+        readonly schedule?: {
+            readonly before?: readonly MergeDependencies<D>['systemNames'][];
+            readonly after?: readonly MergeDependencies<D>['systemNames'][];
+        };
+    };
+}>(descriptor: {
+    components?: CS;
+    resources?: RS;
+    archetypes?: A;
+    transactions?: TD;
+    systems?: SYS;
+}, dependencies: D): Database.Plugin.Intersect<[
+    ...D,
+    Database.Plugin<CS & MergeDependencies<D>['components'], RS, A, TD, StringKeyof<SYS>>
+]>;
+export {};

package/dist/ecs/database/create-plugin.js

@@ -0,0 +1,47 @@
+/*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.*/
+// Implementation
+export function createPlugin(descriptor, dependencies) {
+    const requireIdentity = new Set(['components', 'resources', 'archetypes']);
+    const merge = (base, next) => Object.fromEntries(keys.map(key => {
+        const baseObj = base[key] ?? {};
+        const nextObj = next[key] ?? {};
+        if (requireIdentity.has(key)) {
+            const merged = { ...baseObj };
+            for (const [k, v] of Object.entries(nextObj)) {
+                if (k in baseObj && baseObj[k] !== v) {
+                    throw new Error(`Plugin merge conflict: ${key}.${k} must be identical (===) across plugins`);
+                }
+                merged[k] = v;
+            }
+            return [key, merged];
+        }
+        return [key, { ...baseObj, ...nextObj }];
+    }));
+    // Merge dependencies first
+    const mergedDeps = (dependencies ?? []).reduce(merge, emptyPlugin);
+    // Merge descriptor on top of dependencies
+    return merge(mergedDeps, descriptor);
+}
+const keys = ['components', 'resources', 'archetypes', 'transactions', 'systems'];
+const emptyPlugin = { components: {}, resources: {}, archetypes: {}, transactions: {}, systems: {} };
+//# sourceMappingURL=create-plugin.js.map

package/dist/ecs/database/create-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-plugin.js","sourceRoot":"","sources":["../../../src/ecs/database/create-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AA2HX,iBAAiB;AACjB,MAAM,UAAU,YAAY,CACxB,UAAe,EACf,YAAkB;IAElB,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;IAE3E,MAAM,KAAK,GAAG,CAAC,IAAS,EAAE,IAAS,EAAE,EAAE,CACnC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAEhC,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;YAC9B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC,IAAI,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;oBACnC,MAAM,IAAI,KAAK,CACX,0BAA0B,GAAG,IAAI,CAAC,yCAAyC,CAC9E,CAAC;gBACN,CAAC;gBACD,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC;YACD,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACzB,CAAC;QAED,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC,CAAC;IAER,2BAA2B;IAC3B,MAAM,UAAU,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAEnE,0CAA0C;IAC1C,OAAO,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AACzC,CAAC;AACD,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,CAAU,CAAC;AAC3F,MAAM,WAAW,GAA2B,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC"}

package/dist/ecs/database/create-plugin.test.d.ts

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