@intlayer/docs 9.3.3 → 9.4.0

package/docs/uk/packages/intlayer/getIntlayer.md

@@ -0,0 +1,197 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: Документація функції getIntlayer | intlayer
+description: Дивіться, як використовувати функцію getIntlayer для пакета intlayer
+keywords:
+  - getIntlayer
+  - dictionary
+  - content
+  - selector
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getIntlayer
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Документація: функція `getIntlayer` в `intlayer`
+
+## Опис
+
+Функція `getIntlayer` вибирає один словник за його ключем і повертає його вміст, інтерпретований для певної локалі. Це аналог хука `useIntlayer`, незалежний від фреймворку: той самий вміст, ті самі селектори, але придатний скрізь, де React контекст недоступний — Node-скрипти, серверні функції, завантажувачі маршрутів, конструктори метаданих, обробники Express/Fastify, тести.
+
+Він читає словники, згенеровані Intlayer у `.intlayer/`, тому аргумент `key` типізований та автодоповнюється на основі ваших декларацій вмісту, а повернений об'єкт повністю типізований аж до кожного листка.
+
+**Ключові особливості:**
+
+- Типізовані ключі словника та типізований повернений вміст
+- Інтерпретує кожен вузол вмісту (`t()`, `enu()`, `cond()`, `insert()`, `nest()`, `md()`, `html()`, `file()`, `gender()`)
+- Приймає локаль або об'єкт селектора (колекції, варіанти)
+- Результати кешуються для кожної комбінації `key + locale + selector`
+- Під час розробки повертається до безпечного проксі, коли словник відсутній, замість краху
+
+---
+
+## Function Signature
+
+```typescript
+getIntlayer(
+  key: DictionaryKeys,                        // Обов'язковий
+  localeOrSelector?: LocalesValues | DictionarySelector, // Опціональний
+  plugins?: Plugins[]                         // Опціональний
+): DeepTransformContent<...>
+```
+
+---
+
+## Параметри
+
+- `key: DictionaryKeys`
+  - **Description**: The key of the dictionary to read, as declared in your content files.
+  - **Type**: `DictionaryKeys` — a union of every declared dictionary key.
+  - **Required**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Description**: The locale to interpret the content with, or a selector object for [dynamic dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dynamic_dictionaries/index.md).
+    - `'fr'` — a locale
+    - `{ item: 2 }` — a [collection](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dynamic_dictionaries/collections.md) item (omit `item` to get every item as an array)
+    - `{ variant: 'black-friday' }` — a named [variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dynamic_dictionaries/variants.md) (omit for the `default` one)
+    - `{ variant: { id: 'prod_abc', userId: '123' } }` — a structured variant
+    - Any selector can carry a locale: `{ item: 2, locale: 'fr' }`
+  - **Type**: `LocalesValues | DictionarySelector`
+  - **Required**: No (Optional) — defaults to the configured `defaultLocale`.
+
+- `plugins: Plugins[]`
+  - **Description**: Custom node transformers replacing the base interpreter plugins. Advanced use only; omit it to keep the default behaviour.
+  - **Type**: `Plugins[]`
+  - **Required**: No (Optional)
+
+### Повертає
+
+- **Тип**: Інтерпретований вміст словника, типізований з вашої декларації.
+- **Опис**: Простий об'єкт, що відображає поле `content` вашого словника, де кожен вузол Intlayer розв'язаний на його остаточне значення для запитуваної мови.
+
+---
+
+## Приклад використання
+
+### Базове використання
+
+```typescript fileName="src/app.content.ts" codeFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const appContent = {
+  key: "app",
+  content: {
+    title: t({
+      uk: "Привіт",
+      en: "Hello",
+      fr: "Bonjour",
+    }),
+  },
+} satisfies Dictionary;
+
+export default appContent;
+```
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer("app", "fr"); // "Bonjour"
+```
+
+### Без локалі
+
+Пропуск локалі інтерпретує вміст за допомогою `defaultLocale`, декларованої у вашій [конфігурації](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md).
+
+```typescript
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer("app"); // Інтерпретується з локаллю за замовчуванням
+```
+
+### Усередині серверного обробника
+
+```typescript fileName="src/routes/greeting.ts" codeFormat="typescript"
+import { getIntlayer, getLocale } from "intlayer";
+
+export const greetingHandler = async (request: Request) => {
+  const locale = await getLocale({
+    getHeader: (name) => request.headers.get(name) ?? undefined,
+  });
+
+  const { title } = getIntlayer("app", locale);
+
+  return Response.json({ title });
+};
+```
+
+### З селектором (колекції та варіанти)
+
+```typescript
+import { getIntlayer } from "intlayer";
+
+// Один елемент колекції
+const secondPost = getIntlayer("blog-post", { item: 2, locale: "fr" });
+
+// Всі елементи колекції як упорядкований масив
+const allPosts = getIntlayer("blog-post", { locale: "fr" });
+
+// Названий варіант
+const banner = getIntlayer("banner", { variant: "black-friday", locale: "fr" });
+```
+
+---
+
+## Примітки щодо поведінки
+
+### Caching
+
+Результати кешуються в кеші на рівні модуля за допомогою ключа `key + locale + selector`. Повторне виклик `getIntlayer("app", "fr")` інтерпретує словник один раз і повертає той самий об'єкт потім.
+
+### Відсутні словники
+
+Під час розробки, якщо запросити ключ, для якого не було згенеровано словник, виводиться попередження один раз і повертається безпечний резервний проксі: читання `content.title` повертає рядок `"app.title"` замість викидання помилки. Це дозволяє сторінці залишатися функціональною, поки відсутня декларація не буде виправлена. Запустіть збірку Intlayer (або dev сервер), щоб словник був згенеровано.
+
+### Розмір bundle
+
+`getIntlayer` читає об'єднаний словник, який містить **кожну** локаль. У клієнтських bundle'ах [плагіни збірки](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/bundle_optimization.md) переписують виклик, щоб відправляється тільки необхідний контент. Коли ви читаєте контент поза рендерингом (метадані, loader'и, серверні функції) і хочете, щоб одна локаль завантажувалася за запитом, використовуйте замість цього [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/intlayer/getIntlayerAsync.md).
+
+---
+
+## Пов'язані функції
+
+- [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/intlayer/getIntlayerAsync.md): Асинхронний аналог для завантаження одного chunk'у локалізації.
+- [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/intlayer/getDictionary.md): Інтерпретує об'єкт dictionary, який ви передаєте самі, замість пошуку за ключем.
+- [`useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/react-intlayer/useIntlayer.md): React hook еквівалент, який зчитує локаль від провайдера.
+
+---
+
+## TypeScript
+
+```typescript
+function getIntlayer<
+  const T extends DictionaryKeys,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  key: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): DeepTransformContent<
+  DictionaryRegistryResult<T, A>,
+  IInterpreterPluginState,
+  ExtractSelectorLocale<A>
+>;
+```

