zeed 1.2.4 → 1.3.1

package/dist/common/exec/progress.mjs

@@ -0,0 +1,149 @@
+import { arrayRemoveElement } from "../data/array.mjs";
+import { useDispose } from "../dispose-defer.mjs";
+import { Emitter } from "../msg/emitter.mjs";
+import { uname } from "../uuid.mjs";
+
+//#region src/common/exec/progress.ts
+/**
+* Progress helper with these properties:
+*
+* - `totalUnits` and `completedUnits` for progress
+* - Can be cancelled
+* - Sends events on cancel, changed and dispose
+* - Supports children and propagates values.
+*   Total progress is sum of all units in the tree.
+* - On `dispose` child removes itself from parent.
+*/
+var Progress = class Progress extends Emitter {
+	_totalUnits;
+	_completedUnits;
+	_isCancelled = false;
+	_resetWhenFinished = true;
+	_children = [];
+	dispose = useDispose();
+	name;
+	constructor(opt = {}) {
+		super();
+		this._totalUnits = opt.totalUnits ?? 0;
+		this._completedUnits = opt.completeUnits ?? 0;
+		this._resetWhenFinished = opt.resetWhenFinished ?? true;
+		this.name = opt.name ?? uname("progress");
+		this.dispose.add(async () => {
+			for (const child of this._children) await child.dispose();
+			await this.emit("progressDispose", this);
+		});
+	}
+	/** Notify others about changes and reset on completion, if flag is set. */
+	update() {
+		this.emit("progressChanged", this);
+		if (this._isCancelled && this._resetWhenFinished) {
+			if (this.getTotalUnits() <= this.getCompletedUnits()) this.reset();
+		}
+	}
+	/** Fresh start */
+	reset() {
+		if (this._isCancelled) {
+			this._isCancelled = false;
+			for (const child of this._children) child.reset();
+			this.update();
+		}
+	}
+	/** Notify and mark as cancelled. May take some time before having an effect. */
+	async cancel() {
+		if (!this._isCancelled) {
+			this._isCancelled = true;
+			await this.emit("progressCancelled", this);
+			for (const child of this._children) await child.cancel();
+			this.update();
+		}
+	}
+	/** Add child progress, which count into its parents units. On `dispose` it will auto remove itself from parent. */
+	addChild(child) {
+		child.on("progressDispose", () => this.removeChild(child));
+		child.on("progressChanged", () => this.update());
+		if (!this._children.includes(child)) this._children.push(child);
+		this.update();
+	}
+	/** Create child progress.  */
+	createChildProgress(opt) {
+		const progress = new Progress(opt);
+		this.addChild(progress);
+		return progress;
+	}
+	removeChild(child) {
+		arrayRemoveElement(this._children, child);
+		this.update();
+	}
+	/** Total units including children */
+	getTotalUnits() {
+		if (this.isIndeterminate()) return 0;
+		let units = this._totalUnits;
+		for (const child of this._children) units += child.getTotalUnits();
+		return units;
+	}
+	/** Completed units including children */
+	getCompletedUnits() {
+		if (this.isIndeterminate()) return 0;
+		let units = this._completedUnits;
+		for (const child of this._children) units += child.getCompletedUnits();
+		return units;
+	}
+	/** Cannot calculate progress, because totalUnits are missing. Special representation in UI. */
+	isIndeterminate() {
+		return this._totalUnits <= 0 && this._children.length <= 0;
+	}
+	isCancelled() {
+		return this._isCancelled;
+	}
+	/** Either disposed or all units completed. */
+	isFinished() {
+		return this.dispose.isDisposed() || !this.isIndeterminate() && this.getTotalUnits() <= this.getCompletedUnits();
+	}
+	/** Value from 0 to 1, where 1 is 100% completeness. */
+	getFraction() {
+		if (this.isIndeterminate()) return 0;
+		let value = this.getCompletedUnits() / this.getTotalUnits();
+		if (Number.isNaN(value)) value = 0;
+		return Math.min(1, Math.max(0, value));
+	}
+	getChildrenCount() {
+		return this._children.length;
+	}
+	/** Change total units. */
+	setTotalUnits(units, completedUnits) {
+		this._totalUnits = units;
+		if (completedUnits != null) this._completedUnits = completedUnits;
+		this.update();
+	}
+	/** Relatively change total units. */
+	incTotalUnits(step = 1) {
+		this._totalUnits += step;
+		this.update();
+	}
+	/** Set fixed number of completed units. */
+	setCompletetedUnits(units) {
+		this._completedUnits = units;
+		this.update();
+	}
+	/** Set to 100% without disposing. */
+	setCompleted() {
+		this._completedUnits = this._totalUnits;
+		this.update();
+	}
+	/** Dynamically change completed units. */
+	incCompletedUnits(step = 1) {
+		this._completedUnits += step;
+		this.update();
+	}
+	/** Progress tree to string for debuggin purposes. Consider using `name` attribute of Progress. */
+	toString(indent = 0) {
+		let s = `${"  ".repeat(indent)}${this.name}: ${this._completedUnits} of ${this._totalUnits} units, ${Math.floor(this.getFraction() * 100)} %, cancel=${this._isCancelled}\n`;
+		for (const child of this._children) s += child.toString(indent + 1);
+		if (indent === 0) return s.trim();
+		return s;
+	}
+};
+
+//#endregion
+export { Progress };
+//# sourceMappingURL=progress.mjs.map

