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

package/docs/vi/intlayer_with_vite+vanilla.md

@@ -205,7 +205,13 @@ import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayer()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -466,12 +472,15 @@ document.querySelector<HTMLDivElement>(".edit-note")!.innerHTML =
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // nên đặt đầu tiên
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -603,6 +612,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Trình biên dịch Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Cập nhật `vite.config.ts` của bạn để bao gồm plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -612,7 +623,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Thêm plugin trình biên dịch
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/vi/intlayer_with_vite+vue.md

@@ -633,14 +633,17 @@ Song song đó, bạn cũng có thể sử dụng `intlayerProxy` để thêm ro
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
     vue(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -965,6 +968,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Trình biên dịch Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Cập nhật `vite.config.ts` của bạn để bao gồm plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -974,7 +979,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Thêm plugin trình biên dịch
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/vi/packages/@intlayer_babel/export.md

@@ -0,0 +1,131 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: "Tài liệu Gói @intlayer/babel"
+description: Các plugin Babel cho Intlayer để xử lý trích xuất nội dung, tối ưu hóa nhập khẩu (import), loại bỏ các trường không sử dụng và mã hóa tên trường trong quá trình xây dựng (build).
+keywords:
+  - "@intlayer/babel"
+  - babel
+  - plugin
+  - đa ngôn ngữ
+  - i18n
+  - trình biên dịch
+  - tối ưu hóa
+  - loại bỏ
+  - thu nhỏ
+slugs:
+  - doc
+  - packages
+  - "@intlayer/babel"
+  - export
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Hợp nhất tài liệu cho tất cả các xuất khẩu (exports)"
+author: aymericzip
+---
+
+# Gói @intlayer/babel
+
+Gói `@intlayer/babel` cung cấp một tập hợp các plugin Babel chuyên dụng cho Intlayer. Các plugin này bao gồm toàn bộ chu kỳ xây dựng: trích xuất các khai báo nội dung, viết lại các lệnh gọi `useIntlayer` / `getIntlayer` thành các lệnh nhập từ điển được tối ưu hóa, cắt bỏ các trường không sử dụng và nén tên trường.
+
+## Cài đặt
+
+```bash
+npm install @intlayer/babel
+```
+
+## Xuất khẩu (Exports)
+
+Nhập khẩu (Import):
+
+```ts
+import { ... } from "@intlayer/babel";
+```
+
+---
+
+### Plugins
+
+| Hàm / Lớp                      | Mô tả                                                                                                                                                                                              |
+| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `intlayerExtractBabelPlugin`   | Plugin Babel trích xuất nội dung có thể dịch từ các tệp nguồn và tự động chèn các hook `useIntlayer` / `getIntlayer`. Được thiết kế để sử dụng với Next.js và các công cụ xây dựng dựa trên Babel. |
+| `intlayerOptimizeBabelPlugin`  | Plugin Babel chuyển đổi các lệnh gọi `useIntlayer` và `getIntlayer` và viết lại các lệnh nhập của chúng thành các lệnh nhập từ điển JSON được tối ưu hóa (tĩnh, động hoặc qua fetch).              |
+| `intlayerPurgeBabelPlugin`     | Plugin Babel phân tích các tệp nguồn và viết lại các tệp JSON từ điển đã biên dịch để loại bỏ các trường không sử dụng (`build.purge`) hoặc đổi tên chúng thành các bí danh ngắn (`build.minify`). |
+| `intlayerMinifyBabelPlugin`    | Plugin Babel viết lại các tệp nguồn để sử dụng các bí danh trường ngắn được chỉ định trong giai đoạn thu nhỏ (ví dụ: `content.title` ← `content.a`). Dựa vào `intlayerPurgeBabelPlugin`.           |
+| `makeFieldRenameBabelPlugin`   | Hàm tạo (factory) tạo ra một plugin Babel để đổi tên các truy cập trường nội dung từ điển trong các tệp nguồn theo `dictionaryKeyToFieldRenameMap` được điền trong `PruneContext`.                 |
+| `makeUsageAnalyzerBabelPlugin` | Hàm tạo tạo ra một plugin Babel để phân tích việc sử dụng `useIntlayer` / `getIntlayer` trong mã nguồn và tổng hợp dữ liệu sử dụng trường trong `PruneContext` chung.                              |
+| `getSharedPruneContext`        | Hàm trợ giúp trả về đối tượng `PruneContext` chung cho thư mục gốc đã chỉ định hoặc `null` nếu nó chưa được khởi tạo.                                                                              |
+
+---
+
+### Tiện ích cấu hình plugin
+
+| Hàm                        | Mô tả                                                                                                                                           |
+| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| `getExtractPluginOptions`  | Tải cấu hình Intlayer và trả về `ExtractPluginOptions` sẵn sàng sử dụng với `intlayerExtractBabelPlugin`.                                       |
+| `getOptimizePluginOptions` | Tải cấu hình Intlayer và các từ điển đã biên dịch, đồng thời trả về `OptimizePluginOptions` sẵn sàng sử dụng với `intlayerOptimizeBabelPlugin`. |
+| `getPurgePluginOptions`    | Tải cấu hình Intlayer và trả về `PurgePluginOptions` sẵn sàng sử dụng với `intlayerPurgeBabelPlugin`.                                           |
+| `getMinifyPluginOptions`   | Tải cấu hình Intlayer và trả về `MinifyPluginOptions` sẵn sàng sử dụng với `intlayerMinifyBabelPlugin`.                                         |
+
+---
+
+### Kiểu dữ liệu
+
+| Kiểu dữ liệu            | Mô tả                                                                                                                         |
+| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| `CompilerMode`          | Chế độ trình biên dịch: `'dev'` để phát triển với hỗ trợ HMR hoặc `'build'` cho các bản dựng production.                      |
+| `ExtractPluginOptions`  | Tùy chọn cho `intlayerExtractBabelPlugin`: danh sách tệp, cấu hình, callback `onExtract`, v.v.                                |
+| `ExtractResult`         | Kết quả trích xuất: khóa từ điển, đường dẫn tệp, nội dung và ngôn ngữ.                                                        |
+| `OptimizePluginOptions` | Tùy chọn cho `intlayerOptimizeBabelPlugin`: đường dẫn từ điển, chế độ nhập, bản đồ chế độ cho mỗi từ điển, v.v.               |
+| `PurgePluginOptions`    | Tùy chọn cho `intlayerPurgeBabelPlugin`: thư mục gốc, cờ purge/minify/optimize, danh sách tệp component.                      |
+| `MinifyPluginOptions`   | Tùy chọn cho `intlayerMinifyBabelPlugin`: thư mục gốc, cờ thu nhỏ/tối ưu hóa/editorEnabled.                                   |
+| `PruneContext`          | Trạng thái chia sẻ giữa các phân tích và các plugin cắt bỏ: bản đồ sử dụng trường, bản đồ đổi tên, v.v.                       |
+| `DictionaryFieldUsage`  | Kết quả sử dụng trường cho một từ điển duy nhất: `Set<string>` hoặc `'all'` khi phân tích tĩnh không đưa ra kết quả kết luận. |
+| `NestedRenameEntry`     | Một nút trong cây đổi tên: `shortName` và bản đồ các con.                                                                     |
+| `NestedRenameMap`       | Một cấp độ trong cây đổi tên: `Map<string, NestedRenameEntry>`.                                                               |
+| `CompatCallerConfig`    | Cấu hình cho bộ phân tích sử dụng tương thích cho các gói `compat-adapter` (tên người gọi và các tùy chọn xử lý).             |
+| `ScriptBlock`           | Khối script được trích xuất từ tệp SFC (Vue hoặc Svelte): nội dung, độ lệch bắt đầu và kết thúc.                              |
+
+---
+
+### Các hàm tiện ích
+
+| Hàm                               | Mô tả                                                                                                                                                         |
+| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `generateShortFieldName`          | Chuyển đổi một số nguyên (bắt đầu từ số không) thành mã định danh chữ cái ngắn: `0` → `'a'`, `25` → `'z'`, `26` → `'aa'`, v.v.                                |
+| `buildNestedRenameMapFromContent` | Xây dựng đệ quy một `NestedRenameMap` từ giá trị nội dung của một từ điển đã biên dịch, tôn trọng các cấu trúc nút Intlayer (translation, enumeration, v.v.). |
+| `createPruneContext`              | Tạo một đối tượng `PruneContext` trống mới được khởi tạo với các giá trị mặc định.                                                                            |
+| `extractScriptBlocks`             | Trích xuất các khối `<script>` từ các tệp SFC (Vue / Svelte) để phân tích Babel tiếp theo.                                                                    |
+| `BABEL_PARSER_OPTIONS`            | Hằng số đại diện cho các tùy chọn phân tích cú pháp Babel bao gồm các framework được hỗ trợ (React/Vue/Svelte/Angular/...).                                   |
+| `INTLAYER_CALLER_NAMES`           | Danh sách hằng số gồm các tên người gọi Intlayer ban đầu: `['useIntlayer', 'getIntlayer']`.                                                                   |
+
+---
+
+## Ví dụ sử dụng
+
+```js
+// babel.config.js
+const {
+  intlayerExtractBabelPlugin,
+  intlayerPurgeBabelPlugin,
+  intlayerMinifyBabelPlugin,
+  intlayerOptimizeBabelPlugin,
+  getExtractPluginOptions,
+  getPurgePluginOptions,
+  getMinifyPluginOptions,
+  getOptimizePluginOptions,
+} = require("@intlayer/babel");
+
+module.exports = {
+  presets: ["next/babel"],
+  plugins: [
+    [intlayerExtractBabelPlugin, getExtractPluginOptions()],
+    [intlayerPurgeBabelPlugin, getPurgePluginOptions()],
+    [intlayerMinifyBabelPlugin, getMinifyPluginOptions()],
+    [intlayerOptimizeBabelPlugin, getOptimizePluginOptions()],
+  ],
+};
+```
+
+> **Lưu ý:** Plugin `intlayerPurgeBabelPlugin` phải được khai báo **trước** `intlayerMinifyBabelPlugin`, vì plugin sau đọc bản đồ đổi tên được xây dựng bởi plugin trước. Ngoài ra, cả hai đều phải đứng sau `intlayerOptimizeBabelPlugin` để nó có thể nhìn thấy các khóa từ điển trước khi các lệnh gọi `useIntlayer` được viết lại.

package/docs/vi/packages/react-native-intlayer/exports.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-06-25
 title: Tài liệu gói react-native-intlayer
-description: Hỗ trợ React Native cho Intlayer, cung cấp provider và các polyfill.
+description: Hỗ trợ React Native cho Intlayer, cung cấp provider, hook, polyfill và cấu hình Metro.
 keywords:
   - react-native-intlayer
   - react-native
@@ -14,6 +14,9 @@ slugs:
   - react-native-intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Tái xuất toàn bộ API react-intlayer (hook, tiện ích, các subpath format/html/markdown) để ứng dụng React Native chỉ cần phụ thuộc vào react-native-intlayer"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Hợp nhất tài liệu cho tất cả các exports"
@@ -22,7 +25,9 @@ author: aymericzip
 
 # Gói react-native-intlayer
 
-Gói `react-native-intlayer` cung cấp các công cụ cần thiết để tích hợp Intlayer vào các ứng dụng React Native. Nó bao gồm một provider và các polyfill để hỗ trợ locale.
+Gói `react-native-intlayer` cung cấp các công cụ cần thiết để tích hợp Intlayer vào các ứng dụng React Native. Nó tái xuất toàn bộ API `react-intlayer` (hook và tiện ích) với `IntlayerProvider` sẵn sàng cho React Native, cùng các polyfill và cấu hình Metro mà React Native yêu cầu.
+
+> Trong một ứng dụng React Native, hãy nhập **tất cả mọi thứ** từ `react-native-intlayer`. Bạn không cần cài đặt hoặc nhập `react-intlayer` trực tiếp.
 
 ## Cài đặt
 
@@ -34,14 +39,30 @@ npm install react-native-intlayer
 
 ### Provider
 
-| Thành phần         | Mô tả                                                                     |
-| ------------------ | ------------------------------------------------------------------------- |
-| `IntlayerProvider` | Component Provider bọc ứng dụng của bạn và cung cấp context của Intlayer. |
+| Thành phần         | Mô tả                                                                                                             |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------- |
+| `IntlayerProvider` | Component Provider bọc ứng dụng của bạn và cung cấp context của Intlayer. Tự động áp dụng các polyfill cần thiết. |
+
+```tsx
+import { IntlayerProvider } from "react-native-intlayer";
+```
+
+### Hook và tiện ích
+
+Các mục này được tái xuất từ `react-intlayer`, vì vậy bạn có thể nhập chúng trực tiếp từ `react-native-intlayer`:
 
-Nhập:
+| Export                                                                                                            | Mô tả                                                  |
+| ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
+| `useIntlayer`                                                                                                     | Truy cập nội dung đã bản địa hóa cho một khóa từ điển. |
+| `useLocale`                                                                                                       | Đọc và thay đổi locale hiện tại.                       |
+| `useDictionary`, `useDictionaryAsync`, `useDictionaryDynamic`, `useLoadDynamic`                                   | Tải nội dung từ điển theo nhiều cách khác nhau.        |
+| `useI18n`                                                                                                         | Hook tương thích với i18next.                          |
+| `t`                                                                                                               | Trợ lý dịch inline.                                    |
+| `getIntlayer`, `getDictionary`                                                                                    | Các hàm lấy nội dung theo kiểu mệnh lệnh.              |
+| `localeCookie`, `localeInStorage`, `setLocaleCookie`, `setLocaleInStorage`, `useLocaleCookie`, `useLocaleStorage` | Các trợ lý lưu trữ locale.                             |
 
 ```tsx
-import "react-native-intlayer";
+import { useIntlayer, useLocale, t } from "react-native-intlayer";
 ```
 
 ### Polyfill
@@ -50,10 +71,25 @@ import "react-native-intlayer";
 | ------------------ | ----------------------------------------------------------------------- |
 | `intlayerPolyfill` | Hàm áp dụng các polyfill cần thiết cho React Native để hỗ trợ Intlayer. |
 
-Nhập:
+```tsx
+import { intlayerPolyfill } from "react-native-intlayer";
+```
+
+> Polyfill được áp dụng tự động khi bạn nhập `IntlayerProvider`. Chỉ gọi `intlayerPolyfill` thủ công nếu bạn cần các polyfill trước khi provider được mount.
+
+### Bộ định dạng (Formatters)
+
+Các hook định dạng số, ngày tháng và các hook dựa trên Intl khác có sẵn từ subpath `/format`:
+
+```tsx
+import { useNumber, useDate } from "react-native-intlayer/format";
+```
+
+### Markdown và HTML
 
 ```tsx
-import "react-native-intlayer";
+import { MarkdownProvider } from "react-native-intlayer/markdown";
+import { HTMLProvider } from "react-native-intlayer/html";
 ```
 
 ### Cấu hình Metro
@@ -66,8 +102,6 @@ Gói `react-native-intlayer` cung cấp các tiện ích cấu hình Metro để
 | `configMetroIntlayerSync` | Hàm đồng bộ hợp nhất cấu hình Metro mà không chuẩn bị tài nguyên của Intlayer.             |
 | `exclusionList`           | Tạo một biểu thức RegExp cho blockList của Metro để loại trừ các tệp nội dung khỏi bundle. |
 
-Import:
-
 ```tsx
-import "react-native-intlayer/metro";
+import { configMetroIntlayer } from "react-native-intlayer/metro";
 ```

package/docs/vi/packages/vite-intlayer/intlayerCompiler.md

@@ -0,0 +1,120 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Tài liệu Plugin Vite intlayerCompiler | vite-intlayer
+description: Plugin Vite giúp trích xuất các khai báo nội dung Intlayer trực tiếp (inline) từ các tệp component và ghi chúng vào các tệp JSON từ điển tại thời điểm build/transform.
+keywords:
+  - intlayerCompiler
+  - vite
+  - plugin
+  - trình biên dịch
+  - nội dung
+  - từ điển
+  - đa ngôn ngữ
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerCompiler
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Đã tích hợp vào intlayer(); khởi tạo tài liệu"
+author: aymericzip
+---
+
+# intlayerCompiler
+
+`intlayerCompiler` là một plugin Vite quét các tệp nguồn component để tìm **các khai báo nội dung Intlayer trực tiếp (inline)** — nội dung được định nghĩa trực tiếp bên trong một component thay vì trong một tệp `.content.ts` riêng biệt — và ghi chúng vào các tệp JSON từ điển trong giai đoạn transform (chuyển đổi).
+
+> **Từ phiên bản Intlayer v9**, `intlayerCompiler` được tự động bao gồm bên trong plugin chính [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/vite-intlayer/intlayer.md) khi cả hai cấu hình `compiler.enabled` là `true` và `compiler.output` được thiết lập trong cấu hình Intlayer của bạn. Bạn chỉ cần đăng ký riêng khi muốn kiểm soát hoàn toàn cấu hình dành riêng cho trình biên dịch.
+
+## Cách sử dụng
+
+### Như một phần của `intlayer()` (khuyên dùng, v9+)
+
+Bật trình biên dịch thông qua cấu hình Intlayer của bạn:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  compiler: {
+    enabled: true,
+    output: "./src/dictionaries", // nơi ghi các từ điển đã được trích xuất
+  },
+});
+```
+
+Sau đó sử dụng plugin tiêu chuẩn mà không cần đăng ký thêm:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### Độc lập (khi cần thiết)
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayerCompiler()],
+});
+```
+
+## Các tùy chọn
+
+```ts
+import type { IntlayerCompilerOptions } from "vite-intlayer";
+```
+
+| Tùy chọn         | Kiểu dữ liệu              | Mô tả                                                                                                  |
+| ---------------- | ------------------------- | ------------------------------------------------------------------------------------------------------ |
+| `configOptions`  | `GetConfigurationOptions` | Các giá trị ghi đè cấu hình Intlayer được chuyển tiếp đến `getConfiguration()`.                        |
+| `compilerConfig` | `Partial<CompilerConfig>` | Các ghi đè cho phần cấu hình dành riêng cho trình biên dịch (ví dụ: `enabled`, `output`, `filesList`). |
+
+### Ví dụ
+
+```ts
+intlayerCompiler({
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+  compilerConfig: { enabled: true, output: "./src/dictionaries" },
+});
+```
+
+## Cách thức hoạt động
+
+### Giai đoạn Transform (Chuyển đổi)
+
+Đối với mỗi tệp nguồn khớp với `compiler.filesList`, plugin trình biên dịch sẽ:
+
+1. Chuyển nội dung tệp qua hàm `extractContent` từ thư viện `@intlayer/babel`.
+2. Gọi hàm `onExtract` cho mỗi khai báo được tìm thấy, thao tác này sẽ ghi JSON từ điển kết quả vào đường dẫn `compiler.output`.
+3. Trả về mã nguồn đã chuyển đổi với các khai báo inline được thay thế bằng các lệnh gọi tiêu chuẩn `useIntlayer('key')` / `getIntlayer('key')`.
+
+Các loại tệp được hỗ trợ: `.ts`, `.tsx`, `.js`, `.jsx`, `.vue`, `.svelte`, `.astro`.
+
+### HMR (Hot Module Replacement - Thay thế mô-đun nóng)
+
+Khi một tệp component được lưu ở chế độ phát triển (development mode), trình biên dịch sẽ:
+
+1. Phát hiện tệp thay đổi thông qua hook `handleHotUpdate` của Vite.
+2. Trích xuất lại nội dung từ tệp đã cập nhật.
+3. Ghi tệp JSON từ điển đã cập nhật.
+4. Kích hoạt tải lại toàn bộ trang (`server.ws.send({ type: 'full-reload' })`).
+
+Một khoảng thời gian debounce (chống rung) 500 ms ngăn việc ghi từ điển (cũng kích hoạt sự kiện thay đổi tệp) tạo ra một vòng lặp trích xuất vô hạn.
+
+### Khử trùng lặp (Deduplication)
+
+`intlayerCompiler` sử dụng cùng một cơ chế khử trùng lặp `createPrimaryInstanceGuard` giống như các plugin đi kèm khác. Khi cả `intlayer()` (gộp cả trình biên dịch) và lệnh gọi `intlayerCompiler()` thủ công đều xuất hiện, chỉ có phiên bản đã đăng ký đầu tiên chạy — không có từ điển nào bị ghi đè hai lần.

