@intlayer/docs 9.0.0-canary.3 → 9.0.0-canary.5

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.

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

@@ -0,0 +1,46 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Di Chuyển Từ NuxtJS I18n Sang Intlayer"
+description: "Tìm hiểu cách di chuyển ứng dụng Nuxt.js của bạn từ @nuxtjs/i18n sang Intlayer bằng bộ điều hợp tương thích."
+keywords:
+  - nuxtjs-i18n
+  - nuxt
+  - vue
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - nuxtjs-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Khởi tạo lịch sử"
+author: aymericzip
+---
+
+# Di Chuyển Từ NuxtJS I18n Sang Intlayer
+
+Việc di chuyển ứng dụng Nuxt của bạn từ `@nuxtjs/i18n` sang Intlayer là một quá trình liền mạch bằng cách sử dụng module Nuxt adapter.
+
+## Phải làm gì
+
+Để khởi tạo dự án, hãy chạy:
+
+```bash
+npx intlayer init
+```
+
+Lệnh này sẽ thiết lập `intlayer.config.ts`. Sau đó, thêm module Nuxt của Intlayer (ví dụ: `@intlayer/nuxt-i18n`) vào mảng modules trong `nuxt.config.ts` của bạn. Điều này tự động áp dụng cấu hình tương thích cho ứng dụng của bạn.
+
+## Những gì diễn ra bên dưới
+
+`@nuxtjs/i18n` bao bọc `vue-i18n` trong khi cung cấp các composable routing dành riêng cho Nuxt (`useLocalePath`, `useSwitchLocalePath`, `<NuxtLinkLocale>`).
+
+Bên dưới:
+
+- **Bản dịch:** Phụ thuộc gốc vào lớp tương thích `@intlayer/vue-i18n` cho tất cả các tác vụ dịch thuật chuỗi (hỗ trợ đầy đủ các định dạng `vue-i18n`, số nhiều kiểu pipe và reactivity).
+- **Routing:** Phản chiếu các composable routing bằng cách sử dụng các helper URL được bản địa hóa của Intlayer.
+- **Cấu hình:** Đọc `availableLocales` và các cài đặt mặc định trực tiếp từ `intlayer.config.ts` của bạn để tự động phối hợp các trang Nuxt.

package/docs/vi/compat/polyglot.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Di Chuyển Từ Polyglot.js Sang Intlayer"
+description: "Tìm hiểu cách di chuyển từ Polyglot.js sang Intlayer bằng bộ điều hợp tương thích."
+keywords:
+  - polyglot
+  - airbnb
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - polyglot
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Khởi tạo lịch sử"
+author: aymericzip
+---
+
+# Di Chuyển Từ Polyglot.js Sang Intlayer
+
+Nếu bạn đang sử dụng Polyglot.js của Airbnb, việc di chuyển sang Intlayer cực kỳ đơn giản bằng cách sử dụng lớp tương thích.
+
+## Phải làm gì
+
+Chỉ cần chạy lệnh khởi tạo trong dự án của bạn:
+
+```bash
+npx intlayer init
+```
+
+Lệnh này tạo `intlayer.config.ts`. Sau đó bạn có thể sử dụng bí danh plugin bundler để chuyển hướng trong suốt các import Polyglot sang `@intlayer/polyglot`.
+
+## Những gì diễn ra bên dưới
+
+Cú pháp Polyglot.js thường dựa vào `polyglot.t('key', {name})` với các nội suy `%{name}` và số nhiều `smart_count` được phân tách bằng `"singular |||| plural"`.
+
+Bên dưới:
+
+- **Nội suy:** Lớp tương thích xử lý các placeholder `%{var}` một cách gốc.
+- **Số nhiều:** Chuỗi được tách tại `||||` và đánh giá dựa trên `Intl.PluralRules` gốc theo locale đang hoạt động, phản chiếu thứ tự bucket của chính Polyglot theo locale.
+- **Từ điển:** Bạn bỏ qua việc cần cung cấp các cấu hình JSON khổng lồ cho `new Polyglot()` — Intlayer xử lý các từ điển một cách động và tự động loại bỏ chúng.

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

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Di Chuyển Từ react-i18next Sang Intlayer"
+description: "Tìm hiểu cách di chuyển ứng dụng React của bạn từ react-i18next sang Intlayer bằng bộ điều hợp tương thích."
+keywords:
+  - react-i18next
+  - i18next
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Khởi tạo lịch sử"
+author: aymericzip
+---
+
+# Di Chuyển Từ react-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 react-i18next](../migration_from_react-i18next_to_intlayer.md) đầy đủ của chúng tôi.
+
+Việc sử dụng bộ điều hợp tương thích của Intlayer cho phép bạn di chuyển từ `react-i18next` mà không cần bất kỳ thay đổi nào đối với các import trong source code của bạn.
+
+## Phải làm gì
+
+Để khởi tạo dự án, hãy chạy:
+
+```bash
+npx intlayer init
+```
+
+Trong quá trình khởi tạo, Intlayer sẽ cài đặt `@intlayer/react-i18next` và tạo `intlayer.config.ts`. Trong bundler của bạn (như Vite), hãy áp dụng plugin Intlayer:
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import { reactI18nextVitePlugin } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactI18nextVitePlugin()],
+});
+```
+
+## Những gì diễn ra bên dưới
+
+`reactI18nextVitePlugin` bao bọc plugin `vite-intlayer` cốt lõi và chèn các bí danh resolve cho `react-i18next` và `i18next`, chuyển hướng chúng sang `@intlayer/react-i18next` và `@intlayer/i18next`.
+
+Bên dưới:
+
+- **`useTranslation` & `withTranslation`:** Được viết lại để sử dụng các hook gốc của Intlayer, cung cấp cho bạn tính năng tự động hoàn thành TypeScript cho các key từ điển. Nó hỗ trợ liền mạch các namespace (ví dụ: `t('namespace:key')`).
+- **Số nhiều & Ngữ cảnh:** Xử lý số nhiều dựa trên hậu tố của i18next (`key_one`, `key_other`) bằng cách sử dụng `Intl.PluralRules` gốc và các hậu tố ngữ cảnh (`key_male`).
+- **Component `<Trans>`:** Được triển khai lại để hỗ trợ prop `components`, dạng đối tượng và mảng, và các thẻ được đánh số `<1>...</1>` ánh xạ trực tiếp đến các React node của bạn.
+- **Instance `i18n`:** Giải quyết các key trực tiếp từ Intlayer mà không cần tải các file JSON lớn, dẫn đến kích thước bundle nhỏ hơn đáng kể.

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

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Di Chuyển Từ React Intl Sang Intlayer"
+description: "Tìm hiểu cách di chuyển ứng dụng React của bạn từ react-intl sang Intlayer bằng bộ điều hợp tương thích."
+keywords:
+  - react-intl
+  - formatjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Khởi tạo lịch sử"
+author: aymericzip
+---
+
+# Di Chuyển Từ React Intl Sang Intlayer
+
+Nếu ứng dụng React của bạn sử dụng `react-intl` (FormatJS), việc chuyển đổi sang Intlayer rất dễ dàng. Lớp tương thích của chúng tôi xử lý liền mạch ICU MessageFormat và tất cả các component `Formatted*` hiện có.
+
+## Phải làm gì
+
+Bắt đầu bằng cách chạy lệnh khởi tạo trong dự án của bạn:
+
+```bash
+npx intlayer init
+```
+
+Sau đó, thiết lập plugin Vite hoặc Next.js của Intlayer trong cấu hình của bạn. Plugin này chèn các bí danh tại thời điểm build để chuyển hướng các import `react-intl` sang `@intlayer/react-intl`.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import reactIntlVitePlugin from "@intlayer/react-intl/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactIntlVitePlugin()],
+});
+```
+
+## Những gì diễn ra bên dưới
+
+Plugin bundler tạo bí danh `react-intl` thành `@intlayer/react-intl`. Thay vì phân tích thủ công các file JSON lớn và bao bọc ứng dụng của bạn trong một `IntlProvider`, plugin Intlayer trích xuất tĩnh các key và sử dụng các từ điển Intlayer tại thời điểm chạy.
+
+Bên dưới:
+
+- **ICU MessageFormat:** Intlayer sử dụng resolver `resolveMessage(..., 'icu')` hỗ trợ đầy đủ số nhiều ICU, lựa chọn, định dạng ngày/số và các thẻ rich text một cách gốc.
+- **Người gọi Method & JSX:** `intl.formatMessage({ id: 'a.b' })` và `<FormattedMessage id="a.b">` được xác định bởi các plugin biên dịch Intlayer (`@intlayer/babel` / `@intlayer/swc`), chuyển đổi các key dấu chấm phẳng để đoạn đầu tiên giải quyết chính xác đến key từ điển Intlayer.
+- **Formatter:** `<FormattedNumber>`, `<FormattedDate>`, v.v., kết nối với các `core/formatters` gốc bằng cách sử dụng `Intl`.

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

