@idlebox/common 1.4.10 → 1.4.12

package/package.json

@@ -1,35 +1,41 @@
 {
   "name": "@idlebox/common",
   "type": "module",
-  "version": "1.4.10",
-  "license": "MIT",
-  "main": "./lib/cjs/__create_index.generated.cjs",
-  "module": "./lib/esm/__create_index.generated.js",
-  "types": "./lib/esm/__create_index.generated.d.ts",
+  "version": "1.4.12",
+  "description": "Common utilities",
+  "keywords": [
+    "utilities",
+    "functions",
+    "helpers",
+    "library"
+  ],
+  "main": "./lib/autoindex.js",
   "exports": {
     ".": {
-      "types": "./lib/esm/__create_index.generated.d.ts",
-      "require": "./lib/cjs/__create_index.generated.cjs",
-      "import": "./lib/esm/__create_index.generated.js"
+      "source": "./src/autoindex.ts",
+      "default": "./lib/autoindex.js"
     },
     "./package.json": "./package.json"
   },
   "sideEffects": false,
-  "repository": "https://github.com/GongT/baobao",
   "devDependencies": {
-    "@rushstack/heft": "^0.68.2",
-    "@build-script/single-dog-asset": "^1.0.34",
+    "@rushstack/heft": "^0.73.6",
     "@internal/local-rig": "^1.0.1",
-    "@idlebox/itypes": "^1.0.7"
+    "@build-script/single-dog-asset": "^1.0.34",
+    "@idlebox/itypes": "^1.0.7",
+    "@mpis/run": "^0.1.0",
+    "@mpis/publisher": "^0.1.0"
   },
   "dependencies": {
-    "debug": "^4.3.7"
+    "debug": "^4.4.1"
   },
+  "license": "MIT",
+  "author": "GongT <admin@gongt.me>",
+  "repository": "https://github.com/GongT/baobao",
   "scripts": {
     "test": "heft test",
-    "build": "heft --unmanaged build",
-    "_phase:build": "heft --unmanaged build",
-    "watch": "heft --unmanaged build-watch",
-    "clean": "heft clean"
+    "build": "mpis-run build",
+    "watch": "mpis-run watch",
+    "clean": "mpis-run clean"
   }
 }

package/src/autoindex.ts

