@redocly/openapi-docs 3.0.0-alpha.10 → 3.0.0-alpha.12

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

@@ -0,0 +1,63 @@
+import type { OpenAPITag } from '../types';
+import type { OpenAPIParser } from './OpenAPIParser';
+import type { TagGroup, TagInfo, TagsInfoMap } from './types';
+import type { ContentItemModel } from '../models';
+import type { Options } from './Options/types';
+import { GroupModel, OperationModel } from '../models';
+export declare class MenuBuilder {
+    /**
+     * Builds page content structure based on tags
+     */
+    static buildStructure(parser: OpenAPIParser, options: Options): ContentItemModel[];
+    /**
+     * extracts items from markdown description
+     * @param description - markdown source
+     * @param parent
+     * @param initialDepth - number of items depth
+     * @param options - normalized options
+     */
+    static addMarkdownItems(description: string, parent: GroupModel | undefined, initialDepth: number, options: Options): ContentItemModel[];
+    /**
+     * Returns array of OperationsGroup items for the tag groups (x-tagGroups vendor extension)
+     * @param parser
+     * @param parent
+     * @param groups
+     * @param tags value of `x-tagGroups` vendor extension
+     * @param options - normalized options
+     */
+    static getTagGroupsItems(parser: OpenAPIParser, parent: GroupModel | undefined, groups: TagGroup[], tags: TagsInfoMap, options: Options): GroupModel[];
+    /**
+     * Returns array of OperationsGroup items for the tags of the group or for all tags
+     * @param parser
+     * @param tagsMap tags info returned from `getTagsWithOperations`
+     * @param parent parent item
+     * @param group group which this tag belongs to. if not provided gets all tags
+     * @param options - normalized options
+     */
+    static getTagsItems(parser: OpenAPIParser, tagsMap: TagsInfoMap, parent: GroupModel | undefined, group: TagGroup | undefined, options: Options): ContentItemModel[];
+    /**
+     * Returns array of schemas with reference to tag, or schemas with reference to schemaDefinitionsTagName tag
+     * @param tagsMap all tags
+     * @param tag tag to find reference of schema
+     * @param schemaDefinitionsTagName config
+     */
+    static getTagRelatedSchema({ parser, tag, parent, schemaDefinitionsTagName, }: {
+        parser: OpenAPIParser;
+        tag: TagInfo;
+        parent: GroupModel;
+        schemaDefinitionsTagName?: string;
+    }): GroupModel[];
+    /**
+     * Returns array of Operation items for the tag
+     * @param parser
+     * @param parent parent OperationsGroup
+     * @param tag tag info returned from `getTagsWithOperations`
+     * @param depth items depth
+     * @param options - normalized options
+     */
+    static getOperationsItems(parser: OpenAPIParser, parent: GroupModel | undefined, tag: TagInfo, depth: number, options: Options): OperationModel[];
+    /**
+     * collects tags and maps each tag to list of operations belonging to this tag
+     */
+    static getTagsWithOperations(parser: OpenAPIParser, explicitTags: OpenAPITag[]): TagsInfoMap;
+}

package/lib-esm/services/MenuBuilder.js

@@ -0,0 +1,2 @@
+import{isOperationName,JsonPointer,alphabeticallyByProp}from"../utils";import{MarkdownRenderer}from"./MarkdownRenderer";import{GroupModel,OperationModel}from"../models";import{GROUP_DEPTH}from"../constants";export class MenuBuilder{static buildStructure(e,t){const n=e.definition,o=[],s=[...n.tags||[]]||[];!s.find((e=>(null==e?void 0:e.name)===t.schemaDefinitionsTagName))&&t.schemaDefinitionsTagName&&s.push({name:t.schemaDefinitionsTagName});const i=MenuBuilder.getTagsWithOperations(e,s),a=n["x-tagGroups"];return o.push(...MenuBuilder.addMarkdownItems(n.info.description||"",void 0,1,t)),a&&a.length>0?o.push(...MenuBuilder.getTagGroupsItems(e,void 0,a,i,t)):o.push(...MenuBuilder.getTagsItems(e,i,void 0,void 0,t)),o}static addMarkdownItems(e,t,n,o){const s=new MarkdownRenderer(o).extractHeadings(e||"");s.length&&t&&t.description&&(t.description=MarkdownRenderer.getTextBeforeHading(t.description,s[0].name));const i=(e,t,n=1)=>t.map((t=>{const o=new GroupModel("section",t,e);return o.depth=n,t.items&&(o.items=i(o,t.items,n+1)),o}));return i(t,s,n)}static getTagGroupsItems(e,t,n,o,s){const i=[];for(const a of n){const n=new GroupModel("group",a,t);n.depth=GROUP_DEPTH,n.items=MenuBuilder.getTagsItems(e,o,n,a,s),i.push(n)}return i}static getTagsItems(e,t,n,o,s){let i;if(i=void 0===o?Object.keys(t):o.tags,!Array.isArray(i))return console.warn("Unexpected values of tags. Check tags or x-tagGroups in your definition."),[];const a=i.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 a){if(!t)continue;const o=new GroupModel("tag",t,n);if(o.depth=GROUP_DEPTH+1,""===t.name){const n=[...MenuBuilder.addMarkdownItems(t.description||"",o,o.depth+1,s),...this.getOperationsItems(e,void 0,t,o.depth+1,s)];r.push(...n);continue}const i=this.getTagRelatedSchema({parser:e,tag:t,parent:o,schemaDefinitionsTagName:s.schemaDefinitionsTagName});o.items=[...i,...MenuBuilder.addMarkdownItems(t.description||"",o,o.depth+1,s),...this.getOperationsItems(e,o,t,o.depth+1,s)],r.push(o)}return s.sortTagsAlphabetically&&r.sort(alphabeticallyByProp("name")),r}static getTagRelatedSchema({parser:e,tag:t,parent:n,schemaDefinitionsTagName:o}){var s;const i=o?[o]:[];return Object.entries((null===(s=e.definition.components)||void 0===s?void 0:s.schemas)||{}).map((([e,o])=>{if(!(o["x-tags"]||i).includes(t.name))return null;const s=new GroupModel("schema",{name:e,"x-displayName":`${o.title||e}`,description:`<SchemaDefinition showWriteOnly={true} schemaRef="#/components/schemas/${e}" />`,isSchema:!0,level:2},n);return s.depth=n.depth+1,s})).filter(Boolean)}static getOperationsItems(e,t,n,o,s){if(0===n.operations.length)return[];const i=[];for(const a of n.operations){const n=new OperationModel(e,a,t,s);n.depth=o,i.push(n)}return s.sortOperationsAlphabetically&&i.sort(alphabeticallyByProp("name")),i}static getTagsWithOperations(e,t){const n={},{definition:o}=e,s=o["x-webhooks"]||o.webhooks;for(const e of t||[])n[e.name]=Object.assign(Object.assign({},e),{operations:[]});function i(e,t,o){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);i(e,{[s]:t},o);continue}let p=null==r?void 0:r.tags;p&&p.length||(p=[""]);for(const e of p){let i=n[e];void 0===i&&(i={name:e,operations:[]},n[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:!!o}))}}}}return o.paths&&i(e,o.paths),s&&i(e,s,!0),n}}
+//# sourceMappingURL=MenuBuilder.js.map

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

@@ -0,0 +1,51 @@
+import type { OpenAPIRef, OpenAPIDefinition } from '../types';
+import type { MergedOpenAPISchema } from './types';
+import type { Options } from './Options/types';
+/**
+ * Loads and keeps spec. Provides raw spec operations
+ */
+export declare function pushRef(stack: string[], ref?: string): string[];
+export declare function concatRefStacks(base: string[], stack?: string[]): string[];
+export declare class OpenAPIParser {
+    private options;
+    definitionUrl?: string;
+    definition: OpenAPIDefinition;
+    private readonly allowMergeRefs;
+    constructor(definition: OpenAPIDefinition, definitionUrl?: string, options?: Options);
+    validate(spec: GenericObject): void;
+    preprocess(spec: OpenAPIDefinition): void;
+    /**
+     * get spec part by JsonPointer ($ref)
+     */
+    byRef: <T>(ref: string) => T | undefined;
+    /**
+     * checks if the object is OpenAPI reference (contains $ref property)
+     */
+    isRef<T>(obj: OpenAPIRef | T): obj is OpenAPIRef;
+    /**
+     * Resolve given reference object or return as is if it is not a reference
+     * @param obj object to dereference
+     * @param forceCircular whether to dereference even if it is circular ref
+     * @param mergeAsAllOf
+     */
+    deref<T>(obj: OpenAPIRef | T, baseRefsStack?: string[], mergeAsAllOf?: boolean): {
+        resolved: T;
+        refsStack: string[];
+    };
+    mergeRefs<T>(ref: OpenAPIRef, resolved: T, mergeAsAllOf: boolean): T;
+    /**
+     * Merge allOf constraints.
+     * @param schema schema with allOF
+     * @param $ref pointer of the schema
+     * @param forceCircular whether to dereference children even if it is a circular ref
+     * @param used$Refs
+     */
+    mergeAllOf(schema: MergedOpenAPISchema, $ref: string | undefined, refsStack: string[]): MergedOpenAPISchema;
+    /**
+     * Find all derived definitions among #/components/schemas from any of $refs
+     * returns map of definition pointer to definition name
+     * @param $refs array of references to find derived from
+     */
+    findDerived($refs: string[]): Record<string, string[] | string>;
+    private hoistOneOfs;
+}

