rockbed 0.1.0

package/dist/async/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/error/error-t.ts","../../src/error/error-const.ts","../../src/error/error-code.ts","../../src/dispose/dispose-base.ts","../../src/dispose/disposable-t.ts","../../src/dispose/disposable-utils.ts","../../src/async/promise.ts","../../src/async/wait.ts","../../src/async/barrier.ts"],"sourcesContent":["import type { ILvErrorRef, ILvErrorOr, ILvRealErrorRef } from './error-base';\n\n//\n// Error类\n//\n// 用户给函数签名明确错误\n// function foo(): ILvErrorRef\n//   return makeOk();  // 如果没有错误\n//   return makeError(code, msg);  // 指定错误码和携带消息\n//\n//   const SomeError = LvErrorConst(code, msg);  // 更推荐用LvErrorConst生成\n//   return SomeError();\n//\n\nconst lvErrorRefSymbol = Symbol('lvErrorRef');\n\nexport function makeOk(): ILvErrorOr<never> {\n  return {\n    ok: true,\n    value: null!,\n    pair() {\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n      return [null, null!] as any;\n    },\n    code: 0,\n    msg: '',\n    ...{ [lvErrorRefSymbol]: true }, // 跳过类型检测\n  };\n}\n\nexport function makeOkWith<T>(value: T): ILvErrorOr<T> {\n  return {\n    ok: true,\n    value,\n    pair() {\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n      return [null, value] as any;\n    },\n    code: 0,\n    msg: '',\n    ...{ [lvErrorRefSymbol]: true }, // 跳过类型检测\n  };\n}\n\nfunction printCause(cause: ILvErrorRef | Error | undefined): string {\n  if (cause === undefined) {\n    return '';\n  } else if (cause instanceof Error) {\n    return `\\ncaused by [jsError]${cause.name}-${cause.message}`;\n  } else {\n    return `\\ncaused by [${cause.code}]${cause.msg}${cause.ok ? '' : printCause(cause.cause)}`;\n  }\n}\n\nfunction internalMakeError(\n  code: number,\n  msg: string,\n  cause?: ILvErrorRef | Error,\n  errorInfo?: unknown,\n) {\n  const errorRef: ILvRealErrorRef = {\n    ok: false,\n    code,\n    msg,\n    cause,\n    errorInfo,\n    toString() {\n      return `[${code}]${msg}.${cause ? printCause(cause) : ''}`;\n    },\n    pair() {\n      return [errorRef, null];\n    },\n    ...{ [lvErrorRefSymbol]: true }, // 跳过类型检测\n  };\n  return errorRef;\n}\n\nexport function makeError(code: number, msg: string, errorInfo?: unknown): ILvRealErrorRef {\n  return internalMakeError(code, msg, undefined, errorInfo);\n}\n\nexport function makeErrorBy(\n  code: number,\n  msg: string,\n  cause: ILvErrorRef | Error,\n  errorInfo?: unknown,\n): ILvRealErrorRef {\n  return internalMakeError(code, msg, cause, errorInfo);\n}\n\nexport function isLvErrorRef(val: unknown): val is ILvErrorRef {\n  return typeof val === 'object' && val !== null && lvErrorRefSymbol in val;\n}\n","import { makeError, makeErrorBy } from './error-t';\n\n//\n// Error编译时错误对象\n//\nexport function lvErrorConst(code: number, msg: string) {\n  return (rewrite?: string | Error) => {\n    if (!rewrite) {\n      return makeError(code, msg);\n    }\n    if (typeof rewrite === 'string') {\n      return makeError(code, rewrite);\n    }\n    return makeErrorBy(code, rewrite.message, rewrite);\n  };\n}\n","import { lvErrorConst } from './error-const';\n\n/**\n * 提供了通用的错误码(+1至+256)\n *\n * 注意：这里只是提供了通用的错误码，方便服务使用，但并不是要求服务一定使用如下的错误码来表明某种错误\n */\nexport enum GenericError {\n  Ok = 0,\n  Cancelled = 1, // 操作被取消\n  TimedOut = 2, // 操作超时\n  PermissionDenied = 3, // 无权限\n  AlreadyExists = 4, // 已经存在(文件/记录等)\n  NotSupported = 5, // 操作不支持\n  ResourceUnavailable = 6, // 资源不可用\n  OutOfRange = 7, // (参数/结果等)发生越界\n  InvalidArgument = 8, // 无效参数\n  NetworkFailed = 9, // 网络失败\n  Interrupted = 10, // 操作被中断(捕获异常转为错误)\n  ResultNil = 11, // 结果不存在(null or undefined转为错误)\n}\n\n/**\n * 通用错误码所对应的编译时常量对象(ErrorConst)\n */\nexport const cancelledError = lvErrorConst(GenericError.Cancelled, 'operation(s) cancelled.');\nexport const timeoutError = lvErrorConst(GenericError.TimedOut, 'operation(s) timed out.');\nexport const permissionDeniedError = lvErrorConst(\n  GenericError.PermissionDenied,\n  'permission denied.',\n);\nexport const alreadyExistsError = lvErrorConst(GenericError.AlreadyExists, 'already exists.');\nexport const notSupportedError = lvErrorConst(\n  GenericError.NotSupported,\n  'operation(s) not supported.',\n);\nexport const resourceUnavailableError = lvErrorConst(\n  GenericError.ResourceUnavailable,\n  'resource is unavailable.',\n);\nexport const outOfRangeError = lvErrorConst(GenericError.OutOfRange, 'out of range.');\nexport const invalidArgumentError = lvErrorConst(\n  GenericError.InvalidArgument,\n  'invalid arguments.',\n);\nexport const networkFailedError = lvErrorConst(GenericError.NetworkFailed, 'network failed.');\nexport const interruptedError = lvErrorConst(GenericError.Interrupted, 'interrupted.');\nexport const resultNilError = lvErrorConst(GenericError.ResultNil, 'result is nil.');\n","//\n// Disposable特征约束\n//\nexport interface IDisposable {\n  dispose: () => void;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-function\nexport const EmptyDispose = Object.freeze<IDisposable>({ dispose() {} });\n","import { DisposableStore } from './disposable-store';\nimport type { IDisposable } from './dispose-base';\nimport { BRANCH_DISPOSE } from './logger';\n\n//\n// Disposable基类\n//\n// 自动添加DisposableStore，提供默认的dispose和register方法\n//\nexport abstract class Disposable implements IDisposable {\n  protected readonly _store = new DisposableStore();\n\n  // 销毁该节点和所有的子节点\n  dispose(): void {\n    BRANCH_DISPOSE(this.constructor.name, this._store.constructor.name);\n\n    this._store.dispose();\n  }\n\n  // 挂载子节点\n  protected _register<T extends IDisposable>(o: T): T {\n    if ((o as unknown as Disposable) === this) {\n      throw new Error('Cannot register a disposable on itself!');\n    }\n    return this._store.add(o);\n  }\n}\n\nexport class MutableDisposable<T extends IDisposable> implements IDisposable {\n  private _value?: T;\n  private _isDisposed = false;\n\n  constructor(value?: T) {\n    this.value = value;\n  }\n\n  get value(): T | undefined {\n    return this._isDisposed ? undefined : this._value;\n  }\n\n  set value(value: T | undefined) {\n    if (this._isDisposed || value === this._value) {\n      return;\n    }\n\n    this._value?.dispose();\n    this._value = value;\n  }\n\n  clear(): void {\n    this.value = undefined;\n  }\n\n  dispose(): void {\n    this._isDisposed = true;\n    this._value?.dispose();\n    this._value = undefined;\n  }\n\n  release(): T | undefined {\n    const oldValue = this._value;\n    this._value = undefined;\n    return oldValue;\n  }\n}\n\nexport class SafeDisposable<T extends IDisposable> implements IDisposable {\n  private _value: T | null = null;\n\n  constructor(value: T) {\n    this._value = value;\n  }\n\n  isEmpty() {\n    return this._value === null;\n  }\n\n  dispose() {\n    if (!this._value) {\n      return;\n    }\n    this._value.dispose();\n    this._value = null;\n  }\n}\n","import { SafeDisposable } from './disposable-t';\nimport { EmptyDispose } from './dispose-base';\n\nexport function makeSafeDisposable(fn: (...args: any) => any) {\n  const disposable = new SafeDisposable({\n    dispose: fn,\n  });\n  return disposable;\n}\n\nexport function makeEmptyDisposable() {\n  return EmptyDispose;\n}\n","/* eslint-disable @typescript-eslint/prefer-promise-reject-errors */\nimport {\n  makeOkWith,\n  type ILvErrorOr,\n  cancelledError,\n  GenericError,\n  timeoutError,\n  type ILvErrorRef,\n  makeOk,\n  isLvErrorRef,\n} from '../error';\nimport { EmptyDispose, makeSafeDisposable, type IDisposable } from '../dispose';\n\nexport interface ICancellationToken {\n  readonly isCancellationRequested: boolean;\n  readonly reason?: string;\n  readonly onCancellationRequested: (\n    listener: () => any,\n    thisArgs?: any,\n  ) => IDisposable;\n}\n\nconst shortcutCancellationEvent = (callback: () => any, context?: any): IDisposable => {\n  const handle = setTimeout(callback.bind(context), 0);\n  return makeSafeDisposable(() => clearTimeout(handle));\n};\n\nclass MutableToken implements ICancellationToken, IDisposable {\n  private _isCancelled = false;\n  private _reason?: string;\n  private readonly _listeners = new Set<() => void>();\n\n  get isCancellationRequested(): boolean {\n    return this._isCancelled;\n  }\n\n  get reason(): string | undefined {\n    return this._reason;\n  }\n\n  onCancellationRequested(listener: () => any, thisArgs?: any): IDisposable {\n    if (this._isCancelled) {\n      return shortcutCancellationEvent(listener, thisArgs);\n    }\n\n    const wrappedListener = listener.bind(thisArgs);\n    this._listeners.add(wrappedListener);\n    return makeSafeDisposable(() => {\n      this._listeners.delete(wrappedListener);\n    });\n  }\n\n  cancel(reason?: string): void {\n    if (this._isCancelled) {\n      return;\n    }\n\n    this._reason = reason;\n    this._isCancelled = true;\n    for (const listener of this._listeners) {\n      listener();\n    }\n    this._listeners.clear();\n  }\n\n  dispose(): void {\n    this._listeners.clear();\n  }\n}\n\nexport class CancellationToken {\n  static None = Object.freeze<ICancellationToken>({\n    isCancellationRequested: false,\n    onCancellationRequested: () => EmptyDispose,\n  });\n\n  static Cancelled = Object.freeze<ICancellationToken>({\n    isCancellationRequested: true,\n    onCancellationRequested: shortcutCancellationEvent,\n  });\n\n  static Make(reason: string): ICancellationToken {\n    return Object.freeze<ICancellationToken>({\n      isCancellationRequested: true,\n      onCancellationRequested: shortcutCancellationEvent,\n      reason,\n    });\n  }\n}\n\nexport class CancellationTokenSource implements IDisposable {\n  private _token?: ICancellationToken;\n  private _abortController?: AbortController;\n\n  get token(): ICancellationToken {\n    if (!this._token) {\n      this._token = new MutableToken();\n    }\n    return this._token;\n  }\n\n  get signal(): AbortSignal {\n    if (!this._abortController) {\n      this._abortController = new AbortController();\n    }\n    if (this._token?.isCancellationRequested) {\n      this._abortController.abort(this._token.reason);\n    }\n    return this._abortController.signal;\n  }\n\n  cancel(reason?: string): void {\n    if (!this._token) {\n      this._token =\n        reason === undefined ? CancellationToken.Cancelled : CancellationToken.Make(reason);\n    } else if (this._token instanceof MutableToken) {\n      this._token.cancel(reason);\n    }\n    this._abortController?.abort(reason);\n  }\n\n  dispose(cancel = false): void {\n    if (cancel) {\n      this.cancel();\n    }\n    if (!this._token) {\n      this._token = CancellationToken.None;\n    } else if (this._token instanceof MutableToken) {\n      this._token.dispose();\n    }\n  }\n}\n\n/**\n * 一般来说Promise常用的场景有：\n * 1. 单次异步调用（new Promise）\n * 2. 批量promise调用（Promise.all）\n * 3. promise竞速调用（Promise.race）\n *\n * 但是原生能力有如下的缺陷\n * 1. 不支持取消某一次promise调用\n * 2. 不支持错误语义，promise.catch的重视程度比try catch还低\n * 3. 超时行为需要基于race封装\n *\n * 针对这三点，基建侧提供了高阶的promise能力\n * 1. makeCancelablePromise 返回一个可取消的promise\n * const promise = makeCancelablePromise(() => { ... });\n * promise.then((res) => {\n *   // res是一个ILvErrorRef对象\n * });\n * // 可以直接取消promise\n * promise.cancel();\n *\n * 2. parallelPromise 并发执行promise，会自动观测ILvErrorRef语义\n * 当单个promise出现错误返回时，promise执行失败，尽可能调用所有cancelablePromise\n * 当单个promise出现reject时，promise执行失败，尽可能调用所有cancelablePromise，并且将reject继续上抛\n *\n * 3. makePromiseWithTimeout 让promise支持超时，可以提供默认值\n *\n * ——————————————————\n * Promise.allSettled和Promise.any在实际使用中场景较少，暂不提供错误语义包装\n */\n\n//\n// 可以cancel的promise对象\n//\nexport interface CancelablePromise<T> extends Promise<T> {\n  cancel: () => void;\n}\n\n/**\n * 快速生成一个CancelablePromise对象\n */\nexport function makeCancelablePromise<T>(\n  callback: (token: ICancellationToken) => Promise<T | ILvErrorOr<T>>,\n): CancelablePromise<ILvErrorOr<T>> {\n  const source = new CancellationTokenSource();\n  const thenable = callback(source.token);\n  const promise = new Promise<ILvErrorOr<T>>((resolve, reject) => {\n    const subscription = source.token.onCancellationRequested(() => {\n      subscription.dispose();\n      source.dispose();\n      resolve(cancelledError());\n    });\n    Promise.resolve(thenable).then(\n      (value) => {\n        subscription.dispose();\n        source.dispose();\n        if (isLvErrorRef(value)) {\n          resolve(value);\n        } else {\n          resolve(makeOkWith(value as T));\n        }\n      },\n      (err) => {\n        subscription.dispose();\n        source.dispose();\n        reject(err);\n      },\n    );\n  });\n  return new (class {\n    cancel() {\n      source.cancel();\n    }\n    then<TResult1 = T, TResult2 = never>(\n      resolve?: ((value: ILvErrorOr<T>) => TResult1 | Promise<TResult1>) | null,\n      reject?: ((reason: any) => TResult2 | Promise<TResult2>) | null,\n    ): Promise<TResult1 | TResult2> {\n      return promise.then(resolve, reject);\n    }\n    catch<TResult = never>(\n      reject?: ((reason: any) => TResult | Promise<TResult>) | null,\n    ): Promise<T | TResult> {\n      return this.then(undefined, reject);\n    }\n    finally(onfinally?: (() => void) | null): Promise<ILvErrorOr<T>> {\n      return promise.finally(onfinally);\n    }\n  })() as CancelablePromise<ILvErrorOr<T>>;\n}\n\n/**\n * 并行执行promise，当某一个失败，本次调用失败\n * 本质上和Promise.all差不多，相比较之下\n * 1. 包装了错误语义判断\n * 2. 当失败时，会尽可能尝试cancel其他promise\n *\n * 注意：某一个promise失败时，会尽可能尝试调用其他promise的cancel，但不保证一定有效\n * （有可能promiseA已经成功，但是primiseB在之后失败了）\n */\nexport function parallelPromise(promiseList: Promise<any>[]): Promise<ILvErrorRef> {\n  if (promiseList.length === 0) {\n    return Promise.resolve(makeOk());\n  }\n\n  let todo = promiseList.length;\n  const finish = () => {\n    todo = -1;\n    for (const promise of promiseList) {\n      (promise as Partial<CancelablePromise<any>>).cancel?.();\n    }\n  };\n\n  return new Promise<ILvErrorRef>((resolve, reject) => {\n    for (const promise of promiseList) {\n      promise\n\n        .then((res) => {\n          if (isLvErrorRef(res) && !res.ok) {\n            finish();\n            resolve(res as ILvErrorRef);\n            return;\n          }\n          todo--;\n          if (todo === 0) {\n            resolve(makeOk());\n          }\n        })\n        .catch((err) => {\n          finish();\n          reject(err);\n        });\n    }\n  });\n}\n\n/**\n * 包装一个promise，提供超时能力\n */\nexport function makePromiseWithTimeout<T>(\n  callback: (token: ICancellationToken) => Promise<T | ILvErrorOr<T>>,\n  timeout: number,\n  defaultValue?: T, // 当发生超时时，提供的默认值\n): Promise<ILvErrorOr<T>> {\n  const cancellable = makeCancelablePromise<T>(callback);\n  const timer = setTimeout(() => {\n    cancellable.cancel();\n  }, timeout);\n  return cancellable.then((res: ILvErrorOr<T>) => {\n    clearTimeout(timer);\n    if (res.ok) {\n      return res;\n    }\n    // 如果是被取消，触发了超时\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-enum-comparison\n    if (res.code === GenericError.Cancelled) {\n      if (defaultValue !== undefined) {\n        // 希望返回默认值\n        return makeOkWith(defaultValue);\n      }\n      return timeoutError();\n    } else {\n      // 遇到其他错误时透传错误\n      return res;\n    }\n  });\n}\n\n// 如果 proposal-promise-with-resolvers 通过了，那么这个函数就可以去掉了\n// https://github.com/microsoft/TypeScript/blob/1d96eb489e559f4f61522edb3c8b5987bbe948af/src/harness/util.ts#L115\nexport interface Deferred<T> {\n  resolve: (value: T | PromiseLike<T>) => void;\n  reject: (reason: unknown) => void;\n  promise: Promise<T>;\n}\n\nexport function defer<T = void>(): Deferred<T> {\n  let resolve!: (value: T | PromiseLike<T>) => void;\n  let reject!: (reason: unknown) => void;\n  const promise = new Promise<T>((_resolve, _reject) => {\n    resolve = _resolve;\n    reject = _reject;\n  });\n  return { resolve, reject, promise };\n}\n","/**\n * 等待一段时间\n * @param ms 单位毫秒\n */\nexport function wait(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","export interface IBarrier {\n  isOpen: () => boolean;\n  open: () => void;\n  wait: () => Promise<boolean>;\n}\n\n/**\n * A barrier that is initially closed and then becomes opened permanently after a certain period of\n * time or when open is called explicitly\n */\nexport class Barrier {\n  private _isOpen: boolean;\n  private readonly _promise: Promise<boolean>;\n  private _completePromise!: (v: boolean) => void;\n\n  constructor() {\n    this._isOpen = false;\n    this._promise = new Promise<boolean>((c, e) => {\n      this._completePromise = c;\n    });\n  }\n\n  isOpen(): boolean {\n    return this._isOpen;\n  }\n\n  open(): void {\n    this._isOpen = true;\n    this._completePromise(true);\n  }\n\n  wait(): Promise<boolean> {\n    return this._promise;\n  }\n}\n\nexport function makeBarrierByPromise(promise: Promise<any>, openWhenReject: boolean = false) {\n  const barrier = new Barrier();\n  promise.then(() => barrier.open());\n  if (openWhenReject) {\n    promise.catch((err) => {\n      barrier.open();\n      throw err;\n    });\n  }\n  return barrier;\n}\n"],"mappings":"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","names":[]}

