@jhqn/utils-core 0.0.3-beta.6 → 0.0.3-beta.8

package/dist/index.cjs

@@ -2,22 +2,22 @@
 
 const detectBrowser = require('detect-browser');
 const dayjs = require('dayjs');
-const localeData = require('dayjs/plugin/localeData');
-const duration = require('dayjs/plugin/duration');
-const relativeTime = require('dayjs/plugin/relativeTime');
+const zhCN = require('dayjs/locale/zh-cn');
 const customParseFormat = require('dayjs/plugin/customParseFormat');
+const duration = require('dayjs/plugin/duration');
+const localeData = require('dayjs/plugin/localeData');
 const objectSupport = require('dayjs/plugin/objectSupport');
-const zhCN = require('dayjs/locale/zh-cn');
+const relativeTime = require('dayjs/plugin/relativeTime');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
 
 const dayjs__default = /*#__PURE__*/_interopDefaultCompat(dayjs);
-const localeData__default = /*#__PURE__*/_interopDefaultCompat(localeData);
-const duration__default = /*#__PURE__*/_interopDefaultCompat(duration);
-const relativeTime__default = /*#__PURE__*/_interopDefaultCompat(relativeTime);
+const zhCN__default = /*#__PURE__*/_interopDefaultCompat(zhCN);
 const customParseFormat__default = /*#__PURE__*/_interopDefaultCompat(customParseFormat);
+const duration__default = /*#__PURE__*/_interopDefaultCompat(duration);
+const localeData__default = /*#__PURE__*/_interopDefaultCompat(localeData);
 const objectSupport__default = /*#__PURE__*/_interopDefaultCompat(objectSupport);
-const zhCN__default = /*#__PURE__*/_interopDefaultCompat(zhCN);
+const relativeTime__default = /*#__PURE__*/_interopDefaultCompat(relativeTime);
 
 const snake2Kebab = (str) => str.replace(/_([a-z])/g, (_, letter) => `-${letter.toLowerCase()}`);
 const snake2Pascal = (str) => str.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase()).replace(/^[a-z]/, (letter) => letter.toUpperCase());
@@ -120,6 +120,7 @@ const isJSONStr = (str) => {
       JSON.parse(str);
       return true;
     } catch (e) {
+      jError("isJSONStr", e);
       return false;
     }
   }
@@ -130,6 +131,7 @@ const isArrStr = (str) => {
     try {
       return Array.isArray(JSON.parse(str));
     } catch (e) {
+      jError("isArrStr", e);
       return false;
     }
   }
@@ -140,13 +142,14 @@ const isEmpty = (val) => {
   return !isDef(val) || val === "" || isArray(val) && val.length === 0 || isObject(val) && Object.keys(val).length === 0 || isMap(val) && val.size === 0 || isSet(val) && val.size === 0;
 };
 
-const isValidResCode = (res, code = 200) => res.code === code;
-const isValidRes = (res, code) => isValidResCode(res, code) && isDef(res.data);
-const isValidArrRes = (res, code) => isValidResCode(res, code) && Array.isArray(res.data);
-const isValidPageRes = (res, code) => isValidResCode(res, code) && isDef(res.data) && Array.isArray(res.data.list || res.data.records);
-
 const cnPhoneRE = /^1[3-9]\d{9}$/;
 const cnTelRE = /^0\d{9,11}$/;
