@intlayer/docs 9.4.1 → 9.4.2

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`.
 
 ## Налаштування контенту у множині
 

package/docs/uk/how_works_intlayer.md

@@ -257,3 +257,95 @@ The `@intlayer/api` package is an API SDK to interact with the backend.
 ## Чат з нашою розумною документацією
 
 - [Задавайте свої питання нашій розумній документації](https://intlayer.org/doc/chat)
+
+## Часто задавані запитання
+
+<FAQ>
+
+<Question title="Коли будуються словники: під час збирання чи під час виконання?">
+
+Під час збирання. Плагін Intlayer сканує файли `.content.ts`, компілює їх в оптимізовані словники та записує до теки `.intlayer`. У середовищі розробки цей процес виконується миттєво при кожному збереженні файлу.
+
+</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="Що таке тека .intlayer і чи слід комітити її в git?">
+
+Це скомпільований результат: згенеровані словники та типи TypeScript. Вона повністю генерується з ваших файлів вмісту, тому її слід додати до `.gitignore` і збирати в CI/CD за допомогою команди `intlayer build`.
+
+</Question>
+
+<Question title="Як визначається активна локаль?">
+
+З джерел, зазначених у `routing.storage`, за чергою: префікс URL, файл cookie, заголовок `Accept-Language` та мова за замовчуванням.
+
+</Question>
+
+<Question title="У чому різниця між локальними та віддаленими словниками?">
+
+Локальний словник оголошується у вашій кодовій базі та компілюється разом із додатком. Віддалений словник керується в CMS і підтягується через API, що дозволяє оновлювати тексти без повторного збирання додатку.
+
+</Question>
+
+<Question title="Чи працює Intlayer без TypeScript?">
+
+Так. Файли вмісту можна писати на TypeScript, JavaScript, ESM, CommonJS або JSON. Проте саме TypeScript забезпечує строгу типізацію та автодоповнення ключів у вашому редакторі.
+
+</Question>
+
+<Question title="Як серверний рендеринг і клієнтський рендеринг ділять один і той самий контент?">
+
+Сервер вирішує вміст компонентів, що рендеряться на стороні сервера, напряму, тому для них клієнту не відправляється жодних словників. Клієнтські компоненти отримують лише ті словники, які потрібні для інтерактивності в браузері.
+
+</Question>
+
+<Question title="Як Intlayer уникає помилок гідратації (hydration mismatch), пов'язаних із мовою?">
+
+Мова визначається один раз на сервері й передається клієнтському провайдеру замість повторного визначення в браузері, що гарантує повну відповідність серверного та клієнтського HTML.
+
+</Question>
+
+<Question title="Чи потрібно перезбирати додаток під час додавання перекладу?">
+
+У режимі розробки ні: плагін відстежує файли та оновлює словники на льоту. У продакшні так: локальні словники вбудовуються в кінцеві файли під час етапу збирання.
+
+</Question>
+
+</FAQ>

package/docs/uk/interest_of_intlayer.md

@@ -39,7 +39,6 @@ author: aymericzip
 Порівняно з основними рішеннями, такими як `next-intl` або `i18next`, Intlayer — це рішення, яке має такі інтегровані оптимізації, як:
 
 <AccordionGroup>
-
 <Accordion header="Розмір бандлу">
 
 Замість того, щоб завантажувати великі файли JSON на свої сторінки, завантажуйте лише необхідний вміст. Intlayer допомагає **зменшити розмір бандлу і сторінок до 50%**.
@@ -294,3 +293,99 @@ export const ComponentExample = () => {
 За допомогою `intlayer` ви можете оголосити свій вміст у форматі вашої улюбленої бібліотеки i18n, і intlayer згенерує простори назв у вибраному вами місці (наприклад: `/messages/{{locale}}/{{namespace}}.json`).
 
 Якщо ви хочете й надалі використовувати API вашої поточної бібліотеки i18n, `intlayer` також надає **адаптери сумісності (compat adapters)**: пакети, що надають точно такий самий API, як `react-i18next`, `next-intl`, `react-intl`, `vue-i18n` та інші, але з вмістом зі словників Intlayer. Це дозволяє мігрувати поступово, не переписуючи код. Див. [документацію адаптерів сумісності](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/compat/index.md).
+
+## Часто задавані запитання
+
+<FAQ>
+
+<Question title="Які є різні рішення для інтернаціоналізації додатків JavaScript?">
+
+Співіснують три покоління:
+
+- **Бібліотеки каталогів часу виконання (runtime)**: `i18next`, `react-i18next`, `next-i18next`, `vue-i18n`, `ngx-translate`.
+- **Бібліотеки повідомлень часу компіляції**: `Lingui`, `Paraglide`, `react-intl` та `next-intl`.
+- **Бібліотеки з шаром контенту (Content layer)**: `Intlayer`. Оголошення поруч із компонентом, tree-shaking, типи TypeScript, переклад за допомогою AI та візуальний редактор.
+
+</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="Чим Intlayer відрізняється від next-intl?">
+
+`next-intl` - це шар повідомлень для Next.js, заснований на JSON файлах під кожну мову. Intlayer оголошує вміст безпосередньо біля компонента, видаляє невикористані ключі під час збирання, створює суворі типи TypeScript для кожного словника і надає вбудований переклад AI та візуальний редактор.
+
+</Question>
+
+<Question title="Чим Intlayer відрізняється від i18next та react-i18next?">
+
+`i18next` вирішує рядкові ключі під час виконання, що у разі помилки в назві ключа призводить до порожнього тексту на екрані. Intlayer перевіряє ключі статично під час компіляції, виключає непотрібні мови з бандла та автоматизує процес перекладу.
+
+</Question>
+
+<Question title="Чи є Intlayer швидшим або легшим за альтернативи?">
+
+Щодо розміру бандла та сторінки - так: відмова від завантаження непотрібних сторінці каталогів скорочує обсяг бандла до 50%. Щодо швидкодії - попередня компіляція усуває витрати на парсинг у runtime. Див. [бенчмарк](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/benchmark/index.md).
+
+</Question>
+
+<Question title="Чи варто мігрувати наявний додаток?">
+
+Це залежить від поточних проблем. Якщо вам заважає великий розмір бандла, пропущені переклади чи труднощі нетехнічних спеціалістів із редагуванням текстів, Intlayer вирішує ці задачі, а адаптери сумісності дозволяють мігрувати поступово без переписування коду.
+
+</Question>
+
+<Question title="Що пропонує Intlayer, чого немає в інших бібліотеках i18n?">
+
+Підтримку [Markdown вмісту](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/markdown.md), завантаження контенту з CMS, інтегрований візуальний редактор, автоматичний переклад через AI з прапорцем `--git-diff` та автодоповнення TypeScript на основі структури компонентів.
+
+</Question>
+
+<Question title="Чи можу я використовувати Intlayer лише як менеджер перекладів і зберегти поточну бібліотеку?">
+
+Так. Intlayer може генерувати простори імен у форматі та шляху, очікуваному вашою поточною бібліотекою (наприклад `/messages/{locale}/{namespace}.json`), що дозволяє використовувати CLI та редактор Intlayer без зміни коду додатку.
+
+</Question>
+
+<Question title="Чи є Intlayer безкоштовним та відкритим кодом?">
+
+Так, під ліцензією Apache 2.0, включно з комерційним використанням. Хмарна CMS - це додаткова послуга, яку також можна [розгорнути на власному сервері](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/self_hosting.md).
+
+</Question>
+
+</FAQ>

package/docs/uk/intlayer_CMS.md

@@ -431,3 +431,95 @@ curl -fsSL https://intlayer.org/install.sh | sh
 - Переконайтеся, що конфігурацію проєкту було pushed до Intlayer CMS.
 
 - Візуальний редактор використовує iframe для відображення вашого вебсайту. Переконайтеся, що Content Security Policy (CSP) вашого сайту дозволяє URL CMS у `frame-ancestors` ('https://app.intlayer.org' за замовчуванням). Перевірте консоль редактора на наявність помилок.
+
+## Часто задавані запитання
+
+<FAQ>
+
+<Question title="У чому різниця між Intlayer CMS та візуальним редактором?">
+
+[Візуальний редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_visual_editor.md) редагує локальні файли словників у вашій кодовій базі. CMS керує контентом віддалено на сервері, дозволяючи публікувати зміни текстів без необхідності нового розгортання додатку.
+
+</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="Який контент варто переносити до CMS?">
+
+Контент, що часто змінюється і не прив'язаний до циклу релізів коду: тексти на лендінгах, ціни, оголошення, банери та статті блогу.
+
+</Question>
+
+<Question title="Що станеться, якщо CMS недоступна?">
+
+Додаток автоматично повертається до локального оголошення словника в кодовій базі, завдяки чому збій мережі ніколи не призведе до порожньої сторінки для користувача.
+
+</Question>
+
+<Question title="Чи можу я самостійно хостити CMS?">
+
+Так. CMS може працювати на вашій власній інфраструктурі, коли контент не повинен виходити за межі внутрішньої мережі. Див. [посібник із self-hosting](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/self_hosting.md).
+
+</Question>
+
+<Question title="Чи потрібен редакторам контенту розробник для публікації змін?">
+
+Ні. Це головна мета віддалених словників: редактор змінює текст у CMS, і завдяки функції живої синхронізації (live sync) сайт миттєво відображає оновлення.
+
+</Question>
+
+<Question title="Чи можна автоматизувати CMS замість використання інтерфейсу?">
+
+Так. SDK `@intlayer/api` надає ті самі ендпоінти, що й інтерфейс, дозволяючи керувати проектами та публікацією словників за допомогою власних скриптів.
+
+</Question>
+
+<Question title="Чи підтримує CMS A/B тестування перекладів?">
+
+Так. Віддалені словники підтримують [варіанти контенту](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dynamic_dictionaries/index.md), що дозволяє показувати різні версії текстів різним аудиторіям.
+
+</Question>
+
+<Question title="Чи є CMS безкоштовною?">
+
+Бібліотека Intlayer, CLI, компілятор та візуальний редактор безкоштовні під ліцензією Apache 2.0. Хмарна CMS є платною послугою, але її версію для самостійного розміщення можна запустити безкоштовно на власному сервері.
+
+</Question>
+
+</FAQ>

package/docs/uk/intlayer_visual_editor.md

@@ -219,4 +219,90 @@ pnpm intlayer-editor start -e development
   - Обов'язкові поля:
     - URL застосунку має відповідати тому, який ви вказали в конфігурації редактора (`applicationURL`).
 
-- Візуальний редактор використовує iframe для відображення вашого сайту. Переконайтесь, що Content Security Policy (CSP) вашого сайту дозволяє URL CMS як значення `frame-ancestors` ('http://localhost:8000' за замовчуванням). Перевірте консоль редактора на наявність помилок.
+- Візуальний редактор використовує iframe для відображення вашого сайту. Переконайтесь, що Content Security Policy (CSP) вашого сайту дозволяє URL CMS як значення `frame-ancestors` (`http://localhost:8000` за замовчуванням). Перевірте консоль редактора на наявність помилок.
+
+## Часто задавані запитання
+
+<FAQ>
+
+<Question title="У чому різниця між візуальним редактором та CMS?">
+
+Візуальний редактор змінює локальні словники і записує зміни безпосередньо у файли коду, тому вони проходять стандартну процедуру Git. CMS зберігає тексти на віддаленому сервері для миттєвої публікації без нового білду.
+
+</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="Де запускається візуальний редактор?">
+
+На вашій власній інфраструктурі. Він завантажує ваш додаток усередині iframe та взаємодіє з локальним сервером редактора, тому ваш контент ніколи не передається стороннім сервісам.
+
+</Question>
+
+<Question title="Чи потрібно редакторам вміти програмувати?">
+
+Ні. Вони відкривають сайт, натискають на потрібний текст і редагують його на місці. Редактор автоматично знаходить відповідний запис у словнику.
+
+</Question>
+
+<Question title="Чи змінює редагування через візуальний редактор мої вихідні файли?">
+
+Так, саме так це задумано. Зміна записується у файл оголошення контенту у вашій кодовій базі та відображається у звичайному diff git.
+
+</Question>
+
+<Question title="Редактор показує порожню сторінку або відмовляється завантажувати сайт. Що перевірити?">
+
+Редактор відображає додаток в iframe, тому ваша політика Content Security Policy (CSP) повинна дозволяти адресу редактора в директиві `frame-ancestors`. Також перевірте, чи запущені обидва сервери.
+
+</Question>
+
+<Question title="Чи можна використовувати візуальний редактор у продакшні?">
+
+Він створений для середовищ розробки та стейджингу, де допустима перезбірка після редагування. Для редагування контенту на живих сайтах рекомендується [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_CMS.md).
+
+</Question>
+
+<Question title="Чи є візуальний редактор безкоштовним?">
+
+Так. Візуальний редактор є частиною відкритого проекту під ліцензією Apache 2.0, включно з комерційним використанням.
+
+</Question>
+
+</FAQ>