@adobe/data 0.9.5 → 0.9.6

package/ecs/database/experimental-action-types.js

@@ -0,0 +1,275 @@
+// /*MIT License
+export {};
+// © 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.*/
+// /**
+//  * EXPERIMENTAL: Testing type inference patterns for actions
+//  * This file is for experimentation only - not part of the actual implementation
+//  */
+// 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 { TransactionDeclarations, ToTransactionFunctions } from "../store/transaction-functions.js";
+// import type { ActionDeclarations, ToActionFunctions } from "../store/action-functions.js";
+// import type { FromSchemas } from "../../schema/index.js";
+// import type { StringKeyof, Simplify } from "../../types/types.js";
+// type RemoveIndex<T> = Simplify<{
+//     [K in keyof T as
+//       string extends K ? never :
+//       number extends K ? never :
+//       symbol extends K ? never :
+//       K
+//     ]: T[K]
+//   }>;
+// // Test 1: Current approach - using ActionDeclarations constraint
+// function testCurrentApproach<
+//     const CS extends ComponentSchemas,
+//     const RS extends ResourceSchemas,
+//     const A extends ArchetypeComponents<StringKeyof<CS>>,
+//     const TD extends TransactionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A>,
+//     const S extends string,
+//     const AD extends ActionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A, ToTransactionFunctions<TD>, S> = {}
+// >(
+//     plugins: {
+//         components?: CS,
+//         resources?: RS,
+//         archetypes?: A,
+//         transactions?: TD,
+//         systems?: { readonly [K in S]: {
+//             readonly create: (db: Database<
+//                 FromSchemas<CS>,
+//                 FromSchemas<RS>,
+//                 A,
+//                 ToTransactionFunctions<TD>,
+//                 S,
+//                 ToActionFunctions<AD>
+//             >) => (() => void) | void;
+//         } },
+//         actions?: AD
+//     }
+// ) {
+//     // This should work if AD is properly constrained
+//     const testActions = plugins.actions;
+//     return testActions;
+// }
+// // Test 2: Inline explicit Database type (EXACTLY like systems pattern)
+// // Key insight: Systems use 'string' not 'S' for the system name in Database type!
+// // This breaks the circular dependency while still providing correct types
+// function testInlineExplicitType<
+//     const CS extends ComponentSchemas,
+//     const RS extends ResourceSchemas,
+//     const A extends ArchetypeComponents<StringKeyof<CS>>,
+//     const TD extends TransactionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A>,
+//     const S extends string,
+//     const AD extends ActionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A, ToTransactionFunctions<TD>, S> = {}
+// >(
+//     plugins: {
+//         components?: CS,
+//         resources?: RS,
+//         archetypes?: A,
+//         transactions?: TD,
+//         systems?: { readonly [K in S]: {
+//             readonly create: (db: Database<
+//                 FromSchemas<CS>,
+//                 FromSchemas<RS>,
+//                 A,
+//                 ToTransactionFunctions<TD>,
+//                 string, // Note: 'string' not 'S' - this is the key!
+//                 ToActionFunctions<AD>
+//             >) => (() => void) | void;
+//         } },
+//         actions?: {
+//             readonly [K in string]: (db: Database<
+//                 FromSchemas<CS>,
+//                 FromSchemas<RS>,
+//                 A,
+//                 ToTransactionFunctions<TD>,
+//                 string, // Use 'string' not 'S' to match systems pattern
+//                 ToActionFunctions<AD>
+//             >, input?: any) => any
+//         }
+//     }
+// ) {
+//     const testActions = plugins.actions;
+//     return testActions;
+// }
+// // Test 2b: Inline explicit Database type without AD in Database (to break circular dependency)
+// function testInlineExplicitTypeNoCircular<
+//     const CS extends ComponentSchemas,
+//     const RS extends ResourceSchemas,
+//     const A extends ArchetypeComponents<StringKeyof<CS>>,
+//     const TD extends TransactionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A>,
+//     const S extends string
+// >(
+//     plugins: {
+//         components?: CS,
+//         resources?: RS,
+//         archetypes?: A,
+//         transactions?: TD,
+//         systems?: { readonly [K in S]: {
+//             readonly create: (db: Database<
+//                 FromSchemas<CS>,
+//                 FromSchemas<RS>,
+//                 A,
+//                 ToTransactionFunctions<TD>,
+//                 S,
+//                 {} // Empty actions in Database type to break circular dependency
+//             >) => (() => void) | void;
+//         } },
+//         actions?: {
+//             readonly [K in string]: (db: Database<
+//                 FromSchemas<CS>,
+//                 FromSchemas<RS>,
+//                 A,
+//                 ToTransactionFunctions<TD>,
+//                 S,
+//                 {} // Empty actions - but this means actions can't call other actions
+//             >, input?: any) => any
+//         }
+//     }
+// ) {
+//     const testActions = plugins.actions;
+//     return testActions;
+// }
+// // Test 3: Using satisfies to help inference
+// function testSatisfiesApproach<
+//     const CS extends ComponentSchemas,
+//     const RS extends ResourceSchemas,
+//     const A extends ArchetypeComponents<StringKeyof<CS>>,
+//     const TD extends TransactionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A>,
+//     const S extends string,
+//     const AD extends ActionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A, ToTransactionFunctions<TD>, S> = {}
+// >(
+//     plugins: {
+//         components?: CS,
+//         resources?: RS,
+//         archetypes?: A,
+//         transactions?: TD,
+//         systems?: { readonly [K in S]: {
+//             readonly create: (db: Database<
+//                 FromSchemas<CS>,
+//                 FromSchemas<RS>,
+//                 A,
+//                 ToTransactionFunctions<TD>,
+//                 S,
+//                 ToActionFunctions<AD>
+//             >) => (() => void) | void;
+//         } },
+//         actions?: AD
+//     }
+// ) {
+//     const testActions = plugins.actions;
+//     return testActions;
+// }
+// // Test cases to verify inference
+// function testTypeInference() {
+//     // Test Case 1: Current approach - using ActionDeclarations constraint
+//     const test1 = testCurrentApproach({
+//         components: {
+//             a: { type: "number" },
+//             b: { type: "string" }
+//         },
+//         resources: {
+//             c: { default: false as boolean }
+//         },
+//         transactions: {
+//             testTx: (store) => {
+//                 // store should be typed - verify this works
+//                 store.resources.c = true;
+//             }
+//         },
+//         actions: {
+//             testAction: (db) => {
+//                 // QUESTION: Is db typed here? Or does it need 'any'?
+//                 // db should be typed - does it work?
+//                 db.transactions.testTx();
+//                 return db.resources.c;
+//             }
+//         }
+//     });
+//     // Test Case 2: Inline explicit type (like systems pattern)
+//     const test2 = testInlineExplicitType({
+//         components: {
+//             a: { type: "number" },
+//             b: { type: "string" }
+//         },
+//         resources: {
+//             c: { default: false as boolean }
+//         },
+//         transactions: {
+//             testTx: (store) => {
+//                 store.resources.c = true;
+//             }
+//         },
+//         actions: {
+//             testAction: (db) => {
+//                 // QUESTION: Is db typed here with inline explicit type?
+//                 // db should be typed with inline explicit type
+//                 db.transactions.testTx();
+//                 return db.resources.c;
+//             }
+//         }
+//     });
+//     // Test Case 3: With satisfies helper
+//     const test3 = testSatisfiesApproach({
+//         components: {
+//             a: { type: "number" },
+//             b: { type: "string" }
+//         },
+//         resources: {
+//             c: { default: false as boolean }
+//         },
+//         transactions: {
+//             testTx: (store) => {
+//                 store.resources.c = true;
+//             }
+//         },
+//         actions: {
+//             testAction: (db) => {
+//                 // QUESTION: Does satisfies help with inference?
+//                 // db should be typed
+//                 db.transactions.testTx();
+//                 return db.resources.c;
+//             }
+//         } satisfies ActionDeclarations<any, any, any, any, any>
+//     });
+//     // Test Case 4: Actions without circular dependency (can't call other actions, but can call transactions)
+//     const test4 = testActionsWithoutCircularDependency({
+//         components: {
+//             a: { type: "number" },
+//             b: { type: "string" }
+//         },
+//         resources: {
+//             c: { default: false as boolean }
+//         },
+//         transactions: {
+//             testTx: (store) => {
+//                 store.resources.c = true;
+//             }
+//         },
+//         actions: {
+//             testAction: (db) => {
+//                 // QUESTION: Is db typed here? This should work since no circular dependency
+//                 // db should be typed - can call transactions but not other actions
+//                 db.transactions.testTx();
+//                 return db.resources.c;
+//             }
+//         }
+//     });
+// }
+//# sourceMappingURL=experimental-action-types.js.map

