@intlayer/docs 8.9.8 → 8.10.0-canary.0

package/docs/uk/configuration.md

@@ -606,7 +606,7 @@ export default config;
 | ----------------- | --------------------------------------------------------------------------------------------- | ---------- | ------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `locales`         | Список підтримуваних локалей у додатку.                                                       | `string[]` | `[Locales.ENGLISH]` | `['en', 'fr', 'es']` |                                                                                                                                                                                                                                                                                                                        |
 | `requiredLocales` | Список обов'язкових локалей у додатку.                                                        | `string[]` | `[]`                | `[]`                 | • Якщо порожній, усі локалі обов'язкові в режимі `strict`.<br/>• Переконайтеся, що обов'язкові локалі також визначені в полі `locales`.                                                                                                                                                                                |
-| `strictMode`      | Забезпечує суворе впровадження інтернаціоналізованого контенту за допомогою TypeScript.       | `string`   | `'inclusive'`       |                      | • Якщо `"strict"`: Обов'язкове визначення кожної оголошеної локалі для функції `t` — помилка в разі відсутності або неоголошеної локалі.<br/>• Якщо `"inclusive"`: Попередження для відсутніх локалей, але дозволяє використання існуючих неоголошених локалей.<br/>• Якщо `"loose"`: Приймає будь-яку існуючу локаль. |
+| `strictMode`      | Забезпечує суворе впровадження інтернаціоналізованого контенту за допомогою TypeScript.       | `string`   | `'inclusive'`       |                      | • Якщо `"strict"`: Обов'язкове визначення кожної оголошеної локалі для функції `t` - помилка в разі відсутності або неоголошеної локалі.<br/>• Якщо `"inclusive"`: Попередження для відсутніх локалей, але дозволяє використання існуючих неоголошених локалей.<br/>• Якщо `"loose"`: Приймає будь-яку існуючу локаль. |
 | `defaultLocale`   | Локаль за замовчуванням, яка використовується як резервна, якщо запитувана локаль недоступна. | `string`   | `Locales.ENGLISH`   | `'en'`               | Використовується для визначення локалі, якщо її не вказано в URL, файлах cookie або заголовку.                                                                                                                                                                                                                         |
 
 ---
@@ -640,9 +640,9 @@ export default config;
 | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `mode`     | Режим структури URL для керування локаллю.                                                                                                                                                                      | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (en) або `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard` . `'no-prefix'`: локаль керується іншим способом. `'search-params'`: `/dashboard?locale=fr` | Не впливає на керування файлами cookie або локальне сховище.                                                                                                                                                                                                                                     |
 | `storage`  | Конфігурація для зберігання локалі на клієнті.                                                                                                                                                                  | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                             | Див. таблицю параметрів зберігання нижче.                                                                                                                                                                                                                                                        |
-| `basePath` | Базовий шлях для URL додатка.                                                                                                                                                                                   | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                    | Якщо ваш додаток знаходиться за адресою `https://example.com/my-app`, basePath — `'/my-app'`, що вказує на URL `https://example.com/my-app/en` .                                                                                                                                                 |
+| `basePath` | Базовий шлях для URL додатка.                                                                                                                                                                                   | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                    | Якщо ваш додаток знаходиться за адресою `https://example.com/my-app`, basePath - `'/my-app'`, що вказує на URL `https://example.com/my-app/en` .                                                                                                                                                 |
 | `rewrite`  | Власні правила перенаправлення URL для зміни стандартного режиму маршрутизації для певних шляхів. Підтримує динамічні параметри `[param]`.                                                                      | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | Див. приклад нижче                                                                                                                                                                             | • Правила перенаправлення мають вищий пріоритет, ніж `mode`.<br/>• Працює з Next.js та Vite.<br/>• `getLocalizedUrl()` автоматично застосовує відповідні правила.<br/>• Див. [Власні перенаправлення URL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md). |
-| `domains`  | Відображає локалі на імена хостів доменів для маршрутизації на основі доменів. Якщо встановлено, URL для цієї локалі використовують цей домен як базу (абсолютний URL), і префікс локалі не додається до шляху. | `Partial<Record<Locale, string>>`                                                                                                                                                                            | `undefined`            | `{ zh: 'intlayer.zh', fr: 'intlayer.org' }`                                                                                                                                                    | • Протокол за замовчуванням — `https://`, якщо він не вказаний у імені хоста.<br/>• Сам домен ідентифікує локаль, тому префікс `/zh/` не додається.<br/>• `getLocalizedUrl('/', 'zh')` повертає `https://intlayer.zh/`.                                                                          |
+| `domains`  | Відображає локалі на імена хостів доменів для маршрутизації на основі доменів. Якщо встановлено, URL для цієї локалі використовують цей домен як базу (абсолютний URL), і префікс локалі не додається до шляху. | `Partial<Record<Locale, string>>`                                                                                                                                                                            | `undefined`            | `{ zh: 'intlayer.zh', fr: 'intlayer.org' }`                                                                                                                                                    | • Протокол за замовчуванням - `https://`, якщо він не вказаний у імені хоста.<br/>• Сам домен ідентифікує локаль, тому префікс `/zh/` не додається.<br/>• `getLocalizedUrl('/', 'zh')` повертає `https://intlayer.zh/`.                                                                          |
 
 **Приклад `rewrite`**:
 
