@skbkontur/react-ui 4.17.3 → 4.18.0-fix-safari-textarea

package/components/Toast/Toast.d.ts

@@ -1,68 +1,75 @@
-import React, { AriaAttributes } from 'react';
-import { Nullable } from '../../typings/utility-types';
-import { CommonProps } from '../../internal/CommonWrapper';
-import { ToastView } from './ToastView';
-export interface Action {
-    label: string;
-    handler: () => void;
-    'aria-label'?: string;
-}
-export interface ToastState {
-    notification: Nullable<string>;
-    action: Nullable<Action>;
-    id: number;
-    showTime: Nullable<number>;
-}
-export interface ToastProps extends Pick<AriaAttributes, 'aria-label'>, CommonProps {
-    onPush?: (notification: string, action?: Action) => void;
-    onClose?: (notification: string, action?: Action) => void;
-}
-export declare const ToastDataTids: {
-    readonly toastStatic: "StaticToast";
-    readonly toastView: "ToastView__root";
-    readonly action: "ToastView__action";
-    readonly close: "ToastView__close";
-};
-/**
- * Показывает уведомления.
- *
- * Доступен статический метод: `Toast.push(notification, action?, showTime?)`.
- * Однако, при его использовании не работает кастомизация и могут быть проблемы
- * с перекрытием уведомления другими элементами страницы.
- *
- * Рекомендуется использовать Toast через `ref` (см. примеры).
- */
-export declare class Toast extends React.Component<ToastProps, ToastState> {
-    static __KONTUR_REACT_UI__: string;
-    private setRootNode;
-    static push(notification: string, action?: Nullable<Action>, showTime?: number): void;
-    static close(): void;
-    _toast: Nullable<ToastView>;
-    private _timeout;
-    private rootRef;
-    constructor(props: ToastProps);
-    componentWillUnmount(): void;
-    render(): JSX.Element;
-    /**
-     * Показывает тост с `notification` в качестве сообщения.
-     * Тост автоматически скрывается через 3 или 7 секунд,
-     * в зависимости от наличия у него кнопки `action`.
-     * Время показа можно задать вручную, передав `showTime`.
-     *
-     * @public
-     * @param {string} notification
-     * @param {Action} action `action` опциональный параметр формата `{ label: string, handler: function }`
-     * добавляет кнопку в виде ссылки при клике на которую вызывается переданный handler
-     * @param {number} showTime Время существования Toast в миллисекундах
-     */
-    push(notification: string, action?: Nullable<Action>, showTime?: number): void;
-    /**
-     * @public
-     */
-    close: () => void;
-    private _renderToast;
-    private setRootRef;
-    private _clearTimer;
-    private _setTimer;
-    private _refToast;
-}
+import React, { AriaAttributes } from 'react';
+import { ThemeIn } from '../../lib/theming/Theme';
+import { Nullable } from '../../typings/utility-types';
+import { CommonProps } from '../../internal/CommonWrapper';
+import { ToastView } from './ToastView';
+export interface Action {
+    label: string;
+    handler: () => void;
+    'aria-label'?: string;
+}
+export interface ToastState {
+    notification: Nullable<string>;
+    action: Nullable<Action>;
+    id: number;
+    showTime: Nullable<number>;
+}
+export interface ToastProps extends Pick<AriaAttributes, 'aria-label'>, CommonProps {
+    onPush?: (notification: string, action?: Action) => void;
+    onClose?: (notification: string, action?: Action) => void;
+    /**
+     * Обычный объект с переменными темы.
+     * Он будет объединён с темой из контекста.
+     */
+    theme?: ThemeIn;
+}
+export declare const ToastDataTids: {
+    readonly toastStatic: "StaticToast";
+    readonly toastView: "ToastView__root";
+    readonly action: "ToastView__action";
+    readonly close: "ToastView__close";
+};
+/**
+ * Показывает уведомления.
+ *
+ * Доступен статический метод: `Toast.push(notification, action?, showTime?)`.
+ * Однако, при его использовании не работает кастомизация, они не поддерживаются в `React@18`, а также могут быть проблемы с перекрытием уведомления другими элементами страницы.
+ *
+ * Для статических тостов <u>рекомендуется</u> использовать компонент [SingleToast](https://tech.skbkontur.ru/react-ui/#/Components/SingleToast) - в нём исправлены эти проблемы.
+ *
+ */
+export declare class Toast extends React.Component<ToastProps, ToastState> {
+    static __KONTUR_REACT_UI__: string;
+    private setRootNode;
+    private theme;
+    static push(notification: string, action?: Nullable<Action>, showTime?: number): void;
+    static close(): void;
+    _toast: Nullable<ToastView>;
+    private _timeout;
+    private rootRef;
+    constructor(props: ToastProps);
+    componentWillUnmount(): void;
+    render(): JSX.Element;
+    /**
+     * Показывает тост с `notification` в качестве сообщения.
+     * Тост автоматически скрывается через 3 или 7 секунд,
+     * в зависимости от наличия у него кнопки `action`.
+     * Время показа можно задать вручную, передав `showTime`.
+     *
+     * @public
+     * @param {string} notification
+     * @param {Action} action `action` опциональный параметр формата `{ label: string, handler: function }`
+     * добавляет кнопку в виде ссылки при клике на которую вызывается переданный handler
+     * @param {number} showTime Время существования Toast в миллисекундах
+     */
+    push(notification: string, action?: Nullable<Action>, showTime?: number): void;
+    /**
+     * @public
+     */
+    close: () => void;
+    private _renderToast;
+    private setRootRef;
+    private _clearTimer;
+    private _setTimer;
+    private _refToast;
+}

