@intlayer/docs 9.4.1 → 9.4.3

package/docs/uk/bundle_optimization.md

@@ -43,139 +43,6 @@ author: aymericzip
 
 <TOC />
 
-## Проаналізуйте свій бандл
-
-Аналіз бандлу — це перший крок до виявлення "важких" JSON-файлів та пошуку можливостей для розділення коду (code-splitting). Відповідні інструменти генерують візуальну деревоподібну мапу (treemap) зібраного коду вашої програми, дозволяючи точно побачити, які бібліотеки займають найбільше місця.
-
-<Tabs>
- <Tab value="vite">
-
-### Vite / Rollup
-
-Vite під капотом використовує Rollup. Плагін `rollup-plugin-visualizer` створює інтерактивний HTML-файл, що відображає розмір кожного модуля у вашому графі.
-
-```bash
-npm install -D rollup-plugin-visualizer
-```
-
-```typescript fileName="vite.config.ts"
-import { defineConfig } from "vite";
-import { visualizer } from "rollup-plugin-visualizer";
-
-export default defineConfig({
-  plugins: [
-    visualizer({
-      open: true, // Автоматично відкрити звіт у браузері
-      filename: "stats.html",
-      gzipSize: true,
-      brotliSize: true,
-    }),
-  ],
-});
-```
-
- </Tab>
- <Tab value="nextjs (turbopack)">
-
-### Next.js (Turbopack)
-
-Для проєктів, що використовують App Router та Turbopack, Next.js надає вбудований експериментальний аналізатор, який не потребує додаткових залежностей.
-
-```bash packageManager='npm'
-npx next experimental-analyze
-```
-
-```bash packageManager='yarn'
-yarn next experimental-analyze
-```
-
-```bash packageManager='pnpm'
-pnpm next experimental-analyze
-```
-
-```bash packageManager='bun'
-bun next experimental-analyze
-```
-
- </Tab>
- <Tab value="nextjs (Webpack)">
-
-### Next.js (Webpack)
-
-Якщо в Next.js ви користуєтеся стандартним Webpack, застосуйте офіційний bundle analyzer. Викличте його, встановивши змінну середовища (environment variable) під час збірки.
-
-```bash packageManager='npm'
-npm install -D @next/bundle-analyzer
-```
-
-```bash packageManager='yarn'
-yarn add -D @next/bundle-analyzer
-```
-
-```bash packageManager='pnpm'
-pnpm add -D @next/bundle-analyzer
-```
-
-```bash packageManager='bun'
-bun add -d @next/bundle-analyzer
-```
-
-```javascript fileName="next.config.js"
-const withBundleAnalyzer = require("@next/bundle-analyzer")({
-  enabled: process.env.ANALYZE === "true",
-});
-
-module.exports = withBundleAnalyzer({
-  // Ваш конфіг Next.js
-});
-```
-
-**Використання:**
-
-```bash
-ANALYZE=true npm run build
-```
-
- </Tab>
- <Tab value="Webpack (CRA / Angular / etc)">
-
-### Стандартний Webpack
-
-Для Create React App (ejected), Angular або кастомних налаштувань Webpack скористайтеся галузевим стандартом `webpack-bundle-analyzer`.
-
-```bash packageManager='npm'
-npm install -D webpack-bundle-analyzer
-```
-
-```bash packageManager='yarn'
-yarn add -D webpack-bundle-analyzer
-```
-
-```bash packageManager='pnpm'
-pnpm add -D webpack-bundle-analyzer
-```
-
-```bash packageManager='bun'
-bun add -d webpack-bundle-analyzer
-```
-
-```typescript fileName="webpack.config.ts"
-import { BundleAnalyzerPlugin } from "webpack-bundle-analyzer";
-
-export default {
-  plugins: [
-    new BundleAnalyzerPlugin({
-      analyzerMode: "static",
-      reportFilename: "bundle-analyzer.html",
-      openAnalyzer: false,
-    }),
-  ],
-};
-```
-
- </Tab>
-</Tabs>
-
 ## Як це працює
 
 Intlayer використовує **підхід на рівні компонентів (per-component approach)**. На відміну від глобальних JSON-файлів, ваш контент визначається поруч із вашими компонентами або всередині них. Під час збірки Intlayer:
