@sentzunhat/zacatl 0.0.13 → 0.0.20

package/build/intl/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"./src/","sources":["intl/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAUxB,MAAM,OAAO,iBAAiB;IACpB,UAAU,CAAS;IAE3B,YAAY,UAAkB;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,IAAI;QACF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,gCAAgC,IAAI,CAAC,UAAU,EAAE,CAClD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,aAAa,CACX,QAAgB,EAChB,aAAqB,aAAa;QAElC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CACxB,IAAI,CAAC,UAAU,EACf,GAAG,QAAQ,OAAO,CACnB,CAAC;QAEF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,MAAM,IAAI,KAAK,CACb,oCAAoC,QAAQ,KAAK,YAAY,EAAE,CAChE,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAWD,MAAM,OAAO,aAAa;IAChB,SAAS,CAGf;IAEF,YACE,YAGI,EAAE;QAEN,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,aAAa,CACX,QAAgB,EAChB,YAAoB,aAAa;QAEjC,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;IACvD,CAAC;IAED,aAAa,CACX,QAAgB,EAChB,SAAiB,EACjB,SAAkC;QAElC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAE,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IACnD,CAAC;IAKD,MAAM;QACJ,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAC/B,CAAC;CACF","sourcesContent":["import fs from 'fs';\nimport path from 'path';\nimport type { I18nAdapter } from '../types';\n\n/**\n * Filesystem-based i18n adapter.\n * Loads translations from JSON files organized as: localesDir/language.json\n *\n * @example\n * const adapter = new FilesystemAdapter('./src/intl/locales');\n */\nexport class FilesystemAdapter implements I18nAdapter {\n  private localesDir: string;\n\n  constructor(localesDir: string) {\n    this.localesDir = localesDir;\n  }\n\n  init(): void {\n    if (!fs.existsSync(this.localesDir)) {\n      throw new Error(\n        `Locales directory not found: ${this.localesDir}`,\n      );\n    }\n  }\n\n  loadResources(\n    language: string,\n    _namespace: string = \"translation\",\n  ): Record<string, unknown> | null {\n    const filePath = path.join(\n      this.localesDir,\n      `${language}.json`,\n    );\n\n    if (!fs.existsSync(filePath)) {\n      return null;\n    }\n\n    try {\n      const content = fs.readFileSync(filePath, 'utf-8');\n      return JSON.parse(content);\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      throw new Error(\n        `Failed to load translations from ${filePath}: ${errorMessage}`,\n      );\n    }\n  }\n}\n\n/**\n * Memory-based i18n adapter.\n * Stores translations in-memory; useful for testing and embedded scenarios.\n *\n * @example\n * const adapter = new MemoryAdapter({\n *   en: { translation: { greeting: 'Hello' } }\n * });\n */\nexport class MemoryAdapter implements I18nAdapter {\n  private resources: Record<\n    string,\n    Record<string, Record<string, unknown>>\n  >;\n\n  constructor(\n    resources: Record<\n      string,\n      Record<string, Record<string, unknown>>\n    > = {},\n  ) {\n    this.resources = resources;\n  }\n\n  loadResources(\n    language: string,\n    namespace: string = 'translation',\n  ): Record<string, unknown> | null {\n    return this.resources[language]?.[namespace] ?? null;\n  }\n\n  saveResources(\n    language: string,\n    namespace: string,\n    resources: Record<string, unknown>,\n  ): void {\n    if (!this.resources[language]) {\n      this.resources[language] = {};\n    }\n    this.resources[language]![namespace] = resources;\n  }\n\n  /**\n   * Get all stored resources (for testing/inspection).\n   */\n  getAll(): Record<string, Record<string, Record<string, unknown>>> {\n    return { ...this.resources };\n  }\n}\n"]}

package/build/intl/index.d.ts

@@ -0,0 +1,5 @@
+export type { I18nAdapter, I18nConfig, I18nInstance } from "./types";
+export { createI18n, createI18nAsync, setGlobalI18n, getI18nOrThrow, } from "./intl";
+export { FilesystemAdapter, MemoryAdapter } from "./adapters";
+export { I18nConfigSchema, validateI18nConfig, safeValidateI18nConfig, } from "./validation";
+//# sourceMappingURL=index.d.ts.map

package/build/intl/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"./src/","sources":["intl/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAErE,OAAO,EACL,UAAU,EACV,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9D,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,cAAc,CAAC"}

package/build/intl/index.js

@@ -0,0 +1,4 @@
+export { createI18n, createI18nAsync, setGlobalI18n, getI18nOrThrow, } from "./intl";
+export { FilesystemAdapter, MemoryAdapter } from "./adapters";
+export { I18nConfigSchema, validateI18nConfig, safeValidateI18nConfig, } from "./validation";
+//# sourceMappingURL=index.js.map

package/build/intl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"./src/","sources":["intl/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,UAAU,EACV,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9D,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,cAAc,CAAC","sourcesContent":["export type { I18nAdapter, I18nConfig, I18nInstance } from \"./types\";\n\nexport {\n  createI18n,\n  createI18nAsync,\n  setGlobalI18n,\n  getI18nOrThrow,\n} from \"./intl\";\n\nexport { FilesystemAdapter, MemoryAdapter } from \"./adapters\";\n\nexport {\n  I18nConfigSchema,\n  validateI18nConfig,\n  safeValidateI18nConfig,\n} from \"./validation\";\n"]}

package/build/intl/intl.d.ts

@@ -0,0 +1,6 @@
+import type { I18nAdapter, I18nConfig, I18nInstance } from "./types";
+export declare const createI18n: (adapter?: I18nAdapter, config?: I18nConfig) => I18nInstance;
+export declare const createI18nAsync: (adapter?: I18nAdapter, config?: I18nConfig) => Promise<I18nInstance>;
+export declare const setGlobalI18n: (instance: I18nInstance) => void;
+export declare const getI18nOrThrow: () => I18nInstance;
+//# sourceMappingURL=intl.d.ts.map

package/build/intl/intl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intl.d.ts","sourceRoot":"./src/","sources":["intl/intl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA8BrE,eAAO,MAAM,UAAU,GACrB,UAAU,WAAW,EACrB,SAAS,UAAU,KAClB,YA4CF,CAAC;AAUF,eAAO,MAAM,eAAe,GAC1B,UAAU,WAAW,EACrB,SAAS,UAAU,KAClB,OAAO,CAAC,YAAY,CA8CtB,CAAC;AAQF,eAAO,MAAM,aAAa,GAAI,UAAU,YAAY,KAAG,IAEtD,CAAC;AAEF,eAAO,MAAM,cAAc,QAAO,YAOjC,CAAC"}

package/build/intl/intl.js

