feat: Feature notifications

[georgylobko]

Description

Introduced a feature notifications API that allows dynamically injecting a feature notifications drawer on pages using the AppLayout component.

The new API includes 3 methods:

• registerFeatureNotifications - registers a new drawer
• showFeaturePromptIfPossible - manually shows a feature prompt next to the drawer's trigger button
• clearFeatureNotifications - clears the feature notifications drawer

Also enhanced the existing feature prompt internal component by adding dismissal context to the onDismiss method (blur, close-button, outside-click, etc.).

Related links, issue #, if available: n/a

How has this been tested?

U tests / manually

Review checklist

The following items are to be evaluated by the author(s) and the reviewer(s).

Correctness

• Changes include appropriate documentation updates.
• Changes are backward-compatible if not indicated, see CONTRIBUTING.md.
• Changes do not include unsupported browser features, see CONTRIBUTING.md.
• Changes were manually tested for accessibility, see accessibility guidelines.

Security

• If the code handles URLs: all URLs are validated through the checkSafeUrl function.

Testing

• Changes are covered with new/existing unit tests?
• Changes are covered with new/existing integration tests?

---

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[codecov]

Codecov Report

❌ Patch coverage is 99.48454% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 97.32%. Comparing base (27ce9e0) to head (6286dcf).

Files with missing lines	Patch %	Lines
...efresh-toolbar/state/use-feature-notifications.tsx	99.09%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4186      +/-   ##
==========================================
+ Coverage   97.30%   97.32%   +0.01%     
==========================================
  Files         888      890       +2     
  Lines       26012    26182     +170     
  Branches     9408     9476      +68     
==========================================
+ Hits        25312    25481     +169     
- Misses        694      695       +1     
  Partials        6        6              

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

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[georgylobko]

Why not set focus immediately after opening the drawer? The drawer opens on the next react rendering cycle, so if we set focus right after registering, the dom element doesn't exist yet. Same issue in use-focus-control: https://github.com/cloudscape-design/components/blob/main/src/app-layout/utils/use-focus-control.ts#L145

[georgylobko]

Async problem - we need to unset tooltip suppress after shifting focus to it.

[georgylobko]

The method is a way the feature prompt was closed - blur, escape, close-button, click-outside.