@redocly/api-docs 0.0.2

package/lib/utils/deep-link.d.ts

@@ -0,0 +1,146 @@
+import type { RouteIndex } from './routing.js';
+/**
+ * Serialize key-value params into a query-string fragment.
+ * Matches openapi-docs `constructFieldDeepFragment` output:
+ * keys in insertion order, no encoding, undefined values omitted.
+ */
+export declare function serializeFieldParams(params: Record<string, string | undefined>): string;
+/**
+ * Build a deep-link path+hash string for a given operation slug and suffix.
+ * Semantics match openapi-docs `makeDeepLink`:
+ *   `/{operationId}#{operationId}/{suffix}`  (all lowercased, backslashes encoded).
+ *
+ * `operationId` must be a basePath-free slug (e.g. `cafe/placeorder`) — a
+ * leading slash is stripped defensively so the output is well-formed even
+ * if a caller hands in `/cafe/placeorder`.
+ */
+export declare function makeDeepLink(operationId: string, suffix: string): string;
+/**
+ * Build a full deep-link URL by combining routing base, operation id, and suffix.
+ */
+export declare function buildDeepLinkUrl(routingBasePath: string, operationId: string, suffix: string): string;
+/**
+ * Extract element id from a URL hash (strip `#`, decode, lowercase).
+ * The returned value can be passed to `document.getElementById`.
+ */
+export declare function hashToElementId(hash: string): string;
+/**
+ * Extract the hash fragment from a deep link URL for use as an element id.
+ * Given `/petstore/pet/getpetbyid#pet/getpetbyid/request`, returns `pet/getpetbyid/request`.
+ * Returns empty string if no hash is present.
+ */
+export declare function deepLinkToId(deepLink: string): string;
+interface OpenApiFieldParams {
+    /** "request" | "response" */
+    t?: string;
+    /** "query" | "header" | "path" | "cookie" */
+    in?: string;
+    /** Response status code (responses only) */
+    c?: string;
+    /** Callback id (callbacks only) */
+    cb?: string;
+    /** Content-type name (when multiple media types) */
+    ct?: string;
+    /** Field deep path */
+    path?: string;
+}
+/**
+ * Build a suffix for an OpenAPI request/response/callback field.
+ * Same shape as openapi-docs `constructFieldDeepFragment`.
+ */
+export declare function buildOpenApiFieldSuffix(params: OpenApiFieldParams): string;
+/**
+ * Build section-level suffix for OpenAPI requests/responses.
+ *
+ * Examples:
+ *   buildOpenApiSectionSuffix('request')                        -> "request"
+ *   buildOpenApiSectionSuffix('request', 'query')                -> "request/query"
+ *   buildOpenApiSectionSuffix('response', undefined, '200')      -> "response&c=200"
+ *   buildOpenApiSectionSuffix('response', 'body', '200')         -> "response&c=200/body"
+ *   buildOpenApiSectionSuffix('response', 'headers', '200')      -> "response&c=200/headers"
+ *   buildOpenApiSectionSuffix('callbacks')                       -> "callbacks"
+ *   buildOpenApiSectionSuffix('callbacks', 'myCallback')          -> "callbacks/myCallback"
+ */
+export declare function buildOpenApiSectionSuffix(section: string, subSection?: string, responseCode?: string): string;
+export interface AsyncApiSuffixParams {
+    /** "send" | "receive" | "parameters" | "messages" */
+    section: string;
+    /** Message key/name (when linking to a specific message) */
+    messageKey?: string;
+    /** Sub-section: "headers" | "payload" */
+    subsection?: string;
+}
+/**
+ * Build a suffix for AsyncAPI sections.
+ *
+ * Examples:
+ *   { section: 'send' }                                    -> "send"
+ *   { section: 'parameters' }                              -> "parameters"
+ *   { section: 'messages', messageKey: 'userSignedUp' }    -> "messages&m=userSignedUp"
+ *   { section: 'messages', messageKey: 'msg1', subsection: 'headers' }
+ *       -> "messages&m=msg1&t=headers"
+ *   { section: 'messages', messageKey: 'msg1', subsection: 'payload' }
+ *       -> "messages&m=msg1&t=payload"
+ */
+export declare function buildAsyncApiSuffix(params: AsyncApiSuffixParams): string;
+export interface GraphqlSuffixParams {
+    /** Section type: "field" | "argument" | "return-type" | "possible-types" |
+     *  "implements" | "directive" | "enum-value" | "scalar" */
+    t: string;
+    /** Stable path: e.g. "Query.hero", "User.friends" */
+    path?: string;
+    /** Argument name (when t=argument or nested under a field) */
+    arg?: string;
+    /** Return-type anchor ("1" or nested path when expanded) */
+    rt?: string;
+}
+/**
+ * Build a suffix for GraphQL deep links.
+ *
+ * Examples:
+ *   { t: 'field', path: 'Query.hero' }           -> "t=field&path=Query.hero"
+ *   { t: 'argument', path: 'Query.hero', arg: 'id' }
+ *       -> "t=argument&path=Query.hero&arg=id"
+ *   { t: 'return-type', path: 'Query.hero', rt: '1' }
+ *       -> "t=return-type&path=Query.hero&rt=1"
+ */
+export declare function buildGraphqlSuffix(params: GraphqlSuffixParams): string;
+export declare function isGraphqlDeepLinkAncestor(hash: string, path: string): boolean;
+/**
+ * Convert a deep-link URL to an element id, returning `undefined` for empty/missing links.
+ * Shorthand for the common pattern `id={url ? deepLinkToId(url) : undefined}`.
+ */
+export declare function getDeepLinkId(deepLink: string | undefined): string | undefined;
+export declare function appendVariantSuffix(fieldParentsName: string[] | undefined, suffix: string): string[];
+/**
+ * Remove variant deep-link markers (`&oneof=N`, `&d=N`) from a field-parent path
+ * piece, leaving the human-readable name(s). The markers can sit mid-path
+ * (e.g. `_embedded.quote&d=0.order` -> `_embedded.quote.order`), so they must be
+ * stripped in place rather than split off. Returns `''` when the piece was only a
+ * marker (e.g. `&d=0`), so callers can skip it in the breadcrumb.
+ */
+export declare function stripVariantMarkers(name: string): string;
+/**
+ * Remove `[]` array-item markers from a deep-link path piece.
+ * Legacy (openapi-docs) support.
+ */
+export declare function stripArrayMarkers(value: string): string;
+/**
+ * Keep only the variant markers (`&oneof=N` / `&d=N`) from each parent path piece,
+ * dropping plain field-name bases. Used at shallow render levels where breadcrumbs are
+ * suppressed, so a switched tab stays reload-reachable without showing a field prefix.
+ */
+export declare function variantMarkersOnly(fieldParentsName: string[] | undefined): string[];
+/**
+ * Extract a deep-link parameter value from a URL hash.
+ * The search is case-insensitive and values are returned lowercased.
+ */
+export declare function extractDeepLinkParamFromHash(hash: string, key: 'c' | 'm'): string | undefined;
+/**
+ * Detect legacy openapi hash patterns and return normalized suffix.
+ * Matches: #tag/..., #operation/..., #paths/...
+ */
+export declare function getLegacyHash(hash: string): string;
+/** Map a legacy single-page hash (`#section/…`, `#tag/…`, `#operation/…`) to its route in the multi-page engine; `undefined` for a genuine in-page anchor (e.g. a field deep link). */
+export declare function resolveLegacyHashToRoute(hash: string, basePath: string, routeIndex: RouteIndex): string | undefined;
+export {};

