@tanwan/utils 1.0.0 → 1.2.0

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.cjs → isArray.cjs}

@@ -3,7 +3,7 @@
 * 检测变量是否为数组
 * @example
 * ```ts
-* import isArray from '@tw/utils/isArray'
+* import isArray from '@tanwan/utils/isArray'
 * isArray([1, 2, 3]) // true
 * isArray('hello') // false
 * ```

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

@@ -3,11 +3,10 @@
 * 检测变量是否为数组
 * @example
 * ```ts
-* import isArray from '@tw/utils/isArray'
+* import isArray from '@tanwan/utils/isArray'
 * isArray([1, 2, 3]) // true
 * isArray('hello') // false
 * ```
 */
 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}

@@ -3,12 +3,11 @@
 * 检测变量是否为数组
 * @example
 * ```ts
-* import isArray from '@tw/utils/isArray'
+* import isArray from '@tanwan/utils/isArray'
 * isArray([1, 2, 3]) // true
 * isArray('hello') // false
 * ```
 */
 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}

@@ -3,7 +3,7 @@
 * 检测变量是否为数组
 * @example
 * ```ts
-* import isArray from '@tw/utils/isArray'
+* import isArray from '@tanwan/utils/isArray'
 * isArray([1, 2, 3]) // true
 * isArray('hello') // false
 * ```
@@ -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/isEmpty.cjs

@@ -0,0 +1,42 @@
+const require_isObject = require("./isObject.cjs");
+//#region src/base/isEmpty/index.ts
+/**
+* 判断值是否为空
+*
+* 以下情况视为空：
+* - `null` / `undefined`
+* - 空字符串 `''`
+* - 空数组 `[]`
+* - 普通空对象 `{}`
+* - 空 `Map` / 空 `Set`
+*
+* 数字 `0`、布尔值 `false` 等视为非空
+*
+* @param value - 待检测的值
+* @returns 是否为空
+*
+* @example
+* ```ts
+* import isEmpty from '@tanwan/utils/isEmpty'
+* isEmpty(null)      // true
+* isEmpty(undefined) // true
+* isEmpty('')        // true
+* isEmpty([])        // true
+* isEmpty({})        // true
+* isEmpty(new Map()) // true
+* isEmpty(new Set()) // true
+* isEmpty(0)         // false
+* isEmpty(false)     // false
+* isEmpty('hello')   // false
+* ```
+*/
+function isEmpty(value) {
+	if (value === null || value === void 0) return true;
+	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_isObject(value)) return Object.keys(value).length === 0;
+	return false;
+}
+//#endregion
+module.exports = isEmpty;

package/dist/isEmpty.d.cts

@@ -0,0 +1,33 @@
+//#region src/base/isEmpty/index.d.ts
+/**
+* 判断值是否为空
+*
+* 以下情况视为空：
+* - `null` / `undefined`
+* - 空字符串 `''`
+* - 空数组 `[]`
+* - 普通空对象 `{}`
+* - 空 `Map` / 空 `Set`
+*
+* 数字 `0`、布尔值 `false` 等视为非空
+*
+* @param value - 待检测的值
+* @returns 是否为空
+*
+* @example
+* ```ts
+* import isEmpty from '@tanwan/utils/isEmpty'
+* isEmpty(null)      // true
+* isEmpty(undefined) // true
+* isEmpty('')        // true
+* isEmpty([])        // true
+* isEmpty({})        // true
+* isEmpty(new Map()) // true
+* isEmpty(new Set()) // true
+* isEmpty(0)         // false
+* isEmpty(false)     // false
+* isEmpty('hello')   // false
+* ```
+*/
+declare function isEmpty(value: unknown): boolean;
+export = isEmpty;

package/dist/isEmpty.d.ts

@@ -0,0 +1,34 @@
+//#region src/base/isEmpty/index.d.ts
+/**
+* 判断值是否为空
+*
+* 以下情况视为空：
+* - `null` / `undefined`
+* - 空字符串 `''`
+* - 空数组 `[]`
+* - 普通空对象 `{}`
+* - 空 `Map` / 空 `Set`
+*
+* 数字 `0`、布尔值 `false` 等视为非空
+*
+* @param value - 待检测的值
+* @returns 是否为空
+*
+* @example
+* ```ts
+* import isEmpty from '@tanwan/utils/isEmpty'
+* isEmpty(null)      // true
+* isEmpty(undefined) // true
+* isEmpty('')        // true
+* isEmpty([])        // true
+* isEmpty({})        // true
+* isEmpty(new Map()) // true
+* isEmpty(new Set()) // true
+* isEmpty(0)         // false
+* isEmpty(false)     // false
+* isEmpty('hello')   // false
+* ```
+*/
+declare function isEmpty(value: unknown): boolean;
+//#endregion
+export { isEmpty as default };

package/dist/isEmpty.js

@@ -0,0 +1,42 @@
+import isObject from "./isObject.js";
+//#region src/base/isEmpty/index.ts
+/**
+* 判断值是否为空
+*
+* 以下情况视为空：
+* - `null` / `undefined`
+* - 空字符串 `''`
+* - 空数组 `[]`
+* - 普通空对象 `{}`
+* - 空 `Map` / 空 `Set`
+*
+* 数字 `0`、布尔值 `false` 等视为非空
+*
+* @param value - 待检测的值
+* @returns 是否为空
+*
+* @example
+* ```ts
+* import isEmpty from '@tanwan/utils/isEmpty'
+* isEmpty(null)      // true
+* isEmpty(undefined) // true
+* isEmpty('')        // true
+* isEmpty([])        // true
+* isEmpty({})        // true
+* isEmpty(new Map()) // true
+* isEmpty(new Set()) // true
+* isEmpty(0)         // false
+* isEmpty(false)     // false
+* isEmpty('hello')   // false
+* ```
+*/
+function isEmpty(value) {
+	if (value === null || value === void 0) return true;
+	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 (isObject(value)) return Object.keys(value).length === 0;
+	return false;
+}
+//#endregion
+export { isEmpty as default };

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 };

package/dist/isInViewport.cjs

@@ -0,0 +1,22 @@
+//#region src/dom/isInViewport/index.ts
+/**
+* 判断元素是否在可视区域内
+*
+* @param el - DOM 元素
+* @param offset - 偏移量（px），正值提前触发，负值延迟触发
+* @returns 是否在视口中
+*
+* @example
+* ```ts
+* import isInViewport from '@tanwan/utils/isInViewport'
+* isInViewport(el)       // 完全或部分在视口中
+* isInViewport(el, 100)  // 提前 100px 就认为在视口中
+* ```
+*/
+function isInViewport(el, offset = 0) {
+	const rect = el.getBoundingClientRect();
+	const { innerHeight, innerWidth } = window;
+	return rect.top < innerHeight + offset && rect.bottom > -offset && rect.left < innerWidth + offset && rect.right > -offset;
+}
+//#endregion
+module.exports = isInViewport;