@e280/stz 0.0.0-36 → 0.0.0-37

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@e280/stz",
-	"version": "0.0.0-36",
+	"version": "0.0.0-37",
 	"description": "everyday ts fns for everything",
 	"license": "MIT",
 	"author": "Chase Moskal <chasemoskal@gmail.com>",

package/s/index.ts

@@ -35,6 +35,7 @@ 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/s/scope.ts

@@ -0,0 +1,80 @@
+
+export type Scoped<Item> = [item: Item, dispose: () => void]
+export type Disposable = {dispose(): void}
+
+export function scoped<Item>(item: Item, dispose: () => void) {
+	return [item, dispose] as Scoped<Item>
+}
+
+export class Scope {
+	#disposers: (() => void)[] = []
+
+	/** add a dispose fn */
+	add(dispose: () => void) {
+		this.#disposers.push(dispose)
+	}
+
+	/** add a dispose fn, and return the item */
+	reg<Item>(item: Item, dispose: () => void) {
+		this.add(dispose)
+		return item
+	}
+
+	/** add a scoped item's disposer, and return the item */
+	register<Item>([item, dispose]: Scoped<Item>) {
+		this.add(dispose)
+		return item
+	}
+
+	/** register and return disposable item */
+	registerDisposable<Item extends Disposable>(item: Item) {
+		this.#disposers.push(() => item.dispose)
+		return item
+	}
+
+	/** augment a fn to register its returned scoped item */
+	fn<Params extends any[], Item>(fn: (...params: Params) => Scoped<Item>) {
+		return (...a: Params) => {
+			const scoped = fn(...a)
+			return this.register(scoped)
+		}
+	}
+
+	/** augment an async fn to register its returned scoped item */
+	fnAsync<Params extends any[], Item>(fn: (...params: Params) => Promise<Scoped<Item>>) {
+		return async(...a: Params) => {
+			const scoped = await fn(...a)
+			return this.register(scoped)
+		}
+	}
+
+	/** augment a fn to register its returned disposable item */
+	fnDisposable<Params extends any[], Item extends Disposable>(fn: (...params: Params) => Item) {
+		return (...a: Params) => {
+			const scoped = fn(...a)
+			return this.registerDisposable(scoped)
+		}
+	}
+
+	/** augment an async fn to register its returned disposable item */
+	fnAsyncDisposable<Params extends any[], Item extends Disposable>(fn: (...params: Params) => Promise<Item>) {
+		return async(...a: Params) => {
+			const scoped = await fn(...a)
+			return this.registerDisposable(scoped)
+		}
+	}
+
+	/** create a subscope that is registered, so disposing the parent will dispose the children */
+	sub() {
+		const scope = new Scope()
+		return this.reg(scope, () => scope.dispose())
+	}
+
+	/** dispose all the disposers added to this scope */
+	dispose() {
+		for (const fn of this.#disposers.reverse())
+			fn()
+		this.#disposers = []
+	}
+}
+

package/x/index.d.ts

@@ -30,6 +30,7 @@ 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

@@ -30,6 +30,7 @@ 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.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,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,iBAAiB,CAAA;AAC/B,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,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/scope.d.ts

@@ -0,0 +1,28 @@
+export type Scoped<Item> = [item: Item, dispose: () => void];
+export type Disposable = {
+    dispose(): void;
+};
+export declare function scoped<Item>(item: Item, dispose: () => void): Scoped<Item>;
+export declare class Scope {
+    #private;
+    /** add a dispose fn */
+    add(dispose: () => void): void;
+    /** add a dispose fn, and return the item */
+    reg<Item>(item: Item, dispose: () => void): Item;
+    /** add a scoped item's disposer, and return the item */
+    register<Item>([item, dispose]: Scoped<Item>): Item;
+    /** register and return disposable item */
+    registerDisposable<Item extends Disposable>(item: Item): Item;
+    /** augment a fn to register its returned scoped item */
+    fn<Params extends any[], Item>(fn: (...params: Params) => Scoped<Item>): (...a: Params) => Item;
+    /** augment an async fn to register its returned scoped item */
+    fnAsync<Params extends any[], Item>(fn: (...params: Params) => Promise<Scoped<Item>>): (...a: Params) => Promise<Item>;
+    /** augment a fn to register its returned disposable item */
+    fnDisposable<Params extends any[], Item extends Disposable>(fn: (...params: Params) => Item): (...a: Params) => Item;
+    /** augment an async fn to register its returned disposable item */
+    fnAsyncDisposable<Params extends any[], Item extends Disposable>(fn: (...params: Params) => Promise<Item>): (...a: Params) => Promise<Item>;
+    /** create a subscope that is registered, so disposing the parent will dispose the children */
+    sub(): Scope;
+    /** dispose all the disposers added to this scope */
+    dispose(): void;
+}

package/x/scope.js

@@ -0,0 +1,65 @@
+export function scoped(item, dispose) {
+    return [item, dispose];
+}
+export class Scope {
+    #disposers = [];
+    /** add a dispose fn */
+    add(dispose) {
+        this.#disposers.push(dispose);
+    }
+    /** add a dispose fn, and return the item */
+    reg(item, dispose) {
+        this.add(dispose);
+        return item;
+    }
+    /** add a scoped item's disposer, and return the item */
+    register([item, dispose]) {
+        this.add(dispose);
+        return item;
+    }
+    /** register and return disposable item */
+    registerDisposable(item) {
+        this.#disposers.push(() => item.dispose);
+        return item;
+    }
+    /** augment a fn to register its returned scoped item */
+    fn(fn) {
+        return (...a) => {
+            const scoped = fn(...a);
+            return this.register(scoped);
+        };
+    }
+    /** augment an async fn to register its returned scoped item */
+    fnAsync(fn) {
+        return async (...a) => {
+            const scoped = await fn(...a);
+            return this.register(scoped);
+        };
+    }
+    /** augment a fn to register its returned disposable item */
+    fnDisposable(fn) {
+        return (...a) => {
+            const scoped = fn(...a);
+            return this.registerDisposable(scoped);
+        };
+    }
+    /** augment an async fn to register its returned disposable item */
+    fnAsyncDisposable(fn) {
+        return async (...a) => {
+            const scoped = await fn(...a);
+            return this.registerDisposable(scoped);
+        };
+    }
+    /** create a subscope that is registered, so disposing the parent will dispose the children */
+    sub() {
+        const scope = new Scope();
+        return this.reg(scope, () => scope.dispose());
+    }
+    /** dispose all the disposers added to this scope */
+    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":"AAIA,MAAM,UAAU,MAAM,CAAO,IAAU,EAAE,OAAmB;IAC3D,OAAO,CAAC,IAAI,EAAE,OAAO,CAAiB,CAAA;AACvC,CAAC;AAED,MAAM,OAAO,KAAK;IACjB,UAAU,GAAmB,EAAE,CAAA;IAE/B,uBAAuB;IACvB,GAAG,CAAC,OAAmB;QACtB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC9B,CAAC;IAED,4CAA4C;IAC5C,GAAG,CAAO,IAAU,EAAE,OAAmB;QACxC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACjB,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,wDAAwD;IACxD,QAAQ,CAAO,CAAC,IAAI,EAAE,OAAO,CAAe;QAC3C,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACjB,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,0CAA0C;IAC1C,kBAAkB,CAA0B,IAAU;QACrD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACxC,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,wDAAwD;IACxD,EAAE,CAA6B,EAAuC;QACrE,OAAO,CAAC,GAAG,CAAS,EAAE,EAAE;YACvB,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;YACvB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;QAC7B,CAAC,CAAA;IACF,CAAC;IAED,+DAA+D;IAC/D,OAAO,CAA6B,EAAgD;QACnF,OAAO,KAAK,EAAC,GAAG,CAAS,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;YAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;QAC7B,CAAC,CAAA;IACF,CAAC;IAED,4DAA4D;IAC5D,YAAY,CAAgD,EAA+B;QAC1F,OAAO,CAAC,GAAG,CAAS,EAAE,EAAE;YACvB,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;YACvB,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAA;QACvC,CAAC,CAAA;IACF,CAAC;IAED,mEAAmE;IACnE,iBAAiB,CAAgD,EAAwC;QACxG,OAAO,KAAK,EAAC,GAAG,CAAS,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;YAC7B,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAA;QACvC,CAAC,CAAA;IACF,CAAC;IAED,8FAA8F;IAC9F,GAAG;QACF,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAA;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;IAC9C,CAAC;IAED,oDAAoD;IACpD,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"}