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

package/docs/ja/migration_from_next-i18next_to_intlayer.md

@@ -101,24 +101,40 @@ AIプロバイダーのコストで、お好みのLLMを使用してCI/CDパイ
 
 Intlayerのコアパッケージと互換性アダプターをインストールします：
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> `--interactive` フラグはオプションです。AI エージェントの場合は `intlayer-cli init` を使用してください。
+
+> このコマンドは環境を検出し、必要なパッケージをインストールします。例えば：
+
 ```bash packageManager="npm"
 npm install intlayer next-intlayer react-intlayer @intlayer/next-i18next @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer next-intlayer react-intlayer @intlayer/next-i18next @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer next-intlayer react-intlayer @intlayer/next-i18next @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer next-intlayer react-intlayer @intlayer/next-i18next @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > 移行中は`next-i18next`、`react-i18next`、および`i18next`を安全にインストールしたままにしておけます（エイリアスが設定されたら削除します）。

package/docs/ja/migration_from_next-intl_to_intlayer.md

@@ -97,24 +97,40 @@ AIプロバイダーのコストで、お好みのLLMを使用してCI/CDパイ
 
 Intlayerのコアパッケージと互換性アダプター`@intlayer/next-intl`をインストールします：
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> `--interactive` フラグはオプションです。AI エージェントの場合は `intlayer-cli init` を使用してください。
+
+> このコマンドは環境を検出し、必要なパッケージをインストールします。例えば：
+
 ```bash packageManager="npm"
 npm install intlayer next-intlayer @intlayer/next-intl @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer next-intlayer @intlayer/next-intl @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer next-intlayer @intlayer/next-intl @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer next-intlayer @intlayer/next-intl @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > `next-intl`はインストールしたままにしておいてください — **URLルーティング** (`createNavigation`、`createMiddleware`、`Link`、`redirect`、`usePathname`、`useRouter`) のために引き続き必要です。互換性アダプターはルーティングレイヤーを置き換え**ません**。

package/docs/ja/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -100,24 +100,40 @@ AIプロバイダーのコストで、お好みのLLMを使用してCI/CDパイ
 
 Intlayerのコアパッケージと互換性アダプターをインストールします：
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> `--interactive` フラグはオプションです。AI エージェントの場合は `intlayer-cli init` を使用してください。
+
+> このコマンドは環境を検出し、必要なパッケージをインストールします。例えば：
+
 ```bash packageManager="npm"
 npm install intlayer vue-intlayer nuxt-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer vue-intlayer nuxt-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer vue-intlayer nuxt-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer vue-intlayer nuxt-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > 移行中は`@nuxtjs/i18n`を安全にインストールしたままにしておけます（後でNuxtの設定から削除します）。

package/docs/ja/migration_from_react-i18next_to_intlayer.md

@@ -100,24 +100,40 @@ AIプロバイダーのコストで、お好みのLLMを使用してCI/CDパイ
 
 Intlayerのコアパッケージと互換性アダプターをインストールします：
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> `--interactive` フラグはオプションです。AI エージェントの場合は `intlayer-cli init` を使用してください。
+
+> このコマンドは環境を検出し、必要なパッケージをインストールします。例えば：
+
 ```bash packageManager="npm"
 npm install intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > `react-i18next`と`i18next`はインストールしたままにしておいて構いません — 互換性アダプターはそれらをTypeScriptの型のオプションの`devDependencies` / `peerDependencies`として使用します。`package.json`のpeer設定を変更する必要はありません。

package/docs/ja/migration_from_vue-i18n_to_intlayer.md