package/docs/uk/packages/intlayer/getIntlayerAsync.md

@@ -0,0 +1,141 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: Документація функції getIntlayerAsync | intlayer
+description: Дізнайтеся, як використовувати функцію getIntlayerAsync з пакета intlayer
+keywords:
+  - getIntlayerAsync
+  - dictionary
+  - dynamic import
+  - metadata
+  - bundle optimization
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getIntlayerAsync
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Документація: функція `getIntlayerAsync` в `intlayer`
+
+## Опис
+
+Функція `getIntlayerAsync` вибирає один словник за його ключем і розв'язує його вміст для заданої локалі, **завантажуючи тільки цю локаль**.
+
+Це асинхронний аналог [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/intlayer/getIntlayer.md), призначений для місць, де словник читається поза рендеруванням — маршрути `head` / конструктори метаданих, лодери, серверні функції.
+
+Де `getIntlayer` завантажує об'єднаний словник, що містить кожну локаль, [плагіни збірки](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/bundle_optimization.md) (`@intlayer/babel`, `@intlayer/swc`) переписують цей виклик у `getDictionaryAsync(loaderMap, key, locale)`, спрямовуючи його на фрагменти для кожної локалі в `.intlayer/dynamic_dictionaries/`. Таким чином, пакет ніколи не містить нічого, крім фактично запитаної локалі.
+
+Без цих плагінів — необоптимізована збірка — виклик розв'язується через синхронний реєстр словників: той же вміст, але без поділу по локалях.
+
+**Ключові особливості:**
+
+- Ті самі типізовані ключі, селектори та повернений вміст, що й у `getIntlayer`
+- Завантажує тільки запитаний фрагмент локалі в оптимізованих збірках
+- Одночасні виклики для одного й того ж фрагмента діляться одним завантаженням
+- Безпечна для використання в асинхронних конструкторах метаданих, лодерах та серверних функціях
+
+---
+
+## Function Signature
+
+```typescript
+getIntlayerAsync(
+  key: DictionaryKeys,                        // Обов'язковий
+  localeOrSelector?: LocalesValues | DictionarySelector, // Необов'язковий
+  plugins?: Plugins[]                         // Необов'язковий
+): Promise<DeepTransformContent<...>>
+```
+
+---
+
+## Параметри
+
+- `key: DictionaryKeys`
+  - **Опис**: Ключ словника для читання, як оголошено у ваших файлах вмісту.
+  - **Тип**: `DictionaryKeys` — об'єднання всіх оголошених ключів словника.
+  - **Обов'язково**: Так
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Опис**: Локаль для інтерпретації вмісту або об'єкт селектора для [динамічних словників](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dynamic_dictionaries/index.md).
+    - `'fr'` — локаль
+    - `{ item: 2 }` — елемент [колекції](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dynamic_dictionaries/collections.md) (пропустіть `item`, щоб отримати кожен елемент як масив)
+    - `{ variant: 'black-friday' }` — названий [варіант](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dynamic_dictionaries/variants.md) (пропустіть для `default`)
+    - `{ variant: { id: 'prod_abc', userId: '123' } }` — структурований варіант
+    - Будь-який селектор може містити локаль: `{ item: 2, locale: 'fr' }`
+  - **Тип**: `LocalesValues | DictionarySelector`
+  - **Обов'язково**: Ні (Опціонально) — за замовчуванням використовується налаштована `defaultLocale`.
+
+- `plugins: Plugins[]`
+  - **Опис**: Користувацькі трансформатори вузлів, що замінюють базові плагіни інтерпретатора. Тільки для розширеного використання.
+  - **Тип**: `Plugins[]`
+  - **Обов'язково**: Ні (Опціонально)
+
+### Повертає
+
+- **Тип**: `Promise<Content>` — promise, що розв'язується в інтерпретований вміст словника, типізований на основі вашої декларації.
+
+---
+
+## Приклад використання
+
+### Базове використання
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getIntlayerAsync } from "intlayer";
+
+const { title } = await getIntlayerAsync("app", "fr"); // "Bonjour"
+```
+
+---
+
+## `getIntlayer` vs `getIntlayerAsync`
+
+|                    | [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/intlayer/getIntlayer.md) | `getIntlayerAsync`                                 |
+| ------------------ | --------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
+| Returns            | Вміст                                                                                                           | Promise вмісту                                     |
+| Dictionary loaded  | Об'єднаний словник (усі локалі)                                                                                 | Фрагмент тільки запитаної локалі                   |
+| Best suited for    | Rendering, синхронні кодові шляхи                                                                               | Metadata, loaders, серверні функції                |
+| Requires a plugin? | No                                                                                                              | No — розділення за локалями потребує build plugins |
+
+Обидві функції приймають однакові аргументи та повертають один і той же вміст: перемикання між ними змінює лише **коли** та **скільки** завантажується.
+
+---
+
+## Пов'язані функції
+
+- [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/intlayer/getIntlayer.md): Синхронний еквівалент, який читає об'єднаний словник.
+- [`getDictionaryAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/intlayer/getDictionaryAsync.md): Низькорівнева функція, яку переписують плагіни збірки.
+- [`getLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/intlayer/getLocale.md): Визначає локаль вхідного запиту.
+
+---
+
+## TypeScript
+
+```typescript
+function getIntlayerAsync<
+  const T extends DictionaryKeys,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  key: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): Promise<
+  DeepTransformContent<
+    DictionaryRegistryResult<T, A>,
+    IInterpreterPluginState,
+    ExtractSelectorLocale<A>
+  >
+>;
+```

package/docs/uk/packages/intlayer/getLocalizedPath.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 Функція `getLocalizedPath` перетворює канонічний шлях (внутрішній шлях додатка) у його локалізований еквівалент на основі вказаної локалі та правил переписування. Вона особливо корисна для генерації SEO-дружніх URL-адрес, що відрізняються залежно від мови.
 
+Це відносний аналог [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/intlayer/getLocalizedUrl.md) — для відносного вводу обидва повертають одне й те саме значення. На відміну від `getLocalizedUrl`, він ніколи не повертає абсолютний URL: конфігурація `domains` ігнорується, тому локаль, обслужена з власного домену, все одно повертає шлях. Абсолютний вввід прийнятий, але його походження видаляється — зберігаються лише його шлях, рядок запиту та хеш.
+
 **Ключові можливості:**
 
 - Підтримує динамічні параметри маршруту з використанням синтаксису `[param]`.
@@ -60,13 +62,17 @@ getLocalizedPath(
   - **Тип**: `string`
   - **Обов'язковий**: Так
 
-- `locale: Locales`
-  - **Опис**: Цільова локаль, для якої шлях має бути локалізований.
-  - **Тип**: `Locales`
-  - **Обов'язковий**: Так
-
 ### Необов'язкові параметри
 
+- `locale?: Locales`
+  - **Description**: Цільовий локаль, для якого слід локалізувати шлях.
+  - **Type**: `Locales`
+  - **Default**: Локаль за замовчуванням конфігурації вашого проекту.
+
+- `options?: object`
+  - **Description**: Перевизначення маршрутизації. Кожен запис за замовчуванням використовує конфігурацію вашого проекту.
+  - **Type**: `object`
+
 - `rewriteRules?: RoutingConfig['rewrite']`
   - **Опис**: Об'єкт, що визначає кастомні правила переписування. Якщо не вказано, використовується значення `routing.rewrite` з конфігурації вашого проєкту.
   - **Тип**: `RoutingConfig['rewrite']`
@@ -79,6 +85,28 @@ getLocalizedPath(
 - **Тип**: `string`
 - **Опис**: Локалізований шлях для зазначеної локалі.
 
+Тип звужується на основі правил перезапису, оголошених у вашій конфігурації, тому редактор показує розташовану шляхом, а не звичайний `string`:
+
+```typescript codeFormat="typescript"
+// Конфігурація: режим 'prefix-no-default', defaultLocale 'en',
+//                { '/about': { fr: '/a-propos' }, '/product/[id]': { fr: '/produit/[id]' } }
+const about = getLocalizedPath("/about", Locales.FRENCH);
+//    ^? '/fr/a-propos'
+const product = getLocalizedPath("/product/123", Locales.FRENCH);
+//    ^? '/fr/produit/123'
+const contact = getLocalizedPath("/contact", Locales.FRENCH);
+//    ^? '/fr/contact'  (немає правила переписування, застосовується лише префікс)
+const home = getLocalizedPath("/", Locales.FRENCH);
+//    ^? '/fr'
+```
+
+Те саме звуження поширюється на [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/intlayer/getLocalizedUrl.md), яка застосовує правила переписування перед додаванням префікса локалі.
+
+Два випадки залишаються розширеними до `string`, оскільки вони не можуть бути розв'язані під час компіляції:
+
+- шлях, який не є рядковим літералом (наприклад, побудований зі змінної);
+- шлях, який відповідає правилу з використанням багатосегментного або необов'язкового параметра (`[...slug]`, `[[...slug]]`, `:param?`).
+
 ---
 
 ## Приклад використання
@@ -126,6 +154,18 @@ getLocalizedPath("/contact", Locales.FRENCH, manualRules);
 // Вивід: "/contactez-nous"
 ```
 
