annil 1.16.0 → 1.18.0

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

@@ -1,209 +0,0 @@
-/* eslint-disable @typescript-eslint/no-unused-vars */
-/* eslint-disable @typescript-eslint/no-unused-expressions */
-import { Checking, type Test } from "hry-types";
-import type { Wm } from "../../../../thirdLib";
-
-import type { Detail, Mark, WMBaseEvent } from "../../../..";
-import type { ComponentDoc } from "../../../DefineComponent/returnType/ComponentDoc";
-import type {
-  Bubbles,
-  BubblesCapture,
-  BubblesCaptureComposed,
-  BubblesComposed,
-  Capture,
-  CaptureComposed,
-} from "../../../RootComponent/CustomEvents/CustomEventsTag";
-import type { Mock_User } from "../../../RootComponent/Properties/test/normalRequired.test";
-import { SubComponent } from "../..";
-
-type CompDoc = ComponentDoc<{
-  events: {
-    aaa_str: string;
-    aaa_bubbles: string | Bubbles;
-    aaa_CapturePhase: string | Capture;
-    aaa_BubblesCapturePhase: null | BubblesCapture;
-    aaa_BubblesComposed: string | BubblesComposed;
-    aaa_CapturePhaseComposed: string | CaptureComposed;
-    aaa_BubblesCapturePhaseComposed: string | BubblesCaptureComposed;
-  };
-}>;
-
-// 1.1 events字段提示 key为 CompDoc下customEvents的字段,类型为函数(e)=>void,e为对应keys类型去除事件标记(冒泡 捕获 穿透)
-const custom1 = SubComponent<{}, CompDoc>()({
-  events: {
-    aaa_str(e) {
-      Checking<typeof e.detail, string, Test.Pass>;
-    },
-    aaa_bubbles(e) {
-      Checking<typeof e.detail, string, Test.Pass>;
-    },
-    aaa_CapturePhase(e) {
-      Checking<typeof e.detail, string, Test.Pass>;
-    },
-    aaa_BubblesCapturePhase(e) {
-      Checking<typeof e.detail, null, Test.Pass>;
-    },
-    aaa_BubblesComposed(e) {
-      Checking<typeof e.detail, string, Test.Pass>;
-    },
-    aaa_CapturePhaseComposed(e) {
-      Checking<typeof e.detail, string, Test.Pass>;
-    },
-    aaa_BubblesCapturePhaseComposed(e) {
-      Checking<typeof e.detail, string, Test.Pass>;
-    },
-  },
-});
-
-type custom1Expected = {
-  composedEvents: {
-    BubblesComposed: string | BubblesComposed;
-    CapturePhaseComposed: string | CaptureComposed;
-    BubblesCapturePhaseComposed: string | BubblesCaptureComposed;
-  };
-  // events: {
-  //   aaa_str(e: Detail<string>): void;
-  //   aaa_bubbles(e: Detail<string>): void;
-  //   aaa_CapturePhase(e: Detail<string>): void;
-  //   aaa_BubblesCapturePhase(e: Detail<null>): void;
-  //   aaa_BubblesComposed(e: Detail<string>): void;
-  //   aaa_CapturePhaseComposed(e: Detail<string>): void;
-  //   aaa_BubblesCapturePhaseComposed(e: Detail<string>): void;
-  // };
-};
-
-// 1.2 Composed事件会被返回
-Checking<typeof custom1, custom1Expected, Test.Pass>;
-
-// 2.1 key可写入后缀字段(_catch,表示阻止冒泡和捕获事件)。
-const custom2 = SubComponent<{}, CompDoc>()({
-  events: {
-    aaa_BubblesComposed_catch(e) {
-      Checking<typeof e.detail, string, Test.Pass>;
-    },
-    aaa_CapturePhaseComposed_catch(e) {
-      Checking<typeof e.detail, string, Test.Pass>;
-    },
-  },
-});
-
-// 2.2 返回没有被加后最(_catch)的Composed事件
-Checking<typeof custom2, {
-  composedEvents: {
-    BubblesCapturePhaseComposed: string | BubblesCaptureComposed;
-  };
-  // events: {
-  //   aaa_BubblesComposed_catch(e: Detail<string>): void;
-  //   aaa_CapturePhaseComposed_catch(e: Detail<string>): void;
-  // };
-}, Test.Pass>;
-
-const custom3 = SubComponent<{}, CompDoc>()({
-  events: {
-    aaa_BubblesComposed_catch(e) {
-      Checking<typeof e.detail, string, Test.Pass>;
-    },
-    aaa_CapturePhaseComposed_catch(e) {
-      Checking<typeof e.detail, string, Test.Pass>;
-    },
-    aaa_BubblesCapturePhaseComposed_catch(e) {
-      Checking<typeof e.detail, string, Test.Pass>;
-    },
-  },
-});
-
-// 2.4 若Composed事件都被阻止则返回never
-Checking<typeof custom3, never, Test.Pass>;
-
-// 3.1 基础组件基本事件参数为WMBaseEvent
-SubComponent<{}, Wm.View>()({
-  events: {
-    view_tap(e) {
-      Checking<typeof e, WMBaseEvent, Test.Pass>;
-    },
-    view_longtap(e) {
-      Checking<typeof e, WMBaseEvent, Test.Pass>;
-    },
-    // ...
-  },
-});
-
-// 3.1 基础组件自定义事件参数为Detail<object>
-SubComponent<{}, Wm.ScrollView>()({
-  events: {
-    scrollView_bindscroll(e) {
-      Checking<
-        typeof e,
-        Detail<{
-          scrollLeft: number;
-          scrollTop: number;
-          scrollHeight: number;
-          scrollWidth: number;
-          deltaX: number;
-          deltaY: number;
-        }>,
-        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>;
-    },
-    // ...
-  },
-});
-
-// 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>;
-    },
-    // ...
-  },
-});
-
-// 5 可以调用自身事件
-SubComponent<{ methods: { aaa: () => string } }, Wm.View>()({
-  methods: {
-    view_xxx() {
-      return 123;
-    },
-  },
-  events: {
-    view_tap(e: Detail<number>) {
-      this.view_xxx();
-      Checking<typeof e.detail, number, Test.Pass>;
-    },
-  },
-});
-// 5 可以调用自身事件
-SubComponent<{ methods: { aaa: () => string } }, Wm.Map>()({
-  methods: {
-    map_xxx() {
-      return 123;
-    },
-  },
-  events: {
-    map_poitap(e) {
-      this.map_xxx();
-      Checking<typeof e.detail, {
-        name: string;
-        longitude: number;
-        latitude: number;
-      }, Test.Pass>;
-    },
-  },
-});

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

