@redocly/openapi-docs 0.74.2-pingfed.3 → 0.81.2-rc.2

package/lib-esm/services/config-options/types.d.ts

@@ -0,0 +1,100 @@
+import type { ComponentType } from 'react';
+import type { Schema, ConfigFunction } from '@markdoc/markdoc/dist/src/types';
+import type { CodeSamplesConfig } from '../code-samples';
+import type { HooksConfig, Unstable_ExternalCodeSample } from '../types';
+import type { Events } from '../../events';
+import type { LayoutVariant } from '@redocly/theme';
+import type { OperationModel } from '../../models/types';
+import type { DownloadUrlsConfig } from '../../components/Download/types';
+export interface RawOptions {
+    licenseKey?: string;
+    scrollYOffset?: number | string | (() => number);
+    hideLoading?: boolean | string;
+    markdocOptions?: {
+        tags: Record<string, Schema>;
+        nodes: Record<string, Schema>;
+        components: Record<string, ComponentType>;
+        variables?: Record<string, any>;
+        partials?: Record<string, any>;
+        functions?: Record<string, ConfigFunction>;
+    };
+    disableRouter?: boolean;
+    hideSidebar?: boolean;
+    feedback?: Record<string, any>;
+    unstable_hooks?: HooksConfig;
+    oAuth2RedirectURI?: string | null;
+    corsProxyUrl?: string;
+    requestInterceptor?: ((req: Request, operation: OperationModel) => void) | undefined | null;
+    sortRequiredPropsFirst?: boolean | string;
+    sanitize?: boolean | string;
+    hideDownloadButtons?: boolean | string;
+    downloadUrls?: DownloadUrlsConfig;
+    onlyRequiredInSamples?: boolean | string;
+    generatedSamplesMaxDepth?: number | string;
+    showExtensions?: boolean | string | string[];
+    hideSchemaTitles?: boolean | string;
+    jsonSamplesExpandLevel?: number | string | 'all';
+    schemasExpansionLevel?: number | string | 'all';
+    mockServer?: {
+        url?: string;
+        position?: 'first' | 'last' | 'replace' | 'off';
+        description?: string;
+    };
+    maxDisplayedEnumValues?: number;
+    unstable_externalCodeSamples?: Unstable_ExternalCodeSample[];
+    schemaDefinitionsTagName?: string;
+    layout?: LayoutVariant;
+    hideInfoMetadata?: boolean;
+    events?: Events;
+    onDeepLinkClick?: ((link: string) => void) | undefined | null;
+    skipBundle?: boolean;
+    routingBasePath?: string;
+    codeSamples?: CodeSamplesConfig;
+    ignoreNamedSchemas?: string[] | string;
+    hidePropertiesPrefix?: boolean;
+}
+export interface Options {
+    scrollYOffset: () => number;
+    hideLoading: boolean;
+    markdocOptions?: {
+        tags: Record<string, Schema>;
+        nodes: Record<string, Schema>;
+        components: Record<string, ComponentType>;
+        variables?: Record<string, any>;
+        partials?: Record<string, any>;
+        functions?: Record<string, ConfigFunction>;
+    };
+    hideSidebar: boolean;
+    feedback: Record<string, any>;
+    unstable_hooks: HooksConfig;
+    oAuth2RedirectURI: string | null;
+    corsProxyUrl?: string;
+    requestInterceptor: ((req: Request, operation: OperationModel) => void) | undefined | null;
+    sortRequiredPropsFirst: boolean;
+    sanitize: boolean;
+    hideDownloadButtons: boolean | null;
+    downloadUrls?: DownloadUrlsConfig;
+    onlyRequiredInSamples: boolean;
+    generatedSamplesMaxDepth: number;
+    showExtensions: string[] | boolean;
+    hideSchemaTitles: boolean;
+    jsonSamplesExpandLevel: number;
+    schemasExpansionLevel: number | undefined;
+    mockServer?: {
+        url: string;
+        position: 'first' | 'last' | 'replace' | 'off';
+        description: string;
+    };
+    maxDisplayedEnumValues: number;
+    ignoreNamedSchemas: Set<string>;
+    unstable_externalCodeSamples: Unstable_ExternalCodeSample[];
+    schemaDefinitionsTagName?: string;
+    layout: LayoutVariant;
+    hideInfoMetadata: boolean;
+    events: Events;
+    onDeepLinkClick: ((link: string) => void) | undefined | null;
+    skipBundle: boolean;
+    routingBasePath: string;
+    codeSamples: CodeSamplesConfig;
+    hidePropertiesPrefix: boolean;
+}

package/lib-esm/services/history/helpers.d.ts

@@ -2,3 +2,4 @@ import type { FieldModel } from '../../models';
 export declare function isSameHash(a: string, b: string): boolean;
 export declare function constructFieldDeepFragment(field: FieldModel): string;
 export declare function joinWithSeparator(base?: string, path?: string, sep?: string): string;
+export declare function makeDeepLink(operationId: string, suffix: string): string;

package/lib-esm/services/history/helpers.js

@@ -1,2 +1,2 @@
-import{queryString}from"../../utils";import{getActiveMediaType}from"../../models/mediaContent";export function isSameHash(e,o){return e===o||"#"+e===o||e==="#"+o}function getContentTypeName(e){var o,n,t,i,d,s,p,r,l,v,u,a,c;if(!e.in)return"request"===e.deps.type&&(null===(t=null===(n=null===(o=e.deps.operation)||void 0===o?void 0:o.requestBody)||void 0===n?void 0:n.content)||void 0===t?void 0:t.mediaTypes)?(null===(s=null===(d=null===(i=e.deps.operation)||void 0===i?void 0:i.requestBody)||void 0===d?void 0:d.content)||void 0===s?void 0:s.mediaTypes.length)>1?(null===(r=null===(p=e.deps.operation)||void 0===p?void 0:p.requestBody)||void 0===r?void 0:r.content)&&getActiveMediaType(e.deps.operation.requestBody.content).name:void 0:"response"===e.deps.type&&(null===(v=null===(l=e.deps.response)||void 0===l?void 0:l.content)||void 0===v?void 0:v.mediaTypes)&&(null===(a=null===(u=e.deps.response)||void 0===u?void 0:u.content)||void 0===a?void 0:a.mediaTypes.length)>1?(null===(c=e.deps.response)||void 0===c?void 0:c.content)&&getActiveMediaType(e.deps.response.content).name:void 0}export function constructFieldDeepFragment(e){var o,n;if(!e)return"";const t={t:e.deps.type,in:e.in||e.deps.in,c:"response"===e.deps.type?null===(o=e.deps.response)||void 0===o?void 0:o.code:void 0,cb:(null===(n=e.deps.operation)||void 0===n?void 0:n.isCallback)?e.deps.operation.callbackId:void 0,ct:getContentTypeName(e),path:e.fieldFullPath};return queryString.stringify(t,{encode:!1,sort:!1})}export function joinWithSeparator(e="",o="",n="/"){return e.endsWith(n)&&(e=e.slice(0,-n.length)),o.startsWith(n)&&(o=o.slice(n.length)),e&&o?e+n+o:e+o}
+import{encodeBackSlashes,queryString}from"../../utils";import{getActiveMediaType}from"../../models/mediaContent";export function isSameHash(e,o){return e===o||"#"+e===o||e==="#"+o}function getContentTypeName(e){var o,n,t,i,d,s,r,p,l,a,v,u,c;if(!e.in)return"request"===e.deps.type&&(null===(t=null===(n=null===(o=e.deps.operation)||void 0===o?void 0:o.requestBody)||void 0===n?void 0:n.content)||void 0===t?void 0:t.mediaTypes)?(null===(s=null===(d=null===(i=e.deps.operation)||void 0===i?void 0:i.requestBody)||void 0===d?void 0:d.content)||void 0===s?void 0:s.mediaTypes.length)>1?(null===(p=null===(r=e.deps.operation)||void 0===r?void 0:r.requestBody)||void 0===p?void 0:p.content)&&getActiveMediaType(e.deps.operation.requestBody.content).name:void 0:"response"===e.deps.type&&(null===(a=null===(l=e.deps.response)||void 0===l?void 0:l.content)||void 0===a?void 0:a.mediaTypes)&&(null===(u=null===(v=e.deps.response)||void 0===v?void 0:v.content)||void 0===u?void 0:u.mediaTypes.length)>1?(null===(c=e.deps.response)||void 0===c?void 0:c.content)&&getActiveMediaType(e.deps.response.content).name:void 0}export function constructFieldDeepFragment(e){var o,n;if(!e)return"";const t={t:e.deps.type,in:e.in||e.deps.in,c:"response"===e.deps.type?null===(o=e.deps.response)||void 0===o?void 0:o.code:void 0,cb:(null===(n=e.deps.operation)||void 0===n?void 0:n.isCallback)?e.deps.operation.callbackId:void 0,ct:getContentTypeName(e),path:e.fieldFullPath};return queryString.stringify(t,{encode:!1,sort:!1})}export function joinWithSeparator(e="",o="",n="/"){return e.endsWith(n)&&(e=e.slice(0,-n.length)),o.startsWith(n)&&(o=o.slice(n.length)),e&&o?e+n+o:e+o}export function makeDeepLink(e,o){return(`/${e=encodeBackSlashes(e)}#`+joinWithSeparator(e,o)).toLowerCase()}
 //# sourceMappingURL=helpers.js.map

