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

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)             |

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

@@ -0,0 +1,136 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: usePathname フック ドキュメント | next-intlayer
+description: next-intlayer パッケージの usePathname フックの使用方法を学びます
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internationalization
+  - Documentation
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - next-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname ユーティリティを追加"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "履歴の初期化"
+author: aymericzip
+---
+
+# Next.js 統合: `usePathname` フック ドキュメント
+
+`usePathname` フックは、ロケールセグメントが取り除かれた現在の Next.js のパス名（pathname）を返します。これは、ロケールプレフィックスを手動で削除することなく、ロケールを考慮したナビゲーション（たとえば、どのナビゲーション項目がアクティブかを判断するなど）を構築するのに役立ちます。
+
+## Next.js で `usePathname` をインポートする
+
+```typescript
+import { usePathname } from "next-intlayer";
+```
+
+## 概要
+
+`usePathname` は、`next/navigation` からの Next.js 組み込みの `usePathname()` をラップし、検索パラメータ (search params) を追加し、`getPathWithoutLocale` を介してロケールプレフィックスを削除します。クライアント側のナビゲーションごとに再レンダリングをトリガーします。このフックはクライアントコンポーネント内でのみ使用できます（`"use client"` が必要です）。
+
+## 使用法
+
+```tsx fileName="src/components/NavItem.tsx" codeFormat={["typescript", "esm"]}
+"use client";
+
+import type { FC } from "react";
+import { usePathname } from "next-intlayer";
+
+type NavItemProps = {
+  href: string;
+  label: string;
+};
+
+const NavItem: FC<NavItemProps> = ({ href, label }) => {
+  const pathname = usePathname();
+  const isActive = pathname === href;
+
+  return (
+    <a href={href} aria-current={isActive ? "page" : undefined}>
+      {label}
+    </a>
+  );
+};
+
+export default NavItem;
+```
+
+## 戻り値
+
+| 型       | 説明                                                                                           |
+| -------- | ---------------------------------------------------------------------------------------------- |
+| `string` | ロケールプレフィックスとロケールパラメータを取り除いたクエリパラメータを含まない現在のパス名。 |
+
+## 動作
+
+- **ロケールの削除**: 先頭のロケールセグメントを取り除きます（例: `/ja/dashboard` → `/dashboard`）。
+- **検索パラメータの削除**: 検索パラメータベースのルーティングモードを使用している場合、`?locale=...` のクエリパラメータも削除します。
+- **リアクティブ**: Next.js App Router 経由でのクライアント側のナビゲーションが行われるたびに更新されます。
+- **SSR セーフ**: 初回レンダリング時にはサーバー側のパス名を返し、その後クライアント側で検索パラメータを同期します。
+
+## `useLocale` との比較
+
+`next-intlayer` の `useLocale` は、すでに戻り値の一部として `pathWithoutLocale` を公開しています。パス名のみが必要で、ロケール切り替え機能が不要な場合は、`usePathname` を使用してください。
+
+```tsx codeFormat={["typescript", "esm"]}
+// ロケール状態とパスの両方が必要な場合:
+import { useLocale } from "next-intlayer";
+const { locale, pathWithoutLocale } = useLocale();
+
+// パスのみが必要な場合:
+import { usePathname } from "next-intlayer";
+const pathname = usePathname();
+```
+
+## 例
+
+```tsx fileName="src/components/Sidebar.tsx" codeFormat={["typescript", "esm"]}
+"use client";
+
+import type { FC } from "react";
+import { usePathname } from "next-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "ダッシュボード" },
+  { href: "/settings", label: "設定" },
+];
+
+const Sidebar: FC = () => {
+  const pathname = usePathname();
+
+  return (
+    <nav>
+      {links.map(({ href, label }) => (
+        <a
+          key={href}
+          href={href}
+          style={{ fontWeight: pathname === href ? "bold" : "normal" }}
+        >
+          {label}
+        </a>
+      ))}
+    </nav>
+  );
+};
+
+export default Sidebar;
+```
+
+## 関連
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/next-intlayer/useLocale.md) — 現在のロケール + ロケールスイッチャー（`pathWithoutLocale` も公開）
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getPathWithoutLocale.md) — このフックで使用される基礎的なユーティリティ

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

@@ -14,6 +14,9 @@ slugs:
   - preact-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathnameユーティリティを追加"
   - version: 8.0.0
     date: 2026-01-21
     changes: "すべてのエクスポートに関するドキュメントを統合"
@@ -40,12 +43,13 @@ npm install preact-intlayer
 
 ### フック
 