package/dist/common/exec/progress.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.mjs","names":[],"sources":["../../../src/common/exec/progress.ts"],"sourcesContent":["// Inspired by https://developer.apple.com/documentation/foundation/progress\n\nimport { arrayRemoveElement } from '../data/array'\nimport { useDispose } from '../dispose-defer'\nimport { Emitter } from '../msg/emitter'\nimport { uname } from '../uuid'\n\nexport interface ProgressOptions {\n  totalUnits?: number\n  completeUnits?: number\n  resetWhenFinished?: boolean\n  name?: string\n}\n\n/**\n * Progress helper with these properties:\n *\n * - `totalUnits` and `completedUnits` for progress\n * - Can be cancelled\n * - Sends events on cancel, changed and dispose\n * - Supports children and propagates values.\n *   Total progress is sum of all units in the tree.\n * - On `dispose` child removes itself from parent.\n */\nexport class Progress extends Emitter<{\n  progressCancelled: (progress: Progress) => void\n  progressChanged: (progress: Progress) => void\n  progressDispose: (progress: Progress) => void\n}> {\n  private _totalUnits: number\n  private _completedUnits: number\n  private _isCancelled = false\n  private _resetWhenFinished = true\n  private _children: Progress[] = []\n\n  dispose = useDispose()\n  name: string\n\n  constructor(opt: ProgressOptions = {}) {\n    super()\n\n    this._totalUnits = opt.totalUnits ?? 0\n    this._completedUnits = opt.completeUnits ?? 0\n    this._resetWhenFinished = opt.resetWhenFinished ?? true\n    this.name = opt.name ?? uname('progress')\n\n    // Make sure to cleanup also children\n    this.dispose.add(async () => {\n      for (const child of this._children)\n        await child.dispose()\n      await this.emit('progressDispose', this)\n    })\n  }\n\n  /** Notify others about changes and reset on completion, if flag is set. */\n  private update() {\n    void this.emit('progressChanged', this)\n\n    if (this._isCancelled && this._resetWhenFinished) {\n      if (this.getTotalUnits() <= this.getCompletedUnits())\n        this.reset()\n    }\n  }\n\n  /** Fresh start */\n  reset() {\n    if (this._isCancelled) {\n      this._isCancelled = false\n      for (const child of this._children)\n        child.reset()\n      this.update()\n    }\n  }\n\n  /** Notify and mark as cancelled. May take some time before having an effect. */\n  async cancel() {\n    if (!this._isCancelled) {\n      this._isCancelled = true\n      await this.emit('progressCancelled', this)\n      for (const child of this._children)\n        await child.cancel()\n      this.update()\n    }\n  }\n\n  /** Add child progress, which count into its parents units. On `dispose` it will auto remove itself from parent. */\n  addChild(child: Progress) {\n    child.on('progressDispose', () => this.removeChild(child))\n    child.on('progressChanged', () => this.update())\n    if (!this._children.includes(child))\n      this._children.push(child)\n    this.update()\n  }\n\n  /** Create child progress.  */\n  createChildProgress(opt?: ProgressOptions) {\n    const progress = new Progress(opt)\n    this.addChild(progress)\n    return progress\n  }\n\n  removeChild(child: Progress) {\n    arrayRemoveElement(this._children, child)\n    this.update()\n  }\n\n  /** Total units including children */\n  getTotalUnits(): number {\n    if (this.isIndeterminate())\n      return 0\n    let units = this._totalUnits\n    for (const child of this._children)\n      units += child.getTotalUnits()\n    return units\n  }\n\n  /** Completed units including children */\n  getCompletedUnits(): number {\n    if (this.isIndeterminate())\n      return 0\n    let units = this._completedUnits\n    for (const child of this._children)\n      units += child.getCompletedUnits()\n    return units\n    //  return Math.min(this.getTotalUnits(), units)\n  }\n\n  /** Cannot calculate progress, because totalUnits are missing. Special representation in UI. */\n  isIndeterminate(): boolean {\n    return this._totalUnits <= 0 && this._children.length <= 0\n  }\n\n  isCancelled() {\n    return this._isCancelled\n  }\n\n  /** Either disposed or all units completed. */\n  isFinished() {\n    return this.dispose.isDisposed() || (!this.isIndeterminate() && (this.getTotalUnits() <= this.getCompletedUnits()))\n  }\n\n  /** Value from 0 to 1, where 1 is 100% completeness. */\n  getFraction() {\n    if (this.isIndeterminate())\n      return 0\n    let value = this.getCompletedUnits() / this.getTotalUnits()\n    if (Number.isNaN(value))\n      value = 0\n    return Math.min(1, Math.max(0, value))\n  }\n\n  getChildrenCount() {\n    return this._children.length\n  }\n\n  /** Change total units. */\n  setTotalUnits(units: number, completedUnits?: number) {\n    this._totalUnits = units\n    if (completedUnits != null)\n      this._completedUnits = completedUnits\n    this.update()\n  }\n\n  /** Relatively change total units. */\n  incTotalUnits(step = 1) {\n    this._totalUnits += step\n    this.update()\n  }\n\n  /** Set fixed number of completed units. */\n  setCompletetedUnits(units: number) {\n    this._completedUnits = units\n    this.update()\n  }\n\n  /** Set to 100% without disposing. */\n  setCompleted() {\n    this._completedUnits = this._totalUnits\n    this.update()\n  }\n\n  /** Dynamically change completed units. */\n  incCompletedUnits(step = 1) {\n    this._completedUnits += step\n    this.update()\n  }\n\n  /** Progress tree to string for debuggin purposes. Consider using `name` attribute of Progress. */\n  toString(indent = 0) {\n    let s = `${'  '.repeat(indent)}${this.name}: ${this._completedUnits} of ${this._totalUnits} units, ${Math.floor(this.getFraction() * 100)} %, cancel=${this._isCancelled}\\n`\n    for (const child of this._children)\n      s += child.toString(indent + 1)\n    if (indent === 0)\n      return s.trim()\n    return s\n  }\n}\n"],"mappings":"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"}

package/dist/common/exec/promise.cjs

