@redocly/redoc-reef 0.138.0-next.13 → 0.138.0-next.14

package/dist/server/plugins/get-api-config.js

@@ -1 +0,0 @@
-import*as n from"path";import{isL10nPath as u}from"../fs/utils/is-l10n-path.js";import{removeL10nPrefix as f}from"../fs/utils/remove-l10n-prefix.js";function d(i,e){for(const o of Object.values(i||{}))if(n.posix.normalize(o.root)===e)return{...o.theme,...o,theme:void 0};return{}}function g(i,e,o="."){const r=Object.values(i||{}),p=u(e)?f(e):e,c=n.posix.dirname(u(o)?f(o):o),s=t=>n.posix.normalize(n.posix.join(c,t.root))===p,m=r.find(t=>!t.output&&s(t))||{},a=r.filter(t=>t.output&&s(t));return[m,...a]}export{g as getAllApiConfigsByPath,d as getApiConfigByPath};

package/dist/server/plugins/get-reserved-routes.d.ts

@@ -1,22 +0,0 @@
-import type { RedoclyConfig } from '@redocly/config';
-type RouteReservationRule = {
-    slug: string;
-    isEnabled: (config: RedoclyConfig) => boolean;
-};
-export declare const RESERVED_ROUTES: {
-    mcp: string;
-    mcpPublic: string;
-};
-/**
- * Checks if a given route slug is reserved based on configuration.
- * A route is considered reserved if a rule for it is enabled, meaning the system serves
- * that slug: content pages cannot use it, and links to it resolve.
- *
- * @param slug - The route slug to check
- * @param config - The Redocly configuration
- * @param additionalRules - Optional additional rules to check
- * @returns true if the route is reserved, false otherwise
- */
-export declare function isRouteReserved(slug: string, config: RedoclyConfig, additionalRules?: RouteReservationRule[]): boolean;
-export {};
-//# sourceMappingURL=get-reserved-routes.d.ts.map

package/dist/server/plugins/get-reserved-routes.js

@@ -1 +0,0 @@
-import{MCP_ROUTE as i,PUBLIC_MCP_ROUTE as r}from"@redocly/theme/core/constants/mcp";import{EntitlementsProvider as m}from"../entitlements/entitlements-provider.js";import{getPublicMcpEndpointStatus as p}from"./mcp/utils/public-endpoint.js";const t={mcp:i,mcpPublic:r};function s(){return!!m.instance().canAccessFeature("mcp")}const E=[{slug:t.mcp,isEnabled:e=>!e?.mcp?.hide&&!e?.mcp?.docs?.hide&&s()},{slug:t.mcpPublic,isEnabled:e=>s()&&p(e)==="served"}];function l(e,n,o=[]){return[...E,...o].some(c=>c.slug===e&&c.isEnabled(n))}export{t as RESERVED_ROUTES,l as isRouteReserved};

package/dist/server/plugins/helpers/normalize-frontmatter-keywords.d.ts

@@ -1,40 +0,0 @@
-import type { FrontmatterKeywords } from '../../types';
-/**
- * Normalizes frontmatter keywords into a structured format with includes/excludes arrays.
- *
- * Validates that the input is an object containing at least one of `includes` or `excludes`
- * as non-empty arrays, then converts all values to strings.
- *
- * @param keywords - Raw keywords object from frontmatter
- * @returns Object with error message or normalized result
- *
- * @example
- * ```ts
- * // Valid with both fields
- * normalizeFrontmatterKeywords({
- *   includes: ['typescript', 'react'],
- *   excludes: ['deprecated']
- * });
- * // { error: null, result: { includes: ['typescript', 'react'], excludes: ['deprecated'] } }
- *
- * // Valid with only includes
- * normalizeFrontmatterKeywords({ includes: ['nodejs'] });
- * // { error: null, result: { includes: ['nodejs'], excludes: undefined } }
- *
- * // Invalid type
- * normalizeFrontmatterKeywords('invalid');
- * // { error: 'Keywords must be an object', result: null }
- *
- * // Empty arrays
- * normalizeFrontmatterKeywords({ includes: [], excludes: [] });
- * // { error: 'Keywords must contain at least one non-empty "includes" or "excludes" array', result: null }
- * ```
- */
-export declare function normalizeFrontmatterKeywords(keywords: unknown): {
-    error: string;
-    result: null;
-} | {
-    error: null;
-    result: FrontmatterKeywords;
-};
-//# sourceMappingURL=normalize-frontmatter-keywords.d.ts.map

package/dist/server/plugins/helpers/normalize-frontmatter-keywords.js

@@ -1 +0,0 @@
-import{isObject as l}from"../../../utils/guards/is-object.js";function t(e){const r={};if(!l(e))return{error:"Keywords must be an object",result:null};if("includes"in e){if(!Array.isArray(e.includes))return{error:'Property "includes" must be an array',result:null};e.includes.length>0&&(r.includes=[...new Set(e.includes.map(n=>String(n)))])}if("excludes"in e){if(!Array.isArray(e.excludes))return{error:'Property "excludes" must be an array',result:null};e.excludes.length>0&&(r.excludes=[...new Set(e.excludes.map(n=>String(n)))])}return r.excludes||r.includes?{error:null,result:r}:{error:"Keywords must have at least one non-empty array (includes or excludes)",result:null}}export{t as normalizeFrontmatterKeywords};

package/dist/server/plugins/l10n/index.d.ts

@@ -1,3 +0,0 @@
-import type { LifecyclePluginInstance } from '../../types';
-export declare function l10nPlugin(): Promise<LifecyclePluginInstance>;
-//# sourceMappingURL=index.d.ts.map

package/dist/server/plugins/l10n/index.js

@@ -1 +0,0 @@
-import g from"path";import{DEFAULT_LOCALE_PLACEHOLDER as d,TRANSLATIONS_FILE_NAME as h}from"../../../constants/common.js";import{I18N_DIR_NAME as y,L10N_DIR_NAME as A}from"../../constants/common.js";import{logger as m}from"../../tools/notifiers/logger.js";import{reporter as w}from"../../tools/notifiers/reporter.js";import{EntitlementsProvider as O}from"../../entitlements/entitlements-provider.js";import{isL10nPath as E}from"../../fs/utils/is-l10n-path.js";import{isOpenapiDoc as I}from"../api-docs/utils/is-api-doc.js";import{telemetryTraceStep as N}from"../../../cli/telemetry/helpers/trace-step.js";async function $(){return{id:"l10n",async processContent(n,i){await N("com.redocly.build.plugin.l10n",async a=>{const{fs:t,cache:c,getConfig:r}=i,e={},p=O.instance(),l=await r();a?.setAttribute("config",JSON.stringify(l.l10n||{}));const s=l.l10n?.defaultLocale||d;if(p.canAccessFeature("l10n")){await F(i);for(const{relativePath:o}of t.scan(/(?:^|[/\\])translations\.yaml$/)){const u=await c.load(o,"yaml"),L=P(o)||s;e[L]={translation:u.data||{}}}}e[s]={translation:{...e[s]?.translation||{}}};const f=l.l10n?.locales||[d,...t.localeFolders].map(o=>({code:o.toLowerCase(),name:o}));a?.setAttribute("locales",JSON.stringify(f)),n.setGlobalData({l10n:{translations:e,defaultLocale:s,locales:f.map(o=>({code:o.code,name:o.name||o.code}))}})})}}}function P(n){return n.indexOf("/")>0?n.split("/")[1]:void 0}async function F(n){const i=n.fs.scan();for(const{isVirtual:a,realRelativePath:t}of i){if(a)continue;if(E(t)&&t.endsWith(".page.tsx")&&await w.panicOnBuild(`The file %rp is not allowed in ${A} or ${y} folders`,t),g.posix.basename(t)===h){const r=/^(?:@(i18n|l10n)[/\\][^/\\]+[/\\])?translations\.yaml$/.test(t),e=await I(t,n);!r&&!e&&m.warn("The file %rp is in the wrong location. Make sure it is located in the root directory or in the locale root directory.",t),r&&e&&m.warn("It looks like the file %rp might be an OpenAPI definition and is located in a location reserved for translation files. Please rename it or move to another directory if it is not a translations file",t)}}}export{$ as l10nPlugin};

package/dist/server/plugins/lifecycle.d.ts

