@intlayer/docs 9.5.4 → 9.5.5

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

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-01-21
+updatedAt: 2026-09-19
+title: Документация интеграции intlayer | astro-intlayer
+description: Узнайте, как настроить и использовать интеграцию Astro intlayer в astro.config.mjs.
+keywords:
+  - intlayer
+  - astro
+  - astro-intlayer
+  - интеграция
+  - i18n
+  - интернационализация
+  - документация
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - intlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Обновлена документация интеграции с подробностями о middleware и хуках"
+  - version: 8.0.0
+    date: 2026-01-21
+    changes: "Начальная документация"
+author: aymericzip
+---
+
+# Документация интеграции Astro intlayer
+
+Интеграция `intlayer` для Astro настраивает ваш проект для многоязычной интернационализации (i18n). Она управляет подготовкой словарей во время сборки, внедрением плагинов Vite, автоматической регистрацией middleware для запросов и генерацией локализованных предрендеренных страниц.
+
+## Использование
+
+Добавьте `intlayer()` в ваш `astro.config.mjs`:
+
+```ts fileName="astro.config.mjs"
+import { defineConfig } from "astro/config";
+import { intlayer } from "astro-intlayer";
+
+export default defineConfig({
+  integrations: [intlayer()],
+});
+```
+
+Кодмод Astro CLI (`astro add astro-intlayer`) также генерирует поддерживаемый импорт по умолчанию:
+
+```ts
+import intlayer from "astro-intlayer";
+```
+
+## Описание
+
+Интеграция встраивается в жизненный цикл сборки и выполнения Astro:
+
+1. **Настройка конфигурации (`astro:config:setup`)**:
+   - **Подготовка словарей**: Подготавливает словари Intlayer и сгенерированные типы до запуска сборки.
+   - **Плагины Vite**: Внедряет плагины для алиасов Vite (обеспечивая беспрепятственный импорт словарей), прокси маршрутизации локалей и очистки сборки.
+   - **Регистрация Middleware**: Автоматически внедряет `astro-intlayer/middleware` в цепочку промежуточного ПО вашего проекта, заполняя `Astro.locals.intlayer` для каждого входящего запроса.
+2. **Завершение сборки (`astro:build:done`)**:
+   - **Перезапись страниц**: Анализирует правила перезаписи локализованных URL-адресов и выводит предрендеренные HTML-страницы по соответствующим локализованным путям.
+
+## Что предоставляется «из коробки»
+
+После настройки ваше приложение Astro может сразу использовать:
+
+- Хуки `useIntlayer`, `useDictionary` и `useLocale` внутри frontmatter компонентов `.astro`.
+- Объект `Astro.locals.intlayer` в эндпоинтах и страницах Astro.
+- Клиентские импорты в блоках `<script>`, повторяющие тот же API с реактивными обновлениями.
+- Встроенные форматтеры в `astro-intlayer/format` (`useDate`, `useNumber`, `useCurrency` и т. д.).
+
+## Связанная документация
+
+- [Хук `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/useIntlayer.md)
+- [Хук `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/useLocale.md)
+- [Промежуточное ПО `onRequest`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/onRequest.md)

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

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Документация middleware onRequest | astro-intlayer
+description: Узнайте, как использовать middleware onRequest в приложениях Astro для определения локали запроса и заполнения Astro.locals.intlayer.
+keywords:
+  - onRequest
+  - middleware
+  - astro
+  - astro-intlayer
+  - Astro.locals
+  - интернационализация
+  - документация
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - onRequest
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Начальная документация"
+author: aymericzip
+---
+
+# Документация middleware Astro onRequest
+
+Middleware `onRequest` из `astro-intlayer/middleware` определяет локаль каждого входящего HTTP-запроса и заполняет `Astro.locals.intlayer`.
+
+При регистрации интеграции `intlayer()` в `astro.config.mjs` это промежуточное ПО внедряется автоматически. Вам нужно импортировать его напрямую только в том случае, если вы вручную компонуете middleware Astro с помощью `sequence(...)`.
+
+## Использование
+
+```ts fileName="src/middleware.ts"
+import { onRequest as intlayer } from "astro-intlayer/middleware";
+import { sequence } from "astro:middleware";
+
+export const onRequest = sequence(intlayer, async (context, next) => {
+  // Доступ к разрешенной локали в вашем пользовательском middleware
+  const { locale } = context.locals.intlayer;
+  console.log(`Обработка запроса для локали: ${locale}`);
+
+  return next();
+});
+```
+
+## Описание
+
+Middleware выполняет следующие действия:
+
+1. **Определение локали**:
+   - **URL**: Анализирует префикс пути URL или параметр поиска `?locale=` (если `routing.mode` не установлен в `no-prefix`).
+   - **Куки / Заголовки**: Проверяет сохраненные файлы cookie локали или пользовательские значения заголовков.
+   - **Accept-Language**: Использует предпочтительный язык браузера в качестве резерва.
+   - Для предрендеренных страниц (`context.isPrerendered`) локаль извлекается строго из URL, чтобы предотвратить предупреждения сборки Astro.
+2. **Заполнение контекста**: Заполняет `Astro.locals.intlayer` следующими данными:
+   - `locale`: Разрешенная локаль.
+   - `defaultLocale`: Резервная локаль по умолчанию.
+   - `availableLocales`: Массив настроенных локалей.
+3. **Область AsyncLocalStorage**: Оборачивает обработку запроса в область `AsyncLocalStorage`, позволяя `useIntlayer()`, `useDictionary()` и `useLocale()` получать доступ к состоянию запроса без явной передачи аргументов.
+
+## Тип `IntlayerLocals`
+
+```ts
+export type IntlayerLocals = {
+  locale: DeclaredLocales;
+  defaultLocale: DeclaredLocales;
+  availableLocales: DeclaredLocales[];
+};
+```
+
+## Связанная документация
+
+- [Интеграция `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/intlayer.md)
+- [Хук `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/useIntlayer.md)
+- [Хук `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/useLocale.md)

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

@@ -0,0 +1,95 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Документация хука useDictionary | astro-intlayer
+description: Узнайте, как использовать хук useDictionary в компонентах и скриптах Astro для разрешения объектов словарей.
+keywords:
+  - useDictionary
+  - dictionary
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - интернационализация
+  - документация
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useDictionary
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Начальная документация"
+author: aymericzip
+---
+
+# Документация хука useDictionary
+
+Хук `useDictionary` разрешает импортированный или встроенный объект словаря и возвращает его содержимое для текущей локали в приложениях Astro.
+
+В отличие от `useIntlayer`, который получает словари по ключу из глобального реестра словарей, `useDictionary` работает непосредственно с объектом словаря.
+
+## Использование
+
+```astro fileName="src/pages/index.astro"
+---
+import { useDictionary } from "astro-intlayer";
+import homeContent from "../content/home.content";
+
+const content = useDictionary(homeContent);
+---
+
+<main>
+  <h1>{content.title}</h1>
+  <p>{content.description}</p>
+</main>
+```
+
+Вы также можете передавать встроенные словари, определенные с помощью функции `t()`:
+
+```astro fileName="src/components/Footer.astro"
+---
+import { useDictionary } from "astro-intlayer";
+import { t } from "intlayer";
+
+const footer = useDictionary({
+  key: "footer",
+  content: {
+    copyright: t({
+      ru: "Все права защищены.",
+      en: "All rights reserved.",
+      fr: "Tous droits réservés.",
+      es: "Todos los derechos reservados.",
+    }),
+  },
+});
+---
+
+<footer>
+  <p>{footer.copyright}</p>
+</footer>
+```
+
+## Параметры
+
+```ts
+useDictionary(dictionary, localeOrSelector?)
+```
+
+1. **`dictionary`**: Объект словаря или квалифицированная группа словарей.
+2. **`localeOrSelector`** (необязательно): Конкретная локаль или объект селектора (`{ item }`, `{ variant }`, при необходимости с `locale`).
+
+## Описание
+
+Хук выполняет следующие задачи:
+
+1. **Определение локали**: На сервере получает локаль из `Astro.locals.intlayer`. В браузере использует локаль клиентского хранилища.
+2. **Обработка контента**: Разрешает переводы (`t()`), перечисления, условия и вложенные структуры в соответствии с разрешенной локалью.
+3. **Селекторы**: Применяет любые селекторы элементов или вариантов, переданные в аргументах.
+
+## Связанная документация
+
+- [Интеграция `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/intlayer.md)
+- [Хук `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/useIntlayer.md)
+- [Хук `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/useLocale.md)

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

