@intlayer/docs 9.3.3 → 9.4.0

package/docs/ru/migration_from_react-i18next_to_intlayer.md

@@ -46,7 +46,7 @@ Intlayer также является **наиболее активно разв
 
 <Accordion header="ИИ Агенты">
 
-Колокация контента **сокращает контекст, необходимый для работы** Больших Языковых Моделей (LLM). Intlayer также предоставляет набор инструментов, таких как **CLI** для тестирования отсутствующих переводов, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md)** и **[Навыки для Агентов (Agent Skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/agent_skills.md)**, чтобы сделать процесс разработки (DX) еще более плавным для ИИ-агентов.
+Колокация контента **сокращает контекст, необходимый для работы** Больших Языковых Моделей (LLM). Intlayer также предоставляет набор инструментов, таких как **CLI** для тестирования отсутствующих переводов, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md)** и **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/agent_skills.md)**, чтобы сделать процесс разработки (DX) еще более плавным для ИИ-агентов.
 
 </Accordion>
 

package/docs/ru/migration_from_vue-i18n_to_intlayer.md

@@ -45,7 +45,7 @@ Intlayer также является **наиболее активно разв
 
 <Accordion header="ИИ Агенты">
 
-Колокация контента **сокращает контекст, необходимый для работы** Больших Языковых Моделей (LLM). Intlayer также предоставляет набор инструментов, таких как **CLI** для тестирования отсутствующих переводов, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md)** и **[Навыки для Агентов (Agent Skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/agent_skills.md)**, чтобы сделать процесс разработки (DX) еще более плавным для ИИ-агентов.
+Колокация контента **сокращает контекст, необходимый для работы** Больших Языковых Моделей (LLM). Intlayer также предоставляет набор инструментов, таких как **CLI** для тестирования отсутствующих переводов, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md)** и **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/agent_skills.md)**, чтобы сделать процесс разработки (DX) еще более плавным для ИИ-агентов.
 
 </Accordion>
 

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

