@adobe/data 0.6.2 → 0.7.0

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

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

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

@@ -0,0 +1,8 @@
+import { StringKeyof } from "../../../types/types.js";
+import { TransactionDeclarations } from "../database.js";
+import { ResourceComponents } from "../../store/resource-components.js";
+import { Store } from "../../store/index.js";
+import { Components } from "../../store/components.js";
+import { ArchetypeComponents } from "../../store/archetype-components.js";
+import { ReconcilingDatabase } from "./reconciling-database.js";
+export declare function createReconcilingDatabase<const C extends Components, const R extends ResourceComponents, const A extends ArchetypeComponents<StringKeyof<C>>, const TD extends TransactionDeclarations<C, R, A>>(store: Store<C, R, A>, transactionDeclarations: TD): ReconcilingDatabase<C, R, A, TD>;

package/dist/ecs/database/reconciling/create-reconciling-database.js

@@ -0,0 +1,146 @@
+/*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 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 { applyOperations } from "../transactional-store/apply-operations.js";
+import { ReconcilingEntryOps, serializeReconcilingEntry, deserializeReconcilingEntry, } from "./reconciling-entry.js";
+import { createObservedDatabase } from "../observed/create-observed-database.js";
+export function createReconcilingDatabase(store, transactionDeclarations) {
+    const observedDatabase = createObservedDatabase(store);
+    const { execute, observe, resources, toData: observedToData, fromData: observedFromData, ...storeMethods } = observedDatabase;
+    const reconcilingEntries = [];
+    const rollbackRange = (startIndex) => {
+        for (let i = reconcilingEntries.length - 1; i >= startIndex; i--) {
+            const entry = reconcilingEntries[i];
+            if (entry.result) {
+                execute(t => applyOperations(t, entry.result.undo), { transient: true });
+                entry.result = undefined;
+            }
+        }
+    };
+    const replayRange = (startIndex) => {
+        let lastResult;
+        for (let i = startIndex; i < reconcilingEntries.length; i++) {
+            const entry = reconcilingEntries[i];
+            const result = execute(t => entry.transaction(t, entry.args), { transient: ReconcilingEntryOps.isTransient(entry) });
+            entry.result = result;
+            lastResult = result;
+        }
+        return lastResult;
+    };
+    const applyEnvelope = (envelope) => {
+        const transaction = transactionDeclarations[envelope.name];
+        if (!transaction) {
+            throw new Error(`Unknown transaction: ${envelope.name}`);
+        }
+        const isCancellation = envelope.time === 0;
+        let startIndex = reconcilingEntries.length;
+        const existingIndex = reconcilingEntries.findIndex(entry => entry.id === envelope.id);
+        if (existingIndex >= 0) {
+            startIndex = existingIndex;
+            const existingEntry = reconcilingEntries[existingIndex];
+            if (existingEntry.result) {
+                execute(t => applyOperations(t, existingEntry.result.undo), { transient: true });
+                existingEntry.result = undefined;
+            }
+            reconcilingEntries.splice(existingIndex, 1);
+        }
+        if (isCancellation) {
+            if (startIndex < reconcilingEntries.length) {
+                rollbackRange(startIndex);
+                replayRange(startIndex);
+            }
+            return undefined;
+        }
+        const entry = {
+            id: envelope.id,
+            name: envelope.name,
+            transaction: transaction,
+            args: envelope.args,
+            time: envelope.time,
+            result: undefined,
+        };
+        const insertIndex = ReconcilingEntryOps.findInsertIndex(reconcilingEntries, entry);
+        reconcilingEntries.splice(insertIndex, 0, entry);
+        const rebuildIndex = Math.min(startIndex, insertIndex);
+        rollbackRange(rebuildIndex);
+        replayRange(rebuildIndex);
+        const insertedEntry = reconcilingEntries.find(e => e.id === envelope.id);
+        const latestResult = insertedEntry?.result;
+        return latestResult;
+    };
+    const removeEntryAtIndex = (index, { rollback }) => {
+        if (index < 0 || index >= reconcilingEntries.length) {
+            return;
+        }
+        if (rollback) {
+            rollbackRange(index);
+        }
+        reconcilingEntries.splice(index, 1);
+        if (rollback) {
+            replayRange(index);
+        }
+    };
+    const cancelEntry = (id) => {
+        const index = reconcilingEntries.findIndex(entry => entry.id === id);
+        if (index === -1) {
+            return;
+        }
+        removeEntryAtIndex(index, { rollback: true });
+    };
+    const serializeReconcilingEntries = () => reconcilingEntries
+        .filter(entry => ReconcilingEntryOps.isTransient(entry))
+        .map(entry => serializeReconcilingEntry(entry));
+    const reconcilingDatabase = {
+        ...storeMethods,
+        resources,
+        execute,
+        observe,
+        toData: () => ({
+            store: observedToData(),
+            appliedEntries: serializeReconcilingEntries(),
+        }),
+        fromData: (data) => {
+            let storeData = data;
+            let serializedEntries;
+            if (typeof data === "object" && data !== null && "store" in data) {
+                const payload = data;
+                storeData = payload.store;
+                serializedEntries = Array.isArray(payload.appliedEntries) ? payload.appliedEntries : undefined;
+            }
+            observedFromData(storeData);
+            reconcilingEntries.length = 0;
+            if (serializedEntries) {
+                for (const serializedEntry of serializedEntries) {
+                    const transaction = transactionDeclarations[serializedEntry.name];
+                    if (!transaction) {
+                        continue;
+                    }
+                    const entry = deserializeReconcilingEntry(serializedEntry, transaction);
+                    reconcilingEntries.push(entry);
+                }
+                reconcilingEntries.sort(ReconcilingEntryOps.compare);
+            }
+        },
+        apply: applyEnvelope,
+        cancel: cancelEntry,
+    };
+    return reconcilingDatabase;
+}
+//# sourceMappingURL=create-reconciling-database.js.map

package/dist/ecs/database/reconciling/create-reconciling-database.js.map

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

package/dist/ecs/database/reconciling/create-reconciling-database.test.d.ts

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

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

@@ -0,0 +1,94 @@
+import { describe, it, expect } from "vitest";
+import { createReconcilingDatabase } from "./create-reconciling-database.js";
+import { createStore } from "../../store/create-store.js";
+const createTestReconcilingDatabase = () => {
+    const store = createStore({
+        position: {
+            type: "object",
+            properties: {
+                x: { type: "number" },
+                y: { type: "number" },
+                z: { type: "number" },
+            },
+            required: ["x", "y", "z"],
+            additionalProperties: false,
+        },
+        name: { type: "string" },
+    }, {}, {
+        PositionNameEntity: ["position", "name"],
+    });
+    const transactions = {
+        createPositionNameEntity(t, args) {
+            return t.archetypes.PositionNameEntity.insert(args);
+        },
+        updatePositionNameEntity(t, args) {
+            t.update(args.entity, { name: args.name });
+        },
+    };
+    return createReconcilingDatabase(store, transactions);
+};
+const readEntityNames = (reconciling) => reconciling
+    .select(["name"])
+    .map(entity => reconciling.read(entity)?.name)
+    .filter((name) => Boolean(name));
+describe("createReconcilingDatabase", () => {
+    it("replaces a transient entry when the same id yields again", () => {
+        const reconciling = createTestReconcilingDatabase();
+        reconciling.apply({
+            id: 1,
+            name: "createPositionNameEntity",
+            args: { position: { x: 0, y: 0, z: 0 }, name: "First" },
+            time: -1,
+        });
+        reconciling.apply({
+            id: 1,
+            name: "createPositionNameEntity",
+            args: { position: { x: 1, y: 1, z: 1 }, name: "Second" },
+            time: -2,
+        });
+        expect(readEntityNames(reconciling)).toEqual(["Second"]);
+        const serialized = reconciling.toData();
+        expect(serialized.appliedEntries).toHaveLength(1);
+        expect(serialized.appliedEntries?.[0]?.args).toEqual({ position: { x: 1, y: 1, z: 1 }, name: "Second" });
+    });
+    it("removes a transient entry when cancelled after other operations", () => {
+        const reconciling = createTestReconcilingDatabase();
+        reconciling.apply({
+            id: 10,
+            name: "createPositionNameEntity",
+            args: { position: { x: 0, y: 0, z: 0 }, name: "Transient" },
+            time: -1,
+        });
+        reconciling.apply({
+            id: 11,
+            name: "createPositionNameEntity",
+            args: { position: { x: 5, y: 5, z: 5 }, name: "Committed" },
+            time: 2,
+        });
+        const serializedBefore = reconciling.toData();
+        expect(serializedBefore.appliedEntries).toHaveLength(1);
+        reconciling.cancel(10);
+        expect(readEntityNames(reconciling)).toEqual(["Committed"]);
+        const serializedAfter = reconciling.toData();
+        expect(serializedAfter.appliedEntries ?? []).toHaveLength(0);
+    });
+    it("clears transient state after commit confirmation", () => {
+        const reconciling = createTestReconcilingDatabase();
+        reconciling.apply({
+            id: 21,
+            name: "createPositionNameEntity",
+            args: { position: { x: 1, y: 2, z: 3 }, name: "InFlight" },
+            time: -1,
+        });
+        reconciling.apply({
+            id: 21,
+            name: "createPositionNameEntity",
+            args: { position: { x: 4, y: 5, z: 6 }, name: "Final" },
+            time: 5,
+        });
+        expect(readEntityNames(reconciling)).toEqual(["Final"]);
+        const serialized = reconciling.toData();
+        expect(serialized.appliedEntries ?? []).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=create-reconciling-database.test.js.map

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

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

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

@@ -0,0 +1,21 @@
+import { TransactionResult } from "../transactional-store/index.js";
+import { StringKeyof } from "../../../types/types.js";
+import { Components } from "../../store/components.js";
+import { ArchetypeComponents } from "../../store/archetype-components.js";
+import { TransactionDeclarations } from "../database.js";
+import { ResourceComponents } from "../../store/resource-components.js";
+import { ObservedDatabase } from "../observed/observed-database.js";
+export type TransactionEnvelope<Name extends string = string> = {
+    readonly id: number;
+    readonly name: Name;
+    readonly args: unknown;
+    /**
+     * Negative time indicates a transient application, positive time a committed one,
+     * and zero time cancels any existing entry.
+     */
+    readonly time: number;
+};
+export interface ReconcilingDatabase<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>, TD extends TransactionDeclarations<C, R, A>> extends ObservedDatabase<C, R, A> {
+    readonly apply: (envelope: TransactionEnvelope<Extract<keyof TD, string>>) => TransactionResult<C> | undefined;
+    readonly cancel: (id: number) => void;
+}

