argous 1.2.134 → 1.2.135

package/dist/components/ConfirmModal/BasicModal.d.ts

@@ -0,0 +1,38 @@
+import { DialogProps } from '@material-ui/core';
+import React from 'react';
+export interface BasicModalProps {
+    /**
+     * Label no botao de confirmar
+     */
+    okLabel: React.ReactNode;
+    /**
+     * Label no botao de cancelar
+     */
+    cancelLabel: React.ReactNode;
+    /**
+     * Titulo do modal
+     */
+    title: React.ReactNode;
+    /**
+     * Descricao do modal
+     */
+    description: React.ReactNode;
+    /**
+     * Props repassados ao componente dialog
+     */
+    dialogProps: Omit<DialogProps, 'open'>;
+    /**
+     * @ignore
+     */
+    proceed: Function;
+    /**
+     * @ignore
+     */
+    cancel: Function;
+    /**
+     * @ignore
+     */
+    open: boolean;
+}
+declare const BasicModal: ({ okLabel, cancelLabel, title, description, open, proceed, dialogProps, cancel }: BasicModalProps) => JSX.Element;
+export default BasicModal;

package/dist/components/ConfirmModal/BasicModal.js

@@ -0,0 +1,29 @@
+"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 };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var core_1 = require("@material-ui/core");
+var react_1 = __importDefault(require("react"));
+var BasicModal = function (_a) {
+    var _b = _a.okLabel, okLabel = _b === void 0 ? 'Ok' : _b, _c = _a.cancelLabel, cancelLabel = _c === void 0 ? 'Cancelar' : _c, _d = _a.title, title = _d === void 0 ? '' : _d, _e = _a.description, description = _e === void 0 ? '' : _e, open = _a.open, proceed = _a.proceed, dialogProps = _a.dialogProps, cancel = _a.cancel;
+    return (react_1.default.createElement(core_1.Dialog, __assign({ open: open, onClose: function () { return cancel(false); } }, dialogProps),
+        react_1.default.createElement(core_1.DialogTitle, null, title),
+        react_1.default.createElement(core_1.DialogContent, null,
+            react_1.default.createElement(core_1.DialogContentText, { component: 'div' }, description)),
+        react_1.default.createElement(core_1.DialogActions, null,
+            react_1.default.createElement(core_1.Button, { variant: 'contained', color: 'secondary', onClick: function () { return proceed(false); } }, cancelLabel),
+            react_1.default.createElement(core_1.Button, { variant: 'contained', color: 'primary', onClick: function () { return proceed(true); } }, okLabel))));
+};
+exports.default = BasicModal;

package/dist/components/ConfirmModal/ModalProvider.d.ts

@@ -0,0 +1,5 @@
+import { ModalProviderContextProps } from '.';
+import React from 'react';
+export declare const ModalProviderContext: React.Context<ModalProviderContextProps>;
+declare const _default: import("react-redux").ConnectedComponent<({ children, argousSystem }: any) => JSX.Element, import("react-redux").Omit<any, "argousSystem" | "dispatch">>;
+export default _default;

package/dist/components/ConfirmModal/ModalProvider.js

@@ -0,0 +1,108 @@
+"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;
+    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.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModalProviderContext = void 0;
+var BasicModal_1 = __importDefault(require("./BasicModal"));
+var fieldsRedux_1 = require("../../fieldsRedux");
+var react_1 = __importStar(require("react"));
+var react_redux_1 = require("react-redux");
+var use_immer_1 = require("use-immer");
+// @ts-ignore
+exports.ModalProviderContext = react_1.createContext();
+var ModalProvider = function (_a) {
+    var children = _a.children, argousSystem = _a.argousSystem;
+    var _b = use_immer_1.useImmer([]), modals = _b[0], setCurrentModal = _b[1];
+    var close = react_1.useCallback(function (unmountDelay, index) { return function () {
+        setTimeout(function () { return setCurrentModal(function (modais) { return void (modais.splice(index, 1)); }); }, unmountDelay);
+    }; }, [setCurrentModal]);
+    var createModal = react_1.useCallback(function (Component, unmountDelay) {
+        if (unmountDelay === void 0) { unmountDelay = 0; }
+        return function (props) {
+            var promise = new Promise(function (resolve, reject) {
+                setCurrentModal(function (modais) { return void (modais.push(react_1.default.createElement(ModalWrapper, __assign({ Component: Component, close: close(unmountDelay, modals.length), resolve: resolve, reject: reject }, props)))); });
+            });
+            return promise.then(function (result) {
+                close(unmountDelay, modals.length);
+                return result;
+            }, function (result) {
+                close(unmountDelay, modals.length);
+                return Promise.reject(result);
+            });
+        };
+    }, [close, modals.length, setCurrentModal]);
+    var openModal = react_1.useMemo(function () { var _a; return (_a = argousSystem === null || argousSystem === void 0 ? void 0 : argousSystem.openModal) === null || _a === void 0 ? void 0 : _a.value; }, [argousSystem]);
+    react_1.useEffect(function () {
+        if (!openModal)
+            return;
+        var reject = openModal.reject, resolve = openModal.resolve, props = __rest(openModal, ["reject", "resolve"]);
+        createModal(BasicModal_1.default)(props).then(resolve, reject);
+        fieldsRedux_1.setAnotherProgramField('openModal', undefined, 'argousSystem');
+        //eslint-disable-next-line
+    }, [openModal]);
+    var context = react_1.useMemo(function () { return ({ createModal: createModal }); }, [createModal]);
+    return (react_1.default.createElement(exports.ModalProviderContext.Provider, { value: context },
+        children,
+        modals.map(function (Modal) { return Modal; })));
+};
+var mapStateToProps = function (state) { return ({
+    argousSystem: state.argous.fields.argousSystem,
+}); };
+exports.default = react_redux_1.connect(mapStateToProps)(ModalProvider);
+var ModalWrapper = function (_a) {
+    var Component = _a.Component, reject = _a.reject, resolve = _a.resolve, close = _a.close, props = __rest(_a, ["Component", "reject", "resolve", "close"]);
+    var _b = react_1.useState(true), show = _b[0], setShow = _b[1];
+    var cancel = react_1.useCallback(function (reject) { return function (value) {
+        setShow(false);
+        reject(value);
+        close();
+    }; }, [close]);
+    var proceed = react_1.useCallback(function (resolve) { return function (value) {
+        setShow(false);
+        resolve(value);
+        close();
+    }; }, [close]);
+    return react_1.default.createElement(Component, __assign({ cancel: cancel(reject), proceed: proceed(resolve), open: show }, props));
+};

package/dist/components/ConfirmModal/WrapperModal.d.ts

@@ -0,0 +1,18 @@
+import { DialogProps } from '@material-ui/core';
+import React from 'react';
+export interface WrapperModalProps {
+    okLabel: React.ReactNode;
+    cancelLabel: React.ReactNode;
+    title: React.ReactNode;
+    dialogProps: Omit<DialogProps, 'open'>;
+    /**
+     * @ignore
+     */
+    proceed: Function;
+    /**
+     * @ignore
+     */
+    open: boolean;
+}
+declare const WrapperModal: (Component: (props: any) => JSX.Element) => ({ proceed, open, title, cancelLabel, okLabel, dialogProps, ...props }: WrapperModalProps) => JSX.Element;
+export default WrapperModal;

package/dist/components/ConfirmModal/WrapperModal.js