@@ -1,2 +1,114 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk7UA33BQWcjs = require('../../chunk-7UA33BQW.cjs');require('../../chunk-P7XCQ7WV.cjs');exports.createPromise = _chunk7UA33BQWcjs.a; exports.immediate = _chunk7UA33BQWcjs.c; exports.isPromise = _chunk7UA33BQWcjs.h; exports.isTimeout = _chunk7UA33BQWcjs.e; exports.promisify = _chunk7UA33BQWcjs.i; exports.sleep = _chunk7UA33BQWcjs.b; exports.timeout = _chunk7UA33BQWcjs.d; exports.tryTimeout = _chunk7UA33BQWcjs.f; exports.waitOn = _chunk7UA33BQWcjs.g;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/common/exec/promise.ts
+/**
+* Promise to be used with `await`. Example:
+*
+* ```
+* const [promise, resolve, reject] = createPromise()
+* setTimeout(() => {
+*   resolve(5)
+* }, 50)
+* const result = await promise
+* ```
+*/
+function createPromise() {
+	let resolve, reject;
+	return [
+		new Promise((_resolve, _reject) => {
+			resolve = _resolve;
+			reject = _reject;
+		}),
+		resolve,
+		reject
+	];
+}
+/** Sleep for `milliSeconds`. Example 1s: `await sleep(1000)` */
+async function sleep(milliSeconds) {
+	return new Promise((resolve) => setTimeout(resolve, milliSeconds));
+}
+/** Same as `await sleep(0)`, just let the event loop execute. */
+async function immediate() {
+	return new Promise((resolve) => setTimeout(resolve, 0));
+}
+async function timeout(promise, milliSeconds, timeoutValue = "timeoutReached") {
+	return new Promise((resolve, reject) => {
+		let done = false;
+		const timeout = setTimeout(() => {
+			done = true;
+			resolve(timeoutValue);
+		}, milliSeconds);
+		promise.then((result) => {
+			clearTimeout(timeout);
+			if (!done) resolve(result);
+		}).catch((err) => {
+			clearTimeout(timeout);
+			if (!done) reject(err);
+		});
+	});
+}
+function isTimeout(value) {
+	return value === "timeoutReached" || value?.name === "Timeout reached";
+}
+async function tryTimeout(promise, milliSeconds) {
+	if (milliSeconds <= 0) return await promise;
+	return new Promise((resolve, reject) => {
+		let done = false;
+		const timeout = setTimeout(() => {
+			done = true;
+			reject(/* @__PURE__ */ new Error("Timeout reached"));
+		}, milliSeconds);
+		promise.then((result) => {
+			clearTimeout(timeout);
+			if (!done) resolve(result);
+		}).catch((err) => {
+			clearTimeout(timeout);
+			if (!done) reject(err);
+		});
+	});
+}
+/**
+* @deprecated use emitter.waitOn
+* Wait for `event` on `obj` to emit. Resolve with result or reject on `timeout`
+*/
+function waitOn(obj, event, timeoutMS = 1e3) {
+	return new Promise((resolve, reject) => {
+		const fn = (value) => {
+			if (timer) {
+				clearTimeout(timer);
+				done();
+				resolve(value);
+			}
+		};
+		let done = () => {
+			timer = null;
+			if (obj.off) obj.off(event, fn);
+			else if (obj.removeEventListener) obj.removeEventListener(event, fn);
+		};
+		let timer = setTimeout(() => {
+			done();
+			reject(/* @__PURE__ */ new Error("Did not response in time"));
+		}, timeoutMS);
+		if (obj.on) obj.on(event, fn);
+		else if (obj.addEventListener) obj.addEventListener(event, fn);
+	});
+}
+function isPromise(value) {
+	return Boolean(value && (value instanceof Promise || typeof value.then === "function"));
+}
+/** This is exactly what Prose.resolve(x) is supposed to be: return a Promise no matter what type x is */
+function promisify(value) {
+	return Promise.resolve(value);
+}
+
+//#endregion
+exports.createPromise = createPromise;
+exports.immediate = immediate;
+exports.isPromise = isPromise;
+exports.isTimeout = isTimeout;
+exports.promisify = promisify;
+exports.sleep = sleep;
+exports.timeout = timeout;
+exports.tryTimeout = tryTimeout;
+exports.waitOn = waitOn;
 //# sourceMappingURL=promise.cjs.map

