@intlayer/docs 9.5.4 → 9.5.5

package/docs/ru/intlayer_with_remix_3.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-09-09
-updatedAt: 2026-09-11
+updatedAt: 2026-09-19
 title: "Remix 3 i18n - Полное руководство по переводу вашего приложения"
 description: "Забудьте об i18next. Руководство 2026 года по созданию многоязычного (i18n) приложения Remix 3. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:
@@ -19,6 +19,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-remix-3-template
 applicationShowcase: https://intlayer-remix-3-template.vercel.app
 history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Использование middleware и хуков remix-intlayer"
   - version: 9.5.0
     date: 2026-09-09
     changes: "Начальная документация для Remix 3"
@@ -39,7 +42,7 @@ author: aymericzip
 - **`remix/node-fetch-server`**: Серверные адаптеры для Node.js с нативной поддержкой Bun, Deno и edge-сред.
 - **`remix/cookie`**: Криптографически безопасный парсинг и сериализация файлов cookie.
 
-В сочетании с **Intlayer** вы получаете законченную систему интернационализации, обеспечивающую безопасность на этапе компиляции, автоматический перевод через ИИ, серверный рендеринг без накладных расходов и удобную маршрутизацию по локалям.
+В сочетании с **Intlayer** и пакетом **`remix-intlayer`**, middleware локали плюс те же хуки `useIntlayer` / `useDictionary` / `useLocale`, что и в `react-intlayer`, привязанные к контексту запроса Remix, вы получаете полноценную систему интернационализации, обеспечивающую безопасность типов во время компиляции, автоматические переводы с помощью ИИ, серверный рендеринг без накладных расходов и бесшовную маршрутизацию по локалям.
 
 ## Содержание
 
@@ -52,7 +55,7 @@ author: aymericzip
 <AccordionGroup>
 <Accordion header="Полная поддержка Remix 3 и веб-стандартов">
 
-Intlayer спроектирован для естественной работы с веб-стандартами (`Request`, `Response`, `Headers` и `URL`). Он легко интегрируется в Fetch-роутер Remix 3 через легковесное middleware, извлекая локали из путей URL, файлов cookie или заголовков `Accept-Language` без привязки к конкретной платформе.
+Intlayer разработан для естественной работы с веб-стандартами (`Request`, `Response`, `Headers` и `URL`). `remix-intlayer` подключается к роутеру Fetch Remix 3 как легковесное middleware, извлекая локаль из путей URL, cookie или заголовков `Accept-Language` и предоставляя ее остальной части запроса, обработчикам, представлениям и компонентам `remix/ui`, без необходимости передавать ее вручную или привязываться к определенной среде выполнения.
 
 </Accordion>
 <Accordion header="Типобезопасные объявления контента">
