@steroidsjs/core 3.0.0-beta.9 → 3.0.0-beta.91

package/ui/layout/Header/Header.d.ts

@@ -1,24 +1,107 @@
 /// <reference types="react" />
+import { IButtonProps } from '../../form/Button/Button';
+import { IAvatarProps } from '../../content/Avatar/Avatar';
+import { ILinkProps } from '../../nav/Link/Link';
+import { IModalProps } from '../../modal/Modal/Modal';
+import { IMenuProps } from '../../content/Menu/Menu';
 import { INavProps } from '../../nav/Nav/Nav';
-export interface IHeaderProps {
-    className?: CssClassName;
-    view?: any;
+/**
+ * IHeaderProps
+ *
+ * Компонент Header представляет собой верхнюю часть макета страницы.
+ * Он может содержать логотип и навигацию, а также кастомизироваться с помощью переданного view React компонента.
+ **/
+export interface IHeaderProps extends IUiComponent {
+    /**
+     * Свойства для логотипа.
+     */
     logo?: {
+        /**
+         * Заголовок логотипа.
+         */
         title: string;
-        linkProps?: Record<string, unknown>;
-        icon?: string | any;
+        /**
+         * Дополнительные свойства ссылки логотипа.
+         */
+        linkProps?: ILinkProps;
+        /**
+         * Иконка логотипа в виде строки или компонента React.
+         */
+        icon?: string | React.ReactElement;
+        /**
+         * Дополнительные классы стилей для логотипа.
+         */
         className?: CssClassName;
     };
+    /**
+    * Свойства для навигации
+    */
     nav?: INavProps;
     /**
      * Размер
      */
     size?: Size;
     /**
-     * Темная тема
+     * Параметры авторизации.
      */
-    dark?: boolean;
+    authParams?: {
+        /**
+         * Флаг для отображения кнопки авторизации
+         */
+        isAuth: boolean;
+        /**
+         * Маршрут, на который перенаправлять пользователя для авторизации.
+         */
+        toRoute?: string;
+        /**
+         * Свойства для модального окна авторизации.
+         */
+        modal?: IModalProps;
+        /**
+        * Параметры для кнопки авторизации
+        */
+        buttonProps?: IButtonProps;
+    };
+    /**
+     * Информация о пользователе.
+     */
+    user?: {
+        /**
+         * Имя пользователя.
+         */
+        name?: string;
+        /**
+         * Свойства для аватара пользователя.
+         */
+        avatar?: IAvatarProps;
+        /**
+         * Свойства для меню пользователя.
+         */
+        menu?: IMenuProps;
+    };
+    /**
+     * Свойства для бургер-меню.
+     */
+    burgerMenu?: {
+        /**
+         * Контент бургер-меню в виде компонента React.
+         */
+        content?: React.ReactElement;
+        /**
+         * Свойства для ссылок бургер-меню.
+         */
+        links?: ILinkProps;
+    };
     [key: string]: any;
 }
-export type IHeaderViewProps = IHeaderProps;
-export default function Header(props: IHeaderProps): JSX.Element;
+export interface IHeaderViewProps extends IHeaderProps {
+    toggleBurger: VoidFunction;
+    isBurgerOpened: boolean;
+}
+declare function Header(props: IHeaderProps): JSX.Element;
+declare namespace Header {
+    var defaultProps: {
+        size: string;
+    };
+}
+export default Header;

package/ui/layout/Header/Header.js

@@ -1,7 +1,26 @@
 "use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
 exports.__esModule = true;
+var react_1 = require("react");
 var hooks_1 = require("../../../hooks");
 function Header(props) {
-    return (0, hooks_1.useComponents)().ui.renderView(props.view || 'layout.HeaderView', props);
+    var _a = (0, react_1.useState)(false), isBurgerOpened = _a[0], setIsBurgerOpened = _a[1];
+    var toggleBurger = (0, react_1.useCallback)(function () {
+        setIsBurgerOpened(function (prev) { return !prev; });
+    }, []);
+    return (0, hooks_1.useComponents)().ui.renderView(props.view || 'layout.HeaderView', __assign(__assign({}, props), { toggleBurger: toggleBurger, isBurgerOpened: isBurgerOpened }));
 }
+Header.defaultProps = {
+    size: 'md'
+};
 exports["default"] = Header;

package/ui/layout/Loader/Loader.d.ts

@@ -1,6 +1,20 @@
 /// <reference types="react" />
+/**
+ * ILoaderProps
+ *
+ * Компонент Loader представляет собой индикатор загрузки,
+ * который может использоваться для обозначения процесса загрузки данных или выполнения операции.
+ **/
 export interface ILoaderProps {
-    view?: any;
+    /**
+    * Размер элемента
+    */
+    size?: Size;
+    /**
+     * Название цвета
+     */
+    color?: ColorName;
     [key: string]: any;
 }
+export type ILoaderViewProps = ILoaderProps;
 export default function Loader(props: ILoaderProps): JSX.Element;

package/ui/layout/Meta/Meta.js

@@ -21,9 +21,9 @@ function Meta(props) {
     return (react_1["default"].createElement(react_helmet_1["default"], null,
         react_1["default"].createElement("title", null, props.title),
         props.base && react_1["default"].createElement("base", __assign({}, props.base)),
-        props.description && react_1["default"].createElement("meta", { name: 'description', content: props.description }), (_a = props.meta) === null || _a === void 0 ? void 0 :
-        _a.map(function (attrs, index) { return react_1["default"].createElement("meta", __assign({ key: index }, attrs)); }), (_b = props.links) === null || _b === void 0 ? void 0 :
-        _b.map(function (attrs, index) { return react_1["default"].createElement("link", __assign({ key: index }, attrs)); }), (_c = props.styles) === null || _c === void 0 ? void 0 :
+        props.description && (react_1["default"].createElement("meta", { name: 'description', content: props.description })), (_a = props.meta) === null || _a === void 0 ? void 0 :
+        _a.map(function (attrs, index) { return (react_1["default"].createElement("meta", __assign({ key: index }, attrs))); }), (_b = props.links) === null || _b === void 0 ? void 0 :
+        _b.map(function (attrs, index) { return (react_1["default"].createElement("link", __assign({ key: index }, attrs))); }), (_c = props.styles) === null || _c === void 0 ? void 0 :
         _c.map(function (attrs, index) { return (react_1["default"].createElement("style", __assign({ key: index }, attrs, { dangerouslySetInnerHTML: {
                 __html: attrs.innerHtml
             } }))); }), (_d = props.scripts) === null || _d === void 0 ? void 0 :

package/ui/layout/Notifications/Notifications.d.ts

@@ -14,6 +14,9 @@ import * as React from 'react';
  * ```
  */
 interface INotificationItem {
+    /**
+    * Идентификатор уведомления
+    */
     id?: number;
     /**
      * Цвет всплывающего уведомления
@@ -27,15 +30,43 @@ interface INotificationItem {
     message?: string;
     isClosing?: boolean;
 }
+/**
+ * Notifications
+ *
+ * Компонент Notifications представляет собой контейнер для отображения всплывающих уведомлений.
+ **/
 export interface INotificationsProps {
+    /**
+    * Исходные уведомления
+    */
     initialFlashes?: {
         [key: string]: string | any;
     };
+    /**
+    * Коллекция уведомлений
+    */
     notifications?: INotificationItem[];
+    /**
+    * Задержка перед закрытием
+    */
     closeTimeoutMs?: number;
+    /**
+    * Дополнительный CSS-класс для элемента отображения
+    */
     className?: CssClassName;
-    view?: any;
+    /**
+     * Переопределение view React компонента для кастомизации отображения
+     * @example MyCustomView
+     */
+    view?: CustomView;
+    /**
+     * Переопределение view React компонента для кастомизации отображения элемента
+     * @example MyCustomView
+     */
     itemView?: any;
+    /**
+    * Позиционирование элемента уведомления
+    */
     position?: string;
     [key: string]: any;
 }

package/ui/layout/ProgressBar/ProgressBar.js

@@ -32,14 +32,18 @@ var hooks_1 = require("../../../hooks");
 function ProgressBar(props) {
     var components = (0, hooks_1.useComponents)();
     var getLabel = (function () {
-        if (!props.showLabel)
+        if (!props.showLabel) {
             return null;
-        if (props.icon)
+        }
+        if (props.icon) {
             return props.icon(props.status, props.percent);
-        if (props.status === 'success')
+        }
+        if (props.status === 'success') {
             return React.createElement(Icon_1["default"], { name: "check" });
-        if (props.status === 'exception')
+        }
+        if (props.status === 'exception') {
             return React.createElement(Icon_1["default"], { name: "times" });
+        }
         return props.label(props.percent);
     });
     if (props.type === 'line') {

package/ui/layout/Sidebar/Sidebar.d.ts

@@ -0,0 +1,82 @@
+import React from 'react';
+import { IMenuProps } from '../../content/Menu/Menu';
+import { INavItem } from '../../nav/Nav/Nav';
+import { IIconProps } from '../../content/Icon/Icon';
+export interface ISidebarItem extends INavItem {
+    /**
+    * Наличие верней границы у элемента
+    */
+    border?: boolean;
+}
+/**
+* Sidebar
+*
+* Компонент Sidebar представляет собой боковое меню с возможностью гибкой настройки
+*/
+export interface ISidebarProps extends IUiComponent {
+    /**
+     * Объект с информацией о логотипе.
+     */
+    logo?: {
+        /**
+         * Текст или React-элемент для отображения логотипа.
+         */
+        label: string;
+        /**
+         * Путь к иконке или React-элемент для отображения иконки логотипа.
+         */
+        icon: string | React.ReactElement;
+    };
+    /**
+     * Объект с информацией о пользователе.
+     */
+    user?: {
+        /**
+         * URL изображения пользователя.
+         */
+        picture: string;
+        /**
+         * Имя пользователя.
+         */
+        name: string;
+    };
+    /**
+     * Props для компонента Menu.
+     */
+    menu?: IMenuProps;
+    /**
+     * Элементы навигации для компонента Nav.
+     */
+    items?: ISidebarItem[];
+    /**
+     * Флаг, определяющий, следует ли разделять элементы навигации.
+     */
+    hasSeparatedNavItem?: boolean;
+    /**
+     * Массив объектов с информацией об иконках для футера.
+     */
+    footerIcons?: IIconProps[];
+    /**
+     * Флаг, определяющий, будет ли сайдбар открытым по умолчанию.
+     */
+    isOpenedByDefault?: boolean;
+    /**
+     * Callback-функция, вызывается при клике на элемент навигации.
+     * @param itemId - идентификатор элемента навигации, по которому произошел клик.
+     */
+    onClickItem?: (itemId: number) => void;
+    [key: string]: any;
+}
+export interface ISidebarViewProps extends ISidebarProps {
+    isOpened: boolean;
+    toggleSidebar: VoidFunction;
+    onClickNav: (itemId: number) => void;
+}
+declare function Sidebar(props: ISidebarProps): React.ReactElement<any, string | React.JSXElementConstructor<any>>;
+declare namespace Sidebar {
+    var defaultProps: {
+        hasSeparatedNavItem: boolean;
+        isOpenedByDefault: boolean;
+    };
+}
+export default Sidebar;

package/ui/{list/ControlsColumn/demo/basic.js → layout/Sidebar/Sidebar.js}

@@ -33,17 +33,25 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 exports.__esModule = true;
-var React = __importStar(require("react"));
-var ControlsColumn_1 = __importDefault(require("../../../list/ControlsColumn"));
-var basic_1 = require("../../../nav/Controls/demo/basic");
-/**
- * Basic
- * @order 1
- * @col 8
- */
-exports["default"] = (function () { return (React.createElement(React.Fragment, null,
-    React.createElement(ControlsColumn_1["default"], { controls: basic_1.controls.map(function (item) { return (__assign(__assign({}, item), { visible: true })); }), item: {} }))); });
+var react_1 = __importStar(require("react"));
+var hooks_1 = require("../../../hooks");
+function Sidebar(props) {
+    var components = (0, hooks_1.useComponents)();
+    var _a = (0, react_1.useState)(props.isOpenedByDefault), isOpened = _a[0], setIsOpened = _a[1];
+    var toggleSidebar = (0, react_1.useCallback)(function () {
+        var newState = !isOpened;
+        setIsOpened(newState);
+    }, [isOpened]);
+    var onClickNav = react_1["default"].useCallback(function (itemId) {
+        if (props === null || props === void 0 ? void 0 : props.onClickItem) {
+            props.onClickItem(itemId);
+        }
+    }, [props]);
+    return components.ui.renderView(props.view || 'layout.SidebarView', __assign(__assign({}, props), { isOpened: isOpened, toggleSidebar: toggleSidebar, onClickNav: onClickNav }));
+}
+exports["default"] = Sidebar;
+Sidebar.defaultProps = {
+    hasSeparatedNavItem: false,
+    isOpenedByDefault: true
+};

package/ui/layout/Sidebar/index.d.ts

@@ -0,0 +1,2 @@
+import Sidebar from './Sidebar';
+export default Sidebar;

package/ui/layout/Sidebar/index.js

@@ -0,0 +1,7 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+exports.__esModule = true;
+var Sidebar_1 = __importDefault(require("./Sidebar"));
+exports["default"] = Sidebar_1["default"];

package/ui/layout/Skeleton/Skeleton.d.ts

@@ -1,18 +1,41 @@
 import * as React from 'react';
 export interface ISkeletonViewProps {
-    className?: string;
+    className?: CssClassName;
     children?: React.ReactNode;
     animation?: 'pulse' | 'wave';
     type?: 'text' | 'rect' | 'circle';
     height?: string | number;
     width?: string | number;
 }
+/**
+ * Компонент Skeleton представляет собой заглушку для отображения временных данных
+ * во время загрузки или ожидания загрузки реальных данных.
+ **/
 export interface ISkeletonProps {
-    className?: string;
+    /**
+    * Дополнительные CSS классы
+    * @example my-block
+    */
+    className?: CssClassName;
+    /**
+    * Дочерние элементы
+    */
     children?: React.ReactNode;
+    /**
+    * Тип анимации
+    */
     animation?: 'pulse' | 'wave';
+    /**
+    * Тип компонента
+    */
     type?: 'text' | 'rect' | 'circle';
+    /**
+    * Высота элемента
+    */
     height?: string | number;
+    /**
+    * Ширина элемента
+    */
     width?: string | number;
 }
 declare function Skeleton(props: ISkeletonProps): JSX.Element;

package/ui/layout/Tooltip/Tooltip.d.ts

@@ -1,20 +1,42 @@
 /// <reference types="react" />
-/**
- * Варианты позиций всплывающей подсказки
- * @example 'top'
- */
-type TooltipPosition = 'top' | 'topLeft' | 'topRight' | 'bottom' | 'bottomLeft' | 'bottomRight' | 'left' | 'leftTop' | 'leftBottom' | 'right' | 'rightTop' | 'rightBottom' | string;
-export interface TooltipArrowPosition {
+import { PositionType } from '../../../hooks/useAbsolutePositioning';
+export interface ITooltipArrowPosition {
+    /**
+    * Позиция стрелки слева
+    */
     left?: number | string;
+    /**
+    * Позиция стрелки справа
+    */
     right?: number | string;
+    /**
+    * Позиция стрелки сверху
+    */
     top?: number | string;
+    /**
+    * Позиция стрелки снизу
+    */
     bottom?: number | string;
 }
-export interface TooltipStylePosition {
+export interface ITooltipStylePosition {
+    /**
+    * Позиция Tooltip слева
+    */
     left: 'unset' | number;
+    /**
+    * Позиция Tooltip справа
+    */
     right: 'unset' | number;
+    /**
+    * Позиция Tooltip сверху
+    */
     top: 'unset' | number;
 }
+/**
+ * Tooltip
+ *
+ * Компонент Tooltip предоставляет всплывающую подсказку для дочерних элементов.
+ **/
 export interface ITooltipProps {
     /**
      * Текст подсказки
@@ -28,7 +50,7 @@ export interface ITooltipProps {
     /**
      * Позиционирование подсказки, относительно целевого элемента
      */
-    position?: TooltipPosition;
+    position?: PositionType;
     /**
      * Показывать ли подсказку сразу после рендера страницы
      * @example true
@@ -47,23 +69,28 @@ export interface ITooltipProps {
     /**
      * Стили для абсолютного позиционирования подсказки
      */
-    style?: TooltipStylePosition;
+    style?: ITooltipStylePosition;
     /**
      * Стили для позиционирования стрелки
      * @example {left: 10}
      */
-    arrowPosition?: TooltipArrowPosition;
+    arrowPosition?: ITooltipArrowPosition;
     /**
      * Рассчет позиции подсказки
      */
     calculatePosition?: (tooltipDimensions: Record<string, any>, arrowDimensions: Record<string, any>) => void;
+    /**
+     * Дополнительный CSS-класс для элемента отображения
+     */
+    className?: CssClassName;
     [key: string]: any;
 }
 export interface ITooltipViewProps extends ITooltipProps {
     isTooltipVisible: boolean;
     content: string | any;
-    position: TooltipPosition;
-    style: TooltipStylePosition;
+    position: PositionType;
+    style: ITooltipStylePosition;
+    className?: CssClassName;
 }
 declare function Tooltip(props: ITooltipProps): JSX.Element;
 declare namespace Tooltip {

package/ui/layout/Tooltip/Tooltip.js

@@ -29,8 +29,8 @@ exports.__esModule = true;
 var React = __importStar(require("react"));
 var react_1 = require("react");
 var react_use_1 = require("react-use");
-var calculate_1 = __importDefault(require("../Tooltip/calculate"));
 var hooks_1 = require("../../../hooks");
+var useAbsolutePositioning_1 = __importDefault(require("../../../hooks/useAbsolutePositioning"));
 var TooltipPortalInner_1 = __importDefault(require("./TooltipPortalInner"));
 /*
 * @Todo + check all calculations + describe
@@ -44,50 +44,21 @@ var TooltipPortalInner_1 = __importDefault(require("./TooltipPortalInner"));
 * */
 function Tooltip(props) {
     var components = (0, hooks_1.useComponents)();
-    var _a = (0, react_1.useState)(false), isComponentExist = _a[0], setIsComponentExist = _a[1];
-    var _b = (0, react_1.useState)(props.defaultVisible), isTooltipVisible = _b[0], setIsTooltipVisible = _b[1];
-    var _c = (0, react_1.useState)({
-        left: null,
-        right: null,
-        top: null
-    }), style = _c[0], setStyle = _c[1];
-    var _d = (0, react_1.useState)({
-        left: null,
-        right: null,
-        top: null,
-        bottom: null
-    }), arrowPosition = _d[0], setArrowPosition = _d[1];
-    var timerRef = (0, react_1.useRef)(null);
-    var positionRef = (0, react_1.useRef)(props.position);
+    var _a = (0, useAbsolutePositioning_1["default"])({
+        componentDestroyDelay: props.animationMs,
+        position: props.position,
+        children: props.children,
+        gap: props.gap,
+        defaultVisible: props.defaultVisible
+    }), isComponentExist = _a.isComponentExist, isComponentVisible = _a.isComponentVisible, calculateAbsolutePosition = _a.calculateAbsolutePosition, onShow = _a.onShow, onHide = _a.onHide, position = _a.position, arrowPosition = _a.arrowPosition, style = _a.style;
     var childRef = (0, react_1.useRef)(null);
-    var onShowTooltip = (0, react_1.useCallback)(function () {
-        if (timerRef.current) {
-            clearTimeout(timerRef.current);
-        }
-        setIsComponentExist(true);
-        setIsTooltipVisible(false);
-        // TODO: How to wait setState callback?
-        setTimeout(function () { return setIsTooltipVisible(true); });
-    }, []);
-    var onHideTooltip = (0, react_1.useCallback)(function () {
-        setIsTooltipVisible(false);
-        if (timerRef.current) {
-            clearTimeout(timerRef.current);
-        }
-        timerRef.current = setTimeout(function () { return setIsComponentExist(false); }, props.animationMs);
-    }, [props.animationMs]);
-    // Основная функция расчета позиции
     var calculatePosition = (0, react_1.useCallback)(function (tooltipSize, arrowSize) {
-        var result = (0, calculate_1["default"])(props.gap, positionRef.current, childRef.current, tooltipSize, arrowSize);
-        positionRef.current = result.position;
-        setStyle(result.style);
-        if (result.arrowPosition) {
-            setArrowPosition(result.arrowPosition);
-        }
-    }, [props.gap]);
+        calculateAbsolutePosition(position, childRef.current, tooltipSize, arrowSize);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
     (0, react_use_1.useMount)(function () {
-        if (isTooltipVisible) {
-            onShowTooltip();
+        if (isComponentVisible) {
+            onShow();
         }
     });
     if (!props.content) {
@@ -101,12 +72,12 @@ function Tooltip(props) {
         childrenElement
             ? React.cloneElement(childrenElement, {
                 ref: childRef,
-                onMouseOver: onShowTooltip,
-                onMouseOut: onHideTooltip
+                onMouseOver: onShow,
+                onMouseOut: onHide
             })
-            : (React.createElement("span", { ref: childRef, onFocus: onShowTooltip, onMouseOver: onShowTooltip, onBlur: onHideTooltip, onMouseOut: onHideTooltip }, props.children)),
+            : (React.createElement("span", { ref: childRef, onFocus: onShow, onMouseOver: onShow, onBlur: onHide, onMouseOut: onHide }, props.children)),
         isComponentExist && (React.createElement(TooltipPortalInner_1["default"], null,
-            React.createElement(TooltipView, { isTooltipVisible: isTooltipVisible, content: props.content, position: positionRef.current, style: style, arrowPosition: arrowPosition, calculatePosition: calculatePosition })))));
+            React.createElement(TooltipView, { isTooltipVisible: isComponentVisible, content: props.content, position: position, style: style, arrowPosition: arrowPosition, calculatePosition: calculatePosition, className: props.className })))));
 }
 Tooltip.defaultProps = {
     content: '',

package/ui/layout/index.d.ts

@@ -2,4 +2,5 @@ import Header from './Header';
 import Loader from './Loader';
 import Notifications from './Notifications';
 import Tooltip from './Tooltip';
-export { Header, Loader, Notifications, Tooltip, };
+import Sidebar from './Sidebar';
+export { Header, Loader, Notifications, Tooltip, Sidebar, };

package/ui/layout/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 exports.__esModule = true;
-exports.Tooltip = exports.Notifications = exports.Loader = exports.Header = void 0;
+exports.Sidebar = exports.Tooltip = exports.Notifications = exports.Loader = exports.Header = void 0;
 var Header_1 = __importDefault(require("./Header"));
 exports.Header = Header_1["default"];
 var Loader_1 = __importDefault(require("./Loader"));
@@ -12,3 +12,5 @@ var Notifications_1 = __importDefault(require("./Notifications"));
 exports.Notifications = Notifications_1["default"];
 var Tooltip_1 = __importDefault(require("./Tooltip"));
 exports.Tooltip = Tooltip_1["default"];
+var Sidebar_1 = __importDefault(require("./Sidebar"));
+exports.Sidebar = Sidebar_1["default"];

package/ui/list/CheckboxColumn/CheckboxColumn.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="react" />
+import { IColumnViewProps } from '../Grid/Grid';
 /**
  * CheckboxColumn
  * Колонка с чекбоксом, которая позволяет выбирать одну или все записи в таблице.
@@ -20,10 +21,10 @@ export interface ICheckboxColumnProps {
      * Переопределение view React компонента для кастомизации отображения
      * @example MyCustomView
      */
-    view?: any;
+    view?: CustomView;
     [key: string]: any;
 }
-export interface ICheckboxColumnViewProps {
+export interface ICheckboxColumnViewProps extends IColumnViewProps {
     fieldProps: Record<string, any>;
     input: {
         name: string;