superdesk-ui-framework 2.4.14 → 2.4.15

package/examples/pages/react/Tooltips.tsx

@@ -15,7 +15,8 @@ export default class TooltipDoc extends React.Component {
                     </Tooltip>
                 `}
                 </Markup.ReactMarkupCodePreview>
-                <p className="docs-page__paragraph">Chose one of 4 placement options (<code>’left’</code>, <code>’right’</code>, <code>’bottom’</code>, and <code>’top’</code>). The default value is <code>’top’</code> and will be rendered so without explicitly specifying it.</p>
+                <h3 className="docs-page__h3">Default</h3>
+                <p className="docs-page__paragraph">Chose one of 4 placement options (<code>’left’</code>, <code>’right’</code>, <code>down</code>, and <code>’top’</code>). The default value is <code>’top’</code> and will be rendered so without explicitly specifying it.</p>
                 <Markup.ReactMarkup>
                     <Markup.ReactMarkupPreview>
                         <div className="docs-page__content-row docs-page__content-row--no-margin">
@@ -30,7 +31,7 @@ export default class TooltipDoc extends React.Component {
                             </Tooltip>
                             <Tooltip text="Right on!" flow='right'>
                                 <Button text='right' onClick={() => false} />
-                            </Tooltip>
+                            </Tooltip>   
                         </div>
                     </Markup.ReactMarkupPreview>
                     <Markup.ReactMarkupCode>{`
@@ -50,10 +51,53 @@ export default class TooltipDoc extends React.Component {
                     </Markup.ReactMarkupCode>
                 </Markup.ReactMarkup>
 
+                <h3 className="docs-page__h3">Appended to body</h3>
+                <p className="docs-page__paragraph">
+                    Appends tooltip element to body therefore avoids overflow issues. For performance reasons don't use it if not necessary.
+                </p>
+                <Markup.ReactMarkup>
+                    <Markup.ReactMarkupPreview>
+                       
+                        <div className="docs-page__content-row docs-page__content-row--no-margin">
+                            
+                            <div className="docs-page__content-row docs-page__content-row--no-margin" style={{background: "#ebebeb", width: "100%", padding: "5px", overflow: "hidden"}}>
+                                <Tooltip text="I'm appended to body" flow='top' appendToBody={true}>
+                                    <Button text='top' onClick={() => false} />
+                                </Tooltip>
+                                <Tooltip text="I'm appended to body" flow='down' appendToBody={true}>
+                                    <Button text='Down' onClick={() => false} />
+                                </Tooltip>
+                                <Tooltip text="I'm appended to body" flow='left' appendToBody={true}>
+                                    <Button text='left' onClick={() => false} />
+                                </Tooltip>
+                                <Tooltip text="I'm appended to body" flow='right' appendToBody={true}>
+                                    <Button text='right' onClick={() => false} />
+                                </Tooltip>
+                            </div>
+                        </div>
+                    </Markup.ReactMarkupPreview>
+                    <Markup.ReactMarkupCode>{`
+                        <Tooltip text="I'm appended to body" flow='top' appendToBody={true}>
+                                    <Button text='top' onClick={() => false} />
+                                </Tooltip>
+                                <Tooltip text="I'm appended to body" flow='down' appendToBody={true}>
+                                    <Button text='Down' onClick={() => false} />
+                                </Tooltip>
+                                <Tooltip text="I'm appended to body" flow='left' appendToBody={true}>
+                                    <Button text='left' onClick={() => false} />
+                                </Tooltip>
+                                <Tooltip text="I'm appended to body" flow='right' appendToBody={true}>
+                                    <Button text='right' onClick={() => false} />
+                                </Tooltip>
+                    `}
+                    </Markup.ReactMarkupCode>
+                </Markup.ReactMarkup>
+
                 <h3 className="docs-page__h3">Props</h3>
                 <PropsList>
-                    <Prop name='text' isRequered={true} type='string' default='/' description='Tooltip text value.' />
-                    <Prop name='flow' isRequered={false} type='top | left | right | down' default='top' description='Position of tooltip text.' />
+                    <Prop name='text' isRequired={true} type='string' default='/' description='Tooltip text value.' />
+                    <Prop name='flow' isRequired={false} type='top | left | right | down' default='top' description='Position of tooltip text.' />
+                    <Prop name='appendToBody' isRequired={false} type='boolean' default='false' description='Appends element to body therefore avoids overflow issues.' />
                 </PropsList>
             </section>
         )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superdesk-ui-framework",
-  "version": "2.4.14",
+  "version": "2.4.15",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",
@@ -82,12 +82,12 @@
   "dependencies": {
     "@material-ui/lab": "^4.0.0-alpha.56",
     "@popperjs/core": "^2.4.0",
+    "@superdesk/primereact": "^5.0.2-4",
     "@types/node": "^14.10.2",
     "chart.js": "^2.9.3",
     "date-fns": "2.7.0",
     "popper.js": "1.14.4",
     "primeicons": "2.0.0",
-    "@superdesk/primereact": "5.0.2-2",
     "react-id-generator": "^3.0.0",
     "react-popper": "^2.2.3"
   }

package/patches/@superdesk+primereact+5.0.2-4.patch

@@ -0,0 +1,13 @@
+diff --git a/node_modules/@superdesk/primereact/components/tieredmenu/TieredMenu.d.ts b/node_modules/@superdesk/primereact/components/tieredmenu/TieredMenu.d.ts
+index a91da27..3dd7822 100644
+--- a/node_modules/@superdesk/primereact/components/tieredmenu/TieredMenu.d.ts
++++ b/node_modules/@superdesk/primereact/components/tieredmenu/TieredMenu.d.ts
+@@ -9,7 +9,7 @@ interface TieredMenuProps {
+     style?: object;
+     className?: string;
+     autoZIndex?: boolean;
+-    bazeZIndex?: number;
++    baseZIndex?: number;
+     appendTo?: any;
+     onShow?(e: Event): void;
+     onHide?(e: Event): void;

package/react/components/Button.d.ts

@@ -8,7 +8,7 @@ interface IButtonBase {
     icon?: string;
     disabled?: boolean;
     iconOnly?: boolean;
-    onClick(): void;
+    onClick(event: React.MouseEvent<HTMLButtonElement, MouseEvent>): void;
     'data-test-id'?: string;
 }
 interface IPropsButton extends IButtonBase {

package/react/components/Button.js

@@ -46,6 +46,7 @@ var Button = /** @class */ (function (_super) {
     }
     Button.prototype.render = function () {
         var _a;
+        var _this = this;
         var classes = classnames_1.default('btn', (_a = {
                 'btn--expanded': this.props.expand
             },
@@ -57,7 +58,7 @@ var Button = /** @class */ (function (_super) {
             _a['btn--ui-dark'] = this.props.theme === 'dark',
             _a['btn--icon-only-circle'] = this.props.shape === 'round' && this.props.iconOnly,
             _a));
-        return (React.createElement("button", { id: this.props.id, className: classes, tabIndex: 0, onClick: this.props.disabled ? function () { return false; } : this.props.onClick, "aria-label": this.props.iconOnly ? this.props.text : '', "data-test-id": this.props['data-test-id'] },
+        return (React.createElement("button", { id: this.props.id, className: classes, tabIndex: 0, onClick: this.props.disabled ? function () { return false; } : function (event) { return _this.props.onClick(event); }, "aria-label": this.props.iconOnly ? this.props.text : '', "data-test-id": this.props['data-test-id'] },
             this.props.icon ? React.createElement(Icon_1.Icon, { name: this.props.icon }) : null,
             this.props.iconOnly ? null : this.props.text));
     };

package/react/components/DropdownFirst.js

@@ -47,7 +47,7 @@ exports.DropdownFirst = function (_a) {
         return function () {
             var context = children;
             clearTimeout(inDebounce);
-            inDebounce = setTimeout(function () { return calculate.apply(context); }, delay);
+            inDebounce = window.setTimeout(function () { return calculate.apply(context); }, delay);
         };
     };
     React.useLayoutEffect(function () {

package/react/components/IconPicker.d.ts

@@ -0,0 +1,24 @@
+import * as React from 'react';
+import { IItem } from "./SelectGrid";
+interface IProps {
+    label?: string;
+    filterPlaceholder?: string;
+    translateFunction?: (text: string) => string;
+    value: string;
+    onChange(icon: string): void;
+}
+interface IState {
+    icons: Array<IItem>;
+}
+export declare class IconPicker extends React.PureComponent<IProps, IState> {
+    constructor(props: IProps);
+    componentDidMount(): void;
+    getItems: (searchString: string | null) => Promise<Array<IItem>>;
+    onChange: (item: IItem) => void;
+    triggerTemplate: (props: any) => JSX.Element;
+    itemTemplate: ({ item }: {
+        item: IItem | null;
+    }) => JSX.Element | null;
+    render(): JSX.Element;
+}
+export {};

package/react/components/IconPicker.js

@@ -0,0 +1,283 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __spreadArrays = (this && this.__spreadArrays) || function () {
+    for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;
+    for (var r = Array(s), k = 0, i = 0; i < il; i++)
+        for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)
+            r[k] = a[j];
+    return r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IconPicker = void 0;
+var React = __importStar(require("react"));
+// @ts-ignore
+var iconFont = __importStar(require("../../app/styles/_icon-font.scss"));
+var Button_1 = require("./Button");
+var Icon_1 = require("./Icon");
+var SelectGrid_1 = require("./SelectGrid");
+var IconPicker = /** @class */ (function (_super) {
+    __extends(IconPicker, _super);
+    function IconPicker(props) {
+        var _this = _super.call(this, props) || this;
+        _this.getItems = function (searchString) {
+            return new Promise(function (resolve) {
+                var icons = __spreadArrays(_this.state.icons);
+                if (searchString) {
+                    icons = icons.filter(function (icon) { return (icon.value.toLowerCase().includes(searchString) ||
+                        icon.label.toLowerCase().includes(searchString)); });
+                }
+                resolve(icons);
+            });
+        };
+        _this.onChange = function (item) {
+            _this.props.onChange(item.value);
+        };
+        _this.triggerTemplate = function (props) { return React.createElement(Button_1.Button, { icon: _this.props.value, text: _this.props.value, onClick: function (e) { props.onClick(e); }, iconOnly: true }); };
+        _this.itemTemplate = function (_a) {
+            var item = _a.item;
+            return item ?
+                (React.createElement(React.Fragment, null,
+                    React.createElement(Icon_1.Icon, { name: item.value }),
+                    React.createElement("span", { className: "sd-text__normal sd-padding-t--1" }, item.label))) : null;
+        };
+        _this.state = { icons: [] };
+        return _this;
+    }
+    IconPicker.prototype.componentDidMount = function () {
+        var translateFunction = this.props.translateFunction ?
+            this.props.translateFunction : function (text) { return text; };
+        this.setState({
+            icons: getIcons(translateFunction),
+        });
+    };
+    IconPicker.prototype.render = function () {
+        return (React.createElement(SelectGrid_1.SelectGrid, { label: this.props.label || "Icon", filterPlaceholder: this.props.filterPlaceholder || "Search...", getItems: this.getItems, onChange: this.onChange, itemTemplate: this.itemTemplate, triggerTemplate: this.triggerTemplate }));
+    };
+    return IconPicker;
+}(React.PureComponent));
+exports.IconPicker = IconPicker;
+var getIcons = function (translateFunction) {
+    var translatedIconNameMap = {
+        'add-gallery': 'Add Gallery',
+        'add-image': 'Add Image',
+        'adjust': 'Adjust',
+        'align-center': 'Align Center',
+        'align-justify': 'Align Justify',
+        'align-left': 'Align Left',
+        'align-right': 'Align Right',
+        'amp': 'AMP',
+        'analytics': 'Analytics',
+        'archive': 'Archive',
+        'arrow-left': 'Arrow Left',
+        'arrow-right': 'Arrow Right',
+        'arrow-small': 'Arrow Small',
+        'ascending': 'Ascending',
+        'assign': 'Assign',
+        'attachment': 'Attachment',
+        'attachment-large': 'Attachment Large',
+        'audio': 'Audio',
+        'backward-thin': 'Backward Thin',
+        'ban-circle': 'Ban Circle',
+        'bell': 'Bell',
+        'bold': 'Bold',
+        'broadcast': 'Broadcast',
+        'broadcast-create': 'Broadcast Create',
+        'business': 'Business',
+        'calendar': 'Calendar',
+        'calendar-list': 'Calendar List',
+        'chevron-down-thin': 'Chevron Down Thin',
+        'chevron-left-thin': 'Chevron Left Thin',
+        'chevron-right-thin': 'Chevron Right Thin',
+        'chevron-up-thin': 'Chevron Up Thin',
+        'clear-all': 'Clear All',
+        'clear-format': 'Clear Format',
+        'close-small': 'Close Small',
+        'close-thick': 'Close Thick',
+        'code': 'Code',
+        'collapse': 'Collapse',
+        'comment': 'Comment',
+        'composite': 'Composite',
+        'copy': 'Copy',
+        'crop': 'Crop',
+        'cut': 'Cut',
+        'descending': 'Descending',
+        'dots': 'Dots',
+        'dots-vertical': 'Dots Vertical',
+        'download': 'Download',
+        'download-alt': 'Download Alternate',
+        'edit-line': 'Edit Line',
+        'envelope': 'Envelope',
+        'event': 'Event',
+        'exclamation-sign': 'Exclamation Sign',
+        'expand': 'Expand',
+        'expand-thin': 'Expand Thin',
+        'external': 'External',
+        'eye-open': 'Eye Open',
+        'facebook': 'Facebook',
+        'facebook-circle': 'Facebook Circle',
+        'fast_forward': 'Fast Forward',
+        'fast_rewind': 'Fast Rewind',
+        'fetch-as': 'Fetch As',
+        'file': 'File',
+        'filter-large': 'Filter Large',
+        'flip-horizontal': 'Flip Horizontal',
+        'flip-vertical': 'Flip Vertical',
+        'folder-close': 'Folder Close',
+        'folder-open': 'Folder Open',
+        'font': 'Font',
+        'forward-thin': 'Forward Thin',
+        'fullscreen': 'Fullscreen',
+        'globe': 'Globe',
+        'graphic': 'Graphic',
+        'grid-view': 'Grid View',
+        'grid-view-large': 'Grid View Large',
+        'heading-1': 'Heading 1',
+        'heading-2': 'Heading 2',
+        'heading-3': 'Heading 3',
+        'heading-4': 'Heading 4',
+        'heading-5': 'Heading 5',
+        'heading-6': 'Heading 6',
+        'heart': 'Heart',
+        'help-large': 'Help Large',
+        'highlight-package': 'Highlight Package',
+        'home': 'Home',
+        'indent-left': 'Indent Left',
+        'indent-right': 'Indent Right',
+        'info-large': 'Info Large',
+        'info-sign': 'Info Sign',
+        'ingest': 'Ingest',
+        'instagram': 'Instagram',
+        'italic': 'Italic',
+        'kanban-view': 'Kanban View',
+        'kill': 'Kill',
+        'link': 'Link',
+        'linked-in': 'LinkedIn',
+        'linked-in-circle': 'LinkedIn Circle',
+        'list-alt': 'List Alternate',
+        'list-menu': 'List Menu',
+        'list-plus': 'List Plus',
+        'list-view': 'List View',
+        'lock': 'Lock',
+        'map-marker': 'Map Marker',
+        'minus-sign': 'Minus Sign',
+        'minus-small': 'Minus Small',
+        'mobile': 'Mobile',
+        'move': 'Move',
+        'multi-star': 'Multi Start',
+        'multiedit': 'Multi Edit',
+        'new-doc': 'New Document',
+        'ok': 'Okay',
+        'ordered-list': 'Ordered List',
+        'package-create': 'Package Create',
+        'package-plus': 'Package Plus',
+        'paragraph': 'Paragraph',
+        'paste': 'Paste',
+        'pause': 'Pause',
+        'paywall': 'Paywall',
+        'pencil': 'Pencil',
+        'phone': 'Phone',
+        'photo': 'Photo',
+        'pick': 'Pick',
+        'picture': 'Picture',
+        'pin': 'Pin',
+        'play': 'Play',
+        'plus-large': 'Plus Large',
+        'plus-sign': 'Plus Sign',
+        'plus-small': 'Plus Small',
+        'post': 'Post',
+        'preformatted': 'Preformatted',
+        'preview-mode': 'Preview Mode',
+        'print': 'Print',
+        'question-sign': 'Question Sign',
+        'quote': 'Quote',
+        'random': 'Random',
+        'recurring': 'Recurring',
+        'redo': 'Redo',
+        'refresh': 'Refresh',
+        'remove-sign': 'Remove Sign',
+        'repeat': 'Repeat',
+        'retweet': 'Retweet',
+        'revert': 'Revert',
+        'rotate-left': 'Rotate Left',
+        'rotate-right': 'Rotate Right',
+        'search': 'Search',
+        'settings': 'Settings',
+        'share-alt': 'Share Alternate',
+        'signal': 'Signal',
+        'skip_next': 'Skip Next',
+        'skip_previous': 'Skip Previous',
+        'slideshow': 'Slideshow',
+        'star': 'Star',
+        'star-empty': 'Star Empty',
+        'stop': 'Stop',
+        'stream': 'Stream',
+        'strikethrough': 'Strikethrough',
+        'subscript': 'Subscript',
+        'suggestion': 'Suggestion',
+        'superscript': 'Superscript',
+        'switches': 'Switches',
+        'table': 'Table',
+        'takes-package': 'Takes Package',
+        'tasks': 'Tasks',
+        'text': 'Text',
+        'text-format': 'Text Format',
+        'th': 'Table Header',
+        'th-large': 'Table Header Large',
+        'th-list': 'Table Header List',
+        'time': 'Time',
+        'to-lowercase': 'To Lowercase',
+        'to-uppercase': 'To Uppercase',
+        'trash': 'Trash',
+        'twitter': 'Twitter',
+        'twitter-circle': 'Twitter Circle',
+        'underline': 'Underline',
+        'undo': 'Undo',
+        'unlocked': 'Unlocked',
+        'unordered-list': 'Unordered List',
+        'unspike': 'Unspike',
+        'upload': 'Upload',
+        'user': 'User',
+        'video': 'Video',
+        'warning-sign': 'Warning Sign',
+        'zoom-in': 'Zoom In',
+        'zoom-out': 'Zoom Out',
+    };
+    return iconFont.icon
+        .split(', ')
+        .sort()
+        .map(function (icon) { return ({
+        value: icon,
+        label: translatedIconNameMap[icon] ? translateFunction(translatedIconNameMap[icon]) : icon,
+    }); });
+};

package/react/components/ListItemLoader.d.ts

@@ -0,0 +1,4 @@
+import * as React from 'react';
+export declare class ListItemLoader extends React.Component<{}> {
+    render(): JSX.Element;
+}

package/react/components/ListItemLoader.js

@@ -0,0 +1,62 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListItemLoader = void 0;
+var React = __importStar(require("react"));
+var Skeleton_1 = require("./Skeleton");
+var ListItemLoader = /** @class */ (function (_super) {
+    __extends(ListItemLoader, _super);
+    function ListItemLoader() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    ListItemLoader.prototype.render = function () {
+        return (React.createElement("div", { className: "sd-list-item sd-shadow--z1 sd-list-item--no-hover" },
+            React.createElement("div", { className: "sd-list-item__border" }),
+            React.createElement("div", { className: "sd-list-item__column" },
+                React.createElement(Skeleton_1.Skeleton, { shape: "circle", size: "2rem" })),
+            React.createElement("div", { className: "sd-list-item__column sd-padding-y--1" },
+                React.createElement(Skeleton_1.Skeleton, { shape: "circle", size: "2rem", className: "sd-margin-b--0-5" }),
+                React.createElement(Skeleton_1.Skeleton, { shape: "circle", size: "2rem" })),
+            React.createElement("div", { className: "sd-list-item__column sd-list-item__column--grow sd-list-item__column--no-border" },
+                React.createElement("div", { className: "sd-list-item__row sd-padding-b--0-5" },
+                    React.createElement(Skeleton_1.Skeleton, { borderRadius: "16px" }),
+                    React.createElement(Skeleton_1.Skeleton, { width: "10rem", borderRadius: "16px", className: "sd-margin-l--0-5" })),
+                React.createElement("div", { className: "sd-list-item__row" },
+                    React.createElement(Skeleton_1.Skeleton, { width: "8rem", borderRadius: "16px" }),
+                    React.createElement(Skeleton_1.Skeleton, { width: "8rem", borderRadius: "16px", className: "sd-margin-l--0-5" }),
+                    React.createElement(Skeleton_1.Skeleton, { width: "8rem", borderRadius: "16px", className: "sd-margin-l--0-5" })))));
+    };
+    return ListItemLoader;
+}(React.Component));
+exports.ListItemLoader = ListItemLoader;

package/react/components/Menu.d.ts

@@ -0,0 +1,59 @@
+import React, { SyntheticEvent } from 'react';
+/**
+ * Known issues:
+ *
+ * 1. Menu detaches from trigger element when scrolling.
+ * Closing the menu on scroll would fix it,
+ * but in case there are more items than
+ * can fit in the screen, some wouldn't be selectable.
+ *
+ * 2. In some cases, menus will be rendered outside of viewport.
+ * When the menu is triggered, it will check whether
+ * there is more space available on the left or right
+ * and will render submenus in that direction.
+ * It only checks available space relatively to the trigger element.
+ * If there's no space left after n submenus have been opened,
+ * it won't change direction.
+ *
+ * Accessibility features:
+ * * ESC closes the last sub-menu or entire menu
+ * * When menu is closed via ESC, focus returns to the element that was focused before opening the menu
+ * * Focuses the first item on activation
+ * * Focuses first sub-menu item when sub-menu opens
+ * * ENTER/ESC or arrow keys work for entering/leaving submenus
+ */
+export declare type IMenuItem = IMenuBranch | IMenuLeaf | ISeparator;
+/**
+ * Available icons are listed here:
+ * https://ui-framework.superdesk.org/#/components/icons
+ */
+declare type IIconName = string;
+interface ISeparator {
+    separator: true;
+}
+interface IMenuLeaf {
+    label: string;
+    icon?: IIconName;
+    onClick(): void;
+    disabled?: boolean;
+}
+interface IMenuBranch {
+    label: string;
+    icon?: IIconName;
+    children: Array<IMenuItem>;
+}
+interface IProps {
+    items: Array<IMenuItem>;
+    children: (toggle: (event: SyntheticEvent) => void) => JSX.Element;
+    zIndex?: number;
+}
+export declare class Menu extends React.Component<IProps, {}> {
+    private menu;
+    private focusedBefore;
+    constructor(props: IProps);
+    private toPrimeReactInterface;
+    private toggle;
+    private close;
+    render(): JSX.Element;
+}
+export {};