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

package/lib-esm/recoil/app.d.ts

@@ -0,0 +1,32 @@
+import type { CodeSampleConfig } from '../services';
+import type { OperationModel } from '../models';
+import { LayoutVariant } from '../constants';
+export type AppSessionStore = {
+    activeVersionIdx: number;
+    showRightPanelToggle: boolean;
+};
+export type AppLocalStore = {
+    layout: LayoutVariant;
+    activeSampleLanguage: CodeSampleConfig['lang'] | string;
+};
+export type AppStore = {
+    isSidebarOpened: boolean;
+    tryItOperation?: OperationModel;
+    activeMimeName: string;
+};
+export declare const appStore: import("recoil").RecoilState<AppStore>;
+export declare const isSidebarOpenedSelector: import("recoil").RecoilState<boolean>;
+export declare const activeMimeNameSelector: import("recoil").RecoilState<string>;
+export declare const tryItOperationSelector: import("recoil").RecoilState<OperationModel | undefined>;
+/**
+ * appLocalStore saved to local storage
+ */
+export declare const appLocalStore: import("recoil").RecoilState<AppLocalStore>;
+export declare const layoutSelector: import("recoil").RecoilState<LayoutVariant>;
+export declare const activeSampleLanguageSelector: import("recoil").RecoilState<string>;
+/**
+ * appSessionStore saved to session storage
+ */
+export declare const appSessionStore: import("recoil").RecoilState<AppSessionStore>;
+export declare const showRightPanelToggleSelector: import("recoil").RecoilState<boolean>;
+export declare const activeVersionIdxSelector: import("recoil").RecoilState<number>;

package/lib-esm/recoil/app.js

@@ -0,0 +1,2 @@
+import{atom,DefaultValue,selector}from"recoil";import{toLocalStorage,fromLocalStorage,toSessionStorage,fromSessionStorage,IS_BROWSER}from"../utils";import{LayoutVariant}from"../constants";export const appStore=atom({key:"appStore",default:{isSidebarOpened:!1,tryItOperation:void 0,activeMimeName:""}});export const isSidebarOpenedSelector=selector({key:"isSidebarOpened",get:({get:e})=>e(appStore).isSidebarOpened,set:({set:e,get:t},o)=>{const a=t(appStore);e(appStore,Object.assign(Object.assign({},a),{isSidebarOpened:o}))}});export const activeMimeNameSelector=selector({key:"activeMimeName",get:({get:e})=>e(appStore).activeMimeName,set:({set:e,get:t},o)=>{const a=t(appStore);e(appStore,Object.assign(Object.assign({},a),{activeMimeName:o}))}});export const tryItOperationSelector=selector({key:"tryItOperation",get:({get:e})=>e(appStore).tryItOperation,set:({set:e,get:t},o)=>{if(o instanceof DefaultValue)return;const a=t(appStore);e(appStore,Object.assign(Object.assign({},a),{tryItOperation:o}))}});export const appLocalStore=atom({key:"appLocalStore",default:{layout:LayoutVariant.THREE_PANEL,activeSampleLanguage:""},effects:[({onSet:e,setSelf:t})=>{const o=fromLocalStorage("appLocalStore");null!=o&&""!==o&&t(JSON.parse(o)),e((e=>{e instanceof DefaultValue?IS_BROWSER&&localStorage.removeItem("appLocalStore"):toLocalStorage("appLocalStore",JSON.stringify(e))}))}]});export const layoutSelector=selector({key:"layout",get:({get:e})=>e(appLocalStore).layout,set:({set:e,get:t},o=LayoutVariant.STACKED)=>{const a=t(appLocalStore),s=o===LayoutVariant.STACKED?LayoutVariant.THREE_PANEL:LayoutVariant.STACKED;e(appLocalStore,Object.assign(Object.assign({},a),{layout:s}))}});export const activeSampleLanguageSelector=selector({key:"activeSampleLanguage",get:({get:e})=>e(appLocalStore).activeSampleLanguage,set:({set:e,get:t},o)=>{const a=t(appLocalStore);e(appLocalStore,Object.assign(Object.assign({},a),{activeSampleLanguage:o}))}});export const appSessionStore=atom({key:"appSessionStore",default:{activeVersionIdx:0,showRightPanelToggle:!0},effects:[({onSet:e,setSelf:t})=>{const o=fromSessionStorage("appSessionStore");null!=o&&""!==o&&t(JSON.parse(o)),e((e=>{e instanceof DefaultValue?IS_BROWSER&&localStorage.removeItem("appSessionStore"):toSessionStorage("appSessionStore",JSON.stringify(e))}))}]});export const showRightPanelToggleSelector=selector({key:"showRightPanelToggle",get:({get:e})=>e(appSessionStore).showRightPanelToggle,set:({set:e,get:t},o)=>{const a=t(appSessionStore);e(appSessionStore,Object.assign(Object.assign({},a),{showRightPanelToggle:o}))}});export const activeVersionIdxSelector=selector({key:"activeVersionIdx",get:({get:e})=>e(appSessionStore).activeVersionIdx,set:({set:e,get:t},o)=>{const a=t(appSessionStore);e(appSessionStore,Object.assign(Object.assign({},a),{activeVersionIdx:o}))}});
+//# sourceMappingURL=app.js.map

package/lib-esm/recoil/operation.d.ts

@@ -0,0 +1,11 @@
+import type { Server } from '../types/server';
+type OperationStore = {
+    activeExampleName?: string;
+    activeOneOf: number;
+    activeServer?: Server;
+    requestValues: {
+        [field: string]: any;
+    };
+};
+export declare const operationStore: (param: string) => import("recoil").RecoilState<OperationStore>;
+export {};

package/lib-esm/recoil/operation.js

@@ -0,0 +1,2 @@
+import{atomFamily}from"recoil";export const operationStore=atomFamily({key:"operation",default:{activeExampleName:void 0,activeOneOf:0,activeServer:void 0,requestValues:{}}});
+//# sourceMappingURL=operation.js.map

package/lib-esm/recoil/store.d.ts

@@ -0,0 +1,19 @@
+import type { Options, OpenAPIParser } from '../services';
+export interface OpenAPIDefinitionVersion {
+    id: string;
+    title: string;
+    url?: string;
+    parser: OpenAPIParser;
+}
+export type GlobalStore = {
+    options: Options;
+    versions: Array<OpenAPIDefinitionVersion>;
+};
+export declare const globalStore: import("recoil").RecoilState<GlobalStore>;
+export type GlobalStoreSelector = {
+    parser: OpenAPIParser;
+    options: Options;
+    hasVersions: boolean;
+};
+export declare const globalStoreSelector: import("recoil").RecoilValueReadOnly<GlobalStoreSelector>;
+export declare const globalOptionsSelector: import("recoil").RecoilValueReadOnly<Options>;

package/lib-esm/recoil/store.js