package/ecs/database/experimental-action-types.js.map

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

package/ecs/database/from-plugin.type-test.js

@@ -0,0 +1,180 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database } from "./database.js";
+/**
+ * Type-only tests for Database.FromPlugin and Database.FromPluginWithStore helper types.
+ *
+ * These tests verify that:
+ * 1. Database.FromPlugin extracts correct Database type from simple plugins
+ * 2. Database.FromPluginWithStore includes store intersection
+ * 3. Both work with plugins using `extends`
+ * 4. Both work with combined plugins
+ *
+ * The tests verify type correctness using Assert<Equal<...>> to catch type-breaking changes early.
+ *
+ * Note: These are compile-time type checks only - they don't need to execute.
+ */
+// ============================================================================
+// PROOF: Types are equivalent but Equal check fails
+// ============================================================================
+function proofTypesAreEquivalentButNotEqual() {
+    const plugin = Database.Plugin.create({
+        components: {
+            position: { type: "number" },
+        },
+        resources: {
+            time: { default: 0 },
+        },
+        archetypes: {
+            Position: ["position"],
+        },
+    });
+    const db = Database.create(plugin);
+    // PROOF 7: Practical compatibility test - can we use ExtractedDatabase where CreatedDatabase is expected?
+    // This function accepts CreatedDatabase - if ExtractedDatabase works here, they're compatible
+    function acceptCreatedDatabase(db) {
+        // Access key properties to verify compatibility
+        const _resources = db.resources;
+        const _transactions = db.transactions;
+        const _store = db.store; // store might not be in CreatedDatabase type
+    }
+    // PROOF 8: Can we use CreatedDatabase where ExtractedDatabase is expected?
+    function acceptExtractedDatabase(db) {
+        const _resources = db.resources;
+        const _transactions = db.transactions;
+    }
+    // If both of these compile without errors, types are practically compatible
+    acceptCreatedDatabase(db); // ✅ Should work - db is CreatedDatabase
+    // CONCLUSION:
+    // The proof above shows:
+    // 1. Key properties (resources, components, archetypes) match exactly ✅
+    // 2. Equal check fails (too strict for complex types) ✅
+    // 3. Bidirectional assignability - check by uncommenting PROOF B assertions
+    //    - If both pass → types ARE equivalent, Equal is too strict
+    //    - If either fails → types are NOT equivalent, Equal correctly fails
+    //
+    // To see the actual results, hover over the type aliases in your IDE:
+    // - _ExtractedToCreated, _CreatedToExtracted, _EquivalentTypesResult, _EqualResult
+}
+// ============================================================================
+// SIMPLE PLUGIN TESTS
+// ============================================================================
+function testFromPluginSimple() {
+    const plugin = Database.Plugin.create({
+        components: {
+            position: { type: "number" },
+        },
+        resources: {
+            time: { default: 0 },
+        },
+        archetypes: {
+            Position: ["position"],
+        },
+    });
+    // Test that FromPlugin extracts a compatible type to Database.create
+    const db = Database.create(plugin);
+}
+function testFromPluginWithStoreSimple() {
+    const plugin = Database.Plugin.create({
+        components: {
+            position: { type: "number" },
+        },
+        resources: {
+            time: { default: 0 },
+        },
+        archetypes: {
+            Position: ["position"],
+        },
+    });
+}
+// ============================================================================
+// PLUGIN WITH EXTENDS TESTS
+// ============================================================================
+function testFromPluginWithExtends() {
+    const basePlugin = Database.Plugin.create({
+        components: {
+            base: { type: "string" },
+        },
+    });
+    const extendedPlugin = Database.Plugin.create({
+        extends: basePlugin,
+        components: {
+            position: { type: "number" },
+        },
+        resources: {
+            time: { default: 0 },
+        },
+    });
+    // Test that FromPlugin extracts a compatible type to Database.create
+    const db = Database.create(extendedPlugin);
+}
+function testFromPluginWithStoreExtends() {
+    const basePlugin = Database.Plugin.create({
+        components: {
+            base: { type: "string" },
+        },
+    });
+    const extendedPlugin = Database.Plugin.create({
+        extends: basePlugin,
+        components: {
+            position: { type: "number" },
+        },
+        resources: {
+            time: { default: 0 },
+        },
+    });
+}
+// ============================================================================
+// COMBINED PLUGIN TESTS
+// ============================================================================
+function testFromPluginCombined() {
+    const plugin1 = Database.Plugin.create({
+        components: {
+            a: { type: "number" },
+        },
+    });
+    const plugin2 = Database.Plugin.create({
+        components: {
+            b: { type: "string" },
+        },
+    });
+    const combinedPlugin = Database.Plugin.combine(plugin1, plugin2);
+    // Test that FromPlugin extracts a compatible type to Database.create
+    const db = Database.create(combinedPlugin);
+}
+function testFromPluginWithStoreCombined() {
+    const plugin1 = Database.Plugin.create({
+        components: {
+            a: { type: "number" },
+        },
+    });
+    const plugin2 = Database.Plugin.create({
+        components: {
+            b: { type: "string" },
+        },
+    });
+    const combinedPlugin = Database.Plugin.combine(plugin1, plugin2);
+}
+// ============================================================================
+// CONVENIENCE ALIAS TESTS
+// ============================================================================
+function testConvenienceAliases() {
+    const plugin = Database.Plugin.create({
+        components: {
+            position: { type: "number" },
+        },
+    });
+}
+// ============================================================================
+// STORE PROPERTY ACCESS TESTS
+// ============================================================================
+function testStorePropertyAccess() {
+    const plugin = Database.Plugin.create({
+        components: {
+            position: { type: "number" },
+        },
+        archetypes: {
+            Position: ["position"],
+        },
+    });
+}
+//# sourceMappingURL=from-plugin.type-test.js.map

