feat(open-api): add servers display if set

INT-407

src/.vuepress/plugins/openApi.ts

@@ -42,6 +42,9 @@ ${document.security ? '## Authorization' : ''}
 :security='${JSON.stringify(document.security ?? [])}'
 :security-schemes='${JSON.stringify(document.components?.securitySchemes ?? [])}' />
 
+${document.servers?.length ? '## Servers' : ''}
+<OpenApiServers :servers='${JSON.stringify(document.servers ?? [])}' />
+
 ${renderPaths(document, document.paths, 'Endpoints')}
 
 ${renderPaths(document, document.webhooks, 'Webhooks')}

src/.vuepress/theme/client/components/global/OpenApiServers.vue

@@ -0,0 +1,23 @@
+<template>
+  <ul
+    v-if="servers?.length"
+    class="open-api-servers">
+    <li
+      v-for="(server, index) in servers"
+      :key="index">
+      <code>{{ server.url }}</code>
+      <Markdown
+        v-if="server.description"
+        :content="server.description" />
+    </li>
+  </ul>
+</template>
+
+<script setup lang="ts">
+import {type OpenAPIV3_1 as OpenApiType} from 'openapi-types';
+import Markdown from './Markdown.vue';
+
+defineProps<{
+  servers: OpenApiType.Document['servers'];
+}>();
+</script>

src/.vuepress/theme/client/components/global/index.ts

@@ -84,3 +84,5 @@ export {default as OpenApiSchemaInfo} from './OpenApiSchemaInfo.vue';
 export {default as OpenApiSecurityRequirements} from './OpenApiSecurityRequirements.vue';
 
 export {default as OpenApiSecurityScheme} from './OpenApiSecurityScheme.vue';
+
+export {default as OpenApiServers} from './OpenApiServers.vue';