@tanwan/utils 1.0.0 → 1.2.0

package/dist/formatPhone.d.ts

@@ -0,0 +1,18 @@
+//#region src/business/formatPhone/index.d.ts
+/**
+* 手机号格式化
+*
+* @param phone - 11 位手机号字符串
+* @param mode - `'display'`（显示：188-1234-5678，默认）| `'mask'`（脱敏：188****5678）
+* @returns 格式化后的手机号
+*
+* @example
+* ```ts
+* import formatPhone from '@tanwan/utils/formatPhone'
+* formatPhone('18812345678')              // '188-1234-5678'
+* formatPhone('18812345678', 'mask')      // '188****5678'
+* ```
+*/
+declare function formatPhone(phone: string, mode?: "display" | "mask"): string;
+//#endregion
+export { formatPhone as default };

package/dist/formatPhone.js

@@ -0,0 +1,21 @@
+//#region src/business/formatPhone/index.ts
+/**
+* 手机号格式化
+*
+* @param phone - 11 位手机号字符串
+* @param mode - `'display'`（显示：188-1234-5678，默认）| `'mask'`（脱敏：188****5678）
+* @returns 格式化后的手机号
+*
+* @example
+* ```ts
+* import formatPhone from '@tanwan/utils/formatPhone'
+* formatPhone('18812345678')              // '188-1234-5678'
+* formatPhone('18812345678', 'mask')      // '188****5678'
+* ```
+*/
+function formatPhone(phone, mode = "display") {
+	if (mode === "mask") return phone.replace(/(\d{3})\d{4}(\d{4})/, "$1****$2");
+	return phone.replace(/(\d{3})(\d{4})(\d{4})/, "$1-$2-$3");
+}
+//#endregion
+export { formatPhone as default };

package/dist/{number/formatThousands.cjs → formatThousands.cjs}

@@ -3,7 +3,7 @@
 * 千分位格式化数字
 * @example
 * ```ts
-* import formatThousands from '@tw/utils/formatThousands'
+* import formatThousands from '@tanwan/utils/formatThousands'
 * formatThousands(1234567) // '1,234,567'
 * formatThousands(1234567.89) // '1,234,567.89'
 * ```

package/dist/{number/formatThousands.d.cts → formatThousands.d.cts}

@@ -3,11 +3,10 @@
 * 千分位格式化数字
 * @example
 * ```ts
-* import formatThousands from '@tw/utils/formatThousands'
+* import formatThousands from '@tanwan/utils/formatThousands'
 * formatThousands(1234567) // '1,234,567'
 * formatThousands(1234567.89) // '1,234,567.89'
 * ```
 */
 declare function formatThousands(num: number | string): string;
-export = formatThousands;
-//# sourceMappingURL=formatThousands.d.cts.map
+export = formatThousands;

package/dist/{number/formatThousands.d.ts → formatThousands.d.ts}

@@ -3,12 +3,11 @@
 * 千分位格式化数字
 * @example
 * ```ts
-* import formatThousands from '@tw/utils/formatThousands'
+* import formatThousands from '@tanwan/utils/formatThousands'
 * formatThousands(1234567) // '1,234,567'
 * formatThousands(1234567.89) // '1,234,567.89'
 * ```
 */
 declare function formatThousands(num: number | string): string;
 //#endregion
-export { formatThousands as default };
-//# sourceMappingURL=formatThousands.d.ts.map
+export { formatThousands as default };

package/dist/{number/formatThousands.js → formatThousands.js}

@@ -3,7 +3,7 @@
 * 千分位格式化数字
 * @example
 * ```ts
-* import formatThousands from '@tw/utils/formatThousands'
+* import formatThousands from '@tanwan/utils/formatThousands'
 * formatThousands(1234567) // '1,234,567'
 * formatThousands(1234567.89) // '1,234,567.89'
 * ```
@@ -15,5 +15,3 @@ function formatThousands(num) {
 }
 //#endregion
 export { formatThousands as default };
-
-//# sourceMappingURL=formatThousands.js.map

package/dist/generateCode.cjs

