dzkcc-mflow 0.0.34 → 0.0.36

package/dist/core/Api.d.ts

@@ -1,11 +1,48 @@
+/**
+ * ModelNames 接口（由业务层扩展以提供代码补全和类型推断）
+ * @example
+ * ```typescript
+ * // 在 .d.ts 文件中扩展
+ * interface ModelNamesType {
+ *     readonly User: 'User';
+ * }
+ * ```
+ */
+export interface ModelNamesType extends Record<string, string> {
+}
+/**
+ * ManagerNames 接口（由业务层扩展以提供代码补全和类型推断）
+ * @example
+ * ```typescript
+ * // 在 .d.ts 文件中扩展
+ * interface ManagerNamesType {
+ *     readonly Home: 'Home';
+ * }
+ * ```
+ */
+export interface ManagerNamesType extends Record<string, string> {
+}
+/**
+ * ViewNames 接口（由业务层扩展以提供代码补全和类型推断）
+ */
+export interface ViewNamesType extends Record<string, string> {
+}
 /**
  * 核心接口 - 管理 Model 和 Manager 的生命周期
  *
  * 类型推断由业务层的 .d.ts 文件通过函数重载提供
  */
 export interface ICore {
-    /** 注册 Model - 通过 Key 自动实例化 */
-    regModel(modelKey: string): 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
@@ -16,9 +53,17 @@ export interface ICore {
      * const userModel = core.getModel(ModelNames.User);
      * ```
      */
-    getModel(modelKey: string): any;
-    /** 注册 Manager - 通过 Key 自动实例化 */
-    regManager(managerKey: string): 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
@@ -29,7 +74,19 @@ export interface ICore {
      * const gameManager = core.getManager(ManagerNames.Game);
      * ```
      */
-    getManager(managerKey: string): 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 基接口 - 数据模型
@@ -67,11 +124,11 @@ export interface IView {
  */
 export interface IUIManager {
     /** 打开视图 */
-    open(viewKey: string, args?: any): Promise<IView>;
+    open(viewKey: keyof ViewNamesType, args?: any): Promise<IView>;
     /** 关闭视图 */
-    close(viewKey: string | IView, destory?: boolean): void;
+    close(viewKey: keyof ViewNamesType | IView, destory?: boolean): void;
     /** 打开视图并入栈 */
-    openAndPush(viewKey: string, 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

@@ -1,9 +1,9 @@
-import { ICore, IManager } from "./Api";
+import { ICore, IManager, ModelNamesType, ManagerNamesType } from "./Api";
 export declare abstract class AbstractCore<T extends AbstractCore<T>> implements ICore {
     private readonly container;
     constructor();
     protected abstract initialize(): void;
-    regModel(modelKey: string): 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(modelKey: string): any;
-    regManager(managerKey: string): 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(managerKey: string): 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(modelKey: string): any;
+    protected getModel(modelKey: keyof ModelNamesType): any;
     /**
      * 获取 Manager 实例
      * @param managerKey Manager 的 Key，使用 ManagerNames.XXX
      * @returns Manager 实例（具体类型由 .d.ts 文件的函数重载推断）
      */
-    protected getManager(managerKey: string): 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() {
@@ -22,9 +25,10 @@ class AbstractCore {
     }
     // 注册与获取模型
     regModel(modelKey) {
-        const ModelClass = getModelClass(modelKey);
+        const modelKeyStr = modelKey;
+        const ModelClass = getModelClass(modelKeyStr);
         const model = new ModelClass();
-        this.container.reg(modelKey, model);
+        this.container.reg(modelKeyStr, model);
         model.initialize();
     }
     /**
@@ -42,9 +46,10 @@ class AbstractCore {
     }
     // 注册与获取管理器
     regManager(managerKey) {
-        const ManagerClass = getManagerClass(managerKey);
+        const managerKeyStr = managerKey;
+        const ManagerClass = getManagerClass(managerKeyStr);
         const manager = new ManagerClass();
-        this.container.reg(managerKey, manager);
+        this.container.reg(managerKeyStr, manager);
         manager.initialize();
     }
     /**
@@ -60,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

@@ -1,33 +1,4 @@
-import { ICore } from "./Api";
-/**
- * ModelNames 接口（由业务层扩展以提供代码补全和类型推断）
- * @example
- * ```typescript
- * // 在 .d.ts 文件中扩展
- * interface ModelNamesType {
- *     readonly User: 'User';
- * }
- * ```
- */
-export interface ModelNamesType extends Record<string, string> {
-}
-/**
- * ManagerNames 接口（由业务层扩展以提供代码补全和类型推断）
- * @example
- * ```typescript
- * // 在 .d.ts 文件中扩展
- * interface ManagerNamesType {
- *     readonly Home: 'Home';
- * }
- * ```
- */
-export interface ManagerNamesType extends Record<string, string> {
-}
-/**
- * ViewNames 接口（由业务层扩展以提供代码补全和类型推断）
- */
-export interface ViewNamesType extends Record<string, string> {
-}
+import { ICore, ModelNamesType, ManagerNamesType, ViewNamesType } from "./Api";
 /** Model 名称常量对象，用于代码补全和类型推断 */
 export declare const ModelNames: ModelNamesType;
 /** Manager 名称常量对象，用于代码补全和类型推断 */
@@ -132,6 +103,7 @@ export declare function getViewClass<T>(viewKey: string): new () => T;
 /**
  * 自动注册所有使用装饰器标记的 Model 和 Manager
  * @param core Core 实例
+ * @param options 注册选项
  * @example
  * ```typescript
  * // 导入所有 Model 和 Manager
@@ -140,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/BaseView.d.ts

@@ -1,5 +1,6 @@
 import { Component } from 'cc';
-import { IView, IManager, IModel, IEventManager, ICocosResManager } from '../core';
+import { IView, IEventManager, ICocosResManager } from '../core';
+import { ModelNamesType, ManagerNamesType } from '../core';
 export declare abstract class BaseView extends Component implements IView {
     /** @internal */
     private readonly __isIView__;
@@ -16,6 +17,26 @@ export declare abstract class BaseView extends Component implements IView {
     abstract onEnter(args?: any): void;
     onExit(): void;
     protected onDestroy(): void;
-    protected getManager<T extends IManager>(managerSymbol: symbol): T;
-    protected getModel<T extends IModel>(modelSymbol: symbol): T;
+    /**
+     * 获取 Model 实例
+     * @param modelKey Model 的 Key，使用 ModelNames.XXX
+     * @returns Model 实例（具体类型由 .d.ts 文件的函数重载推断）
+     * @example
+     * ```typescript
+     * // 类型由 .d.ts 文件的重载自动推断
+     * const userModel = this.getModel(ModelNames.User);
+     * ```
+     */
+    protected getModel<T extends keyof ModelNamesType>(modelKey: T): any;
+    /**
+     * 获取 Manager 实例
+     * @param managerKey Manager 的 Key，使用 ManagerNames.XXX
+     * @returns Manager 实例（具体类型由 .d.ts 文件的函数重载推断）
+     * @example
+     * ```typescript
+     * // 类型由 .d.ts 文件的重载自动推断
+     * const gameManager = this.getManager(ManagerNames.Game);
+     * ```
+     */
+    protected getManager<T extends keyof ManagerNamesType>(managerKey: T): any;
 }

package/dist/libs/BaseView.js

@@ -69,13 +69,31 @@ class BaseView extends Component {
         });
         this._loaderHandlers = [];
     }
-    getManager(managerSymbol) {
-        // 业务组件避免直接依赖底层服务定位器，所以使用app.core统一对外接口，方便后续架构演进
-        return mf.core.getManager(managerSymbol);
+    /**
+     * 获取 Model 实例
+     * @param modelKey Model 的 Key，使用 ModelNames.XXX
+     * @returns Model 实例（具体类型由 .d.ts 文件的函数重载推断）
+     * @example
+     * ```typescript
+     * // 类型由 .d.ts 文件的重载自动推断
+     * const userModel = this.getModel(ModelNames.User);
+     * ```
+     */
+    getModel(modelKey) {
+        return mf.core.getModel(modelKey);
     }
-    getModel(modelSymbol) {
-        // 业务组件避免直接依赖底层服务定位器，所以使用app.core统一对外接口，方便后续架构演进
-        return mf.core.getModel(modelSymbol);
+    /**
+     * 获取 Manager 实例
+     * @param managerKey Manager 的 Key，使用 ManagerNames.XXX
+     * @returns Manager 实例（具体类型由 .d.ts 文件的函数重载推断）
+     * @example
+     * ```typescript
+     * // 类型由 .d.ts 文件的重载自动推断
+     * const gameManager = this.getManager(ManagerNames.Game);
+     * ```
+     */
+    getManager(managerKey) {
+        return mf.core.getManager(managerKey);
     }
 }
 

package/dist/libs/UIManager.d.ts

@@ -1,11 +1,12 @@
 import { Component } from "cc";
 import { IUIManager, IView } from "../core";
+import { ViewNamesType } from "../core";
 type ICocosView = IView & Component;
 declare abstract class CcocosUIManager implements IUIManager {
     getTopView(): IView | undefined;
-    open(viewKey: string, args?: any): Promise<IView>;
-    close(viewKey: string | IView, destory?: boolean): void;
-    openAndPush(viewKey: string, 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.34",
+    "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",