@esengine/ecs-framework 2.2.20 → 2.3.0

package/bin/Utils/Logger/ConsoleLogger.js

@@ -0,0 +1,187 @@
+import { Colors, LogLevel } from './Constants';
+/**
+ * 默认控制台日志实现
+ */
+export class ConsoleLogger {
+    constructor(config = {}) {
+        this._config = {
+            level: LogLevel.Info,
+            enableTimestamp: true,
+            enableColors: typeof window === 'undefined',
+            ...config
+        };
+    }
+    /**
+     * 输出调试级别日志
+     * @param message 日志消息
+     * @param args 附加参数
+     */
+    debug(message, ...args) {
+        this.log(LogLevel.Debug, message, ...args);
+    }
+    /**
+     * 输出信息级别日志
+     * @param message 日志消息
+     * @param args 附加参数
+     */
+    info(message, ...args) {
+        this.log(LogLevel.Info, message, ...args);
+    }
+    /**
+     * 输出警告级别日志
+     * @param message 日志消息
+     * @param args 附加参数
+     */
+    warn(message, ...args) {
+        this.log(LogLevel.Warn, message, ...args);
+    }
+    /**
+     * 输出错误级别日志
+     * @param message 日志消息
+     * @param args 附加参数
+     */
+    error(message, ...args) {
+        this.log(LogLevel.Error, message, ...args);
+    }
+    /**
+     * 输出致命错误级别日志
+     * @param message 日志消息
+     * @param args 附加参数
+     */
+    fatal(message, ...args) {
+        this.log(LogLevel.Fatal, message, ...args);
+    }
+    /**
+     * 设置日志级别
+     * @param level 日志级别
+     */
+    setLevel(level) {
+        this._config.level = level;
+    }
+    /**
+     * 设置颜色配置
+     * @param colors 颜色配置
+     */
+    setColors(colors) {
+        if (Object.keys(colors).length === 0) {
+            // 重置为默认颜色
+            delete this._config.colors;
+        }
+        else {
+            this._config.colors = {
+                ...this._config.colors,
+                ...colors
+            };
+        }
+    }
+    /**
+     * 设置日志前缀
+     * @param prefix 前缀字符串
+     */
+    setPrefix(prefix) {
+        this._config.prefix = prefix;
+    }
+    /**
+     * 内部日志输出方法
+     * @param level 日志级别
+     * @param message 日志消息
+     * @param args 附加参数
+     */
+    log(level, message, ...args) {
+        if (level < this._config.level) {
+            return;
+        }
+        let formattedMessage = message;
+        // 添加时间戳
+        if (this._config.enableTimestamp) {
+            const timestamp = new Date().toISOString();
+            formattedMessage = `[${timestamp}] ${formattedMessage}`;
+        }
+        // 添加前缀
+        if (this._config.prefix) {
+            formattedMessage = `[${this._config.prefix}] ${formattedMessage}`;
+        }
+        // 添加日志级别
+        const levelName = LogLevel[level].toUpperCase();
+        formattedMessage = `[${levelName}] ${formattedMessage}`;
+        // 使用自定义输出或默认控制台输出
+        if (this._config.output) {
+            this._config.output(level, formattedMessage);
+        }
+        else {
+            this.outputToConsole(level, formattedMessage, ...args);
+        }
+    }
+    /**
+     * 输出到控制台
+     * @param level 日志级别
+     * @param message 格式化后的消息
+     * @param args 附加参数
+     */
+    outputToConsole(level, message, ...args) {
+        const colors = this._config.enableColors ? this.getColors() : null;
+        switch (level) {
+            case LogLevel.Debug:
+                if (colors) {
+                    console.debug(`${colors.debug}${message}${colors.reset}`, ...args);
+                }
+                else {
+                    console.debug(message, ...args);
+                }
+                break;
+            case LogLevel.Info:
+                if (colors) {
+                    console.info(`${colors.info}${message}${colors.reset}`, ...args);
+                }
+                else {
+                    console.info(message, ...args);
+                }
+                break;
+            case LogLevel.Warn:
+                if (colors) {
+                    console.warn(`${colors.warn}${message}${colors.reset}`, ...args);
+                }
+                else {
+                    console.warn(message, ...args);
+                }
+                break;
+            case LogLevel.Error:
+                if (colors) {
+                    console.error(`${colors.error}${message}${colors.reset}`, ...args);
+                }
+                else {
+                    console.error(message, ...args);
+                }
+                break;
+            case LogLevel.Fatal:
+                if (colors) {
+                    console.error(`${colors.fatal}${message}${colors.reset}`, ...args);
+                }
+                else {
+                    console.error(message, ...args);
+                }
+                break;
+        }
+    }
+    /**
+     * 获取控制台颜色配置
+     * @returns 颜色配置对象
+     */
+    getColors() {
+        // 默认颜色配置
+        const defaultColors = {
+            debug: Colors.BRIGHT_BLACK, // 灰色
+            info: Colors.GREEN, // 绿色
+            warn: Colors.YELLOW, // 黄色
+            error: Colors.RED, // 红色
+            fatal: Colors.BRIGHT_RED, // 亮红色
+            reset: Colors.RESET // 重置
+        };
+        // 合并用户自定义颜色
+        return {
+            ...defaultColors,
+            ...this._config.colors
+        };
+    }
+}
+//# sourceMappingURL=ConsoleLogger.js.map

