docusaurus-plugin-openapi-docs 0.0.0-417 → 0.0.0-420

package/lib/markdown/createRequestBodyDetails.d.ts

@@ -1,6 +1,13 @@
+import { MediaTypeObject } from "../openapi/types";
 interface Props {
     title: string;
-    body: any;
+    body: {
+        content?: {
+            [key: string]: MediaTypeObject;
+        };
+        description?: string;
+        required?: boolean;
+    };
 }
-export declare function createRequestBodyDetails({ title, body }: Props): string | undefined;
+export declare function createRequestBodyDetails({ title, body }: Props): any;
 export {};

package/lib/markdown/createSchemaDetails.d.ts

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

package/lib/markdown/createSchemaDetails.js

@@ -192,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) &&
@@ -331,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)",
@@ -427,6 +428,7 @@ function createPropertyDiscriminator(name, schemaName, schema, discriminator, re
 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);
     }
@@ -453,7 +455,7 @@ function createEdges({ name, schema, required, discriminator, }) {
         return (0, utils_1.create)("SchemaItem", {
             collapsible: false,
             name,
-            required,
+            required: Array.isArray(required) ? required.includes(name) : required,
             schemaDescription: mergedSchemas.description,
             schemaName: schemaName,
             qualifierMessage: (0, schema_1.getQualifierMessage)(schema),
@@ -474,7 +476,7 @@ function createEdges({ name, schema, required, discriminator, }) {
     return (0, utils_1.create)("SchemaItem", {
         collapsible: false,
         name,
-        required,
+        required: Array.isArray(required) ? required.includes(name) : required,
         schemaDescription: schema.description,
         schemaName: schemaName,
         qualifierMessage: (0, schema_1.getQualifierMessage)(schema),
@@ -541,8 +543,71 @@ function createSchemaDetails({ title, body, ...rest }) {
         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) {
@@ -554,46 +619,55 @@ 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),
-            }),
         ],
     });
 }

package/lib/markdown/index.js

