@gitbook/react-openapi 1.0.2 → 1.0.4

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @gitbook/react-openapi
 
+## 1.0.4
+
+### Patch Changes
+
+-   722f02e: Fix recursion in OpenAPISchemaAlternative
+-   Updated dependencies [0924259]
+    -   @gitbook/openapi-parser@2.0.1
+
+## 1.0.3
+
+### Patch Changes
+
+-   dc2dbc5: Update OpenAPI code examples to support multiple content-type
+-   f1d1d2f: Return empty string if no server provided
+-   05e1d8c: Hide x-gitbook-\* symbols in OpenAPI blocks
+-   b4a12d6: Fix circularRef in schema + examples OpenAPI
+-   9f0de74: Fix ID not set when there is no operation summary
+-   da55fac: Render GitBook blocks in OpenAPI operation description
+-   Updated dependencies [c808bb1]
+-   Updated dependencies [e24206e]
+-   Updated dependencies [a054554]
+-   Updated dependencies [da55fac]
+    -   @gitbook/openapi-parser@2.0.0
+
 ## 1.0.2
 
 ### Patch Changes

package/dist/OpenAPICodeSample.jsx

@@ -9,14 +9,13 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
+import { InteractiveSection } from './InteractiveSection';
+import { OpenAPITabs, OpenAPITabsList, OpenAPITabsPanels } from './OpenAPITabs';
 import { codeSampleGenerators } from './code-samples';
 import { generateMediaTypeExample, generateSchemaExample } from './generateSchemaExample';
-import { InteractiveSection } from './InteractiveSection';
-import { getServersURL } from './OpenAPIServerURL';
-import { createStateKey } from './utils';
 import { stringifyOpenAPI } from './stringifyOpenAPI';
-import { OpenAPITabs, OpenAPITabsList, OpenAPITabsPanels } from './OpenAPITabs';
-import { checkIsReference } from './utils';
+import { getDefaultServerURL } from './util/server';
+import { checkIsReference, createStateKey } from './utils';
 /**
  * Display code samples to execute the operation.
  * It supports the Redocly custom syntax as well (https://redocly.com/docs/api-reference-docs/specification-extensions/x-code-samples/)
@@ -52,15 +51,11 @@ export function OpenAPICodeSample(props) {
         : undefined;
     var requestBodyContent = requestBodyContentEntries === null || requestBodyContentEntries === void 0 ? void 0 : requestBodyContentEntries[0];
     var input = {
-        url: getServersURL(data.servers) +
+        url: getDefaultServerURL(data.servers) +
             data.path +
             (searchParams.size ? "?".concat(searchParams.toString()) : ''),
         method: data.method,
-        body: requestBodyContent
-            ? generateMediaTypeExample(requestBodyContent[1], {
-                omitEmptyAndOptionalProperties: true,
-            })
-            : undefined,
+        body: requestBodyContent ? generateMediaTypeExample(requestBodyContent[1]) : undefined,
         headers: __assign(__assign(__assign({}, getSecurityHeaders(data.securities)), headersObject), (requestBodyContent
             ? {
                 'Content-Type': requestBodyContent[0],
@@ -70,7 +65,10 @@ export function OpenAPICodeSample(props) {
     var autoCodeSamples = codeSampleGenerators.map(function (generator) { return ({
         key: "default-".concat(generator.id),
         label: generator.label,
-        body: <context.CodeBlock code={generator.generate(input)} syntax={generator.syntax}/>,
+        body: context.renderCodeBlock({
+            code: generator.generate(input),
+            syntax: generator.syntax,
+        }),
     }); });
     // Use custom samples if defined
     var customCodeSamples = null;
@@ -83,10 +81,13 @@ export function OpenAPICodeSample(props) {
                     typeof sample.source === 'string' &&
                     typeof sample.lang === 'string');
             })
-                .map(function (sample) { return ({
-                key: "redocly-".concat(sample.lang),
+                .map(function (sample, index) { return ({
+                key: "redocly-".concat(sample.lang, "-").concat(index),
                 label: sample.label,
-                body: <context.CodeBlock code={sample.source} syntax={sample.lang}/>,
+                body: context.renderCodeBlock({
+                    code: sample.source,
+                    syntax: sample.lang,
+                }),
             }); });
         }
     });
@@ -125,7 +126,7 @@ function getSecurityHeaders(securities) {
                 scheme = 'Token';
             }
             return {
-                Authorization: scheme + ' ' + format,
+                Authorization: "".concat(scheme, " ").concat(format),
             };
         }
         case 'apiKey': {

package/dist/OpenAPIDisclosure.d.ts

@@ -1,3 +1,4 @@
+import type React from 'react';
 import type { OpenAPIClientContext } from './types';
 interface Props {
     context: OpenAPIClientContext;
@@ -8,5 +9,5 @@ interface Props {
  * Display an interactive OpenAPI disclosure.
  * The label is optional and defaults to "child attributes".
  */
