@tanwan/utils 1.1.0 → 1.2.0

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/{url/parseQueryString.d.cts → parseQueryString.d.cts}

@@ -18,5 +18,4 @@
 * ```
 */
 declare function parseQueryString(query?: string): Record<string, string | number | boolean | (string | number | boolean)[]>;
-export = parseQueryString;
-//# sourceMappingURL=parseQueryString.d.cts.map
+export = parseQueryString;

package/dist/{url/parseQueryString.d.ts → parseQueryString.d.ts}

@@ -19,5 +19,4 @@
 */
 declare function parseQueryString(query?: string): Record<string, string | number | boolean | (string | number | boolean)[]>;
 //#endregion
-export { parseQueryString as default };
-//# sourceMappingURL=parseQueryString.d.ts.map
+export { parseQueryString as default };

package/dist/{url/parseQueryString.js → parseQueryString.js}

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

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/{object/pick.d.cts → pick.d.cts}

@@ -14,5 +14,4 @@
 * ```
 */
 declare function pick<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
-export = pick;
-//# sourceMappingURL=pick.d.cts.map
+export = pick;

package/dist/{object/pick.d.ts → pick.d.ts}

@@ -15,5 +15,4 @@
 */
 declare function pick<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
 //#endregion
-export { pick as default };
-//# sourceMappingURL=pick.d.ts.map
+export { pick as default };

package/dist/{object/pick.js → pick.js}

@@ -20,5 +20,3 @@ function pick(obj, keys) {
 }
 //#endregion
 export { pick as default };
-
-//# sourceMappingURL=pick.js.map

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

@@ -9,5 +9,4 @@
 * ```
 */
 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}

@@ -10,5 +10,4 @@
 */
 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}

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

package/dist/{array/range.d.cts → range.d.cts}

@@ -17,5 +17,4 @@
 * ```
 */
 declare function range(start: number, end: number, step?: number): number[];
-export = range;
-//# sourceMappingURL=range.d.cts.map
+export = range;

package/dist/{array/range.d.ts → range.d.ts}

@@ -18,5 +18,4 @@
 */
 declare function range(start: number, end: number, step?: number): number[];
 //#endregion
-export { range as default };
-//# sourceMappingURL=range.d.ts.map
+export { range as default };

package/dist/{array/range.js → range.js}

@@ -25,5 +25,3 @@ function range(start, end, step = 1) {
 }
 //#endregion
 export { range as default };
-
-//# sourceMappingURL=range.js.map

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;

package/dist/removeClass.d.cts

@@ -0,0 +1,16 @@
+//#region src/dom/removeClass/index.d.ts
+/**
+* 移除元素的 CSS class
+*
+* @param el - DOM 元素
+* @param className - 要移除的 class（支持空格分隔多个）
+*
+* @example
+* ```ts
+* import removeClass from '@tanwan/utils/removeClass'
+* removeClass(el, 'active')
+* removeClass(el, 'foo bar')
+* ```
+*/
+declare function removeClass(el: Element, className: string): void;
+export = removeClass;

package/dist/removeClass.d.ts

@@ -0,0 +1,17 @@
+//#region src/dom/removeClass/index.d.ts
+/**
+* 移除元素的 CSS class
+*
+* @param el - DOM 元素
+* @param className - 要移除的 class（支持空格分隔多个）
+*
+* @example
+* ```ts
+* import removeClass from '@tanwan/utils/removeClass'
+* removeClass(el, 'active')
+* removeClass(el, 'foo bar')
+* ```
+*/
+declare function removeClass(el: Element, className: string): void;
+//#endregion
+export { removeClass as default };

package/dist/removeClass.js

@@ -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
+export { removeClass as default };

package/dist/removeElement.cjs

@@ -0,0 +1,17 @@
+//#region src/dom/removeElement/index.ts
+/**
+* 安全地移除元素
+*
+* @param el - 要移除的 DOM 元素
+*
+* @example
+* ```ts
+* import removeElement from '@tanwan/utils/removeElement'
+* removeElement(document.getElementById('banner'))
+* ```
+*/
+function removeElement(el) {
+	el.remove();
+}
+//#endregion
+module.exports = removeElement;

package/dist/removeElement.d.cts

@@ -0,0 +1,14 @@
+//#region src/dom/removeElement/index.d.ts
+/**
+* 安全地移除元素
+*
+* @param el - 要移除的 DOM 元素
+*
+* @example
+* ```ts
+* import removeElement from '@tanwan/utils/removeElement'
+* removeElement(document.getElementById('banner'))
+* ```
+*/
+declare function removeElement(el: Element): void;
+export = removeElement;

