Support schemas with array of types

[MarcL01]

Description

Support an array of schema types (IE string & null)

Motivation and Context

• We are trying to switch away from readme.com which supports array of schema types

How Has This Been Tested?

Used the pet store demo to test - http://localhost:3000/petstore_versioned/1.0.0/update-pet-with-form

type:
  - string
  - 'null'

"type": [
  "string",
  "null"
]

Before the above schemas would result in stringnull, now they result in string | null

Screenshots (if appropriate)

Before:

After:

Types of changes

• Bug fix (non-breaking change which fixes an issue)

Checklist

• I have updated the documentation accordingly.
• I have read the CONTRIBUTING document.
• I have added tests to cover my changes if appropriate.
• All new and existing tests passed.

[github-actions]

Visit the preview URL for this PR (updated for commit 1a68f26):

https://docusaurus-openapi-36b86--pr1017-4gdj0s5q.web.app

_{(expires Sun, 08 Dec 2024 16:35:37 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: bf293780ee827f578864d92193b8c2866acd459f}

[sserrata]

Hi @MarcL01, thanks for the PR. I think this is only officially supported in OpenAPI 3.1, according to the spec? How do you see this interacting with nullable or OpenAPI 3.0 in general?

[robbieaverill]

@sserrata OpenAPI 3.1 actually removes nullable (from 3.0) entirely - see https://www.openapis.org/blog/2021/02/16/migrating-from-openapi-3-0-to-3-1-0 -> "Swap nullable type for arrays".

This PR is good but we also need to add support for it in anyOf, allOf, oneOf, etc, as well in the type definitions.