@idlebox/common 1.3.24 → 1.3.27

package/lib/esm/lifecycle/dispose/disposedError.mjs

@@ -1,12 +1,25 @@
-import { getErrorFrame } from "../../error/getFrame.mjs";
 import { tryInspect } from "../../debugging/tryInspect.mjs";
+import { getErrorFrame } from "../../error/getFrame.mjs";
+import { prettyFormatError } from "../../error/pretty.mjs";
 /**
  * Error when call dispose() twice
  */
 export class DisposedError extends Error {
+    previous;
+    inspectString;
     constructor(object, previous) {
-        super(`Object [${tryInspect(object)}] has already disposed at ${getErrorFrame(previous, 2)}.`);
+        const insp = tryInspect(object);
+        super(`Object [${insp}] has already disposed ${getErrorFrame(previous, 2)}.`);
+        this.previous = previous;
+        this.inspectString = insp;
         this.name = 'Warning';
+        this.tryCreateConsoleWarning().catch(() => { });
+    }
+    async tryCreateConsoleWarning() {
+        console.error('DisposedWarning: duplicate dispose.');
+        console.error(' * first   dispose:\n%s', prettyFormatError(this.previous, false));
+        console.error(' * current dispose:\n%s', prettyFormatError(this, false));
+        console.error(' * Object: %s', this.inspectString);
     }
 }
 export function isDisposedError(error) {

package/lib/esm/lifecycle/dispose/disposedError.mjs.map

@@ -6,5 +6,5 @@
         "../../../../src/lifecycle/dispose/disposedError.ts"
     ],
     "names": [],
-    "mappings": "AAAA,OAAO,EAAE,aAAa,EAAE,iCAA6B;AACrD,OAAO,EAAE,UAAU,EAAE,uCAAmC;AAExD;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACvC,YAAY,MAAW,EAAE,QAAe;QACvC,KAAK,CAAC,WAAW,UAAU,CAAC,MAAM,CAAC,6BAA6B,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/F,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IACvB,CAAC;CACD;AAED,MAAM,UAAU,eAAe,CAAC,KAAU;IACzC,OAAO,KAAK,YAAY,aAAa,CAAC;AACvC,CAAC"
+    "mappings": "AAAA,OAAO,EAAE,UAAU,EAAE,uCAAmC;AACxD,OAAO,EAAE,aAAa,EAAE,iCAA6B;AACrD,OAAO,EAAE,iBAAiB,EAAE,+BAA2B;AAEvD;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAItB;IAHD,aAAa,CAAS;IACtC,YACC,MAAW,EACK,QAAe;QAE/B,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAChC,KAAK,CAAC,WAAW,IAAI,0BAA0B,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;QAH9D,aAAQ,GAAR,QAAQ,CAAO;QAK/B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QAEtB,IAAI,CAAC,uBAAuB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IAEM,KAAK,CAAC,uBAAuB;QACnC,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACrD,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;QAClF,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACzE,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IACpD,CAAC;CACD;AAED,MAAM,UAAU,eAAe,CAAC,KAAU;IACzC,OAAO,KAAK,YAAY,aAAa,CAAC;AACvC,CAAC"
 }

package/lib/esm/lifecycle/dispose/lifecycle.async.mjs

@@ -23,14 +23,19 @@ export class AsyncDisposable {
             throw new DisposedError(this, this._disposed);
         }
     }