@@ -23,6 +23,7 @@ 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`,
@@ -36,7 +37,10 @@ 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 }),
     ]);
 }

package/lib/openapi/openapi.js

@@ -59,7 +59,7 @@ async function createPostmanCollection(openapiData) {
     return await jsonToCollection(data);
 }
 function createItems(openapiData, sidebarOptions) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
     // TODO: Find a better way to handle this
     let items = [];
     const infoId = (0, kebabCase_1.default)(openapiData.info.title);
@@ -136,6 +136,17 @@ function createItems(openapiData, sidebarOptions) {
             if (body === null || body === void 0 ? void 0 : body.schema) {
                 jsonRequestBodyExample = (0, createExample_1.sampleFromSchema)(body.schema);
             }
+            // Handle vendor JSON media types
+            const bodyContent = (_q = operationObject.requestBody) === null || _q === void 0 ? void 0 : _q.content;
+            if (bodyContent) {
+                const firstBodyContentKey = Object.keys(bodyContent)[0];
+                if (firstBodyContentKey.endsWith("+json")) {
+                    const firstBody = bodyContent[firstBodyContentKey];
+                    if (firstBody === null || firstBody === void 0 ? void 0 : firstBody.schema) {
+                        jsonRequestBodyExample = (0, createExample_1.sampleFromSchema)(firstBody.schema);
+                    }
+                }
+            }
             // TODO: Don't include summary temporarilly
             const { summary, ...defaults } = operationObject;
             const apiPage = {
@@ -148,7 +159,7 @@ function createItems(openapiData, sidebarOptions) {
                 frontMatter: {},
                 api: {
                     ...defaults,
-                    tags: (_q = operationObject.tags) === null || _q === void 0 ? void 0 : _q.map((tagName) => { var _a; return getTagDisplayName(tagName, (_a = openapiData.tags) !== null && _a !== void 0 ? _a : []); }),
+                    tags: (_r = operationObject.tags) === null || _r === void 0 ? void 0 : _r.map((tagName) => { var _a; return getTagDisplayName(tagName, (_a = openapiData.tags) !== null && _a !== void 0 ? _a : []); }),
                     method,
                     path,
                     servers,
@@ -248,7 +259,7 @@ async function processOpenapiFiles(files, sidebarOptions) {
         // Remove undefined tags due to transient parsing errors
         return x !== undefined;
     });
-    return [items, tags];
+    return [items, tags[0]];
 }
 exports.processOpenapiFiles = processOpenapiFiles;
 async function processOpenapiFile(openapiData, sidebarOptions) {

package/lib/sidebars/index.js

@@ -33,9 +33,16 @@ function groupByTags(items, sidebarOptions, options, tags, docPath) {
         };
     });
     // TODO: make sure we only take the first tag
-    const apiTags = (0, uniq_1.default)(apiItems
+    const operationTags = (0, uniq_1.default)(apiItems
         .flatMap((item) => item.api.tags)
         .filter((item) => !!item));
+    const apiTags = [];
+    // eslint-disable-next-line array-callback-return
+    tags.map((tag) => {
+        if (operationTags.includes(tag.name)) {
+            apiTags.push(tag.name);
+        }
+    });
     const basePath = docPath
         ? outputDir.split(docPath)[1].replace(/^\/+/g, "")
         : outputDir.slice(outputDir.indexOf("/", 1)).replace(/^\/+/g, "");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docusaurus-plugin-openapi-docs",
   "description": "OpenAPI plugin for Docusaurus.",
-  "version": "0.0.0-417",
+  "version": "0.0.0-420",
   "license": "MIT",
   "keywords": [
     "openapi",
@@ -67,5 +67,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "ba966845b63e38ad91bfdef96905f353ef6edac5"
+  "gitHead": "d3a62f626be0bc127f6d9f3534a20e8a1ff84192"
 }

package/src/markdown/createRequestBodyDetails.ts

@@ -5,13 +5,20 @@
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
 
+import { MediaTypeObject } from "../openapi/types";
 import { createSchemaDetails } from "./createSchemaDetails";
 
 interface Props {
   title: string;
-  body: any;
+  body: {
+    content?: {
+      [key: string]: MediaTypeObject;
+    };
+    description?: string;
+    required?: boolean;
+  };
 }
 
-export function createRequestBodyDetails({ title, body }: Props) {
+export function createRequestBodyDetails({ title, body }: Props): any {
   return createSchemaDetails({ title, body });
 }

package/src/markdown/createSchemaDetails.ts

@@ -227,8 +227,12 @@ function createItems(schema: SchemaObject) {
   }
 
   if (schema.items?.allOf !== undefined) {
-    const { mergedSchemas }: { mergedSchemas: SchemaObject; required: any } =
-      mergeAllOf(schema.items?.allOf);
+    // TODO: figure out if and how we should pass merged required array
+    const {
+      mergedSchemas,
+    }: { mergedSchemas: SchemaObject; required: string[] } = mergeAllOf(
+      schema.items?.allOf
+    );
 
     // Handles combo anyOf/oneOf + properties
     if (
@@ -387,7 +391,7 @@ function createDetailsNode(
   name: string,
   schemaName: string,
   schema: SchemaObject,
-  required: any
+  required: string[] | boolean
 ): any {
   return create("SchemaItem", {
     collapsible: true,
@@ -402,7 +406,7 @@ function createDetailsNode(
                 style: { opacity: "0.6" },
                 children: ` ${schemaName}`,
               }),
-              guard(required, () => [
+              guard(schema.required && schema.required === true, () => [
                 create("strong", {
                   style: {
                     fontSize: "var(--ifm-code-font-size)",
@@ -446,7 +450,7 @@ function createPropertyDiscriminator(
   schemaName: string,
   schema: SchemaObject,
   discriminator: any,
-  required: any
+  required: string[] | boolean
 ): any {
   if (schema === undefined) {
     return undefined;
@@ -515,7 +519,7 @@ function createPropertyDiscriminator(
 interface EdgeProps {
   name: string;
   schema: SchemaObject;
-  required: boolean;
+  required: string[] | boolean;
   discriminator?: any | unknown;
 }
 
@@ -530,6 +534,8 @@ function createEdges({
 }: EdgeProps): any {
   const schemaName = getSchemaName(schema);
 
+  // if (name === "id") console.log(name, schema, required);
+
   if (discriminator !== undefined && discriminator.propertyName === name) {
     return createPropertyDiscriminator(
       name,
@@ -548,9 +554,8 @@ function createEdges({
     const {
       mergedSchemas,
       required,
-    }: { mergedSchemas: SchemaObject; required: any } = mergeAllOf(
-      schema.allOf
-    );
+    }: { mergedSchemas: SchemaObject; required: string[] | boolean } =
+      mergeAllOf(schema.allOf);
     const mergedSchemaName = getSchemaName(mergedSchemas);
 
     if (
@@ -576,7 +581,7 @@ function createEdges({
     return create("SchemaItem", {
       collapsible: false,
       name,
-      required,
+      required: Array.isArray(required) ? required.includes(name) : required,
       schemaDescription: mergedSchemas.description,
       schemaName: schemaName,
       qualifierMessage: getQualifierMessage(schema),
@@ -601,7 +606,7 @@ function createEdges({
   return create("SchemaItem", {
     collapsible: false,
     name,
-    required,
+    required: Array.isArray(required) ? required.includes(name) : required,
     schemaDescription: schema.description,
     schemaName: schemaName,
     qualifierMessage: getQualifierMessage(schema),
@@ -685,7 +690,7 @@ interface Props {
       [key: string]: MediaTypeObject;
     };
     description?: string;
-    required?: boolean;
+    required?: string[] | boolean;
   };
 }
 
@@ -699,8 +704,75 @@ export function createSchemaDetails({ title, body, ...rest }: Props) {
     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 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 create("TabItem", {
+          label: mimeType,
+          value: `${mimeType}`,
+          children: [
+            createDetails({
+              "data-collapsed": false,
+              open: true,
+              ...rest,
+              children: [
+                createDetailsSummary({
+                  style: { textAlign: "left" },
+                  children: [
+                    create("strong", { children: `${title}` }),
+                    guard(firstBody.type === "array", (format) =>
+                      create("span", {
+                        style: { opacity: "0.6" },
+                        children: ` array`,
+                      })
+                    ),
+                    guard(body.required && body.required === true, () => [
+                      create("strong", {
+                        style: {
+                          fontSize: "var(--ifm-code-font-size)",
+                          color: "var(--openapi-required)",
+                        },
+                        children: " required",
+                      }),
+                    ]),
+                  ],
+                }),
+                create("div", {
+                  style: { textAlign: "left", marginLeft: "1rem" },
+                  children: [
+                    guard(body.description, () => [
+                      create("div", {
+                        style: { marginTop: "1rem", marginBottom: "1rem" },
+                        children: createDescription(body.description),
+                      }),
+                    ]),
+                  ],
+                }),
+                create("ul", {
+                  style: { marginLeft: "1rem" },
+                  children: createNodes(firstBody),
+                }),
+              ],
+            }),
+          ],
+        });
+      }),
+    });
+  }
+
   const randomFirstKey = Object.keys(body.content)[0];
   const firstBody = body.content[randomFirstKey].schema;
 
@@ -714,49 +786,57 @@ export function createSchemaDetails({ title, body, ...rest }: Props) {
       return undefined;
     }
   }
-
-  // Root-level schema dropdown
-  return createDetails({
-    "data-collapsed": false,
-    open: true,
-    ...rest,
+  return create("MimeTabs", {
     children: [
-      createDetailsSummary({
-        style: { textAlign: "left" },
+      create("TabItem", {
+        label: randomFirstKey,
+        value: `${randomFirstKey}-schema`,
         children: [
-          create("strong", { children: `${title}` }),
-          guard(firstBody.type === "array", (format) =>
-            create("span", {
-              style: { opacity: "0.6" },
-              children: ` array`,
-            })
-          ),
-          guard(body.required, () => [
-            create("strong", {
-              style: {
-                fontSize: "var(--ifm-code-font-size)",
-                color: "var(--openapi-required)",
-              },
-              children: " required",
-            }),
-          ]),
-        ],
-      }),
-      create("div", {
-        style: { textAlign: "left", marginLeft: "1rem" },
-        children: [
-          guard(body.description, () => [
-            create("div", {
-              style: { marginTop: "1rem", marginBottom: "1rem" },
-              children: createDescription(body.description),
-            }),
-          ]),
+          createDetails({
+            "data-collapsed": false,
+            open: true,
+            ...rest,
+            children: [
+              createDetailsSummary({
+                style: { textAlign: "left" },
+                children: [
+                  create("strong", { children: `${title}` }),
+                  guard(firstBody.type === "array", (format) =>
+                    create("span", {
+                      style: { opacity: "0.6" },
+                      children: ` array`,
+                    })
+                  ),
+                  guard(body.required, () => [
+                    create("strong", {
+                      style: {
+                        fontSize: "var(--ifm-code-font-size)",
+                        color: "var(--openapi-required)",
+                      },
+                      children: " required",
+                    }),
+                  ]),
+                ],
+              }),
+              create("div", {
+                style: { textAlign: "left", marginLeft: "1rem" },
+                children: [
+                  guard(body.description, () => [
+                    create("div", {
+                      style: { marginTop: "1rem", marginBottom: "1rem" },
+                      children: createDescription(body.description),
+                    }),
+                  ]),
+                ],
+              }),
+              create("ul", {
+                style: { marginLeft: "1rem" },
+                children: createNodes(firstBody),
+              }),
+            ],
+          }),
         ],
       }),
-      create("ul", {
-        style: { marginLeft: "1rem" },
-        children: createNodes(firstBody),
-      }),
     ],
   });
 }

package/src/markdown/index.ts

@@ -10,6 +10,7 @@ import { escape } from "lodash";
 import {
   ContactObject,
   LicenseObject,
+  MediaTypeObject,
   SecuritySchemeObject,
 } from "../openapi/types";
 import { ApiPageMetadata, InfoPageMetadata, TagPageMetadata } from "../types";
@@ -26,6 +27,17 @@ import { createTermsOfService } from "./createTermsOfService";
 import { createVersionBadge } from "./createVersionBadge";
 import { render } from "./utils";
 
+interface Props {
+  title: string;
+  body: {
+    content?: {
+      [key: string]: MediaTypeObject;
+    };
+    description?: string;
+    required?: boolean;
+  };
+}
+
 export function createApiPageMD({
   title,
   api: {
@@ -39,6 +51,7 @@ export function createApiPageMD({
 }: ApiPageMetadata) {
   return 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`,
