@intlayer/docs 9.5.4 → 9.5.5

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

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-01-21
+updatedAt: 2026-09-19
+title: intlayer 統合ドキュメント | astro-intlayer
+description: astro.config.mjs で intlayer Astro 統合を設定および使用する方法を説明します。
+keywords:
+  - intlayer
+  - astro
+  - astro-intlayer
+  - 統合
+  - i18n
+  - 国際化
+  - ドキュメント
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - intlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "ミドルウェアとフックの詳細を含む統合ドキュメントを更新"
+  - version: 8.0.0
+    date: 2026-01-21
+    changes: "初期ドキュメント"
+author: aymericzip
+---
+
+# intlayer Astro 統合ドキュメント
+
+Astro 向けの `intlayer` 統合は、多言語国際化（i18n）のためにプロジェクトを設定します。ビルド時の辞書準備、Vite プラグインの注入、リクエストミドルウェアの自動登録、およびローカライズされたプリレンダリングページの出力を処理します。
+
+## 使用方法
+
+`astro.config.mjs` に `intlayer()` を追加します。
+
+```ts fileName="astro.config.mjs"
+import { defineConfig } from "astro/config";
+import { intlayer } from "astro-intlayer";
+
+export default defineConfig({
+  integrations: [intlayer()],
+});
+```
+
+Astro CLI のコードモッド（`astro add astro-intlayer`）でもサポートされているデフォルトインポートが生成されます。
+
+```ts
+import intlayer from "astro-intlayer";
+```
+
+## 説明
+
+この統合は Astro のビルドおよびランタイムライフサイクルにフックします。
+
+1. **設定セットアップ (`astro:config:setup`)**:
+   - **辞書の準備**: ビルド実行前に Intlayer 辞書と生成された型を準備します。
+   - **Vite プラグイン**: Vite エイリアス（シームレスな辞書インポートを可能にする）、ロケールルーティングプロキシ、およびビルドプルーニング用のプラグインを注入します。
+   - **ミドルウェアの登録**: 受信リクエストごとに `Astro.locals.intlayer` を設定する `astro-intlayer/middleware` をプロジェクトのミドルウェアチェーンに自動的に注入します。
+2. **ビルド完了 (`astro:build:done`)**:
+   - **ページの書き換え**: ローカライズされた URL 書き換えルールを検査し、対応するローカライズされたパスにプリレンダリングされた HTML ページを出力します。
+
+## すぐに利用できる機能
+
+設定が完了すると、Astro アプリケーションはすぐに以下を利用できます。
+
+- `.astro` コンポーネントのフロントマター内の `useIntlayer`、`useDictionary`、および `useLocale` フック。
+- Astro エンドポイントおよびページ内の `Astro.locals.intlayer` オブジェクト。
+- リアクティブな更新を備えた同じ API を反映する `<script>` ブロック内のクライアント側インポート。
+- `astro-intlayer/format` の組み込みフォーマッター（`useDate`、`useNumber`、`useCurrency` など）。
+
+## 関連ドキュメント
+
+- [`useIntlayer` フック](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/astro-intlayer/useIntlayer.md)
+- [`useLocale` フック](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/astro-intlayer/useLocale.md)
+- [`onRequest` ミドルウェア](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/astro-intlayer/onRequest.md)

