@alauda-fe/common 1.4.28-beta.5 → 1.4.28

package/translate/intl-format.pipes.d.ts

@@ -0,0 +1,122 @@
+/**
+ * @packageDocumentation
+ * @module translate
+ */
+import { ChangeDetectorRef, OnDestroy, PipeTransform } from '@angular/core';
+import { Subject } from 'rxjs';
+import { TranslateService } from './translate.service';
+import * as i0 from "@angular/core";
+/**
+ * 基础国际化格式化 Pipe 抽象类
+ * 提供响应式的 locale 变化监听功能
+ */
+declare abstract class BaseIntlPipe implements PipeTransform, OnDestroy {
+    protected readonly destroy$$: Subject<void>;
+    protected readonly cdr: ChangeDetectorRef;
+    protected readonly translate: TranslateService;
+    constructor();
+    ngOnDestroy(): void;
+    abstract transform(value: any, ...args: any[]): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BaseIntlPipe, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<BaseIntlPipe>;
+}
+/**
+ * 数字格式化 Pipe
+ * @example
+ * {{ 1234.56 | aclIntlNumber }} // "1,234.56"
+ * {{ 0.85 | aclIntlNumber:{ style: 'percent' } }} // "85%"
+ * {{ 1234.56 | aclIntlNumber:{ minimumFractionDigits: 2 } }} // "1,234.56"
+ */
+export declare class IntlNumberPipe extends BaseIntlPipe implements PipeTransform {
+    transform(value: number, options?: Intl.NumberFormatOptions): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IntlNumberPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<IntlNumberPipe, "aclIntlNumber", true>;
+}
+/**
+ * 货币格式化 Pipe
+ * @example
+ * {{ 1234.56 | aclIntlCurrency }} // "¥1,234.56"
+ * {{ 1234.56 | aclIntlCurrency:'USD' }} // "$1,234.56"
+ * {{ 1234.56 | aclIntlCurrency:'EUR':{ minimumFractionDigits: 2 } }} // "€1,234.56"
+ */
+export declare class IntlCurrencyPipe extends BaseIntlPipe implements PipeTransform {
+    transform(value: number, currency?: string, options?: Intl.NumberFormatOptions): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IntlCurrencyPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<IntlCurrencyPipe, "aclIntlCurrency", true>;
+}
+/**
+ * 百分比格式化 Pipe
+ * @example
+ * {{ 0.85 | aclIntlPercent }} // "85%"
+ * {{ 0.8567 | aclIntlPercent:{ minimumFractionDigits: 2 } }} // "85.67%"
+ */
+export declare class IntlPercentPipe extends BaseIntlPipe implements PipeTransform {
+    transform(value: number, options?: Omit<Intl.NumberFormatOptions, 'style'>): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IntlPercentPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<IntlPercentPipe, "aclIntlPercent", true>;
+}
+/**
+ * 日期格式化 Pipe
+ * @example
+ * {{ date | aclIntlDate }} // "2025/01/01"
+ * {{ date | aclIntlDate:{ dateStyle: 'long' } }} // "2025年1月1日"
+ * {{ date | aclIntlDate:{ year: 'numeric', month: 'long' } }} // "2025年1月"
+ */
+export declare class IntlDatePipe extends BaseIntlPipe implements PipeTransform {
+    transform(value: Date | string | number, options?: Intl.DateTimeFormatOptions): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IntlDatePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<IntlDatePipe, "aclIntlDate", true>;
+}
+/**
+ * 日期时间格式化 Pipe
+ * @example
+ * {{ date | aclIntlDateTime }} // "2025/01/01 14:30:00"
+ * {{ date | aclIntlDateTime:{ dateStyle: 'medium', timeStyle: 'short' } }} // "2025年1月1日 14:30"
+ */
+export declare class IntlDateTimePipe extends BaseIntlPipe implements PipeTransform {
+    transform(value: Date | string | number, options?: Intl.DateTimeFormatOptions): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IntlDateTimePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<IntlDateTimePipe, "aclIntlDateTime", true>;
+}
+/**
+ * 相对时间格式化 Pipe
+ * 支持两种使用方式：
+ * 1. 传入 Date 对象，自动计算相对时间
+ * 2. 传入数值和单位，手动指定相对时间
+ *
+ * 特性：
+ * - 自动刷新UI：根据时间距离智能调整刷新频率
+ * - 性能优化：共享定时器，避免大量单独计时器
+ * - 响应式设计：监听语言变化自动更新
+ *
+ * @example
+ * // 自动计算
+ * {{ pastDate | aclIntlRelativeTime }} // "2 hours ago"
+ * {{ futureDate | aclIntlRelativeTime:{ numeric: 'always' } }} // "in 2 hours"
+ *
+ * // 手动指定
+ * {{ -1 | aclIntlRelativeTime:'day' }} // "yesterday"
+ * {{ 2 | aclIntlRelativeTime:'hour':{ numeric: 'always' } }} // "in 2 hours"
+ * {{ -30 | aclIntlRelativeTime:'minute':{ numeric: 'always' } }} // "30 minutes ago"
+ */
+export declare class IntlRelativeTimePipe extends BaseIntlPipe implements PipeTransform, OnDestroy {
+    private readonly relativeTimeManager;
+    private currentInterval?;
+    private refreshSubscription?;
+    private currentValue?;
+    ngOnDestroy(): void;
+    transform(value: Date | number, unitOrOptions?: Intl.RelativeTimeFormatUnit | Intl.RelativeTimeFormatOptions, options?: Intl.RelativeTimeFormatOptions): string;
+    /**
+     * 设置自动刷新机制
+     * 使用共享的计时器管理器，提高多实例场景下的性能
+     * 时间间隔大于一天时不设置自动刷新
+     */
+    private setupAutoRefresh;
+    /**
+     * 清理刷新相关资源
+     */
+    private cleanupRefresh;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IntlRelativeTimePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<IntlRelativeTimePipe, "aclIntlRelativeTime", true>;
+}
+export {};