package/lib-esm/services/index.d.ts

@@ -1,12 +1,8 @@
 export * from './history';
 export * from './code-samples';
 export * from './types';
-export * from './labels';
 export { OpenAPIParser } from './OpenAPIParser';
 export { buildContentItems } from './menu';
-export { SearchStore } from './search';
-export type { SearchResultMeta } from './search';
-export { MarkerService } from './MarkerService';
 export * from './types';
-export * from './Options';
+export * from './config-options';
 export { deepClone } from './utils';

package/lib-esm/services/index.js

@@ -1,2 +1,2 @@
-export*from"./history";export*from"./code-samples";export*from"./types";export*from"./labels";export{OpenAPIParser}from"./OpenAPIParser";export{buildContentItems}from"./menu";export{SearchStore}from"./search";export{MarkerService}from"./MarkerService";export*from"./types";export*from"./Options";export{deepClone}from"./utils";
+export*from"./history";export*from"./code-samples";export*from"./types";export{OpenAPIParser}from"./OpenAPIParser";export{buildContentItems}from"./menu";export*from"./types";export*from"./config-options";export{deepClone}from"./utils";
 //# sourceMappingURL=index.js.map

package/lib-esm/services/menu/builder.d.ts

@@ -1,5 +1,5 @@
 import type { OpenAPIParser } from '../OpenAPIParser';
-import type { Options } from '../Options';
+import type { Options } from '../config-options';
 import type { ContentItemModel } from '../../models';
 import type { ExtendedMenuItem, IMenuItem } from '../types';
 export declare function buildMenuStructure(parser: OpenAPIParser, options: Options): ContentItemModel[];

package/lib-esm/services/menu/builder.js

@@ -1,2 +1,2 @@
-import{getTagGroupsItems,getTagsItems,getTagsWithOperations}from"./tags";import{addMarkdownItems}from"./markdown";import{flattenByProp,getValueFromMdParsedExtension,normalizePath}from"../../utils";import{joinWithSeparator}from"../history";export function buildMenuStructure(e,t){var i,o,n;const{definition:r}=e,{hideInfoSection:a,hideInfoDescription:s,pagination:d,schemaDefinitionsTagName:m,markdownHeadingsAnchorLevel:l,infoLabel:u}=t,f=a&&"none"!==d?[]:[{id:"",name:(null===(o=null===(i=null==r?void 0:r.info)||void 0===i?void 0:i["x-seo"])||void 0===o?void 0:o.title)||u||(null===(n=null==r?void 0:r.info)||void 0===n?void 0:n.title)||"Overview",href:"/",depth:a?-1:1,level:1,type:"section",infoDefinition:r.info,items:[]}],p=[...r.tags||[]];!p.find((e=>(null==e?void 0:e.name)===m))&&m&&p.push({name:m});const h=getTagsWithOperations(e,p),g=r["x-tagGroups"];return a||s||f.push(...addMarkdownItems(getValueFromMdParsedExtension(r.info,"description")||"",void 0,1,l,d)),g&&g.length>0?f.push(...getTagGroupsItems(e,void 0,g,h,t)):f.push(...getTagsItems(e,h,void 0,void 0,t)),f}function addVersionToHref(e,t){return e.map((e=>(e.href&&(e.href=normalizePath(joinWithSeparator(t,e.href,"/"))),e.id&&"tag"===e.type&&(e.id=normalizePath(joinWithSeparator(t,e.id,"/"))),e.items&&addVersionToHref(e.items,t),e)))}export function buildContentItems(e,t){const i=buildMenuStructure(e,t),o=e.versionPath?addVersionToHref(i,e.versionPath):i;return{contentItems:o,flatItems:flattenByProp(o||[],"items")}}
+import{getTagGroupsItems,getTagsItems,getTagsWithOperations}from"./tags";import{addMarkdownItems}from"./markdown";import{flattenByProp,getValueFromMdParsedExtension}from"../../utils";export function buildMenuStructure(t,e){var o,i,n;const{definition:s}=t,{schemaDefinitionsTagName:r}=e,d=[{id:"",name:(null===(i=null===(o=null==s?void 0:s.info)||void 0===o?void 0:o["x-seo"])||void 0===i?void 0:i.title)||(null===(n=null==s?void 0:s.info)||void 0===n?void 0:n.title)||"Overview",href:"/",depth:1,level:1,type:"section",infoDefinition:s.info,items:[]}],a=[...s.tags||[]];!a.find((t=>(null==t?void 0:t.name)===r))&&r&&a.push({name:r});const u=getTagsWithOperations(t,a),l=s["x-tagGroups"];return d.push(...addMarkdownItems(getValueFromMdParsedExtension(s.info,"description")||"",void 0,1)),l&&l.length>0?d.push(...getTagGroupsItems(t,void 0,l,u,e)):d.push(...getTagsItems(t,u,void 0,void 0,e)),d}export function buildContentItems(t,e){const o=buildMenuStructure(t,e);return{contentItems:o,flatItems:flattenByProp(o||[],"items")}}
 //# sourceMappingURL=builder.js.map

package/lib-esm/services/menu/markdown.d.ts

@@ -1,11 +1,8 @@
 import type { ContentItemModel, GroupModel } from '../../models';
-import { Pagination } from '../types';
 /**
  * extracts items from markdown description
  * @param description - markdown source
  * @param parent
  * @param initialDepth - number of items depth
- * @param markdownHeadingsAnchorLevel - level of headings renders as a section from markdown.
- * @param pagination
  */
-export declare function addMarkdownItems(description: string | GenericObject, parent: GroupModel | undefined, initialDepth: number, markdownHeadingsAnchorLevel?: number, pagination?: Pagination): ContentItemModel[];
+export declare function addMarkdownItems(description: string | GenericObject, parent: GroupModel | undefined, initialDepth: number): ContentItemModel[];

package/lib-esm/services/menu/markdown.js

@@ -1,2 +1,2 @@
-import{parse,Ast}from"@markdoc/markdoc";import{Pagination}from"../types";import{getTagOrGroup}from"../../models";import{isString,safeSlugify,unescapeHTMLChars}from"../../utils";export function addMarkdownItems(t,e,i,n=2,o=Pagination.Section){const r=isString(t)?parse(t):Ast.fromJSON(JSON.stringify(null==t?void 0:t.result)),s=[];let l;const a=(t,e,i=s,n,o)=>{let r;t=unescapeHTMLChars(t),n.attributes.id?r=n.attributes.id:(r=o?`${o}/${safeSlugify(t)}`:`section/${safeSlugify(t)}`,n.attributes.id=r);const l={id:r,name:t,level:e,items:[],ast:[n]};return i.push(l),l},d=(t,e)=>{var i,n;null===(n=null===(i=t[t.length-1])||void 0===i?void 0:i.ast)||void 0===n||n.push(e)},u=t=>{var e;for(const i of t.children){const t=getMarkdownContent(i)||"";"heading"===i.type&&1===i.attributes.level?l=a(t,i.attributes.level,void 0,i):i.attributes.level<=n?a(t,i.attributes.level,null==l?void 0:l.items,i,null==l?void 0:l.id):(null===(e=null==l?void 0:l.items)||void 0===e?void 0:e.length)?d(null==l?void 0:l.items,i):(null==s?void 0:s.length)&&d(s,i)}};if(Array.isArray(r))for(const t of r)u(t);else u(r);return mapHeadingsDeep(e,s,i,{pagination:o,markdownHeadingsAnchorLevel:n})}function mapHeadingsDeep(t,e,i=1,n){return e.map((e=>{const o=getTagOrGroup("section",e,n,t);return o.depth=i,e.items&&(o.items=mapHeadingsDeep(o,e.items,i+1,n)),o}))}function getMarkdownContent(t){var e,i;return"string"==typeof(null===(e=null==t?void 0:t.attributes)||void 0===e?void 0:e.content)?null===(i=t.attributes)||void 0===i?void 0:i.content:(null==t?void 0:t.children)?getMarkdownContent(t.children[0]):void 0}
+import{parse,Ast}from"@markdoc/markdoc";import{isString}from"@redocly/theme";import{getTagOrGroup}from"../../models";import{safeSlugify,unescapeHTMLChars}from"../../utils";export function addMarkdownItems(t,e,i){const n=isString(t)?parse(t):Ast.fromJSON(JSON.stringify(null==t?void 0:t.result)),o=[];let r;const s=(t,e,i=o,n,r)=>{let s;t=unescapeHTMLChars(t),n.attributes.id?s=n.attributes.id:(s=r?`${r}/${safeSlugify(t)}`:`section/${safeSlugify(t)}`,n.attributes.id=s);const l={id:s.toLowerCase(),name:t,level:e,items:[],ast:[n]};return i.push(l),l},l=(t,e)=>{var i,n;null===(n=null===(i=t[t.length-1])||void 0===i?void 0:i.ast)||void 0===n||n.push(e)},a=t=>{var e;for(const i of t.children){const t=getMarkdownContent(i)||"";"heading"===i.type&&1===i.attributes.level?r=s(t,i.attributes.level,void 0,i):i.attributes.level?s(t,i.attributes.level,null==r?void 0:r.items,i,null==r?void 0:r.id):(null===(e=null==r?void 0:r.items)||void 0===e?void 0:e.length)?l(null==r?void 0:r.items,i):(null==o?void 0:o.length)&&l(o,i)}};if(Array.isArray(n))for(const t of n)a(t);else a(n);return mapHeadingsDeep(e,o,i)}function mapHeadingsDeep(t,e,i=1){return e.map((e=>{const n=getTagOrGroup("section",e,t);return n.depth=i,e.items&&(n.items=mapHeadingsDeep(n,e.items,i+1)),n}))}function getMarkdownContent(t){var e,i;return"string"==typeof(null===(e=null==t?void 0:t.attributes)||void 0===e?void 0:e.content)?null===(i=t.attributes)||void 0===i?void 0:i.content:(null==t?void 0:t.children)?getMarkdownContent(t.children[0]):void 0}
 //# sourceMappingURL=markdown.js.map

