@idlebox/logger 0.0.22 → 0.0.24

package/lib/outputs/nodejs.d.ts

@@ -0,0 +1,26 @@
+import { Terminal } from '@idlebox/terminal-control';
+import type { IInstrestedConsole } from '../common/types.js';
+interface IOptions {
+    readonly stream: NodeJS.WritableStream;
+    readonly colorEnabled?: boolean;
+}
+export declare class NodejsOutput implements IInstrestedConsole {
+    static defaultInstance(): IInstrestedConsole;
+    readonly colorEnabled: boolean;
+    readonly stream: NodeJS.WritableStream;
+    readonly terminal: Terminal;
+    constructor({ stream, colorEnabled }: IOptions);
+    clear(): void;
+    group(message: string): void;
+    groupCollapsed(message: string): void;
+    groupEnd(): void;
+    readonly error: (message: string) => void;
+    readonly warn: (message: string) => void;
+    readonly info: (message: string) => void;
+    readonly log: (message: string) => void;
+    readonly debug: (message: string) => void;
+    readonly trace: (message: string) => void;
+    private _writeLine;
+}
+export {};
+//# sourceMappingURL=nodejs.d.ts.map

package/lib/outputs/nodejs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodejs.d.ts","sourceRoot":"","sources":["../../src/outputs/nodejs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAuC7D,UAAU,QAAQ;IACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CAChC;AAGD,qBAAa,YAAa,YAAW,kBAAkB;IACtD,MAAM,CAAC,eAAe,IAAI,kBAAkB;IAW5C,SAAgB,YAAY,UAAC;IAC7B,SAAgB,MAAM,wBAAC;IACvB,SAAgB,QAAQ,WAAC;gBACb,EAAE,MAAM,EAAE,YAAoB,EAAE,EAAE,QAAQ;IAatD,KAAK,IAAI,IAAI;IAIb,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIrC,QAAQ,IAAI,IAAI;IAIhB,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAE1C,OAAO,CAAC,UAAU;CAGlB"}

package/lib/outputs/nodejs.js

@@ -0,0 +1,82 @@
+import { Terminal } from '@idlebox/terminal-control';
+import { applyControllerByEnvironment } from './node-controllers/index.js';
+function environmentColorEnabled(stream) {
+    // biome-ignore lint/performance/useTopLevelRegex: one time use
+    const colorArgReg = /^--color=|^--color$|^-[^-]+c/;
+    const colorArg = process.argv.find((e) => colorArgReg.test(e));
+    const noColorArg = process.argv.includes('--no-color');
+    // 命令行顶级优先
+    if (noColorArg)
+        return false;
+    if (colorArg)
+        return true;
+    // 环境变量
+    if (process.env.NO_COLOR || process.env.NODE_DISABLE_COLORS === '1') {
+        /**
+         * https://force-color.org/
+         * https://nodejs.org/docs/latest/api/cli.html#node_disable_colors1
+         */
+        return false;
+    }
+    else if (process.env.FORCE_COLOR) {
+        return true;
+    }
+    // 目标输出是TTY
+    if (stream.isTTY) {
+        return true;
+    }
+    if (process.env.GITHUB_ACTIONS) {
+        return true;
+    }
+    // TODO 检测其他可能
+    return false;
+}
+let instance;
+export class NodejsOutput {
+    static defaultInstance() {
+        if (!instance) {
+            instance = new NodejsOutput({
+                stream: process.stderr,
+                colorEnabled: environmentColorEnabled(process.stderr),
+            });
+            applyControllerByEnvironment(instance);
+        }
+        return instance;
+    }
+    colorEnabled;
+    stream;
+    terminal;
+    constructor({ stream, colorEnabled = false }) {
+        this.colorEnabled = colorEnabled;
+        this.stream = stream;
+        this.terminal = new Terminal(this.stream);
+        this.error = this._writeLine.bind(this);
+        this.warn = this._writeLine.bind(this);
+        this.info = this._writeLine.bind(this);
+        this.log = this._writeLine.bind(this);
+        this.debug = this._writeLine.bind(this);
+        this.trace = this._writeLine.bind(this);
+    }
+    clear() {
+        this.terminal.resetIf(this.colorEnabled);
+    }
+    group(message) {
+        this.stream.write(`[${message}] START\n`);
+    }
+    groupCollapsed(message) {
+        this.stream.write(`[${message}] START (collapsed)\n`);
+    }
+    groupEnd() {
+        this.stream.write(`[GROUP] END\n`);
+    }
+    error;
+    warn;
+    info;
+    log;
+    debug;
+    trace;
+    _writeLine(message) {
+        this.stream.write(`${message}\n`);
+    }
+}
+//# sourceMappingURL=nodejs.js.map