package/dist/dispose/index.d.ts

@@ -0,0 +1,47 @@
+import { I as IDisposable } from '../dispose-base-CAeXDpjg.js';
+export { E as EmptyDispose } from '../dispose-base-CAeXDpjg.js';
+
+declare class DisposableStore implements IDisposable {
+    static DISABLE_DISPOSED_WARNING: boolean;
+    private readonly _toDispose;
+    private _isDisposed;
+    get isDisposed(): boolean;
+    dispose(): void;
+    clear(): void;
+    add<T extends IDisposable>(o: T): T;
+}
+
+declare abstract class Disposable implements IDisposable {
+    protected readonly _store: DisposableStore;
+    dispose(): void;
+    protected _register<T extends IDisposable>(o: T): T;
+}
+declare class MutableDisposable<T extends IDisposable> implements IDisposable {
+    private _value?;
+    private _isDisposed;
+    constructor(value?: T);
+    get value(): T | undefined;
+    set value(value: T | undefined);
+    clear(): void;
+    dispose(): void;
+    release(): T | undefined;
+}
+declare class SafeDisposable<T extends IDisposable> implements IDisposable {
+    private _value;
+    constructor(value: T);
+    isEmpty(): boolean;
+    dispose(): void;
+}
+
+declare function makeSafeDisposable(fn: (...args: any) => any): SafeDisposable<{
+    dispose: (...args: any) => any;
+}>;
+declare function makeEmptyDisposable(): Readonly<IDisposable>;
+
+interface IDisposableLogger {
+    branch: (from: string, to: string) => void;
+    end: () => void;
+}
+declare function disposeWithLog<T extends IDisposable>(x: T, logger?: IDisposableLogger): void;
+
+export { Disposable, DisposableStore, IDisposable, type IDisposableLogger, MutableDisposable, SafeDisposable, disposeWithLog, makeEmptyDisposable, makeSafeDisposable };

