@fern-api/fdr-sdk 1.2.35-b081075b10 → 1.2.35-cf6486493a

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

@@ -612,6 +612,9 @@ function slugjoin(...parts) {
 }
 
 // src/navigation/ledger-root-builder.ts
+var segMeta = (seg) => seg.metadata ?? {};
+var routeMeta = (route) => route.metadata ?? {};
+var detailMeta = (detail) => detail.metadata ?? {};
 function createBuildContext(basePath) {
   const seen = /* @__PURE__ */ new Map();
   const basePrefix = basePath.replace(/^\/+|\/+$/g, "");
@@ -630,41 +633,6 @@ function createBuildContext(basePath) {
 function asSlug(path) {
   return Slug(path.replace(/^\/+|\/+$/g, ""));
 }
-function metaStr(metadata, key) {
-  if (metadata != null && typeof metadata === "object" && key in metadata) {
-    const v = metadata[key];
-    return typeof v === "string" ? v : void 0;
-  }
-  return void 0;
-}
-function metaBool(metadata, key) {
-  if (metadata != null && typeof metadata === "object" && key in metadata) {
-    const v = metadata[key];
-    return typeof v === "boolean" ? v : void 0;
-  }
-  return void 0;
-}
-function metaCollapsed(metadata) {
-  if (metadata != null && typeof metadata === "object" && "collapsed" in metadata) {
-    const v = metadata.collapsed;
-    if (typeof v === "boolean") {
-      return v;
-    }
-    if (v === "open-by-default") {
-      return "open-by-default";
-    }
-  }
-  return void 0;
-}
-function metaStrArr(metadata, key) {
-  if (metadata != null && typeof metadata === "object" && key in metadata) {
-    const v = metadata[key];
-    if (Array.isArray(v)) {
-      return v.filter((x) => typeof x === "string");
-    }
-  }
-  return void 0;
-}
 function toViewers(viewers) {
   if (viewers == null || viewers.length === 0) {
     return void 0;
@@ -672,29 +640,17 @@ function toViewers(viewers) {
   return viewers.map((v) => RoleId(v));
 }
 function mergeVariantViewers(seg) {
-  const segViewers = metaStrArr(seg.metadata, "viewers");
-  const variantViewers = seg.variant?.viewers;
-  if ((segViewers == null || segViewers.length === 0) && (variantViewers == null || variantViewers.length === 0)) {
-    return void 0;
-  }
-  const merged = /* @__PURE__ */ new Set();
-  if (segViewers != null) {
-    for (const v of segViewers) {
-      merged.add(v);
-    }
-  }
-  if (variantViewers != null) {
-    for (const v of variantViewers) {
-      merged.add(v);
-    }
-  }
-  return merged.size > 0 ? [...merged].map((v) => RoleId(v)) : void 0;
+  const all = [...segMeta(seg).viewers ?? [], ...seg.variant?.viewers ?? []];
+  return all.length > 0 ? [...new Set(all)].map((v) => RoleId(v)) : void 0;
 }
 function detailSlug(detail) {
-  return metaStr(detail.metadata, "slug") ?? "";
+  return detailMeta(detail).slug ?? "";
 }
 function detailIsDefault(detail) {
-  return metaBool(detail.metadata, "default") ?? false;
+  return detailMeta(detail).default ?? false;
+}
+function pointsToSlug(ctx, meta) {
+  return meta.pointsTo != null ? ctx.contentSlug(meta.pointsTo) : void 0;
 }
 function scopeKey(seg) {
   return [seg.product?.id ?? "", seg.version?.id ?? "", seg.variant?.id ?? "", seg.tab?.id ?? ""].join("|");
@@ -714,240 +670,223 @@ function withMetadataDefaults(base) {
   };
 }
 function artifactToNode(ctx, route) {
-  const md = route.metadata;
-  const title = metaStr(md, "title") ?? "";
-  const icon = metaStr(md, "icon");
-  const viewers = toViewers(metaStrArr(md, "viewers"));
+  const md = routeMeta(route);
   const slug = ctx.contentSlug(route.fullPath ?? "");
   switch (route.type) {
     case "markdown": {
-      if (metaBool(md, "isOverview")) {
+      if (md.isOverview) {
         return void 0;
       }
-      const pageId = metaStr(md, "pageId") ?? "";
-      const node = {
+      return {
         type: "page",
         ...withMetadataDefaults({
           id: ctx.nodeId(`page:${slug}`),
-          title,
+          title: md.title ?? "",
           slug,
-          icon,
+          icon: md.icon,
           hidden: route.hidden,
-          viewers
+          viewers: toViewers(md.viewers)
         }),
-        pageId: PageId(pageId),
-        noindex: metaBool(md, "noindex"),
+        pageId: PageId(md.pageId ?? ""),
+        noindex: md.noindex,
         availability: void 0
       };
-      return node;
     }
     case "link": {
-      const node = {
+      return {
         type: "link",
-        id: ctx.nodeId(`link:${metaStr(md, "url") ?? route.fullPath ?? ""}`),
+        id: ctx.nodeId(`link:${md.url ?? route.fullPath ?? ""}`),
         collapsed: void 0,
-        title,
-        icon,
-        url: Url(metaStr(md, "url") ?? ""),
+        title: md.title ?? "",
+        icon: md.icon,
+        url: Url(md.url ?? ""),
         target: void 0
       };
-      return node;
     }
     // API leaf types are handled by apiReferenceNode (which calls
     // apiLeafNodeFromNavRouteInternal), not by section-level artifact
     // conversion. Returning undefined here prevents them from appearing
     // as duplicate siblings alongside the apiReference node.
-    case "rest":
-    case "asyncapi":
-    case "webhook":
-    case "grpc":
-    case "graphql":
-      return void 0;
     default:
       return void 0;
   }
 }
-function apiLeafNodeFromNavRoute(route, basePath, segmentApiDefinitionId2) {
+function apiLeafNodeFromNavRoute(route, basePath, segmentApiDefId) {
   const ctx = createBuildContext(basePath);
-  return apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2);
+  return apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefId);
 }
-function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2) {
-  const md = route.metadata;
-  const apiDefinitionId = ApiDefinitionId(metaStr(md, "apiDefinitionId") ?? segmentApiDefinitionId2);
+function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefId) {
+  const md = routeMeta(route);
   const slug = ctx.contentSlug(route.fullPath ?? "");
-  const title = metaStr(md, "title") ?? "";
-  const icon = metaStr(md, "icon");
-  const viewers = toViewers(metaStrArr(md, "viewers"));
-  const meta = withMetadataDefaults({
-    id: ctx.nodeId(`api-leaf:${slug}`),
-    title,
-    slug,
-    icon,
-    hidden: route.hidden,
-    viewers
-  });
-  if (route.type === "rest") {
-    const endpointId = metaStr(md, "endpointId");
-    const method = metaStr(md, "method");
-    if (endpointId == null || method == null) {
-      return void 0;
-    }
-    return {
-      type: "endpoint",
-      ...meta,
-      method,
-      endpointId: EndpointId(endpointId),
-      apiDefinitionId,
-      isResponseStream: metaBool(md, "isResponseStream"),
-      availability: void 0,
-      playground: void 0
-    };
-  }
-  if (route.type === "webhook") {
-    const webhookId = metaStr(md, "webhookId");
-    const method = metaStr(md, "method");
-    if (webhookId == null || method == null) {
-      return void 0;
-    }
-    return {
-      type: "webhook",
-      ...meta,
-      method,
-      webhookId: WebhookId(webhookId),
-      apiDefinitionId,
-      availability: void 0
-    };
-  }
-  if (route.type === "asyncapi") {
-    const webSocketId = metaStr(md, "webSocketId");
-    if (webSocketId == null) {
-      return void 0;
-    }
-    return {
-      type: "webSocket",
-      ...meta,
-      webSocketId: WebSocketId(webSocketId),
-      apiDefinitionId,
-      availability: void 0,
-      playground: void 0
-    };
-  }
-  if (route.type === "grpc") {
-    const grpcId = metaStr(md, "grpcId");
-    const method = metaStr(md, "method");
-    if (grpcId == null || method == null) {
-      return void 0;
-    }
-    return {
-      type: "grpc",
-      ...meta,
-      method,
-      grpcId: GrpcId(grpcId),
-      apiDefinitionId,
-      availability: void 0
-    };
-  }
-  if (route.type === "graphql") {
-    const graphqlOperationId = metaStr(md, "graphqlOperationId");
-    const operationType = metaStr(md, "operationType");
-    if (graphqlOperationId == null || operationType == null) {
+  const base = {
+    ...withMetadataDefaults({
+      id: ctx.nodeId(`api-leaf:${slug}`),
+      title: md.title ?? "",
+      slug,
+      icon: md.icon,
+      hidden: route.hidden,
+      viewers: toViewers(md.viewers)
+    }),
+    apiDefinitionId: ApiDefinitionId(md.apiDefinitionId ?? segmentApiDefId),
+    availability: void 0
+  };
+  switch (route.type) {
+    case "rest":
+      if (md.endpointId == null || md.method == null) {
+        return void 0;
+      }
+      return {
+        type: "endpoint",
+        ...base,
+        method: md.method,
+        endpointId: EndpointId(md.endpointId),
+        isResponseStream: md.isResponseStream,
+        playground: void 0
+      };
+    case "webhook":
+      if (md.webhookId == null || md.method == null) {
+        return void 0;
+      }
+      return {
+        type: "webhook",
+        ...base,
+        method: md.method,
+        webhookId: WebhookId(md.webhookId)
+      };
+    case "asyncapi":
+      if (md.webSocketId == null) {
+        return void 0;
+      }
+      return {
+        type: "webSocket",
+        ...base,
+        webSocketId: WebSocketId(md.webSocketId),
+        playground: void 0
+      };
+    case "grpc":
+      if (md.grpcId == null || md.method == null) {
+        return void 0;
+      }
+      return {
+        type: "grpc",
+        ...base,
+        method: md.method,
+        grpcId: GrpcId(md.grpcId)
+      };
+    case "graphql":
+      if (md.graphqlOperationId == null || md.operationType == null) {
+        return void 0;
+      }
+      return {
+        type: "graphql",
+        ...base,
+        operationType: md.operationType,
+        graphqlOperationId: GraphQlOperationId(md.graphqlOperationId),
+        graphqlOperationIds: void 0,
+        playground: void 0
+      };
+    default:
       return void 0;
-    }
-    return {
-      type: "graphql",
-      ...meta,
-      operationType,
-      graphqlOperationId: GraphQlOperationId(graphqlOperationId),
-      graphqlOperationIds: void 0,
-      apiDefinitionId,
-      availability: void 0,
-      playground: void 0
-    };
   }
-  return void 0;
 }
-function collectApiLeafNodesFromNav(routes, basePath, segmentApiDefinitionId2) {
+function collectApiLeafNodesFromNav(routes, basePath, segmentApiDefId) {
   const ctx = createBuildContext(basePath);
-  return routes.map((route) => apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2)).filter((node) => node != null);
+  return routes.map((route) => apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefId)).filter((node) => node != null);
 }
 function segmentApiDefinitionId(metadata) {
-  return metaStr(metadata, "apiDefinitionId");
+  return metadata?.apiDefinitionId;
 }
 function overviewRoute(nav) {
-  return nav.find((r) => r.type === "markdown" && metaBool(r.metadata, "isOverview"));
+  for (const r of nav) {
+    if (r.type === "markdown") {
+      const meta = routeMeta(r);
+      if (meta.isOverview) {
+        return { route: r, meta };
+      }
+    }
+  }
+  return void 0;
 }
 function sectionNode(ctx, scoped, sectionChildren) {
-  const { seg, nav } = scoped;
+  const { seg, meta: sm, nav } = scoped;
   const overview = overviewRoute(nav);
-  const overviewPageId = overview != null ? metaStr(overview.metadata, "pageId") : void 0;
-  const slug = ctx.contentSlug(overview?.fullPath ?? seg.section);
+  const overviewPageId = overview?.meta.pageId;
+  const slug = ctx.contentSlug(overview?.route.fullPath ?? seg.section);
   const leafChildren = nav.map((r) => artifactToNode(ctx, r)).filter((n) => n != null);
   const defaults = withMetadataDefaults({
     id: ctx.nodeId(`section:${slug}`),
-    title: metaStr(seg.metadata, "title") ?? "",
+    title: sm.title ?? "",
     slug,
-    icon: metaStr(seg.metadata, "icon"),
+    icon: sm.icon,
     hidden: seg.hidden,
     viewers: mergeVariantViewers(seg)
   });
   return {
     type: "section",
     ...defaults,
-    collapsed: metaCollapsed(seg.metadata) ?? defaults.collapsed,
+    collapsed: sm.collapsed ?? defaults.collapsed,
     overviewPageId: overviewPageId != null ? PageId(overviewPageId) : void 0,
     noindex: void 0,
-    collapsible: metaBool(seg.metadata, "collapsible"),
-    collapsedByDefault: metaBool(seg.metadata, "collapsedByDefault"),
+    collapsible: sm.collapsible,
+    collapsedByDefault: sm.collapsedByDefault,
     availability: void 0,
     pointsTo: void 0,
     children: [...leafChildren, ...sectionChildren]
   };
 }
-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;
-    }
-    const parent = parentSectionPath(s.seg.section);
-    if (parent === parentSection) {
-      return true;
-    }
-    if (!sectionPaths.has(parent)) {
-      return nearestExistingAncestor(s.seg.section, sectionPaths) === parentSection;
+function parentSectionPath(sectionPath) {
+  const idx = sectionPath.lastIndexOf("/");
+  return idx === -1 ? "" : sectionPath.slice(0, idx);
+}
+function nearestExistingAncestor(sectionPath, existing) {
+  let current = parentSectionPath(sectionPath);
+  while (current !== "") {
+    if (existing.has(current)) {
+      return current;
     }
-    return false;
-  }).sort((a, b) => a.seg.sortOrder - b.seg.sortOrder);
+    current = parentSectionPath(current);
+  }
+  return "";
+}
+function isDirectChildOf(sec, parentPath, sectionPaths) {
+  const parent = parentSectionPath(sec);
+  if (parent === parentPath) {
+    return true;
+  }
+  return !sectionPaths.has(parent) && nearestExistingAncestor(sec, sectionPaths) === parentPath;
 }
-function buildApiChildren(ctx, scoped, scopeSegs, apiDefinitionId) {
-  const { seg, nav } = scoped;
-  const rawLeafNodes = nav.map((route) => apiLeafNodeFromNavRouteInternal(ctx, route, apiDefinitionId)).filter((node) => node != null);
+function directChildApiPackages(parentSection, scopeSegs, sectionPaths) {
+  return scopeSegs.filter((s) => s.meta.type === "apiPackage" && isDirectChildOf(s.seg.section, parentSection, sectionPaths)).sort((a, b) => a.seg.sortOrder - b.seg.sortOrder);
+}
+function buildApiChildren(ctx, scoped, scopeSegs, apiDefId, sectionPaths) {
+  const { nav } = scoped;
+  const rawLeafNodes = nav.map((route) => apiLeafNodeFromNavRouteInternal(ctx, route, apiDefId)).filter((node) => node != null);
   const leafNodes = mergeEndpointPairs(ctx, rawLeafNodes, nav);
-  const childPackages = directChildApiPackages(seg.section, scopeSegs);
+  const childPackages = directChildApiPackages(scoped.seg.section, scopeSegs, sectionPaths);
   const packageNodes = childPackages.map(
-    (child) => apiPackageChildNode(ctx, child, scopeSegs, apiDefinitionId)
+    (child) => apiPackageChildNode(ctx, child, scopeSegs, apiDefId, sectionPaths)
   );
   return [...leafNodes, ...packageNodes];
 }
-function apiPackageChildNode(ctx, scoped, scopeSegs, parentApiDefinitionId) {
-  const { seg, nav } = scoped;
+function apiPackageChildNode(ctx, scoped, scopeSegs, parentApiDefId, sectionPaths) {
+  const { seg, meta: sm, nav } = scoped;
   const overview = overviewRoute(nav);
-  const overviewPageId = overview != null ? metaStr(overview.metadata, "pageId") : void 0;
-  const apiDefinitionId = metaStr(seg.metadata, "apiDefinitionId") ?? parentApiDefinitionId;
-  const slug = ctx.contentSlug(overview?.fullPath ?? nav[0]?.fullPath ?? seg.section);
-  const children = buildApiChildren(ctx, scoped, scopeSegs, apiDefinitionId);
+  const overviewPageId = overview?.meta.pageId;
+  const apiDefId = sm.apiDefinitionId ?? parentApiDefId;
+  const slug = ctx.contentSlug(overview?.route.fullPath ?? nav[0]?.fullPath ?? seg.section);
+  const children = buildApiChildren(ctx, scoped, scopeSegs, apiDefId, sectionPaths);
   return {
     type: "apiPackage",
     ...withMetadataDefaults({
       id: ctx.nodeId(`api-pkg:${slug}`),
-      title: metaStr(seg.metadata, "title") ?? "",
+      title: sm.title ?? "",
       slug,
-      icon: metaStr(seg.metadata, "icon"),
+      icon: sm.icon,
       hidden: seg.hidden,
-      viewers: toViewers(metaStrArr(seg.metadata, "viewers"))
+      viewers: toViewers(sm.viewers)
     }),
-    apiDefinitionId: ApiDefinitionId(apiDefinitionId),
-    availability: metaStr(seg.metadata, "availability"),
+    apiDefinitionId: ApiDefinitionId(apiDefId),
+    availability: sm.availability,
     overviewPageId: overviewPageId != null ? PageId(overviewPageId) : void 0,
     noindex: void 0,
     pointsTo: void 0,
@@ -961,10 +900,9 @@ function mergeEndpointPairs(ctx, leafNodes, allNav) {
     if (route.type !== "rest") {
       continue;
     }
-    const pairKey = metaStr(route.metadata, "endpointPairKey");
-    const endpointId = metaStr(route.metadata, "endpointId");
-    if (pairKey != null && endpointId != null) {
-      endpointIdToPairKey.set(endpointId, pairKey);
+    const md = routeMeta(route);
+    if (md.endpointPairKey != null && md.endpointId != null) {
+      endpointIdToPairKey.set(md.endpointId, md.endpointPairKey);
     }
   }
   if (endpointIdToPairKey.size === 0) {
@@ -1006,30 +944,30 @@ function mergeEndpointPairs(ctx, leafNodes, allNav) {
   }
   return result;
 }
-function apiReferenceNode(ctx, scoped, scopeSegs) {
-  const { seg, nav } = scoped;
+function apiReferenceNode(ctx, scoped, scopeSegs, sectionPaths) {
+  const { seg, meta: sm, nav } = scoped;
   const overview = overviewRoute(nav);
-  const overviewPageId = overview != null ? metaStr(overview.metadata, "pageId") : void 0;
-  const apiDefinitionId = metaStr(seg.metadata, "apiDefinitionId") ?? "";
-  const slug = ctx.contentSlug(overview?.fullPath ?? nav[0]?.fullPath ?? seg.section);
-  const children = buildApiChildren(ctx, scoped, scopeSegs, apiDefinitionId);
+  const overviewPageId = overview?.meta.pageId;
+  const apiDefId = sm.apiDefinitionId ?? "";
+  const slug = ctx.contentSlug(overview?.route.fullPath ?? nav[0]?.fullPath ?? seg.section);
+  const children = buildApiChildren(ctx, scoped, scopeSegs, apiDefId, sectionPaths);
   return {
     type: "apiReference",
     ...withMetadataDefaults({
       id: ctx.nodeId(`api:${slug}`),
-      title: metaStr(seg.metadata, "title") ?? "",
+      title: sm.title ?? "",
       slug,
-      icon: metaStr(seg.metadata, "icon"),
+      icon: sm.icon,
       hidden: seg.hidden,
       viewers: mergeVariantViewers(seg)
     }),
-    apiDefinitionId: ApiDefinitionId(apiDefinitionId),
+    apiDefinitionId: ApiDefinitionId(apiDefId),
     availability: void 0,
     overviewPageId: overviewPageId != null ? PageId(overviewPageId) : void 0,
     noindex: void 0,
     paginated: true,
-    showErrors: metaBool(seg.metadata, "showErrors"),
-    hideTitle: metaBool(seg.metadata, "hideTitle"),
+    showErrors: sm.showErrors,
+    hideTitle: sm.hideTitle,
     pointsTo: void 0,
     children,
     changelog: void 0,
@@ -1038,29 +976,29 @@ function apiReferenceNode(ctx, scoped, scopeSegs) {
   };
 }
 function changelogNode(ctx, scoped) {
-  const { seg, nav } = scoped;
+  const { seg, meta: sm, nav } = scoped;
   const overview = overviewRoute(nav);
-  const overviewPageId = overview != null ? metaStr(overview.metadata, "pageId") : void 0;
+  const overviewPageId = overview?.meta.pageId;
   const entries = nav.filter((r) => r.type === "changelog");
   const byYear = /* @__PURE__ */ new Map();
   for (const r of entries) {
-    const dateStr = metaStr(r.metadata, "date");
-    const date = dateStr != null ? new Date(dateStr) : /* @__PURE__ */ new Date(0);
+    const md = routeMeta(r);
+    const date = md.date != null ? new Date(md.date) : /* @__PURE__ */ new Date(0);
     const year = date.getUTCFullYear();
     const month = date.getUTCMonth() + 1;
     const entry = {
       type: "changelogEntry",
       ...withMetadataDefaults({
-        id: ctx.nodeId(`cl-entry:${r.fullPath ?? metaStr(r.metadata, "pageId") ?? ""}`),
-        title: metaStr(r.metadata, "title") ?? "",
+        id: ctx.nodeId(`cl-entry:${r.fullPath ?? md.pageId ?? ""}`),
+        title: md.title ?? "",
         slug: ctx.contentSlug(r.fullPath ?? ""),
-        icon: metaStr(r.metadata, "icon"),
+        icon: md.icon,
         hidden: r.hidden,
-        viewers: toViewers(metaStrArr(r.metadata, "viewers"))
+        viewers: toViewers(md.viewers)
       }),
-      pageId: PageId(metaStr(r.metadata, "pageId") ?? ""),
+      pageId: PageId(md.pageId ?? ""),
       noindex: void 0,
-      date: dateStr ?? "",
+      date: md.date ?? "",
       tags: void 0
     };
     let months = byYear.get(year);
@@ -1072,7 +1010,7 @@ function changelogNode(ctx, scoped) {
     arr.push(entry);
     months.set(month, arr);
   }
-  const baseSlug = ctx.contentSlug(overview?.fullPath ?? seg.section);
+  const baseSlug = ctx.contentSlug(overview?.route.fullPath ?? seg.section);
   const years = [...byYear.entries()].sort((a, b) => b[0] - a[0]).map(([year, months]) => ({
     type: "changelogYear",
     ...withMetadataDefaults({
@@ -1100,9 +1038,9 @@ function changelogNode(ctx, scoped) {
     type: "changelog",
     ...withMetadataDefaults({
       id: ctx.nodeId(`changelog:${baseSlug}`),
-      title: metaStr(seg.metadata, "title") ?? "",
+      title: sm.title ?? "",
       slug: baseSlug,
-      icon: metaStr(seg.metadata, "icon"),
+      icon: sm.icon,
       hidden: seg.hidden,
       viewers: mergeVariantViewers(seg)
     }),
@@ -1111,46 +1049,20 @@ function changelogNode(ctx, scoped) {
     children: years
   };
 }
-function parentSectionPath(sectionPath) {
-  const idx = sectionPath.lastIndexOf("/");
-  return idx === -1 ? "" : sectionPath.slice(0, idx);
-}
-function nearestExistingAncestor(sectionPath, existing) {
-  let current = parentSectionPath(sectionPath);
-  while (current !== "") {
-    if (existing.has(current)) {
-      return current;
-    }
-    current = parentSectionPath(current);
-  }
-  return "";
-}
-function buildSectionTree(ctx, scopeSegs, parentPath) {
-  const sectionPaths = new Set(scopeSegs.map((s) => s.seg.section));
+function buildSectionTree(ctx, scopeSegs, parentPath, sectionPaths) {
   const direct = scopeSegs.filter((s) => {
     const sec = s.seg.section;
-    const type = metaStr(s.seg.metadata, "type");
-    if (sec === "" || type === "tabRoot") {
-      return false;
-    }
-    const parent = parentSectionPath(sec);
-    if (parent === parentPath) {
-      return true;
-    }
-    if (!sectionPaths.has(parent)) {
-      return nearestExistingAncestor(sec, sectionPaths) === parentPath;
-    }
-    return false;
+    return sec !== "" && s.meta.type !== "tabRoot" && isDirectChildOf(sec, parentPath, sectionPaths);
   }).sort((a, b) => a.seg.sortOrder - b.seg.sortOrder);
   return direct.map((s) => {
-    const type = metaStr(s.seg.metadata, "type");
+    const { type } = s.meta;
     if (type === "apiReference" || type === "apiPackage") {
-      return apiReferenceNode(ctx, s, scopeSegs);
+      return apiReferenceNode(ctx, s, scopeSegs, sectionPaths);
     }
     if (type === "changelog") {
       return changelogNode(ctx, s);
     }
-    return sectionNode(ctx, s, buildSectionTree(ctx, scopeSegs, s.seg.section));
+    return sectionNode(ctx, s, buildSectionTree(ctx, scopeSegs, s.seg.section, sectionPaths));
   });
 }
 function buildSidebarRootChildren(ctx, scopeSegs) {
@@ -1158,7 +1070,7 @@ function buildSidebarRootChildren(ctx, scopeSegs) {
   const sectionPaths = new Set(ordered.map((s) => s.seg.section));
   const flat = [];
   for (const s of ordered) {
-    const type = metaStr(s.seg.metadata, "type");
+    const { type } = s.meta;
     const sec = s.seg.section;
     if (type === "tabRoot" || sec === "") {
       for (const r of s.nav) {
@@ -1169,15 +1081,13 @@ function buildSidebarRootChildren(ctx, scopeSegs) {
       }
       continue;
     }
-    const parent = parentSectionPath(sec);
-    const isRootLevel = parent === "" || !sectionPaths.has(parent) && nearestExistingAncestor(sec, sectionPaths) === "";
-    if (isRootLevel) {
+    if (isDirectChildOf(sec, "", sectionPaths)) {
       if (type === "apiReference" || type === "apiPackage") {
-        flat.push(apiReferenceNode(ctx, s, scopeSegs));
+        flat.push(apiReferenceNode(ctx, s, scopeSegs, sectionPaths));
       } else if (type === "changelog") {
         flat.push(changelogNode(ctx, s));
       } else {
-        flat.push(sectionNode(ctx, s, buildSectionTree(ctx, scopeSegs, sec)));
+        flat.push(sectionNode(ctx, s, buildSectionTree(ctx, scopeSegs, sec, sectionPaths)));
       }
     }
   }
@@ -1223,10 +1133,7 @@ function buildSidebarRoot(ctx, scopeSegs) {
 function buildFullRootFromSegments(options) {
   const { basePath, title, segments, navBySegment } = options;
   const ctx = createBuildContext(basePath);
-  const scoped = segments.filter((seg) => {
-    const t = metaStr(seg.metadata, "type");
-    return t !== "files" && t !== "redirects";
-  }).map((seg) => ({ seg, nav: navBySegment.get(seg.segmentHash) ?? [] }));
+  const scoped = segments.map((seg) => ({ seg, meta: segMeta(seg), nav: navBySegment.get(seg.segmentHash) ?? [] })).filter((s) => s.meta.type !== "files" && s.meta.type !== "redirects");
   const rootSlug = asSlug(basePath);
   const scopesByKey = /* @__PURE__ */ new Map();
   for (const s of scoped) {
@@ -1244,7 +1151,7 @@ function buildFullRootFromSegments(options) {
   } else if (versions.length > 0) {
     child = buildVersioned(ctx, versions, scoped, rootSlug, void 0);
   } else {
-    child = buildUnversioned(ctx, scoped, rootSlug, tabs.length > 0);
+    child = buildUnversioned(ctx, scoped, tabs.length > 0);
   }
   let rootPointsTo;
   if (child.type === "productgroup") {
@@ -1254,15 +1161,20 @@ function buildFullRootFromSegments(options) {
     const defaultVersion = child.children.find((v) => v.default) ?? child.children[0];
     rootPointsTo = defaultVersion?.pointsTo;
   }
-  const root = {
+  return {
     type: "root",
     version: "v2",
-    ...withMetadataDefaults({ id: ctx.nodeId("root"), title, slug: rootSlug, icon: void 0, hidden: void 0 }),
+    ...withMetadataDefaults({
+      id: ctx.nodeId("root"),
+      title,
+      slug: rootSlug,
+      icon: void 0,
+      hidden: void 0
+    }),
     roles: void 0,
     pointsTo: rootPointsTo,
     child
   };
-  return root;
 }
 function uniqueDetails(scoped, dim) {
   const bySlug = /* @__PURE__ */ new Map();
@@ -1271,15 +1183,14 @@ function uniqueDetails(scoped, dim) {
     if (d == null) {
       continue;
     }
-    const slug = detailSlug(d);
+    const dm = detailMeta(d);
+    const slug = dm.slug ?? "";
     const existing = bySlug.get(slug);
-    if (existing == null) {
-      bySlug.set(slug, d);
-    } else if (metaStr(d.metadata, "pointsTo") != null && metaStr(existing.metadata, "pointsTo") == null) {
-      bySlug.set(slug, d);
+    if (existing == null || dm.pointsTo != null && existing.meta.pointsTo == null) {
+      bySlug.set(slug, { detail: d, meta: dm });
     }
   }
-  return [...bySlug.values()].sort((a, b) => a.sortOrder - b.sortOrder);
+  return [...bySlug.values()].map((e) => e.detail).sort((a, b) => a.sortOrder - b.sortOrder);
 }
 function scopeSlugPrefix(rootSlug, ...details) {
   const parts = [rootSlug];
@@ -1299,22 +1210,22 @@ function buildTabbedOrSidebar(ctx, scopeSegs, tabsPresent) {
   }
   const tabDetails = uniqueDetails(scopeSegs, "tab");
   const children = tabDetails.map((tab) => {
-    const tabType = metaStr(tab.metadata, "tab_type");
+    const tm = detailMeta(tab);
     const tabSlug = asSlug(scopeSlugPrefix(Slug(""), tab));
-    if (tabType === "link") {
+    if (tm.tab_type === "link") {
       return {
         type: "link",
-        id: ctx.nodeId(`link:${metaStr(tab.metadata, "url") ?? tabSlug}`),
+        id: ctx.nodeId(`link:${tm.url ?? tabSlug}`),
         collapsed: void 0,
         title: tab.displayName,
         icon: tab.icon ?? void 0,
-        url: Url(metaStr(tab.metadata, "url") ?? ""),
+        url: Url(tm.url ?? ""),
         target: void 0
       };
     }
-    if (tabType === "changelog") {
+    if (tm.tab_type === "changelog") {
       const tabSegs2 = scopeSegs.filter((s) => s.seg.tab?.id === tab.id);
-      const changelogSeg = tabSegs2.find((s) => metaStr(s.seg.metadata, "type") === "changelog");
+      const changelogSeg = tabSegs2.find((s) => s.meta.type === "changelog");
       if (changelogSeg != null) {
         return changelogNode(ctx, changelogSeg);
       }
@@ -1334,7 +1245,6 @@ function buildTabbedOrSidebar(ctx, scopeSegs, tabsPresent) {
       };
     }
     const tabSegs = scopeSegs.filter((s) => s.seg.tab?.id === tab.id);
-    const metaPointsTo = metaStr(tab.metadata, "pointsTo");
     return {
       type: "tab",
       ...withMetadataDefaults({
@@ -1345,7 +1255,7 @@ function buildTabbedOrSidebar(ctx, scopeSegs, tabsPresent) {
         hidden: tab.hidden,
         viewers: toViewers(tab.viewers)
       }),
-      pointsTo: metaPointsTo != null ? ctx.contentSlug(metaPointsTo) : void 0,
+      pointsTo: pointsToSlug(ctx, tm),
       child: buildSidebarRoot(ctx, tabSegs)
     };
   });
@@ -1357,8 +1267,7 @@ function buildTabbedOrSidebar(ctx, scopeSegs, tabsPresent) {
     children
   };
 }
-function buildUnversioned(ctx, scopeSegs, rootSlug, tabsPresent) {
-  void rootSlug;
+function buildUnversioned(ctx, scopeSegs, tabsPresent) {
   const first = scopeSegs[0];
   return {
     type: "unversioned",
@@ -1370,11 +1279,12 @@ function buildUnversioned(ctx, scopeSegs, rootSlug, tabsPresent) {
 }
 function buildVersioned(ctx, versions, scoped, rootSlug, productPrefix) {
   const children = versions.map((version) => {
+    const vm = detailMeta(version);
     const versionSegs = scoped.filter((s) => s.seg.version?.id === version.id);
     const tabsPresent = uniqueDetails(versionSegs, "tab").length > 0;
-    const prefix = productPrefix != null ? productPrefix : rootSlug;
-    const slug = version.metadata != null && detailIsDefault(version) ? prefix : scopeSlugPrefix(rootSlug, version);
-    const node = {
+    const prefix = productPrefix ?? rootSlug;
+    const slug = vm.default ? prefix : scopeSlugPrefix(rootSlug, version);
+    return {
       type: "version",
       ...withMetadataDefaults({
         id: ctx.nodeId(`version:${slug}`),
@@ -1384,15 +1294,14 @@ function buildVersioned(ctx, versions, scoped, rootSlug, productPrefix) {
         hidden: version.hidden,
         viewers: toViewers(version.viewers)
       }),
-      default: detailIsDefault(version),
+      default: vm.default ?? false,
       versionId: VersionId(version.id),
       availability: void 0,
       landingPage: void 0,
       announcement: void 0,
-      pointsTo: metaStr(version.metadata, "pointsTo") != null ? ctx.contentSlug(metaStr(version.metadata, "pointsTo")) : void 0,
+      pointsTo: pointsToSlug(ctx, vm),
       child: buildTabbedOrSidebar(ctx, versionSegs, tabsPresent)
     };
-    return node;
   });
   return {
     type: "versioned",
@@ -1403,12 +1312,13 @@ function buildVersioned(ctx, versions, scoped, rootSlug, productPrefix) {
 }
 function buildProductGroup(ctx, products, scoped, rootSlug) {
   const children = products.map((product) => {
+    const pm = detailMeta(product);
     const productSegs = scoped.filter((s) => s.seg.product?.id === product.id);
     const versions = uniqueDetails(productSegs, "version");
     const tabsPresent = uniqueDetails(productSegs, "tab").length > 0;
     const productPrefix = scopeSlugPrefix(rootSlug, product);
-    const productChild = versions.length > 0 ? buildVersioned(ctx, versions, productSegs, rootSlug, productPrefix) : buildUnversioned(ctx, productSegs, rootSlug, tabsPresent);
-    const node = {
+    const productChild = versions.length > 0 ? buildVersioned(ctx, versions, productSegs, rootSlug, productPrefix) : buildUnversioned(ctx, productSegs, tabsPresent);
+    return {
       type: "product",
       ...withMetadataDefaults({
         id: ctx.nodeId(`product:${productPrefix}`),
@@ -1420,13 +1330,12 @@ function buildProductGroup(ctx, products, scoped, rootSlug) {
       }),
       default: detailIsDefault(product),
       productId: ProductId(product.id),
-      subtitle: metaStr(product.metadata, "subtitle") ?? "",
+      subtitle: pm.subtitle ?? "",
       image: void 0,
       announcement: void 0,
-      pointsTo: metaStr(product.metadata, "pointsTo") != null ? ctx.contentSlug(metaStr(product.metadata, "pointsTo")) : void 0,
+      pointsTo: pointsToSlug(ctx, pm),
       child: productChild
     };
-    return node;
   });
   return {
     type: "productgroup",