feat: display format for oneOf primitive arms (#1268)

* feat: display format for oneOf primitive arms

Uses getSchemaName() to properly display format information (e.g.,
'string<date-time>') for primitive arms in oneOf/anyOf schemas, instead
of just showing the raw type ('string').

Closes #1230

Co-authored-by: Josh Wulf <[email protected]>

* test: add oneOf primitive format types example

Adds test case for oneOf schemas with primitive types that have format
specifiers (e.g., string with date-time, email, integer with int64).
This verifies the fix displays 'string<date-time>' instead of just 'string'.

---------

Co-authored-by: Josh Wulf <[email protected]>

Author: sserrata

demo/examples/tests/oneOf.yaml

@@ -39,6 +39,46 @@ paths:
                       - type: boolean
                       - type: "null"
 
+  /oneof-primitive-formats:
+    get:
+      tags:
+        - oneOf
+      summary: oneOf with Primitive Format Types
+      description: |
+        Primitive types with format should display as `type<format>` (e.g., `string<date-time>`).
+
+        Schema:
+        ```yaml
+        type: object
+        properties:
+          oneOfProperty:
+            oneOf:
+              - type: string
+                format: date-time
+              - type: string
+                format: email
+              - type: integer
+                format: int64
+              - type: string
+        ```
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  oneOfProperty:
+                    oneOf:
+                      - type: string
+                        format: date-time
+                      - type: string
+                        format: email
+                      - type: integer
+                        format: int64
+                      - type: string
+
   /oneof-complex-types:
     get:
       tags:

packages/docusaurus-theme-openapi-docs/src/theme/Schema/index.tsx

@@ -145,9 +145,13 @@ const AnyOneOf: React.FC<SchemaProps> = ({ schema, schemaType }) => {
       </span>
       <SchemaTabs groupId={`schema-${uniqueId}`} lazy>
         {schema[key]?.map((anyOneSchema: any, index: number) => {
+          // Use getSchemaName to include format info (e.g., "string<date-time>")
+          const computedSchemaName = getSchemaName(anyOneSchema);
+
           // Determine label for the tab
-          // If schema is just oneOf/anyOf without title/type, use a generic label
-          let label = anyOneSchema.title || anyOneSchema.type;
+          // Prefer explicit title, then computed schema name, then raw type
+          let label =
+            anyOneSchema.title || computedSchemaName || anyOneSchema.type;
           if (!label) {
             if (anyOneSchema.oneOf) {
               label = translate({
@@ -175,7 +179,7 @@ const AnyOneOf: React.FC<SchemaProps> = ({ schema, schemaType }) => {
                 <SchemaItem
                   collapsible={false}
                   name={undefined}
-                  schemaName={anyOneSchema.type}
+                  schemaName={computedSchemaName}
                   qualifierMessage={getQualifierMessage(anyOneSchema)}
                   schema={anyOneSchema}
                   discriminator={false}
@@ -192,7 +196,7 @@ const AnyOneOf: React.FC<SchemaProps> = ({ schema, schemaType }) => {
                   <SchemaItem
                     collapsible={false}
                     name={undefined}
-                    schemaName={anyOneSchema.type}
+                    schemaName={computedSchemaName}
                     qualifierMessage={getQualifierMessage(anyOneSchema)}
                     schema={anyOneSchema}
                     discriminator={false}