@nebulaaa/journal 1.1.0 → 1.1.2

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[GetLevel()]) {
+        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 = GetLevelStyle(level);
-        const text = `[${this.name}] ${String(message)}`;
+        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,10 +95,10 @@ class JournalLogger {
     }
 }
 /**
- * 日志记录器环境
+ * 日志记录器上下文
  */
-const JournalEnv = {
-    _initialized: false,
+const JournalContext = {
+    _instance: null,
     _level: 'disable',
     _logger: null,
     _styles: Object.assign({}, JOURNAL_DEFAULT_LEVEL_STYLES),
@@ -110,34 +110,28 @@ const JournalEnv = {
  */
 function JournalInit(options) {
     var _a, _b, _c;
-    if (JournalEnv._initialized) {
+    if (JournalContext._instance) {
         console.warn('[Journal] 已初始化，请勿重复调用');
-        return;
+        return JournalContext._instance;
     }
-    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({
+    JournalContext._level = (_a = options === null || options === void 0 ? void 0 : options.level) !== null && _a !== void 0 ? _a : 'debug';
+    JournalContext._logger = new JournalLogger({
         name: JOURNAL_DEFAULT_LOGGER_NAME,
-        level: JournalEnv._level,
+        level: JournalContext._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);
+                JournalContext._styles[level] = Object.assign(Object.assign({}, JournalContext._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');
     }
-    /**
-     * 日志管理器
-     *
-     * 内置一个默认记录器，用于便捷记录，不占用记录器表，分级随管理器动态调整。
-     */
-    return {
+    JournalContext._instance = {
         Acquire,
         Create,
         Remove,
@@ -152,15 +146,16 @@ function JournalInit(options) {
         Warn,
         Error,
     };
+    return JournalContext._instance;
 }
 /** 获取管理器分级 */
 function GetLevel() {
-    return JournalEnv._level;
+    return JournalContext._level;
 }
 /** 设置管理器分级 */
 function SetLevel(level) {
-    JournalEnv._level = level;
-    JournalEnv._logger.level = level;
+    JournalContext._level = level;
+    JournalContext._logger.Level = level;
 }
 /** 输出 debug 级别记录（默认记录器） */
 function Debug(message, ...args) {
@@ -185,15 +180,15 @@ function Error(message, ...args) {
  * @param args     附加内容，透传给 console
  */
 function Log(level, message, ...args) {
-    JournalEnv._logger.log(level, message, ...args);
+    JournalContext._logger.Log(level, message, ...args);
 }
 /** 获取分级样式 */
 function GetLevelStyle(level) {
-    return JournalEnv._styles[level];
+    return JournalContext._styles[level];
 }
 /** 更新分级样式，仅覆盖传入字段 */
 function SetLevelStyle(level, style) {
-    JournalEnv._styles[level] = Object.assign(Object.assign({}, JournalEnv._styles[level]), style);
+    JournalContext._styles[level] = Object.assign(Object.assign({}, JournalContext._styles[level]), style);
 }
 /**
  * 创建记录器；同名记录器已存在时更新其分级并返回原实例
@@ -201,31 +196,31 @@ function SetLevelStyle(level, style) {
  * @param level  记录器分级，默认为 debug
  */
 function Create(name, level = 'debug') {
-    const existing = JournalEnv._loggers.get(name);
+    const existing = JournalContext._loggers.get(name);
     if (existing) {
-        existing.level = level;
+        existing.Level = level;
         return existing;
     }
     const logger = new JournalLogger({ name, level });
-    JournalEnv._loggers.set(name, logger);
+    JournalContext._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);
+    return (_a = JournalContext._loggers.get(name)) !== null && _a !== void 0 ? _a : Create(name, JournalContext._level);
 }
 /** 移除记录器，返回是否移除成功 */
 function Remove(name) {
-    return JournalEnv._loggers.delete(name);
+    return JournalContext._loggers.delete(name);
 }
 /** 清空全部记录器，不影响默认记录器 */
 function Clear() {
-    JournalEnv._loggers.clear();
+    JournalContext._loggers.clear();
 }
 /** 获取全部记录器，不包含默认记录器 */
 function All() {
-    return [...JournalEnv._loggers.values()];
+    return [...JournalContext._loggers.values()];
 }
 
 exports.JOURNAL_DEFAULT_LEVEL_STYLES = JOURNAL_DEFAULT_LEVEL_STYLES;

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,77 +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;
 }
 /**
  * 初始化；仅首次调用生效，重复调用将被警告并忽略
  * @param options 管理器配置
  */
-declare function JournalInit(options?: JournalManagerOptions): {
-    Acquire: typeof Acquire;
-    Create: typeof Create;
-    Remove: typeof Remove;
-    Clear: typeof Clear;
-    All: typeof All;
-    GetLevel: typeof GetLevel;
-    SetLevel: typeof SetLevel;
-    GetLevelStyle: typeof GetLevelStyle;
-    SetLevelStyle: typeof SetLevelStyle;
-    Debug: typeof Debug;
-    Info: typeof Info;
-    Warn: typeof Warn;
-    Error: typeof Error;
-};
-/** 获取管理器分级 */
-declare function GetLevel(): JournalLevel;
-/** 设置管理器分级 */
-declare function SetLevel(level: JournalLevel): void;
-/** 输出 debug 级别记录（默认记录器） */
-declare function Debug(message: unknown, ...args: unknown[]): void;
-/** 输出 info 级别记录（默认记录器） */
-declare function Info(message: unknown, ...args: unknown[]): void;
-/** 输出 warn 级别记录（默认记录器） */
-declare function Warn(message: unknown, ...args: unknown[]): void;
-/** 输出 error 级别记录（默认记录器） */
-declare function Error(message: unknown, ...args: unknown[]): void;
-/** 获取分级样式 */
-declare function GetLevelStyle(level: JournalLevel): Readonly<JournalLevelStyle>;
-/** 更新分级样式，仅覆盖传入字段 */
-declare function SetLevelStyle(level: JournalLevel, style: Partial<JournalLevelStyle>): void;
-/**
- * 创建记录器；同名记录器已存在时更新其分级并返回原实例
- * @param name   记录器名称
- * @param level  记录器分级，默认为 debug
- */
-declare function Create(name: string, level?: JournalLevel): JournalLogger | null;
-/** 获取记录器，不存在时以管理器当前分级创建并返回 */
-declare function Acquire(name: string): JournalLogger;
-/** 移除记录器，返回是否移除成功 */
-declare function Remove(name: string): boolean;
-/** 清空全部记录器，不影响默认记录器 */
-declare function Clear(): void;
-/** 获取全部记录器，不包含默认记录器 */
-declare function All(): JournalLogger[];
+declare function JournalInit(options?: JournalManagerOptions): IJournal;
 
 export { JOURNAL_DEFAULT_LEVEL_STYLES, JOURNAL_DEFAULT_LOGGER_NAME, JOURNAL_LEVELS, JOURNAL_LEVEL_WEIGHTS, JournalInit, JournalLogger };
-export type { JournalLevel, JournalLevelStyle, JournalLoggerOptions, JournalManagerOptions, JournalPrintLevel };
+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"],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[s()])return;if(l[e]<l[this.level])return;const t=_(e),i=`[${this.name}] ${String(o)}`,u=r[e];t.color?console[u](`%c${t.label}%c ${i}`,`color:${t.color};font-weight:bold;`,"color:inherit;font-weight:inherit;",...n):console[u](`${t.label} ${i}`,...n)}}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 d(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 L(e){var l;return null!==(l=i._loggers.get(e))&&void 0!==l?l:d(e,i._level)}function E(e){return i._loggers.delete(e)}function w(){i._loggers.clear()}function h(){return[...i._loggers.values()]}exports.JOURNAL_DEFAULT_LEVEL_STYLES=o,exports.JOURNAL_DEFAULT_LOGGER_NAME=n,exports.JOURNAL_LEVELS=e,exports.JOURNAL_LEVEL_WEIGHTS=l,exports.JournalInit=function(l){var o,r,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:n,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!==(r=null==l?void 0:l.loggers)&&void 0!==r?r:[])d(e.name,null!==(v=e.level)&&void 0!==v?v:"debug");return{Acquire:L,Create:d,Remove:E,Clear:w,All:h,GetLevel:s,SetLevel:u,GetLevelStyle:_,SetLevelStyle:b,Debug:g,Info:a,Warn:c,Error:f}},exports.JournalLogger=t;
+"use strict";const e=["debug","info","warn","error","disable"],l={debug:0,info:1,warn:2,error:3,disable:4},n={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",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,n,...o){if("disable"===e)return;if(l[this.Level]<l[i()])return;if(l[e]<l[this.Level])return;const t=v(e),s=`[${this.Name}] ${String(n)}`,u=r[e];t.color?console[u](`%c${t.label}%c ${s}`,`color:${t.color};font-weight:bold;`,"color:inherit;font-weight:inherit;",...o):console[u](`${t.label} ${s}`,...o)}}const s={_instance:null,_level:"disable",_logger:null,_styles:Object.assign({},n),_loggers:new Map};function i(){return s._level}function u(e){s._level=e,s._logger.Level=e}function g(e,...l){_("debug",e,...l)}function c(e,...l){_("info",e,...l)}function a(e,...l){_("warn",e,...l)}function f(e,...l){_("error",e,...l)}function _(e,l,...n){s._logger.Log(e,l,...n)}function v(e){return s._styles[e]}function b(e,l){s._styles[e]=Object.assign(Object.assign({},s._styles[e]),l)}function L(e,l="debug"){const n=s._loggers.get(e);if(n)return n.Level=l,n;const o=new t({name:e,level:l});return s._loggers.set(e,o),o}function d(e){var l;return null!==(l=s._loggers.get(e))&&void 0!==l?l:L(e,s._level)}function E(e){return s._loggers.delete(e)}function h(){s._loggers.clear()}function w(){return[...s._loggers.values()]}exports.JOURNAL_DEFAULT_LEVEL_STYLES=n,exports.JOURNAL_DEFAULT_LOGGER_NAME=o,exports.JOURNAL_LEVELS=e,exports.JOURNAL_LEVEL_WEIGHTS=l,exports.JournalInit=function(l){var n,r,_;if(s._instance)return console.warn("[Journal] 已初始化，请勿重复调用"),s._instance;s._level=null!==(n=null==l?void 0:l.level)&&void 0!==n?n:"debug",s._logger=new t({name:o,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!==(r=null==l?void 0:l.loggers)&&void 0!==r?r:[])L(e.name,null!==(_=e.level)&&void 0!==_?_:"debug");return s._instance={Acquire:d,Create:L,Remove:E,Clear:h,All:w,GetLevel:i,SetLevel:u,GetLevelStyle:v,SetLevelStyle:b,Debug:g,Info:c,Warn:a,Error:f},s._instance},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},n={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",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,n,...o){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(n)}`,s=r[e];t.color?console[s](`%c${t.label}%c ${i}`,`color:${t.color};font-weight:bold;`,"color:inherit;font-weight:inherit;",...o):console[s](`${t.label} ${i}`,...o)}}const i={_initialized:!1,_level:"disable",_logger:null,_styles:Object.assign({},n),_loggers:new Map};function s(l){var n,r,s;if(i._initialized)return void console.warn("[Journal] 已初始化，请勿重复调用");i._initialized=!0,i._level=null!==(n=null==l?void 0:l.level)&&void 0!==n?n:"debug",i._logger=new t({name:o,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:[])w(e.name,null!==(s=e.level)&&void 0!==s?s:"debug");return{Acquire:h,Create:w,Remove:y,Clear:m,All:$,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,...n){i._logger.log(e,l,...n)}function d(e){return i._styles[e]}function _(e,l){i._styles[e]=Object.assign(Object.assign({},i._styles[e]),l)}function w(e,l="debug"){const n=i._loggers.get(e);if(n)return n.level=l,n;const o=new t({name:e,level:l});return i._loggers.set(e,o),o}function h(e){var l;return null!==(l=i._loggers.get(e))&&void 0!==l?l:w(e,i._level)}function y(e){return i._loggers.delete(e)}function m(){i._loggers.clear()}function $(){return[...i._loggers.values()]}export{n as JOURNAL_DEFAULT_LEVEL_STYLES,o as JOURNAL_DEFAULT_LOGGER_NAME,e as JOURNAL_LEVELS,l as JOURNAL_LEVEL_WEIGHTS,s as JournalInit,t as JournalLogger};
+const e=["debug","info","warn","error","disable"],l={debug:0,info:1,warn:2,error:3,disable:4},n={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",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,n,...o){if("disable"===e)return;if(l[this.Level]<l[u()])return;if(l[e]<l[this.Level])return;const t=_(e),i=`[${this.Name}] ${String(n)}`,s=r[e];t.color?console[s](`%c${t.label}%c ${i}`,`color:${t.color};font-weight:bold;`,"color:inherit;font-weight:inherit;",...o):console[s](`${t.label} ${i}`,...o)}}const i={_instance:null,_level:"disable",_logger:null,_styles:Object.assign({},n),_loggers:new Map};function s(l){var n,r,s;if(i._instance)return console.warn("[Journal] 已初始化，请勿重复调用"),i._instance;i._level=null!==(n=null==l?void 0:l.level)&&void 0!==n?n:"debug",i._logger=new t({name:o,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 i._instance={Acquire:h,Create:L,Remove:w,Clear:y,All:m,GetLevel:u,SetLevel:g,GetLevelStyle:_,SetLevelStyle:d,Debug:c,Info:a,Warn:f,Error:v},i._instance}function u(){return i._level}function g(e){i._level=e,i._logger.Level=e}function c(e,...l){b("debug",e,...l)}function a(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,...n){i._logger.Log(e,l,...n)}function _(e){return i._styles[e]}function d(e,l){i._styles[e]=Object.assign(Object.assign({},i._styles[e]),l)}function L(e,l="debug"){const n=i._loggers.get(e);if(n)return n.Level=l,n;const o=new t({name:e,level:l});return i._loggers.set(e,o),o}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{n as JOURNAL_DEFAULT_LEVEL_STYLES,o 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[GetLevel()]) {
+        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 = GetLevelStyle(level);
-        const text = `[${this.name}] ${String(message)}`;
+        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,10 +93,10 @@ class JournalLogger {
     }
 }
 /**
- * 日志记录器环境
+ * 日志记录器上下文
  */
-const JournalEnv = {
-    _initialized: false,
+const JournalContext = {
+    _instance: null,
     _level: 'disable',
     _logger: null,
     _styles: Object.assign({}, JOURNAL_DEFAULT_LEVEL_STYLES),
@@ -108,34 +108,28 @@ const JournalEnv = {
  */
 function JournalInit(options) {
     var _a, _b, _c;
-    if (JournalEnv._initialized) {
+    if (JournalContext._instance) {
         console.warn('[Journal] 已初始化，请勿重复调用');
-        return;
+        return JournalContext._instance;
     }
-    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({
+    JournalContext._level = (_a = options === null || options === void 0 ? void 0 : options.level) !== null && _a !== void 0 ? _a : 'debug';
+    JournalContext._logger = new JournalLogger({
         name: JOURNAL_DEFAULT_LOGGER_NAME,
-        level: JournalEnv._level,
+        level: JournalContext._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);
+                JournalContext._styles[level] = Object.assign(Object.assign({}, JournalContext._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');
     }
-    /**
-     * 日志管理器
-     *
-     * 内置一个默认记录器，用于便捷记录，不占用记录器表，分级随管理器动态调整。
-     */
-    return {
+    JournalContext._instance = {
         Acquire,
         Create,
         Remove,
@@ -150,15 +144,16 @@ function JournalInit(options) {
         Warn,
         Error,
     };
+    return JournalContext._instance;
 }
 /** 获取管理器分级 */
 function GetLevel() {
-    return JournalEnv._level;
+    return JournalContext._level;
 }
 /** 设置管理器分级 */
 function SetLevel(level) {
-    JournalEnv._level = level;
-    JournalEnv._logger.level = level;
+    JournalContext._level = level;
+    JournalContext._logger.Level = level;
 }
 /** 输出 debug 级别记录（默认记录器） */
 function Debug(message, ...args) {
@@ -183,15 +178,15 @@ function Error(message, ...args) {
  * @param args     附加内容，透传给 console
  */
 function Log(level, message, ...args) {
-    JournalEnv._logger.log(level, message, ...args);
+    JournalContext._logger.Log(level, message, ...args);
 }
 /** 获取分级样式 */
 function GetLevelStyle(level) {
-    return JournalEnv._styles[level];
+    return JournalContext._styles[level];
 }
 /** 更新分级样式，仅覆盖传入字段 */
 function SetLevelStyle(level, style) {
-    JournalEnv._styles[level] = Object.assign(Object.assign({}, JournalEnv._styles[level]), style);
+    JournalContext._styles[level] = Object.assign(Object.assign({}, JournalContext._styles[level]), style);
 }
 /**
  * 创建记录器；同名记录器已存在时更新其分级并返回原实例
@@ -199,31 +194,31 @@ function SetLevelStyle(level, style) {
  * @param level  记录器分级，默认为 debug
  */
 function Create(name, level = 'debug') {
-    const existing = JournalEnv._loggers.get(name);
+    const existing = JournalContext._loggers.get(name);
     if (existing) {
-        existing.level = level;
+        existing.Level = level;
         return existing;
     }
     const logger = new JournalLogger({ name, level });
-    JournalEnv._loggers.set(name, logger);
+    JournalContext._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);
+    return (_a = JournalContext._loggers.get(name)) !== null && _a !== void 0 ? _a : Create(name, JournalContext._level);
 }
 /** 移除记录器，返回是否移除成功 */
 function Remove(name) {
-    return JournalEnv._loggers.delete(name);
+    return JournalContext._loggers.delete(name);
 }
 /** 清空全部记录器，不影响默认记录器 */
 function Clear() {
-    JournalEnv._loggers.clear();
+    JournalContext._loggers.clear();
 }
 /** 获取全部记录器，不包含默认记录器 */
 function All() {
-    return [...JournalEnv._loggers.values()];
+    return [...JournalContext._loggers.values()];
 }
 
 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.1.0",
+  "version": "1.1.2",
   "description": "日志记录扩展包",
   "author": "doooreyn",
   "license": "MIT",

package/package.json

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