@@ -0,0 +1,41 @@
+"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 __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var MaterialButton_1 = __importDefault(require("../MaterialButton/MaterialButton"));
+var core_1 = require("@material-ui/core");
+var react_1 = __importDefault(require("react"));
+var WrapperModal = function (Component) { return function (_a) {
+    var proceed = _a.proceed, open = _a.open, title = _a.title, _b = _a.cancelLabel, cancelLabel = _b === void 0 ? 'Cancelar' : _b, _c = _a.okLabel, okLabel = _c === void 0 ? 'Ok' : _c, dialogProps = _a.dialogProps, props = __rest(_a, ["proceed", "open", "title", "cancelLabel", "okLabel", "dialogProps"]);
+    return react_1.default.createElement(core_1.Dialog, __assign({ open: open, onClose: function () { return proceed(false); } }, dialogProps),
+        title && react_1.default.createElement(core_1.DialogTitle, null, title),
+        react_1.default.createElement(core_1.DialogContent, null,
+            react_1.default.createElement(Component, __assign({}, props))),
+        react_1.default.createElement(core_1.DialogActions, null,
+            cancelLabel && react_1.default.createElement(MaterialButton_1.default, { variant: 'contained', color: 'secondary', onClick: function () { return proceed(false); } }, cancelLabel),
+            okLabel && react_1.default.createElement(MaterialButton_1.default, { variant: 'contained', color: 'primary', onClick: function () { return proceed(true); } }, okLabel)));
+}; };
+exports.default = WrapperModal;

package/dist/components/ConfirmModal/index.d.ts

@@ -0,0 +1,20 @@
+export interface BasicComponentProps {
+  cancel: (value: unknown) => void,
+  proceed: (value: unknown) => void,
+  open: boolean
+}
+
+export type CreateModalType = <P>(Component: (props: P & BasicComponentProps) => JSX.Element, unmountDelay?: number) => (props?: Omit<P, keyof BasicComponentProps>) => Promise<unknown>
+
+export interface ModalProviderContextProps {
+  createModal: CreateModalType
+}
+
+export { default } from './ModalProvider';
+export * from './ModalProvider';
+
+export { default as BasicModal } from './BasicModal';
+export * from './BasicModal';
+
+export { default as WrapperModal } from './WrapperModal';
+export * from './WrapperModal';

package/dist/components/ConfirmModal/index.js

@@ -0,0 +1,25 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WrapperModal = exports.BasicModal = exports.default = void 0;
+var ModalProvider_1 = require("./ModalProvider");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(ModalProvider_1).default; } });
+__exportStar(require("./ModalProvider"), exports);
+var BasicModal_1 = require("./BasicModal");
+Object.defineProperty(exports, "BasicModal", { enumerable: true, get: function () { return __importDefault(BasicModal_1).default; } });
+__exportStar(require("./BasicModal"), exports);
+var WrapperModal_1 = require("./WrapperModal");
+Object.defineProperty(exports, "WrapperModal", { enumerable: true, get: function () { return __importDefault(WrapperModal_1).default; } });
+__exportStar(require("./WrapperModal"), exports);

package/dist/components/DropArea/DropArea.d.ts

@@ -0,0 +1,21 @@
+import * as React from 'react';
+
+export interface DropAreaProps extends Omit<React.HTMLProps<HTMLDivElement>, 'onChange'> {
+  /**
+   * Função chamada ao receber arquivo
+   * 
+   * @param arquivo - Arquivo
+   * 
+   * @returns {void} Sem Retorno
+   */
+  onChange?: (arquivo: File) => void
+}
+
+/**
+ * Componente para drop de arquivos
+ * 
+ * Repassa o arquivo dropado diretamente para um file preparer se tiver o mesmo como filho
+ */
+declare function DropArea(props: DropAreaProps): JSX.Element
+
+export default DropArea;

package/dist/components/DropArea/DropArea.js

