@fern-api/fern-api-dev 5.101.2 → 5.102.0

package/cli.cjs

@@ -357882,7 +357882,7 @@ var init_OperationConverter = __esm({
           return void 0;
         }
         const { group, method: method8 } = this.computeGroupNameAndLocationFromExtensions() ?? this.computeGroupNameFromTagAndOperationId();
-        const groupDisplayName = this.getGroupDisplayName(group);
+        const groupDisplayName2 = this.getGroupDisplayName(group);
         const { headers: headers2, pathParameters, queryParameters } = this.convertParameters({
           breadcrumbs: [...this.breadcrumbs, "parameters"]
         });
@@ -358032,7 +358032,7 @@ var init_OperationConverter = __esm({
         return {
           audiences,
           group,
-          groupDisplayName,
+          groupDisplayName: groupDisplayName2,
           errors: topLevelErrors,
           endpoint: {
             ...baseEndpoint,
@@ -703430,7 +703430,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.101.2",
+          version: "5.102.0",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -703496,7 +703496,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.101.2",
+        version: "5.102.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -884878,7 +884878,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.101.2";
+  const version7 = "5.102.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -903930,6 +903930,104 @@ function renderCompoundPage(compound, meta5) {
   }
 }
 
+// ../library-docs-generator/lib/cpp/src/renderers/GroupPageRenderer.js
+function isNamedMember(member) {
+  return member.path.trim().length > 0;
+}
+function collectEntries(items) {
+  return items.filter(isNamedMember).map((item) => ({ displayName: item.path, linkPath: buildLinkPath(item.path) })).sort((a3, b5) => a3.displayName.localeCompare(b5.displayName));
+}
+function collectFunctionEntries(functions2) {
+  const seen = /* @__PURE__ */ new Set();
+  const entries24 = [];
+  for (const func2 of functions2) {
+    if (!isNamedMember(func2)) {
+      continue;
+    }
+    const stripped = stripTemplateArgs(func2.path);
+    if (seen.has(stripped)) {
+      continue;
+    }
+    seen.add(stripped);
+    entries24.push({ displayName: func2.path, linkPath: buildLinkPath(stripped) });
+  }
+  return entries24.sort((a3, b5) => a3.displayName.localeCompare(b5.displayName));
+}
+function collectGroupSections(group) {
+  const classes = group.classes ?? [];
+  const sections = [
+    { heading: "Classes", entries: collectEntries(classes.filter((cls) => cls.kind !== "struct")) },
+    { heading: "Structs", entries: collectEntries(classes.filter((cls) => cls.kind === "struct")) },
+    { heading: "Functions", entries: collectFunctionEntries(group.functions ?? []) },
+    { heading: "Enumerations", entries: collectEntries(group.enums ?? []) },
+    { heading: "Type Definitions", entries: collectEntries(group.typedefs ?? []) },
+    { heading: "Variables", entries: collectEntries(group.variables ?? []) }
+  ];
+  return sections.filter((section) => section.entries.length > 0);
+}
+function groupHasContent(group, visited = /* @__PURE__ */ new Set()) {
+  if (visited.has(group.id)) {
+    return false;
+  }
+  visited.add(group.id);
+  const hasMembers = [group.classes, group.functions, group.enums, group.typedefs, group.variables].some((members) => members != null && members.some(isNamedMember));
+  return hasMembers || group.subgroups.some((subgroup) => groupHasContent(subgroup, visited));
+}
+function renderEntries(entries24, lines) {
+  for (const entry of entries24) {
+    if (entry.linkPath) {
+      lines.push(`- [\`${entry.displayName}\`](${entry.linkPath})`);
+    } else {
+      lines.push(`- \`${entry.displayName}\``);
+    }
+  }
+}
+function renderGroupPage(group, sections, subgroupEntries) {
+  const lines = [];
+  const docstring = group.docstring;
+  const title2 = group.title || group.name;
+  const summaryText = docstring ? renderSegmentsPlainText(docstring.summary) : "";
+  const description = summaryText.length > 0 ? summaryText : `Members of the ${title2} group.`;
+  lines.push(...renderFrontmatter(title2, description));
+  if (docstring?.summary && docstring.summary.length > 0) {
+    const summary = renderSegmentsTrimmed(docstring.summary);
+    if (summary) {
+      lines.push("", summary);
+    }
+  }
+  if (docstring?.description && docstring.description.length > 0) {
+    const desc = renderDescriptionBlocksDeduped(docstring.description, docstring.summary);
+    if (desc) {
+      lines.push("", desc);
+    }
+  }
+  for (const section of sections) {
+    lines.push("", `## ${section.heading}`, "");
+    renderEntries(section.entries, lines);
+  }
+  if (subgroupEntries.length > 0) {
+    lines.push("", "## Subgroups", "");
+    for (const entry of subgroupEntries) {
+      lines.push(`- [${entry.displayName}](${entry.linkPath})`);
+    }
+  }
+  trimTrailingBlankLines(lines);
+  return lines.join("\n") + "\n";
+}
+function renderGroupsIndexPage(entries24, libraryTitle) {
+  const lines = [];
+  const library = libraryTitle.trim();
+  const title2 = library.length > 0 ? `${library} \u2014 Groups` : "Groups";
+  const description = library.length > 0 ? `Documentation groups in ${library}.` : "Documentation groups in this library.";
+  lines.push(...renderFrontmatter(title2, description));
+  lines.push("");
+  for (const entry of entries24) {
+    lines.push(`- [${entry.displayName}](${entry.linkPath})`);
+  }
+  trimTrailingBlankLines(lines);
+  return lines.join("\n") + "\n";
+}
+
 // ../library-docs-generator/lib/cpp/src/renderers/IndexPageRenderer.js
 function collectClassEntries(classes, kind) {
   return classes.filter((cls) => cls.kind === kind).map((cls) => ({
@@ -903943,7 +904041,7 @@ function collectEntityEntries(items) {
     linkPath: buildLinkPath(item.path)
   })).sort((a3, b5) => a3.displayName.localeCompare(b5.displayName));
 }
-function collectFunctionEntries(functions2) {
+function collectFunctionEntries2(functions2) {
   const seen = /* @__PURE__ */ new Set();
   const entries24 = [];
   for (const func2 of functions2) {
@@ -903978,7 +904076,7 @@ var ENTITY_CATEGORIES = [
   {
     folderName: "functions",
     heading: "Functions",
-    collectEntries: (ns2) => collectFunctionEntries(ns2.functions)
+    collectEntries: (ns2) => collectFunctionEntries2(ns2.functions)
   },
   {
     folderName: "enums",
@@ -904003,7 +904101,7 @@ function namespaceHasEntities(ns2) {
   }
   return ns2.namespaces.some((child) => namespaceHasEntities(child));
 }
-function renderNamespaceIndexPage(title2, categories, hasChildNamespaces, nsLastSegment) {
+function renderNamespaceIndexPage(title2, categories, hasChildNamespaces, nsLastSegment, hasGroups = false) {
   const lines = [];
   const descriptionSubject = title2.endsWith(" API Reference") ? title2.replace(/ API Reference$/, "") : title2;
   const description = `API reference for the ${descriptionSubject} namespace.`;
@@ -904015,6 +904113,9 @@ function renderNamespaceIndexPage(title2, categories, hasChildNamespaces, nsLast
   if (hasChildNamespaces) {
     lines.push(`- [Namespaces](${nsLastSegment}/namespaces)`);
   }
+  if (hasGroups) {
+    lines.push(`- [Groups](${nsLastSegment}/groups)`);
+  }
   trimTrailingBlankLines(lines);
   return lines.join("\n") + "\n";
 }
@@ -904107,13 +904208,15 @@ function generateCpp(options2) {
       const content5 = renderCompoundPage(entry.collected.compound, meta5);
       writer2.writePage(entry.pageKey, content5);
     }
+    const groups2 = (ir3.groups ?? []).filter((group) => groupHasContent(group));
     const slugBaseName = slug.includes("/") ? slug.split("/").pop() ?? slug : slug;
     const libraryNs = ir3.rootNamespace.namespaces.find((child) => child.name === slugBaseName);
     if (libraryNs) {
       const title2 = LIBRARY_TITLES[libraryNs.name] ?? `${libraryNs.name} API Reference`;
       const outputFolderSlug = slugifySegment(outputDir.split("/").pop() || slug);
-      generateIndexPages(libraryNs, title2, writer2, rootNsName, outputFolderSlug);
+      generateIndexPages(libraryNs, title2, writer2, rootNsName, outputFolderSlug, groups2.length > 0);
     }
+    generateGroupPages(groups2, writer2, repo.trim() || (rootNsName ?? slug));
     return writer2.result();
   } finally {
     clearEntityRegistry();
@@ -904352,7 +904455,7 @@ var LIBRARY_TITLES = {
   thrust: "Thrust API Reference",
   cuda: "libcudacxx API Reference"
 };
-function generateIndexPages(ns2, title2, writer2, rootNsName, outputFolderSlug) {
+function generateIndexPages(ns2, title2, writer2, rootNsName, outputFolderSlug, hasGroups) {
   if (!namespaceHasEntities(ns2)) {
     return;
   }
@@ -904374,7 +904477,7 @@ function generateIndexPages(ns2, title2, writer2, rootNsName, outputFolderSlug)
     entries: cat.collectEntries(ns2)
   }));
   const nsLastSegment = nsDir ? slugifySegment(nsDir.split("/").pop() || ns2.name) : outputFolderSlug;
-  const indexContent = renderNamespaceIndexPage(title2, categoriesForNsIndex, childrenWithEntities.length > 0, nsLastSegment);
+  const indexContent = renderNamespaceIndexPage(title2, categoriesForNsIndex, childrenWithEntities.length > 0, nsLastSegment, hasGroups);
   writer2.writePage(nsIndexPageKey, indexContent);
   for (const category of nonEmptyCategories) {
     const catPageKey = nsDir ? `${nsDir}/${category.folderName}/index.mdx` : `${category.folderName}/index.mdx`;
@@ -904399,7 +904502,49 @@ function generateIndexPages(ns2, title2, writer2, rootNsName, outputFolderSlug)
     writer2.writePage(nsListPageKey, namespacesContent);
   }
   for (const child of ns2.namespaces) {
-    generateIndexPages(child, `Namespace ${child.path}`, writer2, rootNsName, outputFolderSlug);
+    generateIndexPages(child, `Namespace ${child.path}`, writer2, rootNsName, outputFolderSlug, false);
+  }
+}
+var GROUPS_FOLDER = "groups";
+function groupFolderName(group) {
+  return sanitizeForFilename(group.name || group.title);
+}
+function groupDisplayName(group) {
+  return group.title || group.name;
+}
+function generateGroupPages(renderable, writer2, libraryTitle) {
+  if (renderable.length === 0) {
+    return;
+  }
+  const indexPageKey = `${GROUPS_FOLDER}/index.mdx`;
+  setCurrentPageSlugPath(pageKeyToSlugPath(indexPageKey));
+  const entries24 = renderable.map((group) => ({
+    displayName: groupDisplayName(group),
+    linkPath: `${GROUPS_FOLDER}/${slugifySegment(groupFolderName(group))}`
+  }));
+  writer2.writePage(indexPageKey, renderGroupsIndexPage(entries24, libraryTitle));
+  const written = /* @__PURE__ */ new Set();
+  for (const group of renderable) {
+    writeGroupPage(group, `${GROUPS_FOLDER}/${groupFolderName(group)}`, writer2, written);
+  }
+}
+function writeGroupPage(group, dir, writer2, written) {
+  if (written.has(group.id)) {
+    return;
+  }
+  written.add(group.id);
+  const pageKey = `${dir}/index.mdx`;
+  setCurrentPageSlugPath(pageKeyToSlugPath(pageKey));
+  const sections = collectGroupSections(group);
+  const subgroups = group.subgroups.filter((subgroup) => !written.has(subgroup.id) && groupHasContent(subgroup));
+  const dirSegment = slugifySegment(dir.split("/").pop() ?? "");
+  const subgroupEntries = subgroups.map((subgroup) => ({
+    displayName: groupDisplayName(subgroup),
+    linkPath: `${dirSegment}/${slugifySegment(groupFolderName(subgroup))}`
+  }));
+  writer2.writePage(pageKey, renderGroupPage(group, sections, subgroupEntries));
+  for (const subgroup of subgroups) {
+    writeGroupPage(subgroup, `${dir}/${groupFolderName(subgroup)}`, writer2, written);
   }
 }
 
@@ -910798,7 +910943,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.101.2",
+        cliVersion: "5.102.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -978169,7 +978314,7 @@ function getAutomationContextFromEnv() {
     config_branch: process.env.FERN_CONFIG_BRANCH,
     config_pr_number: process.env.FERN_CONFIG_PR_NUMBER,
     trigger: process.env.GITHUB_EVENT_NAME,
-    cli_version: "5.101.2"
+    cli_version: "5.102.0"
   };
 }
 function isAutomationMode() {
@@ -979001,7 +979146,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.101.2";
+    return "5.102.0";
   }
   getCliName() {
     if (false) {

package/package.json

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