@@ -0,0 +1,47 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Di Chuyển Từ Svelte I18n Sang Intlayer"
+description: "Tìm hiểu cách di chuyển ứng dụng Svelte của bạn từ svelte-i18n sang Intlayer bằng bộ điều hợp tương thích."
+keywords:
+  - svelte-i18n
+  - svelte
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - svelte-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Khởi tạo lịch sử"
+author: aymericzip
+---
+
+# Di Chuyển Từ Svelte I18n Sang Intlayer
+
+Việc di chuyển ứng dụng Svelte của bạn từ `svelte-i18n` sang Intlayer chỉ mất một khoảnh khắc bằng cách sử dụng bộ điều hợp tương thích.
+
+## Phải làm gì
+
+Chỉ cần chạy lệnh khởi tạo trong dự án của bạn:
+
+```bash
+npx intlayer init
+```
+
+Lệnh này tạo `intlayer.config.ts`. Đảm bảo các plugin SvelteKit / Vite của bạn được bao bọc với plugin bí danh của Intlayer để liền mạch ánh xạ `svelte-i18n` sang `@intlayer/svelte-i18n`.
+
+## Những gì diễn ra bên dưới
+
+Svelte-i18n phụ thuộc vào các store được sử dụng nhiều (`$_`, `$t`, `$format`, v.v.) và ICU MessageFormat.
+
+Bên dưới:
+
+- **Store:** Intlayer proxy các store của `svelte-i18n`. `$_` trở thành một derived store của locale hiện tại trả về một resolver Intlayer.
+- **Key:** Các key phẳng của bạn (ví dụ: `$_('home.title')`) được đánh giá sao cho đoạn đường dẫn đầu tiên đại diện cho từ điển Intlayer.
+- **Cú pháp ICU:** Được xử lý đầy đủ bởi resolver ICU được chia sẻ (phân tích tương đương `intl-messageformat`).
+- **Formatter:** Các lời gọi `$date`, `$time`, `$number` chuyển hướng an toàn đến các formatter gốc core của Intlayer.
+- **Phân tích Babel/SWC:** Bộ phân tích Intlayer đọc các người gọi store Svelte (`$_`) bên trong các file `.svelte` nguồn của bạn trước khi biên dịch để tự động xây dựng các chunk từ điển liên quan.