package/lib-esm/services/menu/operation.d.ts

@@ -1,13 +1,10 @@
 import type { GroupModel, OperationMenuItem, ContentItemModel } from '../../models';
 import type { TagInfo } from '../types';
-import type { Options } from '../Options';
-import { Pagination } from '../types';
 /**
  * Returns array of Operation items for the tag
  * @param parent parent OperationsGroup
  * @param tag tag info returned from `getTagsWithOperations`
  * @param depth items depth
- * @param options - normalized options
  */
-export declare function getOperationsItems(parent: GroupModel | undefined, tag: TagInfo, depth: number, options: Options): OperationMenuItem[];
-export declare function getHref({ type, id, parent }: Pick<ContentItemModel, 'id' | 'parent' | 'type'>, pagination: Pagination): string;
+export declare function getOperationsItems(parent: GroupModel | undefined, tag: TagInfo, depth: number): OperationMenuItem[];
+export declare function getHref({ id }: Pick<ContentItemModel, 'id'>): string;

package/lib-esm/services/menu/operation.js

@@ -1,2 +1,2 @@
-import{alphabeticallyByProp,getOperationId,getOperationName,normalizePath}from"../../utils";import{Pagination}from"../types";import{joinWithSeparator}from"../history";export function getOperationsItems(t,e,o,a){if(0===e.operations.length)return[];const i=[];for(const r of e.operations){const e=getOperationId(r,a.pagination,t),n="operation";i.push({id:e,type:n,parent:t,operationDefinition:r,depth:o,name:getOperationName(r),httpVerb:r.httpVerb,path:r.pathName,items:[],isWebhook:r.isWebhook,operationId:r.operationId,href:getHref({id:e,type:n,parent:t},a.pagination)})}return a.sortOperationsAlphabetically&&i.sort(alphabeticallyByProp("name")),i}export function getHref({type:t,id:e,parent:o},a){switch(a){case Pagination.None:return`#${e}`;case Pagination.Item:return"section"===t?"tag"===(null==o?void 0:o.type)?normalizePath(joinWithSeparator(o.id,e,"#")):`#${e}`:o&&"group"!==o.type?normalizePath(joinWithSeparator(o.id,e)):normalizePath(e);case Pagination.Section:return"operation"===t||"schema"===t?normalizePath(o?joinWithSeparator(o.id,e,"#"):`#${e}`):"section"===t?o?`#${e}`:normalizePath(`#${e}`):normalizePath(e);default:return""}}
+import{encodeBackSlashes,getOperationId,getOperationName}from"../../utils";export function getOperationsItems(e,t,o){if(0===t.operations.length)return[];const r=[];for(const n of t.operations){const t=getOperationId(n,e),i="operation";r.push({id:t,type:i,parent:e,operationDefinition:n,depth:o,name:getOperationName(n),httpVerb:n.httpVerb,path:n.pathName,items:[],isWebhook:n.isWebhook,operationId:n.operationId,badges:n["x-badges"]||[],href:getHref({id:t})})}return r.sort(((e,t)=>Number(e.isWebhook)-Number(t.isWebhook)))}export function getHref({id:e}){return encodeBackSlashes(`/${e}`.toLowerCase())}
 //# sourceMappingURL=operation.js.map

package/lib-esm/services/menu/tags.d.ts

@@ -1,7 +1,7 @@
 import type { OpenAPIParser } from '../OpenAPIParser';
 import type { ContentItemModel, GroupModel } from '../../models';
 import type { TagGroup, TagsInfoMap } from '../types';