+const cnUSCIRE = /^[0-9A-HJ-NPQRTUWXY]{2}\d{6}[0-9A-HJ-NPQRTUWXY]{10}$/;
+const isUSCI = (val) => {
+  if (!isDef(val))
+    return false;
+  return cnUSCIRE.test(val);
+};
 const isPhone = (val) => {
   if (!isDef(val))
     return false;
@@ -203,6 +206,11 @@ const isValidFileType = (file, type) => {
   return validate(type);
 };
 
+const isValidResCode = (res, code = 200) => res.code === code;
+const isValidRes = (res, code) => isValidResCode(res, code) && isDef(res.data);
+const isValidArrRes = (res, code) => isValidResCode(res, code) && Array.isArray(res.data);
+const isValidPageRes = (res, code) => isValidResCode(res, code) && isDef(res.data) && Array.isArray(res.data.list || res.data.records);
+
 const hideMiddle = (str) => {
   if (!isDef(str))
     return "";
@@ -313,14 +321,34 @@ const hideBankCard = (bankCard) => {
   return "";
 };
 
+let __BASE_ATTACH_URL__;
+function setBaseAttachUrl(baseUrl) {
+  __BASE_ATTACH_URL__ = baseUrl;
+}
+function getBaseAttachUrl() {
+  return __BASE_ATTACH_URL__;
+}
+
 const parseToJSON = (str, reviver2) => isJSONStr(str) ? JSON.parse(str, reviver2) : null;
 const replacer = (_, value) => {
-  if (value instanceof Map) {
+  if (isMap(value)) {
     return {
       dataType: "Map",
       value: [...value]
     };
   }
+  if (isSet(value)) {
+    return {
+      dataType: "Set",
+      value: [...value]
+    };
+  }
+  if (isDate(value)) {
+    return {
+      dataType: "Date",
+      value: value.toISOString()
+    };
+  }
   return value;
 };
 const reviver = (_, value) => {
@@ -328,11 +356,33 @@ const reviver = (_, value) => {
     if (value.dataType === "Map") {
       return new Map(value.value);
     }
+    if (value.dataType === "Set") {
+      return new Set(value.value);
+    }
+    if (value.dataType === "Date") {
+      return new Date(value.value);
+    }
   }
   return value;
 };
 const filterObj = (obj, keys, reverse = false) => Object.fromEntries(Object.entries(obj).filter(([key]) => reverse ? !keys.includes(key) : keys.includes(key)));
 
+const toThousands = (num) => {
+  const arr = num.toString().split(".");
+  const integer = arr[0]?.replace(/(\d)(?=(?:\d{3})+$)/g, "$1,");
+  if (arr.length > 1)
+    return `${integer}.${arr[1]}`;
+  return integer;
+};
+const currencyFmt = (currency, maximumFractionDigits = 2) => {
+  if (!isDef(currency))
+    return "";
+  const num = Number(currency);
+  if (Number.isNaN(num))
+    return "";
+  return new Intl.NumberFormat("zh-CN", { style: "currency", currency: "CNY", maximumFractionDigits }).format(num);
+};
+
 dayjs__default.extend(localeData__default).locale("zh-cn", zhCN__default);
 dayjs__default.extend(duration__default);
 dayjs__default.extend(relativeTime__default);
@@ -366,34 +416,10 @@ const dateDuration = (start, end) => {
   return dd.format(format);
 };
 
-let __BASE_ATTACH_URL__;
-function setBaseAttachUrl(baseUrl) {
-  __BASE_ATTACH_URL__ = baseUrl;
-}
-function getBaseAttachUrl() {
-  return __BASE_ATTACH_URL__;
-}
-
-const toThousands = (num) => {
-  const arr = num.toString().split(".");
-  const integer = arr[0]?.replace(/(\d)(?=(?:\d{3})+$)/g, "$1,");
-  if (arr.length > 1)
-    return `${integer}.${arr[1]}`;
-  return integer;
-};
-const currencyFmt = (currency, maximumFractionDigits = 2) => {
-  if (!isDef(currency))
-    return "";
-  const num = Number(currency);
-  if (Number.isNaN(num))
-    return "";
-  return new Intl.NumberFormat("zh-CN", { style: "currency", currency: "CNY", maximumFractionDigits }).format(num);
-};
-
 const resUrl = (url) => {
   if (!isDef(url))
     return void 0;
-  if (/^https?:\/\//.test(url) || /^blob:/.test(url) || /^data:/.test(url)) {
+  if (/^https?:\/\//.test(url) || url.startsWith("blob:") || url.startsWith("data:")) {
     return url;
   }
   const baseUrl = getBaseAttachUrl();
@@ -438,6 +464,23 @@ const attachFmt = (data) => {
   return attachList.map(recoverFile);
 };
 
+const isNumberArray = (arr) => arr.every((item) => typeof item === "number");
+const isStringArray = (arr) => arr.every((item) => typeof item === "string");
+const naturalSort = (arr) => {
+  if (isNumberArray(arr))
+    return [...arr].sort((a, b) => a - b);
+  if (isStringArray(arr)) {
+    return [...arr].sort((a, b) => a.localeCompare(b, "zh-CN")).sort((a, b) => a.length - b.length);
+  }
+  const newArr = [...arr].sort();
+  const validArr = newArr.filter((a) => isDef(a));
+  const invalidArr = newArr.filter((a) => !isDef(a));
+  return naturalSort(validArr).concat(invalidArr);
+};
+const naturalSortBy = (arr, key) => {
+  return [...arr].sort((a, b) => naturalSort([a[key], b[key]])[0] === a[key] ? -1 : 1);
+};
+
 const inBrowser = typeof window !== "undefined";
 const waitTime = (time = 100) => {
   return new Promise((resolve) => {
@@ -539,6 +582,7 @@ exports.isString = isString;
 exports.isSymbol = isSymbol;
 exports.isTel = isTel;
 exports.isURL = isURL;
+exports.isUSCI = isUSCI;
 exports.isUndefined = isUndefined;
 exports.isValidArrRes = isValidArrRes;
 exports.isValidFileType = isValidFileType;
@@ -565,6 +609,8 @@ exports.kebab2Camel = kebab2Camel;
 exports.kebab2Pascal = kebab2Pascal;
 exports.kebab2Snake = kebab2Snake;
 exports.kebab2Title = kebab2Title;
+exports.naturalSort = naturalSort;
+exports.naturalSortBy = naturalSortBy;
 exports.nonASCII = nonASCII;
 exports.parseToJSON = parseToJSON;
 exports.pascal2Camel = pascal2Camel;

package/dist/index.d.cts

@@ -7,6 +7,59 @@ import { ConfigType } from 'dayjs';
 export { Dayjs, default as dayjs } from 'dayjs';
 export { detect } from 'detect-browser';
 
+/**
+ * 数字或字符串
+ */
+type Numeric = number | string;
+/**
+ * 可 Null
+ */
+type Nullable<T> = T | null;
+/**
+ * 可 Undefined
+ */
+type Undefinable<T> = T | undefined;
+/**
+ * 可 Null 或 Undefined
+ */
+type NullOrUndefinable<T> = Nullable<Undefinable<T>>;
+/**
+ * alias for NullOrUndefinable
+ */
+type UnDef<T> = NullOrUndefinable<T>;
+/**
+ * 请求结果
+ */
+type Res<T = any> = Service.Response<T>;
+/**
+ * 分页请求结果数据
+ */
+type PageResData<T = any> = Service.PageResponseData<T>;
+/**
+ * 分页请求结果
+ */
+type PageRes<T = any> = Service.PageResponse<T>;
+/**
+ * 分页请求参数
+ */
+type PageReq<T extends Record<string, any> = NonNullable<unknown>> = Service.PageRequestParams<T>;
+/**
+ * 可能是数组
+ */
+type MaybeArray<T = any> = T | Array<T>;
+/**
+ * 枚举键值对
+ */
+type VK<T = string> = Record<string | number, T>;
+/**
+ * 字典
+ */
+type Dict<T = string> = Record<string, T>;
+/**
+ * 使某键可选
+ */
+type PartialBy<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+
 /**
  * snake2Kebab
  * @param {string} str 字符串
@@ -217,43 +270,6 @@ declare const jLogDedupe: (...args: any[]) => void;
  */
 declare const jLogOnce: (...args: any[]) => void;
 
-/**
- * 数字或字符串
- */
-declare type Numeric = number | string;
-/**
- * 可 Null
- */
-declare type Nullable<T> = T | null;
-/**
- * 可 Undefined
- */
-declare type Undefinable<T> = T | undefined;
-/**
- * 可 Null 或 Undefined
- */
-declare type NullOrUndefinable<T> = Nullable<Undefinable<T>>;
-/**
- * alias for NullOrUndefinable
- */
-declare type UnDef<T> = NullOrUndefinable<T>;
-/**
- * 请求结果
- */
-declare type Res<T = any> = Service.Response<T>;
-/**
- * 分页请求结果数据
- */
-declare type PageResData<T = any> = Service.PageResponseData<T>;
-/**
- * 分页请求结果
- */
-declare type PageRes<T = any> = Service.PageResponse<T>;
-/**
- * 可能是数组
- */
-declare type MaybeArray<T = any> = T | Array<T>;
-
 /**
  * 隐藏中间部分
  * @param {string} str 需要隐藏的字符串
@@ -392,6 +408,16 @@ declare const getCodeOfDate: () => number;
  */
 declare const getCodeOfMonth: () => number;
 
+/**
+ * 设置文件基本路径
+ * @param baseUrl
+ */
+declare function setBaseAttachUrl(baseUrl: string): void;
+/**
+ * 获取文件基本路径
+ */
+declare function getBaseAttachUrl(): string;
+
 /**
  * Json字符串转对象
  * @param str
@@ -420,13 +446,25 @@ declare const filterObj: (obj: Record<string, any>, keys: string[], reverse?: bo
     [k: string]: any;
 };
 
+/**
+ * 千位分隔符
+ * @param num
+ */
+declare const toThousands: (num: number) => string | undefined;
+/**
+ * 货币格式化
+ * @param {number | string | bigint} currency - 金额
+ * @param {number} [maximumFractionDigits] - 小数位数
+ */
+declare const currencyFmt: (currency: UnDef<Numeric | bigint>, maximumFractionDigits?: number) => string;
+
 /**
  * 格式化时间
  * @param {import('dayjs').ConfigType} date 时间
  * @param {string} format 格式
  * @returns {string} 格式化后的时间
  */
-declare const dateFmt: (date: ConfigType, format?: string | 'date' | 'datetime') => string;
+declare const dateFmt: (date: ConfigType, format?: string | "date" | "datetime") => string;
 /**
  * 格式化时间间隔
  * @param {import('dayjs').ConfigType} start 开始时间
@@ -434,28 +472,6 @@ declare const dateFmt: (date: ConfigType, format?: string | 'date' | 'datetime')
  */
 declare const dateDuration: (start: ConfigType, end: ConfigType) => string;
 
-/**
- * 设置文件基本路径
- * @param baseUrl
- */
-declare function setBaseAttachUrl(baseUrl: string): void;
-/**
- * 获取文件基本路径
- */
-declare function getBaseAttachUrl(): string;
-
-/**
- * 千位分隔符
- * @param num
- */
-declare const toThousands: (num: number) => string | undefined;
-/**
- * 货币格式化
- * @param {number | string | bigint} currency - 金额
- * @param {number} [maximumFractionDigits] - 小数位数
- */
-declare const currencyFmt: (currency: UnDef<Numeric | bigint>, maximumFractionDigits?: number) => string;
-
 type VantUploadFileStatus = '' | 'uploading' | 'done' | 'failed'
 type AntdUploadFileStatus = 'removed' | 'uploading' | 'done' | 'error'
 type ElementPlusUploadFileStatus = 'ready' | 'uploading' | 'success' | 'fail'
@@ -504,16 +520,16 @@ declare const recoverFile: (resource: Resource) => {
     group: string;
     id: string;
     name: string;
-    size?: number | undefined;
-    uid?: string | undefined;
-    objectUrl?: string | undefined;
-    isImage?: boolean | undefined;
-    message?: string | undefined;
-    deletable?: boolean | undefined;
-    reupload?: boolean | undefined;
-    fileName?: string | undefined;
-    thumbUrl?: string | undefined;
-    percentage?: number | undefined;
+    size?: number;
+    uid?: string;
+    objectUrl?: string;
+    isImage?: boolean;
+    message?: string;
+    deletable?: boolean;
+    reupload?: boolean;
+    fileName?: string;
+    thumbUrl?: string;
+    percentage?: number;
 };
 /**
  * 附件格式
@@ -528,18 +544,32 @@ declare const attachFmt: (data: UnDef<MaybeArray<Resource>> | string) => {
     group: string;
     id: string;
     name: string;
-    size?: number | undefined;
-    uid?: string | undefined;
-    objectUrl?: string | undefined;
-    isImage?: boolean | undefined;
-    message?: string | undefined;
-    deletable?: boolean | undefined;
-    reupload?: boolean | undefined;
-    fileName?: string | undefined;
-    thumbUrl?: string | undefined;
-    percentage?: number | undefined;
+    size?: number;
+    uid?: string;
+    objectUrl?: string;
+    isImage?: boolean;
+    message?: string;
+    deletable?: boolean;
+    reupload?: boolean;
+    fileName?: string;
+    thumbUrl?: string;
+    percentage?: number;
 }[];
 
+/**
+ * 自然排序
+ * @param {UnDef<string>[] | UnDef<number>[]} arr - 数字或字符串数组
+ * @returns {UnDef<string>[] | UnDef<number>[]} - 排序后的数组
+ */
+declare const naturalSort: (arr: UnDef<string>[] | UnDef<number>[]) => UnDef<string>[] | UnDef<number>[];
+/**
+ * 根据 key 自然排序
+ * @param arr - 数组
+ * @param {string} key - 键名
+ * @returns {any[]} - 排序后的数组
+ */
+declare const naturalSortBy: <T extends Record<string, UnDef<Numeric>>>(arr: T[], key: keyof T) => T[];
+
 /**
  * 检测变量类型
  * @param {any} val 检测的目标
@@ -589,7 +619,7 @@ declare const isObject: (val: any) => val is Record<any, any>;
  * 是否是数组
  * @param {any} val 检测的目标
  */
-declare const isArray: (val: any) => val is any[];
+declare const isArray: (val: any) => val is Array<any>;
 /**
  * 是否是函数，但也有可能是Class
  * @param {any} val 检测的目标
@@ -677,7 +707,7 @@ declare const isArrStr: (str: UnDef<string>) => boolean;
  * ```
  * @returns {boolean} boolean
  */
-declare const isValidKey: (key: string | number | symbol, object: object) => key is never;
+declare const isValidKey: (key: string | number | symbol, object: object) => key is keyof typeof object;
 /**
  * 是否是空值/空数组/空对象 null undefined '' [] {} Set Map
  * @param val
@@ -685,30 +715,15 @@ declare const isValidKey: (key: string | number | symbol, object: object) => key
 declare const isEmpty: (val: UnDef<Numeric | boolean | Record<any, any> | Array<any> | Set<any> | Map<any, any>>) => boolean;
 
 /**
- * 校验接口返回code
- * @param res
- * @param code
- */
-declare const isValidResCode: (res: Res, code?: number) => boolean;
-/**
- * 校验接口返回内容
- * @param res
- * @param code
- */
-declare const isValidRes: (res: Res, code?: number) => boolean;
-/**
- * 校验接口数组返回内容
- * @param res
- * @param code
- */
-declare const isValidArrRes: (res: Res<any[]>, code?: number) => boolean;
-/**
- * 校验接口分页返回内容
- * @param res
- * @param code
+ * 是否是[统一社会信用代码](https://zh.wikipedia.org/zh-cn/%E7%BB%9F%E4%B8%80%E7%A4%BE%E4%BC%9A%E4%BF%A1%E7%94%A8%E4%BB%A3%E7%A0%81)
+ * @example
+ * ```ts
+ * isUSCI('91350100M000100Y43') // true
+ * ```
+ * @param {UnDef<string>} val - 待校验的值
+ * @returns {boolean} 是否是统一社会信用代码
  */
-declare const isValidPageRes: (res: PageRes, code?: number) => boolean;
-
+declare const isUSCI: (val: UnDef<string>) => boolean;
 /**
  * 是否是中国手机号
  * @param val
@@ -753,4 +768,29 @@ declare const nonASCII: (text: string) => boolean;
  */
 declare const isValidFileType: (file: File, type: string) => boolean;
 
-export { type MaybeArray, type NullOrUndefinable, type Nullable, type Numeric, type PageRes, type PageResData, type Res, type UnDef, type Undefinable, attachFmt, camel2Kebab, camel2Pascal, camel2Snake, camel2Title, checkImg, currencyFmt, dateDuration, dateFmt, filterObj, fixiOSInputAutoZoomIn, getBaseAttachUrl, getCodeOfDate, getCodeOfHour, getCodeOfMonth, getHostEnv, getVariableType, hideBankCard, hideCardNo, hideEmail, hideFirstName, hideHead, hideMiddle, hideName, hidePhone, hideSurname, hideTail, hideThird, inBrowser, isArrStr, isArray, isBigInt, isBlob, isBoolean, isDate, isDef, isEmail, isEmpty, isError, isFile, isFunction, isIdCard, isJSONStr, isMap, isNull, isNumber, isNumeric, isObject, isPhone, isPromise, isRegExp, isSet, isString, isSymbol, isTel, isURL, isUndefined, isValidArrRes, isValidFileType, isValidKey, isValidPageRes, isValidRes, isValidResCode, isWeakMap, isWeakSet, jClear, jDebug, jError, jGroup, jGroupC, jGroupE, jInfo, jLog, jLogDedupe, jLogOnce, jTime, jTimeEnd, jWarn, kebab2Camel, kebab2Pascal, kebab2Snake, kebab2Title, nonASCII, parseToJSON, pascal2Camel, pascal2Kebab, pascal2Snake, pascal2Title, recoverFile, replacer, resUrl, reviver, setBaseAttachUrl, snake2Camel, snake2Kebab, snake2Pascal, snake2Title, title2Camel, title2Kebab, title2Pascal, title2Snake, toThousands, userAgent, waitTime };
+/**
+ * 校验接口返回code
+ * @param res
+ * @param code
+ */
+declare const isValidResCode: (res: Res, code?: number) => boolean;
+/**
+ * 校验接口返回内容
+ * @param res
+ * @param code
+ */
+declare const isValidRes: (res: Res, code?: number) => boolean;
+/**
+ * 校验接口数组返回内容
+ * @param res
+ * @param code
+ */
+declare const isValidArrRes: (res: Res<any[]>, code?: number) => boolean;
+/**
+ * 校验接口分页返回内容
+ * @param res
+ * @param code
+ */
+declare const isValidPageRes: (res: PageRes, code?: number) => boolean;
+
+export { type Dict, type MaybeArray, type NullOrUndefinable, type Nullable, type Numeric, type PageReq, type PageRes, type PageResData, type PartialBy, type Res, type UnDef, type Undefinable, type VK, attachFmt, camel2Kebab, camel2Pascal, camel2Snake, camel2Title, checkImg, currencyFmt, dateDuration, dateFmt, filterObj, fixiOSInputAutoZoomIn, getBaseAttachUrl, getCodeOfDate, getCodeOfHour, getCodeOfMonth, getHostEnv, getVariableType, hideBankCard, hideCardNo, hideEmail, hideFirstName, hideHead, hideMiddle, hideName, hidePhone, hideSurname, hideTail, hideThird, inBrowser, isArrStr, isArray, isBigInt, isBlob, isBoolean, isDate, isDef, isEmail, isEmpty, isError, isFile, isFunction, isIdCard, isJSONStr, isMap, isNull, isNumber, isNumeric, isObject, isPhone, isPromise, isRegExp, isSet, isString, isSymbol, isTel, isURL, isUSCI, isUndefined, isValidArrRes, isValidFileType, isValidKey, isValidPageRes, isValidRes, isValidResCode, isWeakMap, isWeakSet, jClear, jDebug, jError, jGroup, jGroupC, jGroupE, jInfo, jLog, jLogDedupe, jLogOnce, jTime, jTimeEnd, jWarn, kebab2Camel, kebab2Pascal, kebab2Snake, kebab2Title, naturalSort, naturalSortBy, nonASCII, parseToJSON, pascal2Camel, pascal2Kebab, pascal2Snake, pascal2Title, recoverFile, replacer, resUrl, reviver, setBaseAttachUrl, snake2Camel, snake2Kebab, snake2Pascal, snake2Title, title2Camel, title2Kebab, title2Pascal, title2Snake, toThousands, userAgent, waitTime };