@lijuhong1981/jsmath 1.3.5 → 1.3.7

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2022-2026 lijuhong1981
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -1,11 +1,21 @@
-# `@lijuhong1981/jsmath`
-
-> TODO: description
-
-## Usage
-
-```
-const jsmath = require('@lijuhong1981/jsmath');
-
-// TODO: DEMONSTRATE API
-```
+# @lijuhong1981/jsmath
+
+> 数学工具集，涵盖插值、夹取、角度/弧度换算、经纬度范围、NDC 坐标转换、随机数与数值解析。
+
+## 安装
+
+```bash
+npm install @lijuhong1981/jsmath
+```
+
+## 导出
+
+- **夹取/范围**：`clamp`、`clampLatitude`、`clampLongitude`、`scalarInRange`、`isBetween`、`convertToRange`
+- **角度换算**：`degreesToRadians`、`radiansToDegrees`、`convertToDegreesCircular`、`convertToRadiansCircular`
+- **经纬度范围**：`convertToLatitudeRange`、`convertToLongitudeRange`
+- **插值**：`lerp`
+- **坐标转换**：`getNDCInElement`、`ndcToWindowPosition`、`windowPositionToNDC`
+- **数值处理**：`normalize`、`toFixed`、`extractFraction`、`acosClamped`、`equalsEpsilon`
+- **随机数**：`randomNumber`、`randomInteger`
+- **解析**：`parseBoolean`、`parseNumber`
+- **类/常量**：`Interval`、`Constant`（命名空间导出）

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lijuhong1981/jsmath",
-  "version": "1.3.5",
-  "description": "> TODO: description",
+  "version": "1.3.7",
+  "description": "Math utilities: interpolation, clamp, coordinates and random.",
   "author": "lijuhong1981 <lijuhong@hotmail.com>",
   "homepage": "https://github.com/lijuhong1981/jslibs#readme",
   "license": "ISC",
@@ -18,5 +18,5 @@
   "bugs": {
     "url": "https://github.com/lijuhong1981/jslibs/issues"
   },
-  "gitHead": "cae3f4be65fe0454718936b9ab5a4d29af4fdda0"
+  "gitHead": "5d4bd57b654be98c46364160070d5dd11600afa6"
 }

package/src/Constant.js

@@ -10,7 +10,7 @@ const ONE_OVER_TWO_PI = 1.0 / (2.0 * PI);
 const RADIANS_PER_DEGREE = PI / 180.0;
 const DEGREES_PER_RADIAN = 180.0 / PI;
 /**
- * The number of radians in an arc second.
+ * 一弧秒所对应的弧度数。
  *
  * @type {number}
  * @constant

package/src/acosClamped.js

@@ -1,4 +1,4 @@
-import clamp from "./clamp";
+import clamp from "./clamp.js";
 
 /**
  * 计算一个数值的反余弦值，并将输入值约束在-1到1之间

package/src/convertToRange.js

@@ -8,6 +8,8 @@
  */
 function convertToRange(value, rangeMinimum, rangeMaximum) {
     const length = rangeMaximum - rangeMinimum;
+    if (length === 0)
+        return rangeMinimum;
     if (value < rangeMinimum) {
         value += length;
         while (value < rangeMinimum)

package/src/extractFraction.js

@@ -4,12 +4,7 @@
  * @returns {Number} 提取的小数
  */
 function extractFraction(value) {
-    value = value.toString();
-    const arr = value.split('.');
-    if (arr.length === 2)
-        return parseFloat('0.' + arr[1]);
-    else
-        return 0.0;
+    return value - Math.trunc(value);
 };
 
 export default extractFraction;

package/src/randomInteger.js

@@ -3,7 +3,7 @@ import randomNumber from "./randomNumber.js";
 /**
  * 产生一个随机整数，可指定随机范围
  * @param {Number} rangeMinimum 最小整数，默认0
- * @param {Number} rangeMaximum 最大整数，默认Number.MAX_SAFE_INTEGER
+ * @param {Number} rangeMaximum 最大整数，默认Number.MAX_SAFE_INTEGER - 1
  * @returns {Integer} 生成的随机整数
  */
 function randomInteger(rangeMinimum = 0, rangeMaximum = Number.MAX_SAFE_INTEGER - 1) {