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

package/docs/ja/packages/solid-intlayer/usePathname.md

@@ -0,0 +1,120 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: usePathname Hook ドキュメント | solid-intlayer
+description: solid-intlayer パッケージの usePathname フックの使い方
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - 国際化
+  - i18n
+  - ドキュメント
+  - Solid
+  - Solid.js
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - solid-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathnameユーティリティを追加"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Init history"
+author: aymericzip
+---
+
+# Solid 連携: `usePathname` フックドキュメント
+
+`usePathname` フックは、現在のブラウザのパス名 (pathname) からロケールセグメントを削除したものを、Solid の `Accessor<string>` として返します。ロケールを意識したナビゲーション（例：どのナビゲーションアイテムがアクティブかを判断する）を、ロケールのプレフィックスを手動で削除することなく構築するのに役立ちます。
+
+## `usePathname` のインポート（Solid）
+
+```typescript
+import { usePathname } from "solid-intlayer";
+```
+
+## 概要
+
+`usePathname` は、`window.location.pathname` から初期化されたリアクティブなシグナルを作成し、`getPathWithoutLocale` を介してロケールプレフィックスを削除し、ブラウザが `popstate` イベント（戻る/進むのナビゲーション）を発生させるたびにシグナルを更新します。イベントリスナーは、`onCleanup` を介して自動的にクリーンアップされます。
+
+## 使用方法
+
+```tsx fileName="src/components/NavItem.tsx"
+import type { Component } from "solid-js";
+import { usePathname } from "solid-intlayer";
+
+type NavItemProps = {
+  href: string;
+  label: string;
+};
+
+const NavItem: Component<NavItemProps> = ({ href, label }) => {
+  const pathname = usePathname();
+
+  return (
+    <a href={href} aria-current={pathname() === href ? "page" : undefined}>
+      {label}
+    </a>
+  );
+};
+
+export default NavItem;
+```
+
+## 戻り値
+
+| 型                 | 説明                                                                                               |
+| ------------------ | -------------------------------------------------------------------------------------------------- |
+| `Accessor<string>` | ロケールプレフィックスを取り除いた現在のパス名を返す、Solid のアクセサ（リアクティブなゲッター）。 |
+
+## 動作
+
+- **ロケールの削除**: 先頭のロケールセグメントを削除します（例: `/ja/dashboard` → `/dashboard`）。
+- **リアクティビティ**: `popstate` イベント（ブラウザの戻る / 進む）で自動的に更新されます。
+- **SSR セーフ**: `window` が利用できない場合は `""` を返します。
+- **クリーンアップ**: `popstate` リスナーは Solid の `onCleanup` 経由で自動的に削除されます。
+
+## 例
+
+```tsx fileName="src/components/Sidebar.tsx"
+import type { Component } from "solid-js";
+import { For } from "solid-js";
+import { usePathname } from "solid-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "ダッシュボード" },
+  { href: "/settings", label: "設定" },
+];
+
+const Sidebar: Component = () => {
+  const pathname = usePathname();
+
+  return (
+    <nav>
+      <For each={links}>
+        {({ href, label }) => (
+          <a
+            href={href}
+            style={{ "font-weight": pathname() === href ? "bold" : "normal" }}
+          >
+            {label}
+          </a>
+        )}
+      </For>
+    </nav>
+  );
+};
+
+export default Sidebar;
+```
+
+## 関連事項
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/solid-intlayer/useLocale.md) — 現在のロケール + ロケールスイッチャー
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getPathWithoutLocale.md) — このフックの内部で使用されるユーティリティ

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

@@ -14,6 +14,9 @@ slugs:
   - svelte-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname ユーティリティを追加"
   - version: 8.0.0
     date: 2026-01-21
     changes: "すべてのエクスポートのドキュメントを統合"
