@plesk/ui-library 3.34.2 → 3.35.1

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

@@ -0,0 +1,49 @@
+import { Component, ReactNode } from 'react';
+import { Status } from '../ProgressStep';
+import '../../helpers/base.less';
+import './Progress.less';
+export interface ProgressProps {
+    /**
+     * Content of the `Progress`.
+     * @since 1.10.0
+     */
+    children: ReactNode;
+    /**
+     * On overall status event handler.
+     * @since 1.10.0
+     */
+    onStatusChange?: (status: Status) => void;
+    /**
+     * @ignore
+     */
+    className?: string;
+    /**
+     * @ignore
+     */
+    baseClassName?: string;
+}
+declare type ProgressState = {
+    status: Status | null;
+};
+/**
+ * `Progress` is used for showing progress of performing long operations.
+ * @since 1.10.0
+ */
+declare class Progress extends Component<ProgressProps, ProgressState> {
+    static defaultProps: {
+        onStatusChange: null;
+        children: null;
+        className: null;
+        baseClassName: string;
+    };
+    state: {
+        status: null;
+    };
+    static getDerivedStateFromProps({ children }: ProgressProps): {
+        status: string;
+    };
+    componentDidMount(): void;
+    componentDidUpdate(_: ProgressProps, prevState: ProgressState): void;
+    render(): JSX.Element;
+}
+export default Progress;

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

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

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

@@ -0,0 +1,69 @@
+import { ReactNode } from 'react';
+import { IconName, IconProps } from '../Icon';
+import '../../helpers/base.less';
+import './ProgressStep.less';
+export declare const STATUS_NOT_STARTED = "not_started";
+export declare const STATUS_RUNNING = "running";
+export declare const STATUS_DONE = "done";
+export declare const STATUS_WARNING = "warning";
+export declare const STATUS_ERROR = "error";
+export declare const STATUS_CANCELED = "canceled";
+export declare type Status = typeof STATUS_NOT_STARTED | typeof STATUS_RUNNING | typeof STATUS_DONE | typeof STATUS_ERROR | typeof STATUS_CANCELED | typeof STATUS_WARNING;
+export interface ProgressStepProps {
+    /**
+     * Title of the step
+     * @since 1.10.0
+     */
+    title?: ReactNode;
+    /**
+     * Status for the step
+     * @since 1.10.0
+     */
+    status?: Status;
+    /**
+     * Name of icon or [Icon](#!/Icon) component
+     * @ignore
+     */
+    icon?: ReactNode | IconName | IconProps;
+    /**
+     * Text description for the status of the step
+     * @since 1.10.0
+     */
+    statusText?: ReactNode;
+    /**
+     * Progress indication in numbers
+     * @since 1.10.0
+     */
+    progress?: number;
+    /**
+     * Content of the `ProgressStep`.
+     * @since 1.10.0
+     */
+    children?: ReactNode;
+    /**
+     * @ignore
+     */
+    className?: string;
+    /**
+     * @ignore
+     */
+    baseClassName?: string;
+}
+/**
+ * `ProgressStep` is a part of the [Progress](#!/Progress) component.
+ * @since 1.10.0
+ */
+declare const ProgressStep: {
+    ({ className, children, icon, title, statusText, progress, status, baseClassName, ...props }: ProgressStepProps): JSX.Element;
+    defaultProps: {
+        icon: null;
+        title: null;
+        status: string;
+        statusText: null;
+        progress: number;
+        children: null;
+        className: null;
+        baseClassName: string;
+    };
+};
+export default ProgressStep;

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

@@ -0,0 +1,2 @@
+export type { Status, ProgressStepProps } from './ProgressStep';
+export { default, STATUS_RUNNING, STATUS_DONE, STATUS_ERROR, STATUS_WARNING, STATUS_CANCELED, STATUS_NOT_STARTED, } from './ProgressStep';

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

