@fgv/ts-random 5.1.0-14 → 5.1.0-16

package/.rush/temp/{3e52bbe13068378e2400ce8a606faeb9c7611641.tar.log → a34da6ff833f9800742457a862fac09bdf3c4c41.tar.log}

@@ -1,5 +1,5 @@
-Start time: Fri Apr 10 2026 15:10:48 GMT+0000 (Coordinated Universal Time)
-Invoking "/usr/bin/tar -c -f /home/runner/work/fgv/fgv/common/temp/build-cache/3e52bbe13068378e2400ce8a606faeb9c7611641-902c744721388f92.temp -z --files-from=-"
+Start time: Mon Apr 13 2026 15:33:56 GMT+0000 (Coordinated Universal Time)
+Invoking "/usr/bin/tar -c -f /home/runner/work/fgv/fgv/common/temp/build-cache/a34da6ff833f9800742457a862fac09bdf3c4c41-cb8ba97a50abd449.temp -z --files-from=-"
 
 ======= BEGIN PROCESS INPUT ======
 .rush/temp/operation/build/all.log

package/.rush/temp/chunked-rush-logs/ts-random.build.chunks.jsonl

@@ -2,5 +2,5 @@
 {"kind":"O","text":" ---- build started ---- \n"}
 {"kind":"O","text":"[build:typescript] The TypeScript compiler version 5.9.3 is newer than the latest version that was tested with Heft (5.8); it may not work correctly.\n"}
 {"kind":"O","text":"[build:typescript] Using TypeScript version 5.9.3\n"}
-{"kind":"O","text":" ---- build finished (9.470s) ---- \n"}
-{"kind":"O","text":"-------------------- Finished (9.475s) --------------------\n"}
+{"kind":"O","text":" ---- build finished (8.448s) ---- \n"}
+{"kind":"O","text":"-------------------- Finished (8.453s) --------------------\n"}

package/.rush/temp/operation/build/all.log

@@ -2,5 +2,5 @@ Invoking: heft build --clean
  ---- build started ---- 
 [build:typescript] The TypeScript compiler version 5.9.3 is newer than the latest version that was tested with Heft (5.8); it may not work correctly.
 [build:typescript] Using TypeScript version 5.9.3
- ---- build finished (9.470s) ---- 
--------------------- Finished (9.475s) --------------------
+ ---- build finished (8.448s) ---- 
+-------------------- Finished (8.453s) --------------------

package/.rush/temp/operation/build/log-chunks.jsonl

@@ -2,5 +2,5 @@
 {"kind":"O","text":" ---- build started ---- \n"}
 {"kind":"O","text":"[build:typescript] The TypeScript compiler version 5.9.3 is newer than the latest version that was tested with Heft (5.8); it may not work correctly.\n"}
 {"kind":"O","text":"[build:typescript] Using TypeScript version 5.9.3\n"}
-{"kind":"O","text":" ---- build finished (9.470s) ---- \n"}
-{"kind":"O","text":"-------------------- Finished (9.475s) --------------------\n"}
+{"kind":"O","text":" ---- build finished (8.448s) ---- \n"}
+{"kind":"O","text":"-------------------- Finished (8.453s) --------------------\n"}

package/.rush/temp/operation/build/state.json

@@ -1,3 +1,3 @@
 {
-  "nonCachedDurationMs": 10325.582172000002
+  "nonCachedDurationMs": 9136.951115999997
 }

package/docs/Generator/README.md

@@ -134,15 +134,6 @@ Function that steps a random number generator state and returns the next value.
 </td></tr>
 <tr><td>
 
-[GeneratorGlobalThis](./type-aliases/GeneratorGlobalThis.md)
-
-</td><td>
-
-Global context (globalThis) into which the generator can install itself for sharing.
-
-</td></tr>
-<tr><td>
-
 [SequencePickParams](./type-aliases/SequencePickParams.md)
 
 </td><td>

