@adobe/data 0.2.1 → 0.2.2

package/dist/ecs/action-ecs/action-ecs.test.js

@@ -0,0 +1,362 @@
+/*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, expect, test } from "vitest";
+import { createActionECS } from "./action-ecs.js";
+import { Float32Schema, Tuple } from "../../core/schema/schemas.js";
+const user = "test";
+const createECSWithMassAndSize = () => {
+    return createActionECS({ user })
+        .withComponents({
+        mass: { type: "number", minimum: 0 },
+        size: { enum: ["small", "medium", "large"] },
+        checkCreatedTime: { type: "integer" },
+        checkCreatedBy: { type: "string" },
+    })
+        .withArchetypes({
+        physical: ["id", "mass", "size"],
+        sized: ["id", "size"],
+        check: ["id", "checkCreatedTime", "checkCreatedBy"],
+    })
+        .withResources({
+        gravity: 9.8,
+    })
+        .withActions({
+        createPhysical(t, mass, size) {
+            t.createEntity(t.ecs.archetypes.physical, { mass, size });
+        },
+        deletePhysical(t, entity) {
+            t.deleteEntity(entity);
+        },
+        setMass(t, entity, mass) {
+            t.setComponentValue(entity, "mass", mass);
+        },
+        setSize(t, entity, size) {
+            t.setComponentValue(entity, "size", size);
+        },
+        setGravity(t, gravity) {
+            t.resources.gravity = gravity;
+        },
+    })
+        .withActions({
+        //  higher order actions based on the previous actions
+        setMassAndSize(t, entity, mass, size) {
+            this.setMass(t, entity, mass);
+            this.setSize(t, entity, size);
+        },
+        checkTransactionOptions(t) {
+            t.createEntity(t.ecs.archetypes.check, {
+                checkCreatedTime: t.options.createdTime,
+                checkCreatedBy: t.options.createdBy,
+            });
+        }
+    });
+};
+let FIRST_ENTITY;
+{
+    const ecs = createECSWithMassAndSize();
+    ecs.actions.createPhysical(1, "small");
+    FIRST_ENTITY = ecs.selectEntities(ecs.archetypes.physical)[0];
+}
+describe("ActionECS", () => {
+    test("can call an action to create an entity", () => {
+        const ecs = createECSWithMassAndSize();
+        ecs.actions.createPhysical(1, "small");
+        expect(ecs.selectEntityValues(ecs.archetypes.physical)).toEqual([
+            { id: FIRST_ENTITY, mass: 1, size: "small" },
+        ]);
+    });
+    test("calling an action includes createdTime and createdBy on options", () => {
+        const ecs = createECSWithMassAndSize();
+        ecs.actions.checkTransactionOptions();
+        const check = ecs.selectEntityValues(ecs.archetypes.check)[0];
+        expect(check).toEqual({
+            id: FIRST_ENTITY,
+            checkCreatedTime: expect.any(Number),
+            checkCreatedBy: user,
+        });
+    });
+    test("calling an apply action includes createdTime and createdBy on options", () => {
+        const ecs = createECSWithMassAndSize();
+        //  now we check that the time is exactly what we expect
+        const time = Date.now();
+        ecs.apply({ type: "commit", createdTime: time, createdBy: user, name: "checkTransactionOptions", args: [] });
+        const check = ecs.selectEntityValues(ecs.archetypes.check)[0];
+        expect(check).toEqual({
+            id: FIRST_ENTITY,
+            checkCreatedTime: time,
+            checkCreatedBy: user,
+        });
+    });
+    test("can call an action twice to create two entities", () => {
+        const ecs = createECSWithMassAndSize();
+        ecs.actions.createPhysical(1, "small");
+        ecs.actions.createPhysical(5, "large");
+        expect(ecs.selectEntityValues(ecs.archetypes.physical)).toEqual([
+            { id: FIRST_ENTITY, mass: 1, size: "small" },
+            { id: FIRST_ENTITY + 1, mass: 5, size: "large" },
+        ]);
+    });
+    test("can use higher order actions", () => {
+        const ecs = createECSWithMassAndSize();
+        ecs.actions.createPhysical(1, "small");
+        ecs.actions.setMassAndSize(FIRST_ENTITY, 10, "medium");
+        expect(ecs.selectEntityValues(ecs.archetypes.physical)).toEqual([
+            { id: FIRST_ENTITY, mass: 10, size: "medium" },
+        ]);
+    });
+    test("can call sequential actions and commit", () => {
+        const ecs = createECSWithMassAndSize();
+        ecs.actionSequences.setGravity(10).update(11).update(12).commit();
+        expect(ecs.resources.gravity).toBe(12);
+    });
+    test("can call sequential actions and cancel", () => {
+        const ecs = createECSWithMassAndSize();
+        ecs.actionSequences.setGravity(10).update(11).update(12).cancel();
+        expect(ecs.resources.gravity).toBe(9.8);
+    });
+    test("can execute sequential actions and commit", async () => {
+        const ecs = createECSWithMassAndSize();
+        expect(ecs.getTransientActionCount()).toBe(0);
+        await ecs.actions.setGravity(async function* () {
+            expect(ecs.getTransientActionCount()).toBe(0);
+            yield [10];
+            expect(ecs.resources.gravity).toBe(10); // in flight
+            expect(ecs.getTransientActionCount()).toBe(1);
+            yield [11];
+            expect(ecs.resources.gravity).toBe(11); // in flight
+            expect(ecs.getTransientActionCount()).toBe(1);
+            yield [12];
+            expect(ecs.resources.gravity).toBe(12); // in flight
+            expect(ecs.getTransientActionCount()).toBe(1);
+        });
+        expect(ecs.getTransientActionCount()).toBe(0);
+        expect(ecs.resources.gravity).toBe(12);
+    });
+    test("can execute sequential actions and throw an error which cancels", async () => {
+        const ecs = createECSWithMassAndSize();
+        let cleanup = false;
+        try {
+            await ecs.actions.setGravity(async function* () {
+                try {
+                    yield [10];
+                    yield [11];
+                    yield [12];
+                    throw new Error("test");
+                }
+                finally {
+                    cleanup = true;
+                }
+            });
+        }
+        catch (error) {
+            expect(cleanup).toBe(true);
+            expect(error).toBeInstanceOf(Error);
+            expect(error.message).toBe("test");
+        }
+        expect(ecs.resources.gravity).toBe(9.8);
+    });
+    test("can execute promise action and commit", async () => {
+        const ecs = createECSWithMassAndSize();
+        await ecs.actions.setGravity(async () => {
+            return [10];
+        });
+        expect(ecs.resources.gravity).toBe(10);
+    });
+    test("can use apply directly", () => {
+        const ecs = createECSWithMassAndSize();
+        const time = Date.now();
+        ecs.apply({
+            type: "commit",
+            createdTime: time,
+            createdBy: user,
+            name: "createPhysical",
+            args: [1, "small"],
+        });
+        expect(ecs.selectEntityValues(ecs.archetypes.physical)).toEqual([
+            { id: FIRST_ENTITY, mass: 1, size: "small" },
+        ]);
+    });
+    test("can resolve out of order apply calls", () => {
+        const ecs = createECSWithMassAndSize();
+        const time = Date.now();
+        //  this later one is applied first
+        ecs.apply({
+            type: "commit",
+            createdTime: time + 1,
+            createdBy: user,
+            name: "createPhysical",
+            args: [5, "large"],
+        });
+        //  this earlier one is applied second
+        ecs.apply({
+            type: "commit",
+            createdTime: time,
+            createdBy: user,
+            name: "createPhysical",
+            args: [1, "small"],
+        });
+        //  the entities are sorted and reapplied by updatedTime
+        expect(ecs.selectEntityValues(ecs.archetypes.physical)).toEqual([
+            { id: FIRST_ENTITY, mass: 1, size: "small" },
+            { id: FIRST_ENTITY + 1, mass: 5, size: "large" },
+        ]);
+    });
+    test("with subsequent updates, created order is still retained", () => {
+        //  we *could* change order later to use an updatedTime for final ordering
+        //  but would still have to roll back apply calls based on last ordering
+        const ecs = createECSWithMassAndSize();
+        const time = Date.now();
+        ecs.apply({
+            type: "transient",
+            createdTime: time,
+            createdBy: user,
+            name: "createPhysical",
+            args: [1, "small"],
+        });
+        ecs.apply({
+            type: "commit",
+            createdTime: time + 1,
+            createdBy: user,
+            name: "createPhysical",
+            args: [2, "medium"],
+        });
+        ecs.apply({
+            type: "transient",
+            createdTime: time,
+            createdBy: user,
+            name: "createPhysical",
+            args: [5, "large"],
+        });
+        ecs.apply({
+            type: "transient",
+            createdTime: time,
+            createdBy: user,
+            name: "createPhysical",
+            args: [10, "large"],
+        });
+        expect(ecs.selectEntityValues(ecs.archetypes.physical)).toEqual([
+            { id: FIRST_ENTITY, mass: 10, size: "large" },
+            { id: FIRST_ENTITY + 1, mass: 2, size: "medium" },
+        ]);
+    });
+    test("can observe actions", () => {
+        const ecs = createECSWithMassAndSize();
+        const actions = [];
+        ecs.observe.actions((action) => actions.push(action));
+        ecs.actions.createPhysical(1, "small");
+        ecs.actions.createPhysical(5, "large");
+        expect(actions).toEqual([
+            {
+                type: "commit",
+                createdTime: expect.any(Number),
+                createdBy: user,
+                name: "createPhysical",
+                args: [1, "small"],
+            },
+            {
+                type: "commit",
+                createdTime: expect.any(Number),
+                createdBy: user,
+                name: "createPhysical",
+                args: [5, "large"],
+            },
+        ]);
+    });
+});
+// sample ECS creation
+const Vector3Schema = Tuple(Float32Schema, 3);
+const Vector4Schema = Tuple(Float32Schema, 4);
+//  create an action ecs
+const ecs = createActionECS()
+    //  define components with schemas
+    .withComponents({
+    position: Vector3Schema,
+    velocity: Vector3Schema,
+    color: Vector4Schema,
+    size: { type: "number" },
+    health: { type: "number" },
+    player: { const: true },
+})
+    //  define archetypes with component names
+    .withArchetypes({
+    particle: ["position", "velocity", "color", "size"],
+    player: ["position", "health", "player"],
+})
+    //  define resources with initial values
+    .withResources({
+    gravity: 9.8,
+})
+    //  define actions with transactional functions
+    .withActions({
+    createParticle(t, props) {
+        t.createEntity(t.ecs.archetypes.particle, props);
+    },
+    deleteParticle(t, entity) {
+        t.deleteEntity(entity);
+    },
+    createPlayer(t, position) {
+        t.createEntity(t.ecs.archetypes.player, { position, health: 100, player: true });
+    },
+    movePlayer(t, entity, position) {
+        t.setComponentValue(entity, "position", position);
+    },
+    setGravity(t, gravity) {
+        t.resources.gravity = gravity;
+    },
+});
+//  call some actions to modify the ECS
+ecs.actions.createParticle({ position: [0, 0, 0], velocity: [0, 0, 0], color: [1, 0, 0, 0], size: 1 });
+ecs.actions.createParticle({ position: [1, 1, 1], velocity: [1, 1, 1], color: [1, 1, 1, 1], size: 2 });
+ecs.actions.createPlayer([10, 20, 0]);
+//  read out the player entity
+const playerEntity = ecs.selectEntities(ecs.archetypes.player)[0];
+ecs.actions.movePlayer(playerEntity, [10, 20, 0]);
+//  read some values from the ECS
+const particles = ecs.selectEntities(ecs.archetypes.particle);
+//  observe changes to the ECS
+ecs.observe.archetypeEntities(ecs.archetypes.player)((playerEntities) => {
+    for (const playerEntity of playerEntities) {
+        const player = ecs.getEntityValues(playerEntity);
+        // console.log("Player entity changed", player);
+    }
+});
+{
+    //  some type checks.
+    const ecs = createActionECS()
+        .withComponents({
+        position: { type: "string" },
+    })
+        .withComponents({
+        size: { type: "number" },
+    })
+        .withResources({
+        gravity: 9.8,
+    })
+        .withResources({
+        time: 0,
+    })
+        .withArchetypes({
+        position_size: ["id", "position", "size"],
+        position: ["id", "position"],
+    });
+}
+//# sourceMappingURL=action-ecs.test.js.map

package/dist/ecs/action-ecs/action-ecs.test.js.map

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

package/dist/ecs/action-ecs/action-types.d.ts

@@ -0,0 +1,106 @@
+import { FromSchema, Schema } from "../../core/index.js";
+import { Observe } from "../../observe/types.js";
+import { Expand, Simplify } from "../../types/types.js";
+import { Archetype, ECSArchetypes, ECSComponents, ECSResources } from "../ecs/ecs-types.js";
+import { Entity } from "../index.js";
+import { Transaction, TransactionECS, TransactionObservables } from "../transaction-ecs/transaction-types.js";
+export type ECSActionFunctions = Record<string, ActionFunction>;
+export type AsyncArgsProvider<T> = () => Promise<T> | AsyncGenerator<T>;
+/**
+ * Represents an ECS with actions that can be applied to it.
+ * Actions are functions that can be applied to the ECS to change its state.
+ * They are defined in advance using the withActions method.
+ * These actions are implemented using transactions which are applied to the
+ * underlying TransactionECS.
+ */
+export interface ActionECS<C extends ECSComponents = ECSComponents, //  name => Component Value Type
+A extends ECSArchetypes = {}, //  name => Entity Values Type
+R extends ECSResources = {}, //  name => Resource Value Type
+F extends ECSActionFunctions = {}> extends Omit<TransactionECS<C, A, R>, "createTransaction" | "withComponents" | "withArchetypes" | "withResources"> {
+    apply(action: Action<F>): void;
+    readonly actions: {
+        [K in keyof F]: ToActionFunction<F[K]>;
+    };
+    readonly actionSequences: {
+        [K in keyof F]: (...args: Parameters<ToActionFunction<F[K]>>) => ActionSequence<Parameters<ToActionFunction<F[K]>>>;
+    };
+    withComponents<S extends {
+        [K: string]: Schema;
+    }, T = {
+        -readonly [K in keyof S]: FromSchema<S[K]>;
+    }>(components: S): ActionECS<Simplify<C & T>, A, R, F>;
+    withArchetypes<S extends {
+        [K: string]: ReadonlyArray<keyof C>;
+    }>(archetypes: S): ActionECS<C, Simplify<A & {
+        -readonly [AN in keyof S]: Archetype<Expand<{
+            id: Entity;
+        } & {
+            [PN in S[AN][number]]: C[PN];
+        }>>;
+    }>, R, F>;
+    withResources<S extends {
+        [K: string]: unknown;
+    }>(resources: S): ActionECS<C, A, Simplify<R & S>, F>;
+    withActions<S extends {
+        [K: string]: TransactionFunction<C, A, R, F>;
+    }>(transactionFunctions: S): ActionECS<C, A, R, Simplify<F & S>>;
+    observe: ActionECSObservables<C, A, R, F>;
+    /**
+     * The number of transient actions that are currently in progress.
+     * This is used for debugging.
+     */
+    getTransientActionCount: () => number;
+}
+export type ActionECSObservables<C extends ECSComponents = ECSComponents, //  name => Component Value Type
+A extends ECSArchetypes = ECSArchetypes, //  name => Entity Values Type
+R extends ECSResources = ECSResources, //  name => Resource Value Type
+F extends ECSActionFunctions = ECSActionFunctions> = TransactionObservables<C, A, R> & {
+    actions: Observe<Action<F>>;
+};
+/**
+ * Represents an action which can be applied to an ActionECS.
+ */
+export type Action<F extends ECSActionFunctions = any> = {
+    type: "transient" | "commit" | "cancel";
+    /**
+     * The unique time in UTC milliseconds when the action was created.
+     */
+    createdTime: number;
+    /**
+     * The unique identifier for the user creating the action.
+     */
+    createdBy: string;
+    /**
+     * The name of the action.
+     */
+    name: keyof F;
+    /**
+     * The semantic arguments for the action.
+     */
+    args: Parameters<ToActionFunction<F[keyof F]>>;
+};
+/**
+ * Gets the action type for the given ECS.
+ */
+export type ActionFor<ECS extends ActionECS<any, any, any, any>> = ECS extends ActionECS<infer C, infer A, infer R, infer F> ? Action<F> : never;
+/**
+ * Compares two actions to determine their correct application order.
+ * Transient actions are always applied after non-transient actions.
+ * Actions are then sorted by time ascending.
+ * Actions are then sorted by user ascending.
+ * @returns 0 if the actions are equal, -1 if a should be applied before b, 1 if b should be applied before a.
+ */
+export declare function compareActionOrder(a: Action, b: Action): number;
+export declare function isSameAction(a: Action, b: Action): boolean;
+export type TransactionFunction<C extends ECSComponents = any, //  name => Component Value Type
+A extends ECSArchetypes = any, //  name => Entity Values Type
+R extends ECSResources = any, //  name => Resource Value Type
+F extends ECSActionFunctions = any> = (this: F, t: Transaction<C, A, R>, ...args: any[]) => void;
+export type ToActionFunction<F> = F extends (t: Transaction<any, any, any>, ...args: infer Args) => void ? ActionFunction<(Args | [AsyncArgsProvider<Args>])> : never;
+type ActionFunction<Args extends any[] = any[]> = (...args: Args) => void;
+export type ActionSequence<Args extends any[] = any[]> = {
+    update: (...args: Args) => ActionSequence<Args>;
+    commit: () => void;
+    cancel: () => void;
+};
+export {};

