smath 1.15.0 → 1.16.0

package/dist/bin.js

@@ -1,10 +1,7 @@
 #!/usr/bin/env node
-"use strict";
-var _a, _b, _c, _d;
-Object.defineProperty(exports, "__esModule", { value: true });
-var SMath = require(".");
-var func = ((_a = process.argv[2]) !== null && _a !== void 0 ? _a : '').toLowerCase(), nums = process.argv.slice(3).map(function (arg, i) {
-    var num = Number.parseFloat(arg);
+import * as SMath from './index.js';
+const func = (process.argv[2] ?? '').toLowerCase(), nums = process.argv.slice(3).map((arg, i) => {
+    const num = Number.parseFloat(arg);
     if (Number.isFinite(num)) {
         return num;
     }
@@ -53,7 +50,7 @@ if (func.includes('help')) {
 }
 switch (func) {
     case ('approx'): {
-        console.log(SMath.approx(nums[0], nums[1], (_b = nums[2]) !== null && _b !== void 0 ? _b : 1e-6));
+        console.log(SMath.approx(nums[0], nums[1], nums[2] ?? 1e-6));
         break;
     }
     case ('clamp'): {
@@ -157,11 +154,11 @@ switch (func) {
         break;
     }
     case ('rat'): {
-        console.log(SMath.rat(nums[0], (_c = nums[1]) !== null && _c !== void 0 ? _c : 1e-6));
+        console.log(SMath.rat(nums[0], nums[1] ?? 1e-6));
         break;
     }
     case ('mixed'): {
-        console.log(SMath.mixed(nums[0], (_d = nums[1]) !== null && _d !== void 0 ? _d : 1e-6));
+        console.log(SMath.mixed(nums[0], nums[1] ?? 1e-6));
         break;
     }
     case (''): {

package/dist/index.js

@@ -1,47 +1,3 @@
-"use strict";
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.approx = approx;
-exports.clamp = clamp;
-exports.normalize = normalize;
-exports.expand = expand;
-exports.translate = translate;
-exports.linspace = linspace;
-exports.logspace = logspace;
-exports.factorial = factorial;
-exports.factors = factors;
-exports.round2 = round2;
-exports.error = error;
-exports.sum = sum;
-exports.prod = prod;
-exports.avg = avg;
-exports.median = median;
-exports.varp = varp;
-exports.vars = vars;
-exports.stdevp = stdevp;
-exports.stdevs = stdevs;
-exports.runif = runif;
-exports.rint = rint;
-exports.rnorm = rnorm;
-exports.rdist = rdist;
-exports.shuffle = shuffle;
-exports.selectRandom = selectRandom;
-exports.selectRandomWeighted = selectRandomWeighted;
-exports.lim = lim;
-exports.differentiate = differentiate;
-exports.integrate = integrate;
-exports.rat = rat;
-exports.mixed = mixed;
 /**
  * @packageDocumentation
  * Small math function library
@@ -59,8 +15,7 @@ exports.mixed = mixed;
  * const b1 = SMath.approx(1 / 3, 0.33, 1e-6), // false
  *       b2 = SMath.approx(1 / 3, 0.33, 1e-2); // true
  */
-function approx(a, b, epsilon) {
-    if (epsilon === void 0) { epsilon = 1e-6; }
+export function approx(a, b, epsilon = 1e-6) {
     return a - b < epsilon && b - a < epsilon;
 }
 /**
@@ -73,7 +28,7 @@ function approx(a, b, epsilon) {
  * const n1 = SMath.clamp(5, 0, 10),  // 5
  *       n2 = SMath.clamp(-2, 0, 10); // 0
  */
-function clamp(n, min, max) {
+export function clamp(n, min, max) {
     if (n < min) {
         return min;
     }
@@ -91,7 +46,7 @@ function clamp(n, min, max) {
  * @example
  * const y = SMath.normalize(18, 9, 99); // 0.1
  */
-function normalize(n, min, max) {
+export function normalize(n, min, max) {
     if (min === max) {
         return 0;
     }
@@ -106,7 +61,7 @@ function normalize(n, min, max) {
  * @example
  * const y = SMath.expand(0.25, 4, 6); // 4.5
  */
-function expand(n, min, max) {
+export function expand(n, min, max) {
     return (max - min) * n + min;
 }
 /**
@@ -121,7 +76,7 @@ function expand(n, min, max) {
  * const C = 20,
  *       F = SMath.translate(C, 0, 100, 32, 212); // 68
  */
-function translate(n, min1, max1, min2, max2) {
+export function translate(n, min1, max1, min2, max2) {
     return expand(normalize(n, min1, max1), min2, max2);
 }
 /**
@@ -134,9 +89,9 @@ function translate(n, min1, max1, min2, max2) {
  * const space = SMath.linspace(1, 5, 6);
  * // [ 1, 1.8, 2.6, 3.4, 4.2, 5 ]
  */
-function linspace(min, max, count) {
-    var space = [];
-    for (var i = 0; i < count; i++) {
+export function linspace(min, max, count) {
+    const space = [];
+    for (let i = 0; i < count; i++) {
         space[i] = translate(i, 0, count - 1, min, max);
     }
     return space;
@@ -151,8 +106,8 @@ function linspace(min, max, count) {
  * const space = SMath.logspace(0, 2, 5);
  * // [ 1, 3.2, 10, 31.6, 100 ]
  */
-function logspace(min, max, count) {
-    return linspace(min, max, count).map(function (n) { return Math.pow(10, n); });
+export function logspace(min, max, count) {
+    return linspace(min, max, count).map(n => 10 ** n);
 }
 /**
  * Compute the factorial of `n`.
@@ -161,7 +116,7 @@ function logspace(min, max, count) {
  * @example
  * const y = SMath.factorial(5); // 120
  */
-function factorial(n) {
+export function factorial(n) {
     if (n < 0 || (n | 0) !== n) {
         throw new Error('Input must be a positive integer.');
     }
@@ -182,15 +137,15 @@ function factorial(n) {
  * @example
  * const y = SMath.factors(12); // [ 2, 2, 3 ]
  */
-function factors(n) {
+export function factors(n) {
     if (n < 0 || (n | 0) !== n) {
         throw new Error('Input must be a positive integer!');
     }
     if (n <= 3) {
         return [n];
     }
-    var f = [];
-    var i = 2;
+    const f = [];
+    let i = 2;
     while (n > 1 && i <= n) {
         if ((n / i) === ((n / i) | 0)) {
             n /= i;
@@ -211,9 +166,9 @@ function factors(n) {
  * @example
  * const y = SMath.round2(Math.PI, 0.2); // 3.2
  */
-function round2(n, base) {
-    var rounded = base ? base * Math.round(n / base) : n;
-    var precision = 10; // Removes precision errors
+export function round2(n, base) {
+    const rounded = base ? base * Math.round(n / base) : n;
+    const precision = 10; // Removes precision errors
     return parseFloat(rounded.toFixed(precision));
 }
 /**
@@ -229,7 +184,7 @@ function round2(n, base) {
  * @example
  * const e = SMath.error(22.5, 25); // -0.1
  */
-function error(experimental, actual) {
+export function error(experimental, actual) {
     if (experimental === 0 && actual === 0) {
         return 0;
     }
@@ -245,8 +200,8 @@ function error(experimental, actual) {
  * @example
  * const y = SMath.sum([1, 2, 3]); // 6
  */
-function sum(data) {
-    return data.reduce(function (a, b) { return a + b; }, 0);
+export function sum(data) {
+    return data.reduce((a, b) => a + b, 0);
 }
 /**
  * Multiply all the inputs.
@@ -256,8 +211,8 @@ function sum(data) {
  * @example
  * const y = SMath.prod([2, 2, 3, 5]); // 60
  */
-function prod(data) {
-    return data.reduce(function (a, b) { return a * b; }, 1);
+export function prod(data) {
+    return data.reduce((a, b) => a * b, 1);
 }
 /**
  * Compute the average, or mean, of a set of numbers.
@@ -266,7 +221,7 @@ function prod(data) {
  * @example
  * const y = SMath.avg([1, 2, 4, 4]); // 2.75
  */
-function avg(data) {
+export function avg(data) {
     return sum(data) / data.length;
 }
 /**
@@ -276,8 +231,8 @@ function avg(data) {
  * @example
  * const y = SMath.median([2, 5, 3, 1]); // 2.5
  */
-function median(data) {
-    data.sort(function (a, b) { return a - b; });
+export function median(data) {
+    data.sort((a, b) => a - b);
     if (data.length % 2) {
         return data[(data.length - 1) / 2];
     }
@@ -290,8 +245,8 @@ function median(data) {
  * @example
  * const y = SMath.varp([1, 2, 4, 4]); // 1.6875
  */
-function varp(data) {
-    var mean = avg(data), squares = data.map(function (x) { return Math.pow((x - mean), 2); });
+export function varp(data) {
+    const mean = avg(data), squares = data.map(x => (x - mean) ** 2);
     return sum(squares) / data.length;
 }
 /**
@@ -301,8 +256,8 @@ function varp(data) {
  * @example
  * const y = SMath.vars([1, 2, 4, 4]); // 2.25
  */
-function vars(data) {
-    var mean = avg(data), squares = data.map(function (x) { return Math.pow((x - mean), 2); });
+export function vars(data) {
+    const mean = avg(data), squares = data.map(x => (x - mean) ** 2);
     return sum(squares) / (data.length - 1);
 }
 /**
@@ -312,7 +267,7 @@ function vars(data) {
  * @example
  * const y = SMath.stdevp([1, 2, 3, 4]); // 1.118...
  */
-function stdevp(data) {
+export function stdevp(data) {
     return Math.sqrt(varp(data));
 }
 /**
@@ -322,7 +277,7 @@ function stdevp(data) {
  * @example
  * const y = SMath.stdevs([1, 2, 3, 4]); // 1.29...
  */
-function stdevs(data) {
+export function stdevs(data) {
     return Math.sqrt(vars(data));
 }
 /**
@@ -333,7 +288,7 @@ function stdevs(data) {
  * @example
  * const y = SMath.runif(-2, 2); // 0.376...
  */
-function runif(min, max) {
+export function runif(min, max) {
     return expand(Math.random(), min, max);
 }
 /**
@@ -344,7 +299,7 @@ function runif(min, max) {
  * @example
  * const y = SMath.rint(-4, 3); // -4
  */
-function rint(min, max) {
+export function rint(min, max) {
     min |= 0;
     max |= 0;
     if (min < 0) {
@@ -363,9 +318,7 @@ function rint(min, max) {
  * @example
  * const y = SMath.rnorm(2, 3); // 1.627...
  */
-function rnorm(mean, stdev) {
-    if (mean === void 0) { mean = 0; }
-    if (stdev === void 0) { stdev = 1; }
+export function rnorm(mean = 0, stdev = 1) {
     return mean + stdev * Math.sqrt(-2 * Math.log(Math.random())) * Math.cos(2 * Math.PI * Math.random());
 }
 /**
@@ -377,11 +330,9 @@ function rnorm(mean, stdev) {
  * @example
  * const dataset = SMath.rdist(3); // [ 1.051..., -0.779..., -2.254... ]
  */
-function rdist(count, mean, stdev) {
-    if (mean === void 0) { mean = 0; }
-    if (stdev === void 0) { stdev = 1; }
-    var distribution = [];
-    for (var i = 0; i < count; i++) {
+export function rdist(count, mean = 0, stdev = 1) {
+    const distribution = [];
+    for (let i = 0; i < count; i++) {
         distribution[i] = rnorm(mean, stdev);
     }
     return distribution;
@@ -393,13 +344,12 @@ function rdist(count, mean, stdev) {
  * @example
  * const shuffled = SMath.shuffle(['a', 'b', 'c']); // [ 'c', 'a', 'b' ]
  */
-function shuffle(stack) {
-    var rawData = [];
-    for (var _i = 0, stack_1 = stack; _i < stack_1.length; _i++) {
-        var item = stack_1[_i];
+export function shuffle(stack) {
+    const rawData = [];
+    for (const item of stack) {
         rawData.push({ index: Math.random(), value: item });
     }
-    return rawData.sort(function (a, b) { return a.index - b.index; }).map(function (a) { return a.value; });
+    return rawData.sort((a, b) => a.index - b.index).map(a => a.value);
 }
 /**
  * Select a single item from an array at random with uniform weights.
@@ -408,24 +358,25 @@ function shuffle(stack) {
  * @example
  * const selected = SMath.selectRandom([10, 20, 30, 40]); // 30
  */
-function selectRandom(stack) {
+export function selectRandom(stack) {
     return stack[rint(0, stack.length - 1)];
 }
 /**
  * Select a single index in an array at random with different weights.
  * @param weights The weights for each item
- * @returns The index of the randomly selected item
+ * @returns The 0-based index of the randomly selected item
+ * @example
+ * const index = SMath.selectRandomWeighted([3.5, 4, 1]); // 1
  */
-function selectRandomWeighted(weights) {
-    var startWeights = [];
-    var accumulation = 0;
-    for (var _i = 0, weights_1 = weights; _i < weights_1.length; _i++) {
-        var weight = weights_1[_i];
+export function selectRandomWeighted(weights) {
+    const startWeights = [];
+    let accumulation = 0;
+    for (const weight of weights) {
         accumulation += clamp(0, weight, Infinity);
         startWeights.push(accumulation);
     }
-    var random = runif(0, accumulation);
-    return startWeights.findIndex(function (weight) { return random < weight; });
+    const random = runif(0, accumulation);
+    return startWeights.findIndex(weight => random < weight);
 }
 /**
  * Take the limit of a function. A return value of `NaN` indicates
@@ -438,11 +389,9 @@ function selectRandomWeighted(weights) {
  * @example
  * const y = SMath.lim(Math.log, 0); // -Infinity
  */
-function lim(f, x, h, discontinuity_cutoff) {
-    if (h === void 0) { h = 1e-6; }
-    if (discontinuity_cutoff === void 0) { discontinuity_cutoff = 1e-3; }
-    var center = f(x), left1 = f(x - h), left2 = f(x - h / 2), right1 = f(x + h), right2 = f(x + h / 2);
-    var left, right;
+export function lim(f, x, h = 1e-6, discontinuity_cutoff = 1e-3) {
+    const center = f(x), left1 = f(x - h), left2 = f(x - h / 2), right1 = f(x + h), right2 = f(x + h / 2);
+    let left, right;
     if (Number.isFinite(center)) {
         return center;
     }
@@ -511,9 +460,8 @@ function lim(f, x, h, discontinuity_cutoff) {
  * @example
  * const y = SMath.differentiate(x => 3 * x ** 2, 2); // 12
  */
-function differentiate(f, x, epsilon) {
-    if (epsilon === void 0) { epsilon = 1e-6; }
-    return lim(function (h) { return (f(x + h) - f(x - h)) / (2 * h); }, 0, epsilon);
+export function differentiate(f, x, epsilon = 1e-6) {
+    return lim(h => (f(x + h) - f(x - h)) / (2 * h), 0, epsilon);
 }
 /**
  * Compute the definite integral of a function.
@@ -525,9 +473,8 @@ function differentiate(f, x, epsilon) {
  * @example
  * const y = SMath.integrate(x => 3 * x ** 2, 1, 2); // 7
  */
-function integrate(f, a, b, Ndx) {
-    if (Ndx === void 0) { Ndx = 1e6; }
-    return ((b - a) / Ndx) * sum(linspace(a, b, Ndx).map(function (x) { return f(x); }));
+export function integrate(f, a, b, Ndx = 1e6) {
+    return ((b - a) / Ndx) * sum(linspace(a, b, Ndx).map(x => f(x)));
 }
 /**
  * Convert an arbitrary decimal number into a simplified fraction (or ratio).
@@ -538,10 +485,9 @@ function integrate(f, a, b, Ndx) {
  * @example
  * const frac = SMath.rat(0.625); // { num: 5, den: 8 }
  */
-function rat(n, epsilon) {
-    if (epsilon === void 0) { epsilon = 1e-6; }
-    var num = 0, den = 1;
-    var sign = n < 0 ? -1 : 1;
+export function rat(n, epsilon = 1e-6) {
+    let num = 0, den = 1;
+    const sign = n < 0 ? -1 : 1;
     while (!approx(sign * n, num / den, epsilon)) {
         if (sign * n > num / den) {
             num++;
@@ -562,7 +508,6 @@ function rat(n, epsilon) {
  * @example
  * const frac = SMath.mixed(-8 / 6); // { whole: -1, num: 1, den: 3 }
  */
-function mixed(n, epsilon) {
-    if (epsilon === void 0) { epsilon = 1e-6; }
-    return __assign({ whole: n | 0 }, rat(n < -1 ? (n | 0) - n : n - (n | 0), epsilon));
+export function mixed(n, epsilon = 1e-6) {
+    return { whole: n | 0, ...rat(n < -1 ? (n | 0) - n : n - (n | 0), epsilon) };
 }

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "smath",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "Small math function library",
   "homepage": "https://npm.nicfv.com/",
+  "type": "module",
   "bin": "dist/bin.js",
   "main": "dist/index.js",
   "types": "types/index.d.ts",
@@ -52,7 +53,7 @@
   "repository": "github:nicfv/npm",
   "license": "MIT",
   "devDependencies": {
-    "@types/node": "25.0.10",
-    "t6": "1.2.1"
+    "@types/node": "25.6.0",
+    "t6": "1.3.0"
   }
 }

package/types/index.d.ts

@@ -244,7 +244,9 @@ export declare function selectRandom<T>(stack: T[]): T;
 /**
  * Select a single index in an array at random with different weights.
  * @param weights The weights for each item
- * @returns The index of the randomly selected item
+ * @returns The 0-based index of the randomly selected item
+ * @example
+ * const index = SMath.selectRandomWeighted([3.5, 4, 1]); // 1
  */
 export declare function selectRandomWeighted(weights: number[]): number;
 /**