@e280/stz 0.0.0-8 → 0.1.0

package/x/data/data.test.js

@@ -0,0 +1,77 @@
+import { Science, test, expect } from "@e280/science";
+import { ob } from "../ob.js";
+import { Txt } from "./txt.js";
+import { Hex } from "./hex.js";
+import { Bytes } from "./bytes.js";
+import { BaseX } from "./base-x.js";
+import { Base58 } from "./base58.js";
+import { Base64 } from "./base64.js";
+import { Base64url } from "./base64url.js";
+const sampleBytes = Hex.toBytes("9960cd633a46acfe8307d8a400e842da0d930a75fb8188e0f5da264e4b6b4e5b");
+function testBytes(util) {
+    return async () => {
+        const string = util.fromBytes(sampleBytes);
+        const recreated = util.toBytes(string);
+        expect(Bytes.eq(sampleBytes, recreated)).ok();
+    };
+}
+function testNumbers(util) {
+    return {
+        positive: async () => {
+            const original = 123456789;
+            const string = util.fromInteger(original);
+            const recreated = util.toInteger(string);
+            expect(original).is(recreated);
+            expect(util.toInteger("")).is(0);
+        },
+        negative: async () => {
+            const original = -123456789;
+            const string = util.fromInteger(original);
+            const recreated = util.toInteger(string);
+            expect(original).is(recreated);
+            expect(util.toInteger("")).is(0);
+        },
+    };
+}
+function testBoth(util) {
+    return {
+        bytes: testBytes(util),
+        numbers: testNumbers(util),
+    };
+}
+function testCompat(alpha, bravo) {
+    return async () => {
+        expect(alpha.fromBytes(sampleBytes))
+            .is(bravo.fromBytes(sampleBytes));
+    };
+}
+export default Science.suite({
+    "Base58": testBytes(Base58),
+    "Base64": testBytes(Base64),
+    "Base64url": testBytes(Base64url),
+    "Hex": testBytes(Hex),
+    "Txt": test(async () => {
+        const original = `build or die. 💻>☠️ 命火工`;
+        const bytes = Txt.toBytes(original);
+        const recreated = Txt.fromBytes(bytes);
+        expect(original).is(recreated);
+    }),
+    "BaseX": Science.suite({
+        lexicons: Science.suite(ob(BaseX.lexicons).map(lex => testBoth(new BaseX(lex)))),
+        compat: Science.suite({
+            "Hex": testCompat(Hex, new BaseX(BaseX.lexicons.hex)),
+            "Base64": testCompat(Base64, new BaseX(BaseX.lexicons.base64)),
+            "Base64url": testCompat(Base64url, new BaseX(BaseX.lexicons.base64url)),
+        }),
+        "base64 has padding": test(async () => {
+            const s = new BaseX(BaseX.lexicons.base64).fromBytes(sampleBytes);
+            expect(s.endsWith("=")).ok();
+        }),
+        "antagonistic base64 positive integer": test(async () => {
+            const base64url = new BaseX(BaseX.lexicons.base64url);
+            expect(base64url.toInteger(base64url.fromInteger(62))).is(62);
+            expect(base64url.toInteger(base64url.fromInteger(4030))).is(4030);
+        }),
+    }),
+});
+//# sourceMappingURL=data.test.js.map

package/x/data/data.test.js.map

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

package/x/data/hex.d.ts

@@ -1,6 +1,10 @@
-export declare const Hex: {
-    string(bytes: Uint8Array): string;
-    bytes(string: string): Uint8Array<ArrayBuffer>;
+export declare const Hex: Readonly<{
+    fromBytes(bytes: Uint8Array): string;
+    toBytes(string: string): Uint8Array<ArrayBuffer>;
     /** generate a random hex string. byteCount defaults to 32. */
     random(byteCount?: number): string;
-};
+    /** @deprecated renamed to `fromBytes` */
+    string(bytes: Uint8Array): string;
+    /** @deprecated renamed to `toBytes` */
+    bytes(string: string): Uint8Array<ArrayBuffer>;
+}>;

package/x/data/hex.js

@@ -8,13 +8,13 @@
 
 */
 import { Bytes } from "./bytes.js";
