@intlayer/docs 9.3.3 → 9.4.0

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

@@ -0,0 +1,197 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: Документация функции getIntlayer | intlayer
+description: Узнайте, как использовать функцию getIntlayer для пакета intlayer
+keywords:
+  - getIntlayer
+  - dictionary
+  - content
+  - selector
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getIntlayer
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Документация: функция `getIntlayer` в `intlayer`
+
+## Описание
+
+Функция `getIntlayer` выбирает один словарь по его ключу и возвращает его содержимое, интерпретированное для заданной локали. Это независимый от фреймворка эквивалент хука `useIntlayer`: то же содержимое, те же селекторы, но пригодный для использования везде, где React контекст недоступен — скрипты Node, серверные функции, загрузчики маршрутов, построители метаданных, обработчики Express/Fastify, тесты.
+
+Функция читает словари, созданные Intlayer в `.intlayer/`, поэтому аргумент `key` типизирован и автодополняется на основе ваших объявлений содержимого, а возвращаемый объект полностью типизирован вплоть до каждого листового узла.
+
+**Основные возможности:**
+
+- Типизированные ключи словарей и типизированное возвращаемое содержимое
+- Интерпретирует каждый узел содержимого (`t()`, `enu()`, `cond()`, `insert()`, `nest()`, `md()`, `html()`, `file()`, `gender()`)
+- Принимает локаль или объект селектора (коллекции, варианты)
+- Результаты кэшируются для каждой комбинации `key + locale + selector`
+- В режиме разработки откатывается на безопасный прокси при отсутствии словаря вместо краша
+
+---
+
+## Function Signature
+
+```typescript
+getIntlayer(
+  key: DictionaryKeys,                        // Обязательно
+  localeOrSelector?: LocalesValues | DictionarySelector, // Опционально
+  plugins?: Plugins[]                         // Опционально
+): DeepTransformContent<...>
+```
+
+---
+
+## Параметры
+
+- `key: DictionaryKeys`
+  - **Description**: Ключ словаря для чтения, объявленный в ваших файлах контента.
+  - **Type**: `DictionaryKeys` — объединение всех объявленных ключей словаря.
+  - **Required**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Description**: Локаль для интерпретации контента или объект селектора для [динамических словарей](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/index.md).
+    - `'fr'` — локаль
+    - `{ item: 2 }` — элемент [коллекции](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/collections.md) (опустите `item` чтобы получить все элементы как массив)
+    - `{ variant: 'black-friday' }` — именованный [вариант](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/variants.md) (опустите для `default` варианта)
+    - `{ variant: { id: 'prod_abc', userId: '123' } }` — структурированный вариант
+    - Любой селектор может содержать локаль: `{ item: 2, locale: 'fr' }`
+  - **Type**: `LocalesValues | DictionarySelector`
+  - **Required**: No (Optional) — по умолчанию используется настроенная `defaultLocale`.
+
+- `plugins: Plugins[]`
+  - **Description**: Пользовательские трансформеры узлов, заменяющие базовые плагины интерпретатора. Только для продвинутого использования; опустите для сохранения поведения по умолчанию.
+  - **Type**: `Plugins[]`
+  - **Required**: No (Optional)
+
+### Возвращаемое значение
+
+- **Type**: Интерпретированное содержимое словаря, типизированное из вашего объявления.
+- **Description**: Простой объект, отражающий поле `content` вашего словаря, где каждый узел Intlayer разрешен на его финальное значение для запрошенной локали.
+
+---
+
+## Пример использования
+
+### Базовое использование
+
+```typescript fileName="src/app.content.ts" codeFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const appContent = {
+  key: "app",
+  content: {
+    title: t({
+      ru: "Привет",
+      en: "Hello",
+      fr: "Bonjour",
+    }),
+  },
+} satisfies Dictionary;
+
+export default appContent;
+```
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer("app", "fr"); // "Bonjour"
+```
+
+### Без локали
+
+Если пропустить параметр locale, контент будет интерпретирован с использованием `defaultLocale`, объявленной в вашей [конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md).
+
+```typescript
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer("app"); // Интерпретируется с локалью по умолчанию
+```
+
+### Внутри обработчика сервера
+
+```typescript fileName="src/routes/greeting.ts" codeFormat="typescript"
+import { getIntlayer, getLocale } from "intlayer";
+
+export const greetingHandler = async (request: Request) => {
+  const locale = await getLocale({
+    getHeader: (name) => request.headers.get(name) ?? undefined,
+  });
+
+  const { title } = getIntlayer("app", locale);
+
+  return Response.json({ title });
+};
+```
+
+### С селектором (коллекции и варианты)
+
+```typescript
+import { getIntlayer } from "intlayer";
+
+// Один элемент коллекции
+const secondPost = getIntlayer("blog-post", { item: 2, locale: "fr" });
+
+// Все элементы коллекции, как упорядоченный массив
+const allPosts = getIntlayer("blog-post", { locale: "fr" });
+
+// Именованный вариант
+const banner = getIntlayer("banner", { variant: "black-friday", locale: "fr" });
+```
+
+---
+
+## Примечания о поведении
+
+### Кеширование
+
+Результаты кешируются на уровне модуля с ключом `key + locale + selector`. Повторные вызовы `getIntlayer("app", "fr")` интерпретируют словарь один раз и впоследствии возвращают тот же объект.
+
+### Отсутствующие словари
+
+В процессе разработки запрос ключа, для которого не был сгенерирован словарь, регистрирует предупреждение один раз и возвращает безопасный резервный прокси: чтение `content.title` возвращает строку `"app.title"` вместо выброса ошибки. Это позволяет странице оставаться функциональной во время исправления недостающей декларации. Запустите сборку Intlayer (или сервер разработки), чтобы словарь был сгенерирован.
+
+### Размер бандла
+
+`getIntlayer` читает объединённый словарь, который содержит **все** локали. В клиентских бандлах [плагины сборки](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/bundle_optimization.md) переписывают вызов так, чтобы отправлялось только необходимое содержимое. Когда вы читаете содержимое вне рендеринга (метаданные, загрузчики, серверные функции) и хотите загрузить одну локаль по требованию, используйте [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getIntlayerAsync.md).
+
+---
+
+## Связанные функции
+
+- [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getIntlayerAsync.md): Асинхронный аналог для загрузки одного языкового chunk'а.
+- [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getDictionary.md): Интерпретирует объект словаря, который вы передаёте сами, вместо поиска по ключу.
+- [`useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/react-intlayer/useIntlayer.md): Эквивалент React hook'а, читающий локаль из провайдера.
+
+---
+
+## TypeScript
+
+```typescript
+function getIntlayer<
+  const T extends DictionaryKeys,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  key: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): DeepTransformContent<
+  DictionaryRegistryResult<T, A>,
+  IInterpreterPluginState,
+  ExtractSelectorLocale<A>
+>;
+```

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

@@ -0,0 +1,141 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: Документация функции getIntlayerAsync | intlayer
+description: Узнайте, как использовать функцию getIntlayerAsync для пакета intlayer
+keywords:
+  - getIntlayerAsync
+  - dictionary
+  - dynamic import
+  - metadata
+  - bundle optimization
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getIntlayerAsync
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Документация: функция `getIntlayerAsync` в `intlayer`
+
+## Описание
+
+Функция `getIntlayerAsync` выбирает один словарь по его ключу и разрешает его содержимое для заданной локали, **загружая только эту локаль**.
+
+Это асинхронный аналог [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getIntlayer.md), предназначенный для мест, где словарь читается вне рендеринга — построители маршрута `head` / метаданных, загрузчики, серверные функции.
+
+В то время как `getIntlayer` подгружает объединённый словарь, содержащий все локали, [плагины сборки](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/bundle_optimization.md) (`@intlayer/babel`, `@intlayer/swc`) переписывают этот вызов в `getDictionaryAsync(loaderMap, key, locale)`, указывая на части для каждой локали в `.intlayer/dynamic_dictionaries/`. Таким образом, бандл никогда не содержит ничего, кроме фактически запрошенной локали.
+
+Без этих плагинов — при неоптимизированной сборке — вызов разрешается через синхронный реестр словарей вместо этого: то же содержимое, но без разделения по локалям.
+
+**Ключевые особенности:**
+
+- Те же типизированные ключи, селекторы и возвращаемое содержимое, что и в `getIntlayer`
+- Загружает только запрошенный фрагмент локали в оптимизированных сборках
+- Одновременные вызовы для одного и того же фрагмента используют единую загрузку
+- Безопасно использовать в `async` построителях метаданных, загрузчиках и серверных функциях
+
+---
+
+## Сигнатура функции
+
+```typescript
+getIntlayerAsync(
+  key: DictionaryKeys,                        // Обязательно
+  localeOrSelector?: LocalesValues | DictionarySelector, // Опционально
+  plugins?: Plugins[]                         // Опционально
+): Promise<DeepTransformContent<...>>
+```
+
+---
+
+## Параметры
+
+- `key: DictionaryKeys`
+  - **Описание**: Ключ словаря для чтения, как объявлено в ваших файлах контента.
+  - **Тип**: `DictionaryKeys` — объединение всех объявленных ключей словаря.
+  - **Обязательно**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Описание**: Локаль для интерпретации контента или объект селектора для [динамических словарей](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/index.md).
+    - `'fr'` — локаль
+    - `{ item: 2 }` — элемент [коллекции](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/collections.md) (опустите `item`, чтобы получить все элементы в виде массива)
+    - `{ variant: 'black-friday' }` — именованный [вариант](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/variants.md) (опустите для получения `default`)
+    - `{ variant: { id: 'prod_abc', userId: '123' } }` — структурированный вариант
+    - Любой селектор может содержать локаль: `{ item: 2, locale: 'fr' }`
+  - **Тип**: `LocalesValues | DictionarySelector`
+  - **Обязательно**: No (Optional) — по умолчанию используется настроенный `defaultLocale`.
+
+- `plugins: Plugins[]`
+  - **Описание**: Пользовательские трансформаторы узлов, заменяющие базовые плагины интерпретатора. Только для продвинутого использования.
+  - **Тип**: `Plugins[]`
+  - **Обязательно**: No (Optional)
+
+### Возвращаемое значение
+
+- **Type**: `Promise<Content>` — обещание, разрешаемое в интерпретированное содержимое словаря, типизированное из вашего объявления.
+
+---
+
+## Пример использования
+
+### Основное использование
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getIntlayerAsync } from "intlayer";
+
+const { title } = await getIntlayerAsync("app", "fr"); // "Bonjour"
+```
+
+---
+
+## `getIntlayer` vs `getIntlayerAsync`
+
+|                    | [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getIntlayer.md) | `getIntlayerAsync`                                 |
+| ------------------ | --------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
+| Returns            | Контент                                                                                                         | Обещание (promise) контента                        |
+| Dictionary loaded  | Объединённый словарь (все локали)                                                                               | Только фрагмент запрошенной локали                 |
+| Best suited for    | Рендеринг, синхронные пути кода                                                                                 | Метаданные, загрузчики, серверные функции          |
+| Requires a plugin? | Нет                                                                                                             | Нет — разделение по локалям требует плагины сборки |
+
+Обе функции принимают одинаковые аргументы и возвращают одинаковый контент: переключение между ними изменяет только **когда** и **сколько** загружается.
+
+---
+
+## Связанные функции
+
+- [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getIntlayer.md): Синхронный эквивалент, читающий объединённый словарь.
+- [`getDictionaryAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getDictionaryAsync.md): Функция нижнего уровня, в которую переписывают вызовы плагины сборки.
+- [`getLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getLocale.md): Определяет локаль входящего запроса.
+
+---
+
+## TypeScript
+
+```typescript
+function getIntlayerAsync<
+  const T extends DictionaryKeys,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  key: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): Promise<
+  DeepTransformContent<
+    DictionaryRegistryResult<T, A>,
+    IInterpreterPluginState,
+    ExtractSelectorLocale<A>
+  >
+>;
+```

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

@@ -31,6 +31,8 @@ author: aymericzip
 
 Функция `getLocalizedPath` преобразует канонический путь (внутренний путь приложения) в его локализованный эквивалент на основе указанной локали и правил перезаписи. Она особенно полезна для генерации SEO-дружественных URL, которые различаются по языку.
 
+Это относительный аналог [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getLocalizedUrl.md) — для относительного входного значения оба возвращают одинаковое значение. В отличие от `getLocalizedUrl`, он никогда не возвращает абсолютный URL: конфигурация `domains` игнорируется, поэтому локаль, обслуживаемая со своего собственного домена, все равно возвращает путь. Абсолютный входной URL принимается, но его origin отбрасывается — сохраняются только путь, строка запроса и фрагмент.
+
 **Ключевые возможности:**
 
 - Поддерживает динамические параметры маршрута, использующие синтаксис `[param]`.
@@ -60,13 +62,17 @@ getLocalizedPath(
   - **Тип**: `string`
   - **Обязательный**: Да
 
-- `locale: Locales`
-  - **Описание**: Целевая локаль, для которой должен быть локализован путь.
-  - **Тип**: `Locales`
-  - **Обязательный**: Да
-
 ### Необязательные параметры
 
+- `locale?: Locales`
+  - **Description**: Целевой язык, для которого должен быть локализован путь.
+  - **Type**: `Locales`
+  - **Default**: Язык по умолчанию конфигурации вашего проекта.
+
+- `options?: object`
+  - **Description**: Переопределения маршрутизации. Каждая запись использует конфигурацию вашего проекта по умолчанию.
+  - **Type**: `object`
+
 - `rewriteRules?: RoutingConfig['rewrite']`
   - **Описание**: Объект, определяющий пользовательские правила перезаписи. Если не указан, по умолчанию используется свойство `routing.rewrite` из конфигурации проекта.
   - **Тип**: `RoutingConfig['rewrite']`
@@ -79,6 +85,28 @@ getLocalizedPath(
 - **Тип**: `string`
 - **Описание**: Локализованный путь для указанной локали.
 
+Тип сужается на основе правил переписи, объявленных в вашей конфигурации, поэтому редактор показывает разрешённый путь вместо простой `string`:
+
+```typescript codeFormat="typescript"
+// Конфигурация: режим 'prefix-no-default', defaultLocale 'en',
+//                { '/about': { fr: '/a-propos' }, '/product/[id]': { fr: '/produit/[id]' } }
+const about = getLocalizedPath("/about", Locales.FRENCH);
+//    ^? '/fr/a-propos'
+const product = getLocalizedPath("/product/123", Locales.FRENCH);
+//    ^? '/fr/produit/123'
+const contact = getLocalizedPath("/contact", Locales.FRENCH);
+//    ^? '/fr/contact'  (нет подходящего правила переписания, применяется только префикс)
+const home = getLocalizedPath("/", Locales.FRENCH);
+//    ^? '/fr'
+```
+
+То же сужение переходит в [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getLocalizedUrl.md), которая применяет правила переписи перед добавлением префикса локали.
+
+Два случая остаются расширенными до `string`, поскольку они не могут быть разрешены во время компиляции:
+
+- путь, который не является строковым литералом (например, построенный из переменной);
+- путь, соответствующий правилу с многосегментным или необязательным параметром (`[...slug]`, `[[...slug]]`, `:param?`).
+
 ---
 
 ## Пример использования
@@ -126,6 +154,18 @@ getLocalizedPath("/contact", Locales.FRENCH, manualRules);
 // Вывод: "/contactez-nous"
 ```
 
