feat: add optional description to combobox

[Bracciata]

Closes: #1657

This adds an optional attribute for a description below the Label of a combobox. It also moves the error to above the input and below the description. Finally, it adds a caution icon before the error message.

[Copilot]

Pull Request Overview

This PR adds an optional description feature to the Combobox component that displays below the label and repositions error messages to appear between the description and input field for better visual hierarchy.

• Adds an optional description prop to the Combobox component
• Moves error messages to appear above the input field and below the description
• Updates aria-describedby to properly reference both description and error elements

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File	Description
packages/styles/forms.css	Adds flex layout styles for proper field alignment
packages/react/src/components/Combobox/Combobox.tsx	Implements description prop and repositions error rendering
packages/react/src/components/Combobox/Combobox.test.tsx	Adds test coverage for description functionality
docs/pages/components/Combobox.mdx	Documents the new description feature with example

Comments suppressed due to low confidence (1)

packages/react/src/components/Combobox/Combobox.test.tsx:271

• This test is duplicated by the test at line 1678. The tests have the same functionality but different naming - consider consolidating them to avoid redundancy.

test('should render combobox with both description and error', () => {

[aws-amplify-us-east-1]

This pull request is automatically being deployed by Amplify Hosting (learn more).

Access this pull request here: https://pr-2042.d15792l1n26ww3.amplifyapp.com

[scurker]

Thanks for taking a look at this! This is definitely a good start, a few things to clean up but nothing big. We'll also need to ensure we have updated screenshots for this with the description. If you're unsure where to get started with that, let me know and we can pair!

[shawnsharpDQ]

Looking at the screenshots, the error and description do not look to have the correct spacing from the field

[scurker]

Just a few minor things. I think addressing the class name fixes in the component should address the differences that are being shown in the screenshot.

Addressed

[scurker]

One minor thing. We also need to get a final @dequelabs/design-team signoff and we're good to go.