import { RiskMetricsOptions } from '../schemas/RiskMetricsOptionsSchema';
import { RiskMetricsResult } from '../schemas/RiskMetricsResultSchema';
/**
 * Calculate Risk Metrics (Beta, Correlation, Downside Deviation)
 *
 * Calculates comprehensive risk metrics for portfolio analysis:
 *
 * 1. Beta: Measures systematic risk relative to benchmark
 *    Formula: β = Cov(Asset, Benchmark) / Var(Benchmark)
 *
 * 2. Correlation Matrix: Measures relationships between assets
 *    Formula: ρ = Cov(Asset1, Asset2) / (σ1 × σ2)
 *
 * 3. Downside Deviation: Measures volatility of negative returns
 *    Formula: DD = √(Σ(min(r_i, 0))² / n) × √(annualization_factor)
 *
 * @param options - Asset returns, benchmark returns, and calculation parameters
 * @returns Risk metrics including beta, correlation, and downside deviation
 *
 * @example
 * ```typescript
 * const riskMetrics = calculateRiskMetrics({
 *   assetReturns: [
 *     [0.05, 0.03, 0.07, 0.02], // Asset 1 returns
 *     [0.04, 0.02, 0.06, 0.01], // Asset 2 returns
 *     [0.06, 0.04, 0.08, 0.03]  // Asset 3 returns
 *   ],
 *   benchmarkReturns: [0.04, 0.03, 0.06, 0.02],
 *   riskFreeRate: 0.02,
 *   annualizationFactor: 252
 * });
 * ```
 */
export declare function calculateRiskMetrics(options: RiskMetricsOptions): RiskMetricsResult;