@@ -0,0 +1,337 @@
+// DO NOT EDIT THIS FILE
+// @ts-ignore
+/* eslint-disable */
+
+/* array/arrayDiff.ts */
+	// Identifiers
+	export type { IArrayUpdate } from "./array/arrayDiff.js";
+	export { arrayDiff } from "./array/arrayDiff.js";
+/* array/arraySame.ts */
+	// Identifiers
+	export { isArraySame } from "./array/arraySame.js";
+/* array/arrayUnique.ts */
+	// Identifiers
+	export { arrayUnique } from "./array/arrayUnique.js";
+	export { arrayUniqueReference } from "./array/arrayUnique.js";
+	export type { IUniqueIdFactory } from "./array/arrayUnique.js";
+	export { uniqueFilter } from "./array/arrayUnique.js";
+/* array/normalizeArray.ts */
+	// Identifiers
+	export { normalizeArray } from "./array/normalizeArray.js";
+/* array/sortAlpha.ts */
+	// Identifiers
+	export { sortByString } from "./array/sortAlpha.js";
+/* date/consts.ts */
+	// Identifiers
+	export { oneSecond } from "./date/consts.js";
+	export { oneMinute } from "./date/consts.js";
+	export { oneHour } from "./date/consts.js";
+	export { oneDay } from "./date/consts.js";
+	export { oneWeek } from "./date/consts.js";
+/* date/isInvalid.ts */
+	// Identifiers
+	export { isDateInvalid } from "./date/isInvalid.js";
+/* date/sibling.ts */
+	// Identifiers
+	export { nextSecond } from "./date/sibling.js";
+	export { nextMinute } from "./date/sibling.js";
+	export { nextHour } from "./date/sibling.js";
+	export { nextDay } from "./date/sibling.js";
+	export { nextWeek } from "./date/sibling.js";
+	export { nextMonth } from "./date/sibling.js";
+	export { nextYear } from "./date/sibling.js";
+/* string/pad2.ts */
+	// Identifiers
+	export { pad2 } from "./string/pad2.js";
+/* date/timeString.ts */
+	// Identifiers
+	export { humanDate } from "./date/timeString.js";
+/* date/unix.ts */
+	// Identifiers
+	export { getTimeStamp } from "./date/unix.js";
+	export { fromTimeStamp } from "./date/unix.js";
+/* debugging/serializable.ts */
+	// Identifiers
+	export { isScalar } from "./debugging/serializable.js";
+	export { SerializableKind } from "./debugging/serializable.js";
+	export { isSerializable } from "./debugging/serializable.js";
+	export { getTypeOf } from "./debugging/serializable.js";
+	export { assertSerializable } from "./debugging/serializable.js";
+/* debugging/tryInspect.ts */
+	// Identifiers
+	export { tryInspect } from "./debugging/tryInspect.js";
+/* error/getFrame.ts */
+	// Identifiers
+	export { getErrorFrame } from "./error/getFrame.js";
+/* error/convertUnknown.ts */
+	// Identifiers
+	export { convertCatchedError } from "./error/convertUnknown.js";
+/* platform/os.ts */
+	// Identifiers
+	export { hasProcess } from "./platform/os.js";
+	export { hasWindow } from "./platform/os.js";
+	export { hasGlobal } from "./platform/os.js";
+	export { isElectron } from "./platform/os.js";
+	export { isElectronSandbox } from "./platform/os.js";
+	export { isElectronRenderer } from "./platform/os.js";
+	export { isElectronMain } from "./platform/os.js";
+	export { isWindows } from "./platform/os.js";
+	export { isMacintosh } from "./platform/os.js";
+	export { isLinux } from "./platform/os.js";
+	export { isNative } from "./platform/os.js";
+	export { isNodeJs } from "./platform/os.js";
+	export { isWeb } from "./platform/os.js";
+	export { is64Bit } from "./platform/os.js";
+	export { sepList } from "./platform/os.js";
+	export { is32Bit } from "./platform/os.js";
+/* error/known.ts */
+	// Identifiers
+	export { KnownError } from "./error/known.js";
+/* path/isAbsolute.ts */
+	// Identifiers
+	export { isAbsolute } from "./path/isAbsolute.js";
+/* path/normalizePath.ts */
+	// Identifiers
+	export { PathKind } from "./path/normalizePath.js";
+	export type { IPathInfo } from "./path/normalizePath.js";
+	export { analyzePath } from "./path/normalizePath.js";
+	export { normalizePath } from "./path/normalizePath.js";
+	export { relativePath } from "./path/normalizePath.js";
+/* platform/globalObject.ts */
+	// Identifiers
+	export { globalObject } from "./platform/globalObject.js";
+	export { ensureGlobalObject } from "./platform/globalObject.js";
+	export { x } from "./platform/globalObject.js";
+/* error/pretty.vscode.ts */
+	// Identifiers
+	export { vscEscapeValue } from "./error/pretty.vscode.js";
+/* error/pretty.ts */
+	// Identifiers
+	export { setErrorLogRoot } from "./error/pretty.js";
+	export type { IStructreStackLine } from "./error/pretty.js";
+	export { parseStackLine } from "./error/pretty.js";
+	export { prettyPrintError } from "./error/pretty.js";
+	export { parseStackString } from "./error/pretty.js";
+	export { prettyFormatStack } from "./error/pretty.js";
+	export { prettyFormatError } from "./error/pretty.js";
+/* error-wellknown/exit.error.ts */
+	// Identifiers
+	export { AppExit } from "./error-wellknown/exit.error.js";
+/* function/functionName.ts */
+	// Identifiers
+	export type { NamedFunction } from "./function/functionName.js";
+	export { functionName } from "./function/functionName.js";
+	export { nameFunction } from "./function/functionName.js";
+	export type { MaybeNamedFunction } from "./function/functionName.js";
+	export { assertFunctionHasName } from "./function/functionName.js";
+/* function/asyncCallbackList.ts */
+	// Identifiers
+	export type { MyAsyncCallback } from "./function/asyncCallbackList.js";
+	export { AsyncCallbackList } from "./function/asyncCallbackList.js";
+/* function/callbackList.ts */
+	// Identifiers
+	export type { MyCallback } from "./function/callbackList.js";
+	export { CallbackList } from "./function/callbackList.js";
+/* function/delayCallbackList.ts */
+	// Identifiers
+	export type { MyDelayCallback } from "./function/delayCallbackList.js";
+	export { DelayCallbackList } from "./function/delayCallbackList.js";
+/* lifecycle/dispose/disposableEvent.ts */
+	// Identifiers
+	export type { IEventListenerOptions } from "./lifecycle/dispose/disposableEvent.js";
+	export type { IEventHostObject } from "./lifecycle/dispose/disposableEvent.js";
+	export type { IEventEmitterObject } from "./lifecycle/dispose/disposableEvent.js";
+	export { addDisposableEventListener } from "./lifecycle/dispose/disposableEvent.js";
+/* lifecycle/dispose/disposedError.ts */
+	// Identifiers
+	export { DisposedError } from "./lifecycle/dispose/disposedError.js";
+	export { isDisposedError } from "./lifecycle/dispose/disposedError.js";
+/* lifecycle/dispose/lifecycle.async.ts */
+	// Identifiers
+	export { AsyncDisposable } from "./lifecycle/dispose/lifecycle.async.js";
+/* platform/globalSingleton.ts */
+	// Identifiers
+	export { globalSingletonStrong } from "./platform/globalSingleton.js";
+	export { globalSingletonDelete } from "./platform/globalSingleton.js";
+	export { globalSingleton } from "./platform/globalSingleton.js";
+/* platform/globalSymbol.ts */
+	// Identifiers
+	export { createSymbol } from "./platform/globalSymbol.js";
+	export { deleteSymbol } from "./platform/globalSymbol.js";
+/* lifecycle/dispose/lifecycle.global.ts */
+	// Identifiers
+	export { registerGlobalLifecycle } from "./lifecycle/dispose/lifecycle.global.js";
+	export { ensureDisposeGlobal } from "./lifecycle/dispose/lifecycle.global.js";
+	export { disposeGlobal } from "./lifecycle/dispose/lifecycle.global.js";
+	export { LifecycleObject } from "./lifecycle/dispose/lifecycle.global.js";
+/* lifecycle/dispose/lifecycle.sync.ts */
+	// Identifiers
+	export { DisposableOnce } from "./lifecycle/dispose/lifecycle.sync.js";
+	export { Disposable } from "./lifecycle/dispose/lifecycle.sync.js";
+/* lifecycle/dispose/bridges/rxjs.ts */
+	// Identifiers
+	export { unsubscribableToDisposable } from "./lifecycle/dispose/bridges/rxjs.js";
+/* lifecycle/event/memorized.ts */
+	// Identifiers
+	export { MemorizedEmitter } from "./lifecycle/event/memorized.js";
+/* lifecycle/promise/cancel.ts */
+	// Identifiers
+	export { CanceledError } from "./lifecycle/promise/cancel.js";
+	export { isCanceledError } from "./lifecycle/promise/cancel.js";
+/* lifecycle/promise/deferredPromise.ts */
+	// Identifiers
+	export type { ValueCallback } from "./lifecycle/promise/deferredPromise.js";
+	export type { ProgressCallback } from "./lifecycle/promise/deferredPromise.js";
+	export type { IProgressHolder } from "./lifecycle/promise/deferredPromise.js";
+	export { DeferredPromise } from "./lifecycle/promise/deferredPromise.js";
+/* lifecycle/promise/cancellationToken/driver.browser.ts */
+	// Identifiers
+/* lifecycle/promise/cancellationToken/driver.common.ts */
+	// Identifiers
+/* lifecycle/promise/cancellationToken/source.ts */
+	// Identifiers
+	export type { CancellationToken } from "./lifecycle/promise/cancellationToken/source.js";
+	export { CancellationTokenSource } from "./lifecycle/promise/cancellationToken/source.js";
+/* lifecycle/timeout/timeoutError.ts */
+	// Identifiers
+	export { TimeoutError } from "./lifecycle/timeout/timeoutError.js";
+	export { isTimeoutError } from "./lifecycle/timeout/timeoutError.js";
+/* lifecycle/timeout/timeout.ts */
+	// Identifiers
+	export { timeout } from "./lifecycle/timeout/timeout.js";
+	export { sleep } from "./lifecycle/timeout/timeout.js";
+	export { timeoutPromise } from "./lifecycle/timeout/timeout.js";
+/* log/logger.ts */
+	// Identifiers
+	export { ColorKind } from "./log/logger.js";
+	export type { WrappedConsoleOptions } from "./log/logger.js";
+	export { WrappedConsole } from "./log/logger.js";
+/* mapSet/customSet.ts */
+	// Identifiers
+	export type { Finder } from "./mapSet/customSet.js";
+	export { RegexpFinder } from "./mapSet/customSet.js";
+	export { CustomSet } from "./mapSet/customSet.js";
+/* mapSet/extendMap.ts */
+	// Identifiers
+	export type { MapLike } from "./mapSet/extendMap.js";
+	export { ExtendMap } from "./mapSet/extendMap.js";
+/* misc/assertNotNull.ts */
+	// Identifiers
+	export { assertNotNull } from "./misc/assertNotNull.js";
+	export { throwNull } from "./misc/assertNotNull.js";
+/* misc/package.json.ts */
+	// Identifiers
+	export type { IExportCondition } from "./misc/package.json.js";
+	export type { IExportMap } from "./misc/package.json.js";
+	export type { IFullExportsField } from "./misc/package.json.js";
+	export type { IExportsField } from "./misc/package.json.js";
+	export { parseExportsField } from "./misc/package.json.js";
+	export { resolveExportPath } from "./misc/package.json.js";
+	export type { IPackageJson } from "./misc/package.json.js";
+	export type { IPackageJsonNpmDist } from "./misc/package.json.js";
+/* object/definePublicConstant.ts */
+	// Identifiers
+	export { definePublicConstant } from "./object/definePublicConstant.js";
+	export { definePrivateConstant } from "./object/definePublicConstant.js";
+/* object/initOnRead.ts */
+	// Identifiers
+	export type { InitFunc } from "./object/initOnRead.js";
+	export { initOnRead } from "./object/initOnRead.js";
+/* object/objectPath.ts */
+	// Identifiers
+	export { objectPath } from "./object/objectPath.js";
+/* object/objectSame.ts */
+	// Identifiers
+	export { isObjectSame } from "./object/objectSame.js";
+	export { isObjectSameRecursive } from "./object/objectSame.js";
+/* string/castCase.ts */
+	// Identifiers
+	export { camelCase } from "./string/castCase.js";
+	export { ucfirst } from "./string/castCase.js";
+	export { lcfirst } from "./string/castCase.js";
+	export { linux_case } from "./string/castCase.js";
+	export { linux_case_hyphen } from "./string/castCase.js";
+/* path/pathArray.ts */
+	// Identifiers
+	export { PathArrayWindows } from "./path/pathArray.js";
+	export { PathArrayPosix } from "./path/pathArray.js";
+	export { PathArray } from "./path/pathArray.js";
+/* promise/awaitIterator.ts */
+	// Identifiers
+	export { awaitIterator } from "./promise/awaitIterator.js";
+/* promise/finishAllPromise.ts */
+	// Identifiers
+	export type { PromiseResultArray } from "./promise/finishAllPromise.js";
+	export { finishAllPromise } from "./promise/finishAllPromise.js";
+/* promise/promiseBool.ts */
+	// Identifiers
+	export { promiseBool } from "./promise/promiseBool.js";
+/* promise/promiseCollection.ts */
+	// Identifiers
+	export { PromiseCollection } from "./promise/promiseCollection.js";
+/* promise/timeoutPromiseCollection.ts */
+	// Identifiers
+	export { TimeoutPromiseCollection } from "./promise/timeoutPromiseCollection.js";
+/* reflection/classes/hookClass.ts */
+	// Identifiers
+	export { hookClassSymbol } from "./reflection/classes/hookClass.js";
+	export { hookClass } from "./reflection/classes/hookClass.js";
+/* reflection/classes/singleton.ts */
+	// Identifiers
+	export { singletonSymbol } from "./reflection/classes/singleton.js";
+	export { SingletonType } from "./reflection/classes/singleton.js";
+	export { singleton } from "./reflection/classes/singleton.js";
+/* reflection/methods/bind.ts */
+	// Identifiers
+	export { bindThis } from "./reflection/methods/bind.js";
+/* reflection/methods/initOnRead.ts */
+	// Identifiers
+	export { init } from "./reflection/methods/initOnRead.js";
+/* reflection/methods/memorize.ts */
+	// Identifiers
+	export { memorizeValueSymbol } from "./reflection/methods/memorize.js";
+	export { memo } from "./reflection/methods/memorize.js";
+/* state/StateMachine.ts */
+	// Identifiers
+	export type { IFsmRuleMap } from "./state/StateMachine.js";
+	export type { IStateChangeEvent } from "./state/StateMachine.js";
+	export { SimpleStateMachine } from "./state/StateMachine.js";
+/* string/concatType.generated.ts */
+	// Identifiers
+	export { concatStringType } from "./string/concatType.generated.js";
+/* string/escapeRegexp.ts */
+	// Identifiers
+	export { escapeRegExp } from "./string/escapeRegexp.js";
+/* string/sizeString.ts */
+	// Identifiers
+	export { humanSizeSI } from "./string/sizeString.js";
+	export { humanSize } from "./string/sizeString.js";
+	export { humanSpeed } from "./string/sizeString.js";
+/* typingHelper/literal.ts */
+	// Identifiers
+	export type { Primitive } from "./typingHelper/literal.js";
+/* typingHelper/deep.partial.ts */
+	// Identifiers
+	export type { DeepPartial } from "./typingHelper/deep.partial.js";
+/* typingHelper/deep.readonly.ts */
+	// Identifiers
+	export type { DeepReadonly } from "./typingHelper/deep.readonly.js";
+/* typingHelper/deep.required.ts */
+	// Identifiers
+	export type { DeepNonNullable } from "./typingHelper/deep.required.js";
+/* typingHelper/deep.writable.ts */
+	// Identifiers
+	export type { DeepWriteable } from "./typingHelper/deep.writable.js";
+/* lifecycle/event/event.ts */
+	// Identifiers
+	export type { EventHandler } from "./lifecycle/event/event.js";
+	export type { EventRegister } from "./lifecycle/event/event.js";
+	export { Emitter } from "./lifecycle/event/event.js";
+/* lifecycle/dispose/lifecycle.ts */
+	// Identifiers
+	export type { IDisposableEvents } from "./lifecycle/dispose/lifecycle.js";
+	export type { IDisposable } from "./lifecycle/dispose/lifecycle.js";
+	export type { IAsyncDisposable } from "./lifecycle/dispose/lifecycle.js";
+	export { toDisposable } from "./lifecycle/dispose/lifecycle.js";
+/* lifecycle/dispose/debug.ts */
+	// Identifiers

