dce-reactkit 3.1.3 → 3.1.6

package/dist/cjs/index.js

@@ -937,7 +937,7 @@ const CheckboxButton = (props) => {
     /*                                  Setup                                 */
     /*------------------------------------------------------------------------*/
     /* -------------- Props ------------- */
-    const { text, onChanged, ariaLabel, title, checked, id, noMarginOnRight, checkedVariant = Variant$1.Secondary, uncheckedVariant = Variant$1.Light, small, dashed, } = props;
+    const { text, onChanged, ariaLabel, title, checked, id, className, noMarginOnRight, checkedVariant = Variant$1.Secondary, uncheckedVariant = Variant$1.Light, small, dashed, } = props;
     /*------------------------------------------------------------------------*/
     /*                                 Render                                 */
     /*------------------------------------------------------------------------*/
@@ -955,7 +955,7 @@ const CheckboxButton = (props) => {
             : freeRegularSvgIcons.faSquare);
     }
     // Create the button
-    return (React__default["default"].createElement("button", { type: "button", id: id, title: title, className: `CheckboxButton-status-${checked ? 'checked' : 'unchecked'} ${dashed ? 'CheckboxButton-dashed ' : ''}btn btn-${checked ? checkedVariant : uncheckedVariant}${checked ? ' selected' : ''}${small ? ' btn-sm' : ''} m-0${noMarginOnRight ? '' : ' me-1'}`, "aria-label": `${ariaLabel}${checked ? ': currently checked' : ''}`, onClick: () => {
+    return (React__default["default"].createElement("button", { type: "button", id: id, title: title, className: `CheckboxButton-status-${checked ? 'checked' : 'unchecked'} ${dashed ? 'CheckboxButton-dashed ' : ''}btn btn-${checked ? checkedVariant : uncheckedVariant}${checked ? ' selected' : ''}${small ? ' btn-sm' : ''} m-0${noMarginOnRight ? '' : ' me-1'} ${className !== null && className !== void 0 ? className : ''}`, "aria-label": `${ariaLabel}${checked ? ': currently checked' : ''}`, onClick: () => {
             onChanged(!checked);
         } },
         React__default["default"].createElement(reactFontawesome.FontAwesomeIcon, { icon: icon, className: "me-1" }),
@@ -1543,27 +1543,27 @@ const PopPendingMark = (props) => {
  */
 /* ------------- Actions ------------ */
 // Types of actions
-var ActionType;
+var ActionType$1;
 (function (ActionType) {
     // Indicate that the text was recently copied
     ActionType["IndicateRecentlyCopied"] = "indicate-recently-copied";
     // Clear the status
     ActionType["ClearRecentlyCopiedStatus"] = "clear-recently-copied-status";
-})(ActionType || (ActionType = {}));
+})(ActionType$1 || (ActionType$1 = {}));
 /**
  * Reducer that executes actions
  * @author Gabe Abrams
  * @param state current state
  * @param action action to execute
  */
-const reducer = (state, action) => {
+const reducer$1 = (state, action) => {
     switch (action.type) {
-        case ActionType.IndicateRecentlyCopied: {
+        case ActionType$1.IndicateRecentlyCopied: {
             return {
                 recentlyCopied: true,
             };
         }
-        case ActionType.ClearRecentlyCopiedStatus: {
+        case ActionType$1.ClearRecentlyCopiedStatus: {
             return {
                 recentlyCopied: false,
             };
@@ -1589,7 +1589,7 @@ const CopiableBox = (props) => {
         recentlyCopied: false,
     };
     // Initialize state
-    const [state, dispatch] = React.useReducer(reducer, initialState);
+    const [state, dispatch] = React.useReducer(reducer$1, initialState);
     // Destructure common state
     const { recentlyCopied, } = state;
     /*------------------------------------------------------------------------*/
@@ -1609,13 +1609,13 @@ const CopiableBox = (props) => {
         }
         // Show copied notice
         dispatch({
-            type: ActionType.IndicateRecentlyCopied,
+            type: ActionType$1.IndicateRecentlyCopied,
         });
         // Wait a moment
         yield waitMs(4000);
         // Hide copied notice
         dispatch({
-            type: ActionType.ClearRecentlyCopiedStatus,
+            type: ActionType$1.ClearRecentlyCopiedStatus,
         });
     });
     /*------------------------------------------------------------------------*/
@@ -1664,6 +1664,183 @@ const CopiableBox = (props) => {
                 "Copy")))));
 };
 
+/**
+ * Reusable nested item picker
+ * @author Yuen Ler Chow
+ */
+/* ------------- Actions ------------ */
+// Types of actions
+var ActionType;
+(function (ActionType) {
+    // Toggle whether the children are being shown
+    ActionType["ToggleItems"] = "toggle-items";
+})(ActionType || (ActionType = {}));
+/**
+ * Reducer that executes actions
+ * @author Yuen Ler Chow
+ * @param state current state
+ * @param action action to execute
+ */
+const reducer = (state, action) => {
+    switch (action.type) {
+        case ActionType.ToggleItems: {
+            return { isShowingItems: !state.isShowingItems };
+        }
+        default: {
+            return state;
+        }
+    }
+};
+/*------------------------------------------------------------------------*/
+/*                                Component                               */
+/*------------------------------------------------------------------------*/
+const NestableItemList = (props) => {
+    /*------------------------------------------------------------------------*/
+    /*                                  Setup                                 */
+    /*------------------------------------------------------------------------*/
+    /* -------------- Props ------------- */
+    // Destructure all props
+    const { items, onChanged, } = props;
+    /* -------------- State ------------- */
+    // Initial state
+    const initialState = {
+        isShowingItems: true,
+    };
+    // Initialize state
+    const [state, dispatch] = React.useReducer(reducer, initialState);
+    // Destructure common state
+    const { isShowingItems, } = state;
+    /*------------------------------------------------------------------------*/
+    /*                           Component Functions                          */
+    /*------------------------------------------------------------------------*/
+    /**
+     * Checks if all items in a list are checked
+     * @author Yuen Ler Chow
+     * @param pickableItems a list of items
+     * @returns true if all items are checked. If any item is a group,
+     *   we recursively check its children
+     */
+    const allChecked = (pickableItems) => {
+        return pickableItems.every((item) => {
+            if (item.isGroup) {
+                return allChecked(item.children);
+            }
+            return item.checked;
+        });
+    };
+    /**
+     * Checks if none of the items in a list are checked
+     * @author Yuen Ler Chow
+     * @param pickableItems a list of items
+     * @returns true if all items are unchecked. If any item is a group, we
+     *   recursively check its children
+     */
+    const noneChecked = (pickableItems) => {
+        return pickableItems.every((item) => {
+            if (item.isGroup) {
+                return noneChecked(item.children);
+            }
+            return !item.checked;
+        });
+    };
+    /**
+     * Change whether specific items are checked
+     * @author Yuen Ler Chow
+     * @param id the id of the item we want to check or uncheck OR true if
+     *   we are checking/unchecking all items, independent of their id
+     * @param checked if true, the item will be checked.
+     * @param pickableItems the list of items we iterate through to find the item
+     *   we want to check/uncheck
+     * @returns a list of items with the item now checked/unchecked.
+     *   If it is a group, its children will also become checked/unchecked
+     */
+    const changeChecked = (id, checked, pickableItems) => {
+        const updatedItems = pickableItems.map((item) => {
+            if (item.id === id || id === true) {
+                if (item.isGroup) {
+                    return Object.assign(Object.assign({}, item), { children: changeChecked(true, checked, item.children) });
+                }
+                return Object.assign(Object.assign({}, item), { checked });
+            }
+            if (item.isGroup) {
+                return Object.assign(Object.assign({}, item), { children: changeChecked(id, checked, item.children) });
+            }
+            return item;
+        });
+        return updatedItems;
+    };
+    /**
+     * Within a tree of items, swap in the list of updated items into the spot
+     *   indicated by the id
+     * @author Yuen Ler Chow
+     * @param id the id of the item group we want to change
+     * @param updatedItems the list of items we want to change the items in the group to
+     * @returns a list of all items containing the updated items
+     */
+    const changeItems = (id, updatedItems) => {
+        return items.map((item) => {
+            if (item.id === id) {
+                return Object.assign(Object.assign({}, item), { children: updatedItems });
+            }
+            return item;
+        });
+    };
+    /*------------------------------------------------------------------------*/
+    /*                                 Render                                 */
+    /*------------------------------------------------------------------------*/
+    return (React__default["default"].createElement("div", null, items.map((item) => {
+        return (React__default["default"].createElement("div", { key: item.id },
+            React__default["default"].createElement("span", { className: "NestableItemList-dropdown-button-container d-inline-block", style: {
+                    minWidth: '2rem',
+                } }, item.isGroup && (React__default["default"].createElement("button", { className: `NestableItemList-dropdown-button NestableItemList-dropdown-button-${item.id}`, style: {
+                    border: 0,
+                    backgroundColor: 'transparent',
+                }, type: "button", onClick: () => {
+                    dispatch({
+                        type: ActionType.ToggleItems,
+                    });
+                }, "aria-label": `${isShowingItems ? 'Hide' : 'Show'} items in ${item.name}` },
+                React__default["default"].createElement(reactFontawesome.FontAwesomeIcon, { icon: isShowingItems ? freeSolidSvgIcons.faChevronDown : freeSolidSvgIcons.faChevronRight })))),
+            React__default["default"].createElement(CheckboxButton, { className: `NestableItemList-CheckboxButton-${item.id}`, text: item.name, checked: item.isGroup ? allChecked(item.children) : item.checked, dashed: item.isGroup ? !noneChecked(item.children) : false, onChanged: (checked) => {
+                    onChanged(changeChecked(item.id, checked, items));
+                }, ariaLabel: `Select ${item.name}`, checkedVariant: Variant$1.Light }),
+            item.isGroup && isShowingItems && (React__default["default"].createElement("div", { className: "NestableItemList-children-container", style: {
+                    paddingLeft: '2.2rem',
+                } },
+                React__default["default"].createElement(NestableItemList, { items: item.children, onChanged: (updatedItems) => {
+                        onChanged(changeItems(item.id, updatedItems));
+                    } })))));
+    })));
+};
+
+/**
+ * Reusable nested item picker
+ * @author Yuen Ler Chow
+ */
+/*------------------------------------------------------------------------*/
+/*                                Component                               */
+/*------------------------------------------------------------------------*/
+const ItemPicker = (props) => {
+    /*------------------------------------------------------------------------*/
+    /*                                  Setup                                 */
+    /*------------------------------------------------------------------------*/
+    /* -------------- Props ------------- */
+    // Destructure all props
+    const { title, items, onChanged, } = props;
+    /*------------------------------------------------------------------------*/
+    /*                           Component Functions                          */
+    /*------------------------------------------------------------------------*/
+    /*------------------------------------------------------------------------*/
+    /*                                 Render                                 */
+    /*------------------------------------------------------------------------*/
+    /*----------------------------------------*/
+    /*                 Main UI                */
+    /*----------------------------------------*/
+    return (React__default["default"].createElement(TabBox, { title: title },
+        React__default["default"].createElement("div", { style: { overflowX: 'scroll' } },
+            React__default["default"].createElement(NestableItemList, { items: items, onChanged: onChanged }))));
+};
+
 /**
  * One minute in ms
  * @author Gabe Abrams
@@ -2489,6 +2666,53 @@ const onlyKeepLetters = (str) => {
     return str.replace(/[^a-zA-Z]+/g, '');
 };
 
+/**
+ * Run tasks in parallel with a limit on how many tasks can execute at once.
+ *   No guarantees are made about the order of task execution
+ * @author Gabe Abrams
+ * @param taskFunctions functions that start asynchronous tasks and optionally
+ *   resolve with values
+ * @param limit maximum number of asynchronous tasks to permit to run at
+ *   once
+ * @returns array of resolved values in the same order as the task functions
+ */
+const parallelLimit = (taskFunctions, limit) => __awaiter(void 0, void 0, void 0, function* () {
+    const results = [];
+    // Wait until finished with all tasks
+    yield new Promise((resolve) => {
+        /* ------------- Helpers ------------ */
+        let nextTaskIndex = 0;
+        let numFinishedTasks = 0;
+        /**
+         * Start the next task
+         * @author Gabe Abrams
+         */
+        const startTask = () => __awaiter(void 0, void 0, void 0, function* () {
+            const taskIndex = nextTaskIndex++;
+            // Get the task
+            const taskFunction = taskFunctions[taskIndex];
+            if (!taskFunction) {
+                return;
+            }
+            // Execute task
+            const result = yield taskFunction();
+            // Add results
+            results[taskIndex] = result;
+            // Tally and finish
+            if (++numFinishedTasks === taskFunctions.length) {
+                return resolve();
+            }
+            // Not finished! Start another task
+            startTask();
+        });
+        /* ----------- Start Tasks ---------- */
+        for (let i = 0; i < limit; i++) {
+            startTask();
+        }
+    });
+    return results;
+});
+
 /**
  * Days of the week
  * @author Gabe Abrams
@@ -2515,6 +2739,7 @@ exports.Drawer = Drawer;
 exports.ErrorBox = ErrorBox;
 exports.ErrorWithCode = ErrorWithCode;
 exports.HOUR_IN_MS = HOUR_IN_MS;
+exports.ItemPicker = ItemPicker;
 exports.LoadingSpinner = LoadingSpinner;
 exports.MINUTE_IN_MS = MINUTE_IN_MS;
 exports.Modal = Modal;
@@ -2548,6 +2773,7 @@ exports.initServer = initServer;
 exports.onlyKeepLetters = onlyKeepLetters;
 exports.padDecimalZeros = padDecimalZeros;
 exports.padZerosLeft = padZerosLeft;
+exports.parallelLimit = parallelLimit;
 exports.roundToNumDecimals = roundToNumDecimals;
 exports.showFatalError = showFatalError;
 exports.startMinWait = startMinWait;