-import type { Options } from '../Options';
+import type { Options } from '../config-options';
 import type { OpenAPITag } from '../../types';
 /**
  * Returns array of OperationsGroup items for the tags of the group or for all tags

package/lib-esm/services/menu/tags.js

@@ -1,2 +1,2 @@
-import{getTagOrGroup}from"../../models/group";import{GROUP_DEPTH}from"../../constants";import{alphabeticallyByProp,getValueFromMdParsedExtension,isOperationName,JsonPointer}from"../../utils";import{getOperationsItems}from"./operation";import{addMarkdownItems}from"./markdown";export function getTagsItems(e,t,n,o,a){let s;if(s=void 0===o?Object.keys(t):o.tags,!Array.isArray(s))return console.warn("Unexpected values of tags. Check tags or x-tagGroups in your definition."),[];const i=s.map((e=>t[e]?(t[e].used=!0,t[e]):(console.warn(`Non-existing tag "${e}" is added to the group "${null==o?void 0:o.name}"`),null))),r=[];for(const t of i){if(!t)continue;const o=getTagOrGroup("tag",t,{pagination:a.pagination,markdownHeadingsAnchorLevel:a.markdownHeadingsAnchorLevel},n);if(o.depth=GROUP_DEPTH+1,""===t.name){const e=[...addMarkdownItems(getValueFromMdParsedExtension(t,"description")||"",o,o.depth+1,a.markdownHeadingsAnchorLevel,a.pagination),...getOperationsItems(void 0,t,o.depth+1,a)];r.push(...e);continue}const s=getTagRelatedSchema({definition:e.definition,tag:t,parent:o,schemaDefinitionsTagName:a.schemaDefinitionsTagName,options:{pagination:a.pagination,markdownHeadingsAnchorLevel:a.markdownHeadingsAnchorLevel}});o.items=[...s,...addMarkdownItems(getValueFromMdParsedExtension(t,"description")||"",o,o.depth+1,a.markdownHeadingsAnchorLevel,a.pagination),...getOperationsItems(o,t,o.depth+1,a)],r.push(o)}return a.sortTagsAlphabetically&&r.sort(alphabeticallyByProp("name")),r}export function getTagGroupsItems(e,t,n,o,a){const s=[];for(const i of n){const n=getTagOrGroup("group",i,{pagination:a.pagination,markdownHeadingsAnchorLevel:a.markdownHeadingsAnchorLevel},t);n.depth=GROUP_DEPTH,n.items=getTagsItems(e,o,n,i,a),s.push(n)}return s}function getTagRelatedSchema({definition:e,tag:t,parent:n,schemaDefinitionsTagName:o,options:a}){var s;const i=o?[o]:[];return Object.entries((null===(s=e.components)||void 0===s?void 0:s.schemas)||{}).map((([e,o])=>{if(!(o["x-tags"]||i).includes(t.name))return null;const s=getTagOrGroup("schema",{name:e,"x-displayName":`${o.title||e}`,description:`{% schemaDefinition showWriteOnly="true" schemaRef="#/components/schemas/${e}" /%}`,isSchema:!0,level:2},a,n);return s.depth=n.depth+1,s})).filter(Boolean)}export function getTagsWithOperations(e,t){const{definition:n}=e,o={},a=n["x-webhooks"]||n.webhooks;for(const e of t||[])o[e.name]=Object.assign(Object.assign({},e),{operations:[]});return n.paths&&getTags(e,n.paths,o),a&&getTags(e,a,o,!0),o}function getTags(e,t,n,o){for(const a of Object.keys(t||{})){const s=t[a],i=Object.keys(s).filter(isOperationName);for(const t of i){const i=s[t];if(s.$ref){const{resolved:t}=e.deref(s);getTags(e,{[a]:t},n,o);continue}let r=null==i?void 0:i.tags;r&&r.length||(r=[""]);for(const e of r){let r=n[e];void 0===r&&(r={name:e,operations:[]},n[e]=r),r["x-traitTag"]||r.operations.push(Object.assign(Object.assign({},i),{pathName:a,pointer:JsonPointer.compile(["paths",a,t]),httpVerb:t,pathParameters:s.parameters||[],pathServers:s.servers,isWebhook:!!o}))}}}}
+import{getTagOrGroup}from"../../models/group";import{GROUP_DEPTH}from"../../constants";import{getValueFromMdParsedExtension,isOperationName,JsonPointer}from"../../utils";import{getOperationsItems}from"./operation";import{addMarkdownItems}from"./markdown";export function getTagsItems(e,t,o,n,s){let a;if(a=void 0===n?Object.keys(t):n.tags,!Array.isArray(a))return console.warn("Unexpected values of tags. Check tags or x-tagGroups in your definition."),[];const r=a.map((e=>t[e]?(t[e].used=!0,t[e]):(console.warn(`Non-existing tag "${e}" is added to the group "${null==n?void 0:n.name}"`),null))),i=[];for(const t of r){if(!t)continue;const n=getTagOrGroup("tag",t,o);if(n.depth=GROUP_DEPTH+1,""===t.name){const e=[...addMarkdownItems(getValueFromMdParsedExtension(t,"description")||"",n,n.depth+1),...getOperationsItems(void 0,t,n.depth+1)];i.push(...e);continue}const a=getTagRelatedSchema({definition:e.definition,tag:t,parent:n,schemaDefinitionsTagName:s.schemaDefinitionsTagName});n.items=[...a,...addMarkdownItems(getValueFromMdParsedExtension(t,"description")||"",n,n.depth+1),...getOperationsItems(n,t,n.depth+1)],i.push(n)}return i}export function getTagGroupsItems(e,t,o,n,s){const a=[];for(const r of o){const o=getTagOrGroup("group",r,t);o.depth=GROUP_DEPTH,o.items=getTagsItems(e,n,o,r,s),a.push(o)}return a}function getTagRelatedSchema({definition:e,tag:t,parent:o,schemaDefinitionsTagName:n}){var s;const a=n?[n]:[];return Object.entries((null===(s=e.components)||void 0===s?void 0:s.schemas)||{}).map((([e,n])=>{if(!(n["x-tags"]||a).includes(t.name))return null;const s=getTagOrGroup("schema",{name:e,"x-displayName":`${n.title||e}`,description:`{% schemaDefinition showWriteOnly="true" schemaRef="#/components/schemas/${e}" /%}`,isSchema:!0,level:2},o);return s.depth=o.depth+1,s})).filter(Boolean)}export function getTagsWithOperations(e,t){const{definition:o}=e,n={},s=o["x-webhooks"]||o.webhooks;for(const e of t||[])n[e.name]=Object.assign(Object.assign({},e),{operations:[]});return o.paths&&getTags(e,o.paths,n),s&&getTags(e,s,n,!0),n}function getTags(e,t,o,n){for(const s of Object.keys(t||{})){const a=t[s],r=Object.keys(a).filter(isOperationName);for(const t of r){const r=a[t];if(a.$ref){const{resolved:t}=e.deref(a);getTags(e,{[s]:t},o,n);continue}let i=null==r?void 0:r.tags;i&&i.length||(i=[""]);for(const e of i){let i=o[e];void 0===i&&(i={name:e,operations:[]},o[e]=i),i["x-traitTag"]||i.operations.push(Object.assign(Object.assign({},r),{pathName:s,pointer:JsonPointer.compile(["paths",s,t]),httpVerb:t,pathParameters:a.parameters||[],pathServers:a.servers,isWebhook:!!n}))}}}}
 //# sourceMappingURL=tags.js.map

package/lib-esm/services/types.d.ts

@@ -1,24 +1,10 @@
-import type React from 'react';
+import type { ReactElement } from 'react';
 import type { Node } from '@markdoc/markdoc';
-import type { OpenAPIDefinition, OpenAPIInfo, OpenAPIOperation, OpenAPIParameter, OpenAPISchema, OpenAPIServer, OpenAPITag, Referenced, Server } from '../types';
+import type { OpenAPIDefinition, OpenAPIInfo, OpenAPIOperation, OpenAPIParameter, OpenAPISchema, OpenAPIServer, OpenAPITag, Referenced } from '../types';
 import type { OperationModel, Sample } from '../models';
-import type { OAuth2 } from './OAuth2';
-import type { GlobalStoreAtom } from '../jotai/store';
-export declare enum SideNavStyle {
-    SummaryOnly = "summary-only",
-    PathFirst = "path-first",
-    IdOnly = "id-only"
-}
 export type Normalized<T> = {
     [P in keyof T]-?: T[P];
 };
-export type MarkdownItemsPagination = 'none' | 'section';
-export declare enum Pagination {
-    None = "none",
-    Section = "section",
-    Item = "item"
-}
-export type PaginationType = 'none' | 'section' | 'item';
 export type ExternalLink = ExternalLinkLink | ExternalLinkSeparator;
 export type ExternalLinkLink = {
     label: string;
@@ -45,6 +31,7 @@ export interface IMenuItem {
     type: MenuItemType;
     isSchema?: boolean;
     httpVerb?: string;
+    isWebhook?: boolean;
     path?: string;
     definition?: OpenAPIDefinition;
 }
@@ -74,11 +61,6 @@ export type MergedOpenAPISchema = OpenAPISchema & {
     'x-circular-ref'?: boolean;
     absolutePointer?: string;
 };
-export interface MDXComponentMeta {
-    component: React.ComponentType;
-    propsSelector: (oldStore?: GlobalStoreAtom, store?: GlobalStoreAtom) => GenericObject;
-    props?: GenericObject;
-}
 export interface MarkdownHeading {
     id: string;
     name: string;
@@ -97,17 +79,10 @@ export interface ExternalSource {
     pathParams?: any;
     properties?: any;
 }
-export interface SecurityPanelHookProps {
-    operation: OperationModel;
-    server: Server;
-    onChange: (securityDetails: unknown) => void;
-    OAuth2: OAuth2;
-}
-export type AuthPanelHookProps = SecurityPanelHookProps;
 export interface HookRawHtml {
     html: string;
 }
-type HookResult = JSX.Element | HookRawHtml | null;
+type HookResult = ReactElement | HookRawHtml | null;
 export type HookConfig<T> = (props: T) => HookResult;
 export interface HooksConfig {
     AfterApiTitle?: HookConfig<{
@@ -125,7 +100,6 @@ export interface HooksConfig {
     AfterOperation?: HookConfig<{
         operation: OperationModel;
     }>;
-    ReplaceTryItSecurityPanel?: HookConfig<SecurityPanelHookProps>;
     onInit?: (args: {
         store: GenericObject;
     }) => void;
@@ -135,8 +109,6 @@ export interface HooksConfig {
     sanitize?: (raw: string) => string;
     MiddlePanelFooter?: HookConfig<undefined>;
     MiddlePanelHeader?: HookConfig<undefined>;
-    /** @deprecated Use ReplaceTryItSecurityPanel instead */
-    ReplaceTryItAuthPanel?: HookConfig<SecurityPanelHookProps>;
 }
 export type ExtendedMenuItem = Omit<IMenuItem, 'type'> & {
     type: MenuItemType | 'spec';
@@ -145,22 +117,4 @@ export type ExtendedMenuItem = Omit<IMenuItem, 'type'> & {
     httpVerb?: string;
     path?: string;
 };
-export interface SpecInfo {
-    id?: string;
-    title?: string;
-    spec?: OpenAPIDefinition;
-    url?: string;
-    items?: SpecInfo[];
-}
-export interface SpecVersions {
-    versions?: Array<VersionInfo>;
-}
-interface VersionInfo {
-    id: string;
-    title: string;
-    url?: string;
-    spec?: OpenAPIDefinition;
-    isDefault?: boolean;
-    _searchIndexName?: string;
-}
 export {};

package/lib-esm/services/types.js

@@ -1,2 +1,2 @@
-export var SideNavStyle;!function(n){n.SummaryOnly="summary-only",n.PathFirst="path-first",n.IdOnly="id-only"}(SideNavStyle||(SideNavStyle={}));export var Pagination;!function(n){n.None="none",n.Section="section",n.Item="item"}(Pagination||(Pagination={}));
+export{};
 //# sourceMappingURL=types.js.map

package/lib-esm/services/utils.d.ts

@@ -15,11 +15,4 @@ export declare function unescapeServerVariables(str: string): string;
 export declare function arrayMergeStrategy<T>(target: T[], source: T[]): T[];
 export declare function isEmptyObject(obj: GenericObject): boolean;
 export declare const cryptoLib: Crypto | undefined;
-export declare function randString(len?: number): string;
-/**
- * Returns base-64 encoded ASCII string from a stringified JSON object
- */
-export declare function encodeState<T extends GenericObject = GenericObject>(params: T): string;
-export declare function sha256(str: string): Promise<ArrayBuffer | undefined>;
-export declare function base64UrlEncode(arrayBuff?: ArrayBuffer): string | undefined;
 export declare function deepClone(inObject: any): any;

package/lib-esm/services/utils.js

@@ -1,2 +1,2 @@
-var __awaiter=this&&this.__awaiter||function(e,r,t,n){return new(t||(t=Promise))((function(o,i){function a(e){try{s(n.next(e))}catch(e){i(e)}}function c(e){try{s(n.throw(e))}catch(e){i(e)}}function s(e){var r;e.done?o(e.value):(r=e.value,r instanceof t?r:new t((function(e){e(r)}))).then(a,c)}s((n=n.apply(e,r||[])).next())}))};import merge from"deepmerge";import{isMergeableObject,isObject}from"../utils/helpers";export function isSameMime(e,r){return!(!e||!r)&&normalizeMimeType(e)===normalizeMimeType(r)}export function normalizeMimeType(e){if(!e)return;const r=e.split(";")[0].toLowerCase(),[t,n]=r.split("/");if(void 0===n)return t;return`${t}/${n.split("+").pop()}`}export function unescapeServerVariables(e){const r=new RegExp("%7B","g"),t=new RegExp("%7D","g");return e.replace(r,"{").replace(t,"}").replace("///","//")}export function arrayMergeStrategy(e,r){if(!e.length||!hasObjectOrArray(e))return r;const t=e.filter((e=>Object.keys(e).length>0));return r.forEach((function(r,n){isMergeableObject(r)?t[n]=merge(e[n],r,{arrayMerge:arrayMergeStrategy}):Array.isArray(r)?t.push(r):t[n]=r})),t}const hasObjectOrArray=e=>e.some((e=>isObject(e)&&Object.keys(e).length>0));export function isEmptyObject(e){return!!e&&0===Object.keys(e).length}export const cryptoLib="undefined"!=typeof window&&(window.crypto||window.msCrypto)||void 0;export function randString(e=32){let r="";for(;r.length<e;)r+=Math.random().toString(32).substring(2);return r.substring(0,e)}export function encodeState(e){const r=Object.assign({randomStr:randString()},e);return btoa(JSON.stringify(r))}export function sha256(e){return __awaiter(this,void 0,void 0,(function*(){const r=(new TextEncoder).encode(e);return null==cryptoLib?void 0:cryptoLib.subtle.digest("SHA-256",r)}))}export function base64UrlEncode(e){if(e)return btoa(String.fromCharCode.apply(null,new Uint8Array(e))).replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/,"")}export function deepClone(e){if("object"!=typeof e||null===e)return e;const r=Array.isArray(e)?[]:{};for(const t in e){const n=e[t];r[t]=deepClone(n)}return r}
+import merge from"deepmerge";import{isObject}from"@redocly/theme";import{isMergeableObject}from"../utils";export function isSameMime(e,r){return!(!e||!r)&&normalizeMimeType(e)===normalizeMimeType(r)}export function normalizeMimeType(e){if(!e)return;const r=e.split(";")[0].toLowerCase(),[t,n]=r.split("/");if(void 0===n)return t;return`${t}/${n.split("+").pop()}`}export function unescapeServerVariables(e){const r=new RegExp("%7B","g"),t=new RegExp("%7D","g");return e.replace(r,"{").replace(t,"}").replace("///","//")}export function arrayMergeStrategy(e,r){if(!e.length||!hasObjectOrArray(e))return r;const t=e.filter((e=>Object.keys(e).length>0));return r.forEach((function(r,n){isMergeableObject(r)?t[n]=merge(e[n],r,{arrayMerge:arrayMergeStrategy}):Array.isArray(r)?t.push(r):t[n]=r})),t}const hasObjectOrArray=e=>e.some((e=>isObject(e)&&Object.keys(e).length>0));export function isEmptyObject(e){return!!e&&0===Object.keys(e).length}export const cryptoLib="undefined"!=typeof window&&(window.crypto||window.msCrypto)||void 0;export function deepClone(e){if("object"!=typeof e||null===e)return e;const r=Array.isArray(e)?[]:{};for(const t in e){const n=e[t];r[t]=deepClone(n)}return r}
 //# sourceMappingURL=utils.js.map