-| フック          | 説明                                                                                                                           | 関連ドキュメント                                                                                |
-| --------------- | ------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------- |
-| `useIntlayer`   | `useDictionary` をベースにしていますが、生成された宣言から最適化された辞書のバージョンを注入します。                           | -                                                                                               |
-| `useDictionary` | キーとコンテンツ（key, content）のような辞書的なオブジェクトを処理します。`t()` の翻訳、enumerations（列挙）などを処理します。 | -                                                                                               |
-| `useLocale`     | 現在のロケールとそれを設定する関数を返します。                                                                                 | -                                                                                               |
-| `t`             | 現在のロケールに基づいてコンテンツを選択します。                                                                               | [翻訳](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/translation.md) |
+| フック          | 説明                                                                                                                           | 関連ドキュメント                                                                                                     |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | `useDictionary` をベースにしていますが、生成された宣言から最適化された辞書のバージョンを注入します。                           | -                                                                                                                    |
+| `useDictionary` | キーとコンテンツ（key, content）のような辞書的なオブジェクトを処理します。`t()` の翻訳、enumerations（列挙）などを処理します。 | -                                                                                                                    |
+| `useLocale`     | 現在のロケールとそれを設定する関数を返します。                                                                                 | -                                                                                                                    |
+| `usePathname`   | ロケールセグメントが削除された現在のパス名 (pathname) を返すフックです。ブラウザのナビゲーション（`popstate`）に反応します。   | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/preact-intlayer/usePathname.md) |
+| `t`             | 現在のロケールに基づいてコンテンツを選択します。                                                                               | [翻訳](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/translation.md)                      |
 
 ### コンポーネント
 

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

@@ -0,0 +1,117 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: usePathname フックのドキュメント | preact-intlayer
+description: preact-intlayer パッケージの usePathname フックの使用方法について
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - 国際化
+  - ドキュメント
+  - Preact
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - preact-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathnameユーティリティを追加"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "履歴の初期化"
+author: aymericzip
+---
+
+# Preact 統合: `usePathname` フックのドキュメント
+
+`usePathname` フックは、ロケールセグメントが削除された現在のブラウザパス名（pathname）を返します。これは、ロケールプレフィックスを手動で削除することなく、ロケールを考慮したナビゲーション（例：どのナビゲーションアイテムがアクティブかを判定する）を構築するのに役立ちます。
+
+## Preact での `usePathname` のインポート
+
+```typescript
+import { usePathname } from "preact-intlayer";
+```
+
+## 概要
+
+`usePathname` は `window.location.pathname` を読み取り、`getPathWithoutLocale` 経由でロケールプレフィックスを削除します。ブラウザが `popstate` イベント（戻る/進む ナビゲーション）を発生させるたびにコンポーネントを再レンダリングします。サーバーサイドレンダリング（SSR）中は空の文字列を返します。
+
+## 使用方法
+
+```tsx fileName="src/components/NavItem.tsx"
+import type { FunctionComponent } from "preact";
+import { usePathname } from "preact-intlayer";
+
+type NavItemProps = {
+  href: string;
+  label: string;
+};
+
+const NavItem: FunctionComponent<NavItemProps> = ({ href, label }) => {
+  const pathname = usePathname();
+  const isActive = pathname === href;
+
+  return (
+    <a href={href} aria-current={isActive ? "page" : undefined}>
+      {label}
+    </a>
+  );
+};
+
+export default NavItem;
+```
+
+## 戻り値
+
+| 型       | 説明                                                                                                      |
+| -------- | --------------------------------------------------------------------------------------------------------- |
+| `string` | ロケールプレフィックスを含まない現在のパス名。サーバーサイドレンダリング（SSR）中は空の文字列を返します。 |
+
+## 動作
+
+- **ロケールの削除 (Locale stripping)**: 先頭のロケールセグメントを削除します（例：`/ja/dashboard` → `/dashboard`）。
+- **リアクティブ**: ブラウザの戻る / 進むナビゲーション（`popstate` イベント）時に自動的に更新されます。
+- **SSR セーフ**: `window` が利用できない場合は `""` を返します。
+- **クリーンアップ**: コンポーネントのアンマウント時に、`popstate` リスナーは自動的に削除されます。
+
+## 例
+
+```tsx fileName="src/components/Sidebar.tsx"
+import type { FunctionComponent } from "preact";
+import { usePathname } from "preact-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "ダッシュボード" },
+  { href: "/settings", label: "設定" },
+];
+
+const Sidebar: FunctionComponent = () => {
+  const pathname = usePathname();
+
+  return (
+    <nav>
+      {links.map(({ href, label }) => (
+        <a
+          key={href}
+          href={href}
+          style={{ fontWeight: pathname === href ? "bold" : "normal" }}
+        >
+          {label}
+        </a>
+      ))}
+    </nav>
+  );
+};
+
+export default Sidebar;
+```
+
+## 関連ドキュメント
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/preact-intlayer/exports.md) — 現在のロケールとロケールスイッチャー
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getPathWithoutLocale.md) — このフックで使われているベースのユーティリティ

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

