@awesome-ecs/abstract 0.31.0 → 0.32.0

package/dist/types-C1ojaDL4.d.mts

@@ -0,0 +1,74 @@
+//#region src/utils/types.d.ts
+/**
+ * Maps all properties of a type to boolean flags.
+ * Useful for feature flags, capability indicators, or boolean option sets.
+ *
+ * @template T - The type whose properties are mapped to booleans.
+ * @example type Features = BooleanProps<{health: any; armor: any}>; // => {health: boolean, armor: boolean}
+ */
+type BooleanProps<T> = { [Property in keyof T]: boolean };
+/**
+ * Removes readonly modifiers from all properties, making them mutable.
+ * One level of immutability removal (see MutableDeep for recursive removal).
+ *
+ * @template T - The type to make mutable.
+ * @example type Mut = Mutable<{readonly x: number}>; // => {x: number}
+ */
+type Mutable<T> = { -readonly [K in keyof T]: T[K] };
+/**
+ * Recursively removes readonly modifiers from all properties at all nesting levels.
+ * Makes entire object graph mutable.
+ *
+ * @template T - The type to make mutable recursively.
+ */
+type MutableDeep<T> = { -readonly [K in keyof T]: Mutable<T[K]> };
+type ImmutablePrimitive = undefined | null | boolean | string | number | Function;
+/**
+ * Makes a type fully immutable at the top level only.
+ * Primitives and functions remain unchanged.
+ * Collections (Array, Map, Set) become readonly.
+ * Objects have their properties made readonly.
+ *
+ * @template T - The type to make immutable.
+ * @example type Imm = Immutable<{x: number}>; // => {readonly x: number}
+ */
+type Immutable<T> = T extends ImmutablePrimitive ? T : T extends Array<infer U> ? ImmutableArray<U> : T extends Map<infer K, infer V> ? ImmutableMap<K, V> : T extends Set<infer M> ? ImmutableSet<M> : ImmutableObject<T>;
+/**
+ * Readonly array variant for use in Immutable type transformation.
+ *
+ * @template T - Element type of the array.
+ */
+type ImmutableArray<T> = ReadonlyArray<Immutable<T>>;
+/**
+ * Readonly map variant for use in Immutable type transformation.
+ *
+ * @template K - Key type of the map.
+ * @template V - Value type of the map.
+ */
+type ImmutableMap<K, V> = ReadonlyMap<Immutable<K>, Immutable<V>>;
+/**
+ * Readonly set variant for use in Immutable type transformation.
+ *
+ * @template T - Element type of the set.
+ */
+type ImmutableSet<T> = ReadonlySet<Immutable<T>>;
+/**
+ * Makes all object properties readonly (one level only).
+ *
+ * @template T - The type to make immutable.
+ */
+type ImmutableObject<T> = { readonly [K in keyof T]: T[K] };
+/**
+ * Recursively makes all properties readonly at all nesting levels.
+ * Provides complete immutability guarantee for the entire object graph.
+ *
+ * @template T - The type to make deeply immutable.
+ */
+type ImmutableObjectDeep<T> = { readonly [K in keyof T]: Immutable<T[K]> };
+/**
+ * Recursively makes all properties optional at all nesting levels.
+ */
+type DeepPartial<T> = T extends ((...args: unknown[]) => unknown) ? T : T extends readonly unknown[] ? T : T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T;
+//#endregion
+export { ImmutableMap as a, ImmutableSet as c, ImmutableArray as i, Mutable as l, DeepPartial as n, ImmutableObject as o, Immutable as r, ImmutableObjectDeep as s, BooleanProps as t, MutableDeep as u };
+//# sourceMappingURL=types-C1ojaDL4.d.mts.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,WAAL,yBAAA,UAAA;;;;AAIL,UAAA,SAAA,WAAA,KAAA;;;;AAKA,UAAA,SAAA,WAAA,KAAA;;;;AAKA,UAAA,SAAA,UAAA,KAAA;;;;AAKA,UAAA,SAAA,WAAA,KAAA;;KACD"}
+{"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,UAAU;CAExC,KAAK,IAAI,OAAO,SAAS,KAAK,GAAG,CAAC,KAAK,MAAM,OAAO,SAAS,KAAK,GAAG;EACnE,MAAM,SAAS,GAAG,KAAK,KAAK;EAE5B,IAAI,kBAAkB,SACpB,OAAO,cAAc,UAAU,IAAI,MAAM;CAE7C;AACF;AAEA,eAAe,cACb,UACA,IACA,SACe;CACf,MAAM;CAEN,KAAK,IAAI,OAAO,SAAS,KAAK,GAAG,CAAC,KAAK,MAAM,OAAO,SAAS,KAAK,GAAG;EACnE,MAAM,SAAS,GAAG,KAAK,KAAK;EAE5B,IAAI,kBAAkB,SACpB,MAAM;CAEV;AACF;;;;;;ACUA,IAAY,WAAL,yBAAA,UAAA;;;;CAIL,SAAA,SAAA,WAAA,KAAA;;;;CAKA,SAAA,SAAA,WAAA,KAAA;;;;CAKA,SAAA,SAAA,UAAA,KAAA;;;;CAKA,SAAA,SAAA,WAAA,KAAA;;AACF,EAAA,CAAA,CAAA"}

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 { $ 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 };
+import { a as ImmutableMap, c as ImmutableSet, i as ImmutableArray, l as Mutable, n as DeepPartial, o as ImmutableObject, r as Immutable, s as ImmutableObjectDeep, t as BooleanProps, u as MutableDeep } from "../types-Bbmnq4ni.cjs";
+import { C as TickSnapshot, G as LogLevel, O as IJsonSerializer, S as TickMetricEntry, U as ILogger, W as ILoggerOptions, _ as PerformanceMetricOptions, b as MiddlewareMetricsSummary, g as IPerformanceTimer, v as PerformanceTimeEntry, w as dispatchSequential, x as RenderSnapshot, y as PerformanceTimerUid } from "../index-B1OYkMOx.cjs";
+export { BooleanProps, DeepPartial, 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 { $ 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 };
+import { a as ImmutableMap, c as ImmutableSet, i as ImmutableArray, l as Mutable, n as DeepPartial, o as ImmutableObject, r as Immutable, s as ImmutableObjectDeep, t as BooleanProps, u as MutableDeep } from "../types-C1ojaDL4.mjs";
+import { C as TickSnapshot, G as LogLevel, O as IJsonSerializer, S as TickMetricEntry, U as ILogger, W as ILoggerOptions, _ as PerformanceMetricOptions, b as MiddlewareMetricsSummary, g as IPerformanceTimer, v as PerformanceTimeEntry, w as dispatchSequential, x as RenderSnapshot, y as PerformanceTimerUid } from "../index-D3rS2RFG.mjs";
+export { BooleanProps, DeepPartial, 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.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,WAAL,yBAAA,UAAA;;;;AAIL,UAAA,SAAA,WAAA,KAAA;;;;AAKA,UAAA,SAAA,WAAA,KAAA;;;;AAKA,UAAA,SAAA,UAAA,KAAA;;;;AAKA,UAAA,SAAA,WAAA,KAAA;;KACD"}
+{"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,UAAU;CAExC,KAAK,IAAI,OAAO,SAAS,KAAK,GAAG,CAAC,KAAK,MAAM,OAAO,SAAS,KAAK,GAAG;EACnE,MAAM,SAAS,GAAG,KAAK,KAAK;EAE5B,IAAI,kBAAkB,SACpB,OAAO,cAAc,UAAU,IAAI,MAAM;CAE7C;AACF;AAEA,eAAe,cACb,UACA,IACA,SACe;CACf,MAAM;CAEN,KAAK,IAAI,OAAO,SAAS,KAAK,GAAG,CAAC,KAAK,MAAM,OAAO,SAAS,KAAK,GAAG;EACnE,MAAM,SAAS,GAAG,KAAK,KAAK;EAE5B,IAAI,kBAAkB,SACpB,MAAM;CAEV;AACF;;;;;;ACUA,IAAY,WAAL,yBAAA,UAAA;;;;CAIL,SAAA,SAAA,WAAA,KAAA;;;;CAKA,SAAA,SAAA,WAAA,KAAA;;;;CAKA,SAAA,SAAA,UAAA,KAAA;;;;CAKA,SAAA,SAAA,WAAA,KAAA;;AACF,EAAA,CAAA,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesome-ecs/abstract",
-  "version": "0.31.0",
+  "version": "0.32.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": "23e307e2b48e442855dc940daad1c18985d9d94d"
+  "gitHead": "0a5ee91c2d3cc1854cf92ec953c31a55c88b8353"
 }