@hedia/recommendation-screen 2.1.34-alpha.3 → 2.1.34-alpha.5

package/.github/workflows/ci.yaml

@@ -0,0 +1,17 @@
+name: Version Bump & Publish Alpha
+
+on:
+  pull_request:
+    branches:
+      - master
+    types: [opened, reopened, synchronize]
+
+env:
+  HEDIA_BOT_NPM_TOKEN: ${{ secrets.HEDIA_BOT_NPM_TOKEN }}
+
+jobs:
+  ci:
+    uses: hedia-team/service-workflows/.github/workflows/ci-package.yaml@hda-1973-refactor-service-actions
+    secrets:
+      HEDIA_BOT_NPM_TOKEN: ${{ secrets.HEDIA_BOT_NPM_TOKEN }}
+      HEDIA_BOT_GITHUB_PAT: ${{ secrets.HEDIA_BOT_GITHUB_PAT }}

package/.github/workflows/publish-release-package.yaml

@@ -0,0 +1,17 @@
+name: On post-merge - Publish package
+
+on:
+  pull_request:
+    branches:
+      - master
+    types: [closed]
+
+env:
+  HEDIA_BOT_NPM_TOKEN: ${{ secrets.HEDIA_BOT_NPM_TOKEN }}
+
+jobs:
+  ci:
+    uses: hedia-team/service-workflows/.github/workflows/bump-and-publish-npm-package.yaml@hda-1973-refactor-service-actions
+    secrets:
+      HEDIA_BOT_NPM_TOKEN: ${{ secrets.HEDIA_BOT_NPM_TOKEN }}
+      HEDIA_BOT_GITHUB_PAT: ${{ secrets.HEDIA_BOT_GITHUB_PAT }}

package/index.d.ts

@@ -0,0 +1,5 @@
+import RecommendationScreen from "./src/RecommendationScreen";
+import * as Errors from "./src/utils/RecommendationError";
+export default RecommendationScreen;
+export { Errors };
+export * from "./src/types/enum";

package/index.js

@@ -0,0 +1,5 @@
+import RecommendationScreen from "./src/RecommendationScreen";
+import * as Errors from "./src/utils/RecommendationError";
+export default RecommendationScreen;
+export { Errors };
+export * from "./src/types/enum";

package/package.json