@@ -99,24 +99,40 @@ AIプロバイダーのコストで、お好みのLLMを使用してCI/CDパイ
 
 Intlayerのコアパッケージと互換性アダプターをインストールします：
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> `--interactive` フラグはオプションです。AI エージェントの場合は `intlayer-cli init` を使用してください。
+
+> このコマンドは環境を検出し、必要なパッケージをインストールします。例えば：
+
 ```bash packageManager="npm"
 npm install intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > `vue-i18n`はインストールしたままにしておいて構いません — 互換性アダプターはそれをTypeScriptの型の`devDependency` / `peerDependency`として使用します。

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

@@ -14,6 +14,9 @@ slugs:
   - angular-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname ユーティリティの追加"
   - version: 8.0.0
     date: 2026-01-21
     changes: "すべてのエクスポートに対するドキュメントを統一"
@@ -46,15 +49,16 @@ import "angular-intlayer";
 
 ### フック
 
-| フック                 | 説明                                                                                             | 関連ドキュメント |
-| ---------------------- | ------------------------------------------------------------------------------------------------ | ---------------- |
-| `useIntlayer`          | `useDictionary` に基づいていますが、生成された宣言から辞書の最適化されたバージョンを注入します。 | -                |
-| `useDictionary`        | 辞書（key、content）のようなオブジェクトを処理します。`t()` の翻訳や列挙、その他を処理します。   | -                |
-| `useDictionaryAsync`   | `useDictionary` と同様ですが、非同期の辞書を扱います。                                           | -                |
-| `useDictionaryDynamic` | `useDictionary` と同様ですが、動的な辞書を扱います。                                             | -                |
-| `useLocale`            | 現在のロケールとそれを設定する関数を返します。                                                   | -                |
-| `useIntl`              | 現在のロケールに対応する Intl オブジェクトを返します。                                           | -                |
-| `useLoadDynamic`       | 動的辞書を読み込むためのフック。                                                                 | -                |
+| フック                 | 説明                                                                                                                        | 関連ドキュメント                                                                                                      |
+| ---------------------- | --------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`          | `useDictionary` に基づいていますが、生成された宣言から辞書の最適化されたバージョンを注入します。                            | -                                                                                                                     |
+| `useDictionary`        | 辞書（key、content）のようなオブジェクトを処理します。`t()` の翻訳や列挙、その他を処理します。                              | -                                                                                                                     |
+| `useDictionaryAsync`   | `useDictionary` と同様ですが、非同期の辞書を扱います。                                                                      | -                                                                                                                     |
+| `useDictionaryDynamic` | `useDictionary` と同様ですが、動的な辞書を扱います。                                                                        | -                                                                                                                     |
+| `useLocale`            | 現在のロケールとそれを設定する関数を返します。                                                                              | -                                                                                                                     |
+| `usePathname`          | ロケールセグメントが削除された現在のパス名を `Signal<string>` として返します。`DestroyRef` 経由で `popstate` に反応します。 | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/angular-intlayer/usePathname.md) |
+| `useIntl`              | 現在のロケールに対応する Intl オブジェクトを返します。                                                                      | -                                                                                                                     |
+| `useLoadDynamic`       | 動的辞書を読み込むためのフック。                                                                                            | -                                                                                                                     |
 
 ### コンポーネント
 

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

@@ -0,0 +1,119 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: usePathname Hook ドキュメント | angular-intlayer
+description: angular-intlayer パッケージでの usePathname フックの使用方法について
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internationalization
+  - Documentation
+  - Angular
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - angular-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname ユーティリティの追加"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "履歴の初期化"
+author: aymericzip
+---
+
+# Angular 統合: `usePathname` Hook ドキュメント
+
+`usePathname` フックは、ロケールセグメントが削除された現在のブラウザのパス名を、Angular の `Signal<string>` として返します。これは、ロケールのプレフィックスを手動で削除することなく、例えばどのナビゲーション項目がアクティブであるかを判別するなど、ロケールを意識したナビゲーションを構築する際に役立ちます。
+
+## Angular での `usePathname` のインポート
+
+```typescript
+import { usePathname } from "angular-intlayer";
+```
+
+## 概要
+
+`usePathname` は `window.location.pathname` を読み取り、`getPathWithoutLocale` を使用してロケールのプレフィックスを削除し、ブラウザが `popstate` イベント（戻る/進むナビゲーション）を発生させるたびにシグナルを更新します。コンポーネントが破棄された際に自動的にイベントリスナーをクリーンアップするため、Angular の `DestroyRef` を使用しています。
+
+## 使用方法
+
+```typescript fileName="src/app/nav-item.component.ts"
+import { Component, input } from "@angular/core";
+import { usePathname } from "angular-intlayer";
+
+@Component({
+  standalone: true,
+  selector: "app-nav-item",
+  template: `
+    <a
+      [href]="href()"
+      [attr.aria-current]="pathname() === href() ? 'page' : null"
+    >
+      {{ label() }}
+    </a>
+  `,
+})
+export class NavItemComponent {
+  readonly href = input.required<string>();
+  readonly label = input.required<string>();
+
+  readonly pathname = usePathname();
+}
+```
+
+## 戻り値
+
+| タイプ           | 説明                                                                      |
+| ---------------- | ------------------------------------------------------------------------- |
+| `Signal<string>` | ロケールプレフィックスを含まない現在のパス名を保持する Angular シグナル。 |
+
+## 動作
+
+- **ロケールの削除**: 先頭のロケールセグメントを削除します（例: `/ja/dashboard` → `/dashboard`）。
+- **リアクティブ**: `popstate` イベント（ブラウザの戻る / 進む操作）時に自動で更新されます。
+- **SSR セーフ**: `window` が利用できない場合は `""` を返します。
+- **クリーンアップ**: ホストコンポーネントが破棄されると、`DestroyRef.onDestroy` を介して `popstate` リスナーが削除されます。
+
+## 例
+
+```typescript fileName="src/app/sidebar.component.ts"
+import { Component } from "@angular/core";
+import { usePathname } from "angular-intlayer";
+
+@Component({
+  standalone: true,
+  selector: "app-sidebar",
+  template: `
+    <nav>
+      @for (link of links; track link.href) {
+        <a
+          [href]="link.href"
+          [style.font-weight]="pathname() === link.href ? 'bold' : 'normal'"
+        >
+          {{ link.label }}
+        </a>
+      }
+    </nav>
+  `,
+})
+export class SidebarComponent {
+  readonly links = [
+    { href: "/dashboard", label: "ダッシュボード" },
+    { href: "/settings", label: "設定" },
+  ];
+
+  readonly pathname = usePathname();
+}
+```
+
+## 関連情報
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/angular-intlayer/exports.md) — 現在のロケール + ロケールスイッチャー
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getPathWithoutLocale.md) — このフックで内部的に使用されているユーティリティ

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

