fix: hoist and combine allOf subschema titles

[Drahflow]

What/Why/How?

Issues #932 and #1256 raise the point that the typically achieved rendering of the schemas resulting from nestend oneOf and allOf are unexpectedly ugly, namely object.

In #932 (comment) the point is raised that simply using one of the titles of multiple allOf options (e.g. the first one) might be wrong as the other elements might also have added semantics.

Hence this PR collects all schema titles from the subschemas below allOf (pulled down via hoistOneOf or not) and combines them via + for display. Schemas without title are not included, giving the API developer some flexibility to consider them for inclusion in display.

Reference

Closes #932 (differently)
Closes #1256

Testing

Screenshots (optional)

Source:

allOf:
  - type: object
    title: Existing
    properties:
      id:
        type: string
        format: uuid
  - description: Payment instrument (eg. card) data to use.
    title: Payment instrument
    type: object
    oneOf:
      - title: Credit card
        type: object
        properties:
          type:
            type: string
            const: cardInstrument
... [and three more types] ...

Check yourself

• Code is linted
• Tested
• All new/updated code is covered with tests

[AlexVarchuk]

@Drahflow Thank you a lot for your contribution.
I think it is better to enable it like redoc option.

Please add a boolean option like includeParentToSubschemaTitle or something like that to enable this feature.

Also, add a description of this option to the readme file and add tests for this feature.

Thank

[AlexVarchuk]

fixes #1960