@intlayer/docs 8.11.3 → 8.12.0-canary.0

package/docs/zh/intlayer_with_vite+vue.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2026-05-31
-title: Vite + Vue i18n - 完整翻译指南： Vue
-description: 最佳的包体积、SEO、性能和可维护性解决方案。让您的 Vite and Vue 应用在 2026 年实现多语言化，LLM 翻译，Agent Skills & MCP。
+title: "Vite + Vue i18n - 翻译你的应用的完整指南"
+description: "告别 i18next。2026 年构建多语言 (i18n) Vite + Vue 应用的完整指南。使用 AI 代理翻译并优化包体积、SEO 和性能。"
 keywords:
   - 国际化
   - 文档
@@ -902,76 +902,6 @@ const { myMarkdownContent } = useIntlayer("my-component");
 </script>
 ```
 
-### 配置 TypeScript
-
-Intlayer 使用模块增强来利用 TypeScript 的优势，使您的代码库更强大。
-
-![Autocompletion](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)
-
-![Translation error](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.png?raw=true)
-
-确保您的 TypeScript 配置包含自动生成的类型。
-
-```json5 fileName="tsconfig.json"
-{
-  // ... 您现有的 TypeScript 配置
-  "include": [
-    // ... 您现有的 TypeScript 配置
-    ".intlayer/**/*.ts", // 包含自动生成的类型
-  ],
-}
-```
-
-### Git 配置
-
-建议忽略 Intlayer 生成的文件。这样可以避免将它们提交到您的 Git 仓库中。
-
-为此，您可以在 `.gitignore` 文件中添加以下指令：
-
-```bash
-#  忽略 Intlayer 生成的文件
-.intlayer
-```
-
-### VS Code 扩展
-
-为了提升您使用 Intlayer 的开发体验，您可以安装官方的 **Intlayer VS Code 扩展**。
-
-[从 VS Code 市场安装](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
-
-该扩展提供：
-
-- 翻译键的 **自动补全**。
-- 缺失翻译的 **实时错误检测**。
-- 翻译内容的 **内联预览**。
-- 轻松创建和更新翻译的 **快速操作**。
-
-建议忽略由 Intlayer 生成的文件。这样可以避免将它们提交到您的 Git 仓库中。
-
-为此，您可以在 `.gitignore` 文件中添加以下指令：
-
-```bash
-#  忽略由 Intlayer 生成的文件
-.intlayer
-```
-
-### VS Code 扩展
-
-为了提升您使用 Intlayer 的开发体验，您可以安装官方的 **Intlayer VS Code 扩展**。
-
-[从 VS Code 市场安装](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
-
-该扩展提供：
-
-- 翻译键的 **自动补全**。
-- 缺失翻译的 **实时错误检测**。
-- 翻译内容的 **内联预览**。
-- 轻松创建和更新翻译的 **快速操作**。
-
-有关如何使用该扩展的更多详细信息，请参阅 [Intlayer VS Code 扩展文档](https://intlayer.org/doc/vs-code-extension)。
-
----
-
 </Step>
 
 <Step number={1} title="提取组件内容" isOptional={true}>
@@ -1069,6 +999,79 @@ bun run build # Or bun run dev
 
  </Tab>
 </Tabs>
+</Step>
+
+</Steps>
+
+### 配置 TypeScript
+
+Intlayer 使用模块增强来利用 TypeScript 的优势，使您的代码库更强大。
+
+![Autocompletion](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)
+
+![Translation error](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.png?raw=true)
+
+确保您的 TypeScript 配置包含自动生成的类型。
+
+```json5 fileName="tsconfig.json"
+{
+  // ... 您现有的 TypeScript 配置
+  "include": [
+    // ... 您现有的 TypeScript 配置
+    ".intlayer/**/*.ts", // 包含自动生成的类型
+  ],
+}
+```
+
+### Git 配置
+
+建议忽略 Intlayer 生成的文件。这样可以避免将它们提交到您的 Git 仓库中。
+
+为此，您可以在 `.gitignore` 文件中添加以下指令：
+
+```bash
+#  忽略 Intlayer 生成的文件
+.intlayer
+```
+
+### VS Code 扩展
+
+为了提升您使用 Intlayer 的开发体验，您可以安装官方的 **Intlayer VS Code 扩展**。
+
+[从 VS Code 市场安装](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
+
+该扩展提供：
+
+- 翻译键的 **自动补全**。
+- 缺失翻译的 **实时错误检测**。
+- 翻译内容的 **内联预览**。
+- 轻松创建和更新翻译的 **快速操作**。
+
+建议忽略由 Intlayer 生成的文件。这样可以避免将它们提交到您的 Git 仓库中。
+
+为此，您可以在 `.gitignore` 文件中添加以下指令：
+
+```bash
+#  忽略由 Intlayer 生成的文件
+.intlayer
+```
+
+### VS Code 扩展
+
+为了提升您使用 Intlayer 的开发体验，您可以安装官方的 **Intlayer VS Code 扩展**。
+
+[从 VS Code 市场安装](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
+
+该扩展提供：
+
+- 翻译键的 **自动补全**。
+- 缺失翻译的 **实时错误检测**。
+- 翻译内容的 **内联预览**。
+- 轻松创建和更新翻译的 **快速操作**。
+
+有关如何使用该扩展的更多详细信息，请参阅 [Intlayer VS Code 扩展文档](https://intlayer.org/doc/vs-code-extension)。
+
+---
 
 ### （可选）站点地图与 robots.txt（构建时生成）
 
@@ -1149,7 +1152,3 @@ console.log("SEO files generated successfully.");
 要进一步使用，您可以实现 [可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md) 或使用 [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md) 来外部管理您的内容。
 
 ---
-
-</Step>
-
-</Steps>

package/docs/zh/introduction.md

@@ -87,6 +87,49 @@ export const MyComponent: FC = () => {
 };
 ```
 
