@brix-sdk/platform-shared 1.0.0

package/dist/utils/index.d.ts

@@ -0,0 +1,795 @@
+export { S as SimpleSnowflake, c as createDailySequenceIdGenerator, a as createSequenceIdGenerator, e as extractTimestampFromId, g as generateNanoId, b as generateShortId, d as generateSnowflakeId, f as generateTimestampId, h as generateUUID, i as isValidUUID } from '../id-BFKGN254.js';
+
+/**
+ * Copyright 2026 Brix Platform Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @file Debounce and throttle utilities
+ * @description Provides debounce and throttle functions
+ * @module @brix-sdk/platform-shared/utils/debounce
+ * @version 3.0.0
+ */
+/**
+ * Debounce function
+ *
+ * Delays function execution until stopped calling for a period of time.
+ *
+ * @param fn - Function to debounce
+ * @param delay - Delay in milliseconds
+ * @returns Debounced function
+ *
+ * @example
+ * ```typescript
+ * const debouncedSearch = debounce((query: string) => {
+ *   search(query);
+ * }, 300);
+ *
+ * input.addEventListener('input', (e) => {
+ *   debouncedSearch(e.target.value);
+ * });
+ * ```
+ */
+declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, delay: number): (this: ThisParameterType<T>, ...args: Parameters<T>) => void;
+/**
+ * Throttle function
+ *
+ * Limits function execution frequency to execute only once within specified time.
+ *
+ * @param fn - Function to throttle
+ * @param limit - Limit in milliseconds
+ * @returns Throttled function
+ *
+ * @example
+ * ```typescript
+ * const throttledScroll = throttle(() => {
+ *   updatePosition();
+ * }, 100);
+ *
+ * window.addEventListener('scroll', throttledScroll);
+ * ```
+ */
+declare function throttle<T extends (...args: unknown[]) => unknown>(fn: T, limit: number): (this: ThisParameterType<T>, ...args: Parameters<T>) => void;
+
+/**
+ * Copyright 2026 Brix Platform Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @file Type guard utilities
+ * @description Provides type guards and assertion functions
+ * @module @brix-sdk/platform-shared/utils/guards
+ * @version 3.0.0
+ */
+/**
+ * Check if value is null or undefined
+ *
+ * @param value - Value to check
+ * @returns Whether value is null or undefined
+ */
+declare function isNullOrUndefined(value: unknown): value is null | undefined;
+/**
+ * Check if value is non-null and non-undefined
+ *
+ * @param value - Value to check
+ * @returns Whether value is non-null
+ */
+declare function isNotNullOrUndefined<T>(value: T): value is NonNullable<T>;
+/**
+ * Check if value is a string
+ *
+ * @param value - Value to check
+ * @returns Whether value is a string
+ */
+declare function isString(value: unknown): value is string;
+/**
+ * Check if value is a number
+ *
+ * @param value - Value to check
+ * @returns Whether value is a number
+ */
+declare function isNumber(value: unknown): value is number;
+/**
+ * Check if value is a boolean
+ *
+ * @param value - Value to check
+ * @returns Whether value is a boolean
+ */
+declare function isBoolean(value: unknown): value is boolean;
+/**
+ * Check if value is a function
+ *
+ * @param value - Value to check
+ * @returns Whether value is a function
+ */
+declare function isFunction(value: unknown): value is (...args: unknown[]) => unknown;
+/**
+ * Check if value is an object
+ *
+ * @param value - Value to check
+ * @returns Whether value is an object
+ */
+declare function isObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Check if value is an array
+ *
+ * @param value - Value to check
+ * @returns Whether value is an array
+ */
+declare function isArray(value: unknown): value is unknown[];
+/**
+ * Check if value is a Promise
+ *
+ * @param value - Value to check
+ * @returns Whether value is a Promise
+ */
+declare function isPromise(value: unknown): value is Promise<unknown>;
+/**
+ * Assert value is non-null
+ *
+ * @param value - Value to assert
+ * @param message - Error message
+ */
+declare function assertNotNull<T>(value: T, message?: string): asserts value is NonNullable<T>;
+/**
+ * Assert condition is true
+ *
+ * @param condition - Condition to assert
+ * @param message - Error message
+ */
+declare function assert(condition: boolean, message?: string): asserts condition;
+
+/**
+ * Copyright 2026 Brix Platform Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @file Deep clone utility
+ * @description Provides deep clone functions
+ * @module @brix-sdk/platform-shared/utils/clone
+ * @version 3.0.0
+ */
+/**
+ * Deep clone an object
+ *
+ * Supports Date, RegExp, Map, Set, and other types.
+ *
+ * @param obj - Object to clone
+ * @returns Cloned object
+ */
+declare function deepClone<T>(obj: T): T;
+/**
+ * Deep merge objects
+ *
+ * @param target - Target object
+ * @param sources - Source objects array
+ * @returns Merged object
+ */
+declare function deepMerge<T extends Record<string, unknown>>(target: T, ...sources: Partial<T>[]): T;
+
+/**
+ * @file format.ts
+ * @description 格式化工具函数集
+ * @module @brix-sdk/utils/format
+ * @version 3.0.0
+ *
+ * 【模块说明�? * 提供各种数据格式化工具，包括文件大小、日期时间、数字、货币、字符串等�? * 这些函数遵循中国大陆的常用格式习惯，同时支持国际化配置�? *
+ * 【使用场景�? * - 文件大小：上传下载、存储空间显�? * - 日期格式化：时间显示、相对时间、倒计�? * - 数字格式化：金额、百分比、统计数�? * - 字符串处理：截断、大小写转换
+ *
+ * @license Apache-2.0
+ */
+/**
+ * 格式化文件大�? *
+ * 【功能说明�? * 将字节数转换为人类可读的文件大小格式�? * 自动选择合适的单位（B、KB、MB、GB 等）�? *
+ * @param bytes 字节�? * @param decimals 小数位数（默�?2�? * @returns 格式化后的字符串
+ *
+ * @example
+ * ```typescript
+ * formatFileSize(0);          // '0 B'
+ * formatFileSize(1024);       // '1 KB'
+ * formatFileSize(1048576);    // '1 MB'
+ * formatFileSize(1073741824); // '1 GB'
+ * formatFileSize(1536, 1);    // '1.5 KB'
+ * ```
+ */
+declare function formatFileSize(bytes: number, decimals?: number): string;
+/**
+ * 解析文件大小字符串为字节�? *
+ * 【功能说明�? * 将文件大小字符串（如 '1 MB', '500KB'）解析为字节数�? * 支持各种常见格式，大小写不敏感�? *
+ * @param sizeStr 文件大小字符�? * @returns 字节数（解析失败返回 0�? *
+ * @example
+ * ```typescript
+ * parseFileSize('1 KB');   // 1024
+ * parseFileSize('1.5MB');  // 1572864
+ * parseFileSize('2 GB');   // 2147483648
+ * parseFileSize('invalid'); // 0
+ * ```
+ */
+declare function parseFileSize(sizeStr: string): number;
+/**
+ * 格式化日�? *
+ * 【功能说明�? * 将日期格式化为指定格式的字符串�? * 支持常用的占位符，如 YYYY、MM、DD、HH、mm、ss 等�? *
+ * 【支持的占位符�? * - YYYY: 四位年份
+ * - YY: 两位年份
+ * - MM: 两位月份�?1-12�? * - M: 月份�?-12�? * - DD: 两位日期�?1-31�? * - D: 日期�?-31�? * - HH: 两位小时�?0-23�? * - H: 小时�?-23�? * - mm: 两位分钟�?0-59�? * - m: 分钟�?-59�? * - ss: 两位秒（00-59�? * - s: 秒（0-59�? * - SSS: 毫秒
+ *
+ * @param date 日期（Date 对象、时间戳或日期字符串�? * @param format 格式字符串（默认 'YYYY-MM-DD HH:mm:ss'�? * @returns 格式化后的日期字符串
+ *
+ * @example
+ * ```typescript
+ * formatDate(new Date(), 'YYYY-MM-DD');          // '2024-01-01'
+ * formatDate(Date.now(), 'YYYY-MM-DD HH:mm:ss'); // '2024-01-01 12:00:00'
+ * formatDate(new Date(), 'YYYY年MM月DD�?);      // '2024�?1�?1�?
+ * formatDate(new Date(), 'MM/DD/YYYY');          // '01/01/2024'
+ * ```
+ */
+declare function formatDate(date: Date | number | string, format?: string): string;
+/**
+ * 格式化相对时�? *
+ * 【功能说明�? * 将日期转换为相对于当前时间的描述，如"3分钟�?�?2天后"�? * 使用中文描述，适合中国用户的阅读习惯�? *
+ * @param date 日期（Date 对象、时间戳或日期字符串�? * @param now 当前时间戳（默认 Date.now()�? * @returns 相对时间字符�? *
+ * @example
+ * ```typescript
+ * formatRelativeTime(Date.now() - 30000);     // '30秒前'
+ * formatRelativeTime(Date.now() - 3600000);   // '1小时�?
+ * formatRelativeTime(Date.now() - 86400000);  // '1天前'
+ * formatRelativeTime(Date.now() + 86400000);  // '1天后'
+ * formatRelativeTime(Date.now() - 5000);      // '刚刚'
+ * ```
+ */
+declare function formatRelativeTime(date: Date | number | string, now?: number): string;
+/**
+ * 格式化时�? *
+ * 【功能说明�? * 将毫秒数格式化为时长字符串�? * 支持短格式（1:01:01）和长格式（1小时1分钟1秒）两种风格�? *
+ * @param ms 毫秒�? * @param options 格式选项
+ * @param options.style 格式风格�?short'（默认）�?'long'
+ * @returns 格式化后的时长字符串
+ *
+ * @example
+ * ```typescript
+ * formatDuration(3661000);                    // '1:01:01'
+ * formatDuration(3661000, { style: 'long' }); // '1小时1分钟1�?
+ * formatDuration(65000);                      // '1:05'
+ * formatDuration(90061000);                   // '1d 1:01:01'
+ * ```
+ */
+declare function formatDuration(ms: number, options?: {
+    style?: 'short' | 'long';
+}): string;
+/**
+ * 格式化数字为千分�? *
+ * 【功能说明�? * 将数字格式化为带千分位分隔符的字符串�? * 可指定小数位数�? *
+ * @param num 数字
+ * @param decimals 小数位数（可选）
+ * @returns 格式化后的字符串
+ *
+ * @example
+ * ```typescript
+ * formatNumber(1234567);        // '1,234,567'
+ * formatNumber(1234567.89, 2);  // '1,234,567.89'
+ * formatNumber(1000, 2);        // '1,000.00'
+ * formatNumber(NaN);            // 'NaN'
+ * formatNumber(Infinity);       // '�?
+ * ```
+ */
+declare function formatNumber(num: number, decimals?: number): string;
+/**
+ * 格式化百分比
+ *
+ * 【功能说明�? * 将数值格式化为百分比字符串�? * 支持将比率（0-1）或百分比值转换为显示格式�? *
+ * @param value 数�? * @param decimals 小数位数（默�?2�? * @param asRatio 值是否为比率�?-1），默认 true
+ * @returns 格式化后的百分比字符�? *
+ * @example
+ * ```typescript
+ * formatPercent(0.1234);            // '12.34%'
+ * formatPercent(0.1234, 1);         // '12.3%'
+ * formatPercent(12.34, 2, false);   // '12.34%'
+ * formatPercent(1);                 // '100.00%'
+ * ```
+ */
+declare function formatPercent(value: number, decimals?: number, asRatio?: boolean): string;
+/**
+ * 格式化货�? *
+ * 【功能说明�? * 将金额格式化为货币字符串�? * 使用 Intl.NumberFormat 实现，支持国际化�? *
+ * @param amount 金额
+ * @param currency 货币代码（默�?'CNY'�? * @param locale 地区（默�?'zh-CN'�? * @returns 格式化后的货币字符串
+ *
+ * @example
+ * ```typescript
+ * formatCurrency(1234.56);                   // '¥1,234.56'
+ * formatCurrency(1234.56, 'USD', 'en-US');   // '$1,234.56'
+ * formatCurrency(1234.56, 'EUR', 'de-DE');   // '1.234,56 �?
+ * formatCurrency(1234.56, 'JPY', 'ja-JP');   // '�?,235'
+ * ```
+ */
+declare function formatCurrency(amount: number, currency?: string, locale?: string): string;
+/**
+ * 截断字符�? *
+ * 【功能说明�? * 将超长字符串截断并添加后缀�? * 常用于显示标题、描述等需要限制长度的文本�? *
+ * @param str 原字符串
+ * @param maxLength 最大长�? * @param suffix 截断后缀（默�?'...'�? * @returns 截断后的字符�? *
+ * @example
+ * ```typescript
+ * truncate('这是一段很长的文字', 5);        // '这是...'
+ * truncate('短文�?, 10);                   // '短文�?
+ * truncate('Hello World', 8, '�?);          // 'Hello W�?
+ * ```
+ */
+declare function truncate(str: string, maxLength: number, suffix?: string): string;
+/**
+ * 首字母大�? *
+ * 【功能说明�? * 将字符串的首字母转为大写，其余保持不变�? *
+ * @param str 原字符串
+ * @returns 首字母大写的字符�? *
+ * @example
+ * ```typescript
+ * capitalize('hello');   // 'Hello'
+ * capitalize('WORLD');   // 'WORLD'
+ * capitalize('');        // ''
+ * ```
+ */
+declare function capitalize(str: string): string;
+/**
+ * 驼峰转短横线（kebab-case�? *
+ * 【功能说明�? * 将驼峰命名转换为短横线命名�? * 常用�?CSS 类名、URL 路径等场景�? *
+ * @param str 驼峰命名的字符串
+ * @returns 短横线命名的字符�? *
+ * @example
+ * ```typescript
+ * kebabCase('backgroundColor');  // 'background-color'
+ * kebabCase('myComponent');      // 'my-component'
+ * kebabCase('XMLHttpRequest');   // 'x-m-l-http-request'
+ * ```
+ */
+declare function kebabCase(str: string): string;
+/**
+ * 短横线转驼峰（camelCase�? *
+ * 【功能说明�? * 将短横线命名转换为驼峰命名�? * 常用于将 CSS 属性名转换�?JavaScript 属性名�? *
+ * @param str 短横线命名的字符�? * @returns 驼峰命名的字符串
+ *
+ * @example
+ * ```typescript
+ * camelCase('background-color');   // 'backgroundColor'
+ * camelCase('my-component');       // 'myComponent'
+ * camelCase('font-size');          // 'fontSize'
+ * ```
+ */
+declare function camelCase(str: string): string;
+
+/**
+ * 延迟执行
+ *
+ * 【功能说明�? * 返回一个在指定时间后解决的 Promise�? * 用于 async/await 语法中实现等待效果�? *
+ * @param ms 延迟时间（毫秒）
+ * @returns Promise<void>
+ *
+ * @example
+ * ```typescript
+ * // 基础用法
+ * await delay(1000);
+ * console.log('1秒后执行');
+ *
+ * // 动画间隔
+ * for (const item of items) {
+ *   await fadeIn(item);
+ *   await delay(200);
+ * }
+ * ```
+ */
+declare function delay(ms: number): Promise<void>;
+/**
+ * 带返回值的延迟
+ *
+ * 【功能说明�? * 延迟指定时间后返回指定的值�? * 适用于需要延迟返回特定值的场景�? *
+ * @template T 返回值类�? * @param ms 延迟时间（毫秒）
+ * @param value 返回�? * @returns Promise<T>
+ *
+ * @example
+ * ```typescript
+ * // 延迟返回默认�? * const result = await delayWith(1000, { status: 'ready' });
+ *
+ * // Promise.race 超时降级
+ * const data = await Promise.race([
+ *   fetchData(),
+ *   delayWith(5000, defaultData),
+ * ]);
+ * ```
+ */
+declare function delayWith<T>(ms: number, value: T): Promise<T>;
+/**
+ * 可取消延迟接�? */
+interface CancelableDelay {
+    /** 延迟 Promise */
+    promise: Promise<void>;
+    /** 取消延迟 */
+    cancel: () => void;
+}
+/**
+ * 创建可取消的延迟
+ *
+ * 【功能说明�? * 创建一个可以被手动取消的延迟�? * 适用于需要中断等待的场景，如组件卸载时�? *
+ * @param ms 延迟时间（毫秒）
+ * @returns 可取消的延迟对象
+ *
+ * @example
+ * ```typescript
+ * const { promise, cancel } = cancelableDelay(5000);
+ *
+ * // 设置取消条件
+ * button.onclick = cancel;
+ *
+ * try {
+ *   await promise;
+ *   showMessage('操作完成');
+ * } catch (e) {
+ *   showMessage('操作已取�?);
+ * }
+ * ```
+ */
+declare function cancelableDelay(ms: number): CancelableDelay;
+/**
+ * 带超时的 Promise 包装
+ *
+ * 【功能说明�? * 为任�?Promise 添加超时限制，超时后抛出错误�? * 适用于网络请求、长时间操作等需要超时控制的场景�? *
+ * @template T Promise 解析类型
+ * @param promise 原始 Promise
+ * @param ms 超时时间（毫秒）
+ * @param message 超时错误消息（可选）
+ * @returns Promise<T>
+ * @throws Error 超时时抛出错�? *
+ * @example
+ * ```typescript
+ * // API 请求超时
+ * try {
+ *   const data = await withTimeout(
+ *     fetch('/api/data'),
+ *     5000,
+ *     '请求超时，请检查网�?
+ *   );
+ * } catch (e) {
+ *   if (e.message.includes('超时')) {
+ *     showRetryDialog();
+ *   }
+ * }
+ *
+ * // 文件上传超时
+ * await withTimeout(uploadFile(file), 60000, '上传超时');
+ * ```
+ */
+declare function withTimeout<T>(promise: Promise<T>, ms: number, message?: string): Promise<T>;
+/**
+ * 在下一个宏任务中执�? *
+ * 【功能说明�? * 将函数调度到下一个事件循环执行�? * 类似�?Vue �?nextTick，但更简单�? *
+ * @param fn 要执行的函数
+ *
+ * @example
+ * ```typescript
+ * // 确保 DOM 更新后执�? * element.innerHTML = newContent;
+ * nextTick(() => {
+ *   element.querySelector('.new-element').focus();
+ * });
+ * ```
+ */
+declare function nextTick(fn: () => void): void;
+/**
+ * 请求空闲回调（带降级�? *
+ * 【功能说明�? * 在浏览器空闲时执行任务，支持不兼容浏览器的降级处理�? * 适用于低优先级的后台任务�? *
+ * @param fn 要执行的函数
+ * @param options 配置选项
+ * @param options.timeout 超时时间（毫秒）
+ * @returns 请求 ID
+ *
+ * @example
+ * ```typescript
+ * // 空闲时发送分析数�? * requestIdleCallback(() => {
+ *   sendAnalytics(analyticsData);
+ * }, { timeout: 5000 });
+ *
+ * // 空闲时预加载资源
+ * requestIdleCallback(() => {
+ *   preloadNextPageResources();
+ * });
+ * ```
+ */
+declare function requestIdleCallback(fn: () => void, options?: {
+    timeout?: number;
+}): number;
+
+/**
+ * @file validators.ts
+ * @description 验证工具函数�? * @module @brix-sdk/utils/validators
+ * @version 3.0.0
+ *
+ * 【模块说明�? * 提供各种数据验证工具函数，包括基础格式验证、中国特有证件验证、密码强度检查等�? * 验证函数均返回布尔值，不抛出异常，便于条件判断使用�? *
+ * 【使用场景�? * - 表单验证：邮箱、手机号、密码等
+ * - 证件验证：身份证、统一社会信用代码、银行卡�? * - 数据校验：URL、IP、JSON 格式�? * - 类型检查：空值、数字、范围等
+ *
+ * @license Apache-2.0
+ */
+/**
+ * 验证邮箱格式
+ *
+ * 【功能说明�? * 验证字符串是否为有效的邮箱地址格式�? * 使用 RFC 5322 简化版正则表达式�? *
+ * @param email 邮箱地址
+ * @returns 是否为有效邮箱格�? *
+ * @example
+ * ```typescript
+ * isValidEmail('user@example.com');     // true
+ * isValidEmail('user.name@domain.cn');  // true
+ * isValidEmail('invalid-email');        // false
+ * isValidEmail('user@');                // false
+ * isValidEmail('');                     // false
+ * ```
+ */
+declare function isValidEmail(email: string): boolean;
+/**
+ * 验证中国大陆手机�? *
+ * 【功能说明�? * 验证字符串是否为有效的中国大陆手机号码�? * 支持目前所有运营商号段�?3x�?4x�?5x�?6x�?7x�?8x�?9x）�? *
+ * 【验证规则�? * - 11位数�? * - �?开�? * - 第二位为3-9
+ *
+ * @param phone 手机�? * @returns 是否为有效手机号
+ *
+ * @example
+ * ```typescript
+ * isValidPhone('13800138000');  // true
+ * isValidPhone('19912345678');  // true
+ * isValidPhone('12345678901');  // false（第二位不符合）
+ * isValidPhone('1380013800');   // false（位数不足）
+ * isValidPhone('138 0013 8000'); // false（含空格�? * ```
+ */
+declare function isValidPhone(phone: string): boolean;
+/**
+ * 验证 URL 格式
+ *
+ * 【功能说明�? * 验证字符串是否为有效�?HTTP/HTTPS URL�? * 使用原生 URL API 进行解析验证�? *
+ * @param url URL 字符�? * @returns 是否为有�?URL
+ *
+ * @example
+ * ```typescript
+ * isValidUrl('https://example.com');        // true
+ * isValidUrl('http://example.com/path');    // true
+ * isValidUrl('ftp://example.com');          // false（不支持 FTP�? * isValidUrl('not-a-url');                  // false
+ * isValidUrl('');                           // false
+ * ```
+ */
+declare function isValidUrl(url: string): boolean;
+/**
+ * 验证 IPv4 地址
+ *
+ * 【功能说明�? * 验证字符串是否为有效�?IPv4 地址格式�? *
+ * 【验证规则�? * - 四段数字，用点分�? * - 每段范围 0-255
+ * - 不允许前导零（如 01.02.03.04�? *
+ * @param ip IP 地址字符�? * @returns 是否为有�?IPv4 地址
+ *
+ * @example
+ * ```typescript
+ * isValidIPv4('192.168.1.1');   // true
+ * isValidIPv4('0.0.0.0');       // true
+ * isValidIPv4('255.255.255.255'); // true
+ * isValidIPv4('256.1.1.1');     // false（超出范围）
+ * isValidIPv4('01.02.03.04');   // false（前导零�? * isValidIPv4('192.168.1');     // false（不完整�? * ```
+ */
+declare function isValidIPv4(ip: string): boolean;
+/**
+ * 验证 JSON 字符�? *
+ * 【功能说明�? * 验证字符串是否为有效�?JSON 格式�? *
+ * @param str 待验证字符串
+ * @returns 是否为有�?JSON
+ *
+ * @example
+ * ```typescript
+ * isValidJSON('{"name":"test"}');  // true
+ * isValidJSON('[1, 2, 3]');        // true
+ * isValidJSON('true');             // true
+ * isValidJSON('{invalid}');        // false
+ * isValidJSON('');                 // false
+ * ```
+ */
+declare function isValidJSON(str: string): boolean;
+/**
+ * 验证中国大陆身份证号
+ *
+ * 【功能说明�? * 验证字符串是否为有效的中国大陆居民身份证号�? * 支持18位（新版）和15位（老版）两种格式�? * 18位身份证会进行校验码验证�? *
+ * �?8位身份证结构�? * - �?位：地区�? * - 7-14位：出生日期（YYYYMMDD�? * - 15-17位：顺序码（�?7位奇数为男，偶数为女�? * - �?8位：校验码（0-9 �?X�? *
+ * @param idCard 身份证号
+ * @returns 是否为有效身份证�? *
+ * @example
+ * ```typescript
+ * isValidIdCard('110101199001011234');  // 需验证校验�? * isValidIdCard('110101900101123');     // 15位老版身份�? * isValidIdCard('12345678901234567');   // false（校验码错误�? * isValidIdCard('');                    // false
+ * ```
+ */
+declare function isValidIdCard(idCard: string): boolean;
+/**
+ * 验证中国大陆统一社会信用代码
+ *
+ * 【功能说明�? * 验证字符串是否为有效的统一社会信用代码（企业信用代码）�? *
+ * 【代码结构�? * - �?位：登记管理部门代码�?位）
+ * - �?位：机构类别代码�?位）
+ * - �?-8位：登记管理机关行政区划码（6位数字）
+ * - �?-17位：主体标识码（组织机构代码�? * - �?8位：校验�? *
+ * @param code 统一社会信用代码
+ * @returns 是否为有效代�? *
+ * @example
+ * ```typescript
+ * isValidUnifiedCreditCode('91110000MA0ABCDE12');  // 需验证格式
+ * isValidUnifiedCreditCode('');                    // false
+ * ```
+ */
+declare function isValidUnifiedCreditCode(code: string): boolean;
+/**
+ * 验证中国大陆银行卡号（Luhn算法�? *
+ * 【功能说明�? * 验证字符串是否为有效的银行卡号�? * 使用 Luhn 算法进行校验�? *
+ * 【Luhn 算法�? * 1. 从右向左，偶数位�?，若结果大于9则减9
+ * 2. 所有位数求�? * 3. 能被10整除则有�? *
+ * @param cardNumber 银行卡号
+ * @returns 是否为有效银行卡�? *
+ * @example
+ * ```typescript
+ * isValidBankCard('6222020200010001234');  // 需验证Luhn算法
+ * isValidBankCard('1234 5678 9012 3456');  // 支持带空�? * isValidBankCard('123');                  // false（位数不足）
+ * ```
+ */
+declare function isValidBankCard(cardNumber: string): boolean;
+/**
+ * 密码强度等级
+ */
+type PasswordStrength = 'weak' | 'medium' | 'strong' | 'very-strong';
+/**
+ * 密码强度检查结�? */
+interface PasswordStrengthResult {
+    /** 强度等级 */
+    strength: PasswordStrength;
+    /** 强度分数�?-10�?*/
+    score: number;
+    /** 改进建议列表 */
+    suggestions: string[];
+}
+/**
+ * 检查密码强�? *
+ * 【功能说明�? * 综合评估密码强度，返回强度等级、分数和改进建议�? *
+ * 【评分规则�? * - 长度�?位及以上 +1�?2位及以上 +1�?6位及以上 +1
+ * - 小写字母�?1
+ * - 大写字母�?1
+ * - 数字�?1
+ * - 特殊字符�?2
+ * - 常见模式�?2
+ *
+ * 【强度等级�? * - weak：分�?<= 2
+ * - medium：分�?3-4
+ * - strong：分�?5-6
+ * - very-strong：分�?>= 7
+ *
+ * @param password 密码
+ * @returns 强度检查结�? *
+ * @example
+ * ```typescript
+ * checkPasswordStrength('123456');
+ * // { strength: 'weak', score: 0, suggestions: ['密码长度至少8�?, ...] }
+ *
+ * checkPasswordStrength('MyP@ssw0rd');
+ * // { strength: 'strong', score: 7, suggestions: [] }
+ *
+ * checkPasswordStrength('VeryStr0ng!P@ssw0rd');
+ * // { strength: 'very-strong', score: 9, suggestions: [] }
+ * ```
+ */
+declare function checkPasswordStrength(password: string): PasswordStrengthResult;
+/**
+ * 检查是否为空�? *
+ * 【功能说明�? * 检查值是否为"�?。支持多种类型：
+ * - null/undefined：空
+ * - 字符串：空字符串或纯空白为空
+ * - 数组：空数组为空
+ * - 对象：空对象为空
+ *
+ * @param value 待检查的�? * @returns 是否为空
+ *
+ * @example
+ * ```typescript
+ * isEmpty(null);       // true
+ * isEmpty(undefined);  // true
+ * isEmpty('');         // true
+ * isEmpty('  ');       // true
+ * isEmpty([]);         // true
+ * isEmpty({});         // true
+ * isEmpty(0);          // false
+ * isEmpty(false);      // false
+ * isEmpty('hello');    // false
+ * ```
+ */
+declare function isEmpty(value: unknown): boolean;
+/**
+ * 检查是否为数字
+ *
+ * 【功能说明�? * 检查值是否为有效数字（包括数字类型和可解析的数字字符串）�? * 排除 NaN �?Infinity�? *
+ * @param value 待检查的�? * @returns 是否为有效数�? *
+ * @example
+ * ```typescript
+ * isNumeric(123);      // true
+ * isNumeric('123');    // true
+ * isNumeric('12.34');  // true
+ * isNumeric('-100');   // true
+ * isNumeric(NaN);      // false
+ * isNumeric(Infinity); // false
+ * isNumeric('abc');    // false
+ * isNumeric('');       // false
+ * ```
+ */
+declare function isNumeric(value: unknown): boolean;
+/**
+ * 检查是否为整数
+ *
+ * @param value 待检查的�? * @returns 是否为整�? *
+ * @example
+ * ```typescript
+ * isInteger(123);    // true
+ * isInteger(-100);   // true
+ * isInteger(12.34);  // false
+ * isInteger('123');  // false（需为数字类型）
+ * ```
+ */
+declare function isInteger(value: unknown): boolean;
+/**
+ * 检查是否为正数
+ *
+ * @param value 待检查的数字
+ * @returns 是否为正�? *
+ * @example
+ * ```typescript
+ * isPositive(1);     // true
+ * isPositive(0.001); // true
+ * isPositive(0);     // false
+ * isPositive(-1);    // false
+ * ```
+ */
+declare function isPositive(value: number): boolean;
+/**
+ * 检查是否在范围�? *
+ * @param value 待检查的数字
+ * @param min 最小值（包含�? * @param max 最大值（包含�? * @returns 是否在范围内
+ *
+ * @example
+ * ```typescript
+ * isInRange(5, 1, 10);   // true
+ * isInRange(1, 1, 10);   // true（包含边界）
+ * isInRange(10, 1, 10);  // true（包含边界）
+ * isInRange(0, 1, 10);   // false
+ * isInRange(11, 1, 10);  // false
+ * ```
+ */
+declare function isInRange(value: number, min: number, max: number): boolean;
+
+export { type PasswordStrength, type PasswordStrengthResult, assert, assertNotNull, camelCase, cancelableDelay, capitalize, checkPasswordStrength, debounce, deepClone, deepMerge, delay, delayWith, formatCurrency, formatDate, formatDuration, formatFileSize, formatNumber, formatPercent, formatRelativeTime, isArray, isBoolean, isEmpty, isFunction, isInRange, isInteger, isNotNullOrUndefined, isNullOrUndefined, isNumber, isNumeric, isObject, isPositive, isPromise, isString, isValidBankCard, isValidEmail, isValidIPv4, isValidIdCard, isValidJSON, isValidPhone, isValidUnifiedCreditCode, isValidUrl, kebabCase, nextTick, parseFileSize, requestIdleCallback, throttle, truncate, withTimeout };