@hua-labs/i18n-core 2.0.0 → 2.0.4

package/dist/index.d.ts

@@ -1,14 +1,85 @@
+import React$1 from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { I as I18nConfig, a as I18nContextType, L as LanguageConfig, R as ResolveStringKey, T as TranslationParams, b as ResolvePluralKey, c as ResolveArrayKey, d as TranslationError } from './server-4TeBq6hp.js';
+export { P as PluralCategory, e as PluralValue, f as Translator, g as TypedTranslationKeys, s as serverTranslate, h as ssrTranslate } from './server-4TeBq6hp.js';
+
+/**
+ * I18n Provider 컴포넌트
+ */
+declare function I18nProvider({ config, children }: {
+    config: I18nConfig & {
+        autoLanguageSync?: boolean;
+    };
+    children: React.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+/**
+ * I18n 훅
+ */
+declare function useI18n(): I18nContextType;
+
+/**
+ * 간단한 번역 훅 (원본 SDK와 호환)
+ *
+ * @example
+ * ```tsx
+ * import { useTranslation } from '@hua-labs/i18n-core';
+ *
+ * function MyComponent() {
+ *   const { t, currentLanguage, setLanguage, isLoading, error } = useTranslation();
+ *
+ *   return (
+ *     <div>
+ *       <h1>{t('welcome')}</h1>
+ *       <p>Current language: {currentLanguage}</p>
+ *       <button onClick={() => setLanguage('en')}>Switch to English</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useTranslation(): {
+    t: (key: ResolveStringKey, paramsOrLang?: TranslationParams | string, language?: string) => string;
+    tPlural: (key: ResolvePluralKey, count: number, params?: Record<string, unknown>, language?: string) => string;
+    tArray: (key: ResolveArrayKey, language?: string) => string[];
+    currentLanguage: string;
+    setLanguage: (language: string) => void | Promise<void>;
+    getRawValue: (key: string, language?: string) => unknown;
+    isLoading: boolean;
+    error: TranslationError | null;
+    supportedLanguages: LanguageConfig[];
+    debug: {
+        getCurrentLanguage: () => string;
+        getSupportedLanguages: () => string[];
+        getLoadedNamespaces: () => string[];
+        getAllTranslations: () => Record<string, Record<string, unknown>>;
+        isReady: () => boolean;
+        getInitializationError: () => TranslationError | null;
+        clearCache: () => void;
+        reloadTranslations: () => Promise<void>;
+        getCacheStats: () => {
+            size: number;
+            hits: number;
+            misses: number;
+        };
+    };
+    isInitialized: boolean;
+};
+/**
+ * 언어 변경 전용 훅
+ */
+declare function useLanguageChange(): {
+    currentLanguage: string;
+    changeLanguage: (language: string) => void;
+    supportedLanguages: LanguageConfig[];
+};
+
 /**
  * @hua-labs/i18n-core - 핵심 기능 전용 엔트리포인트
  *
  * 이 모듈은 기본적인 번역 기능만 필요한 경우 사용합니다.
  * 플러그인, 고급 기능, 디버깅 도구 없이 순수한 번역 기능만 제공합니다.
  */
-import React from 'react';
-import { I18nProvider, useI18n } from './hooks/useI18n';
-import { useTranslation, useLanguageChange } from './hooks/useTranslation';
-import { Translator, ssrTranslate, serverTranslate } from './core/translator';
-import { I18nConfig } from './types';
+
 declare global {
     interface Window {
         __I18N_DEBUG_MODE__?: boolean;
@@ -75,7 +146,7 @@ declare global {
  * }
  * ```
  */
-export declare function createCoreI18n(options?: {
+declare function createCoreI18n(options?: {
     defaultLanguage?: string;
     fallbackLanguage?: string;
     namespaces?: string[];
@@ -98,65 +169,81 @@ export declare function createCoreI18n(options?: {
      * 형식: { [language]: { [namespace]: { [key]: value } } }
      */
     initialTranslations?: Record<string, Record<string, Record<string, string>>>;
+    /**
+     * 지원 언어 목록 (LanguageConfig 배열 또는 언어 코드 문자열 배열)
+     * 기본값: ['ko', 'en']
+     */
+    supportedLanguages?: Array<{
+        code: string;
+        name: string;
+        nativeName: string;
+    }> | string[];
     /**
      * 자동 언어 동기화 활성화 여부
      * 기본값: false (Zustand 어댑터 등 외부에서 직접 처리하는 경우)
      */
     autoLanguageSync?: boolean;
+    /**
+     * 서버사이드 렌더링 시 사용할 기본 URL
+     * 환경 변수보다 우선 적용됨
+     */
+    baseUrl?: string;
+    /**
+     * 로컬 개발 환경 fallback URL
+     * 기본값: 'http://localhost:3010'
+     */
+    localFallbackBaseUrl?: string;
 }): ({ children }: {
-    children: React.ReactNode;
-}) => React.FunctionComponentElement<{
+    children: React$1.ReactNode;
+}) => React$1.FunctionComponentElement<{
     config: I18nConfig & {
         autoLanguageSync?: boolean;
     };
-    children: React.ReactNode;
+    children: React$1.ReactNode;
 }>;
 /**
  * 가장 기본적인 Provider (최소한의 설정)
  */
-export declare function CoreProvider({ children }: {
-    children: React.ReactNode;
-}): React.FunctionComponentElement<{
+declare function CoreProvider({ children }: {
+    children: React$1.ReactNode;
+}): React$1.FunctionComponentElement<{
     config: I18nConfig & {
         autoLanguageSync?: boolean;
     };
-    children: React.ReactNode;
+    children: React$1.ReactNode;
 }>;
 /**
  * 언어별 Provider (언어만 지정)
  */
-export declare function createLanguageProvider(language: string): ({ children }: {
-    children: React.ReactNode;
-}) => React.FunctionComponentElement<{
+declare function createLanguageProvider(language: string): ({ children }: {
+    children: React$1.ReactNode;
+}) => React$1.FunctionComponentElement<{
     config: I18nConfig & {
         autoLanguageSync?: boolean;
     };
-    children: React.ReactNode;
+    children: React$1.ReactNode;
 }>;
 /**
  * 네임스페이스별 Provider (네임스페이스만 지정)
  */
-export declare function createNamespaceProvider(namespaces: string[]): ({ children }: {
-    children: React.ReactNode;
-}) => React.FunctionComponentElement<{
+declare function createNamespaceProvider(namespaces: string[]): ({ children }: {
+    children: React$1.ReactNode;
+}) => React$1.FunctionComponentElement<{
     config: I18nConfig & {
         autoLanguageSync?: boolean;
     };
-    children: React.ReactNode;
+    children: React$1.ReactNode;
 }>;
 /**
  * 커스텀 로더 Provider (사용자 정의 번역 로더 사용)
  */
-export declare function createCustomLoaderProvider(loadTranslations: (language: string, namespace: string) => Promise<Record<string, string>>): ({ children }: {
-    children: React.ReactNode;
-}) => React.FunctionComponentElement<{
+declare function createCustomLoaderProvider(loadTranslations: (language: string, namespace: string) => Promise<Record<string, string>>): ({ children }: {
+    children: React$1.ReactNode;
+}) => React$1.FunctionComponentElement<{
     config: I18nConfig & {
         autoLanguageSync?: boolean;
     };
-    children: React.ReactNode;
+    children: React$1.ReactNode;
 }>;
-export { useTranslation, useLanguageChange, useI18n };
-export { I18nProvider };
-export { Translator, ssrTranslate, serverTranslate };
-export type { I18nConfig };
-//# sourceMappingURL=index.d.ts.map
+
+export { CoreProvider, I18nConfig, I18nContextType, I18nProvider, ResolveArrayKey, ResolvePluralKey, ResolveStringKey, TranslationParams, createCoreI18n, createCustomLoaderProvider, createLanguageProvider, createNamespaceProvider, useI18n, useLanguageChange, useTranslation };