now-design-atoms/dist/tooltip/Tooltip.js

Atomic UI components for now-design.

"use strict";

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); }
Object.defineProperty(exports, "__esModule", {
  value: true
});
exports["default"] = void 0;
var _react = _interopRequireWildcard(require("react"));
var _propTypes = _interopRequireDefault(require("prop-types"));
var _nowDesignTheme = require("now-design-theme");
var _nowDesignIcons = require("now-design-icons");
require("./Tooltip.css");
var _jsxRuntime = require("react/jsx-runtime");
var _excluded = ["children", "content", "position", "trigger", "disabled", "delay", "icon", "iconColor", "className"];
/**
 * Accessible tooltip atom with hover/click/focus triggers and auto-positioning.
 * Adjusts position to avoid viewport overflow and supports custom trigger content.
 *
 * @param {Object} props
 * @param {React.ReactNode} [props.children] Optional custom trigger; if not provided an info icon is rendered.
 * @param {string|React.ReactNode} props.content Tooltip body content.
 * @param {'top'|'bottom'|'left'|'right'|'top-left'|'top-right'|'bottom-left'|'bottom-right'} [props.position='top'] Preferred tooltip position.
 * @param {'hover'|'click'|'focus'} [props.trigger='hover'] Trigger interaction mode.
 * @param {boolean} [props.disabled=false] Disables showing the tooltip.
 * @param {number} [props.delay=0] Delay in ms before showing when using hover/focus.
 * @param {React.ReactNode} [props.icon] Custom icon for default trigger.
 * @param {string} [props.iconColor='#E3E3E3'] Color for the default info icon.
 * @param {string} [props.className=''] Additional class names for the tooltip surface.
 * @returns {JSX.Element} Tooltip container with trigger and content.
 */
