@nebulaaa/journal 0.0.0-stage → 1.0.1

package/dist/journal.cjs

@@ -0,0 +1,256 @@
+'use strict';
+
+/*****************************************************************************
+  Author: DoooReyn
+  Feature: journal
+  Descriptions: 日志常量与默认配置
+ *****************************************************************************/
+/** 全部分级，按权重由低到高排列 */
+const JOURNAL_LEVELS = ['debug', 'info', 'warn', 'error', 'disable'];
+/** 分级权重表：数值越大，输出门槛越高 */
+const JOURNAL_LEVEL_WEIGHTS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    disable: 4,
+};
+/** 默认分级样式 */
+const JOURNAL_DEFAULT_LEVEL_STYLES = {
+    debug: { label: '[Debug]', color: '#8C8C8C' },
+    info: { label: '[Info]', color: '#0986FF' },
+    warn: { label: '[Warn]', color: '#E6A23C' },
+    error: { label: '[Error]', color: '#D93026' },
+    disable: { label: '[Disable]', color: '' },
+};
+/** 默认记录器名称 */
+const JOURNAL_DEFAULT_LOGGER_NAME = 'journal';
+
+/*****************************************************************************
+  Author: DoooReyn
+  Feature: journal
+  Descriptions: 日志管理器与记录器
+ *****************************************************************************/
+/** 各分级对应的控制台输出方法（debug 走 log，兼容性更好） */
+const CONSOLE_METHODS = {
+    debug: 'log',
+    info: 'info',
+    warn: 'warn',
+    error: 'error',
+};
+/**
+ * 日志记录器
+ *
+ * 由 Journal 创建，持有独立分级；输出记录时受双重限制：
+ * 1. 记录器分级低于所属管理器分级时，该记录器整体视为忽略；
+ * 2. 记录分级低于记录器分级时，该条记录视为忽略。
+ */
+class JournalLogger {
+    constructor(options) {
+        var _a;
+        this.name = options.name;
+        this.level = (_a = options.level) !== null && _a !== void 0 ? _a : 'debug';
+    }
+    /** 输出 debug 级别记录 */
+    debug(message, ...args) {
+        this.log('debug', message, ...args);
+    }
+    /** 输出 info 级别记录 */
+    info(message, ...args) {
+        this.log('info', message, ...args);
+    }
+    /** 输出 warn 级别记录 */
+    warn(message, ...args) {
+        this.log('warn', message, ...args);
+    }
+    /** 输出 error 级别记录 */
+    error(message, ...args) {
+        this.log('error', message, ...args);
+    }
+    /**
+     * 输出一条记录，分级规则见类说明
+     * @param level    记录分级
+     * @param message  记录内容
+     * @param args     附加内容，透传给 console
+     */
+    log(level, message, ...args) {
+        if (level === 'disable') {
+            return;
+        }
+        if (JOURNAL_LEVEL_WEIGHTS[this.level] < JOURNAL_LEVEL_WEIGHTS[Journal.Level]) {
+            return;
+        }
+        if (JOURNAL_LEVEL_WEIGHTS[level] < JOURNAL_LEVEL_WEIGHTS[this.level]) {
+            return;
+        }
+        const style = Journal.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);
+        }
+        else {
+            console[method](`${style.label} ${text}`, ...args);
+        }
+    }
+}
+/**
+ * 日志管理器（静态类）
+ *
+ * 通过 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);
+                }
+            }
+        }
+        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);
+    }
+    /**
+     * 创建记录器；同名记录器已存在时更新其分级并返回原实例
+     * @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;
+    }
+}
+/** 是否已初始化 */
+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.JournalLogger = JournalLogger;

package/dist/journal.d.ts