package/dist/dispose/index.js

@@ -0,0 +1,166 @@
+// src/dispose/dispose-base.ts
+var EmptyDispose = Object.freeze({ dispose() {
+} });
+
+// src/dispose/logger.ts
+var disposableLogger = null;
+function setDisposableLogger(logger) {
+  disposableLogger = logger;
+}
+function makeDefaultLogger() {
+  return new class {
+    _dep = [];
+    branch(from, to) {
+      this._dep.push([from, to]);
+    }
+    end() {
+    }
+  }();
+}
+function BRANCH_DISPOSE(from, to) {
+  disposableLogger?.branch(from, to);
+}
+function disposeWithLog(x, logger = makeDefaultLogger()) {
+  setDisposableLogger(logger);
+  x.dispose();
+  logger.end();
+  setDisposableLogger(null);
+}
+
+// src/dispose/disposable-store.ts
+var DisposableStore = class _DisposableStore {
+  static DISABLE_DISPOSED_WARNING = false;
+  _toDispose = /* @__PURE__ */ new Set();
+  _isDisposed = false;
+  get isDisposed() {
+    return this._isDisposed;
+  }
+  dispose() {
+    if (this._isDisposed) {
+      console.warn(new Error("DisposableStore has disposed.").stack);
+      return;
+    }
+    this._isDisposed = true;
+    this.clear();
+  }
+  clear() {
+    if (this._toDispose.size === 0) {
+      return;
+    }
+    for (const disposable of this._toDispose) {
+      BRANCH_DISPOSE(this.constructor.name, disposable.constructor.name);
+    }
+    try {
+      for (const disposable of this._toDispose) {
+        disposable.dispose();
+      }
+    } finally {
+      this._toDispose.clear();
+    }
+  }
+  add(o) {
+    if (!o) {
+      return o;
+    }
+    if (o === this) {
+      throw new Error("Cannot register a disposable on itself.");
+    }
+    if (this._isDisposed) {
+      if (!_DisposableStore.DISABLE_DISPOSED_WARNING) {
+        console.warn(
+          new Error(
+            "Trying to add a disposable to a DisposableStore that has already been disposed of. The added object will be leaked!"
+          ).stack
+        );
+      }
+    } else {
+      this._toDispose.add(o);
+    }
+    return o;
+  }
+};
+
+// src/dispose/disposable-t.ts
+var Disposable = class {
+  _store = new DisposableStore();
+  // 销毁该节点和所有的子节点
+  dispose() {
+    BRANCH_DISPOSE(this.constructor.name, this._store.constructor.name);
+    this._store.dispose();
+  }
+  // 挂载子节点
+  _register(o) {
+    if (o === this) {
+      throw new Error("Cannot register a disposable on itself!");
+    }
+    return this._store.add(o);
+  }
+};
+var MutableDisposable = class {
+  _value;
+  _isDisposed = false;
+  constructor(value) {
+    this.value = value;
+  }
+  get value() {
+    return this._isDisposed ? void 0 : this._value;
+  }
+  set value(value) {
+    if (this._isDisposed || value === this._value) {
+      return;
+    }
+    this._value?.dispose();
+    this._value = value;
+  }
+  clear() {
+    this.value = void 0;
+  }
+  dispose() {
+    this._isDisposed = true;
+    this._value?.dispose();
+    this._value = void 0;
+  }
+  release() {
+    const oldValue = this._value;
+    this._value = void 0;
+    return oldValue;
+  }
+};
+var SafeDisposable = class {
+  _value = null;
+  constructor(value) {
+    this._value = value;
+  }
+  isEmpty() {
+    return this._value === null;
+  }
+  dispose() {
+    if (!this._value) {
+      return;
+    }
+    this._value.dispose();
+    this._value = null;
+  }
+};
+
+// src/dispose/disposable-utils.ts
+function makeSafeDisposable(fn) {
+  const disposable = new SafeDisposable({
+    dispose: fn
+  });
+  return disposable;
+}
+function makeEmptyDisposable() {
+  return EmptyDispose;
+}
+export {
+  Disposable,
+  DisposableStore,
+  EmptyDispose,
+  MutableDisposable,
+  SafeDisposable,
+  disposeWithLog,
+  makeEmptyDisposable,
+  makeSafeDisposable
+};
+//# sourceMappingURL=index.js.map

