@intlayer/docs 9.4.3 → 9.5.0

package/docs/uk/intlayer_with_hono.md

@@ -310,25 +310,21 @@ Hono не має власного рівня i18n, тому варіантами
 Див. [чому Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/interest_of_intlayer.md).
 
 </Question>
-
 <Question title="Скільки i18n додає до розміру серверного бандла Hono?">
 
 Значно менше, ніж традиційні каталоги JSON. Компілятор Intlayer оптимізує словники під час збирання і не парсить їх заново під час кожного запиту, зменшуючи використання пам'яті та час холодного старту. Див. [оптимізацію бандла](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/bundle_optimization.md).
 
 </Question>
-
 <Question title="Чи можу я мігрувати з i18next або інших бібліотек без переписування обробників?">
 
 Так, через поступову міграцію або синхронізацію файлів перекладів.
 
 </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).
@@ -336,7 +332,6 @@ Hono не має власного рівня i18n, тому варіантами
 Для повної автоматизації [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/compiler.md) робить те саме під час збирання та генерує словники під час кожної зміни.
 
 </Question>
-
 <Question title="Які інструменти для редактора та AI агентів доступні?">
 
 П'ять інструментів, усі опціональні:
@@ -348,61 +343,51 @@ Hono не має власного рівня i18n, тому варіантами
 - **[Плагін ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/eslint.md)**: правило `no-raw-text` відстежує жорстко закодовані рядки.
 
 </Question>
-
 <Question title="Як визначається мова клієнта у вхідних запитах?">
 
 Middleware Hono читає cookie та заголовок `Accept-Language` через `c.req`, надаючи активну мову через `c.get('locale')`.
 
 </Question>
-
 <Question title="Чи можуть одні й ті самі оголошення контенту обслуговувати відповіді API та веб-інтерфейс?">
 
 Так, у монорепозиторіях або спільних пакетах це є ключовою перевагою. Оголошений словник можна імпортувати як на бекенді (листи, помилки, відповіді API), так і на фронтенді (React, Vue, Svelte тощо), зберігаючи єдине джерело істини для всіх текстів.
 
 </Question>
-
 <Question title="Чи сповільнює Intlayer обробку запитів?">
 
 Ні. Визначення локалі відбувається у швидкому middleware (читаються cookie, параметри або заголовок Accept-Language). Словники скомпільовані під час збирання та знаходяться в пам'яті, тому під час запиту немає читання з диска чи парсингу рядків.
 
 </Question>
-
 <Question title="Як локалізувати повідомлення про помилки, електронні листи та push-сповіщення?">
 
 Викликаючи функцію `getIntlayer` або `t()` з урахуванням локалі запиту. Якщо мова користувача зберігається у базі даних, у фонових завданнях цільову мову можна передати у функцію явно.
 
 </Question>
-
 <Question title="Чи працює Intlayer у Cloudflare Workers та edge середовищах?">
 
 Так. Intlayer генерує оптимізований JavaScript код без залежності від локальної файлової системи під час виконання, тому він ідеально працює на Cloudflare Workers, Deno та Vercel Edge.
 
 </Question>
-
 <Question title="Як використовувати локалізовані префікси URL у маршрутах Hono?">
 
 Використовуючи сегмент `/:locale/` або створюючи суб-роутери Hono.
 
 </Question>
-
 <Question title="Як автоматично перекласти додаток за допомогою AI?">
 
 Запустіть `npx intlayer fill`. Утиліта заповнює відсутні переклади через обрану LLM з вашим провайдером та ключем API, а прапорець `--git-diff` обмежує обробку зміненими файлами. Див. [команду fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/fill.md) та [інтеграцію CI/CD](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/CI_CD.md).
 
 </Question>
-
 <Question title="Чи підтримує Intlayer форми множини, стать та форматований текст (rich text)?">
 
 Так: [форми множини](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/plurial.md), [контент з урахуванням статі](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/gender.md), умови, [вставки (insertions)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/insertion.md) та [форматування](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/formatters.md).
 
 </Question>
