@adobe/data 0.9.0 → 0.9.2

package/ecs/database/multi-param-inference-poc.test.js

@@ -0,0 +1,96 @@
+import { describe, test } from "vitest";
+/**
+ * Proof of Concept: Can TypeScript infer types progressively across N parameters?
+ *
+ * Goal: Each parameter's type should be inferred based on accumulated types from previous parameters
+ */
+describe("Multi-Parameter Progressive Type Inference POC", () => {
+    test("POC 1: Two parameters with progressive inference", () => {
+        function createWithTwo(first, second) {
+            const accumulated = { data: first };
+            const secondResult = second(accumulated);
+            return { data: { ...first, ...secondResult } };
+        }
+        const result = createWithTwo({ x: 10, y: 20 }, (acc) => {
+            // Can we infer acc.data.x and acc.data.y?
+            const sum = acc.data.x + acc.data.y; // Should work!
+            return { sum };
+        });
+        console.log("Result:", result.data); // { x: 10, y: 20, sum: 30 }
+    });
+    test("POC 2: Three parameters with progressive inference", () => {
+        function createWithThree(first, second, third) {
+            const step1 = { data: first };
+            const step2Result = second(step1);
+            const step2 = { data: { ...first, ...step2Result } };
+            const step3Result = third(step2);
+            return { data: { ...first, ...step2Result, ...step3Result } };
+        }
+        const result = createWithThree({ x: 10 }, (acc) => {
+            const doubled = acc.data.x * 2;
+            return { doubled };
+        }, (acc) => {
+            const sum = acc.data.x + acc.data.doubled; // Should infer both!
+            return { sum };
+        });
+        console.log("Result:", result.data); // { x: 10, doubled: 20, sum: 30 }
+    });
+    test("POC 3: Variadic parameters with rest syntax", () => {
+        // Can we use rest parameters for N steps?
+        function createWithSteps(initial, ...steps) {
+            let accumulated = { data: initial };
+            for (const step of steps) {
+                const result = step(accumulated);
+                accumulated = { data: { ...accumulated.data, ...result } };
+            }
+            return accumulated;
+        }
+        // Test it - but note: inference might be weak here
+        const result = createWithSteps({ x: 10 }, (acc) => ({ doubled: acc.data.x * 2 }), (acc) => ({ sum: acc.data.x + acc.data.doubled }));
+        console.log("Result:", result.data);
+    });
+    test("POC 4: Database-like pattern with components -> systems inference", () => {
+        function createPlugin(components, systems) {
+            const db = {
+                components,
+                get(key) { return components[key]; }
+            };
+            const systemResults = systems(db);
+            return {
+                components,
+                systems: systemResults
+            };
+        }
+        const plugin = createPlugin({
+            position: { x: 0, y: 0 },
+            velocity: { x: 1, y: 1 }
+        }, (db) => ({
+            // db should be inferred with position and velocity!
+            physicsSystem: () => {
+                const pos = db.get("position"); // Should work!
+                const vel = db.get("velocity"); // Should work!
+                console.log(pos, vel);
+            }
+        }));
+        console.log("Plugin:", plugin);
+    });
+    test("POC 5: Builder pattern with method chaining (for comparison)", () => {
+        class Builder {
+            constructor(data) {
+                this.data = data;
+            }
+            add(key, value) {
+                return new Builder({ ...this.data, [key]: value });
+            }
+            build() {
+                return this.data;
+            }
+        }
+        const result = new Builder({ x: 10 })
+            .add("doubled", 20)
+            .add("sum", 30)
+            .build();
+        console.log("Builder result:", result);
+    });
+});
+//# sourceMappingURL=multi-param-inference-poc.test.js.map

package/ecs/database/multi-param-inference-poc.test.js.map

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

package/ecs/database/old-plugin-create-with-dependencies-array.d.ts