@@ -0,0 +1,98 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Документация хука useIntlayer | astro-intlayer
+description: Узнайте, как использовать хук useIntlayer в компонентах Astro и клиентских скриптах для доступа к локализованному контенту.
+keywords:
+  - useIntlayer
+  - dictionary
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - интернационализация
+  - документация
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useIntlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Начальная документация"
+author: aymericzip
+---
+
+# Документация хука useIntlayer
+
+Хук `useIntlayer` позволяет получать локализованный контент словаря по ключу в приложениях Astro.
+
+Его можно вызывать в двух различных контекстах, используя один и тот же путь импорта:
+
+1. **Сервер / Frontmatter**: Внутри файлов `.astro` он автоматически разрешает контент, используя локаль запроса, сохраненную в `Astro.locals.intlayer`.
+2. **Браузер / Клиентский тег `<script>`**: Внутри клиентских скриптов или компонентов UI-фреймворков он перенаправляется на реализацию клиентского хранилища (`vanilla-intlayer`).
+
+## Использование
+
+### Во frontmatter компонентов Astro
+
+```astro fileName="src/pages/index.astro"
+---
+import { useIntlayer } from "astro-intlayer";
+
+const content = useIntlayer("home");
+---
+
+<main>
+  <h1>{content.title}</h1>
+  <p>{content.description}</p>
+</main>
+```
+
+### В блоках `<script>` на клиенте
+
+```astro fileName="src/components/InteractiveWidget.astro"
+---
+import { useIntlayer } from "astro-intlayer";
+
+const content = useIntlayer("home");
+---
+
+<button id="alert-btn">{content.buttonText}</button>
+
+<script>
+  import { useIntlayer } from "astro-intlayer";
+
+  const content = useIntlayer("home");
+
+  document.getElementById("alert-btn")?.addEventListener("click", () => {
+    alert(content.buttonText);
+  });
+</script>
+```
+
+## Параметры
+
+```ts
+useIntlayer(key, localeOrSelector?)
+```
+
+1. **`key`**: Уникальный ключ словаря (определенный в файлах `.content.ts`).
+2. **`localeOrSelector`** (необязательно): Конкретная локаль или объект селектора (`{ item }`, `{ variant }`, при необходимости с `locale`). Если указан, переопределяет локаль, определенную из контекста запроса или клиентского хранилища.
+
+## Описание
+
+Хук выполняет следующие задачи:
+
+1. **Разрешение локали**:
+   - На сервере считывает активную локаль из `Astro.locals.intlayer` через область `AsyncLocalStorage`, инициализированную `astro-intlayer/middleware`.
+   - В браузере считывает активную локаль из клиентского хранилища/стора.
+2. **Получение словаря**: Извлекает содержимое словаря, соответствующее указанному ключу.
+3. **Обработка перевода**: Обрабатывает переводы (`t()`), перечисления, условия и markdown в готовый к рендерингу контент.
+
+## Связанная документация
+
+- [Интеграция `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/intlayer.md)
+- [Хук `useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/useDictionary.md)
+- [Хук `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/useLocale.md)

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

@@ -0,0 +1,126 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Документация хука useLocale | astro-intlayer
+description: Узнайте, как использовать хук useLocale в приложениях Astro для доступа к текущей локали и управления ею.
+keywords:
+  - useLocale
+  - locale
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - интернационализация
+  - документация
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useLocale
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Начальная документация"
+author: aymericzip
+---
+
+# Документация хука useLocale
+
+Хук `useLocale` из `astro-intlayer` предоставляет доступ к текущей локали запроса, настроенной локали по умолчанию и всем доступным локалям в приложениях Astro.
+
+Он ведет себя согласованно как во frontmatter компонентов `.astro`, рендеримых на сервере, так и в клиентских блоках `<script>`.
+
+## Использование
+
+### Во frontmatter компонентов (Серверный рендеринг)
+
+```astro fileName="src/layouts/Layout.astro"
+---
+import { useLocale } from "astro-intlayer";
+import { getLocalizedUrl, getPathWithoutLocale } from "intlayer";
+
+const { locale, defaultLocale, availableLocales } = useLocale();
+const pathWithoutLocale = getPathWithoutLocale(Astro.url.pathname);
+---
+
+<!DOCTYPE html>
+<html lang={locale}>
+  <head>
+    <meta charset="utf-8" />
+    <title>Astro + Intlayer</title>
+  </head>
+  <body>
+    <header>
+      <span>Текущая: {locale}</span>
+      <span>По умолчанию: {defaultLocale}</span>
+      <nav>
+        <ul>
+          {availableLocales.map((localeItem) => (
+            <li key={localeItem} className="p-1">
+              <a
+                href={getLocalizedUrl(pathWithoutLocale, localeItem)}
+                aria-current={localeItem === locale ? "page" : undefined}
+              >
+                {localeItem.toUpperCase()}
+              </a>
+            </li>
+          ))}
+        </ul>
+      </nav>
+    </header>
+    <slot />
+  </body>
+</html>
+```
+
+### В клиентском `<script>` (Интерактивно)
+
+```astro fileName="src/components/LocaleSwitcher.astro"
+---
+import { useLocale } from "astro-intlayer";
+
+const { locale, availableLocales } = useLocale();
+---
+
+<select id="locale-select">
+  {availableLocales.map((loc) => (
+    <option value={loc} selected={loc === locale}>
+      {loc.toUpperCase()}
+    </option>
+  ))}
+</select>
+
+<script>
+  import { useLocale, setLocaleInStorage } from "astro-intlayer";
+
+  const { setLocale } = useLocale();
+
+  document.getElementById("locale-select")?.addEventListener("change", (e) => {
+    const target = e.target as HTMLSelectElement;
+    setLocale(target.value);
+  });
+</script>
+```
+
+## Возвращаемые значения
+
+Хук возвращает объект типа `UseLocaleResult`:
+
+| Свойство           | Тип                                    | Описание                                                                                              |
+| ------------------ | -------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| `locale`           | `DeclaredLocales`                      | Активная локаль.                                                                                      |
+| `defaultLocale`    | `DeclaredLocales`                      | Резервная локаль по умолчанию, настроенная в `intlayer.config.ts`.                                    |
+| `availableLocales` | `DeclaredLocales[]`                    | Массив всех поддерживаемых локалей, настроенных для проекта.                                          |
+| `setLocale`        | `(locale: LocalesValues) => void`      | Функция для обновления локали. (Интерактивна в клиентском `<script>`, выдает предупреждение при SSR). |
+| `subscribe`        | `(callback: () => void) => () => void` | Подписывается на изменения локали на стороне клиента.                                                 |
+
+## Поведение на сервере и клиенте
+
+- **Во время SSR / Серверного рендеринга**: Запрос рендерится один раз с фиксированными параметрами. Вызов `setLocale()` во время серверного рендеринга не имеет эффекта и выдает предупреждение; переключение локали должно выполняться на клиенте или путем перехода по URL-адресу целевой локали.
+- **В клиентских скриптах**: `setLocale` обновляет клиентское хранилище и сохраняет файлы cookie или данные в локальном хранилище в соответствии с конфигурацией Intlayer.
+
+## Связанная документация
+
+- [Интеграция `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/intlayer.md)
+- [Хук `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/useIntlayer.md)
+- [Хук `useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/astro-intlayer/useDictionary.md)

