fix(popover): Deprecate PopoverAlignment type values

[2nikhiltom]

Closes #16326 #16467

In #14654 all Popover-based components were unified to use new values for the align prop.

This PR does the below

• Deprecates old values so we can ensure consumers know to stop using them.

• PopoverAlignment is now a union of both : PopoverAlignment = DeprecatedPopoverAlignment | NewPopoverAlignment;

• Adds a custom validator function for proptypes that pops a warning when a deprecated value is used

Changelog

New

Adds deprecateValuesWithin function to warn when deprecated value is used for align prop
Pulls the old values out into their own type : DeprecatedPopoverAlignment and marks it as deprecated

Testing / Reviewing

Pass any old value for align pop in Popover component and verify that console warns about deprecated usage

<div>
      <Popover open={true} align="top-left" autoAlign></Popover>;
 </div>

[netlify]

✅ Deploy Preview for v11-carbon-react ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	87d15d3
🔍 Latest deploy log	https://app.netlify.com/sites/v11-carbon-react/deploys/664462994a764500082bfe0e
😎 Deploy Preview	https://deploy-preview-16346--v11-carbon-react.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[preetibansalui]

Few minor changes only, rest is looking fine to me.

[preetibansalui]

LGTM 👍

[tay1orjones]

This looks really great! I have a couple suggestions on the signature of deprecateValuesWithin. Let me know what you think

[2nikhiltom]

Hey @tay1orjones !
Thanks for the enhancement suggestions 💯
I have changed the signature of deprecateValuesWithin and is ready for the review

[tay1orjones]

Awesome stuff!