@skbkontur/react-ui 4.5.1 → 4.5.2

package/components/Loader/Loader.md

@@ -1,25 +1,32 @@
 ```jsx harmony
-<Loader type="big" active>
-  <h1>Yeah, and if you were the pope they'd be all, "Straighten your pope hat." And "Put on your good vestments."</h1>
-  <p>
-    No, I'm Santa Claus! I guess if you want children beaten, you have to do it yourself. We're also Santa Claus! Leela,
-    Bender, we're going grave robbing.
-  </p>
-  <p>
-    Are you crazy? I can't swallow that. Large bet on myself in round one. Hey, whatcha watching?
-    <strong> Moving along… I guess if you want children beaten, you have to do it yourself.</strong>
-    <em>It's okay, Bender.</em> I like cooking too.
-  </p>
-  <h2>Oh, I think we should just stay friends.</h2>
-  <p>
-    No argument here. And when we woke up, we had these bodies. You guys go on without me! I'm going to go… look for
-    more stuff to steal! Oh, how awful. Did he at least die painlessly? …To shreds, you say. Well, how is his wife
-    holding up? …To shreds, you say.
-  </p>
-  <ol>
-    <li>No! The kind with looting and maybe starting a few fires!</li>
-    <li>You are the last hope of the universe.</li>
-    <li>Hey, guess what you're accessories to.</li>
-  </ol>
-</Loader>
+import { Button } from '@skbkontur/react-ui';
+
+const [isActive, setIsActive] = React.useState(true);
+
+<>
+  <Button onClick={() => setIsActive(!isActive)}>{isActive ? 'Остановить загрузку' : 'Продолжить загрузку'}</Button>
+  <Loader type="big" active={isActive}>
+    <h1>Yeah, and if you were the pope they'd be all, "Straighten your pope hat." And "Put on your good vestments."</h1>
+    <p>
+      No, I'm Santa Claus! I guess if you want children beaten, you have to do it yourself. We're also Santa Claus! Leela,
+      Bender, we're going grave robbing.
+    </p>
+    <p>
+      Are you crazy? I can't swallow that. Large bet on myself in round one. Hey, whatcha watching?
+      <strong> Moving along… I guess if you want children beaten, you have to do it yourself.</strong>
+      <em>It's okay, Bender.</em> I like cooking too.
+    </p>
+    <h2>Oh, I think we should just stay friends.</h2>
+    <p>
+      No argument here. And when we woke up, we had these bodies. You guys go on without me! I'm going to go… look for
+      more stuff to steal! Oh, how awful. Did he at least die painlessly? …To shreds, you say. Well, how is his wife
+      holding up? …To shreds, you say.
+    </p>
+    <ol>
+      <li>No! The kind with looting and maybe starting a few fires!</li>
+      <li>You are the last hope of the universe.</li>
+      <li>Hey, guess what you're accessories to.</li>
+    </ol>
+  </Loader>
+</>
 ```

package/components/Select/Select.md

