docusaurus-plugin-openapi-docs 2.1.0 → 2.1.2

package/lib/markdown/createSchema.js

@@ -521,8 +521,8 @@ function createEdges({ name, schema, required, discriminator, }) {
             collapsible: false,
             name,
             required: Array.isArray(required) ? required.includes(name) : required,
-            schemaName: schemaName,
-            qualifierMessage: (0, schema_1.getQualifierMessage)(schema),
+            schemaName: mergedSchemaName,
+            qualifierMessage: (0, schema_1.getQualifierMessage)(mergedSchemas),
             schema: mergedSchemas,
         });
     }
@@ -610,9 +610,16 @@ function createNodes(schema, schemaType) {
             style: {
                 marginTop: ".5rem",
                 marginBottom: ".5rem",
-                marginLeft: "1rem",
             },
-            children: (0, createDescription_1.createDescription)(schema.type),
+            children: [
+                (0, createDescription_1.createDescription)(schema.type),
+                (0, utils_1.guard)((0, schema_1.getQualifierMessage)(schema), (message) => (0, utils_1.create)("div", {
+                    style: {
+                        paddingTop: "1rem",
+                    },
+                    children: (0, createDescription_1.createDescription)(message),
+                })),
+            ],
         });
     }
     // handle circular references
@@ -621,9 +628,16 @@ function createNodes(schema, schemaType) {
             style: {
                 marginTop: ".5rem",
                 marginBottom: ".5rem",
-                marginLeft: "1rem",
             },
-            children: [(0, createDescription_1.createDescription)(schema)],
+            children: [
+                (0, createDescription_1.createDescription)(schema),
+                (0, utils_1.guard)((0, schema_1.getQualifierMessage)(schema), (message) => (0, utils_1.create)("div", {
+                    style: {
+                        paddingTop: "1rem",
+                    },
+                    children: (0, createDescription_1.createDescription)(message),
+                })),
+            ],
         });
     }
     // Unknown node/schema type should return undefined

package/lib/markdown/schema.js

@@ -35,6 +35,9 @@ function prettyName(schema, circular) {
         return (_d = (_c = schema.xml) === null || _c === void 0 ? void 0 : _c.name) !== null && _d !== void 0 ? _d : schema.type;
         // return schema.type;
     }
+    if (schema.title && schema.type) {
+        return `${schema.title} (${schema.type})`;
+    }
     return (_e = schema.title) !== null && _e !== void 0 ? _e : schema.type;
 }
 function getSchemaName(schema, circular) {

package/lib/markdown/utils.js

@@ -17,7 +17,7 @@ function create(tag, props) {
 }
 exports.create = create;
 function guard(value, cb) {
-    if (!!value) {
+    if (!!value || value === 0) {
         const children = cb(value);
         return render(children);
     }

package/lib/sidebars/index.js

@@ -52,7 +52,7 @@ function groupByTags(items, sidebarOptions, options, tags, docPath) {
             apiTags.push(tag.name);
         }
     });
-    // apiTags = uniq(apiTags.concat(operationTags));
+    apiTags = (0, uniq_1.default)(apiTags.concat(operationTags));
     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": "2.1.0",
+  "version": "2.1.2",
   "license": "MIT",
   "keywords": [
     "openapi",
@@ -36,13 +36,13 @@
     "@types/mustache": "^4.1.2"
   },
   "dependencies": {
-    "@apidevtools/json-schema-ref-parser": "^10.1.0",
+    "@apidevtools/json-schema-ref-parser": "^11.5.4",
     "@docusaurus/plugin-content-docs": ">=2.4.1 <=2.4.3",
     "@docusaurus/utils": ">=2.4.1 <=2.4.3",
     "@docusaurus/utils-validation": ">=2.4.1 <=2.4.3",
     "@paloaltonetworks/openapi-to-postmanv2": "3.1.0-hotfix.1",
     "@paloaltonetworks/postman-collection": "^4.1.0",
-    "@redocly/openapi-core": "^1.0.0-beta.125",
+    "@redocly/openapi-core": "^1.10.5",
     "chalk": "^4.1.2",
     "clsx": "^1.1.1",
     "fs-extra": "^9.0.1",
@@ -60,5 +60,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "9064dd22c8e18125f838fd88caba6364e5484b68"
+  "gitHead": "4bb7040ce39ebe38b2a2837ab0c6a8c477a9a546"
 }

package/src/markdown/__snapshots__/createSchema.test.ts.snap

@@ -35,13 +35,7 @@ Array [
               Array [
             </div>
           </li>
-          <div
-            style={{
-              marginTop: \\".5rem\\",
-              marginBottom: \\".5rem\\",
-              marginLeft: \\"1rem\\",
-            }}
-          >
+          <div style={{ marginTop: \\".5rem\\", marginBottom: \\".5rem\\" }}>
             string
           </div>
           <li>
@@ -57,35 +51,17 @@ Array [
           </li>
         </TabItem>
         <TabItem label={\\"MOD3\\"} value={\\"2-item-properties\\"}>
-          <div
-            style={{
-              marginTop: \\".5rem\\",
-              marginBottom: \\".5rem\\",
-              marginLeft: \\"1rem\\",
-            }}
-          >
+          <div style={{ marginTop: \\".5rem\\", marginBottom: \\".5rem\\" }}>
             boolean
           </div>
         </TabItem>
         <TabItem label={\\"MOD4\\"} value={\\"3-item-properties\\"}>
-          <div
-            style={{
-              marginTop: \\".5rem\\",
-              marginBottom: \\".5rem\\",
-              marginLeft: \\"1rem\\",
-            }}
-          >
+          <div style={{ marginTop: \\".5rem\\", marginBottom: \\".5rem\\" }}>
             number
           </div>
         </TabItem>
         <TabItem label={\\"MOD5\\"} value={\\"4-item-properties\\"}>
-          <div
-            style={{
-              marginTop: \\".5rem\\",
-              marginBottom: \\".5rem\\",
-              marginLeft: \\"1rem\\",
-            }}
-          >
+          <div style={{ marginTop: \\".5rem\\", marginBottom: \\".5rem\\" }}>
             string
           </div>
         </TabItem>

package/src/markdown/createSchema.ts

@@ -624,7 +624,6 @@ function createEdges({
     }: { mergedSchemas: SchemaObject; required: string[] | boolean } =
       mergeAllOf(schema.allOf);
     const mergedSchemaName = getSchemaName(mergedSchemas);
-
     if (
       mergedSchemas.oneOf !== undefined ||
       mergedSchemas.anyOf !== undefined
@@ -685,8 +684,8 @@ function createEdges({
       collapsible: false,
       name,
       required: Array.isArray(required) ? required.includes(name) : required,
-      schemaName: schemaName,
-      qualifierMessage: getQualifierMessage(schema),
+      schemaName: mergedSchemaName,
+      qualifierMessage: getQualifierMessage(mergedSchemas),
       schema: mergedSchemas,
     });
   }
@@ -817,9 +816,18 @@ export function createNodes(
       style: {
         marginTop: ".5rem",
         marginBottom: ".5rem",
-        marginLeft: "1rem",
       },
-      children: createDescription(schema.type),
+      children: [
+        createDescription(schema.type),
+        guard(getQualifierMessage(schema), (message) =>
+          create("div", {
+            style: {
+              paddingTop: "1rem",
+            },
+            children: createDescription(message),
+          })
+        ),
+      ],
     });
   }
 
@@ -829,9 +837,18 @@ export function createNodes(
       style: {
         marginTop: ".5rem",
         marginBottom: ".5rem",
-        marginLeft: "1rem",
       },
-      children: [createDescription(schema)],
+      children: [
+        createDescription(schema),
+        guard(getQualifierMessage(schema), (message) =>
+          create("div", {
+            style: {
+              paddingTop: "1rem",
+            },
+            children: createDescription(message),
+          })
+        ),
+      ],
     });
   }
 

package/src/markdown/schema.ts

@@ -40,6 +40,10 @@ function prettyName(schema: SchemaObject, circular?: boolean) {
     // return schema.type;
   }
 
+  if (schema.title && schema.type) {
+    return `${schema.title} (${schema.type})`;
+  }
+
   return schema.title ?? schema.type;
 }
 

package/src/markdown/utils.ts

@@ -24,7 +24,7 @@ export function guard<T>(
   value: T | undefined,
   cb: (value: T) => Children
 ): string {
-  if (!!value) {
+  if (!!value || value === 0) {
     const children = cb(value);
     return render(children);
   }

package/src/sidebars/index.ts

@@ -87,7 +87,7 @@ function groupByTags(
       apiTags.push(tag.name!);
     }
   });
-  // apiTags = uniq(apiTags.concat(operationTags));
+  apiTags = uniq(apiTags.concat(operationTags));
 
   const basePath = docPath
     ? outputDir.split(docPath!)[1].replace(/^\/+/g, "")