@@ -0,0 +1,61 @@
+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 } from "../store/action-functions.js";
+import type { FromSchemas } from "../../schema/index.js";
+import type { IntersectTuple, StringKeyof } from "../../types/types.js";
+export declare namespace OldDatabaseSchema {
+    type Schema<CS extends ComponentSchemas = any, RS extends ResourceSchemas = any, A extends ArchetypeComponents<StringKeyof<CS>> = any, TD extends ActionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A> = any> = {
+        readonly components: CS;
+        readonly resources: RS;
+        readonly archetypes: A;
+        readonly transactions: TD;
+    };
+    namespace Schema {
+        /**
+         * Intersect multiple schemas into a single merged schema type
+         */
+        type Intersect<T extends readonly Schema<any, any, any, any>[]> = Schema<{} & IntersectTuple<{
+            [K in keyof T]: T[K] extends Schema<infer C, infer R, infer A, infer TD> ? C : never;
+        }>, {} & IntersectTuple<{
+            [K in keyof T]: T[K] extends Schema<any, infer R, any, any> ? R : never;
+        }>, {} & IntersectTuple<{
+            [K in keyof T]: T[K] extends Schema<any, any, infer A, any> ? A : never;
+        }>, {} & IntersectTuple<{
+            [K in keyof T]: T[K] extends Schema<any, any, any, infer TD> ? TD : never;
+        }>>;
+        /**
+         * OLD SIGNATURE: Create a schema with optional dependencies array
+         *
+         * @param schema - The schema descriptor containing components, resources, archetypes, and transactions
+         * @param dependencies - Optional array of dependency schemas to merge with the primary schema
+         * @returns Merged schema containing all properties from the input schema and dependencies
+         *
+         * Example usage:
+         * ```typescript
+         * const baseSchema = Database.Schema.create({
+         *   components: { position: { type: "number" } },
+         *   resources: { time: { default: 0 } },
+         *   archetypes: {},
+         *   transactions: {}
+         * });
+         *
+         * const extendedSchema = Database.Schema.create(
+         *   {
+         *     components: { velocity: { type: "number" } },
+         *     resources: { delta: { default: 0 } },
+         *     archetypes: { Moving: ["position", "velocity"] },
+         *     transactions: {}
+         *   },
+         *   [baseSchema] // Dependencies array
+         * );
+         * ```
+         */
+        function create<const CS extends ComponentSchemas, const RS extends ResourceSchemas, const A extends ArchetypeComponents<StringKeyof<CS & Intersect<D>["components"]>>, const TD extends ActionDeclarations<FromSchemas<CS & Intersect<D>["components"]>, FromSchemas<RS & Intersect<D>["resources"]>, A>, const D extends readonly Schema<any, any, any, any>[]>(schema: {
+            components: CS;
+            resources: RS;
+            archetypes: A;
+            transactions: TD;
+        }, dependencies?: D): Intersect<[Schema<CS, RS, A, TD>, ...D]>;
+    }
+}

package/ecs/database/old-plugin-create-with-dependencies-array.js

