@fern-api/fern-api-dev 5.2.2-5-ge17d83c7e65 → 5.2.2-7-g8752405b79b

package/cli.cjs

@@ -544046,6 +544046,7 @@ async function loadTranslationNavigationOverlays({ translations, defaultLocale,
       const overlay = await parseNavigationOverlayFromDocsYml({
         docsYmlContent: overlayContent,
         langFernDir: overlayDir,
+        overlayDocsYmlPath,
         context: context3
       });
       result[lang] = overlay;
@@ -544080,13 +544081,26 @@ function extractString(obj, key2) {
   }
   return void 0;
 }
-async function parseNavigationOverlayFromDocsYml({ docsYmlContent, langFernDir: overlayDir, context: context3 }) {
+async function validateOverlayNavbarLinks({ rawNavbarLinks, overlayDocsYmlPath, context: context3 }) {
+  const result = [];
+  for (const [index3, raw] of rawNavbarLinks.entries()) {
+    try {
+      const parsed = await docs_yml_exports.RawSchemas.Serializer.NavbarLink.parseOrThrow(raw);
+      result.push(parsed);
+    } catch (error50) {
+      context3.logger.warn(`Invalid navbar-link at index ${index3} in "${overlayDocsYmlPath}": ${String(error50)}. Skipping this entry.`);
+    }
+  }
+  return result;
+}
+async function parseNavigationOverlayFromDocsYml({ docsYmlContent, langFernDir: overlayDir, overlayDocsYmlPath, context: context3 }) {
   const overlay = {
     tabs: void 0,
     products: void 0,
     versions: void 0,
     announcement: void 0,
-    navigation: void 0
+    navigation: void 0,
+    navbarLinks: void 0
   };
   if (isPlainObject4(docsYmlContent.announcement)) {
     const message = extractString(docsYmlContent.announcement, "message");
@@ -544094,6 +544108,15 @@ async function parseNavigationOverlayFromDocsYml({ docsYmlContent, langFernDir:
       overlay.announcement = { message };
     }
   }
+  const rawNavbarLinks = docsYmlContent["navbar-links"];
+  if (Array.isArray(rawNavbarLinks)) {
+    const validatedNavbarLinks = await validateOverlayNavbarLinks({
+      rawNavbarLinks,
+      overlayDocsYmlPath,
+      context: context3
+    });
+    overlay.navbarLinks = convertNavbarLinks(validatedNavbarLinks, overlayDocsYmlPath) ?? [];
+  }
   if (isPlainObject4(docsYmlContent.tabs)) {
     overlay.tabs = parseTabOverlays(docsYmlContent.tabs);
   }
@@ -622017,7 +622040,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.2.2-5-ge17d83c7e65",
+          version: "5.2.2-7-g8752405b79b",
           usingAccessToken: true
         }
       });
@@ -622071,7 +622094,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.2.2-5-ge17d83c7e65",
+        version: "5.2.2-7-g8752405b79b",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -791706,7 +791729,8 @@ function applyChildOverlays(children2, parent, overlay) {
           products: void 0,
           versions: overlay.versions,
           announcement: productOverlay.announcement ?? overlay.announcement,
-          navigation: productOverlay.navigation ?? overlay.navigation
+          navigation: productOverlay.navigation ?? overlay.navigation,
+          navbarLinks: overlay.navbarLinks
         };
         const walked = walkAndApply(child, scopedOverlay);
         return applyProductOverlayToNode(walked, productOverlay);
@@ -791856,7 +791880,8 @@ function applyTabOverlayToNode(node4, overlay) {
         products: void 0,
         versions: void 0,
         announcement: void 0,
-        navigation: tabNavOverlay.layout
+        navigation: tabNavOverlay.layout,
+        navbarLinks: void 0
       };
       return walkAndApply(node4, scopedOverlay);
     }
@@ -799679,8 +799704,49 @@ async function collectFilesFromDocsConfig({ parsedDocsConfig }) {
       }
     }));
   }
+  if (parsedDocsConfig.translationNavigationOverlays != null) {
+    for (const overlay of Object.values(parsedDocsConfig.translationNavigationOverlays)) {
+      await collectIconsFromNavbarLinks({
+        navbarLinks: overlay.navbarLinks,
+        filepaths
+      });
+    }
+  }
   return filepaths;
 }
