yc-pro-components 0.0.16 → 0.0.17

package/es/hooks/usePlusFormReset.d.ts

@@ -0,0 +1,97 @@
+import { PlusDialogForm, PlusDrawerForm } from 'yc-components';
+import { Ref } from 'vue';
+
+/**
+ * 表单重置选项
+ */
+export interface FormResetOptions {
+    /**
+     * 是否在打开时清除验证状态
+     * @default true
+     */
+    clearValidateOnOpen?: boolean;
+    /**
+     * 是否在关闭时重置表单数据
+     * @default true
+     */
+    resetFieldsOnClose?: boolean;
+    /**
+     * 是否在打开时重置表单数据
+     * @default false - 编辑模式下通常不需要重置
+     */
+    resetFieldsOnOpen?: boolean;
+    /**
+     * 自定义重置回调函数（在关闭时调用）
+     */
+    onReset?: () => void;
+    /**
+     * 自定义清除验证回调函数（在打开时调用）
+     */
+    onClearValidate?: () => void;
+}
+/**
+ * Plus Pro Form 重置 Composable
+ *
+ * @description
+ * 用于 PlusDialogForm 和 PlusDrawerForm 组件的表单状态重置管理。
+ *
+ * 功能：
+ * 1. 监听对话框/抽屉的打开/关闭状态
+ * 2. 打开时自动清除验证状态（可选）
+ * 3. 关闭时自动重置表单数据（可选）
+ * 4. 支持自定义重置逻辑
+ *
+ * @example
+ * ```ts
+ * // 在组件中使用
+ * const visible = ref(false);
+ * const plusFormRef = ref();
+ *
+ * const { formRef } = usePlusFormReset(visible, {
+ *   clearValidateOnOpen: true,
+ *   resetFieldsOnClose: true,
+ *   onReset: () => {
+ *     // 自定义重置逻辑
+ *     formData.value = { ...defaultFormData };
+ *   }
+ * });
+ *
+ * // 在模板中绑定 ref
+ * <PlusDialogForm ref="formRef" v-model:visible="visible" ... />
+ * ```
+ *
+ * @param visible - 对话框/抽屉的可见性状态（响应式引用）
+ * @param options - 重置选项配置
+ * @returns 包含 formRef 的对象
+ */
+export declare function usePlusFormReset(visible: Ref<boolean>, options?: FormResetOptions): {
+    formRef: Ref<InstanceType<typeof PlusDialogForm | typeof PlusDrawerForm> | undefined>;
+    clearValidate: () => Promise<void>;
+    resetFields: () => Promise<void>;
+};
+/**
+ * 简化版本：仅清除验证状态（适用于编辑模式）
+ *
+ * @example
+ * ```ts
+ * const visible = ref(false);
+ * const { formRef } = usePlusFormClearValidate(visible);
+ *
+ * <PlusDialogForm ref="formRef" v-model:visible="visible" ... />
+ * ```
+ */
+export declare function usePlusFormClearValidate(visible: Ref<boolean>): ReturnType<typeof usePlusFormReset>;
+/**
+ * 完整版本：清除验证 + 重置表单（适用于新增模式）
+ *
+ * @example
+ * ```ts
+ * const visible = ref(false);
+ * const { formRef } = usePlusFormFullReset(visible, () => {
+ *   formData.value = { ...defaultFormData };
+ * });
+ *
+ * <PlusDialogForm ref="formRef" v-model:visible="visible" ... />
+ * ```
+ */
+export declare function usePlusFormFullReset(visible: Ref<boolean>, onReset?: () => void): ReturnType<typeof usePlusFormReset>;

package/index.js

@@ -1,4 +1,4 @@
-/*! yc-pro-components v0.0.16 */
+/*! yc-pro-components v0.0.17 */
 (function (global, factory) {
   typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('vue'), require('element-plus')) :
   typeof define === 'function' && define.amd ? define(['exports', 'vue', 'element-plus'], factory) :
@@ -23,10 +23,8 @@
   /** Used as a reference to the global object. */
   var root = freeGlobal || freeSelf || Function('return this')();
 
-  var root$1 = root;
-
   /** Built-in value references. */
-  var Symbol$1 = root$1.Symbol;
+  var Symbol$1 = root.Symbol;
 
   /** Used for built-in method references. */
   var objectProto$f = Object.prototype;
@@ -421,7 +419,7 @@
   }
 
   /** Used to detect overreaching core-js shims. */
-  var coreJsData = root$1['__core-js_shared__'];
+  var coreJsData = root['__core-js_shared__'];
 
   /** Used to detect methods masquerading as native. */
   var maskSrcKey = (function() {
@@ -532,7 +530,7 @@
   }
 
   /* Built-in method references that are verified to be native. */
-  var WeakMap$1 = getNative(root$1, 'WeakMap');
+  var WeakMap$1 = getNative(root, 'WeakMap');
 
   /** Built-in value references. */
   var objectCreate = Object.create;
@@ -1133,7 +1131,7 @@
   var moduleExports$2 = freeModule$2 && freeModule$2.exports === freeExports$2;
 
   /** Built-in value references. */
-  var Buffer$1 = moduleExports$2 ? root$1.Buffer : undefined;
+  var Buffer$1 = moduleExports$2 ? root.Buffer : undefined;
 
   /* Built-in method references for those with the same name as other `lodash` methods. */
   var nativeIsBuffer = Buffer$1 ? Buffer$1.isBuffer : undefined;
@@ -1752,7 +1750,7 @@
   ListCache.prototype.set = listCacheSet;
 
   /* Built-in method references that are verified to be native. */
-  var Map$1 = getNative(root$1, 'Map');
+  var Map$1 = getNative(root, 'Map');
 
   /**
    * Removes all key-value entries from the map.
@@ -2327,7 +2325,7 @@
   var moduleExports = freeModule && freeModule.exports === freeExports;
 
   /** Built-in value references. */
-  var Buffer = moduleExports ? root$1.Buffer : undefined,
+  var Buffer = moduleExports ? root.Buffer : undefined,
       allocUnsafe = Buffer ? Buffer.allocUnsafe : undefined;
 
   /**
@@ -2504,13 +2502,13 @@
   }
 
   /* Built-in method references that are verified to be native. */
-  var DataView$1 = getNative(root$1, 'DataView');
+  var DataView$1 = getNative(root, 'DataView');
 
   /* Built-in method references that are verified to be native. */
-  var Promise$1 = getNative(root$1, 'Promise');
+  var Promise$1 = getNative(root, 'Promise');
 
   /* Built-in method references that are verified to be native. */
-  var Set$1 = getNative(root$1, 'Set');
+  var Set$1 = getNative(root, 'Set');
 
   /** `Object#toString` result references. */
   var mapTag$4 = '[object Map]',
@@ -2589,7 +2587,7 @@
   }
 
   /** Built-in value references. */
-  var Uint8Array$1 = root$1.Uint8Array;
+  var Uint8Array$1 = root.Uint8Array;
 
   /**
    * Creates a clone of `arrayBuffer`.
@@ -3876,7 +3874,7 @@
    * // => Logs the number of milliseconds it took for the deferred invocation.
    */
   var now = function() {
-    return root$1.Date.now();
+    return root.Date.now();
   };
 
   /** Error message constants. */