@@ -0,0 +1,29 @@
+//#region src/business/generateCode/index.ts
+/**
+* 生成随机验证码
+*
+* @param length - 验证码长度，默认 6
+* @param type - 类型：`'number'` | `'letter'` | `'mixed'`（默认）
+* @returns 随机验证码字符串
+*
+* @example
+* ```ts
+* import generateCode from '@tanwan/utils/generateCode'
+* generateCode()          // 'a3Bk9M'（混合）
+* generateCode(4)         // 'G2xP'
+* generateCode(6, 'number') // '382410'
+* generateCode(6, 'letter') // 'aBcDeF'
+* ```
+*/
+function generateCode(length = 6, type = "mixed") {
+	const pool = {
+		number: "0123456789",
+		letter: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",
+		mixed: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789"
+	}[type];
+	let result = "";
+	for (let i = 0; i < length; i++) result += pool[Math.floor(Math.random() * pool.length)];
+	return result;
+}
+//#endregion
+module.exports = generateCode;

package/dist/generateCode.d.cts

@@ -0,0 +1,19 @@
+//#region src/business/generateCode/index.d.ts
+/**
+* 生成随机验证码
+*
+* @param length - 验证码长度，默认 6
+* @param type - 类型：`'number'` | `'letter'` | `'mixed'`（默认）
+* @returns 随机验证码字符串
+*
+* @example
+* ```ts
+* import generateCode from '@tanwan/utils/generateCode'
+* generateCode()          // 'a3Bk9M'（混合）
+* generateCode(4)         // 'G2xP'
+* generateCode(6, 'number') // '382410'
+* generateCode(6, 'letter') // 'aBcDeF'
+* ```
+*/
+declare function generateCode(length?: number, type?: "number" | "letter" | "mixed"): string;
+export = generateCode;

package/dist/generateCode.d.ts

@@ -0,0 +1,20 @@
+//#region src/business/generateCode/index.d.ts
+/**
+* 生成随机验证码
+*
+* @param length - 验证码长度，默认 6
+* @param type - 类型：`'number'` | `'letter'` | `'mixed'`（默认）
+* @returns 随机验证码字符串
+*
+* @example
+* ```ts
+* import generateCode from '@tanwan/utils/generateCode'
+* generateCode()          // 'a3Bk9M'（混合）
+* generateCode(4)         // 'G2xP'
+* generateCode(6, 'number') // '382410'
+* generateCode(6, 'letter') // 'aBcDeF'
+* ```
+*/
+declare function generateCode(length?: number, type?: "number" | "letter" | "mixed"): string;
+//#endregion
+export { generateCode as default };

package/dist/generateCode.js

@@ -0,0 +1,29 @@
+//#region src/business/generateCode/index.ts
+/**
+* 生成随机验证码
+*
+* @param length - 验证码长度，默认 6
+* @param type - 类型：`'number'` | `'letter'` | `'mixed'`（默认）
+* @returns 随机验证码字符串
+*
+* @example
+* ```ts
+* import generateCode from '@tanwan/utils/generateCode'
+* generateCode()          // 'a3Bk9M'（混合）
+* generateCode(4)         // 'G2xP'
+* generateCode(6, 'number') // '382410'
+* generateCode(6, 'letter') // 'aBcDeF'
+* ```
+*/
+function generateCode(length = 6, type = "mixed") {
+	const pool = {
+		number: "0123456789",
+		letter: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",
+		mixed: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789"
+	}[type];
+	let result = "";
+	for (let i = 0; i < length; i++) result += pool[Math.floor(Math.random() * pool.length)];
+	return result;
+}
+//#endregion
+export { generateCode as default };

package/dist/getAge.cjs

@@ -0,0 +1,30 @@
+//#region src/business/getAge/index.ts
+/**
+* 计算年龄
+*
+* @param source - 身份证号（18 位）或 `YYYY-MM-DD` 日期字符串
+* @param baseDate - 计算的基准日期，默认为当天
+* @returns 年龄（周岁）
+*
+* @example
+* ```ts
+* import getAge from '@tanwan/utils/getAge'
+* getAge('1990-05-15')                  // 按当天计算
+* getAge('110101199001011234')          // 从身份证计算
+* getAge('1990-05-15', '2024-01-01')    // 按指定日期计算
+* ```
+*/
+function getAge(source, baseDate) {
+	let birthStr;
+	if (source.length === 18) birthStr = `${source.substring(6, 10)}-${source.substring(10, 12)}-${source.substring(12, 14)}`;
+	else birthStr = source;
+	const birth = new Date(birthStr);
+	const base = baseDate ? new Date(baseDate) : /* @__PURE__ */ new Date();
+	let age = base.getFullYear() - birth.getFullYear();
+	const monthDiff = base.getMonth() - birth.getMonth();
+	const dayDiff = base.getDate() - birth.getDate();
+	if (monthDiff < 0 || monthDiff === 0 && dayDiff < 0) age--;
+	return age;
+}
+//#endregion
+module.exports = getAge;

