@adobe/data 0.2.0 → 0.2.2

package/dist/ecs/database/transactional-store/create-transactional-store.test.js

@@ -0,0 +1,186 @@
+/*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 { createTransactionalStore } from "./create-transactional-store.js";
+import { createStore } from "../../store/create-store.js";
+import { F32Schema } from "../../../schema/f32.js";
+// Test schemas
+const positionSchema = {
+    type: "object",
+    properties: {
+        x: F32Schema,
+        y: F32Schema,
+        z: F32Schema,
+    }
+};
+const healthSchema = {
+    type: "object",
+    properties: {
+        current: F32Schema,
+        max: F32Schema,
+    }
+};
+describe("createTransactionalStore", () => {
+    it("should create transactional store with basic components", () => {
+        const baseStore = createStore({ position: positionSchema, health: healthSchema }, { time: { delta: 0.016, elapsed: 0 } });
+        const store = createTransactionalStore(baseStore);
+        expect(store).toBeDefined();
+        expect(store.componentSchemas).toHaveProperty("id");
+        expect(store.componentSchemas).toHaveProperty("position");
+        expect(store.componentSchemas).toHaveProperty("health");
+        expect(store.resources).toHaveProperty("time");
+    });
+    it("should execute transactions successfully", () => {
+        const baseStore = createStore({ position: positionSchema, health: healthSchema }, { time: { delta: 0.016, elapsed: 0 } });
+        const store = createTransactionalStore(baseStore);
+        const result = store.execute((transactionStore) => {
+            // Create an entity
+            const archetype = transactionStore.ensureArchetype(["id", "position"]);
+            const entity = archetype.insert({ position: { x: 1, y: 2, z: 3 } });
+            // Update the entity
+            transactionStore.update(entity, { position: { x: 10, y: 20, z: 30 } });
+            // Update resources
+            transactionStore.resources.time = { delta: 0.032, elapsed: 1 };
+        });
+        expect(result).toBeDefined();
+        expect(result.redo).toHaveLength(3); // insert + update
+        expect(result.undo).toHaveLength(3); // delete + insert with old values
+        expect(result.changedEntities.size).toBe(2);
+        expect(result.changedComponents.size).toBe(2); // position
+        expect(result.changedArchetypes.size).toBe(2);
+    });
+    it("should rollback on error", () => {
+        const baseStore = createStore({ position: positionSchema, health: healthSchema }, { time: { delta: 0.016, elapsed: 0 } });
+        const store = createTransactionalStore(baseStore);
+        // Create initial entity in a transaction
+        let entity = -1;
+        store.execute((transactionStore) => {
+            const archetype = transactionStore.ensureArchetype(["id", "position"]);
+            entity = archetype.insert({ position: { x: 1, y: 2, z: 3 } });
+        });
+        // Verify initial state
+        const initialData = store.read(entity);
+        expect(initialData?.position).toEqual({ x: 1, y: 2, z: 3 });
+        // Execute transaction that throws an error
+        expect(() => {
+            store.execute((transactionStore) => {
+                // Update entity
+                transactionStore.update(entity, { position: { x: 10, y: 20, z: 30 } });
+                // This should cause rollback
+                throw new Error("Transaction failed");
+            });
+        }).toThrow("Transaction failed");
+        // Verify rollback occurred
+        const finalData = store.read(entity);
+        expect(finalData?.position).toEqual({ x: 1, y: 2, z: 3 });
+    });
+    it("should combine multiple updates to the same entity", () => {
+        const baseStore = createStore({ position: positionSchema, health: healthSchema }, { time: { delta: 0.016, elapsed: 0 } });
+        const store = createTransactionalStore(baseStore);
+        const result = store.execute((transactionStore) => {
+            const archetype = transactionStore.ensureArchetype(["id", "position", "health"]);
+            const entity = archetype.insert({
+                position: { x: 1, y: 2, z: 3 },
+                health: { current: 100, max: 100 }
+            });
+            // Multiple updates to the same entity should be combined
+            transactionStore.update(entity, { position: { x: 10, y: 20, z: 30 } });
+            transactionStore.update(entity, { health: { current: 50, max: 100 } });
+        });
+        // Should have combined updates
+        expect(result.redo).toHaveLength(2); // insert + combined update
+        expect(result.undo).toHaveLength(2); // delete + insert with old values
+        const updateOperation = result.redo.find(op => op.type === "update");
+        expect(updateOperation?.type).toBe("update");
+        if (updateOperation?.type === "update") {
+            expect(updateOperation.values).toHaveProperty("position");
+            expect(updateOperation.values).toHaveProperty("health");
+        }
+    });
+    it("should track changed entities, components, and archetypes", () => {
+        const baseStore = createStore({ position: positionSchema, health: healthSchema }, { time: { delta: 0.016, elapsed: 0 } });
+        const store = createTransactionalStore(baseStore);
+        const result = store.execute((transactionStore) => {
+            // Create entities in different archetypes
+            const posArchetype = transactionStore.ensureArchetype(["id", "position"]);
+            const healthArchetype = transactionStore.ensureArchetype(["id", "health"]);
+            const entity1 = posArchetype.insert({ position: { x: 1, y: 2, z: 3 } });
+            const entity2 = healthArchetype.insert({ health: { current: 100, max: 100 } });
+            // Update resources
+            transactionStore.resources.time = { delta: 0.032, elapsed: 1 };
+        });
+        expect(result.changedEntities.size).toBe(3);
+        expect(result.changedComponents.size).toBe(3); // position, health
+        expect(result.changedArchetypes.size).toBe(3); // two different archetypes
+    });
+    it("should preserve base store functionality", () => {
+        const baseStore = createStore({ position: positionSchema, health: healthSchema }, { time: { delta: 0.016, elapsed: 0 } });
+        const store = createTransactionalStore(baseStore);
+        // Verify all base store methods are available
+        expect(store.componentSchemas).toBeDefined();
+        expect(store.resources).toBeDefined();
+        expect(store.queryArchetypes).toBeDefined();
+        expect(store.ensureArchetype).toBeDefined();
+        expect(store.locate).toBeDefined();
+        expect(store.read).toBeDefined();
+        expect(store.execute).toBeDefined();
+        // Verify we can use the store normally for read operations
+        const archetypes = store.queryArchetypes(["id"]);
+        expect(archetypes.length).toBeGreaterThan(0);
+        // Verify we can create entities through transactions
+        store.execute((transactionStore) => {
+            const archetype = transactionStore.ensureArchetype(["id", "position"]);
+            const entity = archetype.insert({ position: { x: 1, y: 2, z: 3 } });
+            expect(store.read(entity)).toBeDefined();
+        });
+    });
+    it("should support transient transactions", () => {
+        const baseStore = createStore({ position: positionSchema, health: healthSchema }, { time: { delta: 0.016, elapsed: 0 } });
+        const store = createTransactionalStore(baseStore);
+        // Execute a regular transaction (non-transient)
+        const regularResult = store.execute((transactionStore) => {
+            const archetype = transactionStore.ensureArchetype(["id", "position"]);
+            archetype.insert({ position: { x: 1, y: 2, z: 3 } });
+        });
+        expect(regularResult.transient).toBe(false);
+        // Execute a transient transaction
+        const transientResult = store.execute((transactionStore) => {
+            const archetype = transactionStore.ensureArchetype(["id", "position"]);
+            archetype.insert({ position: { x: 10, y: 20, z: 30 } });
+        }, { transient: true });
+        expect(transientResult.transient).toBe(true);
+        // Both transactions should have the same structure but different transient flags
+        expect(regularResult).toHaveProperty("value");
+        expect(regularResult).toHaveProperty("redo");
+        expect(regularResult).toHaveProperty("undo");
+        expect(regularResult).toHaveProperty("changedEntities");
+        expect(regularResult).toHaveProperty("changedComponents");
+        expect(regularResult).toHaveProperty("changedArchetypes");
+        expect(transientResult).toHaveProperty("value");
+        expect(transientResult).toHaveProperty("redo");
+        expect(transientResult).toHaveProperty("undo");
+        expect(transientResult).toHaveProperty("changedEntities");
+        expect(transientResult).toHaveProperty("changedComponents");
+        expect(transientResult).toHaveProperty("changedArchetypes");
+    });
+});
+//# sourceMappingURL=create-transactional-store.test.js.map

package/dist/ecs/database/transactional-store/create-transactional-store.test.js.map

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

package/dist/ecs/database/transactional-store/index.d.ts

@@ -0,0 +1 @@
+export * from "./transactional-store.js";

package/dist/ecs/database/transactional-store/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 "./transactional-store.js";
+//# sourceMappingURL=index.js.map

package/dist/ecs/database/transactional-store/index.js.map

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

package/dist/ecs/database/transactional-store/transactional-store.d.ts

@@ -0,0 +1,44 @@
+import { ArchetypeId, EntityInsertValues } from "../../archetype/index.js";
+import { CoreComponents } from "../../core-components.js";
+import { ResourceComponents } from "../../store/resource-components.js";
+import { ReadonlyStore, Store } from "../../store/index.js";
+import { Entity } from "../../entity.js";
+import { EntityUpdateValues } from "../../store/core/index.js";
+export interface TransactionalStore<C extends CoreComponents = CoreComponents, R extends ResourceComponents = never> extends ReadonlyStore<C, R> {
+    /**
+     * Execute a transaction on the store.
+     * The transactionFunction must NOT directly mutate archetype rows as those changes would not be captured.
+     * Instead, use the store's update and delete and archetype insert methods to make changes.
+     * @param transactionFunction - A function that takes the store as an argument and performs some operations on it.
+     * @returns A promise that resolves when the transaction is complete.
+     */
+    execute(transactionFunction: (store: Store<C, R>) => Entity | void, options?: {
+        transient?: boolean;
+    }): TransactionResult<C>;
+}
+export type TransactionInsertOperation<C> = {
+    type: "insert";
+    values: EntityInsertValues<C>;
+};
+export type TransactionUpdateOperation<C> = {
+    type: "update";
+    entity: Entity;
+    values: EntityUpdateValues<C>;
+};
+export type TransactionDeleteOperation = {
+    type: "delete";
+    entity: Entity;
+};
+export type TransactionWriteOperation<C> = TransactionInsertOperation<C> | TransactionUpdateOperation<C> | TransactionDeleteOperation;
+export interface TransactionResult<C> {
+    /**
+     * The Entity value if any returned by the transaction function.
+     */
+    readonly value: Entity | void;
+    readonly transient: boolean;
+    readonly redo: TransactionWriteOperation<C>[];
+    readonly undo: TransactionWriteOperation<C>[];
+    readonly changedEntities: Set<Entity>;
+    readonly changedComponents: Set<keyof C>;
+    readonly changedArchetypes: Set<ArchetypeId>;
+}

package/dist/ecs/database/transactional-store/transactional-store.js

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

package/dist/ecs/database/transactional-store/transactional-store.js.map

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

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

@@ -0,0 +1,132 @@
+import { Data, FromSchema, Schema } from "../../core/index.js";
+import { Simplify } from "../../types/types.js";
+import { CoreComponents, ECSJSON, Table } from "../core-ecs/core-ecs-types.js";
+import { EntityCreateValues, Entity, EntityValues, EntityUpdateValues } from "../core-ecs/core-ecs-types.js";
+export type ECSComponents = CoreComponents;
+/**
+ * Represents a runtime handle to an ECS Archetype.
+ * An archetype represents a set of components that are required to be present on an entity.
+ * These instances cannot be created directly or persisted but are returned from the ECS API.
+ */
+export interface Archetype<EntityType = any> {
+    readonly components: readonly (keyof EntityType)[];
+}
+export type ECSResources = {};
+export type TypeFromComponents<C extends ECSComponents, T extends (keyof C)[]> = {
+    [K in T[number]]: C[K];
+};
+export type ECSArchetypes = {};
+/**
+ * Comparison operators for declarative where clauses
+ */
+type ComparisonOperator = "==" | "!=" | "<" | ">" | ">=" | "<=";
+/**
+ * Represents a comparison operation in a declarative where clause
+ */
+type ComparisonOperation<T> = {
+    [P in ComparisonOperator]?: T;
+};
+/**
+ * Represents a condition that can be either a direct value, comparison operation, or nested conditions
+ */
+type WhereCondition<T> = T extends object ? {
+    [K in keyof T]?: WhereCondition<T[K]>;
+} | ComparisonOperation<T> : T | ComparisonOperation<T>;
+/**
+ * Declarative where clause structure that allows for JSON-based filtering
+ * Each key in the object represents a component field to filter on
+ * The value can either be a direct value (equality check), a comparison operation, or nested conditions
+ */
+export type WhereClause<T extends CoreComponents> = {
+    [K in keyof T]?: WhereCondition<T[K]>;
+};
+type SelectOrder<T extends CoreComponents> = {
+    [K in keyof T]?: boolean;
+};
+export type SelectOptions<C extends CoreComponents, T extends CoreComponents> = {
+    /**
+     * Order results by the given components ascending or descending.
+     */
+    order?: SelectOrder<T>;
+    /**
+     * Components to include in the results.
+     */
+    components?: (keyof T)[];
+    /**
+     * Do not return any rows for entities that contain these components.
+     */
+    without?: (keyof C)[];
+    /**
+     * Filter the results by the given condition using a declarative where clause.
+     */
+    where?: WhereClause<T>;
+};
+/**
+ * An Entity Component System (ECS) is a data structure that stores entities and their components.
+ * This interface is used for low level ECS instances that allow fast, direct read and write access.
+ */
+export interface ECS<C extends ECSComponents = ECSComponents, //  name => Component Value Type
+A extends ECSArchetypes = ECSArchetypes, //  name => Archetype
+R extends ECSResources = ECSResources> extends ECSWrite<C> {
+    components: {
+        readonly [K in keyof C]: Schema;
+    };
+    archetypes: A;
+    resources: {
+        -readonly [K in keyof R]: R[K];
+    };
+    withComponents<S extends {
+        [K: string]: Schema;
+    }, T = {
+        [K in keyof S]: FromSchema<S[K]>;
+    }>(components: S): ECS<Simplify<C & T>, A, R>;
+    withArchetypes<S extends {
+        [K: string]: ReadonlyArray<keyof C>;
+    }>(archetypes: S): ECS<C, Simplify<A & {
+        -readonly [AN in keyof S]: Archetype<{
+            [PN in S[AN][number]]: C[PN];
+        }>;
+    }>, R>;
+    withResources<S extends {
+        [K: string]: Data;
+    }>(resources: S): ECS<C, A, Simplify<R & S>>;
+    getComponentValue<Name extends keyof C>(id: Entity, component: Name): C[Name] | undefined;
+    getArchetype<AC extends (keyof C)[]>(...components: AC): Archetype<TypeFromComponents<C, AC>>;
+    getEntityArchetype(id: Entity): Archetype;
+    /**
+     * @returns
+     *  The entity values if this entity contains all of the archetype components.
+     *  Null if the entity exists but does not contain all of the archetype components.
+     *  Undefined if the entity does not exist.
+     */
+    getEntityValues<A>(id: Entity, archetype: Archetype<A>): A & Partial<EntityValues<C>> | null | undefined;
+    /**
+     * @returns The entity values if this entity exists otherwise undefined.
+     */
+    getEntityValues(id: Entity): EntityValues<C> | undefined;
+    countEntities<T extends CoreComponents>(archetype: Archetype<T>): number;
+    selectEntities<T extends CoreComponents, P extends Partial<T>>(archetype: Archetype<T>, options?: Omit<SelectOptions<C, T>, "components">): Entity[];
+    getTables(): Table[];
+    getTables<T>(archetype: Archetype<T>, options: {
+        mode: "read" | "write";
+        exact?: boolean;
+    }): Table<T>[];
+    selectEntityValues<T extends CoreComponents, P extends Partial<T>>(archetype: Archetype<T>, options: SelectOptions<C, T>): P[];
+    selectEntityValues<T extends CoreComponents>(archetype: Archetype<T>): Simplify<T & EntityValues<C>>[];
+    createBatch<T>(archetype: Archetype<T>, count: number): Table<T>;
+    toJSON(): ECSJSON;
+}
+export interface ECSWrite<C extends ECSComponents> {
+    /**
+     * Sets the value of a component for the given entity.
+     * @param component the component to write.
+     * @param value the value of the component or undefined to delete the component.
+     * @param id if not provided, uses the components own entity id as with resources.
+     */
+    setComponentValue<Name extends keyof C>(id: Entity, component: Name, value: C[Name] | undefined): void;
+    createEntity(): Entity;
+    createEntity<T>(archetype: Archetype<T>, values: EntityCreateValues<T>): Entity;
+    updateEntity(id: Entity, values: EntityUpdateValues<C>): void;
+    deleteEntity(id: Entity): void;
+}
+export {};

