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

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.

package/docs/vi/compat/transloco.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Di Chuyển Từ Transloco Sang Intlayer"
+description: "Tìm hiểu cách di chuyển ứng dụng Angular của bạn từ Transloco sang Intlayer bằng bộ điều hợp tương thích."
+keywords:
+  - transloco
+  - angular
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - transloco
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Khởi tạo lịch sử"
+author: aymericzip
+---
+
+# Di Chuyển Từ Transloco Sang Intlayer
+
+Nếu ứng dụng Angular của bạn hiện đang sử dụng `@jsverse/transloco`, bạn có thể di chuyển sang Intlayer bằng cách sử dụng bộ điều hợp tương thích của chúng tôi. Quá trình chuyển đổi này cho phép bạn duy trì cú pháp template hiện có trong khi tận dụng cấu trúc từ điển mạnh mẽ của Intlayer.
+
+## 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 sẽ tạo cấu hình `intlayer.config.ts` cần thiết. Sau đó bạn sẽ thay thế các import Transloco của mình bằng các module `@intlayer/transloco` hoặc dựa vào các bí danh build.
+
+## Những gì diễn ra bên dưới
+
+Transloco sử dụng các phạm vi và `TranslocoService` (`translate`, `selectTranslate`), cùng với các directive cấu trúc (`*transloco="let t"`) và pipe (`| transloco`).
+
+Bên dưới:
+
+- **Phạm vi:** Ánh xạ tự nhiên đến các key từ điển Intlayer, cung cấp một cách loại bỏ tuyệt vời cho tối ưu hóa bundle.
+- **Service & Directive:** Bộ điều hợp Angular của Intlayer thay thế liền mạch các provider, cho phép các pipe và directive template hiện có của bạn giải quyết các chuỗi dựa trên các từ điển Intlayer.
+- **Phân tích tại thời điểm build:** Bộ phân tích TypeScript nhận ra các lời gọi `instant/get`, và việc loại bỏ fallback đảm bảo tính chính xác ngay cả khi việc sử dụng template không thể theo dõi tĩnh được.

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

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Di Chuyển Từ Vue I18n Sang Intlayer"
+description: "Tìm hiểu cách di chuyển ứng dụng Vue của bạn từ vue-i18n sang Intlayer bằng bộ điều hợp tương thích."
+keywords:
+  - vue-i18n
+  - vue
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - vue-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Khởi tạo lịch sử"
+author: aymericzip
+---
+
+# Di Chuyển Từ Vue I18n Sang Intlayer
+
+Nếu ứng dụng Vue của bạn hiện đang sử dụng `vue-i18n`, bạn có thể di chuyển sang Intlayer mà không cần viết lại các component hoặc dịch các hook. Intlayer cung cấp một bộ điều hợp tương thích phản chiếu hoàn hảo API của `vue-i18n` trong khi tận dụng các tính năng mạnh mẽ của Intlayer bên dưới.
+
+## Phải làm gì
+
+Để bắt đầu, chỉ cần chạy lệnh khởi tạo trong dự án của bạn:
+
+```bash
+npx intlayer init
+```
+
+Trong quá trình khởi tạo, Intlayer sẽ thiết lập file cấu hình (`intlayer.config.ts`) và chuẩn bị dự án của bạn để di chuyển. Bạn chỉ cần thêm plugin Intlayer vào cấu hình Vite của mình để tự động tạo bí danh cho các import `vue-i18n`.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vue(), vueI18nVitePlugin()],
+});
+```
+
+## Những gì diễn ra bên dưới
+
+`vueI18nVitePlugin` chèn một bí danh module vào bundler của bạn. Bất kỳ import nào của `vue-i18n` trong codebase của bạn sẽ được chuyển hướng trong suốt sang `@intlayer/vue-i18n`.
+
+**Bên dưới, bộ điều hợp xử lý cú pháp `vue-i18n` phức tạp một cách gốc:**
+
+- **Nội suy & Số nhiều:** Giải quyết các nội suy `{name}` và danh sách `{0}`. Số nhiều kiểu pipe (`"car | cars"`) được chuyển đổi thành các node enumeration/plural của Intlayer dựa trên ngữ nghĩa vị trí.
+- **Định dạng:** Các hàm như `d()` và `n()` bao bọc `Intl` bên dưới, tuân thủ `datetimeFormats` và `numberFormats` được xác định trong các tùy chọn của bạn.
+- **Trạng thái toàn cục & cục bộ:** `global.locale` được ánh xạ tới một `WritableComputedRef` được hỗ trợ bởi client Intlayer, vì vậy reactivity hoạt động chính xác như mong đợi (ví dụ: `locale.value = 'fr'`).
+- **Directive:** Directive `v-t` được đăng ký và hoạt động bình thường.
+
+Ứng dụng của bạn tiếp tục hiển thị chính xác như trước, nhưng nội dung được cung cấp bởi các từ điển Intlayer của bạn, mang lại cho bạn type safety, tối ưu hóa bundle tốt hơn và tích hợp CMS liền mạch.

package/docs/vi/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-03-12
+updatedAt: 2026-06-23
 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:
@@ -60,6 +60,8 @@ Như một giải pháp thay thế, để tự động hóa quy trình i18n củ
 
 ## Cách sử dụng
 
+> The quickest way to wire the compiler in is the interactive setup: run `npx intlayer init --interactive` and select **Compiler**. On Vite there is nothing to configure — the compiler is plugged in directly through the `intlayerCompiler()` plugin. On Next.js the command scaffolds the `babel.config.js` shown below. The non-interactive `intlayer init` leaves the compiler setup untouched.
+
 <Tabs>
  <Tab value='vite'>
 
@@ -79,12 +81,15 @@ Cập nhật file `vite.config.ts` của bạn để bao gồm plugin `intlayerC
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // Thêm plugin trình biên dịch
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/vi/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-05-12
+updatedAt: 2026-06-23
 title: Cấu hình (Configuration)
 description: Tìm hiểu cách cấu hình Intlayer cho ứng dụng của bạn. Hiểu các cài đặt và tùy chọn khác nhau có sẵn để tùy chỉnh Intlayer theo nhu cầu của bạn.
 keywords:
@@ -14,6 +14,12 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-06-24
+    changes: "Add `enableProxy` option to the routing configuration"
+  - version: 8.10.0
+    date: 2026-06-17
+    changes: "Thêm tùy chọn `format` vào cấu hình từ điển"
   - version: 8.9.4
     date: 2026-05-12
     changes: "Thêm hỗ trợ cho nhà cung cấp LM Studio"
@@ -135,6 +141,7 @@ Intlayer chấp nhận các định dạng tệp cấu hình JSON, JS, MJS và T
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import { Locales, type IntlayerConfig } from "intlayer";
 import { nextjsRewrite } from "intlayer/routing";
+import { syncJSON } from "@intlayer/sync-json-plugin";
 import { z } from "zod";
 
 /**
@@ -583,9 +590,37 @@ const config: IntlayerConfig = {
   },
 
   /**
-   * Cấu hình các plugin.
+   * Cấu hình từ điển.
    */
-  plugins: [],
+  dictionary: {
+    /**
+     * Kiểm soát cách các từ điển được nhập.
+     * - "static": Nhập tĩnh tại thời điểm xây dựng.
+     * - "dynamic": Nhập động sử dụng Suspense.
+     * - "fetch": Tìm nạp động qua API đồng bộ trực tiếp.
+     */
+    importMode: "static",
+
+    /**
+     * Định dạng tin nhắn mặc định cho tất cả các từ điển trong dự án.
+     * - 'intlayer': Định dạng intlayer gốc (mặc định).
+     * - 'icu': Định dạng tin nhắn ICU.
+     * - 'i18next': Định dạng i18next.
+     * - 'vue-i18n': Định dạng Vue I18n.
+     * - 'po': Định dạng GNU Gettext PO.
+     */
+    format: "icu",
+  },
+
+  /**
+   * Cấu hình plugin.
+   */
+  plugins: [
+    syncJSON({
+      format: "icu",
+      source: ({ locale }) => `./messages/${locale}.json`,
+    }),
+  ],
 };
 
 export default config;
