@jhqn/utils-core 0.4.4 → 0.4.6

package/dist/index.d.ts

@@ -3,9 +3,7 @@
 /// <reference types="dayjs/plugin/relativeTime" />
 /// <reference types="dayjs/plugin/customParseFormat" />
 /// <reference types="dayjs/plugin/objectSupport" />
-
 import dayjs, { ConfigType, Dayjs } from "dayjs";
-
 //#region types/index.d.ts
 /**
  * 数字或字符串
@@ -538,16 +536,25 @@ declare const filterObj: (obj: Record<string, any>, keys: string[], reverse?: bo
 declare const toThousands: (num: number) => string;
 /**
  * 货币格式化
+ * @example
+ * ```ts
+ * currencyFmt(123456.789) // "￥123,456.79"
+ * ```
  * @param {number | string | bigint} currency - 金额
- * @param {number} [maximumFractionDigits] - 小数位数
+ * @param {number} [maximumFractionDigits] - 最多小数位数
  */
 declare const currencyFmt: (currency: UnDef<Numeric | bigint>, maximumFractionDigits?: number) => string;
 //#endregion
 //#region src/format/dayjs.d.ts
 /**
  * 格式化时间
+ * @example
+ * ```ts
+ * dateFmt(new Date(), 'date') // 2024-06-01
+ * dateFmt(dayjs(), 'datetime') // 2024-06-01 12:34:56
+ * ```
  * @param {import('dayjs').ConfigType} date 时间
- * @param {string} format 格式
+ * @param {string} [format = "datetime"] 格式化pattern
  * @returns {string} 格式化后的时间
  */
 declare const dateFmt: (date: ConfigType, format?: string | "date" | "datetime") => string;
@@ -718,6 +725,11 @@ declare const isArray: (val: any) => val is Array<any>;
  * @param {any} val 检测的目标
  */
 declare const isFunction: (val: any) => val is Function;
+/**
+ * 是否是纯函数（不包含 Class，含原生构造函数如 Date、Array 等）
+ * @param {any} val 检测的目标
+ */
+declare const isPureFunction: (val: any) => val is Function;
 /**
  * 是否是日期
  * @param {any} val 检测的目标
@@ -895,4 +907,4 @@ declare const isValidArrRes: (res: Res<any[]>, code?: number) => boolean;
  */
 declare const isValidPageRes: (res: PageRes, code?: number) => boolean;
 //#endregion
-export { type Dayjs, 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, dayjs, emailRE, filterObj, fixiOSInputAutoZoomIn, getBaseAttachUrl, getCodeOfDate, getCodeOfHour, getCodeOfMonth, getHostEnv, getMockData, getMockDataList, getVariableType, hideBankCard, hideCardNo, hideEmail, hideFirstName, hideHead, hideMiddle, 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, parseJSON, parseToJSON, pascal2Camel, pascal2Kebab, pascal2Snake, pascal2Title, recoverFile, replacer, resUrl, reviver, setBaseAttachUrl, snake2Camel, snake2Kebab, snake2Pascal, snake2Title, stringifyJSON, title2Camel, title2Kebab, title2Pascal, title2Snake, toThousands, userAgent, waitTime };
+export { type Dayjs, 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, dayjs, emailRE, filterObj, fixiOSInputAutoZoomIn, getBaseAttachUrl, getCodeOfDate, getCodeOfHour, getCodeOfMonth, getHostEnv, getMockData, getMockDataList, getVariableType, hideBankCard, hideCardNo, hideEmail, hideFirstName, hideHead, hideMiddle, 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, isPureFunction, 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, parseJSON, parseToJSON, pascal2Camel, pascal2Kebab, pascal2Snake, pascal2Title, recoverFile, replacer, resUrl, reviver, setBaseAttachUrl, snake2Camel, snake2Kebab, snake2Pascal, snake2Title, stringifyJSON, title2Camel, title2Kebab, title2Pascal, title2Snake, toThousands, userAgent, waitTime };

package/dist/index.js

@@ -5,7 +5,6 @@ import duration from "dayjs/plugin/duration.js";
 import localeData from "dayjs/plugin/localeData.js";
 import objectSupport from "dayjs/plugin/objectSupport.js";
 import relativeTime from "dayjs/plugin/relativeTime.js";
-
 //#region src/case.ts
 /**
 * snake2Kebab
@@ -150,7 +149,6 @@ const title2Pascal = (str) => str.replace(/ /g, "");
 * @example title2Camel('Hello World') // Hello World => helloWorld
 */
 const title2Camel = (str) => str.replace(/ /g, "").replace(/^[A-Z]/, (match) => match.toLowerCase());
-
 //#endregion
 //#region src/console/log-common.ts
 const sharedStyle = "color: white; padding: 1px 2px;";