@@ -14,9 +14,12 @@ slugs:
   - react-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathnameユーティリティを追加"
   - version: 7.5.14
     date: 2026-01-21
-    changes: "全エクスポートのドキュメントを統一"
+    changes: "すべてのエクスポートのドキュメントを統一"
 author: aymericzip
 ---
 
@@ -54,21 +57,23 @@ import "react-intlayer";
 import "react-intlayer";
 ```
 
-| フック | 説明 | 関連ドキュメント |
-| `useIntlayer` | クライアントサイドのフックで、キーで辞書を選択してその内容を返します。指定がなければコンテキストのロケールを使用します。 | [useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/react-intlayer/useIntlayer.md) |
-| `useDictionary` | 辞書オブジェクトを変換し、現在のロケール向けのコンテンツを返すフック。`t()` の翻訳、列挙型（enums）などを処理します。 | [useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/react-intlayer/useDictionary.md) |
-| `useDictionaryAsync` | 非同期の辞書を扱うフック。Promise ベースの辞書マップを受け取り、現在のロケール向けに解決します。 | - |
-| `useDictionaryDynamic` | キーでロードされる動的な辞書を扱うフック。内部で React Suspense を使用してロード状態を処理します。 | - |
-| `useLocale` | クライアントサイドのフック。現在のロケール、デフォルトロケール、利用可能なロケール、およびロケールを更新する関数を取得します。 | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/react-intlayer/useLocale.md) |
-| `useLocaleBase` | コンテキストから現在のロケールと関連するすべてのフィールド（locale、defaultLocale、availableLocales、setLocale）を取得するフック。 | - |
-| `useRewriteURL` | URL書き換えを管理するクライアントサイドのフック。現在のパス名とロケールに対する書き換えルールが存在する場合、URLを更新します。 | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/react-intlayer/useRewriteURL.md) |
-| `useI18n` | フック。キーでネストされたコンテンツにアクセスするための翻訳関数 `t()` を提供します。i18next/next-intl のパターンを模倣しています。 | [useI18n](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/react-intlayer/useI18n.md) |
-| `useIntl` | フック。ロケールに結びついた `Intl` オブジェクトを提供します。現在のロケールを自動で注入し、最適化されたキャッシュを使用します。 | - |
-| `useLocaleStorage` | ローカルストレージまたはクッキーで locale の永続化を提供するフック。getter と setter 関数を返します。 | - |
-| `useLocaleCookie` | 非推奨。代わりに `useLocaleStorage` を使用してください。クッキーで locale の永続化を管理するフック。 | - |
-| `useLoadDynamic` | React Suspenseを使用して動的辞書を読み込むためのフック。キーとPromiseを受け取り、結果をキャッシュします。 | - |
-| `useIntlayerContext` | 現在の Intlayer クライアントのコンテキスト値（locale、setLocale など）を提供するフック。 | - |
-| `useHTMLContext` | HTMLProvider コンテキストから HTML コンポーネントのオーバーライドにアクセスするフック。 | - |
+| フック                 | 説明                                                                                                                                     | 関連ドキュメント                                                                                                        |
+| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`          | クライアントサイドのフックで、キーで辞書を選択してその内容を返します。指定がなければコンテキストのロケールを使用します。                 | [useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/react-intlayer/useIntlayer.md)     |
+| `useDictionary`        | 辞書オブジェクトを変換し、現在のロケール向けのコンテンツを返すフック。`t()` の翻訳、列挙型（enums）などを処理します。                    | [useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/react-intlayer/useDictionary.md) |
+| `useDictionaryAsync`   | 非同期の辞書を扱うフック。Promise ベースの辞書マップを受け取り、現在のロケール向けに解決します。                                         | -                                                                                                                       |
+| `useDictionaryDynamic` | キーでロードされる動的な辞書を扱うフック。内部で React Suspense を使用してロード状態を処理します。                                       | -                                                                                                                       |
+| `useLocale`            | 現在のロケール、デフォルトロケール、利用可能なロケール、およびロケールを更新する機能を取得するためのクライアントサイドフック。           | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/react-intlayer/useLocale.md)         |
+| `useLocaleBase`        | コンテキストから現在のロケールと関連するすべてのフィールド（locale、defaultLocale、availableLocales、setLocale）を取得するためのフック。 | -                                                                                                                       |
+| `usePathname`          | ロケールセグメントが削除された現在のパス名を返すフック。`popstate`を介したブラウザナビゲーションに反応します。                           | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/react-intlayer/usePathname.md)     |
+| `useRewriteURL`        | URLの書き換えを管理するためのクライアントサイドフック。現在のパス名とロケールの書き換えルールが存在する場合、URLを更新します。           | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/react-intlayer/useRewriteURL.md) |
+| `useI18n`              | フック。キーでネストされたコンテンツにアクセスするための翻訳関数 `t()` を提供します。i18next/next-intl のパターンを模倣しています。      | [useI18n](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/react-intlayer/useI18n.md)             |
+| `useIntl`              | フック。ロケールに結びついた `Intl` オブジェクトを提供します。現在のロケールを自動で注入し、最適化されたキャッシュを使用します。         | -                                                                                                                       |
+| `useLocaleStorage`     | ローカルストレージまたはクッキーで locale の永続化を提供するフック。getter と setter 関数を返します。                                    | -                                                                                                                       |
+| `useLocaleCookie`      | 非推奨。代わりに `useLocaleStorage` を使用してください。クッキーで locale の永続化を管理するフック。                                     | -                                                                                                                       |
+| `useLoadDynamic`       | React Suspenseを使用して動的辞書を読み込むためのフック。キーとPromiseを受け取り、結果をキャッシュします。                                | -                                                                                                                       |
+| `useIntlayerContext`   | 現在の Intlayer クライアントのコンテキスト値（locale、setLocale など）を提供するフック。                                                 | -                                                                                                                       |
+| `useHTMLContext`       | HTMLProvider コンテキストから HTML コンポーネントのオーバーライドにアクセスするフック。                                                  | -                                                                                                                       |
 
 ### 関数
 

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