@@ -52,7 +65,10 @@ export function createApiPageMD({
     createParamsDetails({ parameters, type: "query" }),
     createParamsDetails({ parameters, type: "header" }),
     createParamsDetails({ parameters, type: "cookie" }),
-    createRequestBodyDetails({ title: "Request Body", body: requestBody }),
+    createRequestBodyDetails({
+      title: "Request Body",
+      body: requestBody,
+    } as Props),
     createStatusCodes({ responses }),
   ]);
 }

package/src/openapi/openapi.ts

@@ -175,6 +175,18 @@ function createItems(
         jsonRequestBodyExample = sampleFromSchema(body.schema);
       }
 
+      // Handle vendor JSON media types
+      const bodyContent = operationObject.requestBody?.content;
+      if (bodyContent) {
+        const firstBodyContentKey = Object.keys(bodyContent)[0];
+        if (firstBodyContentKey.endsWith("+json")) {
+          const firstBody = bodyContent[firstBodyContentKey];
+          if (firstBody?.schema) {
+            jsonRequestBodyExample = sampleFromSchema(firstBody.schema);
+          }
+        }
+      }
+
       // TODO: Don't include summary temporarilly
       const { summary, ...defaults } = operationObject;
 
@@ -326,7 +338,7 @@ export async function processOpenapiFiles(
       // Remove undefined tags due to transient parsing errors
       return x !== undefined;
     });
-  return [items as ApiMetadata[], tags as TagObject[]];
+  return [items as ApiMetadata[], tags[0] as TagObject[]];
 }
 
 export async function processOpenapiFile(

package/src/sidebars/index.ts

@@ -60,11 +60,18 @@ function groupByTags(
   });
 
   // TODO: make sure we only take the first tag
-  const apiTags = uniq(
+  const operationTags = uniq(
     apiItems
       .flatMap((item) => item.api.tags)
       .filter((item): item is string => !!item)
   );
+  const apiTags: string[] = [];
+  // eslint-disable-next-line array-callback-return
+  tags.map((tag) => {
+    if (operationTags.includes(tag.name!)) {
+      apiTags.push(tag.name!);
+    }
+  });
 
   const basePath = docPath
     ? outputDir.split(docPath!)[1].replace(/^\/+/g, "")