@@ -1,17 +0,0 @@
-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";
-
-type unionAddList<Keys extends string> = Keys | Keys[];
-
-/**
- * 子组件inherit字段约束,key为构建组件所需的properties字段,类型为根组件数据的key或key[]或`WXMLSign`。要求根数据类型为子数据类型的子类型。当key的值来自wxml(循环产生的子数据等情况)时用`WXMLSign`表示。
- * @returns object
- */
-export type SubInheritConstraint<AllRootData extends object, TComponentDoc extends ComponentDoc> = {
-  [k in keyof TComponentDoc["properties"]]?:
-    | unionAddList<RemoveInnerData<SelectKeys<AllRootData, TComponentDoc["properties"][k]> & string>>
-    | WXMLSign;
-};

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

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

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

@@ -1,84 +0,0 @@
-import { Checking, type Test } from "hry-types";
-import { DefineComponent } from "../../../DefineComponent";
-import type { ComponentDoc } from "../../../DefineComponent/returnType/ComponentDoc";
-import type { RootComponentDefinition } from "../../../RootComponent/returnType";
-import { SubComponent } from "../..";
-import type { SubComponentDefinition } from "../../returnType";
-
-type Mock_RootDoc = RootComponentDefinition<{
-  properties: {
-    required_num: number;
-    optional_literal_num?: 123 | 456 | 789;
-    unionStrNum: string | number;
-    required_obj: object | null;
-    optional_obj?: object;
-  };
-  data: {
-    str: string;
-    literal_str: "a" | "b" | "c";
-    bool: boolean;
-    _num: number;
-    _str: string;
-  };
-  computed: {
-    Cuinon: string | boolean;
-  };
-}>;
-
-type Mock_CompDoc = ComponentDoc<{
-  properties: {
-    aaa_num: number;
-    aaa_literal_num: 123 | 456;
-    aaa_str?: string;
-    aaa_union: string | boolean;
-    aaa_obj: object | null;
-    aaa_obj1?: object | null;
-  };
-}>;
-
-// 1 继承字段类型错误
-SubComponent<Mock_RootDoc, Mock_CompDoc>()({
-  inherit: {
-    // @ts-expect-error 1.1 [string | number] 不是 [number] 的子集
-    aaa_num: "unionStrNum",
-    // @ts-expect-error 1.2 [123 | 456 | 789] 不是 [123 | 456] 的子集
-    aaa_literal_num: "optional_literal_num",
-    // @ts-expect-error 1.3 不可继承内部字段
-    aaa_str: "_str",
-  },
-});
-
-// 2 inherit字段最终不会在组件配置中,意义在于通过声明继承字段便于类型判断,配置是否满足子组件文档的需求。下面示例中,配置不满足组件需求,Mock_CompDoc需要一些必传字段没有配置,即使这些字段存在在于根组件(或wmxl).而返回的字符串(错误),无法通过DefinedComponent Api 类型检测。
-const customDoc = SubComponent<Mock_RootDoc, Mock_CompDoc>()({
-  data: {
-    aaa_num: 123,
-  },
-});
-
-void Checking<typeof customDoc, SubComponentDefinition, Test.Fail>;
-
-DefineComponent({
-  name: "xxx",
-  // @ts-expect-error 2 不能将类型“string”分配给类型“_customComponentDoc”。
-  subComponents: [customDoc],
-});
-
-// 3 错误的key检查
-
-SubComponent<Mock_RootDoc, Mock_CompDoc>()({
-  inherit: {
-    aaa_num: "required_num",
-    // @ts-expect-error 3.1 不存在于组件中的key给错误提示
-    xxx: "",
-    // @ts-expect-error 3.2 不存在于组件中的key给错误提示
-    aaa_xxx: "",
-  },
-});
-// 4 数组时类型错误
-
-SubComponent<Mock_RootDoc, Mock_CompDoc>()({
-  inherit: {
-    // @ts-expect-error   取消了数组类型,之前的版本允许数组类型表示三元表达式
-    aaa_num: ["optional_lit1eral_num", "require1d_num"],
-  },
-});

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

