@zk-tech/bedrock 0.0.1

package/dist/dispose/index.js

@@ -0,0 +1,340 @@
+// src/_internal/logger.ts
+var Logger = {
+  error(...data) {
+    if (typeof console.error === "function") {
+      console.error(...data);
+    }
+  },
+  info(...data) {
+    if (typeof console.info === "function") {
+      console.info(...data);
+    }
+  },
+  log(...data) {
+    if (typeof console.log === "function") {
+      console.log(...data);
+    }
+  },
+  time(label) {
+    if (typeof console.time === "function") {
+      console.time(label);
+    }
+  },
+  timeEnd(label) {
+    if (typeof console.timeEnd === "function") {
+      console.timeEnd(label);
+    }
+  },
+  timeLog(label, ...data) {
+    if (typeof console.timeLog === "function") {
+      console.timeLog(label, ...data);
+    }
+  },
+  timeStamp(label) {
+    if (typeof console.timeStamp === "function") {
+      console.timeStamp(label);
+    }
+  },
+  trace(...data) {
+    if (typeof console.trace === "function") {
+      console.trace(...data);
+    }
+  },
+  warn(...data) {
+    if (typeof console.warn === "function") {
+      console.warn(...data);
+    }
+  },
+  profile(label) {
+    if (typeof console.profile === "function") {
+      console.profile(label);
+    }
+  },
+  profileEnd(label) {
+    if (typeof console.profileEnd === "function") {
+      console.profileEnd(label);
+    }
+  }
+};
+function BRANCH_DISPOSE(from, to) {
+}
+
+// src/dispose/dispose-base.ts
+var EmptyDispose = Object.freeze({ dispose() {
+} });
+
+// src/dispose/tracker.ts
+var disposableTracker = null;
+function makeDefaultTracker() {
+  const ignorePattern = /commitHookEffectList/i;
+  const __is_disposable_tracked__ = "__is_disposable_tracked__";
+  const __is_leak_marked__ = "__is_leak_marked__";
+  return new class {
+    trackDisposable(x) {
+      const stack = new Error("Potentially leaked disposable").stack;
+      setTimeout(() => {
+        if (stack.match(ignorePattern)) {
+          return;
+        }
+        if (x[__is_leak_marked__]) {
+          return;
+        }
+        if (!x[__is_disposable_tracked__]) {
+          Logger.log(stack);
+        }
+      }, 3e3);
+    }
+    setParent(child, parent) {
+      if (child && child !== EmptyDispose) {
+        try {
+          child[__is_disposable_tracked__] = true;
+        } catch {
+        }
+      }
+    }
+    markAsDisposed(disposable) {
+      if (disposable && disposable !== EmptyDispose) {
+        try {
+          disposable[__is_disposable_tracked__] = true;
+        } catch {
+        }
+      }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-empty-function
+    markAsLeaked(disposable) {
+      if (disposable && disposable !== EmptyDispose) {
+        try {
+          disposable[__is_leak_marked__] = true;
+        } catch {
+        }
+      }
+    }
+  }();
+}
+function setDisposableTracker(tracker) {
+  disposableTracker = tracker;
+}
+function enableTrack(tracker = makeDefaultTracker()) {
+  setDisposableTracker(tracker);
+}
+function disableTrack() {
+  setDisposableTracker(null);
+}
+function TRACK_DISPOSABLE(x) {
+  disposableTracker?.trackDisposable(x);
+  return x;
+}
+function MARK_AS_DISPOSED(x) {
+  disposableTracker?.markAsDisposed(x);
+}
+function SET_PARENT_OF_DISPOSABLE(child, parent) {
+  disposableTracker?.setParent(child, parent);
+}
+function MARK_AS_LEAKED(x) {
+  disposableTracker?.markAsLeaked(x);
+}
+
+// src/dispose/disposable-store.ts
+var _DisposableStore = class _DisposableStore {
+  constructor() {
+    this._toDispose = /* @__PURE__ */ new Set();
+    this._isDisposed = false;
+    TRACK_DISPOSABLE(this);
+  }
+  get isDisposed() {
+    return this._isDisposed;
+  }
+  dispose() {
+    if (this._isDisposed) {
+      Logger.warn(new Error("DisposableStore has disposed.").stack);
+      return;
+    }
+    MARK_AS_DISPOSED(this);
+    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);
+    }
+    const errors = [];
+    for (const disposable of this._toDispose) {
+      try {
+        disposable.dispose();
+      } catch (e) {
+        errors.push(e);
+      }
+    }
+    this._toDispose.clear();
+    if (errors.length > 0) {
+      throw new AggregateError(errors, "find error when dispose store.");
+    }
+  }
+  add(o) {
+    if (!o) {
+      return o;
+    }
+    if (o === this) {
+      throw new Error("Cannot register a disposable on itself.");
+    }
+    SET_PARENT_OF_DISPOSABLE(o, this);
+    if (this._isDisposed) {
+      if (!_DisposableStore.DISABLE_DISPOSED_WARNING) {
+        Logger.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;
+  }
+};
+_DisposableStore.DISABLE_DISPOSED_WARNING = false;
+var DisposableStore = _DisposableStore;
+
+// src/assert/assert.ts
+function abort(reason) {
+  throw new Error(`lvAssert(${reason})`);
+}
+function lvAssertNotNil(val, reason) {
+  if (val === null || val === void 0) {
+    abort("#val is nil");
+  }
+}
+
+// src/dispose/disposable-t.ts
+var Disposable = class {
+  constructor() {
+    this._store = new DisposableStore();
+    TRACK_DISPOSABLE(this);
+    SET_PARENT_OF_DISPOSABLE(this._store, this);
+  }
+  // 销毁该节点和所有的子节点
+  dispose() {
+    MARK_AS_DISPOSED(this);
+    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 {
+  constructor(value) {
+    this._isDisposed = false;
+    TRACK_DISPOSABLE(this);
+    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();
+    if (value) {
+      SET_PARENT_OF_DISPOSABLE(value, this);
+    }
+    this._value = value;
+  }
+  clear() {
+    this.value = void 0;
+  }
+  dispose() {
+    this._isDisposed = true;
+    MARK_AS_DISPOSED(this);
+    this._value?.dispose();
+    this._value = void 0;
+  }
+  release() {
+    const oldValue = this._value;
+    this._value = void 0;
+    if (oldValue) {
+      SET_PARENT_OF_DISPOSABLE(oldValue, null);
+    }
+    return oldValue;
+  }
+};
+var SafeDisposable = class {
+  constructor(value) {
+    this._value = value;
+    TRACK_DISPOSABLE(this);
+  }
+  get value() {
+    return this._value;
+  }
+  isEmpty() {
+    return this._value === void 0;
+  }
+  dispose() {
+    if (!this._value) {
+      return;
+    }
+    this._value.dispose();
+    this._value = void 0;
+    MARK_AS_DISPOSED(this);
+  }
+};
+var TransferDisposable = class extends Disposable {
+  constructor(val) {
+    super();
+    this._val = val;
+  }
+  release() {
+    lvAssertNotNil(this._val);
+    const v = this._val;
+    this._val = void 0;
+    return v;
+  }
+  dispose() {
+    Logger.warn(new Error("TransferDisposable call dispose."));
+    this._val?.dispose();
+    super.dispose();
+  }
+};
+
+// src/dispose/disposable-utils.ts
+function makeSafeDisposable(fn) {
+  const disposable = new SafeDisposable({
+    dispose: fn
+  });
+  return disposable;
+}
+function ignoreDispose(x) {
+  MARK_AS_LEAKED(x);
+}
+function isDisposable(thing) {
+  return typeof thing.dispose === "function" && thing.dispose.length === 0;
+}
+function makeTransferDisposable(val) {
+  return new TransferDisposable(val);
+}
+
+// src/dispose/timer.ts
+function setDisposableTimeout(fn, timeout) {
+  const handle = setTimeout(() => {
+    fn();
+  }, timeout);
+  return makeSafeDisposable(() => clearTimeout(handle));
+}
+function setDisposableInterval(fn, timeout) {
+  const handle = setInterval(() => {
+    fn();
+  }, timeout);
+  return makeSafeDisposable(() => clearInterval(handle));
+}
+
+export { Disposable, DisposableStore, EmptyDispose, MutableDisposable, SET_PARENT_OF_DISPOSABLE, SafeDisposable, TransferDisposable, disableTrack, enableTrack, ignoreDispose, isDisposable, makeSafeDisposable, makeTransferDisposable, setDisposableInterval, setDisposableTimeout };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/dispose/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/_internal/logger.ts","../../src/dispose/logger.ts","../../src/dispose/dispose-base.ts","../../src/dispose/tracker.ts","../../src/dispose/disposable-store.ts","../../src/assert/assert.ts","../../src/dispose/disposable-t.ts","../../src/dispose/disposable-utils.ts","../../src/dispose/timer.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/* eslint-disable no-console */\n\nexport const Logger = {\n  error(...data: any[]): void {\n    if (typeof console.error === 'function') {\n      console.error(...data);\n    }\n  },\n  info(...data: any[]): void {\n    if (typeof console.info === 'function') {\n      console.info(...data);\n    }\n  },\n  log(...data: any[]): void {\n    if (typeof console.log === 'function') {\n      console.log(...data);\n    }\n  },\n  time(label?: string): void {\n    if (typeof console.time === 'function') {\n      console.time(label);\n    }\n  },\n  timeEnd(label?: string): void {\n    if (typeof console.timeEnd === 'function') {\n      console.timeEnd(label);\n    }\n  },\n  timeLog(label?: string, ...data: any[]): void {\n    if (typeof console.timeLog === 'function') {\n      console.timeLog(label, ...data);\n    }\n  },\n  timeStamp(label?: string): void {\n    if (typeof console.timeStamp === 'function') {\n      console.timeStamp(label);\n    }\n  },\n  trace(...data: any[]): void {\n    if (typeof console.trace === 'function') {\n      console.trace(...data);\n    }\n  },\n  warn(...data: any[]): void {\n    if (typeof console.warn === 'function') {\n      console.warn(...data);\n    }\n  },\n  profile(label?: string): void {\n    if (typeof console.profile === 'function') {\n      console.profile(label);\n    }\n  },\n  profileEnd(label?: string): void {\n    if (typeof console.profileEnd === 'function') {\n      console.profileEnd(label);\n    }\n  },\n};\n","import { Logger } from '@/_internal/logger';\nimport 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      Logger.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>(x: T, logger: IDisposableLogger = makeDefaultLogger()) {\n  setDisposableLogger(logger);\n  x.dispose();\n  logger.end();\n  setDisposableLogger(null);\n}\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 { Logger } from '@/_internal/logger';\nimport type { IDisposable } from './dispose-base';\nimport { EmptyDispose } from './dispose-base';\n\nexport interface IDisposableTracker {\n  trackDisposable: (disposable: IDisposable) => void;\n\n  setParent: (child: IDisposable, parent: IDisposable | null) => void;\n\n  markAsDisposed: (disposable: IDisposable) => void;\n\n  markAsLeaked: (disposable: IDisposable) => void;\n}\n\nlet disposableTracker: IDisposableTracker | null = null;\n\nfunction makeDefaultTracker() {\n  // reactHooks useEffect中出现disposable，我们默认为不会泄漏\n  // 默认使用者一定会在useEffect的返回值中进行dispose\n  const ignorePattern = /commitHookEffectList/i;\n\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  const __is_disposable_tracked__ = '__is_disposable_tracked__';\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  const __is_leak_marked__ = '__is_leak_marked__';\n  return new (class implements IDisposableTracker {\n    trackDisposable(x: IDisposable): void {\n      const stack = new Error('Potentially leaked disposable').stack!;\n      setTimeout(() => {\n        if (stack.match(ignorePattern)) {\n          return;\n        }\n        if ((x as any)[__is_leak_marked__]) {\n          return;\n        }\n        if (!(x as any)[__is_disposable_tracked__]) {\n          Logger.log(stack);\n        }\n      }, 3000);\n    }\n\n    setParent(child: IDisposable, parent: IDisposable | null): void {\n      if (child && child !== EmptyDispose) {\n        try {\n          (child as any)[__is_disposable_tracked__] = true;\n        } catch {\n          // noop\n        }\n      }\n    }\n\n    markAsDisposed(disposable: IDisposable): void {\n      if (disposable && disposable !== EmptyDispose) {\n        try {\n          (disposable as any)[__is_disposable_tracked__] = true;\n        } catch {\n          // noop\n        }\n      }\n    }\n    // eslint-disable-next-line @typescript-eslint/no-empty-function\n    markAsLeaked(disposable: IDisposable): void {\n      if (disposable && disposable !== EmptyDispose) {\n        try {\n          (disposable as any)[__is_leak_marked__] = true;\n        } catch {\n          // noop\n        }\n      }\n    }\n  })();\n}\n\nfunction setDisposableTracker(tracker: IDisposableTracker | null): void {\n  disposableTracker = tracker;\n}\n\nexport function enableTrack(tracker: IDisposableTracker = makeDefaultTracker()) {\n  setDisposableTracker(tracker);\n}\n\nexport function disableTrack() {\n  setDisposableTracker(null);\n}\n\n// 辅助能力 跟踪disposable\nexport function TRACK_DISPOSABLE<T extends IDisposable>(x: T): T {\n  disposableTracker?.trackDisposable(x);\n  return x;\n}\n\n// 辅助能力 标记disposable成功\nexport function MARK_AS_DISPOSED<T extends IDisposable>(x: T): void {\n  disposableTracker?.markAsDisposed(x);\n}\n\n// 辅助能力 标记disposable关系\nexport function SET_PARENT_OF_DISPOSABLE(child: IDisposable, parent: IDisposable | null): void {\n  disposableTracker?.setParent(child, parent);\n}\n\n// 辅助能力 主动标记泄漏\nexport function MARK_AS_LEAKED<T extends IDisposable>(x: T) {\n  disposableTracker?.markAsLeaked(x);\n}\n","import { Logger } from '@/_internal/logger';\nimport type { IDisposable } from './dispose-base';\nimport { BRANCH_DISPOSE } from './logger';\nimport { MARK_AS_DISPOSED, SET_PARENT_OF_DISPOSABLE, TRACK_DISPOSABLE } from './tracker';\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  constructor() {\n    TRACK_DISPOSABLE(this);\n  }\n\n  get isDisposed(): boolean {\n    return this._isDisposed;\n  }\n\n  dispose(): void {\n    if (this._isDisposed) {\n      // 不应该出现重复dispose\n      Logger.warn(new Error('DisposableStore has disposed.').stack);\n      return;\n    }\n\n    MARK_AS_DISPOSED(this);\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    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const errors: any[] = [];\n    for (const disposable of this._toDispose) {\n      try {\n        disposable.dispose();\n      } catch (e) {\n        errors.push(e);\n      }\n    }\n\n    this._toDispose.clear();\n    if (errors.length > 0) {\n      throw new AggregateError(errors, 'find error when dispose store.');\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    SET_PARENT_OF_DISPOSABLE(o, this);\n    if (this._isDisposed) {\n      if (!DisposableStore.DISABLE_DISPOSED_WARNING) {\n        Logger.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","function abort(reason: string): never {\n  throw new Error(`lvAssert(${reason})`);\n}\n\n/**\n * 断言表达式为真\n * @param expr \n * @param reason \n */\nexport function lvAssert(expr: unknown, reason?: string): asserts expr {\n  if (!expr) {\n    abort(reason ?? '#expr is false');\n  }\n}\n\n/**\n * 断言deadcode路径\n * @param reason \n */\nexport function lvAssertNotHere(reason?: string): never {\n  abort(reason ?? 'unreachable code flow');\n}\n\n/**\n * 断言类型不可达\n * @param member \n * @param message \n */\nexport function lvAssertNever(member: never, message = 'Illegal value:'): never {\n  abort(`${message}: ${member}`);\n}\n\n/**\n * 断言变量为null或者undefined\n * @param val \n * @param reason \n */\nexport function lvAssertNotNil<T>(val: T, reason?: string): asserts val is NonNullable<T> {\n  if (val === null || val === undefined) {\n    abort(reason ?? '#val is nil');\n  }\n}\n","import { Logger } from '@/_internal/logger';\nimport { lvAssertNotNil } from '@/assert';\nimport { DisposableStore } from './disposable-store';\nimport type { IDisposable } from './dispose-base';\nimport { BRANCH_DISPOSE } from './logger';\nimport { MARK_AS_DISPOSED, SET_PARENT_OF_DISPOSABLE, TRACK_DISPOSABLE } from './tracker';\n\n//\n// Disposable基类\n//\n// 自动添加DisposableStore，提供默认的dispose和register方法\n//\nexport abstract class Disposable implements IDisposable {\n  protected readonly _store = new DisposableStore();\n\n  constructor() {\n    TRACK_DISPOSABLE(this);\n    SET_PARENT_OF_DISPOSABLE(this._store, this);\n  }\n\n  // 销毁该节点和所有的子节点\n  dispose(): void {\n    MARK_AS_DISPOSED(this);\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\n/**\n * 容器类\n * 提供一个容器，容器内部的IDisposable对象可以切换更新，每次更新的时候，旧的IDisposable对象会自动进行dispose\n *\n * 使用方式:\n * class Foo {\n *   private readonly _barRef: MutableDisposable;\n *\n *   toggle() {\n *     this._barRef.setValue(new Bar());\n *   }\n *\n *   doSomething() {\n *     this._barRef.value.xxx();\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    TRACK_DISPOSABLE(this);\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    if (value) {\n      SET_PARENT_OF_DISPOSABLE(value, this);\n    }\n    this._value = value;\n  }\n\n  clear(): void {\n    this.value = undefined;\n  }\n\n  dispose(): void {\n    this._isDisposed = true;\n    MARK_AS_DISPOSED(this);\n    this._value?.dispose();\n    this._value = undefined;\n  }\n\n  release(): T | undefined {\n    const oldValue = this._value;\n    this._value = undefined;\n    if (oldValue) {\n      SET_PARENT_OF_DISPOSABLE(oldValue, null);\n    }\n    return oldValue;\n  }\n}\n\n/**\n * 容器类\n * 通过该容器进行dispose试，可以保证内部的IDisposable一会进行一次dispose\n * 本质是一种防御性质的处理，如果需要使用时，最好有明确的理由\n */\nexport class SafeDisposable<T extends IDisposable> implements IDisposable {\n  private _value?: T;\n\n  constructor(value: T) {\n    this._value = value;\n    TRACK_DISPOSABLE(this);\n  }\n\n  get value(): T | undefined {\n    return this._value;\n  }\n\n  isEmpty() {\n    return this._value === undefined;\n  }\n\n  dispose() {\n    if (!this._value) {\n      return;\n    }\n    this._value.dispose();\n    this._value = undefined;\n    MARK_AS_DISPOSED(this);\n  }\n}\n\n/**\n * 容器类\n * 引用计数容器，当引用为0时自动执行dispose\n * 注意：初始计数为1，默认构造的地方自动获得引用，如果在栈上构造，记得最后调用release\n *\n * 使用实例:\n * class Foo {\n *   private _bar: RefCountedDisposable = new RefCountedDisposable(new Bar());\n *\n *   getBar() {\n *     this._bar.acquire();\n *     return this._bar;\n *   }\n * }\n *\n * // 如果在栈上构造\n * const bar = new RefCountedDisposable(new Bar());\n * makeFoo(bar);\n * makeFoo(bar);\n * bar.release();\n */\nexport class RefCountedDisposable<T extends IDisposable> implements IDisposable {\n  private _counter: number = 1;\n  private _value?: T;\n\n  constructor(value: T) {\n    this._value = value;\n    TRACK_DISPOSABLE(this);\n  }\n\n  get value(): T | undefined {\n    return this._value;\n  }\n\n  acquire() {\n    if (!this._value) {\n      return this;\n    }\n    this._counter++;\n    return this;\n  }\n\n  release() {\n    if (--this._counter === 0) {\n      this._value!.dispose();\n      this._value = undefined;\n      MARK_AS_DISPOSED(this);\n    }\n    return this;\n  }\n\n  dispose() {\n    this.release();\n  }\n}\n\n/**\n * 容器类，表示了一个T生命周期的转移\n *\n * 由于js引用传递的特性，正常情况下，我们默认为传递过来的对象不具备dispose权利\n * class Foo extends Disposable {\n *   private readonly _bar = new Bar();\n *\n *   constructor(\n *     thirdparty: Thirdparty,\n *   ) {\n *     this._register(this._bar);  // class内部构造的，具备dispose权利\n *     this._register(thirdparty);  // ❌，很少会直接这么写，除非能很确定存在生命周期转移\n *   }\n *\n *   constructor(\n *     thirdparty: TransferDisposable<Thirdparty>,  // ✅，明确表示了我依赖了Thirdparty，但是该对象生命周期要归我所有\n *   ) {\n *     this._register(this._bar);\n *     this._register(thirdparty.release());  // ✅，可以直接register\n *   }\n * }\n *\n * 注意：\n * 不同于C++中的unique_ptr，该class只作用于转移场景。\n * 所以class理论上只在栈上出现，不应该在堆上存在。\n * 如果出现了需要在堆上存储的场景，可以联系架构侧\n */\nexport class TransferDisposable<T extends IDisposable> extends Disposable {\n  private _val?: T;\n\n  constructor(val: T) {\n    super();\n\n    this._val = val;\n  }\n\n  release() {\n    // 只能release一次\n    lvAssertNotNil(this._val);\n    const v = this._val;\n    this._val = undefined;\n    return v;\n  }\n\n  dispose(): void {\n    // 虽然它有dispose，但是不应该被执行，应该直接被gc才对\n    Logger.warn(new Error('TransferDisposable call dispose.'));\n    this._val?.dispose();\n    super.dispose();\n  }\n}\n","import { SafeDisposable, TransferDisposable } from './disposable-t';\nimport { EmptyDispose, type IDisposable } from './dispose-base';\nimport { MARK_AS_LEAKED } from './tracker';\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\n// 忽略dispose\nexport function ignoreDispose(x: IDisposable) {\n  MARK_AS_LEAKED(x);\n}\n\n// 判断一个thing是否是disposable\nexport function isDisposable<E = any>(thing: E): thing is E & IDisposable {\n  return typeof (thing as IDisposable).dispose === 'function' && (thing as IDisposable).dispose.length === 0;\n}\n\nexport function makeTransferDisposable<T extends IDisposable>(val: T) {\n  return new TransferDisposable(val);\n}\n","import type { IDisposable } from './dispose-base';\nimport { makeSafeDisposable } from './disposable-utils';\n\nexport function setDisposableTimeout(fn: (...args: any[]) => void, timeout: number): IDisposable {\n  const handle = setTimeout(() => {\n    fn();\n  }, timeout);\n  return makeSafeDisposable(() => clearTimeout(handle));\n}\n\nexport function setDisposableInterval(fn: (...args: any[]) => void, timeout: number): IDisposable {\n  const handle = setInterval(() => {\n    fn();\n  }, timeout);\n  return makeSafeDisposable(() => clearInterval(handle));\n}\n"]}

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

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

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/emitter-CAfCtSTg.d.cts

@@ -0,0 +1,35 @@
+import { I as IDisposable } from './dispose-base-CAeXDpjg.cjs';
+import { L as LinkedList } from './linked-list-CUkue5DZ.cjs';
+
+declare class DisposableLinkedList<T> extends LinkedList<T> {
+    unshiftAndGetDisposableNode(value: T): () => void;
+    pushAndGetDisposableNode(value: T): () => void;
+}
+
+interface EmitterOptions {
+    onAddListener?: (...args: any) => any;
+    onRemoveListener?: (...args: any) => any;
+    onListenerError?: (e: any) => void;
+}
+declare class Listener<TArgs extends any[]> {
+    private readonly _callback;
+    private readonly _callbackThis;
+    constructor(callback: (...args: TArgs) => void, callbackThis: any | undefined);
+    invoke(...args: TArgs): void;
+}
+interface Event<T extends any[]> {
+    (listener: (...args: T) => any, thisArgs?: any): IDisposable;
+}
+declare class Emitter<TArgs extends any[]> {
+    protected _listeners?: DisposableLinkedList<Listener<TArgs>>;
+    private readonly _options?;
+    private _disposed;
+    private _event?;
+    private _deliveryQueue?;
+    constructor(options?: EmitterOptions);
+    get event(): Event<TArgs>;
+    dispose(): void;
+    fire(...event: TArgs): void;
+}
+
+export { type Event as E, Emitter as a, type EmitterOptions as b };

package/dist/emitter-DeM5mlEm.d.ts

@@ -0,0 +1,35 @@
+import { I as IDisposable } from './dispose-base-CAeXDpjg.js';
+import { L as LinkedList } from './linked-list-CUkue5DZ.js';
+
+declare class DisposableLinkedList<T> extends LinkedList<T> {
+    unshiftAndGetDisposableNode(value: T): () => void;
+    pushAndGetDisposableNode(value: T): () => void;
+}
+
+interface EmitterOptions {
+    onAddListener?: (...args: any) => any;
+    onRemoveListener?: (...args: any) => any;
+    onListenerError?: (e: any) => void;
+}
+declare class Listener<TArgs extends any[]> {
+    private readonly _callback;
+    private readonly _callbackThis;
+    constructor(callback: (...args: TArgs) => void, callbackThis: any | undefined);
+    invoke(...args: TArgs): void;
+}
+interface Event<T extends any[]> {
+    (listener: (...args: T) => any, thisArgs?: any): IDisposable;
+}
+declare class Emitter<TArgs extends any[]> {
+    protected _listeners?: DisposableLinkedList<Listener<TArgs>>;
+    private readonly _options?;
+    private _disposed;
+    private _event?;
+    private _deliveryQueue?;
+    constructor(options?: EmitterOptions);
+    get event(): Event<TArgs>;
+    dispose(): void;
+    fire(...event: TArgs): void;
+}
+
+export { type Event as E, Emitter as a, type EmitterOptions as b };

package/dist/error/index.cjs

@@ -0,0 +1,145 @@
+'use strict';
+
+// src/error/error-t.ts
+var lvErrorRefSymbol = /* @__PURE__ */ Symbol("lvErrorRef");
+function findJsError(error) {
+  let obj = error;
+  while (obj) {
+    if (obj instanceof Error) {
+      return obj;
+    }
+    obj = obj.cause;
+  }
+  return new Error(error.toString());
+}
+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];
+    },
+    stack: cause instanceof Error ? cause.stack : void 0,
+    findJsError: () => findJsError(errorRef),
+    ...{ [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.");
+
+exports.GenericError = GenericError;
+exports.alreadyExistsError = alreadyExistsError;
+exports.cancelledError = cancelledError;
+exports.interruptedError = interruptedError;
+exports.invalidArgumentError = invalidArgumentError;
+exports.isLvErrorRef = isLvErrorRef;
+exports.lvErrorConst = lvErrorConst;
+exports.makeError = makeError;
+exports.makeErrorBy = makeErrorBy;
+exports.makeOk = makeOk;
+exports.makeOkWith = makeOkWith;
+exports.networkFailedError = networkFailedError;
+exports.notSupportedError = notSupportedError;
+exports.outOfRangeError = outOfRangeError;
+exports.permissionDeniedError = permissionDeniedError;
+exports.resourceUnavailableError = resourceUnavailableError;
+exports.resultNilError = resultNilError;
+exports.timeoutError = timeoutError;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/error/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/error/error-t.ts","../../src/error/error-const.ts","../../src/error/error-code.ts"],"names":["GenericError"],"mappings":"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","file":"index.cjs","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\nfunction findJsError(error: ILvErrorRef | Error) {\n  let obj: ILvErrorRef | Error | undefined = error;\n  while (obj) {\n    if (obj instanceof Error) {\n      return obj;\n    }\n    obj = (obj as ILvErrorRef).cause;\n  }\n  // 如果没有Error，那就序列化lvError\n  return new Error((error as ILvErrorRef).toString());\n}\n\nexport function makeOk<K>(): ILvErrorOr<never, K> {\n  return {\n    ok: true,\n    value: null!,\n    pair() {\n      return [null, null!];\n    },\n    code: 0,\n    msg: '',\n    ...{ [lvErrorRefSymbol]: true }, // 跳过类型检测\n  };\n}\n\nexport function makeOkWith<T, K = unknown>(value: T): ILvErrorOr<T, K> {\n  return {\n    ok: true,\n    value,\n    pair() {\n      return [null, value];\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<T>(code: number, msg: string, cause?: ILvErrorRef | Error, errorInfo?: T) {\n  const errorRef: ILvRealErrorRef<T> = {\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    stack: cause instanceof Error ? cause.stack : undefined,\n    findJsError: () => findJsError(errorRef),\n    ...{ [lvErrorRefSymbol]: true }, // 跳过类型检测\n  };\n  return errorRef;\n}\n\nexport function makeError<T = unknown>(code: number, msg: string, errorInfo?: T): ILvRealErrorRef<T> {\n  return internalMakeError(code, msg, undefined, errorInfo);\n}\n\nexport function makeErrorBy<T = unknown>(\n  code: number,\n  msg: string,\n  cause: ILvErrorRef | Error,\n  errorInfo?: T,\n): ILvRealErrorRef<T> {\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(GenericError.PermissionDenied, 'permission denied.');\nexport const alreadyExistsError = lvErrorConst(GenericError.AlreadyExists, 'already exists.');\nexport const notSupportedError = lvErrorConst(GenericError.NotSupported, 'operation(s) not supported.');\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(GenericError.InvalidArgument, 'invalid arguments.');\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"]}