package/dist/common/exec/promise.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/dirk/work/github-zeed/dist/common/exec/promise.cjs"],"names":[],"mappings":"AAAA,qIAAuD,oCAAiC,4WAA2I","file":"/Users/dirk/work/github-zeed/dist/common/exec/promise.cjs"}
+{"version":3,"file":"promise.cjs","names":[],"sources":["../../../src/common/exec/promise.ts"],"sourcesContent":["/* eslint-disable ts/no-use-before-define */\n\n/**\n * Promise to be used with `await`. Example:\n *\n * ```\n * const [promise, resolve, reject] = createPromise()\n * setTimeout(() => {\n *   resolve(5)\n * }, 50)\n * const result = await promise\n * ```\n */\nexport function createPromise<T>(): [Promise<T>, any, any] {\n  let resolve, reject\n  const promise = new Promise<T>((_resolve, _reject) => {\n    resolve = _resolve\n    reject = _reject\n  })\n  return [promise, resolve, reject]\n}\n\n/** Sleep for `milliSeconds`. Example 1s: `await sleep(1000)` */\nexport async function sleep(milliSeconds: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, milliSeconds))\n}\n\n/** Same as `await sleep(0)`, just let the event loop execute. */\nexport async function immediate(): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, 0))\n}\n\n// type Unwrap<T> = T extends Promise<infer U>\n//   ? U\n//   : T extends (...args: any) => Promise<infer U>\n//     ? U\n//     : T extends (...args: any) => infer U\n//       ? U\n//       : T\n\nexport async function timeout<T>(\n  promise: Promise<T>,\n  milliSeconds: number,\n  timeoutValue = 'timeoutReached',\n): Promise<T | typeof timeoutValue> {\n  return new Promise((resolve, reject) => {\n    let done = false\n\n    const timeout = setTimeout(() => {\n      done = true\n      resolve(timeoutValue)\n    }, milliSeconds)\n\n    promise\n      .then((result) => {\n        clearTimeout(timeout)\n        if (!done)\n          resolve(result)\n      })\n      .catch((err) => {\n        clearTimeout(timeout)\n        if (!done)\n          reject(err)\n      })\n  })\n}\n\nexport function isTimeout(value: any): boolean {\n  return value === 'timeoutReached' || value?.name === 'Timeout reached'\n}\n\nexport async function tryTimeout<T>(\n  promise: Promise<T>,\n  milliSeconds: number,\n): Promise<T | undefined> {\n  if (milliSeconds <= 0)\n    return await promise\n\n  return new Promise((resolve, reject) => {\n    let done = false\n\n    const timeout = setTimeout(() => {\n      done = true\n      reject(new Error('Timeout reached'))\n    }, milliSeconds)\n\n    promise\n      .then((result) => {\n        clearTimeout(timeout)\n        if (!done)\n          resolve(result)\n      })\n      .catch((err) => {\n        clearTimeout(timeout)\n        if (!done)\n          reject(err)\n      })\n  })\n}\n\n/**\n * @deprecated use emitter.waitOn\n * Wait for `event` on `obj` to emit. Resolve with result or reject on `timeout`\n */\nexport function waitOn(\n  obj: any,\n  event: string,\n  timeoutMS = 1000,\n): Promise<any> {\n  return new Promise((resolve, reject) => {\n    const fn = (value: any) => {\n      if (timer) {\n        clearTimeout(timer)\n        done()\n        resolve(value)\n      }\n    }\n\n    let done = () => {\n      timer = null\n      if (obj.off)\n        obj.off(event, fn)\n      else if (obj.removeEventListener)\n        obj.removeEventListener(event, fn)\n      // else\n      //   log.warn('No remove listener method found for', obj, event)\n    }\n\n    let timer: any = setTimeout(() => {\n      done()\n      reject(new Error('Did not response in time'))\n    }, timeoutMS)\n\n    if (obj.on)\n      obj.on(event, fn)\n    else if (obj.addEventListener)\n      obj.addEventListener(event, fn)\n    // else\n    //   log.warn('No listener method found for', obj)\n  })\n}\n\nexport function isPromise<T>(value: Promise<T> | T): value is Promise<T> {\n  return Boolean(value && (value instanceof Promise || typeof (value as any).then === 'function'))\n}\n\n/** This is exactly what Prose.resolve(x) is supposed to be: return a Promise no matter what type x is */\nexport function promisify<T>(value: Promise<T> | T): Promise<T> {\n  return Promise.resolve(value)\n}\n\n// // https://github.com/unjs/items-promise\n\n// /**\n//  * Run tasks one by one by calling fn(task, previous) in a promise chain.\n//  * Return value is of type Promise<*> which resolves to the last fn result.\n//  */\n// export async function serial(tasks: any, fn: any) {\n//   return tasks.reduce(\n//     (promise: Promise<any>, task: any) =>\n//       promise.then((previous) => fn(task, previous)),\n//     Promise.resolve(null)\n//   )\n// }\n\n// /**\n//  * Run all tasks in parallel by calling fn(tasks) and await using Promise.all.\n//  * Return value is of type Promise<*[]> which resolves to results of all fns in an array.\n//  */\n// export async function parallel(tasks: any[], fn: any): Promise<any[]> {\n//   return Promise.all(tasks.map((task) => fn(task)))\n// }\n\n//\n\n/**\n *  Like ReturnType but for async functions.\n *  From https://www.jpwilliams.dev/how-to-unpack-the-return-type-of-a-promise-in-typescript\n */\nexport type AsyncReturnType<T extends (...args: any) => any> = T extends (\n  ...args: any\n) => Promise<infer U>\n  ? U\n  : T extends (...args: any) => infer U\n    ? U\n    : any\n"],"mappings":";;;;;;;;;;;;;;AAaA,SAAgB,gBAA2C;CACzD,IAAI,SAAS;AAKb,QAAO;EAJS,IAAI,SAAY,UAAU,YAAY;AACpD,aAAU;AACV,YAAS;IACT;EACe;EAAS;EAAO;;;AAInC,eAAsB,MAAM,cAAqC;AAC/D,QAAO,IAAI,SAAQ,YAAW,WAAW,SAAS,aAAa,CAAC;;;AAIlE,eAAsB,YAA2B;AAC/C,QAAO,IAAI,SAAQ,YAAW,WAAW,SAAS,EAAE,CAAC;;AAWvD,eAAsB,QACpB,SACA,cACA,eAAe,kBACmB;AAClC,QAAO,IAAI,SAAS,SAAS,WAAW;EACtC,IAAI,OAAO;EAEX,MAAM,UAAU,iBAAiB;AAC/B,UAAO;AACP,WAAQ,aAAa;KACpB,aAAa;AAEhB,UACG,MAAM,WAAW;AAChB,gBAAa,QAAQ;AACrB,OAAI,CAAC,KACH,SAAQ,OAAO;IACjB,CACD,OAAO,QAAQ;AACd,gBAAa,QAAQ;AACrB,OAAI,CAAC,KACH,QAAO,IAAI;IACb;GACJ;;AAGJ,SAAgB,UAAU,OAAqB;AAC7C,QAAO,UAAU,oBAAoB,OAAO,SAAS;;AAGvD,eAAsB,WACpB,SACA,cACwB;AACxB,KAAI,gBAAgB,EAClB,QAAO,MAAM;AAEf,QAAO,IAAI,SAAS,SAAS,WAAW;EACtC,IAAI,OAAO;EAEX,MAAM,UAAU,iBAAiB;AAC/B,UAAO;AACP,0BAAO,IAAI,MAAM,kBAAkB,CAAC;KACnC,aAAa;AAEhB,UACG,MAAM,WAAW;AAChB,gBAAa,QAAQ;AACrB,OAAI,CAAC,KACH,SAAQ,OAAO;IACjB,CACD,OAAO,QAAQ;AACd,gBAAa,QAAQ;AACrB,OAAI,CAAC,KACH,QAAO,IAAI;IACb;GACJ;;;;;;AAOJ,SAAgB,OACd,KACA,OACA,YAAY,KACE;AACd,QAAO,IAAI,SAAS,SAAS,WAAW;EACtC,MAAM,MAAM,UAAe;AACzB,OAAI,OAAO;AACT,iBAAa,MAAM;AACnB,UAAM;AACN,YAAQ,MAAM;;;EAIlB,IAAI,aAAa;AACf,WAAQ;AACR,OAAI,IAAI,IACN,KAAI,IAAI,OAAO,GAAG;YACX,IAAI,oBACX,KAAI,oBAAoB,OAAO,GAAG;;EAKtC,IAAI,QAAa,iBAAiB;AAChC,SAAM;AACN,0BAAO,IAAI,MAAM,2BAA2B,CAAC;KAC5C,UAAU;AAEb,MAAI,IAAI,GACN,KAAI,GAAG,OAAO,GAAG;WACV,IAAI,iBACX,KAAI,iBAAiB,OAAO,GAAG;GAGjC;;AAGJ,SAAgB,UAAa,OAA4C;AACvE,QAAO,QAAQ,UAAU,iBAAiB,WAAW,OAAQ,MAAc,SAAS,YAAY;;;AAIlG,SAAgB,UAAa,OAAmC;AAC9D,QAAO,QAAQ,QAAQ,MAAM"}

package/dist/common/exec/promise.d.cts