package/dist/getAge.d.cts

@@ -0,0 +1,18 @@
+//#region src/business/getAge/index.d.ts
+/**
+* 计算年龄
+*
+* @param source - 身份证号（18 位）或 `YYYY-MM-DD` 日期字符串
+* @param baseDate - 计算的基准日期，默认为当天
+* @returns 年龄（周岁）
+*
+* @example
+* ```ts
+* import getAge from '@tanwan/utils/getAge'
+* getAge('1990-05-15')                  // 按当天计算
+* getAge('110101199001011234')          // 从身份证计算
+* getAge('1990-05-15', '2024-01-01')    // 按指定日期计算
+* ```
+*/
+declare function getAge(source: string, baseDate?: string | Date): number;
+export = getAge;

package/dist/getAge.d.ts

@@ -0,0 +1,19 @@
+//#region src/business/getAge/index.d.ts
+/**
+* 计算年龄
+*
+* @param source - 身份证号（18 位）或 `YYYY-MM-DD` 日期字符串
+* @param baseDate - 计算的基准日期，默认为当天
+* @returns 年龄（周岁）
+*
+* @example
+* ```ts
+* import getAge from '@tanwan/utils/getAge'
+* getAge('1990-05-15')                  // 按当天计算
+* getAge('110101199001011234')          // 从身份证计算
+* getAge('1990-05-15', '2024-01-01')    // 按指定日期计算
+* ```
+*/
+declare function getAge(source: string, baseDate?: string | Date): number;
+//#endregion
+export { getAge as default };

package/dist/getAge.js

@@ -0,0 +1,30 @@
+//#region src/business/getAge/index.ts
+/**
+* 计算年龄
+*
+* @param source - 身份证号（18 位）或 `YYYY-MM-DD` 日期字符串
+* @param baseDate - 计算的基准日期，默认为当天
+* @returns 年龄（周岁）
+*
+* @example
+* ```ts
+* import getAge from '@tanwan/utils/getAge'
+* getAge('1990-05-15')                  // 按当天计算
+* getAge('110101199001011234')          // 从身份证计算
+* getAge('1990-05-15', '2024-01-01')    // 按指定日期计算
+* ```
+*/
+function getAge(source, baseDate) {
+	let birthStr;
+	if (source.length === 18) birthStr = `${source.substring(6, 10)}-${source.substring(10, 12)}-${source.substring(12, 14)}`;
+	else birthStr = source;
+	const birth = new Date(birthStr);
+	const base = baseDate ? new Date(baseDate) : /* @__PURE__ */ new Date();
+	let age = base.getFullYear() - birth.getFullYear();
+	const monthDiff = base.getMonth() - birth.getMonth();
+	const dayDiff = base.getDate() - birth.getDate();
+	if (monthDiff < 0 || monthDiff === 0 && dayDiff < 0) age--;
+	return age;
+}
+//#endregion
+export { getAge as default };

package/dist/getByPath.cjs

@@ -0,0 +1,29 @@
+//#region src/object/getByPath/index.ts
+/**
+* 通过路径字符串安全获取嵌套对象的值
+*
+* @param obj - 源对象
+* @param path - 属性路径，支持点号分隔和方括号，如 `'a.b[0].c'`
+* @param defaultValue - 路径不存在时的默认值
+* @returns 路径对应的值，或默认值
+*
+* @example
+* ```ts
+* import getByPath from '@tanwan/utils/getByPath'
+* const obj = { a: { b: [{ c: 42 }] } }
+* getByPath(obj, 'a.b[0].c')       // 42
+* getByPath(obj, 'a.x.y')          // undefined
+* getByPath(obj, 'a.x.y', 'none')  // 'none'
+* ```
+*/
+function getByPath(obj, path, defaultValue) {
+	const keys = path.replace(/\[(\d+)\]/g, ".$1").split(".").filter(Boolean);
+	let current = obj;
+	for (const key of keys) {
+		if (current === null || current === void 0 || typeof current !== "object") return defaultValue;
+		current = current[key];
+	}
+	return current === void 0 ? defaultValue : current;
+}
+//#endregion
+module.exports = getByPath;

package/dist/getByPath.d.cts

