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

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/useDictionary.md

@@ -28,98 +28,6 @@ author: aymericzip
 
 このセクションでは、Reactアプリケーション内で`useDictionary`フックを使用するための詳細なガイドを提供します。ビジュアルエディタなしでローカライズされたコンテンツを効率的に扱うことが可能です。
 
-## Reactでの`useDictionary`のインポート
-
-`useDictionary`フックは、コンテキストに応じてインポートすることでReactアプリケーションに統合できます。
-
-- **クライアントコンポーネント:**
-
-  ```typescript codeFormat="typescript"
-  import { useDictionary } from "react-intlayer"; // クライアントサイドのReactコンポーネントで使用
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useDictionary } from "react-intlayer"; // クライアントサイドのReactコンポーネントで使用
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useDictionary } = require("react-intlayer"); // クライアントサイドのReactコンポーネントで使用
-  ```
-
-- **サーバーコンポーネント:**
-
-  ```typescript codeFormat="typescript"
-  import { useDictionary } from "react-intlayer/server"; // サーバーサイドのReactコンポーネントで使用
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useDictionary } from "react-intlayer/server"; // サーバーサイドのReactコンポーネントで使用
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useDictionary } = require("react-intlayer/server"); // サーバーサイドのReactコンポーネントで使用
-  ```
-
-## パラメーター
-
-このフックは2つのパラメーターを受け取ります：
-
-1. **`dictionary`**：特定のキーに対応するローカライズされたコンテンツを含む宣言済みの辞書オブジェクト。
-2. **`locale`**（オプション）：希望するロケール。指定しない場合は現在のコンテキストのロケールがデフォルトとなります。
-
-## 辞書
-
-すべての辞書オブジェクトは型の安全性を確保し、実行時エラーを防ぐために構造化されたコンテンツファイル内で宣言する必要があります。セットアップ手順は[こちら](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/content_file.md)で確認できます。以下はコンテンツ宣言の例です：
-
-```typescript fileName="./component.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
-import { t, type Dictionary } from "intlayer";
-
-const componentContent = {
-  key: "component-example",
-  content: {
-    title: t({
-      en: "Client Component Example",
-      fr: "Exemple de composant client",
-      es: "Ejemplo de componente cliente",
-    }),
-    content: t({
-      en: "This is the content of a client component example",
-      fr: "Ceci est le contenu d'un exemple de composant client",
-      es: "Este es el contenido de un ejemplo de componente cliente",
-    }),
-  },
-} satisfies Dictionary;
-
-export default componentContent;
-```
-
-```json fileName="./component.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "component-example",
-  "content": {
-    "title": {
-      "nodeType": "translation",
-      "translation": {
-        "en": "Client Component Example",
-        "fr": "Exemple de composant client",
-        "es": "Ejemplo de componente cliente",
-        "ja": "クライアントコンポーネントの例"
-      }
-    },
-    "content": {
-      "nodeType": "translation",
-      "translation": {
-        "en": "This is the content of a client component example",
-        "fr": "Ceci est le contenu d'un exemple de composant client",
-        "es": "Este es el contenido de un ejemplo de componente cliente",
-        "ja": "これはクライアントコンポーネントの例の内容です"
-      }
-    }
-  }
-}
-```
-
 ## Reactでの使用例
 
 以下は、Reactコンポーネントで`useDictionary`フックを使用する例です：
