@adobe/data 0.9.82 → 0.9.84

package/dist/ecs/database/facets/archetypes.d.ts

@@ -0,0 +1,17 @@
+import type { ComponentSchemas } from "../../component-schemas.js";
+/**
+ * Declare a feature's archetypes, validating every key against `components` and
+ * preserving each archetype's literal key tuple (via a `const` type parameter),
+ * so no per-archetype `as const satisfies` is needed. `components` is passed as
+ * a value (it is imported anyway) because TypeScript can't infer the tuple type
+ * while a component-type argument is also supplied explicitly.
+ *
+ * ```ts
+ * export const archetypes = Database.archetypes(components, {
+ *     Todo: ["todo", "name", "complete", "order", "dragPosition", "assignees"],
+ * });
+ * ```
+ */
+export declare function archetypes<C extends ComponentSchemas, const A extends {
+    readonly [name: string]: readonly (keyof C & string)[];
+}>(_components: C, map: A): A;

package/dist/ecs/database/facets/archetypes.js

@@ -0,0 +1,18 @@
+/**
+ * Declare a feature's archetypes, validating every key against `components` and
+ * preserving each archetype's literal key tuple (via a `const` type parameter),
+ * so no per-archetype `as const satisfies` is needed. `components` is passed as
+ * a value (it is imported anyway) because TypeScript can't infer the tuple type
+ * while a component-type argument is also supplied explicitly.
+ *
+ * ```ts
+ * export const archetypes = Database.archetypes(components, {
+ *     Todo: ["todo", "name", "complete", "order", "dragPosition", "assignees"],
+ * });
+ * ```
+ */
+export function archetypes(_components, map) {
+    // `_components` carries the component type C for key validation; unused at runtime.
+    return map;
+}
+//# sourceMappingURL=archetypes.js.map

package/dist/ecs/database/facets/archetypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archetypes.js","sourceRoot":"","sources":["../../../../src/ecs/database/facets/archetypes.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAGxB,WAAc,EAAE,GAAM;IACpB,oFAAoF;IACpF,OAAO,GAAG,CAAC;AACf,CAAC"}

package/dist/ecs/database/facets/components.d.ts

@@ -0,0 +1,17 @@
+import type { ComponentSchemas } from "../../component-schemas.js";
+import type { Simplify } from "../../../types/index.js";
+import { type ScopeGroups } from "./stamp-scopes.js";
+/**
+ * Build a feature's component facet map from its schema scopes, stamping each
+ * scope's flags (see {@link ScopeGroups}). Declare only the scopes you use —
+ * a document-only feature is just `{ document: { … } }`. Component entries are
+ * any `Schema`; no `default` required (unlike `Database.resources`).
+ *
+ * ```ts
+ * export const components = Database.components({
+ *   document: { mark: PlayerMark.schema },
+ *   session: { dragPosition: DragPosition.schema },
+ * });
+ * ```
+ */
+export declare function components<D extends ComponentSchemas = {}, S extends ComponentSchemas = {}, P extends ComponentSchemas = {}, Se extends ComponentSchemas = {}>(groups: ScopeGroups<D, S, P, Se>): Simplify<D & S & P & Se>;

package/dist/ecs/database/facets/components.js

@@ -0,0 +1,18 @@
+import { stampScopes } from "./stamp-scopes.js";
+/**
+ * Build a feature's component facet map from its schema scopes, stamping each
+ * scope's flags (see {@link ScopeGroups}). Declare only the scopes you use —
+ * a document-only feature is just `{ document: { … } }`. Component entries are
+ * any `Schema`; no `default` required (unlike `Database.resources`).
+ *
+ * ```ts
+ * export const components = Database.components({
+ *   document: { mark: PlayerMark.schema },
+ *   session: { dragPosition: DragPosition.schema },
+ * });
+ * ```
+ */
+export function components(groups) {
+    return stampScopes(groups);
+}
+//# sourceMappingURL=components.js.map

package/dist/ecs/database/facets/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../../../../src/ecs/database/facets/components.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAoB,MAAM,mBAAmB,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAGxB,MAAgC;IAC9B,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/ecs/database/facets/facets.test.d.ts

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

package/dist/ecs/database/facets/facets.test.js

