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

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,316 @@
+---
+createdAt: 2026-06-14
+updatedAt: 2026-06-26
+title: Новий Intlayer v9 - Що нового?
+description: Дізнайтеся, що нового в Intlayer v9. Представляємо сумісні пакети швидкої заміни (drop-in) для популярних бібліотек i18n та підтримку Collections та Variants.
+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** (Варіантів).
+
+## Зміст
+
+<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/react-intl`
+- `@intlayer/next-i18next`
+- `@intlayer/vue-i18n`
+- `@intlayer/lingui`
+
+Наприклад, просто змініть:
+
+```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
+
+Intlayer v9 виходить за рамки статичних об'єктів типу ключ-значення, дозволяючи словникам оголошувати динамічні структури макетів, які повністю типізовані від початку до кінця (end-to-end).
+
+### 1. Колекції (Collections)
+
+Визначайте керований CMS список упорядкованих елементів (наприклад, FAQ, товари або списки блогів):
+
+```ts fileName="faq.1.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 1,
+  content: {
+    question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
+    answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
+  },
+} satisfies Dictionary;
+```
+
+```ts fileName="faq.2.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 2,
+  content: {
+    question: t({ en: "Is it free?", fr: "Est-ce gratuit ?" }),
+    answer: t({ en: "Yes, open-source.", fr: "Oui, open-source." }),
+  },
+} satisfies Dictionary;
+```
+
+#### Використання:
+
+```ts
+// Fetch all items as an array
+const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
+
+// Fetch a single item by index
+const faq = useIntlayer("faq", { item: 2 }); // -> { question: string, answer: string }
+```
+
+### 2. Варіанти (Variants)
+
+Надавайте A/B тести, сезонні заголовки, feature flags або кастомні цільові сторінки (landing pages):
+
+#### Рядкові варіанти (наприклад, A/B-тестування)
+
+```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" });
+```
+
+#### Об'єктні варіанти (наприклад, динамічні записи)
+
+```ts fileName="product.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "product-copy",
+  variant: {
+    id: "prod_123",
+    category: "books",
+  },
+  content: {
+    title: t({ uk: "Чистий код", en: "Clean Code", fr: "Code Propre" }),
+  },
+} satisfies Dictionary;
+```
+
+#### Використання:
+
+```ts
+// Динамічно завантажує лише запитуваний елемент (потребує Suspense)
+const product = useIntlayer("product-copy", {
+  variant: { 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`). Завантажується лише контент, необхідний для вибраного елемента колекції, варіанта або локалі, що запобігає потраплянню невикористовуваних перекладів у ваш продакшн-бандл.
+
+---
+
+## Vite Plugin: Bundled Compiler & Proxy
+
+Плагін Vite `intlayer()` тепер об'єднує **компілятор** та **проксі для маршрутизації локалей** безпосередньо, тому більшості проектів потрібен лише один плагін у `vite.config.ts`:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **Compiler**: Активується автоматично, коли `compiler.enabled` встановлено у `true` та налаштовано шлях `compiler.output`. Вам більше не потрібно реєструвати `intlayerCompiler()` окремо.
+- **Proxy**: Активується автоматично на основі нового параметра `routing.enableProxy` (`true` за замовчуванням). Він підключає middleware виявлення локалей / перенаправлення / переписування в режимі розробки, попереднього перегляду та production SSR. Вам більше не потрібно реєструвати `intlayerProxy()` окремо.
+
+### Опція `routing.enableProxy`
+
+Нова опція `routing.enableProxy` контролює, чи підключений проксі маршрутизації локалі. За замовчуванням встановлено значення `true`. Вимкніть її, якщо ви хочете самостійно обробляти маршрутизацію локалі:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // За замовчуванням: true
+  },
+};
+
+export default config;
+```
+
+Автономні плагіни `intlayerCompiler()` та `intlayerProxy()` залишаються експортованими для складних налаштувань. Реєстрація їх разом з `intlayer()` безпечна — кожен плагін автоматично дедублює себе і запускається лише один раз.
+
+---
+
+## Компілятор вимкнено за замовчуванням
+
+Починаючи з Intlayer v9, **компілятор вимкнено за замовчуванням** (значення `compiler.enabled` тепер за замовчуванням дорівнює `false`). Щоб увімкнути вилучення ваших файлів `.content.ts` під час збірки, встановіть `compiler.enabled: true` у своїй конфігурації:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    enabled: true, // За замовчуванням: false — потрібно для увімкнення компілятора починаючи з v9
+    output: ({ fileName }) => `./${fileName}.content.ts`,
+  },
+};
+
+export default config;
+```
+
+Коли компілятор вимкнено, Intlayer пропускає крок вилучення під час збірки та покладається на вже оголошені вами словники. Вмикайте його лише тоді, коли хочете, щоб плагін збирача (`@intlayer/swc`, `@intlayer/babel` або Vite-плагін `intlayer()`) вилучав вміст автоматично.
+
+---
+
+## React Native: імпорт з одного пакета
+
+У програмі React Native або Expo вам більше не потрібно жонглювати `react-intlayer` та `react-native-intlayer`. Пакет `react-native-intlayer` тепер **реекспортує весь API `react-intlayer`** (хуки, утиліти та підшляхи `/format`, `/html` і `/markdown`), а його `IntlayerProvider` автоматично застосовує поліфіли React Native.
+
+Імпортуйте все з єдиного пакета `react-native-intlayer`:
+
+```tsx
+import {
+  IntlayerProvider,
+  useIntlayer,
+  useLocale,
+} from "react-native-intlayer";
+```
+
+```bash
+npm install intlayer react-native-intlayer
+```
+
+> Імпорт з `react-intlayer` продовжує працювати, але `react-native-intlayer` тепер є рекомендованою єдиною точкою входу для React Native — його провайдер містить поліфіли, яких не має веб-орієнтований провайдер `react-intlayer`.
+
+---
+
+## Примітки щодо міграції з v8
+
+Якщо ви оновлюєтеся з v8, зверніть увагу, що v9 не містить критичних змін (breaking changes). Проте ось ключові зміни:
+
+- **Компілятор вимкнено за замовчуванням**: значення `compiler.enabled` тепер за замовчуванням дорівнює `false`. Якщо ви покладаєтеся на вилучення ваших файлів `.content.ts` під час збірки, встановіть `compiler.enabled: true` у своєму `intlayer.config.ts`.
+- **Locales & Dialects**: Якщо ви використовуєте зовнішні залежності i18n, додайте відповідні плагіни адаптерів сумісності у вашу конфігурацію або налаштування бандлера для автоматичного перезапису імпортів.
+- **Custom Selectors**: При виклику `useIntlayer` другий параметр тепер зарезервований для об'єкта опцій, що містить `{ locale, item, variant }`. Якщо раніше ви передавали рядок локалі безпосередньо, ви все ще можете це робити, але для розширеного вибору рекомендується використовувати об'єкт опцій.
+
+---
+
+## Корисні посилання
+
+- [Посібник з пакетів адаптерів сумісності (Compat Adapter Packages)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/compat/index.md)
+- [Динамічні словники - Collections та Variants](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

package/docs/ur/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-05-12
+updatedAt: 2026-06-17
 title: ترتیب (Configuration)
 description: سیکھیں کہ اپنی ایپلیکیشن کے لیے Intlayer کو کیسے ترتیب دینا ہے۔ اپنی ضروریات کے مطابق Intlayer کو اپنی مرضی کے مطابق بنانے کے لیے دستیاب مختلف ترتیبات اور اختیارات کو سمجھیں۔
 keywords:
@@ -16,6 +16,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.10.0
+    date: 2026-06-17
+    changes: "ڈکشنری کی ترتیب میں `format` کا اختیار شامل کیا گیا"
   - version: 8.9.4
     date: 2026-05-12
     changes: "LM Studio فراہم کنندہ کے لیے سپورٹ شامل کریں"
@@ -137,6 +140,7 @@ Intlayer JSON، JS، MJS، اور TS کنفیگریشن فائل فارمیٹس
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import { Locales, type IntlayerConfig } from "intlayer";
 import { nextjsRewrite } from "intlayer/routing";
+import { syncJSON } from "@intlayer/sync-json-plugin";
 import { z } from "zod";
 
 /**
@@ -585,9 +589,37 @@ const config: IntlayerConfig = {
   },
 
   /**
-   * پلگ ان کنفیگریشن۔
+   * ڈکشنری کی ترتیب۔
    */
-  plugins: [],
+  dictionary: {
+    /**
+     * کنٹرول کرتا ہے کہ ڈکشنریاں کیسے درآمد کی جاتی ہیں۔
+     * - "static": تعمیر کے وقت جامد طور پر درآمد کیا گیا۔
+     * - "dynamic": Suspense کا استعمال کرتے ہوئے متحرک طور پر درآمد کیا گیا۔
+     * - "fetch": لائیو سنک API کے ذریعے متحرک طور پر حاصل کیا گیا۔
+     */
+    importMode: "static",
+
+    /**
+     * پروجیکٹ میں تمام ڈکشنریوں کے لیے ڈیفالٹ پیغام کا فارمیٹ۔
+     * - 'intlayer': مقامی intlayer فارمیٹ (ڈیفالٹ)۔
+     * - 'icu': ICU پیغام کا فارمیٹ۔
+     * - 'i18next': i18next فارمیٹ۔
+     * - 'vue-i18n': Vue I18n فارمیٹ۔
+     * - 'po': GNU Gettext PO فارمیٹ۔
+     */
+    format: "icu",
+  },
+
+  /**
+   * پلگ ان کی ترتیب۔
+   */
+  plugins: [
+    syncJSON({
+      format: "icu",
+      source: ({ locale }) => `./messages/${locale}.json`,
+    }),
+  ],
 };
 
 export default config;
