@hedia/recommendation-screen 2.1.15 → 2.1.17-alpha

package/coverage/lcov-report/src/components/RecommendedInsulin.tsx.html

@@ -25,7 +25,7 @@
             <div class='fl pad1y space-right2'>
                 <span class="strong">100% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>28/28</span>
+                <span class='fraction'>27/27</span>
             </div>
         
             
@@ -39,14 +39,14 @@
             <div class='fl pad1y space-right2'>
                 <span class="strong">100% </span>
                 <span class="quiet">Functions</span>
-                <span class='fraction'>7/7</span>
+                <span class='fraction'>6/6</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
                 <span class="strong">100% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>28/28</span>
+                <span class='fraction'>27/27</span>
             </div>
         
             
@@ -234,7 +234,63 @@
 <a name='L175'></a><a href='#L175'>175</a>
 <a name='L176'></a><a href='#L176'>176</a>
 <a name='L177'></a><a href='#L177'>177</a>
-<a name='L178'></a><a href='#L178'>178</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
+<a name='L178'></a><a href='#L178'>178</a>
+<a name='L179'></a><a href='#L179'>179</a>
+<a name='L180'></a><a href='#L180'>180</a>
+<a name='L181'></a><a href='#L181'>181</a>
+<a name='L182'></a><a href='#L182'>182</a>
+<a name='L183'></a><a href='#L183'>183</a>
+<a name='L184'></a><a href='#L184'>184</a>
+<a name='L185'></a><a href='#L185'>185</a>
+<a name='L186'></a><a href='#L186'>186</a>
+<a name='L187'></a><a href='#L187'>187</a>
+<a name='L188'></a><a href='#L188'>188</a>
+<a name='L189'></a><a href='#L189'>189</a>
+<a name='L190'></a><a href='#L190'>190</a>
+<a name='L191'></a><a href='#L191'>191</a>
+<a name='L192'></a><a href='#L192'>192</a>
+<a name='L193'></a><a href='#L193'>193</a>
+<a name='L194'></a><a href='#L194'>194</a>
+<a name='L195'></a><a href='#L195'>195</a>
+<a name='L196'></a><a href='#L196'>196</a>
+<a name='L197'></a><a href='#L197'>197</a>
+<a name='L198'></a><a href='#L198'>198</a>
+<a name='L199'></a><a href='#L199'>199</a>
+<a name='L200'></a><a href='#L200'>200</a>
+<a name='L201'></a><a href='#L201'>201</a>
+<a name='L202'></a><a href='#L202'>202</a>
+<a name='L203'></a><a href='#L203'>203</a>
+<a name='L204'></a><a href='#L204'>204</a>
+<a name='L205'></a><a href='#L205'>205</a>
+<a name='L206'></a><a href='#L206'>206</a>
+<a name='L207'></a><a href='#L207'>207</a>
+<a name='L208'></a><a href='#L208'>208</a>
+<a name='L209'></a><a href='#L209'>209</a>
+<a name='L210'></a><a href='#L210'>210</a>
+<a name='L211'></a><a href='#L211'>211</a>
+<a name='L212'></a><a href='#L212'>212</a>
+<a name='L213'></a><a href='#L213'>213</a>
+<a name='L214'></a><a href='#L214'>214</a>
+<a name='L215'></a><a href='#L215'>215</a>
+<a name='L216'></a><a href='#L216'>216</a>
+<a name='L217'></a><a href='#L217'>217</a>
+<a name='L218'></a><a href='#L218'>218</a>
+<a name='L219'></a><a href='#L219'>219</a>
+<a name='L220'></a><a href='#L220'>220</a>
+<a name='L221'></a><a href='#L221'>221</a>
+<a name='L222'></a><a href='#L222'>222</a>
+<a name='L223'></a><a href='#L223'>223</a>
+<a name='L224'></a><a href='#L224'>224</a>
+<a name='L225'></a><a href='#L225'>225</a>
+<a name='L226'></a><a href='#L226'>226</a>
+<a name='L227'></a><a href='#L227'>227</a>
+<a name='L228'></a><a href='#L228'>228</a>
+<a name='L229'></a><a href='#L229'>229</a>
+<a name='L230'></a><a href='#L230'>230</a>
+<a name='L231'></a><a href='#L231'>231</a>
+<a name='L232'></a><a href='#L232'>232</a>
+<a name='L233'></a><a href='#L233'>233</a>
+<a name='L234'></a><a href='#L234'>234</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -264,13 +320,21 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">2x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">81x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">2x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">81x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -278,16 +342,47 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">70x</span>
 <span class="cline-any cline-yes">70x</span>
 <span class="cline-any cline-yes">2x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">81x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">81x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">18x</span>
