@awesome-ecs/abstract 0.32.1 → 0.34.0

package/README.md

@@ -1,125 +1,119 @@
-# Awesome ECS - Abstract Package
-
-## Overview
-
-The Abstract package defines all core interfaces and abstractions for the Entity-Component-System (ECS) framework. It provides the foundational contracts that all other packages implement, including:
-
-- **Components**: Data-storage contracts
-- **Entities**: Container contracts for components and relationships
-- **Pipelines**: Middleware-based execution chains
-- **Systems**: Modular logic execution patterns
-- **Utilities**: Serialization, events, and scheduling
-
-This package has **zero external dependencies** and serves as the contract layer for the entire ECS framework.
-
-## Core Concepts
-
-### Components (`src/components/`)
-
-Components are **data-only containers**. They should never contain business logic.
-
-```typescript
-import { IComponent } from "@awesome-ecs/abstract";
-
-export class HealthComponent implements IComponent {
-  readonly componentType = ComponentType.health;
-  readonly isSerializable = true;  // Include in snapshots
-  
-  current: number = 100;
-  max: number = 100;
-}
-```
-
-**Key interfaces:**
-- `IComponent`: Base component interface with `componentType` and `isSerializable`
-- `IdentityComponent`: Mandatory component tracking entity UID and model
-
-### Entities (`src/entities/`)
-
-Entities are immutable **containers of components** and **proxies to other entities**. They never directly reference other entities—they use proxies for loose coupling.
-
-```typescript
-export class GridEntity extends EntityBase<GridModel> {
-  // Strongly-typed component getters
-  get coordinates(): CoordinatesComponent {
-    return this.getComponent(ComponentType.coordinates);
-  }
-
-  // Entity proxies for relationships (not direct references)
-  get sceneProxy(): EntityProxy<SceneEntity> {
-    return this.getProxy(EntityType.scene);
-  }
-}
-```
-
-**Key files:**
-- `entity.ts`: Base `IEntity` interface and `EntityTypeUid` types
-- `entity-proxies.ts`: `EntityProxy` for loose-coupling relationships
-- `entity-snapshot.ts`: `IEntitySnapshot` for serialization
-- `entity-queue.ts`: `IEntityUpdate` and `IEntityUpdateQueue` for batching changes
-- `entity-repository.ts`: `IEntityRepository` for entity lookups
-- `entity-scheduler.ts`: `IEntityScheduler` for deferred updates
-- `entity-events.ts`: `IEntityEvents` for reactive patterns
-
-### Pipelines (`src/pipelines/`)
-
-Pipelines execute **middleware chains** with two phases:
-
-1. **dispatch(context)**: Main execution phase
-2. **cleanup(context)**: Resource cleanup phase
-
-```typescript
-export interface IPipeline<TContext extends IPipelineContext> {
-  use(middleware: IMiddleware<TContext>): this;
-  dispatch(context: Partial<TContext>): void | Promise<void>;
-  cleanup(context: Partial<TContext>): void | Promise<void>;
-}
-```
-
-**Key files:**
-- `pipeline.ts`: Core `IPipeline` interface
-- `middleware.ts`: `IMiddleware` contract (action + optional cleanup)
-- `middleware-runner.ts`: Middleware execution engine
-- `pipeline-context.ts`: Context passed to middleware
-- `pipeline-runner.ts`: Pipeline execution orchestration
-
-### Systems (`src/systems/`)
-
-Systems are **modular logic units** that operate on entities. They implement the middleware pattern.
-
-**Pipeline-based systems:**
-- `system-middleware.ts`: `ISystemMiddleware<TEntity>` - middleware for a specific entity type
-- `system-context.ts`: Context passed to system middleware (entity, events, repository, etc.)
-
-**Module-based organization:**
-- `systems-module.ts`: `ISystemsModule<TEntity>` - groups related systems targeting an entity type
-- `systems-module-builder.ts`: `ISystemsModuleBuilder<TEntity>` - fluent builder for pipeline registration
-- `systems-module-repository.ts`: Module lifecycle and registration
-
-**Runtime execution:**
-- `systems-runtime.ts`: `ISystemsRuntime` - core tick-based execution loop
-- `systems-runtime-context.ts`: Context for runtime execution
-- `systems-runtime-middleware.ts`: Middleware for runtime operations
-
-### Utilities (`src/utils/`)
-
-- `types.ts`: Common types (`Immutable`, `BooleanProps`, `Readonly`)
-- `json-serializer.ts`: JSON serialization contracts
-- `logger.ts`: Logging interface
-- `performance-timer.ts`: Performance measurement
-
-## Key Design Principles
-
-1. **Components are data-only** - no behavior, just properties
-2. **Entities are immutable** - modifications through systems only
-3. **Relationships use proxies** - loose coupling between entities
-4. **Systems are middleware** - pluggable into pipelines
-5. **Pipelines are composable** - middleware chains with dispatch + cleanup
-
-## What's NOT in Abstract
-
-- Concrete entity implementations (→ @awesome-ecs/core)
-- System module base classes (→ @awesome-ecs/core)
-- Component factories (→ @awesome-ecs/core)
-- Multi-threading (→ @awesome-ecs/workers)
-- AI patterns (→ @awesome-ecs/ai)
+# Awesome ECS - Abstract Package
+
+## Overview
+
+The Abstract package defines all core interfaces and abstractions for the Entity-Component-System (ECS) framework. It provides the foundational contracts that all other packages implement, including:
+
+- **Components**: Data-storage contracts
+- **Entities**: Materialized view contracts for components and proxy references
+- **Pipelines**: Middleware-based execution chains
+- **Systems**: Modular logic execution patterns
+- **Utilities**: Serialization, events, and scheduling
+
+This package has **zero external dependencies** and serves as the contract layer for the entire ECS framework.
+
+## Core Concepts
+
+### Components (`src/components/`)
+
+Components are **data-only containers**. They should never contain business logic.
+
+```typescript
+import { IComponent } from "@awesome-ecs/abstract";
+
+export class HealthComponent implements IComponent {
+  readonly componentType = ComponentType.health;
+  readonly isSerializable = true;  // Include in snapshots
+  
+  current: number = 100;
+  max: number = 100;
+}
+```
+
+**Key interfaces:**
+- `IComponent`: Base component interface with `componentType` and `isSerializable`
+- `IdentityComponent`: Mandatory component tracking entity UID and model
+
+### Entities (`src/entities/`)
+
+Entities are immutable contracts over identity, components, and explicit typed proxy fields.
+
+```typescript
+import { EntityProxy, IEntityWith } from '@awesome-ecs/abstract/entities';
+
+export interface GridEntity extends IEntityWith<GridModel> {
+  readonly coordinates: CoordinatesComponent;
+  readonly sceneProxy: EntityProxy<SceneEntity>;
+}
+```
+
+**Key files:**
+- `entity.ts`: Base `IEntity` interface and `EntityTypeUid` types
+- `entity-proxies.ts`: `EntityProxy` for loose-coupling relationships
+- `entity-snapshot.ts`: `IEntitySnapshot` for serialization
+- `entity-runtime-scheduler.ts`: `IEntityUpdate`, the lean `IEntityRuntimeScheduler` runtime contract, and `IEntityRuntimeSchedulerInspector` for tooling/debug surfaces that need mailbox and schedule snapshots
+- `entity-repository.ts`: `IEntityRepository` for entity lookups
+- `entity-events.ts`: `IEntityEvents` for reactive patterns
+
+### Pipelines (`src/pipelines/`)
+
+Pipelines execute **middleware chains** with two phases:
+
+1. **dispatch(context)**: Main execution phase
+2. **cleanup(context)**: Resource cleanup phase
+
+```typescript
+export interface IPipeline<TContext extends IPipelineContext> {
+  use(middleware: IMiddleware<TContext>): this;
+  dispatch(context: Partial<TContext>): void | Promise<void>;
+  cleanup(context: Partial<TContext>): void | Promise<void>;
+}
+```
+
+**Key files:**
+- `pipeline.ts`: Core `IPipeline` interface
+- `middleware.ts`: `IMiddleware` contract (action + optional cleanup)
+- `middleware-runner.ts`: Middleware execution engine
+- `pipeline-context.ts`: Context passed to middleware
+- `pipeline-runner.ts`: Pipeline execution orchestration
+
+### Systems (`src/systems/`)
+
+Systems are **modular logic units** that operate on entities. They implement the middleware pattern.
+
+**Pipeline-based systems:**
+- `system-middleware.ts`: `ISystemMiddleware<TEntity>` - middleware for a specific entity type
+- `system-context.ts`: Context passed to system middleware (entity, events, repository, etc.)
+
+**Module-based organization:**
+- `systems-module.ts`: `ISystemsModule<TEntity>` - groups related systems targeting an entity type
+- `systems-module-builder.ts`: `ISystemsModuleBuilder<TEntity>` - fluent builder for pipeline registration
+- `systems-module-repository.ts`: Module lifecycle and registration
+
+**Runtime execution:**
+- `systems-runtime.ts`: `ISystemsRuntime` - core tick-based execution loop
+- `systems-runtime-context.ts`: Context for runtime execution
+- `systems-runtime-middleware.ts`: Middleware for runtime operations
+
+### Utilities (`src/utils/`)
+
+- `types.ts`: Common types (`Immutable`, `BooleanProps`, `Readonly`)
+- `json-serializer.ts`: JSON serialization contracts
+- `logger.ts`: Logging interface
+- `performance-timer.ts`: Performance measurement
+
+## Key Design Principles
+
+1. **Components are data-only** - no behavior, just properties
+2. **Entities are immutable** - modifications through systems only
+3. **Relationships are backed by proxies** - proxy fields expose typed lookup refs; systems resolve proxy handles or full entities explicitly when needed
+4. **Systems are middleware** - pluggable into pipelines
+5. **Pipelines are composable** - middleware chains with dispatch + cleanup
+
+## What's NOT in Abstract
+
+- Concrete entity implementations (→ @awesome-ecs/core)
+- System module base classes (→ @awesome-ecs/core)
+- Component factories (→ @awesome-ecs/core)
+- Multi-threading (→ @awesome-ecs/workers)
+- AI patterns (→ @awesome-ecs/ai)

