@e280/stz 0.2.11 → 0.2.13

package/README.md

@@ -111,6 +111,41 @@ await nap(900)
   // wait for 900 milliseconds
 ```
 
+### 🍏 disposer
+> easy trash management
+
+```ts
+import {disposer} from "@e280/stz"
+```
+
+- create a disposer
+    ```ts
+    const dispose = disposer()
+    ```
+- schedule something for cleanup
+    ```ts
+    dispose.schedule(() => console.log("disposed!"))
+    ```
+- schedule multiple things at once
+    ```ts
+    dispose.schedule(
+      () => console.log("disposed thing 1"),
+      () => console.log("disposed thing 2"),
+      () => ev(window, {keydown: () => console.log("keydown")}),
+    )
+    ```
+- schedule is chainable if you prefer that vibe
+    ```ts
+    dispose
+      .schedule(() => console.log("disposed thing 1"))
+      .schedule(() => console.log("disposed thing 2"))
+      .schedule(() => ev(window, {keydown: () => console.log("keydown")}))
+    ```
+- **dispose** of all that garbage
+    ```ts
+    dispose()
+    ```
+
 ### 🍏 G Crew
 > extended js data types
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@e280/stz",
-	"version": "0.2.11",
+	"version": "0.2.13",
 	"description": "everyday ts fns for everything",
 	"license": "MIT",
 	"author": "Chase Moskal <chasemoskal@gmail.com>",
@@ -28,7 +28,7 @@
 	},
 	"devDependencies": {
 		"@e280/science": "^0.1.2",
-		"@types/node": "^24.7.1",
+		"@types/node": "^24.7.2",
 		"npm-run-all": "^4.1.5",
 		"typescript": "^5.9.3"
 	},

package/s/disposer.ts

@@ -1,5 +1,10 @@
 
-export function disposer() {
+export type Disposer = {
+	(): void
+	schedule: (...fns: (() => void)[]) => Disposer
+}
+
+export function disposer(): Disposer {
 	let fns: (() => void)[] = []
 
 	function d() {
@@ -7,8 +12,8 @@ export function disposer() {
 		fns = []
 	}
 
-	d.schedule = (fn: () => void) => {
-		fns.push(fn)
+	d.schedule = (...newFns: (() => void)[]) => {
+		fns.push(...newFns)
 		return d
 	}
 

package/s/pubsub.ts

@@ -24,7 +24,7 @@ export interface Xub<A extends any[] = []> {
 	on(fn: Listener<A>): () => void
 
 	/** wait for the next published value */
-	next(): Promise<A>
+	next(fn?: Listener<A>): Promise<A>
 
 	/** wipe all listeners attached to this. */
 	clear(): void

package/x/disposer.d.ts

@@ -1,4 +1,5 @@
-export declare function disposer(): {
+export type Disposer = {
     (): void;
-    schedule(fn: () => void): /*elided*/ any;
+    schedule: (...fns: (() => void)[]) => Disposer;
 };
+export declare function disposer(): Disposer;

package/x/disposer.js

@@ -5,8 +5,8 @@ export function disposer() {
             fn();
         fns = [];
     }
-    d.schedule = (fn) => {
-        fns.push(fn);
+    d.schedule = (...newFns) => {
+        fns.push(...newFns);
         return d;
     };
     return d;

package/x/disposer.js.map

@@ -1 +1 @@
-{"version":3,"file":"disposer.js","sourceRoot":"","sources":["../s/disposer.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,QAAQ;IACvB,IAAI,GAAG,GAAmB,EAAE,CAAA;IAE5B,SAAS,CAAC;QACT,KAAK,MAAM,EAAE,IAAI,GAAG;YAAE,EAAE,EAAE,CAAA;QAC1B,GAAG,GAAG,EAAE,CAAA;IACT,CAAC;IAED,CAAC,CAAC,QAAQ,GAAG,CAAC,EAAc,EAAE,EAAE;QAC/B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACZ,OAAO,CAAC,CAAA;IACT,CAAC,CAAA;IAED,OAAO,CAAC,CAAA;AACT,CAAC"}
+{"version":3,"file":"disposer.js","sourceRoot":"","sources":["../s/disposer.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,QAAQ;IACvB,IAAI,GAAG,GAAmB,EAAE,CAAA;IAE5B,SAAS,CAAC;QACT,KAAK,MAAM,EAAE,IAAI,GAAG;YAAE,EAAE,EAAE,CAAA;QAC1B,GAAG,GAAG,EAAE,CAAA;IACT,CAAC;IAED,CAAC,CAAC,QAAQ,GAAG,CAAC,GAAG,MAAsB,EAAE,EAAE;QAC1C,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;QACnB,OAAO,CAAC,CAAA;IACT,CAAC,CAAA;IAED,OAAO,CAAC,CAAA;AACT,CAAC"}

package/x/pubsub.d.ts

@@ -14,7 +14,7 @@ export interface Xub<A extends any[] = []> {
      */
     on(fn: Listener<A>): () => void;
     /** wait for the next published value */
-    next(): Promise<A>;
+    next(fn?: Listener<A>): Promise<A>;
     /** wipe all listeners attached to this. */
     clear(): void;
 }