feat(upgrade): adds featureflag-deprecate-flags-prop codemod and deprecates flags prop

[2nikhiltom]

Closes #17243

New props to feature flag props were added here #17239

This introduces a new codemod to Convert FeatureFlags' flags object prop to individual boolean props
and deprecates the existing flags prop

Changelog

New

• Added a new featureflag-deprecate-flags-prop codemod
• Added test fixtures for all existing featureflags and tests to validate
• flags prop for FeatureFlag is marked as deprecated

Changed

• Updated FeatureFlags/overview.stories.mdx to document the codemod
• Added instructions for running the codemod to the flags deprecation warning message

Testing / Reviewing

• Ensure that the test fixtures make sense - input is what someones code should look like before running the codemod, and the output is what we expect the codemod to generate/change it to.
• Make sure the docs read well and I didn't miss anything
• I used below command to run the codemode locally to verify it works ( --parser=tsx used to process typescript files)
• jscodeshift -t featureflag-deprecate-flags-prop.js --parser=tsx _your_file_path_

curious to hear how you feel about this

[netlify]

✅ Deploy Preview for v11-carbon-react ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	1cd4432
🔍 Latest deploy log	https://app.netlify.com/sites/v11-carbon-react/deploys/66ed1ca7552df80008d1e005
😎 Deploy Preview	https://deploy-preview-17266--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.

[netlify]

✅ Deploy Preview for carbon-elements ready!

Name	Link
🔨 Latest commit	1cd4432
🔍 Latest deploy log	https://app.netlify.com/sites/carbon-elements/deploys/66ed1ca78001c20008e2aac2
😎 Deploy Preview	https://deploy-preview-17266--carbon-elements.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.

[riddhybansal]

Hey @tay1orjones one doubt , what do you think on test fixture ? can we just make it generic for all feature flags , May be just this

The input.js

<FeatureFlags flags={{ 'enable-v12-tile-default-icons': true, 'enable-v12-overflowmenu': true, }}> <Tile /> </FeatureFlags>;

The output.js
`<FeatureFlags
enableV12TileDefaultIcons
enableV12Overflowmenu

;`

[tay1orjones]

This looks great! Just a few things from our pair reviewing session today:

• Add this codemod to the available migrations via @carbon/upgrade migrate, in packages/upgrade/src/upgrades.js
• Update the codemod to remove old flags that are no longer needed, like enable-v11-release. Mention this in the description of the migration in packages/upgrade/src/upgrades.js
• Add some new test fixtures mixing old flags and new to validate that the right one are being removed

[tay1orjones]

This looks so good! 🔥 just three minor things I saw

[tay1orjones]

There's one more spot where enable-use-controlled-state-with-value is used that could probably be deleted, it's not used anywhere else in the styles

carbon/packages/styles/scss/_feature-flags.scss

Line 11 in b9abee7

'enable-use-controlled-state-with-value': true,

[codecov]

Codecov Report

Attention: Patch coverage is 61.11111% with 7 lines in your changes missing coverage. Please review.

Project coverage is 76.95%. Comparing base (72c80b3) to head (1cd4432).
Report is 726 commits behind head on main.

Files with missing lines	Patch %	Lines
packages/upgrade/src/upgrades.js	0.00%	5 Missing and 1 partial ⚠️
...ackages/react/src/components/FeatureFlags/index.js	91.66%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #17266      +/-   ##
==========================================
- Coverage   76.95%   76.95%   -0.01%     
==========================================
  Files         408      408              
  Lines       13979    13992      +13     
  Branches     4343     4300      -43     
==========================================
+ Hits        10758    10768      +10     
- Misses       3047     3051       +4     
+ Partials      174      173       -1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.