-export const Hex = {
-    string(bytes) {
+export const Hex = Object.freeze({
+    fromBytes(bytes) {
         return [...bytes]
             .map(byte => byte.toString(16).padStart(2, "0"))
             .join("");
     },
-    bytes(string) {
+    toBytes(string) {
         if (string.length % 2 !== 0)
             throw new Error("must have even number of hex characters");
         const bytes = new Uint8Array(string.length / 2);
@@ -24,7 +24,15 @@ export const Hex = {
     },
     /** generate a random hex string. byteCount defaults to 32. */
     random(byteCount = 32) {
-        return this.string(Bytes.random(byteCount));
+        return this.fromBytes(Bytes.random(byteCount));
+    },
+    /** @deprecated renamed to `fromBytes` */
+    string(bytes) {
+        return Hex.fromBytes(bytes);
+    },
+    /** @deprecated renamed to `toBytes` */
+    bytes(string) {
+        return Hex.toBytes(string);
     },
-};
+});
 //# sourceMappingURL=hex.js.map

package/x/data/hex.js.map

@@ -1 +1 @@
-{"version":3,"file":"hex.js","sourceRoot":"","sources":["../../s/data/hex.ts"],"names":[],"mappings":"AACA;;;;;;;;EAQE;AAEF,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAA;AAEhC,MAAM,CAAC,MAAM,GAAG,GAAG;IAClB,MAAM,CAAC,KAAiB;QACvB,OAAO,CAAC,GAAG,KAAK,CAAC;aACf,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;aAC/C,IAAI,CAAC,EAAE,CAAC,CAAA;IACX,CAAC;IAED,KAAK,CAAC,MAAc;QACnB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;QAC3D,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC;YACxC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACpD,OAAO,KAAK,CAAA;IACb,CAAC;IAED,8DAA8D;IAC9D,MAAM,CAAC,SAAS,GAAG,EAAE;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAA;IAC5C,CAAC;CACD,CAAA"}
+{"version":3,"file":"hex.js","sourceRoot":"","sources":["../../s/data/hex.ts"],"names":[],"mappings":"AACA;;;;;;;;EAQE;AAEF,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAA;AAEhC,MAAM,CAAC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;IAChC,SAAS,CAAC,KAAiB;QAC1B,OAAO,CAAC,GAAG,KAAK,CAAC;aACf,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;aAC/C,IAAI,CAAC,EAAE,CAAC,CAAA;IACX,CAAC;IAED,OAAO,CAAC,MAAc;QACrB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;QAC3D,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC;YACxC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACpD,OAAO,KAAK,CAAA;IACb,CAAC;IAED,8DAA8D;IAC9D,MAAM,CAAC,SAAS,GAAG,EAAE;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAA;IAC/C,CAAC;IAED,yCAAyC;IACzC,MAAM,CAAC,KAAiB;QACvB,OAAO,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAC5B,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,MAAc;QACnB,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3B,CAAC;CACD,CAAC,CAAA"}

package/x/data/txt.d.ts

@@ -1,4 +1,8 @@
-export declare const Txt: {
+export declare const Txt: Readonly<{
+    fromBytes(bytes: Uint8Array): string;
+    toBytes(string: string): Uint8Array<ArrayBufferLike>;
+    /** @deprecated renamed to `fromBytes` */
     string(bytes: Uint8Array): string;
+    /** @deprecated renamed to `toBytes` */
     bytes(string: string): Uint8Array<ArrayBufferLike>;
-};
+}>;

package/x/data/txt.js

@@ -1,9 +1,17 @@
-export const Txt = {
-    string(bytes) {
+export const Txt = Object.freeze({
+    fromBytes(bytes) {
         return new TextDecoder().decode(bytes);
     },
-    bytes(string) {
+    toBytes(string) {
         return new TextEncoder().encode(string);
     },
-};
+    /** @deprecated renamed to `fromBytes` */
+    string(bytes) {
+        return Txt.fromBytes(bytes);
+    },
+    /** @deprecated renamed to `toBytes` */
+    bytes(string) {
+        return Txt.toBytes(string);
+    },
+});
 //# sourceMappingURL=txt.js.map

package/x/data/txt.js.map

@@ -1 +1 @@
-{"version":3,"file":"txt.js","sourceRoot":"","sources":["../../s/data/txt.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,GAAG,GAAG;IAClB,MAAM,CAAC,KAAiB;QACvB,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACvC,CAAC;IAED,KAAK,CAAC,MAAc;QACnB,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACxC,CAAC;CACD,CAAA"}
+{"version":3,"file":"txt.js","sourceRoot":"","sources":["../../s/data/txt.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;IAChC,SAAS,CAAC,KAAiB;QAC1B,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACvC,CAAC;IAED,OAAO,CAAC,MAAc;QACrB,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACxC,CAAC;IAED,yCAAyC;IACzC,MAAM,CAAC,KAAiB;QACvB,OAAO,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAC5B,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,MAAc;QACnB,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3B,CAAC;CACD,CAAC,CAAA"}

package/x/deadline.d.ts

@@ -1,7 +1,7 @@
 export declare class DeadlineError extends Error {
     milliseconds: number;
     name: string;
-    constructor(milliseconds: number, message: string);
+    constructor(milliseconds: number);
 }
 /** set a deadline for a fn to do something, will reject with a `DeadlineError` if it takes too long */
-export declare function deadline<R>(milliseconds: number, message: string, fn: () => Promise<R>): Promise<R>;
+export declare function deadline<R>(milliseconds: number, fn: () => Promise<R>): Promise<R>;

package/x/deadline.js

@@ -1,17 +1,17 @@
 export class DeadlineError extends Error {
     milliseconds;
     name = this.constructor.name;
-    constructor(milliseconds, message) {
-        super(`${message}, timed out in ${(milliseconds / 1000).toFixed(1)} seconds`);
+    constructor(milliseconds) {
+        super(`deadline exceeded (${(milliseconds / 1000).toFixed(1)} seconds)`);
         this.milliseconds = milliseconds;
     }
 }
 /** set a deadline for a fn to do something, will reject with a `DeadlineError` if it takes too long */
-export function deadline(milliseconds, message, fn) {
+export function deadline(milliseconds, fn) {
     if (milliseconds <= 0 || milliseconds === Infinity)
         return fn();
     return new Promise((resolve, reject) => {
-        const id = setTimeout(() => reject(new DeadlineError(milliseconds, message)), milliseconds);
+        const id = setTimeout(() => reject(new DeadlineError(milliseconds)), milliseconds);
         fn()
             .then(resolve)
             .catch(reject)

package/x/deadline.js.map

@@ -1 +1 @@
-{"version":3,"file":"deadline.js","sourceRoot":"","sources":["../s/deadline.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEpB;IADnB,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;IAC5B,YAAmB,YAAoB,EAAE,OAAe;QACvD,KAAK,CAAC,GAAG,OAAO,kBAAkB,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;QAD3D,iBAAY,GAAZ,YAAY,CAAQ;IAEvC,CAAC;CACD;AAED,uGAAuG;AACvG,MAAM,UAAU,QAAQ,CAAI,YAAoB,EAAE,OAAe,EAAE,EAAoB;IACtF,IAAI,YAAY,IAAI,CAAC,IAAI,YAAY,KAAK,QAAQ;QACjD,OAAO,EAAE,EAAE,CAAA;IAEZ,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAEzC,MAAM,EAAE,GAAG,UAAU,CACpB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,EACtD,YAAY,CACZ,CAAA;QAED,EAAE,EAAE;aACF,IAAI,CAAC,OAAO,CAAC;aACb,KAAK,CAAC,MAAM,CAAC;aACb,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"deadline.js","sourceRoot":"","sources":["../s/deadline.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEpB;IADnB,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;IAC5B,YAAmB,YAAoB;QACtC,KAAK,CAAC,sBAAsB,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;QADtD,iBAAY,GAAZ,YAAY,CAAQ;IAEvC,CAAC;CACD;AAED,uGAAuG;AACvG,MAAM,UAAU,QAAQ,CAAI,YAAoB,EAAE,EAAoB;IACrE,IAAI,YAAY,IAAI,CAAC,IAAI,YAAY,KAAK,QAAQ;QACjD,OAAO,EAAE,EAAE,CAAA;IAEZ,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACzC,MAAM,EAAE,GAAG,UAAU,CACpB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC,EAC7C,YAAY,CACZ,CAAA;QACD,EAAE,EAAE;aACF,IAAI,CAAC,OAAO,CAAC;aACb,KAAK,CAAC,MAAM,CAAC;aACb,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;AACH,CAAC"}

package/x/{defer-promise.d.ts → defer.d.ts}

@@ -1,5 +1,5 @@
 /** a promise which can be resolved from the outside */
-export type DeferredPromise<R> = {
+export type Deferred<R = void> = {
     promise: Promise<R>;
     resolve: (result: R) => void;
     reject: (reason: any) => void;
@@ -7,4 +7,4 @@ export type DeferredPromise<R> = {
     entangle: (outsidePromise: Promise<R>) => Promise<R>;
 };
 /** returns a deferred promise with exposed resolve and reject fns */
-export declare function deferPromise<R>(): DeferredPromise<R>;
+export declare function defer<R = void>(): Deferred<R>;

package/x/{defer-promise.js → defer.js}

@@ -1,5 +1,5 @@
 /** returns a deferred promise with exposed resolve and reject fns */
-export function deferPromise() {
+export function defer() {
     let resolve;
     let reject;
     const promise = new Promise((res, rej) => {
@@ -12,4 +12,4 @@ export function deferPromise() {
     }
     return { promise, resolve, reject, entangle };
 }
-//# sourceMappingURL=defer-promise.js.map
+//# sourceMappingURL=defer.js.map

package/x/defer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defer.js","sourceRoot":"","sources":["../s/defer.ts"],"names":[],"mappings":"AAWA,qEAAqE;AACrE,MAAM,UAAU,KAAK;IACpB,IAAI,OAA6B,CAAA;IACjC,IAAI,MAA8B,CAAA;IAElC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC3C,OAAO,GAAG,GAAG,CAAA;QACb,MAAM,GAAG,GAAG,CAAA;IACb,CAAC,CAAC,CAAA;IAEF,SAAS,QAAQ,CAAC,OAAmB;QACpC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACnC,OAAO,OAAO,CAAA;IACf,CAAC;IAED,OAAO,EAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAC,CAAA;AAC5C,CAAC"}

package/x/drill.d.ts

@@ -1,6 +1,4 @@
-/**
- * return a value within an object tree, found at the given path.
- */
+/** return a value within an object tree, found at the given path. */
 export declare function drill<xResult>(object: {
     [key: string]: any;
 }, path: string[]): xResult;

package/x/drill.js

@@ -1,12 +1,10 @@
 import { is } from "./is.js";
-/**
- * return a value within an object tree, found at the given path.
- */
+/** return a value within an object tree, found at the given path. */
 export function drill(object, path) {
     let current = object;
     for (const key of path) {
         current = current[key];
-        if (is.unavailable(current))
+        if (is.unset(current))
             break;
     }
     return current;

package/x/drill.js.map

@@ -1 +1 @@
-{"version":3,"file":"drill.js","sourceRoot":"","sources":["../s/drill.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,EAAE,EAAC,MAAM,SAAS,CAAA;AAE1B;;GAEG;AACH,MAAM,UAAU,KAAK,CACnB,MAA4B,EAC5B,IAAc;IAGf,IAAI,OAAO,GAAQ,MAAM,CAAA;IAEzB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QACtB,IAAI,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC;YAC1B,MAAK;IACP,CAAC;IAED,OAAO,OAAO,CAAA;AACf,CAAC"}
+{"version":3,"file":"drill.js","sourceRoot":"","sources":["../s/drill.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,EAAE,EAAC,MAAM,SAAS,CAAA;AAE1B,qEAAqE;AACrE,MAAM,UAAU,KAAK,CACnB,MAA4B,EAC5B,IAAc;IAGf,IAAI,OAAO,GAAQ,MAAM,CAAA;IAEzB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QACtB,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;YACpB,MAAK;IACP,CAAC;IAED,OAAO,OAAO,CAAA;AACf,CAAC"}

package/x/ev.d.ts

@@ -0,0 +1,6 @@
+export type EvFn = (...a: any[]) => void;
+export type EvTarget<N extends string> = {
+    addEventListener(name: N, fn: EvFn): void;
+    removeEventListener(name: N, fn: EvFn): void;
+};
+export declare function ev<N extends string>(target: EvTarget<N>, fns: Record<N, EvFn>): () => void;

package/x/ev.js

@@ -0,0 +1,10 @@
+export function ev(target, fns) {
+    const entries = Object.entries(fns);
+    for (const [name, fn] of entries)
+        target.addEventListener(name, fn);
+    return () => {
+        for (const [name, fn] of entries)
+            target.removeEventListener(name, fn);
+    };
+}
+//# sourceMappingURL=ev.js.map

package/x/ev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ev.js","sourceRoot":"","sources":["../s/ev.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,EAAE,CAAmB,MAAmB,EAAE,GAAoB;IAC7E,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAgB,CAAA;IAElD,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,OAAO;QAC/B,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAElC,OAAO,GAAG,EAAE;QACX,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,OAAO;YAC/B,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IACtC,CAAC,CAAA;AACF,CAAC"}

package/x/id-counter.d.ts

@@ -0,0 +1,5 @@
+export declare class IdCounter {
+    count: number;
+    constructor(count?: number);
+    next(): number;
+}

package/x/id-counter.js

@@ -0,0 +1,10 @@
+export class IdCounter {
+    count;
+    constructor(count = 0) {
+        this.count = count;
+    }
+    next() {
+        return this.count++;
+    }
+}
+//# sourceMappingURL=id-counter.js.map

package/x/id-counter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-counter.js","sourceRoot":"","sources":["../s/id-counter.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,SAAS;IACF;IAAnB,YAAmB,QAAQ,CAAC;QAAT,UAAK,GAAL,KAAK,CAAI;IAAG,CAAC;IAEhC,IAAI;QACH,OAAO,IAAI,CAAC,KAAK,EAAE,CAAA;IACpB,CAAC;CACD"}

package/x/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./data/bytename/index.js";
+export * from "./data/base-x.js";
 export * from "./data/base58.js";
 export * from "./data/base64.js";
 export * from "./data/base64url.js";
@@ -8,19 +9,28 @@ export * from "./data/txt.js";
 export * from "./debounce/debounce.js";
 export * from "./debounce/types.js";
 export * from "./deep/deep.js";
+export * from "./queue/queue.js";
 export * from "./coalesce.js";
 export * from "./concurrent.js";
+export * from "./constructor.js";
 export * from "./deadline.js";
 export * from "./dedupe.js";
-export * from "./defer-promise.js";
+export * from "./defer.js";
 export * from "./drill.js";
 export * from "./escape-regex.js";
+export * from "./ev.js";
 export * from "./hat.js";
+export * from "./id-counter.js";
 export * from "./is.js";
 export * from "./loopy.js";
 export * from "./map-g.js";
 export * from "./nap.js";
 export * from "./ob.js";
+export * from "./once.js";
 export * from "./pipe.js";
 export * from "./pubsub.js";
+export * from "./repeat.js";
+export * from "./scope.js";
+export * from "./templating.js";
+export * from "./time.js";
 export * from "./trash.js";

package/x/index.js

@@ -1,4 +1,5 @@
 export * from "./data/bytename/index.js";
+export * from "./data/base-x.js";
 export * from "./data/base58.js";
 export * from "./data/base64.js";
 export * from "./data/base64url.js";
@@ -8,20 +9,29 @@ export * from "./data/txt.js";
 export * from "./debounce/debounce.js";
 export * from "./debounce/types.js";
 export * from "./deep/deep.js";
+export * from "./queue/queue.js";
 export * from "./coalesce.js";
 export * from "./concurrent.js";
+export * from "./constructor.js";
 export * from "./deadline.js";
 export * from "./dedupe.js";
-export * from "./defer-promise.js";
+export * from "./defer.js";
 export * from "./drill.js";
 export * from "./escape-regex.js";
+export * from "./ev.js";
 export * from "./hat.js";
+export * from "./id-counter.js";
 export * from "./is.js";
 export * from "./loopy.js";
 export * from "./map-g.js";
 export * from "./nap.js";
 export * from "./ob.js";
+export * from "./once.js";
 export * from "./pipe.js";
 export * from "./pubsub.js";
+export * from "./repeat.js";
+export * from "./scope.js";
+export * from "./templating.js";
+export * from "./time.js";
 export * from "./trash.js";
 //# sourceMappingURL=index.js.map

package/x/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../s/index.ts"],"names":[],"mappings":"AACA,cAAc,0BAA0B,CAAA;AACxC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAE7B,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AAEnC,cAAc,gBAAgB,CAAA;AAE9B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../s/index.ts"],"names":[],"mappings":"AACA,cAAc,0BAA0B,CAAA;AACxC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAE7B,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AAEnC,cAAc,gBAAgB,CAAA;AAE9B,cAAc,kBAAkB,CAAA;AAEhC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA"}

package/x/is.d.ts

@@ -1,10 +1,12 @@
-export declare const is: {
-    available: <X>(x: X) => x is NonNullable<X>;
-    unavailable: (x: any) => x is (undefined | null);
+export declare const is: Readonly<{
+    set: <X>(x: X) => x is NonNullable<X>;
+    unset: (x: any) => x is (undefined | null);
     boolean: (x: any) => x is boolean;
     number: (x: any) => x is number;
     string: (x: any) => x is string;
     bigint: (x: any) => x is bigint;
     object: <X>(x: X) => x is object & NonNullable<X>;
     array: (x: any | any[]) => x is any[];
-};
+    fn: (x: any) => x is (...a: any[]) => any;
+    symbol: (x: any) => x is symbol;
+}>;

package/x/is.js

@@ -1,11 +1,13 @@
-export const is = {
-    available: (x) => x !== undefined && x !== null,
-    unavailable: (x) => x === undefined || x === null,
+export const is = Object.freeze({
+    set: (x) => x !== undefined && x !== null,
+    unset: (x) => x === undefined || x === null,
     boolean: (x) => typeof x === "boolean",
     number: (x) => typeof x === "number",
     string: (x) => typeof x === "string",
     bigint: (x) => typeof x === "bigint",
     object: (x) => typeof x === "object" && x !== null,
     array: (x) => Array.isArray(x),
-};
+    fn: (x) => typeof x === "function",
+    symbol: (x) => typeof x === "symbol",
+});
 //# sourceMappingURL=is.js.map

package/x/is.js.map

@@ -1 +1 @@
-{"version":3,"file":"is.js","sourceRoot":"","sources":["../s/is.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,EAAE,GAAG;IACjB,SAAS,EAAE,CAAI,CAAI,EAAuB,EAAE,CAC3C,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;IAE9B,WAAW,EAAE,CAAC,CAAM,EAA2B,EAAE,CAChD,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;IAE9B,OAAO,EAAE,CAAC,CAAM,EAAgB,EAAE,CACjC,OAAO,CAAC,KAAK,SAAS;IAEvB,MAAM,EAAE,CAAC,CAAM,EAAe,EAAE,CAC/B,OAAO,CAAC,KAAK,QAAQ;IAEtB,MAAM,EAAE,CAAC,CAAM,EAAe,EAAE,CAC/B,OAAO,CAAC,KAAK,QAAQ;IAEtB,MAAM,EAAE,CAAC,CAAM,EAAe,EAAE,CAC/B,OAAO,CAAC,KAAK,QAAQ;IAEtB,MAAM,EAAE,CAAI,CAAI,EAAgC,EAAE,CACjD,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;IAEpC,KAAK,EAAE,CAAC,CAAc,EAAc,EAAE,CACrC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;CACjB,CAAA"}
+{"version":3,"file":"is.js","sourceRoot":"","sources":["../s/is.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/B,GAAG,EAAE,CAAI,CAAI,EAAuB,EAAE,CACrC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;IAE9B,KAAK,EAAE,CAAC,CAAM,EAA2B,EAAE,CAC1C,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;IAE9B,OAAO,EAAE,CAAC,CAAM,EAAgB,EAAE,CACjC,OAAO,CAAC,KAAK,SAAS;IAEvB,MAAM,EAAE,CAAC,CAAM,EAAe,EAAE,CAC/B,OAAO,CAAC,KAAK,QAAQ;IAEtB,MAAM,EAAE,CAAC,CAAM,EAAe,EAAE,CAC/B,OAAO,CAAC,KAAK,QAAQ;IAEtB,MAAM,EAAE,CAAC,CAAM,EAAe,EAAE,CAC/B,OAAO,CAAC,KAAK,QAAQ;IAEtB,MAAM,EAAE,CAAI,CAAI,EAAgC,EAAE,CACjD,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;IAEpC,KAAK,EAAE,CAAC,CAAc,EAAc,EAAE,CACrC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjB,EAAE,EAAE,CAAC,CAAM,EAA6B,EAAE,CACzC,OAAO,CAAC,KAAK,UAAU;IAExB,MAAM,EAAE,CAAC,CAAM,EAAe,EAAE,CAC/B,OAAO,CAAC,KAAK,QAAQ;CACtB,CAAC,CAAA"}

package/x/map-g.d.ts

@@ -1,9 +1,9 @@
-/** js map, but with handy methods like `require` and `guarantee` */
+/** extended js map with handy methods like `require` and `guarantee` */
 export declare class MapG<K, V> extends Map<K, V> {
-    static require<K, V>(map: Map<K, V>, key: K): V & ({} | null);
+    static require<K, V>(map: Map<K, V>, key: K): NonNullable<V>;
     static guarantee<K, V>(map: Map<K, V>, key: K, make: () => V): V;
     array(): [K, V][];
-    require(key: K): V & ({} | null);
+    require(key: K): NonNullable<V>;
     guarantee(key: K, make: () => V): V;
 }
 export type Identifiable<Id = any> = {

package/x/map-g.js

@@ -1,18 +1,19 @@
-/** js map, but with handy methods like `require` and `guarantee` */
+/** extended js map with handy methods like `require` and `guarantee` */
 export class MapG extends Map {
     static require(map, key) {
-        const value = map.get(key);
-        if (value === undefined)
+        if (map.has(key))
+            return map.get(key);
+        else
             throw new Error(`required key not found: "${key}"`);
-        return value;
     }
     static guarantee(map, key, make) {
-        let value = map.get(key);
-        if (value === undefined) {
-            value = make();
+        if (map.has(key))
+            return map.get(key);
+        else {
+            const value = make();
             map.set(key, value);
+            return value;
         }
-        return value;
     }
     array() {
         return [...this];

package/x/map-g.js.map

@@ -1 +1 @@
-{"version":3,"file":"map-g.js","sourceRoot":"","sources":["../s/map-g.ts"],"names":[],"mappings":"AACA,oEAAoE;AACpE,MAAM,OAAO,IAAW,SAAQ,GAAS;IACxC,MAAM,CAAC,OAAO,CAAO,GAAc,EAAE,GAAM;QAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC1B,IAAI,KAAK,KAAK,SAAS;YACtB,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,GAAG,CAAC,CAAA;QACpD,OAAO,KAAK,CAAA;IACb,CAAC;IAED,MAAM,CAAC,SAAS,CAAO,GAAc,EAAE,GAAM,EAAE,IAAa;QAC3D,IAAI,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAExB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,KAAK,GAAG,IAAI,EAAE,CAAA;YACd,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACpB,CAAC;QAED,OAAO,KAAK,CAAA;IACb,CAAC;IAED,KAAK;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;IACjB,CAAC;IAED,OAAO,CAAC,GAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED,SAAS,CAAC,GAAM,EAAE,IAAa;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;IACvC,CAAC;CACD;AAID,oDAAoD;AACpD,MAAM,OAAO,KAA8B,SAAQ,IAAgB;IAClE,GAAG,CAAC,KAAQ;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC1B,CAAC;IAED,GAAG,CAAC,KAAQ;QACX,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;QACzB,OAAO,KAAK,CAAA;IACb,CAAC;IAED,MAAM,CAAC,KAAQ;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC7B,CAAC;CACD"}
+{"version":3,"file":"map-g.js","sourceRoot":"","sources":["../s/map-g.ts"],"names":[],"mappings":"AACA,wEAAwE;AACxE,MAAM,OAAO,IAAW,SAAQ,GAAS;IACxC,MAAM,CAAC,OAAO,CAAO,GAAc,EAAE,GAAM;QAC1C,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;YACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAE,CAAA;;YAEpB,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,GAAG,CAAC,CAAA;IACrD,CAAC;IAED,MAAM,CAAC,SAAS,CAAO,GAAc,EAAE,GAAM,EAAE,IAAa;QAC3D,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;YACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAE,CAAA;aAChB,CAAC;YACL,MAAM,KAAK,GAAG,IAAI,EAAE,CAAA;YACpB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACnB,OAAO,KAAK,CAAA;QACb,CAAC;IACF,CAAC;IAED,KAAK;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;IACjB,CAAC;IAED,OAAO,CAAC,GAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED,SAAS,CAAC,GAAM,EAAE,IAAa;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;IACvC,CAAC;CACD;AAID,oDAAoD;AACpD,MAAM,OAAO,KAA8B,SAAQ,IAAgB;IAClE,GAAG,CAAC,KAAQ;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC1B,CAAC;IAED,GAAG,CAAC,KAAQ;QACX,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;QACzB,OAAO,KAAK,CAAA;IACb,CAAC;IAED,MAAM,CAAC,KAAQ;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC7B,CAAC;CACD"}

package/x/nap.d.ts

@@ -1 +1,2 @@
+/** create a promise that waits for a number of milliseconds. */
 export declare const nap: (milliseconds?: number) => Promise<void>;

package/x/nap.js

@@ -1,2 +1,3 @@
+/** create a promise that waits for a number of milliseconds. */
 export const nap = (milliseconds = 0) => (new Promise(resolve => setTimeout(resolve, milliseconds)));
 //# sourceMappingURL=nap.js.map

package/x/nap.js.map

@@ -1 +1 @@
-{"version":3,"file":"nap.js","sourceRoot":"","sources":["../s/nap.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,eAAuB,CAAC,EAAE,EAAE,CAAC,CAChD,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAC/D,CAAA"}
+{"version":3,"file":"nap.js","sourceRoot":"","sources":["../s/nap.ts"],"names":[],"mappings":"AACA,gEAAgE;AAChE,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,eAAuB,CAAC,EAAE,EAAE,CAAC,CAChD,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAC/D,CAAA"}

package/x/once.d.ts

@@ -0,0 +1 @@
+export declare function once<Fn extends (...a: any[]) => any>(fn: Fn): Fn;

package/x/once.js

@@ -0,0 +1,12 @@
+export function once(fn) {
+    let done = false;
+    let ret;
+    return ((...a) => {
+        if (!done) {
+            done = true;
+            ret = fn(...a);
+        }
+        return ret;
+    });
+}
+//# sourceMappingURL=once.js.map

package/x/once.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"once.js","sourceRoot":"","sources":["../s/once.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,IAAI,CAAkC,EAAM;IAC3D,IAAI,IAAI,GAAG,KAAK,CAAA;IAChB,IAAI,GAAQ,CAAA;IAEZ,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE;QAChB,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,IAAI,GAAG,IAAI,CAAA;YACX,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;QACf,CAAC;QACD,OAAO,GAAG,CAAA;IACX,CAAC,CAAO,CAAA;AACT,CAAC"}

package/x/pipe.d.ts

@@ -1,8 +1,9 @@
-export type PipeFun<I, O> = (input: I) => O;
+export type Piper<I, O> = (input: I) => O;
+export declare function pipe<I>(input: I): Pipe<I>;
 export declare class Pipe<I> {
     #private;
-    static with<I>(input: I): Pipe<I>;
+    static with: typeof pipe;
     constructor(input: I);
-    to<O>(fun: PipeFun<I, O>): Pipe<O>;
+    to<O>(fn: Piper<I, O>): Pipe<O>;
     done(): I;
 }

package/x/pipe.js

@@ -1,13 +1,14 @@
+export function pipe(input) {
+    return new Pipe(input);
+}
 export class Pipe {
-    static with(input) {
-        return new this(input);
-    }
     #input;
+    static with = pipe;
     constructor(input) {
         this.#input = input;
     }
-    to(fun) {
-        return new Pipe(fun(this.#input));
+    to(fn) {
+        return new Pipe(fn(this.#input));
     }
     done() {
         return this.#input;

package/x/pipe.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipe.js","sourceRoot":"","sources":["../s/pipe.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,IAAI;IAEhB,MAAM,CAAC,IAAI,CAAI,KAAQ;QACtB,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAA;IACvB,CAAC;IAED,MAAM,CAAG;IAET,YAAY,KAAQ;QACnB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;IACpB,CAAC;IAED,EAAE,CAAI,GAAkB;QACvB,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IAClC,CAAC;IAED,IAAI;QACH,OAAO,IAAI,CAAC,MAAM,CAAA;IACnB,CAAC;CACD"}
+{"version":3,"file":"pipe.js","sourceRoot":"","sources":["../s/pipe.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,IAAI,CAAI,KAAQ;IAC/B,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAA;AACvB,CAAC;AAED,MAAM,OAAO,IAAI;IAChB,MAAM,CAAG;IACT,MAAM,CAAC,IAAI,GAAG,IAAI,CAAA;IAElB,YAAY,KAAQ;QACnB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;IACpB,CAAC;IAED,EAAE,CAAI,EAAe;QACpB,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IACjC,CAAC;IAED,IAAI;QACH,OAAO,IAAI,CAAC,MAAM,CAAA;IACnB,CAAC"}

package/x/pubsub.d.ts

@@ -1,13 +1,24 @@
 export type Listener<A extends any[]> = (...a: A) => (void | Promise<void>);
 export interface Xub<A extends any[] = []> {
+    /** publish to all subscribed listeners. */
     pub(...a: A): Promise<void>;
+    /** subscribe a listener function. */
     sub(fn: Listener<A>): () => void;
-    once(): Promise<A>;
+    /**
+     * subscribe a listener function.
+     * @alias sub
+     */
+    on(fn: Listener<A>): () => void;
+    /** wait for the next published value */
+    next(): Promise<A>;
+    /** wipe all listeners attached to this. */
     clear(): void;
 }
+/** subscriber fn that can be published to. */
 export interface Sub<A extends any[] = []> extends Xub<A> {
     (fn: Listener<A>): () => void;
 }
+/** publisher fn that can be published to. */
 export interface Pub<A extends any[] = []> extends Xub<A> {
     (...a: A): Promise<void>;
 }