@@ -1,15 +0,0 @@
-import type { Store } from '../store';
-import type { LifecyclePluginInstance, PluginOptions, LifecycleContext, LifecyclePluginCreator, LifecyclePlugin } from '../types';
-import { Cache } from '../fs/cache.js';
-import { ContentFs } from '../fs/content-fs.js';
-export declare const INTERNAL_PLUGINS: LifecyclePluginCreator[];
-export declare function initPlugins(options: PluginOptions, internalPlugins?: LifecyclePlugin[]): Promise<{
-    pluginInstances: LifecyclePluginInstance[];
-    lifecycleContext: LifecycleContext;
-}>;
-export declare function writeClientEntries(store: Store): void;
-export declare function runPlugins(pluginInstances: LifecyclePluginInstance[], store: Store, context: LifecycleContext, options?: {
-    failFast?: boolean;
-}): Promise<void>;
-export declare function createLifecycleContext(fs: ContentFs, cache: Cache): LifecycleContext;
-//# sourceMappingURL=lifecycle.d.ts.map

package/dist/server/plugins/lifecycle.js

@@ -1,2 +0,0 @@
-import B from"@redocly/portal-plugin-mock-server";import{REDOCLY_ROUTE_RBAC as x}from"@redocly/config";import{combineUrls as E,withPathPrefix as L}from"@redocly/theme/core/utils";import{VERSION_SEPARATOR as k}from"../constants/common.js";import{removeTrailingSlash as N}from"../../utils/url/remove-trailing-slash.js";import{removeLeadingSlash as j}from"../../utils/url/remove-leading-slash.js";import{isTruthy as $}from"../../utils/guards/is-truthy.js";import{normalizeRouteSlug as D}from"../../utils/path/normalize-route-slug.js";import{parsePathVersions as V}from"../../utils/path/parse-path-versions.js";import{reporter as v}from"../tools/notifiers/reporter.js";import{logger as P}from"../tools/notifiers/logger.js";import{envConfig as S}from"../config/env-config.js";import{shaDirPathShort as M}from"../utils/crypto/sha-dir-path-short.js";import{writeServerRebuildTrigger as _,generateBrowserPluginsModule as q,generateClientRoutes as z,generateTemplatesModule as H}from"../esbuild/generate.js";import{customPagesPlugin as U}from"../../server/plugins/pages/index.js";import{apiDocsPlugin as G}from"../../server/plugins/api-docs/index.js";import{configParserPlugin as I}from"./config-parser/index.js";import{createSlugify as W}from"./create-slugify.js";import{markdownPlugin as K}from"./markdown/index.js";import{searchPlugin as Y}from"./search/index.js";import{skillsPlugin as J}from"./skills/index.js";import{defaultThemePlugin as Q}from"./default-theme/index.js";import{apiKeyMgmtPlugin as X}from"./dev-onboarding/index.js";import{apiFunctionsPlugin as Z}from"./api-functions/index.js";import{scorecardClassicPlugin as ee}from"./scorecard-classic/index.js";import{lintPlugin as te}from"./lint/index.js";import{resolveExternalPlugins as oe}from"../external-plugins/resolve-external-plugins.js";import{sidebarsPlugin as ie}from"./sidebars/index.js";import{l10nPlugin as re}from"./l10n/index.js";import{validateRedirects as ne}from"../utils/redirects/validate-redirects.js";import{analyticsPlugins as se}from"./analytics/index.js";import{consentPlugin as ae}from"./consent/index.js";import{sitemapPlugin as le}from"./sitemap/index.js";import{entitlementsPlugin as ce}from"./entitlements/index.js";import{getBilledPagesCount as ue}from"../utils/index.js";import{telemetry as fe}from"../../cli/telemetry/index.js";import{telemetryTraceStep as b}from"../../cli/telemetry/helpers/trace-step.js";import{EntitlementsProvider as A}from"../entitlements/entitlements-provider.js";import{enforceLoginPlugin as me}from"./enforce-login/index.js";import{ssoPlugin as de}from"./sso/index.js";import{Cache as ge}from"../fs/cache.js";import{ContentFs as pe}from"../fs/content-fs.js";import{findProductBySlug as Pe}from"../utils/product.js";import{isRouteReserved as ye}from"./get-reserved-routes.js";import{catalogClassicPlugin as he}from"./catalog-classic/index.js";import{arazzoDocsPlugin as Re}from"./arazzo-docs/index.js";const Ce=[I,me,de,Q,re,K,G,Re,ee,te,Z,U,X,he,{importPath:"./catalog-entities/plugin.js",loadCondition:()=>S.NEW_CATALOG_ENABLED??!1},{importPath:"./scorecards/plugin.js",loadCondition:()=>S.NEW_SCORECARDS_ENABLED??!1},{importPath:"./mcp/index.js",loadCondition:()=>A.instance().canAccessFeature("mcp")},ie,le,ce,Y,J,B,ae,...se];async function Pt(t,e=Ce){return await b("com.redocly.build.pluginsInit",async()=>{const r=[],R=A.instance(),y={};for(const s of e){let u;if("loadCondition"in s){if(!s.loadCondition())continue;const i=await import(s.importPath);if(!i.default||typeof i.default!="function"){await v.panicOnBuild(`Dynamic plugin ${s.importPath} does not export a default export or it is not a function`);continue}u=i.default}else u=s;const h=await u(t);for(const[i,f]of Object.entries(h.loaders||{}))y[i]&&await v.panicOnBuild(`Duplicate loader with name ${i}`),y[i]=f;(!h.requiredEntitlements||h.requiredEntitlements?.every(i=>R.canAccessFeature(i)))&&r.push(h)}const l=new pe(t.contentDir);await l.ready;const c=new ge(l);return c.setLoaders(y),P.verbose("All plugins instantiated"),{pluginInstances:r,lifecycleContext:be(l,c)}})}function O(t){P.verbose("Generating templates"),b("com.redocly.build.writeClientEntries",()=>{H(t),q(t),z(t)})}async function ve(t){const e=t.getAllRoutes();ue(e)||await v.panicOnBuild("No routes created by plugins. Please check your project configuration.")}async function yt(t,e,r,R={}){const y=A.instance();try{await b("com.redocly.build.pluginsRun",async()=>{e.startPluginsRun();const l=S.isDevelopMode&&e.buildRevision>0,c=l?F(e):"";let s=[];await b("com.redocly.build.pluginsProcessContent",async i=>{for(const o of t){const a=P.startTiming();await o.processContent?.(e,r),P.verboseTime(a,`processContent for ${o.id}`)}s=(await oe(e.contentDir,e.config.plugins)).map(o=>o.lifecyclePlugin).filter(o=>$(o)&&(!o.requiredEntitlements||o.requiredEntitlements?.every(a=>y.canAccessFeature(a)))),r.cache.setLoaders(Object.fromEntries(s.flatMap(o=>Object.entries(o.loaders||{}))));for(const o of s){const a=P.startTiming();await o.processContent?.(e,r),P.verboseTime(a,`processContent for ${o.id}`)}i?.setAttribute("externalPluginsProcessed",s.length.toString())});const u=await we(e,r),h=[...t,...s];O(e),S.isDevelopMode?await e.userCodeReady:e.buildRevision++,await b("com.redocly.build.pluginsAfterRoutesCreated",async()=>{for(const i of h){const f=P.startTiming();await i.afterRoutesCreated?.(e,u),P.verboseTime(f,`afterRoutesCreated for ${i.id}`)}}),ne(e),await e.reportUnsetEnvVars(),await ve(e),O(e),l&&c!==F(e)&&(e.markRequestHandlersEntryOutdated(),_(e.serverOutDir))})}catch(l){const c="Unhandled error in plugin. "+l.message+`
-`+l.stack;fe.sendCliErrorCaughtMessage([{id:"cli",object:"error",uri:"urn:redocly:realm:cli:error:cli",message:c}]),R.failFast?await v.panic(c):await v.panicOnBuild(c)}finally{e.finishPluginsRun()}}async function we(t,e){const{cache:r,fs:R}=e,y=await e.getConfig(),l=Object.values(y.products||{}),c=(await r.load("versions-config","versions-config")).data,s=(await r.load("content-slugs","content-slugs")).data,u=W(s);for(const{duplicateInAllLocales:i,slugSuffix:f,sharedData:o=[],redirectFrom:a=[],...d}of t.newRoutes){const w=D(d.slug?d.slug:u(d.fsPath)),g=N(f?E(w,f):w),n={...d,[x]:{slug:g,fsPath:d.fsPath},slug:g,baseSlug:w,versions:h(d.fsPath,f),product:Pe(l,g,u)};ye(g,y)&&await v.panicOnBuildContentError(`Route "${g}" is reserved and cannot be used. Please choose a different slug for "${d.fsPath}".`),t.routesByFsPath.set(n.fsPath,n.slug),t.routesBySlug.set(n.slug,n);for(const{key:p,id:m}of o)t.addRouteSharedData(n.slug,p,m);for(const p of a)t.addRedirect(p.from,{type:p.type,to:n.slug});if(i)for(const p of R.localeFolders){const m={...n,slug:"/"+p.toLowerCase()+n.slug};t.routesByFsPath.set(m.fsPath,m.slug),t.routesBySlug.set(m.slug,m);for(const{key:C,id:T}of o)t.addRouteSharedData(m.slug,C,T);for(const C of a){const T=E(R.localizationFolder,p,C.from);t.addRedirect(T,{type:C.type,to:m.slug},{trackOriginalSource:!1})}}}return t.newRoutes=[],{...e,slugify:u};function h(i,f=""){const o=V(i);if(!o?.versionName)return;const{versionFolderPath:a,filePathInVersion:d,versionName:w}=o,g=c.get(a);if(g)return g.versions.map(n=>{const p=g.defaultVersion===n.version,m=j(E(a,k+n.version,d)),C=u(m);return{version:n.version,label:n.name||n.version,link:D(E(C,f)),default:p,active:w===n.version,folderId:M(`${a}`)}})}}function be(t,e){return{fs:t,cache:e,getConfig:async(r=".")=>(await e.load(r,"nearest-redocly-config",t.localeFolders)).data,isPathIgnored:async r=>(await e.load(r,"is-ignored")).data,withPathPrefix:L,logger:P}}function F(t){return[...t.apiRoutesRequestHandlers.keys(),...t.getMcpTools().map(e=>`${e.name}:${e.importPath}`)].sort().join(",")}export{Ce as INTERNAL_PLUGINS,be as createLifecycleContext,Pt as initPlugins,yt as runPlugins,O as writeClientEntries};

