docusaurus-plugin-openapi-docs 1.5.1 → 1.6.0

package/lib/markdown/createResponseSchema.js

@@ -7,6 +7,7 @@
  * ========================================================================== */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createResponseSchema = exports.mergeAllOf = void 0;
+const createArrayBracket_1 = require("./createArrayBracket");
 const createDescription_1 = require("./createDescription");
 const createDetails_1 = require("./createDetails");
 const createDetailsSummary_1 = require("./createDetailsSummary");
@@ -47,46 +48,55 @@ exports.mergeAllOf = mergeAllOf;
  */
 function createAnyOneOf(schema) {
     const type = schema.oneOf ? "oneOf" : "anyOf";
-    return (0, utils_1.create)("div", {
+    return (0, utils_1.create)("li", {
         children: [
-            (0, utils_1.create)("div", {
-                children: [
-                    (0, utils_1.create)("span", {
-                        className: "badge badge--info",
-                        children: type,
-                    }),
-                    (0, utils_1.create)("SchemaTabs", {
-                        children: schema[type].map((anyOneSchema, index) => {
-                            const label = anyOneSchema.title
-                                ? anyOneSchema.title
-                                : `MOD${index + 1}`;
-                            const anyOneChildren = [];
-                            if (anyOneSchema.properties !== undefined) {
-                                anyOneChildren.push(createProperties(anyOneSchema));
-                            }
-                            if (anyOneSchema.allOf !== undefined) {
-                                anyOneChildren.push(createNodes(anyOneSchema));
-                            }
-                            if (anyOneSchema.items !== undefined) {
-                                anyOneChildren.push(createItems(anyOneSchema));
-                            }
-                            if (anyOneSchema.type === "string" ||
-                                anyOneSchema.type === "number" ||
-                                anyOneSchema.type === "integer" ||
-                                anyOneSchema.type === "boolean") {
-                                anyOneChildren.push(createNodes(anyOneSchema));
-                            }
-                            if (anyOneChildren.length) {
-                                return (0, utils_1.create)("TabItem", {
-                                    label: label,
-                                    value: `${index}-item-properties`,
-                                    children: anyOneChildren,
-                                });
-                            }
-                            return undefined;
-                        }),
-                    }),
-                ],
+            (0, utils_1.create)("span", {
+                className: "badge badge--info",
+                children: type,
+            }),
+            (0, utils_1.create)("SchemaTabs", {
+                children: schema[type].map((anyOneSchema, index) => {
+                    const label = anyOneSchema.title
+                        ? anyOneSchema.title
+                        : `MOD${index + 1}`;
+                    const anyOneChildren = [];
+                    if (anyOneSchema.properties !== undefined) {
+                        anyOneChildren.push(createProperties(anyOneSchema));
+                    }
+                    if (anyOneSchema.allOf !== undefined) {
+                        anyOneChildren.push(createNodes(anyOneSchema));
+                    }
+                    if (anyOneSchema.items !== undefined) {
+                        anyOneChildren.push(createItems(anyOneSchema));
+                    }
+                    if (anyOneSchema.type === "string" ||
+                        anyOneSchema.type === "number" ||
+                        anyOneSchema.type === "integer" ||
+                        anyOneSchema.type === "boolean") {
+                        anyOneChildren.push(createNodes(anyOneSchema));
+                    }
+                    if (anyOneChildren.length) {
+                        if (schema.type === "array") {
+                            return (0, utils_1.create)("TabItem", {
+                                label: label,
+                                value: `${index}-item-properties`,
+                                children: [
+                                    (0, createArrayBracket_1.createOpeningArrayBracket)(),
+                                    anyOneChildren,
+                                    (0, createArrayBracket_1.createClosingArrayBracket)(),
+                                ]
+                                    .filter(Boolean)
+                                    .flat(),
+                            });
+                        }
+                        return (0, utils_1.create)("TabItem", {
+                            label: label,
+                            value: `${index}-item-properties`,
+                            children: anyOneChildren,
+                        });
+                    }
+                    return undefined;
+                }),
             }),
         ],
     });
@@ -189,15 +199,27 @@ function createAdditionalProperties(schema) {
 }
 // TODO: figure out how to handle array of objects
 function createItems(schema) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
     if (((_a = schema.items) === null || _a === void 0 ? void 0 : _a.properties) !== undefined) {
-        return createProperties(schema.items);
+        return [
+            (0, createArrayBracket_1.createOpeningArrayBracket)(),
+            createProperties(schema.items),
+            (0, createArrayBracket_1.createClosingArrayBracket)(),
+        ].flat();
     }
     if (((_b = schema.items) === null || _b === void 0 ? void 0 : _b.additionalProperties) !== undefined) {
-        return createAdditionalProperties(schema.items);
+        return [
+            (0, createArrayBracket_1.createOpeningArrayBracket)(),
+            createAdditionalProperties(schema.items),
+            (0, createArrayBracket_1.createClosingArrayBracket)(),
+        ].flat();
     }
     if (((_c = schema.items) === null || _c === void 0 ? void 0 : _c.oneOf) !== undefined || ((_d = schema.items) === null || _d === void 0 ? void 0 : _d.anyOf) !== undefined) {
-        return createAnyOneOf(schema.items);
+        return [
+            (0, createArrayBracket_1.createOpeningArrayBracket)(),
+            createAnyOneOf(schema.items),
+            (0, createArrayBracket_1.createClosingArrayBracket)(),
+        ].flat();
     }
     if (((_e = schema.items) === null || _e === void 0 ? void 0 : _e.allOf) !== undefined) {
         // TODO: figure out if and how we should pass merged required array
@@ -206,41 +228,54 @@ function createItems(schema) {
         if ((mergedSchemas.oneOf !== undefined ||
             mergedSchemas.anyOf !== undefined) &&
             mergedSchemas.properties) {
-            return (0, utils_1.create)("div", {
-                children: [
-                    createAnyOneOf(mergedSchemas),
-                    createProperties(mergedSchemas),
-                ],
-            });
+            return [
+                (0, createArrayBracket_1.createOpeningArrayBracket)(),
+                createAnyOneOf(mergedSchemas),
+                createProperties(mergedSchemas),
+                (0, createArrayBracket_1.createClosingArrayBracket)(),
+            ].flat();
         }
         // Handles only anyOf/oneOf
         if (mergedSchemas.oneOf !== undefined ||
             mergedSchemas.anyOf !== undefined) {
-            return (0, utils_1.create)("div", {
-                children: [createAnyOneOf(mergedSchemas)],
-            });
+            return [
+                (0, createArrayBracket_1.createOpeningArrayBracket)(),
+                createAnyOneOf(mergedSchemas),
+                (0, createArrayBracket_1.createClosingArrayBracket)(),
+            ].flat();
         }
         // Handles properties
         if (mergedSchemas.properties !== undefined) {
-            return (0, utils_1.create)("div", {
-                children: [createProperties(mergedSchemas)],
-            });
+            return [
+                (0, createArrayBracket_1.createOpeningArrayBracket)(),
+                createProperties(mergedSchemas),
+                (0, createArrayBracket_1.createClosingArrayBracket)(),
+            ].flat();
         }
     }
     if (((_g = schema.items) === null || _g === void 0 ? void 0 : _g.type) === "string" ||
         ((_h = schema.items) === null || _h === void 0 ? void 0 : _h.type) === "number" ||
         ((_j = schema.items) === null || _j === void 0 ? void 0 : _j.type) === "integer" ||
-        ((_k = schema.items) === null || _k === void 0 ? void 0 : _k.type) === "boolean") {
-        return createNodes(schema.items);
+        ((_k = schema.items) === null || _k === void 0 ? void 0 : _k.type) === "boolean" ||
+        ((_l = schema.items) === null || _l === void 0 ? void 0 : _l.type) === "object") {
+        return [
+            (0, createArrayBracket_1.createOpeningArrayBracket)(),
+            createNodes(schema.items),
+            (0, createArrayBracket_1.createClosingArrayBracket)(),
+        ].flat();
     }
     // TODO: clean this up or eliminate it?
-    return Object.entries(schema.items).map(([key, val]) => createEdges({
-        name: key,
-        schema: val,
-        required: Array.isArray(schema.required)
-            ? schema.required.includes(key)
-            : false,
-    }));
+    return [
+        (0, createArrayBracket_1.createOpeningArrayBracket)(),
+        Object.entries(schema.items).map(([key, val]) => createEdges({
+            name: key,
+            schema: val,
+            required: Array.isArray(schema.required)
+                ? schema.required.includes(key)
+                : false,
+        })),
+        (0, createArrayBracket_1.createClosingArrayBracket)(),
+    ].flat();
 }
 /**
  * For handling discriminators that do not map to a same-level property
@@ -339,7 +374,7 @@ function createItems(schema) {
 //     }),
 //   });
 // }
-function createDetailsNode(name, schemaName, schema, required) {
+function createDetailsNode(name, schemaName, schema, required, nullable) {
     return (0, utils_1.create)("SchemaItem", {
         collapsible: true,
         className: "schemaItem",
@@ -353,7 +388,19 @@ function createDetailsNode(name, schemaName, schema, required) {
                                 style: { opacity: "0.6" },
                                 children: ` ${schemaName}`,
                             }),
-                            (0, utils_1.guard)(schema.required && schema.required === true, () => [
+                            (0, utils_1.guard)((schema.nullable && schema.nullable === true) ||
+                                (nullable && nullable === true), () => [
+                                (0, utils_1.create)("strong", {
+                                    style: {
+                                        fontSize: "var(--ifm-code-font-size)",
+                                        color: "var(--openapi-nullable)",
+                                    },
+                                    children: " nullable",
+                                }),
+                            ]),
+                            (0, utils_1.guard)(Array.isArray(required)
+                                ? required.includes(name)
+                                : required === true, () => [
                                 (0, utils_1.create)("strong", {
                                     style: {
                                         fontSize: "var(--ifm-code-font-size)",
@@ -453,24 +500,24 @@ function createEdges({ name, schema, required, discriminator, }) {
         return createPropertyDiscriminator(name, "string", schema, discriminator, required);
     }
     if (schema.oneOf !== undefined || schema.anyOf !== undefined) {
-        return createDetailsNode(name, schemaName, schema, required);
+        return createDetailsNode(name, schemaName, schema, required, schema.nullable);
     }
     if (schema.allOf !== undefined) {
         const { mergedSchemas, required, } = mergeAllOf(schema.allOf);
         const mergedSchemaName = (0, schema_1.getSchemaName)(mergedSchemas);
         if (mergedSchemas.oneOf !== undefined ||
             mergedSchemas.anyOf !== undefined) {
-            return createDetailsNode(name, mergedSchemaName, mergedSchemas, required);
+            return createDetailsNode(name, mergedSchemaName, mergedSchemas, required, schema.nullable);
         }
         if (mergedSchemas.properties !== undefined) {
-            return createDetailsNode(name, mergedSchemaName, mergedSchemas, required);
+            return createDetailsNode(name, mergedSchemaName, mergedSchemas, required, schema.nullable);
         }
         if (mergedSchemas.additionalProperties !== undefined) {
-            return createDetailsNode(name, mergedSchemaName, mergedSchemas, required);
+            return createDetailsNode(name, mergedSchemaName, mergedSchemas, required, schema.nullable);
         }
         // array of objects
         if (((_a = mergedSchemas.items) === null || _a === void 0 ? void 0 : _a.properties) !== undefined) {
-            return createDetailsNode(name, mergedSchemaName, mergedSchemas, required);
+            return createDetailsNode(name, mergedSchemaName, mergedSchemas, required, schema.nullable);
         }
         if (mergedSchemas.writeOnly && mergedSchemas.writeOnly === true) {
             return undefined;
@@ -479,25 +526,23 @@ function createEdges({ name, schema, required, discriminator, }) {
             collapsible: false,
             name,
             required: false,
-            deprecated: mergedSchemas.deprecated,
-            schemaDescription: mergedSchemas.description,
             schemaName: schemaName,
             qualifierMessage: (0, schema_1.getQualifierMessage)(schema),
-            defaultValue: mergedSchemas.default,
+            schema: mergedSchemas,
         });
     }
     if (schema.properties !== undefined) {
-        return createDetailsNode(name, schemaName, schema, required);
+        return createDetailsNode(name, schemaName, schema, required, schema.nullable);
     }
     if (schema.additionalProperties !== undefined) {
-        return createDetailsNode(name, schemaName, schema, required);
+        return createDetailsNode(name, schemaName, schema, required, schema.nullable);
     }
     // array of objects
     if (((_b = schema.items) === null || _b === void 0 ? void 0 : _b.properties) !== undefined) {
-        return createDetailsNode(name, schemaName, schema, required);
+        return createDetailsNode(name, schemaName, schema, required, schema.nullable);
     }
     if (((_c = schema.items) === null || _c === void 0 ? void 0 : _c.anyOf) !== undefined || ((_d = schema.items) === null || _d === void 0 ? void 0 : _d.oneOf) !== undefined) {
-        return createDetailsNode(name, schemaName, schema, required);
+        return createDetailsNode(name, schemaName, schema, required, schema.nullable);
     }
     if (schema.writeOnly && schema.writeOnly === true) {
         return undefined;
@@ -507,40 +552,43 @@ function createEdges({ name, schema, required, discriminator, }) {
         collapsible: false,
         name,
         required: false,
-        deprecated: schema.deprecated,
-        schemaDescription: schema.description,
         schemaName: schemaName,
         qualifierMessage: (0, schema_1.getQualifierMessage)(schema),
-        defaultValue: schema.default,
+        schema: schema,
     });
 }
 /**
  * Creates a hierarchical level of a schema tree. Nodes produce edges that can branch into sub-nodes with edges, recursively.
  */
 function createNodes(schema) {
+    const nodes = [];
     // if (schema.discriminator !== undefined) {
     //   return createDiscriminator(schema);
     // }
     if (schema.oneOf !== undefined || schema.anyOf !== undefined) {
-        return createAnyOneOf(schema);
+        nodes.push(createAnyOneOf(schema));
     }
     if (schema.allOf !== undefined) {
         const { mergedSchemas } = mergeAllOf(schema.allOf);
-        // allOf seems to always result in properties
         if (mergedSchemas.properties !== undefined) {
-            return createProperties(mergedSchemas);
+            nodes.push(createProperties(mergedSchemas));
+        }
+        if (mergedSchemas.items !== undefined) {
+            nodes.push(createItems(mergedSchemas));
         }
     }
     if (schema.properties !== undefined) {
-        return createProperties(schema);
+        nodes.push(createProperties(schema));
     }
-    // Could be set to false to just check if evals to true
-    if (schema.additionalProperties) {
-        return createAdditionalProperties(schema);
+    if (schema.additionalProperties !== undefined) {
+        nodes.push(createAdditionalProperties(schema));
     }
     // TODO: figure out how to handle array of objects
     if (schema.items !== undefined) {
-        return createItems(schema);
+        nodes.push(createItems(schema));
+    }
+    if (nodes.length && nodes.length > 0) {
+        return nodes.filter(Boolean).flat();
     }
     // primitive
     if (schema.type !== undefined) {
@@ -566,7 +614,7 @@ function createNodes(schema) {
     }
     // Unknown node/schema type should return undefined
     // So far, haven't seen this hit in testing
-    return undefined;
+    return "any";
 }
 function createResponseSchema({ title, body, ...rest }) {
     if (body === undefined ||
@@ -581,9 +629,10 @@ function createResponseSchema({ title, body, ...rest }) {
         return (0, utils_1.create)("MimeTabs", {
             schemaType: "response",
             children: mimeTypes.map((mimeType) => {
+                var _a;
                 const responseExamples = body.content[mimeType].examples;
                 const responseExample = body.content[mimeType].example;
-                const firstBody = body.content[mimeType].schema;
+                const firstBody = (_a = body.content[mimeType].schema) !== null && _a !== void 0 ? _a : body.content[mimeType];
                 if (firstBody === undefined &&
                     responseExample === undefined &&
                     responseExamples === undefined) {
@@ -616,10 +665,6 @@ function createResponseSchema({ title, body, ...rest }) {
                                                         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: {

package/lib/markdown/createStatusCodes.js

@@ -66,7 +66,9 @@ function createResponseHeaders(responseHeaders) {
         style: { marginLeft: "1rem" },
         children: [
             Object.entries(responseHeaders).map(([headerName, headerObj]) => {
-                const { description, schema: { type }, example, } = headerObj;
+                var _a, _b;
+                const { description, example } = headerObj;
+                const type = (_b = (_a = headerObj.schema) === null || _a === void 0 ? void 0 : _a.type) !== null && _b !== void 0 ? _b : "any";
                 return (0, utils_1.create)("li", {
                     className: "schemaItem",
                     children: [
@@ -110,12 +112,10 @@ function createResponseExamples(responseExamples, mimeType) {
         language = "xml";
     }
     return Object.entries(responseExamples).map(([exampleName, exampleValue]) => {
-        const camelToSpaceName = exampleName.replace(/([A-Z])/g, " $1");
-        let finalFormattedName = camelToSpaceName.charAt(0).toUpperCase() + camelToSpaceName.slice(1);
         if (typeof exampleValue.value === "object") {
             return (0, utils_1.create)("TabItem", {
-                label: `${finalFormattedName}`,
-                value: `${finalFormattedName}`,
+                label: `${exampleName}`,
+                value: `${exampleName}`,
                 children: [
                     (0, utils_2.guard)(exampleValue.summary, (summary) => [
                         (0, utils_1.create)("p", {
@@ -130,8 +130,8 @@ function createResponseExamples(responseExamples, mimeType) {
             });
         }
         return (0, utils_1.create)("TabItem", {
-            label: `${finalFormattedName}`,
-            value: `${finalFormattedName}`,
+            label: `${exampleName}`,
+            value: `${exampleName}`,
             children: [
                 (0, utils_2.guard)(exampleValue.summary, (summary) => [
                     (0, utils_1.create)("p", {

package/lib/markdown/index.js

@@ -48,7 +48,7 @@ exports.createApiPageMD = createApiPageMD;
 function createInfoPageMD({ info: { title, version, description, contact, license, termsOfService, logo, darkLogo, }, securitySchemes, downloadUrl, }) {
     return (0, utils_1.render)([
         `import ApiLogo from "@theme/ApiLogo";\n`,
-        `import Tabs from "@theme/Tabs";\n`,
+        `import SchemaTabs from "@theme/SchemaTabs";\n`,
         `import TabItem from "@theme/TabItem";\n`,
         `import Export from "@theme/ApiDemoPanel/Export";\n\n`,
         (0, createVersionBadge_1.createVersionBadge)(version),

package/lib/openapi/createRequestExample.js

@@ -11,13 +11,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.sampleRequestFromSchema = void 0;
 const chalk_1 = __importDefault(require("chalk"));
+const merge_1 = __importDefault(require("lodash/merge"));
 const createRequestSchema_1 = require("../markdown/createRequestSchema");
 const primitives = {
     string: {
         default: () => "string",
         email: () => "user@example.com",
         date: () => new Date().toISOString().substring(0, 10),
-        "date-time": () => new Date().toISOString().substring(0, 10),
+        "date-time": () => new Date().toISOString(),
         uuid: () => "3fa85f64-5717-4562-b3fc-2c963f66afa6",
         hostname: () => "example.com",
         ipv4: () => "198.51.100.42",
@@ -60,15 +61,27 @@ function sampleRequestFromProp(name, prop, obj) {
 }
 const sampleRequestFromSchema = (schema = {}) => {
     try {
-        let { type, example, allOf, properties, items, oneOf, anyOf } = schema;
+        // deep copy schema before processing
+        let schemaCopy = JSON.parse(JSON.stringify(schema));
+        let { type, example, allOf, properties, items, oneOf, anyOf } = schemaCopy;
         if (example !== undefined) {
             return example;
         }
         if (oneOf) {
+            if (properties) {
+                const combinedSchemas = (0, merge_1.default)(schemaCopy, oneOf[0]);
+                delete combinedSchemas.oneOf;
+                return (0, exports.sampleRequestFromSchema)(combinedSchemas);
+            }
             // Just go with first schema
             return (0, exports.sampleRequestFromSchema)(oneOf[0]);
         }
         if (anyOf) {
+            if (properties) {
+                const combinedSchemas = (0, merge_1.default)(schemaCopy, anyOf[0]);
+                delete combinedSchemas.anyOf;
+                return (0, exports.sampleRequestFromSchema)(combinedSchemas);
+            }
             // Just go with first schema
             return (0, exports.sampleRequestFromSchema)(anyOf[0]);
         }
@@ -81,6 +94,11 @@ const sampleRequestFromSchema = (schema = {}) => {
                     }
                 }
             }
+            if (properties) {
+                const combinedSchemas = (0, merge_1.default)(schemaCopy, mergedSchemas);
+                delete combinedSchemas.allOf;
+                return (0, exports.sampleRequestFromSchema)(combinedSchemas);
+            }
             return (0, exports.sampleRequestFromSchema)(mergedSchemas);
         }
         if (!type) {
@@ -133,16 +151,17 @@ const sampleRequestFromSchema = (schema = {}) => {
             }
             return [(0, exports.sampleRequestFromSchema)(items)];
         }
-        if (schema.enum) {
-            if (schema.default) {
-                return schema.default;
+        if (schemaCopy.enum) {
+            if (schemaCopy.default) {
+                return schemaCopy.default;
             }
-            return normalizeArray(schema.enum)[0];
+            return normalizeArray(schemaCopy.enum)[0];
         }
-        if ((schema.readOnly && schema.readOnly === true) || schema.deprecated) {
+        if ((schema.readOnly && schema.readOnly === true) ||
+            schemaCopy.deprecated) {
             return undefined;
         }
-        return primitive(schema);
+        return primitive(schemaCopy);
     }
     catch (err) {
         console.error(chalk_1.default.yellow("WARNING: failed to create example from schema object:", err));

package/lib/openapi/createResponseExample.js

@@ -11,13 +11,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.sampleResponseFromSchema = void 0;
 const chalk_1 = __importDefault(require("chalk"));
+const merge_1 = __importDefault(require("lodash/merge"));
 const createResponseSchema_1 = require("../markdown/createResponseSchema");
 const primitives = {
     string: {
         default: () => "string",
         email: () => "user@example.com",
         date: () => new Date().toISOString().substring(0, 10),
-        "date-time": () => new Date().toISOString().substring(0, 10),
+        "date-time": () => new Date().toISOString(),
         uuid: () => "3fa85f64-5717-4562-b3fc-2c963f66afa6",
         hostname: () => "example.com",
         ipv4: () => "198.51.100.42",
@@ -60,7 +61,9 @@ function sampleResponseFromProp(name, prop, obj) {
 }
 const sampleResponseFromSchema = (schema = {}) => {
     try {
-        let { type, example, allOf, oneOf, anyOf, properties, items } = schema;
+        // deep copy schema before processing
+        let schemaCopy = JSON.parse(JSON.stringify(schema));
+        let { type, example, allOf, properties, items, oneOf, anyOf } = schemaCopy;
         if (example !== undefined) {
             return example;
         }
@@ -74,13 +77,28 @@ const sampleResponseFromSchema = (schema = {}) => {
                     }
                 }
             }
+            if (properties) {
+                const combinedSchemas = (0, merge_1.default)(schemaCopy, mergedSchemas);
+                delete combinedSchemas.allOf;
+                return (0, exports.sampleResponseFromSchema)(combinedSchemas);
+            }
             return (0, exports.sampleResponseFromSchema)(mergedSchemas);
         }
         if (oneOf) {
+            if (properties) {
+                const combinedSchemas = (0, merge_1.default)(schemaCopy, oneOf[0]);
+                delete combinedSchemas.oneOf;
+                return (0, exports.sampleResponseFromSchema)(combinedSchemas);
+            }
             // Just go with first schema
             return (0, exports.sampleResponseFromSchema)(oneOf[0]);
         }
         if (anyOf) {
+            if (properties) {
+                const combinedSchemas = (0, merge_1.default)(schemaCopy, anyOf[0]);
+                delete combinedSchemas.anyOf;
+                return (0, exports.sampleResponseFromSchema)(combinedSchemas);
+            }
             // Just go with first schema
             return (0, exports.sampleResponseFromSchema)(anyOf[0]);
         }
@@ -134,16 +152,17 @@ const sampleResponseFromSchema = (schema = {}) => {
             }
             return [(0, exports.sampleResponseFromSchema)(items)];
         }
-        if (schema.enum) {
-            if (schema.default) {
-                return schema.default;
+        if (schemaCopy.enum) {
+            if (schemaCopy.default) {
+                return schemaCopy.default;
             }
-            return normalizeArray(schema.enum)[0];
+            return normalizeArray(schemaCopy.enum)[0];
         }
-        if ((schema.writeOnly && schema.writeOnly === true) || schema.deprecated) {
+        if ((schemaCopy.writeOnly && schemaCopy.writeOnly === true) ||
+            schemaCopy.deprecated) {
             return undefined;
         }
-        return primitive(schema);
+        return primitive(schemaCopy);
     }
     catch (err) {
         console.error(chalk_1.default.yellow("WARNING: failed to create example from schema object:", err));

package/lib/openapi/openapi.js

@@ -66,7 +66,7 @@ function createItems(openapiData, options, sidebarOptions) {
     let items = [];
     const infoIdSpaces = openapiData.info.title.replace(" ", "-").toLowerCase();
     const infoId = (0, kebabCase_1.default)(infoIdSpaces);
-    if (openapiData.info.description) {
+    if (openapiData.info.description || openapiData.info.title) {
         // Only create an info page if we have a description.
         const infoDescription = (_a = openapiData.info) === null || _a === void 0 ? void 0 : _a.description;
         let splitDescription;
@@ -173,6 +173,9 @@ function createItems(openapiData, options, sidebarOptions) {
                             .replace(/\s+$/, "")
                         : "",
                     ...((options === null || options === void 0 ? void 0 : options.proxy) && { proxy: options.proxy }),
+                    ...((options === null || options === void 0 ? void 0 : options.hideSendButton) && {
+                        hide_send_button: options.hideSendButton,
+                    }),
                 },
                 api: {
                     ...defaults,
@@ -264,6 +267,9 @@ function createItems(openapiData, options, sidebarOptions) {
                             .replace(/\s+$/, "")
                         : "",
                     ...((options === null || options === void 0 ? void 0 : options.proxy) && { proxy: options.proxy }),
+                    ...((options === null || options === void 0 ? void 0 : options.hideSendButton) && {
+                        hide_send_button: options.hideSendButton,
+                    }),
                 },
                 api: {
                     ...defaults,

package/lib/openapi/utils/loadAndResolveSpec.js

@@ -114,6 +114,19 @@ async function loadAndResolveSpec(specUrlOrObject) {
     // Force dereference ?
     // bundleOpts["dereference"] = true;
     const { bundle: { parsed }, } = await (0, openapi_core_1.bundle)(bundleOpts);
+    //Pre-processing before resolving JSON refs
+    if (parsed.components) {
+        for (let [component, type] of Object.entries(parsed.components)) {
+            if (component === "schemas") {
+                for (let [schemaKey, schemaValue] of Object.entries(type)) {
+                    const title = schemaValue["title"];
+                    if (!title) {
+                        schemaValue.title = schemaKey;
+                    }
+                }
+            }
+        }
+    }
     const resolved = await resolveJsonRefs(parsed);
     // Force serialization and replace circular $ref pointers
     // @ts-ignore

package/lib/options.js

@@ -25,6 +25,7 @@ exports.OptionsSchema = utils_validation_1.Joi.object({
         outputDir: utils_validation_1.Joi.string().required(),
         template: utils_validation_1.Joi.string(),
         downloadUrl: utils_validation_1.Joi.string(),
+        hideSendButton: utils_validation_1.Joi.boolean(),
         sidebarOptions: sidebarOptions,
         version: utils_validation_1.Joi.string().when("versions", {
             is: utils_validation_1.Joi.exist(),