@intlayer/docs 8.2.3 → 8.3.0-canary.0

package/docs/vi/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-02-25
+updatedAt: 2026-03-10
 title: Trình Biên Dịch Intlayer | Trích Xuất Nội Dung Tự Động cho i18n
 description: Tự động hóa quy trình quốc tế hóa của bạn với Trình Biên Dịch Intlayer. Trích xuất nội dung trực tiếp từ các component để i18n nhanh hơn và hiệu quả hơn trong Vite, Next.js và nhiều hơn nữa.
 keywords:
@@ -20,6 +20,9 @@ slugs:
   - doc
   - compiler
 history:
+  - version: 8.2.0
+    date: 2026-03-09
+    changes: Update compiler options, add FilePathPattern support
   - version: 8.1.7
     date: 2026-02-25
     changes: Cập nhật các tùy chọn trình biên dịch
@@ -157,13 +160,12 @@ import { type IntlayerConfig, Locales } from "intlayer";
 const config: IntlayerConfig = {
   compiler: {
     /**
-     * Chỉ định liệu trình biên dịch có nên được bật hay không.
      * Đặt thành 'build-only' để bỏ qua trình biên dịch trong quá trình phát triển và tăng tốc thời gian khởi động.
      */
     enabled: true,
 
     /**
-     * Mẫu để duyệt qua mã để tối ưu hóa.
+     * Pattern to traverse the code to optimize.
      */
     transformPattern: [
       "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
@@ -171,23 +173,28 @@ const config: IntlayerConfig = {
     ],
 
     /**
-     * Mẫu để loại trừ khỏi quá trình tối ưu hóa.
+     * Pattern to exclude from the optimization.
      */
     excludePattern: ["**/node_modules/**"],
 
     /**
-     * Thư mục đầu ra cho các từ điển đã được tối ưu hóa.
+     * Thư mục đầu ra cho các từ điển được tối ưu hóa.
      */
-    outputDir: "i18n",
+    output: ({ key }) => `compiler/${key}.content.json`,
 
     /**
-     * Tiền tố phím từ điển
+     * Chỉ chèn nội dung vào tệp đã tạo, không có khóa.
      */
-    dictionaryKeyPrefix: "", // Xóa tiền tố cơ sở
+    noMetadata: false,
 
     /**
-     * Chỉ định liệu các component có nên được lưu sau khi được chuyển đổi hay không.
-     * Bằng cách đó, trình biên dịch có thể được chạy chỉ một lần để chuyển đổi ứng dụng, sau đó có thể được gỡ bỏ.
+     * Tiền tố khóa từ điển
+     */
+    dictionaryKeyPrefix: "", // Remove base prefix
+
+    /**
+     * Cho biết liệu các thành phần có nên được lưu sau khi được chuyển đổi hay không.
+     * Bằng cách đó, trình biên dịch có thể được chạy một lần duy nhất để chuyển đổi ứng dụng, và sau đó nó có thể được gỡ bỏ.
      */
     saveComponents: false,
   },
@@ -209,3 +216,61 @@ npx intlayer fill         # Điền các bản dịch còn thiếu
 ```
 
 > Để biết thêm chi tiết, hãy tham khảo [tài liệu CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/ci.md)
+
+### Tham khảo cấu hình trình biên dịch
+
+Các thuộc tính sau có thể được cấu hình trong khối `compiler` của tệp `intlayer.config.ts` của bạn:
+
+- **enabled**:
+  - _Loại_: `boolean | 'build-only'`
+  - _Mặc định_: `true`
+  - _Mô tả_: Cho biết trình biên dịch có nên được bật hay không.
+- **dictionaryKeyPrefix**:
+  - _Loại_: `string`
+  - _Mặc định_: `'comp-'`
+  - _Mô tả_: Tiền tố cho các khóa từ điển được trích xuất.
+- **transformPattern**:
+  - _Loại_: `string | string[]`
+  - _Mặc định_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}', '!**/node_modules/**']`
+  - _Mô tả_: Các mẫu để duyệt mã để tối ưu hóa.
+- **excludePattern**:
+  - _Loại_: `string | string[]`
+  - _Mặc định_: `['**/node_modules/**']`
+  - _Mô tả_: Các mẫu để loại trừ khỏi quá trình tối ưu hóa.
+- **outputDir** (Deprecated):
+  - _Loại_: `string`
+  - _Mặc định_: `'compiler'`
+  - _Mô tả_: Thư mục nơi lưu trữ các từ điển được trích xuất.
+
+- **output**:
+  - _Loại_: `FilePathPattern`
+  - _Mặc định_: `({ key }) => 'compiler/${key}.content.json'`
+  - _Mô tả_: Xác định đường dẫn tệp đầu ra. Thay thế `outputDir`. Xử lý các biến động như `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}` và `{{componentFormat}}`. Có thể được đặt dưới dạng chuỗi bằng định dạng `'my/{{var}}/path'` hoặc dưới dạng hàm.
+  - _Ghi chú_: Các đường dẫn `./**/*` được giải quyết tương đối so với component. Các đường dẫn `/**/*` được giải quyết tương đối so với `baseDir` của Intlayer.
+  - _Ví dụ_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _Loại_: `boolean`
+  - _Mặc định_: `false`
+  - _Mô tả_: Cho biết liệu siêu dữ liệu có nên được lưu trong tệp hay không. Nếu true, trình biên dịch sẽ không lưu siêu dữ liệu của từ điển (khóa, trình bao bọc nội dung).
+  - _Ghi chú_: Hữu ích nếu được sử dụng với plugin `loadJSON`.
+  - _Ví dụ_: Nếu `true`:
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    Nếu `false`:
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```
+
+- **saveComponents**:
+  - _Loại_: `boolean`
+  - _Mặc định_: `false`
+  - _Mô tả_: Cho biết liệu các thành phần có nên được lưu sau khi được chuyển đổi hay không.

package/docs/vi/configuration.md

@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.2.0
+    date: 2026-03-09
+    changes: Update compiler options, add 'output' and 'noMetadata' support
   - version: 8.1.7
     date: 2026-02-25
     changes: Cập nhật các tùy chọn trình biên dịch
@@ -437,7 +440,7 @@ const config: IntlayerConfig = {
    */
   compiler: {
     /**
-     * Indicates if the compiler should be enabled.
+     * Cho biết trình biên dịch có nên được bật hay không.
      */
     enabled: true,
 
@@ -455,18 +458,23 @@ const config: IntlayerConfig = {
     excludePattern: ["**/node_modules/**"],
 
     /**
-     * Output directory for the optimized dictionaries.
+     * Thư mục đầu ra cho các từ điển được tối ưu hóa.
      */
-    outputDir: "compiler",
+    output: ({ key }) => `compiler/${key}.content.json`,
 
     /**
-     * Dictionary key prefix
+     * Chỉ chèn nội dung vào tệp đã tạo, không có khóa.
+     */
+    noMetadata: false,
+
+    /**
+     * Tiền tố khóa từ điển
      */
     dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * Indicates if the components should be saved after being transformed.
-     * That way, the compiler can be run only once to transform the app, and then it can be removed.
+     * Cho biết liệu các thành phần có nên được lưu sau khi được chuyển đổi hay không.
+     * Bằng cách đó, trình biên dịch có thể được chạy một lần duy nhất để chuyển đổi ứng dụng, và sau đó nó có thể được gỡ bỏ.
      */
     saveComponents: false,
   },
@@ -1073,7 +1081,7 @@ Các tùy chọn build áp dụng cho các plugin `@intlayer/babel` và `@intlay
   - _Lưu ý_: Đảm bảo tất cả các khóa được khai báo tĩnh trong các lệnh gọi `useIntlayer`. Ví dụ: `useIntlayer('navbar')`.
 
 - **importMode**:
-  - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
+  - _Ghi chú_: **Deprecated**: Use `dictionary.importMode` instead.
   - _Kiểu_: `'static' | 'dynamic' | 'fetch'`
   - _Mặc định_: `'static'`
   - _Mô tả_: Điều khiển cách các từ điển được nhập.
@@ -1091,10 +1099,10 @@ Các tùy chọn build áp dụng cho các plugin `@intlayer/babel` và `@intlay
   - _Lưu ý_: Chế độ live sẽ sử dụng live sync API để lấy các từ điển. Nếu cuộc gọi API thất bại, các từ điển sẽ được nhập động dưới dạng chế độ "dynamic".
   - _Lưu ý_: Tùy chọn này sẽ không ảnh hưởng đến các hàm `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` và `useDictionaryDynamic`.
 - **checkTypes**:
-  - _Type_: `boolean`
-  - _Default_: `false`
-  - _Description_: Cho biết liệu quá trình xây dựng có nên kiểm tra các kiểu TypeScript và ghi lại lỗi hay không.
-  - _Note_: Điều này có thể làm chậm quá trình xây dựng.
+  - _Loại_: `boolean`
+  - _Mặc định_: `false`
+  - _Mô tả_: Cho biết liệu quá trình xây dựng có nên kiểm tra các kiểu TypeScript và ghi lại lỗi hay không.
+  - _Ghi chú_: Điều này có thể làm chậm quá trình xây dựng.
 
 - **outputFormat**:
   - _Kiểu_: `'esm' | 'cjs'`
@@ -1157,3 +1165,31 @@ Các cài đặt kiểm soát trình biên dịch Intlayer, trình biên dịch
   - _Kiểu_: `string`
   - _Mặc định_: `'compiler'`
   - _Mô tả_: Thư mục nơi các từ điển trích xuất sẽ được lưu trữ, tương đối so với đường dẫn gốc dự án của bạn.
+
+- **output**:
+  - _Loại_: `FilePathPattern`
+  - _Mặc định_: `({ key }) => 'compiler/${key}.content.json'`
+  - _Mô tả_: Xác định đường dẫn tệp đầu ra. Thay thế `outputDir`. Xử lý các biến động như `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}` và `{{componentFormat}}`. Có thể được đặt dưới dạng chuỗi bằng định dạng `'my/{{var}}/path'` hoặc dưới dạng hàm.
+  - _Ghi chú_: Các đường dẫn `./**/*` được giải quyết tương đối so với component. Các đường dẫn `/**/*` được giải quyết tương đối so với `baseDir` của Intlayer.
+  - _Ví dụ_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _Loại_: `boolean`
+  - _Mặc định_: `false`
+  - _Mô tả_: Cho biết liệu siêu dữ liệu có nên được lưu trong tệp hay không. Nếu true, trình biên dịch sẽ không lưu siêu dữ liệu của từ điển (khóa, trình bao bọc nội dung).
+  - _Ghi chú_: Hữu ích nếu được sử dụng với plugin `loadJSON`.
+  - _Ví dụ_: Nếu `true`:
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    Nếu `false`:
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```

package/docs/vi/intlayer_with_nextjs_compiler.md

@@ -20,6 +20,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-next-no-lolale-path-template
 youtubeVideo: https://www.youtube.com/watch?v=e_PPG7PTqGU
 history:
+  - version: 8.2.0
+    date: 2026-03-09
+    changes: Update compiler options, add FilePathPattern support
   - version: 8.1.6
     date: 2026-02-23
     changes: Phiên bản đầu tiên
@@ -128,23 +131,28 @@ const config: IntlayerConfig = {
   },
   compiler: {
     /**
-     * Cho biết liệu trình biên dịch có nên được bật hay không.
+     * Cho biết trình biên dịch có nên được bật hay không.
      */
     enabled: true,
 
     /**
-     * Thư mục đầu ra cho các từ điển đã được tối ưu hóa.
+     * Thư mục đầu ra cho các từ điển được tối ưu hóa.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * Chỉ chèn nội dung vào tệp đã tạo, không có khóa.
+     */
+    noMetadata: false,
 
     /**
      * Tiền tố khóa từ điển
      */
-    dictionaryKeyPrefix: "", // Xóa tiền tố cơ bản
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * Cho biết liệu các thành phần có nên được lưu lại sau khi được biến đổi hay không.
-     * Bằng cách này, trình biên dịch có thể được chạy một lần để biến đổi ứng dụng, sau đó nó có thể được gỡ bỏ.
+     * Cho biết liệu các thành phần có nên được lưu sau khi được chuyển đổi hay không.
+     * Bằng cách đó, trình biên dịch có thể được chạy một lần duy nhất để chuyển đổi ứng dụng, và sau đó nó có thể được gỡ bỏ.
      */
     saveComponents: false,
   },

package/docs/vi/intlayer_with_vite+react_compiler.md

@@ -19,6 +19,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-vite-react-template
 youtubeVideo: https://www.youtube.com/watch?v=dS9L7uJeak4
 history:
+  - version: 8.2.0
+    date: 2026-03-09
+    changes: Update compiler options, add FilePathPattern support
   - version: 8.1.6
     date: 2026-02-23
     changes: Phát hành lần đầu
@@ -125,23 +128,28 @@ const config: IntlayerConfig = {
   },
   compiler: {
     /**
-     * Cho biết liệu trình biên dịch có nên được bật hay không.
+     * Cho biết trình biên dịch có nên được bật hay không.
      */
     enabled: true,
 
     /**
-     * Thư mục đầu ra cho các từ điển đã được tối ưu hóa.
+     * Thư mục đầu ra cho các từ điển được tối ưu hóa.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * Chỉ chèn nội dung vào tệp đã tạo, không có khóa.
+     */
+    noMetadata: false,
 
     /**
      * Tiền tố khóa từ điển
      */
-    dictionaryKeyPrefix: "", // Xóa tiền tố cơ bản
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * Cho biết liệu các thành phần có nên được lưu lại sau khi được biến đổi hay không.
-     * Bằng cách này, trình biên dịch có thể được chạy một lần để biến đổi ứng dụng, sau đó nó có thể được gỡ bỏ.
+     * Cho biết liệu các thành phần có nên được lưu sau khi được chuyển đổi hay không.
+     * Bằng cách đó, trình biên dịch có thể được chạy một lần duy nhất để chuyển đổi ứng dụng, và sau đó nó có thể được gỡ bỏ.
      */
     saveComponents: false,
   },

package/docs/vi/per_locale_file.md

@@ -128,7 +128,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-Sử dụng cấu hình này, tất cả các tệp theo từng locale sẽ được tạo với locale mặc định được đặt là tiếng Anh. Nó cũng bao gồm việc tạo các tệp `.content` bằng cách sử dụng lệnh `extract` và compiler. (Xem [Compiler](https://intlayer.org/doc/compiler) hoặc [Extract](https://intlayer.org/doc/concept/cli/extract) để biết thêm thông tin.)
+Sử dụng cấu hình này, tất cả các tệp theo từng locale sẽ được tạo với locale mặc định được đặt là tiếng Anh. Nó cũng bao gồm việc tạo các tệp `.content` bằng cách sử dụng lệnh `extract` và compiler. (Xem [Compiler](https://intlayer.org/doc/compiler) hoặc [Extract](https://github.com/aymericzip/intlayer/edit/main/docs/docs/en/cli/extract.md) để biết thêm thông tin.)
 
 ## Định dạng theo từng locale
 

package/docs/zh/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-02-25
+updatedAt: 2026-03-10
 title: Intlayer 编译器 | 用于 i18n 的自动内容提取
 description: 使用 Intlayer 编译器自动化您的国际化流程。直接从组件中提取内容，实现 Vite、Next.js 等框架中更快速、更高效的 i18n。
 keywords:
@@ -20,6 +20,9 @@ slugs:
   - doc
   - compiler
 history:
+  - version: 8.2.0
+    date: 2026-03-10
+    changes: Update compiler options, add FilePathPattern support
   - version: 8.1.7
     date: 2026-02-25
     changes: 更新编译器选项
@@ -157,13 +160,12 @@ import { type IntlayerConfig, Locales } from "intlayer";
 const config: IntlayerConfig = {
   compiler: {
     /**
-     * 指示是否应启用编译器。
-     * 设置为 'build-only' 可在开发期间跳过编译器并加快启动速度。
+     * 设置为 “build-only” 以在开发期间跳过编译器并加快启动速度。
      */
     enabled: true,
 
     /**
-     * 遍历要优化的代码的模式。
+     * Pattern to traverse the code to optimize.
      */
     transformPattern: [
       "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
@@ -171,23 +173,28 @@ const config: IntlayerConfig = {
     ],
 
     /**
-     * 要从优化中排除的模式。
+     * Pattern to exclude from the optimization.
      */
     excludePattern: ["**/node_modules/**"],
 
     /**
-     * 优化后字典的输出目录。
+     * 优化字典的输出目录。
      */
-    outputDir: "i18n",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * 仅在生成的文件中插入内容，不含键。
+     */
+    noMetadata: false,
 
     /**
      * 字典键前缀
      */
-    dictionaryKeyPrefix: "", // 移除基本前缀
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * 指示是否应在转换后保存组件。
-     * 这样，编译器只需运行一次即可转换应用程序，然后可以将其移除。
+     * 指示转换后是否应保存组件。
+     * 这样，编译器只需运行一次即可转换应用程序，然后即可将其删除。
      */
     saveComponents: false,
   },
@@ -209,3 +216,61 @@ npx intlayer fill         # 填充缺失的翻译
 ```
 
 > 有关更多详细信息，请参阅 [CLI 文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/ci.md)
+
+### 编译器配置参考
+
+可以在 `intlayer.config.ts` 文件的 `compiler` 块中配置以下属性：
+
+- **enabled**:
+  - _类型_: `boolean | 'build-only'`
+  - _默认值_: `true`
+  - _描述_: 指示是否应启用编译器。
+- **dictionaryKeyPrefix**:
+  - _类型_: `string`
+  - _默认值_: `'comp-'`
+  - _描述_: 提取的字典键的前缀。
+- **transformPattern**:
+  - _类型_: `string | string[]`
+  - _默认值_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}', '!**/node_modules/**']`
+  - _描述_: 遍历代码进行优化的模式。
+- **excludePattern**:
+  - _类型_: `string | string[]`
+  - _默认值_: `['**/node_modules/**']`
+  - _描述_: 优化中排除的模式。
+- **outputDir** (Deprecated):
+  - _类型_: `string`
+  - _默认值_: `'compiler'`
+  - _描述_: 存储提取的字典的目录。
+
+- **output**:
+  - _类型_: `FilePathPattern`
+  - _默认值_: `({ key }) => 'compiler/${key}.content.json'`
+  - _描述_: 定义输出文件路径。替换 `outputDir`。处理动态变量，如 `{{locale}}`、`{{key}}`、`{{fileName}}`、`{{extension}}`、`{{format}}`、`{{dirPath}}`、`{{componentFileName}}`、`{{componentExtension}}`、`{{componentFormat}}`。可以设置为字符串（使用 `'my/{{var}}/path'` 格式）或函数。
+  - _注意_: `./**/*` 路径相对于组件解析。`/**/*` 路径相对于 Intlayer 的 `baseDir` 解析。
+  - _示例_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _类型_: `boolean`
+  - _默认值_: `false`
+  - _描述_: 指示是否应在文件中保存元数据。如果为 true，编译器将不会保存字典的元数据（键、内容包装器）。
+  - _注意_: 如果与 `loadJSON` 插件一起使用，则非常有用。
+  - _示例_: 如果为 `true`：
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    如果为 `false`：
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```
+
+- **saveComponents**:
+  - _类型_: `boolean`
+  - _默认值_: `false`
+  - _描述_: 指示转换后是否应保存组件。

package/docs/zh/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-25
+updatedAt: 2026-03-10
 title: 配置
 description: 了解如何为您的应用程序配置 Intlayer。了解各种设置和选项，以根据您的需求自定义 Intlayer。
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.2.0
+    date: 2026-03-10
+    changes: Update compiler options, add 'output' and 'noMetadata' support
   - version: 8.1.7
     date: 2026-02-25
     changes: 更新编译器选项
@@ -422,7 +425,7 @@ const config: IntlayerConfig = {
    */
   compiler: {
     /**
-     * Indicates if the compiler should be enabled.
+     * 指示是否应启用编译器。
      */
     enabled: true,
 
@@ -440,18 +443,23 @@ const config: IntlayerConfig = {
     excludePattern: ["**/node_modules/**"],
 
     /**
-     * Output directory for the optimized dictionaries.
+     * 优化字典的输出目录。
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
 
     /**
-     * Dictionary key prefix
+     * 仅在生成的文件中插入内容，不含键。
+     */
+    noMetadata: false,
+
+    /**
+     * 字典键前缀
      */
     dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * Indicates if the components should be saved after being transformed.
-     * That way, the compiler can be run only once to transform the app, and then it can be removed.
+     * 指示转换后是否应保存组件。
+     * 这样，编译器只需运行一次即可转换应用程序，然后即可将其删除。
      */
     saveComponents: false,
   },
@@ -707,7 +715,7 @@ export default config;
 #### 属性
 
 - **autoFill**：
-  - _类型_：`boolean | string | { [key in Locales]?: string }`
+  - _类型_：`boolean | string | FilePathPattern | { [key in Locales]?: string }`
   - _默认值_：`undefined`
   - _描述_：指示内容应如何使用 AI 自动填充。可以在 `intlayer.config.ts` 文件中全局声明。
   - _示例_：true
@@ -823,11 +831,11 @@ export default config;
 - **locale**
 - **location**
 - **importMode**:
-  - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
-  - _Type_: `'static' | 'dynamic' | 'fetch'`
-  - _Default_: `'static'`
-  - _Description_: Controls how dictionaries are imported.
-  - _Example_: `'dynamic'`
+  - _注意_: **Deprecated**: Use `dictionary.importMode` instead.
+  - _类型_: `'static' | 'dynamic' | 'fetch'`
+  - _默认值_: `'static'`
+  - _描述_: Controls how dictionaries are imported.
+  - _示例_: `'dynamic'`
 - **priority**
 - **live**
 - **schema**
@@ -959,10 +967,10 @@ Intlayer 支持多个 AI 提供商，以增强灵活性和选择。目前支持
   - _注意_：可用于禁用字典构建，例如当应避免在 Node.js 环境中执行时。
 
 - **checkTypes**:
-  - _Type_: `boolean`
-  - _Default_: `false`
-  - _Description_: 指示构建是否应检查 TypeScript 类型并记录错误。
-  - _Note_: 这可能会减慢构建速度。
+  - _类型_: `boolean`
+  - _默认值_: `false`
+  - _描述_: 指示构建是否应检查 TypeScript 类型并记录错误。
+  - _注意_: 这可能会减慢构建速度。
 
 - **optimize**：
   - _类型_：`boolean`
@@ -975,7 +983,7 @@ Intlayer 支持多个 AI 提供商，以增强灵活性和选择。目前支持
   - _注意_: 确保所有键在 `useIntlayer` 调用中是静态声明的。例如 `useIntlayer('navbar')`。
 
 - **importMode**:
-  - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
+  - _注意_: **Deprecated**: Use `dictionary.importMode` instead.
   - _类型_: `'static' | 'dynamic' | 'fetch'`
   - _默认值_: `'static'`
   - _描述_: 控制字典的导入方式。
@@ -1054,3 +1062,31 @@ Intlayer 支持多个 AI 提供商，以增强灵活性和选择。目前支持
   - _类型_：`string`
   - _默认值_： `'compiler'`
   - _描述_：存储提取字典的目录，相对于您的项目基准路径。
+
+- **output**:
+  - _类型_: `FilePathPattern`
+  - _默认值_: `({ key }) => 'compiler/${key}.content.json'`
+  - _描述_: 定义输出文件路径。替换 `outputDir`。处理动态变量，如 `{{locale}}`、`{{key}}`、`{{fileName}}`、`{{extension}}`、`{{format}}`、`{{dirPath}}`、`{{componentFileName}}`、`{{componentExtension}}`、`{{componentFormat}}`。可以设置为字符串（使用 `'my/{{var}}/path'` 格式）或函数。
+  - _注意_: `./**/*` 路径相对于组件解析。`/**/*` 路径相对于 Intlayer 的 `baseDir` 解析。
+  - _示例_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _类型_: `boolean`
+  - _默认值_: `false`
+  - _描述_: 指示是否应在文件中保存元数据。如果为 true，编译器将不会保存字典的元数据（键、内容包装器）。
+  - _注意_: 如果与 `loadJSON` 插件一起使用，则非常有用。
+  - _示例_: 如果为 `true`：
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    如果为 `false`：
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```

package/docs/zh/intlayer_with_nextjs_compiler.md

@@ -20,6 +20,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-next-no-lolale-path-template
 youtubeVideo: https://www.youtube.com/watch?v=e_PPG7PTqGU
 history:
+  - version: 8.2.0
+    date: 2026-03-09
+    changes: Update compiler options, add FilePathPattern support
   - version: 8.1.6
     date: 2026-02-23
     changes: 初始版本
@@ -128,23 +131,28 @@ const config: IntlayerConfig = {
   },
   compiler: {
     /**
-     * 指示是否启用编译器。
+     * 指示是否应启用编译器。
      */
     enabled: true,
 
     /**
-     * 优化后字典的输出目录。
+     * 优化字典的输出目录。
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * 仅在生成的文件中插入内容，不含键。
+     */
+    noMetadata: false,
 
     /**
      * 字典键前缀
      */
-    dictionaryKeyPrefix: "", // 移除基础前缀
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
      * 指示转换后是否应保存组件。
-     * 这样，编译器只需运行一次即可转换应用程序，然后即可将其移除。
+     * 这样，编译器只需运行一次即可转换应用程序，然后即可将其删除。
      */
     saveComponents: false,
   },