gc_i18n 1.4.9 → 1.5.0

package/.qoder/repowiki/zh/content//345/267/245/345/205/267/345/207/275/346/225/260.md

@@ -7,9 +7,17 @@
 - [service.js](file://packages/libs/service.js)
 - [index.js](file://packages/index.js)
 - [textEditMode.js](file://packages/libs/textEditMode.js)
+- [earth.js](file://packages/components/earth.js)
 - [gc_i18n.js](file://lib/gc_i18n.js)
 </cite>
 
+## 更新摘要
+**变更内容**   
+- 更新了 `packages/index.js` 导出结构分析，反映了默认导出和命名导出的双重支持
+- 增强了模块整合与协作关系的说明，突出了新的导出组织方式
+- 补充了组件集成和全局方法的详细说明
+- 更新了国际化工具函数和通用辅助函数的实现细节
+
 ## 目录
 1. [项目结构](#项目结构)
 2. [核心工具模块分析](#核心工具模块分析)
@@ -18,6 +26,7 @@
 5. [RTL语言检测功能](#rtl语言检测功能)
 6. [外部服务接口 (service.js)](#外部服务接口-servicejs)
 7. [模块整合与协作关系](#模块整合与协作关系)
+8. [导出结构优化](#导出结构优化)
 
 ## 项目结构
 
@@ -25,7 +34,7 @@
 
 - `lang` 目录存放语言包配置。
 - `lib` 目录包含核心库文件 `gc_i18n.js` 和样式文件。
-- `packages` 目录是功能模块的核心，其中 `packages/libs` 存放了 `utils.js`、`i18nUtils.ts` 和 `service.js` 三个关键工具模块。
+- `packages` 目录是功能模块的核心，其中 `packages/libs` 存放了 `utils.js`、`i18nUtils.ts` 和 `service.js` 三个关键工具模块，`packages/components` 存放了 `earth.js` 全球组件。
 - `src` 目录是应用源码，包含视图、路由和主入口。
 
 ```mermaid
@@ -36,25 +45,28 @@ A --> |新增| C[RTL语言检测函数]
 D[i18nUtils.ts] --> |提供| E[i18n专用工具]
 F[service.js] --> |提供| G[外部服务接口]
 H[textEditMode.js] --> |提供| I[文本编辑模式]
+J[earth.js] --> |提供| K[全球组件]
 end
 subgraph "入口与整合"
-J[index.js] --> |整合并使用| A
-J --> |整合并使用| D
-J --> |整合并使用| F
-J --> |整合并使用| H
+L[index.js] --> |整合并使用| A
+L --> |整合并使用| D
+L --> |整合并使用| F
+L --> |整合并使用| H
+L --> |整合并使用| J
 end
 subgraph "核心库"
-K[gc_i18n.js] --> |定义| L[Po, Mo, Pa, qn等函数]
-J --> |依赖| K
+M[gc_i18n.js] --> |定义| N[Po, Mo, Pa, qn等函数]
+L --> |依赖| M
 end
 subgraph "应用层"
-M[src] --> |使用| J
+O[src] --> |使用| L
 end
-A --> J
-D --> J
-F --> J
-H --> J
-K --> J
+A --> L
+D --> L
+F --> L
+H --> L
+J --> L
+M --> L
 ```
 
 **图示来源**
@@ -62,6 +74,7 @@ K --> J
 - [i18nUtils.ts](file://packages/libs/i18nUtils.ts)
 - [service.js](file://packages/libs/service.js)
 - [textEditMode.js](file://packages/libs/textEditMode.js)
+- [earth.js](file://packages/components/earth.js)
 - [index.js](file://packages/index.js)
 - [gc_i18n.js](file://lib/gc_i18n.js)
 
@@ -71,6 +84,7 @@ K --> J
 - [i18nUtils.ts](file://packages/libs/i18nUtils.ts)
 - [service.js](file://packages/libs/service.js)
 - [textEditMode.js](file://packages/libs/textEditMode.js)
+- [earth.js](file://packages/components/earth.js)
 - [index.js](file://packages/index.js)
 
 ## 核心工具模块分析
@@ -380,7 +394,7 @@ end
 
 ## 模块整合与协作关系
 
-`packages/index.js` 作为主入口文件，负责将 `utils.js`、`i18nUtils.ts`、`service.js` 和 `textEditMode.js` 四个工具模块整合成一个完整的 `I18n` 类。
+`packages/index.js` 作为主入口文件，负责将 `utils.js`、`i18nUtils.ts`、`service.js`、`textEditMode.js` 和 `earth.js` 五个工具模块整合成一个完整的 `I18n` 类。
 
 ### 协作流程
 
@@ -393,7 +407,8 @@ end
 4.  **数据加载**: `getTranslate` 函数在 `service.js` 中定义，但其内部调用的 `Uo`、`qn`、`Mo`、`Po` 等函数实际定义在 `lib/gc_i18n.js` 中，这表明 `service.js` 依赖于核心库。
 5.  **RTL方向更新**: 在语言切换时，系统会重新检测RTL状态并更新文档方向。
 6.  **文本编辑模式**: `textEditMode.js` 提供了额外的文本编辑功能，支持页面和路由级别的翻译管理。
-7.  **最终整合**: `index.js` 将所有功能整合后，通过 `install` 方法注入到Vue应用中，使 `$t` 等全局函数可用。
+7.  **全局组件注册**: `earth.js` 组件通过 `app.component` 注册为全局组件，提供多语言编辑功能。
+8.  **最终整合**: `index.js` 将所有功能整合后，通过 `install` 方法注入到Vue应用中，使 `$t` 等全局函数可用。
 
 ### 关键协作点
 -   `index.js` 使用 `i18nUtils.ts` 进行**键的提取**。
@@ -402,6 +417,7 @@ end
 -   `index.js` 使用 `utils.js` 的 `isRTLLocale` 进行**RTL语言检测**。
 -   `service.js` 依赖 `gc_i18n.js` 提供的底层**网络请求和缓存函数**。
 -   `textEditMode.js` 与 `service.js` 协作，提供**文本编辑和翻译管理**功能。
+-   `earth.js` 与 `service.js` 协作，提供**全局多语言编辑组件**。
 
 ### RTL功能的完整协作链
 ```mermaid
@@ -424,4 +440,102 @@ G --> H[提供isRTL实例方法]
 - [i18nUtils.ts](file://packages/libs/i18nUtils.ts)
 - [service.js](file://packages/libs/service.js)
 - [textEditMode.js](file://packages/libs/textEditMode.js)
-- [gc_i18n.js](file://lib/gc_i18n.js)
+- [earth.js](file://packages/components/earth.js)
+- [gc_i18n.js](file://lib/gc_i18n.js)
+
+## 导出结构优化
+
+`packages/index.js` 的导出结构经过优化，现在同时支持默认导出和命名导出，提供了更好的模块兼容性和使用灵活性。
+
+### 双重导出支持
+
+#### 默认导出
+```javascript
+export default I18n;
+```
+
+#### 命名导出
+```javascript
+export { I18n };
+```
+
+这种设计允许开发者使用多种导入方式：
+
+**ES6 模块导入**：
+```javascript
+import I18n from 'gc_i18n';
+// 或
+import { I18n } from 'gc_i18n';
+```
+
+**CommonJS 导入**：
+```javascript
+const { I18n } = require('gc_i18n');
+// 或
+const I18n = require('gc_i18n').default;
+```
+
+### 模块导入优化
+
+新的导出结构采用了更清晰的模块导入组织：
+
+1. **核心依赖导入**：`keyboardJS`、`vue-demi`、`axios` 等核心依赖
+2. **工具模块导入**：`utils.js`、`i18nUtils.ts`、`textEditMode.js` 的功能函数
+3. **组件导入**：`earth.js` 全球组件和样式文件
+4. **第三方库导入**：`lodash-es`、`store2`、`sweetalert2` 等
+
+### 全局方法和工具函数
+
+优化后的导出结构还增强了全局方法的暴露：
+
+#### 全局翻译函数
+```javascript
+globalThis.$t = (key, defaultValue) => {
+  // 实现翻译逻辑
+};
+```
+
+#### 全局配置函数
+```javascript
+globalThis.$i18nLogin = async (orgCode) => { /* 登录逻辑 */ };
+globalThis.$i18nLogout = (orgCode) => { /* 登出逻辑 */ };
+globalThis.$clearI18n = () => { /* 清理逻辑 */ };
+```
+
+#### RTL检测函数
+```javascript
+globalThis.$isRTL = () => this._isRTL;
+this.i18n.global.isRTL = () => this._isRTL;
+```
+
+### 组件注册优化
+
+新的导出结构改进了全局组件的注册方式：
+
+```javascript
+app.component("i18n-earth", {
+  ...earthVue,
+  props: {
+    ...earthVue.props,
+    baseUrl: {
+      type: String,
+      default: this.baseUrl
+    }
+  }
+});
+```
+
+这种设计确保了组件能够正确接收 `baseUrl` 属性，同时保持了与主应用的兼容性。
+
+### 在整体架构中的作用
+
+优化后的导出结构提升了模块的可复用性和兼容性：
+
+1. **更好的模块兼容性**：支持 ES6、CommonJS、AMD 等多种模块系统
+2. **增强的全局API**：提供了丰富的全局函数供开发者使用
+3. **灵活的组件集成**：简化了全局组件的注册和使用
+4. **清晰的命名空间**：避免了全局变量污染，提供了明确的API接口
+
+**本节来源**
+- [index.js](file://packages/index.js)
+- [earth.js](file://packages/components/earth.js)