@@ -670,10 +670,10 @@ routing: {
 
 | Значення           | Примітки                                                                                                                                                                                                       | Опис                                                                      |
 | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
-| `'cookie'`         | • Забезпечте належну згоду користувача відповідно до GDPR.<br/>• Можна налаштувати через `CookiesAttributes` (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`).                     | Зберігає локаль у файлі cookie — доступно і на клієнті, і на сервері.     |
-| `'localStorage'`   | • Термін дії не закінчується, поки не буде видалено явно.<br/>• Intlayer Proxy не має доступу до нього.<br/>• Можна налаштувати через `StorageAttributes` (`{ type: 'localStorage', name: 'custom-locale' }`). | Зберігає локаль у браузері без терміну дії — лише клієнтська частина.     |
-| `'sessionStorage'` | • Видаляється при закритті вкладки/вікна браузера.<br/>• Intlayer Proxy не має доступу до нього.<br/>• Можна налаштувати через `StorageAttributes` (`{ type: 'sessionStorage', name: 'custom-locale' }`).      | Зберігає локаль на час сесії сторінки — лише клієнтська частина.          |
-| `'header'`         | • Корисно для викликів API.<br/>• Клієнтська частина не має доступу до нього.<br/>• Можна налаштувати через `StorageAttributes` (`{ type: 'header', name: 'custom-locale' }`).                                 | Зберігає або передає локаль через HTTP-заголовки — лише серверна частина. |
+| `'cookie'`         | • Забезпечте належну згоду користувача відповідно до GDPR.<br/>• Можна налаштувати через `CookiesAttributes` (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`).                     | Зберігає локаль у файлі cookie - доступно і на клієнті, і на сервері.     |
+| `'localStorage'`   | • Термін дії не закінчується, поки не буде видалено явно.<br/>• Intlayer Proxy не має доступу до нього.<br/>• Можна налаштувати через `StorageAttributes` (`{ type: 'localStorage', name: 'custom-locale' }`). | Зберігає локаль у браузері без терміну дії - лише клієнтська частина.     |
+| `'sessionStorage'` | • Видаляється при закритті вкладки/вікна браузера.<br/>• Intlayer Proxy не має доступу до нього.<br/>• Можна налаштувати через `StorageAttributes` (`{ type: 'sessionStorage', name: 'custom-locale' }`).      | Зберігає локаль на час сесії сторінки - лише клієнтська частина.          |
+| `'header'`         | • Корисно для викликів API.<br/>• Клієнтська частина не має доступу до нього.<br/>• Можна налаштувати через `StorageAttributes` (`{ type: 'header', name: 'custom-locale' }`).                                 | Зберігає або передає локаль через HTTP-заголовки - лише серверна частина. |
 
 #### Атрибути Cookie (Cookies Attributes)
 
@@ -861,7 +861,7 @@ export default config;
 | `location`                  | Вказує на місце зберігання файлів словників та спосіб їх синхронізації з CMS.                                                                  | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`        | `'hybrid'`                                                                                  | • `'local'`: Тільки локальне керування.<br/>• `'remote'`: Тільки віддалене керування (CMS).<br/>• `'hybrid'`: І локальне, і віддалене керування.<br/>• `'plugin'` або власні рядки: Керування через плагін або власне джерело.                                                                                                                                                                                      |
 | `importMode`                | Керує способом імпорту словників.                                                                                                              | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`       | `'dynamic'`                                                                                 | • `'static'`: Статичний імпорт.<br/>• `'dynamic'`: Динамічний імпорт через Suspense.<br/>• `'fetch'`: Отримання через Live Sync API; резервний варіант `'dynamic'` у разі помилки.<br/>• Потрібні плагіни `@intlayer/babel` та `@intlayer/swc`.<br/>• Ключі мають бути оголошені статично.<br/>• Ігнорується, якщо `optimize` вимкнено.<br/>• Не впливає на `getIntlayer`, `getDictionary` тощо.                    |
 | `priority`                  | Пріоритет словника. При вирішенні конфліктів між словниками вище значення має перевагу перед нижчим.                                           | `number`                                                                                                        | `undefined`      | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                     |
-| `live`                      | ЗАСТАРІЛО — використовуйте `importMode: 'fetch'`. Раніше вказувало, чи слід отримувати контент словника динамічно через Live Sync API.         | `boolean`                                                                                                       | `undefined`      |                                                                                             | Перейменовано на `importMode: 'fetch'` у v8.0.0.                                                                                                                                                                                                                                                                                                                                                                    |
+| `live`                      | ЗАСТАРІЛО - використовуйте `importMode: 'fetch'`. Раніше вказувало, чи слід отримувати контент словника динамічно через Live Sync API.         | `boolean`                                                                                                       | `undefined`      |                                                                                             | Перейменовано на `importMode: 'fetch'` у v8.0.0.                                                                                                                                                                                                                                                                                                                                                                    |
 | `schema`                    | Генерується автоматично Intlayer для валідації JSON-схеми.                                                                                     | `'https://intlayer.org/schema.json'`                                                                            | Генерується      |                                                                                             | Не редагуйте вручну.                                                                                                                                                                                                                                                                                                                                                                                                |
 | `title`                     | Допомагає ідентифікувати словники в редакторі та CMS.                                                                                          | `string`                                                                                                        | `undefined`      | `'User Profile'`                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                                     |
 | `tags`                      | Класифікує словники та надає контекст або інструкції для редактора та AI.                                                                      | `string[]`                                                                                                      | `undefined`      | `['user', 'profile']`                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                     |

package/docs/uk/custom_domains.md

@@ -34,8 +34,8 @@ Intlayer підтримує маршрутизацію локалей на ос
 
 Ключова відмінність полягає в **ексклюзивності**:
 
-- **Ексклюзивний домен** — лише одна локаль відображається на це ім'я хоста (наприклад, `zh → intlayer.zh`). Сам домен ідентифікує локаль, тому префікс локалі не додається до шляху. `https://intlayer.zh/about` обслуговує китайський контент.
-- **Спільний домен** — кілька локалей відображаються на одне й те саме ім'я хоста (наприклад, і `en`, і `fr` відображаються на `intlayer.org`). Застосовується звичайна маршрутизація на основі префіксів. `intlayer.org/fr/about` обслуговує французький контент.
+- **Ексклюзивний домен** - лише одна локаль відображається на це ім'я хоста (наприклад, `zh → intlayer.zh`). Сам домен ідентифікує локаль, тому префікс локалі не додається до шляху. `https://intlayer.zh/about` обслуговує китайський контент.
+- **Спільний домен** - кілька локалей відображаються на одне й те саме ім'я хоста (наприклад, і `en`, і `fr` відображаються на `intlayer.org`). Застосовується звичайна маршрутизація на основі префіксів. `intlayer.org/fr/about` обслуговує французький контент.
 
 ## Конфігурація
 
@@ -55,9 +55,9 @@ const config: IntlayerConfig = {
   routing: {
     mode: "prefix-no-default",
     domains: {
-      // Спільний домен — en та fr використовують префіксну маршрутизацію на intlayer.org
+      // Спільний домен - en та fr використовують префіксну маршрутизацію на intlayer.org
       en: "intlayer.org",
-      // Ексклюзивний домен — zh має власне ім'я хоста, префікс /zh/ не потрібен
+      // Ексклюзивний домен - zh має власне ім'я хоста, префікс /zh/ не потрібен
       zh: "intlayer.zh",
     },
   },
@@ -96,7 +96,7 @@ getLocalizedUrl("/about", "zh", { currentDomain: "intlayer.org" });
 ```ts
 // Поточна сторінка: intlayer.zh/about
 getLocalizedUrl("/about", "zh", { currentDomain: "intlayer.zh" });
-// → "/about"  (вже на правильному домені — відносний URL)
+// → "/about"  (вже на правильному домені - відносний URL)
 
 getLocalizedUrl("/about", "fr", { currentDomain: "intlayer.zh" });
 // → "https://intlayer.org/fr/about"  (міждоменне посилання назад на intlayer.org)
@@ -108,14 +108,14 @@ getLocalizedUrl("/about", "fr", { currentDomain: "intlayer.zh" });
 
 1. Ім'я хоста з абсолютного вхідного URL (наприклад, `https://intlayer.org/about` → `intlayer.org`).
 2. `window.location.hostname` у браузерному середовищі.
-3. Якщо жоден з варіантів не доступний (SSR без явно вказаного параметра), повертається відносний URL для локалей на тому самому домені, а абсолютний URL не створюється — це безпечний резервний варіант.
+3. Якщо жоден з варіантів не доступний (SSR без явно вказаного параметра), повертається відносний URL для локалей на тому самому домені, а абсолютний URL не створюється - це безпечний резервний варіант.
 
 ```ts
-// Браузер — window.location.hostname === 'intlayer.org'
+// Браузер - window.location.hostname === 'intlayer.org'
 getLocalizedUrl("/about", "zh");
 // → "https://intlayer.zh/about"  (автоматично визначено з window)
 
-// З абсолютного URL — домен визначено автоматично
+// З абсолютного URL - домен визначено автоматично
 getLocalizedUrl("https://intlayer.org/about", "zh");
 // → "https://intlayer.zh/about"
 ```
@@ -151,14 +151,14 @@ export const config = {
 };
 ```
 
-**Перенаправлення (Redirect)** — запит надходить на неправильний домен для даного префікса локалі:
+**Перенаправлення (Redirect)** - запит надходить на неправильний домен для даного префікса локалі:
 
 ```
 GET intlayer.org/zh/about
 → 301 https://intlayer.zh/about
 ```
 
-**Перезапис (Rewrite)** — запит надходить на ексклюзивний домен локалі без префікса:
+**Перезапис (Rewrite)** - запит надходить на ексклюзивний домен локалі без префікса:
 
 ```
 GET intlayer.zh/about
@@ -209,7 +209,7 @@ export const LocaleSwitcher = () => {
 };
 ```
 
-Жодних додаткових налаштувань не потрібно — `useLocale` внутрішньо визначає `window.location.hostname` і обирає між `router.replace` (той самий домен) та `window.location.href` (інший домен).
+Жодних додаткових налаштувань не потрібно - `useLocale` внутрішньо визначає `window.location.hostname` і обирає між `router.replace` (той самий домен) та `window.location.href` (інший домен).
 
 ## SEO: альтернативні посилання `hreflang`
 
@@ -247,4 +247,4 @@ export const generateMetadata = (): Metadata => {
 | ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
 | `getLocalizedUrl(url, locale, { currentDomain })` | Повертає відносний або абсолютний URL залежно від того, чи знаходиться цільова локаль на поточному домені. |
 | `getMultilingualUrls(url, { currentDomain })`     | Повертає карту локалізованих URL за ключем локалі, змішуючи відносні та абсолютні за потреби.              |
-| `getPrefix(locale, { domains })`                  | Повертає порожній префікс для локалей з ексклюзивним доменом, інакше — звичайний префікс.                  |
+| `getPrefix(locale, { domains })`                  | Повертає порожній префікс для локалей з ексклюзивним доменом, інакше - звичайний префікс.                  |

package/docs/uk/dictionary/content_file.md

@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 8.10.0
+    date: 2026-05-19
+    changes: "Додано підтримку форматів файлів YAML та Markdown"
   - version: 8.9.0
     date: 2026-05-12
     changes: "Add `plural` content node type"
@@ -808,6 +811,40 @@ export default {
 }
 ```
 
+### Файл вмісту в форматі Markdown
+
+```markdown
+---
+key: welcome-page
+locale: en
+title: Welcome Page Content
+description: Content for the main welcome page
+tags:
+  - page
+  - welcome
+---
+
+# Welcome to Our Platform
+
+## Build amazing applications with ease
+```
+
+### Файл вмісту в форматі YAML
+
+```yaml
+key: welcome-page
+title: Welcome Page Content
+description: Content for the main welcome page
+locale: "en"
+tags:
+  - page
+  - welcome
+content:
+  hero:
+    title: Welcome to Our Platform
+    subtitle: Build amazing applications with ease
+```
+
 ### Файли вмісту для кожної локалі
 
 Для словників по локалях вкажіть властивість `locale`:
@@ -859,6 +896,10 @@ Intlayer дозволяє налаштовувати розширення фай
 - `.content.mjx`
 - `.content.cjs`
 - `.content.cjx`
+- `.content.md`
+- `.content.mdx`
+- `.content.yaml`
+- `.content.yml`
 
 Ці стандартні розширення підходять для більшості застосунків. Однак якщо у вас є спеціальні вимоги, ви можете визначити власні розширення, щоб оптимізувати процес збірки та зменшити ризик конфліктів з іншими компонентами.
 

package/docs/uk/dictionary/markdown.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2026-01-22
+updatedAt: 2026-05-19
 title: Markdown
 description: Дізнайтеся, як оголошувати та використовувати контент Markdown на вашому багатомовному веб-сайті за допомогою Intlayer. Дотримуйтесь кроків у цій онлайн-документації, щоб легко інтегрувати Markdown у ваш проєкт.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - content
   - markdown
 history:
+  - version: 8.10.0
+    date: 2026-05-19
+    changes: "Додано підтримку файлів `.content.md`"
   - version: 8.5.0
     date: 2026-03-24
     changes: "Add `intlayerMarkdown` plugin object; use `app.use(intlayerMarkdown)` instead of `app.use(installIntlayerMarkdown)`"
@@ -43,6 +46,38 @@ Intlayer підтримує контент rich text, визначений за
 Ви можете оголосити контент Markdown за допомогою функції `md` або просто як рядок (якщо він містить синтаксис Markdown).
 
 <Tabs>
+  <Tab label=".content.md" value=".content.md">
+    Починаючи з версії `8.10.0`, ви можете оголошувати контент Markdown безпосередньо у файлах `.content.md`. Intlayer автоматично виявить та розбере контент Markdown.
+
+    ```md fileName="markdown-file.uk.content.md"
+    ---
+    key: my-markdown-content
+    description: Мій контент
+    locale: uk
+    ---
+
+    # Мій контент
+
+    Ось приклад контенту markdown
+    ```
+
+    Поле `locale` у frontmatter визначає локаль контенту. Це поле є необов'язковим. Якщо його не вказано, Intlayer використовуватиме локаль за замовчуванням, яка також використовується як резервна (fallback) локаль, якщо переклад для конкретної локалі відсутній.
+
+    Приклад структури файлів:
+
+    ```text
+    content/
+    ├── en/
+    │   └── markdown-file.en.content.md
+    ├── fr/
+    │   └── markdown-file.fr.content.md
+    └── es/
+        └── markdown-file.es.content.md
+    ```
+
+    Ви можете додати у front-matter будь-які властивості, визначені у [Визначенні словника (Dictionary definition)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/content_file.md)
+
+  </Tab>
   <Tab label="Ручне обгортання" value="manual-wrapping">
     Використовуйте функцію `md` для явного оголошення контенту Markdown. Це корисно, якщо ви хочете переконатися, що рядок розглядається як Markdown, навіть якщо він не містить очевидного синтаксису.
 

package/docs/uk/interest_of_intlayer.md

@@ -28,7 +28,7 @@ history:
 
 ## Що таке Intlayer?
 
-**Intlayer** — це бібліотека інтернаціоналізації, розроблена спеціально для розробників JavaScript. Вона дозволяє оголошувати ваш вміст у будь-якому місці вашого коду. Вона перетворює оголошення багатомовного вмісту на структуровані словники для легкої інтеграції у ваш код. Використовуючи TypeScript, **Intlayer** робить вашу розробку більш надійною та ефективною.
+**Intlayer** - це бібліотека інтернаціоналізації, розроблена спеціально для розробників JavaScript. Вона дозволяє оголошувати ваш вміст у будь-якому місці вашого коду. Вона перетворює оголошення багатомовного вмісту на структуровані словники для легкої інтеграції у ваш код. Використовуючи TypeScript, **Intlayer** робить вашу розробку більш надійною та ефективною.
 
 ## Чому був створений Intlayer?
 
@@ -198,7 +198,7 @@ export const ComponentExample = () => {
 
 | Функція                                            | `intlayer`                                                                                                                           | `react-i18next`                                                                                          | `react-intl` (FormatJS)                                                                                                     | `lingui`                                                          | `next-intl`                                                                                      | `next-i18next`                                                                                   | `vue-i18n`                                                        |
 | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------- |
-| **Переклади поруч із компонентами**                | ✅ Так, вміст розміщено разом із кожним компонентом                                                                                  | ❌ Ні                                                                                                    | ❌ Ні                                                                                                                       | ❌ Ні                                                             | ❌ Ні                                                                                            | ❌ Ні                                                                                            | ✅ Так — за умови використання `Single File Components` (SFCs)    |
+| **Переклади поруч із компонентами**                | ✅ Так, вміст розміщено разом із кожним компонентом                                                                                  | ❌ Ні                                                                                                    | ❌ Ні                                                                                                                       | ❌ Ні                                                             | ❌ Ні                                                                                            | ❌ Ні                                                                                            | ✅ Так - за умови використання `Single File Components` (SFCs)    |
 | **Інтеграція TypeScript**                          | ✅ Просунута, автоматично згенеровані строгі типи                                                                                    | ⚠️ Базова; потрібна додаткова конфігурація для безпеки                                                   | ✅ Добре, але менш строго                                                                                                   | ⚠️ Типізація, потрібна конфігурація                               | ✅ Добре                                                                                         | ⚠️ Базова                                                                                        | ✅ Добре (типи доступні; безпека ключів потребує налаштування)    |
 | **Виявлення відсутніх перекладів**                 | ✅ Підсвічування помилок TypeScript та помилки/попередження під час збірки                                                           | ⚠️ Переважно рядки відкату (fallback) під час виконання                                                  | ⚠️ Рядки відкату                                                                                                            | ⚠️ Потрібна додаткова конфігурація                                | ⚠️ Відкат під час виконання                                                                      | ⚠️ Відкат під час виконання                                                                      | ⚠️ Відкат/попередження під час виконання (можна налаштувати)      |
 | **Багатий вміст (JSX/Markdown/компоненти)**        | ✅ Пряма підтримка                                                                                                                   | ⚠️ Обмежено / лише інтерполяція                                                                          | ⚠️ Синтаксис ICU, не справжній JSX                                                                                          | ⚠️ Обмежено                                                       | ❌ Не розраховано на багаті вузли                                                                | ⚠️ Обмежено                                                                                      | ⚠️ Обмежено (компоненти через `<i18n-t>`, Markdown через плагіни) |

package/docs/uk/intlayer_with_analog.md

@@ -44,7 +44,7 @@ history:
 <iframe
   src="https://intlayer-analog-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Демо — intlayer-analog-template"
+  title="Демо - intlayer-analog-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/uk/intlayer_with_angular.md

@@ -65,7 +65,7 @@ history:
 <iframe
   src="https://intlayer-angular-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Демо — intlayer-angular-template"
+  title="Демо - intlayer-angular-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/uk/intlayer_with_astro.md

@@ -48,7 +48,7 @@ history:
 <iframe
   src="https://intlayer-astro-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Демо — intlayer-astro-template"
+  title="Демо - intlayer-astro-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -62,7 +62,7 @@ history:
 
 ## Що таке Intlayer?
 
-**Intlayer** — це інноваційна бібліотека інтернаціоналізації (i18n) з відкритим вихідним кодом, розроблена для спрощення підтримки багатьох мов у сучасних веб-додатках.
+**Intlayer** - це інноваційна бібліотека інтернаціоналізації (i18n) з відкритим вихідним кодом, розроблена для спрощення підтримки багатьох мов у сучасних веб-додатках.
 
 З Intlayer ви можете:
 

package/docs/uk/intlayer_with_astro_lit.md

@@ -47,7 +47,7 @@ history:
 <iframe
   src="https://intlayer-astro-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Демо — intlayer-astro-template"
+  title="Демо - intlayer-astro-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -61,7 +61,7 @@ history:
 
 ## Що таке Intlayer?
 
-**Intlayer** — це інноваційна бібліотека інтернаціоналізації (i18n) з відкритим вихідним кодом, розроблена для спрощення підтримки багатьох мов у сучасних веб-додатках.
+**Intlayer** - це інноваційна бібліотека інтернаціоналізації (i18n) з відкритим вихідним кодом, розроблена для спрощення підтримки багатьох мов у сучасних веб-додатках.
 
 З Intlayer ви можете:
 
@@ -262,7 +262,7 @@ const { greeting } = getIntlayer("lit-demo", locale);
     />
   </head>
   <body>
-    <!-- Lit custom element — приймає мову, визначену сервером, як атрибут -->
+    <!-- Lit custom element - приймає мову, визначену сервером, як атрибут -->
     <lit-demo locale={locale}></lit-demo>
   </body>
 </html>

package/docs/uk/intlayer_with_astro_preact.md

@@ -46,7 +46,7 @@ history:
 <iframe
   src="https://intlayer-astro-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Демо — intlayer-astro-template"
+  title="Демо - intlayer-astro-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -60,7 +60,7 @@ history:
 
 ## Що таке Intlayer?
 
-**Intlayer** — це інноваційна бібліотека інтернаціоналізації (i18n) з відкритим вихідним кодом, розроблена для спрощення підтримки багатьох мов у сучасних веб-додатках.
+**Intlayer** - це інноваційна бібліотека інтернаціоналізації (i18n) з відкритим вихідним кодом, розроблена для спрощення підтримки багатьох мов у сучасних веб-додатках.
 
 З Intlayer ви можете:
 
@@ -110,7 +110,7 @@ bun x intlayer init
   Плагін інтеграції Astro для зв'язку Intlayer з [бандлером Vite](https://vite.dev/guide/why.html#why-bundle-for-production); він також включає middleware для визначення бажаної мови користувача, керування cookie та обробки перенаправлень URL.
 
 - **preact**
-  Основний пакет Preact — швидка і легка альтернатива React.
+  Основний пакет Preact - швидка і легка альтернатива React.
 
 - **preact-intlayer**
   Пакет для інтеграції Intlayer у додатки Preact. Він надає `IntlayerProvider`, а також хуки `useIntlayer` та `useLocale` для інтернаціоналізації в Preact.
@@ -365,7 +365,7 @@ export const LocaleSwitcher: FunctionalComponent = () => {
 > **Примітка щодо стійкості:**
 > Використання `onLocaleChange` para redicuicamiento через `window.location.href` garantiza відвідування нової URL-адреси з мовним префіксом. Це дозволяє middleware Intlayer встановити cookie мови та запам'ятати вибір користувача для майбутніх візитів.
 
-> `LocaleSwitcher` повинен рендеритися всередині `IntlayerProvider` — використовуйте його у вашому компоненті island (як показано на кроці 6).
+> `LocaleSwitcher` повинен рендеритися всередині `IntlayerProvider` - використовуйте його у вашому компоненті island (як показано на кроці 6).
 
 ### Крок 8: Sitemap та Robots.txt
 

package/docs/uk/intlayer_with_astro_react.md

@@ -49,7 +49,7 @@ history:
 <iframe
   src="https://intlayer-astro-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Демо — intlayer-astro-template"
+  title="Демо - intlayer-astro-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -63,7 +63,7 @@ history:
 
 ## Що таке Intlayer?
 
-**Intlayer** — це інноваційна бібліотека інтернаціоналізації (i18n) з відкритим вихідним кодом, розроблена для спрощення підтримки багатьох мов у сучасних веб-додатках.
+**Intlayer** - це інноваційна бібліотека інтернаціоналізації (i18n) з відкритим вихідним кодом, розроблена для спрощення підтримки багатьох мов у сучасних веб-додатках.
 
 З Intlayer ви можете:
 
@@ -361,7 +361,7 @@ export function LocaleSwitcher() {
 > **Примітка щодо стійкості:**
 > Використання `onLocaleChange` для перенаправлення через `window.location.href` гарантує відвідування нової URL-адреси з мовним префіксом. Це дозволяє middleware Intlayer встановити cookie мови та запам'ятати вибір користувача для майбутніх візитів.
 
-> `LocaleSwitcher` повинен рендеритися всередині `IntlayerProvider` — використовуйте його у вашому компоненті island (як показано на кроці 6).
+> `LocaleSwitcher` повинен рендеритися всередині `IntlayerProvider` - використовуйте його у вашому компоненті island (як показано на кроці 6).
 
 ### Крок 8: Sitemap та Robots.txt
 

package/docs/uk/intlayer_with_astro_solid.md

@@ -46,7 +46,7 @@ history:
 <iframe
   src="https://intlayer-astro-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Демо — intlayer-astro-template"
+  title="Демо - intlayer-astro-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -60,7 +60,7 @@ history:
 
 ## Що таке Intlayer?
 
-**Intlayer** — це інноваційна бібліотека інтернаціоналізації (i18n) з відкритим вихідним кодом, розроблена для спрощення підтримки багатьох мов у сучасних веб-додатках.
+**Intlayer** - це інноваційна бібліотека інтернаціоналізації (i18n) з відкритим вихідним кодом, розроблена для спрощення підтримки багатьох мов у сучасних веб-додатках.
 
 З Intlayer ви можете:
 
@@ -356,12 +356,12 @@ export function LocaleSwitcher() {
 ```
 
 > **Примітка щодо реактивності Solid:**
-> У Solid `locale` є сигналом реактивного доступу (reactive accessor signal) — завжди викликайте його як `locale()`, щоб отримати поточне значення.
+> У Solid `locale` є сигналом реактивного доступу (reactive accessor signal) - завжди викликайте його як `locale()`, щоб отримати поточне значення.
 
 > **Примітка щодо стійкості:**
 > Використання `onLocaleChange` для перенаправлення через `window.location.href` гарантує відвідування нової URL-адреси з мовним префіксом. Це дозволяє middleware Intlayer встановити cookie мови та запам'ятати вибір користувача для майбутніх візитів.
 
-> `LocaleSwitcher` повинен рендеритися всередині `IntlayerProvider` — використовуйте його у вашому компоненті island (як показано на кроці 6).
+> `LocaleSwitcher` повинен рендеритися всередині `IntlayerProvider` - використовуйте його у вашому компоненті island (як показано на кроці 6).
 
 ### Крок 8: Sitemap та Robots.txt
 

package/docs/uk/intlayer_with_astro_svelte.md

@@ -46,7 +46,7 @@ history:
 <iframe
   src="https://intlayer-astro-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Демо — intlayer-astro-template"
+  title="Демо - intlayer-astro-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -60,7 +60,7 @@ history:
 
 ## Що таке Intlayer?
 
-**Intlayer** — це інноваційна бібліотека інтернаціоналізації (i18n) з відкритим вихідним кодом, розроблена для спрощення підтримки багатьох мов у сучасних веб-додатках.
+**Intlayer** - це інноваційна бібліотека інтернаціоналізації (i18n) з відкритим вихідним кодом, розроблена для спрощення підтримки багатьох мов у сучасних веб-додатках.
 
 З Intlayer ви можете:
 

package/docs/uk/intlayer_with_astro_vanilla.md

@@ -46,7 +46,7 @@ history:
 <iframe
   src="https://intlayer-astro-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Демо — intlayer-astro-template"
+  title="Демо - intlayer-astro-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -60,7 +60,7 @@ history:
 
 ## Що таке Intlayer?
 
-**Intlayer** — це інноваційна бібліотека інтернаціоналізації (i18n) з відкритим вихідним кодом, розроблена для спрощення підтримки багатьох мов у сучасних веб-додатках.
+**Intlayer** - це інноваційна бібліотека інтернаціоналізації (i18n) з відкритим вихідним кодом, розроблена для спрощення підтримки багатьох мов у сучасних веб-додатках.
 
 З Intlayer ви можете:
 

package/docs/uk/intlayer_with_astro_vue.md

@@ -46,7 +46,7 @@ history:
 <iframe
   src="https://intlayer-astro-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Демо — intlayer-astro-template"
+  title="Демо - intlayer-astro-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -60,7 +60,7 @@ history:
 
 ## Що таке Intlayer?
 
-**Intlayer** — це інноваційна бібліотека інтернаціоналізації (i18n) з відкритим вихідним кодом, розроблена для спрощення підтримки багатьох мов у сучасних веб-додатках.
+**Intlayer** - це інноваційна бібліотека інтернаціоналізації (i18n) з відкритим вихідним кодом, розроблена для спрощення підтримки багатьох мов у сучасних веб-додатках.
 
 З Intlayer ви можете:
 

package/docs/uk/intlayer_with_fastify.md

@@ -29,7 +29,7 @@ history:
 
 # Перекладіть свій бекенд-сайт на Fastify за допомогою Intlayer | Інтернаціоналізація (i18n)
 
-`fastify-intlayer` — це потужний плагін інтернаціоналізації (i18n) для додатків Fastify, розроблений для того, щоб зробити ваші бекенд-сервіси доступними в усьому світі, надаючи локалізовані відповіді на основі вподобань клієнта.
+`fastify-intlayer` - це потужний плагін інтернаціоналізації (i18n) для додатків Fastify, розроблений для того, щоб зробити ваші бекенд-сервіси доступними в усьому світі, надаючи локалізовані відповіді на основі вподобань клієнта.
 
 > Подивитися реалізацію пакета на GitHub: https://github.com/aymericzip/intlayer/tree/main/packages/fastify-intlayer
 

package/docs/uk/intlayer_with_nextjs_14.md

@@ -60,7 +60,7 @@ history:
 <iframe
   src="https://intlayer-next-14-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Демо — intlayer-next-14-template"
+  title="Демо - intlayer-next-14-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/uk/intlayer_with_nextjs_15.md

@@ -116,7 +116,7 @@ history:
 <iframe
   src="https://next-15-intlayer-template-xt83.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Демо — intlayer-next-15-template"
+  title="Демо - intlayer-next-15-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/uk/intlayer_with_nextjs_16.md

@@ -56,7 +56,7 @@ history:
 <iframe
   src="https://intlayer-next-16-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Демо — intlayer-next-16-template"
+  title="Демо - intlayer-next-16-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/uk/intlayer_with_nextjs_page_router.md

@@ -41,7 +41,7 @@ history:
 <iframe
   src="https://ide.intlayer.org/aymericzip/intlayer-next-14-template?file=intlayer.config.ts"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Demo CodeSandbox — Intlayer"
+  title="Demo CodeSandbox - Intlayer"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -52,7 +52,7 @@ history:
 <iframe
   src="https://intlayer-next-14-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Демо — intlayer-next-14-template"
+  title="Демо - intlayer-next-14-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/uk/intlayer_with_nuxt.md

@@ -78,7 +78,7 @@ history:
 <iframe
   src="https://intlayer-nuxt-4-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Демо — intlayer-nuxt-4-template"
+  title="Демо - intlayer-nuxt-4-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />