@docyrus/i18n 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { D as DocyrusI18nConfig, a as DocyrusI18nContextValue } from './types-DQtgewNG.js';
+export { F as FallbackStrategy, I as I18nStatus, T as TranslationDictionary, b as TranslationsResponse } from './types-DQtgewNG.js';
+export { I18nManager, I18nStateListener, getLocale, interpolate, setLocale } from './core-index.js';
+import '@docyrus/api-client';
+
+declare const DocyrusI18nContext: react.Context<DocyrusI18nContextValue | null>;
+interface DocyrusI18nProviderProps extends DocyrusI18nConfig {
+    children: ReactNode;
+}
+declare function DocyrusI18nProvider({ children, ...config }: DocyrusI18nProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Access the full Docyrus i18n context.
+ * Must be used within a `<DocyrusI18nProvider>`.
+ *
+ * Returns: { t, locale, setLocale, status, isLoading, translations, error, refetch }
+ */
+declare function useDocyrusI18n(): DocyrusI18nContextValue;
+
+/**
+ * Lightweight hook for translation only.
+ * Returns just `t` and `isLoading` — use `useDocyrusI18n()` for full context.
+ *
+ * Must be used within a `<DocyrusI18nProvider>`.
+ */
+declare function useTranslation(): {
+    t: (key: string, params?: Record<string, string | number>) => string;
+    isLoading: boolean;
+};
+
+export { DocyrusI18nConfig, DocyrusI18nContext, DocyrusI18nContextValue, DocyrusI18nProvider, type DocyrusI18nProviderProps, useDocyrusI18n, useTranslation };

package/dist/index.js

@@ -0,0 +1,340 @@
+import { createContext, useState, useRef, useEffect, useCallback, useMemo, useContext } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+// src/components/docyrus-i18n-provider.tsx
+
+// 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 };
+    }
+  }
+};
+var DocyrusI18nContext = createContext(null);
+function DocyrusI18nProvider({
+  children,
+  ...config
+}) {
+  const [status, setStatus] = useState(
+    config.staticTranslations && Object.keys(config.staticTranslations).length > 0 ? "ready" : "loading"
+  );
+  const [locale, setLocaleState] = useState(null);
+  const [translations, setTranslations] = useState(
+    config.staticTranslations ?? {}
+  );
+  const [error, setError] = useState(null);
+  const managerRef = useRef(null);
+  useEffect(() => {
+    const manager = new I18nManager(config);
+    managerRef.current = manager;
+    setLocaleState(manager.getLocale());
+    const unsubscribe = manager.subscribe((state) => {
+      setStatus(state.status);
+      setLocaleState(state.locale);
+      setTranslations(state.translations);
+      setError(state.error);
+    });
+    manager.initialize();
+    return () => {
+      unsubscribe();
+      manager.destroy();
+    };
+  }, []);
+  const clientRef = useRef(config.client);
+  useEffect(() => {
+    if (config.client !== clientRef.current) {
+      clientRef.current = config.client;
+      managerRef.current?.updateConfig({ client: config.client });
+    }
+  }, [config.client]);
+  const setLocale2 = useCallback((newLocale) => {
+    managerRef.current?.setLocale(newLocale);
+  }, []);
+  const refetch = useCallback(async () => {
+    await managerRef.current?.fetchTranslations();
+  }, []);
+  const t = useCallback(
+    (key, params) => {
+      return managerRef.current?.t(key, params) ?? key;
+    },
+    // Re-create t when translations change so consumers re-render
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [translations]
+  );
+  const value = useMemo(() => ({
+    t,
+    locale,
+    setLocale: setLocale2,
+    status,
+    isLoading: status === "loading",
+    translations,
+    error,
+    refetch
+  }), [
+    t,
+    locale,
+    setLocale2,
+    status,
+    translations,
+    error,
+    refetch
+  ]);
+  return /* @__PURE__ */ jsx(DocyrusI18nContext.Provider, { value, children });
+}
+function useDocyrusI18n() {
+  const context = useContext(DocyrusI18nContext);
+  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 = useContext(DocyrusI18nContext);
+  if (!context) {
+    throw new Error(
+      "useTranslation() must be used within a <DocyrusI18nProvider>. Wrap your app with <DocyrusI18nProvider> to provide i18n context."
+    );
+  }
+  return { t: context.t, isLoading: context.isLoading };
+}
+
+export { DocyrusI18nContext, DocyrusI18nProvider, I18nManager, getLocale, interpolate, setLocale, useDocyrusI18n, useTranslation };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/interpolation.ts","../src/core/locale-storage.ts","../src/core/i18n-manager.ts","../src/components/docyrus-i18n-provider.tsx","../src/hooks/use-i18n.ts","../src/hooks/use-translation.ts"],"names":["setLocale","useContext"],"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","'use client';\n\nimport {\n  createContext,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode\n} from 'react';\n\nimport { type RestApiClient } from '@docyrus/api-client';\n\nimport {\n  type DocyrusI18nConfig,\n  type DocyrusI18nContextValue,\n  type I18nStatus,\n  type TranslationDictionary\n} from '../types';\n\nimport { I18nManager } from '../core/i18n-manager';\n\nexport const DocyrusI18nContext = createContext<DocyrusI18nContextValue | null>(null);\n\nexport interface DocyrusI18nProviderProps extends DocyrusI18nConfig {\n  children: ReactNode;\n}\n\nexport function DocyrusI18nProvider({\n  children,\n  ...config\n}: DocyrusI18nProviderProps) {\n  const [status, setStatus] = useState<I18nStatus>(\n    config.staticTranslations && Object.keys(config.staticTranslations).length > 0 ? 'ready' : 'loading'\n  );\n  const [locale, setLocaleState] = useState<string | null>(null);\n  const [translations, setTranslations] = useState<TranslationDictionary>(\n    config.staticTranslations ?? {}\n  );\n  const [error, setError] = useState<Error | null>(null);\n  const managerRef = useRef<I18nManager | null>(null);\n\n  useEffect(() => {\n    const manager = new I18nManager(config);\n\n    managerRef.current = manager;\n    setLocaleState(manager.getLocale());\n\n    const unsubscribe = manager.subscribe((state) => {\n      setStatus(state.status);\n      setLocaleState(state.locale);\n      setTranslations(state.translations);\n      setError(state.error);\n    });\n\n    manager.initialize();\n\n    return () => {\n      unsubscribe();\n      manager.destroy();\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  // React to client prop changes (null → RestApiClient transition)\n  const clientRef = useRef<RestApiClient | null | undefined>(config.client);\n\n  useEffect(() => {\n    if (config.client !== clientRef.current) {\n      clientRef.current = config.client;\n      managerRef.current?.updateConfig({ client: config.client });\n    }\n  }, [config.client]);\n\n  const setLocale = useCallback((newLocale: string) => {\n    managerRef.current?.setLocale(newLocale);\n  }, []);\n\n  const refetch = useCallback(async () => {\n    await managerRef.current?.fetchTranslations();\n  }, []);\n\n  const t = useCallback(\n    (key: string, params?: Record<string, string | number>) => {\n      return managerRef.current?.t(key, params) ?? key;\n    },\n    // Re-create t when translations change so consumers re-render\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [translations]\n  );\n\n  const value = useMemo<DocyrusI18nContextValue>(() => ({\n    t,\n    locale,\n    setLocale,\n    status,\n    isLoading: status === 'loading',\n    translations,\n    error,\n    refetch\n  }), [\n    t,\n    locale,\n    setLocale,\n    status,\n    translations,\n    error,\n    refetch\n  ]);\n\n  return (\n    <DocyrusI18nContext.Provider value={value}>\n      {children}\n    </DocyrusI18nContext.Provider>\n  );\n}\n","import { useContext } from 'react';\n\nimport { type DocyrusI18nContextValue } from '../types';\n\nimport { DocyrusI18nContext } from '../components/docyrus-i18n-provider';\n\n/**\n * Access the full Docyrus i18n context.\n * Must be used within a `<DocyrusI18nProvider>`.\n *\n * Returns: { t, locale, setLocale, status, isLoading, translations, error, refetch }\n */\nexport function useDocyrusI18n(): DocyrusI18nContextValue {\n  const context = useContext(DocyrusI18nContext);\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","import { useContext } from 'react';\n\nimport { DocyrusI18nContext } from '../components/docyrus-i18n-provider';\n\n/**\n * Lightweight hook for translation only.\n * Returns just `t` and `isLoading` — use `useDocyrusI18n()` for full context.\n *\n * Must be used within a `<DocyrusI18nProvider>`.\n */\nexport function useTranslation() {\n  const context = useContext(DocyrusI18nContext);\n\n  if (!context) {\n    throw new Error(\n      'useTranslation() must be used within a <DocyrusI18nProvider>. '\n      + 'Wrap your app with <DocyrusI18nProvider> to provide i18n context.'\n    );\n  }\n\n  return { t: context.t, isLoading: context.isLoading };\n}\n"]}

package/dist/types-DQtgewNG.d.ts

@@ -0,0 +1,55 @@
+import { RestApiClient } from '@docyrus/api-client';
+
+type I18nStatus = 'loading' | 'ready' | 'error';
+type TranslationDictionary = Record<string, string>;
+type FallbackStrategy = 'key' | 'empty' | ((key: string) => string);
+interface TranslationsResponse {
+    success: boolean;
+    data: TranslationDictionary;
+}
+interface DocyrusI18nConfig {
+    /** Pre-configured RestApiClient with auto-refresh tokens. Primary auth method. */
+    client?: RestApiClient | null;
+    /** Alternative auth: callback returning access token string. Used for SSR or custom setups. */
+    getAccessToken?: () => Promise<string | null> | string | null;
+    /** API base URL. Required when using getAccessToken (not needed with client). */
+    apiUrl?: string;
+    /** API endpoint path for translations. Default: 'tenant/translations' */
+    translationsEndpoint?: string;
+    /** Pre-loaded translations (e.g. from SSR or static JSON). Available immediately, no loading state. */
+    staticTranslations?: TranslationDictionary;
+    /** Cookie key for locale persistence. Default: 'docyrus-locale' */
+    cookieKey?: string;
+    /** How to merge static and API translations. Default: 'api-first' */
+    mergeStrategy?: 'api-first' | 'static-first';
+    /** What to return when a key is not found. Default: 'key' */
+    fallback?: FallbackStrategy;
+    /** Skip API fetch entirely. Use only staticTranslations. Default: false */
+    disableApiFetch?: boolean;
+    /**
+     * API endpoint to persist user language preference via PATCH.
+     * Set to false to disable. Default: 'users/me'
+     * Sends: PATCH {endpoint} { language: locale }
+     */
+    userLanguageEndpoint?: string | false;
+}
+interface DocyrusI18nContextValue {
+    /** Translate a key with optional interpolation params. */
+    t: (key: string, params?: Record<string, string | number>) => string;
+    /** Current active locale (null until first setLocale or cookie read). */
+    locale: string | null;
+    /** Change locale — writes cookie + refetches translations. */
+    setLocale: (locale: string) => void;
+    /** Current status of the i18n system. */
+    status: I18nStatus;
+    /** Convenience: true when status is 'loading'. */
+    isLoading: boolean;
+    /** Current merged translations dictionary. */
+    translations: TranslationDictionary;
+    /** Last error, if any. */
+    error: Error | null;
+    /** Manually refetch translations from the API. */
+    refetch: () => Promise<void>;
+}
+
+export type { DocyrusI18nConfig as D, FallbackStrategy as F, I18nStatus as I, TranslationDictionary as T, DocyrusI18nContextValue as a, TranslationsResponse as b };

package/dist/vue/index.d.ts

@@ -0,0 +1,136 @@
+import * as vue from 'vue';
+import { PropType } from 'vue';
+import { RestApiClient } from '@docyrus/api-client';
+import { I as I18nStatus, T as TranslationDictionary, F as FallbackStrategy } from '../types-DQtgewNG.js';
+export { D as DocyrusI18nConfig } from '../types-DQtgewNG.js';
+
+interface DocyrusI18nState {
+    status: I18nStatus;
+    locale: string | null;
+    translations: TranslationDictionary;
+    error: Error | null;
+    isLoading: boolean;
+    t: (key: string, params?: Record<string, string | number>) => string;
+    setLocale: (locale: string) => void;
+    refetch: () => Promise<void>;
+}
+/**
+ * Vue composable to access full Docyrus i18n state.
+ * Must be used within a `<DocyrusI18nProvider>`.
+ *
+ * Returns: { t, locale, setLocale, status, isLoading, translations, error, refetch }
+ */
+declare function useDocyrusI18n(): DocyrusI18nState;
+/**
+ * Lightweight composable for translation only.
+ * Returns just `t` and `isLoading`.
+ */
+declare function useTranslation(): {
+    t: vue.ComputedRef<(key: string, params?: Record<string, string | number>) => string>;
+    isLoading: vue.ComputedRef<boolean>;
+};
+/**
+ * Vue provider component that wraps your app with Docyrus i18n context.
+ *
+ * Usage:
+ * ```vue
+ * <template>
+ *   <DocyrusI18nProvider :client="client">
+ *     <App />
+ *   </DocyrusI18nProvider>
+ * </template>
+ *
+ * <script setup>
+ * import { DocyrusI18nProvider } from '@docyrus/i18n/vue';
+ * </script>
+ * ```
+ */
+declare const DocyrusI18nProvider: vue.DefineComponent<vue.ExtractPropTypes<{
+    client: {
+        type: PropType<RestApiClient | null>;
+        default: null;
+    };
+    getAccessToken: {
+        type: PropType<() => Promise<string | null> | string | null>;
+        default: undefined;
+    };
+    apiUrl: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    translationsEndpoint: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    staticTranslations: {
+        type: PropType<TranslationDictionary>;
+        default: undefined;
+    };
+    cookieKey: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    mergeStrategy: {
+        type: PropType<"api-first" | "static-first">;
+        default: undefined;
+    };
+    fallback: {
+        type: PropType<FallbackStrategy>;
+        default: undefined;
+    };
+    disableApiFetch: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+}>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>[] | undefined, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+    client: {
+        type: PropType<RestApiClient | null>;
+        default: null;
+    };
+    getAccessToken: {
+        type: PropType<() => Promise<string | null> | string | null>;
+        default: undefined;
+    };
+    apiUrl: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    translationsEndpoint: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    staticTranslations: {
+        type: PropType<TranslationDictionary>;
+        default: undefined;
+    };
+    cookieKey: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    mergeStrategy: {
+        type: PropType<"api-first" | "static-first">;
+        default: undefined;
+    };
+    fallback: {
+        type: PropType<FallbackStrategy>;
+        default: undefined;
+    };
+    disableApiFetch: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+}>> & Readonly<{}>, {
+    client: RestApiClient | null;
+    getAccessToken: () => Promise<string | null> | string | null;
+    apiUrl: string;
+    translationsEndpoint: string;
+    staticTranslations: TranslationDictionary;
+    cookieKey: string;
+    mergeStrategy: "api-first" | "static-first";
+    fallback: FallbackStrategy;
+    disableApiFetch: boolean;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+
+export { DocyrusI18nProvider, type DocyrusI18nState, FallbackStrategy, I18nStatus, TranslationDictionary, useDocyrusI18n, useTranslation };