nhanh-pure-function 1.2.8 → 1.3.1

package/lib/Index.d.ts

@@ -1,5 +1,6 @@
-export * from "./Utility";
-export * from "./User";
+export * from "./Utility/Utility";
+export * from "./User/User";
+export * from "./Math/Math";
 
 // 提取单个函数的参数类型
 export type ExtractParameters<T> = T extends (...args: infer P) => any

package/lib/Index.js

@@ -1,4 +1,5 @@
 import "./index.css";
 
-export * from "./Utility";
-export * from "./User";
+export * from "./Utility/Utility.js";
+export * from "./User/User.js";
+export * from "./Math/Math.js";

package/lib/Math/Math.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 转为百分比字符串
+ * @param value 分子
+ * @param totalValue 分母
+ * @param decimalPlaces 保留小数位
+ * @returns 10.00%
+ */
+export function _ConvertToPercentage(
+  value: number,
+  totalValue: number,
+  decimalPlaces?: number
+): number;
+
+/**
+ * 误差范围
+ * @param value 需要判断的数字
+ * @param target 目标数字
+ * @param errorMargin 正负误差范围
+ * @returns 是否在误差内
+ */
+export function _IsWithinErrorMargin(
+  value: number,
+  target: number,
+  errorMargin: number
+): boolean;
+
+/**
+ * 进度
+ * @param {(schedule)=>void} callback callback( 进度百分比 )
+ * @param {Number} TIME 总时长
+ */
+export function _Schedule(
+  callback: (schedule: number) => void,
+  TIME: number
+): void;
+
+/**
+ * 格式化数字，给数字加上千位分隔符。
+ * @param {number} number - 要格式化的数字。
+ * @returns {string} - 格式化后的字符串。
+ */
+export function _FormatNumber(number: number): string;
+
+/**
+ * 纯数字转  数字加单位
+ * @param number 数字或字符串数字
+ * @param config : {
+ *    join 拼接起来吗
+ *    suffix 后缀
+ *    integer 不超过万位的数字时保持整数吗
+ * }
+ * @returns 123456  -->  12.34万 | [ 12.34 , 万 ]
+ */
+export function _FormatNumberWithUnit(
+  number: string | number,
+  config?: {
+    join?: boolean;
+    suffix?: string;
+    integer?: boolean;
+  }
+): string | [number, string];
+
+interface Point {
+  x: number;
+  y: number;
+}
+/**
+ * 判断点是否在多边形内
+ * @param point - 待检测的点，包含 x 和 y 坐标
+ * @param polygon - 多边形的点集，数组形式，每个点包含 x 和 y 坐标
+ * @returns boolean - 点是否在多边形内
+ */
+export function _IsPointInPolygon(point: Point, polygon: Point[]): boolean;

package/lib/Math/Math.js