+### Опущение локали
+
+Когда локаль не указана, путь локализируется для настроенной локали по умолчанию:
+
+```typescript codeFormat="typescript"
+import { getLocalizedPath } from "intlayer";
+
+// Конфигурация: defaultLocale = Locales.ENGLISH, { '/about': { en: '/about', fr: '/a-propos' } }
+getLocalizedPath("/about");
+// Вывод: "/about"
+```
+
 ---
 
 ## Связанные функции

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

@@ -143,36 +143,6 @@ getLocalizedUrl(
 // Вывод: "/about" для локали по умолчанию (английский)
 ```
 
-```javascript codeFormat="esm"
-import { getLocalizedUrl, Locales } from "intlayer";
-
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH],
-  Locales.ENGLISH,
-  false
-);
-
-// Вывод: "/fr/about" для французской локали
-// Вывод: "/about" для локали по умолчанию (английский)
-```
-
-```javascript codeFormat="commonjs"
-const { getLocalizedUrl, Locales } = require("intlayer");
-
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH],
-  Locales.ENGLISH,
-  false
-);
-
-// Вывод: "/fr/about" для французской локали
-// Вывод: "/about" для локали по умолчанию (английский)
-```
-
 ### Частичное переопределение конфигурации
 
 Вы также можете предоставить только некоторые необязательные параметры. Функция будет использовать конфигурацию вашего проекта для любых параметров, которые вы не указали:
@@ -249,6 +219,12 @@ getLocalizedUrl(
 - **Неподдерживаемые локали:**
   - Для локалей, не указанных в списке `locales`, функция не применяет никакого префикса.
 
+- **Режимы маршрутизации:**
+  - `'prefix-no-default'`: Локаль по умолчанию не имеет префикса, остальные имеют (например, `/about`, `/fr/about`)
+  - `'prefix-all'`: Все локали имеют префиксы (например, `/en/about`, `/fr/about`)
+  - `'no-prefix'`: Нет префиксов локалей в URL (локаль обрабатывается в другом месте)
+  - `'search-params'`: Локаль указана через параметр запроса (например, `/about?locale=fr`)
+
 ---
 
 ## Использование в приложениях

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

@@ -138,8 +138,6 @@ getMultilingualUrls(
 // }
 ```
 
