@e280/stz 0.0.0-8 → 0.0.0

package/x/pubsub.js

@@ -1,4 +1,4 @@
-import { deferPromise } from "./defer-promise.js";
+import { defer } from "./defer.js";
 export function xub() {
     const set = new Set();
     function sub(fn) {
@@ -8,8 +8,8 @@ export function xub() {
     async function pub(...a) {
         await Promise.all([...set].map(fn => fn(...a)));
     }
-    async function once() {
-        const { promise, resolve } = deferPromise();
+    async function next() {
+        const { promise, resolve } = defer();
         const unsubscribe = sub((...a) => {
             resolve(a);
             unsubscribe();
@@ -21,11 +21,13 @@ export function xub() {
     }
     sub.pub = pub;
     sub.sub = sub;
-    sub.once = once;
+    sub.on = sub;
+    sub.next = next;
     sub.clear = clear;
     pub.pub = pub;
     pub.sub = sub;
-    pub.once = once;
+    pub.on = sub;
+    pub.next = next;
     pub.clear = clear;
     return [pub, sub];
 }

package/x/pubsub.js.map

@@ -1 +1 @@
-{"version":3,"file":"pubsub.js","sourceRoot":"","sources":["../s/pubsub.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAA;AAmB/C,MAAM,UAAU,GAAG;IAClB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAe,CAAA;IAElC,SAAS,GAAG,CAAC,EAAe;QAC3B,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACX,OAAO,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA,CAAC,CAAC,CAAA;IAChC,CAAC;IAED,KAAK,UAAU,GAAG,CAAC,GAAG,CAAI;QACzB,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAChD,CAAC;IAED,KAAK,UAAU,IAAI;QAClB,MAAM,EAAC,OAAO,EAAE,OAAO,EAAC,GAAG,YAAY,EAAK,CAAA;QAC5C,MAAM,WAAW,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE;YAChC,OAAO,CAAC,CAAC,CAAC,CAAA;YACV,WAAW,EAAE,CAAA;QACd,CAAC,CAAC,CAAA;QACF,OAAO,OAAO,CAAA;IACf,CAAC;IAED,SAAS,KAAK;QACb,GAAG,CAAC,KAAK,EAAE,CAAA;IACZ,CAAC;IAED,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACb,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACb,GAAG,CAAC,IAAI,GAAG,IAAI,CAAA;IACf,GAAG,CAAC,KAAK,GAAG,KAAK,CAAA;IAEjB,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACb,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACb,GAAG,CAAC,IAAI,GAAG,IAAI,CAAA;IACf,GAAG,CAAC,KAAK,GAAG,KAAK,CAAA;IAEjB,OAAO,CAAC,GAAG,EAAE,GAAG,CAAqB,CAAA;AACtC,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,GAAG,CAAuB,QAAsB;IAC/D,MAAM,EAAE,GAAG,GAAG,EAAK,CAAC,CAAC,CAAC,CAAA;IACtB,IAAI,QAAQ;QACX,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACjB,OAAO,EAAE,CAAA;AACV,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,GAAG,CAAuB,QAAsB;IAC/D,MAAM,EAAE,GAAG,GAAG,EAAK,CAAC,CAAC,CAAC,CAAA;IACtB,IAAI,QAAQ;QACX,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACjB,OAAO,EAAE,CAAA;AACV,CAAC"}
+{"version":3,"file":"pubsub.js","sourceRoot":"","sources":["../s/pubsub.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAA;AAmChC,MAAM,UAAU,GAAG;IAClB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAe,CAAA;IAElC,SAAS,GAAG,CAAC,EAAe;QAC3B,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACX,OAAO,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA,CAAC,CAAC,CAAA;IAChC,CAAC;IAED,KAAK,UAAU,GAAG,CAAC,GAAG,CAAI;QACzB,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAChD,CAAC;IAED,KAAK,UAAU,IAAI;QAClB,MAAM,EAAC,OAAO,EAAE,OAAO,EAAC,GAAG,KAAK,EAAK,CAAA;QACrC,MAAM,WAAW,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE;YAChC,OAAO,CAAC,CAAC,CAAC,CAAA;YACV,WAAW,EAAE,CAAA;QACd,CAAC,CAAC,CAAA;QACF,OAAO,OAAO,CAAA;IACf,CAAC;IAED,SAAS,KAAK;QACb,GAAG,CAAC,KAAK,EAAE,CAAA;IACZ,CAAC;IAED,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACb,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACb,GAAG,CAAC,EAAE,GAAG,GAAG,CAAA;IACZ,GAAG,CAAC,IAAI,GAAG,IAAI,CAAA;IACf,GAAG,CAAC,KAAK,GAAG,KAAK,CAAA;IAEjB,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACb,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACb,GAAG,CAAC,EAAE,GAAG,GAAG,CAAA;IACZ,GAAG,CAAC,IAAI,GAAG,IAAI,CAAA;IACf,GAAG,CAAC,KAAK,GAAG,KAAK,CAAA;IAEjB,OAAO,CAAC,GAAG,EAAE,GAAG,CAAqB,CAAA;AACtC,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,GAAG,CAAuB,QAAsB;IAC/D,MAAM,EAAE,GAAG,GAAG,EAAK,CAAC,CAAC,CAAC,CAAA;IACtB,IAAI,QAAQ;QACX,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACjB,OAAO,EAAE,CAAA;AACV,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,GAAG,CAAuB,QAAsB;IAC/D,MAAM,EAAE,GAAG,GAAG,EAAK,CAAC,CAAC,CAAC,CAAA;IACtB,IAAI,QAAQ;QACX,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACjB,OAAO,EAAE,CAAA;AACV,CAAC"}

package/x/queue/queue.d.ts

@@ -0,0 +1,4 @@
+/**
+ * create a job queue that ensures the given fn is always called in sequence (not concurrently).
+ */
+export declare function queue<Args extends any[], Result>(fn: (...args: Args) => Promise<Result>): (...args: Args) => Promise<Result>;

package/x/queue/queue.js

@@ -0,0 +1,14 @@
+/**
+ * create a job queue that ensures the given fn is always called in sequence (not concurrently).
+ */
+export function queue(fn) {
+    let last = Promise.resolve();
+    return (...args) => {
+        const job = () => fn(...args);
+        const current = last.then(job);
+        // prevent unhandled rejection breaking the chain
+        last = current.catch(() => { });
+        return current;
+    };
+}
+//# sourceMappingURL=queue.js.map

package/x/queue/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../s/queue/queue.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,UAAU,KAAK,CACnB,EAAsC;IAGvC,IAAI,IAAI,GAAiB,OAAO,CAAC,OAAO,EAAE,CAAA;IAE1C,OAAO,CAAC,GAAG,IAAU,EAAmB,EAAE;QACzC,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAE9B,iDAAiD;QACjD,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAE9B,OAAO,OAAO,CAAA;IACf,CAAC,CAAA;AACF,CAAC"}

package/x/queue/queue.test.d.ts

@@ -0,0 +1,8 @@
+import { Science } from "@e280/science";
+declare const _default: {
+    "job runs": Science.Test;
+    "sequencing is enforced": Science.Test;
+    "params and return values seem to work": Science.Test;
+    "first job throws, second job unaffected": Science.Test;
+};
+export default _default;

package/x/queue/queue.test.js

@@ -0,0 +1,57 @@
+import { Science, expect } from "@e280/science";
+import { nap } from "../nap.js";
+import { queue } from "./queue.js";
+export default Science.suite({
+    "job runs": Science.test(async () => {
+        let concurrent = 0;
+        const job = queue(async () => {
+            concurrent++;
+            await nap(100);
+            concurrent--;
+        });
+        const promise1 = job();
+        await nap(50);
+        expect(concurrent).is(1);
+        await promise1;
+        expect(concurrent).is(0);
+    }),
+    "sequencing is enforced": Science.test(async () => {
+        let concurrent = 0;
+        const job = queue(async () => {
+            concurrent++;
+            await nap(100);
+            concurrent--;
+        });
+        const promise1 = job();
+        const promise2 = job();
+        await nap(50);
+        expect(concurrent).is(1);
+        await promise1;
+        await nap(50);
+        expect(concurrent).is(1);
+        await promise2;
+        expect(concurrent).is(0);
+    }),
+    "params and return values seem to work": Science.test(async () => {
+        const add = queue(async (a, b) => {
+            await nap(100);
+            return a + b;
+        });
+        const promise1 = add(1, 2);
+        const promise2 = add(10, 20);
+        expect(await promise1).is(3);
+        expect(await promise2).is(30);
+    }),
+    "first job throws, second job unaffected": Science.test(async () => {
+        let run = 0;
+        const job = queue(async () => {
+            run++;
+            await nap(100);
+            if (run === 1)
+                throw new Error("first job failed");
+        });
+        expect(async () => job()).throwsAsync();
+        expect(async () => job()).not.throwsAsync();
+    }),
+});
+//# sourceMappingURL=queue.test.js.map

package/x/queue/queue.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.test.js","sourceRoot":"","sources":["../../s/queue/queue.test.ts"],"names":[],"mappings":"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"}

package/x/repeat.d.ts

@@ -0,0 +1,5 @@
+/**
+ * repeat the given async function over and over.
+ *  - consider using `nap` in your fn to create a delay
+ */
+export declare function repeat(fn: (stop: () => void) => Promise<void>): () => void;

package/x/repeat.js

@@ -0,0 +1,23 @@
+/**
+ * repeat the given async function over and over.
+ *  - consider using `nap` in your fn to create a delay
+ */
+export function repeat(fn) {
+    let timeout;
+    let stopped = false;
+    const stop = () => {
+        stopped = true;
+        clearTimeout(timeout);
+    };
+    const tick = async () => {
+        if (stopped)
+            return;
+        await fn(stop);
+        if (stopped)
+            return;
+        timeout = setTimeout(tick, 0);
+    };
+    tick();
+    return stop;
+}
+//# sourceMappingURL=repeat.js.map

package/x/repeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repeat.js","sourceRoot":"","sources":["../s/repeat.ts"],"names":[],"mappings":"AACA;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,EAAuC;IAC7D,IAAI,OAAY,CAAA;IAChB,IAAI,OAAO,GAAG,KAAK,CAAA;IAEnB,MAAM,IAAI,GAAG,GAAG,EAAE;QACjB,OAAO,GAAG,IAAI,CAAA;QACd,YAAY,CAAC,OAAO,CAAC,CAAA;IACtB,CAAC,CAAA;IAED,MAAM,IAAI,GAAG,KAAK,IAAG,EAAE;QACtB,IAAI,OAAO;YAAE,OAAM;QACnB,MAAM,EAAE,CAAC,IAAI,CAAC,CAAA;QACd,IAAI,OAAO;YAAE,OAAM;QACnB,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IAC9B,CAAC,CAAA;IAED,IAAI,EAAE,CAAA;IACN,OAAO,IAAI,CAAA;AACZ,CAAC"}

package/x/scope.d.ts

@@ -0,0 +1,37 @@
+import { Constructor } from "./constructor.js";
+export type Scoped<Item> = [item: Item, dispose: () => void];
+export type Disposable = {
+    dispose(): void;
+};
+export declare function scoped<Item>(item: Item, dispose: () => void): Scoped<Item>;
+/**
+ * a trashcan you can fill with garbage, then call `scope.dispose()` to dump it all
+ *  - `add/stow/scoped` methods are for dealing with disposer fns
+ *  - `keep` methods are for dealing with disposable objects (with a dispose method)
+ *  - `sub` for creating nested sub-scopes
+ */
+export declare class Scope implements Disposable {
+    #private;
+    /** add disposer fn */
+    add(dispose: () => void): this;
+    /** add disposer, return item */
+    stow<Item>(item: Item, dispose: () => void): Item;
+    /** add scoped disposer, return item */
+    scoped<Item>([item, dispose]: Scoped<Item>): Item;
+    /** add and return a disposable object */
+    keep<D extends Disposable>(disposable: D): D;
+    /** wrap a fn, auto-add returned disposers */
+    scopedFn<Params extends any[], Item>(fn: (...params: Params) => Scoped<Item>): (...a: Params) => Item;
+    /** wrap an async fn, auto-add returned disposers */
+    scopedFnAsync<Params extends any[], Item>(fn: (...params: Params) => Promise<Scoped<Item>>): (...a: Params) => Promise<Item>;
+    /** wrap a fn, auto-add returned disposables */
+    keepFn<Params extends any[], D extends Disposable>(fn: (...params: Params) => D): (...a: Params) => D;
+    /** wrap an async fn, auto-add returned disposables */
+    keepFnAsync<Params extends any[], D extends Disposable>(fn: (...params: Params) => Promise<D>): (...a: Params) => Promise<D>;
+    /** wrap a constructor, auto-add returned disposables */
+    keepConstructor<C extends Constructor<Disposable>>(Ctor: C): C;
+    /** create a subscope, child gets disposed when parent does */
+    sub(): Scope;
+    /** dispose everything in this scope, in reverse order */
+    dispose(): void;
+}

package/x/scope.js

@@ -0,0 +1,82 @@
+export function scoped(item, dispose) {
+    return [item, dispose];
+}
+/**
+ * a trashcan you can fill with garbage, then call `scope.dispose()` to dump it all
+ *  - `add/stow/scoped` methods are for dealing with disposer fns
+ *  - `keep` methods are for dealing with disposable objects (with a dispose method)
+ *  - `sub` for creating nested sub-scopes
+ */
+export class Scope {
+    #disposers = [];
+    /** add disposer fn */
+    add(dispose) {
+        this.#disposers.push(dispose);
+        return this;
+    }
+    /** add disposer, return item */
+    stow(item, dispose) {
+        this.add(dispose);
+        return item;
+    }
+    /** add scoped disposer, return item */
+    scoped([item, dispose]) {
+        this.add(dispose);
+        return item;
+    }
+    /** add and return a disposable object */
+    keep(disposable) {
+        this.add(() => disposable.dispose());
+        return disposable;
+    }
+    /** wrap a fn, auto-add returned disposers */
+    scopedFn(fn) {
+        return (...a) => {
+            const scoped = fn(...a);
+            return this.scoped(scoped);
+        };
+    }
+    /** wrap an async fn, auto-add returned disposers */
+    scopedFnAsync(fn) {
+        return async (...a) => {
+            const scoped = await fn(...a);
+            return this.scoped(scoped);
+        };
+    }
+    /** wrap a fn, auto-add returned disposables */
+    keepFn(fn) {
+        return (...a) => {
+            const disposable = fn(...a);
+            return this.keep(disposable);
+        };
+    }
+    /** wrap an async fn, auto-add returned disposables */
+    keepFnAsync(fn) {
+        return async (...a) => {
+            const disposable = await fn(...a);
+            return this.keep(disposable);
+        };
+    }
+    /** wrap a constructor, auto-add returned disposables */
+    keepConstructor(Ctor) {
+        const scope = this;
+        return class extends Ctor {
+            constructor(...p) {
+                super(...p);
+                scope.keep(this);
+            }
+        };
+    }
+    /** create a subscope, child gets disposed when parent does */
+    sub() {
+        const subscope = new Scope();
+        return this.stow(subscope, () => subscope.dispose());
+    }
+    /** dispose everything in this scope, in reverse order */
+    dispose() {
+        for (const fn of this.#disposers.reverse())
+            fn();
+        this.#disposers = [];
+    }
+}
+//# sourceMappingURL=scope.js.map

package/x/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../s/scope.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,MAAM,CAAO,IAAU,EAAE,OAAmB;IAC3D,OAAO,CAAC,IAAI,EAAE,OAAO,CAAiB,CAAA;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,KAAK;IACjB,UAAU,GAAmB,EAAE,CAAA;IAE/B,sBAAsB;IACtB,GAAG,CAAC,OAAmB;QACtB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC7B,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,gCAAgC;IAChC,IAAI,CAAO,IAAU,EAAE,OAAmB;QACzC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACjB,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,uCAAuC;IACvC,MAAM,CAAO,CAAC,IAAI,EAAE,OAAO,CAAe;QACzC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACjB,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,yCAAyC;IACzC,IAAI,CAAuB,UAAa;QACvC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAA;QACpC,OAAO,UAAU,CAAA;IAClB,CAAC;IAED,6CAA6C;IAC7C,QAAQ,CACN,EAAuC;QAExC,OAAO,CAAC,GAAG,CAAS,EAAE,EAAE;YACvB,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;YACvB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC3B,CAAC,CAAA;IACF,CAAC;IAED,oDAAoD;IACpD,aAAa,CACX,EAAgD;QAEjD,OAAO,KAAK,EAAC,GAAG,CAAS,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;YAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC3B,CAAC,CAAA;IACF,CAAC;IAED,+CAA+C;IAC/C,MAAM,CACJ,EAA4B;QAE7B,OAAO,CAAC,GAAG,CAAS,EAAE,EAAE;YACvB,MAAM,UAAU,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;YAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC7B,CAAC,CAAA;IACF,CAAC;IAED,sDAAsD;IACtD,WAAW,CACT,EAAqC;QAEtC,OAAO,KAAK,EAAC,GAAG,CAAS,EAAE,EAAE;YAC5B,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;YACjC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC7B,CAAC,CAAA;IACF,CAAC;IAED,wDAAwD;IACxD,eAAe,CAAoC,IAAO;QACzD,MAAM,KAAK,GAAG,IAAI,CAAA;QAClB,OAAO,KAAM,SAAQ,IAAI;YACxB,YAAY,GAAG,CAAQ;gBACtB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;gBACX,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACjB,CAAC;SACI,CAAA;IACP,CAAC;IAED,8DAA8D;IAC9D,GAAG;QACF,MAAM,QAAQ,GAAG,IAAI,KAAK,EAAE,CAAA;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACrD,CAAC;IAED,yDAAyD;IACzD,OAAO;QACN,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE;YACzC,EAAE,EAAE,CAAA;QACL,IAAI,CAAC,UAAU,GAAG,EAAE,CAAA;IACrB,CAAC;CACD"}

package/x/templating.d.ts

@@ -0,0 +1,6 @@
+export type TemplateParts = {
+    strings: TemplateStringsArray;
+    values: any[];
+};
+export declare function templateParts(strings: TemplateStringsArray, ...values: any[]): TemplateParts;
+export declare function templateString(strings: TemplateStringsArray, ...values: any[]): string;

package/x/templating.js

@@ -0,0 +1,11 @@
+export function templateParts(strings, ...values) {
+    return { strings, values };
+}
+export function templateString(strings, ...values) {
+    const lastIndex = strings.length - 1;
+    return strings
+        .slice(0, lastIndex)
+        .reduce((a, b, c) => a + b + values[c], "")
+        + strings[lastIndex];
+}
+//# sourceMappingURL=templating.js.map

package/x/templating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templating.js","sourceRoot":"","sources":["../s/templating.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,aAAa,CAC3B,OAA6B,EAC7B,GAAG,MAAa;IAGjB,OAAO,EAAC,OAAO,EAAE,MAAM,EAAC,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAA6B,EAAE,GAAG,MAAa;IAC7E,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAA;IACpC,OAAO,OAAO;SACZ,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;SACnB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;UACxC,OAAO,CAAC,SAAS,CAAC,CAAA;AACvB,CAAC"}

package/x/tests.test.js

@@ -1,14 +1,18 @@
 import { Science } from "@e280/science";
-import cloneTest from "./clone/clone.test.js";
-import badgeTest from "./data/bytename/badge.test.js";
-import debounceTest from "./debounce/debounce.test.js";
-import bytenameTest from "./data/bytename/bytename.test.js";
-import deepTest from "./deep/deep.test.js";
+import clone from "./clone/clone.test.js";
+import thumbprint from "./data/bytename/thumbprint.test.js";
+import debounce from "./debounce/debounce.test.js";
+import bytename from "./data/bytename/bytename.test.js";
+import deep from "./deep/deep.test.js";
+import data from "./data/data.test.js";
+import queue from "./queue/queue.test.js";
 await Science.run({
-    clone: cloneTest,
-    bytename: bytenameTest,
-    badge: badgeTest,
-    debounce: debounceTest,
-    deep: deepTest,
+    clone,
+    bytename,
+    thumbprint,
+    debounce,
+    deep,
+    data,
+    queue,
 });
 //# sourceMappingURL=tests.test.js.map

package/x/tests.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"tests.test.js","sourceRoot":"","sources":["../s/tests.test.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,OAAO,EAAC,MAAM,eAAe,CAAA;AAErC,OAAO,SAAS,MAAM,uBAAuB,CAAA;AAC7C,OAAO,SAAS,MAAM,+BAA+B,CAAA;AACrD,OAAO,YAAY,MAAM,6BAA6B,CAAA;AACtD,OAAO,YAAY,MAAM,kCAAkC,CAAA;AAC3D,OAAO,QAAQ,MAAM,qBAAqB,CAAA;AAE1C,MAAM,OAAO,CAAC,GAAG,CAAC;IACjB,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,YAAY;IACtB,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,YAAY;IACtB,IAAI,EAAE,QAAQ;CACd,CAAC,CAAA"}
+{"version":3,"file":"tests.test.js","sourceRoot":"","sources":["../s/tests.test.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,OAAO,EAAC,MAAM,eAAe,CAAA;AAErC,OAAO,KAAK,MAAM,uBAAuB,CAAA;AACzC,OAAO,UAAU,MAAM,oCAAoC,CAAA;AAC3D,OAAO,QAAQ,MAAM,6BAA6B,CAAA;AAClD,OAAO,QAAQ,MAAM,kCAAkC,CAAA;AACvD,OAAO,IAAI,MAAM,qBAAqB,CAAA;AACtC,OAAO,IAAI,MAAM,qBAAqB,CAAA;AACtC,OAAO,KAAK,MAAM,uBAAuB,CAAA;AAEzC,MAAM,OAAO,CAAC,GAAG,CAAC;IACjB,KAAK;IACL,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,IAAI;IACJ,IAAI;IACJ,KAAK;CACL,CAAC,CAAA"}

package/x/time.d.ts

@@ -0,0 +1,18 @@
+export declare const Time: {
+    seconds: (n: number) => number;
+    minutes: (n: number) => number;
+    hours: (n: number) => number;
+    days: (n: number) => number;
+    future: {
+        seconds: (n: number) => number;
+        minutes: (n: number) => number;
+        hours: (n: number) => number;
+        days: (n: number) => number;
+    };
+    past: {
+        seconds: (n: number) => number;
+        minutes: (n: number) => number;
+        hours: (n: number) => number;
+        days: (n: number) => number;
+    };
+};

package/x/time.js

@@ -0,0 +1,19 @@
+export const Time = {
+    seconds: (n) => (n * 1000),
+    minutes: (n) => (n * Time.seconds(60)),
+    hours: (n) => (n * Time.minutes(60)),
+    days: (n) => (n * Time.hours(24)),
+    future: {
+        seconds: (n) => (Date.now() + Time.seconds(n)),
+        minutes: (n) => (Date.now() + Time.minutes(n)),
+        hours: (n) => (Date.now() + Time.hours(n)),
+        days: (n) => (Date.now() + Time.days(n)),
+    },
+    past: {
+        seconds: (n) => (Date.now() - Time.seconds(n)),
+        minutes: (n) => (Date.now() - Time.minutes(n)),
+        hours: (n) => (Date.now() - Time.hours(n)),
+        days: (n) => (Date.now() - Time.days(n)),
+    },
+};
+//# sourceMappingURL=time.js.map

package/x/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../s/time.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,IAAI,GAAG;IACnB,OAAO,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9C,KAAK,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAEzC,MAAM,EAAE;QACP,OAAO,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACtD,OAAO,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACtD,KAAK,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAClD,IAAI,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KAChD;IAED,IAAI,EAAE;QACL,OAAO,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACtD,OAAO,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACtD,KAAK,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAClD,IAAI,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KAChD;CACD,CAAA"}

package/s/data/anka.ts

@@ -1,66 +0,0 @@
-
-/*
-
-"anka" is an alternative to base64 that i totally made up.
-	- it looks cool because it features characters from the indian subcontinent.
-	- each byte is represented by one character, which makes a 256 bit id incomparably short at only 32 characters.
-	- however, it's probably a bad idea, for these negative reasons:
-		1. many of these characters are actually 2-or-3-byte sequences (so even though anka is visually more compact than base64 to the user, it's actually more data in terms of bytes).
-		2. it's horrible for url-encoding.
-		3. it's horrible for trying to manually copy by typing.
-
-256-bit anka ids look like this:
-
-	ஒഐওଆઊসਅവஎଉखਬശயഘसചവਭଏரঊझഠடଓઐഴঠണവઞ
-	ठକநइஎਦਏஒഊটਹஜഴयભকயঙਪഉजकঝഐवઠসഏਓਡਟऋ
-	થঞठખஉધഫரਜऐફരਪਙਗഭਣഎफઇমએরଔડਉதਤஅदઘച
-
-*/
-
-import {Bytes} from "./bytes.js"
-
-const characters = [...new Set([
-	// devanagari
-	..."अआइईउऊऋएऐओऔकखगघङचछजझञटठडढणतथदधनपफबभमयरलवशषसह",
-
-	// tamil
-	..."அஆஇஈஉஊஎஏஐஒஓகஙசஜஞடணதநபமயரலவழளறன",
-
-	// bengali
-	..."অআইঈউঊএঐওকখগঘঙচছজঝঞটঠডঢণতথদধনপফবভমযরলশষসহ",
-
-	// gurmukhi
-	..."ਅਆਇਈਉਊਏਐਓਕਖਗਘਙਚਛਜਝਞਟਠਡਢਣਤਥਦਧਨਪਫਬਭਮਯਰਲਵਸਹ",
-
-	// malayalam
-	..."അആഇഈഉഊഎഏഐഒഓകഖഗഘങചഛജഝഞടഠഡഢണതഥദധനപഫബഭമയരലവശസഹളഴറ",
-
-	// gujarati
-	..."અઆઇઈઉઊએઐઓકખગઘઙચછજઝઞટઠડઢણતથદધનપફબભમયરલવશષસહ",
-
-	// odia
-	..."ଅଆଇଈଉଊଏଐଓଔକଖଗଘଙଚଛଜଝଞଟଠଡଢଣତଥଦଧନପଫବଭମଯରଲଶଷସହ",
-])]
-
-export const Anka = Object.freeze({
-
-	string(bytes: Uint8Array) {
-		return [...bytes]
-			.map(int => characters.at(int))
-			.join("")
-	},
-
-	bytes(code: string) {
-		return new Uint8Array([...code].map(char => {
-			const index = characters.indexOf(char)
-			if (index === -1)
-				throw new Error(`invalid anka character "${char}"`)
-			return index
-		}))
-	},
-
-	random(count = 32) {
-		return this.string(Bytes.random(count))
-	},
-})
-

package/s/data/bytename/badge.test.ts

@@ -1,53 +0,0 @@
-
-import {Hex} from "../hex.js"
-import {Badge} from "./badge.js"
-import {Bytes} from "../bytes.js"
-import {Science, test, expect} from "@e280/science"
-
-const sampleBadge = "nodlyn.fasrep:39gfeGFAAnBzH5pkT7EdoETMUMAekG9h1iymk6k"
-const sampleHex = "88e8c3fad1028fcf6ce5ac491578850f4d833336feca03b608265501c3019d59"
-const sampleBytes = Hex.bytes(sampleHex)
-
-function good(bytes: Uint8Array) {
-	expect(Bytes.eq(bytes, sampleBytes)).ok()
-}
-
-export default Science.suite({
-	"bytes->string->bytes": test(async() => {
-		const text = Badge.string(sampleBytes)
-		expect(text).is(sampleBadge)
-		good(Badge.bytes(text))
-	}),
-
-	"zero bytes": test(async() => {
-		const text = Badge.string(new Uint8Array([]))
-		expect(text).is("")
-		expect(Bytes.eq(Badge.bytes(text), new Uint8Array([]))).ok()
-	}),
-
-	"one byte": test(async() => {
-		const text = Badge.string(new Uint8Array([0x00]))
-		expect(text).is("doz")
-		expect(Bytes.eq(Badge.bytes(text), new Uint8Array([0x00]))).ok()
-	}),
-
-	"partially": Science.suite({
-		"normal": test(async() => expect(Badge.bytes("nodlyn.fasrep:39gfeGFAAnBzH5pkT7EdoETMUMAekG9h1iymk6k").length).ok()),
-		"nothing": test(async() => expect(Badge.bytes("").length).is(0)),
-		"no-rest": test(async() => expect(Badge.bytes("nodlyn.fasrep").length).ok()),
-		"one-byte": test(async() => expect(Badge.bytes("nod").length).is(1)),
-		"three-byte": test(async() => expect(Badge.bytes("nodlynfas").length).is(3)),
-		"one-byte-lead": test(async() => expect(Badge.bytes("nod:39gfeGFAAnBzH5pkT7EdoETMUMAekG9h1iymk6k").length).ok()),
-	}),
-
-	"tolerance": Science.suite({
-		"normal": test(async() => good(Badge.bytes("nodlyn.fasrep:39gfeGFAAnBzH5pkT7EdoETMUMAekG9h1iymk6k"))),
-		"coolio": test(async() => good(Badge.bytes("nodlyn.fasrep..39gfeGFAAnBzH5pkT7EdoETMUMAekG9h1iymk6k"))),
-		"spaces": test(async() => good(Badge.bytes("nodlyn fasrep 39gfeGFAAnBzH5pkT7EdoETMUMAekG9h1iymk6k"))),
-		"dots": test(async() => good(Badge.bytes("nodlyn.fasrep.39gfeGFAAnBzH5pkT7EdoETMUMAekG9h1iymk6k"))),
-		"one-space": test(async() => good(Badge.bytes("nodlynfasrep 39gfeGFAAnBzH5pkT7EdoETMUMAekG9h1iymk6k"))),
-		"one-newline": test(async() => good(Badge.bytes("nodlynfasrep\n39gfeGFAAnBzH5pkT7EdoETMUMAekG9h1iymk6k"))),
-		"whitespace": test(async() => good(Badge.bytes("\t\n nodlyn\n fasrep \n\n\t\n 39gfeGFAAnBzH5pkT7EdoETMUMAekG9h1iymk6k\n\t"))),
-	}),
-})
-

package/s/data/bytename/badge.ts

@@ -1,81 +0,0 @@
-
-import {Hex} from "../hex.js"
-import {Base58} from "../base58.js"
-import {Bytename} from "./bytename.js"
-
-export type BadgeOptions = {
-	leadBytes: number
-	leadSeparator: string
-	restSeparator: string
-}
-
-export type ParsedBadge = {
-	lead: string
-	rest: string
-	bytes: Uint8Array
-}
-
-/**
- * Badge is a human-friendly presentation format for arbitrary binary data.
- *  - looks like "nodlyn.fasrep:39gfeGFAAnBzH5pkT7EdoETMUMAekG9h1iymk6k"
- *  - the first lead bytes are shown in bytename format
- *  - the rest of the data is in base58
- *  - designed to be a nice way to present 256-bit passport thumbprints
- *  - can actually represent any number of bytes
- *  - "nodlyn.fasrep:39gfeGFAAnBzH5pkT7EdoETMUMAekG9h1iymk6k"
- */
-export const Badge = {
-	defaults: (<BadgeOptions>{
-		leadBytes: 4,
-		leadSeparator: ".",
-		restSeparator: ":",
-	}),
-
-	string(bytes: Uint8Array, options: Partial<BadgeOptions> = {}) {
-		const {leadBytes, leadSeparator, restSeparator}
-			= {...Badge.defaults, ...options}
-
-		const appetizer = Bytename.string(bytes.slice(0, leadBytes), {
-			wordSeparator: leadSeparator,
-			groupSeparator: leadSeparator,
-		})
-
-		return (bytes.length > leadBytes)
-			? `${appetizer}${restSeparator}${Base58.string(bytes.slice(leadBytes))}`
-			: appetizer
-	},
-
-	parse(badge: string): ParsedBadge {
-		badge = badge.trim()
-		const parts = badge.split(/[^a-zA-Z0-9]+/m)
-			.filter(Boolean)
-			.map(s => s.trim())
-
-		if (parts.length < 2) {
-			const lead = parts.join(".")
-			const bytes = Bytename.bytes(lead)
-			return {lead, rest: "", bytes}
-		}
-
-		const rest = parts.pop()!
-		const lead = parts.join(".")
-		const bytes = new Uint8Array([
-			...Bytename.bytes(lead),
-			...Base58.bytes(rest),
-		])
-		return {lead, rest, bytes}
-	},
-
-	bytes(badge: string) {
-		return Badge.parse(badge).bytes
-	},
-
-	hex(badge: string) {
-		return Hex.string(Badge.bytes(badge))
-	},
-
-	fromHex(hex: string, options?: Partial<BadgeOptions>) {
-		return Badge.string(Hex.bytes(hex), options)
-	},
-}
-

package/x/data/anka.d.ts

@@ -1,5 +0,0 @@
-export declare const Anka: Readonly<{
-    string(bytes: Uint8Array): string;
-    bytes(code: string): Uint8Array<ArrayBuffer>;
-    random(count?: number): string;
-}>;