@@ -0,0 +1,163 @@
+/**
+ * 转为百分比字符串
+ * @param value 分子
+ * @param totalValue 分母
+ * @param decimalPlaces 保留小数位
+ * @returns 10.00%
+ */
+export function _ConvertToPercentage(value, totalValue, decimalPlaces = 2) {
+  if (
+    typeof value !== "number" ||
+    typeof totalValue !== "number" ||
+    typeof decimalPlaces !== "number" ||
+    totalValue == 0
+  ) {
+    console.error("异常输入：", arguments);
+    return "0.00%";
+  }
+  return (
+    Number(
+      parseInt((value / totalValue) * Math.pow(10, 2 + decimalPlaces)) /
+        Math.pow(10, decimalPlaces)
+    ) || 0
+  );
+}
+
+/**
+ * 误差范围
+ * @param value 需要判断的数字
+ * @param target 目标数字
+ * @param errorMargin 正负误差范围
+ * @returns 是否在误差内
+ */
+export function _IsWithinErrorMargin(value, target, errorMargin) {
+  return Math.abs(value - target) <= errorMargin;
+}
+
+/**
+ * 进度
+ * @param {(schedule)=>void} callback callback( 进度百分比 )
+ * @param {Number} TIME 总时长
+ */
+export function _Schedule(callback, TIME = 500) {
+  let t;
+  function loop(time) {
+    if (!t) t = time;
+    let percentage = Math.min((time - t) / TIME, 1);
+    callback(percentage);
+    if (time - t < TIME) requestAnimationFrame(loop);
+  }
+  requestAnimationFrame(loop);
+}
+
+/**
+ * 格式化数字，给数字加上千位分隔符。
+ * @param {number} number - 要格式化的数字。
+ * @returns {string} - 格式化后的字符串。
+ */
+export function _FormatNumber(number) {
+  return number.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+}
+
+/**
+ * 纯数字转  数字加单位
+ * @param number 数字或字符串数字
+ * @param config : {
+ *    join 拼接起来吗
+ *    suffix 后缀
+ *    integer 不超过万位的数字时保持整数吗
+ * }
+ * @returns 123456  -->  12.34万 | [ 12.34 , 万 ]
+ */
+export function _FormatNumberWithUnit(number, config = {}) {
+  const { join, suffix, integer } = Object.assign(
+    {
+      join: true,
+      suffix: "",
+      integer: false,
+    },
+    config
+  );
+
+  function _join(value, suffix, plus = true) {
+    value = (plus ? "" : "-") + value;
+    if (join) return value + suffix;
+    else return [value, suffix];
+  }
+
+  if (typeof number == "string") {
+    if (!/^\d+$/.test(number.trim())) {
+      console.error("错误输入：", number);
+      return _join(0, suffix);
+    }
+  } else if (typeof number != "number") {
+    console.error("错误输入：", number);
+    return _join(0, suffix);
+  }
+
+  if (Math.abs(number) == Infinity || number == 0) {
+    return _join(0, suffix);
+  }
+
+  number = Number(number);
+  const plus = number >= 0;
+  number = Math.abs(number);
+
+  const units = [
+    "",
+    "万",
+    "亿",
+    "兆",
+    "京",
+    "垓",
+    "秭",
+    "穰",
+    "沟",
+    "涧",
+    "正",
+    "载",
+    "极",
+  ];
+  const digits = Math.floor(Math.log10(number) / 4); // 计算位数
+
+  // 不超过万位的数字直接返回
+  if (digits === 0) {
+    if (integer) {
+      return _join(number, suffix, plus);
+    } else {
+      return _join(number.toFixed(2), suffix, plus);
+    }
+  }
+
+  const dividedNumber = number / Math.pow(10000, digits);
+  const formattedNumber = dividedNumber.toFixed(2);
+
+  return _join(formattedNumber, units[digits] + suffix, plus);
+}
+
+/**
+ * 判断点是否在多边形内
+ * @param point - 待检测的点，包含 x 和 y 坐标
+ * @param polygon - 多边形的点集，数组形式，每个点包含 x 和 y 坐标
+ * @returns boolean - 点是否在多边形内
+ */
+export function _IsPointInPolygon(point, polygon) {
+  let isInside = false;
+
+  const { x, y } = point;
+  const len = polygon.length;
+
+  for (let i = 0, j = len - 1; i < len; j = i++) {
+    const xi = polygon[i].x,
+      yi = polygon[i].y;
+    const xj = polygon[j].x,
+      yj = polygon[j].y;
+
+    const intersect =
+      yi > y !== yj > y && x < ((xj - xi) * (y - yi)) / (yj - yi) + xi;
+
+    if (intersect) isInside = !isInside;
+  }
+
+  return isInside;
+}

package/lib/{User.d.ts → User/User.d.ts}

@@ -1,30 +1,11 @@
 /**
  * 滚动结束监听器
- * @param {(trigger?: "vertical" | "horizontal") => void} callback
+ * @param {(trigger: "vertical" | "horizontal") => void} callback
  */
 export function _ScrollEndListener(
-  callback: (trigger?: "vertical" | "horizontal") => void
+  callback: (trigger: "vertical" | "horizontal") => void
 ): (payload: Event) => void;
 
