Allow labeling oneOf/anyOf variants in nested polymorphic schemas (currently always "Option 1 / Option 2")

[rcalejan]

Allow labeling oneOf/anyOf variants in nested polymorphic schemas (currently always "Option 1 / Option 2")

Mintlify renders polymorphic schema variants with meaningful labels (the $ref schema name) when the union sits at the top level of a response or request body. This works correctly:

"responses": {
  "200": {
    "content": {
      "application/json": {
        "schema": {
          "anyOf": [
            { "$ref": "#/components/schemas/VariantA" },
            { "$ref": "#/components/schemas/VariantB" }
          ]
        }
      }
    }
  }
}

But when the same pattern is nested inside an array's items (or any deeper position), tabs collapse to "Option 1", "Option 2", … with no override:

"BatchRequest": {
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": { "$ref": "#/components/schemas/Item" }
    }
  }
}

Where Item is a oneOf of VariantA / VariantB. Mintlify renders this with tabs literally labeled "Option 1" and "Option 2", regardless of:

• The $ref schema names of the branches
• An OpenAPI discriminator.mapping block keyed by the discriminator value
• JSON-Schema title on each inline branch
• { "title": "...", "allOf": [{ "$ref": "..." }] } wrapper pattern
• Switching oneOf → anyOf

This is a common shape for batch endpoints where each item in the array can be one of N variant types, and there's currently no way to label them.

Requested: Have the renderer use the $ref schema name (or honor discriminator.mapping keys, or a title keyword) for oneOf/anyOf variants regardless of nesting depth — not just at the top-level schema position.

Alternative if behavior change is risky: an x-mint extension on the union or on each branch that explicitly sets the tab label, e.g.:

"oneOf": [
  { "$ref": "#/components/schemas/VariantA", "x-mint": { "title": "Variant A" } },
  { "$ref": "#/components/schemas/VariantB", "x-mint": { "title": "Variant B" } }
]

Happy to provide a minimal repro repo if useful.