@e280/stz 0.0.0-35 → 0.0.0-37

package/README.md

@@ -1,5 +1,5 @@
 
-# `@e280/stz`
+# 🏂 `@e280/stz`
 
 **stz** is e280's standard library of environment-agnostic typescript tools.
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@e280/stz",
-	"version": "0.0.0-35",
+	"version": "0.0.0-37",
 	"description": "everyday ts fns for everything",
 	"license": "MIT",
 	"author": "Chase Moskal <chasemoskal@gmail.com>",
@@ -27,7 +27,7 @@
 	},
 	"devDependencies": {
 		"@e280/science": "^0.0.6",
-		"@types/node": "^24.2.0",
+		"@types/node": "^24.3.0",
 		"npm-run-all": "^4.1.5",
 		"typescript": "^5.9.2"
 	},

package/s/constructor.ts

@@ -0,0 +1,3 @@
+
+export type Constructor<T extends {} = {}> = new(...args: any[]) => T
+

package/s/index.ts

@@ -17,6 +17,7 @@ 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.js"
@@ -32,8 +33,10 @@ export * from "./nap.js"
 export * from "./ob.js"
 export * from "./once.js"
 export * from "./pipe.js"
-export * from "./repeat.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/pipe.ts

@@ -1,20 +1,19 @@
 
-export type PipeFun<I, O> = (input: I) => O
+export type Piper<I, O> = (input: I) => O
 
-export class Pipe<I> {
-
-	static with<I>(input: I) {
-		return new this(input)
-	}
+export function pipe<I>(input: I) {
+	return new Pipe(input)
+}
 
+export class Pipe<I> {
 	#input: I
 
 	constructor(input: I) {
 		this.#input = input
 	}
 
-	to<O>(fun: PipeFun<I, O>) {
-		return new Pipe(fun(this.#input))
+	to<O>(fn: Piper<I, O>) {
+		return new Pipe(fn(this.#input))
 	}
 
 	done() {

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

@@ -0,0 +1,22 @@
+
+export type TemplateParts = {
+	strings: TemplateStringsArray
+	values: any[]
+}
+
+export function templateParts(
+		strings: TemplateStringsArray,
+		...values: any[]
+	): TemplateParts {
+
+	return {strings, values}
+}
+
+export function templateString(strings: TemplateStringsArray, ...values: any[]) {
+	const lastIndex = strings.length - 1
+	return strings
+		.slice(0, lastIndex)
+		.reduce((a, b, c) => a + b + values[c], "")
+			+ strings[lastIndex]
+}
+

package/x/constructor.d.ts

@@ -0,0 +1 @@
+export type Constructor<T extends {} = {}> = new (...args: any[]) => T;

package/x/constructor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=constructor.js.map

package/x/constructor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructor.js","sourceRoot":"","sources":["../s/constructor.ts"],"names":[],"mappings":""}

package/x/index.d.ts

@@ -12,6 +12,7 @@ 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.js";
@@ -27,7 +28,9 @@ export * from "./nap.js";
 export * from "./ob.js";
 export * from "./once.js";
 export * from "./pipe.js";
-export * from "./repeat.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

@@ -12,6 +12,7 @@ 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.js";
@@ -27,8 +28,10 @@ export * from "./nap.js";
 export * from "./ob.js";
 export * from "./once.js";
 export * from "./pipe.js";
-export * from "./repeat.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,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,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"}
+{"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/pipe.d.ts

@@ -1,8 +1,8 @@
-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>;
     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,13 @@
+export function pipe(input) {
+    return new Pipe(input);
+}
 export class Pipe {
-    static with(input) {
-        return new this(input);
-    }
     #input;
     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;IAET,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;CACD"}

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

package/x/templating.d.ts

@@ -0,0 +1,6 @@
+export type TemplateParts = {
+    strings: TemplateStringsArray;
+    values: any[];
+};
+export declare function templateParts(strings: TemplateStringsArray, ...values: any[]): TemplateParts;
+export declare function templateString(strings: TemplateStringsArray, ...values: any[]): string;

package/x/templating.js

@@ -0,0 +1,11 @@
+export function templateParts(strings, ...values) {
+    return { strings, values };
+}
+export function templateString(strings, ...values) {
+    const lastIndex = strings.length - 1;
+    return strings
+        .slice(0, lastIndex)
+        .reduce((a, b, c) => a + b + values[c], "")
+        + strings[lastIndex];
+}
+//# sourceMappingURL=templating.js.map

package/x/templating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templating.js","sourceRoot":"","sources":["../s/templating.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,aAAa,CAC3B,OAA6B,EAC7B,GAAG,MAAa;IAGjB,OAAO,EAAC,OAAO,EAAE,MAAM,EAAC,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAA6B,EAAE,GAAG,MAAa;IAC7E,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAA;IACpC,OAAO,OAAO;SACZ,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;SACnB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;UACxC,OAAO,CAAC,SAAS,CAAC,CAAA;AACvB,CAAC"}