@alauda-fe/common 1.4.29-beta.1 → 1.4.29

package/translate/translate.service.d.ts

@@ -46,25 +46,21 @@ export declare class TranslateService implements OnDestroy {
     ngOnDestroy(): void;
     /**
      * 获取翻译文本并进行模板插值
-     * 自动将传统 {{ key }} 语法转换为 ICU {key} 格式进行解析
-     * 同时支持原生 ICU Message Format 语法
+     * 支持两种模板语法：
+     * 1. 传统的 {{ key }} 语法，使用 lodash template 处理
+     * 2. ICU Message Format 语法，使用 IntlMessageFormat 处理
      * @param key - 翻译键或翻译对象
      * @param data - 模板数据（支持基本类型、Date、对象和数组）
      * @returns 翻译后的文本
      *
      * @example
      * ```typescript
-     * // 对象参数（推荐）
-     * translate.get('hello', { name: 'World' }) // 模板: "Hello {name}"
+     * // lodash template 语法
+     * translate.get('hello', { name: 'World' }) // 模板: "Hello {{ name }}"
      *
-     * // 基本类型参数（自动转换为 {value}）
-     * translate.get('welcome', 'John') // 模板: "Welcome {value}"
-     *
-     * // ICU 格式（数字）
-     * translate.get('itemCount', { count: 5 })
-     *
-     * // ICU 格式（日期，默认本地化）
-     * translate.get('createdAt', { date: new Date() })
+     * // ICU Message Format 语法
+     * translate.get('itemCount', { count: 5 }) // 模板: "Items: {count, number}"
+     * translate.get('createdAt', { date: new Date() }) // 模板: "Created: {date, date, short}"
      * ```
      */
     get(key: TranslateKey, data?: TemplateData): string;
@@ -118,11 +114,7 @@ export declare class TranslateService implements OnDestroy {
      * @param data - 模板数据
      * @returns ICU 兼容的数据对象
      */
-    private normalizeAndConvertToIcuData;
-    /**
-     * 检查是否为纯模板对象（不是数组、Date等特殊对象）
-     */
-    private isPlainTemplateObject;
+    private normalizeIcuData;
     /**
      * 转换对象的所有属性为 ICU 兼容值
      */
@@ -137,12 +129,18 @@ export declare class TranslateService implements OnDestroy {
      */
     private handleTemplateError;
     /**
-     * 将传统的 {{ key }} 语法转换为 ICU {key} 格式
-     * 同时保持已有的 ICU 格式不变
-     * @param message - 原始消息模板
-     * @returns 转换后的 ICU 格式消息
+     * 使用 lodash template 格式化文本
+     * @param message - 包含 {{ }} 语法的模板字符串
+     * @param data - 模板数据
+     * @returns 格式化后的字符串
      */
-    private convertToIcuFormat;
+    private formatLodashTemplate;
+    /**
+     * 标准化模板数据为对象格式
+     * @param data - 原始模板数据
+     * @returns 标准化后的对象或数组（为了向后兼容）
+     */
+    private normalizeTemplateData;
     /**
      * 使用 ICU message format 格式化文本
      */
@@ -238,14 +236,6 @@ export declare class TranslateService implements OnDestroy {
      * 使用标准 Intl.DateTimeFormatOptions 确保格式可预测性
      */
     private formatDateByOptions;
-    /**
-     * 通过字符串键获取翻译
-     */
-    private getTranslationByKey;
-    /**
-     * 通过翻译对象获取翻译值
-     */
-    private getTranslationByObject;
     /**
      * 处理无效语言环境
      */
@@ -262,10 +252,6 @@ export declare class TranslateService implements OnDestroy {
      * 标准化远程URL
      */
     private normalizeRemoteUrl;
-    /**
-     * 清理URL（移除hash片段）
-     */
-    private cleanUrl;
     /**
      * 验证远程URL（开发模式）
      */
@@ -291,36 +277,25 @@ export declare class TranslateService implements OnDestroy {
      */
     private validateFetchTranslationParams;
     /**
-     * 解析翻译文本
-     */
-    private resolveTranslation;
-    /**
-     * 在翻译列表中搜索
-     */
-    private searchInTranslationsList;
-    /**
-     * 在单个翻译对象中搜索
+     * 通过键查找翻译文本
      */
-    private searchInTranslations;
+    private getTranslationByKey;
     /**
-     * 从翻译源获取翻译值，支持扁平和嵌套两种结构
-     * @param source - 翻译源对象
-     * @param key - 翻译键（如 'a.b.c'）
-     * @returns 翻译值或undefined
+     * 在所有翻译源中查找键值
      */
-    private getTranslationFromSource;
+    private findInAllTranslations;
     /**
-     * 获取指定语言的翻译值（处理loose模式和fallback逻辑）
+     * 在翻译列表中查找键值
      */
-    private getTranslationValue;
+    private findInTranslationsList;
     /**
-     * 宽松模式下获取翻译值
+     * 在单个翻译对象中查找键值
      */
-    private getLooseTranslationValue;
+    private findInTranslation;
     /**
-     * 提取宽松语言代码（如：zh-CN -> zh）
+     * 从Translation对象中获取翻译值（支持宽松匹配和回退逻辑）
      */
-    private extractLooseLocale;
+    private getTranslationByObject;
     /**
      * 验证翻译值（开发模式）
      */