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

package/docs/uk/packages/react-intlayer/useIntlayer.md

@@ -29,49 +29,6 @@ author: aymericzip
 
 У цьому розділі наведено докладні вказівки щодо використання хука `useIntlayer` у React-застосунках, що дозволяє ефективно локалізувати вміст.
 
-## Імпорт хуку `useIntlayer` у React
-
-Хук `useIntlayer` можна інтегрувати в React-застосунки, імпортуючи його залежно від контексту:
-
-- **Клієнтський компонент:**
-
-  ```typescript codeFormat="typescript"
-  import { useIntlayer } from "react-intlayer"; // Використовується в клієнтських React компонентах
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer"; // Використовується в клієнтських React компонентах
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer"); // Використовується в клієнтських React компонентах
-  ```
-
-- **Серверний компонент:**
-
-  ```typescript codeFormat="commonjs"
-  import { useIntlayer } from "react-intlayer/server"; // Використовується в серверних React компонентах
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer/server"; // Використовується в серверних React-компонентах
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer/server"); // Використовується в серверних React-компонентах
-  ```
-
-## Параметри
-
-Хук приймає два параметри:
-
-1. **`key`**: Ключ словника для отримання локалізованого вмісту.
-2. **`locale`** (необов'язковий): Бажана локаль. За замовчуванням використовується локаль контексту, якщо не вказано.
-
-## Словник
-
-Усі ключі словника повинні бути оголошені у файлах декларації контенту, щоб підвищити безпеку типів і уникнути помилок. Інструкцію з налаштування можна знайти [тут](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/content_file.md).
-
 ## Приклад використання в React
 
 Приклад використання хука `useIntlayer` у React-компоненті:
@@ -131,14 +88,6 @@ const ServerComponentExample = () => {
 };
 ```
 
-## Обробка атрибутів
-
-При локалізації атрибутів звертайтеся до значень контенту відповідним чином:
-
-```jsx
-<button title={content.buttonTitle.value}>{content.buttonText}</button>
-```
-
 ## Додаткові ресурси
 
 - **Intlayer Visual Editor**: Для інтуїтивнішого управління контентом зверніться до документації візуального редактора [тут](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_visual_editor.md).

package/docs/uk/packages/react-intlayer/usePathname.md

@@ -0,0 +1,87 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Документація хука usePathname | react-intlayer
+description: Дізнайтеся, як використовувати хук usePathname з пакета react-intlayer для отримання поточного шляху URL без сегмента локалі.
+keywords:
+  - usePathname
+  - pathname
+  - react
+  - intlayer
+  - маршрутизація
+  - інтернаціоналізація
+slugs:
+  - doc
+  - packages
+  - react-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Додано утиліту usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Ініціалізація історії"
+author: aymericzip
+---
+
+# Інтеграція з React: Документація хука `usePathname`
+
+Хук `usePathname` з `react-intlayer` повертає поточний шлях браузера (pathname) із видаленим сегментом локалі. Він покладається на нативну властивість `window.location.pathname` і реагує на події навігації браузера через `popstate`.
+
+## Імпорт `usePathname`
+
+```typescript
+import { usePathname } from "react-intlayer";
+```
+
+## Огляд
+
+На відміну від хуків маршрутизації, специфічних для фреймворку (наприклад, у `next-intlayer` або `react-router`), цей хук є легким, незалежним від фреймворку рішенням для звичайних React-додатків. Він отримує поточну URL-адресу та видаляє будь-який співпадаючий префікс локалі (наприклад, `/uk/about` стає `/about`).
+
+## Використання
+
+```tsx fileName="src/components/Navigation.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { usePathname } from "react-intlayer";
+
+const Navigation: FC = () => {
+  const pathname = usePathname();
+
+  return (
+    <nav>
+      <a
+        href="/home"
+        style={{ fontWeight: pathname === "/home" ? "bold" : "normal" }}
+      >
+        Головна
+      </a>
+      <a
+        href="/about"
+        style={{ fontWeight: pathname === "/about" ? "bold" : "normal" }}
+      >
+        Про нас
+      </a>
+    </nav>
+  );
+};
+
+export default Navigation;
+```
+
+## Значення, що повертається
+
+| Тип      | Опис                                                                                             |
+| -------- | ------------------------------------------------------------------------------------------------ |
+| `string` | Поточний шлях браузера з видаленим префіксом локалі (наприклад, `/uk/dashboard` → `/dashboard`). |
+
+## Поведінка
+
+- **Видалення локалі**: Під капотом використовує утиліту `getPathWithoutLocale` для автоматичного виявлення та видалення локалі зі шляху на основі конфігурації Intlayer додатка.
+- **Реактивність**: Слухає подію `popstate`. Коли користувач здійснює навігацію за допомогою кнопок назад/вперед у браузері або коли викликається `pushState`/`replaceState`, хук оновлює шлях, що повертається.
+- **SSR Fallback**: На сервері (де `window` не визначено), за замовчуванням повертає `/`, оскільки він не має доступу до URL-адреси запиту в чистому контексті React.
+
+## Пов'язана документація
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/react-intlayer/useLocale.md)
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/intlayer/getPathWithoutLocale.md)

package/docs/uk/packages/solid-intlayer/exports.md

@@ -14,9 +14,12 @@ slugs:
   - solid-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Додано утиліту usePathname"
   - version: 8.0.0
     date: 2026-01-21
-    changes: "Уніфікована документація для всіх експортів"
+    changes: "Уніфікована документация для всіх експортів"
 author: aymericzip
 ---
 
@@ -59,6 +62,7 @@ import "solid-intlayer";
 | `useDictionaryAsync`   | Те саме, що `useDictionary`, але працює з асинхронними словниками.                                                 | -                                                                                                                       |
 | `useDictionaryDynamic` | Те саме, що `useDictionary`, але працює з динамічними словниками.                                                  | -                                                                                                                       |
 | `useLocale`            | Повертає поточну локаль та функцію для її встановлення.                                                            | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/solid-intlayer/useLocale.md)         |
+| `usePathname`          | Повертає поточний шлях (pathname) як `Accessor<string>` із видаленим сегментом локалі. Реактивний до `popstate`.   | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/solid-intlayer/usePathname.md)     |
 | `useRewriteURL`        | Клієнтський хук для керування перенаписами URL. Автоматично оновлює URL, якщо існує локалізоване правило перепису. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/solid-intlayer/useRewriteURL.md) |
 | `useIntl`              | Повертає об'єкт Intl для поточної локалі.                                                                          | -                                                                                                                       |
 | `useLoadDynamic`       | Hook для завантаження динамічних словників.                                                                        | -                                                                                                                       |

package/docs/uk/packages/solid-intlayer/usePathname.md

@@ -0,0 +1,119 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Документація хука usePathname | solid-intlayer
+description: Дізнайтеся, як використовувати хук usePathname з пакета solid-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Інтернаціоналізація
+  - Документація
+  - Solid
+  - Solid.js
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - solid-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Додано утиліту usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Ініціалізація історії"
+author: aymericzip
+---
+
+# Інтеграція з Solid: Документація хука `usePathname`
+
+Хук `usePathname` повертає поточний шлях (pathname) браузера із видаленим сегментом локалі, у вигляді `Accessor<string>` для Solid. Це корисно для навігації з урахуванням локалі — наприклад, для визначення активного пункту меню — без необхідності вручну видаляти префікс локалі.
+
+## Імпорт `usePathname` в Solid
+
+```typescript
+import { usePathname } from "solid-intlayer";
+```
+
+## Огляд
+
+`usePathname` створює реактивний сигнал, що ініціалізується з `window.location.pathname`, видаляє префікс локалі через `getPathWithoutLocale` і оновлює сигнал кожного разу, коли браузер викликає подію `popstate` (навігація назад/вперед). Слухач подій автоматично очищається за допомогою `onCleanup`.
+
+## Використання
+
+```tsx fileName="src/components/NavItem.tsx"
+import type { Component } from "solid-js";
+import { usePathname } from "solid-intlayer";
+
+type NavItemProps = {
+  href: string;
+  label: string;
+};
+
+const NavItem: Component<NavItemProps> = ({ href, label }) => {
+  const pathname = usePathname();
+
+  return (
+    <a href={href} aria-current={pathname() === href ? "page" : undefined}>
+      {label}
+    </a>
+  );
+};
+
+export default NavItem;
+```
+
+## Значення, що повертається
+
+| Тип                | Опис                                                                                              |
+| ------------------ | ------------------------------------------------------------------------------------------------- |
+| `Accessor<string>` | Accessor для Solid (реактивний геттер), що повертає поточний шлях (pathname) без префікса локалі. |
+
+## Поведінка
+
+- **Видалення локалі**: Видаляє початковий сегмент локалі (наприклад, `/uk/dashboard` → `/dashboard`).
+- **Реактивність**: Автоматично оновлюється під час подій `popstate` (навігація назад/вперед у браузері).
+- **Безпека для SSR**: Повертає `""`, якщо об'єкт `window` недоступний.
+- **Очищення**: Слухач `popstate` автоматично видаляється через `onCleanup` у Solid.
+
+## Приклад
+
+```tsx fileName="src/components/Sidebar.tsx"
+import type { Component } from "solid-js";
+import { For } from "solid-js";
+import { usePathname } from "solid-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "Дашборд" },
+  { href: "/settings", label: "Налаштування" },
+];
+
+const Sidebar: Component = () => {
+  const pathname = usePathname();
+
+  return (
+    <nav>
+      <For each={links}>
+        {({ href, label }) => (
+          <a
+            href={href}
+            style={{ "font-weight": pathname() === href ? "bold" : "normal" }}
+          >
+            {label}
+          </a>
+        )}
+      </For>
+    </nav>
+  );
+};
+
+export default Sidebar;
+```
+
+## Пов'язані хуки
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/solid-intlayer/useLocale.md) — поточна локаль + перемикач локалей
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/intlayer/getPathWithoutLocale.md) — базова утиліта, яку використовує цей хук

package/docs/uk/packages/svelte-intlayer/exports.md

@@ -14,6 +14,9 @@ slugs:
   - svelte-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Додано утиліту usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Уніфікована документація для всіх експортів"
@@ -71,6 +74,7 @@ import "svelte-intlayer";
 | `useDictionaryAsync`   | Те ж саме, що й `useDictionary`, але обробляє асинхронні словники.                                                      | -                                                                                                                        |
 | `useDictionaryDynamic` | Те ж саме, що й `useDictionary`, але обробляє динамічні словники.                                                       | -                                                                                                                        |
 | `useLocale`            | Повертає поточну локаль та функцію для її встановлення.                                                                 | -                                                                                                                        |
+| `usePathname`          | Повертає поточний шлях (pathname) як стор `Readable<string>` із видаленим сегментом локалі. Реактивний до `popstate`.   | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/svelte-intlayer/usePathname.md)     |
 | `useRewriteURL`        | Клієнтська функція для керування перезаписами URL. Автоматично оновлює URL, якщо існує локалізоване правило перезапису. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/svelte-intlayer/useRewriteURL.md) |
 | `useIntl`              | Повертає об'єкт Intl для поточної локалі.                                                                               | -                                                                                                                        |
 

package/docs/uk/packages/svelte-intlayer/usePathname.md

@@ -0,0 +1,103 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Документація функції usePathname | svelte-intlayer
+description: Дізнайтеся, як використовувати функцію usePathname з пакету svelte-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Інтернаціоналізація
+  - Документація
+  - Svelte
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - svelte-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Додано утиліту usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Ініціалізація історії"
+author: aymericzip
+---
+
+# Інтеграція зі Svelte: Документація `usePathname`
+
+Функція `usePathname` повертає поточний шлях (pathname) браузера із видаленим сегментом локалі у вигляді Svelte-стору `Readable<string>`. Це корисно для створення навігації, що враховує локаль — наприклад, для визначення активного пункту меню — без необхідності вручну видаляти префікс локалі.
+
+## Імпорт `usePathname` у Svelte
+
+```typescript
+import { usePathname } from "svelte-intlayer";
+```
+
+## Огляд
+
+`usePathname` створює Svelte readable store, який зчитує `window.location.pathname`, видаляє префікс локалі за допомогою `getPathWithoutLocale`, та видає нове значення кожного разу, коли браузер ініціює подію `popstate` (навігація назад/вперед). Підписуйтесь на стор за допомогою синтаксису `$` у компонентах.
+
+## Використання
+
+```svelte fileName="src/components/NavItem.svelte"
+<script lang="ts">
+  import { usePathname } from "svelte-intlayer";
+
+  export let href: string;
+  export let label: string;
+
+  const pathname = usePathname();
+</script>
+
+<a {href} aria-current={$pathname === href ? "page" : undefined}>
+  {label}
+</a>
+```
+
+## Значення, що повертається
+
+| Тип                | Опис                                                                                              |
+| ------------------ | ------------------------------------------------------------------------------------------------- |
+| `Readable<string>` | Svelte readable store (реактивний стор), що містить поточний шлях (pathname) без префікса локалі. |
+
+## Поведінка
+
+- **Видалення локалі**: Видаляє початковий сегмент локалі (наприклад, `/uk/dashboard` → `/dashboard`).
+- **Реактивність**: Автоматично видає нове значення при подіях `popstate` (навігація назад/вперед у браузері).
+- **Безпека для SSR**: Повертає `""`, якщо об'єкт `window` недоступний.
+- **Очищення**: Слухач `popstate` автоматично видаляється, коли відписується останній підписник.
+
+## Приклад
+
+```svelte fileName="src/components/Sidebar.svelte"
+<script lang="ts">
+  import { usePathname } from "svelte-intlayer";
+
+  const links = [
+    { href: "/dashboard", label: "Дашборд" },
+    { href: "/settings", label: "Налаштування" },
+  ];
+
+  const pathname = usePathname();
+</script>
+
+<nav>
+  {#each links as link}
+    <a
+      href={link.href}
+      style:font-weight={$pathname === link.href ? "bold" : "normal"}
+    >
+      {link.label}
+    </a>
+  {/each}
+</nav>
+```
+
+## Пов'язані функції
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/svelte-intlayer/useLocale.md) — поточна локаль + перемикач локалей
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/intlayer/getPathWithoutLocale.md) — базова утиліта, що використовується цим хуком

package/docs/uk/packages/vue-intlayer/exports.md

@@ -14,6 +14,9 @@ slugs:
   - vue-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Додано утиліту usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Уніфікована документація для всіх експортів"
@@ -59,6 +62,7 @@ import "vue-intlayer";
 | `useDictionaryAsync`   | Те саме, що `useDictionary`, але обробляє асинхронні словники.                                                                          | -                                                                                                                     |
 | `useDictionaryDynamic` | Те саме, що `useDictionary`, але обробляє динамічні словники.                                                                           | -                                                                                                                     |
 | `useLocale`            | Повертає поточну локаль та функцію для її встановлення.                                                                                 | -                                                                                                                     |
+| `usePathname`          | Повертає поточний pathname як `ComputedRef<string>` з видаленим сегментом локалі. Реактивний до подій `popstate`.                       | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/vue-intlayer/usePathname.md)     |
 | `useRewriteURL`        | Composable на стороні клієнта для керування переписуванням URL. Автоматично оновлює URL, якщо існує локалізоване правило переписування. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/vue-intlayer/useRewriteURL.md) |
 | `useIntl`              | Повертає об'єкт Intl для поточної локалі.                                                                                               | -                                                                                                                     |
 | `useLoadDynamic`       | Composable для завантаження динамічних словників.                                                                                       | -                                                                                                                     |

package/docs/uk/packages/vue-intlayer/usePathname.md

@@ -0,0 +1,109 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Документація функції usePathname | vue-intlayer
+description: Дізнайтеся, як використовувати функцію usePathname з пакета vue-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Інтернаціоналізація
+  - Документація
+  - Vue
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - vue-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Додано утиліту usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Ініціалізація історії"
+author: aymericzip
+---
+
+# Інтеграція з Vue: Документація `usePathname`
+
+Функція `usePathname` повертає поточний шлях браузера (pathname) з видаленим сегментом локалі, як Vue `ComputedRef<string>`. Це корисно для створення навігації, що залежить від локалі — наприклад, щоб визначити, який елемент навігації є активним — без необхідності обробляти префікс локалі вручну.
+
+## Імпорт `usePathname` у Vue
+
+```typescript
+import { usePathname } from "vue-intlayer";
+```
+
+## Огляд
+
+`usePathname` створює Vue обчислюване посилання (computed ref), яке зчитує `window.location.pathname`, видаляє префікс локалі через `getPathWithoutLocale` і оновлює своє значення щоразу, коли браузер ініціює подію `popstate` (навігація назад/вперед). Це значення можна безпосередньо використовувати у ваших шаблонах Vue або функціях setup.
+
+## Використання
+
+```vue fileName="src/components/NavItem.vue"
+<script setup lang="ts">
+import { usePathname } from "vue-intlayer";
+
+const props = defineProps<{
+  href: string;
+  label: string;
+}>();
+
+const pathname = usePathname();
+</script>
+
+<template>
+  <a :href="href" :aria-current="pathname === href ? 'page' : undefined">
+    {{ label }}
+  </a>
+</template>
+```
+
+## Значення, що повертається
+
+| Тип                   | Опис                                                                                |
+| --------------------- | ----------------------------------------------------------------------------------- |
+| `ComputedRef<string>` | Vue Computed Ref, що містить поточний шлях браузера (pathname) без префіксу локалі. |
+
+## Поведінка
+
+- **Видалення локалі (Locale stripping)**: Видаляє початковий сегмент локалі (наприклад, `/uk/dashboard` → `/dashboard`).
+- **Реактивність**: Оновлює значення при кожній події `popstate` (навігація браузера назад / вперед).
+- **Безпека для SSR**: Повертає `""`, коли `window` недоступний.
+- **Очищення (Cleanup)**: Слухач події `popstate` додається глобально під час ініціалізації і зазвичай не потребує ручного очищення в кожному компоненті завдяки тому, як Vue керує життєвим циклом.
+
+## Приклад
+
+```vue fileName="src/components/Sidebar.vue"
+<script setup lang="ts">
+import { usePathname } from "vue-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "Дашборд" },
+  { href: "/settings", label: "Налаштування" },
+];
+
+const pathname = usePathname();
+</script>
+
+<template>
+  <nav>
+    <a
+      v-for="link in links"
+      :key="link.href"
+      :href="link.href"
+      :style="{ fontWeight: pathname === link.href ? 'bold' : 'normal' }"
+    >
+      {{ link.label }}
+    </a>
+  </nav>
+</template>
+```
+
+## Пов'язане
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/vue-intlayer/useLocale.md) — поточна локаль + перемикач локалі
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/intlayer/getPathWithoutLocale.md) — базова утиліта, що використовується цим хуком

package/docs/uk/releases/v6.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Ласкаво просимо в Intlayer v6! У цьому релізі акцент зроблено на продуктивності, developer experience та надійності. Нижче наведено основні моменти, нотатки щодо міграції та приклади, які можна копіювати й вставляти.
 
+## Зміст
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Основні зміни
 
 - Нова команда: `npx intlayer content test` для виявлення відсутніх перекладів

package/docs/uk/releases/v7.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Ласкаво просимо до Intlayer v7! Це велике оновлення вводить суттєві покращення продуктивності, type safety і developer experience. Нижче наведено основні зміни, нотатки щодо міграції та практичні приклади.
 
+## Зміст
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Основні моменти
 
 - Підтримка Next.js 16

package/docs/uk/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-14
+updatedAt: 2026-06-23
 title: Новий Intlayer v9 - Що нового?
 description: Дізнайтеся, що нового в Intlayer v9. Представляємо сумісні пакети швидкої заміни (drop-in) для популярних бібліотек i18n та підтримку Collections, Variants та Dynamic Records.
 keywords:
@@ -216,6 +216,42 @@ export default {
 
 ---
 
+## Vite Plugin: Bundled Compiler & Proxy
+
+Плагін Vite `intlayer()` тепер об'єднує **компілятор** та **проксі для маршрутизації локалей** безпосередньо, тому більшості проектів потрібен лише один плагін у `vite.config.ts`:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **Compiler**: Активується автоматично, коли встановлено `compiler.enabled` та налаштована шлях `compiler.output`. Вам більше не потрібно реєструвати `intlayerCompiler()` окремо.
+- **Proxy**: Активується автоматично на основі нового параметра `routing.enableProxy` (`true` за замовчуванням). Він підключає middleware виявлення локалей / перенаправлення / переписування в режимі розробки, попереднього перегляду та production SSR. Вам більше не потрібно реєструвати `intlayerProxy()` окремо.
+
+### Опція `routing.enableProxy`
+
+Нова опція `routing.enableProxy` контролює, чи підключений проксі маршрутизації локалі. За замовчуванням встановлено значення `true`. Вимкніть її, якщо ви хочете самостійно обробляти маршрутизацію локалі:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // За замовчуванням: true
+  },
+};
+
+export default config;
+```
+
+Автономні плагіни `intlayerCompiler()` та `intlayerProxy()` залишаються експортованими для складних налаштувань. Реєстрація їх разом з `intlayer()` безпечна — кожен плагін автоматично дедублює себе і запускається лише один раз.
+
+---
+
 ## Примітки щодо міграції з v8
 
 Якщо ви оновлюєтеся з v8, зверніть увагу, що v9 не містить критичних змін (breaking changes). Проте ось ключові зміни: