annil 1.17.0 → 1.18.0

package/src/api/RootComponent/Computed/test/normal.test.ts

@@ -1,124 +0,0 @@
-/* eslint-disable @typescript-eslint/no-unused-expressions */
-/* eslint-disable @typescript-eslint/no-unused-vars */
-import { Checking, type Test } from "hry-types";
-import type { ComputeIntersection } from "hry-types/src/Object/_api";
-
-import type { IInjectAllData } from "../../../InstanceInject/instanceConfig";
-import { RootComponent } from "../..";
-import type { Mock_User } from "../../Properties/test/normalRequired.test";
-type User = {
-  name: string;
-  age?: number;
-};
-
-const RootDoc = RootComponent()({
-  properties: {
-    firstName: String,
-  },
-  data: {
-    lastName: "lastName",
-    mock_User: {} as Mock_User,
-  },
-  store: {
-    prefix: () => "hry-", // 模拟而已
-  },
-  computed: {
-    fullName() {
-      // 1 计算属性字段可以通过this.data 引用properties、data、store字段
-      return this.data.prefix + this.data.firstName + this.data.lastName;
-    },
-    user() {
-      return {} as Mock_User;
-    },
-    // 2. 可依赖其他计算字段
-    id_fullName() {
-      return this.data.user.id + this.data.fullName;
-    },
-    readOnly() {
-      // 3 this.data 类型是深度只读的
-      Checking<
-        typeof this.data,
-        ComputeIntersection<
-          {
-            firstName: string;
-            lastName: string;
-            mock_User: Mock_User;
-            fullName: string;
-            user: Mock_User;
-            prefix: string;
-            id_fullName: string;
-            readOnly: "str";
-          } & IInjectAllData
-        >,
-        Test.Pass
-      >;
-
-      // @ts-expect-error  深度只读 不可赋值
-      this.data.user.id = "xxx";
-
-      return "str";
-    },
-  },
-});
-
-// 4. 返回的文档类型中computed类型为计算字段函数返回类型
-type ComputedDocExpected = {
-  fullName: string;
-  user: Mock_User;
-  id_fullName: string;
-  readOnly: "str";
-};
-
-Checking<typeof RootDoc["computed"], ComputedDocExpected, Test.Pass>;
-
-/**
- *  5 无计算属性字段时,返回文档中无computed字段
- */
-const noComputedFieldDoc = RootComponent()({
-  methods: {
-    M1() {
-      // 5.1 无computed,this.data中为{}
-      Checking<typeof this.data, IInjectAllData, Test.Pass>;
-    },
-  },
-});
-
-Checking<typeof noComputedFieldDoc, { methods: { M1: () => void } }, Test.Pass>;
-
-/**
- *  6 计算属性字段为空对象时,返回文档中无computed字段
- */
-const EmptyComputedFieldDoc = RootComponent()({
-  computed: {},
-  methods: {
-    M1() {
-      // 6.1 computed为{},this.data中为{}
-      Checking<typeof this.data, IInjectAllData, Test.Pass>;
-    },
-  },
-});
-
-Checking<typeof EmptyComputedFieldDoc, { methods: { M1: () => void } }, Test.Pass>;
-
-type Custom = { type: "custom"; xxx: string };
-type Chunk = { type: "chunk"; yyy: number };
-type Union = Custom | Chunk;
-/**
- *  6 计算属性可以使用实例上的方法和属性
- */
-RootComponent()({
-  data: {
-    union: { type: "custom", xxx: "123" } as Union,
-  },
-  computed: {
-    count(): string | number {
-      const { union } = this.data;
-      return this.isCustom(union) ? union.xxx : union.yyy;
-    },
-  },
-  methods: {
-    isCustom(union: Union): union is Custom {
-      return union.type === "custom";
-    },
-  },
-});

package/src/api/RootComponent/CustomEvents/CustomEventConstraint.ts

