@intlayer/docs 9.0.0-canary.4 → 9.0.0-canary.5

package/docs/ru/formatters.md

@@ -176,6 +176,100 @@ getLocaleName("de", "es"); // "alemán"
 - **displayLocale**: Локаль, для которой нужно получить название
 - **targetLocale**: Локаль, на которой будет отображаться название (по умолчанию displayLocale)
 
+### Доступные Composables
+
+Все composables возвращают computed refs, которые автоматически используют локаль из внедренного `IntlayerProvider`.
+
+| Composable          | Описание                                    | Пример вывода                 |
+| ------------------- | ------------------------------------------- | ----------------------------- |
+| `useNumber()`       | Форматирование чисел с группировкой         | `"123,456.789"`               |
+| `useCurrency()`     | Форматирование значений валют               | `"€1,234.50"`                 |
+| `usePercentage()`   | Форматирование процентов                    | `"25%"`                       |
+| `useDate()`         | Форматирование дат и времени                | `"Aug 2, 2025"`               |
+| `useRelativeTime()` | Форматирование относительного времени       | `"in 3 days"`                 |
+| `useUnit()`         | Форматирование значений с единицами         | `"5 kilometers"`              |
+| `useCompact()`      | Форматирование чисел в компактной нотации   | `"1.2K"`                      |
+| `useList()`         | Форматирование массивов как списки          | `"apple, banana, and orange"` |
+| `useIntl()`         | Получить привязанный к локали объект `Intl` | Полный доступ к `Intl` API    |
+
+### Полный пример
+
+```vue
+<script setup>
+import {
+  useNumber,
+  useCurrency,
+  useDate,
+  usePercentage,
+  useCompact,
+  useList,
+  useRelativeTime,
+  useUnit,
+} from "vue-intlayer/format";
+
+const number = useNumber();
+const currency = useCurrency();
+const date = useDate();
+const percentage = usePercentage();
+const compact = useCompact();
+const list = useList();
+const relativeTime = useRelativeTime();
+const unit = useUnit();
+</script>
+
+<template>
+  <div>
+    <p>{{ number.value(123456.789) }}</p>
+    <p>{{ currency.value(1234.5, { currency: "EUR" }) }}</p>
+    <p>{{ date.value(new Date(), "short") }}</p>
+    <p>{{ percentage.value(0.25) }}</p>
+    <p>{{ compact.value(1200) }}</p>
+    <p>{{ list.value(["apple", "banana", "orange"]) }}</p>
+    <p>{{ relativeTime.value(new Date(), new Date(Date.now() + 86400000)) }}</p>
+    <p>{{ unit.value(5, { unit: "kilometer" }) }}</p>
+  </div>
+</template>
+```
+
+### Composable `useIntl`
+
+Composable `useIntl` предоставляет прямой доступ к объекту `Intl`, привязанному к локали. Это полезно, когда вам нужен полный API `Intl` с автоматическим внедрением локали.
+
+```vue
+<script setup>
+import { useIntl } from "vue-intlayer/format";
+
+const intl = useIntl(); // использует локаль контекста
+
+// Стандартный API Intl, но локаль автоматически внедряется, если не определена
+const formatted = new intl.value.NumberFormat(undefined, {
+  style: "currency",
+  currency: "USD",
+}).format(123.45);
+
+// Вы все еще можете переопределить локаль, если необходимо
+const date = new intl.value.DateTimeFormat("fr-FR").format(new Date());
+
+// Доступ к другим функциям Intl
+const displayNames = new intl.value.DisplayNames(undefined, {
+  type: "language",
+});
+const languageName = displayNames.of("fr");
+</script>
+
+<template>
+  <div>
+    <p>{{ formatted }}</p>
+    <p>{{ date }}</p>
+    <p>{{ languageName }}</p>
+  </div>
+</template>
+```
+
+## Vanilla JS / Node.js Formatters
+
+Для контекстов без framework'а импортируйте форматтеры напрямую из `intlayer`. Обратите внимание, что вы должны передать locale вручную.
+
 ### `getLocaleLang(locale?)`
 
 Извлекает код языка из строки локали:
