@awesome-ecs/abstract 0.30.0 → 0.31.0

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';\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, 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 PipelineMetricOptions = {\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>(\r\n    options?: PipelineMetricOptions\r\n  ): IPipeline<TContext>;\r\n}\r\n"],"mappings":";;;;;;;;;AAgBA,IAAY,mBAAL,yBAAA,kBAAA;AACL,kBAAA,YAAA;AACA,kBAAA,aAAA;AACA,kBAAA,YAAA;;KACD"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/factories/pipeline-factory.ts"],"sourcesContent":["import { 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, 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;AACL,kBAAA,YAAA;AACA,kBAAA,aAAA;AACA,kBAAA,YAAA;;KACD"}

package/dist/factories/index.d.cts

@@ -1,2 +1,2 @@
-import { d as IPipelineFactory, f as PipelineCategory, h as IContextFactory, m as PipelineMetricOptions, n as IRuntimeFactory, p as PipelineCategoryName, t as ISystemsFactory } from "../index-BVkmidEx.cjs";
-export { IContextFactory, IPipelineFactory, IRuntimeFactory, ISystemsFactory, PipelineCategory, PipelineCategoryName, PipelineMetricOptions };
+import { d as IPipelineFactory, f as PipelineCategory, h as IContextFactory, m as PipelineOptions, n as IRuntimeFactory, p as PipelineCategoryName, t as ISystemsFactory } from "../index-zohK7ftH.cjs";
+export { IContextFactory, IPipelineFactory, IRuntimeFactory, 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 PipelineMetricOptions, n as IRuntimeFactory, p as PipelineCategoryName, t as ISystemsFactory } from "../index-8XDo0pla.mjs";
-export { IContextFactory, IPipelineFactory, IRuntimeFactory, ISystemsFactory, PipelineCategory, PipelineCategoryName, PipelineMetricOptions };
+import { d as IPipelineFactory, f as PipelineCategory, h as IContextFactory, m as PipelineOptions, n as IRuntimeFactory, p as PipelineCategoryName, t as ISystemsFactory } from "../index-DZlhICMZ.mjs";
+export { IContextFactory, IPipelineFactory, IRuntimeFactory, 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';\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, 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 PipelineMetricOptions = {\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>(\r\n    options?: PipelineMetricOptions\r\n  ): IPipeline<TContext>;\r\n}\r\n"],"mappings":";;;;;;;;AAgBA,IAAY,mBAAL,yBAAA,kBAAA;AACL,kBAAA,YAAA;AACA,kBAAA,aAAA;AACA,kBAAA,YAAA;;KACD"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/factories/pipeline-factory.ts"],"sourcesContent":["import { 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, 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;AACL,kBAAA,YAAA;AACA,kBAAA,aAAA;AACA,kBAAA,YAAA;;KACD"}

package/dist/{index-8XDo0pla.d.mts → index-DZlhICMZ.d.mts}

@@ -430,6 +430,87 @@ interface IPipelineRunner<TContext extends IPipelineContext> {
   cleanup(context: Partial<TContext>, middleware: IMiddleware<TContext>[]): void | Promise<void>;
 }
 //#endregion
+//#region src/systems/pipeline/system-middleware.d.ts
+type SystemMiddlewareName = string;
+type SystemModuleName = string;
+type MiddlewareRegistry = Map<SystemMiddlewareName, SystemModuleName>;
+type MiddlewareRegistryReadonly = ReadonlyMap<SystemMiddlewareName, SystemModuleName>;
+/**
+ * A middleware unit that operates within the system pipeline.
+ * System middleware receive comprehensive context about the entity being processed
+ * and can influence entity state and behavior through various APIs.
+ *
+ * @template TEntity - The entity type this middleware handles.
+ */
+type ISystemMiddleware<TEntity extends IEntity> = IMiddleware<ISystemContext<TEntity>>;
+//#endregion
+//#region src/systems/pipeline/system-context-control.d.ts
+declare enum SystemContextControlState {
+  none = "none",
+  enableCurrentSystem = "enableCurrentSystem",
+  disableCurrentSystem = "disableCurrentSystem",
+  enableCurrentModule = "enableCurrentModule",
+  disableCurrentModule = "disableCurrentModule"
+}
+/**
+ * Interface for controlling the execution of systems and modules within a system context.
+ * This allows middleware to enable or disable specific systems or entire modules for the current entity.
+ */
+interface ISystemContextControl {
+  /**
+   * Disables the current system for the current entity.
+   */
+  disableCurrentSystem(): void;
+  /**
+   * Re-enables the current system for the current entity.
+   */
+  enableCurrentSystem(): void;
+  /**
+   * Disables the current module for the current entity.
+   */
+  disableCurrentModule(): void;
+  /**
+   * Re-enables the current module for the current entity.
+   */
+  enableCurrentModule(): void;
+}
+/**
+ * Extended system context interface that includes control state for middleware to manage system and module execution.
+ * This allows middleware to query and modify the execution state of systems and modules during pipeline processing.
+ */
+interface ISystemContextControlState extends ISystemContextControl {
+  /**
+   * Current state of system/module execution control, indicating whether the current system or module is enabled or disabled.
+   */
+  readonly state: SystemContextControlState;
+  /**
+   * Checks if a specific middleware is currently disabled in the context, allowing middleware to conditionally execute logic based on the enabled/disabled state of other middleware.
+   * @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;
+  /**
+   * Disables a specific middleware in the context.
+   * @param middleware - The middleware to disable.
+   */
+  disableMiddleware(middleware: ISystemMiddleware<IEntity>): void;
+  /**
+   * Enables a specific middleware in the context.
+   * @param middleware - The middleware to enable.
+   */
+  enableMiddleware(middleware: ISystemMiddleware<IEntity>): void;
+  /**
+   * Disables an entire module of middleware in the context.
+   * @param middleware - A middleware from the module to disable.
+   */
+  disableModule(middleware: ISystemMiddleware<IEntity>): void;
+  /**
+   * Enables an entire module of middleware in the context.
+   * @param middleware - A middleware from the module to enable.
+   */
+  enableModule(middleware: ISystemMiddleware<IEntity>): void;
+}
+//#endregion
 //#region src/systems/pipeline/system-context-events.d.ts
 /**
  * System context API for event-driven entity communication.
@@ -694,6 +775,10 @@ interface ISystemContext<TEntity extends IEntity> extends IPipelineContext {
    * Event system API for publishing and subscribing to entity events.
    */
   readonly events: Immutable<ISystemContextEvents>;
+  /**
+   * Logging interface for debug and diagnostic output.
+   */
+  readonly logger: Immutable<ILogger>;
   /**
    * Proxy management API for establishing and managing entity relationships.
    */
@@ -702,6 +787,10 @@ interface ISystemContext<TEntity extends IEntity> extends IPipelineContext {
    * Repository access API for querying and modifying entity storage.
    */
   readonly repository: Immutable<ISystemContextRepository>;
+  /**
+   * The per-entity runtime state and control interface for this system context.
+   */
+  readonly runtime: PipelineRuntime;
   /**
    * Scheduling API for requesting follow-up entity updates.
    */
@@ -711,9 +800,9 @@ interface ISystemContext<TEntity extends IEntity> extends IPipelineContext {
    */
   readonly snapshot: Immutable<ISystemContextSnapshot>;
   /**
-   * Logging interface for debug and diagnostic output.
+   * Control API for enabling/disabling the current system or entire module during execution.
    */
-  readonly logger: Immutable<ILogger>;
+  readonly systems: Immutable<ISystemContextControl>;
 }
 //#endregion
 //#region src/systems/pipeline/system-context-mutable.d.ts
@@ -745,9 +834,10 @@ interface IContextFactory {
    * 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>): IMutableSystemContext<TEntity>;
+  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.
@@ -784,7 +874,7 @@ declare enum PipelineCategory {
 /**
  * Options for identifying and categorizing performance metrics on pipelines.
  */
-type PipelineMetricOptions = {
+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;
@@ -801,7 +891,7 @@ interface IPipelineFactory {
    * @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?: PipelineMetricOptions): IPipeline<TContext>;
+  createPipeline<TContext extends IPipelineContext>(options?: PipelineOptions): IPipeline<TContext>;
 }
 //#endregion
 //#region src/systems/system-type.d.ts
@@ -833,52 +923,29 @@ declare enum SystemType {
   sync = 3
 }
 //#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> {
+//#region src/systems/module/systems-module-builder.d.ts
+interface ISystemsModuleBuilderReadonly<TEntity extends IEntity> {
   /**
-   * The pipelines for this entity type.
-   * Each pipeline contains middleware that operates on the entity.
+   * The Module's name.
    */
-  readonly pipelines: ReadonlyMap<SystemType, Immutable<IPipeline<ISystemContext<TEntity>>>>;
+  readonly name: string;
   /**
-   * 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.
+   * Read-only map of system pipelines keyed by SystemType.
    */
-  readonly initEntity?: (model: IEntityModel) => TEntity;
+  readonly pipelines: ReadonlyMap<SystemType, IPipeline<ISystemContext<TEntity>>>;
   /**
-   * If true, this entity type creates a new scope boundary when initialized.
-   * A new scope ID is auto-generated. All child entities inherit this scope.
-   * Typically used for root entities like Engine.
+   * Read-only registry mapping middleware names to their originating module names.
    */
-  readonly scopeRoot?: boolean;
+  readonly middlewareRegistry: MiddlewareRegistryReadonly;
   /**
-   * If true, this entity type registers itself as a scoped proxy when initialized.
-   * It joins the inherited scope and becomes resolvable via `context.proxies.get()`
-   * by any entity in the same scope. Throws if no scope exists.
-   * Typically used for scope-wide entities like Scene, Input, AssetsManager.
+   * Whether this entity type is a scope root. When initialized, a new scope is auto-generated and all child entities inherit it.
    */
-  readonly scopedProxy?: boolean;
+  readonly scopeRoot: boolean;
+  /**
+   * Whether this entity type is a scoped proxy. When initialized, the entity registers itself in the inherited scope, making it resolvable via `context.proxies.get()` by any entity in the same scope.
+   */
+  readonly scopedProxy: boolean;
 }
-//#endregion
-//#region src/systems/pipeline/system-middleware.d.ts
-/**
- * A middleware unit that operates within the system pipeline.
- * System middleware receive comprehensive context about the entity being processed
- * and can influence entity state and behavior through various APIs.
- *
- * @template TEntity - The entity type this middleware handles.
- */
-type ISystemMiddleware<TEntity extends IEntity> = IMiddleware<ISystemContext<TEntity>>;
-//#endregion
-//#region src/systems/module/systems-module-builder.d.ts
 /**
  * Builder pattern interface for constructing system modules.
  * Allows incremental registration of systems and modules for an entity type.
@@ -886,24 +953,8 @@ type ISystemMiddleware<TEntity extends IEntity> = IMiddleware<ISystemContext<TEn
  *
  * @template TEntity - The entity type for which systems are being added.
  */
-interface ISystemsModuleBuilder<TEntity extends IEntity> {
-  /**
-   * The Module Builder's name.
-   */
-  readonly name: string;
-  /**
-   * The pipelines being built.
-   * Accessible during and after construction.
-   */
-  readonly pipelines: ReadonlyMap<SystemType, IPipeline<ISystemContext<TEntity>>>;
-  /**
-   * Whether this entity type is a scope root.
-   */
-  readonly scopeRoot: boolean;
-  /**
-   * Whether this entity type is a scoped proxy.
-   */
-  readonly scopedProxy: boolean;
+interface ISystemsModuleBuilder<TEntity extends IEntity> extends ISystemsModuleBuilderReadonly<TEntity> {
+  readonly middlewareRegistry: MiddlewareRegistry;
   /**
    * Registers middleware systems for a specific pipeline stage.
    * The middleware are added to the pipeline in the order provided.
@@ -936,6 +987,27 @@ interface ISystemsModuleBuilder<TEntity extends IEntity> {
   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.
@@ -980,9 +1052,9 @@ 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 Array of pipeline results containing execution metrics and data.
+   * @returns Pipeline results containing execution data and metrics.
    */
-  runTick(update?: IEntityUpdate): PerformanceTimeEntry[] | void;
+  runTick(update?: IEntityUpdate): PipelineRuntime | Promise<PipelineRuntime> | void;
 }
 //#endregion
 //#region src/systems/runtime/systems-runtime-context.d.ts
@@ -1061,5 +1133,5 @@ interface ISystemsFactory {
   createSystemsModuleBuilder<TEntity extends IEntity>(name: string): ISystemsModuleBuilder<TEntity>;
 }
 //#endregion
-export { IMiddleware as A, TickSnapshot as B, IPipelineRunner as C, IParentMiddleware as D, IParentContext as E, PerformanceTimeEntry as F, dispatchSequential as G, ILoggerOptions as H, PerformanceTimerUid as I, MiddlewareMetricsSummary as L, PipelineRuntime as M, IPerformanceTimer as N, IPipeline as O, PerformanceMetricOptions as P, RenderSnapshot as R, ISystemContextEvents as S, INestedMiddleware as T, LogLevel as U, ILogger as V, IJsonSerializer as W, ISystemContext as _, ISystemsRuntime as a, ISystemContextRepository as b, ISystemMiddleware as c, IPipelineFactory as d, PipelineCategory as f, IMutableSystemContext as g, IContextFactory as h, ISystemsRuntimeContext as i, IPipelineContext as j, IMiddlewareRunner as k, ISystemsModule as l, PipelineMetricOptions as m, IRuntimeFactory as n, ISystemsModuleRepository as o, PipelineCategoryName as p, ISystemsRuntimeMiddleware as r, ISystemsModuleBuilder as s, ISystemsFactory as t, SystemType as u, ISystemContextSnapshot as v, INestedContext as w, ISystemContextProxies as x, ISystemContextScheduler as y, TickMetricEntry as z };
-//# sourceMappingURL=index-8XDo0pla.d.mts.map
+export { dispatchSequential as $, SystemModuleName as A, PipelineRuntime as B, ISystemContextControl as C, MiddlewareRegistry as D, ISystemMiddleware as E, IParentMiddleware as F, MiddlewareMetricsSummary as G, PerformanceMetricOptions as H, IPipeline as I, TickSnapshot as J, RenderSnapshot as K, IMiddlewareRunner as L, INestedContext as M, INestedMiddleware as N, MiddlewareRegistryReadonly as O, IParentContext as P, IJsonSerializer as Q, IMiddleware as R, ISystemContextEvents as S, SystemContextControlState as T, PerformanceTimeEntry as U, IPerformanceTimer as V, PerformanceTimerUid as W, ILoggerOptions as X, ILogger as Y, LogLevel as Z, ISystemContext as _, ISystemsRuntime as a, ISystemContextRepository as b, ISystemsModuleBuilder as c, IPipelineFactory as d, PipelineCategory as f, IMutableSystemContext as g, IContextFactory as h, ISystemsRuntimeContext as i, IPipelineRunner as j, SystemMiddlewareName as k, ISystemsModuleBuilderReadonly as l, PipelineOptions as m, IRuntimeFactory as n, ISystemsModuleRepository as o, PipelineCategoryName as p, TickMetricEntry as q, ISystemsRuntimeMiddleware as r, ISystemsModule as s, ISystemsFactory as t, SystemType as u, ISystemContextSnapshot as v, ISystemContextControlState as w, ISystemContextProxies as x, ISystemContextScheduler as y, IPipelineContext as z };
+//# sourceMappingURL=index-DZlhICMZ.d.mts.map

package/dist/{index-BVkmidEx.d.cts → index-zohK7ftH.d.cts}

@@ -430,6 +430,87 @@ interface IPipelineRunner<TContext extends IPipelineContext> {
   cleanup(context: Partial<TContext>, middleware: IMiddleware<TContext>[]): void | Promise<void>;
 }
 //#endregion
+//#region src/systems/pipeline/system-middleware.d.ts
+type SystemMiddlewareName = string;
+type SystemModuleName = string;
+type MiddlewareRegistry = Map<SystemMiddlewareName, SystemModuleName>;
+type MiddlewareRegistryReadonly = ReadonlyMap<SystemMiddlewareName, SystemModuleName>;
+/**
+ * A middleware unit that operates within the system pipeline.
+ * System middleware receive comprehensive context about the entity being processed
+ * and can influence entity state and behavior through various APIs.
+ *
+ * @template TEntity - The entity type this middleware handles.
+ */
+type ISystemMiddleware<TEntity extends IEntity> = IMiddleware<ISystemContext<TEntity>>;
+//#endregion
+//#region src/systems/pipeline/system-context-control.d.ts
+declare enum SystemContextControlState {
+  none = "none",
+  enableCurrentSystem = "enableCurrentSystem",
+  disableCurrentSystem = "disableCurrentSystem",
+  enableCurrentModule = "enableCurrentModule",
+  disableCurrentModule = "disableCurrentModule"
+}
+/**
+ * Interface for controlling the execution of systems and modules within a system context.
+ * This allows middleware to enable or disable specific systems or entire modules for the current entity.
+ */
+interface ISystemContextControl {
+  /**
+   * Disables the current system for the current entity.
+   */
+  disableCurrentSystem(): void;
+  /**
+   * Re-enables the current system for the current entity.
+   */
+  enableCurrentSystem(): void;
+  /**
+   * Disables the current module for the current entity.
+   */
+  disableCurrentModule(): void;
+  /**
+   * Re-enables the current module for the current entity.
+   */
+  enableCurrentModule(): void;
+}
+/**
+ * Extended system context interface that includes control state for middleware to manage system and module execution.
+ * This allows middleware to query and modify the execution state of systems and modules during pipeline processing.
+ */
+interface ISystemContextControlState extends ISystemContextControl {
+  /**
+   * Current state of system/module execution control, indicating whether the current system or module is enabled or disabled.
+   */
+  readonly state: SystemContextControlState;
+  /**
+   * Checks if a specific middleware is currently disabled in the context, allowing middleware to conditionally execute logic based on the enabled/disabled state of other middleware.
+   * @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;
+  /**
+   * Disables a specific middleware in the context.
+   * @param middleware - The middleware to disable.
+   */
+  disableMiddleware(middleware: ISystemMiddleware<IEntity>): void;
+  /**
+   * Enables a specific middleware in the context.
+   * @param middleware - The middleware to enable.
+   */
+  enableMiddleware(middleware: ISystemMiddleware<IEntity>): void;
+  /**
+   * Disables an entire module of middleware in the context.
+   * @param middleware - A middleware from the module to disable.
+   */
+  disableModule(middleware: ISystemMiddleware<IEntity>): void;
+  /**
+   * Enables an entire module of middleware in the context.
+   * @param middleware - A middleware from the module to enable.
+   */
+  enableModule(middleware: ISystemMiddleware<IEntity>): void;
+}
+//#endregion
 //#region src/systems/pipeline/system-context-events.d.ts
 /**
  * System context API for event-driven entity communication.
@@ -694,6 +775,10 @@ interface ISystemContext<TEntity extends IEntity> extends IPipelineContext {
    * Event system API for publishing and subscribing to entity events.
    */
   readonly events: Immutable<ISystemContextEvents>;
+  /**
+   * Logging interface for debug and diagnostic output.
+   */
+  readonly logger: Immutable<ILogger>;
   /**
    * Proxy management API for establishing and managing entity relationships.
    */
@@ -702,6 +787,10 @@ interface ISystemContext<TEntity extends IEntity> extends IPipelineContext {
    * Repository access API for querying and modifying entity storage.
    */
   readonly repository: Immutable<ISystemContextRepository>;
+  /**
+   * The per-entity runtime state and control interface for this system context.
+   */
+  readonly runtime: PipelineRuntime;
   /**
    * Scheduling API for requesting follow-up entity updates.
    */
@@ -711,9 +800,9 @@ interface ISystemContext<TEntity extends IEntity> extends IPipelineContext {
    */
   readonly snapshot: Immutable<ISystemContextSnapshot>;
   /**
-   * Logging interface for debug and diagnostic output.
+   * Control API for enabling/disabling the current system or entire module during execution.
    */
-  readonly logger: Immutable<ILogger>;
+  readonly systems: Immutable<ISystemContextControl>;
 }
 //#endregion
 //#region src/systems/pipeline/system-context-mutable.d.ts
@@ -745,9 +834,10 @@ interface IContextFactory {
    * 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>): IMutableSystemContext<TEntity>;
+  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.
@@ -784,7 +874,7 @@ declare enum PipelineCategory {
 /**
  * Options for identifying and categorizing performance metrics on pipelines.
  */
-type PipelineMetricOptions = {
+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;
@@ -801,7 +891,7 @@ interface IPipelineFactory {
    * @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?: PipelineMetricOptions): IPipeline<TContext>;
+  createPipeline<TContext extends IPipelineContext>(options?: PipelineOptions): IPipeline<TContext>;
 }
 //#endregion
 //#region src/systems/system-type.d.ts
@@ -833,52 +923,29 @@ declare enum SystemType {
   sync = 3
 }
 //#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> {
+//#region src/systems/module/systems-module-builder.d.ts
+interface ISystemsModuleBuilderReadonly<TEntity extends IEntity> {
   /**
-   * The pipelines for this entity type.
-   * Each pipeline contains middleware that operates on the entity.
+   * The Module's name.
    */
-  readonly pipelines: ReadonlyMap<SystemType, Immutable<IPipeline<ISystemContext<TEntity>>>>;
+  readonly name: string;
   /**
-   * 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.
+   * Read-only map of system pipelines keyed by SystemType.
    */
-  readonly initEntity?: (model: IEntityModel) => TEntity;
+  readonly pipelines: ReadonlyMap<SystemType, IPipeline<ISystemContext<TEntity>>>;
   /**
-   * If true, this entity type creates a new scope boundary when initialized.
-   * A new scope ID is auto-generated. All child entities inherit this scope.
-   * Typically used for root entities like Engine.
+   * Read-only registry mapping middleware names to their originating module names.
    */
-  readonly scopeRoot?: boolean;
+  readonly middlewareRegistry: MiddlewareRegistryReadonly;
   /**
-   * If true, this entity type registers itself as a scoped proxy when initialized.
-   * It joins the inherited scope and becomes resolvable via `context.proxies.get()`
-   * by any entity in the same scope. Throws if no scope exists.
-   * Typically used for scope-wide entities like Scene, Input, AssetsManager.
+   * Whether this entity type is a scope root. When initialized, a new scope is auto-generated and all child entities inherit it.
    */
-  readonly scopedProxy?: boolean;
+  readonly scopeRoot: boolean;
+  /**
+   * Whether this entity type is a scoped proxy. When initialized, the entity registers itself in the inherited scope, making it resolvable via `context.proxies.get()` by any entity in the same scope.
+   */
+  readonly scopedProxy: boolean;
 }
-//#endregion
-//#region src/systems/pipeline/system-middleware.d.ts
-/**
- * A middleware unit that operates within the system pipeline.
- * System middleware receive comprehensive context about the entity being processed
- * and can influence entity state and behavior through various APIs.
- *
- * @template TEntity - The entity type this middleware handles.
- */
-type ISystemMiddleware<TEntity extends IEntity> = IMiddleware<ISystemContext<TEntity>>;
-//#endregion
-//#region src/systems/module/systems-module-builder.d.ts
 /**
  * Builder pattern interface for constructing system modules.
  * Allows incremental registration of systems and modules for an entity type.
@@ -886,24 +953,8 @@ type ISystemMiddleware<TEntity extends IEntity> = IMiddleware<ISystemContext<TEn
  *
  * @template TEntity - The entity type for which systems are being added.
  */
-interface ISystemsModuleBuilder<TEntity extends IEntity> {
-  /**
-   * The Module Builder's name.
-   */
-  readonly name: string;
-  /**
-   * The pipelines being built.
-   * Accessible during and after construction.
-   */
-  readonly pipelines: ReadonlyMap<SystemType, IPipeline<ISystemContext<TEntity>>>;
-  /**
-   * Whether this entity type is a scope root.
-   */
-  readonly scopeRoot: boolean;
-  /**
-   * Whether this entity type is a scoped proxy.
-   */
-  readonly scopedProxy: boolean;
+interface ISystemsModuleBuilder<TEntity extends IEntity> extends ISystemsModuleBuilderReadonly<TEntity> {
+  readonly middlewareRegistry: MiddlewareRegistry;
   /**
    * Registers middleware systems for a specific pipeline stage.
    * The middleware are added to the pipeline in the order provided.
@@ -936,6 +987,27 @@ interface ISystemsModuleBuilder<TEntity extends IEntity> {
   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.
@@ -980,9 +1052,9 @@ 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 Array of pipeline results containing execution metrics and data.
+   * @returns Pipeline results containing execution data and metrics.
    */
-  runTick(update?: IEntityUpdate): PerformanceTimeEntry[] | void;
+  runTick(update?: IEntityUpdate): PipelineRuntime | Promise<PipelineRuntime> | void;
 }
 //#endregion
 //#region src/systems/runtime/systems-runtime-context.d.ts
@@ -1061,5 +1133,5 @@ interface ISystemsFactory {
   createSystemsModuleBuilder<TEntity extends IEntity>(name: string): ISystemsModuleBuilder<TEntity>;
 }
 //#endregion
-export { IMiddleware as A, TickSnapshot as B, IPipelineRunner as C, IParentMiddleware as D, IParentContext as E, PerformanceTimeEntry as F, dispatchSequential as G, ILoggerOptions as H, PerformanceTimerUid as I, MiddlewareMetricsSummary as L, PipelineRuntime as M, IPerformanceTimer as N, IPipeline as O, PerformanceMetricOptions as P, RenderSnapshot as R, ISystemContextEvents as S, INestedMiddleware as T, LogLevel as U, ILogger as V, IJsonSerializer as W, ISystemContext as _, ISystemsRuntime as a, ISystemContextRepository as b, ISystemMiddleware as c, IPipelineFactory as d, PipelineCategory as f, IMutableSystemContext as g, IContextFactory as h, ISystemsRuntimeContext as i, IPipelineContext as j, IMiddlewareRunner as k, ISystemsModule as l, PipelineMetricOptions as m, IRuntimeFactory as n, ISystemsModuleRepository as o, PipelineCategoryName as p, ISystemsRuntimeMiddleware as r, ISystemsModuleBuilder as s, ISystemsFactory as t, SystemType as u, ISystemContextSnapshot as v, INestedContext as w, ISystemContextProxies as x, ISystemContextScheduler as y, TickMetricEntry as z };
-//# sourceMappingURL=index-BVkmidEx.d.cts.map
+export { dispatchSequential as $, SystemModuleName as A, PipelineRuntime as B, ISystemContextControl as C, MiddlewareRegistry as D, ISystemMiddleware as E, IParentMiddleware as F, MiddlewareMetricsSummary as G, PerformanceMetricOptions as H, IPipeline as I, TickSnapshot as J, RenderSnapshot as K, IMiddlewareRunner as L, INestedContext as M, INestedMiddleware as N, MiddlewareRegistryReadonly as O, IParentContext as P, IJsonSerializer as Q, IMiddleware as R, ISystemContextEvents as S, SystemContextControlState as T, PerformanceTimeEntry as U, IPerformanceTimer as V, PerformanceTimerUid as W, ILoggerOptions as X, ILogger as Y, LogLevel as Z, ISystemContext as _, ISystemsRuntime as a, ISystemContextRepository as b, ISystemsModuleBuilder as c, IPipelineFactory as d, PipelineCategory as f, IMutableSystemContext as g, IContextFactory as h, ISystemsRuntimeContext as i, IPipelineRunner as j, SystemMiddlewareName as k, ISystemsModuleBuilderReadonly as l, PipelineOptions as m, IRuntimeFactory as n, ISystemsModuleRepository as o, PipelineCategoryName as p, TickMetricEntry as q, ISystemsRuntimeMiddleware as r, ISystemsModule as s, ISystemsFactory as t, SystemType as u, ISystemContextSnapshot as v, ISystemContextControlState as w, ISystemContextProxies as x, ISystemContextScheduler as y, IPipelineContext as z };
+//# sourceMappingURL=index-zohK7ftH.d.cts.map

package/dist/pipelines/index.d.cts

@@ -1,2 +1,2 @@
-import { A as IMiddleware, C as IPipelineRunner, D as IParentMiddleware, E as IParentContext, M as PipelineRuntime, O as IPipeline, T as INestedMiddleware, j as IPipelineContext, k as IMiddlewareRunner, w as INestedContext } from "../index-BVkmidEx.cjs";
+import { B as PipelineRuntime, F as IParentMiddleware, I as IPipeline, L as IMiddlewareRunner, M as INestedContext, N as INestedMiddleware, P as IParentContext, R as IMiddleware, j as IPipelineRunner, z as IPipelineContext } from "../index-zohK7ftH.cjs";
 export { IMiddleware, IMiddlewareRunner, INestedContext, INestedMiddleware, IParentContext, IParentMiddleware, IPipeline, IPipelineContext, IPipelineRunner, PipelineRuntime };

package/dist/pipelines/index.d.mts

@@ -1,2 +1,2 @@
-import { A as IMiddleware, C as IPipelineRunner, D as IParentMiddleware, E as IParentContext, M as PipelineRuntime, O as IPipeline, T as INestedMiddleware, j as IPipelineContext, k as IMiddlewareRunner, w as INestedContext } from "../index-8XDo0pla.mjs";
+import { B as PipelineRuntime, F as IParentMiddleware, I as IPipeline, L as IMiddlewareRunner, M as INestedContext, N as INestedMiddleware, P as IParentContext, R as IMiddleware, j as IPipelineRunner, z as IPipelineContext } from "../index-DZlhICMZ.mjs";
 export { IMiddleware, IMiddlewareRunner, INestedContext, INestedMiddleware, IParentContext, IParentMiddleware, IPipeline, IPipelineContext, IPipelineRunner, PipelineRuntime };

package/dist/systems/index.cjs

@@ -1,4 +1,14 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/systems/pipeline/system-context-control.ts
+let SystemContextControlState = /* @__PURE__ */ function(SystemContextControlState) {
+	SystemContextControlState["none"] = "none";
+	SystemContextControlState["enableCurrentSystem"] = "enableCurrentSystem";
+	SystemContextControlState["disableCurrentSystem"] = "disableCurrentSystem";
+	SystemContextControlState["enableCurrentModule"] = "enableCurrentModule";
+	SystemContextControlState["disableCurrentModule"] = "disableCurrentModule";
+	return SystemContextControlState;
+}({});
+//#endregion
 //#region src/systems/system-type.ts
 /**
 * The four phases of entity system execution in each frame.
@@ -29,6 +39,7 @@ let SystemType = /* @__PURE__ */ function(SystemType) {
 	return SystemType;
 }({});
 //#endregion
+exports.SystemContextControlState = SystemContextControlState;
 exports.SystemType = SystemType;
 
 //# sourceMappingURL=index.cjs.map

package/dist/systems/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../src/systems/system-type.ts"],"sourcesContent":["/**\r\n * The four phases of entity system execution in each frame.\r\n * Each phase serves a specific purpose in the entity lifecycle and can be extended by custom system types.\r\n * The runtime handles each phase in order, allowing systems to perform stage-specific operations.\r\n */\r\nexport enum SystemType {\r\n  /**\r\n   * Initial setup and resource allocation for the entity.\r\n   * Runs once when the entity is first created or initialized.\r\n   */\r\n  initialize = 0,\r\n\r\n  /**\r\n   * Main logic and state updates for the entity.\r\n   * Runs on every update to change entity behavior and properties.\r\n   */\r\n  update = 1,\r\n\r\n  /**\r\n   * Output and visualization operations.\r\n   * Runs after updates to render or display the entity state.\r\n   */\r\n  render = 2,\r\n\r\n  /**\r\n   * Synchronization and persistence.\r\n   * Runs last to synchronize state with external systems or storage.\r\n   */\r\n  sync = 3\r\n}\r\n"],"mappings":";;;;;;;AAKA,IAAY,aAAL,yBAAA,YAAA;;;;;AAKL,YAAA,WAAA,gBAAA,KAAA;;;;;AAMA,YAAA,WAAA,YAAA,KAAA;;;;;AAMA,YAAA,WAAA,YAAA,KAAA;;;;;AAMA,YAAA,WAAA,UAAA,KAAA;;KACD"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/systems/pipeline/system-context-control.ts","../../src/systems/system-type.ts"],"sourcesContent":["import { IEntity } from '@awesome-ecs/abstract/entities';\r\nimport { ISystemMiddleware } from './system-middleware';\r\n\r\nexport enum SystemContextControlState {\r\n  none = 'none',\r\n  enableCurrentSystem = 'enableCurrentSystem',\r\n  disableCurrentSystem = 'disableCurrentSystem',\r\n  enableCurrentModule = 'enableCurrentModule',\r\n  disableCurrentModule = 'disableCurrentModule'\r\n}\r\n\r\n/**\r\n * Interface for controlling the execution of systems and modules within a system context.\r\n * This allows middleware to enable or disable specific systems or entire modules for the current entity.\r\n */\r\nexport interface ISystemContextControl {\r\n  /**\r\n   * Disables the current system for the current entity.\r\n   */\r\n  disableCurrentSystem(): void;\r\n\r\n  /**\r\n   * Re-enables the current system for the current entity.\r\n   */\r\n  enableCurrentSystem(): void;\r\n\r\n  /**\r\n   * Disables the current module for the current entity.\r\n   */\r\n  disableCurrentModule(): void;\r\n\r\n  /**\r\n   * Re-enables the current module for the current entity.\r\n   */\r\n  enableCurrentModule(): void;\r\n}\r\n\r\n/**\r\n * Extended system context interface that includes control state for middleware to manage system and module execution.\r\n * This allows middleware to query and modify the execution state of systems and modules during pipeline processing.\r\n */\r\nexport interface ISystemContextControlState extends ISystemContextControl {\r\n  /**\r\n   * Current state of system/module execution control, indicating whether the current system or module is enabled or disabled.\r\n   */\r\n  readonly state: SystemContextControlState;\r\n\r\n  /**\r\n   * Checks if a specific middleware is currently disabled in the context, allowing middleware to conditionally execute logic based on the enabled/disabled state of other middleware.\r\n   * @param middleware - The middleware to check for disabled state.\r\n   * @returns True if the specified middleware is currently disabled, false otherwise.\r\n   */\r\n  isMiddlewareDisabled(middleware: ISystemMiddleware<IEntity>): boolean;\r\n\r\n  /**\r\n   * Disables a specific middleware in the context.\r\n   * @param middleware - The middleware to disable.\r\n   */\r\n  disableMiddleware(middleware: ISystemMiddleware<IEntity>): void;\r\n\r\n  /**\r\n   * Enables a specific middleware in the context.\r\n   * @param middleware - The middleware to enable.\r\n   */\r\n  enableMiddleware(middleware: ISystemMiddleware<IEntity>): void;\r\n\r\n  /**\r\n   * Disables an entire module of middleware in the context.\r\n   * @param middleware - A middleware from the module to disable.\r\n   */\r\n  disableModule(middleware: ISystemMiddleware<IEntity>): void;\r\n\r\n  /**\r\n   * Enables an entire module of middleware in the context.\r\n   * @param middleware - A middleware from the module to enable.\r\n   */\r\n  enableModule(middleware: ISystemMiddleware<IEntity>): void;\r\n}\r\n","/**\r\n * The four phases of entity system execution in each frame.\r\n * Each phase serves a specific purpose in the entity lifecycle and can be extended by custom system types.\r\n * The runtime handles each phase in order, allowing systems to perform stage-specific operations.\r\n */\r\nexport enum SystemType {\r\n  /**\r\n   * Initial setup and resource allocation for the entity.\r\n   * Runs once when the entity is first created or initialized.\r\n   */\r\n  initialize = 0,\r\n\r\n  /**\r\n   * Main logic and state updates for the entity.\r\n   * Runs on every update to change entity behavior and properties.\r\n   */\r\n  update = 1,\r\n\r\n  /**\r\n   * Output and visualization operations.\r\n   * Runs after updates to render or display the entity state.\r\n   */\r\n  render = 2,\r\n\r\n  /**\r\n   * Synchronization and persistence.\r\n   * Runs last to synchronize state with external systems or storage.\r\n   */\r\n  sync = 3\r\n}\r\n"],"mappings":";;AAGA,IAAY,4BAAL,yBAAA,2BAAA;AACL,2BAAA,UAAA;AACA,2BAAA,yBAAA;AACA,2BAAA,0BAAA;AACA,2BAAA,yBAAA;AACA,2BAAA,0BAAA;;KACD;;;;;;;;ACJD,IAAY,aAAL,yBAAA,YAAA;;;;;AAKL,YAAA,WAAA,gBAAA,KAAA;;;;;AAMA,YAAA,WAAA,YAAA,KAAA;;;;;AAMA,YAAA,WAAA,YAAA,KAAA;;;;;AAMA,YAAA,WAAA,UAAA,KAAA;;KACD"}

package/dist/systems/index.d.cts

@@ -1,2 +1,2 @@
-import { S as ISystemContextEvents, _ as ISystemContext, a as ISystemsRuntime, b as ISystemContextRepository, c as ISystemMiddleware, g as IMutableSystemContext, i as ISystemsRuntimeContext, l as ISystemsModule, o as ISystemsModuleRepository, r as ISystemsRuntimeMiddleware, s as ISystemsModuleBuilder, u as SystemType, v as ISystemContextSnapshot, x as ISystemContextProxies, y as ISystemContextScheduler } from "../index-BVkmidEx.cjs";
-export { IMutableSystemContext, ISystemContext, ISystemContextEvents, ISystemContextProxies, ISystemContextRepository, ISystemContextScheduler, ISystemContextSnapshot, ISystemMiddleware, ISystemsModule, ISystemsModuleBuilder, ISystemsModuleRepository, ISystemsRuntime, ISystemsRuntimeContext, ISystemsRuntimeMiddleware, SystemType };
+import { A as SystemModuleName, C as ISystemContextControl, D as MiddlewareRegistry, E as ISystemMiddleware, O as MiddlewareRegistryReadonly, S as ISystemContextEvents, T as SystemContextControlState, _ as ISystemContext, a as ISystemsRuntime, b as ISystemContextRepository, c as ISystemsModuleBuilder, g as IMutableSystemContext, i as ISystemsRuntimeContext, k as SystemMiddlewareName, l as ISystemsModuleBuilderReadonly, o as ISystemsModuleRepository, r as ISystemsRuntimeMiddleware, s as ISystemsModule, u as SystemType, v as ISystemContextSnapshot, w as ISystemContextControlState, x as ISystemContextProxies, y as ISystemContextScheduler } from "../index-zohK7ftH.cjs";
+export { IMutableSystemContext, ISystemContext, ISystemContextControl, ISystemContextControlState, ISystemContextEvents, ISystemContextProxies, ISystemContextRepository, ISystemContextScheduler, ISystemContextSnapshot, ISystemMiddleware, ISystemsModule, ISystemsModuleBuilder, ISystemsModuleBuilderReadonly, ISystemsModuleRepository, ISystemsRuntime, ISystemsRuntimeContext, ISystemsRuntimeMiddleware, MiddlewareRegistry, MiddlewareRegistryReadonly, SystemContextControlState, SystemMiddlewareName, SystemModuleName, SystemType };

package/dist/systems/index.d.mts

@@ -1,2 +1,2 @@
-import { S as ISystemContextEvents, _ as ISystemContext, a as ISystemsRuntime, b as ISystemContextRepository, c as ISystemMiddleware, g as IMutableSystemContext, i as ISystemsRuntimeContext, l as ISystemsModule, o as ISystemsModuleRepository, r as ISystemsRuntimeMiddleware, s as ISystemsModuleBuilder, u as SystemType, v as ISystemContextSnapshot, x as ISystemContextProxies, y as ISystemContextScheduler } from "../index-8XDo0pla.mjs";
-export { IMutableSystemContext, ISystemContext, ISystemContextEvents, ISystemContextProxies, ISystemContextRepository, ISystemContextScheduler, ISystemContextSnapshot, ISystemMiddleware, ISystemsModule, ISystemsModuleBuilder, ISystemsModuleRepository, ISystemsRuntime, ISystemsRuntimeContext, ISystemsRuntimeMiddleware, SystemType };
+import { A as SystemModuleName, C as ISystemContextControl, D as MiddlewareRegistry, E as ISystemMiddleware, O as MiddlewareRegistryReadonly, S as ISystemContextEvents, T as SystemContextControlState, _ as ISystemContext, a as ISystemsRuntime, b as ISystemContextRepository, c as ISystemsModuleBuilder, g as IMutableSystemContext, i as ISystemsRuntimeContext, k as SystemMiddlewareName, l as ISystemsModuleBuilderReadonly, o as ISystemsModuleRepository, r as ISystemsRuntimeMiddleware, s as ISystemsModule, u as SystemType, v as ISystemContextSnapshot, w as ISystemContextControlState, x as ISystemContextProxies, y as ISystemContextScheduler } from "../index-DZlhICMZ.mjs";
+export { IMutableSystemContext, ISystemContext, ISystemContextControl, ISystemContextControlState, ISystemContextEvents, ISystemContextProxies, ISystemContextRepository, ISystemContextScheduler, ISystemContextSnapshot, ISystemMiddleware, ISystemsModule, ISystemsModuleBuilder, ISystemsModuleBuilderReadonly, ISystemsModuleRepository, ISystemsRuntime, ISystemsRuntimeContext, ISystemsRuntimeMiddleware, MiddlewareRegistry, MiddlewareRegistryReadonly, SystemContextControlState, SystemMiddlewareName, SystemModuleName, SystemType };

package/dist/systems/index.mjs

@@ -1,3 +1,13 @@
+//#region src/systems/pipeline/system-context-control.ts
+let SystemContextControlState = /* @__PURE__ */ function(SystemContextControlState) {
+	SystemContextControlState["none"] = "none";
+	SystemContextControlState["enableCurrentSystem"] = "enableCurrentSystem";
+	SystemContextControlState["disableCurrentSystem"] = "disableCurrentSystem";
+	SystemContextControlState["enableCurrentModule"] = "enableCurrentModule";
+	SystemContextControlState["disableCurrentModule"] = "disableCurrentModule";
+	return SystemContextControlState;
+}({});
+//#endregion
 //#region src/systems/system-type.ts
 /**
 * The four phases of entity system execution in each frame.
@@ -28,6 +38,6 @@ let SystemType = /* @__PURE__ */ function(SystemType) {
 	return SystemType;
 }({});
 //#endregion
-export { SystemType };
+export { SystemContextControlState, SystemType };
 
 //# sourceMappingURL=index.mjs.map

package/dist/systems/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/systems/system-type.ts"],"sourcesContent":["/**\r\n * The four phases of entity system execution in each frame.\r\n * Each phase serves a specific purpose in the entity lifecycle and can be extended by custom system types.\r\n * The runtime handles each phase in order, allowing systems to perform stage-specific operations.\r\n */\r\nexport enum SystemType {\r\n  /**\r\n   * Initial setup and resource allocation for the entity.\r\n   * Runs once when the entity is first created or initialized.\r\n   */\r\n  initialize = 0,\r\n\r\n  /**\r\n   * Main logic and state updates for the entity.\r\n   * Runs on every update to change entity behavior and properties.\r\n   */\r\n  update = 1,\r\n\r\n  /**\r\n   * Output and visualization operations.\r\n   * Runs after updates to render or display the entity state.\r\n   */\r\n  render = 2,\r\n\r\n  /**\r\n   * Synchronization and persistence.\r\n   * Runs last to synchronize state with external systems or storage.\r\n   */\r\n  sync = 3\r\n}\r\n"],"mappings":";;;;;;AAKA,IAAY,aAAL,yBAAA,YAAA;;;;;AAKL,YAAA,WAAA,gBAAA,KAAA;;;;;AAMA,YAAA,WAAA,YAAA,KAAA;;;;;AAMA,YAAA,WAAA,YAAA,KAAA;;;;;AAMA,YAAA,WAAA,UAAA,KAAA;;KACD"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/systems/pipeline/system-context-control.ts","../../src/systems/system-type.ts"],"sourcesContent":["import { IEntity } from '@awesome-ecs/abstract/entities';\r\nimport { ISystemMiddleware } from './system-middleware';\r\n\r\nexport enum SystemContextControlState {\r\n  none = 'none',\r\n  enableCurrentSystem = 'enableCurrentSystem',\r\n  disableCurrentSystem = 'disableCurrentSystem',\r\n  enableCurrentModule = 'enableCurrentModule',\r\n  disableCurrentModule = 'disableCurrentModule'\r\n}\r\n\r\n/**\r\n * Interface for controlling the execution of systems and modules within a system context.\r\n * This allows middleware to enable or disable specific systems or entire modules for the current entity.\r\n */\r\nexport interface ISystemContextControl {\r\n  /**\r\n   * Disables the current system for the current entity.\r\n   */\r\n  disableCurrentSystem(): void;\r\n\r\n  /**\r\n   * Re-enables the current system for the current entity.\r\n   */\r\n  enableCurrentSystem(): void;\r\n\r\n  /**\r\n   * Disables the current module for the current entity.\r\n   */\r\n  disableCurrentModule(): void;\r\n\r\n  /**\r\n   * Re-enables the current module for the current entity.\r\n   */\r\n  enableCurrentModule(): void;\r\n}\r\n\r\n/**\r\n * Extended system context interface that includes control state for middleware to manage system and module execution.\r\n * This allows middleware to query and modify the execution state of systems and modules during pipeline processing.\r\n */\r\nexport interface ISystemContextControlState extends ISystemContextControl {\r\n  /**\r\n   * Current state of system/module execution control, indicating whether the current system or module is enabled or disabled.\r\n   */\r\n  readonly state: SystemContextControlState;\r\n\r\n  /**\r\n   * Checks if a specific middleware is currently disabled in the context, allowing middleware to conditionally execute logic based on the enabled/disabled state of other middleware.\r\n   * @param middleware - The middleware to check for disabled state.\r\n   * @returns True if the specified middleware is currently disabled, false otherwise.\r\n   */\r\n  isMiddlewareDisabled(middleware: ISystemMiddleware<IEntity>): boolean;\r\n\r\n  /**\r\n   * Disables a specific middleware in the context.\r\n   * @param middleware - The middleware to disable.\r\n   */\r\n  disableMiddleware(middleware: ISystemMiddleware<IEntity>): void;\r\n\r\n  /**\r\n   * Enables a specific middleware in the context.\r\n   * @param middleware - The middleware to enable.\r\n   */\r\n  enableMiddleware(middleware: ISystemMiddleware<IEntity>): void;\r\n\r\n  /**\r\n   * Disables an entire module of middleware in the context.\r\n   * @param middleware - A middleware from the module to disable.\r\n   */\r\n  disableModule(middleware: ISystemMiddleware<IEntity>): void;\r\n\r\n  /**\r\n   * Enables an entire module of middleware in the context.\r\n   * @param middleware - A middleware from the module to enable.\r\n   */\r\n  enableModule(middleware: ISystemMiddleware<IEntity>): void;\r\n}\r\n","/**\r\n * The four phases of entity system execution in each frame.\r\n * Each phase serves a specific purpose in the entity lifecycle and can be extended by custom system types.\r\n * The runtime handles each phase in order, allowing systems to perform stage-specific operations.\r\n */\r\nexport enum SystemType {\r\n  /**\r\n   * Initial setup and resource allocation for the entity.\r\n   * Runs once when the entity is first created or initialized.\r\n   */\r\n  initialize = 0,\r\n\r\n  /**\r\n   * Main logic and state updates for the entity.\r\n   * Runs on every update to change entity behavior and properties.\r\n   */\r\n  update = 1,\r\n\r\n  /**\r\n   * Output and visualization operations.\r\n   * Runs after updates to render or display the entity state.\r\n   */\r\n  render = 2,\r\n\r\n  /**\r\n   * Synchronization and persistence.\r\n   * Runs last to synchronize state with external systems or storage.\r\n   */\r\n  sync = 3\r\n}\r\n"],"mappings":";AAGA,IAAY,4BAAL,yBAAA,2BAAA;AACL,2BAAA,UAAA;AACA,2BAAA,yBAAA;AACA,2BAAA,0BAAA;AACA,2BAAA,yBAAA;AACA,2BAAA,0BAAA;;KACD;;;;;;;;ACJD,IAAY,aAAL,yBAAA,YAAA;;;;;AAKL,YAAA,WAAA,gBAAA,KAAA;;;;;AAMA,YAAA,WAAA,YAAA,KAAA;;;;;AAMA,YAAA,WAAA,YAAA,KAAA;;;;;AAMA,YAAA,WAAA,UAAA,KAAA;;KACD"}

package/dist/utils/index.d.cts

@@ -1,3 +1,3 @@
 import { a as ImmutableArray, c as ImmutableObjectDeep, d as MutableDeep, i as Immutable, l as ImmutableSet, o as ImmutableMap, r as BooleanProps, s as ImmutableObject, u as Mutable } from "../identity-component-DLDaOTyK.cjs";
-import { B as TickSnapshot, F as PerformanceTimeEntry, G as dispatchSequential, H as ILoggerOptions, I as PerformanceTimerUid, L as MiddlewareMetricsSummary, N as IPerformanceTimer, P as PerformanceMetricOptions, R as RenderSnapshot, U as LogLevel, V as ILogger, W as IJsonSerializer, z as TickMetricEntry } from "../index-BVkmidEx.cjs";
+import { $ as dispatchSequential, G as MiddlewareMetricsSummary, H as PerformanceMetricOptions, J as TickSnapshot, K as RenderSnapshot, Q as IJsonSerializer, U as PerformanceTimeEntry, V as IPerformanceTimer, W as PerformanceTimerUid, X as ILoggerOptions, Y as ILogger, Z as LogLevel, q as TickMetricEntry } from "../index-zohK7ftH.cjs";
 export { BooleanProps, IJsonSerializer, ILogger, ILoggerOptions, IPerformanceTimer, Immutable, ImmutableArray, ImmutableMap, ImmutableObject, ImmutableObjectDeep, ImmutableSet, LogLevel, MiddlewareMetricsSummary, Mutable, MutableDeep, PerformanceMetricOptions, PerformanceTimeEntry, PerformanceTimerUid, RenderSnapshot, TickMetricEntry, TickSnapshot, dispatchSequential };

package/dist/utils/index.d.mts

@@ -1,3 +1,3 @@
 import { a as ImmutableArray, c as ImmutableObjectDeep, d as MutableDeep, i as Immutable, l as ImmutableSet, o as ImmutableMap, r as BooleanProps, s as ImmutableObject, u as Mutable } from "../identity-component-CuWHf7jX.mjs";
-import { B as TickSnapshot, F as PerformanceTimeEntry, G as dispatchSequential, H as ILoggerOptions, I as PerformanceTimerUid, L as MiddlewareMetricsSummary, N as IPerformanceTimer, P as PerformanceMetricOptions, R as RenderSnapshot, U as LogLevel, V as ILogger, W as IJsonSerializer, z as TickMetricEntry } from "../index-8XDo0pla.mjs";
+import { $ as dispatchSequential, G as MiddlewareMetricsSummary, H as PerformanceMetricOptions, J as TickSnapshot, K as RenderSnapshot, Q as IJsonSerializer, U as PerformanceTimeEntry, V as IPerformanceTimer, W as PerformanceTimerUid, X as ILoggerOptions, Y as ILogger, Z as LogLevel, q as TickMetricEntry } from "../index-DZlhICMZ.mjs";
 export { BooleanProps, IJsonSerializer, ILogger, ILoggerOptions, IPerformanceTimer, Immutable, ImmutableArray, ImmutableMap, ImmutableObject, ImmutableObjectDeep, ImmutableSet, LogLevel, MiddlewareMetricsSummary, Mutable, MutableDeep, PerformanceMetricOptions, PerformanceTimeEntry, PerformanceTimerUid, RenderSnapshot, TickMetricEntry, TickSnapshot, dispatchSequential };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesome-ecs/abstract",
-  "version": "0.30.0",
+  "version": "0.31.0",
   "description": "A comprehensive Entity-Component-System (ECS) Architecture implementation. Abstract components.",
   "type": "module",
   "scripts": {
@@ -97,5 +97,5 @@
     "url": "https://github.com/privatebytes/awesome-ecs/issues"
   },
   "homepage": "https://github.com/privatebytes/awesome-ecs#readme",
-  "gitHead": "e4f5e0176478cb0e32364b0df375c537acbdcb66"
+  "gitHead": "23e307e2b48e442855dc940daad1c18985d9d94d"
 }