@@ -0,0 +1,173 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: comparePaths 関数のドキュメント | intlayer
+description: intlayer パッケージの comparePaths 関数の使い方を学びます
+keywords:
+  - comparePaths
+  - normalizePath
+  - アクティブリンク
+  - ナビゲーション
+  - Intlayer
+  - intlayer
+  - 国際化
+  - ドキュメント
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - comparePaths
+history:
+  - version: 9.0.0
+    date: 2026-06-22
+    changes: "初期ドキュメント"
+author: aymericzip
+---
+
+# ドキュメント: `intlayer` の `comparePaths` 関数
+
+## 概要
+
+`comparePaths` 関数は、ロケールセグメント、プロトコル/ホスト、クエリ文字列、ハッシュ、および末尾のスラッシュを無視して、2つの URL またはパス名が等しいかどうかを比較します。これは、ナビゲーションリンクが現在のページを指しているかどうか（例：アクティブリンクをハイライトする）を判定するための推奨される方法であり、独自に（エラーを起こしやすい）正規化ロジックを作成する必要がありません。
+
+内部的には [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getPathWithoutLocale.md) を再利用してロケールセグメントを削除するため、設定されたルーティングモードとロケールを尊重します。
+
+パッケージはまた、比較に使用されるロケールに依存しない正規化されたパス名を返す基盤ヘルパーである [`normalizePath`](#normalizepath) をエクスポートします。
+
+**主な特徴：**
+
+- ロケールに依存しない比較（`/ja/about` は `/about` と一致します）
+- 絶対 URL と相対パスの両方で動作
+- クエリ文字列、ハッシュ、および末尾のスラッシュを無視
+- 先頭のスラッシュの欠落や空の値を許容（`/` に正規化）
+- 軽量 — `getPathWithoutLocale` の上に構築されています
+
+---
+
+## 関数シグネチャ
+
+```typescript
+comparePaths(
+  pathname: string,  // 必須
+  href: string,      // 必須
+  locales?: Locales[] // オプション
+): boolean
+
+normalizePath(
+  inputUrl: string,   // 必須
+  locales?: Locales[] // オプション
+): string
+```
+
+---
+
+## パラメーター
+
+- `pathname: string`
+  - **説明**: 比較する最初の URL 文字列またはパス名（通常は現在のパス）。
+  - **型**: `string`
+  - **必須**: はい
+
+- `href: string`
+  - **説明**: 比較する2番目の URL 文字列またはパス名（通常はナビゲーションリンクの `href`）。
+  - **型**: `string`
+  - **必須**: はい
+
+- `locales: Locales[]`
+  - **説明**: サポートされているロケールのオプションの配列。デフォルトではプロジェクトで設定されたロケールになります。
+  - **型**: `Locales[]`
+  - **必須**: いいえ (オプション)
+
+### 戻り値
+
+- **型**: `boolean`
+- **説明**: 両方の入力が同じロケールに依存しないパスに解決される場合は `true`、そうでない場合は `false`。
+
+---
+
+## 使用例
+
+### 基本的な使用法
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { comparePaths } from "intlayer";
+
+comparePaths("/ru/path", "/path"); // true
+comparePaths("/ru/path/", "/path"); // true
+comparePaths("/ru/path", "/path/"); // true
+comparePaths("/ru/", "/"); // true
+comparePaths("/ru", "/"); // true
+comparePaths("ru/path", "/path"); // true
+comparePaths("", "/"); // true
+comparePaths("/ru", ""); // true
+comparePaths("/ru/path", "/other"); // false
+```
+
+### 絶対URLと相対URL
+
+```typescript
+import { comparePaths } from "intlayer";
+
+comparePaths("https://example.com/ru/path", "/path"); // true
+```
+
+### アクティブなナビゲーションリンクのハイライト
+
+```tsx
+import { comparePaths } from "intlayer";
+import { useLocation } from "react-router";
+
+const NavLink = ({ href, children }) => {
+  const { pathname } = useLocation();
+  const isActive = comparePaths(pathname, href);
+
+  return (
+    <a href={href} aria-current={isActive ? "page" : undefined}>
+      {children}
+    </a>
+  );
+};
+```
+
+---
+
+## normalizePath
+
+`normalizePath` は `comparePaths` で使用されるロケールに依存しない正規パスを返します。ロケールセグメント、プロトコル/ホスト、クエリ文字列、ハッシュを削除し、先頭のスラッシュを1つだけに保ち、末尾のスラッシュ（ルートを除く）を削除し、空の値に対しては `/` にフォールバックします。
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { normalizePath } from "intlayer";
+
+normalizePath("/ru/path"); // "/path"
+normalizePath("/ru/path/"); // "/path"
+normalizePath("ru/path"); // "/path"
+normalizePath("/ru/"); // "/"
+normalizePath("/ru"); // "/"
+normalizePath(""); // "/"
+normalizePath("https://example.com/ru/path"); // "/path"
+```
+
+---
+
+## 関連関数
+
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getPathWithoutLocale.md): URL やパス名からロケールセグメントを削除します。
+- [`getPrefix`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getPrefix.md): 指定したロケールの URL プレフィックスを決定します。
+- [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getLocalizedUrl.md): 特定のロケールのローカライズされた URL を生成します。
+
+---
+
+## TypeScript
+
+```typescript
+function normalizePath(inputUrl: string, locales?: Locales[]): string;
+
+function comparePaths(
+  pathname: string,
+  href: string,
+  locales?: Locales[]
+): boolean;
+```

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

