@e280/stz 0.0.0-3 → 0.0.0-30

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>;
 }

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/tests.test.js

@@ -0,0 +1,18 @@
+import { Science } from "@e280/science";
+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,
+    bytename,
+    thumbprint,
+    debounce,
+    deep,
+    data,
+    queue,
+});
+//# sourceMappingURL=tests.test.js.map

package/x/tests.test.js.map

@@ -0,0 +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,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/readme.md

@@ -1,85 +0,0 @@
-
-# `@e280/stz`
-standard library of environment-agnostic typescript functions we use basically everywhere
-
-<br/>
-
-## the tools
-stz has many more tools than documented below, see their [sourcecode here in s/](./s/)
-
-### MapG — an extension of js Map with handy methods
-- `map.require`
-  ```ts
-  import {MapG} from "@e280/stz"
-
-  const map = new MapG<number, string>([
-    [1, "hello"],
-    [2, "world"],
-  ])
-
-  // throws error if the value is undefined
-  const value = map.require(1)
-  ```
-- `map.guarantee`
-  ```ts
-  // if the value is undefined, the new value "rofl" is set and returned
-  const value = map.guarantee(3, () => "rofl")
-  ```
-
-### pub and sub — minimal ergonomic event system
-- make a publisher fn
-  ```ts
-  import {pub} from "@e280/stz"
-
-  // create a pub fn
-  const sendMessage = pub<[string]>()
-
-  // subscribe to it
-  sendMessage.sub(m => console.log(m))
-
-  // publish to it
-  sendMessage("hello")
-  ```
-- make a subscriber fn *(see how it's just the reverse of pub?)*
-  ```ts
-  import {sub} from "@e280/stz"
-
-  // create a sub fn
-  const onMessage = sub<[string]>()
-
-  // subscribe to it
-  onMessage(m => console.log(m))
-
-  // publish to it
-  onMessage.pub("hello")
-  ```
-- the pub and sub are the same, but have differing invoke signatures
-- i seem to use `sub` more often
-- both have some extra functionality
-  ```ts
-  // pub fns return a promise, to wait for all async subscribers
-  await sendMessage("hello")
-  await onMessage.pub("hello")
-
-  // sub fns return an unsub fn
-  const unsub1 = onMessage(m => console.log(m))
-  unsub1() // unsubscribe that listener
-
-  const unsub2 = sendMessage.sub(m => console.log(m))
-  unsub2() // unsubscribe that listener
-
-  // you can clear all subscribers from a pub or a sub
-  sendMessage.clear()
-  onMessage.clear()
-
-  // you can subscribe to only one next call
-  onMessage.once(m => console.log(m))
-  sendMessage.once(m => console.log(m))
-  ```
-
-<br/>
-
-## 💖 made with open source love
-reward us with github stars  
-build with us at https://e280.org/ but only if you're cool  
-

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/barname/badge.ts

@@ -1,78 +0,0 @@
-
-import {Hex} from "../hex.js"
-import {Base58} from "../base58.js"
-import {Barname} from "./barname.js"
-
-/**
- * Badge is a human-friendly presentation format for arbitrary binary data.
- *  - looks like "nomluc_rigpem.tg2bjNkjMh1H6M2b2EhD5V4x6XAqx9wyWddsBt"
- *  - the first bytes are shown in barname format
- *  - the rest of the data is in base58
- *  - designed to be a nice way to present 256-bit passport thumbprints
- *  - can be used for data of different lengths
- *  - preview size can be customized as 'leadCount', which defaults to 4
- */
-export class Badge {
-	static readonly separator = "."
-	static readonly defaultLeadCount = 4
-
-	readonly hex: string
-	readonly string: string
-	readonly preview: string
-
-	constructor(
-			public readonly bytes: Uint8Array,
-			public readonly leadCount = Badge.defaultLeadCount,
-		) {
-
-		if (leadCount < 1)
-			throw new Error(`badge leadCount must be greater than 0 (was ${leadCount})`)
-
-		this.hex = Hex.string(this.bytes)
-		this.preview = Barname.string(this.bytes.slice(0, leadCount))
-
-		this.string = (bytes.length > leadCount)
-			? `${this.preview}.${Base58.string(this.bytes.slice(leadCount))}`
-			: this.preview
-	}
-
-	static parse(badge: string) {
-		const [barname, b58] = badge.split(Badge.separator)
-
-		// badge has a base58 component
-		if (b58) {
-			const appetizer = Barname.bytes(barname)
-			const entree = Base58.bytes(b58)
-			const bytes = new Uint8Array([...appetizer, ...entree])
-			return new this(bytes, appetizer.length)
-		}
-
-		// badge is just a barname (no base58 part)
-		else {
-			const bytes = Barname.bytes(barname)
-			return new this(bytes, bytes.length)
-		}
-	}
-
-	static fromHex(hex: string, leadCount = this.defaultLeadCount) {
-		const bytes = Hex.bytes(hex)
-		return new this(bytes, leadCount)
-	}
-
-	static string(bytes: Uint8Array, leadCount = this.defaultLeadCount) {
-		return new this(bytes, leadCount).string
-	}
-
-	static bytes(badge: string) {
-		return this.parse(badge)
-	}
-
-	static hex(badge: string) {
-		return this.parse(badge).hex
-	}
-
-	toString() {
-		return this.string
-	}
-}
-

package/s/data/barname/demo.ts

@@ -1,49 +0,0 @@
-
-import {Hex} from "../hex.js"
-import {Badge} from "./badge.js"
-import {Bytes} from "../bytes.js"
-import {Barname} from "./barname.js"
-
-for (const _ of Array(2)) {
-	const string = Barname.random(34)
-	const bytes = Barname.bytes(string)
-	const string2 = Barname.string(bytes)
-	console.log(string.replaceAll(" ", "\n"))
-	if (string !== string2)
-		throw new Error("barname fails equality check")
-	console.log("")
-}
-
-for (const _ of Array(10)) {
-	const bytes = Bytes.random(32)
-	const badge = new Badge(bytes)
-	const bytes2 = badge.bytes
-	console.log(badge.string)
-	if (Hex.string(bytes) !== Hex.string(bytes2))
-		throw new Error("badge fails equality check")
-}
-
-{
-	console.log("")
-	const alpha = `
-		dacsyd_labdun_fipsub_bonmel
-		fitlys_rovbud_sipnel_sonryx
-		sitrem_lasdyr_dovpun_nibwep
-		tippet_mapnub_ticnet_famset
-		wanteg
-	`
-	const bravo = `
-		dacsyd-labdun-fipsub-bonmel;
-		[fitlys rovbud sipnel sonryx]
-		sitrem/lasdyr/dovpun/nibwep
-		tippet+mapnub+ticnet+famset
-		wanteg++
-	`
-	const alphaHex = Hex.string(Barname.bytes(alpha))
-	const bravoHex = Hex.string(Barname.bytes(bravo))
-	if (alphaHex.length === 68 && alphaHex === bravoHex)
-		console.log("*barname parsing appears resilient to whitespace and garbage*")
-	else
-		throw new Error("barname resiliency failure")
-}
-

package/s/data/barname/index.ts

@@ -1,4 +0,0 @@
-
-export * from "./barname.js"
-export * from "./badge.js"
-

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;
-}>;

