dzkcc-mflow 0.0.28 → 0.0.30

package/README.md

@@ -186,7 +186,12 @@ userModel.name;  // ✅ 有完整的代码补全
 
 **编辑器菜单**：**mflow-tools -> generate-types**
 
-📖 **查看文档**: [类型自动推断](./docs/TYPE_INFERENCE.md) | [类型生成工具](./docs/TYPE_GENERATION.md)
+> ⚠️ **如果 getManager/getModel 没有类型提示**？
+> 
+> 需要创建类型映射文件，使用编辑器的 **mflow-tools -> Generate decorator mapping/生成装饰器映射** 自动生成，
+> 或查看 [类型提示问题解决方案](./docs/TYPE_INFERENCE_FIX.md)
+
+📖 **查看文档**: [类型自动推断](./docs/TYPE_INFERENCE.md) | [类型生成工具](./docs/TYPE_GENERATION.md) | [类型提示问题解决](./docs/TYPE_INFERENCE_FIX.md)
 
 ### 9. 开发工具
 
@@ -279,6 +284,7 @@ mf.reddot.setCount('main/bag', 5);
 | [红点系统](./docs/REDDOT_SYSTEM.md) | 红点提示管理 |
 | [类型自动推断](./docs/TYPE_INFERENCE.md) | 类型映射和自动推断 |
 | [类型生成工具](./docs/TYPE_GENERATION.md) | 自动生成类型映射文件 |
+| [类型提示问题解决](./docs/TYPE_INFERENCE_FIX.md) | 解决无类型提示问题 ⭐ |
 | [开发工具](./docs/DEV_TOOLS.md) | 编辑器插件使用 |
 | [完整示例](./docs/COMPLETE_EXAMPLE.md) | 塔防游戏示例 |
 | [最佳实践](./docs/BEST_PRACTICES.md) | 设计原则和规范 |

package/dist/core/Api.d.ts

@@ -1,15 +1,58 @@
+/**
+ * Model 类型映射接口（由业务层扩展）
+ */
+export interface ModelTypeMap extends Record<string, any> {
+}
+/**
+ * Manager 类型映射接口（由业务层扩展）
+ */
+export interface ManagerTypeMap extends Record<string, any> {
+}
+/**
+ * View 类型映射接口（由业务层扩展）
+ */
+export interface ViewTypeMap extends Record<string, any> {
+}
+/**
+ * ModelNames 接口（由业务层扩展）
+ */
+export interface ModelNamesType extends Record<string, symbol> {
+}
+/**
+ * ManagerNames 接口（由业务层扩展）
+ */
+export interface ManagerNamesType extends Record<string, symbol> {
+}
+/**
+ * View 名称接口（用于类型推断，通过生成的 d.ts 文件扩展）
+ * */
+export interface ViewNamesType extends Record<string, symbol> {
+}
+/**
+ * 从 symbol 推断对应的字符串 key
+ */
+type GetKeyFromSymbol<S extends symbol, Names extends Record<string, symbol>> = {
+    [K in keyof Names]: Names[K] extends S ? K : never;
+}[keyof Names];
+/**
+ * 从 Model Symbol 推断类型
+ */
+export type InferModelType<S extends symbol> = GetKeyFromSymbol<S, ModelNamesType> extends keyof ModelTypeMap ? ModelTypeMap[GetKeyFromSymbol<S, ModelNamesType>] : IModel;
+/**
+ * 从 Manager Symbol 推断类型
+ */
+export type InferManagerType<S extends symbol> = GetKeyFromSymbol<S, ManagerNamesType> extends keyof ManagerTypeMap ? ManagerTypeMap[GetKeyFromSymbol<S, ManagerNamesType>] : IManager;
 /**
  * 核心接口 - 管理 Model 和 Manager 的生命周期
  *
- * 注意：返回类型由具体实现类（AbstractCore）决定，
- * 实现类会使用类型推断将 symbol 映射到具体的 Model/Manager 类型
+ * 支持通过 Symbol 自动推断返回类型
  */
 export interface ICore {
     /** 注册 Model - 通过 Symbol 自动实例化 */
     regModel(modelSymbol: symbol): void;
     /**
      * 获取 Model（支持类型自动推断）
-     * @param modelSymbol Model 的 Symbol。返回 any，由实现类提供具体类型
+     * @param modelSymbol Model 的 Symbol，使用 ModelNames.XXX
      * @returns Model 实例，类型会根据 symbol 自动推断为具体的 Model 类型
      * @example
      * ```typescript
@@ -17,12 +60,12 @@ export interface ICore {
      * const userModel = core.getModel(ModelNames.User);
      * ```
      */
-    getModel<S extends symbol>(modelSymbol: S): any;
+    getModel<S extends symbol>(modelSymbol: S): InferModelType<S>;
     /** 注册 Manager - 通过 Symbol 自动实例化 */
     regManager(managerSymbol: symbol): void;
     /**
      * 获取 Manager（支持类型自动推断）
-     * @param managerSymbol Manager 的 Symbol。返回 any，由实现类提供具体类型
+     * @param managerSymbol Manager 的 Symbol，使用 ManagerNames.XXX
      * @returns Manager 实例，类型会根据 symbol 自动推断为具体的 Manager 类型
      * @example
      * ```typescript
@@ -30,7 +73,7 @@ export interface ICore {
      * const gameManager = core.getManager(ManagerNames.Game);
      * ```
      */
-    getManager<S extends symbol>(managerSymbol: S): any;
+    getManager<S extends symbol>(managerSymbol: S): InferManagerType<S>;
 }
 /**
  * Model 基接口 - 数据模型
@@ -225,3 +268,4 @@ export interface IRedDotManager extends IManager {
     /** 移除红点监听 */
     off(path: string, listener: Function): void;
 }
+export {};

package/dist/core/Core.d.ts

@@ -1,20 +1,4 @@
-import { ICore, IManager, IModel } from "./Api";
-import { ModelTypeMap, ManagerTypeMap, ModelNames, ManagerNames } from "./Decorators";
-/**
- * 从 symbol 推断对应的字符串 key
- * @example ModelNames.User -> 'User'
- */
-type GetKeyFromSymbol<S extends symbol, Names extends Record<string, symbol>> = {
-    [K in keyof Names]: Names[K] extends S ? K : never;
-}[keyof Names];
-/**
- * 从 Model Symbol 推断类型
- */
-type InferModelType<S extends symbol> = GetKeyFromSymbol<S, typeof ModelNames> extends keyof ModelTypeMap ? ModelTypeMap[GetKeyFromSymbol<S, typeof ModelNames>] : IModel;
-/**
- * 从 Manager Symbol 推断类型
- */
-type InferManagerType<S extends symbol> = GetKeyFromSymbol<S, typeof ManagerNames> extends keyof ManagerTypeMap ? ManagerTypeMap[GetKeyFromSymbol<S, typeof ManagerNames>] : IManager;
+import { ICore, IManager, InferModelType, InferManagerType } from "./Api";
 export declare abstract class AbstractCore<T extends AbstractCore<T>> implements ICore {
     private readonly container;
     constructor();
@@ -60,4 +44,3 @@ export declare abstract class AbstractManager implements IManager {
      */
     protected getManager<S extends symbol>(managerSymbol: S): InferManagerType<S>;
 }
-export {};

package/dist/core/Decorators.d.ts

@@ -1,46 +1,11 @@
-import { ICore } from "./Api";
+import { ICore, ModelNamesType, ManagerNamesType, ViewNamesType } from "./Api";
 import 'reflect-metadata';
-/** Model 名称接口（用于类型推断，通过生成的 d.ts 文件扩展） */
-export interface ModelNamesType extends Record<string, symbol> {
-}
-/** Manager 名称接口（用于类型推断，通过生成的 d.ts 文件扩展） */
-export interface ManagerNamesType extends Record<string, symbol> {
-}
-/** View 名称接口（用于类型推断，通过生成的 d.ts 文件扩展） */
-export interface ViewNamesType extends Record<string, symbol> {
-}
 /** Model 名称到 Symbol 的映射，用于代码补全和类型推断 */
 export declare const ModelNames: ModelNamesType;
 /** Manager 名称到 Symbol 的映射，用于代码补全和类型推断 */
 export declare const ManagerNames: ManagerNamesType;
 /** View 名称到 Symbol 的映射，用于代码补全和类型推断 */
 export declare const ViewNames: ViewNamesType;
-/**
- * Symbol 到类型的映射接口，用于类型推断
- * 业务层通过 declare module 扩展此接口来注册类型
- * @example
- * ```typescript
- * declare module 'dzkcc-mflow/core' {
- *   interface ModelTypeMap {
- *     'User': UserModel;  // 使用字符串字面量作为 key
- *   }
- * }
- * ```
- */
-export interface ModelTypeMap extends Record<string, any> {
-}
-/**
- * Symbol 到类型的映射接口，用于类型推断
- * 业务层通过 declare module 扩展此接口来注册类型
- */
-export interface ManagerTypeMap extends Record<string, any> {
-}
-/**
- * Symbol 到类型的映射接口，用于类型推断
- * 业务层通过 declare module 扩展此接口来注册类型
- */
-export interface ViewTypeMap extends Record<string, any> {
-}
 /**
  * Model 装饰器，用于注册 Model 到全局注册表
  * @param name 可选的 Model 名称，如果不提供则使用类名

package/dist/core/Decorators.js

@@ -1,5 +1,8 @@
 import 'reflect-metadata';
 
+// ============================================================================
+// Symbol 注册系统 - Names 对象（提供代码补全和类型推断）
+// ============================================================================
 /** Model 名称到 Symbol 的映射，用于代码补全和类型推断 */
 const ModelNames = {};
 /** Manager 名称到 Symbol 的映射，用于代码补全和类型推断 */

package/package.json

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