@awesome-ecs/abstract 0.28.0 → 0.30.0

package/dist/{index-C1Ojam4M.d.cts → index-BguFn1Xj.d.cts}

@@ -1,5 +1,58 @@
-import { a as IEntity, c as IEntityProxy, n as IdentityComponent, o as IEntityModel, p as IComponent, r as EntityTypeUid } from "./identity-component-uU0yDR-y.cjs";
+import { S as IComponent, _ as IEntityProxy, f as EntityTypeUid, h as IEntityModel, m as IEntity, n as IdentityComponent, p as EntityUid } from "./identity-component-DLDaOTyK.cjs";
 
+//#region src/entities/entity-context-cache.d.ts
+/**
+ * A generic per-entity key-value store for runtime contexts.
+ *
+ * Each package registers its own per-entity data using its own key constants.
+ * Disposal removes all entries for an entity in a single call, covering all packages.
+ *
+ * @example
+ * // Core stores SystemContext:
+ * cache.set(entityUid, SYSTEM_KEY, systemContext);
+ *
+ * // AI stores per-module StateContexts:
+ * cache.set(entityUid, `state:${moduleName}`, stateContext);
+ *
+ * // On removal, one call cleans up everything:
+ * cache.disposeEntity(entityUid);
+ */
+interface IEntityContextCache {
+  /**
+   * Retrieves a cached value by entity UID and key.
+   * @template T - The expected value type.
+   * @param entityUid - The entity's unique identifier.
+   * @param key - The key to look up.
+   * @returns The cached value, or undefined if not found.
+   */
+  get<T>(entityUid: EntityUid, key: string | symbol): T | undefined;
+  /**
+   * Stores a value for an entity under the given key.
+   * @param entityUid - The entity's unique identifier.
+   * @param key - The key to store under.
+   * @param value - The value to cache.
+   */
+  set(entityUid: EntityUid, key: string | symbol, value: unknown): void;
+  /**
+   * Checks whether a cached entry exists.
+   * @param entityUid - The entity's unique identifier.
+   * @param key - Optional key to check. If omitted, checks if any entry exists for the entity.
+   */
+  has(entityUid: EntityUid, key?: string | symbol): boolean;
+  /**
+   * Returns an iterator over all key-value pairs cached for the given entity.
+   * @param entityUid - The entity's unique identifier.
+   * @returns An iterable iterator of [key, value] pairs, or undefined if the entity has no entries.
+   */
+  getEntries(entityUid: EntityUid): IterableIterator<[string | symbol, unknown]> | undefined;
+  /**
+   * Removes all cached entries for the given entity.
+   * Should be called when an entity is removed from the system.
+   * @param entityUid - The entity's unique identifier.
+   */
+  disposeEntity(entityUid: EntityUid): void;
+}
+//#endregion
 //#region src/entities/entity-events.d.ts
 /**
  * Represents a unique identifier for an entity event.
@@ -255,6 +308,12 @@ interface IEntityUpdateQueue {
    * @returns The next update in the queue.
    */
   peek(): IEntityUpdate;
+  /**
+   * Returns a read-only snapshot of all queued updates without removing them.
+   * Useful for inspection/debugging UIs.
+   * @returns An array of all currently queued updates.
+   */
+  items(): ReadonlyArray<IEntityUpdate>;
   /**
    * Removes all updates from the queue.
    */
@@ -411,5 +470,5 @@ interface IEntityScheduler {
   resume(): void;
 }
 //#endregion
-export { EntityUpdateType as a, IEntitySnapshot as c, EntityEventSubscriptionOptions as d, EntityEventUid as f, IEventData as g, IEntityEventsManager as h, IEntityRepository as i, IEntitySnapshotProvider as l, IEntityEventsDispatcher as m, IEntityScheduler as n, IEntityUpdate as o, IEntityEvent as p, SchedulerPauseType as r, IEntityUpdateQueue as s, EntitySchedule as t, EntityEventSubscriptionFilter as u };
-//# sourceMappingURL=index-C1Ojam4M.d.cts.map
+export { IEntityContextCache as _, EntityUpdateType as a, IEntitySnapshot as c, EntityEventSubscriptionOptions as d, EntityEventUid as f, IEventData as g, IEntityEventsManager as h, IEntityRepository as i, IEntitySnapshotProvider as l, IEntityEventsDispatcher as m, IEntityScheduler as n, IEntityUpdate as o, IEntityEvent as p, SchedulerPauseType as r, IEntityUpdateQueue as s, EntitySchedule as t, EntityEventSubscriptionFilter as u };
+//# sourceMappingURL=index-BguFn1Xj.d.cts.map

package/dist/{index-C0v9GTM7.d.mts → index-kNcUiDBd.d.mts}

@@ -1,5 +1,58 @@
-import { a as IEntity, c as IEntityProxy, n as IdentityComponent, o as IEntityModel, p as IComponent, r as EntityTypeUid } from "./identity-component-CgzvgBVh.mjs";
+import { S as IComponent, _ as IEntityProxy, f as EntityTypeUid, h as IEntityModel, m as IEntity, n as IdentityComponent, p as EntityUid } from "./identity-component-CuWHf7jX.mjs";
 