package/ecs/database/from-plugin.type-test.js.map

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

package/ecs/database/plugin-types.js

@@ -0,0 +1,5 @@
+function createPlugin(plugins, extend) {
+    return null;
+}
+export {};
+//# sourceMappingURL=plugin-types.js.map

package/ecs/database/plugin-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-types.js","sourceRoot":"","sources":["../../../src/ecs/database/plugin-types.ts"],"names":[],"mappings":"AAeA,SAAS,YAAY,CAYjB,OAoBC,EACD,MAA+C;IAO/C,OAAO,IAAW,CAAC;AACvB,CAAC"}

package/ecs/database/type-investigation.test.js

@@ -0,0 +1,54 @@
+/*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 { describe, it } from "vitest";
+import { createPlugin } from "./create-plugin.js";
+import { Database } from "./database.js";
+import { Vec4 } from "../../math/index.js";
+import { scheduler } from "../plugins/scheduler/scheduler.js";
+describe("Type Investigation: componentSchemas type inference", () => {
+    it("should investigate ComponentSchemas index signature behavior", () => {
+        // Expected: string
+        // Test 3: What happens with a specific component schema object?
+        const specificSchema = { foo: Vec4.schema };
+        // Expected: "foo"
+    });
+    it("should investigate plugin type inference", () => {
+        const plugin = createPlugin({
+            components: {
+                foo: Vec4.schema,
+            }
+        }, [scheduler]);
+        // What is the inferred CS type parameter?
+        // This is what gets passed to createDatabaseFromPlugin
+    });
+    it("should investigate database type inference", () => {
+        const plugin = createPlugin({
+            components: {
+                foo: Vec4.schema,
+            }
+        }, [scheduler]);
+        const database = Database.create(plugin);
+        // What is StringKeyof<C> where C is the Components type parameter?
+        // This is what determines the keys of componentSchemas
+    });
+});
+//# sourceMappingURL=type-investigation.test.js.map

package/ecs/database/type-investigation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-investigation.test.js","sourceRoot":"","sources":["../../../src/ecs/database/type-investigation.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAO9D,QAAQ,CAAC,qDAAqD,EAAE,GAAG,EAAE;IACjE,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QAOpE,mBAAmB;QAEnB,gEAAgE;QAChE,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAW,CAAC;QAqCrD,kBAAkB;IACtB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAChD,MAAM,MAAM,GAAG,YAAY,CAAC;YACxB,UAAU,EAAE;gBACR,GAAG,EAAE,IAAI,CAAC,MAAM;aACnB;SACJ,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;QAKhB,0CAA0C;QAC1C,uDAAuD;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QAClD,MAAM,MAAM,GAAG,YAAY,CAAC;YACxB,UAAU,EAAE;gBACR,GAAG,EAAE,IAAI,CAAC,MAAM;aACnB;SACJ,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;QAEhB,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAKzC,mEAAmE;QACnE,uDAAuD;IAC3D,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/ecs/store/core/create-core.test.js

@@ -90,6 +90,27 @@ export function createCoreTestSuite(name, factory) {
             expect(positionOnlyArchetypes[0].components.has("position")).toBe(true);
             expect(positionOnlyArchetypes[0].components.has("health")).toBe(false);
         });
+        it("should exclude multiple components - guarantees neither component exists in result", () => {
+            const core = factory({
+                position: positionSchema,
+                health: healthSchema,
+                name: nameSchema,
+            });
+            // Create archetypes with different component combinations
+            const positionOnly = core.ensureArchetype(["id", "position"]);
+            const positionHealth = core.ensureArchetype(["id", "position", "health"]);
+            const positionName = core.ensureArchetype(["id", "position", "name"]);
+            const positionHealthName = core.ensureArchetype(["id", "position", "health", "name"]);
+            // Query for position but exclude both health and name
+            // Should only return archetype with position only (neither health nor name)
+            const result = core.queryArchetypes(["position"], { exclude: ["health", "name"] });
+            expect(result).toHaveLength(1);
+            expect(result[0].components.has("position")).toBe(true);
+            expect(result[0].components.has("health")).toBe(false);
+            expect(result[0].components.has("name")).toBe(false);
+            // Verify it's the position-only archetype
+            expect(result[0]).toBe(positionOnly);
+        });
         it("should ensure archetype creates new archetype when needed", () => {
             const core = factory({
                 position: positionSchema,