@intlayer/docs 9.0.0-canary.4 → 9.0.0-canary.5

package/docs/ja/compat/i18n-js.md

@@ -0,0 +1,44 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "i18n-jsからIntlayerへの移行"
+description: "compatアダプタを使用してアプリケーションをi18n-jsからIntlayerに移行する方法を学びます。"
+keywords:
+  - i18n-js
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - i18n-js
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# i18n-js から Intlayer への移行
+
+`i18n-js` ライブラリから Intlayer への移行は、大規模な翻訳設定を Intlayer の構造化されたファイル解決システムにオフロードするために設計された、高度に最適化された移行です。
+
+## やることリスト
+
+リポジトリで次のセットアップコマンドを実行してください：
+
+```bash
+npx intlayer init
+```
+
+`intlayer.config.ts`を準備したら、バンドラー設定にIntlayerのエイリアスを追加して、`i18n-js`のインポートが互換性パッケージ`@intlayer/i18n-js`を対象とするようにすることができます。
+
+## 内部的な動作
+
+`i18n-js` は `i18n.t('scope.key', {name})` のような式を通じてネームスペースにアクセスし、ロケールフォールバックと特定の複数形マッピングに対応しています。
+
+内部的には：
+
+- **補間:** compat アダプターは `%{name}` マッピングをターゲットとするランタイム辞書値に簡単に解析します。
+- **複数形:** `one/other` サブキーを置き換え、Intlayer の強力な基礎となる複数形メカニズム (`Intl.PluralRules`) に対してマップし、手動マッピングを抽象化します。
+- **ロケール:** ブートストラップ時にモノリシック言語ペイロードを読み込む代わりに、ネイティブ Intlayer 設定を通じて現在のコンテキスト設定に基づいて辞書が最適に提供されます。

package/docs/ja/compat/i18next.md