package/lib-esm/services/OpenAPIParser.js

@@ -0,0 +1,2 @@
+var __rest=this&&this.__rest||function(e,t){var r={};for(var i in e)Object.prototype.hasOwnProperty.call(e,i)&&t.indexOf(i)<0&&(r[i]=e[i]);if(null!=e&&"function"==typeof Object.getOwnPropertySymbols){var n=0;for(i=Object.getOwnPropertySymbols(e);n<i.length;n++)t.indexOf(i[n])<0&&Object.prototype.propertyIsEnumerable.call(e,i[n])&&(r[i[n]]=e[i[n]])}return r};import{IS_BROWSER,getDefinitionName}from"../utils/";import{JsonPointer}from"../utils/JsonPointer";import{NormalizedOptions}from"./Options/NormalizedOptions";export function pushRef(e,t){return t&&e[e.length-1]!==t?[...e,t]:e}export function concatRefStacks(e,t){return t?e.concat(t):e}export class OpenAPIParser{constructor(e,t,r=NormalizedOptions({})){Object.defineProperty(this,"options",{enumerable:!0,configurable:!0,writable:!0,value:r}),Object.defineProperty(this,"definitionUrl",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),Object.defineProperty(this,"definition",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),Object.defineProperty(this,"allowMergeRefs",{enumerable:!0,configurable:!0,writable:!0,value:!1}),Object.defineProperty(this,"byRef",{enumerable:!0,configurable:!0,writable:!0,value:e=>{let t;if(this.definition){"#"!==e.charAt(0)&&(e="#"+e),e=decodeURIComponent(e);try{t=JsonPointer.get(this.definition,e)}catch(e){}return t||{}}}}),this.validate(e),this.preprocess(e),this.definition=e,this.allowMergeRefs=e.openapi.startsWith("3.1");const i=IS_BROWSER?window.location.href:"";"string"==typeof t&&(this.definitionUrl=new URL(t,i).href)}validate(e){if(void 0===e.openapi)throw new Error("Document must be valid OpenAPI 3.0.0 definition")}preprocess(e){e.info&&this.options.hideInfoDescription&&(e.info.description="")}isRef(e){return!!e&&(void 0!==e.$ref&&null!==e.$ref)}deref(e,t=[],r=!1){const i=null==e?void 0:e["x-refsStack"];if(t=concatRefStacks(t,i),this.isRef(e)){const i=getDefinitionName(e.$ref);if(i&&this.options.ignoreNamedSchemas.has(i))return{resolved:{type:"object",title:i},refsStack:t};let n=this.byRef(e.$ref);if(!n)throw new Error(`Failed to resolve $ref "${e.$ref}"`);let s=t;if(t.includes(e.$ref))n=Object.assign({},n,{"x-circular-ref":!0});else if(this.isRef(n)){const e=this.deref(n,t,r);s=e.refsStack,n=e.resolved}return s=pushRef(t,e.$ref),n=this.allowMergeRefs?this.mergeRefs(e,n,r):n,{resolved:n,refsStack:s}}return{resolved:e,refsStack:concatRefStacks(t,i)}}mergeRefs(e,t,r){const{$ref:i}=e,n=__rest(e,["$ref"]),s=Object.keys(n);if(0===s.length)return t;if(r&&s.some((e=>!["description","title","externalDocs","x-refsStack","x-parentRefs","readOnly","writeOnly"].includes(e)))){const e=n,{description:r,title:i,readOnly:s,writeOnly:o}=e;return{allOf:[{description:r,title:i,readOnly:s,writeOnly:o},t,__rest(e,["description","title","readOnly","writeOnly"])]}}return Object.assign(Object.assign({},t),n)}mergeAllOf(e,t,r){var i;if(e["x-circular-ref"])return e;if(void 0===(e=this.hoistOneOfs(e)).allOf)return e;let n=Object.assign(Object.assign({},e),{"x-parentRefs":[],allOf:void 0,title:e.title||getDefinitionName(t)});void 0!==n.properties&&"object"==typeof n.properties&&(n.properties=Object.assign({},n.properties)),void 0!==n.items&&"object"==typeof n.items&&(n.items=Object.assign({},n.items));const s=e.allOf.map((e=>{var t;const{resolved:i,refsStack:s}=this.deref(e,r,!0),o=e.$ref||void 0,f=this.mergeAllOf(i,o,s);if(!f["x-circular-ref"]||!f.allOf)return o&&(null===(t=n["x-parentRefs"])||void 0===t||t.push(...f["x-parentRefs"]||[],o)),{$ref:o,refsStack:pushRef(s,o),schema:f}})).filter((e=>void 0!==e));for(const{schema:e,refsStack:r}of s){const{type:s,enum:o,properties:f,items:l,required:a,title:c,description:p,readOnly:d,writeOnly:O,oneOf:u,anyOf:y,"x-circular-ref":m}=e,h=__rest(e,["type","enum","properties","items","required","title","description","readOnly","writeOnly","oneOf","anyOf","x-circular-ref"]);if(n.type!==s&&void 0!==n.type&&void 0!==s&&console.warn(`Incompatible types in allOf at "${t}": "${n.type}" and "${s}"`),void 0!==s&&(Array.isArray(s)&&Array.isArray(n.type)?n.type=[...s,...n.type]:n.type=s),void 0!==o&&(Array.isArray(o)&&Array.isArray(n.enum)?n.enum=Array.from(new Set([...o,...n.enum])):n.enum=o),void 0!==f&&"object"==typeof f){n.properties=n.properties||{};for(const e in f){const s=concatRefStacks(r,null===(i=f[e])||void 0===i?void 0:i["x-refsStack"]);if(n.properties[e]){if(!m){const r=this.mergeAllOf({allOf:[n.properties[e],f[e]],"x-refsStack":s},t+"/properties/"+e,s);n.properties[e]=r}}else n.properties[e]=Object.assign(Object.assign({},f[e]),{"x-refsStack":s})}}if(void 0!==l&&!m){const i="boolean"==typeof n.items?{}:Object.assign({},n.items),s="boolean"==typeof e.items?{}:Object.assign({},e.items);n.items=this.mergeAllOf({allOf:[i,s]},t+"/items",r)}void 0!==u&&(n.oneOf=u),void 0!==y&&(n.anyOf=y),void 0!==a&&(n.required=[...n.required||[],...a]),n=Object.assign(Object.assign(Object.assign({},n),{title:n.title||c,description:n.description||p,readOnly:void 0!==n.readOnly?n.readOnly:d,writeOnly:void 0!==n.writeOnly?n.writeOnly:O,"x-circular-ref":n["x-circular-ref"]||m}),h)}return n}findDerived(e){const t={},r=this.definition.components&&this.definition.components.schemas||{};for(const i in r){const{resolved:n}=this.deref(r[i]);void 0!==n.allOf&&n.allOf.find((t=>void 0!==t.$ref&&e.indexOf(t.$ref)>-1))&&(t["#/components/schemas/"+i]=[n["x-discriminator-value"]||i])}return t}hoistOneOfs(e){if(void 0===e.allOf)return e;const t=e.allOf;for(let e=0;e<t.length;e++){const r=t[e];if(Array.isArray(r.oneOf)){const i=t.slice(0,e),n=t.slice(e+1);return{oneOf:r.oneOf.map((e=>({allOf:[...i,e,...n]})))}}}return e}}
+//# sourceMappingURL=OpenAPIParser.js.map

package/lib-esm/services/Options/NormalizedOptions.d.ts

@@ -0,0 +1,2 @@
+import type { Options, RawOptions } from './types';
+export declare function NormalizedOptions(raw: RawOptions, defaultOptions?: RawOptions): Options;

package/lib-esm/services/Options/NormalizedOptions.js