@@ -1,34 +1,2 @@
-/**
- * Promise to be used with `await`. Example:
- *
- * ```
- * const [promise, resolve, reject] = createPromise()
- * setTimeout(() => {
- *   resolve(5)
- * }, 50)
- * const result = await promise
- * ```
- */
-declare function createPromise<T>(): [Promise<T>, any, any];
-/** Sleep for `milliSeconds`. Example 1s: `await sleep(1000)` */
-declare function sleep(milliSeconds: number): Promise<void>;
-/** Same as `await sleep(0)`, just let the event loop execute. */
-declare function immediate(): Promise<void>;
-declare function timeout<T>(promise: Promise<T>, milliSeconds: number, timeoutValue?: string): Promise<T | typeof timeoutValue>;
-declare function isTimeout(value: any): boolean;
-declare function tryTimeout<T>(promise: Promise<T>, milliSeconds: number): Promise<T | undefined>;
-/**
- * @deprecated use emitter.waitOn
- * Wait for `event` on `obj` to emit. Resolve with result or reject on `timeout`
- */
-declare function waitOn(obj: any, event: string, timeoutMS?: number): Promise<any>;
-declare function isPromise<T>(value: Promise<T> | T): value is Promise<T>;
-/** This is exactly what Prose.resolve(x) is supposed to be: return a Promise no matter what type x is */
-declare function promisify<T>(value: Promise<T> | T): Promise<T>;
-/**
- *  Like ReturnType but for async functions.
- *  From https://www.jpwilliams.dev/how-to-unpack-the-return-type-of-a-promise-in-typescript
- */
-type AsyncReturnType<T extends (...args: any) => any> = T extends (...args: any) => Promise<infer U> ? U : T extends (...args: any) => infer U ? U : any;
-
-export { type AsyncReturnType, createPromise, immediate, isPromise, isTimeout, promisify, sleep, timeout, tryTimeout, waitOn };
+import { a as isTimeout, c as timeout, i as isPromise, l as tryTimeout, n as createPromise, o as promisify, r as immediate, s as sleep, t as AsyncReturnType, u as waitOn } from "../../promise-DGgiRckN.cjs";
+export { AsyncReturnType, createPromise, immediate, isPromise, isTimeout, promisify, sleep, timeout, tryTimeout, waitOn };

package/dist/common/exec/promise.d.mts

@@ -0,0 +1,2 @@
+import { a as isTimeout, c as timeout, i as isPromise, l as tryTimeout, n as createPromise, o as promisify, r as immediate, s as sleep, t as AsyncReturnType, u as waitOn } from "../../promise-MH3xAy4S.mjs";
+export { AsyncReturnType, createPromise, immediate, isPromise, isTimeout, promisify, sleep, timeout, tryTimeout, waitOn };

package/dist/common/exec/promise.mjs

@@ -0,0 +1,104 @@
+//#region src/common/exec/promise.ts
+/**
+* Promise to be used with `await`. Example:
+*
+* ```
+* const [promise, resolve, reject] = createPromise()
+* setTimeout(() => {
+*   resolve(5)
+* }, 50)
+* const result = await promise
+* ```
+*/
+function createPromise() {
+	let resolve, reject;
+	return [
+		new Promise((_resolve, _reject) => {
+			resolve = _resolve;
+			reject = _reject;
+		}),
+		resolve,
+		reject
+	];
+}
+/** Sleep for `milliSeconds`. Example 1s: `await sleep(1000)` */
+async function sleep(milliSeconds) {
+	return new Promise((resolve) => setTimeout(resolve, milliSeconds));
+}
+/** Same as `await sleep(0)`, just let the event loop execute. */
+async function immediate() {
+	return new Promise((resolve) => setTimeout(resolve, 0));
+}
+async function timeout(promise, milliSeconds, timeoutValue = "timeoutReached") {
+	return new Promise((resolve, reject) => {
+		let done = false;
+		const timeout = setTimeout(() => {
+			done = true;
+			resolve(timeoutValue);
+		}, milliSeconds);
+		promise.then((result) => {
+			clearTimeout(timeout);
+			if (!done) resolve(result);
+		}).catch((err) => {
+			clearTimeout(timeout);
+			if (!done) reject(err);
+		});
+	});
+}
+function isTimeout(value) {
+	return value === "timeoutReached" || value?.name === "Timeout reached";
+}
+async function tryTimeout(promise, milliSeconds) {
+	if (milliSeconds <= 0) return await promise;
+	return new Promise((resolve, reject) => {
+		let done = false;
+		const timeout = setTimeout(() => {
+			done = true;
+			reject(/* @__PURE__ */ new Error("Timeout reached"));
+		}, milliSeconds);
+		promise.then((result) => {
+			clearTimeout(timeout);
+			if (!done) resolve(result);
+		}).catch((err) => {
+			clearTimeout(timeout);
+			if (!done) reject(err);
+		});
+	});
+}
+/**
+* @deprecated use emitter.waitOn
+* Wait for `event` on `obj` to emit. Resolve with result or reject on `timeout`
+*/
+function waitOn(obj, event, timeoutMS = 1e3) {
+	return new Promise((resolve, reject) => {
+		const fn = (value) => {
+			if (timer) {
+				clearTimeout(timer);
+				done();
+				resolve(value);
+			}
+		};
+		let done = () => {
+			timer = null;
+			if (obj.off) obj.off(event, fn);
+			else if (obj.removeEventListener) obj.removeEventListener(event, fn);
+		};
+		let timer = setTimeout(() => {
+			done();
+			reject(/* @__PURE__ */ new Error("Did not response in time"));
+		}, timeoutMS);
+		if (obj.on) obj.on(event, fn);
+		else if (obj.addEventListener) obj.addEventListener(event, fn);
+	});
+}
+function isPromise(value) {
+	return Boolean(value && (value instanceof Promise || typeof value.then === "function"));
+}
+/** This is exactly what Prose.resolve(x) is supposed to be: return a Promise no matter what type x is */
+function promisify(value) {
+	return Promise.resolve(value);
+}
+
+//#endregion
+export { createPromise, immediate, isPromise, isTimeout, promisify, sleep, timeout, tryTimeout, waitOn };
+//# sourceMappingURL=promise.mjs.map