@@ -0,0 +1,20 @@
+//#region src/object/getByPath/index.d.ts
+/**
+* 通过路径字符串安全获取嵌套对象的值
+*
+* @param obj - 源对象
+* @param path - 属性路径，支持点号分隔和方括号，如 `'a.b[0].c'`
+* @param defaultValue - 路径不存在时的默认值
+* @returns 路径对应的值，或默认值
+*
+* @example
+* ```ts
+* import getByPath from '@tanwan/utils/getByPath'
+* const obj = { a: { b: [{ c: 42 }] } }
+* getByPath(obj, 'a.b[0].c')       // 42
+* getByPath(obj, 'a.x.y')          // undefined
+* getByPath(obj, 'a.x.y', 'none')  // 'none'
+* ```
+*/
+declare function getByPath<T = unknown>(obj: Record<string, unknown>, path: string, defaultValue?: T): T | undefined;
+export = getByPath;

package/dist/getByPath.d.ts

@@ -0,0 +1,21 @@
+//#region src/object/getByPath/index.d.ts
+/**
+* 通过路径字符串安全获取嵌套对象的值
+*
+* @param obj - 源对象
+* @param path - 属性路径，支持点号分隔和方括号，如 `'a.b[0].c'`
+* @param defaultValue - 路径不存在时的默认值
+* @returns 路径对应的值，或默认值
+*
+* @example
+* ```ts
+* import getByPath from '@tanwan/utils/getByPath'
+* const obj = { a: { b: [{ c: 42 }] } }
+* getByPath(obj, 'a.b[0].c')       // 42
+* getByPath(obj, 'a.x.y')          // undefined
+* getByPath(obj, 'a.x.y', 'none')  // 'none'
+* ```
+*/
+declare function getByPath<T = unknown>(obj: Record<string, unknown>, path: string, defaultValue?: T): T | undefined;
+//#endregion
+export { getByPath as default };

package/dist/getByPath.js

@@ -0,0 +1,29 @@
+//#region src/object/getByPath/index.ts
+/**
+* 通过路径字符串安全获取嵌套对象的值
+*
+* @param obj - 源对象
+* @param path - 属性路径，支持点号分隔和方括号，如 `'a.b[0].c'`
+* @param defaultValue - 路径不存在时的默认值
+* @returns 路径对应的值，或默认值
+*
+* @example
+* ```ts
+* import getByPath from '@tanwan/utils/getByPath'
+* const obj = { a: { b: [{ c: 42 }] } }
+* getByPath(obj, 'a.b[0].c')       // 42
+* getByPath(obj, 'a.x.y')          // undefined
+* getByPath(obj, 'a.x.y', 'none')  // 'none'
+* ```
+*/
+function getByPath(obj, path, defaultValue) {
+	const keys = path.replace(/\[(\d+)\]/g, ".$1").split(".").filter(Boolean);
+	let current = obj;
+	for (const key of keys) {
+		if (current === null || current === void 0 || typeof current !== "object") return defaultValue;
+		current = current[key];
+	}
+	return current === void 0 ? defaultValue : current;
+}
+//#endregion
+export { getByPath as default };

package/dist/getCssVar.cjs

@@ -0,0 +1,22 @@
+//#region src/dom/getCssVar/index.ts
+/**
+* 读取 CSS 自定义属性（CSS 变量）
+*
+* @param name - CSS 变量名（可带 `--` 前缀或省略）
+* @param el - 指定元素，不传则读取 `document.documentElement`（`:root`）
+* @returns CSS 变量值
+*
+* @example
+* ```ts
+* import getCssVar from '@tanwan/utils/getCssVar'
+* getCssVar('--color-primary')
+* getCssVar('color-primary')        // 自动补 -- 前缀
+* getCssVar('--bg', document.getElementById('box'))
+* ```
+*/
+function getCssVar(name, el = document.documentElement) {
+	const varName = name.startsWith("--") ? name : `--${name}`;
+	return getComputedStyle(el).getPropertyValue(varName).trim();
+}
+//#endregion
+module.exports = getCssVar;

package/dist/getCssVar.d.cts

