@intlayer/docs 7.4.0 → 7.5.0-canary.1

package/docs/zh/cli/login.md

@@ -0,0 +1,182 @@
+---
+createdAt: 2025-12-16
+updatedAt: 2025-12-16
+title: CLI - 登录
+description: 了解如何使用 Intlayer CLI 的 login 命令与 Intlayer CMS 进行身份验证并获取访问凭证。
+keywords:
+  - CLI
+  - 登录
+  - 认证
+  - CMS
+  - Intlayer
+  - 凭证
+slugs:
+  - doc
+  - concept
+  - cli
+  - login
+---
+
+# Intlayer CLI 登录命令
+
+---
+
+## 描述
+
+Intlayer CLI 的 `login` 命令允许您对 Intlayer CMS 进行身份验证。该命令会自动打开您的默认浏览器以完成身份验证流程，并接收使用 Intlayer 服务所需的凭证（Client ID 和 Client Secret）。
+
+## 用法
+
+```bash
+npx intlayer login [options]
+```
+
+或
+
+```bash
+intlayer login [options]
+```
+
+## 选项
+
+### `--cms-url <url>`
+
+指定用于身份验证的 Intlayer CMS 的 URL。
+
+- **类型**: `string`
+- **默认**: 在 `intlayer.config.*` 中配置的值，或 `https://intlayer.org`
+- **示例**:
+
+```bash
+npx intlayer login --cms-url https://intlayer.org
+```
+
+### 配置选项
+
+您还可以使用常见的配置选项：
+
+- `--env-file <path>`：环境文件的路径
+- `-e, --env <env>`：执行环境
+- `--base-dir <dir>`：项目的基目录
+- `--verbose`：启用详细输出（默认：true）
+- `--prefix <prefix>`：日志前缀
+
+## 工作原理
+
+1. **启动本地服务器**：该命令在一个随机端口上启动本地 HTTP 服务器，以从 CMS 接收凭证
+
+指定要用于身份验证的 Intlayer CMS 的 URL。
+
+- **类型**: `string`
+- **默认**: 在 `intlayer.config.*` 中配置的值，或 `https://intlayer.org`
+- **示例**:
+
+```bash
+npx intlayer login --cms-url https://intlayer.org
+```
+
+### 配置选项
+
+您还可以使用常用的配置选项：
+
+- `--env-file <path>`: 环境文件的路径
+- `-e, --env <env>`: 执行环境
+- `--base-dir <dir>`: 项目的基目录
+- `--verbose`: 启用详细输出（默认：true）
+- `--prefix <prefix>`: 日志前缀
+
+## 工作原理
+
+1. **启动本地服务器**：该命令在随机端口启动一个本地 HTTP 服务器以接收来自 CMS 的凭证
+2. **Browser Opening**：该命令会自动在你的默认浏览器中打开 CMS 的登录 URL
+3. **Authentication**：在浏览器中使用你的 Intlayer 帐户完成身份验证
+4. **Credentials Reception**：本地服务器从 CMS 接收 Client ID 和 Client Secret
+5. **Instructions**：该命令显示在项目中配置凭证的说明
+
+## 输出
+
+登录成功后，命令将显示：
+
+1. **接收到的凭证**（Client ID 和 Client Secret）
+2. **`.env` 文件的说明**：
+
+```bash
+INTLAYER_CLIENT_ID=your_client_id
+INTLAYER_CLIENT_SECRET=your_client_secret
+```
+
+3. **Intlayer 配置文件的说明**：
+
+```typescript
+{
+  editor: {
+    cmsURL: 'https://intlayer.org',
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+}
+```
+
+## 手动配置
+
+如果浏览器没有自动打开，您可以手动访问终端中显示的 URL。
+
+## 示例
+
+### 使用自定义 CMS URL 登录
+
+```bash
+npx intlayer login --cms-url https://custom-cms.example.com
+```
+
+### 使用特定环境文件登录
+
+```bash
+npx intlayer login --env-file .env.production
+```
+
+### 以详细模式登录
+
+```bash
+npx intlayer login --verbose
+```
+
+## 故障排除
+
+### 浏览器未打开
+
+如果浏览器没有自动打开，请复制终端中显示的 URL 并在浏览器中手动打开。
+
+### 连接问题
+
+如果遇到连接问题，请验证：
+
+1. 确认 CMS URL 是否正确
+2. 确认您的网络连接正常工作
+3. 确认没有防火墙阻止连接
+
+### 未收到凭证
+
+如果未收到凭证：
+
+1. 确保在浏览器中完成了身份验证流程
+2. 验证本地端口未被阻塞
+3. 重新尝试该命令
+
+## 后续步骤
+
+完成登录后：
+
+1. 将凭证添加到您的 `.env` 文件中
+2. 在 `intlayer.config.*` 文件中配置这些凭证
+3. 使用 CLI 命令管理您的词典：
+   - [`npx intlayer push`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/push.md) - 将词典推送到 CMS
+   - [`npx intlayer pull`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/pull.md) - 从 CMS 拉取词典
+   - [`npx intlayer fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/fill.md) - 填充缺失的翻译
+   - [`npx intlayer fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/fill.md) - 填充缺失的翻译
+
+## 另请参阅
+
+- [CLI 文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/index.md)
+- [Intlayer 配置](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)