@@ -189,59 +56,6 @@ Intlayer використовує **підхід на рівні компоне
 - Якщо компонент не імпортується, його контент не включатиметься до бандлу (Dead Code Elimination).
 - Якщо компонент завантажується ліниво (lazy-loaded), його контент також буде завантажено ліниво.
 
-## Довідка щодо плагінів
-
-Оптимізація збірки від Intlayer розділена на кілька окремих плагінів, кожен з яких виконує лише одну задачу. Розуміння того, за що відповідає кожен із них, запобігає плутанині під час конфігурації.
-
-### Плагіни Babel (`@intlayer/babel`)
-
-Ці плагіни використовуються безпосередньо в `babel.config.js` для налаштувань на базі Webpack (Next.js із Babel, CRA, кастомний Webpack тощо).
-
-Таблиця нижче перелічує їх у потрібному порядку конвеєра (у тому самому порядку, в якому вони мають бути в `babel.config.js`):
-
-| Плагін                        | Що він робить                                                                                                                      |
-| :---------------------------- | :--------------------------------------------------------------------------------------------------------------------------------- |
-| `intlayerExtractBabelPlugin`  | Сканує файли `.content.ts` та записує зібрані словники до папки `.intlayer/`                                                       |
-| `intlayerPurgeBabelPlugin`    | Сканує всі файли з кодом та видаляє **невикористані поля контенту** зі скомпільованих словників `.intlayer/**/*.json`              |
-| `intlayerMinifyBabelPlugin`   | **Перейменовує ключі полів контенту** на короткі алфавітні псевдоніми (наприклад, `title` → `a`) у JSON-файлах та у вихідному коді |
-| `intlayerOptimizeBabelPlugin` | Переписує `useIntlayer('key')` на `useDictionary(hash)` та інжектить (вставляє) відповідний `import` словника                      |
-
-> **Порядок плагінів має значення.** У файлі `babel.config.js` плагіни `purge` та `minify` мають з'являтися **перед** плагіном `optimize`. Оскільки `optimize` замінює `useIntlayer('key')` на непрозорий (opaque) виклик `useDictionary(hash)`, він стирає інформацію про ключ словника. Але саме ця інформація потрібна на етапах `purge` та `minify`, щоб розпізнати, які поля контенту використовуються.
-
-Кожен плагін Babel має відповідного помічника налаштувань (options helper), який зчитує `intlayer.config.ts` лише раз під час завантаження конфігурації та повертає підготовані значення:
-
-| Options helper               | З яким плагіном використовується |
-| :--------------------------- | :------------------------------- |
-| `getExtractPluginOptions()`  | `intlayerExtractBabelPlugin`     |
-| `getPurgePluginOptions()`    | `intlayerPurgeBabelPlugin`       |
-| `getMinifyPluginOptions()`   | `intlayerMinifyBabelPlugin`      |
-| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin`    |
-
-### Плагіни Vite (`vite-intlayer`)
-
-Користувачі Vite **ніколи не конфігурують їх напряму**. Вони налаштовуються автоматично після виклику `withIntlayer()` у файлі `vite.config.ts`. Прапорці `build.purge` та `build.minify` в `intlayer.config.ts` вмикають та вимикають відповідну поведінку без необхідності вручну реєструвати додаткові плагіни.
-
-| Внутрішній плагін Vite | Еквівалентна поведінка                                                                                             |
-| :--------------------- | :----------------------------------------------------------------------------------------------------------------- |
-| Usage analyzer         | Аналогічно до етапу аналізу плагіна `intlayerPurgeBabelPlugin`                                                     |
-| Dictionary prune       | Аналогічно до етапу запису JSON плагіна `intlayerPurgeBabelPlugin`                                                 |
-| Dictionary minify      | Аналогічно до етапу запису JSON плагіна `intlayerMinifyBabelPlugin`                                                |
-| Babel transform        | Аналогічно до перейменування у вихідному коді плагіном `intlayerMinifyBabelPlugin` + `intlayerOptimizeBabelPlugin` |
-
-### Плагін SWC (`@intlayer/swc`)
-
-Користувачі Next.js **також ніколи не налаштовують це напряму**. Починаючи з **v9.2.1**, `withIntlayer()` у `next.config.ts` виконує весь конвеєр — purge, мініфікацію та переписування імпортів — спираючись лише на прапорці `build.purge` і `build.minify`.
-
-Роботу поділено на дві частини, бо Wasm-плагін SWC перетворює по одному файлу за раз і не має доступу до файлової системи:
-
-| Прохід                                                | Де виконується                   | Що робить                                                                                            |
-| :---------------------------------------------------- | :------------------------------- | :--------------------------------------------------------------------------------------------------- |
-| Аналіз використання + purge/мініфікація JSON          | Node, усередині `withIntlayer()` | Читає кожен вихідний файл компонента, переписує `.intlayer/**/*.json`, формує таблиці перейменування |
-| Переписування вихідного коду (`content.title` → `.a`) | `@intlayer/swc` (Wasm)           | Застосовує таблиці перейменування до відповідних звернень до властивостей у вашому коді              |
-| Переписування імпортів (`useIntlayer` → dict)         | `@intlayer/swc` (Wasm)           | Те саме, що `intlayerOptimizeBabelPlugin`                                                            |
-
-Визначення того, _які_ поля не використовуються і _який_ псевдонім отримає кожне з них, потребує стану між файлами та файлового вводу-виводу, тож ця половина виконується в Node; плагін SWC отримує лише готові таблиці.
-
 ## Налаштування за платформами
 
 <Tabs>
@@ -405,6 +219,59 @@ module.exports = {
  </Tab>
 </Tabs>
 
+## Довідка щодо плагінів
+
+Оптимізація збірки від Intlayer розділена на кілька окремих плагінів, кожен з яких виконує лише одну задачу. Розуміння того, за що відповідає кожен із них, запобігає плутанині під час конфігурації.
+
+### Плагіни Babel (`@intlayer/babel`)
+
+Ці плагіни використовуються безпосередньо в `babel.config.js` для налаштувань на базі Webpack (Next.js із Babel, CRA, кастомний Webpack тощо).
+
+Таблиця нижче перелічує їх у потрібному порядку конвеєра (у тому самому порядку, в якому вони мають бути в `babel.config.js`):
+
+| Плагін                        | Що він робить                                                                                                                      |
+| :---------------------------- | :--------------------------------------------------------------------------------------------------------------------------------- |
+| `intlayerExtractBabelPlugin`  | Сканує файли `.content.ts` та записує зібрані словники до папки `.intlayer/`                                                       |
+| `intlayerPurgeBabelPlugin`    | Сканує всі файли з кодом та видаляє **невикористані поля контенту** зі скомпільованих словників `.intlayer/**/*.json`              |
+| `intlayerMinifyBabelPlugin`   | **Перейменовує ключі полів контенту** на короткі алфавітні псевдоніми (наприклад, `title` → `a`) у JSON-файлах та у вихідному коді |
+| `intlayerOptimizeBabelPlugin` | Переписує `useIntlayer('key')` на `useDictionary(hash)` та інжектить (вставляє) відповідний `import` словника                      |
+
+> **Порядок плагінів має значення.** У файлі `babel.config.js` плагіни `purge` та `minify` мають з'являтися **перед** плагіном `optimize`. Оскільки `optimize` замінює `useIntlayer('key')` на непрозорий (opaque) виклик `useDictionary(hash)`, він стирає інформацію про ключ словника. Але саме ця інформація потрібна на етапах `purge` та `minify`, щоб розпізнати, які поля контенту використовуються.
+
+Кожен плагін Babel має відповідного помічника налаштувань (options helper), який зчитує `intlayer.config.ts` лише раз під час завантаження конфігурації та повертає підготовані значення:
+
+| Options helper               | З яким плагіном використовується |
+| :--------------------------- | :------------------------------- |
+| `getExtractPluginOptions()`  | `intlayerExtractBabelPlugin`     |
+| `getPurgePluginOptions()`    | `intlayerPurgeBabelPlugin`       |
+| `getMinifyPluginOptions()`   | `intlayerMinifyBabelPlugin`      |
+| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin`    |
+
+### Плагіни Vite (`vite-intlayer`)
+
+Користувачі Vite **ніколи не конфігурують їх напряму**. Вони налаштовуються автоматично після виклику `withIntlayer()` у файлі `vite.config.ts`. Прапорці `build.purge` та `build.minify` в `intlayer.config.ts` вмикають та вимикають відповідну поведінку без необхідності вручну реєструвати додаткові плагіни.
+
+| Внутрішній плагін Vite | Еквівалентна поведінка                                                                                             |
+| :--------------------- | :----------------------------------------------------------------------------------------------------------------- |
+| Usage analyzer         | Аналогічно до етапу аналізу плагіна `intlayerPurgeBabelPlugin`                                                     |
+| Dictionary prune       | Аналогічно до етапу запису JSON плагіна `intlayerPurgeBabelPlugin`                                                 |
+| Dictionary minify      | Аналогічно до етапу запису JSON плагіна `intlayerMinifyBabelPlugin`                                                |
+| Babel transform        | Аналогічно до перейменування у вихідному коді плагіном `intlayerMinifyBabelPlugin` + `intlayerOptimizeBabelPlugin` |
+
+### Плагін SWC (`@intlayer/swc`)
+
+Користувачі Next.js **також ніколи не налаштовують це напряму**. Починаючи з **v9.2.1**, `withIntlayer()` у `next.config.ts` виконує весь конвеєр — purge, мініфікацію та переписування імпортів — спираючись лише на прапорці `build.purge` і `build.minify`.
+
+Роботу поділено на дві частини, бо Wasm-плагін SWC перетворює по одному файлу за раз і не має доступу до файлової системи:
+
+| Прохід                                                | Де виконується                   | Що робить                                                                                            |
+| :---------------------------------------------------- | :------------------------------- | :--------------------------------------------------------------------------------------------------- |
+| Аналіз використання + purge/мініфікація JSON          | Node, усередині `withIntlayer()` | Читає кожен вихідний файл компонента, переписує `.intlayer/**/*.json`, формує таблиці перейменування |
+| Переписування вихідного коду (`content.title` → `.a`) | `@intlayer/swc` (Wasm)           | Застосовує таблиці перейменування до відповідних звернень до властивостей у вашому коді              |
+| Переписування імпортів (`useIntlayer` → dict)         | `@intlayer/swc` (Wasm)           | Те саме, що `intlayerOptimizeBabelPlugin`                                                            |
+
+Визначення того, _які_ поля не використовуються і _який_ псевдонім отримає кожне з них, потребує стану між файлами та файлового вводу-виводу, тож ця половина виконується в Node; плагін SWC отримує лише готові таблиці.
+
 ## Конфігурація
 
 Ви можете контролювати те, як Intlayer оптимізує ваш бандл, за допомогою властивості `build` у файлі `intlayer.config.ts`.
