@intlayer/docs 9.3.1 → 9.3.3

package/docs/vi/eslint.md

@@ -0,0 +1,336 @@
+---
+createdAt: 2026-08-12
+updatedAt: 2026-08-13
+title: Plugin ESLint | Quy tắc Lint cho Intlayer
+description: Phát hiện chuỗi văn bản bị hardcode, các lệnh gọi động mà trình biên dịch Intlayer không thể tối ưu hóa và nội dung từ điển không sử dụng với eslint-plugin-intlayer. Hoạt động với ESLint và oxlint trên React, Vue, Svelte, Angular và Astro.
+keywords:
+  - Intlayer
+  - ESLint
+  - oxlint
+  - Linting
+  - i18n
+  - Quốc tế hóa
+  - no-raw-text
+  - Chuỗi văn bản hardcoded
+  - Bản dịch không sử dụng
+  - Nội dung thừa
+  - React
+  - Vue
+  - Svelte
+  - Angular
+slugs:
+  - doc
+  - eslint
+history:
+  - version: 9.3.1
+    date: 2026-08-12
+    changes: "Lịch sử khởi tạo"
+author: aymericzip
+---
+
+# Plugin ESLint x OXLint
+
+`eslint-plugin-intlayer` giúp bắt các lỗi i18n mà TypeScript không thể phát hiện:
+
+1. **Văn bản hardcode** chưa từng được đưa vào từ điển.
+2. **Các lệnh gọi động** vượt qua kiểm tra kiểu và thực thi được, nhưng trình biên dịch Intlayer không thể tối ưu hóa.
+3. **Nội dung thừa (Dead content)** — các từ điển và trường không có bất kỳ phần nào trong dự án đọc (tùy chọn kích hoạt).
+
+Các khóa từ điển không xác định, đường dẫn trường không xác định và ngôn ngữ còn thiếu vốn đã là các lỗi biên dịch, vì vậy plugin sẽ không lặp lại chúng.
+
+## Cài đặt
+
+```bash packageManager="npm"
+npm install --save-dev eslint-plugin-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add --save-dev eslint-plugin-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add --dev eslint-plugin-intlayer
+```
+
+Yêu cầu ESLint 9 trở lên (flat config). ESLint 10 được hỗ trợ.
+
+## Cách sử dụng
+
+Plugin hoạt động trên cả ESLint và [oxlint](https://oxc.rs) — cùng quy tắc, cùng tùy chọn.
+
+<Tabs defaultTab="eslint">
+  <Tab label="ESLint" value="eslint">
+
+```javascript fileName="eslint.config.mjs"
+import intlayer from "eslint-plugin-intlayer";
+
+export default [...intlayer.configs.recommended];
+```
+
+Hoặc trải một cấu hình và tự đặt mức độ nghiêm trọng:
+
+```javascript fileName="eslint.config.mjs"
+import intlayer from "eslint-plugin-intlayer";
+
+export default [
+  ...intlayer.configs.recommended,
+  {
+    rules: {
+      "intlayer/no-raw-text": "warn",
+      "intlayer/static-dictionary-key": "error",
+      "intlayer/no-dynamic-field-access": "error",
+      "intlayer/enforce-adapter-import": "warn",
+      "intlayer/no-unused-content": "warn",
+    },
+  },
+];
+```
+
+  </Tab>
+  <Tab label="oxlint" value="oxlint">
+
+```json fileName=".oxlintrc.json"
+{
+  "jsPlugins": ["eslint-plugin-intlayer"],
+  "rules": {
+    "intlayer/no-raw-text": "warn",
+    "intlayer/static-dictionary-key": "error",
+    "intlayer/no-dynamic-field-access": "error",
+    "intlayer/enforce-adapter-import": "warn"
+  }
+}
+```
+
+Hai lưu ý: hỗ trợ plugin JS của oxlint vẫn đang ở giai đoạn alpha và oxlint không hỗ trợ trình phân tích cú pháp tùy chỉnh — vì vậy các tệp `.vue`, `.svelte`, `.astro` và template Angular không được lint tại đó. Hãy chạy oxlint trên các tệp JS/TS/JSX của bạn và giữ lại ESLint cho phần còn lại.
+
+`no-unused-content` được cố tình lược bỏ ở trên: nó cần thư mục làm việc và đường dẫn tệp được lint từ ngữ cảnh quy tắc, điều mà cầu nối plugin JS alpha chưa đảm bảo. Hãy chạy quy tắc này dưới ESLint.
+
+  </Tab>
+</Tabs>
+
+### Cấu hình (Configs)
+
+| Cấu hình        | `no-raw-text`             | `static-dictionary-key` | `no-dynamic-field-access` | `enforce-adapter-import` | `no-unused-content` |
+| --------------- | ------------------------- | ----------------------- | ------------------------- | ------------------------ | ------------------- |
+| `recommended`   | warn                      | error                   | error                     | off                      | off                 |
+| `strict`        | error (+ chuỗi ngoài JSX) | error                   | error                     | error                    | off                 |
+| `contract-only` | off                       | error                   | error                     | off                      | off                 |
+
+`recommended` cố ý giữ `no-raw-text` ở mức `warn`: việc áp dụng quy tắc này vào một codebase hiện có sẽ hiển thị tất cả các chuỗi chưa được dịch cùng một lúc, điều này không nên làm gián đoạn bản build của bạn ngay từ ngày đầu tiên.
+
+`enforce-adapter-import` bị tắt theo mặc định — hãy bật rõ ràng nếu bạn muốn.
+
+`no-unused-content` bị tắt trong mọi cấu hình, bao gồm cả `strict`. Đây là quy tắc duy nhất đọc cấu hình Intlayer của bạn và duyệt qua các tệp nguồn từ đĩa, vì vậy việc bật nó nên là một lựa chọn có chủ đích thay vì được thiết lập sẵn tự động.
+
+## Các quy tắc
+
+### `no-raw-text`
+
+Báo cáo văn bản hiển thị cho người dùng không được khai báo trong từ điển. Quy tắc sử dụng cơ chế phát hiện giống như `intlayer extract`, do đó tên thương hiệu, lớp CSS và định danh kỹ thuật sẽ bị bỏ qua.
+
+```jsx
+// ✗ Bị báo cáo
+<h1>Welcome to our documentation</h1>
+<input placeholder="Enter your email address" />
+
+// ✓ Hợp lệ
+const { title } = useIntlayer("home");
+<h1>{title}</h1>
+```
+
+Các tệp khai báo nội dung (`*.content.ts`, …) được bỏ qua.
+
+Để sửa toàn bộ tệp cùng lúc, hãy chạy `npx intlayer extract` và để trình biên dịch chuyển các chuỗi vào từ điển giúp bạn.
+
+**Tùy chọn**
+
+```javascript fileName="eslint.config.mjs"
+{
+  "intlayer/no-raw-text": [
+    "warn",
+    {
+      // Các thuộc tính có giá trị là văn bản hiển thị cho người dùng.
+      // Mặc định: title, placeholder, alt, aria-label, label
+      attributes: ["title", "placeholder", "alt", "aria-label", "label"],
+
+      // Các phần tử có nội dung không bao giờ là văn bản hiển thị cho người dùng.
+      // Mặc định: code, pre, script, style
+      ignoreElements: ["code", "pre", "script", "style"],
+
+      // Biểu thức chính quy cho văn bản không bao giờ bị báo cáo.
+      ignorePatterns: ["^Powered by"],
+
+      // Báo cáo cả chuỗi ký tự bên ngoài mã markup. Mặc định: false
+      includeStringLiterals: false,
+    },
+  ],
+}
+```
+
+### `static-dictionary-key`
+
+Yêu cầu khóa từ điển phải là một chuỗi ký tự cố định (string literal).
+
+Trình biên dịch chỉ có thể tải trước từ điển khi có thể đọc trực tiếp khóa tại vị trí gọi. Với một khóa được tính toán động, nó sẽ âm thầm bỏ qua việc tối ưu hóa và đóng gói tất cả từ điển thay thế.
+
+```typescript
+// ✗ Bị báo cáo
+useIntlayer(dictionaryKey);
+useIntlayer(`home-${suffix}`);
+getTranslations({ namespace: page });
+
+// ✗ Biến vẫn không phải là một chuỗi cố định
+const key = "home";
+useIntlayer(key);
+
+// ✓ Hợp lệ
+useIntlayer("home");
+getTranslations({ namespace: "home" });
+```
+
+Điều này áp dụng cho `useIntlayer`, `getIntlayer` và mọi adapter tương thích (`useTranslation`, `useTranslations`, `formatMessage`, `<FormattedMessage id>`, `<Trans i18nKey>`, …).
+
+### `no-dynamic-field-access`
+
+Yêu cầu trường bạn đọc từ từ điển phải được xác định tĩnh.
+
+Trình biên dịch sẽ loại bỏ các trường mà nó không thấy được sử dụng. Một truy cập được tính toán động là vô hình đối với nó, do đó việc đọc có thể trả về `undefined` trong thời gian chạy.
+
+```typescript
+// ✗ Bị báo cáo
+const content = useIntlayer("home");
+content[fieldName];
+
+const t = useTranslations("home");
+t(messageKey);
+
+// ✓ Hợp lệ
+content.title;
+content["title"];
+content.items[0];
+t("hero.title");
+```
+
+### `enforce-adapter-import`
+
+Ưu tiên adapter tương thích `@intlayer/*` hơn gói gốc. Gói gốc chỉ phân giải thành Intlayer khi alias của bundler được cấu hình; adapter luôn luôn thực hiện được. Có thể tự động sửa bằng `--fix`.
+
+```typescript
+// ✗ Bị báo cáo
+import { useTranslation } from "react-i18next";
+import { getTranslations } from "next-intl/server";
+
+// ✓ Hợp lệ
+import { useTranslation } from "@intlayer/react-i18next";
+import { getTranslations } from "@intlayer/next-intl/server";
+```
+
+### `no-unused-content`
+
+**Tắt theo mặc định.** Báo cáo nội dung không có bất kỳ phần nào trong dự án đọc, cùng với các khóa từ điển được khai báo ở nhiều nơi.
+
+```typescript fileName="src/home.content.ts"
+export default {
+  key: "home", // ✗ Bị báo cáo nếu không có nơi nào trong dự án yêu cầu "home"
+  content: {
+    title: t({ vi: "Tiêu đề", en: "Title" }),
+
+    // ✗ Bị báo cáo nếu không có nơi nào đọc `hero`
+    hero: {
+      subtitle: t({ vi: "Phụ đề", en: "Subtitle" }),
+    },
+  },
+};
+```
+
+Không giống như các quy tắc khác, quy tắc này không thể quyết định chỉ từ tệp đang kiểm tra — một trường chỉ được xem là không sử dụng khi so với toàn bộ dự án. Khi gặp khai báo nội dung đầu tiên trong một lần lint, nó sẽ tải cấu hình Intlayer, quét các tệp nguồn mà cấu hình đó khai báo (`build.traversePattern`, `compiler.transformPattern`) và chạy cùng bộ phân tích mức độ sử dụng đang vận hành `@intlayer/lsp` và tính năng gạch ngang "không sử dụng" trong tiện ích mở rộng VS Code. Kết quả được lưu vào bộ nhớ cache trong `cacheTtl` mili giây, do đó quá trình quét diễn ra một lần cho mỗi lượt chạy thay vì mỗi tệp.
+
+**Tùy chọn**
+
+```javascript fileName="eslint.config.mjs"
+{
+  "intlayer/no-unused-content": [
+    "warn",
+    {
+      // Báo cáo các khóa từ điển không có nơi nào tham chiếu. Mặc định: true
+      reportUnusedDictionaries: true,
+
+      // Báo cáo các trường nội dung không có nơi nào đọc. Mặc định: true
+      reportUnusedFields: true,
+
+      // Báo cáo các khóa được khai báo ở nhiều nơi. Mặc định: true
+      reportDuplicateKeys: true,
+
+      // Biểu thức chính quy cho đường dẫn trường không bao giờ bị báo cáo.
+      ignoreFields: ["^meta"],
+
+      // Thư mục gốc của dự án bắt đầu quét. Mặc định: thư mục làm việc của ESLint
+      baseDir: process.cwd(),
+
+      // Thời gian một lần quét dự án được tái sử dụng, tính bằng ms. Mặc định: 30000
+      cacheTtl: 30000,
+    },
+  ],
+}
+```
+
+Giảm `cacheTtl` khi bạn lint từ một editor server hoạt động lâu dài và muốn các chỉnh sửa hiển thị sớm hơn; thiết lập `baseDir` khi một lần chạy lint trải rộng trên nhiều dự án Intlayer trong monorepo.
+
+> **Thiên về sự an toàn (ít báo sai).** Một cảnh báo sai ở đây có thể dẫn đến việc xóa một bản dịch, vì vậy sẽ không có gì được báo cáo khi từ điển được sử dụng theo cách mà bộ phân tích không thể theo dõi: đối tượng nội dung được truyền nguyên vẹn, hàm dịch được liên kết từ đó (`const t = useTranslations("home")`), khai báo được truy cập qua import trực tiếp (`useDictionary(myDictionary)`), lệnh `nest()` từ từ điển khác, hoặc danh sách trường bị làm mờ bởi toán tử spread. Các component đơn tệp (`.vue`, `.svelte`, `.astro`) được tính là sử dụng mọi trường của từ điển mà chúng đề cập, vì các khối script của chúng không được phân tích cú pháp tại đây.
+
+`reportDuplicateKeys` đọc các từ điển chưa hợp nhất mà bản build ghi dưới thư mục `.intlayer/`, do đó nó giữ im lặng cho đến khi dự án được build ít nhất một lần. Hai khai báo có chung một khóa sẽ được hợp nhất, đây là một mẫu hợp lệ — báo cáo tồn tại vì một trường được định nghĩa ở cả hai bên sẽ âm thầm chỉ giữ lại một trong hai giá trị.
+
+Bộ phân tích được nạp từ `@intlayer/lsp`, phát hành dưới dạng ESM. Do đó quy tắc cần một phiên bản Node có thể `require()` module ES — Node 20.19+ hoặc 22.12+. Trên các phiên bản cũ hơn, nó sẽ không báo cáo gì thay vì làm hỏng lần chạy lint.
+
+## Frameworks
+
+Mọi quy tắc đều hoạt động trên tất cả các tích hợp của Intlayer, bao gồm bên trong template của Vue, Svelte và Angular. Bạn chỉ cần chỉ định cho ESLint parser nào xử lý từng loại tệp.
+
+| Framework                 | Tệp               | Parser                            |
+| ------------------------- | ----------------- | --------------------------------- |
+| React, Preact, Solid, Lit | `.jsx` `.tsx`     | `typescript-eslint`               |
+| Next.js                   | `.jsx` `.tsx`     | `typescript-eslint`               |
+| Vue, Nuxt                 | `.vue`            | `vue-eslint-parser`               |
+| Svelte, SvelteKit         | `.svelte`         | `svelte-eslint-parser`            |
+| Angular                   | `.ts`             | `typescript-eslint`               |
+| Template Angular          | `.component.html` | `@angular-eslint/template-parser` |
+| Astro                     | `.astro`          | `astro-eslint-parser`             |
+
+```javascript fileName="eslint.config.mjs"
+import intlayer from "eslint-plugin-intlayer";
+import tseslint from "typescript-eslint";
+import vueParser from "vue-eslint-parser";
+import svelteParser from "svelte-eslint-parser";
+import angularTemplateParser from "@angular-eslint/template-parser";
+
+export default [
+  ...intlayer.configs.recommended,
+
+  {
+    files: ["**/*.{ts,tsx,jsx}"],
+    languageOptions: { parser: tseslint.parser },
+  },
+  {
+    files: ["**/*.vue"],
+    languageOptions: {
+      parser: vueParser,
+      parserOptions: { parser: tseslint.parser },
+    },
+  },
+  {
+    files: ["**/*.svelte"],
+    languageOptions: {
+      parser: svelteParser,
+      parserOptions: { parser: tseslint.parser },
+    },
+  },
+  {
+    files: ["**/*.component.html"],
+    languageOptions: { parser: angularTemplateParser },
+  },
+];
+```
+
+Chỉ cài đặt các parser mà dự án của bạn cần.
+
+> **Hạn chế đã biết.** Trong template của Vue và Angular, một biểu thức như `{{ content[key] }}` sẽ không được kiểm tra bởi `no-dynamic-field-access`. Các truy cập động được viết trong khối script vẫn được phát hiện bình thường.

package/docs/zh/bundle_optimization.md

@@ -159,7 +159,7 @@ pnpm add -D webpack-bundle-analyzer
 bun add -d webpack-bundle-analyzer
 ```
 
-```typescript fileName="webpack.config.ts
+```typescript fileName="webpack.config.ts"
 import { BundleAnalyzerPlugin } from "webpack-bundle-analyzer";
 
 export default {

package/docs/zh/configuration.md

@@ -477,6 +477,24 @@ const config: IntlayerConfig = {
      */
     purge: true,
 
+    /**
+     * 按使用它们的代码分割边界对各语言的字典分块进行分组，使懒加载页面只需一次请求即可获取其内容。
+     * 默认值：true
+     *
+     * 注意：
+     * - 仅适用于使用 `importMode: 'dynamic'` 的字典。
+     */
+    chunkGrouping: true,
+
+    /**
+     * 让字典与使用它的分块一起加载，而不是等该分块渲染后再获取。读取将同步渲染而不是挂起，因此导航时不再闪烁加载状态。
+     * 默认值：true
+     *
+     * 注意：
+     * - 仅等待已解析的语言，因此页面只会下载它所呈现的语言。
+     */
+    dictionariesPreload: true,
+
     /**
      * 生成的字典文件的输出格式。
      * 默认值：['cjs', 'esm']
@@ -1056,15 +1074,17 @@ Intlayer 支持多个 AI 提供商，以提供最大的灵活性。当前支持
 
 > 在优化期间，Intlayer 将替换字典调用以优化分块 (chunking)，使生成的包仅导入实际使用的字典。
 
-| 字段              | 说明                                           | 类型                             | 默认值                                                                                                                                                                            | 示例                                                                          | 备注                                                                                                                                                                                                                              |
-| ----------------- | ---------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mode`            | 控制构建模式。                                 | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: 构建在应用程序构建期间自动启动。<br/>• `'manual'`: 仅通过显式构建命令触发。<br/>• 可用于防止字典构建（例如避免在 Node.js 环境中运行）。                                                                               |
-| `optimize`        | 控制是否应执行构建优化。                       | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • 如果未定义，则在框架构建 (Vite/Next.js) 期间启动优化。<br/>• `true` 在开发模式下也会强制执行优化。<br/>• `false` 将其禁用。<br/>• 如果启用，则会替换字典调用以优化分块。<br/>• 需要 `@intlayer/babel` 和 `@intlayer/swc` 插件。 |
-| `minify`          | 压缩字典以减小包体大小。                       | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • 指定是否应最小化包内容。<br/>• 默认值：生产环境中为 `true`。<br/>• 如果禁用了 `optimize`，该选项将被忽略。<br/>• 如果 `editor.enabled` 为 true，该选项将被忽略。                                                                |
-| `purge`           | 清除字典中未使用的键。                         | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • 指定是否应清理包内容。<br/>• 默认值：生产环境中为 `true`。<br/>• 如果禁用了 `optimize`，该选项将被忽略。                                                                                                                        |
-| `checkTypes`      | 指示构建是否应检查 TypeScript 类型并记录错误。 | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | 可能会减慢构建过程。                                                                                                                                                                                                              |
-| `outputFormat`    | 控制字典的输出格式。                           | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                   |
-| `traversePattern` | 优化期间指定要扫描的文件的模式。               | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • 通过将优化限制在相关文件来提高构建性能。<br/>• 如果 `optimize` 关闭则忽略。<br/>• 使用 glob 模式。                                                                                                                              |
+| 字段                  | 说明                                                           | 类型                             | 默认值                                                                                                                                                                            | 示例                                                                          | 备注                                                                                                                                                                                                                                                                                                                            |
+| --------------------- | -------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`                | 控制构建模式。                                                 | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: 构建在应用程序构建期间自动启动。<br/>• `'manual'`: 仅通过显式构建命令触发。<br/>• 可用于防止字典构建（例如避免在 Node.js 环境中运行）。                                                                                                                                                                             |
+| `optimize`            | 控制是否应执行构建优化。                                       | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • 如果未定义，则在框架构建 (Vite/Next.js) 期间启动优化。<br/>• `true` 在开发模式下也会强制执行优化。<br/>• `false` 将其禁用。<br/>• 如果启用，则会替换字典调用以优化分块。<br/>• 需要 `@intlayer/babel` 和 `@intlayer/swc` 插件。                                                                                               |
+| `minify`              | 压缩字典以减小包体大小。                                       | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • 指定是否应最小化包内容。<br/>• 默认值：生产环境中为 `true`。<br/>• 如果禁用了 `optimize`，该选项将被忽略。<br/>• 如果 `editor.enabled` 为 true，该选项将被忽略。                                                                                                                                                              |
+| `purge`               | 清除字典中未使用的键。                                         | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • 指定是否应清理包内容。<br/>• 默认值：生产环境中为 `true`。<br/>• 如果禁用了 `optimize`，该选项将被忽略。                                                                                                                                                                                                                      |
+| `checkTypes`          | 指示构建是否应检查 TypeScript 类型并记录错误。                 | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | 可能会减慢构建过程。                                                                                                                                                                                                                                                                                                            |
+| `chunkGrouping`       | 是否按使用它们的代码分割边界对各语言的字典分块进行分组。       | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • 不分组时，由众多组件构成的页面会为每个字典发出一次请求。<br/>• 从多个边界访问的字典会移入共享分块，因此任何页面都不会携带其他页面的内容。<br/>• 仅适用于使用 `importMode: 'dynamic'` 的字典。<br/>• 仅适用于客户端构建，且仅在打包时生效（开发模式除外）。                                                                    |
+| `dictionariesPreload` | 字典是否应与使用它的分块一起加载，而不是等该分块渲染后再获取。 | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • 生成的入口点在顶层等待浏览语言，因此懒加载路由在其内容就绪前不会被视为已加载。<br/>• 读取将同步渲染而不是挂起，因此导航时不再闪烁加载状态。<br/>• 仅等待已解析的语言，因此页面只会下载它所呈现的语言。<br/>• 仅适用于客户端构建中使用 `importMode: 'dynamic'` 的字典。<br/>• 需要支持顶层 await 的打包工具（Vite、esbuild）。 |
+| `outputFormat`        | 控制字典的输出格式。                                           | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                 |
+| `traversePattern`     | 优化期间指定要扫描的文件的模式。                               | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • 通过将优化限制在相关文件来提高构建性能。<br/>• 如果 `optimize` 关闭则忽略。<br/>• 使用 glob 模式。                                                                                                                                                                                                                            |
 
 ---
 

package/docs/zh/dictionary/content_file.md

@@ -533,28 +533,6 @@ export default aboutPageMetaContent;
 
 > 参见 [变体](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dynamic_dictionaries/variants.md) 了解更多信息。
 
-#### `meta` (`Record<string, string | number | boolean>`)
-
-与动态记录 (Dynamic Records) 配合使用，此字段允许通过不透明的 ID 声明 CMS 管理的的记录或在运行时获取的任意数据。字典身份由该 `meta` 字段中声明的任意键值对集定义。
-
-**示例：**
-
-```typescript
-{
-  key: "product-copy",
-  meta: {
-    id: "prod_abc",
-    userId: "user_123"
-  },
-  content: {
-    name: "Widget Pro",
-    description: "The best widget."
-  }
-}
-```
-
-> 参见 [动态记录](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dynamic_dictionaries/dynamic_content.md) 了解更多信息。
-
 ### CMS 属性
 
 ##### `version`（字符串）

package/docs/zh/dictionary/function_fetching.md

@@ -87,6 +87,29 @@ export default asyncFunctionContent;
 
 在这种情况下，`fakeFetch` 函数模拟了一个延迟以模拟服务器响应时间。Intlayer 会执行异步函数，并将结果用作 `text` 键的内容。
 
+## 获取远程内容
+
+你也可以直接将一个 Promise 赋值给内容字段。Intlayer 会在构建字典时等待它，并将解析后的值内联进字典：
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import type { Dictionary } from "intlayer";
+
+const remoteContent = {
+  key: "remote_content",
+  content: {
+    externalContent: fetch("https://example.com").then((res) => res.json()),
+  },
+} satisfies Dictionary;
+
+export default remoteContent;
+```
+
+```plaintext fileName="**/*.content.json" contentDeclarationFormat="json"
+无法从JSON文件获取内容，请改用.ts或.js文件
+```
+
+> 该请求在构建时执行，因此获取到的数据是嵌入字典中的快照。重新构建字典即可更新它。
+
 ## 在 React 组件中使用基于函数的内容
 
 要在 React 组件中使用基于函数的内容，您需要从 `react-intlayer` 导入 `useIntlayer` 并使用内容 ID 调用它以获取内容。示例如下：