dce-reactkit 5.0.8 → 5.0.10

package/src/index.ts

@@ -15,6 +15,7 @@ import {
   abbreviate,
   avg,
   ceilToNumDecimals,
+  convertDateKeyToDateInfo,
   floorToNumDecimals,
   forceNumIntoBounds,
   padDecimalZeros,
@@ -121,6 +122,7 @@ import isMobileOrTablet from './helpers/isMobileOrTablet';
 import makeLinksClickable from './helpers/makeLinksClickable';
 import combineClassNames from './helpers/combineClassNames';
 import useForceRender from './helpers/useForceRender';
+import useBackButton, { backButtonController } from './helpers/useBackButton';
 import isSelectAdmin from './helpers/isSelectAdmin';
 
 // Import types
@@ -131,6 +133,8 @@ import Variant from './types/Variant';
 import IntelliTableColumn from './types/IntelliTableColumn';
 import DropdownItemType from './types/DropdownItemType';
 import ProgressBarSize from './types/ProgressBarSize';
+import BackState from './types/BackState';
+import BackButtonController from './types/BackButtonController';
 
 // Component-specific-types
 import PickableItem from './components/ItemPicker/types/PickableItem';
@@ -190,6 +194,8 @@ export {
   leaveToURL,
   combineClassNames,
   useForceRender,
+  useBackButton,
+  backButtonController,
   setClientEventMetadataPopulator,
   // Types
   ModalButtonType,
@@ -200,6 +206,8 @@ export {
   DropdownItemType,
   LogReviewerFilterState,
   ProgressBarSize,
+  BackState,
+  BackButtonController,
   // Component-specific-types
   PickableItem,
   DBEntry,
@@ -221,6 +229,7 @@ export {
   abbreviate,
   avg,
   ceilToNumDecimals,
+  convertDateKeyToDateInfo,
   floorToNumDecimals,
   forceNumIntoBounds,
   padDecimalZeros,

package/src/types/BackButtonController.ts

@@ -0,0 +1,43 @@
+// Import types
+import BackState from './BackState';
+
+/**
+ * Controller for the back button, used to drive back navigation from anywhere
+ *   in the app. Pass this to subpanels so they can describe their state and
+ *   send the user home.
+ * @author Yuen Ler Chow
+ */
+type BackButtonController = {
+  /**
+   * Call this when the user navigates to a child of the home screen (something
+   *   they can come back from)
+   */
+  onSubpanelEntered: () => void,
+  /**
+   * Send the user back to the home screen
+   * @param [force] if true, go home immediately without checking the subpanel
+   *   state (no confirmation, not blocked). If falsy, nothing happens when
+   *   blocked and confirmation is required when there are unsaved changes
+   */
+  goHome: (force?: boolean) => Promise<void>,
+  /**
+   * Set the state of the current subpanel, which determines what happens when
+   *   the user tries to go back
+   * @param newSubpanelState the new state of the subpanel
+   */
+  setSubpanelState: (newSubpanelState: BackState) => void,
+  /**
+   * Set the confirmation message shown if the user tries to go back while there
+   *   are unsaved changes (cleared upon returning to the home screen)
+   * @param message the message to show
+   */
+  setCustomUnsavedChangesMessage: (message: string) => void,
+  /**
+   * Set the message shown if the user tries to go back while blocked (cleared
+   *   upon returning to the home screen)
+   * @param message the message to show
+   */
+  setCustomBlockedMessage: (message: string) => void,
+};
+
+export default BackButtonController;

package/src/types/BackState.ts

@@ -0,0 +1,15 @@
+/**
+ * State of the current subpanel, determining what happens when the user tries
+ *   to go back to the home screen
+ * @author Yuen Ler Chow
+ */
+enum BackState {
+  // The user can go back immediately, no confirmation required
+  Normal = 'Normal',
+  // The user must confirm before going back because progress will be lost
+  UnsavedChanges = 'UnsavedChanges',
+  // The user cannot go back right now because work is in progress
+  Blocked = 'Blocked',
+}
+
+export default BackState;