@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.10

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 を自動的にビルドします。

package/docs/ja/compat/transloco.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "TranslocoからIntlayerへの移行"
+description: "compatアダプターを使用してAngularアプリケーションをTranslocoからIntlayerに移行する方法を学びます。"
+keywords:
+  - transloco
+  - angular
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - transloco
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Transloco から Intlayer への移行
+
+Angular アプリケーションが現在 `@jsverse/transloco` を使用している場合、当社の compat アダプタを使用して Intlayer に移行できます。この移行により、既存のテンプレート構文を維持しながら、Intlayer の強力な辞書構造を活用できます。
+
+## やること
+
+プロジェクトで初期化コマンドを実行するだけです：
+
+```bash
+npx intlayer init
+```
+
+これにより、必要な `intlayer.config.ts` 設定が生成されます。その後、Transloco のインポートを `@intlayer/transloco` モジュールに置き換えるか、ビルド aliases に依存します。
+
+## 内部動作
+
+Translocoは、スコープと`TranslocoService`（`translate`、`selectTranslate`）を、構造的ディレクティブ（`*transloco="let t"`）とパイプ（`| transloco`）とともに使用します。
+
+内部動作：
+
+- **スコープ：** Intlayerの辞書キーに自然にマップされ、バンドルの最適化のための優れたプルーニング機能を提供します。
+- **サービスとディレクティブ：** Intlayerの角度アダプターはプロバイダーをシームレスに置き換え、既存のテンプレートパイプとディレクティブがIntlayer辞書に対して文字列を解決できるようにします。
+- **ビルド時パース：** TypeScriptアナライザーは`instant/get`呼び出しを認識し、フォールバックプルーニングはテンプレートの使用が静的に追跡可能でない場合でも正確性を保証します。

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

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Vue I18nからIntlayerへの移行"
+description: "compatアダプタを使用してVueアプリケーションをvue-i18nからIntlayerに移行する方法を学びます。"
+keywords:
+  - vue-i18n
+  - vue
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - vue-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Vue I18n から Intlayer への移行
+
+Vue アプリケーションが現在 `vue-i18n` を使用している場合、コンポーネントを書き直したり、フックを翻訳したりすることなく、Intlayer に移行できます。Intlayer は `vue-i18n` の API を完全に反映する互換性アダプターを提供しながら、Intlayer の強力な機能を内部で活用しています。
+
+## 実施すべきこと
+
+まず、プロジェクトで初期化コマンドを実行してください：
+
+```bash
+npx intlayer init
+```
+
+初期化中、Intlayer は設定ファイル（`intlayer.config.ts`）をセットアップし、プロジェクトをマイグレーション用に準備します。Vite 設定に Intlayer プラグインを追加するだけで、`vue-i18n` インポートを自動的にエイリアスできます。
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vue(), vueI18nVitePlugin()],
+});
+```
+
+## 内部的な動作
+
+`vueI18nVitePlugin` はバンドラーにモジュールエイリアスを注入します。コードベース内の `vue-i18n` のあらゆるインポートは、透過的に `@intlayer/vue-i18n` にリダイレクトされます。
+
+**内部的には、アダプターは複雑な `vue-i18n` 構文をネイティブに処理します：**
+
+- **補間とプルーラル：** `{name}` とリスト `{0}` の補間を解決します。パイププルーラル（`"car | cars"`）は位置セマンティクスに基づいて Intlayer の列挙型/プルーラルノードに変換されます。
+- **フォーマット：** `d()` や `n()` などの関数は内部的に `Intl` をラップし、オプションで定義された `datetimeFormats` と `numberFormats` を尊重します。
+- **グローバルおよびローカルの状態：** `global.locale` は Intlayer クライアントによって支援される `WritableComputedRef` にマップされるため、リアクティビティはまさに期待通りに機能します（例：`locale.value = 'fr'`）。
+- **ディレクティブ：** `v-t` ディレクティブが登録され、正常に機能します。
+
+アプリケーションは以前と全く同じようにレンダリングされ続けますが、コンテンツは Intlayer ディクショナリによって駆動されるため、型安全性、より優れたバンドル最適化、シームレスな CMS 統合を得られます。

package/docs/ja/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-03-12
+updatedAt: 2026-06-23
 title: Intlayer コンパイラー | i18n のための自動コンテンツ抽出
 description: Intlayer コンパイラーで国際化プロセスを自動化しましょう。コンポーネントから直接コンテンツを抽出し、Vite、Next.js などでより高速かつ効率的な i18n を実現します。
 keywords:
@@ -60,6 +60,8 @@ author: aymericzip
 
 ## 使い方
 
+> The quickest way to wire the compiler in is the interactive setup: run `npx intlayer init --interactive` and select **Compiler**. On Vite there is nothing to configure — the compiler is plugged in directly through the `intlayerCompiler()` plugin. On Next.js the command scaffolds the `babel.config.js` shown below. The non-interactive `intlayer init` leaves the compiler setup untouched.
+
 <Tabs>
  <Tab value='vite'>
 
@@ -79,12 +81,15 @@ npm install vite-intlayer
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // コンパイラープラグインを追加
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```