@@ -0,0 +1,59 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "i18nextからIntlayerへの移行"
+description: "compat adapterを使用して、Vanilla JS/TSアプリケーションをi18nextからIntlayerに移行する方法を学びます。"
+keywords:
+  - i18next
+  - vanilla
+  - javascript
+  - typescript
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# i18nextからIntlayerへの移行
+
+詳細なステップバイステップのチュートリアルについては、[i18next Migration Guide](../migration_from_i18next_to_intlayer.md)をご覧ください。
+
+Intlayerは`i18next`のコア実行時特性を完全に複製します。compatパッケージを利用することで、Vanillaアプリケーションまたは内部モジュールは引き続き馴染みのある構文を活用できます。
+
+## やることリスト
+
+まず、プロジェクトで Intlayer を初期化します：
+
+```bash
+npx intlayer init
+```
+
+Vite を使用している場合、Intlayer プラグインを含めて `@intlayer/i18next` へのインポートをルーティングしてください：
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { i18nextVitePlugin } from "@intlayer/i18next/plugin";
+
+export default defineConfig({
+  plugins: [i18nextVitePlugin()],
+});
+```
+
+## 内部動作
+
+`i18nextVitePlugin` は `i18next` インポートを `@intlayer/i18next` にエイリアスし、JSON ファイル含有によるバンドル肥大化を回避します。
+
+内部動作:
+
+- **インスタンス設定:** `createInstance` は名前空間フォールバックを正しく解析・適用し、Intlayer のコンパイルパイプラインを活用して辞書取得を行います。
+- **補間:** `{{name}}` 置換と `$t(key)` ネストの再帰的なネイティブサポート。
+- **コンテキスト & 複数形:** `key_male` や `key_one`/`key_other` のようなサフィックス形式を識別・解決し、標準 `Intl.PluralRules` に対して評価します。
+- **オブジェクト返却:** `returnObjects: true` モードは Intlayer 辞書からツリーを安全に抽出します。

package/docs/ja/compat/index.md

@@ -0,0 +1,51 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Intlayer Compat アダプター"
+description: "既存の i18n ソリューションを、compat アダプターを使用して、ゼロの摩擦で Intlayer に移行してください。"
+keywords:
+  - compat
+  - migration
+  - internationalization
+  - i18n
+  - Intlayer
+slugs:
+  - doc
+  - compatibility
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Intlayer Compat Adapters
+
+大規模なアプリケーションを新しい国際化ライブラリに移行することは困難な場合があります。この移行を容易にするため、Intlayer はエコシステムで最も人気のある i18n ライブラリ用の **compat adapters** を提供しています。
+
+これらのアダプターパッケージは、既存の i18n ライブラリと **まったく同じパブリック API** を公開していますが、すべての翻訳作業を実行時に Intlayer に委譲しています。
+
+## 仕組み
+
+compat アダプターを使用する場合、アプリケーションのインポートを書き直したり、翻訳フックとコンポーネントの使用方法を変更したりする必要はありません。代わりに、Intlayer のバンドラープラグインが既存のインポートを自動的に Intlayer compat パッケージにエイリアスします。
+
+例えば、開発者は `import { useTranslation } from 'react-i18next'` を `import { useTranslation } from '@intlayer/react-i18next'` に置き換えます (バンドラープラグインが自動的に行います)。すると、アプリケーションは Intlayer 辞書から提供される翻訳で動作し続けます。キーは Intlayer 辞書に対しても型付けされています！
+
+## 利用可能な互換性アダプター
+
+以下から既存のライブラリを選択して、シームレスに移行する方法を確認してください：
+
+- [Vue I18n](./vue-i18n.md)
+- [Transloco](./transloco.md)
+- [React Intl](./react-intl.md)
+- [Svelte I18n](./svelte-i18n.md)
+- [React i18next](./react-i18next.md)
+- [Polyglot.js](./polyglot.md)
+- [NuxtJS I18n](./nuxtjs-i18n.md)
+- [NGX Translate](./ngx-translate.md)
+- [Next Translate](./next-translate.md)
+- [Next Intl](./next-intl.md)
+- [Next i18next](./next-i18next.md)
+- [i18next](./i18next.md)
+- [Lingui](./lingui.md)
+- [I18n-js](./i18n-js.md)

package/docs/ja/compat/lingui.md

@@ -0,0 +1,44 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Linguiからintlayerへの移行"
+description: "compat adapterを使用してLinguiアプリケーションからIntlayerへ移行する方法を学びます。"
+keywords:
+  - lingui
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - lingui
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Linguiからの移行 Intlayer
+
+現在、プロジェクトがLinguiのマクロベースのコンパイルに依存している場合、Intlayerへの移行により、強力なマクロワークフローを維持しながら、Intlayerの JSON コンパイル戦略でネイティブにサポートすることができます。
+
+## 実施方法
+
+まず、プロジェクトで Intlayer を初期化します:
+
+```bash
+npx intlayer init
+```
+
+これにより `intlayer.config.ts` が作成されます。ビルドステップで `@lingui/babel-plugin-lingui-macro` / `@lingui/swc-plugin` を保持し、Intlayer compiler の _前に_ 実行されることを確認してください。その後、bundler plugin alias を使用して `@lingui/core` と `@lingui/react` を `@intlayer/lingui` にルーティングします。
+
+## 内部動作
+
+Linguiは、マクロ（`` t`Hello ${name}` ``および`<Trans>`など）を使用しており、これらは`i18n._(id, values)`のようなランタイム呼び出しにコンパイルされます。
+
+内部動作:
+
+- **マクロ:** これらは以前と同じようにコンパイルされ、ソース構文の中断がないことを保証します。
+- **ランタイム翻訳:** エイリアス化された`i18n._()`はIntlayerの辞書を使用します。明示的に名付けられたIDとハッシュ化されたIDの両方が、Intlayerの`.po`同期プラグインを使用して完全にマップされ、キーを安全に集約およびプルーニングします。
+- **ICU機能:** 複数形化、選択、およびICUバリアントのサポートは、Intlayerの統一されたICUパーサーにより堅牢であり、同じレンダリング出力を保証します。

package/docs/ja/compat/next-i18next.md

@@ -0,0 +1,57 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "next-i18nextからIntlayerへの移行"
+description: "compat アダプターを使用して、Next.js アプリケーションを next-i18next から Intlayer に移行する方法を学びます。"
+keywords:
+  - next-i18next
+  - nextjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# next-i18nextからIntlayerへの移行
+
+完全で詳細なステップバイステップのチュートリアルについては、[next-i18next移行ガイド](../migration_from_next-i18next_to_intlayer.md)をご参照ください。
+
+Intlayerは、Next.js Pages RouterとApp Routerのすべての実装を透過的に処理します。アダプターを使用することで、`next-i18next`の実装をコードの書き換えなしで移行できます。
+
+## 実行する内容
+
+開始するには、以下を実行してください:
+
+```bash
+npx intlayer init
+```
+
+これにより、必要な Intlayer セットアップファイルが作成されます。バックグラウンドで Intlayer を使用するように切り替えるには、`next.config.ts` を更新してください:
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+
+const withIntlayer = createNextI18nPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## 仕組みの詳細
+
+`createNextI18nPlugin` は Next.js のネイティブな動作と core `next-intlayer` プラグインを合成し、`next-i18next`、`react-i18next`、`i18next` に必要なすべての Webpack/Turbopack エイリアスをインジェクトします。
+
+仕組みの詳細：
+
+- **`serverSideTranslations` & `appWithTranslation`:** これらは Intlayer の内部ローダーのラッパーとして機能し、大規模な静的 JSON インジェクションを回避します。
+- **Client hooks:** `@intlayer/react-i18next` に直接委譲され、すべてのフォーマット、複数形、およびネストされた namespace 機能を保持します。

package/docs/ja/compat/next-intl.md

@@ -0,0 +1,59 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "next-intl から Intlayer への移行"
+description: "compat アダプタを使用して、Next.js アプリケーションを next-intl から Intlayer に移行する方法を学びます。"
+keywords:
+  - next-intl
+  - nextjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# next-intl から Intlayer への移行
+
+完全で詳細なステップバイステップチュートリアルについては、[next-intl 移行ガイド](../migration_from_next-intl_to_intlayer.md)を参照してください。
+
+`next-intl` から Intlayer への移行により、アプリケーションのルーティングとシンタックスを完全に変更せずに維持できます。
+
+## やること
+
+リポジトリで次のコマンドを実行します:
+
+```bash
+npx intlayer init
+```
+
+これにより `intlayer.config.ts` が作成されます。`next.config.ts` で、プラグインラッパーを使用して `next-intl` のエイリアスを `@intlayer/next-intl` にシームレスに注入します。
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextIntlPlugin } from "@intlayer/next-intl/plugin";
+
+const withIntlayer = createNextIntlPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## 内部的な動作
+
+bundlerラッパーは翻訳を置き換えますが、**`next-intl/navigation`の機能は損なわれません**（例：`Link`、`redirect`、`usePathname`）。
+
+内部的には：
+
+- **ICU runtime:** 複数形（`=0`、`one`、`other`）、select/selectordinal、`#`引数、フォーマット済み引数（`{ts, date, long}`）は、共有の`resolveMessage(..., 'icu')`リゾルバーを使用して正しく実行されます。
+- **`useTranslations()` & `getTranslations()`:** ベアスコープの呼び出しは、最初のキーセグメントを正しい辞書識別子として抽出します。ネストされた名前空間は、辞書パスとプレフィックスに適切に分割されます。
+- **Rich formatting:** `t.rich()`と`t.markup()`の両方が完全にネイティブに実装され、HTML風のノードをレンダリングされたReactチャンクに変換します。
+- **`useFormatter`:** `relativeTime`、`list`、`dateTimeRange`、および設定からの名前付きフォーマットが、コアのネイティブな`Intl`フォーマッターにブリッジされます。

package/docs/ja/compat/next-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Next Translateから Intlayerへの移行"
+description: "compat adapterを使用して、Next.jsアプリケーションをnext-translateからIntlayerに移行する方法を学びます。"
+keywords:
+  - next-translate
+  - nextjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Next Translateから Intlayerへの移行
+
+`next-translate` から Intlayer への移行は、既存の構文とタグを保持するほぼドロップイン置換です。
+
+## やること
+
+プロジェクトで Intlayer を初期化します:
+
+```bash
+npx intlayer init
+```
+
+CLI があなたの設定をスキャフォルドします。その後、`next.config.ts` で Intlayer プラグインを適用でき、ビルド時に `next-translate/useTranslation` を `@intlayer/next-translate` にマッピングするサブパスエイリアスを注入します。
+
+## 内部的な動作
+
+`next-translate` は `useTranslation('ns')`、`t('ns:key.path')`、および `<Trans>` コンポーネントなどのフックを提供します。
+
+内部的には：
+
+- **補間とプルーラル:** `react-i18next` アダプターの動作に密接に依存しています。`{{var}}` プレースホルダーと `key_0`、`key_one`、`key_other` などのサフィックスからマップされたプルーラル化が動的に処理されます。
+- **`<Trans>` コンポーネント:** HTML風のタグ解析が、配列ベースの `components` プロップと共に直接サポートされています。
+- **Namespaces:** サブパスエイリアシングにより、`useTranslation` が手動修正なしに正しい内部辞書 namespace を参照することを保証します。

