docusaurus-plugin-openapi-docs 1.1.2 → 1.1.5

package/lib/markdown/{createSchemaDetails.d.ts → createResponseSchema.d.ts}

@@ -7,8 +7,8 @@ interface Props {
             [key: string]: MediaTypeObject;
         };
         description?: string;
-        required?: boolean;
+        required?: string[] | boolean;
     };
 }
-export declare function createSchemaDetails({ title, body, ...rest }: Props): string | undefined;
+export declare function createResponseSchema({ title, body, ...rest }: Props): string | undefined;
 export {};

package/lib/markdown/{createSchemaDetails.js → createResponseSchema.js}

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSchemaDetails = void 0;
+exports.createResponseSchema = void 0;
 const createDescription_1 = require("./createDescription");
 const createDetails_1 = require("./createDetails");
 const createDetailsSummary_1 = require("./createDetailsSummary");
@@ -86,12 +86,14 @@ function createAnyOneOf(schema) {
     });
 }
 function createProperties(schema) {
+    const discriminator = schema.discriminator;
     return Object.entries(schema.properties).map(([key, val]) => createEdges({
         name: key,
         schema: val,
         required: Array.isArray(schema.required)
             ? schema.required.includes(key)
             : false,
+        discriminator,
     }));
 }
 function createAdditionalProperties(schema) {
@@ -190,7 +192,8 @@ function createItems(schema) {
         return createAnyOneOf(schema.items);
     }
     if (((_e = schema.items) === null || _e === void 0 ? void 0 : _e.allOf) !== undefined) {
-        const { mergedSchemas } = mergeAllOf((_f = schema.items) === null || _f === void 0 ? void 0 : _f.allOf);
+        // TODO: figure out if and how we should pass merged required array
+        const { mergedSchemas, } = mergeAllOf((_f = schema.items) === null || _f === void 0 ? void 0 : _f.allOf);
         // Handles combo anyOf/oneOf + properties
         if ((mergedSchemas.oneOf !== undefined ||
             mergedSchemas.anyOf !== undefined) &&
@@ -228,6 +231,93 @@ function createItems(schema) {
             : false,
     }));
 }