@@ -0,0 +1,53 @@
+import { ReactNode, KeyboardEventHandler } from 'react';
+import { ButtonProps } from '../Button';
+import { DropdownProps } from '../Dropdown';
+import './SplitButton.less';
+export interface SplitButtonProps {
+    /**
+     * Dropdown [menu](#!/Menu)
+     * @type ReactElement
+     * @since 0.0.47
+     */
+    menu: DropdownProps['menu'];
+    /**
+     * Name of icon or [Icon](#!/Icon) component
+     * @type IconName | IconProps | ReactNode
+     * @since 3.35.0
+     */
+    icon?: ButtonProps['icon'];
+    /**
+     * Button size
+     * @since 3.35.0
+     */
+    size?: ButtonProps['size'];
+    /**
+     * Content of the button
+     * @since 0.0.40
+     */
+    children?: ReactNode;
+    /**
+     * @ignore
+     */
+    className?: string;
+    /**
+     * @ignore
+     */
+    baseClassName?: string;
+    /**
+     * @ignore
+     */
+    onKeyDown?: KeyboardEventHandler<HTMLDivElement>;
+    /**
+     * @ignore
+     */
+    onClick?: ButtonProps['onClick'];
+}
+/**
+ * `Split Button` is a combination of a standard [Button](#!/Button) with a [Dropdown](#!/Dropdown) menu.
+ * It is used for grouping several related actions when one of the actions should be accessible immediately
+ * because it is used more often than others.
+ *
+ * Since: 0.0.40
+ */
+declare const SplitButton: ({ baseClassName, className, menu, children, onClick, onKeyDown, icon, size, ...props }: SplitButtonProps) => JSX.Element;
+export default SplitButton;

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

@@ -0,0 +1,2 @@
+export { default } from './SplitButton';
+export * from './SplitButton';

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

@@ -0,0 +1,58 @@
+import { ReactNode } from 'react';
+import './Switch.less';
+export interface SwitchProps {
+    /**
+     * Determine whether the `Switch` is checked.
+     * @since 0.0.42
+     */
+    checked?: boolean;
+    /**
+     * A callback function, can be executed when the checked state is changing.
+     * @since 0.0.42
+     */
+    onChange?: (checked: boolean) => void;
+    /**
+     * Tooltip for component
+     * @since 0.0.42
+     */
+    tooltip?: ReactNode;
+    /**
+     * Visual intent color to apply to component.
+     * @since 0.3.0
+     */
+    intent?: 'warning' | 'danger';
+    /**
+     * Is `Switch` disabled?
+     * @since 0.0.42
+     */
+    disabled?: boolean;
+    /**
+     * Loading indication
+     * @since 0.3.0
+     */
+    loading?: boolean;
+    /**
+     * Label of the `Switch`
+     * @since 0.0.42
+     */
+    children?: ReactNode;
+    /**
+     * @ignore
+     */
+    defaultChecked?: boolean;
+    /**
+     * @ignore
+     */
+    className?: string;
+    /**
+     * @ignore
+     */
+    baseClassName?: string;
+}
+/**
+ * `Switch` component is used for changing the state of an object or system preferences.
+ * It provides immediate results that is why it should not be used in Form.
+ * @since 0.0.42
+ */
+declare const Switch: ({ className, children, onChange, tooltip, intent, checked, defaultChecked, baseClassName, disabled, loading, ...props }: SwitchProps) => JSX.Element;
+export default Switch;

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

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

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

@@ -0,0 +1 @@
+export { default } from './TextArea';

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

@@ -0,0 +1,61 @@
+import { Component, CSSProperties, MouseEvent, ReactElement, ReactNode } from 'react';
+import './Tooltip.less';
+export interface TooltipProps {
+    /**
+     * Content of the tooltip
+     * @since 0.0.42
+     */
+    title: ReactNode;
+    /**
+     * Element with tooltip
+     * @since 0.0.42
+     */
+    children: ReactElement;
+    /**
+     * Show delay (ms)
+     * @since 0.0.50
+     */
+    delay?: number;
+    /**
+     * @ignore
+     */
+    style?: CSSProperties;
+    /**
+     * @ignore
+     */
+    className?: string;
+    /**
+     * @ignore
+     */
+    baseClassName?: string;
+}
+/**
+ * `Tooltip` component is used for providing information about an interface element
+ * while user hovers the pointer over the element.
+ * @since 0.0.35
+ */
+declare class Tooltip extends Component<TooltipProps> {
+    static defaultProps: {
+        delay: number;
+        style: undefined;
+        className: undefined;
+        baseClassName: string;
+    };
+    state: {
+        left: number;
+        top: number;
+        ready: boolean;
+        visible: boolean;
+    };
+    componentWillUnmount(): void;
+    private timer;
+    private tooltipRef;
+    clearTimer: () => void;
+    handleShow: () => void;
+    handleHide: () => void;
+    handleMouseEnter: () => void;
+    handleMouseMove: (e: MouseEvent) => void;
+    renderTooltip(): JSX.Element;
+    render(): JSX.Element;
+}
+export default Tooltip;

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

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

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

