docusaurus-plugin-openapi-docs 0.0.0-479 → 0.0.0-481

package/lib/markdown/createDescription.js

@@ -7,10 +7,13 @@
  * ========================================================================== */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDescription = void 0;
+const utils_1 = require("./utils");
 function createDescription(description) {
     if (!description) {
         return "";
     }
-    return `\n\n${description}\n\n`;
+    return `\n\n${description
+        .replace(utils_1.lessThan, "<")
+        .replace(utils_1.greaterThan, ">")}\n\n`;
 }
 exports.createDescription = createDescription;

package/lib/markdown/index.js

@@ -7,7 +7,6 @@
  * ========================================================================== */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTagPageMD = exports.createInfoPageMD = exports.createApiPageMD = void 0;
-const lodash_1 = require("lodash");
 const createAuthentication_1 = require("./createAuthentication");
 const createContactInfo_1 = require("./createContactInfo");
 const createDeprecationNotice_1 = require("./createDeprecationNotice");
@@ -30,9 +29,9 @@ function createApiPageMD({ title, api: { deprecated, "x-deprecated-description":
         `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`,
+        `## ${title.replace(utils_1.lessThan, "<").replace(utils_1.greaterThan, ">")}\n\n`,
         (0, createDeprecationNotice_1.createDeprecationNotice)({ deprecated, description: deprecatedDescription }),
-        (0, createDescription_1.createDescription)((0, lodash_1.escape)(description)),
+        (0, createDescription_1.createDescription)(description),
         (0, createParamsDetails_1.createParamsDetails)({ parameters, type: "path" }),
         (0, createParamsDetails_1.createParamsDetails)({ parameters, type: "query" }),
         (0, createParamsDetails_1.createParamsDetails)({ parameters, type: "header" }),
@@ -51,7 +50,7 @@ function createInfoPageMD({ info: { title, version, description, contact, licens
         `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`,
+        `# ${title.replace(utils_1.lessThan, "<").replace(utils_1.greaterThan, ">")}\n\n`,
         (0, createLogo_1.createLogo)(logo, darkLogo),
         (0, createDescription_1.createDescription)(description),
         (0, createAuthentication_1.createAuthentication)(securitySchemes),

package/lib/markdown/utils.d.ts

@@ -5,3 +5,5 @@ export declare type Props = Record<string, any> & {
 export declare function create(tag: string, props: Props): string;
 export declare function guard<T>(value: T | undefined, cb: (value: T) => Children): string;
 export declare function render(children: Children): string;
+export declare const lessThan: RegExp;
+export declare const greaterThan: RegExp;

package/lib/markdown/utils.js

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.render = exports.guard = exports.create = void 0;
+exports.greaterThan = exports.lessThan = exports.render = exports.guard = exports.create = void 0;
 function create(tag, props) {
     const { children, ...rest } = props;
     let propString = "";
@@ -34,3 +34,6 @@ function render(children) {
     return children !== null && children !== void 0 ? children : "";
 }
 exports.render = render;
+// Regex to selectively URL-encode '>' and '<' chars
+exports.lessThan = /<(?!(button|\s?\/button|details|\s?\/details|summary|\s?\/summary|hr|\s?\/hr|br|\s?\/br|span|\s?\/span|strong|\s?\/strong|small|\s?\/small|table|\s?\/table|td|\s?\/td|tr|\s?\/tr|th|\s?\/th|h1|\s?\/h1|h2|\s?\/h2|h3|\s?\/h3|h4|\s?\/h4|h5|\s?\/h5|h6|\s?\/h6|title|\s?\/title|p|\s?\/p|em|\s?\/em|b|\s?\/b|i|\s?\/i|u|\s?\/u|strike|\s?\/strike|a|\s?\/a|li|\s?\/li|ol|\s?\/ol|ul|\s?\/ul|img|\s?\/img|div|\s?\/div|center|\s?\/center))/giu;
+exports.greaterThan = /(?<!(button|details|summary|hr|br|span|strong|small|table|td|tr|th|h1|h2|h3|h4|h5|h6|title|p|em|b|i|u|strike|a|tag|li|ol|ul|img|div|center|\/|\s|"|'))>/giu;

package/lib/openapi/createResponseExample.js

@@ -60,12 +60,10 @@ function sampleResponseFromProp(name, prop, obj) {
 }
 const sampleResponseFromSchema = (schema = {}) => {
     try {
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
         let { type, example, allOf, oneOf, anyOf, properties, items } = schema;
-        // TODO: determine if we should always ignore the example when creating from schema
-        // if (example !== undefined) {
-        //   return example;
-        // }
+        if (example !== undefined) {
+            return example;
+        }
         if (allOf) {
             const { mergedSchemas } = (0, createResponseSchema_1.mergeAllOf)(allOf);
             if (mergedSchemas.properties) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docusaurus-plugin-openapi-docs",
   "description": "OpenAPI plugin for Docusaurus.",
-  "version": "0.0.0-479",
+  "version": "0.0.0-481",
   "license": "MIT",
   "keywords": [
     "openapi",
@@ -68,5 +68,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "72d4c8ac5203c761c8ed3f9b30ee6ee79e386500"
+  "gitHead": "6eff65560dc9e24c5823ea1ba7da33fa86bfc703"
 }

package/src/markdown/createDescription.ts

@@ -5,9 +5,13 @@
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
 
+import { greaterThan, lessThan } from "./utils";
+
 export function createDescription(description: string | undefined) {
   if (!description) {
     return "";
   }
-  return `\n\n${description}\n\n`;
+  return `\n\n${description
+    .replace(lessThan, "<")
+    .replace(greaterThan, ">")}\n\n`;
 }

package/src/markdown/index.ts

@@ -5,8 +5,6 @@
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
 
-import { escape } from "lodash";
-
 import {
   ContactObject,
   LicenseObject,
@@ -25,7 +23,7 @@ import { createRequestBodyDetails } from "./createRequestBodyDetails";
 import { createStatusCodes } from "./createStatusCodes";
 import { createTermsOfService } from "./createTermsOfService";
 import { createVersionBadge } from "./createVersionBadge";
-import { render } from "./utils";
+import { greaterThan, lessThan, render } from "./utils";
 
 interface Props {
   title: string;
@@ -58,9 +56,9 @@ export function createApiPageMD({
     `import SchemaTabs from "@theme/SchemaTabs";\n`,
     `import DiscriminatorTabs from "@theme/DiscriminatorTabs";\n`,
     `import TabItem from "@theme/TabItem";\n\n`,
-    `## ${escape(title)}\n\n`,
+    `## ${title.replace(lessThan, "<").replace(greaterThan, ">")}\n\n`,
     createDeprecationNotice({ deprecated, description: deprecatedDescription }),
-    createDescription(escape(description)),
+    createDescription(description),
     createParamsDetails({ parameters, type: "path" }),
     createParamsDetails({ parameters, type: "query" }),
     createParamsDetails({ parameters, type: "header" }),
@@ -92,7 +90,7 @@ export function createInfoPageMD({
     `import TabItem from "@theme/TabItem";\n\n`,
 
     createVersionBadge(version),
-    `# ${escape(title)}\n\n`,
+    `# ${title.replace(lessThan, "<").replace(greaterThan, ">")}\n\n`,
     createLogo(logo, darkLogo),
     createDescription(description),
     createAuthentication(securitySchemes as unknown as SecuritySchemeObject),

package/src/markdown/utils.ts

@@ -40,3 +40,9 @@ export function render(children: Children): string {
   }
   return children ?? "";
 }
+
+// Regex to selectively URL-encode '>' and '<' chars
+export const lessThan =
+  /<(?!(button|\s?\/button|details|\s?\/details|summary|\s?\/summary|hr|\s?\/hr|br|\s?\/br|span|\s?\/span|strong|\s?\/strong|small|\s?\/small|table|\s?\/table|td|\s?\/td|tr|\s?\/tr|th|\s?\/th|h1|\s?\/h1|h2|\s?\/h2|h3|\s?\/h3|h4|\s?\/h4|h5|\s?\/h5|h6|\s?\/h6|title|\s?\/title|p|\s?\/p|em|\s?\/em|b|\s?\/b|i|\s?\/i|u|\s?\/u|strike|\s?\/strike|a|\s?\/a|li|\s?\/li|ol|\s?\/ol|ul|\s?\/ul|img|\s?\/img|div|\s?\/div|center|\s?\/center))/giu;
+export const greaterThan =
+  /(?<!(button|details|summary|hr|br|span|strong|small|table|td|tr|th|h1|h2|h3|h4|h5|h6|title|p|em|b|i|u|strike|a|tag|li|ol|ul|img|div|center|\/|\s|"|'))>/giu;

package/src/openapi/createResponseExample.ts

@@ -77,13 +77,11 @@ function sampleResponseFromProp(name: string, prop: any, obj: any): any {
 
 export const sampleResponseFromSchema = (schema: SchemaObject = {}): any => {
   try {
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
     let { type, example, allOf, oneOf, anyOf, properties, items } = schema;
 
-    // TODO: determine if we should always ignore the example when creating from schema
-    // if (example !== undefined) {
-    //   return example;
-    // }
+    if (example !== undefined) {
+      return example;
+    }
 
     if (allOf) {
       const { mergedSchemas }: { mergedSchemas: SchemaObject } =