package/dist/common/exec/promise.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.mjs","names":[],"sources":["../../../src/common/exec/promise.ts"],"sourcesContent":["/* eslint-disable ts/no-use-before-define */\n\n/**\n * Promise to be used with `await`. Example:\n *\n * ```\n * const [promise, resolve, reject] = createPromise()\n * setTimeout(() => {\n *   resolve(5)\n * }, 50)\n * const result = await promise\n * ```\n */\nexport function createPromise<T>(): [Promise<T>, any, any] {\n  let resolve, reject\n  const promise = new Promise<T>((_resolve, _reject) => {\n    resolve = _resolve\n    reject = _reject\n  })\n  return [promise, resolve, reject]\n}\n\n/** Sleep for `milliSeconds`. Example 1s: `await sleep(1000)` */\nexport async function sleep(milliSeconds: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, milliSeconds))\n}\n\n/** Same as `await sleep(0)`, just let the event loop execute. */\nexport async function immediate(): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, 0))\n}\n\n// type Unwrap<T> = T extends Promise<infer U>\n//   ? U\n//   : T extends (...args: any) => Promise<infer U>\n//     ? U\n//     : T extends (...args: any) => infer U\n//       ? U\n//       : T\n\nexport async function timeout<T>(\n  promise: Promise<T>,\n  milliSeconds: number,\n  timeoutValue = 'timeoutReached',\n): Promise<T | typeof timeoutValue> {\n  return new Promise((resolve, reject) => {\n    let done = false\n\n    const timeout = setTimeout(() => {\n      done = true\n      resolve(timeoutValue)\n    }, milliSeconds)\n\n    promise\n      .then((result) => {\n        clearTimeout(timeout)\n        if (!done)\n          resolve(result)\n      })\n      .catch((err) => {\n        clearTimeout(timeout)\n        if (!done)\n          reject(err)\n      })\n  })\n}\n\nexport function isTimeout(value: any): boolean {\n  return value === 'timeoutReached' || value?.name === 'Timeout reached'\n}\n\nexport async function tryTimeout<T>(\n  promise: Promise<T>,\n  milliSeconds: number,\n): Promise<T | undefined> {\n  if (milliSeconds <= 0)\n    return await promise\n\n  return new Promise((resolve, reject) => {\n    let done = false\n\n    const timeout = setTimeout(() => {\n      done = true\n      reject(new Error('Timeout reached'))\n    }, milliSeconds)\n\n    promise\n      .then((result) => {\n        clearTimeout(timeout)\n        if (!done)\n          resolve(result)\n      })\n      .catch((err) => {\n        clearTimeout(timeout)\n        if (!done)\n          reject(err)\n      })\n  })\n}\n\n/**\n * @deprecated use emitter.waitOn\n * Wait for `event` on `obj` to emit. Resolve with result or reject on `timeout`\n */\nexport function waitOn(\n  obj: any,\n  event: string,\n  timeoutMS = 1000,\n): Promise<any> {\n  return new Promise((resolve, reject) => {\n    const fn = (value: any) => {\n      if (timer) {\n        clearTimeout(timer)\n        done()\n        resolve(value)\n      }\n    }\n\n    let done = () => {\n      timer = null\n      if (obj.off)\n        obj.off(event, fn)\n      else if (obj.removeEventListener)\n        obj.removeEventListener(event, fn)\n      // else\n      //   log.warn('No remove listener method found for', obj, event)\n    }\n\n    let timer: any = setTimeout(() => {\n      done()\n      reject(new Error('Did not response in time'))\n    }, timeoutMS)\n\n    if (obj.on)\n      obj.on(event, fn)\n    else if (obj.addEventListener)\n      obj.addEventListener(event, fn)\n    // else\n    //   log.warn('No listener method found for', obj)\n  })\n}\n\nexport function isPromise<T>(value: Promise<T> | T): value is Promise<T> {\n  return Boolean(value && (value instanceof Promise || typeof (value as any).then === 'function'))\n}\n\n/** This is exactly what Prose.resolve(x) is supposed to be: return a Promise no matter what type x is */\nexport function promisify<T>(value: Promise<T> | T): Promise<T> {\n  return Promise.resolve(value)\n}\n\n// // https://github.com/unjs/items-promise\n\n// /**\n//  * Run tasks one by one by calling fn(task, previous) in a promise chain.\n//  * Return value is of type Promise<*> which resolves to the last fn result.\n//  */\n// export async function serial(tasks: any, fn: any) {\n//   return tasks.reduce(\n//     (promise: Promise<any>, task: any) =>\n//       promise.then((previous) => fn(task, previous)),\n//     Promise.resolve(null)\n//   )\n// }\n\n// /**\n//  * Run all tasks in parallel by calling fn(tasks) and await using Promise.all.\n//  * Return value is of type Promise<*[]> which resolves to results of all fns in an array.\n//  */\n// export async function parallel(tasks: any[], fn: any): Promise<any[]> {\n//   return Promise.all(tasks.map((task) => fn(task)))\n// }\n\n//\n\n/**\n *  Like ReturnType but for async functions.\n *  From https://www.jpwilliams.dev/how-to-unpack-the-return-type-of-a-promise-in-typescript\n */\nexport type AsyncReturnType<T extends (...args: any) => any> = T extends (\n  ...args: any\n) => Promise<infer U>\n  ? U\n  : T extends (...args: any) => infer U\n    ? U\n    : any\n"],"mappings":";;;;;;;;;;;;AAaA,SAAgB,gBAA2C;CACzD,IAAI,SAAS;AAKb,QAAO;EAJS,IAAI,SAAY,UAAU,YAAY;AACpD,aAAU;AACV,YAAS;IACT;EACe;EAAS;EAAO;;;AAInC,eAAsB,MAAM,cAAqC;AAC/D,QAAO,IAAI,SAAQ,YAAW,WAAW,SAAS,aAAa,CAAC;;;AAIlE,eAAsB,YAA2B;AAC/C,QAAO,IAAI,SAAQ,YAAW,WAAW,SAAS,EAAE,CAAC;;AAWvD,eAAsB,QACpB,SACA,cACA,eAAe,kBACmB;AAClC,QAAO,IAAI,SAAS,SAAS,WAAW;EACtC,IAAI,OAAO;EAEX,MAAM,UAAU,iBAAiB;AAC/B,UAAO;AACP,WAAQ,aAAa;KACpB,aAAa;AAEhB,UACG,MAAM,WAAW;AAChB,gBAAa,QAAQ;AACrB,OAAI,CAAC,KACH,SAAQ,OAAO;IACjB,CACD,OAAO,QAAQ;AACd,gBAAa,QAAQ;AACrB,OAAI,CAAC,KACH,QAAO,IAAI;IACb;GACJ;;AAGJ,SAAgB,UAAU,OAAqB;AAC7C,QAAO,UAAU,oBAAoB,OAAO,SAAS;;AAGvD,eAAsB,WACpB,SACA,cACwB;AACxB,KAAI,gBAAgB,EAClB,QAAO,MAAM;AAEf,QAAO,IAAI,SAAS,SAAS,WAAW;EACtC,IAAI,OAAO;EAEX,MAAM,UAAU,iBAAiB;AAC/B,UAAO;AACP,0BAAO,IAAI,MAAM,kBAAkB,CAAC;KACnC,aAAa;AAEhB,UACG,MAAM,WAAW;AAChB,gBAAa,QAAQ;AACrB,OAAI,CAAC,KACH,SAAQ,OAAO;IACjB,CACD,OAAO,QAAQ;AACd,gBAAa,QAAQ;AACrB,OAAI,CAAC,KACH,QAAO,IAAI;IACb;GACJ;;;;;;AAOJ,SAAgB,OACd,KACA,OACA,YAAY,KACE;AACd,QAAO,IAAI,SAAS,SAAS,WAAW;EACtC,MAAM,MAAM,UAAe;AACzB,OAAI,OAAO;AACT,iBAAa,MAAM;AACnB,UAAM;AACN,YAAQ,MAAM;;;EAIlB,IAAI,aAAa;AACf,WAAQ;AACR,OAAI,IAAI,IACN,KAAI,IAAI,OAAO,GAAG;YACX,IAAI,oBACX,KAAI,oBAAoB,OAAO,GAAG;;EAKtC,IAAI,QAAa,iBAAiB;AAChC,SAAM;AACN,0BAAO,IAAI,MAAM,2BAA2B,CAAC;KAC5C,UAAU;AAEb,MAAI,IAAI,GACN,KAAI,GAAG,OAAO,GAAG;WACV,IAAI,iBACX,KAAI,iBAAiB,OAAO,GAAG;GAGjC;;AAGJ,SAAgB,UAAa,OAA4C;AACvE,QAAO,QAAQ,UAAU,iBAAiB,WAAW,OAAQ,MAAc,SAAS,YAAY;;;AAIlG,SAAgB,UAAa,OAAmC;AAC9D,QAAO,QAAQ,QAAQ,MAAM"}