@@ -64,15 +67,16 @@ import "svelte-intlayer";
 import "svelte-intlayer";
 ```
 
-| 関数                   | 説明                                                                                                                     | 関連ドキュメント                                                                                                         |
-| ---------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
-| `useIntlayer`          | `useDictionary` をベースにしており、生成された宣言から辞書の最適化されたバージョンを注入します。                         | -                                                                                                                        |
-| `useDictionary`        | 辞書のようなオブジェクト（key、content）を処理します。`t()` の翻訳、列挙などを処理します。                               | -                                                                                                                        |
-| `useDictionaryAsync`   | `useDictionary` と同じですが、非同期の辞書を扱います。                                                                   | -                                                                                                                        |
-| `useDictionaryDynamic` | `useDictionary` と同じですが、動的な辞書を扱います。                                                                     | -                                                                                                                        |
-| `useLocale`            | 現在のロケールとそれを設定する関数を返します。                                                                           | -                                                                                                                        |
-| `useRewriteURL`        | URLの書き換えを管理するクライアントサイド関数。ローカライズされた書き換えルールが存在する場合は自動的にURLを更新します。 | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/svelte-intlayer/useRewriteURL.md) |
-| `useIntl`              | 現在のロケールのためのIntlオブジェクトを返します。                                                                       | -                                                                                                                        |
+| 関数                   | 説明                                                                                                                      | 関連ドキュメント                                                                                                         |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| `useIntlayer`          | `useDictionary` をベースにしており、生成された宣言から辞書の最適化されたバージョンを注入します。                          | -                                                                                                                        |
+| `useDictionary`        | 辞書のようなオブジェクト（key、content）を処理します。`t()` の翻訳、列挙などを処理します。                                | -                                                                                                                        |
+| `useDictionaryAsync`   | `useDictionary` と同じですが、非同期の辞書を扱います。                                                                    | -                                                                                                                        |
+| `useDictionaryDynamic` | `useDictionary` と同じですが、動的な辞書を扱います。                                                                      | -                                                                                                                        |
+| `useLocale`            | 現在のロケールとそれを設定する関数を返します。                                                                            | -                                                                                                                        |
+| `usePathname`          | ロケールセグメントが削除された現在のパス名(pathname)を `Readable<string>` ストアとして返します。`popstate` に反応します。 | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/svelte-intlayer/usePathname.md)     |
+| `useRewriteURL`        | URLの書き換えを管理するクライアントサイド関数。ローカライズされた書き換えルールが存在する場合は自動的にURLを更新します。  | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/svelte-intlayer/useRewriteURL.md) |
+| `useIntl`              | 現在のロケールのためのIntlオブジェクトを返します。                                                                        | -                                                                                                                        |
 
 ### マークダウン
 

package/docs/ja/packages/svelte-intlayer/usePathname.md

@@ -0,0 +1,103 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: usePathname 関数ドキュメント | svelte-intlayer
+description: svelte-intlayer パッケージの usePathname 関数の使用方法
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internationalization
+  - Documentation
+  - Svelte
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - svelte-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname ユーティリティを追加"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "履歴の初期化"
+author: aymericzip
+---
+
+# Svelte 統合: `usePathname` ドキュメント
+
+`usePathname` 関数は、ロケールセグメントが削除された現在のブラウザのパス名を Svelte の `Readable<string>` ストアとして返します。これは、ロケールプレフィックスを手動で削除することなく、ロケールを考慮したナビゲーション（例えば、どのナビゲーション項目がアクティブかを判断するなど）を構築するのに役立ちます。
+
+## Svelte で `usePathname` をインポートする
+
+```typescript
+import { usePathname } from "svelte-intlayer";
+```
+
+## 概要
+
+`usePathname` は `window.location.pathname` から初期化される Svelte の読み取り可能なストア（readable store）を作成し、`getPathWithoutLocale` を介してロケールプレフィックスを削除し、ブラウザが `popstate` イベント（戻る/進むナビゲーション）を発生させるたびに新しい値を発行します。コンポーネント内では `$` ストア構文を使用してサブスクライブします。
+
+## 使用法
+
+```svelte fileName="src/components/NavItem.svelte"
+<script lang="ts">
+  import { usePathname } from "svelte-intlayer";
+
+  export let href: string;
+  export let label: string;
+
+  const pathname = usePathname();
+</script>
+
+<a {href} aria-current={$pathname === href ? "page" : undefined}>
+  {label}
+</a>
+```
+
+## 戻り値
+
+| タイプ             | 説明                                                                                                 |
+| ------------------ | ---------------------------------------------------------------------------------------------------- |
+| `Readable<string>` | ロケールプレフィックスを含まない現在のパス名を含む Svelte の読み取り可能なストア（Readable store）。 |
+
+## 動作
+
+- **ロケールの削除**: 先頭のロケールセグメントを削除します（例: `/ja/dashboard` → `/dashboard`）。
+- **リアクティブ**: `popstate` イベント（ブラウザの戻る/進むナビゲーション）のたびに新しい値を発行します。
+- **SSR セーフ**: `window` が利用できない場合は `""` を返します。
+- **クリーンアップ**: 最後のサブスクライバーがサブスクライブを解除すると、`popstate` リスナーは自動的に削除されます。
+
+## 例
+
+```svelte fileName="src/components/Sidebar.svelte"
+<script lang="ts">
+  import { usePathname } from "svelte-intlayer";
+
+  const links = [
+    { href: "/dashboard", label: "ダッシュボード" },
+    { href: "/settings", label: "設定" },
+  ];
+
+  const pathname = usePathname();
+</script>
+
+<nav>
+  {#each links as link}
+    <a
+      href={link.href}
+      style:font-weight={$pathname === link.href ? "bold" : "normal"}
+    >
+      {link.label}
+    </a>
+  {/each}
+</nav>
+```
+
+## 関連
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/svelte-intlayer/useLocale.md) — 現在のロケール + ロケールスイッチャー
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getPathWithoutLocale.md) — このフックで使用される基礎的なユーティリティ

package/docs/ja/packages/vite-intlayer/intlayerCompiler.md

@@ -0,0 +1,120 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: intlayerCompiler Viteプラグインドキュメント | vite-intlayer
+description: コンポーネントファイルからインラインのIntlayerコンテンツ宣言を抽出し、ビルド/変換時に辞書JSONファイルに書き込むViteプラグイン。
+keywords:
+  - intlayerCompiler
+  - vite
+  - プラグイン
+  - コンパイラ
+  - コンテンツ
+  - 辞書
+  - 国際化
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerCompiler
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "intlayer()にバンドル。ドキュメント初期化"
+author: aymericzip
+---
+
+# intlayerCompiler
+
+`intlayerCompiler`は、コンポーネントのソースファイルをスキャンして**インラインのIntlayerコンテンツ宣言**（別個の`.content.ts`ファイルではなく、コンポーネント内に直接定義されたコンテンツ）を探し、変換（transform）フェーズ中にそれらを辞書JSONファイルに書き込むViteプラグインです。
+
+> **Intlayer v9以降**、`compiler.enabled`が`true`かつ`compiler.output`がIntlayer設定で指定されている場合、`intlayerCompiler`はメインの[`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/vite-intlayer/intlayer.md)プラグインに自動的に組み込まれます。コンパイラ固有の設定を完全に制御したい場合にのみ、個別に登録する必要があります。
+
+## 使用方法
+
+### `intlayer()`の一部として（推奨、v9+）
+
+Intlayer設定でコンパイラを有効にします：
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  compiler: {
+    enabled: true,
+    output: "./src/dictionaries", // 抽出された辞書が書き込まれる場所
+  },
+});
+```
+
+次に、追加の登録なしで標準プラグインを使用します：
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### スタンドアロン（必要な場合）
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayerCompiler()],
+});
+```
+
+## オプション
+
+```ts
+import type { IntlayerCompilerOptions } from "vite-intlayer";
+```
+
+| オプション       | 型                        | 説明                                                                                           |
+| ---------------- | ------------------------- | ---------------------------------------------------------------------------------------------- |
+| `configOptions`  | `GetConfigurationOptions` | `getConfiguration()`に転送されるIntlayer設定のオーバーライド。                                 |
+| `compilerConfig` | `Partial<CompilerConfig>` | コンパイラ固有の設定セクションに対するオーバーライド（例：`enabled`、`output`、`filesList`）。 |
+
+### 例
+
+```ts
+intlayerCompiler({
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+  compilerConfig: { enabled: true, output: "./src/dictionaries" },
+});
+```
+
+## 動作原理
+
+### 変換（Transform）フェーズ
+
+`compiler.filesList`に一致するすべてのソースファイルに対して、コンパイラプラグインは以下を実行します：
+
+1. ファイルコンテンツを`@intlayer/babel`の`extractContent`に渡します。
+2. 検出された各宣言に対して`onExtract`を呼び出し、結果の辞書JSONを`compiler.output`に書き込みます。
+3. インライン宣言が標準の`useIntlayer('key')` / `getIntlayer('key')`呼び出しに置き換えられた、変換後のソースコードを返します。
+
+サポートされているファイルタイプ：`.ts`、`.tsx`、`.js`、`.jsx`、`.vue`、`.svelte`、`.astro`。
+
+### HMR（ホットモジュールリプレイスメント）
+
+開発モードでコンポーネントファイルが保存されると、コンパイラは以下を実行します：
+
+1. Viteの`handleHotUpdate`フックを介してファイルの変更を検知します。
+2. 更新されたファイルからコンテンツを再抽出します。
+3. 更新された辞書JSONを書き込みます。
+4. ページのフルリロードをトリガーします（`server.ws.send({ type: 'full-reload' })`）。
+
+500ミリ秒のデバウンス（遅延）により、辞書の書き込み自体（これもファイル変更イベントをトリガーします）が無限の再抽出ループを引き起こすのを防ぎます。
+
+### 重複排除（Deduplication）
+
+`intlayerCompiler`は、他のバンドルされたプラグインと同じ`createPrimaryInstanceGuard`重複排除メカニズムを使用します。`intlayer()`（コンパイラを内包）と手動の`intlayerCompiler()`呼び出しの両方が存在する場合、最初に登録されたインスタンスのみが実行され、辞書が二重に書き込まれることはありません。

