feat(openapi): support components

[OskarLebuda]

🔗 Linked issue

Fixes #2920

❓ Type of change

• 📖 Documentation (updates to the documentation, readme, or JSdoc annotations)
• 🐞 Bug fix (a non-breaking change that fixes an issue)
• 👌 Enhancement (improving an existing functionality like performance)
• ✨ New feature (a non-breaking change that adds functionality)
• 🧹 Chore (updates to the build process or auxiliary tools and libraries)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

Add components support for OpenAPI module.

Usage:

defineRouteMeta({
  openAPI: {
    responses: {
      200: { description: 'OK ', content: { 'application/json': { schema: { $ref: '#/components/schemas/User' } } } },
    },
    components: {
      User: {
        type: 'object',
        properties: {
          id: { type: 'integer' },
          name: { type: 'string' },
        },
      }
    },
  },
});

Result:

📝 Checklist

• I have linked an issue or discussion.
• I have updated the documentation accordingly.

[OskarLebuda]

@pi0 what do you think about it?

[pi0]

Quickly looking, seems lovely1

[OskarLebuda]

Can we merge this? 😄

[OskarLebuda]

@pi0 Can you merge this PR please? 😄

[pi0]

Dear @OskarLebuda it still needs proper testing before merge (or further change requests). reading this might be good.

[OskarLebuda]

Great! Didn't know about that! I'll check that and get back to you soon! Thanks!