@zachhandley/ez-i18n 0.3.3 → 0.3.4

package/dist/index.d.ts

@@ -2,6 +2,43 @@ import { AstroIntegration } from 'astro';
 import { E as EzI18nConfig } from './types-Cg77gLzO.js';
 export { T as TranslateFunction } from './types-Cg77gLzO.js';
 
+/**
+ * Comprehensive locale database for ez-i18n
+ * Contains display names (in native language) and BCP47 codes
+ */
+interface LocaleInfo {
+    /** Display name in native language */
+    name: string;
+    /** Display name in English */
+    englishName: string;
+    /** BCP47 language tag */
+    bcp47: string;
+    /** Text direction */
+    dir: 'ltr' | 'rtl';
+}
+/**
+ * Comprehensive mapping of locale codes to their metadata
+ * Covers all major languages and regional variants
+ */
+declare const LOCALE_DATABASE: Record<string, LocaleInfo>;
+/**
+ * Get locale info for a given locale code
+ * Falls back to a generated entry if not found
+ */
+declare function getLocaleInfo(locale: string): LocaleInfo;
+/**
+ * Build locale names mapping for discovered locales
+ */
+declare function buildLocaleNames(locales: string[]): Record<string, string>;
+/**
+ * Build locale to BCP47 mapping for discovered locales
+ */
+declare function buildLocaleToBCP47(locales: string[]): Record<string, string>;
+/**
+ * Build locale directions mapping for discovered locales
+ */
+declare function buildLocaleDirections(locales: string[]): Record<string, 'ltr' | 'rtl'>;
+
 /**
  * ez-i18n Astro integration
  *
@@ -26,4 +63,4 @@ export { T as TranslateFunction } from './types-Cg77gLzO.js';
  */
 declare function ezI18n(config: EzI18nConfig): AstroIntegration;
 
-export { EzI18nConfig, ezI18n as default };
+export { EzI18nConfig, LOCALE_DATABASE, type LocaleInfo, buildLocaleDirections, buildLocaleNames, buildLocaleToBCP47, ezI18n as default, getLocaleInfo };

package/dist/index.js