@@ -0,0 +1,87 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: usePathnameフックドキュメント | react-intlayer
+description: react-intlayerパッケージからusePathnameフックを使用して、ロケールセグメントを含まない現在のURLパス名を取得する方法を学びます。
+keywords:
+  - usePathname
+  - pathname
+  - react
+  - intlayer
+  - routing
+  - internationalization
+slugs:
+  - doc
+  - packages
+  - react-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathnameユーティリティを追加"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "履歴を初期化"
+author: aymericzip
+---
+
+# React統合: `usePathname` フックドキュメント
+
+`react-intlayer`の`usePathname`フックは、ロケールセグメントが削除された現在のブラウザパス名を返します。ネイティブの`window.location.pathname`に依存し、`popstate`を介してブラウザのナビゲーションイベントに反応します。
+
+## `usePathname`のインポート
+
+```typescript
+import { usePathname } from "react-intlayer";
+```
+
+## 概要
+
+フレームワーク固有のルーティングフック（`next-intlayer`や`react-router`など）とは異なり、このフックはプレーンなReactアプリケーション向けの軽量でフレームワークに依存しないソリューションです。現在のURLを抽出し、一致するロケールプレフィックスを削除します（例：`/ja/about`は`/about`になります）。
+
+## 使用方法
+
+```tsx fileName="src/components/Navigation.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { usePathname } from "react-intlayer";
+
+const Navigation: FC = () => {
+  const pathname = usePathname();
+
+  return (
+    <nav>
+      <a
+        href="/home"
+        style={{ fontWeight: pathname === "/home" ? "bold" : "normal" }}
+      >
+        ホーム
+      </a>
+      <a
+        href="/about"
+        style={{ fontWeight: pathname === "/about" ? "bold" : "normal" }}
+      >
+        概要
+      </a>
+    </nav>
+  );
+};
+
+export default Navigation;
+```
+
+## 戻り値
+
+| 型       | 説明                                                                                             |
+| -------- | ------------------------------------------------------------------------------------------------ |
+| `string` | ロケールプレフィックスが削除された現在のブラウザのパス名（例：`/ja/dashboard` → `/dashboard`）。 |
+
+## 動作
+
+- **ロケールの削除**: 内部的に`getPathWithoutLocale`ユーティリティを使用して、アプリケーションのIntlayer設定に基づいてパス名から自動的にロケールを検出および削除します。
+- **反応性**: `popstate`イベントをリッスンします。ユーザーがブラウザの戻る/進むボタンを使用してナビゲートするか、`pushState`/`replaceState`が呼び出されると、フックは返されるパス名を更新します。
+- **SSRのフォールバック**: サーバー上（`window`が未定義の場合）、純粋なReactコンテキストではデフォルトでリクエストURLにアクセスできないため、デフォルトで`/`を返します。
+
+## 関連ドキュメント
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/react-intlayer/useLocale.md)
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getPathWithoutLocale.md)