@fern-api/fdr-sdk 1.2.42-b174eece86 → 1.2.42-e01a8637c3

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

@@ -1259,6 +1259,30 @@ function stripLeadingScopePrefix(section, scopePrefix) {
   }
   return section;
 }
+function computeDuplicateSiblingSortBoundaries(siblings) {
+  const result = /* @__PURE__ */ new Map();
+  const byPath = /* @__PURE__ */ new Map();
+  for (const sibling of siblings) {
+    if (metaStr(sibling.seg.metadata, "type") !== "section") {
+      continue;
+    }
+    const group = byPath.get(sibling.seg.section) ?? [];
+    group.push(sibling);
+    byPath.set(sibling.seg.section, group);
+  }
+  for (const [, group] of byPath) {
+    if (group.length <= 1) {
+      continue;
+    }
+    for (let i = 0; i < group.length; i++) {
+      result.set(group[i], {
+        lo: group[i].seg.sortOrder,
+        hi: i + 1 < group.length ? group[i + 1].seg.sortOrder : Number.MAX_SAFE_INTEGER
+      });
+    }
+  }
+  return result;
+}
 function mergeChildrenByPosition(ctx, nav, sectionChildren) {
   const leafNodes = [];
   for (let i = 0; i < nav.length; i++) {
@@ -1313,12 +1337,15 @@ function sectionNode(ctx, scoped, sectionChildren, scopePrefix) {
     children: mergeChildrenByPosition(ctx, nav, sectionChildren)
   };
 }
-function directChildApiPackages(parentSection, scopeSegs) {
+function directChildApiPackages(parentSection, scopeSegs, apiDefinitionId) {
   const sectionPaths = new Set(scopeSegs.map((s) => s.seg.section));
   return scopeSegs.filter((s) => {
     if (metaStr(s.seg.metadata, "type") !== "apiPackage") {
       return false;
     }
+    if (metaStr(s.seg.metadata, "apiDefinitionId") !== apiDefinitionId) {
+      return false;
+    }
     const parent = parentSectionPath(s.seg.section);
     if (parent === parentSection) {
       return true;
@@ -1332,7 +1359,17 @@ function directChildApiPackages(parentSection, scopeSegs) {
 function buildApiChildren(ctx, scoped, scopeSegs, apiDefinitionId, scopePrefix) {
   const { seg, nav } = scoped;
   const leafNodes = positionedApiLeafChildren(ctx, nav, apiDefinitionId);
-  const childPackages = directChildApiPackages(seg.section, scopeSegs);
+  let childPackages = directChildApiPackages(seg.section, scopeSegs, apiDefinitionId);
+  const samePathApiSiblings = scopeSegs.filter(
+    (s) => s.seg.section === seg.section && s.seg.sortOrder !== seg.sortOrder && API_NODE_SEGMENT_TYPES.has(metaStr(s.seg.metadata, "type") ?? "")
+  );
+  const hasCollapsedGroups = samePathApiSiblings.length > 0;
+  if (hasCollapsedGroups && metaStr(seg.metadata, "type") !== "apiReference") {
+    const nextSibling = samePathApiSiblings.filter((s) => s.seg.sortOrder > seg.sortOrder).sort((a, b) => a.seg.sortOrder - b.seg.sortOrder)[0];
+    const lo = seg.sortOrder;
+    const hi = nextSibling?.seg.sortOrder ?? Number.MAX_SAFE_INTEGER;
+    childPackages = childPackages.filter((c) => c.seg.sortOrder > lo && c.seg.sortOrder < hi);
+  }
   const packageNodes = childPackages.map((child) => ({
     node: apiPackageChildNode(
       ctx,
@@ -1343,6 +1380,9 @@ function buildApiChildren(ctx, scoped, scopeSegs, apiDefinitionId, scopePrefix)
     ),
     childIndex: metaNum(child.seg.metadata, "childIndex")
   }));
+  if (hasCollapsedGroups && metaStr(seg.metadata, "type") === "apiReference") {
+    return [...leafNodes, ...packageNodes.map((p, i) => ({ node: p.node, pos: leafNodes.length + i }))].sort((a, b) => a.pos - b.pos).map((p) => p.node);
+  }
   const hasChildIndex = packageNodes.some((p) => p.childIndex != null);
   if (!hasChildIndex) {
     return [...leafNodes, ...packageNodes.map((p) => ({ node: p.node, pos: Number.MAX_SAFE_INTEGER }))].sort((a, b) => a.pos - b.pos).map((p) => p.node);
@@ -1473,7 +1513,7 @@ function apiReferenceNode(ctx, scoped, scopeSegs, scopePrefix) {
     availability: metaAvailability(seg.metadata),
     overviewPageId: overviewPageId != null ? PageId(overviewPageId) : void 0,
     noindex: metaBool(overview?.metadata, "noindex") ?? metaBool(seg.metadata, "noindex"),
-    paginated: true,
+    paginated: metaBool(seg.metadata, "paginated"),
     showErrors: metaBool(seg.metadata, "showErrors"),
     hideTitle: metaBool(seg.metadata, "hideTitle"),
     pointsTo: metaPointsTo != null ? pointsToSlug(metaPointsTo) : void 0,
@@ -1491,7 +1531,10 @@ function attachedApiChangelogNode(ctx, scoped, scopeSegs, apiDefinitionId, scope
     }
     return metaStr(candidate.seg.metadata, "apiDefinitionId") === apiDefinitionId;
   });
-  const changelogSeg = candidates.find((candidate) => parentSectionPath(candidate.seg.section) === seg.section) ?? candidates[0];
+  const apiReferenceCount = scopeSegs.filter((candidate) => {
+    return metaStr(candidate.seg.metadata, "type") === "apiReference" && metaStr(candidate.seg.metadata, "apiDefinitionId") === apiDefinitionId;
+  }).length;
+  const changelogSeg = candidates.find((candidate) => parentSectionPath(candidate.seg.section) === seg.section) ?? (apiReferenceCount === 1 ? candidates[0] : void 0);
   return changelogSeg != null ? changelogNode(ctx, changelogSeg, scopePrefix) : void 0;
 }
 function hasOwningApiReference(scoped, scopeSegs) {
@@ -1499,12 +1542,13 @@ function hasOwningApiReference(scoped, scopeSegs) {
   if (apiDefinitionId == null || metaStr(scoped.seg.metadata, "type") !== "changelog") {
     return false;
   }
-  return scopeSegs.some((candidate) => {
+  const candidates = scopeSegs.filter((candidate) => {
     if (metaStr(candidate.seg.metadata, "type") !== "apiReference") {
       return false;
     }
     return metaStr(candidate.seg.metadata, "apiDefinitionId") === apiDefinitionId;
   });
+  return candidates.some((candidate) => parentSectionPath(scoped.seg.section) === candidate.seg.section) || candidates.length === 1;
 }
 function isNestedApiPackage(scoped, scopeSegs) {
   if (metaStr(scoped.seg.metadata, "type") !== "apiPackage") {
@@ -1650,6 +1694,10 @@ function buildSectionTree(ctx, scopeSegs, parentPath, scopePrefix, changelogScop
     if (hasOwningApiReference(s, scopeSegs) || isNestedApiPackage(s, scopeSegs)) {
       return false;
     }
+    const depth = metaNum(s.seg.metadata, "sidebarDepth");
+    if (depth === 0) {
+      return false;
+    }
     const parent = parentSectionPath(sec);
     if (parent === parentPath) {
       return true;
@@ -1659,6 +1707,7 @@ function buildSectionTree(ctx, scopeSegs, parentPath, scopePrefix, changelogScop
     }
     return false;
   }).sort((a, b) => a.seg.sortOrder - b.seg.sortOrder);
+  const siblingBoundaries = computeDuplicateSiblingSortBoundaries(direct);
   return direct.map((s) => {
     const type = metaStr(s.seg.metadata, "type");
     const childIndex = metaNum(s.seg.metadata, "childIndex");
@@ -1668,10 +1717,14 @@ function buildSectionTree(ctx, scopeSegs, parentPath, scopePrefix, changelogScop
     } else if (type === "changelog") {
       node = changelogNode(ctx, s, changelogScopePrefix ?? scopePrefix);
     } else {
+      const boundary = siblingBoundaries.get(s);
+      const childScopeSegs = boundary != null ? scopeSegs.filter(
+        (candidate) => candidate.seg.sortOrder >= boundary.lo && candidate.seg.sortOrder < boundary.hi
+      ) : scopeSegs;
       node = sectionNode(
         ctx,
         s,
-        buildSectionTree(ctx, scopeSegs, s.seg.section, scopePrefix, changelogScopePrefix),
+        buildSectionTree(ctx, childScopeSegs, s.seg.section, scopePrefix, changelogScopePrefix),
         scopePrefix
       );
     }
@@ -1685,11 +1738,16 @@ function computeSiblingSortBoundaries(ordered) {
   for (const s of ordered) {
     const type = metaStr(s.seg.metadata, "type");
     const sec = s.seg.section;
-    if (type !== "section" || sec === "") {
+    if (type !== "section") {
+      continue;
+    }
+    if (sec === "") {
+      rootSections.push(s);
       continue;
     }
+    const depth = metaNum(s.seg.metadata, "sidebarDepth");
     const parent = parentSectionPath(sec);
-    const isRootLevel = parent === "" || !sectionPaths.has(parent) && nearestExistingAncestor(sec, sectionPaths) === "";
+    const isRootLevel = depth === 0 || parent === "" || !sectionPaths.has(parent) && nearestExistingAncestor(sec, sectionPaths) === "";
     if (isRootLevel) {
       rootSections.push(s);
     }
@@ -1716,14 +1774,24 @@ function buildSidebarRootChildren(ctx, scopeSegs, scopePrefix, changelogScopePre
   const ordered = [...scopeSegs].sort((a, b) => a.seg.sortOrder - b.seg.sortOrder);
   const sectionPaths = new Set(ordered.map((s) => s.seg.section));
   const annotated = [];
-  const hasRootSection = ordered.some((s) => metaStr(s.seg.metadata, "type") === "section" && s.seg.section === "");
   const siblingBoundaries = computeSiblingSortBoundaries(ordered);
+  const hasRootSection = ordered.some(
+    (s) => metaStr(s.seg.metadata, "type") === "section" && s.seg.section === "" && (metaNum(s.seg.metadata, "childIndex") == null || siblingBoundaries.has(s))
+  );
   for (const s of ordered) {
     const type = metaStr(s.seg.metadata, "type");
     const sec = s.seg.section;
     if (hasOwningApiReference(s, scopeSegs) || isNestedApiPackage(s, scopeSegs)) {
       continue;
     }
+    if (type === "apiPackage") {
+      const hasApiRefSibling = ordered.some(
+        (sib) => sib.seg.section === sec && metaStr(sib.seg.metadata, "type") === "apiReference"
+      );
+      if (hasApiRefSibling) {
+        continue;
+      }
+    }
     if (type === "tabRoot" && metaBool(s.seg.metadata, "landingPage") === true) {
       continue;
     }
@@ -1736,15 +1804,18 @@ function buildSidebarRootChildren(ctx, scopeSegs, scopePrefix, changelogScopePre
       }
       continue;
     }
-    if (type === "section" && sec === "") {
-      const sectionChildren = buildSectionTree(ctx, scopeSegs, "", scopePrefix);
+    if (type === "section" && sec === "" && hasRootSection) {
+      const bounds = siblingBoundaries.get(s);
+      const ownedSegs = bounds != null ? scopeSegs.filter((seg) => seg.seg.sortOrder >= bounds.lo && seg.seg.sortOrder < bounds.hi) : scopeSegs;
+      const sectionChildren = buildSectionTree(ctx, ownedSegs, "", scopePrefix, changelogScopePrefix);
       const node = sectionNode(ctx, s, sectionChildren, scopePrefix);
       annotated.push({ node, pos: metaNum(s.seg.metadata, "childIndex"), isLeaf: false });
       continue;
     }
+    const depth = metaNum(s.seg.metadata, "sidebarDepth");
     const parent = parentSectionPath(sec);
-    const isRootLevel = parent === "" || !sectionPaths.has(parent) && nearestExistingAncestor(sec, sectionPaths) === "";
-    if (isRootLevel && hasRootSection && sec !== "") {
+    const isRootLevel = depth === 0 || parent === "" || !sectionPaths.has(parent) && nearestExistingAncestor(sec, sectionPaths) === "";
+    if (isRootLevel && hasRootSection && sec !== "" && depth == null) {
       continue;
     }
     if (isRootLevel) {
@@ -1756,12 +1827,9 @@ function buildSidebarRootChildren(ctx, scopeSegs, scopePrefix, changelogScopePre
       } else {
         const bounds = siblingBoundaries.get(s);
         const ownedSegs = bounds != null ? scopeSegs.filter((seg) => seg.seg.sortOrder >= bounds.lo && seg.seg.sortOrder < bounds.hi) : scopeSegs;
-        node = sectionNode(
-          ctx,
-          s,
-          buildSectionTree(ctx, ownedSegs, sec, scopePrefix, changelogScopePrefix),
-          scopePrefix
-        );
+        const isUnboundedSkipSlugSibling = sec === "" && metaNum(s.seg.metadata, "childIndex") != null && bounds == null;
+        const sectionChildren = isUnboundedSkipSlugSibling ? [] : buildSectionTree(ctx, ownedSegs, sec, scopePrefix, changelogScopePrefix);
+        node = sectionNode(ctx, s, sectionChildren, scopePrefix);
       }
       const isSharedSection = siblingBoundaries.size > 0 && scopePrefix !== "" && sec !== "" && !sec.startsWith(scopePrefix);
       annotated.push({
@@ -1799,10 +1867,6 @@ function groupSidebarRootChildren(ctx, children) {
     } else if (child.type === "section" && !child.collapsible) {
       flushRun();
       out.push(child);
-    } else if (child.type === "changelog") {
-      flushRun();
-      run.push(child);
-      flushRun();
     } else {
       run.push(child);
     }
@@ -1917,7 +1981,7 @@ function buildVariantedNode(ctx, variants, scopeSegs, scopePrefix) {
     const variantIndividualSlug = detailSlug(variant);
     const variantSlug = variantIndividualSlug !== "" ? asSlug(slugjoin(scopePrefix, variantIndividualSlug)) : scopePrefix;
     const metaPointsTo = metaStr(variant.metadata, "pointsTo");
-    const children = buildSidebarRootChildren(ctx, variantSegs, scopePrefix);
+    const children = buildSidebarRootChildren(ctx, variantSegs, variantSlug);
     return {
       type: "variant",
       ...withMetadataDefaults({
@@ -2319,6 +2383,7 @@ function buildProductGroup(ctx, products, scoped, rootSlug, skipSharedSectionMer
     };
     return node;
   });
+  markCrossProductCanonicalSlugs(children);
   return {
     type: "productgroup",
     id: ctx.nodeId("productgroup"),
@@ -2330,6 +2395,32 @@ function buildProductGroup(ctx, products, scoped, rootSlug, skipSharedSectionMer
     children
   };
 }
+function markCrossProductCanonicalSlugs(productNodes) {
+  const pageIdToCanonical = /* @__PURE__ */ new Map();
+  const sorted = [...productNodes].sort((a, b) => {
+    if (a.default !== b.default) {
+      return a.default ? -1 : 1;
+    }
+    return 0;
+  });
+  for (const product of sorted) {
+    traverseDF(product, (child) => {
+      if (hasMetadata(child) && isPage(child)) {
+        const pid = getPageId(child);
+        if (pid == null) {
+          return;
+        }
+        const key = `pid:${pid}`;
+        const canonical = pageIdToCanonical.get(key);
+        if (canonical != null && !product.default) {
+          child.canonicalSlug = canonical;
+        } else if (canonical == null) {
+          pageIdToCanonical.set(key, child.canonicalSlug ?? child.slug);
+        }
+      }
+    });
+  }
+}
 export {
   apiLeafNodeFromNavRoute,
   buildFullRootFromSegments,