/**
 * 覆盖率计算 —— 纯函数，供设置页与审计脚本共用。
 *
 * 动机（2026-09-12 教训）：本插件曾把「数据源没收录某 provider」当成
 * 「该 provider 没有峰谷定价」，于是 `ocg` / `opencode-go` 被静默漏掉。
 * **静默遗漏的根因是「缺少决策」被当成「决策就是不做」。**
 * 因此这里把「哪些 provider/model 命中了、哪些没有」显式算出来给人看。
 */
import { type MatchConfig, type RateProfile } from './matching.js';
/** 模型目录里的一行（只取本模块需要的字段）。 */
export interface CoverageModel {
    id: string;
    name: string;
}
/** 模型目录里的一个 provider 分组。 */
export interface CoverageGroup {
    id: string;
    name: string;
    models: readonly CoverageModel[];
}
/** 单个 provider 的覆盖情况。 */
export interface ProviderCoverage {
    id: string;
    name: string;
    /** 命中的行数。 */
    matched: number;
    /** 未命中的行数。 */
    unmatched: number;
    rows: {
        modelId: string;
        modelName: string;
        /** 命中的 profile 展示名（`providerName · modelLabel`）；未命中为 undefined。 */
        profileLabel?: string;
    }[];
    /** 该 provider 整体未映射时的已知理由（来自 UNMATCHED_BY_DESIGN）。 */
    reason?: string;
    /** 该 provider 是否在别名表里有映射（与具体模型是否命中无关）。 */
    knownProvider: boolean;
}
/** 整份覆盖报告。 */
export interface CoverageReport {
    providers: ProviderCoverage[];
    matchedTotal: number;
    unmatchedTotal: number;
    /** 存在未命中项的 provider 数（设置页据此给提示）。 */
    providersWithGaps: number;
}
/**
 * 计算当前配置下的覆盖率报告。
 *
 * @param groups - 来自共享模型目录的 provider 分组。
 * @param profiles - 可用 profile 列表。
 * @param aliases - 生效的 provider 别名表（含内置与用户覆盖）。
 * @param config - 匹配配置（别名/映射覆盖）。
 * @returns 逐 provider 的覆盖情况与合计。
 */
export declare function buildCoverage(groups: readonly CoverageGroup[], profiles: readonly RateProfile[], aliases: Record<string, string>, config?: MatchConfig): CoverageReport;
/**
 * 挑出「**可能漏配**」的 provider —— 即完全没有任何模型命中的 provider。
 *
 * 这是唯一值得提醒的情况：部分命中是正常的（同一 provider 下混有非峰谷计价的模型），
 * 而**整组都不命中**才可能是映射缺失或 endpoint 未被识别。
 *
 * @param report - 覆盖率报告。
 * @returns 可疑 provider（已排除在 UNMATCHED_BY_DESIGN 里写明理由的）。
 */
export declare function suspiciousProviders(report: CoverageReport): ProviderCoverage[];