@awesome-ecs/abstract 0.32.1 → 0.33.0

package/dist/{index-BJFNTFDd.d.cts → index-CPGVaS-_.d.cts}

@@ -1,7 +1,7 @@
-import { _ as ConfigRecord, a as IEntity, c as IEntityProxy, f as ComponentTypeUid, i as EntityUid, l as IEntityProxyRepository, o as IEntityModel, r as EntityTypeUid, s as EntityProxy } from "./index-C5nragoq.cjs";
-import { r as Immutable } from "./types-Bbmnq4ni.cjs";
-import { c as IEntitySnapshot, d as EntityEventSubscriptionOptions, f as EntityEventUid, g as IEventData, o as IEntityUpdate, p as IEntityEvent, v as IEntityConfigSnapshot } from "./index-BOsrKTWm.cjs";
-import { c as IMiddleware, l as IPipelineContext, o as IPipeline, u as PipelineRuntime } from "./index-DMTkNY1e.cjs";
+import { a as IEntity, c as IEntityProxy, i as EntityUid, o as IEntityModel, p as ComponentTypeUid, r as EntityTypeUid, s as EntityProxy, v as ConfigRecord } from "./index-HeCQLTSE.cjs";
+import { r as Immutable } from "./types-COxeVghs.cjs";
+import { b as IEntityConfigSnapshot, h as IEntityEvent, l as IEntitySnapshot, m as EntityEventUid, p as EntityEventSubscriptionOptions, s as IEntityUpdate, v as IEventData } from "./index-0hg5PXZe.cjs";
+import { c as IMiddleware, l as IPipelineContext, o as IPipeline, u as PipelineDispatch } from "./index-Bl7Cf9gi.cjs";
 
 //#region src/utils/logger.d.ts
 /**
@@ -142,14 +142,25 @@ type MiddlewareRegistryReadonly = ReadonlyMap<SystemMiddlewareName, SystemModule
  * @template TEntity - The entity type this middleware handles.
  */
 type ISystemMiddleware<TEntity extends IEntity> = IMiddleware<ISystemContext<TEntity>>;
+/**
+ * Event-routed middleware. Unlike normal system middleware, event middleware is
+ * invoked once per matching event instance and receives that event explicitly.
+ */
+interface ISystemEventMiddleware<TEntity extends IEntity, TEventData extends IEventData = IEventData> {
+  readonly name?: string;
+  shouldRun?(context: ISystemContext<TEntity>, event: IEntityEvent<TEventData>): boolean;
+  action(context: ISystemContext<TEntity>, event: IEntityEvent<TEventData>): void | Promise<void>;
+  cleanup?(context: ISystemContext<TEntity>): void | Promise<void>;
+}
 //#endregion
 //#region src/systems/pipeline/system-context-control.d.ts
+interface SystemContextControlTarget {
+  readonly name?: string;
+}
 declare enum SystemContextControlState {
   none = "none",
   enableCurrentSystem = "enableCurrentSystem",
-  disableCurrentSystem = "disableCurrentSystem",
-  enableCurrentModule = "enableCurrentModule",
-  disableCurrentModule = "disableCurrentModule"
+  disableCurrentSystem = "disableCurrentSystem"
 }
 /**
  * Interface for controlling the execution of systems and modules within a system context.
@@ -165,13 +176,13 @@ interface ISystemContextControl {
    */
   enableCurrentSystem(): void;
   /**
-   * Disables the current module for the current entity.
+   * Disables a module for the current entity.
    */
-  disableCurrentModule(): void;
+  disableModule(name: SystemModuleName): void;
   /**
-   * Re-enables the current module for the current entity.
+   * Re-enables a module for the current entity.
    */
-  enableCurrentModule(): void;
+  enableModule(name: SystemModuleName): void;
 }
 /**
  * Extended system context interface that includes control state for middleware to manage system and module execution.
@@ -187,33 +198,32 @@ interface ISystemContextControlState extends ISystemContextControl {
    * @param middleware - The middleware to check for disabled state.
    * @returns True if the specified middleware is currently disabled, false otherwise.
    */