-
 <Question title="Як нетехнічні члени команди можуть редагувати шаблони листів та повідомлення про помилки без доступу до коду?">
 
 Є два шляхи: [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_CMS.md), яка відокремлює вміст від кодової бази і дозволяє редагувати тексти через веб-інтерфейс, або [візуальний редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_visual_editor.md), який записує зміни безпосередньо у файли коду.
 
 </Question>
-
 <Question title="Чи є Intlayer безкоштовним та відкритим кодом?">
 
 Так, під ліцензією Apache 2.0, включно з комерційним використанням. Хмарна CMS - це додаткова платна послуга, яку також можна [розгорнути самостійно (self-host)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/self_hosting.md).

package/docs/uk/intlayer_with_htmx.md

@@ -42,13 +42,11 @@ Intlayer охоплює це через свої backend інтеграції,
 Middleware Intlayer розв'язує локаль із самого запиту, тому фрагмент, поданий на десятій хвилині, відповідає тією ж мовою, що й сторінка, подана на нульовій хвилині.
 
 </Accordion>
-
 <Accordion header="Локаль має подорожувати з запитом">
 
 Два переносники працюють з htmx. Cookie (`INTLAYER_LOCALE`) автоматично відправляється браузером при кожному запиті, включаючи запити htmx. Заголовок (`x-intlayer-locale`) може бути прикріплений до запитів htmx за допомогою атрибута `hx-headers`. Обидва читаються за замовчуванням.
 
 </Accordion>
-
 <Accordion header="Замінений HTML залишається HTML">
 
 Перекладене значення, інтерпольоване у фрагмент, є розміткою. Екранізуйте його точно так само, як ви робили б з будь-яким іншим динамічним значенням, тому переклад, що містить `<`, не може розірвати документ, у який він вставляється.
@@ -56,8 +54,6 @@ Middleware Intlayer розв'язує локаль із самого запит
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Покрокове керівництво
 
 <iframe