package/lib-esm/setupTests.js

@@ -1,2 +1,2 @@
-import*as Enzyme from"enzyme";import Adapter from"@cfaester/enzyme-adapter-react-18";import"raf/polyfill";import"@testing-library/jest-dom";import"jest-styled-components";import{configure}from"@testing-library/react";Enzyme.configure({adapter:new Adapter}),configure({testIdAttribute:"data-cy"});
+import*as Enzyme from"enzyme";import Adapter from"@cfaester/enzyme-adapter-react-18";import"raf/polyfill";import"@testing-library/jest-dom";import"jest-styled-components";import{randomUUID}from"node:crypto";Enzyme.configure({adapter:new Adapter}),window.crypto.randomUUID=randomUUID,global.structuredClone=r=>JSON.parse(JSON.stringify(r));
 //# sourceMappingURL=setupTests.js.map

package/lib-esm/standalone.d.ts

@@ -13,16 +13,12 @@ import 'core-js/es/string/starts-with';
 import 'core-js/es/symbol';
 import 'unfetch/polyfill/index';
 import 'url-polyfill';
-import { LayoutVariant } from '@redocly/theme';
 import type { OpenAPIDefinition } from './types';
-import type { RawOptions } from './services/Options/types';
+import type { RawOptions } from './services';
 import type { StoreProviderProps } from './components';
-import type { SpecVersions } from './services/types';
 export { setSecurityDetails, setParameterValue, setSecurityDetailsVariants } from './utils';
-export declare function toggleLayout(layout?: LayoutVariant): void;
-export declare function toggleRightPanel(showRightPanelToggle?: boolean): void;
 export declare function hydrate(store: StoreProviderProps, element?: Element | null): void;
-export declare function init(definitionOrDefinitionUrl: string | OpenAPIDefinition | SpecVersions, options?: RawOptions, element?: Element | null): void;
+export declare function init(definitionOrDefinitionUrl: string | OpenAPIDefinition, options?: RawOptions, element?: Element | null): void;
 export declare function setPublicPath(path: string): void;
 export declare const version: string;
 export declare const revision: string;

package/lib-esm/standalone.js