@@ -0,0 +1,54 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it, expect } from "vitest";
+import { Database } from "../database.js";
+describe("Database.components / resources / archetypes", () => {
+    const s = { type: "number" };
+    // Typed with a `default` in its type (not just `Schema`) so it qualifies as
+    // a ResourceSchema — resources typed as bare `Schema` are rejected by design.
+    const r = { type: "boolean", default: false };
+    it("components stamps each scope's flags and merges the groups", () => {
+        const c = Database.components({
+            document: { a: s },
+            settings: { b: s },
+            presence: { c: s },
+            session: { d: s },
+        });
+        expect(Object.keys(c)).toEqual(["a", "b", "c", "d"]);
+        expect(c.a).toMatchObject({ type: "number" }); // document: no flags
+        expect(c.b).toMatchObject({ nonShared: true });
+        expect(c.b.nonPersistent).toBeUndefined();
+        expect(c.c).toMatchObject({ nonPersistent: true });
+        expect(c.c.nonShared).toBeUndefined();
+        expect(c.d).toMatchObject({ nonPersistent: true, nonShared: true });
+    });
+    it("omitted scopes default to empty — a document-only feature needs just one key", () => {
+        const c = Database.components({ document: { a: s } });
+        expect(Object.keys(c)).toEqual(["a"]);
+        expect(c.a).toMatchObject({ type: "number" });
+        expect(c.a).not.toHaveProperty("nonShared");
+    });
+    it("does not mutate the input schemas", () => {
+        const doc = { a: s };
+        Database.components({ document: doc, settings: {}, presence: {}, session: {} });
+        expect(doc.a).toBe(s);
+        expect(s).not.toHaveProperty("nonShared");
+    });
+    it("resources requires a default (and applies scope flags)", () => {
+        const res = Database.resources({
+            document: {},
+            settings: { flag: r },
+            presence: {},
+            session: {},
+        });
+        expect(res.flag).toMatchObject({ default: false, nonShared: true });
+    });
+    it("archetypes validates keys against components and preserves tuples", () => {
+        const components = Database.components({
+            document: { mark: s, index: s },
+            settings: {}, presence: {}, session: {},
+        });
+        const a = Database.archetypes(components, { PlacedMark: ["mark", "index"] });
+        expect(a.PlacedMark).toEqual(["mark", "index"]);
+    });
+});
+//# sourceMappingURL=facets.test.js.map

package/dist/ecs/database/facets/facets.test.js.map

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

package/dist/ecs/database/facets/resources.d.ts

@@ -0,0 +1,17 @@
+import type { ResourceSchemas } from "../../resource-schemas.js";
+import type { Simplify } from "../../../types/index.js";
+import { type ScopeGroups } from "./stamp-scopes.js";
+/**
+ * Build a feature's resource facet map from its schema scopes, stamping each
+ * scope's flags (see {@link ScopeGroups}). Declare only the scopes you use.
+ * Identical to `Database.components` except every entry must be a
+ * `ResourceSchema` (a `Schema` with a `default`) — a missing `default` is a
+ * compile error here, at the declaration site.
+ *
+ * ```ts
+ * export const resources = Database.resources({
+ *   settings: { displayCompleted: Boolean.schema },
+ * });
+ * ```
+ */
+export declare function resources<D extends ResourceSchemas = {}, S extends ResourceSchemas = {}, P extends ResourceSchemas = {}, Se extends ResourceSchemas = {}>(groups: ScopeGroups<D, S, P, Se>): Simplify<D & S & P & Se>;

package/dist/ecs/database/facets/resources.js

@@ -0,0 +1,18 @@
+import { stampScopes } from "./stamp-scopes.js";
+/**
+ * Build a feature's resource facet map from its schema scopes, stamping each
+ * scope's flags (see {@link ScopeGroups}). Declare only the scopes you use.
+ * Identical to `Database.components` except every entry must be a
+ * `ResourceSchema` (a `Schema` with a `default`) — a missing `default` is a
+ * compile error here, at the declaration site.
+ *
+ * ```ts
+ * export const resources = Database.resources({
+ *   settings: { displayCompleted: Boolean.schema },
+ * });
+ * ```
+ */
+export function resources(groups) {
+    return stampScopes(groups);
+}
+//# sourceMappingURL=resources.js.map

