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

package/docs/ru/packages/intlayer/getLocalizedUrl.md

@@ -29,6 +29,38 @@ author: aymericzip
 
 ## Описание
 
+Функция `getLocalizedUrl` генерирует локализованный URL, добавляя префикс с указанной локалью к заданному URL. Она обрабатывает как абсолютные, так и относительные URL, обеспечивая правильное применение префикса локали на основе конфигурации.
+
+**Основные возможности:**
+
+- Требуются только 2 параметра: `url` и `currentLocale`
+- Опциональный объект `options` с `locales`, `defaultLocale` и `mode`
+- Использует конфигурацию интернационализации вашего проекта по умолчанию
+- Может использоваться с минимальными параметрами для простых случаев или полностью настраиваться для сложных сценариев
+- Поддерживает несколько режимов маршрутизации: `prefix-no-default`, `prefix-all`, `no-prefix` и `search-params`
+
+---
+
+## Сигнатура функции
+
+```typescript
+getLocalizedUrl(
+  url: string,                   // Обязательно
+  currentLocale: Locales,        // Обязательно
+  options?: {                    // Опционально
+    locales?: Locales[];
+    defaultLocale?: Locales;
+    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';
+  }
+): string
+```
+
+---
+
+## Параметры
+
+## Описание
+
 Функция `getLocalizedUrl` генерирует локализованный URL, добавляя в начало заданного URL указанный локаль. Она обрабатывает как абсолютные, так и относительные URL, обеспечивая применение правильного префикса локали в соответствии с конфигурацией.
 
 ---
@@ -67,6 +99,25 @@ author: aymericzip
 
 ## Пример использования
 
+### Базовое использование (только необходимые параметры)
+
+Когда вы настроили свой проект с параметрами интернационализации, вы можете использовать функцию только с необходимыми параметрами:
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getLocalizedUrl, Locales } from "intlayer";
+
+// Использует конфигурацию вашего проекта для locales, defaultLocale и mode
+getLocalizedUrl("/about", Locales.FRENCH);
+// Вывод: "/fr/about" (при условии, что французский поддерживается и mode установлен на 'prefix-no-default')
+
+getLocalizedUrl("/about", Locales.ENGLISH);
+// Вывод: "/about" или "/en/about" (в зависимости от параметра mode)
+```
+
+### Advanced Usage (With Optional Parameters)
+
+Вы можете переопределить конфигурацию по умолчанию, предоставив необязательный параметр `options`:
+
 ### Относительные URL
 
 ```typescript codeFormat={["typescript", "esm"]}
@@ -114,6 +165,30 @@ getLocalizedUrl(
 // Вывод: "/about" для локали по умолчанию (английский)
 ```
 
+### Частичное переопределение конфигурации
+
+Вы также можете предоставить только некоторые необязательные параметры. Функция будет использовать конфигурацию вашего проекта для любых параметров, которые вы не указали:
+
+```typescript codeFormat="typescript"
+import { getLocalizedUrl, Locales } from "intlayer";
+
+// Переопределить только locales, использовать конфигурацию проекта для defaultLocale и mode
+getLocalizedUrl("/about", Locales.SPANISH, {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+});
+
+// Переопределить только mode, использовать конфигурацию проекта для locales и defaultLocale
+getLocalizedUrl("/about", Locales.ENGLISH, {
+  mode: "prefix-all", // Принудительный префикс для всех локалей, включая значение по умолчанию
+});
+
+// Переопределить несколько опций
+getLocalizedUrl("/about", Locales.FRENCH, {
+  defaultLocale: Locales.ENGLISH,
+  mode: "search-params", // Использовать параметры запроса: /about?locale=fr
+});
+```
+
 ### Абсолютные URL
 
 ```typescript

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

@@ -29,12 +29,28 @@ author: aymericzip
 
 ## Описание
 
+Функция `getMultilingualUrls` генерирует отображение многоязычных URL-адресов путём добавления префикса локали к заданному URL-адресу. Она может обрабатывать как абсолютные, так и относительные URL-адреса, применяя подходящий префикс локали на основе предоставленной конфигурации или значений по умолчанию.
+
+**Ключевые возможности:**
+
+- Требуется только 1 параметр: `url`
+- Опциональный объект `options` с параметрами `locales`, `defaultLocale` и `mode`
+- Использует конфигурацию интернационализации вашего проекта в качестве значений по умолчанию
+- Поддерживает несколько режимов маршрутизации: `prefix-no-default`, `prefix-all`, `no-prefix` и `search-params`
+- Возвращает объект отображения со всеми локалями в качестве ключей и соответствующими URL-адресами в качестве значений
+
+---
+
+## Описание
+
 Функция `getMultilingualUrls` генерирует отображение многоязычных URL, добавляя префикс с каждым поддерживаемым языком к заданному URL. Она может обрабатывать как абсолютные, так и относительные URL, применяя соответствующий префикс языка на основе предоставленной конфигурации или значений по умолчанию.
 
 ---
 
 ## Параметры
 
+## Параметры
+
 - `url: string`
   - **Описание**: Исходная строка URL, к которой будут добавлены префиксы языков.
   - **Тип**: `string`
@@ -54,6 +70,33 @@ author: aymericzip
   - **Тип**: `boolean`
   - **По умолчанию**: `prefixDefaultDefault`
 
+### Опциональные параметры
+
+- `options?: object`
+  - **Description**: Объект конфигурации для поведения локализации URL.
+  - **Type**: `object`
+  - **Required**: No (Optional)
+
+  - `options.locales?: Locales[]`
+    - **Description**: Массив поддерживаемых локалей. Если не предоставлен, использует настроенные локали из конфигурации вашего проекта.
+    - **Type**: `Locales[]`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md#middleware)
+
+  - `options.defaultLocale?: Locales`
+    - **Description**: Локаль по умолчанию для приложения. Если не предоставлена, использует настроенную локаль по умолчанию из конфигурации вашего проекта.
+    - **Type**: `Locales`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/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/ru/configuration.md#middleware)
+    - **Modes**:
+      - `prefix-no-default`: Без префикса для локали по умолчанию, с префиксом для всех остальных
+      - `prefix-all`: Префикс для всех локалей, включая локаль по умолчанию
+      - `no-prefix`: Без префикса локали в URL
+      - `search-params`: Использование параметров запроса для локали (например, `?locale=fr`)
+
 ### Возвращаемое значение
 
 - **Тип**: `IConfigLocales<string>`
@@ -63,6 +106,20 @@ author: aymericzip
 
 ## Пример использования
 
+### Базовое использование (использует конфигурацию проекта)
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getMultilingualUrls, Locales } from "intlayer";
+
+// Использует конфигурацию вашего проекта для локалей, defaultLocale и mode
+getMultilingualUrls("/dashboard");
+// Output (assuming project config has en, fr with mode 'prefix-no-default'):
+// {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard"
+// }
+```
+
 ### Относительные URL
 
 ```typescript codeFormat={["typescript", "esm", "commonjs"]}