package/bin/Utils/Logger/ConsoleLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleLogger.js","sourceRoot":"","sources":["../../../src/Utils/Logger/ConsoleLogger.ts"],"names":[],"mappings":"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"}

package/bin/Utils/Logger/Constants.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 日志级别
+ */
+export declare enum LogLevel {
+    Debug = 0,
+    Info = 1,
+    Warn = 2,
+    Error = 3,
+    Fatal = 4,
+    None = 5
+}
+/**
+ * 预定义的颜色常量
+ */
+export declare const Colors: {
+    readonly BLACK: "\u001B[30m";
+    readonly RED: "\u001B[31m";
+    readonly GREEN: "\u001B[32m";
+    readonly YELLOW: "\u001B[33m";
+    readonly BLUE: "\u001B[34m";
+    readonly MAGENTA: "\u001B[35m";
+    readonly CYAN: "\u001B[36m";
+    readonly WHITE: "\u001B[37m";
+    readonly BRIGHT_BLACK: "\u001B[90m";
+    readonly BRIGHT_RED: "\u001B[91m";
+    readonly BRIGHT_GREEN: "\u001B[92m";
+    readonly BRIGHT_YELLOW: "\u001B[93m";
+    readonly BRIGHT_BLUE: "\u001B[94m";
+    readonly BRIGHT_MAGENTA: "\u001B[95m";
+    readonly BRIGHT_CYAN: "\u001B[96m";
+    readonly BRIGHT_WHITE: "\u001B[97m";
+    readonly RESET: "\u001B[0m";
+    readonly BOLD: "\u001B[1m";
+    readonly UNDERLINE: "\u001B[4m";
+};
+//# sourceMappingURL=Constants.d.ts.map

package/bin/Utils/Logger/Constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Constants.d.ts","sourceRoot":"","sources":["../../../src/Utils/Logger/Constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,QAAQ;IAChB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,KAAK,IAAI;IACT,IAAI,IAAI;CACX;AAED;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;CAyBT,CAAC"}

package/bin/Utils/Logger/Constants.js

@@ -0,0 +1,40 @@
+/**
+ * 日志级别
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["Debug"] = 0] = "Debug";
+    LogLevel[LogLevel["Info"] = 1] = "Info";
+    LogLevel[LogLevel["Warn"] = 2] = "Warn";
+    LogLevel[LogLevel["Error"] = 3] = "Error";
+    LogLevel[LogLevel["Fatal"] = 4] = "Fatal";
+    LogLevel[LogLevel["None"] = 5] = "None";
+})(LogLevel || (LogLevel = {}));
+/**
+ * 预定义的颜色常量
+ */
+export const Colors = {
+    // 基础颜色
+    BLACK: '\x1b[30m',
+    RED: '\x1b[31m',
+    GREEN: '\x1b[32m',
+    YELLOW: '\x1b[33m',
+    BLUE: '\x1b[34m',
+    MAGENTA: '\x1b[35m',
+    CYAN: '\x1b[36m',
+    WHITE: '\x1b[37m',
+    // 亮色版本
+    BRIGHT_BLACK: '\x1b[90m',
+    BRIGHT_RED: '\x1b[91m',
+    BRIGHT_GREEN: '\x1b[92m',
+    BRIGHT_YELLOW: '\x1b[93m',
+    BRIGHT_BLUE: '\x1b[94m',
+    BRIGHT_MAGENTA: '\x1b[95m',
+    BRIGHT_CYAN: '\x1b[96m',
+    BRIGHT_WHITE: '\x1b[97m',
+    // 特殊
+    RESET: '\x1b[0m',
+    BOLD: '\x1b[1m',
+    UNDERLINE: '\x1b[4m'
+};
+//# sourceMappingURL=Constants.js.map

