import type { FormatOptions } from '../types';
/**
 * 格式化指标数值
 *
 * 支持以下格式化选项：
 * - 小数精度控制
 * - 千分位分隔符
 * - 货币符号显示
 * - 自定义格式化函数
 * - 整数时隐藏小数部分
 *
 * @param value 数值
 * @param options 格式化选项
 * @returns 格式化后的字符串，null 时返回 null
 *
 * @example
 * formatMetricValue(1234.56, { precision: 2, useGrouping: true })
 * // 返回: "1,234.56"
 *
 * @example
 * formatMetricValue(1580, {
 *   showCurrencySymbol: true,
 *   currencySymbol: '$'
 * })
 * // 返回: "$1580"
 *
 * @example
 * formatMetricValue(100.00, {
 *   precision: 2,
 *   hideDecimalForWholeNumbers: true
 * })
 * // 返回: "100"
 */
export declare function formatMetricValue(value: number | string | null | undefined, options?: FormatOptions): string | null;