@@ -0,0 +1,2 @@
+import{generateMediaQueries}from"@redocly/theme";import{DEFAULT_SEARCH_MAX_DEPTH,LayoutVariant,WindowReferenceOptions}from"../../constants";import{SearchMode}from"./types";import{argValueToBoolean,argValueToExpandLevel,argValueToInt,argValueToNumber,getWindowReferenceOptions}from"../../utils";import{normalizePath}from"../utils";import{addTrailingSlash,normalizeExpandResponses,normalizePayloadSampleIdx,normalizeShowExtensions,normalizeScrollYOffset}from"./helpers";import{SideNavStyle}from"../types";export function NormalizedOptions(e,a){var o,n,l;e=Object.assign(Object.assign({},a),e);const r=Array.isArray(e.ignoreNamedSchemas)?e.ignoreNamedSchemas:null===(o=e.ignoreNamedSchemas)||void 0===o?void 0:o.split(",").map((e=>e.trim())),i={corsProxyUrl:addTrailingSlash(e.corsProxyUrl),authCorsProxyUrl:addTrailingSlash(e.authCorsProxyUrl),ctrlFHijack:argValueToBoolean(e.ctrlFHijack,!0),disableDeepLinks:argValueToBoolean(e.disableDeepLinks,!1),disableTryItRequestUrlEncoding:argValueToBoolean(e.disableTryItRequestUrlEncoding,!1),minCharacterLengthToInitSearch:argValueToNumber(e.minCharacterLengthToInitSearch,3),disableSearch:argValueToBoolean(e.disableSearch,!1),disableSidebar:argValueToBoolean(e.disableSidebar,!1),expandResponses:normalizeExpandResponses(e.expandResponses),jsonSampleExpandLevel:argValueToExpandLevel(e.jsonSampleExpandLevel,2),expandDefaultServerVariables:argValueToBoolean(e.expandDefaultServerVariables,!1),expandDefaultRequest:argValueToBoolean(e.expandDefaultRequest,!0),expandDefaultResponse:argValueToBoolean(e.expandDefaultResponse,!0),expandSingleSchemaField:argValueToBoolean(e.expandSingleSchemaField,!1),generatedPayloadSamplesMaxDepth:argValueToInt(e.generatedPayloadSamplesMaxDepth,8),hideDownloadButton:void 0===e.hideDownloadButton?null:argValueToBoolean(e.hideDownloadButton),hideInfoDescription:argValueToBoolean(e.hideInfoDescription),hideHostname:argValueToBoolean(e.hideHostname,!1),hideInfoSection:argValueToBoolean(e.hideInfoSection,!1),hideLoading:argValueToBoolean(e.hideLoading,!1),hideLogo:argValueToBoolean(e.hideLogo,!1),hideFab:argValueToBoolean(e.hideFab,!1),hideRequestPayloadSample:argValueToBoolean(e.hideRequestPayloadSample,!1),hideRightPanel:argValueToBoolean(e.hideRightPanel,!1),hideSchemaPattern:argValueToBoolean(e.hideSchemaPattern,!1),hideOneOfDescription:argValueToBoolean(e.hideOneOfDescription,!1),hideSchemaTitles:argValueToBoolean(e.hideSchemaTitles,!1),hideSingleRequestSampleTab:argValueToBoolean(e.hideSingleRequestSampleTab,!1),hideTryItPanel:argValueToBoolean(e.hideTryItPanel,!1),showObjectSchemaExamples:argValueToBoolean(e.showObjectSchemaExamples,!1),showAccessMode:argValueToBoolean(e.showAccessMode,!1),maxDisplayedEnumValues:argValueToNumber(e.maxDisplayedEnumValues),maxResponseHeadersToShowInTryIt:argValueToNumber(e.maxResponseHeadersToShowInTryIt,0),menuToggle:argValueToBoolean(e.menuToggle,!0),mockServer:(null===(n=e.mockServer)||void 0===n?void 0:n.url)?{url:e.mockServer.url,position:e.mockServer.position||"first",description:e.mockServer.description||"Mock server"}:void 0,nativeScrollbars:argValueToBoolean(e.nativeScrollbars,!1),oAuth2RedirectURI:e.oAuth2RedirectURI||null,onlyRequiredInSamples:argValueToBoolean(e.onlyRequiredInSamples,!1),pathInMiddlePanel:argValueToBoolean(e.pathInMiddlePanel,!1),onDeepLinkClick:e.onDeepLinkClick||getWindowReferenceOptions(WindowReferenceOptions.ON_DEEP_LINK_CLICK),requestInterceptor:e.requestInterceptor||getWindowReferenceOptions(WindowReferenceOptions.REQUEST_INTERCEPTOR),routingBasePath:e.routingBasePath&&normalizePath(e.routingBasePath)||"",routingStrategy:e.routingStrategy,schemaExpansionLevel:argValueToExpandLevel(e.schemaExpansionLevel),pagination:e.pagination||"none",payloadSampleIdx:normalizePayloadSampleIdx(e.payloadSampleIdx,0),requiredPropsFirst:argValueToBoolean(e.requiredPropsFirst,!1),markdownHeadingsAnchorLevel:argValueToNumber(e.markdownHeadingsAnchorLevel,2),samplesTabsMaxCount:argValueToInt(e.samplesTabsMaxCount,5),scrollYOffset:normalizeScrollYOffset(e.scrollYOffset),searchAutoExpand:argValueToBoolean(e.searchAutoExpand,!0),searchFieldLevelBoost:argValueToNumber(e.searchFieldLevelBoost,.95),searchMaxDepth:argValueToNumber(e.searchMaxDepth,DEFAULT_SEARCH_MAX_DEPTH),searchOperationTitleBoost:argValueToNumber(e.searchOperationTitleBoost,4),searchTagTitleBoost:argValueToNumber(e.searchTagTitleBoost,8),sendXUserAgentInTryIt:argValueToBoolean(e.sendXUserAgentInTryIt,!1),showWebhookVerb:argValueToBoolean(e.showWebhookVerb,!1),showChangeLayoutButton:argValueToBoolean(e.showChangeLayoutButton,!0),showConsole:null!=e.hideTryItPanel?!e.hideTryItPanel:null===(l=e.showConsole)||void 0===l||l,showExtensions:normalizeShowExtensions(e.showExtensions),preserveOriginalExtensionsName:argValueToBoolean(e.preserveOriginalExtensionsName,!1),showNextButton:argValueToBoolean(e.showNextButton,!0),showRightPanelToggle:argValueToBoolean(e.showRightPanelToggle,!0),showSecuritySchemeType:argValueToBoolean(e.showSecuritySchemeType,!0),hideSecuritySection:argValueToBoolean(e.hideSecuritySection,!1),simpleOneOfTypeLabel:argValueToBoolean(e.simpleOneOfTypeLabel,!1),sortEnumValuesAlphabetically:argValueToBoolean(e.sortEnumValuesAlphabetically),sortOperationsAlphabetically:argValueToBoolean(e.sortOperationsAlphabetically),sortPropsAlphabetically:argValueToBoolean(e.sortPropsAlphabetically,!1),sortTagsAlphabetically:argValueToBoolean(e.sortTagsAlphabetically,!1),unstable_ignoreMimeParameters:argValueToBoolean(e.unstable_ignoreMimeParameters,!1),untrustedDefinition:argValueToBoolean(e.untrustedDefinition,!1),enumSkipQuotes:argValueToBoolean(e.enumSkipQuotes),whiteLabel:argValueToBoolean(e.whiteLabel),linkForId:e.linkForId||getWindowReferenceOptions(WindowReferenceOptions.LINK_FOR_ID),generateDeepLink:e.generateDeepLink||getWindowReferenceOptions(WindowReferenceOptions.GENERATE_DEEP_LINK),skipBundleAndConvert:argValueToBoolean(e.skipBundleAndConvert),disablePaginationLoadingAnimation:argValueToBoolean(!!e.disablePaginationLoadingAnimation),disableErrorBoundary:argValueToBoolean(e.disableErrorBoundary),ignoreNamedSchemas:new Set(r),mediaQueries:generateMediaQueries((null==e?void 0:e.breakpoints)||{}),showAtBreakpoint:e.showAtBreakpoint,allowedMdComponents:(null==e?void 0:e.allowedMdComponents)||{}};null!=e.showConsole&&console.warn('"showConsole" option is deprecated. Please, use "hideTryItPanel" instead.');const t="object"==typeof e.layout?e.layout:null;if(!(null==e?void 0:e.pagination)&&(null==t?void 0:t.scope))switch(console.warn('"layout.scope" and "routingStrategy" settings are deprecated. Please, use "pagination" instead.'),null==t?void 0:t.scope){case"all":default:i.pagination="none",i.routingStrategy="hash";break;case"section":i.pagination="section",i.routingStrategy="browser";break;case"item":i.pagination="item",i.routingStrategy="browser"}return i.routingStrategy=void 0!==e.routingStrategy?e.routingStrategy:"none"===i.pagination?"hash":"browser",i.disablePaginationLoadingAnimation=!!e.disablePaginationLoadingAnimation||"none"===i.pagination,Object.assign(DEFAULT_USER_OPTIONS,e,i)}const DEFAULT_USER_OPTIONS={defaultSampleLanguage:"",generateCodeSamples:{languages:[]},layout:LayoutVariant.THREE_PANEL,sideNavStyle:SideNavStyle.SummaryOnly,searchMode:SearchMode.Default,sidebarLinks:{},events:{},hooks:getWindowReferenceOptions(WindowReferenceOptions.HOOKS)||{},unstable_tryItButtonOverride:null,unstable_externalCodeSamples:[],deepLinkSeparator:"/",deepLinkPrefix:"!",markdownItemsPagination:"none"};
+//# sourceMappingURL=NormalizedOptions.js.map

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