package/dist/common/exec/queue.cjs

@@ -1,2 +1,126 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk4ATJXWZHcjs = require('../../chunk-4ATJXWZH.cjs');require('../../chunk-ABCQXAMV.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-FMMEBQFR.cjs');require('../../chunk-5VHLMAKU.cjs');require('../../chunk-L5IXZXHR.cjs');require('../../chunk-LUPESR7S.cjs');require('../../chunk-A6DSKTWF.cjs');require('../../chunk-OGP3AZFM.cjs');require('../../chunk-TNMEWZPW.cjs');require('../../chunk-BPWOWVF7.cjs');require('../../chunk-ZEDMMWJI.cjs');require('../../chunk-UXW3L3L6.cjs');require('../../chunk-5RHVNJKM.cjs');require('../../chunk-P7XCQ7WV.cjs');exports.SerialQueue = _chunk4ATJXWZHcjs.a;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_common_log_log_base = require('../log/log-base.cjs');
+const require_common_log_log = require('../log/log.cjs');
+const require_common_msg_emitter = require('../msg/emitter.cjs');
+const require_common_uuid = require('../uuid.cjs');
+
+//#region src/common/exec/queue.ts
+/** Guarentee serial execution of tasks. Able to wait, pause, resume and cancel all. */
+var SerialQueue = class extends require_common_msg_emitter.Emitter {
+	queue = [];
+	waitToFinish = [];
+	currentTask;
+	log;
+	countMax = 0;
+	countResolved = 0;
+	paused = false;
+	name;
+	constructor(opt = {}) {
+		super();
+		const { name = require_common_uuid.uname("queue"), logLevel } = opt;
+		this.name = name;
+		this.log = require_common_log_log.DefaultLogger(`zeed:queue:${name}`, logLevel ?? 9007199254740991);
+	}
+	async performNext() {
+		this.log("performNext, queue.length =", this.queue.length);
+		if (this.currentTask != null) {
+			this.log("performNext => skip while another task is running");
+			return;
+		}
+		if (this.paused) {
+			this.log("performNext => skip while is paused");
+			return;
+		}
+		while (this.currentTask == null && !this.paused) {
+			const info = this.queue.shift();
+			this.log(`performNext => ${info?.name}`);
+			if (info == null) break;
+			if (this.countResolved === 0) this.emit("didStart", this.countMax);
+			const { name, task, resolve } = info;
+			this.currentTask = task();
+			let result;
+			try {
+				this.log.info(`start task ${name}`);
+				result = await this.currentTask;
+				this.log(`finished task ${name} with result =`, result);
+			} catch (err) {
+				this.log.warn("Error performing task", err);
+			}
+			resolve(result);
+			this.currentTask = void 0;
+			this.countResolved += 1;
+			this.emit("didUpdate", this.countMax, this.countResolved);
+		}
+		if (this.queue.length === 0) {
+			this.emit("didFinish");
+			this.countMax = 0;
+			this.countResolved = 0;
+		}
+		while (this.waitToFinish.length > 0) this.waitToFinish.shift()();
+	}
+	/** Enqueue task to be executed when all other tasks are done. Except `immediate = true`. */
+	async enqueue(task, opt = {}) {
+		const { immediate = false, name = require_common_uuid.uname(this.name) } = opt;
+		if (immediate) {
+			this.log.info(`immediate execution ${name}`);
+			return await task();
+		}
+		this.log(`enqueue ${name}`);
+		return new Promise((resolve) => {
+			this.queue.push({
+				name,
+				task,
+				resolve
+			});
+			this.countMax += 1;
+			this.emit("didUpdate", this.countMax, this.countResolved);
+			this.performNext();
+		});
+	}
+	/** If a task is already performing, execute immediately. Otherwise enqueue as usual. */
+	async enqueueReentrant(task, opt = {}) {
+		return this.enqueue(task, {
+			immediate: this.currentTask != null,
+			name: opt.name
+		});
+	}
+	/** Remove all tasks from queue that are not yet executing. */
+	async cancelAll(_unblock = true) {
+		this.log("cancelAll");
+		this.emit("didCancel");
+		const resolver = this.queue.map((task) => task.resolve);
+		this.queue = [];
+		resolver.forEach((r) => r(void 0));
+		await this.wait();
+	}
+	/** Pause execution after current task is finished. */
+	async pause() {
+		this.log("pause");
+		this.paused = true;
+		await this.wait();
+	}
+	/** Resume paused queue. */
+	resume() {
+		this.log("resume");
+		this.paused = false;
+		this.performNext();
+	}
+	/** Wait for all tasks to finish */
+	async wait() {
+		this.log("wait");
+		if (this.currentTask == null && (this.queue.length === 0 || this.paused)) return;
+		return new Promise((resolve) => {
+			this.waitToFinish.push(resolve);
+		});
+	}
+	get isPaused() {
+		return this.paused;
+	}
+	get hasTasks() {
+		return this.queue.length !== 0;
+	}
+};
+
+//#endregion
+exports.SerialQueue = SerialQueue;
 //# sourceMappingURL=queue.cjs.map