package/docs/ru/packages/remix-intlayer/Intlayer.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Документация контекста Intlayer | remix-intlayer
+description: Документация по ключу хранилища контекста запроса Intlayer в приложениях Remix 3.
+keywords:
+  - Intlayer
+  - remix
+  - remix-3
+  - контекст запроса
+  - интернационализация
+  - i18n
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - Intlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Начальная документация по ключу контекста Intlayer"
+author: aymericzip
+---
+
+# Ключ контекста запроса Intlayer
+
+Экспорт `Intlayer` служит идентификатором хранилища контекста запроса в Remix 3. Он позволяет извлекать состояние Intlayer напрямую из объекта контекста Remix внутри обработчиков маршрутов или пользовательского промежуточного ПО.
+
+## Использование
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer, Intlayer } from "remix-intlayer";
+
+const router = createRouter({
+  middleware: [intlayer()],
+});
+
+router.get("/api/current-locale", (context) => {
+  const intlayerState = context.get(Intlayer);
+
+  return Response.json({
+    locale: intlayerState?.locale,
+  });
+});
+```
+
+## Описание
+
+`Intlayer` используется промежуточным ПО `intlayer()` для привязки текущего состояния сессии к контексту запроса Remix (`RequestContext`). Обычно предпочтительнее использовать хуки, такие как `useLocale()` или `useIntlayer()`. Прямой доступ к `context.get(Intlayer)` полезен в низкоуровневых промежуточных обработчиках или API-маршрутах, где передача экземпляра контекста является явной.
+
+## Связанная документация
+
+- [Промежуточное ПО `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/intlayerMiddleware.md)
+- [Хук `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/useLocale.md)

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

@@ -0,0 +1,80 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Документация пакета remix-intlayer
+description: Документация по экспортам пакета remix-intlayer, обеспечивающего интернационализацию (i18n) для приложений Remix 3.
+keywords:
+  - remix-intlayer
+  - remix
+  - remix-3
+  - intlayer
+  - интернационализация
+  - i18n
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - exports
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Начальная документация по экспортам remix-intlayer"
+author: aymericzip
+---
+
+# Пакет remix-intlayer
+
+Пакет `remix-intlayer` предоставляет инструменты для интеграции Intlayer в приложения Remix 3. Он включает промежуточное ПО (middleware) для определения локали запроса, доступ к контексту запроса и хуки для получения словарей и управления локалями.
+
+## Установка
+
+```bash
+npm install remix-intlayer
+```
+
+## Экспорты пакета
+
+### Промежуточное ПО (Middleware)
+
+| Экспорт    | Тип                | Описание                                                                                                                 | Связанная документация                                                                                                                   |
+| ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | Функция Middleware | Промежуточное ПО для Remix 3, определяющее локаль запроса, управляющее перенаправлениями и заполняющее контекст запроса. | [Промежуточное ПО intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/intlayerMiddleware.md) |
+
+### Хранилище контекста
+
+| Экспорт    | Тип                             | Описание                                                                                                                       | Связанная документация                                                                                                 |
+| ---------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
+| `Intlayer` | Ключ RequestContext / Хранилище | Ключ контекста запроса, используемый для извлечения состояния Intlayer из контекста запроса Remix 3 (`context.get(Intlayer)`). | [Контекст Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/Intlayer.md) |
+
+### Хуки
+
+| Экспорт         | Тип | Описание                                                                                       | Связанная документация                                                                                                      |
+| --------------- | --- | ---------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | Хук | Получает и декорирует контент словаря по ключу с учетом текущей локали запроса.                | [Хук useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/useIntlayer.md)     |
+| `useDictionary` | Хук | Возвращает контент предварительно импортированного словаря для текущей локали запроса.         | [Хук useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/useDictionary.md) |
+| `useLocale`     | Хук | Предоставляет доступ к текущей локали запроса, локали по умолчанию и списку доступных локалей. | [Хук useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/useLocale.md)         |
+
+## Быстрый старт
+
+### Настройка маршрутизатора с промежуточным ПО
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer } from "remix-intlayer";
+
+export const router = createRouter({
+  middleware: [intlayer()],
+});
+```
+
+### Использование контента в компонентах и представлениях
+
+```ts fileName="src/views/home.ts"
+import { useIntlayer } from "remix-intlayer";
+
+export const HomeView = () => {
+  const content = useIntlayer("home");
+
+  return `<h1>${content.title}</h1><p>${content.description}</p>`;
+};
+```

package/docs/ru/packages/remix-intlayer/intlayerMiddleware.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Документация промежуточного ПО intlayer | remix-intlayer
+description: Узнайте, как использовать промежуточное ПО intlayer в Remix 3 для определения локали, обработки перенаправлений и внедрения состояния Intlayer в контекст запроса.
+keywords:
+  - intlayer
+  - middleware
+  - remix
+  - remix-3
+  - интернационализация
+  - i18n
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - intlayerMiddleware
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Начальная документация по промежуточному ПО intlayer"
+author: aymericzip
+---
+
+# Промежуточное ПО intlayer
+
+Функция промежуточного ПО `intlayer` настраивает интернационализацию запросов в приложениях Remix 3. Она определяет локаль каждого входящего запроса, применяет правила перенаправления URL и сохраняет состояние локали в контексте запроса.
+
+## Использование
+
+Зарегистрируйте промежуточное ПО в вашем маршрутизаторе Remix:
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer } from "remix-intlayer";
+
+export const router = createRouter({
+  middleware: [intlayer()],
+});
+```
+
+## Как это работает
+
+Промежуточное ПО выполняет несколько задач для каждого входящего запроса:
+
+1. **Определение локали**: Извлекает локаль из префикса URL-пути (например, `/fr/about`), файлов cookie или заголовка `Accept-Language` в соответствии с вашей конфигурацией Intlayer.
+2. **Перенаправление URL**: Если запрошенный путь не содержит префикса локали, а конфигурация требует префиксации маршрутов, промежуточное ПО возвращает ответ-перенаправление (302/307/308) на соответствующий URL с префиксом.
+3. **Заполнение контекста запроса**: Сохраняет текущую разрешенную локаль в контексте запроса Remix с использованием ключа `Intlayer`, что позволяет хукам (`useLocale`, `useIntlayer`, `useDictionary`) прозрачно использовать ее.
+4. **Управление куками**: Сохраняет заголовок `Set-Cookie` при необходимости запомнить предпочтительную локаль пользователя.
+
+## Связанная документация
+
+- [Контекст запроса `Intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/Intlayer.md)
+- [Хук `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/useLocale.md)
+- [Хук `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/useIntlayer.md)