package/docs/zh/configuration.md

@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 7.5.0
+    date: 2025-12-17
+    changes: 添加 `buildMode` 选项
   - version: 6.0.0
     date: 2025-09-16
     changes: 添加 `live` 导入模式
@@ -528,6 +531,15 @@ Intlayer 支持多个 AI 提供商，以增强灵活性和选择。目前支持
 
 #### 属性
 
+- **mode**：
+  - _类型_：`'auto' | 'manual'`
+  - _默认值_：`'auto'`
+  - _描述_：控制构建的模式。
+  - _示例_：`'manual'`
+  - _注意_：如果为 'auto'，构建将在应用程序构建时自动启用。
+  - _注意_：如果为 'manual'，构建仅在执行构建命令时设置。
+  - _注意_：可用于禁用字典构建，例如当应避免在 Node.js 环境中执行时。
+
 - **optimize**：
   - _类型_：`boolean`
   - _默认值_：`process.env.NODE_ENV === 'production'`

package/docs/zh/dictionary/content_file.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2025-09-20
+updatedAt: 2025-12-13
 title: 内容文件
 description: 学习如何自定义内容声明文件的扩展。按照本指南高效地在项目中实现条件。
 keywords:
@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 7.5.0
+    date: 2025-12-13
+    changes: 添加 ICU 和 i18next 格式支持
   - version: 6.0.0
     date: 2025-09-20
     changes: 添加字段文档
