@intlayer/docs 7.5.11 → 7.5.13

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

@@ -0,0 +1,132 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Переклад документа
+description: Дізнайтеся, як автоматично перекладати файли документації за допомогою AI-сервісів перекладу.
+keywords:
+  - Переклад
+  - Документ
+  - Документація
+  - AI
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - doc-translate
+---
+
+# Переклад документа
+
+Команда `doc translate` автоматично перекладає файли документації з базової локалі до цільових локалей за допомогою AI-сервісів перекладу.
+
+```bash
+npx intlayer doc translate
+```
+
+## Аргументи:
+
+**Параметри списку файлів:**
+
+- **`--doc-pattern [docPattern...]`**: Глобальні шаблони (glob) для співпадіння файлів документації, які потрібно перекласти.
+
+  > Приклад: `npx intlayer doc translate --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Glob-шаблони, які слід виключити з перекладу.
+
+  > Приклад: `npx intlayer doc translate --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 translate --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Пропустити файл, якщо він був змінений протягом вказаного проміжку часу.
+  - Може бути абсолютним часом, наприклад "2025-12-05" (рядок або Date)
+  - Може бути відносним часом у мс `1 * 60 * 60 * 1000` (1 година)
+  - Ця опція перевіряє час оновлення файлу за допомогою методу `fs.stat`. Тому вона може залежати від Git або інших інструментів, які змінюють файл.
+
+  > Example: `npx intlayer doc translate --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Пропустити файл, якщо він уже існує.
+
+  > Example: `npx intlayer doc translate --skip-if-exists`
+
+**Параметри виводу записів:**
+
+- **`--locales [locales...]`**: Цільові локалі для перекладу документації.
+
+  > Example: `npx intlayer doc translate --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Базова локаль, з якої перекладати.
+
+  > Example: `npx intlayer doc translate --base-locale en`
+
+**Параметри обробки файлів:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Кількість файлів для одночасної обробки під час перекладу.
+
+  > Приклад: `npx intlayer doc translate --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.
+- **`--custom-prompt [prompt]`**: Налаштувати базовий prompt, який використовується для перекладу. (Примітка: у більшості випадків натомість рекомендується використовувати опцію `--custom-instructions`, оскільки вона дає кращий контроль над поведінкою перекладу.)
+
+  > Приклад: `npx intlayer doc translate --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 translate --base-dir ./docs --env-file .env.production.local`
+
+**Параметри логування:**
+
+- **`--verbose`**: Увімкнути детальне логування для налагодження. (за замовчуванням true при використанні CLI)
+
+  > Приклад: `npx intlayer doc translate --verbose`
+
+**Параметри користувацьких інструкцій:**
+
+- **`--custom-instructions [customInstructions]`**: Користувацькі інструкції, додані до prompt. Корисно для застосування специфічних правил щодо форматування, перекладу URL тощо.
+  - Може бути абсолютним часом, наприклад "2025-12-05" (рядок або Date)
+  - Може бути відносним часом у мс `1 * 60 * 60 * 1000` (1 година)
+  - Ця опція перевіряє час оновлення файлу за допомогою методу `fs.stat`. Тож це може залежати від Git або інших інструментів, які змінюють файл.
+
+  > Приклад: `npx intlayer doc translate --custom-instructions "Avoid translating urls, and keep the markdown format"`
+
+  > Приклад: `npx intlayer doc translate --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 translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Приклад: `npx intlayer doc translate --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/editor.md

@@ -0,0 +1,28 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Команди редактора
+description: Дізнайтеся, як використовувати команди редактора Intlayer.
+keywords:
+  - Editor
+  - Visual Editor
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - editor
+---
+
+# Команди редактора
+
+Команда `editor` обгортає команди `intlayer-editor`.
+
+> Щоб мати можливість використовувати команду `editor`, пакет `intlayer-editor` має бути встановлений. (Див. [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_visual_editor.md))
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:editor:start": "npx intlayer editor start --with 'next dev --turbopack'"
+}
+```