@@ -1,89 +0,0 @@
-import type { DetailedType } from "../../../types/DetailedType";
-
-type SimpleCustomeEvents = DetailedType | null | undefined;
-
-export type SimpleCustomeEventsList = SimpleCustomeEvents[];
-
-export type ShortCustomeEvents = SimpleCustomeEvents | SimpleCustomeEventsList;
-
-// options
-type BubblesConfig = { bubbles: true };
-
-type CaptureConfig = { capturePhase: true };
-
-type ComposedCongifg = { composed: true };
-
-type NonBubblesConfig = { bubbles?: never };
-
-type NonComposedConfig = { composed?: never };
-
-type NonCaptureConfig = { capturePhase?: never };
-
-export type BubblesOption = BubblesConfig & NonComposedConfig & NonCaptureConfig;
-
-export type CaptureOption = CaptureConfig & NonBubblesConfig & NonComposedConfig;
-
-export type BubblesCaptureOption = BubblesConfig & CaptureConfig & NonComposedConfig;
-
-export type BubblesComposedOption = BubblesConfig & ComposedCongifg & NonCaptureConfig;
-
-export type CaptureComposedOption = CaptureConfig & ComposedCongifg & NonBubblesConfig;
-
-export type BubblesCaptureComposedOption = BubblesConfig & ComposedCongifg & CaptureConfig;
-
-export type OptionsFieldsConfigOfCustomEvents =
-  | BubblesOption
-  | CaptureOption
-  | BubblesCaptureOption
-  | BubblesComposedOption
-  | CaptureComposedOption
-  | BubblesCaptureComposedOption;
-
-/**
- * 带options的CustomEvents配置
- */
-export type FullCustomEventsOptions = {
-  detail: ShortCustomeEvents;
-  options: OptionsFieldsConfigOfCustomEvents;
-  debounce?: never;
-  throttle?: never;
-};
-
-export type FullCustomEventsWithDebounce = {
-  detail: ShortCustomeEvents;
-  options?: never;
-  debounce: number;
-  throttle?: never;
-};
-
-export type FullCustomEventsWithThrottle = {
-  detail: ShortCustomeEvents;
-  options?: never;
-  debounce?: never;
-  throttle: number;
-};
-
-export type FullCustomEventsOptionsWithThrottle = {
-  detail: ShortCustomeEvents;
-  options: OptionsFieldsConfigOfCustomEvents;
-  debounce?: never;
-  throttle: number;
-};
-
-export type FullCustomEventsOptionsWithDebounce = {
-  detail: ShortCustomeEvents;
-  options: OptionsFieldsConfigOfCustomEvents;
-  debounce: number;
-  throttle?: never;
-};
-
-export type FullCustomEvents =
-  | FullCustomEventsOptions
-  | FullCustomEventsWithDebounce
-  | FullCustomEventsWithThrottle
-  | FullCustomEventsOptionsWithThrottle
-  | FullCustomEventsOptionsWithDebounce;
-
-export type CustomEvents = FullCustomEvents | ShortCustomeEvents;
-
-export type CustomEventConstraint = Record<string, CustomEvents>;

package/src/api/RootComponent/CustomEvents/CustomEventsDef.ts

@@ -1,4 +0,0 @@
-import type { Primitive } from "hry-types/src/_internal/Primitive";
-import type { CustomEventsTags } from "./CustomEventsTag";
-
-export type CustomEventsDef = Record<string, Exclude<Primitive, undefined> | object | CustomEventsTags>;

package/src/api/RootComponent/CustomEvents/CustomEventsDoc.ts

@@ -1,4 +0,0 @@
-import type { Primitive } from "hry-types/src/_internal/Primitive";
-import type { CustomEventsTags } from "./CustomEventsTag";
-
-export type CustomEventsDoc = Record<string, Exclude<Primitive, undefined> | object | CustomEventsTags>;

package/src/api/RootComponent/CustomEvents/CustomEventsOption.ts

