@oeos-components/utils 0.0.21 → 0.0.22

package/dist/base.d.cts

@@ -0,0 +1,342 @@
+import * as element_plus from 'element-plus';
+import { MessageOptions } from 'element-plus';
+import { VNode } from 'vue';
+import { Ref } from '@vue/reactivity';
+
+type Func = (...args: any[]) => any;
+/**
+ * 现有方法如下
+ * $toast(message, type: string | object = 'success', otherParams: object = {})
+ * setStorage(storageName: string, params: any, isSession = false)
+ * getStorage(data, isSession = false)
+ * clearStorage(str: string | [] | object = '')
+ * validForm(ref, { message = '表单校验错误, 请检查', detail = false, showMessage = true } = {})
+ * isEmpty(data: any): boolean
+ * notEmpty(v: any): boolean
+ * merge(obj1: object, obj2: object): object
+ * clone(data, times = 1)
+ * uuid(type = '',length = 4,{ emailStr = '@qq.com', timeStr = '{m}-{d} {h}:{i}:{s}', startStr = '', optionsIndex = null } = {},)
+ * getType(type)
+ * sleep(delay = 0, fn?: () => void)
+ * validate(type = 'required', rules = {}, pureValid = false)
+ * asyncWrapper(func, ...args)
+ * copy = (text, toastParams = {})
+ * log(variableStr, variable, otherInfo = '')
+ * random(min = 0, max = 10)
+ * toLine(text, connect = '-')
+ * processWidth(initValue, isBase = false)
+ * throttle(fn, delay = 1000)
+ * debounce(fn, delay = 1000)
+ * confirm(message, options)
+ * getVariable('--green')
+ */
+/**
+ * @example1
+  proxy.$toast('保存成功') // s:success; i: info; w: warning; e: error;
+  proxy.$toast('保存失败', 'e')
+  proxy.$toast('永不关闭', {duration: 0})
+  proxy.$toast({
+    message: 'andy',
+    type: 'warning',
+    duration: 300,
+    closeAll: true,
+  })
+* $toast.success('This is a success message')
+* @example2 显示对象
+* $toast({
+    dangerouslyUseHTMLString: true,
+    message: `<h6>复制成功</h6><pre>${JSON.stringify(obj, null, 2)}</pre>`,
+    type: 'success',
+    duration: 5000,
+  })
+*/
+type MessageType = 'success' | 'info' | 'error' | 'warning';
+type ShortType = 's' | 'i' | 'e' | 'w';
+type ToastType = MessageType | ShortType;
+type ToastOptions = Partial<MessageOptions> & {
+    closeAll?: boolean;
+};
+declare function $toast(message: string | ToastOptions | VNode | (() => VNode), type?: ToastType | ToastOptions, otherParams?: ToastOptions): void;
+declare namespace $toast {
+    var success: (message: any, otherParams?: {}) => void;
+    var info: (message: any, otherParams?: {}) => void;
+    var error: (message: any, otherParams?: {}) => void;
+    var warning: (message: any, otherParams?: {}) => void;
+}
+declare function setStorage(storageName: string, params: any, isSession?: boolean): void;
+declare function getStorage(data: any, isSession?: boolean): string | null;
+/**
+ *
+ * @param {*} str 需要清空的localStorage或sessionStorage, 如果不传清空所有
+ * @param {*} param1 需要排除的sessionStorage或者localStorage
+ * @example
+ * clearStorage()
+ * clearStorage('loginId')
+ * clearStorage(['loginId', 'token'])
+ * clearStorage({ exclude: ['loginId', 'token'] })
+ */
+declare function clearStorage(str?: string | [] | object): void;
+/**
+ * element-plus的form表单使用promise进行封装
+ * @param ref
+ * @param param1
+ * @returns Promise
+ * await proxy.validForm(formRef);
+ * await proxy.validForm(formRef, {message: '自定义错误'});
+ * await proxy.validForm(formRef, {showMessage: false});
+ * await proxy.validForm(formRef, {detail: true});
+ */
+declare function validForm(ref: any, { message, detail, showMessage }?: {
+    message?: string | undefined;
+    detail?: boolean | undefined;
+    showMessage?: boolean | undefined;
+}): Promise<unknown>;
+/**
+ * 判断变量是否空值
+ * undefined, null, '', '   ', false, 0, [], {}, NaN, new Set(), new Map(), BigInt(0), new Date('无效日期') 均返回true，否则返回false
+ */
+declare function isEmpty(data: any, strict?: boolean): boolean;
+declare function notEmpty(v: any): boolean;
+/**
+ *  将两个对象合并, 以第二个对象为准, 如果两个对象, 一个属性有值, 一个没值, 合并后有值; 如果两个属性都有值, 以第二个属性为准
+ *  */
+declare function merge(obj1: object, obj2: object): object;
+/**
+ * 克隆数据并根据需要复制数组
+ * @param {any} data - 要克隆的数据
+ * @param {number} [times=1] - 如果是数组，要复制的次数
+ * @returns {any} - 克隆后的数据或复制后的数组
+ * clone(123) => 123
+ * clone([1,2, {name: 'andy'}], 2) => [1, 2, {name: 'andy'}, 1, 2, {name: 'andy'}]
+ */
+declare function clone(data: any, times?: number): any;
+/**
+ * 生成 UUID
+ * @param type - 生成 UUID 的类型，可以是 'phone', 'email', 'time', 'number', 'ip', 'port' 或空字符串
+ * @param length - 生成字符串的长度（默认为4）
+ * @param options - 额外的选项
+ * @param options.emailStr - 生成 email 时使用的后缀（默认为 '@qq.com'）
+ * @param options.timeStr - 生成时间字符串的格式（默认为 '{y}-{m}-{d} {h}:{i}:{s}'）
+ * @param options.startStr - 起始字符串（默认为空）
+ * @param options.optionsIndex - 数组索引（默认为随机）
+ * @returns 生成的 UUID (字符串或数字)
+ * * uuid("名字") => 名字hc8f
+ * uuid() => abcd
+ * uuid('time') => 25MR 10-27 17:34:01
+ * uuid('time', 0, {startStr:'andy', timeStr:"{h}:{i}:{s}"}) => andy 17:38:23
+ * uuid('phone') => 13603312460
+ * uuid('email') => cBZA@qq.com
+ * uuid('number') => 2319
+ * uuid([ { label: "小泽泽", value: "xzz" },{ label: "小月月", value: "xyy" }]) => xzz
+ */
+declare function uuid(type?: string | Array<{
+    label: string;
+    value: any;
+}>, length?: number, options?: {
+    emailStr?: string;
+    timeStr?: string;
+    startStr?: string;
+    optionsIndex?: number | null;
+}): string | number;
+/**
+ * 判断传入参数的类型
+ * @param {*} type
+ * getType(new RegExp()) regexp
+ * getType(new Date()) date
+ * getType([]) array
+ * getType({}) object
+ * getType(null) null
+ * getType(123) number
+ */
+declare function getType(type: any): string;
+/**
+ * 一个辅助函数，用于在代码中创建一个暂停（延迟）。
+ * 它返回一个 Promise，你可以在 `await` 后使用它来实现类似 "sleep" 的效果。
+ *
+ * @param delay - 等待的毫秒数。默认值为 0，表示不延迟。
+ * @param fn - (可选) 一个在延迟结束后立即执行的函数。
+ *
+ * @returns 一个 Promise，当延迟结束后解析（resolve）。
+ *
+ * @example
+ * // 基本用法：延迟 2 秒后打印消息
+ * console.log('开始');
+ * await sleep(2000);
+ * console.log('2秒后执行');
+ *
+ * @example
+ * // 带回调函数的用法：延迟 1 秒后执行清理工作
+ * sleep(1000, () => {
+ *   console.log('执行清理操作...');
+ *   // 清理代码...
+ * });
+ *
+ * @example
+ * // 在循环中使用：每次迭代后延迟 500 毫秒
+ * for (let i = 0; i < 5; i++) {
+ *   console.log(`当前值: ${i}`);
+ *   await sleep(500);
+ * }
+ */
+declare function sleep(delay?: number, fn?: () => void): Promise<void>;
+declare function validateTrigger(type?: string, rules?: {}, pureValid?: boolean): boolean | {
+    validator: (rule: any, value: any, callback: (error?: Error | undefined) => void) => void;
+    required: any;
+    trigger: any;
+} | {
+    required: any;
+    message: any;
+    trigger: any;
+    validator?: undefined;
+    min?: undefined;
+    max?: undefined;
+} | {
+    validator: (rule: any, value: any, callback: (error?: Error | undefined) => void) => void;
+    trigger: any;
+    required?: undefined;
+    message?: undefined;
+    min?: undefined;
+    max?: undefined;
+} | {
+    min: any;
+    max: any;
+    message: any;
+    trigger: any;
+    required: any;
+    validator?: undefined;
+} | undefined;
+declare function validate(type?: string, rules?: Record<string, any>, pureValid?: boolean): boolean | {
+    validator: (rule: any, value: any, callback: (error?: Error) => void) => void;
+    required: any;
+    trigger: any;
+} | {
+    required: any;
+    message: any;
+    trigger: any;
+    validator?: undefined;
+    min?: undefined;
+    max?: undefined;
+} | {
+    validator: (rule: any, value: any, callback: (error?: Error) => void) => void;
+    trigger: any;
+    required?: undefined;
+    message?: undefined;
+    min?: undefined;
+    max?: undefined;
+} | {
+    min: any;
+    max: any;
+    message: any;
+    trigger: any;
+    required: any;
+    validator?: undefined;
+} | undefined;
+/**
+ *
+const { res, err } = await proxy.asyncWrapper(listTests, pickForm);
+if (err) {
+    return;
+}
+ */
+declare function asyncWrapper(func: any, ...args: any[]): Promise<{
+    res: any;
+    err?: undefined;
+} | {
+    err: unknown;
+    res?: undefined;
+}>;
+type ToastParams = {
+    hideToast?: boolean;
+} | (Omit<ToastOptions, 'hideToast'> & {
+    hideToast: boolean;
+});
+/**
+ * 复制文本
+ *
+ * copy('这是要复制的文本');
+ *
+ * copy('这是要复制的文本', {duration: 500});
+ *
+ * copy('这是要复制的文本', {hideToast: true});
+ *
+ *  */
+declare const copy: (text: any, toastParams?: ToastParams) => boolean;
+declare function log(variableStr: any, variable: any, otherInfo?: string): void;
+/**
+ * 生成指定范围内的随机整数
+ *
+ * @param min 最小值，默认为0
+ * @param max 最大值，默认为10
+ * @returns 返回生成的随机整数
+ */
+declare function random(min?: number, max?: number): number;
+/**
+ * 将文本转换为带有连接符的行文本
+ *
+ * @param text 要转换的文本
+ * @param connect 连接符，默认为'-'
+ * @returns 返回转换后的行文本
+ * toLine('NameAndy') // name-andy
+ * toLine('nameAndy') // name-andy
+ * toLine('_nameAndy') // _name-andy
+ */
+declare function toLine(text: any, connect?: string): any;
+declare function processWidth(initValue: any, isBase?: boolean): any;
+declare function throttle(fn: any, delay?: number): () => void;
+/**
+ * 封装 Promise 执行，提供自动 loading 状态管理
+ * @param promise 需要执行的 Promise
+ * @param sendLoading 可选的 loading 状态(支持 Ref<boolean> 或 boolean)
+ * @returns Promise<{ data: T | null; error: any }>
+ * @example1
+ * const loading = ref(false);
+ * const { data, error } = await tryCatch(fetchUserData(), loading);
+ * @example2 // 无视 loading 状态
+ * const { data, error } = await tryCatch(fetchUserData());
+ */
+declare function tryCatch<T>(promise: Promise<T>, sendLoading?: Ref<boolean> | null): Promise<{
+    data: T | null;
+    error: any;
+}>;
+/**
+ * 防抖函数
+ * @param { Function } func 函数
+ * @param { Number } delay 防抖时间
+ * @param { Boolean } immediate 是否立即执行
+ * @param { Function } resultCallback
+ */
+declare function debounce(func: Func, delay?: number, immediate?: boolean, resultCallback?: Func): {
+    (this: unknown, ...args: any[]): Promise<unknown>;
+    cancel(): void;
+};
+/**
+ * proxy.confirm('确定删除吗?')
+ * proxy.confirm('哈哈', { icon: 'el-icon-plus' })
+ * close-on-click-modal: 是否可通过点击遮罩层关闭 MessageBox 默认true
+ * lock-scroll: 是否在 MessageBox 出现时将 body 滚动锁定. 默认true
+ * 设置宽度, 内容使用组件
+   import GWarning from '@/autoComponents/gWarning.vue'
+    await proxy.confirm('', {
+      dangerouslyUseHTMLString: true,
+      customStyle: {
+        maxWidth: '600px',
+      },
+      message: h(GWarning, {
+        content:
+          '对于光存储开启保持原始对象名称后，对象将作为独立文件在光存储介质直接存储。<br>注意：当桶内文件大小普遍较小（<100MB）或过大（>5GB）时不推荐打开此功能！您确定开启此功能吗?',
+      }),
+      showCancelButton: true,
+      cancelButtonText: '取消',
+      appendTo: '#highSettingsForm',
+    })
+ * 如果是多个dialog嵌套, 可以给上层的dom设置个id如highSettingsForm, 然后appendTo: '#highSettingsForm'
+ */
+declare function confirm(message: any, options: any): Promise<element_plus.MessageBoxData>;
+/** Function to get a CSS custom property value
+ *
+ * getVariable('--blue');
+ *  */
+declare function getVariable(propertyName: any): string;
+declare function test(): string;
+
+export { $toast, asyncWrapper, clearStorage, clone, confirm, copy, debounce, getStorage, getType, getVariable, isEmpty, log, merge, notEmpty, processWidth, random, setStorage, sleep, test, throttle, toLine, tryCatch, uuid, validForm, validate, validateTrigger };