package/dist/components/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../src/components/identity-component.ts"],"sourcesContent":["import { EntityTypeUid, IEntityModel } from '../entities/entity';\nimport { Immutable } from '../utils/types';\nimport { IComponent } from './component';\n\n/**\n * The `BasicComponentType` enum defines the types of basic components available.\n */\nexport enum BasicComponentType {\n  identity = 'identity'\n}\n\n/**\n * The mandatory metadata component for every entity.\n * Contains core information that defines what an entity is and when it was last updated.\n * This component is immutable after creation and uniquely identifies each entity.\n *\n * @template TModel - The entity model type containing initialization data.\n */\nexport interface IdentityComponent<TModel extends IEntityModel> extends IComponent {\n  /**\n   * The entity type classification.\n   * Categorizes entities into logical types, allowing systems to selectively operate on specific entity categories.\n   */\n  readonly entityType: EntityTypeUid;\n\n  /**\n   * The initialization model for this entity.\n   * Provides the minimal data structure used when the entity was first created.\n   * Serves as a reference point for the entity's initial configuration.\n   *\n   * @type {Immutable<TModel>}\n   */\n  readonly model: Immutable<TModel>;\n\n  /**\n   * The timestamp of the entity's last system update.\n   * Useful for calculating elapsed time (delta time) between consecutive updates.\n   * Helps systems make time-aware decisions.\n   *\n   * @type {Date | undefined}\n   */\n  readonly lastUpdated?: Date;\n}\n"],"mappings":";;;;;AAOA,IAAY,qBAAL,yBAAA,oBAAA;CACL,mBAAA,cAAA;;AACF,EAAA,CAAA,CAAA"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/components/identity-component.ts"],"sourcesContent":["import type { EntityTypeUid, IEntityModel } from '../entities/entity';\r\nimport type { IEntityProxy } from '../entities/entity-proxies';\r\nimport { Immutable } from '../utils/types';\r\nimport { IComponent } from './component';\r\n\r\n/**\r\n * The `BasicComponentType` enum defines the types of basic components available.\r\n */\r\nexport enum BasicComponentType {\r\n  identity = 'identity'\r\n}\r\n\r\n/**\r\n * The mandatory metadata component for every entity.\r\n * Contains core information that defines what an entity is and when it was last updated.\r\n * This component is immutable after creation and uniquely identifies each entity.\r\n *\r\n * @template TModel - The entity model type containing initialization data.\r\n */\r\nexport interface IdentityComponent<TModel extends IEntityModel> extends IComponent {\r\n  /**\r\n   * The entity type classification.\r\n   * Categorizes entities into logical types, allowing systems to selectively operate on specific entity categories.\r\n   */\r\n  readonly entityType: EntityTypeUid;\r\n\r\n  /**\r\n   * The initialization model for this entity.\r\n   * Provides the minimal data structure used when the entity was first created.\r\n   * Serves as a reference point for the entity's initial configuration.\r\n   *\r\n   * @type {Immutable<TModel>}\r\n   */\r\n  readonly model: Immutable<TModel>;\r\n\r\n  /**\r\n   * The proxy for this entity, derived from `entityType` and `model.uid`.\r\n   */\r\n  readonly proxy: IEntityProxy;\r\n\r\n  /**\r\n   * The timestamp of the entity's last system update.\r\n   * Useful for calculating elapsed time (delta time) between consecutive updates.\r\n   * Helps systems make time-aware decisions.\r\n   *\r\n   * @type {Date | undefined}\r\n   */\r\n  readonly lastUpdated?: Date;\r\n}\r\n"],"mappings":";;;;;AAQA,IAAY,qBAAL,yBAAA,oBAAA;CACL,mBAAA,cAAA;;AACF,EAAA,CAAA,CAAA"}

package/dist/components/index.d.cts

@@ -1,2 +1,2 @@
-import { _ as ConfigRecord, f as ComponentTypeUid, g as ConfigOption, h as ConfigCustomControlOptions, m as IComponentWithConfig, n as IdentityComponent, p as IComponent, t as BasicComponentType } from "../index-C5nragoq.cjs";
-export { BasicComponentType, ComponentTypeUid, ConfigCustomControlOptions, ConfigOption, ConfigRecord, IComponent, IComponentWithConfig, IdentityComponent };
+import { C as ConfigCustomControlOptions, S as IComponentWithConfig, T as ConfigRecord, b as ComponentTypeUid, t as IComponentRepository, v as BasicComponentType, w as ConfigOption, x as IComponent, y as IdentityComponent } from "../index-DMZSrHoB.cjs";
+export { BasicComponentType, ComponentTypeUid, ConfigCustomControlOptions, ConfigOption, ConfigRecord, IComponent, IComponentRepository, IComponentWithConfig, IdentityComponent };

package/dist/components/index.d.mts

@@ -1,2 +1,2 @@
-import { _ as ConfigRecord, f as ComponentTypeUid, g as ConfigOption, h as ConfigCustomControlOptions, m as IComponentWithConfig, n as IdentityComponent, p as IComponent, t as BasicComponentType } from "../index-BlP67nCr.mjs";
-export { BasicComponentType, ComponentTypeUid, ConfigCustomControlOptions, ConfigOption, ConfigRecord, IComponent, IComponentWithConfig, IdentityComponent };
+import { C as ConfigCustomControlOptions, S as IComponentWithConfig, T as ConfigRecord, b as ComponentTypeUid, t as IComponentRepository, v as BasicComponentType, w as ConfigOption, x as IComponent, y as IdentityComponent } from "../index-Dbwzlrgp.mjs";
+export { BasicComponentType, ComponentTypeUid, ConfigCustomControlOptions, ConfigOption, ConfigRecord, IComponent, IComponentRepository, IComponentWithConfig, IdentityComponent };