@@ -297,6 +392,19 @@
 <span class="cline-any cline-yes">18x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">81x</span>
 <span class="cline-any cline-yes">29x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -316,6 +424,10 @@
 <span class="cline-any cline-yes">16x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">81x</span>
 <span class="cline-any cline-yes">151x</span>
 <span class="cline-any cline-yes">151x</span>
@@ -426,34 +538,54 @@ import InvisibleNumberInput from "./InvisibleNumberInput";
 &nbsp;
 const { RecommendedInsulinTestIds } = Testing.Id;
 &nbsp;
-interface IProps {
-	// Values
+export interface IProps {
+	/** The amount of insulin in units to display to the user as a recommendation. */
 	insulinRecommendation: number;
+	/** The amount of insulin introduced by the user. */
 	enteredInsulin: number | null;
+	/**
+	 * The factor by which the recommendation was multiplied to get the reduced insulin amount.
+	 * Used by the RecommendedInsulin component to check that the user’s input doesn’t exceed the maximum allowed.
+	 * If no activity has been entered, this prop should be null.
+	 * */
 	activityReduction: number | null;
+	/** Used to determine how the insulin amount should be rounded. */
 	injectionMethod: UserSettings.Enums.InjectionMethod;
 &nbsp;
-	// Callbacks
+	/**
+	 * Callback function taking a number as argument and giving no return value.
+	 * To be called with the new value every time the content of the insulin input field gets changed.
+	 */
 	updateRecommendedInsulin(value: number): void;
 }
 &nbsp;
-interface IState {
+export interface IState {
+	/** The entered amount of insulin as a string. */
 	partialInput?: string;
 }
 &nbsp;
 const SAFETY_INSULIN_LIMIT = BolusCalculator.Constants.SAFETY_INSULIN_LIMIT;
 &nbsp;
+/** Input field for displaying the entered amount of insulin (which defaults to HDA’s recommendation) and allowing the user to edit it. */
 export default class RecommendedInsulin extends React.Component&lt;IProps, IState&gt; {
+	/** Initialise the state partialInput variable with undefined */
+	public state: IState = {
+		partialInput: undefined,
+	};
+	/**
+	 *  Function taking no arguments and returning no value.
+	 *  Will be bound to the function that activates input for InvisibleNumberInput when that component has been mounted.
+	 */
 	public callbackInput?: () =&gt; void;
 &nbsp;
-	constructor(props: IProps) {
-		super(props);
-&nbsp;
-		this.state = {
-			partialInput: undefined,
-		};
-	}
-&nbsp;
+	/**
+	 * Called immediately after updating occurs. Not called for the initial render.
+	 * The snapshot is only present if getSnapshotBeforeUpdate is present and returns non-null.
+	 *
+	 * Steps:
+	 * 1. If the value of the enteredInsulin prop was changed, set the partialInput state variable to the new value.
+	 * @param prevProps The previous component props
+	 */
 	public componentDidUpdate(prevProps: IProps): void {
 		const { enteredInsulin } = this.props;
 		if (prevProps.enteredInsulin !== enteredInsulin) {
@@ -461,10 +593,29 @@ export default class RecommendedInsulin extends React.Component&lt;IProps, IStat
 		}
 	}
 &nbsp;
+	/**
+	 * Handle what should happen when the InsulinRecommendation component has been pressed.
+	 * Uses the InvisibleNumberInput child component to enable the user to input the amount of insulin that hey are taking.
+	 *
+	 * Steps:
+	 * 1. Call the callbackInput() member method.
+	 */
 	public handleOnPress = (): void =&gt; {
 		this.callbackInput?.();
 	};
 &nbsp;
+	/**
+	 * Passed to the InvisibleNumberInput child component as a callback function to be called every time the content of the input field changes.
+	 *
+	 * Steps:
+	 * 1. Assign a new local variable, replacedZero, with the value of the insulin argument string
+	 * except for the first character if insulin is longer than 1 character and starts with a '0' but doesn’t start with ‘0.’.
+	 * Otherwise set it to insulin. This would be better handled by converting it to a number: replacedZero = Number(insulin);
+	 * 2. Save replacedZero to the partialInput state variable.
+	 * 3. Return replacedZero
+	 * @param insulin  The contents of the input field.
+	 * @returns The partially cleaned input.
+	 */
 	public updatePartially = (insulin: string): string =&gt; {
 		const replacedZero =
 			insulin.length &gt; 1 &amp;&amp; insulin.startsWith(`0`) &amp;&amp; !insulin.startsWith(`0.`) ? insulin.substring(1) : insulin;
@@ -474,6 +625,19 @@ export default class RecommendedInsulin extends React.Component&lt;IProps, IStat
 		return replacedZero;
 	};
 &nbsp;
+	/**
+	 * Handle what happens when input in the InvisibleNumberInput child component is completed.
+	 *
+	 * Steps:
+	 * 1. Get the rounded insulin amount using the value argument and the injectionMethod prop as arguments for the Utils.roundValue() function.
+	 * 2. Get the adjusted safety insulin limit (due to activity) by multiplying the activity reduction factor (which is 1 minus the activityReduction prop) with the SAFETY_INSULIN_LIMIT constant.
+	 * 3. If the rounded value exceeds the adjusted safety threshold:
+	 * 	- Call the updatePartially() method with the adjusted safety threshold to set the insulin amount to the capped value.
+	 * 	- Return an Alert with a message about the insulin limit.
+	 * 4. Call the updatePartially() method with the rounded value to set the entered insulin value.
+	 * 5. Call the updateRecommendedInsulin callback function prop with rounded as the argument to report back the updated insulin amount to the parent RecommendationScreen component.
+	 * @param value The numerical value of the input field at completion.
+	 */
 	public handleUpdatedInsulin = (value: number): void =&gt; {
 		const rounded = Utils.roundValue(value, this.props.injectionMethod);
 &nbsp;
@@ -493,6 +657,10 @@ export default class RecommendedInsulin extends React.Component&lt;IProps, IStat
 		this.props.updateRecommendedInsulin(rounded);
 	};
 &nbsp;
+	/**
+	 * Render a JSX element to display the insulin input field with the current insulin amount value
+	 * and using an InvisibleNumberInput component to enable input when the insulin amount is tapped.
+	 */
 	public render = (): JSX.Element =&gt; {
 		const paddingBottom = Platform.OS === `ios` ? `3%` : `1%`;
 		const shownInsulin = this.state.partialInput ?? this.props.insulinRecommendation ?? `0`;
@@ -595,7 +763,7 @@ const recommendedInsulinStyles = StyleSheet.create({
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank">istanbul</a>
-                at Fri Jul 09 2021 12:31:53 GMT+0000 (Coordinated Universal Time)
+                at Mon Aug 16 2021 10:59:26 GMT+0000 (Coordinated Universal Time)
             </div>
         </div>
         <script src="../../prettify.js"></script>

package/coverage/lcov-report/src/components/Remeasure.tsx.html

@@ -177,7 +177,65 @@
 <a name='L118'></a><a href='#L118'>118</a>
 <a name='L119'></a><a href='#L119'>119</a>
 <a name='L120'></a><a href='#L120'>120</a>
-<a name='L121'></a><a href='#L121'>121</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
+<a name='L121'></a><a href='#L121'>121</a>
+<a name='L122'></a><a href='#L122'>122</a>
+<a name='L123'></a><a href='#L123'>123</a>
+<a name='L124'></a><a href='#L124'>124</a>
+<a name='L125'></a><a href='#L125'>125</a>
+<a name='L126'></a><a href='#L126'>126</a>
+<a name='L127'></a><a href='#L127'>127</a>
+<a name='L128'></a><a href='#L128'>128</a>
+<a name='L129'></a><a href='#L129'>129</a>
+<a name='L130'></a><a href='#L130'>130</a>
+<a name='L131'></a><a href='#L131'>131</a>
+<a name='L132'></a><a href='#L132'>132</a>
+<a name='L133'></a><a href='#L133'>133</a>
+<a name='L134'></a><a href='#L134'>134</a>
+<a name='L135'></a><a href='#L135'>135</a>
+<a name='L136'></a><a href='#L136'>136</a>
+<a name='L137'></a><a href='#L137'>137</a>
+<a name='L138'></a><a href='#L138'>138</a>
+<a name='L139'></a><a href='#L139'>139</a>
+<a name='L140'></a><a href='#L140'>140</a>
+<a name='L141'></a><a href='#L141'>141</a>
+<a name='L142'></a><a href='#L142'>142</a>
+<a name='L143'></a><a href='#L143'>143</a>
+<a name='L144'></a><a href='#L144'>144</a>
+<a name='L145'></a><a href='#L145'>145</a>
+<a name='L146'></a><a href='#L146'>146</a>
+<a name='L147'></a><a href='#L147'>147</a>
+<a name='L148'></a><a href='#L148'>148</a>
+<a name='L149'></a><a href='#L149'>149</a>
+<a name='L150'></a><a href='#L150'>150</a>
+<a name='L151'></a><a href='#L151'>151</a>
+<a name='L152'></a><a href='#L152'>152</a>
+<a name='L153'></a><a href='#L153'>153</a>
+<a name='L154'></a><a href='#L154'>154</a>
+<a name='L155'></a><a href='#L155'>155</a>
+<a name='L156'></a><a href='#L156'>156</a>
+<a name='L157'></a><a href='#L157'>157</a>
+<a name='L158'></a><a href='#L158'>158</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -200,16 +258,32 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">78x</span>
 <span class="cline-any cline-yes">17x</span>
 <span class="cline-any cline-yes">17x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">78x</span>
 <span class="cline-any cline-yes">178x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">161x</span>
 <span class="cline-any cline-yes">161x</span>
 <span class="cline-any cline-yes">161x</span>
@@ -306,29 +380,66 @@ import { Testing } from "../types/enum";
 import { BORDER_COLOUR_GREY, BORDER_COLOUR_TEAL } from "../utils/Constants";
 import { infoStyles } from "./InfoBars";
 &nbsp;
-interface IProps {
+export interface IProps {
+	/** The initial time (in hours) after which the user should be reminded to measure their BGL. */
 	remeasureTime: number;
+	/**
+	 * Callback function taking a single number (the new remeasurement time) as argument
+	 *  Function to be called every time the slider component is changed to a new value.
+	 */
 	onSliderChange(value: number): void;
 }
 &nbsp;
+/**
+ * The Remeasure component has a slider child component that the user can drag to change
+ * when they will get a reminder notification about measuring their BGL again.
+ */
 export default class Remeasure extends React.Component&lt;IProps&gt; {
+	/** For holding a reference to the slider component so its initial value can be set (only one time) when the Remeasure component has been mounted. */
 	private slider?: Slider;
 &nbsp;
+	/**
+	 * Called immediately after a component is mounted. Setting state here will trigger re-rendering.
+	 *
+	 * If the value of a slider component in React Native is set to track an outside state,
+	 * the slider indicator may jump back and forth while updates to the value are propagated through the affected objects and components.
+	 * Since we don’t need to change the value of the slider from the outside after initialising it to the default value,
+	 * we simply set the default value (using setNativeProp) upon initialisation instead of using the slider’s normal value prop to set it.
+	 *
+	 * Steps:
+	 * 1. Call the setNativeProps() method on the slider to set its value to the remeasureTime prop.
+	 */
 	public componentDidMount(): void {
 		this.slider?.setNativeProps({
 			value: this.props.remeasureTime,
 		});
 	}
 &nbsp;
+	/**
+	 * Steps:
+	 * 1. Use limitTime() to limit/clamp the value of remeasureTime in the range 0 to 6.
+	 * 2. Call the onSliderChange prop callback function with the limited value as argument.
+	 * @param remeasureTime The value of the remeasurement slider.
+	 */
 	public handleSliderChange = (remeasureTime: number): void =&gt; {
 		const limited = this.limitTime(remeasureTime);
 		this.props.onSliderChange(limited);
 	};
 &nbsp;
+	/**
+	 * Steps:
+	 * 1.Use Math.min() and Math.max() to clamp remeasureTime in the range 0 to 6 and return the result.
+	 * @param remeasureTime The value of the remeasurement slider.
+	 * @returns The limited remeasurement time in hours
+	 */
 	public limitTime = (remeasureTime: number): number =&gt; {
 		return Math.min(Math.max(0, remeasureTime), 6);
 	};
 &nbsp;
+	/**
+	 * Compose a JSX element for displaying the currently selected remeasurement time along
+	 * with a horizontal slider for changing it in increments of 0.5 hours in the range 0 to 6.
+	 */
 	public render(): JSX.Element {
 		const measure = this.props.remeasureTime &gt; 0;
 		const limited = this.limitTime(this.props.remeasureTime);
@@ -424,7 +535,7 @@ const variantStyles = StyleSheet.create({
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank">istanbul</a>
-                at Fri Jul 09 2021 12:31:53 GMT+0000 (Coordinated Universal Time)
+                at Mon Aug 16 2021 10:59:26 GMT+0000 (Coordinated Universal Time)
             </div>
         </div>
         <script src="../../prettify.js"></script>

package/coverage/lcov-report/src/components/TransferToLogbook.tsx.html

@@ -157,7 +157,36 @@
 <a name='L98'></a><a href='#L98'>98</a>
 <a name='L99'></a><a href='#L99'>99</a>
 <a name='L100'></a><a href='#L100'>100</a>
-<a name='L101'></a><a href='#L101'>101</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
+<a name='L101'></a><a href='#L101'>101</a>
+<a name='L102'></a><a href='#L102'>102</a>
+<a name='L103'></a><a href='#L103'>103</a>
+<a name='L104'></a><a href='#L104'>104</a>
+<a name='L105'></a><a href='#L105'>105</a>
+<a name='L106'></a><a href='#L106'>106</a>
+<a name='L107'></a><a href='#L107'>107</a>
+<a name='L108'></a><a href='#L108'>108</a>
+<a name='L109'></a><a href='#L109'>109</a>
+<a name='L110'></a><a href='#L110'>110</a>
+<a name='L111'></a><a href='#L111'>111</a>
+<a name='L112'></a><a href='#L112'>112</a>
+<a name='L113'></a><a href='#L113'>113</a>
+<a name='L114'></a><a href='#L114'>114</a>
+<a name='L115'></a><a href='#L115'>115</a>
+<a name='L116'></a><a href='#L116'>116</a>
+<a name='L117'></a><a href='#L117'>117</a>
+<a name='L118'></a><a href='#L118'>118</a>
+<a name='L119'></a><a href='#L119'>119</a>
+<a name='L120'></a><a href='#L120'>120</a>
+<a name='L121'></a><a href='#L121'>121</a>
+<a name='L122'></a><a href='#L122'>122</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -179,6 +208,13 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">65x</span>
 <span class="cline-any cline-yes">6x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -187,6 +223,12 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">135x</span>
 <span class="cline-any cline-yes">45x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -265,20 +307,35 @@ import { i18n } from "../locale/i18nUtils";
 import { Testing } from "../types/enum";
 import Icon from "./Icon";
 &nbsp;
-interface IProps {
+export interface IProps {
+	/** Whether or not the transfer button shall be visible on the screen. */
 	visible: boolean;
+	/** To be called when the button is pressed. */
 	transfer(): void;
 }
 &nbsp;
-interface IState {
+export interface IState {
+	/**  Keeps track of whether the button was already pressed and thus should be displayed in the inactive visually distinct pressed state. */
 	pressed: boolean;
 }
 &nbsp;
+/**
+ * Render a button for transferring the recommendation to a logbook entry.
+ * The button has a visually distinct pressed state to signal to the user that the button was actually activated before returning to the dashboard screen.
+ */
 export default class TransferToLogbook extends React.Component&lt;IProps, IState&gt; {
+	/** Initialise the state pressed variable with false */
 	public state: IState = {
 		pressed: false,
 	};
 &nbsp;
+	/**
+	 * Handle what happens when the button is pressed.
+	 *
+	 * Steps:
+	 * 1. Toggle the pressed state to the opposite of its current value.
+	 * 2. Call the transfer prop callback function.
+	 */
 	public handlePress = (): void =&gt; {
 		this.setState({
 			pressed: !this.state.pressed,
@@ -286,6 +343,12 @@ export default class TransferToLogbook extends React.Component&lt;IProps, IState
 		this.props.transfer();
 	};
 &nbsp;
+	/**
+	 * Steps:
+	 * 1. If the visible prop is false, display an empty space to keep the correct margins in the screen.
+	 * 2. Return a JSX element to display a touchable button (that is disabled when the pressed state is true)
+	 * @returns JSX element for displaying the transfer button
+	 */
 	public render(): JSX.Element {
 		if (!this.props.visible) {
 			return &lt;View style={addToLogbookStyles.marginContainer} /&gt;;
@@ -364,7 +427,7 @@ const addToLogbookStyles = StyleSheet.create({
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank">istanbul</a>
-                at Fri Jul 09 2021 12:31:53 GMT+0000 (Coordinated Universal Time)
+                at Mon Aug 16 2021 10:59:26 GMT+0000 (Coordinated Universal Time)
             </div>
         </div>
         <script src="../../prettify.js"></script>