+### 为什么选择 Intlayer 而不是其他替代方案？
+
+与 `next-intl` 或 `i18next` 等主流解决方案相比，Intlayer 是一个自带多项集成的优化方案，例如：
+
+<AccordionGroup>
+
+<Accordion header="捆绑体积 (Bundle Size)">
+
+您无需在页面中加载庞大的 JSON 文件，而是只加载所需的内容。Intlayer 可以帮助 **将您的捆绑包和页面大小减小多达 50%**。
+
+</Accordion>
+
+<Accordion header="可维护性">
+
+将您的应用程序内容局限在相应范围内，**有助于维护**大规模的应用程序。您可以复制或删除单个功能文件夹，而不会有审查整个内容代码库的心理负担。此外，Intlayer 是 **完全类型化 (fully typed)** 的，这能够确保您的内容的准确性。
+
+</Accordion>
+
+<Accordion header="AI Agent 支持">
+
+将内容同位放置 **减少了所需的上下文**，这非常适合大型语言模型 (LLM)。Intlayer 还附带一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/mcp_server.md)** 以及 **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，旨在让 AI 代理的开发者体验 (DX) 变得更加顺畅。
+
+</Accordion>
+
+<Accordion header="自动化">
+
+使用您选择的 LLM 并在由您的 AI 提供商承担费用的情况下，通过自动化在您的 CI/CD 管道中进行翻译。Intlayer 还提供了一个 **编译器**，可自动提取内容；并配备了一个 [Web 平台](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md) 以帮助您 **在后台执行翻译**。
+
+</Accordion>
+
+<Accordion header="性能表现 (Performance)">
+
+将庞大的 JSON 文件连接到组件，可能会导致性能与响应式问题。Intlayer 会在构建时优化您的内容加载。
+
+</Accordion>
+
+<Accordion header="无需开发人员的规模化运作 (Scaling with non-dev)">
+
+Intlayer 不仅仅是一个简单的 i18n 解决方案。它还提供了一个 **支持自托管的[可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)** 以及一个 **[完整的 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)**。借此，您可以 **实时** 管理多语言内容，并让译者、文案及其他团队成员之间的协作变得无缝。内容可以存储在本地和/或远程服务器上。
+
+</Accordion>
+</AccordionGroup>
+
 ## 主要特性
 
 Intlayer 提供了多种功能，旨在满足现代 Web 开发的需求。以下是主要功能，以及每个功能的详细文档链接：