package/dist/components/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/components/identity-component.ts"],"sourcesContent":["import { EntityTypeUid, IEntityModel } from '../entities/entity';\nimport { Immutable } from '../utils/types';\nimport { IComponent } from './component';\n\n/**\n * The `BasicComponentType` enum defines the types of basic components available.\n */\nexport enum BasicComponentType {\n  identity = 'identity'\n}\n\n/**\n * The mandatory metadata component for every entity.\n * Contains core information that defines what an entity is and when it was last updated.\n * This component is immutable after creation and uniquely identifies each entity.\n *\n * @template TModel - The entity model type containing initialization data.\n */\nexport interface IdentityComponent<TModel extends IEntityModel> extends IComponent {\n  /**\n   * The entity type classification.\n   * Categorizes entities into logical types, allowing systems to selectively operate on specific entity categories.\n   */\n  readonly entityType: EntityTypeUid;\n\n  /**\n   * The initialization model for this entity.\n   * Provides the minimal data structure used when the entity was first created.\n   * Serves as a reference point for the entity's initial configuration.\n   *\n   * @type {Immutable<TModel>}\n   */\n  readonly model: Immutable<TModel>;\n\n  /**\n   * The timestamp of the entity's last system update.\n   * Useful for calculating elapsed time (delta time) between consecutive updates.\n   * Helps systems make time-aware decisions.\n   *\n   * @type {Date | undefined}\n   */\n  readonly lastUpdated?: Date;\n}\n"],"mappings":";;;;AAOA,IAAY,qBAAL,yBAAA,oBAAA;CACL,mBAAA,cAAA;;AACF,EAAA,CAAA,CAAA"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/components/identity-component.ts"],"sourcesContent":["import type { EntityTypeUid, IEntityModel } from '../entities/entity';\r\nimport type { IEntityProxy } from '../entities/entity-proxies';\r\nimport { Immutable } from '../utils/types';\r\nimport { IComponent } from './component';\r\n\r\n/**\r\n * The `BasicComponentType` enum defines the types of basic components available.\r\n */\r\nexport enum BasicComponentType {\r\n  identity = 'identity'\r\n}\r\n\r\n/**\r\n * The mandatory metadata component for every entity.\r\n * Contains core information that defines what an entity is and when it was last updated.\r\n * This component is immutable after creation and uniquely identifies each entity.\r\n *\r\n * @template TModel - The entity model type containing initialization data.\r\n */\r\nexport interface IdentityComponent<TModel extends IEntityModel> extends IComponent {\r\n  /**\r\n   * The entity type classification.\r\n   * Categorizes entities into logical types, allowing systems to selectively operate on specific entity categories.\r\n   */\r\n  readonly entityType: EntityTypeUid;\r\n\r\n  /**\r\n   * The initialization model for this entity.\r\n   * Provides the minimal data structure used when the entity was first created.\r\n   * Serves as a reference point for the entity's initial configuration.\r\n   *\r\n   * @type {Immutable<TModel>}\r\n   */\r\n  readonly model: Immutable<TModel>;\r\n\r\n  /**\r\n   * The proxy for this entity, derived from `entityType` and `model.uid`.\r\n   */\r\n  readonly proxy: IEntityProxy;\r\n\r\n  /**\r\n   * The timestamp of the entity's last system update.\r\n   * Useful for calculating elapsed time (delta time) between consecutive updates.\r\n   * Helps systems make time-aware decisions.\r\n   *\r\n   * @type {Date | undefined}\r\n   */\r\n  readonly lastUpdated?: Date;\r\n}\r\n"],"mappings":";;;;AAQA,IAAY,qBAAL,yBAAA,oBAAA;CACL,mBAAA,cAAA;;AACF,EAAA,CAAA,CAAA"}

package/dist/entities/index.cjs

@@ -1,36 +1,22 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/entities/entity-queue.ts
-/**
-* Specifies the action to be performed on an entity.
-* Updates are categorized to enable different processing paths in the runtime.
-*/
+//#region src/entities/context-repository.ts
+const SYSTEM_CONTEXT_KEY = Symbol("systemContext");
+//#endregion
+//#region src/entities/entity-scheduler.ts
 let EntityUpdateType = /* @__PURE__ */ function(EntityUpdateType) {
-	/**
-	* Indicates the entity should be updated with new data.
-	*/
 	EntityUpdateType["update"] = "update";
-	/**
-	* Indicates the entity should be removed from the system.
-	*/
 	EntityUpdateType["remove"] = "remove";
 	return EntityUpdateType;
 }({});
-//#endregion
-//#region src/entities/entity-scheduler.ts
-/**
-* Controls which scheduling modes are paused.
-*/
 let SchedulerPauseType = /* @__PURE__ */ function(SchedulerPauseType) {
-	/** Pause both interval timers and frame subscriptions. */
 	SchedulerPauseType["full"] = "full";
-	/** Pause only frame subscriptions. Interval timers continue firing. */
 	SchedulerPauseType["perFrame"] = "perFrame";
-	/** Pause only interval timers. Frame subscriptions continue. */
 	SchedulerPauseType["intervals"] = "intervals";
 	return SchedulerPauseType;
 }({});
 //#endregion
 exports.EntityUpdateType = EntityUpdateType;
+exports.SYSTEM_CONTEXT_KEY = SYSTEM_CONTEXT_KEY;
 exports.SchedulerPauseType = SchedulerPauseType;
 
 //# sourceMappingURL=index.cjs.map