package/dist/ecs/action-ecs/action-types.js

@@ -0,0 +1,19 @@
+/**
+ * Compares two actions to determine their correct application order.
+ * Transient actions are always applied after non-transient actions.
+ * Actions are then sorted by time ascending.
+ * Actions are then sorted by user ascending.
+ * @returns 0 if the actions are equal, -1 if a should be applied before b, 1 if b should be applied before a.
+ */
+export function compareActionOrder(a, b) {
+    if (a.createdTime !== b.createdTime) {
+        return a.createdTime - b.createdTime;
+    }
+    return a.createdBy.localeCompare(b.createdBy, undefined, {
+        sensitivity: "variant",
+    });
+}
+export function isSameAction(a, b) {
+    return a.createdTime === b.createdTime && a.createdBy === b.createdBy;
+}
+//# sourceMappingURL=action-types.js.map

package/dist/ecs/action-ecs/action-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-types.js","sourceRoot":"","sources":["../../../src/ecs/action-ecs/action-types.ts"],"names":[],"mappings":"AAwIA;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,CAAS,EAAE,CAAS;IACrD,IAAI,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QACpC,OAAO,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE;QACvD,WAAW,EAAE,SAAS;KACvB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAS,EAAE,CAAS;IAC/C,OAAO,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,CAAC;AACxE,CAAC"}

