@awesome-ecs/abstract 0.33.0 → 0.34.0

package/README.md

@@ -1,124 +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-runtime-scheduler.ts`: `IEntityUpdate` and `IEntityRuntimeScheduler` for dirty mailboxes, cadence, and batched runtime dispatch
-- `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 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 ConfigOption, g as ConfigCustomControlOptions, h as IComponentWithConfig, m as IComponent, n as IdentityComponent, p as ComponentTypeUid, t as BasicComponentType, v as ConfigRecord } from "../index-HeCQLTSE.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 ConfigOption, g as ConfigCustomControlOptions, h as IComponentWithConfig, m as IComponent, n as IdentityComponent, p as ComponentTypeUid, t as BasicComponentType, v as ConfigRecord } from "../index-Tznk33g6.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,4 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/entities/context-repository.ts
+const SYSTEM_CONTEXT_KEY = Symbol("systemContext");
+//#endregion
 //#region src/entities/entity-scheduler.ts
 let EntityUpdateType = /* @__PURE__ */ function(EntityUpdateType) {
 	EntityUpdateType["update"] = "update";
@@ -13,6 +16,7 @@ let SchedulerPauseType = /* @__PURE__ */ function(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-scheduler.ts"],"sourcesContent":["import { EntityTypeUid, EntityUid, IEntity, IEntityModel } from './entity';\nimport { IEntityConfigSnapshot } from './entity-config';\nimport { IEntityEvent, IEventData } from './entity-events';\nimport { IEntityProxy } from './entity-proxies';\nimport { IEntitySnapshot } from './entity-snapshot';\n\nexport enum EntityUpdateType {\n  update = 'update',\n  remove = 'remove'\n}\n\nexport interface IEntityUpdate {\n  readonly type: EntityUpdateType;\n  readonly entity: IEntityProxy;\n  readonly model?: IEntityModel;\n  readonly snapshot?: IEntitySnapshot;\n  readonly config?: IEntityConfigSnapshot;\n}\n\nexport interface IEntityDispatchGroup {\n  readonly entityType: EntityTypeUid;\n  readonly updates: ReadonlyArray<IEntityUpdate>;\n  readonly dirtyUpdates: number;\n  readonly scheduledUpdates: number;\n  readonly removeUpdates: number;\n  readonly pipelineMask?: number;\n}\n\nexport type EntityRuntimePendingGroupOptions = {\n  readonly includeFrameSubscriptions?: boolean;\n};\n\nexport type EntitySchedule = {\n  readonly proxy: IEntityProxy;\n  readonly intervalMs?: number;\n};\n\nexport type EntityPriorityModel = {\n  readonly defaultPriority?: number;\n  readonly entityTypes?: ReadonlyMap<EntityTypeUid, number>;\n};\n\nexport enum SchedulerPauseType {\n  full = 'full',\n  perFrame = 'perFrame',\n  intervals = 'intervals'\n}\n\nexport interface IEntityRuntimeScheduler {\n  readonly dirtyCount: number;\n  readonly rawDirtyCount: number;\n  readonly pendingCount: number;\n\n  enqueue(update: IEntityUpdate): void;\n  enqueueEvent(entity: IEntityProxy, event: IEntityEvent<IEventData>): void;\n  enqueueEvents(entity: IEntityProxy, events: ReadonlyArray<IEntityEvent<IEventData>>): void;\n\n  schedule(proxy: IEntityProxy, intervalMs?: number): void;\n  removeSchedule(proxy: IEntityProxy): void;\n  hasSchedule(proxy: IEntityProxy): boolean;\n\n  takePendingGroups(\n    maxItems?: number,\n    options?: EntityRuntimePendingGroupOptions\n  ): ReadonlyArray<IEntityDispatchGroup>;\n}\n"],"mappings":";;AAMA,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"}
+{"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 RequiredProxies, f as TypedEntityProxy, i as EntityUid, l as IEntityProxyRepository, o as IEntityModel, r as EntityTypeUid, s as EntityProxy, u as ProxyTypesOf } from "../index-HeCQLTSE.cjs";
-import { _ as IEntityEventsManager, a as IEntityDispatchGroup, b as IEntityConfigSnapshot, c as SchedulerPauseType, d as IEntityRepository, f as EntityEventSubscriptionFilter, g as IEntityEventsDispatcher, h as IEntityEvent, i as EntityUpdateType, l as IEntitySnapshot, m as EntityEventUid, n as EntityRuntimePendingGroupOptions, o as IEntityRuntimeScheduler, p as EntityEventSubscriptionOptions, r as EntitySchedule, s as IEntityUpdate, t as EntityPriorityModel, u as IEntitySnapshotProvider, v as IEventData, y as IEntityContextCache } from "../index-0hg5PXZe.cjs";
-export { EntityEventSubscriptionFilter, EntityEventSubscriptionOptions, EntityEventUid, EntityPriorityModel, EntityProxy, EntityRuntimePendingGroupOptions, EntitySchedule, EntityTypeUid, EntityUid, EntityUpdateType, IEntity, IEntityConfigSnapshot, IEntityContextCache, IEntityDispatchGroup, IEntityEvent, IEntityEventsDispatcher, IEntityEventsManager, IEntityModel, IEntityProxy, IEntityProxyRepository, IEntityRepository, IEntityRuntimeScheduler, IEntitySnapshot, IEntitySnapshotProvider, IEntityUpdate, IEventData, ProxyTypesOf, 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 RequiredProxies, f as TypedEntityProxy, i as EntityUid, l as IEntityProxyRepository, o as IEntityModel, r as EntityTypeUid, s as EntityProxy, u as ProxyTypesOf } from "../index-Tznk33g6.mjs";
-import { _ as IEntityEventsManager, a as IEntityDispatchGroup, b as IEntityConfigSnapshot, c as SchedulerPauseType, d as IEntityRepository, f as EntityEventSubscriptionFilter, g as IEntityEventsDispatcher, h as IEntityEvent, i as EntityUpdateType, l as IEntitySnapshot, m as EntityEventUid, n as EntityRuntimePendingGroupOptions, o as IEntityRuntimeScheduler, p as EntityEventSubscriptionOptions, r as EntitySchedule, s as IEntityUpdate, t as EntityPriorityModel, u as IEntitySnapshotProvider, v as IEventData, y as IEntityContextCache } from "../index--9JJtMKF.mjs";
-export { EntityEventSubscriptionFilter, EntityEventSubscriptionOptions, EntityEventUid, EntityPriorityModel, EntityProxy, EntityRuntimePendingGroupOptions, EntitySchedule, EntityTypeUid, EntityUid, EntityUpdateType, IEntity, IEntityConfigSnapshot, IEntityContextCache, IEntityDispatchGroup, IEntityEvent, IEntityEventsDispatcher, IEntityEventsManager, IEntityModel, IEntityProxy, IEntityProxyRepository, IEntityRepository, IEntityRuntimeScheduler, IEntitySnapshot, IEntitySnapshotProvider, IEntityUpdate, IEventData, ProxyTypesOf, 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,3 +1,6 @@
+//#region src/entities/context-repository.ts
+const SYSTEM_CONTEXT_KEY = Symbol("systemContext");
+//#endregion
 //#region src/entities/entity-scheduler.ts
 let EntityUpdateType = /* @__PURE__ */ function(EntityUpdateType) {
 	EntityUpdateType["update"] = "update";
@@ -11,6 +14,6 @@ let SchedulerPauseType = /* @__PURE__ */ function(SchedulerPauseType) {
 	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-scheduler.ts"],"sourcesContent":["import { EntityTypeUid, EntityUid, IEntity, IEntityModel } from './entity';\nimport { IEntityConfigSnapshot } from './entity-config';\nimport { IEntityEvent, IEventData } from './entity-events';\nimport { IEntityProxy } from './entity-proxies';\nimport { IEntitySnapshot } from './entity-snapshot';\n\nexport enum EntityUpdateType {\n  update = 'update',\n  remove = 'remove'\n}\n\nexport interface IEntityUpdate {\n  readonly type: EntityUpdateType;\n  readonly entity: IEntityProxy;\n  readonly model?: IEntityModel;\n  readonly snapshot?: IEntitySnapshot;\n  readonly config?: IEntityConfigSnapshot;\n}\n\nexport interface IEntityDispatchGroup {\n  readonly entityType: EntityTypeUid;\n  readonly updates: ReadonlyArray<IEntityUpdate>;\n  readonly dirtyUpdates: number;\n  readonly scheduledUpdates: number;\n  readonly removeUpdates: number;\n  readonly pipelineMask?: number;\n}\n\nexport type EntityRuntimePendingGroupOptions = {\n  readonly includeFrameSubscriptions?: boolean;\n};\n\nexport type EntitySchedule = {\n  readonly proxy: IEntityProxy;\n  readonly intervalMs?: number;\n};\n\nexport type EntityPriorityModel = {\n  readonly defaultPriority?: number;\n  readonly entityTypes?: ReadonlyMap<EntityTypeUid, number>;\n};\n\nexport enum SchedulerPauseType {\n  full = 'full',\n  perFrame = 'perFrame',\n  intervals = 'intervals'\n}\n\nexport interface IEntityRuntimeScheduler {\n  readonly dirtyCount: number;\n  readonly rawDirtyCount: number;\n  readonly pendingCount: number;\n\n  enqueue(update: IEntityUpdate): void;\n  enqueueEvent(entity: IEntityProxy, event: IEntityEvent<IEventData>): void;\n  enqueueEvents(entity: IEntityProxy, events: ReadonlyArray<IEntityEvent<IEventData>>): void;\n\n  schedule(proxy: IEntityProxy, intervalMs?: number): void;\n  removeSchedule(proxy: IEntityProxy): void;\n  hasSchedule(proxy: IEntityProxy): boolean;\n\n  takePendingGroups(\n    maxItems?: number,\n    options?: EntityRuntimePendingGroupOptions\n  ): ReadonlyArray<IEntityDispatchGroup>;\n}\n"],"mappings":";AAMA,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"}
+{"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 type { 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 { _ as PipelineCategoryName, g as PipelineCategory, h as IPipelineFactory, t as ISystemsFactory, v as PipelineOptions, y as IContextFactory } from "../index-CPGVaS-_.cjs";
+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 { _ as PipelineCategoryName, g as PipelineCategory, h as IPipelineFactory, t as ISystemsFactory, v as PipelineOptions, y as IContextFactory } from "../index-BOS-47DQ.mjs";
+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 type { 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-DXbpfhHa.d.mts → index-B3DqdxE6.d.mts}

@@ -1,4 +1,4 @@
-import { r as Immutable } from "./types-UnqKSA14.mjs";
+import { r as Immutable } from "./types-BaCGIrym.mjs";
 
 //#region src/pipelines/pipeline-context.d.ts
 /**
@@ -215,4 +215,4 @@ interface IPipelineRunner<TContext extends IPipelineContext> {
 }
 //#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, PipelineDispatch as u };
-//# sourceMappingURL=index-DXbpfhHa.d.mts.map
+//# sourceMappingURL=index-B3DqdxE6.d.mts.map

package/dist/{index--9JJtMKF.d.mts → index-BanhgPCc.d.mts}

@@ -1,6 +1,15 @@
-import { a as IEntity, c as IEntityProxy, i as EntityUid, m as IComponent, n as IdentityComponent, o as IEntityModel, p as ComponentTypeUid, r as EntityTypeUid, v as ConfigRecord } from "./index-Tznk33g6.mjs";
-import { n as DeepPartial } from "./types-UnqKSA14.mjs";
+import { T as ConfigRecord, a as IEntityProxy, b as ComponentTypeUid, f as IEntity, p as IEntityModel, u as EntityTypeUid, x as IComponent, y as IdentityComponent } from "./index-Dbwzlrgp.mjs";
+import { n as DeepPartial } from "./types-BaCGIrym.mjs";
 
+//#region src/entities/context-repository.d.ts
+declare const SYSTEM_CONTEXT_KEY: unique symbol;
+interface IContextRepository {
+  get<TContext>(proxy: IEntityProxy, key: string | symbol): TContext | undefined;
+  set<TContext>(proxy: IEntityProxy, key: string | symbol, context: TContext): TContext;
+  delete(proxy: IEntityProxy, key: string | symbol): boolean;
+  deleteAll(proxy: IEntityProxy): boolean;
+}
+//#endregion
 //#region src/entities/entity-config.d.ts
 /**
  * Config-only entity state update.
@@ -14,18 +23,6 @@ interface IEntityConfigSnapshot<TConfig extends ConfigRecord = ConfigRecord> {
   readonly components: Record<ComponentTypeUid, DeepPartial<TConfig>>;
 }
 //#endregion
-//#region src/entities/entity-context-cache.d.ts
-/**
- * Flat per-entity key-value storage for runtime-owned cached context objects.
- */
-interface IEntityContextCache {
-  get<T>(entityUid: EntityUid, key: string | symbol): T | undefined;
-  set(entityUid: EntityUid, key: string | symbol, value: unknown): void;
-  has(entityUid: EntityUid, key?: string | symbol): boolean;
-  getEntries(entityUid: EntityUid): IterableIterator<[string | symbol, unknown]> | undefined;
-  disposeEntity(entityUid: EntityUid): void;
-}
-//#endregion
 //#region src/entities/entity-events.d.ts
 /**
  * Represents a unique identifier for an entity event.
@@ -193,14 +190,14 @@ interface IEntityRepository {
    * @param proxy - Reference to the entity to retrieve.
    * @returns The requested entity.
    */
-  get<TEntity extends IEntity>(proxy: IEntityProxy): TEntity;
+  getEntity<TEntity extends IEntity>(proxy: IEntityProxy): TEntity | undefined;
   /**
    * Retrieves all entities of a specific type.
    * @template TEntity - The entity type to retrieve.
    * @param entityType - The type identifier to filter by.
    * @returns Array of all entities matching the type.
    */
-  getAll<TEntity extends IEntity>(entityType: EntityTypeUid): TEntity[];
+  getEntities<TEntity extends IEntity>(entityType: EntityTypeUid): TEntity[];
   /**
    * Iterates over all entities regardless of type.
    * @returns An iterator over all stored entities.
@@ -210,7 +207,7 @@ interface IEntityRepository {
    * Stores or updates an entity.
    * @param entity - The entity to store.
    */
-  set(entity: IEntity): void;
+  set<TEntity extends IEntity>(entity: TEntity): TEntity;
   /**
    * Removes an entity from storage.
    * @param proxy - Reference to the entity to remove.
@@ -307,17 +304,32 @@ declare enum SchedulerPauseType {
   intervals = "intervals"
 }
 interface IEntityRuntimeScheduler {
-  readonly dirtyCount: number;
-  readonly rawDirtyCount: number;
-  readonly pendingCount: number;
   enqueue(update: IEntityUpdate): void;
   enqueueEvent(entity: IEntityProxy, event: IEntityEvent<IEventData>): void;
   enqueueEvents(entity: IEntityProxy, events: ReadonlyArray<IEntityEvent<IEventData>>): void;
+  clearDirtyUpdates(): void;
   schedule(proxy: IEntityProxy, intervalMs?: number): void;
   removeSchedule(proxy: IEntityProxy): void;
   hasSchedule(proxy: IEntityProxy): boolean;
+  clearSchedules(): void;
   takePendingGroups(maxItems?: number, options?: EntityRuntimePendingGroupOptions): ReadonlyArray<IEntityDispatchGroup>;
+  skipEntityType(entityType: EntityTypeUid): void;
+  unskipEntityType(entityType: EntityTypeUid): void;
+  pause(type?: SchedulerPauseType): void;
+  resume(): void;
+}
+interface IEntityRuntimeSchedulerInspector extends IEntityRuntimeScheduler {
+  readonly dirtyCount: number;
+  readonly frameSubscriptions: ReadonlySet<IEntityProxy>;
+  readonly isPaused: boolean;
+  readonly pauseType: SchedulerPauseType | null;
+  readonly pendingGroupCount: number;
+  readonly pendingCount: number;
+  readonly rawDirtyCount: number;
+  readonly schedules: ReadonlyArray<EntitySchedule>;
+  readonly skippedEntityTypes: ReadonlySet<EntityTypeUid>;
+  inspectDirtyUpdates(): ReadonlyArray<IEntityUpdate>;
 }
 //#endregion
-export { IEntityEventsManager as _, IEntityDispatchGroup as a, IEntityConfigSnapshot as b, SchedulerPauseType as c, IEntityRepository as d, EntityEventSubscriptionFilter as f, IEntityEventsDispatcher as g, IEntityEvent as h, EntityUpdateType as i, IEntitySnapshot as l, EntityEventUid as m, EntityRuntimePendingGroupOptions as n, IEntityRuntimeScheduler as o, EntityEventSubscriptionOptions as p, EntitySchedule as r, IEntityUpdate as s, EntityPriorityModel as t, IEntitySnapshotProvider as u, IEventData as v, IEntityContextCache as y };
-//# sourceMappingURL=index--9JJtMKF.d.mts.map
+export { SYSTEM_CONTEXT_KEY as S, IEntityEventsDispatcher as _, IEntityDispatchGroup as a, IEntityConfigSnapshot as b, IEntityUpdate as c, IEntitySnapshotProvider as d, IEntityRepository as f, IEntityEvent as g, EntityEventUid as h, EntityUpdateType as i, SchedulerPauseType as l, EntityEventSubscriptionOptions as m, EntityRuntimePendingGroupOptions as n, IEntityRuntimeScheduler as o, EntityEventSubscriptionFilter as p, EntitySchedule as r, IEntityRuntimeSchedulerInspector as s, EntityPriorityModel as t, IEntitySnapshot as u, IEntityEventsManager as v, IContextRepository as x, IEventData as y };
+//# sourceMappingURL=index-BanhgPCc.d.mts.map