package/lib/outputs/nodejs.js.map

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

package/lib/printers/file.d.ts

@@ -1,2 +1,3 @@
-export declare function createLogFile(filePath: string): NodeJS.WritableStream;
+import { NodejsOutput } from '../outputs/nodejs.js';
+export declare function createLogFile(filePath: string): NodejsOutput;
 //# sourceMappingURL=file.d.ts.map

package/lib/printers/file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/printers/file.ts"],"names":[],"mappings":"AAIA,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,CAiBrE"}
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/printers/file.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAiB5D"}

package/lib/printers/file.js

@@ -1,6 +1,7 @@
 import { createWriteStream } from 'node:fs';
 import { resolve } from 'node:path';
 import { Transform } from 'node:stream';
+import { NodejsOutput } from '../outputs/nodejs.js';
 export function createLogFile(filePath) {
     const file = resolve(process.cwd(), filePath);
     console.log(`Creating log file: ${file}`);
@@ -16,7 +17,7 @@ export function createLogFile(filePath) {
     });
     const filter = new ColorRemoveStream();
     filter.pipe(target, { end: true });
-    return filter;
+    return new NodejsOutput({ stream: filter, colorEnabled: false });
 }
 class ColorRemoveStream extends Transform {
     _transform(chunk, _encoding, callback) {

package/lib/printers/file.js.map

@@ -1 +1 @@
-{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/printers/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAA0B,MAAM,aAAa,CAAC;AAEhE,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5F,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QAC1B,OAAO,CAAC,KAAK,CAAC,6BAA6B,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE;QACxB,OAAO,CAAC,KAAK,CAAC,YAAY,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACvB,OAAO,CAAC,KAAK,CAAC,YAAY,IAAI,SAAS,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACvC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAEnC,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,iBAAkB,SAAQ,SAAS;IAC/B,UAAU,CAAC,KAAa,EAAE,SAAiB,EAAE,QAA2B;QAChF,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;QAChE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzB,CAAC;CACD"}
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/printers/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAA0B,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5F,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QAC1B,OAAO,CAAC,KAAK,CAAC,6BAA6B,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE;QACxB,OAAO,CAAC,KAAK,CAAC,YAAY,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACvB,OAAO,CAAC,KAAK,CAAC,YAAY,IAAI,SAAS,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACvC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAEnC,OAAO,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,iBAAkB,SAAQ,SAAS;IAC/B,UAAU,CAAC,KAAa,EAAE,SAAiB,EAAE,QAA2B;QAChF,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;QAChE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzB,CAAC;CACD"}

package/package.json

@@ -1,25 +1,31 @@
 {
   "name": "@idlebox/logger",
   "type": "module",
-  "version": "0.0.22",
+  "version": "0.0.24",
   "description": "A simple logger module for my self use (nodejs).",
   "exports": {
     ".": {
-      "source": "./src/index.ts",
-      "default": "./lib/index.js"
+      "source": "./src/environments/node.ts",
+      "browser": "./lib/environments/browser.js",
+      "node": "./lib/environments/node.js",
+      "default": "./lib/environments/browser.js"
     },
+    "./node": "./lib/environments/node.js",
+    "./browser": "./lib/environments/browser.js",
     "./package.json": "./package.json"
   },
   "sideEffects": false,
   "dependencies": {
     "debug": "^4.4.3",
-    "@idlebox/common": "^1.5.17"
+    "@idlebox/common": "^1.5.22",
+    "@idlebox/terminal-control": "^0.0.4"
   },
   "devDependencies": {
     "@types/debug": "^4.1.13",
     "@types/node": "^25.5.0",
-    "@build-script/baseline-rig": "latest",
-    "@mpis/run": "^0.0.22"
+    "mocha": "^11.7.5",
+    "@mpis/run": "^0.0.26",
+    "@build-script/baseline-rig": "latest"
   },
   "license": "MIT",
   "author": "GongT <admin@gongt.me>",
@@ -28,7 +34,7 @@
     "url": "git+https://github.com/GongT/baobao.git",
     "directory": "@idlebox/logger"
   },
-  "main": "./lib/index.js",
+  "main": "./lib/environments/browser.js",
   "scripts": {
     "build": "mpis-run build",
     "watch": "mpis-run watch",

package/src/common/ansi.ts

@@ -1,4 +1,4 @@
-export const CSI = '\x1b[';
+import { CSI } from '@idlebox/terminal-control/constants';
 
 export const Crst = `${CSI}0m`;
 
@@ -17,3 +17,8 @@ export const CFgreen = `${CSI}38;5;10m`;
 export const CFyellow = `${CSI}38;5;11m`;
 export const CFblue = `${CSI}38;5;14m`;
 export const CFred = `${CSI}38;5;9m`;
+
+/**
+ * @deprecated
+ */
+export { CSI };

package/src/common/create.compability.ts

@@ -0,0 +1,7 @@
+import type { IAbstractConsole, IMyLogger } from './types.js';
+
+type IBondOptions = {};
+
+export function consoleCompatibleInternal(_options: IBondOptions, _input: IMyLogger): IAbstractConsole {
+	return undefined as any;
+}

package/src/common/create.function.ts

@@ -1,55 +1,86 @@
 import { defineInspectMethod } from '@idlebox/common';
-import type { InspectContext } from 'node:util';
+import { call_debug_command, debug_commands, nodeFormat } from '../functions/builtin-commands.js';
 import { Cdim, Crst, CSI, NCdim } from './ansi.js';
 import { LogLevel, logLevelPaddingStr, logTagColor } from './colors.js';
-import { call_debug_command, debug_commands, nodeFormat } from './debug.commands.js';
 import { current_error_action, escapeRegExp } from './helpers.js';
-import type { IMyDebug, IMyDebugWithControl } from './types.js';
+import type { ILineWriter, IMyDebug, IMyDebugWithControl, InspectContext } from './types.js';
 
 interface IDebugOptions {
 	tag: string;
 	level: LogLevel;
-	color_enabled: boolean;
-	color_entire_line?: boolean;
-	stream?: NodeJS.WritableStream;
+	colorEnabled: boolean;
+	colorWholeLine?: boolean;
+	writer: ILineWriter;
 	enabled?: boolean;
 }
-export function createDebug({ tag, level, color_enabled, color_entire_line = false, stream = process.stdout, enabled = true }: IDebugOptions): IMyDebugWithControl {
+
+/**
+ * 创建一个debug函数
+ * 在浏览器中必须指定stream
+ */
+export function createDebug({ tag, level, colorEnabled, colorWholeLine = false, writer, enabled = true }: IDebugOptions): IMyDebugWithControl {
 	const color = logTagColor[level];
 	const lineOpt = {
 		tag: tag ? tag : `${LogLevel[level][0].toUpperCase()}`,
-		stream,
+		writer,
 		color,
 		level,
 	};
 
 	let write_line: IMyDebug;
-	if (!color_enabled) {
+	if (!colorEnabled) {
 		write_line = write_line_monolithic({
 			...lineOpt,
 			tag: tag ? tag : `$$`,
 		});
-	} else if (color_entire_line) {
+	} else if (colorWholeLine) {
 		write_line = write_line_colored_line(lineOpt);
 	} else {
 		write_line = write_line_colored_tag(lineOpt);
 	}
 
-	const r = Object.assign(
+	// assert.equal(typeof writer, 'function', 'writer must be a function');
+
+	const r = Object.defineProperties(
 		(m: any, ...args: unknown[]) => {
-			if (!r.isEnabled) return;
+			if (!enabled) return;
 			write_line(m, ...args);
 		},
 		{
-			enable: () => {
-				r.isEnabled = true;
+			displayName: {
+				get() {
+					return `writeLine:${LogLevel[level]}|${enabled ? 'enabled' : 'disabled'}`;
+				},
+				configurable: false,
+			},
+			enable: {
+				value: function enable() {
+					enabled = true;
+				},
+				configurable: false,
+				writable: false,
+			},
+			disable: {
+				value: function disable() {
+					enabled = false;
+				},
+				configurable: false,
+				writable: false,
+			},
+			isEnabled: {
+				get() {
+					return enabled;
+				},
+				configurable: false,
 			},
-			disable: () => {
-				r.isEnabled = false;
+			writeLine: {
+				value: writer,
+				enumerable: false,
+				configurable: false,
+				writable: false,
 			},
-			isEnabled: enabled,
 		},
-	);
+	) as IMyDebugWithControl;
 
 	return defineInspectMethod(r, (_depth: number, context: InspectContext) => {
 		return `[${context.stylize('Debug', 'special')} "${context.stylize(tag, 'string')}" ${context.stylize(LogLevel[level], 'undefined')} ${context.stylize(r.isEnabled ? 'enabled' : 'disabled', 'boolean')}]`;
@@ -58,7 +89,7 @@ export function createDebug({ tag, level, color_enabled, color_entire_line = fal
 
 interface IWriteLineOptions {
 	tag: string;
-	stream: NodeJS.WritableStream;
+	writer: ILineWriter;
 	color: string;
 	level: LogLevel;
 }
@@ -118,7 +149,7 @@ function format_template(messages: TemplateStringsArray, args: unknown[], color:
 /**
  * TAG带颜色
  */
-function write_line_colored_tag({ tag, stream, color }: IWriteLineOptions) {
+function write_line_colored_tag({ tag, writer, color }: IWriteLineOptions) {
 	return (messages: TemplateStringsArray | string, ...args: unknown[]) => {
 		const head = `[${CSI}${color}m${tag}${Crst}]`;
 		let body: string;
@@ -128,14 +159,14 @@ function write_line_colored_tag({ tag, stream, color }: IWriteLineOptions) {
 			body = format_template(messages, args, true);
 		}
 
-		write(stream, head, body);
+		write(writer, head, body);
 	};
 }
 
 /**
  * 整行带颜色
  */
-function write_line_colored_line({ tag, stream, color }: IWriteLineOptions) {
+function write_line_colored_line({ tag, writer, color }: IWriteLineOptions) {
 	return (messages: TemplateStringsArray | string, ...args: unknown[]) => {
 		const head = `${CSI}${color}m[${tag}]`;
 		let body: string;
@@ -146,14 +177,14 @@ function write_line_colored_line({ tag, stream, color }: IWriteLineOptions) {
 		}
 		body += Crst;
 
-		write(stream, head, body);
+		write(writer, head, body);
 	};
 }
 
 /**
  * 不带颜色
  */
-function write_line_monolithic({ tag, level, stream }: IWriteLineOptions) {
+function write_line_monolithic({ tag, level, writer }: IWriteLineOptions) {
 	const lvlStr = logLevelPaddingStr[level];
 	const head = `[${tag}/${lvlStr}]`;
 
@@ -166,14 +197,14 @@ function write_line_monolithic({ tag, level, stream }: IWriteLineOptions) {
 			body = format_template(messages, args, false);
 		}
 
-		write(stream, head, body);
+		write(writer, head, body);
 	};
 }
 
-function write(stream: NodeJS.WritableStream, head: string, body: string) {
+function write(writer: ILineWriter, head: string, body: string) {
 	if (body[0] === '[') {
-		stream.write(`${head}${body}\n`);
+		writer(`${head}${body}`);
 	} else {
-		stream.write(`${head} ${body}\n`);
+		writer(`${head} ${body}`);
 	}
 }

package/src/common/create.logger.ts

@@ -1,28 +1,28 @@
 import { defineInspectMethod, SoftwareDefectError } from '@idlebox/common';
 import type { InspectContext } from 'node:util';
+import { EnableLogLevel } from '../loglevels/loglevel.js';
 import { LogLevel } from './colors.js';
 import { createDebug } from './create.function.js';
-import { defaultLogLevel, detectColorEnable } from './helpers.js';
-import { EnableLogLevel, type IMyDebugWithControl, type IMyLogger } from './types.js';
+import { defaultLogLevel } from './helpers.js';
+import { loggersRegistry, loggersRegistrySet } from './registry.js';
+import type { IInstrestedConsole, IMyDebugWithControl, IMyLogger } from './types.js';
 
-const seen_loggers = new Set<string>();
-export const all_logger_names: ReadonlySet<string> = seen_loggers;
+export function create(console: IInstrestedConsole, tag: string, defaultLevel = EnableLogLevel.auto, color_enabled: boolean = true): IMyLogger {
+	const exists = loggersRegistry?.get(tag);
+	if (exists) return exists;
 
-export function create(tag: string, color_enabled: undefined | boolean, stream: NodeJS.ReadWriteStream, defaultLevel = EnableLogLevel.auto): IMyLogger {
+	const colorEnabled = color_enabled && console.colorEnabled;
 	let currentLevel = defaultLevel;
-	seen_loggers.add(tag);
 
-	if (color_enabled === undefined) color_enabled = detectColorEnable(stream);
+	const log_fatal = createDebug({ tag, colorEnabled, level: LogLevel.fatal, writer: console.error, colorWholeLine: true });
 
-	const log_fatal = createDebug({ tag, color_enabled, level: LogLevel.fatal, stream, color_entire_line: true });
-
-	const error = createDebug({ tag, color_enabled, level: LogLevel.error, stream });
-	const success = createDebug({ tag, color_enabled, level: LogLevel.success, stream });
-	const warn = createDebug({ tag, color_enabled, level: LogLevel.warn, stream });
-	const info = createDebug({ tag, color_enabled, level: LogLevel.info, stream });
-	const log = createDebug({ tag, color_enabled, level: LogLevel.log, stream });
-	const debug = createDebug({ tag, color_enabled, level: LogLevel.debug, stream, color_entire_line: true });
-	const verbose = createDebug({ tag, color_enabled, level: LogLevel.verbose, stream, color_entire_line: true });
+	const error = createDebug({ tag, colorEnabled, level: LogLevel.error, writer: console.error });
+	const success = createDebug({ tag, colorEnabled, level: LogLevel.success, writer: console.log });
+	const warn = createDebug({ tag, colorEnabled, level: LogLevel.warn, writer: console.warn });
+	const info = createDebug({ tag, colorEnabled, level: LogLevel.info, writer: console.info });
+	const log = createDebug({ tag, colorEnabled, level: LogLevel.log, writer: console.log });
+	const debug = createDebug({ tag, colorEnabled, level: LogLevel.debug, writer: console.debug, colorWholeLine: true });
+	const verbose = createDebug({ tag, colorEnabled, level: LogLevel.verbose, writer: console.debug, colorWholeLine: true });
 
 	syncEnabled({ error, warn, info, log, success, debug, verbose }, tag, currentLevel);
 
@@ -33,7 +33,7 @@ export function create(tag: string, color_enabled: undefined | boolean, stream:
 
 	const result = {
 		tag,
-		stream,
+		console,
 		fatal,
 		error,
 		warn,
@@ -43,7 +43,7 @@ export function create(tag: string, color_enabled: undefined | boolean, stream:
 		debug,
 		verbose,
 
-		colorEnabled: color_enabled,
+		colorEnabled: colorEnabled,
 
 		enable(newLevel: EnableLogLevel) {
 			currentLevel = newLevel;
@@ -52,13 +52,15 @@ export function create(tag: string, color_enabled: undefined | boolean, stream:
 
 		extend: (newTag: string) => {
 			if (tag) {
-				return create(`${tag}:${newTag}`, color_enabled, stream, currentLevel);
+				return create(console, `${tag}:${newTag}`, currentLevel, colorEnabled);
 			} else {
-				return create(newTag, color_enabled, stream, currentLevel);
+				return create(console, newTag, currentLevel, colorEnabled);
 			}
 		},
 	};
 
+	loggersRegistrySet(result);
+
 	return defineInspectMethod(result, (_depth: number, context: InspectContext) => {
 		if (_depth < 0) return `${context.stylize(`[Logger ${tag}]`, 'special')}`;
 		return `${context.stylize('Logger', 'name')} { "${context.stylize(tag, 'string')}" ${context.stylize(EnableLogLevel[currentLevel], 'undefined')} }`;

package/src/common/helpers.ts

@@ -1,9 +1,9 @@
 import { prettyFormatError } from '@idlebox/common';
 import debug from 'debug';
-import process from 'node:process';
-import { debug_commands } from './debug.commands.js';
-import { terminal } from './logger.global.js';
-import { EnableLogLevel, type IDebugCommand } from './types.js';
+import { debug_commands } from '../functions/builtin-commands.js';
+import { EnableLogLevel } from '../loglevels/loglevel.js';
+import { globalLogger } from './logger.global.js';
+import type { IDebugCommand } from './types.js';
 
 /**
  * 判断 字符串是否为“真值”
@@ -24,52 +24,11 @@ export function is_string_truthy(value: string | undefined) {
 	} else if (value === '0' || value === 'false' || value === 'off' || value === 'no' || value === 'disabled') {
 		return false;
 	} else {
-		terminal.warn`invalid boolean string: ${value}, assuming false.`;
+		globalLogger.warn`invalid boolean string: ${value}, assuming false.`;
 		return false;
 	}
 }
 
-interface IWritableStream extends NodeJS.WritableStream {
-	colorEnabled?: boolean;
-	isTTY?: boolean;
-}
-
-function _colorEnabled(stream: IWritableStream): boolean {
-	const colorArg = process.argv.find((e) => e.startsWith('--color=') || e === '--color' || e === '-c');
-	const noColorArg = process.argv.includes('--no-color');
-
-	// 命令行顶级优先
-	if (colorArg) return true;
-	if (noColorArg) return false;
-
-	// 环境变量
-	if (process.env.NO_COLOR || process.env.NODE_DISABLE_COLORS === '1') {
-		/**
-		 * https://force-color.org/
-		 * https://nodejs.org/docs/latest/api/cli.html#node_disable_colors1
-		 */
-		return false;
-	} else if (process.env.FORCE_COLOR) {
-		return true;
-	}
-
-	// 检测其他可能
-	if (stream.isTTY) {
-		return true;
-	}
-
-	// TODO
-
-	return false;
-}
-
-export function detectColorEnable(stream: IWritableStream = process.stderr): boolean {
-	if (stream.colorEnabled === undefined) {
-		stream.colorEnabled = _colorEnabled(stream);
-	}
-	return stream.colorEnabled;
-}
-
 export function escapeRegExp(str: string) {
 	return str.replace(/[-[\]/{}()*+?.\\^$|]/g, '\\$&');
 }

package/src/common/logger.create.ts

@@ -1,31 +1,29 @@
-import process from 'node:process';
-import { PassThrough } from 'node:stream';
+import { EnableLogLevel } from '../loglevels/loglevel.js';
 import { create } from './create.logger.js';
 import { debug_enabled, defaultLogLevel } from './helpers.js';
-import { terminal } from './logger.global.js';
-import { EnableLogLevel, type IMyLogger } from './types.js';
+import { globalLogger } from './logger.global.js';
+import type { IInstrestedConsole, IMyLogger } from './types.js';
+
+export interface ILoggerOptionsReq {
+	readonly colors?: boolean;
+	readonly console: IInstrestedConsole;
+}
 
 /**
  * 创建一个新的logger实例
- * @param color_enabled 默认自动
- * @param pipeTo 默认是 process.stderr
+ * @param tag logger的tag，类似 "app:db:insert"
+ * @param colors 是否启用颜色，默认启用
  * @returns
  */
-export function createLogger(tag: string, color_enabled: boolean | undefined = undefined, pipeTo: undefined | NodeJS.WritableStream = process.stderr): IMyLogger {
-	const stream = new PassThrough();
-	if (pipeTo) {
-		Object.assign(stream, { isTTY: (pipeTo as any).isTTY });
-		stream.pipe(pipeTo);
-	}
-
+export function createLoggerObject(tag: string, { colors = true, console }: ILoggerOptionsReq): IMyLogger {
 	let level = EnableLogLevel.error;
 	if (debug_enabled(tag)) {
 		level = defaultLogLevel;
 	}
 
-	const logger = create(tag, color_enabled, stream, level);
+	const logger = create(console, tag, level, colors);
 
-	(terminal || logger).verbose`logger "${tag}" created, level = ${EnableLogLevel[level]}`;
+	(globalLogger || logger).verbose`logger "${tag}" created, level = ${EnableLogLevel[level]}`;
 
 	return logger;
 }

package/src/common/logger.global.ts

@@ -1,39 +1,34 @@
 import { globalObject } from '@idlebox/common';
-import process from 'node:process';
-import { PassThrough } from 'node:stream';
+import type { EnableLogLevel } from '../loglevels/loglevel.js';
 import { create } from './create.logger.js';
-import { EnableLogLevel, type IMyLogger } from './types.js';
-
-const stream = new PassThrough();
-stream.pipe(process.stderr);
-Object.assign(stream, { isTTY: process.stderr.isTTY });
+import type { IInstrestedConsole, IMyLogger } from './types.js';
 
 const symbol = Symbol.for('@idlebox/logger/global/terminal');
 
 /**
  * 作为logger导出，必须在程序入口调用过 createGlobalLogger() 才能使用
  */
-export let terminal: IMyLogger;
+export let globalLogger: IMyLogger;
 
 /**
  * 创建root-logger，随后logger变量可用
  */
-export function createGlobalLogger(tag: string, defaultLevel: EnableLogLevel = EnableLogLevel.auto): void {
-	terminal = globalObject[symbol];
-	if (terminal) {
-		terminal.error`global logger already created`;
+export function createGlobalLogger(console: IInstrestedConsole, tag: string, defaultLevel: EnableLogLevel): void {
+	globalLogger = globalObject[symbol];
+	if (globalLogger) {
+		globalLogger.error`global logger already created`;
 		return;
 	}
 
-	terminal = create(tag, undefined, stream);
-	globalObject[symbol] = terminal;
+	globalLogger = create(console, tag);
+	globalObject[symbol] = globalLogger;
 
-	terminal.enable(defaultLevel);
+	globalLogger.enable(defaultLevel);
 
-	if (terminal.verbose.isEnabled) {
-		terminal.verbose`verbose is enabled`;
+	if (globalLogger.verbose.isEnabled) {
+		globalLogger.verbose`verbose is enabled`;
 	} else {
-		terminal.debug`debug is enabled`;
+		globalLogger.debug`debug is enabled`;
 	}
 	return;
 }