feat(elements): show tags description if exist

Author: Airkro

packages/elements/src/components/API/utils.ts

@@ -30,9 +30,9 @@ export function computeTagGroups<T extends GroupableNode>(serviceNode: ServiceNo
         groupsByTagId[tagId].items.push(node);
       } else {
         const serviceTagIndex = lowerCaseServiceTags.findIndex(tn => tn === tagId);
-        const serviceTagName = serviceNode.tags[serviceTagIndex];
+        const serviceTag = serviceNode.tagsRaw?.[serviceTagIndex];
         groupsByTagId[tagId] = {
-          title: serviceTagName || tagName,
+          title: serviceTag?.description || serviceTag?.name || tagName,
           items: [node],
         };
       }

packages/elements/src/utils/oas/__tests__/oas.spec.ts

@@ -94,6 +94,16 @@ describe('computeOasNodes', () => {
         infoExtensions: {},
       },
       tags: ['operation-tag', 'model-tag'],
+      tagsRaw: [
+        {
+          id: '68c460dd9e97a',
+          name: 'operation-tag',
+        },
+        {
+          id: 'feec8b579ae6b',
+          name: 'model-tag',
+        },
+      ],
       children: [
         {
           type: 'http_operation',
@@ -171,6 +181,16 @@ describe('computeOasNodes', () => {
         version: '1.0.0',
       },
       tags: ['operation-tag', 'model-tag'],
+      tagsRaw: [
+        {
+          id: '68c460dd9e97a',
+          name: 'operation-tag',
+        },
+        {
+          id: 'feec8b579ae6b',
+          name: 'model-tag',
+        },
+      ],
       children: [
         {
           type: 'http_operation',

packages/elements/src/utils/oas/index.ts

@@ -73,6 +73,7 @@ function computeServiceNode(
     name: serviceDocument.name,
     data: serviceDocument,
     tags: serviceDocument.tags?.map(tag => tag.name) || [],
+    tagsRaw: serviceDocument.tags,
     children: computeChildNodes(document, document, map, transformOperation),
   };
 

packages/elements/src/utils/oas/types.ts

@@ -25,6 +25,7 @@ type Node<T, D> = {
   name: string;
   data: D;
   tags: string[];
+  tagsRaw?: { name?: string; description?: string }[];
 };
 
 export type ServiceNode = Node<NodeType.HttpService, IHttpService> & { children: ServiceChildNode[] };