OpenAPISpecWriter does not support schema 'format' field.

[ArclightHub]

• I confirm that I have read and attempted the tips in the Troubleshooting Guide.

What happened?
When exporting API documentation using the OpenAPISpecWriter it does not allow us to add the optional 'format' String Formats field as described in the following swagger document:
https://swagger.io/docs/specification/data-models/data-types/

We could do something like this at the end of the generateFieldData function:

        } else {
            $optionalSchema=  [];
            if (isset($field->format)) {
                $optionalSchema['format'] = $field->format;
            }
            return array_merge([
                'type' => $this->normalizeTypeName($field->type),
                'description' => $field->description ?: '',
                'example' => $field->example,
            ], $optionalSchema);
        }

instead of...

        } else {
            return [
                'type' => $this->normalizeTypeName($field->type),
                'description' => $field->description ?: '',
                'example' => $field->example,
            ];
        }

Additional info:

We would also need to update the Parameters class to add a public $format variable.

I have made a PR here:
#394