package/dist/server/plugins/lint/index.d.ts

@@ -1,3 +0,0 @@
-import type { LifecyclePluginInstance } from '../../types';
-export declare function lintPlugin(): Promise<LifecyclePluginInstance>;
-//# sourceMappingURL=index.d.ts.map

package/dist/server/plugins/lint/index.js

@@ -1 +0,0 @@
-import{scorecardClassicPlugin as i}from"../scorecard-classic/index.js";async function t(){return await i({id:"lint",requiredEntitlements:["lint"],loadersPrefix:"lint-"})}export{t as lintPlugin};

package/dist/server/plugins/markdown/attribute-resolvers/code-walkthrough/file-chunk-parser.d.ts

@@ -1,6 +0,0 @@
-import type { CodeWalkthroughNode, CodeWalkthroughFileMetadata } from '@redocly/theme/core/types';
-export declare function parseFileChunks(text: string, filePath: string): Promise<{
-    root: CodeWalkthroughNode[];
-    metadata: CodeWalkthroughFileMetadata;
-}>;
-//# sourceMappingURL=file-chunk-parser.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/code-walkthrough/file-chunk-parser.js

@@ -1,2 +0,0 @@
-import{isObject as k}from"../../../../../utils/guards/is-object.js";import{reporter as a}from"../../../../tools/notifiers/reporter.js";async function O(u,s){const h=u.split(`
-`),c=[],n=[],l={steps:[]},d=/chunk\s*\{(.*)\}/,g=/(?:^|\s)@chunk-end(?!\S)/;for(let e=0;e<h.length;e++){const i=h[e],p=i.match(d);if(p){let t,r=p[1];try{t=JSON.parse(`{${r}}`)}catch{try{r=r.replace(/\}\s*\*\/$/,""),t=JSON.parse(`{${r}}`)}catch(f){await a.panicOnBuildContentError(`Invalid format of the @chunk tag at ${e+1} in ${s}. It should be a valid JSON object. ${f}`),t={steps:[]}}}k(t)||(await a.panicOnBuildContentError(`Invalid format of the @chunk tag at ${e+1} in ${s}. It should be a valid JSON object.`),t={steps:[]}),t.steps&&!Array.isArray(t.steps)&&(await a.panicOnBuildContentError(`Invalid format of the @chunk tag at ${e+1} in ${s}. "steps" should be an array of strings.`),t={...t,steps:[]}),t.steps?l.steps.push(...t.steps):t.steps=[];const o={start:e,condition:t,children:[]};n.length>0?n[n.length-1].children.push(o):c.push(o),n.push(o)}else g.test(i)?n.length>0?n.pop():await a.panicOnBuildContentError(`Unmatched closing tag '@chunk-end' at line ${e+1} in ${s}`):n.length>0?n[n.length-1].children.push(i):c.push(i)}if(n.length>0){let e;for(;e=n.pop();)await a.panicOnBuildContentError(`Unmatched opening tag '@chunk' at line ${e.start+1} in ${s}`)}return{root:c,metadata:l}}export{O as parseFileChunks};

package/dist/server/plugins/markdown/attribute-resolvers/code-walkthrough/filesets-resolver.d.ts

@@ -1,4 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext } from '../../../../types';
-export declare function resolveCodeWalkthroughFilesets(node: Node, attributeName: string, pageRelativePath: string, markdocResolveContext: MarkdocResolveContext): Promise<void>;
-//# sourceMappingURL=filesets-resolver.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/code-walkthrough/filesets-resolver.js

@@ -1 +0,0 @@
-import c from"node:path";import v from"is-glob";import m from"picomatch";import{getNodeAttribute as h}from"../../../../../markdoc/helpers/get-node-attribute.js";import{setNodeAttributeValue as d}from"../../../../../markdoc/helpers/set-node-attribute-value.js";import{parseFileChunks as b}from"./file-chunk-parser.js";import{readFileContent as g}from"../../read-file-content.js";import{resolvePathInMarkdown as x}from"../../resolve-path-in-markdown.js";import{removeL10nPrefix as P}from"../../../../fs/utils/remove-l10n-prefix.js";import{mapFileExtensionToLanguage as k}from"./map-file-extension-to-language.js";async function V(a,f,p,u){const{actions:{contentDir:F},context:{fs:i}}=u,n=h(a,f);if(!Array.isArray(n))d(a,"resolvedFilesets",[]);else{const w=await Promise.all(n.map(async e=>{const s=Array.isArray(e.files)?e.files:[],o=Array.isArray(e.downloadAssociatedFiles)?e.downloadAssociatedFiles:[],r=await Promise.all(s.map(l)),t=await Promise.all(o.map(l));return{...e,files:r.flat(),downloadAssociatedFiles:t.flat()}}));d(a,"resolvedFilesets",w.filter(e=>!!e));async function l(e){const s=x(e,P(p),F),o=await A(s);return(await Promise.all(o.map(y))).filter(t=>t!==null)}async function A(e){if(!v(e))return[e];const{base:s}=m.scan(e);return i.scan(new RegExp(s)).filter(({isVirtual:t})=>!t).map(({realRelativePath:t})=>t).filter(t=>m(e)(t))}async function y(e){const s=await g(e,i);if(s==null)return null;const{root:o,metadata:r}=await b(s,e);return{path:e,content:o,metadata:r,basename:c.basename(e),language:k(c.extname(e))}}}}export{V as resolveCodeWalkthroughFilesets};

package/dist/server/plugins/markdown/attribute-resolvers/code-walkthrough/map-file-extension-to-language.d.ts

@@ -1,5 +0,0 @@
-/**
- * Maps file extension to a language for shiki highlighting in the code panel
- */
-export declare function mapFileExtensionToLanguage(ext: string): "markdoc" | import("shiki").BundledLanguage;
-//# sourceMappingURL=map-file-extension-to-language.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/code-walkthrough/map-file-extension-to-language.js

@@ -1 +0,0 @@
-const s={".md":"markdoc",".js":"javascript",".mjs":"javascript",".cjs":"javascript",".ts":"typescript",".jsx":"jsx",".tsx":"tsx",".sh":"bash",".bash":"bash",".c":"c",".h":"c",".cpp":"c",".cs":"csharp",".css":"css",".go":"go",".gql":"graphql",".graphql":"graphql",".graphqls":"graphql",".html":"html",".java":"java",".lua":"lua",".m":"objective-c",".pl":"perl",".cgi":"perl",".php":"php",".py":"python",".rb":"ruby",".sc":"scala",".scala":"scala",".sql":"sql",".swift":"swift",".xml":"xml",".wsdl":"xml",".vim":"vim",".yaml":"yaml",".yml":"yaml",".kt":"kotlin"};function l(a){return s[a]||"text"}export{l as mapFileExtensionToLanguage};