@@ -0,0 +1,136 @@
+---
+createdAt: 2026-08-24
+updatedAt: 2026-08-24
+title: Документация пакета elysia-intlayer
+description: Плагин Elysia для Intlayer, предоставляющий функции перевода и определение локали.
+keywords:
+  - elysia-intlayer
+  - elysia
+  - plugin
+  - internationalization
+  - i18n
+slugs:
+  - doc
+  - packages
+  - elysia-intlayer
+  - exports
+history:
+  - version: 9.4.0
+    date: 2026-08-24
+    changes: "Унифицированная документация для всех экспортов"
+author: aymericzip
+---
+
+# Пакет elysia-intlayer
+
+Пакет `elysia-intlayer` предоставляет плагин для приложений на Elysia для работы с интернационализацией. Он определяет локаль пользователя и внедряет объект `intlayer` в контекст маршрута.
+
+## Установка
+
+```bash packageManager="npm"
+npm install intlayer elysia-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer elysia-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add intlayer elysia-intlayer
+```
+
+```bash packageManager="bun"
+bun add intlayer elysia-intlayer
+```
+
+> `elysia` — это peer dependency (`>=1.0.0`). Elysia рассчитан на runtime **Bun**.
+
+## Экспорты
+
+### Плагин
+
+Импорт:
+
+```ts
+import { intlayer } from "elysia-intlayer";
+```
+
+| Функция    | Описание                                                                                                                                                                                                                                                                                                                             | Связанная документация                                                                                         |
+| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | Плагин Elysia, который интегрирует Intlayer в ваше приложение Elysia. Обрабатывает определение локали из storage (cookies, headers), затем из `Accept-Language`, внедряет объект `intlayer`, предоставляющий `locale`, `t`, `getIntlayer` и `getDictionary`, в контекст маршрута и настраивает контекст запроса `AsyncLocalStorage`. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/elysia-intlayer/intlayer.md) |
+
+### Функции
+
+Импорт:
+
+```ts
+import { t, getIntlayer, getDictionary } from "elysia-intlayer";
+```
+
+| Функция         | Описание                                                                                                                                                                                                                                                                 | Связанная документация                                                                                 |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |
+| `t`             | Глобальная функция перевода, которая получает содержимое для текущей локали в Elysia. Использует `AsyncLocalStorage` для доступа к контексту запроса, настроенному плагином `intlayer`, и вне его возвращается к локали по умолчанию. Также доступна через `intlayer.t`. | [translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/translation.md) |
+| `getIntlayer`   | Получает словарь по его ключу из сгенерированной декларации и возвращает его содержимое для текущей локали. Оптимизированная версия `getDictionary`. Использует `AsyncLocalStorage` для доступа к контексту запроса. Также доступна через `intlayer.getIntlayer`.        | -                                                                                                      |
+| `getDictionary` | Обрабатывает объекты словарей и возвращает содержимое для текущей локали. Обрабатывает переводы `t()`, перечисления, markdown, HTML и т.д. Использует `AsyncLocalStorage` для доступа к контексту запроса. Также доступна через `intlayer.getDictionary`.                | -                                                                                                      |
+
+### Типы
+
+Импорт:
+
+```ts
+import type { IntlayerContext, TranslateFunction } from "elysia-intlayer";
+```
+
+| Тип                 | Описание                                                                                                                                                               |
+| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `IntlayerContext`   | Форма объекта `intlayer`, внедряемого в каждый контекст маршрута: `locale`, `locale_storage`, `locale_detected`, `defaultLocale`, `t`, `getIntlayer`, `getDictionary`. |
+| `TranslateFunction` | Сигнатура функции перевода, преобразующей locale map в содержимое, соответствующее локали текущего запроса.                                                            |
+
+## Использование
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { getDictionary, getIntlayer, intlayer, t } from "elysia-intlayer";
+import dictionaryExample from "./index.content";
+
+const app = new Elysia()
+  // Загрузка плагина интернационализации
+  .use(intlayer())
+  // Читаем локаль и helpers из контекста маршрута
+  .get("/", ({ intlayer }) => ({
+    locale: intlayer!.locale,
+    greeting: intlayer!.t({
+      ru: "Привет",
+      en: "Hello",
+      fr: "Bonjour",
+      es: "Hola",
+    }),
+    content: intlayer!.getIntlayer("index").exampleOfContent,
+  }))
+  // Или используем standalone helpers, привязанные к текущему запросу
+  .get("/t_example", () =>
+    t({
+      ru: "Пример возвращаемого контента на русском",
+      en: "Example of returned content in English",
+      fr: "Exemple de contenu renvoyé en français",
+      es: "Ejemplo de contenido devuelto en español",
+    })
+  )
+  .get("/getIntlayer_example", () => getIntlayer("index").exampleOfContent)
+  .get(
+    "/getDictionary_example",
+    () => getDictionary(dictionaryExample).exampleOfContent
+  )
+  .listen(3000);
+
+console.log(
+  `🦊 Elysia is running at ${app.server?.hostname}:${app.server?.port}`
+);
+```
+
+> Плагин регистрирует свой контекст через **глобальный** `derive`, который Elysia типизирует как `Partial<{ intlayer: IntlayerContext }>`. Во время выполнения значение всегда присутствует для маршрутов, зарегистрированных после `.use(intlayer())`, поэтому используйте non-null assertion (`intlayer!.locale`) — или optional chaining — чтобы удовлетворить TypeScript в режиме `strict`.
+
+## Связанная документация
+
+- [Elysia i18n - Полное руководство по переводу вашего приложения](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_elysia.md)
+- [Конфигурация](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md)

package/docs/ru/packages/elysia-intlayer/intlayer.md

@@ -0,0 +1,139 @@
+---
+createdAt: 2026-08-24
+updatedAt: 2026-08-24
+title: Документация плагина intlayer для Elysia | elysia-intlayer
+description: Узнайте, как использовать плагин intlayer из пакета elysia-intlayer
+keywords:
+  - intlayer
+  - elysia
+  - plugin
+  - Intlayer
+  - Интернационализация
+  - Документация
+slugs:
+  - doc
+  - packages
+  - elysia-intlayer
+  - intlayer
+history:
+  - version: 9.4.0
+    date: 2026-08-24
+    changes: "Инициализация документации"
+author: aymericzip
+---
+
+# Документация плагина intlayer для Elysia
+
+Плагин `intlayer` для Elysia определяет локаль пользователя и внедряет объект `intlayer` в контекст маршрута. Он также позволяет использовать глобальные функции перевода в контексте запроса.
+
+## Использование
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { intlayer } from "elysia-intlayer";
+
+const app = new Elysia().use(intlayer()).get("/", ({ intlayer }) =>
+  intlayer!.t({
+    ru: "Привет",
+    en: "Hello",
+    fr: "Bonjour",
+    es: "Hola",
+  })
+);
+```
+
+> Плагин регистрирует свой контекст через **глобальный** `derive`, который Elysia типизирует как `Partial<{ intlayer: IntlayerContext }>`. Во время выполнения значение всегда присутствует для маршрутов, зарегистрированных после `.use(intlayer())`, поэтому используйте non-null assertion (`intlayer!.t`) — или optional chaining — чтобы удовлетворить TypeScript в режиме `strict`.
+
+Те же хелперы доступны как отдельные экспорты, поэтому их можно вызывать без деструктуризации контекста маршрута:
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { intlayer, t } from "elysia-intlayer";
+
+const app = new Elysia().use(intlayer()).get("/", () =>
+  t({
+    ru: "Привет",
+    en: "Hello",
+    fr: "Bonjour",
+    es: "Hola",
+  })
+);
+```
+
+## Описание
+
+Плагин выполняет следующие задачи:
+
+1. **Определение локали**: Он считывает локаль, явно заданную клиентом, из storage (cookie, header), а затем возвращается к локали, согласованной по заголовку `Accept-Language`.
+2. **Внедрение в контекст**: Добавляет свойство `intlayer` в контекст маршрута Elysia (см. таблицу «Контекст маршрута» ниже).
+3. **Управление контекстом**: Использует `AsyncLocalStorage` для управления асинхронным контекстом, позволяя глобальным функциям Intlayer (`t`, `getIntlayer`, `getDictionary`) получать доступ к локали, специфичной для запроса, без передачи объекта контекста.
+4. **Подготовка словарей**: Вызывает `prepareIntlayer` при создании плагина, поэтому словари собираются при старте приложения.
+
+### Контекст маршрута
+
+| Свойство          | Тип                    | Описание                                                                                        |
+| ----------------- | ---------------------- | ----------------------------------------------------------------------------------------------- |
+| `locale`          | `Locale`               | Локаль, используемая для этого запроса; `locale_storage` имеет приоритет над `locale_detected`. |
+| `locale_storage`  | `Locale` (опционально) | Локаль, явно запрошенная клиентом через cookie или header.                                      |
+| `locale_detected` | `Locale`               | Локаль, согласованная по заголовкам запроса.                                                    |
+| `defaultLocale`   | `Locale`               | Локаль, настроенная как fallback в `intlayer.config.ts`.                                        |
+| `t`               | `TranslateFunction`    | Функция перевода.                                                                               |
+| `getIntlayer`     | `typeof getIntlayer`   | Функция для получения словарей по ключу.                                                        |
+| `getDictionary`   | `typeof getDictionary` | Функция для обработки объектов словарей.                                                        |
+
+> В отличие от плагинов Intlayer, основанных на Node, `elysia-intlayer` опирается на `AsyncLocalStorage` вместо `cls-hooked`, потому что `cls-hooked` зависит от `async_hooks.createHook`, который Bun не реализует.
+
+Контекст запроса освобождается сразу после маппинга ответа, поэтому отдельные хелперы никогда не разрешаются относительно уже завершённого запроса. При вызове вне запроса, обрабатываемого плагином, они возвращаются к настроенной локали по умолчанию.
+
+## Порядок определения локали
+
+По умолчанию плагин определяет локаль в следующем порядке:
+
+1. Cookie `INTLAYER_LOCALE`.
+2. Заголовок `x-intlayer-locale`.
+3. Согласование через заголовок `Accept-Language`.
+4. Настроенная `defaultLocale`.
+
+```bash
+# Согласовано из `Accept-Language`
+curl -H "Accept-Language: fr" http://localhost:3000/
+# Bonjour
+
+# Cookie имеет приоритет над `Accept-Language`
+curl -H "Accept-Language: fr" -H "Cookie: INTLAYER_LOCALE=es" http://localhost:3000/
+# Hola
+
+# Заголовок имеет приоритет над `Accept-Language`
+curl -H "Accept-Language: fr" -H "x-intlayer-locale: es" http://localhost:3000/
+# Hola
+```
+
+## Конфигурация
+
+Плагин читает ваш файл `intlayer.config.ts`. Вы можете настроить cookie и header, используемые для определения локали:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
+  },
+};
+
+export default config;
+```
+
+> Дополнительную информацию о конфигурации смотрите в [документации по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md).
+
+## Связанная документация
+
+- [Документация пакета elysia-intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/elysia-intlayer/exports.md)
+- [Elysia i18n - Полное руководство по переводу вашего приложения](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_elysia.md)

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