package/dist/entities/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../src/entities/entity-queue.ts","../../src/entities/entity-scheduler.ts"],"sourcesContent":["import { IEntityModel } from './entity';\nimport { IEntityConfigSnapshot } from './entity-config';\nimport { IEntityProxy } from './entity-proxies';\nimport { IEntitySnapshot } from './entity-snapshot';\n\n/**\n * Specifies the action to be performed on an entity.\n * Updates are categorized to enable different processing paths in the runtime.\n */\nexport enum EntityUpdateType {\n  /**\n   * Indicates the entity should be updated with new data.\n   */\n  update = 'update',\n  /**\n   * Indicates the entity should be removed from the system.\n   */\n  remove = 'remove'\n}\n\n/**\n * Represents a queued entity state change or removal.\n * Updates flow through the system to be processed by entity update handlers.\n */\nexport interface IEntityUpdate {\n  /**\n   * The type of operation: update or remove.\n   */\n  readonly type: EntityUpdateType;\n\n  /**\n   * The entity being affected by this update.\n   */\n  readonly entity: IEntityProxy;\n\n  /**\n   * Optional model data for initialization or reconfiguration.\n   */\n  readonly model?: IEntityModel;\n\n  /**\n   * Optional serialized state to apply to the entity.\n   */\n  readonly snapshot?: IEntitySnapshot;\n\n  /**\n   * Optional config-only component state to apply to the entity.\n   * When present on an update, the runtime applies it after `snapshot` and\n   * includes the config system phase in the same tick.\n   */\n  readonly config?: IEntityConfigSnapshot;\n}\n\n/**\n * Queue interface for managing pending entity updates.\n * Different implementations may use different prioritization strategies (e.g., priority queues, FIFO, ordered by entity type).\n * Updates are consumed by the runtime and dispatched to appropriate entity systems.\n */\nexport interface IEntityUpdateQueue {\n  /**\n   * The current number of updates in the queue.\n   */\n  readonly size: number;\n\n  /**\n   * Adds an update to the queue for processing.\n   * @param change - The update to queue.\n   */\n  enqueue(change: IEntityUpdate): void;\n\n  /**\n   * Removes and returns the next update from the queue.\n   * The specific update returned depends on the queue's prioritization strategy.\n   * @returns The next queued update.\n   */\n  dequeue(): IEntityUpdate;\n\n  /**\n   * Views the next update without removing it.\n   * Useful for inspection before dequeuing.\n   * @returns The next update in the queue.\n   */\n  peek(): IEntityUpdate;\n\n  /**\n   * Returns a read-only snapshot of all queued updates without removing them.\n   * Useful for inspection/debugging UIs.\n   * @returns An array of all currently queued updates.\n   */\n  items(): ReadonlyArray<IEntityUpdate>;\n\n  /**\n   * Removes all updates from the queue.\n   */\n  clear(): void;\n}\n","import { EntityTypeUid } from './entity';\nimport { IEntityProxy } from './entity-proxies';\n\n/**\n * Describes a scheduled entity update, including the target entity and optional interval.\n */\nexport type EntitySchedule = {\n  readonly proxy: IEntityProxy;\n  readonly intervalMs?: number;\n};\n\n/**\n * Controls which scheduling modes are paused.\n */\nexport enum SchedulerPauseType {\n  /** Pause both interval timers and frame subscriptions. */\n  full = 'full',\n  /** Pause only frame subscriptions. Interval timers continue firing. */\n  perFrame = 'perFrame',\n  /** Pause only interval timers. Frame subscriptions continue. */\n  intervals = 'intervals'\n}\n\n/**\n * Manages time-based scheduling of entity updates.\n *\n * Entities can be scheduled with an interval (timer-driven) or without one (per-frame).\n * The runtime pulls pending entities each tick via the {@link pending} iterator,\n * which yields both per-frame subscriptions and interval entities whose timer has fired.\n */\nexport interface IEntityScheduler {\n  /**\n   * Returns all currently scheduled entities with their configuration.\n   * Useful for inspection and debugging.\n   */\n  readonly schedules: ReadonlyArray<EntitySchedule>;\n\n  /**\n   * Yields entities pending processing this tick: per-frame subscriptions\n   * followed by interval entities whose timer has fired since the last drain.\n   * Iterating drains the due interval buckets; a second iteration without\n   * timer advancement yields only per-frame subscriptions.\n   */\n  readonly pending: IterableIterator<IEntityProxy>;\n\n  /**\n   * The set of entities scheduled for per-frame updates (no interval).\n   */\n  readonly frameSubscriptions: ReadonlySet<IEntityProxy>;\n\n  /**\n   * Entity types currently excluded from {@link pending} iteration.\n   */\n  readonly skippedEntityTypes: ReadonlySet<EntityTypeUid>;\n\n  /**\n   * The number of entities currently awaiting processing:\n   * per-frame subscriptions (if not paused) plus interval entities whose timer has fired.\n   */\n  readonly pendingCount: number;\n\n  /**\n   * Whether the scheduler is currently paused in any mode.\n   */\n  readonly isPaused: boolean;\n\n  /**\n   * Registers or replaces an entity schedule.\n   * @param entityProxy - The entity to schedule.\n   * @param intervalMs - Update frequency in milliseconds. If omitted, the entity is scheduled per-frame.\n   */\n  schedule(entityProxy: IEntityProxy, intervalMs?: number): void;\n\n  /**\n   * Unregisters an entity from the scheduler.\n   * @param entityProxy - The entity to unschedule.\n   */\n  remove(entityProxy: IEntityProxy): void;\n\n  /**\n   * Checks if an entity is currently scheduled for updates.\n   * @param entityProxy - The entity to check.\n   * @returns True if the entity is scheduled, false otherwise.\n   */\n  has(entityProxy: IEntityProxy): boolean;\n\n  /**\n   * Removes all schedules and clears all timers.\n   */\n  clear(): void;\n\n  /**\n   * Excludes an entity type from {@link pending} iteration.\n   * Entities remain registered; only yielding is suppressed.\n   */\n  skipEntityType(entityType: EntityTypeUid): void;\n\n  /**\n   * Re-includes a previously skipped entity type in {@link pending} iteration.\n   */\n  unskipEntityType(entityType: EntityTypeUid): void;\n\n  /**\n   * Pauses the scheduler.\n   * @param type - Which scheduling modes to pause. Defaults to {@link SchedulerPauseType.full}.\n   */\n  pause(type?: SchedulerPauseType): void;\n\n  /**\n   * Resumes the scheduler from any paused state.\n   */\n  resume(): void;\n}\n"],"mappings":";;;;;;AASA,IAAY,mBAAL,yBAAA,kBAAA;;;;CAIL,iBAAA,YAAA;;;;CAIA,iBAAA,YAAA;;AACF,EAAA,CAAA,CAAA;;;;;;ACJA,IAAY,qBAAL,yBAAA,oBAAA;;CAEL,mBAAA,UAAA;;CAEA,mBAAA,cAAA;;CAEA,mBAAA,eAAA;;AACF,EAAA,CAAA,CAAA"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/entities/context-repository.ts","../../src/entities/entity-scheduler.ts"],"sourcesContent":["import type { IEntityProxy } from './entity-proxies';\r\n\r\nexport const SYSTEM_CONTEXT_KEY = Symbol('systemContext');\r\n\r\nexport interface IContextRepository {\r\n  get<TContext>(proxy: IEntityProxy, key: string | symbol): TContext | undefined;\r\n  set<TContext>(proxy: IEntityProxy, key: string | symbol, context: TContext): TContext;\r\n  delete(proxy: IEntityProxy, key: string | symbol): boolean;\r\n  deleteAll(proxy: IEntityProxy): boolean;\r\n}\r\n","import { EntityTypeUid, IEntityModel } from './entity';\r\nimport { IEntityConfigSnapshot } from './entity-config';\r\nimport { IEntityEvent, IEventData } from './entity-events';\r\nimport { IEntityProxy } from './entity-proxies';\r\nimport { IEntitySnapshot } from './entity-snapshot';\r\n\r\nexport enum EntityUpdateType {\r\n  update = 'update',\r\n  remove = 'remove'\r\n}\r\n\r\nexport interface IEntityUpdate {\r\n  readonly type: EntityUpdateType;\r\n  readonly entity: IEntityProxy;\r\n  readonly model?: IEntityModel;\r\n  readonly snapshot?: IEntitySnapshot;\r\n  readonly config?: IEntityConfigSnapshot;\r\n}\r\n\r\nexport interface IEntityDispatchGroup {\r\n  readonly entityType: EntityTypeUid;\r\n  readonly updates: ReadonlyArray<IEntityUpdate>;\r\n  readonly dirtyUpdates: number;\r\n  readonly scheduledUpdates: number;\r\n  readonly removeUpdates: number;\r\n  readonly pipelineMask?: number;\r\n}\r\n\r\nexport type EntityRuntimePendingGroupOptions = {\r\n  readonly includeFrameSubscriptions?: boolean;\r\n};\r\n\r\nexport type EntitySchedule = {\r\n  readonly proxy: IEntityProxy;\r\n  readonly intervalMs?: number;\r\n};\r\n\r\nexport type EntityPriorityModel = {\r\n  readonly defaultPriority?: number;\r\n  readonly entityTypes?: ReadonlyMap<EntityTypeUid, number>;\r\n};\r\n\r\nexport enum SchedulerPauseType {\r\n  full = 'full',\r\n  perFrame = 'perFrame',\r\n  intervals = 'intervals'\r\n}\r\n\r\nexport interface IEntityRuntimeScheduler {\r\n  enqueue(update: IEntityUpdate): void;\r\n  enqueueEvent(entity: IEntityProxy, event: IEntityEvent<IEventData>): void;\r\n  enqueueEvents(entity: IEntityProxy, events: ReadonlyArray<IEntityEvent<IEventData>>): void;\r\n  clearDirtyUpdates(): void;\r\n\r\n  schedule(proxy: IEntityProxy, intervalMs?: number): void;\r\n  removeSchedule(proxy: IEntityProxy): void;\r\n  hasSchedule(proxy: IEntityProxy): boolean;\r\n  clearSchedules(): void;\r\n\r\n  takePendingGroups(\r\n    maxItems?: number,\r\n    options?: EntityRuntimePendingGroupOptions\r\n  ): ReadonlyArray<IEntityDispatchGroup>;\r\n\r\n  skipEntityType(entityType: EntityTypeUid): void;\r\n  unskipEntityType(entityType: EntityTypeUid): void;\r\n  pause(type?: SchedulerPauseType): void;\r\n  resume(): void;\r\n}\r\n\r\nexport interface IEntityRuntimeSchedulerInspector extends IEntityRuntimeScheduler {\r\n  readonly dirtyCount: number;\r\n  readonly frameSubscriptions: ReadonlySet<IEntityProxy>;\r\n  readonly isPaused: boolean;\r\n  readonly pauseType: SchedulerPauseType | null;\r\n  readonly pendingGroupCount: number;\r\n  readonly pendingCount: number;\r\n  readonly rawDirtyCount: number;\r\n  readonly schedules: ReadonlyArray<EntitySchedule>;\r\n  readonly skippedEntityTypes: ReadonlySet<EntityTypeUid>;\r\n\r\n  inspectDirtyUpdates(): ReadonlyArray<IEntityUpdate>;\r\n}\r\n"],"mappings":";;AAEA,MAAa,qBAAqB,OAAO,eAAe;;;ACIxD,IAAY,mBAAL,yBAAA,kBAAA;CACL,iBAAA,YAAA;CACA,iBAAA,YAAA;;AACF,EAAA,CAAA,CAAA;AAiCA,IAAY,qBAAL,yBAAA,oBAAA;CACL,mBAAA,UAAA;CACA,mBAAA,cAAA;CACA,mBAAA,eAAA;;AACF,EAAA,CAAA,CAAA"}

package/dist/entities/index.d.cts

