@adobe/data 0.8.5 → 0.8.6

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.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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"}