@tanwan/utils 1.1.0 → 1.2.0

package/dist/index.js

@@ -1,28 +1,91 @@
-import isArray from "./base/isArray.js";
-import isString from "./base/isString.js";
-import isObject from "./base/isObject.js";
-import deepClone from "./base/deepClone.js";
-import isEmpty from "./base/isEmpty.js";
-import pick from "./object/pick.js";
-import omit from "./object/omit.js";
-import debounce from "./function/debounce.js";
-import throttle from "./function/throttle.js";
-import delay from "./function/delay.js";
-import unique from "./array/unique.js";
-import flatten from "./array/flatten.js";
-import chunk from "./array/chunk.js";
-import shuffle from "./array/shuffle.js";
-import range from "./array/range.js";
-import groupBy from "./array/groupBy.js";
-import randomInt from "./number/randomInt.js";
-import clamp from "./number/clamp.js";
-import formatThousands from "./number/formatThousands.js";
-import formatDate from "./date/formatDate.js";
-import getRelativeTime from "./date/getRelativeTime.js";
-import camelCase from "./string/camelCase.js";
-import kebabCase from "./string/kebabCase.js";
-import capitalize from "./string/capitalize.js";
-import uuid from "./string/uuid.js";
-import parseQueryString from "./url/parseQueryString.js";
-import stringifyQueryString from "./url/stringifyQueryString.js";
-export { camelCase, capitalize, chunk, clamp, debounce, deepClone, delay, flatten, formatDate, formatThousands, getRelativeTime, groupBy, isArray, isEmpty, isObject, isString, kebabCase, omit, parseQueryString, pick, randomInt, range, shuffle, stringifyQueryString, throttle, unique, uuid };
+import isArray from "./isArray.js";
+import isString from "./isString.js";
+import isObject from "./isObject.js";
+import deepClone from "./deepClone.js";
+import isEmpty from "./isEmpty.js";
+import isNil from "./isNil.js";
+import isNumber from "./isNumber.js";
+import isFunction from "./isFunction.js";
+import isPromise from "./isPromise.js";
+import isPrimitive from "./isPrimitive.js";
+import isBrowser from "./isBrowser.js";
+import pick from "./pick.js";
+import omit from "./omit.js";
+import deepMerge from "./deepMerge.js";
+import getByPath from "./getByPath.js";
+import mapValues from "./mapValues.js";
+import invert from "./invert.js";
+import debounce from "./debounce.js";
+import throttle from "./throttle.js";
+import delay from "./delay.js";
+import once from "./once.js";
+import memoize from "./memoize.js";
+import unique from "./unique.js";
+import flatten from "./flatten.js";
+import chunk from "./chunk.js";
+import range from "./range.js";
+import groupBy from "./groupBy.js";
+import sortBy from "./sortBy.js";
+import difference from "./difference.js";
+import intersection from "./intersection.js";
+import uniqBy from "./uniqBy.js";
+import sample from "./sample.js";
+import randomInt from "./randomInt.js";
+import clamp from "./clamp.js";
+import formatThousands from "./formatThousands.js";
+import formatDate from "./formatDate.js";
+import getRelativeTime from "./getRelativeTime.js";
+import isDate from "./isDate.js";
+import camelCase from "./camelCase.js";
+import kebabCase from "./kebabCase.js";
+import capitalize from "./capitalize.js";
+import uuid from "./uuid.js";
+import snakeCase from "./snakeCase.js";
+import pascalCase from "./pascalCase.js";
+import truncate from "./truncate.js";
+import maskString from "./maskString.js";
+import parseQueryString from "./parseQueryString.js";
+import stringifyQueryString from "./stringifyQueryString.js";
+import joinUrl from "./joinUrl.js";
+import listToTree from "./listToTree.js";
+import treeToList from "./treeToList.js";
+import treeFind from "./treeFind.js";
+import getStorage from "./getStorage.js";
+import setStorage from "./setStorage.js";
+import removeStorage from "./removeStorage.js";
+import formatCurrency from "./formatCurrency.js";
+import formatFileSize from "./formatFileSize.js";
+import copyToClipboard from "./copyToClipboard.js";
+import downloadFile from "./downloadFile.js";
+import formatPhone from "./formatPhone.js";
+import formatIdCard from "./formatIdCard.js";
+import formatBankCard from "./formatBankCard.js";
+import validatePhone from "./validatePhone.js";
+import validateEmail from "./validateEmail.js";
+import validateIdCard from "./validateIdCard.js";
+import retry from "./retry.js";
+import generateCode from "./generateCode.js";
+import convertCurrencyToChinese from "./convertCurrencyToChinese.js";
+import debounceSubmit from "./debounceSubmit.js";
+import getAge from "./getAge.js";
+import encodeBase64 from "./encodeBase64.js";
+import decodeBase64 from "./decodeBase64.js";
+import hasClass from "./hasClass.js";
+import addClass from "./addClass.js";
+import removeClass from "./removeClass.js";
+import toggleClass from "./toggleClass.js";
+import getStyle from "./getStyle.js";
+import setStyle from "./setStyle.js";
+import on from "./on.js";
+import off from "./off.js";
+import getScrollTop from "./getScrollTop.js";
+import isInViewport from "./isInViewport.js";
+import createElement from "./createElement.js";
+import insertAfter from "./insertAfter.js";
+import removeElement from "./removeElement.js";
+import scrollToElement from "./scrollToElement.js";
+import getCssVar from "./getCssVar.js";
+import setCssVar from "./setCssVar.js";
+import getTextWidth from "./getTextWidth.js";
+import lazyLoadImages from "./lazyLoadImages.js";
+export { addClass, camelCase, capitalize, chunk, clamp, convertCurrencyToChinese, copyToClipboard, createElement, debounce, debounceSubmit, decodeBase64, deepClone, deepMerge, delay, difference, downloadFile, encodeBase64, flatten, formatBankCard, formatCurrency, formatDate, formatFileSize, formatIdCard, formatPhone, formatThousands, generateCode, getAge, getByPath, getCssVar, getRelativeTime, getScrollTop, getStorage, getStyle, getTextWidth, groupBy, hasClass, insertAfter, intersection, invert, isArray, isBrowser, isDate, isEmpty, isFunction, isInViewport, isNil, isNumber, isObject, isPrimitive, isPromise, isString, joinUrl, kebabCase, lazyLoadImages, listToTree, mapValues, maskString, memoize, off, omit, on, once, parseQueryString, pascalCase, pick, randomInt, range, removeClass, removeElement, removeStorage, retry, sample, scrollToElement, setCssVar, setStorage, setStyle, snakeCase, sortBy, stringifyQueryString, throttle, toggleClass, treeFind, treeToList, truncate, uniqBy, unique, uuid, validateEmail, validateIdCard, validatePhone };

