mm_expand 1.9.8 → 2.0.0

package/README.md

@@ -11,6 +11,24 @@ mm_expand 是一个功能丰富的 JavaScript 工具库，为原生类型（Stri
 
 这个库通过扩展 JavaScript 原生对象的原型链，提供了丰富的数据操作方法，使开发者能够用更简洁的代码处理常见的数据操作任务。同时，它还包含了强大的事件系统、文件操作工具和对象处理功能，适用于各种 JavaScript 应用场景。
 
+### 最新功能更新（v1.9.9）
+
+#### ECS架构支持
+- **组件操作增强**：新增 `add`、`set`、`del`、`get` 方法，专门为游戏ECS（Entity Component System）架构设计
+- **路径支持**：支持点分隔符和数组路径访问嵌套属性
+- **覆盖控制**：所有方法支持 `overwrite` 参数，控制是否修改原对象
+- **默认值补全**：`get` 方法支持对象默认值补全，确保组件属性完整性
+
+#### 对象操作增强
+- **Object.prototype扩展**：为所有对象添加原型方法，包括 `keys`、`getInfo`、`add`、`del`、`set`、`get` 等
+- **类型安全**：所有方法都包含严格的参数校验和错误处理
+- **深度操作**：支持深层嵌套对象的操作和遍历
+
+#### 代码质量提升
+- **ESLint合规**：所有代码符合ESLint规范，确保代码质量
+- **函数优化**：重构长函数，降低复杂度，提高可维护性
+- **测试覆盖**：完整的测试套件，确保功能稳定性
+
 ## 特点
 
 - **原生类型扩展**：为 String、Array、Number、Date 等原生类型提供丰富的原型方法
@@ -94,6 +112,25 @@ $.eventer.runParallel('data:process', { items: [...] });
 // 暂停和恢复事件
 $.eventer.pause('user:*'); // 暂停所有用户相关事件
 $.eventer.resume('user:*'); // 恢复所有用户相关事件
+
+// ECS架构组件操作示例
+const entity = { position: { x: 0, y: 0 }, health: 100 };
+
+// 添加组件属性
+entity.add({ velocity: { x: 1, y: 0 } });
+
+// 设置组件值（类型转换）
+entity.set({ health: '150' }); // 自动转换为数字类型
+
+// 删除组件属性
+entity.del('velocity.x');
+
+// 获取组件（支持默认值补全）
+const position = entity.get('position', { x: 0, y: 0, z: 0 });
+// 返回 { x: 0, y: 0, z: 0 }，补全了缺失的z属性
+
+// 使用路径访问嵌套属性
+const x = entity.get('position.x'); // 返回 0
 ```
 
 ## 模块导出
@@ -635,7 +672,7 @@ const finalResult = await $.eventer.emitWaterfall('data:pipeline', initialData,
 
 ### 代码执行
 
-#### $.run_code(code, cm, em, qm, rm)
+#### $.runCode(code, cm, em, qm, rm)
 - 描述：执行动态代码
 - 参数：
   - code: 要执行的代码字符串
@@ -733,7 +770,7 @@ A: 目前提供基本的JavaScript支持，TypeScript类型定义正在规划中
 ## npm发布信息
 
 ### 发布状态
-- **当前版本**: 1.9.6
+- **当前版本**: 1.9.9
 - **npm包名**: mm_expand
 - **发布状态**: 已准备发布
 

package/README_EN.md

@@ -11,6 +11,24 @@ A comprehensive JavaScript utility library that extends native prototypes (Strin
 
 This library extends JavaScript native object prototypes with comprehensive data operation methods, enabling developers to handle common data manipulation tasks with more concise code. It also includes a powerful event system, file operation tools, and object processing functions, making it suitable for various JavaScript application scenarios.
 
+### Latest Features Update (v1.9.9)
+
+#### ECS Architecture Support
+- **Enhanced Component Operations**: New `add`, `set`, `del`, `get` methods specifically designed for game ECS (Entity Component System) architecture
+- **Path Support**: Support for dot-separated and array paths to access nested properties
+- **Overwrite Control**: All methods support `overwrite` parameter to control whether to modify the original object
+- **Default Value Completion**: `get` method supports object default value completion to ensure component property integrity
+
+#### Enhanced Object Operations
+- **Object.prototype Extensions**: Added prototype methods for all objects including `keys`, `getInfo`, `add`, `del`, `set`, `get`, etc.
+- **Type Safety**: All methods include strict parameter validation and error handling
+- **Deep Operations**: Support for deep nested object operations and traversal
+
+#### Code Quality Improvements
+- **ESLint Compliance**: All code conforms to ESLint standards ensuring code quality
+- **Function Optimization**: Refactored long functions to reduce complexity and improve maintainability
+- **Test Coverage**: Complete test suite ensuring functional stability
+
 ## Features
 
 - **Native Type Extension**: Rich prototype methods for native types like String, Array, Number, Date, etc.
@@ -120,6 +138,25 @@ $.eventer.runParallel('data:process', { items: [...] });
 // Pause and resume events
 $.eventer.pause('user:*'); // Pause all user-related events
 $.eventer.resume('user:*'); // Resume all user-related events
+
+// ECS Architecture Component Operations Example
+const entity = { position: { x: 0, y: 0 }, health: 100 };
+
+// Add component properties
+entity.add({ velocity: { x: 1, y: 0 } });
+
+// Set component values (type conversion)
+entity.set({ health: '150' }); // Automatically converts to number type
+
+// Delete component properties
+entity.del('velocity.x');
+
+// Get component (supports default value completion)
+const position = entity.get('position', { x: 0, y: 0, z: 0 });
+// Returns { x: 0, y: 0, z: 0 }, completing the missing z property
+
+// Use path to access nested properties
+const x = entity.get('position.x'); // Returns 0
 ```
 
 ## Module Exports
@@ -661,7 +698,7 @@ const finalResult = await $.eventer.emitWaterfall('data:pipeline', initialData,
 
 ### Code Execution
 
-#### $.run_code(code, cm, em, qm, rm)
+#### $.runCode(code, cm, em, qm, rm)
 - Description: Execute dynamic code
 - Parameters:
   - code: Code string to execute
@@ -738,18 +775,49 @@ Welcome to submit Issues and Pull Requests! Please ensure your code follows thes
 3. Write test cases to ensure functionality
 4. Run tests before submitting to ensure no new issues are introduced
 
-## Release Status
-- **Current Version**: 1.9.6
+## npm Publishing Information
+
+### Release Status
+- **Current Version**: 1.9.9
 - **npm Package Name**: mm_expand
-- **Release Status**: Ready for release
+- **Release Status**: Ready for publishing
 
 ### Pre-release Checklist
 - ✅ All tests passed (87/87, 100% pass rate)
-- ✅ Documentation updated
+- ✅ Documentation updated with latest features
 - ✅ Dependencies correctly configured
 - ✅ Package information complete
 - ✅ License file exists
-- ✅ Event system performance optimization completed
+- ✅ ESLint compliance verified
+- ✅ ECS architecture support implemented
+- ✅ Object.prototype extensions completed
+
+### Publishing Commands
+```bash
+# Login to npm (if not already logged in)
+npm login
+
+# Publish to npm
+npm publish
+
+# If you need to update version after publishing
+npm version patch  # Patch version update
+npm version minor  # Minor version update
+npm version major  # Major version update
+npm publish        # Publish new version
+```
+
+### Version Management
+- Follows Semantic Versioning (SemVer)
+- Major version: Incompatible API changes
+- Minor version: Backward-compatible functionality additions
+- Patch version: Backward-compatible bug fixes
+
+### Maintenance Guidelines
+1. Run tests after each modification to ensure functionality
+2. Update documentation to reflect API changes
+3. Check code quality before committing code
+4. Regularly update dependencies to ensure security
 
 ## Changelog
 

package/index.js

@@ -24,61 +24,62 @@ var { Base } = require('./lib/base.js');
 var { Timer } = require('./lib/timer.js');
 var { Validator, validator } = require('./lib/validator.js');
 
-
+// 初始化$对象
 if (global.$ && !$.is_init) {
-	Object.assign($, require('./lib/object.js'), {
-		// 验证器类
-		validator,
-		// 事件驱动类
-		eventer,
-		// 日志类
-		logger: new Logger(),
-		// 文件类
-		file: new File(),
-		// 目录类
-		dir: new Dir(),
-		// 定时器类
-		timer: new Timer(),
-		// 语言包类
-		lang: new Lang({
-			zh_cn: {
-				name: "超级美眉"
-			},
-			en: {
-				name: "MM"
-			}
-		}),
-		// 基础类
-		Base,
-		// 事件类
-		Event
-	});
-	$.is_init = true;
+  Object.assign($, require('./lib/object.js'), {
+      // 验证器类
+      validator,
+      // 事件驱动类
+      eventer,
+      // 日志类
+      log: new Logger(),
+      // 文件类
+      file: new File(),
+      // 目录类
+      dir: new Dir(),
+      // 定时器类
+      timer: new Timer(),
+      // 语言包类
+      lang: new Lang({
+        zh_cn: {
+          name: '超级美眉'
+        },
+        en: {
+          name: 'MM'
+        }
+      }),
+      // 基础类
+      Base,
+      // 事件类
+      Event
+    });
+    
+    $.is_init = true;
 }
 
 module.exports = {
-	// 全局对象
-	$: global.$,
-	// 验证器类
-	Validator,
-	// 事件类
-	Event,
-	// 事件驱动类
-	Eventer,
-	// 定时器类
-	Timer,
-	// 日志类
-	Logger,
-	// 语言包类
-	Lang,
-	// 基础类
-	Base,
-	// 文件类
-	File,
-	// 目录类
-	Dir,
-	// 验证器实例
-	validator,
-	// 事件驱动实例
-	eventer
-}
+  // 全局对象
+  $: global.$,
+  // 验证器类
+  Validator,
+  // 事件类
+  Event,
+  // 事件驱动类
+  Eventer,
+  // 定时器类
+  Timer,
+  // 日志类
+  Logger,
+  // 语言包类
+  Lang,
+  // 基础类
+  Base,
+  // 文件类
+  File,
+  // 目录类
+  Dir,
+  // 验证器实例
+  validator,
+  // 事件驱动实例
+  eventer
+};