@e280/stz 0.0.0-34 → 0.0.0-36

package/README.md

@@ -1,5 +1,5 @@
 
-# `@e280/stz`
+# 🏂 `@e280/stz`
 
 **stz** is e280's standard library of environment-agnostic typescript tools.
 
@@ -23,12 +23,12 @@ const map = new MapG<number, string>([
 ])
 ```
 
-- `map.require(key)` — throws error if the value is undefined
+- `map.require(key)` — returns the value for key — if missing, throw an error
   ```ts
   const value = map.require(1)
     // "hello"
   ```
-- `map.guarantee(key, make)` — returns the value for `key`, but if undefined, run `make` to set the value
+- `map.guarantee(key, make)` — returns the value for `key` — if missing, run `make` to set the value and return it
   ```ts
   const value = map.guarantee(3, () => "rofl")
     // "rofl"

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@e280/stz",
-	"version": "0.0.0-34",
+	"version": "0.0.0-36",
 	"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,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 "./templating.js"
 export * from "./time.js"
 export * from "./trash.js"
 

package/s/map-g.ts

@@ -2,21 +2,20 @@
 /** extended js map with handy methods like `require` and `guarantee` */
 export class MapG<K, V> extends Map<K, V> {
 	static require<K, V>(map: Map<K, V>, key: K) {
-		const value = map.get(key)
-		if (value === undefined)
+		if (map.has(key))
+			return map.get(key)!
+		else
 			throw new Error(`required key not found: "${key}"`)
-		return value as V
 	}
 
 	static guarantee<K, V>(map: Map<K, V>, key: K, make: () => V) {
-		let value = map.get(key)
-
-		if (value === undefined) {
-			value = make()
+		if (map.has(key))
+			return map.get(key)!
+		else {
+			const value = make()
 			map.set(key, value)
+			return value
 		}
-
-		return value
 	}
 
 	array() {

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/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,8 @@ 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 "./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,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 "./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,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA"}

package/x/map-g.d.ts

@@ -1,9 +1,9 @@
 /** extended js map with handy methods like `require` and `guarantee` */
 export declare class MapG<K, V> extends Map<K, V> {
-    static require<K, V>(map: Map<K, V>, key: K): V;
+    static require<K, V>(map: Map<K, V>, key: K): NonNullable<V>;
     static guarantee<K, V>(map: Map<K, V>, key: K, make: () => V): V;
     array(): [K, V][];
-    require(key: K): V;
+    require(key: K): NonNullable<V>;
     guarantee(key: K, make: () => V): V;
 }
 export type Identifiable<Id = any> = {

package/x/map-g.js

@@ -1,18 +1,19 @@
 /** extended js map with handy methods like `require` and `guarantee` */
 export class MapG extends Map {
     static require(map, key) {
-        const value = map.get(key);
-        if (value === undefined)
+        if (map.has(key))
+            return map.get(key);
+        else
             throw new Error(`required key not found: "${key}"`);
-        return value;
     }
     static guarantee(map, key, make) {
-        let value = map.get(key);
-        if (value === undefined) {
-            value = make();
+        if (map.has(key))
+            return map.get(key);
+        else {
+            const value = make();
             map.set(key, value);
+            return value;
         }
-        return value;
     }
     array() {
         return [...this];

package/x/map-g.js.map

@@ -1 +1 @@
-{"version":3,"file":"map-g.js","sourceRoot":"","sources":["../s/map-g.ts"],"names":[],"mappings":"AACA,wEAAwE;AACxE,MAAM,OAAO,IAAW,SAAQ,GAAS;IACxC,MAAM,CAAC,OAAO,CAAO,GAAc,EAAE,GAAM;QAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC1B,IAAI,KAAK,KAAK,SAAS;YACtB,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,GAAG,CAAC,CAAA;QACpD,OAAO,KAAU,CAAA;IAClB,CAAC;IAED,MAAM,CAAC,SAAS,CAAO,GAAc,EAAE,GAAM,EAAE,IAAa;QAC3D,IAAI,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAExB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,KAAK,GAAG,IAAI,EAAE,CAAA;YACd,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACpB,CAAC;QAED,OAAO,KAAK,CAAA;IACb,CAAC;IAED,KAAK;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;IACjB,CAAC;IAED,OAAO,CAAC,GAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED,SAAS,CAAC,GAAM,EAAE,IAAa;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;IACvC,CAAC;CACD;AAID,oDAAoD;AACpD,MAAM,OAAO,KAA8B,SAAQ,IAAgB;IAClE,GAAG,CAAC,KAAQ;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC1B,CAAC;IAED,GAAG,CAAC,KAAQ;QACX,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;QACzB,OAAO,KAAK,CAAA;IACb,CAAC;IAED,MAAM,CAAC,KAAQ;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC7B,CAAC;CACD"}
+{"version":3,"file":"map-g.js","sourceRoot":"","sources":["../s/map-g.ts"],"names":[],"mappings":"AACA,wEAAwE;AACxE,MAAM,OAAO,IAAW,SAAQ,GAAS;IACxC,MAAM,CAAC,OAAO,CAAO,GAAc,EAAE,GAAM;QAC1C,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;YACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAE,CAAA;;YAEpB,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,GAAG,CAAC,CAAA;IACrD,CAAC;IAED,MAAM,CAAC,SAAS,CAAO,GAAc,EAAE,GAAM,EAAE,IAAa;QAC3D,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;YACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAE,CAAA;aAChB,CAAC;YACL,MAAM,KAAK,GAAG,IAAI,EAAE,CAAA;YACpB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACnB,OAAO,KAAK,CAAA;QACb,CAAC;IACF,CAAC;IAED,KAAK;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;IACjB,CAAC;IAED,OAAO,CAAC,GAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED,SAAS,CAAC,GAAM,EAAE,IAAa;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;IACvC,CAAC;CACD;AAID,oDAAoD;AACpD,MAAM,OAAO,KAA8B,SAAQ,IAAgB;IAClE,GAAG,CAAC,KAAQ;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC1B,CAAC;IAED,GAAG,CAAC,KAAQ;QACX,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;QACzB,OAAO,KAAK,CAAA;IACb,CAAC;IAED,MAAM,CAAC,KAAQ;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC7B,CAAC;CACD"}

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