Description makes property to generate allOf instead of $ref

[papirosko]

Is there an existing issue for this?

• I have searched the existing issues

Current behavior

Using

    "@nestjs/swagger": "^7.1.11",

I have an object with property:

    @ApiProperty({
        type: OfferedServiceView,
        description: 'any text',
    })
    offeredServiceSnapshot: OfferedServiceView;

openapi file contains this for the property, which is wrong

"offeredServiceSnapshot":{"description":"any text","allOf":[{"$ref":"#/components/schemas/OfferedServiceView"}]}

while without description:

    @ApiProperty({
        type: OfferedServiceView
    })
    offeredServiceSnapshot: OfferedServiceView;

generates

"offeredServiceSnapshot":{"$ref":"#/components/schemas/OfferedServiceView"}

The latest is correct, I wonder, why adding description breaks this?

Minimum reproduction code

Steps to reproduce

No response

Expected behavior

openapi should contain

"offeredServiceSnapshot":{"$ref":"#/components/schemas/OfferedServiceView"}

Package version

10.2.5

NestJS version

7.1.11

Node.js version

No response

In which operating systems have you tested?

• macOS
• Windows
• Linux

Other

No response

[kamilmysliwiec]

Please provide a minimum reproduction repository (Git repository/StackBlitz/CodeSandbox project).

[An-dz]

@kamilmysliwiec
Here's a reproduction repo: https://github.com/An-dz/nestjs-swagger-ref-reproducible

And here's the OpenAPI specification that tells that description is allowed with $ref:
https://swagger.io/specification/#reference-object

What to see:

• In /api two of the properties are linked with SecondLevelDTO, two others are not.
• In /api-json you can see the weird $ref in the components section.

Edit:
It's not only "description" that does that, "nullable" also causes the same issue.