----
-
 ### Различные режимы маршрутизации
 
 ```typescript
@@ -205,6 +203,12 @@ getMultilingualUrls("/dashboard", {
 - **Неподдерживаемые локали:**
   - Для генерации URL учитываются только локали, указанные в массиве `locales`.
 
+- **Режимы маршрутизации:**
+  - `'prefix-no-default'`: Локаль по умолчанию без префикса, остальные с префиксом (например, `/dashboard`, `/fr/dashboard`)
+  - `'prefix-all'`: Все локали с префиксами (например, `/en/dashboard`, `/fr/dashboard`)
+  - `'no-prefix'`: Отсутствие префиксов локалей в URL (все локали возвращают одинаковый URL)
+  - `'search-params'`: Локаль указывается через параметр запроса (например, `/dashboard?locale=fr`)
+
 ---
 
 ## Использование в приложениях

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

@@ -31,6 +31,8 @@ author: aymericzip
 
 Функция `getTranslationContent` извлекает содержимое, соответствующее определённой локали, из набора настраиваемого языкового контента. Если указанная локаль не найдена, по умолчанию возвращается содержимое для локали по умолчанию, настроенной в проекте.
 
+Для получения дополнительной информации о том, как объявлять переводы, см. [документацию по переводам](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/translation.md).
+
 ## Параметры
 
 - `languageContent: CustomizableLanguageContent<Content>`

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

@@ -102,37 +102,6 @@ export const ServerComponentExample: FC = () => (
 );
 ```
 