@@ -0,0 +1,18 @@
+//#region src/dom/getCssVar/index.d.ts
+/**
+* 读取 CSS 自定义属性（CSS 变量）
+*
+* @param name - CSS 变量名（可带 `--` 前缀或省略）
+* @param el - 指定元素，不传则读取 `document.documentElement`（`:root`）
+* @returns CSS 变量值
+*
+* @example
+* ```ts
+* import getCssVar from '@tanwan/utils/getCssVar'
+* getCssVar('--color-primary')
+* getCssVar('color-primary')        // 自动补 -- 前缀
+* getCssVar('--bg', document.getElementById('box'))
+* ```
+*/
+declare function getCssVar(name: string, el?: Element): string;
+export = getCssVar;

package/dist/getCssVar.d.ts

@@ -0,0 +1,19 @@
+//#region src/dom/getCssVar/index.d.ts
+/**
+* 读取 CSS 自定义属性（CSS 变量）
+*
+* @param name - CSS 变量名（可带 `--` 前缀或省略）
+* @param el - 指定元素，不传则读取 `document.documentElement`（`:root`）
+* @returns CSS 变量值
+*
+* @example
+* ```ts
+* import getCssVar from '@tanwan/utils/getCssVar'
+* getCssVar('--color-primary')
+* getCssVar('color-primary')        // 自动补 -- 前缀
+* getCssVar('--bg', document.getElementById('box'))
+* ```
+*/
+declare function getCssVar(name: string, el?: Element): string;
+//#endregion
+export { getCssVar as default };

package/dist/getCssVar.js

@@ -0,0 +1,22 @@
+//#region src/dom/getCssVar/index.ts
+/**
+* 读取 CSS 自定义属性（CSS 变量）
+*
+* @param name - CSS 变量名（可带 `--` 前缀或省略）
+* @param el - 指定元素，不传则读取 `document.documentElement`（`:root`）
+* @returns CSS 变量值
+*
+* @example
+* ```ts
+* import getCssVar from '@tanwan/utils/getCssVar'
+* getCssVar('--color-primary')
+* getCssVar('color-primary')        // 自动补 -- 前缀
+* getCssVar('--bg', document.getElementById('box'))
+* ```
+*/
+function getCssVar(name, el = document.documentElement) {
+	const varName = name.startsWith("--") ? name : `--${name}`;
+	return getComputedStyle(el).getPropertyValue(varName).trim();
+}
+//#endregion
+export { getCssVar as default };

package/dist/{date/getRelativeTime.cjs → getRelativeTime.cjs}

@@ -3,7 +3,7 @@
 * 获取相对时间描述（如"3分钟前"）
 * @example
 * ```ts
-* import getRelativeTime from '@tw/utils/getRelativeTime'
+* import getRelativeTime from '@tanwan/utils/getRelativeTime'
 * getRelativeTime(Date.now() - 60000) // '1分钟前'
 * getRelativeTime(Date.now() - 3600000) // '1小时前'
 * ```

package/dist/{date/getRelativeTime.d.cts → getRelativeTime.d.cts}

@@ -3,11 +3,10 @@
 * 获取相对时间描述（如"3分钟前"）
 * @example
 * ```ts
-* import getRelativeTime from '@tw/utils/getRelativeTime'
+* import getRelativeTime from '@tanwan/utils/getRelativeTime'
 * getRelativeTime(Date.now() - 60000) // '1分钟前'
 * getRelativeTime(Date.now() - 3600000) // '1小时前'
 * ```
 */
 declare function getRelativeTime(date: number | string | Date, now?: Date): string;
-export = getRelativeTime;
-//# sourceMappingURL=getRelativeTime.d.cts.map
+export = getRelativeTime;

package/dist/{date/getRelativeTime.d.ts → getRelativeTime.d.ts}

@@ -3,12 +3,11 @@
 * 获取相对时间描述（如"3分钟前"）
 * @example
 * ```ts
-* import getRelativeTime from '@tw/utils/getRelativeTime'
+* import getRelativeTime from '@tanwan/utils/getRelativeTime'
 * getRelativeTime(Date.now() - 60000) // '1分钟前'
 * getRelativeTime(Date.now() - 3600000) // '1小时前'
 * ```
 */
 declare function getRelativeTime(date: number | string | Date, now?: Date): string;
 //#endregion
-export { getRelativeTime as default };
-//# sourceMappingURL=getRelativeTime.d.ts.map
+export { getRelativeTime as default };

package/dist/{date/getRelativeTime.js → getRelativeTime.js}