+### Пропуск локалі
+
+Коли локаль не вказана, шлях локалізується для налаштованої локалі за замовчуванням:
+
+```typescript codeFormat="typescript"
+import { getLocalizedPath } from "intlayer";
+
+// Конфігурація: defaultLocale = Locales.ENGLISH, { '/about': { en: '/about', fr: '/a-propos' } }
+getLocalizedPath("/about");
+// Результат: "/about"
+```
+
 ---
 
 ## Пов'язані функції

package/docs/uk/packages/intlayer/getTranslation.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 Функція `getTranslationContent` отримує вміст, що відповідає певній локалі, із набору налаштовуваного мовного вмісту. Якщо вказаної локалі не знайдено, вона за замовчуванням повертає вміст для локалі за замовчуванням, налаштованої в проєкті.
 
+Для більш детальної інформації про те, як оголошувати переклади, див. [документацію Translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/translation.md).
+
 ## Параметри
 
 - `languageContent: CustomizableLanguageContent<Content>`

package/docs/uk/packages/next-intlayer/t.md

@@ -165,6 +165,23 @@ const greeting = t(translations);
 
 #### Приклад:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx codeFormat={["typescript", "esm", "commonjs"]}
+import type { FC, ReactNode } from "react";
+import type { Locales } from "intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const Page: FC<{ locale: Locales; children: ReactNode }> = ({
+  locale,
+  children,
+}) => <IntlayerProvider locale={locale}>{children}</IntlayerProvider>;
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx codeFormat={["typescript", "esm", "commonjs"]}
 import type { FC } from "react";
 import type { Locales } from "intlayer";
