@plesk/ui-library 3.35.1 → 3.35.3

package/types/src/components/Menu/MenuDivider.d.ts

@@ -0,0 +1,16 @@
+export interface MenuDividerProps {
+    /**
+     * @ignore
+     */
+    className?: string;
+    /**
+     * @ignore
+     */
+    baseClassName?: string;
+}
+/**
+ * `MenuDivider` is a part of [Menu](#!/Menu) component.
+ * @since 0.0.57
+ */
+declare const MenuDivider: ({ className, baseClassName, ...props }: MenuDividerProps) => JSX.Element;
+export default MenuDivider;

package/types/src/components/Menu/MenuHeader.d.ts

@@ -0,0 +1,22 @@
+import { ReactNode } from 'react';
+export interface MenuHeaderProps {
+    /**
+     * Content of the `MenuHeader`.
+     * @since 0.0.57
+     */
+    children?: ReactNode;
+    /**
+     * @ignore
+     */
+    className?: string;
+    /**
+     * @ignore
+     */
+    baseClassName?: string;
+}
+/**
+ * `MenuHeader` is a part of [Menu](#!/Menu) component.
+ * @since 0.0.57
+ */
+declare const MenuHeader: ({ className, children, baseClassName, ...props }: MenuHeaderProps) => JSX.Element;
+export default MenuHeader;

package/types/src/components/Menu/MenuItem.d.ts

@@ -0,0 +1,49 @@
+import { ElementType, ReactNode } from 'react';
+import { MenuBaseItemProps } from './MenuBaseItem';
+import { IconName, IconProps } from '../Icon';
+export declare type MenuItemProps<Component extends ElementType = 'div'> = {
+    /**
+     * Whether item is active.
+     * @since 0.0.55
+     */
+    active?: boolean;
+    /**
+     * Whether item is disabled.
+     * @since 0.0.55
+     */
+    disabled?: boolean;
+    /**
+     * Icon
+     * @since 0.0.55
+     */
+    icon?: IconName | IconProps | ReactNode;
+    /**
+     * Right label of item.
+     * @since 0.0.57
+     */
+    label?: ReactNode;
+    /**
+     * Tooltip for component.
+     * @since 2.6.1
+     */
+    tooltip?: ReactNode;
+    /**
+     * Content of the `MenuItem`.
+     * @since 0.0.55
+     */
+    children?: ReactNode;
+    /**
+     * @ignore
+     */
+    className?: string;
+    /**
+     * @ignore
+     */
+    baseClassName?: string;
+} & MenuBaseItemProps<Component>;
+/**
+ * `MenuItem` is a part of [Menu](#!/Menu) component.
+ * @since 0.0.55
+ */
+declare const MenuItem: ({ className, children, onClick, icon, label, tooltip, baseClassName, disabled, active, ...props }: MenuItemProps) => JSX.Element;
+export default MenuItem;

package/types/src/components/Menu/MenuSelectableItem.d.ts

@@ -0,0 +1,28 @@
+import { ElementType, ReactNode } from 'react';
+import { MenuItemProps } from './MenuItem';
+export declare type MenuSelectableItemProps<Component extends ElementType = 'div'> = {
+    /**
+     * Whether item is selected.
+     * @since 0.0.57
+     */
+    selected?: boolean;
+    /**
+     * Content of the `MenuSelectableItem`.
+     * @since 0.0.57
+     */
+    children?: ReactNode;
+    /**
+     * @ignore
+     */
+    className?: string;
+    /**
+     * @ignore
+     */
+    baseClassName?: string;
+} & MenuItemProps<Component>;
+/**
+ * `MenuSelectableItem` is a part of [Menu](#!/Menu) component.
+ * @since 0.0.57
+ */
+declare const MenuSelectableItem: ({ className, children, selected, baseClassName, ...props }: MenuSelectableItemProps) => JSX.Element;
+export default MenuSelectableItem;

package/types/src/components/Menu/index.d.ts

@@ -0,0 +1,11 @@
+export { default } from './Menu';
+export type { MenuProps } from './Menu';
+export { default as MenuItem } from './MenuItem';
+export type { MenuItemProps } from './MenuItem';
+export { default as MenuBaseItem } from './MenuBaseItem';
+export { default as MenuSelectableItem } from './MenuSelectableItem';
+export type { MenuSelectableItemProps } from './MenuSelectableItem';
+export { default as MenuDivider } from './MenuDivider';
+export type { MenuDividerProps } from './MenuDivider';
+export { default as MenuHeader } from './MenuHeader';
+export type { MenuHeaderProps } from './MenuHeader';