@@ -0,0 +1,155 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: Документация функции getDictionary | intlayer
+description: Узнайте, как использовать функцию getDictionary в пакете intlayer
+keywords:
+  - getDictionary
+  - dictionary
+  - interpreter
+  - content
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getDictionary
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Документация: функция `getDictionary` в `intlayer`
+
+## Описание
+
+Функция `getDictionary` интерпретирует словарь **объект, который вы передаёте сами**, и возвращает его разрешённое содержимое для заданной локали. Она проходит содержимое в один проход и применяет каждый плагин интерпретатора по мере необходимости, разрешая переводы `t()`, перечисления, условия, вставки, вложенность, markdown, HTML и узлы файлов.
+
+В отличие от [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getIntlayer.md), которая ищет словарь по ключу в сгенерированном реестре, `getDictionary` принимает сам словарь. Это делает её правильным инструментом для содержимого, построенного во время выполнения, полученного из API или CMS, или объявленного встроенно в тесте.
+
+**Ключевые особенности:**
+
+- Работает с любым объектом, следующим структуре словаря (`{ key, content }`)
+- Также принимает квалифицированную группу словаря (коллекции, варианты) вместе с селектором
+- Полностью типизирована: возвращаемый объект отражает `content`, который вы передали
+- Принимает пользовательские плагины интерпретатора
+
+---
+
+## Сигнатура функции
+
+```typescript
+getDictionary(
+  dictionary: Dictionary | QualifiedDictionaryGroup, // Обязательно
+  localeOrSelector?: LocalesValues | DictionarySelector, // Опционально
+  plugins?: Plugins[]                                // Опционально
+): DeepTransformContent<...>
+```
+
+---
+
+## Параметры
+
+- `dictionary: Dictionary | QualifiedDictionaryGroup`
+  - **Description**: Словарь (или квалифицированная группа словарей) для интерпретации.
+  - **Type**: `Dictionary | QualifiedDictionaryGroup`
+  - **Required**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Description**: Локаль для интерпретации содержимого или объект селектора (`{ item }`, `{ variant }`, опционально с `locale`). См. [dynamic dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/index.md).
+  - **Type**: `LocalesValues | DictionarySelector`
+  - **Required**: No (Optional) — defaults to the configured `defaultLocale`.
+
+- `plugins: Plugins[]`
+  - **Description**: Массив преобразователей узлов, определяющих способ интерпретации распознанных узлов. Если не указано, используется набор плагинов интерпретатора по умолчанию.
+  - **Type**: `Plugins[]`
+  - **Required**: No (Optional)
+
+### Возвращаемое значение
+
+- **Type**: The interpreted content of the dictionary.
+- **Description**: The `content` you passed, with every Intlayer node resolved for the requested locale. For a collection group without an `item` selector, an ordered array of interpreted entries is returned; `null` is returned when the selector targets nothing.
+
+---
+
+## Пример использования
+
+### Базовое использование
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getDictionary, t } from "intlayer";
+
+const content = getDictionary(
+  {
+    key: "my_key",
+    content: {
+      greeting: t({
+        ru: "Привет",
+        en: "Hello",
+        fr: "Bonjour",
+      }),
+    },
+  },
+  "ru"
+);
+
+console.log(content.greeting); // "Привет"
+```
+
+### Интерпретация контента, полученного во время выполнения
+
+```typescript
+import { getDictionary, type Dictionary } from "intlayer";
+
+const remoteDictionary: Dictionary = await fetch("/api/cms/banner").then(
+  (res) => res.json()
+);
+
+const banner = getDictionary(remoteDictionary, "fr");
+```
+
+### С селектором
+
+```typescript
+import { getDictionary } from "intlayer";
+
+// Квалифицированная группа словаря разрешается в одну запись…
+const secondItem = getDictionary(blogPostGroup, { item: 2, locale: "fr" });
+
+// …или в упорядоченный массив, если `item` не указан
+const allItems = getDictionary(blogPostGroup, { locale: "fr" });
+```
+
+---
+
+## Связанные функции
+
+- [`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): Аналог для карт загрузчиков для каждой локали.
+- [`useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/react-intlayer/useDictionary.md): Эквивалент React хука, читающий локаль от провайдера.
+
+---
+
+## TypeScript
+
+```typescript
+function getDictionary<
+  const T extends Dictionary | QualifiedDictionaryGroup,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  dictionary: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): DeepTransformContent<
+  ResolveQualifiedDictionaryContent<T, A>,
+  IInterpreterPluginState,
+  ExtractSelectorLocale<A>
+>;
+```

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

@@ -0,0 +1,166 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: Документация функции getDictionaryAsync | intlayer
+description: Узнайте, как использовать функцию getDictionaryAsync для пакета intlayer
+keywords:
+  - getDictionaryAsync
+  - dictionary
+  - dynamic dictionaries
+  - loader map
+  - bundle optimization
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getDictionaryAsync
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Документация: Функция `getDictionaryAsync` в `intlayer`
+
+## Описание
+
+Функция `getDictionaryAsync` загружает **единый языковой chunk** словаря и возвращает его интерпретированное содержимое.
+
+Это аналог [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getDictionary.md) для maps загрузчиков для отдельных языков, выпускаемых в `.intlayer/dynamic_dictionaries/`: вместо получения словаря со всеми языками он получает map загрузчика и ожидает только chunk для запрошенного языка.
+
+> В коде приложения вы обычно вызываете [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getIntlayerAsync.md), а не эту функцию. [Плагины сборки](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/bundle_optimization.md) переписывают каждый вызов `getIntlayerAsync('key', locale)` на `getDictionaryAsync(loaderMap, 'key', locale)`. `getDictionaryAsync` экспортируется для пользовательских загрузчиков и для инструментов, которые создают свои собственные maps загрузчиков.
+
+**Ключевые особенности:**
+
+- Загружает только запрошенный языковой chunk
+- Поддерживает простые (`locale → loader`) и квалифицированные (`locale → qualifierId → loader`) maps загрузчиков
+- Дедублирует одновременные загрузки одного chunk и кэширует разрешенное содержимое
+- Неудачные загрузки удаляются из кэша, поэтому последующий вызов повторит попытку загрузки chunk
+
+---
+
+## Сигнатура функции
+
+```typescript
+getDictionaryAsync(
+  dictionaryLoaders: PlainDynamicLoaderMap | QualifiedDynamicLoaderMap, // Обязательно
+  key: string,                                           // Обязательно
+  localeOrSelector?: LocalesValues | DictionarySelector, // Опционально
+  plugins?: Plugins[]                                    // Опционально
+): Promise<DeepTransformContent<...>>
+```
+
+---
+
+## Параметры
+
+- `dictionaryLoaders: PlainDynamicLoaderMap | QualifiedDynamicLoaderMap`
+  - **Description**: Карта загрузчиков для каждой локали. Простые карты связывают локаль с загрузчиком; квалифицированные карты (используются коллекциями и вариантами) связывают локаль с идентификатором квалификатора, затем с загрузчиком. Для квалифицированной карты загружаются только фрагменты, на которые указывает селектор.
+  - **Type**: `PlainDynamicLoaderMap<T> | QualifiedDynamicLoaderMap`
+  - **Required**: Yes
+
+- `key: string`
+  - **Description**: Ключ словаря, используется для разделения кэша фрагментов.
+  - **Type**: `string`
+  - **Required**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Description**: Локаль для интерпретации контента или объект селектора (`{ item }`, `{ variant }`, опционально с `locale`). См. [динамические словари](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/index.md).
+  - **Type**: `LocalesValues | DictionarySelector`
+  - **Required**: No (Optional) — по умолчанию используется настроенная `defaultLocale`.
+
+- `plugins: Plugins[]`
+  - **Description**: Node трансформеры. По умолчанию используется базовый набор интерпретатора.
+  - **Type**: `Plugins[]`
+  - **Required**: No (Optional)
+
+### Returns
+
+- **Type**: `Promise<Content>` — a promise resolving to the interpreted content of the loaded chunk.
+- **Description**: Resolves to `null` when the map emits no chunk for the requested locale nor for any of its fallbacks, mirroring how a missing qualified coordinate resolves.
+
+---
+
+## Пример использования
+
+### С генерируемой картой загрузчика
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getDictionaryAsync } from "intlayer";
+import appLoaderMap from "../.intlayer/dynamic_dictionaries/app";
+
+const { title } = await getDictionaryAsync(appLoaderMap, "app", "fr");
+```
+
+### С пользовательской картой загрузчика
+
+```typescript
+import { getDictionaryAsync } from "intlayer";
+
+const loaderMap = {
+  en: () => import("./banner.en.json").then((mod) => mod.default),
+  fr: () => import("./banner.fr.json").then((mod) => mod.default),
+};
+
+const banner = await getDictionaryAsync(loaderMap, "banner", "fr");
+```
+
+### С селектором на квалифицированной карте
+
+```typescript
+import { getDictionaryAsync } from "intlayer";
+
+const promoBanner = await getDictionaryAsync(bannerLoaderMap, "banner", {
+  variant: "black-friday",
+  locale: "fr",
+});
+```
+
+---
+
+## Примечания о поведении
+
+### Кеширование и дедупликация
+
+Кеш сохраняет **promise** каждой тройки `key + locale + selector`, поэтому одновременные вызовы для одного chunk ждут одной загрузки. Отклоненная загрузка удаляется из кеша, поэтому неудавшийся chunk повторяется при следующем вызове вместо того, чтобы воспроизводить одну и ту же ошибку бесконечно.
+
+### Fallback локали
+
+Простая карта загрузчика следует той же цепочке fallback, что и синхронный режим: сначала запрашиваемая локаль, затем её fallbacks, затем `null`, если ни один из них не выдал chunk.
+
+---
+
+## Связанные функции
+
+- [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getIntlayerAsync.md): Функция, которую вызывают приложения; плагины сборки переписывают её в `getDictionaryAsync`.
+- [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getDictionary.md): Синхронный аналог, принимающий полный словарь.
+- [Dynamic dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/index.md): Collections и variants, а также генерируемые ими карты loader.
+
+---
+
+## TypeScript
+
+```typescript
+function getDictionaryAsync<
+  const T extends Dictionary,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  dictionaryLoaders: PlainDynamicLoaderMap<T> | QualifiedDynamicLoaderMap,
+  key: string,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): Promise<
+  DeepTransformContent<
+    T["content"],
+    IInterpreterPluginState,
+    ExtractSelectorLocale<A>
+  >
+>;
+```

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

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