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

package/docs/uk/compat/nuxtjs-i18n.md

@@ -0,0 +1,46 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Міграція з NuxtJS I18n на Intlayer"
+description: "Дізнайтеся, як перенести вашу програму Nuxt.js з @nuxtjs/i18n на Intlayer за допомогою адаптера compat."
+keywords:
+  - nuxtjs-i18n
+  - nuxt
+  - vue
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - nuxtjs-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Перехід з NuxtJS I18n на Intlayer
+
+Перехід вашої Nuxt-програми з `@nuxtjs/i18n` на Intlayer є безперебійним процесом за допомогою модуля адаптера Nuxt.
+
+## Що робити
+
+Щоб ініціалізувати проект, запустіть:
+
+```bash
+npx intlayer init
+```
+
+Це налаштує `intlayer.config.ts`. Потім додайте модуль Intlayer Nuxt (наприклад `@intlayer/nuxt-i18n`) у масив modules вашого `nuxt.config.ts`. Це автоматично застосує конфігурацію сумісності для вашої програми.
+
+## Що він робить під капотом
+
+`@nuxtjs/i18n` обгортає `vue-i18n`, надаючи Nuxt-специфічні routing composables (`useLocalePath`, `useSwitchLocalePath`, `<NuxtLinkLocale>`).
+
+Під капотом:
+
+- **Translations:** Покладається нативно на `@intlayer/vue-i18n` compat layer для всіх завдань трансляції рядків (повністю підтримуючи формати `vue-i18n`, pipe plurals та reactivity).
+- **Routing:** Відзеркалює routing composables, використовуючи Intlayer's localized URL helpers.
+- **Configuration:** Читає `availableLocales` та параметри за замовчуванням прямо з вашого `intlayer.config.ts` для автоматичної координації сторінок Nuxt.

package/docs/uk/compat/polyglot.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Міграція з Polyglot.js на Intlayer"
+description: "Дізнайтеся, як перейти з Polyglot.js на Intlayer, використовуючи адаптер сумісності."
+keywords:
+  - polyglot
+  - airbnb
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - polyglot
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Міграція з Polyglot.js на Intlayer
+
+Якщо ви використовуєте Polyglot.js від Airbnb, міграція на Intlayer є надзвичайно простою за допомогою рівня сумісності.
+
+## Що робити
+
+Просто запустіть команду ініціалізації у вашому проекті:
+
+```bash
+npx intlayer init
+```
+
+Це генерує `intlayer.config.ts`. Потім ви можете використовувати alias bundler plugin для прозорого перенаправлення Polyglot imports на `@intlayer/polyglot`.
+
+## Що робиться під капотом
+
+Синтаксис Polyglot.js зазвичай спирається на `polyglot.t('key', {name})` з інтерполяціями `%{name}` та множинами `smart_count`, розділеними на `"singular |||| plural"`.
+
+Під капотом:
+
+- **Interpolation:** Рівень сумісності обробляє заповнювачі `%{var}` нативно.
+- **Plurals:** Рядок розділяється на `||||` і оцінюється проти нативного `Intl.PluralRules` відповідно до активної локалі, дзеркалюючи власний порядок buckets Polyglot за локаллю.
+- **Dictionaries:** Ви обходите потребу надавати великі конфігурації JSON до `new Polyglot()` – Intlayer обробляє словники динамічно та обрізує їх автоматично.

