feat(@aws-amplify/ui-react): withAuthenticator(Component[, props])

[ericclemmons]

Issue #, if available: Delivers #171965194

• Add withAuthenticator(Component[, props]), where props are those of AmplifyAuthenticator (e.g. usernameAlias).
• Add stories.
• Add docs.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

[codecov]

Codecov Report

Merging #5204 into ui-components/master will not change coverage by %.
The diff coverage is n/a.

@@                  Coverage Diff                  @@
##           ui-components/master    #5204   +/-   ##
=====================================================
  Coverage                 75.85%   75.85%           
=====================================================
  Files                       177      177           
  Lines                      9685     9685           
  Branches                   1910     1860   -50     
=====================================================
  Hits                       7347     7347           
- Misses                     2187     2198   +11     
+ Partials                    151      140   -11     

Impacted Files	Coverage Δ
packages/auth/src/OAuth/OAuth.ts	48.12% <0.00%> (ø)
packages/core/src/Credentials.ts	31.45% <0.00%> (ø)
packages/analytics/src/Analytics.ts	66.86% <0.00%> (ø)
packages/core/src/OAuthHelper/GoogleOAuth.ts	32.65% <0.00%> (ø)
packages/xr/src/Providers/SumerianProvider.ts	47.55% <0.00%> (ø)
packages/core/src/OAuthHelper/FacebookOAuth.ts	35.55% <0.00%> (ø)
...ackages/pubsub/src/Providers/AWSAppSyncProvider.ts	66.66% <0.00%> (ø)
...pubsub/src/Providers/AWSAppSyncRealTimeProvider.ts	18.67% <0.00%> (ø)
...rc/Providers/AmazonAIConvertPredictionsProvider.ts	61.01% <0.00%> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update aeb4f80...cc569cb. Read the comment docs.

[jordanranz]

This looks great, we may want to add a small README section for migrating from the old to new. What do you think?

[jordanranz]

LGMT, nice work

[ashika01]

Looks good 🎉 Ship it

[github-actions]

This pull request has been automatically locked since there hasn't been any recent activity after it was closed. Please open a new issue for related bugs.

Looking for a help forum? We recommend joining the Amplify Community Discord server *-help channels or Discussions for those types of questions.