A tiny math library for node.js, deno, bun & JavaScript on browser

// JavaScript
0.1 + 0.2 = 0.30000000000000004   // 0.1 + 0.2 === 0.3 returns false
0.2 + 0.7 = 0.8999999999999999    // 0.2 + 0.7 === 0.9 returns false
0.7 - 0.2 = 0.49999999999999994   // 0.7 - 0.2 === 0.5 returns false
0.1 * 0.2 = 0.020000000000000004  // 0.1 * 0.2 === 0.02 returns false
0.3 / 0.1 = 2.9999999999999996    // 0.3 / 0.1 === 3 returns false
1.2 % 0.5 = 0.19999999999999996   // 1.2 / 0.5 === 0.2 returns false

// NATIVE MATH library
nm.add(0.1, 0.2)   = 0.3      // nm.add(0.1, 0.2)  === 0.3 returns true
nm.add(0.2, 0.7)   = 0.9      // nm.add(0.2, 0.7)  === 0.9 returns true
nm.subt(0.7, 0.2)  = 0.5      // nm.subt(0.7, 0.2) === 0.5 returns true
nm.mult(0.1, 0.2)  = 0.02     // nm.mult(0.1, 0.2) === 0.02 returns true
nm.divi(0.3, 0.1)  = 3        // nm.divi(0.3, 0.1) === 3 returns true
nm.rem(1.2, 0.5)   = 0.2      // nm.rem(1.2, 0.5)  === 0.2 returns true

// Next JS
// index.js
// npm install native_math
import nm from 'native_math';
import React from 'react';

const Home = () => {

  const price = 4.5 / 3;

  return (
    <div>
      <ul>
        <li>{nm.add([1,8], 1).[1]}</li>
        <li>{nm.fix(1, 2)}</li>
        <li>{nm.fix(nm.phi,2)}</li>
        <li>{nm.stn('8.00')}</li>
        <li>{nm.zeros(2,2)}</li>
        <li>{nm.zeros(2.1,2)}</li>
        <li>{nm.zeros(2.1440000000,2)}</li>
        <li>{nm.zeros(2.1440000000,5)}</li>
        <li>${nm.zeros(price,2)}</li>
        <li>
            <a
              className="App-link"
              href="https://www.npmjs.com/package/native_math"
              target="_blank"
              rel="noopener noreferrer"
            >
              Learn NATIVE MATH Library
            </a>
        </li>
      </ul>
    </div>
  );
};

export default Home;

// React JS
// App.js
// npm install native_math
import { divi, zeros, stn, nts } from 'native_math';
import logo from './logo.svg';
import './App.css';

function App() {
	const price = divi(4.2, 3);
	const priceWithFormat = zeros(price, 2);

	return (
		<div className="App">
			<header className="App-header">
				<img src={logo} className="App-logo" alt="logo" />
				<p>
					Edit <code>src/App.js</code> and save to reload.
				</p>
				<a className="App-link" href="https://reactjs.org" target="_blank" rel="noopener noreferrer">
					Learn React
				</a>
				<br />
				<a className="App-link" href="https://www.npmjs.com/package/native_math" target="_blank" rel="noopener noreferrer">
					Learn NATIVE MATH Library
				</a>
				<h2>
					<p>${nts(0.0)}</p>
					Free ${zeros(stn('0.00'), 2)} <strike>${priceWithFormat}</strike>
				</h2>
				<small>Type: {typeof priceWithFormat}</small>
			</header>
		</div>
	);
}

export default App;

// Node JS
// index.js
// npm install native_math

// import nm from 'native_math';
// console.log(nm.sin.deg(nm.range(0, 90, 30)));
// Or

import { sin, range } from 'native_math';
console.log(sin.deg(range(0, 90, 30)));

const nm = require(`native_math`);

nm.abs(-3.6); // 3.6

nm.subt(2, 5); // -3

nm.sqr(2) + nm.sqrt(4); // 6

nm.sqr(4) + nm.sqrt(4) / nm.pi; // 16.63661977236758

nm.e; // 2.718281828459045

nm.exp(1); // 2.718281828459045

nm.exp(-1); // 0.367879441171442

nm.exp(nm.pi / 3); // 2.849653908226361

nm.log(10); // 2.302585092994046

nm.ln2; // 0.693147180559945
nm.ln10; // 2.302585092994046

nm.log2e; // 1.442695040888963
nm.log10e; // 0.434294481903252

nm.log1p(5); // 1.791759469228055

nm.log(mnjs.e); // 1

nm.hypot(4); // 4
nm.hypot([4]); // 4
nm.hypot(3, 4); // 5
nm.hypot([3, 4]); // 5
nm.hypot(4, 2, 4); // 6
nm.hypot([4, 2, 4]); // 6
nm.hypot([-3, -4]); // 5
nm.hypot(-3, -4); // 5
nm.hypot([-4]); // 4
nm.hypot(-4); // 4
nm.sqrt(nm.add(nm.sqr(6), nm.sqr(8))) === nm.hypot(6, 8); // true
nm.hypot([-3, -4], 1); // Error: NATIVE MATH ERROR No. 01 : 05
mnjs.hypot([-3, -4], [1]); // Error: NATIVE MATH ERROR No. 01 : 05
mnjs.hypot([-3, -4, '1']); // Error: NATIVE MATH ERROR No. 01 : 05

nm.fix(2.718281828459045, 2); // 2.72

nm.inv(10); // 0.1

nm.ceil(1.1); // 2
nm.ceil(-1.1); // -1
nm.ceil([-0.2, 0, 0.2]); // [-0, 0, 1]

nm.max(1, 10, 3, -2); // 10
nm.max([1, 10, 3, -2]); // 10
nm.max(1, 10, 3, ''); // Error: NATIVE MATHnm ERROR No. 01 : 05

nm.min(5, 1, -3.2, 0.5, 3); // -3.2
nm.min([5, 1, -3.2, 0.5, 3]); // -3.2
nm.min(); // Error: NATIVE MATHnm ERROR No. 01 : 05
nm.min([]); // Error: NATIVE MATHnm ERROR No. 01 : 05: This function accepts numeric arguments or one numeric array argument. (num1, num2, ..., num) => {} or ([num1, num2, ..., num]) => {}

nm.pow(2, 4); // 16

nm.pow(2, -2.5); // 0.176776695296637

nm.cbrt(8); // 2

nm.nrt(0.0001, 4); // 0.1
nm.nrt(Infinity, Infinity); // 1
nm.nrt(Infinity, Infinity) === nm.pow(Infinity, 1 / Infinity); // true

nm.tau; // 6.283185307179586

nm.sin(1); // 0.841470984807897
nm.sin.rad(1); // 0.841470984807897
nm.sin(1) === nm.sin.rad(1); // true

nm.dtr(30); // 0.523598775598299
nm.sin.deg(30); // 0.5
nm.sin.deg(30) === nm.sin(mnjs.dtr(30)); // true

nm.cos.deg(60); // 0.5
nm.cos(0); // 1
nm.cos.rad(0); // 1
nm.cos(1) === nm.cos.rad(1); // true

nm.tan.deg(45); // 1

nm.tan(0.5); // 0.54630248984379
nm.tan(0.5) === nm.tan.rad(0.5); // true

nm.tan.deg(90); // -Infinity

1 / nm.sin.deg(30); // 2
nm.csc.deg(30)(
	// 2

	1 / nm.cos.deg(60)
) === nm.sec.deg(60); // true
console.log(nm.sec.deg(60))(
	// 2

	1 / nm.tan.deg(45)
) === nm.cot.deg(45); // true
nm.cot.deg(45); // 1

nm.cot.deg(0); // Infinity

nm.acsc(mnjs.csc(0.67)); // 0.67

nm.asec.rad(1) === nm.asec(1); // true

nm.stn('123'); // 123
nm.nts(123); // "123"

/***** Matrices *****/
nm.range(1, 10, 1); //  [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ]
nm.range(1, 10); //  [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ]
nm.range(10, 1, 1); //  [ 10, 9, 8, 7, 6, 5, 4, 3, 2, 1 ]
nm.range(10, 1); //  [ 10, 9, 8, 7, 6, 5, 4, 3, 2, 1 ]
nm.range(1, 5, 0.5); //  [ 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5 ]
nm.range(1, 0, 0.2); //  [ 1, 0.8, 0.6, 0.4, 0.2, 0 ]
nm.range(10, 1, 2); //  [ 10, 8, 6, 4, 2 ]
nm.range(-20, 1, 0); //  Error: NATIVE MATH ERROR No. 02 : 01: The step parameter should not be:
//  1/ null
//  2/ equal or less than zero.
//  3/ greater than the absolute difference between the first and second parameter

nm.monolist(1, 5); //  [ 1, 1, 1, 1, 1 ]
nm.monolist(0.5, 3); //  [ 0.5, 0.5, 0.5 ]
nm.monolist(0, 5); //  [ 0, 0, 0, 0, 0 ]
nm.monolist(-0.5, 3); //  [ -0.5, -0.5, -0.5 ]
nm.monolist(-1, 5); //  [ -1, -1, -1, -1, -1 ]
nm.monolist(5, 1.1); //  RangeError: Invalid array length

// Most of the NATIVE MATH functions return a number or an array of numbers

const myArray = nm.range(0, 90, 30);
const errArray = [0, 30, '60', 90];

myArray; //  [ 0, 30, 60, 90 ]
errArray; //  [ 0, 30, '60', 90 ]

nm.cube(myArray); // [ 0, 27000, 216000, 729000 ]

nm.sin.deg(myArray[1]); // 0.5
nm.sin.deg(myArray); // [ 0, 0.5, 0.866025403784439, 1 ]

nm.abs(errArray); // Error: NATIVE MATHnm ERROR No. 01: This function accepting either a number or an array.
// In the case of an array, all of its elements must be numbers.
nm.dtr(myArray); // [ 0, 0.523598775598299, 1.047197551196598, 1.570796326794897 ]

// Note the result may change in some functions depending on the position of the arguments

nm.add(2, 2); //  4
nm.add([0, 2], [4, 8]); //  [ 4, 10 ]
nm.add([4, 8], [0, 2]); //  [ 4, 10 ]
nm.add(2, [1, 2]); //  [ 3, 4 ]
nm.add([1, 2], 2); //  [ 3, 4 ]
nm.subt(2, [1, 2]); //  [ 1, 0 ]
nm.subt([1, 2], 2); //  [ -1, 0 ]
nm.subt([0, 2], [4, 8]); //  [ -4, -6 ]
nm.subt([4, 8], [0, 2]); //  [ 4, 6 ]
nm.mult(2, [1, 2]); //  [ 2, 4 ]
nm.mult([1, 2], 2); //  [ 2, 4 ]
nm.divi(2, [1, 2]); //  [ 2, 1 ]
nm.divi([1, 2], 2); //  [ 0.5, 1 ]
nm.divi([0, 2], [4, 8]); //  [ 0, 0.25 ]
nm.divi([4, 8], [0, 2]); //  [ Infinity, 4 ]
nm.add([2], [1, 2]); // Error: NATIVE MATH ERROR No. 01 : 03: This function accepting two arguments of numbers, arrays, or one of them must be a number, and the other must be an array; In the case of arrays, all elements must be a number, the length of arrays must be equal

nm.pow(4, [1, 2, 3]); //  [ 4, 16, 64 ]
nm.pow([1, 2, 3], 4); //  [ 1, 16, 81 ]

nm.nrt(8, [1, 2, 3]); //  [ 8, 2.82842712474619, 2 ]
nm.nrt([1, 2, 3], 8); //  [ 1, 1.090507732665258, 1.147202690439877 ]
nm.nrt([1, 3], [3, 1]); //  [ 1, 3 ]
nm.nrt([3, 1], [1, 3]); //  [ 3, 1 ]

nm.mult(0.2, [5, 10, 15]); //  [ 1, 2, 3 ]
nm.mult(0.2, nm.range(5, 15, 5)); //  [ 1, 2, 3 ]
nm.mult([0.2, 0.2, 0.2], [5, 10, 15]); //  [ 1, 2, 3 ]
nm.mult(nm.monolist(0.2, 3), [5, 10, 15]); //  [ 1, 2, 3 ]
nm.mult(0.2, [5, 10, 15])[1] === nm.mult(nm.monolist(0.2, 3), [5, 10, 15])[1]; // true

