zeed 1.3.0 → 1.4.0

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

@@ -1 +1 @@
-{"version":3,"file":"xrx.cjs","names":[],"sources":["../../../src/common/data/xrx.ts"],"sourcesContent":["/* eslint-disable no-cond-assign */\n\nconst RX_WHITESPACE = /\\\\\\s|\\s+|#[^\\n]*\\n?/g\nconst RX_REAL_GROUPS = /\\(\\?P?<(\\w{2,})>|\\((?!\\?([:!=]|<=|<!))/g\n// eslint-disable-next-line regexp/no-unused-capturing-group\nconst RX_LOOK_BEHIND = /^((?:\\(\\?[\\w$]+\\))?)\\(\\?<([=!])([\\s\\S]*?)\\)/gm\n\nexport function regExpString(rx: string | RegExp): string {\n  return typeof rx === 'string' ? rx : (rx.source || '')\n}\n\nexport function regExpEscape(str: string): string {\n  return str.replace(/[-[\\]{}()*+?.,\\\\^$|#\\s]/g, '\\\\$&')\n}\n\nexport class XRX {\n  lookBehind:any\n  namedGroups: Record<string, number> = {}\n  names: string[] = []\n  rx: RegExp\n\n  constructor(pattern: string | RegExp, flags?: string) {\n    let _flags: string = flags ?? ''\n    let _rx: string\n\n    if (pattern instanceof RegExp) {\n      if (flags == null)\n        _flags = pattern.flags\n\n      _rx = pattern.source\n    }\n    else {\n      _rx = pattern\n    }\n\n    // eXtended / Ignore Whitespace\n    const extended = _flags && _flags.includes('x')\n    if (extended) {\n      _flags = _flags.replace('x', '')\n      _rx = _rx.replace(RX_WHITESPACE, (r) => {\n        // log('rp', r)\n        return r[0] === '\\\\' ? r : ''\n      })\n    }\n\n    // Named Groups\n    if (!(pattern instanceof RegExp)) {\n      let index = 0\n      _rx = _rx.replace(RX_REAL_GROUPS, (str, name) => {\n        // log('>>>', name)\n        index += 1\n        if (name) {\n          if (\n            name !== 'index'\n            && name !== 'length'\n            && !this.namedGroups[name]\n          ) {\n            this.namedGroups[name] = index\n          }\n          // else\n          //   log.error(`Unallowed or duplicate group name: ${name}`)\n\n          return '('\n        }\n        return str\n      })\n      this.names = Object.keys(this.namedGroups)\n    }\n\n    // http://www.rexegg.com/regex-best-trick.html\n\n    _rx = regExpString(_rx)\n    RX_LOOK_BEHIND.lastIndex = 0\n    const parts = RX_LOOK_BEHIND.exec(_rx)\n    if (parts) {\n      this.lookBehind = {\n        rx: new RegExp(`${parts[3]}$(?!\\\\s)`),\n        expect: parts ? parts[2] === '=' : !parts,\n      }\n      _rx = _rx.substr(parts[0].length)\n    }\n\n    this.rx = new RegExp(_rx, _flags)\n  }\n\n  // flagsString() {\n  //     let hash = this.rx.toString() + '/'\n  //     if (this.rx.global) {\n  //         hash += 'g'\n  //     }\n  //     if (this.rx.multiline) {\n  //         hash += 'm'\n  //     }\n  //     if (this.rx.ignoreCase) {\n  //         hash += 'i'\n  //     }\n  //     if (this.rx.unicode) {\n  //         hash += 'u'\n  //     }\n  //     if (this.rx.sticky) {\n  //         hash += 'y'\n  //     }\n  // }\n\n  get lastIndex(): number {\n    return this.rx.lastIndex\n  }\n\n  set lastIndex(index: number) {\n    this.rx.lastIndex = index\n  }\n\n  _handleMatch(m: any) {\n    if (this.lookBehind) {\n      const leftContext = m.input.slice(0, m.index)\n      if (this.lookBehind.expect !== this.lookBehind.rx.test(leftContext))\n        return null\n    }\n    for (const name of this.names)\n      m[name] = m[this.namedGroups[name]]\n\n    return m\n  }\n\n  exec(str: string) {\n    let m\n    while ((m = this.rx.exec(str))) {\n      if (this.rx.lastIndex === m.index)\n        this.rx.lastIndex++\n      m = this._handleMatch(m)\n      if (m != null)\n        return m\n    }\n  }\n\n  execAll(str: string) {\n    const matches = []\n    let m\n    this.rx.lastIndex = 0\n    while ((m = this.exec(str)))\n      matches.push(m)\n\n    this.rx.lastIndex = 0\n    // log('execAll:', matches)\n    return matches\n  }\n\n  replace(str: string, replacement: string | ((m: string) => string)) {\n    const fn = typeof replacement === 'function' ? replacement : () => replacement\n    return str.replace(this.rx, (m) => {\n      // m = this._handleMatch(m)\n      return fn(m)\n    })\n  }\n}\n"],"mappings":"mEAEA,MAAM,EAAgB,uBAChB,EAAiB,0CAEjB,EAAiB,gDAEvB,SAAgB,EAAa,EAA6B,CACxD,OAAO,OAAO,GAAO,SAAW,EAAM,EAAG,QAAU,GAGrD,SAAgB,EAAa,EAAqB,CAChD,OAAO,EAAI,QAAQ,2BAA4B,OAAO,CAGxD,IAAa,EAAb,KAAiB,CACf,WACA,YAAsC,EAAE,CACxC,MAAkB,EAAE,CACpB,GAEA,YAAY,EAA0B,EAAgB,CACpD,IAAI,EAAiB,GAAS,GAC1B,EAuBJ,GArBI,aAAmB,QACjB,IACF,EAAS,EAAQ,OAEnB,EAAM,EAAQ,QAGd,EAAM,EAIS,GAAU,EAAO,SAAS,IAAI,GAE7C,EAAS,EAAO,QAAQ,IAAK,GAAG,CAChC,EAAM,EAAI,QAAQ,EAAgB,GAEzB,EAAE,KAAO,KAAO,EAAI,GAC3B,EAIA,EAAE,aAAmB,QAAS,CAChC,IAAI,EAAQ,EACZ,EAAM,EAAI,QAAQ,GAAiB,EAAK,KAEtC,GAAS,EACL,GAEA,IAAS,SACN,IAAS,UACT,CAAC,KAAK,YAAY,KAErB,KAAK,YAAY,GAAQ,GAKpB,KAEF,GACP,CACF,KAAK,MAAQ,OAAO,KAAK,KAAK,YAAY,CAK5C,EAAM,EAAa,EAAI,CACvB,EAAe,UAAY,EAC3B,IAAM,EAAQ,EAAe,KAAK,EAAI,CAClC,IACF,KAAK,WAAa,CAChB,GAAQ,OAAO,GAAG,EAAM,GAAG,UAAU,CACrC,OAAQ,EAAQ,EAAM,KAAO,IAAM,CAAC,EACrC,CACD,EAAM,EAAI,OAAO,EAAM,GAAG,OAAO,EAGnC,KAAK,GAAK,IAAI,OAAO,EAAK,EAAO,CAsBnC,IAAI,WAAoB,CACtB,OAAO,KAAK,GAAG,UAGjB,IAAI,UAAU,EAAe,CAC3B,KAAK,GAAG,UAAY,EAGtB,aAAa,EAAQ,CACnB,GAAI,KAAK,WAAY,CACnB,IAAM,EAAc,EAAE,MAAM,MAAM,EAAG,EAAE,MAAM,CAC7C,GAAI,KAAK,WAAW,SAAW,KAAK,WAAW,GAAG,KAAK,EAAY,CACjE,OAAO,KAEX,IAAK,IAAM,KAAQ,KAAK,MACtB,EAAE,GAAQ,EAAE,KAAK,YAAY,IAE/B,OAAO,EAGT,KAAK,EAAa,CAChB,IAAI,EACJ,KAAQ,EAAI,KAAK,GAAG,KAAK,EAAI,EAI3B,GAHI,KAAK,GAAG,YAAc,EAAE,OAC1B,KAAK,GAAG,YACV,EAAI,KAAK,aAAa,EAAE,CACpB,GAAK,KACP,OAAO,EAIb,QAAQ,EAAa,CACnB,IAAM,EAAU,EAAE,CACd,EAEJ,IADA,KAAK,GAAG,UAAY,EACZ,EAAI,KAAK,KAAK,EAAI,EACxB,EAAQ,KAAK,EAAE,CAIjB,MAFA,MAAK,GAAG,UAAY,EAEb,EAGT,QAAQ,EAAa,EAA+C,CAClE,IAAM,EAAK,OAAO,GAAgB,WAAa,MAAoB,EACnE,OAAO,EAAI,QAAQ,KAAK,GAAK,GAEpB,EAAG,EAAE,CACZ"}
+{"version":3,"file":"xrx.cjs","names":[],"sources":["../../../src/common/data/xrx.ts"],"sourcesContent":["/* eslint-disable no-cond-assign */\n\nconst RX_WHITESPACE = /\\\\\\s|\\s+|#[^\\n]*\\n?/g\nconst RX_REAL_GROUPS = /\\(\\?P?<(\\w{2,})>|\\((?!\\?([:!=]|<=|<!))/g\n// eslint-disable-next-line regexp/no-unused-capturing-group\nconst RX_LOOK_BEHIND = /^((?:\\(\\?[\\w$]+\\))?)\\(\\?<([=!])([\\s\\S]*?)\\)/gm\n\nexport function regExpString(rx: string | RegExp): string {\n  return typeof rx === 'string' ? rx : (rx.source || '')\n}\n\nexport function regExpEscape(str: string): string {\n  return str.replace(/[-[\\]{}()*+?.,\\\\^$|#\\s]/g, '\\\\$&')\n}\n\nexport class XRX {\n  lookBehind:any\n  namedGroups: Record<string, number> = {}\n  names: string[] = []\n  rx: RegExp\n\n  constructor(pattern: string | RegExp, flags?: string) {\n    let _flags: string = flags ?? ''\n    let _rx: string\n\n    if (pattern instanceof RegExp) {\n      if (flags == null)\n        _flags = pattern.flags\n\n      _rx = pattern.source\n    }\n    else {\n      _rx = pattern\n    }\n\n    // eXtended / Ignore Whitespace\n    const extended = _flags && _flags.includes('x')\n    if (extended) {\n      _flags = _flags.replace('x', '')\n      _rx = _rx.replace(RX_WHITESPACE, (r) => {\n        // log('rp', r)\n        return r[0] === '\\\\' ? r : ''\n      })\n    }\n\n    // Named Groups\n    if (!(pattern instanceof RegExp)) {\n      let index = 0\n      _rx = _rx.replace(RX_REAL_GROUPS, (str, name) => {\n        // log('>>>', name)\n        index += 1\n        if (name) {\n          if (\n            name !== 'index'\n            && name !== 'length'\n            && !this.namedGroups[name]\n          ) {\n            this.namedGroups[name] = index\n          }\n          // else\n          //   log.error(`Unallowed or duplicate group name: ${name}`)\n\n          return '('\n        }\n        return str\n      })\n      this.names = Object.keys(this.namedGroups)\n    }\n\n    // http://www.rexegg.com/regex-best-trick.html\n\n    _rx = regExpString(_rx)\n    RX_LOOK_BEHIND.lastIndex = 0\n    const parts = RX_LOOK_BEHIND.exec(_rx)\n    if (parts) {\n      this.lookBehind = {\n        rx: new RegExp(`${parts[3]}$(?!\\\\s)`),\n        expect: parts ? parts[2] === '=' : !parts,\n      }\n      _rx = _rx.substr(parts[0].length)\n    }\n\n    this.rx = new RegExp(_rx, _flags)\n  }\n\n  // flagsString() {\n  //     let hash = this.rx.toString() + '/'\n  //     if (this.rx.global) {\n  //         hash += 'g'\n  //     }\n  //     if (this.rx.multiline) {\n  //         hash += 'm'\n  //     }\n  //     if (this.rx.ignoreCase) {\n  //         hash += 'i'\n  //     }\n  //     if (this.rx.unicode) {\n  //         hash += 'u'\n  //     }\n  //     if (this.rx.sticky) {\n  //         hash += 'y'\n  //     }\n  // }\n\n  get lastIndex(): number {\n    return this.rx.lastIndex\n  }\n\n  set lastIndex(index: number) {\n    this.rx.lastIndex = index\n  }\n\n  _handleMatch(m: any) {\n    if (this.lookBehind) {\n      const leftContext = m.input.slice(0, m.index)\n      if (this.lookBehind.expect !== this.lookBehind.rx.test(leftContext))\n        return null\n    }\n    for (const name of this.names)\n      m[name] = m[this.namedGroups[name]]\n\n    return m\n  }\n\n  exec(str: string) {\n    let m\n    while ((m = this.rx.exec(str))) {\n      if (this.rx.lastIndex === m.index)\n        this.rx.lastIndex++\n      m = this._handleMatch(m)\n      if (m != null)\n        return m\n    }\n  }\n\n  execAll(str: string) {\n    const matches = []\n    let m\n    this.rx.lastIndex = 0\n    while ((m = this.exec(str)))\n      matches.push(m)\n\n    this.rx.lastIndex = 0\n    // log('execAll:', matches)\n    return matches\n  }\n\n  replace(str: string, replacement: string | ((m: string) => string)) {\n    const fn = typeof replacement === 'function' ? replacement : () => replacement\n    return str.replace(this.rx, (m) => {\n      // m = this._handleMatch(m)\n      return fn(m)\n    })\n  }\n}\n"],"mappings":";;;AAEA,MAAM,gBAAgB;AACtB,MAAM,iBAAiB;AAEvB,MAAM,iBAAiB;AAEvB,SAAgB,aAAa,IAA6B;AACxD,QAAO,OAAO,OAAO,WAAW,KAAM,GAAG,UAAU;;AAGrD,SAAgB,aAAa,KAAqB;AAChD,QAAO,IAAI,QAAQ,4BAA4B,OAAO;;AAGxD,IAAa,MAAb,MAAiB;CACf;CACA,cAAsC,EAAE;CACxC,QAAkB,EAAE;CACpB;CAEA,YAAY,SAA0B,OAAgB;EACpD,IAAI,SAAiB,SAAS;EAC9B,IAAI;AAEJ,MAAI,mBAAmB,QAAQ;AAC7B,OAAI,SAAS,KACX,UAAS,QAAQ;AAEnB,SAAM,QAAQ;QAGd,OAAM;AAKR,MADiB,UAAU,OAAO,SAAS,IAAI,EACjC;AACZ,YAAS,OAAO,QAAQ,KAAK,GAAG;AAChC,SAAM,IAAI,QAAQ,gBAAgB,MAAM;AAEtC,WAAO,EAAE,OAAO,OAAO,IAAI;KAC3B;;AAIJ,MAAI,EAAE,mBAAmB,SAAS;GAChC,IAAI,QAAQ;AACZ,SAAM,IAAI,QAAQ,iBAAiB,KAAK,SAAS;AAE/C,aAAS;AACT,QAAI,MAAM;AACR,SACE,SAAS,WACN,SAAS,YACT,CAAC,KAAK,YAAY,MAErB,MAAK,YAAY,QAAQ;AAK3B,YAAO;;AAET,WAAO;KACP;AACF,QAAK,QAAQ,OAAO,KAAK,KAAK,YAAY;;AAK5C,QAAM,aAAa,IAAI;AACvB,iBAAe,YAAY;EAC3B,MAAM,QAAQ,eAAe,KAAK,IAAI;AACtC,MAAI,OAAO;AACT,QAAK,aAAa;IAChB,IAAI,IAAI,OAAO,GAAG,MAAM,GAAG,UAAU;IACrC,QAAQ,QAAQ,MAAM,OAAO,MAAM,CAAC;IACrC;AACD,SAAM,IAAI,OAAO,MAAM,GAAG,OAAO;;AAGnC,OAAK,KAAK,IAAI,OAAO,KAAK,OAAO;;CAsBnC,IAAI,YAAoB;AACtB,SAAO,KAAK,GAAG;;CAGjB,IAAI,UAAU,OAAe;AAC3B,OAAK,GAAG,YAAY;;CAGtB,aAAa,GAAQ;AACnB,MAAI,KAAK,YAAY;GACnB,MAAM,cAAc,EAAE,MAAM,MAAM,GAAG,EAAE,MAAM;AAC7C,OAAI,KAAK,WAAW,WAAW,KAAK,WAAW,GAAG,KAAK,YAAY,CACjE,QAAO;;AAEX,OAAK,MAAM,QAAQ,KAAK,MACtB,GAAE,QAAQ,EAAE,KAAK,YAAY;AAE/B,SAAO;;CAGT,KAAK,KAAa;EAChB,IAAI;AACJ,SAAQ,IAAI,KAAK,GAAG,KAAK,IAAI,EAAG;AAC9B,OAAI,KAAK,GAAG,cAAc,EAAE,MAC1B,MAAK,GAAG;AACV,OAAI,KAAK,aAAa,EAAE;AACxB,OAAI,KAAK,KACP,QAAO;;;CAIb,QAAQ,KAAa;EACnB,MAAM,UAAU,EAAE;EAClB,IAAI;AACJ,OAAK,GAAG,YAAY;AACpB,SAAQ,IAAI,KAAK,KAAK,IAAI,CACxB,SAAQ,KAAK,EAAE;AAEjB,OAAK,GAAG,YAAY;AAEpB,SAAO;;CAGT,QAAQ,KAAa,aAA+C;EAClE,MAAM,KAAK,OAAO,gBAAgB,aAAa,oBAAoB;AACnE,SAAO,IAAI,QAAQ,KAAK,KAAK,MAAM;AAEjC,UAAO,GAAG,EAAE;IACZ"}