-    /**
-     * register a disposable object
-     */
-    _register(d) {
+    _register(d, deref) {
         this.assertNotDisposed();
         this._disposables.unshift(d);
+        if (deref) {
+            d.onBeforeDispose(() => {
+                this._unregister(d);
+            });
+        }
         return d;
     }
+    _unregister(d) {
+        return this._disposables.splice(this._disposables.indexOf(d), 1).length > 0;
+    }
     async dispose() {
         if (this._disposed) {
             console.warn(new DisposedError(this, this._disposed).message);

package/lib/esm/lifecycle/dispose/lifecycle.async.mjs.map

@@ -6,5 +6,5 @@
         "../../../../src/lifecycle/dispose/lifecycle.async.ts"
     ],
     "names": [],
-    "mappings": "AAAA,OAAO,EAAE,mBAAmB,EAAE,uCAAmC;AACjE,OAAO,EAAE,OAAO,EAAiB,2BAAuB;AACxD,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAGhD;;;GAGG;AACH,MAAM,OAAO,eAAe;IACV,YAAY,GAAuB,EAAE,CAAC;IAEpC,eAAe,GAAG,IAAI,OAAO,EAAS,CAAC;IAC1C,cAAc,GAAyB,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC;IAElE,gBAAgB,GAAG,IAAI,OAAO,EAAQ,CAAC;IAC1C,eAAe,GAAwB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC;IAE9E,SAAS,CAAS;IAE1B,IAAW,WAAW;QACrB,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IACzB,CAAC;IAED;;OAEG;IACI,iBAAiB;QACvB,IAAI,IAAI,CAAC,SAAS,EAAE;YACnB,MAAM,IAAI,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;SAC9C;IACF,CAAC;IAED;;OAEG;IACI,SAAS,CAA6B,CAAI;QAChD,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC7B,OAAO,CAAC,CAAC;IACV,CAAC;IAEM,KAAK,CAAC,OAAO;QACnB,IAAI,IAAI,CAAC,SAAS,EAAE;YACnB,OAAO,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC;YAC9D,OAAO;SACP;QACD,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;QAEvC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC9C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC7C,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,YAAY,EAAE;YACnC,IAAI;gBACH,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;aACnB;YAAC,OAAO,CAAC,EAAE;gBACX,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;aAClD;SACD;IACF,CAAC;CACD"
+    "mappings": "AAAA,OAAO,EAAE,mBAAmB,EAAE,uCAAmC;AACjE,OAAO,EAAE,OAAO,EAAiB,2BAAuB;AACxD,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAGhD;;;GAGG;AACH,MAAM,OAAO,eAAe;IACV,YAAY,GAAuB,EAAE,CAAC;IAEpC,eAAe,GAAG,IAAI,OAAO,EAAS,CAAC;IAC1C,cAAc,GAAyB,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC;IAElE,gBAAgB,GAAG,IAAI,OAAO,EAAQ,CAAC;IAC1C,eAAe,GAAwB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC;IAE9E,SAAS,CAAS;IAE1B,IAAW,WAAW;QACrB,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IACzB,CAAC;IAED;;OAEG;IACI,iBAAiB;QACvB,IAAI,IAAI,CAAC,SAAS,EAAE;YACnB,MAAM,IAAI,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;SAC9C;IACF,CAAC;IAOM,SAAS,CAAsE,CAAI,EAAE,KAAe;QAC1G,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,KAAK,EAAE;YACT,CAAuB,CAAC,eAAe,CAAC,GAAG,EAAE;gBAC7C,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YACrB,CAAC,CAAC,CAAC;SACH;QACD,OAAO,CAAC,CAAC;IACV,CAAC;IAEM,WAAW,CAAC,CAAmB;QACrC,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7E,CAAC;IAEM,KAAK,CAAC,OAAO;QACnB,IAAI,IAAI,CAAC,SAAS,EAAE;YACnB,OAAO,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC;YAC9D,OAAO;SACP;QACD,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;QAEvC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC9C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC7C,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,YAAY,EAAE;YACnC,IAAI;gBACH,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;aACnB;YAAC,OAAO,CAAC,EAAE;gBACX,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;aAClD;SACD;IACF,CAAC;CACD"
 }

package/lib/esm/lifecycle/dispose/lifecycle.sync.mjs

@@ -1,5 +1,5 @@
-import { DisposedError } from "./disposedError.mjs";
 import { Emitter } from "../event/event.mjs";
+import { DisposedError } from "./disposedError.mjs";
 export class DisposableOnce {
     _disposed;
     get hasDisposed() {
@@ -35,11 +35,19 @@ export class Disposable {
             throw new DisposedError(this, this._disposed);
         }
     }
-    _register(d) {
+    _register(d, autoDereference) {
         this.assertNotDisposed();
         this._disposables.unshift(d);
+        if (autoDereference) {
+            d.onBeforeDispose(() => {
+                this._unregister(d);
+            });
+        }
         return d;
     }
+    _unregister(d) {
+        return this._disposables.splice(this._disposables.indexOf(d), 1).length > 0;
+    }
     dispose() {
         if (this._disposed) {
             console.warn(new DisposedError(this, this._disposed).message);

package/lib/esm/lifecycle/dispose/lifecycle.sync.mjs.map

@@ -6,5 +6,5 @@
         "../../../../src/lifecycle/dispose/lifecycle.sync.ts"
     ],
     "names": [],
-    "mappings": "AAAA,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAChD,OAAO,EAAE,OAAO,EAAiB,2BAAuB;AAGxD,MAAM,OAAgB,cAAc;IAC3B,SAAS,CAAS;IAE1B,IAAW,WAAW;QACrB,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IACzB,CAAC;IACM,OAAO;QACb,IAAI,IAAI,CAAC,SAAS,EAAE;YACnB,OAAO,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC;YAC9D,OAAO;SACP;QACD,IAAI,CAAC,SAAS,GAAG,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;IACjB,CAAC;CAGD;AAED;;GAEG;AACH,MAAM,OAAO,UAAU;IACL,YAAY,GAAkB,EAAE,CAAC;IAE/B,eAAe,GAAG,IAAI,OAAO,EAAS,CAAC;IAC1C,cAAc,GAAyB,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC;IAElE,gBAAgB,GAAG,IAAI,OAAO,EAAQ,CAAC;IAC1C,eAAe,GAAwB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC;IAE9E,SAAS,CAAS;IAE1B,IAAW,WAAW;QACrB,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IACzB,CAAC;IAED;;OAEG;IACI,iBAAiB;QACvB,IAAI,IAAI,CAAC,SAAS,EAAE;YACnB,MAAM,IAAI,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;SAC9C;IACF,CAAC;IAEM,SAAS,CAAwB,CAAI;QAC3C,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC7B,OAAO,CAAC,CAAC;IACV,CAAC;IAEM,OAAO;QACb,IAAI,IAAI,CAAC,SAAS,EAAE;YACnB,OAAO,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC;YAC9D,OAAO;SACP;QACD,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;QAEvC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC9C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC7C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE;YAC9C,IAAI;gBACH,IAAI,CAAC,OAAO,EAAE,CAAC;aACf;YAAC,OAAO,CAAC,EAAE;gBACX,IAAI,CAAC,YAAY,KAAK,EAAE;oBACvB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;iBAC7B;qBAAM;oBACN,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,CAAC,CAAC,CAAC;oBACjD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;iBAC7C;aACD;SACD;IACF,CAAC;CACD"
+    "mappings": "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"
 }

package/lib/esm/path/normalizePath.mjs

@@ -1,12 +1,122 @@
+const schema = /^[a-z]{2,}:\/\//i;
+const unc = /^[\/\\]{1,2}\?[\/\\]UNC[\/\\]/i;
+const winSp = /^[\/\\]{1,2}\?[\/\\]([a-z]:[\/\\])/i;
+const winLetter = /^[a-z]:\//i;
+const doubleSlash = /^[\/\\]{2}[^\/\\]/i;
+export var PathKind;
+(function (PathKind) {
+    PathKind[PathKind["url"] = 0] = "url";
+    PathKind[PathKind["unc"] = 1] = "unc";
+    PathKind[PathKind["win"] = 2] = "win";
+    PathKind[PathKind["cifs"] = 3] = "cifs";
+    PathKind[PathKind["unix"] = 4] = "unix";
+    PathKind[PathKind["relative"] = 5] = "relative";
+})(PathKind || (PathKind = {}));
+export function analyzePath(p) {
+    const inp = p;
+    let r;
+    if (schema.test(p)) {
+        const u = new URL(p);
+        r = {
+            kind: PathKind.url,
+            prefix: u.protocol + '//' + u.host,
+            path: u.pathname.slice(1),
+            url: u,
+        };
+    }
+    else if (unc.test(p)) {
+        p = p.replace(unc, '').replace(/^[\/\\]+/, '');
+        const i = /[\///]/.exec(p)?.index ?? -1;
+        if (i <= 0)
+            throw new Error('invalid unc path: ' + inp);
+        r = {
+            kind: PathKind.unc,
+            prefix: '//?/UNC/' + p.slice(0, i),
+            path: p.slice(i + 1),
+        };
+    }
+    else if (winSp.test(p) || winLetter.test(p)) {
+        p = p.replace(winSp, '$1');
+        r = {
+            kind: PathKind.win,
+            prefix: p.slice(0, 2),
+            path: p.slice(4),
+        };
+    }
+    else if (doubleSlash.test(p)) {
+        p = p.replace(/^[\/\\]+/, '');
+        const i = /[\///]/.exec(p)?.index ?? -1;
+        if (i <= 0)
+            throw new Error('invalid cifs url: ' + inp);
+        r = {
+            kind: PathKind.cifs,
+            prefix: '//' + p.slice(0, i),
+            path: p.slice(i + 1),
+        };
+    }
+    else if (p.startsWith('/')) {
+        r = {
+            kind: PathKind.unix,
+            prefix: '',
+            path: p,
+        };
+    }
+    else {
+        const st = p.startsWith('..') ? '..' : '.';
+        r = {
+            kind: PathKind.relative,
+            prefix: st,
+            path: p,
+        };
+    }
+    const path = r.path.replace(/\\/g, '/');
+    const st = [];
+    for (const item of path.split('/')) {
+        if (!item || item === '.')
+            continue;
+        if (item === '..') {
+            st.pop();
+        }
+        else {
+            st.push(item);
+        }
+    }
+    r.path = st.join('/');
+    return r;
+}
 /**
  * replace // to /
  * replace \ to /
  * remove ending /
  */
 export function normalizePath(p) {
-    if (p.startsWith('file:')) {
-        throw new Error('normalizePath not support file url.');
+    const r = analyzePath(p);
+    if (r.prefix === undefined) {
+        return r.path;
     }
-    return p.replace(/\\+/g, '/').replace(/\/\/+/g, '/').replace(/\/+$/, '');
+    else {
+        return `${r.prefix}/${r.path}`;
+    }
+}
+export function relativePath(from, to) {
+    const r1 = analyzePath(from);
+    const r2 = analyzePath(to);
+    if (r1.kind !== r2.kind)
+        throw new Error(`cannot relative path between different kind: "${PathKind[r1.kind]}::${r1.prefix}" * "${PathKind[r2.kind]}::${r2.prefix}"`);
+    if (r1.prefix !== r2.prefix)
+        return to;
+    const p1arr = r1.path.split('/');
+    const p2arr = r2.path.split('/');
+    // find same prefix
+    let i = 0;
+    while (i < p1arr.length && i < p2arr.length && p1arr[i] === p2arr[i])
+        i++;
+    // remove same prefix
+    p1arr.splice(0, i);
+    p2arr.splice(0, i);
+    // add ..
+    const p1 = p1arr.length > 0 ? p1arr.map(() => '..').join('/') + '/' : '';
+    const p2 = p2arr.join('/');
+    return p1 + p2;
 }
 //# sourceMappingURL=normalizePath.mjs.map

package/lib/esm/path/normalizePath.mjs.map

@@ -6,5 +6,5 @@
         "../../../src/path/normalizePath.ts"
     ],
     "names": [],
-    "mappings": "AAAA;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS;IACtC,IAAI,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE;QAC1B,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;KACvD;IACD,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC1E,CAAC"
+    "mappings": "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"
 }

package/lib/esm/promise/{promisePool.mjs → promiseCollection.mjs}

@@ -1,6 +1,6 @@
 import { CanceledError } from "../lifecycle/promise/cancel.mjs";
 import { DeferredPromise } from "../lifecycle/promise/deferredPromise.mjs";
-export class PromisePool {
+export class PromiseCollection {
     promiseList = {};
     size() {
         return Object.keys(this.promiseList).length;
@@ -31,4 +31,4 @@ export class PromisePool {
         }
     }
 }
-//# sourceMappingURL=promisePool.mjs.map
+//# sourceMappingURL=promiseCollection.mjs.map

package/lib/esm/promise/promiseCollection.mjs.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "promiseCollection.mjs",
+    "sourceRoot": "",
+    "sources": [
+        "../../../src/promise/promiseCollection.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA,OAAO,EAAE,aAAa,EAAE,wCAAoC;AAC5D,OAAO,EAAE,eAAe,EAAE,iDAA6C;AAEvE,MAAM,OAAO,iBAAiB;IACV,WAAW,GAAyC,EAAE,CAAC;IAE1E,IAAI;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,EAAU;QAChB,IAAI,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE;YACzB,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC;SACnD;QACD,MAAM,GAAG,GAAG,IAAI,eAAe,EAAO,CAAC;QACvC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;QAC3B,OAAO,GAAG,CAAC,CAAC,CAAC;IACd,CAAC;IAED,GAAG,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,EAAU,EAAE,IAAS;QACzB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,EAAU,EAAE,CAAQ;QACzB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO;QACN,MAAM,CAAC,GAAG,IAAI,aAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE;YAC/C,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;SAClB;IACF,CAAC;CACD"
+}

package/lib/esm/promise/{timeoutPromisePool.mjs → timeoutPromiseCollection.mjs}

@@ -1,6 +1,6 @@
 import { TimeoutError } from "../lifecycle/timeout/timeoutError.mjs";
-import { PromisePool } from "./promisePool.mjs";
-export class TimeoutPromisePool extends PromisePool {
+import { PromiseCollection } from "./promiseCollection.mjs";
+export class TimeoutPromiseCollection extends PromiseCollection {
     defaultTimeoutMs;
     constructor(defaultTimeoutMs = 50000) {
         super();
@@ -17,4 +17,4 @@ export class TimeoutPromisePool extends PromisePool {
         return p;
     }
 }
-//# sourceMappingURL=timeoutPromisePool.mjs.map
+//# sourceMappingURL=timeoutPromiseCollection.mjs.map

package/lib/esm/promise/timeoutPromiseCollection.mjs.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "timeoutPromiseCollection.mjs",
+    "sourceRoot": "",
+    "sources": [
+        "../../../src/promise/timeoutPromiseCollection.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA,OAAO,EAAE,YAAY,EAAE,8CAA0C;AACjE,OAAO,EAAE,iBAAiB,EAAE,gCAA4B;AAExD,MAAM,OAAO,wBAAyB,SAAQ,iBAAiB;IACjC;IAA7B,YAA6B,mBAAmB,KAAK;QACpD,KAAK,EAAE,CAAC;QADoB,qBAAgB,GAAhB,gBAAgB,CAAQ;IAErD,CAAC;IAEQ,MAAM,CAAC,EAAU,EAAE,YAAoB,IAAI,CAAC,gBAAgB,EAAE,UAAmB;QACzF,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAE3B,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,YAAY,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;QACzD,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YACd,YAAY,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,CAAC;IACV,CAAC;CACD"
+}

package/lib/esm/state/StateMachine.mjs

@@ -0,0 +1,30 @@
+import { Emitter } from "../lifecycle/event/event.mjs";
+export class SimpleStateMachine {
+    rules;
+    _onStateChange = new Emitter();
+    onStateChange = this._onStateChange.register;
+    constructor(rules, init_state) {
+        this.rules = rules;
+        this.moveTo(init_state);
+    }
+    moveTo(state) {
+        if (!this.rules.has(state))
+            throw new Error(`missing state "${state}"`);
+        this.currentState = state;
+    }
+    getName() {
+        return this.currentState;
+    }
+    change(event) {
+        const state = this.rules.get(this.currentState);
+        const next = state.get(event);
+        if (typeof next === 'undefined') {
+            throw new Error(`no event "${event} (${typeof event})" on state "${this.currentState} (${typeof this
+                .currentState})" (has ${[...state.keys()].map((v) => `"${v} (${typeof v})"`).join(', ')})`);
+        }
+        const last = this.currentState;
+        this.moveTo(next);
+        this._onStateChange.fireNoError({ from: last, to: next, reason: event });
+    }
+}
+//# sourceMappingURL=StateMachine.mjs.map

package/lib/esm/state/StateMachine.mjs.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "StateMachine.mjs",
+    "sourceRoot": "",
+    "sources": [
+        "../../../src/state/StateMachine.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA,OAAO,EAAE,OAAO,EAAE,qCAAiC;AAenD,MAAM,OAAO,kBAAkB;IAEX,KAAK,CAAoC;IAE3C,cAAc,GAAG,IAAI,OAAO,EAA2C,CAAC;IACzE,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;IAE7D,YAAY,KAAwC,EAAE,UAAqB;QAC1E,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IAES,MAAM,CAAC,KAAgB;QAChC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,GAAG,CAAC,CAAC;QAExE,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,OAAO;QACN,OAAO,IAAI,CAAC,YAAY,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,KAAgB;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAE,CAAC;QACjD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,OAAO,IAAI,KAAK,WAAW,EAAE;YAChC,MAAM,IAAI,KAAK,CACd,aAAa,KAAK,KAAK,OAAO,KAAK,gBAAgB,IAAI,CAAC,YAAY,KAAK,OAAO,IAAI;iBAClF,YAAY,WAAW,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC3F,CAAC;SACF;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1E,CAAC;CACD"
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@idlebox/common",
   "type": "module",
-  "version": "1.3.24",
+  "version": "1.3.27",
   "license": "MIT",
   "main": "./lib/cjs/__create_index.generated.cjs",
   "module": "./lib/esm/__create_index.generated.mjs",
@@ -20,9 +20,9 @@
   "devDependencies": {
     "@rushstack/heft": "^0.57.1",
     "source-map-support": "^0.5.21",
-    "@build-script/single-dog-asset": "^1.0.27",
-    "@internal/dualstack-rig": "^1.0.1",
-    "@idlebox/itypes": "^1.0.5"
+    "@build-script/single-dog-asset": "^1.0.28",
+    "@idlebox/itypes": "^1.0.5",
+    "@internal/dualstack-rig": "^1.0.1"
   },
   "scripts": {
     "test": "heft test",

package/src/debugging/tryInspect.ts

@@ -31,7 +31,9 @@ export function tryInspect(object: any) {
 		return object[Symbol.toStringTag]();
 	} else if (object.toJSON) {
 		return object.toJSON();
+	} else if (object.constructor?.name) {
+		return `unknown: ${object.constructor.name}`;
 	} else {
-		return '' + object;
+		return 'unknown: ' + object;
 	}
 }

package/src/error/known.ts

@@ -0,0 +1,27 @@
+import { isNative } from '../platform/os';
+
+class KnownErrorNode extends Error {
+	constructor(message: string, consopt?: ErrorOptions) {
+		const limit = (Error as any).stackTraceLimit;
+		(Error as any).stackTraceLimit = 0;
+		super(message, consopt);
+		(Error as any).stackTraceLimit = limit;
+	}
+
+	static is(e: any): e is KnownErrorNode {
+		return e instanceof KnownErrorNode;
+	}
+}
+
+class KnownErrorCommon extends Error {
+	constructor(message: string, consopt?: ErrorOptions) {
+		super(message, consopt);
+		this.stack = message;
+	}
+
+	static is(e: any): e is KnownErrorCommon {
+		return e instanceof KnownErrorCommon;
+	}
+}
+
+export const KnownError = isNative ? KnownErrorNode : KnownErrorCommon;