package/docs/ja/packages/vite-intlayer/intlayerMinify.md

@@ -0,0 +1,92 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: intlayerMinify Viteプラグインドキュメント | vite-intlayer
+description: コンパイルされたIntlayer辞書JSONファイルを圧縮（ミニファイ）し、必要に応じてコンテンツフィールド名を難読化してバンドルサイズを削減するViteプラグイン。
+keywords:
+  - intlayerMinify
+  - vite
+  - プラグイン
+  - 圧縮
+  - バンドルサイズ
+  - 辞書
+  - 国際化
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerMinify
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "ドキュメント初期化"
+author: aymericzip
+---
+
+# intlayerMinify
+
+`intlayerMinify`は、本番ビルド（production build）時にコンパイルされた辞書JSONファイルを圧縮するViteプラグインです。不要な空白をすべて取り除き、`intlayerPrune`と組み合わせることで、コンテンツフィールド名を短いアルファベットのエイリアス（`a`、`b`、`c`、…）にオプションで変更し、バンドルサイズをさらに削減します。
+
+> [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/vite-intlayer/intlayer.md)を使用する場合、このプラグインはすでに自動的に含まれ、設定されています。プラグインのスタックをご自身で構成する場合にのみ、手動で登録する必要があります。
+
+## 使用方法
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerMinify, intlayerPrune } from "vite-intlayer";
+import { createPruneContext } from "@intlayer/babel";
+
+const pruneContext = createPruneContext();
+
+export default defineConfig({
+  plugins: [
+    intlayerPrune(intlayerConfig, pruneContext),
+    intlayerMinify(intlayerConfig, pruneContext),
+  ],
+});
+```
+
+## 有効化の条件
+
+`intlayerMinify`は、以下の3つの条件がすべて満たされている場合に**のみ**有効になります：
+
+1. Viteコマンドが`build`である（`serve` / devではない）。
+2. `build.optimize`が`true`である（または`undefined`であり、ビルド時のデフォルトである`true`になる）。
+3. Intlayer設定で`build.minify`が`true`である。
+
+エディタは完全で人間が読める辞書コンテンツを必要とするため、`editor.enabled`が`true`の場合、プラグインは自動的に**無効**になります。
+
+## 圧縮される対象
+
+プラグインは、2つの辞書の場所（`intlayer.system`から解決される場所）をターゲットにします：
+
+- `dictionariesDir` — 静的な全言語共通の辞書（例：`.intlayer/dictionaries/*.json`）
+- `dynamicDictionariesDir` — 言語ごとの動的な辞書
+
+> フェッチモード辞書（`fetchDictionariesDir`）は、実行時に元のフィールド名を使用してリモートAPIから提供されるため、**決して**圧縮されません。フィールド名を変更すると、サーバーの応答とクライアント側のプロパティアクセスとの間に不一致が生じるためです。
+
+## フィールド名の難読化（プロパティの圧縮）
+
+`intlayerPrune`がコードベースを分析し、`pruneContext.dictionaryKeyToFieldRenameMap`にデータを入力すると、`intlayerMinify`はコンテンツフィールド名を短いエイリアスに変更します。例えば：
+
+```json
+// 変更前
+{ "key": "myDict", "content": { "title": "Hello", "description": "World" } }
+
+// 変更後（難読化あり）
+{ "key": "myDict", "content": { "a": "Hello", "b": "World" } }
+```
+
+対応するソースファイルのプロパティアクセスは、`intlayerOptimize`内のBabelパスによって変更されるため、実行時の動作は変わりません。
+
+Intlayerの内部フィールド（`nodeType`、`translation`など）の名前が変更されることはありません。
+
+## エッジケースの辞書
+
+`pruneContext.dictionariesWithEdgeCases`でフラグが立てられた辞書（クリーンアップ（prune）フェーズで検出された構造的な異常）は、破損したデータを配信するのを防ぐために完全にスキップされ、圧縮も難読化もされません。
+
+## 修飾子グループ（コレクション / バリアント / メタレコード）
+
+`qualifierTypes`配列を持つ辞書（コレクション、バリアント、メタレコード）について、プラグインは`qualifierTypes`配列と`meta`サイドマップをそのまま保持します。`content`エントリのフィールド名のみが難読化されます。実行時のセレクターマッチングに使用される複合キーが変更されることはありません。

package/docs/ja/packages/vite-intlayer/intlayerProxy.md

@@ -0,0 +1,172 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: intlayerProxy Viteプラグインドキュメント | vite-intlayer
+description: Viteの開発/プレビューサーバーおよび本番SSR用の言語ルーティングミドルウェア。言語検出、URLリダイレクト、および内部書き換えを処理します。
+keywords:
+  - intlayerProxy
+  - vite
+  - プラグイン
+  - ミドルウェア
+  - 言語
+  - ルーティング
+  - 国際化
+  - i18n
+  - SSR
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerProxy
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "configOptionsを単一のoptionsオブジェクトにマージ。proxyをintlayer()にバンドル"
+author: aymericzip
+---
+
+# intlayerProxy
+
+`intlayerProxy`は、開発サーバー、プレビューサーバー、および本番SSR（Nitro / TanStack Start）の**すべての環境**に対応する言語ルーティングミドルウェアを登録するViteプラグインです。
+
+> **Intlayer v9以降**、`intlayerProxy`は自動的にメインの[`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/vite-intlayer/intlayer.md)プラグインに含まれ、`routing.enableProxy: true`を介してデフォルトで有効になります。より低レベルな制御が必要な場合や、標準の`intlayer()`セットアップ以外で使用する場合にのみ、個別に登録する必要があります。
+
+## 使用方法
+
+### `intlayer()`の一部として（推奨、v9+）
+
+`intlayerProxy`を個別に登録する代わりに、メインプラグインに`proxy`オプションを渡します：
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
+});
+```
+
+### スタンドアロン（必要な場合）
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+## オプション
+
+```ts
+import type { IntlayerProxyPluginOptions } from "vite-intlayer";
+```
+
+すべてのオプションは任意であり、単一のオブジェクトとして渡されます：
+
+| オプション      | 型                                  | 説明                                                                                                                                                         |
+| --------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `ignore`        | `(req: IncomingMessage) => boolean` | リクエストを言語ルーティングから除外する述語。リクエストをスキップするには`true`を返します（例：APIルート、ヘルスチェック）。                                |
+| `configOptions` | `GetConfigurationOptions`           | `getConfiguration()`に転送されるIntlayer設定のオーバーライド。プロキシに特定の設定ファイルを読み込ませたり、値を上書きしたりする必要がある場合に使用します。 |
+
+### 例
+
+```ts
+intlayerProxy({
+  ignore: (req) => req.url?.startsWith("/api"),
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+});
+```
+
+## createIntlayerProxyHandler
+
+`createIntlayerProxyHandler`は、すべての言語ルーティングロジックを含む、特定のフレームワークに依存しないNode.jsの`(req, res, next)`スタンドアロンミドルウェアを作成します。ViteプラグインAPIが使用できない環境（例：純粋なNode.jsサーバーやカスタムNitroモジュール）で有用です。
+
+```ts
+import { createIntlayerProxyHandler } from "vite-intlayer";
+
+const handler = createIntlayerProxyHandler({
+  ignore: (req) => req.url?.startsWith("/api"),
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+});
+
+// Express / Connect
+app.use(handler);
+```
+
+### 本番SSR（TanStack Start / h3を介した Nitro）
+
+```ts
+// server/middleware/intlayerProxy.ts
+import { fromNodeMiddleware } from "h3";
+import { createIntlayerProxyHandler } from "vite-intlayer";
+
+export default fromNodeMiddleware(
+  createIntlayerProxyHandler({
+    ignore: (req) => req.url?.startsWith("/api"),
+  })
+);
+```
+
+## ルーティングの動作
+
+ミドルウェアは、`next-intlayer`ミドルウェアのルーティングロジックを反映しており、すべてのIntlayerルーティングモードをサポートしています。
+
+### ルーティングモード
+
+| モード          | ブラウザに表示されるURL  | 動作                                                                                                                                |
+| --------------- | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
+| `prefix`        | `/ja/about`              | デフォルト。URLの言語プレフィックス。`prefix-all`が有効でない限り、デフォルト言語はプレフィックスなしのURLにリダイレクトします。    |
+| `prefix-all`    | `/en/about`, `/ja/about` | デフォルト言語を含むすべての言語が常にプレフィックス付きになります。                                                                |
+| `no-prefix`     | `/about`                 | URLに言語は含まれません。言語はCookieにのみ保存され、内部的にURLの書き換えが行われます。                                            |
+| `search-params` | `/about?locale=ja`       | クエリパラメータとして渡される言語。パラメータがない、または古い場合に、`locale`パラメータを追加/更新するためにリダイレクトします。 |
+
+### 検出の優先順位
+
+1. URLパスのプレフィックス（例：`/ja/about` → `ja`）。
+2. Cookie / localStorageの値（`intlayer-locale`）。
+3. `Accept-Language`ヘッダー。
+4. 設定ファイル内の`defaultLocale`。
+
+### 自動バイパス
+
+ミドルウェアは、言語処理を行うことなく、常に以下のリクエストをそのまま通します：
+
+- `ignore`述語に一致するリクエスト。
+- `/node_modules/**`
+- `/@**` – Viteの内部処理（`@vite/`、`@fs/`、`@id/`など）。
+- `/_**` – サーバーの内部処理（`__vite_ping`、`__manifest`など）。
+- パスがファイル拡張子で終わるリクエスト（静的アセット）。静的アセットのパスに言語プレフィックスが存在する場合（例：`/ja/logo.png`）、ファイルが正しく提供されるようにプレフィックスが削除されます。
+
+### ドメインルーティング
+
+Intlayer設定で`routing.domains`が構成されている場合、ミドルウェアはドメインをまたぐ言語ルーティングを処理します：
+
+- `domains.zh = "intlayer.zh"`のとき、`intlayer.org`上の`/zh/about`に対するリクエストは`https://intlayer.zh/about`にリダイレクトされます。
+- `intlayer.zh/about`へのリクエストは、`[locale]`ルートパラメータが入力されるように、内部的に`/zh/about`に書き換えられます。
+
+### リダイレクトループ防止
+
+ミドルウェアは、2秒のスライディングウィンドウ内で、`originalUrl → newUrl`のペアごとのリクエストに対するリダイレクト回数を追跡します。ウィンドウ内で10回を超えるリダイレクトが発生した場合、無限ループに陥るのを防ぐために、説明的なエラーを含む`500`応答を返します。
+
+## Nitro / 本番SSR（自動注入、v9+）
+
+`intlayerProxy`がViteプラグインとして使用される場合、`.nitro`プロパティを保持します。`nitro/vite`ビルドプラグインはこのプロパティを読み取り、`nitroConfig.modules`にプッシュします。これにより、`intlayerNitroHandler`が自動的にNitroサーバーミドルウェアとして登録されます。本番SSRのための手動設定は不要です。
+
+Nitroハンドラーは、h3 v2のWeb Fetch APIイベントモデルを使用しているため（`fromNodeMiddleware`ではない）、Node、Bun、Deno、エッジランタイムなど、すべてのNitroプリセットと互換性があります。
+
+## 非推奨のエイリアス
+
+| 非推奨のシグネチャ         | 代替品          |
+| -------------------------- | --------------- |
+| `intlayerMiddleware`       | `intlayerProxy` |
+| `intLayerMiddlewarePlugin` | `intlayerProxy` |

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

@@ -14,6 +14,9 @@ slugs:
   - vue-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathnameユーティリティを追加"
   - version: 8.0.0
     date: 2026-01-21
     changes: "すべてのエクスポートのドキュメントを統一"
@@ -59,6 +62,7 @@ import "vue-intlayer";
 | `useDictionaryAsync`   | `useDictionary` と同様ですが、非同期の辞書を処理します。                                                                                | -                                                                                                                     |
 | `useDictionaryDynamic` | `useDictionary` と同様ですが、動的な辞書を処理します。                                                                                  | -                                                                                                                     |
 | `useLocale`            | 現在のロケールと、それを設定する関数を返します。                                                                                        | -                                                                                                                     |
+| `usePathname`          | ロケールセグメントが削除された現在のパス名 (pathname) を `ComputedRef<string>` として返します。`popstate` に反応します。                | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/vue-intlayer/usePathname.md)     |
 | `useRewriteURL`        | URL の書き換えを管理するクライアントサイドのコンポーザブル。ローカライズされた書き換えルールが存在する場合は自動的に URL を更新します。 | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/vue-intlayer/useRewriteURL.md) |
 | `useIntl`              | 現在のロケールの Intl オブジェクトを返します。                                                                                          | -                                                                                                                     |
 | `useLoadDynamic`       | 動的辞書を読み込むためのコンポーザブル。                                                                                                | -                                                                                                                     |