zeed 1.2.4 → 1.3.1

package/dist/common/data/xrx.mjs

@@ -0,0 +1,93 @@
+//#region src/common/data/xrx.ts
+const RX_WHITESPACE = /\\\s|\s+|#[^\n]*\n?/g;
+const RX_REAL_GROUPS = /\(\?P?<(\w{2,})>|\((?!\?([:!=]|<=|<!))/g;
+const RX_LOOK_BEHIND = /^((?:\(\?[\w$]+\))?)\(\?<([=!])([\s\S]*?)\)/gm;
+function regExpString(rx) {
+	return typeof rx === "string" ? rx : rx.source || "";
+}
+function regExpEscape(str) {
+	return str.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, "\\$&");
+}
+var XRX = class {
+	lookBehind;
+	namedGroups = {};
+	names = [];
+	rx;
+	constructor(pattern, flags) {
+		let _flags = flags ?? "";
+		let _rx;
+		if (pattern instanceof RegExp) {
+			if (flags == null) _flags = pattern.flags;
+			_rx = pattern.source;
+		} else _rx = pattern;
+		if (_flags && _flags.includes("x")) {
+			_flags = _flags.replace("x", "");
+			_rx = _rx.replace(RX_WHITESPACE, (r) => {
+				return r[0] === "\\" ? r : "";
+			});
+		}
+		if (!(pattern instanceof RegExp)) {
+			let index = 0;
+			_rx = _rx.replace(RX_REAL_GROUPS, (str, name) => {
+				index += 1;
+				if (name) {
+					if (name !== "index" && name !== "length" && !this.namedGroups[name]) this.namedGroups[name] = index;
+					return "(";
+				}
+				return str;
+			});
+			this.names = Object.keys(this.namedGroups);
+		}
+		_rx = regExpString(_rx);
+		RX_LOOK_BEHIND.lastIndex = 0;
+		const parts = RX_LOOK_BEHIND.exec(_rx);
+		if (parts) {
+			this.lookBehind = {
+				rx: new RegExp(`${parts[3]}$(?!\\s)`),
+				expect: parts ? parts[2] === "=" : !parts
+			};
+			_rx = _rx.substr(parts[0].length);
+		}
+		this.rx = new RegExp(_rx, _flags);
+	}
+	get lastIndex() {
+		return this.rx.lastIndex;
+	}
+	set lastIndex(index) {
+		this.rx.lastIndex = index;
+	}
+	_handleMatch(m) {
+		if (this.lookBehind) {
+			const leftContext = m.input.slice(0, m.index);
+			if (this.lookBehind.expect !== this.lookBehind.rx.test(leftContext)) return null;
+		}
+		for (const name of this.names) m[name] = m[this.namedGroups[name]];
+		return m;
+	}
+	exec(str) {
+		let m;
+		while (m = this.rx.exec(str)) {
+			if (this.rx.lastIndex === m.index) this.rx.lastIndex++;
+			m = this._handleMatch(m);
+			if (m != null) return m;
+		}
+	}
+	execAll(str) {
+		const matches = [];
+		let m;
+		this.rx.lastIndex = 0;
+		while (m = this.exec(str)) matches.push(m);
+		this.rx.lastIndex = 0;
+		return matches;
+	}
+	replace(str, replacement) {
+		const fn = typeof replacement === "function" ? replacement : () => replacement;
+		return str.replace(this.rx, (m) => {
+			return fn(m);
+		});
+	}
+};
+
+//#endregion
+export { XRX, regExpEscape, regExpString };
+//# sourceMappingURL=xrx.mjs.map

package/dist/common/data/xrx.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"xrx.mjs","names":[],"sources":["../../../src/common/data/xrx.ts"],"sourcesContent":["/* eslint-disable no-cond-assign */\n\nconst RX_WHITESPACE = /\\\\\\s|\\s+|#[^\\n]*\\n?/g\nconst RX_REAL_GROUPS = /\\(\\?P?<(\\w{2,})>|\\((?!\\?([:!=]|<=|<!))/g\n// eslint-disable-next-line regexp/no-unused-capturing-group\nconst RX_LOOK_BEHIND = /^((?:\\(\\?[\\w$]+\\))?)\\(\\?<([=!])([\\s\\S]*?)\\)/gm\n\nexport function regExpString(rx: string | RegExp): string {\n  return typeof rx === 'string' ? rx : (rx.source || '')\n}\n\nexport function regExpEscape(str: string): string {\n  return str.replace(/[-[\\]{}()*+?.,\\\\^$|#\\s]/g, '\\\\$&')\n}\n\nexport class XRX {\n  lookBehind:any\n  namedGroups: Record<string, number> = {}\n  names: string[] = []\n  rx: RegExp\n\n  constructor(pattern: string | RegExp, flags?: string) {\n    let _flags: string = flags ?? ''\n    let _rx: string\n\n    if (pattern instanceof RegExp) {\n      if (flags == null)\n        _flags = pattern.flags\n\n      _rx = pattern.source\n    }\n    else {\n      _rx = pattern\n    }\n\n    // eXtended / Ignore Whitespace\n    const extended = _flags && _flags.includes('x')\n    if (extended) {\n      _flags = _flags.replace('x', '')\n      _rx = _rx.replace(RX_WHITESPACE, (r) => {\n        // log('rp', r)\n        return r[0] === '\\\\' ? r : ''\n      })\n    }\n\n    // Named Groups\n    if (!(pattern instanceof RegExp)) {\n      let index = 0\n      _rx = _rx.replace(RX_REAL_GROUPS, (str, name) => {\n        // log('>>>', name)\n        index += 1\n        if (name) {\n          if (\n            name !== 'index'\n            && name !== 'length'\n            && !this.namedGroups[name]\n          ) {\n            this.namedGroups[name] = index\n          }\n          // else\n          //   log.error(`Unallowed or duplicate group name: ${name}`)\n\n          return '('\n        }\n        return str\n      })\n      this.names = Object.keys(this.namedGroups)\n    }\n\n    // http://www.rexegg.com/regex-best-trick.html\n\n    _rx = regExpString(_rx)\n    RX_LOOK_BEHIND.lastIndex = 0\n    const parts = RX_LOOK_BEHIND.exec(_rx)\n    if (parts) {\n      this.lookBehind = {\n        rx: new RegExp(`${parts[3]}$(?!\\\\s)`),\n        expect: parts ? parts[2] === '=' : !parts,\n      }\n      _rx = _rx.substr(parts[0].length)\n    }\n\n    this.rx = new RegExp(_rx, _flags)\n  }\n\n  // flagsString() {\n  //     let hash = this.rx.toString() + '/'\n  //     if (this.rx.global) {\n  //         hash += 'g'\n  //     }\n  //     if (this.rx.multiline) {\n  //         hash += 'm'\n  //     }\n  //     if (this.rx.ignoreCase) {\n  //         hash += 'i'\n  //     }\n  //     if (this.rx.unicode) {\n  //         hash += 'u'\n  //     }\n  //     if (this.rx.sticky) {\n  //         hash += 'y'\n  //     }\n  // }\n\n  get lastIndex(): number {\n    return this.rx.lastIndex\n  }\n\n  set lastIndex(index: number) {\n    this.rx.lastIndex = index\n  }\n\n  _handleMatch(m: any) {\n    if (this.lookBehind) {\n      const leftContext = m.input.slice(0, m.index)\n      if (this.lookBehind.expect !== this.lookBehind.rx.test(leftContext))\n        return null\n    }\n    for (const name of this.names)\n      m[name] = m[this.namedGroups[name]]\n\n    return m\n  }\n\n  exec(str: string) {\n    let m\n    while ((m = this.rx.exec(str))) {\n      if (this.rx.lastIndex === m.index)\n        this.rx.lastIndex++\n      m = this._handleMatch(m)\n      if (m != null)\n        return m\n    }\n  }\n\n  execAll(str: string) {\n    const matches = []\n    let m\n    this.rx.lastIndex = 0\n    while ((m = this.exec(str)))\n      matches.push(m)\n\n    this.rx.lastIndex = 0\n    // log('execAll:', matches)\n    return matches\n  }\n\n  replace(str: string, replacement: string | ((m: string) => string)) {\n    const fn = typeof replacement === 'function' ? replacement : () => replacement\n    return str.replace(this.rx, (m) => {\n      // m = this._handleMatch(m)\n      return fn(m)\n    })\n  }\n}\n"],"mappings":";AAEA,MAAM,gBAAgB;AACtB,MAAM,iBAAiB;AAEvB,MAAM,iBAAiB;AAEvB,SAAgB,aAAa,IAA6B;AACxD,QAAO,OAAO,OAAO,WAAW,KAAM,GAAG,UAAU;;AAGrD,SAAgB,aAAa,KAAqB;AAChD,QAAO,IAAI,QAAQ,4BAA4B,OAAO;;AAGxD,IAAa,MAAb,MAAiB;CACf;CACA,cAAsC,EAAE;CACxC,QAAkB,EAAE;CACpB;CAEA,YAAY,SAA0B,OAAgB;EACpD,IAAI,SAAiB,SAAS;EAC9B,IAAI;AAEJ,MAAI,mBAAmB,QAAQ;AAC7B,OAAI,SAAS,KACX,UAAS,QAAQ;AAEnB,SAAM,QAAQ;QAGd,OAAM;AAKR,MADiB,UAAU,OAAO,SAAS,IAAI,EACjC;AACZ,YAAS,OAAO,QAAQ,KAAK,GAAG;AAChC,SAAM,IAAI,QAAQ,gBAAgB,MAAM;AAEtC,WAAO,EAAE,OAAO,OAAO,IAAI;KAC3B;;AAIJ,MAAI,EAAE,mBAAmB,SAAS;GAChC,IAAI,QAAQ;AACZ,SAAM,IAAI,QAAQ,iBAAiB,KAAK,SAAS;AAE/C,aAAS;AACT,QAAI,MAAM;AACR,SACE,SAAS,WACN,SAAS,YACT,CAAC,KAAK,YAAY,MAErB,MAAK,YAAY,QAAQ;AAK3B,YAAO;;AAET,WAAO;KACP;AACF,QAAK,QAAQ,OAAO,KAAK,KAAK,YAAY;;AAK5C,QAAM,aAAa,IAAI;AACvB,iBAAe,YAAY;EAC3B,MAAM,QAAQ,eAAe,KAAK,IAAI;AACtC,MAAI,OAAO;AACT,QAAK,aAAa;IAChB,IAAI,IAAI,OAAO,GAAG,MAAM,GAAG,UAAU;IACrC,QAAQ,QAAQ,MAAM,OAAO,MAAM,CAAC;IACrC;AACD,SAAM,IAAI,OAAO,MAAM,GAAG,OAAO;;AAGnC,OAAK,KAAK,IAAI,OAAO,KAAK,OAAO;;CAsBnC,IAAI,YAAoB;AACtB,SAAO,KAAK,GAAG;;CAGjB,IAAI,UAAU,OAAe;AAC3B,OAAK,GAAG,YAAY;;CAGtB,aAAa,GAAQ;AACnB,MAAI,KAAK,YAAY;GACnB,MAAM,cAAc,EAAE,MAAM,MAAM,GAAG,EAAE,MAAM;AAC7C,OAAI,KAAK,WAAW,WAAW,KAAK,WAAW,GAAG,KAAK,YAAY,CACjE,QAAO;;AAEX,OAAK,MAAM,QAAQ,KAAK,MACtB,GAAE,QAAQ,EAAE,KAAK,YAAY;AAE/B,SAAO;;CAGT,KAAK,KAAa;EAChB,IAAI;AACJ,SAAQ,IAAI,KAAK,GAAG,KAAK,IAAI,EAAG;AAC9B,OAAI,KAAK,GAAG,cAAc,EAAE,MAC1B,MAAK,GAAG;AACV,OAAI,KAAK,aAAa,EAAE;AACxB,OAAI,KAAK,KACP,QAAO;;;CAIb,QAAQ,KAAa;EACnB,MAAM,UAAU,EAAE;EAClB,IAAI;AACJ,OAAK,GAAG,YAAY;AACpB,SAAQ,IAAI,KAAK,KAAK,IAAI,CACxB,SAAQ,KAAK,EAAE;AAEjB,OAAK,GAAG,YAAY;AAEpB,SAAO;;CAGT,QAAQ,KAAa,aAA+C;EAClE,MAAM,KAAK,OAAO,gBAAgB,aAAa,oBAAoB;AACnE,SAAO,IAAI,QAAQ,KAAK,KAAK,MAAM;AAEjC,UAAO,GAAG,EAAE;IACZ"}

