@tanwan/utils 1.0.0 → 1.2.0

package/dist/on.cjs

@@ -0,0 +1,21 @@
+//#region src/dom/on/index.ts
+/**
+* 给元素绑定事件
+*
+* @param el - DOM 元素
+* @param event - 事件名
+* @param handler - 事件处理函数
+* @param options - addEventListener 选项
+*
+* @example
+* ```ts
+* import on from '@tanwan/utils/on'
+* on(el, 'click', () => console.log('clicked'))
+* on(el, 'scroll', handler, { passive: true })
+* ```
+*/
+function on(el, event, handler, options) {
+	el.addEventListener(event, handler, options);
+}
+//#endregion
+module.exports = on;

package/dist/on.d.cts

@@ -0,0 +1,18 @@
+//#region src/dom/on/index.d.ts
+/**
+* 给元素绑定事件
+*
+* @param el - DOM 元素
+* @param event - 事件名
+* @param handler - 事件处理函数
+* @param options - addEventListener 选项
+*
+* @example
+* ```ts
+* import on from '@tanwan/utils/on'
+* on(el, 'click', () => console.log('clicked'))
+* on(el, 'scroll', handler, { passive: true })
+* ```
+*/
+declare function on(el: EventTarget, event: string, handler: EventListenerOrEventListenerObject, options?: AddEventListenerOptions): void;
+export = on;

package/dist/on.d.ts

@@ -0,0 +1,19 @@
+//#region src/dom/on/index.d.ts
+/**
+* 给元素绑定事件
+*
+* @param el - DOM 元素
+* @param event - 事件名
+* @param handler - 事件处理函数
+* @param options - addEventListener 选项
+*
+* @example
+* ```ts
+* import on from '@tanwan/utils/on'
+* on(el, 'click', () => console.log('clicked'))
+* on(el, 'scroll', handler, { passive: true })
+* ```
+*/
+declare function on(el: EventTarget, event: string, handler: EventListenerOrEventListenerObject, options?: AddEventListenerOptions): void;
+//#endregion
+export { on as default };

package/dist/on.js

@@ -0,0 +1,21 @@
+//#region src/dom/on/index.ts
+/**
+* 给元素绑定事件
+*
+* @param el - DOM 元素
+* @param event - 事件名
+* @param handler - 事件处理函数
+* @param options - addEventListener 选项
+*
+* @example
+* ```ts
+* import on from '@tanwan/utils/on'
+* on(el, 'click', () => console.log('clicked'))
+* on(el, 'scroll', handler, { passive: true })
+* ```
+*/
+function on(el, event, handler, options) {
+	el.addEventListener(event, handler, options);
+}
+//#endregion
+export { on as default };

package/dist/once.cjs

@@ -0,0 +1,31 @@
+//#region src/function/once/index.ts
+/**
+* 包装函数，确保它只执行一次，后续调用返回第一次的结果
+*
+* @param fn - 需要只执行一次的函数
+* @returns 包装后的函数
+*
+* @example
+* ```ts
+* import once from '@tanwan/utils/once'
+* const initialize = once(() => {
+*   console.log('只执行一次')
+*   return 'done'
+* })
+* initialize() // 'done'（输出日志）
+* initialize() // 'done'（不输出日志）
+* ```
+*/
+function once(fn) {
+	let called = false;
+	let result;
+	return ((...args) => {
+		if (!called) {
+			called = true;
+			result = fn(...args);
+		}
+		return result;
+	});
+}
+//#endregion
+module.exports = once;

package/dist/once.d.cts

@@ -0,0 +1,20 @@
+//#region src/function/once/index.d.ts
+/**
+* 包装函数，确保它只执行一次，后续调用返回第一次的结果
+*
+* @param fn - 需要只执行一次的函数
+* @returns 包装后的函数
+*
+* @example
+* ```ts
+* import once from '@tanwan/utils/once'
+* const initialize = once(() => {
+*   console.log('只执行一次')
+*   return 'done'
+* })
+* initialize() // 'done'（输出日志）
+* initialize() // 'done'（不输出日志）
+* ```
+*/
+declare function once<T extends (...args: unknown[]) => unknown>(fn: T): T;
+export = once;