@@ -1,81 +0,0 @@
-import type { ComponentDoc } from "../../../DefineComponent/returnType/ComponentDoc";
-import type { RootComponentDefinition } from "../../../RootComponent/returnType";
-import { SubComponent } from "../..";
-
-/**
- * inherit字段最终会在选项中删除,它用ts开发类型检测。
- */
-type Mock_RootDoc = RootComponentDefinition<{
-  properties: {
-    required_num: number;
-    optional_literal_num?: 123 | 456 | 789;
-    unionStrNum: string | number;
-    required_obj: object | null;
-    optional_obj?: object | null;
-  };
-  data: {
-    str: string;
-    literal_str: "a" | "b" | "c";
-    bool: boolean;
-  };
-  computed: {
-    Cuinon: string | boolean;
-  };
-}>;
-
-type Mock_CompDoc = ComponentDoc<{
-  properties: {
-    aaa_num: number;
-    aaa_literal_num: 123 | 456;
-    aaa_str?: string;
-    aaa_union: string | boolean;
-    aaa_obj: object | null;
-    aaa_obj1?: object | null;
-  };
-}>;
-
-// 1 没有可继承的数据,类型可为'wxml',表示数据来自wxml(例如数据来自父元素循环wx:for后的数据等情况)
-SubComponent<{}, Mock_CompDoc>()({
-  inherit: {
-    aaa_num: "wxml",
-    aaa_str: "wxml",
-    aaa_union: "wxml",
-    aaa_obj: "wxml",
-    aaa_obj1: "wxml",
-  },
-});
-
-// 2 RootDoc不为空时,可继承对应类型的字段。
-SubComponent<Mock_RootDoc, Mock_CompDoc>()({
-  inherit: {
-    aaa_num: "" as "optional_literal_num" | "required_num" | "wxml",
-    aaa_str: "" as "str" | "literal_str" | "wxml",
-    aaa_obj: "" as "required_obj" | "optional_obj" | "wxml",
-    aaa_obj1: "" as "required_obj" | "optional_obj" | "wxml",
-  },
-});
-
-// 3 value为数组时,表示多个字段的联合类型
-
-SubComponent<Mock_RootDoc, Mock_CompDoc>()({
-  inherit: {
-    aaa_num: ["optional_literal_num", "required_num"],
-    aaa_str: ["literal_str", "str"],
-    aaa_obj: "" as "required_obj" | "optional_obj" | ["required_obj" | "optional_obj"] | "wxml",
-    aaa_obj1: "" as "required_obj" | "optional_obj" | ["required_obj" | "optional_obj"] | "wxml",
-  },
-});
-
-// 4. 实例上没有computed字段。
-SubComponent<{}, Mock_CompDoc>()({
-  computed: {
-    aaa_num() {
-      return 1;
-    },
-  },
-  methods: {
-    aaa_meA() {
-      console.log(this.data.aaa_num);
-    },
-  },
-});