@@ -850,24 +885,40 @@ Các cài đặt về cách nội dung được quản lý trong ứng dụng, b
 
 ---
 
+### Cấu hình Hệ thống
+
+Các cài đặt liên quan đến các đường dẫn nội bộ và kết quả đầu ra của Intlayer. Các cài đặt này thường là nội bộ và không cần phải được sửa đổi bởi người dùng.
+
+| Field                     | Description                                                                   | Type     | Default                           | Example              | Note                                                                  |
+| ------------------------- | ----------------------------------------------------------------------------- | -------- | --------------------------------- | -------------------- | --------------------------------------------------------------------- |
+| `baseDir`                 | Thư mục cơ sở cho dự án.                                                      | `string` | `process.cwd()`                   | `'/path/to/project'` | Được sử dụng để giải quyết tất cả các thư mục liên quan đến Intlayer. |
+| `dictionariesDir`         | Đường dẫn thư mục để lưu trữ từ điển bản địa hóa.                             | `string` | `'.intlayer/dictionary'`          |                      |                                                                       |
+| `moduleAugmentationDir`   | Thư mục để tăng cường module, cho phép có gợi ý IDE tốt hơn và kiểm tra loại. | `string` | `'.intlayer/types'`               | `'intlayer-types'`   | Hãy chắc chắn bao gồm điều này trong `tsconfig.json`.                 |
+| `unmergedDictionariesDir` | Thư mục để lưu trữ các từ điển chưa được hợp nhất.                            | `string` | `'.intlayer/unmerged_dictionary'` |                      |                                                                       |
+| `typesDir`                | Thư mục để lưu trữ các loại từ điển.                                          | `string` | `'.intlayer/types'`               |                      |                                                                       |
+| `mainDir`                 | Thư mục nơi lưu trữ các tệp ứng dụng chính.                                   | `string` | `'.intlayer/main'`                |                      |                                                                       |
+| `configDir`               | Thư mục nơi lưu trữ các tệp cấu hình.                                         | `string` | `'.intlayer/config'`              |                      |                                                                       |
+| `cacheDir`                | Thư mục nơi lưu trữ các tệp bộ nhớ đệm.                                       | `string` | `'.intlayer/cache'`               |                      |                                                                       |
+
 ### Cấu hình Dictionary (Dictionary)
 
 Tham số điều khiển các hoạt động của dictionary, bao gồm hành vi tự động điền (auto-fill) và thế hệ nội dung.
 
