@e280/stz 0.3.0-next.0 → 0.3.0

package/README.md

@@ -9,6 +9,38 @@
 
 ## 🥨 stz primitives
 
+### 🍏 utensil fns
+> everyday helper fns
+
+- **got(value)** — throw an error if the value is null or undefined
+    ```ts
+    const value = got(nullableValue)
+    ```
+
+#### map helpers
+- **need(map, key)** — return-or-throw a map value
+    ```ts
+    const value = need(map, "my_key")
+    ```
+- **guarantee(map, key, makeFn)** — get-or-create a map value
+    ```ts
+    const value = guarantee(map, "my_key", () => 123)
+    ```
+- **inserts(map, entries)** — set many entries at once
+    ```ts
+    inserts(map, [["my_key1", 123], ["my_key2", 234]])
+    ```
+
+#### set helpers
+- **adds(set, values)** — add many values at once
+    ```ts
+    adds(set, ["alpha", "bravo", "charlie"])
+    ```
+- **deletes(set, values)** — delete many values at once
+    ```ts
+    deletes(map, ["alpha", "bravo", "charlie"])
+    ```
+
 ### 🍏 `pub` and `sub`
 > ergonomic event emitters
 
@@ -130,7 +162,7 @@ await all(
 ```ts
 import {concurrent} from "@e280/stz"
 
-cons {slept, hello, whatever} = await concurrent({
+const {slept, hello, whatever} = await concurrent({
   slept: nap(500),
   hello: Promise.resolve("hello"),
   whatever: fetch("whatever.json"),
@@ -172,43 +204,6 @@ import {disposer} from "@e280/stz"
     dispose()
     ```
 
-### 🍏 G Crew
-> extended js data types
-
-#### GMap
-> extended js Map
-- many are saying it's *"The Deluxe Mapping Experience"*
-  ```ts
-  import {GMap} from "@e280/stz"
-
-  const map = new GMap<number, string>([
-    [1, "hello"],
-    [2, "world"],
-  ])
-  ```
-- `map.need(key)` — returns the value for key.. if missing, throw an error
-  ```ts
-  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
-  ```ts
-  const value = map.guarantee(3, () => "rofl")
-    // "rofl"
-  ```
-
-#### GSet
-> extended js Set
-- `new GSet<T>()`
-- `set.adds(item1, item2, item3)` — add multiple items without a for-loop
-- `set.deletes(item1, item2, item3)` — add multiple items without a for-loop
-
-#### GWeakMap
-> extended js WeakMap
-- `new GWeakMap<K, V>()`
-- `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
-
 
 
 <br/>

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@e280/stz",
-	"version": "0.3.0-next.0",
+	"version": "0.3.0",
 	"description": "everyday ts fns for everything",
 	"license": "MIT",
 	"author": "Chase Moskal <chasemoskal@gmail.com>",
@@ -23,7 +23,7 @@
 	},
 	"devDependencies": {
 		"@e280/science": "^0.1.11",
-		"@types/node": "^25.7.0",
+		"@types/node": "^25.9.3",
 		"typescript": "^6.0.3"
 	},
 	"keywords": [

package/s/index.ts

@@ -14,6 +14,7 @@ export * from "./deep/index.js"
 export * from "./dig/dig.js"
 
 export * from "./queue/queue.js"
+export * from "./rand/index.js"
 
 export * from "./ok/index.js"
 export * from "./toq/index.js"

package/s/rand/index.ts

@@ -0,0 +1,6 @@
+
+export * from "./rand.js"
+export * from "./seed.js"
+export * from "./types.js"
+export * from "./u32ify.js"
+

package/s/rand/rand.ts

@@ -0,0 +1,78 @@
+
+import {Random} from "./types.js"
+import {u32ify} from "./u32ify.js"
+
+/** facility for doing common random things, like picking a random item from an array. */
+export class Rand {
+	constructor(public random: Random = Math.random) {}
+
+	/** random positive unsigned 32-bit integer. */
+	u32() {
+		return u32ify(this.random())
+	}
+
+	/** randomly returns true given a probability fraction. */
+	roll(chance = 0.5) {
+		return this.random() < chance
+	}
+
+	/** random number between two numbers. */
+	range(min: number, max: number) {
+		return min + (this.random() * (max - min))
+	}
+
+	/** random integer from min to max (inclusive). */
+	integerRange(min: number, max: number) {
+		return min + Math.floor(this.random() * (max - min + 1))
+	}
+
+	/** random array index given an array length. */
+	index(length: number) {
+		return Math.floor(this.random() * length)
+	}
+
+	/** randomly choose one item from the provided array. */
+	pick<T>(array: T[]) {
+		return array[this.index(array.length)]
+	}
+
+	/** randomly select a given number of array items. */
+	select<T>(count: number, array: T[]) {
+		const copy = [...array]
+		if (count >= array.length)
+			return copy
+
+		const selection: T[] = []
+		for (let i = 0; i < count; i++)
+			selection.push(this.yoink(copy))
+		return selection
+	}
+
+	/** remove a random item from the array, and return it. */
+	yoink<T>(array: T[]) {
+		const index = this.index(array.length)
+		const [item] = array.splice(index, 1)
+		return item
+	}
+
+	/** randomly remove the given number of items from the array. */
+	extract<T>(count: number, array: T[]) {
+		const selection: T[] = []
+		for (let i = 0; i < count; i++) {
+			if (array.length === 0)
+				return selection
+			selection.push(this.yoink(array))
+		}
+		return selection
+	}
+
+	/** randomly shuffle an array in-place using fisher-yates. */
+	shuffle<T>(array: T[]) {
+		for (let i = array.length - 1; i > 0; i--) {
+			const j = Math.floor(this.random() * (i + 1))
+			;[array[i], array[j]] = [array[j], array[i]]
+		}
+		return array
+	}
+}
+

package/s/rand/seed.ts

@@ -0,0 +1,20 @@
+
+import {Random} from "./types.js"
+import {u32ify} from "./u32ify.js"
+
+const m = 2147483647
+const a = 48271
+
+export function seed(u32 = u32ify(Math.random())): Random {
+	u32 = (u32 ^ 0x6D2B79F5) + 0x1E35A7BD
+	u32 = ((u32 >>> 0) % m) || 1
+
+	function random() {
+		u32 = (a * u32) % m
+		return u32 / m
+	}
+
+	random()
+	return random
+}
+

package/s/rand/types.ts

@@ -0,0 +1,4 @@
+
+/** fn that returns random number fraction between 0 and 1. */
+export type Random = () => number
+

package/s/rand/u32ify.ts

@@ -0,0 +1,6 @@
+
+/** convert a fraction number (between 0 and 1) into an unsigned 32-bit integer. */
+export function u32ify(fraction: number) {
+	return Math.floor(fraction * 0x100000000)
+}
+

package/s/utensils/map.ts

@@ -5,7 +5,7 @@ type MapLike<K, V> = {
 	set(key: K, value: V): unknown
 }
 
-export function need<K, V>(map: MapLike<K, V>, key: K) {
+export function need<K, V>(map: Pick<MapLike<K, V>, "has" | "get">, key: K) {
 	if (map.has(key))
 		return map.get(key) as V
 	else
@@ -22,7 +22,7 @@ export function guarantee<K, V>(map: MapLike<K, V>, key: K, make: () => V) {
 	}
 }
 
-export function inserts<K, V, M extends MapLike<K, V>>(map: M, entries: Iterable<[K, V]>) {
+export function inserts<K, V, M extends Pick<MapLike<K, V>, "set">>(map: M, entries: Iterable<[K, V]>) {
 	for (const [key, value] of entries)
 		map.set(key, value)
 	return map

package/s/utensils/set.ts

@@ -1,17 +1,11 @@
 
-type SetLike<V> = {
-	has(value: V): boolean
-	add(value: V): void
-	delete(value: V): void
-}
-
-export function adds<V, S extends SetLike<V>>(set: S, values: Iterable<V>) {
+export function adds<V, S extends {add(value: V): void}>(set: S, values: Iterable<V>) {
 	for (const value of values)
 		set.add(value)
 	return set
 }
 
-export function deletes<V, S extends SetLike<V>>(set: S, values: Iterable<V>) {
+export function deletes<V, S extends {delete(value: V): void}>(set: S, values: Iterable<V>) {
 	for (const value of values)
 		set.delete(value)
 	return set

package/x/index.d.ts

@@ -10,6 +10,7 @@ export * from "./debounce/types.js";
 export * from "./deep/index.js";
 export * from "./dig/dig.js";
 export * from "./queue/queue.js";
+export * from "./rand/index.js";
 export * from "./ok/index.js";
 export * from "./toq/index.js";
 export * from "./maybe/index.js";

package/x/index.js

@@ -10,6 +10,7 @@ export * from "./debounce/types.js";
 export * from "./deep/index.js";
 export * from "./dig/dig.js";
 export * from "./queue/queue.js";
+export * from "./rand/index.js";
 export * from "./ok/index.js";
 export * from "./toq/index.js";
 export * from "./maybe/index.js";

package/x/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../s/index.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAA;AAC3C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,yBAAyB,CAAA;AACvC,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAE7B,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,qBAAqB,CAAA;AAEnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAE5B,cAAc,kBAAkB,CAAA;AAEhC,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAEhC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AAEjC,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,SAAS,CAAA;AACvB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../s/index.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAA;AAC3C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,yBAAyB,CAAA;AACvC,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAE7B,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,qBAAqB,CAAA;AAEnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAE5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAE/B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAEhC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AAEjC,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,SAAS,CAAA;AACvB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/x/rand/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./rand.js";
+export * from "./seed.js";
+export * from "./types.js";
+export * from "./u32ify.js";

package/x/rand/index.js

@@ -0,0 +1,5 @@
+export * from "./rand.js";
+export * from "./seed.js";
+export * from "./types.js";
+export * from "./u32ify.js";
+//# sourceMappingURL=index.js.map

package/x/rand/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../s/rand/index.ts"],"names":[],"mappings":"AACA,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA"}

package/x/rand/rand.d.ts

@@ -0,0 +1,26 @@
+import { Random } from "./types.js";
+/** facility for doing common random things, like picking a random item from an array. */
+export declare class Rand {
+    random: Random;
+    constructor(random?: Random);
+    /** random positive unsigned 32-bit integer. */
+    u32(): number;
+    /** randomly returns true given a probability fraction. */
+    roll(chance?: number): boolean;
+    /** random number between two numbers. */
+    range(min: number, max: number): number;
+    /** random integer from min to max (inclusive). */
+    integerRange(min: number, max: number): number;
+    /** random array index given an array length. */
+    index(length: number): number;
+    /** randomly choose one item from the provided array. */
+    pick<T>(array: T[]): T;
+    /** randomly select a given number of array items. */
+    select<T>(count: number, array: T[]): T[];
+    /** remove a random item from the array, and return it. */
+    yoink<T>(array: T[]): T;
+    /** randomly remove the given number of items from the array. */
+    extract<T>(count: number, array: T[]): T[];
+    /** randomly shuffle an array in-place using fisher-yates. */
+    shuffle<T>(array: T[]): T[];
+}

package/x/rand/rand.js

@@ -0,0 +1,67 @@
+import { u32ify } from "./u32ify.js";
+/** facility for doing common random things, like picking a random item from an array. */
+export class Rand {
+    random;
+    constructor(random = Math.random) {
+        this.random = random;
+    }
+    /** random positive unsigned 32-bit integer. */
+    u32() {
+        return u32ify(this.random());
+    }
+    /** randomly returns true given a probability fraction. */
+    roll(chance = 0.5) {
+        return this.random() < chance;
+    }
+    /** random number between two numbers. */
+    range(min, max) {
+        return min + (this.random() * (max - min));
+    }
+    /** random integer from min to max (inclusive). */
+    integerRange(min, max) {
+        return min + Math.floor(this.random() * (max - min + 1));
+    }
+    /** random array index given an array length. */
+    index(length) {
+        return Math.floor(this.random() * length);
+    }
+    /** randomly choose one item from the provided array. */
+    pick(array) {
+        return array[this.index(array.length)];
+    }
+    /** randomly select a given number of array items. */
+    select(count, array) {
+        const copy = [...array];
+        if (count >= array.length)
+            return copy;
+        const selection = [];
+        for (let i = 0; i < count; i++)
+            selection.push(this.yoink(copy));
+        return selection;
+    }
+    /** remove a random item from the array, and return it. */
+    yoink(array) {
+        const index = this.index(array.length);
+        const [item] = array.splice(index, 1);
+        return item;
+    }
+    /** randomly remove the given number of items from the array. */
+    extract(count, array) {
+        const selection = [];
+        for (let i = 0; i < count; i++) {
+            if (array.length === 0)
+                return selection;
+            selection.push(this.yoink(array));
+        }
+        return selection;
+    }
+    /** randomly shuffle an array in-place using fisher-yates. */
+    shuffle(array) {
+        for (let i = array.length - 1; i > 0; i--) {
+            const j = Math.floor(this.random() * (i + 1));
+            [array[i], array[j]] = [array[j], array[i]];
+        }
+        return array;
+    }
+}
+//# sourceMappingURL=rand.js.map

package/x/rand/rand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rand.js","sourceRoot":"","sources":["../../s/rand/rand.ts"],"names":[],"mappings":"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"}

package/x/rand/seed.d.ts

@@ -0,0 +1,2 @@
+import { Random } from "./types.js";
+export declare function seed(u32?: number): Random;

package/x/rand/seed.js

@@ -0,0 +1,14 @@
+import { u32ify } from "./u32ify.js";
+const m = 2147483647;
+const a = 48271;
+export function seed(u32 = u32ify(Math.random())) {
+    u32 = (u32 ^ 0x6D2B79F5) + 0x1E35A7BD;
+    u32 = ((u32 >>> 0) % m) || 1;
+    function random() {
+        u32 = (a * u32) % m;
+        return u32 / m;
+    }
+    random();
+    return random;
+}
+//# sourceMappingURL=seed.js.map

package/x/rand/seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.js","sourceRoot":"","sources":["../../s/rand/seed.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,MAAM,EAAC,MAAM,aAAa,CAAA;AAElC,MAAM,CAAC,GAAG,UAAU,CAAA;AACpB,MAAM,CAAC,GAAG,KAAK,CAAA;AAEf,MAAM,UAAU,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IAC/C,GAAG,GAAG,CAAC,GAAG,GAAG,UAAU,CAAC,GAAG,UAAU,CAAA;IACrC,GAAG,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAA;IAE5B,SAAS,MAAM;QACd,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;QACnB,OAAO,GAAG,GAAG,CAAC,CAAA;IACf,CAAC;IAED,MAAM,EAAE,CAAA;IACR,OAAO,MAAM,CAAA;AACd,CAAC"}

package/x/rand/types.d.ts

@@ -0,0 +1,2 @@
+/** fn that returns random number fraction between 0 and 1. */
+export type Random = () => number;

package/x/rand/types.js

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

package/x/rand/types.js.map

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

package/x/rand/u32ify.d.ts

@@ -0,0 +1,2 @@
+/** convert a fraction number (between 0 and 1) into an unsigned 32-bit integer. */
+export declare function u32ify(fraction: number): number;

package/x/rand/u32ify.js

@@ -0,0 +1,5 @@
+/** convert a fraction number (between 0 and 1) into an unsigned 32-bit integer. */
+export function u32ify(fraction) {
+    return Math.floor(fraction * 0x100000000);
+}
+//# sourceMappingURL=u32ify.js.map

package/x/rand/u32ify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"u32ify.js","sourceRoot":"","sources":["../../s/rand/u32ify.ts"],"names":[],"mappings":"AACA,mFAAmF;AACnF,MAAM,UAAU,MAAM,CAAC,QAAgB;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,WAAW,CAAC,CAAA;AAC1C,CAAC"}

package/x/utensils/map.d.ts

@@ -3,7 +3,7 @@ type MapLike<K, V> = {
     get(key: K): V | undefined;
     set(key: K, value: V): unknown;
 };
-export declare function need<K, V>(map: MapLike<K, V>, key: K): V;
+export declare function need<K, V>(map: Pick<MapLike<K, V>, "has" | "get">, key: K): V;
 export declare function guarantee<K, V>(map: MapLike<K, V>, key: K, make: () => V): V;
-export declare function inserts<K, V, M extends MapLike<K, V>>(map: M, entries: Iterable<[K, V]>): M;
+export declare function inserts<K, V, M extends Pick<MapLike<K, V>, "set">>(map: M, entries: Iterable<[K, V]>): M;
 export {};

package/x/utensils/map.js.map

@@ -1 +1 @@
-{"version":3,"file":"map.js","sourceRoot":"","sources":["../../s/utensils/map.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,IAAI,CAAO,GAAkB,EAAE,GAAM;IACpD,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;QACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAM,CAAA;;QAExB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,SAAS,CAAO,GAAkB,EAAE,GAAM,EAAE,IAAa;IACxE,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;QACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAE,CAAA;SAChB,CAAC;QACL,MAAM,KAAK,GAAG,IAAI,EAAE,CAAA;QACpB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACnB,OAAO,KAAK,CAAA;IACb,CAAC;AACF,CAAC;AAED,MAAM,UAAU,OAAO,CAAgC,GAAM,EAAE,OAAyB;IACvF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO;QACjC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACpB,OAAO,GAAG,CAAA;AACX,CAAC"}
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../s/utensils/map.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,IAAI,CAAO,GAAuC,EAAE,GAAM;IACzE,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;QACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAM,CAAA;;QAExB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,SAAS,CAAO,GAAkB,EAAE,GAAM,EAAE,IAAa;IACxE,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;QACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAE,CAAA;SAChB,CAAC;QACL,MAAM,KAAK,GAAG,IAAI,EAAE,CAAA;QACpB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACnB,OAAO,KAAK,CAAA;IACb,CAAC;AACF,CAAC;AAED,MAAM,UAAU,OAAO,CAA6C,GAAM,EAAE,OAAyB;IACpG,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO;QACjC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACpB,OAAO,GAAG,CAAA;AACX,CAAC"}

package/x/utensils/set.d.ts

@@ -1,8 +1,6 @@
-type SetLike<V> = {
-    has(value: V): boolean;
+export declare function adds<V, S extends {
     add(value: V): void;
+}>(set: S, values: Iterable<V>): S;
+export declare function deletes<V, S extends {
     delete(value: V): void;
-};
-export declare function adds<V, S extends SetLike<V>>(set: S, values: Iterable<V>): S;
-export declare function deletes<V, S extends SetLike<V>>(set: S, values: Iterable<V>): S;
-export {};
+}>(set: S, values: Iterable<V>): S;

package/x/utensils/set.js.map

@@ -1 +1 @@
-{"version":3,"file":"set.js","sourceRoot":"","sources":["../../s/utensils/set.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,IAAI,CAA0B,GAAM,EAAE,MAAmB;IACxE,KAAK,MAAM,KAAK,IAAI,MAAM;QACzB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACf,OAAO,GAAG,CAAA;AACX,CAAC;AAED,MAAM,UAAU,OAAO,CAA0B,GAAM,EAAE,MAAmB;IAC3E,KAAK,MAAM,KAAK,IAAI,MAAM;QACzB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAClB,OAAO,GAAG,CAAA;AACX,CAAC"}
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../s/utensils/set.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,IAAI,CAAqC,GAAM,EAAE,MAAmB;IACnF,KAAK,MAAM,KAAK,IAAI,MAAM;QACzB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACf,OAAO,GAAG,CAAA;AACX,CAAC;AAED,MAAM,UAAU,OAAO,CAAwC,GAAM,EAAE,MAAmB;IACzF,KAAK,MAAM,KAAK,IAAI,MAAM;QACzB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAClB,OAAO,GAAG,CAAA;AACX,CAAC"}