package/components/Toast/Toast.md

@@ -67,108 +67,3 @@ class Toaster extends React.Component {
 
 <Toaster />;
 ```
-
-### SuperToast
-
-Вы можете объединить удобство статических методов и кастамизируемость классического способа через `ref`.
-Для этого можно добавить обёртку, которая позволяет Toast работать по примеру GlobalLoader.
-
-Т.е. кастомный Toast можно добавить в единственном месте в проекте, а статические методы будут всегда использовать последний отрендеренный экземпляр Toast:
-
-Также в обёртке можно изменить логику появления всплывашки, по рекомендации Гайдов:
-https://guides.kontur.ru/components/toast/#08
-```static
-«Всегда показывается только 1 тост. Перед появлением следующего тоста, текущий скрывается, даже если время его показа еще не истекло»
-```
-
-Для этого немного изменим метод `SuperToast.close` с помощью специального метода `ReactDOM.flushSync`.
-
-Итоговый вариант:
-```js static
-const SuperToast = (props) => <Toast ref={SuperToast.ref} {...props} />;
-SuperToast.ref = React.createRef();
-SuperToast.push = (...args) => {
-  SuperToast.close();
-  SuperToast.ref.current && SuperToast.ref.current.push(...args);
-};
-SuperToast.close = () => {
-  ReactDOM.flushSync(() => {
-    SuperToast.ref.current && SuperToast.ref.current.close();
-  });
-};
-
-```
-
-
-Версия на typescript:
-```typescript static
-class SuperToast extends React.Component<ToastProps> {
-  public static ref = React.createRef<Toast>();
-  public static push: typeof Toast.push = (...args) => {
-    SuperToast.close();
-    SuperToast.ref.current?.push(...args);
-  };
-  public static close: typeof Toast.close = () => {
-    ReactDOM.flushSync(() => SuperToast.ref.current?.close());
-  };
-  render = () => {
-    return <Toast ref={SuperToast.ref} {...this.props} />;
-  };
-}
-```
-
-
-```jsx harmony
-import { Button, Toast, ThemeContext, ThemeFactory, THEME_2022 } from '@skbkontur/react-ui';
-import ReactDOM from 'react-dom';
-
-const SuperToast = (props) => <Toast ref={SuperToast.ref} {...props} />;
-SuperToast.ref = React.createRef();
-SuperToast.push = (...args) => {
-  SuperToast.close();
-  SuperToast.ref.current && SuperToast.ref.current.push(...args);
-};
-SuperToast.close = () => {
-  ReactDOM.flushSync(() => {
-    SuperToast.ref.current && SuperToast.ref.current.close();
-  });
-};
-
-const RedToast = () => (
-  <ThemeContext.Consumer>
-    {(theme) => {
-      return <ThemeContext.Provider
-        value={ThemeFactory.create(
-          {
-            toastBg: "rgba(210, 15, 0, 0.76)",
-            toastLinkBgActive: "rgba(210, 15, 0, 0.76)"
-          },
-          theme
-        )}
-      >
-        <SuperToast />
-      </ThemeContext.Provider>
-    }}
-  </ThemeContext.Consumer>
-);
-
-const rand = () => "Пример красного тоста №" + Math.round(Math.random() * 100).toString();
-
-const push = () => {
-  SuperToast.push(rand(), {
-    label: "Cancel",
-    handler: () => SuperToast.push("Canceled")
-  });
-};
-
-<div>
-  <RedToast />
-  <span />
-  <span />
-  <span />
-  <Button onClick={push}>
-    Show super red toast
-  </Button>
-</div>
-;
-```

package/components/Toast/Toast.styles.d.ts

@@ -1,6 +1,6 @@
-export declare const styles: {
-    enter(): string;
-    enterActive(): string;
-    exit(): string;
-    exitActive(): string;
-};
+export declare const styles: {
+    enter(): string;
+    enterActive(): string;
+    exit(): string;
+    exitActive(): string;
+};

package/components/Toast/ToastStatic.d.ts

@@ -1,9 +1,9 @@
-import { Nullable } from '../../typings/utility-types';
-import { Action } from './Toast';
-export declare class ToastStatic {
-    static push: (notification: string, action?: Nullable<Action>, showTime?: number | undefined) => void;
-    static _push: (notification: string, action?: Nullable<Action>, showTime?: number | undefined) => void;
-    static close: () => void;
-    private static node;
-    private static instance;
-}
+import { Nullable } from '../../typings/utility-types';
+import { Action } from './Toast';
+export declare class ToastStatic {
+    static push: (notification: string, action?: Nullable<Action>, showTime?: number | undefined) => void;
+    static _push: (notification: string, action?: Nullable<Action>, showTime?: number | undefined) => void;
+    static close: () => void;
+    private static node;
+    private static instance;
+}

package/components/Toast/ToastView.d.ts

@@ -1,38 +1,38 @@
-import React, { AriaAttributes } from 'react';
-import { Nullable } from '../../typings/utility-types';
-import { CommonProps } from '../../internal/CommonWrapper';
-import { Action } from './Toast';
-export interface ToastViewProps extends Pick<AriaAttributes, 'aria-label'>, CommonProps {
-    /**
-     * Toast content
-     */
-    children?: string;
-    /**
-     * Adds action handling and close icon for toast
-     */
-    action?: Nullable<Action>;
-    onClose?: () => void;
-    onMouseEnter?: () => void;
-    onMouseLeave?: () => void;
-}
-export declare class ToastView extends React.Component<ToastViewProps> {
-    static propTypes: {
-        /**
-         * Adds action handling and close icon for toast
-         */
-        action: import("prop-types").Requireable<import("prop-types").InferProps<{
-            label: import("prop-types").Validator<string>;
-            handler: import("prop-types").Validator<(...args: any[]) => any>;
-        }>>;
-        /**
-         * Toast content
-         */
-        children: import("prop-types").Validator<string>;
-        onClose: import("prop-types").Requireable<(...args: any[]) => any>;
-    };
-    private theme;
-    private setRootNode;
-    private readonly locale;
-    render(): JSX.Element;
-    private renderMain;
-}
+import React, { AriaAttributes } from 'react';
+import { Nullable } from '../../typings/utility-types';
+import { CommonProps } from '../../internal/CommonWrapper';
+import { Action } from './Toast';
+export interface ToastViewProps extends Pick<AriaAttributes, 'aria-label'>, CommonProps {
+    /**
+     * Toast content
+     */
+    children?: string;
+    /**
+     * Adds action handling and close icon for toast
+     */
+    action?: Nullable<Action>;
+    onClose?: () => void;
+    onMouseEnter?: () => void;
+    onMouseLeave?: () => void;
+}
+export declare class ToastView extends React.Component<ToastViewProps> {
+    static propTypes: {
+        /**
+         * Adds action handling and close icon for toast
+         */
+        action: import("prop-types").Requireable<import("prop-types").InferProps<{
+            label: import("prop-types").Validator<string>;
+            handler: import("prop-types").Validator<(...args: any[]) => any>;
+        }>>;
+        /**
+         * Toast content
+         */
+        children: import("prop-types").Validator<string>;
+        onClose: import("prop-types").Requireable<(...args: any[]) => any>;
+    };
+    private theme;
+    private setRootNode;
+    private readonly locale;
+    render(): JSX.Element;
+    private renderMain;
+}

package/components/Toast/ToastView.styles.d.ts

@@ -1,8 +1,8 @@
-import { Theme } from '../../lib/theming/Theme';
-export declare const styles: {
-    root(t: Theme): string;
-    wrapper(t: Theme): string;
-    closeWrapper(t: Theme): string;
-    link(t: Theme): string;
-    close(t: Theme): string;
-};
+import { Theme } from '../../lib/theming/Theme';
+export declare const styles: {
+    root(t: Theme): string;
+    wrapper(t: Theme): string;
+    closeWrapper(t: Theme): string;
+    link(t: Theme): string;
+    close(t: Theme): string;
+};

package/components/Toast/index.d.ts

@@ -1 +1 @@
-export * from './Toast';
+export * from './Toast';

package/components/Toast/locale/index.d.ts

@@ -1,4 +1,4 @@
-import { LocaleHelper } from '../../../lib/locale/LocaleHelper';
-import { ToastLocale } from './types';
-export * from './types';
-export declare const ToastLocaleHelper: LocaleHelper<ToastLocale>;
+import { LocaleHelper } from '../../../lib/locale/LocaleHelper';
+import { ToastLocale } from './types';
+export * from './types';
+export declare const ToastLocaleHelper: LocaleHelper<ToastLocale>;

package/components/Toast/locale/locales/en.d.ts

@@ -1,2 +1,2 @@
-import { ToastLocale } from '../types';
-export declare const componentsLocales: ToastLocale;
+import { ToastLocale } from '../types';
+export declare const componentsLocales: ToastLocale;

package/components/Toast/locale/locales/ru.d.ts

@@ -1,2 +1,2 @@
-import { ToastLocale } from '../types';
-export declare const componentsLocales: ToastLocale;
+import { ToastLocale } from '../types';
+export declare const componentsLocales: ToastLocale;

package/components/Toast/locale/types.d.ts

@@ -1,3 +1,3 @@
-export interface ToastLocale {
-    closeButtonAriaLabel: string;
-}
+export interface ToastLocale {
+    closeButtonAriaLabel: string;
+}