[EuiComboBox] Improved props table for EuiComboBox

[akashgp09]

Summary

This PR Fixes: #1981

Improved props table for EuiComboBox.
Imported EuiComboBoxOptionOption using the prop-loader syntax and added it to the props key of the example.

Checklist

• Check against all themes for compatibility in both light and dark modes
• Checked in mobile
• Checked in Chrome, Edge, and Firefox
  - [ ] Props have proper autodocs and playground toggles
• Added documentation
  - [ ] Checked Code Sandbox works for the any docs examples
  - [ ] Added or updated jest tests
  - [ ] Checked for breaking changes and labeled appropriately
  - [ ] Checked for accessibility including keyboard-only and screenreader modes
  - [ ] A changelog entry exists and is marked appropriately

[kibanamachine]

Since this is a community submitted pull request, a Jenkins build has not been kicked off automatically. Can an Elastic organization member please verify the contents of this patch and then kick off a build manually?

[chandlerprall]

jenkins test this

[kibanamachine]

Preview documentation changes for this PR: https://eui.elastic.co/pr_4563/

[chandlerprall]

Looking into why this renders so weirdly.

[akashgp09]

@chandlerprall what needs to be done for this?

[chandlerprall]

Sorry for the delay, still need to look into why this renders like this - my initial search didn't show anything obvious.

Instead of rendering "EuiComboBoxOptionOption" under the "Prop" column, it is supposed to list each prop from the EuiComboBoxOptionOption type in separate rows.

[akashgp09]

It seems only types declared using interface declaration renders list of each prop defined within it in separate rows and those defined using type alias declaration (in our case) lists the alias itself under the prop column.

[akashgp09]

changing the type alias declaration of EuiComboBoxOptionOption to interface declaration fixes this

[chandlerprall]

Nice find! This looks good, will deploy through CI for final verification.

jenkins test this

[kibanamachine]

Preview documentation changes for this PR: https://eui.elastic.co/pr_4563/

[chandlerprall]

Oh, one last thing. It's useful to link between the options row in EuiComboBox's props to the new EuiComboBoxOptionOption section. An example of this is EuiDataGrid's props pointing at #EuiDataGridColumnActions in the actions prop: https://github.com/elastic/eui/blob/master/src/components/datagrid/data_grid_types.ts#L81-L84

Let's add a similar comment to EuiComboBox directing the user to the new section.

[akashgp09]

@chandlerprall i have made the changes :-)

[chandlerprall]

jenkins test this

[kibanamachine]

Preview documentation changes for this PR: https://eui.elastic.co/pr_4563/

[chandlerprall]

Changes look good, tested props table rendering & link between EuiComboBox::options -> EuiComboBoxOptionOption tables; 👍 thanks again!