-| Trường                      | Mô tả                                                                                                                                                      | Kiểu dữ liệu                                                                                                    | Mặc định    | Ví dụ                                                                                       | Nhận xét                                                                                                                                                                                                                                                                                                                                                                                          |
-| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `fill`                      | Điều khiển cách các tệp đầu ra auto-fill (bản dịch bằng AI) được tạo ra.                                                                                   | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true`      | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: Đường dẫn mặc định (cùng tệp với nguồn).<br/>• `false`: Vô hiệu hóa.<br/>• Template string/Hàm bật tạo tệp theo từng locale.<br/>• Đối tượng theo từng locale: Mỗi locale khớp với template của riêng nó; `false` loại bỏ locale đó.<br/>• Việc bao gồm `{{locale}}` bật tạo tệp theo từng locale.<br/>• Cài đặt `fill` ở cấp độ dictionary luôn được ưu tiên hơn cài đặt toàn cầu này. |
-| `description`               | Giúp editor và CMS hiểu được mục đích của dictionary. Cũng được sử dụng làm ngữ cảnh để tạo các bản dịch bằng AI.                                          | `string`                                                                                                        | `undefined` | `'User profile section'`                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                   |
-| `locale`                    | Chuyển đổi dictionary thành định dạng cho một locale cụ thể. Mỗi trường đã khai báo trở thành một nút dịch. Nếu thiếu, dictionary được coi là đa ngôn ngữ. | `LocalesValues`                                                                                                 | `undefined` | `'en'`                                                                                      | Sử dụng tính năng này nếu dictionary dành cho một locale cụ thể thay vì chứa các bản dịch đa ngôn ngữ.                                                                                                                                                                                                                                                                                            |
-| `contentAutoTransformation` | Liệu có tự động chuyển đổi các chuỗi nội dung thành các nút có kiểu (Markdown, HTML hoặc chèn biến).                                                       | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`     | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')` .<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')` .<br/>• Chèn biến : `Hello {{name}}` → `insert('Hello {{name}}')` .                                                                                                                                                                                                                   |
-| `location`                  | Chỉ ra nơi lưu trữ các tệp dictionary và cách chúng được đồng bộ hóa với CMS.                                                                              | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`   | `'hybrid'`                                                                                  | • `'local'`: Chỉ quản lý cục bộ.<br/>• `'remote'`: Chỉ quản lý từ xa (CMS).<br/>• `'hybrid'`: Cả quản lý cục bộ và từ xa.<br/>• `'plugin'` hoặc các chuỗi tùy chỉnh: Quản lý thông qua plugin hoặc nguồn tùy chỉnh.                                                                                                                                                                               |
-| `importMode`                | Kiểm soát cách các dictionary được import.                                                                                                                 | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`  | `'dynamic'`                                                                                 | • `'static'`: Import tĩnh.<br/>• `'dynamic'`: Import động thông qua Suspense.<br/>• `'fetch'`: Lấy dữ liệu thông qua Live Sync API; dự phòng về `'dynamic'` nếu thất bại.<br/>• Yêu cầu các plugin `@intlayer/babel` và `@intlayer/swc`.<br/>• Các khóa (keys) phải được khai báo tĩnh.<br/>• Bị bỏ qua nếu `optimize` tắt.<br/>• Không ảnh hưởng đến `getIntlayer`, `getDictionary`, v.v.        |
-| `priority`                  | Độ ưu tiên của dictionary. Khi giải quyết xung đột giữa các dictionary, giá trị cao hơn sẽ giành chiến thắng trước các giá trị thấp hơn.                   | `number`                                                                                                        | `undefined` | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                   |
-| `live`                      | ĐÃ LỖI THỜI - sử dụng `importMode: 'fetch'`. Từng biểu thị nội dung dictionary có nên được lấy dữ liệu động thông qua Live Sync API hay không.             | `boolean`                                                                                                       | `undefined` |                                                                                             | Được đổi tên thành `importMode: 'fetch'` trong v8.0.0.                                                                                                                                                                                                                                                                                                                                            |
-| `schema`                    | Được tạo tự động bởi Intlayer để xác thực JSON schema.                                                                                                     | `'https://intlayer.org/schema.json'`                                                                            | Tự động tạo |                                                                                             | Không chỉnh sửa thủ công.                                                                                                                                                                                                                                                                                                                                                                         |
-| `title`                     | Giúp xác định các dictionary trong editor và CMS.                                                                                                          | `string`                                                                                                        | `undefined` | `'User Profile'`                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                   |
-| `tags`                      | Phân loại các dictionary và cung cấp ngữ cảnh hoặc hướng dẫn cho editor và AI.                                                                             | `string[]`                                                                                                      | `undefined` | `['user', 'profile']`                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                   |
-| `version`                   | Phiên bản của dictionary từ xa; giúp theo dõi phiên bản hiện đang được sử dụng.                                                                            | `string`                                                                                                        | `undefined` | `'1.0.0'`                                                                                   | • Được quản lý trong CMS.<br/>• Đừng chỉnh sửa cục bộ.                                                                                                                                                                                                                                                                                                                                            |
+| Trường                      | Mô tả                                                                                                                                                      | Kiểu dữ liệu                                                                                                    | Mặc định     | Ví dụ                                                                                       | Nhận xét                                                                                                                                                                                                                                                                                                                                                                                          |
+| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `fill`                      | Điều khiển cách các tệp đầu ra auto-fill (bản dịch bằng AI) được tạo ra.                                                                                   | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true`       | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: Đường dẫn mặc định (cùng tệp với nguồn).<br/>• `false`: Vô hiệu hóa.<br/>• Template string/Hàm bật tạo tệp theo từng locale.<br/>• Đối tượng theo từng locale: Mỗi locale khớp với template của riêng nó; `false` loại bỏ locale đó.<br/>• Việc bao gồm `{{locale}}` bật tạo tệp theo từng locale.<br/>• Cài đặt `fill` ở cấp độ dictionary luôn được ưu tiên hơn cài đặt toàn cầu này. |
+| `description`               | Giúp editor và CMS hiểu được mục đích của dictionary. Cũng được sử dụng làm ngữ cảnh để tạo các bản dịch bằng AI.                                          | `string`                                                                                                        | `undefined`  | `'User profile section'`                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `locale`                    | Chuyển đổi dictionary thành định dạng cho một locale cụ thể. Mỗi trường đã khai báo trở thành một nút dịch. Nếu thiếu, dictionary được coi là đa ngôn ngữ. | `LocalesValues`                                                                                                 | `undefined`  | `'en'`                                                                                      | Sử dụng tính năng này nếu dictionary dành cho một locale cụ thể thay vì chứa các bản dịch đa ngôn ngữ.                                                                                                                                                                                                                                                                                            |
+| `contentAutoTransformation` | Liệu có tự động chuyển đổi các chuỗi nội dung thành các nút có kiểu (Markdown, HTML hoặc chèn biến).                                                       | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`      | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')` .<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')` .<br/>• Chèn biến : `Hello {{name}}` → `insert('Hello {{name}}')` .                                                                                                                                                                                                                   |
+| `location`                  | Chỉ ra nơi lưu trữ các tệp dictionary và cách chúng được đồng bộ hóa với CMS.                                                                              | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`    | `'hybrid'`                                                                                  | • `'local'`: Chỉ quản lý cục bộ.<br/>• `'remote'`: Chỉ quản lý từ xa (CMS).<br/>• `'hybrid'`: Cả quản lý cục bộ và từ xa.<br/>• `'plugin'` hoặc các chuỗi tùy chỉnh: Quản lý thông qua plugin hoặc nguồn tùy chỉnh.                                                                                                                                                                               |
+| `importMode`                | Kiểm soát cách các dictionary được import.                                                                                                                 | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`   | `'dynamic'`                                                                                 | • `'static'`: Import tĩnh.<br/>• `'dynamic'`: Import động thông qua Suspense.<br/>• `'fetch'`: Lấy dữ liệu thông qua Live Sync API; dự phòng về `'dynamic'` nếu thất bại.<br/>• Yêu cầu các plugin `@intlayer/babel` và `@intlayer/swc`.<br/>• Các khóa (keys) phải được khai báo tĩnh.<br/>• Bị bỏ qua nếu `optimize` tắt.<br/>• Không ảnh hưởng đến `getIntlayer`, `getDictionary`, v.v.        |
+| `format`                    | Định dạng tin nhắn mặc định cho tất cả các từ điển trong dự án.                                                                                            | `'intlayer'` &#124; <br/> `'icu'` &#124; <br/> `'i18next'` &#124; <br/> `'vue-i18n'` &#124; <br/> `'po'`        | `'intlayer'` | `'icu'`                                                                                     | • `'intlayer'`: Định dạng intlayer gốc.<br/>• `'icu'`: Định dạng tin nhắn ICU.<br/>• `'i18next'`: Định dạng i18next.<br/>• `'vue-i18n'`: Định dạng Vue I18n.<br/>• `'po'`: Định dạng GNU Gettext PO.                                                                                                                                                                                              |
+| `priority`                  | Độ ưu tiên của dictionary. Khi giải quyết xung đột giữa các dictionary, giá trị cao hơn sẽ giành chiến thắng trước các giá trị thấp hơn.                   | `number`                                                                                                        | `undefined`  | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `live`                      | ĐÃ LỖI THỜI - sử dụng `importMode: 'fetch'`. Từng biểu thị nội dung dictionary có nên được lấy dữ liệu động thông qua Live Sync API hay không.             | `boolean`                                                                                                       | `undefined`  |                                                                                             | Được đổi tên thành `importMode: 'fetch'` trong v8.0.0.                                                                                                                                                                                                                                                                                                                                            |
+| `schema`                    | Được tạo tự động bởi Intlayer để xác thực JSON schema.                                                                                                     | `'https://intlayer.org/schema.json'`                                                                            | Tự động tạo  |                                                                                             | Không chỉnh sửa thủ công.                                                                                                                                                                                                                                                                                                                                                                         |
+| `title`                     | Giúp xác định các dictionary trong editor và CMS.                                                                                                          | `string`                                                                                                        | `undefined`  | `'User Profile'`                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `tags`                      | Phân loại các dictionary và cung cấp ngữ cảnh hoặc hướng dẫn cho editor và AI.                                                                             | `string[]`                                                                                                      | `undefined`  | `['user', 'profile']`                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `version`                   | Phiên bản của dictionary từ xa; giúp theo dõi phiên bản hiện đang được sử dụng.                                                                            | `string`                                                                                                        | `undefined`  | `'1.0.0'`                                                                                   | • Được quản lý trong CMS.<br/>• Đừng chỉnh sửa cục bộ.                                                                                                                                                                                                                                                                                                                                            |
 
 **Ví dụ về `fill`**:
 