package/dist/common/exec/queue.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/dirk/work/github-zeed/dist/common/exec/queue.cjs"],"names":[],"mappings":"AAAA,qIAAuC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,oCAAiC,0CAAyB","file":"/Users/dirk/work/github-zeed/dist/common/exec/queue.cjs"}
+{"version":3,"file":"queue.cjs","names":["Emitter","uname","DefaultLogger"],"sources":["../../../src/common/exec/queue.ts"],"sourcesContent":["// Can learn from here https://github.com/sindresorhus/p-queue\n\nimport type { LoggerInterface, LogLevel } from '../log/log-base'\nimport { DefaultLogger } from '../log/log'\nimport { LogLevelOff } from '../log/log-base'\nimport { Emitter } from '../msg/emitter'\nimport { uname } from '../uuid'\n\ntype TaskResolver = any\n\nexport type TaskFn<T = any> = () => Promise<T>\n\ninterface TaskInfo {\n  name: string\n  task: TaskFn\n  resolve: TaskResolver\n}\n\nexport interface TaskEvents {\n  didUpdate: (max: number, resolved: number) => void\n  didStart: (max: number) => void\n  didCancel: () => void\n  didFinish: () => void\n  // didResolve(value: any): void\n  // didReject(error: any): void\n  // didPause(max: number): void\n}\n\n/** Guarentee serial execution of tasks. Able to wait, pause, resume and cancel all. */\nexport class SerialQueue extends Emitter<TaskEvents> {\n  private queue: TaskInfo[] = []\n  private waitToFinish: TaskResolver[] = []\n  private currentTask?: Promise<any>\n  private log: LoggerInterface\n  private countMax = 0\n  private countResolved = 0\n\n  private paused = false\n\n  name: string\n\n  constructor(opt: { name?: string, logLevel?: LogLevel } = {}) {\n    super()\n    const { name = uname('queue'), logLevel } = opt\n    this.name = name\n    this.log = DefaultLogger(`zeed:queue:${name}`, logLevel ?? LogLevelOff)\n  }\n\n  private async performNext() {\n    this.log('performNext, queue.length =', this.queue.length)\n\n    if (this.currentTask != null) {\n      this.log('performNext => skip while another task is running')\n      return\n    }\n\n    if (this.paused) {\n      this.log('performNext => skip while is paused')\n      return\n    }\n\n    while (this.currentTask == null && !this.paused) {\n      const info = this.queue.shift()\n      this.log(`performNext => ${info?.name}`)\n\n      if (info == null)\n        break\n\n      if (this.countResolved === 0)\n        void this.emit('didStart', this.countMax)\n\n      const { name, task, resolve } = info\n      this.currentTask = task()\n      let result\n      try {\n        this.log.info(`start task ${name}`)\n        result = await this.currentTask\n        this.log(`finished task ${name} with result =`, result)\n      }\n      catch (err) {\n        this.log.warn('Error performing task', err)\n      }\n\n      resolve(result)\n      this.currentTask = undefined\n\n      this.countResolved += 1\n      void this.emit('didUpdate', this.countMax, this.countResolved)\n    }\n\n    if (this.queue.length === 0) {\n      void this.emit('didFinish')\n      this.countMax = 0\n      this.countResolved = 0\n    }\n\n    while (this.waitToFinish.length > 0)\n      this.waitToFinish.shift()()\n  }\n\n  /** Enqueue task to be executed when all other tasks are done. Except `immediate = true`. */\n  async enqueue<T>(\n    task: TaskFn<T>,\n    opt: { immediate?: boolean, name?: string } = {},\n  ): Promise<T> {\n    const { immediate = false, name = uname(this.name) } = opt\n    if (immediate) {\n      this.log.info(`immediate execution ${name}`)\n      return await task()\n    }\n\n    this.log(`enqueue ${name}`)\n    return new Promise((resolve) => {\n      this.queue.push({\n        name,\n        task,\n        resolve,\n      })\n\n      this.countMax += 1\n      void this.emit('didUpdate', this.countMax, this.countResolved)\n\n      void this.performNext()\n    })\n  }\n\n  /** If a task is already performing, execute immediately. Otherwise enqueue as usual. */\n  async enqueueReentrant<T>(\n    task: TaskFn<T>,\n    opt: { name?: string } = {},\n  ): Promise<T> {\n    return this.enqueue(task, {\n      immediate: this.currentTask != null,\n      name: opt.name,\n    })\n  }\n\n  /** Remove all tasks from queue that are not yet executing. */\n  async cancelAll(_unblock = true) {\n    this.log('cancelAll')\n    void this.emit('didCancel')\n    const resolver = this.queue.map(task => task.resolve)\n    this.queue = []\n    resolver.forEach(r => r(undefined))\n    await this.wait()\n  }\n\n  /** Pause execution after current task is finished. */\n  async pause() {\n    this.log('pause')\n    this.paused = true\n    await this.wait()\n  }\n\n  /** Resume paused queue. */\n  resume() {\n    this.log('resume')\n    this.paused = false\n    void this.performNext()\n  }\n\n  /** Wait for all tasks to finish */\n  async wait() {\n    this.log('wait')\n    if (this.currentTask == null && (this.queue.length === 0 || this.paused))\n      return\n\n    return new Promise((resolve) => {\n      this.waitToFinish.push(resolve)\n    })\n  }\n\n  public get isPaused(): boolean {\n    return this.paused\n  }\n\n  public get hasTasks(): boolean {\n    return this.queue.length !== 0\n  }\n}\n"],"mappings":"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"}