package/docs/ja/compat/ngx-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "NGX-Translateからのへの移行"
+description: "compat adapterを使用してあなたのAngularアプリケーションをngx-translateからIntlayerに移行する方法を学びます。"
+keywords:
+  - ngx-translate
+  - angular
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - ngx-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# NGX-Translate から Intlayer への移行
+
+`ngx-translate` から Intlayer への Angular アプリケーションの移行は、compat adapter を使用することで簡単です。すべてのテンプレートを書き直す必要がありません。
+
+## やることリスト
+
+以下のコマンドを実行します:
+
+```bash
+npx intlayer init
+```
+
+これにより `intlayer.config.ts` がセットアップされます。`TranslateModule.forRoot()` のセットアップとインポートエイリアスを置き換えて、`@intlayer/ngx-translate` を適切にポイントするようにしてください。
+
+## 内部的な動作
+
+`ngx-translate` は `TranslateService` (`instant`、`get`、`stream`) を `{{ 'KEY' | translate:params }}` パイプと `[translate]` ディレクティブと共に使用します。
+
+内部的には:
+
+- **Services:** `TranslateService` は `getIntlayer` とロケール observable をラップし、完全に同じメソッドを提供します。
+- **Pipes & Directives:** Intlayer ディクショナリに対して直接解決するように再実装されています。
+- **Loaders:** `TranslateHttpLoader` のセットアップは warning stubs に変換されます。Intlayer は本質的にビルド時（またはスタンダード dynamic imports を通じて）ディクショナリを解決およびバンドルするため、HTTP loaders の必要性を完全に排除します。

package/docs/ja/compat/nuxtjs-i18n.md

@@ -0,0 +1,46 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "NuxtJS I18n から Intlayer への移行"
+description: "compat アダプターを使用して、Nuxt.js アプリケーションを @nuxtjs/i18n から Intlayer に移行する方法を学びます。"
+keywords:
+  - nuxtjs-i18n
+  - nuxt
+  - vue
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - nuxtjs-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# NuxtJS I18n から Intlayer への移行
+
+Nuxt アプリケーションを `@nuxtjs/i18n` から Intlayer に移行することは、Nuxt アダプターモジュールを使用したシームレスなプロセスです。
+
+## やるべきこと
+
+プロジェクトを初期化するには、以下を実行します:
+
+```bash
+npx intlayer init
+```
+
+これにより `intlayer.config.ts` がセットアップされます。その後、Intlayer Nuxt モジュール (例: `@intlayer/nuxt-i18n`) を `nuxt.config.ts` の modules 配列に追加します。これはアプリケーションの compat 設定を自動的に適用します。
+
+## 内部的な動作
+
+`@nuxtjs/i18n` は `vue-i18n` をラップしながら、Nuxt固有のルーティングコンポーザブル (`useLocalePath`、`useSwitchLocalePath`、`<NuxtLinkLocale>`) を提供します。
+
+内部的には:
+
+- **翻訳:** すべての文字列翻訳タスクのために `@intlayer/vue-i18n` compat レイヤーにネイティブに依存しています (`vue-i18n` フォーマット、pipe複数形、およびリアクティビティを完全にサポート)。
+- **ルーティング:** IntlayerのローカライズされたURL ヘルパーを使用してルーティングコンポーザブルをミラーリングします。
+- **設定:** `intlayer.config.ts` から直接 `availableLocales` とデフォルト設定を読み込み、Nuxtページを自動的に調整します。

