@e280/stz 0.0.0-33 → 0.0.0-35

package/README.md

@@ -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"
@@ -121,7 +121,7 @@ import {pub, sub} from "@e280/stz"
 
 <br/>
 
-## 🧰 FN TOOLS
+## 🧰 STZ FN TOOLS
 
 ### 🍏 `queue(fn)`
 > execute calls in sequence (not concurrent)
@@ -178,7 +178,7 @@ we use `debounce` a lot in ui code, like on a user's keyboard input in a form fi
 import {debounce} from "@e280/stz"
 
 const fn = debounce(100, async() => {
-  await coolSlowActionOrWhatever()
+  await coolAction()
 })
 
 // each fn() call resets the timer
@@ -186,7 +186,7 @@ fn()
 fn()
 fn()
 
-// coolSlowActionOrWhatever, the others are redundant
+// coolAction is only called once here, other calls are redundant
 ```
 
 ### 🍏 `repeat(fn)`
@@ -211,7 +211,7 @@ stop()
 
 <br/>
 
-## 🧰 DATA UTILITIES
+## 🧰 STZ DATA UTILITIES
 
 ### 🍏 Hex
 > convert to/from hexadecimal string format

package/package.json

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

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