+/**
+ * For handling discriminators that do not map to a same-level property
+ */
+function createDiscriminator(schema) {
+    var _a;
+    const discriminator = schema.discriminator;
+    const propertyName = discriminator === null || discriminator === void 0 ? void 0 : discriminator.propertyName;
+    const propertyType = "string"; // should always be string
+    const mapping = discriminator === null || discriminator === void 0 ? void 0 : discriminator.mapping;
+    // Explicit mapping is required since we can't support implicit
+    if (mapping === undefined) {
+        return undefined;
+    }
+    // Attempt to get the property description we want to display
+    // TODO: how to make it predictable when handling allOf
+    let propertyDescription;
+    const firstMappingSchema = mapping[Object.keys(mapping)[0]];
+    if (firstMappingSchema.properties !== undefined) {
+        propertyDescription =
+            firstMappingSchema.properties[propertyName].description;
+    }
+    if (firstMappingSchema.allOf !== undefined) {
+        const { mergedSchemas } = mergeAllOf(firstMappingSchema.allOf);
+        if (mergedSchemas.properties !== undefined) {
+            propertyDescription =
+                (_a = mergedSchemas.properties[propertyName]) === null || _a === void 0 ? void 0 : _a.description;
+        }
+    }
+    if (propertyDescription === undefined) {
+        if (schema.properties !== undefined &&
+            schema.properties[propertyName] !== undefined) {
+            propertyDescription = schema.properties[propertyName].description;
+        }
+    }
+    return (0, utils_1.create)("div", {
+        className: "discriminatorItem",
+        children: (0, utils_1.create)("div", {
+            children: [
+                (0, utils_1.create)("strong", {
+                    style: { paddingLeft: "1rem" },
+                    children: propertyName,
+                }),
+                (0, utils_1.guard)(propertyType, (name) => (0, utils_1.create)("span", {
+                    style: { opacity: "0.6" },
+                    children: ` ${propertyType}`,
+                })),
+                (0, utils_1.guard)((0, schema_1.getQualifierMessage)(schema.discriminator), (message) => (0, utils_1.create)("div", {
+                    style: {
+                        paddingLeft: "1rem",
+                    },
+                    children: (0, createDescription_1.createDescription)(message),
+                })),
+                (0, utils_1.guard)(propertyDescription, (description) => (0, utils_1.create)("div", {
+                    style: {
+                        paddingLeft: "1rem",
+                    },
+                    children: (0, createDescription_1.createDescription)(description),
+                })),
+                (0, utils_1.create)("DiscriminatorTabs", {
+                    children: Object.keys(mapping).map((key, index) => {
+                        if (mapping[key].allOf !== undefined) {
+                            const { mergedSchemas } = mergeAllOf(mapping[key].allOf);
+                            // Cleanup duplicate property from mapping schema
+                            delete mergedSchemas.properties[propertyName];
+                            mapping[key] = mergedSchemas;
+                        }
+                        if (mapping[key].properties !== undefined) {
+                            // Cleanup duplicate property from mapping schema
+                            delete mapping[key].properties[propertyName];
+                        }
+                        const label = key;
+                        return (0, utils_1.create)("TabItem", {
+                            label: label,
+                            value: `${index}-item-discriminator`,
+                            children: [
+                                (0, utils_1.create)("div", {
+                                    style: { marginLeft: "-4px" },
+                                    children: createNodes(mapping[key]),
+                                }),
+                            ],
+                        });
+                    }),
+                }),
+            ],
+        }),
+    });
+}
 function createDetailsNode(name, schemaName, schema, required) {
     return (0, utils_1.create)("SchemaItem", {
         collapsible: true,
@@ -242,7 +332,7 @@ function createDetailsNode(name, schemaName, schema, required) {
                                 style: { opacity: "0.6" },
                                 children: ` ${schemaName}`,
                             }),
-                            (0, utils_1.guard)(required, () => [
+                            (0, utils_1.guard)(schema.required && schema.required === true, () => [
                                 (0, utils_1.create)("strong", {
                                     style: {
                                         fontSize: "var(--ifm-code-font-size)",
@@ -272,12 +362,76 @@ function createDetailsNode(name, schemaName, schema, required) {
         ],
     });
 }
+/**
+ * For handling discriminators that map to a same-level property (like 'petType').
+ * Note: These should only be encountered while iterating through properties.
+ */
+function createPropertyDiscriminator(name, schemaName, schema, discriminator, required) {
+    if (schema === undefined) {
+        return undefined;
+    }
+    if (discriminator.mapping === undefined) {
+        return undefined;
+    }
+    return (0, utils_1.create)("div", {
+        className: "discriminatorItem",
+        children: (0, utils_1.create)("div", {
+            children: [
+                (0, utils_1.create)("strong", { style: { paddingLeft: "1rem" }, children: name }),
+                (0, utils_1.guard)(schemaName, (name) => (0, utils_1.create)("span", {
+                    style: { opacity: "0.6" },
+                    children: ` ${schemaName}`,
+                })),
+                (0, utils_1.guard)(required, () => [
+                    (0, utils_1.create)("strong", {
+                        style: {
+                            fontSize: "var(--ifm-code-font-size)",
+                            color: "var(--openapi-required)",
+                        },
+                        children: " required",
+                    }),
+                ]),
+                (0, utils_1.guard)((0, schema_1.getQualifierMessage)(discriminator), (message) => (0, utils_1.create)("div", {
+                    style: {
+                        paddingLeft: "1rem",
+                    },
+                    children: (0, createDescription_1.createDescription)(message),
+                })),
+                (0, utils_1.guard)(schema.description, (description) => (0, utils_1.create)("div", {
+                    style: {
+                        paddingLeft: "1rem",
+                    },
+                    children: (0, createDescription_1.createDescription)(description),
+                })),
+                (0, utils_1.create)("DiscriminatorTabs", {
+                    children: Object.keys(discriminator === null || discriminator === void 0 ? void 0 : discriminator.mapping).map((key, index) => {
+                        const label = key;
+                        return (0, utils_1.create)("TabItem", {
+                            label: label,
+                            value: `${index}-item-discriminator`,
+                            children: [
+                                (0, utils_1.create)("div", {
+                                    style: { marginLeft: "-4px" },
+                                    children: createNodes(discriminator === null || discriminator === void 0 ? void 0 : discriminator.mapping[key]),
+                                }),
+                            ],
+                        });
+                    }),
+                }),
+            ],
+        }),
+    });
+}
 /**
  * Creates the edges or "leaves" of a schema tree. Edges can branch into sub-nodes with createDetails().
  */
-function createEdges({ name, schema, required }) {
-    var _a;
+function createEdges({ name, schema, required, discriminator, }) {
+    var _a, _b;
     const schemaName = (0, schema_1.getSchemaName)(schema);
+    // if (name === "id") console.log(name, schema, required);
+    if (discriminator !== undefined && discriminator.propertyName === name) {
+        return createPropertyDiscriminator(name, "string", schema, discriminator, required);
+    }
     if (schema.oneOf !== undefined || schema.anyOf !== undefined) {
         return createDetailsNode(name, schemaName, schema, required);
     }
@@ -294,13 +448,21 @@ function createEdges({ name, schema, required }) {
         if (mergedSchemas.additionalProperties !== undefined) {
             return createDetailsNode(name, mergedSchemaName, mergedSchemas, required);
         }
+        // array of objects
+        if (((_a = mergedSchemas.items) === null || _a === void 0 ? void 0 : _a.properties) !== undefined) {
+            return createDetailsNode(name, mergedSchemaName, mergedSchemas, required);
+        }
+        if (mergedSchemas.writeOnly && mergedSchemas.writeOnly === true) {
+            return undefined;
+        }
         return (0, utils_1.create)("SchemaItem", {
             collapsible: false,
             name,
-            required,
+            required: false,
             schemaDescription: mergedSchemas.description,
             schemaName: schemaName,
             qualifierMessage: (0, schema_1.getQualifierMessage)(schema),
+            defaultValue: mergedSchemas.default,
         });
     }
     if (schema.properties !== undefined) {
@@ -310,23 +472,30 @@ function createEdges({ name, schema, required }) {
         return createDetailsNode(name, schemaName, schema, required);
     }
     // array of objects
-    if (((_a = schema.items) === null || _a === void 0 ? void 0 : _a.properties) !== undefined) {
+    if (((_b = schema.items) === null || _b === void 0 ? void 0 : _b.properties) !== undefined) {
         return createDetailsNode(name, schemaName, schema, required);
     }
+    if (schema.writeOnly && schema.writeOnly === true) {
+        return undefined;
+    }
     // primitives and array of non-objects
     return (0, utils_1.create)("SchemaItem", {
         collapsible: false,
         name,
-        required,
+        required: false,
         schemaDescription: schema.description,
         schemaName: schemaName,
         qualifierMessage: (0, schema_1.getQualifierMessage)(schema),
+        defaultValue: schema.default,
     });
 }
 /**
  * Creates a hierarchical level of a schema tree. Nodes produce edges that can branch into sub-nodes with edges, recursively.
  */
 function createNodes(schema) {
+    if (schema.discriminator !== undefined) {
+        return createDiscriminator(schema);
+    }
     if (schema.oneOf !== undefined || schema.anyOf !== undefined) {
         return createAnyOneOf(schema);
     }
@@ -373,15 +542,78 @@ function createNodes(schema) {
     // So far, haven't seen this hit in testing
     return undefined;
 }
-function createSchemaDetails({ title, body, ...rest }) {
+function createResponseSchema({ title, body, ...rest }) {
     if (body === undefined ||
         body.content === undefined ||
         Object.keys(body).length === 0 ||
         Object.keys(body.content).length === 0) {
         return undefined;
     }
-    // NOTE: We just pick a random content-type.
-    // How common is it to have multiple?
+    // Get all MIME types, including vendor-specific
+    const mimeTypes = Object.keys(body.content);
+    if (mimeTypes && mimeTypes.length > 1) {
+        return (0, utils_1.create)("MimeTabs", {
+            groupId: "mime-type",
+            children: mimeTypes.map((mimeType) => {
+                const firstBody = body.content[mimeType].schema;
+                if (firstBody === undefined) {
+                    return undefined;
+                }
+                if (firstBody.properties !== undefined) {
+                    if (Object.keys(firstBody.properties).length === 0) {
+                        return undefined;
+                    }
+                }
+                return (0, utils_1.create)("TabItem", {
+                    label: mimeType,
+                    value: `${mimeType}`,
+                    children: [
+                        (0, createDetails_1.createDetails)({
+                            "data-collapsed": false,
+                            open: true,
+                            ...rest,
+                            children: [
+                                (0, createDetailsSummary_1.createDetailsSummary)({
+                                    style: { textAlign: "left" },
+                                    children: [
+                                        (0, utils_1.create)("strong", { children: `${title}` }),
+                                        (0, utils_1.guard)(firstBody.type === "array", (format) => (0, utils_1.create)("span", {
+                                            style: { opacity: "0.6" },
+                                            children: ` array`,
+                                        })),
+                                        (0, utils_1.guard)(body.required && body.required === true, () => [
+                                            (0, utils_1.create)("strong", {
+                                                style: {
+                                                    fontSize: "var(--ifm-code-font-size)",
+                                                    color: "var(--openapi-required)",
+                                                },
+                                                children: " required",
+                                            }),
+                                        ]),
+                                    ],
+                                }),
+                                (0, utils_1.create)("div", {
+                                    style: { textAlign: "left", marginLeft: "1rem" },
+                                    children: [
+                                        (0, utils_1.guard)(body.description, () => [
+                                            (0, utils_1.create)("div", {
+                                                style: { marginTop: "1rem", marginBottom: "1rem" },
+                                                children: (0, createDescription_1.createDescription)(body.description),
+                                            }),
+                                        ]),
+                                    ],
+                                }),
+                                (0, utils_1.create)("ul", {
+                                    style: { marginLeft: "1rem" },
+                                    children: createNodes(firstBody),
+                                }),
+                            ],
+                        }),
+                    ],
+                });
+            }),
+        });
+    }
     const randomFirstKey = Object.keys(body.content)[0];
     const firstBody = body.content[randomFirstKey].schema;
     if (firstBody === undefined) {
@@ -393,47 +625,56 @@ function createSchemaDetails({ title, body, ...rest }) {
             return undefined;
         }
     }
-    // Root-level schema dropdown
-    return (0, createDetails_1.createDetails)({
-        "data-collapsed": false,
-        open: true,
-        ...rest,
+    return (0, utils_1.create)("MimeTabs", {
         children: [
-            (0, createDetailsSummary_1.createDetailsSummary)({
-                style: { textAlign: "left" },
+            (0, utils_1.create)("TabItem", {
+                label: randomFirstKey,
+                value: `${randomFirstKey}-schema`,
                 children: [
-                    (0, utils_1.create)("strong", { children: `${title}` }),
-                    (0, utils_1.guard)(firstBody.type === "array", (format) => (0, utils_1.create)("span", {
-                        style: { opacity: "0.6" },
-                        children: ` array`,
-                    })),
-                    (0, utils_1.guard)(body.required, () => [
-                        (0, utils_1.create)("strong", {
-                            style: {
-                                fontSize: "var(--ifm-code-font-size)",
-                                color: "var(--openapi-required)",
-                            },
-                            children: " required",
-                        }),
-                    ]),
-                ],
-            }),
-            (0, utils_1.create)("div", {
-                style: { textAlign: "left", marginLeft: "1rem" },
-                children: [
-                    (0, utils_1.guard)(body.description, () => [
-                        (0, utils_1.create)("div", {
-                            style: { marginTop: "1rem", marginBottom: "1rem" },
-                            children: (0, createDescription_1.createDescription)(body.description),
-                        }),
-                    ]),
+                    (0, createDetails_1.createDetails)({
+                        "data-collapsed": false,
+                        open: true,
+                        ...rest,
+                        children: [
+                            (0, createDetailsSummary_1.createDetailsSummary)({
+                                style: { textAlign: "left" },
+                                children: [
+                                    (0, utils_1.create)("strong", { children: `${title}` }),
+                                    (0, utils_1.guard)(firstBody.type === "array", (format) => (0, utils_1.create)("span", {
+                                        style: { opacity: "0.6" },
+                                        children: ` array`,
+                                    })),
+                                    (0, utils_1.guard)(body.required, () => [
+                                        (0, utils_1.create)("strong", {
+                                            style: {
+                                                fontSize: "var(--ifm-code-font-size)",
+                                                color: "var(--openapi-required)",
+                                            },
+                                            children: " required",
+                                        }),
+                                    ]),
+                                ],
+                            }),
+                            (0, utils_1.create)("div", {
+                                style: { textAlign: "left", marginLeft: "1rem" },
+                                children: [
+                                    (0, utils_1.guard)(body.description, () => [
+                                        (0, utils_1.create)("div", {
+                                            style: { marginTop: "1rem", marginBottom: "1rem" },
+                                            children: (0, createDescription_1.createDescription)(body.description),
+                                        }),
+                                    ]),
+                                ],
+                            }),
+                            (0, utils_1.create)("ul", {
+                                style: { marginLeft: "1rem" },
+                                children: createNodes(firstBody),
+                            }),
+                        ],
+                    }),
                 ],
             }),
-            (0, utils_1.create)("ul", {
-                style: { marginLeft: "1rem" },
-                children: createNodes(firstBody),
-            }),
         ],
     });
 }
-exports.createSchemaDetails = createSchemaDetails;
+exports.createResponseSchema = createResponseSchema;

package/lib/markdown/createStatusCodes.js

@@ -8,8 +8,67 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createStatusCodes = void 0;
 const createDescription_1 = require("./createDescription");
-const createSchemaDetails_1 = require("./createSchemaDetails");
+const createDetails_1 = require("./createDetails");
+const createDetailsSummary_1 = require("./createDetailsSummary");
+const createResponseSchema_1 = require("./createResponseSchema");
 const utils_1 = require("./utils");
+const utils_2 = require("./utils");
+function createResponseHeaders(responseHeaders) {
+    return (0, utils_2.guard)(responseHeaders, () => (0, utils_1.create)("ul", {
+        style: { marginLeft: "1rem" },
+        children: [
+            Object.entries(responseHeaders).map(([headerName, headerObj]) => {
+                const { description, schema: { type }, example, } = headerObj;
+                return (0, utils_1.create)("li", {
+                    class: "schemaItem",
+                    children: [
+                        (0, createDetailsSummary_1.createDetailsSummary)({
+                            children: [
+                                (0, utils_1.create)("strong", { children: headerName }),
+                                (0, utils_2.guard)(type, () => [
+                                    (0, utils_1.create)("span", {
+                                        style: { opacity: "0.6" },
+                                        children: ` ${type}`,
+                                    }),
+                                ]),
+                            ],
+                        }),
+                        (0, utils_1.create)("div", {
+                            children: [
+                                (0, utils_2.guard)(description, (description) => (0, utils_1.create)("div", {
+                                    style: {
+                                        marginTop: ".5rem",
+                                        marginBottom: ".5rem",
+                                    },
+                                    children: [
+                                        (0, utils_2.guard)(example, () => `Example: ${example}`),
+                                        (0, createDescription_1.createDescription)(description),
+                                    ],
+                                })),
+                            ],
+                        }),
+                    ],
+                });
+            }),
+        ],
+    }));
+}
+function createResponseExamples(responseExamples) {
+    return Object.entries(responseExamples).map(([exampleName, exampleValue]) => {
+        var _a;
+        const camelToSpaceName = exampleName.replace(/([A-Z])/g, " $1");
+        let finalFormattedName = camelToSpaceName.charAt(0).toUpperCase() + camelToSpaceName.slice(1);
+        return (0, utils_1.create)("TabItem", {
+            label: `${finalFormattedName}`,
+            value: `${finalFormattedName}`,
+            children: [
+                (0, utils_1.create)("ResponseSamples", {
+                    responseExample: JSON.stringify((_a = exampleValue.value) !== null && _a !== void 0 ? _a : exampleValue, null, 2),
+                }),
+            ],
+        });
+    });
+}
 function createStatusCodes({ responses }) {
     if (responses === undefined) {
         return undefined;
@@ -22,6 +81,12 @@ function createStatusCodes({ responses }) {
         children: [
             (0, utils_1.create)("ApiTabs", {
                 children: codes.map((code) => {
+                    const responseHeaders = responses[code].headers;
+                    const responseContent = responses[code].content;
+                    const responseContentKey = responseContent && Object.keys(responseContent)[0];
+                    const responseExamples = responseContentKey &&
+                        (responseContent[responseContentKey].examples ||
+                            responseContent[responseContentKey].example);
                     return (0, utils_1.create)("TabItem", {
                         label: code,
                         value: code,
@@ -29,14 +94,62 @@ function createStatusCodes({ responses }) {
                             (0, utils_1.create)("div", {
                                 children: (0, createDescription_1.createDescription)(responses[code].description),
                             }),
-                            (0, utils_1.create)("div", {
-                                children: (0, createSchemaDetails_1.createSchemaDetails)({
+                            (0, utils_2.guard)(responseExamples, () => (0, utils_1.create)("SchemaTabs", {
+                                children: [
+                                    (0, utils_1.create)("TabTtem", {
+                                        label: "Schema",
+                                        value: "Schema",
+                                        children: [
+                                            responseHeaders &&
+                                                (0, createDetails_1.createDetails)({
+                                                    "data-collaposed": false,
+                                                    open: true,
+                                                    style: { textAlign: "left", marginBottom: "1rem" },
+                                                    children: [
+                                                        (0, createDetailsSummary_1.createDetailsSummary)({
+                                                            children: [
+                                                                (0, utils_1.create)("strong", {
+                                                                    children: "Response Headers",
+                                                                }),
+                                                            ],
+                                                        }),
+                                                        createResponseHeaders(responseHeaders),
+                                                    ],
+                                                }),
+                                            (0, utils_1.create)("div", {
+                                                children: (0, createResponseSchema_1.createResponseSchema)({
+                                                    title: "Schema",
+                                                    body: {
+                                                        content: responses[code].content,
+                                                    },
+                                                }),
+                                            }),
+                                        ],
+                                    }),
+                                    createResponseExamples(responseExamples),
+                                ],
+                            })),
+                            (0, utils_2.guard)(responseHeaders && !responseExamples, () => (0, createDetails_1.createDetails)({
+                                "data-collaposed": false,
+                                open: true,
+                                style: { textAlign: "left" },
+                                children: [
+                                    (0, createDetailsSummary_1.createDetailsSummary)({
+                                        children: [
+                                            (0, utils_1.create)("strong", { children: "Response Headers" }),
+                                        ],
+                                    }),
+                                    createResponseHeaders(responseHeaders),
+                                ],
+                            })),
+                            (0, utils_2.guard)(!responseExamples, () => (0, utils_1.create)("div", {
+                                children: (0, createResponseSchema_1.createResponseSchema)({
                                     title: "Schema",
                                     body: {
                                         content: responses[code].content,
                                     },
                                 }),
-                            }),
+                            })),
                         ],
                     });
                 }),

package/lib/markdown/index.d.ts

@@ -1,4 +1,4 @@
 import { ApiPageMetadata, InfoPageMetadata, TagPageMetadata } from "../types";
 export declare function createApiPageMD({ title, api: { deprecated, "x-deprecated-description": deprecatedDescription, description, parameters, requestBody, responses, }, }: ApiPageMetadata): string;
-export declare function createInfoPageMD({ info: { title, version, description, contact, license, termsOfService }, securitySchemes, }: InfoPageMetadata): string;
+export declare function createInfoPageMD({ info: { title, version, description, contact, license, termsOfService, logo, darkLogo, }, securitySchemes, }: InfoPageMetadata): string;
 export declare function createTagPageMD({ tag: { description } }: TagPageMetadata): string;

package/lib/markdown/index.js

@@ -13,6 +13,7 @@ const createContactInfo_1 = require("./createContactInfo");
 const createDeprecationNotice_1 = require("./createDeprecationNotice");
 const createDescription_1 = require("./createDescription");
 const createLicense_1 = require("./createLicense");
+const createLogo_1 = require("./createLogo");
 const createParamsDetails_1 = require("./createParamsDetails");
 const createRequestBodyDetails_1 = require("./createRequestBodyDetails");
 const createStatusCodes_1 = require("./createStatusCodes");
@@ -21,10 +22,13 @@ const createVersionBadge_1 = require("./createVersionBadge");
 const utils_1 = require("./utils");
 function createApiPageMD({ title, api: { deprecated, "x-deprecated-description": deprecatedDescription, description, parameters, requestBody, responses, }, }) {
     return (0, utils_1.render)([
+        `import ApiTabs from "@theme/ApiTabs";\n`,
+        `import MimeTabs from "@theme/MimeTabs";\n`,
         `import ParamsItem from "@theme/ParamsItem";\n`,
+        `import ResponseSamples from "@theme/ResponseSamples";\n`,
         `import SchemaItem from "@theme/SchemaItem"\n`,
-        `import ApiTabs from "@theme/ApiTabs";\n`,
         `import SchemaTabs from "@theme/SchemaTabs";\n`,
+        `import DiscriminatorTabs from "@theme/DiscriminatorTabs";\n`,
         `import TabItem from "@theme/TabItem";\n\n`,
         `## ${(0, lodash_1.escape)(title)}\n\n`,
         (0, createDeprecationNotice_1.createDeprecationNotice)({ deprecated, description: deprecatedDescription }),
@@ -33,17 +37,22 @@ function createApiPageMD({ title, api: { deprecated, "x-deprecated-description":
         (0, createParamsDetails_1.createParamsDetails)({ parameters, type: "query" }),
         (0, createParamsDetails_1.createParamsDetails)({ parameters, type: "header" }),
         (0, createParamsDetails_1.createParamsDetails)({ parameters, type: "cookie" }),
-        (0, createRequestBodyDetails_1.createRequestBodyDetails)({ title: "Request Body", body: requestBody }),
+        (0, createRequestBodyDetails_1.createRequestBodyDetails)({
+            title: "Request Body",
+            body: requestBody,
+        }),
         (0, createStatusCodes_1.createStatusCodes)({ responses }),
     ]);
 }
 exports.createApiPageMD = createApiPageMD;
-function createInfoPageMD({ info: { title, version, description, contact, license, termsOfService }, securitySchemes, }) {
+function createInfoPageMD({ info: { title, version, description, contact, license, termsOfService, logo, darkLogo, }, securitySchemes, }) {
     return (0, utils_1.render)([
+        `import ApiLogo from "@theme/ApiLogo";\n`,
         `import Tabs from "@theme/Tabs";\n`,
         `import TabItem from "@theme/TabItem";\n\n`,
         (0, createVersionBadge_1.createVersionBadge)(version),
         `# ${(0, lodash_1.escape)(title)}\n\n`,
+        (0, createLogo_1.createLogo)(logo, darkLogo),
         (0, createDescription_1.createDescription)(description),
         (0, createAuthentication_1.createAuthentication)(securitySchemes),
         (0, createContactInfo_1.createContactInfo)(contact),