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

package/docs/vi/cli/ci.md

@@ -140,6 +140,28 @@ steps:
     run: npx intlayer ci fill
 ```
 
+## GitHub Actions được tạo tự động
+
+Khi bạn chạy `intlayer init`, Intlayer sẽ phát hiện package manager của bạn (npm, yarn, pnpm, hoặc bun) và tạo hai workflow GitHub Actions trong `.github/workflows/`, với các lệnh phù hợp với package manager đó:
+
+- **`intlayer-fill.yml`** — Trên mọi pull request, xây dựng các từ điển và chạy `intlayer fill --git-diff --mode complete` để tạo các bản dịch bị thiếu cho các từ điển đã thay đổi, sau đó commit kết quả lại vào nhánh PR.
+- **`intlayer-test.yml`** — Trên mọi pull request, xây dựng các từ điển và chạy `intlayer test`, làm cho kiểm tra thất bại khi các locale bắt buộc bị thiếu bản dịch.
+
+Các tập tin workflow hiện có sẽ không bao giờ bị ghi đè. Để bỏ qua việc tạo tự động hoàn toàn, hãy chạy:
+
+```bash
+npx intlayer init --no-github-actions
+```
+
+### Cấp quyền truy cập AI cho quy trình fill
+
+`intlayer-fill.yml` được tạo ra yêu cầu quyền truy cập AI. Có hai tùy chọn có sẵn (được cấu hình trong khối `env` của quy trình):
+
+1. **Khóa nhà cung cấp AI của riêng bạn** — Thêm bí mật `AI_API_KEY` trong cài đặt kho lưu trữ của bạn (Settings → Secrets and variables → Actions). Quy trình sẽ chuyển tiếp nó qua `--provider`, `--model` và `--api-key`.
+2. **Khóa truy cập Intlayer CMS** — Thêm bí mật `INTLAYER_CLIENT_ID` và `INTLAYER_CLIENT_SECRET` và kết nối chúng vào phần `editor` của `intlayer.config` của bạn. Các khóa truy cập CMS cấp quyền truy cập AI thông qua backend Intlayer.
+
+Quy trình `intlayer-test.yml` không yêu cầu bất kỳ quyền truy cập AI nào.
+
 ## Xử lý lỗi
 
 - Nếu `INTLAYER_PROJECT_CREDENTIALS` không được đặt, lệnh sẽ thoát với lỗi.

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

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-06-17
 title: Đánh Giá Tài Liệu
 description: Tìm hiểu cách đánh giá các tệp tài liệu về chất lượng, tính nhất quán và độ đầy đủ trên các ngôn ngữ khác nhau.
 keywords:
@@ -15,6 +15,10 @@ slugs:
   - concept
   - cli
   - doc-review
+history:
+  - version: 9.0.0
+    date: 2026-06-17
+    changes: "Thêm tùy chọn --log"
 author: aymericzip
 ---
 
@@ -55,8 +59,110 @@ Lệnh này có thể được sử dụng để đánh giá các tệp đã đ
 
 ## Tham số:
 
-Lệnh `doc review` chấp nhận cùng các tham số như `doc translate`, cho phép bạn đánh giá các tệp tài liệu cụ thể và áp dụng các kiểm tra chất lượng.
+**Tùy chọn danh sách tệp:**
 
-Nếu bạn đã kích hoạt một trong các tùy chọn git, lệnh sẽ chỉ đánh giá phần của các tệp bị thay đổi. Script sẽ xử lý bằng cách chia tệp thành các phần nhỏ và đánh giá từng phần. Nếu phần đó không có thay đổi, script sẽ bỏ qua để tăng tốc quá trình đánh giá và giới hạn chi phí API của nhà cung cấp AI.
+- **`--doc-pattern [docPattern...]`**: Các mẫu glob để khớp với các tệp tài liệu cần đánh giá.
 
-- Để xem danh sách đầy đủ các tham số, hãy xem tài liệu lệnh [Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/doc-translate.md).
+  > Ví dụ: `npx intlayer doc review --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Các mẫu glob để loại trừ khỏi việc đánh giá.
+
+  > Ví dụ: `npx intlayer doc review --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Bỏ qua tệp nếu nó đã được sửa đổi trước thời gian cho trước.
+  - Có thể là thời gian tuyệt đối như "2025-12-05" (chuỗi hoặc Date)
+  - Có thể là thời gian tương đối tính bằng ms `1 * 60 * 60 * 1000` (1 giờ)
+  - Tùy chọn này kiểm tra thời gian cập nhật của tệp bằng phương thức `fs.stat`. Do đó, nó có thể bị ảnh hưởng bởi Git hoặc các công cụ khác sửa đổi tệp.
+
+  > Ví dụ: `npx intlayer doc review --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Bỏ qua tệp nếu nó đã được sửa đổi trong khoảng thời gian cho trước.
+  - Có thể là thời gian tuyệt đối như "2025-12-05" (chuỗi hoặc Date)
+  - Có thể là thời gian tương đối tính bằng ms `1 * 60 * 60 * 1000` (1 giờ)
+  - Tùy chọn này kiểm tra thời gian cập nhật của tệp bằng phương thức `fs.stat`. Do đó, nó có thể bị ảnh hưởng bởi Git hoặc các công cụ khác sửa đổi tệp.
+
+  > Ví dụ: `npx intlayer doc review --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Bỏ qua tệp nếu tệp đã tồn tại.
+
+  > Ví dụ: `npx intlayer doc review --skip-if-exists`
+
+**Tùy chọn chế độ đánh giá:**
+
+- **`--log`**: Chế độ chỉ ghi log. Không dịch bằng AI; thay vào đó, ghi lại các phần cần lưu ý (kèm số dòng và nội dung) cho ngôn ngữ cơ sở và ngôn ngữ đích, nhằm hỗ trợ một agent khác tạo bản dịch.
+
+  > Ví dụ: `npx intlayer doc review --log`
+
+**Tùy chọn xuất đầu vào:**
+
+- **`--locales [locales...]`**: Các ngôn ngữ đích để đánh giá tài liệu.
+
+  > Ví dụ: `npx intlayer doc review --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Ngôn ngữ nguồn (tài liệu cơ sở) để so sánh.
+
+  > Ví dụ: `npx intlayer doc review --base-locale en`
+
+**Tùy chọn xử lý tệp:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Số lượng tệp được xử lý đồng thời để đánh giá.
+
+  > Ví dụ: `npx intlayer doc review --nb-simultaneous-file-processed 5`
+
+**Tùy chọn AI:**
+
+- **`--model [model]`**: Mô hình AI được sử dụng để đánh giá (ví dụ: `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Nhà cung cấp AI được sử dụng để đánh giá.
+- **`--temperature [temperature]`**: Thiết lập nhiệt độ cho mô hình AI.
+- **`--api-key [apiKey]`**: Cung cấp khóa API riêng của bạn cho dịch vụ AI.
+- **`--application-context [applicationContext]`**: Cung cấp ngữ cảnh bổ sung cho việc đánh giá AI.
+- **`--data-serialization [dataSerialization]`**: Định dạng tuần tự hóa dữ liệu sử dụng cho các tính năng AI của Intlayer. Các tùy chọn: `json` (tiêu chuẩn, đáng tin cậy), `toon` (ít token hơn, kém nhất quán hơn).
+- **`--custom-prompt [prompt]`**: Tùy chỉnh prompt cơ bản được sử dụng cho việc đánh giá. (Lưu ý: Trong hầu hết các trường hợp, tùy chọn `--custom-instructions` được khuyến nghị vì nó cung cấp khả năng kiểm soát tốt hơn.)
+
+  > Ví dụ: `npx intlayer doc review --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "Ứng dụng của tôi là một cửa hàng mèo"`
+
+**Tùy chọn biến môi trường:**
+
+- **`--env`**: Chỉ định môi trường (ví dụ: `development`, `production`).
+- **`--env-file [envFile]`**: Cung cấp tệp môi trường tùy chỉnh để tải biến.
+- **`--base-dir`**: Chỉ định thư mục gốc cho dự án.
+- **`--no-cache`**: Vô hiệu hóa bộ nhớ đệm.
+
+  > Ví dụ: `npx intlayer doc review --base-dir ./docs --env-file .env.production.local`
+
+**Tùy chọn ghi log:**
+
+- **`--verbose`**: Bật ghi log chi tiết để gỡ lỗi. (mặc định là true khi sử dụng CLI)
+
+  > Ví dụ: `npx intlayer doc review --verbose`
+
+**Tùy chọn hướng dẫn tùy chỉnh:**
+
+- **`--custom-instructions [customInstructions]`**: Hướng dẫn tùy chỉnh được thêm vào prompt. Hữu ích để áp dụng các quy tắc cụ thể liên quan đến định dạng, dịch URL, v.v.
+
+  > Ví dụ: `npx intlayer doc review --custom-instructions "Tránh dịch các URL, và giữ nguyên định dạng markdown"`
+
+  > Ví dụ: `npx intlayer doc review --custom-instructions "$(cat ./instructions.md)"`
+
+**Tùy chọn Git:**
+
+- **`--git-diff`**: Chỉ chạy trên các tệp có thay đổi từ cơ sở (mặc định `origin/main`) đến nhánh hiện tại (mặc định: `HEAD`).
+- **`--git-diff-base`**: Chỉ định tham chiếu cơ sở cho git diff (mặc định `origin/main`).
+- **`--git-diff-current`**: Chỉ định tham chiếu hiện tại cho git diff (mặc định: `HEAD`).
+- **`--uncommitted`**: Bao gồm các thay đổi chưa được commit.
+- **`--unpushed`**: Bao gồm các thay đổi chưa được đẩy lên.
+- **`--untracked`**: Bao gồm các tệp chưa được theo dõi.
+
+  > Ví dụ: `npx intlayer doc review --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Ví dụ: `npx intlayer doc review --uncommitted --unpushed --untracked`
+
+> Lưu ý rằng đường dẫn tệp đầu ra sẽ được xác định bằng cách thay thế các mẫu sau:
+>
+> - `/{{baseLocale}}/` thành `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` thành `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` thành `_{{locale}}.`
+> - `{{baseLocale}}_` thành `{{locale}}_`
+> - `.{{baseLocaleName}}.` thành `.{{localeName}}.`
+>
+> Nếu không tìm thấy mẫu, tệp đầu ra sẽ thêm `.{{locale}}` vào phần mở rộng của tệp. Ví dụ, `./my/file.md` sẽ được đánh giá và cập nhật thành `./my/file.fr.md` cho ngôn ngữ Pháp.

package/docs/vi/cli/fill.md

@@ -47,6 +47,14 @@ Lệnh này phân tích các tệp khai báo nội dung của bạn để tìm c
 - Bảo tồn các bản dịch hiện có bằng cách không ghi đè chúng.
 - Xử lý tệp, phần và ngôn ngữ song song bằng hệ thống hàng đợi để tăng tốc độ.
 
+## Những Điểm Chính:
+
+- Chia các tệp JSON lớn thành các chunks để duy trì trong giới hạn cửa sổ ngữ cảnh của mô hình AI.
+- Thử lại dịch nếu định dạng đầu ra không chính xác.
+- Kết hợp ngữ cảnh cụ thể cho ứng dụng và tệp để cải thiện độ chính xác của bản dịch.
+- Bảo tồn các bản dịch hiện có bằng cách không ghi đè chúng.
+- Xử lý các tệp, chunks và locales song song bằng cách sử dụng hệ thống queue để tăng tốc độ.
+
 ## Bí danh:
 
 - `npx intlayer dictionaries fill`

package/docs/vi/cli/index.md

@@ -17,7 +17,7 @@ slugs:
   - concept
   - cli
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "Thêm nội dung lệnh scan"
   - version: 8.6.4

package/docs/vi/cli/login.md

@@ -78,42 +78,6 @@ bun x intlayer login --cms-url https://intlayer.org
 
 ### Tùy chọn cấu hình
 
-Bạn cũng có thể sử dụng các tùy chọn cấu hình chung sau:
-
-- `--env-file <path>`: Đường dẫn tới file môi trường
-- `-e, --env <env>`: Môi trường thực thi
-- `--base-dir <dir>`: Thư mục gốc của dự án
-- `--verbose`: Bật đầu ra chi tiết (mặc định: true)
-- `--prefix <prefix>`: Tiền tố cho logs
-
-## Cách hoạt động
-
-1. **Khởi động máy chủ cục bộ**: Lệnh khởi động một máy chủ HTTP cục bộ trên một cổng ngẫu nhiên để nhận thông tin xác thực từ CMS
-
-Chỉ định URL của Intlayer CMS để kết nối xác thực.
-
-- **Loại**: `string`
-- **Mặc định**: Giá trị được cấu hình trong `intlayer.config.*` hoặc `https://intlayer.org`
-- **Ví dụ**:
-
-```bash packageManager="npm"
-npx intlayer login --cms-url https://intlayer.org
-```
-
-```bash packageManager="yarn"
-yarn intlayer login --cms-url https://intlayer.org
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer login --cms-url https://intlayer.org
-```
-
-```bash packageManager="bun"
-bun x intlayer login --cms-url https://intlayer.org
-```
-
-### Tùy chọn cấu hình
-
 Bạn cũng có thể sử dụng các tùy chọn cấu hình chung:
 
 - `--env-file <path>`: Đường dẫn tới file môi trường

package/docs/vi/cli/scan.md

@@ -18,7 +18,7 @@ slugs:
   - cli
   - scan
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "Thêm nội dung lệnh scan"
 author: aymericzip

package/docs/vi/compat/i18n-js.md

@@ -0,0 +1,44 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Di Chuyển Từ i18n-js Sang Intlayer"
+description: "Tìm hiểu cách di chuyển ứng dụng của bạn từ i18n-js sang Intlayer bằng bộ điều hợp tương thích."
+keywords:
+  - i18n-js
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - i18n-js
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Khởi tạo lịch sử"
+author: aymericzip
+---
+
+# Di Chuyển Từ i18n-js Sang Intlayer
+
+Việc chuyển đổi từ thư viện `i18n-js` sang Intlayer là một quá trình di chuyển được tối ưu hóa cao, được thiết kế để chuyển các cấu hình dịch thuật lớn sang hệ thống phân giải file có cấu trúc của Intlayer.
+
+## Phải làm gì
+
+Thực thi lệnh thiết lập sau trong repository của bạn:
+
+```bash
+npx intlayer init
+```
+
+Sau khi `intlayer.config.ts` được chuẩn bị, bạn có thể thêm bí danh của Intlayer vào cấu hình bundler của mình để bất kỳ import nào của `i18n-js` đều trỏ đến gói tương thích `@intlayer/i18n-js`.
+
+## Những gì diễn ra bên dưới
+
+`i18n-js` truy cập các namespace thông qua các biểu thức như `i18n.t('scope.key', {name})` cùng với các cơ chế dự phòng theo ngôn ngữ và ánh xạ số nhiều cụ thể.
+
+Bên dưới:
+
+- **Nội suy:** Bộ điều hợp tương thích dễ dàng phân tích các ánh xạ `%{name}` thành giá trị từ điển đích tại thời điểm chạy.
+- **Số nhiều:** Thay thế các subkey `one/other` và ánh xạ chúng sang các cơ chế số nhiều mạnh mẽ của Intlayer (`Intl.PluralRules`), loại bỏ các ánh xạ thủ công.
+- **Ngôn ngữ:** Thay vì tải toàn bộ payload ngôn ngữ khi khởi động, các từ điển được phục vụ tối ưu dựa trên thiết lập ngữ cảnh hiện tại thông qua cấu hình Intlayer gốc.

package/docs/vi/compat/i18next.md

@@ -0,0 +1,59 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Di Chuyển Từ i18next Sang Intlayer"
+description: "Tìm hiểu cách di chuyển ứng dụng Vanilla JS/TS của bạn từ i18next sang Intlayer bằng bộ điều hợp tương thích."
+keywords:
+  - i18next
+  - vanilla
+  - javascript
+  - typescript
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Khởi tạo lịch sử"
+author: aymericzip
+---
+
+# Di Chuyển Từ i18next Sang Intlayer
+
+Để có hướng dẫn từng bước chi tiết, vui lòng xem [Hướng Dẫn Di Chuyển i18next](../migration_from_i18next_to_intlayer.md) đầy đủ của chúng tôi.
+
+Intlayer tái tạo hoàn hảo các đặc tính runtime cốt lõi của `i18next`. Bằng cách sử dụng gói tương thích, các ứng dụng Vanilla hoặc các module nội bộ của bạn có thể tiếp tục tận dụng cú pháp quen thuộc.
+
+## Phải làm gì
+
+Để bắt đầu, hãy khởi tạo Intlayer trong dự án của bạn:
+
+```bash
+npx intlayer init
+```
+
+Nếu bạn đang sử dụng Vite, hãy bao gồm plugin Intlayer để định tuyến các import sang `@intlayer/i18next`:
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { i18nextVitePlugin } from "@intlayer/i18next/plugin";
+
+export default defineConfig({
+  plugins: [i18nextVitePlugin()],
+});
+```
+
+## Những gì diễn ra bên dưới
+
+`i18nextVitePlugin` tạo bí danh cho các import `i18next` sang `@intlayer/i18next`, tránh việc bundle bị phình to do bao gồm các file JSON.
+
+Bên dưới:
+
+- **Cấu hình instance:** `createInstance` phân tích chính xác và áp dụng các namespace fallback trong khi tận dụng pipeline biên dịch của Intlayer để truy xuất từ điển.
+- **Nội suy:** Hỗ trợ gốc cho các thay thế `{{name}}` và lồng `$t(key)` theo đệ quy.
+- **Ngữ cảnh & Số nhiều:** Xác định và giải quyết các định dạng hậu tố như `key_male` và `key_one`/`key_other` đánh giá dựa trên `Intl.PluralRules` tiêu chuẩn.
+- **Trả về đối tượng:** Chế độ `returnObjects: true` an toàn trích xuất cây từ các từ điển Intlayer.

package/docs/vi/compat/index.md

@@ -0,0 +1,51 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Bộ Điều Hợp Tương Thích Intlayer"
+description: "Di chuyển giải pháp i18n hiện có của bạn sang Intlayer một cách dễ dàng bằng các bộ điều hợp tương thích."
+keywords:
+  - compat
+  - migration
+  - internationalization
+  - i18n
+  - Intlayer
+slugs:
+  - doc
+  - compatibility
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Khởi tạo lịch sử"
+author: aymericzip
+---
+
+# Bộ Điều Hợp Tương Thích Intlayer
+
+Việc di chuyển một ứng dụng lớn sang thư viện quốc tế hóa mới có thể là một thách thức lớn. Để giảm bớt quá trình chuyển đổi này, Intlayer cung cấp **các bộ điều hợp tương thích** cho các thư viện i18n phổ biến nhất trong hệ sinh thái.
+
+Các gói điều hợp này cung cấp **chính xác cùng một API công khai** như các thư viện i18n hiện có của bạn, nhưng ủy thác toàn bộ công việc dịch thuật cho Intlayer tại thời điểm chạy.
+
+## Cách hoạt động
+
+Khi bạn sử dụng một bộ điều hợp tương thích, bạn không cần phải viết lại các lệnh import trong ứng dụng hoặc thay đổi cách bạn sử dụng các hook và component dịch thuật. Thay vào đó, các plugin bundler của Intlayer tự động tạo bí danh cho các import hiện có của bạn sang các gói tương thích Intlayer.
+
+Ví dụ, một nhà phát triển thay thế `import { useTranslation } from 'react-i18next'` bằng `import { useTranslation } from '@intlayer/react-i18next'` (được thực hiện tự động thông qua plugin bundler), và ứng dụng tiếp tục hoạt động với các bản dịch nay được cung cấp từ từ điển Intlayer. Các key cũng được đánh kiểu dựa trên từ điển Intlayer của bạn!
+
+## Các Bộ Điều Hợp Tương Thích Có Sẵn
+
+Chọn thư viện hiện có của bạn bên dưới để xem cách di chuyển một cách liền mạch:
+
+- [Vue I18n](./vue-i18n.md)
+- [Transloco](./transloco.md)
+- [React Intl](./react-intl.md)
+- [Svelte I18n](./svelte-i18n.md)
+- [React i18next](./react-i18next.md)
+- [Polyglot.js](./polyglot.md)
+- [NuxtJS I18n](./nuxtjs-i18n.md)
+- [NGX Translate](./ngx-translate.md)
+- [Next Translate](./next-translate.md)
+- [Next Intl](./next-intl.md)
+- [Next i18next](./next-i18next.md)
+- [i18next](./i18next.md)
+- [Lingui](./lingui.md)
+- [I18n-js](./i18n-js.md)

package/docs/vi/compat/lingui.md

@@ -0,0 +1,44 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Di Chuyển Từ Lingui Sang Intlayer"
+description: "Tìm hiểu cách di chuyển ứng dụng của bạn từ Lingui sang Intlayer bằng bộ điều hợp tương thích."
+keywords:
+  - lingui
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - lingui
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Khởi tạo lịch sử"
+author: aymericzip
+---
+
+# Di Chuyển Từ Lingui Sang Intlayer
+
+Nếu dự án của bạn hiện đang sử dụng quá trình biên dịch dựa trên macro của Lingui, việc chuyển đổi sang Intlayer cho phép bạn duy trì các quy trình macro mạnh mẽ trong khi hỗ trợ chúng một cách gốc với chiến lược biên dịch JSON của Intlayer.
+
+## Phải làm gì
+
+Để bắt đầu, hãy khởi tạo Intlayer trong dự án của bạn:
+
+```bash
+npx intlayer init
+```
+
+Lệnh này tạo `intlayer.config.ts` của bạn. Đảm bảo giữ lại `@lingui/babel-plugin-lingui-macro` / `@lingui/swc-plugin` trong bước build để chạy _trước_ trình biên dịch Intlayer. Sau đó, sử dụng bí danh plugin bundler để định tuyến `@lingui/core` và `@lingui/react` sang `@intlayer/lingui`.
+
+## Những gì diễn ra bên dưới
+
+Lingui sử dụng các macro (như `` t`Hello ${name}` `` và `<Trans>`) được biên dịch thành các lời gọi runtime như `i18n._(id, values)`.
+
+Bên dưới:
+
+- **Macro:** Chúng biên dịch chính xác như trước đây, đảm bảo không có sự gián đoạn trong cú pháp nguồn của bạn.
+- **Dịch thuật tại runtime:** `i18n._()` được đặt bí danh sử dụng các từ điển Intlayer. Cả ID được đặt tên rõ ràng và ID được băm đều được ánh xạ đầy đủ bằng cách sử dụng các plugin đồng bộ `.po` của Intlayer để tổng hợp và loại bỏ các key một cách an toàn.
+- **Khả năng ICU:** Hỗ trợ số nhiều, lựa chọn và các biến thể ICU vẫn mạnh mẽ nhờ trình phân tích ICU thống nhất của Intlayer, đảm bảo đầu ra hiển thị giống nhau.

package/docs/vi/compat/next-i18next.md

@@ -0,0 +1,57 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Di Chuyển Từ next-i18next Sang Intlayer"
+description: "Tìm hiểu cách di chuyển ứng dụng Next.js của bạn từ next-i18next sang Intlayer bằng bộ điều hợp tương thích."
+keywords:
+  - next-i18next
+  - nextjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Khởi tạo lịch sử"
+author: aymericzip
+---
+
+# Di Chuyển Từ next-i18next Sang Intlayer
+
+Để có hướng dẫn từng bước đầy đủ và chi tiết, vui lòng xem [Hướng Dẫn Di Chuyển next-i18next](../migration_from_next-i18next_to_intlayer.md) đầy đủ của chúng tôi.
+
+Intlayer xử lý tất cả các triển khai Next.js Pages Router và App Router một cách minh bạch. Sử dụng bộ điều hợp cho phép bạn di chuyển triển khai `next-i18next` mà không cần viết lại bất kỳ code nào.
+
+## Phải làm gì
+
+Để bắt đầu, hãy chạy:
+
+```bash
+npx intlayer init
+```
+
+Lệnh này tạo file thiết lập Intlayer cần thiết. Để chuyển sang Intlayer ở hậu trường, hãy cập nhật `next.config.ts` của bạn:
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+
+const withIntlayer = createNextI18nPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## Những gì diễn ra bên dưới
+
+`createNextI18nPlugin` kết hợp hành vi gốc của Next.js cùng với plugin `next-intlayer` cốt lõi, chèn tất cả các bí danh Webpack/Turbopack cần thiết cho `next-i18next`, `react-i18next` và `i18next`.
+
+Bên dưới:
+
+- **`serverSideTranslations` & `appWithTranslation`:** Chúng hiện hoạt động như các wrapper cho các bộ tải nội bộ của Intlayer, bỏ qua việc chèn JSON tĩnh lớn.
+- **Hook phía client:** Ủy thác ngay lập tức cho `@intlayer/react-i18next`, giữ lại tất cả các tính năng định dạng, số nhiều và namespace lồng nhau.

package/docs/vi/compat/next-intl.md

@@ -0,0 +1,59 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Di Chuyển Từ next-intl Sang Intlayer"
+description: "Tìm hiểu cách di chuyển ứng dụng Next.js của bạn từ next-intl sang Intlayer bằng bộ điều hợp tương thích."
+keywords:
+  - next-intl
+  - nextjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Khởi tạo lịch sử"
+author: aymericzip
+---
+
+# Di Chuyển Từ next-intl Sang Intlayer
+
+Để có hướng dẫn từng bước đầy đủ và chi tiết, vui lòng xem [Hướng Dẫn Di Chuyển next-intl](../migration_from_next-intl_to_intlayer.md) đầy đủ của chúng tôi.
+
+Việc di chuyển từ `next-intl` sang Intlayer cho phép bạn duy trì routing và cú pháp của ứng dụng hoàn toàn không bị gián đoạn.
+
+## Phải làm gì
+
+Thực thi lệnh sau trong repository của bạn:
+
+```bash
+npx intlayer init
+```
+
+Lệnh này sẽ tạo một `intlayer.config.ts`. Trong `next.config.ts` của bạn, hãy sử dụng wrapper plugin để liền mạch chèn các bí danh `next-intl` hướng đến `@intlayer/next-intl`.
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextIntlPlugin } from "@intlayer/next-intl/plugin";
+
+const withIntlayer = createNextIntlPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## Những gì diễn ra bên dưới
+
+Wrapper bundler thay thế các bản dịch, nhưng **giữ nguyên các tính năng `next-intl/navigation`** (ví dụ: `Link`, `redirect`, `usePathname`).
+
+Bên dưới:
+
+- **Runtime ICU:** Số nhiều (`=0`, `one`, `other`), select/selectordinal, đối số `#` và các đối số được định dạng (`{ts, date, long}`) chạy chính xác bằng cách sử dụng resolver `resolveMessage(..., 'icu')` được chia sẻ.
+- **`useTranslations()` & `getTranslations()`:** Các lời gọi phạm vi đơn giản trích xuất đoạn key đầu tiên làm định danh từ điển chính xác. Các namespace lồng nhau được tách một cách uyển chuyển thành các đường dẫn từ điển và tiền tố.
+- **Định dạng phong phú:** Cả `t.rich()` và `t.markup()` đều được triển khai gốc đầy đủ, chuyển đổi các nút dạng HTML thành các chunk React được hiển thị.
+- **`useFormatter`:** `relativeTime`, `list`, `dateTimeRange` và các định dạng được đặt tên từ cấu hình kết nối với các formatter `Intl` gốc của core.

package/docs/vi/compat/next-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Di Chuyển Từ Next Translate Sang Intlayer"
+description: "Tìm hiểu cách di chuyển ứng dụng Next.js của bạn từ next-translate sang Intlayer bằng bộ điều hợp tương thích."
+keywords:
+  - next-translate
+  - nextjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Khởi tạo lịch sử"
+author: aymericzip
+---
+
+# Di Chuyển Từ Next Translate Sang Intlayer
+
+Việc di chuyển từ `next-translate` sang Intlayer gần như là một sự thay thế hoàn toàn, giữ lại cú pháp và các thẻ hiện có của bạn.
+
+## Phải làm gì
+
+Khởi tạo Intlayer trong dự án của bạn:
+
+```bash
+npx intlayer init
+```
+
+CLI sẽ tạo cấu hình của bạn. Sau đó bạn có thể áp dụng plugin Intlayer trong `next.config.ts` của mình, plugin này chèn các bí danh subpath tại thời điểm build ánh xạ `next-translate/useTranslation` sang `@intlayer/next-translate`.
+
+## Những gì diễn ra bên dưới
+
+`next-translate` cung cấp các hook như `useTranslation('ns')`, `t('ns:key.path')` và component `<Trans>`.
+
+Bên dưới:
+
+- **Nội suy & Số nhiều:** Nó phụ thuộc chặt chẽ vào hành vi của bộ điều hợp `react-i18next`. Các placeholder `{{var}}` và số nhiều được ánh xạ từ các hậu tố như `key_0`, `key_one` và `key_other` được xử lý động.
+- **Component `<Trans>`:** Được hỗ trợ trực tiếp cho việc phân tích thẻ dạng HTML cùng với prop `components` dựa trên mảng.
+- **Namespace:** Việc đặt bí danh subpath đảm bảo rằng `useTranslation` của bạn tham chiếu đúng namespace từ điển nội bộ mà không cần sửa đổi thủ công.

package/docs/vi/compat/ngx-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Di Chuyển Từ NGX-Translate Sang Intlayer"
+description: "Tìm hiểu cách di chuyển ứng dụng Angular của bạn từ ngx-translate sang Intlayer bằng bộ điều hợp tương thích."
+keywords:
+  - ngx-translate
+  - angular
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - ngx-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Khởi tạo lịch sử"
+author: aymericzip
+---
+
+# Di Chuyển Từ NGX-Translate Sang Intlayer
+
+Việc di chuyển ứng dụng Angular của bạn từ `ngx-translate` sang Intlayer rất dễ dàng với bộ điều hợp tương thích, cho phép bạn bỏ qua việc phải viết lại tất cả các template.
+
+## Phải làm gì
+
+Bắt đầu bằng cách chạy:
+
+```bash
+npx intlayer init
+```
+
+Lệnh này thiết lập `intlayer.config.ts`. Thay thế các thiết lập `TranslateModule.forRoot()` và bí danh import một cách phù hợp để trỏ đến `@intlayer/ngx-translate`.
+
+## Những gì diễn ra bên dưới
+
+`ngx-translate` sử dụng `TranslateService` (`instant`, `get`, `stream`) cùng với pipe `{{ 'KEY' | translate:params }}` và directive `[translate]`.
+
+Bên dưới:
+
+- **Service:** `TranslateService` bao bọc `getIntlayer` và một observable locale, cung cấp chính xác các phương thức giống nhau.
+- **Pipe & Directive:** Được triển khai lại để giải quyết trực tiếp dựa trên các từ điển Intlayer.
+- **Loader:** Các thiết lập `TranslateHttpLoader` được chuyển đổi thành các stub cảnh báo vì Intlayer vốn đã giải quyết và đóng gói các từ điển của bạn tại thời điểm build (hoặc thông qua các dynamic import tiêu chuẩn), hoàn toàn loại bỏ nhu cầu về HTTP loader.