Missing type definition for header when using #/components/parameters/... syntax in the schema

[DefCon-007]

What are the steps to reproduce this issue?

1. Use the following OpenAPI schema.

{
    "openapi": "3.0.0",
    "info": {
      "title": "Simple API",
      "version": "1.0.0"
    },
    "paths": {
      "/example": {
        "get": {
          "summary": "Retrieve example data",
          "parameters": [
            {
              "$ref": "#/components/parameters/stackId"
            }
          ],
          "responses": {
            "200": {
              "description": "Successful response",
              "content": {
                "application/json": {
                  "schema": {
                    "type": "object",
                    "properties": {
                      "message": {
                        "type": "string",
                        "example": "Hello, World!"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "components": {
      "parameters": {
        "stackId": {
          "in": "header",
          "name": "X-Stack-Id",
          "schema": {
            "type": "integer"
          },
          "required": true
        }
      }
    }
  }

2. Check the type definition of headers, it will be something like follows

export type GetExampleStackIdHeaders = {
  "X-Stack-Id": HeaderStackIdParameter;
};

3. You will notice that the HeaderStackIdParameter type is not generated at all.

What happens?

The generated type definition is incomplete when a simple header parameter is referenced using the #/components/parameters/... syntax.

What were you expecting to happen?

Correct type definitions to be generated

Any logs, error output, etc?

…

Any other comments?

…

What versions are you using?

  System:
    OS: macOS 15.2
    CPU: (14) arm64 Apple M3 Max
    Memory: 422.19 MB / 36.00 GB
    Shell: 5.9 - /bin/zsh

[DefCon-007]

Closing as duplicate of #878