@qy_better_lib/core 0.1.3 → 0.1.5

package/lib/utils/is.d.ts

@@ -3,50 +3,140 @@
  * @param val
  * @returns
  */
-export declare function isUndefined(val: any): boolean;
+export declare function is_undefined(val: any): boolean;
+/**
+ * 是否为null
+ * @param val
+ * @returns
+ */
+export declare function is_null(val: any): boolean;
 /**
  * 是否为数组
  * @param val
  * @returns
  */
-export declare function isArray(val: any): boolean;
+export declare function is_array(val: any): boolean;
 /**
  * 是否为对象
  * @param val
  * @returns
  */
-export declare function isObject(val: any): boolean;
+export declare function is_object(val: any): boolean;
+/**
+ * 是否为纯粹的对象（排除数组、null等）
+ * @param val
+ * @returns
+ */
+export declare function is_plain_object(val: any): boolean;
 /**
  * 是否为日期时间
  * @param val
  * @returns
  */
-export declare function isDate(val: any): boolean;
+export declare function is_date(val: any): boolean;
+/**
+ * 是否为有效的日期
+ * @param val
+ * @returns
+ */
+export declare function is_valid_date(val: any): boolean;
+/**
+ * 是否为布尔值
+ * @param val
+ * @returns
+ */
+export declare function is_boolean(val: any): boolean;
+/**
+ * 是否为函数
+ * @param val
+ * @returns
+ */
+export declare function is_function(val: any): boolean;
+/**
+ * 是否为正则表达式
+ * @param val
+ * @returns
+ */
+export declare function is_reg_exp(val: any): boolean;
+/**
+ * 是否为Symbol
+ * @param val
+ * @returns
+ */
+export declare function is_symbol(val: any): boolean;
+/**
+ * 是否为Promise
+ * @param val
+ * @returns
+ */
+export declare function is_promise(val: any): boolean;
 /**
  * 是否为空
  * @param val
  * @returns
  */
-export declare function isEmpty(val: unknown): boolean;
+export declare function is_empty(val: unknown): boolean;
+/**
+ * 是否为真值
+ * @param val
+ * @returns
+ */
+export declare function is_truthy(val: any): boolean;
+/**
+ * 是否为假值
+ * @param val
+ * @returns
+ */
+export declare function is_falsy(val: any): boolean;
 /**
  * 判断对象是否为DOM元素
  * @param e
  * @returns
  */
-export declare function isElement(e: unknown): e is Element;
+export declare function is_element(e: unknown): e is Element;
+/**
+ * 判断对象是否为HTMLElement
+ * @param e
+ * @returns
+ */
+export declare function is_html_element(e: unknown): e is HTMLElement;
 /**
  * 是否是客户端
  */
-export declare const isClient: boolean;
-/**是否未数值 */
-export declare const isNumber: (val: any) => val is number;
-/**是否为字符串 */
-export declare const isString: (val: any) => val is string;
-/**是否为字符串数值 */
-export declare const isStringNumber: (val: string) => boolean;
-/**是否为手机号（国内手机号） */
-export declare function isMobile(str: string): boolean;
-/**是否为有效IP地址 */
-export declare function isIp(val: string): boolean;
-/**是否为有效端口 */
-export declare function isPort(val: string): boolean;
+export declare const is_client: boolean;
+/**
+ * 是否为数值
+ */
+export declare function is_number(val: any): boolean;
+/**
+ * 是否为字符串
+ */
+export declare function is_string(val: any): boolean;
+/**
+ * 是否为字符串数值
+ */
+export declare function is_string_number(val: any): boolean;
+/**
+ * 是否为手机号（国内手机号）
+ */
+export declare function is_mobile(str: string): boolean;
+/**
+ * 是否为邮箱地址
+ */
+export declare function is_email(str: string): boolean;
+/**
+ * 是否为URL地址
+ */
+export declare function is_url(str: string): boolean;
+/**
+ * 是否为十六进制颜色值
+ */
+export declare function is_hex_color(str: string): boolean;
+/**
+ * 是否为有效IP地址
+ */
+export declare function is_ip(val: string): boolean;
+/**
+ * 是否为有效端口
+ */
+export declare function is_port(val: string): boolean;

package/lib/utils/is.js