@@ -1,2 +1,2 @@
-import"core-js/es/array/find-index";import"core-js/es/array/find";import"core-js/es/array/includes";import"core-js/es/map";import"core-js/es/number/is-integer";import"core-js/es/object/assign";import"core-js/es/object/entries";import"core-js/es/object/is";import"core-js/es/object/values";import"core-js/es/promise";import"core-js/es/string/ends-with";import"core-js/es/string/starts-with";import"core-js/es/symbol";import"unfetch/polyfill/index";import"url-polyfill";import{dirname}from"path";import React from"react";import{createRoot,hydrateRoot}from"react-dom/client";import{LayoutVariant}from"@redocly/theme";import{writeAtom,readAtom}from"./jotai/nexus";import{querySelector,IS_BROWSER,getJsUrl}from"./utils";import{RedoclyOpenAPIDocs,RedoclyOpenAPIDocsStandalone}from"./components";import{RedoclyOpenAPIDocsMultiStandalone}from"./components/RedoclyOpenAPIDocs/RedoclyOpenAPIDocsMultiStandalone";import{appLocalStore,appSessionStore}from"./jotai/app";export{setSecurityDetails,setParameterValue,setSecurityDetailsVariants}from"./utils";export function toggleLayout(e=LayoutVariant.THREE_PANEL){const t=readAtom(appLocalStore);writeAtom(appLocalStore,Object.assign(Object.assign({},t),{layout:e}))}export function toggleRightPanel(e){const t=readAtom(appSessionStore);writeAtom(appSessionStore,Object.assign(Object.assign({},t),{showRightPanelToggle:Boolean(e)}))}const url=getJsUrl(),__dirname=url?dirname(url)+"/":"";function attributesMap(e){const t={},o=e.attributes;for(let e=0;e<o.length;e++){const r=o[e];t[r.name]=r.value}return t}function parseOptionsFromElement(e){const t=attributesMap(e),o={};for(const e in t){o[e.replace(/-(.)/g,((e,t)=>t.toUpperCase()))]=t[e]}return o}export function hydrate(e,t=document.querySelector("redoc")){hydrateRoot(t,React.createElement(RedoclyOpenAPIDocs,{store:e}))}export function init(e,t={},o=querySelector("redoc")){if(null===o)throw new Error('"element" argument is not provided and <redoc> tag is not found on the page');let r,n;if("object"==typeof e&&"versions"in e){return void createRoot(o).render(React.createElement(RedoclyOpenAPIDocsMultiStandalone,{definitions:e,options:Object.assign(Object.assign({},t),parseOptionsFromElement(o))},["Loading..."]))}"string"==typeof e?r=e:"object"==typeof e&&(n=e);createRoot(o).render(React.createElement(RedoclyOpenAPIDocsStandalone,{definition:n,definitionUrl:r,options:Object.assign(Object.assign({},t),parseOptionsFromElement(o))},["Loading..."]))}export function setPublicPath(e){__webpack_public_path__=e}export const version=__REDOCLY_API_REFERENCE_VERSION__;export const revision=__REDOCLY_API_REFERENCE_REVISION__;function autoInit(){const e=querySelector("redoc");if(!e)return;const t=e.getAttribute("spec-url");t&&init(t,{},e)}IS_BROWSER&&setPublicPath(__dirname),autoInit();
+import{jsx as _jsx}from"react/jsx-runtime";import"core-js/es/array/find-index";import"core-js/es/array/find";import"core-js/es/array/includes";import"core-js/es/map";import"core-js/es/number/is-integer";import"core-js/es/object/assign";import"core-js/es/object/entries";import"core-js/es/object/is";import"core-js/es/object/values";import"core-js/es/promise";import"core-js/es/string/ends-with";import"core-js/es/string/starts-with";import"core-js/es/symbol";import"unfetch/polyfill/index";import"url-polyfill";import{dirname}from"path";import{createElement}from"react";import{createRoot,hydrateRoot}from"react-dom/client";import{IS_BROWSER}from"@redocly/theme";import{querySelector,getJsUrl}from"./utils";import{RedoclyOpenAPIDocs,RedoclyOpenAPIDocsStandalone}from"./components";export{setSecurityDetails,setParameterValue,setSecurityDetailsVariants}from"./utils";const url=getJsUrl(),__dirname=url?dirname(url)+"/":"";function attributesMap(e){const t={},r=e.attributes;for(let e=0;e<r.length;e++){const o=r[e];t[o.name]=o.value}return t}function parseOptionsFromElement(e){const t=attributesMap(e),r={};for(const e in t){r[e.replace(/-(.)/g,((e,t)=>t.toUpperCase()))]=t[e]}return r}export function hydrate(e,t=document.querySelector("redoc")){hydrateRoot(t,_jsx(RedoclyOpenAPIDocs,{store:e}))}export function init(e,t={},r=querySelector("redoc")){if(null===r)throw new Error('"element" argument is not provided and <redoc> tag is not found on the page');let o,i;"string"==typeof e?o=e:"object"==typeof e&&(i=e);createRoot(r).render(createElement(RedoclyOpenAPIDocsStandalone,{definition:i,definitionUrl:o,options:Object.assign(Object.assign({},t),parseOptionsFromElement(r))},["Loading..."]))}export function setPublicPath(e){__webpack_public_path__=e}export const version=__REDOCLY_API_REFERENCE_VERSION__;export const revision=__REDOCLY_API_REFERENCE_REVISION__;function autoInit(){const e=querySelector("redoc");if(!e)return;const t=e.getAttribute("spec-url");t&&init(t,{},e)}IS_BROWSER&&setPublicPath(__dirname),autoInit();
 //# sourceMappingURL=standalone.js.map

package/lib-esm/testProviders.d.ts

@@ -1,7 +1,3 @@
-import type { ReactNode, PropsWithChildren } from 'react';
+import type { ReactNode, ReactElement } from 'react';
 import type { StoreProviderProps } from './components';
-export declare function withTestProviders(children: ReactNode, store?: StoreProviderProps): JSX.Element;
-export declare function withTheme(children: ReactNode): JSX.Element;
-export declare function TestFormProvider({ children, defaultValues, }: PropsWithChildren<{
-    defaultValues?: any;
-}>): JSX.Element;
+export declare function withTestProviders(children: ReactNode, store?: StoreProviderProps): ReactElement;

package/lib-esm/testProviders.js

@@ -1,2 +1,2 @@
-import React,{Children}from"react";import{ThemeProvider}from"styled-components";import{useForm,FormProvider}from"react-hook-form";import{defaultTheme}from"./constants";import{generateMediaQueries}from"./utils";import{StoreProvider}from"./components";export function withTestProviders(e,r){return React.createElement(StoreProvider,Object.assign({},r||{definition:{openapi:"3.0.0"}}),Children.only(e))}export function withTheme(e){const r={mediaQueries:generateMediaQueries(defaultTheme.breakpoints),showAtBreakpoint:defaultTheme.showAtBreakpoint};return React.createElement(ThemeProvider,{theme:r},e)}export function TestFormProvider({children:e,defaultValues:r}){const t=useForm({defaultValues:r});return React.createElement(FormProvider,Object.assign({},t),e)}
+import{jsx as _jsx}from"react/jsx-runtime";import{Children}from"react";import{StoreProvider}from"./components";export function withTestProviders(r,e){return _jsx(StoreProvider,Object.assign({},e||{definition:{openapi:"3.0.0"}},{children:Children.only(r)}))}
 //# sourceMappingURL=testProviders.js.map

package/lib-esm/types/index.d.ts

@@ -1,4 +1,3 @@
 export * from './open-api';
-export * from './server';
 export * from './security';
 export * from './app';

package/lib-esm/types/index.js

@@ -1,2 +1,2 @@
-export*from"./open-api";export*from"./server";export*from"./security";export*from"./app";
+export*from"./open-api";export*from"./security";export*from"./app";
 //# sourceMappingURL=index.js.map

package/lib-esm/types/open-api.d.ts

@@ -15,7 +15,6 @@ export interface OpenAPIDefinition {
         tags: Array<string>;
     }>;
     'x-feedback'?: any;
