Missing $ref for BadRequestHttpException

[apasquini95]

Hi everyone, I have a question about $ref when handling exceptions such as BadRequestHttpException. I have a controller like this one:

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Symfony\Component\HttpKernel\Exception\BadRequestHttpException;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;

class MyController extends Controller
{
    /**
     * Summary of myHandler
     * @param Request $request
     * @param mixed $user
     * @return int
     * @throws NotFoundHttpException
     * @throws BadRequestHttpException
     */
    public function myHandler(Request $request): int
    {
        $bool = $request->boolean('test_param');
        $this->doSomething($bool);

        return 1;
    }

    /**
     * Summary of myOtherHandler
     * @param Request $request
     * @return int
     * @throws NotFoundHttpException
     * @throws BadRequestHttpException
     */
    public function myOtherHandler(Request $request): int
    {
        $bool = $request->boolean('test_param');
        $this->doSomething($bool);

        return 2;
    }

    private function doSomething(bool $param): void
    {
        if ($param) {
            throw new BadRequestHttpException();
        }

        throw new NotFoundHttpException();
    }
}

As you can see both of the two handlers can throw a NotFoundHttpException or a BadRequestHttpException. Scramble is capable to create the corresponding exception's schemas, but while the NotFoundHttpException is linked by $ref, the BadRequestHttpException's schema is repeated twice.

{
    "openapi": "3.1.0",
    "info": {
        "title": "Laravel",
        "version": "0.0.1"
    },
    "servers": [
        {
            "url": "http://localhost/api"
        }
    ],
    "paths": {
        "/endpoint-1": {
            "get": {
                "operationId": "endpoint-1",
                "summary": "Summary of myHandler",
                "tags": [
                    "My"
                ],
                "parameters": [
                    {
                        "name": "test_param",
                        "in": "query",
                        "schema": {
                            "type": "boolean",
                            "default": false
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "integer",
                                    "const": 1
                                }
                            }
                        }
                    },
                    "400": {                                                                    // First schema
                        "description": "Bad request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "message": {
                                            "type": "string",
                                            "description": "Error overview."
                                        }
                                    },
                                    "required": [
                                        "message"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {                                                                    // Using $ref as wanted
                        "$ref": "#/components/responses/NotFoundHttpException"
                    }
                }
            }
        },
        "/endpoint-2": {
            "get": {
                "operationId": "endpoint-2",
                "summary": "Summary of myOtherHandler",
                "tags": [
                    "My"
                ],
                "parameters": [
                    {
                        "name": "test_param",
                        "in": "query",
                        "schema": {
                            "type": "boolean",
                            "default": false
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "integer",
                                    "const": 2
                                }
                            }
                        }
                    },
                    "400": {                                                                    // Second schema
                        "description": "Bad request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "message": {
                                            "type": "string",
                                            "description": "Error overview."
                                        }
                                    },
                                    "required": [
                                        "message"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {                                                                    // Using $ref as wanted
                        "$ref": "#/components/responses/NotFoundHttpException"
                    }
                }
            }
        }
    },
    "components": {
        "responses": {
            "NotFoundHttpException": {
                "description": "Not found",
                "content": {
                    "application/json": {
                        "schema": {
                            "type": "object",
                            "properties": {
                                "message": {
                                    "type": "string",
                                    "description": "Error overview."
                                }
                            },
                            "required": [
                                "message"
                            ]
                        }
                    }
                }
            }
            // Missing schema declaration for BadRequestHttpException
        }
    }
}

Is it an intended behaviour or am I missing something?
For this purpose, I created a branch on this public repository.