package/lib/utils/deep-link.js

@@ -0,0 +1 @@
+import{encodeBackSlashes as l,tryDecodeURIComponent as o}from"./string.js";import{joinWithSeparator as c,normalizePath as s}from"./url.js";import{resolveRouteByPathname as d}from"./routing.js";function a(e){const t=[];for(const[n,r]of Object.entries(e))r!==void 0&&t.push(`${n}=${r}`);return t.join("&")}function x(e,t){return e=l(e).replace(/^\/+/,""),(`/${e}#`+c(e,t)).toLowerCase()}function $(e,t,n){const r=x(t,n);return s(c(e,r))}function m(e){const t=e.startsWith("#")?e.slice(1):e;return o(t).toLowerCase()}function L(e){const t=o(e),n=t.indexOf("#");return n>=0?t.slice(n+1):""}function A(e){return a({t:e.t,in:e.in,c:e.c,cb:e.cb,ct:e.ct,path:e.path})}function R(e,t,n){let r=e;return n&&(r=`${r}&c=${n}`),t&&(r=c(r,t)),r}function b(e){const{section:t,messageKey:n,subsection:r}=e;if(!n)return t;let i=`${t}&m=${n}`;return r&&(i+=`&t=${r}`),i}function C(e){return a({t:e.t,path:e.path,arg:e.arg,rt:e.rt})}function S(e,t){return!e||!t?!1:o(e.startsWith("#")?e.slice(1):e).toLowerCase().includes(`path=${t.toLowerCase()}.`)}function D(e){return e&&L(e)||void 0}function O(e,t){const n=[...e??[]];return n.length>0?n[n.length-1]+=t:n.push(t),n}const g=/&(?:oneof|d)=\d+/g;function W(e){return e.replace(g,"")}function v(e){return e.replace(/\[\]/g,"")}function z(e){return(e??[]).filter(t=>t.includes("&")).map(t=>t.slice(t.indexOf("&")))}function E(e,t){return e?o(e.startsWith("#")?e.slice(1):e).toLowerCase().match(new RegExp(`(?:^|[&/])${t}=([^/&]+)`))?.[1]:void 0}function h(e){const t=["#tag","#operation","#paths"];for(const n of t)if(e.includes(n))return e.replace(n,"").toLowerCase();return""}function H(e,t,n){const r=m(e);if(!r)return;const i=s(c(t,r));if(d(n,i))return i;const u=h(e);if(u){const f=n.allRoutes.find(p=>p.path.toLowerCase().endsWith(u));if(f)return f.path}}export{O as appendVariantSuffix,b as buildAsyncApiSuffix,$ as buildDeepLinkUrl,C as buildGraphqlSuffix,A as buildOpenApiFieldSuffix,R as buildOpenApiSectionSuffix,L as deepLinkToId,E as extractDeepLinkParamFromHash,D as getDeepLinkId,h as getLegacyHash,m as hashToElementId,S as isGraphqlDeepLinkAncestor,x as makeDeepLink,H as resolveLegacyHashToRoute,a as serializeFieldParams,v as stripArrayMarkers,W as stripVariantMarkers,z as variantMarkersOnly};

package/lib/utils/environments.d.ts

@@ -0,0 +1,6 @@
+import type { Node } from '@markdoc/markdoc';
+import type { OpenAPIServer } from '../types/openapi.js';
+export type EnvironmentData = Record<string, Record<string, string>>;
+export declare function mergeEnvData(env1: EnvironmentData, env2?: EnvironmentData): EnvironmentData;
+export declare function getServerEnvName(server: Pick<OpenAPIServer, 'name' | 'description' | 'url'>): string | Node[] | Node;
+export declare const IS_BROWSER: boolean;

package/lib/utils/environments.js

@@ -0,0 +1 @@
+function i(e,t){return t?Array.from(new Set([...Object.keys(e),...Object.keys(t)])).reduce((r,n)=>(r[n]={...e[n],...t[n]},r),{}):e}function u(e){return e.name||e.description||e.url}const a=typeof window<"u"&&"HTMLElement"in window;export{a as IS_BROWSER,u as getServerEnvName,i as mergeEnvData};

package/lib/utils/expansion.d.ts

@@ -0,0 +1,3 @@
+export declare function isWithinExpansionLevel(level: number, schemasExpansionLevel: number | undefined, fallbackLevel: number): boolean;
+export declare const REQUIRED_EXPAND_LEVEL = 4;
+export declare function isRequiredAutoExpanded(level: number, required: boolean | undefined, schemasExpansionLevel: number | undefined): boolean;

package/lib/utils/expansion.js

@@ -0,0 +1 @@
+function o(e,n,t){return e<(n??t)}const i=4;function r(e,n,t){return t!==void 0?!1:!!n&&e<=i}export{i as REQUIRED_EXPAND_LEVEL,r as isRequiredAutoExpanded,o as isWithinExpansionLevel};

package/lib/utils/extract-extensions.d.ts

@@ -0,0 +1,4 @@
+export type GenericObject = Record<string, unknown>;
+export declare function isRedocExtension(key: string): boolean;
+export declare function extractExtensions(obj: GenericObject, showExtensions: string[] | true): GenericObject;
+export declare function getExtensionsForDisplay(obj: GenericObject, showExtensions: string[] | boolean): GenericObject;

package/lib/utils/extract-extensions.js

@@ -0,0 +1 @@
+const x={"x-circular-ref":!0,"x-complex":!0,"x-parentRefs":!0,"x-refsStack":!0,"x-codeSamples":!0,"x-displayName":!0,"x-examples":!0,"x-logo":!0,"x-nullable":!0,"x-servers":!0,"x-tagGroups":!0,"x-traitTag":!0,"x-additionalPropertiesName":!0,"x-explicitMappingOnly":!0,"x-enumDescriptions":!0,"x-badges":!0,"x-hideReplay":!0,"x-feedback":!0,"x-assertionType":!0,"x-rbac":!0,"x-seo":!0};function n(r){return r in x}function i(r,t){return Object.keys(r).filter(e=>t===!0?e.startsWith("x-")&&!n(e):e.startsWith("x-")&&t.indexOf(e)>-1).reduce((e,u)=>(e[u]=r[u],e),{})}function a(r,t){return t===!1||t===void 0?{}:i(r,t)}export{i as extractExtensions,a as getExtensionsForDisplay,n as isRedocExtension};

package/lib/utils/fetch-openapi-definition.d.ts

@@ -0,0 +1,6 @@
+import type { OpenAPIDefinition } from '../types/openapi.js';
+import type { NormalizedDownloadUrl } from '../types/options.js';
+export declare function pickReplayDefinitionDownloadUrl(downloadUrls: NormalizedDownloadUrl[] | undefined): string | undefined;
+export declare function fetchOpenApiDefinition(url: string): Promise<OpenAPIDefinition>;
+/** Fetches and parses the OpenAPI document, deduplicating concurrent/in-flight requests per URL. */
+export declare function fetchOpenApiDefinitionCached(url: string): Promise<OpenAPIDefinition>;

