@adobe/data 0.8.6 → 0.9.0

package/dist/ecs/database/create-plugin.test.js

@@ -0,0 +1,435 @@
+/*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, expect } from "vitest";
+import { createPlugin } from "./create-plugin.js";
+describe("Database.Plugin.create", () => {
+    describe("single descriptor (no dependencies)", () => {
+        it("should create plugin with components, resources, and archetypes", () => {
+            const plugin = createPlugin({
+                components: {
+                    velocity: { type: "number" },
+                    particle: { type: "boolean" },
+                },
+                resources: {
+                    mousePosition: { default: 0 },
+                    fooPosition: { default: 0 },
+                },
+                archetypes: {
+                    Particle: ["particle"],
+                    DynamicParticle: ["particle", "velocity"],
+                },
+                systems: {
+                    updateSystem: {
+                        create: (db) => () => {
+                            db.store.archetypes.Particle.insert({ particle: true });
+                            db.archetypes.Particle.id.toString();
+                            // @ts-expect-error - foo does not exist
+                            db.archetypes.foo;
+                        }
+                    }
+                }
+            });
+        });
+        it("should infer db type correctly with single descriptor", () => {
+            const plugin = createPlugin({
+                resources: {
+                    time: { default: 0 },
+                },
+                systems: {
+                    physicsSystem: {
+                        create: (db) => () => {
+                            const time = db.resources.time;
+                            // @ts-expect-error - this should be an error
+                            const dt = db.resources.deltaTime2;
+                        }
+                    }
+                }
+            });
+            expect(plugin).toBeDefined();
+            expect(plugin.systems).toBeDefined();
+        });
+        it("should constrain archetype references at input", () => {
+            createPlugin({
+                components: {
+                    particle: { type: "boolean" },
+                },
+                archetypes: {
+                    Particle: ["particle"],
+                    // @ts-expect-error - DoesNotExist component does not exist
+                    DoesNotExist: ["particle234"],
+                },
+            });
+        });
+        it("should constrain archetype access in systems", () => {
+            createPlugin({
+                components: {
+                    particle: { type: "boolean" },
+                },
+                archetypes: {
+                    Particle: ["particle"],
+                },
+                systems: {
+                    testSystem: {
+                        create: (db) => () => {
+                            db.archetypes.Particle; // ✅ OK
+                            // @ts-expect-error - foo does not exist
+                            db.archetypes.foo;
+                        }
+                    }
+                }
+            });
+        });
+        it("should constrain schedule references to dependency system names", () => {
+            const plugin = createPlugin({
+                systems: {
+                    renderSystem: {
+                        create: (_db) => () => { },
+                        schedule: {
+                            after: ["update"],
+                        }
+                    }
+                }
+            }, [
+                createPlugin({
+                    systems: {
+                        update: {
+                            create: (_db) => () => { }
+                        },
+                        render: {
+                            create: (_db) => () => { }
+                        }
+                    }
+                })
+            ]);
+            expect(plugin).toBeDefined();
+            expect(plugin.systems).toBeDefined();
+        });
+    });
+    describe("with dependencies", () => {
+        it("should merge components from dependencies", () => {
+            const basePlugin = createPlugin({
+                components: {
+                    position: { type: "number" },
+                    health: { type: "number" }
+                }
+            });
+            const extendedPlugin = createPlugin({
+                components: {
+                    velocity: { type: "number" }
+                }
+            }, [basePlugin]);
+            expect("position" in extendedPlugin.components).toBe(true);
+            expect("health" in extendedPlugin.components).toBe(true);
+            expect("velocity" in extendedPlugin.components).toBe(true);
+        });
+        it("should merge resources from dependencies", () => {
+            const basePlugin = createPlugin({
+                resources: {
+                    time: { default: 0 },
+                    config: { default: "default" }
+                }
+            });
+            const extendedPlugin = createPlugin({
+                resources: {
+                    delta: { default: 0 }
+                }
+            }, [basePlugin]);
+            expect("time" in extendedPlugin.resources).toBe(true);
+            expect("config" in extendedPlugin.resources).toBe(true);
+            expect("delta" in extendedPlugin.resources).toBe(true);
+        });
+        it("should merge systems from dependencies", () => {
+            const basePlugin = createPlugin({
+                systems: {
+                    inputSystem: {
+                        create: (_db) => () => { }
+                    }
+                }
+            });
+            const extendedPlugin = createPlugin({
+                systems: {
+                    renderSystem: {
+                        create: (_db) => () => { }
+                    }
+                }
+            }, [basePlugin]);
+            expect("inputSystem" in extendedPlugin.systems).toBe(true);
+            expect("renderSystem" in extendedPlugin.systems).toBe(true);
+        });
+        it("should allow systems to access dependency resources", () => {
+            const basePlugin = createPlugin({
+                resources: {
+                    time: { default: 0 }
+                }
+            });
+            const extendedPlugin = createPlugin({
+                systems: {
+                    mySystem: {
+                        create: (db) => () => {
+                            const time = db.resources.time; // Should work!
+                            expect(typeof time).toBe("number");
+                        }
+                    }
+                }
+            }, [basePlugin]);
+            expect(extendedPlugin).toBeDefined();
+        });
+        it("should allow multiple dependencies", () => {
+            const plugin1 = createPlugin({
+                components: { a: { type: "number" } }
+            });
+            const plugin2 = createPlugin({
+                components: { b: { type: "string" } }
+            });
+            const plugin3 = createPlugin({
+                components: { c: { type: "boolean" } }
+            });
+            const merged = createPlugin({
+                components: { d: { type: "number" } }
+            }, [plugin1, plugin2, plugin3]);
+            expect("a" in merged.components).toBe(true);
+            expect("b" in merged.components).toBe(true);
+            expect("c" in merged.components).toBe(true);
+            expect("d" in merged.components).toBe(true);
+        });
+    });
+    describe("schedule validation", () => {
+        it("should allow valid system references in schedule", () => {
+            expect(() => {
+                createPlugin({
+                    systems: {
+                        system1: {
+                            create: (_db) => () => { }
+                        },
+                        system2: {
+                            create: (_db) => () => { },
+                            schedule: {
+                                // @ts-expect-error - system1 does not exist
+                                after: ["system1"]
+                            }
+                        }
+                    }
+                });
+            }).not.toThrow();
+        });
+        it("should allow referencing dependency systems in schedule", () => {
+            const basePlugin = createPlugin({
+                systems: {
+                    inputSystem: {
+                        create: (_db) => () => { }
+                    }
+                }
+            });
+            expect(() => {
+                createPlugin({
+                    systems: {
+                        renderSystem: {
+                            create: (_db) => () => { },
+                            schedule: {
+                                after: ["inputSystem"] // Reference from dependency!
+                            }
+                        }
+                    }
+                }, [basePlugin]);
+            }).not.toThrow();
+        });
+        it("should validate across multiple dependencies", () => {
+            const plugin1 = createPlugin({
+                systems: {
+                    system1: {
+                        create: (_db) => () => { }
+                    }
+                }
+            });
+            const plugin2 = createPlugin({
+                systems: {
+                    system2: {
+                        create: (_db) => () => { }
+                    }
+                }
+            });
+            expect(() => {
+                createPlugin({
+                    systems: {
+                        system3: {
+                            create: (_db) => () => { },
+                            schedule: {
+                                after: ["system1", "system2"] // Both from dependencies
+                            }
+                        }
+                    }
+                }, [plugin1, plugin2]);
+            }).not.toThrow();
+        });
+        it("should constrain schedule references to dependency system names", () => {
+            const basePlugin = createPlugin({
+                systems: {
+                    inputSystem: {
+                        create: (_db) => () => { }
+                    },
+                    physicsSystem: {
+                        create: (_db) => () => { }
+                    }
+                }
+            });
+            // ✅ VALID: referencing actual systems from dependencies (no 'as const' needed!)
+            const validPlugin = createPlugin({
+                systems: {
+                    renderSystem: {
+                        create: (_db) => () => { },
+                        schedule: {
+                            // TypeScript autocompletes: "inputSystem" | "physicsSystem"
+                            after: ["inputSystem", "physicsSystem"]
+                        }
+                    }
+                }
+            }, [basePlugin]);
+            expect(validPlugin).toBeDefined();
+            expect(validPlugin.systems).toHaveProperty("renderSystem");
+        });
+    });
+    describe("type inference edge cases", () => {
+        it("should block arbitrary property access on resources", () => {
+            const plugin = createPlugin({
+                resources: {
+                    time: { default: 0 }
+                },
+                systems: {
+                    testSystem: {
+                        create: (db) => () => {
+                            const time = db.resources.time; // OK
+                            // @ts-expect-error - should error
+                            const invalid = db.resources.nonExistent;
+                        }
+                    }
+                }
+            });
+            expect(plugin).toBeDefined();
+        });
+        it("should block arbitrary property access with dependencies", () => {
+            const basePlugin = createPlugin({
+                resources: {
+                    time: { default: 0 }
+                }
+            });
+            const extendedPlugin = createPlugin({
+                resources: {
+                    delta: { default: 0 }
+                },
+                systems: {
+                    testSystem: {
+                        create: (db) => () => {
+                            const time = db.resources.time; // OK - from dependency
+                            const delta = db.resources.delta; // OK - from descriptor
+                            // @ts-expect-error - should error
+                            const invalid = db.resources.nonExistent;
+                        }
+                    }
+                }
+            }, [basePlugin]);
+            expect(extendedPlugin).toBeDefined();
+        });
+    });
+    describe("identity validation", () => {
+        it("should throw error when merging different component definitions", () => {
+            const plugin1 = createPlugin({
+                components: {
+                    health: { type: "number" }
+                }
+            });
+            expect(() => {
+                createPlugin({
+                    components: {
+                        health: { type: "string" } // Different definition
+                    }
+                }, [plugin1]);
+            }).toThrow('Plugin merge conflict: components.health must be identical (===) across plugins');
+        });
+        it("should throw error when merging different resource definitions", () => {
+            const plugin1 = createPlugin({
+                resources: {
+                    score: { default: 0 }
+                }
+            });
+            expect(() => {
+                createPlugin({
+                    resources: {
+                        score: { default: 100 } // Different definition
+                    }
+                }, [plugin1]);
+            }).toThrow('Plugin merge conflict: resources.score must be identical (===) across plugins');
+        });
+        it("should throw error when merging different archetype definitions", () => {
+            const plugin1 = createPlugin({
+                components: {
+                    position: { type: "number" },
+                    velocity: { type: "number" }
+                },
+                archetypes: {
+                    Entity: ["position"]
+                }
+            });
+            expect(() => {
+                createPlugin({
+                    archetypes: {
+                        Entity: ["position", "velocity"] // Different definition
+                    }
+                }, [plugin1]);
+            }).toThrow('Plugin merge conflict: archetypes.Entity must be identical (===) across plugins');
+        });
+        it("should allow same component with identical reference", () => {
+            const sharedComponent = { type: "number" };
+            const plugin1 = createPlugin({
+                components: {
+                    health: sharedComponent
+                }
+            });
+            expect(() => {
+                createPlugin({
+                    components: {
+                        health: sharedComponent // Same reference - OK
+                    }
+                }, [plugin1]);
+            }).not.toThrow();
+        });
+        it("should allow overwriting systems", () => {
+            const plugin1 = createPlugin({
+                systems: {
+                    update: {
+                        create: () => () => { }
+                    }
+                }
+            });
+            // Should not throw - systems can be overwritten
+            expect(() => {
+                createPlugin({
+                    systems: {
+                        update: {
+                            create: () => () => { } // Different function - OK
+                        }
+                    }
+                }, [plugin1]);
+            }).not.toThrow();
+        });
+    });
+});
+//# sourceMappingURL=create-plugin.test.js.map

package/dist/ecs/database/create-plugin.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-plugin.test.js","sourceRoot":"","sources":["../../../src/ecs/database/create-plugin.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACpC,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;QACjD,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;YACvE,MAAM,MAAM,GAAG,YAAY,CAAC;gBACxB,UAAU,EAAE;oBACR,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC5B,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;iBAChC;gBACD,SAAS,EAAE;oBACP,aAAa,EAAE,EAAE,OAAO,EAAE,CAAW,EAAE;oBACvC,WAAW,EAAE,EAAE,OAAO,EAAE,CAAW,EAAE;iBACxC;gBACD,UAAU,EAAE;oBACR,QAAQ,EAAE,CAAC,UAAU,CAAC;oBACtB,eAAe,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;iBAC5C;gBACD,OAAO,EAAE;oBACL,YAAY,EAAE;wBACV,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE;4BACjB,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;4BACxD,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC;4BACrC,wCAAwC;4BACxC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAA;wBACrB,CAAC;qBACJ;iBACJ;aACJ,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;YAC7D,MAAM,MAAM,GAAG,YAAY,CAAC;gBACxB,SAAS,EAAE;oBACP,IAAI,EAAE,EAAE,OAAO,EAAE,CAAW,EAAE;iBACjC;gBACD,OAAO,EAAE;oBACL,aAAa,EAAE;wBACX,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE;4BACjB,MAAM,IAAI,GAAW,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC;4BACvC,6CAA6C;4BAC7C,MAAM,EAAE,GAAW,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC;wBAC/C,CAAC;qBACJ;iBACJ;aACJ,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACtD,YAAY,CAAC;gBACT,UAAU,EAAE;oBACR,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;iBAChC;gBACD,UAAU,EAAE;oBACR,QAAQ,EAAE,CAAC,UAAU,CAAC;oBACtB,2DAA2D;oBAC3D,YAAY,EAAE,CAAC,aAAa,CAAC;iBAChC;aACJ,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACpD,YAAY,CAAC;gBACT,UAAU,EAAE;oBACR,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;iBAChC;gBACD,UAAU,EAAE;oBACR,QAAQ,EAAE,CAAC,UAAU,CAAC;iBACzB;gBACD,OAAO,EAAE;oBACL,UAAU,EAAE;wBACR,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE;4BACjB,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,OAAO;4BAC/B,wCAAwC;4BACxC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;wBACtB,CAAC;qBACJ;iBACJ;aACJ,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;YACvE,MAAM,MAAM,GAAG,YAAY,CACvB;gBACI,OAAO,EAAE;oBACL,YAAY,EAAE;wBACV,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;wBAC1B,QAAQ,EAAE;4BACN,KAAK,EAAE,CAAC,QAAQ,CAAC;yBACpB;qBACJ;iBACJ;aACJ,EACD;gBACI,YAAY,CAAC;oBACT,OAAO,EAAE;wBACL,MAAM,EAAE;4BACJ,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;yBAC7B;wBACD,MAAM,EAAE;4BACJ,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;yBAC7B;qBACJ;iBACJ,CAAC;aACL,CACJ,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACjD,MAAM,UAAU,GAAG,YAAY,CAAC;gBAC5B,UAAU,EAAE;oBACR,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC5B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC7B;aACJ,CAAC,CAAC;YAEH,MAAM,cAAc,GAAG,YAAY,CAC/B;gBACI,UAAU,EAAE;oBACR,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC/B;aACJ,EACD,CAAC,UAAU,CAAC,CACf,CAAC;YAEF,MAAM,CAAC,UAAU,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3D,MAAM,CAAC,QAAQ,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzD,MAAM,CAAC,UAAU,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAChD,MAAM,UAAU,GAAG,YAAY,CAAC;gBAC5B,SAAS,EAAE;oBACP,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE;oBACpB,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE;iBACjC;aACJ,CAAC,CAAC;YAEH,MAAM,cAAc,GAAG,YAAY,CAC/B;gBACI,SAAS,EAAE;oBACP,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE;iBACxB;aACJ,EACD,CAAC,UAAU,CAAC,CACf,CAAC;YAEF,MAAM,CAAC,MAAM,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,CAAC,QAAQ,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxD,MAAM,CAAC,OAAO,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAC9C,MAAM,UAAU,GAAG,YAAY,CAAC;gBAC5B,OAAO,EAAE;oBACL,WAAW,EAAE;wBACT,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;qBAC7B;iBACJ;aACJ,CAAC,CAAC;YAEH,MAAM,cAAc,GAAG,YAAY,CAC/B;gBACI,OAAO,EAAE;oBACL,YAAY,EAAE;wBACV,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;qBAC7B;iBACJ;aACJ,EACD,CAAC,UAAU,CAAC,CACf,CAAC;YAEF,MAAM,CAAC,aAAa,IAAI,cAAc,CAAC,OAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5D,MAAM,CAAC,cAAc,IAAI,cAAc,CAAC,OAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC3D,MAAM,UAAU,GAAG,YAAY,CAAC;gBAC5B,SAAS,EAAE;oBACP,IAAI,EAAE,EAAE,OAAO,EAAE,CAAW,EAAE;iBACjC;aACJ,CAAC,CAAC;YAEH,MAAM,cAAc,GAAG,YAAY,CAC/B;gBACI,OAAO,EAAE;oBACL,QAAQ,EAAE;wBACN,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE;4BACjB,MAAM,IAAI,GAAW,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAE,eAAe;4BACxD,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;wBACvC,CAAC;qBACJ;iBACJ;aACJ,EACD,CAAC,UAAU,CAAC,CACf,CAAC;YAEF,MAAM,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC1C,MAAM,OAAO,GAAG,YAAY,CAAC;gBACzB,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;aACxC,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,YAAY,CAAC;gBACzB,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;aACxC,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,YAAY,CAAC;gBACzB,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;aACzC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,YAAY,CACvB;gBACI,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;aACxC,EACD,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAC9B,CAAC;YAEF,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACjC,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YACxD,MAAM,CAAC,GAAG,EAAE;gBACR,YAAY,CAAC;oBACT,OAAO,EAAE;wBACL,OAAO,EAAE;4BACL,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;yBAC7B;wBACD,OAAO,EAAE;4BACL,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;4BAC1B,QAAQ,EAAE;gCACN,4CAA4C;gCAC5C,KAAK,EAAE,CAAC,SAAS,CAAC;6BACrB;yBACJ;qBACJ;iBACJ,CAAC,CAAC;YACP,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;YAC/D,MAAM,UAAU,GAAG,YAAY,CAAC;gBAC5B,OAAO,EAAE;oBACL,WAAW,EAAE;wBACT,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;qBAC7B;iBACJ;aACJ,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,EAAE;gBACR,YAAY,CACR;oBACI,OAAO,EAAE;wBACL,YAAY,EAAE;4BACV,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;4BAC1B,QAAQ,EAAE;gCACN,KAAK,EAAE,CAAC,aAAa,CAAC,CAAE,6BAA6B;6BACxD;yBACJ;qBACJ;iBACJ,EACD,CAAC,UAAU,CAAC,CACf,CAAC;YACN,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACpD,MAAM,OAAO,GAAG,YAAY,CAAC;gBACzB,OAAO,EAAE;oBACL,OAAO,EAAE;wBACL,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;qBAC7B;iBACJ;aACJ,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,YAAY,CAAC;gBACzB,OAAO,EAAE;oBACL,OAAO,EAAE;wBACL,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;qBAC7B;iBACJ;aACJ,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,EAAE;gBACR,YAAY,CACR;oBACI,OAAO,EAAE;wBACL,OAAO,EAAE;4BACL,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;4BAC1B,QAAQ,EAAE;gCACN,KAAK,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAE,yBAAyB;6BAC3D;yBACJ;qBACJ;iBACJ,EACD,CAAC,OAAO,EAAE,OAAO,CAAC,CACrB,CAAC;YACN,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;YACvE,MAAM,UAAU,GAAG,YAAY,CAAC;gBAC5B,OAAO,EAAE;oBACL,WAAW,EAAE;wBACT,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;qBAC7B;oBACD,aAAa,EAAE;wBACX,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;qBAC7B;iBACJ;aACJ,CAAC,CAAC;YAEH,gFAAgF;YAChF,MAAM,WAAW,GAAG,YAAY,CAC5B;gBACI,OAAO,EAAE;oBACL,YAAY,EAAE;wBACV,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;wBAC1B,QAAQ,EAAE;4BACN,4DAA4D;4BAC5D,KAAK,EAAE,CAAC,aAAa,EAAE,eAAe,CAAC;yBAC1C;qBACJ;iBACJ;aACJ,EACD,CAAC,UAAU,CAAC,CACf,CAAC;YAEF,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;YAClC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC3D,MAAM,MAAM,GAAG,YAAY,CAAC;gBACxB,SAAS,EAAE;oBACP,IAAI,EAAE,EAAE,OAAO,EAAE,CAAW,EAAE;iBACjC;gBACD,OAAO,EAAE;oBACL,UAAU,EAAE;wBACR,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE;4BACjB,MAAM,IAAI,GAAW,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAE,KAAK;4BAC9C,kCAAkC;4BAClC,MAAM,OAAO,GAAW,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC;wBACrD,CAAC;qBACJ;iBACJ;aACJ,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;YAChE,MAAM,UAAU,GAAG,YAAY,CAAC;gBAC5B,SAAS,EAAE;oBACP,IAAI,EAAE,EAAE,OAAO,EAAE,CAAW,EAAE;iBACjC;aACJ,CAAC,CAAC;YAEH,MAAM,cAAc,GAAG,YAAY,CAC/B;gBACI,SAAS,EAAE;oBACP,KAAK,EAAE,EAAE,OAAO,EAAE,CAAW,EAAE;iBAClC;gBACD,OAAO,EAAE;oBACL,UAAU,EAAE;wBACR,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE;4BACjB,MAAM,IAAI,GAAW,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAI,uBAAuB;4BAClE,MAAM,KAAK,GAAW,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAG,uBAAuB;4BACnE,kCAAkC;4BAClC,MAAM,OAAO,GAAW,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC;wBACrD,CAAC;qBACJ;iBACJ;aACJ,EACD,CAAC,UAAU,CAAC,CACf,CAAC;YAEF,MAAM,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACjC,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;YACvE,MAAM,OAAO,GAAG,YAAY,CAAC;gBACzB,UAAU,EAAE;oBACR,MAAM,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;iBACtC;aACJ,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,EAAE;gBACR,YAAY,CAAC;oBACT,UAAU,EAAE;wBACR,MAAM,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,CAAC,uBAAuB;qBAC9D;iBACJ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC,OAAO,CAAC,iFAAiF,CAAC,CAAC;QAClG,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;YACtE,MAAM,OAAO,GAAG,YAAY,CAAC;gBACzB,SAAS,EAAE;oBACP,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE;iBACxB;aACJ,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,EAAE;gBACR,YAAY,CAAC;oBACT,SAAS,EAAE;wBACP,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,uBAAuB;qBAClD;iBACJ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC,OAAO,CAAC,+EAA+E,CAAC,CAAC;QAChG,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;YACvE,MAAM,OAAO,GAAG,YAAY,CAAC;gBACzB,UAAU,EAAE;oBACR,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC5B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC/B;gBACD,UAAU,EAAE;oBACR,MAAM,EAAE,CAAC,UAAU,CAAC;iBACvB;aACJ,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,EAAE;gBACR,YAAY,CAAC;oBACT,UAAU,EAAE;wBACR,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,uBAAuB;qBAC3D;iBACJ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC,OAAO,CAAC,iFAAiF,CAAC,CAAC;QAClG,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC5D,MAAM,eAAe,GAAG,EAAE,IAAI,EAAE,QAAiB,EAAE,CAAC;YACpD,MAAM,OAAO,GAAG,YAAY,CAAC;gBACzB,UAAU,EAAE;oBACR,MAAM,EAAE,eAAe;iBAC1B;aACJ,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,EAAE;gBACR,YAAY,CAAC;oBACT,UAAU,EAAE;wBACR,MAAM,EAAE,eAAe,CAAC,sBAAsB;qBACjD;iBACJ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YACxC,MAAM,OAAO,GAAG,YAAY,CAAC;gBACzB,OAAO,EAAE;oBACL,MAAM,EAAE;wBACJ,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;qBAC1B;iBACJ;aACJ,CAAC,CAAC;YAEH,gDAAgD;YAChD,MAAM,CAAC,GAAG,EAAE;gBACR,YAAY,CAAC;oBACT,OAAO,EAAE;wBACL,MAAM,EAAE;4BACJ,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,0BAA0B;yBACrD;qBACJ;iBACJ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/ecs/database/database-schema/create-database-schema.d.ts

@@ -3,12 +3,12 @@ import { StringKeyof } from "../../../types/types.js";
 import { ComponentSchemas } from "../../component-schemas.js";
 import { ResourceSchemas } from "../../resource-schemas.js";
 import { ArchetypeComponents } from "../../store/archetype-components.js";
-import { TransactionDeclarations } from "../database.js";
+import type { ActionDeclarations } from "../../store/action-functions.js";
 import { DatabaseFromSchema, DatabaseSchema } from "./database-schema.js";
-export declare function createDatabaseSchema<const CS extends ComponentSchemas, const RS extends ResourceSchemas, const A extends ArchetypeComponents<StringKeyof<CS>>, const TD extends TransactionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A>>(components: CS, resources: RS, archetypes: A, transactions: TD): {
+export declare function createDatabaseSchema<const CS extends ComponentSchemas, const RS extends ResourceSchemas, const A extends ArchetypeComponents<StringKeyof<CS>>, const TD extends ActionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A>>(components: CS, resources: RS, archetypes: A, transactions: TD): {
     readonly components: CS;
     readonly resources: RS;
     readonly archetypes: A;
     readonly transactions: TD;
 };
-export declare function createDatabaseFromSchema<const CS extends ComponentSchemas, const RS extends ResourceSchemas, const A extends ArchetypeComponents<StringKeyof<CS>>, const TD extends TransactionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A>>(schema: DatabaseSchema<CS, RS, A, TD>): DatabaseFromSchema<typeof schema>;
+export declare function createDatabaseFromSchema<const CS extends ComponentSchemas, const RS extends ResourceSchemas, const A extends ArchetypeComponents<StringKeyof<CS>>, const TD extends ActionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A>>(schema: DatabaseSchema<CS, RS, A, TD>): DatabaseFromSchema<typeof schema>;

package/dist/ecs/database/database-schema/database-schema.d.ts

@@ -2,12 +2,13 @@ import { FromSchemas } from "../../../schema/from-schemas.js";
 import { ComponentSchemas } from "../../component-schemas.js";
 import { ResourceSchemas } from "../../resource-schemas.js";
 import { StringKeyof } from "../../../types/types.js";
-import { Database, ToTransactionFunctions, TransactionDeclarations } from "../database.js";
+import { Database } from "../database.js";
+import type { ToActionFunctions, ActionDeclarations } from "../../store/action-functions.js";
 import { ArchetypeComponents } from "../../store/archetype-components.js";
-export type DatabaseSchema<CS extends ComponentSchemas, RS extends ResourceSchemas, A extends ArchetypeComponents<StringKeyof<CS>>, TD extends TransactionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A>> = {
+export type DatabaseSchema<CS extends ComponentSchemas, RS extends ResourceSchemas, A extends ArchetypeComponents<StringKeyof<CS>>, TD extends ActionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A>> = {
     readonly components: CS;
     readonly resources: RS;
     readonly archetypes: A;
     readonly transactions: TD;
 };
-export type DatabaseFromSchema<T> = T extends DatabaseSchema<infer CS, infer RS, infer A, infer TD> ? Database<FromSchemas<CS>, FromSchemas<RS>, A, ToTransactionFunctions<TD>> : never;
+export type DatabaseFromSchema<T> = T extends DatabaseSchema<infer CS, infer RS, infer A, infer TD> ? Database<FromSchemas<CS>, FromSchemas<RS>, A, ToActionFunctions<TD>> : never;

package/dist/ecs/database/database.d.ts

@@ -5,7 +5,7 @@ import { Entity } from "../entity.js";
 import { EntityReadValues } from "../store/core/index.js";
 import { Observe } from "../../observe/index.js";
 import { TransactionResult } from "./transactional-store/index.js";
-import { StringKeyof } from "../../types/types.js";
+import { IntersectTuple, NoInfer, StringKeyof } from "../../types/types.js";
 import { Components } from "../store/components.js";
 import { ArchetypeComponents } from "../store/archetype-components.js";
 import { RequiredComponents } from "../required-components.js";
@@ -13,22 +13,24 @@ import { EntitySelectOptions } from "../store/entity-select-options.js";
 import { Service } from "../../service/service.js";
 import { OptionalComponents } from "../optional-components.js";
 import { createDatabase } from "./public/create-database.js";
-export type TransactionDeclaration<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 TransactionDeclarations<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>> = {
-    readonly [K: string]: TransactionDeclaration<C, R, A>;
-};
-/**
- * Converts from TransactionDeclarations to TransactionFunctions by removing the initial store argument.
- */
-export type ToTransactionFunctions<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 TransactionFunctions = {
-    readonly [K: string]: (args?: any) => void | Entity;
-};
-export interface Database<C extends Components = never, R extends ResourceComponents = never, A extends ArchetypeComponents<StringKeyof<C & OptionalComponents>> = never, T extends TransactionFunctions = never> extends ReadonlyStore<C, R, A>, Service {
-    readonly transactions: T & Service;
+import { ResourceSchemas } from "../resource-schemas.js";
+import { ComponentSchemas } from "../component-schemas.js";
+import { FromSchemas } from "../../schema/index.js";
+import type { ActionDeclarations, ActionFunctions, ToActionFunctions } from "../store/action-functions.js";
+import { createPlugin } from "./create-plugin.js";
+type SystemFunction = () => void | Promise<void>;
+export interface Database<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C & OptionalComponents>>, F extends ActionFunctions, S extends string = never> extends ReadonlyStore<C, R, A>, Service {
+    readonly transactions: F & Service;
+    /**
+     * Provides direct mutable access to the underlying store.
+     */
+    readonly store: Store<C, R, A> & {
+        /**
+         * Provides fast access to the action functions without a transaction wrapper.
+         * This means any calls to them will NOT be observable or undoable.
+         */
+        readonly actions: F;
+    };
     readonly observe: {
         readonly components: {
             readonly [K in StringKeyof<C>]: Observe<void>;
@@ -44,10 +46,46 @@ export interface Database<C extends Components = never, R extends ResourceCompon
         archetype(id: ArchetypeId): Observe<void>;
         select<Include extends StringKeyof<C>, T extends Include>(include: readonly Include[] | ReadonlySet<string>, options?: EntitySelectOptions<C, Pick<C & RequiredComponents, T>>): Observe<readonly Entity[]>;
     };
+    readonly system: {
+        readonly functions: {
+            readonly [K in S]: SystemFunction;
+        };
+        readonly order: S[][];
+    };
     toData(): unknown;
     fromData(data: unknown): void;
-    extend<S extends Store.Schema<any, any, any>>(schema: S): Database<C & (S extends Store.Schema<infer XC, infer XR, infer XA> ? XC : never), R & (S extends Store.Schema<infer XC, infer XR, infer XA> ? XR : never), A & (S extends Store.Schema<infer XC, infer XR, infer XA> ? XA : never), T>;
+    extend<P extends Database.Plugin<any, any, any, any, any>>(plugin: P): Database<C & (P extends Database.Plugin<infer XC, any, any, any, any> ? FromSchemas<XC> : never), R & (P extends Database.Plugin<any, infer XR, any, any, any> ? FromSchemas<XR> : never), A & (P extends Database.Plugin<any, any, infer XA, any, any> ? XA : never), F & (P extends Database.Plugin<any, any, any, infer XTD, any> ? ToActionFunctions<XTD> : never), S | (P extends Database.Plugin<any, any, any, any, infer XS> ? XS : never)>;
 }
 export declare namespace Database {
     const create: typeof createDatabase;
+    type Plugin<CS extends ComponentSchemas = any, RS extends ResourceSchemas = any, A extends ArchetypeComponents<StringKeyof<CS & OptionalComponents>> = any, TD extends ActionDeclarations<FromSchemas<CS>, FromSchemas<RS>, any> = any, S extends string = any> = {
+        readonly components?: CS;
+        readonly resources?: RS;
+        readonly archetypes?: A;
+        readonly transactions?: TD;
+        readonly systems?: {
+            readonly [K in S]: {
+                readonly create: (db: Database<FromSchemas<CS>, FromSchemas<RS>, A, ToActionFunctions<TD>, S>) => SystemFunction;
+                readonly schedule?: {
+                    readonly before?: readonly NoInfer<Exclude<S, K>>[];
+                    readonly after?: readonly NoInfer<Exclude<S, K>>[];
+                };
+            };
+        };
+    };
+    namespace Plugin {
+        type Intersect<T extends readonly Plugin<any, any, any, any, any>[]> = Required<Database.Plugin<{} & IntersectTuple<{
+            [K in keyof T]: T[K] extends Plugin<infer C, any, any, any, any> ? (C extends undefined ? {} : C) : never;
+        }>, {} & IntersectTuple<{
+            [K in keyof T]: T[K] extends Plugin<any, infer R, any, any, any> ? (R extends undefined ? {} : R) : never;
+        }>, {} & IntersectTuple<{
+            [K in keyof T]: T[K] extends Plugin<any, any, infer A, any, any> ? (A extends undefined ? {} : A) : never;
+        }>, {} & IntersectTuple<{
+            [K in keyof T]: T[K] extends Plugin<any, any, any, infer TD, any> ? (TD extends undefined ? Record<never, never> : TD) : never;
+        }>, Extract<{
+            [K in keyof T]: T[K] extends Plugin<any, any, any, any, infer S> ? S : never;
+        }[number], string>>>;
+        const create: typeof createPlugin;
+    }
 }
+export {};

package/dist/ecs/database/database.js

@@ -1,6 +1,48 @@
+/*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 { createDatabase } from "./public/create-database.js";
+import { createPlugin } from "./create-plugin.js";
 export var Database;
 (function (Database) {
     Database.create = createDatabase;
+    let Plugin;
+    (function (Plugin) {
+        Plugin.create = createPlugin;
+    })(Plugin = Database.Plugin || (Database.Plugin = {}));
 })(Database || (Database = {}));
+// Test type inference with new overload pattern
+const testBasePlugin = Database.Plugin.create({
+    components: {
+        position: { type: "number" },
+        health: { type: "number" }
+    }
+});
+const testExtendedPlugin = Database.Plugin.create({
+    components: {
+        velocity: { type: "number" }
+    },
+    archetypes: {
+        DynamicEntity: ["position", "velocity"],
+        LivingEntity: ["position", "health"]
+    }
+}, [testBasePlugin]);
 //# sourceMappingURL=database.js.map

package/dist/ecs/database/database.js.map

@@ -1 +1 @@
-{"version":3,"file":"database.js","sourceRoot":"","sources":["../../../src/ecs/database/database.ts"],"names":[],"mappings":"AAmCA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAgE7D,MAAM,KAAW,QAAQ,CAExB;AAFD,WAAiB,QAAQ;IACV,eAAM,GAAG,cAAc,CAAC;AACvC,CAAC,EAFgB,QAAQ,KAAR,QAAQ,QAExB"}
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../../src/ecs/database/database.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAgBX,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAW7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAoDlD,MAAM,KAAW,QAAQ,CAqCxB;AArCD,WAAiB,QAAQ;IACV,eAAM,GAAG,cAAc,CAAC;IAsBrC,IAAiB,MAAM,CAYtB;IAZD,WAAiB,MAAM;QAWR,aAAM,GAAG,YAAY,CAAC;IACrC,CAAC,EAZgB,MAAM,GAAN,eAAM,KAAN,eAAM,QAYtB;AAEH,CAAC,EArCgB,QAAQ,KAAR,QAAQ,QAqCxB;AA8CD,gDAAgD;AAChD,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5C,UAAU,EAAE;QACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC3B;CACF,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAC/C;IACE,UAAU,EAAE;QACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC7B;IACD,UAAU,EAAE;QACV,aAAa,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;QACvC,YAAY,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;KACrC;CACF,EACD,CAAC,cAAc,CAAC,CACjB,CAAC"}

package/dist/ecs/database/database.test.d.ts

@@ -0,0 +1 @@
+export {};