package/docs/Generator/classes/PseudoRandomGenerator.create.md

@@ -7,7 +7,7 @@ Creates a new pseudo-random number generator.
 **Signature:**
 
 ```typescript
-static create(params?: IPseudoRandomGeneratorCreateParams): Result<PseudoRandomGenerator>;
+static create(params: IPseudoRandomGeneratorCreateParams): Result<PseudoRandomGenerator>;
 ```
 
 **Parameters:**

package/docs/Generator/classes/PseudoRandomGenerator.ensureRng.md

@@ -8,7 +8,7 @@ or creating a new one if not.
 **Signature:**
 
 ```typescript
-static ensureRng(rng?: PseudoRandomGenerator): PseudoRandomGenerator;
+static ensureRng(rng?: PseudoRandomGenerator): Result<PseudoRandomGenerator>;
 ```
 
 **Parameters:**
@@ -20,6 +20,6 @@ static ensureRng(rng?: PseudoRandomGenerator): PseudoRandomGenerator;
 
 **Returns:**
 
-[PseudoRandomGenerator](../../classes/PseudoRandomGenerator.md)
+Result&lt;[PseudoRandomGenerator](../../classes/PseudoRandomGenerator.md)&gt;
 
 A random number generator.

package/docs/Generator/classes/PseudoRandomGenerator.md

@@ -153,7 +153,7 @@ Generates a random float between 0 and 1.
 </td></tr>
 <tr><td>
 
-[nextInt(max)](./PseudoRandomGenerator.nextInt.md)
+[nextInt(extent)](./PseudoRandomGenerator.nextInt.md)
 
 </td><td>
 
@@ -161,7 +161,7 @@ Generates a random float between 0 and 1.
 
 </td><td>
 
-Generates a random integer between 0 and the specified maximum value.
+Generates a random integer between 0 and the specified extent (positive or negative).
 
 </td></tr>
 <tr><td>
@@ -226,7 +226,7 @@ Generates a random item from the given array.
 
 </td><td>
 
-Generates a sequence of values by randomly selecting from the given candidates.
+Generates a sequence of values by randomly selecting from the given candidate
 
 </td></tr>
 <tr><td>
@@ -239,7 +239,7 @@ Generates a sequence of values by randomly selecting from the given candidates.
 
 </td><td>
 
-Generates a sequence of values by randomly selecting from the given candidates.
+Generates a sequence of values by randomly selecting from the supplied
 
 </td></tr>
 <tr><td>

package/docs/Generator/classes/PseudoRandomGenerator.nextInt.md

@@ -2,23 +2,23 @@
 
 ## PseudoRandomGenerator.nextInt() method
 
-Generates a random integer between 0 and the specified maximum value.
+Generates a random integer between 0 and the specified extent (positive or negative).
 
 **Signature:**
 
 ```typescript
-nextInt(max?: number): number;
+nextInt(extent?: number): number;
 ```
 
 **Parameters:**
 
 <table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead>
 <tbody>
-<tr><td>max</td><td>number</td><td>The maximum value (exclusive).</td></tr>
+<tr><td>extent</td><td>number</td><td>The maximum (or minimum) value (exclusive).</td></tr>
 </tbody></table>
 
 **Returns:**
 
 number
 
-A random integer between 0 and the specified maximum value.
+A random integer between 0 and the specified extent.

package/docs/Generator/classes/PseudoRandomGenerator.pickRandom.md

@@ -2,7 +2,8 @@
 
 ## PseudoRandomGenerator.pickRandom() method
 
-Generates a sequence of values by randomly selecting from the given candidates.
+Generates a sequence of values by randomly selecting from the supplied
+dictionaries in random order.
 
 **Signature:**
 

package/docs/Generator/classes/PseudoRandomGenerator.pickSequential.md

@@ -2,7 +2,8 @@
 
 ## PseudoRandomGenerator.pickSequential() method
 