@@ -386,6 +389,46 @@ Intlayer 中的字典由 `Dictionary` 类型定义，包含多个控制其行为
 }
 ```
 
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+指定用于字典内容的格式化器。这允许使用不同的消息格式化语法。
+
+- `'intlayer'`: 默认的 Intlayer 格式化器。
+- `'icu'`: 使用 ICU 消息格式化。
+- `'i18next'`: 使用 i18next 消息格式化。
+
+**示例：**
+
+```typescript
+{
+  key: "my-dictionary",
+  format: "icu",
+  content: {
+    message: "Hello {name}, you have {count, plural, one {# message} other {# messages}}"
+  }
+}
+```
+
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+指定用于字典内容的格式化器。这允许使用不同的消息格式化语法。
+
+- `'intlayer'`: 默认的 Intlayer 格式化器。
+- `'icu'`: 使用 ICU 消息格式化。
+- `'i18next'`: 使用 i18next 消息格式化。
+
+**示例：**
+
+```typescript
+{
+  key: "my-dictionary",
+  format: "icu",
+  content: {
+    message: "Hello {name}, you have {count, plural, one {# message} other {# messages}}"
+  }
+}
+```
+
 #### `locale` (LocalesValues)
 
 将字典转换为按语言区域划分的字典，其中内容中声明的每个字段将自动转换为翻译节点。当设置此属性时：

package/docs/zh/intlayer_with_astro.md

@@ -2,7 +2,7 @@
 createdAt: 2024-03-07
 updatedAt: 2025-10-03
 title: 如何翻译您的Astro应用 – i18n指南 2025
-description: 学习如何使用 Intlayer 为您的 Vite 和 React 应用添加国际化（i18n）。按照本指南使您的应用支持多语言。
+description: 学习如何使用 Intlayer 为您的 Astro 网站添加国际化（i18n）。按照本指南使您的网站支持多语言。
 keywords:
   - 国际化
   - 文档

package/docs/zh/intlayer_with_express.md

@@ -2,7 +2,7 @@
 createdAt: 2024-08-11
 updatedAt: 2025-06-29
 title: 如何翻译您的Express backend应用 – i18n指南 2025
-description: 了解如何使您的 vite 后端实现多语言。请遵循文档进行国际化（i18n）和翻译。
+description: 了解如何使您的 Express 后端实现多语言。请遵循文档进行国际化（i18n）和翻译。
 keywords:
   - 国际化
   - 文档

package/docs/zh/intlayer_with_nestjs.md

@@ -2,7 +2,7 @@
 createdAt: 2025-09-09
 updatedAt: 2025-09-09
 title: 如何翻译您的Nest backend应用 – i18n指南 2025
-description: 了解如何使你的 vite 后端支持多语言。按照文档进行国际化（i18n）和翻译。
+description: 了解如何使你的 NestJS 后端支持多语言。按照文档进行国际化（i18n）和翻译。
 keywords:
   - 国际化
   - 文档

package/docs/zh/intlayer_with_next-i18next.md

@@ -581,6 +581,7 @@ const config: IntlayerConfig = {
   },
   plugins: [
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `./locales/${locale}.json`,
     }),
   ],

package/docs/zh/intlayer_with_next-intl.md

@@ -421,6 +421,7 @@ const config: IntlayerConfig = {
   plugins: [
     // 保持每个命名空间的文件夹结构与 Intlayer 同步
     syncJSON({
+      format: "icu",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
     }),
   ],

package/docs/zh/intlayer_with_tanstack.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2025-09-09
+updatedAt: 2025-12-11
 title: 如何翻译您的Tanstack Start应用 – i18n指南 2025
 description: 学习如何使用 Intlayer 为您的 Tanstack Start 应用添加国际化 (i18n)。按照本综合指南，使您的应用支持多语言并具备基于区域设置的路由功能。
 keywords:
@@ -625,17 +625,6 @@ export function NotFoundComponent() {
 }
 ```
 
-```tsx fileName="src/routes/__root.tsx"
-import { createRootRoute } from "@tanstack/react-router";
-
-// 根路由作为顶级布局
-// 它不直接处理 404 - 这被委托给子路由
-// 这使根路由保持简单，并让区域设置感知的路由管理自己的 404 逻辑
-export const Route = createRootRoute({
-  component: Outlet,
-});
-```
-
 ```tsx fileName="src/routes/{-$locale}/route.tsx"
 import { createFileRoute, Outlet, redirect } from "@tanstack/react-router";
 import { validatePrefix } from "intlayer";

package/docs/zh/plugins/sync-json.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-03-13
-updatedAt: 2025-10-05
+updatedAt: 2025-12-13
 title: 同步 JSON 插件
 description: 将 Intlayer 字典与第三方 i18n JSON 文件（如 i18next、next-intl、react-intl、vue-i18n 等）同步。保持您现有的 i18n，同时使用 Intlayer 管理、翻译和测试您的消息。
 keywords:
@@ -24,12 +24,15 @@ slugs:
   - sync-json
 youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
 history:
+  - version: 7.5.0
+    date: 2025-12-13
+    changes: 添加 ICU 和 i18next 格式支持
   - version: 6.1.6
     date: 2025-10-05
     changes: 初始同步 JSON 插件文档
 ---
 
-## 同步 JSON（i18n 桥接）
+# 同步 JSON（i18n 桥接）- 支持 ICU / i18next 的同步 JSON
 
 <iframe title="如何保持您的 JSON 翻译与 Intlayer 同步" class="m-auto aspect-[16/9] w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/MpGMxniDHNg?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
@@ -105,9 +108,27 @@ syncJSON({
   source: ({ key, locale }) => string, // 必填
   location?: string, // 可选标签，默认值："plugin"
   priority?: number, // 可选优先级，用于冲突解决，默认值：0
+  format?: 'intlayer' | 'icu' | 'i18next', // 可选格式化器，默认值：'intlayer'
 });
 ```
 
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+指定在同步 JSON 文件时用于字典内容的格式化器。这允许使用与各种 i18n 库兼容的不同消息格式化语法。
+
+- `'intlayer'`: 默认的 Intlayer 格式化器（默认值）。
+- `'icu'`: 使用 ICU 消息格式化（与 react-intl、vue-i18n 等库兼容）。
+- `'i18next'`: 使用 i18next 消息格式化（与 i18next、next-i18next、Solid-i18next 兼容）。
+
+**示例：**
+
+```ts
+syncJSON({
+  source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+  format: "i18next", // 使用 i18next 格式化以保持兼容性
+}),
+```
+
 ## 多个 JSON 源和优先级
 
 你可以添加多个 `syncJSON` 插件来同步不同的 JSON 源。当你的项目中使用多个 i18n 库或有不同的 JSON 结构时，这非常有用。