@@ -160,31 +203,3 @@ Intlayer 提供了多种功能，旨在满足现代 Web 开发的需求。以下
 我们非常重视开源和社区驱动开发的力量。如果您想提出改进建议、添加新指南或纠正我们文档中的任何问题，请随时提交 Pull Request 或在我们的 [GitHub 仓库](https://github.com/aymericzip/intlayer/blob/main/docs/docs) 中提出 Issue。
 
 **准备好更快速、更高效地翻译您的应用程序了吗？** 立即深入我们的文档，开始使用 Intlayer。体验一个强大且精简的国际化方法，让您的内容井井有条，并提高您的团队工作效率。
-
-### 为什么选择 Intlayer 而不是其他替代方案？
-
-与 `next-intl` 或 `i18next` 等主流解决方案相比，Intlayer 是一个自带多项集成的优化方案，例如：
-
-**捆绑体积 (Bundle Size)**
-
-您无需在页面中加载庞大的 JSON 文件，而是只加载所需的内容。Intlayer 可以帮助 **将您的捆绑包和页面大小减小多达 50%**。
-
-**可维护性**
-
-将您的应用程序内容局限在相应范围内，**有助于维护**大规模的应用程序。您可以复制或删除单个功能文件夹，而不会有审查整个内容代码库的心理负担。此外，Intlayer 是 **完全类型化 (fully typed)** 的，这能够确保您的内容的准确性。
-
-**AI Agent 支持**
-
-将内容同位放置 **减少了所需的上下文**，这非常适合大型语言模型 (LLM)。Intlayer 还附带一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/mcp_server.md)** 以及 **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，旨在让 AI 代理的开发者体验 (DX) 变得更加顺畅。
-
-**自动化**
-
-使用您选择的 LLM 并在由您的 AI 提供商承担费用的情况下，通过自动化在您的 CI/CD 管道中进行翻译。Intlayer 还提供了一个 **编译器**，可自动提取内容；并配备了一个 [Web 平台](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md) 以帮助您 **在后台执行翻译**。
-
-**性能表现 (Performance)**
-
-将庞大的 JSON 文件连接到组件，可能会导致性能与响应式问题。Intlayer 会在构建时优化您的内容加载。
-
-**无需开发人员的规模化运作 (Scaling with non-dev)**
-
-Intlayer 不仅仅是一个简单的 i18n 解决方案。它还提供了一个 **支持自托管的[可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)** 以及一个 **[完整的 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)**。借此，您可以 **实时** 管理多语言内容，并让译者、文案及其他团队成员之间的协作变得无缝。内容可以存储在本地和/或远程服务器上。

package/docs/zh-TW/intlayer_with_angular_21.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2026-05-31
-title: Angular i18n - 完整翻譯指南： Angular 21
-description: 最佳的包體積、SEO、效能和可維護性解決方案。讓您的 Angular 21 應用程式在 2026 年實現多語言化，LLM 翻譯，Agent Skills & MCP。
+title: "Angular 21 i18n - 翻譯您的應用程式的完整指南"
+description: "告別 i18next。2026 年建構多語言 (i18n) Angular 21 應用程式的完整指南。使用 AI 代理翻譯並優化套件大小、SEO 和效能。"
 keywords:
   - 國際化
   - 文件
