bkui-vue 2.1.0-dev-beta.13 → 2.1.0-dev-beta.14

package/lib/popover/index.js

@@ -45,7 +45,7 @@ const shared_namespaceObject = x({ ["PlacementEnum"]: () => __WEBPACK_EXTERNAL_M
 ;// CONCATENATED MODULE: external "vue"
 var external_vue_x = y => { var x = {}; __webpack_require__.d(x, y); return x; }
 var external_vue_y = x => () => x
-const external_vue_namespaceObject = external_vue_x({ ["Fragment"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.Fragment, ["Teleport"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.Teleport, ["computed"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.computed, ["createApp"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.createApp, ["createVNode"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.createVNode, ["defineComponent"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.defineComponent, ["getCurrentScope"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.getCurrentScope, ["h"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.h, ["isVNode"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.isVNode, ["mergeProps"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.mergeProps, ["nextTick"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.nextTick, ["onBeforeUnmount"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.onBeforeUnmount, ["onMounted"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.onMounted, ["onScopeDispose"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.onScopeDispose, ["reactive"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.reactive, ["ref"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.ref, ["shallowReadonly"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.shallowReadonly, ["shallowRef"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.shallowRef, ["toRefs"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.toRefs, ["unref"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.unref, ["useAttrs"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.useAttrs, ["watch"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.watch });
+const external_vue_namespaceObject = external_vue_x({ ["Comment"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.Comment, ["Fragment"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.Fragment, ["Teleport"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.Teleport, ["Text"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.Text, ["cloneVNode"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.cloneVNode, ["computed"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.computed, ["createApp"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.createApp, ["createVNode"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.createVNode, ["defineComponent"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.defineComponent, ["getCurrentScope"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.getCurrentScope, ["h"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.h, ["isVNode"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.isVNode, ["mergeProps"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.mergeProps, ["nextTick"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.nextTick, ["onBeforeUnmount"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.onBeforeUnmount, ["onMounted"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.onMounted, ["onScopeDispose"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.onScopeDispose, ["reactive"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.reactive, ["ref"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.ref, ["shallowReadonly"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.shallowReadonly, ["shallowRef"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.shallowRef, ["toRefs"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.toRefs, ["unref"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.unref, ["useAttrs"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.useAttrs, ["watch"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.watch });
 ;// CONCATENATED MODULE: ../../node_modules/@babel/runtime/helpers/esm/arrayLikeToArray.js
 function _arrayLikeToArray(r, a) {
   (null == a || a > r.length) && (a = r.length);
@@ -134,7 +134,7 @@ function _defineProperty(e, r, t) {
 ;// CONCATENATED MODULE: external "../config-provider"
 var config_provider_x = y => { var x = {}; __webpack_require__.d(x, y); return x; }
 var config_provider_y = x => () => x
-const config_provider_namespaceObject = config_provider_x({ ["usePrefix"]: () => __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_config_provider_fe8577a3__.usePrefix });
+const config_provider_namespaceObject = config_provider_x({ ["useGlobalConfig"]: () => __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_config_provider_fe8577a3__.useGlobalConfig, ["usePrefix"]: () => __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_config_provider_fe8577a3__.usePrefix });
 ;// CONCATENATED MODULE: ../../node_modules/@babel/runtime/helpers/esm/arrayWithHoles.js
 function _arrayWithHoles(r) {
   if (Array.isArray(r)) return r;
@@ -3190,6 +3190,10 @@ var PopoverProps = {
    * 配置自定义样式类名，传入的类会被加在 Reference 外部的 div 上
    */
   referenceCls: shared_namespaceObject.PropTypes.string.def(''),
+  /**
+   * 是否渲染默认插槽最外层 reference span；false 时不主动追加 span
+   */
+  renderReferenceWrapper: shared_namespaceObject.PropTypes.bool.def(undefined),
   /**
    * 点击 Reference 占位区是否忽略收起 popover
    */
@@ -3251,8 +3255,7 @@ function _isSlot(s) {
 var __bkPopoverIdSeed = 0;
 var __bkPopoverRegistry = new Map();
 var findPopoverIdInEventPath = function findPopoverIdInEventPath(event) {
-  var anyEvent = event;
-  var path = typeof anyEvent.composedPath === 'function' ? anyEvent.composedPath() : [];
+  var path = typeof event.composedPath === 'function' ? event.composedPath() : [];
   var _iterator = _createForOfIteratorHelper(path),
     _step;
   try {
@@ -3313,6 +3316,7 @@ var EMIT_EVENTS = {
     var attrs = (0,external_vue_namespaceObject.useAttrs)();
     var _usePrefix = (0,config_provider_namespaceObject.usePrefix)(),
       resolveClassName = _usePrefix.resolveClassName;
+    var globalConfig = (0,config_provider_namespaceObject.useGlobalConfig)();
     // 当前实例 id（用于注册表与事件路径识别）
     var popoverId = "bk-popover-".concat(++__bkPopoverIdSeed);
     // 元素引用
@@ -3357,7 +3361,21 @@ var EMIT_EVENTS = {
       componentEventDelay = _toRefs.componentEventDelay,
       reference = _toRefs.reference,
       target = _toRefs.target,
-      floatingReference = _toRefs.floatingReference;
+      floatingReference = _toRefs.floatingReference,
+      renderReferenceWrapper = _toRefs.renderReferenceWrapper;
+    var isReferenceWrapperDisabled = (0,external_vue_namespaceObject.computed)(function () {
+      if (renderReferenceWrapper.value !== undefined) {
+        return renderReferenceWrapper.value === false;
+      }
+      var globalValue = globalConfig.value.popoverRenderReferenceWrapper;
+      if (globalValue !== undefined) {
+        return globalValue === false;
+      }
+      return false;
+    });
+    var setReferenceRef = function setReferenceRef(refValue) {
+      referenceWrapperRef.value = refValue;
+    };
     // 判断是否为虚拟元素
     var isVirtualElement = function isVirtualElement(el) {
       return el !== null && _typeof(el) === 'object' && 'getBoundingClientRect' in el && typeof el.getBoundingClientRect === 'function';
@@ -3377,6 +3395,47 @@ var EMIT_EVENTS = {
       }
       return null;
     };
+    var _resolveElementFromVNode = function resolveElementFromVNode(node) {
+      var _node$component;
+      if (!node) return null;
+      if (node.el instanceof HTMLElement) return node.el;
+      var subTree = (_node$component = node.component) === null || _node$component === void 0 ? void 0 : _node$component.subTree;
+      if (subTree) {
+        var element = _resolveElementFromVNode(subTree);
+        if (element) return element;
+      }
+      if (Array.isArray(node.children)) {
+        var _iterator2 = _createForOfIteratorHelper(node.children),
+          _step2;
+        try {
+          for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+            var child = _step2.value;
+            if (!(0,external_vue_namespaceObject.isVNode)(child)) continue;
+            var _element = _resolveElementFromVNode(child);
+            if (_element) return _element;
+          }
+        } catch (err) {
+          _iterator2.e(err);
+        } finally {
+          _iterator2.f();
+        }
+      }
+      return null;
+    };
+    var resolveReferenceRefElement = function resolveReferenceRefElement(refValue) {
+      var _instance$$;
+      if (refValue instanceof HTMLElement) {
+        return refValue;
+      }
+      if (!refValue || _typeof(refValue) !== 'object') {
+        return null;
+      }
+      var instance = refValue;
+      if (instance.$el instanceof HTMLElement) {
+        return instance.$el;
+      }
+      return _resolveElementFromVNode((_instance$$ = instance.$) === null || _instance$$ === void 0 ? void 0 : _instance$$.subTree);
+    };
     // 是否使用自定义 reference
     var useCustomReference = (0,external_vue_namespaceObject.computed)(function () {
       return !!reference.value || !!target.value;
@@ -3431,8 +3490,11 @@ var EMIT_EVENTS = {
      * 策略：优先使用第一个元素子节点作为 reference；否则向下寻找第一个具有可见尺寸的 HTMLElement。
      */
     var resolveDefaultReferenceElement = function resolveDefaultReferenceElement() {
-      var wrapper = referenceWrapperRef.value;
+      var wrapper = resolveReferenceRefElement(referenceWrapperRef.value);
       if (!wrapper) return null;
+      if (isReferenceWrapperDisabled.value) {
+        return wrapper;
+      }
       // display: contents 的元素自身尺寸为 0，直接查找子元素
       var firstChild = wrapper.firstElementChild;
       if (firstChild instanceof HTMLElement) {
@@ -3540,7 +3602,7 @@ var EMIT_EVENTS = {
     }, function () {
       return floatingReference.value;
     }], function () {
-      return (0,external_vue_namespaceObject.nextTick)(updateFloatingReference);
+      (0,external_vue_namespaceObject.nextTick)(updateFloatingReference);
     });
     (0,external_vue_namespaceObject.watch)(isOpen, function (val) {
       if (val) {
@@ -3576,6 +3638,42 @@ var EMIT_EVENTS = {
       }),
       referenceListeners = _useTrigger.referenceListeners,
       floatingListeners = _useTrigger.floatingListeners;
+    var unbindNoWrapperReferenceEvents = [];
+    var clearNoWrapperReferenceEvents = function clearNoWrapperReferenceEvents() {
+      unbindNoWrapperReferenceEvents.forEach(function (unbind) {
+        return unbind();
+      });
+      unbindNoWrapperReferenceEvents = [];
+    };
+    var resolveEventBinding = function resolveEventBinding(eventName) {
+      var rawName = eventName.replace(/^on/, '');
+      var capture = rawName.endsWith('Capture');
+      return {
+        capture: capture,
+        name: rawName.replace(/Capture$/, '').toLowerCase()
+      };
+    };
+    var bindNoWrapperReferenceEvents = function bindNoWrapperReferenceEvents() {
+      clearNoWrapperReferenceEvents();
+      if (!isReferenceWrapperDisabled.value) return;
+      var referenceEl = resolveReferenceRefElement(referenceWrapperRef.value);
+      if (!referenceEl) return;
+      Object.keys(referenceListeners.value).forEach(function (eventName) {
+        var listener = referenceListeners.value[eventName];
+        var eventBinding = resolveEventBinding(eventName);
+        referenceEl.addEventListener(eventBinding.name, listener, eventBinding.capture);
+        unbindNoWrapperReferenceEvents.push(function () {
+          referenceEl.removeEventListener(eventBinding.name, listener, eventBinding.capture);
+        });
+      });
+    };
+    (0,external_vue_namespaceObject.watch)([isReferenceWrapperDisabled, referenceWrapperRef, function () {
+      return referenceListeners.value;
+    }], function () {
+      (0,external_vue_namespaceObject.nextTick)(bindNoWrapperReferenceEvents);
+    }, {
+      immediate: true
+    });
     // hover 模式：把“子弹层”视为内容区的延伸（避免 PopConfirm 内 Select 下拉导致父弹层收起）
     var hoverTrackMoveHandler = null;
     var stopHoverTrack = function stopHoverTrack() {
@@ -3584,9 +3682,10 @@ var EMIT_EVENTS = {
       hoverTrackMoveHandler = null;
     };
     var isTargetInSelfOrChildren = function isTargetInSelfOrChildren(targetEl) {
-      var _referenceWrapperRef$, _floatingRef$value;
+      var _floatingRef$value;
       var actualRef = floatingReferenceRef.value;
-      if (actualRef instanceof HTMLElement && actualRef.contains(targetEl) || (_referenceWrapperRef$ = referenceWrapperRef.value) !== null && _referenceWrapperRef$ !== void 0 && _referenceWrapperRef$.contains(targetEl)) {
+      var referenceWrapperEl = isReferenceWrapperDisabled.value ? null : resolveReferenceRefElement(referenceWrapperRef.value);
+      if (actualRef instanceof HTMLElement && actualRef.contains(targetEl) || referenceWrapperEl instanceof HTMLElement && referenceWrapperEl.contains(targetEl)) {
         return true;
       }
       if ((_floatingRef$value = floatingRef.value) !== null && _floatingRef$value !== void 0 && _floatingRef$value.contains(targetEl)) {
@@ -3698,9 +3797,36 @@ var EMIT_EVENTS = {
     var dataTheme = (0,external_vue_namespaceObject.computed)(function () {
       return theme.value;
     });
+    var _filterEmptyNodes = function filterEmptyNodes() {
+      var children = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+      var nodes = [];
+      children.forEach(function (child) {
+        if (!child) {
+          return;
+        }
+        if (Array.isArray(child)) {
+          nodes.push.apply(nodes, _toConsumableArray(_filterEmptyNodes(child)));
+          return;
+        }
+        if (child.type === external_vue_namespaceObject.Fragment && Array.isArray(child.children)) {
+          nodes.push.apply(nodes, _toConsumableArray(_filterEmptyNodes(child.children)));
+          return;
+        }
+        nodes.push(child);
+      });
+      return nodes.filter(function (child) {
+        var _child$children;
+        return !(child && (child.type === external_vue_namespaceObject.Comment || child.type === external_vue_namespaceObject.Fragment && Array.isArray(child.children) && child.children.length === 0 || child.type === external_vue_namespaceObject.Text && "".concat((_child$children = child.children) !== null && _child$children !== void 0 ? _child$children : '').trim() === ''));
+      });
+    };
+    var hasElementNode = function hasElementNode(nodes) {
+      return nodes.some(function (node) {
+        return node.type !== external_vue_namespaceObject.Text && node.type !== external_vue_namespaceObject.Comment;
+      });
+    };
     // 处理 clickoutside
     var handleClickOutside = function handleClickOutside(event) {
-      var _referenceWrapperRef$2, _floatingRef$value2;
+      var _floatingRef$value2;
       if (disabled.value || always.value) {
         return;
       }
@@ -3711,7 +3837,8 @@ var EMIT_EVENTS = {
       var target = event.target;
       // 点击在 reference 内（包括自定义 reference 和默认 reference）
       var actualRef = floatingReferenceRef.value;
-      var isInReference = actualRef instanceof HTMLElement && actualRef.contains(target) || ((_referenceWrapperRef$2 = referenceWrapperRef.value) === null || _referenceWrapperRef$2 === void 0 ? void 0 : _referenceWrapperRef$2.contains(target));
+      var referenceWrapperEl = isReferenceWrapperDisabled.value ? null : resolveReferenceRefElement(referenceWrapperRef.value);
+      var isInReference = actualRef instanceof HTMLElement && actualRef.contains(target) || referenceWrapperEl instanceof HTMLElement && referenceWrapperEl.contains(target);
       if (isInReference) {
         // 对于 click 和 hover 模式，点击 reference 的行为由 referenceListeners 处理
         if (trigger.value === 'click' || trigger.value === 'hover') {
@@ -3781,38 +3908,35 @@ var EMIT_EVENTS = {
       }
       return isOpen.value;
     });
-    // 为自定义 reference 元素添加事件监听（仅对 HTMLElement 有效，虚拟元素不绑定事件）
-    var bindCustomReferenceEvents = function bindCustomReferenceEvents() {
-      if (!useCustomReference.value || isVirtualReferenceMode.value) return;
-      var customRef = getActualReferenceElement();
-      if (!customRef) return;
-      var listeners = referenceListeners.value;
-      Object.keys(listeners).forEach(function (eventName) {
-        // 将 onMouseenter 转换为 mouseenter
-        var nativeEventName = eventName.replace(/^on/, '').toLowerCase();
-        customRef.addEventListener(nativeEventName, listeners[eventName]);
+    var unbindCustomReferenceEvents = [];
+    var clearCustomReferenceEvents = function clearCustomReferenceEvents() {
+      unbindCustomReferenceEvents.forEach(function (unbind) {
+        return unbind();
       });
+      unbindCustomReferenceEvents = [];
     };
-    var unbindCustomReferenceEvents = function unbindCustomReferenceEvents() {
+    var bindCustomReferenceEvents = function bindCustomReferenceEvents() {
+      clearCustomReferenceEvents();
       if (!useCustomReference.value || isVirtualReferenceMode.value) return;
       var customRef = getActualReferenceElement();
       if (!customRef) return;
-      var listeners = referenceListeners.value;
-      Object.keys(listeners).forEach(function (eventName) {
-        var nativeEventName = eventName.replace(/^on/, '').toLowerCase();
-        customRef.removeEventListener(nativeEventName, listeners[eventName]);
+      Object.keys(referenceListeners.value).forEach(function (eventName) {
+        var listener = referenceListeners.value[eventName];
+        var eventBinding = resolveEventBinding(eventName);
+        customRef.addEventListener(eventBinding.name, listener, eventBinding.capture);
+        unbindCustomReferenceEvents.push(function () {
+          customRef.removeEventListener(eventBinding.name, listener, eventBinding.capture);
+        });
       });
     };
-    // 监听自定义 reference 变化
     (0,external_vue_namespaceObject.watch)([function () {
       return reference.value;
     }, function () {
       return target.value;
+    }, function () {
+      return referenceListeners.value;
     }], function () {
-      unbindCustomReferenceEvents();
-      (0,external_vue_namespaceObject.nextTick)(function () {
-        bindCustomReferenceEvents();
-      });
+      (0,external_vue_namespaceObject.nextTick)(bindCustomReferenceEvents);
     });
     // 挂载时添加 clickoutside 监听
     (0,external_vue_namespaceObject.onMounted)(function () {
@@ -3829,7 +3953,8 @@ var EMIT_EVENTS = {
     // 卸载时清理
     (0,external_vue_namespaceObject.onBeforeUnmount)(function () {
       document.removeEventListener('click', handleClickOutside, true);
-      unbindCustomReferenceEvents();
+      clearCustomReferenceEvents();
+      clearNoWrapperReferenceEvents();
       clearTimers();
       if (eventDelayTimer) {
         clearTimeout(eventDelayTimer);
@@ -3848,7 +3973,7 @@ var EMIT_EVENTS = {
         id: popoverId,
         floatingEl: floatingRef.value,
         referenceEl: referenceEl,
-        referenceWrapperEl: referenceWrapperRef.value
+        referenceWrapperEl: isReferenceWrapperDisabled.value ? null : resolveReferenceRefElement(referenceWrapperRef.value)
       });
     };
     (0,external_vue_namespaceObject.watch)([floatingRef, floatingReferenceRef, referenceWrapperRef], function () {
@@ -3900,7 +4025,7 @@ var EMIT_EVENTS = {
       return boundaryVal instanceof HTMLElement ? boundaryVal : 'body';
     });
     return function () {
-      var _slots$arrow, _slots$content, _slots$content2, _slots$default;
+      var _slots$arrow, _slots$content, _slots$content2, _slots$default, _slots$default2;
       // 渲染 floating content
       var floatingNode = shouldRenderContent.value ? (0,external_vue_namespaceObject.createVNode)("div", (0,external_vue_namespaceObject.mergeProps)({
         "ref": floatingRef,
@@ -3908,9 +4033,9 @@ var EMIT_EVENTS = {
           pointerEvents: contentPointerEvents.value
         }),
         "class": contentClass.value,
+        "data-arrow": arrowSide.value,
         "data-bk-popover-id": popoverId,
         "data-theme": dataTheme.value,
-        "data-arrow": arrowSide.value,
         "onClick": handleClickContent
       }, guardedFloatingListeners.value), [arrow.value && (0,external_vue_namespaceObject.createVNode)("div", {
         "ref": arrowRef,
@@ -3918,8 +4043,7 @@ var EMIT_EVENTS = {
         "class": resolveClassName('pop2-arrow'),
         "data-arrow": arrowSide.value
       }, [(_slots$arrow = slots.arrow) === null || _slots$arrow === void 0 ? void 0 : _slots$arrow.call(slots)]), (_slots$content = (_slots$content2 = slots.content) === null || _slots$content2 === void 0 ? void 0 : _slots$content2.call(slots)) !== null && _slots$content !== void 0 ? _slots$content : renderContent()]) : null;
-      // 如果使用自定义 reference（虚拟元素或外部 HTMLElement），只渲染 Teleport 内容
-      if (useCustomReference.value) {
+      var renderTeleport = function renderTeleport() {
         return (0,external_vue_namespaceObject.createVNode)(external_vue_namespaceObject.Teleport, {
           "disabled": disableTeleport.value,
           "to": teleportTo.value
@@ -3928,25 +4052,51 @@ var EMIT_EVENTS = {
             return [floatingNode];
           }
         });
+      };
+      // 如果使用自定义 reference（虚拟元素或外部 HTMLElement），只渲染 Teleport 内容
+      if (useCustomReference.value) {
+        return renderTeleport();
       }
-      // 默认情况：渲染 reference 和 floating content
-      // 使用 display: contents 避免影响内部元素布局
-      return (0,external_vue_namespaceObject.createVNode)(external_vue_namespaceObject.Fragment, null, [(0,external_vue_namespaceObject.createVNode)("span", (0,external_vue_namespaceObject.mergeProps)({
-        "ref": referenceWrapperRef,
-        "style": {
-          display: 'contents',
-          width: '100%',
-          height: '100%'
-        },
-        "class": [referenceCls.value, attrs["class"]]
-      }, referenceListeners.value), [(_slots$default = slots["default"]) === null || _slots$default === void 0 ? void 0 : _slots$default.call(slots)]), (0,external_vue_namespaceObject.createVNode)(external_vue_namespaceObject.Teleport, {
-        "disabled": disableTeleport.value,
-        "to": teleportTo.value
-      }, _isSlot(floatingNode) ? floatingNode : {
-        "default": function _default() {
-          return [floatingNode];
+      var defaultSlotNodes = (_slots$default = (_slots$default2 = slots["default"]) === null || _slots$default2 === void 0 ? void 0 : _slots$default2.call(slots)) !== null && _slots$default !== void 0 ? _slots$default : [];
+      var referenceNodes = _filterEmptyNodes(defaultSlotNodes);
+      var useContentsWrapper = hasElementNode(referenceNodes);
+      if (!isReferenceWrapperDisabled.value) {
+        return (0,external_vue_namespaceObject.createVNode)(external_vue_namespaceObject.Fragment, null, [(0,external_vue_namespaceObject.createVNode)("span", (0,external_vue_namespaceObject.mergeProps)({
+          "ref": referenceWrapperRef,
+          "style": useContentsWrapper ? {
+            display: 'contents'
+          } : {
+            display: 'inline-block'
+          },
+          "class": [referenceCls.value, attrs["class"]]
+        }, referenceListeners.value), [defaultSlotNodes]), renderTeleport()]);
+      }
+      var renderReferenceNode = function renderReferenceNode() {
+        if (!referenceNodes.length) {
+          return null;
         }
-      })]);
+        // 无包裹模式下，只有“单个非文本 VNode”可以保持原 DOM 结构不变。
+        // 文本节点或多个节点没有唯一 HTMLElement 可作为 floating reference，必须降级为 span。
+        if (referenceNodes.length > 1 || referenceNodes[0].type === external_vue_namespaceObject.Text) {
+          return (0,external_vue_namespaceObject.createVNode)("span", {
+            "ref": setReferenceRef,
+            "style": {
+              display: 'inline-block'
+            },
+            "class": [referenceCls.value, attrs["class"]]
+          }, [referenceNodes]);
+        }
+        var referenceNode = referenceNodes[0];
+        if (!(0,external_vue_namespaceObject.isVNode)(referenceNode) || referenceNode.type === external_vue_namespaceObject.Comment) {
+          return referenceNode;
+        }
+        return (0,external_vue_namespaceObject.cloneVNode)(referenceNode, {
+          ref: setReferenceRef,
+          "class": [referenceCls.value, attrs["class"]]
+        }, true);
+      };
+      // 默认情况：渲染 reference 和 floating content
+      return (0,external_vue_namespaceObject.createVNode)(external_vue_namespaceObject.Fragment, null, [renderReferenceNode(), renderTeleport()]);
     };
   }
 }));

package/lib/popover/popover.d.ts

@@ -131,6 +131,11 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     } & {
         default: string;
     };
+    renderReferenceWrapper: import("vue-types").VueTypeValidableDef<boolean> & {
+        default: boolean;
+    } & {
+        default: boolean;
+    };
     hideIgnoreReference: import("vue-types").VueTypeValidableDef<boolean> & {
         default: boolean;
     } & {
@@ -279,6 +284,11 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     } & {
         default: string;
     };
+    renderReferenceWrapper: import("vue-types").VueTypeValidableDef<boolean> & {
+        default: boolean;
+    } & {
+        default: boolean;
+    };
     hideIgnoreReference: import("vue-types").VueTypeValidableDef<boolean> & {
         default: boolean;
     } & {
@@ -335,6 +345,7 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     popoverDelay: number | number[];
     extCls: string;
     referenceCls: string;
+    renderReferenceWrapper: boolean;
     hideIgnoreReference: boolean;
     componentEventDelay: number;
     forceClickoutside: boolean;

package/lib/popover/props.d.ts

@@ -180,6 +180,14 @@ export declare const PopoverProps: {
     } & {
         default: string;
     };
+    /**
+     * 是否渲染默认插槽最外层 reference span；false 时不主动追加 span
+     */
+    renderReferenceWrapper: import("vue-types").VueTypeValidableDef<boolean> & {
+        default: boolean;
+    } & {
+        default: boolean;
+    };
     /**
      * 点击 Reference 占位区是否忽略收起 popover
      */

package/lib/preset.d.ts

@@ -139,6 +139,10 @@ declare const _default: {
                 };
             }>;
         };
+        popoverRenderReferenceWrapper: {
+            type: import("vue").PropType<boolean>;
+            default: any;
+        };
         prefix: {
             type: StringConstructor;
             default: string;
@@ -283,6 +287,10 @@ declare const _default: {
                 };
             }>;
         };
+        popoverRenderReferenceWrapper: {
+            type: import("vue").PropType<boolean>;
+            default: any;
+        };
         prefix: {
             type: StringConstructor;
             default: string;

package/lib/select/index.d.ts

@@ -250,6 +250,11 @@ declare const BkSelect: {
             } & {
                 default: string;
             };
+            renderReferenceWrapper: import("vue-types").VueTypeValidableDef<boolean> & {
+                default: boolean;
+            } & {
+                default: boolean;
+            };
             hideIgnoreReference: import("vue-types").VueTypeValidableDef<boolean> & {
                 default: boolean;
             } & {
@@ -455,7 +460,7 @@ declare const BkSelect: {
             handleInput: (e: any) => void;
             handleKeydown: (e: any) => void;
             resolveClassName: (cls: string) => string;
-        }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("keydown" | "enter" | "update:modelValue" | "remove")[], import("vue").PublicProps, {
+        }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("keydown" | "remove" | "enter" | "update:modelValue")[], import("vue").PublicProps, {
             disabled: boolean;
             placeholder: string;
             tagTheme: "" | "danger" | "success" | "warning" | "info";
@@ -598,7 +603,7 @@ declare const BkSelect: {
             handleInput: (e: any) => void;
             handleKeydown: (e: any) => void;
             resolveClassName: (cls: string) => string;
-        }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("keydown" | "enter" | "update:modelValue" | "remove")[], import("vue").PublicProps, {
+        }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("keydown" | "remove" | "enter" | "update:modelValue")[], import("vue").PublicProps, {
             disabled: boolean;
             placeholder: string;
             tagTheme: "" | "danger" | "success" | "warning" | "info";
@@ -833,6 +838,11 @@ declare const BkSelect: {
             } & {
                 default: string;
             };
+            renderReferenceWrapper: import("vue-types").VueTypeValidableDef<boolean> & {
+                default: boolean;
+            } & {
+                default: boolean;
+            };
             hideIgnoreReference: import("vue-types").VueTypeValidableDef<boolean> & {
                 default: boolean;
             } & {
@@ -895,6 +905,7 @@ declare const BkSelect: {
         multiple: boolean;
         disabled: boolean;
         trigger: "default" | "manual";
+        scrollHeight: number;
         minHeight: number;
         showOnInit: boolean;
         loading: boolean;
@@ -903,7 +914,6 @@ declare const BkSelect: {
         tagTheme: "" | "danger" | "success" | "warning" | "info";
         behavior: "normal" | "simplicity";
         selectedStyle: "checkbox" | "check";
-        scrollHeight: number;
         clearable: boolean;
         withValidate: boolean;
         noDataText: string;
@@ -1192,6 +1202,11 @@ declare const BkSelect: {
             } & {
                 default: string;
             };
+            renderReferenceWrapper: import("vue-types").VueTypeValidableDef<boolean> & {
+                default: boolean;
+            } & {
+                default: boolean;
+            };
             hideIgnoreReference: import("vue-types").VueTypeValidableDef<boolean> & {
                 default: boolean;
             } & {
@@ -1397,7 +1412,7 @@ declare const BkSelect: {
             handleInput: (e: any) => void;
             handleKeydown: (e: any) => void;
             resolveClassName: (cls: string) => string;
-        }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("keydown" | "enter" | "update:modelValue" | "remove")[], import("vue").PublicProps, {
+        }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("keydown" | "remove" | "enter" | "update:modelValue")[], import("vue").PublicProps, {
             disabled: boolean;
             placeholder: string;
             tagTheme: "" | "danger" | "success" | "warning" | "info";
@@ -1540,7 +1555,7 @@ declare const BkSelect: {
             handleInput: (e: any) => void;
             handleKeydown: (e: any) => void;
             resolveClassName: (cls: string) => string;
-        }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("keydown" | "enter" | "update:modelValue" | "remove")[], import("vue").PublicProps, {
+        }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("keydown" | "remove" | "enter" | "update:modelValue")[], import("vue").PublicProps, {
             disabled: boolean;
             placeholder: string;
             tagTheme: "" | "danger" | "success" | "warning" | "info";
@@ -1775,6 +1790,11 @@ declare const BkSelect: {
             } & {
                 default: string;
             };
+            renderReferenceWrapper: import("vue-types").VueTypeValidableDef<boolean> & {
+                default: boolean;
+            } & {
+                default: boolean;
+            };
             hideIgnoreReference: import("vue-types").VueTypeValidableDef<boolean> & {
                 default: boolean;
             } & {
@@ -1837,6 +1857,7 @@ declare const BkSelect: {
         multiple: boolean;
         disabled: boolean;
         trigger: "default" | "manual";
+        scrollHeight: number;
         minHeight: number;
         showOnInit: boolean;
         loading: boolean;
@@ -1845,7 +1866,6 @@ declare const BkSelect: {
         tagTheme: "" | "danger" | "success" | "warning" | "info";
         behavior: "normal" | "simplicity";
         selectedStyle: "checkbox" | "check";
-        scrollHeight: number;
         clearable: boolean;
         withValidate: boolean;
         noDataText: string;
@@ -2129,6 +2149,11 @@ declare const BkSelect: {
         } & {
             default: string;
         };
+        renderReferenceWrapper: import("vue-types").VueTypeValidableDef<boolean> & {
+            default: boolean;
+        } & {
+            default: boolean;
+        };
         hideIgnoreReference: import("vue-types").VueTypeValidableDef<boolean> & {
             default: boolean;
         } & {
@@ -2334,7 +2359,7 @@ declare const BkSelect: {
         handleInput: (e: any) => void;
         handleKeydown: (e: any) => void;
         resolveClassName: (cls: string) => string;
-    }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("keydown" | "enter" | "update:modelValue" | "remove")[], import("vue").PublicProps, {
+    }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("keydown" | "remove" | "enter" | "update:modelValue")[], import("vue").PublicProps, {
         disabled: boolean;
         placeholder: string;
         tagTheme: "" | "danger" | "success" | "warning" | "info";
@@ -2477,7 +2502,7 @@ declare const BkSelect: {
         handleInput: (e: any) => void;
         handleKeydown: (e: any) => void;
         resolveClassName: (cls: string) => string;
-    }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("keydown" | "enter" | "update:modelValue" | "remove")[], import("vue").PublicProps, {
+    }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("keydown" | "remove" | "enter" | "update:modelValue")[], import("vue").PublicProps, {
         disabled: boolean;
         placeholder: string;
         tagTheme: "" | "danger" | "success" | "warning" | "info";
@@ -2712,6 +2737,11 @@ declare const BkSelect: {
         } & {
             default: string;
         };
+        renderReferenceWrapper: import("vue-types").VueTypeValidableDef<boolean> & {
+            default: boolean;
+        } & {
+            default: boolean;
+        };
         hideIgnoreReference: import("vue-types").VueTypeValidableDef<boolean> & {
             default: boolean;
         } & {
@@ -2774,6 +2804,7 @@ declare const BkSelect: {
     multiple: boolean;
     disabled: boolean;
     trigger: "default" | "manual";
+    scrollHeight: number;
     minHeight: number;
     showOnInit: boolean;
     loading: boolean;
@@ -2782,7 +2813,6 @@ declare const BkSelect: {
     tagTheme: "" | "danger" | "success" | "warning" | "info";
     behavior: "normal" | "simplicity";
     selectedStyle: "checkbox" | "check";
-    scrollHeight: number;
     clearable: boolean;
     withValidate: boolean;
     noDataText: string;