@scalar/openapi-to-markdown 1.5.3 → 1.6.0

package/dist/parse-description.js

@@ -10,8 +10,9 @@ const clean = (node) => {
         node.url = safeUrl(node.url);
     }
     if ('children' in node) {
-        for (const child of node.children)
+        for (const child of node.children) {
             clean(child);
+        }
         // The filter preserves the parent's existing child types.
         const previousLength = node.children.length;
         node.children = node.children.filter((child) => child.type !== 'image' &&
@@ -33,10 +34,12 @@ const clean = (node) => {
         if (node.children.length !== previousLength) {
             const first = node.children.at(0);
             const last = node.children.at(-1);
-            if (first?.type === 'text')
+            if (first?.type === 'text') {
                 first.value = first.value.trimStart();
-            if (last?.type === 'text')
+            }
+            if (last?.type === 'text') {
                 last.value = last.value.trimEnd();
+            }
         }
     }
     delete node.position;
@@ -47,24 +50,31 @@ const pruneDefinitions = (tree) => {
     const footnotes = new Set();
     const definitions = new Map(tree.children.filter((node) => node.type === 'footnoteDefinition').map((node) => [node.identifier, node]));
     const collect = (node) => {
-        if (node.type === 'linkReference')
+        if (node.type === 'linkReference') {
             links.add(node.identifier);
-        if (node.type === 'footnoteReference')
+        }
+        if (node.type === 'footnoteReference') {
             footnotes.add(node.identifier);
-        if ('children' in node)
+        }
+        if ('children' in node) {
             node.children.forEach(collect);
+        }
     };
     tree.children.filter((node) => node.type !== 'footnoteDefinition').forEach(collect);
     // Set iteration also visits footnotes discovered inside another footnote.
-    for (const identifier of footnotes)
+    for (const identifier of footnotes) {
         definitions.get(identifier)?.children.forEach(collect);
+    }
     tree.children = tree.children.filter((node) => {
-        if (node.type === 'definition')
+        if (node.type === 'definition') {
             return links.has(node.identifier);
-        if (node.type === 'footnoteDefinition')
+        }
+        if (node.type === 'footnoteDefinition') {
             return footnotes.has(node.identifier);
-        if (node.type === 'paragraph')
+        }
+        if (node.type === 'paragraph') {
             return node.children.some((child) => child.type !== 'text' || child.value.trim());
+        }
         return true;
     });
 };
@@ -78,8 +88,9 @@ export const createDescriptionParser = () => {
     const cache = new Map();
     const parse = async (value) => {
         // Most schema descriptions are one plain sentence. Parsing them costs more than the page's other text.
-        if (isPlainText(value))
+        if (isPlainText(value)) {
             return [{ type: 'paragraph', children: [{ type: 'text', value: value.trim() }] }];
+        }
         const parsed = parser.parse(value);
         // Raw HTML and GitHub alerts retain Scalar's existing conversion behavior.
         const tree = containsHtml(parsed) || /^\s*>\s*\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION|SUCCESS)\]/im.test(value)
@@ -93,26 +104,31 @@ export const createDescriptionParser = () => {
         const copy = { ...node };
         if ('identifier' in copy) {
             copy.identifier = `${prefix}${copy.identifier}`;
-            if ('label' in copy)
+            if ('label' in copy) {
                 copy.label = copy.identifier;
-            if ('referenceType' in copy)
+            }
+            if ('referenceType' in copy) {
                 copy.referenceType = 'full';
+            }
         }
-        if ('children' in copy)
+        if ('children' in copy) {
             copy.children = copy.children.map((child) => namespace(child, prefix));
+        }
         return copy;
     };
     const hasReference = (node) => 'identifier' in node || ('children' in node && node.children.some(hasReference));
     return () => {
         const state = { nextId: 0 };
         return async (value) => {
-            if (!value)
+            if (!value) {
                 return [];
+            }
             const prefix = `description-${state.nextId++}-`;
             const cached = cache.get(value) ?? parse(value);
             if (!cache.has(value)) {
-                if (cache.size >= 8192)
+                if (cache.size >= 8192) {
                     cache.clear();
+                }
                 cache.set(value, cached);
             }
             const nodes = await cached;
@@ -127,10 +143,12 @@ export const expandDescriptions = async (nodes, description) => {
     const found = [];
     const collect = (siblings) => {
         for (const node of siblings) {
-            if (node.type === 'descriptionPlaceholder')
+            if (node.type === 'descriptionPlaceholder') {
                 found.push({ siblings, node });
-            else if ('children' in node)
+            }
+            else if ('children' in node) {
                 collect(node.children);
+            }
         }
     };
     collect(nodes);

package/dist/render-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-document.d.ts","sourceRoot":"","sources":["../src/render-document.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,8DAA8D,CAAA;AAcrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AA+C7D,2FAA2F;AAC3F,eAAO,MAAM,sBAAsB,QAAO,CAAC,CACzC,QAAQ,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,oBAAoB,KAC3B,OAAO,CAAC,MAAM,CAAC,CAuPnB,CAAA"}
+{"version":3,"file":"render-document.d.ts","sourceRoot":"","sources":["../src/render-document.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,8DAA8D,CAAA;AAerE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAwD7D,2FAA2F;AAC3F,eAAO,MAAM,sBAAsB,QAAO,CAAC,CACzC,QAAQ,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,oBAAoB,KAC3B,OAAO,CAAC,MAAM,CAAC,CAyRnB,CAAA"}

package/dist/render-document.js

@@ -12,20 +12,24 @@ import { renderExamples } from './render-examples.js';
 import { formatOperationMethod, renderOperation } from './render-operation.js';
 import { createSchemaRenderer } from './render-schema.js';
 import { renderSecurity } from './render-security.js';
+import { getTagSections } from './render-tags.js';
 const serializer = unified()
     .use(remarkGfm)
     .use(remarkStringify, {
     bullet: '-',
     join: [
         (left, right, parent) => {
-            if (!('spread' in parent))
+            if (!('spread' in parent)) {
                 return undefined;
+            }
             // Inside a tight list item, content after a nested list would otherwise continue its last item.
-            if (left.type === 'list' && right.type !== 'list')
+            if (left.type === 'list' && right.type !== 'list') {
                 return 1;
+            }
             // Code blocks in descriptions read better apart from the prose around them.
-            if (left.type === 'code' || right.type === 'code')
+            if (left.type === 'code' || right.type === 'code') {
                 return 1;
+            }
             return undefined;
         },
     ],
@@ -43,12 +47,14 @@ const renderShownModel = async (name, view, previous, description) => {
         ? [strong(text(view.title)), text(' ('), inlineCode(name), text(')')]
         : [inlineCode(name)];
     label.push(text(' — shown above'));
-    if (previous.name !== name)
+    if (previous.name !== name) {
         label.push(text(' as '), inlineCode(previous.name));
+    }
     label.push(text('.'));
     const blocks = [paragraph(...label)];
-    if (view.description && view.description !== previous.description)
+    if (view.description && view.description !== previous.description) {
         blocks.push(...(await description(view.description)));
+    }
     return item(...blocks);
 };
 /** Build Markdown directly, retaining caches only for this immutable document snapshot. */
@@ -81,8 +87,9 @@ export const createDocumentRenderer = () => {
             const entries = [];
             for (const [path, reference] of Object.entries(group.paths ?? {})) {
                 const pathItem = getResolvedPathItem(reference);
-                if (!pathItem)
+                if (!pathItem) {
                     continue;
+                }
                 forEachPathItemOperation(reference, (method, operation) => {
                     const label = `${formatOperationMethod(method)} ${path}`;
                     entries.push({
@@ -107,8 +114,9 @@ export const createDocumentRenderer = () => {
         const nodes = [];
         const sections = [];
         const flush = async () => {
-            if (!nodes.length)
+            if (!nodes.length) {
                 return;
+            }
             const children = nodes.splice(0);
             await expandDescriptions(children, description);
             sections.push(serializer.stringify({ type: 'root', children }).trimEnd());
@@ -116,63 +124,73 @@ export const createDocumentRenderer = () => {
         if (!single) {
             const { info } = document;
             const metadata = [field('OpenAPI Version', inlineCode(document.openapi))];
-            if (info.version)
+            if (info.version) {
                 metadata.push(field('API Version', inlineCode(info.version)));
-            if (info.termsOfService)
+            }
+            if (info.termsOfService) {
                 metadata.push(field('Terms of service', link(info.termsOfService, info.termsOfService)));
+            }
             if (info.contact) {
                 const contact = [text(info.contact.name ?? '')];
                 metadata.push(item(paragraph(strong(text('Contact:')), text(' '), ...contact, ...(info.contact.url ? [text(' '), link(info.contact.url, info.contact.url)] : []), ...(info.contact.email ? [text(' '), link(`mailto:${info.contact.email}`, info.contact.email)] : []))));
             }
-            if (info.license)
+            if (info.license) {
                 metadata.push(field('License', info.license.url ? link(info.license.url, info.license.name ?? '') : text(info.license.name)));
+            }
             nodes.push(heading(1, text(info.title)), list(metadata), ...(await description(info.description)));
             if (whole) {
                 const contents = [];
                 for (const group of groups) {
-                    if (!group.entries.length)
+                    if (!group.entries.length) {
                         continue;
+                    }
                     contents.push(paragraph(strong(text(group.title))), list(group.entries.map(({ id, label }) => item(paragraph(link(`#${encodeURIComponent(id)}`, label))))));
                 }
                 if (destinations?.size) {
                     contents.push(paragraph(strong(text('Schemas'))), list([...destinations].map(([name, url]) => item(paragraph(link(url, name))))));
                 }
-                if (contents.length)
+                if (contents.length) {
                     nodes.push(heading(2, text('Contents')), ...contents);
+                }
             }
             if (document.servers?.length || (whole && document.servers !== undefined)) {
-                if (documentContext?.servers)
+                if (documentContext?.servers) {
                     nodes.push(anchor(documentContext.servers));
+                }
                 nodes.push(heading(2, text('Servers')));
                 const effectiveServers = document.servers?.length
                     ? document.servers
                     : [{ url: '/' }];
                 const servers = effectiveServers.map((server) => {
                     const nested = [];
-                    if (server.description)
+                    if (server.description) {
                         nested.push(field('Description', text(server.description)));
+                    }
                     const variables = Object.entries(server.variables ?? {});
-                    if (variables.length)
+                    if (variables.length) {
                         nested.push(item(paragraph(strong(text('Variables:'))), list(variables.map(([name, variable]) => item(paragraph(inlineCode(name), text(' (default: '), inlineCode(variable.default), text(')'), ...(whole && variable.enum?.length
                             ? [text(', possible values: '), inlineCode(variable.enum.join(', '))]
                             : []), text(variable.description ? `: ${variable.description}` : '')))))));
+                    }
                     const entry = field('URL', inlineCode(server.url));
-                    if (nested.length)
+                    if (nested.length) {
                         entry.children.push(list(nested));
+                    }
                     return entry;
                 });
                 nodes.push(list(servers));
             }
-            if (documentContext?.authentication)
+            if (documentContext?.authentication) {
                 nodes.push(anchor(documentContext.authentication));
+            }
             nodes.push(...(await renderSecurity(document.security, document.components?.securitySchemes, description, 2)));
             if (document.tags?.length) {
                 nodes.push(heading(2, text('Tags')));
-                for (const tag of document.tags) {
-                    const title = /^3\.2\./.test(openapiVersion) ? (tag.summary ?? tag.name) : tag.name;
+                for (const { tag, title } of getTagSections(document.tags, openapiVersion)) {
                     nodes.push(heading(3, text(title)), ...(await description(tag.description)));
-                    if (tag.externalDocs)
+                    if (tag.externalDocs) {
                         nodes.push(paragraph(link(tag.externalDocs.url, tag.externalDocs.description ?? tag.externalDocs.url)));
+                    }
                 }
             }
             await flush();
@@ -180,12 +198,14 @@ export const createDocumentRenderer = () => {
         for (const group of groups) {
             let hasOperations = false;
             for (const { path, pathItem, method, operation, id } of group.entries) {
-                if (!hasOperations && !single)
+                if (!hasOperations && !single) {
                     nodes.push(heading(2, text(group.title)));
+                }
                 hasOperations = true;
                 schemas.beginSection();
-                if (id)
+                if (id) {
                     nodes.push(anchor(id));
+                }
                 nodes.push(...(await renderOperation(document, path, method, pathItem, operation, group.webhook, {
                     description,
                     schemas,
@@ -201,11 +221,13 @@ export const createDocumentRenderer = () => {
         const renderModel = async (name, schema, level) => {
             const view = schemas.view(schema);
             const summary = schemas.summarize(schema);
-            if (whole)
+            if (whole) {
                 nodes.push(anchor(anchors.get('schema', name)));
+            }
             nodes.push(heading(level, text(view.title ?? name)));
-            if (summary.length)
+            if (summary.length) {
                 nodes.push(paragraph(strong(text('Type:')), text('\u00a0'), ...summary));
+            }
             nodes.push(...(await description(view.description)), ...schemas.render(schema, 0, [], { hideDetails: true, name }));
             if (view.type === 'object' || hasAuthoredExamples(view)) {
                 // A model page's own schema is bounded, so it gets a generated example even in linked mode.
@@ -224,13 +246,15 @@ export const createDocumentRenderer = () => {
             await renderModel(selected[0], selected[1], 1);
         }
         const dependencies = models.filter(([name]) => name !== options.model);
-        if (dependencies.length)
+        if (dependencies.length) {
             nodes.push(heading(2, text('Schemas')));
+        }
         // Models the page already expanded cost one line each, grouped into a single list.
         const shownAbove = [];
         const flushShownAbove = () => {
-            if (shownAbove.length)
+            if (shownAbove.length) {
                 nodes.push(list(shownAbove.splice(0)));
+            }
         };
         for (const [name, schema] of dependencies) {
             schemas.beginSection();

package/dist/render-examples.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-examples.d.ts","sourceRoot":"","sources":["../src/render-examples.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAQ,WAAW,EAAE,MAAM,OAAO,CAAA;AAG9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,KAAK,aAAa,EAAuB,MAAM,yBAAyB,CAAA;AAEjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAE5D,+EAA+E;AAC/E,eAAO,MAAM,cAAc,GACzB,QAAQ,aAAa,EACrB,aAAa,iBAAiB,EAC9B,kBAA8B,EAC9B,OAAO,MAAM,GAAG,OAAO,EACvB,uBAAwB,EAExB,6BAAqC,EACrC,+BAIG;IACD,yFAAyF;IACzF,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,gFAAgF;IAChF,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,oFAAoF;IACpF,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CACvB,KACL,OAAO,CAAC,WAAW,EAAE,CA8EvB,CAAA"}
+{"version":3,"file":"render-examples.d.ts","sourceRoot":"","sources":["../src/render-examples.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAQ,WAAW,EAAE,MAAM,OAAO,CAAA;AAG9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,KAAK,aAAa,EAAuB,MAAM,yBAAyB,CAAA;AAEjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAE5D,+EAA+E;AAC/E,eAAO,MAAM,cAAc,GACzB,QAAQ,aAAa,EACrB,aAAa,iBAAiB,EAC9B,kBAA8B,EAC9B,OAAO,MAAM,GAAG,OAAO,EACvB,uBAAwB,EAExB,6BAAqC,EACrC,+BAIG;IACD,yFAAyF;IACzF,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,gFAAgF;IAChF,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,oFAAoF;IACpF,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CACvB,KACL,OAAO,CAAC,WAAW,EAAE,CAgFvB,CAAA"}

package/dist/render-examples.js

@@ -10,11 +10,13 @@ schemaOpenapiVersion = openapiVersion, { linked = false, quiet = linked, example
     const nodes = [];
     const values = (examples?.get ?? getMarkdownExamples)(source, mediaType, mode, openapiVersion, schemaOpenapiVersion, linked);
     for (const example of values) {
-        if ('omitted' in example && quiet)
+        if ('omitted' in example && quiet) {
             continue;
+        }
         const start = nodes.length;
         const generated = examples && example.generated;
-        nodes.push(paragraph(strong(text(generated ? 'Generated example:' : example.name ? `Example: ${example.name}` : 'Example:'))));
+        const exampleLabel = example.name ? `Example: ${example.name}` : 'Example:';
+        nodes.push(paragraph(strong(text(generated ? 'Generated example:' : exampleLabel))));
         const addCode = (code) => {
             if (generated) {
                 const scope = JSON.stringify([mediaType, mode, openapiVersion, schemaOpenapiVersion, code.lang]);
@@ -31,8 +33,9 @@ schemaOpenapiVersion = openapiVersion, { linked = false, quiet = linked, example
             nodes.push(paragraph(emphasis(text('Generated example omitted because it is too large.'))));
             continue;
         }
-        if (example.summary)
+        if (example.summary) {
             nodes.push(paragraph(text(example.summary)));
+        }
         nodes.push(...(await description(example.description)));
         if ('error' in example) {
             nodes.push(paragraph(text(example.error)));
@@ -43,9 +46,10 @@ schemaOpenapiVersion = openapiVersion, { linked = false, quiet = linked, example
             continue;
         }
         if ('serializedValue' in example) {
+            const textLanguage = mediaType.includes('json') ? 'json' : 'text';
             addCode({
                 type: 'code',
-                lang: isXmlMediaType(mediaType) ? 'xml' : mediaType.includes('json') ? 'json' : 'text',
+                lang: isXmlMediaType(mediaType) ? 'xml' : textLanguage,
                 value: example.serializedValue,
             });
             continue;

package/dist/render-operation-details.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-operation-details.d.ts","sourceRoot":"","sources":["../src/render-operation-details.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAA;AAClH,OAAO,KAAK,EAAY,WAAW,EAAE,MAAM,OAAO,CAAA;AAElD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAE3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD,wFAAwF;AACxF,eAAO,MAAM,aAAa,GACxB,SAAS,cAAc,CAAC,SAAS,CAAC,EAClC,aAAa,iBAAiB,EAC9B,SAAS,cAAc,EACvB,gBAAgB,MAAM,EACtB,6BAAqC,EACrC,WAAW,gBAAgB,KAC1B,OAAO,CAAC,WAAW,EAAE,CAuCvB,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,SAAS,EACpD,WAAW,MAAM,EACjB,aAAa,iBAAiB,EAC9B,SAAS,cAAc,EACvB,gBAAgB,MAAM,EACtB,6BAAqC,EACrC,WAAW,gBAAgB,KAC1B,OAAO,CAAC,WAAW,EAAE,CA8BvB,CAAA;AAID,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,GAC9B,OAAO,cAAc,CAAC,OAAO,CAAC,EAC9B,aAAa,iBAAiB,KAC7B,OAAO,CAAC,WAAW,EAAE,CA2BvB,CAAA"}
+{"version":3,"file":"render-operation-details.d.ts","sourceRoot":"","sources":["../src/render-operation-details.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAA;AAClH,OAAO,KAAK,EAAY,WAAW,EAAE,MAAM,OAAO,CAAA;AAElD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAE3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD,wFAAwF;AACxF,eAAO,MAAM,aAAa,GACxB,SAAS,cAAc,CAAC,SAAS,CAAC,EAClC,aAAa,iBAAiB,EAC9B,SAAS,cAAc,EACvB,gBAAgB,MAAM,EACtB,6BAAqC,EACrC,WAAW,gBAAgB,KAC1B,OAAO,CAAC,WAAW,EAAE,CA8CvB,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,SAAS,EACpD,WAAW,MAAM,EACjB,aAAa,iBAAiB,EAC9B,SAAS,cAAc,EACvB,gBAAgB,MAAM,EACtB,6BAAqC,EACrC,WAAW,gBAAgB,KAC1B,OAAO,CAAC,WAAW,EAAE,CAqCvB,CAAA;AAID,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,GAC9B,OAAO,cAAc,CAAC,OAAO,CAAC,EAC9B,aAAa,iBAAiB,KAC7B,OAAO,CAAC,WAAW,EAAE,CAoCvB,CAAA"}

package/dist/render-operation-details.js

@@ -6,24 +6,28 @@ export const renderHeaders = async (headers, description, schemas, openapiVersio
     const entries = [];
     for (const [name, reference] of Object.entries(headers ?? {})) {
         // OpenAPI reserves Content-Type for the media type map / encoding field.
-        if (name.toLowerCase() === 'content-type')
+        if (name.toLowerCase() === 'content-type') {
             continue;
-        if (!getResolvedRef(reference))
+        }
+        if (!getResolvedRef(reference)) {
             continue;
+        }
         const header = getResolvedRef(reference, mergeSiblingReferences);
         const blocks = [
             paragraph(strong(inlineCode(name)), text(header.required ? ' (required)' : '')),
             ...(await description(header.description)),
         ];
-        if ('schema' in header && header.schema !== undefined)
+        if ('schema' in header && header.schema !== undefined) {
             blocks.push(...schemas.render(header.schema));
+        }
         if ('example' in header || 'examples' in header) {
             blocks.push(...(await renderExamples({ example: header.example, examples: header.examples }, description, 'application/json', undefined, openapiVersion, schemaOpenapiVersion, { linked: schemas.linked, examples })));
         }
         for (const [mediaType, content] of Object.entries('content' in header ? (header.content ?? {}) : {})) {
             blocks.push(paragraph(strong(text('Content-Type:')), text(` ${mediaType}`)));
-            if (content.schema !== undefined)
+            if (content.schema !== undefined) {
                 blocks.push(...schemas.render(content.schema));
+            }
             blocks.push(...(await renderExamples(content, description, mediaType, undefined, openapiVersion, schemaOpenapiVersion, {
                 linked: schemas.linked,
                 examples,
@@ -36,8 +40,9 @@ export const renderHeaders = async (headers, description, schemas, openapiVersio
 /** Preserve explicit encoding settings, including false flags and part headers. */
 export const renderEncoding = async (encoding, mediaType, description, schemas, openapiVersion, schemaOpenapiVersion = openapiVersion, examples) => {
     const multipart = mediaType.startsWith('multipart/');
-    if (!multipart && mediaType !== 'application/x-www-form-urlencoded')
+    if (!multipart && mediaType !== 'application/x-www-form-urlencoded') {
         return [];
+    }
     const entries = [];
     for (const [name, entry] of Object.entries(encoding ?? {})) {
         const fields = [];
@@ -47,14 +52,17 @@ export const renderEncoding = async (encoding, mediaType, description, schemas,
             ['explode', 'Explode'],
             ['allowReserved', 'Allow reserved'],
         ]) {
-            if (entry[key] !== undefined)
+            if (entry[key] !== undefined) {
                 fields.push(item(paragraph(text(`${label}: `), inlineCode(entry[key]))));
+            }
         }
         const blocks = [paragraph(strong(inlineCode(name)))];
-        if (fields.length)
+        if (fields.length) {
             blocks.push(list(fields));
-        if (multipart)
+        }
+        if (multipart) {
             blocks.push(...(await renderHeaders(entry.headers, description, schemas, openapiVersion, schemaOpenapiVersion, examples)));
+        }
         entries.push(item(...blocks));
     }
     return entries.length ? [paragraph(strong(text('Encoding:'))), list(entries)] : [];
@@ -64,24 +72,30 @@ const formatValue = (value) => (typeof value === 'string' ? value : (JSON.string
 export const renderResponseLinks = async (links, description) => {
     const entries = [];
     for (const [name, reference] of Object.entries(links ?? {})) {
-        if (!getResolvedRef(reference))
+        if (!getResolvedRef(reference)) {
             continue;
+        }
         const link = getResolvedRef(reference, mergeSiblingReferences);
         const blocks = [
             paragraph(strong(text(name))),
             ...(await description(link.description)),
         ];
-        if (link.operationId)
+        if (link.operationId) {
             blocks.push(paragraph(strong(text('Operation ID:')), text(' '), inlineCode(link.operationId)));
-        if (link.operationRef)
+        }
+        if (link.operationRef) {
             blocks.push(paragraph(strong(text('Operation reference:')), text(' '), inlineCode(link.operationRef)));
+        }
         const parameters = Object.entries(link.parameters ?? {});
-        if (parameters.length)
+        if (parameters.length) {
             blocks.push(list(parameters.map(([name, value]) => item(paragraph(strong(text(`${name}:`)), text(' '), inlineCode(formatValue(value)))))));
-        if (link.requestBody !== undefined)
+        }
+        if (link.requestBody !== undefined) {
             blocks.push(paragraph(strong(text('Request body:')), text(' '), inlineCode(formatValue(link.requestBody))));
-        if (link.server)
+        }
+        if (link.server) {
             blocks.push(paragraph(strong(text('Server:')), text(' '), inlineCode(link.server.url)));
+        }
         entries.push(item(...blocks));
     }
     return entries.length ? [paragraph(strong(text('Links:'))), list(entries)] : [];

package/dist/render-operation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-operation.d.ts","sourceRoot":"","sources":["../src/render-operation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAEf,cAAc,EAGf,MAAM,8DAA8D,CAAA;AACrE,OAAO,KAAK,EAAsC,WAAW,EAAE,MAAM,OAAO,CAAA;AAE5E,OAAO,EAAU,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAE3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAG5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGrD,oEAAoE;AACpE,KAAK,aAAa,GAAG;IACnB,WAAW,EAAE,iBAAiB,CAAA;IAC9B,OAAO,EAAE,cAAc,CAAA;IACvB,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAC3B,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,qEAAqE;AACrE,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAA;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC,CAAA;AAoCD,yEAAyE;AACzE,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,KAAG,MACkC,CAAA;AAEzF,iFAAiF;AACjF,eAAO,MAAM,eAAe,GAC1B,UAAU,eAAe,EACzB,MAAM,MAAM,EACZ,QAAQ,MAAM,EACd,UAAU,cAAc,EACxB,WAAW,eAAe,EAC1B,SAAS,OAAO,EAChB,4DAAgE,aAAa,KAC5E,OAAO,CAAC,WAAW,EAAE,CAiLvB,CAAA"}
+{"version":3,"file":"render-operation.d.ts","sourceRoot":"","sources":["../src/render-operation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAEf,cAAc,EAGf,MAAM,8DAA8D,CAAA;AACrE,OAAO,KAAK,EAAsC,WAAW,EAAE,MAAM,OAAO,CAAA;AAE5E,OAAO,EAAU,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAE3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAG5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGrD,oEAAoE;AACpE,KAAK,aAAa,GAAG;IACnB,WAAW,EAAE,iBAAiB,CAAA;IAC9B,OAAO,EAAE,cAAc,CAAA;IACvB,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAC3B,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,qEAAqE;AACrE,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAA;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC,CAAA;AA8CD,yEAAyE;AACzE,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,KAAG,MACkC,CAAA;AAEzF,iFAAiF;AACjF,eAAO,MAAM,eAAe,GAC1B,UAAU,eAAe,EACzB,MAAM,MAAM,EACZ,QAAQ,MAAM,EACd,UAAU,cAAc,EACxB,WAAW,eAAe,EAC1B,SAAS,OAAO,EAChB,4DAAgE,aAAa,KAC5E,OAAO,CAAC,WAAW,EAAE,CAwMvB,CAAA"}