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

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

@@ -14,9 +14,12 @@ slugs:
   - angular-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname 유틸리티 추가"
   - version: 8.0.0
     date: 2026-01-21
-    changes: "모든 exports에 대한 문서 통합"
+    changes: "모든 내보내기에 대한 통합 문서" 통합"
 author: aymericzip
 ---
 
@@ -46,15 +49,16 @@ import "angular-intlayer";
 
 ### 훅
 
-| 훅                     | 설명                                                                                           | 관련 문서 |
-| ---------------------- | ---------------------------------------------------------------------------------------------- | --------- |
-| `useIntlayer`          | `useDictionary`를 기반으로 하며, 생성된 declaration에서 딕셔너리의 최적화된 버전을 주입합니다. | -         |
-| `useDictionary`        | 사전(key, content)처럼 보이는 객체를 처리합니다. `t()` 번역, 열거형 등도 처리합니다.           | -         |
-| `useDictionaryAsync`   | `useDictionary`와 동일하지만 비동기 사전을 처리합니다.                                         | -         |
-| `useDictionaryDynamic` | `useDictionary`와 동일하지만 동적 사전을 처리합니다.                                           | -         |
-| `useLocale`            | 현재 로케일과 이를 설정하는 함수를 반환합니다.                                                 | -         |
-| `useIntl`              | 현재 로케일에 대한 Intl 객체를 반환합니다.                                                     | -         |
-| `useLoadDynamic`       | 동적 사전을 로드하는 훅.                                                                       | -         |
+| 훅                     | 설명                                                                                                               | 관련 문서                                                                                                             |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`          | `useDictionary`를 기반으로 하며, 생성된 declaration에서 딕셔너리의 최적화된 버전을 주입합니다.                     | -                                                                                                                     |
+| `useDictionary`        | 사전(key, content)처럼 보이는 객체를 처리합니다. `t()` 번역, 열거형 등도 처리합니다.                               | -                                                                                                                     |
+| `useDictionaryAsync`   | `useDictionary`와 동일하지만 비동기 사전을 처리합니다.                                                             | -                                                                                                                     |
+| `useDictionaryDynamic` | `useDictionary`와 동일하지만 동적 사전을 처리합니다.                                                               | -                                                                                                                     |
+| `useLocale`            | 현재 로케일과 이를 설정하는 함수를 반환합니다.                                                                     | -                                                                                                                     |
+| `usePathname`          | 로케일 세그먼트가 제거된 현재 경로를 `Signal<string>`으로 반환합니다. `DestroyRef`를 통해 `popstate`에 반응합니다. | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/angular-intlayer/usePathname.md) |
+| `useIntl`              | 현재 로케일에 대한 Intl 객체를 반환합니다.                                                                         | -                                                                                                                     |
+| `useLoadDynamic`       | 동적 사전을 로드하는 훅.                                                                                           | -                                                                                                                     |
 
 ### 컴포넌트
 

package/docs/ko/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 시그널. |
+
+## 동작
+
+- **로케일 제거**: 선행 로케일 세그먼트를 제거합니다 (예: `/ko/dashboard` → `/dashboard`).
+- **반응형**: `popstate` 이벤트(브라우저 뒤로 / 앞으로 탐색)에 자동으로 업데이트됩니다.
+- **SSR 안전성**: `window`를 사용할 수 없을 때는 `""`를 반환합니다.
+- **정리(Cleanup)**: 호스트 컴포넌트가 파괴될 때 `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/ko/packages/angular-intlayer/exports.md) — 현재 로케일 + 로케일 전환기
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getPathWithoutLocale.md) — 이 훅에서 사용하는 기본 유틸리티

package/docs/ko/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` 함수는 로케일 세그먼트, 프로토콜/호스트, 쿼리 문자열, 해시 및 후행 슬래시를 무시하면서 두 URL 또는 경로명이 같은지 비교합니다. 내비게이션 링크가 현재 페이지를 가리키는지 판단할 때(예: 활성 링크 강조 표시) 오류가 발생하기 쉬운 자체 정규화 로직을 만들 필요 없이 사용하는 권장 방법입니다.
+
+내부적으로 [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getPathWithoutLocale.md)을 재사용하여 로케일 세그먼트를 제거하므로, 설정된 라우팅 모드와 로케일을 따릅니다.
+
+이 패키지는 또한 비교에 사용되는 로케일 독립적인 정규화된 경로명을 반환하는 기본 도우미인 [`normalizePath`](#normalizepath)를 내보냅니다.
+
+**주요 기능:**
+
+- 로케일 독립적 비교(`/ko/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`
+  - **설명**: 비교할 두 번째 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
+
+```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`에서 사용하는 로케일 독립적인 정규 경로명을 반환합니다. 로케일 세그먼트, 프로토콜/호스트, 쿼리 문자열 및 해시를 제거하고, 단일 선행 슬래시를 확인하며, 루트를 제외한 모든 후행 슬래시를 제거하고, 빈 값의 경우 `/`로 대체합니다.
+
+```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/ko/packages/intlayer/getPathWithoutLocale.md): URL 또는 경로에서 로케일 세그먼트를 제거합니다.
+- [`getPrefix`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getPrefix.md): 주어진 로케일에 대한 URL 접두사를 결정합니다.
+- [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/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/ko/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: "모든 내보내기에 대한 문서 통합"
@@ -119,6 +122,8 @@ import "intlayer";
 | `getMultilingualUrls`  | `Function` | 지원되는 모든 로케일에 대한 URL을 생성합니다. | [getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getMultilingualUrls.md)   |
 | `getPathWithoutLocale` | `Function` | 경로에서 로케일 접두사를 제거합니다.          | [getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getPathWithoutLocale.md) |
 | `getPrefix`            | `Function` | 경로에서 로케일 접두사를 가져옵니다.          | [getPrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getPrefix.md)                       |
+| `comparePaths`         | `Function` | 로케일을 무시하고 두 경로를 비교합니다.       | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/comparePaths.md)                 |
+| `normalizePath`        | `Function` | 경로를 로케일 독립적인 경로로 정규화합니다.   | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/comparePaths.md)                 |
 | `getHTMLTextDir`       | `Function` | 텍스트 방향(LTR/RTL)을 가져옵니다.            | [getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getHTMLTextDir.md)             |
 | `validatePrefix`       | `Function` | 로케일 접두사를 검증합니다.                   | [validatePrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/validatePrefix.md)             |
 

