niuma-ui 2.0.4 → 2.1.0

package/dist/components/popover/src/RsPopover.impl.js

@@ -1,12 +1,46 @@
-import { PopoverContent, PopoverPortal, PopoverRoot, PopoverTrigger } from "../../_shared/src/reka.js";
-import { computed, createBlock, createCommentVNode, createVNode, defineComponent, mergeModels, normalizeClass, openBlock, renderSlot, unref, useModel, withCtx } from "vue";
+import { useRsConfigOptional } from "../../../composables/useRsConfig.js";
+import { resolveDirMode } from "../../../locale/apply.js";
+import { useRsI18n } from "../../../composables/useRsI18n.js";
+import RsIcon_default from "../../icon/src/RsIcon.js";
+import { useResolvedRsComponentSize } from "../../_shared/src/resolve-size.js";
+import { rsRadiusCss, useResolvedRsRadius } from "../../_shared/src/resolve-radius.js";
+import { placeAlignedPopup } from "../../_shared/src/overlay-utils.js";
+import { clampPopoverDelay, listPopoverFocusable, nextPopoverFocusIndex, normalizePopoverTriggers, resolvePopoverElement, resolvePopoverPortalTarget } from "./popover-utils.js";
+import { Comment, Fragment, Teleport, Text, cloneVNode, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, isVNode, mergeModels, mergeProps, nextTick, normalizeClass, normalizeStyle, onUnmounted, openBlock, ref, renderSlot, toDisplayString, unref, useAttrs, useId, useModel, useSlots, useTemplateRef, watch, withModifiers } from "vue";
 //#region src/components/popover/src/RsPopover.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = ["id", "data-disabled"];
+var _hoisted_2 = [
+	"open",
+	"hidden",
+	"tabindex",
+	"aria-modal",
+	"aria-labelledby",
+	"aria-label",
+	"data-side",
+	"data-align",
+	"data-rs-theme",
+	"data-rs-popover-trigger"
+];
+var _hoisted_3 = {
+	key: 0,
+	class: "rs-popover__arrow",
+	"aria-hidden": "true"
+};
+var _hoisted_4 = {
+	key: 1,
+	class: "rs-popover__head"
+};
+var _hoisted_5 = ["aria-label"];
+var _hoisted_6 = { class: "rs-popover__body" };
 var RsPopover_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsPopover",
+	inheritAttrs: false,
 	__name: "RsPopover",
 	props: /*@__PURE__*/ mergeModels({
 		side: { default: "bottom" },
 		align: { default: "start" },
 		sideOffset: { default: 6 },
+		alignOffset: { default: 0 },
 		modal: {
 			type: Boolean,
 			default: false
@@ -20,7 +54,36 @@ var RsPopover_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 			type: Boolean,
 			default: false
 		},
-		popupClassName: {}
+		popupClassName: {},
+		trigger: { default: "click" },
+		disabled: {
+			type: Boolean,
+			default: false
+		},
+		title: {},
+		arrow: {
+			type: Boolean,
+			default: false
+		},
+		showClose: {
+			type: Boolean,
+			default: false
+		},
+		closeOnEsc: {
+			type: Boolean,
+			default: true
+		},
+		closeOnOutside: {
+			type: Boolean,
+			default: true
+		},
+		mouseEnterDelay: { default: 100 },
+		mouseLeaveDelay: { default: 150 },
+		getPopupContainer: {},
+		size: {},
+		radius: {},
+		ariaLabel: {},
+		id: {}
 	}, {
 		"open": {
 			type: Boolean,
@@ -28,42 +91,490 @@ var RsPopover_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 		},
 		"openModifiers": {}
 	}),