@@ -0,0 +1,56 @@
+import { ElementType, ReactNode } from 'react';
+import { PolymorphicComponentProps } from '../../utils/types';
+interface BaseTranslateProps {
+    /**
+     * A some prefix for the message key.
+     * @since 2.6.0
+     */
+    namespace?: string;
+    /**
+     * Translatable content or message key.
+     * @since 0.0.42
+     */
+    content?: string;
+    /**
+     * Message params
+     * @since 0.0.42
+     */
+    params?: {
+        [key: string]: ReactNode;
+    };
+    /**
+     * Fallback translation value.
+     * @since 0.0.47
+     */
+    fallback?: string;
+    /**
+     * A set of translation messages. If the set contains a message key, the component uses an item from the set for rendering.
+     * @ignore
+     */
+    translators?: {
+        [key: string]: ReactNode;
+    };
+    /**
+     * @ignore
+     */
+    unsafe?: boolean;
+    /**
+     * @ignore
+     */
+    children?: string;
+}
+export declare type TranslateProps<Component extends ElementType = 'span'> = {
+    /**
+     * Component to render as the root element. Useful when rendering a `Translate` as `<option>`.
+     * @since 0.0.42
+     * @type ElementType
+     * @default span
+     */
+    component?: Component;
+} & PolymorphicComponentProps<Component, BaseTranslateProps>;
+/**
+ * `Translate` component.
+ * @since 0.0.42
+ */
+declare const Translate: <Component extends ElementType<any> = "span">({ component, content, children, params, unsafe, fallback, namespace, translators, ...props }: TranslateProps<Component>) => any;
+export default Translate;

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

@@ -0,0 +1,3 @@
+export { default } from './Translate';
+export { isLikeText } from './isLikeText';
+export type { TranslateProps } from './Translate';

package/types/src/components/Translate/isLikeText.d.ts

@@ -0,0 +1,2 @@
+import { ReactNode } from 'react';
+export declare const isLikeText: (node: ReactNode) => boolean;

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

@@ -22,14 +22,18 @@ export { default as ConsoleOutput } from './ConsoleOutput';
 export { default as ContentLoader } from './ContentLoader';
 export { default as Cuttable } from './Cuttable';
 export { default as Dialog } from './Dialog';
+export type { DialogProps } from './Dialog';
 export { default as Drawer } from './Drawer';
 export type { DrawerProps } from './Drawer';
 export { default as Dropdown } from './Dropdown';
+export type { DropdownProps } from './Dropdown';
 export { default as InPlaceEdit } from './InPlaceEdit';
 export { default as ExtendedStatusMessage } from './ExtendedStatusMessage';
 export * from './ExtendedStatusMessage';
 export { default as Figure } from './Figure';
+export type { FigureProps } from './Figure';
 export { default as Form } from './Form';
+export type { FormProps, FormValues, FormInstanceHandles } from './Form';
 export * from './Form';
 export { default as FormField } from './FormField';
 export { default as FormFieldCheckbox } from './FormFieldCheckbox';
@@ -72,21 +76,25 @@ export { default as Paragraph } from './Paragraph';
 export { default as Plaintext } from './Plaintext';
 export { default as Popover } from './Popover';
 export { default as Progress } from './Progress';
+export type { ProgressProps } from './Progress';
 export { default as ProgressBar } from './ProgressBar';
 export { default as ProgressDialog } from './ProgressDialog';
 export { default as ProgressDialogStep } from './ProgressDialogStep';
 export { default as ProgressStep } from './ProgressStep';
+export type { ProgressStepProps } from './ProgressStep';
 export { default as Rating } from './Rating';
 export { default as Section } from './Section';
 export * from './Section';
 export { default as SegmentedControl } from './SegmentedControl';
 export { default as Spot } from './Spot';
 export { default as SplitButton } from './SplitButton';
+export type { SplitButtonProps } from './SplitButton';
 export { default as Status } from './Status';
 export { default as StatusMessage } from './StatusMessage';
 export { default as Subnav } from './Subnav';
 export * from './Subnav';
 export { default as Switch } from './Switch';