@@ -0,0 +1,149 @@
+"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;
+    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.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var Html5FileSelector_1 = require("./Html5FileSelector");
+var __1 = require("../");
+var core_1 = require("@material-ui/core");
+var react_1 = __importStar(require("react"));
+var md_1 = require("react-icons/md");
+var DropArea = function (_a, ref) {
+    var children = _a.children, onChange = _a.onChange, style = _a.style, props = __rest(_a, ["children", "onChange", "style"]);
+    var _b = react_1.useState(false), abrir = _b[0], setAbrir = _b[1];
+    var _c = react_1.useState(false), loading = _c[0], setLoading = _c[1];
+    /** @param {React.DragEvent<HTMLDivElement>} e */
+    var dropArquivo = function (e) { return __awaiter(void 0, void 0, void 0, function () {
+        var finalArray;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    e.preventDefault();
+                    setLoading(true);
+                    return [4 /*yield*/, Html5FileSelector_1.getDroppedOrSelectedFiles(e)];
+                case 1:
+                    finalArray = _a.sent();
+                    // console.log(temp, temp.reduce((acc, { fileObject, fullPath }) => {
+                    //   const fileName = fullPath.match(/\/([^\/]*)$/)?.at(1);
+                    //   const objectPath = fullPath.replace(fileName, '').substring(1).slice(0, -1);
+                    //   return set(acc, objectPath.length ? [...objectPath.split('/'), fileName] : fileName, fileObject)
+                    // }, {}));
+                    // const length = e.dataTransfer.items.length, 
+                    //     i = 0, itens = e.dataTransfer.items, finalArray = [];
+                    // for (i; i < length; i++) {
+                    //   const item = itens[i];
+                    //   if (item.kind === 'file') finalArray.push(item.getAsFile())
+                    // }
+                    // onChange && onChange(finalArray)
+                    // if (ref?.current) ref.current.preparaArquivo(finalArray)
+                    onChange && onChange(finalArray);
+                    if (ref === null || ref === void 0 ? void 0 : ref.current)
+                        ref.current.preparaArquivo(finalArray);
+                    setLoading(false);
+                    setAbrir(false);
+                    return [2 /*return*/];
+            }
+        });
+    }); };
+    return (react_1.default.createElement("div", __assign({ onDragEnter: function () { return setAbrir(true); }, style: __assign({ position: 'relative' }, style) }, props),
+        abrir && (!(ref === null || ref === void 0 ? void 0 : ref.current) || (ref.current && !ref.current.loading)) && (react_1.default.createElement("div", { onDragLeave: function () { return setAbrir(false); }, onDrop: dropArquivo, onDragOver: function (e) { return e.preventDefault(); }, style: {
+                position: 'absolute',
+                border: '1px dashed',
+                background: 'rgba(0,0,0,0.5)',
+                zIndex: 5, width: '100%', height: '100%'
+            } }, loading ?
+            react_1.default.createElement(core_1.Box, { display: 'flex', justifyContent: 'center', alignItems: 'center', height: '100%' },
+                react_1.default.createElement(core_1.CircularProgress, { disableShrink: true }))
+            :
+                react_1.default.createElement(md_1.MdFileUpload, { style: { width: '100%', height: '100%' } }))),
+        deepMap(children, function (filho) { return filho.type === __1.FilePreparer ? react_1.cloneElement(filho, __assign(__assign({}, filho.props), { ref: ref })) : filho; })));
+};
+exports.default = react_1.forwardRef(DropArea);
+var deepMap = function (children, deepMapFn) {
+    return react_1.Children.toArray(children).map(function (child, index, mapChildren) {
+        if (react_1.isValidElement(child) && hasComplexChildren(child)) {
+            return deepMapFn(react_1.cloneElement(child, __assign(__assign({}, child.props), { children: deepMap(child.props.children, deepMapFn) })));
+        }
+        return deepMapFn(child, index, mapChildren);
+    });
+};
+var hasComplexChildren = function (element) {
+    return react_1.isValidElement(element) &&
+        hasChildren(element) &&
+        react_1.Children.toArray(element.props.children).reduce(function (response, child) { return response || react_1.isValidElement(child); }, false);
+};
+var hasChildren = function (element) { return react_1.isValidElement(element) && element.props.children; };

package/dist/components/DropArea/Html5FileSelector.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @param {DataTransfer} dataTransfer
+ */
+export function getDataTransferFiles(dataTransfer: DataTransfer): Promise<any>;
+/**
+ * This function should be called from both the onDrop event from your drag/drop
+ * dropzone as well as from the HTML5 file selector input field onChange event
+ * handler.  Pass the event object from the triggered event into this function.
+ * Supports mix of files and folders dropped via drag/drop.
+ *
+ * Returns: an array of File objects, that includes all files within folders
+ *   and subfolders of the dropped/selected items.
+ *
+ * @param {React.DragEvent<HTMLDivElement>} event
+ */
+export function getDroppedOrSelectedFiles(event: React.DragEvent<HTMLDivElement>): Promise<any>;