package/docs/ja/packages/astro-intlayer/onRequest.md

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: onRequest ミドルウェアドキュメント | astro-intlayer
+description: Astro アプリケーションで onRequest ミドルウェアを使用してリクエストロケールを解決し、Astro.locals.intlayer を設定する方法を説明します。
+keywords:
+  - onRequest
+  - middleware
+  - astro
+  - astro-intlayer
+  - Astro.locals
+  - 国際化
+  - ドキュメント
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - onRequest
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "初期ドキュメント"
+author: aymericzip
+---
+
+# onRequest Astro ミドルウェアドキュメント
+
+`astro-intlayer/middleware` の `onRequest` ミドルウェアは、各受信 HTTP リクエストのロケールを解決し、`Astro.locals.intlayer` を設定します。
+
+`astro.config.mjs` に `intlayer()` 統合を登録すると、このミドルウェアは自動的に注入されます。`sequence(...)` を使用して Astro ミドルウェアを手動で合成する場合にのみ、直接インポートする必要があります。
+
+## 使用方法
+
+```ts fileName="src/middleware.ts"
+import { onRequest as intlayer } from "astro-intlayer/middleware";
+import { sequence } from "astro:middleware";
+
+export const onRequest = sequence(intlayer, async (context, next) => {
+  // カスタムミドルウェアで解決されたロケールにアクセス
+  const { locale } = context.locals.intlayer;
+  console.log(`ロケール ${locale} のリクエストを処理中`);
+
+  return next();
+});
+```
+
+## 説明
+
+ミドルウェアは以下の処理を実行します。
+
+1. **ロケール検出**:
+   - **URL**: URL パスプレフィックスまたは `?locale=` 検索パラメーターを分析します（`routing.mode` が `no-prefix` に設定されていない限り）。
+   - **クッキー / ヘッダー**: 永続化されたロケールクッキーまたはカスタムヘッダー値をチェックします。
+   - **Accept-Language**: ブラウザの優先言語ネゴシエーションにフォールバックします。
+   - プリレンダリングページ（`context.isPrerendered`）の場合、Astro のビルド警告を防ぐためにロケールは厳密に URL から抽出されます。
+2. **コンテキストの設定**: `Astro.locals.intlayer` に以下を設定します。
+   - `locale`: 解決されたロケール。
+   - `defaultLocale`: デフォルトのフォールバックロケール。
+   - `availableLocales`: 設定されたロケールの配列。
+3. **AsyncLocalStorage スコープ**: 後続のリクエスト処理を `AsyncLocalStorage` スコープ内にラップし、`useIntlayer()`、`useDictionary()`、および `useLocale()` が引数を渡さずにリクエスト状態にアクセスできるようにします。
+
+## `IntlayerLocals` 型
+
+```ts
+export type IntlayerLocals = {
+  locale: DeclaredLocales;
+  defaultLocale: DeclaredLocales;
+  availableLocales: DeclaredLocales[];
+};
+```
+
+## 関連ドキュメント
+
+- [`intlayer` 統合](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/astro-intlayer/intlayer.md)
+- [`useIntlayer` フック](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/astro-intlayer/useIntlayer.md)
+- [`useLocale` フック](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/astro-intlayer/useLocale.md)

package/docs/ja/packages/astro-intlayer/useDictionary.md

@@ -0,0 +1,95 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: useDictionary フックドキュメント | astro-intlayer
+description: Astro コンポーネントとスクリプトで useDictionary フックを使用して辞書オブジェクトを解決する方法を説明します。
+keywords:
+  - useDictionary
+  - dictionary
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - 国際化
+  - ドキュメント
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useDictionary
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "初期ドキュメント"
+author: aymericzip
+---
+
+# useDictionary フックドキュメント
+
+`useDictionary` フックは、インポートされた、またはインラインの辞書オブジェクトを解決し、Astro アプリケーションで現在のロケールに対応するコンテンツを返します。
+
+グローバル辞書レジストリからキーによって辞書を取得する `useIntlayer` とは異なり、`useDictionary` は辞書オブジェクトを直接操作します。
+
+## 使用方法
+
+```astro fileName="src/pages/index.astro"
+---
+import { useDictionary } from "astro-intlayer";
+import homeContent from "../content/home.content";
+
+const content = useDictionary(homeContent);
+---
+
+<main>
+  <h1>{content.title}</h1>
+  <p>{content.description}</p>
+</main>
+```
+
+`t()` を使用して定義されたインライン辞書を渡すこともできます。
+
+```astro fileName="src/components/Footer.astro"
+---
+import { useDictionary } from "astro-intlayer";
+import { t } from "intlayer";
+
+const footer = useDictionary({
+  key: "footer",
+  content: {
+    copyright: t({
+      ja: "無断転載を禁じます。",
+      en: "All rights reserved.",
+      fr: "Tous droits réservés.",
+      es: "Todos los derechos reservados.",
+    }),
+  },
+});
+---
+
+<footer>
+  <p>{footer.copyright}</p>
+</footer>
+```
+
+## パラメーター
+
+```ts
+useDictionary(dictionary, localeOrSelector?)
+```
+
+1. **`dictionary`**: 辞書オブジェクト、または修飾された辞書グループ。
+2. **`localeOrSelector`**（オプション）: 特定のロケールまたはセレクターオブジェクト（`{ item }`、`{ variant }`、必要に応じて `locale`）。
+
+## 説明
+
+フックは以下の処理を実行します。
+
+1. **ロケール検出**: サーバー上では `Astro.locals.intlayer` からロケールを取得します。ブラウザ上ではクライアント側のストアロケールを使用します。
+2. **コンテンツ処理**: 解決されたロケールに従って、翻訳（`t()`）、列挙、条件、およびネストされた構造を解決します。
+3. **セレクター**: 引数で提供されたアイテムまたはバリアントセレクターを適用します。
+
+## 関連ドキュメント
+
+- [`intlayer` 統合](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/astro-intlayer/intlayer.md)
+- [`useIntlayer` フック](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/astro-intlayer/useIntlayer.md)
+- [`useLocale` フック](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/astro-intlayer/useLocale.md)

