@adobe/data 0.7.0 → 0.7.2

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

@@ -0,0 +1,47 @@
+import { Archetype, ArchetypeId, ReadonlyArchetype } from "../../archetype/index.js";
+import { ResourceComponents } from "../../store/resource-components.js";
+import { ReadonlyStore } from "../../store/index.js";
+import { Entity } from "../../entity.js";
+import { EntityReadValues } from "../../store/core/index.js";
+import { TransactionResult } from "../transactional-store/index.js";
+import { StringKeyof } from "../../../types/types.js";
+import { Observe } from "../../../observe/index.js";
+import { Components } from "../../store/components.js";
+import { ArchetypeComponents } from "../../store/archetype-components.js";
+import { CoreComponents } from "../../core-components.js";
+import { Service } from "../../../service/service.js";
+import { TransactionDeclarations } from "../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 AppliedDatabase<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>, TD extends TransactionDeclarations<C, R, A>> extends ReadonlyStore<C, R, A>, Service {
+    readonly resources: {
+        readonly [K in StringKeyof<R>]: R[K];
+    };
+    readonly observe: {
+        readonly components: {
+            readonly [K in StringKeyof<C>]: Observe<void>;
+        };
+        readonly resources: {
+            readonly [K in StringKeyof<R>]: Observe<R[K]>;
+        };
+        readonly transactions: Observe<TransactionResult<C>>;
+        entity<T extends CoreComponents>(id: Entity, minArchetype?: ReadonlyArchetype<T> | Archetype<T>): Observe<{
+            readonly [K in (StringKeyof<CoreComponents & T>)]: (CoreComponents & T)[K];
+        } & EntityReadValues<C> | null>;
+        entity(id: Entity): Observe<EntityReadValues<C> | null>;
+        archetype(id: ArchetypeId): Observe<void>;
+        select<Include extends StringKeyof<C>, T extends Include>(include: readonly Include[] | ReadonlySet<string>, options?: any): Observe<readonly Entity[]>;
+    };
+    readonly toData: () => unknown;
+    readonly fromData: (data: unknown) => void;
+    readonly apply: (envelope: TransactionEnvelope<Extract<keyof TD, string>>) => TransactionResult<C> | undefined;
+    readonly cancel: (id: number) => void;
+}

package/dist/ecs/database/applied/applied-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=applied-database.js.map

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

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

package/dist/ecs/database/applied/applied-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 AppliedEntry<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 AppliedEntryOps: {
+    isTransient<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>>(entry: AppliedEntry<C, R, A>): boolean;
+    compare<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>>(a: AppliedEntry<C, R, A>, b: AppliedEntry<C, R, A>): number;
+    findInsertIndex<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>>(entries: AppliedEntry<C, R, A>[], entry: AppliedEntry<C, R, A>): number;
+};
+export type SerializedAppliedEntry = {
+    readonly id: number;
+    readonly name: string;
+    readonly args: unknown;
+    readonly time: number;
+    readonly undo?: TransactionWriteOperation<any>[];
+};
+export declare const serializeAppliedEntry: <C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>>(entry: AppliedEntry<C, R, A>) => SerializedAppliedEntry;
+export declare const deserializeAppliedEntry: <C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>>(serialized: SerializedAppliedEntry, transaction: (store: Store<C, R, A>, args: unknown) => void | Entity) => AppliedEntry<C, R, A>;

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