-Generates a sequence of values by randomly selecting from the given candidates.
+Generates a sequence of values by randomly selecting from the given candidate
+dictionaries in order.
 
 **Signature:**
 

package/docs/Generator/interfaces/IRandomSequencePickParams.candidates.md

@@ -5,5 +5,5 @@
 **Signature:**
 
 ```typescript
-candidates: readonly T[];
+candidates: readonly (readonly T[])[];
 ```

package/docs/Generator/interfaces/IRandomSequencePickParams.md

@@ -69,7 +69,7 @@ number
 
 </td><td>
 
-readonly T[]
+readonly (readonly T[])[]
 
 </td><td>
 

package/docs/classes/PseudoRandomGenerator.create.md

@@ -7,7 +7,7 @@ Creates a new pseudo-random number generator.
 **Signature:**
 
 ```typescript
-static create(params?: IPseudoRandomGeneratorCreateParams): Result<PseudoRandomGenerator>;
+static create(params: IPseudoRandomGeneratorCreateParams): Result<PseudoRandomGenerator>;
 ```
 
 **Parameters:**

package/docs/classes/PseudoRandomGenerator.ensureRng.md

@@ -8,7 +8,7 @@ or creating a new one if not.
 **Signature:**
 
 ```typescript
-static ensureRng(rng?: PseudoRandomGenerator): PseudoRandomGenerator;
+static ensureRng(rng?: PseudoRandomGenerator): Result<PseudoRandomGenerator>;
 ```
 
 **Parameters:**
@@ -20,6 +20,6 @@ static ensureRng(rng?: PseudoRandomGenerator): PseudoRandomGenerator;
 
 **Returns:**
 
-[PseudoRandomGenerator](PseudoRandomGenerator.md)
+Result&lt;[PseudoRandomGenerator](PseudoRandomGenerator.md)&gt;
 
 A random number generator.

package/docs/classes/PseudoRandomGenerator.md

@@ -153,7 +153,7 @@ Generates a random float between 0 and 1.
 </td></tr>
 <tr><td>
 
-[nextInt(max)](./PseudoRandomGenerator.nextInt.md)
+[nextInt(extent)](./PseudoRandomGenerator.nextInt.md)
 
 </td><td>
 
@@ -161,7 +161,7 @@ Generates a random float between 0 and 1.
 
 </td><td>
 
-Generates a random integer between 0 and the specified maximum value.
+Generates a random integer between 0 and the specified extent (positive or negative).
 
 </td></tr>
 <tr><td>
@@ -226,7 +226,7 @@ Generates a random item from the given array.
 
 </td><td>
 
-Generates a sequence of values by randomly selecting from the given candidates.
+Generates a sequence of values by randomly selecting from the given candidate
 
 </td></tr>
 <tr><td>
@@ -239,7 +239,7 @@ Generates a sequence of values by randomly selecting from the given candidates.
 
 </td><td>
 
-Generates a sequence of values by randomly selecting from the given candidates.
+Generates a sequence of values by randomly selecting from the supplied
 
 </td></tr>
 <tr><td>

package/docs/classes/PseudoRandomGenerator.nextInt.md

@@ -2,23 +2,23 @@
 
 ## PseudoRandomGenerator.nextInt() method
 
-Generates a random integer between 0 and the specified maximum value.
+Generates a random integer between 0 and the specified extent (positive or negative).
 
 **Signature:**
 
 ```typescript
-nextInt(max?: number): number;
+nextInt(extent?: number): number;
 ```
 
 **Parameters:**
 
 <table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead>
 <tbody>
-<tr><td>max</td><td>number</td><td>The maximum value (exclusive).</td></tr>
+<tr><td>extent</td><td>number</td><td>The maximum (or minimum) value (exclusive).</td></tr>
 </tbody></table>
 
 **Returns:**
 
 number
 
-A random integer between 0 and the specified maximum value.
+A random integer between 0 and the specified extent.

package/docs/classes/PseudoRandomGenerator.pickRandom.md