@@ -14,6 +14,9 @@ slugs:
   - intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-23
+    changes: "comparePaths ユーティリティを追加"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Unified documentation for all exports"
@@ -119,6 +122,8 @@ import "intlayer";
 | `getMultilingualUrls`  | `Function` | サポートされているすべてのロケールのURLを生成します。        | [getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getMultilingualUrls.md)   |
 | `getPathWithoutLocale` | `Function` | パスからロケールプレフィックスを削除します。                 | [getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getPathWithoutLocale.md) |
 | `getPrefix`            | `Function` | パスからロケールプレフィックスを取得します。                 | [getPrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getPrefix.md)                       |
+| `comparePaths`         | `Function` | ロケールを無視して 2 つのパスを比較します。                  | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/comparePaths.md)                 |
+| `normalizePath`        | `Function` | パスをロケールに依存しないパスに正規化します。               | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/comparePaths.md)                 |
 | `getHTMLTextDir`       | `Function` | テキストの方向（LTR/RTL）を取得します。                      | [getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getHTMLTextDir.md)             |
 | `validatePrefix`       | `Function` | ロケールプレフィックスを検証します。                         | [validatePrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/validatePrefix.md)             |
 

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

@@ -15,6 +15,9 @@ slugs:
   - next-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname ユーティリティを追加"
   - version: 8.0.0
     date: 2026-01-21
     changes: "すべてのエクスポートに関するドキュメントを統一"
@@ -95,6 +98,7 @@ import "next-intlayer";
 | `useDictionaryAsync`   | 非同期辞書を扱うフック。Promiseベースの辞書マップを受け取り、現在のロケール向けに解決します。                                               | -                                                                                                                       |
 | `useDictionaryDynamic` | キーで読み込まれる動的辞書を扱うフック。読み込み状態のために内部で React Suspense を使用します。                                            | -                                                                                                                       |
 | `useLocale`            | 現在のロケールを取得し、それを設定する関数を返すクライアントサイドフック。Next.js App Router 向けにナビゲーション対応で拡張されています。   | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/react-intlayer/useLocale.md)         |
+| `usePathname`          | ロケールプレフィックスとロケールパラメータを取り除いたクエリパラメータを含まない現在のパス名を返します。                                    | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/next-intlayer/usePathname.md)      |
 | `useRewriteURL`        | URL のリライトを管理するクライアントサイドフック。より見栄えの良いローカライズされたリライトルールが存在する場合に自動で URL を更新します。 | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/next-intlayer/useRewriteURL.md)  |
 | `useLocalePageRouter`  | Next.js の Page Router 用のロケール管理フック。ロケール変更時のリダイレクトやページ再読み込みを処理します。                                 | -                                                                                                                       |
 | `useI18n`              | キーでネストされたコンテンツにアクセスするための翻訳関数 `t()` を提供するフック。i18next/next-intl のパターンに似ています。                 | [useI18n](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/react-intlayer/useI18n.md)             |