@fern-api/fdr-sdk 1.2.42-54880bfeac → 1.2.42-6d01f91096

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

@@ -51,17 +51,6 @@ var VersionIdSchema = z.string();
 function VersionId(value) {
   return value;
 }
-var Availability = {
-  Alpha: "Alpha",
-  Stable: "Stable",
-  GenerallyAvailable: "GenerallyAvailable",
-  InDevelopment: "InDevelopment",
-  PreRelease: "PreRelease",
-  Deprecated: "Deprecated",
-  Beta: "Beta",
-  Preview: "Preview",
-  Legacy: "Legacy"
-};
 var SnippetsByEndpointMethodSchema = z.record(
   HttpMethodSchema,
   z.array(z.unknown())
@@ -815,12 +804,6 @@ function traverseDF(node, visit) {
   return dfs(node, visit, getChildren);
 }
 
-// src/navigation/utils/syntheticSectionPath.ts
-var SYNTHETIC_SEGMENT_RE = /^~\d+$/;
-function stripSyntheticSegments(section) {
-  return section.split("/").filter((part) => !SYNTHETIC_SEGMENT_RE.test(part)).join("/");
-}
-
 // src/navigation/ledger-root-builder.ts
 var STRUCTURAL_SEGMENT_TYPES = /* @__PURE__ */ new Set([
   "section",
@@ -858,35 +841,6 @@ function metaStr(metadata, key) {
   }
   return void 0;
 }
-var AVAILABILITY_LOOKUP = {
-  // V1 lowercase values (stored by docsPublishTransform from V1 navigation tree)
-  alpha: Availability.Alpha,
-  stable: Availability.Stable,
-  "generally-available": Availability.GenerallyAvailable,
-  "in-development": Availability.InDevelopment,
-  "pre-release": Availability.PreRelease,
-  deprecated: Availability.Deprecated,
-  beta: Availability.Beta,
-  preview: Availability.Preview,
-  legacy: Availability.Legacy,
-  // Latest PascalCase values (pass-through)
-  Alpha: Availability.Alpha,
-  Stable: Availability.Stable,
-  GenerallyAvailable: Availability.GenerallyAvailable,
-  InDevelopment: Availability.InDevelopment,
-  PreRelease: Availability.PreRelease,
-  Deprecated: Availability.Deprecated,
-  Beta: Availability.Beta,
-  Preview: Availability.Preview,
-  Legacy: Availability.Legacy
-};
-function metaAvailability(metadata) {
-  const raw = metaStr(metadata, "availability");
-  if (raw == null) {
-    return void 0;
-  }
-  return AVAILABILITY_LOOKUP[raw];
-}
 function metaBool(metadata, key) {
   if (metadata != null && typeof metadata === "object" && key in metadata) {
     const v = metadata[key];
@@ -1004,7 +958,7 @@ function artifactToNode(ctx, route) {
         }),
         pageId: PageId(pageId),
         noindex: metaBool(md, "noindex"),
-        availability: metaAvailability(md)
+        availability: metaStr(md, "availability")
       };
       return node;
     }
@@ -1069,7 +1023,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2) {
       endpointId: EndpointId(endpointId),
       apiDefinitionId,
       isResponseStream: metaBool(md, "isResponseStream"),
-      availability: metaAvailability(md),
+      availability: metaStr(md, "availability"),
       playground: void 0
     };
   }
@@ -1085,7 +1039,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2) {
       method,
       webhookId: WebhookId(webhookId),
       apiDefinitionId,
-      availability: metaAvailability(md)
+      availability: metaStr(md, "availability")
     };
   }
   if (route.type === "asyncapi") {
@@ -1098,7 +1052,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2) {
       ...meta,
       webSocketId: WebSocketId(webSocketId),
       apiDefinitionId,
-      availability: metaAvailability(md),
+      availability: metaStr(md, "availability"),
       playground: void 0
     };
   }
@@ -1114,7 +1068,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2) {
       method,
       grpcId: GrpcId(grpcId),
       apiDefinitionId,
-      availability: metaAvailability(md)
+      availability: metaStr(md, "availability")
     };
   }
   if (route.type === "graphql") {
@@ -1130,7 +1084,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2) {
       graphqlOperationId: GraphQlOperationId(graphqlOperationId),
       graphqlOperationIds: void 0,
       apiDefinitionId,
-      availability: metaAvailability(md),
+      availability: metaStr(md, "availability"),
       playground: void 0
     };
   }
@@ -1243,8 +1197,7 @@ function structuralNodeSlug(ctx, overviewFullPath, section, scopePrefix) {
   if (overviewFullPath != null) {
     return ctx.contentSlug(overviewFullPath);
   }
-  const cleanSection = stripSyntheticSegments(section);
-  return cleanSection !== "" ? slugjoin(scopePrefix, cleanSection) : scopePrefix;
+  return section !== "" ? slugjoin(scopePrefix, section) : scopePrefix;
 }
 function stripLeadingScopePrefix(section, scopePrefix) {
   const prefix = scopePrefix;
@@ -1259,30 +1212,6 @@ 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++) {
@@ -1332,20 +1261,17 @@ function sectionNode(ctx, scoped, sectionChildren, scopePrefix) {
     noindex: metaBool(overview?.metadata, "noindex") ?? metaBool(seg.metadata, "noindex"),
     collapsible: metaBool(seg.metadata, "collapsible") ?? (metaCollapsed(seg.metadata) === true ? true : void 0),
     collapsedByDefault: metaBool(seg.metadata, "collapsedByDefault") ?? (metaCollapsed(seg.metadata) === true ? true : void 0),
-    availability: metaAvailability(seg.metadata),
+    availability: metaStr(seg.metadata, "availability"),
     pointsTo: metaPointsTo != null ? pointsToSlug(metaPointsTo) : void 0,
     children: mergeChildrenByPosition(ctx, nav, sectionChildren)
   };
 }