@@ -0,0 +1,2 @@
+import{atom,selector}from"recoil";import{activeVersionIdxSelector}from"./app";export const globalStore=atom({key:"globalStore",default:{options:{},versions:[]}});export const globalStoreSelector=selector({key:"globalStoreSelector",get:({get:o})=>{var e;const{versions:t,options:r}=o(globalStore);return{parser:null===(e=t[o(activeVersionIdxSelector)||0])||void 0===e?void 0:e.parser,options:r,hasVersions:t.length>1}}});export const globalOptionsSelector=selector({key:"globalOptionsSelector",get:({get:o})=>o(globalStore).options});
+//# sourceMappingURL=store.js.map

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

@@ -40,7 +40,7 @@ export declare class OpenAPIParser {
      * @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;
+    mergeAllOf(schema: MergedOpenAPISchema, $ref: string | undefined, refsStack: string[], absolutePointer?: string): MergedOpenAPISchema;
     /**
      * Find all derived definitions among #/components/schemas from any of $refs
      * returns map of definition pointer to definition name

package/lib-esm/services/OpenAPIParser.js

@@ -1,2 +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}}
+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{normalizeOptions}from"./Options/normalizeOptions";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=normalizeOptions({})){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 o=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);o=e.refsStack,n=e.resolved}return o=pushRef(t,e.$ref),n=this.allowMergeRefs?this.mergeRefs(e,n,r):n,{resolved:n,refsStack:o}}return{resolved:e,refsStack:concatRefStacks(t,i)}}mergeRefs(e,t,r){const{$ref:i}=e,n=__rest(e,["$ref"]),o=Object.keys(n);if(0===o.length)return t;if(r&&o.some((e=>!["description","title","externalDocs","x-refsStack","x-parentRefs","readOnly","writeOnly"].includes(e)))){const e=n,{description:r,title:i,readOnly:o,writeOnly:s}=e;return{allOf:[{description:r,title:i,readOnly:o,writeOnly:s},t,__rest(e,["description","title","readOnly","writeOnly"])]}}return Object.assign(Object.assign({},t),n)}mergeAllOf(e,t,r,i=""){var n;if(e["x-circular-ref"])return e;if(void 0===(e=this.hoistOneOfs(e)).allOf)return Object.assign({absolutePointer:i},e);let o=Object.assign(Object.assign({},e),{"x-parentRefs":[],absolutePointer:JsonPointer.join(i,["allOf"]),allOf:void 0,title:e.title||getDefinitionName(t)});void 0!==o.properties&&"object"==typeof o.properties&&(o.properties=Object.assign({},o.properties)),void 0!==o.items&&"object"==typeof o.items&&(o.items=Object.assign({},o.items));const s=e.allOf.map(((e,t)=>{var n;const{resolved:s,refsStack:l}=this.deref(e,r,!0),f=e.$ref,a=f||JsonPointer.join(i,[String(t)]),c=this.mergeAllOf(s,f,l,a);if(!c["x-circular-ref"]||!c.allOf)return f&&(null===(n=o["x-parentRefs"])||void 0===n||n.push(...c["x-parentRefs"]||[],f)),{$ref:f,refsStack:pushRef(l,f),schema:c,absolutePointer:a}})).filter((e=>void 0!==e));for(const[e,{schema:r,refsStack:i,absolutePointer:l}]of s.entries()){const{type:s,enum:f,properties:a,items:c,required:p,title:d,description:O,readOnly:u,writeOnly:y,oneOf:m,anyOf:b,"x-circular-ref":h}=r,v=__rest(r,["type","enum","properties","items","required","title","description","readOnly","writeOnly","oneOf","anyOf","x-circular-ref"]);if(o.type!==s&&void 0!==o.type&&void 0!==s&&console.warn(`Incompatible types in allOf at "${t}": "${o.type}" and "${s}"`),void 0!==s&&(Array.isArray(s)&&Array.isArray(o.type)?o.type=[...s,...o.type]:o.type=s),void 0!==f&&(Array.isArray(f)&&Array.isArray(o.enum)?o.enum=Array.from(new Set([...f,...o.enum])):o.enum=f),void 0!==a&&"object"==typeof a){o.properties=o.properties||{};for(const r in a){const s=concatRefStacks(i,null===(n=a[r])||void 0===n?void 0:n["x-refsStack"]);if(o.properties[r]){if(!h){const i=this.mergeAllOf({allOf:[o.properties[r],a[r]],"x-refsStack":s},t+"/properties/"+r,s,JsonPointer.join(l,["allOf",String(e),"properties",r]));o.properties[r]=i}}else o.properties[r]=Object.assign(Object.assign({},a[r]),{absolutePointer:JsonPointer.join(l,["properties",r]),"x-refsStack":s})}}if(void 0!==c&&!h){const e="boolean"==typeof o.items?{}:Object.assign({},o.items),n="boolean"==typeof r.items?{}:Object.assign({},r.items);o.items=this.mergeAllOf({allOf:[e,n]},t+"/items",i)}void 0!==m&&(o.oneOf=m),void 0!==b&&(o.anyOf=b),void 0!==p&&(o.required=[...o.required||[],...p]),o=Object.assign(Object.assign(Object.assign({},o),{title:o.title||d,description:o.description||O,readOnly:void 0!==o.readOnly?o.readOnly:u,writeOnly:void 0!==o.writeOnly?o.writeOnly:y,"x-circular-ref":o["x-circular-ref"]||h}),v)}return o}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/index.d.ts

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

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

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

package/lib-esm/services/Options/{NormalizedOptions.d.ts → normalizeOptions.d.ts}

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

package/lib-esm/services/Options/normalizeOptions.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,isUndefined}from"../../utils";import{normalizePath}from"../utils";import{addTrailingSlash,normalizeExpandResponses,normalizePayloadSampleIdx,normalizeShowExtensions,normalizeScrollYOffset}from"./helpers";import{Pagination,SideNavStyle}from"../types";export function normalizeOptions(e,a){var o,n,l,i,r,s,t,d,u,g,p,h;e=Object.assign(Object.assign(Object.assign({},a),e),{allowedMdComponents:Object.assign(Object.assign({},null==e?void 0:e.allowedMdComponents),{components:Object.assign(Object.assign({},null===(o=null==a?void 0:a.allowedMdComponents)||void 0===o?void 0:o.components),null===(n=null==e?void 0:e.allowedMdComponents)||void 0===n?void 0:n.components),tags:Object.assign(Object.assign({},null===(l=null==a?void 0:a.allowedMdComponents)||void 0===l?void 0:l.tags),null===(i=null==e?void 0:e.allowedMdComponents)||void 0===i?void 0:i.tags),nodes:Object.assign(Object.assign(Object.assign({},null===(r=null==a?void 0:a.allowedMdComponents)||void 0===r?void 0:r.nodes),null===(s=null==e?void 0:e.allowedMdComponents)||void 0===s?void 0:s.nodes),{heading:(null===(d=null===(t=null==a?void 0:a.allowedMdComponents)||void 0===t?void 0:t.nodes)||void 0===d?void 0:d.heading)||(null===(u=null==e?void 0:e.allowedMdComponents)||void 0===u?void 0:u.nodes.heading)})})});const m=Array.isArray(e.ignoreNamedSchemas)?e.ignoreNamedSchemas:null===(g=e.ignoreNamedSchemas)||void 0===g?void 0:g.split(",").map((e=>e.trim())),c={downloadDefinitionUrl:e.downloadDefinitionUrl,schemaDefinitionsTagName:e.schemaDefinitionsTagName,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===(p=e.mockServer)||void 0===p?void 0:p.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:isUndefined(e.enableRouter)?"":e.routingBasePath&&normalizePath(e.routingBasePath)||"",schemaExpansionLevel:argValueToExpandLevel(e.schemaExpansionLevel),pagination:e.pagination||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===(h=e.showConsole)||void 0===h||h,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),skipBundleAndConvert:argValueToBoolean(e.skipBundleAndConvert),disablePaginationLoadingAnimation:argValueToBoolean(!!e.disablePaginationLoadingAnimation),disableErrorBoundary:argValueToBoolean(e.disableErrorBoundary),ignoreNamedSchemas:new Set(m),mediaQueries:generateMediaQueries((null==e?void 0:e.breakpoints)||{}),showAtBreakpoint:e.showAtBreakpoint,allowedMdComponents:null==e?void 0:e.allowedMdComponents,defaultSampleLanguage:e.defaultSampleLanguage||"",generateCodeSamples:e.generateCodeSamples||{languages:[]},layout:e.layout||LayoutVariant.THREE_PANEL,sideNavStyle:e.sideNavStyle||SideNavStyle.SummaryOnly,searchMode:e.searchMode||SearchMode.Default,sidebarLinks:e.sidebarLinks||{},events:e.events||{},hooks:e.hooks||getWindowReferenceOptions(WindowReferenceOptions.HOOKS)||{},unstable_tryItButtonOverride:e.unstable_tryItButtonOverride||null,unstable_externalCodeSamples:e.unstable_externalCodeSamples||[],markdownItemsPagination:e.markdownItemsPagination||"none"};return null!=e.showConsole&&console.warn('"showConsole" option is deprecated. Please, use "hideTryItPanel" instead.'),c.disablePaginationLoadingAnimation=!!e.disablePaginationLoadingAnimation||c.pagination===Pagination.None,c}
+//# sourceMappingURL=normalizeOptions.js.map

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

@@ -1,9 +1,11 @@
+import type React from 'react';
+import type { Schema, ConfigFunction } from '@markdoc/markdoc/dist/src/types';
 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 { ExternalLink, HooksConfig, MarkdownItemsPagination, Pagination, SideNavStyle, Unstable_ExternalCodeSample, PaginationType } from '../types';
 import type { Events } from '../../events';
 import type { MediaQueries } from '@redocly/theme';
-import type { OperationModel } from 'src/models/Operation';
+import type { OperationModel } from '../../models/types';
 import type { LabelsConfigRaw } from '../labels/types';
 export declare enum SearchMode {
     Default = "default",
@@ -89,8 +91,6 @@ export interface RawOptions {
     showRightPanelToggle?: boolean;
     layout?: LayoutVariant;
     defaultSampleLanguage?: Languages | string;
-    deepLinkSeparator?: string;
-    deepLinkPrefix?: string;
     disableDeepLinks?: boolean;
     sideNavStyle?: SideNavStyle;
     whiteLabel?: boolean;
@@ -100,15 +100,13 @@ export interface RawOptions {
     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;
+    pagination?: PaginationType;
     showNextButton?: boolean;
     routingStrategy?: 'hash' | 'browser';
     markdownItemsPagination?: MarkdownItemsPagination;
@@ -125,7 +123,15 @@ export interface RawOptions {
     mediaQueries?: MediaQueries;
     ignoreNamedSchemas?: string[] | string;
     breakpoints?: Omit<MediaQueries, 'print'>;
-    allowedMdComponents?: Record<string, MDXComponentMeta>;
+    allowedMdComponents?: {
+        tags: Record<string, Schema>;
+        nodes: Record<string, Schema>;
+        components: Record<string, React.ComponentType>;
+        variables?: Record<string, any>;
+        partials?: Record<string, any>;
+        functions?: Record<string, ConfigFunction>;
+    };
+    enableRouter?: boolean;
 }
 export interface DefaultOptions {
     mediaQueries?: MediaQueries;
@@ -135,7 +141,14 @@ export interface DefaultOptions {
         sidebar?: keyof Omit<MediaQueries, 'print'>;
         samplesPanel?: keyof Omit<MediaQueries, 'print'>;
     };
-    allowedMdComponents?: Record<string, MDXComponentMeta>;
+    allowedMdComponents?: {
+        tags: Record<string, Schema>;
+        nodes: Record<string, Schema>;
+        components: Record<string, React.ComponentType>;
+        variables?: Record<string, any>;
+        partials?: Record<string, any>;
+        functions?: Record<string, ConfigFunction>;
+    };
 }
 export interface Options {
     showAtBreakpoint: {
@@ -158,7 +171,7 @@ export interface Options {
     pathInMiddlePanel: boolean;
     untrustedDefinition: boolean;
     hideLoading: boolean;
-    hideDownloadButton: boolean;
+    hideDownloadButton: boolean | null;
     downloadDefinitionUrl?: string;
     disableSearch: boolean;
     searchAutoExpand: boolean;
@@ -192,7 +205,14 @@ export interface Options {
         position: 'first' | 'last' | 'replace' | 'off';
         description: string;
     };
-    allowedMdComponents: Record<string, MDXComponentMeta>;
+    allowedMdComponents?: {
+        tags: Record<string, Schema>;
+        nodes: Record<string, Schema>;
+        components: Record<string, React.ComponentType>;
+        variables?: Record<string, any>;
+        partials?: Record<string, any>;
+        functions?: Record<string, ConfigFunction>;
+    };
     labels?: LabelsConfigRaw;
     enumSkipQuotes: boolean;
     expandDefaultServerVariables: boolean;
@@ -221,8 +241,6 @@ export interface Options {
     showRightPanelToggle: boolean;
     layout: LayoutVariant;
     defaultSampleLanguage: Languages | string;
-    deepLinkSeparator: string;
-    deepLinkPrefix: string;
     disableDeepLinks: boolean;
     sideNavStyle: SideNavStyle;
     whiteLabel: boolean;
@@ -232,8 +250,6 @@ export interface Options {
     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?: {

package/lib-esm/services/code-samples/generator.js

@@ -1,2 +1,2 @@
-import{parse as parseQueryString,stringify as stringifyQueryString}from"query-string";import*as Sampler from"openapi-sampler";import merge from"deepmerge";import{toJS}from"mobx";import{deleteEmptyArrayItem,isArrayOfObjects,serializeParameterValue,getSecurityDetails,getParameterValue}from"../../utils";import{normalizeMimeType,arrayMergeStrategy}from"../utils";import{MediaTypes}from"../../constants";import{l}from"../labels";import{HTTPSnippet}from"./httpsnippet";import StringUtility from"./httpsnippet/helpers/string-utility";function mapOperationToHAR(e,{exampleName:t="",skipOptionalParameters:a=!1,withOAuth2Call:r=!1,spec:i,generatedPayloadSamplesMaxDepth:s=8,pathParams:n={},properties:o={}}){var l,u,p,d,c,m,h,y,v,f;const{securityHeaders:g,securityCookies:O,securityQueries:S,securityOAuth2ExtraCalls:T,basicAuth:C}=getSecurityData(null===(l=e.security)||void 0===l?void 0:l[0],r),b=null===(p=null===(u=e.requestBody)||void 0===u?void 0:u.content)||void 0===p?void 0:p.active,E={skipNonRequired:a,skipReadOnly:!0,maxSampleDepth:s},A={path:toJS(null===(d=null==e?void 0:e.requestValues)||void 0===d?void 0:d.path),cookie:toJS(null===(c=null==e?void 0:e.requestValues)||void 0===c?void 0:c.cookie),header:toJS(null===(m=null==e?void 0:e.requestValues)||void 0===m?void 0:m.header),query:toJS(null===(h=null==e?void 0:e.requestValues)||void 0===h?void 0:h.query),body:toJS(null===(y=null==e?void 0:e.requestValues)||void 0===y?void 0:y.body)};let _=!1;const P=e.parameters.filter((e=>"header"===e.in)).filter((e=>!(a&&!e.required))).map((e=>{var t;return{name:e.name,value:(null===(t=A.header)||void 0===t?void 0:t[e.name])||getParameterValue("header",e.name)||serializeParameterValue(e,Sampler.sample(e.schema.rawSchema,E,i))}})).map((e=>((null==b?void 0:b.name)&&"content-type"===e.name.toLowerCase()&&(_=!0,e.value=b.name),e))).concat(g);!_&&(null==b?void 0:b.name)&&P.unshift({name:"Content-Type",value:null==b?void 0:b.name});const R=e.parameters.filter((e=>"cookie"===e.in)).filter((e=>!(a&&!e.required))).map((e=>parseQueryString(serializeParameterValue(e,Sampler.sample(e.schema.rawSchema,E,i))))).reduce(((e,t)=>{var a;for(const[r,i]of Object.entries(t))e.push({name:r,value:String((null===(a=A.cookie)||void 0===a?void 0:a[r])||i)});return e}),[]).concat(O),w=e.parameters.filter((e=>"query"===e.in)).filter((e=>!(a&&!e.required))).map((e=>parseQueryString(serializeParameterValue(e,Sampler.sample(e.schema.rawSchema,E,i))))).reduce(((e,t)=>{var a,r,i;for(const[s,n]of Object.entries(t))e.push({name:s,value:isArrayOfObjects(null===(a=A.query)||void 0===a?void 0:a[s])&&JSON.stringify(deleteEmptyArrayItem(null===(r=A.query)||void 0===r?void 0:r[s]))||String((null===(i=A.query)||void 0===i?void 0:i[s])||n)});return e}),[]).concat(S),D=`${null===(v=e.activeServer)||void 0===v?void 0:v.url.replace(/\/$/,"")}/${e.path.replace(/^\//,"")}`,j=e.parameters.filter((e=>"path"===e.in)).reduce(((e,t)=>{var a;const{in:r,name:i}=t;return e[i]=(null===(a=A.path)||void 0===a?void 0:a[i])||n[i]||getParameterValue(r,i),e}),{}),k=null===(f=null==b?void 0:b.examples)||void 0===f?void 0:f[t],q=(null==b?void 0:b.examples)||{},[H]=Object.values(q),x=A.body||(null==k?void 0:k.value)||(null==H?void 0:H.value)||(null==b?void 0:b.schema)&&Sampler.sample(null==b?void 0:b.schema.rawSchema,E,i),M=null==b?void 0:b.name.toLowerCase();let N="",U=[];switch(normalizeMimeType(M)){case MediaTypes.JSON:N=JSON.stringify(getDataRequest(x,o));break;case MediaTypes.URL_ENCODED:case MediaTypes.MULTIPART:N=stringifyQueryString(getDataRequest(x,o)),U=objectToHarParams(getDataRequest(x,o));break;default:N=String(x||"")}const z=N?{mimeType:(null==b?void 0:b.name)||MediaTypes.OCTET_STREAM,text:N,params:U}:void 0,V=e.responses.map((e=>e.code));return{method:e.httpVerb,url:D,httpVersion:"HTTP/1.1",cookies:R,headers:P,queryString:w,postData:z,headersSize:-1,bodySize:-1,securityOAuth2ExtraCalls:T,basicAuth:C,pathParameters:j,serverVariables:e.activeServer.variables,allResponseCodes:V}}const defaultOptions={withImports:!0,withComments:!1},langToSnippetConfig={curl:{code:"shell",defaultTarget:"curl",defaultOptions:Object.assign(Object.assign({},defaultOptions),{short:!0})},JavaScript:{code:"javascript",defaultTarget:"fetch",defaultOptions:Object.assign(Object.assign({},defaultOptions),{withImports:!1})},"Node.js":{code:"node",defaultTarget:"fetch",defaultOptions:Object.assign({},defaultOptions)},Python:{code:"python",defaultTarget:"requests",defaultOptions:Object.assign({},defaultOptions)},"Java8+Apache":{code:"java8",defaultTarget:"apachehttp",defaultOptions:Object.assign({},defaultOptions)},Java:{code:"java",defaultTarget:"httpclient",defaultOptions:Object.assign({},defaultOptions)},"C#":{code:"csharp",defaultTarget:"httpclient",defaultOptions:Object.assign({},defaultOptions)},Go:{code:"go",defaultTarget:"http.DefaultClient",defaultOptions:Object.assign({},defaultOptions)},PHP:{code:"php",defaultTarget:"curl",defaultOptions:Object.assign({},defaultOptions)},Ruby:{code:"ruby",defaultTarget:"net::http",defaultOptions:Object.assign({},defaultOptions)},R:{code:"r",defaultTarget:"httr",defaultOptions:Object.assign({},defaultOptions)}};export function getCodeSample({lang:e,operation:t,exampleName:a,pathParams:r,properties:i,options:s={}}){try{const{skipOptionalParameters:n,withOAuth2Call:o,spec:l,generatedPayloadSamplesMaxDepth:u}=s,p=mapOperationToHAR(t,{exampleName:a,pathParams:r,properties:i,skipOptionalParameters:n,withOAuth2Call:o,spec:l,generatedPayloadSamplesMaxDepth:u}),d=new HTTPSnippet(p);return langToSnippetConfig[e]?d.convert(langToSnippetConfig[e].code,langToSnippetConfig[e].defaultTarget,Object.assign(Object.assign({},langToSnippetConfig[e].defaultOptions),s)):"Language is not supported."}catch(e){return console.error(e),"Failed to generate code sample."}}function getSecurityData(e,t){var a,r,i,s;const n={securityHeaders:[],securityCookies:[],securityQueries:[],securityOAuth2ExtraCalls:[],basicAuth:void 0};for(const o of(null==e?void 0:e.schemes)||[]){const e=getSecurityDetails(o.id);switch(o.type){case"openIdConnect":null===(a=n.securityHeaders)||void 0===a||a.push({name:"Authorization",value:"Bearer <YOUR_TOKEN_HERE>"});break;case"oauth2":{const a=e.token?`${e.token.token_type||"Bearer"} ${e.token.access_token}`:"Bearer <YOUR_TOKEN_HERE>";o.flows.clientCredentials&&t?n.securityOAuth2ExtraCalls.push(getOAuth2ClientCredsCallHar(o.flows.clientCredentials,o.scopes,e)):o.flows.password&&t&&n.securityOAuth2ExtraCalls.push(getOAuth2PasswordCallHar(o.flows.password,o.scopes,e)),null===(r=n.securityHeaders)||void 0===r||r.push({name:"Authorization",value:a});break}case"apiKey":{const t=e.raw||"YOUR_API_KEY_HERE";"header"===o.in&&(null===(i=n.securityHeaders)||void 0===i||i.push({name:o.name,value:t})),"cookie"===o.in&&n.securityCookies.push({name:o.name,value:t}),"query"===o.in&&n.securityQueries.push({name:o.name,value:t});break}case"http":"basic"===o.scheme?n.basicAuth={username:e.username||`<${StringUtility.toSnakeCase(l("tryItAuthBasicUsername"))}>`,password:e.password||`<${StringUtility.toSnakeCase(l("tryItAuthBasicPassword"))}>`}:null===(s=n.securityHeaders)||void 0===s||s.push({name:"Authorization",value:`${capitalizeFirst(o.scheme||"bearer")} <YOUR_${o.bearerFormat||"TOKEN"}_HERE>`})}}return n}function getOAuth2PasswordCallHar(e,t,a){return{method:"POST",url:e.tokenUrl,httpVersion:"HTTP/1.1",headers:[{name:"Content-Type",value:MediaTypes.URL_ENCODED},{name:"Accept",value:MediaTypes.JSON}],queryString:[],postData:{mimeType:MediaTypes.URL_ENCODED,text:"",params:[{name:"grant_type",value:"password"},{name:"client_id",value:a.client_id||"YOUR_CLIENT_ID"},{name:"client_secret",value:a.client_secret||"YOUR_CLIENT_SECRET"},{name:"username",value:a.username||"<username>"},{name:"password",value:a.password||"<password>"},t.length?{name:"scope",value:t.join(" ")}:void 0].filter(isDefined)},cookies:[],headersSize:-1,bodySize:-1,securityOAuth2ExtraCalls:[]}}function getOAuth2ClientCredsCallHar(e,t,a){return{method:"POST",url:e.tokenUrl,httpVersion:"HTTP/1.1",headers:[{name:"Content-Type",value:MediaTypes.URL_ENCODED},{name:"Accept",value:MediaTypes.JSON}],queryString:[],postData:{mimeType:MediaTypes.URL_ENCODED,text:"",params:[{name:"grant_type",value:"client_credentials"},{name:"client_id",value:a.client_id||"YOUR_CLIENT_ID"},{name:"client_secret",value:a.client_secret||"YOUR_CLIENT_SECRET"},t.length?{name:"scope",value:t.join(" ")}:void 0].filter(isDefined)},cookies:[],headersSize:-1,bodySize:-1,securityOAuth2ExtraCalls:[]}}function getDataRequest(e,t){if(e){if("object"==typeof e)return merge(e,t,{arrayMerge:arrayMergeStrategy});try{return merge(JSON.parse(e),t,{arrayMerge:arrayMergeStrategy})}catch(e){return!1}}return!1}function objectToHarParams(e){const t=[];for(const[a,r]of Object.entries(e))t.push({name:a,value:String(r)});return t}export function isDefined(e){return void 0!==e}export function capitalizeFirst(e){return e.charAt(0).toUpperCase()+e.slice(1)}
+import{parse as parseQueryString,stringify as stringifyQueryString}from"query-string";import*as Sampler from"openapi-sampler";import merge from"deepmerge";import{getRecoil}from"recoil-nexus";import{deleteEmptyArrayItem,isArrayOfObjects,serializeParameterValue,getSecurityDetails,getParameterValue}from"../../utils";import{normalizeMimeType,arrayMergeStrategy}from"../utils";import{MediaTypes}from"../../constants";import{l}from"../labels";import{HTTPSnippet}from"./httpsnippet";import StringUtility from"./httpsnippet/helpers/string-utility";import{getActiveMediaType}from"../../models";import{operationStore}from"../../recoil/operation";function mapOperationToHAR(e,{exampleName:t="",skipOptionalParameters:a=!1,withOAuth2Call:r=!1,spec:i,generatedPayloadSamplesMaxDepth:s=8,pathParams:n={},properties:o={}}){var l,u,p;const{securityHeaders:c,securityCookies:d,securityQueries:m,securityOAuth2ExtraCalls:h,basicAuth:y}=getSecurityData(null===(l=e.security)||void 0===l?void 0:l[0],r),{activeServer:g,requestValues:f}=getRecoil(operationStore(e.pointer)),v=(null===(u=null==e?void 0:e.requestBody)||void 0===u?void 0:u.content)&&getActiveMediaType(e.requestBody.content),O={skipNonRequired:a,skipReadOnly:!0,maxSampleDepth:s},T={path:null==f?void 0:f.path,cookie:null==f?void 0:f.cookie,header:null==f?void 0:f.header,query:null==f?void 0:f.query,body:null==f?void 0:f.body};let S=!1;const C=e.parameters.filter((e=>"header"===e.in)).filter((e=>!(a&&!e.required))).map((e=>{var t;return{name:e.name,value:(null===(t=T.header)||void 0===t?void 0:t[e.name])||getParameterValue("header",e.name)||serializeParameterValue(e,Sampler.sample(e.schema.rawSchema,O,i))}})).map((e=>((null==v?void 0:v.name)&&"content-type"===e.name.toLowerCase()&&(S=!0,e.value=v.name),e))).concat(c);!S&&(null==v?void 0:v.name)&&C.unshift({name:"Content-Type",value:null==v?void 0:v.name});const b=e.parameters.filter((e=>"cookie"===e.in)).filter((e=>!(a&&!e.required))).map((e=>parseQueryString(serializeParameterValue(e,Sampler.sample(e.schema.rawSchema,O,i))))).reduce(((e,t)=>{var a;for(const[r,i]of Object.entries(t))e.push({name:r,value:String((null===(a=T.cookie)||void 0===a?void 0:a[r])||i)});return e}),[]).concat(d),E=e.parameters.filter((e=>"query"===e.in)).filter((e=>!(a&&!e.required))).map((e=>parseQueryString(serializeParameterValue(e,Sampler.sample(e.schema.rawSchema,O,i))))).reduce(((e,t)=>{var a,r,i;for(const[s,n]of Object.entries(t))e.push({name:s,value:isArrayOfObjects(null===(a=T.query)||void 0===a?void 0:a[s])&&JSON.stringify(deleteEmptyArrayItem(null===(r=T.query)||void 0===r?void 0:r[s]))||String((null===(i=T.query)||void 0===i?void 0:i[s])||n)});return e}),[]).concat(m),A=`${null==g?void 0:g.url.replace(/\/$/,"")}/${e.path.replace(/^\//,"")}`,_=e.parameters.filter((e=>"path"===e.in)).reduce(((e,t)=>{var a;const{in:r,name:i}=t;return e[i]=(null===(a=T.path)||void 0===a?void 0:a[i])||n[i]||getParameterValue(r,i),e}),{}),P=null===(p=null==v?void 0:v.examples)||void 0===p?void 0:p[t],R=(null==v?void 0:v.examples)||{},[w]=Object.values(R),D=T.body||(null==P?void 0:P.value)||(null==w?void 0:w.value)||(null==v?void 0:v.schema)&&Sampler.sample(null==v?void 0:v.schema.rawSchema,O,i),j=null==v?void 0:v.name.toLowerCase();let k="",M=[];switch(normalizeMimeType(j)){case MediaTypes.JSON:k=JSON.stringify(getDataRequest(D,o));break;case MediaTypes.URL_ENCODED:case MediaTypes.MULTIPART:k=stringifyQueryString(getDataRequest(D,o)),M=objectToHarParams(getDataRequest(D,o));break;default:k=String(D||"")}const H=k?{mimeType:(null==v?void 0:v.name)||MediaTypes.OCTET_STREAM,text:k,params:M}:void 0,q=e.responses.map((e=>e.code));return{method:e.httpVerb,url:A,httpVersion:"HTTP/1.1",cookies:b,headers:C,queryString:E,postData:H,headersSize:-1,bodySize:-1,securityOAuth2ExtraCalls:h,basicAuth:y,pathParameters:_,serverVariables:(null==g?void 0:g.variables)||e.activeServer.variables,allResponseCodes:q}}const defaultOptions={withImports:!0,withComments:!1},langToSnippetConfig={curl:{code:"shell",defaultTarget:"curl",defaultOptions:Object.assign(Object.assign({},defaultOptions),{short:!0})},JavaScript:{code:"javascript",defaultTarget:"fetch",defaultOptions:Object.assign(Object.assign({},defaultOptions),{withImports:!1})},"Node.js":{code:"node",defaultTarget:"fetch",defaultOptions:Object.assign({},defaultOptions)},Python:{code:"python",defaultTarget:"requests",defaultOptions:Object.assign({},defaultOptions)},"Java8+Apache":{code:"java8",defaultTarget:"apachehttp",defaultOptions:Object.assign({},defaultOptions)},Java:{code:"java",defaultTarget:"httpclient",defaultOptions:Object.assign({},defaultOptions)},"C#":{code:"csharp",defaultTarget:"httpclient",defaultOptions:Object.assign({},defaultOptions)},Go:{code:"go",defaultTarget:"http.DefaultClient",defaultOptions:Object.assign({},defaultOptions)},PHP:{code:"php",defaultTarget:"curl",defaultOptions:Object.assign({},defaultOptions)},Ruby:{code:"ruby",defaultTarget:"net::http",defaultOptions:Object.assign({},defaultOptions)},R:{code:"r",defaultTarget:"httr",defaultOptions:Object.assign({},defaultOptions)}};export function getCodeSample({lang:e,operation:t,exampleName:a,pathParams:r,properties:i,options:s={}}){try{const{skipOptionalParameters:n,withOAuth2Call:o,spec:l,generatedPayloadSamplesMaxDepth:u}=s,p=mapOperationToHAR(t,{exampleName:a,pathParams:r,properties:i,skipOptionalParameters:n,withOAuth2Call:o,spec:l,generatedPayloadSamplesMaxDepth:u}),c=new HTTPSnippet(p);return langToSnippetConfig[e]?c.convert(langToSnippetConfig[e].code,langToSnippetConfig[e].defaultTarget,Object.assign(Object.assign({},langToSnippetConfig[e].defaultOptions),s)):"Language is not supported."}catch(e){return console.error(e),"Failed to generate code sample."}}function getSecurityData(e,t){var a,r,i,s;const n={securityHeaders:[],securityCookies:[],securityQueries:[],securityOAuth2ExtraCalls:[],basicAuth:void 0};for(const o of(null==e?void 0:e.schemes)||[]){const e=getSecurityDetails(o.id);switch(o.type){case"openIdConnect":null===(a=n.securityHeaders)||void 0===a||a.push({name:"Authorization",value:"Bearer <YOUR_TOKEN_HERE>"});break;case"oauth2":{const a=e.token?`${e.token.token_type||"Bearer"} ${e.token.access_token}`:"Bearer <YOUR_TOKEN_HERE>";o.flows.clientCredentials&&t?n.securityOAuth2ExtraCalls.push(getOAuth2ClientCredsCallHar(o.flows.clientCredentials,o.scopes,e)):o.flows.password&&t&&n.securityOAuth2ExtraCalls.push(getOAuth2PasswordCallHar(o.flows.password,o.scopes,e)),null===(r=n.securityHeaders)||void 0===r||r.push({name:"Authorization",value:a});break}case"apiKey":{const t=e.raw||"YOUR_API_KEY_HERE";"header"===o.in&&(null===(i=n.securityHeaders)||void 0===i||i.push({name:o.name,value:t})),"cookie"===o.in&&n.securityCookies.push({name:o.name,value:t}),"query"===o.in&&n.securityQueries.push({name:o.name,value:t});break}case"http":"basic"===o.scheme?n.basicAuth={username:e.username||`<${StringUtility.toSnakeCase(l("tryItAuthBasicUsername"))}>`,password:e.password||`<${StringUtility.toSnakeCase(l("tryItAuthBasicPassword"))}>`}:null===(s=n.securityHeaders)||void 0===s||s.push({name:"Authorization",value:`${capitalizeFirst(o.scheme||"bearer")} <YOUR_${o.bearerFormat||"TOKEN"}_HERE>`})}}return n}function getOAuth2PasswordCallHar(e,t,a){return{method:"POST",url:e.tokenUrl,httpVersion:"HTTP/1.1",headers:[{name:"Content-Type",value:MediaTypes.URL_ENCODED},{name:"Accept",value:MediaTypes.JSON}],queryString:[],postData:{mimeType:MediaTypes.URL_ENCODED,text:"",params:[{name:"grant_type",value:"password"},{name:"client_id",value:a.client_id||"YOUR_CLIENT_ID"},{name:"client_secret",value:a.client_secret||"YOUR_CLIENT_SECRET"},{name:"username",value:a.username||"<username>"},{name:"password",value:a.password||"<password>"},t.length?{name:"scope",value:t.join(" ")}:void 0].filter(isDefined)},cookies:[],headersSize:-1,bodySize:-1,securityOAuth2ExtraCalls:[]}}function getOAuth2ClientCredsCallHar(e,t,a){return{method:"POST",url:e.tokenUrl,httpVersion:"HTTP/1.1",headers:[{name:"Content-Type",value:MediaTypes.URL_ENCODED},{name:"Accept",value:MediaTypes.JSON}],queryString:[],postData:{mimeType:MediaTypes.URL_ENCODED,text:"",params:[{name:"grant_type",value:"client_credentials"},{name:"client_id",value:a.client_id||"YOUR_CLIENT_ID"},{name:"client_secret",value:a.client_secret||"YOUR_CLIENT_SECRET"},t.length?{name:"scope",value:t.join(" ")}:void 0].filter(isDefined)},cookies:[],headersSize:-1,bodySize:-1,securityOAuth2ExtraCalls:[]}}function getDataRequest(e,t){if(e){if("object"==typeof e)return merge(e,t,{arrayMerge:arrayMergeStrategy});try{return merge(JSON.parse(e),t,{arrayMerge:arrayMergeStrategy})}catch(e){return!1}}return!1}function objectToHarParams(e){const t=[];for(const[a,r]of Object.entries(e))t.push({name:a,value:String(r)});return t}export function isDefined(e){return void 0!==e}export function capitalizeFirst(e){return e.charAt(0).toUpperCase()+e.slice(1)}
 //# sourceMappingURL=generator.js.map

package/lib-esm/services/code-samples/httpsnippet/targets/index.d.ts

@@ -7,7 +7,7 @@ declare const targets: {
             default: string;
         };
         fetch: import("..").LanguageHandler<(import("../..").BasicLanguageOptions & {
-            credentials?: "omit" | "same-origin" | "include" | undefined;
+            credentials?: "same-origin" | "omit" | "include" | undefined;
         }) | undefined>;
     };
     node: {

package/lib-esm/services/code-samples/httpsnippet/targets/javascript/index.d.ts

@@ -6,7 +6,7 @@ declare const _default: {
         default: string;
     };
     fetch: import("../..").LanguageHandler<(import("../../..").BasicLanguageOptions & {
-        credentials?: "omit" | "same-origin" | "include" | undefined;
+        credentials?: "same-origin" | "omit" | "include" | undefined;
     }) | undefined>;
 };
 export default _default;

package/lib-esm/services/code-samples/httpsnippet/targets/shell/curl.d.ts

@@ -1,6 +1,6 @@
 import type { LanguageHandler } from '../..';
-import type { cURULCodeSampleConfig } from '../../../types';
-declare const handler: LanguageHandler<cURULCodeSampleConfig['options']>;
+import type { CurlCodeSampleConfig } from '../../../types';
+declare const handler: LanguageHandler<CurlCodeSampleConfig['options']>;
 export declare const info: {
     key: string;
     title: string;

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

@@ -9,7 +9,7 @@ interface CodeSampleBasicConfig {
     label?: string;
     options?: BasicLanguageOptions;
 }
-export interface cURULCodeSampleConfig extends CodeSampleBasicConfig {
+export interface CurlCodeSampleConfig extends CodeSampleBasicConfig {
     lang: 'curl';
     options?: BasicLanguageOptions & {
         binary?: boolean;
@@ -48,7 +48,7 @@ export interface RubyCodeSampleConfig extends CodeSampleBasicConfig {
 export interface RCodeSampleConfig extends CodeSampleBasicConfig {
     lang: 'R';
 }
-export type CodeSampleConfig = cURULCodeSampleConfig | JavaScriptCodeSampleConfig | NodeJsCodeSampleConfig | PythonCodeSampleConfig | Java8CodeSampleConfig | JavaCodeSampleConfig | CSharpCodeSampleConfig | PHPCodeSampleConfig | GoCodeSampleConfig | RubyCodeSampleConfig | RCodeSampleConfig;
+export type CodeSampleConfig = CurlCodeSampleConfig | JavaScriptCodeSampleConfig | NodeJsCodeSampleConfig | PythonCodeSampleConfig | Java8CodeSampleConfig | JavaCodeSampleConfig | CSharpCodeSampleConfig | PHPCodeSampleConfig | GoCodeSampleConfig | RubyCodeSampleConfig | RCodeSampleConfig;
 /**
  * Code Samples Generator rules
  * - Reference docs always displays all user custom x-code-samples

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

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

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

@@ -1,2 +1,2 @@
-import{stringify as stringifyQueryString}from"query-string";export function isSameHash(e,i){return e===i||"#"+e===i||e==="#"+i}function getContentTypeName(e){var i,n,o,t,d,l,r,s,p,v,u,a,c,y,f;if(!e.in)return"request"===e.deps.type&&(null===(o=null===(n=null===(i=e.deps.operation)||void 0===i?void 0:i.requestBody)||void 0===n?void 0:n.content)||void 0===o?void 0:o.mediaTypes)?(null===(l=null===(d=null===(t=e.deps.operation)||void 0===t?void 0:t.requestBody)||void 0===d?void 0:d.content)||void 0===l?void 0:l.mediaTypes.length)>1?null===(p=null===(s=null===(r=e.deps.operation)||void 0===r?void 0:r.requestBody)||void 0===s?void 0:s.content)||void 0===p?void 0:p.active.name:void 0:"response"===e.deps.type&&(null===(u=null===(v=e.deps.response)||void 0===v?void 0:v.content)||void 0===u?void 0:u.mediaTypes)&&(null===(c=null===(a=e.deps.response)||void 0===a?void 0:a.content)||void 0===c?void 0:c.mediaTypes.length)>1?null===(f=null===(y=e.deps.response)||void 0===y?void 0:y.content)||void 0===f?void 0:f.active.name:void 0}export function constructFieldDeepFragment(e){var i,n,o,t;if(!e)return null;if(!e.deps.operation)return null;if(null===(i=e.deps.operation)||void 0===i?void 0:i.isCallback)return null;const d={t:e.deps.type,in:e.in||e.deps.in,c:"response"===e.deps.type?null===(n=e.deps.response)||void 0===n?void 0:n.code:void 0,cb:(null===(o=e.deps.operation)||void 0===o?void 0:o.isCallback)?null===(t=e.deps.operation)||void 0===t?void 0:t.id:void 0,ct:getContentTypeName(e),path:e.fieldFullPath};return stringifyQueryString(d,{encode:!1})}export function joinWithSeparator(e="",i="",n="/"){return e.endsWith(n)&&(e=e.slice(0,-n.length)),i.startsWith(n)&&(i=i.slice(n.length)),e&&i?e+n+i:e+i}
+import{stringify as stringifyQueryString}from"query-string";import{getActiveMediaType}from"../../models";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,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===(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===(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 stringifyQueryString(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}
 //# sourceMappingURL=helpers.js.map

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

@@ -1,4 +1 @@
-export * from './PushStateHistoryService';
-export * from './ProHashHistoryService';
-export * from './FakeHistoryService';
-export { HistoryService, history } from './HistoryService';
+export * from './helpers';

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

@@ -1,2 +1,2 @@
-export*from"./PushStateHistoryService";export*from"./ProHashHistoryService";export*from"./FakeHistoryService";export{HistoryService,history}from"./HistoryService";
+export*from"./helpers";
 //# sourceMappingURL=index.js.map

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

@@ -1,17 +1,12 @@
-export * from './ProStore';
 export * from './history';
 export * from './code-samples';
 export * from './types';
 export * from './labels';
 export { OpenAPIParser } from './OpenAPIParser';
-export { MarkdownRenderer } from './MarkdownRenderer';
-export { ScrollService } from './ScrollService';
-export { SpecStore } from './SpecStore';
-export { MenuBuilder } from './MenuBuilder';
-export { ProMenu } from './ProMenu';
-export type { ExtendedMenuItem } from './ProMenu';
+export { buildContentItems } from './menu';
 export { SearchStore } from './search';
 export type { SearchResultMeta } from './search';
 export { MarkerService } from './MarkerService';
 export * from './types';
 export * from './Options';
+export { deepClone } from './utils';

package/lib-esm/services/index.js

@@ -1,2 +1,2 @@
-export*from"./ProStore";export*from"./history";export*from"./code-samples";export*from"./types";export*from"./labels";export{OpenAPIParser}from"./OpenAPIParser";export{MarkdownRenderer}from"./MarkdownRenderer";export{ScrollService}from"./ScrollService";export{SpecStore}from"./SpecStore";export{MenuBuilder}from"./MenuBuilder";export{ProMenu}from"./ProMenu";export{SearchStore}from"./search";export{MarkerService}from"./MarkerService";export*from"./types";export*from"./Options";
+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";
 //# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,2 @@
+import{getTagGroupsItems,getTagsItems,getTagsWithOperations}from"./tags";import{addMarkdownItems}from"./markdown";import{flattenByProp}from"../../utils";export function buildMenuStructure(t,e){const{definition:n}=t,o=[],i=[...n.tags||[]]||[];!i.find((t=>(null==t?void 0:t.name)===e.schemaDefinitionsTagName))&&e.schemaDefinitionsTagName&&i.push({name:e.schemaDefinitionsTagName});const s=getTagsWithOperations(t,i),a=n["x-tagGroups"];return o.push(...addMarkdownItems(n.info.description||"",void 0,1,e.markdownHeadingsAnchorLevel,e.pagination)),a&&a.length>0?o.push(...getTagGroupsItems(t,void 0,a,s,e)):o.push(...getTagsItems(t,s,void 0,void 0,e)),o}export function buildContentItems(t,e){const n=buildMenuStructure(t,e);return{contentItems:n,flatItems:flattenByProp(n||[],"items")}}
+//# sourceMappingURL=builder.js.map

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

@@ -0,0 +1,6 @@
+import type { IMenuItem, ExtendedMenuItem } from '../types';
+export declare function getItemById(itemId: string, flatItems: (ExtendedMenuItem & IMenuItem)[]): (ExtendedMenuItem & IMenuItem) | undefined;
+export declare function withoutVersion(path: string): string;
+export declare function getParentSpecItem(item: any): any;
+export declare function getParentOfType(item: ExtendedMenuItem, type: string): any;
+export declare function getLeadingSectionItems(item: ExtendedMenuItem): IMenuItem[];

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

@@ -0,0 +1,2 @@
+export function getItemById(t,e){return e.find((({id:e})=>e===t))}export function withoutVersion(t){return t.split("/").slice(1).join("/")}export function getParentSpecItem(t){for(;t;){if("spec"===t.type)return t;t=t.parent}}export function getParentOfType(t,e){if(t&&t.parent)return t.parent.type===e?t.parent:getParentOfType(t.parent,e)}export function getLeadingSectionItems(t){const e=[];for(const n of t.items){if("section"!==n.type)break;e.push(n)}return e}
+//# sourceMappingURL=helpers.js.map

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

@@ -0,0 +1 @@
+export { buildContentItems } from './builder';

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

@@ -0,0 +1,2 @@
+export{buildContentItems}from"./builder";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,11 @@
+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[];

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

@@ -0,0 +1,2 @@
+import{parse,Ast}from"@markdoc/markdoc";import{Pagination}from"../types";import{getGroup}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(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=getGroup("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}
+//# sourceMappingURL=markdown.js.map

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

@@ -0,0 +1,13 @@
+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;

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

@@ -0,0 +1,2 @@
+import{alphabeticallyByProp,getOperationId,getOperationName}from"../../utils";import{Pagination}from"../types";import{normalizePath}from"../utils";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,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?normalizePath(o?joinWithSeparator(o.id,e,"#"):`#${e}`):"section"===t?o?`#${e}`:normalizePath(`#${e}`):normalizePath(e);default:return""}}
+//# sourceMappingURL=operation.js.map

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

@@ -0,0 +1,27 @@
+import type { OpenAPIParser } from '../OpenAPIParser';
+import type { ContentItemModel, GroupModel } from '../../models';
+import type { TagGroup, TagsInfoMap } from '../types';
+import type { Options } from '../Options';
+import type { OpenAPITag } from '../../types';
+/**
+ * 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
+ */
+export declare function getTagsItems(parser: OpenAPIParser, tagsMap: TagsInfoMap, parent: GroupModel | undefined, group: TagGroup | undefined, 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
+ */
+export declare function getTagGroupsItems(parser: OpenAPIParser, parent: GroupModel | undefined, groups: TagGroup[], tags: TagsInfoMap, options: Options): GroupModel[];
+/**
+ * collects tags and maps each tag to list of operations belonging to this tag
+ */
+export declare function getTagsWithOperations(parser: OpenAPIParser, explicitTags: OpenAPITag[]): TagsInfoMap;

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

@@ -0,0 +1,2 @@
+import{getGroup}from"../../models";import{GROUP_DEPTH}from"../../constants";import{alphabeticallyByProp,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=getGroup("tag",t,{pagination:a.pagination,markdownHeadingsAnchorLevel:a.markdownHeadingsAnchorLevel},n);if(o.depth=GROUP_DEPTH+1,""===t.name){const e=[...addMarkdownItems(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(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=getGroup("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=getGroup("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]),httpVerb:t,pathParameters:s.parameters||[],pathServers:s.servers,isWebhook:!!o}))}}}}
+//# sourceMappingURL=tags.js.map

package/lib-esm/services/search/DeepSearchStore.d.ts

@@ -1,7 +1,7 @@
 import type { SearchResult, SearchResultMeta } from './types';
-import type { OperationModel } from '../../models';
+import type { OperationMenuItem } from '../../models';
 import type { IMenuItem } from '../types';
-import type { Options } from '../Options/types';
+import type { Options } from '../Options';
 import { SearchStore } from './SearchStore';
 export declare class DeepSearchStore extends SearchStore<SearchResultMeta> {
     operationTitleBoost: number;
@@ -10,7 +10,7 @@ export declare class DeepSearchStore extends SearchStore<SearchResultMeta> {
     pathOnly: boolean;
     searchMaxDepth: number;
     constructor(options: Options);
-    indexItems(groups: Array<IMenuItem | OperationModel>): void;
+    indexItems(groups: Array<IMenuItem | OperationMenuItem>): void;
     private indexSchema;
     add(title: string, body: string, meta?: SearchResultMeta): void;
     search<T = SearchResultMeta>(q: string): Promise<Array<SearchResult<T>>>;