package/dist/common/dispose-defer.cjs

@@ -1,2 +1,134 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkWEF4N7J4cjs = require('../chunk-WEF4N7J4.cjs');require('../chunk-7UA33BQW.cjs');require('../chunk-KYDHX5HW.cjs');require('../chunk-B2XPF5R4.cjs');require('../chunk-VX3R7DUJ.cjs');require('../chunk-JLB5ALZ5.cjs');require('../chunk-ZJQITDTA.cjs');require('../chunk-CWGNDC2T.cjs');require('../chunk-DLVWYIS2.cjs');require('../chunk-SEQAFKIV.cjs');require('../chunk-IVUEQANC.cjs');require('../chunk-IXH5D35S.cjs');require('../chunk-DRKHTT76.cjs');require('../chunk-UXW3L3L6.cjs');require('../chunk-5RHVNJKM.cjs');require('../chunk-P7XCQ7WV.cjs');exports.polyfillUsing = _chunkWEF4N7J4cjs.a; exports.useDefer = _chunkWEF4N7J4cjs.c; exports.useDispose = _chunkWEF4N7J4cjs.b;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_common_data_is = require('./data/is.cjs');
+const require_common_log_log = require('./log/log.cjs');
+const require_common_data_array = require('./data/array.cjs');
+const require_common_exec_promise = require('./exec/promise.cjs');
+
+//#region src/common/dispose-defer.ts
+function polyfillUsing() {
+	try {
+		Symbol.dispose ??= Symbol("Symbol.dispose");
+		Symbol.asyncDispose ??= Symbol("Symbol.asyncDispose");
+	} catch (_) {}
+}
+/** Different kinds of implementations have grown, this should unify them  */
+function callDisposable(disposable) {
+	let result;
+	if (typeof disposable === "function") result = disposable();
+	else if (typeof disposable.dispose === "function") result = disposable.dispose();
+	if (require_common_exec_promise.isPromise(result)) return result;
+}
+function useDispose(opt) {
+	if (opt != null) {
+		if (require_common_data_is.isString(opt)) opt = { name: opt };
+		else if ("debug" in opt && "label" in opt) opt = {
+			name: opt.label,
+			log: opt
+		};
+	}
+	polyfillUsing();
+	const name = opt?.name;
+	const log = opt?.log ?? require_common_log_log.DefaultLogger("zeed:dispose");
+	let _disposed = 0;
+	const tracked = [];
+	function untrack(disposable) {
+		if (disposable != null && tracked.includes(disposable)) {
+			require_common_data_array.arrayFilterInPlace(tracked, (el) => el !== disposable);
+			const result = callDisposable(disposable);
+			if (require_common_exec_promise.isPromise(result)) return result;
+		}
+	}
+	function track(obj) {
+		if (obj == null) return;
+		tracked.unshift(obj);
+		return () => untrack(obj);
+	}
+	/** Dispose all tracked entries */
+	function dispose(strictSync = false) {
+		if (name) log.debug(`dispose "${name}": ${tracked.length} entries`);
+		_disposed += 1;
+		const promises = [];
+		while (tracked.length > 0) {
+			const fn = tracked[0];
+			const result = untrack(fn);
+			if (require_common_exec_promise.isPromise(result)) if (strictSync) throw new Error(`Async disposable found: ${fn} -> ${result}`);
+			else promises.push(result);
+		}
+		if (promises.length > 0) return Promise.all(promises);
+	}
+	/** Dispose all tracked entries in synchronous way. */
+	function disposeSync() {
+		dispose(true);
+	}
+	return Object.assign(dispose, {
+		get disposed() {
+			return _disposed;
+		},
+		add: track,
+		remove: untrack,
+		track,
+		untrack,
+		dispose,
+		disposeSync,
+		sync: disposeSync,
+		exec: dispose,
+		getSize() {
+			return tracked.length;
+		},
+		isDisposed() {
+			return _disposed > 0 && tracked.length === 0;
+		},
+		[Symbol.dispose]() {
+			return dispose();
+		},
+		async [Symbol.asyncDispose]() {
+			return await dispose();
+		}
+	});
+}
+function useDefer(config = {}) {
+	const { mode = "fifo" } = config;
+	const steps = [];
+	polyfillUsing();
+	/**
+	* Executes all steps. If all steps are not Promises, they are executed immediately,
+	* otherwise a Promise is returned.
+	* Note: useDefer defaults to FIFO order; use mode: 'lifo' for LIFO (stack) order.
+	*/
+	const exec = async (expectSync = false) => {
+		while (steps.length > 0) {
+			const step = steps[0];
+			require_common_data_array.arrayFilterInPlace(steps, (el) => el !== step);
+			if (typeof step === "function") {
+				const result = step();
+				if (require_common_exec_promise.isPromise(result)) {
+					if (expectSync) throw new Error(`Expected sync only function, but found async: ${step}`);
+					await result;
+				}
+			} else if (typeof step.dispose === "function") {
+				const result = step.dispose();
+				if (require_common_exec_promise.isPromise(result)) {
+					if (expectSync) throw new Error(`Expected sync only function, but found async: ${step}`);
+					await result;
+				}
+			} else throw new TypeError(`Unhandled disposable: ${step}`);
+		}
+	};
+	const add = (obj) => {
+		if (mode === "lifo") steps.unshift(obj);
+		else steps.push(obj);
+	};
+	return Object.assign(exec, {
+		add,
+		exec,
+		getSize() {
+			return steps.length;
+		}
+	});
+}
+
+//#endregion
+exports.polyfillUsing = polyfillUsing;
+exports.useDefer = useDefer;
+exports.useDispose = useDispose;
 //# sourceMappingURL=dispose-defer.cjs.map