@@ -0,0 +1,76 @@
+/*
+ * REFERENCE FILE - OLD IMPLEMENTATION
+ *
+ * This file contains the old Database.Schema.create implementation from commit 05dfb00
+ * where the function accepted:
+ * 1. A single schema descriptor as first argument
+ * 2. An optional array of dependency schemas as second argument
+ *
+ * This was later refactored to use rest parameters instead.
+ */
+export var OldDatabaseSchema;
+(function (OldDatabaseSchema) {
+    let Schema;
+    (function (Schema) {
+        /**
+         * OLD SIGNATURE: Create a schema with optional dependencies array
+         *
+         * @param schema - The schema descriptor containing components, resources, archetypes, and transactions
+         * @param dependencies - Optional array of dependency schemas to merge with the primary schema
+         * @returns Merged schema containing all properties from the input schema and dependencies
+         *
+         * Example usage:
+         * ```typescript
+         * const baseSchema = Database.Schema.create({
+         *   components: { position: { type: "number" } },
+         *   resources: { time: { default: 0 } },
+         *   archetypes: {},
+         *   transactions: {}
+         * });
+         *
+         * const extendedSchema = Database.Schema.create(
+         *   {
+         *     components: { velocity: { type: "number" } },
+         *     resources: { delta: { default: 0 } },
+         *     archetypes: { Moving: ["position", "velocity"] },
+         *     transactions: {}
+         *   },
+         *   [baseSchema] // Dependencies array
+         * );
+         * ```
+         */
+        function create(schema, dependencies) {
+            return (dependencies ?? []).reduce((acc, curr) => {
+                return {
+                    components: { ...acc.components, ...curr.components },
+                    resources: { ...acc.resources, ...curr.resources },
+                    archetypes: { ...acc.archetypes, ...curr.archetypes },
+                    transactions: { ...acc.transactions, ...curr.transactions },
+                };
+            }, schema);
+        }
+        Schema.create = create;
+    })(Schema = OldDatabaseSchema.Schema || (OldDatabaseSchema.Schema = {}));
+})(OldDatabaseSchema || (OldDatabaseSchema = {}));
+/*
+ * KEY DIFFERENCES FROM CURRENT IMPLEMENTATION:
+ *
+ * OLD (this file):
+ * - Second parameter is an ARRAY of dependencies: `dependencies?: D`
+ * - Signature: create(schema, [dep1, dep2, dep3])
+ * - Uses reduce to merge dependencies with schema
+ *
+ * CURRENT (create-plugin.ts):
+ * - Uses REST PARAMETERS: ...args
+ * - Signature: create(schema1, schema2, schema3, ...)
+ * - Multiple overloads for 1-4 arguments
+ * - More flexible but more complex type definitions
+ *
+ * MIGRATION PATH:
+ * If you want to convert old code to new:
+ *   OLD: Database.Schema.create(schema, [dep1, dep2])
+ *   NEW: Database.Plugin.create(dep1, dep2, schema)
+ *
+ * Note: The order is reversed - dependencies come first, then the main schema
+ */
+//# sourceMappingURL=old-plugin-create-with-dependencies-array.js.map

