/**
 * 回测指标库（纯函数、零依赖）。
 *
 * 指标系统设计：所有回测指标统一计算 + 统一目录（METRIC_CATALOG），
 * UI 渲染时按目录勾选显示。必有指标：totalReturn / maxDrawdown / sharpe；
 * 可选指标持续扩展（calmar / sortino / winRate / ic / icir / turnover …）。
 */
export interface EquityMetrics {
    totalReturnPct: number;
    maxDrawdownPct: number;
    sharpe: number;
    /** 年化波动率 % */
    annualizedVol: number;
    /** Calmar = 年化收益 / 最大回撤 */
    calmar: number;
    /** Sortino = 年化收益 / 下行波动 */
    sortino: number;
    /** 正收益期占比 % */
    winRate: number;
    /** 总盈利 / 总亏损（>1 盈利；无亏损时为 null） */
    profitFactor: number | null;
    /** 平均每期收益 % */
    avgPeriodReturnPct: number;
    /** 收益期数 / 总期数 */
    positivePeriods: number;
    periods: number;
}
/** 从净值曲线计算全套指标。 */
export declare function equityMetrics(equityCurve: readonly number[]): EquityMetrics;
export interface TradeMetrics {
    tradeCount: number;
    winRate: number;
    avgReturnPct: number;
    profitFactor: number | null;
    avgHoldingPeriods: number;
}
/** 从交易列表计算交易级指标。 */
export declare function tradeMetrics(trades: readonly {
    entryIndex: number;
    exitIndex: number | null;
    returnPct: number | null;
}[]): TradeMetrics;
export interface MetricDef {
    key: string;
    name: string;
    /** 简短中文名 */
    nameZh: string;
    /** 格式化函数 */
    format: (v: number) => string;
    /** 是否必有（UI 始终显示） */
    required: boolean;
}
/** 指标目录（UI 按此渲染选择器；欢迎 PR 扩展）。 */
export declare const METRIC_CATALOG: MetricDef[];