@docyrus/i18n 0.0.1

package/dist/vue/index.js

@@ -0,0 +1,350 @@
+import { defineComponent, ref, shallowRef, provide, onMounted, watch, onUnmounted, inject, computed } from 'vue';
+
+// src/vue/index.ts
+
+// src/core/interpolation.ts
+function interpolate(template, params) {
+  if (!params) return template;
+  return template.replace(
+    /\{\{(\w+)\}\}|\{(\w+)\}/g,
+    (match, doubleBraceKey, singleBraceKey) => {
+      const key = doubleBraceKey ?? singleBraceKey;
+      if (key === void 0) return match;
+      const value = params[key];
+      return value !== void 0 ? String(value) : match;
+    }
+  );
+}
+
+// src/core/locale-storage.ts
+var DEFAULT_MAX_AGE = 365 * 24 * 60 * 60;
+function getLocale(cookieKey) {
+  if (typeof document === "undefined") return null;
+  const match = document.cookie.match(new RegExp(`(?:^|;\\s*)${escapeRegex(cookieKey)}=([^;]*)`));
+  return match ? decodeURIComponent(match[1]) : null;
+}
+function setLocale(cookieKey, locale) {
+  if (typeof document === "undefined") return;
+  document.cookie = `${cookieKey}=${encodeURIComponent(locale)};path=/;max-age=${DEFAULT_MAX_AGE};SameSite=Lax`;
+}
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+// src/core/i18n-manager.ts
+var I18nManager = class {
+  status = "loading";
+  locale;
+  translations = {};
+  apiTranslations = {};
+  error = null;
+  listeners = /* @__PURE__ */ new Set();
+  abortController = null;
+  client;
+  getAccessToken;
+  apiUrl;
+  translationsEndpoint;
+  staticTranslations;
+  cookieKey;
+  mergeStrategy;
+  fallback;
+  disableApiFetch;
+  userLanguageEndpoint;
+  constructor(config) {
+    this.client = config.client ?? null;
+    this.getAccessToken = config.getAccessToken;
+    this.apiUrl = config.apiUrl;
+    this.translationsEndpoint = config.translationsEndpoint ?? "tenant/translations";
+    this.staticTranslations = config.staticTranslations ?? {};
+    this.cookieKey = config.cookieKey ?? "docyrus-locale";
+    this.mergeStrategy = config.mergeStrategy ?? "api-first";
+    this.fallback = config.fallback ?? "key";
+    this.disableApiFetch = config.disableApiFetch ?? false;
+    this.userLanguageEndpoint = config.userLanguageEndpoint ?? "users/me";
+    this.locale = getLocale(this.cookieKey);
+  }
+  getStatus() {
+    return this.status;
+  }
+  getLocale() {
+    return this.locale;
+  }
+  getTranslations() {
+    return this.translations;
+  }
+  getError() {
+    return this.error;
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+  notify() {
+    for (const listener of this.listeners) {
+      listener({
+        status: this.status,
+        locale: this.locale,
+        translations: this.translations,
+        error: this.error
+      });
+    }
+  }
+  /**
+   * Initialize the manager.
+   * 1. Apply static translations immediately (no loading flash).
+   * 2. Fetch from API if enabled and auth is available.
+   */
+  async initialize() {
+    if (Object.keys(this.staticTranslations).length > 0) {
+      this.translations = { ...this.staticTranslations };
+      this.status = "ready";
+      this.notify();
+    }
+    if (!this.disableApiFetch && (this.client || this.getAccessToken)) {
+      await this.fetchTranslations();
+    } else if (this.status !== "ready") {
+      this.status = "ready";
+      this.notify();
+    }
+  }
+  /**
+   * Fetch translations from the API.
+   * Uses RestApiClient.get() if client is available, otherwise raw fetch with getAccessToken.
+   */
+  async fetchTranslations() {
+    this.abortController?.abort();
+    this.abortController = new AbortController();
+    try {
+      let apiData;
+      if (this.client) {
+        apiData = await this.client.get(
+          this.translationsEndpoint
+        );
+      } else if (this.getAccessToken && this.apiUrl) {
+        const token = await this.getAccessToken();
+        if (!token) {
+          throw new Error("getAccessToken returned null \u2014 cannot fetch translations");
+        }
+        const url = `${this.apiUrl.replace(/\/$/, "")}/${this.translationsEndpoint}`;
+        const res = await fetch(url, {
+          headers: { Authorization: `Bearer ${token}` },
+          signal: this.abortController.signal
+        });
+        if (!res.ok) {
+          throw new Error(`Translation fetch failed: ${res.status} ${res.statusText}`);
+        }
+        apiData = await res.json();
+      } else {
+        return;
+      }
+      this.apiTranslations = apiData.data;
+      this.mergeTranslations();
+      this.error = null;
+      this.status = "ready";
+      this.notify();
+    } catch (err) {
+      if (err.name === "AbortError") return;
+      this.error = err instanceof Error ? err : new Error(String(err));
+      if (Object.keys(this.translations).length > 0) {
+        this.notify();
+      } else {
+        this.status = "error";
+        this.notify();
+      }
+    }
+  }
+  /**
+   * Translate a key with optional interpolation.
+   * Falls back based on the configured strategy.
+   */
+  t(key, params) {
+    const value = this.translations[key];
+    if (value !== void 0) {
+      return interpolate(value, params);
+    }
+    if (this.fallback === "key") return key;
+    if (this.fallback === "empty") return "";
+    return this.fallback(key);
+  }
+  /**
+   * Change the active locale.
+   * Writes to cookie, persists to API (PATCH users/me), and triggers translation refetch.
+   */
+  async setLocale(locale) {
+    if (locale === this.locale) return;
+    this.locale = locale;
+    setLocale(this.cookieKey, locale);
+    this.notify();
+    const promises = [];
+    if (this.userLanguageEndpoint !== false && (this.client || this.getAccessToken)) {
+      promises.push(this.persistUserLanguage(locale));
+    }
+    if (!this.disableApiFetch && (this.client || this.getAccessToken)) {
+      promises.push(this.fetchTranslations());
+    }
+    await Promise.all(promises);
+  }
+  /**
+   * Persist user language preference to API.
+   * PATCH {userLanguageEndpoint} { language: locale }
+   */
+  async persistUserLanguage(locale) {
+    if (this.userLanguageEndpoint === false) return;
+    try {
+      if (this.client) {
+        await this.client.patch(this.userLanguageEndpoint, { language: locale });
+      } else if (this.getAccessToken && this.apiUrl) {
+        const token = await this.getAccessToken();
+        if (!token) return;
+        const url = `${this.apiUrl.replace(/\/$/, "")}/${this.userLanguageEndpoint}`;
+        await fetch(url, {
+          method: "PATCH",
+          headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify({ language: locale })
+        });
+      }
+    } catch {
+    }
+  }
+  /**
+   * Update config at runtime.
+   * Useful when client transitions from null → RestApiClient (auth loading complete).
+   */
+  updateConfig(updates) {
+    let shouldFetch = false;
+    if (updates.client !== void 0 && updates.client !== this.client) {
+      const hadNoClient = !this.client;
+      this.client = updates.client;
+      if (hadNoClient && this.client && !this.disableApiFetch) {
+        shouldFetch = true;
+      }
+    }
+    if (updates.staticTranslations !== void 0) {
+      this.staticTranslations = updates.staticTranslations;
+      this.mergeTranslations();
+      this.notify();
+    }
+    if (shouldFetch) {
+      this.fetchTranslations();
+    }
+  }
+  /** Cleanup: abort in-flight requests + clear listeners. */
+  destroy() {
+    this.abortController?.abort();
+    this.listeners.clear();
+  }
+  mergeTranslations() {
+    if (this.mergeStrategy === "api-first") {
+      this.translations = { ...this.staticTranslations, ...this.apiTranslations };
+    } else {
+      this.translations = { ...this.apiTranslations, ...this.staticTranslations };
+    }
+  }
+};
+
+// src/vue/index.ts
+var DOCYRUS_I18N_KEY = /* @__PURE__ */ Symbol("docyrus-i18n");
+function useDocyrusI18n() {
+  const context = inject(DOCYRUS_I18N_KEY);
+  if (!context) {
+    throw new Error(
+      "useDocyrusI18n() must be used within a <DocyrusI18nProvider>. Wrap your app with <DocyrusI18nProvider> to provide i18n context."
+    );
+  }
+  return context;
+}
+function useTranslation() {
+  const context = useDocyrusI18n();
+  return {
+    t: computed(() => context.t),
+    isLoading: computed(() => context.isLoading)
+  };
+}
+var DocyrusI18nProvider = defineComponent({
+  name: "DocyrusI18nProvider",
+  props: {
+    client: { type: Object, default: null },
+    getAccessToken: { type: Function, default: void 0 },
+    apiUrl: { type: String, default: void 0 },
+    translationsEndpoint: { type: String, default: void 0 },
+    staticTranslations: { type: Object, default: void 0 },
+    cookieKey: { type: String, default: void 0 },
+    mergeStrategy: { type: String, default: void 0 },
+    fallback: { type: [String, Function], default: void 0 },
+    disableApiFetch: { type: Boolean, default: void 0 }
+  },
+  setup(props, { slots }) {
+    const status = ref("loading");
+    const locale = ref(null);
+    const translations = shallowRef({});
+    const error = shallowRef(null);
+    let manager = null;
+    const setLocale2 = (newLocale) => {
+      manager?.setLocale(newLocale);
+    };
+    const refetch = async () => {
+      await manager?.fetchTranslations();
+    };
+    const t = (key, params) => {
+      return manager?.t(key, params) ?? key;
+    };
+    const i18nState = {
+      get status() {
+        return status.value;
+      },
+      get locale() {
+        return locale.value;
+      },
+      get translations() {
+        return translations.value;
+      },
+      get error() {
+        return error.value;
+      },
+      get isLoading() {
+        return status.value === "loading";
+      },
+      t,
+      setLocale: setLocale2,
+      refetch
+    };
+    provide(DOCYRUS_I18N_KEY, i18nState);
+    onMounted(() => {
+      const config = {
+        client: props.client,
+        getAccessToken: props.getAccessToken,
+        apiUrl: props.apiUrl,
+        translationsEndpoint: props.translationsEndpoint,
+        staticTranslations: props.staticTranslations,
+        cookieKey: props.cookieKey,
+        mergeStrategy: props.mergeStrategy,
+        fallback: props.fallback,
+        disableApiFetch: props.disableApiFetch
+      };
+      manager = new I18nManager(config);
+      locale.value = manager.getLocale();
+      manager.subscribe((state) => {
+        status.value = state.status;
+        locale.value = state.locale;
+        translations.value = state.translations;
+        error.value = state.error;
+      });
+      manager.initialize();
+    });
+    watch(() => props.client, (newClient) => {
+      manager?.updateConfig({ client: newClient });
+    });
+    onUnmounted(() => {
+      manager?.destroy();
+      manager = null;
+    });
+    return () => slots.default?.();
+  }
+});
+
+export { DocyrusI18nProvider, useDocyrusI18n, useTranslation };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/vue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/interpolation.ts","../../src/core/locale-storage.ts","../../src/core/i18n-manager.ts","../../src/vue/index.ts"],"names":["setLocale"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Interpolate placeholders in a translation string.\n *\n * Supports three formats (checked in order):\n *   1. {{variable}}  — double-brace (static translations convention)\n *   2. {variable}    — single-brace named (API convention: \"Talk to {name} AI\")\n *   3. {0}, {1}      — single-brace positional (API convention: \"Add New {0}\")\n *\n * Positional placeholders use numeric keys: params = { '0': 'User' }\n *\n * Examples:\n *   interpolate('Hello, {{name}}!', { name: 'Ali' })     → 'Hello, Ali!'\n *   interpolate('Talk to {name} AI', { name: 'Docyrus' }) → 'Talk to Docyrus AI'\n *   interpolate('Add New {0}', { '0': 'User' })           → 'Add New User'\n */\nexport function interpolate(\n  template: string,\n  params?: Record<string, string | number>\n): string {\n  if (!params) return template;\n\n  // Match both {{key}} and {key} — double-brace first, then single-brace\n  return template.replace(\n    /\\{\\{(\\w+)\\}\\}|\\{(\\w+)\\}/g,\n    (match, doubleBraceKey: string | undefined, singleBraceKey: string | undefined) => {\n      const key = doubleBraceKey ?? singleBraceKey;\n\n      if (key === undefined) return match;\n\n      const value = params[key];\n\n      return value !== undefined ? String(value) : match;\n    }\n  );\n}\n","const DEFAULT_MAX_AGE = 365 * 24 * 60 * 60; // 1 year in seconds\n\n/**\n * Read the locale from a cookie. SSR-safe.\n * Returns null if the cookie is not set or not in a browser environment.\n */\nexport function getLocale(cookieKey: string): string | null {\n  if (typeof document === 'undefined') return null;\n\n  const match = document.cookie.match(new RegExp(`(?:^|;\\\\s*)${escapeRegex(cookieKey)}=([^;]*)`));\n\n  return match ? decodeURIComponent(match[1]) : null;\n}\n\n/**\n * Write the locale to a cookie. SSR-safe (no-op on server).\n */\nexport function setLocale(cookieKey: string, locale: string): void {\n  if (typeof document === 'undefined') return;\n\n  document.cookie = `${cookieKey}=${encodeURIComponent(locale)};path=/;max-age=${DEFAULT_MAX_AGE};SameSite=Lax`;\n}\n\nfunction escapeRegex(str: string): string {\n  return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n","import { type RestApiClient } from '@docyrus/api-client';\n\nimport {\n  type DocyrusI18nConfig,\n  type FallbackStrategy,\n  type I18nStatus,\n  type TranslationDictionary,\n  type TranslationsResponse\n} from '../types';\n\nimport { interpolate } from './interpolation';\nimport { getLocale, setLocale as writeLocaleCookie } from './locale-storage';\n\nexport type I18nStateListener = (state: {\n  status: I18nStatus;\n  locale: string | null;\n  translations: TranslationDictionary;\n  error: Error | null;\n}) => void;\n\n/**\n * Framework-agnostic translation engine.\n *\n * Manages locale persistence (cookie), translation fetching (API + static merge),\n * and provides the `t()` function for translation lookup with interpolation.\n *\n * Pattern follows AuthManager from @docyrus/app-auth-ui.\n */\nexport class I18nManager {\n  private status: I18nStatus = 'loading';\n  private locale: string | null;\n  private translations: TranslationDictionary = {};\n  private apiTranslations: TranslationDictionary = {};\n  private error: Error | null = null;\n  private listeners: Set<I18nStateListener> = new Set();\n  private abortController: AbortController | null = null;\n  private client: RestApiClient | null;\n  private getAccessToken: (() => Promise<string | null> | string | null) | undefined;\n  private apiUrl: string | undefined;\n  private translationsEndpoint: string;\n  private staticTranslations: TranslationDictionary;\n  private cookieKey: string;\n  private mergeStrategy: 'api-first' | 'static-first';\n  private fallback: FallbackStrategy;\n  private disableApiFetch: boolean;\n  private userLanguageEndpoint: string | false;\n  constructor(config: DocyrusI18nConfig) {\n    this.client = config.client ?? null;\n    this.getAccessToken = config.getAccessToken;\n    this.apiUrl = config.apiUrl;\n    this.translationsEndpoint = config.translationsEndpoint ?? 'tenant/translations';\n    this.staticTranslations = config.staticTranslations ?? {};\n    this.cookieKey = config.cookieKey ?? 'docyrus-locale';\n    this.mergeStrategy = config.mergeStrategy ?? 'api-first';\n    this.fallback = config.fallback ?? 'key';\n    this.disableApiFetch = config.disableApiFetch ?? false;\n    this.userLanguageEndpoint = config.userLanguageEndpoint ?? 'users/me';\n\n    // Read locale from cookie (null if not set — API resolves from user profile)\n    this.locale = getLocale(this.cookieKey);\n  }\n  getStatus(): I18nStatus {\n    return this.status;\n  }\n  getLocale(): string | null {\n    return this.locale;\n  }\n  getTranslations(): TranslationDictionary {\n    return this.translations;\n  }\n  getError(): Error | null {\n    return this.error;\n  }\n  subscribe(listener: I18nStateListener): () => void {\n    this.listeners.add(listener);\n\n    return () => this.listeners.delete(listener);\n  }\n  private notify(): void {\n    for (const listener of this.listeners) {\n      listener({\n        status: this.status,\n        locale: this.locale,\n        translations: this.translations,\n        error: this.error\n      });\n    }\n  }\n  /**\n   * Initialize the manager.\n   * 1. Apply static translations immediately (no loading flash).\n   * 2. Fetch from API if enabled and auth is available.\n   */\n  async initialize(): Promise<void> {\n    // Apply static translations immediately\n    if (Object.keys(this.staticTranslations).length > 0) {\n      this.translations = { ...this.staticTranslations };\n      this.status = 'ready';\n      this.notify();\n    }\n\n    // Fetch from API\n    if (!this.disableApiFetch && (this.client || this.getAccessToken)) {\n      await this.fetchTranslations();\n    } else if (this.status !== 'ready') {\n      // No static translations and no API fetch — mark ready with empty translations\n      this.status = 'ready';\n      this.notify();\n    }\n  }\n  /**\n   * Fetch translations from the API.\n   * Uses RestApiClient.get() if client is available, otherwise raw fetch with getAccessToken.\n   */\n  async fetchTranslations(): Promise<void> {\n    // Abort any in-flight request\n    this.abortController?.abort();\n    this.abortController = new AbortController();\n\n    try {\n      let apiData: TranslationsResponse;\n\n      if (this.client) {\n        apiData = await this.client.get<TranslationsResponse>(\n          this.translationsEndpoint\n        );\n      } else if (this.getAccessToken && this.apiUrl) {\n        const token = await this.getAccessToken();\n\n        if (!token) {\n          throw new Error('getAccessToken returned null — cannot fetch translations');\n        }\n\n        const url = `${this.apiUrl.replace(/\\/$/, '')}/${this.translationsEndpoint}`;\n        const res = await fetch(url, {\n          headers: { Authorization: `Bearer ${token}` },\n          signal: this.abortController.signal\n        });\n\n        if (!res.ok) {\n          throw new Error(`Translation fetch failed: ${res.status} ${res.statusText}`);\n        }\n\n        apiData = await res.json() as TranslationsResponse;\n      } else {\n        // No auth available yet — skip silently\n        return;\n      }\n\n      this.apiTranslations = apiData.data;\n      this.mergeTranslations();\n      this.error = null;\n      this.status = 'ready';\n      this.notify();\n    } catch (err) {\n      if ((err as Error).name === 'AbortError') return;\n\n      this.error = err instanceof Error ? err : new Error(String(err));\n\n      // If we already have static translations, stay 'ready' with error\n      if (Object.keys(this.translations).length > 0) {\n        this.notify();\n      } else {\n        this.status = 'error';\n        this.notify();\n      }\n    }\n  }\n  /**\n   * Translate a key with optional interpolation.\n   * Falls back based on the configured strategy.\n   */\n  t(key: string, params?: Record<string, string | number>): string {\n    const value = this.translations[key];\n\n    if (value !== undefined) {\n      return interpolate(value, params);\n    }\n\n    // Fallback\n    if (this.fallback === 'key') return key;\n    if (this.fallback === 'empty') return '';\n\n    return this.fallback(key);\n  }\n  /**\n   * Change the active locale.\n   * Writes to cookie, persists to API (PATCH users/me), and triggers translation refetch.\n   */\n  async setLocale(locale: string): Promise<void> {\n    if (locale === this.locale) return;\n\n    this.locale = locale;\n    writeLocaleCookie(this.cookieKey, locale);\n    this.notify();\n\n    // Persist language preference to API + refetch translations in parallel\n    const promises: Promise<void>[] = [];\n\n    if (this.userLanguageEndpoint !== false && (this.client || this.getAccessToken)) {\n      promises.push(this.persistUserLanguage(locale));\n    }\n\n    if (!this.disableApiFetch && (this.client || this.getAccessToken)) {\n      promises.push(this.fetchTranslations());\n    }\n\n    await Promise.all(promises);\n  }\n  /**\n   * Persist user language preference to API.\n   * PATCH {userLanguageEndpoint} { language: locale }\n   */\n  private async persistUserLanguage(locale: string): Promise<void> {\n    if (this.userLanguageEndpoint === false) return;\n\n    try {\n      if (this.client) {\n        await this.client.patch(this.userLanguageEndpoint, { language: locale });\n      } else if (this.getAccessToken && this.apiUrl) {\n        const token = await this.getAccessToken();\n\n        if (!token) return;\n\n        const url = `${this.apiUrl.replace(/\\/$/, '')}/${this.userLanguageEndpoint}`;\n\n        await fetch(url, {\n          method: 'PATCH',\n          headers: {\n            Authorization: `Bearer ${token}`,\n            'Content-Type': 'application/json'\n          },\n          body: JSON.stringify({ language: locale })\n        });\n      }\n    } catch {\n      // Language persist is best-effort — don't block locale switch on failure\n    }\n  }\n  /**\n   * Update config at runtime.\n   * Useful when client transitions from null → RestApiClient (auth loading complete).\n   */\n  updateConfig(updates: Partial<Pick<DocyrusI18nConfig, 'client' | 'staticTranslations'>>): void {\n    let shouldFetch = false;\n\n    if (updates.client !== undefined && updates.client !== this.client) {\n      const hadNoClient = !this.client;\n\n      this.client = updates.client;\n\n      // Client became available — fetch translations\n      if (hadNoClient && this.client && !this.disableApiFetch) {\n        shouldFetch = true;\n      }\n    }\n\n    if (updates.staticTranslations !== undefined) {\n      this.staticTranslations = updates.staticTranslations;\n      this.mergeTranslations();\n      this.notify();\n    }\n\n    if (shouldFetch) {\n      this.fetchTranslations();\n    }\n  }\n  /** Cleanup: abort in-flight requests + clear listeners. */\n  destroy(): void {\n    this.abortController?.abort();\n    this.listeners.clear();\n  }\n  private mergeTranslations(): void {\n    if (this.mergeStrategy === 'api-first') {\n      this.translations = { ...this.staticTranslations, ...this.apiTranslations };\n    } else {\n      this.translations = { ...this.apiTranslations, ...this.staticTranslations };\n    }\n  }\n}\n","\nimport { type RestApiClient } from '@docyrus/api-client';\n\nimport {\n  ref,\n  shallowRef,\n  computed,\n  defineComponent,\n  inject,\n  provide,\n  watch,\n  onMounted,\n  onUnmounted,\n  type InjectionKey,\n  type PropType\n} from 'vue';\n\nimport {\n  type DocyrusI18nConfig,\n  type FallbackStrategy,\n  type I18nStatus,\n  type TranslationDictionary\n} from '../types';\n\nimport { I18nManager } from '../core/i18n-manager';\n\n// ─── Internal reactive i18n state ────────────────────────────────\n\ninterface DocyrusI18nState {\n  status: I18nStatus;\n  locale: string | null;\n  translations: TranslationDictionary;\n  error: Error | null;\n  isLoading: boolean;\n  t: (key: string, params?: Record<string, string | number>) => string;\n  setLocale: (locale: string) => void;\n  refetch: () => Promise<void>;\n}\n\nconst DOCYRUS_I18N_KEY: InjectionKey<DocyrusI18nState> = Symbol('docyrus-i18n');\n\n// ─── Composables ─────────────────────────────────────────────────\n\n/**\n * Vue composable to access full Docyrus i18n state.\n * Must be used within a `<DocyrusI18nProvider>`.\n *\n * Returns: { t, locale, setLocale, status, isLoading, translations, error, refetch }\n */\nexport function useDocyrusI18n(): DocyrusI18nState {\n  const context = inject(DOCYRUS_I18N_KEY);\n\n  if (!context) {\n    throw new Error(\n      'useDocyrusI18n() must be used within a <DocyrusI18nProvider>. '\n      + 'Wrap your app with <DocyrusI18nProvider> to provide i18n context.'\n    );\n  }\n\n  return context;\n}\n\n/**\n * Lightweight composable for translation only.\n * Returns just `t` and `isLoading`.\n */\nexport function useTranslation() {\n  const context = useDocyrusI18n();\n\n  return {\n    t: computed(() => context.t),\n    isLoading: computed(() => context.isLoading)\n  };\n}\n\n// ─── Components ──────────────────────────────────────────────────\n\n/**\n * Vue provider component that wraps your app with Docyrus i18n context.\n *\n * Usage:\n * ```vue\n * <template>\n *   <DocyrusI18nProvider :client=\"client\">\n *     <App />\n *   </DocyrusI18nProvider>\n * </template>\n *\n * <script setup>\n * import { DocyrusI18nProvider } from '@docyrus/i18n/vue';\n * </script>\n * ```\n */\nexport const DocyrusI18nProvider = defineComponent({\n  name: 'DocyrusI18nProvider',\n  props: {\n    client: { type: Object as PropType<RestApiClient | null>, default: null },\n    getAccessToken: { type: Function as PropType<() => Promise<string | null> | string | null>, default: undefined },\n    apiUrl: { type: String, default: undefined },\n    translationsEndpoint: { type: String, default: undefined },\n    staticTranslations: { type: Object as PropType<TranslationDictionary>, default: undefined },\n    cookieKey: { type: String, default: undefined },\n    mergeStrategy: { type: String as PropType<'api-first' | 'static-first'>, default: undefined },\n    fallback: { type: [String, Function] as PropType<FallbackStrategy>, default: undefined },\n    disableApiFetch: { type: Boolean, default: undefined }\n  },\n  setup(props, { slots }) {\n    const status = ref<I18nStatus>('loading');\n    const locale = ref<string | null>(null);\n    const translations = shallowRef<TranslationDictionary>({});\n    const error = shallowRef<Error | null>(null);\n\n    let manager: I18nManager | null = null;\n\n    const setLocale = (newLocale: string) => {\n      manager?.setLocale(newLocale);\n    };\n\n    const refetch = async () => {\n      await manager?.fetchTranslations();\n    };\n\n    const t = (key: string, params?: Record<string, string | number>) => {\n      return manager?.t(key, params) ?? key;\n    };\n\n    const i18nState: DocyrusI18nState = {\n      get status() { return status.value; },\n      get locale() { return locale.value; },\n      get translations() { return translations.value; },\n      get error() { return error.value; },\n      get isLoading() { return status.value === 'loading'; },\n      t,\n      setLocale,\n      refetch\n    };\n\n    provide(DOCYRUS_I18N_KEY, i18nState);\n\n    onMounted(() => {\n      const config: DocyrusI18nConfig = {\n        client: props.client,\n        getAccessToken: props.getAccessToken,\n        apiUrl: props.apiUrl,\n        translationsEndpoint: props.translationsEndpoint,\n        staticTranslations: props.staticTranslations,\n        cookieKey: props.cookieKey,\n        mergeStrategy: props.mergeStrategy,\n        fallback: props.fallback,\n        disableApiFetch: props.disableApiFetch\n      };\n\n      manager = new I18nManager(config);\n      locale.value = manager.getLocale();\n\n      manager.subscribe((state) => {\n        status.value = state.status;\n        locale.value = state.locale;\n        translations.value = state.translations;\n        error.value = state.error;\n      });\n\n      manager.initialize();\n    });\n\n    // Watch client prop for null → value transition\n    watch(() => props.client, (newClient) => {\n      manager?.updateConfig({ client: newClient });\n    });\n\n    onUnmounted(() => {\n      manager?.destroy();\n      manager = null;\n    });\n\n    return () => slots.default?.();\n  }\n});\n\n// ─── Type re-exports ─────────────────────────────────────────────\n\nexport type {\n  DocyrusI18nState,\n  DocyrusI18nConfig,\n  I18nStatus,\n  TranslationDictionary,\n  FallbackStrategy\n};\n"]}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@docyrus/i18n",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./core": {
+      "import": "./dist/core-index.js",
+      "types": "./dist/core-index.d.ts"
+    },
+    "./vue": {
+      "import": "./dist/vue/index.js",
+      "types": "./dist/vue/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "author": "Docyrus",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Docyrus/docyrus-devkit.git",
+    "directory": "packages/i18n"
+  },
+  "devDependencies": {
+    "@types/node": "25.2.3",
+    "@types/react": "19.2.13",
+    "react": "19.2.4",
+    "tsup": "8.5.1",
+    "typescript": "5.9.3",
+    "vue": "3.5.28",
+    "@docyrus/api-client": "0.0.9"
+  },
+  "peerDependencies": {
+    "@docyrus/api-client": ">=0.0.9",
+    "react": ">=19.2.0",
+    "vue": ">=3.5.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src",
+    "format": "eslint src --fix",
+    "typecheck": "eslint src && tsc --noEmit",
+    "deploy": "pnpm run build && pnpm publish --access public"
+  }
+}