package/lib/utils/fetch-openapi-definition.js

@@ -0,0 +1 @@
+import{JSON_SCHEMA as s,load as a,types as i}from"js-yaml";const f=s.extend({implicit:[i.merge],explicit:[i.binary,i.omap,i.pairs,i.set]});function p(t){return a(t,{schema:f})}const o=new Map;function u(t){return t?.length?t.find(e=>/\.json(\?|$)/i.test(e.url))?.url??t[0].url:void 0}function c(t){return/^https?:\/\//i.test(t)?t:typeof globalThis.location?.href=="string"?new URL(t,globalThis.location.href).href:t}async function l(t){const n=c(t),e=await fetch(n);if(!e.ok)throw new Error(`Failed to load API definition (${e.status})`);const r=await e.text();try{return JSON.parse(r)}catch{return p(r)}}function d(t){const n=c(t);let e=o.get(n);return e||(e=l(t),o.set(n,e),e.catch(()=>o.delete(n))),e}export{l as fetchOpenApiDefinition,d as fetchOpenApiDefinitionCached,u as pickReplayDefinitionDownloadUrl};

package/lib/utils/form-urlencoded.d.ts

@@ -0,0 +1,6 @@
+export type FormFieldEncoding = {
+    style?: string;
+    explode?: boolean;
+};
+export declare function formUrlEncodeValue(value: unknown, encoding?: Record<string, FormFieldEncoding>): string;
+export declare function stringifyFormFieldValue(value: unknown): string;

package/lib/utils/form-urlencoded.js

@@ -0,0 +1 @@
+import{serializeParameterValue as o}from"./serialize-parameter.js";function s(n,i={}){return n==null?"":typeof n!="object"?String(n):(Array.isArray(n)?n.map((r,e)=>[String(e),r]):Object.entries(n)).map(([r,e])=>{const t=i[r];return t?o({name:r,in:"query",style:t.style,explode:t.explode},e):`${encodeURIComponent(r)}=${encodeURIComponent(f(e))}`}).join("&")}function f(n){return n==null?"":typeof n=="object"?JSON.stringify(n):String(n)}export{s as formUrlEncodeValue,f as stringifyFormFieldValue};

package/lib/utils/graphql-directive-utils.d.ts

@@ -0,0 +1,6 @@
+import type { GraphQLNamedType, GraphQLEnumValue, GraphQLField, GraphQLArgument, GraphQLInputField, GraphQLSchema } from 'graphql';
+import type { GraphQLInfo } from '../types/graphql.js';
+import type { RequiresScopesDirective } from './graphql-scopes.js';
+export type DirectiveTarget = GraphQLNamedType | GraphQLEnumValue | GraphQLField<any, any> | GraphQLArgument | GraphQLInputField;
+export declare function getRequiresScopesDirective(type: DirectiveTarget): RequiresScopesDirective | null;
+export declare function extractInfoFromDirectives(schema: GraphQLSchema): GraphQLInfo | undefined;

package/lib/utils/graphql-directive-utils.js

@@ -0,0 +1,3 @@
+import{Kind as a}from"graphql";function g(n){if(!n.astNode?.directives)return null;const e=n.astNode.directives.find(r=>r.name.value==="requiresScopes");if(!e)return null;const i=m(e);return!i||i.length===0?null:{scopes:i}}function m(n){const e=n.arguments?.find(i=>i.name.value==="scopes");return!e||!e.value?null:v(e.value)}function v(n){if(n.kind!==a.LIST)return null;const e=[];for(const i of n.values)i.kind===a.LIST&&e.push(i.values.map(r=>r.value));return e.length>0?e:null}function D(n){const e=n.astNode;if(!e)return;const i=t=>e.directives?.find(o=>o.name.value===t),r=i("redocly_info"),u=i("redocly_contact"),f=i("redocly_license"),s=p(e.description?.value);if(!r&&!u&&!f&&!s)return;const c={};if(s?.title&&(c.title=s.title),s?.description&&(c.description=s.description),r){const t=d(r);t.title&&(c.title=t.title),t.version&&(c.version=t.version),t.description&&(c.description=t.description),t.termsOfService&&(c.termsOfService=t.termsOfService)}if(u){const{name:t,url:o,email:l}=d(u);c.contact={name:t,url:o,email:l}}if(f){const{name:t,url:o,identifier:l}=d(f);c.license={name:t,url:o,identifier:l}}return c}function d(n){const e={};return n.arguments?.forEach(i=>{i.value.kind===a.STRING&&(e[i.name.value]=i.value.value)}),e}function p(n){const e=n?.trim();if(!e)return null;const[i,...r]=e.split(`
+`);return i.trim().startsWith("# ")?{title:i.trim().slice(2).trim()||void 0,description:r.join(`
+`).trim()||void 0}:{description:e}}export{D as extractInfoFromDirectives,g as getRequiresScopesDirective};

package/lib/utils/graphql-reference-map.d.ts

@@ -0,0 +1,3 @@
+import type { SchemaEntry } from '../types/store.js';
+import type { GraphqlStoreMeta, GraphqlTypeReference } from '../types/graphql-store.js';
+export declare function buildGraphqlReferenceMap(schemaStore: Record<string, SchemaEntry>, rootTypes?: GraphqlStoreMeta['rootTypes']): Record<string, GraphqlTypeReference[]>;

package/lib/utils/graphql-reference-map.js

@@ -0,0 +1 @@
+import{GRAPHQL_TYPE_ENTRY_PREFIX as r}from"../types/graphql-store.js";function m(f,s={}){const t={},i=new Set(Object.values(s));function a(n,e){t[n]||(t[n]=[]),t[n].push(e)}for(const n of Object.values(f)){if(!n.id.startsWith(r))continue;const e=n.data;if(!i.has(e.name)){for(const o of e.fields??[])a(o.type.name,{name:e.name,field:o.name});for(const o of e.possibleTypes??[])a(o,{name:e.name})}}return t}export{m as buildGraphqlReferenceMap};

package/lib/utils/graphql-samples.d.ts

@@ -0,0 +1,25 @@
+import type { ApiStore, SchemaEntry } from '../types/store.js';
+import type { GraphqlStoreFieldData, GraphqlTypeData } from '../types/graphql-store.js';
+export type GraphqlTypeLookup = (name: string) => GraphqlTypeData | undefined;
+export declare function createGraphqlTypeLookup(schemaStore: Record<string, SchemaEntry>): GraphqlTypeLookup;
+export declare function getOperationFromStore(store: Pick<ApiStore, 'schemaStore' | 'graphqlMeta'>, operationType: 'query' | 'mutation' | 'subscription', operationName: string): GraphqlStoreFieldData | undefined;
+export type ParsedTypeNotation = {
+    kind: 'named';
+    name: string;
+} | {
+    kind: 'list';
+    ofType: ParsedTypeNotation;
+} | {
+    kind: 'non-null';
+    ofType: ParsedTypeNotation;
+};
+export declare function parseTypeNotation(display: string): ParsedTypeNotation;
+export declare function getTypeExample(display: string, lookup: GraphqlTypeLookup, expandLevel: number, level?: number): unknown;
+type SampleLabels = {
+    argumentsHere: string;
+    fragment: string;
+};
+export declare function generateOperationExample(operationType: 'query' | 'mutation' | 'subscription', operation: GraphqlStoreFieldData, lookup: GraphqlTypeLookup, expandLevel: number, multilineArguments?: boolean, labels?: Partial<SampleLabels>): string;
+export declare function generateOperationVariablesExample(args: GraphqlStoreFieldData[], lookup: GraphqlTypeLookup, expandLevel: number): Record<string, unknown>;
+export declare function generateOperationResponseExample(typeDisplay: string, lookup: GraphqlTypeLookup, expandLevel: number): object;
+export {};

package/lib/utils/graphql-samples.js

@@ -0,0 +1,17 @@
+import{graphqlTypeEntryId as d}from"../types/graphql-store.js";const l="  ",y=new Set(["edges","nodes","node","pageInfo"]);function F(n){return t=>n[d(t)]?.data}function _(n,t,e){const r=n.graphqlMeta?.rootTypes[t];return r?n.schemaStore[d(r)]?.data?.fields?.find(i=>i.name===e):void 0}function p(n){const t=n.trim();return t.endsWith("!")?{kind:"non-null",ofType:p(t.slice(0,-1))}:t.startsWith("[")&&t.endsWith("]")?{kind:"list",ofType:p(t.slice(1,-1))}:{kind:"named",name:t}}function f(n){return l.repeat(n)}function x(n){switch(n){case"Int":return 40;case"Float":return 40;case"String":return"Example String";case"Boolean":return!0;case"ID":return"9cfb1c81-4c79-452f-b1f5-8ee6571276b4";default:return"Example Custom Scalar"}}function $(n,t,e,r=0){return g(p(n),t,e,r)}function g(n,t,e,r){return n.kind==="non-null"?g(n.ofType,t,e,r):n.kind==="list"?[g(n.ofType,t,e,r)]:E(n.name,t,e,r)}function E(n,t,e,r){const a=t(n);if(!a||a.variant==="scalar")return x(n);if(a.variant==="object"||a.variant==="interface")return T(a,t,e,r,!0);if(a.variant==="input")return T(a,t,e,r,!1);if(a.variant==="union"){const i=a.possibleTypes?.[0];return i?E(i,t,e,r):{}}return a.variant==="enum"?a.enumValues?.[0]?.name:{}}function T(n,t,e,r,a){if(r===e)return{__typename:n.name};const i={};for(const o of n.fields??[]){const s=a&&y.has(o.name)?r:r+1;i[o.name]=$(o.type.display,t,e,s)}return i}const b={argumentsHere:"Arguments Here",fragment:"Fragment"};function j(n,t){return n.length===0?"":t?`(
+${n.map(r=>`${f(1)}$${r.name}: ${r.type.display}`).join(`
+`)}
+)`:`(${n.map(e=>`$${e.name}: ${e.type.display}`).join(", ")})`}function I(n,t,e,r,a){if(n.length===0)return"";if(r>0){const i=f(e+1),o=f(e);return`(
+${i}# ${a.argumentsHere}
+${o})`}if(t){const i=f(e),o=f(e+1);return`(
+${n.map(c=>`${o}${c.name}: $${c.name}`).join(`
+`)}
+${i})`}return`(${n.map(i=>`${i.name}: $${i.name}`).join(", ")})`}function h(n,t,e,r,a,i,o){const s=t(n);if(!s)return"";if(s.variant==="object"||s.variant==="interface")return N(s,t,e,r,a,i,o);if(s.variant==="union"){const c=s.possibleTypes?.[0];return c?h(c,t,e,r,a,i,o):""}return""}function N(n,t,e,r,a,i,o){const s=f(r);if(i===a){const u=f(r+1);return`{
+${u}__typename
+${u}# ...${n.name}${o.fragment}
+${s}}`}return`{
+${(n.fields??[]).map(u=>{const m=y.has(u.name)?i:i+1;return S(u,t,e,r+1,a,m,o)}).join(`
+`)}
+${s}}`}function S(n,t,e,r,a,i,o){const s=I(n.args??[],e,r,i,o),c=h(n.type.name,t,e,r,a,i,o),u=c?" ":"";return`${f(r)}${n.name}${s}${u}${c}`}function A(n,t,e,r,a,i={}){const o=t.args??[],s=a??o.length>4,c=j(o,s),u={...b,...i},m=S(t,e,s,1,r,0,u);return`${n} ${t.name}${c} {
+${m}
+}`}function w(n,t,e){const r={};for(const a of n)r[a.name]=$(a.type.display,t,e);return r}function D(n,t,e){return{data:$(n,t,e)}}export{F as createGraphqlTypeLookup,A as generateOperationExample,D as generateOperationResponseExample,w as generateOperationVariablesExample,_ as getOperationFromStore,$ as getTypeExample,p as parseTypeNotation};

package/lib/utils/graphql-scopes.d.ts

@@ -0,0 +1,6 @@
+import type { GraphqlRequiresScopes } from '../types/graphql-store.js';
+export interface RequiresScopesDirective {
+    scopes: string[][];
+    parentScopes?: string[][];
+}
+export declare function mergeRequiresScopes(fieldScopes: GraphqlRequiresScopes | null | undefined, parentScopes: GraphqlRequiresScopes | null | undefined): RequiresScopesDirective | null;

package/lib/utils/graphql-scopes.js

@@ -0,0 +1 @@
+function u(s,r){return!s&&!r?null:s&&!r?{scopes:s.scopes}:!s&&r?{scopes:[],parentScopes:r.scopes}:{scopes:s?.scopes??[],parentScopes:r?.scopes??[]}}export{u as mergeRequiresScopes};

package/lib/utils/graphql-type-expansion.d.ts

@@ -0,0 +1,5 @@
+import type { GraphqlStoreFieldData, GraphqlTypeData } from '../types/graphql-store.js';
+import type { GraphqlTypeLookup } from './graphql-samples.js';
+export declare function isGraphqlFieldExpandable(field: GraphqlStoreFieldData, fieldExpandLevel: number, maxFieldExpandLevel: number, lookup: GraphqlTypeLookup): boolean;
+export declare function graphqlTypeHasExpandableFields(data: GraphqlTypeData | undefined, fieldExpandLevel: number, maxFieldExpandLevel: number, lookup: GraphqlTypeLookup): boolean;
+export declare function countNamedTypeFields(typeName: string, lookup: GraphqlTypeLookup): number;

package/lib/utils/graphql-type-expansion.js

@@ -0,0 +1 @@
+function s(e){return!e||e.variant==="scalar"}function i(e){return e?.variant==="object"||e?.variant==="interface"||e?.variant==="input"}function l(e,r,n,t){return r>=n?!1:(e.args?.length??0)>0||!s(t(e.type.name))}function u(e,r,n,t){return i(e)?(e.fields??[]).some(a=>l(a,r,n,t)):!1}function o(e,r){const n=r(e);return i(n)?n.fields?.length??0:0}export{o as countNamedTypeFields,u as graphqlTypeHasExpandableFields,l as isGraphqlFieldExpandable};

package/lib/utils/http-methods.d.ts

@@ -0,0 +1,8 @@
+/**
+ * OpenAPI operation (HTTP method) keys recognized on a path item, including
+ * the OpenAPI 3.2 `query` / vendor `x-query` operations. Shared by the
+ * adapter build context and the public `isOperationName` guard.
+ */
+export declare const HTTP_METHODS: ReadonlySet<string>;
+/** Returns `true` when `key` names an OpenAPI operation on a path item. */
+export declare function isOperationName(key: string): boolean;

package/lib/utils/http-methods.js

@@ -0,0 +1 @@
+const t=new Set(["get","post","put","delete","patch","head","options","trace","query","x-query"]);function o(e){return t.has(e.toLowerCase())}export{t as HTTP_METHODS,o as isOperationName};

package/lib/utils/languages.d.ts

@@ -0,0 +1,18 @@
+import type { Language } from '../types/openapi.js';
+/** Every language `codeSamples.languages` accepts. `label` is what users write in config. */
+export declare const DEFAULT_LANGUAGES: Language[];
+/** Tab identity — a custom `label` names the tab. */
+export declare function getLangKey({ lang, label }: {
+    lang: string;
+    label?: string;
+}): string;
+/** Language to generate code in — a custom `label` never changes it. */
+export declare function getGeneratorKey({ lang }: {
+    lang: string;
+}): string;
+/**
+ * Grammar for the syntax highlighter, resolved from the configured language name. Keep this the
+ * only place a language is turned into a grammar: it is many-to-one (`Node.js` and `JavaScript`
+ * both highlight as JavaScript, `Payload` as JSON), so a grammar can never identify a language.
+ */
+export declare function getSyntaxHighlightLang(lang: string): string;

package/lib/utils/languages.js

@@ -0,0 +1 @@
+const l=[{key:"curl",label:"curl",lang:"bash"},{key:"javascript",label:"JavaScript",lang:"javascript"},{key:"node",label:"Node.js",lang:"javascript"},{key:"python",label:"Python",lang:"python"},{key:"java",label:"Java",lang:"java"},{key:"csharp",label:"C#",lang:"csharp"},{key:"php",label:"PHP",lang:"php"},{key:"go",label:"Go",lang:"go"},{key:"ruby",label:"Ruby",lang:"ruby"},{key:"r",label:"R",lang:"r"},{key:"payload",label:"Payload",lang:"payload"}],n=[{key:"csharpnewtonsoft",label:"C#+Newtonsoft",lang:"csharp"},{key:"java8",label:"Java8+Apache",lang:"java"}],o=new Map([...l,...n].map(a=>[a.label.toLowerCase(),a]));function p({lang:a,label:t}){const e=(t||a).toLowerCase();return o.get(e)?.key??e}function y({lang:a}){return o.get(a.toLowerCase())?.key??a.toLowerCase()}const r={curl:"bash",javascript:"javascript","node.js":"javascript",python:"python",java:"java","java8+apache":"java","c#":"csharp","c#+newtonsoft":"csharp",php:"php",go:"go",ruby:"ruby",r:"r",payload:"json"};function s(a){return r[a.toLowerCase()]??a.toLowerCase()}export{l as DEFAULT_LANGUAGES,y as getGeneratorKey,p as getLangKey,s as getSyntaxHighlightLang};

package/lib/utils/loadAndBundleSpec.d.ts

@@ -0,0 +1,4 @@
+import type { RedocConfig } from '@redocly/config';
+import type { OpenAPIDefinition } from '../types/openapi.js';
+export declare function loadOpenapiConfig(): Promise<RedocConfig>;
+export declare function loadAndBundleDefinition(specUrlOrObject: Record<string, unknown> | string): Promise<OpenAPIDefinition>;

package/lib/utils/loadAndBundleSpec.js

@@ -0,0 +1 @@
+import{createEmptyRedoclyConfig as i}from"@redocly/openapi-core/lib/bundle-oas";import{bundle as c}from"@redocly/openapi-core";import{IS_BROWSER as r}from"@redocly/theme/core/openapi";import{convertSwagger2OpenAPI as f}from"../adapters/utils/convertSwagger2OpenAPI.js";async function p(){try{return i()?.resolvedConfig.openapi||{}}catch{return{}}}async function g(o){const t=i(),e={config:t,base:r?window.location.origin:typeof globalThis.process<"u"?globalThis.process.cwd():""};r&&(t.resolve.http.customFetch=globalThis.fetch),typeof o=="object"&&o!==null?e.doc=a(o):e.ref=o;const{bundle:{parsed:n}}=await c(e);return n.swagger!==void 0?f(n):n}function a(o){return{source:{absoluteRef:""},parsed:o}}export{g as loadAndBundleDefinition,p as loadOpenapiConfig};

package/lib/utils/logo.d.ts

@@ -0,0 +1,8 @@
+import type { RawLogo, SidebarLogo } from '../types/common.js';
+/**
+ * Normalizes an authored `{ url }` logo (OpenAPI `info.x-logo`, the standalone `logo` prop) into
+ * the `{ imageUrl }` shape the sidebar renders. `hrefFallback` covers OpenAPI's `info.contact.url`,
+ * as legacy did. Without an image there is nothing to render, hence `undefined` — which is also
+ * what lets callers fall through to the next logo source with `??`.
+ */
+export declare function toSidebarLogo(raw: RawLogo | undefined, hrefFallback?: string): SidebarLogo | undefined;

package/lib/utils/logo.js

@@ -0,0 +1 @@
+function r(e,o){if(e?.url)return{imageUrl:e.url,href:e.href||o,altText:e.altText,backgroundColor:e.backgroundColor}}export{r as toSidebarLogo};

package/lib/utils/media-type.d.ts

@@ -0,0 +1,7 @@
+import type { FormFieldEncoding } from './form-urlencoded.js';
+export declare function isSequentialMediaType(contentType: string | undefined): boolean;
+export declare function isJsonLikeMediaType(contentType: string | undefined): boolean;
+export declare function langFromMime(contentType: string | undefined): string;
+export declare function normalizeLanguageForHighlight(language: string | undefined): string;
+export declare function isSampleableMediaType(contentType: string | undefined): boolean;
+export declare function encodeExampleForMediaType(value: unknown, mimeType: string, encoding?: Record<string, FormFieldEncoding>): string;

package/lib/utils/media-type.js

@@ -0,0 +1 @@
+import{MediaTypes as e}from"../constants/openapi.js";import{formUrlEncodeValue as f}from"./form-urlencoded.js";import{jsonToXml as l}from"./xml.js";const a=new Set([e.JSONL,e.NDJSON,e.JSON_SEQ,e.EVENT_STREAM,e.MULTIPART_MIXED]);function n(r){return r?a.has(r.toLowerCase()):!1}function t(r){return r?r.search(/json/i)!==-1:!1}function d(r){if(!r)return"clike";const i=r.toLowerCase();return i.includes("xml")?"xml":i.includes("application/json-seq")?"json-seq":i.includes("application/jsonl")||i.includes("application/x-ndjson")?"jsonl":i.includes("multipart/mixed")?"multipart-mixed":i.includes("text/event-stream")?"yaml":i.includes("json")?"json":"clike"}function S(r){if(!r)return"clike";const i=r.toLowerCase();return i.includes("/")?d(i):i}function o(r){return/xml/i.test(r)}function s(r){return r.toLowerCase().includes(e.URL_ENCODED)}function c(r){return r.toLowerCase().includes(e.MULTIPART)}function x(r){return r?t(r)||o(r)||n(r)||s(r)||c(r):!1}function E(r,i,u){if(r===void 0)return"";if(t(i)&&!n(i))try{return JSON.stringify(typeof r=="string"?JSON.parse(r):r,null,2)??""}catch{return String(r)}return typeof r=="object"&&r!==null?s(i)?f(r,u):o(i)?l(r):JSON.stringify(r,null,2):String(r)}export{E as encodeExampleForMediaType,t as isJsonLikeMediaType,x as isSampleableMediaType,n as isSequentialMediaType,d as langFromMime,S as normalizeLanguageForHighlight};

package/lib/utils/multipart.d.ts

@@ -0,0 +1,7 @@
+export type ParsedMultipartPart = {
+    name: string;
+    value?: string;
+    fileName?: string;
+    contentType?: string;
+};
+export declare function parseMultipartFormData(text: string): ParsedMultipartPart[] | undefined;

package/lib/utils/multipart.js

@@ -0,0 +1 @@
+const p=/Content-Disposition:\s*form-data;\s*name="([^"]+)"(?:;\s*filename="([^"]+)")?/i,u=/Content-Type:\s*([^\r\n]+)/i,m=/\r?\n\r?\n([\s\S]*?)(?:\r?\n)?$/,E=/[.*+?^${}()|[\]\\]/g;function h(t){if(typeof t!="string"||t.length===0)return;const o=t.replace(/^\s+/,"").match(/^--([^\r\n]+)/);if(!o)return;const c=o[1].replace(E,"\\$&"),f=t.split(new RegExp(`--${c}(?:--)?`,"g")).filter(n=>n.trim().length>0),e=[];for(const n of f){const r=n.match(p);if(!r)continue;const[,s,i]=r,a=n.match(u)?.[1].trim();if(i){e.push({name:s,fileName:i,...a?{contentType:a}:{}});continue}e.push({name:s,value:n.match(m)?.[1].trim()??""})}return e.length>0?e:void 0}export{h as parseMultipartFormData};

package/lib/utils/refPointer.d.ts

@@ -0,0 +1,2 @@
+export declare function encodeJsonPointerSegment(segment: string): string;
+export declare function refPointerToStoreId(ref: string | undefined): string | undefined;

package/lib/utils/refPointer.js

@@ -0,0 +1 @@
+function n(e){return e.replace(/~/g,"~0").replace(/\//g,"~1")}function r(e){if(!e)return;const t=e.startsWith("#")?e.slice(1):e;return t.startsWith("/")?t.slice(1):t}export{n as encodeJsonPointerSegment,r as refPointerToStoreId};

package/lib/utils/resolveText.d.ts

@@ -0,0 +1,2 @@
+import type { TFunction } from '../hooks/useTranslate.js';
+export declare function resolveText(translate: TFunction, translationKey: string | undefined, text: string | undefined): string;

package/lib/utils/resolveText.js

@@ -0,0 +1 @@
+function f(u,r,e){return r?u(r,e??r):e??""}export{f as resolveText};

package/lib/utils/routing.d.ts

@@ -0,0 +1,49 @@
+import type { ApiItem, ApiItemContent } from '../types/store.js';
+import type { BadgeData } from '../types/common.js';
+export type RouteItem = {
+    path: string;
+    label: string;
+    content: ApiItemContent;
+    badges?: BadgeData[];
+    deprecated?: boolean;
+    eager?: boolean;
+};
+export type TagWithItems = {
+    tag: RouteItem;
+    items: RouteItem[];
+};
+export type RouteIndex = {
+    allRoutes: RouteItem[];
+    tagByPath: Map<string, TagWithItems>;
+    itemToParentTag: Map<string, TagWithItems>;
+    routeIndexByPath: Map<string, number>;
+    rootPage: RouteItem | undefined;
+    tags: RouteItem[];
+};
+type CollectRoutesParams = {
+    apiItems: ApiItem[];
+    allRoutes: RouteItem[];
+    tagsWithItems: TagWithItems[];
+    parentTag: TagWithItems | null;
+    allTagsWithItems?: TagWithItems[];
+};
+export declare function buildRouteIndex(allRoutes: RouteItem[], tagsWithItems: TagWithItems[], _basePath: string, allTagsWithItems?: TagWithItems[]): RouteIndex;
+export declare function resolveRouteByPathname(routeIndex: RouteIndex, pathname: string): RouteItem | undefined;
+export declare function collectRoutesRecursively({ apiItems, allRoutes, tagsWithItems, parentTag, allTagsWithItems, }: CollectRoutesParams): void;
+export type FlatDescendant = RouteItem & {
+    /** Path of the hub whose open state gates this descendant's render. For
+     *  items under a GROUP sub-tag this is the sub-tag itself; items under a
+     *  non-GROUP sub-tag (an AsyncAPI channel) inherit the channel's own gate,
+     *  so a channel's operations render whenever the channel does. */
+    gatePath: string;
+};
+export type TopLevelEntry = {
+    sectionId: string;
+    content: NonNullable<RouteItem['content']>;
+    path: string;
+    /** Descendants flattened (tag's direct items + any nested sub-tags + their items, in source order). */
+    children: FlatDescendant[];
+};
+export declare function buildTopLevelEntries(routeIndex: RouteIndex): TopLevelEntry[];
+export declare function buildEagerSlugs(activeRoute: RouteItem | undefined, routeIndex: RouteIndex): Set<string>;
+export {};

package/lib/utils/routing.js

@@ -0,0 +1 @@
+import{contentType as g}from"../types/common.js";import{tryDecodeURIComponent as f}from"./string.js";function b(t,a,n,o){const s=new Map,e=new Map,i=new Map,r=o??a;for(const c of r){s.set(c.tag.path,c);for(const p of c.items)e.set(p.path,c)}for(let c=0;c<t.length;c++){const p=t[c];i.set(p.path,c);const d=f(p.path);d!==p.path&&i.set(d,c)}return{allRoutes:t,tagByPath:s,itemToParentTag:e,routeIndexByPath:i,rootPage:t[0],tags:a.map(c=>c.tag)}}const m=/\/index(\.(ya?ml|json|graphql|gql))?$/;function D(t,a){const n=f(a||"/").toLowerCase(),o=t.routeIndexByPath.get(n);if(o!==void 0)return t.allRoutes[o];const s=n.replace(m,"");if(s!==n){const e=t.routeIndexByPath.get(s||"/");if(e!==void 0)return t.allRoutes[e]}if(n==="/")return t.allRoutes[0]}function u({apiItems:t,allRoutes:a,tagsWithItems:n,parentTag:o,allTagsWithItems:s}){for(const e of t){if(e.type==="link"&&e.link){const i=h(e);a.push(i),o&&o.items.push(i);continue}if(e.type==="group"){if(e.link){const i=h(e);a.push(i);const r={tag:i,items:[]};o?o.items.push(i):r.tag.content!==null&&n.push(r),s&&s.push(r),e.items&&u({apiItems:e.items,allRoutes:a,tagsWithItems:n,parentTag:r,allTagsWithItems:s})}else e.items&&u({apiItems:e.items,allRoutes:a,tagsWithItems:n,parentTag:o,allTagsWithItems:s});continue}e.type==="separator"&&e.items&&u({apiItems:e.items,allRoutes:a,tagsWithItems:n,parentTag:o,allTagsWithItems:s})}}function h(t){const a=f(t.routeSlug??t.link??"").toLowerCase(),n="badges"in t?t.badges:void 0,o="deprecated"in t?t.deprecated:void 0;return{path:a,label:t.label??"",content:t.content,badges:n,deprecated:o}}function w(t){const a=[];for(const n of t.allRoutes){if(n.content===null||t.itemToParentTag.has(n.path))continue;const o=t.tagByPath.get(n.path),s=o?l(o,t.tagByPath):[];a.push({sectionId:n.path,content:n.content,path:n.path,children:s})}return a}function l(t,a,n=t.tag.path){const o=[];for(const s of t.items){o.push({...s,gatePath:n});const e=a.get(s.path);if(e){const i=e.tag.content?.contentType===g.ITEM?n:e.tag.path;o.push(...l(e,a,i))}}return o}function B(t,a){const n=new Set;if(!t)return n;if(t.content===null&&a.rootPage)return n.add(a.rootPage.path),n;n.add(t.path);const o=a.tagByPath.get(t.path);if(o){const s=o.items.find(e=>e.content!==null);s&&n.add(s.path)}return n}export{B as buildEagerSlugs,b as buildRouteIndex,w as buildTopLevelEntries,u as collectRoutesRecursively,D as resolveRouteByPathname};

package/lib/utils/scroll-anchoring.d.ts

@@ -0,0 +1,3 @@
+/** Keeps the section under the reading line in view across a content-height swap
+ *  (response code, oneOf, media type). Call synchronously from the state write. */
+export declare function keepReadingSectionAnchored(): void;

package/lib/utils/scroll-anchoring.js

@@ -0,0 +1 @@
+import{SECTION_READING_LINE_OFFSET as o}from"@redocly/theme/core/openapi";import{IS_BROWSER as c}from"./environments.js";import{SECTION_ATTR as i}from"../constants/openapi.js";let n=!1;function m(){if(!c||n)return;const e=f();e&&(n=!0,requestAnimationFrame(()=>{if(n=!1,!e.isConnected)return;const{top:t,bottom:r}=e.getBoundingClientRect();(r<=0||t>=window.innerHeight)&&e.scrollIntoView({block:"nearest"})}))}function f(){for(const e of document.querySelectorAll(`[${i}]`)){if(e.parentElement?.closest(`[${i}]`))continue;const t=e.getBoundingClientRect();if(t.top<=o&&t.bottom>o)return e}return null}export{m as keepReadingSectionAnchored};

package/lib/utils/security-scope.d.ts

@@ -0,0 +1,3 @@
+export declare function isScopeTruncated(scope: string, maxVisibleScopeChars: number): boolean;
+export declare function getVisibleScopeLabel(scope: string, maxVisibleScopeChars: number): string;
+export declare function normalizeScopes(scopes?: string[]): string[];

package/lib/utils/security-scope.js

@@ -0,0 +1 @@
+function e(r,t){return r.length>t}function n(r,t){return e(r,t)?`${r.slice(0,t)}...`:r}function i(r){return!r||r.length===0?[]:Array.from(new Set(r.map(t=>t.trim()).filter(Boolean)))}export{n as getVisibleScopeLabel,e as isScopeTruncated,i as normalizeScopes};

package/lib/utils/serialize-parameter.d.ts

@@ -0,0 +1,8 @@
+type ParameterLike = {
+    name: string;
+    in?: string;
+    style?: string;
+    explode?: boolean;
+};
+export declare function serializeParameterValue(param: ParameterLike, value: unknown): string;
+export {};

package/lib/utils/serialize-parameter.js

@@ -0,0 +1 @@
+function g(t,e){if(e==null)return"";const o=t.style??$(t.in),n=t.explode??o==="form";switch(t.in){case"path":return p(t.name,o,n,e);case"query":case"querystring":return f(t.name,o,n,e);case"header":return m(o,n,e);case"cookie":return s(t.name,o,n,e);default:return String(e)}}function $(t){switch(t){case"query":case"querystring":case"cookie":return"form";case"path":case"header":return"simple";default:return"simple"}}function p(t,e,o,n){if(Array.isArray(n)){const r=o?e==="label"?".":e==="matrix"?`;${t}=`:",":e==="label"?".":",";return(e==="label"?".":e==="matrix"?`;${t}=`:"")+n.map(String).join(r)}if(typeof n=="object"&&n!==null){const r=Object.entries(n);return e==="label"?"."+r.map(([i,c])=>o?`${i}=${String(c)}`:`${i},${String(c)}`).join("."):e==="matrix"?o?r.map(([i,c])=>`;${i}=${String(c)}`).join(""):`;${t}=`+r.map(([i,c])=>`${i},${String(c)}`).join(","):o?r.map(([i,c])=>`${i}=${String(c)}`).join(","):r.map(([i,c])=>`${i},${String(c)}`).join(",")}return e==="label"?"."+String(n):e==="matrix"?`;${t}=${String(n)}`:String(n)}function f(t,e,o,n){if(Array.isArray(n))return e==="form"?o?n.map(r=>`${encodeURIComponent(t)}=${encodeURIComponent(String(r))}`).join("&"):`${encodeURIComponent(t)}=${n.map(r=>encodeURIComponent(String(r))).join(",")}`:e==="spaceDelimited"?`${encodeURIComponent(t)}=${n.map(r=>encodeURIComponent(String(r))).join("%20")}`:e==="pipeDelimited"?`${encodeURIComponent(t)}=${n.map(r=>encodeURIComponent(String(r))).join("|")}`:`${encodeURIComponent(t)}=${n.map(r=>encodeURIComponent(String(r))).join(",")}`;if(typeof n=="object"&&n!==null){const r=Object.entries(n);return e==="deepObject"?r.map(([i,c])=>`${encodeURIComponent(t)}[${encodeURIComponent(i)}]=${encodeURIComponent(String(c??""))}`).join("&"):e==="form"&&o?r.map(([i,c])=>`${encodeURIComponent(i)}=${encodeURIComponent(String(c??""))}`).join("&"):`${encodeURIComponent(t)}=${r.map(([i,c])=>`${encodeURIComponent(i)},${encodeURIComponent(String(c??""))}`).join(",")}`}return`${encodeURIComponent(t)}=${encodeURIComponent(String(n))}`}function m(t,e,o){if(Array.isArray(o))return o.map(String).join(",");if(typeof o=="object"&&o!==null){const n=Object.entries(o);return e?n.map(([r,i])=>`${r}=${String(i)}`).join(","):n.map(([r,i])=>`${r},${String(i)}`).join(",")}return String(o)}function s(t,e,o,n){if(Array.isArray(n))return o?n.map(r=>`${t}=${String(r)}`).join("; "):`${t}=${n.map(String).join(",")}`;if(typeof n=="object"&&n!==null){const r=Object.entries(n);return o?r.map(([i,c])=>`${i}=${String(c)}`).join("; "):`${t}=${r.map(([i,c])=>`${i},${String(c)}`).join(",")}`}return`${t}=${String(n)}`}export{g as serializeParameterValue};

package/lib/utils/serialize-querystring.d.ts

@@ -0,0 +1,6 @@
+type HarParam = {
+    name: string;
+    value: string;
+};
+export declare function objectToHarParams(obj: unknown, parentKey?: string): HarParam[];
+export {};

package/lib/utils/serialize-querystring.js

@@ -0,0 +1 @@
+function u(r,e=""){const s=[];if(!r||typeof r!="object")return s;const o=Array.isArray(r)?r.map((n,t)=>[String(t),n]):Object.entries(r);for(const[n,t]of o){const c=e?`${e}[${n}]`:n;if(typeof t=="object"&&t!==null)s.push(...u(t,c));else{const i=Array.isArray(r)&&e?e:c;s.push({name:i,value:String(t)})}}return s}export{u as objectToHarParams};

package/lib/utils/session-storage.d.ts

@@ -0,0 +1,2 @@
+export declare function toSessionStorage(key: string, value: string): void;
+export declare function fromSessionStorage<T extends string>(key: string): T;

package/lib/utils/session-storage.js

@@ -0,0 +1 @@
+import{IS_BROWSER as e}from"./environments.js";function n(o,t){e&&window.sessionStorage.setItem("redoc."+o,t)}function i(o){return e&&window.sessionStorage.getItem("redoc."+o)||""}export{i as fromSessionStorage,n as toSessionStorage};

package/lib/utils/split-badges-by-position.d.ts

@@ -0,0 +1,5 @@
+import type { BadgeType } from '../types/schema.js';
+export declare function splitBadgesByPosition(badges: BadgeType[] | undefined): {
+    before: BadgeType[];
+    after: BadgeType[];
+};

package/lib/utils/split-badges-by-position.js

@@ -0,0 +1 @@
+function t(e){return e?.length?{before:e.filter(r=>r.position==="before"),after:e.filter(r=>r.position!=="before")}:{before:[],after:[]}}export{t as splitBadgesByPosition};

package/lib/utils/status-code.d.ts

@@ -0,0 +1 @@
+export declare function isStatusCode(code: string): boolean;

package/lib/utils/status-code.js

@@ -0,0 +1 @@
+function e(t){return t==="default"||/^\d+$/.test(t)||/^[1-5]xx$/i.test(t)}export{e as isStatusCode};

package/lib/utils/string.d.ts

@@ -0,0 +1,18 @@
+/** Spec values are untrusted: keep truthy scalars, drop objects, arrays and nullish. */
+export declare function asString(value: unknown): string | undefined;
+export declare function strikethroughText(text: string): string;
+export declare function encodeBackSlashes(str: string): string;
+export declare function tryDecodeURIComponent(str: string): string;
+/**
+ * slugify() returns empty string when failed to slugify.
+ * so try to return minimum slugified-string with failed one which keeps original value
+ * the regex codes are referenced with https://gist.github.com/mathewbyrne/1280286
+ */
+export declare function safeSlugify(value: string): string;
+export declare function safeJsonParse<T = unknown>(str: string, fallback?: T): T;
+/**
+ * Generates href from item id
+ */
+export declare function getHref(id: string): string;
+export declare function getFileExtension(value: string): string;
+export declare function transformStringToTelemetryId(...args: string[]): string;

package/lib/utils/string.js

@@ -0,0 +1 @@
+import t from"slugify";function i(e){if(e){if(typeof e=="string")return e;if(typeof e=="number"||typeof e=="boolean")return String(e)}}function c(e){return e.split("").map(r=>r+"\u0335").join("")}function n(e){return e.replace(/\\/g,"%5C")}function p(e){try{return decodeURIComponent(e)}catch(r){return console.error("Decoding failed: %s",e,r),e}}function f(e){return t(e)||e.toString().toLowerCase().replace(/\s+/g,"-").replace(/&/g,"-and-").replace(/--+/g,"-").replace(/^-+/,"").replace(/-+$/,"")}function u(e,r={}){try{return JSON.parse(e)}catch{return r}}function s(e){return n(`/${e}`.toLowerCase())}function a(e){const r=e.split(".");return r.length>1?r[r.length-1].toLowerCase():"file"}function l(...e){return e.join("_").replaceAll(" ","_").replaceAll(".","_").toLowerCase()}export{i as asString,n as encodeBackSlashes,a as getFileExtension,s as getHref,u as safeJsonParse,f as safeSlugify,c as strikethroughText,l as transformStringToTelemetryId,p as tryDecodeURIComponent};

package/lib/utils/telemetry.d.ts

@@ -0,0 +1 @@
+export declare function getDefaultCollectorUrl(): string;

package/lib/utils/telemetry.js

@@ -0,0 +1 @@
+import{withPathPrefix as o}from"@redocly/theme/core/openapi";import{IS_BROWSER as t}from"./environments.js";function i(){return process.env.NODE_ENV==="development"?"http://localhost:4318":t?window.location.origin+o("/_otel"):""}export{i as getDefaultCollectorUrl};

package/lib/utils/url.d.ts

@@ -0,0 +1,9 @@
+export declare function joinWithSeparator(base?: string, path?: string, sep?: string): string;
+export declare function normalizePath(path: string): string;
+export declare function stripLeadingSlash(path: string): string;
+/**
+ * The relative item slug used as the wrapper element id (e.g. `pet/getpetbyid`).
+ * Legacy openapi-docs stamped this id, and e2e/consumer locators depend on it.
+ */
+export declare function toElementId(itemPath: string, basePath: string): string | undefined;
+export declare function toRelativePath(absolutePath: string, basePath: string): string;

package/lib/utils/url.js

@@ -0,0 +1 @@
+function l(n="",i="",r="/"){return n.endsWith(r)&&n!==r&&(n=n.slice(0,-r.length)),i.startsWith(r)&&(i=i.slice(r.length)),!n||!i||n===r?n+i:n+r+i}function e(n){return n.length>1&&n.endsWith("/")&&(n=n.slice(0,-1)),n.startsWith("/")||(n="/"+n),n}function o(n){return n.startsWith("/")?n.slice(1):n}function u(n,i){return o(f(n,i))||void 0}function f(n,i){if(!i)return n;const r=e(n),t=e(i);return r===t?"":r.startsWith(t+"/")?r.slice(t.length+1):n}export{l as joinWithSeparator,e as normalizePath,o as stripLeadingSlash,u as toElementId,f as toRelativePath};

package/lib/utils/xml.d.ts

@@ -0,0 +1 @@
+export declare function jsonToXml(value: unknown): string;

package/lib/utils/xml.js

@@ -0,0 +1 @@
+import{XMLBuilder as n}from"fast-xml-parser";const o=new n({format:!0,cdataPropName:"#cdata"});function d(r){if(r==null)return"";if(typeof r!="object")return String(r);const t=Array.isArray(r)?r:{root:r};return o.build(t).trimEnd()}export{d as jsonToXml};