@awesome-ecs/abstract 0.28.0 → 0.30.0

package/dist/index-Cs9Eerjt.d.cts

@@ -1,175 +0,0 @@
-//#region src/utils/dispatch-sequential.d.ts
-/**
- * Executes a function for each item in an iterable, sequentially.
- *
- * Uses a sync fast-path: iterates synchronously until the first Promise is
- * encountered, then switches to async for the remainder. If no item produces
- * a Promise, the entire call stays synchronous with zero async overhead.
- *
- * @param items - The iterable to iterate over.
- * @param fn - The function to call for each item. May return void or a Promise.
- * @returns void if all calls were synchronous, or a Promise if any were async.
- */
-declare function dispatchSequential<T>(items: Iterable<T>, fn: (item: T) => void | Promise<void>): void | Promise<void>;
-//#endregion
-//#region src/utils/json-serializer.d.ts
-/**
- * Custom JSON serialization and deserialization interface.
- * Allows different serialization strategies for handling complex types.
- * Used for entity snapshots, events, and any data needing JSON conversion.
- */
-interface IJsonSerializer {
-  /**
-   * Converts an object to a serializable JSON representation.
-   * Handles types that don't serialize naturally (dates, maps, custom objects, etc.).
-   * @param value - The object to serialize.
-   * @returns A JSON-serializable representation.
-   */
-  serializeCustom(value: object): string;
-  /**
-   * Converts a JSON string back to its original object type.
-   * Reconstructs complex types from their serialized form.
-   * @template TObject - The target object type.
-   * @param text - The JSON string to deserialize.
-   * @returns The deserialized object of the specified type.
-   */
-  parseCustom<TObject>(text: string): TObject;
-}
-//#endregion
-//#region src/utils/logger.d.ts
-/**
- * Logger interface for debug and diagnostic output.
- * Supports multiple log levels for controlling verbosity.
- * Implementations can target different outputs (console, file, remote, etc.).
- */
-interface ILogger {
-  /**
-   * Logs a message with a specified severity level.
-   * @param level - The severity level of the message.
-   * @param message - The primary message content.
-   * @param args - Additional arguments to include in the log output.
-   */
-  log(level: LogLevel, message: any, ...args: any[]): void;
-  /**
-   * Logs detailed diagnostic information.
-   * Typically the lowest level, most verbose output.
-   * @param message - The message to log.
-   * @param args - Additional data.
-   */
-  trace(message: any, ...args: any[]): void;
-  /**
-   * Logs debug-level information.
-   * Useful during development and troubleshooting.
-   * @param message - The message to log.
-   * @param args - Additional data.
-   */
-  debug(message: any, ...args: any[]): void;
-  /**
-   * Logs warning-level messages.
-   * Indicates potentially problematic conditions.
-   * @param message - The message to log.
-   * @param args - Additional data.
-   */
-  warn(message: any, ...args: any[]): void;
-  /**
-   * Logs error-level messages.
-   * Indicates error conditions that may require attention.
-   * @param message - The message to log.
-   * @param args - Additional data.
-   */
-  error(message: any, ...args: any[]): void;
-}
-/**
- * Logging severity levels in increasing order.
- */
-declare enum LogLevel {
-  /**
-   * Most detailed, diagnostic-level logging.
-   */
-  trace = 0,
-  /**
-   * Development and debugging information.
-   */
-  debug = 1,
-  /**
-   * Warning-level conditions.
-   */
-  warn = 2,
-  /**
-   * Error-level conditions.
-   */
-  error = 3
-}
-/**
- * Configuration options for logger instances.
- */
-interface ILoggerOptions {
-  /**
-   * Enables/disables each log level.
-   * If a level is disabled, log calls at that level are ignored.
-   */
-  enabled: Map<LogLevel, boolean>;
-}
-//#endregion
-//#region src/utils/performance-timer.d.ts
-/**
- * Unique identifier for a timer instance.
- */
-type PerformanceTimerUid = number;
-/**
- * Options for identifying and categorizing performance metrics.
- * Used by pipeline factories and performance decorators.
- */
-type PerformanceMetricOptions = {
-  name?: string;
-  category?: string;
-};
-/**
- * Record of a completed timer measurement.
- * Captures timing information for performance analysis and profiling.
- */
-interface PerformanceTimeEntry {
-  /**
-   * The name identifying this timer.
-   */
-  name: string;
-  /**
-   * The category of this metric (e.g. 'module', 'runtime', 'system').
-   */
-  category?: string;
-  /**
-   * Timestamp in milliseconds when the timer started.
-   */
-  startedAt: number;
-  /**
-   * Timestamp in milliseconds when the timer ended.
-   */
-  endedAt?: number;
-  /**
-   * Duration in milliseconds that elapsed.
-   */
-  msPassed?: number;
-}
-/**
- * Interface for measuring operation duration.
- * Provides start/stop functionality for performance profiling.
- * Used throughout the system to collect timing metrics.
- */
-interface IPerformanceTimer {
-  /**
-   * Starts a new timer.
-   * @param name - Label for this timer (used in results).
-   * @param category - Optional category for grouping metrics.
-   * @returns A unique identifier for this timer instance.
-   */
-  startTimer(name: string, category?: string): PerformanceTimerUid;
-  /**
-   * Stops a timer and returns the recorded metrics.
-   * @param timerUid - The timer identifier returned by startTimer.
-   * @returns Complete timing entry with start, end, and duration.
-   */
-  endTimer(timerUid: PerformanceTimerUid): PerformanceTimeEntry;
-}
-//#endregion
-export { ILogger as a, IJsonSerializer as c, PerformanceTimerUid as i, dispatchSequential as l, PerformanceMetricOptions as n, ILoggerOptions as o, PerformanceTimeEntry as r, LogLevel as s, IPerformanceTimer as t };
-//# sourceMappingURL=index-Cs9Eerjt.d.cts.map