package/dist/once.d.ts

@@ -0,0 +1,21 @@
+//#region src/function/once/index.d.ts
+/**
+* 包装函数，确保它只执行一次，后续调用返回第一次的结果
+*
+* @param fn - 需要只执行一次的函数
+* @returns 包装后的函数
+*
+* @example
+* ```ts
+* import once from '@tanwan/utils/once'
+* const initialize = once(() => {
+*   console.log('只执行一次')
+*   return 'done'
+* })
+* initialize() // 'done'（输出日志）
+* initialize() // 'done'（不输出日志）
+* ```
+*/
+declare function once<T extends (...args: unknown[]) => unknown>(fn: T): T;
+//#endregion
+export { once as default };

package/dist/once.js

@@ -0,0 +1,31 @@
+//#region src/function/once/index.ts
+/**
+* 包装函数，确保它只执行一次，后续调用返回第一次的结果
+*
+* @param fn - 需要只执行一次的函数
+* @returns 包装后的函数
+*
+* @example
+* ```ts
+* import once from '@tanwan/utils/once'
+* const initialize = once(() => {
+*   console.log('只执行一次')
+*   return 'done'
+* })
+* initialize() // 'done'（输出日志）
+* initialize() // 'done'（不输出日志）
+* ```
+*/
+function once(fn) {
+	let called = false;
+	let result;
+	return ((...args) => {
+		if (!called) {
+			called = true;
+			result = fn(...args);
+		}
+		return result;
+	});
+}
+//#endregion
+export { once as default };

package/dist/parseQueryString.cjs

@@ -0,0 +1,48 @@
+//#region src/url/parseQueryString/index.ts
+/**
+* 解析 URL 查询字符串为对象
+*
+* 支持重复 key 解析为数组，数字字符串自动转为 number，布尔字符串自动转为 boolean
+*
+* @param query - 查询字符串（可带或不带前导 `?`），默认为当前页面 `location.search`
+* @returns 解析后的键值对对象
+*
+* @example
+* ```ts
+* import parseQueryString from '@tanwan/utils/parseQueryString'
+* parseQueryString('?name=John&age=25')           // { name: 'John', age: 25 }
+* parseQueryString('name=John&age=25')             // { name: 'John', age: 25 }
+* parseQueryString('?ids=1&ids=2')                 // { ids: [1, 2] }
+* parseQueryString('?active=true&count=0')         // { active: true, count: 0 }
+* parseQueryString('')                             // {}
+* ```
+*/
+function parseQueryString(query) {
+	const qs = query ?? (typeof location !== "undefined" ? location.search : "");
+	if (!qs) return {};
+	const str = qs.startsWith("?") ? qs.slice(1) : qs;
+	if (!str) return {};
+	const result = {};
+	for (const part of str.split("&")) {
+		if (!part) continue;
+		const [rawKey, rawValue = ""] = part.split("=");
+		const key = decodeURIComponent(rawKey);
+		const parsed = parseValue(decodeURIComponent(rawValue));
+		if (key in result) {
+			const existing = result[key];
+			if (Array.isArray(existing)) existing.push(parsed);
+			else result[key] = [existing, parsed];
+		} else result[key] = parsed;
+	}
+	return result;
+}
+function parseValue(value) {
+	if (value === "true") return true;
+	if (value === "false") return false;
+	if (value === "") return "";
+	const num = Number(value);
+	if (!Number.isNaN(num) && String(num) === value) return num;
+	return value;
+}
+//#endregion
+module.exports = parseQueryString;

package/dist/parseQueryString.d.cts