@@ -97,6 +154,60 @@ getMultilingualUrls(
 
 ---
 
+### Различные режимы маршрутизации
+
+```typescript
+// prefix-no-default: Без префикса для локали по умолчанию
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+// Output: {
+//   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",
+});
+// Output: {
+//   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",
+});
+// Output: {
+//   en: "/dashboard",
+//   fr: "/dashboard",
+//   es: "/dashboard"
+// }
+
+// search-params: Локаль в качестве параметра запроса
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "search-params",
+});
+// Output: {
+//   en: "/dashboard?locale=en",
+//   fr: "/dashboard?locale=fr",
+//   es: "/dashboard?locale=es"
+// }
+```
+
+---
+
 ## Особые случаи
 
 - **Отсутствие сегмента языка:**

package/docs/ru/packages/next-intlayer/exports.md

@@ -15,6 +15,9 @@ slugs:
   - next-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Добавлена утилита usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Объединённая документация для всех экспортов"
@@ -95,6 +98,7 @@ import "next-intlayer";
 | `useDictionaryAsync`   | Hook, который обрабатывает асинхронные словари. Принимает карту словарей на основе Promise и разрешает её для текущей локали.                                  | -                                                                                                                       |
 | `useDictionaryDynamic` | Hook, который обрабатывает динамические словари, загружаемые по ключу. Внутри использует React Suspense для состояний загрузки.                                | -                                                                                                                       |
 | `useLocale`            | Хук на стороне клиента для получения текущей локали и функции для её установки. Улучшен для Next.js App Router с поддержкой навигации.                         | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/react-intlayer/useLocale.md)         |
+| `usePathname`          | Возвращает текущий путь без префикса локали и без параметров запроса локали.                                                                                   | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/next-intlayer/usePathname.md)      |
 | `useRewriteURL`        | Клиентский хук для управления правилами переписывания URL. Автоматически обновляет URL, если существует более «читаемое» локализованное правило переписывания. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/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/ru/packages/react-intlayer/useI18n.md)             |