@@ -180,6 +197,9 @@ const Page: FC<{ locale: Locales }> = ({ locale }) => (
 );
 ```
 
+</Tab>
+</Tabs>
+
 ---
 
 ## Загальні помилки та усунення несправностей
@@ -223,8 +243,6 @@ const text = t(translations);
 
 Для детальнішого опису використання та просунутих можливостей див. документацію [next-intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_visual_editor.md).
 
-///
-
 ---
 
 **Примітка**: Не забудьте правильно налаштувати ваші `IntlayerClientProvider` та `IntlayerServerProvider`, щоб поточна локаль коректно передавалася вашим компонентам. Це критично для того, щоб функція `t` повертала правильні переклади.

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

@@ -79,6 +79,34 @@ author: aymericzip
 
 Ось як ви можете реалізувати хук `useIntlayer` на сторінці Next.js, щоб динамічно завантажувати локалізований контент залежно від поточної локалі застосунку:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
+import { ClientComponentExample } from "@components/ClientComponentExample";
+import { ServerComponentExample } from "@components/ServerComponentExample";
+import { type NextPageIntlayer } from "next-intlayer";
+import { useIntlayer } from "next-intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const HomePage: NextPageIntlayer = async ({ params }) => {
+  const { locale } = await params;
+
+  const content = useIntlayer("homepage", locale);
+
+  return (
+    <IntlayerProvider locale={locale}>
+      <p>{content.introduction}</p>
+      <ClientComponentExample />
+      <ServerComponentExample />
+    </IntlayerProvider>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
 import { ClientComponentExample } from "@components/ClientComponentExample";
 import { ServerComponentExample } from "@components/ServerComponentExample";
@@ -104,6 +132,9 @@ const HomePage: NextPageIntlayer = async ({ params }) => {
 };
 ```
 