package/docs/ja/compat/polyglot.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Polyglot.jsからIntlayerへの移行"
+description: "compat adapterを使用してPolyglot.jsからIntlayerに移行する方法を学びます。"
+keywords:
+  - polyglot
+  - airbnb
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - polyglot
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Polyglot.js から Intlayer への移行
+
+Airbnb の Polyglot.js を使用している場合、compat layer を使用すると Intlayer への移行は非常に簡単です。
+
+## 実施内容
+
+プロジェクトで初期化コマンドを実行するだけです:
+
+```bash
+npx intlayer init
+```
+
+これにより `intlayer.config.ts` が生成されます。その後、bundler プラグインエイリアスを使用して、Polyglot のインポートを `@intlayer/polyglot` に透過的にリダイレクトできます。
+
+## 内部的な動作
+
+Polyglot.js の構文は通常、`polyglot.t('key', {name})` と `%{name}` インターポレーション、および `"singular |||| plural"` で区切られた `smart_count` 複数形に依存します。
+
+内部的には:
+
+- **インターポレーション:** 互換性レイヤーはネイティブに `%{var}` プレースホルダーを処理します。
+- **複数形:** 文字列は `||||` で分割され、アクティブなロケールに従って native `Intl.PluralRules` に対して評価され、ロケールごとに Polyglot 独自のバケット順序をミラーリングします。
+- **辞書:** `new Polyglot()` に巨大な JSON 設定を提供する必要がなくなります。Intlayer は辞書を動的に処理し、自動的にプルーニングします。

