exploria-ui 2026.8.27 → 2026.9.26

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

@@ -1,3 +1,4 @@
+import { EContainerTarget } from '../../hooks/useContainer';
 import { default as MediaViewer } from './EMediaViewer.vue';
 export default class EMediaViewer {
     static open(src: string, type: InstanceType<typeof MediaViewer>['type'], 
@@ -12,5 +13,10 @@ export default class EMediaViewer {
      *
      * 此参数专为异步场景设计，确保动画参考元素的准确性。
      */
-    animationReferenceElement?: HTMLElement): void;
+    animationReferenceElement?: HTMLElement, 
+    /**
+     * 弹窗容器。默认 document.body，此时媒体查看器铺满视口。
+     * 传入容器元素后，媒体查看器仅覆盖该容器，且缩放动画以容器中心为基准。
+     */
+    container?: EContainerTarget): void;
 }

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

@@ -1,4 +1,5 @@
 import { ESize } from '../../types/size.d.ts';
+import { EContainerTarget } from '../../hooks/useContainer';
 interface ModalProps {
     open: boolean;
     title?: string;
@@ -26,6 +27,11 @@ interface ModalProps {
     animationReferenceElement?: HTMLElement | {
         $el: HTMLElement;
     };
+    /**
+     * 弹窗容器。默认 document.body，此时遮罩铺满视口、对话框在视口中居中。
+     * 传入容器元素后，遮罩仅覆盖该容器，对话框在容器内居中。
+     */
+    container?: EContainerTarget;
 }
 declare function __VLS_template(): {
     attrs: Partial<{}>;

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

@@ -1,4 +1,5 @@
 import { ESize } from '../../types/size.d.ts';
+import { EContainerTarget } from '../../hooks/useContainer';
 interface DrawerProps {
     open: boolean;
     title?: string;
@@ -10,6 +11,11 @@ interface DrawerProps {
     size?: ESize;
     showFooter?: boolean;
     closeOnClickMask?: boolean;
+    /**
+     * 弹窗容器。默认 document.body，此时遮罩铺满视口、抽屉贴靠视口边缘。
+     * 传入容器元素后，遮罩仅覆盖该容器，抽屉贴靠容器边缘。
+     */
+    container?: EContainerTarget;
 }
 declare function __VLS_template(): {
     attrs: Partial<{}>;

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

@@ -1,12 +1,26 @@
+import { EContainerTarget } from '../../hooks/useContainer';
 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, container?: EContainerTarget): () => void;
+    static loading(str: string, container?: EContainerTarget): () => void;
+    static success(str: string, duration?: number, container?: EContainerTarget): () => void;
+    static error(str: string, duration?: number, container?: EContainerTarget): () => void;
+    static info(str: string, duration?: number, container?: EContainerTarget): () => void;
+    static warning(str: string, duration?: number, container?: EContainerTarget): () => void;
 }

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

@@ -1,3 +1,4 @@
+import { EContainerTarget } from '../../hooks/useContainer';
 interface MessageBoxOptions {
     title?: string;
     okText?: string;
@@ -17,6 +18,11 @@ interface MessageBoxOptions {
     animationReferenceElement?: HTMLElement | {
         $el: HTMLElement;
     };
+    /**
+     * 弹窗容器。默认 document.body，此时遮罩与对话框铺满视口。
+     * 传入容器元素后，遮罩与对话框仅覆盖该容器，且居中位置以容器为准。
+     */
+    container?: EContainerTarget;
 }
 export default class EMessageBox {
     private static show;

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

@@ -1,3 +1,4 @@
+import { EContainerTarget } from '../../hooks/useContainer';
 type NotificationPlacement = 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end';
 interface NotificationOptions {
     title?: string;
@@ -7,11 +8,13 @@ interface NotificationOptions {
     placement?: NotificationPlacement;
     showClose?: boolean;
     onClick?: () => void;
+    /**
+     * 弹窗容器。默认 document.body，此时通知贴靠视口边缘。
+     * 传入容器元素后，通知贴靠容器边缘并随容器变化重新排布。
+     */
+    container?: EContainerTarget;
 }
 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,103 @@
+import { MaybeRefOrGetter, Ref, ShallowRef } from 'vue';
+/**
+ * 弹窗容器。默认 document.body。
+ *
+ * - `HTMLElement`：容器元素，推荐用法
+ * - `() => HTMLElement`：惰性求值，适用于容器尚未渲染完成的场景
+ */
+export type EContainerTarget = HTMLElement | (() => HTMLElement | null | undefined);
+/**
+ * 容器在视口中的矩形区域。
+ */
+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;
+/**
+ * 归一化容器目标，解析失败时回退到默认容器。
+ */
+export declare const normalizeContainer: (target?: EContainerTarget | null) => HTMLElement;
+/**
+ * 创建容器上下文。
+ */
+export declare const createContainerContext: (target?: EContainerTarget | null) => 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 | null | 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';

package/dist/components/index.js

@@ -1,55 +1,55 @@
-/* empty css                                 */
-import e from "../src/directives/EDrag.js";
-import t from "../src/directives/ESizeOb.js";
-import n from "../src/components/advanced/ERollingFollow/ERollingFollow.vue.js";
-import r from "../src/components/advanced/EVirtualList/EVirtualList.vue.js";
-import i from "../src/components/advanced/EWatermark/EWatermark.vue.js";
-import a from "../src/components/basic/EAvatar/EAvatar.vue.js";
-import o from "../src/components/basic/EBadge/EBadge.vue.js";
-import s from "../src/components/basic/EButton/EButton.vue.js";
-import c from "../src/components/basic/ECard/ECard.vue.js";
-import l from "../src/components/basic/ESvgIcon/ESvgIcon.vue.js";
-import u from "../src/components/basic/EUnderLine/EUnderLine.vue.js";
-import d from "../src/components/data/ECalendar.vue.js";
-import f from "../src/components/data/ECarousel/ECarousel.vue.js";
-import p from "../src/components/data/ECarousel/ECarouselItem.vue.js";
-import m from "../src/components/feedback/ETooltip.vue.js";
-import h from "../src/components/data/ECodeCollapse/ECodeCollapse.vue.js";
-import g from "../src/components/data/ECollapse/ECollapse.vue.js";
-import _ from "../src/components/data/EImage.vue.js";
-import v from "../src/components/form/ECheckbox.vue.js";
-import y from "../src/components/data/EList.vue.js";
-import b from "../src/components/data/EMediaViewer/EMediaViewer.js";
-import x from "../src/components/data/EProgress.vue.js";
-import S from "../src/components/data/ERollingPagination.vue.js";
-import C from "../src/components/data/ESkeleton/ESkeleton.vue.js";
-import w from "../src/components/data/ESteps/ESteps.vue.js";
-import T from "../src/components/data/ESteps/EStepItem.vue.js";
-import E from "../src/components/data/ETable/ETable.vue.js";
-import D from "../src/components/data/ETable/ETableColumn.vue.js";
-import O from "../src/components/data/ETimeline/ETimeline.vue.js";
-import k from "../src/components/data/ETimeline/ETimelineItem.vue.js";
-import A from "../src/components/feedback/EDialog/EDialog.vue.js";
-import j from "../src/components/feedback/EDrawer/EDrawer.vue.js";
-import M from "../src/components/feedback/EMessage/EMessage.js";
-import N from "../src/components/form/EInput/EInput.vue.js";
-import P from "../src/components/feedback/EMessageBox/EMessageBox.js";
-import F from "../src/components/feedback/ENotification/ENotification.js";
-import I from "../src/components/feedback/EPopover.vue.js";
-import L from "../src/components/form/EColorPicker.vue.js";
-import R from "../src/components/form/EConditionGroup/EConditionGroup.vue.js";
-import z from "../src/components/form/EFileSelector.vue.js";
-import B from "../src/components/form/EForm/EForm.vue.js";
-import V from "../src/components/form/EForm/EFormItem.vue.js";
-import H from "../src/components/form/ERadio.vue.js";
-import U from "../src/components/form/ESelect/ESelect.vue.js";
-import W from "../src/components/form/ESlider.vue.js";
-import G from "../src/components/form/ETimePicker.vue.js";
-import K from "../src/components/geometry/ECube.vue.js";
-import q from "../src/components/layout/EContainerWithScrollbar.vue.js";
-import J from "../src/components/layout/EDivider.vue.js";
-import Y from "../src/components/layout/EScrollX.vue.js";
-import X from "../src/components/navigation/EDropdown.vue.js";
-import Z from "../src/components/navigation/ETabs/ETabPane.vue.js";
-import Q from "../src/components/navigation/ETabs/ETabs.vue.js";
+/* empty css                                                      */
+import e from "../packages/exploria-ui/src/directives/EDrag.js";
+import t from "../packages/exploria-ui/src/directives/ESizeOb.js";
+import n from "../packages/exploria-ui/src/components/advanced/ERollingFollow/ERollingFollow.vue.js";
+import r from "../packages/exploria-ui/src/components/advanced/EVirtualList/EVirtualList.vue.js";
+import i from "../packages/exploria-ui/src/components/advanced/EWatermark/EWatermark.vue.js";
+import a from "../packages/exploria-ui/src/components/basic/EAvatar/EAvatar.vue.js";
+import o from "../packages/exploria-ui/src/components/basic/EBadge/EBadge.vue.js";
+import s from "../packages/exploria-ui/src/components/basic/EButton/EButton.vue.js";
+import c from "../packages/exploria-ui/src/components/basic/ECard/ECard.vue.js";
+import l from "../packages/exploria-ui/src/components/basic/ESvgIcon/ESvgIcon.vue.js";
+import u from "../packages/exploria-ui/src/components/basic/EUnderLine/EUnderLine.vue.js";
+import d from "../packages/exploria-ui/src/components/data/ECalendar.vue.js";
+import f from "../packages/exploria-ui/src/components/data/ECarousel/ECarousel.vue.js";
+import p from "../packages/exploria-ui/src/components/data/ECarousel/ECarouselItem.vue.js";
+import m from "../packages/exploria-ui/src/components/feedback/ETooltip.vue.js";
+import h from "../packages/exploria-ui/src/components/data/ECodeCollapse/ECodeCollapse.vue.js";
+import g from "../packages/exploria-ui/src/components/data/ECollapse/ECollapse.vue.js";
+import _ from "../packages/exploria-ui/src/components/data/EImage.vue.js";
+import v from "../packages/exploria-ui/src/components/form/ECheckbox.vue.js";
+import y from "../packages/exploria-ui/src/components/data/EList.vue.js";
+import b from "../packages/exploria-ui/src/components/data/EMediaViewer/EMediaViewer.js";
+import x from "../packages/exploria-ui/src/components/data/EProgress.vue.js";
+import S from "../packages/exploria-ui/src/components/data/ERollingPagination.vue.js";
+import C from "../packages/exploria-ui/src/components/data/ESkeleton/ESkeleton.vue.js";
+import w from "../packages/exploria-ui/src/components/data/ESteps/ESteps.vue.js";
+import T from "../packages/exploria-ui/src/components/data/ESteps/EStepItem.vue.js";
+import E from "../packages/exploria-ui/src/components/data/ETable/ETable.vue.js";
+import D from "../packages/exploria-ui/src/components/data/ETable/ETableColumn.vue.js";
+import O from "../packages/exploria-ui/src/components/data/ETimeline/ETimeline.vue.js";
+import k from "../packages/exploria-ui/src/components/data/ETimeline/ETimelineItem.vue.js";
+import A from "../packages/exploria-ui/src/components/feedback/EDialog/EDialog.vue.js";
+import j from "../packages/exploria-ui/src/components/feedback/EDrawer/EDrawer.vue.js";
+import M from "../packages/exploria-ui/src/components/feedback/EMessage/EMessage.js";
+import N from "../packages/exploria-ui/src/components/form/EInput/EInput.vue.js";
+import P from "../packages/exploria-ui/src/components/feedback/EMessageBox/EMessageBox.js";
+import F from "../packages/exploria-ui/src/components/feedback/ENotification/ENotification.js";
+import I from "../packages/exploria-ui/src/components/feedback/EPopover.vue.js";
+import L from "../packages/exploria-ui/src/components/form/EColorPicker.vue.js";
+import R from "../packages/exploria-ui/src/components/form/EConditionGroup/EConditionGroup.vue.js";
+import z from "../packages/exploria-ui/src/components/form/EFileSelector.vue.js";
+import B from "../packages/exploria-ui/src/components/form/EForm/EForm.vue.js";
+import V from "../packages/exploria-ui/src/components/form/EForm/EFormItem.vue.js";
+import H from "../packages/exploria-ui/src/components/form/ERadio.vue.js";
+import U from "../packages/exploria-ui/src/components/form/ESelect/ESelect.vue.js";
+import W from "../packages/exploria-ui/src/components/form/ESlider.vue.js";
+import G from "../packages/exploria-ui/src/components/form/ETimePicker.vue.js";
+import K from "../packages/exploria-ui/src/components/geometry/ECube.vue.js";
+import q from "../packages/exploria-ui/src/components/layout/EContainerWithScrollbar.vue.js";
+import J from "../packages/exploria-ui/src/components/layout/EDivider.vue.js";
+import Y from "../packages/exploria-ui/src/components/layout/EScrollX.vue.js";
+import X from "../packages/exploria-ui/src/components/navigation/EDropdown.vue.js";
+import Z from "../packages/exploria-ui/src/components/navigation/ETabs/ETabPane.vue.js";
+import Q from "../packages/exploria-ui/src/components/navigation/ETabs/ETabs.vue.js";
 export { a as EAvatar, o as EBadge, s as EButton, d as ECalendar, c as ECard, f as ECarousel, p as ECarouselItem, v as ECheckbox, h as ECodeCollapse, g as ECollapse, L as EColorPicker, R as EConditionGroup, q as EContainerWithScrollbar, K as ECube, A as EDialog, J as EDivider, e as EDrag, j as EDrawer, X as EDropdown, z as EFileSelector, B as EForm, V as EFormItem, _ as EImage, N as EInput, y as EList, b as EMediaViewer, M as EMessage, P as EMessageBox, F as ENotification, I as EPopover, x as EProgress, H as ERadio, n as ERollingFollow, S as ERollingPagination, Y as EScrollX, U as ESelect, t as ESizeOb, C as ESkeleton, W as ESlider, T as EStepItem, w as ESteps, l as ESvgIcon, Z as ETabPane, E as ETable, D as ETableColumn, Q as ETabs, G as ETimePicker, O as ETimeline, k as ETimelineItem, m as ETooltip, u as EUnderLine, r as EVirtualList, i as EWatermark };

package/dist/directives/index.js

@@ -1,4 +1,4 @@
-import e from "../src/directives/EDrag.js";
-import t from "../src/directives/ESizeOb.js";
-import n from "../src/directives/ESlideIn.js";
+import e from "../packages/exploria-ui/src/directives/EDrag.js";
+import t from "../packages/exploria-ui/src/directives/ESizeOb.js";
+import n from "../packages/exploria-ui/src/directives/ESlideIn.js";
 export { e as vEDrag, t as vESizeOb, n as vESlideIn };