-###Встроенные переводы в атрибутах
-
-Функция `t` особенно полезна для встроенных переводов в атрибутах JSX.
-При локализации атрибутов, таких как `alt`, `title`, `href` или `aria-label`, вы можете использовать `t` непосредственно внутри атрибута.
-
-```jsx
-<button
-  aria-label={t({
-    en: "Submit",
-    fr: "Soumettre",
-    es: "Enviar",
-  })}
->
-  {t({
-    en: "Submit",
-    fr: "Soumettre",
-    es: "Enviar",
-  })}
-  <img
-    src="/path/to/image"
-    alt={t({
-      en: "A beautiful scenery",
-      fr: "Un beau paysage",
-      es: "Un hermoso paisaje",
-    })}
-  />
-</button>
-```
-
----
-
 ### Встроенные переводы в атрибутах
 
 Функция `t` особенно полезна для встроенных переводов в атрибутах JSX.
@@ -192,6 +161,23 @@ const greeting = t(translations);
 
 #### Пример:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx codeFormat={["typescript", "esm", "commonjs"]}
+import type { FC, ReactNode } from "react";
+import type { Locales } from "intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const Page: FC<{ locale: Locales; children: ReactNode }> = ({
+  locale,
+  children,
+}) => <IntlayerProvider locale={locale}>{children}</IntlayerProvider>;
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx codeFormat={["typescript", "esm", "commonjs"]}
 import type { FC } from "react";
 import type { Locales } from "intlayer";
@@ -207,6 +193,9 @@ const Page: FC<{ locale: Locales }> = ({ locale }) => (
 );
 ```
 
+ </Tab>
+</Tabs>
+
 ---
 
 ## Распространённые ошибки и устранение неполадок

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

@@ -79,6 +79,34 @@ author: aymericzip
 
 Ниже показано, как можно использовать хук `useIntlayer` на странице Next.js для динамической загрузки локализованного контента в зависимости от текущей локали приложения:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
+import { ClientComponentExample } from "@components/ClientComponentExample";
+import { ServerComponentExample } from "@components/ServerComponentExample";
+import { type NextPageIntlayer } from "next-intlayer";
+import { useIntlayer } from "next-intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const HomePage: NextPageIntlayer = async ({ params }) => {
+  const { locale } = await params;
+
+  const content = useIntlayer("homepage", locale);
+
+  return (
+    <IntlayerProvider locale={locale}>
+      <p>{content.introduction}</p>
+      <ClientComponentExample />
+      <ServerComponentExample />
+    </IntlayerProvider>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
 import { ClientComponentExample } from "@components/ClientComponentExample";
 import { ServerComponentExample } from "@components/ServerComponentExample";
@@ -104,6 +132,9 @@ const HomePage: NextPageIntlayer = async ({ params }) => {
 };
 ```
 
+</Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ClientComponentExample.tsx" codeFormat={["typescript", "esm"]}
 "use-client";
 

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

@@ -104,6 +104,8 @@ const LocaleSwitcher: FC = () => {
 
 ## Возвращаемые значения
 
+При вызове hook `useLocale` он возвращает объект, содержащий следующие свойства:
+
 - **`locale`**: Текущая локаль, установленная в контексте React.
 - **`defaultLocale`**: Основная локаль, определённая в конфигурации.
 - **`availableLocales`**: Список всех доступных локалей, определённых в конфигурации.

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

@@ -30,8 +30,6 @@ author: aymericzip
 
 ## Пример использования в React
 
-Ниже приведён пример использования хука `useDictionary` в React-компоненте:
-
 ```tsx fileName="./ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useDictionary } from "react-intlayer";