zeed 1.3.0 → 1.4.0

package/dist/common/exec/queue.cjs

@@ -1,2 +1,126 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../log/log-base.cjs`);const e=require(`../log/log.cjs`),t=require(`../msg/emitter.cjs`),n=require(`../uuid.cjs`);var r=class extends t.Emitter{queue=[];waitToFinish=[];currentTask;log;countMax=0;countResolved=0;paused=!1;name;constructor(t={}){super();let{name:r=n.uname(`queue`),logLevel:i}=t;this.name=r,this.log=e.DefaultLogger(`zeed:queue:${r}`,i??9007199254740991)}async performNext(){if(this.log(`performNext, queue.length =`,this.queue.length),this.currentTask!=null){this.log(`performNext => skip while another task is running`);return}if(this.paused){this.log(`performNext => skip while is paused`);return}for(;this.currentTask==null&&!this.paused;){let e=this.queue.shift();if(this.log(`performNext => ${e?.name}`),e==null)break;this.countResolved===0&&this.emit(`didStart`,this.countMax);let{name:t,task:n,resolve:r}=e;this.currentTask=n();let i;try{this.log.info(`start task ${t}`),i=await this.currentTask,this.log(`finished task ${t} with result =`,i)}catch(e){this.log.warn(`Error performing task`,e)}r(i),this.currentTask=void 0,this.countResolved+=1,this.emit(`didUpdate`,this.countMax,this.countResolved)}for(this.queue.length===0&&(this.emit(`didFinish`),this.countMax=0,this.countResolved=0);this.waitToFinish.length>0;)this.waitToFinish.shift()()}async enqueue(e,t={}){let{immediate:r=!1,name:i=n.uname(this.name)}=t;return r?(this.log.info(`immediate execution ${i}`),await e()):(this.log(`enqueue ${i}`),new Promise(t=>{this.queue.push({name:i,task:e,resolve:t}),this.countMax+=1,this.emit(`didUpdate`,this.countMax,this.countResolved),this.performNext()}))}async enqueueReentrant(e,t={}){return this.enqueue(e,{immediate:this.currentTask!=null,name:t.name})}async cancelAll(e=!0){this.log(`cancelAll`),this.emit(`didCancel`);let t=this.queue.map(e=>e.resolve);this.queue=[],t.forEach(e=>e(void 0)),await this.wait()}async pause(){this.log(`pause`),this.paused=!0,await this.wait()}resume(){this.log(`resume`),this.paused=!1,this.performNext()}async wait(){if(this.log(`wait`),!(this.currentTask==null&&(this.queue.length===0||this.paused)))return new Promise(e=>{this.waitToFinish.push(e)})}get isPaused(){return this.paused}get hasTasks(){return this.queue.length!==0}};exports.SerialQueue=r;
+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,"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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"}
+{"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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"}

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

@@ -1,2 +1,2 @@
-import { n as TaskEvents, r as TaskFn, t as SerialQueue } from "../../index-DHXVOH8h.cjs";
+import { n as TaskEvents, r as TaskFn, t as SerialQueue } from "../../index-CFkMqHvX.cjs";
 export { SerialQueue, TaskEvents, TaskFn };

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

@@ -1,2 +1,2 @@
-import { n as TaskEvents, r as TaskFn, t as SerialQueue } from "../../index-DMaPyx9O.mjs";
+import { n as TaskEvents, r as TaskFn, t as SerialQueue } from "../../index-C_3Y_s6f.mjs";
 export { SerialQueue, TaskEvents, TaskFn };

package/dist/common/exec/queue.mjs

@@ -1,2 +1,125 @@
-import"../log/log-base.mjs";import{DefaultLogger as e}from"../log/log.mjs";import{Emitter as t}from"../msg/emitter.mjs";import{uname as n}from"../uuid.mjs";var r=class extends t{queue=[];waitToFinish=[];currentTask;log;countMax=0;countResolved=0;paused=!1;name;constructor(t={}){super();let{name:r=n(`queue`),logLevel:i}=t;this.name=r,this.log=e(`zeed:queue:${r}`,i??9007199254740991)}async performNext(){if(this.log(`performNext, queue.length =`,this.queue.length),this.currentTask!=null){this.log(`performNext => skip while another task is running`);return}if(this.paused){this.log(`performNext => skip while is paused`);return}for(;this.currentTask==null&&!this.paused;){let e=this.queue.shift();if(this.log(`performNext => ${e?.name}`),e==null)break;this.countResolved===0&&this.emit(`didStart`,this.countMax);let{name:t,task:n,resolve:r}=e;this.currentTask=n();let i;try{this.log.info(`start task ${t}`),i=await this.currentTask,this.log(`finished task ${t} with result =`,i)}catch(e){this.log.warn(`Error performing task`,e)}r(i),this.currentTask=void 0,this.countResolved+=1,this.emit(`didUpdate`,this.countMax,this.countResolved)}for(this.queue.length===0&&(this.emit(`didFinish`),this.countMax=0,this.countResolved=0);this.waitToFinish.length>0;)this.waitToFinish.shift()()}async enqueue(e,t={}){let{immediate:r=!1,name:i=n(this.name)}=t;return r?(this.log.info(`immediate execution ${i}`),await e()):(this.log(`enqueue ${i}`),new Promise(t=>{this.queue.push({name:i,task:e,resolve:t}),this.countMax+=1,this.emit(`didUpdate`,this.countMax,this.countResolved),this.performNext()}))}async enqueueReentrant(e,t={}){return this.enqueue(e,{immediate:this.currentTask!=null,name:t.name})}async cancelAll(e=!0){this.log(`cancelAll`),this.emit(`didCancel`);let t=this.queue.map(e=>e.resolve);this.queue=[],t.forEach(e=>e(void 0)),await this.wait()}async pause(){this.log(`pause`),this.paused=!0,await this.wait()}resume(){this.log(`resume`),this.paused=!1,this.performNext()}async wait(){if(this.log(`wait`),!(this.currentTask==null&&(this.queue.length===0||this.paused)))return new Promise(e=>{this.waitToFinish.push(e)})}get isPaused(){return this.paused}get hasTasks(){return this.queue.length!==0}};export{r as SerialQueue};
+import { LogLevelOff } from "../log/log-base.mjs";
+import { DefaultLogger } from "../log/log.mjs";
+import { Emitter } from "../msg/emitter.mjs";
+import { uname } from "../uuid.mjs";
+
+//#region src/common/exec/queue.ts
+/** Guarentee serial execution of tasks. Able to wait, pause, resume and cancel all. */
+var SerialQueue = class extends Emitter {
+	queue = [];
+	waitToFinish = [];
+	currentTask;
+	log;
+	countMax = 0;
+	countResolved = 0;
+	paused = false;
+	name;
+	constructor(opt = {}) {
+		super();
+		const { name = uname("queue"), logLevel } = opt;
+		this.name = name;
+		this.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 = 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
+export { SerialQueue };
 //# sourceMappingURL=queue.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"queue.mjs","names":[],"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":"4JA6BA,IAAa,EAAb,cAAiC,CAAoB,CACnD,MAA4B,EAAE,CAC9B,aAAuC,EAAE,CACzC,YACA,IACA,SAAmB,EACnB,cAAwB,EAExB,OAAiB,GAEjB,KAEA,YAAY,EAA8C,EAAE,CAAE,CAC5D,OAAO,CACP,GAAM,CAAE,OAAO,EAAM,QAAQ,CAAE,YAAa,EAC5C,KAAK,KAAO,EACZ,KAAK,IAAM,EAAc,cAAc,IAAQ,GAAA,iBAAwB,CAGzE,MAAc,aAAc,CAG1B,GAFA,KAAK,IAAI,8BAA+B,KAAK,MAAM,OAAO,CAEtD,KAAK,aAAe,KAAM,CAC5B,KAAK,IAAI,oDAAoD,CAC7D,OAGF,GAAI,KAAK,OAAQ,CACf,KAAK,IAAI,sCAAsC,CAC/C,OAGF,KAAO,KAAK,aAAe,MAAQ,CAAC,KAAK,QAAQ,CAC/C,IAAM,EAAO,KAAK,MAAM,OAAO,CAG/B,GAFA,KAAK,IAAI,kBAAkB,GAAM,OAAO,CAEpC,GAAQ,KACV,MAEE,KAAK,gBAAkB,GACpB,KAAK,KAAK,WAAY,KAAK,SAAS,CAE3C,GAAM,CAAE,OAAM,OAAM,WAAY,EAChC,KAAK,YAAc,GAAM,CACzB,IAAI,EACJ,GAAI,CACF,KAAK,IAAI,KAAK,cAAc,IAAO,CACnC,EAAS,MAAM,KAAK,YACpB,KAAK,IAAI,iBAAiB,EAAK,gBAAiB,EAAO,OAElD,EAAK,CACV,KAAK,IAAI,KAAK,wBAAyB,EAAI,CAG7C,EAAQ,EAAO,CACf,KAAK,YAAc,IAAA,GAEnB,KAAK,eAAiB,EACjB,KAAK,KAAK,YAAa,KAAK,SAAU,KAAK,cAAc,CAShE,IANI,KAAK,MAAM,SAAW,IACnB,KAAK,KAAK,YAAY,CAC3B,KAAK,SAAW,EAChB,KAAK,cAAgB,GAGhB,KAAK,aAAa,OAAS,GAChC,KAAK,aAAa,OAAO,EAAE,CAI/B,MAAM,QACJ,EACA,EAA8C,EAAE,CACpC,CACZ,GAAM,CAAE,YAAY,GAAO,OAAO,EAAM,KAAK,KAAK,EAAK,EAOvD,OANI,GACF,KAAK,IAAI,KAAK,uBAAuB,IAAO,CACrC,MAAM,GAAM,GAGrB,KAAK,IAAI,WAAW,IAAO,CACpB,IAAI,QAAS,GAAY,CAC9B,KAAK,MAAM,KAAK,CACd,OACA,OACA,UACD,CAAC,CAEF,KAAK,UAAY,EACZ,KAAK,KAAK,YAAa,KAAK,SAAU,KAAK,cAAc,CAEzD,KAAK,aAAa,EACvB,EAIJ,MAAM,iBACJ,EACA,EAAyB,EAAE,CACf,CACZ,OAAO,KAAK,QAAQ,EAAM,CACxB,UAAW,KAAK,aAAe,KAC/B,KAAM,EAAI,KACX,CAAC,CAIJ,MAAM,UAAU,EAAW,GAAM,CAC/B,KAAK,IAAI,YAAY,CAChB,KAAK,KAAK,YAAY,CAC3B,IAAM,EAAW,KAAK,MAAM,IAAI,GAAQ,EAAK,QAAQ,CACrD,KAAK,MAAQ,EAAE,CACf,EAAS,QAAQ,GAAK,EAAE,IAAA,GAAU,CAAC,CACnC,MAAM,KAAK,MAAM,CAInB,MAAM,OAAQ,CACZ,KAAK,IAAI,QAAQ,CACjB,KAAK,OAAS,GACd,MAAM,KAAK,MAAM,CAInB,QAAS,CACP,KAAK,IAAI,SAAS,CAClB,KAAK,OAAS,GACT,KAAK,aAAa,CAIzB,MAAM,MAAO,CACX,QAAK,IAAI,OAAO,CACZ,OAAK,aAAe,OAAS,KAAK,MAAM,SAAW,GAAK,KAAK,SAGjE,OAAO,IAAI,QAAS,GAAY,CAC9B,KAAK,aAAa,KAAK,EAAQ,EAC/B,CAGJ,IAAW,UAAoB,CAC7B,OAAO,KAAK,OAGd,IAAW,UAAoB,CAC7B,OAAO,KAAK,MAAM,SAAW"}
+{"version":3,"file":"queue.mjs","names":[],"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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"}

package/dist/common/exec/throttle-debounce.cjs

@@ -1,2 +1,115 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./promise.cjs`);function t(e,t={}){let{delay:n=100,trailing:r=!0,leading:i=!0}=t,a,o=0,s=0,c;function l(){return a?(clearTimeout(a),a=void 0,!0):!1}function u(...t){let u=Date.now(),d=u-o,f=()=>{s=0,o=Date.now(),e.apply(this,t)};if(c=f,d>n||!a){i&&(d>n?f():++s);let e=d>n?n:n-d;l(),o=u,a=setTimeout(()=>{l(),r&&(!i||s>0)&&c?.()},e)}else ++s}return u.cancel=l,u.stop=()=>{l()&&c&&c()},u.immediate=async function(...t){l(),o=Date.now(),e.apply(this,t)},u.dispose=()=>u.stop(),u}function n(t,n={}){let{delay:r=100}=n,i,a=!1,o;function s(){i&&=(clearTimeout(i),void 0)}async function c(){try{if(s(),o!=null){let n=[...o];o=void 0,a=!0,await e.promisify(t(...n)),a=!1,o!=null&&(s(),i=setTimeout(c,r))}}catch{}}function l(...e){o=[...e],s(),a===!1&&(i=setTimeout(c,r))}async function u(...e){s(),o=[...e],await c()}return l.cancel=s,l.dispose=s,l.immediate=u,l}exports.debounce=n,exports.throttle=t;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_common_exec_promise = require('./promise.cjs');
+
+//#region src/common/exec/throttle-debounce.ts
+/**
+* A special throttle implementation that tries to distribute execution
+* in an optimal way.
+*
+* **Functionality:** For UI usage the function is executed on first occasion (`leading`).
+* If more calls follow it will again be executed at end (`trailing`).
+* If the next call is inside the timeframe, it is delayed until `trailing`.
+* This avoids timewise too close calls.
+* It is possible to `cancel` the timeout and to `flush` a call, e.g. if
+* leaving UI situation where a final call is required to write data or similar.
+*/
+function throttle(callback, opt = {}) {
+	const { delay = 100, trailing = true, leading = true } = opt;
+	let timeoutID;
+	let checkpoint = 0;
+	let visited = 0;
+	let trailingExec;
+	function clearExistingTimeout() {
+		if (timeoutID) {
+			clearTimeout(timeoutID);
+			timeoutID = void 0;
+			return true;
+		}
+		return false;
+	}
+	function wrapper(...args) {
+		const now = Date.now();
+		const elapsed = now - checkpoint;
+		const exec = () => {
+			visited = 0;
+			checkpoint = Date.now();
+			callback.apply(this, args);
+		};
+		trailingExec = exec;
+		if (elapsed > delay || !timeoutID) {
+			if (leading) if (elapsed > delay) exec();
+			else ++visited;
+			const timeout = elapsed > delay ? delay : delay - elapsed;
+			clearExistingTimeout();
+			checkpoint = now;
+			timeoutID = setTimeout(() => {
+				clearExistingTimeout();
+				if (trailing && (!leading || visited > 0)) trailingExec?.();
+			}, timeout);
+		} else ++visited;
+	}
+	wrapper.cancel = clearExistingTimeout;
+	wrapper.stop = () => {
+		if (clearExistingTimeout() && trailingExec) trailingExec();
+	};
+	wrapper.immediate = async function immediate(...args) {
+		clearExistingTimeout();
+		checkpoint = Date.now();
+		callback.apply(this, args);
+	};
+	wrapper.dispose = () => wrapper.stop();
+	return wrapper;
+}
+/**
+* Debounce fits best for filtering a large peak of events.
+* For UI event filtering throttle is probably a better choice.
+*
+* **Functionality:**  It only fires after triggers pause for `delay` ms.
+*/
+function debounce(callback, opt = {}) {
+	const { delay = 100 } = opt;
+	let timeoutID;
+	let running = false;
+	let lastArguments;
+	function clearExistingTimeout() {
+		if (timeoutID) {
+			clearTimeout(timeoutID);
+			timeoutID = void 0;
+		}
+	}
+	async function exec() {
+		try {
+			clearExistingTimeout();
+			if (lastArguments != null) {
+				const args = [...lastArguments];
+				lastArguments = void 0;
+				running = true;
+				await require_common_exec_promise.promisify(callback(...args));
+				running = false;
+				if (lastArguments != null) {
+					clearExistingTimeout();
+					timeoutID = setTimeout(exec, delay);
+				}
+			}
+		} catch (err) {}
+	}
+	function wrapper(...args) {
+		lastArguments = [...args];
+		clearExistingTimeout();
+		if (running === false) timeoutID = setTimeout(exec, delay);
+	}
+	async function immediate(...args) {
+		clearExistingTimeout();
+		lastArguments = [...args];
+		await exec();
+	}
+	wrapper.cancel = clearExistingTimeout;
+	wrapper.dispose = clearExistingTimeout;
+	wrapper.immediate = immediate;
+	return wrapper;
+}
+
+//#endregion
+exports.debounce = debounce;
+exports.throttle = throttle;
 //# sourceMappingURL=throttle-debounce.cjs.map

