@idlebox/common 1.4.1 → 1.4.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@idlebox/common",
   "type": "module",
-  "version": "1.4.1",
+  "version": "1.4.3",
   "license": "MIT",
   "main": "./lib/cjs/__create_index.generated.cjs",
   "module": "./lib/esm/__create_index.generated.js",
@@ -18,8 +18,8 @@
   "repository": "https://github.com/GongT/baobao",
   "devDependencies": {
     "@rushstack/heft": "^0.68.2",
-    "@build-script/single-dog-asset": "^1.0.31",
-    "@idlebox/itypes": "^1.0.5",
+    "@idlebox/itypes": "^1.0.6",
+    "@build-script/single-dog-asset": "^1.0.33",
     "@internal/local-rig": "^1.0.1"
   },
   "scripts": {

package/src/array/arrayUnique.ts

@@ -20,9 +20,7 @@ export function arrayUniqueReference(arr: any[]): void {
 	}
 }
 
-export interface IUniqueIdFactory<T> {
-	(item: T): string;
-}
+export type IUniqueIdFactory<T> = (item: T) => string;
 
 function defaultFactory(t: any) {
 	return t as string;
@@ -42,9 +40,8 @@ export function uniqueFilter<T>(idFactory: IUniqueIdFactory<T> = defaultFactory)
 		const id = idFactory(item);
 		if (seen[id]) {
 			return false;
-		} else {
-			seen[id] = true;
-			return true;
 		}
+		seen[id] = true;
+		return true;
 	};
 }

package/src/array/normalizeArray.ts

@@ -5,9 +5,9 @@
 export function normalizeArray<T>(input: T | T[]): T[] {
 	if (input && Array.isArray(input)) {
 		return input;
-	} else if (typeof input !== undefined) {
+	}
+	if (typeof input !== 'undefined') {
 		return [input];
-	} else {
-		return [];
 	}
+	return [];
 }

package/src/array/sortAlpha.ts

@@ -7,9 +7,9 @@
 export function sortByString(a: string, b: string): number {
 	if (a === b) {
 		return 0;
-	} else if (a > b) {
+	}
+	if (a > b) {
 		return 1;
-	} else {
-		return -1;
 	}
+	return -1;
 }

package/src/date/isInvalid.ts

@@ -2,5 +2,5 @@
  * Check if a date is NaN
  */
 export function isDateInvalid(date: Date) {
-	return isNaN(date.getTime());
+	return Number.isNaN(date.getTime());
 }

package/src/date/timeString.ts

@@ -6,7 +6,7 @@ export namespace humanDate {
 	 */
 	export function time(date: Date | string | number) {
 		if (typeof date === 'string') {
-			date = parseInt(date);
+			date = Number.parseInt(date);
 		}
 		date = new Date(date as number);
 		return `${pad2(date.getHours())}:${pad2(date.getMinutes())}:${pad2(date.getSeconds())}`;
@@ -19,7 +19,7 @@ export namespace humanDate {
 	 */
 	export function date(date: Date | string | number, sp = '-') {
 		if (typeof date === 'string') {
-			date = parseInt(date);
+			date = Number.parseInt(date);
 		}
 		date = new Date(date as number);
 		return `${date.getFullYear()}${sp}${pad2(date.getMonth() + 1)}${sp}${pad2(date.getDate())}`;
@@ -30,19 +30,13 @@ export namespace humanDate {
 	 */
 	export function datetime(date: Date | string | number) {
 		if (typeof date === 'string') {
-			date = parseInt(date);
+			date = Number.parseInt(date);
 		}
 		date = new Date(date as number);
-		return (
-			`${date.getFullYear()}-${date.getMonth() + 1}-${date.getDate()}` +
-			' ' +
-			`${pad2(date.getHours())}:${pad2(date.getMinutes())}:${pad2(date.getSeconds())}`
-		);
+		return `${date.getFullYear()}-${date.getMonth() + 1}-${date.getDate()} ${pad2(date.getHours())}:${pad2(date.getMinutes())}:${pad2(date.getSeconds())}`;
 	}
 
-	export interface ITimeFormatter {
-		(s: number): string;
-	}
+	export type ITimeFormatter = (s: number) => string;
 
 	export interface IFormatters {
 		s: ITimeFormatter;
@@ -53,16 +47,16 @@ export namespace humanDate {
 
 	const formatters: IFormatters = {
 		s(v: number) {
-			return v + 's';
+			return `${v}s`;
 		},
 		m(v: number) {
-			return v + 'm';
+			return `${v}m`;
 		},
 		h(v: number) {
-			return v + 'h';
+			return `${v}h`;
 		},
 		d(v: number) {
-			return v + 'd';
+			return `${v}d`;
 		},
 	};
 

package/src/debugging/serializable.ts

@@ -5,11 +5,11 @@ declare const Element: any;
 type ScalarTypes =
 	| bigint
 	| number
-	| Number
+	| number
+	| boolean
 	| boolean
-	| Boolean
 	| string
-	| String
+	| string
 	| symbol
 	| undefined
 	| null
@@ -43,9 +43,9 @@ export function isScalar(value: any): value is ScalarTypes {
 
 export enum SerializableKind {
 	Invalid = 0,
-	Primitive,
-	Manual,
-	Other,
+	Primitive = 1,
+	Manual = 2,
+	Other = 3,
 }
 
 export function isSerializable(value: any): SerializableKind {
@@ -54,7 +54,7 @@ export function isSerializable(value: any): SerializableKind {
 		case 'bigint':
 		// @ts-expect-error
 		case 'number':
-			if (isNaN(value) || Infinity === value || -Infinity === value) {
+			if (Number.isNaN(value) || Number.POSITIVE_INFINITY === value || Number.NEGATIVE_INFINITY === value) {
 				return SerializableKind.Invalid;
 			}
 		case 'boolean':
@@ -84,7 +84,7 @@ export function isSerializable(value: any): SerializableKind {
 					return SerializableKind.Invalid;
 				}
 			}
-			if ('then' in value && typeof value['then'] === 'function') {
+			if ('then' in value && typeof value.then === 'function') {
 				return SerializableKind.Invalid;
 			}
 

package/src/debugging/tryInspect.ts

@@ -23,17 +23,21 @@ export function tryInspect(object: any) {
 
 	if (object[inspect]) {
 		return object[inspect]();
-	} else if (inspectOld && object[inspectOld]) {
+	}
+	if (inspectOld && object[inspectOld]) {
 		return object[inspectOld]();
-	} else if (object['inspect']) {
-		return object['inspect']();
-	} else if (object[Symbol.toStringTag]) {
+	}
+	if (object.inspect) {
+		return object.inspect();
+	}
+	if (object[Symbol.toStringTag]) {
 		return object[Symbol.toStringTag]();
-	} else if (object.toJSON) {
+	}
+	if (object.toJSON) {
 		return object.toJSON();
-	} else if (object.constructor?.name) {
+	}
+	if (object.constructor?.name) {
 		return `unknown: ${object.constructor.name}`;
-	} else {
-		return 'unknown: ' + object;
 	}
+	return `unknown: ${object}`;
 }

package/src/error/convertUnknown.ts

@@ -3,8 +3,7 @@ import { getErrorFrame } from './getFrame.js';
 export function convertCatchedError(e: unknown): Error {
 	if (e instanceof Error) {
 		return e;
-	} else {
-		console.error('Catched invalid error at %s, type %s, value %s.', getErrorFrame(new Error(), 1), typeof e, e);
-		return new Error('Invalid: ' + e);
 	}
+	console.error('Catched invalid error at %s, type %s, value %s.', getErrorFrame(new Error(), 1), typeof e, e);
+	return new Error(`Invalid: ${e}`);
 }

package/src/error/getFrame.ts

@@ -3,10 +3,10 @@
  * @returns {string} if frame greater than max, return ''
  */
 export function getErrorFrame(e: Error, frame: number): string {
-	if (e && e.stack) {
+	if (e?.stack) {
 		const stackArr = e.stack.split('\n');
 		if (stackArr.length > frame + 1) {
-			return stackArr[frame + 1]!.trim();
+			return stackArr[frame + 1]?.trim();
 		}
 	}
 	return '';

package/src/error/known.ts

@@ -5,8 +5,8 @@ interface ErrorOptions {
 }
 
 abstract class KnownErrorAbstract extends Error {
-	protected static debugMode: boolean = false;
-	static debug(enabled: boolean = true) {
+	protected static debugMode = false;
+	static debug(enabled = true) {
 		KnownErrorAbstract.debugMode = enabled;
 	}
 	static is(e: any): e is KnownErrorAbstract {

package/src/error/pretty.ts

@@ -74,8 +74,8 @@ function addLoc(ret: IStructreStackLine, m: Record<TypeMatchFileOnly, string>) {
 	ret.location = {
 		schema: m.schema?.replace(/\/+$/, '') ?? '',
 		path: path,
-		line: parseInt(m.line),
-		column: parseInt(m.column),
+		line: Number.parseInt(m.line),
+		column: Number.parseInt(m.column),
 		isAbsolute: isAbsolute(path),
 	};
 }
@@ -126,12 +126,13 @@ export function parseStackLine(line: string): IStructreStackLine {
 		addLoc(ret, mEval);
 
 		ret.eval = {
-			eval_column: parseInt(mEval.eval_column),
+			eval_column: Number.parseInt(mEval.eval_column),
 			eval_func: mEval.eval_func,
-			eval_line: parseInt(mEval.eval_line),
+			eval_line: Number.parseInt(mEval.eval_line),
 			funcs: [],
 		};
 		for (const item of line.matchAll(regEvalItem)) {
+			// biome-ignore lint/style/noNonNullAssertion: 有匹配必然有 groups
 			ret.eval.funcs.push(item.groups!.func_name);
 		}
 		ret.eval.funcs.push(mEval.eval_func);
@@ -161,7 +162,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'
 		);
 	}
 }
@@ -197,12 +198,7 @@ export function prettyFormatStack(stackLines: readonly string[]) {
 					if (fn_name) {
 						ret += ' (';
 					}
-					ret += formatFileLine(
-						line.location.schema,
-						line.location.path,
-						line.location.line,
-						line.location.column,
-					);
+					ret += formatFileLine(line.location.schema, line.location.path, line.location.line, line.location.column);
 					if (fn_name) {
 						ret += ')';
 					}
@@ -216,7 +212,7 @@ export function prettyFormatStack(stackLines: readonly string[]) {
 				const color = fn_name ? (isNodeModule ? '14;2' : '14') : '8';
 				ret = `\x1b[0m  at \x1b[38;5;${color}m`;
 				if (fn_alias && fn_name && fn_name.startsWith('Object.')) {
-					ret += fn_alias + ' [export]';
+					ret += `${fn_alias} [export]`;
 				} else {
 					ret += formatFunctionName(fn_name, fn_alias);
 				}
@@ -232,7 +228,7 @@ export function prettyFormatStack(stackLines: readonly string[]) {
 					} else {
 						color = '\x1b[38;5;2m';
 					}
-					ret += ' (' + color;
+					ret += ` (${color}`;
 					const file = formatFileLine(line.location.schema, path, line.location.line, line.location.column);
 					const lastNmPos = file.lastIndexOf('/node_modules/');
 					if (lastNmPos >= 0) {
@@ -266,15 +262,14 @@ interface IError {
 export function prettyFormatError(e: IError, withMessage = true) {
 	if (!e || !e.stack) {
 		if (withMessage) {
-			let msg = e?.message || 'Unknown Error';
+			const msg = e?.message || 'Unknown Error';
 
-			return red(msg + '\n  No stack trace');
-		} else {
-			return red('  No stack trace');
+			return red(`${msg}\n  No stack trace`);
 		}
+		return red('  No stack trace');
 	}
 
-	let stackLines = e.stack.split(/\n/g);
+	const stackLines = e.stack.split(/\n/g);
 
 	let first = 'Unknown Error';
 	if (/^\S/.test(stackLines[0])) {
@@ -286,10 +281,9 @@ export function prettyFormatError(e: IError, withMessage = true) {
 			first = first.replace(/^(\S+):/, `$1(code ${e.code}):`);
 		}
 
-		return first + '\n' + prettyFormatStack(stackLines).join('\n');
-	} else {
-		return prettyFormatStack(stackLines).join('\n');
+		return `${first}\n${prettyFormatStack(stackLines).join('\n')}`;
 	}
+	return prettyFormatStack(stackLines).join('\n');
 }
 
 let alert = false;
@@ -300,7 +294,7 @@ function formatFileLine(schema: string | undefined, file: string, row?: number,
 		try {
 			rel = relativePath(root, file);
 			if (rel[0] !== '.') {
-				rel = './' + rel;
+				rel = `./${rel}`;
 			} else if (rel[1] === '.') {
 				if (file.length < rel.length) {
 					rel = file;
@@ -311,13 +305,12 @@ function formatFileLine(schema: string | undefined, file: string, row?: number,
 			}
 		} catch (e: any) {
 			if (!alert) {
-				debugger;
 				alert = true;
 				console.error(
 					'pretty print error: failed calc relative path ("%s" to "%s"):\n\x1B[2mFormat%s\x1B[0m',
 					root,
 					file,
-					e.stack,
+					e.stack
 				);
 			}
 			rel = file;
@@ -331,12 +324,10 @@ function formatFunctionName(fn?: string, as?: string) {
 	if (fn) {
 		if (as) {
 			return `${fn} [as ${as}]`;
-		} else {
-			return fn;
 		}
-	} else {
-		return '<anonymous>';
+		return fn;
 	}
+	return '<anonymous>';
 }
 
 function translateFunction(data: IStructreStackLine): IStructreStackLine {
@@ -353,8 +344,8 @@ function translateFunction(data: IStructreStackLine): IStructreStackLine {
 		data.func.name = 'process.nextTick';
 	}
 	if (data.func.name.startsWith('Timeout.') && data.func.alias === '_onTimeout') {
-		data.func.name = 'setTimeout->' + data.func.name.slice(8);
-		delete data.func.alias;
+		data.func.name = `setTimeout->${data.func.name.slice(8)}`;
+		data.func.alias = undefined;
 	}
 	return data;
 }
@@ -370,13 +361,17 @@ function skipSomeFrame({ location }: IStructreStackLine): boolean {
 	if (location.schema === 'node:') {
 		if (location.path.startsWith('internal/timers')) {
 			return false;
-		} else if (location.path === 'internal/modules/cjs/loader') {
+		}
+		if (location.path === 'internal/modules/cjs/loader') {
 			return false;
-		} else if (location.path === 'internal/modules/esm/loader') {
+		}
+		if (location.path === 'internal/modules/esm/loader') {
 			return false;
-		} else if (location.path === 'internal/modules/run_main') {
+		}
+		if (location.path === 'internal/modules/run_main') {
 			return false;
-		} else if (location.path === 'internal/modules/esm/module_job') {
+		}
+		if (location.path === 'internal/modules/esm/module_job') {
 			return false;
 		}
 	}

package/src/function/asyncCallbackList.ts

@@ -3,7 +3,7 @@ import { nameFunction } from './functionName.js';
 export interface MyAsyncCallback<Argument extends unknown[]> {
 	displayName?: string;
 
-	(...param: Argument): Promise<void | undefined | boolean> | void | undefined | boolean;
+	(...param: Argument): Promise<undefined | undefined | boolean> | undefined | undefined | boolean;
 }
 
 /**
@@ -11,7 +11,7 @@ export interface MyAsyncCallback<Argument extends unknown[]> {
  */
 export class AsyncCallbackList<Argument extends unknown[]> {
 	protected list: MyAsyncCallback<Argument>[] = [];
-	protected running: boolean = false;
+	protected running = false;
 
 	constructor() {
 		this.run = (this.run as any).bind(this);
@@ -62,7 +62,7 @@ export class AsyncCallbackList<Argument extends unknown[]> {
 	 */
 	async run(...argument: Argument): Promise<boolean> {
 		this.running = true;
-		let ret: boolean | undefined | void;
+		let ret: boolean | undefined | undefined;
 		for (const cb of this.list) {
 			ret = await cb(...argument);
 			if (ret === true) {

package/src/function/callbackList.ts

@@ -11,8 +11,8 @@ export interface MyCallback<Argument extends unknown[]> {
  */
 export class CallbackList<Argument extends unknown[]> {
 	protected list: MyCallback<Argument>[] = [];
-	protected running: boolean = false;
-	protected stop: boolean = false;
+	protected running = false;
+	protected stop = false;
 
 	constructor() {
 		this.run = (this.run as any).bind(this);

package/src/function/delayCallbackList.ts

@@ -12,7 +12,7 @@ export interface MyDelayCallback<Argument extends unknown[]> {
  */
 export class DelayCallbackList<Argument extends unknown[]> {
 	private delayArgument?: Argument;
-	private delayComplete: boolean = false;
+	private delayComplete = false;
 
 	protected list?: MyDelayCallback<Argument>[] = [];
 
@@ -27,7 +27,7 @@ export class DelayCallbackList<Argument extends unknown[]> {
 		if (this.delayComplete) {
 			item(...this.delayArgument!);
 		} else {
-			this.list!.push(item);
+			this.list?.push(item);
 		}
 	}
 
@@ -37,9 +37,9 @@ export class DelayCallbackList<Argument extends unknown[]> {
 		}
 		this.delayComplete = true;
 		this.delayArgument = argument;
-		this.list!.forEach((cb) => {
+		this.list?.forEach((cb) => {
 			cb(...argument);
 		});
-		delete this.list;
+		this.list = undefined;
 	}
 }

package/src/lifecycle/dispose/disposableEvent.ts

@@ -1,4 +1,4 @@
-import { IDisposable } from './lifecycle.js';
+import type { IDisposable } from './lifecycle.js';
 
 declare const AbortController: new () => any;
 
@@ -86,9 +86,8 @@ function check(options: IEventListenerOptions = {}): [{ abort(): void } | undefi
 		const controller = new AbortController();
 		(options as any).signal = controller.signal;
 		return [controller, options];
-	} else {
-		return [undefined, options];
 	}
+	return [undefined, options];
 }
 
 function checkAllSupport(ele: IEventHostObject<any>) {

package/src/lifecycle/dispose/disposedError.ts

@@ -9,7 +9,7 @@ export class DisposedError extends Error {
 	public readonly inspectString: string;
 	constructor(
 		object: any,
-		public readonly previous: Error,
+		public readonly previous: Error
 	) {
 		const insp = tryInspect(object);
 		super(`Object [${insp}] has already disposed ${getErrorFrame(previous, 2)}.`);

package/src/lifecycle/dispose/lifecycle.async.ts

@@ -1,7 +1,7 @@
 import { convertCatchedError } from '../../error/convertUnknown.js';
-import { Emitter, EventRegister } from '../event/event.js';
+import { Emitter, type EventRegister } from '../event/event.js';
 import { DisposedError } from './disposedError.js';
-import { IAsyncDisposable, IDisposableEvents } from './lifecycle.js';
+import type { IAsyncDisposable, IDisposableEvents } from './lifecycle.js';
 
 /**
  * Async version of Disposable

package/src/lifecycle/dispose/lifecycle.global.ts

@@ -1,6 +1,6 @@
 import { globalSingletonStrong } from '../../platform/globalSingleton.js';
 import { createSymbol } from '../../platform/globalSymbol.js';
-import { IDisposable } from './lifecycle.js';
+import type { IDisposable } from './lifecycle.js';
 import { AsyncDisposable } from './lifecycle.async.js';
 
 const symbol = createSymbol('lifecycle', 'application');
@@ -23,9 +23,8 @@ export function ensureDisposeGlobal() {
 	const obj = globalSingletonStrong<AsyncDisposable>(symbol);
 	if (obj && !obj.hasDisposed) {
 		return Promise.resolve(obj.dispose());
-	} else {
-		return Promise.resolve();
 	}
+	return Promise.resolve();
 }
 
 /**
@@ -36,13 +35,13 @@ export function ensureDisposeGlobal() {
  */
 export function disposeGlobal() {
 	const obj = globalSingletonStrong<AsyncDisposable>(symbol);
-	if (obj && obj.hasDisposed) {
+	if (obj?.hasDisposed) {
 		throw new Error('global already disposed.');
-	} else if (obj) {
+	}
+	if (obj) {
 		return Promise.resolve(obj.dispose());
-	} else {
-		return Promise.resolve();
 	}
+	return Promise.resolve();
 }
 
 /**

package/src/lifecycle/dispose/lifecycle.sync.ts

@@ -1,6 +1,6 @@
-import { Emitter, EventRegister } from '../event/event.js';
+import { Emitter, type EventRegister } from '../event/event.js';
 import { DisposedError } from './disposedError.js';
-import { IDisposable, IDisposableEvents } from './lifecycle.js';
+import type { IDisposable, IDisposableEvents } from './lifecycle.js';
 
 export abstract class DisposableOnce implements IDisposable {
 	private _disposed?: Error;
@@ -85,7 +85,7 @@ export class Disposable implements IDisposable, IDisposableEvents {
 					this._onDisposeError.fire(e);
 				} else {
 					console.error('error during dispose, throw:', e);
-					this._onDisposeError.fire(new Error('' + e));
+					this._onDisposeError.fire(new Error(`${e}`));
 				}
 			}
 		}

package/src/lifecycle/dispose/lifecycle.ts

@@ -1,4 +1,4 @@
-import { EventRegister } from '../event/event.js';
+import type { EventRegister } from '../event/event.js';
 
 /**
  * @private