annil 1.1.1 → 1.1.2

package/src/api/RootComponent/Watch/test/WatchProperties.test.ts

@@ -1,15 +1,7 @@
 import { Checking, type Test } from "hry-types";
-
 import type { ReadonlyDeep } from "hry-types/src/Any/_api";
-import { RootComponent } from "../..";
-
 import type { DetailedType } from "../../../..";
-// import {
-//   type Mock_Cart,
-//   mock_requiredTypes,
-//   mock_requiredUnion,
-//   type Mock_User,
-// } from "../../Properties/expected/normalRequired";
+import { RootComponent } from "../..";
 import type { OptionalType } from "../../Properties/PropertiesConstraint";
 import {
   type Mock_Cart,
@@ -155,8 +147,5 @@ RootComponent()({
 
       Checking<string, typeof oldValue, Test.Pass>;
     },
-
-    "optional_objOrNull.age"() {
-    },
   },
 });

package/src/api/RootComponent/index.ts

@@ -26,13 +26,12 @@ import type { PageLifetimesOption } from "./PageLifetimes/PageLifetimesOption";
 import type { GetPropertiesDoc } from "./Properties/GetPropertiesDoc";
 import type { PropertiesConstraint } from "./Properties/PropertiesConstraint";
 import type { PropertiesOption } from "./Properties/PropertiesOption";
-import type { GeTStoreDoc } from "./Store/GeTStoreDoc";
+import type { GetStoreDoc } from "./Store/GeTStoreDoc";
 import type { StoreConstraint } from "./Store/StoreConstraint";
 import type { StoreOption } from "./Store/StoreOption";
 import type { WatchOption } from "./Watch/WatchOption";
 
 type RootComponentOptions<
-  TReceivedComponentDoc extends object,
   TEvents extends object,
   TIsPage extends boolean,
   TCustomEvents extends CustomEventConstraint,
@@ -51,11 +50,11 @@ type RootComponentOptions<
   & MethodsOption<TMethods, keyof (EventsDoc & CustomEventsDoc)>
   & PropertiesOption<TProperties>
   & IsPageOption<TIsPage>
-  & CustomEventsOption<TCustomEvents, EventsDoc>
-  & EventsOption<TEvents, EventsConstraint<TReceivedComponentDoc>>
-  & DataOption<TData, PropertiesDoc>
-  & StoreOption<TStore, PropertiesDoc & DataDoc>
-  & ComputedOption<TComputed, Required<PropertiesDoc> & DataDoc & StoreDoc>
+  & EventsOption<TEvents>
+  & CustomEventsOption<TCustomEvents, keyof EventsDoc>
+  & DataOption<TData, keyof PropertiesDoc>
+  & StoreOption<TStore, keyof (PropertiesDoc & DataDoc)>
+  & ComputedOption<TComputed, keyof (PropertiesDoc & DataDoc & StoreDoc)>
   & PageLifetimesOption<TIsPage, NoInfer<PropertiesDoc>>
   & LifetimesOption<TIsPage>
   & WatchOption<
@@ -76,10 +75,10 @@ type RootComponentOptions<
     >
   >;
 
-type RootComponentConstructor<TReceivedComponentDoc extends ComponentDoc[] | ComponentDoc> = {
+type RootComponentConstructor<TComponentDocList extends ComponentDoc[]> = {
   <
     // TEvents 不能有默认值 {} 会引起事件参数类型(e)失效
-    TEvents extends EventsConstraint<TReceivedComponentDoc>,
+    TEvents extends EventsConstraint<TComponentDocList>,
     TIsPage extends boolean = false,
     const TProperties extends PropertiesConstraint = {},
     TData extends object = {},
@@ -88,15 +87,14 @@ type RootComponentConstructor<TReceivedComponentDoc extends ComponentDoc[] | Com
     // 页面时自定义事件无意义
     TCustomEvents extends IfExtends<TIsPage, false, CustomEventConstraint, EmptyObject> = {},
     TMethods extends MethodsConstraint = {},
-    EventsDoc extends object = IfExtends<EventsConstraint<TReceivedComponentDoc>, TEvents, {}, TEvents>,
+    EventsDoc extends object = IfExtends<EventsConstraint<TComponentDocList>, TEvents, {}, TEvents>,
     CustomEventsDoc extends object = GetCustomEventDoc<TCustomEvents>,
     PropertiesDoc extends object = GetPropertiesDoc<TProperties, TIsPage>,
     DataDoc extends object = TData,
-    StoreDoc extends object = GeTStoreDoc<TStore>,
+    StoreDoc extends object = GetStoreDoc<TStore>,
     ComputedDoc extends object = GetComputedDoc<TComputed>,
   >(
     options: RootComponentOptions<
-      TReceivedComponentDoc,
       TEvents,
       TIsPage,
       TCustomEvents,
@@ -126,10 +124,10 @@ type RootComponentConstructor<TReceivedComponentDoc extends ComponentDoc[] | Com
 };
 
 export function RootComponent<
-  // ComponentDoc表示RootComponent作为单独组件,ComponentDoc[]表示RootComponent作为多个子组件的根组件
-  TReceivedComponentDoc extends ComponentDoc[] | ComponentDoc = {},
+  // TComponentDocList泛型为了给events字段提供类型约束
+  TComponentDocList extends ComponentDoc[] = [],
 >(): RootComponentConstructor<
-  TReceivedComponentDoc
+  TComponentDocList
 > {
   return ((options: any) => options as RootComponentTrueOptions) as any;
 }

package/src/api/SubComponent/SubComputed/SubComputedOption.ts

@@ -6,5 +6,4 @@ export type SubComputedOption<
   computed?:
     & TComputed
     & V.IllegalFieldValidator<TComputed, keyof legal, 0, "", "重复或无效的字段">;
-  // & ValidatorOfReturnType<TComputed, legal>;
 };

package/src/api/SubComponent/SubData/SubDataConstraint.ts

@@ -3,8 +3,7 @@
  * @returns 当剩余对象不为空对象,约束对象的key为剩余key,类型为剩余key对应的文档类型或函数返回类型。
  */
 export type SubDataConstraint<
-  O extends object,
+  TComponentDoc extends object,
 > = {
-  // 加入响应式数据类型
-  [k in (keyof O)]?: O[k];
+  [k in keyof TComponentDoc]?: TComponentDoc[k];
 };

package/src/api/SubComponent/SubData/SubDataOption.ts

@@ -1,6 +1,10 @@
 import type { V } from "hry-types";
 
 export type SubDataOption<TSubData extends object, legalKeys extends PropertyKey, TPrefix extends string> = {
+  /**
+   * 可写子组件所需数据和内部公共数据
+   * 非法字段检测和与Inherit字段的重复检测
+   */
   data?:
     & TSubData
     & V.IllegalFieldValidator<

package/src/api/SubComponent/SubData/test/error.test.ts

@@ -24,7 +24,7 @@ type OnlyPropsCompDoc = ComponentDoc<{
   };
 }>;
 
-// 2 CompDoc有properties字段但去除Inherit字段后为空,只可写临时字段(内部字段)
+// 2 CompDoc有properties字段但去除Inherit字段后为空,只可写内部字段
 SubComponent<{}, OnlyPropsCompDoc>()({
   inherit: {
     aaa_str: "wxml",

package/src/api/SubComponent/SubData/test/normal.test.ts

@@ -1,7 +1,5 @@
 import { Checking, type Test } from "hry-types";
 import type { ReadonlyDeep } from "hry-types/src/Any/_api";
-import type { Wm } from "../../../../thirdLib";
-import type { ComponentDocExtension } from "../../../../types/ComponentDocExtension";
 import type { ComponentDoc } from "../../../DefineComponent/ReturnType/ComponentDoc";
 
 import type { Mock_User } from "../../../RootComponent/Properties/test/normalRequired.test";
@@ -15,61 +13,32 @@ type CompDoc = ComponentDoc<{
   };
 }>;
 
-// 1 data字段的key提示为:组件文档字段去除inherit字段后的字段.值类型为:文档对应字段类型或函数返回类型(表示引入的Store数据)。或临时字段(内部运算所用字段,无法渲染到页面)key,值类型为unknown
 SubComponent<{}, CompDoc>()({
   inherit: {
     aaa_obj: "wxml",
   },
   data: {
+    // 1. 子组件key和对应的类型。
     aaa_str: "a",
     aaa_num: 123,
+    // 2. 可写内部字段,一般作为公共的临时数据。
     _aaa_template: "internal", // 内部临时数据
   },
 });
 
-// 2. 使用CompDocExtends泛型拓展组件文档,满足内部组件内部包含一些slot或基本组件数据
-type viewExtends = ComponentDocExtension<
-  Wm.View,
-  { properties: { view_obj: Mock_User | null; view_str: string; view_ddd: number } }
->;
-
-const res = SubComponent<{}, viewExtends>()({
-  inherit: {
-    view_style: "wxml",
-  },
-  data: {
-    // view组件key
-    view_class: "h-full",
-    view_hover_class: "none",
-    // 拓展的字段
-    view_obj: {} as Mock_User | null,
-    view_str: "a",
-    view_ddd: 123,
-  },
-});
-
-Checking<typeof res, never, Test.Pass>;
-
-// 2  CompDoc去除Inherit字段后为空,可写非临时字段(内部字段)
-SubComponent<{}, CompDoc>()({
+//
+SubComponent<{ data: { _num: number } }, CompDoc>()({
   inherit: {
     aaa_str: "wxml",
     aaa_num: "wxml",
     aaa_obj: "wxml",
   },
   data: {
+    // 3 CompDoc去除Inherit字段后为空时,可写内部字段
     _aaa_str: "str",
   },
 });
 
-// 3 CompDoc 为空对象时,参数为空对象,返回never
-
-type EmptyCompDoc = ComponentDoc<{}>;
-
-const res1 = SubComponent<{}, EmptyCompDoc>()({});
-
-Checking<typeof res1, never, Test.Pass>;
-
 SubComponent<{}, CompDoc>()({
   data: {
     aaa_str: "a",
@@ -79,7 +48,7 @@ SubComponent<{}, CompDoc>()({
   },
   methods: {
     aaa_1() {
-      // 4 this.data 深度只读
+      // 4 this.data中的data配置数据
       Checking<
         typeof this.data,
         ReadonlyDeep<{

package/src/api/SubComponent/SubEvents/SubEventsConstraint.ts

@@ -4,18 +4,23 @@ import type { Detail, WMBaseEvent } from "../../../types/OfficialTypeAlias";
 import type { ComponentDoc } from "../../DefineComponent/ReturnType/ComponentDoc";
 import type { Bubbles, Capture, CustomEventsTags } from "../../RootComponent/CustomEvents/CustomEventsTag";
 
+/**
+ * 把组件事件类型转为函数类型,冒泡事件捕获事件会多一个加后缀(_catch)的key,表示阻止事件冒泡和捕获。
+ */
 export type SubEventsConstraint<
   CompDoc extends ComponentDoc,
-  keys extends keyof CompDoc["customEvents"] = keyof CompDoc["customEvents"],
 > = {
   [
-    k in keys as Contains<CompDoc["customEvents"][k], Bubbles | Capture> extends true ? (k | `${k & string}_catch`)
+    k in keyof CompDoc["customEvents"] as Contains<CompDoc["customEvents"][k], Bubbles | Capture> extends true
+      ? (k | `${k & string}_catch`)
       : k
   ]?: (
     e: IfExtends<
+      // 有可能是基础组件(手写类型),所以事件类型可能为WMBaseEvent
       WMBaseEvent,
       CompDoc["customEvents"][k],
       WMBaseEvent,
+      // 去除 CustomEventsTags 标记
       Detail<Exclude<CompDoc["customEvents"][k], CustomEventsTags>>
     >,
   ) => void;

package/src/api/SubComponent/SubEvents/SubEventsOptions.ts

@@ -1,7 +1,12 @@
 import type { V } from "hry-types";
 
-export type SubEventsOption<TSubEvents, SubEventsDoc extends object, xxx extends PropertyKey> = {
+export type SubEventsOption<TSubEvents, SubEventsDoc extends object, legalKeys extends PropertyKey> = {
+  /**
+   * 子组件事件(基础事件|自定义事件)
+   * 可使用内部泛型(Detail、Mark、WMBaseEvent、WMCustomEvent、CurrentTargetDataset、TargetDataset)自定义事件类型
+   * 非法字段检测(除了组件事件的key均属于非法字段)
+   */
   events?:
     & TSubEvents
-    & V.IllegalFieldValidator<SubEventsDoc, xxx>;
+    & V.IllegalFieldValidator<SubEventsDoc, legalKeys>;
 };

package/src/api/SubComponent/SubEvents/test/error.test.ts

@@ -1,4 +1,5 @@
 import type { ComponentDoc } from "../../../DefineComponent/ReturnType/ComponentDoc";
+import type { Bubbles } from "../../../RootComponent/CustomEvents/CustomEventsTag";
 import { SubComponent } from "../..";
 
 type CompDoc = ComponentDoc<{
@@ -17,16 +18,16 @@ SubComponent<{}, CompDoc>()({
 
 type CompDoc1 = ComponentDoc<{
   customEvents: {
-    aaa_str: string;
+    aaa_str: string | Bubbles;
   };
 }>;
 
-// 组件文档有自定义事件时,events下的字段仅可写文档包含字段
+// 非法字段检测 组件文档有自定义事件时,events下的字段仅可写文档包含字段
 SubComponent<{}, CompDoc1>()({
   events: {
-    aaa_str(e) {
+    aaa_str(e) { // ok
       e;
-    }, // ok
+    },
     // @ts-expect-error 非法字段
     aaa_other() {},
   },

package/src/api/SubComponent/SubEvents/test/normal.test.ts

@@ -1,6 +1,7 @@
 import { Checking, type Test } from "hry-types";
 import type { Wm } from "../../../../thirdLib";
-import type { Detail, WMBaseEvent } from "../../../../types/OfficialTypeAlias";
+
+import type { Detail, Mark, WMBaseEvent } from "../../../..";
 import type { ComponentDoc } from "../../../DefineComponent/ReturnType/ComponentDoc";
 import type {
   Bubbles,
@@ -10,6 +11,7 @@ import type {
   Capture,
   CaptureComposed,
 } from "../../../RootComponent/CustomEvents/CustomEventsTag";
+import type { Mock_User } from "../../../RootComponent/Properties/test/normalRequired.test";
 import { SubComponent } from "../..";
 
 type CompDoc = ComponentDoc<{
@@ -51,13 +53,13 @@ const sub1 = SubComponent<{}, CompDoc>()({
   },
 });
 
-// 1.2 Composed事件会被返回
 type Sub1Expected = {
   BubblesComposed: string | BubblesComposed;
   CapturePhaseComposed: string | CaptureComposed;
   BubblesCapturePhaseComposed: string | BubblesCaptureComposed;
 };
 
+// 1.2 Composed事件会被返回
 Checking<typeof sub1, Sub1Expected, Test.Pass>;
 
 // 2.1 key可写入后缀字段(_catch,表示阻止冒泡和捕获事件)。
@@ -75,7 +77,6 @@ const sub2 = SubComponent<{}, CompDoc>()({
 // 2.2 返回没有被加后最(_catch)的Composed事件
 Checking<typeof sub2, { BubblesCapturePhaseComposed: string | BubblesCaptureComposed }, Test.Pass>;
 
-// 2.3 key可写入后缀字段(_catch,表示阻止冒泡和捕获事件)。
 const sub3 = SubComponent<{}, CompDoc>()({
   events: {
     aaa_BubblesComposed_catch(e) {
@@ -106,7 +107,7 @@ SubComponent<{}, Wm.View>()({
   },
 });
 
-// 3.2 基础组件自定义事件参数为Detail<object>
+// 3.1 基础组件自定义事件参数为Detail<object>
 SubComponent<{}, Wm.ScrollView>()({
   events: {
     scrollView_bindscroll(e) {
@@ -126,3 +127,29 @@ SubComponent<{}, Wm.ScrollView>()({
     // ...
   },
 });
+
+// 4 可为事件自定义类型
+SubComponent<{}, Wm.View>()({
+  events: {
+    view_tap(e: Detail<number>) {
+      Checking<typeof e.detail, number, Test.Pass>;
+    },
+    view_longtap(e: Mark<Mock_User>) {
+      Checking<typeof e.mark, Mock_User, Test.Pass>;
+    },
+    // ...
+  },
+});
+
+// 4 可为事件自定义类型
+SubComponent<{}, Wm.View>()({
+  events: {
+    view_tap(e: Detail<number>) {
+      Checking<typeof e.detail, number, Test.Pass>;
+    },
+    view_longtap(e: Mark<Mock_User>) {
+      Checking<typeof e.mark, Mock_User, Test.Pass>;
+    },
+    // ...
+  },
+});

package/src/api/SubComponent/SubInherit/SubInheritConstraint.ts

@@ -1,12 +1,15 @@
 import type { SelectKeys } from "hry-types/src/Object/_api";
+import type { RemoveInnerData } from "../../../types/RemoveInnerData";
 import type { ComponentDoc } from "../../DefineComponent/ReturnType/ComponentDoc";
 
 type WXMLSign = "wxml";
 
 /**
- * 子组件inherit字段约束,
+ * 子组件inherit字段约束,key为子组件所需key,根组件数据的key或`WXMLSign`。要求根数据类型为子数据类型的子类型。当key的值来自wxml(循环产生的子数据等情况)时用`WXMLSign`表示。
  * @returns object
  */
-export type InheritConstraint<RootData extends object, TComponentDoc extends ComponentDoc> = {
-  [k in keyof TComponentDoc["properties"]]?: SelectKeys<RootData, TComponentDoc["properties"][k]> | WXMLSign;
+export type InheritConstraint<AllRootData extends object, TComponentDoc extends ComponentDoc> = {
+  [k in keyof TComponentDoc["properties"]]?:
+    | RemoveInnerData<SelectKeys<AllRootData, TComponentDoc["properties"][k]> & string>
+    | WXMLSign;
 };

package/src/api/SubComponent/SubInherit/SubInheritOption.ts

@@ -0,0 +1,8 @@
+export type SubInheritOption<TInherit> = {
+  /**
+   * 继承来自根组件的数据(key)或'wxml',wxml表示数据来自`.wxml`文件(例如数据来自父元素循环wx:for的数据).
+   * inherit字段最终会在选项中删除,它的存在是为了ts开发时提供心智模型(类型检测),js开发好比注释功能.便于代码阅读。
+   * 带类型检测
+   */
+  inherit?: TInherit;
+};

package/src/api/SubComponent/SubInherit/test/error.test.ts

@@ -17,6 +17,8 @@ type Mock_RootDoc = RootComponentDoc<{
     str: string;
     literal_str: "a" | "b" | "c";
     bool: boolean;
+    _num: number;
+    _str: string;
   };
   computed: {
     Cuinon: string | boolean;
@@ -34,19 +36,19 @@ type Mock_CompDoc = ComponentDoc<{
   };
 }>;
 
-// RootDoc不为空时,可继承对应类型的字段。
+// 1 继承字段类型错误
 SubComponent<Mock_RootDoc, Mock_CompDoc>()({
   inherit: {
-    // @ts-expect-error  [string | number] 不是 [number] 的子集
+    // @ts-expect-error 1.1 [string | number] 不是 [number] 的子集
     aaa_num: "unionStrNum",
-    // @ts-expect-error  [123 | 456 | 789] 不是 [123 | 456] 的子集
+    // @ts-expect-error 1.2 [123 | 456 | 789] 不是 [123 | 456] 的子集
     aaa_literal_num: "optional_literal_num",
-    // @ts-expect-error  [string | number] 不是 [string] 的子集
-    aaa_str: "" as "unionStrNum",
+    // @ts-expect-error 1.3 不可继承内部字段
+    aaa_str: "_str",
   },
 });
 
-// inherit字段最终不会在组件配置中,意义在于通过声明继承字段便于类型判断,配置是否满足组件的需求。下面示例中,配置不满足组件需求,Mock_CompDoc需要一些必传字段没有配置,即使这些字段存在在于根组件(或wmxl).而返回的字符串(错误),无法通过DefinedComponent Api 类型检测。
+// 2 inherit字段最终不会在组件配置中,意义在于通过声明继承字段便于类型判断,配置是否满足子组件文档的需求。下面示例中,配置不满足组件需求,Mock_CompDoc需要一些必传字段没有配置,即使这些字段存在在于根组件(或wmxl).而返回的字符串(错误),无法通过DefinedComponent Api 类型检测。
 const subDoc = SubComponent<Mock_RootDoc, Mock_CompDoc>()({
   data: {
     aaa_num: 123,
@@ -57,6 +59,6 @@ Checking<typeof subDoc, SubComponentDoc, Test.Fail>;
 
 DefineComponent({
   name: "xxx",
-  // @ts-expect-error 不能将类型“string”分配给类型“_SubComponentDoc”。
+  // @ts-expect-error 2 不能将类型“string”分配给类型“_SubComponentDoc”。
   subComponents: [subDoc],
 });

package/src/api/SubComponent/SubInherit/test/normal.test.ts

@@ -2,13 +2,16 @@ import type { ComponentDoc } from "../../../DefineComponent/ReturnType/Component
 import type { RootComponentDoc } from "../../../RootComponent/RootComponentDoc";
 import { SubComponent } from "../..";
 
+/**
+ * inherit字段最终会在选项中删除,它用ts开发类型检测。
+ */
 type Mock_RootDoc = RootComponentDoc<{
   properties: {
     required_num: number;
     optional_literal_num?: 123 | 456 | 789;
     unionStrNum: string | number;
     required_obj: object | null;
-    optional_obj?: object;
+    optional_obj?: object | null;
   };
   data: {
     str: string;
@@ -31,7 +34,7 @@ type Mock_CompDoc = ComponentDoc<{
   };
 }>;
 
-// 1 没有可继承的数据,类型可为'wxml',表示数据来自wxml(例如数据来自父组件循环wx:for后的数据等情况)
+// 1 没有可继承的数据,类型可为'wxml',表示数据来自wxml(例如数据来自父元素循环wx:for后的数据等情况)
 SubComponent<{}, Mock_CompDoc>()({
   inherit: {
     aaa_num: "wxml",
@@ -51,5 +54,3 @@ SubComponent<Mock_RootDoc, Mock_CompDoc>()({
     aaa_obj1: "" as "required_obj" | "optional_obj" | "wxml",
   },
 });
-
-// inherit字段最终会在配置对象中删除,它用类型检测。

package/src/api/SubComponent/SubMethods/SubMethodsOption.ts

@@ -1,13 +1,17 @@
 import type { V } from "hry-types";
 import type { PrefixValidator } from "hry-types/src/Generic/PrefixValidator";
+import type { SubMethodsConstraint } from "./SubMethodsConstraint";
 
 export type SubMethodsOption<
-  TSubMethods extends object,
+  TSubMethods extends SubMethodsConstraint,
   TPrefix extends string,
-  CompCustomEventsKeys extends PropertyKey,
+  ExcludedKeys extends PropertyKey,
 > = {
+  /**
+   * 前缀检测和重复检测(与events和组件customEvents字段)
+   */
   methods?:
     & TSubMethods
     & PrefixValidator<TSubMethods, TPrefix>
-    & V.DuplicateFieldValidator<TSubMethods, CompCustomEventsKeys>;
+    & V.DuplicateFieldValidator<TSubMethods, ExcludedKeys>;
 };

package/src/api/SubComponent/SubMethods/test/error.test.ts

@@ -1,4 +1,5 @@
 import type { ComponentDoc } from "../../../DefineComponent/ReturnType/ComponentDoc";
+import type { Bubbles } from "../../../RootComponent/CustomEvents/CustomEventsTag";
 import type { RootComponentDoc } from "../../../RootComponent/RootComponentDoc";
 import { SubComponent } from "../..";
 
@@ -16,22 +17,29 @@ type RootDoc = RootComponentDoc<{
 
 type CompDoc = ComponentDoc<{
   customEvents: {
-    aaa_str: string;
+    aaa_str: string | Bubbles;
   };
 }>;
 
-// 前缀错误
+// 1 前缀错误
 SubComponent<RootDoc, CompDoc>()({
   methods: {
-    // @ts-expect-error 前缀错误
+    // @ts-expect-error 1.1 前缀错误
     xxx_yyy() {},
   },
 });
 
-// 与组件事件字段重复
+// 2 重复检测
 SubComponent<RootDoc, CompDoc>()({
+  events: {
+    aaa_str_catch() {
+    },
+  },
   methods: {
-    // @ts-expect-error 与组件事件字段重复
+    // @ts-expect-error 2.1 与组件自定义事件字段重复
     aaa_str() {},
+    // @ts-expect-error 2.2 与events字段重复
+    aaa_str_catch() {
+    },
   },
 });

package/src/api/SubComponent/SubMethods/test/normarl.test.ts

@@ -6,12 +6,6 @@ type RootDoc = RootComponentDoc<{
   methods: {
     Mstr: () => string;
   };
-  events: {
-    Estr: () => string;
-  };
-  customEvents: {
-    Cstr: string;
-  };
 }>;
 
 type CompDoc = ComponentDoc<{
@@ -20,12 +14,7 @@ type CompDoc = ComponentDoc<{
   };
 }>;
 
-// 默认可以为{}。
-SubComponent<RootDoc, CompDoc>()({
-  methods: {},
-});
-
-// methods字段可以写 任意字段函数,不与RootDoc和CompDoc中的方法字段重复即可,前缀为CompDoc的前缀
+// methods字段同组件前缀
 SubComponent<RootDoc, CompDoc>()({
   methods: {
     aaa_xxx() {},
@@ -33,3 +22,8 @@ SubComponent<RootDoc, CompDoc>()({
     // ...
   },
 });
+
+// 2 默认可以为{}。
+SubComponent<RootDoc, CompDoc>()({
+  methods: {},
+});

package/src/api/SubComponent/SubPageLifetimes/test/error.test.ts

@@ -1,32 +1 @@
-import type { RootComponentDoc } from "../../../RootComponent/RootComponentDoc";
-import { SubComponent } from "../..";
-
-type RootDocCompPage = RootComponentDoc<{
-  isPage: true;
-}>;
-
-type CompDoc = RootComponentDoc<{
-  properties: {
-    aaa_str: string;
-  };
-}>;
-
-/**
- * 测试 组件时
- */
-SubComponent<{}, CompDoc>()({
-  pageLifetimes: {
-    // @ts-expect-error 不存在的字段 show是正确字段
-    onShow() {},
-  },
-});
-
-/**
- * 页面时
- */
-SubComponent<RootDocCompPage, CompDoc>()({
-  pageLifetimes: {
-    // @ts-expect-error 不存在的字段 多了一个 `d`
-    onLoadd() {},
-  },
-});
+// 同 RootComponent的PageLifetimes