@jhqn/utils-core 0.0.3-beta.1 → 0.0.3-beta.11

package/dist/index.d.cts

@@ -7,6 +7,90 @@ 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>>;
+
+interface HostEnv {
+  /**
+   * 是否是浙里办
+   */
+  readonly zlb: boolean
+  /**
+   * 是否是专有钉
+   */
+  readonly zyd: boolean
+  /**
+   * 是否是浙政钉
+   */
+  readonly zzd: boolean
+  /**
+   * 是否是钉钉/专有钉/浙政钉
+   */
+  readonly dd: boolean
+  /**
+   * 是否是微信
+   */
+  readonly wx: boolean
+  /**
+   * 是否是支付宝
+   */
+  readonly zfb: boolean
+  /**
+   * 是否是小程序
+   */
+  readonly mini: boolean
+}
+
 /**
  * snake2Kebab
  * @param {string} str 字符串
@@ -217,43 +301,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 需要隐藏的字符串
@@ -277,8 +324,9 @@ declare const hideHead: (str: UnDef<string>, count?: number) => string;
  */
 declare const hideTail: (str: UnDef<string>, count?: number) => string;
 /**
- * 隐藏手机号
- * @param {string} phone 手机号
+ * 隐藏手机号/座机号
+ * @param {string} phone 手机号/座机号
+ * @returns {string} 隐藏后的手机号/座机号
  */
 declare const hidePhone: (phone: UnDef<string>) => string;
 /**
@@ -314,33 +362,6 @@ declare const hideEmail: (email: UnDef<string>) => string;
  */
 declare const hideBankCard: (bankCard: UnDef<string>) => string;
 
-interface HostEnv {
-  /**
-   * 是否是浙里办
-   */
-  readonly zlb: boolean
-  /**
-   * 是否是专有钉
-   */
-  readonly zyd: boolean
-  /**
-   * 是否是浙政钉
-   */
-  readonly zzd: boolean
-  /**
-   * 是否是微信
-   */
-  readonly wx: boolean
-  /**
-   * 是否是支付宝
-   */
-  readonly zfb: boolean
-  /**
-   * 是否是小程序
-   */
-  readonly mini: boolean
-}
-
 /**
  * 判断是否是浏览器环境
  */
@@ -362,6 +383,16 @@ declare const fixiOSInputAutoZoomIn: () => void;
 declare const userAgent: string;
 /**
  * 获取宿主环境信息
+ * @returns {HostEnv} 宿主环境信息
+ * @example
+ * const hostEnv = getHostEnv()
+ * hostEnv.zlb // 浙里办
+ * hostEnv.zyd // 专有钉
+ * hostEnv.zzd // 浙政钉
+ * hostEnv.dd // 钉钉/专有钉/浙政钉
+ * hostEnv.wx // 微信
+ * hostEnv.zfb // 支付宝
+ * hostEnv.mini // 小程序
  */
 declare const getHostEnv: () => HostEnv;
 
@@ -378,12 +409,22 @@ declare const getCodeOfDate: () => number;
  */
 declare const getCodeOfMonth: () => number;
 
+/**
+ * 设置文件基本路径
+ * @param baseUrl
+ */
+declare function setBaseAttachUrl(baseUrl: string): void;
+/**
+ * 获取文件基本路径
+ */
+declare function getBaseAttachUrl(): string;
+
 /**
  * Json字符串转对象
  * @param str
  * @param reviver
  */
-declare const parseToJSON: <T = any>(str: string, reviver?: ((this: any, key: string, value: any) => any) | undefined) => Nullable<T>;
+declare const parseToJSON: <T = any>(str: string, reviver?: (this: any, key: string, value: any) => any) => Nullable<T>;
 /**
  * JSON.stringify() second param
  * @param _
@@ -406,13 +447,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 开始时间
@@ -420,29 +473,6 @@ declare const dateFmt: (date: ConfigType, format?: string | 'date' | 'datetime')
  */
 declare const dateDuration: (start: ConfigType, end: ConfigType) => string;
 
-/**
- * 设置文件基本路径
- * @param key
- * @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'
@@ -491,16 +521,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;
 };
 /**
  * 附件格式
@@ -515,18 +545,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 检测的目标
@@ -576,7 +620,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 检测的目标
@@ -664,38 +708,30 @@ 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
  */
 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 cnPhoneRE: RegExp;
+declare const cnTelRE: RegExp;
+declare const cnTelRE2: RegExp;
+declare const cnUSCIRE: RegExp;
+declare const cnIdCard15Re: RegExp;
+declare const cnIdCard18Re: RegExp;
+declare const emailRE: RegExp;
+/**
+ * 是否是[统一社会信用代码](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 isValidArrRes: (res: Res<any[]>, code?: number) => boolean;
-/**
- * 校验接口分页返回内容
- * @param res
- * @param code
- */
-declare const isValidPageRes: (res: PageRes, code?: number) => boolean;
-
+declare const isUSCI: (val: UnDef<string>) => boolean;
 /**
  * 是否是中国手机号
  * @param val
@@ -740,4 +776,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 HostEnv, 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, cnIdCard15Re, cnIdCard18Re, cnPhoneRE, cnTelRE, cnTelRE2, cnUSCIRE, currencyFmt, dateDuration, dateFmt, emailRE, 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 };