function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
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(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : 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(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _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(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
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(r) { if (Array.isArray(r)) return r; }
function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
var Tooltip = function Tooltip(_ref) {
  var _themeContext$theme;
  var children = _ref.children,
    content = _ref.content,
    _ref$position = _ref.position,
    position = _ref$position === void 0 ? 'top' : _ref$position,
    _ref$trigger = _ref.trigger,
    trigger = _ref$trigger === void 0 ? 'hover' : _ref$trigger,
    _ref$disabled = _ref.disabled,
    disabled = _ref$disabled === void 0 ? false : _ref$disabled,
    _ref$delay = _ref.delay,
    delay = _ref$delay === void 0 ? 0 : _ref$delay,
    icon = _ref.icon,
    _ref$iconColor = _ref.iconColor,
    iconColor = _ref$iconColor === void 0 ? '#E3E3E3' : _ref$iconColor,
    _ref$className = _ref.className,
    className = _ref$className === void 0 ? '' : _ref$className,
    props = _objectWithoutProperties(_ref, _excluded);
  // Use ThemeContext directly so Tooltip doesn't hard-require a ThemeProvider
  var themeContext = (0, _react.useContext)(_nowDesignTheme.ThemeContext);
  var theme = (_themeContext$theme = themeContext === null || themeContext === void 0 ? void 0 : themeContext.theme) !== null && _themeContext$theme !== void 0 ? _themeContext$theme : 'light';
  var _useState = (0, _react.useState)(false),
    _useState2 = _slicedToArray(_useState, 2),
    isVisible = _useState2[0],
    setIsVisible = _useState2[1];
  var _useState3 = (0, _react.useState)(position),
    _useState4 = _slicedToArray(_useState3, 2),
    actualPosition = _useState4[0],
    setActualPosition = _useState4[1];
  var triggerRef = (0, _react.useRef)(null);
  var tooltipRef = (0, _react.useRef)(null);
  var timeoutRef = (0, _react.useRef)(null);
  var showTooltip = function showTooltip() {
    if (disabled) return;
    if (delay > 0) {
      timeoutRef.current = setTimeout(function () {
        setIsVisible(true);
      }, delay);
    } else {
      setIsVisible(true);
    }
  };
  var hideTooltip = function hideTooltip() {
    if (timeoutRef.current) {
      clearTimeout(timeoutRef.current);
    }
    setIsVisible(false);
  };
  var handleKeyDown = function handleKeyDown(e) {
    if (e.key === 'Escape') {
      hideTooltip();
    }
  };

  // Auto-positioning logic to prevent tooltip from going off-screen
  (0, _react.useEffect)(function () {
    if (isVisible && triggerRef.current && tooltipRef.current) {
      var triggerRect = triggerRef.current.getBoundingClientRect();
      var tooltipRect = tooltipRef.current.getBoundingClientRect();
      var viewport = {
        width: window.innerWidth,
        height: window.innerHeight
      };
      var newPosition = position;

      // Check if tooltip goes off-screen and adjust position
      if (position === 'top' && triggerRect.top - tooltipRect.height < 0) {
        newPosition = 'bottom';
      } else if (position === 'bottom' && triggerRect.bottom + tooltipRect.height > viewport.height) {
        newPosition = 'top';
      } else if (position === 'left' && triggerRect.left - tooltipRect.width < 0) {
        newPosition = 'right';
      } else if (position === 'right' && triggerRect.right + tooltipRect.width > viewport.width) {
        newPosition = 'left';
      }
      setActualPosition(newPosition);
    }
  }, [isVisible, position]);
  var getTriggerProps = function getTriggerProps() {
    var props = {
      ref: triggerRef,
      'aria-describedby': isVisible ? 'tooltip' : undefined
    };
    if (trigger === 'hover') {
      props.onMouseEnter = showTooltip;
      props.onMouseLeave = hideTooltip;
      props.onFocus = showTooltip;
      props.onBlur = hideTooltip;
    } else if (trigger === 'click') {
      props.onClick = function () {
        return isVisible ? hideTooltip() : showTooltip();
      };
    } else if (trigger === 'focus') {
      props.onFocus = showTooltip;
      props.onBlur = hideTooltip;
    }
    props.onKeyDown = handleKeyDown;
    return props;
  };
  var getTooltipClasses = function getTooltipClasses() {
    var baseClass = 'tooltip';
    var positionClass = "tooltip--".concat(actualPosition);
    var visibleClass = isVisible ? 'tooltip--visible' : '';
    return [baseClass, positionClass, visibleClass, className].filter(Boolean).join(' ');
  };

  // Default icon if none provided
  var defaultIcon = /*#__PURE__*/(0, _jsxRuntime.jsx)(_nowDesignIcons.SystemInformation2Line, {
    width: 20,
    height: 20,
    style: {
      color: iconColor
    }
  });
  return /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", _objectSpread(_objectSpread({
    className: "tooltip-container"
  }, props), {}, {
    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("div", _objectSpread(_objectSpread({}, getTriggerProps()), {}, {
      className: "tooltip-trigger",
      children: children || /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
        className: "tooltip-icon",
        children: icon || defaultIcon
      })
    })), isVisible && /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
      ref: tooltipRef,
      id: "tooltip",
      role: "tooltip",
      className: getTooltipClasses(),
      "aria-hidden": !isVisible,
      children: /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
        className: "tooltip-content",
        children: content
      })
    })]
  }));
};
Tooltip.propTypes = {
  children: _propTypes["default"].node,
  content: _propTypes["default"].oneOfType([_propTypes["default"].string, _propTypes["default"].node]).isRequired,
  position: _propTypes["default"].oneOf(['top', 'bottom', 'left', 'right', 'top-left', 'top-right', 'bottom-left', 'bottom-right']),
  trigger: _propTypes["default"].oneOf(['hover', 'click', 'focus']),
  disabled: _propTypes["default"].bool,
  delay: _propTypes["default"].number,
  icon: _propTypes["default"].node,
  iconColor: _propTypes["default"].string,
  className: _propTypes["default"].string
};
var _default = exports["default"] = Tooltip;