@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.3

package/docs/uk/plugins/sync-json.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-03-13
-updatedAt: 2025-12-13
+updatedAt: 2026-06-21
 title: Плагін Sync JSON
 description: Синхронізуйте словники Intlayer із зовнішніми i18n JSON-файлами (i18next, next-intl, react-intl, vue-i18n та ін.). Залишайте ваш існуючий i18n-стек і використовуйте Intlayer для керування, перекладу та тестування повідомлень.
 keywords:
@@ -24,6 +24,9 @@ slugs:
   - sync-json
 youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
 history:
+  - version: 9.0.0
+    date: 2026-06-21
+    changes: "Додано опцію splitKeys (один словник на ключ простору імен верхнього рівня) для макетів next-intl / react-intl з одним файлом"
   - version: 7.5.0
     date: 2025-12-13
     changes: "Додано підтримку форматів ICU та i18next"
@@ -182,6 +185,7 @@ syncJSON({
   location?: string, // необов'язковий ярлик, за замовчуванням: "plugin"
   priority?: number, // необов'язковий пріоритет для вирішення конфліктів, за замовчуванням: 0
   format?: 'intlayer' | 'icu' | 'i18next', // необов'язковий форматтер, використовується для сумісності з intlayer runtime
+  splitKeys?: boolean, // необов'язково, розділяє один файл на один словник для кожного ключа простору імен верхнього рівня (автоматично визначається)
 });
 ```
 
@@ -205,6 +209,38 @@ syncJSON({
 }),
 ```
 