package/dist/common/exec/throttle-debounce.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"throttle-debounce.cjs","names":["promisify"],"sources":["../../../src/common/exec/throttle-debounce.ts"],"sourcesContent":["// General explaination https://css-tricks.com/debouncing-throttling-explained-examples/\n// From https://github.com/cowboy/jquery-throttle-debounce\n// And https://github.com/wuct/raf-throttle/blob/master/rafThrottle.js\n\nimport { promisify } from './promise'\n\n// const DEBUG = false\n// const log = DEBUG ? LoggerLazy('zeed:throttle', 'error') : () => {}\n\n/**\n * A special throttle implementation that tries to distribute execution\n * in an optimal way.\n *\n * **Functionality:** For UI usage the function is executed on first occasion (`leading`).\n * If more calls follow it will again be executed at end (`trailing`).\n * If the next call is inside the timeframe, it is delayed until `trailing`.\n * This avoids timewise too close calls.\n * It is possible to `cancel` the timeout and to `flush` a call, e.g. if\n * leaving UI situation where a final call is required to write data or similar.\n */\nexport function throttle<F extends (...args: any[]) => any>(\n  callback: F,\n  opt: {\n    delay?: number\n    trailing?: boolean\n    leading?: boolean\n  } = {},\n): F & {\n  /** Stop all timers, do not exec nothing */\n  cancel: () => void\n\n  /** Stop all timers and execute right now. */\n  immediate: (...args: Parameters<F>) => Promise<void>\n\n  /** Stop all timers and execute trailing call, if exists. */\n  stop: () => void\n\n  dispose: () => void\n} {\n  const { delay = 100, trailing = true, leading = true } = opt\n\n  let timeoutID: any\n  let checkpoint = 0\n  let visited = 0\n  let trailingExec: () => void | undefined\n\n  // const debugCheckpoint = Date.now()\n\n  function clearExistingTimeout() {\n    if (timeoutID) {\n      clearTimeout(timeoutID)\n      timeoutID = undefined\n      return true\n    }\n    return false\n  }\n\n  function wrapper(this: any, ...args: any[]) {\n    const now = Date.now()\n    const elapsed = now - checkpoint\n\n    // function debugElapsed() {\n    //   const dnow = Date.now()\n    //   return `total ${(dnow - debugCheckpoint).toFixed(1)}ms - elapsed ${(\n    //     dnow - checkpoint\n    //   ).toFixed(1)}ms - visited ${visited}x`\n    // }\n\n    const exec = () => {\n      visited = 0\n      checkpoint = Date.now()\n      callback.apply(this, args)\n    }\n\n    trailingExec = exec\n\n    // Make sure enough time has passed since last call\n    if (elapsed > delay || !timeoutID) {\n      // DEBUG && log('elapsed', debugElapsed())\n\n      // Leading execute once immediately\n      if (leading) {\n        if (elapsed > delay) {\n          // DEBUG && log('🚀 leading', debugElapsed())\n          exec()\n        }\n        else {\n          ++visited // at least trigger trailing this way\n        }\n      }\n\n      const timeout = elapsed > delay ? delay : delay - elapsed\n      // log(`⏱ start timeout with ${timeout.toFixed(1)}ms`, debugElapsed())\n\n      // Prepare for next round\n      clearExistingTimeout()\n      checkpoint = now\n\n      // Delay. We should not get here if timeout has not been reached before\n      timeoutID = setTimeout(() => {\n        // DEBUG && log('⏱ reached timeout', debugElapsed())\n        clearExistingTimeout()\n        // Only execute on trailing or when visited again, but do not twice if leading\n        if (trailing && (!leading || visited > 0)) {\n          // DEBUG && log('🚀 trailing', debugElapsed())\n          trailingExec?.()\n        }\n      }, timeout)\n    }\n    else {\n      // Count visits\n      ++visited\n      // DEBUG && log('visited', debugElapsed())\n    }\n  }\n\n  wrapper.cancel = clearExistingTimeout\n\n  wrapper.stop = () => {\n    if (clearExistingTimeout() && trailingExec)\n      trailingExec()\n  }\n\n  wrapper.immediate = async function immediate(this: any, ...args: Parameters<F>[]) {\n    clearExistingTimeout()\n    checkpoint = Date.now()\n    callback.apply(this, args)\n  }\n\n  wrapper.dispose = () => wrapper.stop()\n\n  return wrapper as any\n}\n\n/**\n * Debounce fits best for filtering a large peak of events.\n * For UI event filtering throttle is probably a better choice.\n *\n * **Functionality:**  It only fires after triggers pause for `delay` ms.\n */\nexport function debounce<F extends (...args: any[]) => any | Promise<any>>(\n  callback: F,\n  opt: {\n    delay?: number\n  } = {},\n): F & {\n  cancel: () => void\n  immediate: (...args: Parameters<F>) => Promise<void>\n  dispose: () => void\n} {\n  const { delay = 100 } = opt\n  let timeoutID: any\n  let running = false\n  let lastArguments: any[] | undefined\n\n  function clearExistingTimeout() {\n    if (timeoutID) {\n      // log('clear')\n      clearTimeout(timeoutID)\n      timeoutID = undefined\n    }\n  }\n\n  async function exec() {\n    try {\n      clearExistingTimeout()\n      if (lastArguments != null) {\n        // log('exec')\n        const args = [...lastArguments]\n        lastArguments = undefined\n        running = true\n        await promisify(callback(...args))\n        running = false\n        // log('exec done')\n        if (lastArguments != null) {\n          clearExistingTimeout()\n          // log('exec trigger next')\n          timeoutID = setTimeout(exec, delay)\n        }\n      }\n    }\n    catch (err) { }\n  }\n\n  function wrapper(this: any, ...args: any[]) {\n    lastArguments = [...args]\n    clearExistingTimeout()\n    // log('trigger')\n    if (running === false)\n      timeoutID = setTimeout(exec, delay)\n  }\n\n  async function immediate(this: any, ...args: any[]) {\n    clearExistingTimeout()\n    lastArguments = [...args]\n    await exec()\n  }\n\n  wrapper.cancel = clearExistingTimeout\n  wrapper.dispose = clearExistingTimeout\n  wrapper.immediate = immediate\n\n  return wrapper as any\n}\n"],"mappings":"oGAoBA,SAAgB,EACd,EACA,EAII,EAAE,CAYN,CACA,GAAM,CAAE,QAAQ,IAAK,WAAW,GAAM,UAAU,IAAS,EAErD,EACA,EAAa,EACb,EAAU,EACV,EAIJ,SAAS,GAAuB,CAM9B,OALI,GACF,aAAa,EAAU,CACvB,EAAY,IAAA,GACL,IAEF,GAGT,SAAS,EAAmB,GAAG,EAAa,CAC1C,IAAM,EAAM,KAAK,KAAK,CAChB,EAAU,EAAM,EAShB,MAAa,CACjB,EAAU,EACV,EAAa,KAAK,KAAK,CACvB,EAAS,MAAM,KAAM,EAAK,EAM5B,GAHA,EAAe,EAGX,EAAU,GAAS,CAAC,EAAW,CAI7B,IACE,EAAU,EAEZ,GAAM,CAGN,EAAE,GAIN,IAAM,EAAU,EAAU,EAAQ,EAAQ,EAAQ,EAIlD,GAAsB,CACtB,EAAa,EAGb,EAAY,eAAiB,CAE3B,GAAsB,CAElB,IAAa,CAAC,GAAW,EAAU,IAErC,KAAgB,EAEjB,EAAQ,MAIX,EAAE,EAoBN,MAfA,GAAQ,OAAS,EAEjB,EAAQ,SAAa,CACf,GAAsB,EAAI,GAC5B,GAAc,EAGlB,EAAQ,UAAY,eAAoC,GAAG,EAAuB,CAChF,GAAsB,CACtB,EAAa,KAAK,KAAK,CACvB,EAAS,MAAM,KAAM,EAAK,EAG5B,EAAQ,YAAgB,EAAQ,MAAM,CAE/B,EAST,SAAgB,EACd,EACA,EAEI,EAAE,CAKN,CACA,GAAM,CAAE,QAAQ,KAAQ,EACpB,EACA,EAAU,GACV,EAEJ,SAAS,GAAuB,CAC9B,AAGE,KADA,aAAa,EAAU,CACX,IAAA,IAIhB,eAAe,GAAO,CACpB,GAAI,CAEF,GADA,GAAsB,CAClB,GAAiB,KAAM,CAEzB,IAAM,EAAO,CAAC,GAAG,EAAc,CAC/B,EAAgB,IAAA,GAChB,EAAU,GACV,MAAMA,EAAAA,UAAU,EAAS,GAAG,EAAK,CAAC,CAClC,EAAU,GAEN,GAAiB,OACnB,GAAsB,CAEtB,EAAY,WAAW,EAAM,EAAM,QAI7B,GAGd,SAAS,EAAmB,GAAG,EAAa,CAC1C,EAAgB,CAAC,GAAG,EAAK,CACzB,GAAsB,CAElB,IAAY,KACd,EAAY,WAAW,EAAM,EAAM,EAGvC,eAAe,EAAqB,GAAG,EAAa,CAClD,GAAsB,CACtB,EAAgB,CAAC,GAAG,EAAK,CACzB,MAAM,GAAM,CAOd,MAJA,GAAQ,OAAS,EACjB,EAAQ,QAAU,EAClB,EAAQ,UAAY,EAEb"}
+{"version":3,"file":"throttle-debounce.cjs","names":["promisify"],"sources":["../../../src/common/exec/throttle-debounce.ts"],"sourcesContent":["// General explaination https://css-tricks.com/debouncing-throttling-explained-examples/\n// From https://github.com/cowboy/jquery-throttle-debounce\n// And https://github.com/wuct/raf-throttle/blob/master/rafThrottle.js\n\nimport { promisify } from './promise'\n\n// const DEBUG = false\n// const log = DEBUG ? LoggerLazy('zeed:throttle', 'error') : () => {}\n\n/**\n * A special throttle implementation that tries to distribute execution\n * in an optimal way.\n *\n * **Functionality:** For UI usage the function is executed on first occasion (`leading`).\n * If more calls follow it will again be executed at end (`trailing`).\n * If the next call is inside the timeframe, it is delayed until `trailing`.\n * This avoids timewise too close calls.\n * It is possible to `cancel` the timeout and to `flush` a call, e.g. if\n * leaving UI situation where a final call is required to write data or similar.\n */\nexport function throttle<F extends (...args: any[]) => any>(\n  callback: F,\n  opt: {\n    delay?: number\n    trailing?: boolean\n    leading?: boolean\n  } = {},\n): F & {\n  /** Stop all timers, do not exec nothing */\n  cancel: () => void\n\n  /** Stop all timers and execute right now. */\n  immediate: (...args: Parameters<F>) => Promise<void>\n\n  /** Stop all timers and execute trailing call, if exists. */\n  stop: () => void\n\n  dispose: () => void\n} {\n  const { delay = 100, trailing = true, leading = true } = opt\n\n  let timeoutID: any\n  let checkpoint = 0\n  let visited = 0\n  let trailingExec: () => void | undefined\n\n  // const debugCheckpoint = Date.now()\n\n  function clearExistingTimeout() {\n    if (timeoutID) {\n      clearTimeout(timeoutID)\n      timeoutID = undefined\n      return true\n    }\n    return false\n  }\n\n  function wrapper(this: any, ...args: any[]) {\n    const now = Date.now()\n    const elapsed = now - checkpoint\n\n    // function debugElapsed() {\n    //   const dnow = Date.now()\n    //   return `total ${(dnow - debugCheckpoint).toFixed(1)}ms - elapsed ${(\n    //     dnow - checkpoint\n    //   ).toFixed(1)}ms - visited ${visited}x`\n    // }\n\n    const exec = () => {\n      visited = 0\n      checkpoint = Date.now()\n      callback.apply(this, args)\n    }\n\n    trailingExec = exec\n\n    // Make sure enough time has passed since last call\n    if (elapsed > delay || !timeoutID) {\n      // DEBUG && log('elapsed', debugElapsed())\n\n      // Leading execute once immediately\n      if (leading) {\n        if (elapsed > delay) {\n          // DEBUG && log('🚀 leading', debugElapsed())\n          exec()\n        }\n        else {\n          ++visited // at least trigger trailing this way\n        }\n      }\n\n      const timeout = elapsed > delay ? delay : delay - elapsed\n      // log(`⏱ start timeout with ${timeout.toFixed(1)}ms`, debugElapsed())\n\n      // Prepare for next round\n      clearExistingTimeout()\n      checkpoint = now\n\n      // Delay. We should not get here if timeout has not been reached before\n      timeoutID = setTimeout(() => {\n        // DEBUG && log('⏱ reached timeout', debugElapsed())\n        clearExistingTimeout()\n        // Only execute on trailing or when visited again, but do not twice if leading\n        if (trailing && (!leading || visited > 0)) {\n          // DEBUG && log('🚀 trailing', debugElapsed())\n          trailingExec?.()\n        }\n      }, timeout)\n    }\n    else {\n      // Count visits\n      ++visited\n      // DEBUG && log('visited', debugElapsed())\n    }\n  }\n\n  wrapper.cancel = clearExistingTimeout\n\n  wrapper.stop = () => {\n    if (clearExistingTimeout() && trailingExec)\n      trailingExec()\n  }\n\n  wrapper.immediate = async function immediate(this: any, ...args: Parameters<F>[]) {\n    clearExistingTimeout()\n    checkpoint = Date.now()\n    callback.apply(this, args)\n  }\n\n  wrapper.dispose = () => wrapper.stop()\n\n  return wrapper as any\n}\n\n/**\n * Debounce fits best for filtering a large peak of events.\n * For UI event filtering throttle is probably a better choice.\n *\n * **Functionality:**  It only fires after triggers pause for `delay` ms.\n */\nexport function debounce<F extends (...args: any[]) => any | Promise<any>>(\n  callback: F,\n  opt: {\n    delay?: number\n  } = {},\n): F & {\n  cancel: () => void\n  immediate: (...args: Parameters<F>) => Promise<void>\n  dispose: () => void\n} {\n  const { delay = 100 } = opt\n  let timeoutID: any\n  let running = false\n  let lastArguments: any[] | undefined\n\n  function clearExistingTimeout() {\n    if (timeoutID) {\n      // log('clear')\n      clearTimeout(timeoutID)\n      timeoutID = undefined\n    }\n  }\n\n  async function exec() {\n    try {\n      clearExistingTimeout()\n      if (lastArguments != null) {\n        // log('exec')\n        const args = [...lastArguments]\n        lastArguments = undefined\n        running = true\n        await promisify(callback(...args))\n        running = false\n        // log('exec done')\n        if (lastArguments != null) {\n          clearExistingTimeout()\n          // log('exec trigger next')\n          timeoutID = setTimeout(exec, delay)\n        }\n      }\n    }\n    catch (err) { }\n  }\n\n  function wrapper(this: any, ...args: any[]) {\n    lastArguments = [...args]\n    clearExistingTimeout()\n    // log('trigger')\n    if (running === false)\n      timeoutID = setTimeout(exec, delay)\n  }\n\n  async function immediate(this: any, ...args: any[]) {\n    clearExistingTimeout()\n    lastArguments = [...args]\n    await exec()\n  }\n\n  wrapper.cancel = clearExistingTimeout\n  wrapper.dispose = clearExistingTimeout\n  wrapper.immediate = immediate\n\n  return wrapper as any\n}\n"],"mappings":";;;;;;;;;;;;;;;AAoBA,SAAgB,SACd,UACA,MAII,EAAE,EAYN;CACA,MAAM,EAAE,QAAQ,KAAK,WAAW,MAAM,UAAU,SAAS;CAEzD,IAAI;CACJ,IAAI,aAAa;CACjB,IAAI,UAAU;CACd,IAAI;CAIJ,SAAS,uBAAuB;AAC9B,MAAI,WAAW;AACb,gBAAa,UAAU;AACvB,eAAY;AACZ,UAAO;;AAET,SAAO;;CAGT,SAAS,QAAmB,GAAG,MAAa;EAC1C,MAAM,MAAM,KAAK,KAAK;EACtB,MAAM,UAAU,MAAM;EAStB,MAAM,aAAa;AACjB,aAAU;AACV,gBAAa,KAAK,KAAK;AACvB,YAAS,MAAM,MAAM,KAAK;;AAG5B,iBAAe;AAGf,MAAI,UAAU,SAAS,CAAC,WAAW;AAIjC,OAAI,QACF,KAAI,UAAU,MAEZ,OAAM;OAGN,GAAE;GAIN,MAAM,UAAU,UAAU,QAAQ,QAAQ,QAAQ;AAIlD,yBAAsB;AACtB,gBAAa;AAGb,eAAY,iBAAiB;AAE3B,0BAAsB;AAEtB,QAAI,aAAa,CAAC,WAAW,UAAU,GAErC,iBAAgB;MAEjB,QAAQ;QAIX,GAAE;;AAKN,SAAQ,SAAS;AAEjB,SAAQ,aAAa;AACnB,MAAI,sBAAsB,IAAI,aAC5B,eAAc;;AAGlB,SAAQ,YAAY,eAAe,UAAqB,GAAG,MAAuB;AAChF,wBAAsB;AACtB,eAAa,KAAK,KAAK;AACvB,WAAS,MAAM,MAAM,KAAK;;AAG5B,SAAQ,gBAAgB,QAAQ,MAAM;AAEtC,QAAO;;;;;;;;AAST,SAAgB,SACd,UACA,MAEI,EAAE,EAKN;CACA,MAAM,EAAE,QAAQ,QAAQ;CACxB,IAAI;CACJ,IAAI,UAAU;CACd,IAAI;CAEJ,SAAS,uBAAuB;AAC9B,MAAI,WAAW;AAEb,gBAAa,UAAU;AACvB,eAAY;;;CAIhB,eAAe,OAAO;AACpB,MAAI;AACF,yBAAsB;AACtB,OAAI,iBAAiB,MAAM;IAEzB,MAAM,OAAO,CAAC,GAAG,cAAc;AAC/B,oBAAgB;AAChB,cAAU;AACV,UAAMA,sCAAU,SAAS,GAAG,KAAK,CAAC;AAClC,cAAU;AAEV,QAAI,iBAAiB,MAAM;AACzB,2BAAsB;AAEtB,iBAAY,WAAW,MAAM,MAAM;;;WAIlC,KAAK;;CAGd,SAAS,QAAmB,GAAG,MAAa;AAC1C,kBAAgB,CAAC,GAAG,KAAK;AACzB,wBAAsB;AAEtB,MAAI,YAAY,MACd,aAAY,WAAW,MAAM,MAAM;;CAGvC,eAAe,UAAqB,GAAG,MAAa;AAClD,wBAAsB;AACtB,kBAAgB,CAAC,GAAG,KAAK;AACzB,QAAM,MAAM;;AAGd,SAAQ,SAAS;AACjB,SAAQ,UAAU;AAClB,SAAQ,YAAY;AAEpB,QAAO"}