-export declare function OpenAPIDisclosure({ context, children, label }: Props): JSX.Element;
+export declare function OpenAPIDisclosure({ context, children, label }: Props): React.JSX.Element;
 export {};

package/dist/OpenAPIDisclosure.jsx

@@ -21,7 +21,7 @@ export function OpenAPIDisclosure(_a) {
         }}>
                 {context.icons.plus}
                 <span>
-                    {"".concat(state.isExpanded ? 'Hide' : 'Show', " ").concat(label ? label : "child attributes")}
+                    {"".concat(state.isExpanded ? 'Hide' : 'Show', " ").concat(label ? label : 'child attributes')}
                 </span>
             </button>
 

package/dist/OpenAPIDisclosureGroup.d.ts

@@ -11,7 +11,7 @@ type TDisclosureGroup = {
         body?: React.ReactNode;
     }[];
 };
-import { DisclosureGroupProps } from 'react-stately';
+import { type DisclosureGroupProps } from 'react-stately';
 /**
  * Display an interactive OpenAPI disclosure group.
  */

package/dist/OpenAPIDisclosureGroup.jsx

@@ -9,9 +9,9 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
+import { createContext, useContext, useRef, useState } from 'react';
 import { mergeProps, useButton, useDisclosure, useFocusRing, useId } from 'react-aria';
 import { useDisclosureGroupState, useDisclosureState, } from 'react-stately';
-import { createContext, useContext, useRef, useState } from 'react';
 var DisclosureGroupStateContext = createContext(null);
 /**
  * Display an interactive OpenAPI disclosure group.
@@ -70,7 +70,7 @@ function DisclosureItem(props) {
                                 {group.tabs.map(function (tab) { return (<option key={tab.id} value={tab.id}>
                                         {tab.label}
                                     </option>); })}
-                            </select>) : !!group.tabs[0] ? (<span>{group.tabs[0].label}</span>) : null}
+                            </select>) : group.tabs[0] ? (<span>{group.tabs[0].label}</span>) : null}
                     </div>) : null}
             </div>
 

package/dist/OpenAPIOperation.jsx

@@ -1,9 +1,9 @@
 import clsx from 'clsx';
 import { Markdown } from './Markdown';
 import { OpenAPICodeSample } from './OpenAPICodeSample';
+import { OpenAPIPath } from './OpenAPIPath';
 import { OpenAPIResponseExample } from './OpenAPIResponseExample';
 import { OpenAPISpec } from './OpenAPISpec';
-import { OpenAPIPath } from './OpenAPIPath';
 import { resolveDescription } from './utils';
 /**
  * Display an interactive OpenAPI operation.
@@ -17,9 +17,8 @@ export function OpenAPIOperation(props) {
         icons: context.icons,
         blockKey: context.blockKey,
     };
-    var description = resolveDescription(operation);
     return (<div className={clsx('openapi-operation', className)}>
-            <div className="openapi-summary">
+            <div className="openapi-summary" id={operation.summary ? undefined : context.id}>
                 {operation.summary
             ? context.renderHeading({
                 deprecated: (_a = operation.deprecated) !== null && _a !== void 0 ? _a : false,
@@ -35,11 +34,9 @@ export function OpenAPIOperation(props) {
                             <span className="openapi-deprecated-sunset-date">
                                 {operation['x-deprecated-sunset']}
                             </span>
-                            {"."}
-                        </div>) : null}
-                    {description ? (<div className="openapi-intro">
-                            <Markdown className="openapi-description" source={description}/>
+                            {'.'}
                         </div>) : null}
+                    <OpenAPIOperationDescription operation={operation} context={context}/>
                     <OpenAPIPath data={data} context={context}/>
                     <OpenAPISpec data={data} context={clientContext}/>
                 </div>
@@ -52,3 +49,20 @@ export function OpenAPIOperation(props) {
             </div>
         </div>);
 }
+function OpenAPIOperationDescription(props) {
+    var operation = props.operation;
+    if (operation['x-gitbook-description-document']) {
+        return (<div className="openapi-intro">
+                {props.context.renderDocument({
+                document: operation['x-gitbook-description-document'],
+            })}
+            </div>);
+    }
+    var description = resolveDescription(operation);
+    if (!description) {
+        return null;
+    }
+    return (<div className="openapi-intro">
+            <Markdown className="openapi-description" source={description}/>
+        </div>);
+}

package/dist/OpenAPIPath.d.ts

@@ -1,8 +1,9 @@
-import type { OpenAPIOperationData, OpenAPIContextProps } from './types';
+import type React from 'react';
+import type { OpenAPIContextProps, OpenAPIOperationData } from './types';
 /**
  * Display the path of an operation.
  */
 export declare function OpenAPIPath(props: {
     data: OpenAPIOperationData;
     context: OpenAPIContextProps;
-}): JSX.Element;
+}): React.JSX.Element;

