OpenAPI V2 documents do not properly render anyOf including nullable references

[darrelmiller]

#1005
#1004

The following OpenAPI description does not render the complex object properly in V2

openapi: 3.0.0
info:
  title: asdads
  version: 1.0.0
paths:
  /:
   get:
     responses:
       200:
         description: ok
         content:
           application/json:
             schema:
               type: object
               properties:
                 complex:
                   anyOf:
                     - $ref: '#/components/schemas/complex'
                     - nullable: true
components:
  schemas:
    complex:
      type: object
      properties:
        name: 
          type: string
  

[molson194]

@darrelmiller - not sure if this is related, but it looks like all sibling properties do not get serialized when $ref

"definitions": {
  "AResource": {
    "description": "ARM tracked top level resource.",
    "type": "object",
    "properties": {
      "id": {
        "description": "Resource ID.",
        "type": "string",
        "readOnly": true
      },
      "name": {
        "description": "Resource name.",
        "type": "string",
        "readOnly": true
      },
      "type": {
        "description": "Resource type.",
        "type": "string",
        "readOnly": true
      },
      "location": {
        "description": "Resource location.",
        "type": "string",
        "x-ms-mutability": [
          "read",
          "create"
        ]
      },
      "tags": {
        "description": "Resource tags.",
        "type": "object",
        "additionalProperties": {
          "type": "string"
        }
      },
      "properties": {
        "$ref": "#/definitions/AResourceProperties"
===================NO OTHER PROPERTIES=====================
      }
    },
    "x-ms-azure-resource": true
  },
  "AResourceProperties": {
    "description": "Resource Properties",
    "type": "object",
    "properties": {
      "prop1": {
        "type": "string"
      },
      "prop2": {
        "description": "prop2 description",
        "type": "string"
      }
    }
  }
}

My OpenAPI schema has description and extensions (see the 'NO OTHER PROPERTIES' section), but those aren't generated. Is this related?

[darrelmiller]

Properties alongside the $ref are not supported in OpenAPI 3.0. From the OpenAPI 3.0.0 specification

This object cannot be extended with additional properties and any properties added SHALL be ignored.

https://spec.openapis.org/oas/v3.0.3#fixed-fields-18