@adobe/data 0.9.81 → 0.9.83

package/dist/ecs/store/public/create-store.partition.test.js

@@ -0,0 +1,111 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it, expect } from "vitest";
+import { createStore } from "./create-store.js";
+import { constBufferType } from "../../../typed-buffer/create-const-buffer.js";
+// `cell` partitions; `name` is uniquely indexed. `as const` preserves the
+// `partition: true` literal (so the store is typed with the discrimination) and
+// the index declaration (so `store.indexes.byName` is typed).
+const schema = {
+    components: {
+        cell: { type: "integer", partition: true },
+        name: { type: "string" },
+    },
+    resources: {},
+    archetypes: { Spatial: ["cell", "name"] },
+    indexes: { byName: { key: "name", unique: true } },
+};
+const makeStore = () => createStore(schema);
+describe("Store partition integration", () => {
+    it("dynamically extends with a partition component AFTER creation; N values → N archetypes, each with a const column", () => {
+        // Start with an empty store, then extend — exercises live (post-construction)
+        // partition detection, not the schema passed at creation.
+        const store = createStore().extend(schema);
+        // The dynamically-added partitioned archetype is a Router (no dense view).
+        const spatial = store.archetypes.Spatial;
+        expect("columns" in spatial).toBe(false);
+        // Insert N entities with N distinct partition values.
+        const N = 5;
+        const entities = Array.from({ length: N }, (_, i) => spatial.insert({ cell: i, name: `e${i}` }));
+        // Query the archetypes — exactly N, one per distinct value.
+        const archetypes = store.queryArchetypes(["cell", "name"]);
+        expect(archetypes.length).toBe(N);
+        // Every distinct value lives in its own archetype, and each still carries
+        // a named `cell` column that is a const typed buffer (zero per-row bytes).
+        const valuesSeen = new Set();
+        for (const arch of archetypes) {
+            expect(arch.rowCount).toBe(1);
+            const cellColumn = arch.columns.cell;
+            expect(cellColumn.type).toBe(constBufferType);
+            expect(cellColumn.typedArrayElementSizeInBytes).toBe(0);
+            valuesSeen.add(cellColumn.get(0));
+        }
+        expect([...valuesSeen].sort((a, b) => a - b)).toEqual([0, 1, 2, 3, 4]);
+        // The index (also added dynamically) resolves each routed entity.
+        for (let i = 0; i < N; i++) {
+            expect(store.indexes.byName.get({ name: `e${i}` })).toBe(entities[i]);
+        }
+    });
+    it("store.archetypes.<PartitionedName> is a Proxy-free Router that routes inserts", () => {
+        const store = makeStore();
+        const spatial = store.archetypes.Spatial;
+        expect(typeof spatial.insert).toBe("function");
+        expect("columns" in spatial).toBe(false); // a family has no dense view
+        const a = spatial.insert({ cell: 1, name: "a" });
+        const b = spatial.insert({ cell: 2, name: "b" });
+        expect(store.locate(a).archetype).not.toBe(store.locate(b).archetype);
+        expect(store.get(a, "cell")).toBe(1);
+        expect(store.get(b, "cell")).toBe(2);
+    });
+    it("maintains indexes on routed inserts (find across value-children)", () => {
+        const store = makeStore();
+        const spatial = store.archetypes.Spatial;
+        const a = spatial.insert({ cell: 1, name: "alice" });
+        const b = spatial.insert({ cell: 2, name: "bob" });
+        expect(store.indexes.byName.get({ name: "alice" })).toBe(a);
+        expect(store.indexes.byName.get({ name: "bob" })).toBe(b);
+    });
+    it("enforces a unique index across different value-children, atomically", () => {
+        const store = makeStore();
+        const spatial = store.archetypes.Spatial;
+        const first = spatial.insert({ cell: 1, name: "dup" });
+        // Same name, different cell → different archetype, still a unique conflict.
+        expect(() => spatial.insert({ cell: 2, name: "dup" })).toThrow(/[Uu]nique/);
+        // The original row is intact (atomic — no partial mutation).
+        expect(store.indexes.byName.get({ name: "dup" })).toBe(first);
+    });
+    it("queryArchetypes `where` filters value-children at the store layer", () => {
+        const store = makeStore();
+        const spatial = store.archetypes.Spatial;
+        spatial.insert({ cell: 1, name: "a" });
+        spatial.insert({ cell: 2, name: "b" });
+        spatial.insert({ cell: 2, name: "c" });
+        const cell2 = store.queryArchetypes(["cell", "name"], { where: { cell: 2 } });
+        expect(cell2.length).toBe(1);
+        expect(cell2[0].rowCount).toBe(2);
+    });
+    it("store.ensureArchetype routes (no value) and resolves concrete (with value)", () => {
+        const store = makeStore();
+        const router = store.ensureArchetype(["id", "cell", "name"]);
+        expect("columns" in router).toBe(false);
+        router.insert({ cell: 5, name: "x" });
+        const concrete = store.ensureArchetype(["id", "cell", "name"], { cell: 5 });
+        expect(concrete.columns).toBeDefined();
+        expect(concrete.rowCount).toBe(1);
+    });
+    it("index find works when inserting via the concrete-child path too", () => {
+        const store = makeStore();
+        const concrete = store.ensureArchetype(["id", "cell", "name"], { cell: 9 });
+        const e = concrete.insert({ cell: 9, name: "zed" });
+        expect(store.indexes.byName.get({ name: "zed" })).toBe(e);
+    });
+    it("index updates when a partition-value change migrates an entity", () => {
+        const store = makeStore();
+        const spatial = store.archetypes.Spatial;
+        const e = spatial.insert({ cell: 1, name: "mover" });
+        store.update(e, { cell: 2 });
+        // Entity moved value-children; the name index still resolves it.
+        expect(store.get(e, "cell")).toBe(2);
+        expect(store.indexes.byName.get({ name: "mover" })).toBe(e);
+    });
+});
+//# sourceMappingURL=create-store.partition.test.js.map

