dzkcc-mflow 0.0.35 → 0.0.36

package/dist/core/Api.d.ts

@@ -33,8 +33,16 @@ export interface ViewNamesType extends Record<string, string> {
  * 类型推断由业务层的 .d.ts 文件通过函数重载提供
  */
 export interface ICore {
-    /** 注册 Model - 通过 Key 自动实例化 */
-    regModel<T extends keyof ModelNamesType>(modelKey: T): void;
+    /**
+     * 注册 Model - 通过 Key 自动实例化
+     * @param modelKey Model 的 Key，使用 ModelNames.XXX
+     * @example
+     * ```typescript
+     * // 手动注册（通常不需要，推荐使用 autoRegister）
+     * core.regModel(ModelNames.User);
+     * ```
+     */
+    regModel(modelKey: keyof ModelNamesType): void;
     /**
      * 获取 Model 实例
      * @param modelKey Model 的 Key，使用 ModelNames.XXX
@@ -45,9 +53,17 @@ export interface ICore {
      * const userModel = core.getModel(ModelNames.User);
      * ```
      */
-    getModel<T extends keyof ModelNamesType>(modelKey: T): any;
-    /** 注册 Manager - 通过 Key 自动实例化 */
-    regManager<T extends keyof ManagerNamesType>(managerKey: T): void;
+    getModel(modelKey: keyof ModelNamesType): any;
+    /**
+     * 注册 Manager - 通过 Key 自动实例化
+     * @param managerKey Manager 的 Key，使用 ManagerNames.XXX
+     * @example
+     * ```typescript
+     * // 手动注册（通常不需要，推荐使用 autoRegister）
+     * core.regManager(ManagerNames.Game);
+     * ```
+     */
+    regManager(managerKey: keyof ManagerNamesType): void;
     /**
      * 获取 Manager 实例
      * @param managerKey Manager 的 Key，使用 ManagerNames.XXX
@@ -58,7 +74,19 @@ export interface ICore {
      * const gameManager = core.getManager(ManagerNames.Game);
      * ```
      */
-    getManager<T extends keyof ManagerNamesType>(managerKey: T): any;
+    getManager(managerKey: keyof ManagerNamesType): any;
+    /**
+     * 检查 Model 是否已注册
+     * @param modelKey Model 的 Key
+     * @returns 是否已注册
+     */
+    hasModel(modelKey: keyof ModelNamesType): boolean;
+    /**
+     * 检查 Manager 是否已注册
+     * @param managerKey Manager 的 Key
+     * @returns 是否已注册
+     */
+    hasManager(managerKey: keyof ManagerNamesType): boolean;
 }
 /**
  * Model 基接口 - 数据模型
@@ -96,11 +124,11 @@ export interface IView {
  */
 export interface IUIManager {
     /** 打开视图 */
-    open<T extends keyof ViewNamesType>(viewKey: T, args?: any): Promise<IView>;
+    open(viewKey: keyof ViewNamesType, args?: any): Promise<IView>;
     /** 关闭视图 */
-    close<T extends keyof ViewNamesType>(viewKey: T | IView, destory?: boolean): void;
+    close(viewKey: keyof ViewNamesType | IView, destory?: boolean): void;
     /** 打开视图并入栈 */
-    openAndPush<T extends keyof ViewNamesType>(viewKey: T, group: string, args?: any): Promise<IView>;
+    openAndPush(viewKey: keyof ViewNamesType, group: string, args?: any): Promise<IView>;
     /** 关闭栈顶视图并弹出 */
     closeAndPop(group: string, destroy?: boolean): void;
     /** 获取栈顶视图 */

package/dist/core/Core.d.ts

@@ -3,7 +3,7 @@ export declare abstract class AbstractCore<T extends AbstractCore<T>> implements
     private readonly container;
     constructor();
     protected abstract initialize(): void;
-    regModel<T extends keyof ModelNamesType>(modelKey: T): void;
+    regModel(modelKey: keyof ModelNamesType): void;
     /**
      * 获取 Model 实例
      * @param modelKey Model 的 Key，使用 ModelNames.XXX
@@ -14,8 +14,8 @@ export declare abstract class AbstractCore<T extends AbstractCore<T>> implements
      * const userModel = core.getModel(ModelNames.User);
      * ```
      */
-    getModel<T extends keyof ModelNamesType>(modelKey: T): any;
-    regManager<T extends keyof ManagerNamesType>(managerKey: T): void;
+    getModel(modelKey: keyof ModelNamesType): any;
+    regManager(managerKey: keyof ManagerNamesType): void;
     /**
      * 获取 Manager 实例
      * @param managerKey Manager 的 Key，使用 ManagerNames.XXX
@@ -26,7 +26,19 @@ export declare abstract class AbstractCore<T extends AbstractCore<T>> implements
      * const gameManager = core.getManager(ManagerNames.Game);
      * ```
      */
-    getManager<T extends keyof ManagerNamesType>(managerKey: T): any;
+    getManager(managerKey: keyof ManagerNamesType): any;
+    /**
+     * 检查 Model 是否已注册
+     * @param modelKey Model 的 Key
+     * @returns 是否已注册
+     */
+    hasModel(modelKey: keyof ModelNamesType): boolean;
+    /**
+     * 检查 Manager 是否已注册
+     * @param managerKey Manager 的 Key
+     * @returns 是否已注册
+     */
+    hasManager(managerKey: keyof ManagerNamesType): boolean;
 }
 export declare abstract class AbstractManager implements IManager {
     abstract initialize(): void;
@@ -36,11 +48,11 @@ export declare abstract class AbstractManager implements IManager {
      * @param modelKey Model 的 Key，使用 ModelNames.XXX
      * @returns Model 实例（具体类型由 .d.ts 文件的函数重载推断）
      */
-    protected getModel<T extends keyof ModelNamesType>(modelKey: T): any;
+    protected getModel(modelKey: keyof ModelNamesType): any;
     /**
      * 获取 Manager 实例
      * @param managerKey Manager 的 Key，使用 ManagerNames.XXX
      * @returns Manager 实例（具体类型由 .d.ts 文件的函数重载推断）
      */
-    protected getManager<T extends keyof ManagerNamesType>(managerKey: T): any;
+    protected getManager(managerKey: keyof ManagerNamesType): any;
 }

package/dist/core/Core.js

@@ -14,6 +14,9 @@ class Container {
             throw new Error(`${key} not registered!`);
         return ins;
     }
+    has(key) {
+        return this.key2ins.has(key);
+    }
 }
 class AbstractCore {
     constructor() {
@@ -62,6 +65,22 @@ class AbstractCore {
     getManager(managerKey) {
         return this.container.get(managerKey);
     }
+    /**
+     * 检查 Model 是否已注册
+     * @param modelKey Model 的 Key
+     * @returns 是否已注册
+     */
+    hasModel(modelKey) {
+        return this.container.has(modelKey);
+    }
+    /**
+     * 检查 Manager 是否已注册
+     * @param managerKey Manager 的 Key
+     * @returns 是否已注册
+     */
+    hasManager(managerKey) {
+        return this.container.has(managerKey);
+    }
 }
 class AbstractManager {
     dispose() {

package/dist/core/Decorators.d.ts

@@ -103,6 +103,7 @@ export declare function getViewClass<T>(viewKey: string): new () => T;
 /**
  * 自动注册所有使用装饰器标记的 Model 和 Manager
  * @param core Core 实例
+ * @param options 注册选项
  * @example
  * ```typescript
  * // 导入所有 Model 和 Manager
@@ -111,6 +112,15 @@ export declare function getViewClass<T>(viewKey: string): new () => T;
  *
  * // 自动注册
  * autoRegister(mf.core);
+ *
+ * // 带选项的自动注册
+ * autoRegister(mf.core, {
+ *   skipExisting: true,  // 跳过已注册的
+ *   verbose: false       // 静默模式
+ * });
  * ```
  */
-export declare function autoRegister(core: ICore): void;
+export declare function autoRegister(core: ICore, options?: {
+    skipExisting?: boolean;
+    verbose?: boolean;
+}): void;

package/dist/core/Decorators.js

@@ -182,6 +182,7 @@ function getViewClass(viewKey) {
 /**
  * 自动注册所有使用装饰器标记的 Model 和 Manager
  * @param core Core 实例
+ * @param options 注册选项
  * @example
  * ```typescript
  * // 导入所有 Model 和 Manager
@@ -190,17 +191,36 @@ function getViewClass(viewKey) {
  *
  * // 自动注册
  * autoRegister(mf.core);
+ *
+ * // 带选项的自动注册
+ * autoRegister(mf.core, {
+ *   skipExisting: true,  // 跳过已注册的
+ *   verbose: false       // 静默模式
+ * });
  * ```
  */
-function autoRegister(core) {
+function autoRegister(core, options = {}) {
+    const { skipExisting = false, verbose = true } = options;
     // 注册所有 Model
     ctorToModelKey.forEach((modelKey, ctor) => {
-        console.log(`${ctor.name} initialize`);
+        if (skipExisting && core.hasModel(modelKey)) {
+            if (verbose)
+                console.log(`${ctor.name} already registered, skipping`);
+            return;
+        }
+        if (verbose)
+            console.log(`${ctor.name} initialize`);
         core.regModel(modelKey);
     });
     // 注册所有 Manager
     ctorToManagerKey.forEach((managerKey, ctor) => {
-        console.log(`${ctor.name} initialize`);
+        if (skipExisting && core.hasManager(managerKey)) {
+            if (verbose)
+                console.log(`${ctor.name} already registered, skipping`);
+            return;
+        }
+        if (verbose)
+            console.log(`${ctor.name} initialize`);
         core.regManager(managerKey);
     });
 }

package/dist/libs/UIManager.d.ts

@@ -4,9 +4,9 @@ import { ViewNamesType } from "../core";
 type ICocosView = IView & Component;
 declare abstract class CcocosUIManager implements IUIManager {
     getTopView(): IView | undefined;
-    open<T extends keyof ViewNamesType>(viewKey: T, args?: any): Promise<IView>;
-    close<T extends keyof ViewNamesType>(viewKey: T | IView, destory?: boolean): void;
-    openAndPush<T extends keyof ViewNamesType>(viewKey: T, group: string, args?: any): Promise<IView>;
+    open(viewKey: keyof ViewNamesType, args?: any): Promise<IView>;
+    close(viewKey: keyof ViewNamesType | IView, destory?: boolean): void;
+    openAndPush(viewKey: keyof ViewNamesType, group: string, args?: any): Promise<IView>;
     closeAndPop(group: string, destroy?: boolean): void;
     clearStack(group: string, destroy?: boolean): void;
     protected abstract internalOpen(viewKey: string, args?: any): Promise<ICocosView>;

package/package.json

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