dce-reactkit 5.0.1 → 5.0.3

package/dist/esm/types/components/FakeProgressBar.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Fake progress bar that approaches completion but never fully finishes.
+ * Built on top of the existing ProgressBar component.
+ *
+ * Two phases:
+ *   1. Fast phase (0–90%): random jumps of 1–5% at randomized intervals,
+ *      paced to reach ~90% in roughly estimatedTimeSec seconds.
+ *   2. Slow phase (90–99%): crawls 1% at a time with longer random delays,
+ *      never reaching 100% on its own.
+ *
+ * When isFinished becomes true, the bar immediately jumps to 100%.
+ * @author Yuen Ler Chow
+ */
+import React from 'react';
+import Variant from '../types/Variant';
+import ProgressBarSize from '../types/ProgressBarSize';
+type Props = {
+    isFinished?: boolean;
+    estimatedTimeSec?: number;
+    striped?: boolean;
+    variant?: Variant;
+    bgVariant?: Variant;
+    showOutline?: boolean;
+    size?: ProgressBarSize;
+};
+declare const FakeProgressBar: React.FC<Props>;
+export default FakeProgressBar;

package/dist/esm/types/components/SimpleDateChooser.d.ts

@@ -21,6 +21,7 @@ type Props = {
     dontAllowPast?: boolean;
     dontAllowFuture?: boolean;
     isDisabled?: boolean;
+    hideDay?: boolean;
 };
 declare const SimpleDateChooser: React.FC<Props>;
 export default SimpleDateChooser;

package/dist/esm/types/components/SimpleMonthChooser.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A very simple, lightweight month chooser
+ * @author Gabe Abrams
+ */
+import React from 'react';
+type Props = {
+    ariaLabel: string;
+    name: string;
+    month: number;
+    year: number;
+    /**
+     * Handler for when month changes
+     * @param month new 1-indexed month number
+     * @param year new full year number
+     */
+    onChange: (month: number, year: number) => void;
+    numMonthsToShow?: number;
+    dontAllowPast?: boolean;
+    dontAllowFuture?: boolean;
+    isDisabled?: boolean;
+};
+declare const SimpleMonthChooser: React.FC<Props>;
+export default SimpleMonthChooser;

package/dist/esm/types/index.d.ts

@@ -8,6 +8,7 @@ import RadioButton from './components/RadioButton';
 import CheckboxButton from './components/CheckboxButton';
 import ButtonInputGroup from './components/ButtonInputGroup';
 import SimpleDateChooser from './components/SimpleDateChooser';
+import SimpleMonthChooser from './components/SimpleMonthChooser';
 import SimpleTimeChooser from './components/SimpleTimeChooser';
 import Drawer from './components/Drawer';
 import PopSuccessMark from './components/PopSuccessMark';
@@ -25,6 +26,7 @@ import AutoscrollToBottomContainer from './components/AutoscrollToBottomContaine
 import MultiSwitch from './components/MultiSwitch';
 import Dropdown from './components/Dropdown';
 import ProgressBar from './components/ProgressBar';
+import FakeProgressBar from './components/FakeProgressBar';
 import DynamicWord from './dynamicConstants/DynamicWord';
 import initClient from './helpers/initClient';
 import visitServerEndpoint from './helpers/visitServerEndpoint';
@@ -47,4 +49,4 @@ import PickableItem from './components/ItemPicker/types/PickableItem';
 import DBEntry from './components/DBEntryManagerPanel/types/DBEntry';
 import DBEntryField from './components/DBEntryManagerPanel/types/DBEntryField';
 import DBEntryFieldType from './components/DBEntryManagerPanel/types/DBEntryFieldType';
