@adobe/data 0.8.5 → 0.9.0

package/dist/ecs/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ecs/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,sBAAsB,CAAC"}

package/dist/ecs/plugins/scheduler/index.d.ts

@@ -0,0 +1 @@
+export * from "./scheduler.js";

package/dist/ecs/plugins/scheduler/index.js

@@ -0,0 +1,23 @@
+/*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.*/
+export * from "./scheduler.js";
+//# sourceMappingURL=index.js.map

package/dist/ecs/plugins/scheduler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ecs/plugins/scheduler/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,gBAAgB,CAAC"}

package/dist/ecs/plugins/scheduler/scheduler.d.ts

@@ -0,0 +1,8 @@
+import { Database } from "../../database/database.js";
+type SchedulerState = "running" | "paused" | "disposed";
+export declare const scheduler: Required<Database.Plugin<import("../../component-schemas.js").ComponentSchemas, {
+    readonly schedulerState: {
+        readonly default: SchedulerState;
+    };
+}, import("../../index.js").ArchetypeComponents<string>, import("../../store/action-functions.js").ActionDeclarations<any, any, any>, "schedulerSystem">>;
+export {};

package/dist/ecs/plugins/scheduler/scheduler.js

@@ -0,0 +1,52 @@
+/*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 "../../database/database.js";
+export const scheduler = Database.Plugin.create({
+    resources: {
+        schedulerState: { default: "running" }
+    },
+    systems: {
+        schedulerSystem: {
+            create: (db) => {
+                // Execute one frame
+                const executeFrame = async () => {
+                    if (db.resources.schedulerState === "running") {
+                        // Execute all systems in order (excluding schedulerSystem itself)
+                        for (const tier of db.system.order) {
+                            // Execute tier in parallel
+                            await Promise.all(tier.map((name) => db.system.functions[name]()));
+                        }
+                    }
+                    if (db.resources.schedulerState !== "disposed") {
+                        requestAnimationFrame(executeFrame);
+                    }
+                };
+                executeFrame();
+                // Return a no-op system function (the real work happens in the RAF loop)
+                return () => {
+                    // No-op: The scheduler manages its own execution through RAF
+                };
+            }
+        }
+    }
+});
+//# sourceMappingURL=scheduler.js.map

package/dist/ecs/plugins/scheduler/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../../../src/ecs/plugins/scheduler/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAItD,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE;QACP,cAAc,EAAE,EAAE,OAAO,EAAE,SAA2B,EAAE;KAC3D;IACD,OAAO,EAAE;QACL,eAAe,EAAE;YACb,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE;gBACX,oBAAoB;gBACpB,MAAM,YAAY,GAAG,KAAK,IAAI,EAAE;oBAC5B,IAAI,EAAE,CAAC,SAAS,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;wBAC5C,kEAAkE;wBAClE,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;4BACjC,2BAA2B;4BAC3B,MAAM,OAAO,CAAC,GAAG,CACb,IAAI,CAAC,GAAG,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAC1D,CAAC;wBACN,CAAC;oBACL,CAAC;oBAED,IAAI,EAAE,CAAC,SAAS,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;wBAC7C,qBAAqB,CAAC,YAAY,CAAC,CAAC;oBACxC,CAAC;gBACL,CAAC,CAAC;gBAEF,YAAY,EAAE,CAAC;gBAEf,yEAAyE;gBACzE,OAAO,GAAG,EAAE;oBACR,6DAA6D;gBACjE,CAAC,CAAC;YACN,CAAC;SACJ;KACJ;CACJ,CAAC,CAAC"}

package/dist/ecs/store/action-functions.d.ts

@@ -0,0 +1,21 @@
+import type { Store } from "./store.js";
+import { Entity } from "../entity.js";
+import { Components } from "./components.js";
+import { ResourceComponents } from "./resource-components.js";
+import { ArchetypeComponents } from "./archetype-components.js";
+import { StringKeyof } from "../../types/types.js";
+export type ActionDeclaration<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 ActionDeclarations<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>> = {
+    readonly [K: string]: ActionDeclaration<C, R, A>;
+};
+/**
+ * Converts from TransactionDeclarations to TransactionFunctions by removing the initial store argument.
+ */
+export type ToActionFunctions<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 ActionFunction = (args?: any) => void | Entity;
+export type ActionFunctions = {
+    readonly [K: string]: ActionFunction;
+};