@@ -1,43 +1,126 @@
-function o(t) {
-  return t === void 0;
+function is_undefined(val) {
+  return val === void 0;
 }
-function e(t) {
-  return Object.prototype.toString.call(t) === "[object Array]";
+function is_null(val) {
+  return val === null;
 }
-function n(t) {
-  return typeof t == "object" && Object.prototype.toString.call(t) === "[object Object]";
+function is_array(val) {
+  return Array.isArray(val);
 }
-function c(t) {
-  return Object.prototype.toString.call(t) === "[object Date]";
+function is_object(val) {
+  return typeof val === "object" && val !== null && Object.prototype.toString.call(val) === "[object Object]";
 }
-function u(t) {
-  return !t && t !== 0 || e(t) && t.length === 0 || n(t) && !Object.keys(t).length;
+function is_plain_object(val) {
+  if (typeof val !== "object" || val === null) return false;
+  let proto = val;
+  while (Object.getPrototypeOf(proto) !== null) {
+    proto = Object.getPrototypeOf(proto);
+  }
+  return Object.getPrototypeOf(val) === proto;
 }
-function s(t) {
-  return typeof Element > "u" ? !1 : t instanceof Element;
+function is_date(val) {
+  return Object.prototype.toString.call(val) === "[object Date]";
 }
-const f = typeof window < "u", b = (t) => typeof t == "number", r = (t) => typeof t == "string", d = (t) => r(t) ? !Number.isNaN(Number(t)) : !1;
-function p(t) {
-  return /^1[3-9]\d{9}$/.test(t);
+function is_valid_date(val) {
+  return is_date(val) && !isNaN(val.getTime());
 }
-function y(t) {
-  return /^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/.test(t);
+function is_boolean(val) {
+  return typeof val === "boolean";
 }
-function g(t) {
-  return /^(6553[0-5]|655[0-2]\d|65[0-4]\d{2}|6[0-4]\d{3}|[1-5]\d{4}|[1-9]\d{0,3}|0)$/.test(t);
+function is_function(val) {
+  return typeof val === "function";
+}
+function is_reg_exp(val) {
+  return Object.prototype.toString.call(val) === "[object RegExp]";
+}
+function is_symbol(val) {
+  return typeof val === "symbol";
+}
+function is_promise(val) {
+  return typeof val === "object" && val !== null && typeof val.then === "function" && typeof val.catch === "function";
+}
+function is_empty(val) {
+  return !val && val !== 0 || is_array(val) && val.length === 0 || is_object(val) && !Object.keys(val).length;
+}
+function is_truthy(val) {
+  return !!val;
+}
+function is_falsy(val) {
+  return !val;
+}
+function is_element(e) {
+  if (typeof Element === "undefined") return false;
+  return e instanceof Element;
+}
+function is_html_element(e) {
+  if (typeof HTMLElement === "undefined") return false;
+  return e instanceof HTMLElement;
+}
+const is_client = typeof window !== "undefined";
+function is_number(val) {
+  return typeof val === "number" && !isNaN(val);
+}
+function is_string(val) {
+  return typeof val === "string";
+}
+function is_string_number(val) {
+  if (!is_string(val)) {
+    return false;
+  }
+  return !Number.isNaN(Number(val));
+}
+function is_mobile(str) {
+  const regex = /^1[3-9]\d{9}$/;
+  return regex.test(str);
+}
+function is_email(str) {
+  const regex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+  return regex.test(str);
+}
+function is_url(str) {
+  try {
+    new URL(str);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function is_hex_color(str) {
+  const regex = /^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/;
+  return regex.test(str);
+}
+function is_ip(val) {
+  return /^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/.test(val);
+}
+function is_port(val) {
+  return /^(6553[0-5]|655[0-2]\d|65[0-4]\d{2}|6[0-4]\d{3}|[1-5]\d{4}|[1-9]\d{0,3}|0)$/.test(val);
 }
 export {
-  e as isArray,
-  f as isClient,
-  c as isDate,
-  s as isElement,
-  u as isEmpty,
-  y as isIp,
-  p as isMobile,
-  b as isNumber,
-  n as isObject,
-  g as isPort,
-  r as isString,
-  d as isStringNumber,
-  o as isUndefined
+  is_array,
+  is_boolean,
+  is_client,
+  is_date,
+  is_element,
+  is_email,
+  is_empty,
+  is_falsy,
+  is_function,
+  is_hex_color,
+  is_html_element,
+  is_ip,
+  is_mobile,
+  is_null,
+  is_number,
+  is_object,
+  is_plain_object,
+  is_port,
+  is_promise,
+  is_reg_exp,
+  is_string,
+  is_string_number,
+  is_symbol,
+  is_truthy,
+  is_undefined,
+  is_url,
+  is_valid_date
 };

package/lib/utils/number.d.ts

@@ -1,18 +1,88 @@
 /**
  * 数字转成千分位
- * @param num
- * @returns
+ * @param num 数字或数字字符串
+ * @returns 千分位格式的字符串
  */
-export declare function thousandSeparator(num: number | any): string;
+export declare function thousand_separator(num: any): string;
 /**
  * 转换成数值
  * @param num 源
  * @param fixed 保留小数点，默认不设置
  */
-export declare function toNumber(num: string | undefined, fixed?: number): number | undefined;
+export declare function to_number(num: any): number;
 /**
  * 保留小数点
+ * @param num 数字或数字字符串
+ * @param fixed 小数位数
+ */
+export declare function to_fixed(num: any, fixed: number): number;
+/**
+ * 格式化货币
+ * @param num 数字
+ * @param currency 货币符号，默认为 ¥
+ * @param fixed 小数位数，默认为 2
+ * @returns 格式化后的货币字符串
+ */
+export declare function format_currency(num: number, currency?: string, fixed?: number): string;
+/**
+ * 限制数字范围
+ * @param num 数字
+ * @param min 最小值
+ * @param max 最大值
+ * @returns 限制在范围内的数字
+ */
+export declare function clamp(num: number, min: number, max: number): number;
+/**
+ * 转换为百分比
+ * @param num 数字或数字字符串
+ * @param fixed 小数位数，默认为 2
+ * @returns 百分比字符串
+ */
+export declare function to_percentage(num: any, fixed?: number): string;
+/**
+ * 判断数字奇偶性
  * @param num 数字
- * @param fixed 小数点
+ * @returns 是否为偶数
+ */
+export declare function is_even(num: number): boolean;
+/**
+ * 获取数字的整数部分
+ * @param num 数字
+ * @returns 整数部分
+ */
+export declare function get_integer_part(num: number): number;
+/**
+ * 获取数字的小数部分
+ * @param num 数字
+ * @returns 小数部分
+ */
+export declare function get_decimal_part(num: number): number;
+/**
+ * 数字四舍五入
+ * @param num 数字
+ * @param precision 精度，默认为 0
+ * @returns 四舍五入后的数字
+ */
+export declare function round(num: number, precision?: number): number;
+/**
+ * 数字向上取整
+ * @param num 数字
+ * @param precision 精度，默认为 0
+ * @returns 向上取整后的数字
+ */
+export declare function ceil(num: number, precision?: number): number;
+/**
+ * 数字向下取整
+ * @param num 数字
+ * @param precision 精度，默认为 0
+ * @returns 向下取整后的数字
+ */
+export declare function floor(num: number, precision?: number): number;
+/**
+ * 计算两个数字之间的百分比
+ * @param current 当前值
+ * @param total 总值
+ * @param fixed 小数位数，默认为 2
+ * @returns 百分比值
  */
-export declare function toFixed(num: number, fixed: number): number;
+export declare function calculate_percentage(current: number, total: number, fixed?: number): number;

package/lib/utils/number.js

@@ -1,15 +1,99 @@
-import { isNumber as t } from "./is.js";
-function u(r) {
-  return r ? Object.prototype.toString.call(1) !== "[object Number]" ? `${r}` : `${r}`.replace(/(\d{1,3})(?=(\d{3})+(?:$|\.))/g, "$1,") : "0";
+import { is_number, is_string } from "./is.js";
+function thousand_separator(num) {
+  if (!num && num !== 0) {
+    return "0";
+  }
+  const parsed_num = to_number(num);
+  if (isNaN(parsed_num)) {
+    return `${num}`;
+  }
+  return `${parsed_num}`.replace(/(\d{1,3})(?=(\d{3})+(?:$|\.))/g, "$1,");
 }
-function i(r, e) {
-  return t(r) ? Number(e ? Number(r).toFixed(e) : r) : Number.NaN;
+function to_number(num) {
+  if (is_number(num)) {
+    return num;
+  }
+  if (is_string(num)) {
+    const parsedNum = parseFloat(num);
+    if (isNaN(parsedNum)) {
+      return Number.NaN;
+    }
+    return parsedNum;
+  }
+  return Number.NaN;
 }
-function N(r, e) {
-  return t(r) ? Number(r.toFixed(e)) : Number.NaN;
+function to_fixed(num, fixed) {
+  const parsedNum = to_number(num);
+  if (isNaN(parsedNum)) return Number.NaN;
+  return Number(parsedNum.toFixed(fixed));
+}
+function format_currency(num, currency = "¥", fixed = 2) {
+  if (!is_number(num)) return currency + "0.00";
+  let fixedNum;
+  if (fixed === 0) {
+    const flooredNum = Math.floor(num);
+    fixedNum = flooredNum.toString();
+  } else {
+    fixedNum = num.toFixed(fixed);
+  }
+  const formattedNum = thousand_separator(fixedNum);
+  return currency + formattedNum;
+}
+function clamp(num, min, max) {
+  if (!is_number(num)) return Number.NaN;
+  return Math.max(min, Math.min(max, num));
+}
+function to_percentage(num, fixed = 2) {
+  const parsedNum = to_number(num);
+  if (isNaN(parsedNum)) return "0%";
+  const percentage = parsedNum * 100;
+  const formattedPercentage = percentage.toFixed(fixed);
+  return formattedPercentage + "%";
+}
+function is_even(num) {
+  if (!is_number(num)) return false;
+  return num % 2 === 0;
+}
+function get_integer_part(num) {
+  if (!is_number(num)) return Number.NaN;
+  return Math.trunc(num);
+}
+function get_decimal_part(num) {
+  if (!is_number(num)) return Number.NaN;
+  return num - Math.trunc(num);
+}
+function round(num, precision = 0) {
+  if (!is_number(num)) return Number.NaN;
+  const factor = Math.pow(10, precision);
+  return Math.round(num * factor) / factor;
+}
+function ceil(num, precision = 0) {
+  if (!is_number(num)) return Number.NaN;
+  const factor = Math.pow(10, precision);
+  return Math.ceil(num * factor) / factor;
+}
+function floor(num, precision = 0) {
+  if (!is_number(num)) return Number.NaN;
+  const factor = Math.pow(10, precision);
+  return Math.floor(num * factor) / factor;
+}
+function calculate_percentage(current, total, fixed = 2) {
+  if (!is_number(current) || !is_number(total) || total === 0) return Number.NaN;
+  const percentage = current / total * 100;
+  return to_fixed(percentage, fixed);
 }
 export {
-  u as thousandSeparator,
-  N as toFixed,
-  i as toNumber
+  calculate_percentage,
+  ceil,
+  clamp,
+  floor,
+  format_currency,
+  get_decimal_part,
+  get_integer_part,
+  is_even,
+  round,
+  thousand_separator,
+  to_fixed,
+  to_number,
+  to_percentage
 };

package/lib/utils/object.d.ts

@@ -1,11 +1,81 @@
-export declare function deepClone(obj: any): any;
 /**
- *深度合并多个对象的方法
+ * 深拷贝对象
+ * @param obj 要拷贝的对象
+ * @returns 拷贝后的新对象
  */
-export declare function deepAssign(...arg: any[]): Record<string, any>;
+export declare function deep_clone(obj: any): any;
+/**
+ * 深度合并多个对象
+ * @param args 要合并的对象列表
+ * @returns 合并后的对象
+ */
+export declare function deep_assign(...args: any[]): Record<string, any>;
 /**
  * 深度比较两个对象值是否一致
- * 不考虑值,不考虑引用地址
- * @returns boolean
+ * @param a 第一个对象
+ * @param b 第二个对象
+ * @returns 是否相等
+ */
+export declare function deep_equal(a: any, b: any): boolean;
+/**
+ * 检查对象是否为空
+ * @param obj 要检查的对象
+ * @returns 是否为空对象
+ */
+export declare function is_empty_object(obj: any): boolean;
+/**
+ * 从对象中提取指定属性
+ * @param obj 源对象
+ * @param keys 要提取的属性名数组
+ * @returns 提取后的新对象
+ */
+export declare function pick(obj: any, keys: string[]): Record<string, any>;
+/**
+ * 从对象中排除指定属性
+ * @param obj 源对象
+ * @param keys 要排除的属性名数组
+ * @returns 排除后的新对象
+ */
+export declare function omit(obj: any, keys: string[]): Record<string, any>;
+/**
+ * 将嵌套对象扁平化为一维对象
+ * @param obj 源对象
+ * @param prefix 前缀
+ * @returns 扁平化后的对象
+ */
+export declare function flatten_object(obj: any, prefix?: string): Record<string, any>;
+/**
+ * 将扁平对象转换为嵌套对象
+ * @param obj 扁平对象
+ * @returns 嵌套对象
+ */
+export declare function unflatten_object(obj: any): Record<string, any>;
+/**
+ * 根据路径获取对象值
+ * @param obj 源对象
+ * @param path 路径字符串，如 "a.b.c"
+ * @param defaultValue 默认值
+ * @returns 获取的值或默认值
+ */
+export declare function get_object_value(obj: any, path: string, defaultValue?: any): any;
+/**
+ * 根据路径设置对象值
+ * @param obj 源对象
+ * @param path 路径字符串，如 "a.b.c"
+ * @param value 要设置的值
+ * @returns 修改后的对象
+ */
+export declare function set_object_value(obj: any, path: string, value: any): Record<string, any>;
+/**
+ * 浅合并多个对象
+ * @param args 要合并的对象列表
+ * @returns 合并后的对象
+ */
+export declare function merge_objects(...args: any[]): Record<string, any>;
+/**
+ * 比较两个对象的差异
+ * @param obj1 第一个对象
+ * @param obj2 第二个对象
+ * @returns 差异对象
  */
-export declare function deepEqual(a: any, b: any): boolean;
+export declare function diff_objects(obj1: any, obj2: any): Record<string, any>;