package/dist/insertAfter.cjs

@@ -0,0 +1,19 @@
+//#region src/dom/insertAfter/index.ts
+/**
+* 将元素插入到目标元素之后
+*
+* @param el - 要插入的新元素
+* @param target - 目标元素
+*
+* @example
+* ```ts
+* import insertAfter from '@tanwan/utils/insertAfter'
+* insertAfter(newEl, existingEl)
+* ```
+*/
+function insertAfter(el, target) {
+	const parent = target.parentNode;
+	if (parent) parent.insertBefore(el, target.nextSibling);
+}
+//#endregion
+module.exports = insertAfter;

package/dist/insertAfter.d.cts

@@ -0,0 +1,15 @@
+//#region src/dom/insertAfter/index.d.ts
+/**
+* 将元素插入到目标元素之后
+*
+* @param el - 要插入的新元素
+* @param target - 目标元素
+*
+* @example
+* ```ts
+* import insertAfter from '@tanwan/utils/insertAfter'
+* insertAfter(newEl, existingEl)
+* ```
+*/
+declare function insertAfter(el: Node, target: Node): void;
+export = insertAfter;

package/dist/insertAfter.d.ts

@@ -0,0 +1,16 @@
+//#region src/dom/insertAfter/index.d.ts
+/**
+* 将元素插入到目标元素之后
+*
+* @param el - 要插入的新元素
+* @param target - 目标元素
+*
+* @example
+* ```ts
+* import insertAfter from '@tanwan/utils/insertAfter'
+* insertAfter(newEl, existingEl)
+* ```
+*/
+declare function insertAfter(el: Node, target: Node): void;
+//#endregion
+export { insertAfter as default };

