feat(protocol-designer): cap flow rate at hardware maximum (#18859)

This PR ensures that the interpolated liquid class flow rate for
aspirate, dispense, and blowout does not exceed the range prescribed by
the pipette liquid definition's plunger curves. To achieve this, we
reuse the max flow rate logic in `getMaxUiFlowRate` in the liquid class
form change handler utils, to make sure the populated flow rates from
the liquid class are physically possible.

The code is a bit redundant in the various form change utils, but I am
erring on the side of caution vs. DRY given the upcoming release. I can
refactor the utilities in a followup post-release.

Closes RQA-4151

Author: ncdiehl11

protocol-designer/src/pages/Designer/ProtocolSteps/StepForm/PipetteFields/utils.ts

@@ -207,30 +207,31 @@ const _getPipetteAccuracyUlPerMm = (args: {
   return lastEntry[1] * targetVolume + lastEntry[2]
 }
 
-export const getMaxUiFlowRate = (args: {
-  targetVolume: number
+interface BaseGetMaxUiFlowRateArgs {
   channels: PipetteChannels
   robotType: RobotType
-  tipLiquidSpecs: SupportedTip
-  flowRateType: FlowRateType
-  correctionVolume: number
   shaftULperMM: number
-}): number => {
-  const {
-    targetVolume,
-    channels,
-    robotType,
-    tipLiquidSpecs,
-    flowRateType,
-    correctionVolume,
-    shaftULperMM,
-  } = args
+}
+interface BlowoutMaxUiFlowRateArgs extends BaseGetMaxUiFlowRateArgs {
+  flowRateType: 'blowout'
+}
+interface AspirateDispenseMaxUiFlowRateArgs extends BaseGetMaxUiFlowRateArgs {
+  flowRateType: 'aspirate' | 'dispense'
+  tipLiquidSpecs: SupportedTip
+  targetVolume: number
+  correctionVolume?: number
+}
+export const getMaxUiFlowRate = (
+  args: BlowoutMaxUiFlowRateArgs | AspirateDispenseMaxUiFlowRateArgs
+): number => {
+  const { channels, robotType, flowRateType, shaftULperMM } = args
 
   const maxPlungerSpeed =
     CHANNELS_MAPPED_TO_MAX_SPEED[robotType][channels].plunger
   if (flowRateType === 'blowout') {
     return round(shaftULperMM * maxPlungerSpeed)
   }
+  const { targetVolume, tipLiquidSpecs, correctionVolume = 0 } = args
   const pipetteAccuracyUlPerMm = _getPipetteAccuracyUlPerMm({
     targetVolume,
     tipLiquidSpecs,