@coherent.js/i18n 1.0.0-beta.5 → 1.0.0-beta.7

package/dist/locale.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/locale.js"],
+  "sourcesContent": ["/**\n * Coherent.js Locale Utilities\n * \n * Utilities for locale detection and management\n * \n * @module i18n/locale\n */\n\n/**\n * Detect browser locale\n * \n * @returns {string} Detected locale code\n */\nexport function detectLocale() {\n  if (typeof navigator !== 'undefined') {\n    // Try navigator.language first\n    if (navigator.language) {\n      return normalizeLocale(navigator.language);\n    }\n    \n    // Try navigator.languages array\n    if (navigator.languages && navigator.languages.length > 0) {\n      return normalizeLocale(navigator.languages[0]);\n    }\n    \n    // Fallback to userLanguage (IE)\n    if (navigator.userLanguage) {\n      return normalizeLocale(navigator.userLanguage);\n    }\n  }\n  \n  // Default fallback\n  return 'en';\n}\n\n/**\n * Normalize locale code\n * Converts various formats to standard format (e.g., 'en-US' -> 'en')\n * \n * @param {string} locale - Locale code\n * @param {boolean} [keepRegion=false] - Keep region code\n * @returns {string} Normalized locale\n */\nexport function normalizeLocale(locale, keepRegion = false) {\n  if (!locale) return 'en';\n  \n  // Convert to lowercase and replace underscores\n  let normalized = locale.toLowerCase().replace('_', '-');\n  \n  // Extract language code\n  if (!keepRegion && normalized.includes('-')) {\n    normalized = normalized.split('-')[0];\n  }\n  \n  return normalized;\n}\n\n/**\n * Parse locale into components\n * \n * @param {string} locale - Locale code\n * @returns {Object} Parsed locale components\n */\nexport function parseLocale(locale) {\n  const normalized = locale.replace('_', '-');\n  const parts = normalized.split('-');\n  \n  return {\n    language: parts[0]?.toLowerCase() || 'en',\n    region: parts[1]?.toUpperCase() || null,\n    script: parts.length > 2 ? parts[1] : null,\n    full: normalized\n  };\n}\n\n/**\n * Get locale direction (LTR or RTL)\n * \n * @param {string} locale - Locale code\n * @returns {string} 'ltr' or 'rtl'\n */\nexport function getLocaleDirection(locale) {\n  const rtlLocales = ['ar', 'he', 'fa', 'ur', 'yi'];\n  const language = parseLocale(locale).language;\n  \n  return rtlLocales.includes(language) ? 'rtl' : 'ltr';\n}\n\n/**\n * Check if locale is RTL\n * \n * @param {string} locale - Locale code\n * @returns {boolean} True if RTL\n */\nexport function isRTL(locale) {\n  return getLocaleDirection(locale) === 'rtl';\n}\n\n/**\n * Get locale display name\n * \n * @param {string} locale - Locale code\n * @param {string} [displayLocale] - Locale to display name in\n * @returns {string} Display name\n */\nexport function getLocaleDisplayName(locale, displayLocale = 'en') {\n  if (typeof Intl !== 'undefined' && Intl.DisplayNames) {\n    try {\n      const displayNames = new Intl.DisplayNames([displayLocale], { type: 'language' });\n      return displayNames.of(locale);\n    } catch {\n      // Fallback\n    }\n  }\n  \n  // Fallback to locale code\n  return locale;\n}\n\n/**\n * Match locale from available locales\n * Finds best matching locale from available options\n * \n * @param {string} requestedLocale - Requested locale\n * @param {Array<string>} availableLocales - Available locales\n * @param {string} [defaultLocale='en'] - Default fallback\n * @returns {string} Best matching locale\n */\nexport function matchLocale(requestedLocale, availableLocales, defaultLocale = 'en') {\n  const normalized = normalizeLocale(requestedLocale);\n  \n  // Exact match\n  if (availableLocales.includes(normalized)) {\n    return normalized;\n  }\n  \n  // Try with region\n  const withRegion = normalizeLocale(requestedLocale, true);\n  if (availableLocales.includes(withRegion)) {\n    return withRegion;\n  }\n  \n  // Try language match (ignore region)\n  const language = parseLocale(requestedLocale).language;\n  const languageMatch = availableLocales.find(locale => \n    parseLocale(locale).language === language\n  );\n  \n  if (languageMatch) {\n    return languageMatch;\n  }\n  \n  // Fallback to default\n  return availableLocales.includes(defaultLocale) ? defaultLocale : availableLocales[0];\n}\n\n/**\n * Get supported locales from browser\n * \n * @returns {Array<string>} Array of supported locales\n */\nexport function getSupportedLocales() {\n  if (typeof navigator !== 'undefined' && navigator.languages) {\n    return navigator.languages.map(locale => normalizeLocale(locale));\n  }\n  \n  return [detectLocale()];\n}\n\n/**\n * Locale Manager\n * Manages locale state and persistence\n */\nexport class LocaleManager {\n  constructor(options = {}) {\n    this.options = {\n      defaultLocale: 'en',\n      availableLocales: ['en'],\n      storageKey: 'coherent-locale',\n      autoDetect: true,\n      ...options\n    };\n    \n    this.currentLocale = this.options.defaultLocale;\n    this.listeners = [];\n    \n    // Auto-detect or load from storage\n    if (this.options.autoDetect) {\n      this.currentLocale = this.detectAndMatch();\n    }\n    \n    this.loadFromStorage();\n  }\n\n  /**\n   * Detect and match best locale\n   */\n  detectAndMatch() {\n    const detected = detectLocale();\n    return matchLocale(\n      detected,\n      this.options.availableLocales,\n      this.options.defaultLocale\n    );\n  }\n\n  /**\n   * Get current locale\n   */\n  getLocale() {\n    return this.currentLocale;\n  }\n\n  /**\n   * Set locale\n   */\n  setLocale(locale) {\n    const matched = matchLocale(\n      locale,\n      this.options.availableLocales,\n      this.options.defaultLocale\n    );\n    \n    if (matched !== this.currentLocale) {\n      const oldLocale = this.currentLocale;\n      this.currentLocale = matched;\n      \n      this.saveToStorage();\n      this.notifyListeners(oldLocale, matched);\n    }\n  }\n\n  /**\n   * Add locale change listener\n   */\n  onChange(listener) {\n    this.listeners.push(listener);\n    \n    // Return unsubscribe function\n    return () => {\n      const index = this.listeners.indexOf(listener);\n      if (index > -1) {\n        this.listeners.splice(index, 1);\n      }\n    };\n  }\n\n  /**\n   * Notify listeners of locale change\n   */\n  notifyListeners(oldLocale, newLocale) {\n    this.listeners.forEach(listener => {\n      try {\n        listener(newLocale, oldLocale);\n      } catch (error) {\n        console.error('Error in locale change listener:', error);\n      }\n    });\n  }\n\n  /**\n   * Save locale to storage\n   */\n  saveToStorage() {\n    if (typeof localStorage !== 'undefined') {\n      try {\n        localStorage.setItem(this.options.storageKey, this.currentLocale);\n      } catch {\n        // Ignore storage errors\n      }\n    }\n  }\n\n  /**\n   * Load locale from storage\n   */\n  loadFromStorage() {\n    if (typeof localStorage !== 'undefined') {\n      try {\n        const stored = localStorage.getItem(this.options.storageKey);\n        if (stored) {\n          this.setLocale(stored);\n        }\n      } catch {\n        // Ignore storage errors\n      }\n    }\n  }\n\n  /**\n   * Get available locales\n   */\n  getAvailableLocales() {\n    return [...this.options.availableLocales];\n  }\n\n  /**\n   * Check if locale is available\n   */\n  isAvailable(locale) {\n    return this.options.availableLocales.includes(locale);\n  }\n}\n\n/**\n * Create a locale manager\n */\nexport function createLocaleManager(options = {}) {\n  return new LocaleManager(options);\n}\n\nexport default {\n  detectLocale,\n  normalizeLocale,\n  parseLocale,\n  getLocaleDirection,\n  isRTL,\n  getLocaleDisplayName,\n  matchLocale,\n  getSupportedLocales,\n  LocaleManager,\n  createLocaleManager\n};\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/translator.js

@@ -0,0 +1,220 @@
+// src/translator.js
+var Translator = class {
+  constructor(options = {}) {
+    this.options = {
+      defaultLocale: "en",
+      fallbackLocale: "en",
+      missingKeyHandler: null,
+      interpolation: {
+        prefix: "{{",
+        suffix: "}}"
+      },
+      ...options
+    };
+    this.translations = /* @__PURE__ */ new Map();
+    this.currentLocale = this.options.defaultLocale;
+    this.loadedLocales = /* @__PURE__ */ new Set();
+  }
+  /**
+   * Add translations for a locale
+   * 
+   * @param {string} locale - Locale code (e.g., 'en', 'fr', 'es')
+   * @param {Object} translations - Translation object
+   */
+  addTranslations(locale, translations) {
+    if (!this.translations.has(locale)) {
+      this.translations.set(locale, {});
+    }
+    const existing = this.translations.get(locale);
+    this.translations.set(locale, this.deepMerge(existing, translations));
+    this.loadedLocales.add(locale);
+  }
+  /**
+   * Deep merge objects
+   */
+  deepMerge(target, source) {
+    const result = { ...target };
+    for (const [key, value] of Object.entries(source)) {
+      if (value && typeof value === "object" && !Array.isArray(value)) {
+        result[key] = this.deepMerge(result[key] || {}, value);
+      } else {
+        result[key] = value;
+      }
+    }
+    return result;
+  }
+  /**
+   * Set current locale
+   * 
+   * @param {string} locale - Locale code
+   */
+  setLocale(locale) {
+    if (!this.loadedLocales.has(locale)) {
+      console.warn(`Locale ${locale} not loaded, using fallback`);
+      this.currentLocale = this.options.fallbackLocale;
+    } else {
+      this.currentLocale = locale;
+    }
+  }
+  /**
+   * Get current locale
+   * 
+   * @returns {string} Current locale code
+   */
+  getLocale() {
+    return this.currentLocale;
+  }
+  /**
+   * Translate a key
+   * 
+   * @param {string} key - Translation key (supports dot notation)
+   * @param {Object} [params] - Interpolation parameters
+   * @param {string} [locale] - Override locale
+   * @returns {string} Translated string
+   */
+  t(key, params = {}, locale = null) {
+    const targetLocale = locale || this.currentLocale;
+    let translation = this.getTranslation(key, targetLocale);
+    if (translation === null && targetLocale !== this.options.fallbackLocale) {
+      translation = this.getTranslation(key, this.options.fallbackLocale);
+    }
+    if (translation === null) {
+      if (this.options.missingKeyHandler) {
+        return this.options.missingKeyHandler(key, targetLocale);
+      }
+      return key;
+    }
+    if (typeof translation === "object" && params.count !== void 0) {
+      translation = this.selectPlural(translation, params.count, targetLocale);
+    }
+    if (typeof translation === "string") {
+      return this.interpolate(translation, params);
+    }
+    return String(translation);
+  }
+  /**
+   * Get translation from nested object
+   */
+  getTranslation(key, locale) {
+    const translations = this.translations.get(locale);
+    if (!translations) return null;
+    const keys = key.split(".");
+    let value = translations;
+    for (const k of keys) {
+      if (value && typeof value === "object" && k in value) {
+        value = value[k];
+      } else {
+        return null;
+      }
+    }
+    return value;
+  }
+  /**
+   * Select plural form
+   */
+  selectPlural(pluralObject, count, locale) {
+    if (count === 0 && pluralObject.zero) {
+      return pluralObject.zero;
+    }
+    if (typeof Intl !== "undefined" && Intl.PluralRules) {
+      const rules = new Intl.PluralRules(locale);
+      const rule = rules.select(count);
+      if (pluralObject[rule]) {
+        return pluralObject[rule];
+      }
+    }
+    if (count === 1 && pluralObject.one) {
+      return pluralObject.one;
+    } else if (pluralObject.other) {
+      return pluralObject.other;
+    }
+    return pluralObject.one || pluralObject.other || "";
+  }
+  /**
+   * Interpolate parameters into string
+   */
+  interpolate(str, params) {
+    const { prefix, suffix } = this.options.interpolation;
+    let result = str;
+    for (const [key, value] of Object.entries(params)) {
+      const placeholder = `${prefix}${key}${suffix}`;
+      result = result.replace(new RegExp(placeholder, "g"), String(value));
+    }
+    return result;
+  }
+  /**
+   * Check if translation exists
+   * 
+   * @param {string} key - Translation key
+   * @param {string} [locale] - Locale to check
+   * @returns {boolean} True if translation exists
+   */
+  has(key, locale = null) {
+    const targetLocale = locale || this.currentLocale;
+    return this.getTranslation(key, targetLocale) !== null;
+  }
+  /**
+   * Get all translations for current locale
+   * 
+   * @returns {Object} All translations
+   */
+  getTranslations(locale = null) {
+    const targetLocale = locale || this.currentLocale;
+    return this.translations.get(targetLocale) || {};
+  }
+  /**
+   * Get all loaded locales
+   * 
+   * @returns {Array<string>} Array of locale codes
+   */
+  getLoadedLocales() {
+    return Array.from(this.loadedLocales);
+  }
+  /**
+   * Remove translations for a locale
+   * 
+   * @param {string} locale - Locale code
+   */
+  removeLocale(locale) {
+    this.translations.delete(locale);
+    this.loadedLocales.delete(locale);
+    if (this.currentLocale === locale) {
+      this.currentLocale = this.options.defaultLocale;
+    }
+  }
+  /**
+   * Clear all translations
+   */
+  clear() {
+    this.translations.clear();
+    this.loadedLocales.clear();
+    this.currentLocale = this.options.defaultLocale;
+  }
+};
+function createTranslator(options = {}) {
+  return new Translator(options);
+}
+function createScopedTranslator(translator, namespace) {
+  return {
+    t: (key, params, locale) => {
+      return translator.t(`${namespace}.${key}`, params, locale);
+    },
+    has: (key, locale) => {
+      return translator.has(`${namespace}.${key}`, locale);
+    },
+    getLocale: () => translator.getLocale(),
+    setLocale: (locale) => translator.setLocale(locale)
+  };
+}
+var translator_default = {
+  Translator,
+  createTranslator,
+  createScopedTranslator
+};
+export {
+  Translator,
+  createScopedTranslator,
+  createTranslator,
+  translator_default as default
+};
+//# sourceMappingURL=translator.js.map

package/dist/translator.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/translator.js"],
+  "sourcesContent": ["/**\n * Coherent.js Translator\n * \n * Handles translation of strings with interpolation and pluralization\n * \n * @module i18n/translator\n */\n\n/**\n * Translator\n * Manages translations and locale switching\n */\nexport class Translator {\n  constructor(options = {}) {\n    this.options = {\n      defaultLocale: 'en',\n      fallbackLocale: 'en',\n      missingKeyHandler: null,\n      interpolation: {\n        prefix: '{{',\n        suffix: '}}'\n      },\n      ...options\n    };\n    \n    this.translations = new Map();\n    this.currentLocale = this.options.defaultLocale;\n    this.loadedLocales = new Set();\n  }\n\n  /**\n   * Add translations for a locale\n   * \n   * @param {string} locale - Locale code (e.g., 'en', 'fr', 'es')\n   * @param {Object} translations - Translation object\n   */\n  addTranslations(locale, translations) {\n    if (!this.translations.has(locale)) {\n      this.translations.set(locale, {});\n    }\n    \n    const existing = this.translations.get(locale);\n    this.translations.set(locale, this.deepMerge(existing, translations));\n    this.loadedLocales.add(locale);\n  }\n\n  /**\n   * Deep merge objects\n   */\n  deepMerge(target, source) {\n    const result = { ...target };\n    \n    for (const [key, value] of Object.entries(source)) {\n      if (value && typeof value === 'object' && !Array.isArray(value)) {\n        result[key] = this.deepMerge(result[key] || {}, value);\n      } else {\n        result[key] = value;\n      }\n    }\n    \n    return result;\n  }\n\n  /**\n   * Set current locale\n   * \n   * @param {string} locale - Locale code\n   */\n  setLocale(locale) {\n    if (!this.loadedLocales.has(locale)) {\n      console.warn(`Locale ${locale} not loaded, using fallback`);\n      this.currentLocale = this.options.fallbackLocale;\n    } else {\n      this.currentLocale = locale;\n    }\n  }\n\n  /**\n   * Get current locale\n   * \n   * @returns {string} Current locale code\n   */\n  getLocale() {\n    return this.currentLocale;\n  }\n\n  /**\n   * Translate a key\n   * \n   * @param {string} key - Translation key (supports dot notation)\n   * @param {Object} [params] - Interpolation parameters\n   * @param {string} [locale] - Override locale\n   * @returns {string} Translated string\n   */\n  t(key, params = {}, locale = null) {\n    const targetLocale = locale || this.currentLocale;\n    \n    // Get translation\n    let translation = this.getTranslation(key, targetLocale);\n    \n    // Fallback to default locale\n    if (translation === null && targetLocale !== this.options.fallbackLocale) {\n      translation = this.getTranslation(key, this.options.fallbackLocale);\n    }\n    \n    // Handle missing translation\n    if (translation === null) {\n      if (this.options.missingKeyHandler) {\n        return this.options.missingKeyHandler(key, targetLocale);\n      }\n      return key;\n    }\n    \n    // Handle pluralization\n    if (typeof translation === 'object' && params.count !== undefined) {\n      translation = this.selectPlural(translation, params.count, targetLocale);\n    }\n    \n    // Interpolate parameters\n    if (typeof translation === 'string') {\n      return this.interpolate(translation, params);\n    }\n    \n    return String(translation);\n  }\n\n  /**\n   * Get translation from nested object\n   */\n  getTranslation(key, locale) {\n    const translations = this.translations.get(locale);\n    if (!translations) return null;\n    \n    const keys = key.split('.');\n    let value = translations;\n    \n    for (const k of keys) {\n      if (value && typeof value === 'object' && k in value) {\n        value = value[k];\n      } else {\n        return null;\n      }\n    }\n    \n    return value;\n  }\n\n  /**\n   * Select plural form\n   */\n  selectPlural(pluralObject, count, locale) {\n    // Check for explicit zero first (takes precedence over Intl rules)\n    if (count === 0 && pluralObject.zero) {\n      return pluralObject.zero;\n    }\n    \n    // Use Intl.PluralRules for locale-specific pluralization\n    if (typeof Intl !== 'undefined' && Intl.PluralRules) {\n      const rules = new Intl.PluralRules(locale);\n      const rule = rules.select(count);\n      \n      if (pluralObject[rule]) {\n        return pluralObject[rule];\n      }\n    }\n    \n    // Fallback to simple rules\n    if (count === 1 && pluralObject.one) {\n      return pluralObject.one;\n    } else if (pluralObject.other) {\n      return pluralObject.other;\n    }\n    \n    return pluralObject.one || pluralObject.other || '';\n  }\n\n  /**\n   * Interpolate parameters into string\n   */\n  interpolate(str, params) {\n    const { prefix, suffix } = this.options.interpolation;\n    let result = str;\n    \n    for (const [key, value] of Object.entries(params)) {\n      const placeholder = `${prefix}${key}${suffix}`;\n      result = result.replace(new RegExp(placeholder, 'g'), String(value));\n    }\n    \n    return result;\n  }\n\n  /**\n   * Check if translation exists\n   * \n   * @param {string} key - Translation key\n   * @param {string} [locale] - Locale to check\n   * @returns {boolean} True if translation exists\n   */\n  has(key, locale = null) {\n    const targetLocale = locale || this.currentLocale;\n    return this.getTranslation(key, targetLocale) !== null;\n  }\n\n  /**\n   * Get all translations for current locale\n   * \n   * @returns {Object} All translations\n   */\n  getTranslations(locale = null) {\n    const targetLocale = locale || this.currentLocale;\n    return this.translations.get(targetLocale) || {};\n  }\n\n  /**\n   * Get all loaded locales\n   * \n   * @returns {Array<string>} Array of locale codes\n   */\n  getLoadedLocales() {\n    return Array.from(this.loadedLocales);\n  }\n\n  /**\n   * Remove translations for a locale\n   * \n   * @param {string} locale - Locale code\n   */\n  removeLocale(locale) {\n    this.translations.delete(locale);\n    this.loadedLocales.delete(locale);\n    \n    if (this.currentLocale === locale) {\n      this.currentLocale = this.options.defaultLocale;\n    }\n  }\n\n  /**\n   * Clear all translations\n   */\n  clear() {\n    this.translations.clear();\n    this.loadedLocales.clear();\n    this.currentLocale = this.options.defaultLocale;\n  }\n}\n\n/**\n * Create a translator instance\n * \n * @param {Object} [options] - Translator options\n * @returns {Translator} Translator instance\n */\nexport function createTranslator(options = {}) {\n  return new Translator(options);\n}\n\n/**\n * Create a scoped translator\n * Automatically prefixes all keys with a namespace\n * \n * @param {Translator} translator - Base translator\n * @param {string} namespace - Namespace prefix\n * @returns {Object} Scoped translator\n */\nexport function createScopedTranslator(translator, namespace) {\n  return {\n    t: (key, params, locale) => {\n      return translator.t(`${namespace}.${key}`, params, locale);\n    },\n    has: (key, locale) => {\n      return translator.has(`${namespace}.${key}`, locale);\n    },\n    getLocale: () => translator.getLocale(),\n    setLocale: (locale) => translator.setLocale(locale)\n  };\n}\n\nexport default {\n  Translator,\n  createTranslator,\n  createScopedTranslator\n};\n"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coherent.js/i18n",
-  "version": "1.0.0-beta.5",
+  "version": "1.0.0-beta.7",
   "description": "Internationalization support for Coherent.js applications",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,17 +20,25 @@
   "author": "Coherent.js Team",
   "license": "MIT",
   "peerDependencies": {
-    "@coherent.js/core": "1.0.0-beta.5"
+    "@coherent.js/core": "1.0.0-beta.7"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Tomdrouv1/coherent.js.git"
   },
+  "homepage": "https://github.com/Tomdrouv1/coherent.js",
+  "bugs": {
+    "url": "https://github.com/Tomdrouv1/coherent.js/issues"
+  },
   "publishConfig": {
     "access": "public"
   },
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "types": "./types/index.d.ts",
   "files": [
+    "dist/",
     "LICENSE",
     "README.md",
     "types/"
@@ -38,6 +46,8 @@
   "sideEffects": false,
   "scripts": {
     "build": "node build.mjs",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
 }