-function directChildApiPackages(parentSection, scopeSegs, apiDefinitionId) {
+function directChildApiPackages(parentSection, scopeSegs) {
   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;
@@ -1359,17 +1285,7 @@ function directChildApiPackages(parentSection, scopeSegs, apiDefinitionId) {
 function buildApiChildren(ctx, scoped, scopeSegs, apiDefinitionId, scopePrefix) {
   const { seg, nav } = scoped;
   const leafNodes = positionedApiLeafChildren(ctx, nav, apiDefinitionId);
-  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 childPackages = directChildApiPackages(seg.section, scopeSegs);
   const packageNodes = childPackages.map((child) => ({
     node: apiPackageChildNode(
       ctx,
@@ -1380,9 +1296,6 @@ 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);
@@ -1422,7 +1335,7 @@ function apiPackageChildNode(ctx, scoped, scopeSegs, parentApiDefinitionId, scop
       featureFlags: metaFeatureFlags(seg.metadata)
     }),
     apiDefinitionId: ApiDefinitionId(apiDefinitionId),
-    availability: metaAvailability(seg.metadata),
+    availability: metaStr(seg.metadata, "availability"),
     overviewPageId: overviewPageId != null ? PageId(overviewPageId) : void 0,
     noindex: metaBool(overview?.metadata, "noindex") ?? metaBool(seg.metadata, "noindex"),
     pointsTo: metaPointsTo != null ? pointsToSlug(metaPointsTo) : void 0,
@@ -1510,10 +1423,10 @@ function apiReferenceNode(ctx, scoped, scopeSegs, scopePrefix) {
       featureFlags: metaFeatureFlags(seg.metadata)
     }),
     apiDefinitionId: ApiDefinitionId(apiDefinitionId),
-    availability: metaAvailability(seg.metadata),
+    availability: metaStr(seg.metadata, "availability"),
     overviewPageId: overviewPageId != null ? PageId(overviewPageId) : void 0,
     noindex: metaBool(overview?.metadata, "noindex") ?? metaBool(seg.metadata, "noindex"),
-    paginated: metaBool(seg.metadata, "paginated"),
+    paginated: true,
     showErrors: metaBool(seg.metadata, "showErrors"),
     hideTitle: metaBool(seg.metadata, "hideTitle"),
     pointsTo: metaPointsTo != null ? pointsToSlug(metaPointsTo) : void 0,
@@ -1531,10 +1444,7 @@ function attachedApiChangelogNode(ctx, scoped, scopeSegs, apiDefinitionId, scope
     }
     return metaStr(candidate.seg.metadata, "apiDefinitionId") === apiDefinitionId;
   });
-  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);
+  const changelogSeg = candidates.find((candidate) => parentSectionPath(candidate.seg.section) === seg.section) ?? candidates[0];
   return changelogSeg != null ? changelogNode(ctx, changelogSeg, scopePrefix) : void 0;
 }
 function hasOwningApiReference(scoped, scopeSegs) {
@@ -1542,51 +1452,12 @@ function hasOwningApiReference(scoped, scopeSegs) {
   if (apiDefinitionId == null || metaStr(scoped.seg.metadata, "type") !== "changelog") {
     return false;
   }
-  const candidates = scopeSegs.filter((candidate) => {
+  return scopeSegs.some((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") {
-    return false;
-  }
-  const apiDefinitionId = metaStr(scoped.seg.metadata, "apiDefinitionId");
-  if (apiDefinitionId == null) {
-    return false;
-  }
-  const apiReferenceSections = new Set(
-    scopeSegs.filter(
-      (s) => metaStr(s.seg.metadata, "type") === "apiReference" && metaStr(s.seg.metadata, "apiDefinitionId") === apiDefinitionId
-    ).map((s) => s.seg.section)
-  );
-  if (apiReferenceSections.size === 0) {
-    return false;
-  }
-  const sectionPaths = new Set(scopeSegs.map((s) => s.seg.section));
-  const resolveParent = (section) => {
-    const parent = parentSectionPath(section);
-    if (parent === "" || sectionPaths.has(parent)) {
-      return parent;
-    }
-    return nearestExistingAncestor(section, sectionPaths);
-  };
-  let current = scoped.seg.section;
-  const seen = /* @__PURE__ */ new Set([current]);
-  for (; ; ) {
-    const parent = resolveParent(current);
-    if (apiReferenceSections.has(parent)) {
-      return true;
-    }
-    if (parent === "" || seen.has(parent)) {
-      return false;
-    }
-    seen.add(parent);
-    current = parent;
-  }
 }
 function changelogNode(ctx, scoped, scopePrefix) {
   const { seg, nav } = scoped;
@@ -1691,11 +1562,7 @@ function buildSectionTree(ctx, scopeSegs, parentPath, scopePrefix, changelogScop
     if (sec === "" || type === "tabRoot") {
       return false;
     }
-    if (hasOwningApiReference(s, scopeSegs) || isNestedApiPackage(s, scopeSegs)) {
-      return false;
-    }
-    const depth = metaNum(s.seg.metadata, "sidebarDepth");
-    if (depth === 0) {
+    if (hasOwningApiReference(s, scopeSegs)) {
       return false;
     }
     const parent = parentSectionPath(sec);
@@ -1707,7 +1574,6 @@ 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");
@@ -1717,14 +1583,10 @@ 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, childScopeSegs, s.seg.section, scopePrefix, changelogScopePrefix),
+        buildSectionTree(ctx, scopeSegs, s.seg.section, scopePrefix, changelogScopePrefix),
         scopePrefix
       );
     }
@@ -1738,16 +1600,11 @@ function computeSiblingSortBoundaries(ordered) {
   for (const s of ordered) {
     const type = metaStr(s.seg.metadata, "type");
     const sec = s.seg.section;
-    if (type !== "section") {
-      continue;
-    }
-    if (sec === "") {
-      rootSections.push(s);
+    if (type !== "section" || sec === "") {
       continue;
     }
-    const depth = metaNum(s.seg.metadata, "sidebarDepth");
     const parent = parentSectionPath(sec);
-    const isRootLevel = depth === 0 || parent === "" || !sectionPaths.has(parent) && nearestExistingAncestor(sec, sectionPaths) === "";
+    const isRootLevel = parent === "" || !sectionPaths.has(parent) && nearestExistingAncestor(sec, sectionPaths) === "";
     if (isRootLevel) {
       rootSections.push(s);
     }
@@ -1774,24 +1631,14 @@ 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)) {
+    if (hasOwningApiReference(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;
     }
@@ -1804,18 +1651,15 @@ function buildSidebarRootChildren(ctx, scopeSegs, scopePrefix, changelogScopePre
       }
       continue;
     }
-    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);
+    if (type === "section" && sec === "") {
+      const sectionChildren = buildSectionTree(ctx, scopeSegs, "", scopePrefix);
       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 = depth === 0 || parent === "" || !sectionPaths.has(parent) && nearestExistingAncestor(sec, sectionPaths) === "";
-    if (isRootLevel && hasRootSection && sec !== "" && depth !== 0) {
+    const isRootLevel = parent === "" || !sectionPaths.has(parent) && nearestExistingAncestor(sec, sectionPaths) === "";
+    if (isRootLevel && hasRootSection && sec !== "") {
       continue;
     }
     if (isRootLevel) {
@@ -1827,9 +1671,12 @@ 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;
-        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);
+        node = sectionNode(
+          ctx,
+          s,
+          buildSectionTree(ctx, ownedSegs, sec, scopePrefix, changelogScopePrefix),
+          scopePrefix
+        );
       }
       const isSharedSection = siblingBoundaries.size > 0 && scopePrefix !== "" && sec !== "" && !sec.startsWith(scopePrefix);
       annotated.push({
@@ -1867,6 +1714,10 @@ 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);
     }
@@ -1981,7 +1832,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, variantSlug);
+    const children = buildSidebarRootChildren(ctx, variantSegs, scopePrefix);
     return {
       type: "variant",
       ...withMetadataDefaults({
@@ -2383,7 +2234,6 @@ function buildProductGroup(ctx, products, scoped, rootSlug, skipSharedSectionMer
     };
     return node;
   });
-  markCrossProductCanonicalSlugs(children);
   return {
     type: "productgroup",
     id: ctx.nodeId("productgroup"),
@@ -2395,32 +2245,6 @@ 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,