@fern-api/fern-api-dev 4.104.0 → 4.105.0-4-g36fd47b6743

package/cli.cjs

@@ -346934,7 +346934,14 @@ var require_pushSignedCommit = __commonJS({
       return typeof err === "object" && err != null && "status" in err && typeof err.status === "number";
     }
     function isNotFoundError(err) {
-      return hasNumericStatus(err) && err.status === 404;
+      if (hasNumericStatus(err) && err.status === 404) {
+        return true;
+      }
+      if (hasNumericStatus(err) && err.status === 422) {
+        const message = (0, core_utils_1.extractErrorMessage)(err).toLowerCase();
+        return message.includes("reference does not exist");
+      }
+      return false;
     }
     function isNonFastForwardError(err) {
       if (!hasNumericStatus(err) || err.status !== 422) {
@@ -541997,7 +542004,13 @@ async function parseDocsConfiguration({ rawDocsConfiguration, absolutePathToFern
     absolutePathToFernFolder,
     context: context3
   }));
-  const [navigation2, pages, typography, css, js7, metadata, context7File, llmsTxtFile, llmsFullTxtFile, translationPages] = await Promise.all([
+  const translationNavigationOverlaysPromise = loadTranslationNavigationOverlays({
+    translations: rawDocsConfiguration.translations,
+    defaultLocale,
+    absolutePathToFernFolder,
+    context: context3
+  });
+  const [navigation2, pages, typography, css, js7, metadata, context7File, llmsTxtFile, llmsFullTxtFile, translationPages, translationNavigationOverlays] = await Promise.all([
     convertedNavigationPromise,
     pagesPromise,
     typographyPromise,
@@ -542007,7 +542020,8 @@ async function parseDocsConfiguration({ rawDocsConfiguration, absolutePathToFern
     context7FilePromise,
     llmsTxtFilePromise,
     llmsFullTxtFilePromise,
-    translationPagesPromise
+    translationPagesPromise,
+    translationNavigationOverlaysPromise
   ]);
   const resolvedTheme = convertThemeConfig(rawDocsConfiguration.theme);
   const tabsObj = resolvedTheme?.tabs != null && typeof resolvedTheme.tabs === "object" ? resolvedTheme.tabs : void 0;
@@ -542027,6 +542041,8 @@ async function parseDocsConfiguration({ rawDocsConfiguration, absolutePathToFern
     pages,
     /* per-locale translated page content */
     translationPages,
+    /* per-locale translated navigation overlays */
+    translationNavigationOverlays,
     /* navigation */
     landingPage,
     navigation: navigation2,
@@ -543290,6 +543306,203 @@ These pages will fall back to the default language content.`);
   }));
   return result;
 }
+async function loadTranslationNavigationOverlays({ translations, defaultLocale, absolutePathToFernFolder, context: context3 }) {
+  if (translations == null || translations.length === 0) {
+    return void 0;
+  }
+  const translationsRootDir = import_path22.default.join(absolutePathToFernFolder, "translations");
+  const result = {};
+  const normalizedTranslations = translations.map((t3) => docs_yml_exports.DocsYmlSchemas.normalizeTranslationConfig(t3));
+  await Promise.all(normalizedTranslations.map(async ({ lang }) => {
+    if (lang === defaultLocale) {
+      return;
+    }
+    const langFernDir = import_path22.default.join(translationsRootDir, lang, "fern");
+    const overlayDocsYmlPath = import_path22.default.join(langFernDir, "docs.yml");
+    if (!await doesPathExist(overlayDocsYmlPath)) {
+      return;
+    }
+    try {
+      const overlayContent = jsYaml.load(await (0, import_promises14.readFile)(overlayDocsYmlPath, "utf-8"));
+      if (!isPlainObject4(overlayContent)) {
+        context3.logger.warn(`Translation overlay at "${overlayDocsYmlPath}" is not a valid YAML object. Skipping.`);
+        return;
+      }
+      const overlay = await parseNavigationOverlayFromDocsYml({
+        docsYmlContent: overlayContent,
+        langFernDir,
+        context: context3
+      });
+      result[lang] = overlay;
+    } catch (error50) {
+      context3.logger.warn(`Failed to load translation overlay for locale "${lang}": ${String(error50)}. Navigation labels will not be translated for this locale.`);
+    }
+  }));
+  if (Object.keys(result).length === 0) {
+    return void 0;
+  }
+  return result;
+}
+function extractString(obj, key2) {
+  if (isPlainObject4(obj)) {
+    const value2 = obj[key2];
+    if (typeof value2 === "string") {
+      return value2;
+    }
+  }
+  return void 0;
+}
+async function parseNavigationOverlayFromDocsYml({ docsYmlContent, langFernDir, context: context3 }) {
+  const overlay = {
+    tabs: void 0,
+    products: void 0,
+    versions: void 0,
+    announcement: void 0,
+    navigation: void 0
+  };
+  if (isPlainObject4(docsYmlContent.announcement)) {
+    const message = extractString(docsYmlContent.announcement, "message");
+    if (message != null) {
+      overlay.announcement = { message };
+    }
+  }
+  if (isPlainObject4(docsYmlContent.tabs)) {
+    overlay.tabs = parseTabOverlays(docsYmlContent.tabs);
+  }
+  if (Array.isArray(docsYmlContent.products)) {
+    overlay.products = [];
+    for (const product of docsYmlContent.products) {
+      if (!isPlainObject4(product)) {
+        continue;
+      }
+      const productObj = product;
+      const productOverlay = {
+        slug: typeof productObj.slug === "string" ? productObj.slug : void 0,
+        displayName: typeof productObj["display-name"] === "string" ? productObj["display-name"] : void 0,
+        subtitle: typeof productObj.subtitle === "string" ? productObj.subtitle : void 0,
+        announcement: void 0,
+        tabs: void 0,
+        navigation: void 0
+      };
+      if (isPlainObject4(productObj.announcement)) {
+        const message = extractString(productObj.announcement, "message");
+        if (message != null) {
+          productOverlay.announcement = { message };
+        }
+      }
+      if (typeof productObj.path === "string") {
+        const resolvedNavFilePath = import_path22.default.resolve(langFernDir, productObj.path);
+        if (!resolvedNavFilePath.startsWith(langFernDir)) {
+          context3.logger.warn(`Invalid path in product overlay: "${productObj.path}" escapes the translations directory. Skipping.`);
+          overlay.products.push(productOverlay);
+          continue;
+        }
+        const navFilePath = resolvedNavFilePath;
+        if (await doesPathExist(navFilePath)) {
+          try {
+            const navContent = jsYaml.load(await (0, import_promises14.readFile)(navFilePath, "utf-8"));
+            if (isPlainObject4(navContent)) {
+              const navObj = navContent;
+              if (isPlainObject4(navObj.tabs)) {
+                productOverlay.tabs = parseTabOverlays(navObj.tabs);
+              }
+              if (Array.isArray(navObj.navigation)) {
+                productOverlay.navigation = parseNavigationItemOverlays(navObj.navigation);
+              }
+            }
+          } catch (error50) {
+            context3.logger.warn(`Failed to load translation nav file "${navFilePath}": ${String(error50)}`);
+          }
+        }
+      }
+      overlay.products.push(productOverlay);
+    }
+  }
+  if (Array.isArray(docsYmlContent.versions)) {
+    overlay.versions = [];
+    for (const version7 of docsYmlContent.versions) {
+      if (!isPlainObject4(version7)) {
+        continue;
+      }
+      const versionObj = version7;
+      overlay.versions.push({
+        slug: typeof versionObj.slug === "string" ? versionObj.slug : void 0,
+        displayName: typeof versionObj["display-name"] === "string" ? versionObj["display-name"] : void 0
+      });
+    }
+  }
+  if (Array.isArray(docsYmlContent.navigation)) {
+    overlay.navigation = [...overlay.navigation ?? [], ...parseNavigationItemOverlays(docsYmlContent.navigation)];
+  }
+  return overlay;
+}
+function parseTabOverlays(tabsObj) {
+  const result = {};
+  for (const [tabId, tabConfig] of Object.entries(tabsObj)) {
+    if (isPlainObject4(tabConfig)) {
+      const tabConfigObj = tabConfig;
+      result[tabId] = {
+        displayName: typeof tabConfigObj["display-name"] === "string" ? tabConfigObj["display-name"] : void 0,
+        slug: typeof tabConfigObj.slug === "string" ? tabConfigObj.slug : void 0
+      };
+    }
+  }
+  return result;
+}
+function parseNavigationItemOverlays(items) {
+  const result = [];
+  for (const item of items) {
+    if (!isPlainObject4(item)) {
+      continue;
+    }
+    const obj = item;
+    if (typeof obj.tab === "string") {
+      const tabOverlay = {
+        type: "tab",
+        tabId: obj.tab,
+        layout: Array.isArray(obj.layout) ? parseNavigationItemOverlays(obj.layout) : void 0,
+        variants: Array.isArray(obj.variants) ? parseVariantOverlays(obj.variants) : void 0
+      };
+      result.push(tabOverlay);
+      continue;
+    }
+    if (typeof obj.section === "string") {
+      const sectionOverlay = {
+        type: "section",
+        title: obj.section,
+        slug: typeof obj.slug === "string" ? obj.slug : void 0,
+        contents: Array.isArray(obj.contents) ? parseNavigationItemOverlays(obj.contents) : void 0
+      };
+      result.push(sectionOverlay);
+      continue;
+    }
+    if (typeof obj.page === "string") {
+      const pageOverlay = {
+        type: "page",
+        title: obj.page,
+        slug: typeof obj.slug === "string" ? obj.slug : void 0
+      };
+      result.push(pageOverlay);
+      continue;
+    }
+  }
+  return result;
+}
+function parseVariantOverlays(variants) {
+  const result = [];
+  for (const variant of variants) {
+    if (!isPlainObject4(variant)) {
+      continue;
+    }
+    const obj = variant;
+    result.push({
+      title: typeof obj.title === "string" ? obj.title : void 0,
+      subtitle: typeof obj.subtitle === "string" ? obj.subtitle : void 0,
+      slug: typeof obj.slug === "string" ? obj.slug : void 0
+    });
+  }
+  return result;
+}
 
 // ../configuration-loader/lib/fern-config-json/loadProjectConfig.js
 init_lib6();
@@ -620978,7 +621191,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.104.0",
+          version: "4.105.0-4-g36fd47b6743",
           usingAccessToken: true
         }
       });
@@ -621032,7 +621245,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.104.0",
+        version: "4.105.0-4-g36fd47b6743",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -790443,6 +790656,343 @@ function walkNode(node4, overrides) {
   return updated;
 }
 
+// ../docs-resolver/lib/applyTranslatedNavigationOverlays.js
+function applyTranslatedNavigationOverlays(root6, overlay) {
+  if (root6 == null) {
+    return void 0;
+  }
+  const result = walkAndApply(root6, overlay);
+  return result;
+}
+function getTranslatedAnnouncement(overlay) {
+  if (overlay.announcement?.message != null) {
+    return { text: overlay.announcement.message };
+  }
+  return void 0;
+}
+function walkAndApply(node4, overlay) {
+  if (node4 == null || typeof node4 !== "object") {
+    return node4;
+  }
+  if (Array.isArray(node4)) {
+    return node4.map((item) => walkAndApply(item, overlay));
+  }
+  const obj = node4;
+  const updated = {};
+  for (const [k5, v9] of Object.entries(obj)) {
+    if (k5 === "children" && Array.isArray(v9)) {
+      updated[k5] = applyChildOverlays(v9, obj, overlay);
+    } else {
+      updated[k5] = walkAndApply(v9, overlay);
+    }
+  }
+  return updated;
+}
+function applyChildOverlays(children2, parent, overlay) {
+  const parentType = parent["type"];
+  if (parentType === "productgroup" && overlay.products != null) {
+    return children2.map((child, index3) => {
+      const childObj = child;
+      if (childObj == null || typeof childObj !== "object") {
+        return walkAndApply(child, overlay);
+      }
+      const productOverlay = findProductOverlay(childObj, overlay.products ?? [], index3);
+      if (productOverlay != null) {
+        const scopedOverlay = {
+          tabs: productOverlay.tabs ?? overlay.tabs,
+          products: void 0,
+          versions: overlay.versions,
+          announcement: productOverlay.announcement ?? overlay.announcement,
+          navigation: productOverlay.navigation ?? overlay.navigation
+        };
+        const walked = walkAndApply(child, scopedOverlay);
+        return applyProductOverlayToNode(walked, productOverlay);
+      }
+      return walkAndApply(child, overlay);
+    });
+  }
+  if (parentType === "versioned" && overlay.versions != null) {
+    return children2.map((child, index3) => {
+      const childObj = child;
+      if (childObj == null || typeof childObj !== "object") {
+        return walkAndApply(child, overlay);
+      }
+      const versionOverlay = findVersionOverlay(childObj, overlay.versions ?? [], index3);
+      const walked = walkAndApply(child, overlay);
+      if (versionOverlay != null) {
+        return applyVersionOverlayToNode(walked, versionOverlay);
+      }
+      return walked;
+    });
+  }
+  if (parentType === "tabbed") {
+    return children2.map((child) => {
+      const childObj = child;
+      if (childObj == null || typeof childObj !== "object") {
+        return walkAndApply(child, overlay);
+      }
+      if (childObj["type"] === "tab") {
+        const walked = walkAndApply(child, overlay);
+        return applyTabOverlayToNode(walked, overlay);
+      }
+      return walkAndApply(child, overlay);
+    });
+  }
+  if (parentType === "sidebarRoot") {
+    const navOverlays = collectFlatNavigationOverlays(overlay);
+    if (navOverlays.length > 0) {
+      return applySidebarChildOverlays(children2, navOverlays, overlay);
+    }
+  }
+  if (parentType === "sidebarGroup") {
+    const navOverlays = collectFlatNavigationOverlays(overlay);
+    if (navOverlays.length > 0) {
+      return applySidebarChildOverlays(children2, navOverlays, overlay);
+    }
+  }
+  if (parentType === "section") {
+    return children2.map((child) => walkAndApply(child, overlay));
+  }
+  return children2.map((child) => walkAndApply(child, overlay));
+}
+function findProductOverlay(node4, products, index3) {
+  const nodeSlug = extractLastSlugSegment(node4["slug"]);
+  if (nodeSlug != null) {
+    for (const p14 of products) {
+      if (p14.slug != null && p14.slug === nodeSlug) {
+        return p14;
+      }
+    }
+  }
+  const nodeTitle = node4["title"];
+  const nodeProductId = node4["productId"];
+  for (const p14 of products) {
+    if (p14.displayName != null) {
+      if (nodeTitle === p14.displayName || nodeProductId === p14.displayName) {
+        return p14;
+      }
+    }
+  }
+  if (index3 < products.length) {
+    return products[index3];
+  }
+  return void 0;
+}
+function findVersionOverlay(node4, versions, index3) {
+  const nodeSlug = extractLastSlugSegment(node4["slug"]);
+  if (nodeSlug != null) {
+    for (const v9 of versions) {
+      if (v9.slug != null && v9.slug === nodeSlug) {
+        return v9;
+      }
+    }
+  }
+  const nodeTitle = node4["title"];
+  const nodeVersionId = node4["versionId"];
+  for (const v9 of versions) {
+    if (v9.displayName != null) {
+      if (nodeTitle === v9.displayName || nodeVersionId === v9.displayName) {
+        return v9;
+      }
+    }
+  }
+  if (index3 < versions.length) {
+    return versions[index3];
+  }
+  return void 0;
+}
+function applyProductOverlayToNode(node4, productOverlay) {
+  if (productOverlay.displayName != null) {
+    node4["title"] = productOverlay.displayName;
+  }
+  if (productOverlay.subtitle != null) {
+    node4["subtitle"] = productOverlay.subtitle;
+  }
+  if (productOverlay.announcement?.message != null) {
+    node4["announcement"] = { text: productOverlay.announcement.message };
+  }
+  return node4;
+}
+function applyVersionOverlayToNode(node4, versionOverlay) {
+  if (versionOverlay.displayName != null) {
+    node4["title"] = versionOverlay.displayName;
+  }
+  return node4;
+}
+function applyTabOverlayToNode(node4, overlay) {
+  const tabSlug = extractLastSlugSegment(node4["slug"]);
+  if (overlay.tabs != null && tabSlug != null) {
+    for (const [tabId, tabOverlay] of Object.entries(overlay.tabs)) {
+      const isMatch = tabId === tabSlug || tabOverlay.slug != null && tabOverlay.slug === tabSlug;
+      if (isMatch && tabOverlay.displayName != null) {
+        node4["title"] = tabOverlay.displayName;
+        break;
+      }
+    }
+  }
+  const tabNavOverlay = findTabNavOverlay(tabSlug, overlay);
+  if (tabNavOverlay != null) {
+    if (overlay.tabs != null) {
+      const tabOverlayEntry = overlay.tabs[tabNavOverlay.tabId];
+      if (tabOverlayEntry?.displayName != null) {
+        node4["title"] = tabOverlayEntry.displayName;
+      }
+    }
+    if (tabNavOverlay.variants != null && tabNavOverlay.variants.length > 0) {
+      const tabChild = node4["child"];
+      if (tabChild != null && tabChild["type"] === "variants") {
+        const variantsChildren = tabChild["children"];
+        if (variantsChildren != null) {
+          tabChild["children"] = applyVariantOverlays(variantsChildren, tabNavOverlay.variants);
+        }
+      }
+    }
+    if (tabNavOverlay.layout != null) {
+      const scopedOverlay = {
+        tabs: void 0,
+        products: void 0,
+        versions: void 0,
+        announcement: void 0,
+        navigation: tabNavOverlay.layout
+      };
+      return walkAndApply(node4, scopedOverlay);
+    }
+  }
+  return walkAndApply(node4, overlay);
+}
+function findTabNavOverlay(tabSlug, overlay) {
+  if (overlay.navigation == null) {
+    return void 0;
+  }
+  for (const navItem of overlay.navigation) {
+    if (navItem.type !== "tab") {
+      continue;
+    }
+    if (tabSlug != null && navItem.tabId === tabSlug) {
+      return navItem;
+    }
+    if (tabSlug != null && overlay.tabs != null) {
+      const tabConfig = overlay.tabs[navItem.tabId];
+      if (tabConfig?.slug != null && tabConfig.slug === tabSlug) {
+        return navItem;
+      }
+    }
+  }
+  return void 0;
+}
+function collectFlatNavigationOverlays(overlay) {
+  if (overlay.navigation == null) {
+    return [];
+  }
+  const nonTabItems = overlay.navigation.filter((item) => item.type !== "tab");
+  return nonTabItems;
+}
+function applySidebarChildOverlays(children2, navOverlays, overlay) {
+  let sectionIdx = 0;
+  let pageIdx = 0;
+  return children2.map((child) => {
+    const childObj = child;
+    if (childObj == null || typeof childObj !== "object") {
+      return walkAndApply(child, overlay);
+    }
+    const childType = childObj["type"];
+    if (childType === "section") {
+      const sectionOverlays = navOverlays.filter((item) => item.type === "section");
+      const matched = matchSectionOverlay(childObj, sectionOverlays, sectionIdx);
+      sectionIdx++;
+      if (matched != null) {
+        const walked = walkAndApply(child, overlay);
+        if (matched.title != null) {
+          walked["title"] = matched.title;
+        }
+        if (matched.contents != null) {
+          const childArray = walked["children"];
+          if (childArray != null) {
+            walked["children"] = applySidebarChildOverlays(childArray, matched.contents, overlay);
+          }
+        }
+        return walked;
+      }
+      return walkAndApply(child, overlay);
+    }
+    if (childType === "page" || childType === "landingPage") {
+      const pageOverlays = navOverlays.filter((item) => item.type === "page");
+      const matched = matchPageOverlay(childObj, pageOverlays, pageIdx);
+      pageIdx++;
+      if (matched?.title != null) {
+        const walked = walkAndApply(child, overlay);
+        walked["title"] = matched.title;
+        return walked;
+      }
+      return walkAndApply(child, overlay);
+    }
+    return walkAndApply(child, overlay);
+  });
+}
+function matchSectionOverlay(section, overlays, positionIndex) {
+  const sectionSlug = extractLastSlugSegment(section["slug"]);
+  for (const o3 of overlays) {
+    if (o3.slug != null && o3.slug === sectionSlug) {
+      return o3;
+    }
+  }
+  const noSlugOverlays = overlays.filter((o3) => o3.slug == null);
+  if (positionIndex < noSlugOverlays.length) {
+    return noSlugOverlays[positionIndex];
+  }
+  return void 0;
+}
+function matchPageOverlay(page, overlays, positionIndex) {
+  const pageSlug = extractLastSlugSegment(page["slug"]);
+  for (const o3 of overlays) {
+    if (o3.slug != null && o3.slug === pageSlug) {
+      return o3;
+    }
+  }
+  const noSlugOverlays = overlays.filter((o3) => o3.slug == null);
+  if (positionIndex < noSlugOverlays.length) {
+    return noSlugOverlays[positionIndex];
+  }
+  return void 0;
+}
+function extractLastSlugSegment(slug) {
+  if (slug == null) {
+    return void 0;
+  }
+  const parts = slug.split("/");
+  return parts[parts.length - 1];
+}
+function applyVariantOverlays(variants, overlays) {
+  return variants.map((variant, index3) => {
+    const variantObj = variant;
+    if (variantObj == null || typeof variantObj !== "object") {
+      return variant;
+    }
+    const variantSlug = extractLastSlugSegment(variantObj["slug"]);
+    let matchedOverlay;
+    if (variantSlug != null) {
+      matchedOverlay = overlays.find((o3) => o3.slug != null && o3.slug === variantSlug);
+    }
+    if (matchedOverlay == null) {
+      const noSlugOverlays = overlays.filter((o3) => o3.slug == null);
+      if (index3 < noSlugOverlays.length) {
+        matchedOverlay = noSlugOverlays[index3];
+      }
+    }
+    if (matchedOverlay != null) {
+      const result = { ...variantObj };
+      if (matchedOverlay.title != null) {
+        result["title"] = matchedOverlay.title;
+      }
+      if (matchedOverlay.subtitle != null) {
+        result["subtitle"] = matchedOverlay.subtitle;
+      }
+      return result;
+    }
+    return variant;
+  });
+}
+
 // ../docs-resolver/lib/DocsDefinitionResolver.js
 init_lib4();
 init_js();
@@ -798533,6 +799083,14 @@ var DocsDefinitionResolver = class {
   getTranslationPages() {
     return this._parsedDocsConfig?.translationPages;
   }
+  /**
+   * Returns per-locale translated navigation overlays loaded from
+   * `translations/<lang>/fern/docs.yml` and referenced nav YAML files.
+   * Must be called after `resolve()`.
+   */
+  getTranslationNavigationOverlays() {
+    return this._parsedDocsConfig?.translationNavigationOverlays;
+  }
   /**
    * Returns the map of absolute file paths to uploaded file IDs.
    * Used by translation processing to rewrite image paths in translated pages.
@@ -832328,7 +832886,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 = "4.104.0";
+  const version7 = "4.105.0-4-g36fd47b6743";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -832687,7 +833245,7 @@ var STANDALONE_FOLDER_NAME = "standalone";
 var LOCAL_STORAGE_FOLDER5 = ".fern-dev";
 var INSTRUMENTATION_PATH = "packages/fern-docs/bundle/.next/server/instrumentation.js";
 var COREPACK_MISSING_KEYID_ERROR_MESSAGE = 'Cannot find matching keyid: {"signatures":';
-function warnIfLongPathsDisabled(logger4) {
+function assertLongPathsEnabled(logger4) {
   try {
     const output2 = (0, import_child_process6.execSync)('reg query "HKLM\\SYSTEM\\CurrentControlSet\\Control\\FileSystem" /v LongPathsEnabled', { encoding: "utf-8", timeout: 5e3 });
     const match3 = output2.match(/LongPathsEnabled\s+REG_DWORD\s+0x(\d+)/i);
@@ -832697,7 +833255,11 @@ function warnIfLongPathsDisabled(logger4) {
   } catch (error50) {
     logger4.debug(`Registry query for LongPathsEnabled failed: ${error50}`);
   }
-  logger4.warn(source_default.yellow.bold("\n\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557\n\u2551  WARNING: Windows long path support is NOT enabled.                     \u2551\n\u2551                                                                         \u2551\n\u2551  The docs bundle contains deeply nested .pnpm paths that may exceed     \u2551\n\u2551  the 260-character MAX_PATH limit. Extraction may silently truncate     \u2551\n\u2551  paths and produce a broken bundle.                                     \u2551\n\u2551                                                                         \u2551\n\u2551  To fix, run this in an elevated PowerShell:                             \u2551\n\u2551                                                                         \u2551\n\u2551    New-ItemProperty -Path                                                \u2551\n\u2551      'HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem'           \u2551\n\u2551      -Name 'LongPathsEnabled' -Value 1 -PropertyType DWORD -Force       \u2551\n\u2551                                                                         \u2551\n\u2551  Then restart your terminal.                                             \u2551\n\u2551                                                                         \u2551\n\u2551  For more details, see:                                                  \u2551\n\u2551  https://learn.microsoft.com/en-us/windows/win32/fileio/                 \u2551\n\u2551  maximum-file-path-limitation                                            \u2551\n\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D\n"));
+  throw new CliError({
+    message: "Windows long path support is not enabled. The docs bundle contains deeply nested .pnpm paths that exceed the 260-character MAX_PATH limit.\n\nTo fix, run this in an elevated PowerShell:\n\n  New-ItemProperty -Path 'HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem' -Name 'LongPathsEnabled' -Value 1 -PropertyType DWORD -Force\n\nThen restart your terminal.",
+    code: CliError.Code.EnvironmentError,
+    docsLink: "https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation"
+  });
 }
 function isWithinOutputDir(resolvedPath, outputDir) {
   const rel2 = import_path57.default.relative(outputDir, resolvedPath);
@@ -832926,7 +833488,7 @@ async function downloadBundle({ bucketUrl, logger: logger4, preferCached, app =
       }, 50);
     }
     if (PLATFORM_IS_WINDOWS) {
-      warnIfLongPathsDisabled(logger4);
+      assertLongPathsEnabled(logger4);
     }
     const collectedSymlinks = [];
     try {
@@ -833390,6 +833952,7 @@ async function getPreviewDocsDefinition({ domain: domain3, project, context: con
       return {
         docsDefinition: previousDocsDefinition,
         translationPages: previousPreviewResult.translationPages,
+        translationNavigationOverlays: previousPreviewResult.translationNavigationOverlays,
         collectedFileIds: previousPreviewResult.collectedFileIds,
         docsWorkspacePath: previousPreviewResult.docsWorkspacePath
       };
@@ -833461,10 +834024,12 @@ async function getPreviewDocsDefinition({ domain: domain3, project, context: con
     docsDefinition = { ...substitutedDocs, jsFiles };
   }
   const translationPages = resolver2.getTranslationPages();
+  const translationNavigationOverlays = resolver2.getTranslationNavigationOverlays();
   const collectedFileIds = resolver2.getCollectedFileIds();
   return {
     docsDefinition,
     translationPages,
+    translationNavigationOverlays,
     collectedFileIds,
     docsWorkspacePath: docsWorkspace.absoluteFilePath
   };
@@ -834053,7 +834618,7 @@ async function runAppPreviewServer({ initialProject, reloadProject, validateProj
   const RELOAD_DEBOUNCE_MS = 1e3;
   function computeTranslatedDefinitions(result) {
     const translations = /* @__PURE__ */ new Map();
-    const { docsDefinition, translationPages, collectedFileIds, docsWorkspacePath } = result;
+    const { docsDefinition, translationPages, translationNavigationOverlays, collectedFileIds, docsWorkspacePath } = result;
     if (translationPages == null || Object.keys(translationPages).length === 0) {
       return translations;
     }
@@ -834091,13 +834656,20 @@ async function runAppPreviewServer({ initialProject, reloadProject, validateProj
             editThisPageLaunch: basePage?.editThisPageLaunch
           };
         }
-        const updatedRoot = applyTranslatedFrontmatterToNavTree(docsDefinition.config.root, localePages, context3);
+        let updatedRoot = applyTranslatedFrontmatterToNavTree(docsDefinition.config.root, localePages, context3);
+        const localeNavOverlay = translationNavigationOverlays?.[locale];
+        let translatedAnnouncement = docsDefinition.config.announcement;
+        if (localeNavOverlay != null) {
+          updatedRoot = applyTranslatedNavigationOverlays(updatedRoot, localeNavOverlay);
+          translatedAnnouncement = getTranslatedAnnouncement(localeNavOverlay) ?? translatedAnnouncement;
+        }
         const translatedDefinition = {
           ...docsDefinition,
           pages: translatedPages,
           config: {
             ...docsDefinition.config,
-            root: updatedRoot
+            root: updatedRoot,
+            announcement: translatedAnnouncement
           }
         };
         translations.set(locale, translatedDefinition);
@@ -834545,7 +835117,7 @@ async function runPreviewServer({ initialProject, reloadProject, validateProject
   const RELOAD_DEBOUNCE_MS = 1e3;
   function computeTranslatedDefinitions(result) {
     const translations = /* @__PURE__ */ new Map();
-    const { docsDefinition, translationPages, collectedFileIds, docsWorkspacePath } = result;
+    const { docsDefinition, translationPages, translationNavigationOverlays, collectedFileIds, docsWorkspacePath } = result;
     if (translationPages == null || Object.keys(translationPages).length === 0) {
       return translations;
     }
@@ -834583,13 +835155,20 @@ async function runPreviewServer({ initialProject, reloadProject, validateProject
             editThisPageLaunch: basePage?.editThisPageLaunch
           };
         }
-        const updatedRoot = applyTranslatedFrontmatterToNavTree(docsDefinition.config.root, localePages, context3);
+        let updatedRoot = applyTranslatedFrontmatterToNavTree(docsDefinition.config.root, localePages, context3);
+        const localeNavOverlay = translationNavigationOverlays?.[locale];
+        let translatedAnnouncement = docsDefinition.config.announcement;
+        if (localeNavOverlay != null) {
+          updatedRoot = applyTranslatedNavigationOverlays(updatedRoot, localeNavOverlay);
+          translatedAnnouncement = getTranslatedAnnouncement(localeNavOverlay) ?? translatedAnnouncement;
+        }
         const translatedDefinition = {
           ...docsDefinition,
           pages: translatedPages,
           config: {
             ...docsDefinition.config,
-            root: updatedRoot
+            root: updatedRoot,
+            announcement: translatedAnnouncement
           }
         };
         translations.set(locale, translatedDefinition);
@@ -843931,6 +844510,7 @@ ${JSON.stringify(errorDetails, void 0, 2)}`);
     const publishTime = performance.now() - publishStart;
     context3.logger.debug(`Docs published to FDR in ${publishTime.toFixed(0)}ms`);
     const translationPages = resolver2.getTranslationPages();
+    const translationNavigationOverlays = resolver2.getTranslationNavigationOverlays();
     const translationDomain = preview ? urlToOutput : domain3;
     if (translationPages != null && Object.keys(translationPages).length > 0) {
       context3.logger.info(`Registering translations for ${Object.keys(translationPages).length} locale(s)...`);
@@ -843972,18 +844552,25 @@ ${JSON.stringify(errorDetails, void 0, 2)}`);
               ];
             }))
           };
-          const updatedRoot = applyTranslatedFrontmatterToNavTree(
+          let updatedRoot = applyTranslatedFrontmatterToNavTree(
             docsDefinition.config.root,
             // localePages is Record<RelativeFilePath, string> (path -> raw markdown)
             localePages,
             context3
           );
+          const localeNavOverlay = translationNavigationOverlays?.[locale];
+          let translatedAnnouncement = docsDefinition.config.announcement;
+          if (localeNavOverlay != null) {
+            updatedRoot = applyTranslatedNavigationOverlays(updatedRoot, localeNavOverlay);
+            translatedAnnouncement = getTranslatedAnnouncement(localeNavOverlay) ?? translatedAnnouncement;
+          }
           const translatedDefinition = {
             ...docsDefinition,
             pages: translatedPages,
             config: {
               ...docsDefinition.config,
-              root: updatedRoot
+              root: updatedRoot,
+              announcement: translatedAnnouncement
             }
           };
           const pageCount2 = Object.keys(localePages).length;
@@ -844695,7 +845282,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.104.0",
+        cliVersion: "4.105.0-4-g36fd47b6743",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -892828,14 +893415,24 @@ var EndpointSnippetGenerator9 = class {
     const filePropertyInfo = this.getFilePropertyInfo({ request: request7, snippet: snippet2 });
     this.context.errors.unscope();
     if (request7.body != null) {
-      args.push(swift_exports.functionArgument({
-        label: "request",
-        value: this.getInlinedRequestArg({
-          request: request7,
-          snippet: snippet2,
-          filePropertyInfo
-        })
-      }));
+      if (request7.body.type === "referenced") {
+        args.push(swift_exports.functionArgument({
+          label: "request",
+          value: this.getReferencedRequestBodyPropertyTypeLiteral({
+            body: request7.body.bodyType,
+            value: snippet2.requestBody
+          })
+        }));
+      } else {
+        args.push(swift_exports.functionArgument({
+          label: "request",
+          value: this.getInlinedRequestArg({
+            request: request7,
+            snippet: snippet2,
+            filePropertyInfo
+          })
+        }));
+      }
     }
     return args;
   }
@@ -895204,8 +895801,8 @@ var EndpointSnippetGenerator10 = class {
   getMethodArgsForInlinedRequest({ request: request7, snippet: snippet2 }) {
     const args = [];
     const { inlinePathParameters, inlineFileProperties } = {
-      inlinePathParameters: this.context.customConfig?.inlinePathParameters ?? false,
-      inlineFileProperties: this.context.customConfig?.inlineFileProperties ?? false
+      inlinePathParameters: this.context.customConfig?.inlinePathParameters ?? true,
+      inlineFileProperties: this.context.customConfig?.inlineFileProperties ?? true
     };
     this.context.errors.scope(Scope4.PathParameters);
     const pathParameterFields = [];
@@ -895302,7 +895899,7 @@ var EndpointSnippetGenerator10 = class {
     }
   }
   getFileUploadRequestBodyObjectFields({ filePropertyInfo }) {
-    if (this.context.customConfig?.inlineFileProperties) {
+    if (this.context.customConfig?.inlineFileProperties ?? true) {
       return [...filePropertyInfo.fileFields, ...filePropertyInfo.bodyPropertyFields];
     }
     return filePropertyInfo.bodyPropertyFields;
@@ -918786,7 +919383,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.104.0";
+    return "4.105.0-4-g36fd47b6743";
   }
   getCliName() {
     if (false) {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.104.0",
+  "version": "4.105.0-4-g36fd47b6743",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",