package/bin/Utils/Logger/Constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Constants.js","sourceRoot":"","sources":["../../../src/Utils/Logger/Constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAChB,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;IACT,yCAAS,CAAA;IACT,uCAAQ,CAAA;AACZ,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IAClB,OAAO;IACP,KAAK,EAAE,UAAU;IACjB,GAAG,EAAE,UAAU;IACf,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;IAEjB,OAAO;IACP,YAAY,EAAE,UAAU;IACxB,UAAU,EAAE,UAAU;IACtB,YAAY,EAAE,UAAU;IACxB,aAAa,EAAE,UAAU;IACzB,WAAW,EAAE,UAAU;IACvB,cAAc,EAAE,UAAU;IAC1B,WAAW,EAAE,UAAU;IACvB,YAAY,EAAE,UAAU;IAExB,KAAK;IACL,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,SAAS;CACd,CAAC"}

package/bin/Utils/Logger/LoggerManager.d.ts

@@ -0,0 +1,91 @@
+import { LogLevel } from './Constants';
+import { ILogger, LoggerColorConfig } from './Types';
+/**
+ * 日志管理器
+ */
+export declare class LoggerManager {
+    private static _instance;
+    private _loggers;
+    private _defaultLogger?;
+    private _defaultLevel;
+    private _loggerFactory?;
+    private constructor();
+    private get defaultLogger();
+    private createDefaultLogger;
+    /**
+     * 获取日志管理器实例
+     * @returns 日志管理器实例
+     */
+    static getInstance(): LoggerManager;
+    /**
+     * 获取或创建日志器
+     * @param name 日志器名称
+     * @returns 日志器实例
+     */
+    getLogger(name?: string): ILogger;
+    /**
+     * 设置日志器
+     * @param name 日志器名称
+     * @param logger 日志器实例
+     */
+    setLogger(name: string, logger: ILogger): void;
+    /**
+     * 设置全局日志级别
+     * @param level 日志级别
+     */
+    setGlobalLevel(level: LogLevel): void;
+    /**
+     * 创建子日志器
+     * @param parentName 父日志器名称
+     * @param childName 子日志器名称
+     * @returns 子日志器实例
+     */
+    createChildLogger(parentName: string, childName: string): ILogger;
+    /**
+     * 设置全局颜色配置
+     * @param colors 颜色配置
+     */
+    setGlobalColors(colors: LoggerColorConfig): void;
+    /**
+     * 重置为默认颜色配置
+     */
+    resetColors(): void;
+    /**
+     * 设置日志器工厂方法
+     * @param factory 日志器工厂方法
+     *
+     * 注意: 应该在导入 ECS 模块之前调用此方法。
+     * 设置后, 每次调用 getLogger() 都会通过 factory 创建新的 logger 实例, 由用户侧管理
+     */
+    setLoggerFactory(factory: (name?: string) => ILogger): void;
+}
+/**
+ * 默认日志器实例
+ */
+export declare const Logger: ILogger;
+/**
+ * 创建命名日志器
+ * @param name 日志器名称
+ * @returns 日志器实例
+ */
+export declare function createLogger(name: string): ILogger;
+/**
+ * 设置全局日志颜色配置
+ * @param colors 颜色配置
+ */
+export declare function setLoggerColors(colors: LoggerColorConfig): void;
+/**
+ * 重置日志颜色为默认配置
+ */
+export declare function resetLoggerColors(): void;
+/**
+ * 设置全局日志级别
+ * @param level 日志级别
+ */
+export declare function setGlobalLogLevel(level: LogLevel): void;
+/**
+ * 设置日志器工厂方法
+ * @param factory 日志器工厂方法
+ */
+export declare function setLoggerFactory(factory: (name?: string) => ILogger): void;
+//# sourceMappingURL=LoggerManager.d.ts.map

