@idlebox/common 1.5.14 → 1.5.16

package/src/lifecycle/dispose/disposable.ts

@@ -1,3 +1,4 @@
+import { defineInspectMethod } from '../../debugging/inspect.js';
 import type { MaybeNamed } from '../../debugging/object-with-name.js';
 import { createStackTraceHolder, type StackTraceHolder } from '../../error/stack-trace.js';
 import { Emitter } from '../event/event.js';
@@ -57,13 +58,25 @@ export abstract class AbstractEnhancedDisposable<Async extends boolean> implemen
 			this.displayName = displayName;
 		}
 
-		this._logger = _debug_dispose.extend(this.displayName || 'disposable');
+		this._logger = defineInspectMethod(_debug_dispose.extend(this.displayName || 'disposable'), () => {
+			return `[Function debug]`;
+		});
 
 		this._onPostDispose.handle(() => {
 			this._onPostDispose.dispose();
 		});
 		this._disposables.push(this._onBeforeDispose);
 		this._disposables.push(this._onDisposeError);
+
+		if (
+			this.constructor.name === 'EnhancedAsyncDisposable' ||
+			this.constructor.name === 'UnorderedAsyncDisposable' ||
+			this.constructor.name === 'EnhancedDisposable'
+		) {
+			defineInspectMethod(this, (_depth: number, options: any) => {
+				return options.stylize(`[${this.displayName}]`, 'special');
+			});
+		}
 	}
 
 	/**

package/src/lifecycle/event/event.ts

@@ -1,4 +1,5 @@
 import { Exit } from '@idlebox/errors';
+import { defineInspectMethod, inspectSymbol } from '../../debugging/inspect.js';
 import { nameObject, objectName } from '../../debugging/object-with-name.js';
 import { createStackTraceHolder } from '../../error/stack-trace.js';
 import { functionToDisposable } from '../dispose/bridges/function.js';
@@ -6,6 +7,8 @@ import type { IDisposable } from '../dispose/disposable.js';
 import { DisposedError } from '../dispose/disposedError.js';
 import type { EventHandler, EventRegister, IEventEmitter } from './type.js';
 
+const anonymousName = 'AnonymousEmitter';
+
 /**
  * @public
  */
@@ -14,7 +17,7 @@ export class Emitter<T = unknown> implements IEventEmitter<T> {
 	private executing = false;
 	private _something_change_during_call = false;
 
-	constructor(public readonly displayName: string = 'AnonymousEmitter') {
+	constructor(public readonly displayName: string = anonymousName) {
 		this.handle = Object.defineProperties(this.handle.bind(this), {
 			once: {
 				get: () => this.once.bind(this),
@@ -26,6 +29,9 @@ export class Emitter<T = unknown> implements IEventEmitter<T> {
 				get: () => this._disposed,
 			},
 		});
+		defineInspectMethod(this.handle, (_depth, options) => {
+			return options.stylize(`[EmitterRegister ${this.displayName}]`, 'special');
+		});
 	}
 
 	public listenerCount() {
@@ -181,6 +187,17 @@ export class Emitter<T = unknown> implements IEventEmitter<T> {
 
 	readonly [Symbol.dispose] = this.dispose;
 
+	[inspectSymbol](_depth: number, options: any) {
+		let r = `${options.stylize(this.constructor.name, 'name')} {`;
+		if (this.displayName !== anonymousName) {
+			r += ` ${options.stylize(this.displayName, 'string')},`;
+		}
+		r += ` listeners: ${options.stylize(this.listenerCount(), 'number')}`;
+
+		r += ' }';
+		return r;
+	}
+
 	private requireNotExecuting() {
 		if (this.executing) {
 			throw new Error('conflict state, emitter is firing');

package/src/schedule/interval.ts

@@ -1,3 +1,4 @@
+import { inspectSymbol } from '../debugging/inspect.js';
 import { objectName } from '../debugging/object-with-name.js';
 import type { IDisposable } from '../lifecycle/dispose/disposable.js';
 import { EnhancedDisposable } from '../lifecycle/dispose/sync-disposable.js';
@@ -61,4 +62,15 @@ export class Interval extends EnhancedDisposable {
 		if (this.timer) this.timer.dispose();
 		return super.dispose();
 	}
+
+	[inspectSymbol](depth: number, options: any, inspect: any) {
+		if (depth < 0) {
+			return options.stylize(`[Interval ${this.ms}ms]`, 'special');
+		}
+		let r = `${options.stylize(this.constructor.name, 'name')} ${options.stylize(`${this.ms}`, 'number')}ms`;
+		const padding = ' '.repeat(2);
+		const inner = inspect(this._emitter, options, inspect).replace(/\n/g, `\n${padding}`);
+		r += ` {\n${padding}onTick: ${inner}\n}`;
+		return r;
+	}
 }