-  isMiddlewareDisabled(middleware: ISystemMiddleware<IEntity>): boolean;
+  isMiddlewareDisabled(middleware: SystemContextControlTarget): boolean;
   /**
    * Disables a specific middleware in the context.
    * @param middleware - The middleware to disable.
    */
-  disableMiddleware(middleware: ISystemMiddleware<IEntity>): void;
+  disableMiddleware(middleware: SystemContextControlTarget): void;
   /**
    * Enables a specific middleware in the context.
    * @param middleware - The middleware to enable.
    */
-  enableMiddleware(middleware: ISystemMiddleware<IEntity>): void;
+  enableMiddleware(middleware: SystemContextControlTarget): void;
   /**
-   * Disables an entire module of middleware in the context.
-   * @param middleware - A middleware from the module to disable.
+   * Registers an event subscription owned by a module. This is runtime-only state:
+   * disabling the module should also detach its event subscriptions.
    */
-  disableModule(middleware: ISystemMiddleware<IEntity>): void;
+  registerModuleEvent(moduleName: SystemModuleName, eventUid: EntityEventUid, options?: EntityEventSubscriptionOptions): void;
   /**
-   * Enables an entire module of middleware in the context.
-   * @param middleware - A middleware from the module to enable.
+   * Clears all runtime-owned module event subscriptions for the current entity.
    */