package/dist/OpenAPIPath.jsx

@@ -1,12 +1,3 @@
-var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
-    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
-        if (ar || !(i in from)) {
-            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
-            ar[i] = from[i];
-        }
-    }
-    return to.concat(ar || Array.prototype.slice.call(from));
-};
 import { ScalarApiButton } from './ScalarApiButton';
 /**
  * Display the path of an operation.
@@ -41,14 +32,12 @@ function formatPath(path) {
     // Join parts with separators wrapped in <span>
     var formattedPath = parts.reduce(function (acc, part, index) {
         if (typeof part === 'string' && index > 0 && part === '/') {
-            return __spreadArray(__spreadArray([], acc, true), [
-                <span className="openapi-path-separator" key={"sep-".concat(index)}>
+            acc.push(<span className="openapi-path-separator" key={"sep-".concat(index)}>
                         /
-                    </span>,
-                part,
-            ], false);
+                    </span>);
         }
-        return __spreadArray(__spreadArray([], acc, true), [part], false);
+        acc.push(part);
+        return acc;
     }, []);
     return <span>{formattedPath}</span>;
 }

package/dist/OpenAPIRequestBody.jsx

@@ -1,5 +1,5 @@
-import { OpenAPIRootSchema } from './OpenAPISchema';
 import { InteractiveSection } from './InteractiveSection';
+import { OpenAPIRootSchema } from './OpenAPISchema';
 import { checkIsReference } from './utils';
 /**
  * Display an interactive request body.

package/dist/OpenAPIResponse.jsx

@@ -9,9 +9,9 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
+import { OpenAPIDisclosure } from './OpenAPIDisclosure';
 import { OpenAPISchemaProperties } from './OpenAPISchema';
 import { parameterToProperty, resolveDescription } from './utils';
-import { OpenAPIDisclosure } from './OpenAPIDisclosure';
 /**
  * Display an interactive response body.
  */

package/dist/OpenAPIResponseExample.jsx

@@ -1,8 +1,9 @@
-import { generateSchemaExample } from './generateSchemaExample';
-import { checkIsReference, createStateKey, resolveDescription } from './utils';
-import { OpenAPITabs, OpenAPITabsList, OpenAPITabsPanels } from './OpenAPITabs';
 import { InteractiveSection } from './InteractiveSection';
+import { OpenAPITabs, OpenAPITabsList, OpenAPITabsPanels } from './OpenAPITabs';
+import { generateSchemaExample } from './generateSchemaExample';
 import { json2xml } from './json2xml';
+import { stringifyOpenAPI } from './stringifyOpenAPI';
+import { checkIsReference, createStateKey, resolveDescription } from './utils';
 /**
  * Display an example of the response content.
  */
