Refactor deprecateValuesWithin helper to support optional propMappingFunction as argument

[2nikhiltom]

Issue : #16326
Enhancement of this PR

Change the signature of deprecateValuesWithin to accept below as it's arguments

  propType,
  allowedValues
  propMappingFunction

Create an propMappingFunction function and optionally pass it to deprecateValuesWithin which can guide the user more clearly about the depreciated prop value and it's new_alternative_value

[github-actions]

Thank you for submitting a feature request. Your proposal is open and will soon be triaged by the Carbon team.

If your proposal is accepted and the Carbon team has bandwidth they will take on the issue, or else request you or other volunteers from the community to work on this issue.