@salutejs/plasma-new-hope 0.166.1-dev.0 → 0.167.0-canary.1459.11348453591.0

package/styled-components/cjs/examples/plasma_web/components/TextField/TextField.stories.tsx

@@ -4,7 +4,8 @@ import { action } from '@storybook/addon-actions';
 import { IconPlaceholder } from '@salutejs/plasma-sb-utils';
 
 import { WithTheme } from '../../../_helpers';
-import { IconChevronLeft } from '../../../../components/_Icon';
+import { IconCross } from '../../../../components/_Icon';
+import type { PopoverPlacement } from '../Popover/Popover';
 
 import { TextField } from './TextField';
 
@@ -16,7 +17,29 @@ const onChipsChange = action('onChipsChange');
 
 const sizes = ['l', 'm', 's', 'xs'];
 const views = ['default', 'positive', 'warning', 'negative'];
+const hintViews = ['default', 'onDark', 'onLight'];
+const hintSizes = ['m', 's'];
+const hintTriggers = ['hover', 'click'];
 const labelPlacements = ['outer', 'inner'];
+const placements: Array<PopoverPlacement> = [
+    'top',
+    'top-start',
+    'top-end',
+
+    'bottom',
+    'bottom-start',
+    'bottom-end',
+
+    'left',
+    'left-start',
+    'left-end',
+
+    'right',
+    'right-start',
+    'right-end',
+
+    'auto',
+];
 
 const meta: Meta<typeof TextField> = {
     title: 'plasma_web/TextField',
@@ -70,6 +93,43 @@ const meta: Meta<typeof TextField> = {
                 type: 'inline-radio',
             },
         },
+        hintView: {
+            options: hintViews,
+            control: {
+                type: 'select',
+            },
+            if: { arg: 'hasHint', truthy: true },
+        },
+        hintSize: {
+            options: hintSizes,
+            control: {
+                type: 'select',
+            },
+            if: { arg: 'hasHint', truthy: true },
+        },
+        hintTrigger: {
+            options: hintTriggers,
+            control: {
+                type: 'inline-radio',
+            },
+            if: { arg: 'hasHint', truthy: true },
+        },
+        hintText: {
+            control: { type: 'text' },
+            if: { arg: 'hasHint', truthy: true },
+        },
+        hintPlacement: {
+            options: placements,
+            control: {
+                type: 'select',
+            },
+            if: { arg: 'hasHint', truthy: true },
+            mappers: placements,
+        },
+        hintHasArrow: {
+            control: { type: 'boolean' },
+            if: { arg: 'hasHint', truthy: true },
+        },
     },
 };
 