package/dist/common/dispose-defer.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/dirk/work/github-zeed/dist/common/dispose-defer.cjs"],"names":[],"mappings":"AAAA,kIAAwC,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,8HAAyD","file":"/Users/dirk/work/github-zeed/dist/common/dispose-defer.cjs"}
+{"version":3,"file":"dispose-defer.cjs","names":["isPromise","isString","DefaultLogger"],"sources":["../../src/common/dispose-defer.ts"],"sourcesContent":["import type { DisposerFunction } from './dispose-types'\nimport type { LoggerInterface } from './log/log-base'\nimport { arrayFilterInPlace } from './data/array'\nimport { isString } from './data/is'\nimport { isPromise } from './exec/promise'\nimport { DefaultLogger } from './log/log'\n\nexport function polyfillUsing() {\n  try {\n    // @ts-expect-error just a polyfill\n    Symbol.dispose ??= Symbol('Symbol.dispose')\n    // @ts-expect-error just a polyfill\n    Symbol.asyncDispose ??= Symbol('Symbol.asyncDispose')\n  }\n  catch (_) { }\n}\n\n// Symbol.dispose ??= Symbol('Symbol.dispose')\n// Symbol.asyncDispose ??= Symbol('Symbol.asyncDispose')\n\n/** A disposable entry: either a function or an object with a dispose() method. */\ntype DisposableEntry = DisposerFunction | { dispose: DisposerFunction }\n\n/** Different kinds of implementations have grown, this should unify them  */\nfunction callDisposable(disposable: DisposableEntry): Promise<void> | void {\n  let result\n\n  if (typeof disposable === 'function')\n    result = disposable()\n  else if (typeof disposable.dispose === 'function')\n    result = disposable.dispose()\n\n  if (isPromise(result))\n    return result\n}\n\nexport interface UseDisposeConfig {\n  name?: string\n  log?: LoggerInterface\n}\n\nexport function useDispose(opt?: string | UseDisposeConfig | LoggerInterface) {\n  if (opt != null) {\n    if (isString(opt))\n      opt = { name: opt }\n    else if ('debug' in opt && 'label' in opt)\n      opt = { name: opt.label, log: opt }\n  }\n\n  polyfillUsing()\n\n  const name = opt?.name\n  const log = opt?.log ?? DefaultLogger('zeed:dispose')\n\n  let _disposed = 0\n\n  const tracked: DisposableEntry[] = []\n\n  function untrack(disposable: DisposableEntry): Promise<void> | void {\n    if (disposable != null && tracked.includes(disposable)) {\n      arrayFilterInPlace(tracked, el => el !== disposable)\n      const result = callDisposable(disposable)\n      if (isPromise(result))\n        return result\n    }\n  }\n\n  function track(obj?: DisposableEntry): DisposerFunction | undefined {\n    if (obj == null)\n      return\n    tracked.unshift(obj) // LIFO\n    return () => untrack(obj)\n  }\n\n  /** Dispose all tracked entries */\n  function dispose(strictSync = false): Promise<any> | void {\n    if (name)\n      log.debug(`dispose \"${name}\": ${tracked.length} entries`)\n\n    _disposed += 1\n\n    const promises: any[] = []\n    while (tracked.length > 0) {\n      const fn = tracked[0]\n      const result = untrack(fn) // LIFO\n      if (isPromise(result)) {\n        if (strictSync)\n          throw new Error(`Async disposable found: ${fn} -> ${result}`)\n        else\n          promises.push(result)\n      }\n    }\n\n    if (promises.length > 0)\n      return Promise.all(promises)\n  }\n\n  /** Dispose all tracked entries in synchronous way. */\n  function disposeSync(): void {\n    dispose(true)\n  }\n\n  return Object.assign(dispose, {\n    /** Counter that increments each time dispose has been called */\n    get disposed() {\n      return _disposed\n    },\n\n    add: track,\n    remove: untrack,\n\n    /** @deprecated use add */\n    track,\n\n    /** @deprecated use remove */\n    untrack,\n\n    dispose,\n    disposeSync,\n    sync: disposeSync,\n\n    /** @deprecated use dispose */\n    exec: dispose,\n    getSize() {\n      return tracked.length\n    },\n    isDisposed() {\n      return _disposed > 0 && tracked.length === 0\n    },\n\n    [Symbol.dispose]() {\n      return dispose()\n    },\n\n    async [Symbol.asyncDispose]() {\n      return await dispose()\n    },\n\n  })\n}\n\nexport type UseDispose = ReturnType<typeof useDispose>\n\nexport function useDefer(\n  config: {\n    mode?: 'lifo' | 'fifo'\n  } = {},\n) {\n  const { mode = 'fifo' } = config\n  const steps: DisposableEntry[] = []\n\n  polyfillUsing()\n\n  /**\n   * Executes all steps. If all steps are not Promises, they are executed immediately,\n   * otherwise a Promise is returned.\n   * Note: useDefer defaults to FIFO order; use mode: 'lifo' for LIFO (stack) order.\n   */\n  const exec = async (expectSync = false) => {\n    while (steps.length > 0) {\n      const step = steps[0]\n      arrayFilterInPlace(steps, el => el !== step)\n      if (typeof step === 'function') {\n        const result = step()\n        if (isPromise(result)) {\n          if (expectSync) {\n            throw new Error(\n              `Expected sync only function, but found async: ${step}`,\n            )\n          }\n          await result\n        }\n      }\n      else if (typeof step.dispose === 'function') {\n        // Handle objects with a dispose() method (consistent with useDispose)\n        const result = step.dispose()\n        if (isPromise(result)) {\n          if (expectSync) {\n            throw new Error(\n              `Expected sync only function, but found async: ${step}`,\n            )\n          }\n          await result\n        }\n      }\n      else {\n        throw new TypeError(`Unhandled disposable: ${step}`)\n      }\n    }\n  }\n\n  const add = (obj: DisposableEntry) => {\n    if (mode === 'lifo')\n      steps.unshift(obj)\n    else\n      steps.push(obj)\n  }\n\n  return Object.assign(exec, {\n    add,\n    exec,\n    getSize() {\n      return steps.length\n    },\n  })\n}\n\nexport type UseDefer = ReturnType<typeof useDefer>\n"],"mappings":"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"}

