dzkcc-mflow 0.0.39 → 0.0.41

package/README.md

@@ -7,7 +7,7 @@
 ## 核心特性
 
 ✨ **模块化设计** - 通过 Manager 和 Model 模式实现业务逻辑的模块化管理  
-✨ **依赖注入** - 基于装饰器的自动依赖注入和 Symbol 映射  
+✨ **依赖注入** - 基于装饰器的自动依赖注入和字符串标识  
 ✨ **服务定位器** - 统一的服务管理机制，实现服务解耦  
 ✨ **UI 管理系统** - 完整的 UI 界面管理方案，支持视图栈和分组  
 ✨ **事件系统** - 强大的事件广播和监听机制，支持粘性事件  
@@ -35,8 +35,10 @@ npm i dzkcc-mflow@beta
   "extends": "./temp/tsconfig.cocos.json",
   "compilerOptions": {
     "strict": false,
+    "baseUrl": ".",//必须
     "paths": {
-      "dzkcc-mflow/*": ["./node_modules/dzkcc-mflow/dist/*"]
+      "db://assets/*": ["assets/*"], //必须
+      "dzkcc-mflow/*": ["./node_modules/dzkcc-mflow/dist/*"] //必须
     }
   }
 }
@@ -62,7 +64,7 @@ export class GameCore extends CocosCore {
 
 ### 1. 核心概念
 
-了解框架的基础架构、Core 容器、ServiceLocator、Manager、Model、View 和 Symbol 映射系统。
+了解框架的基础架构、Core 容器、ServiceLocator、Manager、Model、View 和字符串标识系统。
 
 📖 **查看文档**: [核心概念](./docs/CORE_CONCEPTS.md)
 
@@ -171,12 +173,13 @@ mf.reddot.on('main/bag', (totalCount) => {
 // types/api-type-hints.d.ts
 declare module 'dzkcc-mflow/core' {
     interface ModelTypeMap {
-        [ModelNames.User]: UserModel;
+        UserModel: UserModel;
+        GameModel: GameModel;
     }
 }
 
 // 使用时自动推断类型
-const userModel = mf.core.getModel(ModelNames.User);
+const userModel = mf.core.getModel('UserModel');
 userModel.name;  // ✅ 有完整的代码补全
 ```
 
@@ -187,7 +190,7 @@ userModel.name;  // ✅ 有完整的代码补全
 **编辑器菜单**：**mflow-tools -> Generate API type hints/生成API类型提示**
 
 > ⚠️ **如果 getManager/getModel 没有类型提示**？
-> 
+>
 > 需要创建类型映射文件，使用编辑器的 **mflow-tools -> Generate API type hints/生成API类型提示** 自动生成，
 > 或查看 [类型提示问题解决方案](./docs/TYPE_INFERENCE_FIX.md)
 
@@ -219,40 +222,58 @@ Cocos Creator 编辑器插件，自动生成 UI 脚本，自动设置组件引
 ## 架构图
 
 ```
-┌─────────────────────────────────────────────────┐
-│                    全局对象 mf                    │
-│  (统一访问入口，暴露所有框架能力)                   │
-└──────────────────┬──────────────────────────────┘
-                   │
-    ┌──────────────┼──────────────┐
-    │              │              │
-    ▼              ▼              ▼
-┌─────────┐  ┌──────────┐  ┌──────────┐
-│  Core   │  │ Services │  │  Views   │
-│(核心容器)│  │(基础服务) │  │ (UI界面)  │
-└─────────┘  └──────────┘  └──────────┘
-    │              │              │
-    ├─ Manager ─┐  ├─ UIManager  ├─ BaseView
-    │           │  ├─ ResLoader  └─ 自动资源管理
-    ├─ Model ───┤  ├─ EventMgr     自动事件清理
-    │           │  ├─ HttpMgr
-    └─ Symbol ──┘  ├─ SocketMgr
-       映射系统    └─ RedDotMgr
+┌─────────────────────────────────────────────────────────────────┐
+│                          全局对象 mf                              │
+│              (统一访问入口，暴露所有框架能力)                        │
+└─────────────────────────┬───────────────────────────────────────┘
+                          │
+    ┌─────────────────────┼─────────────────────┐
+    │                     │                     │
+    ▼                     ▼                     ▼
+┌─────────┐  ┌─────────────────────────────────────────┐  ┌──────────┐
+│  Core   │  │            ServiceLocator              │  │  Views   │
+│(核心容器)│  │           (服务定位器)                  │  │ (UI界面)  │
+└─────────┘  └─────────────────────────────────────────┘  └──────────┘
+    │                     │                                   │
+    ├─ Manager ─┐         ├─ Broadcaster(EventMgr)             ├─ BaseView
+    │           │         ├─ UIManager                         └─ 自动资源管理
+    ├─ Model ───┤         ├─ ResLoader                          └─ 自动事件清理
+    │           │         ├─ HttpManager
+    └─ 字符串 ───┘         ├─ WebSocketManager
+       标识系统              └─ RedDotManager
 ```
 
+### 架构说明
+
+1. **全局对象 `mf`** - 提供统一访问入口，通过 `mf.core`、`mf.gui`、`mf.event` 等访问各模块功能
+
+2. **Core (核心容器)** - 管理业务层的 Model 和 Manager，支持依赖注入和类型推断
+
+3. **ServiceLocator (服务定位器)** - 统一管理框架的基础服务，包括：
+   - **Broadcaster** - 事件广播系统，支持粘性事件
+   - **UIManager** - UI界面管理系统，支持视图栈和生命周期管理
+   - **ResLoader** - 资源加载器，支持自动释放和缓存管理
+   - **HttpManager** - HTTP网络客户端，支持RESTful API
+   - **WebSocketManager** - WebSocket实时通信，支持自动重连和心跳
+   - **RedDotManager** - 树形结构的红点提示管理系统
+
+4. **Views (UI界面)** - 基于 BaseView 的界面组件，支持完整的生命周期管理和自动资源清理
+
+5. **依赖注入系统** - 通过装饰器(@manager、@model、@view)和字符串标识实现自动依赖注入
+
 ## 使用全局对象
 
 框架提供了全局对象 `mf` 用于访问所有功能：
 
 ```typescript
 // 访问 Manager
-mf.core.getManager(ManagerNames.GameManager);
+mf.core.getManager('GameManager');
 
 // 访问 Model
-mf.core.getModel(ModelNames.UserModel);
+mf.core.getModel('UserModel');
 
 // UI 管理
-mf.gui.open(ViewNames.HomeView);
+mf.gui.open('HomeView');
 
 // 事件系统
 mf.event.dispatch('gameStart');

package/dist/libs/UIManager.d.ts

@@ -53,7 +53,11 @@ export interface UIPreloadConfig {
     /** 预加载延迟（毫秒） */
     delay?: number;
 }
-type ICocosView = IView & Component;
+interface IInternalView extends IView {
+    __group__: string | undefined;
+    __isIView__: boolean;
+}
+type ICocosView = IInternalView & Component;
 declare abstract class CcocosUIManager implements IUIManager {
     getTopView(): IView | undefined;
     open<T extends keyof UIRegistry>(viewClass: T, args?: UIOpenOptions): Promise<InstanceType<UIRegistry[T]>>;

package/dist/libs/UIManager.js

@@ -277,14 +277,14 @@ class UIManager extends CcocosUIManager {
             if (!this._maskOptions.clickToClose) {
                 return;
             }
-            const view = this.getTopView();
+            const view = this._internalGetTopView();
             if (!view) {
                 return;
             }
             // 区分两种情况处理：
             // 1. 如果视图有 __group__ 属性且不为 undefined，说明是通过 openAndPush 打开的栈式UI
             // 2. 否则是通过 open 打开的普通 UI
-            if ('__group__' in view && view.__group__ !== undefined) {
+            if (view.__group__ && view.__group__.trim() != "") {
                 // 栈式UI：调用 _internalCloseAndPop 来处理返回逻辑
                 this._internalCloseAndPop(view.__group__, false);
             }
@@ -405,10 +405,10 @@ class UIManager extends CcocosUIManager {
             if (this._loadingPromises.has(viewKey)) {
                 return this._loadingPromises.get(viewKey);
             }
-            const loadPromise = this._loadInternal(viewKey);
-            this._loadingPromises.set(viewKey, loadPromise);
             try {
-                return yield loadPromise;
+                const view = this._loadInternal(viewKey);
+                this._loadingPromises.set(viewKey, view);
+                return yield view;
             }
             finally {
                 this._loadingPromises.delete(viewKey);
@@ -500,9 +500,7 @@ class UIManager extends CcocosUIManager {
                     top.node.removeFromParent();
                 }
                 // 标记视图所属组并入栈
-                if ('__group__' in view) {
-                    view.__group__ = group;
-                }
+                view.__group__ = group;
                 stack.push(view);
                 addChild(view.node);
                 this._adjustMaskLayer();
@@ -574,9 +572,7 @@ class UIManager extends CcocosUIManager {
             }
             // 处理视图实例
             const viewInstance = viewKeyOrInstance;
-            if ('__group__' in viewInstance) {
-                viewInstance.__group__ = undefined;
-            }
+            viewInstance.__group__ = undefined;
             if (!skipAnimation) {
                 // * 播放关闭动画,使用async是必要的，因为：
                 // * 确保动画播放完成后再执行onExit和节点移除，不然还没播放动画了，UI就已经没了

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "dzkcc-mflow",
-    "version": "0.0.39",
+    "version": "0.0.41",
     "description": "A modular design and process management framework developed for the cocos engine, suitable for decoupling and dependency injection.",
     "author": "duanzhk",
     "license": "MIT",