package/bin/Utils/Logger/LoggerManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoggerManager.d.ts","sourceRoot":"","sources":["../../../src/Utils/Logger/LoggerManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAErD;;GAEG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,cAAc,CAAC,CAAU;IACjC,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,cAAc,CAAC,CAA6B;IAEpD,OAAO;IAEP,OAAO,KAAK,aAAa,GAKxB;IAGD,OAAO,CAAC,mBAAmB;IAO3B;;;OAGG;WACW,WAAW,IAAI,aAAa;IAO1C;;;;OAIG;IACI,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO;IAkBxC;;;;OAIG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAIrD;;;OAGG;IACI,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAc5C;;;;;OAKG;IACI,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAKxE;;;OAGG;IACI,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAYvD;;OAEG;IACI,WAAW,IAAI,IAAI;IAY1B;;;;;;OAMG;IACI,gBAAgB,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI;CASrE;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,SAA0C,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAE/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEvD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAE1E"}

package/bin/Utils/Logger/LoggerManager.js

@@ -0,0 +1,167 @@
+import { ConsoleLogger } from './ConsoleLogger';
+import { LogLevel } from './Constants';
+/**
+ * 日志管理器
+ */
+export class LoggerManager {
+    constructor() {
+        this._loggers = new Map();
+        this._defaultLevel = LogLevel.Info;
+    }
+    get defaultLogger() {
+        if (!this._defaultLogger) {
+            this._defaultLogger = this.createDefaultLogger();
+        }
+        return this._defaultLogger;
+    }
+    // 新增: 创建默认 logger 的逻辑
+    createDefaultLogger() {
+        if (this._loggerFactory) {
+            return this._loggerFactory();
+        }
+        return new ConsoleLogger({ level: this._defaultLevel });
+    }
+    /**
+     * 获取日志管理器实例
+     * @returns 日志管理器实例
+     */
+    static getInstance() {
+        if (!LoggerManager._instance) {
+            LoggerManager._instance = new LoggerManager();
+        }
+        return LoggerManager._instance;
+    }
+    /**
+     * 获取或创建日志器
+     * @param name 日志器名称
+     * @returns 日志器实例
+     */
+    getLogger(name) {
+        if (!name) {
+            return this.defaultLogger;
+        }
+        // 如果有自定义 factory, 每次都调用(不缓存), 由使用方自行管理
+        if (this._loggerFactory) {
+            return this._loggerFactory(name);
+        }
+        // 默认 ConsoleLogger 仍然缓存(保持向后兼容)
+        if (!this._loggers.has(name)) {
+            this._loggers.set(name, new ConsoleLogger({ prefix: name, level: this._defaultLevel }));
+        }
+        return this._loggers.get(name);
+    }
+    /**
+     * 设置日志器
+     * @param name 日志器名称
+     * @param logger 日志器实例
+     */
+    setLogger(name, logger) {
+        this._loggers.set(name, logger);
+    }
+    /**
+     * 设置全局日志级别
+     * @param level 日志级别
+     */
+    setGlobalLevel(level) {
+        this._defaultLevel = level;
+        if (this._defaultLogger instanceof ConsoleLogger) {
+            this._defaultLogger.setLevel(level);
+        }
+        for (const logger of this._loggers.values()) {
+            if (logger instanceof ConsoleLogger) {
+                logger.setLevel(level);
+            }
+        }
+    }
+    /**
+     * 创建子日志器
+     * @param parentName 父日志器名称
+     * @param childName 子日志器名称
+     * @returns 子日志器实例
+     */
+    createChildLogger(parentName, childName) {
+        const fullName = `${parentName}.${childName}`;
+        return this.getLogger(fullName);
+    }
+    /**
+     * 设置全局颜色配置
+     * @param colors 颜色配置
+     */
+    setGlobalColors(colors) {
+        if (this._defaultLogger instanceof ConsoleLogger) {
+            this._defaultLogger.setColors(colors);
+        }
+        for (const logger of this._loggers.values()) {
+            if (logger instanceof ConsoleLogger) {
+                logger.setColors(colors);
+            }
+        }
+    }
+    /**
+     * 重置为默认颜色配置
+     */
+    resetColors() {
+        if (this._defaultLogger instanceof ConsoleLogger) {
+            this._defaultLogger.setColors({});
+        }
+        for (const logger of this._loggers.values()) {
+            if (logger instanceof ConsoleLogger) {
+                logger.setColors({});
+            }
+        }
+    }
+    /**
+     * 设置日志器工厂方法
+     * @param factory 日志器工厂方法
+     *
+     * 注意: 应该在导入 ECS 模块之前调用此方法。
+     * 设置后, 每次调用 getLogger() 都会通过 factory 创建新的 logger 实例, 由用户侧管理
+     */
+    setLoggerFactory(factory) {
+        this._loggerFactory = factory;
+        // 清空默认 logger,下次获取时使用新工厂方法
+        delete this._defaultLogger;
+        // 清空缓存
+        this._loggers.clear();
+    }
+}
+/**
+ * 默认日志器实例
+ */
+export const Logger = LoggerManager.getInstance().getLogger();
+/**
+ * 创建命名日志器
+ * @param name 日志器名称
+ * @returns 日志器实例
+ */
+export function createLogger(name) {
+    return LoggerManager.getInstance().getLogger(name);
+}
+/**
+ * 设置全局日志颜色配置
+ * @param colors 颜色配置
+ */
+export function setLoggerColors(colors) {
+    LoggerManager.getInstance().setGlobalColors(colors);
+}
+/**
+ * 重置日志颜色为默认配置
+ */
+export function resetLoggerColors() {
+    LoggerManager.getInstance().resetColors();
+}
+/**
+ * 设置全局日志级别
+ * @param level 日志级别
+ */
+export function setGlobalLogLevel(level) {
+    LoggerManager.getInstance().setGlobalLevel(level);
+}
+/**
+ * 设置日志器工厂方法
+ * @param factory 日志器工厂方法
+ */
+export function setLoggerFactory(factory) {
+    LoggerManager.getInstance().setLoggerFactory(factory);
+}
+//# sourceMappingURL=LoggerManager.js.map