package/dist/common/dispose-defer.d.cts

@@ -1,38 +1,2 @@
-import { Disposer, DisposerFunction } from './dispose-types.cjs';
-import { LoggerInterface } from './log/log-base.cjs';
-
-declare function polyfillUsing(): void;
-interface UseDisposeConfig {
-    name?: string;
-    log?: LoggerInterface;
-}
-declare function useDispose(opt?: string | UseDisposeConfig | LoggerInterface): ((strictSync?: boolean) => Promise<any> | void) & {
-    /** Counter that incremends, each time dispose has been called */
-    disposed: number;
-    add: (obj?: Disposer) => DisposerFunction | undefined;
-    remove: (disposable: Disposer) => Promise<void> | void;
-    /** @deprecated use add */
-    track: (obj?: Disposer) => DisposerFunction | undefined;
-    /** @deprecated use remove */
-    untrack: (disposable: Disposer) => Promise<void> | void;
-    dispose: (strictSync?: boolean) => Promise<any> | void;
-    disposeSync: () => void;
-    sync: () => void;
-    /** @deprecated use dispose */
-    exec: (strictSync?: boolean) => Promise<any> | void;
-    getSize(): number;
-    isDisposed(): boolean;
-    [Symbol.dispose](): void | Promise<any>;
-    [Symbol.asyncDispose](): Promise<any>;
-};
-type UseDispose = ReturnType<typeof useDispose>;
-declare function useDefer(config?: {
-    mode?: 'lifo' | 'fifo';
-}): ((expectSync?: boolean) => Promise<void>) & {
-    add: (obj: Disposer) => void;
-    exec: (expectSync?: boolean) => Promise<void>;
-    getSize(): number;
-};
-type UseDefer = ReturnType<typeof useDefer>;
-
-export { type UseDefer, type UseDispose, type UseDisposeConfig, polyfillUsing, useDefer, useDispose };
+import { a as useDefer, i as polyfillUsing, n as UseDispose, o as useDispose, r as UseDisposeConfig, t as UseDefer } from "../dispose-defer-BoCXEHoJ.cjs";
+export { UseDefer, UseDispose, UseDisposeConfig, polyfillUsing, useDefer, useDispose };

package/dist/common/dispose-defer.d.mts

@@ -0,0 +1,2 @@
+import { a as useDefer, i as polyfillUsing, n as UseDispose, o as useDispose, r as UseDisposeConfig, t as UseDefer } from "../dispose-defer-Dr619CtL.mjs";
+export { UseDefer, UseDispose, UseDisposeConfig, polyfillUsing, useDefer, useDispose };

package/dist/common/dispose-defer.mjs

