Handle OpenAPI ignored responses

Author: nolannbiron

.changeset/shaggy-crabs-return.md

@@ -0,0 +1,6 @@
+---
+'@gitbook/openapi-parser': patch
+'@gitbook/react-openapi': patch
+---
+
+Handle OpenAPI ignored responses

packages/openapi-parser/src/helpers/shouldIgnoreEntity.ts

@@ -4,7 +4,7 @@ import type { OpenAPIV3 } from '@scalar/openapi-types';
  * Check if an entity should be ignored
  */
 export function shouldIgnoreEntity(
-    data: undefined | OpenAPIV3.TagObject | OpenAPIV3.OperationObject
+    data: undefined | OpenAPIV3.TagObject | OpenAPIV3.OperationObject | OpenAPIV3.ResponseObject
 ) {
     return data?.['x-internal'] === true || data?.['x-gitbook-ignore'] === true;
 }

packages/react-openapi/src/OpenAPIResponseExample.tsx

@@ -1,4 +1,4 @@
-import type { OpenAPIV3 } from '@gitbook/openapi-parser';
+import { type OpenAPIV3, shouldIgnoreEntity } from '@gitbook/openapi-parser';
 import { Markdown } from './Markdown';
 import { OpenAPIEmptyExample, OpenAPIExample } from './OpenAPIExample';
 import { OpenAPIMediaTypeContent } from './OpenAPIMediaType';
@@ -42,7 +42,12 @@ export function OpenAPIResponseExample(props: {
     });
 
     const tabs = responses
-        .filter(([_, responseObject]) => responseObject && typeof responseObject === 'object')
+        .filter(
+            ([_, responseObject]) =>
+                responseObject &&
+                typeof responseObject === 'object' &&
+                !shouldIgnoreEntity(responseObject)
+        )
         .map(([key, responseObject]) => {
             const description = resolveDescription(responseObject);
             const label = description ? (