dzkcc-mflow 0.0.21 → 0.0.23

package/dist/App.d.ts

@@ -1,4 +1,4 @@
-import { ICore, IUIManager, IEventManager, ICocosResManager, IHttpManager, IWebSocketManager } from "./core";
+import { ICore, IUIManager, IEventManager, ICocosResManager, IHttpManager, IWebSocketManager, IRedDotManager } from "./core";
 /**
  * 对外暴露的全局app对像，用于访问基础能力，为上层业务提供了简洁的访问方式
  *
@@ -13,6 +13,7 @@ export declare class App {
     static get socket(): IWebSocketManager;
     static get res(): ICocosResManager;
     static get event(): IEventManager;
+    static get reddot(): IRedDotManager;
     static readonly storage: any;
     static readonly audio: any;
     static readonly timer: any;

package/dist/App.js

@@ -25,6 +25,9 @@ class App {
     static get event() {
         return ServiceLocator.getService('EventManager');
     }
+    static get reddot() {
+        return ServiceLocator.getService('ReddotManager');
+    }
 }
 App.log = null;
 App.config = null;

package/dist/_virtual/_tslib.js

@@ -15,6 +15,17 @@ PERFORMANCE OF THIS SOFTWARE.
 /* global Reflect, Promise, SuppressedError, Symbol, Iterator */
 
 
+function __decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+function __metadata(metadataKey, metadataValue) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(metadataKey, metadataValue);
+}
+
 function __awaiter(thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -30,4 +41,4 @@ typeof SuppressedError === "function" ? SuppressedError : function (error, suppr
     return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
 };
 
-export { __awaiter };
+export { __awaiter, __decorate, __metadata };

package/dist/core/Api.d.ts

@@ -1,88 +1,206 @@
+/**
+ * 核心接口 - 管理 Model 和 Manager 的生命周期
+ */
 export interface ICore {
-    regModel<T extends IModel>(model: T): void;
-    getModel<T extends IModel>(ctor: new () => T): T;
-    regManager<T extends IManager>(manager: T): void;
-    getManager<T extends IManager>(ctor: new () => T): T;
-    getManager<T extends IManager>(symbol: symbol): T;
+    /** 注册 Model - 通过 Symbol 自动实例化 */
+    regModel<T extends IModel>(modelSymbol: symbol): void;
+    /** 获取 Model */
+    getModel<T extends IModel>(modelSymbol: symbol): T;
+    /** 注册 Manager - 通过 Symbol 自动实例化 */
+    regManager<T extends IManager>(managerSymbol: symbol): void;
+    /** 获取 Manager */
+    getManager<T extends IManager>(managerSymbol: symbol): T;
 }
-export interface IManager {
+/**
+ * Model 基接口 - 数据模型
+ */
+export interface IModel {
+    /** 初始化 */
     initialize(): void;
-    dispose(): void;
 }
-export interface IModel {
+/**
+ * Manager 基接口 - 业务逻辑管理器
+ */
+export interface IManager {
+    /** 初始化 */
     initialize(): void;
+    /** 销毁 */
+    dispose(): void;
 }
+/**
+ * View 基接口 - 视图生命周期
+ */
 export interface IView {
+    /** 进入视图 */
     onEnter(args?: any): void;
+    /** 退出视图 */
     onExit(): void;
+    /** 暂停视图（被其他视图覆盖） */
     onPause(): void;
+    /** 恢复视图（从暂停状态恢复） */
     onResume(): void;
 }
+/**
+ * UI 管理器接口 - 管理视图的打开、关闭和栈操作
+ */
 export interface IUIManager {
-    open<T extends IView>(viewType: new () => T, args?: any): Promise<T>;
-    close<T extends IView>(viewortype: T | (new () => T), destory?: boolean): void;
-    openAndPush<T extends IView>(viewType: new () => T, group: string, args?: any): Promise<T>;
+    /** 打开视图 */
+    open<T extends IView>(viewSymbol: symbol, args?: any): Promise<T>;
+    /** 关闭视图 */
+    close(viewSymbol: symbol | IView, destory?: boolean): void;
+    /** 打开视图并入栈 */
+    openAndPush<T extends IView>(viewSymbol: symbol, group: string, args?: any): Promise<T>;
+    /** 关闭栈顶视图并弹出 */
     closeAndPop(group: string, destroy?: boolean): void;
+    /** 获取栈顶视图 */
     getTopView(): IView | undefined;
+    /** 清空视图栈 */
     clearStack(group: string, destroy?: boolean): void;
 }
+/**
+ * 资源管理器接口
+ */
 export interface IResManager {
 }
-export interface IHttpManager extends IManager {
-    get<T = any>(url: string, params?: Record<string, any>, headers?: Record<string, string>): Promise<T>;
-    post<T = any>(url: string, data?: any, headers?: Record<string, string>): Promise<T>;
-    put<T = any>(url: string, data?: any, headers?: Record<string, string>): Promise<T>;
-    delete<T = any>(url: string, params?: Record<string, any>, headers?: Record<string, string>): Promise<T>;
-    request<T = any>(options: HttpRequestOptions): Promise<T>;
-}
+/**
+ * HTTP 请求配置
+ */
 export interface HttpRequestOptions {
+    /** 请求 URL */
     url: string;
+    /** HTTP 方法 */
     method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
+    /** 请求头 */
     headers?: Record<string, string>;
+    /** URL 参数 */
     params?: Record<string, any>;
+    /** 请求体数据 */
     data?: any;
+    /** 超时时间（毫秒） */
     timeout?: number;
 }
-export interface IWebSocketManager extends IManager {
-    connect(url: string, protocols?: string | string[]): void;
-    disconnect(code?: number, reason?: string): void;
-    send(data: string | ArrayBuffer | Blob | object): void;
-    isConnected(): boolean;
-    on(event: 'open' | 'message' | 'error' | 'close', handler: Function): void;
-    off(event: 'open' | 'message' | 'error' | 'close', handler?: Function): void;
-    getReadyState(): number;
-    configure(config: Partial<WebSocketConfig>): void;
+/**
+ * HTTP 管理器接口 - 处理 HTTP 请求
+ */
+export interface IHttpManager extends IManager {
+    /** GET 请求 */
+    get<T = any>(url: string, params?: Record<string, any>, headers?: Record<string, string>): Promise<T>;
+    /** POST 请求 */
+    post<T = any>(url: string, data?: any, headers?: Record<string, string>): Promise<T>;
+    /** PUT 请求 */
+    put<T = any>(url: string, data?: any, headers?: Record<string, string>): Promise<T>;
+    /** DELETE 请求 */
+    delete<T = any>(url: string, params?: Record<string, any>, headers?: Record<string, string>): Promise<T>;
+    /** 通用请求 */
+    request<T = any>(options: HttpRequestOptions): Promise<T>;
 }
+/**
+ * WebSocket 配置
+ */
 export interface WebSocketConfig {
+    /** WebSocket URL */
     url: string;
+    /** 协议 */
     protocols?: string | string[];
+    /** 是否自动重连 */
     reconnect?: boolean;
+    /** 重连间隔（毫秒） */
     reconnectInterval?: number;
+    /** 重连尝试次数 */
     reconnectAttempts?: number;
+    /** 是否启用心跳 */
     heartbeat?: boolean;
+    /** 心跳间隔（毫秒） */
     heartbeatInterval?: number;
+    /** 心跳消息 */
     heartbeatMessage?: string;
 }
+/**
+ * WebSocket 管理器接口 - 管理 WebSocket 连接
+ */
+export interface IWebSocketManager extends IManager {
+    /** 连接 WebSocket */
+    connect(url: string, protocols?: string | string[]): void;
+    /** 断开连接 */
+    disconnect(code?: number, reason?: string): void;
+    /** 发送数据 */
+    send(data: string | ArrayBuffer | Blob | object): void;
+    /** 是否已连接 */
+    isConnected(): boolean;
+    /** 监听事件 */
+    on(event: 'open' | 'message' | 'error' | 'close', handler: Function): void;
+    /** 移除事件监听 */
+    off(event: 'open' | 'message' | 'error' | 'close', handler?: Function): void;
+    /** 获取连接状态 */
+    getReadyState(): number;
+    /** 配置 WebSocket */
+    configure(config: Partial<WebSocketConfig>): void;
+}
+/**
+ * 事件消息键类型（由业务层扩展）
+ */
 export interface IEventMsgKey {
 }
+/**
+ * 将索引类型转换为任意类型的索引类型
+ */
 export type ToAnyIndexKey<IndexKey, AnyType> = IndexKey extends keyof AnyType ? IndexKey : keyof AnyType;
+/**
+ * 监听器结果回调
+ */
 export type OnListenerResult<T = any> = (data?: T, callBack?: any) => void;
+/**
+ * 监听器函数
+ */
 export type OnListener<T = any, K = any> = (value?: T, callBack?: OnListenerResult<K>, ...args: any[]) => void;
+/**
+ * 监听器处理器配置
+ */
 export type ListenerHandler<keyType extends keyof any = any, ValueType = any, ResultType = any> = {
+    /** 事件键 */
     key: keyType;
+    /** 监听函数 */
     listener: OnListener<ValueType[ToAnyIndexKey<keyType, ValueType>], ResultType[ToAnyIndexKey<keyType, ResultType>]>;
+    /** 上下文 */
     context?: any;
+    /** 额外参数 */
     args?: any[];
 };
+/**
+ * 事件管理器接口 - 事件的发布订阅
+ */
 export interface IEventManager<MsgKeyType extends IEventMsgKey = IEventMsgKey, ValueType = any, ResultType = any> {
+    /** 监听事件 */
     on<keyType extends keyof MsgKeyType>(keyOrHandler: keyType | ListenerHandler<keyType, ValueType, ResultType> | ListenerHandler<keyType, ValueType, ResultType>[], listener?: OnListener<ValueType[ToAnyIndexKey<keyType, ValueType>], ResultType[ToAnyIndexKey<keyType, ResultType>]>, context?: any, args?: any[]): void;
+    /** 监听一次事件 */
     once<keyType extends keyof MsgKeyType>(keyOrHandler: keyType | ListenerHandler<keyType, ValueType, ResultType> | ListenerHandler<keyType, ValueType, ResultType>[], listener?: OnListener<ValueType[ToAnyIndexKey<keyType, ValueType>], ResultType[ToAnyIndexKey<keyType, ResultType>]>, context?: any, args?: any[]): void;
+    /** 移除事件监听 */
     off<keyType extends keyof MsgKeyType>(key: keyType, listener: OnListener<ValueType[ToAnyIndexKey<keyType, ValueType>], ResultType[ToAnyIndexKey<keyType, ResultType>]>): void;
+    /** 移除所有事件监听 */
     offAll<keyType extends keyof MsgKeyType>(key?: keyType, context?: any): void;
+    /** 派发事件 */
     dispatch<keyType extends keyof MsgKeyType>(key: keyType, data?: ValueType[ToAnyIndexKey<keyType, ValueType>], callback?: OnListenerResult<ResultType[ToAnyIndexKey<keyType, ResultType>]>, persistence?: boolean): void;
+    /** 派发粘性事件（自动保存） */
     dispatchSticky<keyType extends keyof MsgKeyType>(key: keyType, data?: ValueType[ToAnyIndexKey<keyType, ValueType>], callback?: OnListenerResult<ResultType[ToAnyIndexKey<keyType, ResultType>]>, persistence?: boolean): void;
+    /** 移除粘性广播 */
     removeStickyBroadcast(key: keyof MsgKeyType): void;
+    /** 检查事件是否已注册 */
     isRegistered(key: keyof MsgKeyType): boolean;
+    /** 获取持久化的值 */
     getPersistentValue<keyType extends keyof MsgKeyType>(key: keyType): ValueType[ToAnyIndexKey<keyType, ValueType>] | undefined;
+    /** 销毁 */
     dispose(): void;
 }
+/**
+ * 红点管理器接口 - 管理 UI 红点提示
+ */
+export interface IRedDotManager extends IManager {
+    /** 设置红点数量 */
+    setCount(nodeId: string, count: number): void;
+    /** 获取红点数量 */
+    getCount(nodeId: string): number;
+    /** 监听红点变化 */
+    on(path: string, listener: Function): void;
+    /** 移除红点监听 */
+    off(path: string, listener: Function): void;
+}

package/dist/core/Core.d.ts

@@ -1,20 +1,16 @@
-import { ICore, IEventManager, IManager, IModel, IHttpManager, IWebSocketManager } from "./Api";
+import { ICore, IManager, IModel } from "./Api";
 export declare abstract class AbstractCore<T extends AbstractCore<T>> implements ICore {
     private readonly container;
     constructor();
     protected abstract initialize(): void;
-    regModel<T extends IModel>(model: T): void;
-    getModel<T extends IModel>(ctor: new () => T): T;
-    regManager<T extends IManager>(manager: T): void;
-    getManager<T extends IManager>(indent: (new () => T) | symbol): T;
+    regModel<T extends IModel>(modelSymbol: symbol): void;
+    getModel<T extends IModel>(modelSymbol: symbol): T;
+    regManager<T extends IManager>(managerSymbol: symbol): void;
+    getManager<T extends IManager>(managerSymbol: symbol): T;
 }
 export declare abstract class AbstractManager implements IManager {
-    private eventManager?;
     abstract initialize(): void;
     dispose(): void;
-    protected getModel<T extends IModel>(ctor: new () => T): T;
-    protected getEventManager(): IEventManager;
-    protected getHttpManager(): IHttpManager;
-    protected getWebSocketManager(): IWebSocketManager;
-    private releaseEventManager;
+    protected getModel<T extends IModel>(modelSymbol: symbol): T;
+    protected getManager<T extends IManager>(managerSymbol: symbol): T;
 }

package/dist/core/Core.js

@@ -1,25 +1,14 @@
 import { ServiceLocator } from './ServiceLocator.js';
-import { getInterface } from './Decorators.js';
+import { getModelClass, getManagerClass } from './Decorators.js';
 
 class Container {
     constructor() {
-        this.ctor2ins = new Map(); // 使用构造函数作为键
         this.symbol2ins = new Map();
     }
-    regByCtor(type, ins) {
-        this.ctor2ins.set(type, ins);
-    }
-    getByCtor(type) {
-        const ins = this.ctor2ins.get(type);
-        if (!ins)
-            throw new Error(`${type.name} not registered!`);
-        return ins;
-    }
-    regBySymbol(ctor, ins) {
-        const sym = getInterface(ctor);
+    reg(sym, ins) {
         this.symbol2ins.set(sym, ins);
     }
-    getBySymbol(sym) {
+    get(sym) {
         const ins = this.symbol2ins.get(sym);
         if (!ins)
             throw new Error(`${sym.toString()} not registered!`);
@@ -32,60 +21,37 @@ class AbstractCore {
         this.initialize();
     }
     // 注册与获取模型
-    regModel(model) {
-        this.container.regByCtor(Object.getPrototypeOf(model).constructor, model);
+    regModel(modelSymbol) {
+        const ModelClass = getModelClass(modelSymbol);
+        const model = new ModelClass();
+        this.container.reg(modelSymbol, model);
         model.initialize();
     }
-    getModel(ctor) {
-        return this.container.getByCtor(ctor);
+    getModel(modelSymbol) {
+        return this.container.get(modelSymbol);
     }
     // 注册与获取管理器
-    regManager(manager) {
-        const ctor = Object.getPrototypeOf(manager).constructor;
-        this.container.regByCtor(ctor, manager);
-        this.container.regBySymbol(ctor, manager); // 同时注册Symbol
+    regManager(managerSymbol) {
+        const ManagerClass = getManagerClass(managerSymbol);
+        const manager = new ManagerClass();
+        this.container.reg(managerSymbol, manager);
         manager.initialize();
     }
-    getManager(indent) {
-        if (typeof indent === 'symbol') {
-            return this.container.getBySymbol(indent);
-        }
-        else {
-            return this.container.getByCtor(indent);
-        }
+    getManager(managerSymbol) {
+        return this.container.get(managerSymbol);
     }
 }
 class AbstractManager {
     dispose() {
-        this.releaseEventManager();
     }
-    getModel(ctor) {
+    getModel(modelSymbol) {
         // 保持框架独立性，不与具体应用入口(app类)耦合
         // 框架高内聚，使用ServiceLocator获取core
-        return ServiceLocator.getService('core').getModel(ctor);
-    }
-    // 事件管理器获取（通过服务定位器解耦）
-    getEventManager() {
-        if (!this.eventManager) {
-            this.eventManager = ServiceLocator.getService('EventManager');
-        }
-        return this.eventManager;
-    }
-    // HTTP 管理器获取
-    getHttpManager() {
-        return ServiceLocator.getService('HttpManager');
-    }
-    // WebSocket 管理器获取
-    getWebSocketManager() {
-        return ServiceLocator.getService('WebSocketManager');
+        return ServiceLocator.getService('core').getModel(modelSymbol);
     }
-    releaseEventManager() {
-        var _a, _b;
-        if (this.eventManager) {
-            // 假设 IEventManager 有销毁逻辑（如第三方库）
-            (_b = (_a = this.eventManager) === null || _a === void 0 ? void 0 : _a.dispose) === null || _b === void 0 ? void 0 : _b.call(_a);
-            this.eventManager = undefined;
-        }
+    // 业务模块的事件管理器获取（通过服务定位器解耦）
+    getManager(managerSymbol) {
+        return ServiceLocator.getService('core').getManager(managerSymbol);
     }
 }
 

package/dist/core/Decorators.d.ts

@@ -1,7 +1,117 @@
-import { ICore, IManager } from "./Api";
+import { ICore } from "./Api";
 import 'reflect-metadata';
-export declare function getInterface<T extends Function>(ctor: T): symbol;
-export declare function model(): (ctor: Function) => void;
+/** Model 名称到 Symbol 的映射，用于代码补全 */
+export declare const ModelNames: Record<string, symbol>;
+/** Manager 名称到 Symbol 的映射，用于代码补全 */
+export declare const ManagerNames: Record<string, symbol>;
+/** View 名称到 Symbol 的映射，用于代码补全 */
+export declare const ViewNames: Record<string, symbol>;
+/**
+ * Model 装饰器，用于注册 Model 到全局注册表
+ * @param name 可选的 Model 名称，如果不提供则使用类名
+ * @example
+ * ```typescript
+ * @model('User')
+ * export class UserModel implements IModel {
+ *     initialize(): void { }
+ * }
+ *
+ * // 使用
+ * const user = mf.core.getModel(ModelNames.User);
+ * ```
+ */
+export declare function model(name?: string): (ctor: Function) => void;
+/**
+ * 获取所有已注册的 Model 名称
+ * @returns Model 名称数组
+ */
+export declare function getRegisteredModelNames(): string[];
+/**
+ * 通过 Symbol 获取 Model 类构造函数
+ * @param modelSymbol Model 的 Symbol 标识
+ * @returns Model 类构造函数
+ * @throws 如果 Model 未注册则抛出错误
+ */
+export declare function getModelClass<T>(modelSymbol: symbol): new () => T;
+/**
+ * 通过类构造函数获取 Model 的 Symbol
+ * @param ctor Model 类构造函数
+ * @returns Model 的 Symbol
+ * @internal 内部使用
+ */
+export declare function getModelSymbol(ctor: Function): symbol | undefined;
+/**
+ * Manager 装饰器，用于注册 Manager 到全局注册表
+ * @param name 可选的 Manager 名称，如果不提供则使用类名
+ * @example
+ * ```typescript
+ * @manager('Game')
+ * export class GameManager extends AbstractManager {
+ *     initialize(): void { }
+ * }
+ * ```
+ */
+export declare function manager(name?: string): (ctor: Function) => void;
+/**
+ * 获取所有已注册的 Manager 名称
+ * @returns Manager 名称数组
+ */
+export declare function getRegisteredManagerNames(): string[];
+/**
+ * 通过 Symbol 获取 Manager 类构造函数
+ * @param managerSymbol Manager 的 Symbol 标识
+ * @returns Manager 类构造函数
+ * @throws 如果 Manager 未注册则抛出错误
+ */
+export declare function getManagerClass<T>(managerSymbol: symbol): new () => T;
+/**
+ * 通过类构造函数获取 Manager 的 Symbol
+ * @param ctor Manager 类构造函数
+ * @returns Manager 的 Symbol
+ * @internal 内部使用
+ */
+export declare function getManagerSymbol(ctor: Function): symbol | undefined;
+/**
+ * View 装饰器，用于注册 View 到全局注册表
+ * @param name 可选的 View 名称，如果不提供则使用类名
+ * @example
+ * ```typescript
+ * @view('Home')
+ * @ccclass('HomeView')
+ * export class HomeView extends BaseView {
+ *     onEnter(): void { }
+ *     onPause(): void { }
+ *     onResume(): void { }
+ * }
+ *
+ * // 使用
+ * await mf.ui.open(ViewNames.Home);
+ * ```
+ */
+export declare function view(name?: string): (ctor: Function) => void;
+/**
+ * 获取所有已注册的 View 名称
+ * @returns View 名称数组
+ */
+export declare function getRegisteredViewNames(): string[];
+/**
+ * 通过 Symbol 获取 View 类构造函数
+ * @param viewSymbol View 的 Symbol 标识
+ * @returns View 类构造函数
+ * @throws 如果 View 未注册则抛出错误
+ */
+export declare function getViewClass<T>(viewSymbol: symbol): new () => T;
+/**
+ * 自动注册所有使用装饰器标记的 Model 和 Manager
+ * @param core Core 实例
+ * @example
+ * ```typescript
+ * // 导入所有 Model 和 Manager
+ * import '@/models/UserModel';
+ * import '@/managers/GameManager';
+ *
+ * // 自动注册
+ * autoRegister(mf.core);
+ * ```
+ */
 export declare function autoRegister(core: ICore): void;
-export declare function managedWithClean(): (ctor: Function) => any;
-export declare function injectManager(sym: symbol): (target: IManager, prop: string) => void;