@@ -0,0 +1,84 @@
+/*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 AppliedEntryOps = {
+    isTransient(entry) {
+        return entry.time < 0;
+    },
+    compare(a, b) {
+        const absDiff = Math.abs(a.time) - Math.abs(b.time);
+        if (absDiff !== 0) {
+            return absDiff;
+        }
+        if (a.name < b.name) {
+            return -1;
+        }
+        if (a.name > b.name) {
+            return 1;
+        }
+        return a.id - b.id;
+    },
+    findInsertIndex(entries, entry) {
+        let low = 0;
+        let high = entries.length;
+        while (low < high) {
+            const mid = (low + high) >> 1;
+            if (AppliedEntryOps.compare(entry, entries[mid]) < 0) {
+                high = mid;
+            }
+            else {
+                low = mid + 1;
+            }
+        }
+        return low;
+    },
+};
+export const serializeAppliedEntry = (entry) => ({
+    id: entry.id,
+    name: entry.name,
+    args: entry.args,
+    time: entry.time,
+    undo: entry.result?.undo,
+});
+export const deserializeAppliedEntry = (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=applied-entry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"applied-entry.js","sourceRoot":"","sources":["../../../../src/ecs/database/applied/applied-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;WAmBW;AAwBX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,WAAW,CAIT,KAA4B;QAC1B,OAAO,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,CAIL,CAAwB,EAAE,CAAwB;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO,OAAO,CAAC;QACnB,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO,CAAC,CAAC,CAAC;QACd,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO,CAAC,CAAC;QACb,CAAC;QACD,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;IACvB,CAAC;IACD,eAAe,CAIb,OAAgC,EAAE,KAA4B;QAC5D,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,IAAI,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;QAC1B,OAAO,GAAG,GAAG,IAAI,EAAE,CAAC;YAChB,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnD,IAAI,GAAG,GAAG,CAAC;YACf,CAAC;iBAAM,CAAC;gBACJ,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;YAClB,CAAC;QACL,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;CACJ,CAAC;AAUF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAKjC,KAA4B,EACN,EAAE,CAAC,CAAC;IAC1B,EAAE,EAAE,KAAK,CAAC,EAAE;IACZ,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,IAAoD;CAC3E,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAKnC,UAAkC,EAClC,WAAoE,EAC/C,EAAE;IACvB,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;QACjD,CAAC,CAAE,UAAU,CAAC,IAAuC;QACrD,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO;QACH,EAAE,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QACzB,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,WAAW;QACX,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,MAAM,EAAE,cAAc;YAClB,CAAC,CAAC;gBACE,KAAK,EAAE,SAAS;gBAChB,SAAS,EAAE,UAAU,CAAC,IAAI,GAAG,CAAC;gBAC9B,QAAQ,EAAE,IAAI;gBACd,IAAI,EAAE,EAAE;gBACR,IAAI,EAAE,cAAc;gBACpB,eAAe,EAAE,IAAI,GAAG,EAAE;gBAC1B,iBAAiB,EAAE,IAAI,GAAG,EAAE;gBAC5B,iBAAiB,EAAE,IAAI,GAAG,EAAE;aAC/B;YACD,CAAC,CAAC,SAAS;KAClB,CAAC;AACN,CAAC,CAAC"}

package/dist/ecs/database/applied/create-applied-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 { AppliedDatabase } from "./applied-database.js";
+export declare function createAppliedDatabase<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): AppliedDatabase<C, R, A, TD>;

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

@@ -0,0 +1,266 @@
+/*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 { mapEntries } from "../../../internal/object/index.js";
+import { withMap } from "../../../observe/index.js";
+import { createTransactionalStore } from "../transactional-store/create-transactional-store.js";
+import { applyOperations } from "../transactional-store/apply-operations.js";
+import { observeSelectEntities } from "../observe-select-entities.js";
+import { AppliedEntryOps, serializeAppliedEntry, deserializeAppliedEntry, } from "./applied-entry.js";
+const addToMapSet = (key, map) => (value) => {
+    let set = map.get(key);
+    if (set) {
+        set.add(value);
+    }
+    else {
+        map.set(key, (set = new Set([value])));
+    }
+    return () => {
+        set.delete(value);
+    };
+};
+export function createAppliedDatabase(store, transactionDeclarations) {
+    const transactionalStore = createTransactionalStore(store);
+    const { execute: transactionalExecute, resources, ...rest } = transactionalStore;
+    const componentObservers = new Map();
+    const archetypeObservers = new Map();
+    const entityObservers = new Map();
+    const transactionObservers = new Set();
+    const execute = (handler, options) => {
+        const result = transactionalExecute(handler, options);
+        notifyObservers(result);
+        return result;
+    };
+    const notifyObservers = (result) => {
+        for (const observer of transactionObservers) {
+            observer(result);
+        }
+        for (const changedComponent of result.changedComponents) {
+            const observers = componentObservers.get(changedComponent);
+            if (observers) {
+                for (const observer of observers) {
+                    observer();
+                }
+            }
+        }
+        for (const changedArchetype of result.changedArchetypes) {
+            const observers = archetypeObservers.get(changedArchetype);
+            if (observers) {
+                for (const observer of observers) {
+                    observer();
+                }
+            }
+        }
+        for (const changedEntity of result.changedEntities.keys()) {
+            const observers = entityObservers.get(changedEntity);
+            if (observers) {
+                const values = store.read(changedEntity);
+                for (const observer of observers) {
+                    observer(values);
+                }
+            }
+        }
+    };
+    const observeEntity = (entity, minArchetype) => (observer) => {
+        if (minArchetype) {
+            const originalObserver = observer;
+            observer = (values) => {
+                if (values) {
+                    const location = store.locate(entity);
+                    if (location) {
+                        const { archetype } = location;
+                        if (archetype.id !== minArchetype.id && !archetype.components.isSupersetOf(minArchetype.components)) {
+                            values = null;
+                        }
+                    }
+                }
+                originalObserver(values);
+            };
+        }
+        observer(store.read(entity));
+        const dispose = addToMapSet(entity, entityObservers)(observer);
+        return dispose;
+    };
+    const observeArchetype = (archetype) => addToMapSet(archetype, archetypeObservers);
+    const observeComponent = mapEntries(store.componentSchemas, ([component]) => addToMapSet(component, componentObservers));
+    const observeResource = Object.fromEntries(Object.entries(store.resources).map(([resource]) => {
+        const archetype = store.ensureArchetype(["id", resource]);
+        const resourceId = archetype.columns.id.get(0);
+        return [resource, withMap(observeEntity(resourceId), (values) => values?.[resource] ?? null)];
+    }));
+    const observeTransaction = (notify) => {
+        transactionObservers.add(notify);
+        return () => {
+            transactionObservers.delete(notify);
+        };
+    };
+    const observe = {
+        components: observeComponent,
+        resources: observeResource,
+        transactions: observeTransaction,
+        entity: observeEntity,
+        archetype: observeArchetype,
+        select: observeSelectEntities(transactionalStore, observeTransaction),
+    };
+    const appliedEntries = [];
+    const rollbackRange = (startIndex) => {
+        for (let i = appliedEntries.length - 1; i >= startIndex; i--) {
+            const entry = appliedEntries[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 < appliedEntries.length; i++) {
+            const entry = appliedEntries[i];
+            const result = execute(t => entry.transaction(t, entry.args), { transient: AppliedEntryOps.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 = appliedEntries.length;
+        const existingIndex = appliedEntries.findIndex(entry => entry.id === envelope.id);
+        if (existingIndex >= 0) {
+            startIndex = existingIndex;
+            const existingEntry = appliedEntries[existingIndex];
+            if (existingEntry.result) {
+                execute(t => applyOperations(t, existingEntry.result.undo), { transient: true });
+                existingEntry.result = undefined;
+            }
+            appliedEntries.splice(existingIndex, 1);
+        }
+        if (isCancellation) {
+            if (startIndex < appliedEntries.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 = AppliedEntryOps.findInsertIndex(appliedEntries, entry);
+        appliedEntries.splice(insertIndex, 0, entry);
+        const rebuildIndex = Math.min(startIndex, insertIndex);
+        rollbackRange(rebuildIndex);
+        replayRange(rebuildIndex);
+        const insertedEntry = appliedEntries.find(e => e.id === envelope.id);
+        const latestResult = insertedEntry?.result;
+        return latestResult;
+    };
+    const notifyAllObserversStoreReloaded = () => {
+        const notifyResult = {
+            changedComponents: new Set(componentObservers.keys()),
+            changedArchetypes: new Set(archetypeObservers.keys()),
+            changedEntities: new Map([...entityObservers.keys()].map((entity) => {
+                const values = store.read(entity);
+                let updateValues = null;
+                if (values) {
+                    const { id, ...rest } = values;
+                    updateValues = rest;
+                }
+                return [
+                    entity,
+                    updateValues
+                ];
+            })),
+            transient: false,
+            value: undefined,
+            undo: [],
+            redo: [],
+            undoable: null,
+        };
+        notifyObservers(notifyResult);
+    };
+    const removeEntryAtIndex = (index, { rollback }) => {
+        if (index < 0 || index >= appliedEntries.length) {
+            return;
+        }
+        if (rollback) {
+            rollbackRange(index);
+        }
+        appliedEntries.splice(index, 1);
+        if (rollback) {
+            replayRange(index);
+        }
+    };
+    const cancelEntry = (id) => {
+        const index = appliedEntries.findIndex(entry => entry.id === id);
+        if (index === -1) {
+            return;
+        }
+        removeEntryAtIndex(index, { rollback: true });
+    };
+    const serializeAppliedEntries = () => appliedEntries
+        .filter(entry => AppliedEntryOps.isTransient(entry))
+        .map(entry => serializeAppliedEntry(entry));
+    const appliedDatabase = {
+        serviceName: "ecs-applied-database-service",
+        ...rest,
+        resources,
+        observe,
+        toData: () => ({
+            store: store.toData(),
+            appliedEntries: serializeAppliedEntries(),
+        }),
+        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;
+            }
+            store.fromData(storeData);
+            appliedEntries.length = 0;
+            if (serializedEntries) {
+                for (const serializedEntry of serializedEntries) {
+                    const transaction = transactionDeclarations[serializedEntry.name];
+                    if (!transaction) {
+                        continue;
+                    }
+                    const entry = deserializeAppliedEntry(serializedEntry, transaction);
+                    appliedEntries.push(entry);
+                }
+                appliedEntries.sort(AppliedEntryOps.compare);
+            }
+            notifyAllObserversStoreReloaded();
+        },
+        apply: applyEnvelope,
+        cancel: cancelEntry,
+    };
+    return appliedDatabase;
+}
+//# sourceMappingURL=create-applied-database.js.map

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

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

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

@@ -0,0 +1,94 @@
+import { describe, it, expect } from "vitest";
+import { createAppliedDatabase } from "./create-applied-database.js";
+import { createStore } from "../../store/create-store.js";
+const createTestAppliedDatabase = () => {
+    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 createAppliedDatabase(store, transactions);
+};
+const readEntityNames = (applied) => applied
+    .select(["name"])
+    .map(entity => applied.read(entity)?.name)
+    .filter((name) => Boolean(name));
+describe("createAppliedDatabase", () => {
+    it("replaces a transient entry when the same id yields again", () => {
+        const applied = createTestAppliedDatabase();
+        applied.apply({
+            id: 1,
+            name: "createPositionNameEntity",
+            args: { position: { x: 0, y: 0, z: 0 }, name: "First" },
+            time: -1,
+        });
+        applied.apply({
+            id: 1,
+            name: "createPositionNameEntity",
+            args: { position: { x: 1, y: 1, z: 1 }, name: "Second" },
+            time: -2,
+        });
+        expect(readEntityNames(applied)).toEqual(["Second"]);
+        const serialized = applied.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 applied = createTestAppliedDatabase();
+        applied.apply({
+            id: 10,
+            name: "createPositionNameEntity",
+            args: { position: { x: 0, y: 0, z: 0 }, name: "Transient" },
+            time: -1,
+        });
+        applied.apply({
+            id: 11,
+            name: "createPositionNameEntity",
+            args: { position: { x: 5, y: 5, z: 5 }, name: "Committed" },
+            time: 2,
+        });
+        const serializedBefore = applied.toData();
+        expect(serializedBefore.appliedEntries).toHaveLength(1);
+        applied.cancel(10);
+        expect(readEntityNames(applied)).toEqual(["Committed"]);
+        const serializedAfter = applied.toData();
+        expect(serializedAfter.appliedEntries ?? []).toHaveLength(0);
+    });
+    it("clears transient state after commit confirmation", () => {
+        const applied = createTestAppliedDatabase();
+        applied.apply({
+            id: 21,
+            name: "createPositionNameEntity",
+            args: { position: { x: 1, y: 2, z: 3 }, name: "InFlight" },
+            time: -1,
+        });
+        applied.apply({
+            id: 21,
+            name: "createPositionNameEntity",
+            args: { position: { x: 4, y: 5, z: 6 }, name: "Final" },
+            time: 5,
+        });
+        expect(readEntityNames(applied)).toEqual(["Final"]);
+        const serialized = applied.toData();
+        expect(serialized.appliedEntries ?? []).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=create-applied-database.test.js.map

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

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

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

@@ -0,0 +1,49 @@
+import { Archetype, ArchetypeId, ReadonlyArchetype } from "../archetype/index.js";
+import { ResourceComponents } from "../store/resource-components.js";
+import { Store, ReadonlyStore } from "../store/index.js";
+import { Entity } from "../entity.js";
+import { EntityReadValues } from "../store/core/index.js";
+import { TransactionResult } from "./transactional-store/index.js";
+import { StringKeyof } from "../../types/types.js";
+import { Observe } from "../../observe/index.js";
+import { Components } from "../store/components.js";
+import { ArchetypeComponents } from "../store/archetype-components.js";
+import { CoreComponents } from "../core-components.js";
+import { Service } from "../../service/service.js";
+import { TransactionDeclarations } from "./database.js";
+export type TransactionEnvelope<Name extends string = string> = {
+    readonly id: bigint;
+    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 AppliedDatabase<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>, TD extends TransactionDeclarations<C, R, A>> extends ReadonlyStore<C, R, A>, Service {
+    readonly resources: {
+        readonly [K in StringKeyof<R>]: R[K];
+    };
+    readonly observe: {
+        readonly components: {
+            readonly [K in StringKeyof<C>]: Observe<void>;
+        };
+        readonly resources: {
+            readonly [K in StringKeyof<R>]: Observe<R[K]>;
+        };
+        readonly transactions: Observe<TransactionResult<C>>;
+        entity<T extends CoreComponents>(id: Entity, minArchetype?: ReadonlyArchetype<T> | Archetype<T>): Observe<{
+            readonly [K in (StringKeyof<CoreComponents & T>)]: (CoreComponents & T)[K];
+        } & EntityReadValues<C> | null>;
+        entity(id: Entity): Observe<EntityReadValues<C> | null>;
+        archetype(id: ArchetypeId): Observe<void>;
+        select<Include extends StringKeyof<C>, T extends Include>(include: readonly Include[] | ReadonlySet<string>, options?: any): Observe<readonly Entity[]>;
+    };
+    readonly toData: () => unknown;
+    readonly fromData: (data: unknown) => void;
+    readonly apply: (envelope: TransactionEnvelope<Extract<keyof TD, string>>) => TransactionResult<C> | undefined;
+}
+export declare function createAppliedDatabase<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, options?: {
+    maxSynchronizeDurationMs?: number;
+}): AppliedDatabase<C, R, A, TD>;