Subcomponent api does not support descriptions

[konsalex]

Is your feature request related to a problem? Please describe.

In Storybook v8 the subcomponent API will come back.

While it works great there a few things that would make it better, like provide additional options for documentation.

For example currently we are documenting the subcomponents at @neo4j with custom page components under:

parameters: {
 docs: {
  page: () => <CustomSubs />
 }
}

This allows us to write descriptions about subcomponents and their usage.

Describe the solution you'd like

To have a modified subcomponents interface, where it would allows something along the lines:

subcomponents?: Record<string, TRenderer['component'] & { description:  CUSTOM_DESCRIPTION}>;

Where custom description ideally it would be a component we could render (ReactNode)

Describe alternatives you've considered

Currently the alternative, was what we developed to mitigate the lack of subcomponents API, which is to create custom page render functions.

Are you able to assist to bring the feature to reality?

yes, I can

Additional context

No response