annil 1.8.3 → 1.10.1

package/src/api/DefineComponent/normalizeOptions/index.ts

@@ -2,6 +2,7 @@ import type { Func } from "hry-types/src/Misc/_api";
 import { BBeforeCreate } from "../../../behaviors/BbeforeCreated";
 import { BStore } from "../../../behaviors/BStore";
 import { BthrottleDebounce } from "../../../behaviors/BthrottleDebounce";
+import { applyDebounceAndThrottle } from "../../../utils/applyDebounceAndThrottle";
 import { isEmptyObject } from "../../../utils/isEmptyObject";
 import { instanceConfig } from "../../InstanceInject/instanceConfig";
 import type { ComputedConstraint } from "../../RootComponent/Computed/ComputedConstraint";
@@ -19,6 +20,7 @@ import { hijack } from "./hijackHandle";
 import { isPageCheck } from "./hijackHandle/isPageCheck";
 import { loadReceivedDataHandle } from "./hijackHandle/loadReceivedDataHandle";
 import { onLoadReceivedDataHandle } from "./hijackHandle/onLoadReceivedDataHandle";
+import { pagePathCheck } from "./hijackHandle/pagePathCheck";
 import { initStore } from "./initStore";
 import { injectInfoHandler } from "./injectInfoHandler";
 import { InternalFieldProtection } from "./internalFieldProtection";
@@ -36,8 +38,6 @@ export type OptionsInnerFields = {
     __throttleDebounce__?: ThrottleDebounce;
   };
   methods: {
-    disposer?: Record<string, Func>;
-    // computedHandle加入
     __computedUpdater__?: Func;
   };
 };
@@ -55,7 +55,7 @@ export type FinalOptionsOfComponent = {
   data: DataConstraint & OptionsInnerFields["data"];
   observers: Record<string, Func>;
   behaviors: string[];
-  methods: MethodsConstraint & OptionsInnerFields["methods"];
+  methods: MethodsConstraint;
   externalClasses: string[];
   pageLifetimes: PageLifetimesOption<false, object>["pageLifetimes"] & {};
   isPage: boolean;
@@ -66,6 +66,7 @@ export type FinalOptionsOfComponent = {
   watch: Record<string, Func>;
   lifetimes: LifetimesConstraint;
 };
+
 /**
  * 把DefineComponentOption转化为原生Component API支持的配置
  * @param defineComponentOption
@@ -129,7 +130,7 @@ export function normalizeOptions(
   hijack(
     finalOptionsForComponent.lifetimes,
     "attached",
-    [isPageCheck(rootComponentOption?.isPage)],
+    [isPageCheck(rootComponentOption?.isPage), pagePathCheck(defineComponentOption.path)],
   );
 
   // 页面时删除预设的虚拟组件字段
@@ -137,6 +138,9 @@ export function normalizeOptions(
     Reflect.deleteProperty(finalOptionsForComponent.options, "virtualHost");
   }
 
+  // 处理debounce和throttle前缀的方法(事件)配置
+  applyDebounceAndThrottle(finalOptionsForComponent.methods);
+
   // 初始化store数据到data并把store配置放入到data的__storeConfig__下为后续使用
   initStore(finalOptionsForComponent);
 

package/src/api/SubComponent/SubComponentType.ts

@@ -9,6 +9,7 @@ type _SubComponentType = {
     | boolean
     | symbol
     | null
+    | undefined
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     | Record<string, any>
     | unknown[]

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

@@ -53,3 +53,36 @@ SubComponent<{}, OnlyPropsCompDoc>()({
     },
   },
 });
+// 4 与data的内部字段重复
+SubComponent<{}, OnlyPropsCompDoc>()({
+  data: {
+    _aaa_fff: 123,
+  },
+  computed: {
+    // @ts-expect-error 与data的内部字段重复
+    _aaa_fff(): number {
+      return 123;
+    },
+  },
+});
+// 5 与store的内部字段重复
+SubComponent<{}, OnlyPropsCompDoc>()({
+  store: {
+    _aaa_ccc: () => 123,
+  },
+  computed: {
+    // @ts-expect-error 与store的内部字段重复
+    _aaa_ccc(): number {
+      return 123;
+    },
+  },
+});
+// 6 与root字段重复
+SubComponent<{ data: { _aaa_ccc: 123 } }, OnlyPropsCompDoc>()({
+  computed: {
+    // @ts-expect-error 与store的内部字段重复
+    _aaa_ccc(): number {
+      return 123;
+    },
+  },
+});

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

@@ -168,3 +168,15 @@ SubComponent<{ data: { _num: number } }, $aaa>()({
     },
   },
 });
+
+// computed中可写 内部字段
+SubComponent<{ data: { _num: number } }, $aaa>()({
+  computed: {
+    aaa_isReady() {
+      return true;
+    },
+    _aaa_ccc(): string {
+      return "123";
+    },
+  },
+});

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

@@ -55,3 +55,10 @@ SubComponent<{}, OnlyPropsCompDoc>()({
     _aaa_xxx: 123, // ok 内部字段可写
   },
 });
+// 4 与root的数据字段重复
+SubComponent<{ data: { aaa_str: 123 } }, OnlyPropsCompDoc>()({
+  data: {
+    // @ts-expect-error 与root的data字段重复
+    aaa_str: "a",
+  },
+});

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

@@ -16,15 +16,15 @@ type DocA = ComponentType<{
 
 SubComponent<{
   properties: {
-    aaa_str: string;
-    aaa_num: number;
+    str: string;
   };
 }, DocA>()({
   inherit: {
-    aaa_str: "aaa_str",
+    aaa_str: "str",
   },
   data: {
     aaa_num: 20,
+    _aaa_xxx: 30,
   },
   store: {
     // @ts-expect-error 1 与 inherit 字段重复
@@ -33,5 +33,17 @@ SubComponent<{
     aaa_num: () => user.age,
     // @ts-expect-error 3 超出约束字段
     num: () => user.age,
+    // @ts-expect-error 4 与data的内部字段重复
+    _aaa_xxx: () => user.age,
+  },
+});
+SubComponent<{
+  properties: {
+    aaa_num: number;
+  };
+}, DocA>()({
+  store: {
+    // @ts-expect-error 与 root 的 properties 字段重复
+    aaa_num: () => 123,
   },
 });

package/src/api/SubComponent/index.ts

@@ -38,7 +38,10 @@ import type { CreateSubComponentDoc } from "./SubReturnType/CreateSubComponentDo
 import type { SubStoreConstraint } from "./SubStore/SubStoreConstraint";
 import type { SubStoreOption } from "./SubStore/SubStoreOption";
 import type { SubWatchOption } from "./SubWatch/SubWatchOption";
-
+// type getLegalKeys<K> = K extends Exclude<CompDocKeys, (keyof (InheritDoc & SubDataDoc))> ? K
+//   : K extends keyof AllRootDataDoc ? never
+//   : K extends Extract<Exclude<keyof NoInfer<TSubStore>, keyof SubDataDoc>, InnerFields<Prefix>> ? K
+//   : never;
 type Options<
   RootDoc extends RootComponentType,
   IsPage extends boolean,
@@ -59,21 +62,68 @@ type Options<
   SubMethodsDoc extends object,
   CompDocKeys extends PropertyKey = keyof CurrentCompDoc["properties"],
 > =
-  & SubInheritOption<TInherit, CompDocKeys>
+  & SubInheritOption<
+    TInherit,
+    {
+      [k in keyof NoInfer<TInherit>]:
+        // 与根组件的数据字段重复的不合法
+        k extends keyof (AllRootDataDoc) ? never
+          // 继承CompDocKeys的字段合法
+          : k extends CompDocKeys ? k
+          : never;
+    }[keyof NoInfer<TInherit>]
+  >
   & SubDataOption<
     TSubData,
     // 合法的配置
-    Exclude<CompDocKeys, (keyof InheritDoc)> | InnerFields<Prefix>
+    {
+      [k in keyof NoInfer<TSubData>]:
+        // 与根组件和InheritDoc的数据字段重复的不合法
+        k extends keyof (AllRootDataDoc) ? never
+          // 继承剩余的Doc的字段合法
+          : k extends Exclude<CompDocKeys, (keyof (InheritDoc))> ? k
+          // 内部字段合法
+          : k extends InnerFields<Prefix> ? k
+          : never;
+    }[keyof NoInfer<TSubData>]
   >
   & SubStoreOption<
     TSubStore,
-    // 合法的配置
-    Exclude<CompDocKeys, (keyof (InheritDoc & SubDataDoc))> | InnerFields<Prefix>
+    {
+      [k in keyof NoInfer<TSubStore>]:
+        // 与根组件和DataDoc的数据字段重复的不合法(主要是验证内部字段)
+        k extends keyof (AllRootDataDoc & SubDataDoc) ? never
+          // 继承剩余Doc的字段合法
+          : k extends Exclude<CompDocKeys, (keyof (InheritDoc & SubDataDoc))> ? k
+          // 内部字段合法
+          : k extends InnerFields<Prefix> ? k
+          : never;
+    }[keyof NoInfer<TSubStore>]
   >
+  // 下面为之前的写法 不好与根组件的字段重复检测。
+
+  // // 合法的字段(继承组件类型的keys)
+  // | Exclude<CompDocKeys, (keyof (InheritDoc & SubDataDoc))>
+  // // 合法的内部字段(不与data重复的内部字段)
+  // | Extract<Exclude<keyof NoInfer<TSubStore>, keyof SubDataDoc>, InnerFields<Prefix>>
+  // 不与allData重复的字段
+  // | Exclude<keyof NoInfer<TSubStore>, keyof AllRootDataDoc>
+
   & SubComputedOption<
     TSubComputed,
-    // 合法的配置
-    Exclude<CompDocKeys, (keyof (InheritDoc & SubDataDoc & SubStoreDoc))> | InnerFields<Prefix>,
+    {
+      [k in keyof NoInfer<TSubComputed>]:
+        // 与根组件和DataDoc和SubStoreDoc的key重复的不合法(主要是验证内部字段)
+        k extends keyof (AllRootDataDoc & SubDataDoc & SubStoreDoc) ? never
+          // 继承剩余Doc的字段合法
+          : k extends Exclude<CompDocKeys, (keyof (InheritDoc & SubDataDoc & SubStoreDoc))> ? k
+          // 内部字段合法
+          : k extends InnerFields<Prefix> ? k
+          : never;
+    }[keyof NoInfer<TSubComputed>],
+    // 下面为之前的写法 不好与根组件的字段重复检测。
+    // | Exclude<CompDocKeys, (keyof (InheritDoc & SubDataDoc & SubStoreDoc))>
+    // | Extract<Exclude<keyof NoInfer<TSubComputed>, keyof (SubDataDoc & SubStoreDoc)>, InnerFields<Prefix>>,
     {
       data: ComputeObject<
         & AllRootDataDoc

package/src/api/{navigateTo.ts → wxSugar.ts}

@@ -47,7 +47,7 @@ function _encodeURIComponent(
 
   return Object.assign(result, option);
 }
-
+const backFuncs: (undefined | ((...args: unknown[]) => void))[] = [];
 /**
  * 页面onload参数中接受的数据值是传递的url解析后的字符串。例如:A页面通过`wx.navigateTo({url:'/pages/test/test?num=123&obj={"name":"zhao"}'})`
  * test页面onLoad(data)的参数data接受内容为` data = {num:"123",obj:"{"name":"zhao"}"}`即默认的url传的数据值为字符串,需要在接收时自行解析(JSON.parse)。且url采取ASCII编码只能接受0x20-0x7e区间的符号。无法使用一些特殊符号 如 ` :/?#[]@!$&'()*+,;= `。
@@ -55,7 +55,9 @@ function _encodeURIComponent(
  */
 export function navigateTo<TPageDoc extends PageDoc = never>(
   option: NoInfer<NavigateToOption<TPageDoc>>,
+  onBack?: (res: unknown) => void,
 ) {
+  backFuncs.push(onBack);
   // @ts-ignore 隐式索引
   if (!option.data) {
     return wx.navigateTo(option);
@@ -65,3 +67,41 @@ export function navigateTo<TPageDoc extends PageDoc = never>(
     );
   }
 }
+type WMNavigateBackOption = WechatMiniprogram.NavigateBackOption;
+type NavigateBackOption<Data> = WMNavigateBackOption & { data?: Data };
+
+/**
+ * @param options
+ * @returns
+ */
+export function navigateBack<Data, T extends NavigateBackOption<Data> = NavigateBackOption<Data>>(
+  options?: T,
+): WechatMiniprogram.PromisifySuccessResult<T, WMNavigateBackOption> {
+  const backFunc = backFuncs.pop();
+  if (backFunc) {
+    if (!options || options.data === undefined) {
+      throw new Error("navigateBack 需要带有data参数的配置对象,因为返回的组件需要data数据");
+    }
+    const data = options.data;
+    const complete = options.complete;
+    options.complete = (res) => {
+      backFunc(data);
+      if (complete) {
+        complete(res);
+      }
+    };
+  }
+  return wx.navigateBack(options);
+}
+export function redirectTo<TPageDoc extends PageDoc = never>(
+  option: NoInfer<NavigateToOption<TPageDoc>>,
+) {
+  // @ts-ignore 隐式索引
+  if (!option.data) {
+    return wx.redirectTo(option);
+  } else {
+    return wx.redirectTo(
+      _encodeURIComponent(option as NavigateToOption<TPageDoc> & { data: object }),
+    );
+  }
+}

package/src/index.ts

@@ -1,8 +1,8 @@
 import { DefineComponent } from "./api/DefineComponent";
 import { type IInjectInfo, instanceConfig } from "./api/InstanceInject/instanceConfig";
-import { navigateTo } from "./api/navigateTo";
 import { RootComponent } from "./api/RootComponent";
 import { SubComponent } from "./api/SubComponent";
+import { navigateBack, navigateTo, redirectTo } from "./api/wxSugar";
 import type { CreateComponentType } from "./types/CreateComponentType";
 import type { DetailedType } from "./types/DetailedType";
 import type { ExtendComponentType } from "./types/ExtendComponentType";
@@ -38,8 +38,10 @@ export {
   type ExtendComponentType,
   type IInjectInfo,
   instanceConfig,
+  navigateBack,
   navigateTo,
   type ParamsEqual,
+  redirectTo,
   RootComponent,
   SubComponent,
 };

package/src/thirdLib/wm/index.ts

@@ -5,3 +5,5 @@ export type { Swiper } from "./swiper";
 export type { View } from "./view";
 
 export type { Textarea } from "./Textarea";
+
+export type { Map } from "./map";

package/src/thirdLib/wm/map.ts

@@ -0,0 +1,266 @@
+import type { CreateComponentType } from "../../types/CreateComponentType";
+
+type RegionChangeBegin = { type: "begin"; causedBy: "gesture" | "update" };
+
+export type MarkLocation = { latitude: number; longitude: number };
+
+type RegionChangeEnd = {
+  type: "end";
+  causedBy: "drag" | "scale" | "update";
+  centerLocation: MarkLocation;
+  region: { northeast: MarkLocation; southwest: MarkLocation };
+  rotate: number;
+  scale: number;
+  skew: number;
+};
+
+type RegionChangeDetail = RegionChangeBegin | RegionChangeEnd;
+
+export type Callout = {
+  content: string;
+  display: "ALWAYS" | "BYCLICK";
+  color?: string;
+  fontSize?: string | number;
+  borderWidth?: number;
+  borderRadius?: number;
+  borderColor?: string;
+  bgColor?: string;
+  padding?: number;
+  textAlign?: "center" | "left" | "right";
+  /**
+   * 横向偏移量，向右为正数	number	2.11.0
+   */
+  anchorX?: number;
+  /**
+   * anchorY	纵向偏移量，向下为正数 number	2.11.0
+   */
+  anchorYL?: number;
+};
+
+// 官方说明 https://developers.weixin.qq.com/miniprogram/dev/component/map.html#marker
+export type Marker = {
+  // 标记点 id  marker 点击事件回调会返回此 id
+  id: number;
+  // 标注图标宽度 默认为图片实际宽度
+  width: number | string;
+  // 标注图标高度 默认为图片实际高度
+  height: number | string;
+  // 聚合簇的 id 自定义点聚合簇效果时使用
+  clusterId?: number;
+  // 是否参与点聚合 默认不参与点聚合
+  joinCluster?: boolean;
+  // 纬度 浮点数，范围 -90 ~ 90
+  latitude: number;
+  // 经度 浮点数，范围 -180 ~ 180
+  longitude: number;
+  // 标注点名 点击时显示，callout 存在时将被忽略
+  title?: string;
+  // 显示层级 默认为 0
+  zIndex?: number;
+  // 显示的图标 项目目录下的图片路径，支持网络路径、本地路径、代码包路径（2.3.0）
+  iconPath: string;
+  // 旋转角度 顺时针旋转的角度，范围 0 ~ 360，默认为 0
+  rotate?: number;
+  // 标注的透明度 默认 1，无透明，范围 0 ~ 1
+  alpha?: number;
+  // 标记点上方的气泡窗口 支持的属性见下表，可识别换行符
+  callout?: Callout;
+  // 自定义气泡窗口 支持的属性见下表
+  customCallout?: Callout;
+  // 为标记点旁边增加标签 支持的属性见下表，可识别换行符
+  label?: Callout;
+  // 经纬度在标注图标的锚点，默认底边中点
+  anchor?: { x: number; y: number };
+  // 无障碍访问，（属性）元素的额外描述
+  ariaLabel?: string;
+  // 碰撞关系 详见下表碰撞关系	3.4.3
+  collisionRelation?: string;
+  // 碰撞类型 详见下表碰撞关系	3.4.3
+  collision?: string;
+};
+
+export type Circle = {
+  // 纬度	number	是	浮点数，范围 -90 ~ 90
+  latitude: number;
+  // 经度	number	是	浮点数，范围 -180 ~ 180
+  longitude: number;
+  // 半径	number	是
+  radius: number;
+  // 描边的颜色	string	否	十六进制
+  color?: string;
+  // 填充颜色	string	否	十六进制
+  fillColor?: string;
+  // 描边的宽度	number	否
+  strokeWidth?: number;
+  // 压盖关系	string	否	默认为 abovelabels
+  level?: string;
+};
+
+export type Polygon = {
+  // 边线虚线	Array<number>	否	默认值 [0, 0] 为实线，[10, 10]表示十个像素的实线和十个像素的空白（如此反复）组成的虚线	2.22.0
+  dashArray?: number[];
+  // 经纬度数组	array	是	[{latitude: 0, longitude: 0}]	2.3.0
+  points: MarkLocation[];
+  // 描边的宽度	number	否		2.3.0
+  strokeWidth?: number;
+  // 描边的颜色	string	否	十六进制	2.3.0
+  strokeColor?: string;
+  // 填充颜色	string	否	十六进制
+  fillColor?: string;
+  // 设置多边形 Z 轴数值	number	否		2.3.0
+  zIndex?: number;
+  // 压盖关系	string	否	默认为 abovelabels	2.14.0
+  level?: string;
+};
+
+export type Polyline = {
+  // 经纬度数组	array
+  points: MarkLocation[];
+  // 线的颜色	string	否	十六进制
+  color?: string;
+  // 彩虹线	array	否	存在时忽略 color 值	2.13.0
+  colorList?: string[];
+  // 线的宽度	number	否
+  width?: number;
+  // 是否虚线	boolean	否	默认 false
+  dottedLine?: boolean;
+  // 带箭头的线	boolean	否	默认 false，开发者工具暂不支持该属性	1.2.0
+  arrowLine?: boolean;
+  // 更换箭头图标	string	否	在 arrowLine 为 true 时生效	1.6.0
+  arrowIconPath?: string;
+  // 线的边框颜色	string	否		1.2.0
+  borderColor?: string;
+  // 线的厚度	number	否		1.2.0
+  borderWidth?: number;
+  // 压盖关系	string	否	默认为 abovelabels	2.14.0
+  level?: string;
+  // 文字样式	TextStyle	否	折线上文本样式	2.22.0
+  textStyle?: TextStyle;
+  // 分段文本	Array<SegmentText>	否	折线上文本内容和位置	2.22.0
+  segmentTexts?: SegmentText[];
+};
+
+export type TextStyle = {
+  // 文本颜色	string	否	#000000
+  textColor?: string;
+  // 描边颜色	string	否	#ffffff
+  strokeColor?: string;
+  // 文本大小	number	否	14
+  fontSize?: number;
+};
+
+export type SegmentText = {
+  // 名称	string	默认''
+  name: string;
+  // 起点	number
+  startIndex: string;
+  // 终点	number
+  endIndex: number;
+};
+
+// 源自 https://developers.weixin.qq.com/miniprogram/dev/component/map.html#%E5%B1%9E%E6%80%A7%E8%AF%B4%E6%98%8E
+export type Map = CreateComponentType<"map", {
+  properties: {
+    // 中心经度 1.0.0
+    latitude: number;
+    // 中心纬度 1.0.0
+    longitude: number;
+    // 缩放级别，取值范围为3-20 1.0.0
+    scale?: number;
+    // 最小缩放级别 2.13.0
+    minScale?: number;
+    // 最大缩放级别 2.13.0
+    maxScale?: number;
+    // 标记点 1.0.0
+    markers?: Marker[];
+    // 即将移除，请使用 markers 1.0.0
+    covers?: Marker[];
+    // 路线  1.0.0
+    polyline?: Polyline[];
+    // 圆 1.0.0
+    circles?: Circle[];
+    // 控件（即将废弃，建议使用 cover-view 代替） 1.0.0
+    controls?: Marker[];
+    // 缩放视野以包含所有给定的坐标点 1.0.0
+    includePoints?: Marker[];
+    /**
+     * 显示带有方向的当前定位点 1.0.0
+     */
+    showLocation?: boolean;
+    // 多边形 2.3.0
+    polygons?: Polygon[];
+    // 地图能力【个性化地图】使用的key，不支持动态修改 2.3.0
+    subkey?: string;
+    // 地图能力【个性化地图】配置的 style
+    layerStyle?: number;
+    // 旋转角度，范围 0 ~ 360, 地图正北和设备 y 轴角度的夹角 2.5.0
+    rotate?: number;
+    // 倾斜角度，范围 0 ~ 40 , 关于 z 轴的倾角 2.5.0
+    skew?: number;
+    // 展示3D楼块 2.3.0
+    enable3D?: boolean;
+    // 显示指南针 2.3.0
+    showCompass?: boolean;
+    // 显示比例尺，工具暂不支持 2.8.0
+    showScale?: boolean;
+    // 开启俯视 2.3.0
+    enableOverlooking?: boolean;
+    // 开启最大俯视角，俯视角度从 45 度拓展到 75 度 2.26.0
+    enableAutoMaxOverlooking?: boolean;
+    // 是否支持缩放 2.3.0
+    enableZoom?: boolean;
+    // 是否支持拖动 2.3.0
+    enableScroll?: boolean;
+    // 是否支持旋转 2.3.0
+    enableRotate?: boolean;
+    // 是否开启卫星图 2.7.0
+    enableSatellite?: boolean;
+    // 是否开启实时路况 2.7.0
+    enableTraffic?: boolean;
+    // 是否展示 POI 点 2.14.0
+    enablePOI?: boolean;
+    // 是否展示建筑物 2.14.0
+    enableBuilding?: boolean;
+    // 配置项 2.8.2
+    setting?: object;
+  };
+  customEvents: {
+    // 点击地图时触发，2.9.0起返回经纬度信息 1.0.0
+    tap: MarkLocation;
+    // 点击标记点时触发，e.detail = {markerId} 1.0.0
+    markertap: { markerId: number };
+    // 点击label时触发，e.detail = {markerId} 2.9.0
+    labeltap: { markerId: number };
+    // 点击控件时触发，e.detail = {controlId} 1.0.0
+    controltap: { controlId: number };
+    // 点击标记点对应的气泡时触发e.detail = {markerId} 1.2.0
+    callouttap: { markerId: number };
+    // 在地图渲染更新完成时触发 1.6.0
+    updated: undefined;
+    /**
+     * 视野改变时，regionchange 会触发两次，返回的 type 值分别为 begin 和 end。
+     * 2.8.0 起 begin 阶段返回 causedBy，有效值为 gesture(手势触发) & update(接口触发)
+     * 2.3.0 起 end 阶段返回 causedBy，有效值为 drag(拖动导致)、scale(缩放导致)、update(调用更新接口导致)
+     */
+    regionchange: RegionChangeDetail;
+    // 点击地图poi点时触发，e.detail = {name, longitude, latitude} 2.3.0
+    poitap: { name: string; longitude: number; latitude: number };
+    // 点击地图路线时触发，e.detail = {longitude, latitude} 3.1.0
+    polylinetap: { longitude: number; latitude: number };
+    // 地图能力生效时触发，e.detail = {ability, errCode, errMsg}
+    abilitysuccess: { ability: string; errCode: number; errMsg: string };
+    // 地图能力失败时触发，e.detail = {ability, errCode, errMsg}
+    abilityfail: { ability: string; errCode: number; errMsg: string };
+    // 地图鉴权结果成功时触发，e.detail = {errCode, errMsg}
+    authsuccess: { errCode: number; errMsg: string };
+    // MapContext.moveAlong 插值动画时触发。e.detail = {markerId, longitude, latitude, animationStatus: "interpolating" | "complete"}, 3.1.0
+    interpolatepoint: {
+      markerId: number;
+      longitude: number;
+      latitude: number;
+      animationStatus: "interpolating" | "complete";
+    };
+    // 组件错误时触发，例如创建或鉴权失败，e.detail = {longitude, latitude}
+    error: { longitude: number; latitude: number };
+  };
+}>;

package/src/utils/applyDebounceAndThrottle.ts

@@ -0,0 +1,31 @@
+import type { Func } from "hry-types/src/Misc/Func";
+import { debounce } from "./debounce";
+import { throttle } from "./throttle";
+
+/**
+ * 对象中的函数应用防抖和节流
+ * 规则 函数字段已下划线开始的后缀 如 xxx_debounced500 或 sub_xxx_throttled,无效后缀如 _debouncedxxx 不会被处理
+ * @param obj
+ */
+export function applyDebounceAndThrottle(obj: Record<string, Func>) {
+  for (const [key, value] of Object.entries(obj)) {
+    if (!key.includes("_")) continue;
+    const suffix = key.split("_").at(-1) as string;
+
+    const remaining = suffix.slice(9);
+    const delay = remaining === "" ? 300 : Number(remaining);
+
+    if (suffix.startsWith("debounced")) {
+      if (!isNaN(delay)) {
+        obj[key] = debounce(value, delay);
+      }
+      continue;
+    }
+
+    if (suffix.startsWith("throttled")) {
+      if (!isNaN(delay)) {
+        obj[key] = throttle(value, delay);
+      }
+    }
+  }
+}

package/src/utils/debounce.ts

@@ -1,20 +1,22 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+type Callback = (...args: any[]) => any;
 /**
  * 防抖函数
  * 注意 需要在tsconfig.json的types中添加"node",否则NodeJS.Timeout会报错
- * 例如 应用在输入框输入时，只有在输入完成并delay后,才会触发搜索,
+ * 例如 在input框输入内容时,只有输入停止一段时间(wait)后,才会触发输入事件.
  * @param func
- * @param delay
+ * @param wait
  * @returns
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function debounce<F extends (...args: any[]) => any>(func: F, delay: number): (...args: Parameters<F>) => void {
+/* istanbul ignore next  */
+export function debounce<F extends Callback>(func: F, wait = 300): (...args: Parameters<F>) => void {
   let timeoutId: NodeJS.Timeout | null = null;
 
-  return (...args: Parameters<F>): void => {
+  return function(this: unknown, ...args: Parameters<F>): void {
     if (timeoutId) {
       clearTimeout(timeoutId);
     }
 
-    timeoutId = setTimeout(() => func(...args), delay);
+    timeoutId = setTimeout(() => func.call(this, ...args), wait);
   };
 }