dzkcc-mflow 0.0.34 → 0.0.35

package/dist/core/Api.d.ts

@@ -1,3 +1,32 @@
+/**
+ * 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 的生命周期
  *
@@ -5,7 +34,7 @@
  */
 export interface ICore {
     /** 注册 Model - 通过 Key 自动实例化 */
-    regModel(modelKey: string): void;
+    regModel<T extends keyof ModelNamesType>(modelKey: T): void;
     /**
      * 获取 Model 实例
      * @param modelKey Model 的 Key，使用 ModelNames.XXX
@@ -16,9 +45,9 @@ export interface ICore {
      * const userModel = core.getModel(ModelNames.User);
      * ```
      */
-    getModel(modelKey: string): any;
+    getModel<T extends keyof ModelNamesType>(modelKey: T): any;
     /** 注册 Manager - 通过 Key 自动实例化 */
-    regManager(managerKey: string): void;
+    regManager<T extends keyof ManagerNamesType>(managerKey: T): void;
     /**
      * 获取 Manager 实例
      * @param managerKey Manager 的 Key，使用 ManagerNames.XXX
@@ -29,7 +58,7 @@ export interface ICore {
      * const gameManager = core.getManager(ManagerNames.Game);
      * ```
      */
-    getManager(managerKey: string): any;
+    getManager<T extends keyof ManagerNamesType>(managerKey: T): any;
 }
 /**
  * Model 基接口 - 数据模型
@@ -67,11 +96,11 @@ export interface IView {
  */
 export interface IUIManager {
     /** 打开视图 */
-    open(viewKey: string, args?: any): Promise<IView>;
+    open<T extends keyof ViewNamesType>(viewKey: T, args?: any): Promise<IView>;
     /** 关闭视图 */
-    close(viewKey: string | IView, destory?: boolean): void;
+    close<T extends keyof ViewNamesType>(viewKey: T | IView, destory?: boolean): void;
     /** 打开视图并入栈 */
-    openAndPush(viewKey: string, group: string, args?: any): Promise<IView>;
+    openAndPush<T extends keyof ViewNamesType>(viewKey: T, 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<T extends keyof ModelNamesType>(modelKey: T): 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<T extends keyof ModelNamesType>(modelKey: T): any;
+    regManager<T extends keyof ManagerNamesType>(managerKey: T): void;
     /**
      * 获取 Manager 实例
      * @param managerKey Manager 的 Key，使用 ManagerNames.XXX
@@ -26,7 +26,7 @@ export declare abstract class AbstractCore<T extends AbstractCore<T>> implements
      * const gameManager = core.getManager(ManagerNames.Game);
      * ```
      */
-    getManager(managerKey: string): any;
+    getManager<T extends keyof ManagerNamesType>(managerKey: T): any;
 }
 export declare abstract class AbstractManager implements IManager {
     abstract initialize(): void;
@@ -36,11 +36,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<T extends keyof ModelNamesType>(modelKey: T): any;
     /**
      * 获取 Manager 实例
      * @param managerKey Manager 的 Key，使用 ManagerNames.XXX
      * @returns Manager 实例（具体类型由 .d.ts 文件的函数重载推断）
      */
-    protected getManager(managerKey: string): any;
+    protected getManager<T extends keyof ManagerNamesType>(managerKey: T): any;
 }

package/dist/core/Core.js

@@ -22,9 +22,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 +43,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();
     }
     /**

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 名称常量对象，用于代码补全和类型推断 */

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<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>;
     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.35",
     "description": "A modular design and process management framework developed for the cocos engine, suitable for decoupling and dependency injection.",
     "author": "duanzhk",
     "license": "MIT",