package/docs/ja/compat/react-i18next.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "react-i18nextからIntlayerへの移行"
+description: "compatアダプターを使用して、ReactアプリケーションをReact-i18nextからIntlayerに移行する方法を学びます。"
+keywords:
+  - react-i18next
+  - i18next
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# react-i18next から Intlayer への移行
+
+完全で詳細なステップバイステップチュートリアルについては、[react-i18next 移行ガイド](../migration_from_react-i18next_to_intlayer.md)をご覧ください。
+
+Intlayer の compat adapter を使用することで、ソースコードのインポート変更なしに `react-i18next` から移行できます。
+
+## 何をするか
+
+プロジェクトを初期化するには、次を実行します：
+
+```bash
+npx intlayer init
+```
+
+初期化中に、Intlayer は `@intlayer/react-i18next` をインストールし、`intlayer.config.ts` を作成します。バンドラー（Vite など）で、Intlayer プラグインを適用します：
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import { reactI18nextVitePlugin } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactI18nextVitePlugin()],
+});
+```
+
+## 内部的な動作
+
+`reactI18nextVitePlugin` は、コアの `vite-intlayer` プラグインをラップし、`react-i18next` と `i18next` のリゾルブエイリアスを注入して、`@intlayer/react-i18next` と `@intlayer/i18next` にリダイレクトします。
+
+内部的には:
+
+- **`useTranslation` & `withTranslation`:** Intlayer のネイティブフックを使用するように書き直されており、辞書キーの自動 TypeScript 補完を提供します。namespaces をシームレスにサポートしています (例: `t('namespace:key')`)。
+- **Plurals & Context:** i18next のサフィックスベースの複数形処理 (`key_one`、`key_other`) をネイティブ `Intl.PluralRules` とコンテキストサフィックス (`key_male`) を使用して処理します。
+- **`<Trans>` Component:** `components` プロップ、object と array の形式、および番号付きタグ `<1>...</1>` をサポートするように再実装され、React ノードに直接マップされます。
+- **`i18n` instance:** 大規模な JSON ファイルを取得せずに Intlayer からキーを直接リゾルブするため、バンドルサイズが大幅に削減されます。

package/docs/ja/compat/react-intl.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "React Intl から Intlayer への移行"
+description: "compat アダプターを使用して、React アプリケーションを react-intl から Intlayer に移行する方法を学びます。"
+keywords:
+  - react-intl
+  - formatjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# React IntlからIntlayerへの移行
+
+React アプリケーションが `react-intl` (FormatJS) を使用している場合、Intlayer への移行は簡単です。互換性レイヤーは ICU MessageFormat と既存のすべての `Formatted*` コンポーネントをシームレスに処理します。
+
+## やること
+
+まずプロジェクトで初期化コマンドを実行します：
+
+```bash
+npx intlayer init
+```
+
+次に、設定で Intlayer Vite または Next.js プラグインをセットアップします。このプラグインは、`react-intl` のインポートを `@intlayer/react-intl` にリダイレクトするためのビルド時エイリアスを注入します。
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import reactIntlVitePlugin from "@intlayer/react-intl/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactIntlVitePlugin()],
+});
+```
+
+## 内部的な動作
+
+bundler プラグインは `react-intl` を `@intlayer/react-intl` にエイリアスします。大きな JSON ファイルを手動でパースして `IntlProvider` でアプリをラップする代わりに、Intlayer プラグインは静的にキーを抽出し、実行時に Intlayer ディクショナリを使用します。
+
+内部的には以下のように動作します:
+
+- **ICU MessageFormat:** Intlayer は `resolveMessage(..., 'icu')` リゾルバを使用しており、ICU の複数形化、選択、日付/数値フォーマット、リッチテキストタグをネイティブに完全にサポートしています。
+- **Method & JSX callers:** `intl.formatMessage({ id: 'a.b' })` と `<FormattedMessage id="a.b">` は Intlayer コンパイラプラグイン (`@intlayer/babel` / `@intlayer/swc`) によって識別され、フラットなドット記号キーを変換して最初のセグメントが Intlayer ディクショナリキーに正しく解決されるようにします。
+- **Formatters:** `<FormattedNumber>`、`<FormattedDate>` など、ネイティブな `core/formatters` を `Intl` を使用してブリッジします。

package/docs/ja/compat/svelte-i18n.md

@@ -0,0 +1,47 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Svelte I18nからIntlayerへの移行"
+description: "compat アダプターを使用して、Svelte アプリケーションを svelte-i18n から Intlayer に移行する方法を学びます。"
+keywords:
+  - svelte-i18n
+  - svelte
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - svelte-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Svelte I18n から Intlayer への移行
+
+`svelte-i18n` から Intlayer への Svelte アプリケーションの移行は、compat adapter を使用することで、わずかな時間で完了します。
+
+## やることリスト
+
+プロジェクトで初期化コマンドを実行するだけです:
+
+```bash
+npx intlayer init
+```
+
+これにより `intlayer.config.ts` が生成されます。SvelteKit / Vite プラグインが Intlayer のエイリアスプラグインでラップされていることを確認して、`svelte-i18n` を `@intlayer/svelte-i18n` にシームレスにマップします。
+
+## 内部動作
+
+Svelte-i18n は頻繁に使用される store（`$_`、`$t`、`$format` など）と ICU MessageFormat に依存しています。
+
+内部動作：
+
+- **Stores:** Intlayer は `svelte-i18n` store をプロキシします。`$_` は現在のロケールの派生 store になり、Intlayer resolver を返します。
+- **Keys:** フラットキー（例：`$_('home.title')`）が評価され、最初のパスセグメントが Intlayer dictionary を表します。
+- **ICU Syntax:** 共有 ICU resolver（`intl-messageformat` と同等のパース）によって完全に処理されます。
+- **Formatters:** `$date`、`$time`、`$number` の呼び出しは Intlayer のネイティブコアフォーマッターに安全にリダイレクトされます。
+- **Babel/SWC Analysis:** Intlayer analyzer は コンパイル前に `.svelte` ソースファイル内の Svelte store 呼び出し（`$_`）を読み取り、関連する dictionary chunks を自動的にビルドします。