package/dist/removeElement.d.ts

@@ -0,0 +1,15 @@
+//#region src/dom/removeElement/index.d.ts
+/**
+* 安全地移除元素
+*
+* @param el - 要移除的 DOM 元素
+*
+* @example
+* ```ts
+* import removeElement from '@tanwan/utils/removeElement'
+* removeElement(document.getElementById('banner'))
+* ```
+*/
+declare function removeElement(el: Element): void;
+//#endregion
+export { removeElement as default };

package/dist/removeElement.js

@@ -0,0 +1,17 @@
+//#region src/dom/removeElement/index.ts
+/**
+* 安全地移除元素
+*
+* @param el - 要移除的 DOM 元素
+*
+* @example
+* ```ts
+* import removeElement from '@tanwan/utils/removeElement'
+* removeElement(document.getElementById('banner'))
+* ```
+*/
+function removeElement(el) {
+	el.remove();
+}
+//#endregion
+export { removeElement as default };

package/dist/removeStorage.cjs

@@ -0,0 +1,19 @@
+//#region src/storage/removeStorage/index.ts
+/**
+* 安全地从 localStorage 删除指定键
+*
+* @param key - 存储键名
+*
+* @example
+* ```ts
+* import removeStorage from '@tanwan/utils/removeStorage'
+* removeStorage('user')
+* ```
+*/
+function removeStorage(key) {
+	try {
+		localStorage.removeItem(key);
+	} catch {}
+}
+//#endregion
+module.exports = removeStorage;

package/dist/removeStorage.d.cts

@@ -0,0 +1,14 @@
+//#region src/storage/removeStorage/index.d.ts
+/**
+* 安全地从 localStorage 删除指定键
+*
+* @param key - 存储键名
+*
+* @example
+* ```ts
+* import removeStorage from '@tanwan/utils/removeStorage'
+* removeStorage('user')
+* ```
+*/
+declare function removeStorage(key: string): void;
+export = removeStorage;

package/dist/removeStorage.d.ts

@@ -0,0 +1,15 @@
+//#region src/storage/removeStorage/index.d.ts
+/**
+* 安全地从 localStorage 删除指定键
+*
+* @param key - 存储键名
+*
+* @example
+* ```ts
+* import removeStorage from '@tanwan/utils/removeStorage'
+* removeStorage('user')
+* ```
+*/
+declare function removeStorage(key: string): void;
+//#endregion
+export { removeStorage as default };

package/dist/removeStorage.js

@@ -0,0 +1,19 @@
+//#region src/storage/removeStorage/index.ts
+/**
+* 安全地从 localStorage 删除指定键
+*
+* @param key - 存储键名
+*
+* @example
+* ```ts
+* import removeStorage from '@tanwan/utils/removeStorage'
+* removeStorage('user')
+* ```
+*/
+function removeStorage(key) {
+	try {
+		localStorage.removeItem(key);
+	} catch {}
+}
+//#endregion
+export { removeStorage as default };

package/dist/retry.cjs

@@ -0,0 +1,27 @@
+//#region src/business/retry/index.ts
+/**
+* 异步函数失败自动重试
+*
+* @param fn - 返回 Promise 的函数
+* @param maxRetries - 最大重试次数，默认 3
+* @param delayMs - 每次重试间隔（ms），默认 1000
+* @returns 执行结果
+*
+* @example
+* ```ts
+* import retry from '@tanwan/utils/retry'
+* const data = await retry(() => fetch('/api/data').then(r => r.json()), 3, 1000)
+* ```
+*/
+async function retry(fn, maxRetries = 3, delayMs = 1e3) {
+	let lastError;
+	for (let attempt = 0; attempt <= maxRetries; attempt++) try {
+		return await fn();
+	} catch (error) {
+		lastError = error;
+		if (attempt < maxRetries) await new Promise((resolve) => setTimeout(resolve, delayMs));
+	}
+	throw lastError;
+}
+//#endregion
+module.exports = retry;

package/dist/retry.d.cts

@@ -0,0 +1,17 @@
+//#region src/business/retry/index.d.ts
+/**
+* 异步函数失败自动重试
+*
+* @param fn - 返回 Promise 的函数
+* @param maxRetries - 最大重试次数，默认 3
+* @param delayMs - 每次重试间隔（ms），默认 1000
+* @returns 执行结果
+*
+* @example
+* ```ts
+* import retry from '@tanwan/utils/retry'
+* const data = await retry(() => fetch('/api/data').then(r => r.json()), 3, 1000)
+* ```
+*/
+declare function retry<T>(fn: () => Promise<T>, maxRetries?: number, delayMs?: number): Promise<T>;
+export = retry;

