@nahisaho/musubix-core 1.0.0

package/dist/utils/i18n-manager.d.ts

@@ -0,0 +1,259 @@
+/**
+ * Internationalization (i18n) Manager
+ *
+ * Manages multi-language support for messages, labels, and content
+ *
+ * @packageDocumentation
+ * @module utils/i18n
+ *
+ * @see REQ-I18N-001 - Internationalization Support
+ * @see Article VII - Seamless Integration
+ */
+/**
+ * Supported locale
+ */
+export type SupportedLocale = 'en' | 'ja' | 'zh' | 'ko' | 'de' | 'fr' | 'es' | 'pt';
+/**
+ * Translation key path
+ */
+export type TranslationKey = string;
+/**
+ * Translation value
+ */
+export type TranslationValue = string | Record<string, unknown>;
+/**
+ * Translation dictionary
+ */
+export type TranslationDictionary = Record<TranslationKey, TranslationValue>;
+/**
+ * Locale data
+ */
+export interface LocaleData {
+    /** Locale code */
+    locale: SupportedLocale;
+    /** Display name */
+    name: string;
+    /** Native name */
+    nativeName: string;
+    /** Direction */
+    direction: 'ltr' | 'rtl';
+    /** Translations */
+    translations: TranslationDictionary;
+}
+/**
+ * Plural rules
+ */
+export interface PluralRules {
+    /** Zero form */
+    zero?: string;
+    /** One form */
+    one: string;
+    /** Two form */
+    two?: string;
+    /** Few form */
+    few?: string;
+    /** Many form */
+    many?: string;
+    /** Other form */
+    other: string;
+}
+/**
+ * Date/time format options
+ */
+export interface DateTimeFormatOptions {
+    /** Date style */
+    dateStyle?: 'full' | 'long' | 'medium' | 'short';
+    /** Time style */
+    timeStyle?: 'full' | 'long' | 'medium' | 'short';
+    /** Hour cycle */
+    hourCycle?: 'h11' | 'h12' | 'h23' | 'h24';
+}
+/**
+ * Number format options
+ */
+export interface NumberFormatOptions {
+    /** Style */
+    style?: 'decimal' | 'currency' | 'percent' | 'unit';
+    /** Currency code */
+    currency?: string;
+    /** Minimum fraction digits */
+    minimumFractionDigits?: number;
+    /** Maximum fraction digits */
+    maximumFractionDigits?: number;
+    /** Unit */
+    unit?: string;
+}
+/**
+ * I18n configuration
+ */
+export interface I18nConfig {
+    /** Default locale */
+    defaultLocale: SupportedLocale;
+    /** Fallback locale */
+    fallbackLocale: SupportedLocale;
+    /** Load path pattern */
+    loadPath?: string;
+    /** Cache translations */
+    cache: boolean;
+    /** Debug mode */
+    debug: boolean;
+    /** Missing key handler */
+    missingKeyHandler?: (key: string, locale: SupportedLocale) => string;
+}
+/**
+ * Default configuration
+ */
+export declare const DEFAULT_I18N_CONFIG: I18nConfig;
+/**
+ * Interpolation options
+ */
+export interface InterpolationOptions {
+    /** Variables to interpolate */
+    [key: string]: string | number | boolean | undefined;
+}
+/**
+ * I18n Manager
+ */
+export declare class I18nManager {
+    private config;
+    private currentLocale;
+    private locales;
+    private cache;
+    private loadedLocales;
+    constructor(config?: Partial<I18nConfig>);
+    /**
+     * Get current locale
+     */
+    getLocale(): SupportedLocale;
+    /**
+     * Set current locale
+     */
+    setLocale(locale: SupportedLocale): void;
+    /**
+     * Check if locale is supported
+     */
+    isLocaleSupported(locale: string): locale is SupportedLocale;
+    /**
+     * Get all supported locales
+     */
+    getSupportedLocales(): SupportedLocale[];
+    /**
+     * Get locale data
+     */
+    getLocaleData(locale?: SupportedLocale): LocaleData | undefined;
+    /**
+     * Translate a key
+     */
+    t(key: TranslationKey, options?: InterpolationOptions): string;
+    /**
+     * Translate with plural support
+     */
+    tp(key: TranslationKey, count: number, options?: InterpolationOptions): string;
+    /**
+     * Get translation value
+     */
+    private getTranslation;
+    /**
+     * Get plural key based on count
+     */
+    private getPluralKey;
+    /**
+     * Get plural form based on count
+     */
+    private getPluralForm;
+    /**
+     * Interpolate variables in translation
+     */
+    private interpolate;
+    /**
+     * Add translations for a locale
+     */
+    addTranslations(locale: SupportedLocale, translations: TranslationDictionary): void;
+    /**
+     * Load translations from object
+     */
+    loadTranslations(data: Record<SupportedLocale, TranslationDictionary>): void;
+    /**
+     * Format date
+     */
+    formatDate(date: Date, options?: DateTimeFormatOptions): string;
+    /**
+     * Format number
+     */
+    formatNumber(value: number, options?: NumberFormatOptions): string;
+    /**
+     * Format currency
+     */
+    formatCurrency(value: number, currency: string): string;
+    /**
+     * Format percentage
+     */
+    formatPercent(value: number): string;
+    /**
+     * Format relative time
+     */
+    formatRelativeTime(date: Date, referenceDate?: Date): string;
+    /**
+     * Get text direction for current locale
+     */
+    getTextDirection(): 'ltr' | 'rtl';
+    /**
+     * Check if current locale is RTL
+     */
+    isRTL(): boolean;
+    /**
+     * Get display name for locale
+     */
+    getLocaleDisplayName(locale?: SupportedLocale): string;
+    /**
+     * Create scoped translator
+     */
+    scope(namespace: string): (key: string, options?: InterpolationOptions) => string;
+    /**
+     * Check if translation exists
+     */
+    exists(key: TranslationKey, locale?: SupportedLocale): boolean;
+    /**
+     * Get all keys for a namespace
+     */
+    getKeys(namespace?: string): string[];
+    /**
+     * Clear translation cache
+     */
+    clearCache(): void;
+    /**
+     * Export translations for locale
+     */
+    exportTranslations(locale?: SupportedLocale): TranslationDictionary;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        currentLocale: SupportedLocale;
+        supportedLocales: number;
+        loadedLocales: number;
+        translationKeys: number;
+        cacheSize: number;
+    };
+}
+/**
+ * Create I18n manager instance
+ */
+export declare function createI18nManager(config?: Partial<I18nConfig>): I18nManager;
+/**
+ * Get global I18n instance
+ */
+export declare function getI18n(): I18nManager;
+/**
+ * Initialize global I18n
+ */
+export declare function initI18n(config?: Partial<I18nConfig>): I18nManager;
+/**
+ * Shorthand translate function
+ */
+export declare function t(key: TranslationKey, options?: InterpolationOptions): string;
+/**
+ * Shorthand translate with plural
+ */
+export declare function tp(key: TranslationKey, count: number, options?: InterpolationOptions): string;
+//# sourceMappingURL=i18n-manager.d.ts.map

package/dist/utils/i18n-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-manager.d.ts","sourceRoot":"","sources":["../../src/utils/i18n-manager.ts"],"names":[],"mappings":"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"}