package/dist/ecs/action-ecs/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./action-ecs.js";
+export { type ActionECS, type Action, type ActionSequence, type ActionFor, } from "./action-types.js";

package/dist/ecs/action-ecs/index.js

@@ -0,0 +1,23 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+export * from "./action-ecs.js";
+//# sourceMappingURL=index.js.map

package/dist/ecs/action-ecs/index.js.map

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

package/dist/ecs/archetype/archetype.d.ts

@@ -0,0 +1,15 @@
+import { CoreComponents } from "../core-components.js";
+import { Entity } from "../entity.js";
+import { Table, ReadonlyTable } from "../../table/index.js";
+export type EntityInsertValues<C> = Omit<C, "id">;
+export type ArchetypeId = number;
+interface BaseArchetype<C> {
+    readonly id: ArchetypeId;
+    readonly components: ReadonlySet<string>;
+}
+export interface ReadonlyArchetype<C extends CoreComponents> extends BaseArchetype<C>, ReadonlyTable<C> {
+}
+export interface Archetype<C extends CoreComponents = CoreComponents> extends BaseArchetype<C>, Table<C> {
+    insert: (rowData: EntityInsertValues<C>) => Entity;
+}
+export {};

package/dist/ecs/archetype/archetype.js

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

package/dist/ecs/archetype/archetype.js.map

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

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