package/dist/ecs/store/action-functions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=action-functions.js.map

package/dist/ecs/store/action-functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-functions.js","sourceRoot":"","sources":["../../../src/ecs/store/action-functions.ts"],"names":[],"mappings":""}

package/dist/ecs/store/constants/functions.d.ts

@@ -0,0 +1,14 @@
+import { ComponentSchemas } from "../../component-schemas.js";
+import { ResourceSchemas } from "../../resource-schemas.js";
+import { ArchetypeComponents } from "../archetype-components.js";
+import { OptionalComponents } from "../../optional-components.js";
+import { StringKeyof } from "../../../types/types.js";
+import type { Schema as SchemaType } from "./types.js";
+export declare const Schema: {
+    create<const CS extends ComponentSchemas, const RS extends ResourceSchemas, const A extends ArchetypeComponents<StringKeyof<CS & OptionalComponents>>>(components: CS, resources: RS, archetypes: A): {
+        readonly components: CS;
+        readonly resources: RS;
+        readonly archetypes: A;
+    };
+};
+export declare function createFromSchema<const CS extends ComponentSchemas, const RS extends ResourceSchemas, const A extends ArchetypeComponents<StringKeyof<CS>>>(schema: SchemaType<CS, RS, A>): import("../store.js").Store<import("../../../schema/schema.js").FromSchemas<CS>, import("../../../schema/schema.js").FromSchemas<RS>, A>;

package/dist/ecs/store/constants/functions.js

@@ -0,0 +1,31 @@
+/*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 { createStore } from "../create-store.js";
+export const Schema = {
+    create(components, resources, archetypes) {
+        return { components, resources, archetypes };
+    }
+};
+export function createFromSchema(schema) {
+    return createStore(schema.components, schema.resources, schema.archetypes);
+}
+//# sourceMappingURL=functions.js.map

package/dist/ecs/store/constants/functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../../../src/ecs/store/constants/functions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAOX,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,CAAC,MAAM,MAAM,GAAG;IAClB,MAAM,CAKF,UAAc,EACd,SAAa,EACb,UAAa;QAEb,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAA2C,CAAC;IAC1F,CAAC;CACJ,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAK5B,MAA6B;IAE7B,OAAO,WAAW,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;AAC/E,CAAC"}

package/dist/ecs/store/constants/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types.js";
+export { Schema, createFromSchema } from "./functions.js";

package/dist/ecs/store/constants/index.js

@@ -0,0 +1,24 @@
+/*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.*/
+export * from "./types.js";
+export { Schema, createFromSchema } from "./functions.js";
+//# sourceMappingURL=index.js.map

package/dist/ecs/store/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ecs/store/constants/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/ecs/store/constants/types.d.ts

@@ -0,0 +1,18 @@
+import type { Store } from "../store.js";
+import { Simplify, StringKeyof } from "../../../types/types.js";
+import { FromSchemas } from "../../../schema/schema.js";
+import { ComponentSchemas } from "../../component-schemas.js";
+import { ResourceSchemas } from "../../resource-schemas.js";
+import { ArchetypeComponents } from "../archetype-components.js";
+import { OptionalComponents } from "../../optional-components.js";
+export type Components<S extends Store<any, any, any>> = S extends Store<infer C, infer R, infer A> ? C & R & A : never;
+export type Resources<S extends Store<any, any, any>> = S extends Store<any, infer R, any> ? R : never;
+export type Archetypes<S extends Store<any, any, any>> = S extends Store<any, any, infer A> ? A : never;
+export type EntityValues<S extends Store<any, any, any>, K extends S extends Store<any, any, infer A> ? StringKeyof<A> : never> = Simplify<Parameters<S["archetypes"][K]["insert"]>[0] & import("../../required-components.js").RequiredComponents>;
+export type InsertValues<S extends Store<any, any, any>, K extends S extends Store<any, any, infer A> ? StringKeyof<A> : never> = Parameters<S["archetypes"][K]["insert"]>[0];
+export type Schema<CS extends ComponentSchemas, RS extends ResourceSchemas, A extends ArchetypeComponents<StringKeyof<CS & OptionalComponents>>> = {
+    readonly components: CS;
+    readonly resources: RS;
+    readonly archetypes: A;
+};
+export type FromSchema<T> = T extends Schema<infer CS, infer RS, infer A> ? import("../store.js").Store<FromSchemas<CS>, FromSchemas<RS>, A> : never;

