/**
 * Formatting utilities for QuantRisk MCP.
 * These functions convert raw numeric results into display-ready strings
 * suitable for inclusion in tool `summary` fields.
 *
 * None of these functions throw — they return a fallback string on bad input.
 */
/**
 * Format a dollar amount with thousands separators and two decimal places.
 * Handles negative values (shown with a leading minus, not parentheses).
 *
 * @example
 *   formatCurrency(1234567.89)  // "$1,234,567.89"
 *   formatCurrency(-5000)       // "-$5,000.00"
 *   formatCurrency(0.5)         // "$0.50"
 */
export declare function formatCurrency(n: number): string;
/**
 * Format a decimal fraction as a percentage string.
 * The input is a decimal (0.1234 = 12.34%). `decimals` controls
 * the number of digits after the decimal point (default 2).
 *
 * @example
 *   formatPercent(0.1234)      // "12.34%"
 *   formatPercent(-0.05, 1)   // "-5.0%"
 *   formatPercent(1.5, 0)     // "150%"
 */
export declare function formatPercent(n: number, decimals?: number): string;
/**
 * Format a plain number with optional decimal precision and thousands separators.
 * Defaults to 4 decimal places — appropriate for ratios and factors.
 *
 * @example
 *   formatNumber(1234567.89123, 2)  // "1,234,567.89"
 *   formatNumber(0.8532, 4)         // "0.8532"
 *   formatNumber(-1.23456789, 6)    // "-1.234568"
 */
export declare function formatNumber(n: number, decimals?: number): string;
/**
 * Format a ratio (Sharpe, Sortino, etc.) — 2 decimal places, no units.
 */
export declare function formatRatio(n: number): string;
/**
 * Produce a sign-aware description of a P&L change.
 * Returns e.g. "gained $1,234.56 (+2.34%)" or "lost $5,000.00 (-4.12%)".
 */
export declare function formatPnlDescription(dollarPnl: number, pctPnl: number): string;
/**
 * Compact number abbreviation for large values in summary prose.
 * Renders millions as "M" and billions as "B".
 *
 * @example
 *   formatCompact(1_250_000)     // "$1.25M"
 *   formatCompact(3_400_000_000) // "$3.40B"
 *   formatCompact(450_000)       // "$450,000"
 */
export declare function formatCompact(n: number): string;
//# sourceMappingURL=format.d.ts.map