package/x/data/anka.js

@@ -1,53 +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) {
-        return [...bytes]
-            .map(int => characters.at(int))
-            .join("");
-    },
-    bytes(code) {
-        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));
-    },
-});
-//# sourceMappingURL=anka.js.map

package/x/data/anka.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"anka.js","sourceRoot":"","sources":["../../s/data/anka.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;EAgBE;AAEF,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAA;AAEhC,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC;QAC9B,aAAa;QACb,GAAG,8CAA8C;QAEjD,QAAQ;QACR,GAAG,gCAAgC;QAEnC,UAAU;QACV,GAAG,2CAA2C;QAE9C,WAAW;QACX,GAAG,0CAA0C;QAE7C,YAAY;QACZ,GAAG,gDAAgD;QAEnD,WAAW;QACX,GAAG,4CAA4C;QAE/C,OAAO;QACP,GAAG,4CAA4C;KAC/C,CAAC,CAAC,CAAA;AAEH,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC;IAEjC,MAAM,CAAC,KAAiB;QACvB,OAAO,CAAC,GAAG,KAAK,CAAC;aACf,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;aAC9B,IAAI,CAAC,EAAE,CAAC,CAAA;IACX,CAAC;IAED,KAAK,CAAC,IAAY;QACjB,OAAO,IAAI,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YACtC,IAAI,KAAK,KAAK,CAAC,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,GAAG,CAAC,CAAA;YACpD,OAAO,KAAK,CAAA;QACb,CAAC,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,GAAG,EAAE;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IACxC,CAAC;CACD,CAAC,CAAA"}

package/x/data/barname/badge.d.ts

@@ -1,25 +0,0 @@
-/**
- * Badge is a human-friendly presentation format for arbitrary binary data.
- *  - looks like "nomluc_rigpem.tg2bjNkjMh1H6M2b2EhD5V4x6XAqx9wyWddsBt"
- *  - the first bytes are shown in barname format
- *  - the rest of the data is in base58
- *  - designed to be a nice way to present 256-bit passport thumbprints
- *  - can be used for data of different lengths
- *  - preview size can be customized as 'leadCount', which defaults to 4
- */
-export declare class Badge {
-    readonly bytes: Uint8Array;
-    readonly leadCount: number;
-    static readonly separator = ".";
-    static readonly defaultLeadCount = 4;
-    readonly hex: string;
-    readonly string: string;
-    readonly preview: string;
-    constructor(bytes: Uint8Array, leadCount?: number);
-    static parse(badge: string): Badge;
-    static fromHex(hex: string, leadCount?: number): Badge;
-    static string(bytes: Uint8Array, leadCount?: number): string;
-    static bytes(badge: string): Badge;
-    static hex(badge: string): string;
-    toString(): string;
-}