package/dist/server/plugins/markdown/attribute-resolvers/helpers/dereference-json-schema-refs.d.ts

@@ -1,14 +0,0 @@
-import { type NormalizedProblem } from '@redocly/openapi-core';
-import type { ContentFs } from '../../../../fs/content-fs.js';
-type Opts = {
-    schemaOrRef: unknown;
-    fs: ContentFs;
-    filePath: string;
-};
-export declare function dereferenceJsonSchemaRefs({ schemaOrRef, filePath, fs }: Opts): Promise<{
-    schema: unknown;
-    oas: unknown;
-    problems: NormalizedProblem[];
-} | undefined>;
-export {};
-//# sourceMappingURL=dereference-json-schema-refs.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/helpers/dereference-json-schema-refs.js

@@ -1 +0,0 @@
-import f from"node:path";import{bundle as m,createConfig as d,Source as l}from"@redocly/openapi-core";import{ExternalResolver as u}from"../../../../fs/utils/external-ref-resolver.js";async function h({schemaOrRef:e,filePath:n,fs:c}){if(typeof e!="object"||!e)return;const a={config:await d({}),base:f.dirname(n),doc:{source:new l(n,""),parsed:JSON.parse(JSON.stringify({openapi:"3.1.0",components:{schemas:{__root:e}}}))},externalRefResolver:new u(c)},{bundle:{parsed:p},problems:i}=await m(a),s=p,o=s?.components?.schemas,r=o?.__root?.$ref,t=typeof r=="string"?r.split("/").at(-1):void 0;return{schema:t?o?.[t]:o?.__root,problems:i,oas:s}}export{h as dereferenceJsonSchemaRefs};

package/dist/server/plugins/markdown/attribute-resolvers/helpers/generate-sample-from-schema.d.ts

@@ -1,62 +0,0 @@
-type GenerateSampleOptions = Partial<{
-    mode: 'read' | 'write';
-    spec: object;
-}>;
-/**
- * Generates a sample JSON value from a JSON Schema using openapi-sampler.
- *
- * @param schema - A JSON Schema object to generate a sample from.
- *   Must be a plain JavaScript object (not null, array, or primitive).
- *
- * @param options - Optional configuration for sample generation.
- *   - `mode`: Filter properties by read/write semantics (`'read'` | `'write'`).
- *   - `spec`: Full OpenAPI specification, required if schema contains `$ref` references.
- *
- * @returns An object containing either the generated value or an error message.
- *   - `value`: The generated sample (object or array), or `null` if generation failed.
- *   - `error`: A descriptive error message if generation failed, or `null` on success.
- *
- * @example
- * // Basic object schema
- * generateSampleFromSchema({
- *   type: 'object',
- *   properties: { name: { type: 'string' } }
- * });
- * // Returns: { value: { name: 'string' }, error: null }
- *
- * @example
- * // Using read mode to exclude writeOnly properties
- * generateSampleFromSchema(
- *   {
- *     type: 'object',
- *     properties: {
- *       id: { type: 'integer', readOnly: true },
- *       password: { type: 'string', writeOnly: true }
- *     }
- *   },
- *   { mode: 'read' }
- * );
- * // Returns: { value: { id: 0 }, error: null }
- *
- * @example
- * // Schema with $ref requires spec
- * generateSampleFromSchema(
- *   { $ref: '#/components/schemas/User' },
- *   { spec: openApiDocument }
- * );
- *
- * @example
- * // Empty schema returns error
- * generateSampleFromSchema({ type: 'object' });
- * // Returns: { value: null, error: 'Invalid JSON Schema: schema must include properties, items, allOf/anyOf/oneOf, or example/enum/const/default' }
- *
- * @remarks
- * - Primitive schemas (`type: 'string'`, `type: 'integer'`, etc.) are not supported.
- * - See `../__tests__/generate-sample-from-schema.test.ts` for comprehensive usage examples.
- */
-export declare function generateSampleFromSchema(schema: unknown, options?: GenerateSampleOptions): {
-    value: unknown;
-    error: string | null;
-};
-export {};
-//# sourceMappingURL=generate-sample-from-schema.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/helpers/generate-sample-from-schema.js

@@ -1,2 +0,0 @@
-import i from"@redocly/ajv";import*as s from"openapi-sampler";import{isObject as t}from"../../../../../utils/guards/is-object.js";function p(a,o){if(!t(a))return{value:null,error:"Invalid JSON Schema: schema must be a plain object."};const{mode:l,spec:u}=o??{};let e;try{e=s.sample(a,{...l==="read"?{skipWriteOnly:!0}:void 0,...l==="write"?{skipReadOnly:!0}:void 0},u)}catch(r){return{value:null,error:`Failed to generate sample from schema. Spec is required for schemas with $ref: ${r?.message||""}`}}if(e==null||t(e)&&Object.keys(e).length===0||Array.isArray(e)&&e.length===1&&e[0]===null){const r=new i({}),n=r.validateSchema(a);return typeof n!="boolean"?{value:null,error:"Invalid JSON Schema: Async schemas are not supported."}:!n&&r.errors?.length?{value:null,error:`Invalid JSON Schema: ${r.errorsText(r.errors,{separator:`
-`})}`}:{value:e,error:null}}return{value:e,error:null}}export{p as generateSampleFromSchema};

package/dist/server/plugins/markdown/attribute-resolvers/helpers/load-openapi-bundle.d.ts

@@ -1,9 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { OpenAPIDefinition, RawApiDocsOptions } from '@redocly/api-docs';
-import type { LifecycleContext } from '../../../../types';
-export type OpenapiBundle = {
-    definition: OpenAPIDefinition;
-    rawOptions: RawApiDocsOptions;
-};
-export declare function loadOpenapiBundle(node: Node, context: LifecycleContext): Promise<OpenapiBundle | undefined>;
-//# sourceMappingURL=load-openapi-bundle.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/helpers/load-openapi-bundle.js

@@ -1 +0,0 @@
-import{API_DOCS_SHARED_DATA_PREFIX as r}from"../../../../constants/plugins/api-docs.js";import{getNodeAttribute as p}from"../../../../../markdoc/helpers/get-node-attribute.js";import{logger as s}from"../../../../tools/notifiers/logger.js";async function l(i,a){const e=p(i,"descriptionFile");if(typeof e!="string"||!e.startsWith(r))return;const o=e.slice(r.length);try{const{data:t}=await a.cache.load(o,"api-doc"),n=t?.find(d=>d.type==="openapi");return n?{definition:n.document,rawOptions:n.options}:void 0}catch(t){s.verbose(`Failed to load OpenAPI definition ${o} for the ${i.tag} tag: ${t instanceof Error?t.message:"Unknown error"}`);return}}export{l as loadOpenapiBundle};

package/dist/server/plugins/markdown/attribute-resolvers/index.d.ts

@@ -1,8 +0,0 @@
-import type { MarkdocResolveContext, WithOriginalAttr } from '../../../types';
-import type { Node } from '@markdoc/markdoc';
-type ResolverFunction = (node: WithOriginalAttr<Node>, attrName: string, relativePath: string, context: MarkdocResolveContext) => Promise<{
-    sharedDataId?: string;
-} | undefined | void>;
-export declare const attributeResolvers: Record<string, ResolverFunction>;
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/index.js