@@ -1,41 +0,0 @@
-import type { G } from "hry-types";
-import type { CustomEventConstraint } from "./CustomEventConstraint";
-
-export type CustomEventsOption<
-  TCustomEvents extends CustomEventConstraint,
-  DuplicateFields extends PropertyKey,
-> = {
-  /**
-   * customEvents 定义组件的自定义事件 [类型约束](CustomEventConstraint.ts)
-   * @remarks 通过this.A(123)调用。与events字段重复检测
-   * @example
-   * ```ts
-   * {
-   *  customEvents: {
-   *    A: Number, // number
-   *    B: [String as DetailedType<"male" | "femal">, Number], // "male" | "femal" | number
-   *    C: {
-   *      detail: String,
-   *      options: {
-   *        bubbles: true,
-   *        composed: true,
-   *        capturePhase: true,
-   *      },
-   *    },
-   *  },
-   *  methods: {
-   *    M1() {
-   *      // 调用自定义事件
-   *      this.A(123);
-   *      this.B("femal");
-   *      this.C("string");
-   *    },
-   *  },
-   * },
-   * ```
-   */
-  customEvents?:
-    & TCustomEvents
-    & G.IllegalFieldValidator<TCustomEvents, "bubbles" | "composed" | "capturePhase", 1, "options">
-    & G.DuplicateFieldValidator<TCustomEvents, DuplicateFields, "字段重复">;
-};

package/src/api/RootComponent/CustomEvents/CustomEventsTag.ts

@@ -1,59 +0,0 @@
-import type { IfExtends } from "hry-types/src/Any/IfExtends";
-import type {
-  BubblesCaptureComposedOption,
-  BubblesCaptureOption,
-  BubblesComposedOption,
-  BubblesOption,
-  CaptureComposedOption,
-  CaptureOption,
-  OptionsFieldsConfigOfCustomEvents,
-} from "./CustomEventConstraint";
-
-export type Bubbles = () => "bubbles";
-
-export type Capture = () => "capture";
-
-export type Composed = () => "composed";
-
-export type BubblesCapture = Bubbles | Capture;
-
-export type BubblesComposed = Bubbles | Composed;
-
-export type CaptureComposed = Capture | Composed;
-
-export type BubblesCaptureComposed = Bubbles | Capture | Composed;
-
-export type CustomEventsTags =
-  | Bubbles
-  | Capture
-  | BubblesCapture
-  | BubblesComposed
-  | CaptureComposed
-  | BubblesCaptureComposed;
-
-export type AddTagForCustomEventsDef<Options extends OptionsFieldsConfigOfCustomEvents> = IfExtends<
-  BubblesOption,
-  Options,
-  Bubbles,
-  IfExtends<
-    CaptureOption,
-    Options,
-    Capture,
-    IfExtends<
-      BubblesCaptureOption,
-      Options,
-      BubblesCapture,
-      IfExtends<
-        BubblesComposedOption,
-        Options,
-        BubblesComposed,
-        IfExtends<
-          CaptureComposedOption,
-          Options,
-          CaptureComposed,
-          IfExtends<BubblesCaptureComposedOption, Options, BubblesCaptureComposed>
-        >
-      >
-    >
-  >
->;

package/src/api/RootComponent/CustomEvents/GetCustomEventDef.ts