package/dist/common/data/xrx.mjs

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

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

@@ -1 +1 @@
-{"version":3,"file":"xrx.mjs","names":[],"sources":["../../../src/common/data/xrx.ts"],"sourcesContent":["/* eslint-disable no-cond-assign */\n\nconst RX_WHITESPACE = /\\\\\\s|\\s+|#[^\\n]*\\n?/g\nconst RX_REAL_GROUPS = /\\(\\?P?<(\\w{2,})>|\\((?!\\?([:!=]|<=|<!))/g\n// eslint-disable-next-line regexp/no-unused-capturing-group\nconst RX_LOOK_BEHIND = /^((?:\\(\\?[\\w$]+\\))?)\\(\\?<([=!])([\\s\\S]*?)\\)/gm\n\nexport function regExpString(rx: string | RegExp): string {\n  return typeof rx === 'string' ? rx : (rx.source || '')\n}\n\nexport function regExpEscape(str: string): string {\n  return str.replace(/[-[\\]{}()*+?.,\\\\^$|#\\s]/g, '\\\\$&')\n}\n\nexport class XRX {\n  lookBehind:any\n  namedGroups: Record<string, number> = {}\n  names: string[] = []\n  rx: RegExp\n\n  constructor(pattern: string | RegExp, flags?: string) {\n    let _flags: string = flags ?? ''\n    let _rx: string\n\n    if (pattern instanceof RegExp) {\n      if (flags == null)\n        _flags = pattern.flags\n\n      _rx = pattern.source\n    }\n    else {\n      _rx = pattern\n    }\n\n    // eXtended / Ignore Whitespace\n    const extended = _flags && _flags.includes('x')\n    if (extended) {\n      _flags = _flags.replace('x', '')\n      _rx = _rx.replace(RX_WHITESPACE, (r) => {\n        // log('rp', r)\n        return r[0] === '\\\\' ? r : ''\n      })\n    }\n\n    // Named Groups\n    if (!(pattern instanceof RegExp)) {\n      let index = 0\n      _rx = _rx.replace(RX_REAL_GROUPS, (str, name) => {\n        // log('>>>', name)\n        index += 1\n        if (name) {\n          if (\n            name !== 'index'\n            && name !== 'length'\n            && !this.namedGroups[name]\n          ) {\n            this.namedGroups[name] = index\n          }\n          // else\n          //   log.error(`Unallowed or duplicate group name: ${name}`)\n\n          return '('\n        }\n        return str\n      })\n      this.names = Object.keys(this.namedGroups)\n    }\n\n    // http://www.rexegg.com/regex-best-trick.html\n\n    _rx = regExpString(_rx)\n    RX_LOOK_BEHIND.lastIndex = 0\n    const parts = RX_LOOK_BEHIND.exec(_rx)\n    if (parts) {\n      this.lookBehind = {\n        rx: new RegExp(`${parts[3]}$(?!\\\\s)`),\n        expect: parts ? parts[2] === '=' : !parts,\n      }\n      _rx = _rx.substr(parts[0].length)\n    }\n\n    this.rx = new RegExp(_rx, _flags)\n  }\n\n  // flagsString() {\n  //     let hash = this.rx.toString() + '/'\n  //     if (this.rx.global) {\n  //         hash += 'g'\n  //     }\n  //     if (this.rx.multiline) {\n  //         hash += 'm'\n  //     }\n  //     if (this.rx.ignoreCase) {\n  //         hash += 'i'\n  //     }\n  //     if (this.rx.unicode) {\n  //         hash += 'u'\n  //     }\n  //     if (this.rx.sticky) {\n  //         hash += 'y'\n  //     }\n  // }\n\n  get lastIndex(): number {\n    return this.rx.lastIndex\n  }\n\n  set lastIndex(index: number) {\n    this.rx.lastIndex = index\n  }\n\n  _handleMatch(m: any) {\n    if (this.lookBehind) {\n      const leftContext = m.input.slice(0, m.index)\n      if (this.lookBehind.expect !== this.lookBehind.rx.test(leftContext))\n        return null\n    }\n    for (const name of this.names)\n      m[name] = m[this.namedGroups[name]]\n\n    return m\n  }\n\n  exec(str: string) {\n    let m\n    while ((m = this.rx.exec(str))) {\n      if (this.rx.lastIndex === m.index)\n        this.rx.lastIndex++\n      m = this._handleMatch(m)\n      if (m != null)\n        return m\n    }\n  }\n\n  execAll(str: string) {\n    const matches = []\n    let m\n    this.rx.lastIndex = 0\n    while ((m = this.exec(str)))\n      matches.push(m)\n\n    this.rx.lastIndex = 0\n    // log('execAll:', matches)\n    return matches\n  }\n\n  replace(str: string, replacement: string | ((m: string) => string)) {\n    const fn = typeof replacement === 'function' ? replacement : () => replacement\n    return str.replace(this.rx, (m) => {\n      // m = this._handleMatch(m)\n      return fn(m)\n    })\n  }\n}\n"],"mappings":"AAEA,MAAM,EAAgB,uBAChB,EAAiB,0CAEjB,EAAiB,gDAEvB,SAAgB,EAAa,EAA6B,CACxD,OAAO,OAAO,GAAO,SAAW,EAAM,EAAG,QAAU,GAGrD,SAAgB,EAAa,EAAqB,CAChD,OAAO,EAAI,QAAQ,2BAA4B,OAAO,CAGxD,IAAa,EAAb,KAAiB,CACf,WACA,YAAsC,EAAE,CACxC,MAAkB,EAAE,CACpB,GAEA,YAAY,EAA0B,EAAgB,CACpD,IAAI,EAAiB,GAAS,GAC1B,EAuBJ,GArBI,aAAmB,QACjB,IACF,EAAS,EAAQ,OAEnB,EAAM,EAAQ,QAGd,EAAM,EAIS,GAAU,EAAO,SAAS,IAAI,GAE7C,EAAS,EAAO,QAAQ,IAAK,GAAG,CAChC,EAAM,EAAI,QAAQ,EAAgB,GAEzB,EAAE,KAAO,KAAO,EAAI,GAC3B,EAIA,EAAE,aAAmB,QAAS,CAChC,IAAI,EAAQ,EACZ,EAAM,EAAI,QAAQ,GAAiB,EAAK,KAEtC,GAAS,EACL,GAEA,IAAS,SACN,IAAS,UACT,CAAC,KAAK,YAAY,KAErB,KAAK,YAAY,GAAQ,GAKpB,KAEF,GACP,CACF,KAAK,MAAQ,OAAO,KAAK,KAAK,YAAY,CAK5C,EAAM,EAAa,EAAI,CACvB,EAAe,UAAY,EAC3B,IAAM,EAAQ,EAAe,KAAK,EAAI,CAClC,IACF,KAAK,WAAa,CAChB,GAAQ,OAAO,GAAG,EAAM,GAAG,UAAU,CACrC,OAAQ,EAAQ,EAAM,KAAO,IAAM,CAAC,EACrC,CACD,EAAM,EAAI,OAAO,EAAM,GAAG,OAAO,EAGnC,KAAK,GAAK,IAAI,OAAO,EAAK,EAAO,CAsBnC,IAAI,WAAoB,CACtB,OAAO,KAAK,GAAG,UAGjB,IAAI,UAAU,EAAe,CAC3B,KAAK,GAAG,UAAY,EAGtB,aAAa,EAAQ,CACnB,GAAI,KAAK,WAAY,CACnB,IAAM,EAAc,EAAE,MAAM,MAAM,EAAG,EAAE,MAAM,CAC7C,GAAI,KAAK,WAAW,SAAW,KAAK,WAAW,GAAG,KAAK,EAAY,CACjE,OAAO,KAEX,IAAK,IAAM,KAAQ,KAAK,MACtB,EAAE,GAAQ,EAAE,KAAK,YAAY,IAE/B,OAAO,EAGT,KAAK,EAAa,CAChB,IAAI,EACJ,KAAQ,EAAI,KAAK,GAAG,KAAK,EAAI,EAI3B,GAHI,KAAK,GAAG,YAAc,EAAE,OAC1B,KAAK,GAAG,YACV,EAAI,KAAK,aAAa,EAAE,CACpB,GAAK,KACP,OAAO,EAIb,QAAQ,EAAa,CACnB,IAAM,EAAU,EAAE,CACd,EAEJ,IADA,KAAK,GAAG,UAAY,EACZ,EAAI,KAAK,KAAK,EAAI,EACxB,EAAQ,KAAK,EAAE,CAIjB,MAFA,MAAK,GAAG,UAAY,EAEb,EAGT,QAAQ,EAAa,EAA+C,CAClE,IAAM,EAAK,OAAO,GAAgB,WAAa,MAAoB,EACnE,OAAO,EAAI,QAAQ,KAAK,GAAK,GAEpB,EAAG,EAAE,CACZ"}
+{"version":3,"file":"xrx.mjs","names":[],"sources":["../../../src/common/data/xrx.ts"],"sourcesContent":["/* eslint-disable no-cond-assign */\n\nconst RX_WHITESPACE = /\\\\\\s|\\s+|#[^\\n]*\\n?/g\nconst RX_REAL_GROUPS = /\\(\\?P?<(\\w{2,})>|\\((?!\\?([:!=]|<=|<!))/g\n// eslint-disable-next-line regexp/no-unused-capturing-group\nconst RX_LOOK_BEHIND = /^((?:\\(\\?[\\w$]+\\))?)\\(\\?<([=!])([\\s\\S]*?)\\)/gm\n\nexport function regExpString(rx: string | RegExp): string {\n  return typeof rx === 'string' ? rx : (rx.source || '')\n}\n\nexport function regExpEscape(str: string): string {\n  return str.replace(/[-[\\]{}()*+?.,\\\\^$|#\\s]/g, '\\\\$&')\n}\n\nexport class XRX {\n  lookBehind:any\n  namedGroups: Record<string, number> = {}\n  names: string[] = []\n  rx: RegExp\n\n  constructor(pattern: string | RegExp, flags?: string) {\n    let _flags: string = flags ?? ''\n    let _rx: string\n\n    if (pattern instanceof RegExp) {\n      if (flags == null)\n        _flags = pattern.flags\n\n      _rx = pattern.source\n    }\n    else {\n      _rx = pattern\n    }\n\n    // eXtended / Ignore Whitespace\n    const extended = _flags && _flags.includes('x')\n    if (extended) {\n      _flags = _flags.replace('x', '')\n      _rx = _rx.replace(RX_WHITESPACE, (r) => {\n        // log('rp', r)\n        return r[0] === '\\\\' ? r : ''\n      })\n    }\n\n    // Named Groups\n    if (!(pattern instanceof RegExp)) {\n      let index = 0\n      _rx = _rx.replace(RX_REAL_GROUPS, (str, name) => {\n        // log('>>>', name)\n        index += 1\n        if (name) {\n          if (\n            name !== 'index'\n            && name !== 'length'\n            && !this.namedGroups[name]\n          ) {\n            this.namedGroups[name] = index\n          }\n          // else\n          //   log.error(`Unallowed or duplicate group name: ${name}`)\n\n          return '('\n        }\n        return str\n      })\n      this.names = Object.keys(this.namedGroups)\n    }\n\n    // http://www.rexegg.com/regex-best-trick.html\n\n    _rx = regExpString(_rx)\n    RX_LOOK_BEHIND.lastIndex = 0\n    const parts = RX_LOOK_BEHIND.exec(_rx)\n    if (parts) {\n      this.lookBehind = {\n        rx: new RegExp(`${parts[3]}$(?!\\\\s)`),\n        expect: parts ? parts[2] === '=' : !parts,\n      }\n      _rx = _rx.substr(parts[0].length)\n    }\n\n    this.rx = new RegExp(_rx, _flags)\n  }\n\n  // flagsString() {\n  //     let hash = this.rx.toString() + '/'\n  //     if (this.rx.global) {\n  //         hash += 'g'\n  //     }\n  //     if (this.rx.multiline) {\n  //         hash += 'm'\n  //     }\n  //     if (this.rx.ignoreCase) {\n  //         hash += 'i'\n  //     }\n  //     if (this.rx.unicode) {\n  //         hash += 'u'\n  //     }\n  //     if (this.rx.sticky) {\n  //         hash += 'y'\n  //     }\n  // }\n\n  get lastIndex(): number {\n    return this.rx.lastIndex\n  }\n\n  set lastIndex(index: number) {\n    this.rx.lastIndex = index\n  }\n\n  _handleMatch(m: any) {\n    if (this.lookBehind) {\n      const leftContext = m.input.slice(0, m.index)\n      if (this.lookBehind.expect !== this.lookBehind.rx.test(leftContext))\n        return null\n    }\n    for (const name of this.names)\n      m[name] = m[this.namedGroups[name]]\n\n    return m\n  }\n\n  exec(str: string) {\n    let m\n    while ((m = this.rx.exec(str))) {\n      if (this.rx.lastIndex === m.index)\n        this.rx.lastIndex++\n      m = this._handleMatch(m)\n      if (m != null)\n        return m\n    }\n  }\n\n  execAll(str: string) {\n    const matches = []\n    let m\n    this.rx.lastIndex = 0\n    while ((m = this.exec(str)))\n      matches.push(m)\n\n    this.rx.lastIndex = 0\n    // log('execAll:', matches)\n    return matches\n  }\n\n  replace(str: string, replacement: string | ((m: string) => string)) {\n    const fn = typeof replacement === 'function' ? replacement : () => replacement\n    return str.replace(this.rx, (m) => {\n      // m = this._handleMatch(m)\n      return fn(m)\n    })\n  }\n}\n"],"mappings":";AAEA,MAAM,gBAAgB;AACtB,MAAM,iBAAiB;AAEvB,MAAM,iBAAiB;AAEvB,SAAgB,aAAa,IAA6B;AACxD,QAAO,OAAO,OAAO,WAAW,KAAM,GAAG,UAAU;;AAGrD,SAAgB,aAAa,KAAqB;AAChD,QAAO,IAAI,QAAQ,4BAA4B,OAAO;;AAGxD,IAAa,MAAb,MAAiB;CACf;CACA,cAAsC,EAAE;CACxC,QAAkB,EAAE;CACpB;CAEA,YAAY,SAA0B,OAAgB;EACpD,IAAI,SAAiB,SAAS;EAC9B,IAAI;AAEJ,MAAI,mBAAmB,QAAQ;AAC7B,OAAI,SAAS,KACX,UAAS,QAAQ;AAEnB,SAAM,QAAQ;QAGd,OAAM;AAKR,MADiB,UAAU,OAAO,SAAS,IAAI,EACjC;AACZ,YAAS,OAAO,QAAQ,KAAK,GAAG;AAChC,SAAM,IAAI,QAAQ,gBAAgB,MAAM;AAEtC,WAAO,EAAE,OAAO,OAAO,IAAI;KAC3B;;AAIJ,MAAI,EAAE,mBAAmB,SAAS;GAChC,IAAI,QAAQ;AACZ,SAAM,IAAI,QAAQ,iBAAiB,KAAK,SAAS;AAE/C,aAAS;AACT,QAAI,MAAM;AACR,SACE,SAAS,WACN,SAAS,YACT,CAAC,KAAK,YAAY,MAErB,MAAK,YAAY,QAAQ;AAK3B,YAAO;;AAET,WAAO;KACP;AACF,QAAK,QAAQ,OAAO,KAAK,KAAK,YAAY;;AAK5C,QAAM,aAAa,IAAI;AACvB,iBAAe,YAAY;EAC3B,MAAM,QAAQ,eAAe,KAAK,IAAI;AACtC,MAAI,OAAO;AACT,QAAK,aAAa;IAChB,IAAI,IAAI,OAAO,GAAG,MAAM,GAAG,UAAU;IACrC,QAAQ,QAAQ,MAAM,OAAO,MAAM,CAAC;IACrC;AACD,SAAM,IAAI,OAAO,MAAM,GAAG,OAAO;;AAGnC,OAAK,KAAK,IAAI,OAAO,KAAK,OAAO;;CAsBnC,IAAI,YAAoB;AACtB,SAAO,KAAK,GAAG;;CAGjB,IAAI,UAAU,OAAe;AAC3B,OAAK,GAAG,YAAY;;CAGtB,aAAa,GAAQ;AACnB,MAAI,KAAK,YAAY;GACnB,MAAM,cAAc,EAAE,MAAM,MAAM,GAAG,EAAE,MAAM;AAC7C,OAAI,KAAK,WAAW,WAAW,KAAK,WAAW,GAAG,KAAK,YAAY,CACjE,QAAO;;AAEX,OAAK,MAAM,QAAQ,KAAK,MACtB,GAAE,QAAQ,EAAE,KAAK,YAAY;AAE/B,SAAO;;CAGT,KAAK,KAAa;EAChB,IAAI;AACJ,SAAQ,IAAI,KAAK,GAAG,KAAK,IAAI,EAAG;AAC9B,OAAI,KAAK,GAAG,cAAc,EAAE,MAC1B,MAAK,GAAG;AACV,OAAI,KAAK,aAAa,EAAE;AACxB,OAAI,KAAK,KACP,QAAO;;;CAIb,QAAQ,KAAa;EACnB,MAAM,UAAU,EAAE;EAClB,IAAI;AACJ,OAAK,GAAG,YAAY;AACpB,SAAQ,IAAI,KAAK,KAAK,IAAI,CACxB,SAAQ,KAAK,EAAE;AAEjB,OAAK,GAAG,YAAY;AAEpB,SAAO;;CAGT,QAAQ,KAAa,aAA+C;EAClE,MAAM,KAAK,OAAO,gBAAgB,aAAa,oBAAoB;AACnE,SAAO,IAAI,QAAQ,KAAK,KAAK,MAAM;AAEjC,UAAO,GAAG,EAAE;IACZ"}