package/src/api/SubComponent/SubInstance/SubInstance.ts

@@ -1,9 +0,0 @@
-import type { RootComponentInstance } from "../../RootComponent/Instance/RootComponentInstance";
-
-export type SubInstance<
-  TAllMethods extends object,
-  TDataForSetData extends object,
-  AllData extends object,
-  AllCustomEventsDoc extends object,
-  SubStoreDoc extends object,
-> = RootComponentInstance<false, TAllMethods, TDataForSetData, AllData, AllCustomEventsDoc, SubStoreDoc>;

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

@@ -1,22 +0,0 @@
-import type { View } from "../../../../thirdLib/wm";
-import type { RootComponentDefinition } from "../../../RootComponent/returnType";
-import { SubComponent } from "../..";
-
-type RootDoc = RootComponentDefinition<{
-  events: {
-    RootE1: () => string;
-  };
-}>;
-
-// 实例中只存在RootDoc和自身的methods字段
-SubComponent<RootDoc, View>()({
-  lifetimes: {
-    created() {
-      // @ts-expect-error 不存在的方法  (Root事件方法不可调用)
-      this.RootE1();
-
-      // @ts-expect-error 不存在的方法
-      this.otherMethods();
-    },
-  },
-});

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

@@ -1,87 +0,0 @@
-import { Checking, type Test } from "hry-types";
-import type { ComponentDoc } from "../../../DefineComponent/returnType/ComponentDoc";
-
-import type { ComputeIntersection } from "hry-types/src/Object/ComputeIntersection";
-import type { IInjectAllData } from "../../../InstanceInject/instanceConfig";
-import type { Mock_User } from "../../../RootComponent/Properties/test/normalRequired.test";
-import type { RootComponentDefinition } from "../../../RootComponent/returnType";
-import { SubComponent } from "../..";
-
-type RootDoc = RootComponentDefinition<{
-  properties: {
-    Pstr: string;
-    Pobj: Mock_User | null;
-    PoptionalObj?: Mock_User;
-  };
-  data: {
-    Dnum: number;
-  };
-  computed: {
-    Cnum: number;
-  };
-  methods: {
-    RootM: () => number;
-  };
-  customEvents: {
-    RootCus: string;
-  };
-  events: {
-    RootE1: () => string;
-  };
-}>;
-
-type CompDoc = ComponentDoc<{
-  properties: {
-    aaa_str: string;
-  };
-  events: {
-    aaa_num: number;
-  };
-}>;
-
-SubComponent<RootDoc, CompDoc>()({
-  data: {
-    aaa_str: "str" as string,
-  },
-  computed: {},
-  methods: {
-    aaa_SubM() {
-      void 0;
-    },
-  },
-  events: {
-    aaa_num() {
-      void 0;
-    },
-  },
-  lifetimes: {
-    created() {
-      // this.data
-      void Checking<
-        typeof this.data,
-        ComputeIntersection<
-          {
-            // RootData
-            Pstr: string;
-            Pobj: Mock_User | null;
-            PoptionalObj: Mock_User;
-            Dnum: number;
-            Cnum: number;
-            // 自身Data类型与CompDoc类型相同
-            aaa_str: string;
-          } & IInjectAllData
-        >,
-        Test.Pass
-      >;
-
-      // this.Methods 可调用自身和RootDoc中的methods方法,其他不可以
-      void Checking<typeof this.RootM, () => number, Test.Pass>;
-
-      void Checking<typeof this.RootCus, (detail: string) => void, Test.Pass>;
-
-      void Checking<typeof this.aaa_SubM, () => void, Test.Pass>;
-
-      // 其他官方字段 ...
-    },
-  },
-});

