exploria-ui 2026.10.18 → 2026.10.19

package/dist/components/feedback/EMessageBox/EMessageBox.d.ts

@@ -1,4 +1,22 @@
 import { VNode } from 'vue';
+/**
+ * 关闭动作的触发来源。
+ *
+ * - `confirm`：点击确认按钮
+ * - `cancel`：点击取消按钮
+ * - `close`：点击右上角关闭图标
+ */
+export type EMessageBoxAction = 'confirm' | 'cancel' | 'close';
+/**
+ * beforeClose 回调收到的弹框实例句柄。
+ *
+ * 响应式对象：修改属性会直接反映到弹框 UI，
+ * 目前用于把确认按钮切换为 loading 状态（防重复提交）。
+ */
+export interface EMessageBoxInstance {
+    /** 确认按钮 loading 状态，置 true 时确认按钮转 loading 且不可点击 */
+    confirmButtonLoading: boolean;
+}
 interface MessageBoxOptions {
     title?: string;
     okText?: string;
@@ -7,12 +25,7 @@ interface MessageBoxOptions {
     /**
      * 参考动画元素。用于"指哪打哪"功能，弹框从该元素位置开始显示动画。
      *
-     * 未传入时，自动使用最近一次鼠标落下的元素（同步点击场景下即为
-     * 触发本次调用的按钮），无需手动传入。
-     *
-     * 异步操作（点击后有加载动画/请求，延迟后才弹出）：等待期间用户可能
-     * 点击其他地方，导致自动捕获的元素不准确，此时必须传入此参数，
-     * 确保弹框从原来的触发按钮位置弹出。
+     * 未传入时，弹框从屏幕（或挂载容器）中间放大显示。
      */
     animationReferenceElement?: HTMLElement;
     /**
@@ -20,6 +33,18 @@ interface MessageBoxOptions {
      * 传入挂载元素后，遮罩与对话框仅覆盖该元素，且居中位置以该元素为准。
      */
     mountPoint?: HTMLElement;
+    /**
+     * 关闭前拦截。传入后，点击确认 / 取消 / 关闭图标时弹框不立即关闭，
+     * 关闭时机交由此回调决策：
+     *
+     * - 异步场景：置 `instance.confirmButtonLoading = true` 让确认按钮
+     *   转 loading（同时防重复点击），请求完成后调用 `done()` 才真正关闭
+     * - 校验场景：校验不通过时不调用 `done()`，弹框保持打开
+     * - `action` 区分触发来源（confirm / cancel / close），可只拦截确认
+     *
+     * 未调用 `done()` 前，show 返回的 Promise 保持 pending。
+     */
+    beforeClose?: (action: EMessageBoxAction, instance: EMessageBoxInstance, done: () => void) => void;
 }
 export default class EMessageBox {
     private static show;

package/dist/components/feedback/EMessageBox/EMessageBox.vue.d.ts

@@ -6,6 +6,14 @@ type __VLS_Props = {
     width?: string;
     okText?: string;
     cancelText?: string;
+    /**
+     * 弹框实例句柄（beforeClose 场景由 EMessageBox.show 注入的 reactive 对象）。
+     * confirmButtonLoading 驱动确认按钮的 loading 视图。
+     * 类型内联声明避免与 EMessageBox.ts 循环依赖。
+     */
+    instance?: {
+        confirmButtonLoading?: boolean;
+    };
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     cancel: () => any;