package/dist/common/dispose-defer.cjs

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

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

@@ -1 +1 @@
-{"version":3,"file":"dispose-defer.cjs","names":["isPromise","isString","DefaultLogger"],"sources":["../../src/common/dispose-defer.ts"],"sourcesContent":["import type { DisposerFunction } from './dispose-types'\nimport type { LoggerInterface } from './log/log-base'\nimport { arrayFilterInPlace } from './data/array'\nimport { isString } from './data/is'\nimport { isPromise } from './exec/promise'\nimport { DefaultLogger } from './log/log'\n\nexport function polyfillUsing() {\n  try {\n    // @ts-expect-error just a polyfill\n    Symbol.dispose ??= Symbol('Symbol.dispose')\n    // @ts-expect-error just a polyfill\n    Symbol.asyncDispose ??= Symbol('Symbol.asyncDispose')\n  }\n  catch (_) { }\n}\n\n// Symbol.dispose ??= Symbol('Symbol.dispose')\n// Symbol.asyncDispose ??= Symbol('Symbol.asyncDispose')\n\n/** A disposable entry: either a function or an object with a dispose() method. */\ntype DisposableEntry = DisposerFunction | { dispose: DisposerFunction }\n\n/** Different kinds of implementations have grown, this should unify them  */\nfunction callDisposable(disposable: DisposableEntry): Promise<void> | void {\n  let result\n\n  if (typeof disposable === 'function')\n    result = disposable()\n  else if (typeof disposable.dispose === 'function')\n    result = disposable.dispose()\n\n  if (isPromise(result))\n    return result\n}\n\nexport interface UseDisposeConfig {\n  name?: string\n  log?: LoggerInterface\n}\n\nexport function useDispose(opt?: string | UseDisposeConfig | LoggerInterface) {\n  if (opt != null) {\n    if (isString(opt))\n      opt = { name: opt }\n    else if ('debug' in opt && 'label' in opt)\n      opt = { name: opt.label, log: opt }\n  }\n\n  polyfillUsing()\n\n  const name = opt?.name\n  const log = opt?.log ?? DefaultLogger('zeed:dispose')\n\n  let _disposed = 0\n\n  const tracked: DisposableEntry[] = []\n\n  function untrack(disposable: DisposableEntry): Promise<void> | void {\n    if (disposable != null && tracked.includes(disposable)) {\n      arrayFilterInPlace(tracked, el => el !== disposable)\n      const result = callDisposable(disposable)\n      if (isPromise(result))\n        return result\n    }\n  }\n\n  function track(obj?: DisposableEntry): DisposerFunction | undefined {\n    if (obj == null)\n      return\n    tracked.unshift(obj) // LIFO\n    return () => untrack(obj)\n  }\n\n  /** Dispose all tracked entries */\n  function dispose(strictSync = false): Promise<any> | void {\n    if (name)\n      log.debug(`dispose \"${name}\": ${tracked.length} entries`)\n\n    _disposed += 1\n\n    const promises: any[] = []\n    while (tracked.length > 0) {\n      const fn = tracked[0]\n      const result = untrack(fn) // LIFO\n      if (isPromise(result)) {\n        if (strictSync)\n          throw new Error(`Async disposable found: ${fn} -> ${result}`)\n        else\n          promises.push(result)\n      }\n    }\n\n    if (promises.length > 0)\n      return Promise.all(promises)\n  }\n\n  /** Dispose all tracked entries in synchronous way. */\n  function disposeSync(): void {\n    dispose(true)\n  }\n\n  return Object.assign(dispose, {\n    /** Counter that increments each time dispose has been called */\n    get disposed() {\n      return _disposed\n    },\n\n    add: track,\n    remove: untrack,\n\n    /** @deprecated use add */\n    track,\n\n    /** @deprecated use remove */\n    untrack,\n\n    dispose,\n    disposeSync,\n    sync: disposeSync,\n\n    /** @deprecated use dispose */\n    exec: dispose,\n    getSize() {\n      return tracked.length\n    },\n    isDisposed() {\n      return _disposed > 0 && tracked.length === 0\n    },\n\n    [Symbol.dispose]() {\n      return dispose()\n    },\n\n    async [Symbol.asyncDispose]() {\n      return await dispose()\n    },\n\n  })\n}\n\nexport type UseDispose = ReturnType<typeof useDispose>\n\nexport function useDefer(\n  config: {\n    mode?: 'lifo' | 'fifo'\n  } = {},\n) {\n  const { mode = 'fifo' } = config\n  const steps: DisposableEntry[] = []\n\n  polyfillUsing()\n\n  /**\n   * Executes all steps. If all steps are not Promises, they are executed immediately,\n   * otherwise a Promise is returned.\n   * Note: useDefer defaults to FIFO order; use mode: 'lifo' for LIFO (stack) order.\n   */\n  const exec = async (expectSync = false) => {\n    while (steps.length > 0) {\n      const step = steps[0]\n      arrayFilterInPlace(steps, el => el !== step)\n      if (typeof step === 'function') {\n        const result = step()\n        if (isPromise(result)) {\n          if (expectSync) {\n            throw new Error(\n              `Expected sync only function, but found async: ${step}`,\n            )\n          }\n          await result\n        }\n      }\n      else if (typeof step.dispose === 'function') {\n        // Handle objects with a dispose() method (consistent with useDispose)\n        const result = step.dispose()\n        if (isPromise(result)) {\n          if (expectSync) {\n            throw new Error(\n              `Expected sync only function, but found async: ${step}`,\n            )\n          }\n          await result\n        }\n      }\n      else {\n        throw new TypeError(`Unhandled disposable: ${step}`)\n      }\n    }\n  }\n\n  const add = (obj: DisposableEntry) => {\n    if (mode === 'lifo')\n      steps.unshift(obj)\n    else\n      steps.push(obj)\n  }\n\n  return Object.assign(exec, {\n    add,\n    exec,\n    getSize() {\n      return steps.length\n    },\n  })\n}\n\nexport type UseDefer = ReturnType<typeof useDefer>\n"],"mappings":"6LAOA,SAAgB,GAAgB,CAC9B,GAAI,CAEF,OAAO,UAAY,OAAO,iBAAiB,CAE3C,OAAO,eAAiB,OAAO,sBAAsB,MAE7C,GAUZ,SAAS,EAAe,EAAmD,CACzE,IAAI,EAOJ,GALI,OAAO,GAAe,WACxB,EAAS,GAAY,CACd,OAAO,EAAW,SAAY,aACrC,EAAS,EAAW,SAAS,EAE3BA,EAAAA,UAAU,EAAO,CACnB,OAAO,EAQX,SAAgB,EAAW,EAAmD,CACxE,GAAO,OACLC,EAAAA,SAAS,EAAI,CACf,EAAM,CAAE,KAAM,EAAK,CACZ,UAAW,GAAO,UAAW,IACpC,EAAM,CAAE,KAAM,EAAI,MAAO,IAAK,EAAK,GAGvC,GAAe,CAEf,IAAM,EAAO,GAAK,KACZ,EAAM,GAAK,KAAOC,EAAAA,cAAc,eAAe,CAEjD,EAAY,EAEV,EAA6B,EAAE,CAErC,SAAS,EAAQ,EAAmD,CAClE,GAAI,GAAc,MAAQ,EAAQ,SAAS,EAAW,CAAE,CACtD,EAAA,mBAAmB,EAAS,GAAM,IAAO,EAAW,CACpD,IAAM,EAAS,EAAe,EAAW,CACzC,GAAIF,EAAAA,UAAU,EAAO,CACnB,OAAO,GAIb,SAAS,EAAM,EAAqD,CAC9D,MAAO,KAGX,OADA,EAAQ,QAAQ,EAAI,KACP,EAAQ,EAAI,CAI3B,SAAS,EAAQ,EAAa,GAA4B,CACpD,GACF,EAAI,MAAM,YAAY,EAAK,KAAK,EAAQ,OAAO,UAAU,CAE3D,GAAa,EAEb,IAAM,EAAkB,EAAE,CAC1B,KAAO,EAAQ,OAAS,GAAG,CACzB,IAAM,EAAK,EAAQ,GACb,EAAS,EAAQ,EAAG,CAC1B,GAAIA,EAAAA,UAAU,EAAO,CACnB,IAAI,EACF,MAAU,MAAM,2BAA2B,EAAG,MAAM,IAAS,CAE7D,EAAS,KAAK,EAAO,EAI3B,GAAI,EAAS,OAAS,EACpB,OAAO,QAAQ,IAAI,EAAS,CAIhC,SAAS,GAAoB,CAC3B,EAAQ,GAAK,CAGf,OAAO,OAAO,OAAO,EAAS,CAE5B,IAAI,UAAW,CACb,OAAO,GAGT,IAAK,EACL,OAAQ,EAGR,QAGA,UAEA,UACA,cACA,KAAM,EAGN,KAAM,EACN,SAAU,CACR,OAAO,EAAQ,QAEjB,YAAa,CACX,OAAO,EAAY,GAAK,EAAQ,SAAW,GAG7C,CAAC,OAAO,UAAW,CACjB,OAAO,GAAS,EAGlB,MAAO,OAAO,eAAgB,CAC5B,OAAO,MAAM,GAAS,EAGzB,CAAC,CAKJ,SAAgB,EACd,EAEI,EAAE,CACN,CACA,GAAM,CAAE,OAAO,QAAW,EACpB,EAA2B,EAAE,CAEnC,GAAe,CAOf,IAAM,EAAO,MAAO,EAAa,KAAU,CACzC,KAAO,EAAM,OAAS,GAAG,CACvB,IAAM,EAAO,EAAM,GAEnB,GADA,EAAA,mBAAmB,EAAO,GAAM,IAAO,EAAK,CACxC,OAAO,GAAS,WAAY,CAC9B,IAAM,EAAS,GAAM,CACrB,GAAIA,EAAAA,UAAU,EAAO,CAAE,CACrB,GAAI,EACF,MAAU,MACR,iDAAiD,IAClD,CAEH,MAAM,WAGD,OAAO,EAAK,SAAY,WAAY,CAE3C,IAAM,EAAS,EAAK,SAAS,CAC7B,GAAIA,EAAAA,UAAU,EAAO,CAAE,CACrB,GAAI,EACF,MAAU,MACR,iDAAiD,IAClD,CAEH,MAAM,QAIR,MAAU,UAAU,yBAAyB,IAAO,GAY1D,OAAO,OAAO,OAAO,EAAM,CACzB,IARW,GAAyB,CAChC,IAAS,OACX,EAAM,QAAQ,EAAI,CAElB,EAAM,KAAK,EAAI,EAKjB,OACA,SAAU,CACR,OAAO,EAAM,QAEhB,CAAC"}
+{"version":3,"file":"dispose-defer.cjs","names":["isPromise","isString","DefaultLogger"],"sources":["../../src/common/dispose-defer.ts"],"sourcesContent":["import type { DisposerFunction } from './dispose-types'\nimport type { LoggerInterface } from './log/log-base'\nimport { arrayFilterInPlace } from './data/array'\nimport { isString } from './data/is'\nimport { isPromise } from './exec/promise'\nimport { DefaultLogger } from './log/log'\n\nexport function polyfillUsing() {\n  try {\n    // @ts-expect-error just a polyfill\n    Symbol.dispose ??= Symbol('Symbol.dispose')\n    // @ts-expect-error just a polyfill\n    Symbol.asyncDispose ??= Symbol('Symbol.asyncDispose')\n  }\n  catch (_) { }\n}\n\n// Symbol.dispose ??= Symbol('Symbol.dispose')\n// Symbol.asyncDispose ??= Symbol('Symbol.asyncDispose')\n\n/** A disposable entry: either a function or an object with a dispose() method. */\ntype DisposableEntry = DisposerFunction | { dispose: DisposerFunction }\n\n/** Different kinds of implementations have grown, this should unify them  */\nfunction callDisposable(disposable: DisposableEntry): Promise<void> | void {\n  let result\n\n  if (typeof disposable === 'function')\n    result = disposable()\n  else if (typeof disposable.dispose === 'function')\n    result = disposable.dispose()\n\n  if (isPromise(result))\n    return result\n}\n\nexport interface UseDisposeConfig {\n  name?: string\n  log?: LoggerInterface\n}\n\nexport function useDispose(opt?: string | UseDisposeConfig | LoggerInterface) {\n  if (opt != null) {\n    if (isString(opt))\n      opt = { name: opt }\n    else if ('debug' in opt && 'label' in opt)\n      opt = { name: opt.label, log: opt }\n  }\n\n  polyfillUsing()\n\n  const name = opt?.name\n  const log = opt?.log ?? DefaultLogger('zeed:dispose')\n\n  let _disposed = 0\n\n  const tracked: DisposableEntry[] = []\n\n  function untrack(disposable: DisposableEntry): Promise<void> | void {\n    if (disposable != null && tracked.includes(disposable)) {\n      arrayFilterInPlace(tracked, el => el !== disposable)\n      const result = callDisposable(disposable)\n      if (isPromise(result))\n        return result\n    }\n  }\n\n  function track(obj?: DisposableEntry): DisposerFunction | undefined {\n    if (obj == null)\n      return\n    tracked.unshift(obj) // LIFO\n    return () => untrack(obj)\n  }\n\n  /** Dispose all tracked entries */\n  function dispose(strictSync = false): Promise<any> | void {\n    if (name)\n      log.debug(`dispose \"${name}\": ${tracked.length} entries`)\n\n    _disposed += 1\n\n    const promises: any[] = []\n    while (tracked.length > 0) {\n      const fn = tracked[0]\n      const result = untrack(fn) // LIFO\n      if (isPromise(result)) {\n        if (strictSync)\n          throw new Error(`Async disposable found: ${fn} -> ${result}`)\n        else\n          promises.push(result)\n      }\n    }\n\n    if (promises.length > 0)\n      return Promise.all(promises)\n  }\n\n  /** Dispose all tracked entries in synchronous way. */\n  function disposeSync(): void {\n    dispose(true)\n  }\n\n  return Object.assign(dispose, {\n    /** Counter that increments each time dispose has been called */\n    get disposed() {\n      return _disposed\n    },\n\n    add: track,\n    remove: untrack,\n\n    /** @deprecated use add */\n    track,\n\n    /** @deprecated use remove */\n    untrack,\n\n    dispose,\n    disposeSync,\n    sync: disposeSync,\n\n    /** @deprecated use dispose */\n    exec: dispose,\n    getSize() {\n      return tracked.length\n    },\n    isDisposed() {\n      return _disposed > 0 && tracked.length === 0\n    },\n\n    [Symbol.dispose]() {\n      return dispose()\n    },\n\n    async [Symbol.asyncDispose]() {\n      return await dispose()\n    },\n\n  })\n}\n\nexport type UseDispose = ReturnType<typeof useDispose>\n\nexport function useDefer(\n  config: {\n    mode?: 'lifo' | 'fifo'\n  } = {},\n) {\n  const { mode = 'fifo' } = config\n  const steps: DisposableEntry[] = []\n\n  polyfillUsing()\n\n  /**\n   * Executes all steps. If all steps are not Promises, they are executed immediately,\n   * otherwise a Promise is returned.\n   * Note: useDefer defaults to FIFO order; use mode: 'lifo' for LIFO (stack) order.\n   */\n  const exec = async (expectSync = false) => {\n    while (steps.length > 0) {\n      const step = steps[0]\n      arrayFilterInPlace(steps, el => el !== step)\n      if (typeof step === 'function') {\n        const result = step()\n        if (isPromise(result)) {\n          if (expectSync) {\n            throw new Error(\n              `Expected sync only function, but found async: ${step}`,\n            )\n          }\n          await result\n        }\n      }\n      else if (typeof step.dispose === 'function') {\n        // Handle objects with a dispose() method (consistent with useDispose)\n        const result = step.dispose()\n        if (isPromise(result)) {\n          if (expectSync) {\n            throw new Error(\n              `Expected sync only function, but found async: ${step}`,\n            )\n          }\n          await result\n        }\n      }\n      else {\n        throw new TypeError(`Unhandled disposable: ${step}`)\n      }\n    }\n  }\n\n  const add = (obj: DisposableEntry) => {\n    if (mode === 'lifo')\n      steps.unshift(obj)\n    else\n      steps.push(obj)\n  }\n\n  return Object.assign(exec, {\n    add,\n    exec,\n    getSize() {\n      return steps.length\n    },\n  })\n}\n\nexport type UseDefer = ReturnType<typeof useDefer>\n"],"mappings":";;;;;;;AAOA,SAAgB,gBAAgB;AAC9B,KAAI;AAEF,SAAO,YAAY,OAAO,iBAAiB;AAE3C,SAAO,iBAAiB,OAAO,sBAAsB;UAEhD,GAAG;;;AAUZ,SAAS,eAAe,YAAmD;CACzE,IAAI;AAEJ,KAAI,OAAO,eAAe,WACxB,UAAS,YAAY;UACd,OAAO,WAAW,YAAY,WACrC,UAAS,WAAW,SAAS;AAE/B,KAAIA,sCAAU,OAAO,CACnB,QAAO;;AAQX,SAAgB,WAAW,KAAmD;AAC5E,KAAI,OAAO,MACT;MAAIC,gCAAS,IAAI,CACf,OAAM,EAAE,MAAM,KAAK;WACZ,WAAW,OAAO,WAAW,IACpC,OAAM;GAAE,MAAM,IAAI;GAAO,KAAK;GAAK;;AAGvC,gBAAe;CAEf,MAAM,OAAO,KAAK;CAClB,MAAM,MAAM,KAAK,OAAOC,qCAAc,eAAe;CAErD,IAAI,YAAY;CAEhB,MAAM,UAA6B,EAAE;CAErC,SAAS,QAAQ,YAAmD;AAClE,MAAI,cAAc,QAAQ,QAAQ,SAAS,WAAW,EAAE;AACtD,gDAAmB,UAAS,OAAM,OAAO,WAAW;GACpD,MAAM,SAAS,eAAe,WAAW;AACzC,OAAIF,sCAAU,OAAO,CACnB,QAAO;;;CAIb,SAAS,MAAM,KAAqD;AAClE,MAAI,OAAO,KACT;AACF,UAAQ,QAAQ,IAAI;AACpB,eAAa,QAAQ,IAAI;;;CAI3B,SAAS,QAAQ,aAAa,OAA4B;AACxD,MAAI,KACF,KAAI,MAAM,YAAY,KAAK,KAAK,QAAQ,OAAO,UAAU;AAE3D,eAAa;EAEb,MAAM,WAAkB,EAAE;AAC1B,SAAO,QAAQ,SAAS,GAAG;GACzB,MAAM,KAAK,QAAQ;GACnB,MAAM,SAAS,QAAQ,GAAG;AAC1B,OAAIA,sCAAU,OAAO,CACnB,KAAI,WACF,OAAM,IAAI,MAAM,2BAA2B,GAAG,MAAM,SAAS;OAE7D,UAAS,KAAK,OAAO;;AAI3B,MAAI,SAAS,SAAS,EACpB,QAAO,QAAQ,IAAI,SAAS;;;CAIhC,SAAS,cAAoB;AAC3B,UAAQ,KAAK;;AAGf,QAAO,OAAO,OAAO,SAAS;EAE5B,IAAI,WAAW;AACb,UAAO;;EAGT,KAAK;EACL,QAAQ;EAGR;EAGA;EAEA;EACA;EACA,MAAM;EAGN,MAAM;EACN,UAAU;AACR,UAAO,QAAQ;;EAEjB,aAAa;AACX,UAAO,YAAY,KAAK,QAAQ,WAAW;;EAG7C,CAAC,OAAO,WAAW;AACjB,UAAO,SAAS;;EAGlB,OAAO,OAAO,gBAAgB;AAC5B,UAAO,MAAM,SAAS;;EAGzB,CAAC;;AAKJ,SAAgB,SACd,SAEI,EAAE,EACN;CACA,MAAM,EAAE,OAAO,WAAW;CAC1B,MAAM,QAA2B,EAAE;AAEnC,gBAAe;;;;;;CAOf,MAAM,OAAO,OAAO,aAAa,UAAU;AACzC,SAAO,MAAM,SAAS,GAAG;GACvB,MAAM,OAAO,MAAM;AACnB,gDAAmB,QAAO,OAAM,OAAO,KAAK;AAC5C,OAAI,OAAO,SAAS,YAAY;IAC9B,MAAM,SAAS,MAAM;AACrB,QAAIA,sCAAU,OAAO,EAAE;AACrB,SAAI,WACF,OAAM,IAAI,MACR,iDAAiD,OAClD;AAEH,WAAM;;cAGD,OAAO,KAAK,YAAY,YAAY;IAE3C,MAAM,SAAS,KAAK,SAAS;AAC7B,QAAIA,sCAAU,OAAO,EAAE;AACrB,SAAI,WACF,OAAM,IAAI,MACR,iDAAiD,OAClD;AAEH,WAAM;;SAIR,OAAM,IAAI,UAAU,yBAAyB,OAAO;;;CAK1D,MAAM,OAAO,QAAyB;AACpC,MAAI,SAAS,OACX,OAAM,QAAQ,IAAI;MAElB,OAAM,KAAK,IAAI;;AAGnB,QAAO,OAAO,OAAO,MAAM;EACzB;EACA;EACA,UAAU;AACR,UAAO,MAAM;;EAEhB,CAAC"}