@@ -1,3 +1,3 @@
-import { a as IEntity, c as IEntityProxy, d as TypedEntityProxy, i as EntityUid, l as IEntityProxyRepository, o as IEntityModel, r as EntityTypeUid, s as EntityProxy, u as RequiredProxies } from "../index-C5nragoq.cjs";
-import { _ as IEntityContextCache, a as EntityUpdateType, c as IEntitySnapshot, d as EntityEventSubscriptionOptions, f as EntityEventUid, g as IEventData, h as IEntityEventsManager, i as IEntityRepository, l as IEntitySnapshotProvider, m as IEntityEventsDispatcher, n as IEntityScheduler, o as IEntityUpdate, p as IEntityEvent, r as SchedulerPauseType, s as IEntityUpdateQueue, t as EntitySchedule, u as EntityEventSubscriptionFilter, v as IEntityConfigSnapshot } from "../index-BOsrKTWm.cjs";
-export { EntityEventSubscriptionFilter, EntityEventSubscriptionOptions, EntityEventUid, EntityProxy, EntitySchedule, EntityTypeUid, EntityUid, EntityUpdateType, IEntity, IEntityConfigSnapshot, IEntityContextCache, IEntityEvent, IEntityEventsDispatcher, IEntityEventsManager, IEntityModel, IEntityProxy, IEntityProxyRepository, IEntityRepository, IEntityScheduler, IEntitySnapshot, IEntitySnapshotProvider, IEntityUpdate, IEntityUpdateQueue, IEventData, RequiredProxies, SchedulerPauseType, TypedEntityProxy };
+import { _ as ModelOf, a as IEntityProxy, c as RequiredProxies, d as EntityUid, f as IEntity, g as IEntityWith, h as IEntitySpec, i as EntityProxyManyLookup, l as TypedEntityProxy, m as IEntityModelRef, n as EntityProxy, o as IEntityProxyRepository, p as IEntityModel, r as EntityProxyLookup, s as ProxyTypesOf, u as EntityTypeUid } from "../index-DMZSrHoB.cjs";
+import { S as SYSTEM_CONTEXT_KEY, _ as IEntityEventsDispatcher, a as IEntityDispatchGroup, b as IEntityConfigSnapshot, c as IEntityUpdate, d as IEntitySnapshotProvider, f as IEntityRepository, g as IEntityEvent, h as EntityEventUid, i as EntityUpdateType, l as SchedulerPauseType, m as EntityEventSubscriptionOptions, n as EntityRuntimePendingGroupOptions, o as IEntityRuntimeScheduler, p as EntityEventSubscriptionFilter, r as EntitySchedule, s as IEntityRuntimeSchedulerInspector, t as EntityPriorityModel, u as IEntitySnapshot, v as IEntityEventsManager, x as IContextRepository, y as IEventData } from "../index-CSaKdQe-.cjs";
+export { EntityEventSubscriptionFilter, EntityEventSubscriptionOptions, EntityEventUid, EntityPriorityModel, EntityProxy, EntityProxyLookup, EntityProxyManyLookup, EntityRuntimePendingGroupOptions, EntitySchedule, EntityTypeUid, EntityUid, EntityUpdateType, IContextRepository, IEntity, IEntityConfigSnapshot, IEntityDispatchGroup, IEntityEvent, IEntityEventsDispatcher, IEntityEventsManager, IEntityModel, IEntityModelRef, IEntityProxy, IEntityProxyRepository, IEntityRepository, IEntityRuntimeScheduler, IEntityRuntimeSchedulerInspector, IEntitySnapshot, IEntitySnapshotProvider, IEntitySpec, IEntityUpdate, IEntityWith, IEventData, ModelOf, ProxyTypesOf, RequiredProxies, SYSTEM_CONTEXT_KEY, SchedulerPauseType, TypedEntityProxy };

package/dist/entities/index.d.mts

@@ -1,3 +1,3 @@
-import { a as IEntity, c as IEntityProxy, d as TypedEntityProxy, i as EntityUid, l as IEntityProxyRepository, o as IEntityModel, r as EntityTypeUid, s as EntityProxy, u as RequiredProxies } from "../index-BlP67nCr.mjs";
-import { _ as IEntityContextCache, a as EntityUpdateType, c as IEntitySnapshot, d as EntityEventSubscriptionOptions, f as EntityEventUid, g as IEventData, h as IEntityEventsManager, i as IEntityRepository, l as IEntitySnapshotProvider, m as IEntityEventsDispatcher, n as IEntityScheduler, o as IEntityUpdate, p as IEntityEvent, r as SchedulerPauseType, s as IEntityUpdateQueue, t as EntitySchedule, u as EntityEventSubscriptionFilter, v as IEntityConfigSnapshot } from "../index-vpjRaGIC.mjs";
-export { EntityEventSubscriptionFilter, EntityEventSubscriptionOptions, EntityEventUid, EntityProxy, EntitySchedule, EntityTypeUid, EntityUid, EntityUpdateType, IEntity, IEntityConfigSnapshot, IEntityContextCache, IEntityEvent, IEntityEventsDispatcher, IEntityEventsManager, IEntityModel, IEntityProxy, IEntityProxyRepository, IEntityRepository, IEntityScheduler, IEntitySnapshot, IEntitySnapshotProvider, IEntityUpdate, IEntityUpdateQueue, IEventData, RequiredProxies, SchedulerPauseType, TypedEntityProxy };
+import { _ as ModelOf, a as IEntityProxy, c as RequiredProxies, d as EntityUid, f as IEntity, g as IEntityWith, h as IEntitySpec, i as EntityProxyManyLookup, l as TypedEntityProxy, m as IEntityModelRef, n as EntityProxy, o as IEntityProxyRepository, p as IEntityModel, r as EntityProxyLookup, s as ProxyTypesOf, u as EntityTypeUid } from "../index-Dbwzlrgp.mjs";
+import { S as SYSTEM_CONTEXT_KEY, _ as IEntityEventsDispatcher, a as IEntityDispatchGroup, b as IEntityConfigSnapshot, c as IEntityUpdate, d as IEntitySnapshotProvider, f as IEntityRepository, g as IEntityEvent, h as EntityEventUid, i as EntityUpdateType, l as SchedulerPauseType, m as EntityEventSubscriptionOptions, n as EntityRuntimePendingGroupOptions, o as IEntityRuntimeScheduler, p as EntityEventSubscriptionFilter, r as EntitySchedule, s as IEntityRuntimeSchedulerInspector, t as EntityPriorityModel, u as IEntitySnapshot, v as IEntityEventsManager, x as IContextRepository, y as IEventData } from "../index-BanhgPCc.mjs";
+export { EntityEventSubscriptionFilter, EntityEventSubscriptionOptions, EntityEventUid, EntityPriorityModel, EntityProxy, EntityProxyLookup, EntityProxyManyLookup, EntityRuntimePendingGroupOptions, EntitySchedule, EntityTypeUid, EntityUid, EntityUpdateType, IContextRepository, IEntity, IEntityConfigSnapshot, IEntityDispatchGroup, IEntityEvent, IEntityEventsDispatcher, IEntityEventsManager, IEntityModel, IEntityModelRef, IEntityProxy, IEntityProxyRepository, IEntityRepository, IEntityRuntimeScheduler, IEntityRuntimeSchedulerInspector, IEntitySnapshot, IEntitySnapshotProvider, IEntitySpec, IEntityUpdate, IEntityWith, IEventData, ModelOf, ProxyTypesOf, RequiredProxies, SYSTEM_CONTEXT_KEY, SchedulerPauseType, TypedEntityProxy };

package/dist/entities/index.mjs

@@ -1,34 +1,19 @@
-//#region src/entities/entity-queue.ts
-/**
-* Specifies the action to be performed on an entity.
-* Updates are categorized to enable different processing paths in the runtime.
-*/
+//#region src/entities/context-repository.ts
+const SYSTEM_CONTEXT_KEY = Symbol("systemContext");
+//#endregion
+//#region src/entities/entity-scheduler.ts
 let EntityUpdateType = /* @__PURE__ */ function(EntityUpdateType) {
-	/**
-	* Indicates the entity should be updated with new data.
-	*/
 	EntityUpdateType["update"] = "update";
-	/**
-	* Indicates the entity should be removed from the system.
-	*/
 	EntityUpdateType["remove"] = "remove";
 	return EntityUpdateType;
 }({});
-//#endregion
-//#region src/entities/entity-scheduler.ts
-/**
-* Controls which scheduling modes are paused.
-*/
 let SchedulerPauseType = /* @__PURE__ */ function(SchedulerPauseType) {
-	/** Pause both interval timers and frame subscriptions. */
 	SchedulerPauseType["full"] = "full";
-	/** Pause only frame subscriptions. Interval timers continue firing. */
 	SchedulerPauseType["perFrame"] = "perFrame";
-	/** Pause only interval timers. Frame subscriptions continue. */
 	SchedulerPauseType["intervals"] = "intervals";
 	return SchedulerPauseType;
 }({});
 //#endregion
-export { EntityUpdateType, SchedulerPauseType };
+export { EntityUpdateType, SYSTEM_CONTEXT_KEY, SchedulerPauseType };
 
 //# sourceMappingURL=index.mjs.map

