import { UI18nConfig, TranslationResult, SupportedLanguage } from './types'; import { CacheStats } from './cache-manager'; import { DualAPIConfig } from './api-config'; import { SEOHelper } from './seo-helper'; /** * UI18n 核心类 * 提供完整的国际化翻译功能 * * ✨ 新增:内置SEO支持 - "开发者惊喜体验" */ export declare class UI18n { private config; private cacheManager; private aiTranslator?; private currentLanguage; private serviceModeManager; private translationPipeline; private versionControlManager?; private fallbackManager?; private optimizedCache?; private secureConfigManager?; private logger; private batchOptimizer?; private translationQueue?; seo: SEOHelper; private _messages; private _fallbackLanguage?; constructor(config?: UI18nConfig); /** * 翻译文本 * @param text 要翻译的文本 * @param targetLanguage 目标语言(可选,默认使用当前语言) * @param options 翻译选项 * @returns 翻译结果 */ translate(text: string, targetLanguage?: SupportedLanguage, options?: { context?: string; forceAI?: boolean; skipCache?: boolean; priority?: 'low' | 'normal' | 'high' | 'urgent'; useBatch?: boolean; }): Promise; /** * 异步翻译方法(高级功能,使用AI翻译管道) * @param text 要翻译的文本 * @param options 选项 * @returns 翻译后的文本 */ tAsync(text: string, languageOrOptions?: SupportedLanguage | { language?: SupportedLanguage; context?: string; }): Promise; /** * 批量翻译 * @param texts 要翻译的文本数组 * @param targetLanguage 目标语言 * @param options 选项 * @returns 翻译结果数组 */ translateBatch(texts: string[], targetLanguage?: SupportedLanguage, options?: { context?: string; maxConcurrency?: number; useOptimizer?: boolean; priority?: 'low' | 'normal' | 'high'; }): Promise; /** * 兼容 CLI 的批量翻译映射接口 * @param texts 文本数组 * @param targetLanguage 目标语言 * @returns Record<原文, 译文> */ tBatch(texts: string[], targetLanguage?: SupportedLanguage): Promise>; /** * 设置当前语言 * @param language 语言代码 */ setLanguage(language: SupportedLanguage): void; /** * 获取当前语言 * @returns 当前语言代码 */ getCurrentLanguage(): SupportedLanguage; /** * 批量添加字典 * @param dicts 字典映射对象 */ addAll(dicts: Record>): void; /** * 添加翻译字典 - 核心API * @param lang 语言代码 * @param dict 字典对象 */ addTranslations(lang: string, dict: Record): void; /** * 装载翻译字典 - addTranslations的别名 * @param lang 语言代码 * @param dict 字典对象 */ loadTranslations(lang: string, dict: Record): void; /** * 同步翻译方法 - 标准t方法签名 (RC.3 核心功能) * @param key 翻译键 * @param params 插值参数 * @param opts 选项 (to: 目标语言) * @returns 翻译结果 */ t(key: string, params?: Record, opts?: { to?: string; }): string; /** * 内部查找方法 * @param lang 语言代码 * @param key 翻译键 * @returns 翻译值或undefined */ private _lookup; /** * 字符串插值 - 支持 {{key}} 格式 * @param str 模板字符串 * @param params 参数对象 * @returns 插值后的字符串 */ private _interpolate; /** * 自动检测并设置系统语言 */ detectAndSetSystemLanguage(): void; /** * 获取支持的语言列表 * @returns 支持的语言数组 */ getSupportedLanguages(): SupportedLanguage[]; /** * 获取内置词典统计信息 */ getBuiltinStats(): { totalKeys: number; supportedLanguages: SupportedLanguage[]; coverage: Record; }; /** * 获取缓存统计信息 */ getCacheStats(): CacheStats; /** * 清除缓存 * @param pattern 可选的匹配模式 */ clearCache(pattern?: string): Promise; /** * 清理过期缓存 */ cleanupCache(): Promise; /** * 预热常用词汇 * @param language 目标语言 * @returns 预热的词汇数量 */ preloadCommonTerms(language: SupportedLanguage): Promise; /** * 搜索翻译 * @param query 搜索关键词 * @param language 搜索语言 * @returns 匹配的翻译结果 */ searchTranslations(query: string, language?: SupportedLanguage): import("./types").TranslationSearchResult[]; /** * 验证AI配置 * @returns 配置是否有效 */ validateAIConfig(): Promise; /** * 估算翻译成本 * @param text 要翻译的文本 * @returns 估算成本(美元) */ estimateTranslationCost(text: string): number; /** * 获取语言显示名称 * @param language 语言代码 * @param displayLanguage 显示语言 * @returns 语言显示名称 */ getLanguageDisplayName(language: SupportedLanguage, displayLanguage?: SupportedLanguage): string; /** * 调试日志 */ private log; /** * 切换服务模式 * @param mode 服务模式 */ switchServiceMode(mode: 'self-hosted' | 'cloud' | 'hybrid'): Promise; /** * 获取当前服务模式 */ getCurrentServiceMode(): 'self-hosted' | 'cloud' | 'hybrid'; /** * 获取服务模式统计 */ getServiceModeStats(): import("./service-mode").ServiceModeStats; /** * 获取翻译管道统计 */ getTranslationPipelineStats(): import("./translation-pipeline").PipelineStats; /** * 获取版本控制统计(如果启用) */ getVersionControlStats(): import("./version-control").VersionControlStats; /** * 同步语言包(如果启用版本控制) */ syncLanguagePack(language: SupportedLanguage): Promise; /** * 同步所有语言包(如果启用版本控制) */ syncAllLanguagePacks(): Promise>; /** * 检查语言包更新(如果启用版本控制) */ checkForUpdates(): Promise>; /** * 回滚到指定版本(如果启用版本控制) */ rollbackToVersion(language: SupportedLanguage, version: string): Promise; /** * 获取版本历史(如果启用版本控制) */ getVersionHistory(language: SupportedLanguage): import("./version-control").LanguageVersion[]; /** * 获取批量优化器统计(如果启用) */ getBatchOptimizerStats(): any; /** * 获取批量优化器队列状态(如果启用) */ getBatchOptimizerQueueStatus(): { currentOptimalBatchSize: number; pendingBatches: number; activeBatches: number; mergingBuffer: number; totalRequests: number; batchedRequests: number; mergedRequests: number; costSavings: number; averageBatchSize: number; batchingEfficiency: number; }; /** * 获取成本统计(如果启用批量优化器) */ getCostStats(): { totalRequests: number; batchedRequests: number; mergedRequests: number; costSavings: number; batchingEfficiency: number; }; /** * 暂停批量处理(如果启用批量优化器) */ pauseBatchProcessing(): void; /** * 恢复批量处理(如果启用批量优化器) */ resumeBatchProcessing(): void; /** * 清空批量处理队列(如果启用批量优化器) */ clearBatchQueue(): void; /** * 获取完整的系统状态 */ getSystemStatus(): { currentLanguage: string; serviceMode: "hybrid" | "self-hosted" | "cloud"; serviceModeStats: import("./service-mode").ServiceModeStats; cacheStats: CacheStats; builtinStats: { totalKeys: number; supportedLanguages: SupportedLanguage[]; coverage: Record; }; translationPipelineStats: import("./translation-pipeline").PipelineStats; versionControlStats: import("./version-control").VersionControlStats; supportedLanguages: string[]; }; /** * 销毁实例,清理资源 */ destroy(): void; /** * 初始化智能回退管理器 */ private initializeFallbackManager; /** * 初始化批量优化器 */ private initializeBatchOptimizer; /** * 🎉 初始化SEO Helper - 开发者惊喜功能 * * 为开发者提供零配置的多语言SEO支持,包括: * - hreflang标签生成 * - 语言代码标准化 * - SEO最佳实践建议 * - 多语言URL支持 */ private initializeSEOHelper; private buildFallbackOrder; /** * 注册翻译提供者 */ private registerProviders; /** * 使用智能回退机制进行翻译 */ translateWithFallback(text: string, targetLanguage?: SupportedLanguage, options?: { context?: string; forceAPI?: 'aiProvider' | 'cloudService'; skipCache?: boolean; priority?: 'low' | 'normal' | 'high'; }): Promise; /** * 映射回退源到翻译结果源 */ private mapFallbackSourceToTranslationSource; /** * 获取回退管理器的健康状态 */ getFallbackHealth(): Promise | null>; /** * 重置指定提供者的熔断器 */ resetProviderCircuitBreaker(providerName: string): void; /** * 获取回退统计信息 */ getFallbackStats(): any; /** * 保存安全配置到加密文件 */ saveSecureConfig(config: Partial): boolean; /** * 加载安全配置 */ loadSecureConfig(): Partial | null; /** * 验证配置文件完整性 */ validateSecureConfig(): { valid: boolean; errors: string[]; }; /** * 轮转加密密钥 */ rotateEncryptionKey(newKey?: string): boolean; /** * 删除安全配置文件 */ deleteSecureConfig(): boolean; /** * 获取安全配置状态 */ getSecureConfigStatus(): { initialized: boolean; hasSecureFile: boolean; validationResult?: { valid: boolean; errors: string[]; }; }; /** * 加载持久化翻译(React兼容性方法) */ loadPersistedTranslation(language: SupportedLanguage): Promise; /** * 检测文本语言(React兼容性方法) */ detectLanguage(text: string): SupportedLanguage; /** * 获取可用语言列表(React兼容性方法) */ getAvailableLanguages(): Promise; /** * 获取系统统计信息(React兼容性方法) */ getStats(): { currentLanguage: string; serviceMode: "hybrid" | "self-hosted" | "cloud"; serviceModeStats: import("./service-mode").ServiceModeStats; cacheStats: CacheStats; builtinStats: { totalKeys: number; supportedLanguages: SupportedLanguage[]; coverage: Record; }; translationPipelineStats: import("./translation-pipeline").PipelineStats; versionControlStats: import("./version-control").VersionControlStats; supportedLanguages: string[]; }; /** * 获取适配器信息(React兼容性方法) */ getAdapterInfo(): { platform: string; hasVersionControl: boolean; hasSecureConfig: boolean; hasBatchOptimizer: boolean; serviceMode: "hybrid" | "self-hosted" | "cloud"; cacheEnabled: boolean; aiEnabled: boolean; systemStats: { currentLanguage: string; serviceMode: "hybrid" | "self-hosted" | "cloud"; serviceModeStats: import("./service-mode").ServiceModeStats; cacheStats: CacheStats; builtinStats: { totalKeys: number; supportedLanguages: SupportedLanguage[]; coverage: Record; }; translationPipelineStats: import("./translation-pipeline").PipelineStats; versionControlStats: import("./version-control").VersionControlStats; supportedLanguages: string[]; }; }; } /** * 创建UI18n实例的工厂函数 * @param config 配置选项(可选) * @returns UI18n实例 */ export declare function createUI18n(config?: UI18nConfig): UI18n; //# sourceMappingURL=ui18n.d.ts.map