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

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)

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`       | 動的辞書を読み込むフック。                                                                                                     | -                                                                                                                       |

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オブジェクトを返します。                                                                        | -                                                                                                                        |
 
 ### マークダウン