package/dist/common/exec/throttle-debounce.mjs

@@ -1,2 +1,113 @@
-import{promisify as e}from"./promise.mjs";function t(e,t={}){let{delay:n=100,trailing:r=!0,leading:i=!0}=t,a,o=0,s=0,c;function l(){return a?(clearTimeout(a),a=void 0,!0):!1}function u(...t){let u=Date.now(),d=u-o,f=()=>{s=0,o=Date.now(),e.apply(this,t)};if(c=f,d>n||!a){i&&(d>n?f():++s);let e=d>n?n:n-d;l(),o=u,a=setTimeout(()=>{l(),r&&(!i||s>0)&&c?.()},e)}else ++s}return u.cancel=l,u.stop=()=>{l()&&c&&c()},u.immediate=async function(...t){l(),o=Date.now(),e.apply(this,t)},u.dispose=()=>u.stop(),u}function n(t,n={}){let{delay:r=100}=n,i,a=!1,o;function s(){i&&=(clearTimeout(i),void 0)}async function c(){try{if(s(),o!=null){let n=[...o];o=void 0,a=!0,await e(t(...n)),a=!1,o!=null&&(s(),i=setTimeout(c,r))}}catch{}}function l(...e){o=[...e],s(),a===!1&&(i=setTimeout(c,r))}async function u(...e){s(),o=[...e],await c()}return l.cancel=s,l.dispose=s,l.immediate=u,l}export{n as debounce,t as throttle};
+import { promisify } from "./promise.mjs";
+
+//#region src/common/exec/throttle-debounce.ts
+/**
+* A special throttle implementation that tries to distribute execution
+* in an optimal way.
+*
+* **Functionality:** For UI usage the function is executed on first occasion (`leading`).
+* If more calls follow it will again be executed at end (`trailing`).
+* If the next call is inside the timeframe, it is delayed until `trailing`.
+* This avoids timewise too close calls.
+* It is possible to `cancel` the timeout and to `flush` a call, e.g. if
+* leaving UI situation where a final call is required to write data or similar.
+*/
+function throttle(callback, opt = {}) {
+	const { delay = 100, trailing = true, leading = true } = opt;
+	let timeoutID;
+	let checkpoint = 0;
+	let visited = 0;
+	let trailingExec;
+	function clearExistingTimeout() {
+		if (timeoutID) {
+			clearTimeout(timeoutID);
+			timeoutID = void 0;
+			return true;
+		}
+		return false;
+	}
+	function wrapper(...args) {
+		const now = Date.now();
+		const elapsed = now - checkpoint;
+		const exec = () => {
+			visited = 0;
+			checkpoint = Date.now();
+			callback.apply(this, args);
+		};
+		trailingExec = exec;
+		if (elapsed > delay || !timeoutID) {
+			if (leading) if (elapsed > delay) exec();
+			else ++visited;
+			const timeout = elapsed > delay ? delay : delay - elapsed;
+			clearExistingTimeout();
+			checkpoint = now;
+			timeoutID = setTimeout(() => {
+				clearExistingTimeout();
+				if (trailing && (!leading || visited > 0)) trailingExec?.();
+			}, timeout);
+		} else ++visited;
+	}
+	wrapper.cancel = clearExistingTimeout;
+	wrapper.stop = () => {
+		if (clearExistingTimeout() && trailingExec) trailingExec();
+	};
+	wrapper.immediate = async function immediate(...args) {
+		clearExistingTimeout();
+		checkpoint = Date.now();
+		callback.apply(this, args);
+	};
+	wrapper.dispose = () => wrapper.stop();
+	return wrapper;
+}
+/**
+* Debounce fits best for filtering a large peak of events.
+* For UI event filtering throttle is probably a better choice.
+*
+* **Functionality:**  It only fires after triggers pause for `delay` ms.
+*/
+function debounce(callback, opt = {}) {
+	const { delay = 100 } = opt;
+	let timeoutID;
+	let running = false;
+	let lastArguments;
+	function clearExistingTimeout() {
+		if (timeoutID) {
+			clearTimeout(timeoutID);
+			timeoutID = void 0;
+		}
+	}
+	async function exec() {
+		try {
+			clearExistingTimeout();
+			if (lastArguments != null) {
+				const args = [...lastArguments];
+				lastArguments = void 0;
+				running = true;
+				await promisify(callback(...args));
+				running = false;
+				if (lastArguments != null) {
+					clearExistingTimeout();
+					timeoutID = setTimeout(exec, delay);
+				}
+			}
+		} catch (err) {}
+	}
+	function wrapper(...args) {
+		lastArguments = [...args];
+		clearExistingTimeout();
+		if (running === false) timeoutID = setTimeout(exec, delay);
+	}
+	async function immediate(...args) {
+		clearExistingTimeout();
+		lastArguments = [...args];
+		await exec();
+	}
+	wrapper.cancel = clearExistingTimeout;
+	wrapper.dispose = clearExistingTimeout;
+	wrapper.immediate = immediate;
+	return wrapper;
+}
+
+//#endregion
+export { debounce, throttle };
 //# sourceMappingURL=throttle-debounce.mjs.map