@@ -1 +0,0 @@
-import{resolveOpenApiRef as e}from"./resolve-open-api-ref.js";import{resolveJsonSchemaRef as o}from"./resolve-json-schema-ref.js";import{resolveParsedYaml as r}from"./resolve-parsed-yaml.js";import{resolveRawContent as m}from"./resolve-raw-content.js";import{resolveSvgContent as t}from"./resolve-svg-content.js";import{resolveRelativePath as i}from"./resolve-relative-path.js";import{resolveLink as l}from"./resolve-link.js";import{resolveNativeMdLink as p}from"./resolve-native-md-link.js";import{resolveCodeSnippetFromFile as s}from"./resolve-code-snippet-from-file.js";import{resolveDiagramFromFile as a}from"./resolve-diagram-from-file.js";import{resolveHtmlSourceAttribute as n}from"./resolve-html-source-attribute.js";import{resolveHtmlHref as v}from"./resolve-html-href.js";import{resolveImageSrc as f}from"./resolve-image-src.js";import{resolveImageSrcSet as S}from"./resolve-image-src-set.js";import{resolveImageGallery as c}from"./resolve-image-gallery.js";import{resolveNavLinks as d}from"./resolve-nav-links.js";import{resolveRelativeOrCdnIcon as g}from"./resolve-relative-or-cdn-icon.js";import{resolveCodeWalkthroughFilesets as h}from"./code-walkthrough/filesets-resolver.js";import{resolveJsonExampleRef as R}from"./resolve-json-example-ref.js";import{resolveSampleFromJsonSchema as C}from"./resolve-sample-from-json-schema.js";import{resolveOpenapiCodeSamples as F}from"./resolve-openapi-code-samples.js";import{resolveOpenapiResponseSamples as k}from"./resolve-openapi-response-samples.js";const B={openapiRef:e,jsonSchemaRef:o,parsedYaml:r,rawContent:m,svgContent:t,relativePath:i,link:l,nativeMdLink:p,codeSnippetFile:s,diagramFile:a,htmlSourceAttribute:n,htmlHref:v,imageSrc:f,imageSrcSet:S,imageGallery:c,navLinks:d,relativeOrCdnIcon:g,codeWalkthroughFilesets:h,jsonExampleRef:R,sampleFromJsonSchema:C,openapiCodeSamples:F,openapiResponseSamples:k};export{B as attributeResolvers};

package/dist/server/plugins/markdown/attribute-resolvers/md-resolve-error.d.ts

@@ -1,16 +0,0 @@
-import type { BrokenLinkType } from '../../../../types/index.js';
-export declare class MdResolveError extends Error {
-    meta: {
-        rawLink: string;
-        link?: string;
-        title?: string;
-        brokenLinkType?: BrokenLinkType;
-    };
-    constructor(message: string, meta: {
-        rawLink: string;
-        link?: string;
-        title?: string;
-        brokenLinkType?: BrokenLinkType;
-    });
-}
-//# sourceMappingURL=md-resolve-error.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/md-resolve-error.js

@@ -1 +0,0 @@
-class o extends Error{meta;constructor(t,e){super(t),this.meta=e,Object.setPrototypeOf(this,new.target.prototype)}}export{o as MdResolveError};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-code-snippet-from-file.d.ts

@@ -1,4 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext, WithOriginalAttr } from '../../../types';
-export declare function resolveCodeSnippetFromFile(node: WithOriginalAttr<Node>, attributeName: string, pageRelativePath: string, { actions: { contentDir }, context }: MarkdocResolveContext): Promise<void>;
-//# sourceMappingURL=resolve-code-snippet-from-file.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-code-snippet-from-file.js

@@ -1,6 +0,0 @@
-import c from"node:path";import{slash as L}from"../../../../utils/path/slash.js";import{reporter as F}from"../../../tools/notifiers/reporter.js";import{getNodeAttribute as n}from"../../../../markdoc/helpers/get-node-attribute.js";import{MdResolveError as h}from"./md-resolve-error.js";async function V(i,w,b,{actions:{contentDir:m},context:u}){const o=n(i,w);if(!o)return;const r=o.startsWith("/")?o.slice(1):L(c.relative(m,c.resolve(m,c.dirname(b),o)));if(!u.fs.exists(r)){await F.panicOnBuildContentError(`Code snippet file ${r} does not exist`);return}let e=await u.fs.read(r);const d=n(i,"after"),p=n(i,"before"),y=n(i,"from"),C=n(i,"to"),v=n(i,"prefix")||"",s=y??d,f=C??p,g=d!==null,x=p!==null,E=(typeof s=="number"?Math.max(s||0,1):1)+(g?1:0);let a=(typeof f=="number"?f:1/0)-(x?1:0);if(typeof s=="string"){let t=e.indexOf(s);if(t===-1)throw new h(`Cannot find start text "${s}" in snippet file`,{rawLink:r});for(;e[t]!==`
-`&&t>0;)t--;typeof a=="number"&&(a-=e.slice(0,t-1).split(`
-`).length),e=e.slice(t+1)}if(typeof f=="string"){let t=e.indexOf(f);if(t===-1)throw new h(`Cannot find end text "${p}" in snippet file`,{rawLink:r});e[t-1]===`
-`&&t--,e=e.slice(0,t)}const l=e.split(`
-`);if(x)for(;l[l.length-1]==="";)l.pop();i.children=[],i.attributes.rawContent=v+l.slice(E-1,a).join(`
-`)}export{V as resolveCodeSnippetFromFile};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-diagram-from-file.d.ts

@@ -1,4 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext, WithOriginalAttr } from '../../../types';
-export declare function resolveDiagramFromFile(node: WithOriginalAttr<Node>, attributeName: string, pageRelativePath: string, { actions: { contentDir }, context }: MarkdocResolveContext): Promise<void>;
-//# sourceMappingURL=resolve-diagram-from-file.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-diagram-from-file.js

@@ -1 +0,0 @@
-import a from"node:path";import{slash as f}from"../../../../utils/path/slash.js";import{reporter as l}from"../../../tools/notifiers/reporter.js";import{getNodeAttribute as p}from"../../../../markdoc/helpers/get-node-attribute.js";async function h(t,s,m,{actions:{contentDir:e},context:o}){const r=p(t,s);if(!r)return;const i=r.startsWith("/")?r.slice(1):f(a.relative(e,a.resolve(e,a.dirname(m),r)));if(!o.fs.exists(i)){await l.panicOnBuildContentError(`Diagram file ${i} does not exist`);return}const n=await o.fs.read(i);t.children=[],t.attributes.rawContent=n}export{h as resolveDiagramFromFile};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-html-href.d.ts

@@ -1,14 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext, WithOriginalAttr } from '../../../types';
-/**
- * Resolves HTML href attributes (e.g., `<a href="...">`) using the existing `resolveLink` logic
- * and then applies the global `pathPrefix` if configured. Ensures HTML links are correct for
- * site deployments under a path prefix.
- *
- * @param node The Markdoc AST node (HTML tag with href attribute).
- * @param attributeName Attribute holding the URL ('href').
- * @param pageRelativePath Relative path of the current Markdown page.
- * @param context The Markdoc resolution context.
- */
-export declare function resolveHtmlHref(node: WithOriginalAttr<Node>, attributeName: string | undefined, pageRelativePath: string, context: MarkdocResolveContext): Promise<void>;
-//# sourceMappingURL=resolve-html-href.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-html-href.js

@@ -1 +0,0 @@
-import{withPathPrefix as m,withoutPathPrefix as p}from"@redocly/theme/core/utils";import{isLocalLink as u}from"../../../../utils/path/is-local-link.js";import{getNodeAttribute as s}from"../../../../markdoc/helpers/get-node-attribute.js";import{setNodeAttributeValue as l}from"../../../../markdoc/helpers/set-node-attribute-value.js";import{resolveLink as a}from"./resolve-link.js";async function H(r,t="href",n,c){const i=s(r,"attrs")||{},e=i[t];if(!e)return;const h=p(e);l(r,t,h),await a(r,t,n,c);const o=s(r,t);if(delete r.attributes[t],!o)return;let f=o;!o.startsWith("#")&&u(o)&&(f=m(o)),l(r,"attrs",{...i,[t]:f})}export{H as resolveHtmlHref};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-html-source-attribute.d.ts

@@ -1,4 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext, WithOriginalAttr } from '../../../types';
-export declare function resolveHtmlSourceAttribute(node: WithOriginalAttr<Node>, attributeName: string, pageRelativePath: string, { actions: { contentDir, outdir, getRouteBySlug }, context }: MarkdocResolveContext): Promise<void>;
-//# sourceMappingURL=resolve-html-source-attribute.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-html-source-attribute.js

