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

package/ui/content/DropDown/DropDown.d.ts

@@ -1,25 +1,36 @@
 import * as React from 'react';
 import { IAbsolutePositioningInputProps, IAbsolutePositioningOutputProps } from '../../../hooks/useAbsolutePositioning';
+/**
+ * Menu
+ *
+ * Компонент, представляющий меню с элементами, которые могут быть выбраны или нажаты.
+ * Компонент позволяет отображать и скрывать содержимое меню, а также управлять его позиционированием.
+ */
 export interface IDropDownProps extends IAbsolutePositioningInputProps {
-    /**
-     * Дополнительный CSS-класс
-     */
-    className?: CssClassName;
     /**
      * Содержимое DropDown (компонент или jsx-код)
      * @example () => Component
      */
     content?: () => React.ReactNode;
-    /**
-     * Переопределение view React компонента для кастомизациии отображения
-     * @example MyCustomView
-     */
-    view?: any;
     /**
      * В каком случае закрывать DropDown. По-умолчанию - `click-away`
      * @example click-any
      */
-    closeMode?: 'click-away' | 'click-any';
+    closeMode?: 'click-away' | 'click-any' | string;
+    /**
+    * Позволяет управлять отображением указателя
+    * @example true
+    */
+    hasArrow?: boolean;
+    /**
+    * Переопределение view React компонента для кастомизациии отображения
+    * @example MyCustomView
+    */
+    view?: CustomView;
+    /**
+    * Дополнительный CSS-класс
+    */
+    className?: CssClassName;
 }
 export interface IDropDownViewProps extends IDropDownProps, IAbsolutePositioningOutputProps {
     /**
@@ -40,6 +51,7 @@ declare namespace DropDown {
         gap: number;
         position: string;
         closeMode: string;
+        hasArrow: boolean;
     };
 }
 export default DropDown;

package/ui/content/DropDown/DropDown.js

@@ -1,4 +1,15 @@
 "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);
+};
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -82,14 +93,15 @@ function DropDown(props) {
         isComponentExist && (
         // TODO Change Portal to global
         React.createElement(TooltipPortalInner_1["default"], null,
-            React.createElement(DropDownView, { className: props.className, forwardedRef: forwardedRef, content: props.content, position: position, style: style, calculatePosition: calculatePosition, isComponentVisible: isComponentVisible, onClose: onHide })))));
+            React.createElement(DropDownView, __assign({}, props, { className: props.className, forwardedRef: forwardedRef, content: props.content, position: position, style: style, calculatePosition: calculatePosition, isComponentVisible: isComponentVisible, onClose: onHide }))))));
 }
 DropDown.defaultProps = {
-    autoPositioning: false,
+    autoPositioning: true,
     componentDestroyDelay: 300,
     defaultVisible: false,
     gap: 15,
     position: 'bottom',
-    closeMode: 'click-away'
+    closeMode: 'click-away',
+    hasArrow: true
 };
 exports["default"] = DropDown;

package/ui/content/Icon/Icon.d.ts

@@ -1,4 +1,4 @@
-import * as React from 'react';
+/// <reference types="react" />
 /**
  * Install the latest free version of Font Awesome via yarn:
  * ```
@@ -17,7 +17,12 @@ import * as React from 'react';
  *
  * That get the icon used <Icon name={'icon-name'} />
  */
-export interface IIconProps {
+/**
+ * Icon
+ *
+ * Компонент, представляющий иконку. Иконки могут быть импортированы при старте приложения.
+ */
+export interface IIconProps extends Omit<IUiComponent, 'className' | 'style'>, Partial<HTMLElement> {
     /**
      * Имя иконки (латиницей). Импорт иконок происходит на старте приложения.
      * @example create
@@ -28,12 +33,13 @@ export interface IIconProps {
      * @example Добавить запись
      */
     title?: string;
-    className?: CssClassName;
     /**
-     * Переопределение view React компонента для кастомизации отображения
-     * @example MyCustomView
-     */
-    view?: React.ComponentType;
+    *  Должен ли данный элемент участвовать в последовательной навигации
+    */
+    tabIndex?: number;
+    /**
+    * Функция которая вызывается при клике по иконке
+    */
     onClick?: any;
     [key: string]: any;
 }

package/ui/content/Icon/Icon.js

@@ -17,6 +17,7 @@ exports.__esModule = true;
 var isObject_1 = __importDefault(require("lodash-es/isObject"));
 var isString_1 = __importDefault(require("lodash-es/isString"));
 var hooks_1 = require("../../../hooks");
+var DEFAULT_ICON_NAME = 'default_24x24';
 function Icon(props) {
     var components = (0, hooks_1.useComponents)();
     var name = props.name;
@@ -42,7 +43,9 @@ function Icon(props) {
             }
         }
         if (!icon) {
-            throw new Error('Not found icon with name "' + name + '"');
+            // eslint-disable-next-line no-console
+            console.warn('Not found icon with name "' + name + '"');
+            icon = components.ui.getIcon(DEFAULT_ICON_NAME);
         }
     }
     return components.ui.renderView(props.view || 'content.IconView', __assign(__assign({}, props), { icon: icon }));

package/ui/content/Menu/Menu.d.ts

@@ -0,0 +1,56 @@
+import React from 'react';
+import { IDropDownProps } from '../DropDown/DropDown';
+export interface IMenuItem {
+    /**
+     * Заголовок элемента меню
+     */
+    label: string;
+    /**
+     * Функция вызываемая при клике
+     */
+    onClick: VoidFunction;
+    /**
+     * Кастомная иконка
+     */
+    icon?: string | React.ReactElement;
+    /**
+     * Нижний border
+     */
+    hasBorder?: boolean;
+}
+/**
+ * Menu
+ *
+ * Компонент-меню позволяет создавать выпадающие списки с элементами, которые могут быть выбраны
+ * или выполнить определенные действия при клике на них.
+ *
+ * Компонент `Menu` обычно используется для создания навигационных меню или контекстных меню,
+ * где пользователь может выбирать опции или выполнять определенные действия в зависимости от выбранного элемента.
+ *
+ * Компонент `Menu` принимает массив `items`, каждый элемент которого представляет собой отдельный пункт меню.
+ * Каждый пункт меню имеет заголовок `label`, функцию `onClick`, которая будет вызываться при клике на элемент,
+ * кастомную иконку `icon` (необязательно) и флаг `hasBorder`, определяющий наличие нижней границы у элемента.
+ *
+ * Примечание: Компонент `Menu` требует указания хотя бы одного элемента меню в свойстве `items`.
+ */
+export interface IMenuProps extends IUiComponent {
+    /**
+    *   Элементы меню
+    */
+    items: IMenuItem[];
+    /**
+    * Кастомная иконка, по клику на которую открывается меню
+    */
+    icon?: string | React.ReactElement;
+    /**
+     * Пропсы для DropDown
+     */
+    dropDownProps?: IDropDownProps;
+    /**
+     * Переопределение view React элемента меню для кастомизации отображения
+     */
+    itemView?: CustomView | any;
+}
+export type IMenuViewProps = IMenuProps;
+declare function Menu(props: IMenuProps): JSX.Element;
+export default Menu;

package/ui/content/Menu/Menu.js

@@ -0,0 +1,23 @@
+"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);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+exports.__esModule = true;
+var useComponents_1 = __importDefault(require("../../../hooks/useComponents"));
+function Menu(props) {
+    var components = (0, useComponents_1["default"])();
+    var MenuItemView = components.ui.getView(props.itemView || 'content.MenuItemView');
+    return components.ui.renderView(props.view || 'content.MenuView', __assign(__assign({}, props), { itemView: MenuItemView }));
+}
+exports["default"] = Menu;

package/ui/content/Menu/index.d.ts

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

package/ui/content/Menu/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 Menu_1 = __importDefault(require("./Menu"));
+exports["default"] = Menu_1["default"];

package/ui/content/Slider/Slider.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+import { Options, SplideProps } from '@splidejs/react-splide';
+/**
+ * Slider
+ *
+ * Компонент слайдера позволяет создавать слайдшоу, где элементы могут быть пролистаны
+ * с помощью прокрутки или перетаскивания.
+ **/
+export interface ISliderProps extends IUiComponent, Omit<SplideProps, 'items'> {
+    /**
+     * Опции слайдера.
+     */
+    sliderOptions: Options;
+    /**
+     * Элементы слайдера.
+     */
+    items: Record<string, any>[];
+    /**
+     * Представление элемента слайдера.
+     */
+    itemView: CustomView | any;
+    /**
+     * Дополнительные свойства.
+     */
+    [key: string]: any;
+}
+export type ISliderViewProps = ISliderProps;
+export default function Slider(props: ISliderProps): React.ReactElement<any, string | React.JSXElementConstructor<any>>;

package/ui/content/Slider/Slider.js

@@ -0,0 +1,19 @@
+"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 hooks_1 = require("../../../hooks");
+function Slider(props) {
+    var components = (0, hooks_1.useComponents)();
+    return components.ui.renderView(props.view || 'content.SliderView', __assign({}, props));
+}
+exports["default"] = Slider;

package/ui/content/Slider/index.d.ts

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

package/ui/content/Slider/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 Slider_1 = __importDefault(require("./Slider"));
+exports["default"] = Slider_1["default"];

package/ui/content/index.d.ts

@@ -4,4 +4,11 @@ import Card from './Card';
 import DropDown from './DropDown';
 import Alert from './Alert';
 import Badge from './Badge';
-export { Avatar, AvatarGroup, Accordion, AccordionItem, Alert, Card, DropDown, Badge, };
+import { Detail, DetailItem } from './Detail';
+import Icon from './Icon';
+import Menu from './Menu';
+import CopyToClipboard from './CopyToClipboard';
+import Chart from './Chart';
+import Slider from './Slider';
+import CalendarSystem from './CalendarSystem';
+export { Avatar, AvatarGroup, Accordion, AccordionItem, Alert, Card, DropDown, Badge, Detail, DetailItem, Icon, Menu, CopyToClipboard, Chart, Slider, CalendarSystem, };

package/ui/content/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 exports.__esModule = true;
-exports.Badge = exports.DropDown = exports.Card = exports.Alert = exports.AccordionItem = exports.Accordion = exports.AvatarGroup = exports.Avatar = void 0;
+exports.CalendarSystem = exports.Slider = exports.Chart = exports.CopyToClipboard = exports.Menu = exports.Icon = exports.DetailItem = exports.Detail = exports.Badge = exports.DropDown = exports.Card = exports.Alert = exports.AccordionItem = exports.Accordion = exports.AvatarGroup = exports.Avatar = void 0;
 var Avatar_1 = require("./Avatar");
 exports.Avatar = Avatar_1.Avatar;
 exports.AvatarGroup = Avatar_1.AvatarGroup;
@@ -18,3 +18,18 @@ var Alert_1 = __importDefault(require("./Alert"));
 exports.Alert = Alert_1["default"];
 var Badge_1 = __importDefault(require("./Badge"));
 exports.Badge = Badge_1["default"];
+var Detail_1 = require("./Detail");
+exports.Detail = Detail_1.Detail;
+exports.DetailItem = Detail_1.DetailItem;
+var Icon_1 = __importDefault(require("./Icon"));
+exports.Icon = Icon_1["default"];
+var Menu_1 = __importDefault(require("./Menu"));
+exports.Menu = Menu_1["default"];
+var CopyToClipboard_1 = __importDefault(require("./CopyToClipboard"));
+exports.CopyToClipboard = CopyToClipboard_1["default"];
+var Chart_1 = __importDefault(require("./Chart"));
+exports.Chart = Chart_1["default"];
+var Slider_1 = __importDefault(require("./Slider"));
+exports.Slider = Slider_1["default"];
+var CalendarSystem_1 = __importDefault(require("./CalendarSystem"));
+exports.CalendarSystem = CalendarSystem_1["default"];

package/ui/crud/Crud/Crud.d.ts

@@ -1,23 +1,66 @@
 import * as React from 'react';
 import { ReactNode } from 'react';
-import { IApiRest } from '../../../components/ApiComponent';
 import { IComponents } from '../../../providers/ComponentsProvider';
-import { IComponentsHocOutput } from '../../../hoc/components';
-import { IConnectHocOutput } from '../../../hoc/connect';
 import { IFormProps } from '../../form/Form/Form';
 import { IGridProps } from '../../list/Grid/Grid';
 import { IControlItem } from '../../nav/Controls/Controls';
+export interface IApiRest {
+    index?: any;
+    create?: any;
+    update?: any;
+    delete?: any;
+    view?: any;
+    [key: string]: any | undefined;
+}
 export interface ICrudItem extends Omit<IControlItem, 'visible' | 'confirm' | 'onClick'> {
+    /**
+    * Заголовок
+    * @example 'Title'
+    */
     title?: string;
+    /**
+    * Название для action
+    * @example
+    */
     actionName?: string;
+    /**
+    * Обязателен ли Personal Key
+    * @example true
+    */
     pkRequired?: boolean;
+    /**
+    * Режим отображения
+    * @example 'modal'
+    */
     mode?: 'page' | 'modal';
+    /**
+    * Компонент
+    */
     component?: any;
+    /**
+    * Свойства компонента
+    */
     componentProps?: any;
+    /**
+    * Коллекция Controls
+    */
     controlsInclude?: string[];
+    /**
+    * Коллекция исключенных Controls
+    */
     controlsExclude?: string[];
+    /**
+    * Управление отображением
+    * @example true
+    */
     visible?: boolean | ((item: any, crudItem: ICrudItem, isGrid: boolean) => boolean);
+    /**
+    * Сообщение о подтверждении
+    */
     confirm?: string | ((e: any, props: ICrudClickProps) => any);
+    /**
+    * Функция обратного вызова, срабатывает после нажатия
+    */
     onClick?: (e: Event | React.MouseEvent, props: ICrudClickProps) => any;
 }
 export interface ICrudClickProps {
@@ -36,31 +79,100 @@ export interface ICrudClickProps {
     goToAction: (nextAction: string) => any;
     errorHandler?: (error: any, dispatch: any) => void;
 }
+/**
+ * Crud
+ *
+ * Компонент CRUD (Create, Read, Update, Delete) предоставляет интерфейс для выполнения операций создания,
+ * чтения, обновления и удаления записей. Он позволяет создавать, просматривать, редактировать и удалять
+ * записи из некоторой модели данных.
+ */
 export interface ICrudProps {
+    /**
+    * Id для Crud
+    */
     crudId?: string;
+    /**
+    * Режим работы Crud
+    */
     mode?: 'page' | 'modal';
+    /**
+    * Ссылка на rest
+    */
     restUrl?: string;
+    /**
+    * Методы rest api
+    * @example {}
+    */
     restApi?: IApiRest;
+    /**
+    * Первичный ключ
+    */
     primaryKey?: 'id' | string;
+    /**
+    * Ключ запроса
+    * @example {}
+    */
     queryKey?: 'id' | string;
+    /**
+    * Модель
+    * @example {}
+    */
     model?: string;
+    /**
+    * Модель используемая для поиска
+    */
     searchModel?: string;
+    /**
+    * Параметры для колонки index
+    */
     index?: boolean | ICrudItem;
+    /**
+    * Параметры для колонки create
+    */
     create?: boolean | ICrudItem;
+    /**
+    * Параметры для колонки update
+    */
     update?: boolean | ICrudItem;
+    /**
+    * Представление
+    */
     view?: boolean | ICrudItem;
+    /**
+    * Параметры для колонки delete
+    */
     delete?: boolean | ICrudItem;
+    /**
+    * Коллекция элементов
+    */
     items?: ICrudItem[] | {
         [key: string]: ICrudItem;
     };
+    /**
+    * Параметры Grid
+    */
     grid?: IGridProps | React.ReactNode;
+    /**
+    * Параметры формы
+    */
     form?: IFormProps | React.ReactNode;
+    /**
+    * Параметры для колонки detail
+    */
     detail?: any;
+    /**
+    * Представление для Crud
+    */
     crudView?: CustomView;
+    /**
+    * Функция-обработчик ошибок
+    * @param error - ошибка
+    * @param dispatch - диспатч
+    */
     errorHandler?: (error: any, dispatch: any) => void;
     [key: string]: any;
 }
-export interface ICrudChildrenProps extends ICrudProps, IConnectHocOutput, IComponentsHocOutput {
+export interface ICrudChildrenProps extends ICrudProps {
     item?: any;
     recordId?: PrimaryKey;
     action?: string;

package/ui/crud/Crud/CrudContent.d.ts

@@ -1,8 +1,7 @@
 /// <reference types="react" />
 import { IGridProps } from '../../list/Grid/Grid';
 import { IFormProps } from '../../form/Form/Form';
-import { ICrudItem } from './Crud';
-import { IApiRest } from '../../../components/ApiComponent';
+import { IApiRest, ICrudItem } from './Crud';
 export interface ICrudContentProps {
     crudId?: string;
     queryKey?: string;

package/ui/crud/Crud/utils.js

@@ -93,18 +93,14 @@ var normalizeItems = function (sourceItems, fromProps) {
             position: 'right',
             confirm: function (e, props) { return __('Удалить запись {id}?', { id: props.recordId }); },
             onClick: function (e, props) { return __awaiter(void 0, void 0, void 0, function () {
-                var _a;
-                return __generator(this, function (_b) {
-                    switch (_b.label) {
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
                         case 0:
-                            if (!props.restApi) return [3 /*break*/, 2];
-                            return [4 /*yield*/, props.restApi["delete"](props.components.api, (_a = {}, _a[props.primaryKey] = props.recordId, _a))];
-                        case 1:
-                            _b.sent();
-                            props.goToAction(exports.CRUD_ACTION_INDEX);
-                            return [2 /*return*/];
-                        case 2:
-                            if (!props.restUrl) return [3 /*break*/, 4];
+                            if (props.restApi) {
+                                props.goToAction(exports.CRUD_ACTION_INDEX);
+                                return [2 /*return*/];
+                            }
+                            if (!props.restUrl) return [3 /*break*/, 2];
                             return [4 /*yield*/, props.components.http["delete"]("".concat(props.restUrl, "/").concat(props.recordId))
                                     .then(function () { return props.goToAction(exports.CRUD_ACTION_INDEX); })["catch"](function (error) {
                                     if (props.errorHandler) {
@@ -114,10 +110,10 @@ var normalizeItems = function (sourceItems, fromProps) {
                                         throw error;
                                     }
                                 })];
-                        case 3:
-                            _b.sent();
+                        case 1:
+                            _a.sent();
                             return [2 /*return*/];
-                        case 4: throw new Error('Either restApi or restUrl must be set');
+                        case 2: throw new Error('Either restApi or restUrl must be set');
                     }
                 });
             }); }

package/ui/crud/index.d.ts

@@ -28,7 +28,6 @@ export declare const generateCrud: (routeId: string, props: ICrudGeneratorProps)
     enums: string | string[];
     role?: string;
     roles?: string[];
-    fetch?: import("../../hoc/fetch").IFetchHocConfigFunc;
     items?: IRouteItem[] | {
         [key: string]: IRouteItem;
     };

package/ui/form/AutoCompleteField/AutoCompleteField.d.ts

@@ -1,21 +1,41 @@
 import * as React from 'react';
 import { IDataProviderConfig } from '../../../hooks/useDataProvider';
 import { IDataSelectConfig } from '../../../hooks/useDataSelect';
-import { IInputFieldProps } from '../InputField/InputField';
+import { IBaseFieldProps } from '../InputField/InputField';
+export interface IAutoCompleteItem {
+    id: number | string | boolean;
+    label?: string;
+    additional?: {
+        icon: string;
+        text: string;
+    };
+    category?: string;
+    [key: string]: unknown;
+}
 /**
- * AutoComplete
- * Поле ввода текста с подсказками (auto-complete)
+ * AutoCompleteField
+ *
+ * Поле ввода текста с подсказками (auto-complete). Он позволяет пользователю вводить текст и предлагает
+ * варианты автозаполнения на основе предоставленных данных.
+ *
+ * Компонент `AutoCompleteField` принимает следующие свойства:
+ *
+ * - `searchOnFocus`: при фокусировке на поле ввода будет запускаться поиск (тип: boolean)
+ * - все остальные свойства являются наследниками интерфейсов `IBaseFieldProps`, `IDataProviderConfig` и `IDataSelectConfig`
+ *
+ * Примечание: Компонент `AutoCompleteField` требует указания списка элементов (`items`) и предоставления
+ * конфигурации для провайдера данных (`dataProvider`) и выборки данных (`autoComplete` и `autoFetch`).
  */
-export interface IAutoCompleteFieldProps extends IInputFieldProps, IDataProviderConfig, Omit<IDataSelectConfig, 'items'> {
+export interface IAutoCompleteFieldProps extends IBaseFieldProps, IDataProviderConfig, Omit<IDataSelectConfig, 'items'> {
     /**
      * При фокусировке на поле ввода будет запускаться поиск
      * @example true
      */
     searchOnFocus?: boolean;
-    [key: string]: any;
 }
 export interface IAutoCompleteFieldViewProps extends Omit<IAutoCompleteFieldProps, 'items'> {
-    items: Record<string, unknown>[];
+    items: IAutoCompleteItem[];
+    categories: string[];
     hoveredId: PrimaryKey | any;
     selectedIds: (PrimaryKey | any)[];
     forwardedRef: any;