package/bin/Utils/Logger/LoggerManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoggerManager.js","sourceRoot":"","sources":["../../../src/Utils/Logger/LoggerManager.ts"],"names":[],"mappings":"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"}

package/bin/Utils/Logger/Types.d.ts

@@ -0,0 +1,40 @@
+import type { LogLevel } from './Constants';
+/**
+ * 日志接口
+ */
+export interface ILogger {
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    fatal(...args: unknown[]): void;
+}
+/**
+ * 日志颜色配置接口
+ */
+export interface LoggerColorConfig {
+    debug?: string;
+    info?: string;
+    warn?: string;
+    error?: string;
+    fatal?: string;
+    reset?: string;
+}
+/**
+ * 日志配置
+ */
+export interface LoggerConfig {
+    /** 日志级别 */
+    level: LogLevel;
+    /** 是否启用时间戳 */
+    enableTimestamp: boolean;
+    /** 是否启用颜色 */
+    enableColors: boolean;
+    /** 日志前缀 */
+    prefix?: string;
+    /** 自定义输出函数 */
+    output?: (level: LogLevel, message: string) => void;
+    /** 自定义颜色配置 */
+    colors?: LoggerColorConfig;
+}
+//# sourceMappingURL=Types.d.ts.map

package/bin/Utils/Logger/Types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../../../src/Utils/Logger/Types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,OAAO;IACpB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,WAAW;IACX,KAAK,EAAE,QAAQ,CAAC;IAChB,cAAc;IACd,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa;IACb,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc;IACd,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,cAAc;IACd,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC9B"}

package/bin/Utils/Logger/Types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Types.js.map

package/bin/Utils/Logger/Types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Types.js","sourceRoot":"","sources":["../../../src/Utils/Logger/Types.ts"],"names":[],"mappings":""}

package/bin/Utils/Logger/index.d.ts

@@ -0,0 +1,5 @@
+export * from './ConsoleLogger';
+export * from './Constants';
+export * from './LoggerManager';
+export * from './Types';
+//# sourceMappingURL=index.d.ts.map

package/bin/Utils/Logger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Utils/Logger/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC"}

package/bin/Utils/Logger/index.js

@@ -0,0 +1,5 @@
+export * from './ConsoleLogger';
+export * from './Constants';
+export * from './LoggerManager';
+export * from './Types';
+//# sourceMappingURL=index.js.map

package/bin/Utils/Logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Utils/Logger/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC"}