@intlayer/docs 9.4.0-canary.0 → 9.4.0

package/docs/ru/intlayer_with_vite+lit.md

@@ -109,6 +109,8 @@ Intlayer — это больше, чем просто решение i18n. Он
 
 ---
 
+See [Application Template](https://github.com/aymericzip/intlayer-vite-lit-template) on GitHub.
+
 ## Пошаговое руководство по настройке Intlayer в приложении на Vite и Lit
 
 <Steps>
@@ -478,6 +480,8 @@ export class MyElement extends LitElement {
 
 > Обратите внимание, что для использования `intlayerProxy` в продакшене вам нужно переместить `vite-intlayer` из `devDependencies` в `dependencies`.
 
+> Начиная с Intlayer v9, `intlayerProxy()` встроен непосредственно в плагин `intlayer()` и включен по умолчанию через опцию `routing.enableProxy` (`true` по умолчанию). Регистрация его отдельно, как показано ниже, теперь является опциональной — она сохранена для обратной совместимости и для конфигураций, которым нужно контролировать порядок плагинов. Установите `routing.enableProxy: false` для отключения. См. [заметки о выпуске v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/releases/v9.md).
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";

package/docs/ru/intlayer_with_vite+preact.md

@@ -170,10 +170,6 @@ bun add vite-intlayer --dev
 
   Основной пакет, предоставляющий инструменты интернационализации для управления конфигурацией, перевода, [объявления контента](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/content_file.md), компиляции и [CLI-команд](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/index.md).
 
-- **preact-intlayer**
-
-  Пакет, который интегрирует Intlayer с приложением на Preact. Он предоставляет провайдеры контекста и хуки для интернационализации Preact.
-
 - **vite-intlayer**
 
   Включает плагин Vite для интеграции Intlayer с [сборщиком Vite](https://vite.dev/guide/why.html#why-bundle-for-production), а также промежуточное ПО для определения предпочтительной локали пользователя, управления куки и обработки перенаправления URL.
@@ -516,6 +512,30 @@ const App: FunctionalComponent = () => (
 export default App;
 ```
 
+Параллельно вы также можете использовать `intlayerProxy` для добавления маршрутизации на стороне сервера к вашему приложению. Этот плагин автоматически определяет текущую локаль на основе URL и устанавливает соответствующее значение cookie локали. Если локаль не указана, плагин определит наиболее подходящую локаль на основе предпочтений языка браузера пользователя. Если локаль не обнаружена, она перенаправляет на локаль по умолчанию.
+
+> Обратите внимание, что для использования `intlayerProxy` в production необходимо переместить пакет `vite-intlayer` из `devDependencies` в `dependencies`.
+
+> Начиная с Intlayer v9, `intlayerProxy()` встроен непосредственно в плагин `intlayer()` и включен по умолчанию через опцию `routing.enableProxy` (`true` по умолчанию). Регистрация его отдельно, как показано ниже, теперь необязательна — она сохранена для обратной совместимости и для настроек, которым нужно контролировать порядок плагинов. Установите `routing.enableProxy: false` для отключения. См. [примечания к выпуску v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/releases/v9.md).
+
+```typescript {3,7} fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+import preact from "@preact/preset-vite";
+
+// https://vitejs.dev/config/
+export default defineConfig({
+  plugins: [
+    preact(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
+});
+```
+
 </Step>
 
 <Step number={8} title="Изменяйте URL при смене локали" isOptional={true}>
@@ -592,6 +612,10 @@ export default LocaleSwitcher;
 >
 > > - [Хук `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/react-intlayer/useLocale.md) (API для `preact-intlayer` аналогично)> - [Хук `getLocaleName`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getLocaleName.md)> - [Хук `getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getLocalizedUrl.md)> - [Хук `getHTMLTextDir`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getHTMLTextDir.md)> - [Атрибут `hreflang`](https://developers.google.com/search/docs/specialty/international/localized-versions?hl=ru)> - [Атрибут `lang`](https://developer.mozilla.org/ru/docs/Web/HTML/Global_attributes/lang)> - [Атрибут `dir`](https://developer.mozilla.org/ru/docs/Web/HTML/Global_attributes/dir)> - [Атрибут `aria-current`](https://developer.mozilla.org/ru/docs/Web/Accessibility/ARIA/Attributes/aria-current)> - [Popover API](https://developer.mozilla.org/ru/docs/Web/API/Popover_API)
 
+Ниже приведена обновленная **Шаг 9** с добавленными объяснениями и уточненными примерами кода:
+
+---
+
 </Step>
 
 <Step number={9} title="Переключайте атрибуты языка и направления HTML" isOptional={true}>
@@ -661,6 +685,12 @@ const App: FunctionalComponent = () => (
 export default App;
 ```
 
+Применив эти изменения, ваше приложение будет:
+
+- Убедитесь, что атрибут **language** (`lang`) правильно отражает текущую локаль, что важно для SEO и поведения браузера.
+- Настройте **направление текста** (`dir`) в соответствии с локалью, улучшая читаемость и удобство использования для языков с различными порядками чтения.
+- Обеспечьте более **доступный** опыт, так как вспомогательные технологии зависят от этих атрибутов для оптимального функционирования.
+
 </Step>
 
 <Step number={10} title="Создание компонента локализованной ссылки" isOptional={true}>

package/docs/ru/intlayer_with_vite+react.md

@@ -760,6 +760,8 @@ Link.displayName = "Link";
 Интегрируя этот компонент `Link` по всему вашему приложению, вы поддерживаете последовательный и ориентированный на язык пользовательский опыт, а также получаете преимущества улучшенного SEO и удобства использования.
 </Step>
 
+</Step>
+
 <Step number={1} title="Извлечение содержимого ваших компонентов" isOptional={true}>
 
 Если у вас есть существующая кодовая база, преобразование тысяч файлов может занять много времени.

package/docs/ru/intlayer_with_vite+react_compiler.md

@@ -232,6 +232,8 @@ export default defineConfig({
 
 > Плагин Vite `intlayerCompiler()` используется для извлечения контента из компонентов и записи файлов `.content`.
 
+> Начиная с Intlayer v9, компилятор встроен непосредственно в плагин `intlayer()` и активируется автоматически при установке `compiler.enabled` с путём `compiler.output`. Отдельная регистрация `intlayerCompiler()`, как показано ниже, теперь необязательна — она дедублицирует себя, если также добавлена. См. [примечания к версии v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/releases/v9.md).
+
 </Step>
 
 <Step number={4} title="Компиляция вашего кода">

package/docs/ru/intlayer_with_vite+solid.md

@@ -46,6 +46,17 @@ author: aymericzip
   loading="lazy"
 />
 
+  </Tab>
+  <Tab label="Demo" value="demo">
+
+<iframe
+  src="https://intlayer-vite-solid.vercel.app"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo Intlayer Vite + Solid Template"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
   </Tab>
 </Tabs>
 
@@ -53,10 +64,6 @@ author: aymericzip
 
 <TOC/>
 
-> Этот пакет находится в разработке. Подробнее смотрите в [issue](https://github.com/aymericzip/intlayer/issues/117). Покажите свой интерес к Intlayer для Solid, поставив лайк этому issue.
-
-<!-- Смотрите [шаблон приложения](https://github.com/aymericzip/intlayer-solid-template) на GitHub. -->
-
 ## Почему Intlayer лучше альтернатив?
 
 По сравнению с основными решениями, такими как @solid-primitives/i18n или i18next, Intlayer — это решение со встроенными оптимизациями, такими как:
@@ -242,8 +249,6 @@ export default appContent;
 
 > Ваши объявления контента могут быть определены в любом месте вашего приложения, как только они будут включены в каталог `contentDir` (по умолчанию, `./src`). И соответствовать расширению файла объявления контента (по умолчанию, `.content.{json,ts,tsx,js,jsx,mjs,cjs,md,mdx,yaml,yml}`).
 
-> Для получения дополнительной информации обратитесь к [документации по объявлениям контента](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/content_file.md).
-
 </Step>
 
 <Step number={5} title="Использование Intlayer в вашем коде">
@@ -491,29 +496,10 @@ export const Link: ParentComponent<AnchorProps> = (props) => {
 };
 ```
 
-</Step>
-
 <Step number={11} title="Рендеринг Markdown" isOptional={true}>
 
 Intlayer поддерживает рендеринг контента Markdown непосредственно в вашем приложении Solid, используя свой собственный внутренний парсер. По умолчанию Markdown обрабатывается как обычный текст. Чтобы отрендерить его как богатый HTML, оберните ваше приложение в `MarkdownProvider`.
 
-```tsx fileName="src/index.tsx"
-import { render } from "solid-js/web";
-import { MarkdownProvider } from "solid-intlayer/markdown";
-import App from "./App";
-
-const root = document.getElementById("root");
-
-render(
-  () => (
-    <MarkdownProvider>
-      <App />
-    </MarkdownProvider>
-  ),
-  root!
-);
-```
-
 Затем вы можете использовать его в ваших компонентах:
 
 ```tsx
@@ -743,5 +729,3 @@ 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).
-
----

package/docs/ru/intlayer_with_vite+svelte.md

@@ -298,6 +298,8 @@ export default appContent;
 > Если ваше приложение уже существует, вы можете использовать [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compiler.md) в сочетании с [командой extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/extract.md), чтобы преобразовать тысячи компонентов за одну секунду.
 ```
 
+> Если ваше приложение уже существует, вы можете использовать [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compiler.md), а также [команду extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/extract.md), чтобы трансформировать тысячи компонентов за секунду.
+
 </Step>
 
 <Step number={6} title="Изменение языка вашего контента" isOptional={true}>
@@ -457,6 +459,8 @@ $: content = useIntlayer('app', locale);
 
 > Обратите внимание, что для использования `intlayerProxy` в продакшене необходимо перевести пакет `vite-intlayer` из `devDependencies` в `dependencies`.
 
+> С версии Intlayer v9 `intlayerProxy()` встроен непосредственно в плагин `intlayer()` и включен по умолчанию через опцию `routing.enableProxy` (`true` по умолчанию). Регистрация его отдельно, как показано ниже, теперь является опциональной — она сохранена для обратной совместимости и для конфигураций, которым необходимо контролировать порядок плагинов. Установите `routing.enableProxy: false` для отключения. См. [примечания к релизу v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/releases/v9.md).
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import { svelte } from "@sveltejs/vite-plugin-svelte";
@@ -505,6 +509,29 @@ const changeLocale = (event: Event) => {
 </div>
 ```
 
+Once you provide these, I'll audit the translation and return the fully updated Russian version following all the guidelines you've specified.
+
+<Step number={9} title="Интернационализированные ссылки" isOptional={true}>
+
+Для SEO рекомендуется добавлять префикс локали к вашим маршрутам (например, `/about`, `/fr/about`).
+
+```svelte fileName="src/lib/components/Link.svelte"
+<script lang="ts">
+  import { getLocalizedUrl } from "intlayer";
+  import { useLocale } from "svelte-intlayer";
+
+  export let href = "";
+  const { locale } = useLocale();
+
+  // Вспомогательная функция для префиксации URL
+  $: localizedHref = getLocalizedUrl(href, $locale);
+</script>
+
+<a href={localizedHref}>
+  <slot />
+</a>
+```
+
 </Step>
 
 <Step number={1} title="Извлечение содержимого ваших компонентов" isOptional={true}>
@@ -708,6 +735,8 @@ console.log("SEO files generated successfully.");
 
 Для получения дополнительной информации о том, как использовать расширение, обратитесь к [документации расширения Intlayer для VS Code](https://intlayer.org/doc/vs-code-extension).
 
+---
+
 ### Продвинуться дальше
 
 Чтобы продвинуться дальше, вы можете реализовать [визуальный редактор](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).

package/docs/ru/intlayer_with_vite+vanilla.md

@@ -470,6 +470,8 @@ document.querySelector<HTMLDivElement>(".edit-note")!.innerHTML =
 
 > Обратите внимание, что для использования `intlayerProxy` в продакшене вам нужно переместить `vite-intlayer` из `devDependencies` в `dependencies`.
 
+> Начиная с Intlayer v9, `intlayerProxy()` встроен непосредственно в плагин `intlayer()` и включен по умолчанию через опцию `routing.enableProxy` (`true` по умолчанию). Отдельная регистрация, как показано ниже, теперь опциональна — она сохранена для обратной совместимости и для настроек, которым требуется контролировать порядок плагинов. Установите `routing.enableProxy: false` для отказа. См. [заметки выпуска v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/releases/v9.md).
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";

package/docs/ru/intlayer_with_vite+vue.md

@@ -369,6 +369,8 @@ app.mount("#app");
 
 Получайте доступ к вашим словарям контента по всему приложению, создавая основной Vue-компонент и используя композиции `useIntlayer`:
 
+Получайте доступ к своим словарям контента во всем приложении, создав главный компонент Vue и используя composables `useIntlayer`:
+
 ```vue fileName="src/HelloWord.vue"
 <script setup lang="ts">
 import { ref } from "vue";
@@ -420,6 +422,8 @@ const countRef = ref(0);
 </template>
 ```
 
+> Если ваше приложение уже существует, вы можете использовать [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compiler.md), а также [команду extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/extract.md), чтобы трансформировать тысячи компонентов за секунду.
+
 #### Доступ к содержимому в Intlayer
 
 Intlayer предлагает различные API для доступа к вашему содержимому:
@@ -438,8 +442,6 @@ Intlayer предлагает различные API для доступа к в
   - Используйте `const content = useIntlayer("myContent");` и `{{ content.myContent }}` / `<content.myContent />`.
   - Или используйте `const { myContent } = useIntlayer("myContent");` и `{{ myContent }}` / `<myContent/>` для деструктуризации содержимого.
 
-> Если ваше приложение уже существует, вы можете использовать [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compiler.md) в сочетании с [командой extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/extract.md), чтобы преобразовать тысячи компонентов за одну секунду.
-
 </Step>
 
 <Step number={6} title="Изменение языка вашего содержимого" isOptional={true}>
@@ -629,6 +631,10 @@ import LocaleSwitcher from "@components/LocaleSwitcher.vue"; // Импорт п
 
 Параллельно вы также можете использовать `intlayerProxy` для добавления маршрутизации на стороне сервера в ваше приложение. Этот плагин автоматически определит текущую локаль на основе URL и установит соответствующий cookie с локалью. Если локаль не указана, плагин определит наиболее подходящую локаль на основе языковых предпочтений браузера пользователя. Если локаль не будет обнаружена, произойдет перенаправление на локаль по умолчанию.
 
+> Обратите внимание, что для использования `intlayerProxy` в production, вам необходимо переместить пакет `vite-intlayer` из `devDependencies` в `dependencies`.
+
+> Начиная с Intlayer v9, `intlayerProxy()` встроен непосредственно в плагин `intlayer()` и включен по умолчанию через опцию `routing.enableProxy` (`true` по умолчанию). Регистрация его отдельно, как показано ниже, теперь опциональна — она сохранена для обратной совместимости и для конфигураций, которым необходимо контролировать порядок плагинов. Установите `routing.enableProxy: false`, чтобы отказаться от этого. См. [примечания к выпуску v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/releases/v9.md).
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
@@ -1130,3 +1136,5 @@ Intlayer использует расширение модулей (module augmen
 ### Продвинутые возможности
 
 Для расширения возможностей вы можете реализовать [визуальный редактор](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).
+
+Please share the content blocks and I'll proceed with the audit.---

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)