@e280/stz 0.0.0-28 → 0.0.0-29

package/README.md

@@ -74,9 +74,9 @@ standard library of environment-agnostic typescript functions we use basically e
   sendMessage.clear()
   onMessage.clear()
 
-  // you can subscribe to only one next call
-  onMessage.once(m => console.log(m))
-  sendMessage.once(m => console.log(m))
+  // instead of a 'once' fn we simply await next()
+  await onMessage.next()
+  await sendMessage.next()
   ```
 
 <br/>

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@e280/stz",
-	"version": "0.0.0-28",
+	"version": "0.0.0-29",
 	"description": "everyday ts fns for everything",
 	"license": "MIT",
 	"author": "Chase Moskal <chasemoskal@gmail.com>",
@@ -24,7 +24,7 @@
 	},
 	"devDependencies": {
 		"@e280/science": "^0.0.5",
-		"@types/node": "^24.0.7",
+		"@types/node": "^24.1.0",
 		"npm-run-all": "^4.1.5",
 		"typescript": "^5.8.3"
 	},

package/s/defer.ts

@@ -1,6 +1,6 @@
 
 /** a promise which can be resolved from the outside */
-export type Deferred<R> = {
+export type Deferred<R = void> = {
 	promise: Promise<R>
 	resolve: (result: R) => void
 	reject: (reason: any) => void
@@ -10,7 +10,7 @@ export type Deferred<R> = {
 }
 
 /** returns a deferred promise with exposed resolve and reject fns */
-export function defer<R>(): Deferred<R> {
+export function defer<R = void>(): Deferred<R> {
 	let resolve!: (result: R) => void
 	let reject!: (reason: any) => void
 

package/s/ev.ts

@@ -0,0 +1,20 @@
+
+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 function ev<N extends string>(target: EvTarget<N>, fns: Record<N, EvFn>) {
+	const entries = Object.entries(fns) as [N, EvFn][]
+
+	for (const [name, fn] of entries)
+		target.addEventListener(name, fn)
+
+	return () => {
+		for (const [name, fn] of entries)
+			target.removeEventListener(name, fn)
+	}
+}
+

package/s/index.ts

@@ -20,6 +20,7 @@ export * from "./dedupe.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"
@@ -27,8 +28,9 @@ 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 "./repeatly.js"
+export * from "./repeat.js"
 export * from "./pubsub.js"
 export * from "./time.js"
 export * from "./trash.js"

package/s/once.ts

@@ -0,0 +1,14 @@
+
+export function once<Fn extends (...a: any[]) => any>(fn: Fn) {
+	let done = false
+	let ret: any
+
+	return ((...a) => {
+		if (!done) {
+			done = true
+			ret = fn(...a)
+		}
+		return ret
+	}) as Fn
+}
+

package/s/pubsub.ts

@@ -17,8 +17,8 @@ export interface Xub<A extends any[] = []> {
 	 */
 	on(fn: Listener<A>): () => void
 
-	/** subscribe a listener function that unsubscribes itself after being invoked. */
-	once(): Promise<A>
+	/** wait for the next published value */
+	next(): Promise<A>
 
 	/** wipe all listeners attached to this. */
 	clear(): void
@@ -46,7 +46,7 @@ export function xub<A extends any[] = []>() {
 		await Promise.all([...set].map(fn => fn(...a)))
 	}
 
-	async function once() {
+	async function next() {
 		const {promise, resolve} = defer<A>()
 		const unsubscribe = sub((...a) => {
 			resolve(a)
@@ -62,13 +62,13 @@ export function xub<A extends any[] = []>() {
 	sub.pub = pub
 	sub.sub = sub
 	sub.on = sub
-	sub.once = once
+	sub.next = next
 	sub.clear = clear
 
 	pub.pub = pub
 	pub.sub = sub
 	pub.on = sub
-	pub.once = once
+	pub.next = next
 	pub.clear = clear
 
 	return [pub, sub] as [Pub<A>, Sub<A>]

package/s/repeat.ts

@@ -0,0 +1,25 @@
+
+/**
+ * repeat the given async function over and over.
+ *  - consider using `nap` in your fn to create a delay
+ */
+export function repeat(fn: (stop: () => void) => Promise<void>) {
+	let timeout: any
+	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
+}
+

package/x/defer.d.ts

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

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/index.d.ts

@@ -16,6 +16,7 @@ export * from "./dedupe.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";
@@ -23,8 +24,9 @@ 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 "./repeatly.js";
+export * from "./repeat.js";
 export * from "./pubsub.js";
 export * from "./time.js";
 export * from "./trash.js";

package/x/index.js

@@ -16,6 +16,7 @@ export * from "./dedupe.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";
@@ -23,8 +24,9 @@ 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 "./repeatly.js";
+export * from "./repeat.js";
 export * from "./pubsub.js";
 export * from "./time.js";
 export * from "./trash.js";

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,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,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,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,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,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,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,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,WAAW,CAAA;AACzB,cAAc,YAAY,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/pubsub.d.ts

@@ -9,8 +9,8 @@ export interface Xub<A extends any[] = []> {
      * @alias sub
      */
     on(fn: Listener<A>): () => void;
-    /** subscribe a listener function that unsubscribes itself after being invoked. */
-    once(): Promise<A>;
+    /** wait for the next published value */
+    next(): Promise<A>;
     /** wipe all listeners attached to this. */
     clear(): void;
 }

package/x/pubsub.js

@@ -8,7 +8,7 @@ export function xub() {
     async function pub(...a) {
         await Promise.all([...set].map(fn => fn(...a)));
     }
-    async function once() {
+    async function next() {
         const { promise, resolve } = defer();
         const unsubscribe = sub((...a) => {
             resolve(a);
@@ -22,12 +22,12 @@ export function xub() {
     sub.pub = pub;
     sub.sub = sub;
     sub.on = sub;
-    sub.once = once;
+    sub.next = next;
     sub.clear = clear;
     pub.pub = pub;
     pub.sub = sub;
     pub.on = sub;
-    pub.once = once;
+    pub.next = next;
     pub.clear = clear;
     return [pub, sub];
 }

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/s/repeatly.ts

@@ -1,19 +0,0 @@
-
-export function repeatly(milliseconds: number, fn: () => Promise<void>) {
-	let timeout: any
-	let stop = false
-
-	async function tick() {
-		if (stop) return undefined
-		await fn()
-		timeout = setTimeout(tick, milliseconds)
-	}
-
-	timeout = setTimeout(tick, milliseconds)
-
-	return () => {
-		stop = true
-		clearTimeout(timeout)
-	}
-}
-

package/x/repeatly.d.ts

@@ -1 +0,0 @@
-export declare function repeatly(milliseconds: number, fn: () => Promise<void>): () => void;

package/x/repeatly.js

@@ -1,16 +0,0 @@
-export function repeatly(milliseconds, fn) {
-    let timeout;
-    let stop = false;
-    async function tick() {
-        if (stop)
-            return undefined;
-        await fn();
-        timeout = setTimeout(tick, milliseconds);
-    }
-    timeout = setTimeout(tick, milliseconds);
-    return () => {
-        stop = true;
-        clearTimeout(timeout);
-    };
-}
-//# sourceMappingURL=repeatly.js.map

package/x/repeatly.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"repeatly.js","sourceRoot":"","sources":["../s/repeatly.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,QAAQ,CAAC,YAAoB,EAAE,EAAuB;IACrE,IAAI,OAAY,CAAA;IAChB,IAAI,IAAI,GAAG,KAAK,CAAA;IAEhB,KAAK,UAAU,IAAI;QAClB,IAAI,IAAI;YAAE,OAAO,SAAS,CAAA;QAC1B,MAAM,EAAE,EAAE,CAAA;QACV,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;IACzC,CAAC;IAED,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;IAExC,OAAO,GAAG,EAAE;QACX,IAAI,GAAG,IAAI,CAAA;QACX,YAAY,CAAC,OAAO,CAAC,CAAA;IACtB,CAAC,CAAA;AACF,CAAC"}