package/docs/ja/packages/astro-intlayer/useIntlayer.md

@@ -0,0 +1,98 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: useIntlayer フックドキュメント | astro-intlayer
+description: Astro コンポーネントとクライアントスクリプトで useIntlayer フックを使用してローカライズされたコンテンツにアクセスする方法を説明します。
+keywords:
+  - useIntlayer
+  - dictionary
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - 国際化
+  - ドキュメント
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useIntlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "初期ドキュメント"
+author: aymericzip
+---
+
+# useIntlayer フックドキュメント
+
+`useIntlayer` フックを使用すると、Astro アプリケーションでキーを指定してローカライズされた辞書コンテンツを取得できます。
+
+同じインポートパスを使用して、2つの異なるコンテキストで呼び出すことができます。
+
+1. **サーバー / フロントマター**: `.astro` ファイル内では、`Astro.locals.intlayer` に保存されたリクエストロケールを使用して自動的にコンテンツを解決します。
+2. **ブラウザ / クライアント `<script>`**: クライアントスクリプトまたは UI フレームワークコンポーネント内では、クライアント側のストア実装（`vanilla-intlayer`）に解決されます。
+
+## 使用方法
+
+### Astro コンポーネントのフロントマター内
+
+```astro fileName="src/pages/index.astro"
+---
+import { useIntlayer } from "astro-intlayer";
+
+const content = useIntlayer("home");
+---
+
+<main>
+  <h1>{content.title}</h1>
+  <p>{content.description}</p>
+</main>
+```
+
+### クライアント `<script>` ブロック内
+
+```astro fileName="src/components/InteractiveWidget.astro"
+---
+import { useIntlayer } from "astro-intlayer";
+
+const content = useIntlayer("home");
+---
+
+<button id="alert-btn">{content.buttonText}</button>
+
+<script>
+  import { useIntlayer } from "astro-intlayer";
+
+  const content = useIntlayer("home");
+
+  document.getElementById("alert-btn")?.addEventListener("click", () => {
+    alert(content.buttonText);
+  });
+</script>
+```
+
+## パラメーター
+
+```ts
+useIntlayer(key, localeOrSelector?)
+```
+
+1. **`key`**: 辞書の一意のキー（`.content.ts` 宣言ファイルで定義されたもの）。
+2. **`localeOrSelector`**（オプション）: 特定のロケールまたはセレクターオブジェクト（`{ item }`、`{ variant }`、必要に応じて `locale`）。指定された場合、リクエストコンテキストまたはクライアントストアから検出されたロケールを上書きします。
+
+## 説明
+
+フックは以下の処理を実行します。
+
+1. **ロケール解決**:
+   - サーバー上では、`astro-intlayer/middleware` によって初期化された `AsyncLocalStorage` スコープを介して `Astro.locals.intlayer` からアクティブなロケールを読み取ります。
+   - ブラウザ上では、クライアントストレージ/ストアからアクティブなロケールを読み取ります。
+2. **辞書の取得**: 指定されたキーに一致する辞書コンテンツを注入します。
+3. **翻訳処理**: 翻訳（`t()`）、列挙、条件、およびマークダウンをレンダリング可能なコンテンツに解決します。
+
+## 関連ドキュメント
+
+- [`intlayer` 統合](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/astro-intlayer/intlayer.md)
+- [`useDictionary` フック](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/astro-intlayer/useDictionary.md)
+- [`useLocale` フック](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/astro-intlayer/useLocale.md)