package/dist/retry.d.ts

@@ -0,0 +1,18 @@
+//#region src/business/retry/index.d.ts
+/**
+* 异步函数失败自动重试
+*
+* @param fn - 返回 Promise 的函数
+* @param maxRetries - 最大重试次数，默认 3
+* @param delayMs - 每次重试间隔（ms），默认 1000
+* @returns 执行结果
+*
+* @example
+* ```ts
+* import retry from '@tanwan/utils/retry'
+* const data = await retry(() => fetch('/api/data').then(r => r.json()), 3, 1000)
+* ```
+*/
+declare function retry<T>(fn: () => Promise<T>, maxRetries?: number, delayMs?: number): Promise<T>;
+//#endregion
+export { retry as default };

package/dist/retry.js

@@ -0,0 +1,27 @@
+//#region src/business/retry/index.ts
+/**
+* 异步函数失败自动重试
+*
+* @param fn - 返回 Promise 的函数
+* @param maxRetries - 最大重试次数，默认 3
+* @param delayMs - 每次重试间隔（ms），默认 1000
+* @returns 执行结果
+*
+* @example
+* ```ts
+* import retry from '@tanwan/utils/retry'
+* const data = await retry(() => fetch('/api/data').then(r => r.json()), 3, 1000)
+* ```
+*/
+async function retry(fn, maxRetries = 3, delayMs = 1e3) {
+	let lastError;
+	for (let attempt = 0; attempt <= maxRetries; attempt++) try {
+		return await fn();
+	} catch (error) {
+		lastError = error;
+		if (attempt < maxRetries) await new Promise((resolve) => setTimeout(resolve, delayMs));
+	}
+	throw lastError;
+}
+//#endregion
+export { retry as default };

package/dist/sample.cjs

@@ -0,0 +1,20 @@
+//#region src/array/sample/index.ts
+/**
+* 从数组中随机取一个元素
+*
+* @param arr - 源数组
+* @returns 随机元素，数组为空时返回 `undefined`
+*
+* @example
+* ```ts
+* import sample from '@tanwan/utils/sample'
+* sample([1, 2, 3, 4]) // 可能返回 2
+* sample([])           // undefined
+* ```
+*/
+function sample(arr) {
+	if (arr.length === 0) return void 0;
+	return arr[Math.floor(Math.random() * arr.length)];
+}
+//#endregion
+module.exports = sample;

package/dist/sample.d.cts

@@ -0,0 +1,16 @@
+//#region src/array/sample/index.d.ts
+/**
+* 从数组中随机取一个元素
+*
+* @param arr - 源数组
+* @returns 随机元素，数组为空时返回 `undefined`
+*
+* @example
+* ```ts
+* import sample from '@tanwan/utils/sample'
+* sample([1, 2, 3, 4]) // 可能返回 2
+* sample([])           // undefined
+* ```
+*/
+declare function sample<T>(arr: T[]): T | undefined;
+export = sample;

package/dist/sample.d.ts

@@ -0,0 +1,17 @@
+//#region src/array/sample/index.d.ts
+/**
+* 从数组中随机取一个元素
+*
+* @param arr - 源数组
+* @returns 随机元素，数组为空时返回 `undefined`
+*
+* @example
+* ```ts
+* import sample from '@tanwan/utils/sample'
+* sample([1, 2, 3, 4]) // 可能返回 2
+* sample([])           // undefined
+* ```
+*/
+declare function sample<T>(arr: T[]): T | undefined;
+//#endregion
+export { sample as default };

package/dist/sample.js

@@ -0,0 +1,20 @@
+//#region src/array/sample/index.ts
+/**
+* 从数组中随机取一个元素
+*
+* @param arr - 源数组
+* @returns 随机元素，数组为空时返回 `undefined`
+*
+* @example
+* ```ts
+* import sample from '@tanwan/utils/sample'
+* sample([1, 2, 3, 4]) // 可能返回 2
+* sample([])           // undefined
+* ```
+*/
+function sample(arr) {
+	if (arr.length === 0) return void 0;
+	return arr[Math.floor(Math.random() * arr.length)];
+}
+//#endregion
+export { sample as default };