@@ -0,0 +1,155 @@
+/*****************************************************************************
+  Author: DoooReyn
+  Feature: journal
+  Descriptions: 日志类型定义
+ *****************************************************************************/
+/** 日志分级，权重由低到高，disable 表示不输出任何日志 */
+type JournalLevel = 'debug' | 'info' | 'warn' | 'error' | 'disable';
+/** 可用于输出记录的分级（不含 disable） */
+type JournalPrintLevel = Exclude<JournalLevel, 'disable'>;
+/** 分级样式：标记与颜色 */
+interface JournalLevelStyle {
+    /** 分级标记，输出于日志头部，如 "[Debug]" */
+    label: string;
+    /** 分级颜色，支持任意 CSS 颜色值；留空表示不着色 */
+    color: string;
+}
+/** 记录器配置 */
+interface JournalLoggerOptions {
+    /** 记录器名称，需非空且在所属管理器内唯一 */
+    name: string;
+    /** 记录器分级，默认为 debug */
+    level?: JournalLevel;
+}
+/** 日志管理器配置 */
+interface JournalManagerOptions {
+    /** 管理器分级，默认为 debug */
+    level?: JournalLevel;
+    /** 分级样式配置，覆盖对应分级的默认标记与颜色 */
+    levels?: {
+        [L in JournalLevel]?: Partial<JournalLevelStyle>;
+    };
+    /** 初始记录器配置列表 */
+    loggers?: JournalLoggerOptions[];
+}
+
+/*****************************************************************************
+  Author: DoooReyn
+  Feature: journal
+  Descriptions: 日志常量与默认配置
+ *****************************************************************************/
+
+/** 全部分级，按权重由低到高排列 */
+declare const JOURNAL_LEVELS: readonly ["debug", "info", "warn", "error", "disable"];
+/** 分级权重表：数值越大，输出门槛越高 */
+declare const JOURNAL_LEVEL_WEIGHTS: Record<JournalLevel, number>;
+/** 默认分级样式 */
+declare const JOURNAL_DEFAULT_LEVEL_STYLES: Record<JournalLevel, JournalLevelStyle>;
+/** 默认记录器名称 */
+declare const JOURNAL_DEFAULT_LOGGER_NAME = "journal";
+
+/*****************************************************************************
+  Author: DoooReyn
+  Feature: journal
+  Descriptions: 日志管理器与记录器
+ *****************************************************************************/
+
+/**
+ * 日志记录器
+ *
+ * 由 Journal 创建，持有独立分级；输出记录时受双重限制：
+ * 1. 记录器分级低于所属管理器分级时，该记录器整体视为忽略；
+ * 2. 记录分级低于记录器分级时，该条记录视为忽略。
+ */
+declare class JournalLogger {
+    /** 记录器名称 */
+    readonly name: string;
+    /** 记录器分级 */
+    level: JournalLevel;
+    constructor(options: JournalLoggerOptions);
+    /** 输出 debug 级别记录 */
+    debug(message: unknown, ...args: unknown[]): void;
+    /** 输出 info 级别记录 */
+    info(message: unknown, ...args: unknown[]): void;
+    /** 输出 warn 级别记录 */
+    warn(message: unknown, ...args: unknown[]): void;
+    /** 输出 error 级别记录 */
+    error(message: unknown, ...args: unknown[]): void;
+    /**
+     * 输出一条记录，分级规则见类说明
+     * @param level    记录分级
+     * @param message  记录内容
+     * @param args     附加内容，透传给 console
+     */
+    log(level: JournalLevel, message: unknown, ...args: unknown[]): void;
+}
+/**
+ * 日志管理器（静态类）
+ *
+ * 通过 Journal.init(options) 初始化，必须初始化后才能使用：
+ * 未初始化时管理器分级为 disable，任何记录都不会输出，
+ * 且管理操作会被警告并忽略；使用 Journal.reset() 可恢复未初始化状态。
+ * 内置一个默认记录器，用于便捷记录，不占用记录器表，分级随管理器动态调整。
+ */
+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;
+}
+
+export { JOURNAL_DEFAULT_LEVEL_STYLES, JOURNAL_DEFAULT_LOGGER_NAME, JOURNAL_LEVELS, JOURNAL_LEVEL_WEIGHTS, Journal, JournalLogger };
+export type { JournalLevel, JournalLevelStyle, JournalLoggerOptions, JournalManagerOptions, JournalPrintLevel };

package/dist/journal.min.cjs

@@ -0,0 +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;

package/dist/journal.min.mjs

@@ -0,0 +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};

package/dist/journal.mjs