@@ -864,6 +896,7 @@ export default config;
 | `contentAutoTransformation` | کیا اسٹرنگ مواد کو خودکار طور پر ٹائپ شدہ نوڈز (Markdown، HTML، یا داخل کرنے والا) میں تبدیل کرنا ہے۔                                     | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`            | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')` .<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')` .<br/>• Insertion : `Hello {{name}}` → `insert('Hello {{name}}')` .                                                                                                                                                                                                                                |
 | `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 سنک API کے ذریعے حاصل کرنا؛ ناکامی پر `'dynamic'` پر واپس آتا ہے۔<br/>• `@intlayer/babel` اور `@intlayer/swc` پلگ انز کی ضرورت ہے۔<br/>• کلیدیں ساکن طور پر اعلان ہونی چاہئیں۔<br/>• اگر `optimize` غیر فعال ہو تو نظر انداز کر دیا جاتا ہے۔<br/>• `getIntlayer` ، `getDictionary` وغیرہ پر کوئی اثر نہیں۔ |
+| `format`                    | پروجیکٹ میں تمام ڈکشنریوں کے لیے ڈیفالٹ پیغام کا فارمیٹ۔                                                                                  | `'intlayer'` &#124; <br/> `'icu'` &#124; <br/> `'i18next'` &#124; <br/> `'vue-i18n'` &#124; <br/> `'po'`        | `'intlayer'`       | `'icu'`                                                                                     | • `'intlayer'`: مقامی intlayer فارمیٹ۔<br/>• `'icu'`: ICU پیغام کا فارمیٹ۔<br/>• `'i18next'`: i18next فارمیٹ۔<br/>• `'vue-i18n'`: Vue I18n فارمیٹ۔<br/>• `'po'`: GNU Gettext PO فارمیٹ۔                                                                                                                                                                                                                        |
 | `priority`                  | لغت کی ترجیح۔ لغات کے درمیان تصادم کو حل کرتے وقت، زیادہ قیمت والی لغت کم قیمت والی پر غالب آئے گی۔                                       | `number`                                                                                                        | `undefined`        | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                |
 | `live`                      | DEPRECATED - `importMode: 'fetch'` استعمال کریں۔ پہلے بتاتا تھا کہ آیا API Live Sync کے ذریعے لغت کا مواد متحرک طور پر حاصل کرنا ہے۔      | `boolean`                                                                                                       | `undefined`        |                                                                                             | v8.0.0 میں نام تبدیل کر کے `importMode: 'fetch'` کر دیا گیا۔                                                                                                                                                                                                                                                                                                                                                   |
 | `schema`                    | JSON اسکیمہ کی توثیق کے لیے Intlayer کے ذریعے خودکار طور پر تیار کیا گیا۔                                                                 | `'https://intlayer.org/schema.json'`                                                                            | خودکار طور پر تیار |                                                                                             | دستی طور پر ترمیم نہ کریں۔                                                                                                                                                                                                                                                                                                                                                                                     |