@@ -0,0 +1,21 @@
+//#region src/url/parseQueryString/index.d.ts
+/**
+* 解析 URL 查询字符串为对象
+*
+* 支持重复 key 解析为数组，数字字符串自动转为 number，布尔字符串自动转为 boolean
+*
+* @param query - 查询字符串（可带或不带前导 `?`），默认为当前页面 `location.search`
+* @returns 解析后的键值对对象
+*
+* @example
+* ```ts
+* import parseQueryString from '@tanwan/utils/parseQueryString'
+* parseQueryString('?name=John&age=25')           // { name: 'John', age: 25 }
+* parseQueryString('name=John&age=25')             // { name: 'John', age: 25 }
+* parseQueryString('?ids=1&ids=2')                 // { ids: [1, 2] }
+* parseQueryString('?active=true&count=0')         // { active: true, count: 0 }
+* parseQueryString('')                             // {}
+* ```
+*/
+declare function parseQueryString(query?: string): Record<string, string | number | boolean | (string | number | boolean)[]>;
+export = parseQueryString;

package/dist/parseQueryString.d.ts

@@ -0,0 +1,22 @@
+//#region src/url/parseQueryString/index.d.ts
+/**
+* 解析 URL 查询字符串为对象
+*
+* 支持重复 key 解析为数组，数字字符串自动转为 number，布尔字符串自动转为 boolean
+*
+* @param query - 查询字符串（可带或不带前导 `?`），默认为当前页面 `location.search`
+* @returns 解析后的键值对对象
+*
+* @example
+* ```ts
+* import parseQueryString from '@tanwan/utils/parseQueryString'
+* parseQueryString('?name=John&age=25')           // { name: 'John', age: 25 }
+* parseQueryString('name=John&age=25')             // { name: 'John', age: 25 }
+* parseQueryString('?ids=1&ids=2')                 // { ids: [1, 2] }
+* parseQueryString('?active=true&count=0')         // { active: true, count: 0 }
+* parseQueryString('')                             // {}
+* ```
+*/
+declare function parseQueryString(query?: string): Record<string, string | number | boolean | (string | number | boolean)[]>;
+//#endregion
+export { parseQueryString as default };

package/dist/parseQueryString.js

@@ -0,0 +1,48 @@
+//#region src/url/parseQueryString/index.ts
+/**
+* 解析 URL 查询字符串为对象
+*
+* 支持重复 key 解析为数组，数字字符串自动转为 number，布尔字符串自动转为 boolean
+*
+* @param query - 查询字符串（可带或不带前导 `?`），默认为当前页面 `location.search`
+* @returns 解析后的键值对对象
+*
+* @example
+* ```ts
+* import parseQueryString from '@tanwan/utils/parseQueryString'
+* parseQueryString('?name=John&age=25')           // { name: 'John', age: 25 }
+* parseQueryString('name=John&age=25')             // { name: 'John', age: 25 }
+* parseQueryString('?ids=1&ids=2')                 // { ids: [1, 2] }
+* parseQueryString('?active=true&count=0')         // { active: true, count: 0 }
+* parseQueryString('')                             // {}
+* ```
+*/
+function parseQueryString(query) {
+	const qs = query ?? (typeof location !== "undefined" ? location.search : "");
+	if (!qs) return {};
+	const str = qs.startsWith("?") ? qs.slice(1) : qs;
+	if (!str) return {};
+	const result = {};
+	for (const part of str.split("&")) {
+		if (!part) continue;
+		const [rawKey, rawValue = ""] = part.split("=");
+		const key = decodeURIComponent(rawKey);
+		const parsed = parseValue(decodeURIComponent(rawValue));
+		if (key in result) {
+			const existing = result[key];
+			if (Array.isArray(existing)) existing.push(parsed);
+			else result[key] = [existing, parsed];
+		} else result[key] = parsed;
+	}
+	return result;
+}
+function parseValue(value) {
+	if (value === "true") return true;
+	if (value === "false") return false;
+	if (value === "") return "";
+	const num = Number(value);
+	if (!Number.isNaN(num) && String(num) === value) return num;
+	return value;
+}
+//#endregion
+export { parseQueryString as default };

package/dist/pascalCase.cjs

@@ -0,0 +1,18 @@
+//#region src/string/pascalCase/index.ts
+/**
+* 将字符串转换为帕斯卡命名（PascalCase）
+*
+* @example
+* ```ts
+* import pascalCase from '@tanwan/utils/pascalCase'
+* pascalCase('foo-bar')   // 'FooBar'
+* pascalCase('foo_bar')   // 'FooBar'
+* pascalCase('foo bar')   // 'FooBar'
+* pascalCase('fooBar')    // 'FooBar'
+* ```
+*/
+function pascalCase(str) {
+	return str.replace(/[-_.\s]+(\w|$)/g, (_, c) => c.toUpperCase()).replace(/^[a-z]/, (c) => c.toUpperCase());
+}
+//#endregion
+module.exports = pascalCase;

package/dist/pascalCase.d.cts

@@ -0,0 +1,15 @@
+//#region src/string/pascalCase/index.d.ts
+/**
+* 将字符串转换为帕斯卡命名（PascalCase）
+*
+* @example
+* ```ts
+* import pascalCase from '@tanwan/utils/pascalCase'
+* pascalCase('foo-bar')   // 'FooBar'
+* pascalCase('foo_bar')   // 'FooBar'
+* pascalCase('foo bar')   // 'FooBar'
+* pascalCase('fooBar')    // 'FooBar'
+* ```
+*/
+declare function pascalCase(str: string): string;
+export = pascalCase;

package/dist/pascalCase.d.ts

@@ -0,0 +1,16 @@
+//#region src/string/pascalCase/index.d.ts
+/**
+* 将字符串转换为帕斯卡命名（PascalCase）
+*
+* @example
+* ```ts
+* import pascalCase from '@tanwan/utils/pascalCase'
+* pascalCase('foo-bar')   // 'FooBar'
+* pascalCase('foo_bar')   // 'FooBar'
+* pascalCase('foo bar')   // 'FooBar'
+* pascalCase('fooBar')    // 'FooBar'
+* ```
+*/
+declare function pascalCase(str: string): string;
+//#endregion
+export { pascalCase as default };

package/dist/pascalCase.js

@@ -0,0 +1,18 @@
+//#region src/string/pascalCase/index.ts
+/**
+* 将字符串转换为帕斯卡命名（PascalCase）
+*
+* @example
+* ```ts
+* import pascalCase from '@tanwan/utils/pascalCase'
+* pascalCase('foo-bar')   // 'FooBar'
+* pascalCase('foo_bar')   // 'FooBar'
+* pascalCase('foo bar')   // 'FooBar'
+* pascalCase('fooBar')    // 'FooBar'
+* ```
+*/
+function pascalCase(str) {
+	return str.replace(/[-_.\s]+(\w|$)/g, (_, c) => c.toUpperCase()).replace(/^[a-z]/, (c) => c.toUpperCase());
+}
+//#endregion
+export { pascalCase as default };

package/dist/pick.cjs

@@ -0,0 +1,22 @@
+//#region src/object/pick/index.ts
+/**
+* 从对象中选取指定 key，返回新对象
+*
+* @param obj - 源对象
+* @param keys - 要选取的 key 数组
+* @returns 包含指定 key 的新对象
+*
+* @example
+* ```ts
+* import pick from '@tanwan/utils/pick'
+* pick({ a: 1, b: 2, c: 3 }, ['a', 'c']) // { a: 1, c: 3 }
+* pick({ x: 'foo' }, ['y'])              // {}
+* ```
+*/
+function pick(obj, keys) {
+	const result = {};
+	for (const key of keys) if (key in obj) result[key] = obj[key];
+	return result;
+}
+//#endregion
+module.exports = pick;

package/dist/pick.d.cts

