@intlayer/docs 9.3.2 → 9.3.3

package/docs/vi/eslint.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-08-12
-updatedAt: 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:
@@ -52,7 +52,7 @@ pnpm add --save-dev eslint-plugin-intlayer
 yarn add --dev eslint-plugin-intlayer
 ```
 
-Yêu cầu ESLint 9 trở lên (flat config).
+Yêu cầu ESLint 9 trở lên (flat config). ESLint 10 được hỗ trợ.
 
 ## Cách sử dụng
 
@@ -61,20 +61,20 @@ Plugin hoạt động trên cả ESLint và [oxlint](https://oxc.rs) — cùng q
 <Tabs defaultTab="eslint">
   <Tab label="ESLint" value="eslint">
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 
 export default [...intlayer.configs.recommended];
 ```
 
-Hoặc bật từng quy tắc một:
+Hoặc trải một cấu hình và tự đặt mức độ nghiêm trọng:
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 
 export default [
+  ...intlayer.configs.recommended,
   {
-    plugins: { intlayer },
     rules: {
       "intlayer/no-raw-text": "warn",
       "intlayer/static-dictionary-key": "error",
@@ -144,7 +144,7 @@ Các tệp khai báo nội dung (`*.content.ts`, …) được bỏ qua.
 
 **Tùy chọn**
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 {
   "intlayer/no-raw-text": [
     "warn",
@@ -247,7 +247,7 @@ Không giống như các quy tắc khác, quy tắc này không thể quyết đ
 
 **Tùy chọn**
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 {
   "intlayer/no-unused-content": [
     "warn",
@@ -296,7 +296,7 @@ Mọi quy tắc đều hoạt động trên tất cả các tích hợp của In
 | Template Angular          | `.component.html` | `@angular-eslint/template-parser` |
 | Astro                     | `.astro`          | `astro-eslint-parser`             |
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 import tseslint from "typescript-eslint";
 import vueParser from "vue-eslint-parser";

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 调用它以获取内容。示例如下：

package/docs/zh/eslint.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-08-12
-updatedAt: 2026-08-12
+updatedAt: 2026-08-13
 title: ESLint 插件 | Intlayer 的 Lint 规则
 description: 使用 eslint-plugin-intlayer 捕获硬编码字符串、Intlayer 编译器无法优化的动态调用以及未使用的字典内容。支持 ESLint 和 oxlint，适用于 React、Vue、Svelte、Angular 和 Astro。
 keywords:
@@ -52,7 +52,7 @@ pnpm add --save-dev eslint-plugin-intlayer
 yarn add --dev eslint-plugin-intlayer
 ```
 
-需要 ESLint 9 或更高版本（Flat config）。
+需要 ESLint 9 或更高版本（Flat config）。支持 ESLint 10。
 
 ## 使用方法
 
@@ -61,20 +61,20 @@ yarn add --dev eslint-plugin-intlayer
 <Tabs defaultTab="eslint">
   <Tab label="ESLint" value="eslint">
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 
 export default [...intlayer.configs.recommended];
 ```
 
-或者逐个启用规则：
+或者展开某个配置并自行设置严重级别：
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 
 export default [
+  ...intlayer.configs.recommended,
   {
-    plugins: { intlayer },
     rules: {
       "intlayer/no-raw-text": "warn",
       "intlayer/static-dictionary-key": "error",
@@ -144,7 +144,7 @@ const { title } = useIntlayer("home");
 
 **配置选项**
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 {
   "intlayer/no-raw-text": [
     "warn",
@@ -247,7 +247,7 @@ export default {
 
 **配置选项**
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 {
   "intlayer/no-unused-content": [
     "warn",
@@ -296,7 +296,7 @@ export default {
 | Angular 模板              | `.component.html` | `@angular-eslint/template-parser` |
 | Astro                     | `.astro`          | `astro-eslint-parser`             |
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 import tseslint from "typescript-eslint";
 import vueParser from "vue-eslint-parser";

package/docs/zh-TW/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-TW/eslint.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-08-12
-updatedAt: 2026-08-12
+updatedAt: 2026-08-13
 title: ESLint 外掛 | Intlayer 的 Lint 規則
 description: 使用 eslint-plugin-intlayer 捕捉硬編碼字串、Intlayer 編譯器無法最佳化的動態呼叫以及未使用的字典內容。支援 ESLint 與 oxlint，適用於 React、Vue、Svelte、Angular 與 Astro。
 keywords:
@@ -52,7 +52,7 @@ pnpm add --save-dev eslint-plugin-intlayer
 yarn add --dev eslint-plugin-intlayer
 ```
 
-需要 ESLint 9 或更高版本（Flat config）。
+需要 ESLint 9 或更高版本（Flat config）。支援 ESLint 10。
 
 ## 使用方法
 
@@ -61,20 +61,20 @@ yarn add --dev eslint-plugin-intlayer
 <Tabs defaultTab="eslint">
   <Tab label="ESLint" value="eslint">
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 
 export default [...intlayer.configs.recommended];
 ```
 
-或者逐一啟用規則：
+或者展開某個設定並自行指定嚴重程度：
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 
 export default [
+  ...intlayer.configs.recommended,
   {
-    plugins: { intlayer },
     rules: {
       "intlayer/no-raw-text": "warn",
       "intlayer/static-dictionary-key": "error",
@@ -144,7 +144,7 @@ const { title } = useIntlayer("home");
 
 **設定選項**
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 {
   "intlayer/no-raw-text": [
     "warn",
@@ -247,7 +247,7 @@ export default {
 
 **設定選項**
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 {
   "intlayer/no-unused-content": [
     "warn",
@@ -296,7 +296,7 @@ export default {
 | Angular 範本              | `.component.html` | `@angular-eslint/template-parser` |
 | Astro                     | `.astro`          | `astro-eslint-parser`             |
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 import tseslint from "typescript-eslint";
 import vueParser from "vue-eslint-parser";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "9.3.2",
+  "version": "9.3.3",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -73,9 +73,9 @@
     "watch": "webpack --config ./webpack.config.ts --watch"
   },
   "dependencies": {
-    "@intlayer/config": "9.3.2",
-    "@intlayer/core": "9.3.2",
-    "@intlayer/types": "9.3.2"
+    "@intlayer/config": "9.3.3",
+    "@intlayer/core": "9.3.3",
+    "@intlayer/types": "9.3.3"
   },
   "devDependencies": {
     "@intlayer/api": "9.3.2",
@@ -88,7 +88,7 @@
     "rimraf": "6.1.3",
     "tsdown": "0.22.14",
     "typescript": "7.0.2",
-    "vitest": "4.1.10"
+    "vitest": "4.1.11"
   },
   "engines": {
     "node": ">=14.18"