-export { AppWrapper, LoadingSpinner, ErrorBox, Modal, TabBox, RadioButton, CheckboxButton, ButtonInputGroup, SimpleDateChooser, SimpleTimeChooser, Drawer, PopSuccessMark, PopFailureMark, PopPendingMark, CopiableBox, ItemPicker, LogReviewer, IntelliTable, CSVDownloadButton, DBEntryManagerPanel, Tooltip, ToggleSwitch, AutoscrollToBottomContainer, MultiSwitch, Dropdown, ProgressBar, alert, prompt, confirm, showFatalError, DynamicWord, stubServerEndpoint, canReviewLogs, isMobileOrTablet, makeLinksClickable, isSelectAdmin, initClient, visitServerEndpoint, logClientEvent, addFatalErrorHandler, leaveToURL, combineClassNames, useForceRender, setClientEventMetadataPopulator, ModalButtonType, ModalSize, ModalType, Variant, IntelliTableColumn, DropdownItemType, LogReviewerFilterState, ProgressBarSize, PickableItem, DBEntry, DBEntryField, DBEntryFieldType, ErrorWithCode, MINUTE_IN_MS, HOUR_IN_MS, DAY_IN_MS, LOG_REVIEW_ROUTE_PATH_PREFIX, LOG_ROUTE_PATH, LOG_REVIEW_STATUS_ROUTE, LOG_REVIEW_GET_LOGS_ROUTE, SELECT_ADMIN_CHECK_ROUTE, abbreviate, avg, ceilToNumDecimals, floorToNumDecimals, forceNumIntoBounds, padDecimalZeros, padZerosLeft, roundToNumDecimals, sum, waitMs, getOrdinal, getTimeInfoInET, startMinWait, getHumanReadableDate, getPartOfDay, stringsToHumanReadableList, onlyKeepLetters, parallelLimit, getMonthName, genCSV, extractProp, compareArraysByProp, getLocalTimeInfo, genCommaList, validateEmail, validatePhoneNumber, validateString, idify, prefixWithAOrAn, everyAsync, filterAsync, forEachAsync, mapAsync, someAsync, capitalize, shuffleArray, getWordCount, cloneDeep, getTimestampFromTimeInfoInET, ParamType, DayOfWeek, Log, LogType, LogSource, LogAction, LogBuiltInMetadata, LogMetadataType, LogFunction, LogTypeSpecificInfo, LogMainInfo, LogSourceSpecificInfo, LogLevel, CommonKitErrorCode, };
+export { AppWrapper, LoadingSpinner, ErrorBox, Modal, TabBox, RadioButton, CheckboxButton, ButtonInputGroup, SimpleDateChooser, SimpleMonthChooser, SimpleTimeChooser, Drawer, PopSuccessMark, PopFailureMark, PopPendingMark, CopiableBox, ItemPicker, LogReviewer, IntelliTable, CSVDownloadButton, DBEntryManagerPanel, Tooltip, ToggleSwitch, AutoscrollToBottomContainer, MultiSwitch, Dropdown, ProgressBar, FakeProgressBar, alert, prompt, confirm, showFatalError, DynamicWord, stubServerEndpoint, canReviewLogs, isMobileOrTablet, makeLinksClickable, isSelectAdmin, initClient, visitServerEndpoint, logClientEvent, addFatalErrorHandler, leaveToURL, combineClassNames, useForceRender, setClientEventMetadataPopulator, ModalButtonType, ModalSize, ModalType, Variant, IntelliTableColumn, DropdownItemType, LogReviewerFilterState, ProgressBarSize, PickableItem, DBEntry, DBEntryField, DBEntryFieldType, ErrorWithCode, MINUTE_IN_MS, HOUR_IN_MS, DAY_IN_MS, LOG_REVIEW_ROUTE_PATH_PREFIX, LOG_ROUTE_PATH, LOG_REVIEW_STATUS_ROUTE, LOG_REVIEW_GET_LOGS_ROUTE, SELECT_ADMIN_CHECK_ROUTE, abbreviate, avg, ceilToNumDecimals, floorToNumDecimals, forceNumIntoBounds, padDecimalZeros, padZerosLeft, roundToNumDecimals, sum, waitMs, getOrdinal, getTimeInfoInET, startMinWait, getHumanReadableDate, getPartOfDay, stringsToHumanReadableList, onlyKeepLetters, parallelLimit, getMonthName, genCSV, extractProp, compareArraysByProp, getLocalTimeInfo, genCommaList, validateEmail, validatePhoneNumber, validateString, idify, prefixWithAOrAn, everyAsync, filterAsync, forEachAsync, mapAsync, someAsync, capitalize, shuffleArray, getWordCount, cloneDeep, getTimestampFromTimeInfoInET, ParamType, DayOfWeek, Log, LogType, LogSource, LogAction, LogBuiltInMetadata, LogMetadataType, LogFunction, LogTypeSpecificInfo, LogMainInfo, LogSourceSpecificInfo, LogLevel, CommonKitErrorCode, };