@@ -957,22 +1008,6 @@ Các tùy chọn build được áp dụng cho các plugin `@intlayer/babel` và
 
 ---
 
-### Cấu hình Hệ thống (System)
-
-Các cài đặt này dành cho người dùng nâng cao và dành cho cấu hình nội bộ của Intlayer.
-
-| Trường                    | Mô tả                                              | Kiểu dữ liệu | Mặc định                          | Ví dụ | Nhận xét |
-| ------------------------- | -------------------------------------------------- | ------------ | --------------------------------- | ----- | -------- |
-| `dictionariesDir`         | Thư mục chứa các dictionary đã biên dịch.          | `string`     | `'.intlayer/dictionary'`          |       |          |
-| `moduleAugmentationDir`   | Thư mục chứa module augmentation TypeScript.       | `string`     | `'.intlayer/types'`               |       |          |
-| `unmergedDictionariesDir` | Thư mục lưu trữ các dictionary chưa được hợp nhất. | `string`     | `'.intlayer/unmerged_dictionary'` |       |          |
-| `typesDir`                | Thư mục chứa các kiểu dữ liệu đã tạo.              | `string`     | `'.intlayer/types'`               |       |          |
-| `mainDir`                 | Thư mục chứa các tệp chính của Intlayer.           | `string`     | `'.intlayer/main'`                |       |          |
-| `configDir`               | Thư mục chứa các tệp cấu hình đã được biên dịch.   | `string`     | `'.intlayer/config'`              |       |          |
-| `cacheDir`                | Thư mục chứa các tệp cache.                        | `string`     | `'.intlayer/cache'`               |       |          |
-
----
-
 ### Cấu hình Compiler (Compiler)
 
 Trình kiểm soát trình biên dịch Intlayer, thu thập các bộ từ điển trực tiếp từ các component của bạn.

package/docs/vi/custom_domains.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-02
-updatedAt: 2026-04-02
+updatedAt: 2026-06-23
 title: Tên miền tùy chỉnh
 description: Tìm hiểu cách cấu hình điều hướng ngôn ngữ dựa trên tên miền trong Intlayer để phục vụ các ngôn ngữ khác nhau từ các tên miền riêng biệt.
 keywords:
@@ -172,10 +172,16 @@ Plugin Vite `intlayerProxy` áp dụng logic tương tự trong quá trình phá
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```