@@ -0,0 +1,17 @@
+//#region src/object/pick/index.d.ts
+/**
+* 从对象中选取指定 key，返回新对象
+*
+* @param obj - 源对象
+* @param keys - 要选取的 key 数组
+* @returns 包含指定 key 的新对象
+*
+* @example
+* ```ts
+* import pick from '@tanwan/utils/pick'
+* pick({ a: 1, b: 2, c: 3 }, ['a', 'c']) // { a: 1, c: 3 }
+* pick({ x: 'foo' }, ['y'])              // {}
+* ```
+*/
+declare function pick<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+export = pick;

package/dist/pick.d.ts

@@ -0,0 +1,18 @@
+//#region src/object/pick/index.d.ts
+/**
+* 从对象中选取指定 key，返回新对象
+*
+* @param obj - 源对象
+* @param keys - 要选取的 key 数组
+* @returns 包含指定 key 的新对象
+*
+* @example
+* ```ts
+* import pick from '@tanwan/utils/pick'
+* pick({ a: 1, b: 2, c: 3 }, ['a', 'c']) // { a: 1, c: 3 }
+* pick({ x: 'foo' }, ['y'])              // {}
+* ```
+*/
+declare function pick<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+//#endregion
+export { pick as default };

package/dist/pick.js

@@ -0,0 +1,22 @@
+//#region src/object/pick/index.ts
+/**
+* 从对象中选取指定 key，返回新对象
+*
+* @param obj - 源对象
+* @param keys - 要选取的 key 数组
+* @returns 包含指定 key 的新对象
+*
+* @example
+* ```ts
+* import pick from '@tanwan/utils/pick'
+* pick({ a: 1, b: 2, c: 3 }, ['a', 'c']) // { a: 1, c: 3 }
+* pick({ x: 'foo' }, ['y'])              // {}
+* ```
+*/
+function pick(obj, keys) {
+	const result = {};
+	for (const key of keys) if (key in obj) result[key] = obj[key];
+	return result;
+}
+//#endregion
+export { pick as default };

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

@@ -3,7 +3,7 @@
 * 生成指定范围内的随机整数
 * @example
 * ```ts
-* import randomInt from '@tw/utils/randomInt'
+* import randomInt from '@tanwan/utils/randomInt'
 * randomInt(1, 10) // 3（介于 1-10 之间）
 * randomInt(0, 1) // 0 或 1
 * ```

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

@@ -3,11 +3,10 @@
 * 生成指定范围内的随机整数
 * @example
 * ```ts
-* import randomInt from '@tw/utils/randomInt'
+* import randomInt from '@tanwan/utils/randomInt'
 * randomInt(1, 10) // 3（介于 1-10 之间）
 * randomInt(0, 1) // 0 或 1
 * ```
 */
 declare function randomInt(min: number, max: number): number;
-export = randomInt;
-//# sourceMappingURL=randomInt.d.cts.map
+export = randomInt;

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

@@ -3,12 +3,11 @@
 * 生成指定范围内的随机整数
 * @example
 * ```ts
-* import randomInt from '@tw/utils/randomInt'
+* import randomInt from '@tanwan/utils/randomInt'
 * randomInt(1, 10) // 3（介于 1-10 之间）
 * randomInt(0, 1) // 0 或 1
 * ```
 */
 declare function randomInt(min: number, max: number): number;
 //#endregion
-export { randomInt as default };
-//# sourceMappingURL=randomInt.d.ts.map
+export { randomInt as default };

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

@@ -3,7 +3,7 @@
 * 生成指定范围内的随机整数
 * @example
 * ```ts
-* import randomInt from '@tw/utils/randomInt'
+* import randomInt from '@tanwan/utils/randomInt'
 * randomInt(1, 10) // 3（介于 1-10 之间）
 * randomInt(0, 1) // 0 或 1
 * ```
@@ -13,5 +13,3 @@ function randomInt(min, max) {
 }
 //#endregion
 export { randomInt as default };
-
-//# sourceMappingURL=randomInt.js.map

package/dist/range.cjs

