@sybz-components/utils 0.0.10 → 0.0.12

package/dist/base.cjs

@@ -3,7 +3,7 @@
 require('vue');
 require('consola');
 require('es-toolkit');
-const format = require('./shared/utils.BaNHAtTs.cjs');
+const format = require('./shared/utils.DUIw9c4e.cjs');
 require('element-plus');
 require('./is.cjs');
 
@@ -33,4 +33,4 @@ exports.toLine = format.toLine;
 exports.tryCatch = format.tryCatch;
 exports.validate = format.validate;
 exports.validateForm = format.validateForm;
-exports.validateTrigger = format.validateTrigger;
+exports.validateOnSubmit = format.validateOnSubmit;

package/dist/base.d.cts

@@ -12,6 +12,7 @@ type WidthStyleResult = {
 };
 type ValidateTriggerType = 'blur' | 'change';
 type ValidateInput = ValidateRules | ValidatePrimitiveValue;
+type ValidateTypeInput = string | ValidateRules;
 type ValidateRuleResult = {
     required?: boolean;
     message?: string;
@@ -74,6 +75,10 @@ interface MockValueOptions {
     optionsIndex?: number | null;
 }
 interface ValidateRules {
+    /**
+     * 校验类型。作为 `validate({ type: 'mobile' })` 使用时生效。
+     */
+    type?: string;
     /**
      * 校验失败提示文案。
      */
@@ -365,7 +370,7 @@ declare function getType(type: unknown): string;
  */
 declare function delay(delay?: number, fn?: () => void): Promise<void>;
 /**
- * 为 `validate` 预置默认触发时机 `['blur', 'change']`。
+ * 为 `validate` 预置空触发时机，只在提交或手动调用表单校验时触发。
  *
  * @param type 校验类型。
  * @param rules 校验规则。
@@ -373,10 +378,10 @@ declare function delay(delay?: number, fn?: () => void): Promise<void>;
  * @returns 与 `validate` 一致。
  *
  * @example
- * const rule = validateTrigger('required', { message: '请输入名称' })
+ * const rule = validateOnSubmit('required', { message: '请输入名称' })
  */
-declare function validateTrigger(type?: string, rules?: ValidateRules, pureValid?: boolean): boolean | ValidateRuleResult;
-declare function validate(type?: string, rules?: ValidateInput, pureValid?: boolean): ValidateRuleResult | boolean;
+declare function validateOnSubmit(type?: ValidateTypeInput, rules?: ValidateInput | boolean, pureValid?: boolean): ValidateRuleResult | boolean;
+declare function validate(type?: ValidateTypeInput, rules?: ValidateInput | boolean, pureValid?: boolean): ValidateRuleResult | boolean;
 /**
  * 复制文本到剪贴板。
  *
@@ -450,19 +455,47 @@ declare function toLine(text: string, connect?: string): string;
  */
 declare function processWidth(initValue: WidthInput, isBase: true): string;
 declare function processWidth(initValue: WidthInput, isBase?: false): WidthStyleResult | {};
+interface ThrottleOptions {
+    /**
+     * 是否在首次调用时立即执行，默认 `true`。
+     */
+    leading?: boolean;
+    /**
+     * 是否在节流周期结束时执行最后一次调用，默认 `true`。
+     */
+    trailing?: boolean;
+}
+type ThrottleOptionsInput = boolean | ThrottleOptions;
+type ThrottledFunction<T extends Func> = ((...args: Parameters<T>) => ReturnType<T> | undefined) & {
+    cancel: () => void;
+    flush: () => ReturnType<T> | undefined;
+};
 /**
  * 创建节流函数。
  *
  * @param fn 需要节流执行的函数。
  * @param delay 节流间隔，单位毫秒，默认 `1000`。
- * @returns 节流后的函数。
+ * @param options 节流选项。传 `false` 等同于 `{ leading: false }`。
+ * @param resultCallback 每次真正执行后触发的结果回调。
+ * @returns 带 `cancel()` / `flush()` 方法的节流函数。
  *
  * @example
  * const onResize = throttle(() => {
  *   console.log('resize')
  * }, 300)
+ *
+ * @example
+ * const save = throttle(saveDraft, 1000, { leading: false, trailing: true })
+ *
+ * @example
+ * const track = throttle(trackPosition, 200, { trailing: false }, (result) => {
+ *   console.log(result)
+ * })
+ *
+ * track.cancel()
+ * track.flush()
  */
-declare function throttle<T extends Func>(fn: T, delay?: number): (...args: Parameters<T>) => void;
+declare function throttle<T extends Func>(fn: T, delay?: number, options?: ThrottleOptionsInput, resultCallback?: (result: ReturnType<T>) => void): ThrottledFunction<T>;
 /**
  * 统一处理 Promise 或任务函数执行结果。
  *
@@ -508,6 +541,13 @@ type DebouncedFunction<T extends Func> = ((...args: Parameters<T>) => Promise<Aw
  * }, 300)
  *
  * await search('sybz')
+ *
+ * @example
+ * const submit = debounce(saveForm, 500, true, (result) => {
+ *   console.log(result)
+ * })
+ *
+ * submit.cancel()
  */
 declare function debounce<T extends Func>(func: T, delay?: number, immediate?: boolean, resultCallback?: (result: ReturnType<T>) => void): DebouncedFunction<T>;
 /**
@@ -559,4 +599,4 @@ declare function getUtilsBuildTime(fallback?: string): string;
  */
 declare function test(): string;
 
-export { $toast, clearStorage, clone, confirm, copy, debounce, delay, getStorage, getType, getUtilsBuildTime, getVariable, isEmpty, log, merge, mockValue, processWidth, random, setStorage, test, throttle, toLine, tryCatch, validate, validateForm, validateTrigger };
+export { $toast, clearStorage, clone, confirm, copy, debounce, delay, getStorage, getType, getUtilsBuildTime, getVariable, isEmpty, log, merge, mockValue, processWidth, random, setStorage, test, throttle, toLine, tryCatch, validate, validateForm, validateOnSubmit };

package/dist/base.d.mts

@@ -12,6 +12,7 @@ type WidthStyleResult = {
 };
 type ValidateTriggerType = 'blur' | 'change';
 type ValidateInput = ValidateRules | ValidatePrimitiveValue;
+type ValidateTypeInput = string | ValidateRules;
 type ValidateRuleResult = {
     required?: boolean;
     message?: string;
@@ -74,6 +75,10 @@ interface MockValueOptions {
     optionsIndex?: number | null;
 }
 interface ValidateRules {
+    /**
+     * 校验类型。作为 `validate({ type: 'mobile' })` 使用时生效。
+     */
+    type?: string;
     /**
      * 校验失败提示文案。
      */
@@ -365,7 +370,7 @@ declare function getType(type: unknown): string;
  */
 declare function delay(delay?: number, fn?: () => void): Promise<void>;
 /**
- * 为 `validate` 预置默认触发时机 `['blur', 'change']`。
+ * 为 `validate` 预置空触发时机，只在提交或手动调用表单校验时触发。
  *
  * @param type 校验类型。
  * @param rules 校验规则。
@@ -373,10 +378,10 @@ declare function delay(delay?: number, fn?: () => void): Promise<void>;
  * @returns 与 `validate` 一致。
  *
  * @example
- * const rule = validateTrigger('required', { message: '请输入名称' })
+ * const rule = validateOnSubmit('required', { message: '请输入名称' })
  */
-declare function validateTrigger(type?: string, rules?: ValidateRules, pureValid?: boolean): boolean | ValidateRuleResult;
-declare function validate(type?: string, rules?: ValidateInput, pureValid?: boolean): ValidateRuleResult | boolean;
+declare function validateOnSubmit(type?: ValidateTypeInput, rules?: ValidateInput | boolean, pureValid?: boolean): ValidateRuleResult | boolean;
+declare function validate(type?: ValidateTypeInput, rules?: ValidateInput | boolean, pureValid?: boolean): ValidateRuleResult | boolean;
 /**
  * 复制文本到剪贴板。
  *
@@ -450,19 +455,47 @@ declare function toLine(text: string, connect?: string): string;
  */
 declare function processWidth(initValue: WidthInput, isBase: true): string;
 declare function processWidth(initValue: WidthInput, isBase?: false): WidthStyleResult | {};
+interface ThrottleOptions {
+    /**
+     * 是否在首次调用时立即执行，默认 `true`。
+     */
+    leading?: boolean;
+    /**
+     * 是否在节流周期结束时执行最后一次调用，默认 `true`。
+     */
+    trailing?: boolean;
+}
+type ThrottleOptionsInput = boolean | ThrottleOptions;
+type ThrottledFunction<T extends Func> = ((...args: Parameters<T>) => ReturnType<T> | undefined) & {
+    cancel: () => void;
+    flush: () => ReturnType<T> | undefined;
+};
 /**
  * 创建节流函数。
  *
  * @param fn 需要节流执行的函数。
  * @param delay 节流间隔，单位毫秒，默认 `1000`。
- * @returns 节流后的函数。
+ * @param options 节流选项。传 `false` 等同于 `{ leading: false }`。
+ * @param resultCallback 每次真正执行后触发的结果回调。
+ * @returns 带 `cancel()` / `flush()` 方法的节流函数。
  *
  * @example
  * const onResize = throttle(() => {
  *   console.log('resize')
  * }, 300)
+ *
+ * @example
+ * const save = throttle(saveDraft, 1000, { leading: false, trailing: true })
+ *
+ * @example
+ * const track = throttle(trackPosition, 200, { trailing: false }, (result) => {
+ *   console.log(result)
+ * })
+ *
+ * track.cancel()
+ * track.flush()
  */
-declare function throttle<T extends Func>(fn: T, delay?: number): (...args: Parameters<T>) => void;
+declare function throttle<T extends Func>(fn: T, delay?: number, options?: ThrottleOptionsInput, resultCallback?: (result: ReturnType<T>) => void): ThrottledFunction<T>;
 /**
  * 统一处理 Promise 或任务函数执行结果。
  *
@@ -508,6 +541,13 @@ type DebouncedFunction<T extends Func> = ((...args: Parameters<T>) => Promise<Aw
  * }, 300)
  *
  * await search('sybz')
+ *
+ * @example
+ * const submit = debounce(saveForm, 500, true, (result) => {
+ *   console.log(result)
+ * })
+ *
+ * submit.cancel()
  */
 declare function debounce<T extends Func>(func: T, delay?: number, immediate?: boolean, resultCallback?: (result: ReturnType<T>) => void): DebouncedFunction<T>;
 /**
@@ -559,4 +599,4 @@ declare function getUtilsBuildTime(fallback?: string): string;
  */
 declare function test(): string;
 
-export { $toast, clearStorage, clone, confirm, copy, debounce, delay, getStorage, getType, getUtilsBuildTime, getVariable, isEmpty, log, merge, mockValue, processWidth, random, setStorage, test, throttle, toLine, tryCatch, validate, validateForm, validateTrigger };
+export { $toast, clearStorage, clone, confirm, copy, debounce, delay, getStorage, getType, getUtilsBuildTime, getVariable, isEmpty, log, merge, mockValue, processWidth, random, setStorage, test, throttle, toLine, tryCatch, validate, validateForm, validateOnSubmit };

package/dist/base.d.ts

@@ -12,6 +12,7 @@ type WidthStyleResult = {
 };
 type ValidateTriggerType = 'blur' | 'change';
 type ValidateInput = ValidateRules | ValidatePrimitiveValue;
+type ValidateTypeInput = string | ValidateRules;
 type ValidateRuleResult = {
     required?: boolean;
     message?: string;
@@ -74,6 +75,10 @@ interface MockValueOptions {
     optionsIndex?: number | null;
 }
 interface ValidateRules {
+    /**
+     * 校验类型。作为 `validate({ type: 'mobile' })` 使用时生效。
+     */
+    type?: string;
     /**
      * 校验失败提示文案。
      */
@@ -365,7 +370,7 @@ declare function getType(type: unknown): string;
  */
 declare function delay(delay?: number, fn?: () => void): Promise<void>;
 /**
- * 为 `validate` 预置默认触发时机 `['blur', 'change']`。
+ * 为 `validate` 预置空触发时机，只在提交或手动调用表单校验时触发。
  *
  * @param type 校验类型。
  * @param rules 校验规则。
@@ -373,10 +378,10 @@ declare function delay(delay?: number, fn?: () => void): Promise<void>;
  * @returns 与 `validate` 一致。
  *
  * @example
- * const rule = validateTrigger('required', { message: '请输入名称' })
+ * const rule = validateOnSubmit('required', { message: '请输入名称' })
  */
-declare function validateTrigger(type?: string, rules?: ValidateRules, pureValid?: boolean): boolean | ValidateRuleResult;
-declare function validate(type?: string, rules?: ValidateInput, pureValid?: boolean): ValidateRuleResult | boolean;
+declare function validateOnSubmit(type?: ValidateTypeInput, rules?: ValidateInput | boolean, pureValid?: boolean): ValidateRuleResult | boolean;
+declare function validate(type?: ValidateTypeInput, rules?: ValidateInput | boolean, pureValid?: boolean): ValidateRuleResult | boolean;
 /**
  * 复制文本到剪贴板。
  *
@@ -450,19 +455,47 @@ declare function toLine(text: string, connect?: string): string;
  */
 declare function processWidth(initValue: WidthInput, isBase: true): string;
 declare function processWidth(initValue: WidthInput, isBase?: false): WidthStyleResult | {};
+interface ThrottleOptions {
+    /**
+     * 是否在首次调用时立即执行，默认 `true`。
+     */
+    leading?: boolean;
+    /**
+     * 是否在节流周期结束时执行最后一次调用，默认 `true`。
+     */
+    trailing?: boolean;
+}
+type ThrottleOptionsInput = boolean | ThrottleOptions;
+type ThrottledFunction<T extends Func> = ((...args: Parameters<T>) => ReturnType<T> | undefined) & {
+    cancel: () => void;
+    flush: () => ReturnType<T> | undefined;
+};
 /**
  * 创建节流函数。
  *
  * @param fn 需要节流执行的函数。
  * @param delay 节流间隔，单位毫秒，默认 `1000`。
- * @returns 节流后的函数。
+ * @param options 节流选项。传 `false` 等同于 `{ leading: false }`。
+ * @param resultCallback 每次真正执行后触发的结果回调。
+ * @returns 带 `cancel()` / `flush()` 方法的节流函数。
  *
  * @example
  * const onResize = throttle(() => {
  *   console.log('resize')
  * }, 300)
+ *
+ * @example
+ * const save = throttle(saveDraft, 1000, { leading: false, trailing: true })
+ *
+ * @example
+ * const track = throttle(trackPosition, 200, { trailing: false }, (result) => {
+ *   console.log(result)
+ * })
+ *
+ * track.cancel()
+ * track.flush()
  */
-declare function throttle<T extends Func>(fn: T, delay?: number): (...args: Parameters<T>) => void;
+declare function throttle<T extends Func>(fn: T, delay?: number, options?: ThrottleOptionsInput, resultCallback?: (result: ReturnType<T>) => void): ThrottledFunction<T>;
 /**
  * 统一处理 Promise 或任务函数执行结果。
  *
@@ -508,6 +541,13 @@ type DebouncedFunction<T extends Func> = ((...args: Parameters<T>) => Promise<Aw
  * }, 300)
  *
  * await search('sybz')
+ *
+ * @example
+ * const submit = debounce(saveForm, 500, true, (result) => {
+ *   console.log(result)
+ * })
+ *
+ * submit.cancel()
  */
 declare function debounce<T extends Func>(func: T, delay?: number, immediate?: boolean, resultCallback?: (result: ReturnType<T>) => void): DebouncedFunction<T>;
 /**
@@ -559,4 +599,4 @@ declare function getUtilsBuildTime(fallback?: string): string;
  */
 declare function test(): string;
 
-export { $toast, clearStorage, clone, confirm, copy, debounce, delay, getStorage, getType, getUtilsBuildTime, getVariable, isEmpty, log, merge, mockValue, processWidth, random, setStorage, test, throttle, toLine, tryCatch, validate, validateForm, validateTrigger };
+export { $toast, clearStorage, clone, confirm, copy, debounce, delay, getStorage, getType, getUtilsBuildTime, getVariable, isEmpty, log, merge, mockValue, processWidth, random, setStorage, test, throttle, toLine, tryCatch, validate, validateForm, validateOnSubmit };

package/dist/base.mjs

@@ -1,6 +1,6 @@
 import 'vue';
 import 'consola';
 import 'es-toolkit';
-export { $ as $toast, c as clearStorage, a as clone, b as confirm, d as copy, e as debounce, f as delay, g as getStorage, h as getType, i as getUtilsBuildTime, j as getVariable, k as isEmpty, l as log, m as merge, n as mockValue, p as processWidth, r as random, s as setStorage, t as test, o as throttle, q as toLine, u as tryCatch, v as validate, w as validateForm, x as validateTrigger } from './shared/utils.CzQQZf9j.mjs';
+export { $ as $toast, c as clearStorage, a as clone, b as confirm, d as copy, e as debounce, f as delay, g as getStorage, h as getType, i as getUtilsBuildTime, j as getVariable, k as isEmpty, l as log, m as merge, n as mockValue, p as processWidth, r as random, s as setStorage, t as test, o as throttle, q as toLine, u as tryCatch, v as validate, w as validateForm, x as validateOnSubmit } from './shared/utils.CTnx12Vx.mjs';
 import 'element-plus';
 import './is.mjs';

package/dist/format.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const format = require('./shared/utils.BaNHAtTs.cjs');
+const format = require('./shared/utils.DUIw9c4e.cjs');
 require('./is.cjs');
 require('consola');
 require('vue');

package/dist/format.mjs

@@ -1,4 +1,4 @@
-export { y as formatBytes, z as formatBytesConvert, A as formatDurationTime, B as formatImg, C as formatTextToHtml, D as formatThousands, E as formatTime, F as formatToFixed } from './shared/utils.CzQQZf9j.mjs';
+export { y as formatBytes, z as formatBytesConvert, A as formatDurationTime, B as formatImg, C as formatTextToHtml, D as formatThousands, E as formatTime, F as formatToFixed } from './shared/utils.CTnx12Vx.mjs';
 import './is.mjs';
 import 'consola';
 import 'vue';

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const format = require('./shared/utils.BaNHAtTs.cjs');
+const format = require('./shared/utils.DUIw9c4e.cjs');
 const day = require('./day.cjs');
 const is = require('./is.cjs');
 const ws = require('./ws.cjs');
@@ -45,7 +45,7 @@ exports.toLine = format.toLine;
 exports.tryCatch = format.tryCatch;
 exports.validate = format.validate;
 exports.validateForm = format.validateForm;
-exports.validateTrigger = format.validateTrigger;
+exports.validateOnSubmit = format.validateOnSubmit;
 exports.diffDate = day.diffDate;
 exports.diffDateFromCurrent = day.diffDateFromCurrent;
 exports.formatDate = day.formatDate;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export { $toast, clearStorage, clone, confirm, copy, debounce, delay, getStorage, getType, getUtilsBuildTime, getVariable, isEmpty, log, merge, mockValue, processWidth, random, setStorage, test, throttle, toLine, tryCatch, validate, validateForm, validateTrigger } from './base.cjs';
+export { $toast, clearStorage, clone, confirm, copy, debounce, delay, getStorage, getType, getUtilsBuildTime, getVariable, isEmpty, log, merge, mockValue, processWidth, random, setStorage, test, throttle, toLine, tryCatch, validate, validateForm, validateOnSubmit } from './base.cjs';
 export { diffDate, diffDateFromCurrent, formatDate, formatDateToDay, formatDateToMinute } from './day.cjs';
 export { isArray, isBoolean, isComponent, isDate, isEmptyObject, isFunction, isIOS, isMap, isNumber, isObject, isPlainObject, isPromise, isRegExp, isSVGElement, isSet, isString, isStringNumber, isSymbol, isUrl, objectToString, toRawType, toTypeString } from './is.cjs';
 export { WS, WSAutoReconnectOptions, WSHeartbeatOptions, WSOptions } from './ws.cjs';

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-export { $toast, clearStorage, clone, confirm, copy, debounce, delay, getStorage, getType, getUtilsBuildTime, getVariable, isEmpty, log, merge, mockValue, processWidth, random, setStorage, test, throttle, toLine, tryCatch, validate, validateForm, validateTrigger } from './base.mjs';
+export { $toast, clearStorage, clone, confirm, copy, debounce, delay, getStorage, getType, getUtilsBuildTime, getVariable, isEmpty, log, merge, mockValue, processWidth, random, setStorage, test, throttle, toLine, tryCatch, validate, validateForm, validateOnSubmit } from './base.mjs';
 export { diffDate, diffDateFromCurrent, formatDate, formatDateToDay, formatDateToMinute } from './day.mjs';
 export { isArray, isBoolean, isComponent, isDate, isEmptyObject, isFunction, isIOS, isMap, isNumber, isObject, isPlainObject, isPromise, isRegExp, isSVGElement, isSet, isString, isStringNumber, isSymbol, isUrl, objectToString, toRawType, toTypeString } from './is.mjs';
 export { WS, WSAutoReconnectOptions, WSHeartbeatOptions, WSOptions } from './ws.mjs';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { $toast, clearStorage, clone, confirm, copy, debounce, delay, getStorage, getType, getUtilsBuildTime, getVariable, isEmpty, log, merge, mockValue, processWidth, random, setStorage, test, throttle, toLine, tryCatch, validate, validateForm, validateTrigger } from './base.js';
+export { $toast, clearStorage, clone, confirm, copy, debounce, delay, getStorage, getType, getUtilsBuildTime, getVariable, isEmpty, log, merge, mockValue, processWidth, random, setStorage, test, throttle, toLine, tryCatch, validate, validateForm, validateOnSubmit } from './base.js';
 export { diffDate, diffDateFromCurrent, formatDate, formatDateToDay, formatDateToMinute } from './day.js';
 export { isArray, isBoolean, isComponent, isDate, isEmptyObject, isFunction, isIOS, isMap, isNumber, isObject, isPlainObject, isPromise, isRegExp, isSVGElement, isSet, isString, isStringNumber, isSymbol, isUrl, objectToString, toRawType, toTypeString } from './is.js';
 export { WS, WSAutoReconnectOptions, WSHeartbeatOptions, WSOptions } from './ws.js';

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { $ as $toast, c as clearStorage, a as clone, b as confirm, d as copy, e as debounce, f as delay, y as formatBytes, z as formatBytesConvert, A as formatDurationTime, B as formatImg, C as formatTextToHtml, D as formatThousands, E as formatTime, F as formatToFixed, g as getStorage, h as getType, i as getUtilsBuildTime, j as getVariable, k as isEmpty, l as log, m as merge, n as mockValue, p as processWidth, r as random, s as setStorage, t as test, o as throttle, q as toLine, u as tryCatch, v as validate, w as validateForm, x as validateTrigger } from './shared/utils.CzQQZf9j.mjs';
+export { $ as $toast, c as clearStorage, a as clone, b as confirm, d as copy, e as debounce, f as delay, y as formatBytes, z as formatBytesConvert, A as formatDurationTime, B as formatImg, C as formatTextToHtml, D as formatThousands, E as formatTime, F as formatToFixed, g as getStorage, h as getType, i as getUtilsBuildTime, j as getVariable, k as isEmpty, l as log, m as merge, n as mockValue, p as processWidth, r as random, s as setStorage, t as test, o as throttle, q as toLine, u as tryCatch, v as validate, w as validateForm, x as validateOnSubmit } from './shared/utils.CTnx12Vx.mjs';
 export { diffDate, diffDateFromCurrent, formatDate, formatDateToDay, formatDateToMinute } from './day.mjs';
 export { isArray, isBoolean, isComponent, isDate, isEmptyObject, isFunction, isIOS, isMap, isNumber, isObject, isPlainObject, isPromise, isRegExp, isSVGElement, isSet, isString, isStringNumber, isSymbol, isUrl, objectToString, toRawType, toTypeString } from './is.mjs';
 export { WS } from './ws.mjs';

package/dist/shared/{utils.CzQQZf9j.mjs → utils.CTnx12Vx.mjs}

@@ -529,15 +529,23 @@ function delay(delay2 = 0, fn) {
     }, delay2)
   );
 }
-function validateTrigger(type = "required", rules = {}, pureValid = false) {
-  let mergeRules = {
-    trigger: ["blur", "change"],
-    ...rules
-  };
-  return validate(type, mergeRules, pureValid);
+function validateOnSubmit(type = "required", rules = {}, pureValid = false) {
+  const normalized = normalizeValidateParams(type, rules, pureValid);
+  if (normalized.pureValid) {
+    return validate(normalized.type, normalized.rawRules, true);
+  }
+  return validate(
+    normalized.type,
+    {
+      ...normalized.rulesObject,
+      trigger: normalized.rulesObject.trigger ?? []
+    },
+    normalized.pureValid
+  );
 }
 var ValidateType = /* @__PURE__ */ ((ValidateType2) => {
   ValidateType2["REQUIRED"] = "required";
+  ValidateType2["CHANGE"] = "change";
   ValidateType2["PASSWORD"] = "password";
   ValidateType2["NUMBER"] = "number";
   ValidateType2["POSITIVE"] = "positive";
@@ -555,25 +563,31 @@ var ValidateType = /* @__PURE__ */ ((ValidateType2) => {
   return ValidateType2;
 })(ValidateType || {});
 function validate(type = "required", rules = {}, pureValid = false) {
-  const rulesObject = typeof rules === "object" && rules !== null ? rules : {};
-  let trigger = rulesObject.trigger || [];
+  const normalized = normalizeValidateParams(type, rules, pureValid);
+  const rulesObject = normalized.rulesObject;
+  const rawRules = normalized.rawRules;
+  const validType = normalized.type;
+  const isPureValid = normalized.pureValid;
+  const trigger = rulesObject.trigger ?? ["blur", "change"];
   const typeMaps = Object.values(ValidateType);
-  let parseRequired = rulesObject.required ?? true;
-  if (!typeMaps.includes(type)) {
+  const parseRequired = rulesObject.required ?? true;
+  const defaultRequiredMessage = validType === "change" /* CHANGE */ ? "\u8BF7\u9009\u62E9" : "\u8BF7\u8F93\u5165";
+  const getPureValue = () => Object.prototype.hasOwnProperty.call(rulesObject, "value") ? rulesObject.value : rawRules;
+  if (!typeMaps.includes(validType)) {
     return {
       required: parseRequired,
-      message: type,
+      message: validType,
       trigger
     };
   }
-  if (type === "required" /* REQUIRED */) {
+  if (validType === "required" /* REQUIRED */ || validType === "change" /* CHANGE */) {
     return {
       required: parseRequired,
-      message: rulesObject.message ?? "\u8BF7\u8F93\u5165",
+      message: rulesObject.message ?? defaultRequiredMessage,
       trigger
     };
   }
-  if (type === "password" /* PASSWORD */) {
+  if (validType === "password" /* PASSWORD */) {
     const validateName = (rule, value, callback) => {
       let validFlag = /^[a-zA-Z0-9_-]+$/.test(value);
       if (!validFlag) {
@@ -587,41 +601,46 @@ function validate(type = "required", rules = {}, pureValid = false) {
       trigger
     };
   }
-  if (type === "positive" /* POSITIVE */ || type === "number" /* NUMBER */) {
-    return _validValue(rules, "\u8BF7\u8F93\u5165\u6B63\u6574\u6570", pureValid, /^[1-9]+\d*$/);
+  if (validType === "positive" /* POSITIVE */ || validType === "number" /* NUMBER */) {
+    return _validValue(getPureValue(), "\u8BF7\u8F93\u5165\u6B63\u6574\u6570", isPureValid, /^[1-9]+\d*$/);
   }
-  if (type === "zeroPositive" /* ZERO_POSITIVE */) {
-    return _validValue(rules, "\u8BF7\u8F93\u5165\u975E\u8D1F\u6574\u6570", pureValid, /^(0|[1-9]+\d*)$/);
+  if (validType === "zeroPositive" /* ZERO_POSITIVE */) {
+    return _validValue(getPureValue(), "\u8BF7\u8F93\u5165\u975E\u8D1F\u6574\u6570", isPureValid, /^(0|[1-9]+\d*)$/);
   }
-  if (type === "integer" /* INTEGER */) {
-    return _validValue(rules, "\u8BF7\u8F93\u5165\u6574\u6570", pureValid, /^(0|[-]?[1-9]\d*)$/);
+  if (validType === "integer" /* INTEGER */) {
+    return _validValue(getPureValue(), "\u8BF7\u8F93\u5165\u6574\u6570", isPureValid, /^(0|[-]?[1-9]\d*)$/);
   }
-  if (type === "decimal" /* DECIMAL */) {
-    return _validValue(rules, "\u8BF7\u8F93\u5165\u975E\u8D1F\u6570\u5B57, \u5305\u542B\u5C0F\u6570\u4E14\u6700\u591A2\u4F4D", pureValid, /(0|[1-9]\d*)(\.\d{1, 2})?|0\.\d{1,2}/);
+  if (validType === "decimal" /* DECIMAL */) {
+    return _validValue(
+      getPureValue(),
+      "\u8BF7\u8F93\u5165\u975E\u8D1F\u6570\u5B57, \u5305\u542B\u5C0F\u6570\u4E14\u6700\u591A2\u4F4D",
+      isPureValid,
+      /(0|[1-9]\d*)(\.\d{1, 2})?|0\.\d{1,2}/
+    );
   }
-  if (type === "mobile" /* MOBILE */) {
-    return _validValue(rules, "\u8BF7\u8F93\u5165\u6B63\u786E\u7684\u624B\u673A\u53F7", pureValid, /^[1][0-9]{10}$/);
+  if (validType === "mobile" /* MOBILE */) {
+    return _validValue(getPureValue(), "\u8BF7\u8F93\u5165\u6B63\u786E\u7684\u624B\u673A\u53F7", isPureValid, /^[1][0-9]{10}$/);
   }
-  if (type === "email" /* EMAIL */) {
-    return _validValue(rules, "\u8BF7\u8F93\u5165\u6B63\u786E\u7684email", pureValid, /^[^\s@]+@[^\s@]+\.[^\s@]+$/);
+  if (validType === "email" /* EMAIL */) {
+    return _validValue(getPureValue(), "\u8BF7\u8F93\u5165\u6B63\u786E\u7684email", isPureValid, /^[^\s@]+@[^\s@]+\.[^\s@]+$/);
   }
-  if (type === "ip" /* IP */) {
+  if (validType === "ip" /* IP */) {
     return _validValue(
-      rules,
+      getPureValue(),
       "\u8BF7\u8F93\u5165\u6B63\u786E\u7684ip\u5730\u5740",
-      pureValid,
+      isPureValid,
       /^((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/
     );
   }
-  if (type === "port" /* PORT */) {
+  if (validType === "port" /* PORT */) {
     return _validValue(
-      rules,
+      getPureValue(),
       "\u8BF7\u8F93\u51651-65535\u7684\u7AEF\u53E3\u53F7",
-      pureValid,
+      isPureValid,
       /^([1-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-5][0-5][0-3][0-5])$/
     );
   }
-  if (type === "between" /* BETWEEN */) {
+  if (validType === "between" /* BETWEEN */) {
     let minValue = rulesObject.min ?? "";
     let maxValue = rulesObject.max ?? "";
     const validateBetween = (rule, value, callback) => {
@@ -643,7 +662,7 @@ function validate(type = "required", rules = {}, pureValid = false) {
       required: parseRequired
     };
   }
-  if (type === "length" /* LENGTH */) {
+  if (validType === "length" /* LENGTH */) {
     return {
       min: rulesObject.min,
       max: rulesObject.max,
@@ -652,7 +671,7 @@ function validate(type = "required", rules = {}, pureValid = false) {
       required: parseRequired
     };
   }
-  if (type === "same" /* SAME */) {
+  if (validType === "same" /* SAME */) {
     const validateSame = (rule, value, callback) => {
       let isSame = value === rulesObject.value;
       if (!isSame) {
@@ -671,33 +690,46 @@ function validate(type = "required", rules = {}, pureValid = false) {
     };
     return res;
   }
-  if (type === "custom" /* CUSTOM */) {
-    if (pureValid) {
-      return _validValue(rulesObject.value, rulesObject.message, pureValid, rulesObject.reg);
-    } else {
-      return _validValue(rulesObject, rulesObject.message, pureValid, rulesObject.reg);
-    }
+  if (validType === "custom" /* CUSTOM */) {
+    return _validValue(getPureValue(), rulesObject.message, isPureValid, rulesObject.reg);
   }
-  function _validValue(rules2, msg, pureValid2, reg) {
-    if (pureValid2 === true) {
-      return reg.test(rules2);
+  function _validValue(value, msg, pureValid2, reg) {
+    if (pureValid2) {
+      return reg.test(value);
     }
-    const validatePhone = (rule, value, callback) => {
-      let validFlag = reg.test(value);
+    const validatePhone = (rule, value2, callback) => {
+      let validFlag = reg.test(value2);
       if (!validFlag) {
-        callback(new Error(rules2.message ?? msg));
+        callback(new Error(rulesObject.message ?? msg));
       } else {
         callback();
       }
     };
     return {
       validator: validatePhone,
-      required: rules2.required ?? true,
+      required: rulesObject.required ?? true,
       trigger
     };
   }
   return {};
 }
+function normalizeValidateParams(type, rules, pureValid) {
+  if (typeof type === "object" && type !== null) {
+    const rulesObject = type;
+    return {
+      type: rulesObject.type || "required" /* REQUIRED */,
+      rulesObject,
+      rawRules: rulesObject,
+      pureValid: typeof rules === "boolean" ? rules : pureValid
+    };
+  }
+  return {
+    type,
+    rulesObject: typeof rules === "object" && rules !== null ? rules : {},
+    rawRules: rules,
+    pureValid
+  };
+}
 const copy = (text, toastParams = {}) => {
   const textarea = document.createElement("textarea");
   textarea.value = text;
@@ -782,23 +814,79 @@ function processWidth(initValue, isBase = false) {
   }
   return isBase ? res : { width: res };
 }
-function throttle(fn, delay2 = 1e3) {
-  let last = 0;
+const normalizeThrottleOptions = (options = {}) => {
+  const normalized = typeof options === "boolean" ? { leading: options } : options;
+  return {
+    leading: normalized.leading !== false,
+    trailing: normalized.trailing !== false
+  };
+};
+function throttle(fn, delay2 = 1e3, options = {}, resultCallback) {
+  const { leading, trailing } = normalizeThrottleOptions(options);
   let timer = void 0;
-  return function(...args) {
-    let context = this;
-    let now = +/* @__PURE__ */ new Date();
-    if (now - last < delay2) {
+  let previous;
+  let lastArgs;
+  let lastThis;
+  let result;
+  const cancel = () => {
+    if (timer) {
       clearTimeout(timer);
-      timer = setTimeout(function() {
-        last = now;
-        fn.apply(context, args);
-      }, delay2);
-    } else {
-      last = now;
-      fn.apply(context, args);
+      timer = void 0;
     }
+    previous = void 0;
+    lastArgs = void 0;
+    lastThis = void 0;
+  };
+  const invoke = () => {
+    if (!lastArgs) return result;
+    previous = Date.now();
+    const args = lastArgs;
+    const context = lastThis;
+    lastArgs = void 0;
+    lastThis = void 0;
+    result = fn.apply(context, args);
+    resultCallback?.(result);
+    return result;
+  };
+  const flush = () => {
+    if (timer) {
+      clearTimeout(timer);
+      timer = void 0;
+    }
+    return invoke();
+  };
+  const throttled = function(...args) {
+    const now = Date.now();
+    lastArgs = args;
+    lastThis = this;
+    if (previous === void 0) {
+      if (leading) {
+        return invoke();
+      }
+      previous = now;
+    }
+    const remaining = delay2 - (now - previous);
+    if (remaining <= 0 || remaining > delay2) {
+      if (timer) {
+        clearTimeout(timer);
+        timer = void 0;
+      }
+      return invoke();
+    }
+    if (!timer && trailing) {
+      timer = setTimeout(() => {
+        timer = void 0;
+        if (!leading) {
+          previous = void 0;
+        }
+        invoke();
+      }, remaining);
+    }
+    return result;
   };
+  throttled.cancel = cancel;
+  throttled.flush = flush;
+  return throttled;
 }
 async function tryCatch(task, sendLoading) {
   const updateLoading = (value) => {
@@ -946,11 +1034,11 @@ function getVariable(propertyName, fallback = "") {
 const DEFAULT_BUILD_TIME_FALLBACK = "\u672A\u6CE8\u5165";
 function getUtilsBuildTime(fallback = DEFAULT_BUILD_TIME_FALLBACK) {
   {
-    return "2026-07-01 13:13:26";
+    return "2026-07-02 16:09:23";
   }
 }
 function test() {
   return `build time: ${getUtilsBuildTime()}`;
 }
 
-export { $toast as $, formatDurationTime as A, formatImg as B, formatTextToHtml as C, formatThousands as D, formatTime as E, formatToFixed as F, clone as a, confirm as b, clearStorage as c, copy as d, debounce as e, delay as f, getStorage as g, getType as h, getUtilsBuildTime as i, getVariable as j, isEmpty as k, log as l, merge as m, mockValue as n, throttle as o, processWidth as p, toLine as q, random as r, setStorage as s, test as t, tryCatch as u, validate as v, validateForm as w, validateTrigger as x, formatBytes as y, formatBytesConvert as z };
+export { $toast as $, formatDurationTime as A, formatImg as B, formatTextToHtml as C, formatThousands as D, formatTime as E, formatToFixed as F, clone as a, confirm as b, clearStorage as c, copy as d, debounce as e, delay as f, getStorage as g, getType as h, getUtilsBuildTime as i, getVariable as j, isEmpty as k, log as l, merge as m, mockValue as n, throttle as o, processWidth as p, toLine as q, random as r, setStorage as s, test as t, tryCatch as u, validate as v, validateForm as w, validateOnSubmit as x, formatBytes as y, formatBytesConvert as z };

package/dist/shared/{utils.BaNHAtTs.cjs → utils.DUIw9c4e.cjs}

@@ -190,7 +190,7 @@ function formatImg(photoName, addPath = "", { basePath = "assets/images" } = {})
   const addLastSlash = addPath.endsWith("/") || !addPath ? addPath : `${addPath}/`;
   const addLastBasePathSlash = basePath.endsWith("/") || !basePath ? basePath : `${basePath}/`;
   const mergeSrc = `${addLastSlash}${photoName}`;
-  return new URL(`../${addLastBasePathSlash}${mergeSrc}`, (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('shared/utils.BaNHAtTs.cjs', document.baseURI).href))).href;
+  return new URL(`../${addLastBasePathSlash}${mergeSrc}`, (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('shared/utils.DUIw9c4e.cjs', document.baseURI).href))).href;
 }
 function formatToFixed(value, options) {
   if (typeof options === "number") {
@@ -532,15 +532,23 @@ function delay(delay2 = 0, fn) {
     }, delay2)
   );
 }
-function validateTrigger(type = "required", rules = {}, pureValid = false) {
-  let mergeRules = {
-    trigger: ["blur", "change"],
-    ...rules
-  };
-  return validate(type, mergeRules, pureValid);
+function validateOnSubmit(type = "required", rules = {}, pureValid = false) {
+  const normalized = normalizeValidateParams(type, rules, pureValid);
+  if (normalized.pureValid) {
+    return validate(normalized.type, normalized.rawRules, true);
+  }
+  return validate(
+    normalized.type,
+    {
+      ...normalized.rulesObject,
+      trigger: normalized.rulesObject.trigger ?? []
+    },
+    normalized.pureValid
+  );
 }
 var ValidateType = /* @__PURE__ */ ((ValidateType2) => {
   ValidateType2["REQUIRED"] = "required";
+  ValidateType2["CHANGE"] = "change";
   ValidateType2["PASSWORD"] = "password";
   ValidateType2["NUMBER"] = "number";
   ValidateType2["POSITIVE"] = "positive";
@@ -558,25 +566,31 @@ var ValidateType = /* @__PURE__ */ ((ValidateType2) => {
   return ValidateType2;
 })(ValidateType || {});
 function validate(type = "required", rules = {}, pureValid = false) {
-  const rulesObject = typeof rules === "object" && rules !== null ? rules : {};
-  let trigger = rulesObject.trigger || [];
+  const normalized = normalizeValidateParams(type, rules, pureValid);
+  const rulesObject = normalized.rulesObject;
+  const rawRules = normalized.rawRules;
+  const validType = normalized.type;
+  const isPureValid = normalized.pureValid;
+  const trigger = rulesObject.trigger ?? ["blur", "change"];
   const typeMaps = Object.values(ValidateType);
-  let parseRequired = rulesObject.required ?? true;
-  if (!typeMaps.includes(type)) {
+  const parseRequired = rulesObject.required ?? true;
+  const defaultRequiredMessage = validType === "change" /* CHANGE */ ? "\u8BF7\u9009\u62E9" : "\u8BF7\u8F93\u5165";
+  const getPureValue = () => Object.prototype.hasOwnProperty.call(rulesObject, "value") ? rulesObject.value : rawRules;
+  if (!typeMaps.includes(validType)) {
     return {
       required: parseRequired,
-      message: type,
+      message: validType,
       trigger
     };
   }
-  if (type === "required" /* REQUIRED */) {
+  if (validType === "required" /* REQUIRED */ || validType === "change" /* CHANGE */) {
     return {
       required: parseRequired,
-      message: rulesObject.message ?? "\u8BF7\u8F93\u5165",
+      message: rulesObject.message ?? defaultRequiredMessage,
       trigger
     };
   }
-  if (type === "password" /* PASSWORD */) {
+  if (validType === "password" /* PASSWORD */) {
     const validateName = (rule, value, callback) => {
       let validFlag = /^[a-zA-Z0-9_-]+$/.test(value);
       if (!validFlag) {
@@ -590,41 +604,46 @@ function validate(type = "required", rules = {}, pureValid = false) {
       trigger
     };
   }
-  if (type === "positive" /* POSITIVE */ || type === "number" /* NUMBER */) {
-    return _validValue(rules, "\u8BF7\u8F93\u5165\u6B63\u6574\u6570", pureValid, /^[1-9]+\d*$/);
+  if (validType === "positive" /* POSITIVE */ || validType === "number" /* NUMBER */) {
+    return _validValue(getPureValue(), "\u8BF7\u8F93\u5165\u6B63\u6574\u6570", isPureValid, /^[1-9]+\d*$/);
   }
-  if (type === "zeroPositive" /* ZERO_POSITIVE */) {
-    return _validValue(rules, "\u8BF7\u8F93\u5165\u975E\u8D1F\u6574\u6570", pureValid, /^(0|[1-9]+\d*)$/);
+  if (validType === "zeroPositive" /* ZERO_POSITIVE */) {
+    return _validValue(getPureValue(), "\u8BF7\u8F93\u5165\u975E\u8D1F\u6574\u6570", isPureValid, /^(0|[1-9]+\d*)$/);
   }
-  if (type === "integer" /* INTEGER */) {
-    return _validValue(rules, "\u8BF7\u8F93\u5165\u6574\u6570", pureValid, /^(0|[-]?[1-9]\d*)$/);
+  if (validType === "integer" /* INTEGER */) {
+    return _validValue(getPureValue(), "\u8BF7\u8F93\u5165\u6574\u6570", isPureValid, /^(0|[-]?[1-9]\d*)$/);
   }
-  if (type === "decimal" /* DECIMAL */) {
-    return _validValue(rules, "\u8BF7\u8F93\u5165\u975E\u8D1F\u6570\u5B57, \u5305\u542B\u5C0F\u6570\u4E14\u6700\u591A2\u4F4D", pureValid, /(0|[1-9]\d*)(\.\d{1, 2})?|0\.\d{1,2}/);
+  if (validType === "decimal" /* DECIMAL */) {
+    return _validValue(
+      getPureValue(),
+      "\u8BF7\u8F93\u5165\u975E\u8D1F\u6570\u5B57, \u5305\u542B\u5C0F\u6570\u4E14\u6700\u591A2\u4F4D",
+      isPureValid,
+      /(0|[1-9]\d*)(\.\d{1, 2})?|0\.\d{1,2}/
+    );
   }
-  if (type === "mobile" /* MOBILE */) {
-    return _validValue(rules, "\u8BF7\u8F93\u5165\u6B63\u786E\u7684\u624B\u673A\u53F7", pureValid, /^[1][0-9]{10}$/);
+  if (validType === "mobile" /* MOBILE */) {
+    return _validValue(getPureValue(), "\u8BF7\u8F93\u5165\u6B63\u786E\u7684\u624B\u673A\u53F7", isPureValid, /^[1][0-9]{10}$/);
   }
-  if (type === "email" /* EMAIL */) {
-    return _validValue(rules, "\u8BF7\u8F93\u5165\u6B63\u786E\u7684email", pureValid, /^[^\s@]+@[^\s@]+\.[^\s@]+$/);
+  if (validType === "email" /* EMAIL */) {
+    return _validValue(getPureValue(), "\u8BF7\u8F93\u5165\u6B63\u786E\u7684email", isPureValid, /^[^\s@]+@[^\s@]+\.[^\s@]+$/);
   }
-  if (type === "ip" /* IP */) {
+  if (validType === "ip" /* IP */) {
     return _validValue(
-      rules,
+      getPureValue(),
       "\u8BF7\u8F93\u5165\u6B63\u786E\u7684ip\u5730\u5740",
-      pureValid,
+      isPureValid,
       /^((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/
     );
   }
-  if (type === "port" /* PORT */) {
+  if (validType === "port" /* PORT */) {
     return _validValue(
-      rules,
+      getPureValue(),
       "\u8BF7\u8F93\u51651-65535\u7684\u7AEF\u53E3\u53F7",
-      pureValid,
+      isPureValid,
       /^([1-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-5][0-5][0-3][0-5])$/
     );
   }
-  if (type === "between" /* BETWEEN */) {
+  if (validType === "between" /* BETWEEN */) {
     let minValue = rulesObject.min ?? "";
     let maxValue = rulesObject.max ?? "";
     const validateBetween = (rule, value, callback) => {
@@ -646,7 +665,7 @@ function validate(type = "required", rules = {}, pureValid = false) {
       required: parseRequired
     };
   }
-  if (type === "length" /* LENGTH */) {
+  if (validType === "length" /* LENGTH */) {
     return {
       min: rulesObject.min,
       max: rulesObject.max,
@@ -655,7 +674,7 @@ function validate(type = "required", rules = {}, pureValid = false) {
       required: parseRequired
     };
   }
-  if (type === "same" /* SAME */) {
+  if (validType === "same" /* SAME */) {
     const validateSame = (rule, value, callback) => {
       let isSame = value === rulesObject.value;
       if (!isSame) {
@@ -674,33 +693,46 @@ function validate(type = "required", rules = {}, pureValid = false) {
     };
     return res;
   }
-  if (type === "custom" /* CUSTOM */) {
-    if (pureValid) {
-      return _validValue(rulesObject.value, rulesObject.message, pureValid, rulesObject.reg);
-    } else {
-      return _validValue(rulesObject, rulesObject.message, pureValid, rulesObject.reg);
-    }
+  if (validType === "custom" /* CUSTOM */) {
+    return _validValue(getPureValue(), rulesObject.message, isPureValid, rulesObject.reg);
   }
-  function _validValue(rules2, msg, pureValid2, reg) {
-    if (pureValid2 === true) {
-      return reg.test(rules2);
+  function _validValue(value, msg, pureValid2, reg) {
+    if (pureValid2) {
+      return reg.test(value);
     }
-    const validatePhone = (rule, value, callback) => {
-      let validFlag = reg.test(value);
+    const validatePhone = (rule, value2, callback) => {
+      let validFlag = reg.test(value2);
       if (!validFlag) {
-        callback(new Error(rules2.message ?? msg));
+        callback(new Error(rulesObject.message ?? msg));
       } else {
         callback();
       }
     };
     return {
       validator: validatePhone,
-      required: rules2.required ?? true,
+      required: rulesObject.required ?? true,
       trigger
     };
   }
   return {};
 }
+function normalizeValidateParams(type, rules, pureValid) {
+  if (typeof type === "object" && type !== null) {
+    const rulesObject = type;
+    return {
+      type: rulesObject.type || "required" /* REQUIRED */,
+      rulesObject,
+      rawRules: rulesObject,
+      pureValid: typeof rules === "boolean" ? rules : pureValid
+    };
+  }
+  return {
+    type,
+    rulesObject: typeof rules === "object" && rules !== null ? rules : {},
+    rawRules: rules,
+    pureValid
+  };
+}
 const copy = (text, toastParams = {}) => {
   const textarea = document.createElement("textarea");
   textarea.value = text;
@@ -785,23 +817,79 @@ function processWidth(initValue, isBase = false) {
   }
   return isBase ? res : { width: res };
 }
-function throttle(fn, delay2 = 1e3) {
-  let last = 0;
+const normalizeThrottleOptions = (options = {}) => {
+  const normalized = typeof options === "boolean" ? { leading: options } : options;
+  return {
+    leading: normalized.leading !== false,
+    trailing: normalized.trailing !== false
+  };
+};
+function throttle(fn, delay2 = 1e3, options = {}, resultCallback) {
+  const { leading, trailing } = normalizeThrottleOptions(options);
   let timer = void 0;
-  return function(...args) {
-    let context = this;
-    let now = +/* @__PURE__ */ new Date();
-    if (now - last < delay2) {
+  let previous;
+  let lastArgs;
+  let lastThis;
+  let result;
+  const cancel = () => {
+    if (timer) {
       clearTimeout(timer);
-      timer = setTimeout(function() {
-        last = now;
-        fn.apply(context, args);
-      }, delay2);
-    } else {
-      last = now;
-      fn.apply(context, args);
+      timer = void 0;
     }
+    previous = void 0;
+    lastArgs = void 0;
+    lastThis = void 0;
+  };
+  const invoke = () => {
+    if (!lastArgs) return result;
+    previous = Date.now();
+    const args = lastArgs;
+    const context = lastThis;
+    lastArgs = void 0;
+    lastThis = void 0;
+    result = fn.apply(context, args);
+    resultCallback?.(result);
+    return result;
+  };
+  const flush = () => {
+    if (timer) {
+      clearTimeout(timer);
+      timer = void 0;
+    }
+    return invoke();
+  };
+  const throttled = function(...args) {
+    const now = Date.now();
+    lastArgs = args;
+    lastThis = this;
+    if (previous === void 0) {
+      if (leading) {
+        return invoke();
+      }
+      previous = now;
+    }
+    const remaining = delay2 - (now - previous);
+    if (remaining <= 0 || remaining > delay2) {
+      if (timer) {
+        clearTimeout(timer);
+        timer = void 0;
+      }
+      return invoke();
+    }
+    if (!timer && trailing) {
+      timer = setTimeout(() => {
+        timer = void 0;
+        if (!leading) {
+          previous = void 0;
+        }
+        invoke();
+      }, remaining);
+    }
+    return result;
   };
+  throttled.cancel = cancel;
+  throttled.flush = flush;
+  return throttled;
 }
 async function tryCatch(task, sendLoading) {
   const updateLoading = (value) => {
@@ -949,7 +1037,7 @@ function getVariable(propertyName, fallback = "") {
 const DEFAULT_BUILD_TIME_FALLBACK = "\u672A\u6CE8\u5165";
 function getUtilsBuildTime(fallback = DEFAULT_BUILD_TIME_FALLBACK) {
   {
-    return "2026-07-01 13:13:26";
+    return "2026-07-02 16:09:23";
   }
 }
 function test() {
@@ -988,4 +1076,4 @@ exports.toLine = toLine;
 exports.tryCatch = tryCatch;
 exports.validate = validate;
 exports.validateForm = validateForm;
-exports.validateTrigger = validateTrigger;
+exports.validateOnSubmit = validateOnSubmit;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sybz-components/utils",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "description": "utils of sybz-components",
   "license": "MIT",
   "type": "commonjs",