@@ -0,0 +1,8 @@
+import type { RawOptions } from './types';
+export declare function normalizeExpandResponses(value: RawOptions['expandResponses']): 'all' | {
+    [code: string]: boolean;
+};
+export declare function addTrailingSlash(url?: string): string | undefined;
+export declare function normalizePayloadSampleIdx(value: RawOptions['payloadSampleIdx'], defaultValue: number): number;
+export declare function normalizeShowExtensions(value: RawOptions['showExtensions']): string[] | boolean;
+export declare function normalizeScrollYOffset(value: RawOptions['scrollYOffset']): () => number;

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

@@ -0,0 +1,2 @@
+import{querySelector}from"../../utils/dom";import{isNumeric}from"../../utils/helpers";export function normalizeExpandResponses(e){if("all"===e)return"all";if("string"==typeof e){const t={};return e.split(",").forEach((e=>{t[e.trim()]=!0})),t}return void 0!==e&&console.warn(`expandResponses must be a string but received value "${e}" of type ${typeof e}`),{}}export function addTrailingSlash(e){return e?e.endsWith("/")?e:e+"/":void 0}export function normalizePayloadSampleIdx(e,t){return"number"==typeof e?Math.max(0,e):"string"==typeof e?isFinite(e)?parseInt(e,10):0:t}export function normalizeShowExtensions(e){if(void 0===e)return!1;if(""===e)return!0;if("string"!=typeof e)return e;switch(e){case"true":return!0;case"false":return!1;default:return e.split(",").map((e=>e.trim()))}}export function normalizeScrollYOffset(e){if("string"==typeof e&&!isNumeric(e)){const t=querySelector(e);t||console.warn("scrollYOffset value is a selector to non-existing element. Using offset 0 by default");const r=t&&t.getBoundingClientRect().bottom||0;return()=>r}return"number"==typeof e||isNumeric(e)?()=>"number"==typeof e?e:parseFloat(e):"function"==typeof e?()=>{const t=e();return"number"!=typeof t&&console.warn(`scrollYOffset should return number but returned value "${t}" of type ${typeof t}`),t}:(void 0!==e&&console.warn("Wrong value for scrollYOffset ReDoc option: should be string, number or function"),()=>0)}
+//# sourceMappingURL=helpers.js.map

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

@@ -0,0 +1,2 @@
+export * from './NormalizedOptions';
+export * from './types';

package/lib-esm/services/Options/index.js

@@ -0,0 +1,2 @@
+export*from"./NormalizedOptions";export*from"./types";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,258 @@
+import type { LayoutVariant } from 'src/constants';
+import type { CodeSamplesConfig, Languages } from '../code-samples';
+import type { ExternalLink, HooksConfig, MarkdownItemsPagination, MDXComponentMeta, Pagination, SideNavStyle, Unstable_ExternalCodeSample } from '../types';
+import type { Events } from '../../events';
+import type { MediaQueries } from '@redocly/theme';
+import type { OperationModel } from 'src/models/Operation';
+import type { LabelsConfigRaw } from '../labels/types';
+export declare enum SearchMode {
+    Default = "default",
+    PathOnly = "path-only"
+}
+export interface RawOptions {
+    licenseKey?: string;
+    showAtBreakpoint?: {
+        sidebar?: keyof Omit<MediaQueries, 'print'>;
+        samplesPanel?: keyof Omit<MediaQueries, 'print'>;
+    };
+    scrollYOffset?: number | string | (() => number);
+    hideHostname?: boolean | string;
+    hideInfoDescription?: boolean | string;
+    expandResponses?: string | 'all';
+    requiredPropsFirst?: boolean | string;
+    sortPropsAlphabetically?: boolean | string;
+    sortEnumValuesAlphabetically?: boolean | string;
+    sortOperationsAlphabetically?: boolean | string;
+    sortTagsAlphabetically?: boolean | string;
+    nativeScrollbars?: boolean | string;
+    pathInMiddlePanel?: boolean | string;
+    untrustedDefinition?: boolean | string;
+    hideLoading?: boolean | string;
+    hideDownloadButton?: boolean | string;
+    downloadDefinitionUrl?: string;
+    disableSearch?: boolean | string;
+    searchAutoExpand?: boolean;
+    searchOperationTitleBoost?: number | string;
+    searchTagTitleBoost?: number | string;
+    searchFieldLevelBoost?: number | string;
+    showChangeLayoutButton?: boolean | string;
+    onlyRequiredInSamples?: boolean | string;
+    generatedPayloadSamplesMaxDepth?: number | string;
+    sendXUserAgentInTryIt?: boolean | string;
+    showExtensions?: boolean | string | string[];
+    preserveOriginalExtensionsName?: boolean;
+    hideSingleRequestSampleTab?: boolean | string;
+    hideRequestPayloadSample?: boolean;
+    menuToggle?: boolean | string;
+    jsonSampleExpandLevel?: number | string | 'all';
+    hideSchemaTitles?: boolean | string;
+    hideSecuritySection?: boolean;
+    showSecuritySchemeType?: boolean;
+    simpleOneOfTypeLabel?: boolean | string;
+    payloadSampleIdx?: number;
+    expandSingleSchemaField?: boolean | string;
+    schemaExpansionLevel?: number | string | 'all';
+    samplesTabsMaxCount?: number;
+    unstable_tryItButtonOverride?: {
+        label: string;
+        link: string;
+    } | null;
+    mockServer?: {
+        url?: string;
+        position?: 'first' | 'last' | 'replace' | 'off';
+        description?: string;
+    };
+    labels?: LabelsConfigRaw;
+    enumSkipQuotes?: boolean | string;
+    expandDefaultServerVariables?: boolean;
+    expandDefaultRequest?: boolean;
+    expandDefaultResponse?: boolean;
+    maxDisplayedEnumValues?: number;
+    unstable_externalCodeSamples?: Unstable_ExternalCodeSample[];
+    unstable_ignoreMimeParameters?: boolean;
+    hooks?: HooksConfig;
+    hideSchemaPattern?: boolean;
+    hideOneOfDescription?: boolean;
+    hideFab?: boolean;
+    markdownHeadingsAnchorLevel?: number;
+    schemaDefinitionsTagName?: string;
+    minCharacterLengthToInitSearch?: number;
+    maxResponseHeadersToShowInTryIt?: number;
+    showWebhookVerb?: boolean;
+    showObjectSchemaExamples?: boolean;
+    showAccessMode?: boolean;
+    disableTryItRequestUrlEncoding?: boolean;
+    /** @deprecated use hideTryItPanel instead */
+    showConsole?: boolean;
+    hideTryItPanel?: boolean;
+    hideRightPanel?: boolean;
+    showRightPanelToggle?: boolean;
+    layout?: LayoutVariant;
+    defaultSampleLanguage?: Languages | string;
+    deepLinkSeparator?: string;
+    deepLinkPrefix?: string;
+    disableDeepLinks?: boolean;
+    sideNavStyle?: SideNavStyle;
+    whiteLabel?: boolean;
+    hideLogo?: boolean;
+    hideInfoSection?: boolean;
+    oAuth2RedirectURI?: string | null;
+    events?: Events;
+    corsProxyUrl?: string;
+    authCorsProxyUrl?: string;
+    linkForId?: ((id: string) => string) | null;
+    generateDeepLink?: ((fieldFragment: string, operationLink: any) => string) | undefined | null;
+    onDeepLinkClick?: ((link: string) => void) | undefined | null;
+    requestInterceptor?: ((req: Request, operation: OperationModel) => void) | undefined | null;
+    sidebarLinks?: {
+        beforeInfo?: Array<ExternalLink>;
+        end?: Array<ExternalLink>;
+    };
+    pagination?: Pagination;
+    showNextButton?: boolean;
+    routingStrategy?: 'hash' | 'browser';
+    markdownItemsPagination?: MarkdownItemsPagination;
+    disableSidebar?: boolean;
+    skipBundleAndConvert?: boolean;
+    routingBasePath?: string;
+    searchMode?: SearchMode;
+    ctrlFHijack?: boolean;
+    disablePaginationLoadingAnimation?: boolean | null;
+    generateCodeSamples?: CodeSamplesConfig;
+    disableErrorBoundary?: boolean;
+    unstable_externalDescription?: string;
+    searchMaxDepth?: number;
+    mediaQueries?: MediaQueries;
+    ignoreNamedSchemas?: string[] | string;
+    breakpoints?: Omit<MediaQueries, 'print'>;
+    allowedMdComponents?: Record<string, MDXComponentMeta>;
+}
+export interface DefaultOptions {
+    mediaQueries?: MediaQueries;
+    ignoreNamedSchemas?: string[] | string;
+    breakpoints?: Omit<MediaQueries, 'print'>;
+    showAtBreakpoint?: {
+        sidebar?: keyof Omit<MediaQueries, 'print'>;
+        samplesPanel?: keyof Omit<MediaQueries, 'print'>;
+    };
+    allowedMdComponents?: Record<string, MDXComponentMeta>;
+}
+export interface Options {
+    showAtBreakpoint: {
+        sidebar: keyof Omit<MediaQueries, 'print'>;
+        samplesPanel: keyof Omit<MediaQueries, 'print'>;
+    };
+    mediaQueries: MediaQueries;
+    scrollYOffset: () => number;
+    hideHostname: boolean;
+    hideInfoDescription: boolean;
+    expandResponses: 'all' | {
+        [code: string]: boolean;
+    };
+    requiredPropsFirst: boolean;
+    sortPropsAlphabetically: boolean;
+    sortEnumValuesAlphabetically: boolean;
+    sortOperationsAlphabetically: boolean;
+    sortTagsAlphabetically: boolean;
+    nativeScrollbars: boolean;
+    pathInMiddlePanel: boolean;
+    untrustedDefinition: boolean;
+    hideLoading: boolean;
+    hideDownloadButton: boolean;
+    downloadDefinitionUrl?: string;
+    disableSearch: boolean;
+    searchAutoExpand: boolean;
+    searchOperationTitleBoost: number;
+    searchTagTitleBoost: number;
+    searchFieldLevelBoost: number;
+    showChangeLayoutButton: boolean;
+    onlyRequiredInSamples: boolean;
+    generatedPayloadSamplesMaxDepth: number;
+    sendXUserAgentInTryIt: boolean;
+    showExtensions: string[] | boolean;
+    preserveOriginalExtensionsName: boolean;
+    hideSingleRequestSampleTab: boolean;
+    hideRequestPayloadSample: boolean;
+    menuToggle: boolean;
+    jsonSampleExpandLevel: number;
+    hideSchemaTitles: boolean;
+    hideSecuritySection: boolean;
+    showSecuritySchemeType: boolean;
+    simpleOneOfTypeLabel: boolean;
+    payloadSampleIdx: number;
+    expandSingleSchemaField: boolean;
+    schemaExpansionLevel: number;
+    samplesTabsMaxCount: number;
+    unstable_tryItButtonOverride?: {
+        label: string;
+        link: string;
+    } | null;
+    mockServer?: {
+        url: string;
+        position: 'first' | 'last' | 'replace' | 'off';
+        description: string;
+    };
+    allowedMdComponents: Record<string, MDXComponentMeta>;
+    labels?: LabelsConfigRaw;
+    enumSkipQuotes: boolean;
+    expandDefaultServerVariables: boolean;
+    expandDefaultRequest: boolean;
+    expandDefaultResponse: boolean;
+    maxDisplayedEnumValues: number;
+    ignoreNamedSchemas: Set<string>;
+    unstable_externalCodeSamples: Unstable_ExternalCodeSample[];
+    unstable_ignoreMimeParameters: boolean;
+    hooks: HooksConfig;
+    hideSchemaPattern: boolean;
+    hideOneOfDescription: boolean;
+    hideFab: boolean;
+    markdownHeadingsAnchorLevel: number;
+    schemaDefinitionsTagName?: string;
+    minCharacterLengthToInitSearch: number;
+    maxResponseHeadersToShowInTryIt: number;
+    showWebhookVerb: boolean;
+    showObjectSchemaExamples: boolean;
+    showAccessMode: boolean;
+    disableTryItRequestUrlEncoding?: boolean;
+    /** @deprecated use hideTryItPanel instead */
+    showConsole: boolean;
+    hideTryItPanel: boolean;
+    hideRightPanel: boolean;
+    showRightPanelToggle: boolean;
+    layout: LayoutVariant;
+    defaultSampleLanguage: Languages | string;
+    deepLinkSeparator: string;
+    deepLinkPrefix: string;
+    disableDeepLinks: boolean;
+    sideNavStyle: SideNavStyle;
+    whiteLabel: boolean;
+    hideLogo: boolean;
+    hideInfoSection: boolean;
+    oAuth2RedirectURI: string | null;
+    events: Events;
+    corsProxyUrl?: string;
+    authCorsProxyUrl?: string;
+    linkForId: ((id: string) => string) | null | undefined;
+    generateDeepLink: ((fieldFragment: string, operationLink: any) => string) | undefined | null;
+    onDeepLinkClick: ((link: string) => void) | undefined | null;
+    requestInterceptor: ((req: Request, operation: OperationModel) => void) | undefined | null;
+    sidebarLinks?: {
+        beforeInfo?: Array<ExternalLink>;
+        end?: Array<ExternalLink>;
+    };
+    pagination: Pagination;
+    showNextButton?: boolean;
+    routingStrategy?: 'hash' | 'browser';
+    markdownItemsPagination: MarkdownItemsPagination;
+    disableSidebar: boolean;
+    skipBundleAndConvert: boolean;
+    routingBasePath: string;
+    searchMode: SearchMode;
+    ctrlFHijack?: boolean;
+    disablePaginationLoadingAnimation: boolean;
+    generateCodeSamples: CodeSamplesConfig;
+    disableErrorBoundary: boolean;
+    /** @deprecated */
+    unstable_externalDescription?: string;
+    searchMaxDepth: number;
+}