package/dist/insertAfter.js

@@ -0,0 +1,19 @@
+//#region src/dom/insertAfter/index.ts
+/**
+* 将元素插入到目标元素之后
+*
+* @param el - 要插入的新元素
+* @param target - 目标元素
+*
+* @example
+* ```ts
+* import insertAfter from '@tanwan/utils/insertAfter'
+* insertAfter(newEl, existingEl)
+* ```
+*/
+function insertAfter(el, target) {
+	const parent = target.parentNode;
+	if (parent) parent.insertBefore(el, target.nextSibling);
+}
+//#endregion
+export { insertAfter as default };

package/dist/intersection.cjs

@@ -0,0 +1,24 @@
+//#region src/array/intersection/index.ts
+/**
+* 计算两个数组的交集
+*
+* @param a - 数组 A
+* @param b - 数组 B
+* @returns 交集新数组
+*
+* @example
+* ```ts
+* import intersection from '@tanwan/utils/intersection'
+* intersection([1, 2, 3], [2, 3, 4])
+* // [2, 3]
+*
+* intersection(['a', 'b'], ['b', 'c'])
+* // ['b']
+* ```
+*/
+function intersection(a, b) {
+	const bSet = new Set(b);
+	return a.filter((item) => bSet.has(item));
+}
+//#endregion
+module.exports = intersection;

package/dist/intersection.d.cts

@@ -0,0 +1,20 @@
+//#region src/array/intersection/index.d.ts
+/**
+* 计算两个数组的交集
+*
+* @param a - 数组 A
+* @param b - 数组 B
+* @returns 交集新数组
+*
+* @example
+* ```ts
+* import intersection from '@tanwan/utils/intersection'
+* intersection([1, 2, 3], [2, 3, 4])
+* // [2, 3]
+*
+* intersection(['a', 'b'], ['b', 'c'])
+* // ['b']
+* ```
+*/
+declare function intersection<T>(a: T[], b: T[]): T[];
+export = intersection;

package/dist/intersection.d.ts

@@ -0,0 +1,21 @@
+//#region src/array/intersection/index.d.ts
+/**
+* 计算两个数组的交集
+*
+* @param a - 数组 A
+* @param b - 数组 B
+* @returns 交集新数组
+*
+* @example
+* ```ts
+* import intersection from '@tanwan/utils/intersection'
+* intersection([1, 2, 3], [2, 3, 4])
+* // [2, 3]
+*
+* intersection(['a', 'b'], ['b', 'c'])
+* // ['b']
+* ```
+*/
+declare function intersection<T>(a: T[], b: T[]): T[];
+//#endregion
+export { intersection as default };

package/dist/intersection.js

@@ -0,0 +1,24 @@
+//#region src/array/intersection/index.ts
+/**
+* 计算两个数组的交集
+*
+* @param a - 数组 A
+* @param b - 数组 B
+* @returns 交集新数组
+*
+* @example
+* ```ts
+* import intersection from '@tanwan/utils/intersection'
+* intersection([1, 2, 3], [2, 3, 4])
+* // [2, 3]
+*
+* intersection(['a', 'b'], ['b', 'c'])
+* // ['b']
+* ```
+*/
+function intersection(a, b) {
+	const bSet = new Set(b);
+	return a.filter((item) => bSet.has(item));
+}
+//#endregion
+export { intersection as default };