-  enableModule(middleware: ISystemMiddleware<IEntity>): void;
+  clearModuleEvents(): void;
 }
 //#endregion
 //#region src/systems/pipeline/system-context-events.d.ts
 /**
  * System context API for event-driven entity communication.
- * Allows middleware to dispatch events, manage subscriptions, and query event state.
+ * System middleware can dispatch events, while subscriptions are owned by the runtime.
  * Events enable decoupled communication between distant or unrelated entities.
  */
 interface ISystemContextEvents {
@@ -243,56 +253,10 @@ interface ISystemContextEvents {
    * @param data - Array of event payloads to broadcast.
    */
   broadcastEvents<TEventData extends IEventData>(data: TEventData[]): void;
-  /**
-   * Retrieves an event from the current context by its identifier.
-   * Useful for checking if an event was received this frame.
-   * @param uid - The event type identifier.
-   * @returns The event if present, undefined otherwise.
-   */
-  getEvent<TEventData extends IEventData>(uid: EntityEventUid): IEntityEvent<TEventData> | undefined;
-  /**
-   * Retrieves all events currently set on this context.
-   * Events are cleared between frames.
-   * @returns Array of all active events for this context.
-   */
-  listEvents<TEventData extends IEventData>(): IEntityEvent<TEventData>[];
-  /**
-   * Checks if a specific event is present in the current context.
-   * If no uid is provided, checks if any events exist.
-   * @param uid - Optional event type to check for. If omitted, checks for any event.
-   * @returns True if matching event(s) found, false otherwise.
-   */
-  hasEvent(uid?: EntityEventUid): boolean;
-  /**
-   * Subscribes to events of a specific type.
-   * The entity will be notified of matching events through the update system.
-   * @param uid - The event type to listen for.
-   * @param options - Optional subscription options (filter, scopeId).
-   */
+}
+interface IMutableSystemContextEvents extends ISystemContextEvents {
   subscribeTo(uid: EntityEventUid, options?: EntityEventSubscriptionOptions): void;
-  /**
-   * Stops listening for events of a specific type.
-   * @param uid - The event type to stop listening for.
-   */
   unsubscribeFrom(uid: EntityEventUid): void;
-  /**
-   * Adds events to the current context for processing by this and downstream middleware.
-   * @param events - Event array to add to context.
-   */
-  setContextEvents(events: IEntityEvent<IEventData>[]): void;
-  /**
-   * Adds a single event to the current context.
-   * @param event - Event to add to context.
-   */
-  setContextEvent(event: IEntityEvent<IEventData>): void;
-  /**
-   * Removes all events from the current context.
-   */
-  clearContextEvents(): void;
-  /**
-   * Clears all event subscriptions for the current entity.
-   */
-  clearSubscriptions(): void;
 }
 //#endregion
 //#region src/systems/pipeline/system-context-proxies.d.ts
@@ -484,52 +448,52 @@ interface ISystemContext<TEntity extends IEntity> extends IPipelineContext {
    * Time elapsed since the last system update for this entity, in milliseconds.
    * Useful for time-based calculations and animations.
    */
-  readonly deltaTimeMs: Immutable<number>;
+  readonly deltaTimeMs: number;
   /**
    * The entity currently being processed by this middleware.
    */
-  readonly entity: Immutable<TEntity>;
+  readonly entity: TEntity;
   /**
    * Config metadata and config-update API for the current update.
    */
-  readonly config: Immutable<ISystemContextConfigReadonly>;
+  readonly config: ISystemContextConfigReadonly;
   /**
    * Information about the update triggering this system execution.
    * Contains type (update/remove) and optional model/snapshot data.
    */
-  readonly update: Immutable<IEntityUpdate>;
+  readonly update: IEntityUpdate;
   /**
-   * Event system API for publishing and subscribing to entity events.
+   * Event system API for publishing entity events.
    */
-  readonly events: Immutable<ISystemContextEvents>;
+  readonly events: ISystemContextEvents;
   /**
    * Logging interface for debug and diagnostic output.
    */
-  readonly logger: Immutable<ILogger>;
+  readonly logger: ILogger;
   /**
    * Proxy management API for establishing and managing entity relationships.
    */
-  readonly proxies: Immutable<ISystemContextProxies>;
+  readonly proxies: ISystemContextProxies;
   /**
    * Repository access API for querying and modifying entity storage.
    */
-  readonly repository: Immutable<ISystemContextRepository>;
+  readonly repository: ISystemContextRepository;
   /**
    * Scheduling API for requesting follow-up entity updates.
    */
-  readonly scheduler: Immutable<ISystemContextScheduler>;
+  readonly scheduler: ISystemContextScheduler;
   /**
    * Snapshot management API for serialization and state transfer.
    */
-  readonly snapshot: Immutable<ISystemContextSnapshot>;
+  readonly snapshot: ISystemContextSnapshot;
   /**
    * Control API for enabling/disabling the current system or entire module during execution.
    */
-  readonly systems: Immutable<ISystemContextControl>;
+  readonly systems: ISystemContextControl;
   /**
-   * The per-entity runtime state and control interface for this system context.
+   * The per-entity dispatch state and control interface for this system context.
    */
-  readonly runtime: PipelineRuntime;
+  readonly dispatch: PipelineDispatch;
 }
 //#endregion
 //#region src/systems/pipeline/system-context-mutable.d.ts
@@ -541,9 +505,58 @@ interface ISystemContext<TEntity extends IEntity> extends IPipelineContext {
  * @template TEntity - The specific entity type this context operates on.
  */
 interface IMutableSystemContext<TEntity extends IEntity> extends ISystemContext<TEntity> {
+  readonly events: IMutableSystemContextEvents;
   setUpdate(update: IEntityUpdate): void;
   setDeltaTime(deltaTimeMs: number): void;
-  setRuntime(runtime: PipelineRuntime): void;
+  setDispatch(dispatch: PipelineDispatch): void;
+}
+//#endregion
+//#region src/factories/context-factory.d.ts
+interface IContextFactory {
+  getOrCreateContext<TEntity extends IEntity>(entity: TEntity, registry?: MiddlewareRegistryReadonly): IMutableSystemContext<TEntity>;
+  getContext<TEntity extends IEntity>(entityUid: EntityUid): IMutableSystemContext<TEntity> | undefined;
+  disposeEntity(entityUid: EntityUid): void;
+}
+//#endregion
+//#region src/factories/pipeline-factory.d.ts
+/**
+ * Category identifier for grouping performance metrics.
+ * Typed as string to allow extension beyond the built-in {@link PipelineCategory} values.
+ */
+type PipelineCategoryName = string;
+/**
+ * Built-in metric categories for classifying pipeline and middleware performance entries.
+ *
+ * - `module` — System module pipelines (initialize, config, update, render, sync phases).
+ * - `runtime` — Runtime orchestration pipeline and its middleware.
+ * - `system` — Individual system middleware within a module pipeline.
+ */
+declare enum PipelineCategory {
+  module = "module",
+  runtime = "runtime",
+  system = "system"
+}
+/**
+ * Options for identifying and categorizing performance metrics on pipelines.
+ */
+type PipelineOptions = {
+  /** Display name for the pipeline in performance metrics. */pipelineName: string; /** Category assigned to pipeline-level metric entries. */
+  pipelineCategory: PipelineCategoryName; /** Category assigned to per-middleware metric entries within this pipeline. */
+  middlewareCategory: PipelineCategoryName;
+};
+/**
+ * Creates pipeline instances for various contexts.
+ * Abstracts pipeline creation to support different implementations.
+ * Used by the system to instantiate pipelines without coupling to specific implementations.
+ */
+interface IPipelineFactory {
+  /**
+   * Creates a new pipeline for the specified context type.
+   * @template TContext - The context type for the pipeline. Must extend IPipelineContext.
+   * @param options - Optional performance metric options (name, category) for the pipeline.
+   * @returns A new pipeline instance ready for middleware registration.
+   */
+  createPipeline<TContext extends IPipelineContext>(options?: PipelineOptions): IPipeline<TContext>;
 }
 //#endregion
 //#region src/utils/dispatch-sequential.d.ts
@@ -657,81 +670,6 @@ interface IPerformanceTimer {
   endTimer(timerUid: PerformanceTimerUid): PerformanceTimeEntry;
 }
 //#endregion
-//#region src/factories/context-factory.d.ts
-/**
- * Creates and caches per-entity system contexts.
- *
- * On the first call for a given entity, creates a new SystemContext with all sub-contexts
- * (events, proxies, repository, scheduler, snapshot) bound to that entity.
- * Subsequent calls return the cached context. Disposal removes all cache entries for an entity.
- */
-interface IContextFactory {
-  /**
-   * Creates or retrieves the cached system context for the given entity.
-   * On first call, creates sub-contexts bound to the entity.
-   * On subsequent calls, returns the cached context.
-   * @template TEntity - The entity type for which the system context is being created.
-   * @param entity - The entity to create or retrieve the context for.
-   * @param registry - Optional middleware registry to associate with the context for pipeline execution.
-   * @returns The mutable system context for the entity.
-   */
-  getOrCreateContext<TEntity extends IEntity>(entity: Immutable<TEntity>, registry?: MiddlewareRegistryReadonly): IMutableSystemContext<TEntity>;
-  /**
-   * Retrieves a previously cached system context by entity UID.
-   * @template TEntity - The entity type.
-   * @param entityUid - The entity's unique identifier.
-   * @returns The cached context, or undefined if not found.
-   */
-  getContext<TEntity extends IEntity>(entityUid: EntityUid): IMutableSystemContext<TEntity> | undefined;
-  /**
-   * Disposes all cached contexts for the given entity.
-   * Removes the entity from the repository and clears all cache entries.
-   * @param entityUid - The entity's unique identifier.
-   */
-  disposeEntity(entityUid: EntityUid): void;
-}
-//#endregion
-//#region src/factories/pipeline-factory.d.ts
-/**
- * Category identifier for grouping performance metrics.
- * Typed as string to allow extension beyond the built-in {@link PipelineCategory} values.
- */
-type PipelineCategoryName = string;
-/**
- * Built-in metric categories for classifying pipeline and middleware performance entries.
- *
- * - `module` — System module pipelines (initialize, config, update, render, sync phases).
- * - `runtime` — Runtime orchestration pipeline and its middleware.
- * - `system` — Individual system middleware within a module pipeline.
- */
-declare enum PipelineCategory {
-  module = "module",
-  runtime = "runtime",
-  system = "system"
-}
-/**
- * Options for identifying and categorizing performance metrics on pipelines.
- */
-type PipelineOptions = {
-  /** Display name for the pipeline in performance metrics. */pipelineName: string; /** Category assigned to pipeline-level metric entries. */
-  pipelineCategory: PipelineCategoryName; /** Category assigned to per-middleware metric entries within this pipeline. */
-  middlewareCategory: PipelineCategoryName;
-};
-/**
- * Creates pipeline instances for various contexts.
- * Abstracts pipeline creation to support different implementations.
- * Used by the system to instantiate pipelines without coupling to specific implementations.
- */
-interface IPipelineFactory {
-  /**
-   * Creates a new pipeline for the specified context type.
-   * @template TContext - The context type for the pipeline. Must extend IPipelineContext.
-   * @param options - Optional performance metric options (name, category) for the pipeline.
-   * @returns A new pipeline instance ready for middleware registration.
-   */
-  createPipeline<TContext extends IPipelineContext>(options?: PipelineOptions): IPipeline<TContext>;
-}
-//#endregion
 //#region src/systems/system-type.d.ts
 /**
  * The five phases of entity system execution in each frame.
@@ -749,21 +687,47 @@ declare enum SystemType {
    * Runs on entity creation and on updates that carry a config payload.
    */
   config = 1,
+  /**
+   * Event reactions routed by event uid.
+   * Runs after config and before update for updates carrying events.
+   */
+  event = 2,
   /**
    * Main logic and state updates for the entity.
    * Runs on every update to change entity behavior and properties.
    */
-  update = 2,
+  update = 3,
   /**
    * Output and visualization operations.
    * Runs after updates to render or display the entity state.
    */
-  render = 3,
+  render = 4,
   /**
    * Synchronization and persistence.
    * Runs last to synchronize state with external systems or storage.
    */
-  sync = 4
+  sync = 5
+}
+//#endregion
+//#region src/systems/module/systems-module.d.ts
+/**
+ * Collection of pipelines for a specific entity type.
+ * Defines the complete system processing flow for one entity category.
+ *
+ * @template TEntity - The entity type this module processes.
+ */
+interface ISystemsModule<TEntity extends IEntity> {
+  /**
+   * The builder instance used to construct this module.
+   */
+  readonly builder: ISystemsModuleBuilderReadonly<TEntity>;
+  /**
+   * Optional factory function to initialize new entity instances.
+   * If provided, is called when a new entity of this type is created.
+   * @param model - The initialization model.
+   * @returns The initialized entity.
+   */
+  readonly initEntity?: (model: IEntityModel) => TEntity;
 }
 //#endregion
 //#region src/systems/module/systems-module-builder.d.ts
@@ -776,6 +740,10 @@ interface ISystemsModuleBuilderReadonly<TEntity extends IEntity> {
    * Read-only map of system pipelines keyed by SystemType.
    */
   readonly pipelines: ReadonlyMap<SystemType, IPipeline<ISystemContext<TEntity>>>;
+  /**
+   * Event middleware keyed by event uid.
+   */
+  readonly eventMiddlewares: ReadonlyMap<EntityEventUid, ReadonlyArray<ISystemEventMiddleware<TEntity>>>;
   /**
    * Read-only registry mapping middleware names to their originating module names.
    */
@@ -806,6 +774,11 @@ interface ISystemsModuleBuilder<TEntity extends IEntity> extends ISystemsModuleB
    * @returns This builder for method chaining.
    */
   addSystems(type: SystemType, systems: Immutable<ISystemMiddleware<TEntity>[]>): this;
+  /**
+   * Registers event-routed middleware for a specific event uid.
+   * Event middleware are invoked once per matching event instance.
+   */
+  addEventSystems(uid: EntityEventUid, systems: Immutable<ISystemEventMiddleware<TEntity>[]>): this;
   /**
    * Integrates an entire module's pipelines into this builder.
    * Allows composition of multiple modules into one.
@@ -830,140 +803,6 @@ interface ISystemsModuleBuilder<TEntity extends IEntity> extends ISystemsModuleB
   setScopedProxy(): this;
 }
 //#endregion
-//#region src/systems/module/systems-module.d.ts
-/**
- * Collection of pipelines for a specific entity type.
- * Defines the complete system processing flow for one entity category.
- *
- * @template TEntity - The entity type this module processes.
- */
-interface ISystemsModule<TEntity extends IEntity> {
-  /**
-   * The builder instance used to construct this module.
-   */
-  readonly builder: ISystemsModuleBuilderReadonly<TEntity>;
-  /**
-   * Optional factory function to initialize new entity instances.
-   * If provided, is called when a new entity of this type is created.
-   * @param model - The initialization model.
-   * @returns The initialized entity.
-   */
-  readonly initEntity?: (model: IEntityModel) => TEntity;
-}
-//#endregion
-//#region src/systems/module/systems-module-repository.d.ts
-/**
- * Central registry for all systems modules in the ECS.
- * Maintains a module for each entity type, providing access to all system pipelines.
- * This is the authoritative source for system module data.
- *
- * @template TEntity - The entity types managed by modules in this repository.
- */
-interface ISystemsModuleRepository {
-  /**
-   * The total number of modules in the repository.
-   */
-  readonly size: number;
-  /**
-   * Retrieves the module for a specific entity type.
-   * @template TEntity - The entity type to retrieve module for.
-   * @param type - The entity type identifier.
-   * @returns The systems module for that entity type.
-   */
-  get<TEntity extends IEntity>(type: EntityTypeUid): ISystemsModule<TEntity>;
-  /**
-   * Registers or updates a module for an entity type.
-   * @param type - The entity type identifier.
-   * @param module - The systems module to register.
-   */
-  set(type: EntityTypeUid, module: ISystemsModule<IEntity>): void;
-  /**
-   * Retrieves all registered modules.
-   * @returns A read-only map of entity type to module.
-   */
-  list(): ReadonlyMap<EntityTypeUid, Immutable<ISystemsModule<IEntity>>>;
-}
-//#endregion
-//#region src/systems/runtime/systems-runtime.d.ts
-/**
- * Executes system middleware for entities.
- * Processes entity updates by dispatching them through appropriate system modules.
- * Different implementations may use different execution strategies or optimizations.
- */
-interface ISystemsRuntime {
-  /**
-   * Processes a single entity update through its system pipeline.
-   * If no update is provided, may dequeue one from an internal queue.
-   * @param update - Optional specific update to process. If omitted, dequeues the next update.
-   * @returns Pipeline results containing execution data and metrics.
-   */
-  runTick(update?: IEntityUpdate): PipelineRuntime | Promise<PipelineRuntime> | void;
-}
-//#endregion
-//#region src/systems/runtime/systems-runtime-context.d.ts
-/**
- * Runtime context for system pipeline execution.
- * Coordinates the execution of system pipelines across all entities.
- * Maintains state about the current entity being processed and enabled pipeline stages.
- *
- * @template TEntity - The entity type being processed.
- */
-interface ISystemsRuntimeContext<TEntity extends IEntity> extends IPipelineContext {
-  /**
-   * Indicates if the system pipeline should perform initialization for the current entity.
-   */
-  readonly shouldInitialize?: boolean;
-  /**
-   * Indicates if the config system phase should run for the current entity.
-   */
-  readonly shouldConfigure?: boolean;
-  /**
-   * The systems module for the current entity type.
-   */
-  readonly systemsModule: ISystemsModule<TEntity>;
-  /**
-   * The mutable system context for the current entity execution.
-   * Provides infrastructure setters for update, delta time, and runtime state.
-   */
-  readonly systemContext: IMutableSystemContext<TEntity>;
-  /**
-   * The proxy repository for managing entity proxy relationships and scopes.
-   */
-  readonly proxyRepository: IEntityProxyRepository;
-}
-//#endregion
-//#region src/systems/runtime/systems-runtime-middleware.d.ts
-/**
- * Middleware for orchestrating system execution across entities.
- * Operates at the runtime level to coordinate system module pipelines.
- * Can influence which pipelines execute and in what order.
- *
- * @template TEntity - The entity type being processed.
- */
-type ISystemsRuntimeMiddleware<TEntity extends IEntity> = IMiddleware<ISystemsRuntimeContext<TEntity>>;
-//#endregion
-//#region src/factories/runtime-factory.d.ts
-/**
- * Creates runtime contexts and pipelines for system execution.
- * Provides factory methods for constructing runtime infrastructure.
- * Allows different runtime strategies through multiple implementations.
- */
-interface IRuntimeFactory {
-  /**
-   * Creates a new runtime context for system execution.
-   * @template TEntity - The entity type for the runtime context.
-   * @returns A new systems runtime context instance.
-   */
-  createRuntimeContext<TEntity extends IEntity>(): ISystemsRuntimeContext<TEntity>;
-  /**
-   * Creates a pipeline for systems runtime orchestration.
-   * @template TEntity - The entity type for this runtime pipeline.
-   * @param name - Optional name for debugging.
-   * @returns A new runtime pipeline for system execution.
-   */
-  createRuntimePipeline<TEntity extends IEntity>(name?: string): IPipeline<ISystemsRuntimeContext<TEntity>>;
-}
-//#endregion
 //#region src/factories/systems-factory.d.ts
 /**
  * Creates systems module builders for constructing entity system pipelines.
@@ -980,5 +819,5 @@ interface ISystemsFactory {
   createSystemsModuleBuilder<TEntity extends IEntity>(name: string): ISystemsModuleBuilder<TEntity>;
 }
 //#endregion
-export { ISystemContextRepository as A, SystemModuleName as B, TickSnapshot as C, ISystemContextSnapshot as D, ISystemContext as E, SystemContextControlState as F, LogLevel as G, ISystemContextConfigReadonly as H, ISystemMiddleware as I, MiddlewareRegistry as L, ISystemContextEvents as M, ISystemContextControl as N, IJsonSerializer as O, ISystemContextControlState as P, MiddlewareRegistryReadonly as R, TickMetricEntry as S, IMutableSystemContext as T, ILogger as U, ISystemContextConfig as V, ILoggerOptions as W, PerformanceMetricOptions as _, ISystemsRuntime as a, MiddlewareMetricsSummary as b, ISystemsModuleBuilder as c, IPipelineFactory as d, PipelineCategory as f, IPerformanceTimer as g, IContextFactory as h, ISystemsRuntimeContext as i, ISystemContextProxies as j, ISystemContextScheduler as k, ISystemsModuleBuilderReadonly as l, PipelineOptions as m, IRuntimeFactory as n, ISystemsModuleRepository as o, PipelineCategoryName as p, ISystemsRuntimeMiddleware as r, ISystemsModule as s, ISystemsFactory as t, SystemType as u, PerformanceTimeEntry as v, dispatchSequential as w, RenderSnapshot as x, PerformanceTimerUid as y, SystemMiddlewareName as z };
-//# sourceMappingURL=index-BJFNTFDd.d.cts.map
+export { ISystemContextControlState as A, ISystemContextConfigReadonly as B, IJsonSerializer as C, IMutableSystemContextEvents as D, ISystemContextProxies as E, MiddlewareRegistry as F, ILoggerOptions as H, MiddlewareRegistryReadonly as I, SystemMiddlewareName as L, SystemContextControlTarget as M, ISystemEventMiddleware as N, ISystemContextEvents as O, ISystemMiddleware as P, SystemModuleName as R, ISystemContextSnapshot as S, ISystemContextRepository as T, LogLevel as U, ILogger as V, PipelineCategoryName as _, SystemType as a, IMutableSystemContext as b, PerformanceTimeEntry as c, RenderSnapshot as d, TickMetricEntry as f, PipelineCategory as g, IPipelineFactory as h, ISystemsModule as i, SystemContextControlState as j, ISystemContextControl as k, PerformanceTimerUid as l, dispatchSequential as m, ISystemsModuleBuilder as n, IPerformanceTimer as o, TickSnapshot as p, ISystemsModuleBuilderReadonly as r, PerformanceMetricOptions as s, ISystemsFactory as t, MiddlewareMetricsSummary as u, PipelineOptions as v, ISystemContextScheduler as w, ISystemContext as x, IContextFactory as y, ISystemContextConfig as z };
+//# sourceMappingURL=index-CPGVaS-_.d.cts.map

package/dist/{index-DMTkNY1e.d.cts → index-DXbpfhHa.d.mts}

@@ -1,4 +1,4 @@
-import { r as Immutable } from "./types-Bbmnq4ni.cjs";
+import { r as Immutable } from "./types-UnqKSA14.mjs";
 
 //#region src/pipelines/pipeline-context.d.ts
 /**
@@ -7,16 +7,16 @@ import { r as Immutable } from "./types-Bbmnq4ni.cjs";
  */
 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-DMTkNY1e.d.cts.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-DXbpfhHa.d.mts.map