dzkcc-mflow 0.0.26 → 0.0.28

package/dist/core/Api.d.ts

@@ -1,23 +1,36 @@
 /**
  * 核心接口 - 管理 Model 和 Manager 的生命周期
+ *
+ * 注意：返回类型由具体实现类（AbstractCore）决定，
+ * 实现类会使用类型推断将 symbol 映射到具体的 Model/Manager 类型
  */
 export interface ICore {
     /** 注册 Model - 通过 Symbol 自动实例化 */
     regModel(modelSymbol: symbol): void;
     /**
      * 获取 Model（支持类型自动推断）
-     * @param modelSymbol Model 的 Symbol
-     * @returns Model 实例，类型会根据 ModelTypeMap 自动推断
+     * @param modelSymbol Model 的 Symbol。返回 any，由实现类提供具体类型
+     * @returns Model 实例，类型会根据 symbol 自动推断为具体的 Model 类型
+     * @example
+     * ```typescript
+     * // 自动推断为 UserModel 类型
+     * const userModel = core.getModel(ModelNames.User);
+     * ```
      */
-    getModel<S extends symbol = symbol>(modelSymbol: S): IModel;
+    getModel<S extends symbol>(modelSymbol: S): any;
     /** 注册 Manager - 通过 Symbol 自动实例化 */
     regManager(managerSymbol: symbol): void;
     /**
      * 获取 Manager（支持类型自动推断）
-     * @param managerSymbol Manager 的 Symbol
-     * @returns Manager 实例，类型会根据 ManagerTypeMap 自动推断
+     * @param managerSymbol Manager 的 Symbol。返回 any，由实现类提供具体类型
+     * @returns Manager 实例，类型会根据 symbol 自动推断为具体的 Manager 类型
+     * @example
+     * ```typescript
+     * // 自动推断为 GameManager 类型
+     * const gameManager = core.getManager(ManagerNames.Game);
+     * ```
      */
-    getManager<S extends symbol = symbol>(managerSymbol: S): IManager;
+    getManager<S extends symbol>(managerSymbol: S): any;
 }
 /**
  * Model 基接口 - 数据模型

package/dist/core/Core.d.ts

@@ -1,5 +1,20 @@
 import { ICore, IManager, IModel } from "./Api";
-import { ModelTypeMap, ManagerTypeMap } from "./Decorators";
+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;
 export declare abstract class AbstractCore<T extends AbstractCore<T>> implements ICore {
     private readonly container;
     constructor();
@@ -15,7 +30,7 @@ export declare abstract class AbstractCore<T extends AbstractCore<T>> implements
      * const userModel = core.getModel(ModelNames.User);
      * ```
      */
-    getModel<S extends symbol>(modelSymbol: S): S extends keyof ModelTypeMap ? ModelTypeMap[S] : IModel;
+    getModel<S extends symbol>(modelSymbol: S): InferModelType<S>;
     regManager(managerSymbol: symbol): void;
     /**
      * 获取 Manager 实例（支持类型自动推断）
@@ -27,7 +42,7 @@ export declare abstract class AbstractCore<T extends AbstractCore<T>> implements
      * const gameManager = core.getManager(ManagerNames.Game);
      * ```
      */
-    getManager<S extends symbol>(managerSymbol: S): S extends keyof ManagerTypeMap ? ManagerTypeMap[S] : IManager;
+    getManager<S extends symbol>(managerSymbol: S): InferManagerType<S>;
 }
 export declare abstract class AbstractManager implements IManager {
     abstract initialize(): void;
@@ -37,11 +52,12 @@ export declare abstract class AbstractManager implements IManager {
      * @param modelSymbol Model 的 Symbol，使用 ModelNames.XXX
      * @returns Model 实例，类型会根据 symbol 自动推断
      */
-    protected getModel<S extends symbol>(modelSymbol: S): S extends keyof ModelTypeMap ? ModelTypeMap[S] : IModel;
+    protected getModel<S extends symbol>(modelSymbol: S): InferModelType<S>;
     /**
      * 获取 Manager 实例（支持类型自动推断）
      * @param managerSymbol Manager 的 Symbol，使用 ManagerNames.XXX
      * @returns Manager 实例，类型会根据 symbol 自动推断
      */
-    protected getManager<S extends symbol>(managerSymbol: S): S extends keyof ManagerTypeMap ? ManagerTypeMap[S] : IManager;
+    protected getManager<S extends symbol>(managerSymbol: S): InferManagerType<S>;
 }
+export {};

package/dist/core/Decorators.d.ts

@@ -1,36 +1,45 @@
 import { ICore } 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: Record<string, symbol>;
+export declare const ModelNames: ModelNamesType;
 /** Manager 名称到 Symbol 的映射，用于代码补全和类型推断 */
-export declare const ManagerNames: Record<string, symbol>;
+export declare const ManagerNames: ManagerNamesType;
 /** View 名称到 Symbol 的映射，用于代码补全和类型推断 */
-export declare const ViewNames: Record<string, symbol>;
+export declare const ViewNames: ViewNamesType;
 /**
  * Symbol 到类型的映射接口，用于类型推断
  * 业务层通过 declare module 扩展此接口来注册类型
  * @example
  * ```typescript
- * declare module '@/core/Decorators' {
+ * declare module 'dzkcc-mflow/core' {
  *   interface ModelTypeMap {
- *     [ModelNames.User]: UserModel;
+ *     'User': UserModel;  // 使用字符串字面量作为 key
  *   }
  * }
  * ```
  */
-export interface ModelTypeMap {
+export interface ModelTypeMap extends Record<string, any> {
 }
 /**
  * Symbol 到类型的映射接口，用于类型推断
  * 业务层通过 declare module 扩展此接口来注册类型
  */
-export interface ManagerTypeMap {
+export interface ManagerTypeMap extends Record<string, any> {
 }
 /**
  * Symbol 到类型的映射接口，用于类型推断
  * 业务层通过 declare module 扩展此接口来注册类型
  */
-export interface ViewTypeMap {
+export interface ViewTypeMap extends Record<string, any> {
 }
 /**
  * Model 装饰器，用于注册 Model 到全局注册表

package/dist/core/Decorators.js

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

package/package.json

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