package/dist/ecs/store/public/create-store.partition.test.js.map

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

package/dist/ecs/store/public/create-store.partition.type-test.d.ts

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

package/dist/ecs/store/public/create-store.partition.type-test.js

@@ -0,0 +1,61 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+//
+// Compile-time (red/green) verification of the partition public surface on
+// `Store` — discrimination of `store.archetypes.<Name>` and `ensureArchetype`,
+// and the partition-keyed `queryArchetypes` where. Bodies live in never-called
+// functions so the file type-checks without executing.
+import { createStore } from "./create-store.js";
+// store.archetypes.<Name> — discriminated per declared name
+function _archetypesMap() {
+    // A partitioned named archetype is a Router — write via insert, no dense view.
+    store.archetypes.Spatial.insert({ cell: 1, position: 2 });
+    // @ts-expect-error - Spatial is a partition family (Router), not a concrete Archetype
+    store.archetypes.Spatial.columns;
+    // @ts-expect-error - a Router has no rowCount
+    store.archetypes.Spatial.rowCount;
+    // A non-partitioned named archetype is a concrete Archetype.
+    store.archetypes.Mob.columns;
+    store.archetypes.Mob.rowCount;
+    store.archetypes.Mob.insert({ position: 1, health: 100 });
+}
+// store.ensureArchetype(keys, values?) — discriminated
+function _ensureArchetype() {
+    // Partition key present, no value → Router (insert only).
+    const router = store.ensureArchetype(["id", "cell", "position"]);
+    router.insert({ cell: 1, position: 2 });
+    // @ts-expect-error - a partition family (Router) has no columns
+    router.columns;
+    // Partition value supplied → concrete Archetype (dense access).
+    const concrete = store.ensureArchetype(["id", "cell", "position"], { cell: 7 });
+    concrete.columns;
+    concrete.rowCount;
+    // No partition component in the set → concrete Archetype.
+    const plain = store.ensureArchetype(["id", "position"]);
+    plain.columns;
+    // @ts-expect-error - partition value must match the component's type (cell is number)
+    store.ensureArchetype(["id", "cell", "position"], { cell: "nope" });
+}
+// queryArchetypes where — keyed to partition components only
+function _queryWhere() {
+    store.queryArchetypes(["cell", "position"], { where: { cell: 7 } });
+    // @ts-expect-error - `position` is not a partition component; not archetype-decidable
+    store.queryArchetypes(["cell", "position"], { where: { position: 1 } });
+    // @ts-expect-error - partition where value must match the component type (cell is number)
+    store.queryArchetypes(["cell"], { where: { cell: "x" } });
+}
+// createStore return threads PK (inference, not just Store.FromSchema)
+function _inferenceCheck() {
+    const s = createStore({
+        components: {
+            cell: { type: "integer", partition: true },
+            position: { type: "number" },
+        },
+        resources: {},
+        archetypes: { Spatial: ["cell", "position"] },
+    });
+    s.archetypes.Spatial.insert({ cell: 1, position: 2 });
+    // @ts-expect-error - inferred Spatial is a Router (partition family), no columns
+    s.archetypes.Spatial.columns;
+    return s;
+}
+//# sourceMappingURL=create-store.partition.type-test.js.map