package/dist/ecs/database/facets/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../../../src/ecs/database/facets/resources.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAoB,MAAM,mBAAmB,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS,CAGvB,MAAgC;IAC9B,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/ecs/database/facets/stamp-scopes.d.ts

@@ -0,0 +1,46 @@
+import type { Schema } from "../../../schema/index.js";
+import type { Simplify } from "../../../types/index.js";
+type SchemaMap = {
+    readonly [key: string]: Schema;
+};
+/**
+ * The four schema scopes, grouped for a facet builder ({@link stampScopes},
+ * `Database.components`, `Database.resources`). Every scope is optional and
+ * defaults to empty — declare only the scopes a feature actually uses.
+ *
+ * State divides on two orthogonal axes — **scope** (shared with peers vs. local
+ * to this client) and **lifetime** (durable across reloads vs. ephemeral) — and
+ * each group stamps the flag pair for its quadrant.
+ */
+export type ScopeGroups<D, S, P, Se> = {
+    /**
+     * **document** — shared + durable. The collaborative, serialized data model:
+     * replicated to every peer and saved to storage. The default home for
+     * feature state; carries no scope flags.
+     */
+    document?: D;
+    /**
+     * **settings** — local + durable. Per-device state that persists across
+     * reloads but is never sent to peers (e.g. a view toggle, theme, panel
+     * layout). Stamped `nonShared: true`.
+     */
+    settings?: S;
+    /**
+     * **presence** — shared + ephemeral. Live awareness replicated to peers but
+     * never saved (e.g. cursors, selections, "typing…"). Dies with the session.
+     * Stamped `nonPersistent: true`.
+     */
+    presence?: P;
+    /**
+     * **session** — local + ephemeral. Transient UI state that is neither saved
+     * nor shared (e.g. a drag offset, hover target, focus). Stamped both
+     * `nonPersistent: true` and `nonShared: true`.
+     */
+    session?: Se;
+};
+/**
+ * Merge the provided schema scopes into one flag-tagged map. Omitted scopes are
+ * empty. Shared by `Database.components` and `Database.resources`.
+ */
+export declare function stampScopes<D extends SchemaMap, S extends SchemaMap, P extends SchemaMap, Se extends SchemaMap>(groups: ScopeGroups<D, S, P, Se>): Simplify<D & S & P & Se>;
+export {};

package/dist/ecs/database/facets/stamp-scopes.js

@@ -0,0 +1,26 @@
+// Copy a map with `flags` merged onto every schema, preserving the map type.
+const stamp = (map, flags) => {
+    const out = {};
+    for (const [name, schema] of Object.entries(map)) {
+        out[name] = { ...schema, ...flags };
+    }
+    // Invariant: `out` has exactly `map`'s keys and Schema values — same shape as M.
+    return out;
+};
+/**
+ * Merge the provided schema scopes into one flag-tagged map. Omitted scopes are
+ * empty. Shared by `Database.components` and `Database.resources`.
+ */
+export function stampScopes(groups) {
+    const merged = {
+        // document has no flags — pass schemas through by identity so a column
+        // shared across features (same data/ schema) still dedupes in combinePlugins.
+        ...(groups.document ?? {}),
+        ...stamp(groups.settings ?? {}, { nonShared: true }),
+        ...stamp(groups.presence ?? {}, { nonPersistent: true }),
+        ...stamp(groups.session ?? {}, { nonPersistent: true, nonShared: true }),
+    };
+    // Invariant: `merged` has exactly the keys of the provided groups.
+    return merged;
+}
+//# sourceMappingURL=stamp-scopes.js.map

package/dist/ecs/database/facets/stamp-scopes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp-scopes.js","sourceRoot":"","sources":["../../../../src/ecs/database/facets/stamp-scopes.ts"],"names":[],"mappings":"AA0CA,6EAA6E;AAC7E,MAAM,KAAK,GAAG,CAAsB,GAAM,EAAE,KAAsB,EAAK,EAAE;IACrE,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACxC,CAAC;IACD,iFAAiF;IACjF,OAAO,GAAQ,CAAC;AACpB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,WAAW,CAEzB,MAAgC;IAC9B,MAAM,MAAM,GAAG;QACX,uEAAuE;QACvE,8EAA8E;QAC9E,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC1B,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACpD,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QACxD,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;KAC3E,CAAC;IACF,mEAAmE;IACnE,OAAO,MAAkC,CAAC;AAC9C,CAAC"}