@@ -1,25 +1,31 @@
 {
   "name": "@hedia/recommendation-screen",
-  "version": "2.1.34-alpha.3",
+  "version": "2.1.34-alpha.5",
   "description": "Hedia Recommendation Screen for Bolus and Carbohydrates",
   "main": "index.js",
   "scripts": {
-    "a": "index-git.sh && cd android && gradlew clean && cd .. && react-native run-android",
+    "a": "./index-git.sh && cd android && ./gradlew clean && cd .. && react-native run-android",
     "start": "react-native start",
     "la": "./index-git.sh && cd ./android && ./gradlew clean && cd .. && gnome-terminal -- /bin/bash -c \"wmctrl -c 'Terminal';react-native start $SHELL\" && react-native run-android",
+    "test": "npm run clean && jest",
+    "test-coverage": "npm run clean && jest --coverage",
     "lint": "tslint --project .",
     "lint-fix": "tslint --fix --project .",
     "lint-pkg": "npmPkgJsonLint .",
     "prettier": "prettier --check \"src/**/*.{ts,tsx}\"",
-    "test": "npm run tsc-clean && jest",
-    "test-coverage": "npm run tsc-clean && jest --coverage",
+    "prettier-fix": "prettier --write \"src/**/*.{gts,tsx}\"",
+    "pkg-json-lint": "npmPkgJsonLint .",
+    "package-audit": "npm-audit --critical",
     "tsc": "tsc",
-    "tsc-clean": "tsc --build --clean",
+    "clean": "tsc --build --clean",
+    "build": "tsc --build",
     "add-locale": "lingui add-locale",
     "extract": "lingui extract",
     "extract-clean": "lingui extract --clean",
     "compile": "npm run cleanLanguage && lingui compile",
-    "cleanLanguage": "node ./src/locale/CleanLanguage.ts"
+    "cleanLanguage": "node ./src/locale/CleanLanguage.ts",
+    "prepublishOnly": "npm ci && npm run build",
+    "postpublish": "npm run clean"
   },
   "keywords": [
     "Hedia",
@@ -39,6 +45,7 @@
     "@babel/preset-react": "7.10.1",
     "@babel/preset-typescript": "7.10.1",
     "@babel/runtime": "7.12.5",
+    "@hedia/npm-audit-pipeline": "0.5.0",
     "@hedia/recommendation-calculator": "2.0.11",
     "@react-native-community/slider": "3.0.0",
     "@testing-library/jest-native": "3.1.0",

package/src/RecommendationScreen.d.ts

@@ -0,0 +1,413 @@
+import React from "react";
+import { AppStateStatus } from "react-native";
+import { BloodGlucoseUnit, BloodKetonesUnit, BolusCalculator, Languages, Logbook, UserSettings } from "@hedia/types";
+import { RecommendationError } from "./utils/RecommendationError";
+import { IActivityDisplayProps } from "./types/types";
+/** Represents both a suggestion by HDA and an actual amount of either insulin or carbohydrates. */
+export interface IResult {
+    /** The suggested amount (of insulin in units or carbohydrates in grams) */
+    suggested: number;
+    /** The actual amount (of insulin in units or carbohydrates in grams) */
+    entered: number | null;
+}
+export interface IRecommendationProps {
+    /** The blood glucose measurement unit that the user prefers. */
+    bloodGlucoseUnit: BloodGlucoseUnit;
+    /** The user’s preferred language. */
+    language: Languages;
+    /** The user’s preferred default reminder time in hours when they enter carbohydrates or an activity. */
+    userReminder: number;
+    /** The values needed to make an insulin recommendation calculation. */
+    calculatorParams: BolusCalculator.Types.IRecommendationParams;
+    /** Indicates which method the user uses to inject insulin and thus how insulin amounts should be rounded. */
+    injectionMethod: UserSettings.Enums.InjectionMethod;
+    /** The user’s entered current blood ketones value. Null if no blood ketones value was entered. */
+    currentBKL: number | null;
+    /** The blood ketones measurement unit that the user prefers. Null if the user hasn’t selected a preferred blood ketones unit. */
+    bloodKetoneUnit: BloodKetonesUnit | null;
+    /** The latest logbook entry (if any) from the last 6 hours. */
+    latestLogbookFrom6Hours: Logbook.Types.ILogbookEntry | null;
+    /** The properties of the entered activity that are not used for making the calculation itself, but will be used on the recommendation screen. */
+    activityDisplayProps: IActivityDisplayProps | null;
+    /**
+     * Callback function taking a single boolean argument and returning nothing.
+     * To be called when the user decides on a presented carbohydrate recommendation.
+     * @param carbRecommendationAnswer Whether the user chose to accept (true) or reject (false) the carbohydrate recommendation.
+     */
+    carbRecommendationAnswer(carbRecommendationAnswer: boolean): void;
+    /**
+     * Callback function without arguments or return values.
+     * To be called if the user decides to exit the recommendation screen without transferring any of the data to the logbook.
+     * The unsaved logbook data shall be cleared.
+     */
+    closeCalculationCallback(): void;
+    /**
+     *  Callback function without arguments or return values.
+     * To be called if the user closes the recommendation screen by tapping the cancel button in the header.
+     */
+    exitCallback(): void;
+    /**
+     * Callback function without arguments or return values.
+     * To be called if the user taps “Yes” when asked if they have taken insulin recently.
+     * Should allow the user to enter when they injected insulin and how much.
+     */
+    onRecentInsulinYes(): void;
+    /**
+     * To be called when the “Transfer to Logbook” button is pressed.
+     * @param carbs The suggested and entered amount of carbohydrates.
+     * @param insulin The suggested and entered amount of insulin.
+     * @param reminder The amount of time in hours until the user should get a reminder to measure their BGL again.
+     * @param recommendationDate The date and time when the recommendation calculation was made.
+     * @param mood The mood the user has selected
+     */
+    transferToLogbook(carbs: IResult, insulin: IResult, reminder: number, recommendationDate: Date, mood: Logbook.Enums.MoodEnum | null): void;
+    /**
+     * Callback function taking a single argument of type RecommendationError.
+     * To be called in case a serious issue with the validity of input data is detected.
+     * @param error The detected error.
+     */
+    onError(error: RecommendationError): void;
+    /**
+     * Callback function taking a single argument of type boolean.
+     * To be called to hide the bottom navigation bar while displaying modal dialogs.
+     * @param toggle Showing (true) or hiding (false) the bottom navigation bar on the calculation flow screens.
+     */
+    showBolusBar(toggle: boolean): void;
+    /**
+     * Callback function taking no arguments.
+     * To be called if the user chooses to restart the calculation.
+     */
+    restartCalculation(): void;
+}
+interface IState {
+    /** The time in hours in hours until a reminder notification will be sent to the user. If 0 then no notification will be sent. */
+    remeasureTime: number;
+    /**
+     * If true then the user will see the insulin input field with their recommendation.
+     * Otherwise, the user will be presented with a card that asks them whether they have taken bolus insulin within the last 4 hours
+     */
+    isRecommendationDisplayed: boolean;
+    /** The suggested amount of insulin. */
+    insulinRecommendation: number;
+    /** The fraction by which the recommendation was multiplied to get the reduced amount */
+    activityReduction: number | null;
+    /**  Indicates whether or not the insulin recommendation was limited by the maximum threshold. */
+    wasLimited: boolean;
+    /** The suggested amount of additional carbs. */
+    carbRecommendation: number | null;
+    /** The amount of IOB that was estimated during the recommendation calculation. */
+    activeInsulin: number;
+    /** The mood that is currently selected or null if no mood is selected. */
+    selectedMood: Logbook.Enums.MoodEnum | null;
+    /** The amount of carbs that are being shown in the additional carbs input field. */
+    enteredCarbs: number | null;
+    /** The current insulin value in the insulin recommendation/input field. */
+    enteredInsulin: number | null;
+    /** Indicates whether or not the modal for displaying warnings and other special messages should be visible. */
+    recommendationModal: boolean;
+    /**
+     * Keeps track of whether or not the exit modal should be displayed.
+     * The exit modal prompts the user to consider saving the calculation to a logbook entry before closing the recommendation screen.
+     */
+    showExitModal: boolean;
+    /** Keeps track of whether or not a message about insulin limitation should be displayed. */
+    showLimitationMessage: boolean;
+    /** Keeps track of whether or not a message about the recommendation being too old should be displayed. */
+    showTimeoutModal: boolean;
+}
+/**
+ * The RecommendationScreen is the React component that passes relevant inputs to the recommendation calculation module and presents
+ * the resulting recommendation along with related messages or warnings to the user.
+ * The RecommendationScreen component accepts properties with the user’s settings/preferences and other inputs needed for calculating a recommendation.
+ * @noInheritDoc
+ */
+export default class RecommendationScreen extends React.Component<IRecommendationProps, IState> {
+    /** Reference to the timer that prompts the user to make a new calculation after 15 minutes. */
+    private readonly timer;
+    /**
+     * The carbohydrate recommendation for the user.
+     * This value is saved in a member variable because we want to store it unmodified if the logbook entry
+     * gets saved regardless of what other changes were made on the recommendation screen.
+     */
+    private readonly suggestedCarbs;
+    /**
+     * A guard against displaying wrong or dangerous information to the user.
+     * If an error has occurred, this variable will be set to true and an empty placeholder will be rendered instead of the normal recommendation screen.
+     */
+    private readonly hasError;
+    /** The timestamp when the current recommendation was made. For determining if the recommendation is too old and should be hidden from the user. */
+    private readonly recommendationDate;
+    /**
+     * A reference to the screens scrollview allowing us to programmatically scroll the screen in the handleNoRecentInsulin() method.
+     * The member is initiated without a value but will be set as soon as the component is being rendered.
+     */
+    private scrollViewRef?;
+    /**
+     * A reference to the eventSubscription that'll be returned by AppState.addEventListener().
+     * It'll allow us to later remove the subscription.
+     */
+    private appStateSubscription?;
+    /**
+     * A reference to the eventSubscription that'll be returned by BackHandler.addEventListener().
+     * It'll allow us to later remove the subscription.
+     */
+    private backHandlerSubscription?;
+    /**
+     * Steps:
+     * 1. Call the super() method with the props.
+     * 2. Execute the following steps and if an exception is thrown, catch it, set the hasError member variable to true and call the onError callback prop with the caught exception as argument:
+     * 	- Call the validateParams() method with the props as argument
+     * 	- Set the recommendationDate member to the current date and time
+     * 	- Set the language by using the language prop as argument for calling changeLanguage()
+     * 	- Unpack recentBoluses from the calculatorParams prop.
+     * 	- Use the calculatorParams prop as argument for calling calculateRecommendation() and unpack all of the resulting values.
+     * 	- Copy the carbRecommendation to the suggestedCarbs member variable.
+     * 	- Set the following state variables:
+     * 		- Set remeasureTime to the return value from calling the getBGLevelRemeasurementReminder() method.
+     * 		- Set isRecommendationDisplayed to be false if the length of recentBoluses is 0 or false otherwise.
+     * 		- Set insulinRecommendation to be the bolus insulin recommendation rounded using roundValue().
+     * 		- Set wasLimited to the wasLimited return value from calling calculateRecommendation() above.
+     * 		- Set activityReduction to the reduction returned from the calculation result.
+     * 		- Set carbRecommendation to the recommendation returned from the calculation result.
+     * 		- Set activeInsulin to the estimation returned from the calculation result.
+     * 		- Set enteredCarbs, enteredInsulin, selectedMood to null.
+     * 		- Set recommendationModal to be true if wasLimited is true or if carbRecommendation after being rounded is truthy or if the return value from calling the getBGLevelAttentionMessage() method is truthy.
+     * 		- Set showExitModal, showLimitationMessage, showTimeoutModal to be false.
+     * 3. Start a 15 minute timer assigned to the timer member variable using the setTimeout() function. When the timer expires, call the showTimeoutModal() method.
+     * @param props The data required to initialise the Recommendation Screen
+     */
+    constructor(props: IRecommendationProps);
+    /**
+     * Called immediately after a component is mounted. Setting state here will trigger re-rendering.
+     *
+     * Steps:
+     * 1. If there is no error, create a listener to call the handleAppStateChange() method when the app state changes.
+     */
+    componentDidMount(): void;
+    /**
+     * Called immediately before a component is destroyed.
+     * Perform any necessary cleanup in this method, such as cancelled network requests, or cleaning up any DOM elements created in componentDidMount.
+     *
+     * Clear the 15 minute timer that was set in the constructor during initialisation so it doesn't keep running and gets triggered after the recommendation screen was closed.
+     *
+     * Steps:
+     * 1. Call clearTimeout on the timer member variable.
+     * 2. Remove the listener for app state changes that was set by the componentDidMount() method.
+     */
+    componentWillUnmount(): void;
+    /**
+     * Steps:
+     * 1. Evaluate a boolean called isOlderThan15Minutes to indicate whether the recommendationDate member variable represents a time more than 15 minutes ago.
+     * 2. If nextAppState is ‘active’ and isOlderThan15Minutes is true then call the showTimeoutModal() method.
+     * @param nextAppState The new state of the app.
+     */
+    handleAppStateChange: (nextAppState: AppStateStatus) => void;
+    /**
+     * Steps:
+     * 1. Set the showTimeoutModal state variable to be true. Use a callback function to call the showBolusBar prop callback function with false as argument when the state has been updated.
+     * */
+    showTimeoutModal: () => void;
+    /**
+     * Make a new insulin calculation and set the result to be displayed to the user.
+     *
+     * Steps:
+     * 1. Use calculatorParams as an argument for calling calculateRecommendation(). Unpack bolus, wasLimited, and activityReduction from the result.
+     * 2. Set the following state variables:
+     * 	- Set insulinRecommendation to the bolus rounded using the roundValue() function.
+     * 	- Set enteredInsulin to be undefined.
+     * 	- Set wasLimited to be the value returned from the insulin calculator.
+     * 	- Set activityReduction to be the value returned from the insulin calculator.
+     * 	- Set showLimitationMessage to be the wasLimited value returned from the insulin calculator.
+     * @param calculatorParams The input values for the bolus calculator itself.
+     */
+    recalculateInsulin: (calculatorParams: BolusCalculator.Types.IRecommendationParams) => void;
+    /**
+     * Handle presses on the exit button in the header bar.
+     *
+     * Steps:
+     * 1. If the insulin recommendation is being displayed (the isRecommendationDisplayed state variable is true):
+     *  	- Set the showExitModal state variable to true. When the state has been updated, call the showBolusBar prop callback function with the inverse value of the showExitModal state variable as argument.
+     * 2. Else:
+     *  	- Call the exitCallback prop callback function.
+     */
+    onExit: () => void;
+    /**
+     * Callback to be executed by the back handler listener.
+     *
+     * Steps:
+     * 1. Call the onExist method
+     * 2. Return true so that the default behaviour is overwritten.
+     */
+    onBackHandlerPress: () => boolean;
+    /**
+     * Hide the modal that shows attention messages.
+     *
+     * Steps:
+     * 1. Set the recommendationModal state variable to false.
+     */
+    hideAttentionModal: () => void;
+    /**
+     * Hide the modal that shows attention messages.
+     *
+     * Steps:
+     * 1. Set the showLimitationMessage state variable to false.
+     */
+    hideLimitationMessage: () => void;
+    /**
+     * Hide the exit modal. To be used when the user closes the modal directly or in some way exits the recommendation screen.
+     *
+     * Steps:
+     * 1. Set the showExitModal state variable to false.
+     *    When the state has been updated, call the showBolusBar prop callback function with the inverse value of the showExitModal state variable as argument.
+     */
+    hideExitModal: () => void;
+    /**
+     * Hide the modal that warns the user that their recommendation is old.
+     *
+     * Steps:
+     * 1. Set the showTimeoutModal state variable to false.
+     * 	  When the state has been updated, call the showBolusBar prop callback function with the inverse value of the showTimeoutModal state variable as argument.
+     */
+    hideTimeoutModal: () => void;
+    /**
+     * Used as a callback function for the Remeasure component to update the state when the remeasure time slider’s value changes.
+     *
+     * Steps:
+     * 1. Set the remeasureTime state variable to the value of the remeasureTime argument.
+     * @param remeasureTime The number of hours for which to wait before reminding the user to measure their BGL again. 0 indicates that the user should not be reminded.
+     */
+    updateRemeasureTime: (remeasureTime: number) => void;
+    /**
+     * Handle what happens if the user taps “No” to the question about injecting insulin within the last 4 hours.
+     * The card that prompts the user to answer if they have injected insulin within the last 4 hours shall be hidden and
+     * the screen shall automatically be scrolled to the bottom so the user can see the now visible “Transfer to logbook” button.
+     *
+     * Steps:
+     * 1. Set the isRecommendationDisplayed state variable to be true.
+     * 2. As a callback to the setState() method, define a new anonymous function that calls  the scrollToEnd() method
+     * 	  of the scrollView member, with the animated argument set to true.
+     *    This ensures that the scroll event happens after all other events that get queued to happen at the same time,
+     *    so all relevant elements are visible on the screen and the scroll happens reliably.
+     */
+    handleNoRecentInsulin: () => void;
+    /**
+     * Handle what happens when the user changes the content of the additional carbohydrates input field.
+     *
+     * Steps:
+     * 1. Set the enteredCarbs state variable to the value of the enteredCarbs argument.
+     * 2. As a callback to the setState() method, define a new anonymous function that calls the recalculateInsulin() function using
+     *    a copy of the calculatorParams prop where the carbohydrates property has been overwritten to be
+     *    the sum of the carbohydrates property of the calculatorParams prop and the enteredCarbs argument.
+     * @param enteredCarbs The amount of carbohydrates in grams that has been entered in the additional carbohydrates input field.
+     */
+    updateCarbRecommendation: (enteredCarbs: number) => void;
+    /**
+     * Handle what happens when the cross button by the additional carbohydrates button is tapped.
+     *
+     * Steps:
+     * 1. Set both the enteredCarbs and the carbRecommendation state variables to null.
+     * 2. As a callback to the setState() method, define a new anonymous function that calls the recalculateInsulin() function using a copy of the calculatorParams prop.
+     */
+    removeCarbRecommendation: () => void;
+    /**
+     * Handle what happens when the user is recommended to eat additional carbohydrates but taps the decline button.
+     *
+     * Steps:
+     * 1. Call the hideAttentionModal() method.
+     * 2. Call the removeCarbRecommendation() method.
+     * 3. Call the carbRecommendationAnswer() prop callback function with false as argument.
+     */
+    declineCarbRecommendation: () => void;
+    /**
+     * Handle what happens when the user is recommended to eat additional carbohydrates and they tap the accept button.
+     *
+     * Steps:
+     * 1. Call the hideAttentionModal() method.
+     * 2. Call the carbRecommendationAnswer() prop callback function with true as argument.
+     */
+    acceptCarbRecommendation: () => void;
+    /**
+     * Handles what happens when the user hits the “close calculation”-button on the exit modal.
+     *
+     * Steps:
+     * 1. If the showExitModal state variable is true then call the hideExitModal() method. Otherwise, call the hideTimeoutModal() method
+     * 2. Call the closeCalculationCallback prop callback function.
+     */
+    closeCalculation: () => void;
+    /**
+     * Close the current recommendation and start a new bolus calculation.
+     *
+     * Steps:
+     * 1. Call the hideTimeoutModal() method.
+     * 2. Call the restartCalculation prop callback function.
+     */
+    restartCalculation: () => void;
+    /**
+     * Used as a callback function for the Emotion component to update the state when a mood icon is tapped.
+     *
+     * Steps:
+     * 1. Set the selectedMood state variable to the value of the selectedMood argument.
+     * @param selectedMood he mood that should be selected going forward or null if no mood should be selected.
+     */
+    handleMoodSelected: (selectedMood: IState["selectedMood"]) => void;
+    /**
+     * Handle what happens when the user changes the content of the insulin input field.
+     *
+     * Steps:
+     * 1. Set the enteredInsulin state variable to the value of the enteredInsulin argument.
+     * @param enteredInsulin The amount of insulin (in units) that has been entered in the insulin input field.
+     */
+    updateInsulinRecommendation: (enteredInsulin: number) => void;
+    /**
+     * Handle what happens when the “Transfer to Logbook” button is pressed.
+     * Namely, the entered data should be saved in a logbook entry and the recommendation screen should be closed.
+     *
+     * Steps:
+     * 1. Unpack the enteredCarbs, enteredInsulin, insulinRecommendation, remeasureTime, and showExitModal state variables
+     * 2. Create an IResult object called carbs consisting of suggestedCarbs and enteredCarbs.
+     * 3. Create an IResult object called Insulin consisting of insulinRecommendation and enteredInsulin.
+     * 4. If showExitModal is true then call the hideExitModal() method. otherwise call the hideTimeoutModal() method.
+     * 5. Call the transferToLogbook prop callback function with the following arguments:
+     * 	- Set the carbs argument to the carbs IResult object.
+     * 	- Set the insulin argument to the insulin IResult object.
+     * 	- Set the reminder argument to the remeasureTime state variable.
+     * 	- Set the recommendationDate argument to the recommendationDate member variable.
+     */
+    handleTransfer: () => void;
+    /**
+     * Get the attention message that should be displayed for the user to draw their attention to noteworthy circumstances regarding their current blood glucose level.
+     *
+     * Steps:
+     * 1. Unpack calculatorParams and latestLogbookFrom6Hours from the props.
+     * 2. Unpack currentBGL and activity from calculatorparams.
+     * 3. Get bgLevel, the categorisation of the blood glucose level, by calling the getBGLevel() function with the currentBGL and latestLogbookFrom6Hours as arguments.
+     * 4. Return the attention message that is returned when calling getAttentionMessage() using bgLevel and activity as arguments.
+     * @returns A string describing what the user needs to be aware of regarding their current blood glucose level.
+     * If there is nothing noteworthy, null will be returned instead.
+     */
+    getBGLevelAttentionMessage: () => string | null;
+    /**
+     * Get the initial value for the remeasurement reminder time slider depending on the user’s entered information.
+     *
+     * Steps:
+     * 1. Unpack calculatorParams, userReminder, and latestLogbookFrom6Hours from the props.
+     * 2. Unpack currentBGL, activity,  and carbohydrates from calculatorParams.
+     * 3. Get bgLevel, the categorisation of the blood glucose level, by calling the getBGLevel() function with the currentBGL and latestLogbookFrom6Hours as arguments.
+     * 4. Return the attention message that is returned when calling getReminder() using bgLevel, carbohydrates, userReminder, and activity as arguments.
+     * @returns The time interval in hours that should be used as the initial value for the remeasurement reminder time slider.
+     */
+    getBGLevelRemeasurementReminder: () => number;
+    /**
+     * Get the attention message that should be displayed to the user to let them know that the insulin recommendation that
+     * is being displayed to them was limited by the maximum insulin threshold.
+     *
+     * Steps:
+     * 1. Unpack the wasLimited and activityReduction state variables.
+     * 2. Return the result from calling getLimitationMessage() with wasLimited and activityReduction as arguments.
+     * @returns A message to inform the user how the insulin recommendation was limited. If there is no limitation attention message, null will be returned instead.
+     */
+    getLimitationAttentionMessage: () => string | null;
+    /** Render a JSX element for displaying the insulin recommendation screen. */
+    render(): JSX.Element;
+}
+export {};