inline-i18n-multi-react 0.4.0 → 0.6.0

package/README.md

@@ -60,14 +60,117 @@ function Nav() {
 }
 ```
 
+## Rich Text
+
+Embed React components within translated strings using `<tag>` syntax.
+
+```tsx
+import { RichText, useRichText } from 'inline-i18n-multi-react'
+
+// Component approach
+function Terms() {
+  return (
+    <RichText
+      translations={{
+        en: 'Read <link>terms</link> and <bold>agree</bold>',
+        ko: '<link>약관</link>을 읽고 <bold>동의</bold>해주세요',
+      }}
+      components={{
+        link: (text) => <a href="/terms">{text}</a>,
+        bold: (text) => <strong>{text}</strong>,
+      }}
+    />
+  )
+}
+
+// Hook approach
+function Legal() {
+  const richT = useRichText({
+    link: (text) => <a href="/terms">{text}</a>,
+    bold: (text) => <strong>{text}</strong>,
+  })
+
+  return <p>{richT({ en: 'Click <link>here</link>', ko: '<link>여기</link> 클릭' })}</p>
+}
+```
+
+## Lazy Loading with useLoadDictionaries
+
+```tsx
+import { useLoadDictionaries, useT } from 'inline-i18n-multi-react'
+
+function Dashboard() {
+  const { isLoading, error } = useLoadDictionaries('ko', 'dashboard')
+  const t = useT()
+
+  if (isLoading) return <Spinner />
+  if (error) return <p>Failed to load translations</p>
+
+  return <h1>{t('dashboard.title')}</h1>
+}
+```
+
+## Automatic Locale Detection
+
+```tsx
+import { LocaleProvider, useDetectedLocale } from 'inline-i18n-multi-react'
+
+function App() {
+  return (
+    <LocaleProvider locale="en">
+      <AutoDetect />
+    </LocaleProvider>
+  )
+}
+
+function AutoDetect() {
+  useDetectedLocale({
+    supportedLocales: ['en', 'ko', 'ja'],
+    defaultLocale: 'en',
+    sources: ['cookie', 'navigator'],
+  })
+
+  return <Content />
+}
+```
+
 ## API
 
-- `LocaleProvider` - Context provider for locale
-- `useLocale()` - Get/set current locale
-- `it(ko, en, vars?)` - Inline translation function
-- `T` - Translation component with language props
-- `useT()` - Hook returning key-based `t()` function
-- `loadDictionaries(dict)` - Load translation dictionaries
+### React-Specific
+
+| Export | Description |
+|---|---|
+| `LocaleProvider` | Context provider for locale |
+| `useLocale()` | Get/set current locale via context |
+| `useT()` | Hook returning key-based `t()` function |
+| `T` | Translation component with language props |
+| `RichText` | Rich text translation component |
+| `useRichText(components)` | Hook for rich text translations |
+| `useLoadDictionaries(locale, namespace?)` | Lazy loading hook with loading/error state |
+| `useDetectedLocale(options)` | Auto-detect and set locale on mount |
+
+### Re-exported from Core
+
+**Inline translations:**
+`it`, `it_ja`, `it_zh`, `it_es`, `it_fr`, `it_de`, `en_ja`, `en_zh`, `en_es`, `en_fr`, `en_de`, `ja_zh`, `ja_es`, `zh_es`
+
+**Locale management:**
+`getLocale`, `setLocale`
+
+**Key-based translations:**
+`t`, `loadDictionaries`, `loadDictionary`, `clearDictionaries`, `hasTranslation`, `getLoadedLocales`, `getDictionary`, `loadAsync`, `isLoaded`
+
+**Configuration:**
+`configure`, `getConfig`, `resetConfig`
+
+**Rich text parsing:**
+`parseRichText`
+
+**Custom formatters:**
+`registerFormatter`, `clearFormatters`
+
+**Locale detection:**
+`detectLocale`
 
 ## Documentation
 

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode } from 'react';
-import { Locale, TranslationVars, Translations } from 'inline-i18n-multi';
-export { Dictionaries, Dictionary, Locale, PluralRules, TranslationVars, Translations, clearDictionaries, en_de, en_es, en_fr, en_ja, en_zh, getDictionary, getLoadedLocales, getLocale, hasTranslation, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadDictionaries, loadDictionary, setLocale, t, zh_es } from 'inline-i18n-multi';
+import React, { ReactNode } from 'react';
+import { Locale, TranslationVars, DetectLocaleOptions, Translations } from 'inline-i18n-multi';
+export { CustomFormatter, DetectLocaleOptions, DetectSource, Dictionaries, Dictionary, Locale, PluralRules, RichTextSegment, TranslationVars, Translations, clearDictionaries, clearFormatters, configure, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, getConfig, getDictionary, getLoadedLocales, getLocale, hasTranslation, isLoaded, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadAsync, loadDictionaries, loadDictionary, parseRichText, registerFormatter, resetConfig, setLocale, t, zh_es } from 'inline-i18n-multi';
 
 interface LocaleProviderProps {
     /**
@@ -33,6 +33,36 @@ declare function useLocale(): [Locale, (locale: Locale) => void];
  * t('items.count', { count: 5 })
  */
 declare function useT(): (key: string, vars?: TranslationVars) => string;
+/**
+ * Hook for lazy loading dictionaries
+ * Automatically loads dictionaries when locale or namespace changes
+ *
+ * @example
+ * function Dashboard() {
+ *   const { isLoading, error } = useLoadDictionaries('ko', 'dashboard')
+ *   if (isLoading) return <Spinner />
+ *   if (error) return <Error message={error.message} />
+ *   return <Content />
+ * }
+ */
+declare function useLoadDictionaries(locale: Locale, namespace?: string): {
+    isLoading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook that auto-detects and sets locale on mount
+ *
+ * @example
+ * function App() {
+ *   useDetectedLocale({
+ *     supportedLocales: ['en', 'ko', 'ja'],
+ *     defaultLocale: 'en',
+ *     sources: ['cookie', 'navigator'],
+ *   })
+ *   return <Content />
+ * }
+ */
+declare function useDetectedLocale(options: DetectLocaleOptions): void;
 
 interface TPropsShorthand {
     /**
@@ -62,4 +92,51 @@ type TProps = (TPropsShorthand | TPropsObject) & TranslationVars;
  */
 declare function T(props: TProps): react_jsx_runtime.JSX.Element;
 
-export { LocaleProvider, T, useLocale, useT };
+type ComponentRenderer = (text: string) => ReactNode;
+interface RichTextProps {
+    /**
+     * Translation map with locale keys
+     * Tags like <link>text</link> will be matched to component renderers
+     */
+    translations: Translations;
+    /**
+     * Component renderers for each tag name
+     * @example { link: (text) => <a href="/terms">{text}</a> }
+     */
+    components: Record<string, ComponentRenderer>;
+    /**
+     * Variables for interpolation (applied before rich text parsing)
+     */
+    vars?: TranslationVars;
+}
+/**
+ * Rich text translation component
+ * Supports embedding React components within translations
+ *
+ * @example
+ * <RichText
+ *   translations={{
+ *     en: 'Read <link>terms</link> and <bold>agree</bold>',
+ *     ko: '<link>약관</link>을 읽고 <bold>동의</bold>해주세요'
+ *   }}
+ *   components={{
+ *     link: (text) => <a href="/terms">{text}</a>,
+ *     bold: (text) => <strong>{text}</strong>
+ *   }}
+ * />
+ */
+declare function RichText({ translations, components, vars }: RichTextProps): React.JSX.Element;
+/**
+ * Hook for rich text translations
+ * Returns a function that resolves translations with component interpolation
+ *
+ * @example
+ * const richT = useRichText({
+ *   link: (text) => <a href="/terms">{text}</a>,
+ *   bold: (text) => <strong>{text}</strong>,
+ * })
+ * return richT({ en: 'Click <link>here</link>', ko: '<link>여기</link> 클릭' })
+ */
+declare function useRichText(components: Record<string, ComponentRenderer>): (translations: Translations, vars?: TranslationVars) => ReactNode;
+
+export { LocaleProvider, RichText, T, useDetectedLocale, useLoadDictionaries, useLocale, useRichText, useT };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode } from 'react';
-import { Locale, TranslationVars, Translations } from 'inline-i18n-multi';
-export { Dictionaries, Dictionary, Locale, PluralRules, TranslationVars, Translations, clearDictionaries, en_de, en_es, en_fr, en_ja, en_zh, getDictionary, getLoadedLocales, getLocale, hasTranslation, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadDictionaries, loadDictionary, setLocale, t, zh_es } from 'inline-i18n-multi';
+import React, { ReactNode } from 'react';
+import { Locale, TranslationVars, DetectLocaleOptions, Translations } from 'inline-i18n-multi';
+export { CustomFormatter, DetectLocaleOptions, DetectSource, Dictionaries, Dictionary, Locale, PluralRules, RichTextSegment, TranslationVars, Translations, clearDictionaries, clearFormatters, configure, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, getConfig, getDictionary, getLoadedLocales, getLocale, hasTranslation, isLoaded, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadAsync, loadDictionaries, loadDictionary, parseRichText, registerFormatter, resetConfig, setLocale, t, zh_es } from 'inline-i18n-multi';
 
 interface LocaleProviderProps {
     /**
@@ -33,6 +33,36 @@ declare function useLocale(): [Locale, (locale: Locale) => void];
  * t('items.count', { count: 5 })
  */
 declare function useT(): (key: string, vars?: TranslationVars) => string;
+/**
+ * Hook for lazy loading dictionaries
+ * Automatically loads dictionaries when locale or namespace changes
+ *
+ * @example
+ * function Dashboard() {
+ *   const { isLoading, error } = useLoadDictionaries('ko', 'dashboard')
+ *   if (isLoading) return <Spinner />
+ *   if (error) return <Error message={error.message} />
+ *   return <Content />
+ * }
+ */
+declare function useLoadDictionaries(locale: Locale, namespace?: string): {
+    isLoading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook that auto-detects and sets locale on mount
+ *
+ * @example
+ * function App() {
+ *   useDetectedLocale({
+ *     supportedLocales: ['en', 'ko', 'ja'],
+ *     defaultLocale: 'en',
+ *     sources: ['cookie', 'navigator'],
+ *   })
+ *   return <Content />
+ * }
+ */
+declare function useDetectedLocale(options: DetectLocaleOptions): void;
 
 interface TPropsShorthand {
     /**
@@ -62,4 +92,51 @@ type TProps = (TPropsShorthand | TPropsObject) & TranslationVars;
  */
 declare function T(props: TProps): react_jsx_runtime.JSX.Element;
 
-export { LocaleProvider, T, useLocale, useT };
+type ComponentRenderer = (text: string) => ReactNode;
+interface RichTextProps {
+    /**
+     * Translation map with locale keys
+     * Tags like <link>text</link> will be matched to component renderers
+     */
+    translations: Translations;
+    /**
+     * Component renderers for each tag name
+     * @example { link: (text) => <a href="/terms">{text}</a> }
+     */
+    components: Record<string, ComponentRenderer>;
+    /**
+     * Variables for interpolation (applied before rich text parsing)
+     */
+    vars?: TranslationVars;
+}
+/**
+ * Rich text translation component
+ * Supports embedding React components within translations
+ *
+ * @example
+ * <RichText
+ *   translations={{
+ *     en: 'Read <link>terms</link> and <bold>agree</bold>',
+ *     ko: '<link>약관</link>을 읽고 <bold>동의</bold>해주세요'
+ *   }}
+ *   components={{
+ *     link: (text) => <a href="/terms">{text}</a>,
+ *     bold: (text) => <strong>{text}</strong>
+ *   }}
+ * />
+ */
+declare function RichText({ translations, components, vars }: RichTextProps): React.JSX.Element;
+/**
+ * Hook for rich text translations
+ * Returns a function that resolves translations with component interpolation
+ *
+ * @example
+ * const richT = useRichText({
+ *   link: (text) => <a href="/terms">{text}</a>,
+ *   bold: (text) => <strong>{text}</strong>,
+ * })
+ * return richT({ en: 'Click <link>here</link>', ko: '<link>여기</link> 클릭' })
+ */
+declare function useRichText(components: Record<string, ComponentRenderer>): (translations: Translations, vars?: TranslationVars) => ReactNode;
+
+export { LocaleProvider, RichText, T, useDetectedLocale, useLoadDictionaries, useLocale, useRichText, useT };

package/dist/index.js

@@ -22,32 +22,45 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   LocaleProvider: () => LocaleProvider,
+  RichText: () => RichText,
   T: () => T,
-  clearDictionaries: () => import_inline_i18n_multi4.clearDictionaries,
-  en_de: () => import_inline_i18n_multi4.en_de,
-  en_es: () => import_inline_i18n_multi4.en_es,
-  en_fr: () => import_inline_i18n_multi4.en_fr,
-  en_ja: () => import_inline_i18n_multi4.en_ja,
-  en_zh: () => import_inline_i18n_multi4.en_zh,
-  getDictionary: () => import_inline_i18n_multi4.getDictionary,
-  getLoadedLocales: () => import_inline_i18n_multi4.getLoadedLocales,
-  getLocale: () => import_inline_i18n_multi4.getLocale,
-  hasTranslation: () => import_inline_i18n_multi4.hasTranslation,
-  it: () => import_inline_i18n_multi4.it,
-  it_de: () => import_inline_i18n_multi4.it_de,
-  it_es: () => import_inline_i18n_multi4.it_es,
-  it_fr: () => import_inline_i18n_multi4.it_fr,
-  it_ja: () => import_inline_i18n_multi4.it_ja,
-  it_zh: () => import_inline_i18n_multi4.it_zh,
-  ja_es: () => import_inline_i18n_multi4.ja_es,
-  ja_zh: () => import_inline_i18n_multi4.ja_zh,
-  loadDictionaries: () => import_inline_i18n_multi4.loadDictionaries,
-  loadDictionary: () => import_inline_i18n_multi4.loadDictionary,
-  setLocale: () => import_inline_i18n_multi4.setLocale,
-  t: () => import_inline_i18n_multi4.t,
+  clearDictionaries: () => import_inline_i18n_multi5.clearDictionaries,
+  clearFormatters: () => import_inline_i18n_multi5.clearFormatters,
+  configure: () => import_inline_i18n_multi5.configure,
+  detectLocale: () => import_inline_i18n_multi5.detectLocale,
+  en_de: () => import_inline_i18n_multi5.en_de,
+  en_es: () => import_inline_i18n_multi5.en_es,
+  en_fr: () => import_inline_i18n_multi5.en_fr,
+  en_ja: () => import_inline_i18n_multi5.en_ja,
+  en_zh: () => import_inline_i18n_multi5.en_zh,
+  getConfig: () => import_inline_i18n_multi5.getConfig,
+  getDictionary: () => import_inline_i18n_multi5.getDictionary,
+  getLoadedLocales: () => import_inline_i18n_multi5.getLoadedLocales,
+  getLocale: () => import_inline_i18n_multi5.getLocale,
+  hasTranslation: () => import_inline_i18n_multi5.hasTranslation,
+  isLoaded: () => import_inline_i18n_multi5.isLoaded,
+  it: () => import_inline_i18n_multi5.it,
+  it_de: () => import_inline_i18n_multi5.it_de,
+  it_es: () => import_inline_i18n_multi5.it_es,
+  it_fr: () => import_inline_i18n_multi5.it_fr,
+  it_ja: () => import_inline_i18n_multi5.it_ja,
+  it_zh: () => import_inline_i18n_multi5.it_zh,
+  ja_es: () => import_inline_i18n_multi5.ja_es,
+  ja_zh: () => import_inline_i18n_multi5.ja_zh,
+  loadAsync: () => import_inline_i18n_multi5.loadAsync,
+  loadDictionaries: () => import_inline_i18n_multi5.loadDictionaries,
+  loadDictionary: () => import_inline_i18n_multi5.loadDictionary,
+  parseRichText: () => import_inline_i18n_multi5.parseRichText,
+  registerFormatter: () => import_inline_i18n_multi5.registerFormatter,
+  resetConfig: () => import_inline_i18n_multi5.resetConfig,
+  setLocale: () => import_inline_i18n_multi5.setLocale,
+  t: () => import_inline_i18n_multi5.t,
+  useDetectedLocale: () => useDetectedLocale,
+  useLoadDictionaries: () => useLoadDictionaries,
   useLocale: () => useLocale,
+  useRichText: () => useRichText,
   useT: () => useT,
-  zh_es: () => import_inline_i18n_multi4.zh_es
+  zh_es: () => import_inline_i18n_multi5.zh_es
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -83,7 +96,7 @@ function LocaleProvider({
   (0, import_react2.useEffect)(() => {
     (0, import_inline_i18n_multi.setLocale)(locale);
   }, [locale]);
-  const setLocale2 = (0, import_react2.useCallback)(
+  const setLocale3 = (0, import_react2.useCallback)(
     (newLocale) => {
       setLocaleState(newLocale);
       (0, import_inline_i18n_multi.setLocale)(newLocale);
@@ -94,7 +107,7 @@ function LocaleProvider({
     },
     [cookieName, onLocaleChange]
   );
-  const value = (0, import_react2.useMemo)(() => ({ locale, setLocale: setLocale2 }), [locale, setLocale2]);
+  const value = (0, import_react2.useMemo)(() => ({ locale, setLocale: setLocale3 }), [locale, setLocale3]);
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(LocaleContext.Provider, { value, children });
 }
 
@@ -102,8 +115,8 @@ function LocaleProvider({
 var import_react3 = require("react");
 var import_inline_i18n_multi2 = require("inline-i18n-multi");
 function useLocale() {
-  const { locale, setLocale: setLocale2 } = useLocaleContext();
-  return [locale, setLocale2];
+  const { locale, setLocale: setLocale3 } = useLocaleContext();
+  return [locale, setLocale3];
 }
 function useT() {
   const { locale } = useLocaleContext();
@@ -112,6 +125,32 @@ function useT() {
     [locale]
   );
 }
+function useLoadDictionaries(locale, namespace) {
+  const [isLoading, setIsLoading] = (0, import_react3.useState)(() => !(0, import_inline_i18n_multi2.isLoaded)(locale, namespace));
+  const [error, setError] = (0, import_react3.useState)(null);
+  (0, import_react3.useEffect)(() => {
+    if ((0, import_inline_i18n_multi2.isLoaded)(locale, namespace)) {
+      setIsLoading(false);
+      setError(null);
+      return;
+    }
+    setIsLoading(true);
+    setError(null);
+    (0, import_inline_i18n_multi2.loadAsync)(locale, namespace).then(() => setIsLoading(false)).catch((err) => {
+      setError(err instanceof Error ? err : new Error(String(err)));
+      setIsLoading(false);
+    });
+  }, [locale, namespace]);
+  return { isLoading, error };
+}
+function useDetectedLocale(options) {
+  const { setLocale: setContextLocale } = useLocaleContext();
+  (0, import_react3.useEffect)(() => {
+    const detected = (0, import_inline_i18n_multi2.detectLocale)(options);
+    (0, import_inline_i18n_multi2.setLocale)(detected);
+    setContextLocale(detected);
+  }, []);
+}
 
 // src/component.tsx
 var import_inline_i18n_multi3 = require("inline-i18n-multi");
@@ -127,22 +166,68 @@ function T(props) {
   throw new Error('T component requires either "translations" or both "ko" and "en" props');
 }
 
-// src/index.ts
+// src/richtext.tsx
+var import_react4 = require("react");
 var import_inline_i18n_multi4 = require("inline-i18n-multi");
+var import_jsx_runtime3 = require("react/jsx-runtime");
+function RichText({ translations, components, vars }) {
+  const componentNames = (0, import_react4.useMemo)(() => Object.keys(components), [components]);
+  const resolved = (0, import_inline_i18n_multi4.it)(translations, vars);
+  const segments = (0, import_inline_i18n_multi4.parseRichText)(resolved, componentNames);
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_jsx_runtime3.Fragment, { children: segments.map((segment, index) => {
+    if (segment.type === "text") {
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react4.Fragment, { children: segment.content }, index);
+    }
+    const renderer = components[segment.componentName];
+    if (!renderer) {
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react4.Fragment, { children: segment.content }, index);
+    }
+    return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react4.Fragment, { children: renderer(segment.content) }, index);
+  }) });
+}
+function useRichText(components) {
+  const componentNames = (0, import_react4.useMemo)(() => Object.keys(components), [components]);
+  return (0, import_react4.useCallback)(
+    (translations, vars) => {
+      const resolved = (0, import_inline_i18n_multi4.it)(translations, vars);
+      const segments = (0, import_inline_i18n_multi4.parseRichText)(resolved, componentNames);
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_jsx_runtime3.Fragment, { children: segments.map((segment, index) => {
+        if (segment.type === "text") {
+          return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react4.Fragment, { children: segment.content }, index);
+        }
+        const renderer = components[segment.componentName];
+        if (!renderer) {
+          return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react4.Fragment, { children: segment.content }, index);
+        }
+        return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react4.Fragment, { children: renderer(segment.content) }, index);
+      }) });
+    },
+    [components, componentNames]
+  );
+}
+
+// src/index.ts
+var import_inline_i18n_multi5 = require("inline-i18n-multi");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   LocaleProvider,
+  RichText,
   T,
   clearDictionaries,
+  clearFormatters,
+  configure,
+  detectLocale,
   en_de,
   en_es,
   en_fr,
   en_ja,
   en_zh,
+  getConfig,
   getDictionary,
   getLoadedLocales,
   getLocale,
   hasTranslation,
+  isLoaded,
   it,
   it_de,
   it_es,
@@ -151,11 +236,18 @@ var import_inline_i18n_multi4 = require("inline-i18n-multi");
   it_zh,
   ja_es,
   ja_zh,
+  loadAsync,
   loadDictionaries,
   loadDictionary,
+  parseRichText,
+  registerFormatter,
+  resetConfig,
   setLocale,
   t,
+  useDetectedLocale,
+  useLoadDictionaries,
   useLocale,
+  useRichText,
   useT,
   zh_es
 });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/provider.tsx","../src/context.tsx","../src/hooks.ts","../src/component.tsx"],"sourcesContent":["export { LocaleProvider } from './provider'\nexport { useLocale, useT } from './hooks'\nexport { T } from './component'\n\n// re-export from core for convenience\nexport {\n  // inline translations\n  it,\n  it_ja,\n  it_zh,\n  it_es,\n  it_fr,\n  it_de,\n  en_ja,\n  en_zh,\n  en_es,\n  en_fr,\n  en_de,\n  ja_zh,\n  ja_es,\n  zh_es,\n  getLocale,\n  setLocale,\n  // key-based translations (i18n compatible)\n  t,\n  loadDictionaries,\n  loadDictionary,\n  clearDictionaries,\n  hasTranslation,\n  getLoadedLocales,\n  getDictionary,\n  // types\n  type Locale,\n  type Translations,\n  type TranslationVars,\n  type Dictionary,\n  type Dictionaries,\n  type PluralRules,\n} from 'inline-i18n-multi'\n","import { useState, useCallback, useMemo, useEffect, type ReactNode } from 'react'\nimport { setLocale as setCoreLocale, type Locale } from 'inline-i18n-multi'\nimport { LocaleContext } from './context'\n\ninterface LocaleProviderProps {\n  /**\n   * Initial locale value\n   */\n  locale: Locale\n  /**\n   * Cookie name for persisting locale (default: NEXT_LOCALE)\n   * Set to false to disable cookie sync\n   */\n  cookieName?: string | false\n  /**\n   * Callback when locale changes\n   */\n  onLocaleChange?: (locale: Locale) => void\n  children: ReactNode\n}\n\nfunction setCookie(name: string, value: string, days = 365): void {\n  if (typeof document === 'undefined') return\n  const expires = new Date(Date.now() + days * 864e5).toUTCString()\n  document.cookie = `${name}=${value}; expires=${expires}; path=/; SameSite=Lax`\n}\n\nexport function LocaleProvider({\n  locale: initialLocale,\n  cookieName = 'NEXT_LOCALE',\n  onLocaleChange,\n  children,\n}: LocaleProviderProps) {\n  const [locale, setLocaleState] = useState<Locale>(initialLocale)\n\n  // sync with core package on mount and locale change\n  useEffect(() => {\n    setCoreLocale(locale)\n  }, [locale])\n\n  const setLocale = useCallback(\n    (newLocale: Locale) => {\n      setLocaleState(newLocale)\n      setCoreLocale(newLocale)\n\n      // sync cookie for Next.js middleware\n      if (cookieName) {\n        setCookie(cookieName, newLocale)\n      }\n\n      // callback for custom handling\n      onLocaleChange?.(newLocale)\n    },\n    [cookieName, onLocaleChange]\n  )\n\n  const value = useMemo(() => ({ locale, setLocale }), [locale, setLocale])\n\n  return <LocaleContext.Provider value={value}>{children}</LocaleContext.Provider>\n}\n","import { createContext, useContext } from 'react'\nimport type { Locale } from 'inline-i18n-multi'\n\ninterface LocaleContextValue {\n  locale: Locale\n  setLocale: (locale: Locale) => void\n}\n\nexport const LocaleContext = createContext<LocaleContextValue | null>(null)\n\nexport function useLocaleContext(): LocaleContextValue {\n  const context = useContext(LocaleContext)\n\n  if (!context) {\n    throw new Error('useLocaleContext must be used within a LocaleProvider')\n  }\n\n  return context\n}\n","import { useCallback } from 'react'\nimport { useLocaleContext } from './context'\nimport { t as coreT } from 'inline-i18n-multi'\nimport type { Locale, TranslationVars } from 'inline-i18n-multi'\n\n/**\n * Get current locale and setter\n */\nexport function useLocale(): [Locale, (locale: Locale) => void] {\n  const { locale, setLocale } = useLocaleContext()\n  return [locale, setLocale]\n}\n\n/**\n * Get translation function bound to current locale\n * @example\n * const t = useT()\n * t('greeting.hello') // uses context locale\n * t('items.count', { count: 5 })\n */\nexport function useT(): (key: string, vars?: TranslationVars) => string {\n  const { locale } = useLocaleContext()\n\n  return useCallback(\n    (key: string, vars?: TranslationVars) => coreT(key, vars, locale),\n    [locale]\n  )\n}\n","import { it, type Translations, type TranslationVars } from 'inline-i18n-multi'\n\ninterface TPropsShorthand {\n  /**\n   * Korean text\n   */\n  ko: string\n  /**\n   * English text\n   */\n  en: string\n  translations?: never\n}\n\ninterface TPropsObject {\n  ko?: never\n  en?: never\n  /**\n   * Translation map with locale keys\n   */\n  translations: Translations\n}\n\ntype TProps = (TPropsShorthand | TPropsObject) & TranslationVars\n\n/**\n * Translation component for JSX\n * @example <T ko=\"안녕\" en=\"Hello\" />\n * @example <T translations={{ ko: '안녕', en: 'Hello', ja: 'こんにちは' }} />\n * @example <T ko=\"안녕 {name}\" en=\"Hello {name}\" name=\"철수\" />\n */\nexport function T(props: TProps) {\n  const { ko, en, translations, ...vars } = props\n\n  if (translations) {\n    return <>{it(translations, vars)}</>\n  }\n\n  if (ko !== undefined && en !== undefined) {\n    return <>{it(ko, en, vars)}</>\n  }\n\n  throw new Error('T component requires either \"translations\" or both \"ko\" and \"en\" props')\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,IAAAA,gBAA0E;AAC1E,+BAAwD;;;ACDxD,mBAA0C;AAQnC,IAAM,oBAAgB,4BAAyC,IAAI;AAEnE,SAAS,mBAAuC;AACrD,QAAM,cAAU,yBAAW,aAAa;AAExC,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,uDAAuD;AAAA,EACzE;AAEA,SAAO;AACT;;;ADwCS;AArCT,SAAS,UAAU,MAAc,OAAe,OAAO,KAAW;AAChE,MAAI,OAAO,aAAa,YAAa;AACrC,QAAM,UAAU,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,EAAE,YAAY;AAChE,WAAS,SAAS,GAAG,IAAI,IAAI,KAAK,aAAa,OAAO;AACxD;AAEO,SAAS,eAAe;AAAA,EAC7B,QAAQ;AAAA,EACR,aAAa;AAAA,EACb;AAAA,EACA;AACF,GAAwB;AACtB,QAAM,CAAC,QAAQ,cAAc,QAAI,wBAAiB,aAAa;AAG/D,+BAAU,MAAM;AACd,iCAAAC,WAAc,MAAM;AAAA,EACtB,GAAG,CAAC,MAAM,CAAC;AAEX,QAAMC,iBAAY;AAAA,IAChB,CAAC,cAAsB;AACrB,qBAAe,SAAS;AACxB,mCAAAD,WAAc,SAAS;AAGvB,UAAI,YAAY;AACd,kBAAU,YAAY,SAAS;AAAA,MACjC;AAGA,uBAAiB,SAAS;AAAA,IAC5B;AAAA,IACA,CAAC,YAAY,cAAc;AAAA,EAC7B;AAEA,QAAM,YAAQ,uBAAQ,OAAO,EAAE,QAAQ,WAAAC,WAAU,IAAI,CAAC,QAAQA,UAAS,CAAC;AAExE,SAAO,4CAAC,cAAc,UAAd,EAAuB,OAAe,UAAS;AACzD;;;AE3DA,IAAAC,gBAA4B;AAE5B,IAAAC,4BAA2B;AAMpB,SAAS,YAAgD;AAC9D,QAAM,EAAE,QAAQ,WAAAC,WAAU,IAAI,iBAAiB;AAC/C,SAAO,CAAC,QAAQA,UAAS;AAC3B;AASO,SAAS,OAAwD;AACtE,QAAM,EAAE,OAAO,IAAI,iBAAiB;AAEpC,aAAO;AAAA,IACL,CAAC,KAAa,aAA2B,0BAAAC,GAAM,KAAK,MAAM,MAAM;AAAA,IAChE,CAAC,MAAM;AAAA,EACT;AACF;;;AC3BA,IAAAC,4BAA4D;AAmCjD,IAAAC,sBAAA;AAJJ,SAAS,EAAE,OAAe;AAC/B,QAAM,EAAE,IAAI,IAAI,cAAc,GAAG,KAAK,IAAI;AAE1C,MAAI,cAAc;AAChB,WAAO,6EAAG,4CAAG,cAAc,IAAI,GAAE;AAAA,EACnC;AAEA,MAAI,OAAO,UAAa,OAAO,QAAW;AACxC,WAAO,6EAAG,4CAAG,IAAI,IAAI,IAAI,GAAE;AAAA,EAC7B;AAEA,QAAM,IAAI,MAAM,wEAAwE;AAC1F;;;AJtCA,IAAAC,4BAiCO;","names":["import_react","setCoreLocale","setLocale","import_react","import_inline_i18n_multi","setLocale","coreT","import_inline_i18n_multi","import_jsx_runtime","import_inline_i18n_multi"]}
+{"version":3,"sources":["../src/index.ts","../src/provider.tsx","../src/context.tsx","../src/hooks.ts","../src/component.tsx","../src/richtext.tsx"],"sourcesContent":["export { LocaleProvider } from './provider'\nexport { useLocale, useT, useLoadDictionaries, useDetectedLocale } from './hooks'\nexport { T } from './component'\nexport { RichText, useRichText } from './richtext'\n\n// re-export from core for convenience\nexport {\n  // inline translations\n  it,\n  it_ja,\n  it_zh,\n  it_es,\n  it_fr,\n  it_de,\n  en_ja,\n  en_zh,\n  en_es,\n  en_fr,\n  en_de,\n  ja_zh,\n  ja_es,\n  zh_es,\n  getLocale,\n  setLocale,\n  // key-based translations (i18n compatible)\n  t,\n  loadDictionaries,\n  loadDictionary,\n  clearDictionaries,\n  hasTranslation,\n  getLoadedLocales,\n  getDictionary,\n  loadAsync,\n  isLoaded,\n  // configuration\n  configure,\n  getConfig,\n  resetConfig,\n  // rich text parsing\n  parseRichText,\n  type RichTextSegment,\n  // custom formatters (v0.6.0)\n  registerFormatter,\n  clearFormatters,\n  type CustomFormatter,\n  // locale detection (v0.6.0)\n  detectLocale,\n  type DetectLocaleOptions,\n  type DetectSource,\n  // types\n  type Locale,\n  type Translations,\n  type TranslationVars,\n  type Dictionary,\n  type Dictionaries,\n  type PluralRules,\n} from 'inline-i18n-multi'\n","import { useState, useCallback, useMemo, useEffect, type ReactNode } from 'react'\nimport { setLocale as setCoreLocale, type Locale } from 'inline-i18n-multi'\nimport { LocaleContext } from './context'\n\ninterface LocaleProviderProps {\n  /**\n   * Initial locale value\n   */\n  locale: Locale\n  /**\n   * Cookie name for persisting locale (default: NEXT_LOCALE)\n   * Set to false to disable cookie sync\n   */\n  cookieName?: string | false\n  /**\n   * Callback when locale changes\n   */\n  onLocaleChange?: (locale: Locale) => void\n  children: ReactNode\n}\n\nfunction setCookie(name: string, value: string, days = 365): void {\n  if (typeof document === 'undefined') return\n  const expires = new Date(Date.now() + days * 864e5).toUTCString()\n  document.cookie = `${name}=${value}; expires=${expires}; path=/; SameSite=Lax`\n}\n\nexport function LocaleProvider({\n  locale: initialLocale,\n  cookieName = 'NEXT_LOCALE',\n  onLocaleChange,\n  children,\n}: LocaleProviderProps) {\n  const [locale, setLocaleState] = useState<Locale>(initialLocale)\n\n  // sync with core package on mount and locale change\n  useEffect(() => {\n    setCoreLocale(locale)\n  }, [locale])\n\n  const setLocale = useCallback(\n    (newLocale: Locale) => {\n      setLocaleState(newLocale)\n      setCoreLocale(newLocale)\n\n      // sync cookie for Next.js middleware\n      if (cookieName) {\n        setCookie(cookieName, newLocale)\n      }\n\n      // callback for custom handling\n      onLocaleChange?.(newLocale)\n    },\n    [cookieName, onLocaleChange]\n  )\n\n  const value = useMemo(() => ({ locale, setLocale }), [locale, setLocale])\n\n  return <LocaleContext.Provider value={value}>{children}</LocaleContext.Provider>\n}\n","import { createContext, useContext } from 'react'\nimport type { Locale } from 'inline-i18n-multi'\n\ninterface LocaleContextValue {\n  locale: Locale\n  setLocale: (locale: Locale) => void\n}\n\nexport const LocaleContext = createContext<LocaleContextValue | null>(null)\n\nexport function useLocaleContext(): LocaleContextValue {\n  const context = useContext(LocaleContext)\n\n  if (!context) {\n    throw new Error('useLocaleContext must be used within a LocaleProvider')\n  }\n\n  return context\n}\n","import { useCallback, useState, useEffect } from 'react'\nimport { useLocaleContext } from './context'\nimport { t as coreT, loadAsync, isLoaded, detectLocale, setLocale } from 'inline-i18n-multi'\nimport type { Locale, TranslationVars, DetectLocaleOptions } from 'inline-i18n-multi'\n\n/**\n * Get current locale and setter\n */\nexport function useLocale(): [Locale, (locale: Locale) => void] {\n  const { locale, setLocale } = useLocaleContext()\n  return [locale, setLocale]\n}\n\n/**\n * Get translation function bound to current locale\n * @example\n * const t = useT()\n * t('greeting.hello') // uses context locale\n * t('items.count', { count: 5 })\n */\nexport function useT(): (key: string, vars?: TranslationVars) => string {\n  const { locale } = useLocaleContext()\n\n  return useCallback(\n    (key: string, vars?: TranslationVars) => coreT(key, vars, locale),\n    [locale]\n  )\n}\n\n/**\n * Hook for lazy loading dictionaries\n * Automatically loads dictionaries when locale or namespace changes\n *\n * @example\n * function Dashboard() {\n *   const { isLoading, error } = useLoadDictionaries('ko', 'dashboard')\n *   if (isLoading) return <Spinner />\n *   if (error) return <Error message={error.message} />\n *   return <Content />\n * }\n */\nexport function useLoadDictionaries(\n  locale: Locale,\n  namespace?: string\n): { isLoading: boolean; error: Error | null } {\n  const [isLoading, setIsLoading] = useState(() => !isLoaded(locale, namespace))\n  const [error, setError] = useState<Error | null>(null)\n\n  useEffect(() => {\n    if (isLoaded(locale, namespace)) {\n      setIsLoading(false)\n      setError(null)\n      return\n    }\n\n    setIsLoading(true)\n    setError(null)\n\n    loadAsync(locale, namespace)\n      .then(() => setIsLoading(false))\n      .catch((err) => {\n        setError(err instanceof Error ? err : new Error(String(err)))\n        setIsLoading(false)\n      })\n  }, [locale, namespace])\n\n  return { isLoading, error }\n}\n\n/**\n * Hook that auto-detects and sets locale on mount\n *\n * @example\n * function App() {\n *   useDetectedLocale({\n *     supportedLocales: ['en', 'ko', 'ja'],\n *     defaultLocale: 'en',\n *     sources: ['cookie', 'navigator'],\n *   })\n *   return <Content />\n * }\n */\nexport function useDetectedLocale(options: DetectLocaleOptions): void {\n  const { setLocale: setContextLocale } = useLocaleContext()\n\n  useEffect(() => {\n    const detected = detectLocale(options)\n    setLocale(detected)\n    setContextLocale(detected)\n    // Run once on mount\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [])\n}\n","import { it, type Translations, type TranslationVars } from 'inline-i18n-multi'\n\ninterface TPropsShorthand {\n  /**\n   * Korean text\n   */\n  ko: string\n  /**\n   * English text\n   */\n  en: string\n  translations?: never\n}\n\ninterface TPropsObject {\n  ko?: never\n  en?: never\n  /**\n   * Translation map with locale keys\n   */\n  translations: Translations\n}\n\ntype TProps = (TPropsShorthand | TPropsObject) & TranslationVars\n\n/**\n * Translation component for JSX\n * @example <T ko=\"안녕\" en=\"Hello\" />\n * @example <T translations={{ ko: '안녕', en: 'Hello', ja: 'こんにちは' }} />\n * @example <T ko=\"안녕 {name}\" en=\"Hello {name}\" name=\"철수\" />\n */\nexport function T(props: TProps) {\n  const { ko, en, translations, ...vars } = props\n\n  if (translations) {\n    return <>{it(translations, vars)}</>\n  }\n\n  if (ko !== undefined && en !== undefined) {\n    return <>{it(ko, en, vars)}</>\n  }\n\n  throw new Error('T component requires either \"translations\" or both \"ko\" and \"en\" props')\n}\n","import React, { type ReactNode, useMemo, useCallback, Fragment } from 'react'\nimport { it, parseRichText, type Translations, type TranslationVars } from 'inline-i18n-multi'\n\ntype ComponentRenderer = (text: string) => ReactNode\n\ninterface RichTextProps {\n  /**\n   * Translation map with locale keys\n   * Tags like <link>text</link> will be matched to component renderers\n   */\n  translations: Translations\n  /**\n   * Component renderers for each tag name\n   * @example { link: (text) => <a href=\"/terms\">{text}</a> }\n   */\n  components: Record<string, ComponentRenderer>\n  /**\n   * Variables for interpolation (applied before rich text parsing)\n   */\n  vars?: TranslationVars\n}\n\n/**\n * Rich text translation component\n * Supports embedding React components within translations\n *\n * @example\n * <RichText\n *   translations={{\n *     en: 'Read <link>terms</link> and <bold>agree</bold>',\n *     ko: '<link>약관</link>을 읽고 <bold>동의</bold>해주세요'\n *   }}\n *   components={{\n *     link: (text) => <a href=\"/terms\">{text}</a>,\n *     bold: (text) => <strong>{text}</strong>\n *   }}\n * />\n */\nexport function RichText({ translations, components, vars }: RichTextProps): React.JSX.Element {\n  const componentNames = useMemo(() => Object.keys(components), [components])\n\n  // Resolve locale and interpolate variables ({curly} braces)\n  // Rich text tags (<angle> brackets) don't conflict with variable interpolation\n  const resolved = it(translations, vars)\n  const segments = parseRichText(resolved, componentNames)\n\n  return (\n    <>\n      {segments.map((segment, index) => {\n        if (segment.type === 'text') {\n          return <Fragment key={index}>{segment.content}</Fragment>\n        }\n        const renderer = components[segment.componentName!]\n        if (!renderer) {\n          return <Fragment key={index}>{segment.content}</Fragment>\n        }\n        return <Fragment key={index}>{renderer(segment.content)}</Fragment>\n      })}\n    </>\n  )\n}\n\n/**\n * Hook for rich text translations\n * Returns a function that resolves translations with component interpolation\n *\n * @example\n * const richT = useRichText({\n *   link: (text) => <a href=\"/terms\">{text}</a>,\n *   bold: (text) => <strong>{text}</strong>,\n * })\n * return richT({ en: 'Click <link>here</link>', ko: '<link>여기</link> 클릭' })\n */\nexport function useRichText(\n  components: Record<string, ComponentRenderer>\n): (translations: Translations, vars?: TranslationVars) => ReactNode {\n  const componentNames = useMemo(() => Object.keys(components), [components])\n\n  return useCallback(\n    (translations: Translations, vars?: TranslationVars): ReactNode => {\n      const resolved = it(translations, vars)\n      const segments = parseRichText(resolved, componentNames)\n\n      return (\n        <>\n          {segments.map((segment, index) => {\n            if (segment.type === 'text') {\n              return <Fragment key={index}>{segment.content}</Fragment>\n            }\n            const renderer = components[segment.componentName!]\n            if (!renderer) {\n              return <Fragment key={index}>{segment.content}</Fragment>\n            }\n            return <Fragment key={index}>{renderer(segment.content)}</Fragment>\n          })}\n        </>\n      )\n    },\n    [components, componentNames]\n  )\n}\n"],"mappings":"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","names":["import_react","setCoreLocale","setLocale","import_react","import_inline_i18n_multi","setLocale","coreT","import_inline_i18n_multi","import_jsx_runtime","import_react","import_inline_i18n_multi","import_jsx_runtime","import_inline_i18n_multi"]}

package/dist/index.mjs

@@ -32,7 +32,7 @@ function LocaleProvider({
   useEffect(() => {
     setCoreLocale(locale);
   }, [locale]);
-  const setLocale2 = useCallback(
+  const setLocale3 = useCallback(
     (newLocale) => {
       setLocaleState(newLocale);
       setCoreLocale(newLocale);
@@ -43,16 +43,16 @@ function LocaleProvider({
     },
     [cookieName, onLocaleChange]
   );
-  const value = useMemo(() => ({ locale, setLocale: setLocale2 }), [locale, setLocale2]);
+  const value = useMemo(() => ({ locale, setLocale: setLocale3 }), [locale, setLocale3]);
   return /* @__PURE__ */ jsx(LocaleContext.Provider, { value, children });
 }
 
 // src/hooks.ts
-import { useCallback as useCallback2 } from "react";
-import { t as coreT } from "inline-i18n-multi";
+import { useCallback as useCallback2, useState as useState2, useEffect as useEffect2 } from "react";
+import { t as coreT, loadAsync, isLoaded, detectLocale, setLocale } from "inline-i18n-multi";
 function useLocale() {
-  const { locale, setLocale: setLocale2 } = useLocaleContext();
-  return [locale, setLocale2];
+  const { locale, setLocale: setLocale3 } = useLocaleContext();
+  return [locale, setLocale3];
 }
 function useT() {
   const { locale } = useLocaleContext();
@@ -61,6 +61,32 @@ function useT() {
     [locale]
   );
 }
+function useLoadDictionaries(locale, namespace) {
+  const [isLoading, setIsLoading] = useState2(() => !isLoaded(locale, namespace));
+  const [error, setError] = useState2(null);
+  useEffect2(() => {
+    if (isLoaded(locale, namespace)) {
+      setIsLoading(false);
+      setError(null);
+      return;
+    }
+    setIsLoading(true);
+    setError(null);
+    loadAsync(locale, namespace).then(() => setIsLoading(false)).catch((err) => {
+      setError(err instanceof Error ? err : new Error(String(err)));
+      setIsLoading(false);
+    });
+  }, [locale, namespace]);
+  return { isLoading, error };
+}
+function useDetectedLocale(options) {
+  const { setLocale: setContextLocale } = useLocaleContext();
+  useEffect2(() => {
+    const detected = detectLocale(options);
+    setLocale(detected);
+    setContextLocale(detected);
+  }, []);
+}
 
 // src/component.tsx
 import { it } from "inline-i18n-multi";
@@ -76,9 +102,49 @@ function T(props) {
   throw new Error('T component requires either "translations" or both "ko" and "en" props');
 }
 
+// src/richtext.tsx
+import { useMemo as useMemo2, useCallback as useCallback3, Fragment as Fragment2 } from "react";
+import { it as it2, parseRichText } from "inline-i18n-multi";
+import { Fragment as Fragment3, jsx as jsx3 } from "react/jsx-runtime";
+function RichText({ translations, components, vars }) {
+  const componentNames = useMemo2(() => Object.keys(components), [components]);
+  const resolved = it2(translations, vars);
+  const segments = parseRichText(resolved, componentNames);
+  return /* @__PURE__ */ jsx3(Fragment3, { children: segments.map((segment, index) => {
+    if (segment.type === "text") {
+      return /* @__PURE__ */ jsx3(Fragment2, { children: segment.content }, index);
+    }
+    const renderer = components[segment.componentName];
+    if (!renderer) {
+      return /* @__PURE__ */ jsx3(Fragment2, { children: segment.content }, index);
+    }
+    return /* @__PURE__ */ jsx3(Fragment2, { children: renderer(segment.content) }, index);
+  }) });
+}
+function useRichText(components) {
+  const componentNames = useMemo2(() => Object.keys(components), [components]);
+  return useCallback3(
+    (translations, vars) => {
+      const resolved = it2(translations, vars);
+      const segments = parseRichText(resolved, componentNames);
+      return /* @__PURE__ */ jsx3(Fragment3, { children: segments.map((segment, index) => {
+        if (segment.type === "text") {
+          return /* @__PURE__ */ jsx3(Fragment2, { children: segment.content }, index);
+        }
+        const renderer = components[segment.componentName];
+        if (!renderer) {
+          return /* @__PURE__ */ jsx3(Fragment2, { children: segment.content }, index);
+        }
+        return /* @__PURE__ */ jsx3(Fragment2, { children: renderer(segment.content) }, index);
+      }) });
+    },
+    [components, componentNames]
+  );
+}
+
 // src/index.ts
 import {
-  it as it2,
+  it as it3,
   it_ja,
   it_zh,
   it_es,
@@ -93,29 +159,44 @@ import {
   ja_es,
   zh_es,
   getLocale,
-  setLocale,
+  setLocale as setLocale2,
   t,
   loadDictionaries,
   loadDictionary,
   clearDictionaries,
   hasTranslation,
   getLoadedLocales,
-  getDictionary
+  getDictionary,
+  loadAsync as loadAsync2,
+  isLoaded as isLoaded2,
+  configure,
+  getConfig,
+  resetConfig,
+  parseRichText as parseRichText2,
+  registerFormatter,
+  clearFormatters,
+  detectLocale as detectLocale2
 } from "inline-i18n-multi";
 export {
   LocaleProvider,
+  RichText,
   T,
   clearDictionaries,
+  clearFormatters,
+  configure,
+  detectLocale2 as detectLocale,
   en_de,
   en_es,
   en_fr,
   en_ja,
   en_zh,
+  getConfig,
   getDictionary,
   getLoadedLocales,
   getLocale,
   hasTranslation,
-  it2 as it,
+  isLoaded2 as isLoaded,
+  it3 as it,
   it_de,
   it_es,
   it_fr,
@@ -123,11 +204,18 @@ export {
   it_zh,
   ja_es,
   ja_zh,
+  loadAsync2 as loadAsync,
   loadDictionaries,
   loadDictionary,
-  setLocale,
+  parseRichText2 as parseRichText,
+  registerFormatter,
+  resetConfig,
+  setLocale2 as setLocale,
   t,
+  useDetectedLocale,
+  useLoadDictionaries,
   useLocale,
+  useRichText,
   useT,
   zh_es
 };

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/provider.tsx","../src/context.tsx","../src/hooks.ts","../src/component.tsx","../src/index.ts"],"sourcesContent":["import { useState, useCallback, useMemo, useEffect, type ReactNode } from 'react'\nimport { setLocale as setCoreLocale, type Locale } from 'inline-i18n-multi'\nimport { LocaleContext } from './context'\n\ninterface LocaleProviderProps {\n  /**\n   * Initial locale value\n   */\n  locale: Locale\n  /**\n   * Cookie name for persisting locale (default: NEXT_LOCALE)\n   * Set to false to disable cookie sync\n   */\n  cookieName?: string | false\n  /**\n   * Callback when locale changes\n   */\n  onLocaleChange?: (locale: Locale) => void\n  children: ReactNode\n}\n\nfunction setCookie(name: string, value: string, days = 365): void {\n  if (typeof document === 'undefined') return\n  const expires = new Date(Date.now() + days * 864e5).toUTCString()\n  document.cookie = `${name}=${value}; expires=${expires}; path=/; SameSite=Lax`\n}\n\nexport function LocaleProvider({\n  locale: initialLocale,\n  cookieName = 'NEXT_LOCALE',\n  onLocaleChange,\n  children,\n}: LocaleProviderProps) {\n  const [locale, setLocaleState] = useState<Locale>(initialLocale)\n\n  // sync with core package on mount and locale change\n  useEffect(() => {\n    setCoreLocale(locale)\n  }, [locale])\n\n  const setLocale = useCallback(\n    (newLocale: Locale) => {\n      setLocaleState(newLocale)\n      setCoreLocale(newLocale)\n\n      // sync cookie for Next.js middleware\n      if (cookieName) {\n        setCookie(cookieName, newLocale)\n      }\n\n      // callback for custom handling\n      onLocaleChange?.(newLocale)\n    },\n    [cookieName, onLocaleChange]\n  )\n\n  const value = useMemo(() => ({ locale, setLocale }), [locale, setLocale])\n\n  return <LocaleContext.Provider value={value}>{children}</LocaleContext.Provider>\n}\n","import { createContext, useContext } from 'react'\nimport type { Locale } from 'inline-i18n-multi'\n\ninterface LocaleContextValue {\n  locale: Locale\n  setLocale: (locale: Locale) => void\n}\n\nexport const LocaleContext = createContext<LocaleContextValue | null>(null)\n\nexport function useLocaleContext(): LocaleContextValue {\n  const context = useContext(LocaleContext)\n\n  if (!context) {\n    throw new Error('useLocaleContext must be used within a LocaleProvider')\n  }\n\n  return context\n}\n","import { useCallback } from 'react'\nimport { useLocaleContext } from './context'\nimport { t as coreT } from 'inline-i18n-multi'\nimport type { Locale, TranslationVars } from 'inline-i18n-multi'\n\n/**\n * Get current locale and setter\n */\nexport function useLocale(): [Locale, (locale: Locale) => void] {\n  const { locale, setLocale } = useLocaleContext()\n  return [locale, setLocale]\n}\n\n/**\n * Get translation function bound to current locale\n * @example\n * const t = useT()\n * t('greeting.hello') // uses context locale\n * t('items.count', { count: 5 })\n */\nexport function useT(): (key: string, vars?: TranslationVars) => string {\n  const { locale } = useLocaleContext()\n\n  return useCallback(\n    (key: string, vars?: TranslationVars) => coreT(key, vars, locale),\n    [locale]\n  )\n}\n","import { it, type Translations, type TranslationVars } from 'inline-i18n-multi'\n\ninterface TPropsShorthand {\n  /**\n   * Korean text\n   */\n  ko: string\n  /**\n   * English text\n   */\n  en: string\n  translations?: never\n}\n\ninterface TPropsObject {\n  ko?: never\n  en?: never\n  /**\n   * Translation map with locale keys\n   */\n  translations: Translations\n}\n\ntype TProps = (TPropsShorthand | TPropsObject) & TranslationVars\n\n/**\n * Translation component for JSX\n * @example <T ko=\"안녕\" en=\"Hello\" />\n * @example <T translations={{ ko: '안녕', en: 'Hello', ja: 'こんにちは' }} />\n * @example <T ko=\"안녕 {name}\" en=\"Hello {name}\" name=\"철수\" />\n */\nexport function T(props: TProps) {\n  const { ko, en, translations, ...vars } = props\n\n  if (translations) {\n    return <>{it(translations, vars)}</>\n  }\n\n  if (ko !== undefined && en !== undefined) {\n    return <>{it(ko, en, vars)}</>\n  }\n\n  throw new Error('T component requires either \"translations\" or both \"ko\" and \"en\" props')\n}\n","export { LocaleProvider } from './provider'\nexport { useLocale, useT } from './hooks'\nexport { T } from './component'\n\n// re-export from core for convenience\nexport {\n  // inline translations\n  it,\n  it_ja,\n  it_zh,\n  it_es,\n  it_fr,\n  it_de,\n  en_ja,\n  en_zh,\n  en_es,\n  en_fr,\n  en_de,\n  ja_zh,\n  ja_es,\n  zh_es,\n  getLocale,\n  setLocale,\n  // key-based translations (i18n compatible)\n  t,\n  loadDictionaries,\n  loadDictionary,\n  clearDictionaries,\n  hasTranslation,\n  getLoadedLocales,\n  getDictionary,\n  // types\n  type Locale,\n  type Translations,\n  type TranslationVars,\n  type Dictionary,\n  type Dictionaries,\n  type PluralRules,\n} from 'inline-i18n-multi'\n"],"mappings":";;;AAAA,SAAS,UAAU,aAAa,SAAS,iBAAiC;AAC1E,SAAS,aAAa,qBAAkC;;;ACDxD,SAAS,eAAe,kBAAkB;AAQnC,IAAM,gBAAgB,cAAyC,IAAI;AAEnE,SAAS,mBAAuC;AACrD,QAAM,UAAU,WAAW,aAAa;AAExC,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,uDAAuD;AAAA,EACzE;AAEA,SAAO;AACT;;;ADwCS;AArCT,SAAS,UAAU,MAAc,OAAe,OAAO,KAAW;AAChE,MAAI,OAAO,aAAa,YAAa;AACrC,QAAM,UAAU,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,EAAE,YAAY;AAChE,WAAS,SAAS,GAAG,IAAI,IAAI,KAAK,aAAa,OAAO;AACxD;AAEO,SAAS,eAAe;AAAA,EAC7B,QAAQ;AAAA,EACR,aAAa;AAAA,EACb;AAAA,EACA;AACF,GAAwB;AACtB,QAAM,CAAC,QAAQ,cAAc,IAAI,SAAiB,aAAa;AAG/D,YAAU,MAAM;AACd,kBAAc,MAAM;AAAA,EACtB,GAAG,CAAC,MAAM,CAAC;AAEX,QAAMA,aAAY;AAAA,IAChB,CAAC,cAAsB;AACrB,qBAAe,SAAS;AACxB,oBAAc,SAAS;AAGvB,UAAI,YAAY;AACd,kBAAU,YAAY,SAAS;AAAA,MACjC;AAGA,uBAAiB,SAAS;AAAA,IAC5B;AAAA,IACA,CAAC,YAAY,cAAc;AAAA,EAC7B;AAEA,QAAM,QAAQ,QAAQ,OAAO,EAAE,QAAQ,WAAAA,WAAU,IAAI,CAAC,QAAQA,UAAS,CAAC;AAExE,SAAO,oBAAC,cAAc,UAAd,EAAuB,OAAe,UAAS;AACzD;;;AE3DA,SAAS,eAAAC,oBAAmB;AAE5B,SAAS,KAAK,aAAa;AAMpB,SAAS,YAAgD;AAC9D,QAAM,EAAE,QAAQ,WAAAC,WAAU,IAAI,iBAAiB;AAC/C,SAAO,CAAC,QAAQA,UAAS;AAC3B;AASO,SAAS,OAAwD;AACtE,QAAM,EAAE,OAAO,IAAI,iBAAiB;AAEpC,SAAOC;AAAA,IACL,CAAC,KAAa,SAA2B,MAAM,KAAK,MAAM,MAAM;AAAA,IAChE,CAAC,MAAM;AAAA,EACT;AACF;;;AC3BA,SAAS,UAAmD;AAmCjD,0BAAAC,YAAA;AAJJ,SAAS,EAAE,OAAe;AAC/B,QAAM,EAAE,IAAI,IAAI,cAAc,GAAG,KAAK,IAAI;AAE1C,MAAI,cAAc;AAChB,WAAO,gBAAAA,KAAA,YAAG,aAAG,cAAc,IAAI,GAAE;AAAA,EACnC;AAEA,MAAI,OAAO,UAAa,OAAO,QAAW;AACxC,WAAO,gBAAAA,KAAA,YAAG,aAAG,IAAI,IAAI,IAAI,GAAE;AAAA,EAC7B;AAEA,QAAM,IAAI,MAAM,wEAAwE;AAC1F;;;ACtCA;AAAA,EAEE,MAAAC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAQK;","names":["setLocale","useCallback","setLocale","useCallback","jsx","it"]}
+{"version":3,"sources":["../src/provider.tsx","../src/context.tsx","../src/hooks.ts","../src/component.tsx","../src/richtext.tsx","../src/index.ts"],"sourcesContent":["import { useState, useCallback, useMemo, useEffect, type ReactNode } from 'react'\nimport { setLocale as setCoreLocale, type Locale } from 'inline-i18n-multi'\nimport { LocaleContext } from './context'\n\ninterface LocaleProviderProps {\n  /**\n   * Initial locale value\n   */\n  locale: Locale\n  /**\n   * Cookie name for persisting locale (default: NEXT_LOCALE)\n   * Set to false to disable cookie sync\n   */\n  cookieName?: string | false\n  /**\n   * Callback when locale changes\n   */\n  onLocaleChange?: (locale: Locale) => void\n  children: ReactNode\n}\n\nfunction setCookie(name: string, value: string, days = 365): void {\n  if (typeof document === 'undefined') return\n  const expires = new Date(Date.now() + days * 864e5).toUTCString()\n  document.cookie = `${name}=${value}; expires=${expires}; path=/; SameSite=Lax`\n}\n\nexport function LocaleProvider({\n  locale: initialLocale,\n  cookieName = 'NEXT_LOCALE',\n  onLocaleChange,\n  children,\n}: LocaleProviderProps) {\n  const [locale, setLocaleState] = useState<Locale>(initialLocale)\n\n  // sync with core package on mount and locale change\n  useEffect(() => {\n    setCoreLocale(locale)\n  }, [locale])\n\n  const setLocale = useCallback(\n    (newLocale: Locale) => {\n      setLocaleState(newLocale)\n      setCoreLocale(newLocale)\n\n      // sync cookie for Next.js middleware\n      if (cookieName) {\n        setCookie(cookieName, newLocale)\n      }\n\n      // callback for custom handling\n      onLocaleChange?.(newLocale)\n    },\n    [cookieName, onLocaleChange]\n  )\n\n  const value = useMemo(() => ({ locale, setLocale }), [locale, setLocale])\n\n  return <LocaleContext.Provider value={value}>{children}</LocaleContext.Provider>\n}\n","import { createContext, useContext } from 'react'\nimport type { Locale } from 'inline-i18n-multi'\n\ninterface LocaleContextValue {\n  locale: Locale\n  setLocale: (locale: Locale) => void\n}\n\nexport const LocaleContext = createContext<LocaleContextValue | null>(null)\n\nexport function useLocaleContext(): LocaleContextValue {\n  const context = useContext(LocaleContext)\n\n  if (!context) {\n    throw new Error('useLocaleContext must be used within a LocaleProvider')\n  }\n\n  return context\n}\n","import { useCallback, useState, useEffect } from 'react'\nimport { useLocaleContext } from './context'\nimport { t as coreT, loadAsync, isLoaded, detectLocale, setLocale } from 'inline-i18n-multi'\nimport type { Locale, TranslationVars, DetectLocaleOptions } from 'inline-i18n-multi'\n\n/**\n * Get current locale and setter\n */\nexport function useLocale(): [Locale, (locale: Locale) => void] {\n  const { locale, setLocale } = useLocaleContext()\n  return [locale, setLocale]\n}\n\n/**\n * Get translation function bound to current locale\n * @example\n * const t = useT()\n * t('greeting.hello') // uses context locale\n * t('items.count', { count: 5 })\n */\nexport function useT(): (key: string, vars?: TranslationVars) => string {\n  const { locale } = useLocaleContext()\n\n  return useCallback(\n    (key: string, vars?: TranslationVars) => coreT(key, vars, locale),\n    [locale]\n  )\n}\n\n/**\n * Hook for lazy loading dictionaries\n * Automatically loads dictionaries when locale or namespace changes\n *\n * @example\n * function Dashboard() {\n *   const { isLoading, error } = useLoadDictionaries('ko', 'dashboard')\n *   if (isLoading) return <Spinner />\n *   if (error) return <Error message={error.message} />\n *   return <Content />\n * }\n */\nexport function useLoadDictionaries(\n  locale: Locale,\n  namespace?: string\n): { isLoading: boolean; error: Error | null } {\n  const [isLoading, setIsLoading] = useState(() => !isLoaded(locale, namespace))\n  const [error, setError] = useState<Error | null>(null)\n\n  useEffect(() => {\n    if (isLoaded(locale, namespace)) {\n      setIsLoading(false)\n      setError(null)\n      return\n    }\n\n    setIsLoading(true)\n    setError(null)\n\n    loadAsync(locale, namespace)\n      .then(() => setIsLoading(false))\n      .catch((err) => {\n        setError(err instanceof Error ? err : new Error(String(err)))\n        setIsLoading(false)\n      })\n  }, [locale, namespace])\n\n  return { isLoading, error }\n}\n\n/**\n * Hook that auto-detects and sets locale on mount\n *\n * @example\n * function App() {\n *   useDetectedLocale({\n *     supportedLocales: ['en', 'ko', 'ja'],\n *     defaultLocale: 'en',\n *     sources: ['cookie', 'navigator'],\n *   })\n *   return <Content />\n * }\n */\nexport function useDetectedLocale(options: DetectLocaleOptions): void {\n  const { setLocale: setContextLocale } = useLocaleContext()\n\n  useEffect(() => {\n    const detected = detectLocale(options)\n    setLocale(detected)\n    setContextLocale(detected)\n    // Run once on mount\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [])\n}\n","import { it, type Translations, type TranslationVars } from 'inline-i18n-multi'\n\ninterface TPropsShorthand {\n  /**\n   * Korean text\n   */\n  ko: string\n  /**\n   * English text\n   */\n  en: string\n  translations?: never\n}\n\ninterface TPropsObject {\n  ko?: never\n  en?: never\n  /**\n   * Translation map with locale keys\n   */\n  translations: Translations\n}\n\ntype TProps = (TPropsShorthand | TPropsObject) & TranslationVars\n\n/**\n * Translation component for JSX\n * @example <T ko=\"안녕\" en=\"Hello\" />\n * @example <T translations={{ ko: '안녕', en: 'Hello', ja: 'こんにちは' }} />\n * @example <T ko=\"안녕 {name}\" en=\"Hello {name}\" name=\"철수\" />\n */\nexport function T(props: TProps) {\n  const { ko, en, translations, ...vars } = props\n\n  if (translations) {\n    return <>{it(translations, vars)}</>\n  }\n\n  if (ko !== undefined && en !== undefined) {\n    return <>{it(ko, en, vars)}</>\n  }\n\n  throw new Error('T component requires either \"translations\" or both \"ko\" and \"en\" props')\n}\n","import React, { type ReactNode, useMemo, useCallback, Fragment } from 'react'\nimport { it, parseRichText, type Translations, type TranslationVars } from 'inline-i18n-multi'\n\ntype ComponentRenderer = (text: string) => ReactNode\n\ninterface RichTextProps {\n  /**\n   * Translation map with locale keys\n   * Tags like <link>text</link> will be matched to component renderers\n   */\n  translations: Translations\n  /**\n   * Component renderers for each tag name\n   * @example { link: (text) => <a href=\"/terms\">{text}</a> }\n   */\n  components: Record<string, ComponentRenderer>\n  /**\n   * Variables for interpolation (applied before rich text parsing)\n   */\n  vars?: TranslationVars\n}\n\n/**\n * Rich text translation component\n * Supports embedding React components within translations\n *\n * @example\n * <RichText\n *   translations={{\n *     en: 'Read <link>terms</link> and <bold>agree</bold>',\n *     ko: '<link>약관</link>을 읽고 <bold>동의</bold>해주세요'\n *   }}\n *   components={{\n *     link: (text) => <a href=\"/terms\">{text}</a>,\n *     bold: (text) => <strong>{text}</strong>\n *   }}\n * />\n */\nexport function RichText({ translations, components, vars }: RichTextProps): React.JSX.Element {\n  const componentNames = useMemo(() => Object.keys(components), [components])\n\n  // Resolve locale and interpolate variables ({curly} braces)\n  // Rich text tags (<angle> brackets) don't conflict with variable interpolation\n  const resolved = it(translations, vars)\n  const segments = parseRichText(resolved, componentNames)\n\n  return (\n    <>\n      {segments.map((segment, index) => {\n        if (segment.type === 'text') {\n          return <Fragment key={index}>{segment.content}</Fragment>\n        }\n        const renderer = components[segment.componentName!]\n        if (!renderer) {\n          return <Fragment key={index}>{segment.content}</Fragment>\n        }\n        return <Fragment key={index}>{renderer(segment.content)}</Fragment>\n      })}\n    </>\n  )\n}\n\n/**\n * Hook for rich text translations\n * Returns a function that resolves translations with component interpolation\n *\n * @example\n * const richT = useRichText({\n *   link: (text) => <a href=\"/terms\">{text}</a>,\n *   bold: (text) => <strong>{text}</strong>,\n * })\n * return richT({ en: 'Click <link>here</link>', ko: '<link>여기</link> 클릭' })\n */\nexport function useRichText(\n  components: Record<string, ComponentRenderer>\n): (translations: Translations, vars?: TranslationVars) => ReactNode {\n  const componentNames = useMemo(() => Object.keys(components), [components])\n\n  return useCallback(\n    (translations: Translations, vars?: TranslationVars): ReactNode => {\n      const resolved = it(translations, vars)\n      const segments = parseRichText(resolved, componentNames)\n\n      return (\n        <>\n          {segments.map((segment, index) => {\n            if (segment.type === 'text') {\n              return <Fragment key={index}>{segment.content}</Fragment>\n            }\n            const renderer = components[segment.componentName!]\n            if (!renderer) {\n              return <Fragment key={index}>{segment.content}</Fragment>\n            }\n            return <Fragment key={index}>{renderer(segment.content)}</Fragment>\n          })}\n        </>\n      )\n    },\n    [components, componentNames]\n  )\n}\n","export { LocaleProvider } from './provider'\nexport { useLocale, useT, useLoadDictionaries, useDetectedLocale } from './hooks'\nexport { T } from './component'\nexport { RichText, useRichText } from './richtext'\n\n// re-export from core for convenience\nexport {\n  // inline translations\n  it,\n  it_ja,\n  it_zh,\n  it_es,\n  it_fr,\n  it_de,\n  en_ja,\n  en_zh,\n  en_es,\n  en_fr,\n  en_de,\n  ja_zh,\n  ja_es,\n  zh_es,\n  getLocale,\n  setLocale,\n  // key-based translations (i18n compatible)\n  t,\n  loadDictionaries,\n  loadDictionary,\n  clearDictionaries,\n  hasTranslation,\n  getLoadedLocales,\n  getDictionary,\n  loadAsync,\n  isLoaded,\n  // configuration\n  configure,\n  getConfig,\n  resetConfig,\n  // rich text parsing\n  parseRichText,\n  type RichTextSegment,\n  // custom formatters (v0.6.0)\n  registerFormatter,\n  clearFormatters,\n  type CustomFormatter,\n  // locale detection (v0.6.0)\n  detectLocale,\n  type DetectLocaleOptions,\n  type DetectSource,\n  // types\n  type Locale,\n  type Translations,\n  type TranslationVars,\n  type Dictionary,\n  type Dictionaries,\n  type PluralRules,\n} from 'inline-i18n-multi'\n"],"mappings":"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","names":["setLocale","useCallback","useState","useEffect","setLocale","useCallback","useState","useEffect","jsx","useMemo","useCallback","Fragment","it","jsx","it","setLocale","loadAsync","isLoaded","parseRichText","detectLocale"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "inline-i18n-multi-react",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "React integration for inline-i18n-multi",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -34,7 +34,7 @@
     "react": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "inline-i18n-multi": "0.4.0"
+    "inline-i18n-multi": "0.6.0"
   },
   "devDependencies": {
     "@types/react": "^19.0.2",