@@ -1,29 +0,0 @@
-import type { IfExtends } from "hry-types/src/Any/IfExtends";
-import type { DetailedType } from "../../../types/DetailedType";
-import type { InferDetailedType } from "../../../types/InferDetailedType";
-import type {
-  CustomEventConstraint,
-  FullCustomEvents,
-  ShortCustomeEvents,
-  SimpleCustomeEventsList,
-} from "./CustomEventConstraint";
-import type { AddTagForCustomEventsDef } from "./CustomEventsTag";
-
-export type GetShortCustomEventsDef<T extends ShortCustomeEvents> = T extends DetailedType ? InferDetailedType<T>
-  : T extends null ? null
-  : T extends undefined ? undefined
-  : T extends SimpleCustomeEventsList ? GetShortCustomEventsDef<T[number]>
-  : never;
-
-export type GetFullCustomEventsDef<T extends FullCustomEvents> =
-  | GetShortCustomEventsDef<T["detail"]>
-  | IfExtends<unknown, T["options"], never, AddTagForCustomEventsDef<T["options"] & {}>>;
-
-export type GetCustomEventsDef<T extends CustomEventConstraint> = {
-  [k in keyof T]: T[k] extends ShortCustomeEvents ? GetShortCustomEventsDef<T[k]>
-    : T[k] extends FullCustomEvents ?
-        | GetShortCustomEventsDef<T[k]["detail"]>
-        // 为事件加上标签
-        | IfExtends<unknown, T[k]["options"], never, AddTagForCustomEventsDef<NonNullable<T[k]["options"]>>>
-    : never;
-};

package/src/api/RootComponent/CustomEvents/GetCustomEventDoc.ts

@@ -1,47 +0,0 @@
-import type { IfExtends } from "hry-types/src/Any/IfExtends";
-import type { DetailedType } from "../../../types/DetailedType";
-import type { InferDetailedType } from "../../../types/InferDetailedType";
-import type {
-  CustomEventConstraint,
-  FullCustomEvents,
-  ShortCustomeEvents,
-  SimpleCustomeEventsList,
-} from "./CustomEventConstraint";
-import type { AddTagForCustomEventsDef } from "./CustomEventsTag";
-
-export type GetShortCustomEventsDoc<T extends ShortCustomeEvents> = T extends DetailedType ? InferDetailedType<T>
-  : T extends null ? null
-  : T extends undefined ? undefined
-  : T extends SimpleCustomeEventsList ? GetShortCustomEventsDoc<T[number]>
-  : never;
-
-export type GetFullCustomEventsDoc<T extends FullCustomEvents> =
-  | GetShortCustomEventsDoc<T["detail"]>
-  | IfExtends<unknown, T["options"], never, AddTagForCustomEventsDef<T["options"] & {}>>;
-
-/**
- * 获取自定义事件的文档
- * demo
- * ```ts
- * customEvents:{
- *   a:Number,
- *   b:{ detail: String,options:{ bubbles:true } }
- *   c:{ detail: Number,options:{ bubbles:true, composed:true } }
- * }
- * //result => {a:number,b:string|()=>'bubbles',c:number | ()=>'composed' }
- * ```
- * @returns object
- */
-// @dprint-ignore
-export type GetCustomEventDoc<T extends CustomEventConstraint> = 
-  {
-    [k in keyof T]: T[k] extends ShortCustomeEvents ? GetShortCustomEventsDoc<T[k]>  
-    // 应该写GetFullCustomEventsDoc<T[k]>带鼠标悬停时不是计算结果。所以代码重复了。
-      : // @ts-ignore T[k] 一定为 FullCustomEvents 类型
-        | GetShortCustomEventsDoc<T[k]["detail"]>
-        // 为自定义事件模型加标记,方便识别
-        // @ts-ignore T[k] 一定为 FullCustomEvents 类型
-        // | AddTagForCustomEventsDoc<T[k]["options"]>;
-        | IfExtends<unknown, T[k]["options"], never, AddTagForCustomEventsDef<T[k]["options"] & {}>>;
-  }
-;

package/src/api/RootComponent/CustomEvents/test/GetCustomEventDoc.test.ts

