@fern-api/fern-api-dev 3.67.1 → 3.68.0

package/cli.cjs

@@ -1427240,7 +1427240,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "3.67.1",
+          version: "3.68.0",
           usingAccessToken: true
         }
       });
@@ -1427339,7 +1427339,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "3.67.1",
+        version: "3.68.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -1483554,6 +1483554,9 @@ var Language4 = schemas_exports8.enum_([
   "tr"
 ]);
 
+// ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/TitleSource.js
+var TitleSource2 = schemas_exports8.enum_(["frontmatter", "filename"]);
+
 // ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/DocsSettingsConfig.js
 var DocsSettingsConfig = schemas_exports8.object({
   searchText: schemas_exports8.property("search-text", schemas_exports8.string().optional()),
@@ -1483566,6 +1483569,7 @@ var DocsSettingsConfig = schemas_exports8.object({
   disableExplorerProxy: schemas_exports8.property("disable-explorer-proxy", schemas_exports8.boolean().optional()),
   disableAnalytics: schemas_exports8.property("disable-analytics", schemas_exports8.boolean().optional()),
   language: Language4.optional(),
+  folderTitleSource: schemas_exports8.property("folder-title-source", TitleSource2.optional()),
   substituteEnvVars: schemas_exports8.property("substitute-env-vars", schemas_exports8.boolean().optional())
 });
 
@@ -1483982,9 +1483986,6 @@ var DocsConfiguration = schemas_exports8.object({
   footer: schemas_exports8.string().optional()
 });
 
-// ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/TitleSource.js
-var TitleSource2 = schemas_exports8.enum_(["frontmatter", "filename"]);
-
 // ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/FolderConfiguration.js
 var FolderConfiguration = schemas_exports8.object({
   folder: schemas_exports8.string(),
@@ -1509002,6 +1509003,7 @@ async function parseDocsConfiguration({ rawDocsConfiguration, absolutePathToFern
     experimental
   } = rawDocsConfiguration;
   const landingPage = parsePageConfig(rawDocsConfiguration.landingPage, absoluteFilepathToDocsConfig);
+  const folderTitleSource = rawDocsConfiguration.settings?.folderTitleSource;
   const convertedNavigationPromise = getNavigationConfiguration({
     tabs,
     products,
@@ -1509009,7 +1509011,8 @@ async function parseDocsConfiguration({ rawDocsConfiguration, absolutePathToFern
     navigation: rawNavigation,
     absolutePathToFernFolder,
     absolutePathToConfig: absoluteFilepathToDocsConfig,
-    context: context2
+    context: context2,
+    folderTitleSource
   });
   const pagesPromise = convertedNavigationPromise.then((convertedNavigation) => loadAllPages({
     files: getAllPages({ navigation: convertedNavigation, landingPage }),
@@ -1509290,7 +1509293,7 @@ function parseSizeConfig(sizeAsString) {
   }
   return void 0;
 }
-async function getVersionedNavigationConfiguration({ versions, absolutePathToFernFolder, context: context2 }) {
+async function getVersionedNavigationConfiguration({ versions, absolutePathToFernFolder, context: context2, folderTitleSource }) {
   const versionedNavbars = [];
   for (const version7 of versions) {
     const absoluteFilepathToVersionFile = resolve5(absolutePathToFernFolder, version7.path);
@@ -1509306,7 +1509309,8 @@ async function getVersionedNavigationConfiguration({ versions, absolutePathToFer
       rawNavigationConfig: versionResult.navigation,
       absolutePathToFernFolder,
       absolutePathToConfig: absoluteFilepathToVersionFile,
-      context: context2
+      context: context2,
+      folderTitleSource
     });
     versionedNavbars.push({
       landingPage: parsePageConfig(versionResult.landingPage, absoluteFilepathToVersionFile),
@@ -1509326,14 +1509330,15 @@ async function getVersionedNavigationConfiguration({ versions, absolutePathToFer
     versions: versionedNavbars
   };
 }
-async function getNavigationConfiguration({ tabs, products, versions, navigation, absolutePathToFernFolder, absolutePathToConfig, context: context2 }) {
+async function getNavigationConfiguration({ tabs, products, versions, navigation, absolutePathToFernFolder, absolutePathToConfig, context: context2, folderTitleSource }) {
   if (navigation != null) {
     return await convertNavigationConfiguration({
       tabs,
       rawNavigationConfig: navigation,
       absolutePathToFernFolder,
       absolutePathToConfig,
-      context: context2
+      context: context2,
+      folderTitleSource
     });
   } else if (products != null) {
     const productNavbars = [];
@@ -1509353,7 +1509358,8 @@ async function getNavigationConfiguration({ tabs, products, versions, navigation
           navigation2 = await getVersionedNavigationConfiguration({
             versions: product.versions,
             absolutePathToFernFolder,
-            context: context2
+            context: context2,
+            folderTitleSource
           });
         } else {
           navigation2 = await convertNavigationConfiguration({
@@ -1509361,7 +1509367,8 @@ async function getNavigationConfiguration({ tabs, products, versions, navigation
             rawNavigationConfig: result.navigation,
             absolutePathToFernFolder,
             absolutePathToConfig: absoluteFilepathToProductFile,
-            context: context2
+            context: context2,
+            folderTitleSource
           });
         }
         productNavbars.push({
@@ -1509400,7 +1509407,12 @@ async function getNavigationConfiguration({ tabs, products, versions, navigation
       products: productNavbars
     };
   } else if (versions != null) {
-    return await getVersionedNavigationConfiguration({ versions, absolutePathToFernFolder, context: context2 });
+    return await getVersionedNavigationConfiguration({
+      versions,
+      absolutePathToFernFolder,
+      context: context2,
+      folderTitleSource
+    });
   }
   throw new Error("Unexpected. Docs have neither navigation or versions defined.");
 }
@@ -1509497,7 +1509509,7 @@ function parseWeight(weight) {
   const weights = weight.split(/\D+/).filter((item) => item !== "" && ["100", "200", "300", "400", "500", "600", "700", "800", "900"].includes(item));
   return weights;
 }
-async function convertNavigationTabConfiguration({ tabs, item, absolutePathToFernFolder, absolutePathToConfig, context: context2 }) {
+async function convertNavigationTabConfiguration({ tabs, item, absolutePathToFernFolder, absolutePathToConfig, context: context2, folderTitleSource }) {
   const tab2 = tabs[item.tab];
   if (tab2 == null) {
     throw new Error(`Tab ${item.tab} is not defined in the tabs config.`);
@@ -1509508,7 +1509520,8 @@ async function convertNavigationTabConfiguration({ tabs, item, absolutePathToFer
         rawConfig: layoutItem,
         absolutePathToFernFolder,
         absolutePathToConfig,
-        context: context2
+        context: context2,
+        folderTitleSource
       })));
       return {
         title: variant.title,
@@ -1509540,7 +1509553,13 @@ async function convertNavigationTabConfiguration({ tabs, item, absolutePathToFer
     };
   }
   if (tabbedNavigationItemHasLayout(item)) {
-    const layout = await Promise.all(item.layout.map((item2) => convertNavigationItem({ rawConfig: item2, absolutePathToFernFolder, absolutePathToConfig, context: context2 })));
+    const layout = await Promise.all(item.layout.map((item2) => convertNavigationItem({
+      rawConfig: item2,
+      absolutePathToFernFolder,
+      absolutePathToConfig,
+      context: context2,
+      folderTitleSource
+    })));
     return {
       title: tab2.displayName,
       icon: resolveIconPath(tab2.icon, absolutePathToConfig),
@@ -1509591,14 +1509610,15 @@ async function convertNavigationTabConfiguration({ tabs, item, absolutePathToFer
   }
   assertNever2(tab2);
 }
-async function convertNavigationConfiguration({ tabs = {}, rawNavigationConfig, absolutePathToFernFolder, absolutePathToConfig, context: context2 }) {
+async function convertNavigationConfiguration({ tabs = {}, rawNavigationConfig, absolutePathToFernFolder, absolutePathToConfig, context: context2, folderTitleSource }) {
   if (isTabbedNavigationConfig4(rawNavigationConfig)) {
     const tabbedNavigationItems = await Promise.all(rawNavigationConfig.map((item) => convertNavigationTabConfiguration({
       tabs,
       item,
       absolutePathToFernFolder,
       absolutePathToConfig,
-      context: context2
+      context: context2,
+      folderTitleSource
     })));
     return {
       type: "tabbed",
@@ -1509607,24 +1509627,31 @@ async function convertNavigationConfiguration({ tabs = {}, rawNavigationConfig,
   } else {
     return {
       type: "untabbed",
-      items: await Promise.all(rawNavigationConfig.map((item) => convertNavigationItem({ rawConfig: item, absolutePathToFernFolder, absolutePathToConfig, context: context2 })))
+      items: await Promise.all(rawNavigationConfig.map((item) => convertNavigationItem({
+        rawConfig: item,
+        absolutePathToFernFolder,
+        absolutePathToConfig,
+        context: context2,
+        folderTitleSource
+      })))
     };
   }
 }
 var DEFAULT_CHANGELOG_TITLE = "Changelog";
-async function expandFolderConfiguration({ rawConfig, absolutePathToFernFolder, absolutePathToConfig, context: context2 }) {
+async function expandFolderConfiguration({ rawConfig, absolutePathToFernFolder, absolutePathToConfig, context: context2, folderTitleSource }) {
   const folderPath = resolveFilepath(rawConfig.folder, absolutePathToConfig);
   if (!await doesPathExist(folderPath)) {
     context2.failAndThrow(`Folder not found: ${rawConfig.folder}`);
   }
+  const effectiveTitleSource = rawConfig.titleSource ?? folderTitleSource;
   const contents = await buildNavigationForDirectory({
     directoryPath: folderPath,
-    titleSource: rawConfig.titleSource
+    titleSource: effectiveTitleSource
   });
   const indexPage = contents.find((item) => item.type === "page" && (item.slug === "index" || item.absolutePath.toLowerCase().endsWith("/index.mdx") || item.absolutePath.toLowerCase().endsWith("/index.md")));
   const filteredContents = indexPage ? contents.filter((item) => item !== indexPage) : contents;
   const folderName = import_path20.default.basename(folderPath);
-  const indexFrontmatterTitle = rawConfig.titleSource === "frontmatter" && indexPage?.type === "page" ? await getFrontmatterTitle({ absolutePath: indexPage.absolutePath }) : void 0;
+  const indexFrontmatterTitle = effectiveTitleSource === "frontmatter" && indexPage?.type === "page" ? await getFrontmatterTitle({ absolutePath: indexPage.absolutePath }) : void 0;
   const title4 = rawConfig.title ?? indexFrontmatterTitle ?? nameToTitle({ name: folderName });
   const slug = rawConfig.slug ?? nameToSlug({ name: folderName });
   return {
@@ -1509643,7 +1509670,7 @@ async function expandFolderConfiguration({ rawConfig, absolutePathToFernFolder,
     availability: rawConfig.availability
   };
 }
-async function convertNavigationItem({ rawConfig, absolutePathToFernFolder, absolutePathToConfig, context: context2 }) {
+async function convertNavigationItem({ rawConfig, absolutePathToFernFolder, absolutePathToConfig, context: context2, folderTitleSource }) {
   if (isRawPageConfig(rawConfig)) {
     return parsePageConfig(rawConfig, absolutePathToConfig);
   }
@@ -1509652,7 +1509679,13 @@ async function convertNavigationItem({ rawConfig, absolutePathToFernFolder, abso
       type: "section",
       title: rawConfig.section,
       icon: resolveIconPath(rawConfig.icon, absolutePathToConfig),
-      contents: await Promise.all(rawConfig.contents.map((item) => convertNavigationItem({ rawConfig: item, absolutePathToFernFolder, absolutePathToConfig, context: context2 }))),
+      contents: await Promise.all(rawConfig.contents.map((item) => convertNavigationItem({
+        rawConfig: item,
+        absolutePathToFernFolder,
+        absolutePathToConfig,
+        context: context2,
+        folderTitleSource
+      }))),
       slug: rawConfig.slug ?? void 0,
       collapsed: rawConfig.collapsed ?? void 0,
       hidden: rawConfig.hidden ?? void 0,
@@ -1509719,7 +1509752,8 @@ async function convertNavigationItem({ rawConfig, absolutePathToFernFolder, abso
       rawConfig,
       absolutePathToFernFolder,
       absolutePathToConfig,
-      context: context2
+      context: context2,
+      folderTitleSource
     });
   }
   if (isRawPythonDocsSectionConfig(rawConfig)) {
@@ -1624937,6 +1624971,16 @@ var definitions4 = {
           }
         ]
       },
+      "folder-title-source": {
+        oneOf: [
+          {
+            $ref: "#/definitions/docs.TitleSource"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
       "substitute-env-vars": {
         oneOf: [
           {
@@ -1714270,7 +1714314,7 @@ var CliContext = class {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "3.67.1";
+    return "3.68.0";
   }
   getCliName() {
     if (false) {
@@ -1717390,7 +1717434,7 @@ var import_path56 = __toESM(require("path"), 1);
 var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 function getCliSource() {
-  const version7 = "3.67.1";
+  const version7 = "3.68.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.67.1",
+  "version": "3.68.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",