package/dist/entities/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/entities/entity-queue.ts","../../src/entities/entity-scheduler.ts"],"sourcesContent":["import { IEntityModel } from './entity';\nimport { IEntityConfigSnapshot } from './entity-config';\nimport { IEntityProxy } from './entity-proxies';\nimport { IEntitySnapshot } from './entity-snapshot';\n\n/**\n * Specifies the action to be performed on an entity.\n * Updates are categorized to enable different processing paths in the runtime.\n */\nexport enum EntityUpdateType {\n  /**\n   * Indicates the entity should be updated with new data.\n   */\n  update = 'update',\n  /**\n   * Indicates the entity should be removed from the system.\n   */\n  remove = 'remove'\n}\n\n/**\n * Represents a queued entity state change or removal.\n * Updates flow through the system to be processed by entity update handlers.\n */\nexport interface IEntityUpdate {\n  /**\n   * The type of operation: update or remove.\n   */\n  readonly type: EntityUpdateType;\n\n  /**\n   * The entity being affected by this update.\n   */\n  readonly entity: IEntityProxy;\n\n  /**\n   * Optional model data for initialization or reconfiguration.\n   */\n  readonly model?: IEntityModel;\n\n  /**\n   * Optional serialized state to apply to the entity.\n   */\n  readonly snapshot?: IEntitySnapshot;\n\n  /**\n   * Optional config-only component state to apply to the entity.\n   * When present on an update, the runtime applies it after `snapshot` and\n   * includes the config system phase in the same tick.\n   */\n  readonly config?: IEntityConfigSnapshot;\n}\n\n/**\n * Queue interface for managing pending entity updates.\n * Different implementations may use different prioritization strategies (e.g., priority queues, FIFO, ordered by entity type).\n * Updates are consumed by the runtime and dispatched to appropriate entity systems.\n */\nexport interface IEntityUpdateQueue {\n  /**\n   * The current number of updates in the queue.\n   */\n  readonly size: number;\n\n  /**\n   * Adds an update to the queue for processing.\n   * @param change - The update to queue.\n   */\n  enqueue(change: IEntityUpdate): void;\n\n  /**\n   * Removes and returns the next update from the queue.\n   * The specific update returned depends on the queue's prioritization strategy.\n   * @returns The next queued update.\n   */\n  dequeue(): IEntityUpdate;\n\n  /**\n   * Views the next update without removing it.\n   * Useful for inspection before dequeuing.\n   * @returns The next update in the queue.\n   */\n  peek(): IEntityUpdate;\n\n  /**\n   * Returns a read-only snapshot of all queued updates without removing them.\n   * Useful for inspection/debugging UIs.\n   * @returns An array of all currently queued updates.\n   */\n  items(): ReadonlyArray<IEntityUpdate>;\n\n  /**\n   * Removes all updates from the queue.\n   */\n  clear(): void;\n}\n","import { EntityTypeUid } from './entity';\nimport { IEntityProxy } from './entity-proxies';\n\n/**\n * Describes a scheduled entity update, including the target entity and optional interval.\n */\nexport type EntitySchedule = {\n  readonly proxy: IEntityProxy;\n  readonly intervalMs?: number;\n};\n\n/**\n * Controls which scheduling modes are paused.\n */\nexport enum SchedulerPauseType {\n  /** Pause both interval timers and frame subscriptions. */\n  full = 'full',\n  /** Pause only frame subscriptions. Interval timers continue firing. */\n  perFrame = 'perFrame',\n  /** Pause only interval timers. Frame subscriptions continue. */\n  intervals = 'intervals'\n}\n\n/**\n * Manages time-based scheduling of entity updates.\n *\n * Entities can be scheduled with an interval (timer-driven) or without one (per-frame).\n * The runtime pulls pending entities each tick via the {@link pending} iterator,\n * which yields both per-frame subscriptions and interval entities whose timer has fired.\n */\nexport interface IEntityScheduler {\n  /**\n   * Returns all currently scheduled entities with their configuration.\n   * Useful for inspection and debugging.\n   */\n  readonly schedules: ReadonlyArray<EntitySchedule>;\n\n  /**\n   * Yields entities pending processing this tick: per-frame subscriptions\n   * followed by interval entities whose timer has fired since the last drain.\n   * Iterating drains the due interval buckets; a second iteration without\n   * timer advancement yields only per-frame subscriptions.\n   */\n  readonly pending: IterableIterator<IEntityProxy>;\n\n  /**\n   * The set of entities scheduled for per-frame updates (no interval).\n   */\n  readonly frameSubscriptions: ReadonlySet<IEntityProxy>;\n\n  /**\n   * Entity types currently excluded from {@link pending} iteration.\n   */\n  readonly skippedEntityTypes: ReadonlySet<EntityTypeUid>;\n\n  /**\n   * The number of entities currently awaiting processing:\n   * per-frame subscriptions (if not paused) plus interval entities whose timer has fired.\n   */\n  readonly pendingCount: number;\n\n  /**\n   * Whether the scheduler is currently paused in any mode.\n   */\n  readonly isPaused: boolean;\n\n  /**\n   * Registers or replaces an entity schedule.\n   * @param entityProxy - The entity to schedule.\n   * @param intervalMs - Update frequency in milliseconds. If omitted, the entity is scheduled per-frame.\n   */\n  schedule(entityProxy: IEntityProxy, intervalMs?: number): void;\n\n  /**\n   * Unregisters an entity from the scheduler.\n   * @param entityProxy - The entity to unschedule.\n   */\n  remove(entityProxy: IEntityProxy): void;\n\n  /**\n   * Checks if an entity is currently scheduled for updates.\n   * @param entityProxy - The entity to check.\n   * @returns True if the entity is scheduled, false otherwise.\n   */\n  has(entityProxy: IEntityProxy): boolean;\n\n  /**\n   * Removes all schedules and clears all timers.\n   */\n  clear(): void;\n\n  /**\n   * Excludes an entity type from {@link pending} iteration.\n   * Entities remain registered; only yielding is suppressed.\n   */\n  skipEntityType(entityType: EntityTypeUid): void;\n\n  /**\n   * Re-includes a previously skipped entity type in {@link pending} iteration.\n   */\n  unskipEntityType(entityType: EntityTypeUid): void;\n\n  /**\n   * Pauses the scheduler.\n   * @param type - Which scheduling modes to pause. Defaults to {@link SchedulerPauseType.full}.\n   */\n  pause(type?: SchedulerPauseType): void;\n\n  /**\n   * Resumes the scheduler from any paused state.\n   */\n  resume(): void;\n}\n"],"mappings":";;;;;AASA,IAAY,mBAAL,yBAAA,kBAAA;;;;CAIL,iBAAA,YAAA;;;;CAIA,iBAAA,YAAA;;AACF,EAAA,CAAA,CAAA;;;;;;ACJA,IAAY,qBAAL,yBAAA,oBAAA;;CAEL,mBAAA,UAAA;;CAEA,mBAAA,cAAA;;CAEA,mBAAA,eAAA;;AACF,EAAA,CAAA,CAAA"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/entities/context-repository.ts","../../src/entities/entity-scheduler.ts"],"sourcesContent":["import type { IEntityProxy } from './entity-proxies';\r\n\r\nexport const SYSTEM_CONTEXT_KEY = Symbol('systemContext');\r\n\r\nexport interface IContextRepository {\r\n  get<TContext>(proxy: IEntityProxy, key: string | symbol): TContext | undefined;\r\n  set<TContext>(proxy: IEntityProxy, key: string | symbol, context: TContext): TContext;\r\n  delete(proxy: IEntityProxy, key: string | symbol): boolean;\r\n  deleteAll(proxy: IEntityProxy): boolean;\r\n}\r\n","import { EntityTypeUid, IEntityModel } from './entity';\r\nimport { IEntityConfigSnapshot } from './entity-config';\r\nimport { IEntityEvent, IEventData } from './entity-events';\r\nimport { IEntityProxy } from './entity-proxies';\r\nimport { IEntitySnapshot } from './entity-snapshot';\r\n\r\nexport enum EntityUpdateType {\r\n  update = 'update',\r\n  remove = 'remove'\r\n}\r\n\r\nexport interface IEntityUpdate {\r\n  readonly type: EntityUpdateType;\r\n  readonly entity: IEntityProxy;\r\n  readonly model?: IEntityModel;\r\n  readonly snapshot?: IEntitySnapshot;\r\n  readonly config?: IEntityConfigSnapshot;\r\n}\r\n\r\nexport interface IEntityDispatchGroup {\r\n  readonly entityType: EntityTypeUid;\r\n  readonly updates: ReadonlyArray<IEntityUpdate>;\r\n  readonly dirtyUpdates: number;\r\n  readonly scheduledUpdates: number;\r\n  readonly removeUpdates: number;\r\n  readonly pipelineMask?: number;\r\n}\r\n\r\nexport type EntityRuntimePendingGroupOptions = {\r\n  readonly includeFrameSubscriptions?: boolean;\r\n};\r\n\r\nexport type EntitySchedule = {\r\n  readonly proxy: IEntityProxy;\r\n  readonly intervalMs?: number;\r\n};\r\n\r\nexport type EntityPriorityModel = {\r\n  readonly defaultPriority?: number;\r\n  readonly entityTypes?: ReadonlyMap<EntityTypeUid, number>;\r\n};\r\n\r\nexport enum SchedulerPauseType {\r\n  full = 'full',\r\n  perFrame = 'perFrame',\r\n  intervals = 'intervals'\r\n}\r\n\r\nexport interface IEntityRuntimeScheduler {\r\n  enqueue(update: IEntityUpdate): void;\r\n  enqueueEvent(entity: IEntityProxy, event: IEntityEvent<IEventData>): void;\r\n  enqueueEvents(entity: IEntityProxy, events: ReadonlyArray<IEntityEvent<IEventData>>): void;\r\n  clearDirtyUpdates(): void;\r\n\r\n  schedule(proxy: IEntityProxy, intervalMs?: number): void;\r\n  removeSchedule(proxy: IEntityProxy): void;\r\n  hasSchedule(proxy: IEntityProxy): boolean;\r\n  clearSchedules(): void;\r\n\r\n  takePendingGroups(\r\n    maxItems?: number,\r\n    options?: EntityRuntimePendingGroupOptions\r\n  ): ReadonlyArray<IEntityDispatchGroup>;\r\n\r\n  skipEntityType(entityType: EntityTypeUid): void;\r\n  unskipEntityType(entityType: EntityTypeUid): void;\r\n  pause(type?: SchedulerPauseType): void;\r\n  resume(): void;\r\n}\r\n\r\nexport interface IEntityRuntimeSchedulerInspector extends IEntityRuntimeScheduler {\r\n  readonly dirtyCount: number;\r\n  readonly frameSubscriptions: ReadonlySet<IEntityProxy>;\r\n  readonly isPaused: boolean;\r\n  readonly pauseType: SchedulerPauseType | null;\r\n  readonly pendingGroupCount: number;\r\n  readonly pendingCount: number;\r\n  readonly rawDirtyCount: number;\r\n  readonly schedules: ReadonlyArray<EntitySchedule>;\r\n  readonly skippedEntityTypes: ReadonlySet<EntityTypeUid>;\r\n\r\n  inspectDirtyUpdates(): ReadonlyArray<IEntityUpdate>;\r\n}\r\n"],"mappings":";AAEA,MAAa,qBAAqB,OAAO,eAAe;;;ACIxD,IAAY,mBAAL,yBAAA,kBAAA;CACL,iBAAA,YAAA;CACA,iBAAA,YAAA;;AACF,EAAA,CAAA,CAAA;AAiCA,IAAY,qBAAL,yBAAA,oBAAA;CACL,mBAAA,UAAA;CACA,mBAAA,cAAA;CACA,mBAAA,eAAA;;AACF,EAAA,CAAA,CAAA"}