@@ -134,6 +155,7 @@ export default defineConfig({
   plugins: [
     // 主要 JSON 源（最高优先级）
     syncJSON({
+      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
       location: "main-translations",
       priority: 10,
@@ -141,6 +163,7 @@ export default defineConfig({
 
     // 备用 JSON 源（较低优先级）
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `./fallback-locales/${locale}.json`,
       location: "fallback-translations",
       priority: 5,
@@ -148,6 +171,7 @@ export default defineConfig({
 
     // 旧版 JSON 源（最低优先级）
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `/my/other/app/legacy/${locale}/messages.json`,
       location: "legacy-translations",
       priority: 1,
@@ -178,6 +202,7 @@ import { syncJSON } from "@intlayer/sync-json-plugin";
 export default {
   plugins: [
     syncJSON({
+      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
     }),
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "7.4.0",
+  "version": "7.5.0-canary.1",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -73,23 +73,23 @@
     "watch": "webpack --config ./webpack.config.ts --watch"
   },
   "dependencies": {
-    "@intlayer/config": "7.4.0",
-    "@intlayer/core": "7.4.0",
-    "@intlayer/types": "7.4.0"
+    "@intlayer/config": "7.5.0-canary.1",
+    "@intlayer/core": "7.5.0-canary.1",
+    "@intlayer/types": "7.5.0-canary.1"
   },
   "devDependencies": {
-    "@intlayer/api": "7.4.0",
-    "@intlayer/cli": "7.4.0",
-    "@types/node": "24.10.1",
+    "@intlayer/api": "7.5.0-canary.1",
+    "@intlayer/cli": "7.5.0-canary.1",
+    "@types/node": "25.0.2",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",
     "fast-glob": "3.3.3",
     "rimraf": "6.1.2",
-    "tsdown": "0.16.8",
+    "tsdown": "0.18.0",
     "tsx": "^4.20.6",
     "typescript": "5.9.3",
-    "vitest": "4.0.15"
+    "vitest": "4.0.16"
   },
   "engines": {
     "node": ">=14.18"

package/src/generated/docs.entry.ts

@@ -300,6 +300,25 @@ export const docsEntry = {
     id: readLocale('cli/live.md', 'id'),
     vi: readLocale('cli/live.md', 'vi'),
   } as unknown as Record<LocalesValues, Promise<string>>,
+  './docs/en/cli/login.md': {
+    en: readLocale('cli/login.md', 'en'),
+    ru: readLocale('cli/login.md', 'ru'),
+    ja: readLocale('cli/login.md', 'ja'),
+    fr: readLocale('cli/login.md', 'fr'),
+    ko: readLocale('cli/login.md', 'ko'),
+    zh: readLocale('cli/login.md', 'zh'),
+    es: readLocale('cli/login.md', 'es'),
+    de: readLocale('cli/login.md', 'de'),
+    ar: readLocale('cli/login.md', 'ar'),
+    it: readLocale('cli/login.md', 'it'),
+    'en-GB': readLocale('cli/login.md', 'en-GB'),
+    pt: readLocale('cli/login.md', 'pt'),
+    hi: readLocale('cli/login.md', 'hi'),
+    tr: readLocale('cli/login.md', 'tr'),
+    pl: readLocale('cli/login.md', 'pl'),
+    id: readLocale('cli/login.md', 'id'),
+    vi: readLocale('cli/login.md', 'vi'),
+  } as unknown as Record<LocalesValues, Promise<string>>,
   './docs/en/cli/pull.md': {
     en: readLocale('cli/pull.md', 'en'),
     ru: readLocale('cli/pull.md', 'ru'),