+ </Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ClientComponentExample.tsx" codeFormat={["typescript", "esm"]}
 "use-client";
 

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

@@ -30,8 +30,6 @@ Hook `useDictionary` дозволяє обробляти об'єкт, який
 
 ## Інтеграція на сервері
 
-Якщо ви використовуєте хук `useDictionary` поза межами `IntlayerProvider`, локаль має бути явно передана як параметр під час рендерингу компонента:
-
 ```tsx fileName="./ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useDictionary } from "react-intlayer/server";

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

@@ -77,6 +77,34 @@ author: aymericzip
 
 Приклади використання хуку `useI18n` у React-компонентах:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { ClientComponentExample, ServerComponentExample } from "@components";
+import { IntlayerProvider } from "react-intlayer";
+import { useI18n } from "react-intlayer/server";
+import { Locales } from "intlayer";
+
+const App: FC<{ locale: Locales }> = ({ locale }) => {
+  const t = useI18n("home-page", locale);
+
+  return (
+    <>
+      <p>{t("introduction")}</p>
+      <IntlayerProvider locale={locale}>
+        <ClientComponentExample />
+      </IntlayerProvider>
+      <ServerComponentExample />
+    </>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { ClientComponentExample, ServerComponentExample } from "@components";
@@ -101,6 +129,9 @@ const App: FC<{ locale: Locales }> = ({ locale }) => {
 };
 ```
 
