@lijuhong1981/jsmath 1.0.0

package/index.js

@@ -0,0 +1,53 @@
+import {
+    PI,
+    ONE_OVER_PI,
+    PI_OVER_TWO,
+    PI_OVER_THREE,
+    PI_OVER_FOUR,
+    PI_OVER_SIX,
+    THREE_PI_OVER_TWO,
+    TWO_PI,
+    ONE_OVER_TWO_PI,
+    RADIANS_PER_DEGREE,
+    DEGREES_PER_RADIAN,
+    RADIANS_PER_ARCSECOND
+} from "./src/Constant.js";
+import clampToRange from "./src/clampToRange.js";
+import clampToLongitudeRange from "./src/clampToLongitudeRange.js";
+import clampToLatitudeRange from "./src/clampToLatitudeRange.js";
+import convertToRange from "./src/convertToRange.js";
+import convertToLongitudeRange from "./src/convertToLongitudeRange.js";
+import convertToLatitudeRange from "./src/convertToLatitudeRange.js";
+import convertToDegreesRound from "./src/convertToDegreesRound.js";
+import convertToRadiansRound from "./src/convertToRadiansRound.js";
+import percentInRange from "./src/percentInRange.js";
+import percentToRange from "./src/percentToRange.js";
+import randomInteger from "./src/randomInteger.js";
+import randomNumber from "./src/randomNumber.js";
+
+export {
+    PI,
+    ONE_OVER_PI,
+    PI_OVER_TWO,
+    PI_OVER_THREE,
+    PI_OVER_FOUR,
+    PI_OVER_SIX,
+    THREE_PI_OVER_TWO,
+    TWO_PI,
+    ONE_OVER_TWO_PI,
+    RADIANS_PER_DEGREE,
+    DEGREES_PER_RADIAN,
+    RADIANS_PER_ARCSECOND,
+    clampToRange,
+    clampToLongitudeRange,
+    clampToLatitudeRange,
+    convertToRange,
+    convertToLongitudeRange,
+    convertToLatitudeRange,
+    convertToDegreesRound,
+    convertToRadiansRound,
+    percentInRange,
+    percentToRange,
+    randomInteger,
+    randomNumber,
+};

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@lijuhong1981/jsmath",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "module": "index.js",
+  "type": "module",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "lijuhong1981",
+  "license": "ISC",
+  "dependencies": {
+    "@lijuhong1981/jscheck": "^1.0.0"
+  }
+}

package/src/Constant.js

@@ -0,0 +1,27 @@
+const PI = Math.PI;
+const ONE_OVER_PI = 1.0 / PI;
+const PI_OVER_TWO = PI / 2.0;
+const PI_OVER_THREE = PI / 3.0;
+const PI_OVER_FOUR = PI / 4.0;
+const PI_OVER_SIX = PI / 6.0;
+const THREE_PI_OVER_TWO = (3.0 * PI) / 2.0;
+const TWO_PI = 2.0 * PI;
+const ONE_OVER_TWO_PI = 1.0 / (2.0 * PI);
+const RADIANS_PER_DEGREE = PI / 180.0;
+const DEGREES_PER_RADIAN = 180.0 / PI;
+const RADIANS_PER_ARCSECOND = RADIANS_PER_DEGREE / 3600.0;
+
+export {
+    PI,
+    ONE_OVER_PI,
+    PI_OVER_TWO,
+    PI_OVER_THREE,
+    PI_OVER_FOUR,
+    PI_OVER_SIX,
+    THREE_PI_OVER_TWO,
+    TWO_PI,
+    ONE_OVER_TWO_PI,
+    RADIANS_PER_DEGREE,
+    DEGREES_PER_RADIAN,
+    RADIANS_PER_ARCSECOND
+};

package/src/clampToLatitudeRange.js

@@ -0,0 +1,11 @@
+import clampToRange from "./clampToRange.js";
+import { PI_OVER_TWO } from "./Constant.js";
+
+function clampToLatitudeRange(latitude, degrees = true) {
+    if (degrees)
+        return clampToRange(latitude, -90, 90);
+    else
+        return clampToRange(latitude, -PI_OVER_TWO, PI_OVER_TWO);
+};
+
+export default clampToLatitudeRange;

package/src/clampToLongitudeRange.js

