@adobe/data 0.8.6 → 0.9.1

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

@@ -1,113 +1,80 @@
-import { topologicalSort } from "../../internal/array/index.js";
-import { SystemPhaseSchema } from "./system-phase.js";
-export function createWorld(store, database, systems) {
-    // Cache for topological sort results to avoid re-computing for same system sets
-    const topologicalSortCache = new Map();
-    const runSystems = (systemNames) => {
-        try {
-            // Check cache first (by array identity)
-            let sortedSystems = topologicalSortCache.get(systemNames);
-            if (!sortedSystems) {
-                // Build dependency graph for system scheduling
-                const edges = buildSystemEdges(systemNames, systems);
-                sortedSystems = topologicalSort(systemNames, edges);
-                // Cache the result
-                topologicalSortCache.set(systemNames, sortedSystems);
-            }
-            // Track if any system is async
-            const asyncPromises = [];
-            // Execute systems in dependency order
-            for (const systemName of sortedSystems) {
-                const system = systems[systemName];
-                try {
-                    let result = undefined;
-                    if (system.type === "store") {
-                        result = system.run(store);
-                    }
-                    else if (system.type === "database") {
-                        result = system.run(database);
-                    }
-                    // Check if the result is a Promise
-                    if (result && typeof result === 'object' && 'then' in result) {
-                        // If we find any async system, we need to handle all remaining systems async
-                        asyncPromises.push(result);
-                        // Switch to async mode for remaining systems
-                        return executeRemainingAsync(sortedSystems, systemName, asyncPromises);
-                    }
-                    // If result is not a Promise, continue synchronously
-                }
-                catch (error) {
-                    console.error(`System ${String(systemName)} failed:`, error);
-                    return Promise.reject(error);
-                }
-            }
-            // If we reach here, all systems were synchronous
-            return Promise.resolve();
-        }
-        catch (error) {
-            // Handle errors from topological sort (e.g., circular dependencies)
-            return Promise.reject(error);
-        }
-    };
-    const runPhases = async (phases) => {
-        if (phases) {
-            return runSystems(Object.keys(systems).filter(name => systems[name].phase && phases.includes(systems[name].phase)));
-        }
-        for (const phase of SystemPhaseSchema.enum) {
-            await runPhases([phase]);
-        }
-    };
-    // Helper function to handle async execution once we encounter the first async system
-    const executeRemainingAsync = async (sortedSystems, currentSystemName, pendingPromises) => {
-        // Wait for the current async system to complete
-        await Promise.all(pendingPromises);
-        // Find the index of current system to continue from next one
-        const currentIndex = sortedSystems.indexOf(currentSystemName);
-        // Execute remaining systems asynchronously
-        for (let i = currentIndex + 1; i < sortedSystems.length; i++) {
-            const systemName = sortedSystems[i];
-            const system = systems[systemName];
-            try {
-                if (system.type === "store") {
-                    await system.run(store);
-                }
-                else if (system.type === "database") {
-                    await system.run(database);
-                }
-            }
-            catch (error) {
-                console.error(`System ${String(systemName)} failed:`, error);
-                throw error;
-            }
-        }
+/*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 { Database } from "../index.js";
+import { World } from "./world.js";
+import { calculateSystemOrder } from "./calculate-system-order.js";
+export function createWorld(schemaOrDatabase, systemDeclarations) {
+    if (!schemaOrDatabase) {
+        return createWorldFromSchema(World.Schema.create({}));
+    }
+    if (systemDeclarations) {
+        return createWorldFromDatabaseAndSystems(schemaOrDatabase, systemDeclarations);
+    }
+    else {
+        return createWorldFromSchema(schemaOrDatabase);
+    }
+}
+function createWorldFromSchema(schema) {
+    const dbSchema = {
+        components: schema.components,
+        resources: schema.resources,
+        archetypes: schema.archetypes,
+        transactions: schema.transactions
     };
-    // Build edges for system dependency graph
-    const buildSystemEdges = (systemNames, systemMap) => {
-        const edges = [];
-        systemNames.forEach(name => {
-            const system = systemMap[name];
-            const nameStr = String(name);
-            // Convert 'before' constraints to edges: current → dependency
-            // (current system must run before the dependency)
-            system.schedule?.before?.forEach(dep => {
-                if (systemNames.includes(dep)) {
-                    edges.push([nameStr, String(dep)]);
-                }
-            });
-            // Convert 'after' constraints to edges: dependency → current  
-            // (current system must run after the dependency)
-            system.schedule?.after?.forEach(dep => {
-                if (systemNames.includes(dep)) {
-                    edges.push([String(dep), nameStr]);
-                }
-            });
-        });
-        return edges;
+    const database = Database.create(dbSchema);
+    return createWorldFromDatabaseAndSystems(database, schema.systems);
+}
+function createWorldFromDatabaseAndSystems(database, systemDeclarations) {
+    // Calculate execution order from schedule constraints
+    const executionOrder = calculateSystemOrder(systemDeclarations);
+    // Create partial world shell (two-phase initialization to avoid circular dependency)
+    const partialWorld = {
+        database,
+        system: {
+            functions: {}, // Empty initially
+            order: executionOrder
+        },
+        extend: undefined // Will be set later
     };
-    return {
-        ...database,
-        runPhases,
-        runSystems,
+    // NOW instantiate system functions with full world reference
+    const systemFunctions = {};
+    for (const name in systemDeclarations) {
+        systemFunctions[name] = systemDeclarations[name].create(partialWorld);
+    }
+    // Assign systems to world
+    partialWorld.system.functions = systemFunctions;
+    // Add extend method
+    const extend = (schema) => {
+        // Extend database with new components, resources, transactions
+        const extendedDatabase = database.extend(schema);
+        // Merge system declarations
+        const mergedSystemDeclarations = {
+            ...systemDeclarations,
+            ...schema.systems
+        };
+        // Create new world with merged systems
+        return createWorldFromDatabaseAndSystems(extendedDatabase, mergedSystemDeclarations);
     };
+    partialWorld.extend = extend;
+    return partialWorld;
 }
 //# sourceMappingURL=create-world.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"create-world.js","sourceRoot":"","sources":["../../../src/ecs/world/create-world.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"create-world.js","sourceRoot":"","sources":["../../../src/ecs/world/create-world.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAIX,OAAO,EAAqD,QAAQ,EAA2D,MAAM,aAAa,CAAC;AAEnJ,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AA0CnE,MAAM,UAAU,WAAW,CACvB,gBAAuF,EACvF,kBAAwB;IAExB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACpB,OAAO,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,kBAAkB,EAAE,CAAC;QACrB,OAAO,iCAAiC,CAAC,gBAAuB,EAAE,kBAAkB,CAAC,CAAC;IAC1F,CAAC;SAAM,CAAC;QACJ,OAAO,qBAAqB,CAAC,gBAAuB,CAAC,CAAC;IAC1D,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAM5B,MAAsC;IAOpC,MAAM,QAAQ,GAAG;QACb,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;KACpC,CAAC;IAEF,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3C,OAAO,iCAAiC,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,iCAAiC,CAOtC,QAA8B,EAC9B,kBAA2E;IAI3E,sDAAsD;IACtD,MAAM,cAAc,GAAG,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;IAEhE,qFAAqF;IACrF,MAAM,YAAY,GAAQ;QACtB,QAAQ;QACR,MAAM,EAAE;YACJ,SAAS,EAAE,EAAE,EAAG,kBAAkB;YAClC,KAAK,EAAE,cAAc;SACxB;QACD,MAAM,EAAE,SAAS,CAAE,oBAAoB;KAC1C,CAAC;IAEF,6DAA6D;IAC7D,MAAM,eAAe,GAAQ,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,kBAAkB,EAAE,CAAC;QACpC,eAAe,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC1E,CAAC;IAED,0BAA0B;IAC1B,YAAY,CAAC,MAAM,CAAC,SAAS,GAAG,eAAe,CAAC;IAEhD,oBAAoB;IACpB,MAAM,MAAM,GAAG,CACX,MAAU,EACP,EAAE;QACL,+DAA+D;QAC/D,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEjD,4BAA4B;QAC5B,MAAM,wBAAwB,GAAG;YAC7B,GAAG,kBAAkB;YACrB,GAAG,MAAM,CAAC,OAAO;SACb,CAAC;QAET,uCAAuC;QACvC,OAAO,iCAAiC,CAAC,gBAAuB,EAAE,wBAAwB,CAAC,CAAC;IAChG,CAAC,CAAC;IAEF,YAAY,CAAC,MAAM,GAAG,MAAM,CAAC;IAE7B,OAAO,YAA8C,CAAC;AAC1D,CAAC"}