@fern-api/fdr-sdk 1.2.39-e182f82244 → 1.2.39-f82f6883d8

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

@@ -1289,12 +1289,10 @@ function sectionNode(ctx, scoped, sectionChildren, scopePrefix) {
   return {
     type: "section",
     ...defaults,
-    // 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,
+    collapsed: 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),
+    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"),
     pointsTo: metaPointsTo != null ? pointsToSlug(metaPointsTo) : void 0,
@@ -1521,7 +1519,7 @@ function changelogNode(ctx, scoped, scopePrefix) {
       pageId: PageId(metaStr(r.metadata, "pageId") ?? ""),
       noindex: metaBool(r.metadata, "noindex"),
       date: dateStr ?? "",
-      tags: void 0
+      tags: metaStrArr(r.metadata, "tags")
     };
     let months = byYear.get(year);
     if (months == null) {
@@ -1628,11 +1626,46 @@ function buildSectionTree(ctx, scopeSegs, parentPath, scopePrefix, changelogScop
     return { node, childIndex };
   });
 }
+function computeSiblingSortBoundaries(ordered) {
+  const result = /* @__PURE__ */ new Map();
+  const sectionPaths = new Set(ordered.map((s) => s.seg.section));
+  const rootSections = [];
+  for (const s of ordered) {
+    const type = metaStr(s.seg.metadata, "type");
+    const sec = s.seg.section;
+    if (type !== "section" || sec === "") {
+      continue;
+    }
+    const parent = parentSectionPath(sec);
+    const isRootLevel = parent === "" || !sectionPaths.has(parent) && nearestExistingAncestor(sec, sectionPaths) === "";
+    if (isRootLevel) {
+      rootSections.push(s);
+    }
+  }
+  const byPath = /* @__PURE__ */ new Map();
+  for (const s of rootSections) {
+    const group = byPath.get(s.seg.section) ?? [];
+    group.push(s);
+    byPath.set(s.seg.section, group);
+  }
+  for (const [, siblings] of byPath) {
+    if (siblings.length <= 1) {
+      continue;
+    }
+    for (let i = 0; i < siblings.length; i++) {
+      const lo = siblings[i].seg.sortOrder;
+      const hi = i + 1 < siblings.length ? siblings[i + 1].seg.sortOrder : Number.MAX_SAFE_INTEGER;
+      result.set(siblings[i], { lo, hi });
+    }
+  }
+  return result;
+}
 function buildSidebarRootChildren(ctx, scopeSegs, scopePrefix, changelogScopePrefix) {
   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);
   for (const s of ordered) {
     const type = metaStr(s.seg.metadata, "type");
     const sec = s.seg.section;
@@ -1669,14 +1702,21 @@ function buildSidebarRootChildren(ctx, scopeSegs, scopePrefix, changelogScopePre
       } else if (type === "changelog") {
         node = changelogNode(ctx, s, changelogScopePrefix ?? scopePrefix);
       } 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, scopeSegs, sec, scopePrefix, changelogScopePrefix),
+          buildSectionTree(ctx, ownedSegs, sec, scopePrefix, changelogScopePrefix),
           scopePrefix
         );
       }
-      annotated.push({ node, pos: metaNum(s.seg.metadata, "childIndex"), isLeaf: false });
+      const isSharedSection = siblingBoundaries.size > 0 && scopePrefix !== "" && sec !== "" && !sec.startsWith(scopePrefix);
+      annotated.push({
+        node,
+        pos: isSharedSection ? void 0 : metaNum(s.seg.metadata, "childIndex"),
+        isLeaf: false
+      });
     }
   }
   const hasLeafPos = annotated.some((a) => a.isLeaf && a.pos != null);