@@ -71,7 +67,6 @@ Middleware Intlayer розв'язує локаль із самого запит
 Див. [Application Template](https://github.com/aymericzip/intlayer-htmx-template) на GitHub.
 
 <Steps>
-
 <Step number={1} title="Встановлення залежностей">
 
 Встановіть `intlayer` плюс інтеграцію для вашого сервера.
@@ -160,7 +155,6 @@ bun add intlayer elysia-intlayer
 htmx сам по собі - це один тег скрипту, який додається на кроці 4.
 
 </Step>
-
 <Step number={2} title="Конфігурація вашого проекту">
 
 Створіть `intlayer.config.ts` у кореневі вашого проекту:
@@ -181,7 +175,6 @@ export default config;
 > Для повного списку параметрів див. [документацію конфігурації](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md).
 
 </Step>
-
 <Step number={3} title="Оголосити ваш вміст">
 
 Оголосіть кожен label, який сервер буде відображати, включаючи ті, що з'являються тільки всередині фрагмента:
@@ -228,7 +221,6 @@ export default appContent;
 > Оголошення контенту можуть знаходитися будь-де під `contentDir` (за замовчуванням `./src`) та відповідати `.content.{json,ts,tsx,js,jsx,mjs,cjs,md,mdx,yaml,yml}`. Див. [документацію оголошення контенту](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/content_file.md).
 
 </Step>
-
 <Step number={4} title="Зареєструвати middleware Intlayer">
 
 Middleware розпізнає локаль кожного запиту та надає її доступ до ваших обробників.
@@ -302,7 +294,6 @@ const app = new Elysia().use(intlayer());
 За замовчуванням locale беруть з cookies `INTLAYER_LOCALE`, потім із заголовка `x-intlayer-locale`, потім із переговорів `Accept-Language`.
 
 </Step>
-
 <Step number={5} title="Рендеризуйте фрагменти з locale запиту">
 
 Напишіть ваші рендери фрагментів як чисті функції locale та передайте locale, яке middleware розрахував. Передання його явно утримує фрагмент прив'язаним до запиту, який його запросив, незалежно від того, на якому сервері ви перебуваєте.
@@ -400,7 +391,6 @@ app.post("/cart/items", ({ body, intlayer }) => {
 Той же фрагмент тепер відповідає французькою мовою для відвідувача, чий cookie говорить `fr`, і арабською для того, чий cookie говорить `ar`, без змін у викликаному розмітці.
 
 </Step>
-
 <Step number={6} title="Служба першої сторінки">
 
 Рендеріть `<body>` окремо, щоб перемикач мови на кроці 7 міг замінити його цілком, потім обгорніть його в документ, який завантажує htmx:
@@ -435,7 +425,6 @@ ${renderBody(locale, itemCount)}
 `getHTMLTextDir` повертає `ltr`, `rtl` або `auto` для locale, що забезпечує правильне відображення арабської та іврит мов.
 
 </Step>
-
 <Step number={7} title="Змінити мову">
 
 Зміна мови - це запит як і будь-який інший. Сервер зберігає вибір у cookie, що його читає middleware, потім повертає сторінку, перевідрендерену на новій локалі.
@@ -575,7 +564,6 @@ app.post("/locale", ({ body, cookie, status }) => {
 > `isDeclaredLocale` звужує довільний рядок до одного з ваших налаштованих локалей, тому неочікуване значення ніколи не потрапляє до ваших рендерерів.
 
 </Step>
-
 <Step number={8} title="Синхронізуйте lang і dir після заміни" isOptional={true}>
 
 Обмін може замінити `<body>`, але ніколи не замінює `<html>` навколо нього. Рендеріть `lang` та `dir` на обміненому body та скопіюйте їх назад на кореневий елемент один раз з head:
@@ -592,7 +580,6 @@ app.post("/locale", ({ body, cookie, status }) => {
 Без цього перемикання на арабську мову рендеритиме справа наліво всередину body, а документ все ще повідомляє попередню мову допоміжним технологіям та краулерам.
 
 </Step>
-
 <Step number={9} title="Надіслати локаль як заголовок замість cookie" isOptional={true}>
 
 Якщо cookie вас не влаштовує, додайте локаль до кожного htmx запиту за допомогою `hx-headers` на елементі-предку. Нащадки успадковують її:
@@ -663,8 +650,6 @@ export default config;
 
 Для отримання більше деталей про використання розширення звертайтесь до [документації Intlayer VS Code Extension](https://intlayer.org/doc/vs-code-extension).
 
----
-
 ### Йти далі
 
 Щоб йти далі, ви можете екстерналізувати свій вміст за допомогою [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_CMS.md), щоб перекладачі змінювали копію без розгортання.
@@ -678,67 +663,56 @@ export default config;
 Тому що запит фрагмента не мав локалі. htmx запити незалежні від сторінки, яка їх видала, тому локаль повинна передаватися на кожному з них через cookie `INTLAYER_LOCALE` або заголовок `x-intlayer-locale`, встановлений за допомогою `hx-headers`. Переконайтеся, що парсер cookie запускається перед middleware Intlayer на Express та Fastify, інакше cookie ніколи не читається і кожен запит повертається до `Accept-Language`.
 
 </Question>
-
 <Question title="Чи повинен я передавати локаль до `getIntlayer` або покладатися на контекст запиту?">
 
 Передавайте його. Інтеграції надають розпізнану локаль (`res.locals.locale`, `req.intlayer.locale`, `c.get("locale")`, `intlayer!.locale`), а передача її до `getIntlayer` робить кожен renderer чистою функцією локалі. Це простіше тестувати, і це робить ваші fragment renderers портативними, якщо ви зміните server.
 
 </Question>
-
 <Question title="Чи мені потрібна клієнтська бібліотека i18n поряд з htmx?">
 
 Ні. Все, що бачить відвідувач, створюється сервером, тому в браузері нічого не потрібно перекладати. Саме тому вартість ваги сторінки для i18n в htmx додатку близька до нуля: жоден каталог ніколи не відправляється клієнту.
 
 </Question>
-
 <Question title="Як мені локалізувати URL також для SEO?">
 
 Подавайте свої сторінки з префіксом локалі (`/fr/cart`) і читайте локаль зі шляху у вашому обробнику маршруту, а не з cookie, для повного рендерингу сторінки. Фрагменти можуть продовжити використовувати cookie або заголовок. Див. [configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md) для параметрів маршрутизації та [custom URL rewrites](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/custom_url_rewrites.md).
 
 </Question>
-
 <Question title="Як я обробляю мови, які читаються справа наліво?">
 
 `getHTMLTextDir(locale)` повертає `ltr`, `rtl` або `auto`. Установіть його на документ для першого рендерингу та переналаштуйте його після заміни, як показано на кроці 8. Використовуйте логічні властивості CSS (`margin-inline-start` замість `margin-left`), щоб ваш макет слідував за ними.
 
 </Question>
-
 <Question title="Чи потрібно мені екранувати перекладені значення?">
 
 Так, для будь-чого, що ви інтерполюєте в рядок шаблону, точно як і для будь-якого іншого динамічного значення. Вміст, який надходить від CMS або від перекладача, - це не розмітка, яку ви контролюєте. Крок 5 показує мінімальний екранувач.
 
 </Question>
-
 <Question title="Чи може той же вміст обслуговувати мої відповіді API?">
 
 Так. Backend інтеграції виставляють `t()` та `getIntlayer()` для будь-якого handler, тому повідомлення об помилці, показане в toast, і label, відрендерений у fragment, походять від того самого оголошеного content. Див. керівництва [Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_express.md), [Fastify](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_fastify.md), [Hono](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_hono.md) та [Elysia](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_elysia.md).
 
 </Question>
-
 <Question title="Чи потрібно мені переміщувати мій content ключ за ключем?">
 
 Ні. Запустіть `npx intlayer extract` і Intlayer прочитає ваші вихідні файли, витягне рядки, орієнтовані на користувача, і напише файл `.content` поруч з кожним з них, тому ви переглядаєте diff замість копіювання рядків в каталог один за одним. Див. [команду extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/extract.md).
 
 </Question>
-
 <Question title="Чи можу я зберігати мої існуючі JSON файли перекладів?">
 
 Так. [sync JSON plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/plugins/sync-json.md) зберігає ваші файли `/messages/{locale}/{namespace}.json` як джерело істини та генерує словники Intlayer з них, в обох напрямках. [sync PO plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/plugins/sync-po.md) робить те ж саме для gettext каталогів, а [per locale files](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/per_locale_file.md) дозволяють вам розділити вміст за мовою замість групування локалей в один файл.
 
 </Question>
-
 <Question title="Як я автоматично перекладаю додаток за допомогою штучного інтелекту?">
 
 Запустіть `npx intlayer fill`, який заповнює відсутні переклади за допомогою LLM на ваш вибір, використовуючи вашого власного провайдера та API ключ. Додайте `--git-diff`, щоб перекладати лише вміст, змінений у гілці. Див. [команду fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/fill.md) та [інтеграцію CI/CD](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/CI_CD.md).
 
 </Question>
-
 <Question title="Чи Intlayer підтримує гендер, умови та інтерпольовані значення?">
 
 Так: [контент на основі статі](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/gender.md), умови, [перелічення](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/enumeration.md), [вставки](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/insertion.md) для інтерпольованих значень та [форматори](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/formatters.md) для чисел, дат та валют.
 
 </Question>
-
 <Question title="Які редактори та інструменти AI агентів доступні?">
 
 П'ять компонентів, всі необов'язкові:
@@ -750,7 +724,6 @@ export default config;
 - **[ESLint plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/eslint.md)**: `no-raw-text` позначає жорстко закодовані рядки.
 
 </Question>
-
 <Question title="Чи є Intlayer безкоштовним та відкритим джерелом?">
 
 Так, під ліцензією Apache 2.0, включаючи комерційне використання. Розміщена [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_CMS.md) - це опційна платна послуга, яка також може бути [самостійно розміщена](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/self_hosting.md).

package/docs/uk/intlayer_with_lynx+react.md

@@ -51,37 +51,31 @@ author: aymericzip
 Intlayer оптимізовано для ідеальної роботи з Lynx і React, пропонуючи **визначення вмісту на рівні компонентів**, **підтримку TypeScript** і всі функції, необхідні для інтернаціоналізації масштабування (i18n).
 
 </Accordion>
-
 <Accordion header="Розмір бандлу">
 
 Замість того, щоб завантажувати великі файли JSON на свої сторінки, завантажуйте лише необхідний вміст. Intlayer допомагає **зменшити розмір бандлу і сторінок до 50%**.
 
 </Accordion>
-
 <Accordion header="Підтримуваність">
 
 Організація вмісту за окремими областями (scoping) **полегшує технічне обслуговування** великомасштабних програм. Ви можете скопіювати або видалити окрему папку функцій без розумового навантаження перегляду всієї кодової бази вмісту. Крім того, Intlayer **повністю типізований (fully typed)**, щоб забезпечити точність вашого вмісту.
 
 </Accordion>
-
 <Accordion header="Агент AI">
 
 Спільне розміщення вмісту **зменшує контекст, необхідний** для великих мовних моделей (LLM). Intlayer також постачається з набором інструментів, наприклад **CLI** для перевірки відсутніх перекладів,**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** і **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/agent_skills.md)**, щоб зробити роботу розробника (DX) ще зручнішою для агентів ШІ.
 
 </Accordion>
-
 <Accordion header="Автоматизація">
 
 Використовуйте автоматизацію для перекладу в конвеєрі CI/CD за допомогою LLM за вашим вибором за рахунок вашого постачальника штучного інтелекту. Intlayer також пропонує **компілятор** для автоматизації екстракція вмісту, а також [веб-платформу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md), щоб допомогти **перекладати у фоновому режимі**.
 
 </Accordion>
-
 <Accordion header="Продуктивність">
 
 Підключення великих файлів JSON до компонентів може призвести до проблем з продуктивністю та реакцією. Intlayer оптимізує завантаження вмісту під час збірки (build time).
 
 </Accordion>
-
 <Accordion header="Співпраця з не-розробниками">
 
 Більше ніж просто рішення i18n, Intlayer пропонує **власний [візуальний редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** і **[повний CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)**, щоб допомогти вам керувати своїм багатомовним вмістом у **реальному часі**, спрощуючи співпрацю з перекладачами, копірайтерами та іншими членами команди. Контент можна зберігати локально та/або віддалено.
@@ -89,10 +83,7 @@ Intlayer оптимізовано для ідеальної роботи з Lynx
 </Accordion>
 </AccordionGroup>
 
----
-
 <Steps>
-
 <Step number={1} title="Встановлення залежностей">
 
 З вашого проєкту Lynx встановіть наступні пакети:
@@ -145,7 +136,6 @@ bun add intlayer react-intlayer lynx-intlayer
   Інтеграція для Lynx, яка надає плагін для інтеграції Intlayer з бандлером Lynx.
 
 </Step>
-
 <Step number={2} title="Створіть конфігураційний файл Intlayer">
 
 У корені вашого проєкту (або в будь-якому зручному місці) створіть **конфігураційний файл Intlayer**. Він може виглядати так:
@@ -176,7 +166,6 @@ export default config;
 - Див. [документацію конфігурації Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md) для деталей.
 
 </Step>
-
 <Step number={3} title="Додайте плагін Intlayer у збирач Lynx">
 
 Щоб використовувати Intlayer з Lynx, потрібно додати плагін у файл `lynx.config.ts`:
@@ -194,7 +183,6 @@ export default defineConfig({
 ```
 
 </Step>
-
 <Step number={4} title="Додайте провайдера Intlayer">
 
 Щоб синхронізувати мову користувача по всьому додатку, обгорніть кореневий компонент компонентом `IntlayerProvider` з `react-intlayer`.
@@ -222,7 +210,6 @@ if (import.meta.webpackHot) {
 ```
 
 </Step>
-
 <Step number={5} title="Оголосіть свій контент">
 
 Створіть **файли декларації контенту** у будь-якому місці вашого проєкту (зазвичай у `src/`), використовуючи будь-який із форматів розширень, які підтримує Intlayer:
@@ -338,7 +325,6 @@ export default appContent;
 > Детальніше про декларації контенту див. [документацію Intlayer щодо файлів контенту](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/content_file.md).
 
 </Step>
-
 <Step number={6} title="Використання Intlayer у ваших компонентах">
 
 Використайте хук `useIntlayer` у дочірніх компонентах, щоб отримувати локалізований контент.
@@ -397,7 +383,6 @@ export const App = () => {
 > Коли ви використовуєте `content.someKey` у властивостях, які очікують рядок (наприклад, `title` кнопки або `children` компонента `Text`), **викликайте `content.someKey.value`**, щоб отримати фактичний рядок.
 
 </Step>
-
 <Step number={7} title="Змінити локаль додатка">
 
 Щоб перемикати локалі зсередини ваших компонентів, ви можете використовувати метод `setLocale` хука `useLocale`:
@@ -466,8 +451,6 @@ Intlayer генерує визначення типів у прихованій
 - **Автозаповнення** для ключів вашого словника.
 - **Перевірка типів**, яка попереджає, якщо ви звертаєтеся до неіснуючого ключа або тип не відповідає.
 
----
-
 ## Конфігурація Git
 
 Щоб уникнути коміту автоматично згенерованих файлів Intlayer, додайте наступне до вашого `.gitignore`:
@@ -477,8 +460,6 @@ Intlayer генерує визначення типів у прихованій
 .intlayer
 ```
 
----
-
 ### Розширення VS Code
 
 Щоб покращити ваш досвід розробки з Intlayer, ви можете встановити офіційне **Intlayer VS Code Extension**.
@@ -494,8 +475,6 @@ Intlayer генерує визначення типів у прихованій
 
 Для детальнішої інформації про використання розширення див. документацію [Intlayer VS Code Extension](https://intlayer.org/doc/vs-code-extension).
 
----
-
 ## Додаткові можливості
 
 - **Візуальний редактор**: Використовуйте [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_visual_editor.md) для візуального керування перекладами.

package/docs/uk/intlayer_with_nestjs.md

@@ -280,25 +280,21 @@ export default config;
 Див. [чому Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/interest_of_intlayer.md).
 
 </Question>
-
 <Question title="Скільки i18n додає до розміру серверного бандла NestJS?">
 
 Значно менше, ніж традиційні каталоги JSON. Компілятор Intlayer оптимізує словники під час збирання і не парсить їх заново під час кожного запиту, зменшуючи використання пам'яті та час холодного старту. Див. [оптимізацію бандла](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/bundle_optimization.md).
 
 </Question>
-
 <Question title="Чи можу я мігрувати з nestjs-i18n без переписування обробників та сервісів?">
 
 Більшою мірою так. [sync JSON плагін](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/plugins/sync-json.md) зберігає існуючі файли, генеруючи з них словники 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).
@@ -306,7 +302,6 @@ export default config;
 Для повної автоматизації [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/compiler.md) робить те саме під час збирання та генерує словники під час кожної зміни.
 
 </Question>
-
 <Question title="Які інструменти для редактора та AI агентів доступні?">
 
 П'ять інструментів, усі опціональні:
@@ -318,61 +313,51 @@ export default config;
 - **[Плагін ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/eslint.md)**: правило `no-raw-text` відстежує жорстко закодовані рядки.
 
 </Question>
-
 <Question title="Як визначається мова клієнта у вхідних запитах?">
 
 Інтерцептор або middleware NestJS обробляє заголовки та cookie, прив'язуючи локаль до контексту запиту.
 
 </Question>
-
 <Question title="Чи можуть одні й ті самі оголошення контенту обслуговувати відповіді API та веб-інтерфейс?">
 
 Так, у монорепозиторіях або спільних пакетах це є ключовою перевагою. Оголошений словник можна імпортувати як на бекенді (листи, помилки, відповіді API), так і на фронтенді (React, Vue, Svelte тощо), зберігаючи єдине джерело істини для всіх текстів.
 
 </Question>
-
 <Question title="Чи сповільнює Intlayer обробку запитів?">
 
 Ні. Визначення локалі відбувається у швидкому middleware (читаються cookie, параметри або заголовок Accept-Language). Словники скомпільовані під час збирання та знаходяться в пам'яті, тому під час запиту немає читання з диска чи парсингу рядків.
 
 </Question>
-
 <Question title="Як локалізувати повідомлення про помилки, електронні листи та push-сповіщення?">
 
 Викликаючи функцію `getIntlayer` або `t()` з урахуванням локалі запиту. Якщо мова користувача зберігається у базі даних, у фонових завданнях цільову мову можна передати у функцію явно.
 
 </Question>
-
 <Question title="Як Intlayer працює з Dependency Injection (DI) у NestJS?">
 
 Сервіси та інтерцептори Intlayer можна інжектувати в IoC-контейнер NestJS, що забезпечує легкий доступ до активної мови в контролерах та провайдерах.
 
 </Question>
-
 <Question title="Чи можу я локалізувати повідомлення валідації NestJS DTO?">
 
 Так. У кастомних декораторах `class-validator` або фільтрах винятків ви можете викликати `t()` або `getIntlayer()`.
 
 </Question>
-
 <Question title="Як автоматично перекласти додаток за допомогою AI?">
 
 Запустіть `npx intlayer fill`. Утиліта заповнює відсутні переклади через обрану LLM з вашим провайдером та ключем API, а прапорець `--git-diff` обмежує обробку зміненими файлами. Див. [команду fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/fill.md) та [інтеграцію CI/CD](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/CI_CD.md).
 
 </Question>
-
 <Question title="Чи підтримує Intlayer форми множини, стать та форматований текст (rich text)?">
 
 Так: [форми множини](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/plurial.md), [контент з урахуванням статі](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/gender.md), умови, [вставки (insertions)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/insertion.md) та [форматування](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/formatters.md).
 
 </Question>
-
 <Question title="Як нетехнічні члени команди можуть редагувати шаблони листів та повідомлення про помилки без доступу до коду?">
 
 Є два шляхи: [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_CMS.md), яка відокремлює вміст від кодової бази і дозволяє редагувати тексти через веб-інтерфейс, або [візуальний редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_visual_editor.md), який записує зміни безпосередньо у файли коду.
 
 </Question>
-
 <Question title="Чи є Intlayer безкоштовним та відкритим кодом?">
 
 Так, під ліцензією Apache 2.0, включно з комерційним використанням. Хмарна CMS - це додаткова платна послуга, яку також можна [розгорнути самостійно (self-host)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/self_hosting.md).

package/docs/uk/intlayer_with_next-i18next.md

@@ -40,8 +40,6 @@ author: aymericzip
 > Примітка: next-i18next побудований поверх i18next. Цей посібник використовує примітиви i18next, сумісні з next-i18next в App Router, одночасно зберігаючи архітектуру простою та готовою до продакшену.
 > Для ширшого порівняння див. [next-i18next vs next-intl vs Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/uk/next-i18next_vs_next-intl_vs_intlayer.md).
 
----
-
 ## 1) Структура проєкту
 
 Встановіть залежності next-i18next:
@@ -93,8 +91,6 @@ bun add next-i18next i18next react-i18next i18next-resources-to-backend
 - Не централізуйте повідомлення надто; використовуйте невеликі простори імен (namespaces), орієнтовані на сторінку чи feature
 - Уникайте імпорту всіх локалей одночасно; завантажуйте лише те, що потрібно
 
----
-
 ## 2) Встановлення залежностей
 
 ```bash
@@ -107,8 +103,6 @@ pnpm add i18next react-i18next i18next-resources-to-backend
 pnpm add next-i18next
 ```
 
----
-
 ## 3) Основна конфігурація i18n
 
 Визначте локалі, локаль за замовчуванням, RTL та допоміжні функції для локалізованих шляхів/URL.
@@ -135,8 +129,6 @@ export function abs(locale: string, path: string) {
 
 Примітка: Якщо ви використовуєте `next-i18next.config.js`, тримайте його узгодженим з `i18n.config.ts`, щоб уникнути розходжень.
 
----
-
 ## 4) Ініціалізація i18n на сервері
 
 Ініціалізуйте i18next на сервері з динамічним бекендом, який імпортує лише потрібні JSON для локалі та namespace.
@@ -175,8 +167,6 @@ export async function initI18next(
 
 Проміжна примітка: Тримайте список неймспейсів коротким для кожної сторінки, щоб обмежити обсяг передаваних даних. Уникайте глобальних «catch-all» бандлів.
 
----
-
 ## 5) Клієнтський провайдер для React-компонентів
 
 Оберніть клієнтські компоненти провайдером, який відповідає конфігурації сервера й завантажує лише запитані namespaces.
@@ -233,8 +223,6 @@ export default function I18nProvider({
 
 Порада для початківців: Не потрібно передавати всі повідомлення на клієнт. Почніть лише з namespaces сторінки.
 
----
-
 ## 6) Локалізований layout та routes
 
 Встановіть мову й напрям тексту, та попередньо згенеруйте маршрути для кожної локалі, щоб віддати перевагу статичному рендерингу.
@@ -270,8 +258,6 @@ export default function LocaleLayout({
 }
 ```
 
----
-
 ## 7) Приклад сторінки з використанням сервера та клієнта
 
 ```tsx fileName="src/app/[locale]/about.tsx"
@@ -388,8 +374,6 @@ const ServerComponent = ({ t, locale, count }: ServerComponentProps) => {
 export default ServerComponent;
 ```
 
----
-
 ## 8) SEO: Метадані, Hreflang, Sitemap, Robots
 
 Переклад контенту, це спосіб розширити охоплення. Ретельно налаштуйте багатомовне SEO.
@@ -483,8 +467,6 @@ export default function robots(): MetadataRoute.Robots {
 }
 ```
 
----
-
 ## 9) Middleware для маршрутизації локалі
 
 Виявляє локаль і перенаправляє на локалізований маршрут, якщо він відсутній.
@@ -527,8 +509,6 @@ export const config = {
 };
 ```
 
----
-
 ## 10) Кращі практики продуктивності та DX
 
 - **Встановіть атрибути html `lang` і `dir`**: Зроблено в `src/app/[locale]/layout.tsx`.
@@ -539,8 +519,6 @@ export const config = {
 - **Застосовуйте memoization для важких операцій**: Особливо в клієнтському коді для старіших версій React.
 - **Кеш і заголовки**: Віддавайте перевагу статичному рендерингу або `revalidate` замість динамічного, коли це можливо.
 
----
-
 ## 11) Тестування та CI
 
 - Додайте юніт-тести для компонентів, що використовують `t`, щоб переконатися, що ключі існують.
@@ -549,8 +527,6 @@ export const config = {
 
 Intlayer автоматизує більшість цього (див. наступний розділ).
 
----
-
 ## 12) Додайте Intlayer зверху (автоматизація)
 
 Intlayer допомагає синхронізувати JSON-переклади, перевіряти відсутні ключі та за потреби заповнювати їх за допомогою AI.
@@ -636,8 +612,6 @@ export default config;
 
 > Ви можете передавати аргументи CLI; див. [документацію Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/index.md).
 
----
-
 ## 13) Усунення неполадок
 
 - **Ключі не знайдені**: Переконайтесь, що сторінка/провайдер перераховують правильні простори імен (namespaces) і файл JSON існує за шляхом `src/locales/<locale>/<namespace>.json`.
@@ -646,8 +620,6 @@ export default config;
 - **Відсутні SEO alternates**: Підтвердіть, що `alternates.languages` включає всі локалі та `x-default`.
 - **Занадто великі бандли**: Розбивайте namespaces ще дрібніше та уникайте імпорту цілих дерев `locales` на клієнті.
 
----
-
 ## 14) Що далі
 
 - Додайте більше локалей та namespaces у міру розвитку функціоналу (features)