package/dist/ecs/ecs/ecs-types.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 {};
+//# sourceMappingURL=ecs-types.js.map

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

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

package/dist/ecs/ecs/ecs-where-functions.d.ts

@@ -0,0 +1,6 @@
+import { EntityValues, CoreComponents } from "../core-ecs/core-ecs-types.js";
+import { WhereClause } from "./ecs-types.js";
+/**
+ * Converts a declarative where clause to a predicate function
+ */
+export declare function whereClauseToPredicate<T extends CoreComponents>(whereClause: WhereClause<T>): (entity: EntityValues<T>) => boolean;

package/dist/ecs/ecs/ecs-where-functions.js

@@ -0,0 +1,91 @@
+/*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.*/
+/**
+ * Converts a declarative where clause to a predicate function
+ */
+export function whereClauseToPredicate(whereClause) {
+    // Helper function to get nested value
+    function getNestedValue(obj, path) {
+        return path.reduce((current, key) => current && current[key], obj);
+    }
+    // Helper function to check conditions recursively
+    function checkCondition(value, condition) {
+        // If condition is a direct value, check for equality
+        if (typeof condition !== 'object' || condition === null) {
+            return value === condition;
+        }
+        // If condition is an object but not a comparison operation, it's a nested path
+        if (!('==' in condition || '!=' in condition || '<' in condition || '>' in condition || '<=' in condition || '>=' in condition)) {
+            // Recursively check all nested conditions
+            return Object.entries(condition).every(([key, subCondition]) => checkCondition(value[key], subCondition));
+        }
+        // Handle comparison operations
+        for (const [op, compareValue] of Object.entries(condition)) {
+            switch (op) {
+                case "==":
+                    if (value !== compareValue)
+                        return false;
+                    break;
+                case "!=":
+                    if (value === compareValue)
+                        return false;
+                    break;
+                case "<":
+                    if (typeof value === 'number' && typeof compareValue === 'number') {
+                        if (!(value < compareValue))
+                            return false;
+                    }
+                    break;
+                case ">":
+                    if (typeof value === 'number' && typeof compareValue === 'number') {
+                        if (!(value > compareValue))
+                            return false;
+                    }
+                    break;
+                case "<=":
+                    if (typeof value === 'number' && typeof compareValue === 'number') {
+                        if (!(value <= compareValue))
+                            return false;
+                    }
+                    break;
+                case ">=":
+                    if (typeof value === 'number' && typeof compareValue === 'number') {
+                        if (!(value >= compareValue))
+                            return false;
+                    }
+                    break;
+            }
+        }
+        return true;
+    }
+    return (entity) => {
+        for (const [key, condition] of Object.entries(whereClause)) {
+            const fieldKey = key;
+            const value = entity[fieldKey];
+            if (!checkCondition(value, condition)) {
+                return false;
+            }
+        }
+        return true;
+    };
+}
+//# sourceMappingURL=ecs-where-functions.js.map

package/dist/ecs/ecs/ecs-where-functions.js.map

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

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

@@ -0,0 +1,13 @@
+import { MemoryAllocator } from "../../cache/memory-allocator.js";
+import { ECSJSON } from "../core-ecs/core-ecs-types.js";
+import { ECS, ECSArchetypes, ECSComponents, ECSResources } from "./ecs-types.js";
+/**
+ * Creates a new low level ECS.
+ * This can be used for high performance applications but
+ * for most cases the createActionECS is a better choice.
+ * @param json a value previously returned from calling toJSON.
+ */
+export declare function createECS<C extends ECSComponents = ECSComponents, A extends ECSArchetypes = ECSArchetypes, R extends ECSResources = ECSResources>(options?: {
+    allocator?: MemoryAllocator;
+    data?: ECSJSON;
+}): ECS<C, A, R>;