Parameter description passed incorrectly

[sukhostavets]

The description for parameters in the generated OpenAPI JSON is placed inside the schema object, which does not conform to the OpenAPI specification. It should be directly on the parameter object.

Example Code:

params: z.object({
  id: z.string().openapi({
    example: "1234",
    description: "Id of the object"
  })
})

Current Output:

{
  "parameters": [
    {
      "schema": {
        "type": "string",
        "description": "Id of the object",
        "example": "1234"
      },
      "required": true,
      "name": "id",
      "in": "path"
    }
  ]
}

Expected Output:

{
  "parameters": [
    {
      "name": "id",
      "in": "path",
      "description": "Id of the object",
      "required": true,
      "schema": {
        "type": "string",
        "example": "1234"
      }
    }
  ]
}