@@ -0,0 +1,249 @@
+/*****************************************************************************
+  Author: DoooReyn
+  Feature: journal
+  Descriptions: 日志常量与默认配置
+ *****************************************************************************/
+/** 全部分级，按权重由低到高排列 */
+const JOURNAL_LEVELS = ['debug', 'info', 'warn', 'error', 'disable'];
+/** 分级权重表：数值越大，输出门槛越高 */
+const JOURNAL_LEVEL_WEIGHTS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    disable: 4,
+};
+/** 默认分级样式 */
+const JOURNAL_DEFAULT_LEVEL_STYLES = {
+    debug: { label: '[Debug]', color: '#8C8C8C' },
+    info: { label: '[Info]', color: '#0986FF' },
+    warn: { label: '[Warn]', color: '#E6A23C' },
+    error: { label: '[Error]', color: '#D93026' },
+    disable: { label: '[Disable]', color: '' },
+};
+/** 默认记录器名称 */
+const JOURNAL_DEFAULT_LOGGER_NAME = 'journal';
+
+/*****************************************************************************
+  Author: DoooReyn
+  Feature: journal
+  Descriptions: 日志管理器与记录器
+ *****************************************************************************/
+/** 各分级对应的控制台输出方法（debug 走 log，兼容性更好） */
+const CONSOLE_METHODS = {
+    debug: 'log',
+    info: 'info',
+    warn: 'warn',
+    error: 'error',
+};
+/**
+ * 日志记录器
+ *
+ * 由 Journal 创建，持有独立分级；输出记录时受双重限制：
+ * 1. 记录器分级低于所属管理器分级时，该记录器整体视为忽略；
+ * 2. 记录分级低于记录器分级时，该条记录视为忽略。
+ */
+class JournalLogger {
+    constructor(options) {
+        var _a;
+        this.name = options.name;
+        this.level = (_a = options.level) !== null && _a !== void 0 ? _a : 'debug';
+    }
+    /** 输出 debug 级别记录 */
+    debug(message, ...args) {
+        this.log('debug', message, ...args);
+    }
+    /** 输出 info 级别记录 */
+    info(message, ...args) {
+        this.log('info', message, ...args);
+    }
+    /** 输出 warn 级别记录 */
+    warn(message, ...args) {
+        this.log('warn', message, ...args);
+    }
+    /** 输出 error 级别记录 */
+    error(message, ...args) {
+        this.log('error', message, ...args);
+    }
+    /**
+     * 输出一条记录，分级规则见类说明
+     * @param level    记录分级
+     * @param message  记录内容
+     * @param args     附加内容，透传给 console
+     */
+    log(level, message, ...args) {
+        if (level === 'disable') {
+            return;
+        }
+        if (JOURNAL_LEVEL_WEIGHTS[this.level] < JOURNAL_LEVEL_WEIGHTS[Journal.Level]) {
+            return;
+        }
+        if (JOURNAL_LEVEL_WEIGHTS[level] < JOURNAL_LEVEL_WEIGHTS[this.level]) {
+            return;
+        }
+        const style = Journal.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);
+        }
+        else {
+            console[method](`${style.label} ${text}`, ...args);
+        }
+    }
+}
+/**
+ * 日志管理器（静态类）
+ *
+ * 通过 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);
+                }
+            }
+        }
+        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);
+    }
+    /**
+     * 创建记录器；同名记录器已存在时更新其分级并返回原实例
+     * @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;
+    }
+}
+/** 是否已初始化 */
+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 };

package/dist/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@nebulaaa/journal",
+  "version": "1.0.1",
+  "description": "日志记录扩展包",
+  "author": "doooreyn",
+  "license": "MIT",
+  "keywords": [
+    "journal",
+    "nebulaaa"
+  ],
+  "engines": {
+    "node": ">=16.0.0",
+    "npm": ">=10.0.0"
+  },
+  "main": "./journal.cjs",
+  "module": "./journal.mjs",
+  "types": "./journal.d.ts",
+  "exports": {
+    ".": {
+      "types": "./journal.d.ts",
+      "require": "./journal.cjs",
+      "import": "./journal.mjs",
+      "default": "./journal.cjs"
+    },
+    "./min": {
+      "require": "./journal.min.cjs",
+      "import": "./journal.min.mjs"
+    }
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  }
+}

package/package.json

@@ -1,6 +1,66 @@
-{
-  "name": "@nebulaaa/journal",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+  "name": "@nebulaaa/journal",
+  "version": "1.0.1",
+  "description": "日志记录扩展包",
+  "main": "./dist/journal.cjs",
+  "module": "./dist/journal.mjs",
+  "types": "./dist/journal.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/journal.cjs",
+      "import": "./dist/journal.mjs",
+      "types": "./dist/journal.d.ts",
+      "default": "./dist/journal.cjs"
+    },
+    "./min": {
+      "require": "./dist/journal.min.cjs",
+      "import": "./dist/journal.min.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "npm run clean && rollup -c rollup.config.mjs && node ../scripts/write-dist-package.mjs journal",
+    "test": "jest --config jest.config.mjs"
+  },
+  "keywords": [
+    "journal",
+    "nebulaaa"
+  ],
+  "author": "doooreyn",
+  "license": "MIT",
+  "devEngines": {
+    "packageManager": {
+      "name": "npm",
+      "version": ">=10.0.0",
+      "onFail": "warn"
+    }
+  },
+  "engines": {
+    "node": ">=16.0.0",
+    "npm": ">=10.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "allowScripts": {
+    "unrs-resolver@1.12.2": true,
+    "@parcel/watcher@2.6.0": true
+  },
+  "devDependencies": {
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.1.2",
+    "@types/node": "^22.10.2",
+    "@types/jest": "^30.0.0",
+    "ts-jest": "^29.4.12",
+    "jest": "^30.5.2",
+    "rollup": "^4.28.1",
+    "rollup-plugin-dts": "^6.1.1",
+    "ts-node": "^10.9.2",
+    "typescript": "5.7.3"
+  },
+  "dependencies": {}
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.