@@ -194,6 +194,168 @@ function __wrapWithNamespace(namespace, content) {
 }`;
 }
 
+// src/utils/locales.ts
+var LOCALE_DATABASE = {
+  // Major Western European Languages
+  en: { name: "English", englishName: "English", bcp47: "en-US", dir: "ltr" },
+  "en-US": { name: "English (US)", englishName: "English (US)", bcp47: "en-US", dir: "ltr" },
+  "en-GB": { name: "English (UK)", englishName: "English (UK)", bcp47: "en-GB", dir: "ltr" },
+  "en-AU": { name: "English (Australia)", englishName: "English (Australia)", bcp47: "en-AU", dir: "ltr" },
+  "en-CA": { name: "English (Canada)", englishName: "English (Canada)", bcp47: "en-CA", dir: "ltr" },
+  de: { name: "Deutsch", englishName: "German", bcp47: "de-DE", dir: "ltr" },
+  "de-DE": { name: "Deutsch (Deutschland)", englishName: "German (Germany)", bcp47: "de-DE", dir: "ltr" },
+  "de-AT": { name: "Deutsch (\xD6sterreich)", englishName: "German (Austria)", bcp47: "de-AT", dir: "ltr" },
+  "de-CH": { name: "Deutsch (Schweiz)", englishName: "German (Switzerland)", bcp47: "de-CH", dir: "ltr" },
+  fr: { name: "Fran\xE7ais", englishName: "French", bcp47: "fr-FR", dir: "ltr" },
+  "fr-FR": { name: "Fran\xE7ais (France)", englishName: "French (France)", bcp47: "fr-FR", dir: "ltr" },
+  "fr-CA": { name: "Fran\xE7ais (Canada)", englishName: "French (Canada)", bcp47: "fr-CA", dir: "ltr" },
+  "fr-BE": { name: "Fran\xE7ais (Belgique)", englishName: "French (Belgium)", bcp47: "fr-BE", dir: "ltr" },
+  "fr-CH": { name: "Fran\xE7ais (Suisse)", englishName: "French (Switzerland)", bcp47: "fr-CH", dir: "ltr" },
+  es: { name: "Espa\xF1ol", englishName: "Spanish", bcp47: "es-ES", dir: "ltr" },
+  "es-ES": { name: "Espa\xF1ol (Espa\xF1a)", englishName: "Spanish (Spain)", bcp47: "es-ES", dir: "ltr" },
+  "es-MX": { name: "Espa\xF1ol (M\xE9xico)", englishName: "Spanish (Mexico)", bcp47: "es-MX", dir: "ltr" },
+  "es-AR": { name: "Espa\xF1ol (Argentina)", englishName: "Spanish (Argentina)", bcp47: "es-AR", dir: "ltr" },
+  "es-CO": { name: "Espa\xF1ol (Colombia)", englishName: "Spanish (Colombia)", bcp47: "es-CO", dir: "ltr" },
+  "es-419": { name: "Espa\xF1ol (Latinoam\xE9rica)", englishName: "Spanish (Latin America)", bcp47: "es-419", dir: "ltr" },
+  it: { name: "Italiano", englishName: "Italian", bcp47: "it-IT", dir: "ltr" },
+  "it-IT": { name: "Italiano (Italia)", englishName: "Italian (Italy)", bcp47: "it-IT", dir: "ltr" },
+  "it-CH": { name: "Italiano (Svizzera)", englishName: "Italian (Switzerland)", bcp47: "it-CH", dir: "ltr" },
+  pt: { name: "Portugu\xEAs", englishName: "Portuguese", bcp47: "pt-PT", dir: "ltr" },
+  "pt-PT": { name: "Portugu\xEAs (Portugal)", englishName: "Portuguese (Portugal)", bcp47: "pt-PT", dir: "ltr" },
+  "pt-BR": { name: "Portugu\xEAs (Brasil)", englishName: "Portuguese (Brazil)", bcp47: "pt-BR", dir: "ltr" },
+  nl: { name: "Nederlands", englishName: "Dutch", bcp47: "nl-NL", dir: "ltr" },
+  "nl-NL": { name: "Nederlands (Nederland)", englishName: "Dutch (Netherlands)", bcp47: "nl-NL", dir: "ltr" },
+  "nl-BE": { name: "Nederlands (Belgi\xEB)", englishName: "Dutch (Belgium)", bcp47: "nl-BE", dir: "ltr" },
+  // Nordic Languages
+  sv: { name: "Svenska", englishName: "Swedish", bcp47: "sv-SE", dir: "ltr" },
+  "sv-SE": { name: "Svenska (Sverige)", englishName: "Swedish (Sweden)", bcp47: "sv-SE", dir: "ltr" },
+  da: { name: "Dansk", englishName: "Danish", bcp47: "da-DK", dir: "ltr" },
+  "da-DK": { name: "Dansk (Danmark)", englishName: "Danish (Denmark)", bcp47: "da-DK", dir: "ltr" },
+  no: { name: "Norsk", englishName: "Norwegian", bcp47: "nb-NO", dir: "ltr" },
+  nb: { name: "Norsk bokm\xE5l", englishName: "Norwegian Bokm\xE5l", bcp47: "nb-NO", dir: "ltr" },
+  nn: { name: "Norsk nynorsk", englishName: "Norwegian Nynorsk", bcp47: "nn-NO", dir: "ltr" },
+  fi: { name: "Suomi", englishName: "Finnish", bcp47: "fi-FI", dir: "ltr" },
+  "fi-FI": { name: "Suomi (Suomi)", englishName: "Finnish (Finland)", bcp47: "fi-FI", dir: "ltr" },
+  is: { name: "\xCDslenska", englishName: "Icelandic", bcp47: "is-IS", dir: "ltr" },
+  // Eastern European Languages
+  pl: { name: "Polski", englishName: "Polish", bcp47: "pl-PL", dir: "ltr" },
+  "pl-PL": { name: "Polski (Polska)", englishName: "Polish (Poland)", bcp47: "pl-PL", dir: "ltr" },
+  cs: { name: "\u010Ce\u0161tina", englishName: "Czech", bcp47: "cs-CZ", dir: "ltr" },
+  "cs-CZ": { name: "\u010Ce\u0161tina (\u010Cesko)", englishName: "Czech (Czech Republic)", bcp47: "cs-CZ", dir: "ltr" },
+  sk: { name: "Sloven\u010Dina", englishName: "Slovak", bcp47: "sk-SK", dir: "ltr" },
+  "sk-SK": { name: "Sloven\u010Dina (Slovensko)", englishName: "Slovak (Slovakia)", bcp47: "sk-SK", dir: "ltr" },
+  hu: { name: "Magyar", englishName: "Hungarian", bcp47: "hu-HU", dir: "ltr" },
+  "hu-HU": { name: "Magyar (Magyarorsz\xE1g)", englishName: "Hungarian (Hungary)", bcp47: "hu-HU", dir: "ltr" },
+  ro: { name: "Rom\xE2n\u0103", englishName: "Romanian", bcp47: "ro-RO", dir: "ltr" },
+  "ro-RO": { name: "Rom\xE2n\u0103 (Rom\xE2nia)", englishName: "Romanian (Romania)", bcp47: "ro-RO", dir: "ltr" },
+  bg: { name: "\u0411\u044A\u043B\u0433\u0430\u0440\u0441\u043A\u0438", englishName: "Bulgarian", bcp47: "bg-BG", dir: "ltr" },
+  "bg-BG": { name: "\u0411\u044A\u043B\u0433\u0430\u0440\u0441\u043A\u0438 (\u0411\u044A\u043B\u0433\u0430\u0440\u0438\u044F)", englishName: "Bulgarian (Bulgaria)", bcp47: "bg-BG", dir: "ltr" },
+  hr: { name: "Hrvatski", englishName: "Croatian", bcp47: "hr-HR", dir: "ltr" },
+  sr: { name: "\u0421\u0440\u043F\u0441\u043A\u0438", englishName: "Serbian", bcp47: "sr-RS", dir: "ltr" },
+  sl: { name: "Sloven\u0161\u010Dina", englishName: "Slovenian", bcp47: "sl-SI", dir: "ltr" },
+  uk: { name: "\u0423\u043A\u0440\u0430\u0457\u043D\u0441\u044C\u043A\u0430", englishName: "Ukrainian", bcp47: "uk-UA", dir: "ltr" },
+  "uk-UA": { name: "\u0423\u043A\u0440\u0430\u0457\u043D\u0441\u044C\u043A\u0430 (\u0423\u043A\u0440\u0430\u0457\u043D\u0430)", englishName: "Ukrainian (Ukraine)", bcp47: "uk-UA", dir: "ltr" },
+  ru: { name: "\u0420\u0443\u0441\u0441\u043A\u0438\u0439", englishName: "Russian", bcp47: "ru-RU", dir: "ltr" },
+  "ru-RU": { name: "\u0420\u0443\u0441\u0441\u043A\u0438\u0439 (\u0420\u043E\u0441\u0441\u0438\u044F)", englishName: "Russian (Russia)", bcp47: "ru-RU", dir: "ltr" },
+  // Baltic Languages
+  lt: { name: "Lietuvi\u0173", englishName: "Lithuanian", bcp47: "lt-LT", dir: "ltr" },
+  lv: { name: "Latvie\u0161u", englishName: "Latvian", bcp47: "lv-LV", dir: "ltr" },
+  et: { name: "Eesti", englishName: "Estonian", bcp47: "et-EE", dir: "ltr" },
+  // Greek
+  el: { name: "\u0395\u03BB\u03BB\u03B7\u03BD\u03B9\u03BA\u03AC", englishName: "Greek", bcp47: "el-GR", dir: "ltr" },
+  "el-GR": { name: "\u0395\u03BB\u03BB\u03B7\u03BD\u03B9\u03BA\u03AC (\u0395\u03BB\u03BB\u03AC\u03B4\u03B1)", englishName: "Greek (Greece)", bcp47: "el-GR", dir: "ltr" },
+  // Asian Languages
+  zh: { name: "\u4E2D\u6587", englishName: "Chinese", bcp47: "zh-CN", dir: "ltr" },
+  "zh-CN": { name: "\u4E2D\u6587 (\u7B80\u4F53)", englishName: "Chinese (Simplified)", bcp47: "zh-CN", dir: "ltr" },
+  "zh-TW": { name: "\u4E2D\u6587 (\u7E41\u9AD4)", englishName: "Chinese (Traditional)", bcp47: "zh-TW", dir: "ltr" },
+  "zh-HK": { name: "\u4E2D\u6587 (\u9999\u6E2F)", englishName: "Chinese (Hong Kong)", bcp47: "zh-HK", dir: "ltr" },
+  ja: { name: "\u65E5\u672C\u8A9E", englishName: "Japanese", bcp47: "ja-JP", dir: "ltr" },
+  "ja-JP": { name: "\u65E5\u672C\u8A9E (\u65E5\u672C)", englishName: "Japanese (Japan)", bcp47: "ja-JP", dir: "ltr" },
+  ko: { name: "\uD55C\uAD6D\uC5B4", englishName: "Korean", bcp47: "ko-KR", dir: "ltr" },
+  "ko-KR": { name: "\uD55C\uAD6D\uC5B4 (\uB300\uD55C\uBBFC\uAD6D)", englishName: "Korean (South Korea)", bcp47: "ko-KR", dir: "ltr" },
+  vi: { name: "Ti\u1EBFng Vi\u1EC7t", englishName: "Vietnamese", bcp47: "vi-VN", dir: "ltr" },
+  "vi-VN": { name: "Ti\u1EBFng Vi\u1EC7t (Vi\u1EC7t Nam)", englishName: "Vietnamese (Vietnam)", bcp47: "vi-VN", dir: "ltr" },
+  th: { name: "\u0E44\u0E17\u0E22", englishName: "Thai", bcp47: "th-TH", dir: "ltr" },
+  "th-TH": { name: "\u0E44\u0E17\u0E22 (\u0E1B\u0E23\u0E30\u0E40\u0E17\u0E28\u0E44\u0E17\u0E22)", englishName: "Thai (Thailand)", bcp47: "th-TH", dir: "ltr" },
+  id: { name: "Bahasa Indonesia", englishName: "Indonesian", bcp47: "id-ID", dir: "ltr" },
+  "id-ID": { name: "Bahasa Indonesia (Indonesia)", englishName: "Indonesian (Indonesia)", bcp47: "id-ID", dir: "ltr" },
+  ms: { name: "Bahasa Melayu", englishName: "Malay", bcp47: "ms-MY", dir: "ltr" },
+  "ms-MY": { name: "Bahasa Melayu (Malaysia)", englishName: "Malay (Malaysia)", bcp47: "ms-MY", dir: "ltr" },
+  tl: { name: "Tagalog", englishName: "Tagalog", bcp47: "tl-PH", dir: "ltr" },
+  fil: { name: "Filipino", englishName: "Filipino", bcp47: "fil-PH", dir: "ltr" },
+  // South Asian Languages
+  hi: { name: "\u0939\u093F\u0928\u094D\u0926\u0940", englishName: "Hindi", bcp47: "hi-IN", dir: "ltr" },
+  "hi-IN": { name: "\u0939\u093F\u0928\u094D\u0926\u0940 (\u092D\u093E\u0930\u0924)", englishName: "Hindi (India)", bcp47: "hi-IN", dir: "ltr" },
+  bn: { name: "\u09AC\u09BE\u0982\u09B2\u09BE", englishName: "Bengali", bcp47: "bn-BD", dir: "ltr" },
+  "bn-BD": { name: "\u09AC\u09BE\u0982\u09B2\u09BE (\u09AC\u09BE\u0982\u09B2\u09BE\u09A6\u09C7\u09B6)", englishName: "Bengali (Bangladesh)", bcp47: "bn-BD", dir: "ltr" },
+  "bn-IN": { name: "\u09AC\u09BE\u0982\u09B2\u09BE (\u09AD\u09BE\u09B0\u09A4)", englishName: "Bengali (India)", bcp47: "bn-IN", dir: "ltr" },
+  ta: { name: "\u0BA4\u0BAE\u0BBF\u0BB4\u0BCD", englishName: "Tamil", bcp47: "ta-IN", dir: "ltr" },
+  te: { name: "\u0C24\u0C46\u0C32\u0C41\u0C17\u0C41", englishName: "Telugu", bcp47: "te-IN", dir: "ltr" },
+  mr: { name: "\u092E\u0930\u093E\u0920\u0940", englishName: "Marathi", bcp47: "mr-IN", dir: "ltr" },
+  gu: { name: "\u0A97\u0AC1\u0A9C\u0AB0\u0ABE\u0AA4\u0AC0", englishName: "Gujarati", bcp47: "gu-IN", dir: "ltr" },
+  kn: { name: "\u0C95\u0CA8\u0CCD\u0CA8\u0CA1", englishName: "Kannada", bcp47: "kn-IN", dir: "ltr" },
+  ml: { name: "\u0D2E\u0D32\u0D2F\u0D3E\u0D33\u0D02", englishName: "Malayalam", bcp47: "ml-IN", dir: "ltr" },
+  pa: { name: "\u0A2A\u0A70\u0A1C\u0A3E\u0A2C\u0A40", englishName: "Punjabi", bcp47: "pa-IN", dir: "ltr" },
+  ur: { name: "\u0627\u0631\u062F\u0648", englishName: "Urdu", bcp47: "ur-PK", dir: "rtl" },
+  // Middle Eastern Languages (RTL)
+  ar: { name: "\u0627\u0644\u0639\u0631\u0628\u064A\u0629", englishName: "Arabic", bcp47: "ar-SA", dir: "rtl" },
+  "ar-SA": { name: "\u0627\u0644\u0639\u0631\u0628\u064A\u0629 (\u0627\u0644\u0633\u0639\u0648\u062F\u064A\u0629)", englishName: "Arabic (Saudi Arabia)", bcp47: "ar-SA", dir: "rtl" },
+  "ar-EG": { name: "\u0627\u0644\u0639\u0631\u0628\u064A\u0629 (\u0645\u0635\u0631)", englishName: "Arabic (Egypt)", bcp47: "ar-EG", dir: "rtl" },
+  "ar-AE": { name: "\u0627\u0644\u0639\u0631\u0628\u064A\u0629 (\u0627\u0644\u0625\u0645\u0627\u0631\u0627\u062A)", englishName: "Arabic (UAE)", bcp47: "ar-AE", dir: "rtl" },
+  he: { name: "\u05E2\u05D1\u05E8\u05D9\u05EA", englishName: "Hebrew", bcp47: "he-IL", dir: "rtl" },
+  "he-IL": { name: "\u05E2\u05D1\u05E8\u05D9\u05EA (\u05D9\u05E9\u05E8\u05D0\u05DC)", englishName: "Hebrew (Israel)", bcp47: "he-IL", dir: "rtl" },
+  fa: { name: "\u0641\u0627\u0631\u0633\u06CC", englishName: "Persian", bcp47: "fa-IR", dir: "rtl" },
+  "fa-IR": { name: "\u0641\u0627\u0631\u0633\u06CC (\u0627\u06CC\u0631\u0627\u0646)", englishName: "Persian (Iran)", bcp47: "fa-IR", dir: "rtl" },
+  tr: { name: "T\xFCrk\xE7e", englishName: "Turkish", bcp47: "tr-TR", dir: "ltr" },
+  "tr-TR": { name: "T\xFCrk\xE7e (T\xFCrkiye)", englishName: "Turkish (Turkey)", bcp47: "tr-TR", dir: "ltr" },
+  // African Languages
+  sw: { name: "Kiswahili", englishName: "Swahili", bcp47: "sw-KE", dir: "ltr" },
+  af: { name: "Afrikaans", englishName: "Afrikaans", bcp47: "af-ZA", dir: "ltr" },
+  zu: { name: "isiZulu", englishName: "Zulu", bcp47: "zu-ZA", dir: "ltr" },
+  // Celtic Languages
+  cy: { name: "Cymraeg", englishName: "Welsh", bcp47: "cy-GB", dir: "ltr" },
+  ga: { name: "Gaeilge", englishName: "Irish", bcp47: "ga-IE", dir: "ltr" },
+  gd: { name: "G\xE0idhlig", englishName: "Scottish Gaelic", bcp47: "gd-GB", dir: "ltr" },
+  // Other European Languages
+  ca: { name: "Catal\xE0", englishName: "Catalan", bcp47: "ca-ES", dir: "ltr" },
+  eu: { name: "Euskara", englishName: "Basque", bcp47: "eu-ES", dir: "ltr" },
+  gl: { name: "Galego", englishName: "Galician", bcp47: "gl-ES", dir: "ltr" },
+  // Constructed Languages
+  eo: { name: "Esperanto", englishName: "Esperanto", bcp47: "eo", dir: "ltr" }
+};
+function getLocaleInfo(locale) {
+  if (LOCALE_DATABASE[locale]) {
+    return LOCALE_DATABASE[locale];
+  }
+  return {
+    name: locale.toUpperCase(),
+    englishName: locale.toUpperCase(),
+    bcp47: locale,
+    dir: "ltr"
+  };
+}
+function buildLocaleNames(locales) {
+  const names = {};
+  for (const locale of locales) {
+    names[locale] = getLocaleInfo(locale).name;
+  }
+  return names;
+}
+function buildLocaleToBCP47(locales) {
+  const bcp47 = {};
+  for (const locale of locales) {
+    bcp47[locale] = getLocaleInfo(locale).bcp47;
+  }
+  return bcp47;
+}
+function buildLocaleDirections(locales) {
+  const dirs = {};
+  for (const locale of locales) {
+    dirs[locale] = getLocaleInfo(locale).dir;
+  }
+  return dirs;
+}
+
 // src/vite-plugin.ts
 import * as path2 from "path";
 var VIRTUAL_CONFIG = "ez-i18n:config";
@@ -319,10 +481,22 @@ function vitePlugin(config) {
     },
     load(id) {
       if (id === RESOLVED_PREFIX + VIRTUAL_CONFIG) {
+        const localeNames = buildLocaleNames(resolved.locales);
+        const localeToBCP47 = buildLocaleToBCP47(resolved.locales);
+        const localeDirections = buildLocaleDirections(resolved.locales);
         return `
 export const locales = ${JSON.stringify(resolved.locales)};
 export const defaultLocale = ${JSON.stringify(resolved.defaultLocale)};
 export const cookieName = ${JSON.stringify(resolved.cookieName)};