@@ -161,18 +69,3 @@ const ServerComponentExample: FC<{ locale: string }> = ({ locale }) => {
   );
 };
 ```
-
-## 属性に関する注意点
-
-ビジュアルエディタを使用した統合とは異なり、`buttonTitle.value` のような属性はここでは適用されません。代わりに、コンテンツで宣言されたローカライズされた文字列に直接アクセスしてください。
-
-```jsx
-<button title={content.title}>{content.content}</button>
-```
-
-## 追加のヒント
-
-- **型安全性**: 辞書を定義する際は常に `Dictionary` を使用して型安全性を確保してください。
-- **ローカライズの更新**: コンテンツを更新する際は、すべてのロケールが一貫していることを確認し、翻訳の欠落を防いでください。
-
-このドキュメントは、`useDictionary` フックの統合に焦点を当てており、ビジュアルエディタの機能に依存せずにローカライズされたコンテンツを管理するための効率的なアプローチを提供します。

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

@@ -29,49 +29,6 @@ author: aymericzip
 
 このセクションでは、React アプリケーション内で `useIntlayer` フックを使用する方法について詳しく説明し、効率的なコンテンツのローカライズを可能にします。
 
-## React での `useIntlayer` のインポート
-
-`useIntlayer` フックは、コンテキストに応じてインポートすることで React アプリケーションに統合できます。
-
-- **クライアントコンポーネント:**
-
-  ```typescript codeFormat="typescript"
-  import { useIntlayer } from "react-intlayer"; // クライアントサイドの React コンポーネントで使用
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer"; // クライアントサイドの React コンポーネントで使用
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer"); // クライアントサイドの React コンポーネントで使用
-  ```
-
-- **サーバーコンポーネント:**
-
-  ```typescript codeFormat="commonjs"
-  import { useIntlayer } from "react-intlayer/server"; // サーバーサイドの React コンポーネントで使用
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer/server"; // サーバーサイドの React コンポーネントで使用
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer/server"); // サーバーサイドの React コンポーネントで使用
-  ```
-
-## パラメーター
-
-このフックは2つのパラメーターを受け取ります：
-
-1. **`key`**: ローカライズされたコンテンツを取得するための辞書キー。
-2. **`locale`**（オプション）: 希望するロケール。指定しない場合はコンテキストのロケールがデフォルトで使用されます。
-
-## 辞書
-
-すべての辞書キーは型安全性を高め、エラーを防ぐためにコンテンツ宣言ファイル内で宣言されている必要があります。セットアップ手順は[こちら](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/content_file.md)で確認できます。
-
 ## Reactでの使用例
 
 Reactコンポーネント内での`useIntlayer`フックの使用例：
@@ -134,28 +91,6 @@ const ServerComponentExample = () => {
 };
 ```
 
-## 属性の取り扱い
-
-属性をローカライズする際は、コンテンツの値に適切にアクセスしてください：
-
-```jsx
-<button title={content.buttonTitle.value}>{content.buttonText}</button>
-```
-
-## 追加リソース
-
-- **Intlayer ビジュアルエディター**: より直感的なコンテンツ管理体験のために、ビジュアルエディターのドキュメントは[こちら](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_visual_editor.md)を参照してください。
-
-このセクションは、Reactアプリケーションにおける `useIntlayer` フックの統合に特化しており、ローカリゼーションプロセスを簡素化し、異なるロケール間でのコンテンツの一貫性を確保します。
-
-## 属性の取り扱い
-
-属性をローカライズする際は、コンテンツの値に適切にアクセスしてください：
-
-```jsx
-<button title={content.buttonTitle.value}>{content.buttonText}</button>
-```
-
 ## 追加リソース
 
 - **Intlayer ビジュアルエディター**: より直感的なコンテンツ管理体験のために、ビジュアルエディターのドキュメントは[こちら](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_visual_editor.md)をご参照ください。

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)

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

@@ -14,6 +14,9 @@ slugs:
   - solid-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 "solid-intlayer";
 | `useDictionaryAsync`   | `useDictionary` と同じですが、非同期の辞書を扱います。                                                                         | -                                                                                                                       |
 | `useDictionaryDynamic` | `useDictionary` と同じですが、動的な辞書を扱います。                                                                           | -                                                                                                                       |
 | `useLocale`            | 現在のロケールと、それを設定する関数を返します。                                                                               | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/solid-intlayer/useLocale.md)         |
+| `usePathname`          | ロケールセグメントを削除した現在のパス名(pathname)を `Accessor<string>` として返します。`popstate` に反応します。              | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/solid-intlayer/usePathname.md)     |
 | `useRewriteURL`        | クライアント側のフックで、URLの書き換えを管理します。ローカライズされた書き換えルールが存在する場合、自動的にURLを更新します。 | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/solid-intlayer/useRewriteURL.md) |
 | `useIntl`              | 現在のロケールのIntlオブジェクトを返します。                                                                                   | -                                                                                                                       |
 | `useLoadDynamic`       | 動的辞書を読み込むフック。                                                                                                     | -                                                                                                                       |