/**
 * @file 字符串处理工具函数
 */
/**
 * 检查字符串是否为 null、undefined、空字符串或仅包含空白字符。
 * @param str - 要检查的字符串。
 * @returns 如果字符串为空或仅包含空白，则返回 true，否则返回 false。
 * @example
 * isEmpty(null); // true
 * isEmpty(''); // true
 * isEmpty('  '); // true
 * isEmpty('hello'); // false
 */
export declare function isEmpty(str: string | null | undefined): boolean;
/**
 * 检查字符串是否非空（包含至少一个非空白字符）。
 * 这是 `isEmpty` 的反函数。
 * @param str - 要检查的字符串。
 * @returns 如果字符串包含非空白字符，则返回 true，否则返回 false。
 */
export declare function isNotEmpty(str: string | null | undefined): boolean;
/**
 * 将文件大小（字节）格式化为更易读的字符串。
 * @param bytes - 文件大小，单位为字节。
 * @param decimals - 保留的小数位数，默认为 2。
 * @returns 格式化后的大小字符串，如 "1.23 MB"。
 */
export declare function formatSize(bytes: number, decimals?: number): string;
/**
 * 生成指定长度的随机字符串（仅包含大小写字母和数字）。
 * @warning 此函数生成的字符串**不具有密码学安全性**，请勿用于密码、令牌等敏感场景。
 * @param length - 期望的字符串长度。
 * @returns 生成的随机字符串。
 */
export declare function randomString(length: number): string;
/**
 * 截断长字符串以便于显示，并在末尾添加省略号。
 * @param str - 要截断的原始字符串。
 * @param length - 目标最大长度（不含省略号），默认为 80。
 * @returns 截断后的字符串。
 */
export declare const truncate: (str: string, length?: number) => string;
/**
 * 将任何类型的对象安全地转换为字符串。
 * 如果输入是字符串，则直接返回；否则，使用 JSON.stringify 进行转换。
 * @param obj - 要转换的对象。
 * @param fallback - 当 JSON.stringify 失败时（例如循环引用）返回的备用值。
 * @returns 转换后的字符串。
 */
export declare function stringify(obj: any, space?: number, fallback?: string): string;
/**
 * 移除字符串开头的空白字符。
 * @param text - 输入字符串。
 * @returns 移除开头空白后的字符串。
 */
export declare function trimStart(text: string): string;
/**
 * 移除字符串末尾的空白字符。
 * @param text - 输入字符串。
 * @returns 移除末尾空白后的字符串。
 */
export declare function trimEnd(text: string): string;
/**
 * 移除字符串首尾的空白字符。
 * @param text - 输入字符串。
 * @returns 移除首尾空白后的字符串。
 */
export declare function trim(text: string): string;
/**
 * 生成字符串的简单哈希值（32位整数的 base-36 表示）。
 * @warning 此哈希函数非常简单，**不具有密码学安全性**，仅适用于非安全场景，如数据分桶、生成唯一键等。
 * @param str - 输入字符串。
 * @returns 一个简短的哈希字符串。
 */
export declare function hashString(str: string): string;
/**
 * 将字符串的第一个字符转换为大写。
 * @param str - 输入字符串。
 * @returns 首字母大写的字符串。
 */
export declare function capitalize(str: string): string;
/**
 * 将字符串转换为驼峰命名（camelCase）。
 * @param str - 输入字符串 (e.g., 'hello-world' or 'hello_world')。
 * @returns 驼峰命名格式的字符串。
 */
export declare function toCamelCase(str: string): string;
/**
 * 将字符串转换为蛇形命名（snake_case）。
 * @param str - 输入字符串 (e.g., 'helloWorld' or 'hello-world')。
 * @returns 蛇形命名格式的字符串。
 */
export declare function toSnakeCase(str: string): string;
/**
 * 将字符串转换为烤串命名（kebab-case）。
 * @param str - 输入字符串 (e.g., 'helloWorld' or 'hello_world')。
 * @returns 烤串命名格式的字符串。
 */
export declare function toKebabCase(str: string): string;