@intlayer/docs 7.3.15 → 7.5.0-canary.0

package/docs/it/intlayer_with_tanstack.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2025-09-09
+updatedAt: 2025-12-11
 title: Come tradurre la tua Tanstack Start – guida i18n 2025
 description: Scopri come aggiungere l'internazionalizzazione (i18n) alla tua applicazione Tanstack Start utilizzando Intlayer. Segui questa guida completa per rendere la tua app multilingue con il routing consapevole della localizzazione.
 keywords:
@@ -19,9 +19,12 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-tanstack-start-template
 youtubeVideo: https://www.youtube.com/watch?v=_XTdKVWaeqg
 history:
+  - version: 7.4.0
+    date: 2025-12-11
+    changes: Introdotto validatePrefix e aggiunto il passaggio 14: Gestione delle pagine 404 con rotte localizzate.
   - version: 7.3.9
     date: 2025-12-05
-    changes: Add step 13: Retrieve the locale in your server actions (Optional)
+    changes: Aggiunto passaggio 13: Recupera la lingua locale nelle server actions (Opzionale)
   - version: 6.5.2
     date: 2025-10-03
     changes: Aggiornamento documentazione
@@ -622,7 +625,123 @@ export const getLocaleServer = createServerFn().handler(async () => {
 
 ---
 
-### Passo 14: Configurare TypeScript (Opzionale)
+### Passo 14: Gestire le pagine non trovate (Opzionale)
+
+Quando un utente visita una pagina inesistente, puoi visualizzare una pagina personalizzata di non trovata e il prefisso locale può influenzare il modo in cui viene attivata la pagina di non trovata.
+
+#### Comprendere la gestione 404 di TanStack Router con prefissi locale
+
+In TanStack Router, gestire le pagine 404 con route localizzate richiede un approccio multistrato:
+
+1. **Route 404 dedicata**: Una route specifica per visualizzare l'interfaccia utente 404
+2. **Validazione a livello di route**: Valida i prefissi locale e reindirizza quelli non validi a 404
+3. **Route catch-all**: Cattura tutti i percorsi non corrispondenti all'interno del segmento locale
+
+```tsx fileName="src/routes/{-$locale}/404.tsx"
+import { createFileRoute } from "@tanstack/react-router";
+
+// Questo crea una route dedicata /[locale]/404
+// Viene utilizzata sia come route diretta che importata come componente in altri file
+export const Route = createFileRoute("/{-$locale}/404")({
+  component: NotFoundComponent,
+});
+
+// Esportato separatamente in modo che possa essere riutilizzato in notFoundComponent e route catch-all
+export function NotFoundComponent() {
+  return (
+    <div>
+      <h1>404</h1>
+    </div>
+  );
+}
+```
+
+```tsx fileName="src/routes/{-$locale}/route.tsx"
+import { createFileRoute, Outlet, redirect } from "@tanstack/react-router";
+import { validatePrefix } from "intlayer";
+import { IntlayerProvider, useLocale } from "react-intlayer";
+
+import { LocaleSwitcher } from "@/components/locale-switcher";
+import { NotFoundComponent } from "./404";
+
+export const Route = createFileRoute("/{-$locale}")({
+  // beforeLoad viene eseguito prima che la route venga renderizzata (sia sul server che sul client)
+  // È il posto ideale per validare il prefisso della locale
+  beforeLoad: ({ params }) => {
+    // Ottieni la locale dai parametri della route (non dagli header del server, poiché beforeLoad viene eseguito sia sul client che sul server)
+    const localeParam = params.locale;
+
+    // validatePrefix verifica se la locale è valida secondo la tua configurazione intlayer
+    // Restituisce: { isValid: boolean, localePrefix: string }
+    // - isValid: true se il prefisso corrisponde a una locale configurata (o è vuoto quando il prefisso è opzionale)
+    // - localePrefix: il prefisso validato o il prefisso della locale predefinito per i reindirizzamenti
+    const { isValid, localePrefix } = validatePrefix(localeParam);
+
+    if (isValid) {
+      // La locale è valida, consenti alla route di renderizzarsi normalmente
+      return;
+    }
+
+    // Prefisso della locale non valido (ad esempio, /xyz/about dove "xyz" non è una locale valida)
+    // Reindirizza alla pagina 404 con un prefisso della locale valido
+    // Questo assicura che la pagina 404 sia ancora correttamente localizzata
+    throw redirect({
+      to: "/{-$locale}/404",
+      params: { locale: localePrefix },
+    });
+  },
+  component: RouteComponent,
+  // notFoundComponent viene chiamato quando una route figlia non esiste
+  // ad esempio, /en/pagina-inesistente attiva questo all'interno del layout /en
+  notFoundComponent: NotFoundLayout,
+});
+
+function RouteComponent() {
+  const { defaultLocale } = useLocale();
+  const { locale } = Route.useParams();
+
+  return (
+    // Avvolgi l'intero segmento della locale con IntlayerProvider
+    // Torna a defaultLocale quando il parametro locale è undefined (modalità prefisso opzionale)
+    <IntlayerProvider locale={locale ?? defaultLocale}>
+      <Outlet />
+    </IntlayerProvider>
+  );
+}
+
+// NotFoundLayout avvolge il componente 404 con IntlayerProvider
+// Questo assicura che le traduzioni funzionino ancora sulla pagina 404
+function NotFoundLayout() {
+  const { defaultLocale } = useLocale();
+  const { locale } = Route.useParams();
+
+  return (
+    <IntlayerProvider locale={locale ?? defaultLocale}>
+      <NotFoundComponent />
+      {/* Includi LocaleSwitcher in modo che gli utenti possano cambiare lingua anche su 404 */}
+      <LocaleSwitcher />
+    </IntlayerProvider>
+  );
+}
+```
+
+```tsx fileName="src/routes/{-$locale}/$.tsx"
+import { createFileRoute } from "@tanstack/react-router";
+
+import { NotFoundComponent } from "./404";
+
+// La route $ (splat/catch-all) corrisponde a qualsiasi percorso che non corrisponde ad altre route
+// ad esempio, /en/qualche/percorso/profondamente/annidato/non-valido
+// Questo assicura che TUTTI i percorsi non corrispondenti all'interno di una locale mostrino la pagina 404
+// Senza questo, i percorsi profondi non corrispondenti potrebbero mostrare una pagina vuota o un errore
+export const Route = createFileRoute("/{-$locale}/$")({
+  component: NotFoundComponent,
+});
+```
+
+---
+
+### Passo 15: Configurare TypeScript (Opzionale)
 
 Intlayer utilizza l'augmentation dei moduli per sfruttare i vantaggi di TypeScript e rendere il tuo codice più robusto.
 

package/docs/it/plugins/sync-json.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-03-13
-updatedAt: 2025-10-05
+updatedAt: 2025-12-13
 title: Plugin Sync JSON
 description: Sincronizza i dizionari Intlayer con file JSON i18n di terze parti (i18next, next-intl, react-intl, vue-i18n e altri). Mantieni il tuo i18n esistente mentre usi Intlayer per gestire, tradurre e testare i tuoi messaggi.
 keywords:
@@ -24,12 +24,15 @@ slugs:
   - sync-json
 youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
 history:
+  - version: 7.5.0
+    date: 2025-12-13
+    changes: Aggiunto supporto per i formati ICU e i18next
   - version: 6.1.6
     date: 2025-10-05
     changes: Documentazione iniziale del plugin Sync JSON
 ---
 
-# Sync JSON (ponti i18n)
+# Sync JSON (ponti i18n) - Sync JSON con supporto ICU / i18next
 
 <iframe title="Come mantenere sincronizzate le tue traduzioni JSON con Intlayer" class="m-auto aspect-[16/9] w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/MpGMxniDHNg?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
@@ -105,9 +108,27 @@ syncJSON({
   source: ({ key, locale }) => string, // richiesto
   location?: string, // etichetta opzionale, predefinito: "plugin"
   priority?: number, // priorità opzionale per la risoluzione dei conflitti, predefinito: 0
+  format?: 'intlayer' | 'icu' | 'i18next', // formattatore opzionale, predefinito: 'intlayer'
 });
 ```
 
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+Specifica il formattatore da utilizzare per il contenuto del dizionario durante la sincronizzazione dei file JSON. Ciò consente di utilizzare diverse sintassi di formattazione dei messaggi compatibili con varie librerie i18n.
+
+- `'intlayer'`: Il formattatore Intlayer predefinito (predefinito).
+- `'icu'`: Utilizza la formattazione dei messaggi ICU (compatibile con librerie come react-intl, vue-i18n).
+- `'i18next'`: Utilizza la formattazione dei messaggi i18next (compatibile con i18next, next-i18next, Solid-i18next).
+
+**Esempio:**
+
+```ts
+syncJSON({
+  source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+  format: "i18next", // Usare la formattazione i18next per la compatibilità
+}),
+```
+
 ## Più sorgenti JSON e priorità
 
 Puoi aggiungere più plugin `syncJSON` per sincronizzare diverse sorgenti JSON. Questo è utile quando hai più librerie i18n o diverse strutture JSON nel tuo progetto.
@@ -134,6 +155,7 @@ export default defineConfig({
   plugins: [
     // Sorgente JSON primaria (priorità più alta)
     syncJSON({
+      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
       location: "main-translations",
       priority: 10,
@@ -141,6 +163,7 @@ export default defineConfig({
 
     // Sorgente JSON di fallback (priorità più bassa)
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `./fallback-locales/${locale}.json`,
       location: "fallback-translations",
       priority: 5,
@@ -148,6 +171,7 @@ export default defineConfig({
 
     // Sorgente JSON legacy (priorità più bassa)
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `/my/other/app/legacy/${locale}/messages.json`,
       location: "legacy-translations",
       priority: 1,
@@ -178,6 +202,7 @@ import { syncJSON } from "@intlayer/sync-json-plugin";
 export default {
   plugins: [
     syncJSON({
+      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
     }),
   ],

package/docs/ja/dictionary/content_file.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2025-09-20
+updatedAt: 2025-12-13
 title: コンテンツファイル
 description: コンテンツ宣言ファイルの拡張機能をカスタマイズする方法を学びます。このドキュメントに従って、プロジェクトで効率的に条件を実装しましょう。
 keywords:
@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 7.5.0
+    date: 2025-12-13
+    changes: ICUおよびi18next形式のサポートを追加
   - version: 6.0.0
     date: 2025-09-20
     changes: フィールドのドキュメントを追加
@@ -387,6 +390,26 @@ Intlayerの辞書は`Dictionary`型で定義され、その動作を制御する
 }
 ```
 
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+辞書コンテンツに使用するフォーマッターを指定します。これにより、異なるメッセージフォーマット構文を使用できます。
+
+- `'intlayer'`: デフォルトのIntlayerフォーマッター。
+- `'icu'`: ICUメッセージフォーマットを使用します。
+- `'i18next'`: i18nextメッセージフォーマットを使用します。
+
+**例：**
+
+```typescript
+{
+  key: "my-dictionary",
+  format: "icu",
+  content: {
+    message: "Hello {name}, you have {count, plural, one {# message} other {# messages}}"
+  }
+}
+```
+
 #### `locale` (LocalesValues)
 
 辞書をロケールごとの辞書に変換し、content内で宣言された各フィールドが自動的に翻訳ノードに変換されます。このプロパティが設定されている場合：

package/docs/ja/intlayer_with_astro.md

@@ -2,7 +2,7 @@
 createdAt: 2024-03-07
 updatedAt: 2025-10-03
 title: Astroアプリを翻訳する方法 – i18nガイド 2025
-description: Intlayerを使用してViteとReactアプリケーションに国際化（i18n）を追加する方法を学びます。このガイドに従ってアプリを多言語対応にしましょう。
+description: Intlayerを使用してAstroウェブサイトに国際化（i18n）を追加する方法を学びます。このガイドに従ってサイトを多言語対応にしましょう。
 keywords:
   - 国際化
   - ドキュメント

package/docs/ja/intlayer_with_express.md

@@ -2,7 +2,7 @@
 createdAt: 2024-08-11
 updatedAt: 2025-06-29
 title: Express backendアプリを翻訳する方法 – i18nガイド 2025
-description: viteバックエンドを多言語化する方法を見つけましょう。国際化（i18n）して翻訳するためにドキュメントに従ってください。
+description: Expressバックエンドを多言語化する方法を見つけましょう。国際化（i18n）して翻訳するためにドキュメントに従ってください。
 keywords:
   - 国際化
   - ドキュメンテーション

package/docs/ja/intlayer_with_nestjs.md

@@ -2,7 +2,7 @@
 createdAt: 2025-09-09
 updatedAt: 2025-09-09
 title: Nest backendアプリを翻訳する方法 – i18nガイド 2025
-description: Viteバックエンドを多言語対応にする方法を紹介します。国際化（i18n）と翻訳のためのドキュメントに従ってください。
+description: NestJSバックエンドを多言語対応にする方法を紹介します。国際化（i18n）と翻訳のためのドキュメントに従ってください。
 keywords:
   - 国際化
   - ドキュメント

package/docs/ja/intlayer_with_next-i18next.md

@@ -580,6 +580,7 @@ const config: IntlayerConfig = {
   },
   plugins: [
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `./locales/${locale}.json`,
     }),
   ],