@@ -2,7 +2,8 @@
 
 ## PseudoRandomGenerator.pickRandom() method
 
-Generates a sequence of values by randomly selecting from the given candidates.
+Generates a sequence of values by randomly selecting from the supplied
+dictionaries in random order.
 
 **Signature:**
 

package/docs/classes/PseudoRandomGenerator.pickSequential.md

@@ -2,7 +2,8 @@
 
 ## PseudoRandomGenerator.pickSequential() method
 
-Generates a sequence of values by randomly selecting from the given candidates.
+Generates a sequence of values by randomly selecting from the given candidate
+dictionaries in order.
 
 **Signature:**
 

package/docs/interfaces/IRandomSequencePickParams.candidates.md

@@ -5,5 +5,5 @@
 **Signature:**
 
 ```typescript
-candidates: readonly T[];
+candidates: readonly (readonly T[])[];
 ```

package/docs/interfaces/IRandomSequencePickParams.md

@@ -69,7 +69,7 @@ number
 
 </td><td>
 
-readonly T[]
+readonly (readonly T[])[]
 
 </td><td>
 

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@fgv/ts-random",
-  "version": "5.1.0-14",
+  "version": "5.1.0-16",
   "description": "psedo-random number generator and utilities for TypeScript",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@fgv/ts-utils": "5.1.0-14",
-    "@fgv/ts-json-base": "5.1.0-14"
+    "@fgv/ts-json-base": "5.1.0-16",
+    "@fgv/ts-utils": "5.1.0-16"
   },
   "devDependencies": {
     "@rushstack/heft": "1.2.7",
@@ -20,9 +20,9 @@
     "@rushstack/eslint-config": "4.6.4",
     "eslint": "^9.39.2",
     "typedoc": "~0.28.16",
-    "@fgv/heft-dual-rig": "5.1.0-14",
-    "@fgv/ts-utils-jest": "5.1.0-14",
-    "@fgv/typedoc-compact-theme": "5.1.0-14"
+    "@fgv/ts-utils-jest": "5.1.0-16",
+    "@fgv/heft-dual-rig": "5.1.0-16",
+    "@fgv/typedoc-compact-theme": "5.1.0-16"
   },
   "repository": {
     "type": "git",

package/rush-logs/ts-random.build.cache.log

@@ -1,3 +1,3 @@
 Caching build output folders: dist, lib, temp, .rush/temp/operation/build
 Successfully set cache entry.
-Cache key: 3e52bbe13068378e2400ce8a606faeb9c7611641
+Cache key: a34da6ff833f9800742457a862fac09bdf3c4c41

package/rush-logs/ts-random.build.log

@@ -2,5 +2,5 @@ Invoking: heft build --clean
  ---- build started ---- 
 [build:typescript] The TypeScript compiler version 5.9.3 is newer than the latest version that was tested with Heft (5.8); it may not work correctly.
 [build:typescript] Using TypeScript version 5.9.3
- ---- build finished (9.470s) ---- 
--------------------- Finished (9.475s) --------------------
+ ---- build finished (8.448s) ---- 
+-------------------- Finished (8.453s) --------------------

package/docs/Generator/type-aliases/GeneratorGlobalThis.md

@@ -1,11 +0,0 @@
-[Home](../../README.md) > [Generator](../README.md) > GeneratorGlobalThis
-
-# Type Alias: GeneratorGlobalThis
-
-Global context (globalThis) into which the generator can install itself for sharing.
-
-## Type
-
-```typescript
-type GeneratorGlobalThis = unknown
-```

package/docs/type-aliases/GeneratorGlobalThis.md

@@ -1,11 +0,0 @@
-[Home](../README.md) > GeneratorGlobalThis
-
-# Type Alias: GeneratorGlobalThis
-
-Global context (globalThis) into which the generator can install itself for sharing.
-
-## Type
-
-```typescript
-type GeneratorGlobalThis = unknown
-```