@thi.ng/lowdisc 0.3.42 → 0.3.44

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-12-03T12:13:31Z
+- **Last updated**: 2023-12-11T10:07:09Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -89,7 +89,7 @@ For Node.js REPL:
 const lowdisc = await import("@thi.ng/lowdisc");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 449 bytes
+Package sizes (brotli'd, pre-treeshake): ESM: 450 bytes
 
 ## Dependencies
 

package/halton.js

@@ -1,38 +1,25 @@
 import { lowDiscrepancy } from "./lowdisc.js";
-/**
- * Iterator yielding 1D Halton sequence for given `base` (preferably a prime).
- *
- * @remarks
- * Ported from Python version at: https://en.wikipedia.org/wiki/Halton_sequence
- *
- * @param base -
- */
-export function* halton(base) {
-    let n = 0;
-    let d = 1;
-    let invB = 1 / base;
-    while (true) {
-        let x = d - n;
-        if (x === 1) {
-            n = 1;
-            d *= base;
-        }
-        else {
-            let y = (d * invB) | 0;
-            while (x <= y) {
-                y = (y * invB) | 0;
-            }
-            n = (base + 1) * y - x;
-        }
-        yield n / d;
+function* halton(base) {
+  let n = 0;
+  let d = 1;
+  let invB = 1 / base;
+  while (true) {
+    let x = d - n;
+    if (x === 1) {
+      n = 1;
+      d *= base;
+    } else {
+      let y = d * invB | 0;
+      while (x <= y) {
+        y = y * invB | 0;
+      }
+      n = (base + 1) * y - x;
     }
+    yield n / d;
+  }
 }
-/**
- * n-dimensional version of {@link halton}. Takes a vector of `bases` (one per
- * dimension) and yields iterator of nD points. If `offset` > 0, the stated
- * number of initial iterations will be skipped.
- *
- * @param bases -
- * @param offset -
- */
-export const haltonND = (bases, offset = 0) => lowDiscrepancy(bases.map(halton), offset);
+const haltonND = (bases, offset = 0) => lowDiscrepancy(bases.map(halton), offset);
+export {
+  halton,
+  haltonND
+};

package/kronecker.js

@@ -1,30 +1,11 @@
 import { lowDiscrepancy } from "./lowdisc.js";
-/** @internal */
 const fract = (x) => x - Math.floor(x);
-/**
- * Iterator yielding 1D Kronecker Recurrence sequence for given `alpha` and
- * `start` values, where `y(i) = fract(start + i * alpha)` and `i` is the
- * iteration counter. The `alpha` param should be an irrational number in the
- * `(0..1)` interval.
- *
- * @remarks
- * Reference:
- * - https://math.stackexchange.com/a/2848339
- * - http://extremelearning.com.au/unreasonable-effectiveness-of-quasirandom-sequences/
- *
- * @param alpha -
- * @param start -
- */
-export function* kronecker(alpha, start = 0) {
-    while (true)
-        yield (start = fract(start + alpha));
+function* kronecker(alpha, start = 0) {
+  while (true)
+    yield start = fract(start + alpha);
 }
-/**
- * n-dimensional version of {@link kronecker}. Takes a vector of `alphas` (one
- * per dimension) and yields iterator of nD points. If `offset` > 0, the stated
- * number of initial iterations will be skipped.
- *
- * @param bases -
- * @param offset -
- */
-export const kroneckerND = (alphas, offset = 0) => lowDiscrepancy(alphas.map(kronecker), offset);
+const kroneckerND = (alphas, offset = 0) => lowDiscrepancy(alphas.map(kronecker), offset);
+export {
+  kronecker,
+  kroneckerND
+};

package/lowdisc.js

@@ -1,44 +1,29 @@
 import { assert } from "@thi.ng/errors/assert";
-/**
- * General purpose iterator yielding n-dimensional sequence values obtained from
- * given per-dimension sequence generators. Omits `offset` (default: 0) initial
- * values.
- *
- * @remarks
- * This function acts as shared impl for all other sequence generators in this
- * package.
- *
- * @param dims -
- * @param offset -
- */
-export const lowDiscrepancy = (dims, offset = 0) => {
-    const num = dims.length;
-    assert(num > 0, `invalid dimensions`);
-    const [x, y, z] = dims;
-    const iter = num === 1
-        ? (function* () {
-            while (true)
-                yield [x.next().value];
-        })()
-        : num === 2
-            ? (function* () {
-                while (true)
-                    yield [x.next().value, y.next().value];
-            })()
-            : num === 3
-                ? (function* () {
-                    while (true)
-                        yield [
-                            x.next().value,
-                            y.next().value,
-                            z.next().value,
-                        ];
-                })()
-                : (function* () {
-                    while (true)
-                        yield dims.map((d) => d.next().value);
-                })();
-    for (; offset-- > 0;)
-        iter.next();
-    return iter;
+const lowDiscrepancy = (dims, offset = 0) => {
+  const num = dims.length;
+  assert(num > 0, `invalid dimensions`);
+  const [x, y, z] = dims;
+  const iter = num === 1 ? function* () {
+    while (true)
+      yield [x.next().value];
+  }() : num === 2 ? function* () {
+    while (true)
+      yield [x.next().value, y.next().value];
+  }() : num === 3 ? function* () {
+    while (true)
+      yield [
+        x.next().value,
+        y.next().value,
+        z.next().value
+      ];
+  }() : function* () {
+    while (true)
+      yield dims.map((d) => d.next().value);
+  }();
+  for (; offset-- > 0; )
+    iter.next();
+  return iter;
+};
+export {
+  lowDiscrepancy
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/lowdisc",
-  "version": "0.3.42",
+  "version": "0.3.44",
   "description": "n-dimensional low-discrepancy sequence generators/iterators",
   "type": "module",
   "module": "./index.js",
@@ -24,7 +24,9 @@
   "author": "Karsten Schmidt (https://thi.ng)",
   "license": "Apache-2.0",
   "scripts": {
-    "build": "yarn clean && tsc --declaration",
+    "build": "yarn build:esbuild && yarn build:decl",
+    "build:decl": "tsc --declaration --emitDeclarationOnly",
+    "build:esbuild": "esbuild --format=esm --platform=neutral --target=es2022 --tsconfig=tsconfig.json --outdir=. src/**/*.ts",
     "clean": "rimraf --glob '*.js' '*.d.ts' '*.map' doc",
     "doc": "typedoc --excludePrivate --excludeInternal --out doc src/index.ts",
     "doc:ae": "mkdir -p .ae/doc .ae/temp && api-extractor run --local --verbose",
@@ -33,11 +35,11 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@thi.ng/errors": "^2.4.4"
+    "@thi.ng/errors": "^2.4.6"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.38.3",
-    "@thi.ng/testament": "^0.4.3",
+    "esbuild": "^0.19.8",
     "rimraf": "^5.0.5",
     "tools": "^0.0.1",
     "typedoc": "^0.25.4",
@@ -92,5 +94,5 @@
     "status": "beta",
     "year": 2020
   },
-  "gitHead": "04d1de79f256d7a53c6b5fd157b37f49bc88e11d\n"
+  "gitHead": "5e7bafedfc3d53bc131469a28de31dd8e5b4a3ff\n"
 }

package/plastic.js

@@ -1,42 +1,22 @@
 import { assert } from "@thi.ng/errors/assert";
 import { kronecker } from "./kronecker.js";
 import { lowDiscrepancy } from "./lowdisc.js";
-/**
- * Computes the `d`-th Harmonious number, with:
- *
- * - d=1 : PHI (Golden ratio)
- * - d=2 : PLASTIC (Plastic number)
- *
- * @remarks
- * See {@link plasticND} for references.
- *
- * @param d -
- * @param i -
- */
-export const phi = (d, i = 18) => {
-    assert(d > 0, `d must be > 0`);
-    d = 1 / (d + 1);
-    let x = 2;
-    while (i-- > 0)
-        x = (1 + x) ** d;
-    return x;
+const phi = (d, i = 18) => {
+  assert(d > 0, `d must be > 0`);
+  d = 1 / (d + 1);
+  let x = 2;
+  while (i-- > 0)
+    x = (1 + x) ** d;
+  return x;
 };
-/**
- * Additive Recurrence R2 sequence using n-dimensional {@link kronecker}
- * configured with Harmonious Numbers (based on Plastic number).
- *
- * @remarks
- * References:
- *
- * - http://extremelearning.com.au/unreasonable-effectiveness-of-quasirandom-sequences/
- * - https://en.wikipedia.org/wiki/Plastic_number
- * - https://bib.irb.hr/datoteka/628836.Plastic_Number_-_Construct.pdf
- *
- * @param dim -
- */
-export const plasticND = (dim, offset = 0) => {
-    const g = phi(dim);
-    return lowDiscrepancy(new Array(dim)
-        .fill(0)
-        .map((_, i) => kronecker(1 / Math.pow(g, i + 1), 0.5)), offset);
+const plasticND = (dim, offset = 0) => {
+  const g = phi(dim);
+  return lowDiscrepancy(
+    new Array(dim).fill(0).map((_, i) => kronecker(1 / Math.pow(g, i + 1), 0.5)),
+    offset
+  );
+};
+export {
+  phi,
+  plasticND
 };