+export type { SwitchProps } from './Switch';
 export { default as SwitchesPanel } from './SwitchesPanel';
 export { default as SwitchesPanelItem } from './SwitchesPanelItem';
 export { default as Tabs } from './Tabs';
@@ -96,9 +104,12 @@ export { default as Toaster } from './Toaster';
 export { default as Toolbar } from './Toolbar';
 export * from './Toolbar';
 export { default as Tooltip } from './Tooltip';
+export type { TooltipProps } from './Tooltip';
 export { default as Tour } from './Tour';
 export { default as Translate } from './Translate';
+export type { TranslateProps } from './Translate';
 export { default as Link } from './Link';
+export type { LinkProps } from './Link';
 export { default as Skeleton } from './Skeleton';
 export * from './Skeleton';
 export { PortalContext } from './Layer';

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

@@ -13,12 +13,14 @@ export declare class EventEmitter<H = (...args: any[]) => void> {
     on(type: string, handler: H): void;
     emit(type: string, ...args: any[]): void;
 }
-export declare const createFocusManager: (containerRef: RefObject<HTMLElement>, isFitForFocus?: (_node: Element) => boolean, strategy?: {
-    getNext: (container: Element, element: Element | null) => Element | undefined;
-    getPrev: (container: Element, element: Element | null) => Element | undefined;
+export declare type FocusStrategy = {
+    getNext: (container: Element, element: Element | null) => Element | null | undefined;
+    getPrev: (container: Element, element: Element | null) => Element | null | undefined;
     getFirst: (container: Element) => Element | null;
     getLast: (container: Element) => Element | null;
-}) => {
+};
+declare type ElementFitForFocusChecker = (node: Element) => boolean;
+export declare const createFocusManager: (containerRef: RefObject<HTMLElement>, isFitForFocus?: ElementFitForFocusChecker, strategy?: FocusStrategy) => {
     focusNext: (element?: Element | null, attempt?: number) => boolean;
     focusPrev: (element?: Element | null, attempt?: number) => boolean;
     focusFirst: (attempt?: number) => boolean;

package/types/src/tests/index.d.ts

@@ -0,0 +1 @@
+export { default } from './renderer';

package/types/src/tests/renderer.d.ts

@@ -0,0 +1,23 @@
+import { ComponentProps, ElementType } from 'react';
+declare const renderer: <C extends ElementType<any>>(Component: C, baseProps?: ComponentProps<C> | undefined) => (propOverrides?: Partial<ComponentProps<C>> | undefined) => {
+    asFragment: () => DocumentFragment;
+    user: {
+        clear: (element: import("@testing-library/user-event").TargetElement) => void;
+        click: (element: import("@testing-library/user-event").TargetElement, init?: MouseEventInit | undefined, options?: import("@testing-library/user-event").IClickOptions | undefined) => void;
+        dblClick: (element: import("@testing-library/user-event").TargetElement, init?: MouseEventInit | undefined, options?: import("@testing-library/user-event").IClickOptions | undefined) => void;
+        selectOptions: (element: import("@testing-library/user-event").TargetElement, values: string | string[] | HTMLElement | HTMLElement[], init?: MouseEventInit | undefined) => void;
+        deselectOptions: (element: import("@testing-library/user-event").TargetElement, values: string | string[] | HTMLElement | HTMLElement[], init?: MouseEventInit | undefined) => void;
+        upload: (element: import("@testing-library/user-event").TargetElement, files: import("@testing-library/user-event").FilesArgument, init?: import("@testing-library/user-event").UploadInitArgument | undefined, options?: import("@testing-library/user-event").IUploadOptions | undefined) => void;
+        type: <T extends import("@testing-library/user-event").ITypeOpts>(element: import("@testing-library/user-event").TargetElement, text: string, userOpts?: T | undefined) => T extends {
+            delay: number;
+        } ? Promise<void> : void;
+        tab: (userOpts?: import("@testing-library/user-event").ITabUserOptions | undefined) => void;
+        paste: (element: import("@testing-library/user-event").TargetElement, text: string, init?: MouseEventInit | undefined, pasteOptions?: {
+            initialSelectionStart?: number | undefined;
+            initialSelectionEnd?: number | undefined;
+        } | undefined) => void;
+        hover: (element: import("@testing-library/user-event").TargetElement, init?: MouseEventInit | undefined) => void;
+        unhover: (element: import("@testing-library/user-event").TargetElement, init?: MouseEventInit | undefined) => void;
+    };
+};
+export default renderer;