mm_expand 1.9.4 → 1.9.6

package/README.md

@@ -82,6 +82,70 @@ $.eventer.pause('user:*'); // 暂停所有用户相关事件
 $.eventer.resume('user:*'); // 恢复所有用户相关事件
 ```
 
+## 模块导出
+
+本库提供多种导出方式，支持按需导入和使用：
+
+### 全局对象方式（推荐）
+```javascript
+const $ = require('mm_expand');
+// 使用全局对象调用所有功能
+$.copy({ a: 1 }); // 对象深拷贝
+$.eventer.on('event', handler); // 事件监听
+```
+
+### 按需导入方式
+```javascript
+// 导入核心类
+const { Event, Eventer, Lang, Base, File, Dir } = require('mm_expand');
+
+// 导入对象操作函数
+const { as, push, clear, toJson, copy, get, set } = require('mm_expand/lib/object.js');
+
+// 导入数组构造函数
+const { Array } = require('mm_expand/lib/array.js');
+
+// 导入其他功能模块
+const { Log } = require('mm_expand/lib/log.js');
+const { Timer } = require('mm_expand/lib/timer.js');
+```
+
+### 主要导出模块
+
+#### 核心类（index.js导出）
+- **Event**: 事件类，用于创建和管理事件实例
+- **Eventer**: 事件驱动类，提供完整的事件系统功能
+- **Lang**: 语言包类，支持多语言国际化
+- **Base**: 基础类，提供类创建和继承功能
+- **File**: 文件操作类，提供文件读写功能
+- **Dir**: 目录操作类，提供目录管理功能
+
+#### 对象操作函数（object.js导出）
+- **as**: 判断对象是否相似
+- **push**: 合并对象属性
+- **clear**: 清空对象值
+- **toJson**: 对象转JSON字符串
+- **toXml**: 对象转XML字符串
+- **toUrl**: 对象转URL参数字符串
+- **saveJson**: 对象保存为JSON文件
+- **saveXml**: 对象保存为XML文件
+- **copy**: 深度拷贝对象
+- **keys**: 获取对象属性名
+- **getInfo**: 获取对象详细信息
+- **add**: 添加对象属性
+- **del**: 删除对象属性
+- **set**: 修改对象属性
+- **get**: 查询对象属性
+- **prop**: 遍历读写对象属性
+- **arrToObj**: 数组转对象
+
+#### 数组构造函数（array.js导出）
+- **Array**: 增强的数组构造函数，包含所有数组原型扩展方法
+
+#### 其他功能模块
+- **Log**: 日志类，提供日志记录功能
+- **Timer**: 定时器类，提供定时任务功能
+
 ## API文档
 
 ### 全局工具函数
@@ -624,7 +688,7 @@ A: 目前提供基本的JavaScript支持，TypeScript类型定义正在规划中
 ## npm发布信息
 
 ### 发布状态
-- **当前版本**: 1.9.3
+- **当前版本**: 1.9.6
 - **npm包名**: mm_expand
 - **发布状态**: 已准备发布
 

package/README_EN.md

@@ -108,6 +108,70 @@ $.eventer.pause('user:*'); // Pause all user-related events
 $.eventer.resume('user:*'); // Resume all user-related events
 ```
 