+</Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useI18n } from "react-intlayer";

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

@@ -31,48 +31,6 @@ author: aymericzip
 
 ## Приклад використання в React
 
-Приклад використання хука `useIntlayer` у React-компоненті:
-
-```tsx fileName="src/app.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { ClientComponentExample, ServerComponentExample } from "@components";
-import { IntlayerProvider } from "react-intlayer";
-import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
-import { Locales } from "intlayer";
-
-const App: FC<{ locale: Locales }> = ({ locale }) => {
-  const content = useIntlayer("homepage", locale);
-
-  return (
-    <>
-      <p>{content.introduction}</p>
-      <IntlayerProvider locale={locale}>
-        <ClientComponentExample />
-      </IntlayerProvider>
-      <IntlayerServerProvider locale={locale}>
-        <ServerComponentExample />
-      </IntlayerServerProvider>
-    </>
-  );
-};
-```
-
-```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const ComponentExample: FC = () => {
-  const content = useIntlayer("component-example");
-
-  return (
-    <div>
-      <h1>{content.title}</h1>
-      <p>{content.description}</p>
-    </div>
-  );
-};
-```
-
 ```tsx fileName="src/components/ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import { useIntlayer } from "react-intlayer/server";
 

package/docs/uk/packages/vite-intlayer/intlayerMinify.md

@@ -56,7 +56,7 @@ export default defineConfig({
 2. `build.optimize` має значення `true` (або `undefined`, що за замовчуванням дорівнює `true` для збірок).
 3. `build.minify` має значення `true` у вашій конфігурації Intlayer.
 
-Він автоматично **вимикається**, коли `editor.enabled` має значення `true`, оскільки редактору потрібен повний, зрозумілий людині вміст словників.
+Коли `editor.enabled` становить `true`, плагін продовжує працювати, але **пропускає перейменування полів**: перейменування переписує ключі контенту, якими проходить інтерпретатор, тому `keyPath`, який отримує візуальний редактор, більше не відповідатиме необ'єднаним словникам, які він редагує. Стиснення пробілів та видалення метаданих верхнього рівня залишаються активними.
 
 ## Що мінімізується
 

package/docs/uk/packages/vite-intlayer/intlayerPrune.md

@@ -28,6 +28,8 @@ author: aymericzip
 
 Плагін Vite `intlayerPrune` використовується для виконання tree-shaking та видалення невикористаних словників з бандла вашого застосунку. Це допомагає зменшити фінальний розмір бандла, включаючи лише необхідний багатомовний вміст.
 
+> Плагін вже включений та налаштований автоматично, коли ви використовуєте [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/vite-intlayer/intlayer.md). Вам потрібно зареєструвати його вручну лише в тому випадку, якщо ви самостійно складаєте стек плагінів.
+
 ## Використання
 
 ### У складі `intlayer()` (рекомендовано)
@@ -115,4 +117,4 @@ const { title, description } = useIntlayer("myDict");
 2. `build.optimize` має значення `true` (або `undefined`, що за замовчуванням дорівнює `true` для збірок).
 3. `build.purge` має значення `true` у вашій конфігурації Intlayer.
 
-Він автоматично **вимикається**, коли `editor.enabled` має значення `true`, оскільки редактору потрібна повна змістова частина словника.
+Він залишається активним, коли `editor.enabled` становить `true`: візуальний редактор визначає кожну правку через `dictionaryKey` + `keyPath` відносно необ'єднаних словників, яких цей плагін ніколи не торкається, а очищене поле — це поле, яке не читає жоден компонент, тому воно ніколи не відображається і не може бути вибраним на сторінці.