package/dist/ecs/store/constants/types.js

@@ -0,0 +1,23 @@
+/*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.*/
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ecs/store/constants/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/ecs/store/constants/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW"}

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

@@ -21,13 +21,75 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.*/
 import { Store } from "./store.js";
 const storeSchema = Store.Schema.create({
-    velocity: { type: "number" },
-    particle: { type: "boolean" },
-}, {
-    mousePosition: { type: "number", default: 0 },
-    fooPosition: { type: "number", default: 0 },
-}, {
-    Particle: ["particle"],
-    DynamicParticle: ["particle", "velocity"],
+    components: {
+        velocity: { type: "number" },
+        particle: { type: "boolean" },
+    },
+    resources: {
+        mousePosition: { type: "number", default: 0 },
+        fooPosition: { type: "number", default: 0 },
+    },
+    archetypes: {
+        Particle: ["particle"],
+        DynamicParticle: ["particle", "velocity"],
+    },
 });
+// Test store schema dependencies and merging
+const aSchema = Store.Schema.create({
+    components: {
+        a: { type: "number" },
+        b: { type: "string" }
+    },
+    resources: {
+        c: { default: "string" }
+    },
+    archetypes: {
+        one: ["a", "b"]
+    }
+});
+const bSchema = Store.Schema.create({
+    components: {
+        x: { type: "number" },
+        y: { type: "string" }
+    },
+    resources: {
+        z: { default: "string" }
+    },
+    archetypes: {
+        two: ["x", "y"]
+    }
+});
+const cSchema = Store.Schema.create({
+    components: {
+        m: { type: "number" },
+        n: { type: "string" }
+    },
+    resources: {
+        c: { default: "string" }
+    },
+    archetypes: {
+        three: ["m", "n", "m", "x"]
+    },
+}, [aSchema, bSchema]);
+// 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;
+if (!hasAllComponents) {
+    throw new Error("Schema merging failed: missing components");
+}
+if (!hasAllResources) {
+    throw new Error("Schema merging failed: missing resources");
+}
+if (!hasAllArchetypes) {
+    throw new Error("Schema merging failed: missing archetypes");
+}
 //# sourceMappingURL=create-store-schema-test.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"create-store-schema-test.js","sourceRoot":"","sources":["../../../src/ecs/store/create-store-schema-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAKX,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CACnC;IACI,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC5B,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;CAChC,EACD;IACI,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;IAC7C,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;CAC9C,EACD;IACI,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,eAAe,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;CAC5C,CACJ,CAAA"}
+{"version":3,"file":"create-store-schema-test.js","sourceRoot":"","sources":["../../../src/ecs/store/create-store-schema-test.ts"],"names":[],"mappings":"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"}

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

@@ -5,4 +5,4 @@ import { FromSchemas } from "../../schema/from-schemas.js";
 import { ResourceSchemas } from "../resource-schemas.js";
 import { ArchetypeComponents } from "./archetype-components.js";
 import { OptionalComponents } from "../optional-components.js";
-export declare function createStore<NC extends ComponentSchemas, NR extends ResourceSchemas, A extends ArchetypeComponents<StringKeyof<NC & OptionalComponents>> = {}>(newComponentSchemas: NC, resourceSchemas?: NR, archetypeComponentNames?: A): Store<FromSchemas<NC>, FromSchemas<NR>, A>;
+export declare function createStore<CS extends ComponentSchemas = {}, RS extends ResourceSchemas = {}, A extends ArchetypeComponents<StringKeyof<CS & OptionalComponents>> = {}>(schema?: Store.Schema<CS, RS, A>): Store<FromSchemas<CS>, FromSchemas<RS>, A>;

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

@@ -21,26 +21,35 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.*/
 import { createCore } from "./core/create-core.js";
 import { selectEntities } from "./core/select-entities.js";
-export function createStore(newComponentSchemas, resourceSchemas = {}, archetypeComponentNames = {}) {
+export function createStore(schema) {
+    const schemaArg = schema;
+    const hasSchemaShape = schemaArg &&
+        typeof schemaArg === "object" &&
+        "components" in schemaArg &&
+        "resources" in schemaArg &&
+        "archetypes" in schemaArg;
+    const normalizedSchema = (hasSchemaShape
+        ? schemaArg
+        : {
+            components: (schemaArg ?? {}),
+            resources: (arguments.length > 1 ? arguments[1] : {}),
+            archetypes: (arguments.length > 2 ? arguments[2] : {}),
+        });
     const resources = {};
-    const componentAndResourceSchemas = {
-        ...newComponentSchemas,
-    };
-    // Resources are stored in the core as components, so we need to add them to the componentSchemas
-    for (const name of Object.keys(resourceSchemas)) {
-        const resourceId = name;
-        componentAndResourceSchemas[resourceId] = resourceSchemas[name];
-    }
+    const componentSchemas = {};
+    const resourceSchemas = {};
+    const archetypeComponentNames = {};
+    const componentAndResourceSchemas = {};
     const core = createCore(componentAndResourceSchemas);
     // Each resource will be stored as the only entity in an archetype of [id, <resourceName>]
     // The resource component we added above will contain the resource value
-    const ensureDefaultResourcesAndPropertiesExist = () => {
-        for (const [name, resourceSchema] of Object.entries(resourceSchemas)) {
-            const resourceId = name;
-            const archetype = core.ensureArchetype(["id", resourceId]);
-            if (archetype.rowCount === 0) {
-                archetype.insert({ [resourceId]: resourceSchema.default });
-            }
+    const ensureResourceInitialized = (name, resourceSchema) => {
+        const resourceId = name;
+        const archetype = core.ensureArchetype(["id", resourceId]);
+        if (archetype.rowCount === 0) {
+            archetype.insert({ [resourceId]: resourceSchema.default });
+        }
+        if (!Object.prototype.hasOwnProperty.call(resources, name)) {
             const row = 0;
             Object.defineProperty(resources, name, {
                 get: () => archetype.columns[resourceId].get(row),
@@ -52,25 +61,66 @@ export function createStore(newComponentSchemas, resourceSchemas = {}, archetype
             });
         }
     };
-    ensureDefaultResourcesAndPropertiesExist();
     const select = (include, options) => {
         return selectEntities(core, include, options);
     };
-    const archetypes = Object.fromEntries(Object.entries(archetypeComponentNames).map(([name, componentNames]) => {
-        const archetype = core.ensureArchetype(["id", ...componentNames]);
-        return [name, archetype];
-    }));
+    const archetypes = {};
+    const extend = (schema) => {
+        // components: existing must be identical if present
+        for (const [name, newComponentSchema] of Object.entries(schema.components)) {
+            if (name in componentAndResourceSchemas) {
+                if (componentAndResourceSchemas[name] !== newComponentSchema) {
+                    throw new Error(`Component schema for "${name}" must be identical when extending.`);
+                }
+                continue;
+            }
+            componentAndResourceSchemas[name] = newComponentSchema;
+            core.componentSchemas[name] = newComponentSchema;
+            componentSchemas[name] = newComponentSchema;
+        }
+        // resources: existing must be identical if present
+        const newResourceNames = [];
+        for (const [name, newResourceSchema] of Object.entries(schema.resources)) {
+            if (name in resourceSchemas) {
+                if (resourceSchemas[name] !== newResourceSchema) {
+                    throw new Error(`Resource schema for "${name}" must be identical when extending.`);
+                }
+                continue;
+            }
+            resourceSchemas[name] = newResourceSchema;
+            componentAndResourceSchemas[name] = newResourceSchema;
+            core.componentSchemas[name] = newResourceSchema;
+            newResourceNames.push(name);
+            ensureResourceInitialized(name, newResourceSchema);
+        }
+        // archetypes: existing must be identical if present
+        for (const [name, newComponents] of Object.entries(schema.archetypes)) {
+            if (name in archetypeComponentNames) {
+                if (archetypeComponentNames[name] !== newComponents) {
+                    throw new Error(`Archetype definition for "${name}" must be identical when extending.`);
+                }
+                continue;
+            }
+            archetypeComponentNames[name] = newComponents;
+            const archetype = core.ensureArchetype(["id", ...newComponents]);
+            archetypes[name] = archetype;
+        }
+        return store;
+    };
     const store = {
         ...core,
         resources,
         select,
         archetypes,
+        extend,
         toData: () => core.toData(),
         fromData: (data) => {
             core.fromData(data);
-            ensureDefaultResourcesAndPropertiesExist();
-        }
+            for (const [name, resourceSchema] of Object.entries(resourceSchemas)) {
+                ensureResourceInitialized(name, resourceSchema);
+            }
+        },
     };
-    return store;
+    return store.extend(normalizedSchema);
 }
 //# sourceMappingURL=create-store.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"create-store.js","sourceRoot":"","sources":["../../../src/ecs/store/create-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAQX,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAMnD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D,MAAM,UAAU,WAAW,CAKvB,mBAAuB,EACvB,kBAAsB,EAAQ,EAC9B,0BAA6B,EAAO;IAKpC,MAAM,SAAS,GAAG,EAAO,CAAC;IAE1B,MAAM,2BAA2B,GAA0C;QACvE,GAAG,mBAAmB;KACzB,CAAC;IACF,iGAAiG;IACjG,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;QAC9C,MAAM,UAAU,GAAG,IAA0B,CAAC;QAC9C,2BAA2B,CAAC,UAAU,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,CAAC,2BAA2B,CAAuB,CAAC;IAE3E,0FAA0F;IAC1F,wEAAwE;IACxE,MAAM,wCAAwC,GAAG,GAAG,EAAE;QAClD,KAAK,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;YACnE,MAAM,UAAU,GAAG,IAAsB,CAAC;YAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;YAC3D,IAAI,SAAS,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBAC3B,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,OAAO,EAAS,CAAC,CAAC;YACtE,CAAC;YACD,MAAM,GAAG,GAAG,CAAC,CAAC;YACd,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE;gBACnC,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAE,CAAC,GAAG,CAAC,GAAG,CAAC;gBAClD,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE;oBACX,SAAS,CAAC,OAAO,CAAC,UAAU,CAAE,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACnD,CAAC;gBACD,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,IAAI;aACrB,CAAC,CAAC;QACP,CAAC;IACL,CAAC,CAAA;IACD,wCAAwC,EAAE,CAAC;IAE3C,MAAM,MAAM,GAAG,CAGX,OAAiD,EACrD,OAAiH,EAC5F,EAAE;QACnB,OAAO,cAAc,CAAa,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC,CAAA;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CACjC,MAAM,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE;QACnE,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,EAAE,GAAG,cAAqB,CAAC,CAAC,CAAC;QACzE,OAAO,CAAC,IAAI,EAAE,SAAS,CAAU,CAAC;IACtC,CAAC,CAAC,CACE,CAAC;IAET,MAAM,KAAK,GAAgB;QACvB,GAAG,IAAI;QACP,SAAS;QACT,MAAM;QACN,UAAU;QACV,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE;QAC3B,QAAQ,EAAE,CAAC,IAAa,EAAE,EAAE;YACxB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACpB,wCAAwC,EAAE,CAAC;QAC/C,CAAC;KACJ,CAAC;IAEF,OAAO,KAAY,CAAC;AACxB,CAAC"}
+{"version":3,"file":"create-store.js","sourceRoot":"","sources":["../../../src/ecs/store/create-store.ts"],"names":[],"mappings":"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"}