package/dist/dispose/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/dispose/dispose-base.ts","../../src/dispose/logger.ts","../../src/dispose/disposable-store.ts","../../src/dispose/disposable-t.ts","../../src/dispose/disposable-utils.ts"],"sourcesContent":["//\n// Disposable特征约束\n//\nexport interface IDisposable {\n  dispose: () => void;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-function\nexport const EmptyDispose = Object.freeze<IDisposable>({ dispose() {} });\n","import type { IDisposable } from './dispose-base';\n\nlet disposableLogger: IDisposableLogger | null = null;\n\nexport interface IDisposableLogger {\n  branch: (from: string, to: string) => void;\n  end: () => void;\n}\n\nfunction setDisposableLogger(logger: IDisposableLogger | null): void {\n  disposableLogger = logger;\n}\n\nfunction makeDefaultLogger() {\n  return new (class implements IDisposableLogger {\n    private readonly _dep: [string, string][] = [];\n\n    branch(from: string, to: string): void {\n      this._dep.push([from, to]);\n    }\n\n    end(): void {\n      // console.log(this._dep);\n    }\n  })();\n}\n\n// 辅助能力 dispose触发时记录\nexport function BRANCH_DISPOSE(from: string, to: string) {\n  disposableLogger?.branch(from, to);\n}\n\nexport function disposeWithLog<T extends IDisposable>(\n  x: T,\n  logger: IDisposableLogger = makeDefaultLogger(),\n) {\n  setDisposableLogger(logger);\n  x.dispose();\n  logger.end();\n  setDisposableLogger(null);\n}\n","import type { IDisposable } from './dispose-base';\nimport { BRANCH_DISPOSE } from './logger';\n\nexport class DisposableStore implements IDisposable {\n  static DISABLE_DISPOSED_WARNING = false;\n\n  private readonly _toDispose = new Set<IDisposable>();\n  private _isDisposed = false;\n\n  get isDisposed(): boolean {\n    return this._isDisposed;\n  }\n\n  dispose(): void {\n    if (this._isDisposed) {\n      // 不应该出现重复dispose\n      /* eslint-disable no-console */\n      console.warn(new Error('DisposableStore has disposed.').stack);\n      return;\n    }\n\n    this._isDisposed = true;\n    this.clear();\n  }\n\n  clear(): void {\n    if (this._toDispose.size === 0) {\n      return;\n    }\n\n    for (const disposable of this._toDispose) {\n      BRANCH_DISPOSE(this.constructor.name, disposable.constructor.name);\n    }\n\n    try {\n      // TODO(vorshen): 考虑异常情况\n      for (const disposable of this._toDispose) {\n        disposable.dispose();\n      }\n    } finally {\n      this._toDispose.clear();\n    }\n  }\n\n  add<T extends IDisposable>(o: T): T {\n    if (!o) {\n      return o;\n    }\n    if ((o as unknown as DisposableStore) === this) {\n      throw new Error('Cannot register a disposable on itself.');\n    }\n\n    if (this._isDisposed) {\n      if (!DisposableStore.DISABLE_DISPOSED_WARNING) {\n        /* eslint-disable no-console */\n        console.warn(\n          new Error(\n            'Trying to add a disposable to a DisposableStore that has already been disposed of. The added object will be leaked!',\n          ).stack,\n        );\n      }\n    } else {\n      this._toDispose.add(o);\n    }\n\n    return o;\n  }\n}\n","import { DisposableStore } from './disposable-store';\nimport type { IDisposable } from './dispose-base';\nimport { BRANCH_DISPOSE } from './logger';\n\n//\n// Disposable基类\n//\n// 自动添加DisposableStore，提供默认的dispose和register方法\n//\nexport abstract class Disposable implements IDisposable {\n  protected readonly _store = new DisposableStore();\n\n  // 销毁该节点和所有的子节点\n  dispose(): void {\n    BRANCH_DISPOSE(this.constructor.name, this._store.constructor.name);\n\n    this._store.dispose();\n  }\n\n  // 挂载子节点\n  protected _register<T extends IDisposable>(o: T): T {\n    if ((o as unknown as Disposable) === this) {\n      throw new Error('Cannot register a disposable on itself!');\n    }\n    return this._store.add(o);\n  }\n}\n\nexport class MutableDisposable<T extends IDisposable> implements IDisposable {\n  private _value?: T;\n  private _isDisposed = false;\n\n  constructor(value?: T) {\n    this.value = value;\n  }\n\n  get value(): T | undefined {\n    return this._isDisposed ? undefined : this._value;\n  }\n\n  set value(value: T | undefined) {\n    if (this._isDisposed || value === this._value) {\n      return;\n    }\n\n    this._value?.dispose();\n    this._value = value;\n  }\n\n  clear(): void {\n    this.value = undefined;\n  }\n\n  dispose(): void {\n    this._isDisposed = true;\n    this._value?.dispose();\n    this._value = undefined;\n  }\n\n  release(): T | undefined {\n    const oldValue = this._value;\n    this._value = undefined;\n    return oldValue;\n  }\n}\n\nexport class SafeDisposable<T extends IDisposable> implements IDisposable {\n  private _value: T | null = null;\n\n  constructor(value: T) {\n    this._value = value;\n  }\n\n  isEmpty() {\n    return this._value === null;\n  }\n\n  dispose() {\n    if (!this._value) {\n      return;\n    }\n    this._value.dispose();\n    this._value = null;\n  }\n}\n","import { SafeDisposable } from './disposable-t';\nimport { EmptyDispose } from './dispose-base';\n\nexport function makeSafeDisposable(fn: (...args: any) => any) {\n  const disposable = new SafeDisposable({\n    dispose: fn,\n  });\n  return disposable;\n}\n\nexport function makeEmptyDisposable() {\n  return EmptyDispose;\n}\n"],"mappings":"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","names":[]}