@@ -0,0 +1,131 @@
+import { isString } from "./data/is.mjs";
+import { DefaultLogger } from "./log/log.mjs";
+import { arrayFilterInPlace } from "./data/array.mjs";
+import { isPromise } from "./exec/promise.mjs";
+
+//#region src/common/dispose-defer.ts
+function polyfillUsing() {
+	try {
+		Symbol.dispose ??= Symbol("Symbol.dispose");
+		Symbol.asyncDispose ??= Symbol("Symbol.asyncDispose");
+	} catch (_) {}
+}
+/** Different kinds of implementations have grown, this should unify them  */
+function callDisposable(disposable) {
+	let result;
+	if (typeof disposable === "function") result = disposable();
+	else if (typeof disposable.dispose === "function") result = disposable.dispose();
+	if (isPromise(result)) return result;
+}
+function useDispose(opt) {
+	if (opt != null) {
+		if (isString(opt)) opt = { name: opt };
+		else if ("debug" in opt && "label" in opt) opt = {
+			name: opt.label,
+			log: opt
+		};
+	}
+	polyfillUsing();
+	const name = opt?.name;
+	const log = opt?.log ?? DefaultLogger("zeed:dispose");
+	let _disposed = 0;
+	const tracked = [];
+	function untrack(disposable) {
+		if (disposable != null && tracked.includes(disposable)) {
+			arrayFilterInPlace(tracked, (el) => el !== disposable);
+			const result = callDisposable(disposable);
+			if (isPromise(result)) return result;
+		}
+	}
+	function track(obj) {
+		if (obj == null) return;
+		tracked.unshift(obj);
+		return () => untrack(obj);
+	}
+	/** Dispose all tracked entries */
+	function dispose(strictSync = false) {
+		if (name) log.debug(`dispose "${name}": ${tracked.length} entries`);
+		_disposed += 1;
+		const promises = [];
+		while (tracked.length > 0) {
+			const fn = tracked[0];
+			const result = untrack(fn);
+			if (isPromise(result)) if (strictSync) throw new Error(`Async disposable found: ${fn} -> ${result}`);
+			else promises.push(result);
+		}
+		if (promises.length > 0) return Promise.all(promises);
+	}
+	/** Dispose all tracked entries in synchronous way. */
+	function disposeSync() {
+		dispose(true);
+	}
+	return Object.assign(dispose, {
+		get disposed() {
+			return _disposed;
+		},
+		add: track,
+		remove: untrack,
+		track,
+		untrack,
+		dispose,
+		disposeSync,
+		sync: disposeSync,
+		exec: dispose,
+		getSize() {
+			return tracked.length;
+		},
+		isDisposed() {
+			return _disposed > 0 && tracked.length === 0;
+		},
+		[Symbol.dispose]() {
+			return dispose();
+		},
+		async [Symbol.asyncDispose]() {
+			return await dispose();
+		}
+	});
+}
+function useDefer(config = {}) {
+	const { mode = "fifo" } = config;
+	const steps = [];
+	polyfillUsing();
+	/**
+	* Executes all steps. If all steps are not Promises, they are executed immediately,
+	* otherwise a Promise is returned.
+	* Note: useDefer defaults to FIFO order; use mode: 'lifo' for LIFO (stack) order.
+	*/
+	const exec = async (expectSync = false) => {
+		while (steps.length > 0) {
+			const step = steps[0];
+			arrayFilterInPlace(steps, (el) => el !== step);
+			if (typeof step === "function") {
+				const result = step();
+				if (isPromise(result)) {
+					if (expectSync) throw new Error(`Expected sync only function, but found async: ${step}`);
+					await result;
+				}
+			} else if (typeof step.dispose === "function") {
+				const result = step.dispose();
+				if (isPromise(result)) {
+					if (expectSync) throw new Error(`Expected sync only function, but found async: ${step}`);
+					await result;
+				}
+			} else throw new TypeError(`Unhandled disposable: ${step}`);
+		}
+	};
+	const add = (obj) => {
+		if (mode === "lifo") steps.unshift(obj);
+		else steps.push(obj);
+	};
+	return Object.assign(exec, {
+		add,
+		exec,
+		getSize() {
+			return steps.length;
+		}
+	});
+}
+
+//#endregion
+export { polyfillUsing, useDefer, useDispose };
+//# sourceMappingURL=dispose-defer.mjs.map