+#### `splitKeys` (boolean)
+
+Контролює, чи повинен один JSON-файл, **ключі першого рівня якого є просторами імен**, стати одним словником на ключ верхнього рівня, замість одного словника, що містить весь файл.
+
+Це відповідає моделі просторів імен таких бібліотек, як `next-intl` та `react-intl`, де один файл `messages/{locale}.json` групує кілька просторів імен за ключами першого рівня, кожен з яких адресується незалежно (наприклад, `useTranslations('Hero')` розв'язується до словника `Hero`).
+
+- `undefined` (за замовчуванням): **автоматично визначається** — файл розділяється, коли шаблон `source` не має сегмента `{key}` (один файл містить кожен простір імен), і залишається як єдиний словник в іншому випадку (один файл на ключ).
+- `true`: завжди розділяти кожен ключ верхнього рівня на окремий словник.
+- `false`: ніколи не розділяти; весь файл стає єдиним словником.
+
+Дано один файл `messages/{locale}.json`:
+
+```json fileName="messages/en.json"
+{
+  "Hero": { "title": "Full-stack developer" },
+  "Nav": { "work": "Work", "about": "About" },
+  "About": { "lead": "I build apps end to end." }
+}
+```
+
+```ts fileName="intlayer.config.ts"
+syncJSON({
+  format: "icu",
+  source: ({ locale }) => `./messages/${locale}.json`,
+  // splitKeys: true, // мається на увазі, оскільки шаблон не має сегмента `{key}`
+}),
+```
+
+Це створює три словники — `Hero`, `Nav` та `About` — тому `useTranslations('Hero')` (next-intl) розв'язується коректно. При зворотному записі всі простори імен знову збираються в той самий файл для кожної локалі.
+
+> Коли ви зберігаєте явний сегмент `{key}` у вашому `source` (наприклад, `./locales/${locale}/${key}.json`), кожен файл вже є одним простором імен, тому розділення за замовчуванням вимкнено.
+
 ### Кілька джерел JSON та пріоритет
 
 Ви можете додавати кілька плагінів `syncJSON` для синхронізації різних джерел JSON. Це корисно, коли у вашому проєкті використовується декілька i18n бібліотек або різні структури JSON.
@@ -337,6 +373,9 @@ loadJSON({
 
   // Необов'язковий форматувач для JSON-вмісту
   format?: 'intlayer' | 'icu' | 'i18next', // за замовчуванням: 'intlayer'
+
+  // Розділяє один файл на один словник для кожного ключа верхнього рівня (автоматично визначається)
+  splitKeys?: boolean,
 });
 ```
 
@@ -358,10 +397,25 @@ loadJSON({
 }),
 ```
 
+#### `splitKeys` (boolean)
+
+Така ж поведінка, як і в [`syncJSON`](#splitkeys-boolean): коли один JSON-файл групує кілька просторів імен за ключами першого рівня, кожен ключ верхнього рівня стає окремим словником.
+
+- `undefined` (за замовчуванням): **автоматично визначається** — розділяється, коли шаблон `source` не має сегмента `{key}`, інакше — єдиний словник.
+- `true` / `false`: примусово ввімкнути або вимкнути розділення.
+
+```ts
+loadJSON({
+  source: ({ locale }) => `./messages/${locale}.json`,
+  format: "icu",
+  // splitKeys auto-enabled: `Hero`, `Nav`, `About`, … each become a dictionary
+}),
+```
+
 ### Поведінка та конвенції
 
 - Якщо ваша маска `source` містить плейсхолдер локалі, імпортуються лише файли для обраної `locale`.
-- Якщо в масці немає сегмента `{key}`, ключ словника, "index".
+- Якщо в масці немає сегмента `{key}`, кожен ключ верхнього рівня файлу за замовчуванням стає окремим словником (див. [`splitKeys`](#splitkeys-boolean)). Встановіть `splitKeys: false`, щоб замість цього завантажити весь файл як єдиний словник `index`.
 - Ключі виводяться зі шляхів файлів шляхом підстановки плейсхолдера `{key}` у вашому source builder.
 - Плагін використовує лише виявлені файли і не створює відсутні локалі чи ключі.
 - Шлях `fill` виводиться з вашого `source` і використовується для оновлення відсутніх значень через CLI, якщо ви погодитесь.

package/docs/uk/releases/v8.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-22
-updatedAt: 2026-01-26
+updatedAt: 2026-06-14
 title: "Новий Intlayer v8 - Що нового?"
 description: "Дізнайтеся, що нового в Intlayer v8. Значні покращення досвіду розробника, валідації контенту та управління словниками."
 keywords:
@@ -199,7 +199,7 @@ Intlayer v8 вносить значні покращення в обробку
 
     **3. Використання утиліти:**
 
-    ```tsx
+    ```typescript
     import { renderMarkdown } from "solid-intlayer/markdown";
 
     return <div>{renderMarkdown("# Мій заголовок")}</div>;
@@ -409,6 +409,16 @@ Intlayer v8 вносить значні покращення в обробку
 
 ---
 
+## Файли контенту YAML та Markdown (v8.10.0)
+
+Тепер ви можете оголошувати контент безпосередньо за допомогою розширень файлів `.content.md` та `.content.yaml`. Це ідеально підходить для лонгрідів, блогів, документації та політик конфіденційності.
+
+Ці файли повністю доступні для редагування у Visual Editor, забезпечуючи спрощений робочий процес для нетехнічних членів команди.
+
+Для отримання додаткової інформації див. [Документацію про файли контенту YAML](https://intlayer.org/doc/concept/content#yaml-content-file) та [Документацію про файли контенту Markdown](https://intlayer.org/doc/concept/content/markdown).
+
+---
+
 ## Користувацькі переписування URL
 
 Intlayer v8 додає підтримку **користувацьких переписувань URL**, що дозволяє визначати локалізовані шляхи, які відрізняються від стандартної структури `/locale/path`. Це потужна можливість для покращення локального SEO та забезпечення більш природного досвіду користувача для тих, хто не говорить англійською.
@@ -753,6 +763,60 @@ export default {
   </Tab>
 </Tabs>
 
+---
+
+## Правила множини Unicode CLDR (v8.8.0)
+
+Було впроваджено новий хелпер вузла `plural` на основі правил множини, визначених проектом Unicode CLDR, що покращує підтримку складних мов.
+
+```typescript fileName="src/openings.content.ts"
+import { plural, t, type Dictionary } from "intlayer";
+
+const openingsContent = {
+  key: "total_openings",
+  content: {
+    totalOpenings: t({
+      en: plural({
+        one: "{{count}} opening",
+        other: "{{count}} openings",
+      }),
+      fr: plural({
+        one: "{{count}} offre",
+        other: "{{count}} offres",
+      }),
+    }),
+  },
+} satisfies Dictionary;
+
+export default openingsContent;
+```
+
+Після цього ви можете динамічно передавати кількість у компонент вашого фреймворку:
+
+```tsx
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const OpeningsComponent: FC<{ count: number }> = ({ count }) => {
+  const { totalOpenings } = useIntlayer("total_openings");
+
+  return (
+    <div>
+      {/* Англійською:                                  */}
+      {/*  count=0  → "0 openings"   (other)           */}
+      {/*  count=1  → "1 opening"    (one)             */}
+      {/*  count=2  → "2 openings"   (other)           */}
+      {/*  count=21 → "21 openings"  (other)           */}
+      <p>{totalOpenings(count)}</p>
+    </div>
+  );
+};
+```
+
+Для отримання додаткової інформації див. [Документацію про плюралізацію](https://intlayer.org/doc/concept/content/plural).
+
+---
+
 ## Валідація схем контенту
 
 Intlayer v8 впроваджує валідацію схем для словників. Тепер ви можете визначати повторно використовувані схеми валідації у вашій конфігурації за допомогою Zod і застосовувати їх до ваших файлів контенту. Це гарантує, що ваш контент завжди відповідає очікуваній структурі, виявляючи помилки під час збірки.
@@ -797,6 +861,34 @@ export default aboutPageMetaContent;
 
 ---
 
+## TypeScript: Примітивні аксесори IntlayerNode
+
+Тип `IntlayerNode` було оновлено, щоб дозволити виклик примітивних методів JavaScript безпосередньо на вузлах контенту. Це дає змогу взаємодіяти з вашим локалізованим контентом так, ніби це стандартний примітив рядка, числа, булевого значення або масиву.
+
+Підтримується в React, Preact, Solid, Svelte, Vue та Angular.
+
+### Приклад з рядком (String)
+
+```typescript
+content.placeholder; // Повертає IntlayerNode<string>
+content.placeholder.value; // Повертає string
+content.placeholder.toString(); // Повертає string
+content.placeholder.toLowerCase(); // Повертає string
+String(content.placeholder); // Повертає string
+content.placeholder.toUpperCase(); // Повертає рядок у верхньому регістрі
+content.placeholder.replace("a", "b"); // Повертає змінений рядок
+```
+
+### Приклад з масивом (Array)
+
+```typescript
+content.myArrayOfString             // Повертає IntlayerNode<Array<string>>
+content.myArrayOfString.find(...)   // Повертає елемент
+content.myArrayOfString.join(', ')  // Повертає об'єднаний рядок
+```
+
+---
+
 ### Покращене автоматичне виявлення контенту
 
 У v8 Intlayer інтелектуально виявляє синтаксис Markdown, HTML-теги та вставки змінних у рядках контенту. Це означає, що ви часто можете опустити допоміжні функції, такі як `md()`, `html()` або `insert()`.
@@ -1002,9 +1094,20 @@ export default {
 
 ---
 
+## Інструменти: C++ Watcher та LSP на базі OXC (v8.12.0)
+
+Intlayer v8.12.0 приносить значні покращення у досвід розробника:
+
+- **Parcel Watcher**: Спостерігач за контентом (content watcher) було мігровано з `chokidar` на `@parcel/watcher`, що використовує нативне спостереження за файлами на C++ для забезпечення швидших оновлень та значно меншого споживання пам'яті.
+- **Новий Language Server Protocol (LSP)**: Тепер доступний абсолютно новий LSP. Створений на основі парсингу OXC, він допомагає вашій IDE та AI-агентам безперешкодно пов'язувати виклики `useIntlayer('my-key')` з відповідними файлами `.content` і навпаки.
+
+Для отримання додаткової інформації див. [Документацію LSP](https://intlayer.org/doc/lsp).
+
+---
+
 ## Оптимізації компілятора
 
-Intlayer v8 включає новий шар кешування для компілятора Markdown та HTML. Це гарантує, що ідентичні рядки контенту з однаковою конфігурацією парсяться лише один раз, що значно зменшує витрати під час повторних відтворень або при використанні одного й того ж контенту в декількох місцях.
+Intlayer v8 включає новий шар кешування для компілятора Markdown та HTML. Це гарантує, що ідентичні рядки контенту з однаковою конфігурацією парсяться лише один раз, що значно зменшує витрати під час повторних відтворень або при використанні одного й того же контенту в декількох місцях.
 
 <Tabs group='bundler'>
   <Tab label="Next.js" value="nextjs">
@@ -1057,6 +1160,48 @@ Intlayer v8 включає новий шар кешування для комп
 
 ---
 
+## Експериментальні оптимізації збірки: Minify & Purge (v8.7.0)
+
+Intlayer v8.7.0 представляє нові експериментальні функції збірки у вашому `intlayer.config.ts`, розроблені для оптимізації вашого production-бандлу:
+
+- **Мініфікація словників (Dictionary Minification)**: Мініфікує файли словників для зменшення їхнього розміру.
+- **Очищення невикористовуваних ключів (Unused Key Purging)**: Сканує та видаляє невикористовувані ключі перекладу зі словників, перейменовуючи активні ключі на короткі символи (наприклад, `"products" -> "a"`, `"pricing" -> "b"`). Це зменшує розмір бандлу до 5%.
+- **Вимкнення перевірок TypeScript**: Прискорює збірку шляхом вимкнення типізації TypeScript під час кроку компіляції.
+
+```typescript fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  dictionary: {
+    importMode: "dynamic",
+  },
+  build: {
+    /**
+     * Мініфікувати словники для зменшення розміру бандлу.
+     */
+    minify: true,
+
+    /**
+     * Очистити невикористовувані ключі у словниках
+     */
+    purge: true,
+
+    /**
+     * Вказує, чи повинна збірка перевіряти типи TypeScript
+     */
+    checkTypes: false,
+  },
+};
+
+export default config;
+```
+
+---
+
 ## Гнучкість: Уніфікований режим імпорту
 
 Властивість булевого типу `live` була застаріла на користь більш всеосяжної властивості `importMode`. Це дозволяє явно визначати, як словники мають завантажуватися: статично, динамічно або через live-синхронізацію.
@@ -1204,6 +1349,49 @@ export default {
 
 ---
 
+## Підтримка Angular: Vite Bundler (v8.11.0)
+
+Для користувачів Angular Intlayer тепер нативно підтримує бандлер Vite через новий кастомний плагін esbuild, що прискорює час розробки та збірки.
+
+Детальніше про конфігурацію див. у [Документації середовища Angular](https://intlayer.org/doc/environment/angular).
+
+---
+
+## Генерація карти сайту (Sitemap) (v8.6.0)
+
+Intlayer тепер автоматично генерує карти сайтів (sitemaps) на основі ваших локалей та режиму маршрутизації. Це особливо корисно для SEO-оптимізації в архітектурах роутерів, таких як TanStack Router:
+
+```typescript fileName="src/routes/sitemap.xml.ts"
+import { createFileRoute } from "@tanstack/react-router";
+import { generateSitemap } from "intlayer";
+
+const SITE_URL = (
+  import.meta.env.VITE_SITE_URL ?? "http://localhost:3000"
+).replace(/\/$/, "");
+
+export const Route = createFileRoute("/sitemap.xml")({
+  server: {
+    handlers: {
+      GET: async () => {
+        const sitemap = generateSitemap(
+          [
+            { path: "/", changefreq: "daily", priority: 1.0 },
+            { path: "/about", changefreq: "monthly", priority: 0.8 },
+          ],
+          { siteUrl: SITE_URL }
+        );
+
+        return new Response(sitemap, {
+          headers: { "Content-Type": "application/xml" },
+        });
+      },
+    },
+  },
+});
+```
+
+---
+
 ## Примітки до міграції з v7
 
 ### Зміни в конфігурації

package/docs/uk/releases/v9.md

@@ -0,0 +1,232 @@
+---
+createdAt: 2026-06-14
+updatedAt: 2026-06-14
+title: Новий Intlayer v9 - Що нового?
+description: Дізнайтеся, що нового в Intlayer v9. Представляємо сумісні пакети швидкої заміни (drop-in) для популярних бібліотек i18n та підтримку Collections, Variants та Dynamic Records.
+keywords:
+  - Intlayer
+  - Сумісність
+  - Міграція
+  - Колекції
+  - Варіанти
+  - Динамічні записи
+  - i18next
+  - next-intl
+  - vue-i18n
+slugs:
+  - doc
+  - releases
+  - v9
+author: aymericzip
+---
+
+# Новий Intlayer v9 - Що нового?
+
+Ласкаво просимо до Intlayer v9! Цей мажорний реліз є величезною віхою у спрощенні шляху міграції на Intlayer завдяки **Compat Adapter Packages** (пакетам адаптерів сумісності) для основних бібліотек i18n (`react-i18next`, `next-intl`, `vue-i18n` тощо) та додає підтримку складних структур контенту: **Collections** (Колекцій), **Variants** (Варіантів) та **Dynamic Records** (Динамічних записів).
+
+## Зміст
+
+<TOC levels={[2]} maxDepth={1} />
+
+---
+
+## Пакети адаптерів сумісності (Compat Adapter Packages)
+
+Мігрувати на Intlayer з популярних бібліотек i18n тепер простіше, ніж будь-коли. Ми створили п'ять пакетів сумісності, які надають **точно такий самий публічний API**, як і стандартні бібліотеки i18n, але делегують усю роботу з перекладу Intlayer під час виконання (runtime).
+
+### Той самий публічний API зі строгою типізацією
+
+Замінивши імпорти, ви отримуєте всі переваги Intlayer (включаючи типізацію на етапі компіляції відповідно до ваших реальних словників) з мінімальними змінами в коді:
+
+- `@intlayer/i18next`
+- `@intlayer/react-i18next`
+- `@intlayer/next-intl`
+- `@intlayer/next-i18next`
+- `@intlayer/vue-i18n`
+
+Наприклад, просто змініть:
+
+```ts
+import { useTranslation } from "react-i18next";
+```
+
+на:
+
+```ts
+import { useTranslation } from "@intlayer/react-i18next";
+```
+
+Тепер ваші ключі будуть **строго типізовані** відповідно до ваших словників Intlayer, забезпечуючи повне автодоповнення шляхів через крапку (dot-path) у вашій IDE!
+
+### Плагіни аліасів для бандлерів (Vite, Next.js, Turbopack)
+
+Щоб дозволити міграцію без ручного переписування всіх інструкцій імпорту, кожен пакет адаптера сумісності містить **кастомний плагін для бандлера** (Vite або Next.js) у підшляху `/plugin`.
+
+Ці плагіни автоматично перезаписують існуючі імпорти (наприклад, `react-i18next` або `next-intl`) на їхні еквіваленти `@intlayer/*` під час збірки.
+
+#### Приклад для Next.js (Webpack / Turbopack)
+
+Замість `withIntlayer` оберніть вашу конфігурацію Next.js плагіном сумісності:
+
+```ts fileName="next.config.ts"
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+import type { NextConfig } from "next";
+
+const withIntlayer = createNextI18nPlugin();
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+#### Приклад для Vite (React, Vue, Solid, Svelte)
+
+```ts fileName="vite.config.ts"
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vueI18nVitePlugin()],
+});
+```
+
+---
+
+## Спільний резолвер часу виконання (Mutualized Runtime Resolver)
+
+Усі адаптери сумісності тепер направляють резолв перекладів через єдиний, високооптимізований парсер часу виконання: `@intlayer/core/messageFormat`.
+
+- **Interpolate Message**: Резолвить стандартні `{{var}}` (пробіли та dot-paths), аргументи у форматі ICU (`{v, number, percent}` тощо) та прості шаблони `{var}`.
+- **Message Node Resolver**: Резолвить вкладені вузли: `insert()`, `plural()` (правила множини CLDR), `enu()` (перелічення), `gender()`, HTML-теги, масиви та вузли функцій зворотного виклику (callable function nodes).
+- **Tokenized Tag Parser**: Підтримує інлайнові XML/HTML-теги та нумеровані теги (наприклад, `<1>children</1>`) для забезпечення рендерингу форматованого тексту (rich-text) "з коробки".
+
+---
+
+## Специфікація функцій: Collections, Variants та Dynamic Records
+
+Intlayer v9 виходить за рамки статичних об'єктів типу ключ-значення, дозволяючи словникам оголошувати динамічні структури макетів, які повністю типізовані від початку до кінця (end-to-end).
+
+### 1. Колекції (Collections)
+
+Визначайте керований CMS список упорядкованих елементів (наприклад, FAQ, товари або списки блогів):
+
+```ts fileName="faq.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  content: [
+    {
+      question: t({
+        uk: "Що таке Intlayer?",
+        en: "What is Intlayer?",
+        fr: "Qu'est-ce qu'Intlayer ?",
+      }),
+      answer: t({
+        uk: "Інструментарій i18n.",
+        en: "An i18n toolkit.",
+        fr: "Une boîte à outils i18n.",
+      }),
+    },
+  ],
+} satisfies Dictionary;
+```
+
+#### Використання:
+
+```ts
+// Отримати всі елементи
+const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
+
+// Отримати один елемент за індексом
+const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+```
+
+### 2. Варіанти (Variants)
+
+Надавайте A/B тести, сезонні заголовки, feature flags або кастомні цільові сторінки (landing pages):
+
+```ts fileName="hero.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "hero-banner",
+  variant: "default",
+  content: {
+    control: t({ uk: "Ласкаво просимо", en: "Welcome", fr: "Bienvenue" }),
+    black_friday: t({
+      uk: "Купити зараз",
+      en: "Shop now",
+      fr: "Acheter maintenant",
+    }),
+  },
+} satisfies Dictionary;
+```
+
+#### Використання:
+
+```ts
+const banner = useIntlayer("hero-banner", { variant: "black_friday" });
+```
+
+### 3. Динамічні записи (Dynamic Records)
+
+Визначайте словники, записи яких завантажуються динамічно під час виконання за допомогою ідентифікаторів запитів (query IDs):
+
+```ts fileName="product.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "product-copy",
+  meta: {
+    id: "prod_123",
+    category: "books",
+  },
+  content: {
+    title: t({ uk: "Чистий код", en: "Clean Code", fr: "Code Propre" }),
+  },
+} satisfies Dictionary;
+```
+
+#### Використання:
+
+```ts
+// Динамічно завантажує лише запитуваний елемент (потребує Suspense)
+const product = useIntlayer("product-copy", {
+  id: "prod_123",
+  category: "books",
+});
+```
+
+---
+
+## Динамічне завантаження та оптимізація розміру бандла
+
+Щоб зберегти розмір бандлів надзвичайно малим, Intlayer v9 підтримує динамічне ліниве завантаження (lazy loading).
+
+У вашій конфігурації встановіть `importMode` у `'dynamic'` або `'fetch'`:
+
+```ts fileName="intlayer.config.ts"
+export default {
+  dictionary: {
+    importMode: "dynamic", // "static" | "dynamic" | "fetch"
+  },
+};
+```
+
+Під час збірки `@intlayer/swc` та `@intlayer/babel` сканують ваші файли та замінюють виклики `useIntlayer` / `getIntlayer` на tree-shakeable обгортки (`useDictionary` / `useDictionaryDynamic`). Завантажується лише контент, необхідний для вибраного елемента колекції, варіанта або локалі, що запобігає потраплянню невикористовуваних перекладів у ваш продакшн-бандл.
+
+---
+
+## Примітки щодо міграції з v8
+
+Якщо ви оновлюєтеся з v8, зверніть увагу, що v9 не містить критичних змін (breaking changes). Проте ось ключові зміни:
+
+- **Locales & Dialects**: Якщо ви використовуєте зовнішні залежності i18n, додайте відповідні плагіни адаптерів сумісності у вашу конфігурацію або налаштування бандлера для автоматичного перезапису імпортів.
+- **Custom Selectors**: При виклику `useIntlayer` другий параметр тепер зарезервований для об'єкта опцій, що містить `{ locale, item, variant, id }`. Якщо раніше ви передавали рядок локалі безпосередньо, ви все ще можете це робити, але для розширеного вибору рекомендується використовувати об'єкт опцій.
+
+---
+
+## Корисні посилання
+
+- [Посібник з пакетів адаптерів сумісності (Compat Adapter Packages)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/compat/index.md)
+- [Динамічні словники - Collections, Variants та Dynamic Records](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dynamic_dictionaries/index.md)
+- [Довідник з конфігурації](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md)

package/docs/ur/cli/index.md

@@ -17,7 +17,7 @@ slugs:
   - concept
   - cli
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "اسکین (scan) کمانڈ شامل کی گئی"
   - version: 8.6.4

package/docs/ur/cli/scan.md

@@ -18,7 +18,7 @@ slugs:
   - cli
   - scan
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "اسکین (scan) کمانڈ شامل کی گئی"
 author: aymericzip