@@ -1,38 +0,0 @@
-import { Checking, type Test } from "hry-types";
-import type { GetCustomEventsDef } from "../GetCustomEventDef";
-
-import {
-  type BubblesCapturePhaseComposedExpected,
-  type BubblesCapturePhaseExpected,
-  type BubblesComposedExpected,
-  type bubblesExpected,
-  type CapturePhaseComposedExpected,
-  type CapturePhaseExpected,
-} from "./GetFullEventDoc.test";
-import {
-  type ListExpected,
-  type NullExpected,
-  type ObjExpected,
-  type StrExpected,
-  type UnionStrExpected,
-} from "./GetShortEventDoc.test";
-import { type mock_customEvents } from "./normal.test";
-
-type Mock_CustomEventsDoc = GetCustomEventsDef<typeof mock_customEvents>;
-
-export type Mock_CustomEventsDocExpected = {
-  str: StrExpected;
-  null: NullExpected;
-  nothing: undefined;
-  unionStr: UnionStrExpected;
-  union: ListExpected;
-  obj: ObjExpected;
-  bubbles: bubblesExpected;
-  capturePhase: CapturePhaseExpected;
-  bubbles_capturePhase: BubblesCapturePhaseExpected;
-  bubbles_composed: BubblesComposedExpected;
-  capturePhase_composed: CapturePhaseComposedExpected;
-  bubbles_capturePhase_composed: BubblesCapturePhaseComposedExpected;
-};
-
-void Checking<Mock_CustomEventsDoc, Mock_CustomEventsDocExpected, Test.Pass>;

package/src/api/RootComponent/CustomEvents/test/GetFullEventDoc.test.ts

@@ -1,57 +0,0 @@
-/* eslint-disable @typescript-eslint/no-unused-expressions */
-import { Checking, type Test } from "hry-types";
-import type {
-  Bubbles,
-  BubblesCapture,
-  BubblesCaptureComposed,
-  BubblesComposed,
-  Capture,
-  CaptureComposed,
-} from "../CustomEventsTag";
-
-import type { GetFullCustomEventsDoc } from "../GetCustomEventDoc";
-import { type mock_fullCustomEvents } from "./normal.test";
-
-// bubbles
-type bubblesResult = GetFullCustomEventsDoc<typeof mock_fullCustomEvents["bubbles"]>;
-
-export type bubblesExpected = string | Bubbles;
-
-Checking<bubblesResult, bubblesExpected, Test.Pass>;
-
-// CapturePhase
-type CapturePhaseResult = GetFullCustomEventsDoc<typeof mock_fullCustomEvents["capturePhase"]>;
-
-export type CapturePhaseExpected = Capture | null;
-
-Checking<CapturePhaseResult, CapturePhaseExpected, Test.Pass>;
-
-// bubbles_capturePhase
-type BubblesCapturePhaseResult = GetFullCustomEventsDoc<typeof mock_fullCustomEvents["bubbles_capturePhase"]>;
-
-export type BubblesCapturePhaseExpected = string | number | BubblesCapture;
-
-Checking<BubblesCapturePhaseResult, BubblesCapturePhaseExpected, Test.Pass>;
-
-// bubbles_composed
-type BubblesComposedResult = GetFullCustomEventsDoc<typeof mock_fullCustomEvents["bubbles_composed"]>;
-
-export type BubblesComposedExpected = "male" | "female" | BubblesComposed;
-
-Checking<BubblesComposedResult, BubblesComposedExpected, Test.Pass>;
-
-// capturePhase_composed
-type CapturePhaseComposedResult = GetFullCustomEventsDoc<typeof mock_fullCustomEvents["capturePhase_composed"]>;
-
-export type CapturePhaseComposedExpected = string | 0 | 1 | 2 | null | CaptureComposed;
-
-Checking<CapturePhaseComposedResult, CapturePhaseComposedExpected, Test.Pass>;
-
-// bubbles_capturePhase_composed
-type BubblesCapturePhaseComposedResult = GetFullCustomEventsDoc<
-  typeof mock_fullCustomEvents["bubbles_capturePhase_composed"]
->;
-
-export type BubblesCapturePhaseComposedExpected = boolean | BubblesCaptureComposed;
-
-Checking<BubblesCapturePhaseComposedResult, BubblesCapturePhaseComposedExpected, Test.Pass>;

package/src/api/RootComponent/CustomEvents/test/GetShortEventDoc.test.ts

