@intlayer/docs 9.4.0-canary.0 → 9.4.0

package/docs/ja/packages/elysia-intlayer/intlayer.md

@@ -0,0 +1,139 @@
+---
+createdAt: 2026-08-24
+updatedAt: 2026-08-24
+title: intlayer Elysia プラグインドキュメント | elysia-intlayer
+description: elysia-intlayer パッケージの intlayer プラグインの使い方を確認します
+keywords:
+  - intlayer
+  - elysia
+  - plugin
+  - Intlayer
+  - 国際化
+  - ドキュメント
+slugs:
+  - doc
+  - packages
+  - elysia-intlayer
+  - intlayer
+history:
+  - version: 9.4.0
+    date: 2026-08-24
+    changes: "ドキュメントの初期化"
+author: aymericzip
+---
+
+# intlayer Elysia プラグインドキュメント
+
+Elysia 用の `intlayer` プラグインは、ユーザーのロケールを検出し、ルートコンテキストに `intlayer` オブジェクトを注入します。また、リクエストコンテキスト内でグローバルな翻訳関数を使用できるようにします。
+
+## 使用方法
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { intlayer } from "elysia-intlayer";
+
+const app = new Elysia().use(intlayer()).get("/", ({ intlayer }) =>
+  intlayer!.t({
+    ja: "こんにちは",
+    en: "Hello",
+    fr: "Bonjour",
+    es: "Hola",
+  })
+);
+```
+
+> プラグインは **グローバル** な `derive` を通じてコンテキストを登録し、Elysia はそれを `Partial<{ intlayer: IntlayerContext }>` として型付けします。`.use(intlayer())` の後に登録されたルートでは実行時に値が必ず存在するため、`strict` モードの TypeScript を満たすには非 null アサーション（`intlayer!.t`）またはオプショナルチェーンを使用してください。
+
+同じヘルパーはスタンドアロンのエクスポートとしても利用できるため、ルートコンテキストを分割代入せずに呼び出せます:
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { intlayer, t } from "elysia-intlayer";
+
+const app = new Elysia().use(intlayer()).get("/", () =>
+  t({
+    ja: "こんにちは",
+    en: "Hello",
+    fr: "Bonjour",
+    es: "Hola",
+  })
+);
+```
+
+## 説明
+
+プラグインは次のタスクを実行します:
+
+1. **ロケール検出**: クライアントが明示的に設定したロケールをストレージ（クッキー、ヘッダー）から読み取り、その後 `Accept-Language` ヘッダーからネゴシエートされたロケールにフォールバックします。
+2. **コンテキストへの注入**: Elysia のルートコンテキストに `intlayer` プロパティを追加します（下記の「ルートコンテキスト」表を参照）。
+3. **コンテキスト管理**: 非同期コンテキストを管理するために `AsyncLocalStorage` を使用し、グローバルな Intlayer 関数（`t`、`getIntlayer`、`getDictionary`）がコンテキストオブジェクトを渡さずにリクエスト固有のロケールにアクセスできるようにします。
+4. **辞書の準備**: プラグインの生成時に `prepareIntlayer` を呼び出すため、アプリの起動時に辞書がビルドされます。
+
+### ルートコンテキスト
+
+| プロパティ        | 型                     | 説明                                                                                       |
+| ----------------- | ---------------------- | ------------------------------------------------------------------------------------------ |
+| `locale`          | `Locale`               | このリクエストで使用するロケール。`locale_storage` が `locale_detected` より優先されます。 |
+| `locale_storage`  | `Locale` (任意)        | クッキーまたはヘッダーを通じてクライアントが明示的に要求したロケール。                     |
+| `locale_detected` | `Locale`               | リクエストヘッダーからネゴシエートされたロケール。                                         |
+| `defaultLocale`   | `Locale`               | `intlayer.config.ts` でフォールバックとして設定されたロケール。                            |
+| `t`               | `TranslateFunction`    | 翻訳関数。                                                                                 |
+| `getIntlayer`     | `typeof getIntlayer`   | キーで辞書を取得する関数。                                                                 |
+| `getDictionary`   | `typeof getDictionary` | 辞書オブジェクトを処理する関数。                                                           |
+
+> Node ベースの Intlayer プラグインとは異なり、`elysia-intlayer` は `cls-hooked` ではなく `AsyncLocalStorage` に依存します。`cls-hooked` は Bun が実装していない `async_hooks.createHook` に依存しているためです。
+
+リクエストコンテキストはレスポンスがマップされた時点で解放されるため、スタンドアロンのヘルパーが既に終了したリクエストに対して解決されることはありません。プラグインが処理するリクエストの外部で呼び出された場合は、設定されたデフォルトロケールにフォールバックします。
+
+## ロケールの解決順序
+
+デフォルトでは、プラグインは次の順序でロケールを解決します:
+
+1. `INTLAYER_LOCALE` クッキー。
+2. `x-intlayer-locale` ヘッダー。
+3. `Accept-Language` ヘッダーのネゴシエーション。
+4. 設定された `defaultLocale`。
+
+```bash
+# `Accept-Language` からネゴシエーション
+curl -H "Accept-Language: fr" http://localhost:3000/
+# Bonjour
+
+# クッキーは `Accept-Language` より優先されます
+curl -H "Accept-Language: fr" -H "Cookie: INTLAYER_LOCALE=es" http://localhost:3000/
+# Hola
+
+# ヘッダーは `Accept-Language` より優先されます
+curl -H "Accept-Language: fr" -H "x-intlayer-locale: es" http://localhost:3000/
+# Hola
+```
+
+## 設定
+
+プラグインは `intlayer.config.ts` ファイルを読み取ります。ロケール検出に使用するクッキーとヘッダーをカスタマイズできます:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
+  },
+};
+
+export default config;
+```
+
+> 設定に関する詳細は、[設定ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)をご覧ください。
+
+## 関連ドキュメント
+
+- [elysia-intlayer パッケージドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/elysia-intlayer/exports.md)
+- [Elysia i18n - アプリを翻訳するための完全ガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_with_elysia.md)

package/docs/ja/packages/intlayer/getDictionary.md

@@ -0,0 +1,155 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: getDictionary 関数ドキュメント | intlayer
+description: intlayer パッケージの getDictionary 関数の使用方法を参照してください
+keywords:
+  - getDictionary
+  - dictionary
+  - interpreter
+  - content
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getDictionary
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "初期ドキュメント"
+author: aymericzip
+---
+
+# ドキュメント: `intlayer` の `getDictionary` 関数
+
+## Description
+
+`getDictionary` 関数は、**自分で渡す辞書オブジェクト**を解釈し、指定されたロケールの解決されたコンテンツを返します。コンテンツを1回のパスで走査し、必要に応じて各インタープリタープラグインを適用し、`t()` 翻訳、列挙、条件、挿入、ネスト、markdown、HTML、ファイルノードを解決します。
+
+生成されたレジストリでキーによって辞書を検索する [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getIntlayer.md) とは異なり、`getDictionary` は辞書自体を受け取ります。これにより、実行時に構築されたコンテンツ、API または CMS から取得されたコンテンツ、またはテストでインラインで宣言されたコンテンツの適切なツールになります。
+
+**主な機能:**
+
+- 辞書構造 (`{ key, content }`) に従う任意のオブジェクトで動作
+- セレクターと共に修飾辞書グループ (コレクション、バリアント) も受け入れ
+- 完全に型付け: 返されたオブジェクトは渡した `content` を反映
+- カスタムインタープリタープラグインを受け入れ
+
+---
+
+## 関数署名
+
+```typescript
+getDictionary(
+  dictionary: Dictionary | QualifiedDictionaryGroup, // 必須
+  localeOrSelector?: LocalesValues | DictionarySelector, // オプション
+  plugins?: Plugins[]                                // オプション
+): DeepTransformContent<...>
+```
+
+---
+
+## パラメータ
+
+- `dictionary: Dictionary | QualifiedDictionaryGroup`
+  - **説明**: 解釈する辞書（または qualified dictionary group）。
+  - **型**: `Dictionary | QualifiedDictionaryGroup`
+  - **必須**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **説明**: コンテンツを解釈するロケール、またはセレクターオブジェクト（`{ item }`、`{ variant }`、オプションで `locale`）。[動的辞書](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/index.md)を参照してください。
+  - **型**: `LocalesValues | DictionarySelector`
+  - **必須**: No (Optional) — 設定された `defaultLocale` にデフォルト設定されます。
+
+- `plugins: Plugins[]`
+  - **説明**: 認識されたノードがどのように解釈されるかを定義するノード変換器の配列。省略された場合は、デフォルトのインタープリタープラグインセットが使用されます。
+  - **型**: `Plugins[]`
+  - **必須**: No (Optional)
+
+### Returns
+
+- **Type**: 辞書の解釈されたコンテンツ。
+- **Description**: 渡した `content` に対して、リクエストされたロケール用に全ての Intlayer ノードが解決されたもの。`item` セレクタのないコレクショングループの場合、解釈されたエントリの順序付き配列が返されます。セレクタが何もターゲットしない場合は `null` が返されます。
+
+---
+
+## 使用例
+
+### 基本的な使い方
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getDictionary, t } from "intlayer";
+
+const content = getDictionary(
+  {
+    key: "my_key",
+    content: {
+      greeting: t({
+        ja: "こんにちは",
+        en: "Hello",
+        fr: "Bonjour",
+      }),
+    },
+  },
+  "ja"
+);
+
+console.log(content.greeting); // "こんにちは"
+```
+
+### 実行時に取得したコンテンツの解釈
+
+```typescript
+import { getDictionary, type Dictionary } from "intlayer";
+
+const remoteDictionary: Dictionary = await fetch("/api/cms/banner").then(
+  (res) => res.json()
+);
+
+const banner = getDictionary(remoteDictionary, "fr");
+```
+
+### セレクタを使用する
+
+```typescript
+import { getDictionary } from "intlayer";
+
+// 修飾されたdictionary groupは単一のentryに解決されます…
+const secondItem = getDictionary(blogPostGroup, { item: 2, locale: "fr" });
+
+// …または`item`が指定されない場合は順序付きarrayに解決されます
+const allItems = getDictionary(blogPostGroup, { locale: "fr" });
+```
+
+---
+
+## 関連する関数
+
+- [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getIntlayer.md): 同じ解釈ですが、生成されたレジストリ内でキーで辞書を検索します。
+- [`getDictionaryAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getDictionaryAsync.md): ロケール別ローダーマップの対応物。
+- [`useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/react-intlayer/useDictionary.md): React フックの同等物で、プロバイダーからロケールを読み取ります。
+
+---
+
+## TypeScript
+
+```typescript
+function getDictionary<
+  const T extends Dictionary | QualifiedDictionaryGroup,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  dictionary: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): DeepTransformContent<
+  ResolveQualifiedDictionaryContent<T, A>,
+  IInterpreterPluginState,
+  ExtractSelectorLocale<A>
+>;
+```