@@ -105,13 +165,13 @@ const StoryDemo = ({ enableContentLeft, enableContentRight, view, ...rest }: Sto
     const iconSize = rest.size === 'xs' ? 'xs' : 's';
 
     return (
-        <div style={{ display: 'flex', flexDirection: 'column', gap: '2rem' }}>
+        <div style={{ display: 'flex', flexDirection: 'column', gap: '2rem', width: '70%', margin: '0 auto' }}>
             <TextField
                 {...rest}
                 enumerationType="plain"
                 value={text}
-                contentLeft={enableContentLeft ? <IconPlaceholder size={iconSize} /> : undefined}
-                contentRight={enableContentRight ? <IconPlaceholder size={iconSize} /> : undefined}
+                contentLeft={enableContentLeft ? <IconCross color="inherit" size={iconSize} /> : undefined}
+                contentRight={enableContentRight ? <IconCross color="inherit" size={iconSize} /> : undefined}
                 view={view}
                 onChange={(e) => {
                     setText(e.target.value);
@@ -145,17 +205,28 @@ export const Default: StoryObj<StoryPropsDefault> = {
         view: 'default',
         label: 'Лейбл',
         labelPlacement: 'outer',
+        titleCaption: 'Подпись к полю',
+        textBefore: '',
+        textAfter: '',
         placeholder: 'Заполните поле',
         leftHelper: 'Подсказка к полю',
         disabled: false,
         readOnly: false,
-        required: false,
-        requiredPlacement: 'right',
-        optional: false,
         enableContentLeft: true,
         enableContentRight: true,
         clear: false,
         hasDivider: false,
+        optional: false,
+        required: false,
+        requiredPlacement: 'right',
+        hasHint: false,
+        hintTrigger: 'hover',
+        hintText: 'Текст подсказки',
+        hintView: 'default',
+        hintSize: 'm',
+        hintPlacement: 'auto',
+        hintWidth: '10rem',
+        hintHasArrow: true,
     },
     render: (args) => <StoryDemo {...args} />,
 };
@@ -176,8 +247,6 @@ type StoryPropsChips = Omit<
     | 'checked'
     | 'maxLength'
     | 'minLength'
-    | 'required'
-    | 'optional'
     | 'enumerationType'
 > & {
     enableContentLeft: boolean;
@@ -194,7 +263,7 @@ const StoryChips = ({ enableContentLeft, enableContentRight, view, ...rest }: St
             {...rest}
             enumerationType="chip"
             value={text}
-            contentLeft={enableContentLeft ? <IconChevronLeft color="inherit" size={iconSize} /> : undefined}
+            contentLeft={enableContentLeft ? <IconPlaceholder size={iconSize} /> : undefined}
             contentRight={enableContentRight ? <IconPlaceholder size={iconSize} /> : undefined}
             view={view}
             onChange={(e) => {
@@ -204,6 +273,7 @@ const StoryChips = ({ enableContentLeft, enableContentRight, view, ...rest }: St
             onFocus={onFocus}
             onBlur={onBlur}
             onChangeChips={onChipsChange}
+            style={{ width: '70%', margin: '0 auto' }}
         />
     );
 };

package/styled-components/es/components/Autocomplete/Autocomplete.js

@@ -1,4 +1,4 @@
-var _excluded = ["value", "onChange", "suggestions", "view", "size", "labelPlacement", "disabled", "readOnly", "label", "leftHelper", "contentLeft", "contentRight", "textBefore", "textAfter", "onScroll", "listMaxHeight", "listWidth", "portal", "filter", "onSuggestionSelect", "threshold", "renderList", "renderListEnd", "onSearch"];
+var _excluded = ["value", "onChange", "suggestions", "view", "size", "labelPlacement", "disabled", "readOnly", "label", "leftHelper", "contentLeft", "contentRight", "textBefore", "textAfter", "onScroll", "listMaxHeight", "listWidth", "portal", "filter", "onSuggestionSelect", "threshold", "renderList", "renderListEnd", "onSearch", "hasHint", "hintText"];
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 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."); }
@@ -47,6 +47,8 @@ export var autocompleteRoot = function autocompleteRoot(Root) {
       renderList = _ref.renderList,
       renderListEnd = _ref.renderListEnd,
       onSearch = _ref.onSearch,
+      hasHint = _ref.hasHint,
+      hintText = _ref.hintText,
       rest = _objectWithoutProperties(_ref, _excluded);
     var _useReducer = useReducer(focusedReducer, null),
       _useReducer2 = _slicedToArray(_useReducer, 2),
@@ -144,7 +146,9 @@ export var autocompleteRoot = function autocompleteRoot(Root) {
         "aria-controls": listId,
         "aria-expanded": isOpen,
         "aria-activedescendant": "".concat(listId, "/").concat(focused),
-        "aria-describedby": helperTextId
+        "aria-describedby": helperTextId,
+        hasHint: Boolean(hasHint),
+        hintText: String(hintText || '')
       }, rest)),
       preventOverflow: false,
       ref: targetRef,

package/styled-components/es/components/TextArea/TextArea.js

@@ -1,6 +1,6 @@
 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); }
-var _excluded = ["helperText", "status", "resize", "rightHelper", "leftHelper", "contentRight", "autoResize", "minAuto", "maxAuto", "label", "labelPlacement", "placeholder", "defaultValue", "height", "width", "value", "disabled", "required", "requiredPlacement", "optional", "clear", "hasDivider", "size", "view", "id", "style", "className", "readOnly", "rows", "cols", "onChange"];
-function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+var _IconInfoCircleOutlin;
+var _excluded = ["helperText", "status", "resize", "rightHelper", "leftHelper", "contentRight", "autoResize", "minAuto", "maxAuto", "label", "labelPlacement", "titleCaption", "placeholder", "defaultValue", "height", "width", "value", "disabled", "required", "requiredPlacement", "optional", "clear", "hasDivider", "size", "view", "id", "style", "className", "readOnly", "rows", "cols", "hasHint", "hintTrigger", "hintText", "hintView", "hintSize", "hintTargetIcon", "hintPlacement", "hintHasArrow", "hintOffset", "hintWidth", "hintContentLeft", "onChange"];
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
@@ -10,6 +10,7 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 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 : 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 _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 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); }
@@ -18,18 +19,22 @@ function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" !=
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
-import React, { forwardRef, useState, createRef, useCallback } from 'react';
+import React, { forwardRef, useState, createRef, useCallback, useRef, useMemo } from 'react';
 import { css } from 'styled-components';
-import { useResizeObserver } from '@salutejs/plasma-core';
-import { cx, mergeRefs } from '../../utils';
+import { useForkRef, useResizeObserver } from '@salutejs/plasma-core';
+import { cx, mergeRefs, safeUseId } from '../../utils';
+import { IconInfoCircleOutline } from '../_Icon';
+import { useOutsideClick } from '../../hooks';
 import { applyDynamicLabel } from './mixins';
 import { useAutoResize, ROOT_FONT_SIZE } from './hooks';
-import { StyledContent, StyledHelpers, StyledLeftHelper, StyledRightHelper, StyledLabel, StyledPlaceholder, StyledTextArea, StyledTextAreaWrapper, StyledContainer, StyledIndicator, StyledOptionalText } from './TextArea.styles';
+import { StyledContent, StyledHelpers, StyledLeftHelper, StyledRightHelper, StyledLabel, StyledPlaceholder, StyledTextArea, StyledTextAreaWrapper, StyledContainer, StyledIndicator, StyledOptionalText, OuterLabelWrapper, StyledIndicatorWrapper, StyledHintWrapper, HintTargetWrapper, TitleCaption, Hint } from './TextArea.styles';
 import { classes } from './TextArea.tokens';
 import { base as viewCSS } from './variations/_view/base';
 import { base as sizeCSS } from './variations/_size/base';
 import { base as clearCSS } from './variations/_clear/base';
 import { base as disabledCSS } from './variations/_disabled/base';
+import { base as hintViewCSS } from './variations/_hint-view/base';
+import { base as hintSizeCSS } from './variations/_hint-size/base';
 var innerPlaceholderUp = classes.innerPlaceholderUp,
   focusedOuterPlaceholderColor = classes.focusedOuterPlaceholderColor,
   hidePlaceHolder = classes.hidePlaceHolder,
@@ -84,6 +89,7 @@ export var textAreaRoot = function textAreaRoot(Root) {
       label = props.label,
       _props$labelPlacement = props.labelPlacement,
       labelPlacement = _props$labelPlacement === void 0 ? 'inner' : _props$labelPlacement,
+      titleCaption = props.titleCaption,
       placeholder = props.placeholder,
       defaultValue = props.defaultValue,
       height = props.height,
@@ -106,21 +112,47 @@ export var textAreaRoot = function textAreaRoot(Root) {
       readOnly = props.readOnly,
       rows = props.rows,
       cols = props.cols,
+      hasHint = props.hasHint,
+      _props$hintTrigger = props.hintTrigger,
+      hintTrigger = _props$hintTrigger === void 0 ? 'hover' : _props$hintTrigger,
+      hintText = props.hintText,
+      _props$hintView = props.hintView,
+      hintView = _props$hintView === void 0 ? 'default' : _props$hintView,
+      _props$hintSize = props.hintSize,
+      hintSize = _props$hintSize === void 0 ? 'm' : _props$hintSize,
+      hintTargetIcon = props.hintTargetIcon,
+      _props$hintPlacement = props.hintPlacement,
+      hintPlacement = _props$hintPlacement === void 0 ? 'auto' : _props$hintPlacement,
+      hintHasArrow = props.hintHasArrow,
+      _props$hintOffset = props.hintOffset,
+      hintOffset = _props$hintOffset === void 0 ? [0, 0] : _props$hintOffset,
+      hintWidth = props.hintWidth,
+      hintContentLeft = props.hintContentLeft,
       onChange = props.onChange,
       rest = _objectWithoutProperties(props, _excluded);
-    var _useState = useState(width ? "".concat(width, "rem") : '100%'),
+    var _useState = useState(false),
       _useState2 = _slicedToArray(_useState, 2),
-      helperWidth = _useState2[0],
-      setHelperWidth = _useState2[1];
-    var _useState3 = useState(false),
+      isHintVisible = _useState2[0],
+      setIsHintVisible = _useState2[1];
+    var _useState3 = useState(width ? "".concat(width, "rem") : '100%'),
       _useState4 = _slicedToArray(_useState3, 2),
-      focused = _useState4[0],
-      setFocused = _useState4[1];
-    var _useState5 = useState(),
+      helperWidth = _useState4[0],
+      setHelperWidth = _useState4[1];
+    var _useState5 = useState(false),
       _useState6 = _slicedToArray(_useState5, 2),
-      uncontrolledValue = _useState6[0],
-      setUncontrolledValue = _useState6[1];
+      focused = _useState6[0],
+      setFocused = _useState6[1];
+    var _useState7 = useState(),
+      _useState8 = _slicedToArray(_useState7, 2),
+      uncontrolledValue = _useState8[0],
+      setUncontrolledValue = _useState8[1];
     var outerRef = /*#__PURE__*/createRef();
+    var hintId = safeUseId();
+    var hintRef = useOutsideClick(function () {
+      setIsHintVisible(false);
+    });
+    var hintInnerRef = useRef(null);
+    var hintForkRef = useForkRef(hintRef, hintInnerRef);
     var innerOptional = required ? false : optional;
     var hasHelper = Boolean(leftHelper || rightHelper || helperText);
     var hasOuterLabel = Boolean(label && labelPlacement === 'outer');
@@ -131,9 +163,27 @@ export var textAreaRoot = function textAreaRoot(Root) {
     var applyCustomWidth = resize !== 'horizontal' && resize !== 'both' && !cols;
     var placeholderLabel = hasInnerLabel ? label : placeholder;
     var clearClass = clear ? classes.clear : undefined;
+    var hasHintClass = hasHint ? classes.hasHint : undefined;
     var hasRightContentClass = contentRight ? classes.hasRightContent : undefined;
     var hasDividerClass = hasDivider ? classes.hasDivider : undefined;
     var requiredPlacementClass = requiredPlacement === 'right' ? 'align-right ' : undefined;
+    var handleHintShow = function handleHintShow() {
+      return setIsHintVisible(true);
+    };
+    var handleHintHide = function handleHintHide() {
+      return setIsHintVisible(false);
+    };
+    var handleHintClick = function handleHintClick(event) {
+      if (hasHint && hintTrigger === 'click') {
+        var _hintInnerRef$current;
+        event.stopPropagation();
+        var targetIsPopover = event.target === hintInnerRef.current;
+        var rootHasTarget = (_hintInnerRef$current = hintInnerRef.current) === null || _hintInnerRef$current === void 0 ? void 0 : _hintInnerRef$current.contains(event.target);
+        if (!targetIsPopover && !rootHasTarget) {
+          setIsHintVisible(true);
+        }
+      }
+    };
     useResizeObserver(outerRef, function (currentElement) {
       var inlineWidth = currentElement.style.width;
       if (inlineWidth || cols) {
@@ -156,17 +206,6 @@ export var textAreaRoot = function textAreaRoot(Root) {
       }
       onChange === null || onChange === void 0 || onChange(event);
     }, [value, onChange]);
-    var handleTextAreaFocus = function handleTextAreaFocus() {
-      if (readOnly || disabled || !(outerRef !== null && outerRef !== void 0 && outerRef.current)) {
-        return;
-      }
-      outerRef.current.scrollTo({
-        top: 0,
-        left: outerRef.current.offsetLeft,
-        behavior: 'smooth'
-      });
-      outerRef.current.focus();
-    };
     var dynamicLabelClasses = getDynamicLabelClasses({
       size: size,
       readOnly: readOnly,
@@ -175,8 +214,35 @@ export var textAreaRoot = function textAreaRoot(Root) {
       value: value || uncontrolledValue || defaultValue,
       rows: rows
     }, focused);
-    var optionalTextNode = innerOptional ? /*#__PURE__*/React.createElement(StyledOptionalText, null, Boolean(hasPlaceholderOptional ? placeholderLabel : label) && '\xa0', optionalText) : null;
-    return /*#__PURE__*/React.createElement(Root, {
+    var optionalTextNode = innerOptional ? /*#__PURE__*/React.createElement(StyledOptionalText, {
+      inheritFont: !hasOuterLabel
+    }, Boolean(hasPlaceholderOptional ? placeholderLabel : label) && '\xa0', optionalText) : null;
+    var HintComponent = useMemo(function () {
+      return /*#__PURE__*/React.createElement(Hint, {
+        ref: hintForkRef,
+        text: String(hintText),
+        opened: isHintVisible,
+        target: /*#__PURE__*/React.createElement(HintTargetWrapper, _extends({
+          id: hintId
+        }, hintTrigger === 'hover' ? {
+          onMouseEnter: handleHintShow,
+          onMouseLeave: handleHintHide
+        } : {
+          onClick: handleHintClick
+        }), hintTargetIcon || _IconInfoCircleOutlin || (_IconInfoCircleOutlin = /*#__PURE__*/React.createElement(IconInfoCircleOutline, {
+          size: "xs",
+          color: "inherit"
+        }))),
+        placement: hintPlacement,
+        hasArrow: hintHasArrow,
+        offset: hintOffset,
+        minWidth: hintWidth,
+        maxWidth: hintWidth,
+        contentLeft: hintContentLeft,
+        frame: hintId
+      });
+    }, [hintText, isHintVisible, hintId, hintTrigger, handleHintShow, handleHintHide, handleHintClick, hintTargetIcon, hintPlacement, hintHasArrow, hintOffset, hintWidth, hintContentLeft]);
+    return /*#__PURE__*/React.createElement(Root, _extends({
       view: overriddenView,
       size: size,
       disabled: disabled,
@@ -185,18 +251,24 @@ export var textAreaRoot = function textAreaRoot(Root) {
       style: _objectSpread({
         width: helperWidth
       }, style),
-      className: cx(clearClass, hasDividerClass, className),
-      onClick: handleTextAreaFocus
-    }, hasOuterLabel && /*#__PURE__*/React.createElement(StyledLabel, null, required && /*#__PURE__*/React.createElement(StyledIndicator, {
-      className: cx(classes.outerLabelPlacement, requiredPlacementClass)
-    }), label, optionalTextNode), /*#__PURE__*/React.createElement(StyledContainer, {
+      className: cx(clearClass, hasDividerClass, hasHintClass, className)
+    }, hasHint && {
+      hintView: hintView || 'default',
+      hintSize: hintSize || 'm'
+    }), (hasOuterLabel || titleCaption) && /*#__PURE__*/React.createElement(OuterLabelWrapper, {
+      isInnnerLabel: labelPlacement === 'inner'
+    }, hasOuterLabel && /*#__PURE__*/React.createElement(StyledIndicatorWrapper, null, /*#__PURE__*/React.createElement(StyledLabel, null, label), hasHint && /*#__PURE__*/React.createElement(StyledHintWrapper, null, HintComponent), required && /*#__PURE__*/React.createElement(StyledIndicator, {
+      className: cx(classes.outerLabelPlacement, requiredPlacementClass, hasHintClass)
+    }), optionalTextNode), titleCaption && /*#__PURE__*/React.createElement(TitleCaption, null, titleCaption)), /*#__PURE__*/React.createElement(StyledContainer, {
       className: cx.apply(void 0, [styledContainer].concat(_toConsumableArray(dynamicLabelClasses))),
       width: helperWidth,
       onFocus: onFocusHandler,
       onBlur: onBlurHandler
-    }, required && !hasOuterLabel && /*#__PURE__*/React.createElement(StyledIndicator, {
+    }, !hasOuterLabel && /*#__PURE__*/React.createElement(React.Fragment, null, required && /*#__PURE__*/React.createElement(StyledIndicator, {
       className: cx(classes.innerLabelPlacement, requiredPlacementClass)
-    }), contentRight && /*#__PURE__*/React.createElement(StyledContent, null, contentRight), /*#__PURE__*/React.createElement(StyledTextAreaWrapper, {
+    }), hasHint && /*#__PURE__*/React.createElement(StyledHintWrapper, {
+      className: classes.innerLabelPlacement
+    }, HintComponent)), contentRight && /*#__PURE__*/React.createElement(StyledContent, null, contentRight), /*#__PURE__*/React.createElement(StyledTextAreaWrapper, {
       className: styledTextAreaWrapper,
       hasHelper: hasHelper
     }, /*#__PURE__*/React.createElement(StyledTextArea, _extends({
@@ -250,6 +322,12 @@ export var textAreaConfig = {
     },
     readOnly: {
       attrs: true
+    },
+    hintView: {
+      css: hintViewCSS
+    },
+    hintSize: {
+      css: hintSizeCSS
     }
   },
   defaults: {

package/styled-components/es/components/TextArea/TextArea.styles.js

@@ -1,76 +1,119 @@
 import styled from 'styled-components';
 import { applyEllipsis } from '../../mixins';
+import { tooltipConfig } from '../Tooltip';
+import { component, mergeConfig } from '../../engines';
 import { classes, tokens } from './TextArea.tokens';
-export var StyledLabel = /*#__PURE__*/styled.div.withConfig({
+var mergedConfig = /*#__PURE__*/mergeConfig(tooltipConfig);
+var Tooltip = /*#__PURE__*/component(mergedConfig);
+export var Hint = /*#__PURE__*/styled(Tooltip).withConfig({
   componentId: "plasma-new-hope__sc-pxxv3p-0"
-})(["position:relative;display:inline-flex;margin-bottom:var(", ");color:var(", ",var(", "));font-family:var(", ",var(", "));font-size:var(", ",var(", "));font-style:var(", ",var(", "));font-weight:var(", ",var(", "));letter-spacing:var(", ",var(", "));line-height:var(", ",var(", "));"], tokens.labelMarginBottom, tokens.labelOuterColor, tokens.inputColor, tokens.labelOuterFontFamily, tokens.inputFontFamily, tokens.labelOuterFontSize, tokens.inputFontSize, tokens.labelOuterFontStyle, tokens.inputFontStyle, tokens.labelOuterFontWeight, tokens.inputFontWeight, tokens.labelOuterLetterSpacing, tokens.inputLetterSpacing, tokens.labelOuterLineHeight, tokens.inputLineHeight);
-export var StyledOptionalText = /*#__PURE__*/styled.span.withConfig({
+})([""]);
+export var OuterLabelWrapper = /*#__PURE__*/styled.div.withConfig({
   componentId: "plasma-new-hope__sc-pxxv3p-1"
-})(["color:var(", ");"], tokens.optionalColor);
-export var StyledTextAreaWrapper = /*#__PURE__*/styled.div.withConfig({
+})(["display:flex;align-items:center;margin-bottom:", ";"], function (_ref) {
+  var isInnnerLabel = _ref.isInnnerLabel;
+  return isInnnerLabel ? "var(".concat(tokens.titleCaptionInnerLabelOffset, ")") : "var(".concat(tokens.labelMarginBottom, ")");
+});
+export var StyledLabel = /*#__PURE__*/styled.div.withConfig({
   componentId: "plasma-new-hope__sc-pxxv3p-2"
-})(["background-color:var(", ");padding-top:var(", ");padding-bottom:", ";border-radius:", ";"], tokens.inputBackgroundColor, tokens.inputPaddingTop, function (_ref) {
-  var hasHelper = _ref.hasHelper;
+})(["position:relative;display:inline-flex;color:var(", ",var(", "));font-family:var(", ",var(", "));font-size:var(", ",var(", "));font-style:var(", ",var(", "));font-weight:var(", ",var(", "));letter-spacing:var(", ",var(", "));line-height:var(", ",var(", "));"], tokens.labelOuterColor, tokens.inputColor, tokens.labelOuterFontFamily, tokens.inputFontFamily, tokens.labelOuterFontSize, tokens.inputFontSize, tokens.labelOuterFontStyle, tokens.inputFontStyle, tokens.labelOuterFontWeight, tokens.inputFontWeight, tokens.labelOuterLetterSpacing, tokens.inputLetterSpacing, tokens.labelOuterLineHeight, tokens.inputLineHeight);
+export var TitleCaption = /*#__PURE__*/styled.div.withConfig({
+  componentId: "plasma-new-hope__sc-pxxv3p-3"
+})(["display:inline-block;margin-left:auto;font-family:var(", ");font-size:var(", ");font-style:var(", ");font-weight:var(", ");letter-spacing:var(", ");line-height:var(", ");"], tokens.titleCaptionFontFamily, tokens.titleCaptionFontSize, tokens.titleCaptionFontStyle, tokens.titleCaptionFontWeight, tokens.titleCaptionLetterSpacing, tokens.titleCaptionLineHeight);
+export var StyledIndicatorWrapper = /*#__PURE__*/styled.div.withConfig({
+  componentId: "plasma-new-hope__sc-pxxv3p-4"
+})(["position:relative;display:inline-flex;align-items:center;"]);
+export var StyledOptionalText = /*#__PURE__*/styled.span.withConfig({
+  componentId: "plasma-new-hope__sc-pxxv3p-5"
+})(["color:var(", ");font-family:", ";font-size:", ";font-style:", ";font-weight:", ";letter-spacing:", ";line-height:", ";"], tokens.optionalColor, function (_ref2) {
+  var inheritFont = _ref2.inheritFont;
+  return inheritFont ? 'inherit' : "var(".concat(tokens.labelOuterFontFamily, ", var(").concat(tokens.inputFontFamily, "))");
+}, function (_ref3) {
+  var inheritFont = _ref3.inheritFont;
+  return inheritFont ? 'inherit' : "var(".concat(tokens.labelOuterFontSize, ", var(").concat(tokens.inputFontSize, "))");
+}, function (_ref4) {
+  var inheritFont = _ref4.inheritFont;
+  return inheritFont ? 'inherit' : "var(".concat(tokens.labelOuterFontStyle, ", var(").concat(tokens.inputFontStyle, "))");
+}, function (_ref5) {
+  var inheritFont = _ref5.inheritFont;
+  return inheritFont ? 'inherit' : "var(".concat(tokens.labelOuterFontWeight, ", var(").concat(tokens.inputFontWeight, "))");
+}, function (_ref6) {
+  var inheritFont = _ref6.inheritFont;
+  return inheritFont ? 'inherit' : "var(".concat(tokens.labelOuterLetterSpacing, ", var(").concat(tokens.inputLetterSpacing, "))");
+}, function (_ref7) {
+  var inheritFont = _ref7.inheritFont;
+  return inheritFont ? 'inherit' : "var(".concat(tokens.labelOuterLineHeight, ", var(").concat(tokens.inputLineHeight, "))");
+});
+export var StyledHintWrapper = /*#__PURE__*/styled.div.withConfig({
+  componentId: "plasma-new-hope__sc-pxxv3p-6"
+})(["display:inline-block;line-height:0;margin:var(", ");&.", "{position:absolute;margin:0;inset:var(", ");}"], tokens.hintMargin, classes.innerLabelPlacement, tokens.hintInnerLabelPlacementOffset);
+export var HintTargetWrapper = /*#__PURE__*/styled.div.withConfig({
+  componentId: "plasma-new-hope__sc-pxxv3p-7"
+})(["color:var(", ");width:var(", ");height:var(", ");display:flex;justify-content:center;align-items:center;"], tokens.hintIconColor, tokens.hintTargetSize, tokens.hintTargetSize);
+export var StyledTextAreaWrapper = /*#__PURE__*/styled.div.withConfig({
+  componentId: "plasma-new-hope__sc-pxxv3p-8"
+})(["background-color:var(", ");padding-top:var(", ");padding-bottom:", ";border-radius:", ";"], tokens.inputBackgroundColor, tokens.inputPaddingTop, function (_ref8) {
+  var hasHelper = _ref8.hasHelper;
   return hasHelper ? "var(".concat(tokens.inputPaddingBottomWithHelpers, ")") : "var(".concat(tokens.inputPaddingBottom, ")");
-}, function (_ref2) {
-  var hasHelper = _ref2.hasHelper;
+}, function (_ref9) {
+  var hasHelper = _ref9.hasHelper;
   return hasHelper ? "var(".concat(tokens.borderRadiusWithHelpers, ")") : "var(".concat(tokens.borderRadius, ")");
 });
 export var StyledContent = /*#__PURE__*/styled.div.withConfig({
-  componentId: "plasma-new-hope__sc-pxxv3p-3"
+  componentId: "plasma-new-hope__sc-pxxv3p-9"
 })(["position:absolute;display:flex;align-items:center;bottom:0;z-index:1;color:var(", ",var(", "));top:var(", ");right:var(", ");height:var(", ");"], tokens.rightContentColor, tokens.inputColor, tokens.rightContentTop, tokens.rightContentRight, tokens.rightContentHeight);
 export var StyledContainer = /*#__PURE__*/styled.div.withConfig({
-  componentId: "plasma-new-hope__sc-pxxv3p-4"
-})(["display:inline-flex;flex-direction:column;width:", ";position:relative;"], function (_ref3) {
-  var width = _ref3.width;
+  componentId: "plasma-new-hope__sc-pxxv3p-10"
+})(["display:inline-flex;flex-direction:column;width:", ";position:relative;"], function (_ref10) {
+  var width = _ref10.width;
   return width;
 });
 export var StyledTextArea = /*#__PURE__*/styled.textarea.withConfig({
-  componentId: "plasma-new-hope__sc-pxxv3p-5"
-})(["display:block;box-sizing:border-box;outline:none;border:none;-webkit-appearance:none;background-color:transparent;color:var(", ");caret-color:var(", ");resize:", ";--plasma_private-textarea-height:", ";--plasma_private-textarea-width:", ";--plasma_private-textarea-computed-height:", ";--plasma_private-textarea-computed-width:", ";height:var(--plasma_private-textarea-computed-height);width:var(--plasma_private-textarea-computed-width);min-width:", ";max-width:", ";min-height:var(", ");padding-right:", ";padding-left:var(", ");padding-top:0;padding-bottom:0;--plasma_private-textarea-helpers-computed-height:calc( var(", ") + var(", ") + var(", ") );--plasma_private-textarea-input-with-helpers-height:calc( var(--plasma_private-textarea-height) - var(--plasma_private-textarea-helpers-computed-height) + var(", ") );--plasma_private-textarea-input-without-helpers-height:calc( var(--plasma_private-textarea-computed-height) - var(", ") );--plasma_private-textarea-input-actual-height:", ";height:var(--plasma_private-textarea-input-actual-height);font-family:var(", ");font-size:var(", ");font-style:var(", ");font-weight:var(", ");letter-spacing:var(", ");line-height:var(", ");&::placeholder{opacity:0;}&:read-only{cursor:default;}&:focus:not(:disabled){color:var(", ");}&::-webkit-scrollbar{width:var(", ");}&::-webkit-scrollbar-thumb{background-color:var(", ");background-clip:content-box;border:var(", ") solid transparent;border-radius:1rem;}&::-webkit-scrollbar-track{background-color:var(", ");background-clip:content-box;border:var(", ") solid transparent;border-radius:1rem;}"], tokens.inputColor, tokens.inputCaretColor, function (_ref4) {
-  var resize = _ref4.resize;
+  componentId: "plasma-new-hope__sc-pxxv3p-11"
+})(["display:block;box-sizing:border-box;outline:none;border:none;-webkit-appearance:none;background-color:transparent;color:var(", ");caret-color:var(", ");resize:", ";--plasma_private-textarea-height:", ";--plasma_private-textarea-width:", ";--plasma_private-textarea-computed-height:", ";--plasma_private-textarea-computed-width:", ";height:var(--plasma_private-textarea-computed-height);width:var(--plasma_private-textarea-computed-width);min-width:", ";max-width:", ";min-height:var(", ");padding-right:", ";padding-left:var(", ");padding-top:0;padding-bottom:0;--plasma_private-textarea-helpers-computed-height:calc( var(", ") + var(", ") + var(", ") );--plasma_private-textarea-input-with-helpers-height:calc( var(--plasma_private-textarea-height) - var(--plasma_private-textarea-helpers-computed-height) + var(", ") );--plasma_private-textarea-input-without-helpers-height:calc( var(--plasma_private-textarea-computed-height) - var(", ") );--plasma_private-textarea-input-actual-height:", ";height:var(--plasma_private-textarea-input-actual-height);font-family:var(", ");font-size:var(", ");font-style:var(", ");font-weight:var(", ");letter-spacing:var(", ");line-height:var(", ");&::placeholder{opacity:0;}&:read-only{cursor:default;}&:focus:not(:disabled){color:var(", ");}&::-webkit-scrollbar{width:var(", ");}&::-webkit-scrollbar-thumb{background-color:var(", ");background-clip:content-box;border:var(", ") solid transparent;border-radius:1rem;}&::-webkit-scrollbar-track{background-color:var(", ");background-clip:content-box;border:var(", ") solid transparent;border-radius:1rem;}"], tokens.inputColor, tokens.inputCaretColor, function (_ref11) {
+  var resize = _ref11.resize;
   return resize || 'none';
-}, function (_ref5) {
-  var height = _ref5.height;
+}, function (_ref12) {
+  var height = _ref12.height;
   return !Number.isNaN(Number(height)) ? "calc(".concat(height, "rem - 0.875rem)") : height || "var(".concat(tokens.inputHeight, ")");
-}, function (_ref6) {
-  var width = _ref6.width;
+}, function (_ref13) {
+  var width = _ref13.width;
   return !Number.isNaN(Number(width)) ? "".concat(width, "rem") : width || "var(".concat(tokens.inputWidth, ")");
-}, function (_ref7) {
-  var rows = _ref7.rows;
+}, function (_ref14) {
+  var rows = _ref14.rows;
   return rows ? 'unset' : 'var(--plasma_private-textarea-height)';
-}, function (_ref8) {
-  var cols = _ref8.cols;
+}, function (_ref15) {
+  var cols = _ref15.cols;
   return cols ? 'unset' : 'var(--plasma_private-textarea-width)';
-}, function (_ref9) {
-  var applyCustomWidth = _ref9.applyCustomWidth;
+}, function (_ref16) {
+  var applyCustomWidth = _ref16.applyCustomWidth;
   return applyCustomWidth ? 'var(--plasma_private-textarea-width)' : 'auto';
-}, function (_ref10) {
-  var applyCustomWidth = _ref10.applyCustomWidth;
+}, function (_ref17) {
+  var applyCustomWidth = _ref17.applyCustomWidth;
   return applyCustomWidth ? 'var(--plasma_private-textarea-width)' : 'auto';
-}, tokens.inputMinHeight, function (_ref11) {
-  var hasContentRight = _ref11.hasContentRight;
+}, tokens.inputMinHeight, function (_ref18) {
+  var hasContentRight = _ref18.hasContentRight;
   return hasContentRight ? "var(".concat(tokens.inputPaddingRightWithRightContent, ")") : "var(".concat(tokens.inputPaddingRight, ")");
-}, tokens.inputPaddingLeft, tokens.helpersPaddingTop, tokens.helpersPaddingBottom, tokens.helpersLineHeight, tokens.helpersOffset, tokens.inputPaddingBottom, function (_ref12) {
-  var hasHelper = _ref12.hasHelper,
-    rows = _ref12.rows;
+}, tokens.inputPaddingLeft, tokens.helpersPaddingTop, tokens.helpersPaddingBottom, tokens.helpersLineHeight, tokens.helpersOffset, tokens.inputPaddingBottom, function (_ref19) {
+  var hasHelper = _ref19.hasHelper,
+    rows = _ref19.rows;
   return hasHelper && !rows ? 'var(--plasma_private-textarea-input-with-helpers-height)' : 'var(--plasma_private-textarea-input-without-helpers-height)';
 }, tokens.inputFontFamily, tokens.inputFontSize, tokens.inputFontStyle, tokens.inputFontWeight, tokens.inputLetterSpacing, tokens.inputLineHeight, tokens.inputColorFocus, tokens.scrollbarWidth, tokens.scrollbarThumbBackgroundColor, tokens.scrollbarBorderWidth, tokens.scrollbarTrackBackgroundColor, tokens.scrollbarBorderWidth);
 export var StyledHelpers = /*#__PURE__*/styled.div.withConfig({
-  componentId: "plasma-new-hope__sc-pxxv3p-6"
+  componentId: "plasma-new-hope__sc-pxxv3p-12"
 })(["box-sizing:border-box;display:flex;justify-content:space-between;transition:background-color 0.1s ease-in-out;background-color:var(", ");padding-top:var(", ");padding-right:var(", ");padding-bottom:var(", ");padding-left:var(", ");border-bottom-left-radius:var(", ");border-bottom-right-radius:var(", ");"], tokens.helpersBackgroundColor, tokens.helpersPaddingTop, tokens.helpersPaddingRight, tokens.helpersPaddingBottom, tokens.helpersPaddingLeft, tokens.borderRadius, tokens.borderRadius);
 export var StyledLeftHelper = /*#__PURE__*/styled.span.withConfig({
-  componentId: "plasma-new-hope__sc-pxxv3p-7"
+  componentId: "plasma-new-hope__sc-pxxv3p-13"
 })(["", ";display:block;font-family:var(", ");font-size:var(", ");font-style:var(", ");font-weight:var(", ");letter-spacing:var(", ");line-height:var(", ");color:var(", ");"], /*#__PURE__*/applyEllipsis(), tokens.helpersFontFamily, tokens.helpersFontSize, tokens.helpersFontStyle, tokens.helpersFontWeight, tokens.helpersLetterSpacing, tokens.helpersLineHeight, tokens.leftHelperColor);
 export var StyledRightHelper = /*#__PURE__*/styled(StyledLeftHelper).withConfig({
-  componentId: "plasma-new-hope__sc-pxxv3p-8"
+  componentId: "plasma-new-hope__sc-pxxv3p-14"
 })(["color:var(", ");margin-left:auto;"], tokens.rightHelperColor);
 export var StyledPlaceholder = /*#__PURE__*/styled.label.withConfig({
-  componentId: "plasma-new-hope__sc-pxxv3p-9"
-})(["box-sizing:border-box;position:absolute;pointer-events:none;display:inline-flex;align-items:center;transition:all 0.1s ease-in-out;transform-origin:top left;color:var(", ");width:100%;height:auto;top:var(", ");padding-left:var(", ");padding-right:", ";font-family:var(", ");font-size:var(", ");font-style:var(", ");font-weight:var(", ");letter-spacing:var(", ");line-height:var(", ");"], tokens.placeholderColor, tokens.inputPaddingTop, tokens.inputPaddingLeft, function (_ref13) {
-  var hasContentRight = _ref13.hasContentRight;
+  componentId: "plasma-new-hope__sc-pxxv3p-15"
+})(["box-sizing:border-box;position:absolute;pointer-events:none;display:inline-flex;align-items:center;transition:all 0.1s ease-in-out;transform-origin:top left;color:var(", ");width:100%;height:auto;top:var(", ");padding-left:var(", ");padding-right:", ";font-family:var(", ");font-size:var(", ");font-style:var(", ");font-weight:var(", ");letter-spacing:var(", ");line-height:var(", ");"], tokens.placeholderColor, tokens.inputPaddingTop, tokens.inputPaddingLeft, function (_ref20) {
+  var hasContentRight = _ref20.hasContentRight;
   return hasContentRight ? "var(".concat(tokens.inputPaddingRightWithRightContent, ")") : "var(".concat(tokens.inputPaddingRight, ")");
 }, tokens.inputFontFamily, tokens.inputFontSize, tokens.inputFontStyle, tokens.inputFontWeight, tokens.inputLetterSpacing, tokens.inputLineHeight);
 export var StyledIndicator = /*#__PURE__*/styled.div.withConfig({
-  componentId: "plasma-new-hope__sc-pxxv3p-10"
-})(["position:absolute;border-radius:50%;background-color:var(", ");&.", "{width:var(", ");height:var(", ");inset:var(", ");&.align-right{inset:var(", ");}}&.", "{width:var(", ");height:var(", ");inset:var(", ");&.align-right{inset:var(", ");}}"], tokens.indicatorColor, classes.outerLabelPlacement, tokens.indicatorSizeOuter, tokens.indicatorSizeOuter, tokens.indicatorLabelPlacementOuter, tokens.indicatorLabelPlacementOuterRight, classes.innerLabelPlacement, tokens.indicatorSizeInner, tokens.indicatorSizeInner, tokens.indicatorLabelPlacementInner, tokens.indicatorLabelPlacementInnerRight);
+  componentId: "plasma-new-hope__sc-pxxv3p-16"
+})(["position:absolute;border-radius:50%;background-color:var(", ");&.", "{width:var(", ");height:var(", ");inset:var(", ");&.align-right{inset:var(", ");&.", "{right:calc(-1 * var(", "));}}}&.", "{width:var(", ");height:var(", ");inset:var(", ");&.align-right{inset:var(", ");}}"], tokens.indicatorColor, classes.outerLabelPlacement, tokens.indicatorSizeOuter, tokens.indicatorSizeOuter, tokens.indicatorLabelPlacementOuter, tokens.indicatorLabelPlacementOuterRight, classes.hasHint, tokens.indicatorSizeOuter, classes.innerLabelPlacement, tokens.indicatorSizeInner, tokens.indicatorSizeInner, tokens.indicatorLabelPlacementInner, tokens.indicatorLabelPlacementInnerRight);

package/styled-components/es/components/TextArea/TextArea.template-doc.mdx

@@ -134,7 +134,8 @@ export function App() {
 ```
 
 ### Подсказка
-Для вывода подсказки снизу от поля используйте свойство `leftHelper` и/или `rightHelper`.
+Для вывода подсказки снизу от поля используйте свойство `leftHelper` и/или `rightHelper`,
+для подсказки в виде Tooltip - `hasHint`, для подсказки сверху справа - `titleCaption`:
 
 ```tsx live
 import React from 'react';
@@ -148,6 +149,10 @@ export function App() {
                 defaultValue="Значение"
                 leftHelper="Подсказка снизу слева"
                 rightHelper="Подсказка снизу справа"
+                hasHint
+                hintText="Подсказка в виде Tooltip"
+                hintView="default"
+                hintSize="m"
             />
         </div>
     );