@@ -369,6 +369,10 @@ export class AppComponent {
 }
 ```
 
+</Step>
+
+</Steps>
+
 ### 配置TypeScript
 
 Intlayer使用模組擴充（Module Augmentation）來獲得TypeScript的好處，並使您的程式碼庫更健壯。
@@ -422,7 +426,3 @@ Intlayer使用模組擴充（Module Augmentation）來獲得TypeScript的好處
 想要深入了解，您可以實現[視覺化編輯器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/intlayer_visual_editor.md)或使用[CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/intlayer_CMS.md)外部化您的內容。
 
 ---
-
-</Step>
-
-</Steps>

package/docs/zh-TW/introduction.md

@@ -89,6 +89,49 @@ export const MyComponent: FC = () => {
 };
 ```
 
+### 為什麼選擇 Intlayer 而不是其他替代方案？
+
+與 `next-intl` 或 `i18next` 等主流解決方案相比，Intlayer 是一個自帶多項整合最佳化方案的工具，例如：
+
+<AccordionGroup>
+
+<Accordion header="打包體積 (Bundle Size)">
+
+您無需在頁面中載入龐大的 JSON 檔案，而是只載入所需的內容。Intlayer 可以幫助 **將您的打包檔和頁面大小減小高達 50%**。
+
+</Accordion>
+
+<Accordion header="可維護性">
+
+將您的應用程式內容侷限在相應範圍內，**有助於維護**大規模的應用程式。您可以複製或刪除單一功能資料夾，而不會有審查整個內容程式碼庫的心理負擔。此外，Intlayer 是 **完全型別化 (fully typed)** 的，這能夠確保您內容的準確性。
+
+</Accordion>
+
+<Accordion header="AI Agent 支援">
+
+將內容同位放置 **減少了所需的上下文**，這非常適合大型語言模型 (LLM)。Intlayer 還附帶一套工具，例如用於測試缺失翻譯的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/mcp_server.md)** 以及 **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/agent_skills.md)**，旨在讓 AI 代理的開發者體驗 (DX) 變得更加順暢。
+
+</Accordion>
+
+<Accordion header="自動化">
+
+使用您選擇的 LLM 並在由您的 AI 提供者承擔費用的情況下，透過自動化在您的 CI/CD 管道中進行翻譯。Intlayer 還提供了一個 **編譯器**，可自動提取內容；並配備了一個 [Web 平台](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/intlayer_CMS.md) 以幫助您 **在背景執行翻譯**。
+
+</Accordion>
+
+<Accordion header="效能表現 (Performance)">
+
+將龐大的 JSON 檔案連接到元件，可能會導致效能與響應式問題。Intlayer 會在建置時最佳化您的內容載入。
+
+</Accordion>
+
+<Accordion header="無需開發人員的規模化運作 (Scaling with non-dev)">
+
+Intlayer 不僅僅是一個簡單的 i18n 解決方案。它還提供了一個 **支援自託管的[視覺化編輯器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/intlayer_visual_editor.md)** 以及一個 **[完整的 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/intlayer_CMS.md)**。藉此，您可以 **即時** 管理多語言內容，並讓譯者、文案及其他團隊成員之間的協作變得無縫。內容可以儲存在本地和/或遠端伺服器上。
+
+</Accordion>
+</AccordionGroup>
+
 ## 主要功能
 
 Intlayer 提供了多種功能，旨在滿足現代 Web 開發的需求。以下是主要功能，以及每個功能的詳細文件連結：
