Query parameter default array values not rendered correctly

[cmeeren]

Consider the following query parameter definition:

- in: query
  name: "sort"
  description: |
    ...
  explode: false
  schema:
    type: array
    items:
      type: string
      enum:
        - isPending
        - userFullName
        - email
    default:
      - isPending
      - userFullName
      - email
    example:
      - -isPending
      - email
      - userFullName

It is rendered like this:

As you can see, the enumeration and the example renders correctly, but not the default value. It should be rendered like the example, with the query parameter name first and comma between the values.

Workaround: Format manually as string:

default: isPending,userFullName,email

Using @next version from npm.

[AlexVarchuk]

@cmeeren HI, I try to reproduce it but seems I miss something. Can you share additional steps to reproduce? Here is my definition. It works on my side.

openapi: 3.0.0
servers:
  - url: //petstore.swagger.io/v2
    description: Default server
  - url: //petstore.swagger.io/sandbox
    description: Sandbox server
info:
  description: string
  version: 1.0.0
  title: Swagger Petstore
tags:
  - name: url
    description: Everything about your Pets
paths:
  /url:
    parameters:
      - name: Accept-Language
        in: header
        description: "The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US"
        example: en-US
        required: false
        schema:
          type: string
          default: en-AU
      - in: query
        name: "sort"
        description: |
          ...
        explode: false
        schema:
          type: array
          items:
            type: string
            enum:
              - isPending
              - userFullName
              - email
          default:
            - isPending
            - userFullName
            - email
          example:
            - -isPending
            - email
            - userFullName
      - in: query
        name: "sort1"
        description: |
          ...
        explode: false
        schema:
          type: array
          items:
            type: string
            enum:
              - isPending
              - userFullName
              - email
          default:
            - isPending
            - userFullName
            - email
          example:
            - -isPending
            - email
            - userFullName
    get:
      tags:
        - pet
      summary: Find pet by ID
      description: Returns a single pet
      operationId: getPetById
      parameters:
        - name: petId
          in: path
          description: ID of pet to return
          required: true
          deprecated: true
          schema:
            type: integer
            format: int64

[cmeeren]

I am also using enumSkipQuotes.

Without it, it renders like this, which is still a bug and different from example:

[AlexVarchuk]

@cmeeren Why do you need additional - before isPending in your definition?

[cmeeren]

The dash is part of the value. In the JSON:API format, it indicates that the column should be sorted descending. It should be irrelevant here.

[AlexVarchuk]

@cmeeren We found the problem. We'll fix it. Thank you for your help.