package/docs/ru/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({
+    ru: "Отправить",
+    en: "Submit",
+    fr: "Soumettre",
+    es: "Enviar",
+  })}
+>
+  {t({
+    ru: "Отправить",
+    en: "Submit",
+    fr: "Soumettre",
+    es: "Enviar",
+  })}
+  <img
+    src="/path/to/image"
+    alt={t({
+      ru: "Красивый пейзаж",
+      en: "A beautiful scenery",
+      fr: "Un beau paysage",
+      es: "Un hermoso paisaje",
+    })}
+  />
+</button>
+```
+
+---
+
 ## Расширенные темы
 
 ### Интеграция с TypeScript

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

@@ -0,0 +1,136 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Документация хука usePathname | next-intlayer
+description: Узнайте, как использовать хук usePathname в пакете next-intlayer
+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 с удаленным сегментом локали. Это полезно для создания навигации с учетом локали — например, для определения активного элемента навигации — без необходимости вручную удалять префикс локали.
+
+## Импорт `usePathname` в Next.js
+
+```typescript
+import { usePathname } from "next-intlayer";
+```
+
+## Обзор
+
+`usePathname` оборачивает встроенный хук `usePathname()` из `next/navigation`, добавляет параметры поиска (search params) и удаляет префикс локали с помощью `getPathWithoutLocale`. Он запускает повторный рендеринг при каждой навигации на стороне клиента. Хук доступен только в клиентских компонентах (Client Components, требует `"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` | Текущий путь без префикса локали и параметров запроса локали. |
+
+## Поведение
+
+- **Удаление локали**: Удаляет начальный сегмент локали (например, `/ru/dashboard` → `/dashboard`).
+- **Удаление параметров поиска**: Также удаляет параметр запроса `?locale=...` при использовании режима маршрутизации на основе параметров поиска.
+- **Реактивность**: Автоматически обновляется при каждой навигации на стороне клиента через Next.js App Router.
+- **Безопасность для SSR**: Возвращает серверный путь во время первого рендера, а затем синхронизирует параметры поиска на клиенте.
+
+## Сравнение с `useLocale`
+
+Хук `useLocale` из `next-intlayer` уже предоставляет `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/ru/packages/next-intlayer/useLocale.md) — текущая локаль + переключатель локали (также предоставляет `pathWithoutLocale`)
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getPathWithoutLocale.md) — базовая утилита, используемая этим хуком

package/docs/ru/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()`, перечисления и т.д. | -                                                                                                  |
-| `useLocale`     | Возвращает текущую локаль и функцию для её установки.                                                     | -                                                                                                  |
-| `t`             | Выбирает контент в зависимости от текущей локали.                                                         | [перевод](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/translation.md) |
+| Хук             | Описание                                                                                                                              | Связанный документ                                                                                                   |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | Основан на `useDictionary`, но внедряет оптимизированную версию словаря из сгенерированного объявления.                               | -                                                                                                                    |
+| `useDictionary` | Обрабатывает объекты, похожие на словари (key, content). Обрабатывает переводы `t()`, перечисления и т.д.                             | -                                                                                                                    |
+| `useLocale`     | Возвращает текущую локаль и функцию для её установки.                                                                                 | -                                                                                                                    |
+| `usePathname`   | Хук, возвращающий текущий путь (pathname) с удалённым сегментом локали. Реактивно реагирует на навигацию в браузере через `popstate`. | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/preact-intlayer/usePathname.md) |
+| `t`             | Выбирает контент в зависимости от текущей локали.                                                                                     | [перевод](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/translation.md)                   |
 
 ### Компоненты
 

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

@@ -0,0 +1,117 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Документация хука usePathname | preact-intlayer
+description: Узнайте, как использовать хук usePathname в пакете preact-intlayer
+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) браузера с удалённым сегментом локали. Это полезно для создания навигации, учитывающей локаль — например, для определения активного элемента меню — без необходимости вручную удалять префикс локали.
+
+## Импорт `usePathname` в Preact
+
+```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)**: Убирает начальный сегмент локали (например, `/ru/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/ru/packages/preact-intlayer/exports.md) — текущая локаль + переключатель локали
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getPathWithoutLocale.md) — базовая утилита, используемая этим хуком

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

@@ -14,6 +14,9 @@ slugs:
   - react-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Добавлена утилита usePathname"
   - version: 7.5.14
     date: 2026-01-21
     changes: "Унифицированная документация для всех экспортов"
@@ -62,6 +65,7 @@ import "react-intlayer";
 | `useDictionaryDynamic` | Хук, который обрабатывает динамические словари, загружаемые по ключу. Внутри использует React Suspense для состояний загрузки.                         | -                                                                                                                       |
 | `useLocale`            | Клиентский хук для получения текущей локали, локали по умолчанию, доступных локалей и функции для смены локали.                                        | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/react-intlayer/useLocale.md)         |
 | `useLocaleBase`        | Хук для получения текущей локали и всех связанных полей (locale, defaultLocale, availableLocales, setLocale) из контекста.                             | -                                                                                                                       |
+| `usePathname`          | Хук, возвращающий текущий путь (pathname) с удаленным сегментом локали. Реактивно реагирует на навигацию браузера через `popstate`.                    | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/react-intlayer/usePathname.md)     |
 | `useRewriteURL`        | Клиентский хук для управления перезаписью URL. Если для текущего pathname и локали существует правило перезаписи, он обновит URL.                      | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/react-intlayer/useRewriteURL.md) |
 | `useI18n`              | Хук, который предоставляет функцию перевода `t()` для доступа к вложенному содержимому по ключу. Имитирует паттерн i18next/next-intl.                  | [useI18n](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/react-intlayer/useI18n.md)             |
 | `useIntl`              | Хук, который предоставляет объект `Intl`, привязанный к локали. Автоматически внедряет текущую локаль и использует оптимизированный кэш.               | -                                                                                                                       |