package/dist/ecs/store/public/create-store.partition.type-test.js.map

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

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

@@ -6,6 +6,7 @@ import { IntersectTuple, Simplify, StringKeyof } from "../../types/types.js";
 import { Components } from "./components.js";
 import { ArchetypeComponents } from "./archetype-components.js";
 import { Archetype, ReadonlyArchetype } from "../archetype/archetype.js";
+import { HasPartitionKey, PartitionKeysOf, ArchetypeOrRouter } from "./partition.js";
 import { EntitySelectOptions } from "./entity-select-options.js";
 import { Undoable } from "../database/undoable.js";
 import { FromSchemas } from "../../schema/from-schemas.js";
@@ -25,14 +26,16 @@ interface BaseStore<C extends object = never> {
      */
     toData(copy?: boolean): unknown;
 }
-export interface ReadonlyStore<C extends Components = never, R extends ResourceComponents = never, A extends ArchetypeComponents<StringKeyof<C>> = never, IX extends IndexDeclarations<C> = {}> extends BaseStore<C>, ReadonlyCore<C> {
+export interface ReadonlyStore<C extends Components = never, R extends ResourceComponents = never, A extends ArchetypeComponents<StringKeyof<C>> = never, IX extends IndexDeclarations<C> = {}, PK extends string = never> extends BaseStore<C>, ReadonlyCore<C, PK> {
     readonly resources: {
         readonly [K in StringKeyof<R>]: R[K];
     };
     readonly archetypes: {
-        readonly [K in StringKeyof<A>]: ReadonlyArchetype<RequiredComponents & {
-            [P in A[K][number]]: (C & RequiredComponents & OptionalComponents)[P];
-        }>;
+        readonly [K in StringKeyof<A>]: ArchetypeOrRouter<HasPartitionKey<A[K][number], PK>, RequiredComponents & {
+            [Col in A[K][number]]: (C & RequiredComponents & OptionalComponents)[Col];
+        }, ReadonlyArchetype<RequiredComponents & {
+            [Col in A[K][number]]: (C & RequiredComponents & OptionalComponents)[Col];
+        }>>;
     };
     readonly indexes: {
         readonly [K in keyof IX]: Index.Handle<C, IX[K]>;
@@ -42,7 +45,7 @@ export type ToReadonlyStore<T extends Store> = T extends Store<infer C, infer R>
 /**
  * Store is the main interface for storing components, entities and resources.
  */
-export interface Store<C extends Components = {}, R extends ResourceComponents = {}, A extends ArchetypeComponents<StringKeyof<C>> = {}, IX extends IndexDeclarations<C> = {}> extends BaseStore<C>, Core<C> {
+export interface Store<C extends Components = {}, R extends ResourceComponents = {}, A extends ArchetypeComponents<StringKeyof<C>> = {}, IX extends IndexDeclarations<C> = {}, PK extends string = never> extends BaseStore<C>, Core<C, PK> {
     /**
      * This is used when a store is used to represent a transaction.
      * For most stores, this is ignored if it is set.
@@ -52,9 +55,11 @@ export interface Store<C extends Components = {}, R extends ResourceComponents =
         -readonly [K in StringKeyof<R>]: R[K];
     };
     readonly archetypes: {
-        -readonly [K in StringKeyof<A>]: Archetype<RequiredComponents & {
-            [P in A[K][number]]: (C & RequiredComponents & OptionalComponents)[P];
-        }>;
+        -readonly [K in StringKeyof<A>]: ArchetypeOrRouter<HasPartitionKey<A[K][number], PK>, RequiredComponents & {
+            [Col in A[K][number]]: (C & RequiredComponents & OptionalComponents)[Col];
+        }, Archetype<RequiredComponents & {
+            [Col in A[K][number]]: (C & RequiredComponents & OptionalComponents)[Col];
+        }>>;
     };
     /**
      * Index handles keyed by user-chosen name. Returned handles are the
@@ -68,7 +73,7 @@ export interface Store<C extends Components = {}, R extends ResourceComponents =
     /** Wipe all entities and reset resources to plugin defaults. O(num_archetypes + num_resources). */
     reset(): void;
     fromData(data: unknown): void;
-    extend<S extends Store.Schema>(schema: S): S extends Store.Schema<infer XC, infer XR, infer XA, infer XIX> ? Store<C & XC, R & XR, A & XA, IX & XIX> : never;
+    extend<S extends Store.Schema>(schema: S): S extends Store.Schema<infer XC, infer XR, infer XA, infer XIX> ? Store<C & FromSchemas<XC>, R & FromSchemas<XR>, A & XA, IX & XIX, PK | PartitionKeysOf<XC>> : never;
 }
 export declare namespace Store {
     type Components<S extends Store> = S extends Store<infer C, infer R, infer A> ? C : never;
@@ -82,7 +87,7 @@ export declare namespace Store {
         readonly archetypes: A;
         readonly indexes?: IX;
     };
-    type FromSchema<T> = T extends Store.Schema<infer CS, infer RS, infer A, infer IX> ? Store<FromSchemas<CS>, FromSchemas<RS>, A, IX> : never;
+    type FromSchema<T> = T extends Store.Schema<infer CS, infer RS, infer A, infer IX> ? Store<FromSchemas<CS>, FromSchemas<RS>, A, IX, PartitionKeysOf<CS>> : never;
     namespace Schema {
         type Intersect<T extends readonly Schema<any, any, any, any>[]> = Store.Schema<{} & IntersectTuple<{
             [K in keyof T]: T[K] extends Schema<infer C, any, any, any> ? C : never;

package/dist/ecs/store/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/ecs/store/store.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAgEvD,2DAA2D;AAC3D,MAAM,KAAW,KAAK,CAsHrB;AAtHD,WAAiB,KAAK;IAuBlB,IAAiB,MAAM,CA4FtB;IA5FD,WAAiB,MAAM;QAsCnB;;;;;;;;;;;;;;;;;;;;;;;;;WAyBG;QACH,SAAgB,MAAM,CAOlB,MAKE,EACF,YAAgB;YAEhB,MAAM,EAAE,UAAU,GAAG,EAAE,EAAE,SAAS,GAAG,EAAE,EAAE,UAAU,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;YAClF,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;gBAC7C,OAAO;oBACH,UAAU,EAAE,EAAE,GAAG,GAAG,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE;oBACrD,SAAS,EAAE,EAAE,GAAG,GAAG,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE;oBAClD,UAAU,EAAE,EAAE,GAAG,GAAG,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE;oBACrD,OAAO,EAAE,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE;iBAC/C,CAAA;YACL,CAAC,EACG,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAS,CACxD,CAAC;QACN,CAAC;QA1Be,aAAM,SA0BrB,CAAA;IAEL,CAAC,EA5FgB,MAAM,GAAN,YAAM,KAAN,YAAM,QA4FtB;IAEY,YAAM,GAAG,WAAW,CAAC;AACtC,CAAC,EAtHgB,KAAK,KAAL,KAAK,QAsHrB;AAiCD,wEAAwE;AACxE,2EAA2E;AAC3E,MAAM,cAAc,GAAG;IACnB,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IAC3E,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE;CAC3E,CAAC"}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/ecs/store/store.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AA0EvD,2DAA2D;AAC3D,MAAM,KAAW,KAAK,CAsHrB;AAtHD,WAAiB,KAAK;IAuBlB,IAAiB,MAAM,CA4FtB;IA5FD,WAAiB,MAAM;QAsCnB;;;;;;;;;;;;;;;;;;;;;;;;;WAyBG;QACH,SAAgB,MAAM,CAOlB,MAKE,EACF,YAAgB;YAEhB,MAAM,EAAE,UAAU,GAAG,EAAE,EAAE,SAAS,GAAG,EAAE,EAAE,UAAU,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;YAClF,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;gBAC7C,OAAO;oBACH,UAAU,EAAE,EAAE,GAAG,GAAG,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE;oBACrD,SAAS,EAAE,EAAE,GAAG,GAAG,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE;oBAClD,UAAU,EAAE,EAAE,GAAG,GAAG,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE;oBACrD,OAAO,EAAE,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE;iBAC/C,CAAA;YACL,CAAC,EACG,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAS,CACxD,CAAC;QACN,CAAC;QA1Be,aAAM,SA0BrB,CAAA;IAEL,CAAC,EA5FgB,MAAM,GAAN,YAAM,KAAN,YAAM,QA4FtB;IAEY,YAAM,GAAG,WAAW,CAAC;AACtC,CAAC,EAtHgB,KAAK,KAAL,KAAK,QAsHrB;AAiCD,wEAAwE;AACxE,2EAA2E;AAC3E,MAAM,cAAc,GAAG;IACnB,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IAC3E,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE;CAC3E,CAAC"}

package/dist/ecs/store/transaction-functions.d.ts

@@ -5,10 +5,10 @@ import { ArchetypeComponents } from "./archetype-components.js";
 import { StringKeyof } from "../../types/types.js";
 import { IndexDeclarations } from "./index-types.js";
 import type { TransactionContext } from "../database/transactional-store/transactional-store.js";
-export type TransactionDeclaration<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>, IX extends IndexDeclarations<C> = {}, Input extends any | void = any> = (t: TransactionContext<C, R, A, IX>, input: Input) => void | Entity;
+export type TransactionDeclaration<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>, IX extends IndexDeclarations<C> = {}, PK extends string = never, Input extends any | void = any> = (t: TransactionContext<C, R, A, IX, PK>, input: Input) => void | Entity;
 export type AsyncArgsProvider<T> = () => Promise<T> | AsyncGenerator<T>;
-export type TransactionDeclarations<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>, IX extends IndexDeclarations<C> = {}> = {
-    readonly [Q: string]: TransactionDeclaration<C, R, A, IX>;
+export type TransactionDeclarations<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>, IX extends IndexDeclarations<C> = {}, PK extends string = never> = {
+    readonly [Q: string]: TransactionDeclaration<C, R, A, IX, PK>;
 };
 /**
  * Converts from TransactionDeclarations to TransactionFunctions by removing

package/dist/schema/schema.d.ts

@@ -28,6 +28,7 @@ export interface Schema {
     description?: string;
     conditionals?: readonly Conditional[];
     nonPersistent?: boolean;
+    partition?: boolean;
     mutable?: boolean;
     default?: any;
     precision?: 1 | 2;