-    'x-pagination'?: 'item' | 'section' | 'none';
 }
 export interface OpenAPIInfo extends ParsedDescriptionWithSummary {
     title: string;
@@ -45,9 +44,10 @@ export interface XSEO {
 export interface OpenAPIServer extends ParsedDescription {
     url: string;
     description?: string;
-    variables?: {
-        [name: string]: OpenAPIServerVariable;
-    };
+    variables?: OpenAPIServerVariables;
+}
+export interface OpenAPIServerVariables {
+    [name: string]: OpenAPIServerVariable;
 }
 export interface OpenAPIServerVariable extends ParsedDescription {
     enum?: string[];
@@ -81,6 +81,11 @@ export interface OpenAPIPath extends Partial<OpenAPIRef>, ParsedDescriptionWithS
 export interface OpenAPIXCodeSample extends Sample {
     source: string;
 }
+export interface OpenAPIXBadges {
+    name: string;
+    color?: string;
+    position?: 'before' | 'after';
+}
 export interface OpenAPIOperation extends ParsedDescriptionWithSummary {
     tags?: string[];
     summary?: string;
@@ -98,6 +103,7 @@ export interface OpenAPIOperation extends ParsedDescriptionWithSummary {
     servers?: OpenAPIServer[];
     'x-codeSamples'?: OpenAPIXCodeSample[];
     'x-code-samples'?: OpenAPIXCodeSample[];
+    'x-badges'?: OpenAPIXBadges[];
 }
 export interface OpenAPIParameter extends ParsedDescription {
     name: string;

package/lib-esm/utils/argValuesHelpers.d.ts

@@ -1,4 +1,4 @@
 export declare function argValueToBoolean(val?: string | boolean, defaultValue?: boolean): boolean;
 export declare function argValueToNumber(value: number | string | undefined, defaultValue?: number): number;
 export declare function argValueToInt(value: number | string | undefined, defaultValue?: number): number;
-export declare function argValueToExpandLevel(value?: number | string | undefined, defaultValue?: number): number;
+export declare function argValueToExpandLevel(value?: number | string | undefined, defaultValue?: number): number | undefined;

package/lib-esm/utils/argValuesHelpers.js

@@ -1,2 +1,2 @@
-export function argValueToBoolean(e,r){return void 0===e?r||!1:"string"==typeof e?"false"!==e:e}export function argValueToNumber(e,r=0){return"string"==typeof e?parseInt(e,10):"number"==typeof e?e:r}export function argValueToInt(e,r=0){return"string"==typeof e?parseInt(e,10):"number"==typeof e?Math.ceil(e):r}export function argValueToExpandLevel(e,r=0){return"all"===e?1/0:argValueToInt(e,r)}
+export function argValueToBoolean(e,r){return void 0===e?r||!1:"string"==typeof e?"false"!==e:e}export function argValueToNumber(e,r=0){return"string"==typeof e?parseInt(e,10):"number"==typeof e?e:r}export function argValueToInt(e,r=0){return"string"==typeof e?parseInt(e,10):"number"==typeof e?Math.ceil(e):r}export function argValueToExpandLevel(e,r){return void 0===e?r:"all"===e?1/0:argValueToInt(e,r)}
 //# sourceMappingURL=argValuesHelpers.js.map

package/lib-esm/utils/cookies.d.ts

@@ -0,0 +1,7 @@
+export declare function setCookie(name: string | number | boolean, value: string, attributes?: {
+    [x: string]: string | number | Date | boolean;
+}): string | undefined;
+export declare function getCookie(name: string, serverString?: string): string;
+export declare function removeCookie(name: string, attributes?: {
+    [x: string]: string | number | Date | boolean;
+}): void;

package/lib-esm/utils/cookies.js

@@ -0,0 +1,2 @@
+export function setCookie(e,o,n={path:"/"}){if("undefined"==typeof document)return;"number"==typeof n.expires&&(n.expires=new Date(Date.now()+864e5*n.expires)),n.expires&&(n.expires=n.expires instanceof Date?n.expires.toUTCString():n.expires),e=encodeURIComponent(e).replace(/%(2[346B]|5E|60|7C)/g,decodeURIComponent).replace(/[()]/g,escape);let t="";for(const e in n)n[e]&&(t+="; "+e,!0!==n[e]&&(t+="="+String(n[e]).split(";")[0]));return document.cookie=e+"="+encode(o)+t}export function getCookie(e,o){const n="undefined"!=typeof document?document.cookie:o,t=n?n.split("; "):[],i={};for(let o=0;o<t.length;o++){const n=t[o].split("="),c=n.slice(1).join("=");try{const o=decodeURIComponent(n[0]);if(o in i||(i[o]=decode(c)),e===o)break}catch(e){}}return e?i[e]:i}export function removeCookie(e,o={path:"/"}){setCookie(e,"",Object.assign(Object.assign({},o),{expires:-1}))}function decode(e){return'"'===e[0]&&(e=e.slice(1,-1)),e.replace(/(%[\dA-F]{2})+/gi,decodeURIComponent)}function encode(e){return encodeURIComponent(e).replace(/%(2[346BF]|3[AC-F]|40|5[BDE]|60|7[BCD])/g,decodeURIComponent)}
+//# sourceMappingURL=cookies.js.map

package/lib-esm/utils/dom.d.ts

@@ -1,4 +1,3 @@
-export declare const IS_BROWSER: boolean;
 export declare function querySelector(selector: string): Element | null;
 /**
  * Drop everything inside <...> (i.e., tags/elements), and keep the text.

package/lib-esm/utils/dom.js

@@ -1,2 +1,2 @@
-export const IS_BROWSER="undefined"!=typeof window&&"HTMLElement"in window;export function querySelector(t){return"undefined"!=typeof document?document.querySelector(t):null}export function html2Str(t){return t.split(/<[^>]+>/).map((t=>t.trim())).filter((t=>t.length>0)).join(" ")}"undefined"==typeof Element||Element.prototype.scrollIntoViewIfNeeded||(Element.prototype.scrollIntoViewIfNeeded=function(t){t=0===arguments.length||!!t;const e=this.parentNode,o=window.getComputedStyle(e,void 0),i=parseInt(o.getPropertyValue("border-top-width"),10),f=parseInt(o.getPropertyValue("border-left-width"),10),n=this.offsetTop-e.offsetTop<e.scrollTop,l=this.offsetTop-e.offsetTop+this.clientHeight-i>e.scrollTop+e.clientHeight,s=this.offsetLeft-e.offsetLeft<e.scrollLeft,r=this.offsetLeft-e.offsetLeft+this.clientWidth-f>e.scrollLeft+e.clientWidth,p=n&&!l;(n||l)&&t&&(e.scrollTop=this.offsetTop-e.offsetTop-e.clientHeight/2-i+this.clientHeight/2),(s||r)&&t&&(e.scrollLeft=this.offsetLeft-e.offsetLeft-e.clientWidth/2-f+this.clientWidth/2),(n||l||s||r)&&!t&&this.scrollIntoView(p)});
+export function querySelector(t){return"undefined"!=typeof document?document.querySelector(t):null}export function html2Str(t){return t.split(/<[^>]+>/).map((t=>t.trim())).filter((t=>t.length>0)).join(" ")}"undefined"==typeof Element||Element.prototype.scrollIntoViewIfNeeded||(Element.prototype.scrollIntoViewIfNeeded=function(t){t=0===arguments.length||!!t;const e=this.parentNode,o=window.getComputedStyle(e,void 0),f=parseInt(o.getPropertyValue("border-top-width"),10),i=parseInt(o.getPropertyValue("border-left-width"),10),l=this.offsetTop-e.offsetTop<e.scrollTop,n=this.offsetTop-e.offsetTop+this.clientHeight-f>e.scrollTop+e.clientHeight,s=this.offsetLeft-e.offsetLeft<e.scrollLeft,r=this.offsetLeft-e.offsetLeft+this.clientWidth-i>e.scrollLeft+e.clientWidth,p=l&&!n;(l||n)&&t&&(e.scrollTop=this.offsetTop-e.offsetTop-e.clientHeight/2-f+this.clientHeight/2),(s||r)&&t&&(e.scrollLeft=this.offsetLeft-e.offsetLeft-e.clientWidth/2-i+this.clientWidth/2),(l||n||s||r)&&!t&&this.scrollIntoView(p)});
 //# sourceMappingURL=dom.js.map

package/lib-esm/utils/environments.d.ts

@@ -0,0 +1,4 @@
+import type { OpenAPIServer } from '../types';
+export type EnvironmentData = Record<string, Record<string, string>>;
+export declare function mergeEnvData(env1: EnvironmentData, env2?: EnvironmentData): EnvironmentData;
+export declare function getServerEnvName(server: OpenAPIServer): string;

package/lib-esm/utils/environments.js

@@ -0,0 +1,2 @@
+export function mergeEnvData(e,r){if(!r)return e;return Array.from(new Set([...Object.keys(e),...Object.keys(r)])).reduce(((t,n)=>(t[n]=Object.assign(Object.assign({},e[n]),r[n]),t)),{})}export function getServerEnvName(e){return e.description||e.url}
+//# sourceMappingURL=environments.js.map

package/lib-esm/utils/helpers.d.ts

@@ -20,8 +20,6 @@ export declare function flattenByProp<T extends GenericObject, P extends keyof T
 export declare function stripTrailingSlash(path: string): string;
 export declare function isNumeric(value: unknown): value is number;
 export declare function appendToMdHeading(md: string, heading: string, content: string): string;
-export declare const mergeObjects: (target: GenericObject, ...sources: GenericObject[]) => GenericObject;
-export declare const isObject: (item: unknown) => item is "object";
 export declare const isArrayOfObjects: (items: unknown) => items is [];
 export declare const deleteEmptyArrayItem: (items: unknown[]) => unknown[];
 export declare const isMergeableObject: (item: unknown) => boolean;
@@ -31,7 +29,6 @@ export declare function isAbsoluteUrl(url: string): boolean;
  * e.g. resolveUrl('http://test.com:{port}', 'path') results in http://test.com:{port}/path
  */
 export declare function resolveUrl(url: string, to: string): string;
-export declare function getBasePath(serverUrl: string): string;
 export declare function titleize(text: string): string;
 export declare function removeQueryStringAndHash(serverUrl: string): string;
 export declare function escapeHTMLAttrChars(str: string): string;

package/lib-esm/utils/helpers.js

@@ -1,2 +1,2 @@
-import{format,parse}from"url";import{ZERO_BREAKPOINT}from"./media-css";import{isNamedDefinition}from"./openapi";import{JsonPointer}from"./JsonPointer";import{IS_BROWSER}from"./dom";import{isString}from"./typeGuards";export function mapWithLast(e,t){const r=[];for(let n=0;n<e.length-1;n++)r.push(t(e[n],!1));return 0!==e.length&&r.push(t(e[e.length-1],!0)),r}export function mapValues(e,t){const r={};for(const n in e)Object.prototype.hasOwnProperty.call(e,n)&&(r[n]=t(e[n],n,e));return r}export function flattenByProp(e,t){const r=[],n=e=>{for(const o of e)r.push(o),o[t]&&n(o[t])};return n(e),r}export function stripTrailingSlash(e){return e.endsWith("/")?e.substring(0,e.length-1):e}export function isNumeric(e){return!isNaN(parseFloat(e))&&isFinite(e)}export function appendToMdHeading(e,t,r){const n=new RegExp(`(^|\\n)#\\s?${t}\\s*\\n`,"i"),o=new RegExp(`((\\n|^)#\\s*${t}\\s*(\\n|$)(?:.|\\n)*?)(\\n#|$)`,"i");if(n.test(e))return e.replace(o,`$1\n\n${r}\n$4`);{const n=""===e||e.endsWith("\n\n")?"":e.endsWith("\n")?"\n":"\n\n";return`${e}${n}# ${t}\n\n${r}`}}export const mergeObjects=(e,...t)=>{if(!t.length)return e;const r=t.shift();return void 0===r?e:(isMergeableObject(e)&&isMergeableObject(r)&&Object.keys(r).forEach((t=>{isMergeableObject(r[t])?(e[t]||(e[t]={}),["string","number"].includes(typeof e[t])&&(r[t][ZERO_BREAKPOINT]||0===r[t][ZERO_BREAKPOINT]||console.warn(`Theme resolver: using default value of "${e[t]}" for "${t}". This is not recommended. Prefer adding default value by providing "${ZERO_BREAKPOINT}" property to ${JSON.stringify(r[t])}.`),e[t]={[ZERO_BREAKPOINT]:e[t]}),mergeObjects(e[t],r[t])):e[t]=r[t]})),mergeObjects(e,...t))};export const isObject=e=>null!==e&&"object"==typeof e;export const isArrayOfObjects=e=>Array.isArray(e)&&e.some((e=>isObject(e)));export const deleteEmptyArrayItem=e=>e.filter((e=>!!e));export const isMergeableObject=e=>isObject(e)&&!Array.isArray(e);export function isAbsoluteUrl(e){return/(?:^[a-z][a-z0-9+.-]*:|\/\/)/i.test(e)}export function resolveUrl(e,t){let r;if(t.startsWith("//")){const{protocol:n}=parse(e);r=`${n||"https:"}${t}`}else if(isAbsoluteUrl(t))r=t;else if(t.startsWith("/")){const n=parse(e);r=format(Object.assign(Object.assign({},n),{pathname:t}))}else r=stripTrailingSlash(e)+"/"+t;return stripTrailingSlash(r)}export function getBasePath(e){try{return parseURL(e).pathname}catch(t){return e}}export function titleize(e){return e.charAt(0).toUpperCase()+e.slice(1)}export function removeQueryStringAndHash(e){try{const t=parseURL(e);return t.search="",t.hash="",t.toString()}catch(t){return e}}function parseURL(e){return"undefined"==typeof URL?new(require("url").URL)(e):new URL(e)}export function escapeHTMLAttrChars(e){return e.replace(/["\\]/g,"\\$&")}export function unescapeHTMLChars(e){return e.replace(/&#(\d+);/g,((e,t)=>String.fromCharCode(parseInt(t,10)))).replace(/&amp;/g,"&").replace(/&quot;/g,'"')}export function sanitizeItemId(e){return e&&e.replace(/#/g,"_")}export function useSchemaTitle(e,t){return t||isNamedDefinition(e)&&JsonPointer.baseName(e)||""}export function get(e={},t,r){return"string"==typeof t&&(t=t.split(".")),t.reduce(((e,t)=>e&&e[t]?e[t]:r),e)}export function joinStringFactory(e){return(...t)=>t.filter(Boolean).join(e)}export const dottedString=joinStringFactory(".");export function getWindowReferenceOptions(e){var t;return IS_BROWSER?null===(t=null===window||void 0===window?void 0:window.REFERENCE_DOCS_OPTIONS)||void 0===t?void 0:t[e]:null}export function getJsUrl(){var e;if(!IS_BROWSER)return"";const t=+new Date+Math.random();try{return document.currentScript&&(document.currentScript.async||document.currentScript.defer)||document.write(`<script id="dummy${t}"><\/script>`),(null===(e=document.getElementById("dummy"+t))||void 0===e?void 0:e.previousSibling).src}catch(e){return""}}export const normalizeText=e=>isString(e)?e:null==e?void 0:e.raw;export const getValueFromMdParsedExtension=(e,t)=>{const r=e[`x-parsed-md-${t}`]||e[t];if("x-enumDescriptions"!==t)return r;let n={};for(const e in r)e.startsWith("x-parsed-md")||(n[e]=r[`x-parsed-md-${e}`]||r[e]);return Object.keys(n).length?n:r};export function isLastInArray(e,t){return t===e.length-1}export function isLastProperty(e,t){const r=Object.keys(e);return r.indexOf(t)===r.length-1}
+import{format,parse}from"url";import{IS_BROWSER,isObject,isString}from"@redocly/theme";import{isNamedDefinition}from"./openapi";import{JsonPointer}from"./JsonPointer";export function mapWithLast(t,e){const r=[];for(let n=0;n<t.length-1;n++)r.push(e(t[n],!1));return 0!==t.length&&r.push(e(t[t.length-1],!0)),r}export function mapValues(t,e){const r={};for(const n in t)Object.prototype.hasOwnProperty.call(t,n)&&(r[n]=e(t[n],n,t));return r}export function flattenByProp(t,e){const r=[],n=t=>{for(const o of t)r.push(o),o[e]&&n(o[e])};return n(t),r}export function stripTrailingSlash(t){return t.endsWith("/")?t.substring(0,t.length-1):t}export function isNumeric(t){return!isNaN(parseFloat(t))&&isFinite(t)}export function appendToMdHeading(t,e,r){const n=new RegExp(`(^|\\n)#\\s?${e}\\s*\\n`,"i"),o=new RegExp(`((\\n|^)#\\s*${e}\\s*(\\n|$)(?:.|\\n)*?)(\\n#|$)`,"i");if(n.test(t))return t.replace(o,`$1\n\n${r}\n$4`);{const n=""===t||t.endsWith("\n\n")?"":t.endsWith("\n")?"\n":"\n\n";return`${t}${n}# ${e}\n\n${r}`}}export const isArrayOfObjects=t=>Array.isArray(t)&&t.some((t=>isObject(t)));export const deleteEmptyArrayItem=t=>t.filter((t=>!!t));export const isMergeableObject=t=>isObject(t)&&!Array.isArray(t);export function isAbsoluteUrl(t){return/(?:^[a-z][a-z0-9+.-]*:|\/\/)/i.test(t)}export function resolveUrl(t,e){let r;if(e.startsWith("//")){const{protocol:n}=parse(t);r=`${n||"https:"}${e}`}else if(isAbsoluteUrl(e))r=e;else if(e.startsWith("/")){const n=parse(t);r=format(Object.assign(Object.assign({},n),{pathname:e}))}else r=stripTrailingSlash(t)+"/"+e;return stripTrailingSlash(r)}export function titleize(t){return t.charAt(0).toUpperCase()+t.slice(1)}export function removeQueryStringAndHash(t){try{const e=parseURL(t);return e.search="",e.hash="",e.toString()}catch(e){return t}}function parseURL(t){return"undefined"==typeof URL?new(require("url").URL)(t):new URL(t)}export function escapeHTMLAttrChars(t){return t.replace(/["\\]/g,"\\$&")}export function unescapeHTMLChars(t){return t.replace(/&#(\d+);/g,((t,e)=>String.fromCharCode(parseInt(e,10)))).replace(/&amp;/g,"&").replace(/&quot;/g,'"')}export function sanitizeItemId(t){return t&&t.replace(/#/g,"_").toLowerCase()}export function useSchemaTitle(t,e){return e||isNamedDefinition(t)&&JsonPointer.baseName(t)||""}export function get(t={},e,r){return"string"==typeof e&&(e=e.split(".")),e.reduce(((t,e)=>t&&t[e]?t[e]:r),t)}export function joinStringFactory(t){return(...e)=>e.filter(Boolean).join(t)}export const dottedString=joinStringFactory(".");export function getWindowReferenceOptions(t){var e;return IS_BROWSER?null===(e=null===window||void 0===window?void 0:window.REFERENCE_DOCS_OPTIONS)||void 0===e?void 0:e[t]:null}export function getJsUrl(){var t;if(!IS_BROWSER)return"";const e=+new Date+Math.random();try{return document.currentScript&&(document.currentScript.async||document.currentScript.defer)||document.write(`<script id="dummy${e}"><\/script>`),(null===(t=document.getElementById("dummy"+e))||void 0===t?void 0:t.previousSibling).src}catch(t){return""}}export const normalizeText=t=>isString(t)?t:null==t?void 0:t.raw;export const getValueFromMdParsedExtension=(t,e)=>{const r=t[`x-parsed-md-${e}`]||t[e];if("x-enumDescriptions"!==e)return r;let n={};for(const t in r)t.startsWith("x-parsed-md")||(n[t]=r[`x-parsed-md-${t}`]||r[t]);return Object.keys(n).length?n:r};export function isLastInArray(t,e){return e===t.length-1}export function isLastProperty(t,e){const r=Object.keys(t);return r.indexOf(e)===r.length-1}
 //# sourceMappingURL=helpers.js.map