@@ -109,25 +112,26 @@ Intlayer размещает объявления контента (`.content.ts`
 <Steps>
 <Step number={1} title="Установка зависимостей">
 
-Установите `intlayer` и `remix` (версии 3) с помощью предпочитаемого пакетного менеджера:
+Установите `intlayer`, `remix-intlayer` и `remix` (версия 3) с помощью предпочитаемого пакетного менеджера:
 
 ```bash packageManager="npm"
-npm install intlayer remix@next
+npm install intlayer remix-intlayer remix@next
 ```
 
 ```bash packageManager="pnpm"
-pnpm add intlayer remix@next
+pnpm add intlayer remix-intlayer remix@next
 ```
 
 ```bash packageManager="yarn"
-yarn add intlayer remix@next
+yarn add intlayer remix-intlayer remix@next
 ```
 
 ```bash packageManager="bun"
-bun add intlayer remix@next
+bun add intlayer remix-intlayer remix@next
 ```
 
 - **`intlayer`**: Основной движок интернационализации, обеспечивающий управление конфигурацией, декларацию словарей (`t()`, `Dictionary`), утилиты CLI и рантайм-интерпретатор.
+- **`remix-intlayer`**: Интеграция с Remix 3: middleware роутера `intlayer()`, разрешающее локаль каждого запроса, и хуки `useIntlayer`, `useDictionary` и `useLocale`, считывающие ее ниже по цепочке.
 - **`remix`**: Единый пакет фреймворка Remix 3, экспортирующий `remix/router`, `remix/routes`, `remix/ui`, `remix/middleware/render` и `remix/node-fetch-server`.
 
 </Step>
@@ -254,65 +258,30 @@ bun x intlayer build
 Эта команда компилирует контент в каталог `.intlayer`, обеспечивая автодополнение TypeScript и быстрый поиск по словарям.
 
 </Step>
-<Step number={5} title="Реализация middleware Intlayer">
-
-Remix 3 предоставляет конвейер middleware через `createRouter({ middleware: [...] })`.
-
-Создайте middleware Intlayer, определяющий язык каждого входящего запроса:
-
-1. По префиксу пути URL через функцию `getLocaleFromPath` (например, `/ru` или `/fr`).
-2. С помощью вспомогательной функции `getLocale`, которая проверяет файлы cookie (`INTLAYER_LOCALE`), пользовательские заголовки (`x-intlayer-locale`), стандартные заголовки `Accept-Language` и `defaultLocale`.
-
-```typescript fileName="src/middleware/intlayer.ts" codeFormat={["typescript", "esm"]}
-import {
-  defaultLocale,
-  getCookie,
-  getLocale,
-  getLocaleFromPath,
-  type Locale,
-} from "intlayer";
-import { createContextKey, type Middleware } from "remix/router";
-
-/**
- * Типобезопасный ключ контекста для получения разрешенной локали из RequestContext Remix 3.
- */
-export const localeKey = createContextKey<Locale>(defaultLocale);
-
-/**
- * Middleware Intlayer для Remix 3.
- *
- * Определяет локаль запроса по следующему приоритету:
- * 1. Префикс пути URL (напр. `/ru/...`) через `getLocaleFromPath`
- * 2. Анализ заголовков и хранилища через `getLocale` (cookie, кастомный заголовок, Accept-Language, fallback defaultLocale)
- *
- * Добавляет полученную локаль в RequestContext Remix 3.
- */
-export const intlayer = (): Middleware => {
-  return async (context, next) => {
-    // Определение пути (/ru/about -> "ru", /about -> undefined)
-    const pathLocale = getLocaleFromPath(context.url.pathname);
-
-    if (pathLocale) {
-      // Сохранение локали в контексте запроса Remix 3
-      context.set(localeKey, pathLocale);
-
-      return next();
-    }
-
-    const storedLocale = await getLocale({
-      getHeader: (name) => context.headers.get(name),
-      getCookie: (name) =>
-        getCookie(name, context.headers.get("cookie") ?? undefined),
-    });
-
-    // Сохранение локали в контексте запроса Remix 3
-    context.set(localeKey, storedLocale ?? defaultLocale);
-
-    return next();
-  };
-};
+<Step number={5} title="Добавление middleware Intlayer">
+
+Remix 3 предоставляет компонуемый конвейер middleware через `createRouter({ middleware: [...] })`.
+
+`remix-intlayer` поставляет middleware `intlayer()`. Для каждого входящего запроса оно разрешает локаль, используя:
+
+1. URL, во всех режимах маршрутизации, кроме `no-prefix`: префикс пути (напр. `/ru` или `/en`) или поисковый параметр `?locale=`.
+2. Локаль, сохраненную клиентом: cookie хранилища (`INTLAYER_LOCALE`) или пользовательский заголовок (`x-intlayer-locale`).
+3. Стандартное согласование `Accept-Language` с возвратом к настроенной `defaultLocale`.
+
+Результат сохраняется в контексте запроса Remix как `context.intlayer` (или `context.get(Intlayer)`), с полями `locale`, `defaultLocale` и `availableLocales`. Затем middleware выполняет остальную часть запроса в области `AsyncLocalStorage`, привязанной к этому контексту, что позволяет хукам пакета считывать локаль без аргументов, в обработчиках маршрутов, представлениях и компонентах `remix/ui`:
+
+```typescript
+import { useIntlayer, useLocale } from "remix-intlayer";
+
+// В любом месте ниже по цепочке от middleware
+const { locale, availableLocales } = useLocale();
+const { title } = useIntlayer("home");
 ```
 
+`useIntlayer("home", "fr")` или `useIntlayer("faq", { item: 2 })` переопределяют локаль запроса для одного вызова, а `useDictionary(homeContent)` считывает импортированный словарь вместо ключа. Вне контекста запроса хуки возвращаются к локали по умолчанию.
+
+> Middleware также подготавливает словари Intlayer при запуске сервера, благодаря чему отсутствие `intlayer build` не оставит реестр пустым.
+
 </Step>
 <Step number={6} title="Определение типобезопасных маршрутов">
 
@@ -342,20 +311,21 @@ routes.localizedHome.href({ locale: "ru" }); // "/ru"
 
 Remix 3 рендерит пользовательский интерфейс с помощью JSX-компонентов из `remix/ui`. Компонент представляет собой **setup-функцию**, которая принимает `Handle` и возвращает **функцию рендеринга**. Setup выполняется один раз для каждого экземпляра, рендеринг запускается при каждом обновлении, а props считываются через `handle.props`.
 
-Начните с общей оболочки `Document`, устанавливающей атрибуты `<html lang="..." dir="...">` на основе определенной локали:
+Начните с общей оболочки `Document`, которая задает атрибуты `<html lang="..." dir="...">` на основе локали, разрешенной middleware:
 
 ```tsx fileName="src/views/document.tsx" codeFormat={["typescript", "esm"]}
-import { getHTMLTextDir, type Locale } from "intlayer";
+import { getHTMLTextDir } from "intlayer";
+import { useLocale } from "remix-intlayer";
 import type { Handle, RemixNode } from "remix/ui";
 
 type DocumentProps = {
-  locale: Locale;
   title: string;
   children?: RemixNode;
 };
 
 export const Document = (handle: Handle<DocumentProps>) => () => {
-  const { locale, title, children } = handle.props;
+  const { title, children } = handle.props;
+  const { locale } = useLocale();
 
   return (
     <html lang={locale} dir={getHTMLTextDir(locale)}>
@@ -370,47 +340,40 @@ export const Document = (handle: Handle<DocumentProps>) => () => {
 };
 ```
 
-Затем создайте главную страницу. Она извлекает локализованный словарь с помощью `getIntlayer` и отображает переключатель языков:
+Затем создайте главную страницу. Она считывает локализованный словарь с помощью `useIntlayer` и отображает переключатель языков:
 
 ```tsx fileName="src/views/home.tsx" codeFormat={["typescript", "esm"]}
-import {
-  getIntlayer,
-  getLocaleName,
-  getLocalizedPath,
-  type Locale,
-  locales,
-} from "intlayer";
-import type { Handle } from "remix/ui";
-import { routes } from "../routes";
+import { getLocaleName, getLocalizedUrl, getPathWithoutLocale } from "intlayer";
+import { useIntlayer, useLocale } from "remix-intlayer";
 import { Document } from "./document";
 
-type HomePageProps = {
-  locale: Locale;
-};
-
-export const HomePage = (handle: Handle<HomePageProps>) => () => {
-  const { locale } = handle.props;
-  const home = getIntlayer("home", locale);
+export const HomePage = () => () => {
+  const { locale, availableLocales } = useLocale();
+  const home = useIntlayer("home");
+  const pathWithoutLocale = getPathWithoutLocale();
 
   return (
-    <Document locale={locale} title={home.title}>
+    <Document title={home.title}>
       <header>
         <nav aria-label="Languages">
           <span>{home.switchLanguage}</span>
-          {locales.map((targetLocale) => {
-            const isActive = targetLocale === locale;
-
-            return (
-              <a
-                key={targetLocale}
-                href={getLocalizedPath(routes.home.href(), targetLocale)}
-                class={isActive ? "active" : undefined}
-                aria-current={isActive ? "page" : undefined}
-              >
-                {getLocaleName(targetLocale, locale)}
-              </a>
-            );
-          })}
+          <ul>
+            {availableLocales.map((localeItem) => {
+              const isActive = localeItem === locale;
+
+              return (
+                <li key={localeItem} class="p-1">
+                  <a
+                    href={getLocalizedUrl(pathWithoutLocale, localeItem)}
+                    class={isActive ? "active" : undefined}
+                    aria-current={isActive ? "page" : undefined}
+                  >
+                    {getLocaleName(localeItem, locale)}
+                  </a>
+                </li>
+              );
+            })}
+          </ul>
         </nav>
       </header>
       <main>
@@ -422,7 +385,7 @@ export const HomePage = (handle: Handle<HomePageProps>) => () => {
 };
 ```
 
-> Remix JSX не является React: здесь нет хуков, атрибут `class` записывается как есть (также поддерживается `className`), а повторный рендеринг запускается явно через `handle.update()`. Интерполированные значения экранируются автоматически.
+> JSX в Remix — это не React: `class` пишется как есть (`className` также поддерживается), а повторные рендеры вызываются явно через `handle.update()`. Интерполированные значения экранируются автоматически. Хуки Intlayer представляют собой простые функции, считывающие область запроса, поэтому их можно вызывать как из функции setup, так и из функции рендеринга.
 
 </Step>
 <Step number={8} title="Подключение роутера и сервера">
@@ -431,39 +394,37 @@ export const HomePage = (handle: Handle<HomePageProps>) => () => {
 
 ```tsx fileName="src/router.tsx" codeFormat={["typescript", "esm"]}
 import { isDeclaredLocale } from "intlayer";
+import { intlayer } from "remix-intlayer";
 import { render } from "remix/middleware/render";
 import { createRouter } from "remix/router";
-import { intlayer, localeKey } from "./middleware/intlayer";
 import { routes } from "./routes";
 import { HomePage } from "./views/home";
 
-// 1. Инициализация роутера с middleware Intlayer + render
+// 1. Initialize router with Intlayer + render middleware
 export const router = createRouter({
   middleware: [intlayer(), render()],
 });
 
-// 2. Назначение обработчиков маршрутов
+// 2. Map route handlers
 router.map(routes, {
   actions: {
-    // Маршрут для локали по умолчанию
+    // Default locale route
     home(context) {
-      const locale = context.get(localeKey);
-      return context.render(<HomePage locale={locale} />);
+      return context.render(<HomePage />);
     },
 
-    // Локализованный маршрут
+    // Localized route
     localizedHome(context) {
       if (!isDeclaredLocale(context.params.locale)) {
         return new Response("Not Found", { status: 404 });
       }
-      const locale = context.get(localeKey);
-      return context.render(<HomePage locale={locale} />);
+      return context.render(<HomePage />);
     },
   },
 });
 ```
 
-> `context.render` принимает необязательный `ResponseInit` в качестве второго аргумента, например: `context.render(<NotFoundPage locale={locale} />, { status: 404 })`.
+> `context.render` принимает необязательный `ResponseInit` в качестве второго аргумента, например `context.render(<NotFoundPage />, { status: 404 })`. Разрешенная локаль остается доступной из обработчика как `context.intlayer.locale`, например для формирования ответа `Response.json`.
 
 Наконец, экспортируйте роутер через стандартный обработчик `fetch`. Один и тот же роутер работает на Node.js, Bun, Deno и Cloudflare Workers:
 

package/docs/ru/intlayer_with_tanstack+solid.md

@@ -1259,6 +1259,13 @@ TanStack Start не поставляется со слоем i18n, а вариа
 
 Через [визуальный редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md), который работает на вашей собственной инфраструктуре и позволяет любому редактировать текст на месте в работающем приложении, или [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md), которая выносит контент вовне, чтобы он мог меняться без развёртывания.
 
+</Question>
+<Question title="Каковы затраты ресурсов на визуальный редактор? Не является ли он избыточным, если он мне не нужен?">
+
+[Визуальный редактор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md) имеет **нулевую стоимость** для вашего приложения, если он не настроен. Дополнительная логика загружается только в том случае, если она явно включена и необходима.
+
+Даже если он включен, влияние крайне незначительно (+5 кБ, загружается динамически только при активации), поскольку основная логика обрабатывается серверным редактором на [app.intlayer.org](https://app.intlayer.org) или через пакет `intlayer-editor`. Если вам нужно простое решение для перевода без визуального редактирования, Intlayer не создает никаких накладных расходов для вашего приложения.
+
 </Question>
 <Question title="Является ли Intlayer бесплатным и с открытым исходным кодом?">
 

package/docs/ru/intlayer_with_tanstack.md

@@ -1327,6 +1327,13 @@ TanStack Start не поставляется с собственным слое
 
 Через [визуальный редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md), который работает на вашей собственной инфраструктуре и позволяет любому редактировать текст на месте на работающем сайте, или [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md), которая выносит контент вовне, чтобы он мог меняться без развёртывания.
 
+</Question>
+<Question title="Каковы затраты ресурсов на визуальный редактор? Не является ли он избыточным, если он мне не нужен?">
+
+[Визуальный редактор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md) имеет **нулевую стоимость** для вашего приложения, если он не настроен. Дополнительная логика загружается только в том случае, если она явно включена и необходима.
+
+Даже если он включен, влияние крайне незначительно (+5 кБ, загружается динамически только при активации), поскольку основная логика обрабатывается серверным редактором на [app.intlayer.org](https://app.intlayer.org) или через пакет `intlayer-editor`. Если вам нужно простое решение для перевода без визуального редактирования, Intlayer не создает никаких накладных расходов для вашего приложения.
+
 </Question>
 <Question title="Является ли Intlayer бесплатным и с открытым исходным кодом?">
 

package/docs/ru/intlayer_with_vite+preact.md

@@ -1119,6 +1119,13 @@ Intlayer использует модульное расширение, чтоб
 
 Через [визуальный редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md), который работает на вашей собственной инфраструктуре и позволяет любому редактировать текст на месте в работающем приложении, или [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md), которая выносит контент вовне, чтобы он мог меняться без развёртывания.
 
+</Question>
+<Question title="Каковы затраты ресурсов на визуальный редактор? Не является ли он избыточным, если он мне не нужен?">
+
+[Визуальный редактор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md) имеет **нулевую стоимость** для вашего приложения, если он не настроен. Дополнительная логика загружается только в том случае, если она явно включена и необходима.
+
+Даже если он включен, влияние крайне незначительно (+5 кБ, загружается динамически только при активации), поскольку основная логика обрабатывается серверным редактором на [app.intlayer.org](https://app.intlayer.org) или через пакет `intlayer-editor`. Если вам нужно простое решение для перевода без визуального редактирования, Intlayer не создает никаких накладных расходов для вашего приложения.
+
 </Question>
 <Question title="Является ли Intlayer бесплатным и с открытым исходным кодом?">
 

package/docs/ru/intlayer_with_vite+react.md

@@ -1068,6 +1068,13 @@ Intlayer обрабатывает разрешение локали и оста
 
 Через [визуальный редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md), размещённый самостоятельно, который позволяет любому редактировать текст на месте в работающем приложении, или [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md) для контента, который должен меняться без развёртывания.
 
+</Question>
+<Question title="Каковы затраты ресурсов на визуальный редактор? Не является ли он избыточным, если он мне не нужен?">
+
+[Визуальный редактор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md) имеет **нулевую стоимость** для вашего приложения, если он не настроен. Дополнительная логика загружается только в том случае, если она явно включена и необходима.
+
+Даже если он включен, влияние крайне незначительно (+5 кБ, загружается динамически только при активации), поскольку основная логика обрабатывается серверным редактором на [app.intlayer.org](https://app.intlayer.org) или через пакет `intlayer-editor`. Если вам нужно простое решение для перевода без визуального редактирования, Intlayer не создает никаких накладных расходов для вашего приложения.
+
 </Question>
 <Question title="Является ли Intlayer бесплатным и с открытым исходным кодом?">
 

package/docs/ru/intlayer_with_vite+solid.md

@@ -820,6 +820,13 @@ console.log("SEO files generated successfully.");
 
 Через [визуальный редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md), который работает на вашей собственной инфраструктуре и позволяет любому редактировать текст на месте в работающем приложении, или [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md), которая выносит контент вовне, чтобы он мог меняться без развёртывания.
 
+</Question>
+<Question title="Каковы затраты ресурсов на визуальный редактор? Не является ли он избыточным, если он мне не нужен?">
+
+[Визуальный редактор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md) имеет **нулевую стоимость** для вашего приложения, если он не настроен. Дополнительная логика загружается только в том случае, если она явно включена и необходима.
+
+Даже если он включен, влияние крайне незначительно (+5 кБ, загружается динамически только при активации), поскольку основная логика обрабатывается серверным редактором на [app.intlayer.org](https://app.intlayer.org) или через пакет `intlayer-editor`. Если вам нужно простое решение для перевода без визуального редактирования, Intlayer не создает никаких накладных расходов для вашего приложения.
+
 </Question>
 <Question title="Является ли Intlayer бесплатным и с открытым исходным кодом?">
 

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

@@ -1,12 +1,12 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-09-19
 title: Документация пакета astro-intlayer
-description: Интеграция Intlayer для Astro, предоставляющая настройку маршрутизации на основе локали и управление словарями.
+description: Интеграция Astro для Intlayer, обеспечивающая маршрутизацию на основе локалей, промежуточное ПО, хуки, клиентское хранилище и управление словарями.
 keywords:
   - astro-intlayer
   - astro
-  - internationalization
+  - интернационализация
   - i18n
 slugs:
   - doc
@@ -14,15 +14,18 @@ slugs:
   - astro-intlayer
   - exports
 history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Добавлена документация хуков useIntlayer, useDictionary, useLocale, промежуточного ПО и форматтеров"
   - version: 8.0.0
     date: 2026-01-21
-    changes: "Unified documentation for all exports"
+    changes: "Унифицированная документация для всех экспортов"
 author: aymericzip
 ---
 
 # Пакет astro-intlayer
 
-Пакет `astro-intlayer` предоставляет необходимые инструменты для интеграции Intlayer в приложения на Astro. Он настраивает маршрутизацию в зависимости от локали и управление словарями.
+Пакет `astro-intlayer` предоставляет необходимые инструменты для интеграции Intlayer в приложения Astro. Он настраивает маршрутизацию на основе локалей, управление словарями, перезапись страниц во время сборки, промежуточное ПО для запросов и хуки для доступа к мультиязычному контенту как в серверных компонентах `.astro`, так и в клиентских скриптах.
 
 ## Установка
 
@@ -30,26 +33,175 @@ author: aymericzip
 npm install astro-intlayer
 ```
 
-## Экспорты
+## Экспорты пакета
 
 ### Интеграция
 
-Пакет `astro-intlayer` предоставляет интеграцию для Astro, позволяющую настроить Intlayer в вашем проекте.
+Пакет `astro-intlayer` предоставляет интеграцию для Astro, настраивающую Intlayer в вашем проекте.
 
 Импорт:
 
 ```tsx
-import "astro-intlayer";
+import { intlayer } from "astro-intlayer";
 ```
 
-или добавив в `astro.config.mjs`:
+или импорт по умолчанию в `astro.config.mjs`:
 
 ```ts
+import { defineConfig } from "astro/config";
+import intlayer from "astro-intlayer";
+
 export default defineConfig({
   integrations: [intlayer()],
 });
 ```
 
-| Функция    | Описание                                                            |
-| ---------- | ------------------------------------------------------------------- |
-| `intlayer` | Интеграция для Astro, которая настраивает Intlayer в вашем проекте. |
+| Функция    | Описание                                                                                                                                                                                                      | Связанная документация                                                                                        |
+| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | Интеграция Astro, подготавливающая словари, настраивающая плагины Vite (алиасы, прокси маршрутизации, очистку), автоматически регистрирующая middleware и генерирующая предрендеренные страницы с новыми URL. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/intlayer.md) |
+
+### Хуки (Сервер и Клиент)
+
+Импорт:
+
+```tsx
+import { useIntlayer, useDictionary, useLocale } from "astro-intlayer";
+```
+
+| Хук             | Описание                                                                                                                                                                                       | Связанная документация                                                                                                  |
+| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | Выбирает словарь по ключу и возвращает локализованный контент. В frontmatter `.astro` читает локаль запроса из `Astro.locals`. В клиентском `<script>` читает данные из клиентского хранилища. | [useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/useIntlayer.md)     |
+| `useDictionary` | Преобразует объект словаря и возвращает контент для разрешенной локали. Работает как в frontmatter, так и в клиентских скриптах.                                                               | [useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/useDictionary.md) |
+| `useLocale`     | Возвращает текущую локаль, локаль по умолчанию, доступные локали и функцию для обновления локали.                                                                                              | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/useLocale.md)         |
+
+### Промежуточное ПО (astro-intlayer/middleware)
+
+Импорт:
+
+```tsx
+import { onRequest } from "astro-intlayer/middleware";
+```
+
+| Экспорт     | Тип                 | Описание                                                                                                                                                                | Связанная документация                                                                                          |
+| ----------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `onRequest` | `MiddlewareHandler` | Middleware Astro, определяющее локаль запроса и прикрепляющее `Astro.locals.intlayer`. Регистрируется автоматически интеграцией `intlayer()` или импортируется вручную. | [onRequest](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/onRequest.md) |
+
+### Утилиты
+
+Импорт:
+
+```tsx
+import { getIntlayerLocals } from "astro-intlayer";
+```
+
+| Функция             | Описание                                                                                                                         | Связанная документация |
+| ------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
+| `getIntlayerLocals` | Вспомогательная функция для получения текущего объекта `IntlayerLocals` из области хранения запроса за пределами `Astro.locals`. | -                      |
+
+### Клиентские утилиты (astro-intlayer/client)
+
+Импорт:
+
+```tsx
+import {
+  useIntlayer,
+  useDictionary,
+  useDictionaryDynamic,
+  useLocale,
+  useLocaleStorage,
+  useLocaleCookie,
+  getIntlayer,
+  getDictionary,
+  installIntlayer,
+  setLocaleInStorage,
+  setLocaleCookie,
+  localeInStorage,
+  localeCookie,
+} from "astro-intlayer/client";
+```
+
+При импорте в браузере или внутри клиентских тегов `<script>` пакет `astro-intlayer` автоматически перенаправляет на `astro-intlayer/client` (на базе `vanilla-intlayer`), предоставляя клиентские геттеры словарей, подписки на хранилище и инструменты сохранения локали.
+
+### Форматтеры (astro-intlayer/format)
+
+Импорт:
+
+```tsx
+import {
+  useIntl,
+  useDate,
+  useNumber,
+  useCurrency,
+  usePercentage,
+  useRelativeTime,
+  useList,
+  useUnit,
+  useCompact,
+} from "astro-intlayer/format";
+```
+
+| Хук               | Описание                                                                                                            |
+| ----------------- | ------------------------------------------------------------------------------------------------------------------- |
+| `useIntl`         | Возвращает экземпляр Intl, привязанный к локали запроса или клиента с возможностями кэширования и подписки.         |
+| `useDate`         | Возвращает функцию форматирования даты, предварительно привязанную к текущей локали (`Intl.DateTimeFormat`).        |
+| `useNumber`       | Возвращает функцию форматирования чисел, предварительно привязанную к текущей локали (`Intl.NumberFormat`).         |
+| `useCurrency`     | Возвращает функцию форматирования валюты, предварительно привязанную к текущей локали.                              |
+| `usePercentage`   | Возвращает функцию форматирования процентов, предварительно привязанную к текущей локали.                           |
+| `useRelativeTime` | Возвращает функцию форматирования относительного времени, привязанную к текущей локали (`Intl.RelativeTimeFormat`). |
+| `useList`         | Возвращает функцию форматирования списков, привязанную к текущей локали (`Intl.ListFormat`).                        |
+| `useUnit`         | Возвращает функцию форматирования единиц измерения, привязанную к текущей локали.                                   |
+| `useCompact`      | Возвращает функцию компактного форматирования чисел, привязанную к текущей локали (например, `1.5K`).               |
+
+### HTML-утилиты (astro-intlayer/html)
+
+Импорт:
+
+```tsx
+import { renderHTML, useHTML, useHTMLRenderer } from "astro-intlayer/html";
+```
+
+| Экспорт           | Тип        | Описание                                                              |
+| ----------------- | ---------- | --------------------------------------------------------------------- |
+| `renderHTML`      | `Function` | Автономная служебная функция для рендеринга HTML-узлов.               |
+| `useHTML`         | `Hook`     | Хук для получения контекста и конфигурации HTML-провайдера.           |
+| `useHTMLRenderer` | `Hook`     | Хук для получения предварительно настроенной функции рендеринга HTML. |
+
+### Markdown-утилиты (astro-intlayer/markdown)
+
+Импорт:
+
+```tsx
+import {
+  compileMarkdown,
+  renderMarkdown,
+  parseMarkdown,
+  useMarkdown,
+  useMarkdownRenderer,
+} from "astro-intlayer/markdown";
+```
+
+| Экспорт               | Тип        | Описание                                                                  |
+| --------------------- | ---------- | ------------------------------------------------------------------------- |
+| `compileMarkdown`     | `Function` | Компилирует строки markdown в структурированное представление.            |
+| `renderMarkdown`      | `Function` | Рендерит содержимое markdown в выходные узлы.                             |
+| `parseMarkdown`       | `Function` | Анализирует необработанный markdown в AST.                                |
+| `useMarkdown`         | `Hook`     | Хук для получения контекста провайдера markdown.                          |
+| `useMarkdownRenderer` | `Hook`     | Хук для получения предварительно настроенной функции рендеринга Markdown. |
+
+### Типы
+
+Импорт:
+
+```tsx
+import type {
+  IntlayerLocals,
+  UseLocaleProps,
+  UseLocaleResult,
+} from "astro-intlayer";
+```
+
+| Тип               | Описание                                                                                                    |
+| ----------------- | ----------------------------------------------------------------------------------------------------------- |
+| `IntlayerLocals`  | Объект, прикрепленный к `Astro.locals.intlayer`, содержащий `locale`, `defaultLocale` и `availableLocales`. |
+| `UseLocaleProps`  | Необязательные свойства конфигурации, принимаемые `useLocale()`.                                            |
+| `UseLocaleResult` | Тип возвращаемого значения `useLocale()`, предоставляющий свойства локали и методы обновления.              |