@@ -128,7 +129,7 @@ function OpenAPIExample(props) {
     if (code === null) {
         return <OpenAPIEmptyResponseExample />;
     }
-    return <context.CodeBlock code={code} syntax={syntax}/>;
+    return context.renderCodeBlock({ code: code, syntax: syntax });
 }
 function stringifyExample(args) {
     var example = args.example, xml = args.xml;
@@ -141,7 +142,7 @@ function stringifyExample(args) {
     if (xml) {
         return json2xml(example.value);
     }
-    return JSON.stringify(example.value, null, 2);
+    return stringifyOpenAPI(example.value, null, 2);
 }
 /**
  * Get the syntax from a media type.

package/dist/OpenAPIResponses.d.ts

@@ -1,5 +1,5 @@
 import type { OpenAPIV3, OpenAPIV3_1 } from '@gitbook/openapi-parser';
-import { OpenAPIClientContext } from './types';
+import type { OpenAPIClientContext } from './types';
 /**
  * Display an interactive response body.
  */

package/dist/OpenAPIResponses.jsx

@@ -1,7 +1,7 @@
-import { OpenAPIResponse } from './OpenAPIResponse';
 import { InteractiveSection } from './InteractiveSection';
-import { OpenAPIDisclosureGroup } from './OpenAPIDisclosureGroup';
 import { Markdown } from './Markdown';
+import { OpenAPIDisclosureGroup } from './OpenAPIDisclosureGroup';
+import { OpenAPIResponse } from './OpenAPIResponse';
 /**
  * Display an interactive response body.
  */

package/dist/OpenAPISchema.d.ts

@@ -38,10 +38,14 @@ export declare function OpenAPISchemaEnum(props: {
     enumValues: any[];
 }): import("react").JSX.Element;
 export declare function OpenAPISchemaPresentation(props: OpenAPISchemaPropertyEntry): import("react").JSX.Element;
+type OpenAPISchemaAlternatives = [
+    OpenAPIV3.SchemaObject[],
+    OpenAPIV3.DiscriminatorObject | undefined
+];
 /**
  * Get the alternatives to display for a schema.
  */
-export declare function getSchemaAlternatives(schema: OpenAPIV3.SchemaObject, ancestors?: Set<OpenAPIV3.SchemaObject>): null | [OpenAPIV3.SchemaObject[], OpenAPIV3.DiscriminatorObject | undefined];
+export declare function getSchemaAlternatives(schema: OpenAPIV3.SchemaObject, ancestors?: Set<OpenAPIV3.SchemaObject>): null | OpenAPISchemaAlternatives;
 export declare function getSchemaTitle(schema: OpenAPIV3.SchemaObject, 
 /** If the title is inferred in a oneOf with discriminator, we can use it to optimize the title */
 discriminator?: OpenAPIV3.DiscriminatorObject): string;

package/dist/OpenAPISchema.jsx

@@ -1,20 +1,11 @@
-var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
-    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
-        if (ar || !(i in from)) {
-            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
-            ar[i] = from[i];
-        }
-    }
-    return to.concat(ar || Array.prototype.slice.call(from));
-};
 import clsx from 'clsx';
 import { useId } from 'react';
 import { InteractiveSection } from './InteractiveSection';
 import { Markdown } from './Markdown';
-import { checkIsReference, resolveDescription } from './utils';
-import { stringifyOpenAPI } from './stringifyOpenAPI';
-import { OpenAPISchemaName } from './OpenAPISchemaName';
 import { OpenAPIDisclosure } from './OpenAPIDisclosure';
+import { OpenAPISchemaName } from './OpenAPISchemaName';
+import { stringifyOpenAPI } from './stringifyOpenAPI';
+import { checkIsReference, resolveDescription } from './utils';
 /**
  * Render a property of an OpenAPI schema.
  */