package/docs/uk/cli/fill.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Заповнення словників
+description: Дізнайтеся, як заповнювати, перевіряти та перекладати ваші словники за допомогою AI.
+keywords:
+  - Заповнення
+  - Аудит
+  - Переклад
+  - Словники
+  - CLI
+  - Intlayer
+  - AI
+slugs:
+  - doc
+  - concept
+  - cli
+  - fill
+---
+
+# Заповнення / аудит / переклад словників
+
+```bash
+npx intlayer fill
+```
+
+Ця команда аналізує ваші файли декларацій контенту на предмет потенційних проблем, таких як відсутні переклади, структурні невідповідності або невідповідності типів. Якщо будуть виявлені якісь проблеми, **intlayer fill** запропонує або застосує оновлення, щоб тримати ваші словники консистентними та повними.
+
+## Аліаси:
+
+- `npx intlayer dictionaries fill`
+- `npx intlayer dictionary fill`
+- `npx intlayer dic fill`
+
+## Аргументи:
+
+**Опції списку файлів:**
+
+- **`-f, --file [files...]`**: Список конкретних файлів декларації контенту для перевірки. Якщо не вказано, будуть перевірені всі виявлені `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` згідно з налаштуваннями вашого конфігураційного файлу.
+
+  > Приклад: `npx intlayer dictionary fill -f src/home/app.content.ts`
+
+- **`-k, --keys [keys...]`**: Фільтрувати словники за ключами. Якщо не вказано, будуть перевірені всі словники.
+
+  > Приклад: `npx intlayer dictionary fill -k key1 key2`
+
+- **`--key [keys...]`**: Фільтрувати словники за ключами (псевдонім для --keys).
+
+  > Приклад: `npx intlayer dictionary fill --key key1 key2`
+
+- **`--excluded-keys [excludedKeys...]`**: Виключати словники за ключами. Якщо не вказано, будуть перевірені всі словники.
+
+  > Приклад: `npx intlayer dictionary fill --excluded-keys key1 key2`
+
+- **`--excluded-key [excludedKeys...]`**: Фільтрувати словники за ключами (синонім для --excluded-keys).
+
+  > Приклад: `npx intlayer dictionary fill --excluded-key key1 key2`
+
+- **`--path-filter [pathFilters...]`**: Фільтрувати словники на основі шаблону glob для шляхів файлів.
+
+  > Приклад: `npx intlayer dictionary fill --path-filter "src/home/**"`
+
+**Параметри виводу записів:**
+
+- **`--source-locale [sourceLocale]`**: Початкова локаль для перекладу. Якщо не вказано, буде використана локаль за замовчуванням з вашої конфігурації.
+
+- **`--output-locales [outputLocales...]`**: Цільові локалі для перекладу. Якщо не вказано, будуть використані всі локалі з вашої конфігурації, за винятком початкової локалі.
+
+- **`--mode [mode]`**: Режим перекладу: `complete`, `review`. За замовчуванням — `complete`. `complete` заповнює весь відсутній контент, `review` заповнює відсутній контент та переглядає наявні ключі.
+
+**Параметри 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 translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Приклад: `npx intlayer doc translate --uncommitted --unpushed --untracked`
+
+**Параметри AI:**
+
+- **`--model [model]`**: Модель AI для перекладу (наприклад, `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Провайдер AI, який буде використаний для перекладу.
+- **`--temperature [temperature]`**: Параметр temperature для моделі AI.
+- **`--api-key [apiKey]`**: Надайте власний API-ключ для сервісу AI.
+- **`--custom-prompt [prompt]`**: Надайте власний prompt для інструкцій перекладу.
+- **`--application-context [applicationContext]`**: Надайте додатковий контекст для перекладу AI.
+
+  > Приклад: `npx intlayer fill --model gpt-3.5-turbo --provider openai --temperature 0.5 --api-key sk-1234567890 --application-context "My application is a cat store"`
+
+**Параметри змінних середовища:**
+
+- **`--env`**: Вказати середовище (наприклад, `development`, `production`).
+- **`--env-file [envFile]`**: Надати власний файл середовища для завантаження змінних.
+
+  > Приклад: `npx intlayer fill --env-file .env.production.local`
+
+  > Приклад: `npx intlayer fill --env production`
+
+**Параметри конфігурації:**
+
+- **`--base-dir`**: Вказати базовий каталог для проєкту.
+
+  > Приклад: `npx intlayer fill --base-dir ./src`
+
+- **`--no-cache`**: Вимкнути кеш.
+
+  > Приклад: `npx intlayer build --no-cache`
+
+**Опції підготовки:**
+
+- **`--build`**: Збирати словники перед відправкою, щоб забезпечити актуальність контенту. True примусово виконає збірку, false пропустить збірку, undefined дозволить використовувати кеш збірки.
+
+- **`--skip-metadata`**: Пропустити заповнення відсутніх метаданих (description, title, tags) для словників.
+
+**Опції логування:**
+
+- **`--verbose`**: Увімкнути детальне (verbose) логування для налагодження. (за замовчуванням true при використанні CLI)
+
+## Приклад:
+
+```bash
+npx intlayer fill --file src/home/*.content.ts --source-locale en --output-locales fr es --model gpt-3.5-turbo
+```
+
+Ця команда перекладе вміст з англійської на французьку та іспанську для всіх файлів декларацій вмісту в директорії `src/home/`, використовуючи модель GPT-3.5 Turbo.

package/docs/uk/cli/index.md

@@ -0,0 +1,190 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2026-01-06
+title: CLI - Усі CLI-команди Intlayer для вашого багатомовного вебсайту
+description: Дізнайтеся, як використовувати Intlayer CLI для керування вашим багатомовним вебсайтом. Дотримуйтесь кроків цієї онлайн-документації, щоб налаштувати проєкт за кілька хвилин.
+keywords:
+  - CLI
+  - Command Line Interface
+  - Internationalization
+  - Документація
+  - Intlayer
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - concept
+  - cli
+history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Додано команду CI
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Додано команду списку проєктів
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Додано команду init
+  - version: 7.2.3
+    date: 2025-11-22
+    changes: Додано команду transform
+  - version: 7.1.0
+    date: 2025-11-05
+    changes: Додано опцію skipIfExists для команди translate
+  - version: 6.1.4
+    date: 2025-01-27
+    changes: Додано aliases для аргументів і команд CLI
+  - version: 6.1.3
+    date: 2025-10-05
+    changes: Додано опцію build для команд
+  - version: 6.1.2
+    date: 2025-09-26
+    changes: Додано команду version
+  - version: 6.1.0
+    date: 2025-09-26
+    changes: Встановлено опцію verbose за замовчуванням у true через CLI
+  - version: 6.1.0
+    date: 2025-09-23
+    changes: Додано команду watch та опцію with
+  - version: 6.0.1
+    date: 2025-09-23
+    changes: Додано команду editor
+  - version: 6.0.0
+    date: 2025-09-17
+    changes: Додано команди content test і list
+  - version: 5.5.11
+    date: 2025-07-11
+    changes: Оновлено документацію параметрів команд CLI
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Ініціалізація історії
+---
+
+# Intlayer CLI — Усі команди Intlayer CLI для вашого багатомовного сайту
+
+---
+
+## Table of Contents
+
+<TOC/>
+
+---
+
+## Встановлення пакету
+
+Встановіть необхідні пакети за допомогою одного з пакетних менеджерів:
+
+```bash packageManager="npm"
+npm install intlayer-cli -g
+```
+
+```bash packageManager="yarn"
+yarn add intlayer-cli -g
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer-cli -g
+```
+
+```bash packageManager="bun"
+bun add intlayer-cli -g
+```
+
+> Якщо пакет `intlayer` уже встановлено, CLI встановлюється автоматично. Ви можете пропустити цей крок.
+
+## Пакет intlayer-cli
+
+Пакет `intlayer-cli` призначений для трансляції ваших [оголошень intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/content_file.md) у словники.
+
+Цей пакет транспілює всі файли Intlayer, наприклад `src/**/*.content.{ts|js|mjs|cjs|json}`. [Див. як оголосити ваші файли декларацій Intlayer](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
+
+Щоб інтерпретувати словники Intlayer, ви можете використовувати інтерпретатори, такі як [react-intlayer](https://www.npmjs.com/package/react-intlayer) або [next-intlayer](https://www.npmjs.com/package/next-intlayer).
+
+## Підтримка конфігураційних файлів
+
+Intlayer підтримує кілька форматів конфігураційних файлів:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Щоб дізнатися, як налаштувати доступні локалі або інші параметри, перегляньте [документацію з конфігурації](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md).
+
+## Запуск команд intlayer
+
+### Аутентифікація
+
+- **[Вхід](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/login.md)** - Аутентифікація в Intlayer CMS і отримання облікових даних доступу
+
+### Основні команди
+
+- **[Побудова словників](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/build.md)** - Побудуйте словники з файлів декларацій контенту
+- **[Спостереження за словниками](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/watch.md)** - Слідкувати за змінами та автоматично збирати словники
+- **[Перевірити версію CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/version.md)** - Перевірити встановлену версію Intlayer CLI
+- **[Список проєктів](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/list_projects.md)** - Перелічити всі проєкти Intlayer у директорії або git-репозиторії
+
+### Керування словниками
+
+- **[Відправити словники](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/push.md)** - Відправити словники до редактора та CMS Intlayer
+- **[Завантажити словники](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/pull.md)** - Завантажити словники з редактора та CMS Intlayer
+- **[Заповнити словники](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/fill.md)** - Заповнюйте, перевіряйте та перекладайте словники за допомогою AI
+- **[Перевірити відсутні переклади](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/test.md)** - Перевіряйте та виявляйте відсутні переклади
+- **[Перелічити файли декларації контенту](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/list.md)** - Перелічити всі файли декларації контенту у вашому проєкті
+
+### Керування компонентами
+
+- **[Трансформувати компоненти](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/transform.md)** - Трансформувати існуючі компоненти для використання Intlayer
+
+### Конфігурація
+
+- **[Ініціалізація Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/init.md)** - Налаштуйте Intlayer у вашому проєкті з автоматичною конфігурацією
+- **[Управління конфігурацією](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/configuration.md)** - Отримуйте та надсилайте конфігурацію Intlayer до CMS
+
+### Управління документацією
+
+- **[Переклад документа](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/doc-translate.md)** - Автоматично перекладайте файли документації за допомогою AI
+- **[Перевірка документа](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/doc-review.md)** - Перевіряйте файли документації на якість та узгодженість
+
+### Редактор та Live Sync
+
+- **[Команди редактора](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/editor.md)** - Використовуйте команди редактора Intlayer
+- **[Команди Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/live.md)** - Використовуйте Live Sync, щоб відображати зміни контенту CMS під час виконання
+
+### CI/CD та автоматизація
+
+- **[CI Command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/ci.md)** - Запускайте команди Intlayer з автоматично підставленими обліковими даними для CI/CD пайплайнів
+
+### Інструменти розробки
+
+- **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/sdk.md)** - Використовуйте Intlayer CLI SDK у власному коді
+- **[Команда налагодження Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/debug.md)** - Налагоджуйте та усувайте проблеми CLI Intlayer
+
+## Використовуйте команди intlayer у вашому `package.json`
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:init": "npx intlayer init",
+  "intlayer:login": "npx intlayer login",
+  "intlayer:build": "npx intlayer build",
+  "intlayer:watch": "npx intlayer build --watch",
+  "intlayer:push": "npx intlayer push",
+  "intlayer:pull": "npx intlayer pull",
+  "intlayer:fill": "npx intlayer fill",
+  "intlayer:list": "npx intlayer content list",
+  "intlayer:test": "npx intlayer content test",
+  "intlayer:transform": "npx intlayer transform",
+  "intlayer:projects": "npx intlayer projects list",
+  "intlayer:doc:translate": "npx intlayer doc translate",
+  "intlayer:doc:review": "npx intlayer doc review"
+}
+```
+
+> **Примітка**: Ви також можете використовувати коротші псевдоніми:
+>
+> - `npx intlayer list` замість `npx intlayer content list`
+> - `npx intlayer test` замість `npx intlayer content test`
+> - `npx intlayer projects-list` або `npx intlayer pl` замість `npx intlayer projects list`

package/docs/uk/cli/init.md

@@ -0,0 +1,84 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2025-12-30
+title: Ініціалізація Intlayer
+description: Дізнайтесь, як ініціалізувати Intlayer у вашому проєкті.
+keywords:
+  - Ініціалізація
+  - CLI
+  - Intlayer
+  - AI
+slugs:
+  - doc
+  - concept
+  - cli
+  - init
+history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Додано команду init
+---
+
+# Ініціалізація Intlayer
+
+```bash
+npx intlayer init
+```
+
+Команда `init` автоматично налаштовує Intlayer у вашому проєкті, конфігуруючи необхідні файли та параметри. Це рекомендований спосіб почати роботу з `Intlayer`.
+
+## Аліаси:
+
+- `npx intlayer init`
+
+## Аргументи:
+
+- `--project-root [projectRoot]` - Опційно. Вкажіть кореневу директорію проєкту. Якщо не вказано, команда шукатиме корінь проєкту, починаючи з поточної робочої директорії.
+
+## Що робить:
+
+Команда `init` виконує такі дії з налаштування:
+
+1. **Validates project structure** - Переконується, що ви перебуваєте в дійсній директорії проекту з файлом `package.json`
+2. **Updates `.gitignore`** - Додає `.intlayer` до вашого файлу `.gitignore`, щоб виключити згенеровані файли з контролю версій
+3. **Configures TypeScript** - Оновлює всі файли `tsconfig.json`, щоб включити визначення типів Intlayer (`.intlayer/**/*.ts`)
+4. **Creates configuration file** - Генерує `intlayer.config.ts` (для проєктів на TypeScript) або `intlayer.config.mjs` (для проєктів на JavaScript) з налаштуваннями за замовчуванням
+5. **Updates Vite config** - Якщо виявлено файл конфігурації Vite, додає імпорт плагіна `vite-intlayer`
+6. **Оновлює конфігурацію Next.js** - Якщо виявлено файл конфігурації Next.js, додає імпорт плагіна `next-intlayer`
+
+## Приклади:
+
+### Базова ініціалізація:
+
+```bash
+npx intlayer init
+```
+
+Це ініціалізує Intlayer у поточному каталозі, автоматично виявляючи корінь проєкту.
+
+### Ініціалізація з користувацьким коренем проєкту:
+
+```bash
+npx intlayer init --project-root ./my-project
+```
+
+Це ініціалізує Intlayer у вказаному каталозі.
+
+## Приклад виведення:
+
+```bash
+npx intlayer init
+Checking Intlayer configuration...
+✓ Added .intlayer to .gitignore
+✓ Updated tsconfig.json to include intlayer types
+Created intlayer.config.ts
+✓ Injected import into vite.config.ts
+✓ Intlayer init setup complete.
+```
+
+## Примітки:
+
+- Команда ідемпотентна - її можна безпечно запускати кілька разів. Вона пропустить кроки, які вже налаштовано.
+- Якщо файл конфігурації вже існує, він не буде перезаписаний.
+- Файли конфігурації TypeScript без масиву `include` (наприклад, конфіги у стилі solution з references) пропускаються.
+- Команда завершиться з помилкою, якщо у корені проєкту не знайдено `package.json`.

package/docs/uk/cli/list.md

@@ -0,0 +1,90 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2026-01-06
+title: Перелік файлів декларації контенту
+description: Дізнайтеся, як перерахувати всі файли декларацій контенту у вашому проєкті.
+keywords:
+  - Перелік
+  - Декларація контенту
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - list
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Додано опцію виводу абсолютних шляхів для команди list
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Додано опцію виводу у форматі JSON для команди list
+---
+
+# Перелік файлів декларації контенту
+
+```bash
+npx intlayer content list
+```
+
+## Аліаси:
+
+- `npx intlayer list`
+
+Ця команда відображає всі файли декларації контенту у вашому проєкті, показуючи їхні ключі в словнику та шляхи до файлів. Це корисно для отримання огляду всіх ваших файлів контенту та перевірки того, що Intlayer правильно їх виявляє.
+
+## Arguments:
+
+- **`--json`**: Виводити результати у форматі JSON замість відформатованого тексту. Корисно для скриптів і програмного доступу.
+
+  > Приклад: `npx intlayer content list --json`
+
+## Examples:
+
+### List content declaration files:
+
+```bash
+npx intlayer content list
+```
+
+### Output as JSON:
+
+```bash
+npx intlayer content list --json
+```
+
+### Output as absolute paths:
+
+```bash
+npx intlayer content list --absolute
+```
+
+## Example output:
+
+### Formatted output:
+
+```bash
+npx intlayer content list
+Content declaration files:
+ - home-page        - src/components/HomePage/homePage.content.ts
+ - server-component - src/components/ServerComponent/serverComponent.content.ts
+ - client-component - src/components/ClientComponent/clientComponent.content.ts
+
+Загальна кількість файлів декларації контенту: 3
+```
+
+### Вивід у форматі JSON:
+
+```bash
+$ npx intlayer content list --json
+
+[{"key":"home-page","path":"src/components/HomePage/homePage.content.ts"},{"key":"server-component","path":"src/components/ServerComponent/serverComponent.content.ts"},{"key":"client-component","path":"src/components/ClientComponent/clientComponent.content.ts"}]
+```
+
+Ця команда виведе:
+
+- Відформатований список усіх файлів декларації контенту з їхніми ключами та відносними шляхами
+- Загальну кількість знайдених файлів декларації контенту
+
+Вивід допомагає переконатися, що всі ваші файли контенту налаштовані правильно й доступні системі Intlayer.