+//#region src/entities/entity-context-cache.d.ts
+/**
+ * A generic per-entity key-value store for runtime contexts.
+ *
+ * Each package registers its own per-entity data using its own key constants.
+ * Disposal removes all entries for an entity in a single call, covering all packages.
+ *
+ * @example
+ * // Core stores SystemContext:
+ * cache.set(entityUid, SYSTEM_KEY, systemContext);
+ *
+ * // AI stores per-module StateContexts:
+ * cache.set(entityUid, `state:${moduleName}`, stateContext);
+ *
+ * // On removal, one call cleans up everything:
+ * cache.disposeEntity(entityUid);
+ */
+interface IEntityContextCache {
+  /**
+   * Retrieves a cached value by entity UID and key.
+   * @template T - The expected value type.
+   * @param entityUid - The entity's unique identifier.
+   * @param key - The key to look up.
+   * @returns The cached value, or undefined if not found.
+   */
+  get<T>(entityUid: EntityUid, key: string | symbol): T | undefined;
+  /**
+   * Stores a value for an entity under the given key.
+   * @param entityUid - The entity's unique identifier.
+   * @param key - The key to store under.
+   * @param value - The value to cache.
+   */
+  set(entityUid: EntityUid, key: string | symbol, value: unknown): void;
+  /**
+   * Checks whether a cached entry exists.
+   * @param entityUid - The entity's unique identifier.
+   * @param key - Optional key to check. If omitted, checks if any entry exists for the entity.
+   */
+  has(entityUid: EntityUid, key?: string | symbol): boolean;
+  /**
+   * Returns an iterator over all key-value pairs cached for the given entity.
+   * @param entityUid - The entity's unique identifier.
+   * @returns An iterable iterator of [key, value] pairs, or undefined if the entity has no entries.
+   */
+  getEntries(entityUid: EntityUid): IterableIterator<[string | symbol, unknown]> | undefined;
+  /**
+   * Removes all cached entries for the given entity.
+   * Should be called when an entity is removed from the system.
+   * @param entityUid - The entity's unique identifier.
+   */
+  disposeEntity(entityUid: EntityUid): void;
+}
+//#endregion
 //#region src/entities/entity-events.d.ts
 /**
  * Represents a unique identifier for an entity event.
@@ -255,6 +308,12 @@ interface IEntityUpdateQueue {
    * @returns The next update in the queue.
    */
   peek(): IEntityUpdate;
+  /**
+   * Returns a read-only snapshot of all queued updates without removing them.
+   * Useful for inspection/debugging UIs.
+   * @returns An array of all currently queued updates.
+   */
+  items(): ReadonlyArray<IEntityUpdate>;
   /**
    * Removes all updates from the queue.
    */
@@ -411,5 +470,5 @@ interface IEntityScheduler {
   resume(): void;
 }
 //#endregion
-export { EntityUpdateType as a, IEntitySnapshot as c, EntityEventSubscriptionOptions as d, EntityEventUid as f, IEventData as g, IEntityEventsManager as h, IEntityRepository as i, IEntitySnapshotProvider as l, IEntityEventsDispatcher as m, IEntityScheduler as n, IEntityUpdate as o, IEntityEvent as p, SchedulerPauseType as r, IEntityUpdateQueue as s, EntitySchedule as t, EntityEventSubscriptionFilter as u };
-//# sourceMappingURL=index-C0v9GTM7.d.mts.map
+export { IEntityContextCache as _, EntityUpdateType as a, IEntitySnapshot as c, EntityEventSubscriptionOptions as d, EntityEventUid as f, IEventData as g, IEntityEventsManager as h, IEntityRepository as i, IEntitySnapshotProvider as l, IEntityEventsDispatcher as m, IEntityScheduler as n, IEntityUpdate as o, IEntityEvent as p, SchedulerPauseType as r, IEntityUpdateQueue as s, EntitySchedule as t, EntityEventSubscriptionFilter as u };
+//# sourceMappingURL=index-kNcUiDBd.d.mts.map

package/dist/pipelines/index.d.cts

@@ -1,2 +1,2 @@
-import { a as IParentMiddleware, c as IMiddleware, i as IParentContext, l as IPipelineContext, n as INestedContext, o as IPipeline, r as INestedMiddleware, s as IMiddlewareRunner, t as IPipelineRunner, u as PipelineRuntime } from "../index-BQojRXVz.cjs";
+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";
 export { IMiddleware, IMiddlewareRunner, INestedContext, INestedMiddleware, IParentContext, IParentMiddleware, IPipeline, IPipelineContext, IPipelineRunner, PipelineRuntime };

package/dist/pipelines/index.d.mts

@@ -1,2 +1,2 @@
-import { a as IParentMiddleware, c as IMiddleware, i as IParentContext, l as IPipelineContext, n as INestedContext, o as IPipeline, r as INestedMiddleware, s as IMiddlewareRunner, t as IPipelineRunner, u as PipelineRuntime } from "../index-DeYfvKO0.mjs";
+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";
 export { IMiddleware, IMiddlewareRunner, INestedContext, INestedMiddleware, IParentContext, IParentMiddleware, IPipeline, IPipelineContext, IPipelineRunner, PipelineRuntime };

package/dist/pipelines/index.mjs

@@ -1 +1 @@
-export {  };
+export {};

package/dist/systems/index.cjs

@@ -1,4 +1,4 @@
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/systems/system-type.ts
 /**
 * The four phases of entity system execution in each frame.
@@ -28,7 +28,7 @@ let SystemType = /* @__PURE__ */ function(SystemType) {
 	SystemType[SystemType["sync"] = 3] = "sync";
 	return SystemType;
 }({});
