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

package/docs/ru/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:
@@ -44,7 +44,7 @@ Intlayer v8 вносит значительные улучшения в спос
 
 ### Унифицированный API `.use()`
 
-Мы ввели метод `.use()` как для Markdown, так и для HTML узлов. Этот метод позволяет настраивать HTML-теги или компоненты, используемые при рендеринге.
+Мы ввели метод `.use()` как для Markdown, так и для HTML-узлов. Этот метод позволяет настраивать HTML-теги или компоненты, используемые при рендеринге.
 
 - **Замена компонентов**: Вы можете легко заменить HTML-теги или пользовательские компоненты компонентами вашего фреймворка (например, заменить `<a>` на `NextLink` или `<CustomCmp>` на React-компонент).
 - **Типизация**: Все функции для предоставления компонентов полностью типизированы, что гарантирует получение правильных пропсов.
@@ -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,64 @@ export default {
   </Tab>
 </Tabs>
 
+## Unicode CLDR Plural Rules (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({
+      ru: plural({
+        one: "{{count}} вакансия",
+        few: "{{count}} вакансии",
+        many: "{{count}} вакансий",
+        other: "{{count}} вакансии",
+      }),
+      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 +865,34 @@ export default aboutPageMetaContent;
 
 ---
 
+## TypeScript: Примитивные аксессоры IntlayerNode
+
+Тип `IntlayerNode` был обновлен, чтобы позволить вызывать примитивные методы JavaScript напрямую на узлах контента. Это делает возможным взаимодействие с вашим локализованным контентом напрямую, как если бы он был стандартным примитивом строки, числа, булева значения или массива.
+
+Поддерживается в React, Preact, Solid, Svelte, Vue и Angular.
+
+### Пример со строкой
+
+```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"); // Возвращает измененную строку
+```
+
+### Пример с массивом
+
+```typescript
+content.myArrayOfString             // Возвращает IntlayerNode<Array<string>>
+content.myArrayOfString.find(...)   // Возвращает элемент
+content.myArrayOfString.join(', ')  // Возвращает объединенную строку
+```
+
+---
+
 ### Улучшенное автоматическое определение содержимого
 
 В v8 Intlayer автоматически определяет синтаксис Markdown, HTML-теги и вставки переменных в строках содержимого. Это означает, что вы часто можете опускать вспомогательные функции, такие как `md()`, `html()` или `insert()`.
@@ -1002,6 +1098,17 @@ export default {
 
 ---
 
+## Инструменты: C++ Watcher и LSP на базе OXC (v8.12.0)
+
+Intlayer v8.12.0 приносит важные улучшения в опыт разработчика:
+
+- **Parcel 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. Это гарантирует, что идентичные строки контента с одинаковой конфигурацией парсятся только один раз, что значительно снижает накладные расходы при повторных рендерах или при использовании одного и того же контента в нескольких местах.
@@ -1057,6 +1164,48 @@ Intlayer v8 включает новый уровень кеширования д
 
 ---
 
+## Экспериментальные оптимизации сборки: Minify и Purge (v8.7.0)
+
+Intlayer v8.7.0 представляет новые экспериментальные функции сборки в вашем `intlayer.config.ts`, разработанные для оптимизации вашего продакшн-бандла:
+
+- **Минификация словарей**: Минифицирует файлы словарей для уменьшения их размера.
+- **Очистка неиспользуемых ключей (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`. Это позволяет явно задавать, как словари должны загружаться: статически, динамически или посредством синхронизации в реальном времени.
@@ -1204,6 +1353,49 @@ Markdown и HTML-контент в Svelte теперь автоматическ
 
 ---
 
+## Поддержка Angular: Сборщик Vite (v8.11.0)
+
+Для пользователей Angular Intlayer теперь нативно поддерживает сборщик Vite через новый кастомный плагин esbuild, ускоряя время разработки и сборки.
+
+Подробности о конфигурации см. в [Документации по окружению Angular](https://intlayer.org/doc/environment/angular).
+
+---
+
+## Генерация карты сайта (Sitemap) (v8.6.0)
+
+Intlayer теперь автоматически генерирует карты сайта на основе ваших локалей и режима маршрутизации. Это особенно полезно для 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/ru/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
+  - Совместимость
+  - Миграция
+  - Collections
+  - Variants
+  - Dynamic Records
+  - 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 стала проще, чем когда-либо. Мы создали пять пакетов совместимости (compat packages), которые предоставляют **точно такой же публичный 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}}` (с пробелами и путями через точку), аргументы в формате ICU (`{v, number, percent}` и т. д.) и простые шаблоны `{var}`.
+- **Резолвер узлов сообщений (Message Node Resolver)**: Разрешает вложенные узлы: `insert()`, `plural()` (плюрализация по правилам CLDR), `enu()` (перечисление), `gender()` (род), HTML-теги, массивы и вызываемые функции-узлы.
+- **Токенизированный парсер тегов (Tokenized Tag Parser)**: Поддерживает встроенные XML/HTML-теги и нумерованные теги (например, `<1>children</1>`) для рендеринга форматированного текста (rich-text) из коробки.
+
+---
+
+## Спецификация функций: Collections, Variants и Dynamic Records
+
+Intlayer v9 выходит за рамки статических объектов типа ключ-значение, позволяя словарям объявлять динамические структуры макетов со сквозной типизацией.
+
+### 1. Коллекции (Collections)
+
+Определяйте управляемый CMS упорядоченный список элементов (например, FAQ, товары или списки блогов):
+
+```ts fileName="faq.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  content: [
+    {
+      question: t({
+        ru: "Что такое Intlayer?",
+        en: "What is Intlayer?",
+        fr: "Qu'est-ce qu'Intlayer ?",
+      }),
+      answer: t({
+        ru: "Инструментарий 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-тестирования, сезонных заголовков, фича-флагов или кастомных целевых страниц:
+
+```ts fileName="hero.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "hero-banner",
+  variant: "default",
+  content: {
+    control: t({ ru: "Добро пожаловать", en: "Welcome", fr: "Bienvenue" }),
+    black_friday: t({
+      ru: "Купить сейчас",
+      en: "Shop now",
+      fr: "Acheter maintenant",
+    }),
+  },
+} satisfies Dictionary;
+```
+
+#### Использование:
+
+```ts
+const banner = useIntlayer("hero-banner", { variant: "black_friday" });
+```
+
+### 3. Динамические записи (Dynamic Records)
+
+Определяйте словари, записи которых загружаются динамически во время выполнения по идентификаторам запросов:
+
+```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({ ru: "Чистый код", 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 }`. Если ранее вы передавали строку локали напрямую, вы все еще можете это делать, но для расширенного выбора рекомендуется использовать объект опций.
+
+---
+
+## Полезные ссылки
+
+- [Руководство по пакетам адаптеров совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md)
+- [Динамические словари — Collections, Variants и Dynamic Records](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/index.md)
+- [Справочник по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md)

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

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-06-17
 title: Doküman İncelemesi
 description: Farklı yerellerdeki dokümantasyon dosyalarını kalite, tutarlılık ve tamlık açısından nasıl inceleyeceğinizi öğrenin.
 keywords:
@@ -15,6 +15,10 @@ slugs:
   - concept
   - cli
   - doc-review
+history:
+  - version: 9.0.0
+    date: 2026-06-17
+    changes: "--log seçeneği eklendi"
 author: aymericzip
 ---
 
@@ -55,8 +59,110 @@ Zaten çevrilmiş dosyaları incelemek ve çevirinin doğru olup olmadığını
 
 ## Argümanlar:
 
-`doc review` komutu, belirli dokümantasyon dosyalarını incelemenize ve kalite kontrolleri uygulamanıza olanak tanıyan `doc translate` ile aynı argümanları kabul eder.
+**Dosya listesi seçenekleri:**
 
-Eğer git seçeneklerinden birini etkinleştirdiyseniz, komut yalnızca değişen dosya kısımlarını inceleyecektir. Betik, dosyayı parçalara ayırarak işleyecek ve her parçayı inceleyecektir. Parçada değişiklik yoksa, betik inceleme sürecini hızlandırmak ve AI Sağlayıcı API maliyetini sınırlamak için o kısmı atlayacaktır.
+- **`--doc-pattern [docPattern...]`**: İncelemek için dokümantasyon dosyalarını eşleştirmek üzere glob desenleri.
 
-Tam argüman listesi için, bkz. [Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/doc-translate.md) komut dokümantasyonu.
+  > Örnek: `npx intlayer doc review --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: İncelemeden hariç tutulacak dosyaları eşleştirmek için glob desenleri.
+
+  > Örnek: `npx intlayer doc review --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Dosya belirtilen zamandan önce değiştirilmişse atla.
+  - Mutlak bir zaman olabilir, örneğin "2025-12-05" (string veya Date)
+  - Göreceli bir zaman olabilir, ms cinsinden `1 * 60 * 60 * 1000` (1 saat)
+  - Bu seçenek, dosyanın güncelleme zamanını `fs.stat` yöntemi ile kontrol eder. Bu nedenle, dosyayı değiştiren Git veya diğer araçlardan etkilenebilir.
+
+  > Örnek: `npx intlayer doc review --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Dosya belirtilen zaman içinde değiştirilmişse atla.
+  - Mutlak bir zaman olabilir, örneğin "2025-12-05" (string veya Date)
+  - Göreceli bir zaman olabilir, ms cinsinden `1 * 60 * 60 * 1000` (1 saat)
+  - Bu seçenek, dosyanın güncelleme zamanını `fs.stat` yöntemi ile kontrol eder. Bu nedenle, dosyayı değiştiren Git veya diğer araçlardan etkilenebilir.
+
+  > Örnek: `npx intlayer doc review --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Dosya zaten varsa atla.
+
+  > Örnek: `npx intlayer doc review --skip-if-exists`
+
+**İnceleme modu seçenekleri:**
+
+- **`--log`**: Yalnızca günlükleme modu. AI ile çeviri yapmaz; bunun yerine başka bir temsilcinin çevirileri oluşturmasına yardımcı olmak için temel ve hedef yerel ayarlar için dikkat gerektiren blokları (satır numaraları ve içerikleriyle birlikte) günlüğe kaydeder.
+
+  > Örnek: `npx intlayer doc review --log`
+
+**Girdi çıktı seçenekleri:**
+
+- **`--locales [locales...]`**: Dokümantasyonun inceleneceği hedef diller.
+
+  > Örnek: `npx intlayer doc review --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Karşılaştırılacak kaynak dil (temel belge).
+
+  > Örnek: `npx intlayer doc review --base-locale en`
+
+**Dosya işleme seçenekleri:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: İnceleme için eşzamanlı işlenecek dosya sayısı.
+
+  > Örnek: `npx intlayer doc review --nb-simultaneous-file-processed 5`
+
+**Yapay Zeka seçenekleri:**
+
+- **`--model [model]`**: İnceleme için kullanılacak yapay zeka modeli (örneğin, `gpt-3.5-turbo`).
+- **`--provider [provider]`**: İnceleme için kullanılacak yapay zeka sağlayıcısı.
+- **`--temperature [temperature]`**: Yapay zeka modeli için sıcaklık ayarı.
+- **`--api-key [apiKey]`**: Yapay zeka servisi için kendi API anahtarınızı sağlayın.
+- **`--application-context [applicationContext]`**: Yapay zeka incelemesi için ek bağlam sağlayın.
+- **`--data-serialization [dataSerialization]`**: Intlayer'ın AI özellikleri için kullanılacak veri serileştirme formatı. Seçenekler: `json` (standart, güvenilir), `toon` (daha az jeton, daha az tutarlı).
+- **`--custom-prompt [prompt]`**: İnceleme için kullanılan temel promptu özelleştirin. (Not: Çoğu durum için, davranış üzerinde daha iyi kontrol sağladığı için `--custom-instructions` seçeneği önerilir.)
+
+  > Örnek: `npx intlayer doc review --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "My application is a cat store"`
+
+**Ortam değişkenleri seçenekleri:**
+
+- **`--env`**: Ortamı belirtin (örneğin, `development`, `production`).
+- **`--env-file [envFile]`**: Değişkenleri yüklemek için özel bir ortam dosyası sağlayın.
+- **`--base-dir`**: Proje için temel dizini belirtin.
+- **`--no-cache`**: Önbelleği devre dışı bırakın.
+
+  > Örnek: `npx intlayer doc review --base-dir ./docs --env-file .env.production.local`
+
+**Günlük seçenekleri:**
+
+- **`--verbose`**: Hata ayıklama için ayrıntılı günlüklemeyi etkinleştirir. (CLI kullanıldığında varsayılan olarak true)
+
+  > Örnek: `npx intlayer doc review --verbose`
+
+**Özel talimatlar seçenekleri:**
+
+- **`--custom-instructions [customInstructions]`**: Prompt'a eklenen özel talimatlar. Biçimlendirme, URL çevirisi vb. konularda belirli kurallar uygulamak için kullanışlıdır.
+
+  > Örnek: `npx intlayer doc review --custom-instructions "URL çevirilerini yapmaktan kaçının ve markdown formatını koruyun"`
+
+  > Örnek: `npx intlayer doc review --custom-instructions "$(cat ./instructions.md)"`
+
+**Git seçenekleri:**
+
+- **`--git-diff`**: Sadece temel (varsayılan `origin/main`) ile mevcut dal (varsayılan: `HEAD`) arasındaki değişiklikleri içeren dosyalarda çalıştırır.
+- **`--git-diff-base`**: git diff için temel referansı belirtir (varsayılan `origin/main`).
+- **`--git-diff-current`**: git diff için mevcut referansı belirtir (varsayılan `HEAD`).
+- **`--uncommitted`**: İşlenmemiş değişiklikleri dahil eder.
+- **`--unpushed`**: Gönderilmemiş değişiklikleri dahil eder.
+- **`--untracked`**: İzlenmeyen dosyaları dahil eder.
+
+  > Örnek: `npx intlayer doc review --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Örnek: `npx intlayer doc review --uncommitted --unpushed --untracked`
+
+> Çıktı dosya yolunun aşağıdaki kalıplar değiştirilerek belirleneceğini unutmayın:
+>
+> - `/{{baseLocale}}/` yerine `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` yerine `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` yerine `_{{locale}}.`
+> - `{{baseLocale}}_` yerine `{{locale}}_`
+> - `.{{baseLocaleName}}.` yerine `.{{localeName}}.`
+>
+> Eğer kalıp bulunamazsa, çıktı dosyasının uzantısına `.{{locale}}` eklenecektir. Örneğin `./my/file.md` dosyası incelenecek ve Fransızca için `./my/file.fr.md` olarak güncellenecektir.

package/docs/tr/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 komutu eklendi"
   - version: 8.6.4

package/docs/tr/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 komutu eklendi"
 author: aymericzip