package/docs/ja/packages/astro-intlayer/useLocale.md

@@ -0,0 +1,126 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: useLocale フックドキュメント | astro-intlayer
+description: Astro アプリケーションで useLocale フックを使用して現在のロケールにアクセスし管理する方法を説明します。
+keywords:
+  - useLocale
+  - locale
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - 国際化
+  - ドキュメント
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useLocale
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "初期ドキュメント"
+author: aymericzip
+---
+
+# useLocale フックドキュメント
+
+`astro-intlayer` の `useLocale` フックは、Astro アプリケーションにおいて現在のリクエストロケール、設定されたデフォルトロケール、およびすべての利用可能なロケールへのアクセスを提供します。
+
+サーバーレンダリングされた `.astro` フロントマターとクライアント側の `<script>` ブロックの両方で一貫して動作します。
+
+## 使用方法
+
+### コンポーネントフロントマター内（サーバーレンダリング）
+
+```astro fileName="src/layouts/Layout.astro"
+---
+import { useLocale } from "astro-intlayer";
+import { getLocalizedUrl, getPathWithoutLocale } from "intlayer";
+
+const { locale, defaultLocale, availableLocales } = useLocale();
+const pathWithoutLocale = getPathWithoutLocale(Astro.url.pathname);
+---
+
+<!DOCTYPE html>
+<html lang={locale}>
+  <head>
+    <meta charset="utf-8" />
+    <title>Astro + Intlayer</title>
+  </head>
+  <body>
+    <header>
+      <span>現在のロケール: {locale}</span>
+      <span>デフォルト: {defaultLocale}</span>
+      <nav>
+        <ul>
+          {availableLocales.map((localeItem) => (
+            <li key={localeItem} className="p-1">
+              <a
+                href={getLocalizedUrl(pathWithoutLocale, localeItem)}
+                aria-current={localeItem === locale ? "page" : undefined}
+              >
+                {localeItem.toUpperCase()}
+              </a>
+            </li>
+          ))}
+        </ul>
+      </nav>
+    </header>
+    <slot />
+  </body>
+</html>
+```
+
+### クライアント `<script>` 内（インタラクティブ）
+
+```astro fileName="src/components/LocaleSwitcher.astro"
+---
+import { useLocale } from "astro-intlayer";
+
+const { locale, availableLocales } = useLocale();
+---
+
+<select id="locale-select">
+  {availableLocales.map((loc) => (
+    <option value={loc} selected={loc === locale}>
+      {loc.toUpperCase()}
+    </option>
+  ))}
+</select>
+
+<script>
+  import { useLocale, setLocaleInStorage } from "astro-intlayer";
+
+  const { setLocale } = useLocale();
+
+  document.getElementById("locale-select")?.addEventListener("change", (e) => {
+    const target = e.target as HTMLSelectElement;
+    setLocale(target.value);
+  });
+</script>
+```
+
+## 戻り値
+
+このフックは `UseLocaleResult` 型のオブジェクトを返します。
+
+| プロパティ         | タイプ                                 | 説明                                                                                           |
+| ------------------ | -------------------------------------- | ---------------------------------------------------------------------------------------------- |
+| `locale`           | `DeclaredLocales`                      | アクティブなロケール。                                                                         |
+| `defaultLocale`    | `DeclaredLocales`                      | `intlayer.config.ts` で設定されたデフォルトのフォールバックロケール。                          |
+| `availableLocales` | `DeclaredLocales[]`                    | プロジェクト用に設定されたすべてのサポートされているロケールの配列。                           |
+| `setLocale`        | `(locale: LocalesValues) => void`      | ロケールを更新する関数。（クライアント `<script>` でインタラクティブに動作し、SSR では警告）。 |
+| `subscribe`        | `(callback: () => void) => () => void` | クライアント側のロケール変更を購読します。                                                     |
+
+## サーバーとクライアントの動作の違い
+
+- **SSR / サーバーレンダリング中**: リクエストは固定パラメーターで1回レンダリングされます。サーバーレンダリング中に `setLocale()` を呼び出しても効果はなく警告が出力されます。ロケールの切り替えはクライアントで行うか、目的のロケール URL に移動して行う必要があります。
+- **クライアントスクリプト内**: `setLocale` はクライアントストアを更新し、Intlayer 設定に従って永続化されたクッキーまたはローカルストレージを更新します。
+
+## 関連ドキュメント
+
+- [`intlayer` 統合](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/astro-intlayer/intlayer.md)
+- [`useIntlayer` フック](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/astro-intlayer/useIntlayer.md)
+- [`useDictionary` フック](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/astro-intlayer/useDictionary.md)