package/dist/common/dispose-defer.mjs

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

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

@@ -1 +1 @@
-{"version":3,"file":"dispose-defer.mjs","names":[],"sources":["../../src/common/dispose-defer.ts"],"sourcesContent":["import type { DisposerFunction } from './dispose-types'\nimport type { LoggerInterface } from './log/log-base'\nimport { arrayFilterInPlace } from './data/array'\nimport { isString } from './data/is'\nimport { isPromise } from './exec/promise'\nimport { DefaultLogger } from './log/log'\n\nexport function polyfillUsing() {\n  try {\n    // @ts-expect-error just a polyfill\n    Symbol.dispose ??= Symbol('Symbol.dispose')\n    // @ts-expect-error just a polyfill\n    Symbol.asyncDispose ??= Symbol('Symbol.asyncDispose')\n  }\n  catch (_) { }\n}\n\n// Symbol.dispose ??= Symbol('Symbol.dispose')\n// Symbol.asyncDispose ??= Symbol('Symbol.asyncDispose')\n\n/** A disposable entry: either a function or an object with a dispose() method. */\ntype DisposableEntry = DisposerFunction | { dispose: DisposerFunction }\n\n/** Different kinds of implementations have grown, this should unify them  */\nfunction callDisposable(disposable: DisposableEntry): Promise<void> | void {\n  let result\n\n  if (typeof disposable === 'function')\n    result = disposable()\n  else if (typeof disposable.dispose === 'function')\n    result = disposable.dispose()\n\n  if (isPromise(result))\n    return result\n}\n\nexport interface UseDisposeConfig {\n  name?: string\n  log?: LoggerInterface\n}\n\nexport function useDispose(opt?: string | UseDisposeConfig | LoggerInterface) {\n  if (opt != null) {\n    if (isString(opt))\n      opt = { name: opt }\n    else if ('debug' in opt && 'label' in opt)\n      opt = { name: opt.label, log: opt }\n  }\n\n  polyfillUsing()\n\n  const name = opt?.name\n  const log = opt?.log ?? DefaultLogger('zeed:dispose')\n\n  let _disposed = 0\n\n  const tracked: DisposableEntry[] = []\n\n  function untrack(disposable: DisposableEntry): Promise<void> | void {\n    if (disposable != null && tracked.includes(disposable)) {\n      arrayFilterInPlace(tracked, el => el !== disposable)\n      const result = callDisposable(disposable)\n      if (isPromise(result))\n        return result\n    }\n  }\n\n  function track(obj?: DisposableEntry): DisposerFunction | undefined {\n    if (obj == null)\n      return\n    tracked.unshift(obj) // LIFO\n    return () => untrack(obj)\n  }\n\n  /** Dispose all tracked entries */\n  function dispose(strictSync = false): Promise<any> | void {\n    if (name)\n      log.debug(`dispose \"${name}\": ${tracked.length} entries`)\n\n    _disposed += 1\n\n    const promises: any[] = []\n    while (tracked.length > 0) {\n      const fn = tracked[0]\n      const result = untrack(fn) // LIFO\n      if (isPromise(result)) {\n        if (strictSync)\n          throw new Error(`Async disposable found: ${fn} -> ${result}`)\n        else\n          promises.push(result)\n      }\n    }\n\n    if (promises.length > 0)\n      return Promise.all(promises)\n  }\n\n  /** Dispose all tracked entries in synchronous way. */\n  function disposeSync(): void {\n    dispose(true)\n  }\n\n  return Object.assign(dispose, {\n    /** Counter that increments each time dispose has been called */\n    get disposed() {\n      return _disposed\n    },\n\n    add: track,\n    remove: untrack,\n\n    /** @deprecated use add */\n    track,\n\n    /** @deprecated use remove */\n    untrack,\n\n    dispose,\n    disposeSync,\n    sync: disposeSync,\n\n    /** @deprecated use dispose */\n    exec: dispose,\n    getSize() {\n      return tracked.length\n    },\n    isDisposed() {\n      return _disposed > 0 && tracked.length === 0\n    },\n\n    [Symbol.dispose]() {\n      return dispose()\n    },\n\n    async [Symbol.asyncDispose]() {\n      return await dispose()\n    },\n\n  })\n}\n\nexport type UseDispose = ReturnType<typeof useDispose>\n\nexport function useDefer(\n  config: {\n    mode?: 'lifo' | 'fifo'\n  } = {},\n) {\n  const { mode = 'fifo' } = config\n  const steps: DisposableEntry[] = []\n\n  polyfillUsing()\n\n  /**\n   * Executes all steps. If all steps are not Promises, they are executed immediately,\n   * otherwise a Promise is returned.\n   * Note: useDefer defaults to FIFO order; use mode: 'lifo' for LIFO (stack) order.\n   */\n  const exec = async (expectSync = false) => {\n    while (steps.length > 0) {\n      const step = steps[0]\n      arrayFilterInPlace(steps, el => el !== step)\n      if (typeof step === 'function') {\n        const result = step()\n        if (isPromise(result)) {\n          if (expectSync) {\n            throw new Error(\n              `Expected sync only function, but found async: ${step}`,\n            )\n          }\n          await result\n        }\n      }\n      else if (typeof step.dispose === 'function') {\n        // Handle objects with a dispose() method (consistent with useDispose)\n        const result = step.dispose()\n        if (isPromise(result)) {\n          if (expectSync) {\n            throw new Error(\n              `Expected sync only function, but found async: ${step}`,\n            )\n          }\n          await result\n        }\n      }\n      else {\n        throw new TypeError(`Unhandled disposable: ${step}`)\n      }\n    }\n  }\n\n  const add = (obj: DisposableEntry) => {\n    if (mode === 'lifo')\n      steps.unshift(obj)\n    else\n      steps.push(obj)\n  }\n\n  return Object.assign(exec, {\n    add,\n    exec,\n    getSize() {\n      return steps.length\n    },\n  })\n}\n\nexport type UseDefer = ReturnType<typeof useDefer>\n"],"mappings":"4LAOA,SAAgB,GAAgB,CAC9B,GAAI,CAEF,OAAO,UAAY,OAAO,iBAAiB,CAE3C,OAAO,eAAiB,OAAO,sBAAsB,MAE7C,GAUZ,SAAS,EAAe,EAAmD,CACzE,IAAI,EAOJ,GALI,OAAO,GAAe,WACxB,EAAS,GAAY,CACd,OAAO,EAAW,SAAY,aACrC,EAAS,EAAW,SAAS,EAE3B,EAAU,EAAO,CACnB,OAAO,EAQX,SAAgB,EAAW,EAAmD,CACxE,GAAO,OACL,EAAS,EAAI,CACf,EAAM,CAAE,KAAM,EAAK,CACZ,UAAW,GAAO,UAAW,IACpC,EAAM,CAAE,KAAM,EAAI,MAAO,IAAK,EAAK,GAGvC,GAAe,CAEf,IAAM,EAAO,GAAK,KACZ,EAAM,GAAK,KAAO,EAAc,eAAe,CAEjD,EAAY,EAEV,EAA6B,EAAE,CAErC,SAAS,EAAQ,EAAmD,CAClE,GAAI,GAAc,MAAQ,EAAQ,SAAS,EAAW,CAAE,CACtD,EAAmB,EAAS,GAAM,IAAO,EAAW,CACpD,IAAM,EAAS,EAAe,EAAW,CACzC,GAAI,EAAU,EAAO,CACnB,OAAO,GAIb,SAAS,EAAM,EAAqD,CAC9D,MAAO,KAGX,OADA,EAAQ,QAAQ,EAAI,KACP,EAAQ,EAAI,CAI3B,SAAS,EAAQ,EAAa,GAA4B,CACpD,GACF,EAAI,MAAM,YAAY,EAAK,KAAK,EAAQ,OAAO,UAAU,CAE3D,GAAa,EAEb,IAAM,EAAkB,EAAE,CAC1B,KAAO,EAAQ,OAAS,GAAG,CACzB,IAAM,EAAK,EAAQ,GACb,EAAS,EAAQ,EAAG,CAC1B,GAAI,EAAU,EAAO,CACnB,IAAI,EACF,MAAU,MAAM,2BAA2B,EAAG,MAAM,IAAS,CAE7D,EAAS,KAAK,EAAO,EAI3B,GAAI,EAAS,OAAS,EACpB,OAAO,QAAQ,IAAI,EAAS,CAIhC,SAAS,GAAoB,CAC3B,EAAQ,GAAK,CAGf,OAAO,OAAO,OAAO,EAAS,CAE5B,IAAI,UAAW,CACb,OAAO,GAGT,IAAK,EACL,OAAQ,EAGR,QAGA,UAEA,UACA,cACA,KAAM,EAGN,KAAM,EACN,SAAU,CACR,OAAO,EAAQ,QAEjB,YAAa,CACX,OAAO,EAAY,GAAK,EAAQ,SAAW,GAG7C,CAAC,OAAO,UAAW,CACjB,OAAO,GAAS,EAGlB,MAAO,OAAO,eAAgB,CAC5B,OAAO,MAAM,GAAS,EAGzB,CAAC,CAKJ,SAAgB,EACd,EAEI,EAAE,CACN,CACA,GAAM,CAAE,OAAO,QAAW,EACpB,EAA2B,EAAE,CAEnC,GAAe,CAOf,IAAM,EAAO,MAAO,EAAa,KAAU,CACzC,KAAO,EAAM,OAAS,GAAG,CACvB,IAAM,EAAO,EAAM,GAEnB,GADA,EAAmB,EAAO,GAAM,IAAO,EAAK,CACxC,OAAO,GAAS,WAAY,CAC9B,IAAM,EAAS,GAAM,CACrB,GAAI,EAAU,EAAO,CAAE,CACrB,GAAI,EACF,MAAU,MACR,iDAAiD,IAClD,CAEH,MAAM,WAGD,OAAO,EAAK,SAAY,WAAY,CAE3C,IAAM,EAAS,EAAK,SAAS,CAC7B,GAAI,EAAU,EAAO,CAAE,CACrB,GAAI,EACF,MAAU,MACR,iDAAiD,IAClD,CAEH,MAAM,QAIR,MAAU,UAAU,yBAAyB,IAAO,GAY1D,OAAO,OAAO,OAAO,EAAM,CACzB,IARW,GAAyB,CAChC,IAAS,OACX,EAAM,QAAQ,EAAI,CAElB,EAAM,KAAK,EAAI,EAKjB,OACA,SAAU,CACR,OAAO,EAAM,QAEhB,CAAC"}
+{"version":3,"file":"dispose-defer.mjs","names":[],"sources":["../../src/common/dispose-defer.ts"],"sourcesContent":["import type { DisposerFunction } from './dispose-types'\nimport type { LoggerInterface } from './log/log-base'\nimport { arrayFilterInPlace } from './data/array'\nimport { isString } from './data/is'\nimport { isPromise } from './exec/promise'\nimport { DefaultLogger } from './log/log'\n\nexport function polyfillUsing() {\n  try {\n    // @ts-expect-error just a polyfill\n    Symbol.dispose ??= Symbol('Symbol.dispose')\n    // @ts-expect-error just a polyfill\n    Symbol.asyncDispose ??= Symbol('Symbol.asyncDispose')\n  }\n  catch (_) { }\n}\n\n// Symbol.dispose ??= Symbol('Symbol.dispose')\n// Symbol.asyncDispose ??= Symbol('Symbol.asyncDispose')\n\n/** A disposable entry: either a function or an object with a dispose() method. */\ntype DisposableEntry = DisposerFunction | { dispose: DisposerFunction }\n\n/** Different kinds of implementations have grown, this should unify them  */\nfunction callDisposable(disposable: DisposableEntry): Promise<void> | void {\n  let result\n\n  if (typeof disposable === 'function')\n    result = disposable()\n  else if (typeof disposable.dispose === 'function')\n    result = disposable.dispose()\n\n  if (isPromise(result))\n    return result\n}\n\nexport interface UseDisposeConfig {\n  name?: string\n  log?: LoggerInterface\n}\n\nexport function useDispose(opt?: string | UseDisposeConfig | LoggerInterface) {\n  if (opt != null) {\n    if (isString(opt))\n      opt = { name: opt }\n    else if ('debug' in opt && 'label' in opt)\n      opt = { name: opt.label, log: opt }\n  }\n\n  polyfillUsing()\n\n  const name = opt?.name\n  const log = opt?.log ?? DefaultLogger('zeed:dispose')\n\n  let _disposed = 0\n\n  const tracked: DisposableEntry[] = []\n\n  function untrack(disposable: DisposableEntry): Promise<void> | void {\n    if (disposable != null && tracked.includes(disposable)) {\n      arrayFilterInPlace(tracked, el => el !== disposable)\n      const result = callDisposable(disposable)\n      if (isPromise(result))\n        return result\n    }\n  }\n\n  function track(obj?: DisposableEntry): DisposerFunction | undefined {\n    if (obj == null)\n      return\n    tracked.unshift(obj) // LIFO\n    return () => untrack(obj)\n  }\n\n  /** Dispose all tracked entries */\n  function dispose(strictSync = false): Promise<any> | void {\n    if (name)\n      log.debug(`dispose \"${name}\": ${tracked.length} entries`)\n\n    _disposed += 1\n\n    const promises: any[] = []\n    while (tracked.length > 0) {\n      const fn = tracked[0]\n      const result = untrack(fn) // LIFO\n      if (isPromise(result)) {\n        if (strictSync)\n          throw new Error(`Async disposable found: ${fn} -> ${result}`)\n        else\n          promises.push(result)\n      }\n    }\n\n    if (promises.length > 0)\n      return Promise.all(promises)\n  }\n\n  /** Dispose all tracked entries in synchronous way. */\n  function disposeSync(): void {\n    dispose(true)\n  }\n\n  return Object.assign(dispose, {\n    /** Counter that increments each time dispose has been called */\n    get disposed() {\n      return _disposed\n    },\n\n    add: track,\n    remove: untrack,\n\n    /** @deprecated use add */\n    track,\n\n    /** @deprecated use remove */\n    untrack,\n\n    dispose,\n    disposeSync,\n    sync: disposeSync,\n\n    /** @deprecated use dispose */\n    exec: dispose,\n    getSize() {\n      return tracked.length\n    },\n    isDisposed() {\n      return _disposed > 0 && tracked.length === 0\n    },\n\n    [Symbol.dispose]() {\n      return dispose()\n    },\n\n    async [Symbol.asyncDispose]() {\n      return await dispose()\n    },\n\n  })\n}\n\nexport type UseDispose = ReturnType<typeof useDispose>\n\nexport function useDefer(\n  config: {\n    mode?: 'lifo' | 'fifo'\n  } = {},\n) {\n  const { mode = 'fifo' } = config\n  const steps: DisposableEntry[] = []\n\n  polyfillUsing()\n\n  /**\n   * Executes all steps. If all steps are not Promises, they are executed immediately,\n   * otherwise a Promise is returned.\n   * Note: useDefer defaults to FIFO order; use mode: 'lifo' for LIFO (stack) order.\n   */\n  const exec = async (expectSync = false) => {\n    while (steps.length > 0) {\n      const step = steps[0]\n      arrayFilterInPlace(steps, el => el !== step)\n      if (typeof step === 'function') {\n        const result = step()\n        if (isPromise(result)) {\n          if (expectSync) {\n            throw new Error(\n              `Expected sync only function, but found async: ${step}`,\n            )\n          }\n          await result\n        }\n      }\n      else if (typeof step.dispose === 'function') {\n        // Handle objects with a dispose() method (consistent with useDispose)\n        const result = step.dispose()\n        if (isPromise(result)) {\n          if (expectSync) {\n            throw new Error(\n              `Expected sync only function, but found async: ${step}`,\n            )\n          }\n          await result\n        }\n      }\n      else {\n        throw new TypeError(`Unhandled disposable: ${step}`)\n      }\n    }\n  }\n\n  const add = (obj: DisposableEntry) => {\n    if (mode === 'lifo')\n      steps.unshift(obj)\n    else\n      steps.push(obj)\n  }\n\n  return Object.assign(exec, {\n    add,\n    exec,\n    getSize() {\n      return steps.length\n    },\n  })\n}\n\nexport type UseDefer = ReturnType<typeof useDefer>\n"],"mappings":"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"}

package/dist/common/dispose-types.mjs

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