@@ -162,31 +205,3 @@ Intlayer 提供了多種功能，旨在滿足現代 Web 開發的需求。以下
 我們非常重視開源和社群驅動開發的力量。如果您想提出改進建議、新增指南或糾正我們文件中的任何問題，請隨時提交 Pull Request 或在我們的 [GitHub 儲存庫](https://github.com/aymericzip/intlayer/blob/main/docs/docs) 中提出 Issue。
 
 **準備好更快速、更高效地翻譯您的應用程式了嗎？** 立即深入我們的文件，開始使用 Intlayer。體驗一個強大且精簡的國際化方法，讓您的內容井井有條，並提高您的團隊工作效率。
-
-### 為什麼選擇 Intlayer 而不是其他替代方案？
-
-與 `next-intl` 或 `i18next` 等主流解決方案相比，Intlayer 是一個自帶多項整合最佳化方案的工具，例如：
-
-**打包體積 (Bundle Size)**
-
-您無需在頁面中載入龐大的 JSON 檔案，而是只載入所需的內容。Intlayer 可以幫助 **將您的打包檔和頁面大小減小高達 50%**。
-
-**可維護性**
-
-將您的應用程式內容侷限在相應範圍內，**有助於維護**大規模的應用程式。您可以複製或刪除單一功能資料夾，而不會有審查整個內容程式碼庫的心理負擔。此外，Intlayer 是 **完全型別化 (fully typed)** 的，這能夠確保您內容的準確性。
-
-**AI Agent 支援**
-
-將內容同位放置 **減少了所需的上下文**，這非常適合大型語言模型 (LLM)。Intlayer 還附帶一套工具，例如用於測試缺失翻譯的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/mcp_server.md)** 以及 **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/agent_skills.md)**，旨在讓 AI 代理的開發者體驗 (DX) 變得更加順暢。
-
-**自動化**
-
-使用您選擇的 LLM 並在由您的 AI 提供者承擔費用的情況下，透過自動化在您的 CI/CD 管道中進行翻譯。Intlayer 還提供了一個 **編譯器**，可自動提取內容；並配備了一個 [Web 平台](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/intlayer_CMS.md) 以幫助您 **在背景執行翻譯**。
-
-**效能表現 (Performance)**
-
-將龐大的 JSON 檔案連接到元件，可能會導致效能與響應式問題。Intlayer 會在建置時最佳化您的內容載入。
-
-**無需開發人員的規模化運作 (Scaling with non-dev)**
-
-Intlayer 不僅僅是一個簡單的 i18n 解決方案。它還提供了一個 **支援自託管的[視覺化編輯器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/intlayer_visual_editor.md)** 以及一個 **[完整的 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/intlayer_CMS.md)**。藉此，您可以 **即時** 管理多語言內容，並讓譯者、文案及其他團隊成員之間的協作變得無縫。內容可以儲存在本地和/或遠端伺服器上。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "8.11.3",
+  "version": "8.12.0-canary.0",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -72,13 +72,13 @@
     "watch": "webpack --config ./webpack.config.ts --watch"
   },
   "dependencies": {
-    "@intlayer/config": "8.11.3",
-    "@intlayer/core": "8.11.3",
-    "@intlayer/types": "8.11.3"
+    "@intlayer/config": "8.12.0-canary.0",
+    "@intlayer/core": "8.12.0-canary.0",
+    "@intlayer/types": "8.12.0-canary.0"
   },
   "devDependencies": {
-    "@intlayer/api": "8.11.3",
-    "@intlayer/cli": "8.11.3",
+    "@intlayer/api": "8.12.0-canary.0",
+    "@intlayer/cli": "8.12.0-canary.0",
     "@types/node": "25.9.1",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
@@ -87,7 +87,7 @@
     "rimraf": "6.1.3",
     "tsdown": "0.22.1",
     "typescript": "6.0.3",
-    "vitest": "4.1.7"
+    "vitest": "4.1.8"
   },
   "engines": {
     "node": ">=14.18"

package/src/common.ts

@@ -44,7 +44,7 @@ export const getFile = async <
   const file = await files[docKey]?.[locale];
 
   if (!file) {
-    const englishFile = await files[docKey][defaultLocale as LocalesValues];
+    const englishFile = await files[docKey]?.[defaultLocale as LocalesValues];
 
     if (!englishFile) {
       throw new Error(`File ${docKey as string} not found`);