@fern-api/fdr-sdk 1.2.42-0c024f5b0d → 1.2.42-1fb0ba4870

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

@@ -51,6 +51,17 @@ 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())
@@ -847,6 +858,35 @@ 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];
@@ -964,7 +1004,7 @@ function artifactToNode(ctx, route) {
         }),
         pageId: PageId(pageId),
         noindex: metaBool(md, "noindex"),
-        availability: metaStr(md, "availability")
+        availability: metaAvailability(md)
       };
       return node;
     }
@@ -1029,7 +1069,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2) {
       endpointId: EndpointId(endpointId),
       apiDefinitionId,
       isResponseStream: metaBool(md, "isResponseStream"),
-      availability: metaStr(md, "availability"),
+      availability: metaAvailability(md),
       playground: void 0
     };
   }
@@ -1045,7 +1085,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2) {
       method,
       webhookId: WebhookId(webhookId),
       apiDefinitionId,
-      availability: metaStr(md, "availability")
+      availability: metaAvailability(md)
     };
   }
   if (route.type === "asyncapi") {
@@ -1058,7 +1098,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2) {
       ...meta,
       webSocketId: WebSocketId(webSocketId),
       apiDefinitionId,
-      availability: metaStr(md, "availability"),
+      availability: metaAvailability(md),
       playground: void 0
     };
   }
@@ -1074,7 +1114,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2) {
       method,
       grpcId: GrpcId(grpcId),
       apiDefinitionId,
-      availability: metaStr(md, "availability")
+      availability: metaAvailability(md)
     };
   }
   if (route.type === "graphql") {
@@ -1090,7 +1130,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2) {
       graphqlOperationId: GraphQlOperationId(graphqlOperationId),
       graphqlOperationIds: void 0,
       apiDefinitionId,
-      availability: metaStr(md, "availability"),
+      availability: metaAvailability(md),
       playground: void 0
     };
   }
@@ -1268,7 +1308,7 @@ 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: metaStr(seg.metadata, "availability"),
+    availability: metaAvailability(seg.metadata),
     pointsTo: metaPointsTo != null ? pointsToSlug(metaPointsTo) : void 0,
     children: mergeChildrenByPosition(ctx, nav, sectionChildren)
   };
@@ -1342,7 +1382,7 @@ function apiPackageChildNode(ctx, scoped, scopeSegs, parentApiDefinitionId, scop
       featureFlags: metaFeatureFlags(seg.metadata)
     }),
     apiDefinitionId: ApiDefinitionId(apiDefinitionId),
-    availability: metaStr(seg.metadata, "availability"),
+    availability: metaAvailability(seg.metadata),
     overviewPageId: overviewPageId != null ? PageId(overviewPageId) : void 0,
     noindex: metaBool(overview?.metadata, "noindex") ?? metaBool(seg.metadata, "noindex"),
     pointsTo: metaPointsTo != null ? pointsToSlug(metaPointsTo) : void 0,
@@ -1430,7 +1470,7 @@ function apiReferenceNode(ctx, scoped, scopeSegs, scopePrefix) {
       featureFlags: metaFeatureFlags(seg.metadata)
     }),
     apiDefinitionId: ApiDefinitionId(apiDefinitionId),
-    availability: metaStr(seg.metadata, "availability"),
+    availability: metaAvailability(seg.metadata),
     overviewPageId: overviewPageId != null ? PageId(overviewPageId) : void 0,
     noindex: metaBool(overview?.metadata, "noindex") ?? metaBool(seg.metadata, "noindex"),
     paginated: true,
@@ -1645,7 +1685,11 @@ 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 parent = parentSectionPath(sec);
@@ -1676,8 +1720,10 @@ 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;
@@ -1696,8 +1742,10 @@ 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;
@@ -1716,12 +1764,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({