package/translate/public-api.d.ts

@@ -6,11 +6,12 @@
 /** imports */
 export * from './constants';
 export * from './helpers';
+export * from './i18n-assets-loader';
+export * from './i18n-config';
+export * from './intl-format.pipes';
 export * from './tokens';
 export * from './translate.directive';
 export * from './translate.module';
 export * from './translate.pipe';
 export * from './translate.service';
 export * from './types';
-export * from './i18n-assets-loader';
-export * from './i18n-config';

package/translate/relative-time-manager.service.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @packageDocumentation
+ * @module translate
+ */
+import { OnDestroy } from '@angular/core';
+import { Subject } from 'rxjs';
+import * as i0 from "@angular/core";
+/**
+ * 相对时间管理器服务
+ *
+ * 用于优化大量相对时间显示的性能，通过共享定时器避免创建过多独立计时器。
+ * 当页面存在大量相对时间显示时，使用统一的刷新频率来批量更新所有实例。
+ */
+export declare class RelativeTimeManagerService implements OnDestroy {
+    private readonly refreshSubjects;
+    private readonly timers;
+    /**
+     * 获取指定刷新间隔的 Subject
+     * 多个 pipe 实例可以共享同一个刷新频率
+     */
+    getRefreshSubject(interval: number): Subject<void>;
+    /**
+     * 释放指定间隔的订阅
+     * 当没有 pipe 实例使用时，自动清理定时器
+     */
+    releaseRefreshSubject(interval: number): void;
+    private startTimer;
+    private stopTimer;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RelativeTimeManagerService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<RelativeTimeManagerService>;
+}

package/translate/translate.module.d.ts

@@ -1,14 +1,16 @@
+import { IntlNumberPipe, IntlCurrencyPipe, IntlPercentPipe, IntlDatePipe, IntlDateTimePipe, IntlRelativeTimePipe } from './intl-format.pipes';
 import { TranslateDirective, TranslateMatchDirective, TranslateTextDirective } from './translate.directive';
 import { TranslatePipe } from './translate.pipe';
 import * as i0 from "@angular/core";
 import * as i1 from "./translate.pipe";
 import * as i2 from "./translate.directive";
