@intlayer/docs 8.1.7 → 8.1.9

package/docs/uk/readme.md

@@ -39,7 +39,7 @@
 
 Більшість бібліотек для i18n занадто складні, занадто жорсткі або не створені для сучасних фреймворків.
 
-Intlayer — це **сучасне рішення для i18n** для веб- та мобільних застосунків.  
+Intlayer, це **сучасне рішення для i18n** для веб- та мобільних застосунків.  
 Воно незалежне від фреймворку, **AI-powered**, і включає безкоштовний **CMS та візуальний редактор**.
 
 Завдяки **файлам контенту для кожної локалі**, **автодоповненню TypeScript**, **tree-shakable словникам** та **інтеграції CI/CD**, Intlayer робить інтернаціоналізацію **швидшою, чистішою та розумнішою**.
@@ -55,7 +55,7 @@ Intlayer — це **сучасне рішення для i18n** для веб-
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true" alt="TypeScript" width="700">                 | **Типобезпечне середовище**<br><br>Використовуйте TypeScript, щоб гарантувати, що ваші визначення контенту та код позбавлені помилок, а також отримувати автозаповнення в IDE.<br><br> - [Налаштування TypeScript](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                                              |
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true" alt="Конфігурація" width="700">                  | **Спрощене налаштування**<br><br>Швидко запустіть проект з мінімальною конфігурацією. Легко налаштовуйте параметри інтернаціоналізації, маршрутизації, AI, збірки та обробки контенту. <br><br> - [Дізнайтеся про інтеграцію Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                        |
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true" alt="Отримання контенту" width="700">      | **Спрощене отримання контенту**<br><br>Не потрібно викликати вашу функцію `t` для кожного фрагмента контенту. Отримуйте весь контент безпосередньо за допомогою одного hook.<br><br> - [Інтеграція з React](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                                                        |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true" alt="Серверні компоненти" width="700">      | **Послідовна реалізація серверних компонентів**<br><br>Ідеально підходить для серверних компонентів Next.js: використовуйте одну й ту саму реалізацію як для клієнтських, так і для серверних компонентів — немає потреби передавати вашу функцію `t` через кожний серверний компонент. <br><br> - [Серверні компоненти](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                 |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true" alt="Серверні компоненти" width="700">      | **Послідовна реалізація серверних компонентів**<br><br>Ідеально підходить для серверних компонентів Next.js: використовуйте одну й ту саму реалізацію як для клієнтських, так і для серверних компонентів, немає потреби передавати вашу функцію `t` через кожний серверний компонент. <br><br> - [Серверні компоненти](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                  |
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true" alt="Організація" width="700">                     | **Організована codebase**<br><br>Тримайте свій codebase більш організованим: 1 компонент = 1 словник у тій самій папці. Переклади поруч із відповідними компонентами підвищують підтримуваність і зрозумілість. <br><br> - [Як працює Intlayer](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                                                                      |
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true" alt="Маршрутизація" width="700">                 | **Покращена маршрутизація**<br><br>Повна підтримка маршрутизації застосунків, що безшовно адаптується до складних структур додатків для Next.js, React, Vite, Vue.js тощо.<br><br> - [Дізнатися про інтеграцію з Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                    |
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true" alt="Markdown" width="700">                         | **Підтримка Markdown**<br><br>Імпортуйте та інтерпретуйте локалізовані файли і віддалений Markdown для багатомовного контенту, такого як політики конфіденційності, документація тощо. Інтерпретуйте та робіть метадані Markdown доступними у вашому коді.<br><br> - [Файли контенту](https://intlayer.org/doc/concept/content/file)                                                                                                                      |
@@ -243,7 +243,7 @@ const HomePage = () => {
 
 ## 🤝 Спільнота
 
-Intlayer створено спільнотою і для спільноти — нам дуже важлива ваша думка!
+Intlayer створено спільнотою і для спільноти, нам дуже важлива ваша думка!
 
 - Маєте пропозицію? [Відкрийте issue](https://github.com/aymericzip/intlayer/issues)
 - Знайшли помилку або маєте пропозицію щодо покращення? [Надішліть PR](https://github.com/aymericzip/intlayer/pulls)

package/docs/uk/releases/v6.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-22
 updatedAt: 2025-09-23
-title: "Новий Intlayer v6 — Що нового?"
+title: "Новий Intlayer v6. Що нового?"
 description: "Дізнайтеся про новинки Intlayer v6. Значні покращення продуктивності, developer experience та нові функції для вдосконалення вашого робочого процесу інтернаціоналізації."
 keywords:
   - Intlayer
@@ -20,7 +20,7 @@ slugs:
   - v6
 ---
 
-# Новий Intlayer v6 — Що нового?
+# Новий Intlayer v6. Що нового?
 
 Ласкаво просимо в Intlayer v6! У цьому релізі акцент зроблено на продуктивності, developer experience та надійності. Нижче наведено основні моменти, нотатки щодо міграції та приклади, які можна копіювати й вставляти.
 

package/docs/uk/releases/v7.md

@@ -121,7 +121,7 @@ v7 вводить уніфіковану конфігурацію `routing.mode`
 
 ### Доступні режими маршрутизації
 
-- **`prefix-no-default`** (за замовчуванням): локаль за замовчуванням без префікса, інші локалі — з префіксом
+- **`prefix-no-default`** (за замовчуванням): локаль за замовчуванням без префікса, інші локалі, з префіксом
   - `/dashboard` (en) або `/fr/dashboard` (fr)
 - **`prefix-all`**: У всіх локалей є префікс
   - `/en/dashboard` (en) або `/fr/dashboard` (fr)
@@ -239,7 +239,7 @@ setLocale("en");
 
 ## Візуальний редактор: пакет на 30% менший
 
-Пакет Візуального редактора оптимізовано — він став на 30% меншим порівняно з попередньою версією завдяки:
+Пакет Візуального редактора оптимізовано, він став на 30% меншим порівняно з попередньою версією завдяки:
 
 - Покращенням продуктивності редактора коду
 - Видаленню непотрібних залежностей від базових пакетів Intlayer

package/docs/uk/releases/v8.md

@@ -19,7 +19,7 @@ slugs:
   - v8
 ---
 
-# Новий Intlayer v8 — що нового?
+# Новий Intlayer v8, що нового?
 
 Ласкаво просимо до Intlayer v8! У цьому випуску основна увага приділена покращенню досвіду розробника за допомогою автоматичного виявлення контенту, забезпеченню цілісності даних через валідацію схем і наданню більшого контролю над управлінням словниками.
 
@@ -787,7 +787,7 @@ const aboutPageMetaContent = {
     title: "About Our Company - Learn More About Us",
     description: "Discover our company's mission, values, and team.",
   },
-} satisfies Dictionary<"seo-metadata">;
+} satisfies Dictionary;
 
 export default aboutPageMetaContent;
 ```

package/docs/uk/roadmap.md

@@ -27,7 +27,7 @@ history:
 
 # Intlayer: Огляд функцій та дорожня карта
 
-Intlayer — рішення для управління контентом і інтернаціоналізації, яке спрощує спосіб, яким ви оголошуєте, керуєте та оновлюєте контент у ваших застосунках. Воно пропонує потужні можливості, такі як централізоване або розподілене оголошення контенту, широкі опції інтернаціоналізації, підтримка Markdown, умовний рендеринг, інтеграція з TypeScript/JavaScript/JSON тощо. Нижче наведено всебічний огляд того, що Intlayer наразі надає, а також майбутні заплановані можливості.
+Intlayer, рішення для управління контентом і інтернаціоналізації, яке спрощує спосіб, яким ви оголошуєте, керуєте та оновлюєте контент у ваших застосунках. Воно пропонує потужні можливості, такі як централізоване або розподілене оголошення контенту, широкі опції інтернаціоналізації, підтримка Markdown, умовний рендеринг, інтеграція з TypeScript/JavaScript/JSON тощо. Нижче наведено всебічний огляд того, що Intlayer наразі надає, а також майбутні заплановані можливості.
 
 ---
 
@@ -255,7 +255,7 @@ Intlayer підтримує **TypeScript** (також JavaScript) та **JSON**
 
 ### 2. Intlayer CMS (віддалений)
 
-- **Хостована CMS** — рішення, яке дозволяє керувати вмістом застосунку онлайн, не торкаючись вашого codebase.
+- **Хостована CMS**, рішення, яке дозволяє керувати вмістом застосунку онлайн, не торкаючись вашого codebase.
 - Надає AI‑підтримку для декларування вмісту, керування перекладами та виправлення помилок синтаксису або орфографії.
 - Взаємодійте з вашим контентом через інтерфейс живого застосунку.
 
@@ -322,7 +322,7 @@ Intlayer підтримує **TypeScript** (також JavaScript) та **JSON**
 
 ### 3. Автоматичний переклад
 
-- Для користувачів віддаленої CMS — **генерація перекладів в один клік** для будь-якої підтримуваної мови.
+- Для користувачів віддаленої CMS, **генерація перекладів в один клік** для будь-якої підтримуваної мови.
 - Система генеруватиме переклади у фоновому режимі, а потім запропонує вам їх підтвердити або відредагувати.
 
 ### 4. SEO Enhancements
@@ -333,7 +333,7 @@ Intlayer підтримує **TypeScript** (також JavaScript) та **JSON**
 ### 5. Compatibility with More Frameworks
 
 - Проводяться роботи з підтримки **Solid, Svelte, Angular** та інших.
-- Мета — зробити Intlayer сумісним з **будь-яким додатком на базі JavaScript**.
+- Мета, зробити Intlayer сумісним з **будь-яким додатком на базі JavaScript**.
 
 ---
 

package/docs/uk/testing.md

@@ -100,7 +100,7 @@ test("has no missing required locales", async () => {
 Як це працює:
 
 - Intlayer читає вашу конфігурацію (locales, requiredLocales) та оголошені словники, а потім звітує:
-  - `missingTranslations`: по‑ключу — які локалі відсутні та з якого файлу.
+  - `missingTranslations`: по‑ключу, які локалі відсутні та з якого файлу.
   - `missingLocales`: об'єднання всіх відсутніх локалей.
   - `missingRequiredLocales`: підмножина, обмежена `requiredLocales` (або всі локалі, якщо `requiredLocales` не встановлено).
 

package/docs/uk/vs_code_extension.md

@@ -37,7 +37,7 @@ history:
 
 ## Огляд
 
-[**Intlayer**](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension) — офіційне розширення Visual Studio Code для **Intlayer**, створене для покращення досвіду розробника під час роботи з локалізованим контентом у ваших проєктах.
+[**Intlayer**](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension), офіційне розширення Visual Studio Code для **Intlayer**, створене для покращення досвіду розробника під час роботи з локалізованим контентом у ваших проєктах.
 
 ![Розширення Intlayer для VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vs_code_extension_demo.gif?raw=true)
 
@@ -119,7 +119,7 @@ Intlayer рекомендує зберігати ваші AI API keys, а так
 
 - **Порядок завантаження (за пріоритетом)**: `.env.<env>.local` → `.env.<env>` → `.env.local` → `.env`
 - **Недеструктивно**: існуючі значення `process.env` не перезаписуються.
-- **Область застосування**: файли визначаються з налаштованого базового каталогу (за замовчуванням — корінь робочого простору).
+- **Область застосування**: файли визначаються з налаштованого базового каталогу (за замовчуванням, корінь робочого простору).
 
 #### Вибір активного середовища
 

package/docs/vi/agent_skills.md

@@ -18,6 +18,8 @@ history:
     changes: Init history
 ---
 
+# Kỹ năng Agent
+
 ## Lệnh `intlayer init skills`
 
 Lệnh `intlayer init skills` là cách dễ nhất để thiết lập agent skills trong dự án của bạn. Nó phát hiện môi trường và cài đặt các tập tin cấu hình cần thiết cho các nền tảng bạn ưu tiên.

package/docs/vi/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2025-09-09
+updatedAt: 2026-02-25
 title: Trình Biên Dịch Intlayer | Trích Xuất Nội Dung Tự Động cho i18n
 description: Tự động hóa quy trình quốc tế hóa của bạn với Trình Biên Dịch Intlayer. Trích xuất nội dung trực tiếp từ các component để i18n nhanh hơn và hiệu quả hơn trong Vite, Next.js và nhiều hơn nữa.
 keywords:
@@ -20,6 +20,9 @@ slugs:
   - doc
   - compiler
 history:
+  - version: 8.1.7
+    date: 2026-02-25
+    changes: Cập nhật các tùy chọn trình biên dịch
   - version: 7.3.1
     date: 2025-11-27
     changes: Phát hành Trình Biên Dịch
@@ -144,6 +147,55 @@ See complete tutorial: [Intlayer Compiler with Next.js](https://github.com/aymer
 
  </Tab>
 
+### Cấu hình tùy chỉnh
+
+Để tùy chỉnh hành vi của trình biên dịch, bạn có thể cập nhật tệp `intlayer.config.ts` trong thư mục gốc của dự án.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    /**
+     * Chỉ định liệu trình biên dịch có nên được bật hay không.
+     * Đặt thành 'build-only' để bỏ qua trình biên dịch trong quá trình phát triển và tăng tốc thời gian khởi động.
+     */
+    enabled: true,
+
+    /**
+     * Mẫu để duyệt qua mã để tối ưu hóa.
+     */
+    transformPattern: [
+      "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
+      "!**/node_modules/**",
+    ],
+
+    /**
+     * Mẫu để loại trừ khỏi quá trình tối ưu hóa.
+     */
+    excludePattern: ["**/node_modules/**"],
+
+    /**
+     * Thư mục đầu ra cho các từ điển đã được tối ưu hóa.
+     */
+    outputDir: "i18n",
+
+    /**
+     * Tiền tố phím từ điển
+     */
+    dictionaryKeyPrefix: "", // Xóa tiền tố cơ sở
+
+    /**
+     * Chỉ định liệu các component có nên được lưu sau khi được chuyển đổi hay không.
+     * Bằng cách đó, trình biên dịch có thể được chạy chỉ một lần để chuyển đổi ứng dụng, sau đó có thể được gỡ bỏ.
+     */
+    saveComponents: false,
+  },
+};
+
+export default config;
+```
+
 ### Điền các bản dịch còn thiếu
 
 Intlayer cung cấp một công cụ CLI để giúp bạn điền các bản dịch còn thiếu. Bạn có thể sử dụng lệnh `intlayer` để kiểm tra và điền các bản dịch còn thiếu từ mã của mình.

package/docs/vi/component_i18n.md

@@ -78,7 +78,7 @@ JSON cũng được hỗ trợ nếu bạn thích dùng các file cấu hình.
 
 ## 2) Lấy nội dung của bạn
 
-### Trường hợp A — Ứng dụng React (Vite/SPA)
+### Trường hợp A, Ứng dụng React (Vite/SPA)
 
 Cách tiếp cận mặc định: sử dụng `useIntlayer` để lấy theo key. Điều này giữ cho các component gọn nhẹ và có kiểu dữ liệu.
 
@@ -129,7 +129,7 @@ export function ComponentWithDictionary() {
 }
 ```
 
-### Trường hợp B — Next.js (App Router)
+### Trường hợp B. Next.js (App Router)
 
 Ưu tiên sử dụng server components để đảm bảo an toàn dữ liệu và hiệu năng. Sử dụng `useIntlayer` từ `next-intlayer/server` trong các file server, và `useIntlayer` từ `next-intlayer` trong các component phía client.
 

package/docs/vi/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-12
+updatedAt: 2026-02-25
 title: Cấu hình
 description: Tìm hiểu cách cấu hình Intlayer cho ứng dụng của bạn. Hiểu các thiết lập và tùy chọn khác nhau để tùy chỉnh Intlayer theo nhu cầu của bạn.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.1.7
+    date: 2026-02-25
+    changes: Cập nhật các tùy chọn trình biên dịch
   - version: 8.0.6
     date: 2026-02-12
     changes: Add support for Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face, and Together.ai providers
@@ -455,6 +458,17 @@ const config: IntlayerConfig = {
      * Output directory for the optimized dictionaries.
      */
     outputDir: "compiler",
+
+    /**
+     * Dictionary key prefix
+     */
+    dictionaryKeyPrefix: "", // Remove base prefix
+
+    /**
+     * Indicates if the components should be saved after being transformed.
+     * That way, the compiler can be run only once to transform the app, and then it can be removed.
+     */
+    saveComponents: false,
   },
 
   /**
@@ -1094,3 +1108,49 @@ Các tùy chọn build áp dụng cho các plugin `@intlayer/babel` và `@intlay
   - _Lưu ý_: Sử dụng để giới hạn tối ưu hóa chỉ cho các tệp mã liên quan và cải thiện hiệu suất xây dựng.
   - _Lưu ý_: Tùy chọn này sẽ bị bỏ qua nếu `optimize` bị vô hiệu hóa.
   - _Lưu ý_: Sử dụng mẫu glob.
+
+---
+
+### Cấu hình Trình biên dịch
+
+Các cài đặt kiểm soát trình biên dịch Intlayer, trình biên dịch này sẽ trích xuất các từ điển trực tiếp từ các thành phần của bạn.
+
+#### Thuộc tính
+
+- **enabled**:
+  - _Kiểu_: `boolean | 'build-only'`
+  - _Mặc định_: `true`
+  - _Mô tả_: Cho biết liệu trình biên dịch có nên được bật để trích xuất từ điển hay không.
+  - _Ví dụ_: `'build-only'`
+  - _Lưu ý_: Đặt thành `'build-only'` sẽ bỏ qua trình biên dịch trong chế độ phát triển để tăng tốc thời gian khởi động. Nó sẽ chỉ chạy trên các lệnh build.
+
+- **dictionaryKeyPrefix**:
+  - _Kiểu_: `string`
+  - _Mặc định_: `'comp-'`
+  - _Mô tả_: Tiền tố cho các khóa từ điển được trích xuất.
+  - _Ví dụ_: `'my-key-'`
+  - _Lưu ý_: Khi từ điển được trích xuất, khóa được tạo dựa trên tên tệp. Tiền tố này được thêm vào khóa đã tạo để ngăn chặn xung đột.
+
+- **saveComponents**:
+  - _Kiểu_: `boolean`
+  - _Mặc định_: `false`
+  - _Mô tả_: Cho biết liệu các thành phần có nên được lưu sau khi được chuyển đổi hay không.
+  - _Lưu ý_: Nếu đúng (true), trình biên dịch sẽ thay thế các tệp gốc bằng các tệp đã chuyển đổi. Bằng cách đó, trình biên dịch chỉ có thể được chạy một lần để chuyển đổi ứng dụng, sau đó có thể được gỡ bỏ.
+
+- **transformPattern**:
+  - _Kiểu_: `string | string[]`
+  - _Mặc định_: `['**/*.{ts,tsx,jsx,js,cjs,mjs,svelte,vue}', '!**/node_modules/**']`
+  - _Mô tả_: Các mẫu xác định những tệp nào akan được duyệt qua trong quá trình tối ưu hóa.
+  - _Ví dụ_: `['src/**/*.{ts,tsx}', '!**/node_modules/**']`
+  - _Lưu ý_: Sử dụng điều này để giới hạn tối ưu hóa cho các tệp mã liên quan và cải thiện hiệu suất xây dựng.
+
+- **excludePattern**:
+  - _Kiểu_: `string | string[]`
+  - _Mặc định_: `['**/node_modules/**']`
+  - _Mô tả_: Các mẫu xác định những tệp nào sẽ bị loại trừ trong quá trình tối ưu hóa.
+  - _Ví dụ_: `['**/node_modules/**', '!**/node_modules/react/**']`
+
+- **outputDir**:
+  - _Kiểu_: `string`
+  - _Mặc định_: `'compiler'`
+  - _Mô tả_: Thư mục nơi các từ điển trích xuất sẽ được lưu trữ, tương đối so với đường dẫn gốc dự án của bạn.

package/docs/vi/dictionary/content_file.md

@@ -485,7 +485,7 @@ const aboutPageMetaContent = {
     title: "About Our Company - Learn More About Us",
     description: "Discover our company's mission, values, and team.",
   },
-} satisfies Dictionary<"seo-metadata">;
+} satisfies Dictionary;
 
 export default aboutPageMetaContent;
 ```
@@ -496,7 +496,7 @@ Chỉ ra vị trí của từ điển và kiểm soát cách nó đồng bộ v
 
 - `'local'`: Từ điển được quản lý chỉ ở cục bộ. Nó sẽ không được đẩy lên CMS từ xa. Sử dụng điều này cho nội dung phải ở lại trong codebase của bạn.
 - `'remote'`: Từ điển được quản lý chỉ từ xa. Sau khi đẩy lên CMS, nó sẽ bị tách khỏi tệp cục bộ. Tại thời điểm tải nội dung, từ điển từ xa sẽ được kéo từ CMS. Một tệp `.content` với vị trí `remote` sẽ bị bỏ qua sau lần đẩy ban đầu.
-- `'hybrid'`: Từ điển được quản lý cả cục bộ và từ xa. Sau khi đẩy lên CMS, nó sẽ giữ đồng bộ—các thay đổi từ tệp cục bộ được đẩy lên CMS, và các thay đổi từ xa có thể được kéo về tệp cục bộ.
+- `'hybrid'`: Từ điển được quản lý cả cục bộ và từ xa. Sau khi đẩy lên CMS, nó sẽ giữ đồng bộ, các thay đổi từ tệp cục bộ được đẩy lên CMS, và các thay đổi từ xa có thể được kéo về tệp cục bộ.
 - `string` (vd. `'plugin'`): Từ điển được quản lý bởi một plugin hoặc nguồn tùy chỉnh. Khi bạn cố gắng đẩy nó, hệ thống sẽ hỏi bạn phải làm gì.
 
 **Ví dụ:**

package/docs/vi/index.md

@@ -64,7 +64,7 @@ Tổ chức nội dung đa ngôn ngữ của bạn gần với mã nguồn để
 - **[Liệt Kê](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/enumeration.md)**  
   Quản lý dễ dàng các tập dữ liệu lặp lại hoặc cố định trên nhiều ngôn ngữ khác nhau.
 
-- **[Điều Kiện](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/conditional.md)**  
+- **[Điều Kiện](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/condition.md)**  
   Tìm hiểu cách sử dụng logic điều kiện trong Intlayer để tạo nội dung động.
 
 - **[Giới Tính](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/gender.md)**  
@@ -79,7 +79,7 @@ Tổ chức nội dung đa ngôn ngữ của bạn gần với mã nguồn để
 - **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/markdown.md)**  
   Tìm hiểu cách sử dụng Markdown trong Intlayer để tạo nội dung phong phú.
 
-- **[Nhúng Tệp](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/file_embeddings.md)**  
+- **[Nhúng Tệp](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/file.md)**  
   Khám phá cách nhúng các tệp bên ngoài trong Intlayer để sử dụng chúng trong trình soạn thảo nội dung.
 
 - **[Lồng nhau](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/nesting.md)**  

package/docs/vi/intlayer_CMS.md

@@ -464,7 +464,7 @@ Ví dụ sử dụng Vite:
 
 Server Live Sync bao bọc ứng dụng của bạn và tự động áp dụng nội dung cập nhật khi nó đến.
 
-Để nhận thông báo thay đổi từ CMS, server Live Sync duy trì một kết nối SSE đến backend. Khi nội dung thay đổi trong CMS, backend chuyển tiếp bản cập nhật đến server Live Sync, server này sẽ ghi các từ điển mới. Ứng dụng của bạn sẽ phản ánh bản cập nhật trong lần điều hướng tiếp theo hoặc khi tải lại trình duyệt — không cần phải xây dựng lại.
+Để nhận thông báo thay đổi từ CMS, server Live Sync duy trì một kết nối SSE đến backend. Khi nội dung thay đổi trong CMS, backend chuyển tiếp bản cập nhật đến server Live Sync, server này sẽ ghi các từ điển mới. Ứng dụng của bạn sẽ phản ánh bản cập nhật trong lần điều hướng tiếp theo hoặc khi tải lại trình duyệt, không cần phải xây dựng lại.
 
 Sơ đồ luồng (CMS/Backend -> Live Sync Server -> Application Server -> Frontend):
 

package/docs/vi/intlayer_with_adonisjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: AdonisJS i18n - Cách dịch ứng dụng AdonisJS của bạn – hướng dẫn 2026
+title: AdonisJS i18n - Cách dịch ứng dụng AdonisJS năm 2026
 description: Khám phá cách làm cho backend AdonisJS của bạn đa ngôn ngữ. Làm theo tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa

package/docs/vi/intlayer_with_analog.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Analog i18n - Cách dịch ứng dụng Analog của bạn – hướng dẫn 2026
+title: Analog i18n - Cách dịch ứng dụng Analog năm 2026
 description: Khám phá cách làm cho ứng dụng Analog của bạn hỗ trợ đa ngôn ngữ. Làm theo tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa

package/docs/vi/intlayer_with_angular.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Angular i18n - Cách dịch ứng dụng Angular của bạn – hướng dẫn 2026
+title: Angular i18n - Cách dịch ứng dụng Angular năm 2026
 description: Khám phá cách làm cho trang web Angular của bạn đa ngôn ngữ. Làm theo tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa

package/docs/vi/intlayer_with_astro.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-03-07
 updatedAt: 2025-12-30
-title: Astro i18n - Cách dịch ứng dụng Astro của bạn – hướng dẫn 2026
+title: Astro i18n - Cách dịch ứng dụng Astro năm 2026
 description: Tìm hiểu cách thêm quốc tế hóa (i18n) vào trang web Astro của bạn bằng Intlayer. Làm theo hướng dẫn này để làm cho trang web của bạn đa ngôn ngữ.
 keywords:
   - Quốc tế hóa

package/docs/vi/intlayer_with_create_react_app.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: Create React App i18n - Cách dịch ứng dụng React của bạn – hướng dẫn 2026
+title: Create React App i18n - Cách dịch ứng dụng React năm 2026
 description: Khám phá cách làm cho trang web Create React App (CRA) của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa

package/docs/vi/intlayer_with_express.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: Express i18n - Cách dịch ứng dụng Express của bạn – hướng dẫn 2026
+title: Express i18n - Cách dịch ứng dụng Express năm 2026
 description: Khám phá cách làm cho backend Express của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa

package/docs/vi/intlayer_with_fastify.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-12-30
 updatedAt: 2025-12-30
-title: Fastify i18n - Cách dịch ứng dụng Fastify của bạn – hướng dẫn 2026
+title: Fastify i18n - Cách dịch ứng dụng Fastify năm 2026
 description: Tìm hiểu cách làm cho backend Fastify của bạn hỗ trợ đa ngôn ngữ. Thực hiện theo tài liệu để internationalize (i18n) và dịch nội dung.
 keywords:
   - Quốc tế hóa (i18n)

package/docs/vi/intlayer_with_hono.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: i18n Hono - Cách dịch ứng dụng Hono của bạn – hướng dẫn 2026
+title: i18n Hono - Cách dịch ứng dụng Hono năm 2026
 description: Khám phá cách làm cho backend Hono của bạn đa ngôn ngữ. Làm theo tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa

package/docs/vi/intlayer_with_lynx+react.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-03-09
 updatedAt: 2025-12-30
-title: Lynx và React i18n - Cách dịch ứng dụng Lynx của bạn – hướng dẫn 2026
+title: Lynx + React i18n - Cách dịch ứng dụng Lynx năm 2026
 description: Khám phá cách làm cho ứng dụng di động Lynx và React của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa

package/docs/vi/intlayer_with_nestjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-09
 updatedAt: 2025-12-30
-title: NestJS i18n - Cách dịch ứng dụng NestJS của bạn – hướng dẫn 2026
+title: NestJS i18n - Cách dịch ứng dụng NestJS năm 2026
 description: Khám phá cách làm cho backend NestJS của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa

package/docs/vi/intlayer_with_next-i18next.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Next.js và next-i18next i18n - Cách dịch ứng dụng Next.js của bạn – hướng dẫn 2026
+title: next-i18next - Cách dịch ứng dụng Next.js (i18n) vào năm 2026
 description: Hướng dẫn thực tiễn, sẵn sàng cho sản xuất để quốc tế hóa ứng dụng Next.js 15 App Router với i18next/next-i18next và nâng cao với Intlayer.
 keywords:
   - Quốc tế hóa
@@ -37,7 +37,7 @@ applicationTemplate: https://github.com/aymericzip/intlayer-next-i18next-templat
 - Tích hợp Intlayer để tự động hóa quy trình dịch thuật (kiểm thử, điền AI, đồng bộ JSON)
 
 > Lưu ý: next-i18next được xây dựng dựa trên i18next. Hướng dẫn này sử dụng các primitive của i18next tương thích với next-i18next trong App Router, đồng thời giữ cho kiến trúc đơn giản và sẵn sàng cho môi trường production.
-> Để so sánh rộng hơn, xem [next-i18next vs next-i18next vs Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/vi/next-i18next_vs_next-i18next_vs_intlayer.md).
+> Để so sánh rộng hơn, xem [next-i18next vs next-intl vs Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/vi/next-i18next_vs_next-intl_vs_intlayer.md).
 
 ---
 

package/docs/vi/intlayer_with_next-intl.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Next.js và next-intl i18n - Cách dịch ứng dụng Next.js của bạn – hướng dẫn 2026
+title: next-intl - Cách dịch ứng dụng Next.js (i18n) vào năm 2026
 description: Khám phá cách làm cho website Next.js 15 App Router của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa

package/docs/vi/intlayer_with_nextjs_14.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-12-30
-title: Next.js i18n - Cách dịch ứng dụng Next.js 14 của bạn – hướng dẫn 2026
+title: Next.js i18n - Cách dịch ứng dụng Next.js 14 năm 2026
 description: Khám phá cách làm cho trang web Next.js 14 App Router của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa

package/docs/vi/intlayer_with_nextjs_15.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-25
 updatedAt: 2025-12-30
-title: Next.js i18n - Cách dịch ứng dụng Next.js 15 của bạn – hướng dẫn 2026
+title: Next.js i18n - Cách dịch ứng dụng Next.js 15 năm 2026
 description: Khám phá cách làm cho trang web Next.js 15 của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa

package/docs/vi/intlayer_with_nextjs_16.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-12-30
-title: Next.js i18n - Cách dịch ứng dụng Next.js 16 của bạn – hướng dẫn 2026
+title: Next.js i18n - Cách dịch ứng dụng Next.js 16 năm 2026
 description: Khám phá cách làm cho trang web Next.js 16 của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa
@@ -708,6 +708,8 @@ const ServerComponentExample = () => {
 
 > Để Tìm hiểu thêm về hook `useIntlayer`, hãy tham khảo [tài liệu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/next-intlayer/useIntlayer.md).
 
+> Nếu ứng dụng của bạn đã tồn tại, bạn có thể sử dụng [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compiler.md) kết hợp với [lệnh extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/extract.md) để chuyển đổi hàng nghìn component chỉ trong một giây.
+
 ### (Tùy chọn) Bước 7: Cấu hình Proxy để Phát hiện Ngôn ngữ
 
 Thiết lập proxy để phát hiện ngôn ngữ ưu tiên của người dùng:

package/docs/vi/intlayer_with_nextjs_compiler.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2026-01-10
 updatedAt: 2026-01-10
-title: Next.js i18n - Chuyển đổi ứng dụng Next.js hiện tại thành ứng dụng đa ngôn ngữ (hướng dẫn i18n 2026)
+title: Next.js i18n - Chuyển đổi ứng dụng Next.js hiện tại thành ứng dụng đa ngôn ngữ năm 2026
 description: Khám phá cách biến ứng dụng Next.js hiện tại của bạn thành một ứng dụng đa ngôn ngữ bằng cách sử dụng Intlayer Compiler. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch ứng dụng của bạn bằng AI.
 keywords:
   - Quốc tế hóa
@@ -14,9 +14,9 @@ keywords:
   - AI
 slugs:
   - doc
-  - cau hinh
+  - environment
   - nextjs
-  - trình biên dịch
+  - compiler
 applicationTemplate: https://github.com/aymericzip/intlayer-next-no-lolale-path-template
 youtubeVideo: https://www.youtube.com/watch?v=e_PPG7PTqGU
 history:
@@ -127,9 +127,26 @@ const config: IntlayerConfig = {
     mode: "search-params",
   },
   compiler: {
-    enabled: true, // Có thể thiết lập thành 'build-only' để giới hạn ảnh hưởng trong chế độ dev
-    outputDir: "i18n",
-    dictionaryKeyPrefix: "", // Không có tiền tố biên dịch, mặc định là "comp-"
+    /**
+     * Cho biết liệu trình biên dịch có nên được bật hay không.
+     */
+    enabled: true,
+
+    /**
+     * Thư mục đầu ra cho các từ điển đã được tối ưu hóa.
+     */
+    outputDir: "compiler",
+
+    /**
+     * Tiền tố khóa từ điển
+     */
+    dictionaryKeyPrefix: "", // Xóa tiền tố cơ bản
+
+    /**
+     * Cho biết liệu các thành phần có nên được lưu lại sau khi được biến đổi hay không.
+     * Bằng cách này, trình biên dịch có thể được chạy một lần để biến đổi ứng dụng, sau đó nó có thể được gỡ bỏ.
+     */
+    saveComponents: false,
   },
   ai: {
     provider: "openai",