@@ -1 +0,0 @@
-import S from"node:path";import{normalizeRouteSlug as v}from"../../../../utils/path/normalize-route-slug.js";import{reporter as a}from"../../../tools/notifiers/reporter.js";import{getNodeAttribute as m}from"../../../../markdoc/helpers/get-node-attribute.js";import{FileNotFoundError as u,resolveAssetPath as w,resolveSrcSet as h}from"../../../utils/index.js";import{MdResolveError as $}from"./md-resolve-error.js";import{getLinkOriginalAttrName as A}from"./utils.js";async function B(e,o,s,{actions:{contentDir:n,outdir:l,getRouteBySlug:p},context:c}){const i=m(e,"attrs")?.[o],g=m(e,"name");if(!i)return;const f=A(o),t=e[f]||i;if(!(g==="iframe"&&p(v(t)))){if(e[f]=t,o==="src"){if(!S.extname(t))return;try{const r=await w(t,c.fs,{fromFileRelativePath:s,contentDir:n,outdir:l});e.attributes.attrs[o]=r}catch(r){if(r instanceof u)throw new $(`File ${t} does not exist`,{rawLink:t,link:t});await a.panicOnBuild(`Cannot resolve %rp: ${r.message}`,t)}}if(o==="srcSet")try{const r=await h(i,c.fs,{fromFileRelativePath:s,contentDir:n,outdir:l});e.attributes.attrs[o]=r}catch(r){r instanceof u?await a.panicOnBuildContentError(`Cannot resolve 'srcSet' attribute: ${i}: ${r.message}`):await a.panicOnBuild(`Cannot resolve 'srcSet' attribute: ${i}: ${r.message}`)}}}export{B as resolveHtmlSourceAttribute};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-image-gallery.d.ts

@@ -1,4 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext, WithOriginalAttr } from '../../../types';
-export declare function resolveImageGallery(node: WithOriginalAttr<Node>, attributeName: string, pageRelativePath: string, { actions: { contentDir, outdir }, context }: MarkdocResolveContext): Promise<void>;
-//# sourceMappingURL=resolve-image-gallery.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-image-gallery.js

@@ -1 +0,0 @@
-import{getNodeAttribute as p}from"../../../../markdoc/helpers/get-node-attribute.js";import{setNodeAttributeValue as u}from"../../../../markdoc/helpers/set-node-attribute-value.js";import{FileNotFoundError as y,resolveAssetPath as A}from"../../../utils/index.js";import{MdResolveError as d}from"./md-resolve-error.js";import{getLinkOriginalAttrName as v}from"./utils.js";async function P(e,i,f,{actions:{contentDir:c,outdir:m},context:g}){const l=e,h=p(e,i),a=v(i),s=l[a]??h;if(!Array.isArray(s))return;l[a]=s;const r=[],o=[];for(const t of s){if(typeof t!="string"){r.push(t);continue}try{r.push(await A(t,g.fs,{fromFileRelativePath:f,contentDir:c,outdir:m}))}catch(n){if(n instanceof y)r.push(t),o.push(n.filePath);else throw n}}if(u(e,i,r),o.length>0){const[t]=o;throw new d(o.length===1?`File ${t} does not exist`:`Files do not exist: ${o.join(", ")}`,{rawLink:t,link:t})}}export{P as resolveImageGallery};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-image-src-set.d.ts

@@ -1,4 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext, WithOriginalAttr } from '../../../types';
-export declare function resolveImageSrcSet(node: WithOriginalAttr<Node>, attributeName: string, pageRelativePath: string, { actions: { contentDir, outdir }, context }: MarkdocResolveContext): Promise<void>;
-//# sourceMappingURL=resolve-image-src-set.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-image-src-set.js

@@ -1 +0,0 @@
-import{reporter as c}from"../../../tools/notifiers/reporter.js";import{getNodeAttribute as a}from"../../../../markdoc/helpers/get-node-attribute.js";import{setNodeAttributeValue as m}from"../../../../markdoc/helpers/set-node-attribute-value.js";import{FileNotFoundError as p,resolveSrcSet as u}from"../../../utils/index.js";import{getLinkOriginalAttrName as g}from"./utils.js";import{MdResolveError as v}from"./md-resolve-error.js";async function k(r,e,l,{actions:{contentDir:n,outdir:s},context:f}){if(a(r,e)){const i=g(e),o=r[i]||a(r,e);if(r[i]=o,!o)return;try{const t=await u(o,f.fs,{fromFileRelativePath:l,contentDir:n,outdir:s});m(r,e,t)}catch(t){if(t instanceof p)throw new v(`File ${t.filePath} does not exist`,{rawLink:t.filePath,link:t.filePath});await c.panicOnBuild(`Cannot resolve 'srcSet' attribute: ${t.message}`)}}}export{k as resolveImageSrcSet};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-image-src.d.ts

@@ -1,4 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext, WithOriginalAttr } from '../../../types';
-export declare function resolveImageSrc(node: WithOriginalAttr<Node>, attributeName: string, pageRelativePath: string, { actions: { contentDir, outdir }, context }: MarkdocResolveContext): Promise<void>;
-//# sourceMappingURL=resolve-image-src.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-image-src.js

@@ -1 +0,0 @@
-import{reporter as m}from"../../../tools/notifiers/reporter.js";import{getNodeAttribute as n}from"../../../../markdoc/helpers/get-node-attribute.js";import{setNodeAttributeValue as c}from"../../../../markdoc/helpers/set-node-attribute-value.js";import{FileNotFoundError as p,resolveAssetPath as g}from"../../../utils/index.js";import{MdResolveError as u}from"./md-resolve-error.js";import{getLinkOriginalAttrName as v}from"./utils.js";async function x(t,o,s,{actions:{contentDir:a,outdir:l},context:f}){if(n(t,o)){const i=v(o),r=t[i]||n(t,o);if(typeof r!="string"||(t[i]=r,!r))return;try{const e=await g(r,f.fs,{fromFileRelativePath:s,contentDir:a,outdir:l});c(t,o,e)}catch(e){if(e instanceof p)throw new u(`File ${r} does not exist`,{rawLink:r,link:r});await m.panicOnBuild(`Cannot resolve %rp: ${e.message}`,r)}}}export{x as resolveImageSrc};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-json-example-ref.d.ts

@@ -1,4 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext } from '../../../types';
-export declare function resolveJsonExampleRef(node: Node, attrName: string, relativePath: string, { context, actions }: MarkdocResolveContext): Promise<void>;
-//# sourceMappingURL=resolve-json-example-ref.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-json-example-ref.js

@@ -1 +0,0 @@
-import{JsonPointer as w}from"@redocly/api-docs";import{isObject as d}from"../../../../utils/guards/is-object.js";import{getNodeAttribute as u}from"../../../../markdoc/helpers/get-node-attribute.js";import{setNodeAttributeValue as s}from"../../../../markdoc/helpers/set-node-attribute-value.js";import{MdResolveError as p}from"./md-resolve-error.js";import{resolvePathInMarkdown as $}from"../resolve-path-in-markdown.js";async function b(e,o,m,{context:n,actions:h}){const r=u(e,o);try{if(!d(r)||typeof r.$ref!="string"){try{JSON.stringify(r)}catch(i){throw new Error(`Invalid JSON value: ${i.message}`)}s(e,o+"Resolved",r);return}const[t,f]=r.$ref.split("#");if(!t)throw new Error(`Invalid $ref. Path to file is required: ${r.$ref}`);const l=$(t,m,h.contentDir),c=await n.fs.getFileInfo(l);if(!c)throw new Error(`Invalid $ref. No such file: ${l}`);let a;try{a=(await n.cache.load(c.realRelativePath,"yaml")).data}catch(i){throw new Error(`Invalid file format. File must be valid json or yaml: ${l} ${i?.message||""}`)}if(!f){s(e,o+"Resolved",a);return}const v=w.get(a,f);s(e,o+"Resolved",v)}catch(t){throw s(e,o+"ResolvedErrors",[t.message]),new p(t.message,{rawLink:""})}}export{b as resolveJsonExampleRef};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-json-schema-ref.d.ts

@@ -1,6 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext } from '../../../types';
-export declare function resolveJsonSchemaRef(node: Node, attrName: string, relativePath: string, { context, actions }: MarkdocResolveContext): Promise<{
-    sharedDataId?: string;
-} | undefined>;
-//# sourceMappingURL=resolve-json-schema-ref.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-json-schema-ref.js

@@ -1 +0,0 @@
-import a from"node:path";import{getNodeAttribute as u}from"../../../../markdoc/helpers/get-node-attribute.js";import{setNodeAttributeValue as f}from"../../../../markdoc/helpers/set-node-attribute-value.js";import{formatBundleFromMarkdocError as b}from"../errors.js";import{MdResolveError as d}from"./md-resolve-error.js";import{dereferenceJsonSchemaRefs as h}from"./helpers/dereference-json-schema-refs.js";async function k(o,r,e,{context:c,actions:i}){const l=u(o,r),t=i.contentDir,p=a.resolve(t,e),s=await h({schemaOrRef:l,filePath:p,fs:c.fs});f(o,r+"Resolved",s?.oas);const n=s?.problems[0];if(!n)return{};const m=b(n,e,t);throw f(o,r+"ResolvedErrors",[m]),new d(m,{rawLink:""})}export{k as resolveJsonSchemaRef};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-link.d.ts

