@fern-api/fern-api-dev 3.61.0 → 3.62.0

package/cli.cjs

@@ -1465102,6 +1465102,7 @@ __export(schemas_exports9, {
   TabsPlacement: () => TabsPlacement2,
   TabsThemeConfig: () => TabsThemeConfig,
   Target: () => Target,
+  TitleSource: () => TitleSource,
   TwitterCardSetting: () => TwitterCardSetting3,
   VersionAvailability: () => VersionAvailability,
   docs: () => docs_exports4,
@@ -1465136,6 +1465137,7 @@ __export(api_exports6, {
   TabsPlacement: () => TabsPlacement2,
   TabsThemeConfig: () => TabsThemeConfig,
   Target: () => Target,
+  TitleSource: () => TitleSource,
   TwitterCardSetting: () => TwitterCardSetting3,
   VersionAvailability: () => VersionAvailability,
   docs: () => docs_exports4
@@ -1465168,6 +1465170,7 @@ __export(docs_exports4, {
   TabsPlacement: () => TabsPlacement2,
   TabsThemeConfig: () => TabsThemeConfig,
   Target: () => Target,
+  TitleSource: () => TitleSource,
   TwitterCardSetting: () => TwitterCardSetting3,
   VersionAvailability: () => VersionAvailability
 });
@@ -1465373,6 +1465376,12 @@ var Target = {
   Top: "_top"
 };
 
+// ../configuration/lib/docs-yml/schemas/sdk/api/resources/docs/types/TitleSource.js
+var TitleSource = {
+  Frontmatter: "frontmatter",
+  Filename: "filename"
+};
+
 // ../configuration/lib/docs-yml/schemas/sdk/api/resources/docs/types/TwitterCardSetting.js
 var TwitterCardSetting3 = {
   Summary: "summary",
@@ -1465685,6 +1465694,7 @@ __export(serialization_exports4, {
   TabsThemeConfig: () => TabsThemeConfig2,
   Target: () => Target2,
   ThemeConfig: () => ThemeConfig,
+  TitleSource: () => TitleSource2,
   TwitterCardSetting: () => TwitterCardSetting4,
   UntabbedNavigationConfig: () => UntabbedNavigationConfig,
   VersionAvailability: () => VersionAvailability2,
@@ -1465815,6 +1465825,7 @@ __export(docs_exports5, {
   TabsThemeConfig: () => TabsThemeConfig2,
   Target: () => Target2,
   ThemeConfig: () => ThemeConfig,
+  TitleSource: () => TitleSource2,
   TwitterCardSetting: () => TwitterCardSetting4,
   UntabbedNavigationConfig: () => UntabbedNavigationConfig,
   VersionAvailability: () => VersionAvailability2,
@@ -1467999,10 +1468010,14 @@ 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(),
   title: schemas_exports8.string().optional(),
+  titleSource: schemas_exports8.property("title-source", TitleSource2.optional()),
   slug: schemas_exports8.string().optional(),
   icon: schemas_exports8.string().optional(),
   hidden: schemas_exports8.boolean().optional(),
@@ -1495285,15 +1495300,31 @@ async function getFrontmatterPosition({ absolutePath, readFileFn = (path86, enco
     return void 0;
   }
 }
-async function buildNavigationForDirectory({ directoryPath, getDir = getDirectoryContents, readFileFn = (path86, encoding) => (0, import_promises14.readFile)(path86, encoding) }) {
+async function getFrontmatterTitle({ absolutePath, readFileFn = (path86, encoding) => (0, import_promises14.readFile)(path86, encoding) }) {
+  try {
+    const content5 = await readFileFn(absolutePath, "utf-8");
+    const { data: data2 } = (0, import_gray_matter.default)(content5);
+    if (typeof data2.title === "string" && data2.title.trim().length > 0) {
+      return data2.title.trim();
+    }
+    return void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function buildNavigationForDirectory({ directoryPath, titleSource, getDir = getDirectoryContents, readFileFn = (path86, encoding) => (0, import_promises14.readFile)(path86, encoding) }) {
   const contents = await getDir(directoryPath);
+  const useFrontmatterTitles = titleSource === "frontmatter";
   const markdownFiles = contents.filter((item) => item.type === "file" && (item.name.toLowerCase().endsWith(".md") || item.name.toLowerCase().endsWith(".mdx")));
   const subdirectories = contents.filter((item) => item.type === "directory");
-  const pagePositions = await Promise.all(markdownFiles.map((file4) => getFrontmatterPosition({ absolutePath: file4.absolutePath, readFileFn })));
-  const pages = markdownFiles.map((file4) => {
+  const [pagePositions, pageTitles] = await Promise.all([
+    Promise.all(markdownFiles.map((file4) => getFrontmatterPosition({ absolutePath: file4.absolutePath, readFileFn }))),
+    useFrontmatterTitles ? Promise.all(markdownFiles.map((file4) => getFrontmatterTitle({ absolutePath: file4.absolutePath, readFileFn }))) : Promise.resolve(markdownFiles.map(() => void 0))
+  ]);
+  const pages = markdownFiles.map((file4, index3) => {
     return {
       type: "page",
-      title: nameToTitle({ name: file4.name }),
+      title: pageTitles[index3] ?? nameToTitle({ name: file4.name }),
       absolutePath: file4.absolutePath,
       slug: nameToSlug({ name: file4.name }),
       icon: void 0,
@@ -1495308,14 +1495339,17 @@ async function buildNavigationForDirectory({ directoryPath, getDir = getDirector
   const sections = await Promise.all(subdirectories.map(async (dir) => {
     const subContents = await buildNavigationForDirectory({
       directoryPath: dir.absolutePath,
+      titleSource,
       getDir,
       readFileFn
     });
     const indexPage = subContents.find((item) => item.type === "page" && (item.slug === "index" || item.absolutePath.toLowerCase().endsWith("/index.mdx") || item.absolutePath.toLowerCase().endsWith("/index.md")));
     const filteredContents = indexPage ? subContents.filter((item) => item !== indexPage) : subContents;
+    const indexFileFrontmatterTitle = useFrontmatterTitles ? indexPage?.type === "page" ? await getFrontmatterTitle({ absolutePath: indexPage.absolutePath, readFileFn }) : void 0 : void 0;
+    const sectionTitle = indexFileFrontmatterTitle ?? nameToTitle({ name: dir.name });
     return {
       type: "section",
-      title: nameToTitle({ name: dir.name }),
+      title: sectionTitle,
       slug: nameToSlug({ name: dir.name }),
       icon: void 0,
       contents: filteredContents,
@@ -1612209,6 +1612243,13 @@ var definitions4 = {
     ],
     additionalProperties: false
   },
+  "docs.TitleSource": {
+    type: "string",
+    enum: [
+      "frontmatter",
+      "filename"
+    ]
+  },
   "docs.FolderConfiguration": {
     type: "object",
     properties: {
@@ -1612255,6 +1612296,16 @@ var definitions4 = {
           }
         ]
       },
+      "title-source": {
+        oneOf: [
+          {
+            $ref: "#/definitions/docs.TitleSource"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
       slug: {
         oneOf: [
           {
@@ -1678913,7 +1678964,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "3.61.0",
+          version: "3.62.0",
           usingAccessToken: true
         }
       });
@@ -1678963,7 +1679014,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "3.61.0",
+        version: "3.62.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -1710885,7 +1710936,7 @@ var CliContext = class {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "3.61.0";
+    return "3.62.0";
   }
   getCliName() {
     if (false) {
@@ -1713999,7 +1714050,7 @@ var import_path56 = __toESM(require("path"), 1);
 var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 function getCliSource() {
-  const version7 = "3.61.0";
+  const version7 = "3.62.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -1718361,6 +1718412,13 @@ var definitions5 = {
     ],
     additionalProperties: false
   },
+  "docs.TitleSource": {
+    type: "string",
+    enum: [
+      "frontmatter",
+      "filename"
+    ]
+  },
   "docs.FolderConfiguration": {
     type: "object",
     properties: {
@@ -1718407,6 +1718465,16 @@ var definitions5 = {
           }
         ]
       },
+      "title-source": {
+        oneOf: [
+          {
+            $ref: "#/definitions/docs.TitleSource"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
       slug: {
         oneOf: [
           {
@@ -1720198,6 +1720266,13 @@ var definitions6 = {
     ],
     additionalProperties: false
   },
+  "docs.TitleSource": {
+    type: "string",
+    enum: [
+      "frontmatter",
+      "filename"
+    ]
+  },
   "docs.FolderConfiguration": {
     type: "object",
     properties: {
@@ -1720244,6 +1720319,16 @@ var definitions6 = {
           }
         ]
       },
+      "title-source": {
+        oneOf: [
+          {
+            $ref: "#/definitions/docs.TitleSource"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
       slug: {
         oneOf: [
           {

package/package.json

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