@@ -1728,7 +1768,7 @@ function buildSidebarRoot(ctx, scopeSegs, scopePrefix, changelogScopePrefix) {
   };
 }
 function buildFullRootFromSegments(options) {
-  const { basePath, rootSlug: sourceRootSlug, title, segments, navBySegment } = options;
+  const { basePath, rootSlug: sourceRootSlug, title, segments, navBySegment, skipSharedSectionMerge } = options;
   const ctx = createBuildContext(basePath);
   const scoped = segments.filter((seg) => {
     const t = metaStr(seg.metadata, "type");
@@ -1747,9 +1787,9 @@ function buildFullRootFromSegments(options) {
   const tabs = uniqueDetails(scoped, "tab");
   let child;
   if (products.length > 0) {
-    child = buildProductGroup(ctx, products, scoped, rootSlug);
+    child = buildProductGroup(ctx, products, scoped, rootSlug, skipSharedSectionMerge);
   } else if (versions.length > 0) {
-    child = buildVersioned(ctx, versions, scoped, rootSlug, void 0);
+    child = buildVersioned(ctx, versions, scoped, rootSlug, void 0, skipSharedSectionMerge);
   } else {
     child = buildUnversioned(ctx, scoped, rootSlug, tabs.length > 0);
   }
@@ -1856,20 +1896,34 @@ function buildSidebarRootWithVariants(ctx, scopeSegs, scopePrefix, changelogScop
   if (variants.length <= 1) {
     return buildSidebarRoot(ctx, scopeSegs, scopePrefix, changelogScopePrefix);
   }
+  const sharedSegs = scopeSegs.filter((s) => s.seg.variant == null);
   const variantedNode = buildVariantedNode(ctx, variants, scopeSegs, scopePrefix);
+  const sharedChildren = sharedSegs.length > 0 ? buildSidebarRootChildren(ctx, sharedSegs, scopePrefix, changelogScopePrefix) : [];
   const first = scopeSegs[0];
   return {
     type: "sidebarRoot",
     id: ctx.nodeId(`sidebar:${first != null ? scopeKey(first.seg) : "root"}`),
     collapsed: void 0,
-    children: [variantedNode]
+    children: [...sharedChildren, variantedNode]
   };
 }
 function buildTabbedOrSidebar(ctx, scopeSegs, tabsPresent, scopePrefix) {
   if (!tabsPresent) {
     const variants = uniqueDetails(scopeSegs, "variant");
     if (variants.length > 1) {
-      return buildVariantedNode(ctx, variants, scopeSegs, scopePrefix);
+      const sharedSegs = scopeSegs.filter((s) => s.seg.variant == null);
+      const variantedNode = buildVariantedNode(ctx, variants, scopeSegs, scopePrefix);
+      if (sharedSegs.length > 0) {
+        const sharedChildren = buildSidebarRootChildren(ctx, sharedSegs, scopePrefix);
+        const first2 = scopeSegs[0];
+        return {
+          type: "sidebarRoot",
+          id: ctx.nodeId(`sidebar:${first2 != null ? scopeKey(first2.seg) : "root"}`),
+          collapsed: void 0,
+          children: [...sharedChildren, variantedNode]
+        };
+      }
+      return variantedNode;
     }
     return buildSidebarRoot(ctx, scopeSegs, scopePrefix);
   }
@@ -1956,9 +2010,64 @@ function buildUnversioned(ctx, scopeSegs, scopePrefix, tabsPresent) {
     child: buildTabbedOrSidebar(ctx, scopeSegs, tabsPresent, scopePrefix)
   };
 }
-function buildVersioned(ctx, versions, scoped, rootSlug, productPrefix) {
+function mergeSharedSections(defaultSegs, allScoped, defaultVersion, versionSlugs) {
+  const defaultTabsByName = /* @__PURE__ */ new Map();
+  for (const s of defaultSegs) {
+    if (s.seg.tab != null) {
+      const tabName = s.seg.tab.displayName;
+      if (!defaultTabsByName.has(tabName)) {
+        defaultTabsByName.set(tabName, s.seg.tab);
+      }
+    }
+  }
+  const existingSections = new Set(
+    defaultSegs.filter((s) => metaStr(s.seg.metadata, "type") === "section").map((s) => s.seg.section)
+  );
+  const maxSortOrder = defaultSegs.reduce((max, s) => Math.max(max, s.seg.sortOrder), 0);
+  let nextSortOrder = maxSortOrder + 1;
+  const merged = [...defaultSegs];
+  for (const s of allScoped) {
+    if (s.seg.version?.id === defaultVersion.id) {
+      continue;
+    }
+    const type = metaStr(s.seg.metadata, "type");
+    if (type !== "section") {
+      continue;
+    }
+    const sectionPath = s.seg.section;
+    if (versionSlugs.some((vs) => sectionPath === vs || sectionPath.startsWith(vs + "/"))) {
+      continue;
+    }
+    if (existingSections.has(sectionPath)) {
+      continue;
+    }
+    const sourceTabName = s.seg.tab?.displayName ?? "";
+    const targetTab = defaultTabsByName.get(sourceTabName);
+    if (targetTab == null) {
+      continue;
+    }
+    const metadata = s.seg.metadata != null ? { ...s.seg.metadata, childIndex: void 0 } : s.seg.metadata;
+    merged.push({
+      seg: {
+        ...s.seg,
+        tab: targetTab,
+        version: defaultVersion,
+        sortOrder: nextSortOrder++,
+        metadata
+      },
+      nav: s.nav
+    });
+    existingSections.add(sectionPath);
+  }
+  return merged;
+}
+function buildVersioned(ctx, versions, scoped, rootSlug, productPrefix, skipSharedSectionMerge) {
+  const versionSlugs = versions.map((v) => detailSlug(v)).filter((s) => s !== "");
   const children = versions.map((version) => {
-    const versionSegs = scoped.filter((s) => s.seg.version?.id === version.id);
+    let versionSegs = scoped.filter((s) => s.seg.version?.id === version.id);
+    if (detailIsDefault(version) && !skipSharedSectionMerge) {
+      versionSegs = mergeSharedSections(versionSegs, scoped, version, versionSlugs);
+    }
     const tabsPresent = uniqueDetails(versionSegs, "tab").length > 0;
     const prefix = productPrefix != null ? productPrefix : rootSlug;
     const versionSegment = detailSlug(version);
@@ -2126,13 +2235,13 @@ function markCrossVersionCanonicalSlugs(versionNodes) {
     });
   }
 }
-function buildProductGroup(ctx, products, scoped, rootSlug) {
+function buildProductGroup(ctx, products, scoped, rootSlug, skipSharedSectionMerge) {
   const children = products.map((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, asSlug(productPrefix), tabsPresent);
+    const productChild = versions.length > 0 ? buildVersioned(ctx, versions, productSegs, rootSlug, productPrefix, skipSharedSectionMerge) : buildUnversioned(ctx, productSegs, asSlug(productPrefix), tabsPresent);
     const node = {
       type: "product",
       ...withMetadataDefaults({