@@ -3,7 +3,7 @@
 * 获取相对时间描述（如"3分钟前"）
 * @example
 * ```ts
-* import getRelativeTime from '@tw/utils/getRelativeTime'
+* import getRelativeTime from '@tanwan/utils/getRelativeTime'
 * getRelativeTime(Date.now() - 60000) // '1分钟前'
 * getRelativeTime(Date.now() - 3600000) // '1小时前'
 * ```
@@ -27,5 +27,3 @@ function getRelativeTime(date, now = /* @__PURE__ */ new Date()) {
 }
 //#endregion
 export { getRelativeTime as default };
-
-//# sourceMappingURL=getRelativeTime.js.map

package/dist/getScrollTop.cjs

@@ -0,0 +1,28 @@
+//#region src/dom/getScrollTop/index.ts
+/**
+* 获取或设置页面/元素的垂直滚动位置
+*
+* @param value - 设置滚动位置（传数字），不传则返回当前滚动位置
+* @param el - 指定元素，不传则使用全局滚动
+* @returns 当前滚动位置（仅 get 模式）
+*
+* @example
+* ```ts
+* import getScrollTop from '@tanwan/utils/getScrollTop'
+* getScrollTop()          // 获取全局滚动位置
+* getScrollTop(100)       // 设置全局滚动位置为 100
+* getScrollTop(0, el)     // 设置元素滚动位置为 0
+* ```
+*/
+function getScrollTop(value, el) {
+	if (value === void 0) {
+		const target = el || window;
+		if (target === window) return window.scrollY || document.documentElement.scrollTop;
+		return target.scrollTop;
+	}
+	const target = el || window;
+	if (target === window) window.scrollTo({ top: value });
+	else target.scrollTop = value;
+}
+//#endregion
+module.exports = getScrollTop;

package/dist/getScrollTop.d.cts

@@ -0,0 +1,18 @@
+//#region src/dom/getScrollTop/index.d.ts
+/**
+* 获取或设置页面/元素的垂直滚动位置
+*
+* @param value - 设置滚动位置（传数字），不传则返回当前滚动位置
+* @param el - 指定元素，不传则使用全局滚动
+* @returns 当前滚动位置（仅 get 模式）
+*
+* @example
+* ```ts
+* import getScrollTop from '@tanwan/utils/getScrollTop'
+* getScrollTop()          // 获取全局滚动位置
+* getScrollTop(100)       // 设置全局滚动位置为 100
+* getScrollTop(0, el)     // 设置元素滚动位置为 0
+* ```
+*/
+declare function getScrollTop(value?: number, el?: Element | Window): number | void;
+export = getScrollTop;

package/dist/getScrollTop.d.ts

@@ -0,0 +1,19 @@
+//#region src/dom/getScrollTop/index.d.ts
+/**
+* 获取或设置页面/元素的垂直滚动位置
+*
+* @param value - 设置滚动位置（传数字），不传则返回当前滚动位置
+* @param el - 指定元素，不传则使用全局滚动
+* @returns 当前滚动位置（仅 get 模式）
+*
+* @example
+* ```ts
+* import getScrollTop from '@tanwan/utils/getScrollTop'
+* getScrollTop()          // 获取全局滚动位置
+* getScrollTop(100)       // 设置全局滚动位置为 100
+* getScrollTop(0, el)     // 设置元素滚动位置为 0
+* ```
+*/
+declare function getScrollTop(value?: number, el?: Element | Window): number | void;
+//#endregion
+export { getScrollTop as default };

package/dist/getScrollTop.js

@@ -0,0 +1,28 @@
+//#region src/dom/getScrollTop/index.ts
+/**
+* 获取或设置页面/元素的垂直滚动位置
+*
+* @param value - 设置滚动位置（传数字），不传则返回当前滚动位置
+* @param el - 指定元素，不传则使用全局滚动
+* @returns 当前滚动位置（仅 get 模式）
+*
+* @example
+* ```ts
+* import getScrollTop from '@tanwan/utils/getScrollTop'
+* getScrollTop()          // 获取全局滚动位置
+* getScrollTop(100)       // 设置全局滚动位置为 100
+* getScrollTop(0, el)     // 设置元素滚动位置为 0
+* ```
+*/
+function getScrollTop(value, el) {
+	if (value === void 0) {
+		const target = el || window;
+		if (target === window) return window.scrollY || document.documentElement.scrollTop;
+		return target.scrollTop;
+	}
+	const target = el || window;
+	if (target === window) window.scrollTo({ top: value });
+	else target.scrollTop = value;
+}
+//#endregion
+export { getScrollTop as default };