+async function collectIconsFromNavbarLinks({ navbarLinks, filepaths }) {
+  if (navbarLinks == null) {
+    return;
+  }
+  await Promise.all(navbarLinks.map(async (link3) => {
+    if (link3.type === "github") {
+      return;
+    }
+    if (link3.type === "dropdown") {
+      await Promise.all(link3.links.map(async (nestedLink) => {
+        if (nestedLink.icon != null) {
+          await addIconToFilepaths({ iconPath: nestedLink.icon, filepaths });
+        }
+        if (nestedLink.rightIcon != null) {
+          await addIconToFilepaths({ iconPath: nestedLink.rightIcon, filepaths });
+        }
+      }));
+      if (link3.icon != null) {
+        await addIconToFilepaths({ iconPath: link3.icon, filepaths });
+      }
+      if (link3.rightIcon != null) {
+        await addIconToFilepaths({ iconPath: link3.rightIcon, filepaths });
+      }
+      return;
+    }
+    if (link3.icon != null) {
+      await addIconToFilepaths({ iconPath: link3.icon, filepaths });
+    }
+    if (link3.rightIcon != null) {
+      await addIconToFilepaths({ iconPath: link3.rightIcon, filepaths });
+    }
+  }));
+}
 async function collectIconsFromNavigation({ navigation: navigation2 }) {
   const filepaths = /* @__PURE__ */ new Set();
   switch (navigation2.type) {
@@ -800262,6 +800328,7 @@ var DocsDefinitionResolver = class {
     uploadedFiles.forEach((uploadedFile) => {
       this.collectedFileIds.set(uploadedFile.absoluteFilePath, uploadedFile.fileId);
     });
+    this.resolveTranslationOverlayNavbarLinkIcons();
     this.taskContext.logger.debug("Building navigation tree...");
     const rootStart = performance.now();
     const root6 = await this.toRootNode();
@@ -801447,6 +801514,45 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
     }
     return iconPath;
   }
+  /**
+   * Walks each translation overlay's navbar-links and rewrites any
+   * AbsoluteFilePath icons to `file:<fileId>` references using the icons
+   * we just uploaded. Mirrors the per-link transform applied to the
+   * docs-level navbar-links in `toDocsConfig`.
+   */
+  resolveTranslationOverlayNavbarLinkIcons() {
+    const overlays = this.parsedDocsConfig.translationNavigationOverlays;
+    if (overlays == null) {
+      return;
+    }
+    for (const overlay of Object.values(overlays)) {
+      if (overlay.navbarLinks == null) {
+        continue;
+      }
+      overlay.navbarLinks = overlay.navbarLinks.map((navbarLink) => {
+        if (navbarLink.type === "github") {
+          return navbarLink;
+        }
+        if (navbarLink.type === "dropdown") {
+          return {
+            ...navbarLink,
+            icon: this.resolveIconFileId(navbarLink.icon),
+            rightIcon: this.resolveIconFileId(navbarLink.rightIcon),
+            links: navbarLink.links.map((link3) => ({
+              ...link3,
+              icon: this.resolveIconFileId(link3.icon),
+              rightIcon: this.resolveIconFileId(link3.rightIcon)
+            }))
+          };
+        }
+        return {
+          ...navbarLink,
+          icon: this.resolveIconFileId(navbarLink.icon),
+          rightIcon: this.resolveIconFileId(navbarLink.rightIcon)
+        };
+      });
+    }
+  }
   convertPageActions() {
     if (this.parsedDocsConfig.pageActions == null) {
       return void 0;
@@ -834268,7 +834374,7 @@ var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
 function getCliSource() {
-  const version7 = "5.2.2-5-ge17d83c7e65";
+  const version7 = "5.2.2-7-g8752405b79b";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -836557,9 +836663,13 @@ async function runPreviewServer({ initialProject, reloadProject, validateProject
         let updatedRoot = applyTranslatedFrontmatterToNavTree(docsDefinition.config.root, localePages, context3);
         const localeNavOverlay = translationNavigationOverlays?.[locale];
         let translatedAnnouncement = docsDefinition.config.announcement;
+        let translatedNavbarLinks = docsDefinition.config.navbarLinks;
         if (localeNavOverlay != null) {
           updatedRoot = applyTranslatedNavigationOverlays(updatedRoot, localeNavOverlay);
           translatedAnnouncement = getTranslatedAnnouncement(localeNavOverlay) ?? translatedAnnouncement;
+          if (localeNavOverlay.navbarLinks != null) {
+            translatedNavbarLinks = localeNavOverlay.navbarLinks;
+          }
         }
         const translatedDefinition = {
           ...docsDefinition,
@@ -836567,7 +836677,8 @@ async function runPreviewServer({ initialProject, reloadProject, validateProject
           config: {
             ...docsDefinition.config,
             root: updatedRoot,
-            announcement: translatedAnnouncement
+            announcement: translatedAnnouncement,
+            navbarLinks: translatedNavbarLinks
           }
         };
         translations.set(locale, translatedDefinition);
@@ -845977,9 +846088,13 @@ ${JSON.stringify(errorDetails, void 0, 2)}`);
           );
           const localeNavOverlay = translationNavigationOverlays?.[locale];
           let translatedAnnouncement = docsDefinition.config.announcement;
+          let translatedNavbarLinks = docsDefinition.config.navbarLinks;
           if (localeNavOverlay != null) {
             updatedRoot = applyTranslatedNavigationOverlays(updatedRoot, localeNavOverlay);
             translatedAnnouncement = getTranslatedAnnouncement(localeNavOverlay) ?? translatedAnnouncement;
+            if (localeNavOverlay.navbarLinks != null) {
+              translatedNavbarLinks = localeNavOverlay.navbarLinks;
+            }
           }
           const translatedDefinition = {
             ...docsDefinition,
@@ -845987,7 +846102,8 @@ ${JSON.stringify(errorDetails, void 0, 2)}`);
             config: {
               ...docsDefinition.config,
               root: updatedRoot,
-              announcement: translatedAnnouncement
+              announcement: translatedAnnouncement,
+              navbarLinks: translatedNavbarLinks
             }
           };
           const pageCount2 = Object.keys(localePages).length;
@@ -846720,7 +846836,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.2.2-5-ge17d83c7e65",
+        cliVersion: "5.2.2-7-g8752405b79b",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -921052,7 +921168,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.2.2-5-ge17d83c7e65";
+    return "5.2.2-7-g8752405b79b";
   }
   getCliName() {
     if (false) {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.2.2-5-ge17d83c7e65",
+  "version": "5.2.2-7-g8752405b79b",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",