package/dist/base.d.mts

@@ -0,0 +1,342 @@
+import * as element_plus from 'element-plus';
+import { MessageOptions } from 'element-plus';
+import { VNode } from 'vue';
+import { Ref } from '@vue/reactivity';
+
+type Func = (...args: any[]) => any;
+/**
+ * 现有方法如下
+ * $toast(message, type: string | object = 'success', otherParams: object = {})
+ * setStorage(storageName: string, params: any, isSession = false)
+ * getStorage(data, isSession = false)
+ * clearStorage(str: string | [] | object = '')
+ * validForm(ref, { message = '表单校验错误, 请检查', detail = false, showMessage = true } = {})
+ * isEmpty(data: any): boolean
+ * notEmpty(v: any): boolean
+ * merge(obj1: object, obj2: object): object
+ * clone(data, times = 1)
+ * uuid(type = '',length = 4,{ emailStr = '@qq.com', timeStr = '{m}-{d} {h}:{i}:{s}', startStr = '', optionsIndex = null } = {},)
+ * getType(type)
+ * sleep(delay = 0, fn?: () => void)
+ * validate(type = 'required', rules = {}, pureValid = false)
+ * asyncWrapper(func, ...args)
+ * copy = (text, toastParams = {})
+ * log(variableStr, variable, otherInfo = '')
+ * random(min = 0, max = 10)
+ * toLine(text, connect = '-')
+ * processWidth(initValue, isBase = false)
+ * throttle(fn, delay = 1000)
+ * debounce(fn, delay = 1000)
+ * confirm(message, options)
+ * getVariable('--green')
+ */
+/**
+ * @example1
+  proxy.$toast('保存成功') // s:success; i: info; w: warning; e: error;
+  proxy.$toast('保存失败', 'e')
+  proxy.$toast('永不关闭', {duration: 0})
+  proxy.$toast({
+    message: 'andy',
+    type: 'warning',
+    duration: 300,
+    closeAll: true,
+  })
+* $toast.success('This is a success message')
+* @example2 显示对象
+* $toast({
+    dangerouslyUseHTMLString: true,
+    message: `<h6>复制成功</h6><pre>${JSON.stringify(obj, null, 2)}</pre>`,
+    type: 'success',
+    duration: 5000,
+  })
+*/
+type MessageType = 'success' | 'info' | 'error' | 'warning';
+type ShortType = 's' | 'i' | 'e' | 'w';
+type ToastType = MessageType | ShortType;
+type ToastOptions = Partial<MessageOptions> & {
+    closeAll?: boolean;
+};
+declare function $toast(message: string | ToastOptions | VNode | (() => VNode), type?: ToastType | ToastOptions, otherParams?: ToastOptions): void;
+declare namespace $toast {
+    var success: (message: any, otherParams?: {}) => void;
+    var info: (message: any, otherParams?: {}) => void;
+    var error: (message: any, otherParams?: {}) => void;
+    var warning: (message: any, otherParams?: {}) => void;
+}
+declare function setStorage(storageName: string, params: any, isSession?: boolean): void;
+declare function getStorage(data: any, isSession?: boolean): string | null;
+/**
+ *
+ * @param {*} str 需要清空的localStorage或sessionStorage, 如果不传清空所有
+ * @param {*} param1 需要排除的sessionStorage或者localStorage
+ * @example
+ * clearStorage()
+ * clearStorage('loginId')
+ * clearStorage(['loginId', 'token'])
+ * clearStorage({ exclude: ['loginId', 'token'] })
+ */
+declare function clearStorage(str?: string | [] | object): void;
+/**
+ * element-plus的form表单使用promise进行封装
+ * @param ref
+ * @param param1
+ * @returns Promise
+ * await proxy.validForm(formRef);
+ * await proxy.validForm(formRef, {message: '自定义错误'});
+ * await proxy.validForm(formRef, {showMessage: false});
+ * await proxy.validForm(formRef, {detail: true});
+ */
+declare function validForm(ref: any, { message, detail, showMessage }?: {
+    message?: string | undefined;
+    detail?: boolean | undefined;
+    showMessage?: boolean | undefined;
+}): Promise<unknown>;
+/**
+ * 判断变量是否空值
+ * undefined, null, '', '   ', false, 0, [], {}, NaN, new Set(), new Map(), BigInt(0), new Date('无效日期') 均返回true，否则返回false
+ */
+declare function isEmpty(data: any, strict?: boolean): boolean;
+declare function notEmpty(v: any): boolean;
+/**
+ *  将两个对象合并, 以第二个对象为准, 如果两个对象, 一个属性有值, 一个没值, 合并后有值; 如果两个属性都有值, 以第二个属性为准
+ *  */
+declare function merge(obj1: object, obj2: object): object;
+/**
+ * 克隆数据并根据需要复制数组
+ * @param {any} data - 要克隆的数据
+ * @param {number} [times=1] - 如果是数组，要复制的次数
+ * @returns {any} - 克隆后的数据或复制后的数组
+ * clone(123) => 123
+ * clone([1,2, {name: 'andy'}], 2) => [1, 2, {name: 'andy'}, 1, 2, {name: 'andy'}]
+ */
+declare function clone(data: any, times?: number): any;
+/**
+ * 生成 UUID
+ * @param type - 生成 UUID 的类型，可以是 'phone', 'email', 'time', 'number', 'ip', 'port' 或空字符串
+ * @param length - 生成字符串的长度（默认为4）
+ * @param options - 额外的选项
+ * @param options.emailStr - 生成 email 时使用的后缀（默认为 '@qq.com'）
+ * @param options.timeStr - 生成时间字符串的格式（默认为 '{y}-{m}-{d} {h}:{i}:{s}'）
+ * @param options.startStr - 起始字符串（默认为空）
+ * @param options.optionsIndex - 数组索引（默认为随机）
+ * @returns 生成的 UUID (字符串或数字)
+ * * uuid("名字") => 名字hc8f
+ * uuid() => abcd
+ * uuid('time') => 25MR 10-27 17:34:01
+ * uuid('time', 0, {startStr:'andy', timeStr:"{h}:{i}:{s}"}) => andy 17:38:23
+ * uuid('phone') => 13603312460
+ * uuid('email') => cBZA@qq.com
+ * uuid('number') => 2319
+ * uuid([ { label: "小泽泽", value: "xzz" },{ label: "小月月", value: "xyy" }]) => xzz
+ */
+declare function uuid(type?: string | Array<{
+    label: string;
+    value: any;
+}>, length?: number, options?: {
+    emailStr?: string;
+    timeStr?: string;
+    startStr?: string;
+    optionsIndex?: number | null;
+}): string | number;
+/**
+ * 判断传入参数的类型
+ * @param {*} type
+ * getType(new RegExp()) regexp
+ * getType(new Date()) date
+ * getType([]) array
+ * getType({}) object
+ * getType(null) null
+ * getType(123) number
+ */
+declare function getType(type: any): string;
+/**
+ * 一个辅助函数，用于在代码中创建一个暂停（延迟）。
+ * 它返回一个 Promise，你可以在 `await` 后使用它来实现类似 "sleep" 的效果。
+ *
+ * @param delay - 等待的毫秒数。默认值为 0，表示不延迟。
+ * @param fn - (可选) 一个在延迟结束后立即执行的函数。
+ *
+ * @returns 一个 Promise，当延迟结束后解析（resolve）。
+ *
+ * @example
+ * // 基本用法：延迟 2 秒后打印消息
+ * console.log('开始');
+ * await sleep(2000);
+ * console.log('2秒后执行');
+ *
+ * @example
+ * // 带回调函数的用法：延迟 1 秒后执行清理工作
+ * sleep(1000, () => {
+ *   console.log('执行清理操作...');
+ *   // 清理代码...
+ * });
+ *
+ * @example
+ * // 在循环中使用：每次迭代后延迟 500 毫秒
+ * for (let i = 0; i < 5; i++) {
+ *   console.log(`当前值: ${i}`);
+ *   await sleep(500);
+ * }
+ */
+declare function sleep(delay?: number, fn?: () => void): Promise<void>;
+declare function validateTrigger(type?: string, rules?: {}, pureValid?: boolean): boolean | {
+    validator: (rule: any, value: any, callback: (error?: Error | undefined) => void) => void;
+    required: any;
+    trigger: any;
+} | {
+    required: any;
+    message: any;
+    trigger: any;
+    validator?: undefined;
+    min?: undefined;
+    max?: undefined;
+} | {
+    validator: (rule: any, value: any, callback: (error?: Error | undefined) => void) => void;
+    trigger: any;
+    required?: undefined;
+    message?: undefined;
+    min?: undefined;
+    max?: undefined;
+} | {
+    min: any;
+    max: any;
+    message: any;
+    trigger: any;
+    required: any;
+    validator?: undefined;
+} | undefined;
+declare function validate(type?: string, rules?: Record<string, any>, pureValid?: boolean): boolean | {
+    validator: (rule: any, value: any, callback: (error?: Error) => void) => void;
+    required: any;
+    trigger: any;
+} | {
+    required: any;
+    message: any;
+    trigger: any;
+    validator?: undefined;
+    min?: undefined;
+    max?: undefined;
+} | {
+    validator: (rule: any, value: any, callback: (error?: Error) => void) => void;
+    trigger: any;
+    required?: undefined;
+    message?: undefined;
+    min?: undefined;
+    max?: undefined;
+} | {
+    min: any;
+    max: any;
+    message: any;
+    trigger: any;
+    required: any;
+    validator?: undefined;
+} | undefined;
+/**
+ *
+const { res, err } = await proxy.asyncWrapper(listTests, pickForm);
+if (err) {
+    return;
+}
+ */
+declare function asyncWrapper(func: any, ...args: any[]): Promise<{
+    res: any;
+    err?: undefined;
+} | {
+    err: unknown;
+    res?: undefined;
+}>;
+type ToastParams = {
+    hideToast?: boolean;
+} | (Omit<ToastOptions, 'hideToast'> & {
+    hideToast: boolean;
+});
+/**
+ * 复制文本
+ *
+ * copy('这是要复制的文本');
+ *
+ * copy('这是要复制的文本', {duration: 500});
+ *
+ * copy('这是要复制的文本', {hideToast: true});
+ *
+ *  */
+declare const copy: (text: any, toastParams?: ToastParams) => boolean;
+declare function log(variableStr: any, variable: any, otherInfo?: string): void;
+/**
+ * 生成指定范围内的随机整数
+ *
+ * @param min 最小值，默认为0
+ * @param max 最大值，默认为10
+ * @returns 返回生成的随机整数
+ */
+declare function random(min?: number, max?: number): number;
+/**
+ * 将文本转换为带有连接符的行文本
+ *
+ * @param text 要转换的文本
+ * @param connect 连接符，默认为'-'
+ * @returns 返回转换后的行文本
+ * toLine('NameAndy') // name-andy
+ * toLine('nameAndy') // name-andy
+ * toLine('_nameAndy') // _name-andy
+ */
+declare function toLine(text: any, connect?: string): any;
+declare function processWidth(initValue: any, isBase?: boolean): any;
+declare function throttle(fn: any, delay?: number): () => void;
+/**
+ * 封装 Promise 执行，提供自动 loading 状态管理
+ * @param promise 需要执行的 Promise
+ * @param sendLoading 可选的 loading 状态(支持 Ref<boolean> 或 boolean)
+ * @returns Promise<{ data: T | null; error: any }>
+ * @example1
+ * const loading = ref(false);
+ * const { data, error } = await tryCatch(fetchUserData(), loading);
+ * @example2 // 无视 loading 状态
+ * const { data, error } = await tryCatch(fetchUserData());
+ */
+declare function tryCatch<T>(promise: Promise<T>, sendLoading?: Ref<boolean> | null): Promise<{
+    data: T | null;
+    error: any;
+}>;
+/**
+ * 防抖函数
+ * @param { Function } func 函数
+ * @param { Number } delay 防抖时间
+ * @param { Boolean } immediate 是否立即执行
+ * @param { Function } resultCallback
+ */
+declare function debounce(func: Func, delay?: number, immediate?: boolean, resultCallback?: Func): {
+    (this: unknown, ...args: any[]): Promise<unknown>;
+    cancel(): void;
+};
+/**
+ * proxy.confirm('确定删除吗?')
+ * proxy.confirm('哈哈', { icon: 'el-icon-plus' })
+ * close-on-click-modal: 是否可通过点击遮罩层关闭 MessageBox 默认true
+ * lock-scroll: 是否在 MessageBox 出现时将 body 滚动锁定. 默认true
+ * 设置宽度, 内容使用组件
+   import GWarning from '@/autoComponents/gWarning.vue'
+    await proxy.confirm('', {
+      dangerouslyUseHTMLString: true,
+      customStyle: {
+        maxWidth: '600px',
+      },
+      message: h(GWarning, {
+        content:
+          '对于光存储开启保持原始对象名称后，对象将作为独立文件在光存储介质直接存储。<br>注意：当桶内文件大小普遍较小（<100MB）或过大（>5GB）时不推荐打开此功能！您确定开启此功能吗?',
+      }),
+      showCancelButton: true,
+      cancelButtonText: '取消',
+      appendTo: '#highSettingsForm',
+    })
+ * 如果是多个dialog嵌套, 可以给上层的dom设置个id如highSettingsForm, 然后appendTo: '#highSettingsForm'
+ */
+declare function confirm(message: any, options: any): Promise<element_plus.MessageBoxData>;
+/** Function to get a CSS custom property value
+ *
+ * getVariable('--blue');
+ *  */
+declare function getVariable(propertyName: any): string;
+declare function test(): string;
+
+export { $toast, asyncWrapper, clearStorage, clone, confirm, copy, debounce, getStorage, getType, getVariable, isEmpty, log, merge, notEmpty, processWidth, random, setStorage, sleep, test, throttle, toLine, tryCatch, uuid, validForm, validate, validateTrigger };