package/dist/factories/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../src/factories/pipeline-factory.ts"],"sourcesContent":["import { IPipelineContext } from '../pipelines';\nimport { IPipeline } from '../pipelines/pipeline';\n\n/**\n * Category identifier for grouping performance metrics.\n * Typed as string to allow extension beyond the built-in {@link PipelineCategory} values.\n */\nexport type PipelineCategoryName = string;\n\n/**\n * Built-in metric categories for classifying pipeline and middleware performance entries.\n *\n * - `module` — System module pipelines (initialize, config, update, render, sync phases).\n * - `runtime` — Runtime orchestration pipeline and its middleware.\n * - `system` — Individual system middleware within a module pipeline.\n */\nexport enum PipelineCategory {\n  module = 'module',\n  runtime = 'runtime',\n  system = 'system'\n}\n\n/**\n * Options for identifying and categorizing performance metrics on pipelines.\n */\nexport type PipelineOptions = {\n  /** Display name for the pipeline in performance metrics. */\n  pipelineName: string;\n  /** Category assigned to pipeline-level metric entries. */\n  pipelineCategory: PipelineCategoryName;\n  /** Category assigned to per-middleware metric entries within this pipeline. */\n  middlewareCategory: PipelineCategoryName;\n};\n\n/**\n * Creates pipeline instances for various contexts.\n * Abstracts pipeline creation to support different implementations.\n * Used by the system to instantiate pipelines without coupling to specific implementations.\n */\nexport interface IPipelineFactory {\n  /**\n   * Creates a new pipeline for the specified context type.\n   * @template TContext - The context type for the pipeline. Must extend IPipelineContext.\n   * @param options - Optional performance metric options (name, category) for the pipeline.\n   * @returns A new pipeline instance ready for middleware registration.\n   */\n  createPipeline<TContext extends IPipelineContext>(options?: PipelineOptions): IPipeline<TContext>;\n}\n"],"mappings":";;;;;;;;;AAgBA,IAAY,mBAAL,yBAAA,kBAAA;CACL,iBAAA,YAAA;CACA,iBAAA,aAAA;CACA,iBAAA,YAAA;;AACF,EAAA,CAAA,CAAA"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/factories/pipeline-factory.ts"],"sourcesContent":["import type { IPipelineContext } from '../pipelines';\r\nimport { IPipeline } from '../pipelines/pipeline';\r\n\r\n/**\r\n * Category identifier for grouping performance metrics.\r\n * Typed as string to allow extension beyond the built-in {@link PipelineCategory} values.\r\n */\r\nexport type PipelineCategoryName = string;\r\n\r\n/**\r\n * Built-in metric categories for classifying pipeline and middleware performance entries.\r\n *\r\n * - `module` — System module pipelines (initialize, config, update, render, sync phases).\r\n * - `runtime` — Runtime orchestration pipeline and its middleware.\r\n * - `system` — Individual system middleware within a module pipeline.\r\n */\r\nexport enum PipelineCategory {\r\n  module = 'module',\r\n  runtime = 'runtime',\r\n  system = 'system'\r\n}\r\n\r\n/**\r\n * Options for identifying and categorizing performance metrics on pipelines.\r\n */\r\nexport type PipelineOptions = {\r\n  /** Display name for the pipeline in performance metrics. */\r\n  pipelineName: string;\r\n  /** Category assigned to pipeline-level metric entries. */\r\n  pipelineCategory: PipelineCategoryName;\r\n  /** Category assigned to per-middleware metric entries within this pipeline. */\r\n  middlewareCategory: PipelineCategoryName;\r\n};\r\n\r\n/**\r\n * Creates pipeline instances for various contexts.\r\n * Abstracts pipeline creation to support different implementations.\r\n * Used by the system to instantiate pipelines without coupling to specific implementations.\r\n */\r\nexport interface IPipelineFactory {\r\n  /**\r\n   * Creates a new pipeline for the specified context type.\r\n   * @template TContext - The context type for the pipeline. Must extend IPipelineContext.\r\n   * @param options - Optional performance metric options (name, category) for the pipeline.\r\n   * @returns A new pipeline instance ready for middleware registration.\r\n   */\r\n  createPipeline<TContext extends IPipelineContext>(options?: PipelineOptions): IPipeline<TContext>;\r\n}\r\n"],"mappings":";;;;;;;;;AAgBA,IAAY,mBAAL,yBAAA,kBAAA;CACL,iBAAA,YAAA;CACA,iBAAA,aAAA;CACA,iBAAA,YAAA;;AACF,EAAA,CAAA,CAAA"}

package/dist/factories/index.d.cts

@@ -1,2 +1,2 @@
-import { d as IPipelineFactory, f as PipelineCategory, h as IContextFactory, m as PipelineOptions, n as IRuntimeFactory, p as PipelineCategoryName, t as ISystemsFactory } from "../index-BJFNTFDd.cjs";
-export { IContextFactory, IPipelineFactory, IRuntimeFactory, ISystemsFactory, PipelineCategory, PipelineCategoryName, PipelineOptions };
+import { c as PipelineCategoryName, l as PipelineOptions, o as IPipelineFactory, s as PipelineCategory, t as ISystemsFactory, u as IContextFactory } from "../index-BivyWazf.cjs";
+export { IContextFactory, IPipelineFactory, ISystemsFactory, PipelineCategory, PipelineCategoryName, PipelineOptions };

package/dist/factories/index.d.mts

