radiant-docs 0.1.59 → 0.1.61

package/template/src/lib/mdx/remark-resolve-internal-links.ts

@@ -8,7 +8,6 @@ import {
   loadOpenApiSpec,
   resolveDocsHref,
   type DocsConfig,
-  type HiddenPageRoute,
   type NavGroup,
   type NavMenuItem,
   type NavOpenApi,
@@ -28,6 +27,15 @@ import {
 
 type MdxNavItem = string | NavPage | NavGroup | NavOpenApiPage;
 
+type AuxiliaryPageRef = {
+  filePath: string;
+  href: string;
+};
+
+type DocsConfigWithAuxiliaryRefs = DocsConfig & {
+  auxiliaryPageRefs?: AuxiliaryPageRef[];
+};
+
 type ResolvedRouteIndex = {
   canonicalHrefByFilePath: Map<string, string>;
   allHrefsByFilePath: Map<string, string[]>;
@@ -230,14 +238,14 @@ function addOpenApiEndpointRoute(args: {
   );
 }
 
-function addHiddenPageRoute(
+function addAuxiliaryPageRef(
   index: ResolvedRouteIndex,
-  route: HiddenPageRoute,
+  ref: AuxiliaryPageRef,
 ): void {
-  const normalizedFilePath = normalizeDocsFilePath(route.filePath);
+  const normalizedFilePath = normalizeDocsFilePath(ref.filePath);
   if (!normalizedFilePath) return;
 
-  const href = addValidRoutePath(index, prependBasePath(route.href));
+  const href = addValidRoutePath(index, prependBasePath(ref.href));
   if (!index.canonicalHrefByFilePath.has(normalizedFilePath)) {
     index.canonicalHrefByFilePath.set(normalizedFilePath, href);
   }
@@ -249,6 +257,12 @@ function addHiddenPageRoute(
   index.allHrefsByFilePath.set(normalizedFilePath, aliases);
 }
 
+function getAuxiliaryPageRefs(
+  config: DocsConfigWithAuxiliaryRefs,
+): AuxiliaryPageRef[] {
+  return config.auxiliaryPageRefs ?? [];
+}
+
 function shouldIncludeEndpoint(
   method: string,
   pathStr: string,
@@ -474,14 +488,14 @@ async function buildRouteIndex(
   }
 
   if (homePath) {
-    addHiddenPageRoute(index, {
+    addAuxiliaryPageRef(index, {
       filePath: homePath,
       href: "/",
     });
   }
 
-  for (const hiddenPageRoute of config.hiddenPageRoutes ?? []) {
-    addHiddenPageRoute(index, hiddenPageRoute);
+  for (const auxiliaryPageRef of getAuxiliaryPageRefs(config)) {
+    addAuxiliaryPageRef(index, auxiliaryPageRef);
   }
 
   return index;

package/template/src/lib/oas.ts

@@ -4,6 +4,10 @@ import { loadOpenApiSpec } from "./validation";
 // Cache for dereferenced Oas instances (key: filePathOrUrl, value: Oas instance)
 const oasInstanceCache = new Map<string, Oas>();
 
+function cloneOpenApiDocument<T>(document: T): T {
+  return JSON.parse(JSON.stringify(document));
+}
+
 export async function getOasInstance(filePathOrUrl: string): Promise<Oas> {
   // Check cache first
   if (oasInstanceCache.has(filePathOrUrl)) {
@@ -14,7 +18,7 @@ export async function getOasInstance(filePathOrUrl: string): Promise<Oas> {
   const openApiDoc = await loadOpenApiSpec(filePathOrUrl);
 
   // Create and dereference Oas instance
-  const api = new Oas(openApiDoc);
+  const api = new Oas(cloneOpenApiDocument(openApiDoc));
   await api.dereference();
 
   // Cache the dereferenced instance