package/ecs/database/old-plugin-create-with-dependencies-array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"old-plugin-create-with-dependencies-array.js","sourceRoot":"","sources":["../../../src/ecs/database/old-plugin-create-with-dependencies-array.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,MAAM,KAAW,iBAAiB,CA+EjC;AA/ED,WAAiB,iBAAiB;IAahC,IAAiB,MAAM,CAiEtB;IAjED,WAAiB,MAAM;QAYrB;;;;;;;;;;;;;;;;;;;;;;;;;;WA0BG;QACH,SAAgB,MAAM,CAOpB,MAKC,EACD,YAAgB;YAEhB,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;gBAC/C,OAAO;oBACL,UAAU,EAAE,EAAE,GAAG,GAAG,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE;oBACrD,SAAS,EAAE,EAAE,GAAG,GAAG,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE;oBAClD,UAAU,EAAE,EAAE,GAAG,GAAG,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE;oBACrD,YAAY,EAAE,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE;iBAC5D,CAAA;YACH,CAAC,EACC,MAAM,CACA,CAAC;QACX,CAAC;QAzBe,aAAM,SAyBrB,CAAA;IACH,CAAC,EAjEgB,MAAM,GAAN,wBAAM,KAAN,wBAAM,QAiEtB;AACH,CAAC,EA/EgB,iBAAiB,KAAjB,iBAAiB,QA+EjC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/ecs/database/overload-inference-poc.test.js

@@ -0,0 +1,109 @@
+import { describe, test } from "vitest";
+/**
+ * POC: Can we use overloads with explicit types + rest implementation for progressive inference?
+ *
+ * Strategy:
+ * - Define N overload signatures with explicit type threading
+ * - Implementation uses ...rest parameters
+ * - TypeScript should use overload signatures for inference!
+ */
+describe("Overload + Rest Implementation POC", () => {
+    test("POC 1: Simple overload with 1-3 parameters", () => {
+        // Implementation uses rest parameters
+        function create(...args) {
+            let accumulated = { data: args[0] };
+            for (let i = 1; i < args.length; i++) {
+                if (typeof args[i] === 'function') {
+                    const result = args[i](accumulated);
+                    accumulated = { data: { ...accumulated.data, ...result } };
+                }
+            }
+            return accumulated;
+        }
+        // Test 1 parameter
+        const r1 = create({ x: 10 });
+        console.log("1 param:", r1.data); // { x: 10 }
+        // Test 2 parameters with inference
+        const r2 = create({ x: 10 }, (acc) => {
+            // acc.data.x should be inferred!
+            const doubled = acc.data.x * 2;
+            return { doubled };
+        });
+        console.log("2 params:", r2.data); // { x: 10, doubled: 20 }
+        // Test 3 parameters with inference
+        const r3 = create({ x: 10 }, (acc) => {
+            const doubled = acc.data.x * 2;
+            return { doubled };
+        }, (acc) => {
+            // acc.data.x AND acc.data.doubled should be inferred!
+            const sum = acc.data.x + acc.data.doubled;
+            return { sum };
+        });
+        console.log("3 params:", r3.data); // { x: 10, doubled: 20, sum: 30 }
+    });
+    test("POC 2: Database.Plugin-like pattern", () => {
+        // Implementation with rest
+        function createPlugin(...args) {
+            const data = args[0];
+            const systemsFn = args[1];
+            const db = {
+                components: data.components,
+                resources: data.resources,
+                get(key) { return this.components[key]; },
+                getResource(key) { return this.resources[key]; }
+            };
+            const systems = systemsFn ? systemsFn(db) : {};
+            return {
+                components: data.components,
+                resources: data.resources,
+                systems
+            };
+        }
+        // Test without systems
+        const p1 = createPlugin({
+            components: { position: { x: 0, y: 0 } },
+            resources: { time: 0 }
+        });
+        console.log("Plugin 1:", p1);
+        // Test with systems - db should be fully inferred!
+        const p2 = createPlugin({
+            components: { position: { x: 0, y: 0 } },
+            resources: { time: 0 }
+        }, (db) => ({
+            // db.get and db.getResource should work without explicit typing!
+            physicsSystem: () => {
+                const pos = db.get("position");
+                const time = db.getResource("time");
+                console.log(pos, time);
+            }
+        }));
+        console.log("Plugin 2:", p2);
+    });
+    test("POC 3: Full Database.Plugin pattern with 4 overloads", () => {
+        // Implementation with rest
+        function create(...args) {
+            const [components = {}, resources = {}, archetypes = {}, transactions = {}, systemsFn] = args;
+            const db = { components, resources, archetypes, transactions };
+            const systems = systemsFn ? systemsFn(db) : {};
+            return { components, resources, archetypes, transactions, systems };
+        }
+        // Test 1 param
+        const p1 = create({ position: { x: 0 } });
+        console.log("1 param plugin:", p1);
+        // Test 2 params
+        const p2 = create({ position: { x: 0 } }, { time: 0 });
+        console.log("2 param plugin:", p2);
+        // Test 5 params with inference
+        const p3 = create({ position: { x: 0, y: 0 } }, { time: 0 }, { player: ["position"] }, { move: (store) => { } }, (db) => ({
+            // db.components, db.resources, etc should all be inferred!
+            physicsSystem: () => {
+                const pos = db.components.position;
+                const time = db.resources.time;
+                const arch = db.archetypes.player;
+                console.log(pos, time, arch);
+            }
+        }));
+        console.log("5 param plugin:", p3);
+    });
+});
+//# sourceMappingURL=overload-inference-poc.test.js.map

package/ecs/database/overload-inference-poc.test.js.map

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

package/ecs/database/public/create-database.d.ts

@@ -0,0 +1,23 @@
+import { ResourceComponents } from "../../store/resource-components.js";
+import { Store } from "../../store/index.js";
+import { Database } from "../database.js";
+import type { ToActionFunctions, ActionDeclarations } from "../../store/action-functions.js";
+import { StringKeyof } from "../../../types/types.js";
+import { Components } from "../../store/components.js";
+import { ArchetypeComponents } from "../../store/archetype-components.js";
+import { ComponentSchemas } from "../../component-schemas.js";
+import { ResourceSchemas } from "../../resource-schemas.js";
+import { FromSchemas } from "../../../schema/from-schemas.js";
+export declare function createDatabase(): Database<{}, {}, {}, {}, never>;
+export declare function createDatabase<CS extends ComponentSchemas, RS extends ResourceSchemas, A extends ArchetypeComponents<StringKeyof<CS>>, TD extends ActionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A>, S extends string>(plugin: Database.Plugin<CS, RS, A, TD, S>): Database<FromSchemas<CS>, FromSchemas<RS>, A, ToActionFunctions<TD>, S>;
+export declare function createDatabase<const C extends Components, const R extends ResourceComponents, const A extends ArchetypeComponents<StringKeyof<C>>, const TD extends ActionDeclarations<C, R, A>>(store: Store<C, R, A>, transactionDeclarations: TD): Database<C, R, A, ToActionFunctions<TD>, never>;
+export declare function createDatabase<const C extends Components, const R extends ResourceComponents, const A extends ArchetypeComponents<StringKeyof<C>>, const TD extends ActionDeclarations<C, R, A>, const S extends string>(store: Store<C, R, A>, transactionDeclarations: TD, systemDeclarations: {
+    readonly [K in S]: {
+        readonly create: (db: Database<C, R, A, ToActionFunctions<TD>, S>) => () => void | Promise<void>;
+        readonly schedule?: {
+            readonly before?: readonly S[];
+            readonly after?: readonly S[];
+            readonly during?: readonly S[];
+        };
+    };
+}): Database<C, R, A, ToActionFunctions<TD>, S>;

package/ecs/database/schedule-type-check-demo.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Demo file showing compile-time type checking for schedule.before/after
+ *
+ * This demonstrates that TypeScript will autocomplete and type-check
+ * system names from dependencies in the schedule properties.
+ */
+import { Database } from "./database.js";
+declare const validPlugin: Required<Database.Plugin<any, any, any, any, any>>;
+declare const invalidPlugin: Required<Database.Plugin<any, any, any, any, any>>;
+export { validPlugin, invalidPlugin };

package/ecs/database/schedule-type-check-demo.js

@@ -0,0 +1,71 @@
+/*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.*/
+/**
+ * Demo file showing compile-time type checking for schedule.before/after
+ *
+ * This demonstrates that TypeScript will autocomplete and type-check
+ * system names from dependencies in the schedule properties.
+ */
+import { Database } from "./database.js";
+// Create a base plugin with some systems
+const basePlugin = Database.Plugin.create({
+    systems: {
+        inputSystem: {
+            create: (_db) => () => { }
+        },
+        physicsSystem: {
+            create: (_db) => () => { }
+        },
+        audioSystem: {
+            create: (_db) => () => { }
+        }
+    }
+});
+// When extending with dependencies, schedule.before/after will be typed
+// to only accept system names from the dependencies!
+// ✅ VALID: References systems that exist in basePlugin
+const validPlugin = Database.Plugin.create({
+    systems: {
+        renderSystem: {
+            create: (_db) => () => { },
+            schedule: {
+                // TypeScript autocompletes: "inputSystem" | "physicsSystem" | "audioSystem"
+                after: ["inputSystem", "physicsSystem"]
+            }
+        }
+    }
+}, [basePlugin]);
+// ❌ INVALID: This will show a type error in your IDE
+const invalidPlugin = Database.Plugin.create({
+    systems: {
+        renderSystem: {
+            create: (_db) => () => { },
+            schedule: {
+                // @ts-expect-error - Type error: "nonExistentSystem" is not a valid system name
+                after: ["nonExistentSystem"]
+            }
+        }
+    }
+}, [basePlugin]);
+// Export to avoid unused variable warnings
+export { validPlugin, invalidPlugin };
+//# sourceMappingURL=schedule-type-check-demo.js.map

package/ecs/database/schedule-type-check-demo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-type-check-demo.js","sourceRoot":"","sources":["../../../src/ecs/database/schedule-type-check-demo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,yCAAyC;AACzC,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE;QACL,WAAW,EAAE;YACT,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;SAC7B;QACD,aAAa,EAAE;YACX,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;SAC7B;QACD,WAAW,EAAE;YACT,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;SAC7B;KACJ;CACJ,CAAC,CAAC;AAEH,wEAAwE;AACxE,qDAAqD;AAErD,uDAAuD;AACvD,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CACtC;IACI,OAAO,EAAE;QACL,YAAY,EAAE;YACV,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YAC1B,QAAQ,EAAE;gBACN,4EAA4E;gBAC5E,KAAK,EAAE,CAAC,aAAa,EAAE,eAAe,CAAU;aACnD;SACJ;KACJ;CACJ,EACD,CAAC,UAAsD,CAAC,CAC3D,CAAC;AAEF,qDAAqD;AACrD,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CACxC;IACI,OAAO,EAAE;QACL,YAAY,EAAE;YACV,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YAC1B,QAAQ,EAAE;gBACN,gFAAgF;gBAChF,KAAK,EAAE,CAAC,mBAAmB,CAAU;aACxC;SACJ;KACJ;CACJ,EACD,CAAC,UAAsD,CAAC,CAC3D,CAAC;AAEF,2CAA2C;AAC3C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC"}

package/ecs/database/test-archetype-validation.d.ts

@@ -0,0 +1,9 @@
+declare const plugin: Required<import("./database.js").Database.Plugin<{
+    readonly velocity: {
+        readonly type: "number";
+    };
+    readonly particle: {
+        readonly type: "boolean";
+    };
+}, import("../resource-schemas.js").ResourceSchemas, any, import("../store/action-functions.js").ActionDeclarations<any, any, any>, string>>;
+export { plugin };

package/ecs/database/test-archetype-validation.js

@@ -0,0 +1,14 @@
+import { createPlugin } from "./create-plugin.js";
+// This should have a type error
+const plugin = createPlugin({
+    components: {
+        velocity: { type: "number" },
+        particle: { type: "boolean" },
+    },
+    archetypes: {
+        // @ts-expect-error - particle234 does not exist
+        DoesNotExist: ["particle234"],
+    }
+});
+export { plugin };
+//# sourceMappingURL=test-archetype-validation.js.map

package/ecs/database/test-archetype-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-archetype-validation.js","sourceRoot":"","sources":["../../../src/ecs/database/test-archetype-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,gCAAgC;AAChC,MAAM,MAAM,GAAG,YAAY,CAAC;IACxB,UAAU,EAAE;QACR,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;KAChC;IACD,UAAU,EAAE;QACR,gDAAgD;QAChD,YAAY,EAAE,CAAC,aAAa,CAAC;KAChC;CACJ,CAAC,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/ecs/database/test-exactkeys.js

@@ -0,0 +1,17 @@
+import { Database } from "../index.js";
+const plugin = Database.Plugin.create({
+    resources: {
+        time: { default: 0 },
+    },
+}, {
+    systems: {
+        testSystem: {
+            create: (db) => () => {
+                const time = db.resources.time;
+                // @ts-expect-error - this should be an error
+                const dt = db.resources.deltaTime2;
+            }
+        }
+    }
+});
+//# sourceMappingURL=test-exactkeys.js.map

package/ecs/database/test-exactkeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-exactkeys.js","sourceRoot":"","sources":["../../../src/ecs/database/test-exactkeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACpC,SAAS,EAAE;QACT,IAAI,EAAE,EAAE,OAAO,EAAE,CAAW,EAAE;KAC/B;CACF,EAAE;IACD,OAAO,EAAE;QACP,UAAU,EAAE;YACV,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE;gBACnB,MAAM,IAAI,GAAW,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC;gBACvC,6CAA6C;gBAC7C,MAAM,EAAE,GAAW,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC;YAC7C,CAAC;SACF;KACF;CACF,CAAC,CAAC"}