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

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/express-intlayer/t.md

@@ -334,15 +334,6 @@ app.get("/morning", (_req, res) => {
 
 ---
 
-## 효과적인 사용을 위한 팁
-
-1. **번역 중앙 집중화**: 유지 관리를 개선하기 위해 번역 관리를 중앙 집중화된 모듈이나 JSON 파일을 사용하세요.
-2. **번역 검증**: 불필요한 대체를 방지하기 위해 모든 언어 변형에 해당하는 번역이 있는지 확인하세요.
-3. **프론트엔드 i18n과 결합**: 앱 전반에 걸쳐 원활한 사용자 경험을 위해 프론트엔드 국제화와 동기화하세요.
-4. **성능 벤치마크**: 번역을 추가할 때 앱의 응답 시간을 테스트하여 최소한의 영향을 보장하세요.
-
----
-
 ## 결론
 
 1. **번역 중앙화**: 유지보수를 용이하게 하기 위해 번역 관리를 중앙화된 모듈이나 JSON 파일로 수행하세요.

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/intlayer/getLocalizedUrl.md

@@ -36,6 +36,36 @@ author: aymericzip
 
 ---
 
+## 함수 서명
+
+```typescript
+getLocalizedUrl(
+  url: string,                   // 필수
+  currentLocale: Locales,        // 필수
+  options?: {                    // 선택사항
+    locales?: Locales[];
+    defaultLocale?: Locales;
+    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';
+  }
+): string
+```
+
+---
+
+## 매개변수
+
+### 필수 파라미터
+
+- `url: string`
+  - **Description**: 로케일을 접두사로 추가할 원본 URL 문자열입니다.
+  - **Type**: `string`
+  - **Required**: Yes
+
+- `currentLocale: Locales`
+  - **Description**: URL이 로컬라이제이션되는 현재 로케일입니다.
+  - **Type**: `Locales`
+  - **Required**: Yes
+
 ## 매개변수
 
 - `url: string`
@@ -70,6 +100,25 @@ author: aymericzip
 
 ## 사용 예시
 
+### 기본 사용법 (필수 매개변수만 사용)
+
+국제화 설정으로 프로젝트를 구성한 후에는 필수 매개변수만으로 함수를 사용할 수 있습니다:
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getLocalizedUrl, Locales } from "intlayer";
+
+// 프로젝트의 locales, defaultLocale 및 mode 구성을 사용합니다
+getLocalizedUrl("/about", Locales.FRENCH);
+// 출력: "/fr/about" (French가 지원되고 mode가 'prefix-no-default'라고 가정)
+
+getLocalizedUrl("/about", Locales.ENGLISH);
+// 출력: "/about" 또는 "/en/about" (mode 설정에 따라 다름)
+```
+
+### 고급 사용법 (선택적 매개변수 포함)
+
+선택적 `options` 매개변수를 제공하여 기본 구성을 재정의할 수 있습니다:
+
 ### 상대 URL
 
 ```typescript codeFormat={["typescript", "esm"]}
@@ -117,6 +166,30 @@ getLocalizedUrl(
 // 출력: 기본(영어) 로케일의 경우 "/about"
 ```
 
+### 부분 Configuration Override
+
+선택적 매개변수 중 일부만 제공할 수도 있습니다. 함수는 지정하지 않은 매개변수에 대해 프로젝트 configuration을 사용합니다:
+
+```typescript codeFormat="typescript"
+import { getLocalizedUrl, Locales } from "intlayer";
+
+// locales만 override, defaultLocale과 mode는 프로젝트 config 사용
+getLocalizedUrl("/about", Locales.SPANISH, {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+});
+
+// mode만 override, locales과 defaultLocale은 프로젝트 config 사용
+getLocalizedUrl("/about", Locales.ENGLISH, {
+  mode: "prefix-all", // 기본 locale을 포함한 모든 locale에 prefix 강제
+});
+
+// 여러 옵션 override
+getLocalizedUrl("/about", Locales.FRENCH, {
+  defaultLocale: Locales.ENGLISH,
+  mode: "search-params", // 쿼리 매개변수 사용: /about?locale=fr
+});
+```
+
 ### 절대 URL
 
 ```typescript

package/docs/ko/packages/intlayer/getMultilingualUrls.md

@@ -33,6 +33,23 @@ author: aymericzip
 
 ---
 
+## 함수 서명
+
+```typescript
+getMultilingualUrls(
+  url: string,                   // 필수
+  options?: {                    // 선택사항
+    locales?: Locales[];
+    defaultLocale?: Locales;
+    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';
+  }
+): StrictModeLocaleMap<string>
+```
+
+---
+
+## 매개변수
+
 ## 매개변수
 
 - `url: string`
@@ -54,6 +71,33 @@ author: aymericzip
   - **타입**: `boolean`
   - **기본값**: `prefixDefaultDefault`
 
+### 선택적 매개변수
+
+- `options?: object`
+  - **Description**: URL 지역화 동작을 위한 구성 객체입니다.
+  - **Type**: `object`
+  - **Required**: No (선택사항)
+
+  - `options.locales?: Locales[]`
+    - **Description**: 지원되는 로케일의 배열입니다. 제공되지 않으면 프로젝트 구성에서 구성된 로케일을 사용합니다.
+    - **Type**: `Locales[]`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md#middleware)
+
+  - `options.defaultLocale?: Locales`
+    - **Description**: 애플리케이션의 기본 로케일입니다. 제공되지 않으면 프로젝트 구성에서 구성된 기본 로케일을 사용합니다.
+    - **Type**: `Locales`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md#middleware)
+
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Description**: 로케일 처리를 위한 URL 라우팅 모드입니다. 제공되지 않으면 프로젝트 구성에서 구성된 모드를 사용합니다.
+    - **Type**: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md#middleware)
+    - **Modes**:
+      - `prefix-no-default`: 기본 로케일의 경우 접두사 없음, 다른 로케일의 경우 접두사 포함
+      - `prefix-all`: 기본 로케일을 포함한 모든 로케일에 접두사 포함
+      - `no-prefix`: URL에 로케일 접두사 없음
+      - `search-params`: 로케일에 쿼리 매개변수 사용 (예: `?locale=fr`)
+
 ### 반환값
 
 - **타입**: `IConfigLocales<string>`
@@ -63,6 +107,20 @@ author: aymericzip
 
 ## 사용 예시
 
+### 기본 사용법 (프로젝트 구성 사용)
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getMultilingualUrls, Locales } from "intlayer";
+
+// 프로젝트의 구성에서 locales, defaultLocale, mode를 사용합니다
+getMultilingualUrls("/dashboard");
+// 출력 (프로젝트 구성에 en, fr이 있고 mode가 'prefix-no-default'인 경우):
+// {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard"
+// }
+```
+
 ### 상대 URL
 
 ```typescript codeFormat={["typescript", "esm", "commonjs"]}
@@ -97,6 +155,60 @@ getMultilingualUrls(
 
 ---
 
+### 다양한 라우팅 모드
+
+```typescript
+// prefix-no-default: 기본 로케일에 대한 접두사 없음
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+// 출력: {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// prefix-all: 모든 로케일에 접두사 추가
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-all",
+});
+// 출력: {
+//   en: "/en/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// no-prefix: URL에 로케일 접두사 없음
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "no-prefix",
+});
+// 출력: {
+//   en: "/dashboard",
+//   fr: "/dashboard",
+//   es: "/dashboard"
+// }
+
+// search-params: 쿼리 매개변수로 로케일 전달
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "search-params",
+});
+// 출력: {
+//   en: "/dashboard?locale=en",
+//   fr: "/dashboard?locale=fr",
+//   es: "/dashboard?locale=es"
+// }
+```
+
+---
+
 ## 예외 상황
 
 - **로케일 세그먼트 없음:**

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

@@ -133,6 +133,40 @@ export const ServerComponentExample: FC = () => (
 
 ---
 
+### 속성의 인라인 번역
+
+`t` 함수는 JSX 속성의 인라인 번역에 특히 유용합니다.
+`alt`, `title`, `href`, 또는 `aria-label`과 같은 속성을 현지화할 때, 속성 내에서 직접 `t`를 사용할 수 있습니다.
+
+```jsx
+<button
+  aria-label={t({
+    ko: "제출",
+    en: "Submit",
+    fr: "Soumettre",
+    es: "Enviar",
+  })}
+>
+  {t({
+    ko: "제출",
+    en: "Submit",
+    fr: "Soumettre",
+    es: "Enviar",
+  })}
+  <img
+    src="/path/to/image"
+    alt={t({
+      ko: "아름다운 풍경",
+      en: "A beautiful scenery",
+      fr: "Un beau paysage",
+      es: "Un hermoso paisaje",
+    })}
+  />
+</button>
+```
+
+---
+
 ## 고급 주제
 
 ### TypeScript 통합

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

@@ -112,9 +112,4 @@ const LocaleSwitcher: FC = () => {
 
 ## 결론
 
-- **`setLocale`**: 애플리케이션의 로케일을 변경하고 URL을 이에 맞게 업데이트하는 함수입니다. 구성에 따라 경로에 로케일을 추가할지 여부와 접두사 규칙을 처리합니다. `next/navigation`의 `useRouter`를 사용하여 `push` 및 `refresh`와 같은 내비게이션 기능을 활용합니다.
-- **`pathWithoutLocale`**: 로케일이 제거된 경로를 반환하는 계산된 속성입니다. URL 비교에 유용합니다. 예를 들어 현재 로케일이 `fr`이고 URL이 `fr/my_path`인 경우, 로케일이 제거된 경로는 `/my_path`가 됩니다. `next/navigation`의 `usePathname`을 사용하여 현재 경로를 가져옵니다.
-
-## 결론
-
 `next-intlayer`의 `useLocale` 훅은 Next.js 애플리케이션에서 로케일을 관리하는 데 중요한 도구입니다. 로케일 저장, 상태 관리, URL 수정 등을 원활하게 처리하여 다중 로케일에 맞게 애플리케이션을 통합적으로 적응시킬 수 있는 접근 방식을 제공합니다.