package/docs/ja/intlayer_with_next-intl.md

@@ -419,6 +419,7 @@ const config: IntlayerConfig = {
   plugins: [
     // 各ネームスペースのフォルダ構造をIntlayerと同期させる
     syncJSON({
+      format: "icu",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
     }),
   ],

package/docs/ja/intlayer_with_tanstack.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2025-09-09
+updatedAt: 2025-12-11
 title: Tanstack Startアプリを翻訳する方法 – i18nガイド 2025
 description: Intlayerを使ってTanstack Startアプリケーションに国際化（i18n）を追加する方法を学びます。ロケール対応ルーティングで多言語対応アプリを作成するための包括的なガイドです。
 keywords:
@@ -19,9 +19,12 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-tanstack-start-template
 youtubeVideo: https://www.youtube.com/watch?v=_XTdKVWaeqg
 history:
+  - version: 7.4.0
+    date: 2025-12-11
+    changes: validatePrefix を導入し、ステップ14: ローカライズされたルートでの 404 ページ処理 を追加
   - version: 7.3.9
     date: 2025-12-05
-    changes: Add step 13: Retrieve the locale in your server actions (Optional)
+    changes: ステップ13: サーバーアクション内でロケールを取得する方法（オプション）を追加
   - version: 5.8.1
     date: 2025-09-09
     changes: Tanstack Start 用に追加
@@ -594,7 +597,123 @@ export const getLocaleServer = createServerFn().handler(async () => {
 
 ---
 
-### ステップ14: TypeScriptの設定（任意）
+### ステップ14: 見つからないページの管理（任意）
+
+ユーザーが存在しないページにアクセスした場合、カスタムの見つからないページを表示でき、ロケールプレフィックスが見つからないページのトリガー方法に影響を与える可能性があります。
+
+#### ロケールプレフィックスを使用したTanStack Routerの404処理を理解する
+
+TanStack Routerでは、ローカライズされたルートで404ページを処理するには、多層的なアプローチが必要です：
+
+1. **専用の404ルート**: 404 UIを表示するための特定のルート
+2. **ルートレベルの検証**: ロケールプレフィックスを検証し、無効なものを404にリダイレクト
+3. **キャッチオールルート**: ロケールセグメント内で一致しないすべてのパスをキャプチャ
+
+```tsx fileName="src/routes/{-$locale}/404.tsx"
+import { createFileRoute } from "@tanstack/react-router";
+
+// これは専用の /[locale]/404 ルートを作成します
+// 直接ルートとして使用されるか、他のファイルでコンポーネントとしてインポートされます
+export const Route = createFileRoute("/{-$locale}/404")({
+  component: NotFoundComponent,
+});
+
+// notFoundComponent および catch-all ルートで再利用できるように個別にエクスポートされます
+export function NotFoundComponent() {
+  return (
+    <div>
+      <h1>404</h1>
+    </div>
+  );
+}
+```
+
+```tsx fileName="src/routes/{-$locale}/route.tsx"
+import { createFileRoute, Outlet, redirect } from "@tanstack/react-router";
+import { validatePrefix } from "intlayer";
+import { IntlayerProvider, useLocale } from "react-intlayer";
+
+import { LocaleSwitcher } from "@/components/locale-switcher";
+import { NotFoundComponent } from "./404";
+
+export const Route = createFileRoute("/{-$locale}")({
+  // beforeLoadはルートがレンダリングされる前に実行されます（サーバーとクライアントの両方で）
+  // ロケールプレフィックスを検証するのに理想的な場所です
+  beforeLoad: ({ params }) => {
+    // ルートパラメータからロケールを取得（サーバーヘッダーからではない。beforeLoadはクライアントとサーバーの両方で実行されるため）
+    const localeParam = params.locale;
+
+    // validatePrefixは、ロケールがintlayer設定に従って有効かどうかをチェックします
+    // 戻り値: { isValid: boolean, localePrefix: string }
+    // - isValid: プレフィックスが設定されたロケールと一致する場合（またはプレフィックスがオプションの場合は空）はtrue
+    // - localePrefix: 検証されたプレフィックスまたはリダイレクト用のデフォルトのロケールプレフィックス
+    const { isValid, localePrefix } = validatePrefix(localeParam);
+
+    if (isValid) {
+      // ロケールが有効です。ルートが正常にレンダリングされるようにします
+      return;
+    }
+
+    // 無効なロケールプレフィックス（例: "xyz"が有効なロケールではない /xyz/about）
+    // 有効なロケールプレフィックスで404ページにリダイレクト
+    // これにより、404ページが適切にローカライズされたままになります
+    throw redirect({
+      to: "/{-$locale}/404",
+      params: { locale: localePrefix },
+    });
+  },
+  component: RouteComponent,
+  // notFoundComponentは子ルートが存在しないときに呼び出されます
+  // 例: /en/存在しないページが /en レイアウト内でこれをトリガーします
+  notFoundComponent: NotFoundLayout,
+});
+
+function RouteComponent() {
+  const { defaultLocale } = useLocale();
+  const { locale } = Route.useParams();
+
+  return (
+    // ロケールセグメント全体をIntlayerProviderでラップ
+    // ロケールパラメータがundefinedの場合、defaultLocaleにフォールバック（オプションプレフィックスモード）
+    <IntlayerProvider locale={locale ?? defaultLocale}>
+      <Outlet />
+    </IntlayerProvider>
+  );
+}
+
+// NotFoundLayoutは404コンポーネントをIntlayerProviderでラップします
+// これにより、404ページで翻訳が引き続き機能することが保証されます
+function NotFoundLayout() {
+  const { defaultLocale } = useLocale();
+  const { locale } = Route.useParams();
+
+  return (
+    <IntlayerProvider locale={locale ?? defaultLocale}>
+      <NotFoundComponent />
+      {/* ユーザーが404でも言語を変更できるようにLocaleSwitcherを含める */}
+      <LocaleSwitcher />
+    </IntlayerProvider>
+  );
+}
+```
+
+```tsx fileName="src/routes/{-$locale}/$.tsx"
+import { createFileRoute } from "@tanstack/react-router";
+
+import { NotFoundComponent } from "./404";
+
+// $ (splat/catch-all) ルートは、他のルートと一致しない任意のパスに一致します
+// 例: /en/いくつかの/深く/ネストされた/無効な/パス
+// これにより、ロケール内の一致しないすべてのパスが404ページを表示することが保証されます
+// これがないと、一致しない深いパスが空白ページやエラーを表示する可能性があります
+export const Route = createFileRoute("/{-$locale}/$")({
+  component: NotFoundComponent,
+});
+```
+
+---
+
+### ステップ15: TypeScriptの設定（任意）
 
 Intlayerはモジュール拡張を使用して、TypeScriptの利点を活かし、コードベースを強化します。
 

package/docs/ja/plugins/sync-json.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-03-13
-updatedAt: 2025-10-05
+updatedAt: 2025-12-13
 title: Sync JSON プラグイン
 description: Intlayerの辞書をサードパーティのi18n JSONファイル（i18next、next-intl、react-intl、vue-i18nなど）と同期します。既存のi18nを維持しながら、Intlayerでメッセージの管理、翻訳、テストを行えます。
 keywords:
@@ -24,12 +24,15 @@ slugs:
   - sync-json
 youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
 history:
+  - version: 7.5.0
+    date: 2025-12-13
+    changes: ICUおよびi18next形式のサポートを追加
   - version: 6.1.6
     date: 2025-10-05
     changes: Sync JSONプラグインの初期ドキュメント
 ---
 
-# Sync JSON（i18nブリッジ）
+# Sync JSON（i18nブリッジ）- ICU / i18nextサポート付きSync JSON
 
 <iframe title="IntlayerでJSON翻訳を同期状態に保つ方法" class="m-auto aspect-[16/9] w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/MpGMxniDHNg?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
@@ -105,9 +108,27 @@ syncJSON({
   source: ({ key, locale }) => string, // 必須
   location?: string, // オプションのラベル、デフォルト: "plugin"
   priority?: number, // コンフリクト解決のためのオプションの優先度、デフォルト: 0
+  format?: 'intlayer' | 'icu' | 'i18next', // オプションのフォーマッター、デフォルト: 'intlayer'
 });
 ```
 
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+JSONファイルを同期する際に辞書コンテンツに使用するフォーマッターを指定します。これにより、さまざまなi18nライブラリと互換性のある異なるメッセージフォーマット構文を使用できます。
+
+- `'intlayer'`: デフォルトのIntlayerフォーマッター（デフォルト）。
+- `'icu'`: ICUメッセージフォーマットを使用します（react-intl、vue-i18nなどのライブラリと互換性があります）。
+- `'i18next'`: i18nextメッセージフォーマットを使用します（i18next、next-i18next、Solid-i18nextと互換性があります）。
+
+**例：**
+
+```ts
+syncJSON({
+  source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+  format: "i18next", // 互換性のためにi18nextフォーマットを使用
+}),
+```
+
 ## 複数の JSON ソースと優先度
 
 複数の `syncJSON` プラグインを追加して異なる JSON ソースを同期することができます。これは、複数の i18n ライブラリや異なる JSON 構造をプロジェクトで使用している場合に便利です。
@@ -134,6 +155,7 @@ export default defineConfig({
   plugins: [
     // プライマリJSONソース（最も高い優先度）
     syncJSON({
+      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
       location: "main-translations",
       priority: 10,
@@ -141,6 +163,7 @@ export default defineConfig({
 
     // フォールバックJSONソース（低い優先度）
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `./fallback-locales/${locale}.json`,
       location: "fallback-translations",
       priority: 5,
@@ -148,6 +171,7 @@ export default defineConfig({
 
     // レガシーJSONソース（最も低い優先度）
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `/my/other/app/legacy/${locale}/messages.json`,
       location: "legacy-translations",
       priority: 1,
@@ -178,6 +202,7 @@ import { syncJSON } from "@intlayer/sync-json-plugin";
 export default {
   plugins: [
     syncJSON({
+      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
     }),
   ],

package/docs/ko/dictionary/content_file.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2025-09-20
+updatedAt: 2025-12-13
 title: 콘텐츠 파일
 description: 콘텐츠 선언 파일의 확장자를 사용자 정의하는 방법을 배우세요. 이 문서를 따라 프로젝트에서 조건을 효율적으로 구현하세요.
 keywords:
@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 7.5.0
+    date: 2025-12-13
+    changes: ICU 및 i18next 형식 지원 추가
   - version: 6.0.0
     date: 2025-09-20
     changes: 필드 문서 추가
@@ -386,6 +389,46 @@ content: { /* ... */ }
 }
 ```
 
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+사전 콘텐츠에 사용할 포맷터를 지정합니다. 이를 통해 다양한 메시지 포맷팅 구문을 사용할 수 있습니다.
+
+- `'intlayer'`: 기본 Intlayer 포맷터.
+- `'icu'`: ICU 메시지 포맷팅을 사용합니다.
+- `'i18next'`: i18next 메시지 포맷팅을 사용합니다.
+
+**예시:**
+
+```typescript
+{
+  key: "my-dictionary",
+  format: "icu",
+  content: {
+    message: "Hello {name}, you have {count, plural, one {# message} other {# messages}}"
+  }
+}
+```
+
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+사전 콘텐츠에 사용할 포맷터를 지정합니다. 이를 통해 다양한 메시지 포맷팅 구문을 사용할 수 있습니다.
+
+- `'intlayer'`: 기본 Intlayer 포맷터.
+- `'icu'`: ICU 메시지 포맷팅을 사용합니다.
+- `'i18next'`: i18next 메시지 포맷팅을 사용합니다.
+
+**예시:**
+
+```typescript
+{
+  key: "my-dictionary",
+  format: "icu",
+  content: {
+    message: "Hello {name}, you have {count, plural, one {# message} other {# messages}}"
+  }
+}
+```
+
 #### `locale` (LocalesValues)
 
 사전을 각 로케일별 사전으로 변환하며, content에 선언된 각 필드는 자동으로 번역 노드로 변환됩니다. 이 속성이 설정되면:

package/docs/ko/intlayer_with_astro.md

@@ -2,7 +2,7 @@
 createdAt: 2024-03-07
 updatedAt: 2025-10-03
 title: Astro 앱 번역하는 방법 – i18n 가이드 2025
-description: Intlayer를 사용하여 Vite 및 React 애플리케이션에 국제화(i18n)를 추가하는 방법을 배우세요. 이 가이드를 따라 앱을 다국어로 만드세요.
+description: Intlayer를 사용하여 Astro 웹사이트에 국제화(i18n)를 추가하는 방법을 배우세요. 이 가이드를 따라 사이트를 다국어로 만드세요.
 keywords:
   - 국제화
   - 문서

package/docs/ko/intlayer_with_express.md

@@ -2,7 +2,7 @@
 createdAt: 2024-08-11
 updatedAt: 2025-06-29
 title: Express backend 앱 번역하는 방법 – i18n 가이드 2025
-description: vite 백엔드를 다국어로 만드는 방법을 알아보세요. 국제화(i18n)하고 번역하려면 문서를 따르세요.
+description: Express 백엔드를 다국어로 만드는 방법을 알아보세요. 국제화(i18n)하고 번역하려면 문서를 따르세요.
 keywords:
   - 국제화
   - 문서

package/docs/ko/intlayer_with_nestjs.md

@@ -2,7 +2,7 @@
 createdAt: 2025-09-09
 updatedAt: 2025-09-09
 title: Nest backend 앱 번역하는 방법 – i18n 가이드 2025
-description: Vite 백엔드를 다국어로 만드는 방법을 알아보세요. 국제화(i18n) 및 번역을 위한 문서를 따라가세요.
+description: NestJS 백엔드를 다국어로 만드는 방법을 알아보세요. 국제화(i18n) 및 번역을 위한 문서를 따라가세요.
 keywords:
   - 국제화
   - 문서

package/docs/ko/intlayer_with_next-i18next.md

@@ -580,6 +580,7 @@ const config: IntlayerConfig = {
   },
   plugins: [
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `./locales/${locale}.json`,
     }),
   ],

package/docs/ko/intlayer_with_next-intl.md

@@ -419,6 +419,7 @@ const config: IntlayerConfig = {
   plugins: [
     // 네임스페이스별 폴더 구조를 Intlayer와 동기화 상태로 유지하세요
     syncJSON({
+      format: "icu",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
     }),
   ],