package/dist/index.d.ts

@@ -25,7 +25,7 @@ declare enum Variant {
  * @author Gabe Abrams
  */
 
-type Props$n = {
+type Props$p = {
     children: React$1.ReactNode;
 };
 /**
@@ -108,7 +108,7 @@ declare const showFatalError: (error: any, errorTitle?: string) => Promise<void>
  * @author Gabe Abrams
  */
 declare const addFatalErrorHandler: (handler: () => void) => void;
-declare const AppWrapper: React$1.FC<Props$n>;
+declare const AppWrapper: React$1.FC<Props$p>;
 
 /**
  * Loading spinner/indicator
@@ -122,14 +122,14 @@ declare const LoadingSpinner: () => React$1.JSX.Element;
  * @author Gabe Abrams
  */
 
-type Props$m = {
+type Props$o = {
     error: any;
     title?: string;
     onClose?: () => void;
     variant?: Variant;
     icon?: IconProp;
 };
-declare const ErrorBox: React$1.FC<Props$m>;
+declare const ErrorBox: React$1.FC<Props$o>;
 
 /**
  * Types of buttons in the modal
@@ -228,7 +228,7 @@ declare const Modal: React$1.FC<ModalProps>;
  * @author Gabe Abrams
  */
 
-type Props$l = {
+type Props$n = {
     title: React$1.ReactNode;
     children: React$1.ReactNode;
     topRightChildren?: React$1.ReactNode;
@@ -236,14 +236,14 @@ type Props$l = {
     noBottomPadding?: boolean;
     minTitleWidth?: string;
 };
-declare const TabBox: React$1.FC<Props$l>;
+declare const TabBox: React$1.FC<Props$n>;
 
 /**
  * A radio selection button
  * @author Gabe Abrams
  */
 
-type Props$k = {
+type Props$m = {
     text: React$1.ReactNode;
     onSelected: () => void;
     ariaLabel: string;
@@ -257,14 +257,14 @@ type Props$k = {
     small?: boolean;
     useComplexFormatting?: boolean;
 };
-declare const RadioButton: React$1.FC<Props$k>;
+declare const RadioButton: React$1.FC<Props$m>;
 
 /**
  * A checkbox button
  * @author Gabe Abrams
  */
 
-type Props$j = {
+type Props$l = {
     text: React$1.ReactNode;
     onChanged: (checked: boolean) => void;
     ariaLabel: string;
@@ -279,14 +279,14 @@ type Props$j = {
     dashed?: boolean;
     useComplexFormatting?: boolean;
 };
-declare const CheckboxButton: React$1.FC<Props$j>;
+declare const CheckboxButton: React$1.FC<Props$l>;
 
 /**
  * Input group with a title and space for buttons
  * @author Gabe Abrams
  */
 
-type Props$i = {
+type Props$k = {
     label: React$1.ReactNode;
     minLabelWidth?: string;
     children: React$1.ReactNode;
@@ -295,7 +295,7 @@ type Props$i = {
     isAdminFeature?: boolean;
     noMarginOnBottom?: boolean;
 };
-declare const ButtonInputGroup: React$1.FC<Props$i>;
+declare const ButtonInputGroup: React$1.FC<Props$k>;
 
 /**
  * A very simple, lightweight date chooser
@@ -303,7 +303,7 @@ declare const ButtonInputGroup: React$1.FC<Props$i>;
  * @author Gardenia Liu
  */
 
-type Props$h = {
+type Props$j = {
     ariaLabel: string;
     name: string;
     month: number;
@@ -320,15 +320,39 @@ type Props$h = {
     dontAllowPast?: boolean;
     dontAllowFuture?: boolean;
     isDisabled?: boolean;
+    hideDay?: boolean;
+};
+declare const SimpleDateChooser: React$1.FC<Props$j>;
+
+/**
+ * A very simple, lightweight month chooser
+ * @author Gabe Abrams
+ */
+
+type Props$i = {
+    ariaLabel: string;
+    name: string;
+    month: number;
+    year: number;
+    /**
+     * Handler for when month changes
+     * @param month new 1-indexed month number
+     * @param year new full year number
+     */
+    onChange: (month: number, year: number) => void;
+    numMonthsToShow?: number;
+    dontAllowPast?: boolean;
+    dontAllowFuture?: boolean;
+    isDisabled?: boolean;
 };
-declare const SimpleDateChooser: React$1.FC<Props$h>;
+declare const SimpleMonthChooser: React$1.FC<Props$i>;
 
 /**
  * A very simple, lightweight time chooser
  * @author Gardenia Liu
  */
 
-type Props$g = {
+type Props$h = {
     ariaLabel: string;
     name: string;
     hour: number;
@@ -342,62 +366,62 @@ type Props$g = {
     intervalMin?: number;
     isDisabled?: boolean;
 };
-declare const SimpleTimeChooser: React$1.FC<Props$g>;
+declare const SimpleTimeChooser: React$1.FC<Props$h>;
 
 /**
  * Drawer container
  * @author Gabe Abrams
  */
 
-type Props$f = {
+type Props$g = {
     grayBackground?: boolean;
     customBackgroundColor?: string;
     children: React$1.ReactNode;
 };
-declare const Drawer: React$1.FC<Props$f>;
+declare const Drawer: React$1.FC<Props$g>;
 
 /**
  * Success checkmark that pops into view
  * @author Gabe Abrams
  */
 
-type Props$e = {
+type Props$f = {
     sizeRem?: number;
     circleVariant?: string;
     checkVariant?: string;
 };
-declare const PopSuccessMark: React$1.FC<Props$e>;
+declare const PopSuccessMark: React$1.FC<Props$f>;
 
 /**
  * Failure x mark that pops into view
  * @author Gabe Abrams
  */
 
-type Props$d = {
+type Props$e = {
     sizeRem?: number;
     circleVariant?: string;
     xVariant?: string;
 };
-declare const PopFailureMark: React$1.FC<Props$d>;
+declare const PopFailureMark: React$1.FC<Props$e>;
 
 /**
  * Failure pending that pops into view
  * @author Gabe Abrams
  */
 
-type Props$c = {
+type Props$d = {
     sizeRem?: number;
     circleVariant?: string;
     hourglassVariant?: string;
 };
-declare const PopPendingMark: React$1.FC<Props$c>;
+declare const PopPendingMark: React$1.FC<Props$d>;
 
 /**
  * Copiable text box
  * @author Gabe Abrams
  */
 
-type Props$b = {
+type Props$c = {
     text: string;
     maxTextWidthRem?: number;
     label?: string;
@@ -409,7 +433,7 @@ type Props$b = {
     textAreaId?: string;
     copyButtonId?: string;
 };
-declare const CopiableBox: React$1.FC<Props$b>;
+declare const CopiableBox: React$1.FC<Props$c>;
 
 /**
  * An item that can be chosen (for use within ItemPicker)
@@ -432,7 +456,7 @@ type PickableItem = ({
  * @author Yuen Ler Chow
  */
 
-type Props$a = {
+type Props$b = {
     title: string;
     items: PickableItem[];
     /**
@@ -444,7 +468,7 @@ type Props$a = {
     noBottomMargin?: boolean;
     hideSelectAllOrNoneButtons?: boolean;
 };
-declare const ItemPicker: React$1.FC<Props$a>;
+declare const ItemPicker: React$1.FC<Props$b>;
 
 /**
  * Log reviewer panel that allows users (must be approved admins) to
@@ -452,11 +476,11 @@ declare const ItemPicker: React$1.FC<Props$a>;
  * @author Gabe Abrams
  */
 
-type Props$9 = {
+type Props$a = {
     LogMetadata: LogMetadataType;
     onClose: () => void;
 };
-declare const LogReviewer: React$1.FC<Props$9>;
+declare const LogReviewer: React$1.FC<Props$a>;
 
 /**
  * Column description for a column in the IntelliTable
@@ -474,7 +498,7 @@ type IntelliTableColumn = {
  * @author Gabe Abrams
  */
 
-type Props$8 = {
+type Props$9 = {
     title: string;
     id: string;
     data: {
@@ -484,14 +508,14 @@ type Props$8 = {
     columns: IntelliTableColumn[];
     csvName?: string;
 };
-declare const IntelliTable: React$1.FC<Props$8>;
+declare const IntelliTable: React$1.FC<Props$9>;
 
 /**
  * Button for downloading a csv file
  * @author Gabe Abrams
  */
 
-type Props$7 = {
+type Props$8 = {
     filename: string;
     csv: string;
     label?: string;
@@ -504,7 +528,7 @@ type Props$7 = {
     onClick?: () => void;
     children?: React$1.ReactNode;
 };
-declare const CSVDownloadButton: React$1.FC<Props$7>;
+declare const CSVDownloadButton: React$1.FC<Props$8>;
 
 /**
  * Generic type for an object
@@ -580,7 +604,7 @@ type DBEntryField = ({
  * @author Gabe Abrams
  */
 
-type Props$6 = {
+type Props$7 = {
     entryFields: DBEntryField[];
     idPropName: string;
     titlePropName: string;
@@ -606,18 +630,18 @@ type Props$6 = {
         [k: string]: any;
     };
 };
-declare const DBEntryManagerPanel: React$1.FC<Props$6>;
+declare const DBEntryManagerPanel: React$1.FC<Props$7>;
 
 /**
  * Simple tooltip component
  * @author Gabe Abrams
  */
 
-type Props$5 = {
+type Props$6 = {
     text: string;
     children: any;
 };
-declare const Tooltip: React$1.FC<Props$5>;
+declare const Tooltip: React$1.FC<Props$6>;
 
 /**
  * A toggle switch that toggles on or off
@@ -625,7 +649,7 @@ declare const Tooltip: React$1.FC<Props$5>;
  * @author Gabe Abrams
  */
 
-type Props$4 = {
+type Props$5 = {
     isOn: boolean;
     /**
      * A handler to call when the switch is toggled
@@ -637,7 +661,7 @@ type Props$4 = {
     description: string;
     backgroundVariantWhenOn?: Variant;
 };
-declare const ToggleSwitch: React$1.FC<Props$4>;
+declare const ToggleSwitch: React$1.FC<Props$5>;
 
 /**
  * Container that automatically scrolls when new items are added,
@@ -648,7 +672,7 @@ declare const ToggleSwitch: React$1.FC<Props$4>;
  * @author Gabe Abrams
  */
 
-type Props$3 = {
+type Props$4 = {
     itemsName?: string;
     items: AutoScrollItem[];
     jumpToBottomButtonVariant?: Variant;
@@ -659,7 +683,7 @@ type AutoScrollItem = {
     id: string | number;
     item: React$1.ReactNode;
 };
-declare const AutoscrollToBottomContainer: React$1.FC<Props$3>;
+declare const AutoscrollToBottomContainer: React$1.FC<Props$4>;
 
 /**
  * A switch with multiple options for selection
@@ -668,7 +692,7 @@ declare const AutoscrollToBottomContainer: React$1.FC<Props$3>;
  * @author Austen Money
  */
 
-type Props$2 = {
+type Props$3 = {
     options: Option[];
     selectedOptionId: string;
     /**
@@ -683,7 +707,7 @@ type Option = {
     icon: IconProp;
     id: string;
 };
-declare const MultiSwitch: React$1.FC<Props$2>;
+declare const MultiSwitch: React$1.FC<Props$3>;
 
 declare enum DropdownItemType {
     Header = "Header",
@@ -698,7 +722,7 @@ declare enum DropdownItemType {
  * @author Gabe Abrams
  */
 
-type Props$1 = {
+type Props$2 = {
     items: DropdownItem[];
     dropdownButton: {
         ariaLabel: string;
@@ -719,7 +743,7 @@ type DropdownItem = ({
     id: string;
     onClick: () => void;
 });
-declare const Dropdown: React$1.FC<Props$1>;
+declare const Dropdown: React$1.FC<Props$2>;
 
 /**
  * Progress bar sizes
@@ -735,7 +759,7 @@ declare enum ProgressBarSize {
  * @author Allison Zhang
  */
 
-type Props = (({
+type Props$1 = (({
     percentProgress: number;
     numDecimalPlaces?: number;
 } | {
@@ -748,7 +772,32 @@ type Props = (({
     showOutline?: boolean;
     size?: ProgressBarSize;
 });
-declare const ProgressBar: React$1.FC<Props>;
+declare const ProgressBar: React$1.FC<Props$1>;
+
+/**
+ * Fake progress bar that approaches completion but never fully finishes.
+ * Built on top of the existing ProgressBar component.
+ *
+ * Two phases:
+ *   1. Fast phase (0–90%): random jumps of 1–5% at randomized intervals,
+ *      paced to reach ~90% in roughly estimatedTimeSec seconds.
+ *   2. Slow phase (90–99%): crawls 1% at a time with longer random delays,
+ *      never reaching 100% on its own.
+ *
+ * When isFinished becomes true, the bar immediately jumps to 100%.
+ * @author Yuen Ler Chow
+ */
+
+type Props = {
+    isFinished?: boolean;
+    estimatedTimeSec?: number;
+    striped?: boolean;
+    variant?: Variant;
+    bgVariant?: Variant;
+    showOutline?: boolean;
+    size?: ProgressBarSize;
+};
+declare const FakeProgressBar: React$1.FC<Props>;
 
 /**
  * Dynamic words determined by the user's platform
@@ -916,4 +965,4 @@ declare const useForceRender: (useReducer: any) => () => void;
  */
 declare const isSelectAdmin: () => Promise<boolean>;
 
-export { AppWrapper, AutoscrollToBottomContainer, ButtonInputGroup, CSVDownloadButton, CheckboxButton, CopiableBox, DBEntry, DBEntryField, DBEntryFieldType, DBEntryManagerPanel, Drawer, Dropdown, DropdownItemType, DynamicWord, ErrorBox, IntelliTable, IntelliTableColumn, ItemPicker, LoadingSpinner, LogReviewer, Modal, ModalButtonType, ModalSize, ModalType, MultiSwitch, PickableItem, PopFailureMark, PopPendingMark, PopSuccessMark, ProgressBar, ProgressBarSize, RadioButton, SimpleDateChooser, SimpleTimeChooser, TabBox, ToggleSwitch, Tooltip, Variant, addFatalErrorHandler, alert, canReviewLogs, combineClassNames, confirm, initClient, isMobileOrTablet, isSelectAdmin, leaveToURL, logClientEvent, makeLinksClickable, prompt, setClientEventMetadataPopulator, showFatalError, stubServerEndpoint, useForceRender, visitServerEndpoint };
+export { AppWrapper, AutoscrollToBottomContainer, ButtonInputGroup, CSVDownloadButton, CheckboxButton, CopiableBox, DBEntry, DBEntryField, DBEntryFieldType, DBEntryManagerPanel, Drawer, Dropdown, DropdownItemType, DynamicWord, ErrorBox, FakeProgressBar, IntelliTable, IntelliTableColumn, ItemPicker, LoadingSpinner, LogReviewer, Modal, ModalButtonType, ModalSize, ModalType, MultiSwitch, PickableItem, PopFailureMark, PopPendingMark, PopSuccessMark, ProgressBar, ProgressBarSize, RadioButton, SimpleDateChooser, SimpleMonthChooser, SimpleTimeChooser, TabBox, ToggleSwitch, Tooltip, Variant, addFatalErrorHandler, alert, canReviewLogs, combineClassNames, confirm, initClient, isMobileOrTablet, isSelectAdmin, leaveToURL, logClientEvent, makeLinksClickable, prompt, setClientEventMetadataPopulator, showFatalError, stubServerEndpoint, useForceRender, visitServerEndpoint };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dce-reactkit",
-  "version": "5.0.1",
+  "version": "5.0.3",
   "description": "Shared components for Harvard DCE apps",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",