@fern-api/fdr-sdk 1.2.39-b5d93657fe → 1.2.39-b6eaa342cf

package/dist/js/navigation/ledger-root-builder.mjs

@@ -1082,6 +1082,63 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2) {
   }
   return void 0;
 }
+function apiLeafPositionKey(node) {
+  switch (node.type) {
+    case "endpoint":
+      return `endpoint:${node.endpointId}`;
+    case "webhook":
+      return `webhook:${node.webhookId}`;
+    case "webSocket":
+      return `webSocket:${node.webSocketId}`;
+    case "grpc":
+      return `grpc:${node.grpcId}`;
+    case "graphql":
+      return `graphql:${node.graphqlOperationId}`;
+  }
+}
+function apiChildPositionKey(node) {
+  switch (node.type) {
+    case "endpoint":
+    case "webhook":
+    case "webSocket":
+    case "grpc":
+    case "graphql":
+      return apiLeafPositionKey(node);
+    default:
+      return void 0;
+  }
+}
+function positionedApiLeafChildren(ctx, nav, apiDefinitionId) {
+  const rawLeafNodes = [];
+  const leafPositions = /* @__PURE__ */ new Map();
+  const nonApiLeafNodes = [];
+  for (let i = 0; i < nav.length; i++) {
+    const route = nav[i];
+    const pos = route.displaySortOrder ?? i;
+    const apiLeaf = apiLeafNodeFromNavRouteInternal(ctx, route, apiDefinitionId);
+    if (apiLeaf != null) {
+      rawLeafNodes.push(apiLeaf);
+      const key = apiLeafPositionKey(apiLeaf);
+      leafPositions.set(key, Math.min(leafPositions.get(key) ?? pos, pos));
+      continue;
+    }
+    const node = artifactToNode(ctx, route);
+    if (node?.type === "page" || node?.type === "link") {
+      nonApiLeafNodes.push({ node, pos });
+    }
+  }
+  const apiLeafNodes = mergeEndpointPairs(ctx, rawLeafNodes, nav);
+  const positionedApiLeafNodes = apiLeafNodes.map((node, index) => {
+    if (node.type === "endpointPair") {
+      const streamPos = leafPositions.get(apiLeafPositionKey(node.stream)) ?? index;
+      const nonStreamPos = leafPositions.get(apiLeafPositionKey(node.nonStream)) ?? index;
+      return { node, pos: Math.min(streamPos, nonStreamPos) };
+    }
+    const key = apiChildPositionKey(node);
+    return { node, pos: key != null ? leafPositions.get(key) ?? index : index };
+  });
+  return [...positionedApiLeafNodes, ...nonApiLeafNodes];
+}
 function collectApiLeafNodesFromNav(routes, basePath, segmentApiDefinitionId2) {
   const ctx = createBuildContext(basePath);
   return routes.map((route) => apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2)).filter((node) => node != null);
