@e280/stz 0.2.33 → 0.2.34

package/README.md

@@ -186,9 +186,9 @@ import {disposer} from "@e280/stz"
     [2, "world"],
   ])
   ```
-- `map.require(key)` — returns the value for key.. if missing, throw an error
+- `map.need(key)` — returns the value for key.. if missing, throw an error
   ```ts
-  const value = map.require(1)
+  const value = map.need(1)
     // "hello"
   ```
 - `map.guarantee(key, makeFn)` — returns the value for `key`.. if missing, run `makeFn` to set and return the value
@@ -206,7 +206,7 @@ import {disposer} from "@e280/stz"
 #### GWeakMap
 > extended js WeakMap
 - `new GWeakMap<K, V>()`
-- `weakMap.require(key)` — returns value for key.. if missing, throw an error
+- `weakMap.need(key)` — returns value for key.. if missing, throw an error
 - `weakMap.guarantee(key, makeFn)` — returns the value for key.. if missing, run `makeFn` to set and return the value
 
 

package/package.json

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

package/s/g/map.ts

@@ -1,11 +1,11 @@
 
 /** extended js map with handy methods like `require` and `guarantee` */
 export class GMap<K, V> extends Map<K, V> {
-	static require<K, V>(map: Map<K, V>, key: K) {
+	static need<K, V>(map: Map<K, V>, key: K) {
 		if (map.has(key))
 			return map.get(key) as V
 		else
-			throw new Error(`required key not found: "${key}"`)
+			throw new Error(`needed key not found: "${key}"`)
 	}
 
 	static guarantee<K, V>(map: Map<K, V>, key: K, make: () => V) {
@@ -22,13 +22,26 @@ export class GMap<K, V> extends Map<K, V> {
 		return [...this]
 	}
 
-	require(key: K) {
-		return GMap.require(this, key)
+	need(key: K) {
+		return GMap.need(this, key)
 	}
 
 	guarantee(key: K, make: () => V) {
 		return GMap.guarantee(this, key, make)
 	}
+
+	/** @deprecated renamed to `need` */
+	require(key: K) {
+		return GMap.require(this, key)
+	}
+
+	/** @deprecated renamed to `need` */
+	static require<K, V>(map: Map<K, V>, key: K) {
+		if (map.has(key))
+			return map.get(key) as V
+		else
+			throw new Error(`required key not found: "${key}"`)
+	}
 }
 
 /** @deprecated renamed to `GMap` */

package/s/g/weak-map.ts

@@ -1,11 +1,11 @@
 
 /** extended weak map with handy methods like `require` and `guarantee` */
 export class GWeakMap<K extends WeakKey, V> extends WeakMap<K, V> {
-	static require<K extends WeakKey, V>(map: WeakMap<K, V>, key: K) {
+	static need<K extends WeakKey, V>(map: WeakMap<K, V>, key: K) {
 		if (map.has(key))
 			return map.get(key) as V
 		else
-			throw new Error(`required key not found`)
+			throw new Error(`needed key not found`)
 	}
 
 	static guarantee<K extends WeakKey, V>(map: WeakMap<K, V>, key: K, make: () => V) {
@@ -18,13 +18,26 @@ export class GWeakMap<K extends WeakKey, V> extends WeakMap<K, V> {
 		}
 	}
 
-	require(key: K) {
-		return GWeakMap.require(this, key)
+	need(key: K) {
+		return GWeakMap.need(this, key)
 	}
 
 	guarantee(key: K, make: () => V) {
 		return GWeakMap.guarantee(this, key, make)
 	}
+
+	/** @deprecated renamed to `need` */
+	require(key: K) {
+		return GWeakMap.require(this, key)
+	}
+
+	/** @deprecated renamed to `need` */
+	static require<K extends WeakKey, V>(map: WeakMap<K, V>, key: K) {
+		if (map.has(key))
+			return map.get(key) as V
+		else
+			throw new Error(`required key not found`)
+	}
 }
 
 /** @deprecated renamed to `GWeakMap` */

package/x/g/map.d.ts

@@ -1,10 +1,14 @@
 /** extended js map with handy methods like `require` and `guarantee` */
 export declare class GMap<K, V> extends Map<K, V> {
-    static require<K, V>(map: Map<K, V>, key: K): V;
+    static need<K, V>(map: Map<K, V>, key: K): V;
     static guarantee<K, V>(map: Map<K, V>, key: K, make: () => V): V;
     array(): [K, V][];
-    require(key: K): V;
+    need(key: K): V;
     guarantee(key: K, make: () => V): V;
+    /** @deprecated renamed to `need` */
+    require(key: K): V;
+    /** @deprecated renamed to `need` */
+    static require<K, V>(map: Map<K, V>, key: K): V;
 }
 /** @deprecated renamed to `GMap` */
 export declare const MapG: typeof GMap;

package/x/g/map.js

@@ -1,10 +1,10 @@
 /** extended js map with handy methods like `require` and `guarantee` */
 export class GMap extends Map {
-    static require(map, key) {
+    static need(map, key) {
         if (map.has(key))
             return map.get(key);
         else
-            throw new Error(`required key not found: "${key}"`);
+            throw new Error(`needed key not found: "${key}"`);
     }
     static guarantee(map, key, make) {
         if (map.has(key))
@@ -18,12 +18,23 @@ export class GMap extends Map {
     array() {
         return [...this];
     }
-    require(key) {
-        return GMap.require(this, key);
+    need(key) {
+        return GMap.need(this, key);
     }
     guarantee(key, make) {
         return GMap.guarantee(this, key, make);
     }
+    /** @deprecated renamed to `need` */
+    require(key) {
+        return GMap.require(this, key);
+    }
+    /** @deprecated renamed to `need` */
+    static require(map, key) {
+        if (map.has(key))
+            return map.get(key);
+        else
+            throw new Error(`required key not found: "${key}"`);
+    }
 }
 /** @deprecated renamed to `GMap` */
 export const MapG = GMap;

package/x/g/map.js.map

@@ -1 +1 @@
-{"version":3,"file":"map.js","sourceRoot":"","sources":["../../s/g/map.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,CAAM,CAAA;;YAExB,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;AAED,oCAAoC;AACpC,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAA"}
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../s/g/map.ts"],"names":[],"mappings":"AACA,wEAAwE;AACxE,MAAM,OAAO,IAAW,SAAQ,GAAS;IACxC,MAAM,CAAC,IAAI,CAAO,GAAc,EAAE,GAAM;QACvC,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;YACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAM,CAAA;;YAExB,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,GAAG,CAAC,CAAA;IACnD,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,IAAI,CAAC,GAAM;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAC5B,CAAC;IAED,SAAS,CAAC,GAAM,EAAE,IAAa;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;IACvC,CAAC;IAED,oCAAoC;IACpC,OAAO,CAAC,GAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED,oCAAoC;IACpC,MAAM,CAAC,OAAO,CAAO,GAAc,EAAE,GAAM;QAC1C,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;YACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAM,CAAA;;YAExB,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,GAAG,CAAC,CAAA;IACrD,CAAC;CACD;AAED,oCAAoC;AACpC,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAA"}

package/x/g/weak-map.d.ts

@@ -1,9 +1,13 @@
 /** extended weak map with handy methods like `require` and `guarantee` */
 export declare class GWeakMap<K extends WeakKey, V> extends WeakMap<K, V> {
-    static require<K extends WeakKey, V>(map: WeakMap<K, V>, key: K): V;
+    static need<K extends WeakKey, V>(map: WeakMap<K, V>, key: K): V;
     static guarantee<K extends WeakKey, V>(map: WeakMap<K, V>, key: K, make: () => V): V;
-    require(key: K): V;
+    need(key: K): V;
     guarantee(key: K, make: () => V): V;
+    /** @deprecated renamed to `need` */
+    require(key: K): V;
+    /** @deprecated renamed to `need` */
+    static require<K extends WeakKey, V>(map: WeakMap<K, V>, key: K): V;
 }
 /** @deprecated renamed to `GWeakMap` */
 export declare const WeakMapG: typeof GWeakMap;

package/x/g/weak-map.js

@@ -1,10 +1,10 @@
 /** extended weak map with handy methods like `require` and `guarantee` */
 export class GWeakMap extends WeakMap {
-    static require(map, key) {
+    static need(map, key) {
         if (map.has(key))
             return map.get(key);
         else
-            throw new Error(`required key not found`);
+            throw new Error(`needed key not found`);
     }
     static guarantee(map, key, make) {
         if (map.has(key))
@@ -15,12 +15,23 @@ export class GWeakMap extends WeakMap {
             return value;
         }
     }
-    require(key) {
-        return GWeakMap.require(this, key);
+    need(key) {
+        return GWeakMap.need(this, key);
     }
     guarantee(key, make) {
         return GWeakMap.guarantee(this, key, make);
     }
+    /** @deprecated renamed to `need` */
+    require(key) {
+        return GWeakMap.require(this, key);
+    }
+    /** @deprecated renamed to `need` */
+    static require(map, key) {
+        if (map.has(key))
+            return map.get(key);
+        else
+            throw new Error(`required key not found`);
+    }
 }
 /** @deprecated renamed to `GWeakMap` */
 export const WeakMapG = GWeakMap;

package/x/g/weak-map.js.map

@@ -1 +1 @@
-{"version":3,"file":"weak-map.js","sourceRoot":"","sources":["../../s/g/weak-map.ts"],"names":[],"mappings":"AACA,0EAA0E;AAC1E,MAAM,OAAO,QAA+B,SAAQ,OAAa;IAChE,MAAM,CAAC,OAAO,CAAuB,GAAkB,EAAE,GAAM;QAC9D,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;YACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAM,CAAA;;YAExB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,CAAC,SAAS,CAAuB,GAAkB,EAAE,GAAM,EAAE,IAAa;QAC/E,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,OAAO,CAAC,GAAM;QACb,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IACnC,CAAC;IAED,SAAS,CAAC,GAAM,EAAE,IAAa;QAC9B,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;IAC3C,CAAC;CACD;AAED,wCAAwC;AACxC,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAA"}
+{"version":3,"file":"weak-map.js","sourceRoot":"","sources":["../../s/g/weak-map.ts"],"names":[],"mappings":"AACA,0EAA0E;AAC1E,MAAM,OAAO,QAA+B,SAAQ,OAAa;IAChE,MAAM,CAAC,IAAI,CAAuB,GAAkB,EAAE,GAAM;QAC3D,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;YACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAM,CAAA;;YAExB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;IACzC,CAAC;IAED,MAAM,CAAC,SAAS,CAAuB,GAAkB,EAAE,GAAM,EAAE,IAAa;QAC/E,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,IAAI,CAAC,GAAM;QACV,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAChC,CAAC;IAED,SAAS,CAAC,GAAM,EAAE,IAAa;QAC9B,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;IAC3C,CAAC;IAED,oCAAoC;IACpC,OAAO,CAAC,GAAM;QACb,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IACnC,CAAC;IAED,oCAAoC;IACpC,MAAM,CAAC,OAAO,CAAuB,GAAkB,EAAE,GAAM;QAC9D,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;YACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAM,CAAA;;YAExB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IAC3C,CAAC;CACD;AAED,wCAAwC;AACxC,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAA"}