package/dist/invert.cjs

@@ -0,0 +1,21 @@
+//#region src/object/invert/index.ts
+/**
+* 交换对象的键和值
+*
+* @param obj - 源对象，值必须可作为键（string / number / symbol）
+* @returns 键值互换后的新对象
+*
+* @example
+* ```ts
+* import invert from '@tanwan/utils/invert'
+* invert({ a: 1, b: 2 })
+* // { '1': 'a', '2': 'b' }
+* ```
+*/
+function invert(obj) {
+	const result = {};
+	for (const key of Object.keys(obj)) result[String(obj[key])] = key;
+	return result;
+}
+//#endregion
+module.exports = invert;

package/dist/invert.d.cts

@@ -0,0 +1,16 @@
+//#region src/object/invert/index.d.ts
+/**
+* 交换对象的键和值
+*
+* @param obj - 源对象，值必须可作为键（string / number / symbol）
+* @returns 键值互换后的新对象
+*
+* @example
+* ```ts
+* import invert from '@tanwan/utils/invert'
+* invert({ a: 1, b: 2 })
+* // { '1': 'a', '2': 'b' }
+* ```
+*/
+declare function invert(obj: Record<string, string | number | symbol>): Record<string, string>;
+export = invert;

package/dist/invert.d.ts

@@ -0,0 +1,17 @@
+//#region src/object/invert/index.d.ts
+/**
+* 交换对象的键和值
+*
+* @param obj - 源对象，值必须可作为键（string / number / symbol）
+* @returns 键值互换后的新对象
+*
+* @example
+* ```ts
+* import invert from '@tanwan/utils/invert'
+* invert({ a: 1, b: 2 })
+* // { '1': 'a', '2': 'b' }
+* ```
+*/
+declare function invert(obj: Record<string, string | number | symbol>): Record<string, string>;
+//#endregion
+export { invert as default };

package/dist/invert.js

@@ -0,0 +1,21 @@
+//#region src/object/invert/index.ts
+/**
+* 交换对象的键和值
+*
+* @param obj - 源对象，值必须可作为键（string / number / symbol）
+* @returns 键值互换后的新对象
+*
+* @example
+* ```ts
+* import invert from '@tanwan/utils/invert'
+* invert({ a: 1, b: 2 })
+* // { '1': 'a', '2': 'b' }
+* ```
+*/
+function invert(obj) {
+	const result = {};
+	for (const key of Object.keys(obj)) result[String(obj[key])] = key;
+	return result;
+}
+//#endregion
+export { invert as default };

package/dist/{base/isArray.d.cts → isArray.d.cts}

@@ -9,5 +9,4 @@
 * ```
 */
 declare function isArray<T>(v: unknown): v is T[];
-export = isArray;
-//# sourceMappingURL=isArray.d.cts.map
+export = isArray;

package/dist/{base/isArray.d.ts → isArray.d.ts}

@@ -10,5 +10,4 @@
 */
 declare function isArray<T>(v: unknown): v is T[];
 //#endregion
-export { isArray as default };
-//# sourceMappingURL=isArray.d.ts.map
+export { isArray as default };

package/dist/{base/isArray.js → isArray.js}

@@ -13,5 +13,3 @@ function isArray(v) {
 }
 //#endregion
 export { isArray as default };
-
-//# sourceMappingURL=isArray.js.map

package/dist/isBrowser.cjs

@@ -0,0 +1,17 @@
+//#region src/base/isBrowser/index.ts
+/**
+* 判断当前是否运行在浏览器环境
+*
+* @example
+* ```ts
+* import isBrowser from '@tanwan/utils/isBrowser'
+* if (isBrowser()) {
+*   // 浏览器环境才执行的代码
+* }
+* ```
+*/
+function isBrowser() {
+	return typeof window !== "undefined" && typeof document !== "undefined";
+}
+//#endregion
+module.exports = isBrowser;

package/dist/isBrowser.d.cts

@@ -0,0 +1,14 @@
+//#region src/base/isBrowser/index.d.ts
+/**
+* 判断当前是否运行在浏览器环境
+*
+* @example
+* ```ts
+* import isBrowser from '@tanwan/utils/isBrowser'
+* if (isBrowser()) {
+*   // 浏览器环境才执行的代码
+* }
+* ```
+*/
+declare function isBrowser(): boolean;
+export = isBrowser;

package/dist/isBrowser.d.ts

@@ -0,0 +1,15 @@
+//#region src/base/isBrowser/index.d.ts
+/**
+* 判断当前是否运行在浏览器环境
+*
+* @example
+* ```ts
+* import isBrowser from '@tanwan/utils/isBrowser'
+* if (isBrowser()) {
+*   // 浏览器环境才执行的代码
+* }
+* ```
+*/
+declare function isBrowser(): boolean;
+//#endregion
+export { isBrowser as default };

package/dist/isBrowser.js

@@ -0,0 +1,17 @@
+//#region src/base/isBrowser/index.ts
+/**
+* 判断当前是否运行在浏览器环境
+*
+* @example
+* ```ts
+* import isBrowser from '@tanwan/utils/isBrowser'
+* if (isBrowser()) {
+*   // 浏览器环境才执行的代码
+* }
+* ```
+*/
+function isBrowser() {
+	return typeof window !== "undefined" && typeof document !== "undefined";
+}
+//#endregion
+export { isBrowser as default };

package/dist/isDate.cjs

@@ -0,0 +1,18 @@
+//#region src/date/isDate/index.ts
+/**
+* 判断值是否为 Date 实例
+*
+* @example
+* ```ts
+* import isDate from '@tanwan/utils/isDate'
+* isDate(new Date())     // true
+* isDate('2024-01-01')  // false
+* isDate(Date.now())    // false
+* isDate(null)          // false
+* ```
+*/
+function isDate(value) {
+	return value instanceof Date;
+}
+//#endregion
+module.exports = isDate;

package/dist/isDate.d.cts

@@ -0,0 +1,15 @@
+//#region src/date/isDate/index.d.ts
+/**
+* 判断值是否为 Date 实例
+*
+* @example
+* ```ts
+* import isDate from '@tanwan/utils/isDate'
+* isDate(new Date())     // true
+* isDate('2024-01-01')  // false
+* isDate(Date.now())    // false
+* isDate(null)          // false
+* ```
+*/
+declare function isDate(value: unknown): value is Date;
+export = isDate;

package/dist/isDate.d.ts

@@ -0,0 +1,16 @@
+//#region src/date/isDate/index.d.ts
+/**
+* 判断值是否为 Date 实例
+*
+* @example
+* ```ts
+* import isDate from '@tanwan/utils/isDate'
+* isDate(new Date())     // true
+* isDate('2024-01-01')  // false
+* isDate(Date.now())    // false
+* isDate(null)          // false
+* ```
+*/
+declare function isDate(value: unknown): value is Date;
+//#endregion
+export { isDate as default };

package/dist/isDate.js

@@ -0,0 +1,18 @@
+//#region src/date/isDate/index.ts
+/**
+* 判断值是否为 Date 实例
+*
+* @example
+* ```ts
+* import isDate from '@tanwan/utils/isDate'
+* isDate(new Date())     // true
+* isDate('2024-01-01')  // false
+* isDate(Date.now())    // false
+* isDate(null)          // false
+* ```
+*/
+function isDate(value) {
+	return value instanceof Date;
+}
+//#endregion
+export { isDate as default };

package/dist/{base/isEmpty.cjs → isEmpty.cjs}

@@ -1,4 +1,4 @@
-const require_base_isObject = require("./isObject.cjs");
+const require_isObject = require("./isObject.cjs");
 //#region src/base/isEmpty/index.ts
 /**
 * 判断值是否为空
@@ -35,7 +35,7 @@ function isEmpty(value) {
 	if (typeof value === "string") return value.length === 0;
 	if (Array.isArray(value)) return value.length === 0;
 	if (value instanceof Map || value instanceof Set) return value.size === 0;
-	if (require_base_isObject(value)) return Object.keys(value).length === 0;
+	if (require_isObject(value)) return Object.keys(value).length === 0;
 	return false;
 }
 //#endregion

package/dist/{base/isEmpty.d.cts → isEmpty.d.cts}

@@ -30,5 +30,4 @@
 * ```
 */
 declare function isEmpty(value: unknown): boolean;