package/dist/dispose-base-CAeXDpjg.d.ts

@@ -0,0 +1,6 @@
+interface IDisposable {
+    dispose: () => void;
+}
+declare const EmptyDispose: Readonly<IDisposable>;
+
+export { EmptyDispose as E, type IDisposable as I };

package/dist/error/index.d.ts

@@ -0,0 +1,46 @@
+import { b as ILvRealErrorRef, a as ILvErrorRef, I as ILvErrorOr } from '../error-base-BWuBlS2k.js';
+export { c as ILvValueRef } from '../error-base-BWuBlS2k.js';
+
+declare function lvErrorConst(code: number, msg: string): (rewrite?: string | Error) => ILvRealErrorRef;
+
+declare function makeOk(): ILvErrorOr<never>;
+declare function makeOkWith<T>(value: T): ILvErrorOr<T>;
+declare function makeError(code: number, msg: string, errorInfo?: unknown): ILvRealErrorRef;
+declare function makeErrorBy(code: number, msg: string, cause: ILvErrorRef | Error, errorInfo?: unknown): ILvRealErrorRef;
+declare function isLvErrorRef(val: unknown): val is ILvErrorRef;
+
+/**
+ * 提供了通用的错误码(+1至+256)
+ *
+ * 注意：这里只是提供了通用的错误码，方便服务使用，但并不是要求服务一定使用如下的错误码来表明某种错误
+ */
+declare enum GenericError {
+    Ok = 0,
+    Cancelled = 1,// 操作被取消
+    TimedOut = 2,// 操作超时
+    PermissionDenied = 3,// 无权限
+    AlreadyExists = 4,// 已经存在(文件/记录等)
+    NotSupported = 5,// 操作不支持
+    ResourceUnavailable = 6,// 资源不可用
+    OutOfRange = 7,// (参数/结果等)发生越界
+    InvalidArgument = 8,// 无效参数
+    NetworkFailed = 9,// 网络失败
+    Interrupted = 10,// 操作被中断(捕获异常转为错误)
+    ResultNil = 11
+}
+/**
+ * 通用错误码所对应的编译时常量对象(ErrorConst)
+ */
+declare const cancelledError: (rewrite?: string | Error) => ILvRealErrorRef;
+declare const timeoutError: (rewrite?: string | Error) => ILvRealErrorRef;
+declare const permissionDeniedError: (rewrite?: string | Error) => ILvRealErrorRef;
+declare const alreadyExistsError: (rewrite?: string | Error) => ILvRealErrorRef;
+declare const notSupportedError: (rewrite?: string | Error) => ILvRealErrorRef;
+declare const resourceUnavailableError: (rewrite?: string | Error) => ILvRealErrorRef;
+declare const outOfRangeError: (rewrite?: string | Error) => ILvRealErrorRef;
+declare const invalidArgumentError: (rewrite?: string | Error) => ILvRealErrorRef;
+declare const networkFailedError: (rewrite?: string | Error) => ILvRealErrorRef;
+declare const interruptedError: (rewrite?: string | Error) => ILvRealErrorRef;
+declare const resultNilError: (rewrite?: string | Error) => ILvRealErrorRef;
+
+export { GenericError, ILvErrorOr, ILvErrorRef, ILvRealErrorRef, alreadyExistsError, cancelledError, interruptedError, invalidArgumentError, isLvErrorRef, lvErrorConst, makeError, makeErrorBy, makeOk, makeOkWith, networkFailedError, notSupportedError, outOfRangeError, permissionDeniedError, resourceUnavailableError, resultNilError, timeoutError };