@@ -1191,7 +1248,9 @@ function sectionNode(ctx, scoped, sectionChildren, scopePrefix) {
   return {
     type: "section",
     ...defaults,
-    collapsed: metaCollapsed(seg.metadata) ?? defaults.collapsed,
+    // V2 convention: collapsed:false in docs.yml maps to "open-by-default"
+    // so getInitiallyOpenByDefaultNodes picks it up and the UI starts open.
+    collapsed: metaCollapsed(seg.metadata) === false ? "open-by-default" : metaCollapsed(seg.metadata) ?? defaults.collapsed,
     overviewPageId: overviewPageId != null ? PageId(overviewPageId) : void 0,
     noindex: metaBool(overview?.metadata, "noindex") ?? metaBool(seg.metadata, "noindex"),
     collapsible: metaBool(seg.metadata, "collapsible") ?? (metaCollapsed(seg.metadata) != null ? true : void 0),
@@ -1219,8 +1278,7 @@ function directChildApiPackages(parentSection, scopeSegs) {
 }
 function buildApiChildren(ctx, scoped, scopeSegs, apiDefinitionId, scopePrefix) {
   const { seg, nav } = scoped;
-  const rawLeafNodes = nav.map((route) => apiLeafNodeFromNavRouteInternal(ctx, route, apiDefinitionId)).filter((node) => node != null);
-  const leafNodes = mergeEndpointPairs(ctx, rawLeafNodes, nav);
+  const leafNodes = positionedApiLeafChildren(ctx, nav, apiDefinitionId);
   const childPackages = directChildApiPackages(seg.section, scopeSegs);
   const packageNodes = childPackages.map((child) => ({
     node: apiPackageChildNode(
@@ -1234,18 +1292,10 @@ function buildApiChildren(ctx, scoped, scopeSegs, apiDefinitionId, scopePrefix)
   }));
   const hasChildIndex = packageNodes.some((p) => p.childIndex != null);
   if (!hasChildIndex) {
-    return [...leafNodes, ...packageNodes.map((p) => p.node)];
-  }
-  const leafPositions = [];
-  for (const route of nav) {
-    if (route.displaySortOrder != null) {
-      leafPositions.push(route.displaySortOrder);
-    }
+    return [...leafNodes, ...packageNodes.map((p) => ({ node: p.node, pos: Number.MAX_SAFE_INTEGER }))].sort((a, b) => a.pos - b.pos).map((p) => p.node);
   }
   const positioned = [];
-  for (let i = 0; i < leafNodes.length; i++) {
-    positioned.push({ node: leafNodes[i], pos: leafPositions[i] ?? i });
-  }
+  positioned.push(...leafNodes);
   for (const p of packageNodes) {
     positioned.push({ node: p.node, pos: p.childIndex ?? Number.MAX_SAFE_INTEGER });
   }
@@ -1666,6 +1716,24 @@ function buildFullRootFromSegments(options) {
   } else if (child.type === "versioned") {
     const defaultVersion = child.children.find((v) => v.default) ?? child.children[0];
     rootPointsTo = defaultVersion?.pointsTo;
+  } else if (child.type === "unversioned") {
+    if (tabs.length > 0) {
+      const firstTab = tabs[0];
+      const pt = firstTab != null ? metaStr(firstTab.metadata, "pointsTo") : void 0;
+      rootPointsTo = pt != null ? pointsToSlug(pt) : void 0;
+    } else {
+      const sorted = [...scoped].sort((a, b) => a.seg.sortOrder - b.seg.sortOrder);
+      for (const s of sorted) {
+        if (s.seg.hidden) {
+          continue;
+        }
+        const pt = metaStr(s.seg.metadata, "pointsTo");
+        if (pt != null) {
+          rootPointsTo = pointsToSlug(pt);
+          break;
+        }
+      }
+    }
   }
   const root = {
     type: "root",
@@ -1678,21 +1746,22 @@ function buildFullRootFromSegments(options) {
   return root;
 }
 function uniqueDetails(scoped, dim) {
-  const bySlug = /* @__PURE__ */ new Map();
+  const byKey = /* @__PURE__ */ new Map();
   for (const s of scoped) {
     const d = s.seg[dim];
     if (d == null) {
       continue;
     }
     const slug = detailSlug(d);
-    const existing = bySlug.get(slug);
+    const key = dim === "tab" ? d.id : slug !== "" ? slug : d.id;
+    const existing = byKey.get(key);
     if (existing == null) {
-      bySlug.set(slug, d);
+      byKey.set(key, d);
     } else if (metaStr(d.metadata, "pointsTo") != null && metaStr(existing.metadata, "pointsTo") == null) {
-      bySlug.set(slug, d);
+      byKey.set(key, d);
     }
   }
-  return [...bySlug.values()].sort((a, b) => a.sortOrder - b.sortOrder);
+  return [...byKey.values()].sort((a, b) => a.sortOrder - b.sortOrder);
 }
 function scopeSlugPrefix(rootSlug, ...details) {
   const parts = [rootSlug];