@thi.ng/random 4.1.10 → 4.1.12

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-01-29T16:25:48Z
+- **Last updated**: 2025-02-19T20:59:58Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -7,7 +7,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 > [!NOTE]
-> This is one of 201 standalone projects, maintained as part
+> This is one of 202 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
@@ -121,7 +121,7 @@ Note: @thi.ng/api is in _most_ cases a type-only import (not used at runtime)
 
 ## Usage examples
 
-18 projects in this repo's
+19 projects in this repo's
 [/examples](https://github.com/thi-ng/umbrella/tree/develop/examples)
 directory are using this package:
 
@@ -144,6 +144,7 @@ directory are using this package:
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/shader-ast-evo.jpg" width="240"/>        | Evolutionary shader generation using genetic programming                                 | [Demo](https://demo.thi.ng/umbrella/shader-ast-evo/)        | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/shader-ast-evo)        |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/stacked-layout.png" width="240"/>        | Responsive & reactively computed stacked column layout                                   | [Demo](https://demo.thi.ng/umbrella/stacked-layout/)        | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/stacked-layout)        |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/thing-packages-quiz.avif" width="240"/>  | thi.ng/rdom & thi.ng/rstream based quiz to guess thi.ng package names                    | [Demo](https://demo.thi.ng/umbrella/thing-packages-quiz/)   | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/thing-packages-quiz)   |
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/tsne-colors.avif" width="240"/>          | Animated t-SNE visualization of 4D data                                                  | [Demo](https://demo.thi.ng/umbrella/tsne-colors/)           | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/tsne-colors)           |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/webgl-game-of-life.png" width="240"/>    | Game of Life implemented as WebGL2 multi-pass shader pipeline                            | [Demo](https://demo.thi.ng/umbrella/webgl-game-of-life/)    | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/webgl-game-of-life)    |
 
 ## API

package/api.d.ts

@@ -27,14 +27,14 @@ export interface INorm {
 }
 export interface IRandom extends INorm {
     /**
-     * Returns unsigned 32bit int in [0..0xffffffff] interval.
+     * Returns unsigned 32bit int in `[0,0xffffffff]` interval.
      *
      * @remarks
      * See: https://github.com/thi-ng/umbrella/wiki/Glossary#interval
      */
     int(): number;
     /**
-     * Returns float in [0..max) interval.
+     * Returns float in `[0,max)` interval.
      *
      * @remarks
      * See: https://github.com/thi-ng/umbrella/wiki/Glossary#interval
@@ -43,14 +43,14 @@ export interface IRandom extends INorm {
      */
     float(max?: number): number;
     /**
-     *  Calls {@link IRandom.float} and returns true iff result is < `p`
-     *  (assumed to be in [0..1] interval).
+     * Calls {@link IRandom.float} and returns true iff result is < `p` (assumed
+     * to be in `[0,1]` interval).
      *
      * @param p
      */
     probability(p: number): boolean;
     /**
-     * Returns float in [min..max) interval.
+     * Returns float in `[min,max)` interval.
      *
      * @remarks
      * See: https://github.com/thi-ng/umbrella/wiki/Glossary#interval
@@ -60,7 +60,7 @@ export interface IRandom extends INorm {
      */
     minmax(min: number, max: number): number;
     /**
-     * Returns int in **signed** integer [min..max) interval.
+     * Returns int in **signed** integer `[min,max)` interval.
      *
      * @remarks
      * See: https://github.com/thi-ng/umbrella/wiki/Glossary#interval
@@ -70,7 +70,7 @@ export interface IRandom extends INorm {
      */
     minmaxInt(min: number, max: number): number;
     /**
-     * Returns int in **unsigned** integer [min..max) interval.
+     * Returns int in **unsigned** integer `[min,max)` interval.
      *
      * @remarks
      * See: https://github.com/thi-ng/umbrella/wiki/Glossary#interval

package/distributions/gaussian.d.ts

@@ -5,7 +5,7 @@ import type { IRandom } from "../api.js";
  * (Central Limit Theorem).
  *
  * @remarks
- * The default configuration produces samples in the approx. [-0.5,0.5] range
+ * The default configuration produces samples in the approx. `[-0.5,0.5]` range
  * with a ~12% standard deviation.
  *
  * Reference: https://en.wikipedia.org/wiki/Central_limit_theorem

package/distributions/geometric.d.ts

@@ -10,7 +10,7 @@ import type { IRandom } from "../api.js";
  * Reference: https://en.wikipedia.org/wiki/Geometric_distribution
  *
  * @param rnd -
- * @param p - probability (0,1]
+ * @param p - probability `(0,1]`
  */
 export declare const geometric: (rnd?: IRandom, p?: number) => () => number;
 //# sourceMappingURL=geometric.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/random",
-  "version": "4.1.10",
+  "version": "4.1.12",
   "description": "Pseudo-random number generators w/ unified API, distributions, weighted choices, ID generation",
   "type": "module",
   "module": "./index.js",
@@ -39,12 +39,12 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.19",
-    "@thi.ng/errors": "^2.5.25"
+    "@thi.ng/api": "^8.11.21",
+    "@thi.ng/errors": "^2.5.27"
   },
   "devDependencies": {
-    "esbuild": "^0.24.2",
-    "typedoc": "^0.27.6",
+    "esbuild": "^0.25.0",
+    "typedoc": "^0.27.7",
     "typescript": "^5.7.3"
   },
   "keywords": [
@@ -159,5 +159,5 @@
       "ksuid"
     ]
   },
-  "gitHead": "fc1d498e8d4b690db873c30cc594352a804e7a65\n"
+  "gitHead": "bee617702ac61d093465b967f8f973dc566faa6b\n"
 }

package/sfc32.d.ts

@@ -5,8 +5,8 @@ import { ARandom } from "./arandom.js";
  * Simple Fast Counter PRNG (32bit version)
  *
  * @remarks
- * References:
- * - http://pracrand.sourceforge.net/
+ * Reference:
+ * http://pracrand.sourceforge.net/
  */
 export declare class SFC32 extends ARandom implements IBuffered<Uint32Array>, ICopy<SFC32>, ISeedable<ArrayLike<number>> {
     buffer: Uint32Array;

package/smush32.d.ts

@@ -4,7 +4,7 @@ import { ARandom } from "./arandom.js";
 /**
  * @remarks
  * References:
- * -
+ *
  * - https://github.com/thi-ng/ct-head/blob/master/random.h
  * - https://gist.github.com/voidqk/d112165a26b45244a65298933c0349a4
  */

package/weighted-probability.d.ts

@@ -2,8 +2,8 @@ import type { FnN } from "@thi.ng/api";
 import type { IRandom } from "./api.js";
 /**
  * Takes a `weight` function and optional {@link IRandom} instance (default:
- * {@link SYSTEM}). The weight function accepts a number in [0,1) interval and
- * returns a number in [0,1]. Draws two random numbers `a` and `b` via
+ * {@link SYSTEM}). The weight function accepts a number in `[0,1)` interval and
+ * returns a number in `[0,1]`. Draws two random numbers `a` and `b` via
  * {@link IRandom.float} and returns a tuple of `[a, b < weight(a)]`.
  *
  * @example

package/xoshiro128.d.ts

@@ -4,6 +4,7 @@ import { ARandom } from "./arandom.js";
 /**
  * @remarks
  * References:
+ *
  * - http://prng.di.unimi.it/
  * - http://prng.di.unimi.it/xoshiro128plusplus.c
  */