package/src/date/timeString.ts

@@ -1,4 +1,5 @@
 import { pad2 } from '../string/pad2.js';
+import { oneDay, oneHour, oneMinute, oneSecond } from './consts.js';
 
 export namespace humanDate {
 	/**
@@ -39,6 +40,7 @@ export namespace humanDate {
 	export type ITimeFormatter = (s: number) => string;
 
 	export interface IFormatters {
+		ms: ITimeFormatter;
 		s: ITimeFormatter;
 		m: ITimeFormatter;
 		h: ITimeFormatter;
@@ -46,6 +48,9 @@ export namespace humanDate {
 	}
 
 	const formatters: IFormatters = {
+		ms(v: number) {
+			return `${v}ms`;
+		},
 		s(v: number) {
 			return `${v}s`;
 		},
@@ -75,70 +80,53 @@ export namespace humanDate {
 	 * day is the largest unit
 	 */
 	export function deltaTiny(ms: number) {
-		if (ms <= 0) {
+		if (ms > oneDay) {
+			return formatters.d(Math.floor(ms / oneDay));
+		} else if (ms > oneHour) {
+			return formatters.h(Math.floor(ms / oneHour));
+		} else if (ms > oneMinute) {
+			return formatters.m(Math.floor(ms / oneMinute));
+		} else if (ms > oneSecond) {
+			return formatters.s(Math.floor(ms / oneSecond));
+		} else if (ms > 0) {
+			return formatters.ms(ms);
+		} else {
 			return '0s';
 		}
-		if (ms > 86400000) {
-			return formatters.d(Math.floor(ms / 86400000));
-		}
-		if (ms > 3600000) {
-			return formatters.h(Math.floor(ms / 3600000));
-		}
-		if (ms > 60000) {
-			return formatters.m(Math.floor(ms / 60000));
-		}
-		return formatters.s(Math.floor(ms / 1000));
 	}
 
 	/**
 	 * format time delta (in ms) to string, like: '1d10m42s'
+	 * only return XXXms when ms<1000
 	 * when ms<=0, returns '0s'
 	 *
 	 * format can set by `setLocaleFormatter`
 	 * day is the largest unit
 	 */
 	export function delta(ms: number) {
-		let ret = '';
-		let val = Math.ceil(ms / 1000);
-
-		if (val <= 0) {
+		if (ms <= 0) {
 			return '0s';
 		}
 
-		// sec
-		const s = val % 60;
-		val = Math.floor(val / 60);
-		if (s > 0) {
-			ret = formatters.s(s);
-		}
-		if (val === 0) {
-			return ret;
+		// ms
+		if (ms < oneSecond) {
+			return formatters.ms(ms);
 		}
 
-		// min
-		const m = val % 60;
-		val = Math.floor(val / 60);
-		if (m > 0) {
-			ret = formatters.m(m) + ret;
-		}
-		if (val === 0) {
-			return ret;
-		}
-
-		// hour
-		const h = val % 24;
-		val = Math.floor(val / 24);
-		if (h > 0) {
-			ret = formatters.h(h) + ret;
+		let ret = '';
+		if (ms > oneDay) {
+			ret += formatters.d(Math.floor(ms / oneDay));
+			ms = ms % oneDay;
 		}
-		if (val === 0) {
-			return ret;
+		if (ms > oneHour) {
+			ret += formatters.h(Math.floor(ms / oneHour));
+			ms = ms % oneHour;
 		}
-
-		// day
-		if (val > 0) {
-			ret = formatters.d(h) + ret;
+		if (ms > oneMinute) {
+			ret += formatters.m(Math.floor(ms / oneMinute));
+			ms = ms % oneMinute;
 		}
+		ret += formatters.s(Math.floor(ms / oneSecond));
 		return ret;
 	}
 }

package/src/error/pretty.ts

@@ -158,13 +158,17 @@ export function parseStackLine(line: string): IStructreStackLine {
 	return ret;
 }
 
+function isPrettyDisabled() {
+	return globalObject.DISABLE_PRETTY_ERROR || globalObject.process?.env?.DISABLE_PRETTY_ERROR;
+}
+
 let notify_printed = false;
 export function prettyPrintError(type: string, e: Error) {
 	if (!e.stack || e.stack === e.message) {
 		return console.error(e.message);
 	}
 
-	if (globalObject.DISABLE_PRETTY_ERROR || globalObject.process?.env?.DISABLE_PRETTY_ERROR) {
+	if (isPrettyDisabled()) {
 		console.error('[%s] %s', type, e.stack || e.message);
 		return;
 	}
@@ -176,7 +180,7 @@ export function prettyPrintError(type: string, e: Error) {
 		// console.log(JSON.stringify(e.stack), JSON.stringify(e.message));
 		notify_printed = true;
 		console.error(
-			'\x1B[2muse env.DISABLE_PRETTY_ERROR=yes / window.DISABLE_PRETTY_ERROR=true to see original error stack\x1B[0m'
+			'\x1B[2muse env.DISABLE_PRETTY_ERROR=yes / window.DISABLE_PRETTY_ERROR=true to see original error stack\x1B[0m',
 		);
 	}
 }
@@ -190,6 +194,9 @@ export function parseStackString(stack: string) {
 }
 
 export function prettyFormatStack(stackLines: readonly string[]) {
+	if (isPrettyDisabled()) {
+		return stackLines;
+	}
 	const structured: IStructreStackLine[] = stackLines.map(parseStackLine);
 	let messageEnded = false;
 	return structured
@@ -295,6 +302,10 @@ export function prettyFormatError(e: IError, withMessage = true) {
 		return red('  No stack trace');
 	}
 
+	if (isPrettyDisabled()) {
+		return e.stack;
+	}
+
 	const stackLines = e.stack.split(/\n/g);
 
 	let first = 'Unknown Error';
@@ -336,7 +347,7 @@ function formatFileLine(schema: string | undefined, file: string, row?: number,
 					'pretty print error: failed calc relative path ("%s" to "%s"):\n\x1B[2mFormat%s\x1B[0m',
 					root,
 					file,
-					e.stack
+					e.stack,
 				);
 			}
 			rel = file;

package/src/error-wellknown/exit.error.ts

@@ -0,0 +1,14 @@
+/**
+ * 应用程序退出
+ *
+ * 此错误通常不需要输出到日志
+ */
+export class AppExit extends Error {
+	constructor(
+		message: string,
+		public readonly code?: number,
+	) {
+		super(message);
+		this.name = 'AppExit';
+	}
+}

package/src/lifecycle/dispose/debug.ts

@@ -1,15 +1,15 @@
 import debug from 'debug';
-import type { IDisposable } from './lifecycle.js';
+import type { IAsyncDisposable, IDisposable } from './lifecycle.js';
 
 /** @internal */
 export const _debug_dispose = debug('dispose');
 
 /** @internal */
-export function dispose_name(dis: IDisposable) {
-	return dis.displayName || dis.name || name_of_func(dis.constructor) || name_of_func(dis.dispose) || '<unknown>';
+export function dispose_name(dis: IDisposable | IAsyncDisposable, defaultName = '<unknown>'): string {
+	return dis.displayName || dis.name || name_of_func(dis.constructor) || name_of_func(dis.dispose) || defaultName;
 }
 function name_of_func(obj: any) {
-	const name = obj.name;
+	const name: string = obj.name;
 
 	if (
 		name === 'Object' ||
@@ -18,7 +18,8 @@ function name_of_func(obj: any) {
 		name === 'GeneratorFunction' ||
 		name === 'AsyncGeneratorFunction' ||
 		name === 'Disposable' ||
-		name === 'AsyncDisposable'
+		name === 'AsyncDisposable' ||
+		name.toLowerCase() === 'dispose'
 	) {
 		return '';
 	}