package/dist/ecs/database/index.d.ts

@@ -7,7 +7,6 @@ export * from "./reconciling/reconciling-entry.js";
 export * from "./observed/create-observed-database.js";
 export * from "./observed/observed-database.js";
 export * from "./database.js";
-export * from "./observe-dependent-value.js";
 export * from "./transactional-store/index.js";
 export * from "./database-schema/index.js";
 export type { Undoable } from "./undoable.js";

package/dist/ecs/database/index.js

@@ -8,7 +8,6 @@ export * from "./reconciling/reconciling-entry.js";
 export * from "./observed/create-observed-database.js";
 export * from "./observed/observed-database.js";
 export * from "./database.js";
-export * from "./observe-dependent-value.js";
 export * from "./transactional-store/index.js";
 export * from "./database-schema/index.js";
 export * from "./combine-plugins.js";

package/dist/ecs/database/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ecs/database/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,8CAA8C,CAAC;AAC7D,cAAc,uCAAuC,CAAC;AACtD,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,eAAe,CAAC;AAC9B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAE3C,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ecs/database/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,8CAA8C,CAAC;AAC7D,cAAc,uCAAuC,CAAC;AACtD,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,eAAe,CAAC;AAC9B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAE3C,cAAc,sBAAsB,CAAC"}

package/dist/ecs/database/observe-select-entities.performance.test.js

@@ -3,6 +3,13 @@ import { describe, expect, it, beforeEach } from "vitest";
 import { Database } from "./database.js";
 import { F32 } from "../../math/f32/index.js";
 import { Boolean } from "../../schema/index.js";