package/docs/ko/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: "모든 exports에 대한 통합 문서화"
@@ -95,6 +98,7 @@ import "next-intlayer";
 | `useDictionaryAsync`   | 비동기 사전을 처리하는 훅입니다. Promise 기반의 dictionary 맵을 받아 현재 로케일에 맞게 이를 해결(resolve)합니다.                            | -                                                                                                                       |
 | `useDictionaryDynamic` | 키로 로드되는 동적 사전을 처리하는 훅입니다. 로딩 상태 관리를 위해 내부적으로 React Suspense를 사용합니다.                                   | -                                                                                                                       |
 | `useLocale`            | 클라이언트 사이드 훅으로 현재 로케일과 이를 설정하는 함수를 제공합니다. Next.js App Router의 navigation 지원을 위해 확장되어 있습니다.       | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/react-intlayer/useLocale.md)         |
+| `usePathname`          | 로케일 접두사와 로케일 매개변수가 제거된 쿼리 매개변수를 제외한 현재 경로 이름을 반환합니다.                                                 | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/next-intlayer/usePathname.md)      |
 | `useRewriteURL`        | URL 재작성(rewrite)을 관리하는 클라이언트 사이드 훅입니다. 보다 보기 좋은 로컬라이즈된 리라이트 규칙이 있으면 URL을 자동으로 업데이트합니다. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/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/ko/packages/react-intlayer/useI18n.md)             |

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

@@ -0,0 +1,140 @@
+---
+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 경로 이름을 반환합니다. 수동으로 로케일 접두사를 제거하지 않고도 로케일을 인식하는 탐색(예: 어떤 탐색 항목이 활성화되었는지 판단)을 구축할 때 유용합니다.
+
+## Next.js에서 `usePathname` 가져오기
+
+```typescript
+import { usePathname } from "next-intlayer";
+```
+
+## 개요
+
+`usePathname`은 `next/navigation`의 내장 `usePathname()`을 래핑하여 검색 매개변수를 추가하고 `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` | 로케일 접두사와 로케일 매개변수가 제거된 쿼리 매개변수를 제외한 현재 경로 이름입니다. |
+
+## 동작 방식
+
+- **로케일 제거**: 선행 로케일 세그먼트를 제거합니다(예: `/ko/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/ko/packages/next-intlayer/useLocale.md) — 현재 로케일 + 로케일 스위처 (`pathWithoutLocale`도 노출)
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getPathWithoutLocale.md) — 이 훅에서 사용하는 기본 유틸리티
+
+```
+
+```

package/docs/ko/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: "모든 exports에 대한 문서 통합"
@@ -40,12 +43,13 @@ npm install preact-intlayer
 
 ### 훅
 
-| 훅              | 설명                                                                                             | 관련 문서                                                                                              |
-| --------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |
-| `useIntlayer`   | `useDictionary`를 기반으로 하며, 생성된 declaration에서 dictionary의 최적화된 버전을 주입합니다. | -                                                                                                      |
-| `useDictionary` | 키와 내용(key, content)처럼 보이는 객체를 처리합니다. `t()` 번역, enumerations 등을 처리합니다.  | -                                                                                                      |
-| `useLocale`     | 현재 로케일과 이를 설정하는 함수를 반환합니다.                                                   | -                                                                                                      |
-| `t`             | 현재 로케일에 따라 콘텐츠를 선택합니다.                                                          | [translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/translation.md) |
+| 훅              | 설명                                                                                                        | 관련 문서                                                                                                            |
+| --------------- | ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | `useDictionary`를 기반으로 하며, 생성된 declaration에서 dictionary의 최적화된 버전을 주입합니다.            | -                                                                                                                    |
+| `useDictionary` | 키와 내용(key, content)처럼 보이는 객체를 처리합니다. `t()` 번역, enumerations 등을 처리합니다.             | -                                                                                                                    |
+| `useLocale`     | 현재 로케일과 이를 설정하는 함수를 반환합니다.                                                              | -                                                                                                                    |
+| `usePathname`   | 로케일 세그먼트가 제거된 현재 경로명(pathname)을 반환하는 훅입니다. 브라우저 탐색(`popstate`)에 반응합니다. | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/preact-intlayer/usePathname.md) |
+| `t`             | 현재 로케일에 따라 콘텐츠를 선택합니다.                                                                     | [translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/translation.md)               |
 
 ### 컴포넌트
 

package/docs/ko/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)**: URL 앞의 로케일 세그먼트를 제거합니다(예: `/ko/dashboard` → `/dashboard`).
+- **반응형**: `popstate` 이벤트(브라우저 뒤로 / 앞으로 가기 내비게이션) 시 자동으로 업데이트됩니다.
+- **SSR 안전성**: `window`를 사용할 수 없을 때 `""`를 반환합니다.
+- **정리 (Cleanup)**: 컴포넌트 마운트 해제 시 `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/ko/packages/preact-intlayer/exports.md) — 현재 로케일 + 로케일 스위처
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getPathWithoutLocale.md) — 이 훅에서 사용되는 기본 유틸리티