/**
 * Excel 提取（含内嵌图片）— v8.3.207+
 *
 * 用 exceljs（可选依赖）读取 xlsx，同时提取：
 * 1. 单元格文本（每行一个 bug 的描述）
 * 2. 内嵌图片（按 range.tl.nativeRow 关联到对应的 bug 行）
 *
 * 供「bug Excel 表导入」场景使用：描述 + 截图一起进任务上下文，宿主 AI 能 Read 图片看到缺陷。
 * exceljs 未安装时返回 null，调用方回退到纯文本解析（xlsx 库）。
 */
export interface ExcelImage {
    /** 图片关联的行号（0-based，含表头行） */
    rowIndex: number;
    /** 图片扩展名（png/jpeg/gif） */
    ext: string;
    /** 图片二进制数据 */
    buffer: Buffer;
}
export interface ExcelBugRow {
    /** 行号（0-based） */
    rowIndex: number;
    /** 该行所有单元格文本（已过滤空串） */
    cells: string[];
    /** 该行关联的图片 */
    images: ExcelImage[];
    /** 优先级列（若表头识别到） */
    priority?: string;
    /** 严重度列（若表头识别到） */
    severity?: string;
    /** 模块列（若表头识别到，可喂给 .meta/feature 关联功能模块） */
    module?: string;
    /** 标题列（若表头识别到，作为任务名；v8.3.288+ 消费，此前识别后未用） */
    title?: string;
    /** 描述列（若表头识别到，作为任务描述主体；v8.3.288+） */
    desc?: string;
    /** 涉及端列（若表头识别到，「所有端」/「api,web」） */
    platforms?: string;
    /** Bug 编号列（若表头识别到；留空则导入时自动生成 YYYYMMDD-XXXX） */
    bugId?: string;
    /** 提出人列（若表头识别到，区别于负责人=处理人） */
    reporter?: string;
    /** 负责人列（若表头识别到，作为任务处理人写入 .meta/owner） */
    owner?: string;
}
/**
 * 提取 Excel 的 bug 行（文本 + 内嵌图片 + 优先级/严重度/模块列）
 * @param filePath xlsx 文件路径
 * @returns bug 行数组；exceljs 不可用或解析失败时返回 null
 */
export declare function extractExcelBugs(filePath: string): Promise<ExcelBugRow[] | null>;
/**
 * 纯文本回退：用 exceljs 读 Excel，只拿单元格文本（无图片）
 * 供结构化解析失败时的降级路径
 * （v8.3.288 前用 xlsx 库，但 xlsx 从未进入 package.json，回退链实际是断的——
 *  exceljs 缺失时这里也必然失败；统一改为 exceljs）
 */
export declare function extractExcelTextOnly(filePath: string): Promise<string[] | null>;
//# sourceMappingURL=excel-extract.d.ts.map