@skbkontur/react-ui 5.0.12 → 5.1.0-next.1

package/components/DatePicker/DatePicker.d.ts

@@ -6,45 +6,43 @@ import { CalendarDateShape, CalendarProps } from '../Calendar';
 import { SizeProp } from '../../lib/types/props';
 export declare const MIN_WIDTH = 120;
 export interface DatePickerProps extends Pick<CalendarProps, 'isHoliday' | 'minDate' | 'maxDate' | 'renderDay' | 'onMonthChange'>, Pick<HTMLAttributes<HTMLElement>, 'id'>, CommonProps {
+    /** Устанавливает фокус на контроле после окончания загрузки страницы. */
     autoFocus?: boolean;
+    /** Делает компонент недоступным. */
     disabled?: boolean;
-    /**
-     * Отвечает за отображение кнопки "Сегодня".
-     */
+    /** Отображает кнопку "Сегодня" в календаре. */
     enableTodayLink?: boolean;
-    /**
-     * Состояние валидации при ошибке.
-     */
+    /** Переводит контрол в состояние валидации "ошибка". */
     error?: boolean;
-    /**
-     * Позволяет вручную задать текущую позицию выпадающего окна
-     */
+    /** Задает nекущую позицию выпадающего окна вручную. */
     menuPos?: 'top' | 'bottom';
+    /** Задает выравнивание меню. */
     menuAlign?: 'left' | 'right';
+    /** Задает размер контрола. */
     size?: SizeProp;
+    /** Задает значение автокомплита. */
     value?: string | null;
-    /**
-     * Состояние валидации при предупреждении.
-     */
+    /** Переводит контрол в состояние валидации "предупреждение". */
     warning?: boolean;
+    /** Задает ширину автокомплита. */
     width?: number | string;
+    /** Задает функцию, которая вызывается при потере датапикером фокуса. */
     onBlur?: () => void;
-    /**
-     * Вызывается при изменении `value`
-     *
-     * @param value - строка в формате `dd.mm.yyyy`.
-     */
+    /** Задает функцию, вызывающуюся при изменении value.
+     * @param value - строка в формате `dd.mm.yyyy`. */
     onValueChange: (value: string) => void;
+    /** Задает функцию, которая вызывается при получении датапикером фокуса. */
     onFocus?: () => void;
+    /** Задает функцию, которая вызывается при нажатии кнопки на клавиатуре. */
     onKeyDown?: (e: React.KeyboardEvent<any>) => void;
+    /** Задает функцию, которая вызывается при наведении мышкой (событие `onmouseenter`). См разницу с onMouseOver в [документации](https://learn.javascript.ru/mousemove-mouseover-mouseout-mouseenter-mouseleave)  */
     onMouseEnter?: (e: React.MouseEvent<any>) => void;
+    /** Задает функцию, которая вызывается при уходе мышки с объекта (событие `onmouseleave`). */
     onMouseLeave?: (e: React.MouseEvent<any>) => void;
+    /** Задает функцию, которая вызывается при наведении мышкой (событие `onmouseover`). */
     onMouseOver?: (e: React.MouseEvent<any>) => void;
-    /**
-     * Использовать на мобильных устройствах нативный календарь для выбора дат.
-     *
-     * - На iOS нативный календарь не умеет работать с minDate и maxDate
-     */
+    /** Позволяет использовать на мобильных устройствах нативный календарь для выбора дат.
+     * На iOS нативный календарь не умеет работать с minDate и maxDate. */
     useMobileNativeDatePicker?: boolean;
 }
 export interface DatePickerState {
@@ -60,6 +58,13 @@ export declare const DatePickerDataTids: {
     readonly pickerTodayWrapper: "Picker__todayWrapper";
 };
 type DefaultProps = Required<Pick<DatePickerProps, 'minDate' | 'maxDate'>>;
+/**
+ * Поле `DatePicker` помогает вводить дату с клавиатуры или выбирать ее с помощью мыши.
+ *
+ * Используйте поле с датой, когда нужно ввести дату в формате ДД.ММ.ГГГГ.
+ *
+ * Поле с датой отличается от обычного поля ввода наличием иконки, маски и блока календаря.
+ */
 export declare class DatePicker extends React.PureComponent<DatePickerProps, DatePickerState> {
     static __KONTUR_REACT_UI__: string;
     static displayName: string;
@@ -102,6 +107,7 @@ export declare class DatePicker extends React.PureComponent<DatePickerProps, Dat
     private getProps;
     private theme;
     private readonly locale;
+    private canOpenPopup;
     static validate: (value: Nullable<string>, range?: {
         minDate?: string | undefined;
         maxDate?: string | undefined;
@@ -120,7 +126,9 @@ export declare class DatePicker extends React.PureComponent<DatePickerProps, Dat
     /**
      * @public
      */
-    focus(): void;
+    focus(opts?: {
+        withoutOpenDropdown?: boolean;
+    }): void;
     /**
      * Закрывает выпадашку выбора дня
      * @public
@@ -133,7 +141,9 @@ export declare class DatePicker extends React.PureComponent<DatePickerProps, Dat
     getParent: () => Nullable<Element>;
     private getRootStyle;
     private getInputRef;
+    private openPickerPopup;
     private handleFocus;
+    private handleKeyDown;
     private handleBlur;
     private handleValueChange;
     private handleSelect;

package/components/DatePicker/DatePicker.md

@@ -223,6 +223,7 @@ import { DateOrder, DateSeparator, Gapped, LocaleContext, Select, LangCodes } fr
 
 class DatePickerFormatting extends React.Component {
   constructor() {
+    super();
     this.state = {
       order: DateOrder.YMD,
       separator: 'Dot',
@@ -289,11 +290,10 @@ const renderDay = (props) => {
   if (isEven) {
     return <CalendarDay {...props} style={{ background: '#e9f8e3' }} />
   }
-  
+
   return <CalendarDay {...props} />
 };
 
-
 <DatePicker value={value} onValueChange={setValue} renderDay={renderDay} />;
 ```
 

package/components/DatePicker/__docs__/DatePicker.mdx

@@ -0,0 +1,28 @@
+import * as DatePickerStories from './DatePicker.docs.stories.tsx';
+import { Primary, ArgTypes, Stories, Description } from '@storybook/blocks';
+import { Meta } from '../../../.storybook/Meta';
+
+<Meta of={DatePickerStories} />
+
+# DatePicker
+
+[Компонент в Контур.Гайдах](https://guides.kontur.ru/components/input-fields/calendar/)
+
+[Компонент в Figma](https://www.figma.com/file/87ScqxPzJpF9DcVBNYWOjM/%E2%9A%A1-Kontur-UI-Modern-Layout?node-id=281%3A18389)
+
+<Description />
+
+## Базовый пример
+
+<Primary />
+
+## Пропы
+
+<details>
+  <summary>Открыть таблицу с пропами</summary>
+  <ArgTypes />
+</details>
+
+## Примеры использования
+
+<Stories title="" includePrimary={false} />

package/components/DatePicker/locale/types/types.js

@@ -1 +0,0 @@
-export {};

package/components/Dropdown/Dropdown/Dropdown.js

@@ -41,8 +41,14 @@ export var DropdownDataTids = {
 };
 
 /**
- * Выпадающее меню.
+ * Выпадающее меню `Dropdown`. Содержит несколько команд, объединенных по смыслу.
  *
+ * Используйте кнопку-меню:
+ * * когда не хватает места для нескольких кнопок.
+ * * когда названия действий очень длинные.
+ * * когда действия редко используются или объединены по смыслу.
+ *
+ * Не используйте `Dropdown` для выбора значения из набора вариантов. В таком случае воспользуйтесь компонентом Select.
  */
 export var Dropdown = rootNode(_class = (_Dropdown = /*#__PURE__*/function (_React$Component) {
   function Dropdown() {

package/components/Dropdown/Dropdown/Dropdown.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","PropTypes","filterProps","MenuHeader","MenuItem","MenuSeparator","Select","CommonWrapper","rootNode","ThemeContext","getDropdownTheme","PASS_PROPS","_renderButton","error","disabled","disablePortal","menuAlign","menuWidth","maxMenuHeight","use","size","warning","width","onOpen","onClose","onMouseEnter","onMouseLeave","onMouseOver","menuPos","id","DropdownDataTids","root","Dropdown","_class","_Dropdown","_React$Component","_this","_len","arguments","length","args","Array","_key","call","apply","concat","renderMain","_this$props","props","caption","icon","rest","_objectWithoutPropertiesLoose","_excluded","items","Children","map","children","item","createElement","_extends","rootNodeRef","setRootNode","ref","_refSelect","value","_icon","renderValue","element","_select","_inheritsLoose","_proto","prototype","render","_this2","Consumer","theme","Provider","open","close","Component","__KONTUR_REACT_UI__","displayName","Header","Separator","propTypes","node","isRequired","bool","number","oneOf","oneOfType","string","any","func"],"sources":["Dropdown.tsx"],"sourcesContent":["import React, { AriaAttributes, HTMLAttributes } from 'react';\nimport PropTypes from 'prop-types';\n\nimport { filterProps } from '../../lib/filterProps';\nimport { MenuHeader } from '../MenuHeader';\nimport { MenuItem } from '../MenuItem';\nimport { MenuSeparator } from '../MenuSeparator';\nimport { Select } from '../Select';\nimport { Nullable } from '../../typings/utility-types';\nimport { ButtonUse } from '../Button';\nimport { CommonWrapper, CommonProps } from '../../internal/CommonWrapper';\nimport { rootNode, TSetRootNode } from '../../lib/rootNode';\nimport { ThemeContext } from '../../lib/theming/ThemeContext';\nimport { Theme } from '../../lib/theming/Theme';\nimport { SizeProp } from '../../lib/types/props';\n\nimport { getDropdownTheme } from './getDropdownTheme';\n\nconst PASS_PROPS = {\n  _renderButton: true,\n  error: true,\n  disabled: true,\n  disablePortal: true,\n  menuAlign: true,\n  menuWidth: true,\n  maxMenuHeight: true,\n  use: true,\n  size: true,\n  warning: true,\n  width: true,\n  onOpen: true,\n  onClose: true,\n  onMouseEnter: true,\n  onMouseLeave: true,\n  onMouseOver: true,\n  menuPos: true,\n  id: true,\n  'aria-describedby': true,\n  'aria-label': true,\n};\n\nexport interface DropdownProps\n  extends Pick<AriaAttributes, 'aria-label' | 'aria-describedby'>,\n    Pick<HTMLAttributes<HTMLElement>, 'id'>,\n    CommonProps {\n  /**\n   * Подпись на кнопке.\n   */\n  caption: React.ReactNode;\n  /**\n   * Иконка слева от текста кнопки\n   */\n  icon?: React.ReactElement<any>;\n  width?: React.CSSProperties['width'];\n\n  /** @ignore */\n  _renderButton?: (params: any) => JSX.Element;\n\n  /**\n   * Отключает использование портала\n   */\n  disablePortal?: boolean;\n\n  /**\n   * Визуально отключает Dropdown\n   */\n  disabled?: boolean;\n\n  /**\n   * Состояние валидации при ошибке.\n   */\n  error?: boolean;\n  /**\n   * Состояние валидации при предупреждении.\n   */\n  warning?: boolean;\n  maxMenuHeight?: number;\n  /**\n   * Позволяет вручную задать текущую позицию выпадающего окна\n   */\n  menuPos?: 'top' | 'bottom';\n  menuAlign?: 'left' | 'right';\n  menuWidth?: number | string;\n  size?: SizeProp;\n\n  /**\n   * Смотри Button.\n   */\n  use?: ButtonUse;\n\n  /**\n   * Вызывается при закрытии меню.\n   */\n  onClose?: () => void;\n  /**\n   * Вызывается при открытии меню.\n   */\n  onOpen?: () => void;\n  onMouseEnter?: (event: React.MouseEvent<HTMLElement>) => void;\n  onMouseLeave?: (event: React.MouseEvent<HTMLElement>) => void;\n  onMouseOver?: (event: React.MouseEvent<HTMLElement>) => void;\n}\n\ntype DropdownSelectType = Select<React.ReactNode, React.ReactNode>;\n\nexport const DropdownDataTids = {\n  root: 'Dropdown__root',\n} as const;\n\n/**\n * Выпадающее меню.\n *\n */\n@rootNode\nexport class Dropdown extends React.Component<DropdownProps> {\n  public static __KONTUR_REACT_UI__ = 'Dropdown';\n  public static displayName = 'Dropdown';\n\n  public static Header = MenuHeader;\n  public static MenuItem = MenuItem;\n  public static Separator = MenuSeparator;\n\n  public static propTypes = {\n    /**\n     * Подпись на кнопке.\n     */\n    caption: PropTypes.node.isRequired,\n\n    /**\n     * Отключает использование портала\n     */\n    disablePortal: PropTypes.bool,\n\n    /**\n     * Визуально отключает Dropdown\n     */\n    disabled: PropTypes.bool,\n\n    /**\n     * Визуально показать наличие ошибки.\n     */\n    error: PropTypes.bool,\n\n    /**\n     * Иконка слева от текста кнопки\n     */\n    icon: PropTypes.node,\n\n    maxMenuHeight: PropTypes.number,\n\n    menuAlign: PropTypes.oneOf(['left', 'right']),\n\n    menuWidth: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),\n\n    size: PropTypes.oneOf(['small', 'medium', 'large']),\n\n    /**\n     * Смотри Button.\n     */\n    use: PropTypes.any,\n\n    /**\n     * Визуально показать наличие предупреждения.\n     */\n    warning: PropTypes.bool,\n\n    width: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),\n\n    /**\n     * Вызывается при закрытии меню.\n     */\n    onClose: PropTypes.func,\n\n    onMouseEnter: PropTypes.func,\n\n    onMouseLeave: PropTypes.func,\n\n    onMouseOver: PropTypes.func,\n\n    /**\n     * Вызывается при открытии меню.\n     */\n    onOpen: PropTypes.func,\n  };\n\n  private _select: Nullable<DropdownSelectType>;\n  private setRootNode!: TSetRootNode;\n  private theme!: Theme;\n\n  public render() {\n    return (\n      <ThemeContext.Consumer>\n        {(theme) => {\n          this.theme = getDropdownTheme(theme);\n          return <ThemeContext.Provider value={this.theme}>{this.renderMain()}</ThemeContext.Provider>;\n        }}\n      </ThemeContext.Consumer>\n    );\n  }\n\n  public renderMain = () => {\n    const { caption, icon, ...rest } = this.props;\n    const items = React.Children.map(this.props.children, (item) => item) || [];\n\n    return (\n      <CommonWrapper rootNodeRef={this.setRootNode} {...rest}>\n        <Select<React.ReactNode, React.ReactNode>\n          data-tid={DropdownDataTids.root}\n          ref={this._refSelect}\n          {...filterProps(rest, PASS_PROPS)}\n          value={caption}\n          items={items}\n          _icon={icon}\n          renderValue={renderValue}\n        />\n      </CommonWrapper>\n    );\n  };\n\n  /**\n   * @public\n   */\n  public open() {\n    if (this._select) {\n      this._select.open();\n    }\n  }\n\n  /**\n   * @public\n   */\n  public close() {\n    if (this._select) {\n      this._select.close();\n    }\n  }\n\n  private _refSelect = (element: DropdownSelectType): void => {\n    this._select = element;\n  };\n}\n\nfunction renderValue(value: any) {\n  return value;\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["React","PropTypes","filterProps","MenuHeader","MenuItem","MenuSeparator","Select","CommonWrapper","rootNode","ThemeContext","getDropdownTheme","PASS_PROPS","_renderButton","error","disabled","disablePortal","menuAlign","menuWidth","maxMenuHeight","use","size","warning","width","onOpen","onClose","onMouseEnter","onMouseLeave","onMouseOver","menuPos","id","DropdownDataTids","root","Dropdown","_class","_Dropdown","_React$Component","_this","_len","arguments","length","args","Array","_key","call","apply","concat","renderMain","_this$props","props","caption","icon","rest","_objectWithoutPropertiesLoose","_excluded","items","Children","map","children","item","createElement","_extends","rootNodeRef","setRootNode","ref","_refSelect","value","_icon","renderValue","element","_select","_inheritsLoose","_proto","prototype","render","_this2","Consumer","theme","Provider","open","close","Component","__KONTUR_REACT_UI__","displayName","Header","Separator","propTypes","node","isRequired","bool","number","oneOf","oneOfType","string","any","func"],"sources":["Dropdown.tsx"],"sourcesContent":["import React, { AriaAttributes, HTMLAttributes } from 'react';\nimport PropTypes from 'prop-types';\n\nimport { filterProps } from '../../lib/filterProps';\nimport { MenuHeader } from '../MenuHeader';\nimport { MenuItem } from '../MenuItem';\nimport { MenuSeparator } from '../MenuSeparator';\nimport { Select } from '../Select';\nimport { Nullable } from '../../typings/utility-types';\nimport { ButtonUse } from '../Button';\nimport { CommonWrapper, CommonProps } from '../../internal/CommonWrapper';\nimport { rootNode, TSetRootNode } from '../../lib/rootNode';\nimport { ThemeContext } from '../../lib/theming/ThemeContext';\nimport { Theme } from '../../lib/theming/Theme';\nimport { SizeProp } from '../../lib/types/props';\n\nimport { getDropdownTheme } from './getDropdownTheme';\n\nconst PASS_PROPS = {\n  _renderButton: true,\n  error: true,\n  disabled: true,\n  disablePortal: true,\n  menuAlign: true,\n  menuWidth: true,\n  maxMenuHeight: true,\n  use: true,\n  size: true,\n  warning: true,\n  width: true,\n  onOpen: true,\n  onClose: true,\n  onMouseEnter: true,\n  onMouseLeave: true,\n  onMouseOver: true,\n  menuPos: true,\n  id: true,\n  'aria-describedby': true,\n  'aria-label': true,\n};\n\nexport interface DropdownProps\n  extends Pick<AriaAttributes, 'aria-label' | 'aria-describedby'>,\n    Pick<HTMLAttributes<HTMLElement>, 'id'>,\n    CommonProps {\n  /** Задает подпись на кнопке. */\n  caption: React.ReactNode;\n\n  /** Добавляет иконку слева от текста кнопки. */\n  icon?: React.ReactElement<any>;\n\n  /** Задает ширину выпадающего меню. */\n  width?: React.CSSProperties['width'];\n\n  /** @ignore */\n  _renderButton?: (params: any) => JSX.Element;\n\n  /** Отключает использование портала. */\n  disablePortal?: boolean;\n\n  /** Делает компонент недоступным.*/\n  disabled?: boolean;\n\n  /** Переводит контрол в состояние валидации \"ошибка\". */\n  error?: boolean;\n\n  /** Переводит контрол в состояние валидации \"предупреждение\". */\n  warning?: boolean;\n\n  /** Задает максимальную высоту меню. */\n  maxMenuHeight?: number;\n\n  /** Задает текущую позицию выпадающего окна вручную.\n   */\n  menuPos?: 'top' | 'bottom';\n\n  /** Задает выравнивание выпадающего меню. */\n  menuAlign?: 'left' | 'right';\n\n  /** Задает длину меню. */\n  menuWidth?: number | string;\n\n  /** Задает размер контрола. */\n  size?: SizeProp;\n\n  /** Задаёт стиль кнопки. */\n  use?: ButtonUse;\n\n  /** Задает функцию, которая вызывается при закрытии меню. */\n  onClose?: () => void;\n\n  /** Задает функцию, которая вызывается при открытии меню. */\n  onOpen?: () => void;\n\n  /** Задает функцию, которая вызывается при наведении мышкой (событие `onmouseenter`). См разницу с onMouseOver в [документации](https://learn.javascript.ru/mousemove-mouseover-mouseout-mouseenter-mouseleave)  */\n  onMouseEnter?: (event: React.MouseEvent<HTMLElement>) => void;\n\n  /** Задает функцию, которая вызывается при уходе мышки с объекта (событие `onmouseleave`). */\n  onMouseLeave?: (event: React.MouseEvent<HTMLElement>) => void;\n\n  /** Задает функцию, которая вызывается при наведении мышкой (событие `onmouseover`). */\n  onMouseOver?: (event: React.MouseEvent<HTMLElement>) => void;\n}\n\ntype DropdownSelectType = Select<React.ReactNode, React.ReactNode>;\n\nexport const DropdownDataTids = {\n  root: 'Dropdown__root',\n} as const;\n\n/**\n * Выпадающее меню `Dropdown`. Содержит несколько команд, объединенных по смыслу.\n *\n * Используйте кнопку-меню:\n * * когда не хватает места для нескольких кнопок.\n * * когда названия действий очень длинные.\n * * когда действия редко используются или объединены по смыслу.\n *\n * Не используйте `Dropdown` для выбора значения из набора вариантов. В таком случае воспользуйтесь компонентом Select.\n */\n@rootNode\nexport class Dropdown extends React.Component<DropdownProps> {\n  public static __KONTUR_REACT_UI__ = 'Dropdown';\n  public static displayName = 'Dropdown';\n\n  public static Header = MenuHeader;\n  public static MenuItem = MenuItem;\n  public static Separator = MenuSeparator;\n\n  public static propTypes = {\n    /**\n     * Подпись на кнопке.\n     */\n    caption: PropTypes.node.isRequired,\n\n    /**\n     * Отключает использование портала\n     */\n    disablePortal: PropTypes.bool,\n\n    /**\n     * Визуально отключает Dropdown\n     */\n    disabled: PropTypes.bool,\n\n    /**\n     * Визуально показать наличие ошибки.\n     */\n    error: PropTypes.bool,\n\n    /**\n     * Иконка слева от текста кнопки\n     */\n    icon: PropTypes.node,\n\n    maxMenuHeight: PropTypes.number,\n\n    menuAlign: PropTypes.oneOf(['left', 'right']),\n\n    menuWidth: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),\n\n    size: PropTypes.oneOf(['small', 'medium', 'large']),\n\n    /**\n     * Смотри Button.\n     */\n    use: PropTypes.any,\n\n    /**\n     * Визуально показать наличие предупреждения.\n     */\n    warning: PropTypes.bool,\n\n    width: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),\n\n    /**\n     * Вызывается при закрытии меню.\n     */\n    onClose: PropTypes.func,\n\n    onMouseEnter: PropTypes.func,\n\n    onMouseLeave: PropTypes.func,\n\n    onMouseOver: PropTypes.func,\n\n    /**\n     * Вызывается при открытии меню.\n     */\n    onOpen: PropTypes.func,\n  };\n\n  private _select: Nullable<DropdownSelectType>;\n  private setRootNode!: TSetRootNode;\n  private theme!: Theme;\n\n  public render() {\n    return (\n      <ThemeContext.Consumer>\n        {(theme) => {\n          this.theme = getDropdownTheme(theme);\n          return <ThemeContext.Provider value={this.theme}>{this.renderMain()}</ThemeContext.Provider>;\n        }}\n      </ThemeContext.Consumer>\n    );\n  }\n\n  public renderMain = () => {\n    const { caption, icon, ...rest } = this.props;\n    const items = React.Children.map(this.props.children, (item) => item) || [];\n\n    return (\n      <CommonWrapper rootNodeRef={this.setRootNode} {...rest}>\n        <Select<React.ReactNode, React.ReactNode>\n          data-tid={DropdownDataTids.root}\n          ref={this._refSelect}\n          {...filterProps(rest, PASS_PROPS)}\n          value={caption}\n          items={items}\n          _icon={icon}\n          renderValue={renderValue}\n        />\n      </CommonWrapper>\n    );\n  };\n\n  /**\n   * @public\n   */\n  public open() {\n    if (this._select) {\n      this._select.open();\n    }\n  }\n\n  /**\n   * @public\n   */\n  public close() {\n    if (this._select) {\n      this._select.close();\n    }\n  }\n\n  private _refSelect = (element: DropdownSelectType): void => {\n    this._select = element;\n  };\n}\n\nfunction renderValue(value: any) {\n  return value;\n}\n"],"mappings":"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","ignoreList":[]}

package/components/Dropdown/Dropdown.d.ts

@@ -7,63 +7,58 @@ import { ButtonUse } from '../Button';
 import { CommonProps } from '../../internal/CommonWrapper';
 import { SizeProp } from '../../lib/types/props';
 export interface DropdownProps extends Pick<AriaAttributes, 'aria-label' | 'aria-describedby'>, Pick<HTMLAttributes<HTMLElement>, 'id'>, CommonProps {
-    /**
-     * Подпись на кнопке.
-     */
+    /** Задает подпись на кнопке. */
     caption: React.ReactNode;
-    /**
-     * Иконка слева от текста кнопки
-     */
+    /** Добавляет иконку слева от текста кнопки. */
     icon?: React.ReactElement<any>;
+    /** Задает ширину выпадающего меню. */
     width?: React.CSSProperties['width'];
     /** @ignore */
     _renderButton?: (params: any) => JSX.Element;
-    /**
-     * Отключает использование портала
-     */
+    /** Отключает использование портала. */
     disablePortal?: boolean;
-    /**
-     * Визуально отключает Dropdown
-     */
+    /** Делает компонент недоступным.*/
     disabled?: boolean;
-    /**
-     * Состояние валидации при ошибке.
-     */
+    /** Переводит контрол в состояние валидации "ошибка". */
     error?: boolean;
-    /**
-     * Состояние валидации при предупреждении.
-     */
+    /** Переводит контрол в состояние валидации "предупреждение". */
     warning?: boolean;
+    /** Задает максимальную высоту меню. */
     maxMenuHeight?: number;
-    /**
-     * Позволяет вручную задать текущую позицию выпадающего окна
+    /** Задает текущую позицию выпадающего окна вручную.
      */
     menuPos?: 'top' | 'bottom';
+    /** Задает выравнивание выпадающего меню. */
     menuAlign?: 'left' | 'right';
+    /** Задает длину меню. */
     menuWidth?: number | string;
+    /** Задает размер контрола. */
     size?: SizeProp;
-    /**
-     * Смотри Button.
-     */
+    /** Задаёт стиль кнопки. */
     use?: ButtonUse;
-    /**
-     * Вызывается при закрытии меню.
-     */
+    /** Задает функцию, которая вызывается при закрытии меню. */
     onClose?: () => void;
-    /**
-     * Вызывается при открытии меню.
-     */
+    /** Задает функцию, которая вызывается при открытии меню. */
     onOpen?: () => void;
+    /** Задает функцию, которая вызывается при наведении мышкой (событие `onmouseenter`). См разницу с onMouseOver в [документации](https://learn.javascript.ru/mousemove-mouseover-mouseout-mouseenter-mouseleave)  */
     onMouseEnter?: (event: React.MouseEvent<HTMLElement>) => void;
+    /** Задает функцию, которая вызывается при уходе мышки с объекта (событие `onmouseleave`). */
     onMouseLeave?: (event: React.MouseEvent<HTMLElement>) => void;
+    /** Задает функцию, которая вызывается при наведении мышкой (событие `onmouseover`). */
     onMouseOver?: (event: React.MouseEvent<HTMLElement>) => void;
 }
 export declare const DropdownDataTids: {
     readonly root: "Dropdown__root";
 };
 /**
- * Выпадающее меню.
+ * Выпадающее меню `Dropdown`. Содержит несколько команд, объединенных по смыслу.
+ *
+ * Используйте кнопку-меню:
+ * * когда не хватает места для нескольких кнопок.
+ * * когда названия действий очень длинные.
+ * * когда действия редко используются или объединены по смыслу.
  *
+ * Не используйте `Dropdown` для выбора значения из набора вариантов. В таком случае воспользуйтесь компонентом Select.
  */
 export declare class Dropdown extends React.Component<DropdownProps> {
     static __KONTUR_REACT_UI__: string;

package/components/Dropdown/Dropdown.md

@@ -1,3 +1,4 @@
+### Базовый пример
 ```jsx harmony
 import { Dropdown, MenuHeader, MenuItem, MenuSeparator } from '@skbkontur/react-ui';
 <Dropdown caption="Click">
@@ -10,7 +11,7 @@ import { Dropdown, MenuHeader, MenuItem, MenuSeparator } from '@skbkontur/react-
 </Dropdown>;
 ```
 
-У Dropdown есть 3 стандартных размера.
+### Размер
 
 ```jsx harmony
 import { Gapped, MenuItem, MenuSeparator, MenuHeader } from '@skbkontur/react-ui';

package/components/Dropdown/__docs__/Dropdown.mdx

@@ -0,0 +1,28 @@
+import * as DropdownStories from './Dropdown.docs.stories.tsx';
+import { Primary, ArgTypes, Stories, Description } from '@storybook/blocks';
+import { Meta } from '../../../.storybook/Meta';
+
+<Meta of={DropdownStories} />
+
+# Dropdown
+
+[Компонент в Контур.Гайдах](https://guides.kontur.ru/components/actions/menu-button/)
+
+[Компонент в Figma](https://www.figma.com/file/87ScqxPzJpF9DcVBNYWOjM/%E2%9A%A1-Kontur-UI-Modern-Layout?node-id=200%3A2498)
+
+<Description />
+
+## Базовый пример
+
+<Primary />
+
+## Пропы
+
+<details>
+  <summary>Открыть таблицу с пропами</summary>
+  <ArgTypes />
+</details>
+
+## Примеры использования
+
+<Stories title="" includePrimary={false} />

package/components/DropdownMenu/DropdownMenu/DropdownMenu.js

@@ -11,7 +11,7 @@ import { createPropsGetter } from "../../../lib/createPropsGetter";
 import { getDropdownMenuTheme } from "../getDropdownMenuTheme";
 
 /**
- * Меню, раскрывающееся по клику на переданный в `caption` элемент
+ * Выпадающее меню `DropdownMenu` раскрывается по клику на переданный в `caption` элемент.
  */
 export var DropdownMenu = rootNode(_class = (_DropdownMenu = /*#__PURE__*/function (_React$Component) {
   function DropdownMenu(props) {

package/components/DropdownMenu/DropdownMenu/DropdownMenu.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","ThemeContext","PopupMenu","isProductionEnv","isTestEnv","CommonWrapper","rootNode","createPropsGetter","getDropdownMenuTheme","DropdownMenu","_class","_DropdownMenu","_React$Component","props","_this","call","getProps","defaultProps","popupMenu","open","close","refPopupMenu","ref","caption","Error","_inheritsLoose","_proto","prototype","render","_this2","createElement","Consumer","theme","Provider","value","renderMain","_this$getProps","positions","disableAnimations","_extends","rootNodeRef","setRootNode","id","menuMaxHeight","menuWidth","preventIconsOffset","popupHasPin","header","footer","width","onClose","onOpen","popupMenuId","children","Component","__KONTUR_REACT_UI__","displayName"],"sources":["DropdownMenu.tsx"],"sourcesContent":["import React, { AriaAttributes, HTMLAttributes } from 'react';\n\nimport { ThemeContext } from '../../lib/theming/ThemeContext';\nimport { Nullable } from '../../typings/utility-types';\nimport { PopupMenu, PopupMenuProps } from '../../internal/PopupMenu';\nimport { isProductionEnv, isTestEnv } from '../../lib/currentEnvironment';\nimport { PopupPositionsType } from '../../internal/Popup';\nimport { CommonWrapper, CommonProps } from '../../internal/CommonWrapper';\nimport { rootNode, TSetRootNode } from '../../lib/rootNode';\nimport { createPropsGetter } from '../../lib/createPropsGetter';\n\nimport { getDropdownMenuTheme } from './getDropdownMenuTheme';\n\nexport interface DropdownMenuProps\n  extends Pick<AriaAttributes, 'aria-label'>,\n    Pick<HTMLAttributes<HTMLElement>, 'id'>,\n    Pick<PopupMenuProps, 'onOpen' | 'onClose' | 'popupMenuId' | 'preventIconsOffset'>,\n    CommonProps {\n  /** Максимальная высота меню */\n  menuMaxHeight?: React.CSSProperties['maxWidth'];\n  /** Ширина меню */\n  menuWidth?: React.CSSProperties['width'];\n  /** Ширина caption */\n  width?: React.CSSProperties['width'];\n\n  /**\n   * Элемент или функция возвращающая элемент,\n   * если передана, используется вместо `caption`,\n   * в таком случае управлять открытием и закрытием меню\n   * придется в этой функции\n   */\n  caption: PopupMenuProps['caption'];\n\n  /**\n   * Произвольный элемент, который будет отрендерен в шапке меню.\n   *\n   * _Примечание_: контрол [MenuHeader](#/Components/MenuHeader) передаётся только в `children` меню-контролов. Не стоит передавать `MenuHeader` в `header`.\n   */\n  header?: React.ReactNode;\n  /**\n   * Произвольный элемент, который будет отрендерен в подвале меню.\n   *\n   * Перед элементом переданным в `footer` будет отрендерен [MenuSeparator](#/Components/MenuSeparator).\n   */\n  footer?: React.ReactNode;\n  /**\n   *  Список позиций доступных для расположения выпадашки относительно `caption`.\n   *\n   * Если во всех позициях выпадашка вылезает за пределы `viewport`, будет использована первая из этого списка.\n   *\n   * **Возможные значения**: `top left`, `top center`, `top right`, `right top`, `right middle`, `right bottom`, `bottom left`, `bottom center`, `bottom right`, `left top`, `left middle`, `left bottom`\n   * @default ['bottom left', 'bottom right', 'top left', 'top right']\n   */\n  positions?: PopupPositionsType[];\n\n  /**\n   * Не показывать анимацию\n   */\n  disableAnimations?: boolean;\n}\n\ntype DefaultProps = Required<Pick<DropdownMenuProps, 'disableAnimations' | 'positions'>>;\n\n/**\n * Меню, раскрывающееся по клику на переданный в `caption` элемент\n */\n@rootNode\nexport class DropdownMenu extends React.Component<DropdownMenuProps> {\n  public static __KONTUR_REACT_UI__ = 'DropdownMenu';\n  public static displayName = 'DropdownMenu';\n\n  public static defaultProps: DefaultProps = {\n    disableAnimations: isTestEnv,\n    positions: ['bottom left', 'bottom right', 'top left', 'top right'],\n  };\n\n  private getProps = createPropsGetter(DropdownMenu.defaultProps);\n\n  private popupMenu: Nullable<PopupMenu> = null;\n  private setRootNode!: TSetRootNode;\n\n  constructor(props: DropdownMenuProps) {\n    super(props);\n\n    if (!props.caption && !isProductionEnv) {\n      throw new Error('Prop \"caption\" is required!!!');\n    }\n  }\n\n  public render() {\n    return (\n      <ThemeContext.Consumer>\n        {(theme) => {\n          return <ThemeContext.Provider value={getDropdownMenuTheme(theme)}>{this.renderMain()}</ThemeContext.Provider>;\n        }}\n      </ThemeContext.Consumer>\n    );\n  }\n\n  public renderMain() {\n    if (!this.props.caption) {\n      return null;\n    }\n    const { positions, disableAnimations } = this.getProps();\n    return (\n      <CommonWrapper rootNodeRef={this.setRootNode} {...this.props}>\n        <PopupMenu\n          id={this.props.id}\n          aria-label={this.props['aria-label']}\n          ref={this.refPopupMenu}\n          caption={this.props.caption}\n          menuMaxHeight={this.props.menuMaxHeight}\n          menuWidth={this.props.menuWidth}\n          preventIconsOffset={this.props.preventIconsOffset}\n          popupHasPin={false}\n          positions={positions}\n          disableAnimations={disableAnimations}\n          header={this.props.header}\n          footer={this.props.footer}\n          width={this.props.width}\n          onClose={this.props.onClose}\n          onOpen={this.props.onOpen}\n          popupMenuId={this.props.popupMenuId}\n        >\n          {this.props.children}\n        </PopupMenu>\n      </CommonWrapper>\n    );\n  }\n\n  public open = (): void => {\n    if (this.popupMenu) {\n      this.popupMenu.open();\n    }\n  };\n\n  public close = (): void => {\n    if (this.popupMenu) {\n      this.popupMenu.close();\n    }\n  };\n\n  private refPopupMenu = (ref: Nullable<PopupMenu>) => (this.popupMenu = ref);\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["React","ThemeContext","PopupMenu","isProductionEnv","isTestEnv","CommonWrapper","rootNode","createPropsGetter","getDropdownMenuTheme","DropdownMenu","_class","_DropdownMenu","_React$Component","props","_this","call","getProps","defaultProps","popupMenu","open","close","refPopupMenu","ref","caption","Error","_inheritsLoose","_proto","prototype","render","_this2","createElement","Consumer","theme","Provider","value","renderMain","_this$getProps","positions","disableAnimations","_extends","rootNodeRef","setRootNode","id","menuMaxHeight","menuWidth","preventIconsOffset","popupHasPin","header","footer","width","onClose","onOpen","popupMenuId","children","Component","__KONTUR_REACT_UI__","displayName"],"sources":["DropdownMenu.tsx"],"sourcesContent":["import React, { AriaAttributes, HTMLAttributes } from 'react';\n\nimport { ThemeContext } from '../../lib/theming/ThemeContext';\nimport { Nullable } from '../../typings/utility-types';\nimport { PopupMenu, PopupMenuProps } from '../../internal/PopupMenu';\nimport { isProductionEnv, isTestEnv } from '../../lib/currentEnvironment';\nimport { PopupPositionsType } from '../../internal/Popup';\nimport { CommonWrapper, CommonProps } from '../../internal/CommonWrapper';\nimport { rootNode, TSetRootNode } from '../../lib/rootNode';\nimport { createPropsGetter } from '../../lib/createPropsGetter';\n\nimport { getDropdownMenuTheme } from './getDropdownMenuTheme';\n\nexport interface DropdownMenuProps\n  extends Pick<AriaAttributes, 'aria-label'>,\n    Pick<HTMLAttributes<HTMLElement>, 'id'>,\n    Pick<PopupMenuProps, 'onOpen' | 'onClose' | 'popupMenuId' | 'preventIconsOffset'>,\n    CommonProps {\n  /** Максимальная высота меню */\n  menuMaxHeight?: React.CSSProperties['maxWidth'];\n  /** Ширина меню */\n  menuWidth?: React.CSSProperties['width'];\n  /** Ширина caption */\n  width?: React.CSSProperties['width'];\n\n  /**\n   * Элемент или функция возвращающая элемент,\n   * если передана, используется вместо `caption`,\n   * в таком случае управлять открытием и закрытием меню\n   * придется в этой функции\n   */\n  caption: PopupMenuProps['caption'];\n\n  /**\n   * Произвольный элемент, который будет отрендерен в шапке меню.\n   *\n   * _Примечание_: контрол [MenuHeader](#/Components/MenuHeader) передаётся только в `children` меню-контролов. Не стоит передавать `MenuHeader` в `header`.\n   */\n  header?: React.ReactNode;\n  /**\n   * Произвольный элемент, который будет отрендерен в подвале меню.\n   *\n   * Перед элементом переданным в `footer` будет отрендерен [MenuSeparator](#/Components/MenuSeparator).\n   */\n  footer?: React.ReactNode;\n  /**\n   *  Список позиций доступных для расположения выпадашки относительно `caption`.\n   *\n   * Если во всех позициях выпадашка вылезает за пределы `viewport`, будет использована первая из этого списка.\n   *\n   * **Возможные значения**: `top left`, `top center`, `top right`, `right top`, `right middle`, `right bottom`, `bottom left`, `bottom center`, `bottom right`, `left top`, `left middle`, `left bottom`\n   * @default ['bottom left', 'bottom right', 'top left', 'top right']\n   */\n  positions?: PopupPositionsType[];\n\n  /**\n   * Не показывать анимацию\n   */\n  disableAnimations?: boolean;\n}\n\ntype DefaultProps = Required<Pick<DropdownMenuProps, 'disableAnimations' | 'positions'>>;\n\n/**\n * Выпадающее меню `DropdownMenu` раскрывается по клику на переданный в `caption` элемент.\n */\n@rootNode\nexport class DropdownMenu extends React.Component<DropdownMenuProps> {\n  public static __KONTUR_REACT_UI__ = 'DropdownMenu';\n  public static displayName = 'DropdownMenu';\n\n  public static defaultProps: DefaultProps = {\n    disableAnimations: isTestEnv,\n    positions: ['bottom left', 'bottom right', 'top left', 'top right'],\n  };\n\n  private getProps = createPropsGetter(DropdownMenu.defaultProps);\n\n  private popupMenu: Nullable<PopupMenu> = null;\n  private setRootNode!: TSetRootNode;\n\n  constructor(props: DropdownMenuProps) {\n    super(props);\n\n    if (!props.caption && !isProductionEnv) {\n      throw new Error('Prop \"caption\" is required!!!');\n    }\n  }\n\n  public render() {\n    return (\n      <ThemeContext.Consumer>\n        {(theme) => {\n          return <ThemeContext.Provider value={getDropdownMenuTheme(theme)}>{this.renderMain()}</ThemeContext.Provider>;\n        }}\n      </ThemeContext.Consumer>\n    );\n  }\n\n  public renderMain() {\n    if (!this.props.caption) {\n      return null;\n    }\n    const { positions, disableAnimations } = this.getProps();\n    return (\n      <CommonWrapper rootNodeRef={this.setRootNode} {...this.props}>\n        <PopupMenu\n          id={this.props.id}\n          aria-label={this.props['aria-label']}\n          ref={this.refPopupMenu}\n          caption={this.props.caption}\n          menuMaxHeight={this.props.menuMaxHeight}\n          menuWidth={this.props.menuWidth}\n          preventIconsOffset={this.props.preventIconsOffset}\n          popupHasPin={false}\n          positions={positions}\n          disableAnimations={disableAnimations}\n          header={this.props.header}\n          footer={this.props.footer}\n          width={this.props.width}\n          onClose={this.props.onClose}\n          onOpen={this.props.onOpen}\n          popupMenuId={this.props.popupMenuId}\n        >\n          {this.props.children}\n        </PopupMenu>\n      </CommonWrapper>\n    );\n  }\n\n  public open = (): void => {\n    if (this.popupMenu) {\n      this.popupMenu.open();\n    }\n  };\n\n  public close = (): void => {\n    if (this.popupMenu) {\n      this.popupMenu.close();\n    }\n  };\n\n  private refPopupMenu = (ref: Nullable<PopupMenu>) => (this.popupMenu = ref);\n}\n"],"mappings":"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","ignoreList":[]}

package/components/DropdownMenu/DropdownMenu.d.ts

@@ -44,7 +44,7 @@ export interface DropdownMenuProps extends Pick<AriaAttributes, 'aria-label'>, P
 }
 type DefaultProps = Required<Pick<DropdownMenuProps, 'disableAnimations' | 'positions'>>;
 /**
- * Меню, раскрывающееся по клику на переданный в `caption` элемент
+ * Выпадающее меню `DropdownMenu` раскрывается по клику на переданный в `caption` элемент.
  */
 export declare class DropdownMenu extends React.Component<DropdownMenuProps> {
     static __KONTUR_REACT_UI__: string;

package/components/DropdownMenu/DropdownMenu.md

@@ -1,4 +1,4 @@
-Базовый пример меню.
+### Базовый пример меню
 
 ```jsx harmony
 import { Button, MenuHeader, MenuItem, MenuSeparator } from '@skbkontur/react-ui';
@@ -43,7 +43,7 @@ import { Button, MenuHeader, MenuItem, MenuSeparator } from '@skbkontur/react-ui
 </DropdownMenu>;
 ```
 
-Меню с заданной шириной.
+### Ширина
 
 ```jsx harmony
 import { Button, MenuHeader, MenuItem, MenuSeparator } from '@skbkontur/react-ui';
@@ -61,7 +61,7 @@ import { Button, MenuHeader, MenuItem, MenuSeparator } from '@skbkontur/react-ui
 </DropdownMenu>;
 ```
 
-Меню с заданной максимальной высотой.
+### Максимальная высота
 
 ```jsx harmony
 import { Button, MenuHeader, MenuItem, MenuSeparator } from '@skbkontur/react-ui';
@@ -79,7 +79,7 @@ import { Button, MenuHeader, MenuItem, MenuSeparator } from '@skbkontur/react-ui
 </DropdownMenu>;
 ```
 
-Меню с выпадашкой слева по центру.
+### Выпадашка слева по центру
 
 ```jsx harmony
 import { Button, MenuHeader, MenuItem, MenuSeparator } from '@skbkontur/react-ui';
@@ -97,7 +97,7 @@ import { Button, MenuHeader, MenuItem, MenuSeparator } from '@skbkontur/react-ui
 </DropdownMenu>;
 ```
 
-Меню c шапкой и подвалом.
+### Меню c шапкой и подвалом
 
 ```jsx harmony
 import { Button, MenuHeader, MenuItem, MenuSeparator } from '@skbkontur/react-ui';
@@ -113,7 +113,7 @@ import { Button, MenuHeader, MenuItem, MenuSeparator } from '@skbkontur/react-ui
 </DropdownMenu>;
 ```
 
-С иконками и включенным по-умолчанию автоматическим выравниванием текста.
+### Иконка и автовыравнивание текста
 
 ```jsx harmony
 import { Button, MenuHeader, MenuItem, MenuSeparator, DropdownMenu } from '@skbkontur/react-ui';
@@ -127,7 +127,7 @@ import OkIcon from '@skbkontur/react-icons/Ok';
 </DropdownMenu>;
 ```
 
-С иконками и отключенным автоматическим выравниванием текста.
+### Иконка и отключенное автовыравнивание текста
 
 ```jsx harmony
 import { Button, MenuHeader, MenuItem, MenuSeparator, DropdownMenu } from '@skbkontur/react-ui';
@@ -141,7 +141,7 @@ import OkIcon from '@skbkontur/react-icons/Ok';
 </DropdownMenu>
 ```
 
-Меню с отключенной анимацией.
+### Отключенная анимация
 
 ```jsx harmony
 import { Button, MenuHeader, MenuItem, MenuSeparator } from '@skbkontur/react-ui';
@@ -158,6 +158,7 @@ import { Button, MenuHeader, MenuItem, MenuSeparator } from '@skbkontur/react-ui
 </DropdownMenu>;
 ```
 
+### Подпись
 В `caption` можно передать любой элемент.
 
 ```jsx harmony
@@ -178,7 +179,7 @@ import { MenuItem } from '@skbkontur/react-ui';
 </DropdownMenu>;
 ```
 
-Пример с чекбоксом внутри MenuItem.
+### Чекбокс внутри MenuItem
 
 ```jsx harmony
 import { MenuItem, Checkbox, Button, ThemeContext, ThemeFactory } from '@skbkontur/react-ui';
@@ -219,7 +220,8 @@ const renderCaption = ({ openMenu, closeMenu }) => {
 </DropdownMenu>
 ```
 
-Условный рендер элементов меню (с сохранением поведения [MenuItem](#/Components/MenuItem)).
+### Условный рендер элементов меню
+(с сохранением поведения [MenuItem](#/Components/MenuItem))
 
 ```jsx harmony
 import {Button, MenuItem, Gapped, MenuSeparator} from '@skbkontur/react-ui';

package/components/DropdownMenu/__docs__/DropdownMenu.mdx

@@ -0,0 +1,28 @@
+import * as DropdownMenuStories from './DropdownMenu.docs.stories.tsx';
+import { Primary, ArgTypes, Stories, Description } from '@storybook/blocks';
+import { Meta } from '../../../.storybook/Meta';
+
+<Meta of={DropdownMenuStories} />
+
+# DropdownMenu
+
+[Компонент в Контур.Гайдах](https://guides.kontur.ru/components/actions/menu-button/)
+
+[Компонент в Figma](https://www.figma.com/design/87ScqxPzJpF9DcVBNYWOjM/%E2%9A%A1-Kontur-UI?node-id=200-2498&t=I8Bp7OCi6jgkyIbR-0)
+
+<Description />
+
+## Базовый пример
+
+<Primary />
+
+## Пропы
+
+<details>
+  <summary>Открыть таблицу с пропами</summary>
+  <ArgTypes />
+</details>
+
+## Примеры использования
+
+<Stories title="" includePrimary={false} />

package/components/FileUploader/FileUploader/FileUploader.js

@@ -329,6 +329,12 @@ var _FileUploader = forwardRefAndName('FileUploader', function (props, ref) {
     })))))))
   );
 });
+
+/**
+ * `FileUploader` — контрол для выбора пользователем файла на компьютере и отображения статуса его отправки на сервер.
+ *
+ * Можно использовать для синхронной отправки данных, например, в форме. Или же можно использовать в асинхронном режиме.
+ */
 export var FileUploader = withFileUploaderControlProvider( /*#__PURE__*/
 React.memo(_FileUploader));
 FileUploader.displayName = 'FileUploader';