@geenius/i18n 0.1.0 → 0.3.0

package/packages/shared/dist/index.d.ts

@@ -0,0 +1,77 @@
+type Locale = 'en' | 'fr' | 'de' | 'es' | 'pt' | 'it' | 'nl' | 'ru' | 'zh' | 'ja' | 'ko' | 'ar' | 'he' | 'tr';
+type Direction = 'ltr' | 'rtl';
+type I18nNamespace = 'common' | 'auth' | 'dashboard' | 'billing' | 'errors' | string;
+interface TranslationDict {
+    [key: string]: string | TranslationDict;
+}
+interface I18nConfig {
+    defaultLocale: Locale;
+    supportedLocales: Locale[];
+    fallbackLocale?: Locale;
+    namespaces?: I18nNamespace[];
+    /** Active namespace identifier (used by I18nConfigBuilder) */
+    namespace?: string;
+    detectBrowser?: boolean;
+    persistLocale?: boolean;
+    dateFormat?: string;
+    numberFormat?: Intl.NumberFormatOptions;
+    /** Enable debug mode — logs missing keys and translation lookups */
+    debug?: boolean;
+    /** Show console warnings for missing translation keys */
+    missingKeyWarnings?: boolean;
+    /** Prefix prepended to missing key fallback text */
+    missingKeyPrefix?: string;
+}
+interface LocaleInfo {
+    code: Locale;
+    name: string;
+    nativeName: string;
+    direction: Direction;
+    flag: string;
+}
+interface TranslationEntry {
+    id: string;
+    locale: Locale;
+    namespace: string;
+    key: string;
+    value: string;
+    lastEditedBy?: string;
+    updatedAt: string;
+    createdAt: string;
+}
+interface MissingKey {
+    id: string;
+    locale: Locale;
+    namespace: string;
+    key: string;
+    detectedAt: string;
+    count: number;
+}
+interface LocaleStat {
+    locale: Locale;
+    totalKeys: number;
+    missingKeys: number;
+    coverage: number;
+}
+
+declare const LOCALE_INFO: Record<Locale, LocaleInfo>;
+declare const ALL_LOCALES: Locale[];
+declare const RTL_LOCALES: Locale[];
+declare function interpolate(template: string, params: Record<string, string | number>): string;
+declare function t(key: string, dict: TranslationDict, params?: Record<string, string | number>): string;
+declare function plural(key: string, count: number, dict: TranslationDict): string;
+declare function formatDate(date: Date | string, locale: Locale, format?: Intl.DateTimeFormatOptions): string;
+declare function formatNumber(n: number, locale: Locale, opts?: Intl.NumberFormatOptions): string;
+declare function formatCurrency(amount: number, currency: string, locale: Locale): string;
+declare function detectLocale(supportedLocales: Locale[]): Locale;
+declare function getDirection(locale: Locale): Direction;
+declare function isRTL(locale: Locale): boolean;
+/**
+ * Load a translation namespace for a locale.
+ * Delegates to the default translation loader (fetches from /locales/{locale}/{ns}.json).
+ * Falls back to an empty dict if the fetch fails (e.g., during SSR or when no translations are deployed).
+ */
+declare function loadNamespace(locale: Locale, ns: string): Promise<TranslationDict>;
+declare function flattenDict(dict: TranslationDict, prefix?: string): Record<string, string>;
+
+export { ALL_LOCALES, type Direction, type I18nConfig, type I18nNamespace, LOCALE_INFO, type Locale, type LocaleInfo, type LocaleStat, type MissingKey, RTL_LOCALES, type TranslationDict, type TranslationEntry, detectLocale, flattenDict, formatCurrency, formatDate, formatNumber, getDirection, interpolate, isRTL, loadNamespace, plural, t };

package/packages/shared/dist/index.js

@@ -0,0 +1,158 @@
+// src/config.ts
+function createTranslationLoader(config = {}) {
+  const cache = /* @__PURE__ */ new Map();
+  const {
+    baseUrl = "/locales",
+    cache: enableCache = true,
+    cacheDuration = 36e5
+    // 1 hour
+  } = config;
+  return {
+    /**
+     * Loads translations for a locale and namespace
+     */
+    async load(locale, namespace) {
+      const cacheKey = `${locale}:${namespace}`;
+      if (enableCache) {
+        const cached = cache.get(cacheKey);
+        if (cached && Date.now() - cached.timestamp < cacheDuration) {
+          return cached.data;
+        }
+      }
+      try {
+        const url = `${baseUrl}/${locale}/${namespace}.json`;
+        const response = await fetch(url);
+        if (!response.ok) {
+          console.warn(
+            `Failed to load translations from ${url}: ${response.statusText}`
+          );
+          return {};
+        }
+        const data = await response.json();
+        if (enableCache) {
+          cache.set(cacheKey, {
+            data,
+            timestamp: Date.now()
+          });
+        }
+        return data;
+      } catch (error) {
+        console.error(`Error loading translations for ${locale}/${namespace}:`, error);
+        return {};
+      }
+    },
+    /**
+     * Preloads all locales for a namespace
+     */
+    async preload(locales, namespace) {
+      await Promise.all(locales.map((locale) => this.load(locale, namespace)));
+    },
+    /**
+     * Clears cache
+     */
+    clearCache(locale, namespace) {
+      if (locale && namespace) {
+        cache.delete(`${locale}:${namespace}`);
+      } else {
+        cache.clear();
+      }
+    },
+    /**
+     * Gets cache stats
+     */
+    getCacheStats() {
+      return {
+        size: cache.size,
+        entries: Array.from(cache.keys())
+      };
+    }
+  };
+}
+
+// src/index.ts
+var LOCALE_INFO = {
+  en: { code: "en", name: "English", nativeName: "English", direction: "ltr", flag: "\u{1F1EC}\u{1F1E7}" },
+  fr: { code: "fr", name: "French", nativeName: "Fran\xE7ais", direction: "ltr", flag: "\u{1F1EB}\u{1F1F7}" },
+  de: { code: "de", name: "German", nativeName: "Deutsch", direction: "ltr", flag: "\u{1F1E9}\u{1F1EA}" },
+  es: { code: "es", name: "Spanish", nativeName: "Espa\xF1ol", direction: "ltr", flag: "\u{1F1EA}\u{1F1F8}" },
+  pt: { code: "pt", name: "Portuguese", nativeName: "Portugu\xEAs", direction: "ltr", flag: "\u{1F1F5}\u{1F1F9}" },
+  it: { code: "it", name: "Italian", nativeName: "Italiano", direction: "ltr", flag: "\u{1F1EE}\u{1F1F9}" },
+  nl: { code: "nl", name: "Dutch", nativeName: "Nederlands", direction: "ltr", flag: "\u{1F1F3}\u{1F1F1}" },
+  ru: { code: "ru", name: "Russian", nativeName: "\u0420\u0443\u0441\u0441\u043A\u0438\u0439", direction: "ltr", flag: "\u{1F1F7}\u{1F1FA}" },
+  zh: { code: "zh", name: "Chinese", nativeName: "\u4E2D\u6587", direction: "ltr", flag: "\u{1F1E8}\u{1F1F3}" },
+  ja: { code: "ja", name: "Japanese", nativeName: "\u65E5\u672C\u8A9E", direction: "ltr", flag: "\u{1F1EF}\u{1F1F5}" },
+  ko: { code: "ko", name: "Korean", nativeName: "\uD55C\uAD6D\uC5B4", direction: "ltr", flag: "\u{1F1F0}\u{1F1F7}" },
+  ar: { code: "ar", name: "Arabic", nativeName: "\u0627\u0644\u0639\u0631\u0628\u064A\u0629", direction: "rtl", flag: "\u{1F1F8}\u{1F1E6}" },
+  he: { code: "he", name: "Hebrew", nativeName: "\u05E2\u05D1\u05E8\u05D9\u05EA", direction: "rtl", flag: "\u{1F1EE}\u{1F1F1}" },
+  tr: { code: "tr", name: "Turkish", nativeName: "T\xFCrk\xE7e", direction: "ltr", flag: "\u{1F1F9}\u{1F1F7}" }
+};
+var ALL_LOCALES = Object.keys(LOCALE_INFO);
+var RTL_LOCALES = ["ar", "he"];
+function interpolate(template, params) {
+  return template.replace(/\{\{(\w+)\}\}/g, (_, key) => String(params[key] ?? `{{${key}}}`));
+}
+function t(key, dict, params) {
+  const parts = key.split(".");
+  let current = dict;
+  for (const part of parts) {
+    if (typeof current !== "object" || current === null) return key;
+    current = current[part];
+    if (current === void 0) return key;
+  }
+  if (typeof current !== "string") return key;
+  return params ? interpolate(current, params) : current;
+}
+function plural(key, count, dict) {
+  if (count === 0) {
+    const zero = t(`${key}_zero`, dict);
+    if (zero !== `${key}_zero`) return zero;
+  }
+  if (count === 1) {
+    const one = t(`${key}_one`, dict);
+    if (one !== `${key}_one`) return one;
+  }
+  const other = t(`${key}_other`, dict);
+  if (other !== `${key}_other`) return interpolate(other, { count });
+  return t(key, dict, { count });
+}
+function formatDate(date, locale, format) {
+  const d = typeof date === "string" ? new Date(date) : date;
+  return new Intl.DateTimeFormat(locale, format ?? { dateStyle: "medium" }).format(d);
+}
+function formatNumber(n, locale, opts) {
+  return new Intl.NumberFormat(locale, opts).format(n);
+}
+function formatCurrency(amount, currency, locale) {
+  return new Intl.NumberFormat(locale, { style: "currency", currency }).format(amount);
+}
+function detectLocale(supportedLocales) {
+  if (typeof navigator === "undefined") return supportedLocales[0] ?? "en";
+  const browserLang = navigator.language.split("-")[0];
+  if (supportedLocales.includes(browserLang)) return browserLang;
+  const full = navigator.language;
+  if (supportedLocales.includes(full)) return full;
+  return supportedLocales[0] ?? "en";
+}
+function getDirection(locale) {
+  return LOCALE_INFO[locale]?.direction ?? "ltr";
+}
+function isRTL(locale) {
+  return getDirection(locale) === "rtl";
+}
+var _defaultLoader = createTranslationLoader({ baseUrl: "/locales", cache: true });
+async function loadNamespace(locale, ns) {
+  return _defaultLoader.load(locale, ns);
+}
+function flattenDict(dict, prefix = "") {
+  const result = {};
+  for (const [key, value] of Object.entries(dict)) {
+    const fullKey = prefix ? `${prefix}.${key}` : key;
+    if (typeof value === "string") result[fullKey] = value;
+    else Object.assign(result, flattenDict(value, fullKey));
+  }
+  return result;
+}
+
+export { ALL_LOCALES, LOCALE_INFO, RTL_LOCALES, detectLocale, flattenDict, formatCurrency, formatDate, formatNumber, getDirection, interpolate, isRTL, loadNamespace, plural, t };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/packages/shared/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/index.ts"],"names":[],"mappings":";AA0IO,SAAS,uBAAA,CAAwB,MAAA,GAAkC,EAAC,EAAG;AAC5E,EAAA,MAAM,KAAA,uBAAY,GAAA,EAA0D;AAC5E,EAAA,MAAM;AAAA,IACJ,OAAA,GAAU,UAAA;AAAA,IACV,OAAO,WAAA,GAAc,IAAA;AAAA,IACrB,aAAA,GAAgB;AAAA;AAAA,GAClB,GAAI,MAAA;AAEJ,EAAA,OAAO;AAAA;AAAA;AAAA;AAAA,IAIL,MAAM,IAAA,CAAK,MAAA,EAAgB,SAAA,EAA6C;AACtE,MAAA,MAAM,QAAA,GAAW,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,SAAS,CAAA,CAAA;AAGvC,MAAA,IAAI,WAAA,EAAa;AACf,QAAA,MAAM,MAAA,GAAS,KAAA,CAAM,GAAA,CAAI,QAAQ,CAAA;AACjC,QAAA,IAAI,UAAU,IAAA,CAAK,GAAA,EAAI,GAAI,MAAA,CAAO,YAAY,aAAA,EAAe;AAC3D,UAAA,OAAO,MAAA,CAAO,IAAA;AAAA,QAChB;AAAA,MACF;AAEA,MAAA,IAAI;AACF,QAAA,MAAM,MAAM,CAAA,EAAG,OAAO,CAAA,CAAA,EAAI,MAAM,IAAI,SAAS,CAAA,KAAA,CAAA;AAC7C,QAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAG,CAAA;AAEhC,QAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,UAAA,OAAA,CAAQ,IAAA;AAAA,YACN,CAAA,iCAAA,EAAoC,GAAG,CAAA,EAAA,EAAK,QAAA,CAAS,UAAU,CAAA;AAAA,WACjE;AACA,UAAA,OAAO,EAAC;AAAA,QACV;AAEA,QAAA,MAAM,IAAA,GAAQ,MAAM,QAAA,CAAS,IAAA,EAAK;AAGlC,QAAA,IAAI,WAAA,EAAa;AACf,UAAA,KAAA,CAAM,IAAI,QAAA,EAAU;AAAA,YAClB,IAAA;AAAA,YACA,SAAA,EAAW,KAAK,GAAA;AAAI,WACrB,CAAA;AAAA,QACH;AAEA,QAAA,OAAO,IAAA;AAAA,MACT,SAAS,KAAA,EAAO;AACd,QAAA,OAAA,CAAQ,MAAM,CAAA,+BAAA,EAAkC,MAAM,CAAA,CAAA,EAAI,SAAS,KAAK,KAAK,CAAA;AAC7E,QAAA,OAAO,EAAC;AAAA,MACV;AAAA,IACF,CAAA;AAAA;AAAA;AAAA;AAAA,IAKA,MAAM,OAAA,CAAQ,OAAA,EAAmB,SAAA,EAAkC;AACjE,MAAA,MAAM,OAAA,CAAQ,GAAA,CAAI,OAAA,CAAQ,GAAA,CAAI,CAAC,MAAA,KAAW,IAAA,CAAK,IAAA,CAAK,MAAA,EAAQ,SAAS,CAAC,CAAC,CAAA;AAAA,IACzE,CAAA;AAAA;AAAA;AAAA;AAAA,IAKA,UAAA,CAAW,QAAiB,SAAA,EAAoB;AAC9C,MAAA,IAAI,UAAU,SAAA,EAAW;AACvB,QAAA,KAAA,CAAM,MAAA,CAAO,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,SAAS,CAAA,CAAE,CAAA;AAAA,MACvC,CAAA,MAAO;AACL,QAAA,KAAA,CAAM,KAAA,EAAM;AAAA,MACd;AAAA,IACF,CAAA;AAAA;AAAA;AAAA;AAAA,IAKA,aAAA,GAAgB;AACd,MAAA,OAAO;AAAA,QACL,MAAM,KAAA,CAAM,IAAA;AAAA,QACZ,OAAA,EAAS,KAAA,CAAM,IAAA,CAAK,KAAA,CAAM,MAAM;AAAA,OAClC;AAAA,IACF;AAAA,GACF;AACF;;;ACjNO,IAAM,WAAA,GAA0C;AAAA,EACrD,EAAA,EAAI,EAAE,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,SAAA,EAAW,UAAA,EAAY,SAAA,EAAW,SAAA,EAAW,KAAA,EAAO,IAAA,EAAM,oBAAA,EAAO;AAAA,EACzF,EAAA,EAAI,EAAE,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,QAAA,EAAU,UAAA,EAAY,aAAA,EAAY,SAAA,EAAW,KAAA,EAAO,IAAA,EAAM,oBAAA,EAAO;AAAA,EACzF,EAAA,EAAI,EAAE,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,QAAA,EAAU,UAAA,EAAY,SAAA,EAAW,SAAA,EAAW,KAAA,EAAO,IAAA,EAAM,oBAAA,EAAO;AAAA,EACxF,EAAA,EAAI,EAAE,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,SAAA,EAAW,UAAA,EAAY,YAAA,EAAW,SAAA,EAAW,KAAA,EAAO,IAAA,EAAM,oBAAA,EAAO;AAAA,EACzF,EAAA,EAAI,EAAE,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,YAAA,EAAc,UAAA,EAAY,cAAA,EAAa,SAAA,EAAW,KAAA,EAAO,IAAA,EAAM,oBAAA,EAAO;AAAA,EAC9F,EAAA,EAAI,EAAE,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,SAAA,EAAW,UAAA,EAAY,UAAA,EAAY,SAAA,EAAW,KAAA,EAAO,IAAA,EAAM,oBAAA,EAAO;AAAA,EAC1F,EAAA,EAAI,EAAE,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,OAAA,EAAS,UAAA,EAAY,YAAA,EAAc,SAAA,EAAW,KAAA,EAAO,IAAA,EAAM,oBAAA,EAAO;AAAA,EAC1F,EAAA,EAAI,EAAE,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,SAAA,EAAW,UAAA,EAAY,4CAAA,EAAW,SAAA,EAAW,KAAA,EAAO,IAAA,EAAM,oBAAA,EAAO;AAAA,EACzF,EAAA,EAAI,EAAE,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,SAAA,EAAW,UAAA,EAAY,cAAA,EAAM,SAAA,EAAW,KAAA,EAAO,IAAA,EAAM,oBAAA,EAAO;AAAA,EACpF,EAAA,EAAI,EAAE,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,UAAA,EAAY,UAAA,EAAY,oBAAA,EAAO,SAAA,EAAW,KAAA,EAAO,IAAA,EAAM,oBAAA,EAAO;AAAA,EACtF,EAAA,EAAI,EAAE,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,QAAA,EAAU,UAAA,EAAY,oBAAA,EAAO,SAAA,EAAW,KAAA,EAAO,IAAA,EAAM,oBAAA,EAAO;AAAA,EACpF,EAAA,EAAI,EAAE,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,QAAA,EAAU,UAAA,EAAY,4CAAA,EAAW,SAAA,EAAW,KAAA,EAAO,IAAA,EAAM,oBAAA,EAAO;AAAA,EACxF,EAAA,EAAI,EAAE,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,QAAA,EAAU,UAAA,EAAY,gCAAA,EAAS,SAAA,EAAW,KAAA,EAAO,IAAA,EAAM,oBAAA,EAAO;AAAA,EACtF,EAAA,EAAI,EAAE,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,SAAA,EAAW,UAAA,EAAY,cAAA,EAAU,SAAA,EAAW,KAAA,EAAO,IAAA,EAAM,oBAAA;AACnF;AAEO,IAAM,WAAA,GAAwB,MAAA,CAAO,IAAA,CAAK,WAAW;AACrD,IAAM,WAAA,GAAwB,CAAC,IAAA,EAAM,IAAI;AAGzC,SAAS,WAAA,CAAY,UAAkB,MAAA,EAAiD;AAC7F,EAAA,OAAO,QAAA,CAAS,OAAA,CAAQ,gBAAA,EAAkB,CAAC,CAAA,EAAG,GAAA,KAAQ,MAAA,CAAO,MAAA,CAAO,GAAG,CAAA,IAAK,CAAA,EAAA,EAAK,GAAG,IAAI,CAAC,CAAA;AAC3F;AAEO,SAAS,CAAA,CAAE,GAAA,EAAa,IAAA,EAAuB,MAAA,EAAkD;AACtG,EAAA,MAAM,KAAA,GAAQ,GAAA,CAAI,KAAA,CAAM,GAAG,CAAA;AAC3B,EAAA,IAAI,OAAA,GAAoC,IAAA;AACxC,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,IAAA,IAAI,OAAO,OAAA,KAAY,QAAA,IAAY,OAAA,KAAY,MAAM,OAAO,GAAA;AAC5D,IAAA,OAAA,GAAW,QAA4B,IAAI,CAAA;AAC3C,IAAA,IAAI,OAAA,KAAY,QAAW,OAAO,GAAA;AAAA,EACpC;AACA,EAAA,IAAI,OAAO,OAAA,KAAY,QAAA,EAAU,OAAO,GAAA;AACxC,EAAA,OAAO,MAAA,GAAS,WAAA,CAAY,OAAA,EAAS,MAAM,CAAA,GAAI,OAAA;AACjD;AAEO,SAAS,MAAA,CAAO,GAAA,EAAa,KAAA,EAAe,IAAA,EAA+B;AAChF,EAAA,IAAI,UAAU,CAAA,EAAG;AAAE,IAAA,MAAM,IAAA,GAAO,CAAA,CAAE,CAAA,EAAG,GAAG,SAAS,IAAI,CAAA;AAAG,IAAA,IAAI,IAAA,KAAS,CAAA,EAAG,GAAG,CAAA,KAAA,CAAA,EAAS,OAAO,IAAA;AAAA,EAAK;AAChG,EAAA,IAAI,UAAU,CAAA,EAAG;AAAE,IAAA,MAAM,GAAA,GAAM,CAAA,CAAE,CAAA,EAAG,GAAG,QAAQ,IAAI,CAAA;AAAG,IAAA,IAAI,GAAA,KAAQ,CAAA,EAAG,GAAG,CAAA,IAAA,CAAA,EAAQ,OAAO,GAAA;AAAA,EAAI;AAC3F,EAAA,MAAM,KAAA,GAAQ,CAAA,CAAE,CAAA,EAAG,GAAG,UAAU,IAAI,CAAA;AACpC,EAAA,IAAI,KAAA,KAAU,GAAG,GAAG,CAAA,MAAA,CAAA,SAAiB,WAAA,CAAY,KAAA,EAAO,EAAE,KAAA,EAAO,CAAA;AACjE,EAAA,OAAO,CAAA,CAAE,GAAA,EAAK,IAAA,EAAM,EAAE,OAAO,CAAA;AAC/B;AAGO,SAAS,UAAA,CAAW,IAAA,EAAqB,MAAA,EAAgB,MAAA,EAA6C;AAC3G,EAAA,MAAM,IAAI,OAAO,IAAA,KAAS,WAAW,IAAI,IAAA,CAAK,IAAI,CAAA,GAAI,IAAA;AACtD,EAAA,OAAO,IAAI,IAAA,CAAK,cAAA,CAAe,MAAA,EAAQ,MAAA,IAAU,EAAE,SAAA,EAAW,QAAA,EAAU,CAAA,CAAE,MAAA,CAAO,CAAC,CAAA;AACpF;AAEO,SAAS,YAAA,CAAa,CAAA,EAAW,MAAA,EAAgB,IAAA,EAAyC;AAC/F,EAAA,OAAO,IAAI,IAAA,CAAK,YAAA,CAAa,QAAQ,IAAI,CAAA,CAAE,OAAO,CAAC,CAAA;AACrD;AAEO,SAAS,cAAA,CAAe,MAAA,EAAgB,QAAA,EAAkB,MAAA,EAAwB;AACvF,EAAA,OAAO,IAAI,IAAA,CAAK,YAAA,CAAa,MAAA,EAAQ,EAAE,KAAA,EAAO,UAAA,EAAY,QAAA,EAAU,CAAA,CAAE,MAAA,CAAO,MAAM,CAAA;AACrF;AAGO,SAAS,aAAa,gBAAA,EAAoC;AAC/D,EAAA,IAAI,OAAO,SAAA,KAAc,WAAA,EAAa,OAAO,gBAAA,CAAiB,CAAC,CAAA,IAAK,IAAA;AACpE,EAAA,MAAM,cAAc,SAAA,CAAU,QAAA,CAAS,KAAA,CAAM,GAAG,EAAE,CAAC,CAAA;AACnD,EAAA,IAAI,gBAAA,CAAiB,QAAA,CAAS,WAAW,CAAA,EAAG,OAAO,WAAA;AACnD,EAAA,MAAM,OAAO,SAAA,CAAU,QAAA;AACvB,EAAA,IAAI,gBAAA,CAAiB,QAAA,CAAS,IAAI,CAAA,EAAG,OAAO,IAAA;AAC5C,EAAA,OAAO,gBAAA,CAAiB,CAAC,CAAA,IAAK,IAAA;AAChC;AAEO,SAAS,aAAa,MAAA,EAA2B;AACtD,EAAA,OAAO,WAAA,CAAY,MAAM,CAAA,EAAG,SAAA,IAAa,KAAA;AAC3C;AAEO,SAAS,MAAM,MAAA,EAAyB;AAC7C,EAAA,OAAO,YAAA,CAAa,MAAM,CAAA,KAAM,KAAA;AAClC;AAKA,IAAM,iBAAiB,uBAAA,CAAwB,EAAE,SAAS,UAAA,EAAY,KAAA,EAAO,MAAM,CAAA;AAOnF,eAAsB,aAAA,CAAc,QAAgB,EAAA,EAAsC;AACxF,EAAA,OAAO,cAAA,CAAe,IAAA,CAAK,MAAA,EAAQ,EAAE,CAAA;AACvC;AAEO,SAAS,WAAA,CAAY,IAAA,EAAuB,MAAA,GAAS,EAAA,EAA4B;AACtF,EAAA,MAAM,SAAiC,EAAC;AACxC,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,IAAI,CAAA,EAAG;AAC/C,IAAA,MAAM,UAAU,MAAA,GAAS,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,GAAG,CAAA,CAAA,GAAK,GAAA;AAC9C,IAAA,IAAI,OAAO,KAAA,KAAU,QAAA,EAAU,MAAA,CAAO,OAAO,CAAA,GAAI,KAAA;AAAA,gBACrC,MAAA,CAAO,MAAA,EAAQ,WAAA,CAAY,KAAA,EAAO,OAAO,CAAC,CAAA;AAAA,EACxD;AACA,EAAA,OAAO,MAAA;AACT","file":"index.js","sourcesContent":["/**\n * I18n configuration and setup\n */\n\nimport type { Locale, I18nConfig, TranslationDict } from './types'\n\n/**\n * I18n configuration builder\n *\n * @example\n * ```ts\n * const i18nConfig = createI18nConfig()\n *   .withDefaultLocale('en')\n *   .withSupportedLocales(['en', 'fr', 'de'])\n *   .withFallbackLocale('en')\n *   .withNamespace('common')\n * ```\n */\nexport class I18nConfigBuilder {\n  private config: I18nConfig = {\n    defaultLocale: 'en',\n    supportedLocales: ['en'],\n    fallbackLocale: 'en',\n    namespace: 'translations',\n    debug: false,\n  }\n\n  /**\n   * Sets default locale\n   */\n  withDefaultLocale(locale: Locale): this {\n    this.config.defaultLocale = locale\n    return this\n  }\n\n  /**\n   * Sets supported locales\n   */\n  withSupportedLocales(locales: Locale[]): this {\n    this.config.supportedLocales = locales\n    return this\n  }\n\n  /**\n   * Sets fallback locale when translation is missing\n   */\n  withFallbackLocale(locale: Locale): this {\n    this.config.fallbackLocale = locale\n    return this\n  }\n\n  /**\n   * Sets translation namespace\n   */\n  withNamespace(namespace: string): this {\n    this.config.namespace = namespace\n    return this\n  }\n\n  /**\n   * Sets debug mode\n   */\n  withDebug(enabled: boolean): this {\n    this.config.debug = enabled\n    return this\n  }\n\n  /**\n   * Enables missing key warnings\n   */\n  withMissingKeyWarnings(enabled: boolean): this {\n    this.config.missingKeyWarnings = enabled\n    return this\n  }\n\n  /**\n   * Sets missing key prefix\n   */\n  withMissingKeyPrefix(prefix: string): this {\n    this.config.missingKeyPrefix = prefix\n    return this\n  }\n\n  /**\n   * Builds the configuration\n   */\n  build(): I18nConfig {\n    if (!this.config.supportedLocales.includes(this.config.defaultLocale)) {\n      throw new Error(\n        `Default locale ${this.config.defaultLocale} must be in supported locales`\n      )\n    }\n\n    if (!this.config.supportedLocales.includes(this.config.fallbackLocale)) {\n      throw new Error(\n        `Fallback locale ${this.config.fallbackLocale} must be in supported locales`\n      )\n    }\n\n    return this.config\n  }\n}\n\n/**\n * Creates a new I18n configuration builder\n */\nexport function createI18nConfig(): I18nConfigBuilder {\n  return new I18nConfigBuilder()\n}\n\n/**\n * Translation loader configuration\n */\nexport interface TranslationLoaderConfig {\n  /** Base URL for loading translations */\n  baseUrl?: string\n  /** Whether to cache loaded translations */\n  cache?: boolean\n  /** Cache duration in milliseconds */\n  cacheDuration?: number\n  /** Whether to load all locales on init */\n  preloadAll?: boolean\n}\n\n/**\n * Creates a translation loader\n *\n * @example\n * ```ts\n * const loader = createTranslationLoader({\n *   baseUrl: '/locales',\n *   cache: true,\n *   cacheDuration: 3600000\n * })\n *\n * const translations = await loader.load('en', 'common')\n * ```\n */\nexport function createTranslationLoader(config: TranslationLoaderConfig = {}) {\n  const cache = new Map<string, { data: TranslationDict; timestamp: number }>()\n  const {\n    baseUrl = '/locales',\n    cache: enableCache = true,\n    cacheDuration = 3600000, // 1 hour\n  } = config\n\n  return {\n    /**\n     * Loads translations for a locale and namespace\n     */\n    async load(locale: Locale, namespace: string): Promise<TranslationDict> {\n      const cacheKey = `${locale}:${namespace}`\n\n      // Check cache\n      if (enableCache) {\n        const cached = cache.get(cacheKey)\n        if (cached && Date.now() - cached.timestamp < cacheDuration) {\n          return cached.data\n        }\n      }\n\n      try {\n        const url = `${baseUrl}/${locale}/${namespace}.json`\n        const response = await fetch(url)\n\n        if (!response.ok) {\n          console.warn(\n            `Failed to load translations from ${url}: ${response.statusText}`\n          )\n          return {}\n        }\n\n        const data = (await response.json()) as TranslationDict\n\n        // Cache result\n        if (enableCache) {\n          cache.set(cacheKey, {\n            data,\n            timestamp: Date.now(),\n          })\n        }\n\n        return data\n      } catch (error) {\n        console.error(`Error loading translations for ${locale}/${namespace}:`, error)\n        return {}\n      }\n    },\n\n    /**\n     * Preloads all locales for a namespace\n     */\n    async preload(locales: Locale[], namespace: string): Promise<void> {\n      await Promise.all(locales.map((locale) => this.load(locale, namespace)))\n    },\n\n    /**\n     * Clears cache\n     */\n    clearCache(locale?: Locale, namespace?: string) {\n      if (locale && namespace) {\n        cache.delete(`${locale}:${namespace}`)\n      } else {\n        cache.clear()\n      }\n    },\n\n    /**\n     * Gets cache stats\n     */\n    getCacheStats() {\n      return {\n        size: cache.size,\n        entries: Array.from(cache.keys()),\n      }\n    },\n  }\n}\n\n/**\n * Namespace loader for managing multiple translation namespaces\n *\n * @example\n * ```ts\n * const loader = createNamespaceLoader(createTranslationLoader())\n * const translations = await loader.loadMultiple('en', ['common', 'errors'])\n * ```\n */\nexport function createNamespaceLoader(\n  translationLoader: ReturnType<typeof createTranslationLoader>\n) {\n  const namespaces = new Map<string, TranslationDict>()\n\n  return {\n    /**\n     * Loads a single namespace\n     */\n    async load(locale: Locale, namespace: string): Promise<TranslationDict> {\n      const translations = await translationLoader.load(locale, namespace)\n      const key = `${locale}:${namespace}`\n      namespaces.set(key, translations)\n      return translations\n    },\n\n    /**\n     * Loads multiple namespaces\n     */\n    async loadMultiple(\n      locale: Locale,\n      namespaceList: string[]\n    ): Promise<Record<string, TranslationDict>> {\n      const result: Record<string, TranslationDict> = {}\n\n      for (const ns of namespaceList) {\n        result[ns] = await this.load(locale, ns)\n      }\n\n      return result\n    },\n\n    /**\n     * Gets loaded namespace\n     */\n    get(locale: Locale, namespace: string): TranslationDict | undefined {\n      return namespaces.get(`${locale}:${namespace}`)\n    },\n\n    /**\n     * Merges multiple translations into one\n     */\n    merge(\n      locale: Locale,\n      namespaceList: string[]\n    ): TranslationDict {\n      const merged: TranslationDict = {}\n\n      for (const ns of namespaceList) {\n        const trans = this.get(locale, ns)\n        if (trans) {\n          Object.assign(merged, trans)\n        }\n      }\n\n      return merged\n    },\n  }\n}\n\n/**\n * Default i18n configurations for different scenarios\n */\nexport const i18nPresets = {\n  /**\n   * Simple single-language setup\n   */\n  simple: (locale: Locale = 'en'): I18nConfig => {\n    return createI18nConfig()\n      .withDefaultLocale(locale)\n      .withSupportedLocales([locale])\n      .withFallbackLocale(locale)\n      .build()\n  },\n\n  /**\n   * Multi-language with common locales\n   */\n  multi: (defaultLocale: Locale = 'en'): I18nConfig => {\n    return createI18nConfig()\n      .withDefaultLocale(defaultLocale)\n      .withSupportedLocales(['en', 'fr', 'de', 'es', 'it'])\n      .build()\n  },\n\n  /**\n   * Global localization\n   */\n  global: (defaultLocale: Locale = 'en'): I18nConfig => {\n    return createI18nConfig()\n      .withDefaultLocale(defaultLocale)\n      .withSupportedLocales([\n        'en',\n        'fr',\n        'de',\n        'es',\n        'it',\n        'pt',\n        'ru',\n        'zh',\n        'ja',\n        'ko',\n      ] as Locale[])\n      .build()\n  },\n\n  /**\n   * Development configuration with debug output\n   */\n  development: (): I18nConfig => {\n    return createI18nConfig()\n      .withDebug(true)\n      .withMissingKeyWarnings(true)\n      .withMissingKeyPrefix('[MISSING] ')\n      .build()\n  },\n}\n","export type {\n  Locale, Direction, I18nNamespace, TranslationDict, I18nConfig,\n  LocaleInfo, TranslationEntry, MissingKey, LocaleStat,\n} from './types'\n\nimport type { Locale, Direction, LocaleInfo, TranslationDict } from './types'\n\n// ─── LOCALE_INFO (14 locales) ─────────────────────────\nexport const LOCALE_INFO: Record<Locale, LocaleInfo> = {\n  en: { code: 'en', name: 'English', nativeName: 'English', direction: 'ltr', flag: '🇬🇧' },\n  fr: { code: 'fr', name: 'French', nativeName: 'Français', direction: 'ltr', flag: '🇫🇷' },\n  de: { code: 'de', name: 'German', nativeName: 'Deutsch', direction: 'ltr', flag: '🇩🇪' },\n  es: { code: 'es', name: 'Spanish', nativeName: 'Español', direction: 'ltr', flag: '🇪🇸' },\n  pt: { code: 'pt', name: 'Portuguese', nativeName: 'Português', direction: 'ltr', flag: '🇵🇹' },\n  it: { code: 'it', name: 'Italian', nativeName: 'Italiano', direction: 'ltr', flag: '🇮🇹' },\n  nl: { code: 'nl', name: 'Dutch', nativeName: 'Nederlands', direction: 'ltr', flag: '🇳🇱' },\n  ru: { code: 'ru', name: 'Russian', nativeName: 'Русский', direction: 'ltr', flag: '🇷🇺' },\n  zh: { code: 'zh', name: 'Chinese', nativeName: '中文', direction: 'ltr', flag: '🇨🇳' },\n  ja: { code: 'ja', name: 'Japanese', nativeName: '日本語', direction: 'ltr', flag: '🇯🇵' },\n  ko: { code: 'ko', name: 'Korean', nativeName: '한국어', direction: 'ltr', flag: '🇰🇷' },\n  ar: { code: 'ar', name: 'Arabic', nativeName: 'العربية', direction: 'rtl', flag: '🇸🇦' },\n  he: { code: 'he', name: 'Hebrew', nativeName: 'עברית', direction: 'rtl', flag: '🇮🇱' },\n  tr: { code: 'tr', name: 'Turkish', nativeName: 'Türkçe', direction: 'ltr', flag: '🇹🇷' },\n}\n\nexport const ALL_LOCALES: Locale[] = Object.keys(LOCALE_INFO) as Locale[]\nexport const RTL_LOCALES: Locale[] = ['ar', 'he']\n\n// ─── Translation Utilities ────────────────────────────\nexport function interpolate(template: string, params: Record<string, string | number>): string {\n  return template.replace(/\\{\\{(\\w+)\\}\\}/g, (_, key) => String(params[key] ?? `{{${key}}}`))\n}\n\nexport function t(key: string, dict: TranslationDict, params?: Record<string, string | number>): string {\n  const parts = key.split('.')\n  let current: string | TranslationDict = dict\n  for (const part of parts) {\n    if (typeof current !== 'object' || current === null) return key\n    current = (current as TranslationDict)[part]\n    if (current === undefined) return key\n  }\n  if (typeof current !== 'string') return key\n  return params ? interpolate(current, params) : current\n}\n\nexport function plural(key: string, count: number, dict: TranslationDict): string {\n  if (count === 0) { const zero = t(`${key}_zero`, dict); if (zero !== `${key}_zero`) return zero }\n  if (count === 1) { const one = t(`${key}_one`, dict); if (one !== `${key}_one`) return one }\n  const other = t(`${key}_other`, dict)\n  if (other !== `${key}_other`) return interpolate(other, { count })\n  return t(key, dict, { count })\n}\n\n// ─── Formatting ───────────────────────────────────────\nexport function formatDate(date: Date | string, locale: Locale, format?: Intl.DateTimeFormatOptions): string {\n  const d = typeof date === 'string' ? new Date(date) : date\n  return new Intl.DateTimeFormat(locale, format ?? { dateStyle: 'medium' }).format(d)\n}\n\nexport function formatNumber(n: number, locale: Locale, opts?: Intl.NumberFormatOptions): string {\n  return new Intl.NumberFormat(locale, opts).format(n)\n}\n\nexport function formatCurrency(amount: number, currency: string, locale: Locale): string {\n  return new Intl.NumberFormat(locale, { style: 'currency', currency }).format(amount)\n}\n\n// ─── Detection & Direction ────────────────────────────\nexport function detectLocale(supportedLocales: Locale[]): Locale {\n  if (typeof navigator === 'undefined') return supportedLocales[0] ?? 'en'\n  const browserLang = navigator.language.split('-')[0] as Locale\n  if (supportedLocales.includes(browserLang)) return browserLang\n  const full = navigator.language as Locale\n  if (supportedLocales.includes(full)) return full\n  return supportedLocales[0] ?? 'en'\n}\n\nexport function getDirection(locale: Locale): Direction {\n  return LOCALE_INFO[locale]?.direction ?? 'ltr'\n}\n\nexport function isRTL(locale: Locale): boolean {\n  return getDirection(locale) === 'rtl'\n}\n\n// ─── Namespace Loader ─────────────────────────────────\nimport { createTranslationLoader } from './config'\n\nconst _defaultLoader = createTranslationLoader({ baseUrl: '/locales', cache: true })\n\n/**\n * Load a translation namespace for a locale.\n * Delegates to the default translation loader (fetches from /locales/{locale}/{ns}.json).\n * Falls back to an empty dict if the fetch fails (e.g., during SSR or when no translations are deployed).\n */\nexport async function loadNamespace(locale: Locale, ns: string): Promise<TranslationDict> {\n  return _defaultLoader.load(locale, ns)\n}\n\nexport function flattenDict(dict: TranslationDict, prefix = ''): Record<string, string> {\n  const result: Record<string, string> = {}\n  for (const [key, value] of Object.entries(dict)) {\n    const fullKey = prefix ? `${prefix}.${key}` : key\n    if (typeof value === 'string') result[fullKey] = value\n    else Object.assign(result, flattenDict(value, fullKey))\n  }\n  return result\n}\n"]}

package/packages/solidjs/README.md

@@ -1 +1 @@
-# ✦ @geenius-i18n/solidjs\n\n> Geenius I18n — SolidJS components & primitives\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add @geenius-i18n/solidjs\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius-i18n/solidjs';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n
+# ✦ @geenius/i18n-solidjs\n\n> Geenius I18n — SolidJS components & primitives\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add @geenius/i18n-solidjs\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius/i18n-solidjs';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n

package/packages/solidjs/dist/index.d.ts

@@ -0,0 +1,105 @@
+import * as solid_js from 'solid-js';
+import { ParentComponent, Accessor, Component } from 'solid-js';
+import { I18nConfig, TranslationDict, Locale, Direction, TranslationEntry, MissingKey, LocaleStat } from '@geenius/i18n-shared';
+export { Direction, I18nConfig, I18nNamespace, Locale, LocaleInfo, LocaleStat, MissingKey, TranslationDict, TranslationEntry } from '@geenius/i18n-shared';
+
+interface I18nCtx {
+    locale: () => Locale;
+    direction: () => Direction;
+    isRTL: () => boolean;
+    setLocale: (l: Locale) => void;
+    t: (key: string, params?: Record<string, string | number>) => string;
+    formatDate: (d: Date | string, o?: Intl.DateTimeFormatOptions) => string;
+    formatNumber: (n: number, o?: Intl.NumberFormatOptions) => string;
+    formatCurrency: (a: number, c: string) => string;
+}
+declare const I18nProvider: ParentComponent<{
+    config: I18nConfig;
+    translations?: TranslationDict;
+}>;
+declare function createI18n(): I18nCtx;
+
+declare function createLocaleDetect(supportedLocales: Locale[]): {
+    detectedLocale: solid_js.Accessor<Locale>;
+};
+
+declare function createTranslations(locale: Accessor<Locale>, namespace: string): {
+    dict: Accessor<TranslationDict>;
+    isLoading: Accessor<boolean>;
+    error: Accessor<string | undefined>;
+    t: (key: string, params?: Record<string, string | number>) => string;
+};
+
+declare function createI18nAdmin(data: {
+    translations?: TranslationEntry[];
+    missingKeys?: MissingKey[];
+    localeStats?: LocaleStat[];
+}, mutations: {
+    upsert: (locale: string, ns: string, key: string, value: string) => Promise<void>;
+    deleteKey: (locale: string, key: string) => Promise<void>;
+    importDict: (locale: string, ns: string, dict: Record<string, string>) => Promise<void>;
+    clearMissing: (id: string) => Promise<void>;
+}): {
+    upsert: (locale: string, ns: string, key: string, value: string) => Promise<void>;
+    deleteKey: (locale: string, key: string) => Promise<void>;
+    importDict: (locale: string, ns: string, dict: Record<string, string>) => Promise<void>;
+    clearMissing: (id: string) => Promise<void>;
+    translations: solid_js.Accessor<TranslationEntry[]>;
+    missingKeys: () => MissingKey[];
+    localeStats: () => LocaleStat[];
+    search: solid_js.Accessor<string>;
+    setSearch: solid_js.Setter<string>;
+    isLoading: () => boolean;
+};
+
+interface Props$3 {
+    locales: Locale[];
+    current: Locale;
+    onChange: (l: Locale) => void;
+}
+declare const LocaleSwitcher: Component<Props$3>;
+
+declare const RTLWrapper: ParentComponent<{
+    locale?: Locale;
+}>;
+
+declare const LocaleStatsCard: Component<{
+    stats: LocaleStat[];
+}>;
+
+declare const MissingKeyAlert: Component<{
+    count: number;
+    locale: Locale;
+}>;
+
+interface Props$2 {
+    translationKey: string;
+    value: string;
+    locale: Locale;
+    namespace?: string;
+    onEdit?: (key: string) => void;
+    onDelete?: (key: string) => void;
+}
+declare const TranslationKeyRow: Component<Props$2>;
+
+interface Props$1 {
+    locale: Locale;
+    coverage?: number;
+}
+declare const LocaleCard: Component<Props$1>;
+
+interface Props {
+    translations?: TranslationEntry[];
+    missingKeys?: MissingKey[];
+    localeStats?: LocaleStat[];
+    onUpsert?: (locale: string, namespace: string, key: string, value: string) => void;
+    onDelete?: (locale: string, key: string, namespace?: string) => void;
+}
+declare const I18nAdminPage: Component<Props>;
+
+declare const LocalePreviewPage: Component<{
+    config?: Partial<I18nConfig>;
+    translations?: TranslationDict;
+}>;
+
+export { I18nAdminPage, I18nProvider, LocaleCard, LocalePreviewPage, LocaleStatsCard, LocaleSwitcher, MissingKeyAlert, RTLWrapper, TranslationKeyRow, createI18n, createI18nAdmin, createLocaleDetect, createTranslations };