mm_expand 1.9.5 → 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/package.json

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

package/test/array_test.js

@@ -1,167 +0,0 @@
-/**
- * @description array.js 测试文件
- */
-
-// 导入array.js模块，它会自动扩展Array.prototype
-require('../lib/array.js');
-
-/**
- * @description 运行 array.js 测试
- * @returns {Object} 测试结果
- */
-async function run() {
-    let total = 0;
-    let passed = 0;
-    let failed = 0;
-    
-    console.log('开始测试 array.js...');
-    
-    // 测试 Array.prototype.toTree
-    total++;
-    try {
-        const arr = [
-            { id: 1, name: '节点1', father_id: 0 },
-            { id: 2, name: '节点2', father_id: 1 },
-            { id: 3, name: '节点3', father_id: 1 }
-        ];
-        const result = arr.toTree('id', 0);
-        if (result.length === 1 && result[0].sub.length === 2) {
-            console.log('✅ Array.prototype.toTree: 通过');
-            passed++;
-        } else {
-            console.log('❌ Array.prototype.toTree: 失败');
-            failed++;
-        }
-    } catch (error) {
-        console.log('❌ Array.prototype.toTree: 异常 -', error.message);
-        failed++;
-    }
-    
-    // 测试 Array.prototype.toList
-    total++;
-    try {
-        const arr = [
-            { id: 1, name: '节点1', sub: [
-                { id: 2, name: '节点2' },
-                { id: 3, name: '节点3' }
-            ]}
-        ];
-        const result = arr.toList();
-        if (result.length === 3) {
-            console.log('✅ Array.prototype.toList: 通过');
-            passed++;
-        } else {
-            console.log('❌ Array.prototype.toList: 失败');
-            failed++;
-        }
-    } catch (error) {
-        console.log('❌ Array.prototype.toList: 异常 -', error.message);
-        failed++;
-    }
-    
-    // 测试 Array.prototype.copy
-    total++;
-    try {
-        const arr = [1, 2, 3];
-        const result = arr.copy();
-        if (result.length === 3 && result !== arr) {
-            console.log('✅ Array.prototype.copy: 通过');
-            passed++;
-        } else {
-            console.log('❌ Array.prototype.copy: 失败');
-            failed++;
-        }
-    } catch (error) {
-        console.log('❌ Array.prototype.copy: 异常 -', error.message);
-        failed++;
-    }
-    
-    // 测试 Array.prototype.toStr
-    total++;
-    try {
-        const arr = [1, 2, 3];
-        const result = arr.toStr(',');
-        if (result === '1,2,3') {
-            console.log('✅ Array.prototype.toStr: 通过');
-            passed++;
-        } else {
-            console.log('❌ Array.prototype.toStr: 失败');
-            failed++;
-        }
-    } catch (error) {
-        console.log('❌ Array.prototype.toStr: 异常 -', error.message);
-        failed++;
-    }
-    
-    // 测试 Array.prototype.clear
-    total++;
-    try {
-        const arr = [1, 2, 3];
-        const result = arr.clear();
-        if (result.length === 0 && arr.length === 0) {
-            console.log('✅ Array.prototype.clear: 通过');
-            passed++;
-        } else {
-            console.log('❌ Array.prototype.clear: 失败');
-            failed++;
-        }
-    } catch (error) {
-        console.log('❌ Array.prototype.clear: 异常 -', error.message);
-        failed++;
-    }
-    
-    // 测试 Array.prototype.has
-    total++;
-    try {
-        const arr = [{ id: 1, name: 'test1' }, { id: 2, name: 'test2' }];
-        const result1 = arr.has({ id: 1 });
-        const result2 = arr.has({ id: 3 });
-        if (result1 === true && result2 === false) {
-            console.log('✅ Array.prototype.has: 通过');
-            passed++;
-        } else {
-            console.log('❌ Array.prototype.has: 失败');
-            failed++;
-        }
-    } catch (error) {
-        console.log('❌ Array.prototype.has: 异常 -', error.message);
-        failed++;
-    }
-    
-    // 测试 Array.prototype.toObj
-    total++;
-    try {
-        const arr = [{ id: 1, name: 'test1' }, { id: 2, name: 'test2' }];
-        const result = arr.toObj('id');
-        if (result[1].name === 'test1' && result[2].name === 'test2') {
-            console.log('✅ Array.prototype.toObj: 通过');
-            passed++;
-        } else {
-            console.log('❌ Array.prototype.toObj: 失败');
-            failed++;
-        }
-    } catch (error) {
-        console.log('❌ Array.prototype.toObj: 异常 -', error.message);
-        failed++;
-    }
-    
-    console.log(`array.js 测试完成: 通过 ${passed}/${total} 个测试`);
-    
-    return {
-        total,
-        passed,
-        failed
-    };
-}
-
-module.exports = {
-    run
-};
-
-// 如果直接运行此文件，则执行测试
-if (require.main === module) {
-    run().then(result => {
-        console.log('测试结果:', result);
-        process.exit(result.failed > 0 ? 1 : 0);
-    }).catch(console.error);
-}

package/test/base_test.js

@@ -1,87 +0,0 @@
-/**
- * @description base.js 测试文件
- */
-
-const { Base } = require('../lib/base.js');
-
-/**
- * @description 运行 base.js 测试
- * @returns {Object} 测试结果
- */
-async function run() {
-    let total = 0;
-    let passed = 0;
-    let failed = 0;
-    
-    console.log('开始测试 base.js...');
-    
-    // 测试 Base 类构造函数
-    total++;
-    try {
-        const base = new Base({ name: 'test', version: '1.0.0' });
-        if (base.config.name === 'test' && base.config.version === '1.0.0') {
-            console.log('✅ Base 构造函数: 通过');
-            passed++;
-        } else {
-            console.log('❌ Base 构造函数: 失败');
-            failed++;
-        }
-    } catch (error) {
-        console.log('❌ Base 构造函数: 异常 -', error.message);
-        failed++;
-    }
-    
-    // 测试 setConfig 方法
-    total++;
-    try {
-        const base = new Base({ name: 'test' });
-        base.setConfig({ version: '2.0.0', status: 'active' });
-        if (base.config.version === '2.0.0' && base.config.status === 'active') {
-            console.log('✅ Base.prototype.setConfig: 通过');
-            passed++;
-        } else {
-            console.log('❌ Base.prototype.setConfig: 失败');
-            failed++;
-        }
-    } catch (error) {
-        console.log('❌ Base.prototype.setConfig: 异常 -', error.message);
-        failed++;
-    }
-    
-    // 测试 init 方法
-    total++;
-    try {
-        const base = new Base({ name: 'test' });
-        const result = await base.init('arg1', 'arg2');
-        if (result === base) {
-            console.log('✅ Base.prototype.init: 通过');
-            passed++;
-        } else {
-            console.log('❌ Base.prototype.init: 失败');
-            failed++;
-        }
-    } catch (error) {
-        console.log('❌ Base.prototype.init: 异常 -', error.message);
-        failed++;
-    }
-    
-    console.log(`base.js 测试完成: 通过 ${passed}/${total} 个测试`);
-    
-    return {
-        total,
-        passed,
-        failed
-    };
-}
-
-module.exports = {
-    run
-};
-
-// 如果直接运行此文件，则执行测试
-if (require.main === module) {
-    run().then(result => {
-        console.log('测试结果:', result);
-        process.exit(result.failed > 0 ? 1 : 0);
-    }).catch(console.error);
-}

package/test/comprehensive_test.js

@@ -1,185 +0,0 @@
-const { Card, Player, SanguoshaCompleteSystem } = require('./sanguosha_complete_system.js');
-
-/**
- * @description 全面测试三国杀系统
- */
-async function comprehensive_test() {
-    console.log('=== 全面的三国杀系统测试 ===\n');
-    
-    // 创建玩家
-    const liubei = new Player({ 
-        id: 'p1', 
-        name: '刘备', 
-        hp: 4, 
-        max_hp: 4,
-        hand_cards: [],
-        position: 1 
-    });
-    
-    const caocao = new Player({ 
-        id: 'p2', 
-        name: '曹操', 
-        hp: 4, 
-        max_hp: 4,
-        hand_cards: [],
-        position: 3 
-    });
-    
-    // 创建卡牌
-    const attack_card = new Card({ 
-        id: 'c1', 
-        name: '杀', 
-        type: 'attack', 
-        effect: 'damage', 
-        value: 1,
-        range: 2 
-    });
-    
-    const heal_card = new Card({ 
-        id: 'c2', 
-        name: '桃', 
-        type: 'basic', 
-        effect: 'heal', 
-        value: 1,
-        range: 0 
-    });
-    
-    const draw_card = new Card({ 
-        id: 'c3', 
-        name: '无中生有', 
-        type: 'magic', 
-        effect: 'draw', 
-        value: 2,
-        range: 0 
-    });
-    
-    // 给玩家发牌
-    liubei.addHandCard(attack_card);
-    liubei.addHandCard(heal_card);
-    liubei.addHandCard(draw_card);
-    
-    console.log('初始状态:');
-    console.log('刘备手牌数量:', liubei.getHandCardCount());
-    console.log('曹操手牌数量:', caocao.getHandCardCount());
-    console.log('刘备血量:', liubei.config.hp);
-    console.log('曹操血量:', caocao.config.hp);
-    
-    // 创建系统实例
-    const system = new SanguoshaCompleteSystem({ 
-        players: [liubei, caocao],
-        cache_enabled: true,
-        performance_monitoring: true
-    });
-    
-    // 测试1: 普通攻击
-    console.log('\n1. 普通攻击测试:');
-    console.log('攻击前 - 曹操血量:', caocao.config.hp);
-    
-    try {
-        const result1 = await system.useCard({
-            card: attack_card,
-            user: liubei,
-            target: caocao
-        });
-        
-        console.log('攻击后 - 曹操血量:', caocao.config.hp);
-        console.log('使用结果:', result1);
-        console.log('刘备手牌数量:', liubei.getHandCardCount());
-    } catch (error) {
-        console.error('攻击失败:', error.message);
-    }
-    
-    // 测试2: 有效治疗测试（先让曹操受伤，然后刘备对自己治疗）
-    console.log('\n2. 有效治疗测试:');
-    
-    // 先让曹操受伤
-    caocao.config.hp = 2;
-    console.log('曹操受伤后血量:', caocao.config.hp);
-    console.log('治疗前 - 刘备血量:', liubei.config.hp);
-    
-    try {
-        const result2 = await system.useCard({
-            card: heal_card,
-            user: liubei,
-            target: liubei
-        });
-        
-        console.log('治疗后 - 刘备血量:', liubei.config.hp);
-        console.log('使用结果:', result2);
-        console.log('刘备手牌数量:', liubei.getHandCardCount());
-    } catch (error) {
-        console.error('治疗失败:', error.message);
-    }
-    
-    // 测试3: 抽牌效果测试
-    console.log('\n3. 抽牌效果测试:');
-    console.log('使用前 - 刘备手牌数量:', liubei.getHandCardCount());
-    
-    try {
-        const result3 = await system.useCard({
-            card: draw_card,
-            user: liubei,
-            target: liubei
-        });
-        
-        console.log('使用后 - 刘备手牌数量:', liubei.getHandCardCount());
-        console.log('使用结果:', result3);
-    } catch (error) {
-        console.error('抽牌失败:', error.message);
-    }
-    
-    // 测试4: 距离测试
-    console.log('\n4. 距离测试:');
-    const distance = await system.calculateDistance(liubei, caocao);
-    console.log('刘备到曹操的距离:', distance);
-    
-    // 测试5: 性能统计
-    console.log('\n5. 性能统计:');
-    const stats = system.getPerformanceStats();
-    console.log('统计信息:', stats);
-    
-    console.log('\n=== 全面测试完成 ===');
-}
-
-/**
- * @description 运行全面测试
- * @returns {Object} 测试结果
- */
-async function run() {
-    let total = 0;
-    let passed = 0;
-    let failed = 0;
-    
-    console.log('开始测试 comprehensive_test.js...');
-    
-    try {
-        await comprehensive_test();
-        console.log('✅ 全面测试: 通过');
-        passed++;
-    } catch (error) {
-        console.log('❌ 全面测试: 失败 -', error.message);
-        failed++;
-    }
-    
-    total++;
-    
-    console.log(`comprehensive_test.js 测试完成: 通过 ${passed}/${total} 个测试`);
-    
-    return {
-        total,
-        passed,
-        failed
-    };
-}
-
-module.exports = {
-    run
-};
-
-// 如果直接运行此文件，则执行测试
-if (require.main === module) {
-    run().then(result => {
-        console.log('测试结果:', result);
-        process.exit(result.failed > 0 ? 1 : 0);
-    }).catch(console.error);
-}