@@ -1,36 +0,0 @@
-/* eslint-disable @typescript-eslint/no-unused-expressions */
-import { Checking, type Test } from "hry-types";
-
-import type { Mock_User } from "../../Properties/test/normalRequired.test";
-import type { GetShortCustomEventsDef } from "../GetCustomEventDef";
-import { type mock_shortCustomEvents } from "./normal.test";
-
-type StrResult = GetShortCustomEventsDef<typeof mock_shortCustomEvents["str"]>;
-
-export type StrExpected = string;
-
-Checking<StrResult, StrExpected, Test.Pass>;
-
-type NullResult = GetShortCustomEventsDef<typeof mock_shortCustomEvents["null"]>;
-
-export type NullExpected = null;
-
-Checking<NullResult, NullExpected, Test.Pass>;
-
-type UnionStrResult = GetShortCustomEventsDef<typeof mock_shortCustomEvents["unionStr"]>;
-
-export type UnionStrExpected = "male" | "female";
-
-Checking<UnionStrResult, UnionStrExpected, Test.Pass>;
-
-type ListResult = GetShortCustomEventsDef<typeof mock_shortCustomEvents["union"]>;
-
-export type ListExpected = string | 0 | 1 | 2 | null;
-
-Checking<ListResult, ListExpected, Test.Pass>;
-
-type ObjResult = GetShortCustomEventsDef<typeof mock_shortCustomEvents["obj"]>;
-
-export type ObjExpected = Mock_User;
-
-Checking<ObjResult, ObjExpected, Test.Pass>;

package/src/api/RootComponent/CustomEvents/test/error.test.ts

@@ -1,101 +0,0 @@
-import { RootComponent } from "../..";
-
-/**
- * 1 错误的字段类型
- */
-RootComponent()({
-  customEvents: {
-    // @ts-expect-error options 1.1 没有options字段时无需写对象形式,应简写`error1:Boolean`。
-    error1: {
-      detail: Boolean,
-    },
-    // @ts-expect-error options 1.2 不可以为空对象 无意义
-    error2: {
-      detail: Boolean,
-      options: {},
-    },
-    // @ts-expect-error 1.3 false字段不要写 默认就为false
-    error3: {
-      detail: Boolean,
-      options: { bubbles: false },
-    },
-    // @ts-expect-error 1.4 false 字段不要写 默认false
-    error4: {
-      detail: Boolean,
-      options: { capturePhase: false },
-    },
-    // @ts-expect-error 1.5 composed字段不可以单独开启,必须存在 bubbles或capturePhase字段为true时
-    error5: {
-      detail: Boolean,
-      options: { composed: true },
-    },
-  },
-});
-
-/**
- * 2 重复字段
- */
-RootComponent()({
-  events: {
-    aaa() {
-      void 0;
-    },
-  },
-  customEvents: {
-    // @ts-expect-error  "⚠️与events字段重复⚠️"
-    aaa: String,
-  },
-});
-
-/**
- * 3.1 非法字段验证
- */
-RootComponent()({
-  customEvents: {
-    error1: {
-      detail: String,
-      options: {
-        bubbles: true,
-        // @ts-expect-error 非法字段  composed 少了d
-        compose: true,
-      },
-    },
-  },
-});
-
-/**
- * 3.2 非法字段验证
- */
-RootComponent()({
-  customEvents: {
-    error2: {
-      detail: String,
-      options: {
-        bubbles: true,
-        // @ts-expect-error 非法字段  capturePhases 多了 s
-        capturePhases: true,
-      },
-    },
-  },
-});
-
-/**
- * 4 重复字段与非法同时存在时 只报其一错误(非法),确保报错位置在字段而非customEvents位置。
- */
-RootComponent()({
-  events: {
-    aaa() {
-      void 0;
-    },
-  },
-  customEvents: {
-    bbb: {
-      detail: null,
-      options: {
-        // @ts-expect-error 非法字段
-        bubbleds: false,
-      },
-    },
-    aaa: String,
-  },
-});