+## Module Exports
+
+This library provides multiple export methods supporting on-demand import and usage:
+
+### Global Object Method (Recommended)
+```javascript
+const $ = require('mm_expand');
+// Use global object to access all functionality
+$.copy({ a: 1 }); // Object deep copy
+$.eventer.on('event', handler); // Event listening
+```
+
+### On-demand Import Method
+```javascript
+// Import core classes
+const { Event, Eventer, Lang, Base, File, Dir } = require('mm_expand');
+
+// Import object operation functions
+const { as, push, clear, toJson, copy, get, set } = require('mm_expand/lib/object.js');
+
+// Import array constructor
+const { Array } = require('mm_expand/lib/array.js');
+
+// Import other functional modules
+const { Log } = require('mm_expand/lib/log.js');
+const { Timer } = require('mm_expand/lib/timer.js');
+```
+
+### Main Export Modules
+
+#### Core Classes (index.js exports)
+- **Event**: Event class for creating and managing event instances
+- **Eventer**: Event-driven class providing complete event system functionality
+- **Lang**: Language pack class supporting multilingual internationalization
+- **Base**: Base class providing class creation and inheritance functionality
+- **File**: File operation class providing file read/write functionality
+- **Dir**: Directory operation class providing directory management functionality
+
+#### Object Operation Functions (object.js exports)
+- **as**: Determine if objects are similar
+- **push**: Merge object properties
+- **clear**: Clear object values
+- **toJson**: Convert object to JSON string
+- **toXml**: Convert object to XML string
+- **toUrl**: Convert object to URL parameter string
+- **saveJson**: Save object as JSON file
+- **saveXml**: Save object as XML file
+- **copy**: Deep copy object
+- **keys**: Get object property names
+- **getInfo**: Get object detailed information
+- **add**: Add object properties
+- **del**: Delete object properties
+- **set**: Modify object properties
+- **get**: Query object properties
+- **prop**: Traverse and read/write object properties
+- **arrToObj**: Convert array to object
+
+#### Array Constructor (array.js exports)
+- **Array**: Enhanced array constructor containing all array prototype extension methods
+
+#### Other Functional Modules
+- **Log**: Log class providing logging functionality
+- **Timer**: Timer class providing scheduled task functionality
+
 ## API Documentation
 
 ### Global Utility Functions
@@ -630,7 +694,7 @@ Welcome to submit Issues and Pull Requests! Please ensure your code follows thes
 4. Run tests before submitting to ensure no new issues are introduced
 
 ## Release Status
-- **Current Version**: 1.9.3
+- **Current Version**: 1.9.6
 - **npm Package Name**: mm_expand
 - **Release Status**: Ready for release
 

package/index.js

@@ -15,36 +15,17 @@ require('./lib/array.js');
 // 日期原型函数
 require('./lib/date.js');
 
-// 确保原型方法被应用到全局原型
-const numberModule = require('./lib/number.js');
-const stringModule = require('./lib/string.js');
-const arrayModule = require('./lib/array.js');
-const dateModule = require('./lib/date.js');
-
-// 应用原型方法到全局原型
-if (global.Number && numberModule.Number) {
-    Object.assign(global.Number.prototype, numberModule.Number.prototype);
-}
-if (global.String && stringModule.String) {
-    Object.assign(global.String.prototype, stringModule.String.prototype);
-}
-if (global.Array && arrayModule.Array) {
-    Object.assign(global.Array.prototype, arrayModule.Array.prototype);
-}
-if (global.Date && dateModule.Date) {
-    Object.assign(global.Date.prototype, dateModule.Date.prototype);
-}
-
 var { File, Dir } = require('./lib/file.js');
-var { Obj } = require('./lib/object.js');
 var { Log } = require('./lib/log.js');
 var { Eventer } = require('./lib/eventer.js');
 var { Lang } = require('./lib/lang.js');
+var { Event } = require('./lib/event.js');
 var { Base } = require('./lib/base.js');
 var { Timer } = require('./lib/timer.js');
 
+
 if (global.$ && !$.is_init) {
-	Object.assign($, Obj, {
+	Object.assign($, require('./lib/object.js'), {
 		// 基础类
 		Base,
 		// 文件类
@@ -70,9 +51,11 @@ if (global.$ && !$.is_init) {
 	$.is_init = true;
 }
 
-exports.Obj = Obj;
-exports.Eventer = Eventer;
-exports.Lang = Lang;
-exports.Base = Base;
-exports.File = File;
-exports.Dir = Dir;
+module.exports = {
+	Event,
+	Eventer,
+	Lang,
+	Base,
+	File,
+	Dir
+}

package/lib/array.js

@@ -1,5 +1,5 @@
 /* == 数组原型函数 == */
-const { as } = require('./object.js').Obj;
+const { as } = require('./object.js');
 
 /**
  * 列表转树形列表

package/lib/object.js

@@ -586,7 +586,7 @@ function prop(source, path, target) {
     return current;
 }
 
-exports.Obj = {
+module.exports = {
     // 判断对象是否相似
     as,
     // 添加对象

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mm_expand",
-	"version": "1.9.4",
+	"version": "1.9.6",
 	"description": "这是超级美眉原型函数拓展模块，更有利于对string、array、object的操作，避免出错，简化业务逻辑。",
 	"main": "index.js",
 	"scripts": {