@thi.ng/random 3.0.1 → 3.1.2

package/CHANGELOG.md

@@ -3,6 +3,49 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.1.2](https://github.com/thi-ng/umbrella/compare/@thi.ng/random@3.1.1...@thi.ng/random@3.1.2) (2021-10-28)
+
+**Note:** Version bump only for package @thi.ng/random
+
+
+
+
+
+## [3.1.1](https://github.com/thi-ng/umbrella/compare/@thi.ng/random@3.1.0...@thi.ng/random@3.1.1) (2021-10-28)
+
+**Note:** Version bump only for package @thi.ng/random
+
+
+
+
+
+# [3.1.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/random@3.0.3...@thi.ng/random@3.1.0) (2021-10-25)
+
+
+### Features
+
+* **random:** add pickRandom() ([0899aed](https://github.com/thi-ng/umbrella/commit/0899aed89fd691df4ddc5273995a579414f506d8))
+
+
+
+
+
+## [3.0.3](https://github.com/thi-ng/umbrella/compare/@thi.ng/random@3.0.2...@thi.ng/random@3.0.3) (2021-10-15)
+
+**Note:** Version bump only for package @thi.ng/random
+
+
+
+
+
+## [3.0.2](https://github.com/thi-ng/umbrella/compare/@thi.ng/random@3.0.1...@thi.ng/random@3.0.2) (2021-10-15)
+
+**Note:** Version bump only for package @thi.ng/random
+
+
+
+
+
 ## [3.0.1](https://github.com/thi-ng/umbrella/compare/@thi.ng/random@3.0.0...@thi.ng/random@3.0.1) (2021-10-13)
 
 **Note:** Version bump only for package @thi.ng/random

package/README.md

@@ -89,7 +89,7 @@ node --experimental-repl-await
 > const random = await import("@thi.ng/random");
 ```
 
-Package sizes (gzipped, pre-treeshake): ESM: 1.83 KB
+Package sizes (gzipped, pre-treeshake): ESM: 1.86 KB
 
 ## Dependencies
 

package/crypto.js

@@ -11,9 +11,6 @@ import { randomBytes } from "./random-bytes.js";
  *
  */
 export class Crypto extends ARandom {
-    buffer;
-    u32;
-    i;
     /**
      * @param size - buffer size in bytes (will be rounded to next multiple of 4)
      */

package/index.d.ts

@@ -1,21 +1,22 @@
 export * from "./api.js";
 export * from "./arandom.js";
-export * from "./crypto.js";
-export * from "./smush32.js";
-export * from "./system.js";
-export * from "./xoshiro128.js";
-export * from "./xorshift128.js";
-export * from "./xorwow.js";
-export * from "./xsadd.js";
 export * from "./coin.js";
-export * from "./random-bytes.js";
-export * from "./random-id.js";
-export * from "./unique-indices.js";
-export * from "./uuid.js";
-export * from "./weighted-random.js";
+export * from "./crypto.js";
 export * from "./distributions/exponential.js";
 export * from "./distributions/gaussian.js";
 export * from "./distributions/geometric.js";
 export * from "./distributions/normal.js";
 export * from "./distributions/uniform.js";
+export * from "./pick-random.js";
+export * from "./random-bytes.js";
+export * from "./random-id.js";
+export * from "./smush32.js";
+export * from "./system.js";
+export * from "./unique-indices.js";
+export * from "./uuid.js";
+export * from "./weighted-random.js";
+export * from "./xorshift128.js";
+export * from "./xorwow.js";
+export * from "./xoshiro128.js";
+export * from "./xsadd.js";
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -1,20 +1,21 @@
 export * from "./api.js";
 export * from "./arandom.js";
-export * from "./crypto.js";
-export * from "./smush32.js";
-export * from "./system.js";
-export * from "./xoshiro128.js";
-export * from "./xorshift128.js";
-export * from "./xorwow.js";
-export * from "./xsadd.js";
 export * from "./coin.js";
-export * from "./random-bytes.js";
-export * from "./random-id.js";
-export * from "./unique-indices.js";
-export * from "./uuid.js";
-export * from "./weighted-random.js";
+export * from "./crypto.js";
 export * from "./distributions/exponential.js";
 export * from "./distributions/gaussian.js";
 export * from "./distributions/geometric.js";
 export * from "./distributions/normal.js";
 export * from "./distributions/uniform.js";
+export * from "./pick-random.js";
+export * from "./random-bytes.js";
+export * from "./random-id.js";
+export * from "./smush32.js";
+export * from "./system.js";
+export * from "./unique-indices.js";
+export * from "./uuid.js";
+export * from "./weighted-random.js";
+export * from "./xorshift128.js";
+export * from "./xorwow.js";
+export * from "./xoshiro128.js";
+export * from "./xsadd.js";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@thi.ng/random",
-    "version": "3.0.1",
+    "version": "3.1.2",
     "description": "Pseudo-random number generators w/ unified API, distributions, weighted choices, ID generation",
     "type": "module",
     "module": "./index.js",
@@ -34,13 +34,13 @@
         "test": "testament test"
     },
     "dependencies": {
-        "@thi.ng/api": "^8.0.1",
-        "@thi.ng/checks": "^3.0.1",
-        "@thi.ng/errors": "^2.0.1",
-        "@thi.ng/hex": "^2.0.1"
+        "@thi.ng/api": "^8.0.6",
+        "@thi.ng/checks": "^3.0.6",
+        "@thi.ng/errors": "^2.0.6",
+        "@thi.ng/hex": "^2.0.6"
     },
     "devDependencies": {
-        "@thi.ng/testament": "^0.1.1"
+        "@thi.ng/testament": "^0.1.6"
     },
     "keywords": [
         "binary",
@@ -105,6 +105,9 @@
         "./distributions/uniform": {
             "import": "./distributions/uniform.js"
         },
+        "./pick-random": {
+            "import": "./pick-random.js"
+        },
         "./random-bytes": {
             "import": "./random-bytes.js"
         },
@@ -145,5 +148,5 @@
             "ksuid"
         ]
     },
-    "gitHead": "2e6b3d7c0f4c5686c1e9bdb4902ed7d3f90bcc19"
+    "gitHead": "c17a556ad25f6882dfa8f806a1d9e8ed7ac7cd71"
 }

package/pick-random.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Returns a random element from `src` using given {@link IRandom} instance
+ * (default: {@link SYSTEM}). The index selection will be constrained to the
+ * `[start,end)` interval (default: entire array).
+ *
+ * @param src
+ * @param rnd
+ * @param start
+ * @param end
+ */
+export declare const pickRandom: <T>(src: ArrayLike<T>, rnd?: import("./system.js").SystemRandom, start?: number, end?: number) => T;
+//# sourceMappingURL=pick-random.d.ts.map

package/pick-random.js

@@ -0,0 +1,12 @@
+import { SYSTEM } from "./system.js";
+/**
+ * Returns a random element from `src` using given {@link IRandom} instance
+ * (default: {@link SYSTEM}). The index selection will be constrained to the
+ * `[start,end)` interval (default: entire array).
+ *
+ * @param src
+ * @param rnd
+ * @param start
+ * @param end
+ */
+export const pickRandom = (src, rnd = SYSTEM, start = 0, end = src.length) => src[rnd.minmax(start, end) | 0];

package/smush32.js

@@ -8,7 +8,6 @@ import { DEFAULT_SEED_32 } from "./constants.js";
  * - https://gist.github.com/voidqk/d112165a26b45244a65298933c0349a4
  */
 export class Smush32 extends ARandom {
-    buffer;
     constructor(seed = DEFAULT_SEED_32) {
         super();
         this.buffer = new Uint32Array([seed, 0]);

package/xorshift128.js

@@ -5,7 +5,6 @@ import { DEFAULT_SEED_128 } from "./constants.js";
  * Reference: https://en.wikipedia.org/wiki/Xorshift
  */
 export class XorShift128 extends ARandom {
-    buffer;
     constructor(seed = DEFAULT_SEED_128) {
         super();
         this.buffer = new Uint32Array(4);

package/xorwow.js

@@ -5,7 +5,6 @@ import { DEFAULT_SEED_160 } from "./constants.js";
  * Reference: https://en.wikipedia.org/wiki/Xorshift#xorwow
  */
 export class XorWow extends ARandom {
-    buffer;
     constructor(seed = DEFAULT_SEED_160) {
         super();
         this.buffer = new Uint32Array(5);

package/xoshiro128.js

@@ -7,7 +7,6 @@ import { DEFAULT_SEED_128 } from "./constants.js";
  * - http://prng.di.unimi.it/xoshiro128plusplus.c
  */
 export class Xoshiro128 extends ARandom {
-    buffer;
     constructor(seed = DEFAULT_SEED_128) {
         super();
         this.buffer = new Uint32Array(4);

package/xsadd.js

@@ -5,7 +5,6 @@ import { DEFAULT_SEED_32 } from "./constants.js";
  * Reference: https://github.com/MersenneTwister-Lab/XSadd/blob/develop/xsadd.h
  */
 export class XsAdd extends ARandom {
-    buffer;
     constructor(seed = DEFAULT_SEED_32) {
         super();
         this.buffer = new Uint32Array(4);