package/docs/uk/compat/react-i18next.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Міграція з react-i18next на Intlayer"
+description: "Дізнайтесь, як мігрувати свій React додаток з react-i18next на Intlayer за допомогою адаптера сумісності."
+keywords:
+  - react-i18next
+  - i18next
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Міграція з react-i18next на Intlayer
+
+Для повного та детального покрокового посібника дивіться наш повний [Посібник міграції з react-i18next](../migration_from_react-i18next_to_intlayer.md).
+
+Використання адаптера сумісності Intlayer дозволяє вам перейти з `react-i18next` без будь-яких змін у імпортах вихідного коду.
+
+## Що робити
+
+Щоб ініціалізувати проект, виконайте:
+
+```bash
+npx intlayer init
+```
+
+Під час ініціалізації Intlayer встановить `@intlayer/react-i18next` і створить `intlayer.config.ts`. У вашому bundler (наприклад, Vite) застосуйте плагін Intlayer:
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import { reactI18nextVitePlugin } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactI18nextVitePlugin()],
+});
+```
+
+## Що воно робить під капотом
+
+`reactI18nextVitePlugin` обгортає основний плагін `vite-intlayer` і вводить alias'и розділення для `react-i18next` та `i18next`, перенаправляючи їх на `@intlayer/react-i18next` та `@intlayer/i18next`.
+
+Під капотом:
+
+- **`useTranslation` & `withTranslation`:** Переписано для використання нативних хуків Intlayer, що дає вам автоматичне завершення TypeScript для ключів вашого словника. Безпроблемно підтримує простори імен (наприклад `t('namespace:key')`).
+- **Множини & Контекст:** Обробляє pluralization на основі суфіксів в i18next (`key_one`, `key_other`) з використанням нативного `Intl.PluralRules` та суфіксів контексту (`key_male`).
+- **`<Trans>` Компонент:** Перереалізований для підтримки пропса `components`, форм об'єкта та масиву, а також нумерованих тегів `<1>...</1>` з прямим відображенням на ваші React-вузли.
+- **`i18n` екземпляр:** Розв'язує ключі безпосередньо з Intlayer без завантаження великих JSON-файлів, що призводить до значно менших розмірів bundle.

package/docs/uk/compat/react-intl.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Міграція з React Intl на Intlayer"
+description: "Дізнайтеся, як перенести вашу React-додаток з react-intl на Intlayer, використовуючи адаптер сумісності."
+keywords:
+  - react-intl
+  - formatjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Перехід від React Intl до Intlayer
+
+Якщо ваш React додаток використовує `react-intl` (FormatJS), перехід на Intlayer — це просто. Наш compat layer безпроблемно обробляє ICU MessageFormat та всі існуючі компоненти `Formatted*`.
+
+## Що робити
+
+Почніть із запуску команди ініціалізації у вашому проекті:
+
+```bash
+npx intlayer init
+```
+
+Потім налаштуйте плагін Intlayer Vite або Next.js у вашій конфігурації. Цей плагін вводить alias'и часу збірки для перенаправлення імпортів `react-intl` на `@intlayer/react-intl`.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import reactIntlVitePlugin from "@intlayer/react-intl/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactIntlVitePlugin()],
+});
+```
+
+## Що він робить під капотом
+
+Плагін bundler створює alias `react-intl` на `@intlayer/react-intl`. Замість ручного парсингу великих JSON файлів та обгортання вашого додатку в `IntlProvider`, плагін Intlayer статично витягує ключі та використовує словники Intlayer під час виконання.
+
+Під капотом:
+
+- **ICU MessageFormat:** Intlayer використовує resolver `resolveMessage(..., 'icu')` який повністю підтримує ICU множину, вибір, форматування дати/числа та теги багатого тексту нативно.
+- **Методи та JSX callers:** `intl.formatMessage({ id: 'a.b' })` та `<FormattedMessage id="a.b">` ідентифікуються плагінами компілятора Intlayer (`@intlayer/babel` / `@intlayer/swc`), конвертуючи плоскі ключі з крапками так, щоб перший сегмент коректно розв'язувався на ключ словника Intlayer.
+- **Форматери:** `<FormattedNumber>`, `<FormattedDate>` тощо мостять до нативних `core/formatters` використовуючи `Intl`.

package/docs/uk/compat/svelte-i18n.md

@@ -0,0 +1,47 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Міграція з Svelte I18n на Intlayer"
+description: "Дізнайтеся, як мігрувати вашу Svelte-програму з svelte-i18n на Intlayer за допомогою адаптера сумісності."
+keywords:
+  - svelte-i18n
+  - svelte
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - svelte-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Міграція з Svelte I18n на Intlayer
+
+Перенесення вашого Svelte додатку з `svelte-i18n` на Intlayer займає всього кілька хвилин за допомогою адаптера сумісності.
+
+## Що робити
+
+Просто запустіть команду ініціалізації в вашому проекті:
+
+```bash
+npx intlayer init
+```
+
+Це генерує `intlayer.config.ts`. Переконайтеся, що ваші плагіни SvelteKit / Vite обгорнуті плагіном alias від Intlayer, щоб безперебійно відобразити `svelte-i18n` на `@intlayer/svelte-i18n`.
+
+## Як це працює під капотом
+
+Svelte-i18n покладається на широко використовувані store (`$_`, `$t`, `$format` тощо) та ICU MessageFormat.
+
+Під капотом:
+
+- **Store:** Intlayer проксує store `svelte-i18n`. `$_` стає derived store поточної локалі, яка повертає Intlayer resolver.
+- **Ключі:** Ваші плоскі ключі (наприклад, `$_('home.title')`) обчислюються так, що перший сегмент шляху представляє словник Intlayer.
+- **ICU Syntax:** Повністю обробляється спільним ICU resolver (аналіз еквівалента `intl-messageformat`).
+- **Форматери:** Виклики `$date`, `$time`, `$number` безпечно перенаправляються на вбудовані форматери Intlayer.
+- **Babel/SWC Analysis:** Аналізатор Intlayer читає виклики Svelte store (`$_`) всередині ваших файлів `.svelte` перед компіляцією, щоб автоматично побудувати відповідні фрагменти словника.

package/docs/uk/compat/transloco.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Мігрувати з Transloco на Intlayer"
+description: "Дізнайтеся, як мігрувати свій Angular додаток з Transloco на Intlayer за допомогою compat адаптера."
+keywords:
+  - transloco
+  - angular
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - transloco
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Міграція з Transloco на Intlayer
+
+Якщо ваш Angular додаток наразі використовує `@jsverse/transloco`, ви можете перенести його на Intlayer, використовуючи наш адаптер сумісності. Цей перехід дозволяє вам зберегти існуючий синтаксис шаблонів, одночасно використовуючи потужну структуру словників Intlayer.
+
+## Що робити
+
+Просто запустіть команду ініціалізації у вашому проекті:
+
+```bash
+npx intlayer init
+```
+
+Це створить необхідний конфігураційний файл `intlayer.config.ts`. Далі ви замінюєте свої імпорти Transloco на модулі `@intlayer/transloco` або покладаєтесь на build aliases.
+
+## Що він робить під капотом
+
+Transloco використовує scopes та `TranslocoService` (`translate`, `selectTranslate`), поряд зі structural directives (`*transloco="let t"`) та pipes (`| transloco`).
+
+Під капотом:
+
+- **Scopes:** Природно відображаються на ключі словників Intlayer, забезпечуючи чудову історію pruning для оптимізації bundle.
+- **Service & Directives:** Angular adapter Intlayer безпроблемно замінює providers, дозволяючи вашим існуючим template pipes та directives розв'язувати рядки від словників Intlayer.
+- **Build time parsing:** TypeScript analyzer розпізнає виклики `instant/get` та fallback pruning забезпечує коректність навіть коли використання template не можна статично відстежити.