@@ -0,0 +1,10 @@
+import clampToRange from "./clampToRange.js";
+
+function clampToLongitudeRange(longitude, degrees = true) {
+    if (degrees)
+        return clampToRange(longitude, -180, 180);
+    else
+        return clampToRange(longitude, -Math.PI, Math.PI);
+};
+
+export default clampToLongitudeRange;

package/src/clampToRange.js

@@ -0,0 +1,5 @@
+function clampToRange(value, min, max) {
+    return value < min ? min : value > max ? max : value;
+};
+
+export default clampToRange;

package/src/convertToDegreesRound.js

@@ -0,0 +1,7 @@
+import convertToRange from "./convertToRange.js";
+
+function convertToDegreesRound(degrees, minValue = 0) {
+    return convertToRange(degrees, minValue, minValue + 360);
+}
+
+export default convertToDegreesRound;

package/src/convertToLatitudeRange.js

@@ -0,0 +1,24 @@
+import { PI_OVER_TWO } from "./Constant.js";
+
+function convertToLatitudeRange(latitude, degrees = true) {
+    if (degrees) {
+        while (latitude > 90 || latitude < -90) {
+            if (latitude > 90) {
+                latitude = 180 - latitude;
+            } else if (latitude < -90) {
+                latitude = -180 - latitude;
+            }
+        }
+    } else {
+        while (latitude > PI_OVER_TWO || latitude < -PI_OVER_TWO) {
+            if (latitude > PI_OVER_TWO) {
+                latitude = Math.PI - latitude;
+            } else if (latitude < -PI_OVER_TWO) {
+                latitude = -Math.PI - latitude;
+            }
+        }
+    }
+    return latitude;
+};
+
+export default convertToLatitudeRange;

package/src/convertToLongitudeRange.js

@@ -0,0 +1,10 @@
+import convertToRange from "./convertToRange.js";
+
+function convertToLongitudeRange(longitude, degrees = true) {
+    if (degrees)
+        return convertToRange(longitude, -180, 180);
+    else
+        return convertToRange(longitude, -Math.PI, Math.PI);
+};
+
+export default convertToLongitudeRange;

package/src/convertToRadiansRound.js

@@ -0,0 +1,8 @@
+import convertToRange from "./convertToRange.js";
+import { TWO_PI } from "./Constant.js";
+
+function convertToRadiansRound(radians, minValue = 0) {
+    return convertToRange(radians, minValue, minValue + TWO_PI);
+}
+
+export default convertToRadiansRound;

package/src/convertToRange.js

@@ -0,0 +1,21 @@
+import Check from "@lijuhong1981/jscheck";
+
+function convertToRange(value, min, max) {
+    Check.typeOf.number("value", value);
+    Check.typeOf.number("min", min);
+    Check.typeOf.number("max", max);
+
+    const length = max - min;
+    if (value < min) {
+        value += length;
+        while (value < min)
+            value += length;
+    } else if (value > max) {
+        value -= length;
+        while (value > max)
+            value -= length;
+    }
+    return value;
+};
+
+export default convertToRange;

package/src/percentInRange.js

@@ -0,0 +1,10 @@
+import clampToRange from "./clampToRange.js";
+
+function percentInRange(value, rangeMinimum, rangeMaximum, clamp = false) {
+    let scalar = (value - rangeMinimum) / (rangeMaximum - rangeMinimum);
+    if (clamp)
+        scalar = clampToRange(scalar, 0, 1);
+    return scalar;
+};
+
+export default percentInRange;

package/src/percentToRange.js

@@ -0,0 +1,9 @@
+import clampToRange from "./clampToRange.js";
+
+function percentToRange(percent, rangeMinimum, rangeMaximum, clamp = false) {
+    if (clamp)
+        percent = clampToRange(percent, 0, 1);
+    return rangeMinimum + (rangeMaximum - rangeMinimum) * percent;
+};
+
+export default percentToRange;

package/src/randomInteger.js

@@ -0,0 +1,7 @@
+import randomNumber from "./randomNumber.js";
+
+function randomInteger(min = 0, max = Number.MAX_SAFE_INTEGER - 1) {
+    return Math.floor(randomNumber(min, max + 1));
+};
+
+export default randomInteger;

package/src/randomNumber.js

@@ -0,0 +1,5 @@
+function randomNumber(min = 0, max = Number.MAX_SAFE_INTEGER) {
+    return Math.random() * (max - min) + min;
+};
+
+export default randomNumber;