package/lib-esm/services/Options/types.js

@@ -0,0 +1,2 @@
+export var SearchMode;!function(e){e.Default="default",e.PathOnly="path-only"}(SearchMode||(SearchMode={}));
+//# sourceMappingURL=types.js.map

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

@@ -1,10 +1,13 @@
-import type { IMenuItem, ScrollService, HistoryService, MenuItemType, SchemaModel, SpecStore } from '../redoc-lib';
-import type { RedocProNormalizedOptions } from './ProStore';
+import type { IMenuItem, ScrollService, HistoryService, MenuItemType, SpecStore } from '../services';
+import type { Options } from './Options/types';
+import type { SchemaModel } from '../models';
 import { VersionedSpecStore } from './VersionedSpecStore';
-export declare type ExtendedMenuItem = Omit<IMenuItem, 'type'> & {
+export type ExtendedMenuItem = Omit<IMenuItem, 'type'> & {
     type: MenuItemType | 'spec';
     linkable?: boolean;
     href?: string;
+    httpVerb?: string;
+    path?: string;
 };
 /**
  * Stores all side-menu related information
@@ -12,7 +15,7 @@ export declare type ExtendedMenuItem = Omit<IMenuItem, 'type'> & {
 export declare class ProMenu {
     definition: SpecStore | VersionedSpecStore;
     scroll: ScrollService;
-    options: RedocProNormalizedOptions;
+    options: Options;
     history: HistoryService;
     /**
      * Statically try update scroll position
@@ -40,7 +43,7 @@ export declare class ProMenu {
      * @param options normalized options
      * @param history
      */
-    constructor(definition: SpecStore | VersionedSpecStore, scroll: ScrollService, options: RedocProNormalizedOptions, history: HistoryService);
+    constructor(definition: SpecStore | VersionedSpecStore, scroll: ScrollService, options: Options, history: HistoryService);
     subscribe(): void;
     toggleSidebar(): void;
     closeSidebar(): void;

package/lib-esm/services/ProMenu.js

@@ -1,2 +1,2 @@
-var __decorate=this&&this.__decorate||function(e,t,i,s){var n,o=arguments.length,r=o<3?t:null===s?s=Object.getOwnPropertyDescriptor(t,i):s;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)r=Reflect.decorate(e,t,i,s);else for(var a=e.length-1;a>=0;a--)(n=e[a])&&(r=(o<3?n(r):o>3?n(t,i,r):n(t,i))||r);return o>3&&r&&Object.defineProperty(t,i,r),r};import{action,observable,makeObservable}from"mobx";import{flattenByProp,querySelector,GROUP_DEPTH,escapeHTMLAttrChars}from"../redoc-lib";import{SECTION_ATTR}from"../redoc-lib/src/services/constants";import{history as historyInst}from"../redoc-lib/src/services/HistoryService";import{VersionedSpecStore}from"./VersionedSpecStore";export class ProMenu{constructor(e,t,i,s){Object.defineProperty(this,"definition",{enumerable:!0,configurable:!0,writable:!0,value:e}),Object.defineProperty(this,"scroll",{enumerable:!0,configurable:!0,writable:!0,value:t}),Object.defineProperty(this,"options",{enumerable:!0,configurable:!0,writable:!0,value:i}),Object.defineProperty(this,"history",{enumerable:!0,configurable:!0,writable:!0,value:s}),Object.defineProperty(this,"flatItems",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),Object.defineProperty(this,"items",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),Object.defineProperty(this,"activeRenderItemIdx",{enumerable:!0,configurable:!0,writable:!0,value:-1}),Object.defineProperty(this,"renderItems",{enumerable:!0,configurable:!0,writable:!0,value:[]}),Object.defineProperty(this,"activeItemIdx",{enumerable:!0,configurable:!0,writable:!0,value:-1}),Object.defineProperty(this,"sideBarOpened",{enumerable:!0,configurable:!0,writable:!0,value:!1}),Object.defineProperty(this,"_unsubscribe",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),Object.defineProperty(this,"_hashUnsubscribe",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),Object.defineProperty(this,"getItemById",{enumerable:!0,configurable:!0,writable:!0,value:e=>this.flatItems.find((t=>t.id===e))}),Object.defineProperty(this,"initOnHistory",{enumerable:!0,configurable:!0,writable:!0,value:(e=this.history.currentId)=>{const[t]=e.split(this.options.deepLinkPrefix);if(!t)return;const i=this.flatItems.find((e=>e.id===t));i&&(this.activate(i,!1,!1,!1,e),i.active=!1)}}),Object.defineProperty(this,"updateOnHistory",{enumerable:!0,configurable:!0,writable:!0,value:(e=this.history.currentId)=>{const[t]=e.split(this.options.deepLinkPrefix);if(!t)return;const i=this.flatItems.find((e=>e.id===t));i?this.activateAndScroll(i,!1,void 0,e):(this.scroll.prevOffsetY=0,this.scroll.scrollIntoViewBySelector(`[${SECTION_ATTR}="${escapeHTMLAttrChars(t)}"]`))}}),Object.defineProperty(this,"updateVersionOnHistory",{enumerable:!0,configurable:!0,writable:!0,value:e=>{if(!("versionsInfo"in this.definition))return;const[t]=e.split("/");let i=this.definition.versionsInfo.findIndex((e=>e.id===t));i<0&&(i=this.definition.versionsInfo.findIndex((e=>e.isDefault))),this.definition.activeVersionIdx!==i&&(this.definition.changeVersion(i<0?0:i),this.updateItemsByVersionChange(!1,e))}}),Object.defineProperty(this,"updateOnScroll",{enumerable:!0,configurable:!0,writable:!0,value:e=>{const t=e?1:-1;let i=this.activeItemIdx;for(;(-1!==i||e)&&!(i>=this.flatItems.length-1&&e);){if(e){let e=!1;const t=this.flatItems[i+1];switch(this.options.pagination){case"section":e=t&&("spec"===t.type||"group"===t.type||"tag"===t.type);break;case"item":e="section"!==(null==t?void 0:t.type)}const s=this.getElementAt(i+1);if(-1===i&&"tag"===this.flatItems[0].type&&(e=!1),this.scroll.isElementBellow(s)||e)break}else{const e=this.flatItems[i]&&this.flatItems[i].type,t="section"===this.options.pagination&&("spec"===e||"group"===e||"tag"===e)||"item"===this.options.pagination&&"section"!==e,s=this.getElementAt(i);if(this.scroll.isElementAbove(s)||t)break}i+=t}const s=this.flatItems[i];"none"===this.options.pagination||"section"===this.options.pagination?s&&s.active||this.activate(s,!0,!0,!1):s&&"section"===s.type&&(s.active||this.activate(s,!0,!0,!1))}}),makeObservable(this),this.items=e.contentItems,this.flatItems=flattenByProp(this.items||[],"items"),this.flatItems.forEach(((e,t)=>e.absoluteIdx=t)),i.disableSidebar||this.subscribe(),this.flatItems.forEach(((e,t)=>normalizeItem(e,t,i.pagination,this.definition instanceof VersionedSpecStore,this.history))),this.renderItems=this.buildRenderItems(0),this.activeItemIdx=-1,this.activeRenderItemIdx=-1,this.definition instanceof VersionedSpecStore&&this.history.subscribe(this.updateVersionOnHistory)}static updateOnHistory(e=historyInst.currentId,t){e&&t.scrollIntoViewBySelector(`[${SECTION_ATTR}="${escapeHTMLAttrChars(e)}"]`)}subscribe(){this._unsubscribe=this.scroll.subscribe(this.updateOnScroll),this._hashUnsubscribe=this.history.subscribe(this.updateOnHistory)}toggleSidebar(){this.sideBarOpened=!this.sideBarOpened}closeSidebar(){this.sideBarOpened=!1}getElementAt(e){const t=this.flatItems[e];return t&&querySelector(`[${SECTION_ATTR}="${escapeHTMLAttrChars(t.id)}"]`)||null}getElementAtOrFirstChild(e){let t=this.flatItems[e];return t&&"group"===t.type&&(t=t.items[0]),t&&querySelector(`[${SECTION_ATTR}="${escapeHTMLAttrChars(t.id)}"]`)||null}get activeItem(){return this.flatItems[this.activeItemIdx]||void 0}updateItemsByVersionChange(e,t){if(!("versionsInfo"in this.definition))return;const i=this.activeItem&&this.activeItem.active?this.activeItem.absoluteIdx:-1;t=t&&withoutVersion(t)||this.activeItem&&this.activeItem.active&&withoutVersion(this.activeItem.id)||"",this.deactivate(this.activeItem),this.items=this.definition.contentItems,this.flatItems=flattenByProp(this.items||[],"items"),this.flatItems.forEach(((e,t)=>normalizeItem(e,t,this.options.pagination,this.definition instanceof VersionedSpecStore,this.history)));const s=t?(this.flatItems.find((e=>withoutVersion(e.id)===t))||{absoluteIdx:-1}).absoluteIdx:-1;if(-1!==s&&"none"!==this.options.pagination||(this.renderItems=this.buildRenderItems(0)),this.activeItemIdx=-1,-1!==s)this.activate(this.flatItems[s],e);else if(-1!==i)this.activateAndScroll(this.flatItems[0],e);else if(e){const e=this.definition.versionsInfo[this.definition.activeVersionIdx];if(!this.history.currentId&&e.isDefault)return;this.history.replace(e.id)}}buildRenderItems(e){if("none"===this.options.pagination)return this.items;let t=this.flatItems[e];if(t||(t=this.flatItems[0]),"spec"===t.type)return this.buildRenderItems(e+1);if("section"===t.type){const e=[],i=getParentOfType(t,"tag");if("section"===this.options.pagination&&i)return[i];if("item"===this.options.pagination&&i)return[Object.assign(Object.assign({},i),{items:getLeadingSectionItems(i)})];const s=getParentSpecItem(t),n=(null==s?void 0:s.items)||this.items;for(let t=0;t<n.length&&"section"===n[t].type;t++)e.push(n[t]);return e}switch(this.options.pagination){case"section":if(("operation"===t.type||"schema"===t.type)&&t.parent)return[t.parent];if("group"!==t.type)return[t];case"item":return"operation"===t.type||"schema"===t.type?[t]:[Object.assign(Object.assign({},t),{items:getLeadingSectionItems(t)})];default:return[]}}activateBase(e,t=!0,i=!1,s){var n,o,r,a,l;if((null===(n=this.activeItem)||void 0===n?void 0:n.id)===(null==e?void 0:e.id)&&!s)return t&&e&&this.history.replace(encodeURI(e.id),i),void(e&&!e.active&&e.activate());if(e&&"group"===e.type)return;if(this.deactivate(this.activeItem),!e)return void this.history.replace("",i);if(e.depth<=GROUP_DEPTH)return;this.activeItemIdx=e.absoluteIdx,t&&this.history.replace(encodeURI(e.id),i),e.activate(),e.expand();const c=new URLSearchParams(s),d="request"===c.get("t"),h="response"===c.get("t"),u=c.get("c"),p=c.get("ct"),f=c.get("in"),m=c.get("path"),v=(null==m?void 0:m.split(this.options.deepLinkSeparator))||[],b=e;if(f){let e=b.parameters;for(const t of v){const i=null==e?void 0:e.find((e=>e.name===t));null==i||i.expand(),e=null===(o=null==i?void 0:i.schema)||void 0===o?void 0:o.fields}}else if(d){const e=null===(r=b.requestBody)||void 0===r?void 0:r.content;null===(a=b.activateMimeName)||void 0===a||a.call(b,p||b.activeMimeName),setTimeout((()=>{var t;return this.activateField(v,null===(t=null==e?void 0:e.active)||void 0===t?void 0:t.schema)}),0)}else if(h){const e=b.responses.find((e=>e.code===u));(null==e?void 0:e.expanded)||null==e||e.expand(),null===(l=b.activateMimeName)||void 0===l||l.call(b,p||b.activeMimeName),setTimeout((()=>{var t,i;return this.activateField(v,null===(i=null===(t=null==e?void 0:e.content)||void 0===t?void 0:t.active)||void 0===i?void 0:i.schema)}),0)}}activate(e,t=!0,i=!1,s=!0,n){if("none"===this.options.pagination)return this.activateBase(e,t,i,n),void(!e&&this.definition instanceof VersionedSpecStore&&this.history.replace(this.definition.currentVersionId,!0));if("group"!==(null==e?void 0:e.type)){if(e&&"item"===this.options.pagination&&"tag"===e.type&&!e.description){if(e.expanded)return void e.collapse();e.expand(),e=this.flatItems[e.absoluteIdx+1]}if(this.activateBase(e,e&&t,i,n),this.activeRenderItemIdx=e?e.absoluteIdx:this.activeRenderItemIdx,this.activeRenderItemIdx>=0){const e=this.buildRenderItems(this.activeRenderItemIdx);e.some(((e,t)=>e.id!==this.renderItems[t].id))&&(this.renderItems=e),this.renderItems[0]&&(this.activeRenderItemIdx=this.renderItems[0].absoluteIdx)}s&&setTimeout((()=>this.scrollToActive())),!e&&this.definition instanceof VersionedSpecStore&&this.history.replace(this.definition.currentVersionId,!0)}}activateField(e,t){var i;for(let s=0;s<e.length-1;s++){const n=e[s],o=s===e.length-1;if((null==t?void 0:t.hasType("array"))&&(null==t?void 0:t.items)&&(t=null==t?void 0:t.items),null==t?void 0:t.oneOf){const e=Number(n);if(isNaN(e))return;null==t||t.activateOneOf(e),t=null==t?void 0:t.oneOf[e];continue}(null==t?void 0:t.hasType("array"))&&(null==t?void 0:t.items)&&(t=null==t?void 0:t.items);const r=null===(i=null==t?void 0:t.fields)||void 0===i?void 0:i.find((e=>e.name===n));o||null==r||r.expand(),t=null==r?void 0:r.schema}}deactivate(e){if(void 0!==e)for(e.deactivate();void 0!==e;)e.collapse(),e=e.parent}activateAndScroll(e,t,i,s=""){const[,n]=s.split(this.options.deepLinkPrefix),o=e&&this.getItemById(e.id)||e;this.activate(o,t,i,!1,n),this.scrollToActive(n?s:""),o&&o.items.length||this.closeSidebar()}scrollToActive(e){e?setTimeout((()=>this.scroll.scrollIntoViewBySelector(`[${SECTION_ATTR}="${escapeHTMLAttrChars(e)}"]`)),0):this.scroll.scrollIntoView(this.getElementAt(this.activeItemIdx))}dispose(){var e,t;null===(e=this._unsubscribe)||void 0===e||e.call(this),null===(t=this._hashUnsubscribe)||void 0===t||t.call(this)}}function withoutVersion(e){return e.split("/").slice(1).join("/")}function getParentSpecItem(e){for(;e;){if("spec"===e.type)return e;e=e.parent}}function getParentOfType(e,t){if(e&&e.parent)return e.parent.type===t?e.parent:getParentOfType(e.parent,t)}function getLeadingSectionItems(e){const t=[];for(const i of e.items){if("section"!==i.type)break;t.push(i)}return t}function normalizeItem(e,t,i,s,n){if(e.absoluteIdx=t,"none"!==i){const t=getParentOfType(e,"tag");if(e.parent&&t&&!("_id_normalized"in e)){if(s){const[i,s]=e.id.split("/"),n=withoutVersion(e.id);if("operation"===e.type&&!s.startsWith("operation"))return;e.id=i+"/"+withoutVersion(t.id)+"/"+n}else{if("operation"===e.type&&!e.id.startsWith("operation"))return;e.id=t.id+"/"+e.id}e._id_normalized=!0}}"group"!==e.type&&(e.href=n.linkForId(e.id))}__decorate([observable],ProMenu.prototype,"flatItems",void 0),__decorate([observable],ProMenu.prototype,"items",void 0),__decorate([observable],ProMenu.prototype,"activeRenderItemIdx",void 0),__decorate([observable.ref],ProMenu.prototype,"renderItems",void 0),__decorate([observable],ProMenu.prototype,"activeItemIdx",void 0),__decorate([observable],ProMenu.prototype,"sideBarOpened",void 0),__decorate([action],ProMenu.prototype,"toggleSidebar",null),__decorate([action],ProMenu.prototype,"closeSidebar",null),__decorate([action],ProMenu.prototype,"activateBase",null),__decorate([action],ProMenu.prototype,"activate",null),__decorate([action.bound],ProMenu.prototype,"activateAndScroll",null);
+var __decorate=this&&this.__decorate||function(e,t,i,s){var n,o=arguments.length,r=o<3?t:null===s?s=Object.getOwnPropertyDescriptor(t,i):s;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)r=Reflect.decorate(e,t,i,s);else for(var a=e.length-1;a>=0;a--)(n=e[a])&&(r=(o<3?n(r):o>3?n(t,i,r):n(t,i))||r);return o>3&&r&&Object.defineProperty(t,i,r),r};import{action,observable,makeObservable}from"mobx";import{flattenByProp,querySelector,escapeHTMLAttrChars}from"../utils";import{SECTION_ATTR,GROUP_DEPTH}from"../constants";import{history as historyInst}from"./history";import{VersionedSpecStore}from"./VersionedSpecStore";export class ProMenu{static updateOnHistory(e=historyInst.currentId,t){e&&t.scrollIntoViewBySelector(`[${SECTION_ATTR}="${escapeHTMLAttrChars(e)}"]`)}constructor(e,t,i,s){Object.defineProperty(this,"definition",{enumerable:!0,configurable:!0,writable:!0,value:e}),Object.defineProperty(this,"scroll",{enumerable:!0,configurable:!0,writable:!0,value:t}),Object.defineProperty(this,"options",{enumerable:!0,configurable:!0,writable:!0,value:i}),Object.defineProperty(this,"history",{enumerable:!0,configurable:!0,writable:!0,value:s}),Object.defineProperty(this,"flatItems",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),Object.defineProperty(this,"items",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),Object.defineProperty(this,"activeRenderItemIdx",{enumerable:!0,configurable:!0,writable:!0,value:-1}),Object.defineProperty(this,"renderItems",{enumerable:!0,configurable:!0,writable:!0,value:[]}),Object.defineProperty(this,"activeItemIdx",{enumerable:!0,configurable:!0,writable:!0,value:-1}),Object.defineProperty(this,"sideBarOpened",{enumerable:!0,configurable:!0,writable:!0,value:!1}),Object.defineProperty(this,"_unsubscribe",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),Object.defineProperty(this,"_hashUnsubscribe",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),Object.defineProperty(this,"getItemById",{enumerable:!0,configurable:!0,writable:!0,value:e=>this.flatItems.find((t=>t.id===e))}),Object.defineProperty(this,"initOnHistory",{enumerable:!0,configurable:!0,writable:!0,value:(e=this.history.currentId)=>{const[t]=e.split(this.options.deepLinkPrefix);if(!t)return;const i=this.flatItems.find((e=>e.id===t));i&&(this.activate(i,!1,!1,!1,e),i.active=!1)}}),Object.defineProperty(this,"updateOnHistory",{enumerable:!0,configurable:!0,writable:!0,value:(e=this.history.currentId)=>{const[t]=e.split(this.options.deepLinkPrefix);if(!t)return;const i=this.flatItems.find((e=>e.id===t));i?this.activateAndScroll(i,!1,void 0,e):(this.scroll.prevOffsetY=0,this.scroll.scrollIntoViewBySelector(`[${SECTION_ATTR}="${escapeHTMLAttrChars(t)}"]`))}}),Object.defineProperty(this,"updateVersionOnHistory",{enumerable:!0,configurable:!0,writable:!0,value:e=>{if(!("versionsInfo"in this.definition))return;const[t]=e.split("/");let i=this.definition.versionsInfo.findIndex((e=>e.id===t));i<0&&(i=this.definition.versionsInfo.findIndex((e=>e.isDefault))),this.definition.activeVersionIdx!==i&&(this.definition.changeVersion(i<0?0:i),this.updateItemsByVersionChange(!1,e))}}),Object.defineProperty(this,"updateOnScroll",{enumerable:!0,configurable:!0,writable:!0,value:e=>{const t=e?1:-1;let i=this.activeItemIdx;for(;(-1!==i||e)&&!(i>=this.flatItems.length-1&&e);){if(e){let e=!1;const t=this.flatItems[i+1];switch(this.options.pagination){case"section":e=t&&("spec"===t.type||"group"===t.type||"tag"===t.type);break;case"item":e="section"!==(null==t?void 0:t.type)}const s=this.getElementAt(i+1);if(-1===i&&"tag"===this.flatItems[0].type&&(e=!1),this.scroll.isElementBellow(s)||e)break}else{const e=this.flatItems[i]&&this.flatItems[i].type,t="section"===this.options.pagination&&("spec"===e||"group"===e||"tag"===e)||"item"===this.options.pagination&&"section"!==e,s=this.getElementAt(i);if(this.scroll.isElementAbove(s)||t)break}i+=t}const s=this.flatItems[i];"none"===this.options.pagination||"section"===this.options.pagination?s&&s.active||this.activate(s,!0,!0,!1):s&&"section"===s.type&&(s.active||this.activate(s,!0,!0,!1))}}),makeObservable(this),this.items=e.contentItems,this.flatItems=flattenByProp(this.items||[],"items"),this.flatItems.forEach(((e,t)=>e.absoluteIdx=t)),i.disableSidebar||this.subscribe(),this.flatItems.forEach(((e,t)=>normalizeItem(e,t,i.pagination,this.definition instanceof VersionedSpecStore,this.history))),this.renderItems=this.buildRenderItems(0),this.activeItemIdx=-1,this.activeRenderItemIdx=-1,this.definition instanceof VersionedSpecStore&&this.history.subscribe(this.updateVersionOnHistory)}subscribe(){this._unsubscribe=this.scroll.subscribe(this.updateOnScroll),this._hashUnsubscribe=this.history.subscribe(this.updateOnHistory)}toggleSidebar(){this.sideBarOpened=!this.sideBarOpened}closeSidebar(){this.sideBarOpened=!1}getElementAt(e){const t=this.flatItems[e];return t&&querySelector(`[${SECTION_ATTR}="${escapeHTMLAttrChars(t.id)}"]`)||null}getElementAtOrFirstChild(e){let t=this.flatItems[e];return t&&"group"===t.type&&(t=t.items[0]),t&&querySelector(`[${SECTION_ATTR}="${escapeHTMLAttrChars(t.id)}"]`)||null}get activeItem(){return this.flatItems[this.activeItemIdx]||void 0}updateItemsByVersionChange(e,t){if(!("versionsInfo"in this.definition))return;const i=this.activeItem&&this.activeItem.active?this.activeItem.absoluteIdx:-1;t=t&&withoutVersion(t)||this.activeItem&&this.activeItem.active&&withoutVersion(this.activeItem.id)||"",this.deactivate(this.activeItem),this.items=this.definition.contentItems,this.flatItems=flattenByProp(this.items||[],"items"),this.flatItems.forEach(((e,t)=>normalizeItem(e,t,this.options.pagination,this.definition instanceof VersionedSpecStore,this.history)));const s=t?(this.flatItems.find((e=>withoutVersion(e.id)===t))||{absoluteIdx:-1}).absoluteIdx:-1;if(-1!==s&&"none"!==this.options.pagination||(this.renderItems=this.buildRenderItems(0)),this.activeItemIdx=-1,-1!==s)this.activate(this.flatItems[s],e);else if(-1!==i)this.activateAndScroll(this.flatItems[0],e);else if(e){const e=this.definition.versionsInfo[this.definition.activeVersionIdx];if(!this.history.currentId&&e.isDefault)return;this.history.replace(e.id)}}buildRenderItems(e){if("none"===this.options.pagination)return this.items;let t=this.flatItems[e];if(t||(t=this.flatItems[0]),"spec"===t.type)return this.buildRenderItems(e+1);if("section"===t.type){const e=[],i=getParentOfType(t,"tag");if("section"===this.options.pagination&&i)return[i];if("item"===this.options.pagination&&i)return[Object.assign(Object.assign({},i),{items:getLeadingSectionItems(i)})];const s=getParentSpecItem(t),n=(null==s?void 0:s.items)||this.items;for(let t=0;t<n.length&&"section"===n[t].type;t++)e.push(n[t]);return e}switch(this.options.pagination){case"section":if(("operation"===t.type||"schema"===t.type)&&t.parent)return[t.parent];if("group"!==t.type)return[t];case"item":return"operation"===t.type||"schema"===t.type?[t]:[Object.assign(Object.assign({},t),{items:getLeadingSectionItems(t)})];default:return[]}}activateBase(e,t=!0,i=!1,s){var n,o,r,a,l;if((null===(n=this.activeItem)||void 0===n?void 0:n.id)===(null==e?void 0:e.id)&&!s)return t&&e&&this.history.replace(encodeURI(e.id),i),void(e&&!e.active&&e.activate());if(e&&"group"===e.type)return;if(this.deactivate(this.activeItem),!e)return void this.history.replace("",i);if(e.depth<=GROUP_DEPTH)return;this.activeItemIdx=e.absoluteIdx,t&&this.history.replace(encodeURI(e.id),i),e.activate(),e.expand();const c=new URLSearchParams(s),d="request"===c.get("t"),h="response"===c.get("t"),u=c.get("c"),p=c.get("ct"),f=c.get("in"),m=c.get("path"),v=(null==m?void 0:m.split(this.options.deepLinkSeparator))||[],b=e;if(f){let e=b.parameters;for(const t of v){const i=null==e?void 0:e.find((e=>e.name===t));null==i||i.expand(),e=null===(o=null==i?void 0:i.schema)||void 0===o?void 0:o.fields}}else if(d){const e=null===(r=b.requestBody)||void 0===r?void 0:r.content;null===(a=b.activateMimeName)||void 0===a||a.call(b,p||b.activeMimeName),setTimeout((()=>{var t;return this.activateField(v,null===(t=null==e?void 0:e.active)||void 0===t?void 0:t.schema)}),0)}else if(h){const e=b.responses.find((e=>e.code===u));(null==e?void 0:e.expanded)||null==e||e.expand(),null===(l=b.activateMimeName)||void 0===l||l.call(b,p||b.activeMimeName),setTimeout((()=>{var t,i;return this.activateField(v,null===(i=null===(t=null==e?void 0:e.content)||void 0===t?void 0:t.active)||void 0===i?void 0:i.schema)}),0)}}activate(e,t=!0,i=!1,s=!0,n){if("none"===this.options.pagination)return this.activateBase(e,t,i,n),void(!e&&this.definition instanceof VersionedSpecStore&&this.history.replace(this.definition.currentVersionId,!0));if("group"!==(null==e?void 0:e.type)){if(e&&"item"===this.options.pagination&&"tag"===e.type&&!e.description){if(e.expanded)return void e.collapse();e.expand(),e=this.flatItems[e.absoluteIdx+1]}if(this.activateBase(e,e&&t,i,n),this.activeRenderItemIdx=e?e.absoluteIdx:this.activeRenderItemIdx,this.activeRenderItemIdx>=0){const e=this.buildRenderItems(this.activeRenderItemIdx);e.some(((e,t)=>e.id!==this.renderItems[t].id))&&(this.renderItems=e),this.renderItems[0]&&(this.activeRenderItemIdx=this.renderItems[0].absoluteIdx)}s&&setTimeout((()=>this.scrollToActive())),!e&&this.definition instanceof VersionedSpecStore&&this.history.replace(this.definition.currentVersionId,!0)}}activateField(e,t){var i;for(let s=0;s<e.length-1;s++){const n=e[s],o=s===e.length-1;if((null==t?void 0:t.hasType("array"))&&(null==t?void 0:t.items)&&(t=null==t?void 0:t.items),null==t?void 0:t.oneOf){const e=Number(n);if(isNaN(e))return;null==t||t.activateOneOf(e),t=null==t?void 0:t.oneOf[e];continue}(null==t?void 0:t.hasType("array"))&&(null==t?void 0:t.items)&&(t=null==t?void 0:t.items);const r=null===(i=null==t?void 0:t.fields)||void 0===i?void 0:i.find((e=>e.name===n));o||null==r||r.expand(),t=null==r?void 0:r.schema}}deactivate(e){if(void 0!==e)for(e.deactivate();void 0!==e;)e.collapse(),e=e.parent}activateAndScroll(e,t,i,s=""){const[,n]=s.split(this.options.deepLinkPrefix),o=e&&this.getItemById(e.id)||e;this.activate(o,t,i,!1,n),this.scrollToActive(n?s:""),o&&o.items.length||this.closeSidebar()}scrollToActive(e){e?setTimeout((()=>this.scroll.scrollIntoViewBySelector(`[${SECTION_ATTR}="${escapeHTMLAttrChars(e)}"]`)),0):this.scroll.scrollIntoView(this.getElementAt(this.activeItemIdx))}dispose(){var e,t;null===(e=this._unsubscribe)||void 0===e||e.call(this),null===(t=this._hashUnsubscribe)||void 0===t||t.call(this)}}function withoutVersion(e){return e.split("/").slice(1).join("/")}function getParentSpecItem(e){for(;e;){if("spec"===e.type)return e;e=e.parent}}function getParentOfType(e,t){if(e&&e.parent)return e.parent.type===t?e.parent:getParentOfType(e.parent,t)}function getLeadingSectionItems(e){const t=[];for(const i of e.items){if("section"!==i.type)break;t.push(i)}return t}function normalizeItem(e,t,i,s,n){if(e.absoluteIdx=t,"none"!==i){const t=getParentOfType(e,"tag");if(e.parent&&t&&!("_id_normalized"in e)){if(s){const[i,s]=e.id.split("/"),n=withoutVersion(e.id);if("operation"===e.type&&!s.startsWith("operation"))return;e.id=i+"/"+withoutVersion(t.id)+"/"+n}else{if("operation"===e.type&&!e.id.startsWith("operation"))return;e.id=t.id+"/"+e.id}e._id_normalized=!0}}"group"!==e.type&&(e.href=n.linkForId(e.id))}__decorate([observable],ProMenu.prototype,"flatItems",void 0),__decorate([observable],ProMenu.prototype,"items",void 0),__decorate([observable],ProMenu.prototype,"activeRenderItemIdx",void 0),__decorate([observable.ref],ProMenu.prototype,"renderItems",void 0),__decorate([observable],ProMenu.prototype,"activeItemIdx",void 0),__decorate([observable],ProMenu.prototype,"sideBarOpened",void 0),__decorate([action],ProMenu.prototype,"toggleSidebar",null),__decorate([action],ProMenu.prototype,"closeSidebar",null),__decorate([action],ProMenu.prototype,"activateBase",null),__decorate([action],ProMenu.prototype,"activate",null),__decorate([action.bound],ProMenu.prototype,"activateAndScroll",null);
 //# sourceMappingURL=ProMenu.js.map