@nice2dev/game-engine 1.3.14 → 1.3.16

package/dist/cjs/performance/LocalizationRuntime.js

@@ -1,468 +1,421 @@
-'use strict';
-
-/**
- * @file LocalizationRuntime.ts
- * @description In-game language switching and runtime localization
- * PRO-1.5: Runtime & Performance
- *
- * Features:
- * - Runtime language switching
- * - String interpolation
- * - Pluralization rules
- * - Date/time/number formatting
- * - RTL support
- * - Fallback chains
- * - Missing translation detection
- * - Hot-swap translations
- */
-// ============================================================
-// Predefined Locales
-// ============================================================
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const LOCALES = {
-    'en-US': {
-        code: 'en-US',
-        name: 'English (US)',
-        nativeName: 'English',
-        direction: 'ltr',
-        dateFormat: 'MM/DD/YYYY',
-        timeFormat: 'h:mm A',
-        numberFormat: {
-            decimalSeparator: '.',
-            thousandsSeparator: ',',
-            currencySymbol: '$',
-            currencyPosition: 'prefix',
-        },
-        pluralRules: [
-            { category: 'one', condition: (n) => n === 1 },
-            { category: 'other', condition: () => true },
-        ],
+  "en-US": {
+    code: "en-US",
+    name: "English (US)",
+    nativeName: "English",
+    direction: "ltr",
+    dateFormat: "MM/DD/YYYY",
+    timeFormat: "h:mm A",
+    numberFormat: {
+      decimalSeparator: ".",
+      thousandsSeparator: ",",
+      currencySymbol: "$",
+      currencyPosition: "prefix"
     },
-    'en-GB': {
-        code: 'en-GB',
-        name: 'English (UK)',
-        nativeName: 'English',
-        direction: 'ltr',
-        dateFormat: 'DD/MM/YYYY',
-        timeFormat: 'HH:mm',
-        numberFormat: {
-            decimalSeparator: '.',
-            thousandsSeparator: ',',
-            currencySymbol: '£',
-            currencyPosition: 'prefix',
-        },
-        pluralRules: [
-            { category: 'one', condition: (n) => n === 1 },
-            { category: 'other', condition: () => true },
-        ],
+    pluralRules: [
+      { category: "one", condition: (n) => n === 1 },
+      { category: "other", condition: () => true }
+    ]
+  },
+  "en-GB": {
+    code: "en-GB",
+    name: "English (UK)",
+    nativeName: "English",
+    direction: "ltr",
+    dateFormat: "DD/MM/YYYY",
+    timeFormat: "HH:mm",
+    numberFormat: {
+      decimalSeparator: ".",
+      thousandsSeparator: ",",
+      currencySymbol: "£",
+      currencyPosition: "prefix"
     },
-    'de-DE': {
-        code: 'de-DE',
-        name: 'German',
-        nativeName: 'Deutsch',
-        direction: 'ltr',
-        dateFormat: 'DD.MM.YYYY',
-        timeFormat: 'HH:mm',
-        numberFormat: {
-            decimalSeparator: ',',
-            thousandsSeparator: '.',
-            currencySymbol: '€',
-            currencyPosition: 'suffix',
-        },
-        pluralRules: [
-            { category: 'one', condition: (n) => n === 1 },
-            { category: 'other', condition: () => true },
-        ],
+    pluralRules: [
+      { category: "one", condition: (n) => n === 1 },
+      { category: "other", condition: () => true }
+    ]
+  },
+  "de-DE": {
+    code: "de-DE",
+    name: "German",
+    nativeName: "Deutsch",
+    direction: "ltr",
+    dateFormat: "DD.MM.YYYY",
+    timeFormat: "HH:mm",
+    numberFormat: {
+      decimalSeparator: ",",
+      thousandsSeparator: ".",
+      currencySymbol: "€",
+      currencyPosition: "suffix"
     },
-    'pl-PL': {
-        code: 'pl-PL',
-        name: 'Polish',
-        nativeName: 'Polski',
-        direction: 'ltr',
-        dateFormat: 'DD.MM.YYYY',
-        timeFormat: 'HH:mm',
-        numberFormat: {
-            decimalSeparator: ',',
-            thousandsSeparator: ' ',
-            currencySymbol: 'zł',
-            currencyPosition: 'suffix',
-        },
-        pluralRules: [
-            { category: 'one', condition: (n) => n === 1 },
-            {
-                category: 'few',
-                condition: (n) => n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 12 || n % 100 > 14),
-            },
-            {
-                category: 'many',
-                condition: (n) => n !== 1 &&
-                    ((n % 10 >= 0 && n % 10 <= 1) ||
-                        (n % 10 >= 5 && n % 10 <= 9) ||
-                        (n % 100 >= 12 && n % 100 <= 14)),
-            },
-            { category: 'other', condition: () => true },
-        ],
+    pluralRules: [
+      { category: "one", condition: (n) => n === 1 },
+      { category: "other", condition: () => true }
+    ]
+  },
+  "pl-PL": {
+    code: "pl-PL",
+    name: "Polish",
+    nativeName: "Polski",
+    direction: "ltr",
+    dateFormat: "DD.MM.YYYY",
+    timeFormat: "HH:mm",
+    numberFormat: {
+      decimalSeparator: ",",
+      thousandsSeparator: " ",
+      currencySymbol: "zł",
+      currencyPosition: "suffix"
     },
-    'ja-JP': {
-        code: 'ja-JP',
-        name: 'Japanese',
-        nativeName: '日本語',
-        direction: 'ltr',
-        dateFormat: 'YYYY/MM/DD',
-        timeFormat: 'HH:mm',
-        numberFormat: {
-            decimalSeparator: '.',
-            thousandsSeparator: ',',
-            currencySymbol: '¥',
-            currencyPosition: 'prefix',
-        },
-        pluralRules: [{ category: 'other', condition: () => true }],
+    pluralRules: [
+      { category: "one", condition: (n) => n === 1 },
+      {
+        category: "few",
+        condition: (n) => n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 12 || n % 100 > 14)
+      },
+      {
+        category: "many",
+        condition: (n) => n !== 1 && (n % 10 >= 0 && n % 10 <= 1 || n % 10 >= 5 && n % 10 <= 9 || n % 100 >= 12 && n % 100 <= 14)
+      },
+      { category: "other", condition: () => true }
+    ]
+  },
+  "ja-JP": {
+    code: "ja-JP",
+    name: "Japanese",
+    nativeName: "日本語",
+    direction: "ltr",
+    dateFormat: "YYYY/MM/DD",
+    timeFormat: "HH:mm",
+    numberFormat: {
+      decimalSeparator: ".",
+      thousandsSeparator: ",",
+      currencySymbol: "¥",
+      currencyPosition: "prefix"
     },
-    'ar-SA': {
-        code: 'ar-SA',
-        name: 'Arabic',
-        nativeName: 'العربية',
-        direction: 'rtl',
-        dateFormat: 'DD/MM/YYYY',
-        timeFormat: 'HH:mm',
-        numberFormat: {
-            decimalSeparator: '٫',
-            thousandsSeparator: '٬',
-            currencySymbol: 'ر.س',
-            currencyPosition: 'suffix',
-        },
-        pluralRules: [
-            { category: 'zero', condition: (n) => n === 0 },
-            { category: 'one', condition: (n) => n === 1 },
-            { category: 'two', condition: (n) => n === 2 },
-            { category: 'few', condition: (n) => n % 100 >= 3 && n % 100 <= 10 },
-            { category: 'many', condition: (n) => n % 100 >= 11 && n % 100 <= 99 },
-            { category: 'other', condition: () => true },
-        ],
+    pluralRules: [{ category: "other", condition: () => true }]
+  },
+  "ar-SA": {
+    code: "ar-SA",
+    name: "Arabic",
+    nativeName: "العربية",
+    direction: "rtl",
+    dateFormat: "DD/MM/YYYY",
+    timeFormat: "HH:mm",
+    numberFormat: {
+      decimalSeparator: "٫",
+      thousandsSeparator: "٬",
+      currencySymbol: "ر.س",
+      currencyPosition: "suffix"
     },
-    'zh-CN': {
-        code: 'zh-CN',
-        name: 'Chinese (Simplified)',
-        nativeName: '简体中文',
-        direction: 'ltr',
-        dateFormat: 'YYYY-MM-DD',
-        timeFormat: 'HH:mm',
-        numberFormat: {
-            decimalSeparator: '.',
-            thousandsSeparator: ',',
-            currencySymbol: '¥',
-            currencyPosition: 'prefix',
-        },
-        pluralRules: [{ category: 'other', condition: () => true }],
+    pluralRules: [
+      { category: "zero", condition: (n) => n === 0 },
+      { category: "one", condition: (n) => n === 1 },
+      { category: "two", condition: (n) => n === 2 },
+      { category: "few", condition: (n) => n % 100 >= 3 && n % 100 <= 10 },
+      { category: "many", condition: (n) => n % 100 >= 11 && n % 100 <= 99 },
+      { category: "other", condition: () => true }
+    ]
+  },
+  "zh-CN": {
+    code: "zh-CN",
+    name: "Chinese (Simplified)",
+    nativeName: "简体中文",
+    direction: "ltr",
+    dateFormat: "YYYY-MM-DD",
+    timeFormat: "HH:mm",
+    numberFormat: {
+      decimalSeparator: ".",
+      thousandsSeparator: ",",
+      currencySymbol: "¥",
+      currencyPosition: "prefix"
     },
-    'ru-RU': {
-        code: 'ru-RU',
-        name: 'Russian',
-        nativeName: 'Русский',
-        direction: 'ltr',
-        dateFormat: 'DD.MM.YYYY',
-        timeFormat: 'HH:mm',
-        numberFormat: {
-            decimalSeparator: ',',
-            thousandsSeparator: ' ',
-            currencySymbol: '₽',
-            currencyPosition: 'suffix',
-        },
-        pluralRules: [
-            { category: 'one', condition: (n) => n % 10 === 1 && n % 100 !== 11 },
-            {
-                category: 'few',
-                condition: (n) => n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 12 || n % 100 > 14),
-            },
-            {
-                category: 'many',
-                condition: (n) => n % 10 === 0 || (n % 10 >= 5 && n % 10 <= 9) || (n % 100 >= 11 && n % 100 <= 14),
-            },
-            { category: 'other', condition: () => true },
-        ],
+    pluralRules: [{ category: "other", condition: () => true }]
+  },
+  "ru-RU": {
+    code: "ru-RU",
+    name: "Russian",
+    nativeName: "Русский",
+    direction: "ltr",
+    dateFormat: "DD.MM.YYYY",
+    timeFormat: "HH:mm",
+    numberFormat: {
+      decimalSeparator: ",",
+      thousandsSeparator: " ",
+      currencySymbol: "₽",
+      currencyPosition: "suffix"
     },
+    pluralRules: [
+      { category: "one", condition: (n) => n % 10 === 1 && n % 100 !== 11 },
+      {
+        category: "few",
+        condition: (n) => n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 12 || n % 100 > 14)
+      },
+      {
+        category: "many",
+        condition: (n) => n % 10 === 0 || n % 10 >= 5 && n % 10 <= 9 || n % 100 >= 11 && n % 100 <= 14
+      },
+      { category: "other", condition: () => true }
+    ]
+  }
 };
-// ============================================================
-// Default Configuration
-// ============================================================
 const DEFAULT_LOCALIZATION_CONFIG = {
-    defaultLocale: 'en-US',
-    fallbackLocale: 'en-US',
-    availableLocales: Object.keys(LOCALES),
-    interpolationPrefix: '{{',
-    interpolationSuffix: '}}',
+  defaultLocale: "en-US",
+  fallbackLocale: "en-US",
+  availableLocales: Object.keys(LOCALES),
+  interpolationPrefix: "{{",
+  interpolationSuffix: "}}"
 };
-// ============================================================
-// Localization Runtime
-// ============================================================
 class LocalizationRuntime {
-    constructor(config) {
-        this.namespaces = new Map();
-        this.loadedNamespaces = new Set();
-        this.missingKeys = new Set();
-        this.config = { ...DEFAULT_LOCALIZATION_CONFIG, ...config };
-        this.currentLocale = this.config.defaultLocale;
-        this.localeInfo = LOCALES[this.currentLocale] ?? LOCALES['en-US'];
+  constructor(config) {
+    this.namespaces = /* @__PURE__ */ new Map();
+    this.loadedNamespaces = /* @__PURE__ */ new Set();
+    this.missingKeys = /* @__PURE__ */ new Set();
+    this.config = { ...DEFAULT_LOCALIZATION_CONFIG, ...config };
+    this.currentLocale = this.config.defaultLocale;
+    this.localeInfo = LOCALES[this.currentLocale] ?? LOCALES["en-US"];
+  }
+  // ─── Locale Management ─────────────────────────────────
+  async setLocale(locale) {
+    if (!this.config.availableLocales.includes(locale)) {
+      return false;
     }
-    // ─── Locale Management ─────────────────────────────────
-    async setLocale(locale) {
-        if (!this.config.availableLocales.includes(locale)) {
-            return false;
-        }
-        const oldLocale = this.currentLocale;
-        this.currentLocale = locale;
-        this.localeInfo = LOCALES[locale] ?? LOCALES['en-US'];
-        // Reload namespaces for new locale
-        for (const namespace of this.loadedNamespaces) {
-            await this.loadNamespace(namespace);
-        }
-        this.onLocaleChanged?.(oldLocale, locale);
-        return true;
+    const oldLocale = this.currentLocale;
+    this.currentLocale = locale;
+    this.localeInfo = LOCALES[locale] ?? LOCALES["en-US"];
+    for (const namespace of this.loadedNamespaces) {
+      await this.loadNamespace(namespace);
     }
-    getLocale() {
-        return this.currentLocale;
+    this.onLocaleChanged?.(oldLocale, locale);
+    return true;
+  }
+  getLocale() {
+    return this.currentLocale;
+  }
+  getLocaleInfo() {
+    return { ...this.localeInfo };
+  }
+  getAvailableLocales() {
+    return this.config.availableLocales.map((code) => LOCALES[code]).filter(Boolean);
+  }
+  isRTL() {
+    return this.localeInfo.direction === "rtl";
+  }
+  // ─── Translation Loading ───────────────────────────────
+  addTranslations(namespace, locale, entries) {
+    if (!this.namespaces.has(namespace)) {
+      this.namespaces.set(namespace, /* @__PURE__ */ new Map());
     }
-    getLocaleInfo() {
-        return { ...this.localeInfo };
+    const localeNamespaces = this.namespaces.get(namespace);
+    if (!localeNamespaces.has(locale)) {
+      localeNamespaces.set(locale, {
+        namespace,
+        entries: /* @__PURE__ */ new Map()
+      });
     }
-    getAvailableLocales() {
-        return this.config.availableLocales.map((code) => LOCALES[code]).filter(Boolean);
+    const ns = localeNamespaces.get(locale);
+    for (const entry of entries) {
+      ns.entries.set(entry.key, entry);
     }
-    isRTL() {
-        return this.localeInfo.direction === 'rtl';
+    this.loadedNamespaces.add(namespace);
+  }
+  async loadNamespace(namespace) {
+    if (!this.config.loadNamespaceAsync) {
+      return false;
     }
-    // ─── Translation Loading ───────────────────────────────
-    addTranslations(namespace, locale, entries) {
-        if (!this.namespaces.has(namespace)) {
-            this.namespaces.set(namespace, new Map());
-        }
-        const localeNamespaces = this.namespaces.get(namespace);
-        if (!localeNamespaces.has(locale)) {
-            localeNamespaces.set(locale, {
-                namespace,
-                entries: new Map(),
-            });
-        }
-        const ns = localeNamespaces.get(locale);
-        for (const entry of entries) {
-            ns.entries.set(entry.key, entry);
-        }
-        this.loadedNamespaces.add(namespace);
+    try {
+      const entries = await this.config.loadNamespaceAsync(namespace, this.currentLocale);
+      this.addTranslations(namespace, this.currentLocale, entries);
+      this.onNamespaceLoaded?.(namespace, this.currentLocale);
+      return true;
+    } catch {
+      return false;
     }
-    async loadNamespace(namespace) {
-        if (!this.config.loadNamespaceAsync) {
-            return false;
-        }
-        try {
-            const entries = await this.config.loadNamespaceAsync(namespace, this.currentLocale);
-            this.addTranslations(namespace, this.currentLocale, entries);
-            this.onNamespaceLoaded?.(namespace, this.currentLocale);
-            return true;
-        }
-        catch {
-            return false;
-        }
+  }
+  hasNamespace(namespace) {
+    return this.loadedNamespaces.has(namespace);
+  }
+  // ─── Translation Lookup ────────────────────────────────
+  t(key, values, options) {
+    const namespace = options?.namespace ?? "default";
+    const count = options?.count;
+    let entry = this.getEntry(key, namespace, this.currentLocale);
+    if (!entry && this.currentLocale !== this.config.fallbackLocale) {
+      entry = this.getEntry(key, namespace, this.config.fallbackLocale);
     }
-    hasNamespace(namespace) {
-        return this.loadedNamespaces.has(namespace);
+    if (!entry) {
+      this.handleMissingKey(key);
+      return this.config.missingKeyHandler?.(key, this.currentLocale) ?? key;
     }
-    // ─── Translation Lookup ────────────────────────────────
-    t(key, values, options) {
-        const namespace = options?.namespace ?? 'default';
-        const count = options?.count;
-        // Try current locale
-        let entry = this.getEntry(key, namespace, this.currentLocale);
-        // Try fallback locale
-        if (!entry && this.currentLocale !== this.config.fallbackLocale) {
-            entry = this.getEntry(key, namespace, this.config.fallbackLocale);
-        }
-        if (!entry) {
-            this.handleMissingKey(key);
-            return this.config.missingKeyHandler?.(key, this.currentLocale) ?? key;
-        }
-        let value = entry.value;
-        // Handle pluralization
-        if (count !== undefined && entry.plural) {
-            const category = this.getPluralCategory(count);
-            value = entry.plural[category] ?? entry.value;
-        }
-        // Handle interpolation
-        if (values) {
-            value = this.interpolate(value, values);
-        }
-        return value;
+    let value = entry.value;
+    if (count !== void 0 && entry.plural) {
+      const category = this.getPluralCategory(count);
+      value = entry.plural[category] ?? entry.value;
     }
-    getEntry(key, namespace, locale) {
-        return this.namespaces.get(namespace)?.get(locale)?.entries.get(key);
+    if (values) {
+      value = this.interpolate(value, values);
     }
-    handleMissingKey(key) {
-        if (!this.missingKeys.has(key)) {
-            this.missingKeys.add(key);
-            this.onMissingKey?.(key, this.currentLocale);
-        }
+    return value;
+  }
+  getEntry(key, namespace, locale) {
+    return this.namespaces.get(namespace)?.get(locale)?.entries.get(key);
+  }
+  handleMissingKey(key) {
+    if (!this.missingKeys.has(key)) {
+      this.missingKeys.add(key);
+      this.onMissingKey?.(key, this.currentLocale);
     }
-    // ─── Interpolation ─────────────────────────────────────
-    interpolate(text, values) {
-        const { interpolationPrefix, interpolationSuffix } = this.config;
-        let result = text;
-        for (const [key, value] of Object.entries(values)) {
-            const placeholder = `${interpolationPrefix}${key}${interpolationSuffix}`;
-            const formattedValue = this.formatValue(value);
-            result = result.split(placeholder).join(formattedValue);
-        }
-        return result;
+  }
+  // ─── Interpolation ─────────────────────────────────────
+  interpolate(text, values) {
+    const { interpolationPrefix, interpolationSuffix } = this.config;
+    let result = text;
+    for (const [key, value] of Object.entries(values)) {
+      const placeholder = `${interpolationPrefix}${key}${interpolationSuffix}`;
+      const formattedValue = this.formatValue(value);
+      result = result.split(placeholder).join(formattedValue);
     }
-    formatValue(value) {
-        if (value instanceof Date) {
-            return this.formatDate(value).medium;
-        }
-        if (typeof value === 'number') {
-            return this.formatNumber(value).standard;
-        }
-        return String(value);
+    return result;
+  }
+  formatValue(value) {
+    if (value instanceof Date) {
+      return this.formatDate(value).medium;
     }
-    // ─── Pluralization ─────────────────────────────────────
-    getPluralCategory(n) {
-        for (const rule of this.localeInfo.pluralRules) {
-            if (rule.condition(n)) {
-                return rule.category;
-            }
-        }
-        return 'other';
+    if (typeof value === "number") {
+      return this.formatNumber(value).standard;
     }
-    // ─── Date Formatting ───────────────────────────────────
-    formatDate(date) {
-        const { dateFormat, timeFormat } = this.localeInfo;
-        const year = date.getFullYear();
-        const month = String(date.getMonth() + 1).padStart(2, '0');
-        const day = String(date.getDate()).padStart(2, '0');
-        const hours = String(date.getHours()).padStart(2, '0');
-        const minutes = String(date.getMinutes()).padStart(2, '0');
-        const formatStr = (format) => {
-            return format
-                .replace('YYYY', String(year))
-                .replace('MM', month)
-                .replace('DD', day)
-                .replace('HH', hours)
-                .replace('hh', String(date.getHours() % 12 || 12).padStart(2, '0'))
-                .replace('mm', minutes)
-                .replace('A', date.getHours() >= 12 ? 'PM' : 'AM');
-        };
-        return {
-            full: `${formatStr(dateFormat)} ${formatStr(timeFormat)}`,
-            long: formatStr(dateFormat),
-            medium: formatStr(dateFormat.replace('YYYY', String(year).slice(2))),
-            short: `${month}/${day}`,
-            relative: this.getRelativeTime(date),
-        };
+    return String(value);
+  }
+  // ─── Pluralization ─────────────────────────────────────
+  getPluralCategory(n) {
+    for (const rule of this.localeInfo.pluralRules) {
+      if (rule.condition(n)) {
+        return rule.category;
+      }
     }
-    getRelativeTime(date) {
-        const now = new Date();
-        const diff = now.getTime() - date.getTime();
-        const seconds = Math.floor(diff / 1000);
-        const minutes = Math.floor(seconds / 60);
-        const hours = Math.floor(minutes / 60);
-        const days = Math.floor(hours / 24);
-        if (seconds < 60) {
-            return this.t('time.justNow', undefined, { namespace: 'system' }) || 'just now';
-        }
-        if (minutes < 60) {
-            return `${minutes}m ago`;
-        }
-        if (hours < 24) {
-            return `${hours}h ago`;
-        }
-        if (days < 7) {
-            return `${days}d ago`;
-        }
-        return this.formatDate(date).long;
-    }
-    // ─── Number Formatting ─────────────────────────────────
-    formatNumber(value) {
-        const { decimalSeparator, thousandsSeparator, currencySymbol, currencyPosition } = this.localeInfo.numberFormat;
-        const formatStandard = (n) => {
-            const [int, dec] = n.toFixed(2).split('.');
-            const formattedInt = int.replace(/\B(?=(\d{3})+(?!\d))/g, thousandsSeparator);
-            return dec && Number(dec) > 0 ? `${formattedInt}${decimalSeparator}${dec}` : formattedInt;
-        };
-        const standard = formatStandard(value);
-        const currency = currencyPosition === 'prefix'
-            ? `${currencySymbol}${standard}`
-            : `${standard} ${currencySymbol}`;
-        const percent = `${formatStandard(value * 100)}%`;
-        const compact = this.formatCompact(value);
-        return { standard, currency, percent, compact };
-    }
-    formatCompact(value) {
-        if (value >= 1000000000) {
-            return `${(value / 1000000000).toFixed(1)}B`;
-        }
-        if (value >= 1000000) {
-            return `${(value / 1000000).toFixed(1)}M`;
-        }
-        if (value >= 1000) {
-            return `${(value / 1000).toFixed(1)}K`;
-        }
-        return String(value);
-    }
-    // ─── Utilities ─────────────────────────────────────────
-    getMissingKeys() {
-        return Array.from(this.missingKeys);
+    return "other";
+  }
+  // ─── Date Formatting ───────────────────────────────────
+  formatDate(date) {
+    const { dateFormat, timeFormat } = this.localeInfo;
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, "0");
+    const day = String(date.getDate()).padStart(2, "0");
+    const hours = String(date.getHours()).padStart(2, "0");
+    const minutes = String(date.getMinutes()).padStart(2, "0");
+    const formatStr = (format) => {
+      return format.replace("YYYY", String(year)).replace("MM", month).replace("DD", day).replace("HH", hours).replace("hh", String(date.getHours() % 12 || 12).padStart(2, "0")).replace("mm", minutes).replace("A", date.getHours() >= 12 ? "PM" : "AM");
+    };
+    return {
+      full: `${formatStr(dateFormat)} ${formatStr(timeFormat)}`,
+      long: formatStr(dateFormat),
+      medium: formatStr(dateFormat.replace("YYYY", String(year).slice(2))),
+      short: `${month}/${day}`,
+      relative: this.getRelativeTime(date)
+    };
+  }
+  getRelativeTime(date) {
+    const now = /* @__PURE__ */ new Date();
+    const diff = now.getTime() - date.getTime();
+    const seconds = Math.floor(diff / 1e3);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (seconds < 60) {
+      return this.t("time.justNow", void 0, { namespace: "system" }) || "just now";
     }
-    clearMissingKeys() {
-        this.missingKeys.clear();
+    if (minutes < 60) {
+      return `${minutes}m ago`;
     }
-    hasKey(key, namespace = 'default') {
-        return (!!this.getEntry(key, namespace, this.currentLocale) ||
-            !!this.getEntry(key, namespace, this.config.fallbackLocale));
+    if (hours < 24) {
+      return `${hours}h ago`;
     }
-    getAllKeys(namespace = 'default') {
-        const keys = new Set();
-        this.namespaces.get(namespace)?.forEach((ns) => {
-            ns.entries.forEach((_, key) => keys.add(key));
-        });
-        return Array.from(keys);
+    if (days < 7) {
+      return `${days}d ago`;
     }
-    // ─── Callbacks ─────────────────────────────────────────
-    setOnLocaleChanged(callback) {
-        this.onLocaleChanged = callback;
+    return this.formatDate(date).long;
+  }
+  // ─── Number Formatting ─────────────────────────────────
+  formatNumber(value) {
+    const { decimalSeparator, thousandsSeparator, currencySymbol, currencyPosition } = this.localeInfo.numberFormat;
+    const formatStandard = (n) => {
+      const [int, dec] = n.toFixed(2).split(".");
+      const formattedInt = int.replace(/\B(?=(\d{3})+(?!\d))/g, thousandsSeparator);
+      return dec && Number(dec) > 0 ? `${formattedInt}${decimalSeparator}${dec}` : formattedInt;
+    };
+    const standard = formatStandard(value);
+    const currency = currencyPosition === "prefix" ? `${currencySymbol}${standard}` : `${standard} ${currencySymbol}`;
+    const percent = `${formatStandard(value * 100)}%`;
+    const compact = this.formatCompact(value);
+    return { standard, currency, percent, compact };
+  }
+  formatCompact(value) {
+    if (value >= 1e9) {
+      return `${(value / 1e9).toFixed(1)}B`;
     }
-    setOnMissingKey(callback) {
-        this.onMissingKey = callback;
+    if (value >= 1e6) {
+      return `${(value / 1e6).toFixed(1)}M`;
     }
-    setOnNamespaceLoaded(callback) {
-        this.onNamespaceLoaded = callback;
+    if (value >= 1e3) {
+      return `${(value / 1e3).toFixed(1)}K`;
     }
+    return String(value);
+  }
+  // ─── Utilities ─────────────────────────────────────────
+  getMissingKeys() {
+    return Array.from(this.missingKeys);
+  }
+  clearMissingKeys() {
+    this.missingKeys.clear();
+  }
+  hasKey(key, namespace = "default") {
+    return !!this.getEntry(key, namespace, this.currentLocale) || !!this.getEntry(key, namespace, this.config.fallbackLocale);
+  }
+  getAllKeys(namespace = "default") {
+    const keys = /* @__PURE__ */ new Set();
+    this.namespaces.get(namespace)?.forEach((ns) => {
+      ns.entries.forEach((_, key) => keys.add(key));
+    });
+    return Array.from(keys);
+  }
+  // ─── Callbacks ─────────────────────────────────────────
+  setOnLocaleChanged(callback) {
+    this.onLocaleChanged = callback;
+  }
+  setOnMissingKey(callback) {
+    this.onMissingKey = callback;
+  }
+  setOnNamespaceLoaded(callback) {
+    this.onNamespaceLoaded = callback;
+  }
 }
-// ============================================================
-// Factory Functions
-// ============================================================
 function createLocalizationRuntime(config) {
-    return new LocalizationRuntime(config);
+  return new LocalizationRuntime(config);
 }
 function createTranslationEntry(key, value, plural) {
-    return { key, value, plural };
+  return { key, value, plural };
 }
-function createLocaleInfo(code, name, nativeName, direction = 'ltr') {
-    return {
-        code,
-        name,
-        nativeName,
-        direction,
-        dateFormat: 'YYYY-MM-DD',
-        timeFormat: 'HH:mm',
-        numberFormat: {
-            decimalSeparator: '.',
-            thousandsSeparator: ',',
-            currencySymbol: '$',
-            currencyPosition: 'prefix',
-        },
-        pluralRules: [
-            { category: 'one', condition: (n) => n === 1 },
-            { category: 'other', condition: () => true },
-        ],
-    };
+function createLocaleInfo(code, name, nativeName, direction = "ltr") {
+  return {
+    code,
+    name,
+    nativeName,
+    direction,
+    dateFormat: "YYYY-MM-DD",
+    timeFormat: "HH:mm",
+    numberFormat: {
+      decimalSeparator: ".",
+      thousandsSeparator: ",",
+      currencySymbol: "$",
+      currencyPosition: "prefix"
+    },
+    pluralRules: [
+      { category: "one", condition: (n) => n === 1 },
+      { category: "other", condition: () => true }
+    ]
+  };
 }
-
 exports.DEFAULT_LOCALIZATION_CONFIG = DEFAULT_LOCALIZATION_CONFIG;
 exports.LOCALES = LOCALES;
 exports.LocalizationRuntime = LocalizationRuntime;