@@ -1,2 +1,2 @@
-import { d as IPipelineFactory, f as PipelineCategory, h as IContextFactory, m as PipelineOptions, n as IRuntimeFactory, p as PipelineCategoryName, t as ISystemsFactory } from "../index-BD7sDB60.mjs";
-export { IContextFactory, IPipelineFactory, IRuntimeFactory, ISystemsFactory, PipelineCategory, PipelineCategoryName, PipelineOptions };
+import { c as PipelineCategoryName, l as PipelineOptions, o as IPipelineFactory, s as PipelineCategory, t as ISystemsFactory, u as IContextFactory } from "../index-DGyDijY7.mjs";
+export { IContextFactory, IPipelineFactory, ISystemsFactory, PipelineCategory, PipelineCategoryName, PipelineOptions };

package/dist/factories/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/factories/pipeline-factory.ts"],"sourcesContent":["import { IPipelineContext } from '../pipelines';\nimport { IPipeline } from '../pipelines/pipeline';\n\n/**\n * Category identifier for grouping performance metrics.\n * Typed as string to allow extension beyond the built-in {@link PipelineCategory} values.\n */\nexport type PipelineCategoryName = string;\n\n/**\n * Built-in metric categories for classifying pipeline and middleware performance entries.\n *\n * - `module` — System module pipelines (initialize, config, update, render, sync phases).\n * - `runtime` — Runtime orchestration pipeline and its middleware.\n * - `system` — Individual system middleware within a module pipeline.\n */\nexport enum PipelineCategory {\n  module = 'module',\n  runtime = 'runtime',\n  system = 'system'\n}\n\n/**\n * Options for identifying and categorizing performance metrics on pipelines.\n */\nexport type PipelineOptions = {\n  /** Display name for the pipeline in performance metrics. */\n  pipelineName: string;\n  /** Category assigned to pipeline-level metric entries. */\n  pipelineCategory: PipelineCategoryName;\n  /** Category assigned to per-middleware metric entries within this pipeline. */\n  middlewareCategory: PipelineCategoryName;\n};\n\n/**\n * Creates pipeline instances for various contexts.\n * Abstracts pipeline creation to support different implementations.\n * Used by the system to instantiate pipelines without coupling to specific implementations.\n */\nexport interface IPipelineFactory {\n  /**\n   * Creates a new pipeline for the specified context type.\n   * @template TContext - The context type for the pipeline. Must extend IPipelineContext.\n   * @param options - Optional performance metric options (name, category) for the pipeline.\n   * @returns A new pipeline instance ready for middleware registration.\n   */\n  createPipeline<TContext extends IPipelineContext>(options?: PipelineOptions): IPipeline<TContext>;\n}\n"],"mappings":";;;;;;;;AAgBA,IAAY,mBAAL,yBAAA,kBAAA;CACL,iBAAA,YAAA;CACA,iBAAA,aAAA;CACA,iBAAA,YAAA;;AACF,EAAA,CAAA,CAAA"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/factories/pipeline-factory.ts"],"sourcesContent":["import type { IPipelineContext } from '../pipelines';\r\nimport { IPipeline } from '../pipelines/pipeline';\r\n\r\n/**\r\n * Category identifier for grouping performance metrics.\r\n * Typed as string to allow extension beyond the built-in {@link PipelineCategory} values.\r\n */\r\nexport type PipelineCategoryName = string;\r\n\r\n/**\r\n * Built-in metric categories for classifying pipeline and middleware performance entries.\r\n *\r\n * - `module` — System module pipelines (initialize, config, update, render, sync phases).\r\n * - `runtime` — Runtime orchestration pipeline and its middleware.\r\n * - `system` — Individual system middleware within a module pipeline.\r\n */\r\nexport enum PipelineCategory {\r\n  module = 'module',\r\n  runtime = 'runtime',\r\n  system = 'system'\r\n}\r\n\r\n/**\r\n * Options for identifying and categorizing performance metrics on pipelines.\r\n */\r\nexport type PipelineOptions = {\r\n  /** Display name for the pipeline in performance metrics. */\r\n  pipelineName: string;\r\n  /** Category assigned to pipeline-level metric entries. */\r\n  pipelineCategory: PipelineCategoryName;\r\n  /** Category assigned to per-middleware metric entries within this pipeline. */\r\n  middlewareCategory: PipelineCategoryName;\r\n};\r\n\r\n/**\r\n * Creates pipeline instances for various contexts.\r\n * Abstracts pipeline creation to support different implementations.\r\n * Used by the system to instantiate pipelines without coupling to specific implementations.\r\n */\r\nexport interface IPipelineFactory {\r\n  /**\r\n   * Creates a new pipeline for the specified context type.\r\n   * @template TContext - The context type for the pipeline. Must extend IPipelineContext.\r\n   * @param options - Optional performance metric options (name, category) for the pipeline.\r\n   * @returns A new pipeline instance ready for middleware registration.\r\n   */\r\n  createPipeline<TContext extends IPipelineContext>(options?: PipelineOptions): IPipeline<TContext>;\r\n}\r\n"],"mappings":";;;;;;;;AAgBA,IAAY,mBAAL,yBAAA,kBAAA;CACL,iBAAA,YAAA;CACA,iBAAA,aAAA;CACA,iBAAA,YAAA;;AACF,EAAA,CAAA,CAAA"}

package/dist/{index-CeqaKmWR.d.mts → index-B3DqdxE6.d.mts}

@@ -1,4 +1,4 @@
-import { r as Immutable } from "./types-C1ojaDL4.mjs";
+import { r as Immutable } from "./types-BaCGIrym.mjs";
 
 //#region src/pipelines/pipeline-context.d.ts
 /**
@@ -7,16 +7,16 @@ import { r as Immutable } from "./types-C1ojaDL4.mjs";
  */
 interface IPipelineContext {
   /**
-   * The runtime state and control interface for the pipeline.
+   * The dispatch state and control interface for the pipeline.
    * Allows middleware to query and influence pipeline behavior.
    */
-  readonly runtime?: PipelineRuntime;
+  readonly dispatch?: PipelineDispatch;
 }
 /**
- * Runtime state and control interface for pipeline execution.
+ * Dispatch state and control interface for pipeline execution.
  * Allows middleware to query status and influence pipeline flow.
  */
-type PipelineRuntime = {
+type PipelineDispatch = {
   /**
    * Flag to request pipeline halt.
    * Set to true to stop executing remaining middleware (cleanup still runs).
@@ -25,7 +25,7 @@ type PipelineRuntime = {
   /**
    * Optional error state if an exception occurred during execution.
    */
-  error?: any;
+  error?: unknown;
 };
 //#endregion
 //#region src/pipelines/middleware.d.ts
@@ -198,12 +198,12 @@ interface IPipelineRunner<TContext extends IPipelineContext> {
   /**
    * Executes the action phase of all middleware in sequence.
    * Middleware at startIndex and onward are executed in order.
-   * Execution may terminate early if middleware requests it via context.runtime.shouldStop.
+   * Execution may terminate early if middleware requests it via context.dispatch.shouldStop.
    * @param context - The context passed to each middleware action.
    * @param middleware - The ordered middleware array to execute.
    * @param startIndex - Optional starting position in the middleware array (default: 0).
    */
-  dispatch(context: Partial<TContext>, middleware: IMiddleware<TContext>[], startIndex?: number): void | Promise<void>;
+  dispatch(context: Partial<TContext>, middleware: readonly IMiddleware<TContext>[], startIndex?: number): void | Promise<void>;
   /**
    * Executes the cleanup phase of all middleware in reverse order.
    * All middleware cleanup functions are called (if defined), regardless of errors.
@@ -211,8 +211,8 @@ interface IPipelineRunner<TContext extends IPipelineContext> {
    * @param context - The context passed to each middleware cleanup.
    * @param middleware - The ordered middleware array for cleanup (reversed during execution).
    */
-  cleanup(context: Partial<TContext>, middleware: IMiddleware<TContext>[]): void | Promise<void>;
+  cleanup(context: Partial<TContext>, middleware: readonly IMiddleware<TContext>[]): void | Promise<void>;
 }
 //#endregion
-export { IParentMiddleware as a, IMiddleware as c, IParentContext as i, IPipelineContext as l, INestedContext as n, IPipeline as o, INestedMiddleware as r, IMiddlewareRunner as s, IPipelineRunner as t, PipelineRuntime as u };
-//# sourceMappingURL=index-CeqaKmWR.d.mts.map
+export { IParentMiddleware as a, IMiddleware as c, IParentContext as i, IPipelineContext as l, INestedContext as n, IPipeline as o, INestedMiddleware as r, IMiddlewareRunner as s, IPipelineRunner as t, PipelineDispatch as u };
+//# sourceMappingURL=index-B3DqdxE6.d.mts.map