Generate a separate interface for each omponents.schemas model

[alex-aveva]

Description

Generate a separate interface for each components.schemas model to provide a better development experience and easier models consumption.

Proposal

I've created a diff PR with the proposed changes, showing how the final result would look. As you can see, it's a fairly straightforward change, but it can make a significant difference in how VSCode provides hints. You can compare the before and after screenshots below.

Before:

After

In real-world environments, having anonymous classes & hints is not very useful. Models often tend to be large, and in the many of cases, it's not even possible to determine which model you're looking at just by examining its shape. Providing a model interface name addresses this issue. It also enables referencing models by their interface names throughout the codebase, which is very convenient,

This perhaps can be an optional generator switch.

Checklist

• I’m willing to open a PR for this (see CONTRIBUTING.md)

[alex-aveva]

@drwpow I wonder how you feel about this? I'm trying to convince my teammates to adopt this library, and this feature is the only show-stopper for us. We're looking to use this for dozens of services we built (soon to be public) with a rather extensive model structure.
Thank you!

[drwpow]

Upon reading your proposal, this sounds like what’s in-progress here #1260?

I’m slightly-against this in general, because v1 of this library (long ago) took this approach and it quickly became untenable for many schemas. I wrote some thoughts here on some drawbacks of trying to generate separate interfaces for every schema object: #1260 (comment)

And this is off-topic, but a related thought: embrace snake_case (i.e. sometimes trying to get APIs to conform to JS/TS syntax standards can be an unnecessary timesink in general).

[alex-aveva]

@drwpow linked PR will work, I'll try to reach author and see if I can help. Your comments make sense, will make sure to test those cases.

[github-actions]

This issue is stale because it has been open for 90 days with no activity. If there is no activity in the next 7 days, the issue will be closed.

[drwpow]

This was released with the --root-types flag!

[saminahbab]

Huge thanks to whoever it was that helped with this
appreciate that it might break a lot of oapi schemas, but without root types was having to reexport myself.
much cleaner now. I'm happy.