feat: itemsControl property of Side Navigation

[Manzurka]

Description

Items Control property allows customers to define the component of their chose to be added to a slot below the header and above the items of Side Navigation Panel. For example, customers can pass Select or Multi-select components with custom attribute values (ex. options, selectedOption, triggerVariant, label, loadingText). Use case: This allows customers to define a callback function onChange event of the component, for example, to allow users filter out navigation menu items.

Related links
AWSUI-54774
API Proposal ID bG8cAsCSosVm

How has this been tested?

Unit tests, snapshot test, integ test have been added.

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. n/a

Testing

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

---

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

All modified and coverable lines are covered by tests ✅

Project coverage is 95.93%. Comparing base (e55cdca) to head (b7d5556).
Report is 7 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2673      +/-   ##
==========================================
+ Coverage   95.85%   95.93%   +0.08%     
==========================================
  Files         744      746       +2     
  Lines       20581    20679      +98     
  Branches     7024     7043      +19     
==========================================
+ Hits        19727    19839     +112     
- Misses        798      832      +34     
+ Partials       56        8      -48     

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

[pan-kot]

Great work!

[Manzurka]