@@ -1,6 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext, WithOriginalAttr } from '../../../types';
-export declare function resolveLink(node: WithOriginalAttr<Node>, attributeName: string, fromPage: string, { actions, context }: MarkdocResolveContext): Promise<{
-    sharedDataId?: string;
-} | void>;
-//# sourceMappingURL=resolve-link.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-link.js

@@ -1 +0,0 @@
-import n from"node:path";import{API_DOCS_TEMPLATE_ID as y,ASYNC_API_DOCS_TEMPLATE_ID as F,GRAPHQL_TEMPLATE_ID as M,OPENAPI_DOCS_TEMPLATE_ID as U}from"../../../../constants/common.js";import{isLocalLink as C}from"../../../../utils/path/is-local-link.js";import{normalizeRouteSlug as P}from"../../../../utils/path/normalize-route-slug.js";import{removeFragment as B}from"../../../../utils/path/remove-fragment.js";import{getInnerText as W}from"../../../../markdoc/helpers/get-inner-text.js";import{getNodeAttribute as j}from"../../../../markdoc/helpers/get-node-attribute.js";import{setNodeAttributeValue as c}from"../../../../markdoc/helpers/set-node-attribute-value.js";import{isAuthRoutePath as $}from"../../../../utils/auth/is-auth-route-path.js";import{isApiDownloadLink as V}from"../../../utils/is-api-download-link.js";import{MdResolveError as A}from"./md-resolve-error.js";import{getLinkOriginalAttrName as b}from"./utils.js";import{isOpenApiURL as z}from"../../api-docs/utils/is-api-doc.js";import{parseBaseName as G}from"../../utils.js";import{isMarkdownPage as N}from"../is-markdown-page.js";import{copyStaticFile as q}from"../../../utils/fs.js";async function pt(i,r,p,{actions:w,context:u}){const{contentDir:D,outdir:T,getRouteByFsPath:x,getRouteBySlug:I,hasRouteOrRedirectBySlug:d}=w,k=b(r),o=i[k]||j(i,r);if(i[k]=o,!C(o)||V(o)||$(o))return;const[H,t="",R,L]=/^([^?#]+)?([^#]+)?(.+)?/.exec(o)||[],f=i.type==="image"?"IMAGE":"LINK",g=String(i.attributes.title||i.attributes.alt||W([i])||""),a=B(p);if(i.type!=="image"){const{isOpenapiDetected:e,isOpenapiValid:s}=await z(t,a,w,u);if(e&&!s)throw new A(`OpenAPI route ${o} does not exist`,{rawLink:o,link:t,title:g,brokenLinkType:f})}if(n.extname(t)===""){if(t.startsWith("/")){const e=P(t),s=d(e)?t:_(e,I);if(!s)throw new A(`Route ${t} does not exist`,{rawLink:o,link:t,title:g,brokenLinkType:f});c(i,r,s+(R||"")+(L||""))}if(!o.startsWith("#")&&!t.startsWith("/")&&N(a)){const e=x(a)?.slug;if(!e)return;const{isIndexFile:s}=G(a),h=s?P(n.posix.join(e,t)):P(n.posix.join(e,"../",t)),E=d(P(h))?h:_(h,I);if(!E)throw new A(`Route ${t} does not exist`,{rawLink:o,link:h,title:g,brokenLinkType:f});c(i,r,E+(R||"")+(L||""))}return}const l=t.startsWith("/")?t.substring(1):n.posix.join(n.posix.dirname(a),decodeURI(t)),v=t.startsWith("/")?n.posix.join("static",t.substring(1)):"",S=u.fs.exists(l),O=u.fs.exists(v),m=x(l);if(!S&&!m&&!O)throw c(i,r,"#"),new A(`File ${l} does not exist`,{rawLink:o,link:l,title:g,brokenLinkType:f});if(m){const e=[U,M,F].includes(m.templateId);c(i,r,(e?m.baseSlug:m.slug)+(L||""))}else if(S){const e=u.fs.getFileInfo(l);if(!e||e.isVirtual)return;const s=await q(D,e.realRelativePath,T);c(i,r,s)}}function _(i,r){const p=r(i.toLowerCase());return p?.templateId===y?p.slug:void 0}export{pt as resolveLink};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-native-md-link.d.ts

@@ -1,13 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext, WithOriginalAttr } from '../../../types';
-/**
- * Resolves native Markdown links/images (e.g., `[]()` or `![]()`) using `resolveLink` and then applies the global
- * `pathPrefix` if configured. Ensures links are correct for site deployments under a path prefix.
- *
- * @param node The Markdoc AST node (link or image).
- * @param attributeName Attribute holding the URL ('href' or 'src').
- * @param pageRelativePath Relative path of the current Markdown page.
- * @param context The Markdoc resolution context.
- */
-export declare function resolveNativeMdLink(node: WithOriginalAttr<Node>, attributeName: string, pageRelativePath: string, context: MarkdocResolveContext): Promise<void>;
-//# sourceMappingURL=resolve-native-md-link.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-native-md-link.js

@@ -1 +0,0 @@
-import{getPathPrefix as s,withPathPrefix as n}from"@redocly/theme/core/utils";import{isLocalLink as m}from"../../../../utils/path/is-local-link.js";import{getNodeAttribute as p}from"../../../../markdoc/helpers/get-node-attribute.js";import{setNodeAttributeValue as a}from"../../../../markdoc/helpers/set-node-attribute-value.js";import{resolveLink as l}from"./resolve-link.js";async function v(r,i,o,f){if(await l(r,i,o,f),r.type==="link")return;const e=s();if(!e)return;const t=p(r,i);!t||t==="#"||!m(t)||t.startsWith(e)||a(r,i,t.startsWith("#")?t:n(t))}export{v as resolveNativeMdLink};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-nav-links.d.ts

@@ -1,4 +0,0 @@
-import type { MarkdocResolveContext, WithOriginalAttr } from '../../../types';
-import type { Node } from '@markdoc/markdoc';
-export declare function resolveNavLinks(node: WithOriginalAttr<Node, any>, attrName: string, relativePath: string, { context, actions }: MarkdocResolveContext): Promise<void>;
-//# sourceMappingURL=resolve-nav-links.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-nav-links.js

@@ -1 +0,0 @@
-import n from"node:path";import{getNodeAttribute as f}from"../../../../markdoc/helpers/get-node-attribute.js";import{setNodeAttributeValue as p}from"../../../../markdoc/helpers/set-node-attribute-value.js";import{getLinkOriginalAttrName as a}from"./utils.js";import{resolveLinksFromConfig as v}from"../../nav-utils.js";async function L(o,r,t,{context:s,actions:i}){const e=a(r),m=o[e]||f(o,r);o[e]=m;const l=await v(m,n.dirname(n.resolve(i.contentDir,t)),i,s,{navFile:t});p(o,r,l)}export{L as resolveNavLinks};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-open-api-ref.d.ts

@@ -1,6 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext, WithOriginalAttr } from '../../../types';
-export declare function resolveOpenApiRef(node: WithOriginalAttr<Node>, attrName: string, relativePath: string, { context }: MarkdocResolveContext): Promise<{
-    sharedDataId: string;
-} | undefined>;
-//# sourceMappingURL=resolve-open-api-ref.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-open-api-ref.js

@@ -1 +0,0 @@
-import f from"node:path";import{API_DOCS_SHARED_DATA_PREFIX as p}from"../../../constants/plugins/api-docs.js";import{getNodeAttribute as A}from"../../../../markdoc/helpers/get-node-attribute.js";import{setNodeAttributeValue as w}from"../../../../markdoc/helpers/set-node-attribute-value.js";import{isOpenapiDoc as d}from"../../api-docs/utils/is-api-doc.js";import{MdResolveError as a}from"./md-resolve-error.js";import{getLinkOriginalAttrName as g}from"./utils.js";async function R(r,t,e,{context:n}){const s=g(t);let o=r[s]||A(r,t);if(o||await d(e,n)&&(o=f.basename(e)),r[s]=o,!o)return;const i=f.posix.join(f.posix.dirname(e),o),m=p+i;if(w(r,t,m),!n.fs.exists(i))throw new a(`Definition file ${i} does not exist`,{rawLink:i});if(await n.isPathIgnored(i))throw new a(`Definition file ${i} is ignored in config`,{rawLink:i});return{sharedDataId:m}}export{R as resolveOpenApiRef};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-openapi-code-samples.d.ts

@@ -1,4 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext } from '../../../types';
-export declare function resolveOpenapiCodeSamples(node: Node, attrName: string, _relativePath: string, { context }: MarkdocResolveContext): Promise<void>;
-//# sourceMappingURL=resolve-openapi-code-samples.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-openapi-code-samples.js

