exploria-ui 2026.8.28 → 2026.10.3

package/dist/components/data/ECarousel/ECarousel.vue.d.ts

@@ -21,11 +21,11 @@ declare function __VLS_template(): {
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
-    "update:model-value": (value: number) => any;
     change: (value: number) => any;
+    "update:model-value": (value: number) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:model-value"?: ((value: number) => any) | undefined;
     onChange?: ((value: number) => any) | undefined;
+    "onUpdate:model-value"?: ((value: number) => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     carouselRef: HTMLDivElement;
     arrowCanvas: HTMLCanvasElement;

package/dist/components/data/EMediaViewer/EMediaViewer.d.ts

@@ -12,5 +12,10 @@ export default class EMediaViewer {
      *
      * 此参数专为异步场景设计，确保动画参考元素的准确性。
      */
-    animationReferenceElement?: HTMLElement): void;
+    animationReferenceElement?: HTMLElement, 
+    /**
+     * 弹窗挂载点。默认 document.body，此时媒体查看器铺满视口。
+     * 传入挂载元素后，媒体查看器仅覆盖该元素，且缩放动画以该元素中心为基准。
+     */
+    mountPoint?: HTMLElement): void;
 }

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

@@ -23,9 +23,12 @@ interface ModalProps {
      *
      * 此参数专为异步场景设计，确保动画参考元素的准确性。
      */
-    animationReferenceElement?: HTMLElement | {
-        $el: HTMLElement;
-    };
+    animationReferenceElement?: HTMLElement;
+    /**
+     * 弹窗挂载点。默认 document.body，此时遮罩铺满视口、对话框在视口中居中。
+     * 传入挂载元素后，遮罩仅覆盖该元素，对话框在其内居中。
+     */
+    mountPoint?: HTMLElement;
 }
 declare function __VLS_template(): {
     attrs: Partial<{}>;

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

@@ -10,6 +10,11 @@ interface DrawerProps {
     size?: ESize;
     showFooter?: boolean;
     closeOnClickMask?: boolean;
+    /**
+     * 抽屉挂载点。默认 document.body，此时遮罩铺满视口、抽屉贴靠视口边缘。
+     * 传入挂载元素后，遮罩仅覆盖该元素，抽屉贴靠其边缘。
+     */
+    mountPoint?: HTMLElement;
 }
 declare function __VLS_template(): {
     attrs: Partial<{}>;

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

@@ -1,12 +1,25 @@
 import { default as Message } from './EMessage.vue';
 export default class EMessage {
+    /**
+     * 获取容器对应的队列状态，首次使用时注册容器变化监听。
+     */
+    private static getMessageState;
+    /**
+     * 按容器重新排布消息队列。
+     */
     private static layout;
-    private static centerElement;
+    /**
+     * 队列变化时，对存量消息播放位移过渡。
+     */
     private static flipExisting;
-    static show(str: string, type: InstanceType<typeof Message>['type'], duration?: number): () => void;
-    static loading(str: string): () => void;
-    static success(str: string, duration?: number): () => void;
-    static error(str: string, duration?: number): () => void;
-    static info(str: string, duration?: number): () => void;
-    static warning(str: string, duration?: number): () => void;
+    /**
+     * 队列清空后释放容器对应的状态与监听。
+     */
+    private static releaseState;
+    static show(str: string, type: InstanceType<typeof Message>['type'], duration?: number, mountPoint?: HTMLElement): () => void;
+    static loading(str: string, mountPoint?: HTMLElement): () => void;
+    static success(str: string, duration?: number, mountPoint?: HTMLElement): () => void;
+    static error(str: string, duration?: number, mountPoint?: HTMLElement): () => void;
+    static info(str: string, duration?: number, mountPoint?: HTMLElement): () => void;
+    static warning(str: string, duration?: number, mountPoint?: HTMLElement): () => void;
 }

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

@@ -14,9 +14,12 @@ interface MessageBoxOptions {
      *
      * 此参数专为异步场景设计，确保动画参考元素的准确性。
      */
-    animationReferenceElement?: HTMLElement | {
-        $el: HTMLElement;
-    };
+    animationReferenceElement?: HTMLElement;
+    /**
+     * 弹窗挂载点。默认 document.body，此时遮罩与对话框铺满视口。
+     * 传入挂载元素后，遮罩与对话框仅覆盖该元素，且居中位置以该元素为准。
+     */
+    mountPoint?: HTMLElement;
 }
 export default class EMessageBox {
     private static show;

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

@@ -7,11 +7,13 @@ interface NotificationOptions {
     placement?: NotificationPlacement;
     showClose?: boolean;
     onClick?: () => void;
+    /**
+     * 弹窗挂载点。默认 document.body，此时通知贴靠视口边缘。
+     * 传入挂载元素后，通知贴靠其边缘并随其变化重新排布。
+     */
+    mountPoint?: HTMLElement;
 }
 export default class ENotification {
-    private static getContainerList;
-    private static layout;
-    private static flipExisting;
     static show(options: string | NotificationOptions): {
         close: () => void;
     };

package/dist/components/hooks/useContainer.d.ts

@@ -0,0 +1,104 @@
+import { MaybeRefOrGetter, Ref, ShallowRef } from 'vue';
+/**
+ * 弹窗容器。默认 document.body。
+ *
+ * 只接受标准 HTMLElement（可选参数，不传即默认 body）：
+ * 传入容器元素后，遮罩仅覆盖该容器、弹窗在容器内居中；
+ * 未传（undefined）时回退到 document.body，遮罩铺满视口。
+ */
+export type EContainerTarget = HTMLElement;
+/**
+ * 容器在视口中的矩形区域。
+ */
+export interface EContainerBox {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/**
+ * 弹窗定位模式。
+ *
+ * - `fixed`：弹窗相对视口定位，坐标直接取视口坐标（默认策略，可溢出容器）
+ * - `absolute`：容器链上存在 transform / filter / contain 等属性导致 fixed 的
+ *   包含块被改写时自动降级，坐标换算到容器内部
+ */
+export type EPositionMode = 'fixed' | 'absolute';
+/**
+ * 铺满容器的样式。
+ *
+ * 只声明实际用到的字段，不复用 vue 的 `CSSProperties`——后者内部由 `csstype`
+ * 推导，会让构建产物的类型声明依赖 pnpm 提升目录里的间接依赖（TS2742）。
+ */
+export interface ECoverStyle {
+    position: EPositionMode;
+    left: string;
+    top: string;
+    width: string;
+    height: string;
+    /**
+     * 自定义属性索引签名。vue 的 `StyleValue` 要求样式对象具备该签名，
+     * 否则 `:style` 绑定会报 TS2345。
+     */
+    [customProperty: `--${string}`]: string | number | undefined;
+}
+/**
+ * 容器上下文。承载「弹窗挂在哪」与「坐标以谁为原点」两件事。
+ */
+export interface EContainerContext {
+    /** 解析后的容器元素 */
+    readonly container: HTMLElement;
+    /** 容器是否为 document.body */
+    readonly isBody: boolean;
+    /** 定位模式 */
+    readonly positionMode: EPositionMode;
+    /** 容器在视口中的矩形区域 */
+    getBox(): EContainerBox;
+    /** 视口坐标 → 可直接写入 style 的 left / top 值 */
+    toLocal(viewportX: number, viewportY: number): {
+        left: number;
+        top: number;
+    };
+    /** 元素在容器中居中时的 left / top 值 */
+    center(width: number, height: number): {
+        left: number;
+        top: number;
+    };
+    /** 让元素铺满容器的样式对象 */
+    coverStyle(): ECoverStyle;
+    /** 把元素铺满容器 */
+    cover(el: HTMLElement): void;
+    /** 监听容器尺寸与滚动变化，返回取消监听的函数 */
+    observe(onChange: () => void): () => void;
+}
+/**
+ * 默认容器。运行时求值，避免 SSR / 测试环境下模块加载阶段访问 document 报错。
+ */
+export declare const getDefaultContainer: () => HTMLElement;
+/**
+ * 归一化容器目标，未传（undefined）时回退到默认容器。
+ */
+export declare const normalizeContainer: (target?: EContainerTarget) => HTMLElement;
+/**
+ * 创建容器上下文。
+ */
+export declare const createContainerContext: (target?: EContainerTarget) => EContainerContext;
+/**
+ * `useContainer` 的返回值。显式声明，避免类型声明产物推导到间接依赖。
+ */
+export interface EContainerApi {
+    /** 解析后的容器元素 */
+    container: ShallowRef<HTMLElement>;
+    /** 容器在视口中的矩形区域 */
+    box: Ref<EContainerBox>;
+    /** 定位模式 */
+    positionMode: Ref<EPositionMode>;
+    /** 铺满容器的样式，可直接绑定到弹窗根节点 */
+    coverStyle: Ref<ECoverStyle>;
+    /** 手动刷新 box / positionMode / coverStyle */
+    refresh(): void;
+}
+/**
+ * 组件内使用的容器上下文。容器尺寸或滚动变化时自动刷新 box。
+ */
+export declare const useContainer: (target?: MaybeRefOrGetter<EContainerTarget | undefined>) => EContainerApi;

package/dist/components/index.d.ts

@@ -1,3 +1,4 @@
+export type { EContainerTarget } from './hooks/useContainer';
 export { default as EDrag } from '../directives/EDrag.ts';
 export { default as ESizeOb } from '../directives/ESizeOb.ts';
 export { default as ERollingFollow } from './advanced/ERollingFollow/ERollingFollow.vue';