-export declare const TRANSLATE_MODULE: readonly [typeof TranslatePipe, typeof TranslateDirective, typeof TranslateMatchDirective, typeof TranslateTextDirective];
+import * as i3 from "./intl-format.pipes";
+export declare const TRANSLATE_MODULE: readonly [typeof TranslatePipe, typeof TranslateDirective, typeof TranslateMatchDirective, typeof TranslateTextDirective, typeof IntlNumberPipe, typeof IntlCurrencyPipe, typeof IntlPercentPipe, typeof IntlDatePipe, typeof IntlDateTimePipe, typeof IntlRelativeTimePipe];
 /**
  * @deprecated use `TranslatePipe` or `TRANSLATE_MODULE` except `.forRoot`
  */
 export declare class TranslateModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<TranslateModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<TranslateModule, never, [typeof i1.TranslatePipe, typeof i2.TranslateDirective, typeof i2.TranslateMatchDirective, typeof i2.TranslateTextDirective], [typeof i1.TranslatePipe, typeof i2.TranslateDirective, typeof i2.TranslateMatchDirective, typeof i2.TranslateTextDirective]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<TranslateModule, never, [typeof i1.TranslatePipe, typeof i2.TranslateDirective, typeof i2.TranslateMatchDirective, typeof i2.TranslateTextDirective, typeof i3.IntlNumberPipe, typeof i3.IntlCurrencyPipe, typeof i3.IntlPercentPipe, typeof i3.IntlDatePipe, typeof i3.IntlDateTimePipe, typeof i3.IntlRelativeTimePipe], [typeof i1.TranslatePipe, typeof i2.TranslateDirective, typeof i2.TranslateMatchDirective, typeof i2.TranslateTextDirective, typeof i3.IntlNumberPipe, typeof i3.IntlCurrencyPipe, typeof i3.IntlPercentPipe, typeof i3.IntlDatePipe, typeof i3.IntlDateTimePipe, typeof i3.IntlRelativeTimePipe]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<TranslateModule>;
 }

package/translate/translate.pipe.d.ts

@@ -2,11 +2,10 @@
  * @packageDocumentation
  * @module translate
  */