@@ -190,6 +284,8 @@ getLocaleLang("de"); // "de"
 
 - **locale**: Локаль, из которой нужно извлечь язык (по умолчанию текущая локаль)
 
+### Функции форматирования
+
 ### `getLocaleFromPath(inputUrl)`
 
 Извлекает сегмент локали из URL или пути:
@@ -312,6 +408,36 @@ const nestedContent = getIntlayer("common", "fr", customPlugins);
 - **locale**: Необязательная локаль (по умолчанию используется настроенная локаль по умолчанию)
 - **plugins**: Необязательный массив пользовательских плагинов трансформации
 
+## Cached Intl
+
+Экспортируемый `Intl` из `intlayer` — это кэшированная обёртка вокруг глобального `Intl`. Она мемоизирует экземпляры форматтеров (`NumberFormat`, `DateTimeFormat` и т. д.), чтобы избежать их повторного создания и улучшить производительность.
+
+```ts
+import { Intl } from "intlayer";
+
+// Форматирование чисел
+const numberFormat = new Intl.NumberFormat("en-GB", {
+  style: "currency",
+  currency: "GBP",
+});
+numberFormat.format(1234.5); // "£1,234.50"
+
+// Отображение названий языков, регионов и т. д.
+const displayNames = new Intl.DisplayNames("fr", { type: "language" });
+displayNames.of("en"); // "anglais"
+
+// Сортировка по правилам коллации
+const collator = new Intl.Collator("fr", { sensitivity: "base" });
+collator.compare("é", "e"); // 0 (equal)
+
+// Правила plurals
+const pluralRules = new Intl.PluralRules("fr");
+pluralRules.select(1); // "one"
+pluralRules.select(2); // "other"
+```
+
+### Дополнительные возможности Intl
+
 ### `getIntlayerAsync(dictionaryKey, locale?, plugins?)`
 
 Асинхронно получает контент из удалённого словаря:
@@ -347,6 +473,8 @@ number("1000000", { locale: "fr" }); // "1 000 000"
 number(1234.5, { minimumFractionDigits: 2 }); // "1,234.50"
 ```
 
+## Утилиты Локализации
+
 ### `percentage(value, options?)`
 
 Форматирует число в строку с процентами.
@@ -457,6 +585,8 @@ compact(1200); // "1.2K"
 compact("1000000", { locale: "fr", compactDisplay: "long" }); // "1 million"
 ```
 
+## Утилиты для обработки содержимого
+
 ### `list(values, options?)`
 
 Форматирует массив значений в локализованную строку списка с использованием `Intl.ListFormat`.