@@ -650,3 +517,136 @@ const content = useDictionaryAsync({
 | **Мережеві запити**        | 0 додаткових запитів                            | 1 запит на один ключ словника           |
 | **Tree Shaking**           | На рівні компонента                             | На рівні компонента + на рівні локалі   |
 | **Найкраще підходить для** | UI-компонентів, невеликих програм               | Насичених текстом сторінок, безлічі мов |
+
+## Проаналізуйте свій бандл
+
+Аналіз бандлу — це найпряміший спосіб виявити "важкі" JSON-файли та можливості для розділення коду (code-splitting). Відповідні інструменти генерують візуальну деревоподібну мапу (treemap) зібраного коду вашої програми, дозволяючи точно побачити, які бібліотеки займають найбільше місця.
+
+<Tabs>
+ <Tab value="vite">
+
+### Vite / Rollup
+
+Vite під капотом використовує Rollup. Плагін `rollup-plugin-visualizer` створює інтерактивний HTML-файл, що відображає розмір кожного модуля у вашому графі.
+
+```bash
+npm install -D rollup-plugin-visualizer
+```
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { visualizer } from "rollup-plugin-visualizer";
+
+export default defineConfig({
+  plugins: [
+    visualizer({
+      open: true, // Автоматично відкрити звіт у браузері
+      filename: "stats.html",
+      gzipSize: true,
+      brotliSize: true,
+    }),
+  ],
+});
+```
+
+ </Tab>
+ <Tab value="nextjs (turbopack)">
+
+### Next.js (Turbopack)
+
+Для проєктів, що використовують App Router та Turbopack, Next.js надає вбудований експериментальний аналізатор, який не потребує додаткових залежностей.
+
+```bash packageManager='npm'
+npx next experimental-analyze
+```
+
+```bash packageManager='yarn'
+yarn next experimental-analyze
+```
+
+```bash packageManager='pnpm'
+pnpm next experimental-analyze
+```
+
+```bash packageManager='bun'
+bun next experimental-analyze
+```
+
+ </Tab>
+ <Tab value="nextjs (Webpack)">
+
+### Next.js (Webpack)
+
+Якщо в Next.js ви користуєтеся стандартним Webpack, застосуйте офіційний bundle analyzer. Викличте його, встановивши змінну середовища (environment variable) під час збірки.
+
+```bash packageManager='npm'
+npm install -D @next/bundle-analyzer
+```
+
+```bash packageManager='yarn'
+yarn add -D @next/bundle-analyzer
+```
+
+```bash packageManager='pnpm'
+pnpm add -D @next/bundle-analyzer
+```
+
+```bash packageManager='bun'
+bun add -d @next/bundle-analyzer
+```
+
+```javascript fileName="next.config.js"
+const withBundleAnalyzer = require("@next/bundle-analyzer")({
+  enabled: process.env.ANALYZE === "true",
+});
+
+module.exports = withBundleAnalyzer({
+  // Ваш конфіг Next.js
+});
+```
+
+**Використання:**
+
+```bash
+ANALYZE=true npm run build
+```
+
+ </Tab>
+ <Tab value="Webpack (CRA / Angular / etc)">
+
+### Стандартний Webpack
+
+Для Create React App (ejected), Angular або кастомних налаштувань Webpack скористайтеся галузевим стандартом `webpack-bundle-analyzer`.
+
+```bash packageManager='npm'
+npm install -D webpack-bundle-analyzer
+```
+
+```bash packageManager='yarn'
+yarn add -D webpack-bundle-analyzer
+```
+
+```bash packageManager='pnpm'
+pnpm add -D webpack-bundle-analyzer
+```
+
+```bash packageManager='bun'
+bun add -d webpack-bundle-analyzer
+```
+
+```typescript fileName="webpack.config.ts"
+import { BundleAnalyzerPlugin } from "webpack-bundle-analyzer";
+
+export default {
+  plugins: [
+    new BundleAnalyzerPlugin({
+      analyzerMode: "static",
+      reportFilename: "bundle-analyzer.html",
+      openAnalyzer: false,
+    }),
+  ],
+};
+```
+
+ </Tab>
+</Tabs>

package/docs/uk/configuration.md

@@ -1122,3 +1122,101 @@ Intlayer підтримує широкий спектр провайдерів A
 | Поле      | Опис                                         | Тип                |
 | --------- | -------------------------------------------- | ------------------ |
 | `plugins` | Список плагінів Intlayer, які слід включити. | `IntlayerPlugin[]` |
+
+## Часто задавані запитання
+
+<FAQ>
+
+<Question title="Де повинен знаходитися файл intlayer.config.ts?">
+
+У кореневому каталозі проекту, поруч із `package.json`. Intlayer сканує робочий каталог і батьківські каталоги на наявність `intlayer.config.ts`, `intlayer.config.js`, `intlayer.config.mjs` або `intlayer.config.cjs`. Ви також можете передати власний шлях через прапорець `--config` у командах CLI.
+
+</Question>
+
+<Question title="Скільки i18n додає до розміру бандла?">
+
+Значно менше, ніж рішення на основі просторів імен (namespaces), оскільки сторінка ніколи не завантажує каталог, який вона не рендерить. Розмітка, що рендериться на сервері, отримує свій контент безпосередньо на сервері, а компілятор під час збирання замінює виклики `useIntlayer` точними записами словника, які використовує компонент, тому невикористані ключі та мови видаляються. [Динамічні словники](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dynamic_dictionaries/index.md) розділяють залишок за окремими локалями. У порівнянні зі звичними альтернативами Intlayer зменшує розмір бандла та сторінки до 50%. Див. [оптимізацію бандла](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/bundle_optimization.md) та [бенчмарк](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/benchmark/index.md).
+
+</Question>
+
+<Question title="Чи можу я мігрувати з i18next, next-intl або react-i18next без переписування моїх компонентів?">
+
+Так, і для цього є два шляхи. Ви можете переносити контент поступово, користуючись [посібником з міграції з i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/migration_from_i18next_to_intlayer.md) або [посібником з міграції з next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/migration_from_next-intl_to_intlayer.md). Або ви можете повністю зберегти свій поточний API: [адаптери сумісності](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/compat/index.md) надають абсолютно той самий інтерфейс, що й `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` та `Lingui`, але дані беруться зі словників Intlayer, завдяки чому змінюються лише імпорти, а код компонентів залишається незмінним.
+
+</Question>
+
+<Question title="Чи можу я зберігати мої існуючі JSON файли перекладів?">
+
+Так. [sync JSON плагін](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/plugins/sync-json.md) зберігає ваші файли `/messages/{locale}/{namespace}.json` як джерело істини та генерує словники Intlayer з них в обох напрямках. [sync PO плагін](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/plugins/sync-po.md) робить те ж саме для gettext каталогів, а [файли для окремих локалей](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/per_locale_file.md) дозволяють розділити контент за мовами замість групування локалей в один файл.
+
+</Question>
+
+<Question title="Чи потрібно переносити вміст ключ за ключем?">
+
+Ні. Запустіть `npx intlayer extract`, і Intlayer прочитає ваші файли, витягне призначені для користувача рядки і створить файл `.content` поруч із кожним компонентом, завдяки чому ви переглядаєте diff замість копіювання рядків у каталог вручну. Див. [команду extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/extract.md).
+
+Для повністю автоматизованого робочого процесу [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/compiler.md) робить те саме під час збирання у коді JSX, TSX, Vue та Svelte, генеруючи словники під час кожної зміни, тому вручну підтримувати ключі не потрібно. Оскільки він працює через статичний аналіз, динамічні рядки середовища виконання залишаються поза його досяжністю.
+
+</Question>
+
+<Question title="Які інструменти для редактора та AI агентів доступні?">
+
+П'ять інструментів, усі опціональні:
+
+- **[Розширення VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/vs_code_extension.md)**: перехід від ключа `useIntlayer` до файлу контенту, вилучення рядків із компонента та запуск build, fill, test, push і pull із палітри команд або вкладки Intlayer.
+- **[LSP сервер](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/lsp.md)**: та сама функціональність у будь-якому редакторі з підтримкою LSP, включно з переходом до визначення, переглядом перекладеного значення під час наведення та автодоповненням ключів. Також підтримує виклики `i18next`, `react-i18next`, `next-intl` та `use-intl`.
+- **[MCP сервер](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/mcp_server.md)**: надає документацію та CLI Intlayer для Cursor, VS Code, Claude Desktop, Claude Code та ChatGPT.
+- **[Навички агента (Agent skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/agent_skills.md)**: спеціалізовані навички `intlayer-config`, `intlayer-cli` та `intlayer-content`.
+- **[Плагін ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/eslint.md)**: правило `no-raw-text` відстежує жорстко закодовані рядки.
+
+</Question>
+
+<Question title="Як додати нову мову до мого додатку?">
+
+Додайте код локалі до масиву `internationalization.locales`, а потім запустіть `npx intlayer fill`, щоб автоматично перекласти наявний контент. Компілятор врахує нову мову під час наступного збирання.
+
+</Question>
+
+<Question title="Як видалити префікс локалі з моїх адрес URL?">
+
+Налаштуйте `routing.mode`. Значення `"no-prefix"` видаляє префікс для всіх мов, визначаючи локаль через cookie, заголовок або домен. Значення `"prefix-no-default"` (за замовчуванням) приховує префікс тільки для основної мови.
+
+</Question>
+
+<Question title="Чи можу я обслуговувати кожну мову з власного домену?">
+
+Так. Опція `routing.domains` прив'язує кожну локаль до хоста, наприклад `{ uk: 'example.ua', en: 'example.com' }`. Визначення за доменом має пріоритет над префіксами шляху, а `getMultilingualUrls` генерує повні адреси для `hreflang`.
+
+</Question>
+
+<Question title="Як визначається мова користувача?">
+
+Через `routing.storage`, де перелічені джерела за порядком пріоритету: зазвичай спочатку URL, далі cookie, потім заголовок `Accept-Language`, а в разі їх відсутності - мова за замовчуванням.
+
+</Question>
+
+<Question title="Що робить routing.enableProxy?">
+
+Керує проксі маршрутизації локалей - middleware, що обробляє префікси та редиректи. За замовчуванням проксі активне у режимах dev та production. Встановіть `false`, якщо керуєте адресами власноруч.
+
+</Question>
+
+<Question title="У чому різниця між importMode static, dynamic та fetch?">
+
+Значення `"static"` (за замовчуванням) імпортує словники статично, тому вони пакуються в бандл і читаються синхронно. `"dynamic"` завантажує словники асинхронно для кожної мови, полегшуючи початковий бандл. `"fetch"` отримує словники з сервера або CMS під час виконання.
+
+</Question>
+
+<Question title="Де встановити AI провайдера та ключ API для автоматичного перекладу?">
+
+У файлі конфігурації в секції `ai` або в командному рядку за допомогою прапорців `--provider`, `--model` та `--api-key`. Ключ залишається на вашому боці й ніколи не залишає вашого оточення. Див. [довідник конфігурації AI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md).
+
+</Question>
+
+<Question title="Чи потрібно перезапускати сервер розробки після зміни конфігурації?">
+
+Зазвичай ні. Watcher Intlayer відстежує файл `intlayer.config.ts`: під час збереження він перезавантажує налаштування та оновлює словники у фоновому режимі.
+
+</Question>
+
+</FAQ>

package/docs/uk/dictionary/content_file.md

@@ -372,15 +372,15 @@ Intlayer підтримує різні типи контенту через ти
 
 **Приклад:**
 
-```json
+```jsonc
 // Словник для конкретної локалі
 {
   "key": "about-page",
   "locale": "en",
   "content": {
     "title": "About Us", // Це стає вузлом перекладу для 'en'
-    "description": "Learn more about our company"
-  }
+    "description": "Learn more about our company",
+  },
 }
 ```
 
@@ -450,7 +450,7 @@ export default aboutPageMetaContent;
 
 **Приклади:**
 
-```json
+```jsonc
 // Вимкнути автозаповнення
 {
   "fill": false

package/docs/uk/dictionary/markdown.md

@@ -51,6 +51,7 @@ Intlayer підтримує вміст форматованого тексту,
 
 <Tabs>
   <Tab label=".content.md" value=".content.md">
+
     Починаючи з версії `8.10.0`, ви можете оголошувати вміст Markdown безпосередньо у файлах `.content.md`. Intlayer автоматично виявлятиме та аналізуватиме вміст Markdown.
 
     ```md fileName="markdown-file.en.content.md"
@@ -96,6 +97,7 @@ Intlayer підтримує вміст форматованого тексту,
     ```
 
   </Tab>
+
   <Tab label="Зовнішні файли" value="external-files">
     Імпортуйте файли `.md` безпосередньо за допомогою функції `file`.
 
@@ -129,6 +131,7 @@ Intlayer підтримує вміст форматованого тексту,
     ```
 
   </Tab>
+
 </Tabs>
 
 ## Рендеринг Markdown

package/docs/uk/dictionary/plurial.md

@@ -33,11 +33,14 @@ author: aymericzip
 
 На відміну від [`enu`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/enumeration.md), який вибирає контент на основі числових діапазонів, визначених вами самостійно, `plural` делегує вибір правилам CLDR. Це робить його масштабованим для мов зі складними правилами множини, таких як українська, польська, арабська або валлійська, без необхідності вручну писати логіку по модулю.
 
-## Коли використовувати `plural` проти `enu`
+## Коли використовувати `plural` замість `enu`
 
-To use plural content inside a React component, retrieve it via the `useIntlayer` hook and call it with a count. The active locale and the count are combined to pick the matching CLDR category.
+| Варіант використання                                                               | Хелпер   |
+| ---------------------------------------------------------------------------------- | -------- |
+| Граматичні форми множини з урахуванням локалі (одне яблуко / два яблука / 5 яблук) | `plural` |
+| Власні числові діапазони (`<5`, `>=10`) або категорії поза CLDR                    | `enu`    |
 
-To use plural content in Next.js Client Components, retrieve it via the `useIntlayer` hook and call it with a count. Here's an example:
+Якщо ви орієнтуєтеся лише на англійську (де є лише `one` / `other`), працює будь-який варіант. Для будь-якої мови з розрізненням `few` / `many` / `two` віддавайте перевагу `plural`.
 
 ## Налаштування контенту у множині