wssf-kage-ui 0.1.1 → 0.1.3

package/dist/esm/Tooltip/index.js

@@ -0,0 +1,471 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import React, { useState, useRef, useEffect, useCallback, cloneElement, isValidElement } from 'react';
+import { createPortal } from 'react-dom';
+import "./style.less";
+
+// ============ 类型定义 ============
+
+/** 提示框位置 */
+
+/** 触发方式 */
+
+/** 颜色预设 */
+
+/** Tooltip 属性 */
+import { Fragment as _Fragment } from "react/jsx-runtime";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+// ============ 预设颜色 ============
+
+var PRESET_COLORS = ['default', 'primary', 'success', 'warning', 'error'];
+function isPresetColor(color) {
+  return PRESET_COLORS.includes(color || '');
+}
+
+// ============ 位置计算 ============
+
+function getPlacementStyle(triggerRect, tooltipRect, placement, arrow) {
+  var gap = arrow ? 12 : 8;
+  var scrollTop = window.scrollY || document.documentElement.scrollTop;
+  var scrollLeft = window.scrollX || document.documentElement.scrollLeft;
+  var positions = {
+    top: {
+      top: triggerRect.top + scrollTop - tooltipRect.height - gap,
+      left: triggerRect.left + scrollLeft + (triggerRect.width - tooltipRect.width) / 2
+    },
+    topLeft: {
+      top: triggerRect.top + scrollTop - tooltipRect.height - gap,
+      left: triggerRect.left + scrollLeft
+    },
+    topRight: {
+      top: triggerRect.top + scrollTop - tooltipRect.height - gap,
+      left: triggerRect.right + scrollLeft - tooltipRect.width
+    },
+    bottom: {
+      top: triggerRect.bottom + scrollTop + gap,
+      left: triggerRect.left + scrollLeft + (triggerRect.width - tooltipRect.width) / 2
+    },
+    bottomLeft: {
+      top: triggerRect.bottom + scrollTop + gap,
+      left: triggerRect.left + scrollLeft
+    },
+    bottomRight: {
+      top: triggerRect.bottom + scrollTop + gap,
+      left: triggerRect.right + scrollLeft - tooltipRect.width
+    },
+    left: {
+      top: triggerRect.top + scrollTop + (triggerRect.height - tooltipRect.height) / 2,
+      left: triggerRect.left + scrollLeft - tooltipRect.width - gap
+    },
+    leftTop: {
+      top: triggerRect.top + scrollTop,
+      left: triggerRect.left + scrollLeft - tooltipRect.width - gap
+    },
+    leftBottom: {
+      top: triggerRect.bottom + scrollTop - tooltipRect.height,
+      left: triggerRect.left + scrollLeft - tooltipRect.width - gap
+    },
+    right: {
+      top: triggerRect.top + scrollTop + (triggerRect.height - tooltipRect.height) / 2,
+      left: triggerRect.right + scrollLeft + gap
+    },
+    rightTop: {
+      top: triggerRect.top + scrollTop,
+      left: triggerRect.right + scrollLeft + gap
+    },
+    rightBottom: {
+      top: triggerRect.bottom + scrollTop - tooltipRect.height,
+      left: triggerRect.right + scrollLeft + gap
+    }
+  };
+  return positions[placement];
+}
+
+// ============ Tooltip 组件 ============
+
+export var Tooltip = function Tooltip(_ref) {
+  var title = _ref.title,
+    _ref$trigger = _ref.trigger,
+    trigger = _ref$trigger === void 0 ? 'hover' : _ref$trigger,
+    _ref$placement = _ref.placement,
+    placement = _ref$placement === void 0 ? 'top' : _ref$placement,
+    _ref$defaultOpen = _ref.defaultOpen,
+    defaultOpen = _ref$defaultOpen === void 0 ? false : _ref$defaultOpen,
+    controlledOpen = _ref.open,
+    onOpenChange = _ref.onOpenChange,
+    _ref$color = _ref.color,
+    color = _ref$color === void 0 ? 'default' : _ref$color,
+    _ref$arrow = _ref.arrow,
+    arrow = _ref$arrow === void 0 ? true : _ref$arrow,
+    _ref$mouseEnterDelay = _ref.mouseEnterDelay,
+    mouseEnterDelay = _ref$mouseEnterDelay === void 0 ? 0.1 : _ref$mouseEnterDelay,
+    _ref$mouseLeaveDelay = _ref.mouseLeaveDelay,
+    mouseLeaveDelay = _ref$mouseLeaveDelay === void 0 ? 0.1 : _ref$mouseLeaveDelay,
+    _ref$destroyTooltipOn = _ref.destroyTooltipOnHide,
+    destroyTooltipOnHide = _ref$destroyTooltipOn === void 0 ? false : _ref$destroyTooltipOn,
+    getPopupContainer = _ref.getPopupContainer,
+    overlayStyle = _ref.overlayStyle,
+    _ref$overlayClassName = _ref.overlayClassName,
+    overlayClassName = _ref$overlayClassName === void 0 ? '' : _ref$overlayClassName,
+    overlayInnerStyle = _ref.overlayInnerStyle,
+    _ref$autoAdjustOverfl = _ref.autoAdjustOverflow,
+    autoAdjustOverflow = _ref$autoAdjustOverfl === void 0 ? true : _ref$autoAdjustOverfl,
+    _ref$zIndex = _ref.zIndex,
+    zIndex = _ref$zIndex === void 0 ? 1070 : _ref$zIndex,
+    children = _ref.children,
+    _ref$className = _ref.className,
+    className = _ref$className === void 0 ? '' : _ref$className,
+    style = _ref.style;
+  var _useState = useState(defaultOpen),
+    _useState2 = _slicedToArray(_useState, 2),
+    internalOpen = _useState2[0],
+    setInternalOpen = _useState2[1];
+  var _useState3 = useState({
+      top: 0,
+      left: 0
+    }),
+    _useState4 = _slicedToArray(_useState3, 2),
+    position = _useState4[0],
+    setPosition = _useState4[1];
+  var _useState5 = useState(placement),
+    _useState6 = _slicedToArray(_useState5, 2),
+    actualPlacement = _useState6[0],
+    setActualPlacement = _useState6[1];
+  // 如果 defaultOpen 为 true，初始时就应该 mounted
+  var _useState7 = useState(defaultOpen),
+    _useState8 = _slicedToArray(_useState7, 2),
+    mounted = _useState8[0],
+    setMounted = _useState8[1];
+  var _useState9 = useState(false),
+    _useState10 = _slicedToArray(_useState9, 2),
+    positionCalculated = _useState10[0],
+    setPositionCalculated = _useState10[1];
+  var triggerRef = useRef(null);
+  var tooltipRef = useRef(null);
+  var enterTimerRef = useRef();
+  var leaveTimerRef = useRef();
+  var isOpen = controlledOpen !== null && controlledOpen !== void 0 ? controlledOpen : internalOpen;
+  var triggers = Array.isArray(trigger) ? trigger : [trigger];
+
+  // 更新显示状态
+  var updateOpen = useCallback(function (nextOpen) {
+    if (controlledOpen === undefined) {
+      setInternalOpen(nextOpen);
+    }
+    onOpenChange === null || onOpenChange === void 0 || onOpenChange(nextOpen);
+  }, [controlledOpen, onOpenChange]);
+
+  // 计算位置
+  var updatePosition = useCallback(function () {
+    if (!triggerRef.current || !tooltipRef.current) return;
+    var triggerRect = triggerRef.current.getBoundingClientRect();
+    var tooltipRect = tooltipRef.current.getBoundingClientRect();
+    var finalPlacement = placement;
+
+    // 自动调整位置
+    if (autoAdjustOverflow) {
+      var viewportWidth = window.innerWidth;
+      var viewportHeight = window.innerHeight;
+
+      // 检查是否需要翻转
+      if (placement.startsWith('top') && triggerRect.top < tooltipRect.height + 12) {
+        finalPlacement = placement.replace('top', 'bottom');
+      } else if (placement.startsWith('bottom') && viewportHeight - triggerRect.bottom < tooltipRect.height + 12) {
+        finalPlacement = placement.replace('bottom', 'top');
+      } else if (placement.startsWith('left') && triggerRect.left < tooltipRect.width + 12) {
+        finalPlacement = placement.replace('left', 'right');
+      } else if (placement.startsWith('right') && viewportWidth - triggerRect.right < tooltipRect.width + 12) {
+        finalPlacement = placement.replace('right', 'left');
+      }
+      setActualPlacement(finalPlacement);
+    }
+    var pos = getPlacementStyle(triggerRect, tooltipRect, finalPlacement, arrow);
+    setPosition(pos);
+    setPositionCalculated(true);
+  }, [placement, arrow, autoAdjustOverflow]);
+
+  // 显示
+  var handleShow = useCallback(function () {
+    clearTimeout(leaveTimerRef.current);
+    enterTimerRef.current = window.setTimeout(function () {
+      updateOpen(true);
+    }, mouseEnterDelay * 1000);
+  }, [mouseEnterDelay, updateOpen]);
+
+  // 隐藏
+  var handleHide = useCallback(function () {
+    clearTimeout(enterTimerRef.current);
+    leaveTimerRef.current = window.setTimeout(function () {
+      updateOpen(false);
+    }, mouseLeaveDelay * 1000);
+  }, [mouseLeaveDelay, updateOpen]);
+
+  // 立即显示（用于点击触发）
+  var handleShowImmediate = useCallback(function () {
+    clearTimeout(leaveTimerRef.current);
+    clearTimeout(enterTimerRef.current);
+    updateOpen(true);
+  }, [updateOpen]);
+
+  // 切换
+  var handleToggle = useCallback(function () {
+    if (isOpen) {
+      handleHide();
+    } else {
+      handleShowImmediate();
+    }
+  }, [isOpen, handleShowImmediate, handleHide]);
+
+  // 绑定触发事件
+  var getTriggerProps = function getTriggerProps() {
+    var props = {};
+    if (triggers.includes('hover')) {
+      props.onMouseEnter = handleShow;
+      props.onMouseLeave = handleHide;
+    }
+    if (triggers.includes('focus')) {
+      props.onFocus = handleShow;
+      props.onBlur = handleHide;
+    }
+    if (triggers.includes('click')) {
+      props.onClick = function (e) {
+        e.stopPropagation();
+        handleToggle();
+      };
+    }
+    if (triggers.includes('contextMenu')) {
+      props.onContextMenu = function (e) {
+        e.preventDefault();
+        handleToggle();
+      };
+    }
+    return props;
+  };
+
+  // 点击外部关闭
+  useEffect(function () {
+    if (!isOpen || !triggers.includes('click')) return;
+    var handleClickOutside = function handleClickOutside(e) {
+      if (triggerRef.current && !triggerRef.current.contains(e.target) && tooltipRef.current && !tooltipRef.current.contains(e.target)) {
+        updateOpen(false);
+      }
+    };
+
+    // 使用 click 事件而不是 mousedown，避免在显示之前就关闭
+    // 延迟执行，确保点击触发的事件先执行
+    var timer = setTimeout(function () {
+      document.addEventListener('click', handleClickOutside, true);
+    }, 0);
+    return function () {
+      clearTimeout(timer);
+      document.removeEventListener('click', handleClickOutside, true);
+    };
+  }, [isOpen, triggers, updateOpen]);
+
+  // 当 isOpen 变化时，更新 mounted 状态
+  useEffect(function () {
+    if (isOpen) {
+      setMounted(true);
+    } else {
+      setPositionCalculated(false);
+      // 如果 destroyTooltipOnHide 为 true，关闭时重置 mounted
+      if (destroyTooltipOnHide) {
+        setMounted(false);
+      }
+    }
+  }, [isOpen, destroyTooltipOnHide]);
+
+  // 更新位置
+  useEffect(function () {
+    if (isOpen && mounted) {
+      setPositionCalculated(false); // 重置位置计算标志
+      // 等待 DOM 渲染完成后再计算位置
+      // 使用双重 requestAnimationFrame 确保 DOM 已完全渲染
+      var rafId1 = requestAnimationFrame(function () {
+        var rafId2 = requestAnimationFrame(function () {
+          if (tooltipRef.current && triggerRef.current) {
+            updatePosition();
+          }
+        });
+        return function () {
+          return cancelAnimationFrame(rafId2);
+        };
+      });
+      return function () {
+        return cancelAnimationFrame(rafId1);
+      };
+    }
+  }, [isOpen, mounted, updatePosition]);
+
+  // 当 tooltip 挂载后立即更新位置（用于确保位置正确）
+  useEffect(function () {
+    if (mounted && isOpen) {
+      // 多次尝试更新位置，确保 tooltip 已完全渲染
+      var timer1 = setTimeout(function () {
+        if (tooltipRef.current && triggerRef.current) {
+          updatePosition();
+        }
+      }, 0);
+      var timer2 = setTimeout(function () {
+        if (tooltipRef.current && triggerRef.current) {
+          updatePosition();
+        }
+      }, 10);
+      return function () {
+        clearTimeout(timer1);
+        clearTimeout(timer2);
+      };
+    }
+  }, [mounted, isOpen, updatePosition]);
+
+  // 窗口变化时更新位置
+  useEffect(function () {
+    if (!isOpen) return;
+    var handleResize = function handleResize() {
+      return updatePosition();
+    };
+    var handleScroll = function handleScroll() {
+      return updatePosition();
+    };
+    window.addEventListener('resize', handleResize);
+    window.addEventListener('scroll', handleScroll, true);
+    return function () {
+      window.removeEventListener('resize', handleResize);
+      window.removeEventListener('scroll', handleScroll, true);
+    };
+  }, [isOpen, updatePosition]);
+
+  // 清理定时器
+  useEffect(function () {
+    return function () {
+      clearTimeout(enterTimerRef.current);
+      clearTimeout(leaveTimerRef.current);
+    };
+  }, []);
+
+  // 如果没有 title，直接返回 children
+  if (title === undefined || title === null || title === '') {
+    return /*#__PURE__*/_jsx(_Fragment, {
+      children: children
+    });
+  }
+
+  // 检查子元素是否是原生 DOM 元素（如 button, span, a 等）
+  var child = /*#__PURE__*/isValidElement(children) ? children : /*#__PURE__*/_jsx("span", {
+    children: children
+  });
+  var isNativeElement = typeof child.type === 'string';
+  var triggerProps = getTriggerProps();
+  var triggerElement;
+  if (isNativeElement) {
+    // 如果是原生 DOM 元素，直接克隆并添加事件
+    var childProps = child.props;
+    var mergedProps = _objectSpread(_objectSpread({
+      ref: triggerRef
+    }, triggerProps), {}, {
+      className: [childProps.className, className].filter(Boolean).join(' '),
+      style: _objectSpread(_objectSpread({}, style), childProps.style)
+    });
+
+    // 合并事件处理函数
+    var mergeEventHandler = function mergeEventHandler(tooltipHandler, childHandler) {
+      if (tooltipHandler && childHandler) {
+        return function (e) {
+          tooltipHandler(e);
+          childHandler(e);
+        };
+      }
+      return tooltipHandler || childHandler;
+    };
+    mergedProps.onClick = mergeEventHandler(triggerProps.onClick, childProps.onClick);
+    mergedProps.onMouseEnter = mergeEventHandler(triggerProps.onMouseEnter, childProps.onMouseEnter);
+    mergedProps.onMouseLeave = mergeEventHandler(triggerProps.onMouseLeave, childProps.onMouseLeave);
+    mergedProps.onFocus = mergeEventHandler(triggerProps.onFocus, childProps.onFocus);
+    mergedProps.onBlur = mergeEventHandler(triggerProps.onBlur, childProps.onBlur);
+    mergedProps.onContextMenu = mergeEventHandler(triggerProps.onContextMenu, childProps.onContextMenu);
+    triggerElement = /*#__PURE__*/cloneElement(child, mergedProps);
+  } else {
+    // 如果是 React 组件（如 Button），用 span 包裹并绑定事件
+    var _childProps = child.props;
+    triggerElement = /*#__PURE__*/_jsx("span", _objectSpread(_objectSpread({
+      ref: triggerRef,
+      className: className,
+      style: _objectSpread({
+        display: 'inline-block'
+      }, style)
+    }, triggerProps), {}, {
+      children: /*#__PURE__*/cloneElement(child, _objectSpread(_objectSpread({}, _childProps), {}, {
+        // 合并子组件的 onClick（如果有）
+        onClick: triggerProps.onClick && _childProps.onClick ? function (e) {
+          var _triggerProps$onClick, _childProps$onClick;
+          (_triggerProps$onClick = triggerProps.onClick) === null || _triggerProps$onClick === void 0 || _triggerProps$onClick.call(triggerProps, e);
+          (_childProps$onClick = _childProps.onClick) === null || _childProps$onClick === void 0 || _childProps$onClick.call(_childProps, e);
+        } : _childProps.onClick
+      }))
+    }));
+  }
+
+  // 是否使用预设颜色
+  var isPreset = isPresetColor(color);
+
+  // Tooltip 内容
+  var tooltipClassNames = ['kage-tooltip', "kage-tooltip-placement-".concat(actualPlacement), isPreset && "kage-tooltip-".concat(color), !isPreset && 'kage-tooltip-custom-color', !arrow && 'kage-tooltip-no-arrow', overlayClassName].filter(Boolean).join(' ');
+  var tooltipStyle = _objectSpread(_objectSpread({}, overlayStyle), {}, {
+    position: 'absolute',
+    top: position.top,
+    left: position.left,
+    zIndex: zIndex
+  }, isOpen ? {
+    opacity: positionCalculated ? 1 : 0,
+    visibility: 'visible'
+  } : {
+    opacity: 0,
+    visibility: 'hidden'
+  });
+  var innerStyle = _objectSpread(_objectSpread({}, overlayInnerStyle), !isPreset && color ? {
+    backgroundColor: color
+  } : {});
+  var arrowStyle = !isPreset && color ? {
+    '--arrow-color': color
+  } : {};
+
+  // 是否需要渲染
+  // 简化：只要 isOpen 为 true 就渲染，不依赖其他状态
+  // mounted 用于控制 tooltip 的显示状态（opacity），而不是渲染状态
+  var shouldRender = isOpen;
+
+  // 获取容器
+  var container = (getPopupContainer === null || getPopupContainer === void 0 ? void 0 : getPopupContainer()) || document.body;
+
+  // 渲染 Tooltip
+  var tooltipNode = shouldRender ? /*#__PURE__*/_jsxs("div", {
+    ref: tooltipRef,
+    className: tooltipClassNames,
+    style: tooltipStyle,
+    onMouseEnter: triggers.includes('hover') ? handleShow : undefined,
+    onMouseLeave: triggers.includes('hover') ? handleHide : undefined,
+    children: [arrow && /*#__PURE__*/_jsx("div", {
+      className: "kage-tooltip-arrow",
+      style: arrowStyle
+    }), /*#__PURE__*/_jsx("div", {
+      className: "kage-tooltip-inner",
+      style: innerStyle,
+      children: title
+    })]
+  }) : null;
+  return /*#__PURE__*/_jsxs(_Fragment, {
+    children: [triggerElement, /*#__PURE__*/createPortal(tooltipNode, container)]
+  });
+};
+export default Tooltip;