-/**
- * 纯数字转  数字加单位
- * @param number 数字或字符串数字
- * @param config : {
- *    join 拼接起来吗
- *    suffix 后缀
- *    integer 不超过万位的数字时保持整数吗
- * }
- * @returns 123456  -->  12.34万 | [ 12.34 , 万 ]
- */
-export function _FormatNumberWithUnit(
-  number: string | number,
-  config?: {
-    join?: boolean;
-    suffix?: string;
-    integer?: boolean;
-  }
-): string | [number, string];
-
 /**
  * 设置量词属性
  * @param {*} data 需修改对象

package/lib/{User.js → User/User.js}

@@ -44,82 +44,6 @@ export function _ScrollEndListener(callback) {
   };
 }
 
-/**
- * 纯数字转  数字加单位
- * @param number 数字或字符串数字
- * @param config : {
- *    join 拼接起来吗
- *    suffix 后缀
- *    integer 不超过万位的数字时保持整数吗
- * }
- * @returns 123456  -->  12.34万 | [ 12.34 , 万 ]
- */
-export function _FormatNumberWithUnit(number, config = {}) {
-  const { join, suffix, integer } = Object.assign(
-    {
-      join: true,
-      suffix: "",
-      integer: false,
-    },
-    config
-  );
-
-  function _join(value, suffix, plus = true) {
-    value = (plus ? "" : "-") + value;
-    if (join) return value + suffix;
-    else return [value, suffix];
-  }
-
-  if (typeof number == "string") {
-    if (!/^\d+$/.test(number.trim())) {
-      console.error("错误输入：", number);
-      return _join(0, suffix);
-    }
-  } else if (typeof number != "number") {
-    console.error("错误输入：", number);
-    return _join(0, suffix);
-  }
-
-  if (Math.abs(number) == Infinity || number == 0) {
-    return _join(0, suffix);
-  }
-
-  number = Number(number);
-  const plus = number >= 0;
-  number = Math.abs(number);
-
-  const units = [
-    "",
-    "万",
-    "亿",
-    "兆",
-    "京",
-    "垓",
-    "秭",
-    "穰",
-    "沟",
-    "涧",
-    "正",
-    "载",
-    "极",
-  ];
-  const digits = Math.floor(Math.log10(number) / 4); // 计算位数
-
-  // 不超过万位的数字直接返回
-  if (digits === 0) {
-    if (integer) {
-      return _join(number, suffix, plus);
-    } else {
-      return _join(number.toFixed(2), suffix, plus);
-    }
-  }
-
-  const dividedNumber = number / Math.pow(10000, digits);
-  const formattedNumber = dividedNumber.toFixed(2);
-
-  return _join(formattedNumber, units[digits] + suffix, plus);
-}
-
 /**
  * 设置量词属性
  * @param {*} data 需修改对象

package/lib/{Utility.d.ts → Utility/Utility.d.ts}

@@ -1,4 +1,4 @@
-import { ExtractParameters } from "./Index";
+import { ExtractParameters } from "../Index";
 
 /**
  * 非null | undefined判断
@@ -20,19 +20,6 @@ export function _IsObject(value: any): boolean;
  */
 export function _ExecuteWhenIdle(callback: Function);
 
-/**
- * 转为百分比字符串
- * @param value 分子
- * @param totalValue 分母
- * @param decimalPlaces 保留小数位
- * @returns 10.00%
- */
-export function _ConvertToPercentage(
-  value: number,
-  totalValue: number,
-  decimalPlaces?: number
-): number;
-
 /**
  * 等待条件满足
  * @param conditionChecker 条件检查器
@@ -84,19 +71,6 @@ export function _TimeTransition(
   pad?: boolean
 ): string;
 
-/**
- * 误差范围
- * @param value 需要判断的数字
- * @param target 目标数字
- * @param errorMargin 正负误差范围
- * @returns 是否在误差内
- */
-export function _IsWithinErrorMargin(
-  value: number,
-  target: number,
-  errorMargin: number
-): boolean;
-
 /**
  * 读取文件
  * @param src 文件地址
@@ -121,23 +95,6 @@ export function _GetFrameRate(
   referenceNode: number
 ): void;
 
-/**
- * 进度
- * @param {(schedule)=>void} callback callback( 进度百分比 )
- * @param {Number} TIME 总时长
- */
-export function _Schedule(
-  callback: (schedule: number) => void,
-  TIME: number
-): void;
-
-/**
- * 格式化数字，给数字加上千位分隔符。
- * @param {number} number - 要格式化的数字。
- * @returns {string} - 格式化后的字符串。
- */
-export function _FormatNumber(number: number): string;
-
 /**
  * 单位转换 12** -> **px
  * @param {string} width
@@ -234,3 +191,26 @@ export function _CopyToClipboard(text: string): Promise<void>;
  * @returns string
  */
 export function _FormatFileSize(size: number): string;
+
+/**
+ * 根据路径获取目标对象
+ * 该函数用于在给定的模型中，通过路径字符串来获取深层嵌套的目标对象如果路径中的某一部分不存在，则会创建一个新的对象（除非已经是路径的最后一部分）
+ *
+ * @param {Object} model - 包含要查询的数据的模型对象
+ * @param {string} path - 用点分隔的路径字符串，表示要访问的对象属性路径
+ * @returns {Object|undefined} - 返回目标对象，如果路径不存在则返回undefined
+ */
+export function _GetTargetByPath(model: any, path: string): any;
+
+/**
+ * 根据路径更新目标值
+ *
+ * 该函数通过一个点分隔的路径来更新一个对象中的嵌套属性值
+ * 它使用了reduce方法来遍历路径数组，并在路径的终点设置新的值
+ *
+ * @param {Object} model - 包含要更新数据的模型对象
+ * @param {string} path - 点分隔的字符串路径，指示如何到达目标属性
+ * @param {*} value - 要设置的新值
+ * @returns {*} - 返回更新后的模型对象中的值
+ */
+export function _UpdateTargetByPath(model: any, path: string, value: any): any;

