@zachhandley/ez-i18n 0.3.3 → 0.3.5

package/README.md

@@ -76,6 +76,75 @@ t('common.countdown', { seconds: 5 }); // "Ready in 5 seconds"
 await setLocale('es');
 ```
 
+## Virtual Modules
+
+### `ez-i18n:runtime`
+
+Core translation functions:
+
+```ts
+import { t, locale, setLocale, initLocale } from 'ez-i18n:runtime';
+
+t('key');                    // Translate a key
+t('key', { name: 'World' }); // With interpolation
+locale;                      // Reactive store with current locale
+await setLocale('es');       // Change locale (persists to cookie)
+initLocale('en', data);      // Initialize with translations
+```
+
+### `ez-i18n:config`
+
+Access your i18n configuration:
+
+```ts
+import {
+  locales,          // ['en', 'es', 'fr']
+  defaultLocale,    // 'en'
+  cookieName,       // 'ez-locale'
+  localeNames,      // { en: 'English', es: 'Español', fr: 'Français' }
+  localeToBCP47,    // { en: 'en-US', es: 'es-ES', fr: 'fr-FR' }
+  localeDirections, // { en: 'ltr', es: 'ltr', ar: 'rtl' }
+} from 'ez-i18n:config';
+```
+
+### `ez-i18n:translations`
+
+Dynamic translation loading:
+
+```ts
+import { loadTranslations, translationLoaders } from 'ez-i18n:translations';
+
+const data = await loadTranslations('es');
+```
+
+## Locale Utilities
+
+The package includes a comprehensive locale database with 100+ languages:
+
+```ts
+import {
+  LOCALE_DATABASE,
+  getLocaleInfo,
+  buildLocaleNames,
+  buildLocaleToBCP47,
+  buildLocaleDirections,
+} from '@zachhandley/ez-i18n';
+import type { LocaleInfo } from '@zachhandley/ez-i18n';
+
+// Get info for any locale
+const info = getLocaleInfo('es');
+// { name: 'Español', englishName: 'Spanish', bcp47: 'es-ES', dir: 'ltr' }
+
+// Build mappings for your supported locales
+const names = buildLocaleNames(['en', 'es', 'ar']);
+// { en: 'English', es: 'Español', ar: 'العربية' }
+
+const directions = buildLocaleDirections(['en', 'es', 'ar']);
+// { en: 'ltr', es: 'ltr', ar: 'rtl' }
+```
+
+Includes native display names, English names, BCP47 codes, and text direction (LTR/RTL) for all major languages and regional variants.
+
 ## Framework Bindings
 
 - React: `@zachhandley/ez-i18n-react`

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.5",
   "publishConfig": {
     "access": "public"
   },
@@ -30,7 +30,7 @@
   },
   "files": [
     "dist",
-    "src",
+    "src/components",
     "README.md"
   ],
   "keywords": [

package/src/index.ts

@@ -1,122 +0,0 @@
-import type { AstroIntegration, HookParameters } from 'astro';
-import type { EzI18nConfig } from './types';
-import { vitePlugin, resolveConfig } from './vite-plugin';
-
-export type { EzI18nConfig, TranslateFunction } from './types';
-
-/**
- * ez-i18n Astro integration
- *
- * Provides cookie-based i18n without URL prefixes.
- *
- * @example
- * // astro.config.ts
- * import ezI18n from '@zachhandley/ez-i18n';
- *
- * export default defineConfig({
- *   integrations: [
- *     ezI18n({
- *       locales: ['en', 'es', 'fr'],
- *       defaultLocale: 'en',
- *       translations: {
- *         en: './src/i18n/en.json',
- *         es: './src/i18n/es.json',
- *       },
- *     }),
- *   ],
- * });
- */
-export default function ezI18n(config: EzI18nConfig): AstroIntegration {
-  const resolved = resolveConfig(config);
-
-  return {
-    name: 'ez-i18n',
-    hooks: {
-      'astro:config:setup': ({
-        updateConfig,
-        addMiddleware,
-        injectScript,
-      }: HookParameters<'astro:config:setup'>) => {
-        // Add Vite plugin for virtual modules
-        updateConfig({
-          vite: {
-            plugins: [vitePlugin(config)],
-          },
-        });
-
-        // Add locale detection middleware
-        addMiddleware({
-          entrypoint: '@zachhandley/ez-i18n/middleware',
-          order: 'pre',
-        });
-
-        // Inject hydration script to sync localStorage with cookie
-        // This prevents hydration mismatch when server and client disagree
-        const hydrationScript = `
-(function() {
-  try {
-    var cookieName = ${JSON.stringify(resolved.cookieName)};
-    var stored = localStorage.getItem(cookieName);
-    var cookieMatch = document.cookie.match(new RegExp(cookieName + '=([^;]+)'));
-    var cookie = cookieMatch ? cookieMatch[1] : null;
-    if (cookie && stored !== cookie) {
-      localStorage.setItem(cookieName, cookie);
-    }
-  } catch (e) {}
-})();
-`;
-        injectScript('head-inline', hydrationScript);
-      },
-
-      'astro:config:done': ({
-        injectTypes,
-      }: HookParameters<'astro:config:done'>) => {
-        // Inject type declarations for virtual modules
-        injectTypes({
-          filename: 'virtual.d.ts',
-          content: `\
-declare module 'ez-i18n:config' {
-  /** List of all supported locale codes */
-  export const locales: readonly string[];
-  /** Default locale when no preference is detected */
-  export const defaultLocale: string;
-  /** Cookie name used to store locale preference */
-  export const cookieName: string;
-}
-
-declare module 'ez-i18n:runtime' {
-  import type { ReadableAtom } from 'nanostores';
-  /** Reactive store containing the current locale */
-  export const locale: ReadableAtom<string>;
-  /**
-   * Translate a key to the current locale
-   * @param key - Dot-notation key (e.g., 'common.welcome')
-   * @param params - Optional interpolation params for {placeholder} syntax
-   */
-  export function t(key: string, params?: Record<string, string | number>): string;
-  /**
-   * Set the current locale and persist to cookie/localStorage
-   * @param locale - Locale code to switch to
-   * @param cookieName - Optional custom cookie name
-   */
-  export function setLocale(locale: string, cookieName?: string): Promise<void>;
-  /**
-   * Initialize the locale store with translations
-   * @param locale - Initial locale code
-   * @param translations - Optional initial translations object
-   */
-  export function initLocale(locale: string, translations?: Record<string, unknown>): void;
-}
-
-declare module 'ez-i18n:translations' {
-  /** Load translations for a specific locale */
-  export function loadTranslations(locale: string): Promise<Record<string, unknown>>;
-  /** Get the translation loader map from config */
-  export const translationLoaders: Record<string, () => Promise<{ default: Record<string, unknown> }>>;
-}
-`,
-        });
-      },
-    },
-  };
-}

package/src/middleware.ts

@@ -1,82 +0,0 @@
-import { defineMiddleware } from 'astro:middleware';
-import type { TranslateFunction } from './types';
-
-/**
- * Create a server-side translation function for the given translations object
- */
-function createT(translations: Record<string, unknown>): TranslateFunction {
-  return (key: string, params?: Record<string, string | number>): string => {
-    const keys = key.split('.');
-    let value: unknown = translations;
-    for (const k of keys) {
-      if (value == null || typeof value !== 'object') return key;
-      value = (value as Record<string, unknown>)[k];
-    }
-    if (typeof value !== 'string') return key;
-    if (!params) return value;
-    return value.replace(/\{(\w+)\}/g, (_, p) => String(params[p] ?? `{${p}}`));
-  };
-}
-
-/**
- * Locale detection middleware for ez-i18n
- *
- * Detection priority:
- * 1. ?lang query parameter (allows explicit switching)
- * 2. Cookie value
- * 3. Accept-Language header
- * 4. Default locale
- */
-export const onRequest = defineMiddleware(async ({ cookies, request, locals }, next) => {
-  // Import config from virtual module (provided by vite-plugin)
-  const { locales, defaultLocale, cookieName } = await import('ez-i18n:config');
-
-  const url = new URL(request.url);
-
-  // Priority 1: Query parameter
-  const langParam = url.searchParams.get('lang');
-
-  // Priority 2: Cookie
-  const cookieValue = cookies.get(cookieName)?.value;
-
-  // Priority 3: Accept-Language header
-  const acceptLang = request.headers.get('accept-language');
-  const browserLang = acceptLang?.split(',')[0]?.split('-')[0];
-
-  // Determine locale with priority
-  let locale = defaultLocale;
-
-  if (langParam && locales.includes(langParam)) {
-    locale = langParam;
-  } else if (cookieValue && locales.includes(cookieValue)) {
-    locale = cookieValue;
-  } else if (browserLang && locales.includes(browserLang)) {
-    locale = browserLang;
-  }
-
-  // Set locale on locals for use in pages
-  locals.locale = locale;
-
-  // Load translations for the current locale
-  try {
-    const { loadTranslations } = await import('ez-i18n:translations');
-    locals.translations = await loadTranslations(locale);
-  } catch {
-    // Fallback to empty translations if loader not configured
-    locals.translations = {};
-  }
-
-  // Create server-side translation function
-  locals.t = createT(locals.translations);
-
-  // Update cookie if changed via query param
-  if (langParam && langParam !== cookieValue && locales.includes(langParam)) {
-    cookies.set(cookieName, locale, {
-      path: '/',
-      maxAge: 60 * 60 * 24 * 365, // 1 year
-      sameSite: 'lax',
-    });
-  }
-
-  return next();
-});

package/src/runtime/index.ts

@@ -1,19 +0,0 @@
-/**
- * Runtime exports for ez-i18n
- *
- * This module is imported by the ez-i18n:runtime virtual module
- * and can also be used directly in Vue components
- */
-export {
-  effectiveLocale,
-  translations,
-  localePreference,
-  localeLoading,
-  initLocale,
-  setLocale,
-  setTranslations,
-  getLocale,
-  getTranslations,
-} from './store';
-
-export type { TranslationLoader } from './store';