@@ -591,3 +721,9 @@ import {
 ```
 
 > Эти композиционные функции будут учитывать локаль из внедренного `IntlayerProvider`
+
+## Примечания
+
+- Все вспомогательные функции принимают входные данные типа `string`; они внутренне преобразуются в числа или даты.
+- Локаль по умолчанию использует ваш настроенный `internationalization.defaultLocale`, если не указана.
+- Эти утилиты являются тонкими оболочками; для продвинутого форматирования передавайте стандартные параметры `Intl`.

package/docs/ru/how_works_intlayer.md

@@ -22,6 +22,10 @@ author: aymericzip
 
 # Как работает Intlayer
 
+## Таблица содержания
+
+<TOC/>
+
 ## Обзор
 
 Основная идея Intlayer заключается в использовании управления контентом на уровне компонентов. Идея Intlayer состоит в том, чтобы позволить вам объявлять ваш контент в любом месте вашего кода, например, в той же директории, что и ваш компонент.

package/docs/ru/intlayer_CMS.md

@@ -40,6 +40,12 @@ Intlayer CMS, это приложение, которое позволяет в
 
 ![Интерфейс Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/assets/CMS.png)
 
+## Оглавление
+
+<TOC/>
+
+---
+
 ## Понимание удалённых словарей
 
 Intlayer различает «локальные» и «удалённые» словари.

package/docs/ru/intlayer_with_astro.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-03-07
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Astro i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Astro. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:
@@ -317,7 +317,134 @@ const { title } = getIntlayer('app');
 
 </Step>
 
-<Step number={7} title="Продолжайте использовать ваш любимый фреймворк">
+<Step number={7} title="Добавление переключателя языков">
+
+Чтобы пользователи могли переключаться между языками, вы можете создать компонент `LocaleSwitcher`. Этот компонент должен отображать список всех поддерживаемых языков и ссылаться на ту же страницу на каждом языке.
+
+```astro fileName="src/components/LocaleSwitcher.astro"
+---
+import {
+  locales,
+  getLocaleName,
+  getLocalizedUrl,
+  getLocaleFromPath,
+  getPathWithoutLocale,
+  type LocalesValues,
+} from "intlayer";
+
+const locale = getLocaleFromPath(Astro.url.pathname) as LocalesValues;
+const pathWithoutLocale = getPathWithoutLocale(Astro.url.pathname);
+---
+
+<nav>
+  {
+    locales.map((localeItem) => (
+      <a
+        href={getLocalizedUrl(pathWithoutLocale, localeItem)}
+        data-locale={localeItem}
+        aria-current={localeItem === locale ? "page" : undefined}
+      >
+        {getLocaleName(localeItem)}
+      </a>
+    ))
+  }
+</nav>
+
+<script>
+  import { setLocaleInStorageClient, getLocalizedUrl, type LocalesValues } from "intlayer";
+
+  const localeLinks = document.querySelectorAll("[data-locale]");
+
+  localeLinks.forEach((link) => {
+    link.addEventListener("click", (e) => {
+      const locale = link.getAttribute("data-locale") as LocalesValues;
+
+      // Update the locale cookie
+      setLocaleInStorageClient(locale);
+    });
+  });
+</script>
+
+<style>
+  nav {
+    display: flex;
+    gap: 1rem;
+  }
+  a[aria-current="page"] {
+    font-weight: bold;
+    text-decoration: underline;
+  }
+</style>
+```
+
+> **Примечание о сохранении настроек:**
+> Использование `setLocaleInStorageClient` в клиентском скрипте гарантирует, что языковые предпочтения пользователя сохраняются в куки. Это позволяет промежуточному ПО Intlayer запомнить выбор и автоматически перенаправлять пользователя на предпочитаемый язык при будущих посещениях.
+
+</Step>
+
+<Step number={8} title="Sitemap и Robots.txt">
+
+Intlayer предоставляет утилиты для динамического создания локализованных карт сайта и файлов robots.txt.
+
+#### Sitemap
+
+Intlayer поставляется со встроенным генератором карты сайта, который поможет вам легко создать карту сайта для вашего приложения. Он учитывает локализованные маршруты и добавляет необходимые метаданные для поисковых систем.
+
+> Создаваемая Intlayer карта сайта поддерживает пространство имен `xhtml:link` (Hreflang XML Extensions). В отличие от стандартных генераторов карт сайта, которые просто перечисляют прямые URL-адреса, Intlayer автоматически создает необходимые двусторонние связи между всеми языковыми версиями страницы (например, `/about`, `/about?lang=fr` и `/about?lang=es`). Это гарантирует, что поисковые системы будут правильно индексировать и показывать нужную языковую версию соответствующей аудитории.
+
+Создайте `src/pages/sitemap.xml.ts` для генерации карты сайта, включающей все ваши локализованные маршруты.
+
+```typescript fileName="src/pages/sitemap.xml.ts"
+import type { APIRoute } from "astro";
+import { generateSitemap, type SitemapUrlEntry } from "intlayer";
+
+const pathList: SitemapUrlEntry[] = [
+  { path: "/", changefreq: "daily", priority: 1.0 },
+  { path: "/about", changefreq: "monthly", priority: 0.7 },
+];
+
+const SITE_URL = import.meta.env.SITE ?? "http://localhost:4321";
+
+export const GET: APIRoute = async ({ site }) => {
+  const xmlOutput = generateSitemap(pathList, { siteUrl: SITE_URL });
+
+  return new Response(xmlOutput, {
+    headers: { "Content-Type": "application/xml" },
+  });
+};
+```
+
+#### Robots.txt
+
+Создайте `src/pages/robots.txt.ts` для управления сканированием поисковыми системами.
+
+```typescript fileName="src/pages/robots.txt.ts"
+import type { APIRoute } from "astro";
+import { getMultilingualUrls } from "intlayer";
+
+const getAllMultilingualUrls = (urls: string[]) =>
+  urls.flatMap((url) => Object.values(getMultilingualUrls(url)) as string[]);
+
+const disallowedPaths = getAllMultilingualUrls(["/admin", "/private"]);
+
+export const GET: APIRoute = ({ site }) => {
+  const robotsTxt = [
+    "User-agent: *",
+    "Allow: /",
+    ...disallowedPaths.map((path) => `Disallow: ${path}`),
+    "",
+    `Sitemap: ${new URL("/sitemap.xml", site).href}`,
+  ].join("\n");
+
+  return new Response(robotsTxt, {
+    headers: { "Content-Type": "text/plain" },
+  });
+};
+```
+
+</Step>
+
+<Step number={9} title="Продолжайте использовать ваш любимый фреймворк">
 
 Продолжайте использовать ваш любимый фреймворк для создания вашего приложения.
 

package/docs/ru/intlayer_with_astro_lit.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-24
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Astro + Lit i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Astro + Lit. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:

package/docs/ru/intlayer_with_astro_preact.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-24
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Astro + Preact i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Astro + Preact. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:

package/docs/ru/intlayer_with_astro_react.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-03-07
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Astro + React i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Astro + React. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:

package/docs/ru/intlayer_with_astro_solid.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-24
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Astro + Solid i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Astro + Solid. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:

package/docs/ru/intlayer_with_astro_svelte.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-24
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Astro + Svelte i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Astro + Svelte. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:

package/docs/ru/intlayer_with_astro_vanilla.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-24
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Astro + Vanilla JS i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Astro + Vanilla JS. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:

package/docs/ru/intlayer_with_astro_vue.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-24
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Astro + Vue i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Astro + Vue. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:

package/docs/ru/intlayer_with_express.md

@@ -32,10 +32,6 @@ author: aymericzip
 
 `express-intlayer` , это мощное промежуточное программное обеспечение для интернационализации (i18n) приложений Express, разработанное для того, чтобы сделать ваши серверные службы доступными по всему миру, предоставляя локализованные ответы на основе предпочтений клиента.
 
-## Зачем интернационализировать ваш сервер?
-
-Интернационализация вашего сервера необходима для эффективного обслуживания глобальной аудитории. Это позволяет вашему приложению предоставлять контент и сообщения на предпочтительном языке каждого пользователя. Эта возможность улучшает пользовательский опыт и расширяет охват вашего приложения, делая его более доступным и актуальным для людей с разным языковым фоном.
-
 ### Практические случаи использования
 
 - **Отображение ошибок сервера на языке пользователя**: Когда происходит ошибка, отображение сообщений на родном языке пользователя улучшает понимание и снижает уровень разочарования. Это особенно полезно для динамических сообщений об ошибках, которые могут отображаться в компонентах интерфейса, таких как всплывающие уведомления или модальные окна.
@@ -361,25 +357,6 @@ export default config;
 
 Рекомендуется игнорировать файлы, сгенерированные Intlayer. Это позволит избежать их коммита в ваш репозиторий Git.
 
-### Расширение VS Code
-
-Для улучшения вашего опыта разработки с Intlayer вы можете установить официальное **расширение Intlayer для VS Code**.
-
-[Установить из VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
-
-Это расширение предоставляет:
-
-- **Автозаполнение** ключей переводов.
-- **Обнаружение ошибок в реальном времени** для отсутствующих переводов.
-- **Встроенный просмотр** переведённого контента.
-- **Быстрые действия** для лёгкого создания и обновления переводов.
-
-Для получения подробной информации о том, как использовать расширение, обратитесь к [документации расширения Intlayer для VS Code](https://intlayer.org/doc/ru/vs-code-extension).
-
-### Конфигурация Git
-
-Рекомендуется игнорировать файлы, сгенерированные Intlayer. Это позволит избежать их коммита в ваш репозиторий Git.
-
 Для этого вы можете добавить следующие инструкции в ваш файл `.gitignore`:
 
 ```plaintext fileName=".gitignore"

package/docs/ru/intlayer_with_nestjs.md

@@ -33,24 +33,6 @@ history:
 
 `express-intlayer`, это мощный middleware для интернационализации (i18n) в приложениях на Express, разработанный для того, чтобы сделать ваши бэкенд-сервисы доступными по всему миру, предоставляя локализованные ответы в зависимости от предпочтений клиента. Поскольку NestJS построен поверх Express, вы можете без проблем интегрировать `express-intlayer` в ваши приложения на NestJS для эффективной работы с многоязычным контентом.
 
-## Зачем интернационализировать ваш бэкенд?
-
-Интернационализация вашего бэкенда необходима для эффективного обслуживания глобальной аудитории. Она позволяет вашему приложению предоставлять контент и сообщения на предпочитаемом языке каждого пользователя. Эта возможность улучшает пользовательский опыт и расширяет охват вашего приложения, делая его более доступным и релевантным для людей с разным языковым фоном.
-
-### Практические случаи использования
-
-- **Отображение ошибок бэкенда на языке пользователя**: Когда возникает ошибка, отображение сообщений на родном языке пользователя улучшает понимание и снижает уровень разочарования. Это особенно полезно для динамических сообщений об ошибках, которые могут отображаться во фронтенд-компонентах, таких как тосты или модальные окна.
-
-- **Получение многоязычного контента**: Для приложений, которые извлекают контент из базы данных, интернационализация гарантирует возможность предоставления этого контента на нескольких языках. Это критично для платформ, таких как сайты электронной коммерции или системы управления контентом, которым необходимо отображать описания продуктов, статьи и другой контент на предпочитаемом пользователем языке.
-
-- **Отправка многоязычных писем**: Будь то транзакционные письма, маркетинговые кампании или уведомления, отправка писем на языке получателя может значительно повысить вовлеченность и эффективность.
-
-- **Многоязычные push-уведомления**: Для мобильных приложений отправка push-уведомлений на предпочитаемом пользователем языке может улучшить взаимодействие и удержание. Такой персональный подход делает уведомления более релевантными и действенными.
-
-- **Другие виды коммуникаций**: Любая форма коммуникации с бэкенда, такая как SMS-сообщения, системные оповещения или обновления пользовательского интерфейса, выигрывает от использования языка пользователя, обеспечивая ясность и улучшая общий пользовательский опыт.
-
-Интернационализируя бэкенд, ваше приложение не только уважает культурные различия, но и лучше соответствует потребностям глобального рынка, что делает этот шаг ключевым для масштабирования ваших сервисов по всему миру.
-
 ## Начало работы
 
 ### Создание нового проекта NestJS

package/docs/ru/intlayer_with_nextjs_14.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-12-06
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Next.js 14 i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Next.js 14. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:
@@ -53,6 +53,10 @@ author: aymericzip
 
 Смотрите [шаблон приложения](https://github.com/aymericzip/intlayer-next-14-template) на GitHub.
 
+## Оглавление
+
+<TOC/>
+
 ## Почему Intlayer лучше альтернатив?
 
 По сравнению с основными решениями, такими как next-intl или i18next, Intlayer представляет собой решение со встроенными оптимизациями, такими как:
@@ -895,33 +899,52 @@ bun add @intlayer/swc --dev
 
 ### Настройка TypeScript
 
-Intlayer использует расширение модулей для получения преимуществ TypeScript и усиления вашего кода.
+Intlayer использует расширение модулей (module augmentation), чтобы использовать преимущества TypeScript и сделать ваш код более надёжным.
 
 ![Autocompletion](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)
 
 ![Translation error](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.png?raw=true)
 
-Убедитесь, что ваша конфигурация TypeScript включает автогенерируемые типы.
+Убедитесь, что ваша конфигурация TypeScript включает автоматически сгенерированные типы.
 
 ```json5 fileName="tsconfig.json"
 {
-  // ... Ваши существующие конфигурации TypeScript
+  // ... Ваши существующие настройки TypeScript
   "include": [
     // ... Ваши существующие конфигурации TypeScript
-    ".intlayer/**/*.ts", // Включить автогенерируемые типы
+    ".intlayer/**/*.ts", // Включить автоматически сгенерированные типы
   ],
 }
 ```
 
 ### Конфигурация Git
 
-Рекомендуется игнорировать файлы, сгенерированные Intlayer. Это позволяет избежать их добавления в ваш репозиторий Git.
+Рекомендуется игнорировать файлы, сгенерированные Intlayer. Это позволит избежать их коммита в ваш репозиторий Git.
 
-Для этого вы можете добавить следующие инструкции в ваш файл `.gitignore`:
+Для этого вы можете добавить следующие инструкции в файл `.gitignore`:
 
 ```plaintext fileName=".gitignore"
 # Игнорировать файлы, сгенерированные Intlayer
 .intlayer
 ```
 
-### Дальнейшие шаги
+### Расширение VS Code
+
+Для улучшения вашего опыта разработки с Intlayer вы можете установить официальное **расширение Intlayer для VS Code**.
+
+[Установить из VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
+
+Это расширение предоставляет:
+
+- **Автодополнение** для ключей переводов.
+- **Обнаружение ошибок в реальном времени** для отсутствующих переводов.
+- **Встроенный просмотр** переведённого контента.
+- **Быстрые действия** для лёгкого создания и обновления переводов.
+
+Для получения дополнительной информации о том, как использовать расширение, обратитесь к [документации расширения Intlayer для VS Code](https://intlayer.org/doc/ru/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_nextjs_15.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-12-06
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Next.js 15 i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Next.js 15. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:
@@ -65,6 +65,10 @@ author: aymericzip
 
 Смотрите [Шаблон приложения](https://github.com/aymericzip/intlayer-next-15-template) на GitHub.
 
+## Оглавление
+
+<TOC/>
+
 ## Почему Intlayer лучше альтернатив?
 
 По сравнению с основными решениями, такими как next-intl или i18next, Intlayer представляет собой решение со встроенными оптимизациями, такими как:
@@ -886,6 +890,22 @@ bun add @intlayer/swc --dev
 
 </Steps>
 
+### Отслеживание изменений словарей в Turbopack
+
+При использовании Turbopack в качестве сервера разработки с помощью команды `next dev --turbopack` изменения в словарях по умолчанию не будут обнаруживаться автоматически.
+
+Это ограничение возникает из-за того, что Turbopack не может параллельно запускать плагины webpack для мониторинга изменений в ваших контентных файлах. Чтобы обойти это, вам нужно использовать команду `intlayer watch` для одновременного запуска сервера разработки и наблюдателя сборки Intlayer.
+
+```json5 fileName="package.json"
+{
+  // ... Ваши существующие конфигурации package.json
+  "scripts": {
+    // ... Ваши существующие конфигурации скриптов
+    "dev": "intlayer watch --with 'next dev --turbopack'",
+  },
+}
+```
+
 ### Настройка TypeScript
 
 Intlayer использует расширение модулей (module augmentation), чтобы использовать преимущества TypeScript и сделать ваш код более надёжным.

package/docs/ru/intlayer_with_nextjs_16.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-12-06
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Next.js 16 i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Next.js 16. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:

package/docs/ru/intlayer_with_nextjs_compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-01-10
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Next.js i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Next.js. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:

package/docs/ru/intlayer_with_nextjs_no_locale_path.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-01-10
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Next.js 16 i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Next.js 16. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords: