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

package/docs/tr/releases/v9.md

@@ -0,0 +1,316 @@
+---
+createdAt: 2026-06-14
+updatedAt: 2026-06-26
+title: Yeni Intlayer v9 - Yenilikler Neler?
+description: Intlayer v9'daki yenilikleri keşfedin. Popüler i18n kütüphaneleri için doğrudan uyumlu paketler ve Koleksiyonlar ve Varyantlar desteği sunuluyor.
+keywords:
+  - Intlayer
+  - Compatibility
+  - Migration
+  - Collections
+  - Variants
+  - i18next
+  - next-intl
+  - vue-i18n
+slugs:
+  - doc
+  - releases
+  - v9
+author: aymericzip
+---
+
+# Yeni Intlayer v9 - Yenilikler Neler?
+
+Intlayer v9'a hoş geldiniz! Bu ana sürüm, büyük i18n kütüphaneleri (`react-i18next`, `next-intl`, `vue-i18n` vb.) için sunulan **Compat Adapter Paketleri** ile Intlayer'a geçiş sürecini basitleştirmede dev bir adımı temsil ediyor ve zengin içerik yapıları için destek ekliyor: **Koleksiyonlar (Collections)** ve **Varyantlar (Variants)**.
+
+## İçindekiler
+
+<TOC levels={[2]} maxDepth={1} />
+
+---
+
+## Compat Adapter Paketleri
+
+Popüler i18n kütüphanelerinden Intlayer'a geçiş yapmak artık her zamankinden daha kolay. Standart i18n kütüphaneleriyle **birebir aynı genel API'leri (public APIs)** sunan ancak çalışma zamanında (runtime) tüm çeviri işlerini Intlayer'a devreden beş adet uyumluluk (compat) paketi oluşturduk.
+
+### Sıkı Tiplendirme ile Aynı Genel API'yi Sunma
+
+İçe aktarmaları (imports) değiştirerek, minimum kod değişikliğiyle Intlayer'ın tüm avantajlarından (gerçek sözlüklerinize karşı derleme zamanı tip güvenliği dahil) yararlanabilirsiniz:
+
+- `@intlayer/i18next`
+- `@intlayer/react-i18next`
+- `@intlayer/next-intl`
+- `@intlayer/react-intl`
+- `@intlayer/next-i18next`
+- `@intlayer/vue-i18n`
+- `@intlayer/lingui`
+
+Örneğin, sadece şunu değiştirin:
+
+```ts
+import { useTranslation } from "react-i18next";
+```
+
+şuna:
+
+```ts
+import { useTranslation } from "@intlayer/react-i18next";
+```
+
+Anahtarlarınız artık Intlayer sözlüklerinize karşı **sıkı bir şekilde tiplendirilecek (strictly typed)** ve IDE'nizde tam nokta yolu (dot-path) otomatik tamamlama desteği sunacak!
+
+### Bundler Alias Eklentileri (Vite, Next.js, Turbopack)
+
+Tüm içe aktarma ifadelerinizi manuel olarak yeniden yazmadan geçiş yapabilmenizi sağlamak için, her compat adapter paketi `/plugin` alt yolu altında **özel bir bundler eklentisi** (Vite veya Next.js) içerir.
+
+Bu eklentiler, derleme zamanında (build time) mevcut içe aktarmaları (örneğin `react-i18next` veya `next-intl`) otomatik olarak `@intlayer/*` eşdeğerlerine dönüştürür.
+
+#### Next.js (Webpack / Turbopack) Örneği
+
+`withIntlayer` yerine, Next.js yapılandırmanızı compat eklentisi ile sarmalayın:
+
+```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) Örneği
+
+```ts fileName="vite.config.ts"
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vueI18nVitePlugin()],
+});
+```
+
+---
+
+## Ortaklaştırılmış Çalışma Zamanı Çözümleyicisi (Mutualized Runtime Resolver)
+
+Tüm compat adapter'lar artık çeviri çözümlemesini tek ve son derece optimize edilmiş bir çalışma zamanı ayrıştırıcısı (runtime parser) üzerinden yönlendiriyor: `@intlayer/core/messageFormat`.
+
+- **Mesaj Değişkeni Ekleme (Interpolate Message)**: Standart `{{var}}` (boşluklar ve nokta yolları), ICU biçimlendirilmiş argümanlar (`{v, number, percent}` vb.) ve yalın `{var}` şablonlarını çözümler.
+- **Mesaj Düğümü Çözümleyici (Message Node Resolver)**: İç içe geçmiş düğümleri çözümler: `insert()`, `plural()` (CLDR çoğul kuralları), `enu()` (numaralandırma), `gender()`, HTML etiketleri, diziler ve çağrılabilir fonksiyon düğümleri.
+- **Tokenized Tag Parser**: Zengin metin (rich-text) oluşturmayı kutudan çıktığı gibi desteklemek için satır içi XML/HTML etiketlerini ve numaralandırılmış etiketleri (örneğin, `<1>children</1>`) destekler.
+
+---
+
+## Özellik Detayları: Koleksiyonlar ve Varyantlar
+
+Intlayer v9, statik anahtar-değer nesnelerinin ötesine geçerek sözlüklerin uçtan uca tam tiplendirilmiş dinamik düzen yapıları tanımlamasına olanak tanır.
+
+### 1. Koleksiyonlar (Collections)
+
+CMS tarafından yönetilen sıralı öğelerin bir listesini tanımlayın (örneğin SSS'ler, ürünler veya blog listeleri):
+
+```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;
+```
+
+#### Kullanım:
+
+```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. Varyantlar (Variants)
+
+A/B testleri, mevsimsel başlıklar, özellik bayrakları (feature flags) veya özel açılış sayfaları sunun:
+
+#### Dize varyantları (örneğin, A/B testleri)
+
+```ts fileName="hero.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "hero-banner",
+  variant: "default",
+  content: {
+    control: t({ tr: "Hoş geldiniz", en: "Welcome", fr: "Bienvenue" }),
+    black_friday: t({
+      tr: "Şimdi alışveriş yap",
+      en: "Shop now",
+      fr: "Acheter maintenant",
+    }),
+  },
+} satisfies Dictionary;
+```
+
+#### Kullanım:
+
+```ts
+const banner = useIntlayer("hero-banner", { variant: "black_friday" });
+```
+
+#### Nesne varyantları (örneğin, Dinamik Kayıtlar)
+
+```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({ tr: "Temiz Kod", en: "Clean Code", fr: "Code Propre" }),
+  },
+} satisfies Dictionary;
+```
+
+#### Kullanım:
+
+```ts
+// Yalnızca talep edilen öğeyi dinamik olarak getirir (Suspense gerektirir)
+const product = useIntlayer("product-copy", {
+  variant: { id: "prod_123", category: "books" },
+});
+```
+
+---
+
+## Dinamik Yükleme ve Bundle Boyutu Optimizasyonları
+
+Bundle boyutlarını son derece küçük tutmak için Intlayer v9 dinamik tembel yüklemeyi (dynamic lazy loading) destekler.
+
+Yapılandırmanızda `importMode` değerini `'dynamic'` veya `'fetch'` olarak ayarlayın:
+
+```ts fileName="intlayer.config.ts"
+export default {
+  dictionary: {
+    importMode: "dynamic", // "static" | "dynamic" | "fetch"
+  },
+};
+```
+
+Derleme zamanında, `@intlayer/swc` ve `@intlayer/babel` dosyalarınızı tarar ve `useIntlayer` / `getIntlayer` çağrılarını tree-shakeable sarmalayıcılarla (`useDictionary` / `useDictionaryDynamic`) değiştirir. Yalnızca seçilen koleksiyon öğesi, varyant veya dil (locale) için gerekli olan içerik yüklenir, böylece üretim (production) bundle'ınızın kullanılmayan çevirileri içermesi engellenir.
+
+---
+
+## Vite Plugin: Bundled Compiler & Proxy
+
+`intlayer()` Vite eklentisi artık **compiler** ve **locale-routing proxy**'i doğrudan içeriyor, bu nedenle çoğu proje `vite.config.ts` içinde yalnızca tek bir eklentiye ihtiyaç duyuyor:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **Compiler**: `compiler.enabled` `true` olarak ayarlandığında ve `compiler.output` yolu yapılandırıldığında otomatik olarak etkinleştirilir. Artık `intlayerCompiler()`'ı ayrı olarak kaydetmeniz gerekmez.
+- **Proxy**: Yeni `routing.enableProxy` seçeneğine göre otomatik olarak etkinleştirilir (varsayılan olarak `true`). Geliştirme, önizleme ve üretim SSR'de locale algılama / yönlendirme / yeniden yazma middleware'ini bağlar. Artık `intlayerProxy()`'ı ayrı olarak kaydetmeniz gerekmez.
+
+### `routing.enableProxy` seçeneği
+
+Yeni `routing.enableProxy` seçeneği, locale-routing proxy'sinin bağlanıp bağlanmadığını kontrol eder. Varsayılan değer `true`'dur. Locale yönlendirmesini kendiniz işlemek istediğinizde devre dışı bırakın:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // Varsayılan: true
+  },
+};
+
+export default config;
+```
+
+Bağımsız `intlayerCompiler()` ve `intlayerProxy()` eklentileri gelişmiş kurulumlar için dışa aktarılmaya devam eder. Bunları `intlayer()` ile birlikte kaydetmek güvenlidir — her eklenti kendisini çoğaltır ve yalnızca bir kez çalışır.
+
+---
+
+## Derleyici varsayılan olarak devre dışı
+
+Intlayer v9'dan itibaren, **derleyici varsayılan olarak devre dışıdır** (`compiler.enabled` artık varsayılan olarak `false`'tur). `.content.ts` dosyalarınızın derleme zamanı çıkarımını etkinleştirmek için yapılandırmanızda `compiler.enabled: true` olarak ayarlayın:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    enabled: true, // Varsayılan: false — v9'dan itibaren derleyiciyi etkinleştirmek için gereklidir
+    output: ({ fileName }) => `./${fileName}.content.ts`,
+  },
+};
+
+export default config;
+```
+
+Derleyici devre dışı bırakıldığında, Intlayer derleme zamanı çıkarım adımını atlar ve önceden bildirdiğiniz sözlüklere dayanır. Yalnızca bundler eklentisinin (`@intlayer/swc`, `@intlayer/babel` veya `intlayer()` Vite eklentisi) içeriği otomatik olarak çıkarmasını istediğinizde etkinleştirin.
+
+---
+
+## React Native: tek paket içe aktarmaları
+
+Bir React Native veya Expo uygulamasında, artık `react-intlayer` ve `react-native-intlayer` arasında gidip gelmenize gerek yok. `react-native-intlayer` paketi artık **tüm `react-intlayer` API'sini yeniden dışa aktarıyor** (hook'lar, yardımcı programlar ve `/format`, `/html` ve `/markdown` alt yolları) ve `IntlayerProvider`'ı React Native polyfill'lerini otomatik olarak uyguluyor.
+
+Her şeyi tek `react-native-intlayer` paketinden içe aktarın:
+
+```tsx
+import {
+  IntlayerProvider,
+  useIntlayer,
+  useLocale,
+} from "react-native-intlayer";
+```
+
+```bash
+npm install intlayer react-native-intlayer
+```
+
+> `react-intlayer`'dan içe aktarmak çalışmaya devam eder, ancak `react-native-intlayer` artık React Native için önerilen tek giriş noktasıdır — sağlayıcısı, web odaklı `react-intlayer` sağlayıcısının sahip olmadığı polyfill'leri içerir.
+
+---
+
+## v8'den Geçiş Notları
+
+v8'den yükseltme yapıyorsanız, v9'un yıkıcı değişiklikler (breaking changes) içermediğini unutmayın. Ancak işte temel değişiklikler:
+
+- **Derleyici varsayılan olarak devre dışı**: `compiler.enabled` artık varsayılan olarak `false`'tur. `.content.ts` dosyalarınızın derleme zamanı çıkarımına güveniyorsanız, `intlayer.config.ts` dosyanızda `compiler.enabled: true` olarak ayarlayın.
+- **Diller ve Lehçeler (Locales & Dialects)**: Harici i18n bağımlılıkları kullanıyorsanız, içe aktarmaları otomatik olarak yeniden yazmak için yapılandırmanıza veya bundler kurulumunuza ilgili compat adapter eklentilerini ekleyin.
+- **Özel Seçiciler (Custom Selectors)**: `useIntlayer` çağrılırken, ikinci parametre artık `{ locale, item, variant }` içeren bir seçenek nesnesine ayrılmıştır. Daha önce doğrudan bir dil (locale) dizesi geçirdiyseniz bunu yapmaya devam edebilirsiniz, ancak gelişmiş seçimler için seçenekler nesnesini kullanmanız önerilir.
+
+---
+
+## Faydalı bağlantılar
+
+- [Compat Adapter Paketleri Kılavuzu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/compat/index.md)
+- [Dinamik Sözlükler - Koleksiyonlar ve Varyantlar](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/index.md)
+- [Yapılandırma Referansı](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md)