+// Non-fatal perf indicator: warns on a super-linear ratio but never throws —
+// wall-clock ratios are too noisy across machines to gate the suite on.
+function warnIfExceeds(actual, limit, label) {
+    if (actual >= limit) {
+        console.warn(`[perf] ${label}: ratio ${actual.toFixed(2)} ≥ ${limit.toFixed(2)} — possible regression`);
+    }
+}
 describe("observeSelectEntities Performance Tests", () => {
     let database;
     function createTestDatabase() {
@@ -119,10 +126,11 @@ describe("observeSelectEntities Performance Tests", () => {
                 console.log("One or more update times measured as 0ms; skipping ratio checks due to timer precision limits.");
                 return;
             }
-            expect(timeRatio1).toBeLessThan(sizeRatio1 * 0.1);
-            expect(timeRatio2).toBeLessThan(sizeRatio2 * 0.1);
-            const totalTimeRatio = updateTimes[2] / updateTimes[0];
-            expect(totalTimeRatio).toBeLessThan(5);
+            // Indicators only — wall-clock ratios flake across machines, so a
+            // super-linear result warns but never fails the suite.
+            warnIfExceeds(timeRatio1, sizeRatio1 * 0.1, "update time vs 100x dataset");
+            warnIfExceeds(timeRatio2, sizeRatio2 * 0.1, "update time vs 10x dataset");
+            warnIfExceeds(updateTimes[2] / updateTimes[0], 5, "update time 10→10000 entities");
         });
         it("should not notify observer when update does not affect result set", async () => {
             const { testEntity } = createTestData(1000);

package/dist/ecs/database/observe-select-entities.performance.test.js.map

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

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

@@ -3,9 +3,9 @@ import { Components } from "../../store/components.js";
 import { ResourceComponents } from "../../store/resource-components.js";
 import { ArchetypeComponents } from "../../store/archetype-components.js";
 import { StringKeyof } from "../../../types/types.js";
-import { ReadonlyStore } from "../../store/index.js";
+import { ReadonlyStore, Store } from "../../store/index.js";
 import { Observe } from "../../../observe/index.js";
-import { TransactionContext, TransactionResult } from "../transactional-store/index.js";
+import { TransactionResult } from "../transactional-store/index.js";
 import { RequiredComponents } from "../../required-components.js";
 import { Entity } from "../../entity/entity.js";
 import { EntityReadValues } from "../../store/core/index.js";
@@ -32,7 +32,7 @@ export interface ObservedDatabase<C extends Components, R extends ResourceCompon
     derive<I extends Record<string, Observe<unknown>>, T>(inputs: I, compute: (db: any, inputs: {
         readonly [K in keyof I]: I[K] extends Observe<infer U> ? U : never;
     }) => T): Observe<T>;
-    readonly execute: (handler: (ctx: TransactionContext<C, R, A>) => Entity | void, options?: {
+    readonly execute: (handler: (ctx: Store<C, R, A>) => Entity | void, options?: {
         transient?: boolean;
         userId?: number | string;
     }) => TransactionResult<C>;

package/dist/ecs/database/reconciling/create-rebase-replay-applier.js

@@ -20,7 +20,7 @@ import { ReconcilingEntryOps } from "./reconciling-entry.js";
 export function createRebaseReplayApplier(...args) {
     const [execute, getTransaction] = args;
     // The applier is a type-erased layer: `getTransaction` hands back
-    // transactions typed over `TransactionContext<any, any, any>`, so the
+    // transactions typed over `Store<any, any, any>`, so the
     // entries it stores are erased too. Pinning the generics to `any` keeps the
     // stored `transaction` assignable from `getTransaction`'s result without a
     // per-assignment cast.

package/dist/ecs/database/reconciling/create-rebase-replay-applier.js.map

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

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

@@ -2,7 +2,8 @@ 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 { TransactionContext, TransactionResult } from "../transactional-store/index.js";
+import { Store } from "../../store/index.js";
+import { TransactionResult } from "../transactional-store/index.js";
 import { Entity } from "../../entity/entity.js";
 export type ReconcilingEntry<C extends Components = Components, R extends ResourceComponents = ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>> = ArchetypeComponents<StringKeyof<C>>> = {
     readonly id: number;
@@ -14,7 +15,7 @@ export type ReconcilingEntry<C extends Components = Components, R extends Resour
      */
     readonly userId?: number | string;
     readonly name: string;
-    readonly transaction: (ctx: TransactionContext<C, R, A>, args: unknown) => void | Entity;
+    readonly transaction: (ctx: Store<C, R, A>, args: unknown) => void | Entity;
     readonly args: unknown;
     readonly time: number;
     result?: TransactionResult<C>;

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

@@ -1 +1 @@
-{"version":3,"file":"reconciling-entry.js","sourceRoot":"","sources":["../../../../src/ecs/database/reconciling/reconciling-entry.ts"],"names":[],"mappings":"AAAA,uDAAuD;AA6BvD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAE/B,OAAO,CAIL,CAA4B,EAAE,CAA4B;QACxD,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,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;QAC3B,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YACf,OAAO,MAAM,CAAC;QAClB,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;IACb,CAAC;IACD,eAAe,CAIb,OAAoC,EAAE,KAAgC;QACpE,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,mBAAmB,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvD,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"}
+{"version":3,"file":"reconciling-entry.js","sourceRoot":"","sources":["../../../../src/ecs/database/reconciling/reconciling-entry.ts"],"names":[],"mappings":"AAAA,uDAAuD;AA8BvD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAE/B,OAAO,CAIL,CAA4B,EAAE,CAA4B;QACxD,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,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;QAC3B,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YACf,OAAO,MAAM,CAAC;QAClB,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;IACb,CAAC;IACD,eAAe,CAIb,OAAoC,EAAE,KAAgC;QACpE,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,mBAAmB,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvD,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"}

package/dist/ecs/database/to-system-database.d.ts

@@ -0,0 +1,17 @@
+import type { Database } from "./database.js";
+/**
+ * Re-view a created database as its **system surface** — the same
+ * `Database & { store }` type a `SystemDeclaration.create` receives — exposing
+ * the writable `store` (and writable `services`).
+ *
+ * Identity at runtime: `createDatabase` always attaches the store, so this only
+ * reveals it to the type system. It is the widening twin of `UIService.restrict`
+ * (which narrows a full database to the read-only UI view). Direct `store`
+ * access does NOT flow through observable transactions — intended for systems,
+ * and for test-support (a conformance projection seeding the store directly).
+ *
+ * Cast-free by the same overload + broadened-impl shape `restrict` uses: the
+ * public overload returns the widened `ToSystemDatabase<P>`, which is assignable
+ * to the impl's plain `Database` return, so the identity body type-checks.
+ */
+export declare function toSystemDatabase<P extends Database.Plugin>(db: Database.FromPlugin<P>): Database.Plugin.ToSystemDatabase<P>;

package/dist/ecs/database/to-system-database.js

@@ -0,0 +1,5 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export function toSystemDatabase(db) {
+    return db;
+}
+//# sourceMappingURL=to-system-database.js.map

package/dist/ecs/database/to-system-database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-system-database.js","sourceRoot":"","sources":["../../../src/ecs/database/to-system-database.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAsBvD,MAAM,UAAU,gBAAgB,CAC9B,EAAoD;IAEpD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/ecs/database/to-system-database.test.d.ts

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

package/dist/ecs/database/to-system-database.test.js

@@ -0,0 +1,22 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it, expect } from "vitest";
+import { Database } from "./database.js";
+describe("Database.toSystemDatabase", () => {
+    const plugin = Database.Plugin.create({
+        components: { value: { type: "number" }, tag: { type: "boolean" } },
+        resources: { count: { default: 0 } },
+        archetypes: { Thing: ["value", "tag"] },
+    });
+    it("is identity at runtime and exposes the writable store", () => {
+        const db = Database.create(plugin);
+        const sys = Database.toSystemDatabase(db);
+        // Same instance — purely a type-level re-view.
+        expect(sys).toBe(db);
+        // The store surface is now reachable and writable.
+        sys.store.resources.count = 5;
+        expect(sys.store.resources.count).toBe(5);
+        const entity = sys.store.archetypes.Thing.insert({ value: 1, tag: true });
+        expect(sys.store.read(entity, sys.store.archetypes.Thing)?.value).toBe(1);
+    });
+});
+//# sourceMappingURL=to-system-database.test.js.map

package/dist/ecs/database/to-system-database.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-system-database.test.js","sourceRoot":"","sources":["../../../src/ecs/database/to-system-database.test.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;QACpC,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;QACnE,SAAS,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,CAAW,EAAE,EAAE;QAC9C,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE;KACxC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,GAAG,GAAG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QAE1C,+CAA+C;QAC/C,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAErB,mDAAmD;QACnD,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1E,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/ecs/database/transactional-store/coalesce-actions.test.js

@@ -1,6 +1,13 @@
 // © 2026 Adobe. MIT License. See /LICENSE for details.
 import { describe, it, expect } from "vitest";
 import { shouldCoalesceTransactions, coalesceTransactions, coalesceWriteOperations } from "./coalesce-actions.js";
+// Non-fatal perf indicator: warns past budget but never throws — wall-clock
+// timing flakes across machines and must not gate the suite.
+const warnIfExceeds = (actual, limit, label) => {
+    if (actual >= limit) {
+        console.warn(`[perf] ${label}: ${actual.toFixed(2)} ≥ ${limit} — possible regression`);
+    }
+};
 describe("shouldCoalesceTransactions", () => {
     it("should return true for actions with same coalesce values", () => {
         const previous = {
@@ -449,11 +456,13 @@ describe("coalesceWriteOperations performance", () => {
             entity: i,
         }));
         const start = performance.now();
-        coalesceWriteOperations(ops);
+        const result = coalesceWriteOperations(ops);
         const elapsed = performance.now() - start;
-        // 100ms budget: well above the linear path (~20ms) but well below the
-        // quadratic path (~450ms), making the regression unambiguous.
-        expect(elapsed).toBeLessThan(100);
+        // Correctness (the real gate): N distinct-entity deletes coalesce to N ops.
+        expect(result).toHaveLength(N);
+        // Timing is an indicator only — linear path ~20ms, quadratic ~450ms; warn
+        // past 100ms but never fail (wall-clock flakes across machines/CI).
+        warnIfExceeds(elapsed, 100, "coalesce N deletes (ms)");
     });
     it("should strip preceding updates for deleted entities", () => {
         const ops = [