@@ -0,0 +1,8 @@
+import { FromSchema } from "../../schema/schema.js";
+import { Archetype } from "./archetype.js";
+import { CoreComponents } from "../core-components.js";
+import { EntityLocationTable } from "../entity-location-table/entity-location-table.js";
+import { EntitySchema } from "../entity.js";
+export declare const createArchetype: <C extends {
+    id: typeof EntitySchema;
+}>(components: C, id: number, entityLocationTable: EntityLocationTable) => Archetype<CoreComponents & { [K in keyof C]: FromSchema<C[K]>; }>;

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

@@ -0,0 +1,21 @@
+import * as TABLE from "../../table/index.js";
+export const createArchetype = (components, id, entityLocationTable) => {
+    const table = TABLE.createTable(components);
+    const createEntity = (rowData) => {
+        // add the row (excluding entity id)
+        const row = TABLE.addRow(archetype, rowData);
+        // create the entity lookup record
+        const entity = entityLocationTable.create({ archetype: archetype.id, row });
+        // set the entity id for the row (since it wasn't present in the row data)
+        archetype.columns.id.set(row, entity);
+        return entity;
+    };
+    const archetype = {
+        id,
+        ...table,
+        components: new Set(Object.keys(components)),
+        insert: createEntity,
+    };
+    return archetype;
+};
+//# sourceMappingURL=create-archetype.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-archetype.js","sourceRoot":"","sources":["../../../src/ecs/archetype/create-archetype.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,KAAK,MAAM,sBAAsB,CAAC;AAM9C,MAAM,CAAC,MAAM,eAAe,GAAG,CAC3B,UAAa,EACb,EAAU,EACV,mBAAwC,EACwB,EAAE;IAClE,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,CAAC,OAAyD,EAAU,EAAE;QACvF,oCAAoC;QACpC,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,SAAgB,EAAE,OAAO,CAAC,CAAC;QACpD,kCAAkC;QAClC,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5E,0EAA0E;QAC1E,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,MAAa,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC;IAClB,CAAC,CAAA;IAED,MAAM,SAAS,GAAG;QACd,EAAE;QACF,GAAG,KAAK;QACR,UAAU,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAyB,CAAC;QACpE,MAAM,EAAE,YAAY;KACgH,CAAC;IACzI,OAAO,SAAS,CAAC;AACrB,CAAC,CAAA"}

package/dist/ecs/archetype/create-archetype.test.d.ts

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