nm.imul(0xffffffff, [1, 2, 3, 4, 5]); //  [ -1, -2, -3, -4, -5 ]
nm.rib(100000, 999999); //  returns random integer between two values, inclusive min and max value

// Remember that:
// 0 / 0 = NaN, NaN / NaN = NaN, Infinity / Infinity = NaN, Infinity / NaN = NaN
// NaN / Infinity = NaN, 0 / NaN = NaN, NaN / 0 = Nan
// 0 / Infinity = 0, Infinity / 0 = Infinity
// Infinity === Infinity returns true. Infinity is equal to itself
// Infinity > Infinity, return false
// NaN === NaN, NaN > NaN, NaN < NaN, returns false
// Infinity === NaN, Infinity > NaN, Infinity < NaN, returns false

// The change function replace x (number or numeric array element) with z if x = y
// The change and change.isEqual functions are the same
// nm.change(x=1, y=1, z=0)
nm.change(1, 1, 0) === mnjs.change.isEqual(1, 1, 0); // returns true
nm.change(1, 1, 0); //  returns 0
nm.change(1, NaN, 0); //  returns 1
nm.change(Infinity, Infinity, 0); //  returns 0
nm.change([0, NaN, 1, Infinity], NaN, 0); //  returns [0, NaN, 1, Infinity]
// where [0 = old value, NaN = old value, 1 = old value, Infinity = old value], nothing changed!
nm.change([0, NaN, 1, Infinity], Infinity, 0); //  returns [0, NaN, 1, 0]
// where [0 = old value, NaN = old value, 1 = old value, 0 = new value ], only Infinity value replaced with 0

// The change.isNotEqual function replace x (number or numeric array element) with z if x is not equal to y
// nm.change.isNotEqual(x=1, y=1, z=0)
nm.change.isEqual(1, 1, 0) !== nm.change.isNotEqual(1, 1, 0); // returns true
nm.change.isNotEqual(1, 1, 0); //  returns 1, where 1 is the old value of x
nm.change.isNotEqual(1, NaN, 0); //  returns 0, where 0 is the new value of x
nm.change.isNotEqual(Infinity, Infinity, 0); //  returns Infinity
nm.change.isNotEqual([0, NaN, 1, Infinity], NaN, 0); //  returns [0, 0, 0, 0]
// where [0 = new value, 0 = new value, 0 = new value, 0 = new value], all elements changed with new values!
nm.change.isNotEqual([0, NaN, 1, Infinity], Infinity, 0); //  returns [0, 0, 0, Infinity]
// where [0 = new value, 0 = new value, 0 = new value, Infinity = old value ], all elements replaced with 0 except Infinity
nm.change.isGreater([0, NaN, 1, Infinity], NaN, 0); //  returns [0, NaN, 1, Infinity]
nm.change.isLess([0, NaN, 1, Infinity], NaN, 0); //  returns [0, NaN, 1, Infinity]
nm.change.isGreaterOrEqual([0, NaN, 1, Infinity], Infinity, 0); // returns [0, NaN, 1, 0]
// where orEqual is true (Infinity replaced by 0)
nm.change.isLessOrEqual([0, NaN, 1, Infinity], Infinity, 0); // returns [0, NaN, 0, 0]
// change.isFiniteNum(x, y) or change.isFiniteNum(xArray, y)
nm.change.isFiniteNum([0, NaN, 1, Infinity], Infinity); // returns [Infinity, NaN, Infinity, Infinity]
// where [Infinity = new value, NaN = old value, Infinity = new value, Infinity = old value]
nm.change.isInfinity([-Infinity, NaN, 1, Infinity], 0); // returns [0, NaN, 1, 0]  (change ±Infinity)
nm.change.isPlusInfinity([-Infinity, NaN, 1, Infinity], 0); // returns [-Infinity, NaN, 1, 0]
nm.change.isMinusInfinity([-Infinity, NaN, 1, Infinity], 0); // returns [0, NaN, 1, Infinity]
nm.change.isNAN([-Infinity, NaN, 1, Infinity], 0); // returns [-Infinity, 0, 1, Infinity]

// Fermat number
nm.fermat(-1) or nm.fermat(1.2) // returns error
nm.fermat(0) // returns 3
nm.fermat([0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]) // returns [5, 17, 257, ..., 1.3407807929942597e+154, Infinity]