docusaurus-plugin-openapi-docs 1.0.0 → 1.0.3

package/README.md

@@ -80,7 +80,7 @@ Here is an example of properly configuring your `docusaurus.config.js` file for
             specPath: "examples/petstore.yaml", // Path to designated spec file
             outputDir: "api/petstore", // Output directory for generated .mdx docs
             sidebarOptions: {
-              groupPathsBy: "tags",
+              groupPathsBy: "tag",
             },
           },
           burgers: {
@@ -110,12 +110,13 @@ Here is an example of properly configuring your `docusaurus.config.js` file for
 
 `sidebarOptions` can be configured with the following options:
 
-| Name                 | Type      | Default | Description                                                                                                                         |
-| -------------------- | --------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------- |
-| `groupPathsBy`       | `string`  | `null`  | Organize and group sidebar slice by specified option. Note: Currently, `groupPathsBy` only contains support for grouping by "tags". |
-| `sidebarCollapsible` | `boolean` | `true`  | Whether sidebar categories are collapsible by default.                                                                              |
-| `sidebarCollapsed`   | `boolean` | `true`  | Whether sidebar categories are collapsed by default.                                                                                |
-| `customProps`        | `object`  | `null`  | Additional props for customizing a sidebar item.                                                                                    |
+| Name                 | Type      | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| -------------------- | --------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `groupPathsBy`       | `string`  | `null`  | Organize and group sidebar slice by specified option. Note: Currently, `groupPathsBy` only contains support for grouping by `tag`.                                                                                                                                                                                                                                                                                                                   |
+| `categoryLinkSource` | `string`  | `null`  | Defines what source to use for rendering category link pages when grouping paths by tag. <br/></br>The supported options are as follows: <br/></br> `tag`: Sets the category link config type to `generated-index` and uses the tag description as the link config description. <br/><br/>`info`: Sets the category link config type to `doc` and renders the `info` section as the category link (recommended only for multi/micro-spec scenarios). |
+| `sidebarCollapsible` | `boolean` | `true`  | Whether sidebar categories are collapsible by default.                                                                                                                                                                                                                                                                                                                                                                                               |
+| `sidebarCollapsed`   | `boolean` | `true`  | Whether sidebar categories are collapsed by default.                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `customProps`        | `object`  | `null`  | Additional props for customizing a sidebar item.                                                                                                                                                                                                                                                                                                                                                                                                     |
 
 > Note: You may optionally configure a `sidebarOptions`. In doing so, an individual `sidebar.js` slice with the configured options will be generated within the respective `outputDir`.
 

package/lib/index.d.ts

@@ -1,3 +1,4 @@
 import type { LoadContext, Plugin } from "@docusaurus/types";
 import type { PluginOptions, LoadedContent } from "./types";
+export declare function isURL(str: string): boolean;
 export default function pluginOpenAPI(context: LoadContext, options: PluginOptions): Plugin<LoadedContent>;

package/lib/index.js

@@ -9,6 +9,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isURL = void 0;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const utils_1 = require("@docusaurus/utils");
@@ -17,15 +18,21 @@ const mustache_1 = require("mustache");
 const markdown_1 = require("./markdown");
 const openapi_1 = require("./openapi");
 const sidebars_1 = __importDefault(require("./sidebars"));
+function isURL(str) {
+    return /^(https?:)\/\//m.test(str);
+}
+exports.isURL = isURL;
 function pluginOpenAPI(context, options) {
     let { config } = options;
     let { siteDir } = context;
     async function generateApiDocs(options) {
         let { specPath, outputDir, template, sidebarOptions } = options;
-        const contentPath = path_1.default.resolve(siteDir, specPath);
+        const contentPath = isURL(specPath)
+            ? specPath
+            : path_1.default.resolve(siteDir, specPath);
         try {
             const openapiFiles = await (0, openapi_1.readOpenapiFiles)(contentPath, {});
-            const loadedApi = await (0, openapi_1.processOpenapiFiles)(openapiFiles);
+            const [loadedApi, tags] = await (0, openapi_1.processOpenapiFiles)(openapiFiles, sidebarOptions);
             if (!fs_1.default.existsSync(outputDir)) {
                 try {
                     fs_1.default.mkdirSync(outputDir, { recursive: true });
@@ -38,7 +45,7 @@ function pluginOpenAPI(context, options) {
             // TODO: figure out better way to set default
             if (Object.keys(sidebarOptions !== null && sidebarOptions !== void 0 ? sidebarOptions : {}).length > 0) {
                 const sidebarSlice = (0, sidebars_1.default)(sidebarOptions, // TODO: find a better way to handle null
-                options, loadedApi);
+                options, loadedApi, tags);
                 const sidebarSliceTemplate = template
                     ? fs_1.default.readFileSync(template).toString()
                     : `module.exports = {{{slice}}};`;
@@ -59,7 +66,12 @@ function pluginOpenAPI(context, options) {
                 ? fs_1.default.readFileSync(template).toString()
                 : `---
 id: {{{id}}}
+{{^api}}
+sidebar_label: Introduction
+{{/api}}
+{{#api}}
 sidebar_label: {{{title}}}
+{{/api}}
 {{^api}}
 sidebar_position: 0
 {{/api}}
@@ -73,17 +85,63 @@ api: {{{json}}}
 {{#api.method}}
 sidebar_class_name: "{{{api.method}}} api-method"
 {{/api.method}}
+{{#infoPath}}
+info_path: {{{infoPath}}}
+{{/infoPath}}
+---
+
+{{{markdown}}}
+      `;
+            const infoMdTemplate = template
+                ? fs_1.default.readFileSync(template).toString()
+                : `---
+id: {{{id}}}
+sidebar_label: {{{title}}}
+hide_title: true
 ---
 
 {{{markdown}}}
+
+\`\`\`mdx-code-block
+import DocCardList from '@theme/DocCardList';
+import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
+
+<DocCardList items={useCurrentSidebarCategory().items}/>
+\`\`\`
+      `;
+            const tagMdTemplate = template
+                ? fs_1.default.readFileSync(template).toString()
+                : `---
+id: {{{id}}}
+title: {{{description}}}
+description: {{{description}}}
+---
+
+{{{markdown}}}
+
+\`\`\`mdx-code-block
+import DocCardList from '@theme/DocCardList';
+import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
+
+<DocCardList items={useCurrentSidebarCategory().items}/>
+\`\`\`
       `;
             loadedApi.map(async (item) => {
-                const markdown = item.type === "api" ? (0, markdown_1.createApiPageMD)(item) : (0, markdown_1.createInfoPageMD)(item);
+                const markdown = item.type === "api"
+                    ? (0, markdown_1.createApiPageMD)(item)
+                    : item.type === "info"
+                        ? (0, markdown_1.createInfoPageMD)(item)
+                        : (0, markdown_1.createTagPageMD)(item);
                 item.markdown = markdown;
                 if (item.type === "api") {
                     item.json = JSON.stringify(item.api);
+                    if (item.infoId)
+                        item.infoPath = `${outputDir}/${item.infoId}`;
                 }
                 const view = (0, mustache_1.render)(mdTemplate, item);
+                const utils = (0, mustache_1.render)(infoMdTemplate, item);
+                // eslint-disable-next-line testing-library/render-result-naming-convention
+                const tagUtils = (0, mustache_1.render)(tagMdTemplate, item);
                 if (item.type === "api") {
                     if (!fs_1.default.existsSync(`${outputDir}/${item.id}.api.mdx`)) {
                         try {
@@ -97,13 +155,26 @@ sidebar_class_name: "{{{api.method}}} api-method"
                 }
                 // TODO: determine if we actually want/need this
                 if (item.type === "info") {
-                    if (!fs_1.default.existsSync(`${outputDir}/index.api.mdx`)) {
+                    if (!fs_1.default.existsSync(`${outputDir}/${item.id}.info.mdx`)) {
+                        try {
+                            (sidebarOptions === null || sidebarOptions === void 0 ? void 0 : sidebarOptions.categoryLinkSource) === "info" // Only use utils template if set to "info"
+                                ? fs_1.default.writeFileSync(`${outputDir}/${item.id}.info.mdx`, utils, "utf8")
+                                : fs_1.default.writeFileSync(`${outputDir}/${item.id}.info.mdx`, view, "utf8");
+                            console.log(chalk_1.default.green(`Successfully created "${outputDir}/${item.id}.info.mdx"`));
+                        }
+                        catch (err) {
+                            console.error(chalk_1.default.red(`Failed to write "${outputDir}/${item.id}.info.mdx"`), chalk_1.default.yellow(err));
+                        }
+                    }
+                }
+                if (item.type === "tag") {
+                    if (!fs_1.default.existsSync(`${outputDir}/${item.id}.tag.mdx`)) {
                         try {
-                            fs_1.default.writeFileSync(`${outputDir}/index.api.mdx`, view, "utf8");
-                            console.log(chalk_1.default.green(`Successfully created "${outputDir}/index.api.mdx"`));
+                            fs_1.default.writeFileSync(`${outputDir}/${item.id}.tag.mdx`, tagUtils, "utf8");
+                            console.log(chalk_1.default.green(`Successfully created "${outputDir}/${item.id}.tag.mdx"`));
                         }
                         catch (err) {
-                            console.error(chalk_1.default.red(`Failed to write "${outputDir}/index.api.mdx"`), chalk_1.default.yellow(err));
+                            console.error(chalk_1.default.red(`Failed to write "${outputDir}/${item.id}.tag.mdx"`), chalk_1.default.yellow(err));
                         }
                     }
                 }
@@ -119,7 +190,7 @@ sidebar_class_name: "{{{api.method}}} api-method"
     async function cleanApiDocs(options) {
         const { outputDir } = options;
         const apiDir = path_1.default.join(siteDir, outputDir);
-        const apiMdxFiles = await (0, utils_1.Globby)(["*.api.mdx"], {
+        const apiMdxFiles = await (0, utils_1.Globby)(["*.api.mdx", "*.info.mdx", "*.tag.mdx"], {
             cwd: path_1.default.resolve(apiDir),
         });
         const sidebarFile = await (0, utils_1.Globby)(["sidebar.js"], {

package/lib/markdown/createAuthentication.d.ts

@@ -0,0 +1,2 @@
+import { SecuritySchemeObject } from "../openapi/types";
+export declare function createAuthentication(securitySchemes: SecuritySchemeObject): string;

package/lib/markdown/createAuthentication.js

@@ -0,0 +1,139 @@
+"use strict";
+/* ============================================================================
+ * Copyright (c) Palo Alto Networks
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ * ========================================================================== */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuthentication = void 0;
+const createDescription_1 = require("./createDescription");
+const utils_1 = require("./utils");
+function createAuthentication(securitySchemes) {
+    if (!securitySchemes || !Object.keys(securitySchemes).length)
+        return "";
+    const createAuthenticationTable = (securityScheme) => {
+        const { bearerFormat, flows, name, scheme, type } = securityScheme;
+        const createSecuritySchemeTypeRow = () => (0, utils_1.create)("tr", {
+            children: [
+                (0, utils_1.create)("th", { children: "Security Scheme Type:" }),
+                (0, utils_1.create)("td", { children: type }),
+            ],
+        });
+        const createOAuthFlowRows = () => {
+            const flowRows = Object.entries(flows).map(([flowType, flowObj]) => {
+                const { authorizationUrl, tokenUrl, refreshUrl, scopes } = flowObj;
+                return (0, utils_1.create)("tr", {
+                    children: [
+                        (0, utils_1.create)("th", { children: `${flowType} OAuth Flow:` }),
+                        (0, utils_1.create)("td", {
+                            children: [
+                                (0, utils_1.guard)(tokenUrl, () => (0, utils_1.create)("p", { children: `Token URL: ${tokenUrl}` })),
+                                (0, utils_1.guard)(authorizationUrl, () => (0, utils_1.create)("p", {
+                                    children: `Authorization URL: ${authorizationUrl}`,
+                                })),
+                                (0, utils_1.guard)(refreshUrl, () => (0, utils_1.create)("p", { children: `Refresh URL: ${refreshUrl}` })),
+                                (0, utils_1.create)("span", { children: "Scopes:" }),
+                                (0, utils_1.create)("ul", {
+                                    children: Object.entries(scopes).map(([scope, description]) => (0, utils_1.create)("li", { children: `${scope}: ${description}` })),
+                                }),
+                            ],
+                        }),
+                    ],
+                });
+            });
+            return flowRows.join("");
+        };
+        switch (type) {
+            case "apiKey":
+                return (0, utils_1.create)("div", {
+                    children: [
+                        (0, utils_1.create)("table", {
+                            children: (0, utils_1.create)("tbody", {
+                                children: [
+                                    createSecuritySchemeTypeRow(),
+                                    (0, utils_1.create)("tr", {
+                                        children: [
+                                            (0, utils_1.create)("th", { children: "Header parameter name:" }),
+                                            (0, utils_1.create)("td", { children: name }),
+                                        ],
+                                    }),
+                                ],
+                            }),
+                        }),
+                    ],
+                });
+            case "http":
+                return (0, utils_1.create)("div", {
+                    children: [
+                        (0, utils_1.create)("table", {
+                            children: (0, utils_1.create)("tbody", {
+                                children: [
+                                    createSecuritySchemeTypeRow(),
+                                    (0, utils_1.create)("tr", {
+                                        children: [
+                                            (0, utils_1.create)("th", { children: "HTTP Authorization Scheme:" }),
+                                            (0, utils_1.create)("td", { children: scheme }),
+                                        ],
+                                    }),
+                                    (0, utils_1.create)("tr", {
+                                        children: [
+                                            (0, utils_1.create)("th", { children: "Bearer format:" }),
+                                            (0, utils_1.create)("td", { children: bearerFormat }),
+                                        ],
+                                    }),
+                                ],
+                            }),
+                        }),
+                    ],
+                });
+            case "oauth2":
+                return (0, utils_1.create)("div", {
+                    children: [
+                        (0, utils_1.create)("table", {
+                            children: (0, utils_1.create)("tbody", {
+                                children: [
+                                    createSecuritySchemeTypeRow(),
+                                    createOAuthFlowRows(),
+                                ],
+                            }),
+                        }),
+                    ],
+                });
+            default:
+                return "";
+        }
+    };
+    const formatTabLabel = (str) => {
+        const formattedLabel = str
+            .replace(/(_|-)/g, " ")
+            .trim()
+            .replace(/\w\S*/g, (str) => str.charAt(0).toUpperCase() + str.substr(1))
+            .replace(/([a-z])([A-Z])/g, "$1 $2")
+            .replace(/([A-Z])([A-Z][a-z])/g, "$1 $2");
+        const isOAuth = formattedLabel.toLowerCase().includes("oauth2");
+        const isApiKey = formattedLabel.toLowerCase().includes("api");
+        return isOAuth ? "OAuth 2.0" : isApiKey ? "API Key" : formattedLabel;
+    };
+    return (0, utils_1.create)("div", {
+        children: [
+            (0, utils_1.create)("h2", {
+                children: "Authentication",
+                id: "authentication",
+                style: { marginBottom: "1rem" },
+            }),
+            (0, utils_1.create)("Tabs", {
+                children: Object.entries(securitySchemes).map(([schemeType, schemeObj]) => (0, utils_1.create)("TabItem", {
+                    label: formatTabLabel(schemeType),
+                    value: `${schemeType}`,
+                    children: [
+                        (0, createDescription_1.createDescription)(schemeObj.description),
+                        createAuthenticationTable(schemeObj),
+                    ],
+                })),
+            }),
+        ],
+        style: { marginBottom: "2rem" },
+    });
+}
+exports.createAuthentication = createAuthentication;

package/lib/markdown/createContactInfo.d.ts

@@ -0,0 +1,2 @@
+import { ContactObject } from "../openapi/types";
+export declare function createContactInfo(contact: ContactObject): string;

package/lib/markdown/createContactInfo.js

@@ -0,0 +1,49 @@
+"use strict";
+/* ============================================================================
+ * Copyright (c) Palo Alto Networks
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ * ========================================================================== */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContactInfo = void 0;
+const utils_1 = require("./utils");
+function createContactInfo(contact) {
+    if (!contact || !Object.keys(contact).length)
+        return "";
+    const { name, url, email } = contact;
+    return (0, utils_1.create)("div", {
+        style: {
+            display: "flex",
+            flexDirection: "column",
+            marginBottom: "var(--ifm-paragraph-margin-bottom)",
+        },
+        children: [
+            (0, utils_1.create)("h3", {
+                style: {
+                    marginBottom: "0.25rem",
+                },
+                children: "Contact",
+            }),
+            (0, utils_1.create)("span", {
+                children: [
+                    (0, utils_1.guard)(name, () => `${name}: `),
+                    (0, utils_1.guard)(email, () => (0, utils_1.create)("a", {
+                        href: `mailto:${email}`,
+                        children: `${email}`,
+                    })),
+                ],
+            }),
+            (0, utils_1.guard)(url, () => (0, utils_1.create)("span", {
+                children: [
+                    "URL: ",
+                    (0, utils_1.create)("a", {
+                        href: `${url}`,
+                        children: `${url}`,
+                    }),
+                ],
+            })),
+        ],
+    });
+}
+exports.createContactInfo = createContactInfo;

package/lib/markdown/createLicense.d.ts

@@ -0,0 +1,2 @@
+import { LicenseObject } from "../openapi/types";
+export declare function createLicense(license: LicenseObject): string;

package/lib/markdown/createLicense.js

@@ -0,0 +1,33 @@
+"use strict";
+/* ============================================================================
+ * Copyright (c) Palo Alto Networks
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ * ========================================================================== */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLicense = void 0;
+const utils_1 = require("./utils");
+function createLicense(license) {
+    if (!license || !Object.keys(license).length)
+        return "";
+    const { name, url } = license;
+    return (0, utils_1.create)("div", {
+        style: {
+            marginBottom: "var(--ifm-paragraph-margin-bottom)",
+        },
+        children: [
+            (0, utils_1.create)("h3", {
+                style: {
+                    marginBottom: "0.25rem",
+                },
+                children: "License",
+            }),
+            (0, utils_1.guard)(url, () => (0, utils_1.create)("a", {
+                href: url,
+                children: name !== null && name !== void 0 ? name : url,
+            })),
+        ],
+    });
+}
+exports.createLicense = createLicense;

package/lib/markdown/createSchemaDetails.js

@@ -185,7 +185,10 @@ function createRowsRoot({ schema }) {
     });
 }
 function createSchemaDetails({ title, body, ...rest }) {
-    if (body === undefined || body.content === undefined) {
+    if (body === undefined ||
+        body.content === undefined ||
+        Object.keys(body).length === 0 ||
+        Object.keys(body.content).length === 0) {
         return undefined;
     }
     // TODO:

package/lib/markdown/createStatusCodes.js

@@ -20,7 +20,7 @@ function createStatusCodes({ responses }) {
     }
     return (0, utils_1.create)("div", {
         children: [
-            (0, utils_1.create)("Tabs", {
+            (0, utils_1.create)("ApiTabs", {
                 children: codes.map((code) => {
                     return (0, utils_1.create)("TabItem", {
                         label: code,

package/lib/markdown/createTermsOfService.d.ts

@@ -0,0 +1 @@
+export declare function createTermsOfService(termsOfService: string | undefined): string;

package/lib/markdown/createTermsOfService.js

@@ -0,0 +1,32 @@
+"use strict";
+/* ============================================================================
+ * Copyright (c) Palo Alto Networks
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ * ========================================================================== */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTermsOfService = void 0;
+const utils_1 = require("./utils");
+function createTermsOfService(termsOfService) {
+    if (!termsOfService)
+        return "";
+    return (0, utils_1.create)("div", {
+        style: {
+            marginBottom: "var(--ifm-paragraph-margin-bottom)",
+        },
+        children: [
+            (0, utils_1.create)("h3", {
+                style: {
+                    marginBottom: "0.25rem",
+                },
+                children: "Terms of Service",
+            }),
+            (0, utils_1.create)("a", {
+                href: `${termsOfService}`,
+                children: termsOfService,
+            }),
+        ],
+    });
+}
+exports.createTermsOfService = createTermsOfService;

package/lib/markdown/index.d.ts

@@ -1,3 +1,4 @@
-import { ApiPageMetadata, InfoPageMetadata } from "../types";
+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 }, }: InfoPageMetadata): string;
+export declare function createInfoPageMD({ info: { title, version, description, contact, license, termsOfService }, securitySchemes, }: InfoPageMetadata): string;
+export declare function createTagPageMD({ tag: { description } }: TagPageMetadata): string;

package/lib/markdown/index.js

@@ -6,20 +6,24 @@
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createInfoPageMD = exports.createApiPageMD = void 0;
+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");
 const createDescription_1 = require("./createDescription");
+const createLicense_1 = require("./createLicense");
 const createParamsDetails_1 = require("./createParamsDetails");
 const createRequestBodyDetails_1 = require("./createRequestBodyDetails");
 const createStatusCodes_1 = require("./createStatusCodes");
+const createTermsOfService_1 = require("./createTermsOfService");
 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 ParamsItem from "@theme/ParamsItem";\n`,
         `import SchemaItem from "@theme/SchemaItem"\n`,
-        `import Tabs from "@theme/Tabs";\n`,
+        `import ApiTabs from "@theme/ApiTabs";\n`,
         `import TabItem from "@theme/TabItem";\n\n`,
         `## ${(0, lodash_1.escape)(title)}\n\n`,
         (0, createDeprecationNotice_1.createDeprecationNotice)({ deprecated, description: deprecatedDescription }),
@@ -33,11 +37,21 @@ function createApiPageMD({ title, api: { deprecated, "x-deprecated-description":
     ]);
 }
 exports.createApiPageMD = createApiPageMD;
-function createInfoPageMD({ info: { title, version, description }, }) {
+function createInfoPageMD({ info: { title, version, description, contact, license, termsOfService }, securitySchemes, }) {
     return (0, utils_1.render)([
+        `import Tabs from "@theme/Tabs";\n`,
+        `import TabItem from "@theme/TabItem";\n`,
         (0, createVersionBadge_1.createVersionBadge)(version),
         `# ${(0, lodash_1.escape)(title)}\n\n`,
         (0, createDescription_1.createDescription)(description),
+        (0, createAuthentication_1.createAuthentication)(securitySchemes),
+        (0, createContactInfo_1.createContactInfo)(contact),
+        (0, createTermsOfService_1.createTermsOfService)(termsOfService),
+        (0, createLicense_1.createLicense)(license),
     ]);
 }
 exports.createInfoPageMD = createInfoPageMD;
+function createTagPageMD({ tag: { description } }) {
+    return (0, utils_1.render)([(0, createDescription_1.createDescription)(description)]);
+}
+exports.createTagPageMD = createTagPageMD;