package/dist/error/index.js

@@ -0,0 +1,150 @@
+// src/error/error-base.ts
+var ILvErrorRef = /* @__PURE__ */ Symbol.for("rockbed.ILvErrorRef");
+var ILvRealErrorRef = /* @__PURE__ */ Symbol.for("rockbed.ILvRealErrorRef");
+var ILvValueRef = /* @__PURE__ */ Symbol.for("rockbed.ILvValueRef");
+var ILvErrorOr = /* @__PURE__ */ Symbol.for("rockbed.ILvErrorOr");
+
+// src/error/error-t.ts
+var lvErrorRefSymbol = /* @__PURE__ */ Symbol("lvErrorRef");
+function makeOk() {
+  return {
+    ok: true,
+    value: null,
+    pair() {
+      return [null, null];
+    },
+    code: 0,
+    msg: "",
+    ...{ [lvErrorRefSymbol]: true }
+    // 跳过类型检测
+  };
+}
+function makeOkWith(value) {
+  return {
+    ok: true,
+    value,
+    pair() {
+      return [null, value];
+    },
+    code: 0,
+    msg: "",
+    ...{ [lvErrorRefSymbol]: true }
+    // 跳过类型检测
+  };
+}
+function printCause(cause) {
+  if (cause === void 0) {
+    return "";
+  } else if (cause instanceof Error) {
+    return `
+caused by [jsError]${cause.name}-${cause.message}`;
+  } else {
+    return `
+caused by [${cause.code}]${cause.msg}${cause.ok ? "" : printCause(cause.cause)}`;
+  }
+}
+function internalMakeError(code, msg, cause, errorInfo) {
+  const errorRef = {
+    ok: false,
+    code,
+    msg,
+    cause,
+    errorInfo,
+    toString() {
+      return `[${code}]${msg}.${cause ? printCause(cause) : ""}`;
+    },
+    pair() {
+      return [errorRef, null];
+    },
+    ...{ [lvErrorRefSymbol]: true }
+    // 跳过类型检测
+  };
+  return errorRef;
+}
+function makeError(code, msg, errorInfo) {
+  return internalMakeError(code, msg, void 0, errorInfo);
+}
+function makeErrorBy(code, msg, cause, errorInfo) {
+  return internalMakeError(code, msg, cause, errorInfo);
+}
+function isLvErrorRef(val) {
+  return typeof val === "object" && val !== null && lvErrorRefSymbol in val;
+}
+
+// src/error/error-const.ts
+function lvErrorConst(code, msg) {
+  return (rewrite) => {
+    if (!rewrite) {
+      return makeError(code, msg);
+    }
+    if (typeof rewrite === "string") {
+      return makeError(code, rewrite);
+    }
+    return makeErrorBy(code, rewrite.message, rewrite);
+  };
+}
+
+// src/error/error-code.ts
+var GenericError = /* @__PURE__ */ ((GenericError2) => {
+  GenericError2[GenericError2["Ok"] = 0] = "Ok";
+  GenericError2[GenericError2["Cancelled"] = 1] = "Cancelled";
+  GenericError2[GenericError2["TimedOut"] = 2] = "TimedOut";
+  GenericError2[GenericError2["PermissionDenied"] = 3] = "PermissionDenied";
+  GenericError2[GenericError2["AlreadyExists"] = 4] = "AlreadyExists";
+  GenericError2[GenericError2["NotSupported"] = 5] = "NotSupported";
+  GenericError2[GenericError2["ResourceUnavailable"] = 6] = "ResourceUnavailable";
+  GenericError2[GenericError2["OutOfRange"] = 7] = "OutOfRange";
+  GenericError2[GenericError2["InvalidArgument"] = 8] = "InvalidArgument";
+  GenericError2[GenericError2["NetworkFailed"] = 9] = "NetworkFailed";
+  GenericError2[GenericError2["Interrupted"] = 10] = "Interrupted";
+  GenericError2[GenericError2["ResultNil"] = 11] = "ResultNil";
+  return GenericError2;
+})(GenericError || {});
+var cancelledError = lvErrorConst(1 /* Cancelled */, "operation(s) cancelled.");
+var timeoutError = lvErrorConst(2 /* TimedOut */, "operation(s) timed out.");
+var permissionDeniedError = lvErrorConst(
+  3 /* PermissionDenied */,
+  "permission denied."
+);
+var alreadyExistsError = lvErrorConst(4 /* AlreadyExists */, "already exists.");
+var notSupportedError = lvErrorConst(
+  5 /* NotSupported */,
+  "operation(s) not supported."
+);
+var resourceUnavailableError = lvErrorConst(
+  6 /* ResourceUnavailable */,
+  "resource is unavailable."
+);
+var outOfRangeError = lvErrorConst(7 /* OutOfRange */, "out of range.");
+var invalidArgumentError = lvErrorConst(
+  8 /* InvalidArgument */,
+  "invalid arguments."
+);
+var networkFailedError = lvErrorConst(9 /* NetworkFailed */, "network failed.");
+var interruptedError = lvErrorConst(10 /* Interrupted */, "interrupted.");
+var resultNilError = lvErrorConst(11 /* ResultNil */, "result is nil.");
+export {
+  GenericError,
+  ILvErrorOr,
+  ILvErrorRef,
+  ILvRealErrorRef,
+  ILvValueRef,
+  alreadyExistsError,
+  cancelledError,
+  interruptedError,
+  invalidArgumentError,
+  isLvErrorRef,
+  lvErrorConst,
+  makeError,
+  makeErrorBy,
+  makeOk,
+  makeOkWith,
+  networkFailedError,
+  notSupportedError,
+  outOfRangeError,
+  permissionDeniedError,
+  resourceUnavailableError,
+  resultNilError,
+  timeoutError
+};
+//# sourceMappingURL=index.js.map