@@ -1 +0,0 @@
-import{buildCodeSamples as y,getRequestBodySamples as v,normalizeOptions as d,resolveOperationSampleContext as f}from"@redocly/api-docs";import{setNodeAttributeValue as S}from"../../../../markdoc/helpers/set-node-attribute-value.js";import{loadOpenapiBundle as O}from"./helpers/load-openapi-bundle.js";import{getOptionalAttribute as t}from"./utils.js";const b={curl:"shell",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"};async function B(e,c,h,{context:u}){const o=await O(e,u);if(!o)return;const s=t(e,"language"),r={exampleKey:t(e,"exampleKey"),mimeType:t(e,"mimeType"),parameters:t(e,"parameters"),requestBody:t(e,"requestBody"),environments:t(e,"environments"),environment:t(e,"environment")},g={...o.rawOptions,...o.rawOptions.mockServer&&{mockServer:{...o.rawOptions.mockServer,position:"off"}},...s&&{codeSamples:{...o.rawOptions.codeSamples,languages:[{lang:s}]}}},l=d(g),n=f(o.definition,l,{operationId:t(e,"operationId"),pointer:t(e,"pointer")});if(!n)return;const i=y(n,r).map(a=>({lang:b[a.lang]??a.lang.toLowerCase(),title:a.label??a.lang,source:a.source})),m=l.codeSamples?.languages??[],p=m.findIndex(({lang:a})=>a==="Payload");if(p!==-1){const a=v(n,{exampleKey:r.exampleKey,mimeType:r.mimeType,titlePrefix:m[p].label});i.splice(p,0,...a)}i.length&&S(e,c,i)}export{B as resolveOpenapiCodeSamples};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-openapi-response-samples.d.ts

@@ -1,4 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext } from '../../../types';
-export declare function resolveOpenapiResponseSamples(node: Node, attrName: string, _relativePath: string, { context }: MarkdocResolveContext): Promise<void>;
-//# sourceMappingURL=resolve-openapi-response-samples.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-openapi-response-samples.js

@@ -1 +0,0 @@
-import{getResponseSamples as s,normalizeOptions as l,resolveOperationSampleContext as m}from"@redocly/api-docs";import{setNodeAttributeValue as f}from"../../../../markdoc/helpers/set-node-attribute-value.js";import{loadOpenapiBundle as u}from"./helpers/load-openapi-bundle.js";import{getOptionalAttribute as o}from"./utils.js";async function g(e,p,c,{context:r}){const t=await u(e,r);if(!t)return;const a=o(e,"exampleKey"),i=m(t.definition,l(t.rawOptions),{operationId:o(e,"operationId"),pointer:o(e,"pointer")});if(!i)return;const n=s(i,{exampleKey:a});n.length&&f(e,p,n)}export{g as resolveOpenapiResponseSamples};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-parsed-yaml.d.ts

@@ -1,4 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext } from '../../../types';
-export declare function resolveParsedYaml(node: Node, attrName: string, relativePath: string, { context }: MarkdocResolveContext): Promise<void>;
-//# sourceMappingURL=resolve-parsed-yaml.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-parsed-yaml.js

@@ -1 +0,0 @@
-import{getNodeAttribute as m}from"../../../../markdoc/helpers/get-node-attribute.js";import{setNodeAttributeValue as c}from"../../../../markdoc/helpers/set-node-attribute-value.js";import{MdResolveError as f}from"./md-resolve-error.js";import{resolvePathInMarkdown as l}from"../resolve-path-in-markdown.js";async function p(t,r,a,{context:o}){const s=m(t,r);if(s){const e=l(s,a,o.fs.cwd);if(!o.fs.exists(e))throw new f(`Schema file ${e} does not exist`,{rawLink:e});const i=(await o.cache.load(e,"yaml")).data;c(t,r+"Resolved",i)}}export{p as resolveParsedYaml};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-raw-content.d.ts

@@ -1,4 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext } from '../../../types';
-export declare function resolveRawContent(node: Node, attrName: string, relativePath: string, { context, actions }: MarkdocResolveContext): Promise<void>;
-//# sourceMappingURL=resolve-raw-content.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-raw-content.js

@@ -1 +0,0 @@
-import{getNodeAttribute as m}from"../../../../markdoc/helpers/get-node-attribute.js";import{setNodeAttributeValue as c}from"../../../../markdoc/helpers/set-node-attribute-value.js";import{readFileContent as l}from"../read-file-content.js";import{resolvePathInMarkdown as w}from"../resolve-path-in-markdown.js";import{MdResolveError as p}from"./md-resolve-error.js";async function R(o,e,i,{context:r,actions:s}){const n=m(o,e),a=s.contentDir;if(n){const t=w(n,i,a);if(!r.fs.exists(t))throw new p(`File ${t} does not exist`,{rawLink:t});const f=await l(t,r.fs);c(o,e+"RawContent",f)}}export{R as resolveRawContent};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-relative-or-cdn-icon.d.ts

@@ -1,4 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext, WithOriginalAttr } from '../../../types';
-export declare function resolveRelativeOrCdnIcon(node: WithOriginalAttr<Node>, attrName: string, relativePath: string, { context, actions }: MarkdocResolveContext): Promise<void>;
-//# sourceMappingURL=resolve-relative-or-cdn-icon.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-relative-or-cdn-icon.js

@@ -1 +0,0 @@
-import{getNodeAttribute as s}from"../../../../markdoc/helpers/get-node-attribute.js";import{resolveLink as m}from"./resolve-link.js";import{resolveSvgContent as g}from"./resolve-svg-content.js";import{isIconPath as l}from"../../../utils/index.js";import{getLinkOriginalAttrName as p}from"./utils.js";async function k(i,r,t,{context:e,actions:n}){const f=p(r),o=i[f]||s(i,r);!o||typeof o!="string"||(o.endsWith(".svg")?await g(i,r,t,{context:e,actions:n}):l(o)&&await m(i,r,t,{context:e,actions:n}))}export{k as resolveRelativeOrCdnIcon};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-relative-path.d.ts

@@ -1,4 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext, WithOriginalAttr } from '../../../types';
-export declare function resolveRelativePath(node: WithOriginalAttr<Node>, attrName: string, relativePath: string, context: MarkdocResolveContext): Promise<void>;
-//# sourceMappingURL=resolve-relative-path.d.ts.map

package/dist/server/plugins/markdown/attribute-resolvers/resolve-relative-path.js

@@ -1 +0,0 @@
-import e from"node:path";import{slash as g}from"../../../../utils/path/slash.js";import{getNodeAttribute as h}from"../../../../markdoc/helpers/get-node-attribute.js";import{setNodeAttributeValue as v}from"../../../../markdoc/helpers/set-node-attribute-value.js";import{isL10nPath as m}from"../../../fs/utils/is-l10n-path.js";import{getLocaleFromRelativePath as A}from"../../../fs/utils/get-locale-from-relative-path.js";import{getLinkOriginalAttrName as d}from"./utils.js";async function R(o,i,r,n){const s=h(o,i);if(!s)return;const l=n.actions.contentDir,a=d(i),t=o[a]||s;o[a]=t;const c=m(r)?A(r):void 0,f=n.context.fs,p=c&&!m(t.slice(1))?`${f.localizationFolder}/${c}/`:"",u=t.startsWith("/")?p+t.slice(1):g(e.relative(l,e.resolve(l,e.dirname(r),t)));v(o,i,u)}export{R as resolveRelativePath};

package/dist/server/plugins/markdown/attribute-resolvers/resolve-sample-from-json-schema.d.ts

@@ -1,4 +0,0 @@
-import type { Node } from '@markdoc/markdoc';
-import type { MarkdocResolveContext } from '../../../types';
-export declare function resolveSampleFromJsonSchema(node: Node, attrName: string, relativePath: string, { context, actions }: MarkdocResolveContext): Promise<void>;
-//# sourceMappingURL=resolve-sample-from-json-schema.d.ts.map