@@ -0,0 +1,27 @@
+//#region src/array/range/index.ts
+/**
+* 生成数字序列数组
+*
+* @param start - 起始值（包含）
+* @param end - 结束值（不包含）
+* @param step - 步长，默认为 1
+* @returns 数字序列数组
+*
+* @example
+* ```ts
+* import range from '@tanwan/utils/range'
+* range(1, 5)       // [1, 2, 3, 4]
+* range(0, 10, 2)   // [0, 2, 4, 6, 8]
+* range(5, 0, -1)   // [5, 4, 3, 2, 1]
+* range(0, 0)       // []
+* ```
+*/
+function range(start, end, step = 1) {
+	if (step === 0) throw new Error("step 不能为 0");
+	const result = [];
+	if (step > 0) for (let i = start; i < end; i += step) result.push(i);
+	else for (let i = start; i > end; i += step) result.push(i);
+	return result;
+}
+//#endregion
+module.exports = range;

package/dist/range.d.cts

@@ -0,0 +1,20 @@
+//#region src/array/range/index.d.ts
+/**
+* 生成数字序列数组
+*
+* @param start - 起始值（包含）
+* @param end - 结束值（不包含）
+* @param step - 步长，默认为 1
+* @returns 数字序列数组
+*
+* @example
+* ```ts
+* import range from '@tanwan/utils/range'
+* range(1, 5)       // [1, 2, 3, 4]
+* range(0, 10, 2)   // [0, 2, 4, 6, 8]
+* range(5, 0, -1)   // [5, 4, 3, 2, 1]
+* range(0, 0)       // []
+* ```
+*/
+declare function range(start: number, end: number, step?: number): number[];
+export = range;

package/dist/range.d.ts

@@ -0,0 +1,21 @@
+//#region src/array/range/index.d.ts
+/**
+* 生成数字序列数组
+*
+* @param start - 起始值（包含）
+* @param end - 结束值（不包含）
+* @param step - 步长，默认为 1
+* @returns 数字序列数组
+*
+* @example
+* ```ts
+* import range from '@tanwan/utils/range'
+* range(1, 5)       // [1, 2, 3, 4]
+* range(0, 10, 2)   // [0, 2, 4, 6, 8]
+* range(5, 0, -1)   // [5, 4, 3, 2, 1]
+* range(0, 0)       // []
+* ```
+*/
+declare function range(start: number, end: number, step?: number): number[];
+//#endregion
+export { range as default };

package/dist/range.js

@@ -0,0 +1,27 @@
+//#region src/array/range/index.ts
+/**
+* 生成数字序列数组
+*
+* @param start - 起始值（包含）
+* @param end - 结束值（不包含）
+* @param step - 步长，默认为 1
+* @returns 数字序列数组
+*
+* @example
+* ```ts
+* import range from '@tanwan/utils/range'
+* range(1, 5)       // [1, 2, 3, 4]
+* range(0, 10, 2)   // [0, 2, 4, 6, 8]
+* range(5, 0, -1)   // [5, 4, 3, 2, 1]
+* range(0, 0)       // []
+* ```
+*/
+function range(start, end, step = 1) {
+	if (step === 0) throw new Error("step 不能为 0");
+	const result = [];
+	if (step > 0) for (let i = start; i < end; i += step) result.push(i);
+	else for (let i = start; i > end; i += step) result.push(i);
+	return result;
+}
+//#endregion
+export { range as default };

package/dist/removeClass.cjs

@@ -0,0 +1,19 @@
+//#region src/dom/removeClass/index.ts
+/**
+* 移除元素的 CSS class
+*
+* @param el - DOM 元素
+* @param className - 要移除的 class（支持空格分隔多个）
+*
+* @example
+* ```ts
+* import removeClass from '@tanwan/utils/removeClass'
+* removeClass(el, 'active')
+* removeClass(el, 'foo bar')
+* ```
+*/
+function removeClass(el, className) {
+	el.classList.remove(...className.split(/\s+/).filter(Boolean));
+}
+//#endregion
+module.exports = removeClass;