package/dist/error/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/error/error-base.ts","../../src/error/error-t.ts","../../src/error/error-const.ts","../../src/error/error-code.ts"],"sourcesContent":["//\n// lv项目中使用的错误类型\n//\n\nexport const ILvErrorRef = Symbol.for('rockbed.ILvErrorRef');\nexport type ILvErrorRef = ILvErrorOr<never>;\n\nexport const ILvRealErrorRef = Symbol.for('rockbed.ILvRealErrorRef');\nexport interface ILvRealErrorRef {\n  readonly ok: false;\n  readonly code: number;\n  readonly msg: string;\n  readonly cause?: ILvErrorRef | Error;\n  readonly toString: () => string;\n  readonly pair: () => [ILvRealErrorRef, null];\n  readonly errorInfo?: unknown;\n}\n\n//\n// 没有错误时，可以直接使用 value 字段\n//\nexport const ILvValueRef = Symbol.for('rockbed.ILvValueRef');\nexport interface ILvValueRef<T> {\n  readonly ok: true;\n  readonly code: 0;\n  readonly msg: '';\n  readonly cause?: undefined;\n  readonly value: T;\n  readonly toString: () => string;\n  readonly pair: () => [null, T];\n}\n\n//\n// lv项目中使用的携带值可能错误类型\n//\nexport const ILvErrorOr = Symbol.for('rockbed.ILvErrorOr');\nexport type ILvErrorOr<T> = (ILvRealErrorRef | ILvValueRef<T>) & {\n  readonly pair: () => [null, T] | [ILvRealErrorRef, null];\n};\n","import type { ILvErrorRef, ILvErrorOr, ILvRealErrorRef } from './error-base';\n\n//\n// Error类\n//\n// 用户给函数签名明确错误\n// function foo(): ILvErrorRef\n//   return makeOk();  // 如果没有错误\n//   return makeError(code, msg);  // 指定错误码和携带消息\n//\n//   const SomeError = LvErrorConst(code, msg);  // 更推荐用LvErrorConst生成\n//   return SomeError();\n//\n\nconst lvErrorRefSymbol = Symbol('lvErrorRef');\n\nexport function makeOk(): ILvErrorOr<never> {\n  return {\n    ok: true,\n    value: null!,\n    pair() {\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n      return [null, null!] as any;\n    },\n    code: 0,\n    msg: '',\n    ...{ [lvErrorRefSymbol]: true }, // 跳过类型检测\n  };\n}\n\nexport function makeOkWith<T>(value: T): ILvErrorOr<T> {\n  return {\n    ok: true,\n    value,\n    pair() {\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n      return [null, value] as any;\n    },\n    code: 0,\n    msg: '',\n    ...{ [lvErrorRefSymbol]: true }, // 跳过类型检测\n  };\n}\n\nfunction printCause(cause: ILvErrorRef | Error | undefined): string {\n  if (cause === undefined) {\n    return '';\n  } else if (cause instanceof Error) {\n    return `\\ncaused by [jsError]${cause.name}-${cause.message}`;\n  } else {\n    return `\\ncaused by [${cause.code}]${cause.msg}${cause.ok ? '' : printCause(cause.cause)}`;\n  }\n}\n\nfunction internalMakeError(\n  code: number,\n  msg: string,\n  cause?: ILvErrorRef | Error,\n  errorInfo?: unknown,\n) {\n  const errorRef: ILvRealErrorRef = {\n    ok: false,\n    code,\n    msg,\n    cause,\n    errorInfo,\n    toString() {\n      return `[${code}]${msg}.${cause ? printCause(cause) : ''}`;\n    },\n    pair() {\n      return [errorRef, null];\n    },\n    ...{ [lvErrorRefSymbol]: true }, // 跳过类型检测\n  };\n  return errorRef;\n}\n\nexport function makeError(code: number, msg: string, errorInfo?: unknown): ILvRealErrorRef {\n  return internalMakeError(code, msg, undefined, errorInfo);\n}\n\nexport function makeErrorBy(\n  code: number,\n  msg: string,\n  cause: ILvErrorRef | Error,\n  errorInfo?: unknown,\n): ILvRealErrorRef {\n  return internalMakeError(code, msg, cause, errorInfo);\n}\n\nexport function isLvErrorRef(val: unknown): val is ILvErrorRef {\n  return typeof val === 'object' && val !== null && lvErrorRefSymbol in val;\n}\n","import { makeError, makeErrorBy } from './error-t';\n\n//\n// Error编译时错误对象\n//\nexport function lvErrorConst(code: number, msg: string) {\n  return (rewrite?: string | Error) => {\n    if (!rewrite) {\n      return makeError(code, msg);\n    }\n    if (typeof rewrite === 'string') {\n      return makeError(code, rewrite);\n    }\n    return makeErrorBy(code, rewrite.message, rewrite);\n  };\n}\n","import { lvErrorConst } from './error-const';\n\n/**\n * 提供了通用的错误码(+1至+256)\n *\n * 注意：这里只是提供了通用的错误码，方便服务使用，但并不是要求服务一定使用如下的错误码来表明某种错误\n */\nexport enum GenericError {\n  Ok = 0,\n  Cancelled = 1, // 操作被取消\n  TimedOut = 2, // 操作超时\n  PermissionDenied = 3, // 无权限\n  AlreadyExists = 4, // 已经存在(文件/记录等)\n  NotSupported = 5, // 操作不支持\n  ResourceUnavailable = 6, // 资源不可用\n  OutOfRange = 7, // (参数/结果等)发生越界\n  InvalidArgument = 8, // 无效参数\n  NetworkFailed = 9, // 网络失败\n  Interrupted = 10, // 操作被中断(捕获异常转为错误)\n  ResultNil = 11, // 结果不存在(null or undefined转为错误)\n}\n\n/**\n * 通用错误码所对应的编译时常量对象(ErrorConst)\n */\nexport const cancelledError = lvErrorConst(GenericError.Cancelled, 'operation(s) cancelled.');\nexport const timeoutError = lvErrorConst(GenericError.TimedOut, 'operation(s) timed out.');\nexport const permissionDeniedError = lvErrorConst(\n  GenericError.PermissionDenied,\n  'permission denied.',\n);\nexport const alreadyExistsError = lvErrorConst(GenericError.AlreadyExists, 'already exists.');\nexport const notSupportedError = lvErrorConst(\n  GenericError.NotSupported,\n  'operation(s) not supported.',\n);\nexport const resourceUnavailableError = lvErrorConst(\n  GenericError.ResourceUnavailable,\n  'resource is unavailable.',\n);\nexport const outOfRangeError = lvErrorConst(GenericError.OutOfRange, 'out of range.');\nexport const invalidArgumentError = lvErrorConst(\n  GenericError.InvalidArgument,\n  'invalid arguments.',\n);\nexport const networkFailedError = lvErrorConst(GenericError.NetworkFailed, 'network failed.');\nexport const interruptedError = lvErrorConst(GenericError.Interrupted, 'interrupted.');\nexport const resultNilError = lvErrorConst(GenericError.ResultNil, 'result is nil.');\n"],"mappings":"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","names":["GenericError"]}

