@cocojs/mvc 0.0.1-alpha202511172037 → 0.1.0-beta.6

package/dist/index.d.ts

@@ -17,6 +17,8 @@ export declare class Application {
     metadataRepository: MetadataRepository;
     idClassMap: IdClassMap;
     propertiesConfig: PropertiesConfig;
+    iocComponentDefinition: IocComponentDefinition;
+    iocComponentFactory: IocComponentFactory;
     constructor(jsonConfig?: Record<string, any>);
     /**
      * 在项目中，所以的组件都已经收集到coco/index里面了，所以不需要进行组件收集；
@@ -43,7 +45,7 @@ export declare class Application {
      */
     getViewComponent<T>(viewClass: Class<T>, props?: any[]): any;
     listFieldByMetadataCls(beDecoratedCls: Class<any>, MetadataCls: Class<any>): string[];
-    findClassKindMetadataRecursively(beDecoratedCls: Class<any>, TargetCls: Class<any>, upward?: number): any;
+    findClassKindMetadataRecursively(beDecoratedCls: Class<any>, TargetCls: Class<any>, levels?: number): any;
     listBeDecoratedClsByClassKindMetadata(MetadataCls: Class<any>): Map<Class<any>, Metadata>;
     getMetaClassById(id: string): Class<Metadata>;
     /**
@@ -61,6 +63,8 @@ declare class Application_2 {
     metadataRepository: MetadataRepository_2;
     idClassMap: IdClassMap_2;
     propertiesConfig: PropertiesConfig_2;
+    iocComponentDefinition: IocComponentDefinition_2;
+    iocComponentFactory: IocComponentFactory_2;
     constructor(jsonConfig?: Record<string, any>);
     /**
      * 在项目中，所以的组件都已经收集到coco/index里面了，所以不需要进行组件收集；
@@ -87,7 +91,7 @@ declare class Application_2 {
      */
     getViewComponent<T>(viewClass: Class<T>, props?: any[]): any;
     listFieldByMetadataCls(beDecoratedCls: Class<any>, MetadataCls: Class<any>): string[];
-    findClassKindMetadataRecursively(beDecoratedCls: Class<any>, TargetCls: Class<any>, upward?: number): any;
+    findClassKindMetadataRecursively(beDecoratedCls: Class<any>, TargetCls: Class<any>, levels?: number): any;
     listBeDecoratedClsByClassKindMetadata(MetadataCls: Class<any>): Map<Class<any>, Metadata_2>;
     getMetaClassById(id: string): Class<Metadata_2>;
     /**
@@ -105,6 +109,8 @@ declare class Application_3 {
     metadataRepository: MetadataRepository_3;
     idClassMap: IdClassMap_3;
     propertiesConfig: PropertiesConfig_3;
+    iocComponentDefinition: IocComponentDefinition_3;
+    iocComponentFactory: IocComponentFactory_3;
     constructor(jsonConfig?: Record<string, any>);
     /**
      * 在项目中，所以的组件都已经收集到coco/index里面了，所以不需要进行组件收集；
@@ -131,7 +137,7 @@ declare class Application_3 {
      */
     getViewComponent<T>(viewClass: Class<T>, props?: any[]): any;
     listFieldByMetadataCls(beDecoratedCls: Class<any>, MetadataCls: Class<any>): string[];
-    findClassKindMetadataRecursively(beDecoratedCls: Class<any>, TargetCls: Class<any>, upward?: number): any;
+    findClassKindMetadataRecursively(beDecoratedCls: Class<any>, TargetCls: Class<any>, levels?: number): any;
     listBeDecoratedClsByClassKindMetadata(MetadataCls: Class<any>): Map<Class<any>, Metadata_4>;
     getMetaClassById(id: string): Class<Metadata_4>;
     /**
@@ -217,6 +223,7 @@ declare type ComponentFieldPostConstructFn = (metadata: Metadata, application: A
 
 declare class ComponentMetadataClass {
     isComponent: Map<Class<Metadata>, boolean>;
+    destructor(): void;
     isComponentMetadata(MetadataClass: Class<Metadata>): boolean;
     /**
      * 校验元数据类的组件类，过滤掉所有非法的组件元数据信息
@@ -234,6 +241,7 @@ declare class ComponentMetadataClass {
 
 declare class ComponentMetadataClass_2 {
     isComponent: Map<Class<Metadata_2>, boolean>;
+    destructor(): void;
     isComponentMetadata(MetadataClass: Class<Metadata_2>): boolean;
     /**
      * 校验元数据类的组件类，过滤掉所有非法的组件元数据信息
@@ -251,6 +259,7 @@ declare class ComponentMetadataClass_2 {
 
 declare class ComponentMetadataClass_3 {
     isComponent: Map<Class<Metadata_4>, boolean>;
+    destructor(): void;
     isComponentMetadata(MetadataClass: Class<Metadata_4>): boolean;
     /**
      * 校验元数据类的组件类，过滤掉所有非法的组件元数据信息
@@ -281,6 +290,21 @@ export declare class Configuration extends Metadata {
 
 export declare const configuration: () => Decorator<ClassDecoratorContext>;
 
+declare type ConstructOption = {
+    classOrId: Class<any> | string;
+    qualifier?: string;
+};
+
+declare type ConstructOption_2 = {
+    classOrId: Class<any> | string;
+    qualifier?: string;
+};
+
+declare type ConstructOption_3 = {
+    classOrId: Class<any> | string;
+    qualifier?: string;
+};
+
 /**
  * @public
  */
@@ -317,7 +341,8 @@ declare interface CreateDecoratorExpOption {
 }
 
 /**
- * 创建一个未绑定元数据的装饰器表达式，后续通过表达式的第二个参数来绑定
+ * 创建一个未绑定元数据的装饰器表达式
+ * 需要在正式的元数据类上添加decorateSelf装饰器来关联真实的元数据类，装饰器到其他类的使用方式和createDecoratorExp是一致的。
  * 适用于装饰器装饰自己元数据类的场景
  * @public
  */
@@ -347,6 +372,8 @@ declare interface DecoratorExpWithDecoratorSelf<T extends any> {
     decorateSelf: (userParam?: T) => Decorator<DecoratorContext>;
 }
 
+export declare function defineReactive(object: Record<any, any>, field: string, getter: IGetter, setter?: ISetter): void;
+
 declare interface Diagnose {
     code: DiagnoseCode;
     args: any[];
@@ -387,6 +414,9 @@ declare enum DiagnoseCode {
     'CO10022' = 'CO10022', // 元数据类不能有字段装饰器
     'CO10023' = 'CO10023', // 元数据类不能有方法装饰器
     'CO10024' = 'CO10024', // 元数据类存在多个组件装饰器
+    'CO10025' = 'CO10025', // findClassKindMetadataRecursively参数错误，入参不是元数据类
+    'CO10026' = 'CO10026', // 不能添加多个相同的 field 装饰器
+    'CO10027' = 'CO10027', // 不能添加多个相同的 method 装饰器
 }
 
 declare enum DiagnoseCode_2 {
@@ -414,6 +444,9 @@ declare enum DiagnoseCode_2 {
     'CO10022' = 'CO10022', // 元数据类不能有字段装饰器
     'CO10023' = 'CO10023', // 元数据类不能有方法装饰器
     'CO10024' = 'CO10024', // 元数据类存在多个组件装饰器
+    'CO10025' = 'CO10025', // findClassKindMetadataRecursively参数错误，入参不是元数据类
+    'CO10026' = 'CO10026', // 不能添加多个相同的 field 装饰器
+    'CO10027' = 'CO10027', // 不能添加多个相同的 method 装饰器
 }
 
 declare enum DiagnoseCode_3 {
@@ -441,6 +474,9 @@ declare enum DiagnoseCode_3 {
     'CO10022' = 'CO10022', // 元数据类不能有字段装饰器
     'CO10023' = 'CO10023', // 元数据类不能有方法装饰器
     'CO10024' = 'CO10024', // 元数据类存在多个组件装饰器
+    'CO10025' = 'CO10025', // findClassKindMetadataRecursively参数错误，入参不是元数据类
+    'CO10026' = 'CO10026', // 不能添加多个相同的 field 装饰器
+    'CO10027' = 'CO10027', // 不能添加多个相同的 method 装饰器
 }
 
 declare class DynamicRoute {
@@ -500,14 +536,13 @@ export declare class Id extends Metadata {
     value: string;
 }
 
-/**
- * @public
- * @id()装饰器
- * 用于为元数据类或者组件类设置id，id的作用是可以根据id返回元数据类，也可以根据id实例化组件，所以id必须要唯一。
- * 如果一个组件不添加id装饰器，那么组件或者元数据类的id就是class.name（webpack目前打包不会压缩class关键字，TODO: rollup打包会压缩class关键字，要么强制添加id装饰器，要么强制不压缩class关键字）
- * 如果用户显式设置了id装饰器，那么会使用用户设置的id
- */
-export declare const id: DecoratorExpWithDecoratorSelf<string>;
+export declare const id: (id: string) => Decorator<ClassMethodDecoratorContext>;
+
+declare type Id_2 = string;
+
+declare type Id_2_2 = string;
+
+declare type Id_2_3 = string;
 
 declare class IdClassMap {
     private idClassMap;
@@ -517,7 +552,7 @@ declare class IdClassMap {
      */
     constructor(metaMetadataMap: Map<Class<Metadata>, MetaMetadata>);
     /**
-     * * 根据id获取元数据类
+     * * 根据$$id获取元数据类
      * * @param id 元数据类id
      * * @returns 元数据类
      */
@@ -533,7 +568,7 @@ declare class IdClassMap_2 {
      */
     constructor(metaMetadataMap: Map<Class<Metadata_2>, MetaMetadata_2>);
     /**
-     * * 根据id获取元数据类
+     * * 根据$$id获取元数据类
      * * @param id 元数据类id
      * * @returns 元数据类
      */
@@ -549,7 +584,7 @@ declare class IdClassMap_3 {
      */
     constructor(metaMetadataMap: Map<Class<Metadata_4>, MetaMetadata_3>);
     /**
-     * * 根据id获取元数据类
+     * * 根据$$id获取元数据类
      * * @param id 元数据类id
      * * @returns 元数据类
      */
@@ -557,6 +592,152 @@ declare class IdClassMap_3 {
     destructor(): void;
 }
 
+declare interface IGetter {
+    (): any;
+}
+
+/**
+ * 所有被扫描的规范的组件
+ * 包括：
+ * 1. 项目中添加@component类装饰的组件
+ * 2. 第三方添加@component类装饰的组件
+ * 3. 项目中通过@component方法装饰注册的组件
+ */
+declare interface IocComDef<T> {
+    id: string;
+    cls: Class<T>;
+    isSingleton: boolean;
+    instantiateType: 'new' | 'method';
+    methodInstantiateOpts?: {
+        configurationCls: Class<any>;
+        method: string;
+    };
+}
+
+/**
+ * 所有被扫描的规范的组件
+ * 包括：
+ * 1. 项目中添加@component类装饰的组件
+ * 2. 第三方添加@component类装饰的组件
+ * 3. 项目中通过@component方法装饰注册的组件
+ */
+declare interface IocComDef_2<T> {
+    id: string;
+    cls: Class<T>;
+    isSingleton: boolean;
+    instantiateType: 'new' | 'method';
+    methodInstantiateOpts?: {
+        configurationCls: Class<any>;
+        method: string;
+    };
+}
+
+/**
+ * 所有被扫描的规范的组件
+ * 包括：
+ * 1. 项目中添加@component类装饰的组件
+ * 2. 第三方添加@component类装饰的组件
+ * 3. 项目中通过@component方法装饰注册的组件
+ */
+declare interface IocComDef_3<T> {
+    id: string;
+    cls: Class<T>;
+    isSingleton: boolean;
+    instantiateType: 'new' | 'method';
+    methodInstantiateOpts?: {
+        configurationCls: Class<any>;
+        method: string;
+    };
+}
+
+declare class IocComponentDefinition {
+    idDefinitionMap: Map<Id_2, IocComDef<any>>;
+    clsDefinitionMap: Map<Class<any>, IocComDef<any>>;
+    newIocComponentDefinition<T>(id: string, cls: Class<T>, isSingleton: boolean, instantiateType: 'new' | 'method'): IocComDef<T>;
+    addDefinition(cls: Class<any>, id: string, isSingleton: boolean, methodInstantiateOpts?: {
+        configurationCls: Class<any>;
+        method: string;
+    }): void;
+    /**
+     * 获取真正会实例化的类定义
+     * @param ClsOrId 想要实例化的类或类id
+     * @param qualifier 如果存在多个后端类，需要通过qualifier指定具体的类id
+     * @returns 真正会实例化的类定义
+     */
+    getInstantiateDefinition(ClsOrId: Class<any> | Id_2, qualifier?: string): IocComDef<any>;
+    getDefinition(ClsOrId: Class<any> | Id_2): IocComDef<any>;
+    existDefinition(ClsOrId: Class<any> | Id_2): boolean;
+    destructor(): void;
+}
+
+declare class IocComponentDefinition_2 {
+    idDefinitionMap: Map<Id_2_2, IocComDef_2<any>>;
+    clsDefinitionMap: Map<Class<any>, IocComDef_2<any>>;
+    newIocComponentDefinition<T>(id: string, cls: Class<T>, isSingleton: boolean, instantiateType: 'new' | 'method'): IocComDef_2<T>;
+    addDefinition(cls: Class<any>, id: string, isSingleton: boolean, methodInstantiateOpts?: {
+        configurationCls: Class<any>;
+        method: string;
+    }): void;
+    /**
+     * 获取真正会实例化的类定义
+     * @param ClsOrId 想要实例化的类或类id
+     * @param qualifier 如果存在多个后端类，需要通过qualifier指定具体的类id
+     * @returns 真正会实例化的类定义
+     */
+    getInstantiateDefinition(ClsOrId: Class<any> | Id_2_2, qualifier?: string): IocComDef_2<any>;
+    getDefinition(ClsOrId: Class<any> | Id_2_2): IocComDef_2<any>;
+    existDefinition(ClsOrId: Class<any> | Id_2_2): boolean;
+    destructor(): void;
+}
+
+declare class IocComponentDefinition_3 {
+    idDefinitionMap: Map<Id_2_3, IocComDef_3<any>>;
+    clsDefinitionMap: Map<Class<any>, IocComDef_3<any>>;
+    newIocComponentDefinition<T>(id: string, cls: Class<T>, isSingleton: boolean, instantiateType: 'new' | 'method'): IocComDef_3<T>;
+    addDefinition(cls: Class<any>, id: string, isSingleton: boolean, methodInstantiateOpts?: {
+        configurationCls: Class<any>;
+        method: string;
+    }): void;
+    /**
+     * 获取真正会实例化的类定义
+     * @param ClsOrId 想要实例化的类或类id
+     * @param qualifier 如果存在多个后端类，需要通过qualifier指定具体的类id
+     * @returns 真正会实例化的类定义
+     */
+    getInstantiateDefinition(ClsOrId: Class<any> | Id_2_3, qualifier?: string): IocComDef_3<any>;
+    getDefinition(ClsOrId: Class<any> | Id_2_3): IocComDef_3<any>;
+    existDefinition(ClsOrId: Class<any> | Id_2_3): boolean;
+    destructor(): void;
+}
+
+declare class IocComponentFactory {
+    singletonInstances: Map<Class<any>, any>;
+    private createComponent;
+    getComponents(application: Application, userOption: ConstructOption): any;
+    getViewComponent(application: Application, viewClass: Class<any>, props: any[]): any;
+    destructor(): void;
+}
+
+declare class IocComponentFactory_2 {
+    singletonInstances: Map<Class<any>, any>;
+    private createComponent;
+    getComponents(application: Application_2, userOption: ConstructOption_2): any;
+    getViewComponent(application: Application_2, viewClass: Class<any>, props: any[]): any;
+    destructor(): void;
+}
+
+declare class IocComponentFactory_3 {
+    singletonInstances: Map<Class<any>, any>;
+    private createComponent;
+    getComponents(application: Application_3, userOption: ConstructOption_3): any;
+    getViewComponent(application: Application_3, viewClass: Class<any>, props: any[]): any;
+    destructor(): void;
+}
+
+declare interface ISetter {
+    (object: Record<any, any>, field: string, newValue: any): void;
+}
+
 declare function jsx(component: any, config: any, maybeKey?: any): {
     $$typeof: any;
     type: any;
@@ -680,10 +861,12 @@ declare class MetadataRepository {
      */
     listMethodKindMetadata(beDecoratedCls: Class<any>, field: Field, findMetadataCls?: Class<any>): Metadata[];
     /**
-     * 在类的所有类类型的元数据中递归查找某个元数据类实例，找到就直接返回
-     * TODO: 因为现在组件装饰器的层数没有限制了，那么upward这个参数是否还有必要存在
+     * listClassKindMetadata的递归版本，在类装饰器的元数据类递归，但只返回一个
+     * @param beDecoratedCls 被查找的类
+     * @param TargetCls 想要匹配的元数据类定义
+     * @param levels 递归层数，默认无限制，就是查找所有的装饰器的元数据类，也可以使用数字指定，0表示只查当前装饰器，1表示再查当前装饰器的元数据的装饰器，依次类推
      */
-    findClassKindMetadataRecursively(beDecoratedCls: Class<any>, TargetCls: Class<any>, upward?: number): any;
+    findClassKindMetadataRecursively(beDecoratedCls: Class<any>, TargetCls: Class<any>, levels?: number): any;
     /**
      * 返回包含指定元数据类的所有field
      * @param beDecoratedCls 指定类
@@ -735,10 +918,12 @@ declare class MetadataRepository_2 {
      */
     listMethodKindMetadata(beDecoratedCls: Class<any>, field: Field_2, findMetadataCls?: Class<any>): Metadata_2[];
     /**
-     * 在类的所有类类型的元数据中递归查找某个元数据类实例，找到就直接返回
-     * TODO: 因为现在组件装饰器的层数没有限制了，那么upward这个参数是否还有必要存在
+     * listClassKindMetadata的递归版本，在类装饰器的元数据类递归，但只返回一个
+     * @param beDecoratedCls 被查找的类
+     * @param TargetCls 想要匹配的元数据类定义
+     * @param levels 递归层数，默认无限制，就是查找所有的装饰器的元数据类，也可以使用数字指定，0表示只查当前装饰器，1表示再查当前装饰器的元数据的装饰器，依次类推
      */
-    findClassKindMetadataRecursively(beDecoratedCls: Class<any>, TargetCls: Class<any>, upward?: number): any;
+    findClassKindMetadataRecursively(beDecoratedCls: Class<any>, TargetCls: Class<any>, levels?: number): any;
     /**
      * 返回包含指定元数据类的所有field
      * @param beDecoratedCls 指定类
@@ -790,10 +975,12 @@ declare class MetadataRepository_3 {
      */
     listMethodKindMetadata(beDecoratedCls: Class<any>, field: Field_3, findMetadataCls?: Class<any>): Metadata_4[];
     /**
-     * 在类的所有类类型的元数据中递归查找某个元数据类实例，找到就直接返回
-     * TODO: 因为现在组件装饰器的层数没有限制了，那么upward这个参数是否还有必要存在
+     * listClassKindMetadata的递归版本，在类装饰器的元数据类递归，但只返回一个
+     * @param beDecoratedCls 被查找的类
+     * @param TargetCls 想要匹配的元数据类定义
+     * @param levels 递归层数，默认无限制，就是查找所有的装饰器的元数据类，也可以使用数字指定，0表示只查当前装饰器，1表示再查当前装饰器的元数据的装饰器，依次类推
      */
-    findClassKindMetadataRecursively(beDecoratedCls: Class<any>, TargetCls: Class<any>, upward?: number): any;
+    findClassKindMetadataRecursively(beDecoratedCls: Class<any>, TargetCls: Class<any>, levels?: number): any;
     /**
      * 返回包含指定元数据类的所有field
      * @param beDecoratedCls 指定类
@@ -838,12 +1025,11 @@ export declare const page: () => Decorator_2<ClassDecoratorContext>;
 declare type Params = {
     metadataKind: Kind;
     metadataClass: Class<any>;
-    placeholderMetadataClass?: Class<any>;
     metadataParam: any;
     /**
      * 如果metadataKind是'class'，field是undefined
-     * 如果metadataKind是'method'\'field'，field就是对应的prop名字
-     * todo 测试是否支持Symbol类型
+     * 如果metadataKind是'method'\'field'，field就是对应的函数名或字段名
+     * TODO: 测试是否支持Symbol类型
      */
     field?: Field;
 };
@@ -851,12 +1037,11 @@ declare type Params = {
 declare type Params_2 = {
     metadataKind: Kind_2;
     metadataClass: Class<any>;
-    placeholderMetadataClass?: Class<any>;
     metadataParam: any;
     /**
      * 如果metadataKind是'class'，field是undefined
-     * 如果metadataKind是'method'\'field'，field就是对应的prop名字
-     * todo 测试是否支持Symbol类型
+     * 如果metadataKind是'method'\'field'，field就是对应的函数名或字段名
+     * TODO: 测试是否支持Symbol类型
      */
     field?: Field_2;
 };
@@ -864,12 +1049,11 @@ declare type Params_2 = {
 declare type Params_3 = {
     metadataKind: Kind_3;
     metadataClass: Class<any>;
-    placeholderMetadataClass?: Class<any>;
     metadataParam: any;
     /**
      * 如果metadataKind是'class'，field是undefined
-     * 如果metadataKind是'method'\'field'，field就是对应的prop名字
-     * todo 测试是否支持Symbol类型
+     * 如果metadataKind是'method'\'field'，field就是对应的函数名或字段名
+     * TODO: 测试是否支持Symbol类型
      */
     field?: Field_3;
 };
@@ -910,15 +1094,6 @@ declare class PropertiesConfig_3 {
     getAllBootComponents(): string[];
 }
 
-export declare class Publisher {
-    private readonly name;
-    private subscribers;
-    constructor(name?: string);
-    addListener(subscriber: Subscriber): void;
-    removeListener(subscriber: Subscriber): void;
-    notify(): void;
-}
-
 /**
  * @public
  */
@@ -1051,7 +1226,7 @@ export declare class Store extends Metadata_3 {
 
 export declare const store: () => Decorator_2<ClassDecoratorContext>;
 
-export declare class StorePublisher {
+declare class StorePublisher {
     private id;
     private subscribers;
     constructor();
@@ -1071,18 +1246,6 @@ export declare class StoreSubscriber {
     exec(): void;
 }
 
-export declare class Subscriber {
-    static Executing: Subscriber;
-    private isDirty;
-    private publishers;
-    private readonly fn;
-    private value;
-    constructor(bindThisFn: Function);
-    subscribe: (publisher: Publisher) => void;
-    memoizedFn: () => any;
-    dirty(): void;
-}
-
 /**
  * @public
  */

package/package.json

@@ -1,29 +1,37 @@
 {
-    "name": "@cocojs/mvc",
-    "version": "0.0.1-alpha202511172037",
-    "description": "由装饰器驱动，快速构建可扩展的 Web 应用。",
-    "main": "dist/index.cjs.js",
-    "types": "dist/index.d.ts",
-    "scripts": {},
-    "exports": {
-        ".": {
-            "import": "./dist/index.cjs.js",
-            "require": "./dist/index.cjs.js",
-            "types": "./dist/index.d.ts"
-        },
-        "./jsx-runtime": {
-            "import": "./dist/index.cjs.js",
-            "require": "./dist/index.cjs.js",
-            "types": "./dist/index.d.ts"
-        }
+  "name": "@cocojs/mvc",
+  "version": "0.1.0-beta.6",
+  "description": "由装饰器驱动，快速构建可扩展的 Web 应用。",
+  "main": "dist/index.cjs.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.cjs.js",
+      "require": "./dist/index.cjs.js",
+      "types": "./dist/index.d.ts"
     },
-    "files": [
-        "dist"
-    ],
-    "keywords": [
-        "cocojs"
-    ],
-    "author": "",
-    "homepage": "https://github.com/cocojs-org/coconut-framework",
-    "license": "MIT"
-}
+    "./jsx-runtime": {
+      "import": "./dist/index.cjs.js",
+      "require": "./dist/index.cjs.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "cocojs"
+  ],
+  "author": "",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "homepage": "https://github.com/cocojs-org/coconut-framework",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cocojs-org/coconut-framework.git"
+  },
+  "license": "MIT",
+  "scripts": {}
+}