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

package/docs/pt/releases/v8.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-22
-updatedAt: 2026-01-26
+updatedAt: 2026-06-14
 title: Novo Intlayer v8 - O que há de novo?
 description: Descubra as novidades do Intlayer v8. Principais melhorias na experiência do desenvolvedor, validação de esquemas e gestão de dicionários.
 keywords:
@@ -409,6 +409,16 @@ Para mais detalhes, consulte a [Documentação de Conteúdo HTML](https://github
 
 ---
 
+## Ficheiros de Conteúdo YAML & Markdown (v8.10.0)
+
+Agora pode declarar conteúdo diretamente usando as extensões de ficheiro `.content.md` e `.content.yaml`. Isto é perfeito para conteúdos longos, blogs, documentação e políticas de privacidade.
+
+Estes ficheiros são totalmente editáveis a partir do Visual Editor, proporcionando um fluxo de trabalho simplificado para membros não técnicos da equipa.
+
+Para mais detalhes, consulte a [Documentação de Ficheiros de Conteúdo YAML](https://intlayer.org/doc/concept/content#yaml-content-file) e a [Documentação de Ficheiros de Conteúdo Markdown](https://intlayer.org/doc/concept/content/markdown).
+
+---
+
 ## Reescritas de URL Personalizadas
 
 O Intlayer v8 introduz suporte para **Reescritas de URL Personalizadas**, permitindo que você defina caminhos específicos por localidade que diferem da estrutura padrão `/locale/path`. Este é um recurso poderoso para melhorar o local SEO e proporcionar uma experiência de usuário mais natural para usuários que não falam inglês.
@@ -753,6 +763,58 @@ export default {
   </Tab>
 </Tabs>
 
+## Regras de Plural Unicode CLDR (v8.8.0)
+
+Foi introduzido um novo helper de nó `plural` baseado nas regras de plural definidas pelo Projeto Unicode CLDR, melhorando o suporte para idiomas complexos.
+
+```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;
+```
+
+Você pode então passar a contagem dinamicamente no componente do seu framework:
+
+```tsx
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const OpeningsComponent: FC<{ count: number }> = ({ count }) => {
+  const { totalOpenings } = useIntlayer("total_openings");
+
+  return (
+    <div>
+      {/* Em Inglês:                                  */}
+      {/*  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>
+  );
+};
+```
+
+Para mais informações, consulte a [Documentação de Pluralização](https://intlayer.org/doc/concept/content/plural).
+
+---
+
 ## Validação de Esquema de Conteúdo
 
 O Intlayer v8 introduz a validação de esquema para dicionários. Agora você pode definir esquemas de validação reutilizáveis em sua configuração usando Zod e aplicá-los aos seus arquivos de conteúdo. Isso garante que seu conteúdo sempre adira à estrutura esperada, capturando erros em tempo de build.
@@ -797,6 +859,34 @@ Se o conteúdo não corresponder ao esquema (por exemplo, o título é muito cur
 
 ---
 
+## TypeScript: Acessores Primitivos IntlayerNode
+
+O tipo `IntlayerNode` foi atualizado para permitir a chamada de métodos JavaScript primitivos diretamente nos nós de conteúdo. Isto torna possível interagir com o seu conteúdo localizado diretamente como se fosse uma primitiva padrão de string, number, boolean ou array.
+
+Suportado em React, Preact, Solid, Svelte, Vue e Angular.
+
+### Exemplo de String
+
+```typescript
+content.placeholder; // Retorna IntlayerNode<string>
+content.placeholder.value; // Retorna string
+content.placeholder.toString(); // Retorna string
+content.placeholder.toLowerCase(); // Retorna string
+String(content.placeholder); // Retorna string
+content.placeholder.toUpperCase(); // Retorna string em maiúsculas
+content.placeholder.replace("a", "b"); // Retorna string modificada
+```
+
+### Exemplo de Array
+
+```typescript
+content.myArrayOfString             // Retorna IntlayerNode<Array<string>>
+content.myArrayOfString.find(...)   // Retorna elemento
+content.myArrayOfString.join(', ')  // Retorna string unida
+```
+
+---
+
 ### Detecção Automática de Conteúdo Aprimorada
 
 Na v8, o Intlayer detecta inteligentemente a sintaxe Markdown, tags HTML e inserções de variáveis em suas strings de conteúdo. Isso significa que muitas vezes você pode omitir funções auxiliares como `md()`, `html()` ou `insert()`.
@@ -1002,6 +1092,17 @@ A extensão Intlayer para VSCode recebe atualizações significativas na v8 para
 
 ---
 
+## Ferramentas: Watcher C++ & LSP baseado em OXC (v8.12.0)
+
+O Intlayer v8.12.0 traz grandes melhorias para a experiência do desenvolvedor:
+
+- **Parcel Watcher**: O watcher de conteúdo foi migrado de `chokidar` para `@parcel/watcher`, aproveitando a monitorização nativa de ficheiros em C++ para fornecer atualizações mais rápidas e um consumo de memória significativamente menor.
+- **Novo Language Server Protocol (LSP)**: Um novo LSP está agora disponível. Construído com análise baseada em OXC, ajuda o seu IDE e agentes de IA a ligar perfeitamente as chamadas `useIntlayer('my-key')` aos seus ficheiros `.content` correspondentes, e vice-versa.
+
+Para mais detalhes, consulte a [Documentação do LSP](https://intlayer.org/doc/lsp).
+
+---
+
 ## Otimizações do Compilador
 
 Intlayer v8 inclui uma nova camada de cache para o compilador Markdown e HTML. Isso garante que strings de conteúdo idênticas com a mesma configuração sejam analisadas apenas uma vez, reduzindo significativamente a sobrecarga durante re-renders ou quando o mesmo conteúdo é usado em vários lugares.
@@ -1057,6 +1158,48 @@ Intlayer v8 inclui uma nova camada de cache para o compilador Markdown e HTML. I
 
 ---
 
+## Otimizações de Build Experimentais: Minify & Purge (v8.7.0)
+
+O Intlayer v8.7.0 introduz novos recursos experimentais de build no seu `intlayer.config.ts` projetados para otimizar o seu bundle de produção:
+
+- **Minimização de Dicionários (Minify)**: Minimiza os ficheiros de dicionário para reduzir o tamanho.
+- **Purga de Chaves Não Utilizadas (Purge)**: Varre e remove chaves de tradução não utilizadas dos dicionários, renomeando as chaves ativas para caracteres curtos (por exemplo, `"products" -> "a"`, `"pricing" -> "b"`). Isto reduz o tamanho do bundle em até 5%.
+- **Desativar Verificações TypeScript**: Acelera as builds desativando a verificação de tipos TypeScript durante a etapa de compilação.
+
+```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: {
+    /**
+     * Minimiza os dicionários para reduzir o tamanho do bundle.
+     */
+    minify: true,
+
+    /**
+     * Purga as chaves não utilizadas nos dicionários
+     */
+    purge: true,
+
+    /**
+     * Indica se a build deve verificar os tipos TypeScript
+     */
+    checkTypes: false,
+  },
+};
+
+export default config;
+```
+
+---
+
 ## Flexibilidade: Modo Unificado de Importação
 
 A propriedade booleana `live` foi descontinuada em favor de uma propriedade mais abrangente `importMode`. Isso permite a definição explícita de como os dicionários devem ser carregados: estaticamente, dinamicamente ou via sincronização ao vivo.
@@ -1204,6 +1347,49 @@ Conteúdo Markdown e HTML no Svelte agora é automaticamente convertido para HTM
 
 ---
 
+## Suporte Angular: Vite Bundler (v8.11.0)
+
+Para utilizadores do Angular, o Intlayer agora suporta nativamente o bundler Vite através de um novo plugin esbuild personalizado, acelerando os tempos de desenvolvimento e build.
+
+Para detalhes sobre a configuração, consulte a [Documentação do Ambiente Angular](https://intlayer.org/doc/environment/angular).
+
+---
+
+## Geração de Sitemap (v8.6.0)
+
+O Intlayer agora gera sitemaps automaticamente com base nas suas localidades e modo de roteamento. Isto é particularmente útil para otimização de SEO em arquiteturas de roteador como o 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" },
+        });
+      },
+    },
+  },
+});
+```
+
+---
+
 ## Notas de migração da v7
 
 ### Alterações na Configuração

package/docs/pt/releases/v9.md

@@ -0,0 +1,232 @@
+---
+createdAt: 2026-06-14
+updatedAt: 2026-06-14
+title: Novo Intlayer v9 - O que há de novo?
+description: Descubra o que há de novo no Intlayer v9. Apresentando pacotes de compatibilidade drop-in para bibliotecas i18n populares e suporte para Collections, Variants e Dynamic Records.
+keywords:
+  - Intlayer
+  - Compatibility
+  - Migration
+  - Collections
+  - Variants
+  - Dynamic Records
+  - i18next
+  - next-intl
+  - vue-i18n
+slugs:
+  - doc
+  - releases
+  - v9
+author: aymericzip
+---
+
+# Novo Intlayer v9 - O que há de novo?
+
+Bem-vindo ao Intlayer v9! Este grande lançamento marca um marco enorme na simplificação do caminho de migração para o Intlayer com **Compat Adapter Packages** para as principais bibliotecas de i18n (`react-i18next`, `next-intl`, `vue-i18n`, etc.) e adiciona suporte para estruturas de conteúdo ricas: **Collections**, **Variants** e **Dynamic Records**.
+
+## Tabela de conteúdos
+
+<TOC levels={[2]} maxDepth={1} />
+
+---
+
+## Compat Adapter Packages
+
+Migrar para o Intlayer a partir de bibliotecas i18n populares agora é mais fácil do que nunca. Criamos cinco pacotes de compatibilidade que expõem as **mesmas APIs públicas** que as bibliotecas i18n padrão, mas delegam todo o trabalho de tradução para o Intlayer em runtime.
+
+### Expor a Mesma API Pública com Strict Typing
+
+Ao substituir os imports, você obtém todos os benefícios do Intlayer (incluindo type safety em tempo de compilação contra seus dicionários reais) com o mínimo de alterações no código:
+
+- `@intlayer/i18next`
+- `@intlayer/react-i18next`
+- `@intlayer/next-intl`
+- `@intlayer/next-i18next`
+- `@intlayer/vue-i18n`
+
+Por exemplo, basta alterar:
+
+```ts
+import { useTranslation } from "react-i18next";
+```
+
+para:
+
+```ts
+import { useTranslation } from "@intlayer/react-i18next";
+```
+
+Suas chaves agora serão **strictly typed** (fortemente tipadas) contra seus dicionários Intlayer, oferecendo auto-complete completo de dot-path na sua IDE!
+
+### Plugins de Alias de Bundler (Vite, Next.js, Turbopack)
+
+Para permitir a migração sem reescrever todas as suas declarações de import manualmente, cada pacote de compatibilidade inclui um **plugin de bundler personalizado** (Vite ou Next.js) sob o subcaminho `/plugin`.
+
+Esses plugins reescrevem automaticamente os imports existentes (ex: `react-i18next` ou `next-intl`) para seus equivalentes `@intlayer/*` em tempo de build.
+
+#### Exemplo de Next.js (Webpack / Turbopack)
+
+Em vez de `withIntlayer`, envolva sua configuração do Next.js com o plugin de compatibilidade:
+
+```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);
+```
+
+#### Exemplo de 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
+
+Todos os adaptadores de compatibilidade agora roteiam a resolução de tradução através de um único parser de runtime altamente otimizado: `@intlayer/core/messageFormat`.
+
+- **Interpolate Message**: Resolve `{{var}}` padrão (espaços em branco e dot-paths), argumentos formatados em ICU (`{v, number, percent}` etc.) e templates simples `{var}`.
+- **Message Node Resolver**: Resolve nós aninhados: `insert()`, `plural()` (regras de plural CLDR), `enu()` (enumeração), `gender()`, tags HTML, arrays e nós de funções chamáveis.
+- **Tokenized Tag Parser**: Suporta tags XML/HTML inline e tags numeradas (ex: `<1>children</1>`) para habilitar renderização de rich-text nativamente.
+
+---
+
+## Especificação de Recursos: Collections, Variants & Dynamic Records
+
+O Intlayer v9 vai além de objetos estáticos de chave-valor, permitindo que os dicionários declarem estruturas de layout dinâmicas que são totalmente tipadas de ponta a ponta.
+
+### 1. Collections
+
+Defina uma lista gerenciada por CMS de itens ordenados (ex: FAQs, produtos ou listas de blog):
+
+```ts fileName="faq.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  content: [
+    {
+      question: t({
+        pt: "O que é o Intlayer?",
+        en: "What is Intlayer?",
+        fr: "Qu'est-ce qu'Intlayer ?",
+      }),
+      answer: t({
+        pt: "Um kit de ferramentas i18n.",
+        en: "An i18n toolkit.",
+        fr: "Une boîte à outils i18n.",
+      }),
+    },
+  ],
+} satisfies Dictionary;
+```
+
+#### Uso:
+
+```ts
+// Buscar todos os itens
+const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
+
+// Buscar um único item por índice
+const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+```
+
+### 2. Variants
+
+Entregue testes A/B, cabeçalhos sazonais, feature flags ou landing pages personalizadas:
+
+```ts fileName="hero.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "hero-banner",
+  variant: "default",
+  content: {
+    control: t({ pt: "Bem-vindo", en: "Welcome", fr: "Bienvenue" }),
+    black_friday: t({
+      pt: "Compre agora",
+      en: "Shop now",
+      fr: "Acheter maintenant",
+    }),
+  },
+} satisfies Dictionary;
+```
+
+#### Uso:
+
+```ts
+const banner = useIntlayer("hero-banner", { variant: "black_friday" });
+```
+
+### 3. Dynamic Records
+
+Defina dicionários cujas entradas são carregadas dinamicamente em runtime via IDs de consulta:
+
+```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({ pt: "Código Limpo", en: "Clean Code", fr: "Code Propre" }),
+  },
+} satisfies Dictionary;
+```
+
+#### Uso:
+
+```ts
+// Busca apenas o item solicitado dinamicamente (requer Suspense)
+const product = useIntlayer("product-copy", {
+  id: "prod_123",
+  category: "books",
+});
+```
+
+---
+
+## Carregamento Dinâmico & Otimizações de Tamanho de Bundle
+
+Para manter os bundles extremamente pequenos, o Intlayer v9 suporta dynamic lazy loading.
+
+Na sua configuração, defina `importMode` como `'dynamic'` ou `'fetch'`:
+
+```ts fileName="intlayer.config.ts"
+export default {
+  dictionary: {
+    importMode: "dynamic", // "static" | "dynamic" | "fetch"
+  },
+};
+```
+
+Em tempo de build, o `@intlayer/swc` e o `@intlayer/babel` escaneiam seus arquivos e substituem as chamadas de `useIntlayer` / `getIntlayer` por wrappers tree-shakeable (`useDictionary` / `useDictionaryDynamic`). Apenas o conteúdo necessário para o item da coleção, variante ou locale selecionado é carregado, evitando que seu bundle de produção contenha traduções não utilizadas.
+
+---
+
+## Notas de migração da v8
+
+Se você estiver atualizando da v8, observe que a v9 não inclui breaking changes. Mas aqui estão as principais mudanças:
+
+- **Locales & Dialects**: Se estiver usando dependências externas de i18n, adicione seus respectivos plugins de compatibilidade na sua configuração ou setup do bundler para reescrever os imports automaticamente.
+- **Custom Selectors**: Ao chamar `useIntlayer`, o segundo parâmetro agora é reservado para um objeto de opções contendo `{ locale, item, variant, id }`. Se você passava anteriormente uma string de locale diretamente, ainda pode fazer isso, mas o uso do objeto de opções é recomendado para seleções avançadas.
+
+---
+
+## Links úteis
+
+- [Guia de Compat Adapter Packages](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/compat/index.md)
+- [Dicionários Dinâmicos - Collections, Variants & Dynamic Records](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dynamic_dictionaries/index.md)
+- [Referência de Configuração](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/configuration.md)

package/docs/ru/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, команда будет проверять только ту часть файлов, которая изменяется. Скрипт будет обрабатывать файл по частям (чанкам) и проверять каждый из них. Если в чанке нет изменений, скрипт пропустит его, чтобы ускорить процесс проверки и снизить стоимость использования API AI-провайдера.
+- **`--doc-pattern [docPattern...]`**: Глобальные шаблоны для выбора файлов документации, которые нужно проверить.
 
-Для полного списка аргументов смотрите документацию команды [Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/doc-translate.md).
+  > Пример: `npx intlayer doc review --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Глобальные шаблоны для исключения файлов из проверки.
+
+  > Пример: `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`**: Режим только логирования. Не переводить с помощью ИИ; вместо этого логировать блоки, требующие внимания (с номерами строк и содержимым) для базовой и целевой локалей, чтобы помочь другому агенту сгенерировать переводы.
+
+  > Пример: `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`
+
+**Опции ИИ:**
+
+- **`--model [model]`**: Модель ИИ, используемая для проверки (например, `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Провайдер ИИ, используемый для проверки.
+- **`--temperature [temperature]`**: Параметр температуры для модели ИИ.
+- **`--api-key [apiKey]`**: Предоставьте свой собственный API-ключ для сервиса ИИ.
+- **`--application-context [applicationContext]`**: Предоставьте дополнительный контекст для проверки ИИ.
+- **`--data-serialization [dataSerialization]`**: Формат сериализации данных для использования в функциях ИИ Intlayer. Опции: `json` (стандартный, надежный), `toon` (меньше токенов, менее стабильный).
+- **`--custom-prompt [prompt]`**: Настройка базового запроса, используемого для проверки. (Примечание: для большинства случаев рекомендуется использовать опцию `--custom-instructions`, так как она обеспечивает лучший контроль.)
+
+  > Пример: `npx intlayer doc review --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "Мое приложение, магазин для кошек"`
+
+**Опции переменных окружения:**
+
+- **`--env`**: Указать окружение (например, `development`, `production`).
+- **`--env-file [envFile]`**: Указать пользовательский файл окружения для загрузки переменных.
+- **`--base-dir`**: Указать базовую директорию проекта.
+- **`--no-cache`**: Отключить кэш.
+
+  > Пример: `npx intlayer doc review --base-dir ./docs --env-file .env.production.local`
+
+**Опции логирования:**
+
+- **`--verbose`**: Включить подробное логирование для отладки. (по умолчанию включено при использовании CLI)
+
+  > Пример: `npx intlayer doc review --verbose`
+
+**Опции пользовательских инструкций:**
+
+- **`--custom-instructions [customInstructions]`**: Пользовательские инструкции, добавляемые в запрос. Полезно для применения специфических правил касательно форматирования, перевода URL и т.д.
+
+  > Пример: `npx intlayer doc review --custom-instructions "Избегайте перевода URL и сохраняйте формат markdown"`
+
+  > Пример: `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/ru/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/ru/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