package/dist/error-base-BWuBlS2k.d.ts

@@ -0,0 +1,28 @@
+declare const ILvErrorRef: unique symbol;
+type ILvErrorRef = ILvErrorOr<never>;
+declare const ILvRealErrorRef: unique symbol;
+interface ILvRealErrorRef {
+    readonly ok: false;
+    readonly code: number;
+    readonly msg: string;
+    readonly cause?: ILvErrorRef | Error;
+    readonly toString: () => string;
+    readonly pair: () => [ILvRealErrorRef, null];
+    readonly errorInfo?: unknown;
+}
+declare const ILvValueRef: unique symbol;
+interface ILvValueRef<T> {
+    readonly ok: true;
+    readonly code: 0;
+    readonly msg: '';
+    readonly cause?: undefined;
+    readonly value: T;
+    readonly toString: () => string;
+    readonly pair: () => [null, T];
+}
+declare const ILvErrorOr: unique symbol;
+type ILvErrorOr<T> = (ILvRealErrorRef | ILvValueRef<T>) & {
+    readonly pair: () => [null, T] | [ILvRealErrorRef, null];
+};
+
+export { ILvErrorOr as I, ILvErrorRef as a, ILvRealErrorRef as b, ILvValueRef as c };

package/dist/event/index.d.ts

@@ -0,0 +1,57 @@
+import { I as IDisposable } from '../dispose-base-CAeXDpjg.js';
+
+interface EmitterOptions {
+    onAddListener?: (...args: any) => any;
+    onRemoveListener?: (...args: any) => any;
+    onListenerError?: (e: any) => void;
+}
+/**
+ * 默认错误处理：异步抛出监听器错误，避免阻塞当前事件分发。
+ */
+declare function asyncUnexpectedErrorHandler(e: unknown): undefined;
+/**
+ * 同步抛出监听器错误，适合测试或需要立即失败的场景。
+ */
+declare function syncUnexpectedError(e: unknown): undefined;
+/**
+ * 忽略监听器错误，适合明确允许 best-effort 通知的场景。
+ */
+declare function ignoreUnexpectedError(_e: unknown): undefined;
+declare class Listener<TArgs extends any[]> {
+    private readonly _callback;
+    private readonly _callbackThis;
+    constructor(callback: (...args: TArgs) => void, callbackThis: any | undefined);
+    invoke(...args: TArgs): void;
+}
+declare class EventDeliveryQueueElement<TArgs extends any[]> {
+    readonly emitter: Emitter<TArgs>;
+    readonly listener: Listener<TArgs>;
+    readonly event: TArgs;
+    constructor(emitter: Emitter<TArgs>, listener: Listener<TArgs>, event: TArgs);
+}
+declare class EventDeliveryQueue {
+    private readonly _onListenerError;
+    protected _queue: EventDeliveryQueueElement<any>[];
+    constructor(_onListenerError?: (e: unknown) => void);
+    get size(): number;
+    push<TArgs extends any[]>(emitter: Emitter<TArgs>, listener: Listener<TArgs>, event: TArgs): void;
+    clear<TArgs extends any[]>(emitter: Emitter<TArgs>): void;
+    deliver(): void;
+}
+interface Event<T extends any[]> {
+    (listener: (...args: T) => any, thisArgs?: any): IDisposable;
+}
+declare class Emitter<TArgs extends any[]> {
+    protected _listeners?: Set<Listener<TArgs>>;
+    private readonly _options?;
+    private _disposed;
+    private _event?;
+    private _deliveryQueue?;
+    constructor(options?: EmitterOptions);
+    get event(): Event<TArgs>;
+    dispose(): void;
+    fire(...event: TArgs): void;
+}
+declare function listenOnce<TArgs extends any[]>(event: Event<TArgs>): Event<TArgs>;
+
+export { Emitter, type EmitterOptions, type Event, EventDeliveryQueue, asyncUnexpectedErrorHandler, ignoreUnexpectedError, listenOnce, syncUnexpectedError };