-
 //#endregion
 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,kDAAL;;;;;AAKL;;;;;AAMA;;;;;AAMA;;;;;AAMA"}
+{"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"}

package/dist/systems/index.d.cts

@@ -1,2 +1,2 @@
-import { a as ISystemsModuleRepository, c as ISystemsModule, d as ISystemContextSnapshot, f as ISystemContextScheduler, h as ISystemContextEvents, i as ISystemContextEntity, l as SystemType, m as ISystemContextProxies, n as ISystemsRuntimeContext, o as ISystemsModuleBuilder, p as ISystemContextRepository, r as ISystemsRuntime, s as ISystemMiddleware, t as ISystemsRuntimeMiddleware, u as ISystemContext } from "../index-CrMUhuEK.cjs";
-export { ISystemContext, ISystemContextEntity, ISystemContextEvents, ISystemContextProxies, ISystemContextRepository, ISystemContextScheduler, ISystemContextSnapshot, ISystemMiddleware, ISystemsModule, ISystemsModuleBuilder, ISystemsModuleRepository, ISystemsRuntime, ISystemsRuntimeContext, ISystemsRuntimeMiddleware, SystemType };
+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 };

package/dist/systems/index.d.mts

@@ -1,2 +1,2 @@
-import { a as ISystemsModuleRepository, c as ISystemsModule, d as ISystemContextSnapshot, f as ISystemContextScheduler, h as ISystemContextEvents, i as ISystemContextEntity, l as SystemType, m as ISystemContextProxies, n as ISystemsRuntimeContext, o as ISystemsModuleBuilder, p as ISystemContextRepository, r as ISystemsRuntime, s as ISystemMiddleware, t as ISystemsRuntimeMiddleware, u as ISystemContext } from "../index-DQYLun1o.mjs";
-export { ISystemContext, ISystemContextEntity, ISystemContextEvents, ISystemContextProxies, ISystemContextRepository, ISystemContextScheduler, ISystemContextSnapshot, ISystemMiddleware, ISystemsModule, ISystemsModuleBuilder, ISystemsModuleRepository, ISystemsRuntime, ISystemsRuntimeContext, ISystemsRuntimeMiddleware, SystemType };
+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 };

package/dist/systems/index.mjs

@@ -27,7 +27,7 @@ let SystemType = /* @__PURE__ */ function(SystemType) {
 	SystemType[SystemType["sync"] = 3] = "sync";
 	return SystemType;
 }({});
-
 //#endregion
 export { 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,kDAAL;;;;;AAKL;;;;;AAMA;;;;;AAMA;;;;;AAMA"}
+{"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"}

package/dist/utils/index.cjs

@@ -1,4 +1,4 @@
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/utils/dispatch-sequential.ts
 /**
 * Executes a function for each item in an iterable, sequentially.
@@ -25,7 +25,6 @@ async function continueAsync(iterator, fn, pending) {
 		if (result instanceof Promise) await result;
 	}
 }
-
 //#endregion
 //#region src/utils/logger.ts
 /**
@@ -50,8 +49,8 @@ let LogLevel = /* @__PURE__ */ function(LogLevel) {
 	LogLevel[LogLevel["error"] = 3] = "error";
 	return LogLevel;
 }({});
-
 //#endregion
 exports.LogLevel = LogLevel;
 exports.dispatchSequential = dispatchSequential;
+
 //# sourceMappingURL=index.cjs.map

package/dist/utils/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../src/utils/dispatch-sequential.ts","../../src/utils/logger.ts"],"sourcesContent":["/**\r\n * Executes a function for each item in an iterable, sequentially.\r\n *\r\n * Uses a sync fast-path: iterates synchronously until the first Promise is\r\n * encountered, then switches to async for the remainder. If no item produces\r\n * a Promise, the entire call stays synchronous with zero async overhead.\r\n *\r\n * @param items - The iterable to iterate over.\r\n * @param fn - The function to call for each item. May return void or a Promise.\r\n * @returns void if all calls were synchronous, or a Promise if any were async.\r\n */\r\nexport function dispatchSequential<T>(\r\n  items: Iterable<T>,\r\n  fn: (item: T) => void | Promise<void>\r\n): void | Promise<void> {\r\n  const iterator = items[Symbol.iterator]();\r\n\r\n  for (let next = iterator.next(); !next.done; next = iterator.next()) {\r\n    const result = fn(next.value);\r\n\r\n    if (result instanceof Promise) {\r\n      return continueAsync(iterator, fn, result);\r\n    }\r\n  }\r\n}\r\n\r\nasync function continueAsync<T>(\r\n  iterator: Iterator<T>,\r\n  fn: (item: T) => void | Promise<void>,\r\n  pending: Promise<void>\r\n): Promise<void> {\r\n  await pending;\r\n\r\n  for (let next = iterator.next(); !next.done; next = iterator.next()) {\r\n    const result = fn(next.value);\r\n\r\n    if (result instanceof Promise) {\r\n      await result;\r\n    }\r\n  }\r\n}\r\n","/**\r\n * Logger interface for debug and diagnostic output.\r\n * Supports multiple log levels for controlling verbosity.\r\n * Implementations can target different outputs (console, file, remote, etc.).\r\n */\r\nexport interface ILogger {\r\n  /**\r\n   * Logs a message with a specified severity level.\r\n   * @param level - The severity level of the message.\r\n   * @param message - The primary message content.\r\n   * @param args - Additional arguments to include in the log output.\r\n   */\r\n  log(level: LogLevel, message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs detailed diagnostic information.\r\n   * Typically the lowest level, most verbose output.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  trace(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs debug-level information.\r\n   * Useful during development and troubleshooting.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  debug(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs warning-level messages.\r\n   * Indicates potentially problematic conditions.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  warn(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs error-level messages.\r\n   * Indicates error conditions that may require attention.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  error(message: any, ...args: any[]): void;\r\n}\r\n\r\n/**\r\n * Logging severity levels in increasing order.\r\n */\r\nexport enum LogLevel {\r\n  /**\r\n   * Most detailed, diagnostic-level logging.\r\n   */\r\n  trace,\r\n\r\n  /**\r\n   * Development and debugging information.\r\n   */\r\n  debug,\r\n\r\n  /**\r\n   * Warning-level conditions.\r\n   */\r\n  warn,\r\n\r\n  /**\r\n   * Error-level conditions.\r\n   */\r\n  error\r\n}\r\n\r\n/**\r\n * Configuration options for logger instances.\r\n */\r\nexport interface ILoggerOptions {\r\n  /**\r\n   * Enables/disables each log level.\r\n   * If a level is disabled, log calls at that level are ignored.\r\n   */\r\n  enabled: Map<LogLevel, boolean>;\r\n}\r\n"],"mappings":";;;;;;;;;;;;;AAWA,SAAgB,mBACd,OACA,IACsB;CACtB,MAAM,WAAW,MAAM,OAAO,WAAW;AAEzC,MAAK,IAAI,OAAO,SAAS,MAAM,EAAE,CAAC,KAAK,MAAM,OAAO,SAAS,MAAM,EAAE;EACnE,MAAM,SAAS,GAAG,KAAK,MAAM;AAE7B,MAAI,kBAAkB,QACpB,QAAO,cAAc,UAAU,IAAI,OAAO;;;AAKhD,eAAe,cACb,UACA,IACA,SACe;AACf,OAAM;AAEN,MAAK,IAAI,OAAO,SAAS,MAAM,EAAE,CAAC,KAAK,MAAM,OAAO,SAAS,MAAM,EAAE;EACnE,MAAM,SAAS,GAAG,KAAK,MAAM;AAE7B,MAAI,kBAAkB,QACpB,OAAM;;;;;;;;;ACaZ,IAAY,8CAAL;;;;AAIL;;;;AAKA;;;;AAKA;;;;AAKA"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/utils/dispatch-sequential.ts","../../src/utils/logger.ts"],"sourcesContent":["/**\r\n * Executes a function for each item in an iterable, sequentially.\r\n *\r\n * Uses a sync fast-path: iterates synchronously until the first Promise is\r\n * encountered, then switches to async for the remainder. If no item produces\r\n * a Promise, the entire call stays synchronous with zero async overhead.\r\n *\r\n * @param items - The iterable to iterate over.\r\n * @param fn - The function to call for each item. May return void or a Promise.\r\n * @returns void if all calls were synchronous, or a Promise if any were async.\r\n */\r\nexport function dispatchSequential<T>(\r\n  items: Iterable<T>,\r\n  fn: (item: T) => void | Promise<void>\r\n): void | Promise<void> {\r\n  const iterator = items[Symbol.iterator]();\r\n\r\n  for (let next = iterator.next(); !next.done; next = iterator.next()) {\r\n    const result = fn(next.value);\r\n\r\n    if (result instanceof Promise) {\r\n      return continueAsync(iterator, fn, result);\r\n    }\r\n  }\r\n}\r\n\r\nasync function continueAsync<T>(\r\n  iterator: Iterator<T>,\r\n  fn: (item: T) => void | Promise<void>,\r\n  pending: Promise<void>\r\n): Promise<void> {\r\n  await pending;\r\n\r\n  for (let next = iterator.next(); !next.done; next = iterator.next()) {\r\n    const result = fn(next.value);\r\n\r\n    if (result instanceof Promise) {\r\n      await result;\r\n    }\r\n  }\r\n}\r\n","/**\r\n * Logger interface for debug and diagnostic output.\r\n * Supports multiple log levels for controlling verbosity.\r\n * Implementations can target different outputs (console, file, remote, etc.).\r\n */\r\nexport interface ILogger {\r\n  /**\r\n   * Logs a message with a specified severity level.\r\n   * @param level - The severity level of the message.\r\n   * @param message - The primary message content.\r\n   * @param args - Additional arguments to include in the log output.\r\n   */\r\n  log(level: LogLevel, message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs detailed diagnostic information.\r\n   * Typically the lowest level, most verbose output.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  trace(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs debug-level information.\r\n   * Useful during development and troubleshooting.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  debug(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs warning-level messages.\r\n   * Indicates potentially problematic conditions.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  warn(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs error-level messages.\r\n   * Indicates error conditions that may require attention.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  error(message: any, ...args: any[]): void;\r\n}\r\n\r\n/**\r\n * Logging severity levels in increasing order.\r\n */\r\nexport enum LogLevel {\r\n  /**\r\n   * Most detailed, diagnostic-level logging.\r\n   */\r\n  trace,\r\n\r\n  /**\r\n   * Development and debugging information.\r\n   */\r\n  debug,\r\n\r\n  /**\r\n   * Warning-level conditions.\r\n   */\r\n  warn,\r\n\r\n  /**\r\n   * Error-level conditions.\r\n   */\r\n  error\r\n}\r\n\r\n/**\r\n * Configuration options for logger instances.\r\n */\r\nexport interface ILoggerOptions {\r\n  /**\r\n   * Enables/disables each log level.\r\n   * If a level is disabled, log calls at that level are ignored.\r\n   */\r\n  enabled: Map<LogLevel, boolean>;\r\n}\r\n"],"mappings":";;;;;;;;;;;;;AAWA,SAAgB,mBACd,OACA,IACsB;CACtB,MAAM,WAAW,MAAM,OAAO,WAAW;AAEzC,MAAK,IAAI,OAAO,SAAS,MAAM,EAAE,CAAC,KAAK,MAAM,OAAO,SAAS,MAAM,EAAE;EACnE,MAAM,SAAS,GAAG,KAAK,MAAM;AAE7B,MAAI,kBAAkB,QACpB,QAAO,cAAc,UAAU,IAAI,OAAO;;;AAKhD,eAAe,cACb,UACA,IACA,SACe;AACf,OAAM;AAEN,MAAK,IAAI,OAAO,SAAS,MAAM,EAAE,CAAC,KAAK,MAAM,OAAO,SAAS,MAAM,EAAE;EACnE,MAAM,SAAS,GAAG,KAAK,MAAM;AAE7B,MAAI,kBAAkB,QACpB,OAAM;;;;;;;;ACaZ,IAAY,WAAL,yBAAA,UAAA;;;;AAIL,UAAA,SAAA,WAAA,KAAA;;;;AAKA,UAAA,SAAA,WAAA,KAAA;;;;AAKA,UAAA,SAAA,UAAA,KAAA;;;;AAKA,UAAA,SAAA,WAAA,KAAA;;KACD"}

package/dist/utils/index.d.cts

@@ -1,3 +1,3 @@
-import { a as ImmutableObject, c as Mutable, i as ImmutableMap, l as MutableDeep, n as Immutable, o as ImmutableObjectDeep, r as ImmutableArray, s as ImmutableSet, t as BooleanProps } from "../types-DLOd2zXO.cjs";
-import { a as ILogger, c as IJsonSerializer, i as PerformanceTimerUid, l as dispatchSequential, n as PerformanceMetricOptions, o as ILoggerOptions, r as PerformanceTimeEntry, s as LogLevel, t as IPerformanceTimer } from "../index-Cs9Eerjt.cjs";
-export { BooleanProps, IJsonSerializer, ILogger, ILoggerOptions, IPerformanceTimer, Immutable, ImmutableArray, ImmutableMap, ImmutableObject, ImmutableObjectDeep, ImmutableSet, LogLevel, Mutable, MutableDeep, PerformanceMetricOptions, PerformanceTimeEntry, PerformanceTimerUid, dispatchSequential };
+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";
+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 ImmutableObject, c as Mutable, i as ImmutableMap, l as MutableDeep, n as Immutable, o as ImmutableObjectDeep, r as ImmutableArray, s as ImmutableSet, t as BooleanProps } from "../types-CnDtpKsY.mjs";
-import { a as ILogger, c as IJsonSerializer, i as PerformanceTimerUid, l as dispatchSequential, n as PerformanceMetricOptions, o as ILoggerOptions, r as PerformanceTimeEntry, s as LogLevel, t as IPerformanceTimer } from "../index-hHkhvmkO.mjs";
-export { BooleanProps, IJsonSerializer, ILogger, ILoggerOptions, IPerformanceTimer, Immutable, ImmutableArray, ImmutableMap, ImmutableObject, ImmutableObjectDeep, ImmutableSet, LogLevel, Mutable, MutableDeep, PerformanceMetricOptions, PerformanceTimeEntry, PerformanceTimerUid, dispatchSequential };
+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";
+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.mjs

@@ -24,7 +24,6 @@ async function continueAsync(iterator, fn, pending) {
 		if (result instanceof Promise) await result;
 	}
 }
-
 //#endregion
 //#region src/utils/logger.ts
 /**
@@ -49,7 +48,7 @@ let LogLevel = /* @__PURE__ */ function(LogLevel) {
 	LogLevel[LogLevel["error"] = 3] = "error";
 	return LogLevel;
 }({});
-
 //#endregion
 export { LogLevel, dispatchSequential };
+
 //# sourceMappingURL=index.mjs.map

package/dist/utils/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/utils/dispatch-sequential.ts","../../src/utils/logger.ts"],"sourcesContent":["/**\r\n * Executes a function for each item in an iterable, sequentially.\r\n *\r\n * Uses a sync fast-path: iterates synchronously until the first Promise is\r\n * encountered, then switches to async for the remainder. If no item produces\r\n * a Promise, the entire call stays synchronous with zero async overhead.\r\n *\r\n * @param items - The iterable to iterate over.\r\n * @param fn - The function to call for each item. May return void or a Promise.\r\n * @returns void if all calls were synchronous, or a Promise if any were async.\r\n */\r\nexport function dispatchSequential<T>(\r\n  items: Iterable<T>,\r\n  fn: (item: T) => void | Promise<void>\r\n): void | Promise<void> {\r\n  const iterator = items[Symbol.iterator]();\r\n\r\n  for (let next = iterator.next(); !next.done; next = iterator.next()) {\r\n    const result = fn(next.value);\r\n\r\n    if (result instanceof Promise) {\r\n      return continueAsync(iterator, fn, result);\r\n    }\r\n  }\r\n}\r\n\r\nasync function continueAsync<T>(\r\n  iterator: Iterator<T>,\r\n  fn: (item: T) => void | Promise<void>,\r\n  pending: Promise<void>\r\n): Promise<void> {\r\n  await pending;\r\n\r\n  for (let next = iterator.next(); !next.done; next = iterator.next()) {\r\n    const result = fn(next.value);\r\n\r\n    if (result instanceof Promise) {\r\n      await result;\r\n    }\r\n  }\r\n}\r\n","/**\r\n * Logger interface for debug and diagnostic output.\r\n * Supports multiple log levels for controlling verbosity.\r\n * Implementations can target different outputs (console, file, remote, etc.).\r\n */\r\nexport interface ILogger {\r\n  /**\r\n   * Logs a message with a specified severity level.\r\n   * @param level - The severity level of the message.\r\n   * @param message - The primary message content.\r\n   * @param args - Additional arguments to include in the log output.\r\n   */\r\n  log(level: LogLevel, message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs detailed diagnostic information.\r\n   * Typically the lowest level, most verbose output.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  trace(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs debug-level information.\r\n   * Useful during development and troubleshooting.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  debug(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs warning-level messages.\r\n   * Indicates potentially problematic conditions.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  warn(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs error-level messages.\r\n   * Indicates error conditions that may require attention.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  error(message: any, ...args: any[]): void;\r\n}\r\n\r\n/**\r\n * Logging severity levels in increasing order.\r\n */\r\nexport enum LogLevel {\r\n  /**\r\n   * Most detailed, diagnostic-level logging.\r\n   */\r\n  trace,\r\n\r\n  /**\r\n   * Development and debugging information.\r\n   */\r\n  debug,\r\n\r\n  /**\r\n   * Warning-level conditions.\r\n   */\r\n  warn,\r\n\r\n  /**\r\n   * Error-level conditions.\r\n   */\r\n  error\r\n}\r\n\r\n/**\r\n * Configuration options for logger instances.\r\n */\r\nexport interface ILoggerOptions {\r\n  /**\r\n   * Enables/disables each log level.\r\n   * If a level is disabled, log calls at that level are ignored.\r\n   */\r\n  enabled: Map<LogLevel, boolean>;\r\n}\r\n"],"mappings":";;;;;;;;;;;;AAWA,SAAgB,mBACd,OACA,IACsB;CACtB,MAAM,WAAW,MAAM,OAAO,WAAW;AAEzC,MAAK,IAAI,OAAO,SAAS,MAAM,EAAE,CAAC,KAAK,MAAM,OAAO,SAAS,MAAM,EAAE;EACnE,MAAM,SAAS,GAAG,KAAK,MAAM;AAE7B,MAAI,kBAAkB,QACpB,QAAO,cAAc,UAAU,IAAI,OAAO;;;AAKhD,eAAe,cACb,UACA,IACA,SACe;AACf,OAAM;AAEN,MAAK,IAAI,OAAO,SAAS,MAAM,EAAE,CAAC,KAAK,MAAM,OAAO,SAAS,MAAM,EAAE;EACnE,MAAM,SAAS,GAAG,KAAK,MAAM;AAE7B,MAAI,kBAAkB,QACpB,OAAM;;;;;;;;;ACaZ,IAAY,8CAAL;;;;AAIL;;;;AAKA;;;;AAKA;;;;AAKA"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/utils/dispatch-sequential.ts","../../src/utils/logger.ts"],"sourcesContent":["/**\r\n * Executes a function for each item in an iterable, sequentially.\r\n *\r\n * Uses a sync fast-path: iterates synchronously until the first Promise is\r\n * encountered, then switches to async for the remainder. If no item produces\r\n * a Promise, the entire call stays synchronous with zero async overhead.\r\n *\r\n * @param items - The iterable to iterate over.\r\n * @param fn - The function to call for each item. May return void or a Promise.\r\n * @returns void if all calls were synchronous, or a Promise if any were async.\r\n */\r\nexport function dispatchSequential<T>(\r\n  items: Iterable<T>,\r\n  fn: (item: T) => void | Promise<void>\r\n): void | Promise<void> {\r\n  const iterator = items[Symbol.iterator]();\r\n\r\n  for (let next = iterator.next(); !next.done; next = iterator.next()) {\r\n    const result = fn(next.value);\r\n\r\n    if (result instanceof Promise) {\r\n      return continueAsync(iterator, fn, result);\r\n    }\r\n  }\r\n}\r\n\r\nasync function continueAsync<T>(\r\n  iterator: Iterator<T>,\r\n  fn: (item: T) => void | Promise<void>,\r\n  pending: Promise<void>\r\n): Promise<void> {\r\n  await pending;\r\n\r\n  for (let next = iterator.next(); !next.done; next = iterator.next()) {\r\n    const result = fn(next.value);\r\n\r\n    if (result instanceof Promise) {\r\n      await result;\r\n    }\r\n  }\r\n}\r\n","/**\r\n * Logger interface for debug and diagnostic output.\r\n * Supports multiple log levels for controlling verbosity.\r\n * Implementations can target different outputs (console, file, remote, etc.).\r\n */\r\nexport interface ILogger {\r\n  /**\r\n   * Logs a message with a specified severity level.\r\n   * @param level - The severity level of the message.\r\n   * @param message - The primary message content.\r\n   * @param args - Additional arguments to include in the log output.\r\n   */\r\n  log(level: LogLevel, message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs detailed diagnostic information.\r\n   * Typically the lowest level, most verbose output.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  trace(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs debug-level information.\r\n   * Useful during development and troubleshooting.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  debug(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs warning-level messages.\r\n   * Indicates potentially problematic conditions.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  warn(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs error-level messages.\r\n   * Indicates error conditions that may require attention.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  error(message: any, ...args: any[]): void;\r\n}\r\n\r\n/**\r\n * Logging severity levels in increasing order.\r\n */\r\nexport enum LogLevel {\r\n  /**\r\n   * Most detailed, diagnostic-level logging.\r\n   */\r\n  trace,\r\n\r\n  /**\r\n   * Development and debugging information.\r\n   */\r\n  debug,\r\n\r\n  /**\r\n   * Warning-level conditions.\r\n   */\r\n  warn,\r\n\r\n  /**\r\n   * Error-level conditions.\r\n   */\r\n  error\r\n}\r\n\r\n/**\r\n * Configuration options for logger instances.\r\n */\r\nexport interface ILoggerOptions {\r\n  /**\r\n   * Enables/disables each log level.\r\n   * If a level is disabled, log calls at that level are ignored.\r\n   */\r\n  enabled: Map<LogLevel, boolean>;\r\n}\r\n"],"mappings":";;;;;;;;;;;;AAWA,SAAgB,mBACd,OACA,IACsB;CACtB,MAAM,WAAW,MAAM,OAAO,WAAW;AAEzC,MAAK,IAAI,OAAO,SAAS,MAAM,EAAE,CAAC,KAAK,MAAM,OAAO,SAAS,MAAM,EAAE;EACnE,MAAM,SAAS,GAAG,KAAK,MAAM;AAE7B,MAAI,kBAAkB,QACpB,QAAO,cAAc,UAAU,IAAI,OAAO;;;AAKhD,eAAe,cACb,UACA,IACA,SACe;AACf,OAAM;AAEN,MAAK,IAAI,OAAO,SAAS,MAAM,EAAE,CAAC,KAAK,MAAM,OAAO,SAAS,MAAM,EAAE;EACnE,MAAM,SAAS,GAAG,KAAK,MAAM;AAE7B,MAAI,kBAAkB,QACpB,OAAM;;;;;;;;ACaZ,IAAY,WAAL,yBAAA,UAAA;;;;AAIL,UAAA,SAAA,WAAA,KAAA;;;;AAKA,UAAA,SAAA,WAAA,KAAA;;;;AAKA,UAAA,SAAA,UAAA,KAAA;;;;AAKA,UAAA,SAAA,WAAA,KAAA;;KACD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesome-ecs/abstract",
-  "version": "0.28.0",
+  "version": "0.30.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": "41492d7ce0a5e4182798619fe238d0a6d4af6e5a"
+  "gitHead": "e4f5e0176478cb0e32364b0df375c537acbdcb66"
 }

package/dist/index-BQojRXVz.d.cts

@@ -1,224 +0,0 @@
-import { n as Immutable } from "./types-DLOd2zXO.cjs";
-import { r as PerformanceTimeEntry } from "./index-Cs9Eerjt.cjs";
-
-//#region src/pipelines/pipeline-context.d.ts
-/**
- * Base interface for all pipeline context objects.
- * Provides hooks for runtime state and control flow during pipeline execution.
- */
-interface IPipelineContext {
-  /**
-   * The runtime state and control interface for the pipeline.
-   * Allows middleware to query and influence pipeline behavior.
-   */
-  readonly runtime?: PipelineRuntime;
-}
-/**
- * Runtime state and control interface for pipeline execution.
- * Allows middleware to query status and influence pipeline flow.
- */
-type PipelineRuntime = {
-  /**
-   * Flag to request pipeline halt.
-   * Set to true to stop executing remaining middleware (cleanup still runs).
-   */
-  shouldStop?: boolean;
-  /**
-   * Optional error state if an exception occurred during execution.
-   */
-  error?: any;
-  /**
-   * Results collected from middleware execution.
-   * Typically includes performance metrics and operational results.
-   */
-  readonly metrics?: PerformanceTimeEntry[];
-};
-//#endregion
-//#region src/pipelines/middleware.d.ts
-/**
- * The basic unit of work in a pipeline.
- * Middleware are chained together to form processing pipelines.
- * Each middleware can inspect/modify context during dispatch and perform cleanup on their changes.
- *
- * @template TContext The context type passed through the middleware chain.
- */
-interface IMiddleware<TContext extends IPipelineContext> {
-  /**
-   * Optional name for debugging and logging purposes.
-   */
-  readonly name?: string;
-  /**
-   * Optional guard condition before running the action.
-   * Allows middleware to skip execution based on context state.
-   * @param context The current pipeline context.
-   * @returns True to execute action, false to skip.
-   */
-  shouldRun?(context: TContext): boolean;
-  /**
-   * The main unit of work executed as part of the pipeline.
-   * Middlewares execute in registration order during dispatch phase.
-   * Can read and modify the context to influence downstream middleware and results.
-   * @param context The pipeline context containing all relevant state.
-   */
-  action(context: TContext): void | Promise<void>;
-  /**
-   * Optional cleanup function executed during pipeline teardown.
-   * Middlewares execute in reverse registration order during cleanup phase.
-   * Used to release resources, clear temporary state, and perform final operations.
-   * @param context The pipeline context (may be in modified state from action phases).
-   */
-  cleanup?(context: TContext): void | Promise<void>;
-}
-//#endregion
-//#region src/pipelines/middleware-runner.d.ts
-/**
- * Customizes how middleware is executed within a pipeline.
- * Allows decorators to wrap, intercept, or modify middleware execution behavior.
- * Useful for implementing middleware decorators (logging, timing, error handling, etc.).
- *
- * @template TContext The type of context passed to middleware.
- */
-interface IMiddlewareRunner<TContext extends IPipelineContext> {
-  /**
-   * Decides how to execute a middleware's action.
-   * Can add pre/post processing, error handling, or performance tracking around the middleware.
-   * @param context The current pipeline context.
-   * @param middleware The middleware whose action should be executed.
-   */
-  dispatch(context: TContext, middleware: IMiddleware<TContext>): void | Promise<void>;
-  /**
-   * Decides how to execute a middleware's cleanup.
-   * Can add pre/post processing or error handling around cleanup operations.
-   * @param context The current pipeline context.
-   * @param middleware The middleware whose cleanup should be executed.
-   */
-  cleanup(context: TContext, middleware: IMiddleware<TContext>): void | Promise<void>;
-}
-//#endregion
-//#region src/pipelines/pipeline.d.ts
-/**
- * A composable middleware chain for ordered execution of operations.
- * Pipelines provide a framework for registering and executing middleware with dispatch and cleanup phases.
- * Used throughout the ECS system for entity initialization, updates, rendering, and synchronization.
- *
- * @template TContext - The context type passed to all registered middleware.
- */
-interface IPipeline<TContext extends IPipelineContext> {
-  /**
-   * The pipeline's name, useful for debugging and logging.
-   */
-  readonly name?: string;
-  /**
-   * The number of middleware currently registered in this pipeline.
-   */
-  readonly length?: number;
-  /**
-   * Direct access to the ordered list of registered middleware.
-   * Allows inspection of the execution chain.
-   */
-  readonly middleware?: Immutable<IMiddleware<TContext>[]>;
-  /**
-   * Registers middleware to be executed as part of this pipeline.
-   * Middleware is added to the end of the chain and executed in registration order during dispatch.
-   * @param middleware - The middleware to register.
-   * @returns This instance for method chaining.
-   */
-  use(middleware: Immutable<IMiddleware<TContext>>): this;
-  /**
-   * Executes the dispatch phase with all registered middleware in order.
-   * Each middleware's action is called, allowing modifications to context state.
-   * Execution continues until all middleware complete or a middleware requests early termination.
-   * @param context - The context object passed to all middleware.
-   */
-  dispatch(context: Partial<TContext>): void | Promise<void>;
-  /**
-   * Executes the cleanup phase with all registered middleware in reverse order.
-   * Allows middleware to perform resource cleanup and final operations.
-   * Typically called after dispatch to ensure proper teardown.
-   *
-   * @param context - The context object that will be passed to each middleware function.
-   */
-  cleanup(context: Partial<TContext>): void | Promise<void>;
-}
-//#endregion
-//#region src/pipelines/pipeline-nested.d.ts
-/**
- * Context for a parent pipeline containing nested pipelines.
- * Allows coordination between outer and inner pipeline execution.
- *
- * @template N - The context type for the nested pipelines.
- */
-interface IParentContext<N extends IPipelineContext> extends IPipelineContext {
-  /**
-   * The nested pipeline to execute for each context in nestedContexts.
-   */
-  readonly nestedPipeline: IPipeline<INestedContext<this>>;
-  /**
-   * Contexts to pass to the nested pipeline.
-   * The parent pipeline iterates these and executes the nested pipeline for each.
-   */
-  readonly nestedContexts: Partial<N>[];
-}
-/**
- * Context for a nested pipeline.
- * Provides access to both current and previous nested context data plus the parent context.
- *
- * @template P - The context type of the parent pipeline.
- */
-interface INestedContext<P extends IParentContext<any>> extends IPipelineContext {
-  /**
-   * The current context item being processed in the nested pipeline.
-   */
-  readonly current: P extends IParentContext<infer N> ? N : never;
-  /**
-   * The previous context item (if this is not the first iteration).
-   */
-  readonly previous?: P extends IParentContext<infer N> ? N : never;
-  /**
-   * Reference back to the parent pipeline context.
-   */
-  readonly parent: P;
-}
-/**
- * Middleware executing within a nested pipeline.
- *
- * @template P - The context type of the parent pipeline.
- */
-type INestedMiddleware<P extends IParentContext<any>> = IMiddleware<INestedContext<P>>;
-/**
- * Middleware executing within a parent pipeline (containing nested pipelines).
- *
- * @template P - The context type of the parent pipeline.
- */
-type IParentMiddleware<P extends IParentContext<any>> = IMiddleware<P>;
-//#endregion
-//#region src/pipelines/pipeline-runner.d.ts
-/**
- * Executes an array of middleware in a controlled sequence.
- * Supports custom execution strategies through implementation flexibility.
- * Used by pipelines to manage complex middleware chains with features like early termination and nested pipelines.
- *
- * @template TContext - The context type passed to all middleware.
- */
-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.
-   * @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>;
-  /**
-   * Executes the cleanup phase of all middleware in reverse order.
-   * All middleware cleanup functions are called (if defined), regardless of errors.
-   * Allows proper resource release and final state management.
-   * @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>;
-}
-//#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-BQojRXVz.d.cts.map