package/docs/vi/packages/vite-intlayer/intlayerMinify.md

@@ -0,0 +1,92 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Tài liệu Plugin Vite intlayerMinify | vite-intlayer
+description: Plugin Vite giúp nén (minify) các tệp JSON từ điển Intlayer đã biên dịch và tùy chọn mã hóa các tên trường nội dung để giảm kích thước gói bundle.
+keywords:
+  - intlayerMinify
+  - vite
+  - plugin
+  - nén
+  - kích thước bundle
+  - từ điển
+  - đa ngôn ngữ
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerMinify
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Khởi tạo tài liệu"
+author: aymericzip
+---
+
+# intlayerMinify
+
+`intlayerMinify` là một plugin Vite nén các tệp JSON từ điển đã biên dịch trong quá trình build production. Nó loại bỏ tất cả khoảng trắng không cần thiết và khi kết hợp với `intlayerPrune`, có thể tùy chọn đổi tên các trường nội dung thành các bí danh ngắn (`a`, `b`, `c`, …) để giảm thiểu hơn nữa kích thước gói bundle.
+
+> Plugin này đã được tích hợp và cấu hình tự động khi bạn sử dụng [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/vite-intlayer/intlayer.md). Bạn chỉ cần tự đăng ký thủ công nếu đang tự thiết lập cấu trúc plugin của riêng mình.
+
+## Cách sử dụng
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerMinify, intlayerPrune } from "vite-intlayer";
+import { createPruneContext } from "@intlayer/babel";
+
+const pruneContext = createPruneContext();
+
+export default defineConfig({
+  plugins: [
+    intlayerPrune(intlayerConfig, pruneContext),
+    intlayerMinify(intlayerConfig, pruneContext),
+  ],
+});
+```
+
+## Điều kiện kích hoạt
+
+`intlayerMinify` chỉ hoạt động **khi và chỉ khi** cả ba điều kiện sau đều đúng:
+
+1. Lệnh Vite chạy là `build` (không phải `serve` / dev).
+2. Tùy chọn `build.optimize` là `true` (hoặc `undefined`, mặc định sẽ là `true` đối với tiến trình build).
+3. Tùy chọn `build.minify` được đặt là `true` trong cấu hình Intlayer của bạn.
+
+Nó tự động bị **vô hiệu hóa** khi `editor.enabled` là `true` vì editor cần nội dung từ điển đầy đủ và thân thiện với người đọc.
+
+## Những gì được nén
+
+Plugin nhắm vào hai vị trí từ điển (được phân giải từ `intlayer.system`):
+
+- `dictionariesDir` — các từ điển tĩnh cho tất cả các locale (ví dụ: `.intlayer/dictionaries/*.json`)
+- `dynamicDictionariesDir` — các từ điển động cho mỗi locale
+
+> Các từ điển sử dụng chế độ fetch (`fetchDictionariesDir`) sẽ **không bao giờ** bị nén vì chúng được cung cấp từ một API từ xa tại thời điểm chạy bằng cách sử dụng các tên trường gốc. Việc đổi tên các trường sẽ tạo ra sự không khớp giữa phản hồi của máy chủ và các thuộc tính được truy cập phía client.
+
+## Mã hóa tên trường (Thu nhỏ thuộc tính)
+
+Khi `intlayerPrune` đã phân tích mã nguồn và cập nhật dữ liệu cho `pruneContext.dictionaryKeyToFieldRenameMap`, `intlayerMinify` cũng đổi tên các trường nội dung thành các bí danh ngắn. Ví dụ:
+
+```json
+// trước khi đổi
+{ "key": "myDict", "content": { "title": "Hello", "description": "World" } }
+
+// sau khi đổi (đã được mã hóa)
+{ "key": "myDict", "content": { "a": "Hello", "b": "World" } }
+```
+
+Các thuộc tính truy cập trong tệp nguồn tương ứng được đổi tên bằng bước xử lý Babel bên trong `intlayerOptimize`, do đó hành vi runtime không bị thay đổi.
+
+Các trường nội bộ của Intlayer (`nodeType`, `translation`, v.v.) không bao giờ bị đổi tên.
+
+## Các từ điển trường hợp đặc biệt (Edge-cases)
+
+Các từ điển được gắn cờ trong `pruneContext.dictionariesWithEdgeCases` (phát hiện bất thường về cấu trúc trong giai đoạn prune) sẽ được bỏ qua hoàn toàn — không nén hay mã hóa — để tránh gửi dữ liệu bị hỏng.
+
+## Nhóm đủ điều kiện (Bộ sưu tập / Biến thể / Bản ghi meta)
+
+Đối với các từ điển có mảng `qualifierTypes` (bộ sưu tập, biến thể và bản ghi meta), plugin giữ nguyên mảng `qualifierTypes` và bản đồ phụ `meta` một cách nguyên văn. Chỉ có các mục nhập `content` bị mã hóa tên trường. Các khóa phức hợp (được sử dụng để đối sánh bộ chọn tại thời điểm chạy) không bao giờ bị can thiệp.