annil 1.7.8 → 1.8.1

package/dist/utils/deepEqual.js

@@ -1,69 +1,29 @@
-function isSameType(a, b) {
-    return Object.prototype.toString.call(a) === Object.prototype.toString.call(b);
+// 非null的对象类型
+function isNonNullObject(value) {
+    return value !== null && typeof value === "object";
 }
-// 定义一个辅助函数，用于判断两个对象的属性数量是否相同
-function isSameSize(a, b) {
-    return Object.keys(a).length === Object.keys(b).length;
-}
-// 定义一个辅助函数，用于判断两个函数的代码是否相同
-// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
-function isSameCode(a, b) {
-    // 去除空格比较函数字符串
-    return a.toString().split(" ").join("") === b.toString().split(" ").join("");
-}
-// 定义一个辅助函数，用于判断两个日期的时间戳是否相同
-function isSameTime(a, b) {
-    return a.getTime() === b.getTime();
-}
-// 定义一个辅助函数，用于判断两个正则表达式的模式和标志是否相同
-function isSamePattern(a, b) {
-    return a.source === b.source && a.flags === b.flags;
-}
-/**
- * 深度判断两个值是否相等,有一个值为非对象类型即使用Object.is判断。
- * 不支持原型上的属性
- * 两个函数使用toString()比较
- * 支持Date,RegExp
- */
-export function deepEqual(a, b) {
-    // 如果两个值是原始类型或null，直接用Object.is比较
-    if (a === null || b === null || typeof a !== "object" || typeof b !== "object") {
-        if (typeof a !== "function" || typeof b !== "function") {
-            return Object.is(a, b);
-        }
+export function deepEqual(value1, value2) {
+    // 2个非对象类型相等或同引用对象的情况。
+    if (Object.is(value1, value2)) {
+        return true;
     }
-    // 如果两个值是对象类型，先判断它们的类型、构造函数和属性数量是否相同
-    if (!isSameType(a, b) || a.constructor !== b.constructor || !isSameSize(a, b)) {
+    // 有一个不是非空对象,返回false。
+    if (!isNonNullObject(value1) || !isNonNullObject(value2)) {
         return false;
     }
-    // 如果两个值是函数类型，再判断它们的代码是否相同
-    if (typeof a === "function") {
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
-        return isSameCode(a, b);
-    }
-    // 如果两个值是日期类型，再判断它们的时间戳是否相同
-    if (a instanceof Date) {
-        return isSameTime(a, b);
-    }
-    // // 如果两个值是正则表达式类型，再判断它们的模式和标志是否相同
-    if (a instanceof RegExp) {
-        return isSamePattern(a, b);
+    // 到此，2个都是对象类型。
+    const _value1 = value1;
+    const _value2 = value2;
+    const value1Keys = Object.keys(_value1);
+    const value2Keys = Object.keys(_value2);
+    if (value1Keys.length !== value2Keys.length) {
+        return false;
     }
-    // 对于其他对象类型，递归地比较它们的每个属性和值是否深度相等
-    const keysA = Object.keys(a);
-    const keysB = Object.keys(b);
-    for (const key of keysA) {
-        if (keysB.includes(key)) {
-            // @ts-ignore
-            if (!deepEqual(a[key], b[key])) {
-                return false;
-            }
-        }
-        else {
+    for (const key of value1Keys) {
+        if (!value2Keys.includes(key) || !deepEqual(_value1[key], _value2[key])) {
             return false;
         }
     }
-    // 如果以上的条件都满足，说明两个值是深度相等的
     return true;
 }
 //# sourceMappingURL=deepEqual.js.map

package/dist/utils/deepEqual.js.map

@@ -1 +1 @@
-{"version":3,"file":"deepEqual.js","sourceRoot":"","sources":["../../src/utils/deepEqual.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deepEqual.js","sourceRoot":"","sources":["../../src/utils/deepEqual.ts"],"names":[],"mappings":"AACA,aAAa;AACb,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAe,EAAE,MAAe;IACxD,sBAAsB;IACtB,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,qBAAqB;IACrB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,eAAe;IACf,MAAM,OAAO,GAAG,MAAqB,CAAC;IACtC,MAAM,OAAO,GAAG,MAAqB,CAAC;IACtC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAExC,IAAI,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACxE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/throttle.d.ts

@@ -0,0 +1,10 @@
+type Callback = (...args: any[]) => any;
+/**
+ *  节流函数
+ *  规定时间内只触发第一次 例如点击按钮
+ * @param callback 回调函数
+ * @param interval 单位毫秒
+ * @returns
+ */
+export declare function throttle<F extends Callback>(callback: F, interval?: number): (...args: Parameters<F>) => void;
+export {};

package/dist/utils/throttle.js

@@ -0,0 +1,18 @@
+/**
+ *  节流函数
+ *  规定时间内只触发第一次 例如点击按钮
+ * @param callback 回调函数
+ * @param interval 单位毫秒
+ * @returns
+ */
+export function throttle(callback, interval = 200) {
+    let lastCall = 0;
+    return function (...args) {
+        const now = Date.now();
+        if (now - lastCall >= interval) {
+            lastCall = now;
+            callback(...args);
+        }
+    };
+}
+//# sourceMappingURL=throttle.js.map

package/dist/utils/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../src/utils/throttle.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAqB,QAAW,EAAE,QAAQ,GAAG,GAAG;IACtE,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,OAAO,UAAS,GAAG,IAAmB;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,IAAI,GAAG,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAC/B,QAAQ,GAAG,GAAG,CAAC;YAEf,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "annil",
-  "version": "1.7.8",
+  "version": "1.8.1",
   "description": "微信小程序(原生开发)插件",
   "main": "dist/index.js",
   "types": "src/index.ts",
@@ -17,24 +17,21 @@
     "tsc": "tsc --watch",
     "test": "jest --watch",
     "build": "tsc -p tsconfig.build.json",
-    "check": "eslint . --fix --max-warnings 0 && (dprint check || (dprint fmt && exit 1))"
+    "check": "eslint . --fix --max-warnings 0 && (dprint check || (dprint fmt && exit 1)) "
   },
   "devDependencies": {
     "@commitlint/config-conventional": "^17.6.5",
-    "@eslint/js": "^9.8.0",
-    "@types/eslint__js": "^8.42.3",
     "@types/jest": "^29.5.5",
     "commitlint": "^17.6.5",
-    "eslint": "^9.8.0",
+    "eslint": "^9.10.0",
     "husky": "^8.0.3",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
     "miniprogram-simulate": "^1.6.1",
     "mobx": "^6.9.0",
-    "prettier": "^2.8.8",
     "ts-jest": "^29.1.1",
     "typescript": "^5.5.4",
-    "typescript-eslint": "^8.0.0"
+    "typescript-eslint": "^8.4.0"
   },
   "files": [
     "LICENSE",
@@ -53,6 +50,6 @@
   "license": "MIT",
   "peerDependencies": {
     "hry-types": "^0.18.1",
-    "miniprogram-api-typings": "^3.12.2"
+    "miniprogram-api-typings": "^3.12.3"
   }
 }

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

@@ -0,0 +1,27 @@
+import type { RootComponentTrueOptions } from "../../RootComponent";
+import type { SubComponentType } from "../../SubComponent/SubComponentType";
+
+export function __throttleDebounce__FieldCheck(config: RootComponentTrueOptions | SubComponentType[]) {
+  if (Array.isArray(config)) {
+    for (const subComponent of config) {
+      __throttleDebounce__FieldCheck(subComponent);
+    }
+  } else {
+    const dataKeys: string[] = [];
+    if (config.data) {
+      dataKeys.push(...Object.keys(config.data));
+    }
+    if (config.computed) {
+      dataKeys.push(...Object.keys(config.computed));
+    }
+    if (config.properties) {
+      dataKeys.push(...Object.keys(config.properties));
+    }
+    if (config.store) {
+      dataKeys.push(...Object.keys(config.store));
+    }
+    if (dataKeys.includes("__throttleDebounce__")) {
+      throw Error(`__throttleDebounce__字段已被内部字段占用`);
+    }
+  }
+}

package/src/api/DefineComponent/normalizeOptions/computedWatchHandle/computedUpdater.ts

@@ -1,6 +1,6 @@
 import { deepEqual } from "../../../../utils/deepEqual";
 import type { Instance } from "../../../RootComponent/Instance/RootComponentInstance";
-import { deepProxy, getProxyOriginalValue } from "./data-tracer";
+import { deepProxy, getOriginalValue } from "./data-tracer";
 import { removeSubDependences } from "./dependencesOptimize";
 import { getPathsValue } from "./getPathsValue";
 
@@ -14,7 +14,7 @@ export function computedUpdater(this: Instance, isUpdated = false): boolean {
       // getPathsValue返回的是数组
       const curVal = getPathsValue(this.data, dep.paths.join("."))[0];
 
-      // 检查依赖是否更新
+      // 检查依赖是否改变了
       if (!deepEqual(curVal, dep.val)) {
         changed = true;
 
@@ -24,10 +24,9 @@ export function computedUpdater(this: Instance, isUpdated = false): boolean {
     if (changed) {
       const newDependences: ComputedDependence[] = [];
       const newValue = itemCache.method.call({ data: deepProxy(this.data, newDependences) });
-
-      // 更新值不会立即再次进入**函数,而是当前**函数运行完毕后触发**函数,
+      // 更新值不会立即再次进入**函数,而是当前**函数运行完毕后触发**函数,\
       this.setData({
-        [key]: getProxyOriginalValue(newValue),
+        [key]: getOriginalValue(newValue),
       });
 
       isUpdated = true;

package/src/api/DefineComponent/normalizeOptions/computedWatchHandle/data-tracer.ts

@@ -13,9 +13,9 @@ export function deepProxy(
       }
       const val = target[prop];
 
-      // 自身没有但原型链上有的属性不收集依赖
+      // 自身没有但原型链上有的属性不收集依赖,比如数组上的方法 slice map forEach
       if (prop in target && !Object.prototype.hasOwnProperty.call(target, prop)) {
-        return typeof val === "function" ? val.bind(target) : val;
+        return typeof val === "function" ? val.bind(target) : val; // : val 覆盖测试不到.
       }
       removePreviousDependence(dependences, basePath);
 
@@ -25,7 +25,7 @@ export function deepProxy(
 
       // 非对象不代理
       if (typeof val !== "object" || val === null) return val;
-
+      // console.log(val, typeof val);
       return deepProxy(val, dependences, curPath);
     },
     set(_target: object, prop: string) {
@@ -36,17 +36,11 @@ export function deepProxy(
   return new Proxy(data, handler);
 }
 
-export function getProxyOriginalValue(value: { __original__?: unknown }): unknown {
-  if (typeof value !== "object" || value === null) {
+// 如果是代理对象可以从__original__中获取原始值,否则返回自身
+export function getOriginalValue(value: { __original__?: unknown }): unknown {
+  if (typeof value !== "object" || value === null || value.__original__ === undefined) {
     return value;
   }
-  if (value.__original__) return value.__original__;
-
-  const ret = Array.isArray(value) ? [] : {};
-  for (const key in value) {
-    // @ts-ignore 隐式索引
-    ret[key] = getProxyOriginalValue(value[key]);
-  }
 
-  return ret;
+  return value.__original__;
 }

package/src/api/DefineComponent/normalizeOptions/computedWatchHandle/getPropertiesValue.ts

@@ -6,7 +6,7 @@ import type {
 } from "../../../RootComponent/Properties/PropertiesConstraint";
 
 type PropertiesDefaultValue = "" | 0 | [] | null | false;
-
+/* istanbul ignore next */
 function getRequiredSingleValue(
   PropType: RequiredSingle,
 ): PropertiesDefaultValue {
@@ -34,12 +34,10 @@ function IsRequiredSingle(config: PropertiesTypes): config is RequiredSingle {
 function IsRequiredUnion(config: PropertiesTypes): config is RequiredUnion {
   return !Reflect.has(config, "value");
 }
-export function getPropertiesValue(propertiesOpt: PropertiesConstraint | undefined): object | undefined {
-  if (propertiesOpt === undefined) return;
+export function getPropertiesValue(propertiesOpt: PropertiesConstraint): object {
   const result = {};
   for (const key in propertiesOpt) {
     const config = propertiesOpt[key];
-
     if (IsRequiredSingle(config)) {
       // @ts-ignore 隐式索引
       result[key] = getRequiredSingleValue(config);

package/src/api/DefineComponent/normalizeOptions/computedWatchHandle/initComputedAndGetCache.ts

@@ -2,7 +2,7 @@ import type { Func } from "hry-types/src/Misc/Func";
 import type { FinalOptionsOfComponent } from "..";
 
 import type { ComputedDependence } from "./computedUpdater";
-import { deepProxy, getProxyOriginalValue } from "./data-tracer";
+import { deepProxy, getOriginalValue } from "./data-tracer";
 import { removeSubDependences } from "./dependencesOptimize";
 
 type ItemCache = {
@@ -56,7 +56,7 @@ export function initComputedAndGetCache(
 
     // 验证依赖是否有效
     if (isValidDependences(dependences, uninitedkeys)) {
-      initValue = getProxyOriginalValue(initValue);
+      initValue = getOriginalValue(initValue);
 
       // 把计算属性初始值加入到options.data中
       options.data[key] = initValue;

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

@@ -4,7 +4,23 @@ import type {
   FullCustomEvents,
 } from "../../RootComponent/CustomEvents/CustomEventConstraint";
 import type { Instance } from "../../RootComponent/Instance/RootComponentInstance";
-import type { FinalOptionsOfComponent } from ".";
+import type { FinalOptionsOfComponent, ThrottleDebounce } from ".";
+function getThrottleDebounceConfig(
+  methodsName: string,
+  customEventOptions: FullCustomEvents,
+  __throttleDebounce__: ThrottleDebounce,
+) {
+  const { debounce, throttle } = customEventOptions;
+
+  if (debounce) {
+    __throttleDebounce__.debounce ||= {};
+    __throttleDebounce__.debounce[methodsName] = debounce;
+  } else if (throttle) {
+    __throttleDebounce__.throttle ||= {};
+    __throttleDebounce__.throttle[methodsName] = throttle;
+  }
+}
+
 // 类型守卫
 function IsFullCustomEvents(
   customEventOptions: CustomEvents,
@@ -15,16 +31,21 @@ function IsFullCustomEvents(
  * 把customEvents字段配置变成函数放入到componentOptions.methods中
  */
 export function customEventsHandle(
-  methods: FinalOptionsOfComponent["methods"],
+  finalOptions: FinalOptionsOfComponent,
   customEventsConfig: CustomEventConstraint,
 ) {
+  const methods = finalOptions.methods;
+  const data = finalOptions.data;
+
   for (const key in customEventsConfig) {
     const customEventOptions = customEventsConfig[key];
-
     if (IsFullCustomEvents(customEventOptions)) {
       methods[key] = function(this: Instance, detail: unknown) {
         this.triggerEvent(key, detail, customEventOptions.options);
       };
+      data.__throttleDebounce__ ||= {};
+      // 全配置允许设置防抖和节流,在这里保留配置到data.__throttleDebounce__中,以便后续使用
+      getThrottleDebounceConfig(key, customEventOptions, data.__throttleDebounce__);
     } else {
       methods[key] = function(this: Instance, detail: unknown) {
         this.triggerEvent(key, detail);

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

@@ -1,6 +1,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 { isEmptyObject } from "../../../utils/isEmptyObject";
 import { instanceConfig } from "../../InstanceInject/instanceConfig";
 import type { ComputedConstraint } from "../../RootComponent/Computed/ComputedConstraint";
@@ -11,6 +12,7 @@ import type { PageLifetimesOption } from "../../RootComponent/PageLifetimes/Page
 import type { PropertiesConstraint } from "../../RootComponent/Properties/PropertiesConstraint";
 import type { StoreConstraint } from "../../RootComponent/Store/StoreConstraint";
 import type { DefineComponentOption } from "..";
+import { __throttleDebounce__FieldCheck } from "./__throttleDebounce__FieldCheck";
 import { computedWatchHandle } from "./computedWatchHandle";
 import type { ComputedCache } from "./computedWatchHandle/initComputedAndGetCache";
 import { hijack } from "./hijackHandle";
@@ -25,12 +27,13 @@ import { sameFuncOptionsHandle } from "./sameFuncOptionsHandle";
 import { subComponentsOptionHandle } from "./subComponentsOptionHandle";
 
 export type WatchOldValue = Record<string, unknown[]>;
-
+export type ThrottleDebounce = Partial<Record<"throttle" | "debounce", Record<string, number>>>;
 export type OptionsInnerFields = {
   data: {
     __computedCache__?: ComputedCache;
     __storeConfig__?: StoreConstraint;
     __watchOldValue__?: WatchOldValue;
+    __throttleDebounce__?: ThrottleDebounce;
   };
   methods: {
     disposer?: Record<string, Func>;
@@ -78,7 +81,7 @@ export function normalizeOptions(
     data: {},
     methods: {},
     // 加入BStore,处理store字段的behavior
-    behaviors: [BStore],
+    behaviors: [BStore, BthrottleDebounce],
     externalClasses: [],
     pageLifetimes: {},
     isPage: false,
@@ -99,10 +102,15 @@ export function normalizeOptions(
     watch: {},
     observers: {},
   };
+
   if (rootComponentOption && !isEmptyObject(rootComponentOption)) {
+    // 验证配置中是否有内部字段__throttleDebounce__,有则报错,因为在rootComponentOptionHandle中会加入__throttleDebounce__字段到data中
+    __throttleDebounce__FieldCheck(rootComponentOption);
     rootComponentOptionHandle(finalOptionsForComponent, sameFuncOptions, rootComponentOption);
   }
   if (subComponentsOption && !isEmptyObject(subComponentsOption)) {
+    // 验证配置中是否有内部字段__throttleDebounce__,有则报错,因为在rootComponentOptionHandle中会加入__throttleDebounce__字段到data中
+    __throttleDebounce__FieldCheck(subComponentsOption);
     subComponentsOptionHandle(finalOptionsForComponent, subComponentsOption, sameFuncOptions);
   }
   sameFuncOptionsHandle(finalOptionsForComponent, rootComponentOption?.isPage, sameFuncOptions);
@@ -134,6 +142,7 @@ export function normalizeOptions(
 
   // 处理computed和watch配置
   computedWatchHandle(finalOptionsForComponent);
+  // 在rootComponentOptionHandle中保留了防抖节流配置,这里处理后,删除data.__throttleDebounce__字段
 
   // BBeforeCreate在最后面,让BeforeCreate生命周期运行在最终建立组件时。
   finalOptionsForComponent.behaviors.push(BBeforeCreate);

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

@@ -3,7 +3,7 @@ import type { FinalOptionsOfComponent } from ".";
 // 内部字段
 const internalFiled = {
   methods: ["disposer", "__computedUpdater__"],
-  data: ["__computedCache__", "__storeConfig__", "__watchOldValue__"],
+  data: ["__computedCache__", "__storeConfig__", "__watchOldValue__"], // "__throttleDebounce__" 放在之前的位置验证
 };
 
 /**

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

@@ -15,7 +15,8 @@ export function rootComponentOptionHandle(
   funcOptions: SameFuncOptions,
   rootComponentOptions: RootComponentTrueOptions,
 ) {
-  if (rootComponentOptions.customEvents) customEventsHandle(finalOptions.methods, rootComponentOptions.customEvents);
+  // 自定义事件处理时,如果配置了防抖节流,则需要在data.__throttleDebounce__保留配置信息,以便后续使用
+  if (rootComponentOptions.customEvents) customEventsHandle(finalOptions, rootComponentOptions.customEvents);
 
   if (rootComponentOptions.events) Object.assign(finalOptions.methods, rootComponentOptions.events);
 

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

@@ -31,7 +31,7 @@ export function sameFuncOptionsHandle(
       _sameFuncOptionsHandle(finalOptionsForComponent.pageLifetimes, funcOptions.pageLifetimes);
     }
   }
-  if (funcOptions.lifetimes) _sameFuncOptionsHandle(finalOptionsForComponent.lifetimes ||= {}, funcOptions.lifetimes);
+  if (funcOptions.lifetimes) _sameFuncOptionsHandle(finalOptionsForComponent.lifetimes, funcOptions.lifetimes);
 
-  if (funcOptions.watch) _sameFuncOptionsHandle(finalOptionsForComponent.watch ||= {}, funcOptions.watch);
+  if (funcOptions.watch) _sameFuncOptionsHandle(finalOptionsForComponent.watch, funcOptions.watch);
 }

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

@@ -35,3 +35,16 @@ RootComponent()({
     },
   },
 });
+// 3 、实例上不存在的字段应该报错
+RootComponent()({
+  computed: {
+    str(): number {
+      // @ts-ignore 不存在的字段
+      return this.data.numd;
+    },
+    other(): string {
+      // @ts-ignore 不存在的字段
+      return this.func;
+    },
+  },
+});

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

@@ -45,6 +45,28 @@ export type OptionsFieldsConfigOfCustomEvents =
 export type FullCustomEvents = {
   detail: ShortCustomeEvents;
   options: OptionsFieldsConfigOfCustomEvents;
+  debounce?: never;
+  throttle?: never;
+} | {
+  detail: ShortCustomeEvents;
+  options?: never;
+  debounce: number;
+  throttle?: never;
+} | {
+  detail: ShortCustomeEvents;
+  options?: never;
+  debounce?: never;
+  throttle: number;
+} | {
+  detail: ShortCustomeEvents;
+  options: OptionsFieldsConfigOfCustomEvents;
+  debounce?: never;
+  throttle: number;
+} | {
+  detail: ShortCustomeEvents;
+  options: OptionsFieldsConfigOfCustomEvents;
+  debounce: number;
+  throttle?: never;
 };
 
 export type CustomEvents = FullCustomEvents | ShortCustomeEvents;

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

@@ -1,3 +1,4 @@
+import type { IfExtends } from "hry-types/src/Any/IfExtends";
 import type { DetailedType } from "../../../types/DetailedType";
 import type { InferDetailedType } from "../../../types/InferDetailedType";
 import type {
@@ -16,7 +17,7 @@ export type GetShortCustomEventsDoc<T extends ShortCustomeEvents> = T extends De
 
 export type GetFullCustomEventsDoc<T extends FullCustomEvents> =
   | GetShortCustomEventsDoc<T["detail"]>
-  | AddTagForCustomEventsDoc<T["options"]>;
+  | IfExtends<unknown, T["options"], never, AddTagForCustomEventsDoc<T["options"] & {}>>;
 
 /**
  * 获取自定义事件的文档
@@ -40,6 +41,7 @@ export type GetCustomEventDoc<T extends CustomEventConstraint> =
         | GetShortCustomEventsDoc<T[k]["detail"]>
         // 为自定义事件模型加标记,方便识别
         // @ts-ignore T[k] 一定为 FullCustomEvents 类型
-        | AddTagForCustomEventsDoc<T[k]["options"]>;
+        // | AddTagForCustomEventsDoc<T[k]["options"]>;
+        | IfExtends<unknown, T[k]["options"], never, AddTagForCustomEventsDoc<T[k]["options"] & {}>>;
   }
 ;

package/src/behaviors/BbeforeCreated.ts

@@ -8,7 +8,7 @@ export const BBeforeCreate = Behavior({
   definitionFilter(
     options: Omit<FinalOptionsOfComponent, "customEvents" | "store" | "events" | "computed">,
   ) {
-    // 触发beforeCreate生命周期函数  options.lifetimes在之前被赋值过默认{}所以！
+    // 触发beforeCreate生命周期函数
     const beforeCreateFunc = options.lifetimes.beforeCreate;
 
     if (beforeCreateFunc) {

package/src/behaviors/BthrottleDebounce.ts

@@ -0,0 +1,28 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import type { Instance } from "../api/RootComponent/Instance/RootComponentInstance";
+import { debounce } from "../utils/debounce";
+import { throttle } from "../utils/throttle";
+
+export const BthrottleDebounce = Behavior({
+  lifetimes: {
+    created(this: Instance) {
+      const __throttleDebounce__ = this.data.__throttleDebounce__;
+      if (!__throttleDebounce__) return;
+      const debounceConfig = __throttleDebounce__.debounce;
+      if (debounceConfig) {
+        for (const key in debounceConfig) {
+          const _this = this as any;
+          _this[key] = debounce(_this[key].bind(this), debounceConfig[key]);
+        }
+      }
+      const throttleConfig = __throttleDebounce__.throttle;
+      if (throttleConfig) {
+        for (const key in throttleConfig) {
+          const _this = this as any;
+          _this[key] = throttle(_this[key].bind(this), throttleConfig[key]);
+        }
+      }
+      delete this.data.__throttleDebounce__;
+    },
+  },
+});

package/src/index.ts

@@ -7,6 +7,8 @@ import type { CreateComponentType } from "./types/CreateComponentType";
 import type { DetailedType } from "./types/DetailedType";
 import type { ExtendComponentType } from "./types/ExtendComponentType";
 import type { ParamsEqual } from "./types/TwoParamsEqual";
+export * from "./utils/_utils";
+
 export type {
   Bubbles,
   BubblesCapture,

package/src/utils/_utils.ts

@@ -0,0 +1,8 @@
+import { assertNonNullable } from "./assertNonNullable";
+import { debounce } from "./debounce";
+import { deepClone } from "./deepClone";
+import { deepEqual } from "./deepEqual";
+import { isEmptyObject } from "./isEmptyObject";
+import { throttle } from "./throttle";
+
+export { assertNonNullable, debounce, deepClone, deepEqual, isEmptyObject, throttle };

package/src/utils/debounce.ts

@@ -0,0 +1,19 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * 防抖函数
+ * 应用在输入框输入时，只有在输入完成并delay后,才会触发搜索
+ * @param func
+ * @param delay
+ * @returns
+ */
+export function debounce<F extends (...args: any[]) => any>(func: F, delay: number): (...args: Parameters<F>) => void {
+  let timeoutId: NodeJS.Timeout | null = null;
+
+  return (...args: Parameters<F>): void => {
+    if (timeoutId) {
+      clearTimeout(timeoutId);
+    }
+
+    timeoutId = setTimeout(() => func(...args), delay);
+  };
+}