package/docs/uk/compat/vue-i18n.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Міграція з Vue I18n на Intlayer"
+description: "Дізнайтеся, як мігрувати вашу Vue-програму з vue-i18n на Intlayer, використовуючи адаптер сумісності."
+keywords:
+  - vue-i18n
+  - vue
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - vue-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Міграція з Vue I18n на Intlayer
+
+Якщо ваш Vue додаток наразі використовує `vue-i18n`, ви можете мігрувати на Intlayer без перепису компонентів або трансляції хуків. Intlayer надає адаптер сумісності, який ідеально віддзеркалює API `vue-i18n` під час використання потужних функцій Intlayer під капотом.
+
+## Що робити
+
+Щоб почати роботу, просто запустіть команду ініціалізації у вашому проєкті:
+
+```bash
+npx intlayer init
+```
+
+Під час ініціалізації Intlayer налаштує ваш файл конфігурації (`intlayer.config.ts`) і підготує ваш проєкт до міграції. Вам потрібно буде додати плагін Intlayer до конфігурації Vite, щоб автоматично створити псевдоніми для імпортів `vue-i18n`.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vue(), vueI18nVitePlugin()],
+});
+```
+
+## Що це робить під капотом
+
+`vueI18nVitePlugin` впроваджує псевдонім модуля в ваш bundler. Будь-який імпорт `vue-i18n` у вашій кодовій базі буде прозоро перенаправлений на `@intlayer/vue-i18n`.
+
+**Під капотом адаптер обробляє складний синтаксис `vue-i18n` нативно:**
+
+- **Інтерполяція та множина:** Розв'язує `{name}` та списковану `{0}` інтерполяцію. Pipe множини (`"car | cars"`) конвертуються у вузли перерахування/множини Intlayer на основі позиційної семантики.
+- **Формати:** Функції як `d()` та `n()` обгортають `Intl` під капотом, дотримуючись `datetimeFormats` та `numberFormats`, визначених у ваших опціях.
+- **Глобальний та локальний стан:** `global.locale` відображається на `WritableComputedRef`, підкріплений Intlayer client, тому реактивність працює саме так як очікується (напр. `locale.value = 'fr'`).
+- **Директиви:** Директива `v-t` реєструється та функціонує нормально.
+
+Ваша програма продовжує рендеритися точно так само, як раніше, але вміст забезпечується вашими словниками Intlayer, надаючи вам типобезпеку, кращу оптимізацію bundle та безперебійну інтеграцію CMS.

package/docs/uk/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-03-12
+updatedAt: 2026-06-23
 title: Intlayer Compiler | Автоматизоване витягування контенту для i18n
 description: Автоматизуйте процес інтернаціоналізації за допомогою Intlayer Compiler. Витягуйте контент безпосередньо з ваших компонентів для швидшого та ефективнішого i18n у Vite, Next.js та інших.
 keywords:
@@ -60,6 +60,8 @@ author: aymericzip
 
 ## Використання
 
+> The quickest way to wire the compiler in is the interactive setup: run `npx intlayer init --interactive` and select **Compiler**. On Vite there is nothing to configure — the compiler is plugged in directly through the `intlayerCompiler()` plugin. On Next.js the command scaffolds the `babel.config.js` shown below. The non-interactive `intlayer init` leaves the compiler setup untouched.
+
 <Tabs>
  <Tab value='vite'>
 

package/docs/uk/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-17
+updatedAt: 2026-06-23
 title: Конфігурація
 description: Дізнайтеся, як налаштувати Intlayer для вашого додатка. Зрозумійте різні налаштування та параметри, доступні для адаптації Intlayer під ваші потреби.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-06-24
+    changes: "Add `enableProxy` option to the routing configuration"
   - version: 8.10.0
     date: 2026-06-17
     changes: "Додано опцію `format` до конфігурації словника"
@@ -882,6 +885,21 @@ export default config;
 
 ---
 
+### Конфігурація системи
+
+Параметри, пов'язані з внутрішніми шляхами та результатами виведення Intlayer. Ці параметри зазвичай є внутрішніми і не повинні потребувати змін користувачем.
+
+| Field                     | Description                                                                            | Type     | Default                           | Example              | Note                                                        |
+| ------------------------- | -------------------------------------------------------------------------------------- | -------- | --------------------------------- | -------------------- | ----------------------------------------------------------- |
+| `baseDir`                 | Базова директорія проекту.                                                             | `string` | `process.cwd()`                   | `'/path/to/project'` | Використовується для розпізнавання всіх каталогів Intlayer. |
+| `dictionariesDir`         | Шлях директорії для зберігання словників локалізації.                                  | `string` | `'.intlayer/dictionary'`          |                      |                                                             |
+| `moduleAugmentationDir`   | Директорія для розширення модулю, що дозволяє краще пропозиції IDE та перевірку типів. | `string` | `'.intlayer/types'`               | `'intlayer-types'`   | Переконайтеся, що це включено в `tsconfig.json`.            |
+| `unmergedDictionariesDir` | Директорія для зберігання об'єднаних словників.                                        | `string` | `'.intlayer/unmerged_dictionary'` |                      |                                                             |
+| `typesDir`                | Директорія для зберігання типів словників.                                             | `string` | `'.intlayer/types'`               |                      |                                                             |
+| `mainDir`                 | Директорія, де зберігаються основні файли додатку.                                     | `string` | `'.intlayer/main'`                |                      |                                                             |
+| `configDir`               | Директорія, де зберігаються файли конфігурації.                                        | `string` | `'.intlayer/config'`              |                      |                                                             |
+| `cacheDir`                | Директорія, де зберігаються файли кешу.                                                | `string` | `'.intlayer/cache'`               |                      |                                                             |
+
 ### Конфігурація словника (Dictionary)
 
 Параметри для контролю операцій зі словниками, включаючи поведінку автоматичного заповнення та генерацію контенту.
@@ -990,22 +1008,6 @@ Intlayer підтримує широкий спектр провайдерів A
 
 ---
 
-### Системна конфігурація (System)
-
-Ці налаштування призначені для просунутих користувачів та внутрішньої конфігурації Intlayer.
-
-| Поле                      | Опис                                              | Тип      | За замовчуванням                  | Приклад | Примітки |
-| ------------------------- | ------------------------------------------------- | -------- | --------------------------------- | ------- | -------- |
-| `dictionariesDir`         | Директорія для скомпільованих словників.          | `string` | `'.intlayer/dictionary'`          |         |          |
-| `moduleAugmentationDir`   | Директорія для module augmentation TypeScript.    | `string` | `'.intlayer/types'`               |         |          |
-| `unmergedDictionariesDir` | Директорія для незлитих словників.                | `string` | `'.intlayer/unmerged_dictionary'` |         |          |
-| `typesDir`                | Директорія для згенерованих типів.                | `string` | `'.intlayer/types'`               |         |          |
-| `mainDir`                 | Директорія основних файлів Intlayer.              | `string` | `'.intlayer/main'`                |         |          |
-| `configDir`               | Директорія скомпільованих конфігураційних файлів. | `string` | `'.intlayer/config'`              |         |          |
-| `cacheDir`                | Директорія кеш-файлів.                            | `string` | `'.intlayer/cache'`               |         |          |
-
----
-
 ### Конфігурація компілятора (Compiler)
 
 Керує налаштуваннями компілятора Intlayer, який збирає словники безпосередньо з ваших компонентів.

package/docs/uk/custom_domains.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-02
-updatedAt: 2026-04-02
+updatedAt: 2026-06-23
 title: Власні домени
 description: Дізнайтеся, як налаштувати маршрутизацію локалей на основі доменів в Intlayer для обслуговування різних локалей з виділених імен хостів.
 keywords:

package/docs/uk/custom_url_rewrites.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-01-26
+updatedAt: 2026-06-23
 title: Користувацькі правила переписування URL
 description: Дізнайтеся, як налаштувати та використовувати користувацькі правила переписування URL в Intlayer для визначення шляхів, специфічних для локалі.
 keywords:

package/docs/uk/dictionary/content_file.md

@@ -612,13 +612,6 @@ JSON-схема, що використовується для валідації
 
 Вказує, чи словник був автоматично заповнений з зовнішніх джерел. У разі конфліктів базові словники матимуть пріоритет над автоматично заповненими словниками.
 
-##### `location` ('distant' | 'locale')
-
-Вказує місцезнаходження словника:
-
-- `'locale'`: Локальний словник (з файлів контенту)
-- `'distant'`: Віддалений словник (із зовнішнього джерела)
-
 ## Типи вузлів контенту
 
 Intlayer надає кілька спеціалізованих типів вузлів вмісту, які розширюють базові примітивні значення: