inline-i18n-multi-react 0.5.0 → 0.7.0

package/README.md

@@ -60,14 +60,162 @@ 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>
+}
+```
+
+## Plural Shorthand (v0.7.0)
+
+Concise plural syntax sugar:
+
+```tsx
+function Items({ count }: { count: number }) {
+  return (
+    <p>
+      {it({
+        en: '{count, p, item|items}',
+        ko: '{count, p, 개|개}',
+      }, { count })}
+    </p>
+  )
+}
+// count=1 → "1 item", count=5 → "5 items"
+
+// 3-part with zero:
+// {count, p, none|item|items} → count=0: "none", count=1: "1 item", count=5: "5 items"
+```
+
+## Locale Persistence (v0.7.0)
+
+Auto-save and restore locale to cookie or localStorage:
+
+```tsx
+import { configure, restoreLocale } from 'inline-i18n-multi-react'
+
+// Save to cookie on setLocale()
+configure({
+  persistLocale: { storage: 'cookie', key: 'LOCALE', expires: 365 }
+})
+
+// Or use localStorage
+configure({
+  persistLocale: { storage: 'localStorage', key: 'LOCALE' }
+})
+
+// Restore saved locale
+const saved = restoreLocale()  // returns locale string or undefined
+```
+
+## 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`
+
+**ICU cache & persistence:**
+`clearICUCache`, `restoreLocale`
 
 ## Documentation
 

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
-import { Locale, TranslationVars, Translations } from 'inline-i18n-multi';
-export { Dictionaries, Dictionary, Locale, PluralRules, RichTextSegment, TranslationVars, Translations, clearDictionaries, en_de, en_es, en_fr, en_ja, en_zh, getDictionary, getLoadedLocales, getLocale, hasTranslation, isLoaded, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadAsync, loadDictionaries, loadDictionary, parseRichText, setLocale, t, zh_es } from 'inline-i18n-multi';
+import { Locale, TranslationVars, DetectLocaleOptions, Translations } from 'inline-i18n-multi';
+export { CustomFormatter, DetectLocaleOptions, DetectSource, Dictionaries, Dictionary, Locale, PluralRules, RichTextSegment, TranslationVars, Translations, clearDictionaries, clearFormatters, clearICUCache, 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, restoreLocale, setLocale, t, zh_es } from 'inline-i18n-multi';
 
 interface LocaleProviderProps {
     /**
@@ -49,6 +49,20 @@ 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 {
     /**
@@ -125,4 +139,4 @@ declare function RichText({ translations, components, vars }: RichTextProps): Re
  */
 declare function useRichText(components: Record<string, ComponentRenderer>): (translations: Translations, vars?: TranslationVars) => ReactNode;
 
-export { LocaleProvider, RichText, T, useLoadDictionaries, useLocale, useRichText, useT };
+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 React, { ReactNode } from 'react';
-import { Locale, TranslationVars, Translations } from 'inline-i18n-multi';
-export { Dictionaries, Dictionary, Locale, PluralRules, RichTextSegment, TranslationVars, Translations, clearDictionaries, en_de, en_es, en_fr, en_ja, en_zh, getDictionary, getLoadedLocales, getLocale, hasTranslation, isLoaded, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadAsync, loadDictionaries, loadDictionary, parseRichText, setLocale, t, zh_es } from 'inline-i18n-multi';
+import { Locale, TranslationVars, DetectLocaleOptions, Translations } from 'inline-i18n-multi';
+export { CustomFormatter, DetectLocaleOptions, DetectSource, Dictionaries, Dictionary, Locale, PluralRules, RichTextSegment, TranslationVars, Translations, clearDictionaries, clearFormatters, clearICUCache, 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, restoreLocale, setLocale, t, zh_es } from 'inline-i18n-multi';
 
 interface LocaleProviderProps {
     /**
@@ -49,6 +49,20 @@ 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 {
     /**
@@ -125,4 +139,4 @@ declare function RichText({ translations, components, vars }: RichTextProps): Re
  */
 declare function useRichText(components: Record<string, ComponentRenderer>): (translations: Translations, vars?: TranslationVars) => ReactNode;
 
-export { LocaleProvider, RichText, T, useLoadDictionaries, useLocale, useRichText, useT };
+export { LocaleProvider, RichText, T, useDetectedLocale, useLoadDictionaries, useLocale, useRichText, useT };

package/dist/index.js

@@ -25,11 +25,16 @@ __export(index_exports, {
   RichText: () => RichText,
   T: () => T,
   clearDictionaries: () => import_inline_i18n_multi5.clearDictionaries,
+  clearFormatters: () => import_inline_i18n_multi5.clearFormatters,
+  clearICUCache: () => import_inline_i18n_multi5.clearICUCache,
+  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,
@@ -47,8 +52,12 @@ __export(index_exports, {
   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,
+  restoreLocale: () => import_inline_i18n_multi5.restoreLocale,
   setLocale: () => import_inline_i18n_multi5.setLocale,
   t: () => import_inline_i18n_multi5.t,
+  useDetectedLocale: () => useDetectedLocale,
   useLoadDictionaries: () => useLoadDictionaries,
   useLocale: () => useLocale,
   useRichText: () => useRichText,
@@ -89,7 +98,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);
@@ -100,7 +109,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 });
 }
 
@@ -108,8 +117,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();
@@ -136,6 +145,14 @@ function useLoadDictionaries(locale, namespace) {
   }, [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");
@@ -199,11 +216,16 @@ var import_inline_i18n_multi5 = require("inline-i18n-multi");
   RichText,
   T,
   clearDictionaries,
+  clearFormatters,
+  clearICUCache,
+  configure,
+  detectLocale,
   en_de,
   en_es,
   en_fr,
   en_ja,
   en_zh,
+  getConfig,
   getDictionary,
   getLoadedLocales,
   getLocale,
@@ -221,8 +243,12 @@ var import_inline_i18n_multi5 = require("inline-i18n-multi");
   loadDictionaries,
   loadDictionary,
   parseRichText,
+  registerFormatter,
+  resetConfig,
+  restoreLocale,
   setLocale,
   t,
+  useDetectedLocale,
   useLoadDictionaries,
   useLocale,
   useRichText,

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","../src/richtext.tsx"],"sourcesContent":["export { LocaleProvider } from './provider'\nexport { useLocale, useT, useLoadDictionaries } 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  // rich text parsing\n  parseRichText,\n  type RichTextSegment,\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 } 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\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","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":";;;;;;;;;;;;;;;;;;;;;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;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,gBAAiD;AAEjD,IAAAC,4BAAgD;AAMzC,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;AAcO,SAAS,oBACd,QACA,WAC6C;AAC7C,QAAM,CAAC,WAAW,YAAY,QAAI,wBAAS,MAAM,KAAC,oCAAS,QAAQ,SAAS,CAAC;AAC7E,QAAM,CAAC,OAAO,QAAQ,QAAI,wBAAuB,IAAI;AAErD,+BAAU,MAAM;AACd,YAAI,oCAAS,QAAQ,SAAS,GAAG;AAC/B,mBAAa,KAAK;AAClB,eAAS,IAAI;AACb;AAAA,IACF;AAEA,iBAAa,IAAI;AACjB,aAAS,IAAI;AAEb,6CAAU,QAAQ,SAAS,EACxB,KAAK,MAAM,aAAa,KAAK,CAAC,EAC9B,MAAM,CAAC,QAAQ;AACd,eAAS,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC,CAAC;AAC5D,mBAAa,KAAK;AAAA,IACpB,CAAC;AAAA,EACL,GAAG,CAAC,QAAQ,SAAS,CAAC;AAEtB,SAAO,EAAE,WAAW,MAAM;AAC5B;;;ACnEA,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;;;AC3CA,IAAAC,gBAAsE;AACtE,IAAAC,4BAA2E;AA8CvE,IAAAC,sBAAA;AATG,SAAS,SAAS,EAAE,cAAc,YAAY,KAAK,GAAqC;AAC7F,QAAM,qBAAiB,uBAAQ,MAAM,OAAO,KAAK,UAAU,GAAG,CAAC,UAAU,CAAC;AAI1E,QAAM,eAAW,8BAAG,cAAc,IAAI;AACtC,QAAM,eAAW,yCAAc,UAAU,cAAc;AAEvD,SACE,6EACG,mBAAS,IAAI,CAAC,SAAS,UAAU;AAChC,QAAI,QAAQ,SAAS,QAAQ;AAC3B,aAAO,6CAAC,0BAAsB,kBAAQ,WAAhB,KAAwB;AAAA,IAChD;AACA,UAAM,WAAW,WAAW,QAAQ,aAAc;AAClD,QAAI,CAAC,UAAU;AACb,aAAO,6CAAC,0BAAsB,kBAAQ,WAAhB,KAAwB;AAAA,IAChD;AACA,WAAO,6CAAC,0BAAsB,mBAAS,QAAQ,OAAO,KAAhC,KAAkC;AAAA,EAC1D,CAAC,GACH;AAEJ;AAaO,SAAS,YACd,YACmE;AACnE,QAAM,qBAAiB,uBAAQ,MAAM,OAAO,KAAK,UAAU,GAAG,CAAC,UAAU,CAAC;AAE1E,aAAO;AAAA,IACL,CAAC,cAA4B,SAAsC;AACjE,YAAM,eAAW,8BAAG,cAAc,IAAI;AACtC,YAAM,eAAW,yCAAc,UAAU,cAAc;AAEvD,aACE,6EACG,mBAAS,IAAI,CAAC,SAAS,UAAU;AAChC,YAAI,QAAQ,SAAS,QAAQ;AAC3B,iBAAO,6CAAC,0BAAsB,kBAAQ,WAAhB,KAAwB;AAAA,QAChD;AACA,cAAM,WAAW,WAAW,QAAQ,aAAc;AAClD,YAAI,CAAC,UAAU;AACb,iBAAO,6CAAC,0BAAsB,kBAAQ,WAAhB,KAAwB;AAAA,QAChD;AACA,eAAO,6CAAC,0BAAsB,mBAAS,QAAQ,OAAO,KAAhC,KAAkC;AAAA,MAC1D,CAAC,GACH;AAAA,IAEJ;AAAA,IACA,CAAC,YAAY,cAAc;AAAA,EAC7B;AACF;;;AL9FA,IAAAC,4BAsCO;","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"]}
+{"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) + ICU cache (v0.7.0)\n  registerFormatter,\n  clearFormatters,\n  clearICUCache,\n  type CustomFormatter,\n  // locale persistence (v0.7.0)\n  restoreLocale,\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, useState as useState2, useEffect as useEffect2 } from "react";
-import { t as coreT, loadAsync, isLoaded } from "inline-i18n-multi";
+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();
@@ -79,6 +79,14 @@ function useLoadDictionaries(locale, namespace) {
   }, [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";
@@ -151,7 +159,7 @@ import {
   ja_es,
   zh_es,
   getLocale,
-  setLocale,
+  setLocale as setLocale2,
   t,
   loadDictionaries,
   loadDictionary,
@@ -161,18 +169,31 @@ import {
   getDictionary,
   loadAsync as loadAsync2,
   isLoaded as isLoaded2,
-  parseRichText as parseRichText2
+  configure,
+  getConfig,
+  resetConfig,
+  parseRichText as parseRichText2,
+  registerFormatter,
+  clearFormatters,
+  clearICUCache,
+  restoreLocale,
+  detectLocale as detectLocale2
 } from "inline-i18n-multi";
 export {
   LocaleProvider,
   RichText,
   T,
   clearDictionaries,
+  clearFormatters,
+  clearICUCache,
+  configure,
+  detectLocale2 as detectLocale,
   en_de,
   en_es,
   en_fr,
   en_ja,
   en_zh,
+  getConfig,
   getDictionary,
   getLoadedLocales,
   getLocale,
@@ -190,8 +211,12 @@ export {
   loadDictionaries,
   loadDictionary,
   parseRichText2 as parseRichText,
-  setLocale,
+  registerFormatter,
+  resetConfig,
+  restoreLocale,
+  setLocale2 as setLocale,
   t,
+  useDetectedLocale,
   useLoadDictionaries,
   useLocale,
   useRichText,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"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 } 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\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","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 } 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  // rich text parsing\n  parseRichText,\n  type RichTextSegment,\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","loadAsync","isLoaded","parseRichText"]}
+{"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) + ICU cache (v0.7.0)\n  registerFormatter,\n  clearFormatters,\n  clearICUCache,\n  type CustomFormatter,\n  // locale persistence (v0.7.0)\n  restoreLocale,\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.5.0",
+  "version": "0.7.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.5.0"
+    "inline-i18n-multi": "0.7.0"
   },
   "devDependencies": {
     "@types/react": "^19.0.2",