-	emits: ["update:open"],
-	setup(__props) {
+	emits: /*@__PURE__*/ mergeModels(["openChange"], ["update:open"]),
+	setup(__props, { expose: __expose, emit: __emit }) {
 		const open = useModel(__props, "open");
 		const props = __props;
-		const contentForceMount = computed(() => props.forceMount || !props.lazyMount);
-		const portalMounted = computed(() => props.forceMount || !props.lazyMount || open.value);
+		const emit = __emit;
+		const attrs = useAttrs();
+		const slots = useSlots();
+		const { t, locale } = useRsI18n();
+		const config = useRsConfigOptional();
+		const autoId = useId();
+		const contentId = `${autoId}-content`;
+		const titleId = `${autoId}-title`;
+		const fallbackTriggerId = `${autoId}-trigger`;
+		const rootRef = useTemplateRef("rootRef");
+		const contentRef = useTemplateRef("contentRef");
+		const triggerEl = ref(null);
+		const activeTriggerId = ref(fallbackTriggerId);
+		const panelTheme = ref();
+		const layeredInDialog = ref(false);
+		const positionMode = ref("fixed");
+		const box = ref({
+			top: 0,
+			left: 0,
+			side: props.side,
+			align: props.align
+		});
+		const resolvedSize = useResolvedRsComponentSize(() => props.size);
+		const resolvedRadius = useResolvedRsRadius(() => props.radius, "sm");
+		const triggers = computed(() => normalizePopoverTriggers(props.trigger));
+		const hasClick = computed(() => triggers.value.includes("click"));
+		const hasHover = computed(() => triggers.value.includes("hover"));
+		const hasFocusTrigger = computed(() => triggers.value.includes("focus"));
+		const enterDelay = computed(() => clampPopoverDelay(props.mouseEnterDelay, 100));
+		const leaveDelay = computed(() => clampPopoverDelay(props.mouseLeaveDelay, 150));
+		const isRtl = computed(() => resolveDirMode(config?.dir.value ?? "auto", config?.locale.value ?? locale.value) === "rtl");
+		const hasTitle = computed(() => Boolean(props.title) || Boolean(slots.title));
+		const showChrome = computed(() => hasTitle.value || props.showClose);
+		const closeLabel = computed(() => t("popover.close"));
+		const dialogLabel = computed(() => props.ariaLabel?.trim() || t("popover.label"));
+		const keepMounted = computed(() => props.forceMount || !props.lazyMount);
+		const portalMounted = computed(() => keepMounted.value || open.value);
+		const portalTarget = computed(() => resolvePopoverPortalTarget(props.getPopupContainer, triggerEl.value));
+		const contentClass = computed(() => [
+			`rs-popover__content--${props.width}`,
+			`rs-popover__content--size-${resolvedSize.value}`,
+			props.popupClassName,
+			{ "rs-popover__content--in-dialog": layeredInDialog.value }
+		]);
+		const panelStyle = computed(() => ({
+			position: positionMode.value,
+			top: `${box.value.top}px`,
+			left: `${box.value.left}px`,
+			"--rs-popover-radius": rsRadiusCss(resolvedRadius.value),
+			"--rs-popover-arrow-cross": arrowCross(props.align)
+		}));
+		let enterTimer;
+		let leaveTimer;
+		let blurTimer;
+		let frame = 0;
+		let overlayBound = false;
+		let movedFocus = false;
+		let restoreOnClose = false;
+		let pendingReason = null;
+		let openWatchReady = false;
+		let panelResize;
+		function arrowCross(align) {
+			if (align === "center") return "calc(50% - 0.25rem)";
+			if (align === "end") return "calc(100% - 1.25rem)";
+			return "0.75rem";
+		}
+		function clearTimer(kind) {
+			if (kind === "enter" && enterTimer) {
+				clearTimeout(enterTimer);
+				enterTimer = void 0;
+			}
+			if (kind === "leave" && leaveTimer) {
+				clearTimeout(leaveTimer);
+				leaveTimer = void 0;
+			}
+			if (kind === "blur" && blurTimer) {
+				clearTimeout(blurTimer);
+				blurTimer = void 0;
+			}
+		}
+		function clearHoverTimers() {
+			clearTimer("enter");
+			clearTimer("leave");
+		}
+		function setOpen(next, reason) {
+			if (props.disabled && next) return;
+			pendingReason = reason;
+			if (open.value === next) {
+				pendingReason = null;
+				return;
+			}
+			open.value = next;
+		}
+		function close() {
+			restoreOnClose = movedFocus;
+			setOpen(false, "script");
+		}
+		function focusTrigger() {
+			triggerEl.value?.focus();
+		}
+		function focusContent() {
+			const root = contentRef.value;
+			if (!root) return;
+			const target = listPopoverFocusable(root)[0] ?? root;
+			target.focus();
+			movedFocus = document.activeElement === target || root.contains(document.activeElement);
+		}
+		function assignTrigger(value) {
+			const node = resolvePopoverElement(value);
+			triggerEl.value = node;
+			if (node?.id) activeTriggerId.value = node.id;
+		}
+		function flattenPopoverNodes(nodes, out = []) {
+			if (nodes == null || typeof nodes === "boolean") return out;
+			if (Array.isArray(nodes)) {
+				for (const node of nodes) flattenPopoverNodes(node, out);
+				return out;
+			}
+			if (!isVNode(nodes)) return out;
+			if (nodes.type === Comment || nodes.type === Text) return out;
+			if (nodes.type === Fragment && Array.isArray(nodes.children)) {
+				flattenPopoverNodes(nodes.children, out);
+				return out;
+			}
+			out.push(nodes);
+			return out;
+		}
+		function isOwnedTarget(target) {
+			if (!(target instanceof Node)) return false;
+			const trigger = triggerEl.value;
+			if (trigger && (trigger === target || trigger.contains(target))) return true;
+			const content = contentRef.value;
+			if (content?.contains(target)) return true;
+			let node = target;
+			while (node) {
+				if (node instanceof HTMLElement && node.classList.contains("rs-popover__content")) {
+					const owner = node.dataset.rsPopoverTrigger;
+					const ownerTrigger = owner ? document.getElementById(owner) : null;
+					if (ownerTrigger && content?.contains(ownerTrigger)) return true;
+				}
+				node = node.parentNode;
+			}
+			return false;
+		}
+		function portalHost() {
+			const target = portalTarget.value;
+			if (typeof document === "undefined") return null;
+			if (typeof target !== "string") return target;
+			if (target === "body") return document.body;
+			return document.querySelector(target);
+		}
+		function syncPanelTheme() {
+			const el = triggerEl.value ?? rootRef.value;
+			const themed = el?.closest("[data-rs-theme]");
+			panelTheme.value = themed instanceof HTMLElement ? themed.dataset.rsTheme : void 0;
+			layeredInDialog.value = Boolean(el?.closest("dialog, [role=\"dialog\"], .rs-dialog"));
+		}
+		function placePopup() {
+			const trigger = triggerEl.value;
+			const content = contentRef.value;
+			if (!trigger || !content || !open.value || typeof window === "undefined") return;
+			const host = portalHost();
+			const viewportHost = !host || host === document.body || host === document.documentElement;
+			const triggerRect = trigger.getBoundingClientRect();
+			const popupRect = content.getBoundingClientRect();
+			const hostRect = viewportHost || !host ? null : host.getBoundingClientRect();
+			box.value = placeAlignedPopup({
+				top: host && hostRect ? triggerRect.top - hostRect.top + host.scrollTop : triggerRect.top,
+				left: host && hostRect ? triggerRect.left - hostRect.left + host.scrollLeft : triggerRect.left,
+				width: triggerRect.width,
+				height: triggerRect.height
+			}, {
+				width: popupRect.width || content.offsetWidth,
+				height: popupRect.height || content.offsetHeight
+			}, viewportHost ? {
+				width: window.innerWidth,
+				height: window.innerHeight
+			} : {
+				width: host?.clientWidth ?? window.innerWidth,
+				height: host?.clientHeight ?? window.innerHeight
+			}, {
+				side: props.side,
+				align: props.align,
+				sideOffset: props.sideOffset + (props.arrow ? 4 : 0),
+				alignOffset: props.alignOffset,
+				padding: 8,
+				rtl: isRtl.value
+			});
+			positionMode.value = viewportHost ? "fixed" : "absolute";
+		}
+		function requestPlace() {
+			if (typeof window === "undefined" || frame) return;
+			frame = window.requestAnimationFrame(() => {
+				frame = 0;
+				placePopup();
+			});
+		}
+		function onWindowChange() {
+			if (!open.value) return;
+			requestPlace();
+		}
+		function attachPanelObserver() {
+			if (typeof ResizeObserver === "undefined") return;
+			panelResize?.disconnect();
+			panelResize = void 0;
+			if (!contentRef.value || !open.value) return;
+			panelResize = new ResizeObserver(() => requestPlace());
+			panelResize.observe(contentRef.value);
+			if (triggerEl.value) panelResize.observe(triggerEl.value);
+		}
+		function onDocPointerDown(event) {
+			if (!props.closeOnOutside || !open.value) return;
+			if (isOwnedTarget(event.target)) return;
+			restoreOnClose = false;
+			setOpen(false, "script");
+		}
+		function onDocKeydown(event) {
+			if (!open.value || event.isComposing) return;
+			if (event.key === "Escape") {
+				if (!props.closeOnEsc) return;
+				event.preventDefault();
+				restoreOnClose = true;
+				setOpen(false, "script");
+				return;
+			}
+			if (!props.modal || event.key !== "Tab") return;
+			const root = contentRef.value;
+			if (!root) return;
+			const items = listPopoverFocusable(root);
+			event.preventDefault();
+			if (!items.length) {
+				root.focus();
+				return;
+			}
+			const active = document.activeElement;
+			const index = active instanceof HTMLElement ? items.indexOf(active) : -1;
+			items[nextPopoverFocusIndex(items.length, index, event.shiftKey)]?.focus();
+		}
+		function attachOverlay() {
+			if (overlayBound || typeof window === "undefined" || typeof document === "undefined") return;
+			overlayBound = true;
+			document.addEventListener("pointerdown", onDocPointerDown, true);
+			document.addEventListener("keydown", onDocKeydown, true);
+			window.addEventListener("resize", onWindowChange);
+			window.addEventListener("scroll", onWindowChange, true);
+		}
+		function detachOverlay() {
+			panelResize?.disconnect();
+			panelResize = void 0;
+			if (frame && typeof window !== "undefined") {
+				window.cancelAnimationFrame(frame);
+				frame = 0;
+			}
+			if (!overlayBound) return;
+			overlayBound = false;
+			if (typeof document !== "undefined") {
+				document.removeEventListener("pointerdown", onDocPointerDown, true);
+				document.removeEventListener("keydown", onDocKeydown, true);
+			}
+			if (typeof window !== "undefined") {
+				window.removeEventListener("resize", onWindowChange);
+				window.removeEventListener("scroll", onWindowChange, true);
+			}
+		}
+		function scheduleOpenLayout(moveFocus) {
+			nextTick(() => {
+				if (!open.value) return;
+				placePopup();
+				attachPanelObserver();
+				if (moveFocus) focusContent();
+			});
+		}
+		function onTriggerClick(event) {
+			if (!hasClick.value || props.disabled) return;
+			if (event && event.button !== 0) return;
+			if (open.value) {
+				restoreOnClose = false;
+				setOpen(false, "click");
+				return;
+			}
+			setOpen(true, "click");
+		}
+		function onTriggerKeydown(event) {
+			if (!hasClick.value || props.disabled || event.isComposing) return;
+			if (event.key !== "Enter" && event.key !== " ") return;
+			const tag = triggerEl.value?.tagName;
+			if (tag === "BUTTON" || tag === "A" || tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT") return;
+			event.preventDefault();
+			onTriggerClick(new MouseEvent("click", { button: 0 }));
+		}
+		function onTriggerEnter() {
+			if (!hasHover.value || props.disabled) return;
+			clearHoverTimers();
+			enterTimer = setTimeout(() => {
+				enterTimer = void 0;
+				setOpen(true, "hover");
+			}, enterDelay.value);
+		}
+		function onTriggerLeave() {
+			if (!hasHover.value) return;
+			clearTimer("enter");
+			clearTimer("leave");
+			leaveTimer = setTimeout(() => {
+				leaveTimer = void 0;
+				restoreOnClose = false;
+				setOpen(false, "hover");
+			}, leaveDelay.value);
+		}
+		function onContentEnter() {
+			if (hasHover.value) clearTimer("leave");
+		}
+		function onContentLeave() {
+			if (!hasHover.value) return;
+			clearTimer("leave");
+			leaveTimer = setTimeout(() => {
+				leaveTimer = void 0;
+				restoreOnClose = false;
+				setOpen(false, "hover");
+			}, leaveDelay.value);
+		}
+		function onTriggerFocus() {
+			if (!hasFocusTrigger.value || props.disabled) return;
+			clearTimer("blur");
+			setOpen(true, "focus");
+		}
+		function onTriggerBlur() {
+			if (!hasFocusTrigger.value) return;
+			clearTimer("blur");
+			blurTimer = setTimeout(() => {
+				blurTimer = void 0;
+				const active = document.activeElement;
+				if (active && isOwnedTarget(active)) return;
+				restoreOnClose = false;
+				setOpen(false, "focus");
+			}, 0);
+		}
+		function onContentFocusOut() {
+			if (!hasFocusTrigger.value || !open.value) return;
+			onTriggerBlur();
+		}
+		const TriggerHost = defineComponent({
+			name: "RsPopoverTrigger",
+			setup() {
+				return () => {
+					const nodes = flattenPopoverNodes(slots.default?.({
+						open: open.value,
+						close
+					}));
+					const target = nodes[0];
+					if (!target) return null;
+					const cloned = cloneVNode(target, {
+						id: typeof target.props?.id === "string" ? target.props.id : fallbackTriggerId,
+						ref: assignTrigger,
+						"aria-expanded": open.value ? "true" : "false",
+						"aria-controls": portalMounted.value ? contentId : void 0,
+						"aria-haspopup": "dialog",
+						onClick: onTriggerClick,
+						onKeydown: onTriggerKeydown,
+						onMouseenter: onTriggerEnter,
+						onMouseleave: onTriggerLeave,
+						onFocus: onTriggerFocus,
+						onBlur: onTriggerBlur
+					}, true);
+					return nodes.length === 1 ? cloned : [cloned, ...nodes.slice(1)];
+				};
+			}
+		});
+		watch(open, (isOpen) => {
+			const skipEvent = !openWatchReady;
+			openWatchReady = true;
+			const reason = pendingReason ?? "script";
+			pendingReason = null;
+			if (isOpen) {
+				if (props.disabled) {
+					open.value = false;
+					return;
+				}
+				const moveFocus = reason === "click" || reason === "script";
+				if (typeof document !== "undefined") {
+					syncPanelTheme();
+					attachOverlay();
+					scheduleOpenLayout(moveFocus);
+				}
+				if (!skipEvent) emit("openChange", true);
+				return;
+			}
+			detachOverlay();
+			clearHoverTimers();
+			clearTimer("blur");
+			const shouldRestore = restoreOnClose && movedFocus;
+			movedFocus = false;
+			restoreOnClose = false;
+			if (shouldRestore) focusTrigger();
+			if (!skipEvent) emit("openChange", false);
+		}, { immediate: true });
+		watch(() => [
+			props.side,
+			props.align,
+			props.sideOffset,
+			props.alignOffset,
+			props.arrow,
+			props.width,
+			isRtl.value
+		], () => {
+			if (open.value) requestPlace();
+		});
+		watch(() => props.disabled, (disabled) => {
+			if (disabled && open.value) {
+				restoreOnClose = false;
+				setOpen(false, "script");
+			}
+		});
+		watch(contentRef, (el) => {
+			if (!el || !open.value) return;
+			placePopup();
+			attachPanelObserver();
+		});
+		onUnmounted(() => {
+			detachOverlay();
+			clearHoverTimers();
+			clearTimer("blur");
+		});
+		__expose({
+			open: () => setOpen(true, "script"),
+			close,
+			toggle: () => {
+				if (open.value) close();
+				else setOpen(true, "script");
+			},
+			focus: () => focusTrigger()
+		});
 		return (_ctx, _cache) => {
-			return openBlock(), createBlock(unref(PopoverRoot), {
+			return openBlock(), createElementBlock(Fragment, null, [createElementVNode("span", mergeProps({
+				ref_key: "rootRef",
+				ref: rootRef,
+				class: "rs-popover"
+			}, unref(attrs), {
+				id: __props.id,
+				"data-disabled": __props.disabled ? "" : void 0
+			}), [createVNode(unref(TriggerHost))], 16, _hoisted_1), portalMounted.value ? (openBlock(), createBlock(Teleport, {
+				key: 0,
+				to: portalTarget.value
+			}, [createElementVNode("dialog", {
+				id: contentId,
+				ref_key: "contentRef",
+				ref: contentRef,
+				class: normalizeClass(["rs-popover__content rs-motion-reduce", contentClass.value]),
+				style: normalizeStyle(panelStyle.value),
 				open: open.value,
-				"onUpdate:open": _cache[0] || (_cache[0] = ($event) => open.value = $event),
-				modal: __props.modal
-			}, {
-				default: withCtx(() => [createVNode(unref(PopoverTrigger), { "as-child": "" }, {
-					default: withCtx(() => [renderSlot(_ctx.$slots, "default")]),
-					_: 3
-				}), portalMounted.value ? (openBlock(), createBlock(unref(PopoverPortal), { key: 0 }, {
-					default: withCtx(() => [createVNode(unref(PopoverContent), {
-						class: normalizeClass(["rs-popover__content", [`rs-popover__content--${__props.width}`, __props.popupClassName]]),
-						side: __props.side,
-						align: __props.align,
-						"side-offset": __props.sideOffset,
-						"force-mount": contentForceMount.value
-					}, {
-						default: withCtx(() => [renderSlot(_ctx.$slots, "content")]),
-						_: 3
-					}, 8, [
-						"class",
-						"side",
-						"align",
-						"side-offset",
-						"force-mount"
-					])]),
-					_: 3
-				})) : createCommentVNode("", true)]),
-				_: 3
-			}, 8, ["open", "modal"]);
+				hidden: !open.value ? true : void 0,
+				tabindex: open.value ? -1 : void 0,
+				"aria-modal": __props.modal && open.value ? "true" : void 0,
+				"aria-labelledby": hasTitle.value && open.value ? titleId : void 0,
+				"aria-label": hasTitle.value ? void 0 : dialogLabel.value,
+				"data-side": box.value.side,
+				"data-align": __props.align,
+				"data-rs-theme": panelTheme.value,
+				"data-rs-popover-trigger": activeTriggerId.value,
+				onCancel: _cache[0] || (_cache[0] = withModifiers(() => {}, ["prevent"])),
+				onMouseenter: onContentEnter,
+				onMouseleave: onContentLeave,
+				onFocusout: onContentFocusOut
+			}, [
+				__props.arrow ? (openBlock(), createElementBlock("span", _hoisted_3)) : createCommentVNode("", true),
+				showChrome.value ? (openBlock(), createElementBlock("div", _hoisted_4, [hasTitle.value ? (openBlock(), createElementBlock("div", {
+					key: 0,
+					id: titleId,
+					class: "rs-popover__title"
+				}, [renderSlot(_ctx.$slots, "title", {}, () => [createTextVNode(toDisplayString(__props.title), 1)], true)])) : createCommentVNode("", true), __props.showClose ? (openBlock(), createElementBlock("button", {
+					key: 1,
+					type: "button",
+					class: "rs-popover__close",
+					"aria-label": closeLabel.value,
+					onClick: close
+				}, [createVNode(RsIcon_default, {
+					name: "x",
+					size: 14
+				})], 8, _hoisted_5)) : createCommentVNode("", true)])) : createCommentVNode("", true),
+				createElementVNode("div", _hoisted_6, [renderSlot(_ctx.$slots, "content", { close }, void 0, true)])
+			], 46, _hoisted_2)], 8, ["to"])) : createCommentVNode("", true)], 64);
 		};
 	}
 });