package/docs/tr/roadmap.md

@@ -32,6 +32,12 @@ Intlayer, uygulamalarınızda içeriği bildirme, yönetme ve güncelleme şekli
 
 ---
 
+## İçindekiler
+
+<TOC/>
+
+---
+
 ## Mevcut Özellikler
 
 ### 1. İçerik Bildirimi

package/docs/uk/benchmark/solid.md

@@ -118,6 +118,28 @@ style="border:none;"
 - **Scoped static**: Зберігає код організованим (логічне розділення) без складних додаткових мережевих запитів.
 - **Scoped dynamic**: Найкращий підхід для _code splitting_ та продуктивності. Мінімізує пам'ять, завантажуючи лише те, що потрібно поточному перегляду та активній локалі.
 
+### Що я вимірював:
+
+Я запустив одну й ту саму багатомовну програму в реальному браузері для кожного стеку, а потім записав, що насправді з'явилося на мережі та як довго тривав процес. Розміри наводяться **після звичайного стиснення веб-вмісту**, оскільки це ближче до того, що люди завантажують, ніж необроблене джерельне числення.
+
+- **Розмір бібліотеки інтернаціоналізації**: Після bundling, tree-shaking та мініфікації, розмір бібліотеки i18n — це розмір providers + hooks/primitives кода в порожній компоненті. Він не включає завантаження файлів перекладу. Це відповідає на питання про вартість бібліотеки до того, як ваш вміст потрапить у картину.
+
+- **JavaScript на сторінку**: Для кожного маршруту бенчмарку — скільки скрипту браузер витягує для цього відвідування, усереднено по сторінках у наборі (та по мовах, де звіт їх об'єднує). Важкі сторінки — повільні сторінки.
+
+- **Утечка з інших мов**: Це вміст однієї й тієї ж сторінки, але іншою мовою, який по помилці був би завантажений у проаудитовану сторінку. Цей вміст непотрібний і його слід уникати. (напр. вміст сторінки `/fr/about` в bundle сторінки `/en/about`)
+
+- **Утечка з інших маршрутів**: Та сама ідея для **інших екранів** у додатку: чи їхний вміст їде разом, коли ви відкрили лише одну сторінку. (напр. вміст сторінки `/en/about` в bundle сторінки `/en/contact`). Висока оцінка вказує на слабке розділення або занадто широкі bundle.
+
+- **Середній розмір bundle компоненти**: Звичайні елементи інтерфейсу вимірюються **один за одним** замість того, щоб приховуватися всередину одного гігантського числа програми. Це показує, чи інтернаціоналізація тихо збільшує повсякденні компоненти. Наприклад, якщо ваша компонента повторно рендерується, вона завантажить всі ці дані з пам'яті. Прикріплення гігантської JSON до будь-якої компоненти — це як підключення великого сховища невикористаних даних, що сповільнить роботу ваших компонент.
+
+- **Адаптивність перемикання мови**: Я перемикаю мову за допомогою контролю програми й розраховую, як довго це займає, поки сторінка явно не переключиться, що помітить відвідувач, а не мікрокрок у лабораторії.
+
+- **Робота рендерингу після зміни мови**: Вужчий наступний крок: скільки зусиль знадобилося інтерфейсу для перепалітури на нову мову, коли перемикання в польоті. Корисно, коли «відчутний» час і вартість фреймворку розходяться.
+
+- **Час завантаження початкової сторінки**: Від навігації до браузера, який вважає сторінку повністю завантаженою для сценаріїв, які я тестував. Добре для порівняння холодних запусків.
+
+- **Час гідратації**: Коли програма це виявляє, скільки часу клієнт витрачає на перетворення серверної HTML у щось, на що ви можете насправді клікнути. Тире в таблицях означає, що ця реалізація не надала надійної цифри гідратації в цьому бенчмарку.
+
 ## Зірки на GitHub
 
 Зірки на GitHub є потужним індикатором популярності проекту, довіри спільноти та довгострокової актуальності. Хоча вони не є прямим показником технічної якості, вони відображають, скільки розробників вважають проект корисним, стежать за його розвитком і, ймовірно, впровадять його. Для оцінки цінності проекту зірки допомагають порівняти інтерес до альтернатив і дають уявлення про зростання екосистеми.

package/docs/uk/benchmark/svelte.md

@@ -116,6 +116,28 @@ style="border:none;"
 - **Scoped static**: Зберігає код організованим (логічне розділення) без складних додаткових мережевих запитів.
 - **Scoped dynamic**: Найкращий підхід для _code splitting_ та продуктивності. Мінімізує пам'ять, завантажуючи лише те, що потрібно поточному перегляду та активній локалі.
 
+### Що я вимірював:
+
+Я запустив одну й ту ж багатомовну програму в реальному браузері для кожного стеку, а потім записав, що насправді з'явилося в мережі та скільки часу це зайняло. Розміри вказані **після звичайного веб-стиснення**, оскільки це ближче до того, що люди завантажують, ніж підрахунок сирового вихідного коду.
+
+- **Размер бібліотеки internationalization**: Після зв'язування, tree-shaking та мініфікації розмір бібліотеки i18n — це розмір коду провайдерів + stores в порожньому компоненті. Це не включає завантаження файлів перекладу. Це відповідає на питання, наскільки дорога бібліотека перед тим, як ваш вміст входить у гру.
+
+- **JavaScript на сторінку**: Для кожного маршруту бенчмарку — скільки скрипту браузер завантажує під час цього відвідування, усередненого на сторінках в наборі (та на локалях, де звіт їх об'єднує). Важкі сторінки — це повільні сторінки.
+
+- **Витік з інших локалей**: Це вміст однієї й тієї ж сторінки, але іншою мовою, який помилково завантажився б на перевіреній сторінці. Цей вміст непотрібний і його слід уникати. (наприклад, вміст сторінки `/fr/about` в комплекті `/en/about`)
+
+- **Витік з інших маршрутів**: Та ж ідея для **інших екранів** у програмі: чи їхній копія їде разом, коли ви відкрили лише одну сторінку. (наприклад, вміст сторінки `/en/about` в комплекті `/en/contact`). Високий показник вказує на слабкий розподіл або занадто широкі комплекти.
+
+- **Середній розмір комплекту компонентів**: Звичайні елементи інтерфейсу вимірюються **по одному** замість того, щоб ховатися всередині одного гігантського числа програми. Це показує, чи internationalization мовчки збільшує повсякденні компоненти. Наприклад, якщо ваш компонент перерендерується, він завантажить усі ці дані з пам'яті. Приєднання гігантського JSON до будь-якого компонента схоже на підключення великого сховища невикористаних даних, що сповільнить продуктивність ваших компонентів.
+
+- **Чутливість перемикача мови**: Я перемикаю мову за допомогою власного контролю програми та вимірюю, скільки часу займає, поки сторінка явно не переключиться, що помітить відвідувач, а не лабораторний мікро-крок.
+
+- **Робота рендерингу після зміни мови**: Вузький подальший крок: скільки зусиль знадобилося інтерфейсу, щоб перефарбуватися на нову мову після того, як перемикання розпочало свіжість. Корисно, коли «відчутний» час та вартість фреймворку розходяться.
+
+- **Час завантаження початкової сторінки**: Від навігації до браузера, що розглядає сторінку як повністю завантажену для сценаріїв, які я тестував. Добре для порівняння холодних стартів.
+
+- **Час гідрації**: Коли програма це розкриває, скільки часу клієнт витрачає на перетворення серверного HTML на щось, на що ви можете насправді натиснути. Тире в таблицях означає, що реалізація не надала надійного показника гідрації в цьому бенчмарку.
+
 ## Зірки на GitHub
 
 Зірки на GitHub є потужним індикатором популярності проекту, довіри спільноти та довгострокової актуальності. Хоча вони не є прямим показником технічної якості, вони відображають, скільки розробників вважають проект корисним, стежать за його розвитком і, ймовірно, впровадять його. Для оцінки цінності проекту зірки допомагають порівняти інтерес до альтернатив і дають уявлення про зростання екосистеми.

package/docs/uk/benchmark/tanstack.md

@@ -124,6 +124,28 @@ history:
 - **Scoped static**: Зберігає код структурованим (логічний поділ) без складних мережевих запитів.
 - **Scoped dynamic**: Найкращий підхід для _розділення коду_ (code splitting) та продуктивності. Мінімізує обсяг пам'яті, завантажуючи лише те, що потрібно поточному перегляду та активній локалі.
 
+### Що я вимірював:
+
+Я запустив одну й ту саму багатомовну програму в реальному браузері для кожного стеку, а потім записав, що насправді показувалося в мережі та скільки часу це займало. Розміри повідомляються **після звичайного стиснення в мережі**, оскільки це ближче до того, що люди завантажують, ніж до підрахунків сирцевого коду.
+
+- **Розмір бібліотеки інтернаціоналізації**: Після bundling, tree-shaking та мініфікації розмір бібліотеки i18n — це розмір постачальників (наприклад, `NextIntlClientProvider`) + код хуків (наприклад, `useTranslations`) в пустому компоненті. Він не включає завантаження файлів перекладу. Це показує, наскільки дорога бібліотека перш ніж ваш контент потрапить в картину.
+
+- **JavaScript на сторінку**: Для кожного маршруту бенчмарку, скільки скрипту браузер завантажує під час цього відвідування, усереднено по сторінках в наборі (і по локалям, де звіт їх об'єднує). Важкі сторінки — повільні сторінки.
+
+- **Витік з інших локалей**: Це контент однієї й тієї ж сторінки, але іншою мовою, який був би випадково завантажений у перевіреній сторінці. Цей контент не потрібний і його слід уникати. (наприклад, контент сторінки `/fr/about` у пакеті сторінки `/en/about`)
+
+- **Витік з інших маршрутів**: Та сама ідея для **інших екранів** у програмі: чи їхній копія йде разом, коли ви відкрили лише одну сторінку. (наприклад, контент сторінки `/en/about` у пакеті сторінки `/en/contact`). Високий бал натякає на слабке розділення або надто широкі пакети.
+
+- **Середній розмір пакету компонента**: Загальні частини користувацького інтерфейсу вимірюються **один за одним** замість того, щоб приховуватися всередину одного гігантського номера програми. Це показує, чи інтернаціоналізація тихо збільшує звичайні компоненти. Наприклад, якщо ваш компонент перерендерується, він завантажить всі ці дані з пам'яті. Приєднання великого JSON до будь-якого компонента подібно до підключення великого сховища непотрібних даних, що уповільнить продуктивність ваших компонентів.
+
+- **Чутливість перемикання мови**: Я змінюю мову за допомогою власного елемента керування програми та вимірюю, скільки часу пройде, поки сторінка явно не переключиться, що помітив би відвідувач, а не лабораторна мікрокроку.
+
+- **Робота з рендерингом після зміни мови**: Вужча подальша діяльність: скільки зусиль потребував інтерфейс, щоб перемалювати для нової мови, коли перемикання йде. Корисно, коли «відчутний» час та вартість фреймворку розходяться.
+
+- **Час завантаження початкової сторінки**: Від навігації до браузера, враховуючи, що сторінка повністю завантажена для сценаріїв, які я тестував. Добре для порівняння холодних запусків.
+
+- **Час гідратації**: Коли програма це розкриває, скільки часу клієнт витрачає на перетворення серверної HTML на те, що можна насправді клацнути. Тире в таблицях означає, що реалізація не надала надійної цифри гідратації у цьому бенчмарку.
+
 ## Зірки на GitHub
 
 Зірки на GitHub є потужним індикатором популярності проекту, довіри спільноти та довгострокової актуальності. Хоча вони не є прямим показником технічної якості, вони відображають, скільки розробників вважають проект корисним, стежать за його розвитком і, ймовірно, впровадять його. Для оцінки цінності проекту зірки допомагають порівняти інтерес до альтернатив і дають уявлення про зростання екосистеми.

package/docs/uk/cli/ci.md

@@ -140,6 +140,28 @@ steps:
     run: npx intlayer ci fill
 ```
 
+## Scaffolded GitHub Actions
+
+Коли ви запустите `intlayer init`, Intlayer виявляє ваш package manager (npm, yarn, pnpm або bun) і створює два GitHub Actions workflows у `.github/workflows/` з командами, які відповідають цьому package manager:
+
+- **`intlayer-fill.yml`** — На кожен pull request будує словники і запускає `intlayer fill --git-diff --mode complete` для генерування відсутніх перекладів для змінених словників, потім фіксує результат назад у гілку PR.
+- **`intlayer-test.yml`** — На кожен pull request будує словники і запускає `intlayer test`, завершуючи перевірку з помилкою, коли обов'язкові мови не мають перекладів.
+
+Існуючі файли workflows ніколи не перезаписуються. Щоб пропустити scaffolding повністю, запустіть:
+
+```bash
+npx intlayer init --no-github-actions
+```
+
+### Надання доступу до ШІ для робочого процесу заповнення
+
+Сгенерований `intlayer-fill.yml` вимагає доступу до ШІ. Доступні два варіанти (налаштовуються в блоці `env` робочого процесу):
+
+1. **Ваш власний ключ AI-провайдера** — Додайте секрет `AI_API_KEY` в налаштуваннях вашого репозиторію (Settings → Secrets and variables → Actions). Робочий процес передає його через `--provider`, `--model` та `--api-key`.
+2. **Ключі доступу до Intlayer CMS** — Додайте секрети `INTLAYER_CLIENT_ID` та `INTLAYER_CLIENT_SECRET` і підключіть їх до секції `editor` вашого `intlayer.config`. Ключі доступу до CMS надають доступ до ШІ через backend Intlayer.
+
+Робочий процес `intlayer-test.yml` не вимагає жодного доступу до ШІ.
+
 ## Обробка помилок
 
 - Якщо `INTLAYER_PROJECT_CREDENTIALS` не встановлено, команда завершиться з помилкою.

package/docs/uk/cli/doc-review.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-06-17
 title: Перевірка документа
 description: Дізнайтеся, як перевіряти файли документації на предмет якості, узгодженості та повноти для різних локалей.
 keywords:
@@ -15,6 +15,10 @@ slugs:
   - concept
   - cli
   - doc-review
+history:
+  - version: 9.0.0
+    date: 2026-06-17
+    changes: "Додати опцію --log"
 author: aymericzip
 ---
 
@@ -55,8 +59,110 @@ bun x intlayer doc review
 
 ## Аргументи:
 
-Команда `doc review` приймає ті самі аргументи, що й `doc translate`, що дозволяє переглядати конкретні документаційні файли та застосовувати перевірки якості.
+**Параметри списку файлів:**
 
-Якщо ви активували одну з опцій git, команда перегляне лише ту частину файлів, яка була змінена. Скрипт обробляє файл, розбиваючи його на chunks, і перевіряє кожен chunk. Якщо в chunk немає змін, скрипт пропустить його, щоб пришвидшити процес рев'ю та зменшити витрати на API постачальника AI.
+- **`--doc-pattern [docPattern...]`**: Глобальні шаблони (glob) для співпадіння файлів документації, які потрібно перевірити.
 
-Для повного переліку аргументів див. документацію команди [Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/doc-translate.md).
+  > Приклад: `npx intlayer doc review --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Glob-шаблони, які слід виключити з перевірки.
+
+  > Приклад: `npx intlayer doc review --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Пропустити файл, якщо он був змінений до вказаного часу.
+  - Може бути абсолютним часом у форматі "2025-12-05" (рядок або Date)
+  - Може бути відносним часом у мс `1 * 60 * 60 * 1000` (1 година)
+  - Ця опція перевіряє час оновлення файлу за допомогою методу `fs.stat`. Тому на неї можуть вплинути Git або інші інструменти, що змінюють файл.
+
+  > Приклад: `npx intlayer doc review --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Пропустити файл, якщо він був змінений протягом вказаного проміжку часу.
+  - Може бути абсолютним часом, наприклад "2025-12-05" (рядок або Date)
+  - Може бути відносним часом у мс `1 * 60 * 60 * 1000` (1 година)
+  - Ця опція перевіряє час оновлення файлу за допомогою методу `fs.stat`. Тому вона може залежати від Git або інших інструментів, які змінюють файл.
+
+  > Приклад: `npx intlayer doc review --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Пропустити файл, якщо він уже існує.
+
+  > Приклад: `npx intlayer doc review --skip-if-exists`
+
+**Параметри режиму перевірки:**
+
+- **`--log`**: Режим тільки логування. Не перекладати з допомогою AI; замість цього логувати блоки, які потребують уваги (з номерами рядків і вмістом) для базової та цільової локалей, щоб допомогти іншому агенту згенерувати переклади.
+
+  > Приклад: `npx intlayer doc review --log`
+
+**Параметри виводу записів:**
+
+- **`--locales [locales...]`**: Цільові локалі для перевірки документації.
+
+  > Приклад: `npx intlayer doc review --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Базова локаль (базовий документ), з якою порівнювати.
+
+  > Приклад: `npx intlayer doc review --base-locale en`
+
+**Параметри обробки файлів:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Кількість файлів для одночасної обробки під час перевірки.
+
+  > Приклад: `npx intlayer doc review --nb-simultaneous-file-processed 5`
+
+**Параметри AI:**
+
+- **`--model [model]`**: Модель AI, яку слід використовувати для перевірки (наприклад, `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Провайдер AI, який слід використовувати для перевірки.
+- **`--temperature [temperature]`**: Налаштування temperature для моделі AI.
+- **`--api-key [apiKey]`**: Надати власний API-ключ для сервісу AI.
+- **`--application-context [applicationContext]`**: Надати додатковий контекст для перевірки AI.
+- **`--data-serialization [dataSerialization]`**: Формат серіалізації даних для використання у функціях ШІ Intlayer. Опції: `json` (стандартний, надійний), `toon` (менше токенів, менш стабільний).
+- **`--custom-prompt [prompt]`**: Налаштувати базовий prompt, який використовується для перевірки. (Примітка: у більшості випадків натомість рекомендується використовувати опцію `--custom-instructions`, оскільки вона забезпечує кращий контроль.)
+
+  > Приклад: `npx intlayer doc review --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "My application is a cat store"`
+
+**Параметри змінних оточення:**
+
+- **`--env`**: Вказати середовище (наприклад, `development`, `production`).
+- **`--env-file [envFile]`**: Надати користувацький файл оточення для завантаження змінних.
+- **`--base-dir`**: Вказати базову директорію проєкту.
+- **`--no-cache`**: Вимкнути кеш.
+
+  > Приклад: `npx intlayer doc review --base-dir ./docs --env-file .env.production.local`
+
+**Параметри логування:**
+
+- **`--verbose`**: Увімкнути детальне логування для налагодження. (за замовчуванням true при використанні CLI)
+
+  > Приклад: `npx intlayer doc review --verbose`
+
+**Параметри користувацьких інструкцій:**
+
+- **`--custom-instructions [customInstructions]`**: Користувацькі інструкції, додані до prompt. Корисно для застосування специфічних правил щодо форматування, перекладу URL тощо.
+
+  > Приклад: `npx intlayer doc review --custom-instructions "Avoid translating urls, and keep the markdown format"`
+
+  > Приклад: `npx intlayer doc review --custom-instructions "$(cat ./instructions.md)"`
+
+**Опції Git:**
+
+- **`--git-diff`**: Запускати лише для файлів, які містять зміни від бази (за замовчуванням `origin/main`) до поточної гілки (за замовчуванням: `HEAD`).
+- **`--git-diff-base`**: Вказати базову ревізію для git diff (за замовчуванням `origin/main`).
+- **`--git-diff-current`**: Вказати поточну ревізію для git diff (за замовчуванням `HEAD`).
+- **`--uncommitted`**: Включати незакомічені зміни.
+- **`--unpushed`**: Включати незапушені зміни.
+- **`--untracked`**: Включати не відстежувані файли.
+
+  > Приклад: `npx intlayer doc review --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Приклад: `npx intlayer doc review --uncommitted --unpushed --untracked`
+
+> Зверніть увагу, що шлях вихідного файлу визначається заміною наступних шаблонів:
+>
+> - `/{{baseLocale}}/` на `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` на `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` на `_{{locale}}.`
+> - `{{baseLocale}}_` на `{{locale}}_`
+> - `.{{baseLocaleName}}.` на `.{{localeName}}.`
+>
+> Якщо шаблон не знайдено, до розширення файлу буде додано `.{{locale}}`. `./my/file.md` буде перевірено та оновлено на `./my/file.fr.md` для французької локалі.

package/docs/uk/cli/fill.md

@@ -47,6 +47,14 @@ bun x intlayer fill
 - Зберігає існуючі переклади, не перезаписуючи їх.
 - Обробляє файли, частини та локалі паралельно, використовуючи систему черг для збільшення швидкості.
 
+## Ключові моменти:
+
+- Розбиває великі JSON файли на частини, щоб залишатися в межах контекстного вікна AI моделі.
+- Повторює переклад, якщо формат результату невірний.
+- Incorporates application and file-specific context for improved translation accuracy.
+- Зберігає існуючі переклади, не перезаписуючи їх.
+- Обробляє файли, частини та локалі паралельно, використовуючи систему черг для прискорення.
+
 ## Аліаси:
 
 - `npx intlayer dictionaries fill`

package/docs/uk/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/uk/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