@terrygonguet/utils 0.3.0 → 0.4.1

package/dist/index.d.ts

@@ -7,10 +7,11 @@ declare function noop(): void;
 declare function exhaustive(_: never): never;
 declare function hash(message: string): Promise<ArrayBuffer>;
 declare function range(start: number, end: number, step?: number): Generator<number, void, unknown>;
+declare function yesno(value?: string): boolean;
 type ExecResult<T, Err = Error> = [null, T] | [Err, null];
 declare function safe<F extends (...args: any) => any>(f: F, ...args: Parameters<F>): ReturnType<F> extends Promise<any> ? Promise<ExecResult<Awaited<ReturnType<F>>>> : ExecResult<ReturnType<F>>;
 declare function safe<Err, F extends (...args: any) => any>(f: F, ...args: Parameters<F>): ReturnType<F> extends Promise<any> ? Promise<ExecResult<Awaited<ReturnType<F>>, Err>> : ExecResult<ReturnType<F>, Err>;
 declare const exec: typeof safe;
 declare const run: typeof safe;
 
-export { type ExecResult, clamp, createNoopProxy, exec, exhaustive, hash, noop, range, run, safe };
+export { type ExecResult, clamp, createNoopProxy, exec, exhaustive, hash, noop, range, run, safe, yesno };

package/dist/index.js

@@ -35,6 +35,18 @@ function* range(start, end, step = 1) {
     yield i;
   }
 }
+function yesno(value) {
+  switch (value?.toLowerCase()) {
+    case "1":
+    case "y":
+    case "yes":
+    case "true":
+    case "on":
+      return true;
+    default:
+      return false;
+  }
+}
 function safe(f, ...args) {
   try {
     const promiseOrResult = f(...args);
@@ -59,5 +71,6 @@ export {
   noop,
   range,
   run,
-  safe
+  safe,
+  yesno
 };

package/dist/random.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Generates a random integer between `0` (inclusive) and `max` (exlusive)
+ */
+declare function randi(max: number): number;
+/**
+ * Generates a random integer between `min` (inclusive) and `max` (exlusive)
+ */
+declare function randi(min: number, max: number): number;
+/**
+ * Generates a random real between `0` (inclusive) and `max` (exlusive)
+ */
+declare function randf(max: number): number;
+/**
+ * Generates a random real between `min` (inclusive) and `max` (exlusive)
+ */
+declare function randf(min: number, max: number): number;
+declare const shuffle: <T>(arr: T[]) => T[];
+declare function make_randi(prng: typeof Math.random): typeof randi;
+declare function make_randf(prng: typeof Math.random): (minOrMax: number, max?: number) => number;
+declare function make_shuffle(prng: typeof Math.random): <T>(arr: T[]) => T[];
+declare function seeded(seed: string | number): typeof Math.random;
+
+export { make_randf, make_randi, make_shuffle, randf, randi, seeded, shuffle };

package/dist/random.js

@@ -0,0 +1,86 @@
+// src/random.ts
+var base_randi = make_randi(Math.random);
+function randi(minOrMax, max) {
+  if (typeof max == "number") return base_randi(minOrMax, max);
+  else return base_randi(minOrMax);
+}
+var base_randf = make_randf(Math.random);
+function randf(minOrMax, max) {
+  if (typeof max == "number") return base_randf(minOrMax, max);
+  else return base_randf(minOrMax);
+}
+var shuffle = make_shuffle(Math.random);
+function make_randi(prng) {
+  return function randi2(minOrMax, max) {
+    if (typeof max == "number") {
+      const min = minOrMax;
+      const delta = max - min;
+      return min + Math.floor(prng() * delta);
+    } else return Math.floor(prng() * minOrMax);
+  };
+}
+function make_randf(prng) {
+  return function randf2(minOrMax, max) {
+    if (typeof max == "number") {
+      const min = minOrMax;
+      const delta = max - min;
+      return min + prng() * delta;
+    } else return prng() * minOrMax;
+  };
+}
+function make_shuffle(prng) {
+  const randi2 = make_randi(prng);
+  return function shuffle2(arr) {
+    const clone = Array.from(arr);
+    for (let i = 0; i < clone.length - 2; i++) {
+      const j = randi2(i, clone.length);
+      const temp = clone[i];
+      clone[i] = clone[j];
+      clone[j] = temp;
+    }
+    return clone;
+  };
+}
+function seeded(seed) {
+  if (typeof seed == "string") seed = cyrb128(seed);
+  else seed ^= 3735928559;
+  const prng = splitmix32(seed);
+  for (let i = 0; i < 15; i++) prng();
+  return prng;
+}
+function cyrb128(str) {
+  let h1 = 1779033703, h2 = 3144134277, h3 = 1013904242, h4 = 2773480762;
+  for (let i = 0, k; i < str.length; i++) {
+    k = str.charCodeAt(i);
+    h1 = h2 ^ Math.imul(h1 ^ k, 597399067);
+    h2 = h3 ^ Math.imul(h2 ^ k, 2869860233);
+    h3 = h4 ^ Math.imul(h3 ^ k, 951274213);
+    h4 = h1 ^ Math.imul(h4 ^ k, 2716044179);
+  }
+  h1 = Math.imul(h3 ^ h1 >>> 18, 597399067);
+  h2 = Math.imul(h4 ^ h2 >>> 22, 2869860233);
+  h3 = Math.imul(h1 ^ h3 >>> 17, 951274213);
+  h4 = Math.imul(h2 ^ h4 >>> 19, 2716044179);
+  h1 ^= h2 ^ h3 ^ h4;
+  return h1 >>> 0;
+}
+function splitmix32(a) {
+  return function() {
+    a |= 0;
+    a = a + 2654435769 | 0;
+    let t = a ^ a >>> 16;
+    t = Math.imul(t, 569420461);
+    t = t ^ t >>> 15;
+    t = Math.imul(t, 1935289751);
+    return ((t = t ^ t >>> 15) >>> 0) / 4294967296;
+  };
+}
+export {
+  make_randf,
+  make_randi,
+  make_shuffle,
+  randf,
+  randi,
+  seeded,
+  shuffle
+};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@terrygonguet/utils",
-	"version": "0.3.0",
+	"version": "0.4.1",
 	"type": "module",
 	"license": "MIT",
 	"scripts": {
@@ -24,6 +24,10 @@
 			"types": "./dist/json.d.ts",
 			"import": "./dist/json.js"
 		},
+		"./random": {
+			"types": "./dist/random.d.ts",
+			"import": "./dist/random.js"
+		},
 		"./tableau": {
 			"types": "./dist/tableau.d.ts",
 			"import": "./dist/tableau.js"