@adobe/data 0.9.17 → 0.9.19

package/dist/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Adobe, Inc.
+
+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.

package/dist/README.md

@@ -0,0 +1,296 @@
+# @adobe/data
+Adobe Data Oriented Programming Library
+
+## Documentation
+
+[Main Page](https://git.corp.adobe.com/pages/neuralfiltersplatform/firefly-data/docs/api/)
+
+[ECS Performance Test](https://git.corp.adobe.com/pages/neuralfiltersplatform/firefly-data/docs/perftest.html)
+
+## Breaking API Changes
+
+Until we reach 1.0.0, minor version changes may be API breaking.
+
+## Data Oriented Programming
+
+This library is built using a data oriented and functional programming paradigm.
+We prefer composition over inheritance, avoid classes when possible and emphasize separation of concerns.
+
+## Data
+
+This library uses data oriented design paradigm and prefers pure functional interfaces whenever practical.
+
+For our purposes, `Data` is immutable `JSON` (de)serializable objects and primitives.
+
+### Why immutable Data?
+
+We prefer Data because it is easy to:
+- serialize
+- deserialize
+- inspect
+- compare
+- hash
+- validate
+
+We prefer immutable Data because it is easy to:
+- reason about
+- avoid side effects
+- avoid defensive copying
+- use for pure function arguments and return values
+- use with concurrency
+- memoize results
+    - use as cache key (stringified)
+    - use as cache value
+
+### What is Data Oriented Design?
+
+Sanders Mertens covers this thoroughly in his ECS FAQ:
+
+[https://github.com/SanderMertens/ecs-faq?tab=readme-ov-file#what-is-data-oriented-design](https://github.com/SanderMertens/ecs-faq?tab=readme-ov-file#what-is-data-oriented-design)
+
+### Data Schemas
+
+When runtime type information is required we use `JSON Schema`. In order to avoid redundancy, we can use `FromSchema` to derive a typescript type at compile time.
+
+Example:
+
+```typescript
+const Float32Schema = { type: "number", precision: 1 } as const satisfies Schema;
+const Float32 = FromSchema<typeof Float32Schema>; // number
+```
+
+It is important that we use `as const` for the schema definition. Without that, the typeof Float32Schema would be `{ type: string, precision: number }` instead of `{ type: "number", precision: 1 }` and we would not be able to derive a correct type using `FromSchema`.
+
+### Normalized Data
+
+Data is considered "Normalized" when all object keys contained anywhere within it are lexigraphically sorted. We include a `normalize` function which performs this conversion. This is particularly useful when you want to use data as a cache key.
+
+```typescript
+const notNormalized = { b: 2, a: 1 };
+const normalized = normalize(notNormalized); // { a: 1, b: 2 }
+```
+
+## Observables
+
+An `Observable<T>` is a subscription function that you can pass a callback function to. Your callback function can accept a single argument of type `T`. The subscription function returns a dispose function that accepts no parameters and can be called at any point in the future to cancel your subscription.
+
+Your callback function *may* be called back synchronously (before the initial call returns) zero or one times and asynchronously later any number of times.
+
+For more information see the [Observable API documentation](./docs/api/modules/observe.html)
+
+### Observable Types
+
+```typescript
+/**
+ * Called to add a new observer to an Observable.
+ * Returns an Unobserve function that can be called to stop observing the Observable.
+ */
+export type Observable<T> = (observer: Callback<T>) => Unobserve;
+/**
+ * Callback function called zero or more times with a sequence of values.
+ * *may* be called back synchronously, immediately when selector function is called.
+ * *may* also be called back asynchronously later any number of times.
+ * *may* be called multiple sequential times with the same value.
+ */
+export type Callback<T> = (value: T) => void;
+/**
+ * Function called to stop observing an Observable.
+ */
+export type Unobserve = () => void;
+```
+
+An Observable can be thought of sort of like a Promise but with a few important differences.
+- A Promise only yields a single value, an Observable yields a sequence of values.
+- A Promise can reject with an error, an Observable can not. (It could yield type `MyResult | MyError` though.)
+- A Promise can only resolve asynchronously, an Observable *may* yield an initial result synchronously.
+    - An Observable is allowed to call the Callback callback function immediately upon observation if it has a value.
+- A Promise begins executing immediately, an Observable may lazily wait for a first observer before taking any action.
+- An Observable can be unobserved.
+
+### Observable Creation
+
+This simple definition of an Observable makes it very easy to create them from various sources.
+
+- `fromConstant<T>(value: T) => Observable<T>`
+- `fromPromise<T>(promise: Promise<T>): Observable<T>`
+- `fromPromiseWithError<T, E extends Error>(promise: Promise<T>): Observable<T | E>`
+- `fromObservableProperties` converts an object with named Observable values into a single Observable of an object with corresponding types.
+
+For instance:
+
+```typescript
+fromObservables({ a: fromConstant(1), b: fromConstant("s")})
+// yields type Observable<{ a: number, b: string }>
+```
+
+`fromObservableProperties` will only yield a result once every contained observable has provided a result. If some properties are optional then use the `withOptional` higher order function described below.
+
+### Observable Modification
+
+They are also very easy to modify in order to build higher order Observables.
+
+For the purposes of discussion let us use an array to indicate the sequential values yielded by an Observable with the first element being any synchronous callback and `void` meaning no synchronous callback.
+
+So our `fromConstant(12)` would yield `[12]` and `fromPromise(Promise.resolve(12))` would yield `[void, 12]`
+
+These examples will use the form of: Sequence Before => Higher Order Function => Sequence After.
+
+withDeduplicate removes any sequentially equivalent values:
+
+`[1, 1, 2, 2, 2, 3]` => `withDeduplicate` => `[1, 2, 3]`
+
+withDefault replaces any undefined values, including initial synchronous value with a default value:
+
+`[void, 1, 2, undefined, 4]` => `withDefault(-1)` => `[-1, 1, 2, -1, 4]`
+
+withMap applies a mapping function to each value at notification time:
+
+`[void, 1, 2, 3]` => `withMap(x => x * 2)` => `[void, 2, 4, 6]`
+
+withOptional converts an `Observable<T>` to `Observable<T | undefined>` and will always respond synchronously.
+
+`[void, 1, 2, 3, 4]` => `withOptional` => `[undefined, 1, 2, 3, 4]`
+
+## Cache
+
+The cache module contains functions and interfaces related to caching, hashing, memoization and storage and retrieval of `Blob`s.
+
+The `memoize` function and `BlobStore` are the most important public interfaces in the cache submodule. They are described below. See the API reference for hashing and other lower level functions.
+
+The `memoize` function can be used to cache expensive, deterministic, asynchronous functions that take data arguments and return data results. In addition to caching the results, it also blocks multiple simultaneous calls with the same arguments and makes them wait for the first result.
+
+### BlobStore
+
+It is important to handle `Blob`s correctly within an application.
+
+The `BlobStore` interface and corresponding `blobStore` exported instance provide a convenient way to convert `Blob`s into small JSON handles to them called `BlobRef`s. Those `BlobRef`s can later be converted back into a `Blob`.
+
+`Blob`s within the `blobStore` are generally persisted across sessions using the browsers buid in `Cache` storage.
+
+`BlobRef`s have a number of advantages over directly using blobs.
+`BlobRef`s are:
+- small json objects
+- deterministic for each `Blob` based on mime type and content.
+- suitable for persistence to locations with limited size.
+- suitable for use as a cache key
+- suitable for use as a cache value
+
+## Schemas
+
+Contains some standard data type schemas in JSON Schema format for convenience. These types are most frequently used when describing components within the Entity Component System. Knowing the precise size and signedness of primitive numeric types allows the ECS to store these values within tightly packed typed arrays internally. This makes memory usage and processing time more efficient.
+
+## Entity Component System (ECS)
+
+This ECS database is a high performance, strongly typed typescript implementation inspired by the Sanders Mertens C++ based [Flecs](https://www.flecs.dev/flecs/md_docs_2Docs.html).
+
+This library provides two main interfaces for ECS operations: **Store** and **Database**. They share the same read API but differ significantly in their approach to writing and observability.
+
+### Store Interface
+
+The **Store** is the foundational, low-level interface for direct ECS data operations.
+
+**Key Characteristics:**
+- **Direct Access**: Provides immediate, synchronous read/write access to entities, components, and resources
+- **No Transaction Control**: Changes are applied directly without transaction boundaries  
+- **No Observability**: Changes are not automatically observable or trackable
+- **High Performance**: Minimal overhead for direct operations using Structure of Arrays (SoA) with linear memory layout of numeric types for optimal cache performance
+- **Core ECS Operations**: Includes entity creation, component updates, archetype querying, and resource management
+
+**Usage**: Ideal for scenarios requiring fast, direct ECS manipulation where you don't need change tracking or transactional safety.
+
+```typescript
+// Create a store with components, resources, and archetypes
+const store = createStore(
+  { 
+    position: Vec3.schema, 
+    health: { type: "number" },
+    player: { const: true } 
+  },
+  { 
+    gravity: { default: 9.8 as number } 
+  },
+  {
+    Player: ["position", "health", "player"],
+    Particle: ["position"]
+  }
+);
+
+// Direct operations
+const playerId = store.archetypes.Player.insert({ 
+  position: [0, 0, 0], 
+  health: 100, 
+  player: true 
+});
+store.update(playerId, { position: [1, 1, 1] });
+store.resources.gravity = 10.0;
+```
+
+### Database Interface
+
+The **Database** wraps a Store to provide **transaction-based operations** with **full observability**.
+
+**Key Characteristics:**
+- **Transaction-Based**: All changes must occur within predefined atomic transactions that can be undone.
+- **Full Observability**: Every change is observable through the `observe` API
+- **Predefined Operations**: Uses predefined transaction functions rather than direct mutations
+- **Undo/Redo Support**: Transactions generate undo/redo operations automatically
+- **Change Tracking**: Tracks which entities, components, and archetypes changed
+- **Event Notifications**: Automatically notifies observers of changes
+
+**Usage**: Ideal for applications requiring change history, multiplayer synchronization, undo/redo functionality, or reactive UI updates.
+
+**Important Note**: Even when using a Database, transaction functions are written as direct modifications to the underlying Store interface. The Database wraps these operations to provide transactional guarantees and observability.
+
+```typescript
+// Create a database with predefined transactions
+const database = createDatabase(store, {
+  createPlayer(t, args: { position: Vector3, health: number }) {
+    // Transaction function receives Store interface for direct operations
+    return t.archetypes.Player.insert({ 
+      ...args, 
+      player: true 
+    });
+  },
+  movePlayer(t, args: { entity: Entity, position: Vector3 }) {
+    // Direct Store operations within transaction context
+    t.update(args.entity, { position: args.position });
+  },
+  setGravity(t, gravity: number) {
+    // Direct resource modification within transaction
+    t.resources.gravity = gravity;
+  }
+});
+
+// Execute transactions (these provide observability and undo/redo)
+const playerId = database.transactions.createPlayer({ 
+  position: [10, 20, 0], 
+  health: 100 
+});
+database.transactions.movePlayer({ entity: playerId, position: [15, 25, 5] });
+
+// Observe all changes
+database.observe.transactions((result) => {
+  console.log('Transaction applied:', result);
+  console.log('Changed entities:', result.changedEntities);
+  console.log('Undo operations:', result.undo);
+});
+
+// Observe specific entities
+database.observe.entity(playerId)((entityData) => {
+  if (entityData) {
+    console.log('Player moved to:', entityData.position);
+  }
+});
+```
+
+### What is an ECS?
+
+Sanders Mertens also covers this thoroughly in his ECS FAQ:
+
+[https://github.com/SanderMertens/ecs-faq?tab=readme-ov-file#what-is-ecs](https://github.com/SanderMertens/ecs-faq?tab=readme-ov-file#what-is-ecs)
+
+In addition to the Entity, Component and System definitions which are standard, we also use the term Resource. A Resource is just a value which is defined globally on the ECS itself and not attached to any specific Entity. You can think of them as a singleton Component.
+
+## Performance Test
+
+[Performance Test](https://git.corp.adobe.com/pages/neuralfiltersplatform/firefly-data/docs/perftest.html)

package/{ecs → dist/ecs}/database/create-plugin.d.ts

@@ -1,4 +1,4 @@
-import { Database, SystemFunction, ServiceFactories, FromServiceFactories, type PluginComputedFactories } from "./database.js";
+import { Database, SystemFunction, ServiceFactories, FromServiceFactories, FromComputedFactories, type PluginComputedFactories } from "./database.js";
 import type { ComponentSchemas } from "../component-schemas.js";
 import type { ResourceSchemas } from "../resource-schemas.js";
 import type { ArchetypeComponents } from "../store/archetype-components.js";
@@ -67,11 +67,11 @@ export declare function createPlugin<const XP extends Database.Plugin<{}, {}, {}
     computed?: CVF & PluginComputedFactories<FullDBForPlugin<RemoveIndex<CS>, RemoveIndex<RS>, RemoveIndex<A>, RemoveIndex<TD>, string, RemoveIndex<AD> & XP['actions'], XP, RemoveIndex<SVF>>>;
     transactions?: TD;
     actions?: AD & {
-        readonly [K: string]: (db: Database<FromSchemas<RemoveIndex<CS> & XP['components']>, FromSchemas<RemoveIndex<RS> & XP['resources']>, RemoveIndex<A> & XP['archetypes'], ToTransactionFunctions<RemoveIndex<TD> & XP['transactions']>, string, ToActionFunctions<XP['actions']>, FromServiceFactories<RemoveIndex<SVF> & XP['services']>>, input?: any) => any;
+        readonly [K: string]: (db: Database<FromSchemas<RemoveIndex<CS> & XP['components']>, FromSchemas<RemoveIndex<RS> & XP['resources']>, RemoveIndex<A> & XP['archetypes'], ToTransactionFunctions<RemoveIndex<TD> & XP['transactions']>, S | StringKeyof<XP['systems']>, ToActionFunctions<XP['actions']>, FromServiceFactories<RemoveIndex<SVF> & XP['services']>, FromComputedFactories<RemoveIndex<CVF> & XP['computed']>>, input?: any) => any;
     };
     systems?: {
         readonly [K in S]: {
-            readonly create: (db: Database<FromSchemas<RemoveIndex<CS> & XP['components']>, FromSchemas<RemoveIndex<RS> & XP['resources']>, RemoveIndex<A> & XP['archetypes'], ToTransactionFunctions<RemoveIndex<TD> & XP['transactions']>, string, ToActionFunctions<RemoveIndex<AD> & XP['actions']>, FromServiceFactories<RemoveIndex<SVF> & XP['services']>> & {
+            readonly create: (db: Database<FromSchemas<RemoveIndex<CS> & XP['components']>, FromSchemas<RemoveIndex<RS> & XP['resources']>, RemoveIndex<A> & XP['archetypes'], ToTransactionFunctions<RemoveIndex<TD> & XP['transactions']>, S | StringKeyof<XP['systems']>, ToActionFunctions<RemoveIndex<AD> & XP['actions']>, FromServiceFactories<RemoveIndex<SVF> & XP['services']>, FromComputedFactories<RemoveIndex<CVF> & XP['computed']>> & {
                 readonly store: Store<FromSchemas<RemoveIndex<CS> & XP['components']>, FromSchemas<RemoveIndex<RS> & XP['resources']>, RemoveIndex<A> & XP['archetypes']>;
             }) => SystemFunction | void;
             readonly schedule?: {

package/{ecs → dist/ecs}/database/create-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-plugin.js","sourceRoot":"","sources":["../../../src/ecs/database/create-plugin.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAUvD,OAAO,EAAkB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AA4BtE,SAAS,qBAAqB,CAAC,OAAgC;IAC3D,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACzI,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,OAAO,CAAC,CAAC;IAE7D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,aAAa,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,6CAA6C,GAAG,4BAA4B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5H,CAAC;QACD,uDAAuD;QACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,iBAAiB,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACzD,IAAI,iBAAiB,GAAG,aAAa,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CACX,qCAAqC,GAAG,uBAAuB,OAAO,KAAK;oBAC3E,mBAAmB,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrF,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;AACL,CAAC;AA2DD,MAAM,UAAU,YAAY,CAWxB,OA4CC;IAWD,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE/B,mEAAmE;IACnE,MAAM,MAAM,GAAQ;QAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;QACpC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;QAClC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;QACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;QAChC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;QACxC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;QAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;KACjC,CAAC;IAEF,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAQ,CAAC;IAC1D,CAAC;IACD,OAAO,MAAa,CAAC;AACzB,CAAC"}
+{"version":3,"file":"create-plugin.js","sourceRoot":"","sources":["../../../src/ecs/database/create-plugin.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAUvD,OAAO,EAAkB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AA4BtE,SAAS,qBAAqB,CAAC,OAAgC;IAC3D,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACzI,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,OAAO,CAAC,CAAC;IAE7D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,aAAa,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,6CAA6C,GAAG,4BAA4B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5H,CAAC;QACD,uDAAuD;QACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,iBAAiB,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACzD,IAAI,iBAAiB,GAAG,aAAa,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CACX,qCAAqC,GAAG,uBAAuB,OAAO,KAAK;oBAC3E,mBAAmB,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrF,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;AACL,CAAC;AA2DD,MAAM,UAAU,YAAY,CAWxB,OA8CC;IAWD,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE/B,mEAAmE;IACnE,MAAM,MAAM,GAAQ;QAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;QACpC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;QAClC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;QACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;QAChC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;QACxC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;QAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;KACjC,CAAC;IAEF,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAQ,CAAC;IAC1D,CAAC;IACD,OAAO,MAAa,CAAC;AACzB,CAAC"}

package/{ecs → dist/ecs}/database/database.d.ts

@@ -97,17 +97,27 @@ export interface Database<C extends Components = {}, R extends ResourceComponent
         readonly functions: {
             readonly [K in S]: SystemFunction | null;
         };
-        readonly order: S[][];
+        /** Tier order for execution. Looser type allows extended dbs to be assignable to base. */
+        readonly order: ReadonlyArray<ReadonlyArray<string>>;
     };
     toData(): unknown;
     fromData(data: unknown): void;
     extend<P extends Database.Plugin<any, any, any, any, any, any, any, any>>(plugin: P): Database<C & (P extends Database.Plugin<infer XC, any, any, any, any, any, any, any> ? FromSchemas<XC> : never), R & (P extends Database.Plugin<any, infer XR, any, any, any, any, any, any> ? FromSchemas<XR> : never), A & (P extends Database.Plugin<any, any, infer XA, any, any, any, any, any> ? XA : never), F & (P extends Database.Plugin<any, any, any, infer XTD, any, any, any, any> ? ToTransactionFunctions<XTD> : never), S | (P extends Database.Plugin<any, any, any, any, infer XS, any, any, any> ? XS : never), AF & (P extends Database.Plugin<any, any, any, any, any, infer XAD, any, any> ? ToActionFunctions<XAD> : never), SV & (P extends Database.Plugin<any, any, any, any, any, any, infer XSVF, any> ? FromServiceFactories<XSVF> : never), CV & (P extends Database.Plugin<any, any, any, any, any, any, any, infer XCVF> ? FromComputedFactories<XCVF> : never)>;
 }
 export declare namespace Database {
-    type FromPlugin<P extends Database.Plugin> = P extends Database.Plugin<infer CS, infer RS, infer A, infer TD, infer S, infer AD, infer SVF, infer CVF> ? Database<FromSchemas<CS>, FromSchemas<RS>, A, ToTransactionFunctions<TD>, S, ToActionFunctions<AD>, FromServiceFactories<SVF>, FromComputedFactories<CVF>> : never;
-    const create: typeof createDatabase;
-    const is: (value: unknown) => value is Database;
-    type Plugin<CS extends ComponentSchemas = any, RS extends ResourceSchemas = any, A extends ArchetypeComponents<StringKeyof<CS>> = any, TD extends TransactionDeclarations<FromSchemas<CS>, FromSchemas<RS>, any> = any, S extends string = any, AD extends ActionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A, ToTransactionFunctions<TD>, S> = any, SVF extends ServiceFactories = any, CVF extends ComputedFactories = any> = {
+    /** Stepwise inference helpers - each infers one Plugin param to reduce compiler depth. */
+    type FromPluginComponents<P> = P extends Database.Plugin<infer CS, any, any, any, any, any, any, any> ? CS : never;
+    type FromPluginResources<P> = P extends Database.Plugin<any, infer RS, any, any, any, any, any, any> ? RS : never;
+    type FromPluginArchetypes<P> = P extends Database.Plugin<any, any, infer A, any, any, any, any, any> ? A : never;
+    type FromPluginTransactions<P> = P extends Database.Plugin<any, any, any, infer TD, any, any, any, any> ? TD : never;
+    type FromPluginSystems<P> = P extends Database.Plugin<any, any, any, any, infer S, any, any, any> ? S : never;
+    type FromPluginActions<P> = P extends Database.Plugin<any, any, any, any, any, infer AD, any, any> ? AD : never;
+    type FromPluginServices<P> = P extends Database.Plugin<any, any, any, any, any, any, infer SVF, any> ? SVF : never;
+    type FromPluginComputed<P> = P extends Database.Plugin<any, any, any, any, any, any, any, infer CVF> ? CVF : never;
+    export type FromPlugin<P extends Database.Plugin> = P extends Database.Plugin ? Database<FromSchemas<FromPluginComponents<P>>, FromSchemas<FromPluginResources<P>>, FromPluginArchetypes<P>, ToTransactionFunctions<FromPluginTransactions<P>>, FromPluginSystems<P>, ToActionFunctions<FromPluginActions<P>>, FromServiceFactories<FromPluginServices<P>>, FromComputedFactories<FromPluginComputed<P>>> : never;
+    export const create: typeof createDatabase;
+    export const is: (value: unknown) => value is Database;
+    export type Plugin<CS extends ComponentSchemas = any, RS extends ResourceSchemas = any, A extends ArchetypeComponents<StringKeyof<CS>> = any, TD extends TransactionDeclarations<FromSchemas<CS>, FromSchemas<RS>, any> = any, S extends string = any, AD extends ActionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A, ToTransactionFunctions<TD>, S> = any, SVF extends ServiceFactories = any, CVF extends ComputedFactories = any> = {
         readonly components: CS;
         readonly resources: RS;
         readonly archetypes: A;
@@ -117,7 +127,7 @@ export declare namespace Database {
         readonly services: SVF;
         readonly computed: CVF;
     };
-    namespace Plugin {
+    export namespace Plugin {
         const create: typeof createPlugin;
         const combine: typeof combinePlugins;
         type ToDatabase<P extends Database.Plugin> = Database.FromPlugin<P>;
@@ -126,4 +136,5 @@ export declare namespace Database {
             readonly store: Database.Plugin.ToStore<P>;
         };
     }
+    export {};
 }

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

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../../src/ecs/database/database.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAevD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAc7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAoGtD,MAAM,KAAW,QAAQ,CA0DxB;AA1DD,WAAiB,QAAQ;IAwBV,eAAM,GAAG,cAAc,CAAC;IAExB,WAAE,GAAG,CAAC,KAAc,EAAqB,EAAE;QACtD,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,cAAc,IAAI,KAAK,IAAI,SAAS,IAAI,KAAK,IAAI,OAAO,IAAI,KAAK,IAAI,SAAS,IAAI,KAAK,IAAI,QAAQ,IAAI,KAAK,IAAI,QAAQ,IAAI,KAAK,CAAC;IAC1L,CAAC,CAAA;IAsBD,IAAiB,MAAM,CAMtB;IAND,WAAiB,MAAM;QACR,aAAM,GAAG,YAAY,CAAC;QACtB,cAAO,GAAG,cAAc,CAAC;IAIxC,CAAC,EANgB,MAAM,GAAN,eAAM,KAAN,eAAM,QAMtB;AAEH,CAAC,EA1DgB,QAAQ,KAAR,QAAQ,QA0DxB"}

package/{ecs → dist/ecs}/database/index.d.ts

@@ -9,3 +9,4 @@ export * from "./observe-dependent-value.js";
 export * from "./transactional-store/index.js";
 export * from "./database-schema/index.js";
 export type { Undoable } from "./undoable.js";
+export * from "./combine-plugins.js";

package/{ecs → dist/ecs}/database/index.js

@@ -9,4 +9,5 @@ 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";
 //# sourceMappingURL=index.js.map

package/{ecs → 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,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ecs/database/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,cAAc,6BAA6B,CAAC;AAC5C,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"}

package/{ecs → dist/ecs}/database/public/create-database.type-test.js

@@ -157,4 +157,82 @@ function testSystemsAndActionsInference() {
     });
     const db = Database.create(extendedPlugin);
 }
+// ============================================================================
+// EXTENDED DB ASSIGNABLE TO BASE DB (computed type)
+// ============================================================================
+/**
+ * Verifies that db from an extended plugin's system create callback can be passed
+ * to a function expecting the base database type. This catches the "computed:
+ * unknown" bug where system create's db lacked the 8th Database parameter.
+ * We use Pick to test only resources and computed (the structural assignment).
+ */
+function testExtendedDbAssignableToBaseDb() {
+    const basePlugin = Database.Plugin.create({
+        components: { pos: { type: "number" } },
+        resources: { scale: { default: 1 } },
+        archetypes: { Entity: ["pos"] },
+        transactions: {},
+        actions: {},
+        systems: {},
+    });
+    const extendedPlugin = Database.Plugin.create({
+        extends: basePlugin,
+        components: { vel: { type: "number" } },
+        resources: {},
+        archetypes: { Moving: ["pos", "vel"] },
+        transactions: {},
+        actions: {},
+        systems: {
+            update: {
+                create: (db) => {
+                    fnExpectingBaseResourcesAndComputed(db);
+                    return () => { };
+                },
+            },
+        },
+    });
+    function fnExpectingBaseResourcesAndComputed(db) {
+        return db.resources.scale;
+    }
+}
+// ============================================================================
+// EXTENDED DB ASSIGNABLE TO BASE DB (system.functions)
+// ============================================================================
+/**
+ * Verifies that db from an extended plugin's system create callback has
+ * system.functions with specific keys (not { [x: string]: ... }). This catches
+ * the "S = string" bug where system create's db had an index signature.
+ * We test resources + system.functions.input (avoids system.order variance).
+ */
+function testExtendedDbAssignableToBaseDbWithSystems() {
+    const basePlugin = Database.Plugin.create({
+        components: { pos: { type: "number" } },
+        resources: { scale: { default: 1 } },
+        archetypes: { Entity: ["pos"] },
+        transactions: {},
+        actions: {},
+        systems: {
+            input: { create: (db) => () => { } },
+        },
+    });
+    const extendedPlugin = Database.Plugin.create({
+        extends: basePlugin,
+        components: { vel: { type: "number" } },
+        resources: {},
+        archetypes: { Moving: ["pos", "vel"] },
+        transactions: {},
+        actions: {},
+        systems: {
+            update: {
+                create: (db) => {
+                    fnExpectingBaseResourcesAndInputSystem(db);
+                    return () => { };
+                },
+            },
+        },
+    });
+    function fnExpectingBaseResourcesAndInputSystem(db) {
+        return db.resources.scale + (db.system.functions.input ? 1 : 0);
+    }
+}
 //# sourceMappingURL=create-database.type-test.js.map

package/{ecs → dist/ecs}/database/public/create-database.type-test.js.map

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

package/{ecs → dist/ecs}/index.d.ts

@@ -11,6 +11,6 @@ export * from "./resource-schemas.js";
 export * from "./undo-redo-service/index.js";
 export * from "./persistence-service/index.js";
 export { applyOperations } from "./database/transactional-store/apply-operations.js";
-export { scheduler } from "./plugins/index.js";
+export * from "./plugins/index.js";
 export * from "./store/transaction-functions.js";
 export { Entity } from "./entity.js";

package/{ecs → dist/ecs}/index.js

@@ -9,7 +9,7 @@ export * from "./resource-schemas.js";
 export * from "./undo-redo-service/index.js";
 export * from "./persistence-service/index.js";
 export { applyOperations } from "./database/transactional-store/apply-operations.js";
-export { scheduler } from "./plugins/index.js";
+export * from "./plugins/index.js";
 export * from "./store/transaction-functions.js";
 // Export Entity type and namespace
 export { Entity } from "./entity.js";

package/{ecs → dist/ecs}/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ecs/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,oDAAoD,CAAC;AACrF,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AAEjD,mCAAmC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ecs/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,oDAAoD,CAAC;AACrF,cAAc,oBAAoB,CAAC;AACnC,cAAc,kCAAkC,CAAC;AAEjD,mCAAmC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/ecs/plugins/scheduler/scheduler.d.ts

@@ -0,0 +1,10 @@
+export type SchedulerState = "running" | "paused" | "disposed";
+export declare const scheduler: import("../../index.js").CombinePlugins<[import("../../index.js").Database.Plugin<{}, {}, {}, {}, never, {}, {}, {}>, import("../../index.js").Database.Plugin<{}, {
+    readonly schedulerState: {
+        readonly default: SchedulerState;
+    };
+}, {}, {}, "schedulerSystem", import("../../index.js").ActionDeclarations<import("../../../schema/from-schemas.js").FromSchemas<{}>, import("../../../schema/from-schemas.js").FromSchemas<{
+    readonly schedulerState: {
+        readonly default: SchedulerState;
+    };
+}>, {}, import("../../index.js").ToTransactionFunctions<{}>, "schedulerSystem">, {}, {}>]>;

package/dist/ecs/plugins/scheduler/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../../../src/ecs/plugins/scheduler/scheduler.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAI/D,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC;IAClC,SAAS,EAAE;QACP,cAAc,EAAE,EAAE,OAAO,EAAE,SAA2B,EAAE;KAC3D;IACD,OAAO,EAAE;QACL,eAAe,EAAE;YACb,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE;gBACX,oBAAoB;gBACpB,MAAM,YAAY,GAAG,KAAK,IAAI,EAAE;oBAC5B,IAAI,EAAE,CAAC,SAAS,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;wBAC5C,kEAAkE;wBAClE,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;4BACjC,yFAAyF;4BACzF,MAAM,OAAO,CAAC,GAAG,CACb,IAAI;iCACC,MAAM,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,KAAK,iBAAiB,CAAC;iCACpD,GAAG,CAAC,CAAC,IAAY,EAAE,EAAE;gCAClB,MAAM,QAAQ,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAwC,CAAC,CAAC;gCAC/E,IAAI,QAAQ,IAAI,IAAI,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oCAC7C,6EAA6E;oCAC7E,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;gCAC7B,CAAC;gCACD,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;oCACjC,MAAM,IAAI,KAAK,CACX,WAAW,IAAI,uBAAuB;wCACtC,sBAAsB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtE,CAAC;gCACN,CAAC;gCACD,OAAO,QAAQ,EAAE,CAAC;4BACtB,CAAC,CAAC,CACT,CAAC;wBACN,CAAC;oBACL,CAAC;oBAED,IAAI,EAAE,CAAC,SAAS,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;wBAC7C,qBAAqB,CAAC,YAAY,CAAC,CAAC;oBACxC,CAAC;gBACL,CAAC,CAAC;gBAEF,2FAA2F;gBAC3F,qBAAqB,CAAC,YAAY,CAAC,CAAC;gBAEpC,yEAAyE;gBACzE,OAAO,GAAG,EAAE;oBACR,6DAA6D;gBACjE,CAAC,CAAC;YACN,CAAC;SACJ;KACJ;CACJ,CAAC,CAAC"}

package/{ecs → dist/ecs}/store/index.d.ts

@@ -2,3 +2,4 @@ export * from "./store.js";
 export * from "./archetype-components.js";
 export type { EntityReadValues, EntityUpdateValues, ArchetypeQueryOptions } from "./core/core.js";
 export type { EntitySelectOptions } from "./entity-select-options.js";
+export * from "./action-functions.js";

package/{ecs → dist/ecs}/store/index.js

@@ -1,4 +1,5 @@
 // © 2026 Adobe. MIT License. See /LICENSE for details.
 export * from "./store.js";
 export * from "./archetype-components.js";
+export * from "./action-functions.js";
 //# sourceMappingURL=index.js.map

package/{ecs → dist/ecs}/store/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ecs/store/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ecs/store/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAG1C,cAAc,uBAAuB,CAAC"}

package/{math → dist/math}/aabb/face/functions.d.ts

@@ -17,7 +17,7 @@ export declare const NONE = 0;
  */
 export declare const getName: (face: AabbFace) => string;
 /**
- * Get the normal vector for a given AABB face
+ * Get the normal vector for a given AABB face (outward from surface).
  */
 export declare const getNormal: (face: AabbFace) => Vec3;
 export declare function getFaces(face: AabbFace): IterableIterator<AabbFace>;