-export = isEmpty;
-//# sourceMappingURL=isEmpty.d.cts.map
+export = isEmpty;

package/dist/{base/isEmpty.d.ts → isEmpty.d.ts}

@@ -31,5 +31,4 @@
 */
 declare function isEmpty(value: unknown): boolean;
 //#endregion
-export { isEmpty as default };
-//# sourceMappingURL=isEmpty.d.ts.map
+export { isEmpty as default };

package/dist/{base/isEmpty.js → isEmpty.js}

@@ -40,5 +40,3 @@ function isEmpty(value) {
 }
 //#endregion
 export { isEmpty as default };
-
-//# sourceMappingURL=isEmpty.js.map

package/dist/isFunction.cjs

@@ -0,0 +1,19 @@
+//#region src/base/isFunction/index.ts
+/**
+* 判断值是否为函数
+*
+* @example
+* ```ts
+* import isFunction from '@tanwan/utils/isFunction'
+* isFunction(() => {})     // true
+* isFunction(async () => {}) // true
+* isFunction(function*() {}) // true
+* isFunction(class {})     // true
+* isFunction(null)         // false
+* ```
+*/
+function isFunction(value) {
+	return typeof value === "function";
+}
+//#endregion
+module.exports = isFunction;

package/dist/isFunction.d.cts

@@ -0,0 +1,16 @@
+//#region src/base/isFunction/index.d.ts
+/**
+* 判断值是否为函数
+*
+* @example
+* ```ts
+* import isFunction from '@tanwan/utils/isFunction'
+* isFunction(() => {})     // true
+* isFunction(async () => {}) // true
+* isFunction(function*() {}) // true
+* isFunction(class {})     // true
+* isFunction(null)         // false
+* ```
+*/
+declare function isFunction(value: unknown): value is Function;
+export = isFunction;

package/dist/isFunction.d.ts

@@ -0,0 +1,17 @@
+//#region src/base/isFunction/index.d.ts
+/**
+* 判断值是否为函数
+*
+* @example
+* ```ts
+* import isFunction from '@tanwan/utils/isFunction'
+* isFunction(() => {})     // true
+* isFunction(async () => {}) // true
+* isFunction(function*() {}) // true
+* isFunction(class {})     // true
+* isFunction(null)         // false
+* ```
+*/
+declare function isFunction(value: unknown): value is Function;
+//#endregion
+export { isFunction as default };

package/dist/isFunction.js

@@ -0,0 +1,19 @@
+//#region src/base/isFunction/index.ts
+/**
+* 判断值是否为函数
+*
+* @example
+* ```ts
+* import isFunction from '@tanwan/utils/isFunction'
+* isFunction(() => {})     // true
+* isFunction(async () => {}) // true
+* isFunction(function*() {}) // true
+* isFunction(class {})     // true
+* isFunction(null)         // false
+* ```
+*/
+function isFunction(value) {
+	return typeof value === "function";
+}
+//#endregion
+export { isFunction as default };