package/lib/{Utility.js → Utility/Utility.js}

@@ -31,31 +31,6 @@ export function _ExecuteWhenIdle(callback) {
   requestIdleCallback(loop);
 }
 
-/**
- * 转为百分比字符串
- * @param value 分子
- * @param totalValue 分母
- * @param decimalPlaces 保留小数位
- * @returns 10.00%
- */
-export function _ConvertToPercentage(value, totalValue, decimalPlaces = 2) {
-  if (
-    typeof value !== "number" ||
-    typeof totalValue !== "number" ||
-    typeof decimalPlaces !== "number" ||
-    totalValue == 0
-  ) {
-    console.error("异常输入：", arguments);
-    return "0.00%";
-  }
-  return (
-    Number(
-      parseInt((value / totalValue) * Math.pow(10, 2 + decimalPlaces)) /
-        Math.pow(10, decimalPlaces)
-    ) || 0
-  );
-}
-
 /**
  * 等待条件满足
  * @param conditionChecker 条件检查器
@@ -184,17 +159,6 @@ export function _TimeTransition(time, template, pad = true) {
   return template;
 }
 
-/**
- * 误差范围
- * @param value 需要判断的数字
- * @param target 目标数字
- * @param errorMargin 正负误差范围
- * @returns 是否在误差内
- */
-export function _IsWithinErrorMargin(value, target, errorMargin) {
-  return Math.abs(value - target) <= errorMargin;
-}
-
 /**
  * 读取文件
  * @param src 文件地址
@@ -251,31 +215,6 @@ export function _GetFrameRate(callback, referenceNode = 10) {
   });
 }
 
-/**
- * 进度
- * @param {(schedule)=>void} callback callback( 进度百分比 )
- * @param {Number} TIME 总时长
- */
-export function _Schedule(callback, TIME = 500) {
-  let t;
-  function loop(time) {
-    if (!t) t = time;
-    let percentage = Math.min((time - t) / TIME, 1);
-    callback(percentage);
-    if (time - t < TIME) requestAnimationFrame(loop);
-  }
-  requestAnimationFrame(loop);
-}
-
-/**
- * 格式化数字，给数字加上千位分隔符。
- * @param {number} number - 要格式化的数字。
- * @returns {string} - 格式化后的字符串。
- */
-export function _FormatNumber(number) {
-  return number.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ",");
-}
-
 /**
  * 单位转换 12** -> **px
  * @param {string} width
@@ -486,3 +425,37 @@ export function _FormatFileSize(size) {
   }
   return `${Math.round(size * 100) / 100} ${units[unitIndex]}`;
 }
+
+/**
+ * 根据路径获取目标对象
+ * 该函数用于在给定的模型中，通过路径字符串来获取深层嵌套的目标对象如果路径中的某一部分不存在，则会创建一个新的对象（除非已经是路径的最后一部分）
+ *
+ * @param {Object} model - 包含要查询的数据的模型对象
+ * @param {string} path - 用点分隔的路径字符串，表示要访问的对象属性路径
+ * @returns {Object|undefined} - 返回目标对象，如果路径不存在则返回undefined
+ */
+export function _GetTargetByPath(model, path) {
+  const arr = path.split(".");
+  return arr.reduce((prev, curr, index) => {
+    if (prev.hasOwnProperty(curr)) return prev[curr];
+    return (prev[curr] = index == arr.length - 1 ? undefined : {});
+  }, model.value);
+}
+/**
+ * 根据路径更新目标值
+ *
+ * 该函数通过一个点分隔的路径来更新一个对象中的嵌套属性值
+ * 它使用了reduce方法来遍历路径数组，并在路径的终点设置新的值
+ *
+ * @param {Object} model - 包含要更新数据的模型对象
+ * @param {string} path - 点分隔的字符串路径，指示如何到达目标属性
+ * @param {*} value - 要设置的新值
+ * @returns {*} - 返回更新后的模型对象中的值
+ */
+export function _UpdateTargetByPath(model, path, value) {
+  const arr = path.split(".");
+  return arr.reduce((prev, curr, index) => {
+    if (index === arr.length - 1) prev[curr] = value;
+    return prev[curr];
+  }, model.value);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhanh-pure-function",
-  "version": "1.2.8",
+  "version": "1.3.1",
   "description": "纯函数工具",
   "main": "lib/Index.js",
   "scripts": {

package/lib/test.ts

@@ -1 +0,0 @@
-/** 用于测试 js / ts 功能实现及类型是否正确 */