-import { Injector, OnDestroy, PipeTransform } from '@angular/core';
-import { TranslateKey } from './types';
+import { OnDestroy, PipeTransform } from '@angular/core';
+import { TranslateKey, TemplateData } from './types';
 import * as i0 from "@angular/core";
 export declare class TranslatePipe implements PipeTransform, OnDestroy {
-    protected readonly injector: Injector;
     private readonly cdr;
     private readonly translate;
     private value;
@@ -14,8 +13,8 @@ export declare class TranslatePipe implements PipeTransform, OnDestroy {
     private lastData?;
     private onChange;
     private readonly destroy$$;
-    constructor(injector: Injector);
-    transform(key: TranslateKey | any, data?: unknown): string;
+    constructor();
+    transform(key: TranslateKey | any, data?: TemplateData): string;
     private updateValue;
     private dispose;
     ngOnDestroy(): void;

package/translate/translate.service.d.ts

@@ -4,59 +4,331 @@
  */
 import { HttpClient } from '@angular/common/http';
 import { OnDestroy } from '@angular/core';
-import { Observable, Subject } from 'rxjs';
-import { TranslateKey, TranslateOptions, Translation, Translations } from './types';
+import { Observable } from 'rxjs';
+import { TranslateKey, TranslateOptions, Translation, Translations, TemplateData } from './types';
 import * as i0 from "@angular/core";
+/**
+ * 国际化翻译服务
+ *
+ * 特性：
+ * - 支持多层级翻译优先级（远程翻译 > 手动添加翻译 > 配置翻译）
+ * - 支持动态语言切换
+ * - 支持 ICU Message Format 模板插值
+ * - 支持宽松模式语言匹配
+ * - 支持异步远程翻译加载
+ */
 export declare class TranslateService implements OnDestroy {
     private readonly http;
     private readonly baseHref;
-    readonly translationsAdded$: Subject<void>;
+    /** 翻译添加通知流 */
+    private readonly translationsAdded$$;
+    readonly translationsAdded$: Observable<void>;
+    /** 组件销毁通知流 */
     private readonly destroy$$;
+    /** 本地翻译列表（优先级：后加入的优先级更高） */
     readonly translationsList: Array<Readonly<Translations>>;
+    /** 远程翻译列表（优先级最高） */
     readonly remoteTranslationsList: Array<Readonly<Translations>>;
+    /** 翻译配置选项 */
     readonly options: TranslateOptions;
+    /** 当前语言环境 */
     locale: string;
+    /** 当前语言环境（响应式） */
     readonly locale$: Observable<string>;
+    /** 获取支持的语言列表 */
     get locales(): string[];
+    /** 获取回退语言 */
     get fallbackLocale(): string;
     constructor(http: HttpClient, baseHref: string, options: TranslateOptions, translationList: Translations[]);
+    /**
+     * 组件销毁清理
+     */
     ngOnDestroy(): void;
     /**
-     * @param key - 翻译key
-     * @param data - 根据翻译上下文数据获取翻译内容，翻译项不存在直接返回 key 文本
-     * @param ignoreNonExist - 开发环境是否忽视不存在的翻译项
+     * 获取翻译文本并进行模板插值
+     * 自动将传统 {{ key }} 语法转换为 ICU {key} 格式进行解析
+     * 同时支持原生 ICU Message Format 语法
+     * @param key - 翻译键或翻译对象
+     * @param data - 模板数据（支持基本类型、Date、对象和数组）
+     * @returns 翻译后的文本
+     *
+     * @example
+     * ```typescript
+     * // 对象参数（推荐）
+     * 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() })
+     * ```
      */
-    get(key: TranslateKey, data?: unknown): string;
+    get(key: TranslateKey, data?: TemplateData): string;
     /**
-     * 直接返回翻译文本模板
-     * @param key - 翻译key
-     * @param ignoreNonExist - 开发环境是否忽视不存在的翻译项
+     * 获取原始翻译文本模板（不进行插值处理）
+     * @param key - 翻译键或翻译对象
+     * @returns 原始翻译模板文本
      */
     getRaw(key: TranslateKey): string;
     /**
-     * 根据 `locales` 循环切换当前区域设置
+     * 切换到下一个支持的语言环境
      */
     toggleLocale(): void;
+    /**
+     * 设置当前语言环境
+     * @param locale - 要设置的语言环境
+     */
     setLocale(locale: string): void;
     /**
-     * 手动添加语言包
+     * 手动添加翻译包
+     * @param translations - 要添加的翻译包
      */
     addTranslations(translations: Translations): void;
     /**
-     * 手动添加语言包
+     * 添加远程翻译包
+     * @param remoteUrl - 远程翻译文件URL
      */
     addRemoteTranslations(remoteUrl: string): void;
     /**
-     * 从远程 url 模板和区域获取翻译包
+     * 从远程URL获取翻译数据
+     * @param remoteUrl - 远程URL
+     * @param locale - 可选的语言环境（用于URL模板替换）
+     * @returns 翻译数据的Observable
      */
     fetchTranslation(remoteUrl: string): Observable<Translations>;
     fetchTranslation(remoteUrl: string, locale: string): Observable<Translation>;
-    private _getLooseLocale;
-    private _getValue;
-    private _getWithFallback;
-    private _getBase;
-    protected _get(key: string, locale?: string): string;
-    private _compareKeys;
+    /**
+     * 获取初始语言环境
+     */
+    private getInitialLocale;
+    /**
+     * 获取初始翻译列表
+     */
+    private getInitializeTranslations;
+    /**
+     * 加载远程翻译
+     */
+    private loadRemoteTranslations;
+    /**
+     * 转换模板数据为 ICU 兼容格式
+     * @param data - 模板数据
+     * @returns ICU 兼容的数据对象
+     */
+    private normalizeAndConvertToIcuData;
+    /**
+     * 检查是否为纯模板对象（不是数组、Date等特殊对象）
+     */
+    private isPlainTemplateObject;
+    /**
+     * 转换对象的所有属性为 ICU 兼容值
+     */
+    private convertObjectToIcuData;
+    /**
+     * 将单个值转换为 ICU 兼容类型
+     * 按照 ICU MessageFormat 规范，只支持 string | number | Date
+     */
+    private convertValueToIcuValue;
+    /**
+     * 处理模板错误
+     */
+    private handleTemplateError;
+    /**
+     * 将传统的 {{ key }} 语法转换为 ICU {key} 格式
+     * 同时保持已有的 ICU 格式不变
+     * @param message - 原始消息模板
+     * @returns 转换后的 ICU 格式消息
+     */
+    private convertToIcuFormat;
+    /**
+     * 使用 ICU message format 格式化文本
+     */
+    private formatIcuMessage;
+    /**
+     * 格式化数字
+     * @param value - 要格式化的数字
+     * @param options - 格式化选项
+     * @returns 格式化后的数字字符串
+     *
+     * @example
+     * formatNumber(1234.56) // "1,234.56"
+     * formatNumber(0.85, { style: 'percent' }) // "85%"
+     * formatNumber(1234.56, { style: 'currency', currency: 'CNY' }) // "¥1,234.56"
+     */
+    formatNumber(value: number, options?: Intl.NumberFormatOptions): string;
+    /**
+     * 格式化货币
+     * @param value - 要格式化的金额
+     * @param currency - 货币代码，默认为 CNY
+     * @param options - 其他格式化选项
+     * @returns 格式化后的货币字符串
+     *
+     * @example
+     * formatCurrency(1234.56) // en-US: "CN¥1,234.56", zh-CN: "¥1,234.56"
+     * formatCurrency(1234.56, 'USD') // en-US: "$1,234.56", zh-CN: "US$1,234.56"
+     */
+    formatCurrency(value: number, currency?: string, options?: Omit<Intl.NumberFormatOptions, 'style' | 'currency'>): string;
+    /**
+     * 格式化百分比
+     * @param value - 要格式化的值（0.85 表示 85%）
+     * @param options - 格式化选项
+     * @returns 格式化后的百分比字符串
+     *
+     * @example
+     * formatPercent(0.85) // "85%"
+     * formatPercent(0.8567, { minimumFractionDigits: 2 }) // "85.67%"
+     */
+    formatPercent(value: number, options?: Omit<Intl.NumberFormatOptions, 'style'>): string;
+    /**
+     * 格式化日期
+     * @param date - 要格式化的日期
+     * @param options - Intl.DateTimeFormatOptions 格式配置
+     * @returns 格式化后的日期字符串
+     *
+     * @example
+     * formatDate(new Date()) // en-US: "01/01/2025", zh-CN: "2025/01/01"
+     * formatDate(new Date(), { dateStyle: 'full' }) // "2024年8月20日星期二"
+     * formatDate(new Date(), { year: 'numeric', month: '2-digit', day: '2-digit' }) // 根据locale格式化
+     * formatDate(new Date(), { year: 'numeric', month: 'long' }) // "2024年8月"
+     */
+    formatDate(date: Date | string | number, options?: Intl.DateTimeFormatOptions): string;
+    /**
+     * 格式化日期和时间
+     * @param date - 要格式化的日期时间
+     * @param options - Intl.DateTimeFormatOptions 格式配置
+     * @returns 格式化后的日期时间字符串
+     *
+     * @example
+     * formatDateTime(new Date()) // en-US: "01/01/2025, 14:30:00", zh-CN: "2025/01/01 14:30:00"
+     * formatDateTime(new Date(), { dateStyle: 'medium', timeStyle: 'short' }) // "2024年8月20日 14:30"
+     * formatDateTime(new Date(), { year: 'numeric', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit', second: '2-digit', hour12: false }) // 根据locale格式化
+     */
+    formatDateTime(date: Date | string | number, options?: Intl.DateTimeFormatOptions): string;
+    /**
+     * 格式化相对时间
+     * @param value - 时间差值（数字）或日期对象
+     * @param unit - 时间单位（当value为数字时必须提供）
+     * @param options - 格式化选项
+     * @returns 格式化后的相对时间字符串
+     *
+     * @example
+     * // 手动指定单位
+     * formatRelativeTime(-1, 'day') // en-US: "yesterday", zh-CN: "昨天"
+     * formatRelativeTime(2, 'hour') // en-US: "in 2 hours", zh-CN: "2小时后"
+     * formatRelativeTime(-30, 'minute') // en-US: "30 minutes ago", zh-CN: "30分钟前"
+     *
+     * // 自动计算单位
+     * formatRelativeTime(new Date(Date.now() - 60000)) // "1 minute ago"
+     * formatRelativeTime(new Date(Date.now() + 7200000)) // "in 2 hours"
+     * formatRelativeTime(new Date(Date.now() - 86400000)) // "yesterday"
+     */
+    formatRelativeTime(value: Date, options?: Intl.RelativeTimeFormatOptions): string;
+    formatRelativeTime(value: number, unit: Intl.RelativeTimeFormatUnit, options?: Intl.RelativeTimeFormatOptions): string;
+    /**
+     * 根据日期计算相对时间差值和最合适的单位
+     * @param date - 目标日期
+     * @returns 包含时间差值和单位的对象
+     */
+    private calculateRelativeTime;
+    /**
+     * 根据日期格式配置格式化日期
+     * 使用标准 Intl.DateTimeFormatOptions 确保格式可预测性
+     */
+    private formatDateByOptions;
+    /**
+     * 通过字符串键获取翻译
+     */
+    private getTranslationByKey;
+    /**
+     * 通过翻译对象获取翻译值
+     */
+    private getTranslationByObject;
+    /**
+     * 处理无效语言环境
+     */
+    private handleInvalidLocale;
+    /**
+     * 验证语言环境是否有效
+     */
+    private isValidLocale;
+    /**
+     * 检查重复翻译（开发模式）
+     */
+    private checkForDuplicateTranslations;
+    /**
+     * 标准化远程URL
+     */
+    private normalizeRemoteUrl;
+    /**
+     * 清理URL（移除hash片段）
+     */
+    private cleanUrl;
+    /**
+     * 验证远程URL（开发模式）
+     */
+    private validateRemoteUrl;
+    /**
+     * 创建远程翻译请求
+     */
+    private createRemoteTranslationRequest;
+    /**
+     * 创建多语言请求
+     */
+    private createMultiLocaleRequest;
+    /**
+     * 创建单语言请求
+     */
+    private createSingleLocaleRequest;
+    /**
+     * 执行翻译请求
+     */
+    private performTranslationRequest;
+    /**
+     * 验证fetchTranslation参数
+     */
+    private validateFetchTranslationParams;
+    /**
+     * 解析翻译文本
+     */
+    private resolveTranslation;
+    /**
+     * 在翻译列表中搜索
+     */
+    private searchInTranslationsList;
+    /**
+     * 在单个翻译对象中搜索
+     */
+    private searchInTranslations;
+    /**
+     * 从翻译源获取翻译值，支持扁平和嵌套两种结构
+     * @param source - 翻译源对象
+     * @param key - 翻译键（如 'a.b.c'）
+     * @returns 翻译值或undefined
+     */
+    private getTranslationFromSource;
+    /**
+     * 获取指定语言的翻译值（处理loose模式和fallback逻辑）
+     */
+    private getTranslationValue;
+    /**
+     * 宽松模式下获取翻译值
+     */
+    private getLooseTranslationValue;
+    /**
+     * 提取宽松语言代码（如：zh-CN -> zh）
+     */
+    private extractLooseLocale;
+    /**
+     * 验证翻译值（开发模式）
+     */
+    private validateTranslationValue;
+    /**
+     * 比较翻译键（开发模式下检查重复）
+     */
+    private compareTranslationKeys;
     static ɵfac: i0.ɵɵFactoryDeclaration<TranslateService, [null, null, { optional: true; }, { optional: true; }]>;
     static ɵprov: i0.ɵɵInjectableDeclaration<TranslateService>;
 }

package/translate/types.d.ts

@@ -9,6 +9,22 @@ export interface Translation {
 }
 export type Translations = Record<string, Translation>;
 export type TranslateKey = string | Translation;
+/**
+ * 模板插值数据类型
+ * 参考主流 i18n 库的类型定义
+ */
+export type TemplateData = string | number | boolean | Date | null | undefined | TemplateDataObject | TemplateData[] | unknown;
+export interface TemplateDataObject {
+    [key: string]: TemplateData;
+}
+/**
+ * ICU 兼容的简化数据类型
+ * ICU MessageFormat 原生支持的数据类型
+ */
+export type IcuValue = string | number | Date;
+export interface IcuData {
+    [key: string]: IcuValue;
+}
 export interface TranslateOptions {
     locale?: string;
     fallbackLocale?: string;

package/code/resource-yaml-display/schema/component.d.ts

@@ -1,61 +0,0 @@
-import { HttpClient } from '@angular/common/http';
-import { OnInit, OnChanges, SimpleChanges, EventEmitter, ChangeDetectorRef } from '@angular/core';
-import { KubernetesSchemaService } from '../../../core/services/kubernetes-schema.service';
-import { KubernetesResource } from '../../../core/types/k8s/core';
-import { OpenAPIV3SchemaObject } from '../../../core/types/schema';
-import * as i0 from "@angular/core";
-interface YamlExample {
-    title: string;
-    description: string;
-    yaml: string;
-    snippet?: boolean;
-}
-export declare class ResourceYamlSchemaComponent implements OnInit, OnChanges {
-    private schemaService;
-    private http;
-    private cdr;
-    resource: KubernetesResource;
-    schema: OpenAPIV3SchemaObject;
-    close: EventEmitter<void>;
-    tryYaml: EventEmitter<string>;
-    private readonly DEFINITIONS_PREFIX;
-    currentSchema: OpenAPIV3SchemaObject;
-    properties: {
-        [key: string]: OpenAPIV3SchemaObject;
-    };
-    path: string[];
-    resourceKind: string;
-    examples: YamlExample[];
-    hasSchema: boolean;
-    hasExamples: boolean;
-    private readonly builtInExamples;
-    constructor(schemaService: KubernetesSchemaService, http: HttpClient, cdr: ChangeDetectorRef);
-    ngOnInit(): void;
-    ngOnChanges(changes: SimpleChanges): void;
-    refresh(): void;
-    private loadExamples;
-    private loadConsoleYAMLSamples;
-    drilldownToProperty(name: string): void;
-    navigateToPath(index: number): void;
-    hasNestedProperties(property: OpenAPIV3SchemaObject): boolean;
-    getPropertyType(property: OpenAPIV3SchemaObject): string;
-    isRequired(propertyName: string): boolean;
-    /**
-     * 检查属性是否有 $ref 引用或嵌套属性
-     */
-    hasViewableContent(property: OpenAPIV3SchemaObject): boolean;
-    /**
-     * 检查属性是否有 $ref 引用
-     */
-    hasRefProperty(property: OpenAPIV3SchemaObject): boolean;
-    /**
-     * 获取 $ref 引用的定义名称
-     */
-    getRefDefinitionName(property: OpenAPIV3SchemaObject): string;
-    tryExample(example: YamlExample): void;
-    downloadYaml(example: YamlExample): void;
-    processDescription(description: string): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ResourceYamlSchemaComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ResourceYamlSchemaComponent, "acl-resource-yaml-schema", never, { "resource": { "alias": "resource"; "required": false; }; "schema": { "alias": "schema"; "required": false; }; }, { "close": "close"; "tryYaml": "tryYaml"; }, never, never, true, never>;
-}
-export {};

package/code/yaml-sidebar/yaml-examples.d.ts

@@ -1,8 +0,0 @@
-import { YamlExample } from './types';
-/**
- * Kubernetes 资源的内置 YAML 示例
- * 按照 apiVersion.kind 的格式组织
- */
-export declare const BUILT_IN_YAML_EXAMPLES: {
-    [key: string]: YamlExample[];
-};