--- createdAt: 2025-09-22 updatedAt: 2025-09-23 title: "Новий Intlayer v6 — Що нового?" description: "Дізнайтеся про новинки Intlayer v6. Значні покращення продуктивності, developer experience та нові функції для вдосконалення вашого робочого процесу інтернаціоналізації." keywords: - Intlayer - Локалізація - Розробка - Продуктивність - Developer Experience - Функції - React - Next.js - JavaScript - TypeScript slugs: - doc - releases - v6 --- # Новий Intlayer v6 — Що нового? Ласкаво просимо в Intlayer v6! У цьому релізі акцент зроблено на продуктивності, developer experience та надійності. Нижче наведено основні моменти, нотатки щодо міграції та приклади, які можна копіювати й вставляти. ## Основні зміни - Нова команда: `npx intlayer content test` для виявлення відсутніх перекладів - Нова глобальна опція `autoFill` для автоматичної генерації відсутніх перекладів - Команда Fill за замовчуванням пропускає наявні переклади: `npx intlayer fill` - Розширення для VS Code: нова панель активності Intlayer (Search і Dictionaries), дія на панелі інструментів/контекстні дії, auto‑reveal, команди Fill/Test - Збірки у 10× швидші завдяки паралелізації промісів - Кешування віддалених словників, щоб уникнути повторного запиту при старті програми - Покращене логування: встановіть `log.mode: 'verbose'`, щоб перевірити поведінку - Посилена валідація, щоб запобігти падінню додатка через проблеми зі словниками - Живі оновлення з CMS за допомогою `build.importMode = 'live'` та `pnpm intlayer live` - Виправлення: інтеграція з Vue.js, адаптер Lynx, Visual Editor на Windows --- ## Нове: Перевірка відсутніх перекладів Швидко проведіть аудит вашого проєкту, щоб знайти відсутні ключі/локалі. ```bash npx intlayer content test ``` Output: ```bash pnpm intlayer content test Відсутні переклади: - blog-data - Японська (ja), Корейська (ko), Китайська (zh), Німецька (de), Італійська (it) - src/components/BlogPage/blogData.content.ts - demo-page - Французька (fr), Італійська (it) - src/components/DemoPage/demo.content.ts - locale-switcher - Італійська (it), Португальська (pt) - src/components/LocaleSwitcher/localeSwitcher.content.ts Локалі: Англійська (en), Російська (ru), Японська (ja), Французька (fr), Корейська (ko), Китайська (zh), Іспанська (es), Німецька (de), Арабська (ar), Італійська (it), Британська англійська (en-GB), Португальська (pt), Хінді (hi) Обов'язкові локалі: Англійська (en) Відсутні локалі: японська (ja), корейська (ko), китайська (zh), німецька (de), італійська (it), французька (fr), португальська (pt) Відсутні обов'язкові локалі: - Загалом відсутніх локалей: 7 Загалом відсутніх обов'язкових локалей: 0 ``` Див. більше опцій у довіднику CLI: [Довідник CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/index.md) → «Перевірка відсутніх перекладів». А також у [розділі Тестування](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/testing.md). --- ## Нове: Глобальний autoFill для заповнення відсутніх перекладів Тепер ви можете ввімкнути auto‑fill глобально, щоб будь-який словник з відсутніми перекладами автоматично заповнювався. ```ts fileName="intlayer.config.ts" import { type IntlayerConfig, Locales } from "intlayer"; const config: IntlayerConfig = { internationalization: { locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH], defaultLocale: Locales.ENGLISH, requiredLocales: [Locales.ENGLISH, Locales.FRENCH], }, content: { // Автоматично згенерувати відсутні переклади для всіх словників autoFill: "./{{fileName}}Filled.content.ts", // // autoFill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json", // // autoFill: true, // автоматично згенерувати відсутні переклади для всіх словників, як при використанні "./{{fileName}}.content.json" // // autoFill: { // en: "./{{fileName}}.en.content.json", // fr: "./{{fileName}}.fr.content.json", // es: "./{{fileName}}.es.content.json", // }, }, }; export default config; ``` Автоматично заповніть відсутні переклади за допомогою команди `npx intlayer fill`. Ви все ще можете тонко налаштувати окремий словник, використовуючи поле `autoFill` у файлах контенту. Intlayer спочатку врахує конфігурацію для конкретного словника, а потім перейде до глобальної конфігурації. Повну довідку див. в [Автозаповнення](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/autoFill.md) та [Довідник файлу контенту](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/content_file.md). --- ## Команда fill: безпечніші значення за замовчуванням Команда fill тепер за замовчуванням заповнює лише відсутні переклади й пропускає вже існуючий контент. ```bash npx intlayer fill ``` ```bash Затронуті ключі словників для обробки: access-key-creation-form-schema, doc-search-metadata, doc-search-page - [access-key-creation-form-schema] У словника немає шляху до файлу. Пропускається. - [access-key-creation-form-schema] Обробка декларації контенту: src/components/Dashboard/ProjectForm/AccessKey/useAccessKeyCreationFormSchema.content.ts - [access-key-creation-form-schema] Немає локалей для заповнення - Пропуск словника - [doc-search-metadata] Словник не має шляху до файлу. Пропуск. - [doc-search-metadata] Обробка декларації контенту: src/app/[locale]/(docs)/doc/search/metadata.content.ts - [doc-search-metadata] Немає локалей для заповнення - Пропуск словника - [doc-search-page] Словник не має шляху до файлу. Пропуск. - [doc-search-page] Обробка декларації контенту: src/app/[locale]/(docs)/doc/search/page.content.ts - [doc-search-page] [Російська (ru)] Підготовка перекладу словника з Англійської (en) на Російську (ru) [intlayer] Застосовано форматування Prettier до src/app/[locale]/(docs)/doc/search/page.content.ts - [doc-search-page] Оголошення вмісту записано до src/app/[locale]/(docs)/doc/search/page.content.ts ``` Приклади CI доступні в [CI/CD](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/CI_CD.md). --- ## Оновлене розширення VS Code Тепер розширення містить виділену вкладку Intlayer в Activity Bar та кілька покращень робочого процесу: - Панель Intlayer в Activity Bar з двома поданнями: - Webview для live-пошуку словників/контенту - Дерево словників, яке відображає середовища, словники та пов'язані файли - Панель інструментів у поданні Dictionaries: Build, Pull, Push, Fill, Refresh, Test, Create Dictionary File - Контекстні меню: Pull/Push для словників; Fill для файлів - Auto‑reveal: поточний файл у редакторі підсвічується в дереві словників, коли це застосовно - Нові команди, доступні в Палітрі команд: Fill Dictionaries і Test Dictionaries Деталі див. у документації [Official VS Code Extension](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/vs_code_extension.md). --- Оновлено сервер MCP для підтримки нових можливостей. - Автозаповнення - Тестування відсутніх перекладів - Живі оновлення - Логування - Валідація - Нотатки щодо міграції - Документація Сервер MCP допомагає в автоматизації проєктів, що використовують Intlayer. Тестує відсутні переклади для автогенерованого коду. Допомагає зрозуміти вашу конфігурацію та вбудувати документацію Intlayer у вашу IDE. --- ## Продуктивність: у 10× разів швидше - Паралельна обробка локальних і віддалених словників - Віддалені словники кешуються, щоб уникнути повторного завантаження при запуску додатку ```bash npx intlayer build ``` Вивід: ```bash [intlayer] Preparing Intlayer (v6.0.1) [intlayer] Dictionaries: [intlayer] ✓ Local content: 163/163 [intlayer] ✓ Remote content: 100/100 [intlayer] - access-key-creation-form [local: ✔ built] [distant: ✔ imported] [intlayer] - access-key-form [local: ✔ built] [distant: ✔ imported] [intlayer] - ai-ab-testing-section [віддалено: ✔ імпортовано] [intlayer] - application-not-running-view [локально: ✔ побудовано] [віддалено: ✔ імпортовано] [intlayer] - available-techno-section [локально: ✔ побудовано] [віддалено: ✔ імпортовано] [intlayer] - blog-data [локально: ✔ побудовано] [intlayer] - blog-metadata [локольно: ✔ побудовано] [intlayer] - blog-nav-list [локально: ✔ побудовано] [віддалено: ✔ імпортовано] [intlayer] - blog-page [віддалено: ✔ отримано] [intlayer] - blog-search-page [локально: ✔ побудовано] [віддалено: ✔ імпортовано] ... [intlayer] Вміст завантажено (Всього: 8401ms - Локально: 4050ms - Віддалено: 4222ms) ``` --- ## Покращення логування Система логування була покращена, щоб надавати детальнішу інформацію про те, що відбувається під час перетворень під час збірки та виконання. > Увімкніть детальний режим логування, щоб краще зрозуміти, що відбувається під час перетворень під час збірки та виконання. ```ts fileName="intlayer.config.ts" export default { log: { mode: "verbose", // опції: "default" | "verbose" | "disabled" }, }; ``` Див. [Конфігурація](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md) щодо всіх опцій логування. --- ## Посилена валідація Обробка словників тепер виконує більш надійну валідацію. Якщо обробка словника не вдається, Intlayer уникає ламання вашого застосунку і відображає корисні повідомлення про помилки. --- ## Живі оновлення з CMS (production‑safe) Подавайте оновлення контенту в реальному часі (наприклад, редакційні оновлення) у production без перезбирання вашого застосунку. 1. Увімкніть режим live імпорту: ```ts fileName="intlayer.config.ts" import { type IntlayerConfig } from "intlayer"; const config: IntlayerConfig = { build: { importMode: "live", // опції: "static" | "dynamic" | "live" }, editor: { liveSync: true, // увімкнути live sync на стороні сервера }, }; export default config; ``` 2. Запустіть застосунок і live‑процес паралельно: ```bash npx intlayer live --with 'vite preview' ``` Примітки: - Тільки словники, позначені для використання live‑режиму, будуть підвантажуватись у реальному часі. Інші оптимізовані для продуктивності. - Виконується відкат до динамічного імпорту, якщо live API недоступний. Дивіться [CMS and Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_CMS.md) та [Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md) для повного керівництва. ## Паралельний процес для відстеження файлів у Turbopack Коли ви використовуєте Turbopack у Next.js 14 і новіших версіях як сервер розробки з командою `next dev --turbopack`, зміни в словниках за замовчуванням не будуть автоматично виявлятися. Це обмеження виникає через те, що Turbopack не може запускати webpack‑плагіни паралельно для моніторингу змін у ваших файлах контенту. Щоб обійти це, ми відмовилися від команди `intlayer watch`, натомість використовуйте опцію `--with`, щоб одночасно запускати сервер розробки та спостерігача збірки Intlayer. ```json5 fileName="package.json" { "scripts": { "dev": "npx intlayer watch --with 'next dev --turbopack'", }, } ``` --- ## Нотатки щодо міграції - Видалено: `dictionaryOutput` (раніше `i18next` або `next-intl`). Це повернеться як підключні адаптери в майбутніх версіях. Видаліть це поле з вашої конфігурації. - Пов’язане видалення: `i18nextResourcesDir` (див. changelog `doc/configuration`). - Віддавайте перевагу новій глобальній опції `content.autoFill` для масштабного генерування відсутніх перекладів. - Використовуйте `npx intlayer content test`, щоб контролювати PR на предмет відсутніх перекладів. - Для докладної діагностики встановіть `log.mode = 'verbose'`. - У конфігурації Vite використовуйте `intlayer` замість `intlayerPlugin` та `intlayerProxy` замість `intlayerProxyPlugin`. --- ## Виправлення - Покращена стабільність інтеграції з Vue.js - Покращення адаптера Lynx - Покращена робота Візуального редактора на Windows --- ## Нотатки щодо міграції з v6 до v7 Перегляньте [нотатки щодо міграції з v6 до v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/releases/v7.md) для отримання додаткової інформації. --- ## Корисні посилання - [Довідник CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/index.md) - [Автозаповнення](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/autoFill.md) - [Налаштування](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md) - [Довідник файлу контенту](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/content_file.md) - [Офіційне розширення для VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/vs_code_extension.md) - [CMS та Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_CMS.md)