package/src/api/SubComponent/SubLifetimes/SubLifetimesOption.ts

@@ -1,3 +0,0 @@
-import type { LifetimesOption } from "../../RootComponent/Lifetimes/LifetimesOption";
-
-export type SubLifetimesOption = LifetimesOption;

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

@@ -1,3 +0,0 @@
-import type { Func } from "hry-types/src/Misc/Func";
-
-export type SubMethodsConstraint = Record<string, Func>;

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

@@ -1,17 +0,0 @@
-import type { G } from "hry-types";
-
-import type { SubMethodsConstraint } from "./SubMethodsConstraint";
-
-export type SubMethodsOption<
-  TMethods extends SubMethodsConstraint,
-  TPrefix extends string,
-  ExcludedKeys extends PropertyKey,
-> = {
-  /**
-   * 前缀检测和重复检测(与events和组件customEvents字段)
-   */
-  methods?:
-    & TMethods
-    & G.KeyValidator<TMethods, `${TPrefix}_${string}`>
-    & G.DuplicateFieldValidator<TMethods, ExcludedKeys>;
-};

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

@@ -1,51 +0,0 @@
-import type { ComponentDoc } from "../../../DefineComponent/returnType/ComponentDoc";
-import type { Bubbles } from "../../../RootComponent/CustomEvents/CustomEventsTag";
-import type { RootComponentDefinition } from "../../../RootComponent/returnType";
-import { SubComponent } from "../..";
-
-type RootDoc = RootComponentDefinition<{
-  methods: {
-    Mstr: () => string;
-  };
-  events: {
-    Estr: () => string;
-  };
-  customEvents: {
-    Cstr: string;
-  };
-}>;
-
-type CompDoc = ComponentDoc<{
-  events: {
-    aaa_str: string | Bubbles;
-  };
-}>;
-
-// 1 前缀错误
-SubComponent<RootDoc, CompDoc>()({
-  methods: {
-    // @ts-expect-error 1.1 前缀错误
-    xxx_yyy() {
-      void 0;
-    },
-  },
-});
-
-// 2 重复检测
-SubComponent<RootDoc, CompDoc>()({
-  events: {
-    aaa_str_catch() {
-      void 0;
-    },
-  },
-  methods: {
-    // @ts-expect-error 2.1 与组件自定义事件字段重复
-    aaa_str() {
-      void 0;
-    },
-    // @ts-expect-error 2.2 与events字段重复
-    aaa_str_catch() {
-      void 0;
-    },
-  },
-});

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

@@ -1,33 +0,0 @@
-import type { ComponentDoc } from "../../../DefineComponent/returnType/ComponentDoc";
-import type { RootComponentDefinition } from "../../../RootComponent/returnType";
-import { SubComponent } from "../..";
-
-type RootDoc = RootComponentDefinition<{
-  methods: {
-    Mstr: () => string;
-  };
-}>;
-
-type CompDoc = ComponentDoc<{
-  events: {
-    aaa_str: string;
-  };
-}>;
-
-// methods字段同组件前缀
-SubComponent<RootDoc, CompDoc>()({
-  methods: {
-    aaa_xxx() {
-      void 0;
-    },
-    aaa_yyy() {
-      void 0;
-    },
-    // ...
-  },
-});
-
-// 2 默认可以为{}。
-SubComponent<RootDoc, CompDoc>()({
-  methods: {},
-});

package/src/api/SubComponent/SubObservers/SubObserversOption.ts

@@ -1,3 +0,0 @@
-import type { ObserversOption } from "../../RootComponent/Observers/ObserversOption";
-
-export type SubObserversOption<TObserversData extends object> = ObserversOption<TObserversData>;

package/src/api/SubComponent/SubPageLifetimes/SubPageLifetimesOption.ts

@@ -1,6 +0,0 @@
-import type { PageLifetimesOption } from "../../RootComponent/PageLifetimes/PageLifetimesOption";
-
-export type SubPageLifetimesOption<TIsPage extends boolean, PropertiesDoc extends object> = PageLifetimesOption<
-  TIsPage,
-  PropertiesDoc
->;

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

@@ -1 +0,0 @@
-// 同 RootComponent的PageLifetimes

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

@@ -1 +0,0 @@
-// 同 RootComponent的PageLifetimes