package/dist/common/dispose-defer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispose-defer.mjs","names":[],"sources":["../../src/common/dispose-defer.ts"],"sourcesContent":["import type { DisposerFunction } from './dispose-types'\nimport type { LoggerInterface } from './log/log-base'\nimport { arrayFilterInPlace } from './data/array'\nimport { isString } from './data/is'\nimport { isPromise } from './exec/promise'\nimport { DefaultLogger } from './log/log'\n\nexport function polyfillUsing() {\n  try {\n    // @ts-expect-error just a polyfill\n    Symbol.dispose ??= Symbol('Symbol.dispose')\n    // @ts-expect-error just a polyfill\n    Symbol.asyncDispose ??= Symbol('Symbol.asyncDispose')\n  }\n  catch (_) { }\n}\n\n// Symbol.dispose ??= Symbol('Symbol.dispose')\n// Symbol.asyncDispose ??= Symbol('Symbol.asyncDispose')\n\n/** A disposable entry: either a function or an object with a dispose() method. */\ntype DisposableEntry = DisposerFunction | { dispose: DisposerFunction }\n\n/** Different kinds of implementations have grown, this should unify them  */\nfunction callDisposable(disposable: DisposableEntry): Promise<void> | void {\n  let result\n\n  if (typeof disposable === 'function')\n    result = disposable()\n  else if (typeof disposable.dispose === 'function')\n    result = disposable.dispose()\n\n  if (isPromise(result))\n    return result\n}\n\nexport interface UseDisposeConfig {\n  name?: string\n  log?: LoggerInterface\n}\n\nexport function useDispose(opt?: string | UseDisposeConfig | LoggerInterface) {\n  if (opt != null) {\n    if (isString(opt))\n      opt = { name: opt }\n    else if ('debug' in opt && 'label' in opt)\n      opt = { name: opt.label, log: opt }\n  }\n\n  polyfillUsing()\n\n  const name = opt?.name\n  const log = opt?.log ?? DefaultLogger('zeed:dispose')\n\n  let _disposed = 0\n\n  const tracked: DisposableEntry[] = []\n\n  function untrack(disposable: DisposableEntry): Promise<void> | void {\n    if (disposable != null && tracked.includes(disposable)) {\n      arrayFilterInPlace(tracked, el => el !== disposable)\n      const result = callDisposable(disposable)\n      if (isPromise(result))\n        return result\n    }\n  }\n\n  function track(obj?: DisposableEntry): DisposerFunction | undefined {\n    if (obj == null)\n      return\n    tracked.unshift(obj) // LIFO\n    return () => untrack(obj)\n  }\n\n  /** Dispose all tracked entries */\n  function dispose(strictSync = false): Promise<any> | void {\n    if (name)\n      log.debug(`dispose \"${name}\": ${tracked.length} entries`)\n\n    _disposed += 1\n\n    const promises: any[] = []\n    while (tracked.length > 0) {\n      const fn = tracked[0]\n      const result = untrack(fn) // LIFO\n      if (isPromise(result)) {\n        if (strictSync)\n          throw new Error(`Async disposable found: ${fn} -> ${result}`)\n        else\n          promises.push(result)\n      }\n    }\n\n    if (promises.length > 0)\n      return Promise.all(promises)\n  }\n\n  /** Dispose all tracked entries in synchronous way. */\n  function disposeSync(): void {\n    dispose(true)\n  }\n\n  return Object.assign(dispose, {\n    /** Counter that increments each time dispose has been called */\n    get disposed() {\n      return _disposed\n    },\n\n    add: track,\n    remove: untrack,\n\n    /** @deprecated use add */\n    track,\n\n    /** @deprecated use remove */\n    untrack,\n\n    dispose,\n    disposeSync,\n    sync: disposeSync,\n\n    /** @deprecated use dispose */\n    exec: dispose,\n    getSize() {\n      return tracked.length\n    },\n    isDisposed() {\n      return _disposed > 0 && tracked.length === 0\n    },\n\n    [Symbol.dispose]() {\n      return dispose()\n    },\n\n    async [Symbol.asyncDispose]() {\n      return await dispose()\n    },\n\n  })\n}\n\nexport type UseDispose = ReturnType<typeof useDispose>\n\nexport function useDefer(\n  config: {\n    mode?: 'lifo' | 'fifo'\n  } = {},\n) {\n  const { mode = 'fifo' } = config\n  const steps: DisposableEntry[] = []\n\n  polyfillUsing()\n\n  /**\n   * Executes all steps. If all steps are not Promises, they are executed immediately,\n   * otherwise a Promise is returned.\n   * Note: useDefer defaults to FIFO order; use mode: 'lifo' for LIFO (stack) order.\n   */\n  const exec = async (expectSync = false) => {\n    while (steps.length > 0) {\n      const step = steps[0]\n      arrayFilterInPlace(steps, el => el !== step)\n      if (typeof step === 'function') {\n        const result = step()\n        if (isPromise(result)) {\n          if (expectSync) {\n            throw new Error(\n              `Expected sync only function, but found async: ${step}`,\n            )\n          }\n          await result\n        }\n      }\n      else if (typeof step.dispose === 'function') {\n        // Handle objects with a dispose() method (consistent with useDispose)\n        const result = step.dispose()\n        if (isPromise(result)) {\n          if (expectSync) {\n            throw new Error(\n              `Expected sync only function, but found async: ${step}`,\n            )\n          }\n          await result\n        }\n      }\n      else {\n        throw new TypeError(`Unhandled disposable: ${step}`)\n      }\n    }\n  }\n\n  const add = (obj: DisposableEntry) => {\n    if (mode === 'lifo')\n      steps.unshift(obj)\n    else\n      steps.push(obj)\n  }\n\n  return Object.assign(exec, {\n    add,\n    exec,\n    getSize() {\n      return steps.length\n    },\n  })\n}\n\nexport type UseDefer = ReturnType<typeof useDefer>\n"],"mappings":"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"}

package/dist/common/dispose-types.cjs

@@ -1,2 +0,0 @@
-"use strict";require('../chunk-WPWV7ZEM.cjs');
-//# sourceMappingURL=dispose-types.cjs.map

package/dist/common/dispose-types.d.cts

@@ -1,7 +1,2 @@
-type DisposerFunction = () => any | Promise<any>;
-/** @deprecated conflicts with `using` feature */
-type Disposer = DisposerFunction | {
-    dispose: DisposerFunction;
-};
-
-export type { Disposer, DisposerFunction };
+import { n as DisposerFunction, t as Disposer } from "../dispose-types-CVL-NcAL.cjs";
+export { Disposer, DisposerFunction };

package/dist/common/dispose-types.d.mts

@@ -0,0 +1,2 @@
+import { n as DisposerFunction, t as Disposer } from "../dispose-types-Duihe1hZ.mjs";
+export { Disposer, DisposerFunction };

package/dist/common/dispose-types.mjs

@@ -0,0 +1 @@
+export {  };

package/dist/common/dispose-utils.cjs

@@ -1,2 +1,114 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkNVLQ55J2cjs = require('../chunk-NVLQ55J2.cjs');require('../chunk-WEF4N7J4.cjs');require('../chunk-7UA33BQW.cjs');require('../chunk-KYDHX5HW.cjs');require('../chunk-B2XPF5R4.cjs');require('../chunk-VX3R7DUJ.cjs');require('../chunk-JLB5ALZ5.cjs');require('../chunk-ZJQITDTA.cjs');require('../chunk-CWGNDC2T.cjs');require('../chunk-DLVWYIS2.cjs');require('../chunk-SEQAFKIV.cjs');require('../chunk-IVUEQANC.cjs');require('../chunk-IXH5D35S.cjs');require('../chunk-DRKHTT76.cjs');require('../chunk-UXW3L3L6.cjs');require('../chunk-5RHVNJKM.cjs');require('../chunk-P7XCQ7WV.cjs');exports.noopDisposer = _chunkNVLQ55J2cjs.a; exports.useDisposeWithUtils = _chunkNVLQ55J2cjs.g; exports.useEventListener = _chunkNVLQ55J2cjs.e; exports.useEventListenerOnce = _chunkNVLQ55J2cjs.f; exports.useInterval = _chunkNVLQ55J2cjs.c; exports.useIntervalPause = _chunkNVLQ55J2cjs.d; exports.useTimeout = _chunkNVLQ55J2cjs.b;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_common_exec_promise = require('./exec/promise.cjs');
+const require_common_dispose_defer = require('./dispose-defer.cjs');
+
+//#region src/common/dispose-utils.ts
+function _createNoopDispose() {
+	const fn = () => {};
+	fn[Symbol.dispose] = fn;
+	return fn;
+}
+const _noopDispose = _createNoopDispose();
+/** Returns a no-op disposer (shared instance, no allocation per call). */
+const noopDisposer = () => _noopDispose;
+/**
+* Executes a function after a specified timeout and returns a disposer function
+* that can be used to cancel the timeout.
+*
+* @param fn - The function to execute after the timeout.
+* @param timeout - The timeout duration in milliseconds (default: 0).
+* @returns A disposer function that can be used to cancel the timeout.
+*/
+function useTimeout(fn, timeout = 0) {
+	let timeoutHandle = setTimeout(fn, timeout);
+	const dispose = () => {
+		if (timeoutHandle) {
+			clearTimeout(timeoutHandle);
+			timeoutHandle = void 0;
+		}
+	};
+	dispose[Symbol.dispose] = dispose;
+	return dispose;
+}
+/**
+* Executes a function repeatedly at a specified interval and returns a disposer function
+* that can be used to stop the execution.
+*
+* @param fn - The function to be executed at the specified interval.
+* @param interval - The interval (in milliseconds) at which the function should be executed.
+* @returns A disposer function that can be used to stop the execution of the function.
+*/
+function useInterval(fn, interval) {
+	let intervalHandle = setInterval(fn, interval);
+	const dispose = () => {
+		if (intervalHandle) {
+			clearInterval(intervalHandle);
+			intervalHandle = void 0;
+		}
+	};
+	dispose[Symbol.dispose] = dispose;
+	return dispose;
+}
+/** The interval starts only, when the function is finished. */
+function useIntervalPause(fn, interval, immediately = false) {
+	let intervalHandle;
+	let stop = false;
+	async function loop(exec = false) {
+		if (exec) await require_common_exec_promise.promisify(fn());
+		if (!stop) intervalHandle = setTimeout(loop, interval, true);
+	}
+	loop(immediately);
+	const dispose = () => {
+		if (intervalHandle) {
+			stop = true;
+			clearTimeout(intervalHandle);
+			intervalHandle = void 0;
+		}
+	};
+	dispose[Symbol.dispose] = dispose;
+	return dispose;
+}
+function useEventListener(emitter, eventName, fn, ...args) {
+	if (emitter == null) return noopDisposer();
+	if (emitter.on) emitter.on(eventName, fn, ...args);
+	else if (emitter.addEventListener) emitter.addEventListener(eventName, fn, ...args);
+	const dispose = () => {
+		if (emitter.off) emitter.off(eventName, fn, ...args);
+		else if (emitter.removeEventListener) emitter.removeEventListener(eventName, fn, ...args);
+	};
+	dispose[Symbol.dispose] = dispose;
+	return dispose;
+}
+function useEventListenerOnce(emitter, eventName, fn, ...args) {
+	if (emitter == null) return noopDisposer();
+	if (emitter.once) emitter.once(eventName, fn, ...args);
+	else if (emitter.on) emitter.on(eventName, fn, ...args);
+	else if (emitter.addEventListener) emitter.addEventListener(eventName, fn, ...args);
+	const dispose = () => {
+		if (emitter.off) emitter.off(eventName, fn, ...args);
+		else if (emitter.removeEventListener) emitter.removeEventListener(eventName, fn, ...args);
+	};
+	dispose[Symbol.dispose] = dispose;
+	return dispose;
+}
+/** Like useDispose but with shorthands for emitter and timers */
+function useDisposeWithUtils(config) {
+	const dispose = require_common_dispose_defer.useDispose(config);
+	return Object.assign(dispose, {
+		timeout: (fn, timeout = 0) => dispose.add(useTimeout(fn, timeout)),
+		interval: (fn, interval = 0) => dispose.add(useInterval(fn, interval)),
+		intervalPause: (fn, interval = 0) => dispose.add(useIntervalPause(fn, interval)),
+		on: (emitter, eventName, fn, ...args) => dispose.add(useEventListener(emitter, eventName, fn, ...args)),
+		once: (emitter, eventName, fn, ...args) => dispose.add(useEventListenerOnce(emitter, eventName, fn, ...args))
+	});
+}
+
+//#endregion
+exports.noopDisposer = noopDisposer;
+exports.useDisposeWithUtils = useDisposeWithUtils;
+exports.useEventListener = useEventListener;
+exports.useEventListenerOnce = useEventListenerOnce;
+exports.useInterval = useInterval;
+exports.useIntervalPause = useIntervalPause;
+exports.useTimeout = useTimeout;
 //# sourceMappingURL=dispose-utils.cjs.map

package/dist/common/dispose-utils.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/dirk/work/github-zeed/dist/common/dispose-utils.cjs"],"names":[],"mappings":"AAAA,kIAAgD,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,uUAA0J","file":"/Users/dirk/work/github-zeed/dist/common/dispose-utils.cjs"}
+{"version":3,"file":"dispose-utils.cjs","names":["promisify","useDispose"],"sources":["../../src/common/dispose-utils.ts"],"sourcesContent":["import type { UseDisposeConfig } from './dispose-defer'\nimport type { DisposerFunction } from './dispose-types'\nimport type { LoggerInterface } from './log/log-base'\nimport { useDispose } from './dispose-defer'\nimport { promisify } from './exec/promise'\n\nexport type TimerExecFunction = () => void | Promise<void>\n\nfunction _createNoopDispose() {\n  const fn = () => {}\n  fn[Symbol.dispose] = fn\n  return fn as unknown as DisposerFunction\n}\n\nconst _noopDispose = _createNoopDispose()\n\n/** Returns a no-op disposer (shared instance, no allocation per call). */\nexport const noopDisposer: () => DisposerFunction = () => _noopDispose\n\n/**\n * Executes a function after a specified timeout and returns a disposer function\n * that can be used to cancel the timeout.\n *\n * @param fn - The function to execute after the timeout.\n * @param timeout - The timeout duration in milliseconds (default: 0).\n * @returns A disposer function that can be used to cancel the timeout.\n */\nexport function useTimeout(fn: TimerExecFunction, timeout = 0): DisposerFunction {\n  let timeoutHandle: any = setTimeout(fn, timeout)\n  const dispose = () => {\n    if (timeoutHandle) {\n      clearTimeout(timeoutHandle)\n      timeoutHandle = undefined\n    }\n  }\n  dispose[Symbol.dispose] = dispose\n  return dispose\n}\n\n/**\n * Executes a function repeatedly at a specified interval and returns a disposer function\n * that can be used to stop the execution.\n *\n * @param fn - The function to be executed at the specified interval.\n * @param interval - The interval (in milliseconds) at which the function should be executed.\n * @returns A disposer function that can be used to stop the execution of the function.\n */\nexport function useInterval(fn: TimerExecFunction, interval: number): DisposerFunction {\n  let intervalHandle: any = setInterval(fn, interval)\n  const dispose = () => {\n    if (intervalHandle) {\n      clearInterval(intervalHandle)\n      intervalHandle = undefined\n    }\n  }\n  dispose[Symbol.dispose] = dispose\n  return dispose\n}\n\n/** The interval starts only, when the function is finished. */\nexport function useIntervalPause(fn: TimerExecFunction, interval: number, immediately = false): DisposerFunction {\n  let intervalHandle: any\n  let stop = false\n\n  async function loop(exec = false) {\n    if (exec)\n      await promisify(fn())\n    if (!stop)\n      intervalHandle = setTimeout(loop, interval, true)\n  }\n\n  void loop(immediately)\n\n  const dispose = () => {\n    if (intervalHandle) {\n      stop = true\n      clearTimeout(intervalHandle) // uses setTimeout internally, so clearTimeout is correct\n      intervalHandle = undefined\n    }\n  }\n  dispose[Symbol.dispose] = dispose\n  return dispose\n}\n\nexport function useEventListener(\n  emitter: any,\n  eventName: string,\n  fn: (ev?: any) => void,\n  ...args: any[]\n): DisposerFunction {\n  if (emitter == null)\n    return noopDisposer()\n  if (emitter.on)\n    emitter.on(eventName, fn, ...args)\n  else if (emitter.addEventListener)\n    emitter.addEventListener(eventName, fn, ...args)\n  const dispose = () => {\n    if (emitter.off)\n      emitter.off(eventName, fn, ...args)\n    else if (emitter.removeEventListener)\n      emitter.removeEventListener(eventName, fn, ...args)\n  }\n  dispose[Symbol.dispose] = dispose\n  return dispose\n}\n\nexport function useEventListenerOnce(\n  emitter: any,\n  eventName: string,\n  fn: (ev?: any) => void,\n  ...args: any[]\n): DisposerFunction {\n  if (emitter == null)\n    return noopDisposer()\n  if (emitter.once)\n    emitter.once(eventName, fn, ...args)\n  else if (emitter.on)\n    emitter.on(eventName, fn, ...args)\n  else if (emitter.addEventListener)\n    emitter.addEventListener(eventName, fn, ...args)\n  const dispose = () => {\n    if (emitter.off)\n      emitter.off(eventName, fn, ...args)\n    else if (emitter.removeEventListener)\n      emitter.removeEventListener(eventName, fn, ...args)\n  }\n  dispose[Symbol.dispose] = dispose\n  return dispose\n}\n\n/** Like useDispose but with shorthands for emitter and timers */\nexport function useDisposeWithUtils(config?: string | UseDisposeConfig | LoggerInterface) {\n  const dispose = useDispose(config)\n  return Object.assign(dispose, {\n    timeout: (fn: TimerExecFunction, timeout = 0) => dispose.add(useTimeout(fn, timeout))!,\n    interval: (fn: TimerExecFunction, interval = 0) => dispose.add(useInterval(fn, interval))!,\n    intervalPause: (fn: TimerExecFunction, interval = 0) => dispose.add(useIntervalPause(fn, interval))!,\n    on: (emitter: any, eventName: string, fn: (ev?: any) => void, ...args: any[]) => dispose.add(useEventListener(emitter, eventName, fn, ...args))!,\n    once: (emitter: any, eventName: string, fn: (ev?: any) => void, ...args: any[]) => dispose.add(useEventListenerOnce(emitter, eventName, fn, ...args))!,\n  })\n}\n\nexport type UseDisposeWithUtils = ReturnType<typeof useDisposeWithUtils>\n"],"mappings":";;;;;AAQA,SAAS,qBAAqB;CAC5B,MAAM,WAAW;AACjB,IAAG,OAAO,WAAW;AACrB,QAAO;;AAGT,MAAM,eAAe,oBAAoB;;AAGzC,MAAa,qBAA6C;;;;;;;;;AAU1D,SAAgB,WAAW,IAAuB,UAAU,GAAqB;CAC/E,IAAI,gBAAqB,WAAW,IAAI,QAAQ;CAChD,MAAM,gBAAgB;AACpB,MAAI,eAAe;AACjB,gBAAa,cAAc;AAC3B,mBAAgB;;;AAGpB,SAAQ,OAAO,WAAW;AAC1B,QAAO;;;;;;;;;;AAWT,SAAgB,YAAY,IAAuB,UAAoC;CACrF,IAAI,iBAAsB,YAAY,IAAI,SAAS;CACnD,MAAM,gBAAgB;AACpB,MAAI,gBAAgB;AAClB,iBAAc,eAAe;AAC7B,oBAAiB;;;AAGrB,SAAQ,OAAO,WAAW;AAC1B,QAAO;;;AAIT,SAAgB,iBAAiB,IAAuB,UAAkB,cAAc,OAAyB;CAC/G,IAAI;CACJ,IAAI,OAAO;CAEX,eAAe,KAAK,OAAO,OAAO;AAChC,MAAI,KACF,OAAMA,sCAAU,IAAI,CAAC;AACvB,MAAI,CAAC,KACH,kBAAiB,WAAW,MAAM,UAAU,KAAK;;AAGrD,CAAK,KAAK,YAAY;CAEtB,MAAM,gBAAgB;AACpB,MAAI,gBAAgB;AAClB,UAAO;AACP,gBAAa,eAAe;AAC5B,oBAAiB;;;AAGrB,SAAQ,OAAO,WAAW;AAC1B,QAAO;;AAGT,SAAgB,iBACd,SACA,WACA,IACA,GAAG,MACe;AAClB,KAAI,WAAW,KACb,QAAO,cAAc;AACvB,KAAI,QAAQ,GACV,SAAQ,GAAG,WAAW,IAAI,GAAG,KAAK;UAC3B,QAAQ,iBACf,SAAQ,iBAAiB,WAAW,IAAI,GAAG,KAAK;CAClD,MAAM,gBAAgB;AACpB,MAAI,QAAQ,IACV,SAAQ,IAAI,WAAW,IAAI,GAAG,KAAK;WAC5B,QAAQ,oBACf,SAAQ,oBAAoB,WAAW,IAAI,GAAG,KAAK;;AAEvD,SAAQ,OAAO,WAAW;AAC1B,QAAO;;AAGT,SAAgB,qBACd,SACA,WACA,IACA,GAAG,MACe;AAClB,KAAI,WAAW,KACb,QAAO,cAAc;AACvB,KAAI,QAAQ,KACV,SAAQ,KAAK,WAAW,IAAI,GAAG,KAAK;UAC7B,QAAQ,GACf,SAAQ,GAAG,WAAW,IAAI,GAAG,KAAK;UAC3B,QAAQ,iBACf,SAAQ,iBAAiB,WAAW,IAAI,GAAG,KAAK;CAClD,MAAM,gBAAgB;AACpB,MAAI,QAAQ,IACV,SAAQ,IAAI,WAAW,IAAI,GAAG,KAAK;WAC5B,QAAQ,oBACf,SAAQ,oBAAoB,WAAW,IAAI,GAAG,KAAK;;AAEvD,SAAQ,OAAO,WAAW;AAC1B,QAAO;;;AAIT,SAAgB,oBAAoB,QAAsD;CACxF,MAAM,UAAUC,wCAAW,OAAO;AAClC,QAAO,OAAO,OAAO,SAAS;EAC5B,UAAU,IAAuB,UAAU,MAAM,QAAQ,IAAI,WAAW,IAAI,QAAQ,CAAC;EACrF,WAAW,IAAuB,WAAW,MAAM,QAAQ,IAAI,YAAY,IAAI,SAAS,CAAC;EACzF,gBAAgB,IAAuB,WAAW,MAAM,QAAQ,IAAI,iBAAiB,IAAI,SAAS,CAAC;EACnG,KAAK,SAAc,WAAmB,IAAwB,GAAG,SAAgB,QAAQ,IAAI,iBAAiB,SAAS,WAAW,IAAI,GAAG,KAAK,CAAC;EAC/I,OAAO,SAAc,WAAmB,IAAwB,GAAG,SAAgB,QAAQ,IAAI,qBAAqB,SAAS,WAAW,IAAI,GAAG,KAAK,CAAC;EACtJ,CAAC"}