@intlayer/docs 9.5.4 → 9.5.6

package/docs/ru/intlayer_with_vite+preact.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Preact i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Vite + Preact. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:
@@ -860,8 +860,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Компилятор Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Обновите ваш `vite.config.ts`, чтобы включить плагин `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -876,6 +882,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Соберите приложение, чтобы преобразовать ваши компоненты и извлечь контент
+
 ```bash packageManager="npm"
 npm run build # Или npm run dev
 ```
@@ -932,7 +943,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -945,7 +958,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);
@@ -1119,6 +1132,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

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-03-07
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + React i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Vite + React. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:
@@ -827,8 +827,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel compiler'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Обновите ваш `vite.config.ts`, чтобы включить плагин `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -843,6 +849,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Соберите приложение, чтобы преобразовать ваши компоненты и извлечь контент
+
 ```bash packageManager="npm"
 npm run build # Или npm run dev
 ```
@@ -899,7 +910,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -912,7 +925,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);
@@ -1068,6 +1081,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

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Solid i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Vite + Solid. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:
@@ -585,8 +585,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Компилятор Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Обновите ваш `vite.config.ts`, чтобы включить плагин `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -601,6 +607,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Соберите приложение, чтобы преобразовать ваши компоненты и извлечь контент
+
 ```bash packageManager="npm"
 npm run build # Или npm run dev
 ```
@@ -657,7 +668,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -670,7 +683,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);
@@ -820,6 +833,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/intlayer_with_vite+svelte.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Svelte i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Vite + Svelte. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:
@@ -593,8 +593,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel compiler'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Обновите ваш `vite.config.ts`, чтобы включить плагин `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -609,6 +615,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Соберите приложение, чтобы преобразовать ваши компоненты и извлечь контент
+
 ```bash packageManager="npm"
 npm run build # Или npm run dev
 ```
@@ -665,7 +676,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -678,7 +691,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);

package/docs/ru/intlayer_with_vite+vanilla.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-03-23
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Vanilla JS i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Vite + Vanilla JS. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:
@@ -613,8 +613,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Компилятор Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Обновите `vite.config.ts`, включив плагин `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -629,6 +635,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Соберите приложение, чтобы преобразовать ваши компоненты и извлечь контент
+
 ```bash packageManager="npm"
 npm run build # Или npm run dev
 ```
@@ -685,7 +696,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -698,7 +711,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);

package/docs/ru/intlayer_with_vite+vue.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Vue i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Vite + Vue. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:
@@ -978,8 +978,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Компилятор Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Обновите ваш `vite.config.ts`, чтобы включить плагин `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -994,6 +1000,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Соберите приложение, чтобы преобразовать ваши компоненты и извлечь контент
+
 ```bash packageManager="npm"
 npm run build # Или npm run dev
 ```
@@ -1050,7 +1061,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -1063,7 +1076,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);

package/docs/ru/introduction.md

@@ -189,7 +189,6 @@ Intlayer предлагает множество функций, адаптир
 - **[Intlayer с Astro + Solid](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_astro_solid.md)**
 - **[Intlayer с Astro + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_astro_preact.md)**
 - **[Intlayer с Astro + Lit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_astro_lit.md)**
-- **[Intlayer с Astro + Vanilla JS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_astro_vanilla.md)**
 - **[Intlayer с Vite + Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+vue.md)**
 - **[Intlayer с Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_nuxt.md)**
 - **[Intlayer с Vite + Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+svelte.md)**

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()`, предоставляющий свойства локали и методы обновления.              |