package/dist/esm/Tooltip/style.less

@@ -0,0 +1,237 @@
+// Tooltip 文字提示组件样式
+
+@prefix: kage-tooltip;
+
+// 颜色变量
+@tooltip-bg: rgba(0, 0, 0, 0.85);
+@tooltip-color: #fff;
+@tooltip-max-width: 250px;
+@tooltip-arrow-size: 8px;
+@tooltip-border-radius: 6px;
+@tooltip-padding: 6px 8px;
+
+// 预设颜色
+@tooltip-primary: #1890ff;
+@tooltip-success: #52c41a;
+@tooltip-warning: #faad14;
+@tooltip-error: #ff4d4f;
+
+// ============ 主容器 ============
+.@{prefix} {
+  position: absolute;
+  z-index: 1070;
+  display: block;
+  max-width: @tooltip-max-width;
+  word-wrap: break-word;
+  pointer-events: none;
+  transition: opacity 0.2s, visibility 0.2s;
+
+  * {
+    box-sizing: border-box;
+  }
+}
+
+// ============ 内容区域 ============
+.@{prefix}-inner {
+  min-width: 32px;
+  min-height: 32px;
+  padding: @tooltip-padding;
+  color: @tooltip-color;
+  text-align: left;
+  text-decoration: none;
+  word-wrap: break-word;
+  background-color: @tooltip-bg;
+  border-radius: @tooltip-border-radius;
+  box-shadow: 0 6px 16px 0 rgba(0, 0, 0, 0.08), 0 3px 6px -4px rgba(0, 0, 0, 0.12),
+    0 9px 28px 8px rgba(0, 0, 0, 0.05);
+  font-size: 14px;
+  line-height: 1.5715;
+}
+
+// ============ 箭头 ============
+.@{prefix}-arrow {
+  position: absolute;
+  z-index: 1;
+  display: block;
+  pointer-events: none;
+  width: 16px;
+  height: 16px;
+  overflow: hidden;
+
+  &::before {
+    position: absolute;
+    bottom: 0;
+    left: 50%;
+    width: @tooltip-arrow-size;
+    height: @tooltip-arrow-size;
+    background: var(--arrow-color, @tooltip-bg);
+    transform: translateX(-50%) translateY(50%) rotate(45deg);
+    box-shadow: 3px 3px 7px rgba(0, 0, 0, 0.07);
+    content: '';
+    border-radius: 0 0 2px 0;
+  }
+}
+
+// ============ 无箭头 ============
+.@{prefix}-no-arrow {
+  .@{prefix}-arrow {
+    display: none;
+  }
+}
+
+// ============ 位置 - 上方 ============
+.@{prefix}-placement-top,
+.@{prefix}-placement-topLeft,
+.@{prefix}-placement-topRight {
+  .@{prefix}-arrow {
+    bottom: -8px;
+    left: 50%;
+    transform: translateX(-50%);
+  }
+}
+
+.@{prefix}-placement-topLeft .@{prefix}-arrow {
+  left: 16px;
+  transform: none;
+}
+
+.@{prefix}-placement-topRight .@{prefix}-arrow {
+  right: 16px;
+  left: auto;
+  transform: none;
+}
+
+// ============ 位置 - 下方 ============
+.@{prefix}-placement-bottom,
+.@{prefix}-placement-bottomLeft,
+.@{prefix}-placement-bottomRight {
+  .@{prefix}-arrow {
+    top: -8px;
+    left: 50%;
+    transform: translateX(-50%) rotate(180deg);
+  }
+}
+
+.@{prefix}-placement-bottomLeft .@{prefix}-arrow {
+  left: 16px;
+  transform: rotate(180deg);
+}
+
+.@{prefix}-placement-bottomRight .@{prefix}-arrow {
+  right: 16px;
+  left: auto;
+  transform: rotate(180deg);
+}
+
+// ============ 位置 - 左侧 ============
+.@{prefix}-placement-left,
+.@{prefix}-placement-leftTop,
+.@{prefix}-placement-leftBottom {
+  .@{prefix}-arrow {
+    right: -8px;
+    top: 50%;
+    transform: translateY(-50%) rotate(90deg);
+  }
+}
+
+.@{prefix}-placement-leftTop .@{prefix}-arrow {
+  top: 8px;
+  transform: rotate(90deg);
+}
+
+.@{prefix}-placement-leftBottom .@{prefix}-arrow {
+  bottom: 8px;
+  top: auto;
+  transform: rotate(90deg);
+}
+
+// ============ 位置 - 右侧 ============
+.@{prefix}-placement-right,
+.@{prefix}-placement-rightTop,
+.@{prefix}-placement-rightBottom {
+  .@{prefix}-arrow {
+    left: -8px;
+    top: 50%;
+    transform: translateY(-50%) rotate(-90deg);
+  }
+}
+
+.@{prefix}-placement-rightTop .@{prefix}-arrow {
+  top: 8px;
+  transform: rotate(-90deg);
+}
+
+.@{prefix}-placement-rightBottom .@{prefix}-arrow {
+  bottom: 8px;
+  top: auto;
+  transform: rotate(-90deg);
+}
+
+// ============ 预设颜色 ============
+.@{prefix}-default {
+  .@{prefix}-inner {
+    background-color: @tooltip-bg;
+  }
+  .@{prefix}-arrow::before {
+    background: @tooltip-bg;
+  }
+}
+
+.@{prefix}-primary {
+  .@{prefix}-inner {
+    background-color: @tooltip-primary;
+  }
+  .@{prefix}-arrow::before {
+    background: @tooltip-primary;
+  }
+}
+
+.@{prefix}-success {
+  .@{prefix}-inner {
+    background-color: @tooltip-success;
+  }
+  .@{prefix}-arrow::before {
+    background: @tooltip-success;
+  }
+}
+
+.@{prefix}-warning {
+  .@{prefix}-inner {
+    background-color: @tooltip-warning;
+  }
+  .@{prefix}-arrow::before {
+    background: @tooltip-warning;
+  }
+}
+
+.@{prefix}-error {
+  .@{prefix}-inner {
+    background-color: @tooltip-error;
+  }
+  .@{prefix}-arrow::before {
+    background: @tooltip-error;
+  }
+}
+
+// ============ 自定义颜色 ============
+.@{prefix}-custom-color {
+  .@{prefix}-arrow::before {
+    background: var(--arrow-color, @tooltip-bg);
+  }
+}
+
+// ============ 暗色模式适配 ============
+[data-theme='dark'],
+[data-prefers-color-scheme='dark'],
+[data-prefers-color='dark'] {
+  .@{prefix}-default {
+    .@{prefix}-inner {
+      background-color: #434343;
+      color: rgba(255, 255, 255, 0.85);
+    }
+    .@{prefix}-arrow::before {
+      background: #434343;
+    }
+  }
+}
+