+
+/** Display names for each locale (in native language) */
+export const localeNames = ${JSON.stringify(localeNames)};
+
+/** BCP47 language tags for each locale */
+export const localeToBCP47 = ${JSON.stringify(localeToBCP47)};
+
+/** Text direction for each locale ('ltr' or 'rtl') */
+export const localeDirections = ${JSON.stringify(localeDirections)};
 `;
       }
       if (id === RESOLVED_PREFIX + VIRTUAL_RUNTIME) {
@@ -769,6 +943,12 @@ function ezI18n(config) {
   export const defaultLocale: string;
   /** Cookie name used to store locale preference */
   export const cookieName: string;
+  /** Display names for each locale (in native language) */
+  export const localeNames: Record<string, string>;
+  /** BCP47 language tags for each locale */
+  export const localeToBCP47: Record<string, string>;
+  /** Text direction for each locale ('ltr' or 'rtl') */
+  export const localeDirections: Record<string, 'ltr' | 'rtl'>;
 }
 
 declare module 'ez-i18n:runtime' {
@@ -808,5 +988,10 @@ declare module 'ez-i18n:translations' {
   };
 }
 export {
-  ezI18n as default
+  LOCALE_DATABASE,
+  buildLocaleDirections,
+  buildLocaleNames,
+  buildLocaleToBCP47,
+  ezI18n as default,
+  getLocaleInfo
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zachhandley/ez-i18n",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "publishConfig": {
     "access": "public"
   },

package/src/index.ts

@@ -3,6 +3,8 @@ import type { EzI18nConfig } from './types';
 import { vitePlugin, resolveConfig } from './vite-plugin';
 
 export type { EzI18nConfig, TranslateFunction } from './types';
+export { LOCALE_DATABASE, getLocaleInfo, buildLocaleNames, buildLocaleToBCP47, buildLocaleDirections } from './utils/locales';
+export type { LocaleInfo } from './utils/locales';
 
 /**
  * ez-i18n Astro integration
@@ -82,6 +84,12 @@ declare module 'ez-i18n:config' {
   export const defaultLocale: string;
   /** Cookie name used to store locale preference */
   export const cookieName: string;
+  /** Display names for each locale (in native language) */
+  export const localeNames: Record<string, string>;
+  /** BCP47 language tags for each locale */
+  export const localeToBCP47: Record<string, string>;
+  /** Text direction for each locale ('ltr' or 'rtl') */
+  export const localeDirections: Record<string, 'ltr' | 'rtl'>;
 }
 
 declare module 'ez-i18n:runtime' {

package/src/utils/locales.ts

@@ -0,0 +1,240 @@
+/**
+ * Comprehensive locale database for ez-i18n
+ * Contains display names (in native language) and BCP47 codes
+ */
+
+export interface LocaleInfo {
+  /** Display name in native language */
+  name: string;
+  /** Display name in English */
+  englishName: string;
+  /** BCP47 language tag */
+  bcp47: string;
+  /** Text direction */
+  dir: 'ltr' | 'rtl';
+}
+
+/**
+ * Comprehensive mapping of locale codes to their metadata
+ * Covers all major languages and regional variants
+ */
+export const LOCALE_DATABASE: Record<string, LocaleInfo> = {
+  // Major Western European Languages
+  en: { name: 'English', englishName: 'English', bcp47: 'en-US', dir: 'ltr' },
+  'en-US': { name: 'English (US)', englishName: 'English (US)', bcp47: 'en-US', dir: 'ltr' },
+  'en-GB': { name: 'English (UK)', englishName: 'English (UK)', bcp47: 'en-GB', dir: 'ltr' },
+  'en-AU': { name: 'English (Australia)', englishName: 'English (Australia)', bcp47: 'en-AU', dir: 'ltr' },
+  'en-CA': { name: 'English (Canada)', englishName: 'English (Canada)', bcp47: 'en-CA', dir: 'ltr' },
+
+  de: { name: 'Deutsch', englishName: 'German', bcp47: 'de-DE', dir: 'ltr' },
+  'de-DE': { name: 'Deutsch (Deutschland)', englishName: 'German (Germany)', bcp47: 'de-DE', dir: 'ltr' },
+  'de-AT': { name: 'Deutsch (Österreich)', englishName: 'German (Austria)', bcp47: 'de-AT', dir: 'ltr' },
+  'de-CH': { name: 'Deutsch (Schweiz)', englishName: 'German (Switzerland)', bcp47: 'de-CH', dir: 'ltr' },
+
+  fr: { name: 'Français', englishName: 'French', bcp47: 'fr-FR', dir: 'ltr' },
+  'fr-FR': { name: 'Français (France)', englishName: 'French (France)', bcp47: 'fr-FR', dir: 'ltr' },
+  'fr-CA': { name: 'Français (Canada)', englishName: 'French (Canada)', bcp47: 'fr-CA', dir: 'ltr' },
+  'fr-BE': { name: 'Français (Belgique)', englishName: 'French (Belgium)', bcp47: 'fr-BE', dir: 'ltr' },
+  'fr-CH': { name: 'Français (Suisse)', englishName: 'French (Switzerland)', bcp47: 'fr-CH', dir: 'ltr' },
+
+  es: { name: 'Español', englishName: 'Spanish', bcp47: 'es-ES', dir: 'ltr' },
+  'es-ES': { name: 'Español (España)', englishName: 'Spanish (Spain)', bcp47: 'es-ES', dir: 'ltr' },
+  'es-MX': { name: 'Español (México)', englishName: 'Spanish (Mexico)', bcp47: 'es-MX', dir: 'ltr' },
+  'es-AR': { name: 'Español (Argentina)', englishName: 'Spanish (Argentina)', bcp47: 'es-AR', dir: 'ltr' },
+  'es-CO': { name: 'Español (Colombia)', englishName: 'Spanish (Colombia)', bcp47: 'es-CO', dir: 'ltr' },
+  'es-419': { name: 'Español (Latinoamérica)', englishName: 'Spanish (Latin America)', bcp47: 'es-419', dir: 'ltr' },
+
+  it: { name: 'Italiano', englishName: 'Italian', bcp47: 'it-IT', dir: 'ltr' },
+  'it-IT': { name: 'Italiano (Italia)', englishName: 'Italian (Italy)', bcp47: 'it-IT', dir: 'ltr' },
+  'it-CH': { name: 'Italiano (Svizzera)', englishName: 'Italian (Switzerland)', bcp47: 'it-CH', dir: 'ltr' },
+
+  pt: { name: 'Português', englishName: 'Portuguese', bcp47: 'pt-PT', dir: 'ltr' },
+  'pt-PT': { name: 'Português (Portugal)', englishName: 'Portuguese (Portugal)', bcp47: 'pt-PT', dir: 'ltr' },
+  'pt-BR': { name: 'Português (Brasil)', englishName: 'Portuguese (Brazil)', bcp47: 'pt-BR', dir: 'ltr' },
+
+  nl: { name: 'Nederlands', englishName: 'Dutch', bcp47: 'nl-NL', dir: 'ltr' },
+  'nl-NL': { name: 'Nederlands (Nederland)', englishName: 'Dutch (Netherlands)', bcp47: 'nl-NL', dir: 'ltr' },
+  'nl-BE': { name: 'Nederlands (België)', englishName: 'Dutch (Belgium)', bcp47: 'nl-BE', dir: 'ltr' },
+
+  // Nordic Languages
+  sv: { name: 'Svenska', englishName: 'Swedish', bcp47: 'sv-SE', dir: 'ltr' },
+  'sv-SE': { name: 'Svenska (Sverige)', englishName: 'Swedish (Sweden)', bcp47: 'sv-SE', dir: 'ltr' },
+
+  da: { name: 'Dansk', englishName: 'Danish', bcp47: 'da-DK', dir: 'ltr' },
+  'da-DK': { name: 'Dansk (Danmark)', englishName: 'Danish (Denmark)', bcp47: 'da-DK', dir: 'ltr' },
+
+  no: { name: 'Norsk', englishName: 'Norwegian', bcp47: 'nb-NO', dir: 'ltr' },
+  nb: { name: 'Norsk bokmål', englishName: 'Norwegian Bokmål', bcp47: 'nb-NO', dir: 'ltr' },
+  nn: { name: 'Norsk nynorsk', englishName: 'Norwegian Nynorsk', bcp47: 'nn-NO', dir: 'ltr' },
+
+  fi: { name: 'Suomi', englishName: 'Finnish', bcp47: 'fi-FI', dir: 'ltr' },
+  'fi-FI': { name: 'Suomi (Suomi)', englishName: 'Finnish (Finland)', bcp47: 'fi-FI', dir: 'ltr' },
+
+  is: { name: 'Íslenska', englishName: 'Icelandic', bcp47: 'is-IS', dir: 'ltr' },
+
+  // Eastern European Languages
+  pl: { name: 'Polski', englishName: 'Polish', bcp47: 'pl-PL', dir: 'ltr' },
+  'pl-PL': { name: 'Polski (Polska)', englishName: 'Polish (Poland)', bcp47: 'pl-PL', dir: 'ltr' },
+
+  cs: { name: 'Čeština', englishName: 'Czech', bcp47: 'cs-CZ', dir: 'ltr' },
+  'cs-CZ': { name: 'Čeština (Česko)', englishName: 'Czech (Czech Republic)', bcp47: 'cs-CZ', dir: 'ltr' },
+
+  sk: { name: 'Slovenčina', englishName: 'Slovak', bcp47: 'sk-SK', dir: 'ltr' },
+  'sk-SK': { name: 'Slovenčina (Slovensko)', englishName: 'Slovak (Slovakia)', bcp47: 'sk-SK', dir: 'ltr' },
+
+  hu: { name: 'Magyar', englishName: 'Hungarian', bcp47: 'hu-HU', dir: 'ltr' },
+  'hu-HU': { name: 'Magyar (Magyarország)', englishName: 'Hungarian (Hungary)', bcp47: 'hu-HU', dir: 'ltr' },
+
+  ro: { name: 'Română', englishName: 'Romanian', bcp47: 'ro-RO', dir: 'ltr' },
+  'ro-RO': { name: 'Română (România)', englishName: 'Romanian (Romania)', bcp47: 'ro-RO', dir: 'ltr' },
+
+  bg: { name: 'Български', englishName: 'Bulgarian', bcp47: 'bg-BG', dir: 'ltr' },
+  'bg-BG': { name: 'Български (България)', englishName: 'Bulgarian (Bulgaria)', bcp47: 'bg-BG', dir: 'ltr' },
+
+  hr: { name: 'Hrvatski', englishName: 'Croatian', bcp47: 'hr-HR', dir: 'ltr' },
+  sr: { name: 'Српски', englishName: 'Serbian', bcp47: 'sr-RS', dir: 'ltr' },
+  sl: { name: 'Slovenščina', englishName: 'Slovenian', bcp47: 'sl-SI', dir: 'ltr' },
+
+  uk: { name: 'Українська', englishName: 'Ukrainian', bcp47: 'uk-UA', dir: 'ltr' },
+  'uk-UA': { name: 'Українська (Україна)', englishName: 'Ukrainian (Ukraine)', bcp47: 'uk-UA', dir: 'ltr' },
+
+  ru: { name: 'Русский', englishName: 'Russian', bcp47: 'ru-RU', dir: 'ltr' },
+  'ru-RU': { name: 'Русский (Россия)', englishName: 'Russian (Russia)', bcp47: 'ru-RU', dir: 'ltr' },
+
+  // Baltic Languages
+  lt: { name: 'Lietuvių', englishName: 'Lithuanian', bcp47: 'lt-LT', dir: 'ltr' },
+  lv: { name: 'Latviešu', englishName: 'Latvian', bcp47: 'lv-LV', dir: 'ltr' },
+  et: { name: 'Eesti', englishName: 'Estonian', bcp47: 'et-EE', dir: 'ltr' },
+
+  // Greek
+  el: { name: 'Ελληνικά', englishName: 'Greek', bcp47: 'el-GR', dir: 'ltr' },
+  'el-GR': { name: 'Ελληνικά (Ελλάδα)', englishName: 'Greek (Greece)', bcp47: 'el-GR', dir: 'ltr' },
+
+  // Asian Languages
+  zh: { name: '中文', englishName: 'Chinese', bcp47: 'zh-CN', dir: 'ltr' },
+  'zh-CN': { name: '中文 (简体)', englishName: 'Chinese (Simplified)', bcp47: 'zh-CN', dir: 'ltr' },
+  'zh-TW': { name: '中文 (繁體)', englishName: 'Chinese (Traditional)', bcp47: 'zh-TW', dir: 'ltr' },
+  'zh-HK': { name: '中文 (香港)', englishName: 'Chinese (Hong Kong)', bcp47: 'zh-HK', dir: 'ltr' },
+
+  ja: { name: '日本語', englishName: 'Japanese', bcp47: 'ja-JP', dir: 'ltr' },
+  'ja-JP': { name: '日本語 (日本)', englishName: 'Japanese (Japan)', bcp47: 'ja-JP', dir: 'ltr' },
+
+  ko: { name: '한국어', englishName: 'Korean', bcp47: 'ko-KR', dir: 'ltr' },
+  'ko-KR': { name: '한국어 (대한민국)', englishName: 'Korean (South Korea)', bcp47: 'ko-KR', dir: 'ltr' },
+
+  vi: { name: 'Tiếng Việt', englishName: 'Vietnamese', bcp47: 'vi-VN', dir: 'ltr' },
+  'vi-VN': { name: 'Tiếng Việt (Việt Nam)', englishName: 'Vietnamese (Vietnam)', bcp47: 'vi-VN', dir: 'ltr' },
+
+  th: { name: 'ไทย', englishName: 'Thai', bcp47: 'th-TH', dir: 'ltr' },
+  'th-TH': { name: 'ไทย (ประเทศไทย)', englishName: 'Thai (Thailand)', bcp47: 'th-TH', dir: 'ltr' },
+
+  id: { name: 'Bahasa Indonesia', englishName: 'Indonesian', bcp47: 'id-ID', dir: 'ltr' },
+  'id-ID': { name: 'Bahasa Indonesia (Indonesia)', englishName: 'Indonesian (Indonesia)', bcp47: 'id-ID', dir: 'ltr' },
+
+  ms: { name: 'Bahasa Melayu', englishName: 'Malay', bcp47: 'ms-MY', dir: 'ltr' },
+  'ms-MY': { name: 'Bahasa Melayu (Malaysia)', englishName: 'Malay (Malaysia)', bcp47: 'ms-MY', dir: 'ltr' },
+
+  tl: { name: 'Tagalog', englishName: 'Tagalog', bcp47: 'tl-PH', dir: 'ltr' },
+  fil: { name: 'Filipino', englishName: 'Filipino', bcp47: 'fil-PH', dir: 'ltr' },
+
+  // South Asian Languages
+  hi: { name: 'हिन्दी', englishName: 'Hindi', bcp47: 'hi-IN', dir: 'ltr' },
+  'hi-IN': { name: 'हिन्दी (भारत)', englishName: 'Hindi (India)', bcp47: 'hi-IN', dir: 'ltr' },
+
+  bn: { name: 'বাংলা', englishName: 'Bengali', bcp47: 'bn-BD', dir: 'ltr' },
+  'bn-BD': { name: 'বাংলা (বাংলাদেশ)', englishName: 'Bengali (Bangladesh)', bcp47: 'bn-BD', dir: 'ltr' },
+  'bn-IN': { name: 'বাংলা (ভারত)', englishName: 'Bengali (India)', bcp47: 'bn-IN', dir: 'ltr' },
+
+  ta: { name: 'தமிழ்', englishName: 'Tamil', bcp47: 'ta-IN', dir: 'ltr' },
+  te: { name: 'తెలుగు', englishName: 'Telugu', bcp47: 'te-IN', dir: 'ltr' },
+  mr: { name: 'मराठी', englishName: 'Marathi', bcp47: 'mr-IN', dir: 'ltr' },
+  gu: { name: 'ગુજરાતી', englishName: 'Gujarati', bcp47: 'gu-IN', dir: 'ltr' },
+  kn: { name: 'ಕನ್ನಡ', englishName: 'Kannada', bcp47: 'kn-IN', dir: 'ltr' },
+  ml: { name: 'മലയാളം', englishName: 'Malayalam', bcp47: 'ml-IN', dir: 'ltr' },
+  pa: { name: 'ਪੰਜਾਬੀ', englishName: 'Punjabi', bcp47: 'pa-IN', dir: 'ltr' },
+  ur: { name: 'اردو', englishName: 'Urdu', bcp47: 'ur-PK', dir: 'rtl' },
+
+  // Middle Eastern Languages (RTL)
+  ar: { name: 'العربية', englishName: 'Arabic', bcp47: 'ar-SA', dir: 'rtl' },
+  'ar-SA': { name: 'العربية (السعودية)', englishName: 'Arabic (Saudi Arabia)', bcp47: 'ar-SA', dir: 'rtl' },
+  'ar-EG': { name: 'العربية (مصر)', englishName: 'Arabic (Egypt)', bcp47: 'ar-EG', dir: 'rtl' },
+  'ar-AE': { name: 'العربية (الإمارات)', englishName: 'Arabic (UAE)', bcp47: 'ar-AE', dir: 'rtl' },
+
+  he: { name: 'עברית', englishName: 'Hebrew', bcp47: 'he-IL', dir: 'rtl' },
+  'he-IL': { name: 'עברית (ישראל)', englishName: 'Hebrew (Israel)', bcp47: 'he-IL', dir: 'rtl' },
+
+  fa: { name: 'فارسی', englishName: 'Persian', bcp47: 'fa-IR', dir: 'rtl' },
+  'fa-IR': { name: 'فارسی (ایران)', englishName: 'Persian (Iran)', bcp47: 'fa-IR', dir: 'rtl' },
+
+  tr: { name: 'Türkçe', englishName: 'Turkish', bcp47: 'tr-TR', dir: 'ltr' },
+  'tr-TR': { name: 'Türkçe (Türkiye)', englishName: 'Turkish (Turkey)', bcp47: 'tr-TR', dir: 'ltr' },
+
+  // African Languages
+  sw: { name: 'Kiswahili', englishName: 'Swahili', bcp47: 'sw-KE', dir: 'ltr' },
+  af: { name: 'Afrikaans', englishName: 'Afrikaans', bcp47: 'af-ZA', dir: 'ltr' },
+  zu: { name: 'isiZulu', englishName: 'Zulu', bcp47: 'zu-ZA', dir: 'ltr' },
+
+  // Celtic Languages
+  cy: { name: 'Cymraeg', englishName: 'Welsh', bcp47: 'cy-GB', dir: 'ltr' },
+  ga: { name: 'Gaeilge', englishName: 'Irish', bcp47: 'ga-IE', dir: 'ltr' },
+  gd: { name: 'Gàidhlig', englishName: 'Scottish Gaelic', bcp47: 'gd-GB', dir: 'ltr' },
+
+  // Other European Languages
+  ca: { name: 'Català', englishName: 'Catalan', bcp47: 'ca-ES', dir: 'ltr' },
+  eu: { name: 'Euskara', englishName: 'Basque', bcp47: 'eu-ES', dir: 'ltr' },
+  gl: { name: 'Galego', englishName: 'Galician', bcp47: 'gl-ES', dir: 'ltr' },
+
+  // Constructed Languages
+  eo: { name: 'Esperanto', englishName: 'Esperanto', bcp47: 'eo', dir: 'ltr' },
+};
+
+/**
+ * Get locale info for a given locale code
+ * Falls back to a generated entry if not found
+ */
+export function getLocaleInfo(locale: string): LocaleInfo {
+  if (LOCALE_DATABASE[locale]) {
+    return LOCALE_DATABASE[locale];
+  }
+
+  // Generate fallback for unknown locales
+  return {
+    name: locale.toUpperCase(),
+    englishName: locale.toUpperCase(),
+    bcp47: locale,
+    dir: 'ltr',
+  };
+}
+
+/**
+ * Build locale names mapping for discovered locales
+ */
+export function buildLocaleNames(locales: string[]): Record<string, string> {
+  const names: Record<string, string> = {};
+  for (const locale of locales) {
+    names[locale] = getLocaleInfo(locale).name;
+  }
+  return names;
+}
+
+/**
+ * Build locale to BCP47 mapping for discovered locales
+ */
+export function buildLocaleToBCP47(locales: string[]): Record<string, string> {
+  const bcp47: Record<string, string> = {};
+  for (const locale of locales) {
+    bcp47[locale] = getLocaleInfo(locale).bcp47;
+  }
+  return bcp47;
+}
+
+/**
+ * Build locale directions mapping for discovered locales
+ */
+export function buildLocaleDirections(locales: string[]): Record<string, 'ltr' | 'rtl'> {
+  const dirs: Record<string, 'ltr' | 'rtl'> = {};
+  for (const locale of locales) {
+    dirs[locale] = getLocaleInfo(locale).dir;
+  }
+  return dirs;
+}

package/src/virtual.d.ts

@@ -12,6 +12,12 @@ declare module 'ez-i18n:config' {
   export const defaultLocale: string;
   /** Cookie name used to store locale preference */
   export const cookieName: string;
+  /** Display names for each locale (in native language) */
+  export const localeNames: Record<string, string>;
+  /** BCP47 language tags for each locale */
+  export const localeToBCP47: Record<string, string>;
+  /** Text direction for each locale ('ltr' or 'rtl') */
+  export const localeDirections: Record<string, 'ltr' | 'rtl'>;
 }
 
 declare module 'ez-i18n:runtime' {

package/src/vite-plugin.ts

@@ -14,6 +14,11 @@ import {
   toPublicUrl,
   getLocaleBaseDirForNamespace,
 } from './utils/translations';
+import {
+  buildLocaleNames,
+  buildLocaleToBCP47,
+  buildLocaleDirections,
+} from './utils/locales';
 import * as path from 'node:path';
 
 const VIRTUAL_CONFIG = 'ez-i18n:config';
@@ -205,10 +210,23 @@ export function vitePlugin(config: EzI18nConfig): Plugin {
     load(id) {
       // ez-i18n:config - Static config values
       if (id === RESOLVED_PREFIX + VIRTUAL_CONFIG) {
+        const localeNames = buildLocaleNames(resolved.locales);
+        const localeToBCP47 = buildLocaleToBCP47(resolved.locales);
+        const localeDirections = buildLocaleDirections(resolved.locales);
+
         return `
 export const locales = ${JSON.stringify(resolved.locales)};
 export const defaultLocale = ${JSON.stringify(resolved.defaultLocale)};
 export const cookieName = ${JSON.stringify(resolved.cookieName)};
+
+/** Display names for each locale (in native language) */
+export const localeNames = ${JSON.stringify(localeNames)};
+
+/** BCP47 language tags for each locale */
+export const localeToBCP47 = ${JSON.stringify(localeToBCP47)};
+
+/** Text direction for each locale ('ltr' or 'rtl') */
+export const localeDirections = ${JSON.stringify(localeDirections)};
 `;
       }