@@ -0,0 +1,118 @@
+import i18next from "i18next";
+import { FilesystemAdapter } from "./adapters";
+export const createI18n = (adapter, config) => {
+    const finalAdapter = adapter ?? new FilesystemAdapter(`${process.cwd()}/src/intl/locales`);
+    const finalConfig = {
+        defaultLanguage: "en",
+        fallbackLanguage: "en",
+        supportedLanguages: ["en", "es"],
+        defaultNamespace: "translation",
+        ...config,
+    };
+    if (finalAdapter.init) {
+        const result = finalAdapter.init();
+        if (result instanceof Promise) {
+            throw new Error("Async adapter.init() not supported in createI18n(); use createI18nAsync() instead");
+        }
+    }
+    const i18nInstance = i18next.createInstance();
+    i18nInstance.init({
+        lng: finalConfig.defaultLanguage,
+        fallbackLng: finalConfig.fallbackLanguage,
+        ns: [finalConfig.defaultNamespace],
+        defaultNS: finalConfig.defaultNamespace,
+        interpolation: {
+            escapeValue: false,
+        },
+        resources: loadInitialResources(finalAdapter, finalConfig),
+        ...finalConfig.i18nextOptions,
+    }, (err) => {
+        if (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            throw new Error(`i18n initialization failed: ${errorMessage}`);
+        }
+    });
+    return createI18nInstanceWrapper(i18nInstance, finalAdapter, finalConfig);
+};
+export const createI18nAsync = async (adapter, config) => {
+    const finalAdapter = adapter ?? new FilesystemAdapter(`${process.cwd()}/src/intl/locales`);
+    const finalConfig = {
+        defaultLanguage: "en",
+        fallbackLanguage: "en",
+        supportedLanguages: ["en", "es"],
+        defaultNamespace: "translation",
+        ...config,
+    };
+    if (finalAdapter.init) {
+        const result = finalAdapter.init();
+        if (result instanceof Promise) {
+            await result;
+        }
+    }
+    const i18nInstance = i18next.createInstance();
+    await new Promise((resolve, reject) => {
+        i18nInstance.init({
+            lng: finalConfig.defaultLanguage,
+            fallbackLng: finalConfig.fallbackLanguage,
+            ns: [finalConfig.defaultNamespace],
+            defaultNS: finalConfig.defaultNamespace,
+            interpolation: {
+                escapeValue: false,
+            },
+            resources: loadInitialResources(finalAdapter, finalConfig),
+            ...finalConfig.i18nextOptions,
+        }, (err) => {
+            if (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                reject(new Error(`i18n initialization failed: ${errorMessage}`));
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+    return createI18nInstanceWrapper(i18nInstance, finalAdapter, finalConfig);
+};
+let globalI18nInstance = null;
+export const setGlobalI18n = (instance) => {
+    globalI18nInstance = instance;
+};
+export const getI18nOrThrow = () => {
+    if (!globalI18nInstance) {
+        throw new Error("i18n not initialized. Call setGlobalI18n() first or use createI18n() to create an instance.");
+    }
+    return globalI18nInstance;
+};
+const loadInitialResources = (adapter, config) => {
+    const resources = {};
+    for (const lang of config.supportedLanguages ?? []) {
+        const res = adapter.loadResources(lang, config.defaultNamespace ?? "translation");
+        if (res) {
+            resources[lang] = {
+                [config.defaultNamespace ?? "translation"]: res,
+            };
+        }
+    }
+    return resources;
+};
+const createI18nInstanceWrapper = (i18nInstance, _adapter, config) => {
+    const inst = i18nInstance;
+    return {
+        t: (key, options) => inst.t(key, options),
+        getLanguage: () => inst.language,
+        setLanguage: async (language) => {
+            await inst.changeLanguage(language);
+        },
+        getSupportedLanguages: () => config.supportedLanguages ?? ["en"],
+        getI18next: () => i18nInstance,
+        addResources: (language, namespace, resources) => {
+            inst.addResourceBundle(language, namespace, resources, true, true);
+        },
+        getResources: (language, namespace) => {
+            const lang = language ?? inst.language;
+            const ns = namespace ?? config.defaultNamespace ?? "translation";
+            return inst.getResourceBundle(lang, ns) ?? null;
+        },
+    };
+};
+//# sourceMappingURL=intl.js.map

package/build/intl/intl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intl.js","sourceRoot":"./src/","sources":["intl/intl.ts"],"names":[],"mappings":"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","sourcesContent":["import i18next from \"i18next\";\nimport type { I18nAdapter, I18nConfig, I18nInstance } from \"./types\";\nimport { FilesystemAdapter } from \"./adapters\";\n\n/**\n * Create a new i18n instance with optional adapter and configuration.\n * Follows the same factory pattern as createLogger().\n *\n * @param adapter - I18nAdapter implementation (defaults to FilesystemAdapter('./src/intl/locales'))\n * @param config - I18n configuration options\n * @returns Configured I18nInstance\n *\n * @example\n * // With default filesystem adapter\n * const i18n = createI18n();\n *\n * @example\n * // With custom adapter\n * import { MemoryAdapter } from './adapters';\n * const i18n = createI18n(new MemoryAdapter({\n *   en: { translation: { greeting: 'Hello' } }\n * }));\n *\n * @example\n * // With configuration\n * const i18n = createI18n(undefined, {\n *   defaultLanguage: 'en',\n *   supportedLanguages: ['en', 'es'],\n *   i18nextOptions: { ns: ['translation', 'errors'] }\n * });\n */\nexport const createI18n = (\n  adapter?: I18nAdapter,\n  config?: I18nConfig,\n): I18nInstance => {\n  const finalAdapter =\n    adapter ?? new FilesystemAdapter(`${process.cwd()}/src/intl/locales`);\n  const finalConfig: I18nConfig = {\n    defaultLanguage: \"en\",\n    fallbackLanguage: \"en\",\n    supportedLanguages: [\"en\", \"es\"],\n    defaultNamespace: \"translation\",\n    ...config,\n  };\n\n  // Initialize adapter\n  if (finalAdapter.init) {\n    const result = finalAdapter.init();\n    if (result instanceof Promise) {\n      throw new Error(\n        \"Async adapter.init() not supported in createI18n(); use createI18nAsync() instead\",\n      );\n    }\n  }\n\n  // Configure i18next\n  const i18nInstance = i18next.createInstance();\n  i18nInstance.init(\n    {\n      lng: finalConfig.defaultLanguage,\n      fallbackLng: finalConfig.fallbackLanguage,\n      ns: [finalConfig.defaultNamespace],\n      defaultNS: finalConfig.defaultNamespace,\n      interpolation: {\n        escapeValue: false, // React/TypeScript handles escaping\n      },\n      resources: loadInitialResources(finalAdapter, finalConfig),\n      ...finalConfig.i18nextOptions,\n    } as Record<string, unknown>,\n    (err: unknown) => {\n      if (err) {\n        const errorMessage = err instanceof Error ? err.message : String(err);\n        throw new Error(`i18n initialization failed: ${errorMessage}`);\n      }\n    },\n  );\n\n  return createI18nInstanceWrapper(i18nInstance, finalAdapter, finalConfig);\n};\n\n/**\n * Create a new async i18n instance.\n * Use this if your adapter.init() returns a Promise.\n *\n * @param adapter - I18nAdapter implementation\n * @param config - I18n configuration options\n * @returns Promise<I18nInstance>\n */\nexport const createI18nAsync = async (\n  adapter?: I18nAdapter,\n  config?: I18nConfig,\n): Promise<I18nInstance> => {\n  const finalAdapter =\n    adapter ?? new FilesystemAdapter(`${process.cwd()}/src/intl/locales`);\n  const finalConfig: I18nConfig = {\n    defaultLanguage: \"en\",\n    fallbackLanguage: \"en\",\n    supportedLanguages: [\"en\", \"es\"],\n    defaultNamespace: \"translation\",\n    ...config,\n  };\n\n  // Initialize adapter\n  if (finalAdapter.init) {\n    const result = finalAdapter.init();\n    if (result instanceof Promise) {\n      await result;\n    }\n  }\n\n  // Configure i18next\n  const i18nInstance = i18next.createInstance();\n  await new Promise<void>((resolve, reject) => {\n    i18nInstance.init(\n      {\n        lng: finalConfig.defaultLanguage,\n        fallbackLng: finalConfig.fallbackLanguage,\n        ns: [finalConfig.defaultNamespace],\n        defaultNS: finalConfig.defaultNamespace,\n        interpolation: {\n          escapeValue: false,\n        },\n        resources: loadInitialResources(finalAdapter, finalConfig),\n        ...finalConfig.i18nextOptions,\n      } as Record<string, unknown>,\n      (err: unknown) => {\n        if (err) {\n          const errorMessage = err instanceof Error ? err.message : String(err);\n          reject(new Error(`i18n initialization failed: ${errorMessage}`));\n        } else {\n          resolve();\n        }\n      },\n    );\n  });\n\n  return createI18nInstanceWrapper(i18nInstance, finalAdapter, finalConfig);\n};\n\n/**\n * Get or throw error if not initialized.\n * Used internally; not part of public API.\n */\nlet globalI18nInstance: I18nInstance | null = null;\n\nexport const setGlobalI18n = (instance: I18nInstance): void => {\n  globalI18nInstance = instance;\n};\n\nexport const getI18nOrThrow = (): I18nInstance => {\n  if (!globalI18nInstance) {\n    throw new Error(\n      \"i18n not initialized. Call setGlobalI18n() first or use createI18n() to create an instance.\",\n    );\n  }\n  return globalI18nInstance;\n};\n\n/**\n * Internal: Load initial resources from adapter.\n */\nconst loadInitialResources = (\n  adapter: I18nAdapter,\n  config: I18nConfig,\n): Record<string, Record<string, unknown>> => {\n  const resources: Record<string, Record<string, unknown>> = {};\n\n  for (const lang of config.supportedLanguages ?? []) {\n    const res = adapter.loadResources(\n      lang,\n      config.defaultNamespace ?? \"translation\",\n    );\n    if (res) {\n      resources[lang] = {\n        [config.defaultNamespace ?? \"translation\"]: res,\n      };\n    }\n  }\n\n  return resources;\n};\n\n/**\n * Internal: Create the I18nInstance wrapper.\n */\nconst createI18nInstanceWrapper = (\n  i18nInstance: unknown,\n  _adapter: I18nAdapter,\n  config: I18nConfig,\n): I18nInstance => {\n  const inst = i18nInstance as any; // eslint-disable-line @typescript-eslint/no-explicit-any\n  return {\n    t: (key: string, options?: Record<string, unknown>) =>\n      inst.t(key, options) as string,\n\n    getLanguage: () => inst.language,\n\n    setLanguage: async (language: string) => {\n      await inst.changeLanguage(language);\n    },\n\n    getSupportedLanguages: () => config.supportedLanguages ?? [\"en\"],\n\n    getI18next: () => i18nInstance,\n\n    addResources: (\n      language: string,\n      namespace: string,\n      resources: Record<string, unknown>,\n    ) => {\n      inst.addResourceBundle(language, namespace, resources, true, true);\n    },\n\n    getResources: (language?: string, namespace?: string) => {\n      const lang = language ?? inst.language;\n      const ns = namespace ?? config.defaultNamespace ?? \"translation\";\n      return inst.getResourceBundle(lang, ns) ?? null;\n    },\n  };\n};\n"]}

package/build/intl/types.d.ts

@@ -0,0 +1,22 @@
+export interface I18nAdapter {
+    init?(config?: Record<string, unknown>): Promise<void> | void;
+    loadResources(language: string, namespace: string): Promise<Record<string, unknown> | null> | Record<string, unknown> | null;
+    saveResources?(language: string, namespace: string, resources: Record<string, unknown>): Promise<void> | void;
+}
+export interface I18nConfig {
+    defaultLanguage?: string;
+    fallbackLanguage?: string;
+    supportedLanguages?: string[];
+    defaultNamespace?: string;
+    i18nextOptions?: Record<string, unknown>;
+}
+export interface I18nInstance {
+    t(key: string, options?: Record<string, unknown>): string;
+    getLanguage(): string;
+    setLanguage(language: string): Promise<void>;
+    getSupportedLanguages(): string[];
+    getI18next(): unknown;
+    addResources(language: string, namespace: string, resources: Record<string, unknown>): void;
+    getResources(language?: string, namespace?: string): Record<string, unknown> | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/intl/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"./src/","sources":["intl/types.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAI1B,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAM9D,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAK5E,aAAa,CAAC,CACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACzB;AAKD,MAAM,WAAW,UAAU;IAKzB,eAAe,CAAC,EAAE,MAAM,CAAC;IAMzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAM1B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAM9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAK1B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAMD,MAAM,WAAW,YAAY;IAI3B,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IAK1D,WAAW,IAAI,MAAM,CAAC;IAKtB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAK7C,qBAAqB,IAAI,MAAM,EAAE,CAAC;IAKlC,UAAU,IAAI,OAAO,CAAC;IAKtB,YAAY,CACV,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI,CAAC;IAKR,YAAY,CACV,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACnC"}

package/build/intl/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/intl/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"./src/","sources":["intl/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * I18n adapter interface for pluggable i18n backends.\n * Implementations define where translations are loaded from (filesystem, API, memory, etc.).\n */\nexport interface I18nAdapter {\n  /**\n   * Initialize the adapter with optional configuration.\n   */\n  init?(config?: Record<string, unknown>): Promise<void> | void;\n\n  /**\n   * Load translations for a specific language and namespace.\n   * Returns the loaded resources object.\n   */\n  loadResources(\n    language: string,\n    namespace: string,\n  ): Promise<Record<string, unknown> | null> | Record<string, unknown> | null;\n\n  /**\n   * Optional: Save translations (useful for some backends).\n   */\n  saveResources?(\n    language: string,\n    namespace: string,\n    resources: Record<string, unknown>,\n  ): Promise<void> | void;\n}\n\n/**\n * I18n configuration options.\n */\nexport interface I18nConfig {\n  /**\n   * Default language for translations.\n   * @default 'en'\n   */\n  defaultLanguage?: string;\n\n  /**\n   * Fallback language if translation not found.\n   * @default 'en'\n   */\n  fallbackLanguage?: string;\n\n  /**\n   * List of supported languages.\n   * @default ['en']\n   */\n  supportedLanguages?: string[];\n\n  /**\n   * Default namespace for translations.\n   * @default 'translation'\n   */\n  defaultNamespace?: string;\n\n  /**\n   * Additional i18next options to merge with defaults.\n   */\n  i18nextOptions?: Record<string, unknown>;\n}\n\n/**\n * I18n instance returned by createI18n().\n * Provides translation, language switching, and management methods.\n */\nexport interface I18nInstance {\n  /**\n   * Translate a key with optional interpolation.\n   */\n  t(key: string, options?: Record<string, unknown>): string;\n\n  /**\n   * Get the current language.\n   */\n  getLanguage(): string;\n\n  /**\n   * Change the current language.\n   */\n  setLanguage(language: string): Promise<void>;\n\n  /**\n   * Get all supported languages.\n   */\n  getSupportedLanguages(): string[];\n\n  /**\n   * Get the raw i18next instance for advanced usage.\n   */\n  getI18next(): unknown;\n\n  /**\n   * Add resources programmatically.\n   */\n  addResources(\n    language: string,\n    namespace: string,\n    resources: Record<string, unknown>,\n  ): void;\n\n  /**\n   * Get resource bundles for a language/namespace.\n   */\n  getResources(\n    language?: string,\n    namespace?: string,\n  ): Record<string, unknown> | null;\n}\n"]}

package/build/intl/validation.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+export declare const I18nConfigSchema: z.ZodObject<{
+    defaultLanguage: z.ZodDefault<z.ZodString>;
+    fallbackLanguage: z.ZodDefault<z.ZodString>;
+    supportedLanguages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    defaultNamespace: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export declare const validateI18nConfig: (config: unknown) => ReturnType<typeof I18nConfigSchema.parse>;
+export declare const safeValidateI18nConfig: (config: unknown) => {
+    success: true;
+    data: z.infer<typeof I18nConfigSchema>;
+} | {
+    success: false;
+    errors: z.ZodError;
+};
+//# sourceMappingURL=validation.d.ts.map

package/build/intl/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"./src/","sources":["intl/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,gBAAgB;;;;;iBAW3B,CAAC;AAMH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,OAAO,KACd,UAAU,CAAC,OAAO,gBAAgB,CAAC,KAAK,CAE1C,CAAC;AAMF,eAAO,MAAM,sBAAsB,GACjC,QAAQ,OAAO,KAEb;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;CAAE,GACzD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAA;CAKvC,CAAC"}

package/build/intl/validation.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+export const I18nConfigSchema = z.object({
+    defaultLanguage: z.string().default("en").describe("Default language code"),
+    fallbackLanguage: z.string().default("en").describe("Fallback language code"),
+    supportedLanguages: z
+        .array(z.string())
+        .default(["en"])
+        .describe("List of supported language codes"),
+    defaultNamespace: z
+        .string()
+        .default("translation")
+        .describe("Default translation namespace"),
+});
+export const validateI18nConfig = (config) => {
+    return I18nConfigSchema.parse(config);
+};
+export const safeValidateI18nConfig = (config) => {
+    const result = I18nConfigSchema.safeParse(config);
+    return result.success
+        ? { success: true, data: result.data }
+        : { success: false, errors: result.error };
+};
+//# sourceMappingURL=validation.js.map

package/build/intl/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"./src/","sources":["intl/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC3E,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC7E,kBAAkB,EAAE,CAAC;SAClB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;SACf,QAAQ,CAAC,kCAAkC,CAAC;IAC/C,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,OAAO,CAAC,aAAa,CAAC;SACtB,QAAQ,CAAC,+BAA+B,CAAC;CAC7C,CAAC,CAAC;AAMH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,MAAe,EAC4B,EAAE;IAC7C,OAAO,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC,CAAC;AAMF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,MAAe,EAG0B,EAAE;IAC3C,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,OAAO;QACnB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;QACtC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;AAC/C,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\n\n/**\n * Zod schema for validating i18n configuration.\n * Ensures all required language files and namespaces are present.\n */\nexport const I18nConfigSchema = z.object({\n  defaultLanguage: z.string().default(\"en\").describe(\"Default language code\"),\n  fallbackLanguage: z.string().default(\"en\").describe(\"Fallback language code\"),\n  supportedLanguages: z\n    .array(z.string())\n    .default([\"en\"])\n    .describe(\"List of supported language codes\"),\n  defaultNamespace: z\n    .string()\n    .default(\"translation\")\n    .describe(\"Default translation namespace\"),\n});\n\n/**\n * Validate a configuration object against the I18n schema.\n * Throws ZodError if validation fails.\n */\nexport const validateI18nConfig = (\n  config: unknown,\n): ReturnType<typeof I18nConfigSchema.parse> => {\n  return I18nConfigSchema.parse(config);\n};\n\n/**\n * Safe version of validateI18nConfig.\n * Returns { success: true, data } or { success: false, errors }.\n */\nexport const safeValidateI18nConfig = (\n  config: unknown,\n):\n  | { success: true; data: z.infer<typeof I18nConfigSchema> }\n  | { success: false; errors: z.ZodError } => {\n  const result = I18nConfigSchema.safeParse(config);\n  return result.success\n    ? { success: true, data: result.data }\n    : { success: false, errors: result.error };\n};\n"]}

package/build/localization/adapters/index.d.ts

@@ -0,0 +1,15 @@
+import type { I18nAdapter } from "../types";
+export declare class FilesystemAdapter implements I18nAdapter {
+    private localesDir;
+    constructor(localesDir: string);
+    init(): void;
+    loadResources(language: string, _namespace?: string): Record<string, unknown> | null;
+}
+export declare class MemoryAdapter implements I18nAdapter {
+    private resources;
+    constructor(resources?: Record<string, Record<string, Record<string, unknown>>>);
+    loadResources(language: string, namespace?: string): Record<string, unknown> | null;
+    saveResources(language: string, namespace: string, resources: Record<string, unknown>): void;
+    getAll(): Record<string, Record<string, Record<string, unknown>>>;
+}
+//# sourceMappingURL=index.d.ts.map

package/build/localization/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"./src/","sources":["localization/adapters/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAS5C,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAI9B,IAAI,IAAI,IAAI;IAMZ,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,MAAsB,GACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAkBlC;AAWD,qBAAa,aAAc,YAAW,WAAW;IAC/C,OAAO,CAAC,SAAS,CAA0D;gBAGzE,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAM;IAKzE,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAsB,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIjC,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAUP,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAGlE"}

package/build/localization/adapters/index.js

@@ -0,0 +1,46 @@
+import fs from "fs";
+import path from "path";
+export class FilesystemAdapter {
+    localesDir;
+    constructor(localesDir) {
+        this.localesDir = localesDir;
+    }
+    init() {
+        if (!fs.existsSync(this.localesDir)) {
+            throw new Error(`Locales directory not found: ${this.localesDir}`);
+        }
+    }
+    loadResources(language, _namespace = "translation") {
+        const filePath = path.join(this.localesDir, `${language}.json`);
+        if (!fs.existsSync(filePath)) {
+            return null;
+        }
+        try {
+            const content = fs.readFileSync(filePath, "utf-8");
+            return JSON.parse(content);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to load translations from ${filePath}: ${errorMessage}`);
+        }
+    }
+}
+export class MemoryAdapter {
+    resources;
+    constructor(resources = {}) {
+        this.resources = resources;
+    }
+    loadResources(language, namespace = "translation") {
+        return this.resources[language]?.[namespace] ?? null;
+    }
+    saveResources(language, namespace, resources) {
+        if (!this.resources[language]) {
+            this.resources[language] = {};
+        }
+        this.resources[language][namespace] = resources;
+    }
+    getAll() {
+        return { ...this.resources };
+    }
+}
+//# sourceMappingURL=index.js.map

package/build/localization/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"./src/","sources":["localization/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAUxB,MAAM,OAAO,iBAAiB;IACpB,UAAU,CAAS;IAE3B,YAAY,UAAkB;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,IAAI;QACF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,aAAa,CACX,QAAgB,EAChB,aAAqB,aAAa;QAElC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,QAAQ,OAAO,CAAC,CAAC;QAEhE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,MAAM,IAAI,KAAK,CACb,oCAAoC,QAAQ,KAAK,YAAY,EAAE,CAChE,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAWD,MAAM,OAAO,aAAa;IAChB,SAAS,CAA0D;IAE3E,YACE,YAAqE,EAAE;QAEvE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,aAAa,CACX,QAAgB,EAChB,YAAoB,aAAa;QAEjC,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;IACvD,CAAC;IAED,aAAa,CACX,QAAgB,EAChB,SAAiB,EACjB,SAAkC;QAElC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAE,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IACnD,CAAC;IAKD,MAAM;QACJ,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAC/B,CAAC;CACF","sourcesContent":["import fs from \"fs\";\nimport path from \"path\";\nimport type { I18nAdapter } from \"../types\";\n\n/**\n * Filesystem-based i18n adapter.\n * Loads translations from JSON files organized as: localesDir/language.json\n *\n * @example\n * const adapter = new FilesystemAdapter('./src/localization/locales');\n */\nexport class FilesystemAdapter implements I18nAdapter {\n  private localesDir: string;\n\n  constructor(localesDir: string) {\n    this.localesDir = localesDir;\n  }\n\n  init(): void {\n    if (!fs.existsSync(this.localesDir)) {\n      throw new Error(`Locales directory not found: ${this.localesDir}`);\n    }\n  }\n\n  loadResources(\n    language: string,\n    _namespace: string = \"translation\",\n  ): Record<string, unknown> | null {\n    const filePath = path.join(this.localesDir, `${language}.json`);\n\n    if (!fs.existsSync(filePath)) {\n      return null;\n    }\n\n    try {\n      const content = fs.readFileSync(filePath, \"utf-8\");\n      return JSON.parse(content);\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      throw new Error(\n        `Failed to load translations from ${filePath}: ${errorMessage}`,\n      );\n    }\n  }\n}\n\n/**\n * Memory-based i18n adapter.\n * Stores translations in-memory; useful for testing and embedded scenarios.\n *\n * @example\n * const adapter = new MemoryAdapter({\n *   en: { translation: { greeting: 'Hello' } }\n * });\n */\nexport class MemoryAdapter implements I18nAdapter {\n  private resources: Record<string, Record<string, Record<string, unknown>>>;\n\n  constructor(\n    resources: Record<string, Record<string, Record<string, unknown>>> = {},\n  ) {\n    this.resources = resources;\n  }\n\n  loadResources(\n    language: string,\n    namespace: string = \"translation\",\n  ): Record<string, unknown> | null {\n    return this.resources[language]?.[namespace] ?? null;\n  }\n\n  saveResources(\n    language: string,\n    namespace: string,\n    resources: Record<string, unknown>,\n  ): void {\n    if (!this.resources[language]) {\n      this.resources[language] = {};\n    }\n    this.resources[language]![namespace] = resources;\n  }\n\n  /**\n   * Get all stored resources (for testing/inspection).\n   */\n  getAll(): Record<string, Record<string, Record<string, unknown>>> {\n    return { ...this.resources };\n  }\n}\n"]}

package/build/localization/i18n.d.ts

@@ -0,0 +1,6 @@
+import type { I18nAdapter, I18nConfig, I18nInstance } from "./types";
+export declare const createI18n: (adapter?: I18nAdapter, config?: I18nConfig) => I18nInstance;
+export declare const createI18nAsync: (adapter?: I18nAdapter, config?: I18nConfig) => Promise<I18nInstance>;
+export declare const setGlobalI18n: (instance: I18nInstance) => void;
+export declare const getI18nOrThrow: () => I18nInstance;
+//# sourceMappingURL=i18n.d.ts.map

package/build/localization/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"./src/","sources":["localization/i18n.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA8BrE,eAAO,MAAM,UAAU,GACrB,UAAU,WAAW,EACrB,SAAS,UAAU,KAClB,YA4CF,CAAC;AAUF,eAAO,MAAM,eAAe,GAC1B,UAAU,WAAW,EACrB,SAAS,UAAU,KAClB,OAAO,CAAC,YAAY,CA8CtB,CAAC;AAQF,eAAO,MAAM,aAAa,GAAI,UAAU,YAAY,KAAG,IAEtD,CAAC;AAEF,eAAO,MAAM,cAAc,QAAO,YAOjC,CAAC"}

package/build/localization/i18n.js

@@ -0,0 +1,118 @@
+import i18next from "i18next";
+import { FilesystemAdapter } from "./adapters";
+export const createI18n = (adapter, config) => {
+    const finalAdapter = adapter ?? new FilesystemAdapter(`${process.cwd()}/src/localization/locales`);
+    const finalConfig = {
+        defaultLanguage: "en",
+        fallbackLanguage: "en",
+        supportedLanguages: ["en", "es"],
+        defaultNamespace: "translation",
+        ...config,
+    };
+    if (finalAdapter.init) {
+        const result = finalAdapter.init();
+        if (result instanceof Promise) {
+            throw new Error("Async adapter.init() not supported in createI18n(); use createI18nAsync() instead");
+        }
+    }
+    const i18nInstance = i18next.createInstance();
+    i18nInstance.init({
+        lng: finalConfig.defaultLanguage,
+        fallbackLng: finalConfig.fallbackLanguage,
+        ns: [finalConfig.defaultNamespace],
+        defaultNS: finalConfig.defaultNamespace,
+        interpolation: {
+            escapeValue: false,
+        },
+        resources: loadInitialResources(finalAdapter, finalConfig),
+        ...finalConfig.i18nextOptions,
+    }, (err) => {
+        if (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            throw new Error(`i18n initialization failed: ${errorMessage}`);
+        }
+    });
+    return createI18nInstanceWrapper(i18nInstance, finalAdapter, finalConfig);
+};
+export const createI18nAsync = async (adapter, config) => {
+    const finalAdapter = adapter ?? new FilesystemAdapter(`${process.cwd()}/src/localization/locales`);
+    const finalConfig = {
+        defaultLanguage: "en",
+        fallbackLanguage: "en",
+        supportedLanguages: ["en", "es"],
+        defaultNamespace: "translation",
+        ...config,
+    };
+    if (finalAdapter.init) {
+        const result = finalAdapter.init();
+        if (result instanceof Promise) {
+            await result;
+        }
+    }
+    const i18nInstance = i18next.createInstance();
+    await new Promise((resolve, reject) => {
+        i18nInstance.init({
+            lng: finalConfig.defaultLanguage,
+            fallbackLng: finalConfig.fallbackLanguage,
+            ns: [finalConfig.defaultNamespace],
+            defaultNS: finalConfig.defaultNamespace,
+            interpolation: {
+                escapeValue: false,
+            },
+            resources: loadInitialResources(finalAdapter, finalConfig),
+            ...finalConfig.i18nextOptions,
+        }, (err) => {
+            if (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                reject(new Error(`i18n initialization failed: ${errorMessage}`));
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+    return createI18nInstanceWrapper(i18nInstance, finalAdapter, finalConfig);
+};
+let globalI18nInstance = null;
+export const setGlobalI18n = (instance) => {
+    globalI18nInstance = instance;
+};
+export const getI18nOrThrow = () => {
+    if (!globalI18nInstance) {
+        throw new Error("i18n not initialized. Call setGlobalI18n() first or use createI18n() to create an instance.");
+    }
+    return globalI18nInstance;
+};
+const loadInitialResources = (adapter, config) => {
+    const resources = {};
+    for (const lang of config.supportedLanguages ?? []) {
+        const res = adapter.loadResources(lang, config.defaultNamespace ?? "translation");
+        if (res) {
+            resources[lang] = {
+                [config.defaultNamespace ?? "translation"]: res,
+            };
+        }
+    }
+    return resources;
+};
+const createI18nInstanceWrapper = (i18nInstance, _adapter, config) => {
+    const inst = i18nInstance;
+    return {
+        t: (key, options) => inst.t(key, options),
+        getLanguage: () => inst.language,
+        setLanguage: async (language) => {
+            await inst.changeLanguage(language);
+        },
+        getSupportedLanguages: () => config.supportedLanguages ?? ["en"],
+        getI18next: () => i18nInstance,
+        addResources: (language, namespace, resources) => {
+            inst.addResourceBundle(language, namespace, resources, true, true);
+        },
+        getResources: (language, namespace) => {
+            const lang = language ?? inst.language;
+            const ns = namespace ?? config.defaultNamespace ?? "translation";
+            return inst.getResourceBundle(lang, ns) ?? null;
+        },
+    };
+};
+//# sourceMappingURL=i18n.js.map

package/build/localization/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"./src/","sources":["localization/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA6B/C,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,OAAqB,EACrB,MAAmB,EACL,EAAE;IAChB,MAAM,YAAY,GAChB,OAAO,IAAI,IAAI,iBAAiB,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,2BAA2B,CAAC,CAAC;IAChF,MAAM,WAAW,GAAe;QAC9B,eAAe,EAAE,IAAI;QACrB,gBAAgB,EAAE,IAAI;QACtB,kBAAkB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;QAChC,gBAAgB,EAAE,aAAa;QAC/B,GAAG,MAAM;KACV,CAAC;IAGF,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,mFAAmF,CACpF,CAAC;QACJ,CAAC;IACH,CAAC;IAGD,MAAM,YAAY,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAC9C,YAAY,CAAC,IAAI,CACf;QACE,GAAG,EAAE,WAAW,CAAC,eAAe;QAChC,WAAW,EAAE,WAAW,CAAC,gBAAgB;QACzC,EAAE,EAAE,CAAC,WAAW,CAAC,gBAAgB,CAAC;QAClC,SAAS,EAAE,WAAW,CAAC,gBAAgB;QACvC,aAAa,EAAE;YACb,WAAW,EAAE,KAAK;SACnB;QACD,SAAS,EAAE,oBAAoB,CAAC,YAAY,EAAE,WAAW,CAAC;QAC1D,GAAG,WAAW,CAAC,cAAc;KACH,EAC5B,CAAC,GAAY,EAAE,EAAE;QACf,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,+BAA+B,YAAY,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC,CACF,CAAC;IAEF,OAAO,yBAAyB,CAAC,YAAY,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;AAC5E,CAAC,CAAC;AAUF,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,OAAqB,EACrB,MAAmB,EACI,EAAE;IACzB,MAAM,YAAY,GAChB,OAAO,IAAI,IAAI,iBAAiB,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,2BAA2B,CAAC,CAAC;IAChF,MAAM,WAAW,GAAe;QAC9B,eAAe,EAAE,IAAI;QACrB,gBAAgB,EAAE,IAAI;QACtB,kBAAkB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;QAChC,gBAAgB,EAAE,aAAa;QAC/B,GAAG,MAAM;KACV,CAAC;IAGF,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,MAAM,MAAM,CAAC;QACf,CAAC;IACH,CAAC;IAGD,MAAM,YAAY,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAC9C,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,YAAY,CAAC,IAAI,CACf;YACE,GAAG,EAAE,WAAW,CAAC,eAAe;YAChC,WAAW,EAAE,WAAW,CAAC,gBAAgB;YACzC,EAAE,EAAE,CAAC,WAAW,CAAC,gBAAgB,CAAC;YAClC,SAAS,EAAE,WAAW,CAAC,gBAAgB;YACvC,aAAa,EAAE;gBACb,WAAW,EAAE,KAAK;aACnB;YACD,SAAS,EAAE,oBAAoB,CAAC,YAAY,EAAE,WAAW,CAAC;YAC1D,GAAG,WAAW,CAAC,cAAc;SACH,EAC5B,CAAC,GAAY,EAAE,EAAE;YACf,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACtE,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,YAAY,EAAE,CAAC,CAAC,CAAC;YACnE,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,yBAAyB,CAAC,YAAY,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;AAC5E,CAAC,CAAC;AAMF,IAAI,kBAAkB,GAAwB,IAAI,CAAC;AAEnD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAsB,EAAQ,EAAE;IAC5D,kBAAkB,GAAG,QAAQ,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAiB,EAAE;IAC/C,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;IACJ,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC5B,CAAC,CAAC;AAKF,MAAM,oBAAoB,GAAG,CAC3B,OAAoB,EACpB,MAAkB,EACuB,EAAE;IAC3C,MAAM,SAAS,GAA4C,EAAE,CAAC;IAE9D,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,kBAAkB,IAAI,EAAE,EAAE,CAAC;QACnD,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,CAC/B,IAAI,EACJ,MAAM,CAAC,gBAAgB,IAAI,aAAa,CACzC,CAAC;QACF,IAAI,GAAG,EAAE,CAAC;YACR,SAAS,CAAC,IAAI,CAAC,GAAG;gBAChB,CAAC,MAAM,CAAC,gBAAgB,IAAI,aAAa,CAAC,EAAE,GAAG;aAChD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAKF,MAAM,yBAAyB,GAAG,CAChC,YAAqB,EACrB,QAAqB,EACrB,MAAkB,EACJ,EAAE;IAChB,MAAM,IAAI,GAAG,YAAmB,CAAC;IACjC,OAAO;QACL,CAAC,EAAE,CAAC,GAAW,EAAE,OAAiC,EAAE,EAAE,CACpD,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,CAAW;QAEhC,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ;QAEhC,WAAW,EAAE,KAAK,EAAE,QAAgB,EAAE,EAAE;YACtC,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;QAED,qBAAqB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,kBAAkB,IAAI,CAAC,IAAI,CAAC;QAEhE,UAAU,EAAE,GAAG,EAAE,CAAC,YAAY;QAE9B,YAAY,EAAE,CACZ,QAAgB,EAChB,SAAiB,EACjB,SAAkC,EAClC,EAAE;YACF,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACrE,CAAC;QAED,YAAY,EAAE,CAAC,QAAiB,EAAE,SAAkB,EAAE,EAAE;YACtD,MAAM,IAAI,GAAG,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC;YACvC,MAAM,EAAE,GAAG,SAAS,IAAI,MAAM,CAAC,gBAAgB,IAAI,aAAa,CAAC;YACjE,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC;QAClD,CAAC;KACF,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import i18next from \"i18next\";\nimport type { I18nAdapter, I18nConfig, I18nInstance } from \"./types\";\nimport { FilesystemAdapter } from \"./adapters\";\n\n/**\n * Create a new i18n instance with optional adapter and configuration.\n * Follows the same factory pattern as createLogger().\n *\n * @param adapter - I18nAdapter implementation (defaults to FilesystemAdapter('./src/localization/locales'))\n * @param config - I18n configuration options\n * @returns Configured I18nInstance\n *\n * @example\n * // With default filesystem adapter\n * const i18n = createI18n();\n *\n * @example\n * // With custom adapter\n * import { MemoryAdapter } from './adapters';\n * const i18n = createI18n(new MemoryAdapter({\n *   en: { translation: { greeting: 'Hello' } }\n * }));\n *\n * @example\n * // With configuration\n * const i18n = createI18n(undefined, {\n *   defaultLanguage: 'en',\n *   supportedLanguages: ['en', 'fr'],\n *   i18nextOptions: { ns: ['translation', 'errors'] }\n * });\n */\nexport const createI18n = (\n  adapter?: I18nAdapter,\n  config?: I18nConfig,\n): I18nInstance => {\n  const finalAdapter =\n    adapter ?? new FilesystemAdapter(`${process.cwd()}/src/localization/locales`);\n  const finalConfig: I18nConfig = {\n    defaultLanguage: \"en\",\n    fallbackLanguage: \"en\",\n    supportedLanguages: [\"en\", \"es\"],\n    defaultNamespace: \"translation\",\n    ...config,\n  };\n\n  // Initialize adapter\n  if (finalAdapter.init) {\n    const result = finalAdapter.init();\n    if (result instanceof Promise) {\n      throw new Error(\n        \"Async adapter.init() not supported in createI18n(); use createI18nAsync() instead\",\n      );\n    }\n  }\n\n  // Configure i18next\n  const i18nInstance = i18next.createInstance();\n  i18nInstance.init(\n    {\n      lng: finalConfig.defaultLanguage,\n      fallbackLng: finalConfig.fallbackLanguage,\n      ns: [finalConfig.defaultNamespace],\n      defaultNS: finalConfig.defaultNamespace,\n      interpolation: {\n        escapeValue: false, // React/TypeScript handles escaping\n      },\n      resources: loadInitialResources(finalAdapter, finalConfig),\n      ...finalConfig.i18nextOptions,\n    } as Record<string, unknown>,\n    (err: unknown) => {\n      if (err) {\n        const errorMessage = err instanceof Error ? err.message : String(err);\n        throw new Error(`i18n initialization failed: ${errorMessage}`);\n      }\n    },\n  );\n\n  return createI18nInstanceWrapper(i18nInstance, finalAdapter, finalConfig);\n};\n\n/**\n * Create a new async i18n instance.\n * Use this if your adapter.init() returns a Promise.\n *\n * @param adapter - I18nAdapter implementation\n * @param config - I18n configuration options\n * @returns Promise<I18nInstance>\n */\nexport const createI18nAsync = async (\n  adapter?: I18nAdapter,\n  config?: I18nConfig,\n): Promise<I18nInstance> => {\n  const finalAdapter =\n    adapter ?? new FilesystemAdapter(`${process.cwd()}/src/localization/locales`);\n  const finalConfig: I18nConfig = {\n    defaultLanguage: \"en\",\n    fallbackLanguage: \"en\",\n    supportedLanguages: [\"en\", \"es\"],\n    defaultNamespace: \"translation\",\n    ...config,\n  };\n\n  // Initialize adapter\n  if (finalAdapter.init) {\n    const result = finalAdapter.init();\n    if (result instanceof Promise) {\n      await result;\n    }\n  }\n\n  // Configure i18next\n  const i18nInstance = i18next.createInstance();\n  await new Promise<void>((resolve, reject) => {\n    i18nInstance.init(\n      {\n        lng: finalConfig.defaultLanguage,\n        fallbackLng: finalConfig.fallbackLanguage,\n        ns: [finalConfig.defaultNamespace],\n        defaultNS: finalConfig.defaultNamespace,\n        interpolation: {\n          escapeValue: false,\n        },\n        resources: loadInitialResources(finalAdapter, finalConfig),\n        ...finalConfig.i18nextOptions,\n      } as Record<string, unknown>,\n      (err: unknown) => {\n        if (err) {\n          const errorMessage = err instanceof Error ? err.message : String(err);\n          reject(new Error(`i18n initialization failed: ${errorMessage}`));\n        } else {\n          resolve();\n        }\n      },\n    );\n  });\n\n  return createI18nInstanceWrapper(i18nInstance, finalAdapter, finalConfig);\n};\n\n/**\n * Get or throw error if not initialized.\n * Used internally; not part of public API.\n */\nlet globalI18nInstance: I18nInstance | null = null;\n\nexport const setGlobalI18n = (instance: I18nInstance): void => {\n  globalI18nInstance = instance;\n};\n\nexport const getI18nOrThrow = (): I18nInstance => {\n  if (!globalI18nInstance) {\n    throw new Error(\n      \"i18n not initialized. Call setGlobalI18n() first or use createI18n() to create an instance.\",\n    );\n  }\n  return globalI18nInstance;\n};\n\n/**\n * Internal: Load initial resources from adapter.\n */\nconst loadInitialResources = (\n  adapter: I18nAdapter,\n  config: I18nConfig,\n): Record<string, Record<string, unknown>> => {\n  const resources: Record<string, Record<string, unknown>> = {};\n\n  for (const lang of config.supportedLanguages ?? []) {\n    const res = adapter.loadResources(\n      lang,\n      config.defaultNamespace ?? \"translation\",\n    );\n    if (res) {\n      resources[lang] = {\n        [config.defaultNamespace ?? \"translation\"]: res,\n      };\n    }\n  }\n\n  return resources;\n};\n\n/**\n * Internal: Create the I18nInstance wrapper.\n */\nconst createI18nInstanceWrapper = (\n  i18nInstance: unknown,\n  _adapter: I18nAdapter,\n  config: I18nConfig,\n): I18nInstance => {\n  const inst = i18nInstance as any; // eslint-disable-line @typescript-eslint/no-explicit-any\n  return {\n    t: (key: string, options?: Record<string, unknown>) =>\n      inst.t(key, options) as string,\n\n    getLanguage: () => inst.language,\n\n    setLanguage: async (language: string) => {\n      await inst.changeLanguage(language);\n    },\n\n    getSupportedLanguages: () => config.supportedLanguages ?? [\"en\"],\n\n    getI18next: () => i18nInstance,\n\n    addResources: (\n      language: string,\n      namespace: string,\n      resources: Record<string, unknown>,\n    ) => {\n      inst.addResourceBundle(language, namespace, resources, true, true);\n    },\n\n    getResources: (language?: string, namespace?: string) => {\n      const lang = language ?? inst.language;\n      const ns = namespace ?? config.defaultNamespace ?? \"translation\";\n      return inst.getResourceBundle(lang, ns) ?? null;\n    },\n  };\n};\n"]}

package/build/localization/index.d.ts

@@ -0,0 +1,5 @@
+export type { I18nAdapter, I18nConfig, I18nInstance } from "./types";
+export { createI18n, createI18nAsync, setGlobalI18n, getI18nOrThrow, } from "./localization";
+export { FilesystemAdapter, MemoryAdapter } from "./adapters";
+export { I18nConfigSchema, validateI18nConfig, safeValidateI18nConfig, } from "./validation";
+//# sourceMappingURL=index.d.ts.map

package/build/localization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"./src/","sources":["localization/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAErE,OAAO,EACL,UAAU,EACV,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9D,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,cAAc,CAAC"}

package/build/localization/index.js

@@ -0,0 +1,4 @@
+export { createI18n, createI18nAsync, setGlobalI18n, getI18nOrThrow, } from "./localization";
+export { FilesystemAdapter, MemoryAdapter } from "./adapters";
+export { I18nConfigSchema, validateI18nConfig, safeValidateI18nConfig, } from "./validation";
+//# sourceMappingURL=index.js.map

package/build/localization/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"./src/","sources":["localization/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,UAAU,EACV,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9D,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,cAAc,CAAC","sourcesContent":["export type { I18nAdapter, I18nConfig, I18nInstance } from \"./types\";\n\nexport {\n  createI18n,\n  createI18nAsync,\n  setGlobalI18n,\n  getI18nOrThrow,\n} from \"./localization\";\n\nexport { FilesystemAdapter, MemoryAdapter } from \"./adapters\";\n\nexport {\n  I18nConfigSchema,\n  validateI18nConfig,\n  safeValidateI18nConfig,\n} from \"./validation\";\n"]}

package/build/localization/intl.d.ts

@@ -0,0 +1,6 @@
+import type { I18nAdapter, I18nConfig, I18nInstance } from "./types";
+export declare const createI18n: (adapter?: I18nAdapter, config?: I18nConfig) => I18nInstance;
+export declare const createI18nAsync: (adapter?: I18nAdapter, config?: I18nConfig) => Promise<I18nInstance>;
+export declare const setGlobalI18n: (instance: I18nInstance) => void;
+export declare const getI18nOrThrow: () => I18nInstance;
+//# sourceMappingURL=intl.d.ts.map

package/build/localization/intl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intl.d.ts","sourceRoot":"./src/","sources":["localization/intl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA8BrE,eAAO,MAAM,UAAU,GACrB,UAAU,WAAW,EACrB,SAAS,UAAU,KAClB,YA6CF,CAAC;AAUF,eAAO,MAAM,eAAe,GAC1B,UAAU,WAAW,EACrB,SAAS,UAAU,KAClB,OAAO,CAAC,YAAY,CA+CtB,CAAC;AAQF,eAAO,MAAM,aAAa,GAAI,UAAU,YAAY,KAAG,IAEtD,CAAC;AAEF,eAAO,MAAM,cAAc,QAAO,YAOjC,CAAC"}