package/docs/ja/packages/remix-intlayer/Intlayer.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Intlayer コンテキストのドキュメント | remix-intlayer
+description: Remix 3 アプリケーションにおける Intlayer リクエストコンテキストストレージキーのドキュメント。
+keywords:
+  - Intlayer
+  - remix
+  - remix-3
+  - リクエストコンテキスト
+  - 国際化
+  - i18n
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - Intlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Intlayer コンテキストキーの初期ドキュメント"
+author: aymericzip
+---
+
+# Intlayer リクエストコンテキストキー
+
+`Intlayer` エクスポートは、Remix 3 におけるリクエストコンテキストストレージ識別子として機能します。ルートハンドラーやカスタムミドルウェア内で、Remix コンテキストオブジェクトから Intlayer の状態を直接取得できます。
+
+## 使用方法
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer, Intlayer } from "remix-intlayer";
+
+const router = createRouter({
+  middleware: [intlayer()],
+});
+
+router.get("/api/current-locale", (context) => {
+  const intlayerState = context.get(Intlayer);
+
+  return Response.json({
+    locale: intlayerState?.locale,
+  });
+});
+```
+
+## 説明
+
+`Intlayer` は、`intlayer()` ミドルウェアが現在のセッション状態を Remix のリクエストコンテキスト（`RequestContext`）に関連付けるために使用されます。通常は `useLocale()` や `useIntlayer()` などのフックを使用することが推奨されます。`context.get(Intlayer)` による直接アクセスは、低レベルのミドルウェアハンドラーやコンテキストインスタンスが明示的に渡される API ルートで便利です。
+
+## 関連ドキュメント
+
+- [`intlayer` ミドルウェア](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/remix-intlayer/intlayerMiddleware.md)
+- [`useLocale` フック](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/remix-intlayer/useLocale.md)

package/docs/ja/packages/remix-intlayer/exports.md

@@ -0,0 +1,80 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: remix-intlayer パッケージのドキュメント
+description: Remix 3 アプリケーションに国際化（i18n）を提供する remix-intlayer パッケージのエクスポートドキュメント。
+keywords:
+  - remix-intlayer
+  - remix
+  - remix-3
+  - intlayer
+  - 国際化
+  - i18n
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - exports
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "remix-intlayer エクスポートの初期ドキュメント"
+author: aymericzip
+---
+
+# remix-intlayer パッケージ
+
+`remix-intlayer` パッケージは、Intlayer を Remix 3 アプリケーションに統合するためのツールを提供します。リクエストのロケール検出用ミドルウェア、リクエストコンテキストへのアクセス、辞書の取得やロケール管理を行うフックが含まれています。
+
+## インストール
+
+```bash
+npm install remix-intlayer
+```
+
+## パッケージのエクスポート
+
+### ミドルウェア
+
+| エクスポート | タイプ           | 説明                                                                                                          | 関連ドキュメント                                                                                                                     |
+| ------------ | ---------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
+| `intlayer`   | ミドルウェア関数 | リクエストのロケールを検出し、リダイレクトを処理し、リクエストコンテキストを設定する Remix 3 用ミドルウェア。 | [intlayer ミドルウェア](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/remix-intlayer/intlayerMiddleware.md) |
+
+### コンテキストストレージ
+
+| エクスポート | タイプ                           | 説明                                                                                                                                | 関連ドキュメント                                                                                                           |
+| ------------ | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `Intlayer`   | RequestContext キー / ストレージ | Remix 3 のリクエストコンテキスト（`context.get(Intlayer)`）から Intlayer の状態を取得するために使用するリクエストコンテキストキー。 | [Intlayer コンテキスト](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/remix-intlayer/Intlayer.md) |
+
+### フック
+
+| エクスポート    | タイプ | 説明                                                                                                 | 関連ドキュメント                                                                                                               |
+| --------------- | ------ | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
+| `useIntlayer`   | フック | 現在のリクエストロケールに基づいて、キーで指定された辞書コンテンツを取得・解決します。               | [useIntlayer フック](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/remix-intlayer/useIntlayer.md)     |
+| `useDictionary` | フック | インポート済みの辞書オブジェクトから、現在のロケールに対応するコンテンツを返します。                 | [useDictionary フック](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/remix-intlayer/useDictionary.md) |
+| `useLocale`     | フック | 現在のリクエストロケール、デフォルトロケール、および利用可能なロケール一覧へのアクセスを提供します。 | [useLocale フック](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/remix-intlayer/useLocale.md)         |
+
+## クイックスタート
+
+### ルーターでのミドルウェア設定
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer } from "remix-intlayer";
+
+export const router = createRouter({
+  middleware: [intlayer()],
+});
+```
+
+### コンポーネントおよびビューでのコンテンツ利用
+
+```ts fileName="src/views/home.ts"
+import { useIntlayer } from "remix-intlayer";
+
+export const HomeView = () => {
+  const content = useIntlayer("home");
+
+  return `<h1>${content.title}</h1><p>${content.description}</p>`;
+};
+```

