@redocly/api-docs 0.2.0-next.0 → 0.2.0-next.10

package/lib/types/common.d.ts

@@ -1,9 +1,8 @@
 import type { Node } from '@markdoc/markdoc';
 import type { ConfigureRequestValues, ConfigureServerRequestValues } from '@redocly/theme/ext/configure';
-import type { UserClaims } from '@redocly/theme/core/types';
+import type { UserClaims } from '@redocly/theme/core/openapi';
 export type { ConfigureRequestValues, ConfigureServerRequestValues };
 export type { UserClaims };
-export type { RbacScopeItems } from '@redocly/config';
 export type ObjectValues<T> = T[keyof T];
 export type OpenAPIRef = {
     $ref: string;

package/lib/types/content.d.ts

@@ -1,6 +1,8 @@
 import type { REDOCLY_TEAMS_RBAC } from '@redocly/config';
+import type { AdmonitionProps } from '@redocly/theme/components/Admonition/Admonition';
 import type { Node } from '@markdoc/markdoc';
-import type { OpenAPIOperation, OpenAPIResponse } from './openapi.js';
+import type { OpenAPIResponse } from './openapi.js';
+import type { OpenAPIOperation } from './openapi.js';
 import type { CodeSampleSource } from '../services/code-samples/index.js';
 import type { BadgeData, ServerData, nodeTypes, panelKind } from './common.js';
 import type { GroupItem, ApiItemContent, SecuritySchemeEntry } from './store.js';
@@ -187,7 +189,7 @@ export type MarkdocNode = {
 };
 export type AdmonitionNode = {
     nodeType: typeof nodeTypes.ADMONITION;
-    admonitionType: 'warning' | 'info' | 'danger' | 'success' | 'default';
+    admonitionType: NonNullable<AdmonitionProps['type']>;
     name?: string;
     nameTranslationKey?: string;
     content?: string | Node[] | Node;
@@ -405,7 +407,7 @@ export type ResponseExamplesPanelItem = BaseExamplePanelItem & {
     kind: typeof panelKind.RESPONSE;
     exampleIds?: string[];
     responseCodes?: ResponseCodeEntry[];
-    headerTitle?: string;
+    hideHeaderTitle?: boolean;
     exampleKey?: string;
 };
 export type GraphQLQueryPanelItem = BaseExamplePanelItem & {
@@ -468,7 +470,7 @@ export type OverviewPanelItem = ExternalLinkPanelItem | EmailPanelItem | KeyValu
 export type McpPanelItem = KeyValuePanelItem | TagsPanelItem | ExternalLinkPanelItem | ConnectMcpButtonPanelItem;
 export type McpExamplePanelItem = {
     kind: typeof panelKind.MCP_EXAMPLE;
-    headerTitle: string;
+    headerTitleTranslationKey: string;
     data: unknown;
     language?: string;
 };

package/lib/types/edition-config.d.ts

@@ -0,0 +1,4 @@
+import type { AsyncApiConfig, GraphQLConfig, RedocConfig } from '@redocly/config';
+export type EditionRedocConfig = RedocConfig;
+export type EditionAsyncApiConfig = AsyncApiConfig;
+export type EditionGraphQLConfig = GraphQLConfig;

package/lib/types/events.d.ts

@@ -1,8 +1,8 @@
 import type { Operation } from './options.js';
-export type AnalyticsEventType = 'CodeSampleLanguageSwitched' | 'CodeSampleCopied' | 'OperationServerExpanded' | 'PanelToggle' | 'TargetServerSwitched' | 'TryItOpen' | 'TryItSent';
+export type AnalyticsEventType = 'CodeSampleLanguageSwitched' | 'CodeSampleCopied' | 'OperationServerExpanded' | 'PanelToggle' | 'TryItOpen' | 'TryItSent' | 'TargetServerSwitched';
 export type AnalyticsEvent = {
     eventType: AnalyticsEventType;
-    resource: 'Redocly_CodeSample' | 'Redocly_Operation' | 'Redocly_OperationTryIt';
+    resource: 'Redocly_CodeSample' | 'Redocly_OperationTryIt' | 'Redocly_Operation';
     action: 'LanguageSwitched' | 'PanelToggled' | 'Opened' | 'Closed' | 'NavigatedOverrideLink' | 'Sent' | 'ValidationFailed' | 'CodeSampleCopied' | 'TargetServerSwitched';
     operationId?: string;
     operationPath: string;

package/lib/types/openapi.d.ts

@@ -1,4 +1,5 @@
-import type { ENTITY_RELATION_TYPES, REDOCLY_TEAMS_RBAC, RbacScopeItems } from '@redocly/config';
+import type { RbacScopeItems, REDOCLY_TEAMS_RBAC } from '@redocly/config';
+import type { ENTITY_RELATION_TYPES } from '@redocly/config';
 import type { Node } from '@markdoc/markdoc';
 import type { SecurityDetails as ThemeSecurityDetails } from '@redocly/theme/ext/configure';
 import type { OpenAPIRef, RawLogo, Referenced, SeoData, ExternalDocsData, SecuritySchemeType, SecuritySchemeIn, ObjectValues } from './common.js';
@@ -549,9 +550,9 @@ export type OperationInfo = {
     externalDocs?: ExternalDocsData;
     'x-seo'?: SeoData;
     'x-hideReplay'?: boolean;
+    [REDOCLY_TEAMS_RBAC]?: RbacScopeItems;
     'x-badges'?: OpenAPIXBadges[];
     'x-codeSamples'?: OpenAPIXCodeSample[];
-    [REDOCLY_TEAMS_RBAC]?: RbacScopeItems;
     requestValues?: OperationRequestValues;
 };
 export type MarkdownHeading = {
@@ -573,7 +574,6 @@ export type OpenApiBuildContext = {
     downloadUrls?: NormalizedDownloadUrl[];
     basePath: string;
     tagsMap: Map<string, TagData>;
-    hasTopLevelTags: boolean;
     collectedTagOrder: string[];
     storeCtx: StoreContext;
     badgeTags: OpenAPITag[];

package/lib/types/options.d.ts

@@ -1,7 +1,9 @@
-import type { AsyncApiConfig, GraphQLConfig, LayoutVariant, RedocConfig } from '@redocly/config';
+import type { LayoutVariant } from '@redocly/config';
+import type { RedocConfig } from '@redocly/config';
+import type { EditionAsyncApiConfig, EditionGraphQLConfig, EditionRedocConfig } from './edition-config.js';
 import type { ConfigFunction, Node, Schema } from '@markdoc/markdoc';
 import type { MarkdocTagSchema } from '@redocly/theme/markdoc/tags/types';
-import type { UserClaims } from '@redocly/theme/core/types';
+import type { UserClaims } from '@redocly/theme/core/openapi';
 import type { ConfigureRequestValues, ConfigureServerRequestValues } from '@redocly/theme/ext/configure';
 import type { ReactElement } from 'react';
 import type { ComponentType } from 'react';
@@ -9,8 +11,10 @@ import type { ApiSpecType, SidebarLogo } from './common.js';
 import type { ProtocolVariant } from './asyncapi.js';
 import type { GraphQLOptions } from './graphql.js';
 import type { Events } from './events.js';
+import type { CodeSamplesConfig } from './code-samples-config.js';
 import type { OpenAPIInfo, OpenAPIOperation as OpenAPIOperationType, OpenAPIParameter, OpenAPIServer, OpenAPITag } from './openapi.js';
 import type { Referenced } from './common.js';
+export type * from './code-samples-config.js';
 export type Operation = {
     id: string;
     path: string;
@@ -44,19 +48,30 @@ export type MarkdocOptions = {
  * host supplies the parser (the standalone build supplies a Markdoc-based one; see
  * `markdocParser`). It is the single seam where markdown text becomes an AST.
  */
-export type MarkdownParser = (markdown: string, sanitizeOptions?: Partial<Pick<ApiDocsOptions, 'sanitize' | 'unstable_hooks'>>) => Node | Node[] | undefined;
+export type MarkdownParser = (markdown: string, sanitizeOptions?: {
+    sanitize?: ApiDocsOptions['sanitize'];
+    unstable_hooks?: ApiDocsOptions['unstable_hooks'];
+}) => Node | Node[] | undefined;
 export type ApiDocsOptions = {
-    schemaDefinitionsTagName?: string;
     corsProxyUrl?: string;
+    hideInfoMetadata: boolean;
+    hideReplay: boolean;
+    oAuth2RedirectURI?: string;
+    showSchemaCatalogLinks?: boolean;
+    licenseKey?: string;
+    feedback: NonNullable<RedocConfig['feedback']>;
+    mockServer?: {
+        url: string;
+        position: 'first' | 'last' | 'replace' | 'off';
+        description: string;
+    };
+    schemaDefinitionsTagName?: string;
     jsonSamplesExpandLevel: number;
     generatedSamplesMaxDepth: number;
     hideDownloadButtons: boolean;
-    hideInfoMetadata: boolean;
     hideSchemaTitles: boolean;
     hideSchemaPattern: boolean;
     maxDisplayedEnumValues: number;
-    hideReplay: boolean;
-    oAuth2RedirectURI?: string;
     onlyRequiredInSamples: boolean;
     onDeepLinkClick: ((link: string) => void) | undefined | null;
     schemasExpansionLevel?: number;
@@ -72,33 +87,23 @@ export type ApiDocsOptions = {
     unstable_skipSamples?: boolean;
     unstable_externalCodeSamples: Unstable_ExternalCodeSample[];
     hidePropertiesPrefix: boolean;
-    showSchemaCatalogLinks?: boolean;
     dynamicRequestValues?: ConfigureRequestValues | ConfigureServerRequestValues;
     userClaims?: UserClaims;
     protocol?: ProtocolVariant;
     scrollYOffset: () => number;
     hideLoading: boolean;
     skipBundle: boolean;
-    hideSidebar: boolean;
     basePath: string;
     specType: ApiSpecType;
-    licenseKey?: string;
     metadata: ApiDocsMetadata;
     downloadUrls?: NormalizedDownloadUrl[];
     layout: LayoutVariant;
-    feedback: NonNullable<RedocConfig['feedback']>;
-    mockServer?: {
-        url: string;
-        position: 'first' | 'last' | 'replace' | 'off';
-        description: string;
-    };
     apiLogo?: SidebarLogo;
     jsonSamplesDepth: number;
     samplesMaxInlineArgs: number;
     fieldExpandLevel: number;
-    baseUrlPath?: string;
 } & GraphQLOptions;
-export type RawApiDocsOptions = RedocConfig & AsyncApiConfig & GraphQLConfig & {
+export type RawApiDocsOptions = EditionRedocConfig & EditionAsyncApiConfig & EditionGraphQLConfig & {
     specType: ApiSpecType;
     markdownParser: MarkdownParser;
     basePath?: string;
@@ -106,78 +111,10 @@ export type RawApiDocsOptions = RedocConfig & AsyncApiConfig & GraphQLConfig & {
     requiredPropsFirst?: boolean;
     licenseKey?: string;
     protocol?: ProtocolVariant;
-    excludeFromSearch?: boolean;
     dynamicRequestValues?: ConfigureRequestValues | ConfigureServerRequestValues;
     userClaims?: UserClaims;
-    layout?: RedocConfig['layout'] | AsyncApiConfig['layout'] | GraphQLConfig['layout'];
+    layout?: EditionRedocConfig['layout'] | EditionAsyncApiConfig['layout'] | EditionGraphQLConfig['layout'];
 };
-export type Languages = 'JavaScript' | 'Node.js' | 'curl' | 'Java8+Apache' | 'Java' | 'Python' | 'Go' | 'PHP' | 'C#' | 'C#+Newtonsoft' | 'Ruby' | 'R';
-export interface BasicLanguageOptions {
-    indent?: string;
-    withImports?: boolean;
-    withComments?: boolean;
-}
-interface CodeSampleBasicConfig {
-    lang: Languages | 'Payload';
-    label: string;
-    key: string;
-    options?: BasicLanguageOptions;
-}
-export interface CurlCodeSampleConfig extends CodeSampleBasicConfig {
-    lang: 'curl';
-    options?: BasicLanguageOptions & {
-        binary?: boolean;
-    };
-}
-export interface JavaScriptCodeSampleConfig extends CodeSampleBasicConfig {
-    lang: 'JavaScript';
-    options?: BasicLanguageOptions & {
-        credentials?: 'omit' | 'same-origin' | 'include';
-    };
-}
-export interface GoCodeSampleConfig extends CodeSampleBasicConfig {
-    lang: 'Go';
-}
-export interface NodeJsCodeSampleConfig extends CodeSampleBasicConfig {
-    lang: 'Node.js';
-}
-export interface PythonCodeSampleConfig extends CodeSampleBasicConfig {
-    lang: 'Python';
-}
-export interface Java8CodeSampleConfig extends CodeSampleBasicConfig {
-    lang: 'Java8+Apache';
-}
-export interface JavaCodeSampleConfig extends CodeSampleBasicConfig {
-    lang: 'Java';
-}
-export interface CSharpCodeSampleConfig extends CodeSampleBasicConfig {
-    lang: 'C#';
-}
-export interface CSharpNewtonsoftCodeSampleConfig extends CodeSampleBasicConfig {
-    lang: 'C#+Newtonsoft';
-}
-export interface PHPCodeSampleConfig extends CodeSampleBasicConfig {
-    lang: 'PHP';
-}
-export interface RubyCodeSampleConfig extends CodeSampleBasicConfig {
-    lang: 'Ruby';
-}
-export interface RCodeSampleConfig extends CodeSampleBasicConfig {
-    lang: 'R';
-}
-export interface PayloadCodeSampleConfig extends CodeSampleBasicConfig {
-    lang: 'Payload';
-}
-export interface CustomLanguageCodeSampleConfig extends Omit<CodeSampleBasicConfig, 'lang'> {
-    lang: string;
-}
-export type CodeSampleConfig = CurlCodeSampleConfig | JavaScriptCodeSampleConfig | NodeJsCodeSampleConfig | PythonCodeSampleConfig | Java8CodeSampleConfig | JavaCodeSampleConfig | CSharpCodeSampleConfig | CSharpNewtonsoftCodeSampleConfig | PHPCodeSampleConfig | GoCodeSampleConfig | RubyCodeSampleConfig | RCodeSampleConfig;
-export interface CodeSamplesConfig {
-    languages: (CodeSampleConfig | PayloadCodeSampleConfig | CustomLanguageCodeSampleConfig)[];
-    skipOptionalParameters?: boolean;
-    withOAuth2Call?: boolean;
-    onSampleTabClick?: (label: string) => void;
-}
 export type Normalized<T> = {
     [P in keyof T]-?: T[P];
 };
@@ -257,4 +194,3 @@ export type HooksConfig = {
     MiddlePanelFooter?: HookConfig<undefined>;
     MiddlePanelHeader?: HookConfig<undefined>;
 };
-export {};

package/lib/types/store.d.ts

@@ -1,4 +1,5 @@
-import type { ResolvedNavItem, REDOCLY_TEAMS_RBAC } from '@redocly/config';
+import type { ResolvedNavItem } from '@redocly/config';
+import type { REDOCLY_TEAMS_RBAC } from '@redocly/config';
 import type { DocumentNode } from 'graphql';
 import type { Node } from '@markdoc/markdoc';
 import type { ApiSpecType, Badge, BadgeData, ContentType, ItemVariant, SecuritySchemeIn, SecuritySchemeType, ServerData, SeoData, SidebarLogo } from './common.js';
@@ -80,7 +81,7 @@ export type ExampleEntry = {
     value: unknown;
     key?: string;
     summary?: string;
-    description?: string;
+    description?: string | Node | Node[];
     mediaType?: string;
     externalValue?: string;
     [REDOCLY_TEAMS_RBAC]?: Record<string, string>;

package/lib/url-compat.d.ts

@@ -0,0 +1,22 @@
+type LegacyUrl = {
+    protocol: string | null;
+    slashes: boolean;
+    auth: string | null;
+    host: string | null;
+    hostname: string | null;
+    port: string | null;
+    pathname: string | null;
+    search: string | null;
+    hash: string | null;
+    href: string;
+    format(): string;
+};
+export declare function parse(input: string): LegacyUrl;
+export declare function resolve(from: string, to: string): string;
+export declare function format(url: string | LegacyUrl): string;
+declare const _default: {
+    parse: typeof parse;
+    resolve: typeof resolve;
+    format: typeof format;
+};
+export default _default;

package/lib/url-compat.js

@@ -0,0 +1 @@
+const c=/^[a-z][a-z0-9+.-]*:\/\//i,o=s=>s?s.endsWith(":")?s:`${s}:`:"";function i(s){let t;if(c.test(s))try{t=new URL(s)}catch{t=void 0}if(!t){const a=s.indexOf("#"),r=a===-1?s:s.slice(0,a),l=r.indexOf("?");return{protocol:null,slashes:!1,auth:null,host:null,hostname:null,port:null,pathname:(l===-1?r:r.slice(0,l))||null,search:l===-1?null:r.slice(l),hash:a===-1?null:s.slice(a),href:s,format(){return`${o(this.protocol)}${this.pathname??""}${this.search??""}${this.hash??""}`}}}const e=t.username?t.password?`${t.username}:${t.password}`:t.username:null,n=/^[a-z][a-z0-9+.-]*:\/\/[^/?#]+(?:[?#]|$)/i.test(s)?"":t.pathname;return{protocol:t.protocol,slashes:!0,auth:e,host:t.host||null,hostname:t.hostname||null,port:t.port||null,pathname:n,search:t.search||null,hash:t.hash||null,href:t.href,format(){const a=this.auth?`${this.auth}@`:"";return`${o(this.protocol)}//${a}${this.host??""}${this.pathname}${this.search??""}${this.hash??""}`}}}function u(s){const t=[];for(const e of s.split("/")){if(e===".")continue;const h=t[t.length-1],n=t.length===1&&h==="";e===".."&&n||(e===".."&&t.length>0&&h!==".."?t.pop():t.push(e))}return t.join("/")}function f(s,t){try{return new URL(t,s).toString()}catch{}if(/^[a-z][a-z0-9+.-]*:/i.test(t))return t;if(s.startsWith("//"))try{return new URL(t,`http:${s}`).toString().replace(/^http:/,"")}catch{}if(t.startsWith("/"))return t;const e=t.search(/[?#]/),h=e===-1?t:t.slice(0,e),n=e===-1?"":t.slice(e);return h?u(s.replace(/[^/]*$/,"")+h)+n:s.replace(n.startsWith("?")?/[?#].*$/:/#.*$/,"")+n}function p(s){return typeof s=="string"?s:s.format()}var m={parse:i,resolve:f,format:p};export{m as default,p as format,i as parse,f as resolve};

package/lib/utils/compose.d.ts

@@ -4,4 +4,5 @@ export declare function compose<P>(f: HOC<P>): (Component: ComponentType<P>) =>
 export declare function compose<P>(f: HOC<P>, g: HOC<P>): (Component: ComponentType<P>) => FC<P>;
 export declare function compose<P>(f: HOC<P>, g: HOC<P>, h: HOC<P>): (Component: ComponentType<P>) => FC<P>;
 export declare function compose<P>(f: HOC<P>, g: HOC<P>, h: HOC<P>, i: HOC<P>): (Component: ComponentType<P>) => FC<P>;
+export declare function compose<P>(f: HOC<P>, g: HOC<P>, h: HOC<P>, i: HOC<P>, j: HOC<P>): (Component: ComponentType<P>) => FC<P>;
 export {};

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

@@ -112,6 +112,7 @@ export declare function isGraphqlDeepLinkAncestor(hash: string, path: string): b
  */
 export declare function getDeepLinkId(deepLink: string | undefined): string | undefined;
 export declare function appendVariantSuffix(fieldParentsName: string[] | undefined, suffix: string): string[];
+export declare function appendArraySuffix(fieldParentsName: 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
@@ -135,7 +136,7 @@ export declare function variantMarkersOnly(fieldParentsName: string[] | undefine
  * 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;
+export declare function extractDeepLinkParamFromHash(hash: string, key: 'c' | 'm' | 'ct' | 'ex'): string | undefined;
 /** Section name owning a callback's suffixes: `callbacks/<callbackId>[/…]`. */
 export declare const CALLBACKS_SECTION = "callbacks";
 /** Sub-section anchors a callback owns. Emitted by `CallbacksSection` and matched here, so

package/lib/utils/deep-link.js

@@ -1 +1 @@
-import{encodeBackSlashes as k,tryDecodeURIComponent as a}from"./string.js";import{joinWithSeparator as i,normalizePath as x,toElementId as S}from"./url.js";import{resolveRouteByPathname as A}from"./routing.js";function C(t){const e=[];for(const[n,r]of Object.entries(t))r!==void 0&&e.push(`${n}=${r}`);return e.join("&")}function g(t,e){return t=k(t).replace(/^\/+/,""),(`/${t}#`+i(t,e)).toLowerCase()}function D(t,e,n){const r=g(e,n);return x(i(t,r))}function h(t){const e=t.startsWith("#")?t.slice(1):t;return a(e).toLowerCase()}function b(t){const e=a(t),n=e.indexOf("#");return n>=0?e.slice(n+1):""}function j(t){return C({t:t.t,in:t.in,c:t.c,cb:t.cb,ct:t.ct,path:t.path})}function F(t,e,n){let r=t;return n&&(r=`${r}&c=${n}`),e&&(r=i(r,e)),r}function I(t){const{section:e,messageKey:n,subsection:r}=t;if(!n)return e;let o=`${e}&m=${n}`;return r&&(o+=`&t=${r}`),o}function M(t){return C({t:t.t,path:t.path,arg:t.arg,rt:t.rt})}function P(t,e){return!t||!e?!1:a(t.startsWith("#")?t.slice(1):t).toLowerCase().includes(`path=${e.toLowerCase()}.`)}function v(t){return t&&b(t)||void 0}function z(t,e){const n=[...t??[]];return n.length>0?n[n.length-1]+=e:n.push(e),n}const E=/&(?:oneof|d)=\d+/g;function H(t){return t.replace(E,"")}function q(t){return t.replace(/\[\]/g,"")}function G(t){return(t??[]).filter(e=>e.includes("&")).map(e=>e.slice(e.indexOf("&")))}function U(t,e){return t?a(t.startsWith("#")?t.slice(1):t).toLowerCase().match(new RegExp(`(?:^|[&/])${e}=([^/&]+)`))?.[1]:void 0}const O="callbacks",f=`${O}/`,w="callback-request",T="callback-response",R=[`/${w}`,`/${T}`];function p(t){const e=t.indexOf("path=");return e===-1?t:t.slice(0,e)}function V(t){return t.replace(`/${f}`,"/")}function L(t,e){const n=`cb=${e}`;return t.endsWith(n)||t.includes(`${n}&`)}function W(t,e){const n=`/${e}`;return t.endsWith(n)||t.includes(`${n}/`)}function y(t,e){return t===e||t.startsWith(`${e}/`)}function Q(t,e,n){if(!t||!e||!n)return!1;const r=h(t);if(!y(r,e))return!1;const o=p(r),c=n.toLowerCase();return L(o,c)||W(o,c)}function J(t,e,n){const r=p(t),o=n.toLowerCase();return r.startsWith(i(e,`${f}${o}/`))||r.startsWith(i(e,`${o}/`))||L(r,o)}function X(t,e){const n=p(t).slice(e.length);return!(n.startsWith(`/${f}`)||n.includes("cb=")||R.some(o=>n.includes(o)))}function N(t){const e=["#tag","#operation","#paths"];for(const n of e)if(t.includes(n))return t.replace(n,"").toLowerCase();return""}function Y(t,e,n){const r=h(t);if(!r)return;const o=x(i(e,r));if(A(n,o))return o;const c=N(t);if(!c)return;const l=c.split("/").filter(Boolean);for(let s=l.length;s>0;s--){const $="/"+l.slice(0,s).join("/"),u=n.allRoutes.find(m=>m.path.endsWith($));if(!u)continue;const d=l.slice(s).join("/");return d?`${u.path}#${i(S(u.path,e),d)}`:u.path}}export{O as CALLBACKS_SECTION,w as CALLBACK_REQUEST_SECTION,T as CALLBACK_RESPONSE_SECTION,z as appendVariantSuffix,I as buildAsyncApiSuffix,D as buildDeepLinkUrl,M as buildGraphqlSuffix,j as buildOpenApiFieldSuffix,F as buildOpenApiSectionSuffix,b as deepLinkToId,U as extractDeepLinkParamFromHash,v as getDeepLinkId,N as getLegacyHash,y as hashIsForItem,J as hashIsInsideCallback,X as hashIsOutsideCallbacks,Q as hashTargetsCallback,h as hashToElementId,P as isGraphqlDeepLinkAncestor,g as makeDeepLink,Y as resolveLegacyHashToRoute,C as serializeFieldParams,q as stripArrayMarkers,V as stripCallbacksSegment,H as stripVariantMarkers,G as variantMarkersOnly};
+import{encodeBackSlashes as g,tryDecodeURIComponent as a}from"./string.js";import{joinWithSeparator as i,normalizePath as x,toElementId as A}from"./url.js";import{resolveRouteByPathname as k}from"./routing.js";function h(t){const e=[];for(const[n,r]of Object.entries(t))r!==void 0&&e.push(`${n}=${r}`);return e.join("&")}function b(t,e){return t=g(t).replace(/^\/+/,""),(`/${t}#`+i(t,e)).toLowerCase()}function N(t,e,n){const r=b(e,n);return x(i(t,r))}function C(t){const e=t.startsWith("#")?t.slice(1):t;return a(e).toLowerCase()}function m(t){const e=a(t),n=e.indexOf("#");return n>=0?e.slice(n+1):""}function j(t){return h({t:t.t,in:t.in,c:t.c,cb:t.cb,ct:t.ct,path:t.path})}function F(t,e,n){let r=t;return n&&(r=`${r}&c=${n}`),e&&(r=i(r,e)),r}function I(t){const{section:e,messageKey:n,subsection:r}=t;if(!n)return e;let o=`${e}&m=${n}`;return r&&(o+=`&t=${r}`),o}function M(t){return h({t:t.t,path:t.path,arg:t.arg,rt:t.rt})}function v(t,e){return!t||!e?!1:a(t.startsWith("#")?t.slice(1):t).toLowerCase().includes(`path=${e.toLowerCase()}.`)}function z(t){return t&&m(t)||void 0}function H(t,e){const n=[...t??[]];return n.length>0?n[n.length-1]+=e:n.push(e),n}function q(t){return t.length===0?t:[...t.slice(0,-1),t[t.length-1]+"[]"]}const E=/&(?:oneof|d)=\d+/g;function G(t){return t.replace(E,"")}function U(t){return t.replace(/\[\]/g,"")}function V(t){return(t??[]).filter(e=>e.includes("&")).map(e=>e.slice(e.indexOf("&")))}function P(t,e){return t?a(t.startsWith("#")?t.slice(1):t).toLowerCase().match(new RegExp(`(?:^|[&/])${e}=(${e==="ct"?"[^&]+":"[^/&]+"})`))?.[1]:void 0}const O="callbacks",f=`${O}/`,w="callback-request",T="callback-response",R=[`/${w}`,`/${T}`];function p(t){const e=t.indexOf("path=");return e===-1?t:t.slice(0,e)}function Q(t){return t.replace(`/${f}`,"/")}function L(t,e){const n=`cb=${e}`;return t.endsWith(n)||t.includes(`${n}&`)}function W(t,e){const n=`/${e}`;return t.endsWith(n)||t.includes(`${n}/`)}function y(t,e){return t===e||t.startsWith(`${e}/`)}function J(t,e,n){if(!t||!e||!n)return!1;const r=C(t);if(!y(r,e))return!1;const o=p(r),c=n.toLowerCase();return L(o,c)||W(o,c)}function X(t,e,n){const r=p(t),o=n.toLowerCase();return r.startsWith(i(e,`${f}${o}/`))||r.startsWith(i(e,`${o}/`))||L(r,o)}function Y(t,e){const n=p(t).slice(e.length);return!(n.startsWith(`/${f}`)||n.includes("cb=")||R.some(o=>n.includes(o)))}function _(t){const e=["#tag","#operation","#paths"];for(const n of e)if(t.includes(n))return t.replace(n,"").toLowerCase();return""}function Z(t,e,n){const r=C(t);if(!r)return;const o=x(i(e,r));if(k(n,o))return o;const c=_(t);if(!c)return;const l=c.split("/").filter(Boolean);for(let s=l.length;s>0;s--){const $="/"+l.slice(0,s).join("/"),u=n.allRoutes.find(S=>S.path.endsWith($));if(!u)continue;const d=l.slice(s).join("/");return d?`${u.path}#${i(A(u.path,e),d)}`:u.path}}export{O as CALLBACKS_SECTION,w as CALLBACK_REQUEST_SECTION,T as CALLBACK_RESPONSE_SECTION,q as appendArraySuffix,H as appendVariantSuffix,I as buildAsyncApiSuffix,N as buildDeepLinkUrl,M as buildGraphqlSuffix,j as buildOpenApiFieldSuffix,F as buildOpenApiSectionSuffix,m as deepLinkToId,P as extractDeepLinkParamFromHash,z as getDeepLinkId,_ as getLegacyHash,y as hashIsForItem,X as hashIsInsideCallback,Y as hashIsOutsideCallbacks,J as hashTargetsCallback,C as hashToElementId,v as isGraphqlDeepLinkAncestor,b as makeDeepLink,Z as resolveLegacyHashToRoute,h as serializeFieldParams,U as stripArrayMarkers,Q as stripCallbacksSegment,G as stripVariantMarkers,V as variantMarkersOnly};

package/lib/utils/extract-extensions.js

@@ -1 +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};
+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,"x-usePkce":!0,"x-keywords":!0,"x-mcp":!0,"x-metadata":!0,"x-summary":!0,"x-tags":!0,"x-webhooks":!0};function a(r){return r in x}function n(r,t){return Object.keys(r).filter(e=>t===!0?e.startsWith("x-")&&!a(e):e.startsWith("x-")&&t.indexOf(e)>-1).reduce((e,u)=>(e[u]=r[u],e),{})}function i(r,t){return t===!1||t===void 0?{}:n(r,t)}export{n as extractExtensions,i as getExtensionsForDisplay,a as isRedocExtension};

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

@@ -0,0 +1 @@
+export { parse } from 'graphql';

package/lib/utils/graphql-parse.js

@@ -0,0 +1 @@
+import{parse as o}from"graphql";export{o as parse};

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

@@ -1,3 +1,4 @@
 /** 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. */
+ *  (response code, oneOf, media type, example selection). Call synchronously from
+ *  the state write. */
 export declare function keepReadingSectionAnchored(): void;

package/lib/utils/x-logo.d.ts

@@ -0,0 +1,13 @@
+type XLogo = {
+    url?: string;
+    href?: string;
+    altText?: string;
+    backgroundColor?: string;
+};
+export type LogoConfig = XLogo;
+/**
+ * Derives the sidebar logo config from the definition's `info['x-logo']`
+ * extension, falling back to `info.contact.url` for the link.
+ */
+export declare function logoFromDefinition(definition: Record<string, unknown> | string | undefined): LogoConfig | undefined;
+export {};

package/lib/utils/x-logo.js

@@ -0,0 +1 @@
+function e(n){if(typeof n=="string")return;const r=n?.info,o=r?.["x-logo"];if(!o?.url)return;const t=r?.contact;return{url:o.url,href:o.href||t?.url,altText:o.altText,backgroundColor:o.backgroundColor}}export{e as logoFromDefinition};

package/lib/yaml-compat.d.ts

@@ -0,0 +1,7 @@
+export declare const parse: (str: any) => unknown;
+export declare const stringify: (obj: any) => string;
+declare const _default: {
+    parse: typeof parse;
+    stringify: typeof stringify;
+};
+export default _default;

package/lib/yaml-compat.js

@@ -0,0 +1 @@
+import{dump as t,load as r}from"js-yaml";const p=o=>r(o),e=o=>t(o);var a={parse:p,stringify:e};export{a as default,p as parse,e as stringify};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redocly/api-docs",
-  "version": "0.2.0-next.0",
+  "version": "0.2.0-next.10",
   "description": "Redocly API Documentation Library",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE.md",
@@ -31,29 +31,33 @@
   },
   "dependencies": {
     "@markdoc/markdoc": "0.5.2",
-    "@redocly/openapi-core": "2.45.0",
+    "@redocly/allof-merge": "0.6.9",
+    "@redocly/config": "0.56.0",
+    "@redocly/openapi-core": "2.51.2",
+    "@redocly/redoc-opentelemetry": "0.2.4",
+    "@redocly/replay": "0.28.0-next.9",
+    "@redocly/theme": "^0.69.0-next.9",
     "dompurify": "3.4.13",
     "fast-xml-parser": "5.7.3",
     "graphql": "16.14.2",
+    "htmlparser2": "8.0.2",
     "jotai": "^2.16.2",
     "jotai-family": "1.0.1",
     "js-yaml": "4.3.1",
     "json-pointer": "^0.6.2",
     "linkedom": "^0.18.12",
-    "openapi-sampler": "^1.7.2",
+    "openapi-sampler": "^1.7.5",
     "prismjs": "1.30.0",
     "react-router": "^8.3.0",
     "slugify": "^1.4.7",
     "swagger2openapi": "^7.0.8",
     "url-template": "^2.0.8",
-    "web-vitals": "3.3.1",
-    "@redocly/config": "0.53.1",
-    "@redocly/redoc-opentelemetry": "0.2.2",
-    "@redocly/replay": "0.28.0-next.0",
-    "@redocly/theme": "^0.69.0-next.0",
-    "@redocly/allof-merge": "0.6.9"
+    "web-vitals": "3.3.1"
   },
   "devDependencies": {
+    "@microsoft/api-extractor": "7.58.2",
+    "@playwright/test": "1.60.0",
+    "@redocly/ajv": "8.18.0",
     "@testing-library/jest-dom": "6.6.3",
     "@testing-library/react": "16.3.0",
     "@types/js-yaml": "4.0.9",
@@ -63,11 +67,13 @@
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
     "@types/swagger2openapi": "^7.0.4",
-    "@vitejs/plugin-react-swc": "4.3.1",
-    "@vitest/browser-playwright": "4.1.10",
-    "@vitest/coverage-v8": "4.1.10",
+    "@vitejs/plugin-react": "6.0.1",
+    "@vitest/browser-playwright": "4.1.11",
+    "@vitest/coverage-v8": "4.1.11",
     "esbuild": "0.28.1",
+    "flexsearch": "^0.8.2",
     "globals": "^16.5.0",
+    "http-server": "14.1.1",
     "jest-styled-components": "7.2.0",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
@@ -76,10 +82,19 @@
     "tsx": "^4.20.6",
     "typescript": "6.0.3",
     "url": "~0.11.0",
-    "vite": "^7.2.4",
-    "vitest": "4.1.10",
+    "vite": "8.2.2",
+    "vitest": "4.1.11",
     "vitest-browser-react": "^2.0.2"
   },
+  "nx": {
+    "targets": {
+      "vitest:test": {
+        "dependsOn": [
+          "build"
+        ]
+      }
+    }
+  },
   "scripts": {
     "start": "vite --open /docs",
     "build": "pnpm run clean && pnpm run ts:check && pnpm run build:lib && pnpm run build:standalone && pnpm run build:minify",
@@ -89,10 +104,16 @@
     "analyze:bundle": "vite build --mode analyze",
     "watch": "tsgo -w -p tsconfig.build.json",
     "clean": "rimraf bundle lib",
+    "prepare:community-source": "tsx ./scripts/prepare-community-source.ts",
+    "prepare:community-dependencies": "tsx ./scripts/prepare-community-dependencies.ts",
+    "apply:community-source": "tsx ./scripts/apply-changes-from-community-source.ts",
+    "stage:ce": "pnpm run prepare:community-dependencies && pnpm run prepare:community-source",
+    "e2e:ce": "pnpm run stage:ce && cd redoc && REDOC_THEME_PATH=../../theme/src npm run e2e",
+    "lint:ce": "cd redoc && test -d src && test -d e2e && test -f vitest.setup.ts && find src e2e vitest.setup.ts -type f \\( -name '*.ts' -o -name '*.tsx' -o -name '*.cts' -o -name '*.mts' \\) -print0 | xargs -0 ./node_modules/.bin/oxlint --max-warnings=0",
     "test": "nx run vitest:test",
     "test:update": "nx run vitest:test -u --skip-nx-cache",
     "test:coverage:html": "nx run vitest:test --coverage --coverage.reporter=html --exclude 'tools/**'",
-    "test:tools": "vitest run tools",
+    "test:ce": "pnpm run stage:ce && cd redoc && npm run unit",
     "ts:check": "tsgo -p tsconfig.build.json --noEmit --skipLibCheck"
   }
 }

package/lib/services/code-samples/replay/normalize-servers.js

@@ -1 +0,0 @@
-import{isAbsoluteUrl as l,removeQueryStringAndHash as o,resolveUrl as s}from"../../../adapters/openapi/utils/helpers.js";import{getUrlDirname as i}from"../../../adapters/openapi/utils/url.js";import{IS_BROWSER as u}from"../../../utils/environments.js";function f(e){const t=o(e);if(!t||t.endsWith("/"))return t;const r=t.lastIndexOf("/");return r===-1?"":t.slice(0,r)}function a(e){return e===void 0?o((()=>{if(!u)return globalThis.SSR_HOSTNAME||"";const r=window.location.href;return r.endsWith(".html")&&i(r)||r})()):l(e)?i(e):f(e)}function m(e,t){const r=a(t);return r?s(r,e):e}function S(e,t){let r=t;return r.length===0&&(r=[{url:"/"}]),r.map(n=>({...n,url:m(n.url,e),description:n.description||""}))}export{S as normalizeServers,m as resolveServerUrl};