@@ -8,6 +8,20 @@ const items = [Select.static(() => <Select.Item>Not selectable</Select.Item>), '
 <Select items={items} value={value} onValueChange={setValue} />;
 ```
 
+Очистить значение в `Select`'е можно только с помощью `null`
+```jsx harmony
+import { Button, Group } from '@skbkontur/react-ui';
+
+const [value, setValue] = React.useState();
+
+const items = ['One', 'Two', 'Three', 'Four'];
+
+<Group>
+  <Select items={items} value={value} onValueChange={setValue} />
+  <Button onClick={() => setValue(null)}>Очистить</Button>
+</Group>
+```
+
 Пример с полем поиска.
 
 ```jsx harmony

package/components/Spinner/Spinner/Spinner.js

@@ -24,7 +24,7 @@ export var SpinnerDataTids = {
 };
 export
 /**
-* DRAFT - инлайн-лоадер
+* Используйте компонент `Spinner`, если вам нужен спиннер, без дополнительного функционала, который предоставляет компонент [Loader](https://tech.skbkontur.ru/react-ui/#/Components/Loader)
 */
 var Spinner = (_dec = locale('Spinner', SpinnerLocaleHelper), rootNode(_class = _dec(_class = (_temp = _class2 = /*#__PURE__*/function (_React$Component) {
   _inheritsLoose(Spinner, _React$Component);

package/components/Spinner/Spinner/Spinner.js.map

@@ -1 +1 @@
-{"version":3,"sources":["Spinner.tsx"],"names":["React","PropTypes","locale","ThemeContext","SpinnerIcon","CommonWrapper","cx","rootNode","createPropsGetter","styles","SpinnerLocaleHelper","types","big","mini","normal","SpinnerDataTids","root","Spinner","getProps","defaultProps","renderSpinner","type","dimmed","inline","circle","theme","props","color","circleDimmedColor","circleWithoutColorAnimation","width","renderCaption","caption","captionColor","render","renderMain","loading","setRootNode","spinner","inner","Component","__KONTUR_REACT_UI__","propTypes","node","bool","oneOf","Object","keys","Types"],"mappings":"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","sourcesContent":["import React from 'react';\nimport PropTypes from 'prop-types';\n\nimport { locale } from '../../lib/locale/decorators';\nimport { Theme } from '../../lib/theming/Theme';\nimport { ThemeContext } from '../../lib/theming/ThemeContext';\nimport { SpinnerIcon } from '../../internal/icons/SpinnerIcon';\nimport { CommonProps, CommonWrapper } from '../../internal/CommonWrapper';\nimport { cx } from '../../lib/theming/Emotion';\nimport { rootNode, TSetRootNode } from '../../lib/rootNode';\nimport { createPropsGetter } from '../../lib/createPropsGetter';\n\nimport { styles } from './Spinner.styles';\nimport { SpinnerLocale, SpinnerLocaleHelper } from './locale';\n\nconst types: Record<SpinnerType, SpinnerType> = {\n  big: 'big',\n  mini: 'mini',\n  normal: 'normal',\n};\n\nexport type SpinnerType = 'mini' | 'normal' | 'big';\n\nexport interface SpinnerProps extends CommonProps {\n  caption?: React.ReactNode;\n  dimmed?: boolean;\n  /**\n   * Тип спиннера\n   * @default normal\n   */\n  type?: SpinnerType;\n  inline?: boolean;\n  /**\n   * Толщина спиннера\n   */\n  width?: number;\n  /**\n   * Цвет спиннера\n   */\n  color?: React.CSSProperties['color'];\n}\n\nexport const SpinnerDataTids = {\n  root: 'Spinner__root',\n} as const;\n\ntype DefaultProps = Required<Pick<SpinnerProps, 'type'>>;\n\n/**\n * DRAFT - инлайн-лоадер\n */\n\n@rootNode\n@locale('Spinner', SpinnerLocaleHelper)\nexport class Spinner extends React.Component<SpinnerProps> {\n  public static __KONTUR_REACT_UI__ = 'Spinner';\n\n  public static propTypes = {\n    /**\n     * Текст рядом с мини-лоадером.\n     *\n     * 'Загрузка' - значение по-умолчанию\n     */\n    caption: PropTypes.node,\n\n    dimmed: PropTypes.bool,\n\n    /**\n     * Тип спиннера: mini, normal, big\n     *\n     * Значение по-умолчанию - normal\n     *\n     * Spinner.types - все доступные типы\n     */\n    type: PropTypes.oneOf(Object.keys(types)),\n  };\n\n  public static defaultProps: DefaultProps = {\n    type: 'normal',\n  };\n\n  private getProps = createPropsGetter(Spinner.defaultProps);\n\n  public static Types: typeof types = types;\n  private theme!: Theme;\n  private readonly locale!: SpinnerLocale;\n  private setRootNode!: TSetRootNode;\n\n  public render() {\n    return (\n      <ThemeContext.Consumer>\n        {(theme) => {\n          this.theme = theme;\n          return this.renderMain();\n        }}\n      </ThemeContext.Consumer>\n    );\n  }\n\n  private renderMain() {\n    const { caption = this.locale.loading, dimmed, inline } = this.props;\n    const type = this.getProps().type;\n\n    return (\n      <CommonWrapper rootNodeRef={this.setRootNode} {...this.props}>\n        <div data-tid={SpinnerDataTids.root} className={styles.spinner()}>\n          <span className={styles.inner()}>{this.renderSpinner(type, dimmed, inline)}</span>\n          {caption && this.renderCaption(type, caption)}\n        </div>\n      </CommonWrapper>\n    );\n  }\n\n  private renderSpinner = (type: SpinnerType, dimmed?: boolean, inline?: boolean) => {\n    return (\n      <SpinnerIcon\n        size={type}\n        className={cx({\n          [styles.circle(this.theme)]: !dimmed && !this.props.color,\n          [styles.circleDimmedColor(this.theme)]: dimmed,\n          [styles.circleWithoutColorAnimation()]: dimmed || !!this.props.color,\n        })}\n        dimmed={dimmed}\n        width={this.props.width}\n        color={this.props.color}\n        inline={inline}\n      />\n    );\n  };\n\n  private renderCaption = (type: SpinnerType, caption: React.ReactNode) => (\n    <span className={cx(styles[type](this.theme), styles.captionColor(this.theme))}>{caption}</span>\n  );\n}\n"]}
+{"version":3,"sources":["Spinner.tsx"],"names":["React","PropTypes","locale","ThemeContext","SpinnerIcon","CommonWrapper","cx","rootNode","createPropsGetter","styles","SpinnerLocaleHelper","types","big","mini","normal","SpinnerDataTids","root","Spinner","getProps","defaultProps","renderSpinner","type","dimmed","inline","circle","theme","props","color","circleDimmedColor","circleWithoutColorAnimation","width","renderCaption","caption","captionColor","render","renderMain","loading","setRootNode","spinner","inner","Component","__KONTUR_REACT_UI__","propTypes","node","bool","oneOf","Object","keys","Types"],"mappings":"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","sourcesContent":["import React from 'react';\nimport PropTypes from 'prop-types';\n\nimport { locale } from '../../lib/locale/decorators';\nimport { Theme } from '../../lib/theming/Theme';\nimport { ThemeContext } from '../../lib/theming/ThemeContext';\nimport { SpinnerIcon } from '../../internal/icons/SpinnerIcon';\nimport { CommonProps, CommonWrapper } from '../../internal/CommonWrapper';\nimport { cx } from '../../lib/theming/Emotion';\nimport { rootNode, TSetRootNode } from '../../lib/rootNode';\nimport { createPropsGetter } from '../../lib/createPropsGetter';\n\nimport { styles } from './Spinner.styles';\nimport { SpinnerLocale, SpinnerLocaleHelper } from './locale';\n\nconst types: Record<SpinnerType, SpinnerType> = {\n  big: 'big',\n  mini: 'mini',\n  normal: 'normal',\n};\n\nexport type SpinnerType = 'mini' | 'normal' | 'big';\n\nexport interface SpinnerProps extends CommonProps {\n  /**\n   * Подпись под спиннером\n   */\n  caption?: React.ReactNode;\n  /**\n   * Переводит спиннер в \"затемнённый режим\"\n   *\n   * Цвет спиннера в \"затемнённом режиме\" определяется переменной `spinnerDimmedColor`\n   */\n  dimmed?: boolean;\n  /**\n   * Размер спиннера и текста\n   *\n   * @default normal\n   */\n  type?: SpinnerType;\n  inline?: boolean;\n  /**\n   * Толщина спиннера\n   */\n  width?: number;\n  /**\n   * Цвет спиннера\n   */\n  color?: React.CSSProperties['color'];\n}\n\nexport const SpinnerDataTids = {\n  root: 'Spinner__root',\n} as const;\n\ntype DefaultProps = Required<Pick<SpinnerProps, 'type'>>;\n\n/**\n * Используйте компонент `Spinner`, если вам нужен спиннер, без дополнительного функционала, который предоставляет компонент [Loader](https://tech.skbkontur.ru/react-ui/#/Components/Loader)\n */\n\n@rootNode\n@locale('Spinner', SpinnerLocaleHelper)\nexport class Spinner extends React.Component<SpinnerProps> {\n  public static __KONTUR_REACT_UI__ = 'Spinner';\n\n  public static propTypes = {\n    /**\n     * Текст рядом с мини-лоадером.\n     *\n     * 'Загрузка' - значение по-умолчанию\n     */\n    caption: PropTypes.node,\n\n    dimmed: PropTypes.bool,\n\n    /**\n     * Тип спиннера: mini, normal, big\n     *\n     * Значение по-умолчанию - normal\n     *\n     * Spinner.types - все доступные типы\n     */\n    type: PropTypes.oneOf(Object.keys(types)),\n  };\n\n  public static defaultProps: DefaultProps = {\n    type: 'normal',\n  };\n\n  private getProps = createPropsGetter(Spinner.defaultProps);\n\n  public static Types: typeof types = types;\n  private theme!: Theme;\n  private readonly locale!: SpinnerLocale;\n  private setRootNode!: TSetRootNode;\n\n  public render() {\n    return (\n      <ThemeContext.Consumer>\n        {(theme) => {\n          this.theme = theme;\n          return this.renderMain();\n        }}\n      </ThemeContext.Consumer>\n    );\n  }\n\n  private renderMain() {\n    const { caption = this.locale.loading, dimmed, inline } = this.props;\n    const type = this.getProps().type;\n\n    return (\n      <CommonWrapper rootNodeRef={this.setRootNode} {...this.props}>\n        <div data-tid={SpinnerDataTids.root} className={styles.spinner()}>\n          <span className={styles.inner()}>{this.renderSpinner(type, dimmed, inline)}</span>\n          {caption && this.renderCaption(type, caption)}\n        </div>\n      </CommonWrapper>\n    );\n  }\n\n  private renderSpinner = (type: SpinnerType, dimmed?: boolean, inline?: boolean) => {\n    return (\n      <SpinnerIcon\n        size={type}\n        className={cx({\n          [styles.circle(this.theme)]: !dimmed && !this.props.color,\n          [styles.circleDimmedColor(this.theme)]: dimmed,\n          [styles.circleWithoutColorAnimation()]: dimmed || !!this.props.color,\n        })}\n        dimmed={dimmed}\n        width={this.props.width}\n        color={this.props.color}\n        inline={inline}\n      />\n    );\n  };\n\n  private renderCaption = (type: SpinnerType, caption: React.ReactNode) => (\n    <span className={cx(styles[type](this.theme), styles.captionColor(this.theme))}>{caption}</span>\n  );\n}\n"]}

package/components/Spinner/Spinner.d.ts

@@ -4,10 +4,19 @@ import { CommonProps } from '../../internal/CommonWrapper';
 declare const types: Record<SpinnerType, SpinnerType>;
 export declare type SpinnerType = 'mini' | 'normal' | 'big';
 export interface SpinnerProps extends CommonProps {
+    /**
+     * Подпись под спиннером
+     */
     caption?: React.ReactNode;
+    /**
+     * Переводит спиннер в "затемнённый режим"
+     *
+     * Цвет спиннера в "затемнённом режиме" определяется переменной `spinnerDimmedColor`
+     */
     dimmed?: boolean;
     /**
-     * Тип спиннера
+     * Размер спиннера и текста
+     *
      * @default normal
      */
     type?: SpinnerType;
@@ -26,7 +35,7 @@ export declare const SpinnerDataTids: {
 };
 declare type DefaultProps = Required<Pick<SpinnerProps, 'type'>>;
 /**
- * DRAFT - инлайн-лоадер
+ * Используйте компонент `Spinner`, если вам нужен спиннер, без дополнительного функционала, который предоставляет компонент [Loader](https://tech.skbkontur.ru/react-ui/#/Components/Loader)
  */
 export declare class Spinner extends React.Component<SpinnerProps> {
     static __KONTUR_REACT_UI__: string;

package/components/Textarea/Textarea.md

@@ -9,6 +9,25 @@ const [value, setValue] = React.useState('');
 />;
 ```
 
+Очистить значение в `Textarea` можно только с помощью пустой строки
+
+```jsx harmony
+import { Group, Button } from '@skbkontur/react-ui';
+
+const [value, setValue] = React.useState('Значение');
+
+<Group>
+  <Textarea
+    value={value}
+    onValueChange={setValue}
+    autoResize
+    rows={1}
+    placeholder="Плейсхолдер"
+  />
+  <Button style={{ height: '52px' }} onClick={() => setValue('')}>Очистить значение</Button>
+</Group>
+```
+
 Счетчик введенных символов
 
 ```jsx harmony

package/internal/ZIndex/ZIndex/ZIndex.js

@@ -1,7 +1,7 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
 import _inheritsLoose from "@babel/runtime/helpers/esm/inheritsLoose";
-var _excluded = ["style", "children", "delta", "priority", "applyZIndex", "coverChildren", "createStackingContext", "wrapperRef"];
+var _excluded = ["style", "children", "delta", "priority", "applyZIndex", "coverChildren", "createStackingContext", "wrapperRef", "useWrapper"];
 
 var _class, _class2, _temp;
 
@@ -23,8 +23,10 @@ export var ZIndex = rootNode(_class = (_temp = _class2 = /*#__PURE__*/function (
     var _this;
 
     _this = _React$Component.call(this, props) || this;
+    _this.state = {
+      zIndex: 0
+    };
     _this.getProps = createPropsGetter(ZIndex.defaultProps);
-    _this.zIndex = 0;
 
     _this.wrapperRef = function (element) {
       var wrapperRef = _this.props.wrapperRef;
@@ -34,38 +36,53 @@ export var ZIndex = rootNode(_class = (_temp = _class2 = /*#__PURE__*/function (
       wrapperRef && callChildRef(wrapperRef, element);
     };
 
-    _this.zIndex = incrementZIndex(_this.getProps().priority, _this.getProps().delta);
+    _this.increment = function () {
+      var _this$getProps = _this.getProps(),
+          priority = _this$getProps.priority,
+          delta = _this$getProps.delta;
+
+      return incrementZIndex(priority, delta);
+    };
+
+    _this.state.zIndex = _this.increment();
     return _this;
   }
 
   var _proto = ZIndex.prototype;
 
+  _proto.componentDidUpdate = function componentDidUpdate(prevProps) {
+    if (prevProps.priority !== this.props.priority || prevProps.delta !== this.props.delta) {
+      removeZIndex(this.state.zIndex);
+      this.setState({
+        zIndex: this.increment()
+      });
+    }
+  };
+
   _proto.componentWillUnmount = function componentWillUnmount() {
-    removeZIndex(this.zIndex);
+    removeZIndex(this.state.zIndex);
   };
 
   _proto.render = function render() {
-    var _this2 = this; // TODO: Enable this rule in functional components.
-
-    /* eslint-disable @typescript-eslint/no-unused-vars */
-
-
-    var _this$getProps = this.getProps(),
-        style = _this$getProps.style,
-        children = _this$getProps.children,
-        delta = _this$getProps.delta,
-        priority = _this$getProps.priority,
-        applyZIndex = _this$getProps.applyZIndex,
-        coverChildren = _this$getProps.coverChildren,
-        createStackingContext = _this$getProps.createStackingContext,
-        wrapperRef = _this$getProps.wrapperRef,
-        rest = _objectWithoutPropertiesLoose(_this$getProps, _excluded);
+    var _this2 = this;
+
+    var _this$getProps2 = this.getProps(),
+        style = _this$getProps2.style,
+        children = _this$getProps2.children,
+        delta = _this$getProps2.delta,
+        priority = _this$getProps2.priority,
+        applyZIndex = _this$getProps2.applyZIndex,
+        coverChildren = _this$getProps2.coverChildren,
+        createStackingContext = _this$getProps2.createStackingContext,
+        wrapperRef = _this$getProps2.wrapperRef,
+        useWrapper = _this$getProps2.useWrapper,
+        rest = _objectWithoutPropertiesLoose(_this$getProps2, _excluded);
 
     var wrapperStyle = {};
     return /*#__PURE__*/React.createElement(ZIndexContext.Consumer, null, function (_ref) {
       var parentLayerZIndex = _ref.parentLayerZIndex,
           maxZIndex = _ref.maxZIndex;
-      var zIndexContexValue = {
+      var zIndexContextValue = {
         parentLayerZIndex: parentLayerZIndex,
         maxZIndex: maxZIndex
       };
@@ -74,7 +91,7 @@ export var ZIndex = rootNode(_class = (_temp = _class2 = /*#__PURE__*/function (
         var newZIndex = _this2.calcZIndex(parentLayerZIndex, maxZIndex);
 
         wrapperStyle.zIndex = newZIndex;
-        zIndexContexValue = coverChildren ? {
+        zIndexContextValue = coverChildren ? {
           parentLayerZIndex: parentLayerZIndex,
           maxZIndex: newZIndex
         } : {
@@ -87,17 +104,18 @@ export var ZIndex = rootNode(_class = (_temp = _class2 = /*#__PURE__*/function (
         }
       }
 
-      return /*#__PURE__*/React.createElement(ZIndexContext.Provider, {
-        value: zIndexContexValue
-      }, /*#__PURE__*/React.createElement("div", _extends({
+      var child = !useWrapper ? children : /*#__PURE__*/React.createElement("div", _extends({
         style: _extends({}, style, wrapperStyle),
         ref: _this2.wrapperRef
-      }, rest), children));
+      }, rest), children);
+      return /*#__PURE__*/React.createElement(ZIndexContext.Provider, {
+        value: zIndexContextValue
+      }, child);
     });
   };
 
   _proto.calcZIndex = function calcZIndex(parentLayerZIndex, maxZIndex) {
-    var newZIndex = this.zIndex;
+    var newZIndex = this.state.zIndex;
 
     if (Number.isFinite(maxZIndex)) {
       var allowedValuesIntervalLength = maxZIndex - parentLayerZIndex;
@@ -116,7 +134,8 @@ export var ZIndex = rootNode(_class = (_temp = _class2 = /*#__PURE__*/function (
   style: {},
   applyZIndex: true,
   coverChildren: false,
-  createStackingContext: false
+  createStackingContext: false,
+  useWrapper: true
 }, _class2.propTypes = {
   delta: function delta(props) {
     if ((props.delta || _class2.defaultProps.delta) <= 0) {

package/internal/ZIndex/ZIndex/ZIndex.js.map

@@ -1 +1 @@
-{"version":3,"sources":["ZIndex.tsx"],"names":["React","callChildRef","rootNode","isBrowser","createPropsGetter","incrementZIndex","removeZIndex","upperBorder","ZIndexContext","createContext","parentLayerZIndex","maxZIndex","Infinity","displayName","ZIndex","props","getProps","defaultProps","zIndex","wrapperRef","element","setRootNode","priority","delta","componentWillUnmount","render","style","children","applyZIndex","coverChildren","createStackingContext","rest","wrapperStyle","zIndexContexValue","newZIndex","calcZIndex","Number","isFinite","document","body","isolation","transform","allowedValuesIntervalLength","scale","Math","ceil","Component","__KONTUR_REACT_UI__","propTypes","Error","trunc"],"mappings":"iYAAA,OAAOA,KAAP,MAAkB,OAAlB;;AAEA,SAASC,YAAT,QAA6B,qCAA7B;AACA,SAASC,QAAT,QAAuC,oBAAvC;AACA,SAASC,SAAT,QAA0B,kBAA1B;AACA,SAASC,iBAAT,QAAkC,6BAAlC;;AAEA,SAASC,eAAT,EAA0BC,YAA1B,EAAwCC,WAAxC,QAA+E,iBAA/E;;AAEA,IAAMC,aAAa,gBAAGR,KAAK,CAACS,aAAN,CAAoB,EAAEC,iBAAiB,EAAE,CAArB,EAAwBC,SAAS,EAAEC,QAAnC,EAApB,CAAtB;;AAEAJ,aAAa,CAACK,WAAd,GAA4B,eAA5B;;;;;;;;;;;;;;;;;;;;;AAqBA,WAAaC,MAAb,GADCZ,QACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BE,kBAAYa,KAAZ,EAAgC;AAC9B,wCAAMA,KAAN,UAD8B,MAjBxBC,QAiBwB,GAjBbZ,iBAAiB,CAACU,MAAM,CAACG,YAAR,CAiBJ,OAJxBC,MAIwB,GAJf,CAIe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDxBC,IAAAA,UAjDwB,GAiDX,UAACC,OAAD,EAAoC;AACvD,UAAQD,UAAR,GAAuB,MAAKJ,KAA5B,CAAQI,UAAR;AACA,YAAKE,WAAL,CAAiBD,OAAjB;AACAD,MAAAA,UAAU,IAAIlB,YAAY,CAACkB,UAAD,EAAaC,OAAb,CAA1B;AACD,KArD+B,CAE9B,MAAKF,MAAL,GAAcb,eAAe,CAAC,MAAKW,QAAL,GAAgBM,QAAjB,EAA2B,MAAKN,QAAL,GAAgBO,KAA3C,CAA7B,CAF8B,aAG/B,CAhCH,qCAkCSC,oBAlCT,GAkCE,gCAA8B,CAC5BlB,YAAY,CAAC,KAAKY,MAAN,CAAZ,CACD,CApCH,QAsCSO,MAtCT,GAsCE,kBAAgB,oBACd;AACA,0DACA,qBACE,KAAKT,QAAL,EADF,CAAQU,KAAR,kBAAQA,KAAR,CAAeC,QAAf,kBAAeA,QAAf,CAAyBJ,KAAzB,kBAAyBA,KAAzB,CAAgCD,QAAhC,kBAAgCA,QAAhC,CAA0CM,WAA1C,kBAA0CA,WAA1C,CAAuDC,aAAvD,kBAAuDA,aAAvD,CAAsEC,qBAAtE,kBAAsEA,qBAAtE,CAA6FX,UAA7F,kBAA6FA,UAA7F,CAA4GY,IAA5G,4DAGA,IAAMC,YAAiC,GAAG,EAA1C,CAEA,oBACE,oBAAC,aAAD,CAAe,QAAf,QACG,gBAAsC,KAAnCtB,iBAAmC,QAAnCA,iBAAmC,CAAhBC,SAAgB,QAAhBA,SAAgB,CACrC,IAAIsB,iBAAiB,GAAG,EAAEvB,iBAAiB,EAAjBA,iBAAF,EAAqBC,SAAS,EAATA,SAArB,EAAxB,CAEA,IAAIiB,WAAJ,EAAiB,CACf,IAAMM,SAAS,GAAG,MAAI,CAACC,UAAL,CAAgBzB,iBAAhB,EAAmCC,SAAnC,CAAlB,CACAqB,YAAY,CAACd,MAAb,GAAsBgB,SAAtB,CAEAD,iBAAiB,GAAGJ,aAAa,GAC7B,EAAEnB,iBAAiB,EAAjBA,iBAAF,EAAqBC,SAAS,EAAEuB,SAAhC,EAD6B,GAE7B,EAAExB,iBAAiB,EAAEwB,SAArB,EAAgCvB,SAAS,EAAEyB,MAAM,CAACC,QAAP,CAAgB1B,SAAhB,IAA6BuB,SAA7B,GAAyCtB,QAApF,EAFJ,CAIA,IAAIkB,qBAAJ,EAA2B,CACzB3B,SAAS,IAAI,eAAemC,QAAQ,CAACC,IAAT,CAAcb,KAA1C,GACKM,YAAY,CAACQ,SAAb,GAAyB,SAD9B,GAEKR,YAAY,CAACS,SAAb,GAAyB,WAF9B,CAGD,CACF,CAED,oBACE,oBAAC,aAAD,CAAe,QAAf,IAAwB,KAAK,EAAER,iBAA/B,iBACE,sCAAK,KAAK,eAAOP,KAAP,EAAiBM,YAAjB,CAAV,EAA2C,GAAG,EAAE,MAAI,CAACb,UAArD,IAAqEY,IAArE,GACGJ,QADH,CADF,CADF,CAOD,CA1BH,CADF,CA8BD,CA5EH;AAoFUQ,EAAAA,UApFV,GAoFE,oBAAmBzB,iBAAnB,EAA8CC,SAA9C,EAAiE;AAC/D,QAAIuB,SAAS,GAAG,KAAKhB,MAArB;;AAEA,QAAIkB,MAAM,CAACC,QAAP,CAAgB1B,SAAhB,CAAJ,EAAgC;AAC9B,UAAM+B,2BAA2B,GAAG/B,SAAS,GAAGD,iBAAhD;AACA,UAAMiC,KAAK,GAAGpC,WAAW,GAAGmC,2BAA5B;AACAR,MAAAA,SAAS,GAAGU,IAAI,CAACC,IAAL,CAAUX,SAAS,GAAGS,KAAtB,CAAZ;AACD;;AAEDT,IAAAA,SAAS,IAAIxB,iBAAb;;AAEA,WAAOwB,SAAP;AACD,GAhGH,iBAA4BlC,KAAK,CAAC8C,SAAlC,WACgBC,mBADhB,GACsC,QADtC,UAGgB9B,YAHhB,GAG6C,EACzCM,KAAK,EAAE,EADkC,EAEzCD,QAAQ,EAAE,CAF+B,EAGzCI,KAAK,EAAE,EAHkC,EAIzCE,WAAW,EAAE,IAJ4B,EAKzCC,aAAa,EAAE,KAL0B,EAMzCC,qBAAqB,EAAE,KANkB,EAH7C,UAcgBkB,SAdhB,GAc4B,EACxBzB,KADwB,iBAClBR,KADkB,EACE,CACxB,IAAI,CAACA,KAAK,CAACQ,KAAN,IAAeT,OAAM,CAACG,YAAP,CAAoBM,KAApC,KAA8C,CAAlD,EAAqD,CACnD,OAAO,IAAI0B,KAAJ,8DAAqElC,KAAK,CAACQ,KAA3E,CAAP,CACD,CACD,IAAIqB,IAAI,CAACM,KAAL,CAAWnC,KAAK,CAACQ,KAAN,IAAeT,OAAM,CAACG,YAAP,CAAoBM,KAA9C,MAAyDR,KAAK,CAACQ,KAAnE,EAA0E,CACxE,OAAO,IAAI0B,KAAJ,uDAA8DlC,KAAK,CAACQ,KAApE,CAAP,CACD,CACF,CARuB,EAd5B","sourcesContent":["import React from 'react';\n\nimport { callChildRef } from '../../lib/callChildRef/callChildRef';\nimport { rootNode, TSetRootNode } from '../../lib/rootNode';\nimport { isBrowser } from '../../lib/client';\nimport { createPropsGetter } from '../../lib/createPropsGetter';\n\nimport { incrementZIndex, removeZIndex, upperBorder, LayerComponentName } from './ZIndexStorage';\n\nconst ZIndexContext = React.createContext({ parentLayerZIndex: 0, maxZIndex: Infinity });\n\nZIndexContext.displayName = 'ZIndexContext';\n\nexport interface ZIndexProps extends React.HTMLAttributes<HTMLDivElement> {\n  /**\n   * Приращение к z-index\n   */\n  delta?: number;\n  priority?: number | LayerComponentName;\n  style?: React.CSSProperties;\n  createStackingContext?: boolean;\n  coverChildren?: boolean;\n  applyZIndex?: boolean;\n  className?: string;\n  wrapperRef?: React.Ref<HTMLDivElement> | undefined | null;\n}\n\ntype DefaultProps = Required<\n  Pick<ZIndexProps, 'delta' | 'priority' | 'style' | 'applyZIndex' | 'coverChildren' | 'createStackingContext'>\n>;\n\n@rootNode\nexport class ZIndex extends React.Component<ZIndexProps> {\n  public static __KONTUR_REACT_UI__ = 'ZIndex';\n\n  public static defaultProps: DefaultProps = {\n    delta: 10,\n    priority: 0,\n    style: {},\n    applyZIndex: true,\n    coverChildren: false,\n    createStackingContext: false,\n  };\n\n  private getProps = createPropsGetter(ZIndex.defaultProps);\n\n  public static propTypes = {\n    delta(props: ZIndexProps) {\n      if ((props.delta || ZIndex.defaultProps.delta) <= 0) {\n        return new Error(`[ZIndex]: Prop 'delta' must be greater than 0, received ${props.delta}`);\n      }\n      if (Math.trunc(props.delta || ZIndex.defaultProps.delta) !== props.delta) {\n        return new Error(`[ZIndex]: Prop 'delta' must be integer, received ${props.delta}`);\n      }\n    },\n  };\n\n  private zIndex = 0;\n\n  private setRootNode!: TSetRootNode;\n\n  constructor(props: ZIndexProps) {\n    super(props);\n    this.zIndex = incrementZIndex(this.getProps().priority, this.getProps().delta);\n  }\n\n  public componentWillUnmount() {\n    removeZIndex(this.zIndex);\n  }\n\n  public render() {\n    // TODO: Enable this rule in functional components.\n    /* eslint-disable @typescript-eslint/no-unused-vars */\n    const { style, children, delta, priority, applyZIndex, coverChildren, createStackingContext, wrapperRef, ...rest } =\n      this.getProps();\n\n    const wrapperStyle: React.CSSProperties = {};\n\n    return (\n      <ZIndexContext.Consumer>\n        {({ parentLayerZIndex, maxZIndex }) => {\n          let zIndexContexValue = { parentLayerZIndex, maxZIndex };\n\n          if (applyZIndex) {\n            const newZIndex = this.calcZIndex(parentLayerZIndex, maxZIndex);\n            wrapperStyle.zIndex = newZIndex;\n\n            zIndexContexValue = coverChildren\n              ? { parentLayerZIndex, maxZIndex: newZIndex }\n              : { parentLayerZIndex: newZIndex, maxZIndex: Number.isFinite(maxZIndex) ? newZIndex : Infinity };\n\n            if (createStackingContext) {\n              isBrowser && 'isolation' in document.body.style\n                ? (wrapperStyle.isolation = 'isolate')\n                : (wrapperStyle.transform = 'rotate(0)');\n            }\n          }\n\n          return (\n            <ZIndexContext.Provider value={zIndexContexValue}>\n              <div style={{ ...style, ...wrapperStyle }} ref={this.wrapperRef} {...rest}>\n                {children}\n              </div>\n            </ZIndexContext.Provider>\n          );\n        }}\n      </ZIndexContext.Consumer>\n    );\n  }\n\n  private wrapperRef = (element: HTMLDivElement | null) => {\n    const { wrapperRef } = this.props;\n    this.setRootNode(element);\n    wrapperRef && callChildRef(wrapperRef, element);\n  };\n\n  private calcZIndex(parentLayerZIndex: number, maxZIndex: number) {\n    let newZIndex = this.zIndex;\n\n    if (Number.isFinite(maxZIndex)) {\n      const allowedValuesIntervalLength = maxZIndex - parentLayerZIndex;\n      const scale = upperBorder / allowedValuesIntervalLength;\n      newZIndex = Math.ceil(newZIndex / scale);\n    }\n\n    newZIndex += parentLayerZIndex;\n\n    return newZIndex;\n  }\n}\n"]}
+{"version":3,"sources":["ZIndex.tsx"],"names":["React","callChildRef","rootNode","isBrowser","createPropsGetter","incrementZIndex","removeZIndex","upperBorder","ZIndexContext","createContext","parentLayerZIndex","maxZIndex","Infinity","displayName","ZIndex","props","state","zIndex","getProps","defaultProps","wrapperRef","element","setRootNode","increment","priority","delta","componentDidUpdate","prevProps","setState","componentWillUnmount","render","style","children","applyZIndex","coverChildren","createStackingContext","useWrapper","rest","wrapperStyle","zIndexContextValue","newZIndex","calcZIndex","Number","isFinite","document","body","isolation","transform","child","allowedValuesIntervalLength","scale","Math","ceil","Component","__KONTUR_REACT_UI__","propTypes","Error","trunc"],"mappings":"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","sourcesContent":["import React from 'react';\n\nimport { callChildRef } from '../../lib/callChildRef/callChildRef';\nimport { rootNode, TSetRootNode } from '../../lib/rootNode';\nimport { isBrowser } from '../../lib/client';\nimport { createPropsGetter } from '../../lib/createPropsGetter';\n\nimport { incrementZIndex, removeZIndex, upperBorder, LayerComponentName } from './ZIndexStorage';\n\nconst ZIndexContext = React.createContext({ parentLayerZIndex: 0, maxZIndex: Infinity });\n\nZIndexContext.displayName = 'ZIndexContext';\n\nexport interface ZIndexProps extends React.HTMLAttributes<HTMLDivElement> {\n  /**\n   * Приращение к z-index\n   */\n  delta?: number;\n  priority?: number | LayerComponentName;\n  style?: React.CSSProperties;\n  createStackingContext?: boolean;\n  coverChildren?: boolean;\n  applyZIndex?: boolean;\n  className?: string;\n  wrapperRef?: React.Ref<HTMLDivElement> | undefined | null;\n\n  /**\n   * Явно указывает, что вложенные элементы должны быть обёрнуты в `<div/>`.\n   * Для случаев, когда необходимо задать **только** контекст для области.\n   *\n   * @default true\n   */\n  useWrapper?: boolean;\n}\n\ntype DefaultProps = Required<\n  Pick<\n    ZIndexProps,\n    'delta' | 'priority' | 'style' | 'applyZIndex' | 'coverChildren' | 'createStackingContext' | 'useWrapper'\n  >\n>;\n\ninterface ZIndexState {\n  zIndex: number;\n}\n\n@rootNode\nexport class ZIndex extends React.Component<ZIndexProps, ZIndexState> {\n  public static __KONTUR_REACT_UI__ = 'ZIndex';\n\n  public static defaultProps: DefaultProps = {\n    delta: 10,\n    priority: 0,\n    style: {},\n    applyZIndex: true,\n    coverChildren: false,\n    createStackingContext: false,\n    useWrapper: true,\n  };\n\n  public state = {\n    zIndex: 0,\n  };\n\n  private getProps = createPropsGetter(ZIndex.defaultProps);\n\n  public static propTypes = {\n    delta(props: ZIndexProps) {\n      if ((props.delta || ZIndex.defaultProps.delta) <= 0) {\n        return new Error(`[ZIndex]: Prop 'delta' must be greater than 0, received ${props.delta}`);\n      }\n      if (Math.trunc(props.delta || ZIndex.defaultProps.delta) !== props.delta) {\n        return new Error(`[ZIndex]: Prop 'delta' must be integer, received ${props.delta}`);\n      }\n    },\n  };\n\n  private setRootNode!: TSetRootNode;\n\n  constructor(props: ZIndexProps) {\n    super(props);\n    this.state.zIndex = this.increment();\n  }\n\n  public componentDidUpdate(prevProps: Readonly<ZIndexProps>) {\n    if (prevProps.priority !== this.props.priority || prevProps.delta !== this.props.delta) {\n      removeZIndex(this.state.zIndex);\n      this.setState({ zIndex: this.increment() });\n    }\n  }\n\n  public componentWillUnmount() {\n    removeZIndex(this.state.zIndex);\n  }\n\n  public render() {\n    const {\n      style,\n      children,\n      delta,\n      priority,\n      applyZIndex,\n      coverChildren,\n      createStackingContext,\n      wrapperRef,\n      useWrapper,\n      ...rest\n    } = this.getProps();\n\n    const wrapperStyle: React.CSSProperties = {};\n\n    return (\n      <ZIndexContext.Consumer>\n        {({ parentLayerZIndex, maxZIndex }) => {\n          let zIndexContextValue = { parentLayerZIndex, maxZIndex };\n\n          if (applyZIndex) {\n            const newZIndex = this.calcZIndex(parentLayerZIndex, maxZIndex);\n            wrapperStyle.zIndex = newZIndex;\n\n            zIndexContextValue = coverChildren\n              ? { parentLayerZIndex, maxZIndex: newZIndex }\n              : { parentLayerZIndex: newZIndex, maxZIndex: Number.isFinite(maxZIndex) ? newZIndex : Infinity };\n\n            if (createStackingContext) {\n              isBrowser && 'isolation' in document.body.style\n                ? (wrapperStyle.isolation = 'isolate')\n                : (wrapperStyle.transform = 'rotate(0)');\n            }\n          }\n\n          const child = !useWrapper ? (\n            children\n          ) : (\n            <div style={{ ...style, ...wrapperStyle }} ref={this.wrapperRef} {...rest}>\n              {children}\n            </div>\n          );\n\n          return <ZIndexContext.Provider value={zIndexContextValue}>{child}</ZIndexContext.Provider>;\n        }}\n      </ZIndexContext.Consumer>\n    );\n  }\n\n  private wrapperRef = (element: HTMLDivElement | null) => {\n    const { wrapperRef } = this.props;\n    this.setRootNode(element);\n    wrapperRef && callChildRef(wrapperRef, element);\n  };\n\n  private calcZIndex(parentLayerZIndex: number, maxZIndex: number) {\n    let newZIndex = this.state.zIndex;\n\n    if (Number.isFinite(maxZIndex)) {\n      const allowedValuesIntervalLength = maxZIndex - parentLayerZIndex;\n      const scale = upperBorder / allowedValuesIntervalLength;\n      newZIndex = Math.ceil(newZIndex / scale);\n    }\n\n    newZIndex += parentLayerZIndex;\n\n    return newZIndex;\n  }\n\n  private increment = () => {\n    const { priority, delta } = this.getProps();\n\n    return incrementZIndex(priority, delta);\n  };\n}\n"]}

package/internal/ZIndex/ZIndex.d.ts

@@ -12,21 +12,35 @@ export interface ZIndexProps extends React.HTMLAttributes<HTMLDivElement> {
     applyZIndex?: boolean;
     className?: string;
     wrapperRef?: React.Ref<HTMLDivElement> | undefined | null;
+    /**
+     * Явно указывает, что вложенные элементы должны быть обёрнуты в `<div/>`.
+     * Для случаев, когда необходимо задать **только** контекст для области.
+     *
+     * @default true
+     */
+    useWrapper?: boolean;
 }
-declare type DefaultProps = Required<Pick<ZIndexProps, 'delta' | 'priority' | 'style' | 'applyZIndex' | 'coverChildren' | 'createStackingContext'>>;
-export declare class ZIndex extends React.Component<ZIndexProps> {
+declare type DefaultProps = Required<Pick<ZIndexProps, 'delta' | 'priority' | 'style' | 'applyZIndex' | 'coverChildren' | 'createStackingContext' | 'useWrapper'>>;
+interface ZIndexState {
+    zIndex: number;
+}
+export declare class ZIndex extends React.Component<ZIndexProps, ZIndexState> {
     static __KONTUR_REACT_UI__: string;
     static defaultProps: DefaultProps;
+    state: {
+        zIndex: number;
+    };
     private getProps;
     static propTypes: {
         delta(props: ZIndexProps): Error | undefined;
     };
-    private zIndex;
     private setRootNode;
     constructor(props: ZIndexProps);
+    componentDidUpdate(prevProps: Readonly<ZIndexProps>): void;
     componentWillUnmount(): void;
     render(): JSX.Element;
     private wrapperRef;
     private calcZIndex;
+    private increment;
 }
 export {};

package/lib/rootNode/getRootNode/getRootNode.js

@@ -1,10 +1,11 @@
 /* eslint-disable react/no-find-dom-node */
 import { findDOMNode } from 'react-dom';
+import warning from 'warning';
 import { isElement, isNode } from "../../SSRSafe";
 import { canUseDOM } from "../../client";
 import { isInstanceWithRootNode } from "../rootNodeDecorator";
 /**
- * Extracts component's root `Element` out of it's instance
+ * Extracts component's root Element (HTMLElement/SVGElement) out of it's instance
  * following the "StrictMode support convention" (@see README.md#strictmode, #2518).
  *
  * Replaces findDOMNode but falls back to it if "convention" is not respected.
@@ -14,14 +15,21 @@ import { isInstanceWithRootNode } from "../rootNodeDecorator";
  */
 
 export var getRootNode = function getRootNode(instance) {
+  /**
+   * Options of what instance can be:
+   *  1. null or undefined
+   *  2. DOM Element
+   *  3. class Component instance (object)
+   *  4. literally anything, returned from useImperativeHandle
+   */
   if (!canUseDOM || !instance) {
     // instance can be `null` if component was unmounted
-    // also checking undefined for convinient usage
+    // also checking undefined for convenient usage
     return null;
   }
 
   if (isElement(instance)) {
-    // instance can be a `Element` already if comming
+    // instance can be an Element already if its coming
     // from Refs of intrinsic elements (<div />, <button />, etc.)
     return instance;
   }
@@ -31,7 +39,7 @@ export var getRootNode = function getRootNode(instance) {
   if (isInstanceWithRootNode(instance)) {
     // it happened to be that native Node interface also has
     // the "getRootNode" method, but we can ignore it here
-    // because we'd already checked the instance on being an `Element`
+    // because we'd already checked the instance on being an Element
     // which is a subclass of Node, so, just fixing types here
     if (!isNode(instance)) {
       rootNode = instance.getRootNode();
@@ -39,15 +47,25 @@ export var getRootNode = function getRootNode(instance) {
   }
 
   if (rootNode !== undefined) {
-    // at this point, it is rather `Element` (what we are looking for)
-    // or null (which is also OK, e.g. Popup/Tooltip/Hint before opening), so, just return it
+    // the getter exists and has returned something, it should be what we are looking for
+    // probably its an Element or null (which is also OK, e.g. Popup/Tooltip/Hint before opening)
     return rootNode;
-  } // node is undefined, which means that the instance's root node getter doesn't exists or returns the undefined
-  // anyway, it tell us that the convention is not respected (by the component itself or its children),
-  // so, we have to fall back to the deprecated findDOMNode, which always works but breaks StrictMode
+  }
 
+  try {
+    // rootNode is undefined, which means that the getter doesn't exists or returns the undefined
+    // anyway, it tell us that the convention is not respected,
+    // so, we have to fall back to the deprecated findDOMNode, which breaks StrictMode
+    // instance can still be a class component or an imperative handle (i.e., anything, except null/undefined/Element)
+    rootNode = findDOMNode(instance);
+  } catch (e) {
+    // but findDOMNode doesn`t accept everything that instance can be at this point,
+    // so we have to handle exceptions
+    // see https://github.com/facebook/react/blob/cae63505/packages/react-dom/src/__tests__/findDOMNode-test.js#L66-L86
+    warning(false, '[getRootNode]: can`t fallback to findDOMNode.' + '\n' + 'See https://github.com/skbkontur/retail-ui/blob/master/packages/react-ui/README.md#strictmode' + '\n\n' + e.message);
+    return null;
+  } // the findDOMNode can also return Text, but we are only interested in Elements, so just filter it
 
-  rootNode = findDOMNode(instance); // the findDOMNode can also return Text, but we are only intrested in HTMLElements, so just filter it
 
   return isElement(rootNode) ? rootNode : null;
 };

package/lib/rootNode/getRootNode/getRootNode.js.map

@@ -1 +1 @@
-{"version":3,"sources":["getRootNode.ts"],"names":["findDOMNode","isElement","isNode","canUseDOM","isInstanceWithRootNode","getRootNode","instance","rootNode","undefined"],"mappings":"AAAA;AACA,SAASA,WAAT,QAA4B,WAA5B;;;;AAIA,SAASC,SAAT,EAAoBC,MAApB,QAAkC,YAAlC;AACA,SAASC,SAAT,QAA0B,WAA1B;;AAEA,SAASC,sBAAT,QAAuC,qBAAvC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,IAAMC,WAAW,GAAG,SAAdA,WAAc,CAACC,QAAD,EAAgE;AACzF,MAAI,CAACH,SAAD,IAAc,CAACG,QAAnB,EAA6B;AAC3B;AACA;AACA,WAAO,IAAP;AACD;;AAED,MAAIL,SAAS,CAACK,QAAD,CAAb,EAAyB;AACvB;AACA;AACA,WAAOA,QAAP;AACD;;AAED,MAAIC,QAAJ;;AAEA,MAAIH,sBAAsB,CAACE,QAAD,CAA1B,EAAsC;AACpC;AACA;AACA;AACA;AACA,QAAI,CAACJ,MAAM,CAACI,QAAD,CAAX,EAAuB;AACrBC,MAAAA,QAAQ,GAAGD,QAAQ,CAACD,WAAT,EAAX;AACD;AACF;;AAED,MAAIE,QAAQ,KAAKC,SAAjB,EAA4B;AAC1B;AACA;AACA,WAAOD,QAAP;AACD;;AAED;AACA;AACA;AACAA,EAAAA,QAAQ,GAAGP,WAAW,CAACM,QAAD,CAAtB;;AAEA;AACA,SAAOL,SAAS,CAACM,QAAD,CAAT,GAAsBA,QAAtB,GAAiC,IAAxC;AACD,CAtCM","sourcesContent":["/* eslint-disable react/no-find-dom-node */\nimport { findDOMNode } from 'react-dom';\nimport React from 'react';\n\nimport { Nullable } from '../../typings/utility-types';\nimport { isElement, isNode } from '../SSRSafe';\nimport { canUseDOM } from '../client';\n\nimport { isInstanceWithRootNode } from './rootNodeDecorator';\n\n/**\n * Extracts component's root `Element` out of it's instance\n * following the \"StrictMode support convention\" (@see README.md#strictmode, #2518).\n *\n * Replaces findDOMNode but falls back to it if \"convention\" is not respected.\n *\n * @param instance Component's instance provided by React.Ref or `this` inside class-components.\n * @returns Component's root `Element` or null\n */\n\nexport const getRootNode = (instance: Nullable<React.ReactInstance>): Nullable<Element> => {\n  if (!canUseDOM || !instance) {\n    // instance can be `null` if component was unmounted\n    // also checking undefined for convinient usage\n    return null;\n  }\n\n  if (isElement(instance)) {\n    // instance can be a `Element` already if comming\n    // from Refs of intrinsic elements (<div />, <button />, etc.)\n    return instance;\n  }\n\n  let rootNode;\n\n  if (isInstanceWithRootNode(instance)) {\n    // it happened to be that native Node interface also has\n    // the \"getRootNode\" method, but we can ignore it here\n    // because we'd already checked the instance on being an `Element`\n    // which is a subclass of Node, so, just fixing types here\n    if (!isNode(instance)) {\n      rootNode = instance.getRootNode();\n    }\n  }\n\n  if (rootNode !== undefined) {\n    // at this point, it is rather `Element` (what we are looking for)\n    // or null (which is also OK, e.g. Popup/Tooltip/Hint before opening), so, just return it\n    return rootNode;\n  }\n\n  // node is undefined, which means that the instance's root node getter doesn't exists or returns the undefined\n  // anyway, it tell us that the convention is not respected (by the component itself or its children),\n  // so, we have to fall back to the deprecated findDOMNode, which always works but breaks StrictMode\n  rootNode = findDOMNode(instance);\n\n  // the findDOMNode can also return Text, but we are only intrested in HTMLElements, so just filter it\n  return isElement(rootNode) ? rootNode : null;\n};\n"]}
+{"version":3,"sources":["getRootNode.ts"],"names":["findDOMNode","warning","isElement","isNode","canUseDOM","isInstanceWithRootNode","getRootNode","instance","rootNode","undefined","e","message"],"mappings":"AAAA;AACA,SAASA,WAAT,QAA4B,WAA5B;;AAEA,OAAOC,OAAP,MAAoB,SAApB;;;AAGA,SAASC,SAAT,EAAoBC,MAApB,QAAkC,YAAlC;AACA,SAASC,SAAT,QAA0B,WAA1B;;AAEA,SAASC,sBAAT,QAAuC,qBAAvC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,IAAMC,WAAW,GAAG,SAAdA,WAAc,CAACC,QAAD,EAAgE;AACzF;AACF;AACA;AACA;AACA;AACA;AACA;;AAEE,MAAI,CAACH,SAAD,IAAc,CAACG,QAAnB,EAA6B;AAC3B;AACA;AACA,WAAO,IAAP;AACD;;AAED,MAAIL,SAAS,CAACK,QAAD,CAAb,EAAyB;AACvB;AACA;AACA,WAAOA,QAAP;AACD;;AAED,MAAIC,QAAJ;;AAEA,MAAIH,sBAAsB,CAACE,QAAD,CAA1B,EAAsC;AACpC;AACA;AACA;AACA;AACA,QAAI,CAACJ,MAAM,CAACI,QAAD,CAAX,EAAuB;AACrBC,MAAAA,QAAQ,GAAGD,QAAQ,CAACD,WAAT,EAAX;AACD;AACF;;AAED,MAAIE,QAAQ,KAAKC,SAAjB,EAA4B;AAC1B;AACA;AACA,WAAOD,QAAP;AACD;;AAED,MAAI;AACF;AACA;AACA;AACA;AACAA,IAAAA,QAAQ,GAAGR,WAAW,CAACO,QAAD,CAAtB;AACD,GAND,CAME,OAAOG,CAAP,EAAU;AACV;AACA;AACA;AACAT,IAAAA,OAAO;AACL,SADK;AAEL;AACE,QADF;AAEE,mGAFF;AAGE,UAHF;AAIES,IAAAA,CAAC,CAACC,OANC,CAAP;;AAQA,WAAO,IAAP;AACD;;AAED;AACA,SAAOT,SAAS,CAACM,QAAD,CAAT,GAAsBA,QAAtB,GAAiC,IAAxC;AACD,CA9DM","sourcesContent":["/* eslint-disable react/no-find-dom-node */\nimport { findDOMNode } from 'react-dom';\nimport React from 'react';\nimport warning from 'warning';\n\nimport { Nullable } from '../../typings/utility-types';\nimport { isElement, isNode } from '../SSRSafe';\nimport { canUseDOM } from '../client';\n\nimport { isInstanceWithRootNode } from './rootNodeDecorator';\n\n/**\n * Extracts component's root Element (HTMLElement/SVGElement) out of it's instance\n * following the \"StrictMode support convention\" (@see README.md#strictmode, #2518).\n *\n * Replaces findDOMNode but falls back to it if \"convention\" is not respected.\n *\n * @param instance Component's instance provided by React.Ref or `this` inside class-components.\n * @returns Component's root `Element` or null\n */\n\nexport const getRootNode = (instance: Nullable<React.ReactInstance>): Nullable<Element> => {\n  /**\n   * Options of what instance can be:\n   *  1. null or undefined\n   *  2. DOM Element\n   *  3. class Component instance (object)\n   *  4. literally anything, returned from useImperativeHandle\n   */\n\n  if (!canUseDOM || !instance) {\n    // instance can be `null` if component was unmounted\n    // also checking undefined for convenient usage\n    return null;\n  }\n\n  if (isElement(instance)) {\n    // instance can be an Element already if its coming\n    // from Refs of intrinsic elements (<div />, <button />, etc.)\n    return instance;\n  }\n\n  let rootNode;\n\n  if (isInstanceWithRootNode(instance)) {\n    // it happened to be that native Node interface also has\n    // the \"getRootNode\" method, but we can ignore it here\n    // because we'd already checked the instance on being an Element\n    // which is a subclass of Node, so, just fixing types here\n    if (!isNode(instance)) {\n      rootNode = instance.getRootNode();\n    }\n  }\n\n  if (rootNode !== undefined) {\n    // the getter exists and has returned something, it should be what we are looking for\n    // probably its an Element or null (which is also OK, e.g. Popup/Tooltip/Hint before opening)\n    return rootNode;\n  }\n\n  try {\n    // rootNode is undefined, which means that the getter doesn't exists or returns the undefined\n    // anyway, it tell us that the convention is not respected,\n    // so, we have to fall back to the deprecated findDOMNode, which breaks StrictMode\n    // instance can still be a class component or an imperative handle (i.e., anything, except null/undefined/Element)\n    rootNode = findDOMNode(instance);\n  } catch (e) {\n    // but findDOMNode doesn`t accept everything that instance can be at this point,\n    // so we have to handle exceptions\n    // see https://github.com/facebook/react/blob/cae63505/packages/react-dom/src/__tests__/findDOMNode-test.js#L66-L86\n    warning(\n      false,\n      '[getRootNode]: can`t fallback to findDOMNode.' +\n        '\\n' +\n        'See https://github.com/skbkontur/retail-ui/blob/master/packages/react-ui/README.md#strictmode' +\n        '\\n\\n' +\n        e.message,\n    );\n    return null;\n  }\n\n  // the findDOMNode can also return Text, but we are only interested in Elements, so just filter it\n  return isElement(rootNode) ? rootNode : null;\n};\n"]}

package/lib/rootNode/getRootNode.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 import { Nullable } from '../../typings/utility-types';
 /**
- * Extracts component's root `Element` out of it's instance
+ * Extracts component's root Element (HTMLElement/SVGElement) out of it's instance
  * following the "StrictMode support convention" (@see README.md#strictmode, #2518).
  *
  * Replaces findDOMNode but falls back to it if "convention" is not respected.

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@skbkontur/react-ui",
-  "version": "4.5.1",
+  "version": "4.5.2",
   "description": "UI Components",
   "main": "cjs/index.js",
   "module": "index.js",
   "sideEffects": false,
-  "homepage": "https://tech.skbkontur.ru/react-ui/4.5.1/",
+  "homepage": "https://tech.skbkontur.ru/react-ui/4.5.2/",
   "repository": {
     "type": "git",
     "url": "git@github.com:skbkontur/retail-ui.git"