@@ -185,7 +183,7 @@ const jGroup = console.group.bind(console, "%c[%s]", `${sharedStyle} background:
 /**
 * jade console.groupCollapsed
 */
-const jGroupC = console.groupCollapsed.bind(console, "%c[%s]", `${sharedStyle} background: slateblue;`);
+const jGroupC = console?.groupCollapsed?.bind(console, "%c[%s]", `${sharedStyle} background: slateblue;`);
 /**
 * jade console.groupEnd
 */
@@ -194,17 +192,16 @@ const jGroupE = console.groupEnd.bind(console);
 * jade console.time
 * @param str
 */
-const jTime = (str) => console.time(`[${str}]`);
+const jTime = (str) => console?.time(`[${str}]`);
 /**
 * jade console.timeEnd
 * @param str
 */
-const jTimeEnd = (str) => console.timeEnd(`[${str}]`);
+const jTimeEnd = (str) => console?.timeEnd(`[${str}]`);
 /**
 * jade console.clear
 */
-const jClear = console.clear.bind(console);
-
+const jClear = console?.clear?.bind(console);
 //#endregion
 //#region src/console/log-dedupe.ts
 let prevValue;
@@ -218,7 +215,6 @@ const jLogDedupe = (...args) => {
 	jLog(...args);
 	prevValue = args;
 };
-
 //#endregion
 //#region src/console/log-once.ts
 let logged = false;
@@ -231,7 +227,6 @@ const jLogOnce = (...args) => {
 	jLog(...args);
 	logged = true;
 };
-
 //#endregion
 //#region src/validate/core.ts
 /**
@@ -288,7 +283,18 @@ const isArray = (val) => Array.isArray(val);
 * 是否是函数，但也有可能是Class
 * @param {any} val 检测的目标
 */
-const isFunction = (val) => getVariableType(val) === "function";
+const isFunction = (val) => typeof val === "function";
+/**
+* 是否是纯函数（不包含 Class，含原生构造函数如 Date、Array 等）
+* @param {any} val 检测的目标
+*/
+const isPureFunction = (val) => {
+	if (!isFunction(val)) return false;
+	const source = Function.prototype.toString.call(val);
+	if (source.startsWith("class")) return false;
+	if (source.includes("[native code]") && val.prototype !== void 0) return false;
+	return true;
+};
 /**
 * 是否是日期
 * @param {any} val 检测的目标
@@ -407,7 +413,6 @@ const isValidKey = (key, object) => key in object;
 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;
 };
-
 //#endregion
 //#region src/validate/form.ts
 const cnPhoneRE = /^1[3-9]\d{9}$/;
@@ -508,7 +513,6 @@ const isValidFileType = (file, type) => {
 	if (typeArrStr.length > 1) return typeArrStr.some(validate);
 	return validate(type);
 };
-
 //#endregion
 //#region src/validate/request.ts
 /**
@@ -535,7 +539,6 @@ const isValidArrRes = (res, code) => isValidResCode(res, code) && isArray(res.da
 * @param code
 */
 const isValidPageRes = (res, code) => isValidResCode(res, code) && isDef(res.data) && isArray(res.data.list || res.data.records);
-
 //#endregion
 //#region src/desensitize.ts
 /**
@@ -723,7 +726,6 @@ const hideBankCard = (bankCard) => {
 	}
 	return "";
 };
-
 //#endregion
 //#region src/format/baseAttachUrl.ts
 /**
@@ -743,7 +745,6 @@ function setBaseAttachUrl(baseUrl) {
 function getBaseAttachUrl() {
 	return __BASE_ATTACH_URL__;
 }
-
 //#endregion
 //#region src/format/core.ts
 /**
@@ -817,7 +818,6 @@ function reviver(_key, value) {
 * @param {boolean} reverse 为true时过滤取反
 */
 const filterObj = (obj, keys, reverse = false) => Object.fromEntries(Object.entries(obj).filter(([key]) => reverse ? !keys.includes(key) : keys.includes(key)));
-
 //#endregion
 //#region src/format/currency.ts
 /**
@@ -832,8 +832,12 @@ const toThousands = (num) => {
 };
 /**
 * 货币格式化
+* @example
+* ```ts
+* currencyFmt(123456.789) // "￥123,456.79"
+* ```
 * @param {number | string | bigint} currency - 金额
-* @param {number} [maximumFractionDigits] - 小数位数
+* @param {number} [maximumFractionDigits] - 最多小数位数
 */
 const currencyFmt = (currency, maximumFractionDigits = 2) => {
 	if (!isDef(currency)) return "";
@@ -845,7 +849,6 @@ const currencyFmt = (currency, maximumFractionDigits = 2) => {
 		maximumFractionDigits
 	}).format(num);
 };
-
 //#endregion
 //#region src/format/dayjs.ts
 dayjs.extend(localeData).locale("zh-cn", zhCN);
@@ -855,11 +858,16 @@ dayjs.extend(customParseFormat);
 dayjs.extend(objectSupport);
 /**
 * 格式化时间
+* @example
+* ```ts
+* dateFmt(new Date(), 'date') // 2024-06-01
+* dateFmt(dayjs(), 'datetime') // 2024-06-01 12:34:56
+* ```
 * @param {import('dayjs').ConfigType} date 时间
-* @param {string} format 格式
+* @param {string} [format = "datetime"] 格式化pattern
 * @returns {string} 格式化后的时间
 */
-const dateFmt = (date, format = "YYYY-MM-DD HH:mm:ss") => {
+const dateFmt = (date, format = "datetime") => {
 	const dd = dayjs(date);
 	let fmt = format;
 	if (!isDef(date) || !dd.isValid()) return "";
@@ -887,7 +895,6 @@ const dateDuration = (start, end) => {
 	].join("");
 	return dd.format(format);
 };
-
 //#endregion
 //#region src/format/resource.ts
 /**
@@ -940,7 +947,6 @@ const attachFmt = (data) => {
 	else if (prototype === "[object Object]") attachList = [data];
 	return attachList.map(recoverFile);
 };
-
 //#endregion
 //#region src/format/sort.ts
 /**
@@ -977,7 +983,6 @@ const naturalSort = (arr) => {
 const naturalSortBy = (arr, key) => {
 	return [...arr].sort((a, b) => naturalSort([a[key], b[key]])[0] === a[key] ? -1 : 1);
 };
-
 //#endregion
 //#region src/dom.ts
 /**
@@ -1056,7 +1061,6 @@ const getCodeOfDate = () => getCodeOfTime(dateFmt(/* @__PURE__ */ new Date(), "d
 * 获取当月的时间戳的异或值的绝对值, 当月内获取的值是唯一的
 */
 const getCodeOfMonth = () => getCodeOfTime(dateFmt(dayjs().endOf("month"), "date"));
-
 //#endregion
 //#region src/mock.ts
 const getMockData = (data, code = 200, message = "success") => {
@@ -1078,6 +1082,5 @@ const getMockDataList = (data, total, code = 200, message = "success", options =
 		message
 	};
 };
-
 //#endregion
-export { attachFmt, camel2Kebab, camel2Pascal, camel2Snake, camel2Title, checkImg, cnIdCard15Re, cnIdCard18Re, cnPhoneRE, cnTelRE, cnTelRE2, cnUSCIRE, currencyFmt, dateDuration, dateFmt, dayjs, emailRE, filterObj, fixiOSInputAutoZoomIn, getBaseAttachUrl, getCodeOfDate, getCodeOfHour, getCodeOfMonth, getHostEnv, getMockData, getMockDataList, getVariableType, hideBankCard, hideCardNo, hideEmail, hideFirstName, hideHead, hideMiddle, 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, parseJSON, parseToJSON, pascal2Camel, pascal2Kebab, pascal2Snake, pascal2Title, recoverFile, replacer, resUrl, reviver, setBaseAttachUrl, snake2Camel, snake2Kebab, snake2Pascal, snake2Title, stringifyJSON, title2Camel, title2Kebab, title2Pascal, title2Snake, toThousands, userAgent, waitTime };
+export { attachFmt, camel2Kebab, camel2Pascal, camel2Snake, camel2Title, checkImg, cnIdCard15Re, cnIdCard18Re, cnPhoneRE, cnTelRE, cnTelRE2, cnUSCIRE, currencyFmt, dateDuration, dateFmt, dayjs, emailRE, filterObj, fixiOSInputAutoZoomIn, getBaseAttachUrl, getCodeOfDate, getCodeOfHour, getCodeOfMonth, getHostEnv, getMockData, getMockDataList, getVariableType, hideBankCard, hideCardNo, hideEmail, hideFirstName, hideHead, hideMiddle, 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, isPureFunction, 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, parseJSON, parseToJSON, pascal2Camel, pascal2Kebab, pascal2Snake, pascal2Title, recoverFile, replacer, resUrl, reviver, setBaseAttachUrl, snake2Camel, snake2Kebab, snake2Pascal, snake2Title, stringifyJSON, title2Camel, title2Kebab, title2Pascal, title2Snake, toThousands, userAgent, waitTime };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jhqn/utils-core",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "keywords": [
     "jade",
     "utils"
@@ -33,7 +33,7 @@
     }
   },
   "dependencies": {
-    "dayjs": "^1.11.19",
+    "dayjs": "^1.11.21",
     "detect-browser-es": "0.1.1"
   },
   "scripts": {