@@ -29,18 +20,16 @@ export function OpenAPISchemaProperty(props) {
     var alternatives = parentCircularRef
         ? null
         : getSchemaAlternatives(schema, new Set(circularRefs.keys()));
+    if ((_a = alternatives === null || alternatives === void 0 ? void 0 : alternatives[0]) === null || _a === void 0 ? void 0 : _a.length) {
+        return (<OpenAPISchemaAlternativesItem {...props} circularRefs={circularRefs} context={context} alternatives={alternatives} parentCircularRef={parentCircularRef}/>);
+    }
     if ((properties && properties.length > 0) || schema.type === 'object') {
         return (<InteractiveSection id={id} className={clsx('openapi-schema', className)}>
                 <OpenAPISchemaPresentation {...props}/>
-                {properties && properties.length > 0 ? (<OpenAPIDisclosure context={context}>
+                {properties && properties.length > 0 ? (<OpenAPIDisclosure context={context} label={getDisclosureLabel(schema)}>
                         <OpenAPISchemaProperties properties={properties} circularRefs={circularRefs} context={context}/>
                     </OpenAPIDisclosure>) : null}
-            </InteractiveSection>);
-    }
-    if ((_a = alternatives === null || alternatives === void 0 ? void 0 : alternatives[0]) === null || _a === void 0 ? void 0 : _a.length) {
-        return (<InteractiveSection id={id} className={clsx('openapi-schema', className)}>
-                <OpenAPISchemaPresentation {...props}/>
-                {alternatives[0].map(function (alternative, index) { return (<OpenAPISchemaAlternative key={"alternative-".concat(index)} schema={alternative} circularRefs={circularRefs} context={context}/>); })}
+                {parentCircularRef ? (<OpenAPISchemaCircularRef id={parentCircularRef} schema={schema}/>) : null}
             </InteractiveSection>);
     }
     return (<InteractiveSection id={id} className={clsx('openapi-schema', className)}>
@@ -83,12 +72,35 @@ export function OpenAPIRootSchema(props) {
  * for primitives, it renders the schema itself.
  */
 function OpenAPISchemaAlternative(props) {
+    var _a;
     var schema = props.schema, circularRefs = props.circularRefs, context = props.context;
     var id = useId();
     var subProperties = getSchemaProperties(schema);
-    return (<OpenAPIDisclosure context={context}>
-            <OpenAPISchemaProperties id={id} properties={subProperties !== null && subProperties !== void 0 ? subProperties : [{ schema: schema }]} circularRefs={subProperties ? new Map(circularRefs).set(schema, id) : circularRefs} context={context}/>
-        </OpenAPIDisclosure>);
+    var description = resolveDescription(schema);
+    var alternatives = getSchemaAlternatives(schema, new Set(circularRefs === null || circularRefs === void 0 ? void 0 : circularRefs.keys()));
+    if (((_a = alternatives === null || alternatives === void 0 ? void 0 : alternatives[0]) === null || _a === void 0 ? void 0 : _a.length) && !(subProperties === null || subProperties === void 0 ? void 0 : subProperties.length)) {
+        return (<>
+                {description ? (<Markdown source={description} className="openapi-schema-description"/>) : null}
+                <OpenAPIDisclosure context={context} label={getDisclosureLabel(schema)}>
+                    <OpenAPISchemaAlternativesItem schema={schema} circularRefs={circularRefs} context={context} alternatives={alternatives}/>
+                </OpenAPIDisclosure>
+            </>);
+    }
+    return (<>
+            {description ? (<Markdown source={description} className="openapi-schema-description"/>) : null}
+            <OpenAPIDisclosure context={context} label={getDisclosureLabel(schema)}>
+                <OpenAPISchemaProperties id={id} properties={subProperties !== null && subProperties !== void 0 ? subProperties : [{ schema: schema }]} circularRefs={subProperties ? new Map(circularRefs).set(schema, id) : circularRefs} context={context}/>
+            </OpenAPIDisclosure>
+        </>);
+}
+function OpenAPISchemaAlternativesItem(props) {
+    var id = useId();
+    var schema = props.schema, circularRefs = props.circularRefs, context = props.context, alternatives = props.alternatives, parentCircularRef = props.parentCircularRef;
+    return (<InteractiveSection id={id} className={clsx('openapi-schema')}>
+            <OpenAPISchemaPresentation {...props}/>
+            {alternatives[0].map(function (alternative, index) { return (<OpenAPISchemaAlternative key={"alternative-".concat(index)} schema={alternative} circularRefs={circularRefs} context={context}/>); })}
+            {parentCircularRef ? (<OpenAPISchemaCircularRef id={parentCircularRef} schema={schema}/>) : null}
+        </InteractiveSection>);
 }
 /**
  * Render a circular reference to a schema.
@@ -118,7 +130,7 @@ export function OpenAPISchemaEnum(props) {
 export function OpenAPISchemaPresentation(props) {
     var schema = props.schema, propertyName = props.propertyName, required = props.required;
     var shouldDisplayExample = function (schema) {
-        return (typeof schema.example === 'string' ||
+        return ((typeof schema.example === 'string' && !!schema.example) ||
             typeof schema.example === 'number' ||
             typeof schema.example === 'boolean' ||
             (Array.isArray(schema.example) && schema.example.length > 0) ||
@@ -128,7 +140,7 @@ export function OpenAPISchemaPresentation(props) {
     };
     var description = resolveDescription(schema);
     return (<div className="openapi-schema-presentation">
-            <OpenAPISchemaName type={getSchemaTitle(schema)} propertyName={propertyName} required={required} deprecated={schema.deprecated}/>
+            <OpenAPISchemaName schema={schema} type={getSchemaTitle(schema)} propertyName={propertyName} required={required}/>
             {schema['x-deprecated-sunset'] ? (<div className="openapi-deprecated-sunset openapi-schema-description openapi-markdown">
                     Sunset date:{' '}
                     <span className="openapi-deprecated-sunset-date">
@@ -137,12 +149,7 @@ export function OpenAPISchemaPresentation(props) {
                 </div>) : null}
             {description ? (<Markdown source={description} className="openapi-schema-description"/>) : null}
             {shouldDisplayExample(schema) ? (<div className="openapi-schema-example">
-                    Example:{' '}
-                    <code>
-                        {typeof schema.example === 'string'
-                ? schema.example
-                : stringifyOpenAPI(schema.example)}
-                    </code>
+                    Example: <code>{formatExample(schema.example)}</code>
                 </div>) : null}
             {schema.pattern ? (<div className="openapi-schema-pattern">
                     Pattern: <code>{schema.pattern}</code>
@@ -154,17 +161,6 @@ export function OpenAPISchemaPresentation(props) {
  * Get the sub-properties of a schema.
  */
 function getSchemaProperties(schema) {
-    if (schema.allOf) {
-        return schema.allOf.reduce(function (acc, subSchema) {
-            var _a;
-            var properties = (_a = getSchemaProperties(subSchema)) !== null && _a !== void 0 ? _a : [
-                {
-                    schema: subSchema,
-                },
-            ];
-            return __spreadArray(__spreadArray([], acc, true), properties, true);
-        }, []);
-    }
     // check array AND schema.items as this is sometimes null despite what the type indicates
     if (schema.type === 'array' && !!schema.items) {
         var items = schema.items;
@@ -172,6 +168,10 @@ function getSchemaProperties(schema) {
         if (itemProperties) {
             return itemProperties;
         }
+        // If the items are a primitive type, we don't need to display them
+        if (['string', 'number', 'boolean', 'integer'].includes(items.type) && !items.enum) {
+            return null;
+        }
         return [
             {
                 propertyName: 'items',
@@ -217,8 +217,7 @@ export function getSchemaAlternatives(schema, ancestors) {
         return [flattenAlternatives('oneOf', schema.oneOf, downAncestors), schema.discriminator];
     }
     if (schema.allOf) {
-        // allOf is managed in `getSchemaProperties`
-        return null;
+        return [flattenAlternatives('allOf', schema.allOf, downAncestors), schema.discriminator];
     }
     return null;
 }
@@ -226,19 +225,18 @@ function flattenAlternatives(alternativeType, alternatives, ancestors) {
     return alternatives.reduce(function (acc, alternative) {
         var _a;
         if (!!alternative[alternativeType] && !ancestors.has(alternative)) {
-            return __spreadArray(__spreadArray([], acc, true), (((_a = getSchemaAlternatives(alternative, ancestors)) === null || _a === void 0 ? void 0 : _a[0]) || []), true);
+            acc.push.apply(acc, (((_a = getSchemaAlternatives(alternative, ancestors)) === null || _a === void 0 ? void 0 : _a[0]) || []));
         }
-        return __spreadArray(__spreadArray([], acc, true), [alternative], false);
+        else {
+            acc.push(alternative);
+        }
+        return acc;
     }, []);
 }
 export function getSchemaTitle(schema, 
 /** If the title is inferred in a oneOf with discriminator, we can use it to optimize the title */
 discriminator) {
     var _a;
-    if (schema.title) {
-        // If the schema has a title, use it
-        return schema.title;
-    }
     // Try using the discriminator
     if ((discriminator === null || discriminator === void 0 ? void 0 : discriminator.propertyName) && schema.properties) {
         var discriminatorProperty = schema.properties[discriminator.propertyName];
@@ -266,7 +264,7 @@ discriminator) {
             type += " \u00B7 ".concat(schema.format);
         }
     }
-    else if ('anyOf' in schema) {
+    if ('anyOf' in schema) {
         type = 'any of';
     }
     else if ('oneOf' in schema) {
@@ -278,17 +276,30 @@ discriminator) {
     else if ('not' in schema) {
         type = 'not';
     }
-    if (schema.minimum || schema.minLength) {
-        type += " \u00B7 min: ".concat(schema.minimum || schema.minLength);
-    }
-    if (schema.maximum || schema.maxLength) {
-        type += " \u00B7 max: ".concat(schema.maximum || schema.maxLength);
-    }
-    if (schema.default) {
-        type += " \u00B7 default: ".concat(schema.default);
+    return type;
+}
+function getDisclosureLabel(schema) {
+    var _a, _b;
+    if (schema.type === 'array' && !!schema.items) {
+        if (schema.items.oneOf) {
+            return 'available items';
+        }
+        // Fallback to "child attributes" for enums and objects
+        if (schema.items.enum || schema.items.type === 'object') {
+            return;
+        }
+        return (_b = (_a = schema.items.title) !== null && _a !== void 0 ? _a : schema.title) !== null && _b !== void 0 ? _b : getSchemaTitle(schema.items);
     }
-    if (schema.nullable) {
-        type = "".concat(type, " | nullable");
+    return schema.title;
+}
+function formatExample(example) {
+    if (typeof example === 'string') {
+        return example
+            .replace(/\n/g, ' ') // Replace newlines with spaces
+            .replace(/\s+/g, ' ') // Collapse multiple spaces/newlines into a single space
+            .replace(/([\{\}:,])\s+/g, '$1 ') // Ensure a space after {, }, :, and ,
+            .replace(/\s+([\{\}:,])/g, ' $1') // Ensure a space before {, }, :, and ,
+            .trim();
     }
-    return type;
+    return stringifyOpenAPI(example);
 }

package/dist/OpenAPISchemaName.d.ts

@@ -1,12 +1,14 @@
+import type { OpenAPIV3 } from '@gitbook/openapi-parser';
+import type React from 'react';
 interface OpenAPISchemaNameProps {
-    propertyName?: string | JSX.Element;
+    schema?: OpenAPIV3.SchemaObject;
+    propertyName?: string | React.JSX.Element;
     required?: boolean;
     type?: string;
-    deprecated?: boolean;
 }
 /**
  * Display the schema name row.
  * It includes the property name, type, required and deprecated status.
  */
-export declare function OpenAPISchemaName(props: OpenAPISchemaNameProps): JSX.Element;
+export declare function OpenAPISchemaName(props: OpenAPISchemaNameProps): React.JSX.Element;
 export {};

package/dist/OpenAPISchemaName.jsx

@@ -3,13 +3,34 @@
  * It includes the property name, type, required and deprecated status.
  */
 export function OpenAPISchemaName(props) {
-    var type = props.type, propertyName = props.propertyName, required = props.required, deprecated = props.deprecated;
+    var schema = props.schema, type = props.type, propertyName = props.propertyName, required = props.required;
+    var additionalItems = schema && getAdditionalItems(schema);
     return (<div className="openapi-schema-name">
-            {propertyName ? (<span data-deprecated={deprecated} className="openapi-schema-propertyname">
+            {propertyName ? (<span data-deprecated={schema === null || schema === void 0 ? void 0 : schema.deprecated} className="openapi-schema-propertyname">
                     {propertyName}
                 </span>) : null}
-            {type ? <span className="openapi-schema-type">{type}</span> : null}
+            <span>
+                {type ? <span className="openapi-schema-type">{type}</span> : null}
+                {additionalItems ? (<span className="openapi-schema-type">{additionalItems}</span>) : null}
+            </span>
             {required ? <span className="openapi-schema-required">required</span> : null}
-            {deprecated ? <span className="openapi-deprecated">Deprecated</span> : null}
+            {(schema === null || schema === void 0 ? void 0 : schema.deprecated) ? <span className="openapi-deprecated">Deprecated</span> : null}
         </div>);
 }
+function getAdditionalItems(schema) {
+    var additionalItems = '';
+    if (schema.minimum || schema.minLength) {
+        additionalItems += " \u00B7 min: ".concat(schema.minimum || schema.minLength);
+    }
+    if (schema.maximum || schema.maxLength) {
+        additionalItems += " \u00B7 max: ".concat(schema.maximum || schema.maxLength);
+    }
+    // If the schema has a default value, we display it
+    if (typeof schema.default !== 'undefined') {
+        additionalItems += " \u00B7 default: ".concat(schema.default);
+    }
+    if (schema.nullable) {
+        additionalItems = ' | nullable';
+    }
+    return additionalItems;
+}