/** * 支持的语言类型 */ export type SupportedLanguage = 'zh-CN' | 'en-US'; /** * 语言检测选项 */ export interface LanguageDetectionOptions { /** 命令行指定的语言参数 */ cliLanguage?: string; /** 项目根目录路径 */ projectPath?: string; /** 是否启用环境变量检测 */ enableEnvDetection?: boolean; } /** * 语言检测结果 */ export interface LanguageDetectionResult { /** 检测到的语言 */ language: SupportedLanguage; /** 检测来源 */ source: 'cli' | 'file' | 'environment' | 'default'; /** 检测详情 */ details?: string; } /** * 语言检测工具类 * * 按以下优先级检测项目语言: * 1. 命令行参数(最高优先级) * 2. 现有文件内容推断 * 3. 环境变量检测 * 4. 默认回退(英文) */ export declare class LanguageDetector { /** * 检测项目语言 * * @param options 检测选项 * @returns 语言检测结果 */ static detectLanguage(options?: LanguageDetectionOptions): LanguageDetectionResult; /** * 标准化语言代码 * 支持多种格式转换为标准格式 * * @param languageCode 输入的语言代码 * @returns 标准化的语言代码,如果不支持则返回 null */ static normalizeLanguageCode(languageCode: string): SupportedLanguage | null; /** * 从现有文件内容推断语言 * 使用 franc 库检测文件内容的语言 * * @param projectPath 项目根目录路径 * @returns 检测到的语言,如果无法确定则返回 null */ static detectFromFile(projectPath: string): SupportedLanguage | null; /** * 从环境变量检测语言 * 检查 LANG 环境变量 * * @returns 检测到的语言,如果无法确定则返回 null */ static detectFromEnvironment(): SupportedLanguage | null; /** * 检测文本是否包含中文字符 * 作为 franc 库的补充,用于处理混合语言或检测失败的情况 * * @param text 要检测的文本 * @returns 是否包含中文字符 */ static containsChinese(text: string): boolean; /** * 获取支持的语言列表 * * @returns 支持的语言代码数组 */ static getSupportedLanguages(): SupportedLanguage[]; /** * 检查语言代码是否受支持 * * @param languageCode 语言代码 * @returns 是否受支持 */ static isLanguageSupported(languageCode: string): boolean; } //# sourceMappingURL=language-detector.d.ts.map