package/dist/components/popover/src/RsPopover.js

@@ -1,7 +1,8 @@
 import './RsPopover.css'
+import _plugin_vue_export_helper_default from "../../../_virtual/_plugin-vue_export-helper.js";
 import RsPopover_vue_vue_type_script_setup_true_lang_default from "./RsPopover.impl.js";
 
 //#region src/components/popover/src/RsPopover.vue
-var RsPopover_default = RsPopover_vue_vue_type_script_setup_true_lang_default;
+var RsPopover_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsPopover_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-4709e2b1"]]);
 //#endregion
 export { RsPopover_default as default };

package/dist/components/popover/src/popover-utils.d.ts

@@ -1,6 +1,28 @@
-/** Popover 弹出方位 */
+/** Popover 弹出方位。left / right 是物理方向，不跟 RTL 对调。 */
 export type RsPopoverSide = 'top' | 'right' | 'bottom' | 'left';
-/** Popover 对齐方式 */
+/** Popover 交叉轴对齐。横向 start / end 在 RTL 对调。 */
 export type RsPopoverAlign = 'start' | 'center' | 'end';
 /** Popover 内容宽度档位 */
 export type RsPopoverWidth = 'sm' | 'md' | 'lg' | 'auto';
+/** 打开方式。可组合，默认只有 click，和原来点一下开关一致。 */
+export type RsPopoverTrigger = 'click' | 'hover' | 'focus';
+/** 浮层挂载点。返回空时回到 document.body。 */
+export type RsPopoverGetPopupContainer = (trigger?: HTMLElement) => HTMLElement | string | null | undefined;
+/** 宿主可调用的命令。 */
+export interface RsPopoverExpose {
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    focus: () => void;
+}
+export type RsPopoverInstance = RsPopoverExpose;
+/** hover 延迟上限，避免一个超大定时器一直挂着。 */
+export declare const RS_POPOVER_DELAY_MAX = 60000;
+export declare function normalizePopoverTriggers(trigger: RsPopoverTrigger | readonly RsPopoverTrigger[] | undefined): RsPopoverTrigger[];
+export declare function clampPopoverDelay(value: number | undefined, fallback: number): number;
+/** Tab 在浮层内循环。current < 0 时落到第一项或最后一项。 */
+export declare function nextPopoverFocusIndex(count: number, current: number, shift: boolean): number;
+export declare function resolvePopoverPortalTarget(getPopupContainer: RsPopoverGetPopupContainer | undefined, trigger?: HTMLElement | null): string | HTMLElement;
+/** 组件 ref 可能是元素，也可能是带 $el 的实例。无 DOM 时返回空。 */
+export declare function resolvePopoverElement(value: unknown): HTMLElement | null;
+export declare function listPopoverFocusable(root: ParentNode | null | undefined): HTMLElement[];