package/dist/ecs/database/reconciling/reconciling-database.js

@@ -0,0 +1,22 @@
+/*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 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 {};
+//# sourceMappingURL=reconciling-database.js.map

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

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

package/dist/ecs/database/reconciling/reconciling-entry.d.ts

@@ -0,0 +1,30 @@
+import { StringKeyof } from "../../../types/types.js";
+import { Components } from "../../store/components.js";
+import { ResourceComponents } from "../../store/resource-components.js";
+import { ArchetypeComponents } from "../../store/archetype-components.js";
+import { TransactionResult } from "../transactional-store/index.js";
+import { TransactionWriteOperation } from "../transactional-store/transactional-store.js";
+import { Store } from "../../store/index.js";
+import { Entity } from "../../entity.js";
+export type ReconcilingEntry<C extends Components = Components, R extends ResourceComponents = ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>> = ArchetypeComponents<StringKeyof<C>>> = {
+    readonly id: number;
+    readonly name: string;
+    readonly transaction: (store: Store<C, R, A>, args: unknown) => void | Entity;
+    readonly args: unknown;
+    readonly time: number;
+    result?: TransactionResult<C>;
+};
+export declare const ReconcilingEntryOps: {
+    isTransient<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>>(entry: ReconcilingEntry<C, R, A>): boolean;
+    compare<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>>(a: ReconcilingEntry<C, R, A>, b: ReconcilingEntry<C, R, A>): number;
+    findInsertIndex<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>>(entries: ReconcilingEntry<C, R, A>[], entry: ReconcilingEntry<C, R, A>): number;
+};
+export type SerializedReconcilingEntry = {
+    readonly id: number;
+    readonly name: string;
+    readonly args: unknown;
+    readonly time: number;
+    readonly undo?: TransactionWriteOperation<any>[];
+};
+export declare const serializeReconcilingEntry: <C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>>(entry: ReconcilingEntry<C, R, A>) => SerializedReconcilingEntry;
+export declare const deserializeReconcilingEntry: <C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>>(serialized: SerializedReconcilingEntry, transaction: (store: Store<C, R, A>, args: unknown) => void | Entity) => ReconcilingEntry<C, R, A>;

package/dist/ecs/database/reconciling/reconciling-entry.js

@@ -0,0 +1,88 @@
+/*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 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 const ReconcilingEntryOps = {
+    isTransient(entry) {
+        return entry.time < 0;
+    },
+    compare(a, b) {
+        const absDiff = Math.abs(a.time) - Math.abs(b.time);
+        if (absDiff !== 0) {
+            return absDiff;
+        }
+        const idDiff = a.id - b.id;
+        if (idDiff !== 0) {
+            return idDiff;
+        }
+        if (a.name < b.name) {
+            return -1;
+        }
+        if (a.name > b.name) {
+            return 1;
+        }
+        return 0;
+    },
+    findInsertIndex(entries, entry) {
+        let low = 0;
+        let high = entries.length;
+        while (low < high) {
+            const mid = (low + high) >> 1;
+            if (ReconcilingEntryOps.compare(entry, entries[mid]) < 0) {
+                high = mid;
+            }
+            else {
+                low = mid + 1;
+            }
+        }
+        return low;
+    },
+};
+export const serializeReconcilingEntry = (entry) => ({
+    id: entry.id,
+    name: entry.name,
+    args: entry.args,
+    time: entry.time,
+    undo: entry.result?.undo,
+});
+export const deserializeReconcilingEntry = (serialized, transaction) => {
+    const undoOperations = Array.isArray(serialized.undo)
+        ? serialized.undo
+        : undefined;
+    return {
+        id: Number(serialized.id),
+        name: serialized.name,
+        transaction,
+        args: serialized.args,
+        time: serialized.time,
+        result: undoOperations
+            ? {
+                value: undefined,
+                transient: serialized.time < 0,
+                undoable: null,
+                redo: [],
+                undo: undoOperations,
+                changedEntities: new Map(),
+                changedComponents: new Set(),
+                changedArchetypes: new Set(),
+            }
+            : undefined,
+    };
+};
+//# sourceMappingURL=reconciling-entry.js.map

package/dist/ecs/database/reconciling/reconciling-entry.js.map

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

package/dist/ecs/database/transactional-store/entity-id-preservation.test.d.ts

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

package/dist/ecs/database/transactional-store/entity-id-preservation.test.js

@@ -0,0 +1,106 @@
+import { describe, it, expect } from "vitest";
+import { createStore } from "../../store/create-store.js";
+import { createDatabase } from "../create-database.js";
+import { F32Schema } from "../../../schema/f32.js";
+import { createUndoRedoService } from "../../undo-redo-service/create-undo-redo-service.js";
+import { applyOperations } from "./apply-operations.js";
+const positionSchema = {
+    type: "object",
+    properties: {
+        x: F32Schema,
+        y: F32Schema,
+    },
+    required: ["x", "y"],
+    additionalProperties: false,
+};
+describe("entity ID preservation in undo/redo", () => {
+    it("should restore deleted entities with their original entity ID", () => {
+        const store = createStore({ position: positionSchema }, {}, { PositionEntity: ["position"] });
+        const database = createDatabase(store, {
+            createEntity(t, args) {
+                t.undoable = { coalesce: false };
+                return t.archetypes.PositionEntity.insert(args);
+            },
+            deleteEntity(t, args) {
+                t.undoable = { coalesce: false };
+                t.delete(args.entity);
+            },
+            applyOperations(t, operations) {
+                applyOperations(t, operations);
+            }
+        });
+        const undoRedo = createUndoRedoService(database);
+        // Create an entity
+        const entityId = database.transactions.createEntity({ position: { x: 1, y: 2 } });
+        expect(entityId).toBeDefined();
+        // Verify it exists
+        let entity = database.read(entityId);
+        expect(entity).toBeDefined();
+        expect(entity?.position.x).toBe(1);
+        // Delete the entity
+        database.transactions.deleteEntity({ entity: entityId });
+        // Verify it's deleted
+        entity = database.read(entityId);
+        expect(entity).toBeNull();
+        // Undo the delete
+        undoRedo.undo();
+        // Verify it's restored with the SAME entity ID
+        entity = database.read(entityId);
+        expect(entity).toBeDefined();
+        expect(entity?.id).toBe(entityId);
+        expect(entity?.position.x).toBe(1);
+        expect(entity?.position.y).toBe(2);
+    });
+    it("should handle complex undo/redo scenarios with entity ID preservation", () => {
+        const store = createStore({ position: positionSchema }, {}, { PositionEntity: ["position"] });
+        const database = createDatabase(store, {
+            createEntity(t, args) {
+                t.undoable = { coalesce: false };
+                return t.archetypes.PositionEntity.insert(args);
+            },
+            deleteEntity(t, args) {
+                t.undoable = { coalesce: false };
+                t.delete(args.entity);
+            },
+            replaceEntity(t, args) {
+                t.undoable = { coalesce: false };
+                t.delete(args.oldEntity);
+                return t.archetypes.PositionEntity.insert(args.newPosition);
+            },
+            applyOperations(t, operations) {
+                applyOperations(t, operations);
+            }
+        });
+        const undoRedo = createUndoRedoService(database);
+        // Create entity A
+        const entityA = database.transactions.createEntity({ position: { x: 1, y: 1 } });
+        // Replace A with B (delete A, create B) - simulates extrude
+        const entityB = database.transactions.replaceEntity({
+            oldEntity: entityA,
+            newPosition: { x: 2, y: 2 }
+        });
+        // Delete B - simulates clear selection
+        database.transactions.deleteEntity({ entity: entityB });
+        // Verify both are deleted
+        expect(database.read(entityA)).toBeNull();
+        expect(database.read(entityB)).toBeNull();
+        // Undo the delete of B
+        undoRedo.undo();
+        console.log('After undoing delete of B:');
+        console.log('entityA:', entityA, 'value:', database.read(entityA));
+        console.log('entityB:', entityB, 'value:', database.read(entityB));
+        expect(database.read(entityB)).toBeDefined();
+        expect(database.read(entityB)?.id).toBe(entityB);
+        // Note: entityA might be restored if B reused A's ID
+        if (entityA !== entityB) {
+            expect(database.read(entityA)).toBeNull();
+        }
+        // Undo the replace (should restore A, remove B)
+        undoRedo.undo();
+        expect(database.read(entityA)).toBeDefined();
+        expect(database.read(entityA)?.id).toBe(entityA);
+        expect(database.read(entityA)?.position.x).toBe(1);
+        expect(database.read(entityB)).toBeNull();
+    });
+});
+//# sourceMappingURL=entity-id-preservation.test.js.map

package/dist/ecs/database/transactional-store/entity-id-preservation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-id-preservation.test.js","sourceRoot":"","sources":["../../../../src/ecs/database/transactional-store/entity-id-preservation.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,MAAM,cAAc,GAAG;IACnB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,CAAC,EAAE,SAAS;QACZ,CAAC,EAAE,SAAS;KACf;IACD,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IACpB,oBAAoB,EAAE,KAAK;CACrB,CAAC;AAEX,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACjD,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACrE,MAAM,KAAK,GAAG,WAAW,CACrB,EAAE,QAAQ,EAAE,cAAc,EAAE,EAC5B,EAAE,EACF,EAAE,cAAc,EAAE,CAAC,UAAU,CAAC,EAAE,CACnC,CAAC;QAEF,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,EAAE;YACnC,YAAY,CAAC,CAAC,EAAE,IAA4C;gBACxD,CAAC,CAAC,QAAQ,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;gBACjC,OAAO,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACpD,CAAC;YACD,YAAY,CAAC,CAAC,EAAE,IAAwB;gBACpC,CAAC,CAAC,QAAQ,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;gBACjC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,CAAC;YACD,eAAe,CAAC,CAAC,EAAE,UAA4C;gBAC3D,eAAe,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YACnC,CAAC;SACJ,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAEjD,mBAAmB;QACnB,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAClF,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAE/B,mBAAmB;QACnB,IAAI,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEnC,oBAAoB;QACpB,QAAQ,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEzD,sBAAsB;QACtB,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAE1B,kBAAkB;QAClB,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEhB,+CAA+C;QAC/C,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC7E,MAAM,KAAK,GAAG,WAAW,CACrB,EAAE,QAAQ,EAAE,cAAc,EAAE,EAC5B,EAAE,EACF,EAAE,cAAc,EAAE,CAAC,UAAU,CAAC,EAAE,CACnC,CAAC;QAEF,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,EAAE;YACnC,YAAY,CAAC,CAAC,EAAE,IAA4C;gBACxD,CAAC,CAAC,QAAQ,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;gBACjC,OAAO,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACpD,CAAC;YACD,YAAY,CAAC,CAAC,EAAE,IAAwB;gBACpC,CAAC,CAAC,QAAQ,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;gBACjC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,CAAC;YACD,aAAa,CAAC,CAAC,EAAE,IAAkE;gBAC/E,CAAC,CAAC,QAAQ,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;gBACjC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACzB,OAAO,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAChE,CAAC;YACD,eAAe,CAAC,CAAC,EAAE,UAA4C;gBAC3D,eAAe,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YACnC,CAAC;SACJ,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAEjD,kBAAkB;QAClB,MAAM,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAEjF,4DAA4D;QAC5D,MAAM,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,aAAa,CAAC;YAChD,SAAS,EAAE,OAAO;YAClB,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;SAC9B,CAAC,CAAC;QAEH,uCAAuC;QACvC,QAAQ,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAExD,0BAA0B;QAC1B,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC1C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAE1C,uBAAuB;QACvB,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACnE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjD,qDAAqD;QACrD,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YACtB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC9C,CAAC;QAED,gDAAgD;QAChD,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/ecs/entity/entity.d.ts

@@ -0,0 +1,8 @@
+import { FromSchema } from "../../schema/schema.js";
+export declare const EntitySchema: {
+    readonly type: "integer";
+    readonly minimum: 0;
+    readonly maximum: 4294967295;
+    readonly default: number;
+};
+export type Entity = FromSchema<typeof EntitySchema>;

package/dist/ecs/entity/entity.js

@@ -0,0 +1,3 @@
+import { U32Schema } from "../../schema/u32.js";
+export const EntitySchema = U32Schema;
+//# sourceMappingURL=entity.js.map

package/dist/ecs/entity/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../../src/ecs/entity/entity.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC"}

package/dist/ecs/entity/u32.d.ts

@@ -0,0 +1,8 @@
+import { FromSchema } from "../../schema/index.js";
+export declare const schema: {
+    readonly type: "integer";
+    readonly minimum: 0;
+    readonly maximum: 4294967295;
+    readonly default: number;
+};
+export type Type = FromSchema<typeof schema>;

package/dist/{lit/elements/service-context.js → ecs/entity/u32.js}

@@ -19,6 +19,6 @@ 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 { createContext } from "@lit/context";
-export const serviceContext = createContext(Symbol("service"));
-//# sourceMappingURL=service-context.js.map
+import { U32Schema } from "../../schema/index.js";
+export const schema = U32Schema;
+//# sourceMappingURL=u32.js.map

package/dist/ecs/entity/u32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"u32.js","sourceRoot":"","sources":["../../../src/ecs/entity/u32.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,OAAO,EAAE,SAAS,EAAc,MAAM,uBAAuB,CAAC;AAC9D,MAAM,CAAC,MAAM,MAAM,GAAG,SAAS,CAAA"}

package/dist/ecs/store/store-schema/create-store-schema-test.js

@@ -19,8 +19,8 @@ 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 { createStoreSchema } from "./create-store-schema.js";
-const storeSchema = createStoreSchema({
+import { Store } from "../store.js";
+const storeSchema = Store.Schema.create({
     velocity: { type: "number" },
     particle: { type: "boolean" },
 }, {

package/dist/ecs/store/store-schema/create-store-schema-test.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-store-schema-test.js","sourceRoot":"","sources":["../../../../src/ecs/store/store-schema/create-store-schema-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAMX,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,WAAW,GAAG,iBAAiB,CACjC;IACI,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC5B,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;CAChC,EACD;IACI,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;IAC7C,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;CAC9C,EACD;IACI,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,eAAe,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;CAC5C,CACJ,CAAA"}
+{"version":3,"file":"create-store-schema-test.js","sourceRoot":"","sources":["../../../../src/ecs/store/store-schema/create-store-schema-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAKX,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CACnC;IACI,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC5B,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;CAChC,EACD;IACI,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;IAC7C,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;CAC9C,EACD;IACI,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,eAAe,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;CAC5C,CACJ,CAAA"}