feat: support classification of changes of OpenAPI specification extensions for tag object and external documentation for tag object

Author: b41ex

src/openapi/openapi3.rules.ts

@@ -416,6 +416,13 @@ export const openApi3Rules = (options: OpenApi3RulesOptions): CompareRules => {
     '/*': oAuthFlowObjectRules,
   }
 
+  const tagObjectCompareRules: CompareRules = {
+    $: allAnnotation,
+    '/externalDocs': externalDocumentationRules,
+    ...openApiSpecificationExtensionRules,
+    '/*': { $: allAnnotation },
+  }
+
   const componentsRule: CompareRules = {
     $: allNonBreaking,
     [START_NEW_COMPARE_SCOPE_RULE]: COMPARE_SCOPE_COMPONENTS,
@@ -497,7 +504,10 @@ export const openApi3Rules = (options: OpenApi3RulesOptions): CompareRules => {
       $: globalSecurityClassifyRule,
       '/*': { $: globalSecurityItemClassifyRule },
     },
-    '/tags': { $: allAnnotation },
+    '/tags': { 
+      $: allAnnotation,
+      '/*': tagObjectCompareRules,
+    },
     '/externalDocs': externalDocumentationRules,
   }
 }

test/openapi.specificationExtensions.test.ts

@@ -61,7 +61,7 @@ const operationObjectPaths: JsonPath[] = [
 ]
 
 const tagObjectPaths: JsonPath[] = [
-  //['tags', 0],  //Tag Object classification rules are not implemented yet
+  ['tags', 0],
 ]
 
 const responseObjectPaths: JsonPath[] = [