package/docs/ja/packages/intlayer/getDictionaryAsync.md

@@ -0,0 +1,166 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: getDictionaryAsync 関数ドキュメント | intlayer
+description: intlayer パッケージの getDictionaryAsync 関数の使用方法を確認してください
+keywords:
+  - getDictionaryAsync
+  - dictionary
+  - dynamic dictionaries
+  - loader map
+  - bundle optimization
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getDictionaryAsync
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "初期ドキュメント"
+author: aymericzip
+---
+
+# Documentation: `getDictionaryAsync` Function in `intlayer`
+
+## Description
+
+`getDictionaryAsync` 関数は、辞書の**単一ロケールチャンク**を読み込み、その解釈されたコンテンツを返します。
+
+これは `.intlayer/dynamic_dictionaries/` で生成されるロケール単位のローダーマップに対する [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getDictionary.md) の対応物です。すべてのロケールを保持する辞書を受け取る代わりに、ローダーマップを受け取り、要求されたロケールが必要とするチャンクだけを待ちます。
+
+> アプリケーションコードでは通常、この関数ではなく [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getIntlayerAsync.md) を呼び出します。[ビルドプラグイン](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/bundle_optimization.md) は、すべての `getIntlayerAsync('key', locale)` 呼び出しを `getDictionaryAsync(loaderMap, 'key', locale)` の呼び出しに書き換えます。`getDictionaryAsync` はカスタムローダーと独自のローダーマップを構築するツールのためにエクスポートされています。
+
+**主な機能:**
+
+- 要求されたロケールチャンクのみを読み込みます
+- プレーン (`locale → loader`) と修飾済み (`locale → qualifierId → loader`) ローダーマップをサポートしています
+- 同じチャンクの同時読み込みを重複排除し、解決されたコンテンツをキャッシュします
+- 失敗した読み込みはキャッシュから削除されるため、後の呼び出しがチャンクを再試行します
+
+---
+
+## 関数シグネチャ
+
+```typescript
+getDictionaryAsync(
+  dictionaryLoaders: PlainDynamicLoaderMap | QualifiedDynamicLoaderMap, // 必須
+  key: string,                                           // 必須
+  localeOrSelector?: LocalesValues | DictionarySelector, // オプション
+  plugins?: Plugins[]                                    // オプション
+): Promise<DeepTransformContent<...>>
+```
+
+---
+
+## パラメータ
+
+- `dictionaryLoaders: PlainDynamicLoaderMap | QualifiedDynamicLoaderMap`
+  - **説明**: ロケールごとのloader map。プレーンmapはロケールをloaderに関連付けます。qualified mapは（collectionsとvariantsで使用）ロケールをqualifier idに関連付け、その後loaderに関連付けます。qualified mapの場合、selectorが対象とするchunk（複数可）のみが読み込まれます。
+  - **型**: `PlainDynamicLoaderMap<T> | QualifiedDynamicLoaderMap`
+  - **必須**: はい
+
+- `key: string`
+  - **説明**: dictionary key。chunk cacheの名前空間化に使用されます。
+  - **型**: `string`
+  - **必須**: はい
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **説明**: コンテンツを解釈するロケール、またはselectorオブジェクト（`{ item }`、`{ variant }`、オプションで`locale`）。[dynamic dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/index.md)を参照してください。
+  - **型**: `LocalesValues | DictionarySelector`
+  - **必須**: いいえ（オプション）— 設定された`defaultLocale`がデフォルトです。
+
+- `plugins: Plugins[]`
+  - **説明**: Nodetransformers。デフォルトではbase interpreter setです。
+  - **型**: `Plugins[]`
+  - **必須**: いいえ（オプション）
+
+### Returns
+
+- **Type**: `Promise<Content>` — 読み込まれたチャンクの解釈されたコンテンツに解決されるプロミス。
+- **Description**: マップが要求されたロケール、またはそのフォールバックのいずれに対してもチャンクを出さない場合、`null` に解決されます。これは、欠落した適格な座標がどのように解決されるかを反映しています。
+
+---
+
+## 使用例
+
+### 生成されたローダーマップを使用する
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getDictionaryAsync } from "intlayer";
+import appLoaderMap from "../.intlayer/dynamic_dictionaries/app";
+
+const { title } = await getDictionaryAsync(appLoaderMap, "app", "fr");
+```
+
+### カスタムローダーマップを使用する
+
+```typescript
+import { getDictionaryAsync } from "intlayer";
+
+const loaderMap = {
+  en: () => import("./banner.en.json").then((mod) => mod.default),
+  fr: () => import("./banner.fr.json").then((mod) => mod.default),
+};
+
+const banner = await getDictionaryAsync(loaderMap, "banner", "fr");
+```
+
+### 修飾されたマップ上のセレクターを使用
+
+```typescript
+import { getDictionaryAsync } from "intlayer";
+
+const promoBanner = await getDictionaryAsync(bannerLoaderMap, "banner", {
+  variant: "black-friday",
+  locale: "fr",
+});
+```
+
+---
+
+## 動作に関する注釈
+
+### キャッシングと重複排除
+
+キャッシュは各 `key + locale + selector` トリプルの **promise** を保存するため、同じチャンクに対する同時呼び出しは単一の load を待機します。拒否された load はキャッシュから削除されるため、失敗したチャンクは同じ失敗を永遠に再生するのではなく、次の呼び出しで再試行されます。
+
+### ロケールフォールバック
+
+プレーンローダーマップは、同期モードと同じフォールバックチェーンに従って処理されます。リクエストされたロケールが最初に処理され、次にそのフォールバック、そしてどのフォールバックもチャンクを出力しなかった場合は `null` が処理されます。
+
+---
+
+## 関連する関数
+
+- [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getIntlayerAsync.md): アプリケーションが呼び出す関数。ビルドプラグインはこれを `getDictionaryAsync` に書き換えます。
+- [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getDictionary.md): 完全な辞書を取得する同期的な対応関数。
+- [Dynamic dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/index.md): コレクションとバリアント、およびそれらが生成するローダーマップ。
+
+---
+
+## TypeScript
+
+```typescript
+function getDictionaryAsync<
+  const T extends Dictionary,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  dictionaryLoaders: PlainDynamicLoaderMap<T> | QualifiedDynamicLoaderMap,
+  key: string,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): Promise<
+  DeepTransformContent<
+    T["content"],
+    IInterpreterPluginState,
+    ExtractSelectorLocale<A>
+  >
+>;
+```

package/docs/ja/packages/intlayer/getEnumeration.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 `getEnumeration` 関数は、列挙オブジェクト内の事前定義された条件に基づいて、特定の数量に対応するコンテンツを取得します。条件はキーとして定義されており、その優先順位はオブジェクト内の順序によって決まります。
 
+列挙型の宣言方法の詳細については、[列挙型ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/enumeration.md)を参照してください。
+
 ## パラメーター
 
 - `enumerationContent: QuantityContent<Content>`

package/docs/ja/packages/intlayer/getIntlayer.md

@@ -0,0 +1,197 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: getIntlayer Function Documentation | intlayer
+description: intlayer パッケージの getIntlayer 関数を使用する方法を参照してください
+keywords:
+  - getIntlayer
+  - dictionary
+  - content
+  - selector
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getIntlayer
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "初期ドキュメント"
+author: aymericzip
+---
+
+# Documentation: `intlayer` の `getIntlayer` 関数
+
+## Description
+
+`getIntlayer` 関数は、キーによって1つの辞書を選択し、指定されたロケールで解釈されたコンテンツを返します。これは `useIntlayer` フックのフレームワーク非依存の対応物です：同じコンテンツ、同じセレクタですが、React コンテキストが利用できない場所ならどこでも使用可能です — Node スクリプト、サーバー関数、ルートローダー、メタデータビルダー、Express/Fastify ハンドラ、テスト。
+
+Intlayer によって `.intlayer/` に生成された辞書を読み込むため、`key` 引数は型付けされており、独自のコンテンツ宣言から自動補完されます。返されるオブジェクトは各リーフまで完全に型付けされています。
+
+**主な機能：**
+
+- 型付けされた辞書キーと型付けされた返されたコンテンツ
+- すべてのコンテンツノードを解釈（`t()`、`enu()`、`cond()`、`insert()`、`nest()`、`md()`、`html()`、`file()`、`gender()`）
+- ロケールまたはセレクタオブジェクト（collections、variants）を受け入れる
+- 結果は `key + locale + selector` ごとにメモ化される
+- 開発時に辞書が見つからない場合、クラッシュする代わりに安全なプロキシにフォールバックする
+
+---
+
+## 関数シグネチャ
+
+```typescript
+getIntlayer(
+  key: DictionaryKeys,                        // 必須
+  localeOrSelector?: LocalesValues | DictionarySelector, // オプション
+  plugins?: Plugins[]                         // オプション
+): DeepTransformContent<...>
+```
+
+---
+
+## パラメータ
+
+- `key: DictionaryKeys`
+  - **説明**: コンテンツファイルで宣言されている、読み取る辞書のキー。
+  - **型**: `DictionaryKeys` — すべての宣言された辞書キーの共用体。
+  - **必須**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **説明**: コンテンツを解釈するロケール、または[動的辞書](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/index.md)のセレクタオブジェクト。
+    - `'fr'` — ロケール
+    - `{ item: 2 }` — [collection](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/collections.md)アイテム（すべてのアイテムを配列として取得するには`item`を省略）
+    - `{ variant: 'black-friday' }` — 名前付き[variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/variants.md)（`default`の場合は省略）
+    - `{ variant: { id: 'prod_abc', userId: '123' } }` — 構造化variant
+    - すべてのセレクタはロケールを持つことができます: `{ item: 2, locale: 'fr' }`
+  - **型**: `LocalesValues | DictionarySelector`
+  - **必須**: No (Optional) — デフォルトは設定された`defaultLocale`。
+
+- `plugins: Plugins[]`
+  - **説明**: ベースインタープリタプラグインを置き換えるカスタムノードトランスフォーマー。高度な使用のみ；デフォルトの動作を保つには省略してください。
+  - **型**: `Plugins[]`
+  - **必須**: No (Optional)
+
+### 戻り値
+
+- **Type**: 宣言から型付けされた、辞書の解釈されたコンテンツ。
+- **Description**: 辞書の `content` フィールドをミラーリングしたプレーンオブジェクト。すべての Intlayer ノードが要求されたロケールの最終値に解決されます。
+
+---
+
+## 使用例
+
+### 基本的な使用法
+
+```typescript fileName="src/app.content.ts" codeFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const appContent = {
+  key: "app",
+  content: {
+    title: t({
+      ja: "こんにちは",
+      en: "Hello",
+      fr: "Bonjour",
+    }),
+  },
+} satisfies Dictionary;
+
+export default appContent;
+```
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer("app", "fr"); // "Bonjour"
+```
+
+### ロケールなし
+
+ロケールを省略すると、コンテンツは[設定](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)で宣言された `defaultLocale` で解釈されます。
+
+```typescript
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer("app"); // デフォルトロケールで解釈されます
+```
+
+### サーバーハンドラー内
+
+```typescript fileName="src/routes/greeting.ts" codeFormat="typescript"
+import { getIntlayer, getLocale } from "intlayer";
+
+export const greetingHandler = async (request: Request) => {
+  const locale = await getLocale({
+    getHeader: (name) => request.headers.get(name) ?? undefined,
+  });
+
+  const { title } = getIntlayer("app", locale);
+
+  return Response.json({ title });
+};
+```
+
+### セレクタ付き (コレクションとバリアント)
+
+```typescript
+import { getIntlayer } from "intlayer";
+
+// 単一のコレクション項目
+const secondPost = getIntlayer("blog-post", { item: 2, locale: "fr" });
+
+// コレクションのすべての項目を順序付き配列として取得
+const allPosts = getIntlayer("blog-post", { locale: "fr" });
+
+// 名前付きバリアント
+const banner = getIntlayer("banner", { variant: "black-friday", locale: "fr" });
+```
+
+---
+
+## 動作に関する注記
+
+### キャッシング
+
+結果は `key + locale + selector` をキーとするモジュールレベルのキャッシュにメモ化されます。`getIntlayer("app", "fr")` を繰り返し呼び出すと、辞書は一度だけ解釈され、その後は同じオブジェクトが返されます。
+
+### 欠落している辞書
+
+開発中に、生成された辞書がないキーをリクエストすると、警告が1回ログされ、安全なフォールバックプロキシが返されます。`content.title`を読み取ると、エラーをスローする代わりに文字列`"app.title"`が返されます。これにより、欠落している宣言が修正されている間、ページを使用可能な状態に保つことができます。Intlayerビルド（またはdevサーバー）を実行して、辞書を生成します。
+
+### バンドルサイズ
+
+`getIntlayer` は、**すべての**ロケールを保持するマージされた辞書を読み込みます。クライアントバンドルでは、[ビルドプラグイン](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/bundle_optimization.md)が呼び出しを書き換え、必要なコンテンツのみがシップされます。レンダリング外でコンテンツを読み込む場合（メタデータ、ローダー、サーバー関数）で、単一のロケールをオンデマンドで読み込みたい場合は、代わりに[`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getIntlayerAsync.md)を使用してください。
+
+---
+
+## 関連関数
+
+- [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getIntlayerAsync.md): 単一のlocaleチャンクをロードするAsync版。
+- [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getDictionary.md): キーで検索する代わりに、自分で渡すdictionaryオブジェクトを解釈する。
+- [`useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/react-intlayer/useIntlayer.md): React hookの同等版で、providerからlocaleを読み取る。
+
+---
+
+## TypeScript
+
+```typescript
+function getIntlayer<
+  const T extends DictionaryKeys,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  key: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): DeepTransformContent<
+  DictionaryRegistryResult<T, A>,
+  IInterpreterPluginState,
+  ExtractSelectorLocale<A>
+>;
+```