@nebulaaa/journal 1.0.1 → 1.1.1

package/dist/journal.cjs

@@ -48,24 +48,24 @@ const CONSOLE_METHODS = {
 class JournalLogger {
     constructor(options) {
         var _a;
-        this.name = options.name;
-        this.level = (_a = options.level) !== null && _a !== void 0 ? _a : 'debug';
+        this.Name = options.name;
+        this.Level = (_a = options.level) !== null && _a !== void 0 ? _a : 'debug';
     }
     /** 输出 debug 级别记录 */
-    debug(message, ...args) {
-        this.log('debug', message, ...args);
+    Debug(message, ...args) {
+        this.Log('debug', message, ...args);
     }
     /** 输出 info 级别记录 */
-    info(message, ...args) {
-        this.log('info', message, ...args);
+    Info(message, ...args) {
+        this.Log('info', message, ...args);
     }
     /** 输出 warn 级别记录 */
-    warn(message, ...args) {
-        this.log('warn', message, ...args);
+    Warn(message, ...args) {
+        this.Log('warn', message, ...args);
     }
     /** 输出 error 级别记录 */
-    error(message, ...args) {
-        this.log('error', message, ...args);
+    Error(message, ...args) {
+        this.Log('error', message, ...args);
     }
     /**
      * 输出一条记录，分级规则见类说明
@@ -73,18 +73,18 @@ class JournalLogger {
      * @param message  记录内容
      * @param args     附加内容，透传给 console
      */
-    log(level, message, ...args) {
+    Log(level, message, ...args) {
         if (level === 'disable') {
             return;
         }
-        if (JOURNAL_LEVEL_WEIGHTS[this.level] < JOURNAL_LEVEL_WEIGHTS[Journal.Level]) {
+        if (JOURNAL_LEVEL_WEIGHTS[this.Level] < JOURNAL_LEVEL_WEIGHTS[GetLevel()]) {
             return;
         }
-        if (JOURNAL_LEVEL_WEIGHTS[level] < JOURNAL_LEVEL_WEIGHTS[this.level]) {
+        if (JOURNAL_LEVEL_WEIGHTS[level] < JOURNAL_LEVEL_WEIGHTS[this.Level]) {
             return;
         }
-        const style = Journal.GetLevelStyle(level);
-        const text = `[${this.name}] ${String(message)}`;
+        const style = GetLevelStyle(level);
+        const text = `[${this.Name}] ${String(message)}`;
         const method = CONSOLE_METHODS[level];
         if (style.color) {
             console[method](`%c${style.label}%c ${text}`, `color:${style.color};font-weight:bold;`, 'color:inherit;font-weight:inherit;', ...args);
@@ -95,162 +95,142 @@ class JournalLogger {
     }
 }
 /**
- * 日志管理器（静态类）
- *
- * 通过 Journal.init(options) 初始化，必须初始化后才能使用：
- * 未初始化时管理器分级为 disable，任何记录都不会输出，
- * 且管理操作会被警告并忽略；使用 Journal.reset() 可恢复未初始化状态。
- * 内置一个默认记录器，用于便捷记录，不占用记录器表，分级随管理器动态调整。
+ * 日志记录器环境
  */
-class Journal {
-    /** 静态类，禁止实例化 */
-    constructor() { }
-    /**
-     * 初始化；仅首次调用生效，重复调用将被警告并忽略
-     * @param options 管理器配置
-     */
-    static Init(options) {
-        var _a, _b, _c;
-        if (Journal._Initialized) {
-            console.warn('[Journal] 已初始化，请勿重复调用 init()');
-            return;
-        }
-        Journal._Initialized = true;
-        Journal._Level = (_a = options === null || options === void 0 ? void 0 : options.level) !== null && _a !== void 0 ? _a : 'debug';
-        Journal._Logger = new JournalLogger({ name: JOURNAL_DEFAULT_LOGGER_NAME, level: Journal._Level });
-        const overrides = options === null || options === void 0 ? void 0 : options.levels;
-        if (overrides) {
-            for (const level of JOURNAL_LEVELS) {
-                const style = overrides[level];
-                if (style) {
-                    Journal._Styles[level] = Object.assign(Object.assign({}, Journal._Styles[level]), style);
-                }
+const JournalEnv = {
+    _initialized: false,
+    _level: 'disable',
+    _logger: null,
+    _styles: Object.assign({}, JOURNAL_DEFAULT_LEVEL_STYLES),
+    _loggers: new Map(),
+};
+/**
+ * 初始化；仅首次调用生效，重复调用将被警告并忽略
+ * @param options 管理器配置
+ */
+function JournalInit(options) {
+    var _a, _b, _c;
+    if (JournalEnv._initialized) {
+        console.warn('[Journal] 已初始化，请勿重复调用');
+        return;
+    }
+    JournalEnv._initialized = true;
+    JournalEnv._level = (_a = options === null || options === void 0 ? void 0 : options.level) !== null && _a !== void 0 ? _a : 'debug';
+    JournalEnv._logger = new JournalLogger({
+        name: JOURNAL_DEFAULT_LOGGER_NAME,
+        level: JournalEnv._level,
+    });
+    const overrides = options === null || options === void 0 ? void 0 : options.levels;
+    if (overrides) {
+        for (const level of JOURNAL_LEVELS) {
+            const style = overrides[level];
+            if (style) {
+                JournalEnv._styles[level] = Object.assign(Object.assign({}, JournalEnv._styles[level]), style);
             }
         }
-        for (const config of (_b = options === null || options === void 0 ? void 0 : options.loggers) !== null && _b !== void 0 ? _b : []) {
-            Journal.CreateLogger(config.name, (_c = config.level) !== null && _c !== void 0 ? _c : 'debug');
-        }
-    }
-    /** 重置为未初始化状态：清空记录器、恢复默认样式与分级 */
-    static Reset() {
-        Journal._Initialized = false;
-        Journal._Level = 'disable';
-        Journal._Logger = null;
-        Journal._Styles = Object.assign({}, JOURNAL_DEFAULT_LEVEL_STYLES);
-        Journal._Loggers.clear();
-    }
-    /** 管理器分级 */
-    static get Level() {
-        return Journal._Level;
-    }
-    static set Level(level) {
-        if (!Journal.EnsureReady()) {
-            return;
-        }
-        Journal._Level = level;
-        Journal._Logger.level = level;
-    }
-    /** 输出 debug 级别记录（默认记录器） */
-    static Debug(message, ...args) {
-        Journal.Log('debug', message, ...args);
-    }
-    /** 输出 info 级别记录（默认记录器） */
-    static Info(message, ...args) {
-        Journal.Log('info', message, ...args);
-    }
-    /** 输出 warn 级别记录（默认记录器） */
-    static Warn(message, ...args) {
-        Journal.Log('warn', message, ...args);
-    }
-    /** 输出 error 级别记录（默认记录器） */
-    static Error(message, ...args) {
-        Journal.Log('error', message, ...args);
-    }
-    /**
-     * 输出一条记录（默认记录器）
-     * @param level    记录分级
-     * @param message  记录内容
-     * @param args     附加内容，透传给 console
-     */
-    static Log(level, message, ...args) {
-        var _a;
-        if (!Journal.EnsureReady()) {
-            return;
-        }
-        (_a = Journal._Logger) === null || _a === void 0 ? void 0 : _a.log(level, message, ...args);
     }
-    /** 获取分级样式 */
-    static GetLevelStyle(level) {
-        return Journal._Styles[level];
-    }
-    /** 更新分级样式，仅覆盖传入字段 */
-    static SetLevelStyle(level, style) {
-        if (!Journal.EnsureReady()) {
-            return;
-        }
-        Journal._Styles[level] = Object.assign(Object.assign({}, Journal._Styles[level]), style);
+    for (const config of (_b = options === null || options === void 0 ? void 0 : options.loggers) !== null && _b !== void 0 ? _b : []) {
+        Create(config.name, (_c = config.level) !== null && _c !== void 0 ? _c : 'debug');
     }
     /**
-     * 创建记录器；同名记录器已存在时更新其分级并返回原实例
-     * @param name   记录器名称
-     * @param level  记录器分级，默认为 debug
+     * 日志管理器
+     *
+     * 内置一个默认记录器，用于便捷记录，不占用记录器表，分级随管理器动态调整。
      */
-    static CreateLogger(name, level = 'debug') {
-        if (!Journal.EnsureReady()) {
-            return null;
-        }
-        const existing = Journal._Loggers.get(name);
-        if (existing) {
-            existing.level = level;
-            return existing;
-        }
-        const logger = new JournalLogger({ name, level });
-        Journal._Loggers.set(name, logger);
-        return logger;
-    }
-    /** 获取记录器，不存在时以管理器当前分级创建并返回 */
-    static GetLogger(name) {
-        var _a;
-        if (!Journal.EnsureReady()) {
-            return null;
-        }
-        return (_a = Journal._Loggers.get(name)) !== null && _a !== void 0 ? _a : Journal.CreateLogger(name, Journal._Level);
-    }
-    /** 移除记录器，返回是否移除成功 */
-    static RemoveLogger(name) {
-        return Journal._Loggers.delete(name);
-    }
-    /** 清空全部记录器，不影响默认记录器 */
-    static ClearLoggers() {
-        Journal._Loggers.clear();
-    }
-    /** 获取全部记录器，不含默认记录器 */
-    static GetLoggers() {
-        return [...Journal._Loggers.values()];
-    }
-    /** 未初始化时警告并返回 false */
-    static EnsureReady() {
-        if (!Journal._Initialized) {
-            console.warn('[Journal] 尚未初始化，请先调用 Journal.Init()');
-            return false;
-        }
-        return true;
-    }
+    return {
+        Acquire,
+        Create,
+        Remove,
+        Clear,
+        All,
+        GetLevel,
+        SetLevel,
+        GetLevelStyle,
+        SetLevelStyle,
+        Debug,
+        Info,
+        Warn,
+        Error,
+    };
+}
+/** 获取管理器分级 */
+function GetLevel() {
+    return JournalEnv._level;
+}
+/** 设置管理器分级 */
+function SetLevel(level) {
+    JournalEnv._level = level;
+    JournalEnv._logger.Level = level;
+}
+/** 输出 debug 级别记录（默认记录器） */
+function Debug(message, ...args) {
+    Log('debug', message, ...args);
+}
+/** 输出 info 级别记录（默认记录器） */
+function Info(message, ...args) {
+    Log('info', message, ...args);
+}
+/** 输出 warn 级别记录（默认记录器） */
+function Warn(message, ...args) {
+    Log('warn', message, ...args);
+}
+/** 输出 error 级别记录（默认记录器） */
+function Error(message, ...args) {
+    Log('error', message, ...args);
+}
+/**
+ * 输出一条记录（默认记录器）
+ * @param level    记录分级
+ * @param message  记录内容
+ * @param args     附加内容，透传给 console
+ */
+function Log(level, message, ...args) {
+    JournalEnv._logger.Log(level, message, ...args);
+}
+/** 获取分级样式 */
+function GetLevelStyle(level) {
+    return JournalEnv._styles[level];
+}
+/** 更新分级样式，仅覆盖传入字段 */
+function SetLevelStyle(level, style) {
+    JournalEnv._styles[level] = Object.assign(Object.assign({}, JournalEnv._styles[level]), style);
+}
+/**
+ * 创建记录器；同名记录器已存在时更新其分级并返回原实例
+ * @param name   记录器名称
+ * @param level  记录器分级，默认为 debug
+ */
+function Create(name, level = 'debug') {
+    const existing = JournalEnv._loggers.get(name);
+    if (existing) {
+        existing.Level = level;
+        return existing;
+    }
+    const logger = new JournalLogger({ name, level });
+    JournalEnv._loggers.set(name, logger);
+    return logger;
+}
+/** 获取记录器，不存在时以管理器当前分级创建并返回 */
+function Acquire(name) {
+    var _a;
+    return (_a = JournalEnv._loggers.get(name)) !== null && _a !== void 0 ? _a : Create(name, JournalEnv._level);
+}
+/** 移除记录器，返回是否移除成功 */
+function Remove(name) {
+    return JournalEnv._loggers.delete(name);
+}
+/** 清空全部记录器，不影响默认记录器 */
+function Clear() {
+    JournalEnv._loggers.clear();
+}
+/** 获取全部记录器，不包含默认记录器 */
+function All() {
+    return [...JournalEnv._loggers.values()];
 }
-/** 是否已初始化 */
-Journal._Initialized = false;
-/** 管理器分级；未初始化时为 disable，确保无任何输出 */
-Journal._Level = 'disable';
-/** 默认记录器；分级随管理器动态调整 */
-Journal._Logger = null;
-/** 分级样式表 */
-Journal._Styles = Object.assign({}, JOURNAL_DEFAULT_LEVEL_STYLES);
-/** 记录器表 */
-Journal._Loggers = new Map();
 
 exports.JOURNAL_DEFAULT_LEVEL_STYLES = JOURNAL_DEFAULT_LEVEL_STYLES;
 exports.JOURNAL_DEFAULT_LOGGER_NAME = JOURNAL_DEFAULT_LOGGER_NAME;
 exports.JOURNAL_LEVELS = JOURNAL_LEVELS;
 exports.JOURNAL_LEVEL_WEIGHTS = JOURNAL_LEVEL_WEIGHTS;
-exports.Journal = Journal;
+exports.JournalInit = JournalInit;
 exports.JournalLogger = JournalLogger;

package/dist/journal.d.ts

@@ -32,6 +32,56 @@ interface JournalManagerOptions {
     /** 初始记录器配置列表 */
     loggers?: JournalLoggerOptions[];
 }
+/** 日志记录器 */
+interface IJournalLogger {
+    /** 记录器名称 */
+    readonly Name: string;
+    /** 记录器分级 */
+    Level: JournalLevel;
+    /** 输出 debug 级别记录 */
+    Debug(message: string, ...args: unknown[]): void;
+    /** 输出 info 级别记录 */
+    Info(message: string, ...args: unknown[]): void;
+    /** 输出 warn 级别记录 */
+    Warn(message: string, ...args: unknown[]): void;
+    /** 输出 error 级别记录 */
+    Error(message: string, ...args: unknown[]): void;
+    /** 输出分级记录 */
+    Log(level: JournalLevel, message: string, ...args: unknown[]): void;
+}
+/** 日志管理器 */
+interface IJournal {
+    /** 获取记录器，不存在时以管理器当前分级创建并返回 */
+    Acquire(name: string): IJournalLogger;
+    /**
+     * 创建记录器；同名记录器已存在时更新其分级并返回原实例
+     * @param name   记录器名称
+     * @param level  记录器分级，默认为 debug
+     */
+    Create(name: string, level?: JournalLevel): IJournalLogger | null;
+    /** 移除记录器，返回是否移除成功 */
+    Remove(name: string): boolean;
+    /** 清空全部记录器，不影响默认记录器 */
+    Clear(): void;
+    /** 获取全部记录器，不包含默认记录器 */
+    All(): IJournalLogger[];
+    /** 获取管理器分级 */
+    GetLevel(): JournalLevel;
+    /** 设置管理器分级 */
+    SetLevel(level: JournalLevel): void;
+    /** 获取分级样式 */
+    GetLevelStyle(level: JournalLevel): Readonly<JournalLevelStyle>;
+    /** 更新分级样式，仅覆盖传入字段 */
+    SetLevelStyle(level: JournalLevel, style: Partial<JournalLevelStyle>): void;
+    /** 输出 debug 级别记录（默认记录器） */
+    Debug: (message: string, ...args: unknown[]) => void;
+    /** 输出 info 级别记录（默认记录器） */
+    Info: (message: string, ...args: unknown[]) => void;
+    /** 输出 warn 级别记录（默认记录器） */
+    Warn: (message: string, ...args: unknown[]) => void;
+    /** 输出 error 级别记录（默认记录器） */
+    Error: (message: string, ...args: unknown[]) => void;
+}
 
 /*****************************************************************************
   Author: DoooReyn
@@ -61,95 +111,33 @@ declare const JOURNAL_DEFAULT_LOGGER_NAME = "journal";
  * 1. 记录器分级低于所属管理器分级时，该记录器整体视为忽略；
  * 2. 记录分级低于记录器分级时，该条记录视为忽略。
  */
-declare class JournalLogger {
+declare class JournalLogger implements IJournalLogger {
     /** 记录器名称 */
-    readonly name: string;
+    readonly Name: string;
     /** 记录器分级 */
-    level: JournalLevel;
+    Level: JournalLevel;
     constructor(options: JournalLoggerOptions);
     /** 输出 debug 级别记录 */
-    debug(message: unknown, ...args: unknown[]): void;
+    Debug(message: string, ...args: unknown[]): void;
     /** 输出 info 级别记录 */
-    info(message: unknown, ...args: unknown[]): void;
+    Info(message: string, ...args: unknown[]): void;
     /** 输出 warn 级别记录 */
-    warn(message: unknown, ...args: unknown[]): void;
+    Warn(message: string, ...args: unknown[]): void;
     /** 输出 error 级别记录 */
-    error(message: unknown, ...args: unknown[]): void;
+    Error(message: string, ...args: unknown[]): void;
     /**
      * 输出一条记录，分级规则见类说明
      * @param level    记录分级
      * @param message  记录内容
      * @param args     附加内容，透传给 console
      */
-    log(level: JournalLevel, message: unknown, ...args: unknown[]): void;
+    Log(level: JournalLevel, message: string, ...args: unknown[]): void;
 }
 /**
- * 日志管理器（静态类）
- *
- * 通过 Journal.init(options) 初始化，必须初始化后才能使用：
- * 未初始化时管理器分级为 disable，任何记录都不会输出，
- * 且管理操作会被警告并忽略；使用 Journal.reset() 可恢复未初始化状态。
- * 内置一个默认记录器，用于便捷记录，不占用记录器表，分级随管理器动态调整。
+ * 初始化；仅首次调用生效，重复调用将被警告并忽略
+ * @param options 管理器配置
  */
-declare class Journal {
-    /** 是否已初始化 */
-    private static _Initialized;
-    /** 管理器分级；未初始化时为 disable，确保无任何输出 */
-    private static _Level;
-    /** 默认记录器；分级随管理器动态调整 */
-    private static _Logger;
-    /** 分级样式表 */
-    private static _Styles;
-    /** 记录器表 */
-    private static _Loggers;
-    /** 静态类，禁止实例化 */
-    private constructor();
-    /**
-     * 初始化；仅首次调用生效，重复调用将被警告并忽略
-     * @param options 管理器配置
-     */
-    static Init(options?: JournalManagerOptions): void;
-    /** 重置为未初始化状态：清空记录器、恢复默认样式与分级 */
-    static Reset(): void;
-    /** 管理器分级 */
-    static get Level(): JournalLevel;
-    static set Level(level: JournalLevel);
-    /** 输出 debug 级别记录（默认记录器） */
-    static Debug(message: unknown, ...args: unknown[]): void;
-    /** 输出 info 级别记录（默认记录器） */
-    static Info(message: unknown, ...args: unknown[]): void;
-    /** 输出 warn 级别记录（默认记录器） */
-    static Warn(message: unknown, ...args: unknown[]): void;
-    /** 输出 error 级别记录（默认记录器） */
-    static Error(message: unknown, ...args: unknown[]): void;
-    /**
-     * 输出一条记录（默认记录器）
-     * @param level    记录分级
-     * @param message  记录内容
-     * @param args     附加内容，透传给 console
-     */
-    private static Log;
-    /** 获取分级样式 */
-    static GetLevelStyle(level: JournalLevel): Readonly<JournalLevelStyle>;
-    /** 更新分级样式，仅覆盖传入字段 */
-    static SetLevelStyle(level: JournalLevel, style: Partial<JournalLevelStyle>): void;
-    /**
-     * 创建记录器；同名记录器已存在时更新其分级并返回原实例
-     * @param name   记录器名称
-     * @param level  记录器分级，默认为 debug
-     */
-    static CreateLogger(name: string, level?: JournalLevel): JournalLogger | null;
-    /** 获取记录器，不存在时以管理器当前分级创建并返回 */
-    static GetLogger(name: string): JournalLogger | null;
-    /** 移除记录器，返回是否移除成功 */
-    static RemoveLogger(name: string): boolean;
-    /** 清空全部记录器，不影响默认记录器 */
-    static ClearLoggers(): void;
-    /** 获取全部记录器，不含默认记录器 */
-    static GetLoggers(): JournalLogger[];
-    /** 未初始化时警告并返回 false */
-    private static EnsureReady;
-}
+declare function JournalInit(options?: JournalManagerOptions): IJournal;
 
-export { JOURNAL_DEFAULT_LEVEL_STYLES, JOURNAL_DEFAULT_LOGGER_NAME, JOURNAL_LEVELS, JOURNAL_LEVEL_WEIGHTS, Journal, JournalLogger };
-export type { JournalLevel, JournalLevelStyle, JournalLoggerOptions, JournalManagerOptions, JournalPrintLevel };
+export { JOURNAL_DEFAULT_LEVEL_STYLES, JOURNAL_DEFAULT_LOGGER_NAME, JOURNAL_LEVELS, JOURNAL_LEVEL_WEIGHTS, JournalInit, JournalLogger };
+export type { IJournal, IJournalLogger, JournalLevel, JournalLevelStyle, JournalLoggerOptions, JournalManagerOptions, JournalPrintLevel };

package/dist/journal.min.cjs

@@ -1 +1 @@
-"use strict";const e=["debug","info","warn","error","disable"],r={debug:0,info:1,warn:2,error:3,disable:4},l={debug:{label:"[Debug]",color:"#8C8C8C"},info:{label:"[Info]",color:"#0986FF"},warn:{label:"[Warn]",color:"#E6A23C"},error:{label:"[Error]",color:"#D93026"},disable:{label:"[Disable]",color:""}},o="journal",t={debug:"log",info:"info",warn:"warn",error:"error"};class n{constructor(e){var r;this.name=e.name,this.level=null!==(r=e.level)&&void 0!==r?r:"debug"}debug(e,...r){this.log("debug",e,...r)}info(e,...r){this.log("info",e,...r)}warn(e,...r){this.log("warn",e,...r)}error(e,...r){this.log("error",e,...r)}log(e,l,...o){if("disable"===e)return;if(r[this.level]<r[s.Level])return;if(r[e]<r[this.level])return;const n=s.GetLevelStyle(e),i=`[${this.name}] ${String(l)}`,a=t[e];n.color?console[a](`%c${n.label}%c ${i}`,`color:${n.color};font-weight:bold;`,"color:inherit;font-weight:inherit;",...o):console[a](`${n.label} ${i}`,...o)}}class s{constructor(){}static Init(r){var l,t,i;if(s._Initialized)return void console.warn("[Journal] 已初始化，请勿重复调用 init()");s._Initialized=!0,s._Level=null!==(l=null==r?void 0:r.level)&&void 0!==l?l:"debug",s._Logger=new n({name:o,level:s._Level});const a=null==r?void 0:r.levels;if(a)for(const r of e){const e=a[r];e&&(s._Styles[r]=Object.assign(Object.assign({},s._Styles[r]),e))}for(const e of null!==(t=null==r?void 0:r.loggers)&&void 0!==t?t:[])s.CreateLogger(e.name,null!==(i=e.level)&&void 0!==i?i:"debug")}static Reset(){s._Initialized=!1,s._Level="disable",s._Logger=null,s._Styles=Object.assign({},l),s._Loggers.clear()}static get Level(){return s._Level}static set Level(e){s.EnsureReady()&&(s._Level=e,s._Logger.level=e)}static Debug(e,...r){s.Log("debug",e,...r)}static Info(e,...r){s.Log("info",e,...r)}static Warn(e,...r){s.Log("warn",e,...r)}static Error(e,...r){s.Log("error",e,...r)}static Log(e,r,...l){var o;s.EnsureReady()&&(null===(o=s._Logger)||void 0===o||o.log(e,r,...l))}static GetLevelStyle(e){return s._Styles[e]}static SetLevelStyle(e,r){s.EnsureReady()&&(s._Styles[e]=Object.assign(Object.assign({},s._Styles[e]),r))}static CreateLogger(e,r="debug"){if(!s.EnsureReady())return null;const l=s._Loggers.get(e);if(l)return l.level=r,l;const o=new n({name:e,level:r});return s._Loggers.set(e,o),o}static GetLogger(e){var r;return s.EnsureReady()?null!==(r=s._Loggers.get(e))&&void 0!==r?r:s.CreateLogger(e,s._Level):null}static RemoveLogger(e){return s._Loggers.delete(e)}static ClearLoggers(){s._Loggers.clear()}static GetLoggers(){return[...s._Loggers.values()]}static EnsureReady(){return!!s._Initialized||(console.warn("[Journal] 尚未初始化，请先调用 Journal.Init()"),!1)}}s._Initialized=!1,s._Level="disable",s._Logger=null,s._Styles=Object.assign({},l),s._Loggers=new Map,exports.JOURNAL_DEFAULT_LEVEL_STYLES=l,exports.JOURNAL_DEFAULT_LOGGER_NAME=o,exports.JOURNAL_LEVELS=e,exports.JOURNAL_LEVEL_WEIGHTS=r,exports.Journal=s,exports.JournalLogger=n;
+"use strict";const e=["debug","info","warn","error","disable"],l={debug:0,info:1,warn:2,error:3,disable:4},o={debug:{label:"[Debug]",color:"#8C8C8C"},info:{label:"[Info]",color:"#0986FF"},warn:{label:"[Warn]",color:"#E6A23C"},error:{label:"[Error]",color:"#D93026"},disable:{label:"[Disable]",color:""}},r="journal",n={debug:"log",info:"info",warn:"warn",error:"error"};class t{constructor(e){var l;this.Name=e.name,this.Level=null!==(l=e.level)&&void 0!==l?l:"debug"}Debug(e,...l){this.Log("debug",e,...l)}Info(e,...l){this.Log("info",e,...l)}Warn(e,...l){this.Log("warn",e,...l)}Error(e,...l){this.Log("error",e,...l)}Log(e,o,...r){if("disable"===e)return;if(l[this.Level]<l[s()])return;if(l[e]<l[this.Level])return;const t=_(e),i=`[${this.Name}] ${String(o)}`,u=n[e];t.color?console[u](`%c${t.label}%c ${i}`,`color:${t.color};font-weight:bold;`,"color:inherit;font-weight:inherit;",...r):console[u](`${t.label} ${i}`,...r)}}const i={_initialized:!1,_level:"disable",_logger:null,_styles:Object.assign({},o),_loggers:new Map};function s(){return i._level}function u(e){i._level=e,i._logger.Level=e}function g(e,...l){v("debug",e,...l)}function a(e,...l){v("info",e,...l)}function c(e,...l){v("warn",e,...l)}function f(e,...l){v("error",e,...l)}function v(e,l,...o){i._logger.Log(e,l,...o)}function _(e){return i._styles[e]}function b(e,l){i._styles[e]=Object.assign(Object.assign({},i._styles[e]),l)}function L(e,l="debug"){const o=i._loggers.get(e);if(o)return o.Level=l,o;const r=new t({name:e,level:l});return i._loggers.set(e,r),r}function d(e){var l;return null!==(l=i._loggers.get(e))&&void 0!==l?l:L(e,i._level)}function E(e){return i._loggers.delete(e)}function h(){i._loggers.clear()}function w(){return[...i._loggers.values()]}exports.JOURNAL_DEFAULT_LEVEL_STYLES=o,exports.JOURNAL_DEFAULT_LOGGER_NAME=r,exports.JOURNAL_LEVELS=e,exports.JOURNAL_LEVEL_WEIGHTS=l,exports.JournalInit=function(l){var o,n,v;if(i._initialized)return void console.warn("[Journal] 已初始化，请勿重复调用");i._initialized=!0,i._level=null!==(o=null==l?void 0:l.level)&&void 0!==o?o:"debug",i._logger=new t({name:r,level:i._level});const A=null==l?void 0:l.levels;if(A)for(const l of e){const e=A[l];e&&(i._styles[l]=Object.assign(Object.assign({},i._styles[l]),e))}for(const e of null!==(n=null==l?void 0:l.loggers)&&void 0!==n?n:[])L(e.name,null!==(v=e.level)&&void 0!==v?v:"debug");return{Acquire:d,Create:L,Remove:E,Clear:h,All:w,GetLevel:s,SetLevel:u,GetLevelStyle:_,SetLevelStyle:b,Debug:g,Info:a,Warn:c,Error:f}},exports.JournalLogger=t;

package/dist/journal.min.mjs

@@ -1 +1 @@
-const e=["debug","info","warn","error","disable"],l={debug:0,info:1,warn:2,error:3,disable:4},r={debug:{label:"[Debug]",color:"#8C8C8C"},info:{label:"[Info]",color:"#0986FF"},warn:{label:"[Warn]",color:"#E6A23C"},error:{label:"[Error]",color:"#D93026"},disable:{label:"[Disable]",color:""}},t="journal",o={debug:"log",info:"info",warn:"warn",error:"error"};class n{constructor(e){var l;this.name=e.name,this.level=null!==(l=e.level)&&void 0!==l?l:"debug"}debug(e,...l){this.log("debug",e,...l)}info(e,...l){this.log("info",e,...l)}warn(e,...l){this.log("warn",e,...l)}error(e,...l){this.log("error",e,...l)}log(e,r,...t){if("disable"===e)return;if(l[this.level]<l[s.Level])return;if(l[e]<l[this.level])return;const n=s.GetLevelStyle(e),i=`[${this.name}] ${String(r)}`,a=o[e];n.color?console[a](`%c${n.label}%c ${i}`,`color:${n.color};font-weight:bold;`,"color:inherit;font-weight:inherit;",...t):console[a](`${n.label} ${i}`,...t)}}class s{constructor(){}static Init(l){var r,o,i;if(s._Initialized)return void console.warn("[Journal] 已初始化，请勿重复调用 init()");s._Initialized=!0,s._Level=null!==(r=null==l?void 0:l.level)&&void 0!==r?r:"debug",s._Logger=new n({name:t,level:s._Level});const a=null==l?void 0:l.levels;if(a)for(const l of e){const e=a[l];e&&(s._Styles[l]=Object.assign(Object.assign({},s._Styles[l]),e))}for(const e of null!==(o=null==l?void 0:l.loggers)&&void 0!==o?o:[])s.CreateLogger(e.name,null!==(i=e.level)&&void 0!==i?i:"debug")}static Reset(){s._Initialized=!1,s._Level="disable",s._Logger=null,s._Styles=Object.assign({},r),s._Loggers.clear()}static get Level(){return s._Level}static set Level(e){s.EnsureReady()&&(s._Level=e,s._Logger.level=e)}static Debug(e,...l){s.Log("debug",e,...l)}static Info(e,...l){s.Log("info",e,...l)}static Warn(e,...l){s.Log("warn",e,...l)}static Error(e,...l){s.Log("error",e,...l)}static Log(e,l,...r){var t;s.EnsureReady()&&(null===(t=s._Logger)||void 0===t||t.log(e,l,...r))}static GetLevelStyle(e){return s._Styles[e]}static SetLevelStyle(e,l){s.EnsureReady()&&(s._Styles[e]=Object.assign(Object.assign({},s._Styles[e]),l))}static CreateLogger(e,l="debug"){if(!s.EnsureReady())return null;const r=s._Loggers.get(e);if(r)return r.level=l,r;const t=new n({name:e,level:l});return s._Loggers.set(e,t),t}static GetLogger(e){var l;return s.EnsureReady()?null!==(l=s._Loggers.get(e))&&void 0!==l?l:s.CreateLogger(e,s._Level):null}static RemoveLogger(e){return s._Loggers.delete(e)}static ClearLoggers(){s._Loggers.clear()}static GetLoggers(){return[...s._Loggers.values()]}static EnsureReady(){return!!s._Initialized||(console.warn("[Journal] 尚未初始化，请先调用 Journal.Init()"),!1)}}s._Initialized=!1,s._Level="disable",s._Logger=null,s._Styles=Object.assign({},r),s._Loggers=new Map;export{r as JOURNAL_DEFAULT_LEVEL_STYLES,t as JOURNAL_DEFAULT_LOGGER_NAME,e as JOURNAL_LEVELS,l as JOURNAL_LEVEL_WEIGHTS,s as Journal,n as JournalLogger};
+const e=["debug","info","warn","error","disable"],l={debug:0,info:1,warn:2,error:3,disable:4},o={debug:{label:"[Debug]",color:"#8C8C8C"},info:{label:"[Info]",color:"#0986FF"},warn:{label:"[Warn]",color:"#E6A23C"},error:{label:"[Error]",color:"#D93026"},disable:{label:"[Disable]",color:""}},n="journal",r={debug:"log",info:"info",warn:"warn",error:"error"};class t{constructor(e){var l;this.Name=e.name,this.Level=null!==(l=e.level)&&void 0!==l?l:"debug"}Debug(e,...l){this.Log("debug",e,...l)}Info(e,...l){this.Log("info",e,...l)}Warn(e,...l){this.Log("warn",e,...l)}Error(e,...l){this.Log("error",e,...l)}Log(e,o,...n){if("disable"===e)return;if(l[this.Level]<l[g()])return;if(l[e]<l[this.Level])return;const t=d(e),i=`[${this.Name}] ${String(o)}`,s=r[e];t.color?console[s](`%c${t.label}%c ${i}`,`color:${t.color};font-weight:bold;`,"color:inherit;font-weight:inherit;",...n):console[s](`${t.label} ${i}`,...n)}}const i={_initialized:!1,_level:"disable",_logger:null,_styles:Object.assign({},o),_loggers:new Map};function s(l){var o,r,s;if(i._initialized)return void console.warn("[Journal] 已初始化，请勿重复调用");i._initialized=!0,i._level=null!==(o=null==l?void 0:l.level)&&void 0!==o?o:"debug",i._logger=new t({name:n,level:i._level});const b=null==l?void 0:l.levels;if(b)for(const l of e){const e=b[l];e&&(i._styles[l]=Object.assign(Object.assign({},i._styles[l]),e))}for(const e of null!==(r=null==l?void 0:l.loggers)&&void 0!==r?r:[])L(e.name,null!==(s=e.level)&&void 0!==s?s:"debug");return{Acquire:h,Create:L,Remove:w,Clear:y,All:m,GetLevel:g,SetLevel:u,GetLevelStyle:d,SetLevelStyle:_,Debug:a,Info:c,Warn:f,Error:v}}function g(){return i._level}function u(e){i._level=e,i._logger.Level=e}function a(e,...l){b("debug",e,...l)}function c(e,...l){b("info",e,...l)}function f(e,...l){b("warn",e,...l)}function v(e,...l){b("error",e,...l)}function b(e,l,...o){i._logger.Log(e,l,...o)}function d(e){return i._styles[e]}function _(e,l){i._styles[e]=Object.assign(Object.assign({},i._styles[e]),l)}function L(e,l="debug"){const o=i._loggers.get(e);if(o)return o.Level=l,o;const n=new t({name:e,level:l});return i._loggers.set(e,n),n}function h(e){var l;return null!==(l=i._loggers.get(e))&&void 0!==l?l:L(e,i._level)}function w(e){return i._loggers.delete(e)}function y(){i._loggers.clear()}function m(){return[...i._loggers.values()]}export{o as JOURNAL_DEFAULT_LEVEL_STYLES,n as JOURNAL_DEFAULT_LOGGER_NAME,e as JOURNAL_LEVELS,l as JOURNAL_LEVEL_WEIGHTS,s as JournalInit,t as JournalLogger};

package/dist/journal.mjs

@@ -46,24 +46,24 @@ const CONSOLE_METHODS = {
 class JournalLogger {
     constructor(options) {
         var _a;
-        this.name = options.name;
-        this.level = (_a = options.level) !== null && _a !== void 0 ? _a : 'debug';
+        this.Name = options.name;
+        this.Level = (_a = options.level) !== null && _a !== void 0 ? _a : 'debug';
     }
     /** 输出 debug 级别记录 */
-    debug(message, ...args) {
-        this.log('debug', message, ...args);
+    Debug(message, ...args) {
+        this.Log('debug', message, ...args);
     }
     /** 输出 info 级别记录 */
-    info(message, ...args) {
-        this.log('info', message, ...args);
+    Info(message, ...args) {
+        this.Log('info', message, ...args);
     }
     /** 输出 warn 级别记录 */
-    warn(message, ...args) {
-        this.log('warn', message, ...args);
+    Warn(message, ...args) {
+        this.Log('warn', message, ...args);
     }
     /** 输出 error 级别记录 */
-    error(message, ...args) {
-        this.log('error', message, ...args);
+    Error(message, ...args) {
+        this.Log('error', message, ...args);
     }
     /**
      * 输出一条记录，分级规则见类说明
@@ -71,18 +71,18 @@ class JournalLogger {
      * @param message  记录内容
      * @param args     附加内容，透传给 console
      */
-    log(level, message, ...args) {
+    Log(level, message, ...args) {
         if (level === 'disable') {
             return;
         }
-        if (JOURNAL_LEVEL_WEIGHTS[this.level] < JOURNAL_LEVEL_WEIGHTS[Journal.Level]) {
+        if (JOURNAL_LEVEL_WEIGHTS[this.Level] < JOURNAL_LEVEL_WEIGHTS[GetLevel()]) {
             return;
         }
-        if (JOURNAL_LEVEL_WEIGHTS[level] < JOURNAL_LEVEL_WEIGHTS[this.level]) {
+        if (JOURNAL_LEVEL_WEIGHTS[level] < JOURNAL_LEVEL_WEIGHTS[this.Level]) {
             return;
         }
-        const style = Journal.GetLevelStyle(level);
-        const text = `[${this.name}] ${String(message)}`;
+        const style = GetLevelStyle(level);
+        const text = `[${this.Name}] ${String(message)}`;
         const method = CONSOLE_METHODS[level];
         if (style.color) {
             console[method](`%c${style.label}%c ${text}`, `color:${style.color};font-weight:bold;`, 'color:inherit;font-weight:inherit;', ...args);
@@ -93,157 +93,137 @@ class JournalLogger {
     }
 }
 /**
- * 日志管理器（静态类）
- *
- * 通过 Journal.init(options) 初始化，必须初始化后才能使用：
- * 未初始化时管理器分级为 disable，任何记录都不会输出，
- * 且管理操作会被警告并忽略；使用 Journal.reset() 可恢复未初始化状态。
- * 内置一个默认记录器，用于便捷记录，不占用记录器表，分级随管理器动态调整。
+ * 日志记录器环境
  */
-class Journal {
-    /** 静态类，禁止实例化 */
-    constructor() { }
-    /**
-     * 初始化；仅首次调用生效，重复调用将被警告并忽略
-     * @param options 管理器配置
-     */
-    static Init(options) {
-        var _a, _b, _c;
-        if (Journal._Initialized) {
-            console.warn('[Journal] 已初始化，请勿重复调用 init()');
-            return;
-        }
-        Journal._Initialized = true;
-        Journal._Level = (_a = options === null || options === void 0 ? void 0 : options.level) !== null && _a !== void 0 ? _a : 'debug';
-        Journal._Logger = new JournalLogger({ name: JOURNAL_DEFAULT_LOGGER_NAME, level: Journal._Level });
-        const overrides = options === null || options === void 0 ? void 0 : options.levels;
-        if (overrides) {
-            for (const level of JOURNAL_LEVELS) {
-                const style = overrides[level];
-                if (style) {
-                    Journal._Styles[level] = Object.assign(Object.assign({}, Journal._Styles[level]), style);
-                }
+const JournalEnv = {
+    _initialized: false,
+    _level: 'disable',
+    _logger: null,
+    _styles: Object.assign({}, JOURNAL_DEFAULT_LEVEL_STYLES),
+    _loggers: new Map(),
+};
+/**
+ * 初始化；仅首次调用生效，重复调用将被警告并忽略
+ * @param options 管理器配置
+ */
+function JournalInit(options) {
+    var _a, _b, _c;
+    if (JournalEnv._initialized) {
+        console.warn('[Journal] 已初始化，请勿重复调用');
+        return;
+    }
+    JournalEnv._initialized = true;
+    JournalEnv._level = (_a = options === null || options === void 0 ? void 0 : options.level) !== null && _a !== void 0 ? _a : 'debug';
+    JournalEnv._logger = new JournalLogger({
+        name: JOURNAL_DEFAULT_LOGGER_NAME,
+        level: JournalEnv._level,
+    });
+    const overrides = options === null || options === void 0 ? void 0 : options.levels;
+    if (overrides) {
+        for (const level of JOURNAL_LEVELS) {
+            const style = overrides[level];
+            if (style) {
+                JournalEnv._styles[level] = Object.assign(Object.assign({}, JournalEnv._styles[level]), style);
             }
         }
-        for (const config of (_b = options === null || options === void 0 ? void 0 : options.loggers) !== null && _b !== void 0 ? _b : []) {
-            Journal.CreateLogger(config.name, (_c = config.level) !== null && _c !== void 0 ? _c : 'debug');
-        }
-    }
-    /** 重置为未初始化状态：清空记录器、恢复默认样式与分级 */
-    static Reset() {
-        Journal._Initialized = false;
-        Journal._Level = 'disable';
-        Journal._Logger = null;
-        Journal._Styles = Object.assign({}, JOURNAL_DEFAULT_LEVEL_STYLES);
-        Journal._Loggers.clear();
-    }
-    /** 管理器分级 */
-    static get Level() {
-        return Journal._Level;
-    }
-    static set Level(level) {
-        if (!Journal.EnsureReady()) {
-            return;
-        }
-        Journal._Level = level;
-        Journal._Logger.level = level;
-    }
-    /** 输出 debug 级别记录（默认记录器） */
-    static Debug(message, ...args) {
-        Journal.Log('debug', message, ...args);
-    }
-    /** 输出 info 级别记录（默认记录器） */
-    static Info(message, ...args) {
-        Journal.Log('info', message, ...args);
-    }
-    /** 输出 warn 级别记录（默认记录器） */
-    static Warn(message, ...args) {
-        Journal.Log('warn', message, ...args);
-    }
-    /** 输出 error 级别记录（默认记录器） */
-    static Error(message, ...args) {
-        Journal.Log('error', message, ...args);
-    }
-    /**
-     * 输出一条记录（默认记录器）
-     * @param level    记录分级
-     * @param message  记录内容
-     * @param args     附加内容，透传给 console
-     */
-    static Log(level, message, ...args) {
-        var _a;
-        if (!Journal.EnsureReady()) {
-            return;
-        }
-        (_a = Journal._Logger) === null || _a === void 0 ? void 0 : _a.log(level, message, ...args);
     }
-    /** 获取分级样式 */
-    static GetLevelStyle(level) {
-        return Journal._Styles[level];
-    }
-    /** 更新分级样式，仅覆盖传入字段 */
-    static SetLevelStyle(level, style) {
-        if (!Journal.EnsureReady()) {
-            return;
-        }
-        Journal._Styles[level] = Object.assign(Object.assign({}, Journal._Styles[level]), style);
+    for (const config of (_b = options === null || options === void 0 ? void 0 : options.loggers) !== null && _b !== void 0 ? _b : []) {
+        Create(config.name, (_c = config.level) !== null && _c !== void 0 ? _c : 'debug');
     }
     /**
-     * 创建记录器；同名记录器已存在时更新其分级并返回原实例
-     * @param name   记录器名称
-     * @param level  记录器分级，默认为 debug
+     * 日志管理器
+     *
+     * 内置一个默认记录器，用于便捷记录，不占用记录器表，分级随管理器动态调整。
      */
-    static CreateLogger(name, level = 'debug') {
-        if (!Journal.EnsureReady()) {
-            return null;
-        }
-        const existing = Journal._Loggers.get(name);
-        if (existing) {
-            existing.level = level;
-            return existing;
-        }
-        const logger = new JournalLogger({ name, level });
-        Journal._Loggers.set(name, logger);
-        return logger;
-    }
-    /** 获取记录器，不存在时以管理器当前分级创建并返回 */
-    static GetLogger(name) {
-        var _a;
-        if (!Journal.EnsureReady()) {
-            return null;
-        }
-        return (_a = Journal._Loggers.get(name)) !== null && _a !== void 0 ? _a : Journal.CreateLogger(name, Journal._Level);
-    }
-    /** 移除记录器，返回是否移除成功 */
-    static RemoveLogger(name) {
-        return Journal._Loggers.delete(name);
-    }
-    /** 清空全部记录器，不影响默认记录器 */
-    static ClearLoggers() {
-        Journal._Loggers.clear();
-    }
-    /** 获取全部记录器，不含默认记录器 */
-    static GetLoggers() {
-        return [...Journal._Loggers.values()];
-    }
-    /** 未初始化时警告并返回 false */
-    static EnsureReady() {
-        if (!Journal._Initialized) {
-            console.warn('[Journal] 尚未初始化，请先调用 Journal.Init()');
-            return false;
-        }
-        return true;
-    }
+    return {
+        Acquire,
+        Create,
+        Remove,
+        Clear,
+        All,
+        GetLevel,
+        SetLevel,
+        GetLevelStyle,
+        SetLevelStyle,
+        Debug,
+        Info,
+        Warn,
+        Error,
+    };
+}
+/** 获取管理器分级 */
+function GetLevel() {
+    return JournalEnv._level;
+}
+/** 设置管理器分级 */
+function SetLevel(level) {
+    JournalEnv._level = level;
+    JournalEnv._logger.Level = level;
+}
+/** 输出 debug 级别记录（默认记录器） */
+function Debug(message, ...args) {
+    Log('debug', message, ...args);
+}
+/** 输出 info 级别记录（默认记录器） */
+function Info(message, ...args) {
+    Log('info', message, ...args);
+}
+/** 输出 warn 级别记录（默认记录器） */
+function Warn(message, ...args) {
+    Log('warn', message, ...args);
+}
+/** 输出 error 级别记录（默认记录器） */
+function Error(message, ...args) {
+    Log('error', message, ...args);
+}
+/**
+ * 输出一条记录（默认记录器）
+ * @param level    记录分级
+ * @param message  记录内容
+ * @param args     附加内容，透传给 console
+ */
+function Log(level, message, ...args) {
+    JournalEnv._logger.Log(level, message, ...args);
+}
+/** 获取分级样式 */
+function GetLevelStyle(level) {
+    return JournalEnv._styles[level];
+}
+/** 更新分级样式，仅覆盖传入字段 */
+function SetLevelStyle(level, style) {
+    JournalEnv._styles[level] = Object.assign(Object.assign({}, JournalEnv._styles[level]), style);
+}
+/**
+ * 创建记录器；同名记录器已存在时更新其分级并返回原实例
+ * @param name   记录器名称
+ * @param level  记录器分级，默认为 debug
+ */
+function Create(name, level = 'debug') {
+    const existing = JournalEnv._loggers.get(name);
+    if (existing) {
+        existing.Level = level;
+        return existing;
+    }
+    const logger = new JournalLogger({ name, level });
+    JournalEnv._loggers.set(name, logger);
+    return logger;
+}
+/** 获取记录器，不存在时以管理器当前分级创建并返回 */
+function Acquire(name) {
+    var _a;
+    return (_a = JournalEnv._loggers.get(name)) !== null && _a !== void 0 ? _a : Create(name, JournalEnv._level);
+}
+/** 移除记录器，返回是否移除成功 */
+function Remove(name) {
+    return JournalEnv._loggers.delete(name);
+}
+/** 清空全部记录器，不影响默认记录器 */
+function Clear() {
+    JournalEnv._loggers.clear();
+}
+/** 获取全部记录器，不包含默认记录器 */
+function All() {
+    return [...JournalEnv._loggers.values()];
 }
-/** 是否已初始化 */
-Journal._Initialized = false;
-/** 管理器分级；未初始化时为 disable，确保无任何输出 */
-Journal._Level = 'disable';
-/** 默认记录器；分级随管理器动态调整 */
-Journal._Logger = null;
-/** 分级样式表 */
-Journal._Styles = Object.assign({}, JOURNAL_DEFAULT_LEVEL_STYLES);
-/** 记录器表 */
-Journal._Loggers = new Map();
 
-export { JOURNAL_DEFAULT_LEVEL_STYLES, JOURNAL_DEFAULT_LOGGER_NAME, JOURNAL_LEVELS, JOURNAL_LEVEL_WEIGHTS, Journal, JournalLogger };
+export { JOURNAL_DEFAULT_LEVEL_STYLES, JOURNAL_DEFAULT_LOGGER_NAME, JOURNAL_LEVELS, JOURNAL_LEVEL_WEIGHTS, JournalInit, JournalLogger };

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebulaaa/journal",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "description": "日志记录扩展包",
   "author": "doooreyn",
   "license": "MIT",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebulaaa/journal",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "description": "日志记录扩展包",
   "main": "./dist/journal.cjs",
   "module": "./dist/journal.mjs",