smath 1.6.0 → 1.6.2

package/README.md

@@ -2,7 +2,7 @@
 
 ![NPM Downloads](https://img.shields.io/npm/dt/smath)
 ![NPM Version](https://img.shields.io/npm/v/smath)
-![Relative date](https://img.shields.io/date/1711573124)
+![Relative date](https://img.shields.io/date/1712342048)
 ![GitHub watchers](https://img.shields.io/github/watchers/nicfv/npm)
 ![GitHub forks](https://img.shields.io/github/forks/nicfv/npm)
 ![GitHub Repo stars](https://img.shields.io/github/stars/nicfv/npm)
@@ -12,7 +12,7 @@
 smath can be installed from the official [npm package repository](https://www.npmjs.com/package/smath). It is highly recommended to install the latest version, which is installed by default with the following command.
 
 ```shell
-npm i smath@1.6.0
+npm i smath@1.6.2
 ```
 
 ## Bugs and Requests

package/dist/bin.js

@@ -26,6 +26,7 @@ if (func.includes('help')) {
     console.log('  translate <n> <min1> <max1> <min2> <max2>');
     console.log('                           : Linearly interpolate `n` from `min1`, `max1` to `min2`, `max2`');
     console.log('  factorial <n>            : Compute `n!` (factorial)');
+    console.log('  factors <n>              : List the prime factors of `n`');
     console.log('  error <exp> <act>        : Calculate the normaized percent error between `exp` and `act`');
     console.log('  sum <c0> [c1] ... [cn]   : Compute a total of `n` numbers');
     console.log('  prod <c0> [c1] ... [cn]  : Compute a product of `n` numbers');
@@ -70,6 +71,10 @@ switch (func) {
         console.log(_1.SMath.factorial(nums[0]));
         break;
     }
+    case ('factors'): {
+        console.log(_1.SMath.factors(nums[0]));
+        break;
+    }
     case ('error'): {
         console.log(_1.SMath.error(nums[0], nums[1]));
         break;

package/dist/index.js

@@ -156,6 +156,35 @@ var SMath = /** @class */ (function () {
             return n * this.factorial(n - 1);
         }
     };
+    /**
+     * Factorize `n` into its prime factors.
+     * @param n Any positive integer
+     * @returns The array of prime factors
+     * @example
+     * ```js
+     * const y = SMath.factors(12); // [ 2, 2, 3 ]
+     * ```
+     */
+    SMath.factors = function (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;
+        while (n > 1 && i <= n) {
+            if ((n / i) === ((n / i) | 0)) {
+                n /= i;
+                f.push(i);
+            }
+            else {
+                i++;
+            }
+        }
+        return f;
+    };
     /**
      * Calculate the relative normalized error or deviation from any
      * value to an accepted value. An error of 0 indicates that the
@@ -222,7 +251,7 @@ var SMath = /** @class */ (function () {
      * ```
      */
     SMath.median = function (data) {
-        data.sort();
+        data.sort(function (a, b) { return a - b; });
         if (data.length % 2) {
             return data[(data.length - 1) / 2];
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smath",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "Small math function library",
   "homepage": "https://npm.nicfv.com/smath",
   "bin": "dist/bin.js",
@@ -28,6 +28,11 @@
     "avg",
     "average",
     "mean",
+    "calculus",
+    "statistics",
+    "numeric",
+    "numerical",
+    "analysis",
     "interpolate",
     "interpolation",
     "extrapolate",
@@ -47,9 +52,9 @@
   "repository": "github:nicfv/npm",
   "license": "MIT",
   "devDependencies": {
-    "@types/node": "20.11.30",
+    "@types/node": "20.12.4",
     "exray": "1.0.2",
     "typedoc": "0.25.12",
-    "typescript": "5.4.3"
+    "typescript": "5.4.4"
   }
 }

package/types/index.d.ts

@@ -110,6 +110,16 @@ export declare abstract class SMath {
      * ```
      */
     static factorial(n: number): number;
+    /**
+     * Factorize `n` into its prime factors.
+     * @param n Any positive integer
+     * @returns The array of prime factors
+     * @example
+     * ```js
+     * const y = SMath.factors(12); // [ 2, 2, 3 ]
+     * ```
+     */
+    static factors(n: number): Array<number>;
     /**
      * Calculate the relative normalized error or deviation from any
      * value to an accepted value. An error of 0 indicates that the