package/docs/ja/packages/remix-intlayer/intlayerMiddleware.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: intlayer ミドルウェアのドキュメント | remix-intlayer
+description: Remix 3 で intlayer ミドルウェアを使用してロケールを検出し、リダイレクトを処理し、リクエストコンテキストに Intlayer 状態を注入する方法を学びます。
+keywords:
+  - intlayer
+  - middleware
+  - remix
+  - remix-3
+  - 国際化
+  - i18n
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - intlayerMiddleware
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "intlayer ミドルウェアの初期ドキュメント"
+author: aymericzip
+---
+
+# intlayer ミドルウェア
+
+`intlayer` ミドルウェア関数は、Remix 3 アプリケーションでリクエスト単位の国際化を設定します。受信したリクエストごとにロケールを検出し、URL リダイレクトルールを適用し、リクエストコンテキストにロケール状態を永続化します。
+
+## 使用方法
+
+Remix ルーターにミドルウェアを登録します。
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer } from "remix-intlayer";
+
+export const router = createRouter({
+  middleware: [intlayer()],
+});
+```
+
+## 動作の仕組み
+
+ミドルウェアは各受信リクエストに対して以下のタスクを実行します。
+
+1. **ロケール検出**: Intlayer の設定に従い、URL パスプレフィックス（例: `/ja/about`）、クッキー、または `Accept-Language` ヘッダーからロケールを抽出します。
+2. **URL リダイレクト**: 要求されたパスにロケールプレフィックスがなく、設定でプレフィックス付きルーティングが必要な場合、プレフィックス付き URL へのリダイレクトレスポンス（302/307/308）を返します。
+3. **リクエストコンテキストの登録**: `Intlayer` キーを使用して解決された現在のロケールを Remix リクエストコンテキストに保存し、フック（`useLocale`、`useIntlayer`、`useDictionary`）が透過的に利用できるようにします。
+4. **クッキー管理**: ユーザーの優先ロケールを永続化する必要がある場合、`Set-Cookie` ヘッダーを設定します。
+
+## 関連ドキュメント
+
+- [`Intlayer` リクエストコンテキスト](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/remix-intlayer/Intlayer.md)
+- [`useLocale` フック](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/remix-intlayer/useLocale.md)
+- [`useIntlayer` フック](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/remix-intlayer/useIntlayer.md)