package/types/src/components/Panel/Panel.d.ts

@@ -1,4 +1,5 @@
 import { Component, SyntheticEvent, ReactNode } from 'react';
+import { DataAttributes } from '../../utils/types';
 import './Panel.less';
 declare type PanelProps = {
     /**
@@ -39,7 +40,7 @@ declare type PanelProps = {
      * @ignore
      */
     baseClassName?: string;
-};
+} & DataAttributes;
 declare type PanelState = {
     collapsed: boolean;
     prevPropsCollapsed: boolean;

package/types/src/components/Plaintext/Plaintext.d.ts

@@ -0,0 +1,23 @@
+import { ReactNode } from 'react';
+import './Plaintext.less';
+export interface PlainTextProps {
+    /**
+     * Content of the Plaintext
+     * @since 0.0.42
+     */
+    children: ReactNode;
+    /**
+     * @ignore
+     */
+    className?: string;
+    /**
+     * @ignore
+     */
+    baseClassName?: string;
+}
+/**
+ * `Plaintext` component is used to show regular text, without any formatting options and ignoring html tags.
+ * @since 0.0.42
+ */
+declare const Plaintext: ({ className, children, baseClassName, }: PlainTextProps) => JSX.Element;
+export default Plaintext;

package/types/src/components/Plaintext/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './Plaintext';
+export type { PlainTextProps } from './Plaintext';

package/types/src/components/Popover/Popover.d.ts

@@ -0,0 +1,156 @@
+import { ContentRect } from 'react-measure';
+import { PopperState } from '../Popper';
+import { Placement } from 'popper.js';
+import { Component, KeyboardEventHandler, MouseEvent, MutableRefObject, ReactElement, ReactNode } from 'react';
+import './Popover.less';
+declare const PLACEMENT_MAP: Record<string, Placement>;
+export interface PopoverProps {
+    /**
+     * The reference element used to position the popover.
+     * @since 0.0.65
+     */
+    target: ReactElement;
+    /**
+     * A React reference to the DOM element that needs for calculating the position of the popup.
+     * It is required only when visible or defaultVisible props are provided.
+     * @since 3.12.0
+     */
+    targetRef?: MutableRefObject<HTMLElement | null>;
+    /**
+     * Popover visibility. For controlled component only.
+     * @since 0.0.65
+     */
+    visible?: boolean;
+    /**
+     * Popover default (on init) visibility. For uncontrolled component only.
+     * @since 0.0.66
+     */
+    defaultVisible?: boolean;
+    /**
+     * Popover title. Header will only be rendered if this prop is defined.
+     * @since 0.0.42
+     */
+    title?: ReactNode;
+    /**
+     * Click handler for close button. If it is not defined then default behavior (hide popover) will be used.
+     * @since 0.0.42
+     */
+    onClose: () => void;
+    /**
+     * Popover placement
+     * @since 0.0.42
+     */
+    placement?: keyof typeof PLACEMENT_MAP;
+    /**
+     * Indicating if clicking outside the popover should close it.
+     * @since 0.0.65
+     */
+    canCloseOnOutsideClick?: boolean;
+    /**
+     * Indicating if pressing the escape key should close the popover.
+     * @since 0.0.65
+     */
+    canCloseOnEscapePress?: boolean;
+    /**
+     * Content of the Popover
+     * @since 0.0.42
+     */
+    children?: ReactNode;
+    /**
+     * Visual intent color to apply to component.
+     * @since 0.0.59
+     */
+    intent?: 'info' | 'success' | 'warning' | 'danger';
+    /**
+     * Undo predefined max-width.
+     * @since 2.4.0
+     */
+    wide?: boolean;
+    /**
+     * Define the popover width.
+     * @since 3.2.0
+     */
+    width?: 'xs' | 'sm' | 'md' | 'lg';
+    /**
+     * Define the popover height.
+     * @since 3.3.0
+     */
+    height?: number | string;
+    /**
+     * A slot for buttons or links in the header.
+     * @since 3.16.0
+     */
+    extra?: ReactNode;
+    /**
+     * @ignore
+     */
+    className?: string;
+    /**
+     * @ignore
+     */
+    baseClassName?: string;
+    /**
+     * Boundaries element for preventOverflow property.
+     * @since 1.12.4
+     */
+    boundariesElement?: 'scrollParent' | 'window' | 'viewport';
+    /**
+     * @ignore
+     */
+    autoFocus?: boolean;
+}
+declare type PopoverState = {
+    show?: boolean;
+    arrowInHeader: boolean;
+};
+/**
+ * `Popover` component is non-modal pop-up window used for providing additional information
+ * for an interface element. It also may contain Form with few fields or any other small content.
+ * @since 0.0.42
+ */
+declare class Popover extends Component<PopoverProps, PopoverState> {
+    static contextType: import("react").Context<boolean>;
+    static defaultProps: {
+        visible: null;
+        defaultVisible: boolean;
+        title: undefined;
+        onClose: undefined;
+        placement: string;
+        canCloseOnOutsideClick: boolean;
+        canCloseOnEscapePress: boolean;
+        children: undefined;
+        intent: undefined;
+        wide: undefined;
+        width: undefined;
+        height: undefined;
+        extra: undefined;
+        className: undefined;
+        baseClassName: string;
+        boundariesElement: undefined;
+        autoFocus: boolean;
+        targetRef: undefined;
+    };
+    state: {
+        show: boolean | undefined;
+        arrowInHeader: boolean;
+    };
+    static getDerivedStateFromProps(props: PopoverProps, state: PopoverState): {
+        show: boolean | undefined;
+    };
+    componentDidUpdate(_: PopoverProps, prevState: PopoverState): void;
+    private contentRef;
+    private targetRef;
+    private prevFocusElement;
+    private popperData;
+    private headerBounds;
+    focus(): void;
+    checkArrowPosition: () => void;
+    hotkeyHandler: KeyboardEventHandler<HTMLDivElement>;
+    handleTargetClick: (e: MouseEvent<HTMLDivElement>) => void;
+    handleClose: () => void;
+    handleHeaderResize: (contentRect: ContentRect) => void;
+    handlePopperUpdate: (popperData: PopperState) => void;
+    getIgnoreNodes: () => (Element | Text | null)[] | (MutableRefObject<HTMLElement | null> | undefined)[];
+    render(): JSX.Element;
+}
+export default Popover;

package/types/src/components/Popover/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './Popover';
+export type { PopoverProps } from './Popover';

package/types/src/components/ProgressDialog/ProgressDialog.d.ts

@@ -0,0 +1,125 @@
+import { Component, ReactNode } from 'react';
+import { ImageType } from '../Dialog';
+import { ProgressProps } from '../Progress';
+import '../../helpers/base.less';
+import './ProgressDialog.less';
+export interface ProgressDialogProps {
+    /**
+     * Toggles visibility.
+     * @since 1.2.0
+     */
+    isOpen?: boolean;
+    /**
+     * Banner. Renders in front of content as wide as dialog.
+     * @since 1.2.0
+     */
+    banner?: ImageType;
+    /**
+     * Image. Renders into content.
+     * @since 1.2.0
+     */
+    image?: ImageType;
+    /**
+     * Title
+     * @since 1.2.0
+     */
+    title?: ReactNode;
+    /**
+     * Description of the `ProgressDialog`.
+     * @since 1.2.0
+     */
+    description?: ReactNode;
+    /**
+     * Actions which will be shown in Dialog header.
+     * @since 1.2.0
+     */
+    actions?: ReactNode;
+    /**
+     * Whether the dialog should be canceled with the cancel button.
+     * @since 1.2.0
+     */
+    cancelable?: boolean;
+    /**
+     * The interval of time to auto close dialog when it successfully finished.
+     * Set `null` for disable auto close.
+     * @since 1.2.0
+     */
+    autoCloseTimeout?: number | null;
+    /**
+     * On cancel event handler.
+     * @since 1.2.0
+     */
+    onCancel?: () => void;
+    /**
+     * On close event handler.
+     * @since 1.2.0
+     */
+    onClose?: () => void;
+    /**
+     * On finish event handler.
+     * @since 1.2.0
+     */
+    onFinish?: () => void;
+    /**
+     * On fail event handler.
+     * @since 1.2.0
+     */
+    onFail?: () => void;
+    /**
+     * Content of the `ProgressDialog`.
+     * @since 1.2.0
+     */
+    children?: ReactNode;
+    /**
+     * @ignore
+     */
+    className?: string;
+    /**
+     * @ignore
+     */
+    baseClassName?: string;
+}
+declare type ProgressDialogState = {
+    isOpen: boolean;
+    isFinished: boolean;
+    isFailed: boolean;
+};
+/**
+ * `ProgressDialog` is a [Dialog](#!/Dialog) combined with of [Progress](#!/Progress) component.
+ * @since 1.2.0
+ */
+declare class ProgressDialog extends Component<ProgressDialogProps, ProgressDialogState> {
+    static defaultProps: {
+        isOpen: boolean;
+        banner: null;
+        image: null;
+        title: null;
+        description: null;
+        actions: null;
+        cancelable: boolean;
+        autoCloseTimeout: number;
+        onCancel: null;
+        onClose: null;
+        onFinish: null;
+        onFail: null;
+        children: null;
+        className: null;
+        baseClassName: string;
+    };
+    static getDerivedStateFromProps({ isOpen }: ProgressDialogState): {
+        isOpen: boolean;
+    };
+    state: {
+        isOpen: boolean;
+        isFinished: boolean;
+        isFailed: boolean;
+    };
+    componentDidUpdate(_: ProgressDialogProps, prevState: ProgressDialogState): void;
+    componentWillUnmount(): void;
+    private closeTimeout;
+    clearCloseTimeout(): void;
+    handleStatusChange: ProgressProps['onStatusChange'];
+    handleClose: () => void;
+    render(): JSX.Element;
+}
+export default ProgressDialog;

package/types/src/components/ProgressDialog/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './ProgressDialog';
+export type { ProgressDialogProps } from './ProgressDialog';

package/types/src/components/Rating/Rating.d.ts

@@ -0,0 +1,27 @@
+import './Rating.less';
+export interface RatingProps {
+    /**
+     * Rating value from 0 to 5.
+     * @since 0.0.42
+     */
+    value?: number;
+    /**
+     * Small variant.
+     * @since 0.0.42
+     */
+    small?: boolean;
+    /**
+     * @ignore
+     */
+    className?: string;
+    /**
+     * @ignore
+     */
+    baseClassName?: string;
+}
+/**
+ * `Rating` component is used for showing and collecting feedback of users' opinion in 0-5 grade scale.
+ * @since 0.0.42
+ */
+declare const Rating: ({ baseClassName, className, value, small, ...props }: RatingProps) => JSX.Element;
+export default Rating;

package/types/src/components/Rating/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './Rating';
+export type { RatingProps } from './Rating';

package/types/src/components/Section/Section.d.ts

@@ -0,0 +1,145 @@
+import { Component, MouseEvent, ReactNode } from 'react';
+import { ContentRect } from 'react-measure';
+import { FormContextProps } from '../Form/types';
+import { InPlaceEditProps } from '../InPlaceEdit';
+import './Section.less';
+export interface SectionProps {
+    /**
+     * Title of the section.
+     * @since 0.0.54
+     */
+    title?: ReactNode;
+    /**
+     * Visual intent color to apply to component.
+     * @since 0.0.54
+     */
+    intent?: 'danger' | 'warning' | 'success' | 'inactive';
+    /**
+     * Is section collapsible.
+     * @since 0.0.54
+     */
+    collapsible?: boolean;
+    /**
+     * Is section collapsed now.
+     * @since 0.0.54
+     */
+    collapsed?: boolean;
+    /**
+     * Event handler of title change with inline editing form.
+     * @since 0.0.54
+     */
+    onTitleChange?: InPlaceEditProps['onChange'];
+    /**
+     * Event handler of closing section with X-sign at the right.
+     * @since 0.0.54
+     */
+    onClose?: () => void;
+    /**
+     * A callback executed when the section collapsing.
+     * @since 3.26.0
+     */
+    onToggle?: (collapsed: boolean) => void;
+    /**
+     * Array of custom section action button at the right.
+     * @since 0.0.54
+     */
+    buttons?: ReactNode[];
+    /**
+     * Vertical or horizontal section view.
+     * Section view will be automatically switched if this parameter is not specified explicitly.
+     * @since 0.3.0
+     */
+    vertical: boolean;
+    /**
+     * Content of the `Section`.
+     * @since 0.0.54
+     */
+    children: ReactNode;
+    /**
+     * @ignore
+     */
+    className?: string;
+    /**
+     * @ignore
+     */
+    baseClassName?: string;
+    /**
+     * @ignore
+     */
+    form?: FormContextProps;
+}
+interface DerivedState {
+    prevCollapsed?: boolean;
+    prevErrors?: Record<string, any>;
+    collapsed?: boolean;
+}
+interface SectionState extends DerivedState {
+    vertical: boolean;
+}
+export declare const SECTION_BASE_CLASS_NAME: string;
+declare class Section extends Component<SectionProps, SectionState> {
+    static defaultProps: {
+        title: undefined;
+        intent: undefined;
+        collapsible: boolean;
+        collapsed: boolean;
+        onTitleChange: undefined;
+        onClose: undefined;
+        onToggle: undefined;
+        buttons: undefined;
+        vertical: undefined;
+        children: undefined;
+        className: undefined;
+        baseClassName: string;
+        form: undefined;
+    };
+    state: SectionState;
+    static getDerivedStateFromProps(props: SectionProps, state: SectionState): DerivedState;
+    handleResize: ({ bounds }: ContentRect) => void;
+    handleCollapse: (e: MouseEvent<HTMLButtonElement>) => void;
+    renderCollapseButton({ baseClassName, collapsible, }: {
+        baseClassName: string;
+        collapsible: boolean;
+    }): false | JSX.Element;
+    renderCloseButton({ baseClassName, onClose, buttons, }: {
+        baseClassName: string;
+        onClose: SectionProps['onClose'];
+        buttons: SectionProps['buttons'];
+    }): JSX.Element | undefined;
+    renderTitle({ baseClassName, title, onTitleChange, }: {
+        baseClassName: string;
+        title: SectionProps['title'];
+        onTitleChange: SectionProps['onTitleChange'];
+    }): false | "" | 0 | JSX.Element | null | undefined;
+    renderContent({ collapsible, children }: {
+        collapsible: boolean;
+        children: ReactNode;
+    }): ReactNode;
+    render(): JSX.Element;
+}
+/**
+ * `Section` component is used for dividing of complex content into groups for better readability
+ * and comprehension of the presented information.
+ * @since 0.0.54
+ */
+declare const SectionWrapper: {
+    (props: Omit<SectionProps, 'form'>): JSX.Element;
+    displayName: string;
+    defaultProps: {
+        title: undefined;
+        intent: undefined;
+        collapsible: boolean;
+        collapsed: boolean;
+        onTitleChange: undefined;
+        onClose: undefined;
+        onToggle: undefined;
+        buttons: undefined;
+        vertical: undefined;
+        children: undefined;
+        className: undefined;
+        baseClassName: string;
+        form: undefined;
+    };
+    WrappedComponent: typeof Section;
+};
+export default SectionWrapper;

package/types/src/components/Section/SectionItem.d.ts

@@ -0,0 +1,38 @@
+import { ReactNode, HTMLAttributes } from 'react';
+import './SectionItem.less';
+export interface SectionItemProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
+    /**
+     * Content of the `SectionItem`.
+     * @since 0.0.54
+     */
+    children?: ReactNode;
+    /**
+     * @ignore
+     */
+    className?: string;
+    /**
+     * @ignore
+     */
+    baseClassName?: string;
+    /**
+     * Title of the section item.
+     * @since 0.0.54
+     */
+    title?: ReactNode;
+    /**
+     * Is this section item contains actions? If it so than there should be extra whitespaces.
+     * @since 0.0.54
+     */
+    actions?: boolean;
+    /**
+     * @ignore
+     */
+    vertical?: boolean;
+}
+export declare const SECTION_ITEM_BASE_CLASS_NAME: string;
+/**
+ * `SectionItem` component is used for showing parameters and its values in [Section](#!/Section).
+ * @since 0.0.54
+ */
+declare const SectionItem: ({ baseClassName, className, children, title, actions, vertical, ...props }: SectionItemProps) => JSX.Element;
+export default SectionItem;

package/types/src/components/Section/index.d.ts

@@ -0,0 +1,5 @@
+export { default } from './Section';
+export { SECTION_BASE_CLASS_NAME } from './Section';
+export { default as SectionItem, SECTION_ITEM_BASE_CLASS_NAME } from './SectionItem';
+export type { SectionItemProps } from './SectionItem';
+export type { SectionProps } from './Section';