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

package/dist/navigation/__test__/ledger-root-builder.skipSlugSiblingSection.test.js

@@ -0,0 +1,256 @@
+import { describe, expect, it } from "vitest";
+import * as FernNavigation from "../index.js";
+import { buildFullRootFromSegments } from "../ledger-root-builder.js";
+/**
+ * Tests for the case where a section with skipUrlSlug (section="") sits inside
+ * a sidebarGroup alongside sibling sections. The `childIndex` metadata field
+ * (set by `walkNavSubTrees` on the write side) distinguishes these from true
+ * root-section wrappers (direct sidebarRoot children with no childIndex).
+ *
+ * Without the fix, the builder treats ANY section="" segment as a root wrapper,
+ * incorrectly nesting all depth-0 siblings under it and producing spurious
+ * breadcrumb entries (e.g. "Introduction > Echo" instead of just "Echo").
+ *
+ * Real-world repro: mangopay-ledger-test, where the "Introduction" section
+ * has skipUrlSlug (slug == tab slug) and shares a sidebarGroup with ~10 peer
+ * sections (Users, Echo, SCA, Payouts, …).
+ */
+function detail(opts) {
+    return {
+        id: opts.id,
+        displayName: opts.name,
+        icon: null,
+        sortOrder: 0,
+        hidden: false,
+        viewers: [],
+        orphaned: false,
+        featureFlags: [],
+        metadata: { slug: opts.slug, default: false, pointsTo: opts.pointsTo }
+    };
+}
+function seg(opts) {
+    return {
+        segmentId: opts.segmentHash,
+        segmentHash: opts.segmentHash,
+        section: opts.section,
+        locale: "en",
+        sortOrder: opts.sortOrder ?? 0,
+        hidden: false,
+        metadata: {
+            type: opts.type,
+            ...(opts.title != null ? { title: opts.title } : {}),
+            ...(opts.childIndex != null ? { childIndex: opts.childIndex } : {})
+        },
+        product: null,
+        version: null,
+        variant: null,
+        tab: opts.tab ?? null
+    };
+}
+function markdownRoute(fullPath, title, pageId) {
+    return { type: "markdown", fullPath, hidden: false, metadata: { title, pageId } };
+}
+function buildRoot(opts) {
+    return buildFullRootFromSegments({
+        basePath: opts.basePath,
+        title: "Test",
+        segments: opts.segments,
+        navBySegment: opts.navBySegment
+    });
+}
+function findSectionNodes(root) {
+    const sections = [];
+    FernNavigation.traverseDF(root, (node) => {
+        if (node.type === "section") {
+            sections.push(node);
+        }
+    });
+    return sections;
+}
+function findSidebarRootChildren(root) {
+    let sidebarChildren = [];
+    FernNavigation.traverseDF(root, (node) => {
+        if (node.type === "sidebarRoot" && sidebarChildren.length === 0) {
+            sidebarChildren = [...node.children];
+        }
+    });
+    return sidebarChildren;
+}
+describe("buildFullRootFromSegments — skipUrlSlug sibling sections are NOT adopted as root-section children", () => {
+    // Reproduces the mangopay-ledger-test bug: "Introduction" (section="",
+    // childIndex=0) shares a sidebarGroup with "Echo" and "Users".
+    // Without the fix, "Echo" and "Users" are incorrectly nested inside
+    // "Introduction", adding a spurious "Introduction" breadcrumb to every
+    // page under Echo and Users.
+    const tab = detail({
+        id: "t-guides",
+        name: "Guides",
+        slug: "guides",
+        pointsTo: "guides/e-wallet-system"
+    });
+    const tabRoot = seg({
+        segmentHash: "s-tabroot",
+        section: "",
+        type: "tabRoot",
+        tab
+    });
+    // "Introduction" section with skipUrlSlug — its slug matches the tab slug,
+    // so the write side assigns section="" with childIndex=0 (from walkNavSubTrees).
+    const introSection = seg({
+        segmentHash: "s-intro",
+        section: "",
+        type: "section",
+        title: "Introduction",
+        sortOrder: 1,
+        childIndex: 0,
+        tab
+    });
+    // Sibling sections — these should NOT be nested inside Introduction.
+    const echoSection = seg({
+        segmentHash: "s-echo",
+        section: "echo",
+        type: "section",
+        title: "Echo",
+        sortOrder: 2,
+        childIndex: 1,
+        tab
+    });
+    const usersSection = seg({
+        segmentHash: "s-users",
+        section: "users",
+        type: "section",
+        title: "Users",
+        sortOrder: 3,
+        childIndex: 2,
+        tab
+    });
+    const segments = [tabRoot, introSection, echoSection, usersSection];
+    const navBySegment = new Map([
+        ["s-tabroot", []],
+        ["s-intro", [markdownRoute("guides/e-wallet-system", "E-wallet system", "pg-ewallet")]],
+        [
+            "s-echo",
+            [
+                markdownRoute("guides/echo", "Mangopay Echo", "pg-echo"),
+                markdownRoute("guides/echo/reconciliation", "Reconciliation", "pg-recon")
+            ]
+        ],
+        ["s-users", [markdownRoute("guides/users/types", "Types", "pg-user-types")]]
+    ]);
+    it("sections with childIndex remain siblings, not nested under section='' segment", () => {
+        const root = buildRoot({ basePath: "", segments, navBySegment });
+        const sections = findSectionNodes(root);
+        const introSec = sections.find((s) => s.title === "Introduction");
+        const echoSec = sections.find((s) => s.title === "Echo");
+        const usersSec = sections.find((s) => s.title === "Users");
+        expect(introSec).toBeDefined();
+        expect(echoSec).toBeDefined();
+        expect(usersSec).toBeDefined();
+        // Echo and Users must NOT be children of Introduction.
+        const introChildren = (introSec?.children ?? [])
+            .filter((c) => c.type === "section")
+            .map((c) => c.title);
+        expect(introChildren).not.toContain("Echo");
+        expect(introChildren).not.toContain("Users");
+        // All three should be at the sidebar root level (possibly inside sidebarGroups).
+        const sidebarChildren = findSidebarRootChildren(root);
+        const topLevelTitles = [];
+        for (const child of sidebarChildren) {
+            if (child.type === "section") {
+                topLevelTitles.push(child.title);
+            }
+            else if (child.type === "sidebarGroup") {
+                for (const gc of child.children) {
+                    if (gc.type === "section") {
+                        topLevelTitles.push(gc.title);
+                    }
+                }
+            }
+        }
+        expect(topLevelTitles).toContain("Introduction");
+        expect(topLevelTitles).toContain("Echo");
+        expect(topLevelTitles).toContain("Users");
+    });
+    it("breadcrumb for a page inside Echo does NOT include Introduction", () => {
+        const root = buildRoot({ basePath: "", segments, navBySegment });
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        const found = FernNavigation.utils.findNode(root, FernNavigation.Slug("guides/echo"));
+        expect(found.type).toBe("found");
+        if (found.type !== "found") {
+            return;
+        }
+        const breadcrumbTitles = found.breadcrumb.map((b) => b.title);
+        expect(breadcrumbTitles).toContain("Echo");
+        expect(breadcrumbTitles).not.toContain("Introduction");
+    });
+    it("breadcrumb for a page inside Users does NOT include Introduction", () => {
+        const root = buildRoot({ basePath: "", segments, navBySegment });
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        const found = FernNavigation.utils.findNode(root, FernNavigation.Slug("guides/users/types"));
+        expect(found.type).toBe("found");
+        if (found.type !== "found") {
+            return;
+        }
+        const breadcrumbTitles = found.breadcrumb.map((b) => b.title);
+        expect(breadcrumbTitles).toContain("Users");
+        expect(breadcrumbTitles).not.toContain("Introduction");
+    });
+});
+describe("buildFullRootFromSegments — true root-section wrappers (no childIndex) still work", () => {
+    // Regression guard: when a section has section="" WITHOUT childIndex,
+    // it IS a true root wrapper and should adopt depth-0 children.
+    const tab = detail({
+        id: "t-docs",
+        name: "Docs",
+        slug: "docs",
+        pointsTo: "docs/overview/intro"
+    });
+    it("adopts depth-0 children when childIndex is absent", () => {
+        const root = buildRoot({
+            basePath: "",
+            segments: [
+                // True root section wrapper (no childIndex)
+                seg({
+                    segmentHash: "s-root",
+                    section: "",
+                    type: "section",
+                    title: "Overview",
+                    tab
+                }),
+                seg({
+                    segmentHash: "s-gs",
+                    section: "get-started",
+                    type: "section",
+                    title: "Get Started",
+                    sortOrder: 1,
+                    tab
+                }),
+                seg({
+                    segmentHash: "s-adv",
+                    section: "advanced",
+                    type: "section",
+                    title: "Advanced",
+                    sortOrder: 2,
+                    tab
+                })
+            ],
+            navBySegment: new Map([
+                ["s-root", [markdownRoute("docs/overview/intro", "Intro", "pg-intro")]],
+                ["s-gs", [markdownRoute("docs/overview/get-started/setup", "Setup", "pg-setup")]],
+                ["s-adv", [markdownRoute("docs/overview/advanced/tips", "Tips", "pg-tips")]]
+            ])
+        });
+        const sections = findSectionNodes(root);
+        const overviewSec = sections.find((s) => s.title === "Overview");
+        expect(overviewSec).toBeDefined();
+        // Child sections should be nested under Overview (root wrapper behavior)
+        const childTitles = (overviewSec?.children ?? [])
+            .filter((c) => c.type === "section")
+            .map((c) => c.title);
+        expect(childTitles).toContain("Get Started");
+        expect(childTitles).toContain("Advanced");
+        // 3 total sections (Overview + Get Started + Advanced), not duplicated
+        expect(sections.length).toBe(3);
+    });
+});
+//# sourceMappingURL=ledger-root-builder.skipSlugSiblingSection.test.js.map

package/dist/navigation/__test__/ledger-root-builder.skipSlugSiblingSection.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-root-builder.skipSlugSiblingSection.test.js","sourceRoot":"","sources":["../../../src/navigation/__test__/ledger-root-builder.skipSlugSiblingSection.test.ts"],"names":[],"mappings":"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"}

package/dist/navigation/ledger-root-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ledger-root-builder.d.ts","sourceRoot":"","sources":["../../src/navigation/ledger-root-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACnG,OAAO,KAAK,cAAc,MAAM,YAAY,CAAC;AAG7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,KAAK,OAAO,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AA6B9C,MAAM,WAAW,gBAAgB;IAC7B,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,yGAAyG;IACzG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,6DAA6D;IAC7D,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtC;;;;;;;;OAQG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CACpC;AAID;;;;;;GAMG;AACH,UAAU,YAAY;IAClB,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,cAAc,CAAC,MAAM,CAAC;IAC/C,kFAAkF;IAClF,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,cAAc,CAAC,IAAI,CAAC;CAC9D;AAED,2CAA2C;AAC3C,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAuBjE;AA+OD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACjB,cAAc,CAAC,YAAY,GAC3B,cAAc,CAAC,WAAW,GAC1B,cAAc,CAAC,aAAa,GAC5B,cAAc,CAAC,QAAQ,GACvB,cAAc,CAAC,WAAW,CAAC;AAOjC;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,MAAM,EAChB,sBAAsB,EAAE,MAAM,GAC/B,WAAW,GAAG,SAAS,CAGzB;AA+KD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACtC,MAAM,EAAE,QAAQ,EAAE,EAClB,QAAQ,EAAE,MAAM,EAChB,sBAAsB,EAAE,MAAM,GAC/B,WAAW,EAAE,CAKf;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,SAAS,CASxF;AAiWD;;;;;;GAMG;AACH,2CAA2C;AAC3C,wBAAgB,kBAAkB,CAC9B,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,WAAW,EAAE,EACxB,MAAM,EAAE,QAAQ,EAAE,GACnB,cAAc,CAAC,eAAe,EAAE,CAsElC;AAkmBD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,CAAC,QAAQ,CAmF5F"}
+{"version":3,"file":"ledger-root-builder.d.ts","sourceRoot":"","sources":["../../src/navigation/ledger-root-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACnG,OAAO,KAAK,cAAc,MAAM,YAAY,CAAC;AAG7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,KAAK,OAAO,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AA6B9C,MAAM,WAAW,gBAAgB;IAC7B,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,yGAAyG;IACzG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,6DAA6D;IAC7D,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtC;;;;;;;;OAQG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CACpC;AAID;;;;;;GAMG;AACH,UAAU,YAAY;IAClB,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,cAAc,CAAC,MAAM,CAAC;IAC/C,kFAAkF;IAClF,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,cAAc,CAAC,IAAI,CAAC;CAC9D;AAED,2CAA2C;AAC3C,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAuBjE;AAoRD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACjB,cAAc,CAAC,YAAY,GAC3B,cAAc,CAAC,WAAW,GAC1B,cAAc,CAAC,aAAa,GAC5B,cAAc,CAAC,QAAQ,GACvB,cAAc,CAAC,WAAW,CAAC;AAOjC;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,MAAM,EAChB,sBAAsB,EAAE,MAAM,GAC/B,WAAW,GAAG,SAAS,CAGzB;AA+KD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACtC,MAAM,EAAE,QAAQ,EAAE,EAClB,QAAQ,EAAE,MAAM,EAChB,sBAAsB,EAAE,MAAM,GAC/B,WAAW,EAAE,CAKf;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,SAAS,CASxF;AAiWD;;;;;;GAMG;AACH,2CAA2C;AAC3C,wBAAgB,kBAAkB,CAC9B,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,WAAW,EAAE,EACxB,MAAM,EAAE,QAAQ,EAAE,GACnB,cAAc,CAAC,eAAe,EAAE,CAsElC;AA8oBD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,CAAC,QAAQ,CAmF5F"}

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

@@ -60,6 +60,41 @@ function metaStr(metadata, key) {
     }
     return undefined;
 }
+/**
+ * V1 availability values stored in ledger metadata are lowercase (e.g. "deprecated"),
+ * but the latest Availability type uses PascalCase (e.g. "Deprecated"). This map
+ * normalises both formats so the badge component can look up display names correctly.
+ */
+const AVAILABILITY_LOOKUP = {
+    // V1 lowercase values (stored by docsPublishTransform from V1 navigation tree)
+    alpha: FernNavigation.Availability.Alpha,
+    stable: FernNavigation.Availability.Stable,
+    "generally-available": FernNavigation.Availability.GenerallyAvailable,
+    "in-development": FernNavigation.Availability.InDevelopment,
+    "pre-release": FernNavigation.Availability.PreRelease,
+    deprecated: FernNavigation.Availability.Deprecated,
+    beta: FernNavigation.Availability.Beta,
+    preview: FernNavigation.Availability.Preview,
+    legacy: FernNavigation.Availability.Legacy,
+    // Latest PascalCase values (pass-through)
+    Alpha: FernNavigation.Availability.Alpha,
+    Stable: FernNavigation.Availability.Stable,
+    GenerallyAvailable: FernNavigation.Availability.GenerallyAvailable,
+    InDevelopment: FernNavigation.Availability.InDevelopment,
+    PreRelease: FernNavigation.Availability.PreRelease,
+    Deprecated: FernNavigation.Availability.Deprecated,
+    Beta: FernNavigation.Availability.Beta,
+    Preview: FernNavigation.Availability.Preview,
+    Legacy: FernNavigation.Availability.Legacy
+};
+/** Read an availability field from metadata, converting V1 lowercase to latest PascalCase. */
+function metaAvailability(metadata) {
+    const raw = metaStr(metadata, "availability");
+    if (raw == null) {
+        return undefined;
+    }
+    return AVAILABILITY_LOOKUP[raw];
+}
 function metaBool(metadata, key) {
     if (metadata != null && typeof metadata === "object" && key in metadata) {
         const v = metadata[key];
@@ -198,7 +233,7 @@ function artifactToNode(ctx, route) {
                 }),
                 pageId: FernNavigation.PageId(pageId),
                 noindex: metaBool(md, "noindex"),
-                availability: metaStr(md, "availability")
+                availability: metaAvailability(md)
             };
             return node;
         }
@@ -269,7 +304,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId) {
             endpointId: FernNavigation.EndpointId(endpointId),
             apiDefinitionId,
             isResponseStream: metaBool(md, "isResponseStream"),
-            availability: metaStr(md, "availability"),
+            availability: metaAvailability(md),
             playground: undefined
         };
     }
@@ -285,7 +320,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId) {
             method: method,
             webhookId: FernNavigation.WebhookId(webhookId),
             apiDefinitionId,
-            availability: metaStr(md, "availability")
+            availability: metaAvailability(md)
         };
     }
     if (route.type === "asyncapi") {
@@ -298,7 +333,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId) {
             ...meta,
             webSocketId: FernNavigation.WebSocketId(webSocketId),
             apiDefinitionId,
-            availability: metaStr(md, "availability"),
+            availability: metaAvailability(md),
             playground: undefined
         };
     }
@@ -314,7 +349,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId) {
             method: method,
             grpcId: FernNavigation.GrpcId(grpcId),
             apiDefinitionId,
-            availability: metaStr(md, "availability")
+            availability: metaAvailability(md)
         };
     }
     if (route.type === "graphql") {
@@ -330,7 +365,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId) {
             graphqlOperationId: FernNavigation.GraphQlOperationId(graphqlOperationId),
             graphqlOperationIds: undefined,
             apiDefinitionId,
-            availability: metaStr(md, "availability"),
+            availability: metaAvailability(md),
             playground: undefined
         };
     }
@@ -597,7 +632,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 : undefined),
         collapsedByDefault: metaBool(seg.metadata, "collapsedByDefault") ?? (metaCollapsed(seg.metadata) === true ? true : undefined),
-        availability: metaStr(seg.metadata, "availability"),
+        availability: metaAvailability(seg.metadata),
         pointsTo: metaPointsTo != null ? pointsToSlug(metaPointsTo) : undefined,
         children: mergeChildrenByPosition(ctx, nav, sectionChildren)
     };
@@ -686,7 +721,7 @@ function apiPackageChildNode(ctx, scoped, scopeSegs, parentApiDefinitionId, scop
             featureFlags: metaFeatureFlags(seg.metadata)
         }),
         apiDefinitionId: FernNavigation.ApiDefinitionId(apiDefinitionId),
-        availability: metaStr(seg.metadata, "availability"),
+        availability: metaAvailability(seg.metadata),
         overviewPageId: overviewPageId != null ? FernNavigation.PageId(overviewPageId) : undefined,
         noindex: metaBool(overview?.metadata, "noindex") ?? metaBool(seg.metadata, "noindex"),
         pointsTo: metaPointsTo != null ? pointsToSlug(metaPointsTo) : undefined,
@@ -796,7 +831,7 @@ function apiReferenceNode(ctx, scoped, scopeSegs, scopePrefix) {
             featureFlags: metaFeatureFlags(seg.metadata)
         }),
         apiDefinitionId: FernNavigation.ApiDefinitionId(apiDefinitionId),
-        availability: metaStr(seg.metadata, "availability"),
+        availability: metaAvailability(seg.metadata),
         overviewPageId: overviewPageId != null ? FernNavigation.PageId(overviewPageId) : undefined,
         noindex: metaBool(overview?.metadata, "noindex") ?? metaBool(seg.metadata, "noindex"),
         paginated: true,
@@ -1055,12 +1090,19 @@ function buildSectionTree(ctx, scopeSegs, parentPath, scopePrefix, changelogScop
 function computeSiblingSortBoundaries(ordered) {
     const result = new Map();
     // Collect root-level sections grouped by their section path.
+    // Sections with sec==="" (skip-slug sections) are included: when multiple
+    // skip-slug sections exist at the root, they share path "" and need
+    // boundaries so each only adopts its own children.
     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 === "") {
+        if (type !== "section") {
+            continue;
+        }
+        if (sec === "") {
+            rootSections.push(s);
             continue;
         }
         const parent = parentSectionPath(sec);
@@ -1109,6 +1151,17 @@ function buildSidebarRootChildren(ctx, scopeSegs, scopePrefix, changelogScopePre
     // segments. Both index into the SAME child list at write time, so they
     // interleave directly (e.g. [page 0, page 1, section 2…15, page 16, 17]).
     const annotated = [];
+    // ── Sibling section ownership ────────────────────────────────────────
+    //
+    // Multiple root-level sections can share the same section path (e.g.
+    // three sections all with path equal to the version slug). When this
+    // happens, buildSectionTree would incorrectly give ALL child subsections
+    // to each sibling. We resolve ownership via sortOrder: a section owns
+    // segments whose sortOrder falls between its own and the next sibling's.
+    //
+    // Computed first because hasRootSection (below) uses it to decide
+    // whether bounded skip-slug siblings should activate adoption.
+    const siblingBoundaries = computeSiblingSortBoundaries(ordered);
     // ── Root-section adoption flow ──────────────────────────────────────
     //
     // A scope may contain a "root section" — a segment with type "section"
@@ -1127,15 +1180,20 @@ function buildSidebarRootChildren(ctx, scopeSegs, scopePrefix, changelogScopePre
     //          → SKIP — already adopted by (B) via buildSectionTree
     //
     // Without a root section, depth-0 sections are emitted directly.
-    const hasRootSection = ordered.some((s) => metaStr(s.seg.metadata, "type") === "section" && s.seg.section === "");
-    // ── Sibling section ownership ────────────────────────────────────────
     //
-    // Multiple root-level sections can share the same section path (e.g.
-    // three sections all with path equal to the version slug). When this
-    // happens, buildSectionTree would incorrectly give ALL child subsections
-    // to each sibling. We resolve ownership via sortOrder: a section owns
-    // segments whose sortOrder falls between its own and the next sibling's.
-    const siblingBoundaries = computeSiblingSortBoundaries(ordered);
+    // A section with sec=="" AND `childIndex` in its metadata is a sibling
+    // inside a V1 sidebarGroup that has skipUrlSlug — not a true structural
+    // wrapper. `walkNavSubTrees` always passes `childIndex`; direct
+    // sidebarRoot children (true wrappers) never receive one.
+    //
+    // Such siblings only activate adoption when they have sortOrder
+    // boundaries (multiple sec="" sections sharing the same path), which
+    // correctly scope each section's children. A *single* unbounded
+    // skip-slug sibling (e.g. mangopay's "Introduction") must NOT adopt
+    // its depth-0 peers — doing so produces spurious breadcrumb entries.
+    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;
@@ -1158,8 +1216,16 @@ function buildSidebarRootChildren(ctx, scopeSegs, scopePrefix, changelogScopePre
             continue;
         }
         // (B) Root section wrapper — adopts depth-0 children via buildSectionTree.
-        if (type === "section" && sec === "") {
-            const sectionChildren = buildSectionTree(ctx, scopeSegs, "", scopePrefix);
+        // Only applies to true root wrappers (no childIndex); sibling
+        // sections with skipUrlSlug (have childIndex) fall through to (C).
+        // When multiple sections share sec==="" (skip-slug), scope children
+        // to each section's sortOrder range so subsections aren't duplicated.
+        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;
@@ -1190,7 +1256,20 @@ function buildSidebarRootChildren(ctx, scopeSegs, scopePrefix, changelogScopePre
                 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);
+                // A section with sec="" that reaches here (not adopted as a
+                // root wrapper in case B) is a skipUrlSlug sibling.
+                // When sortOrder boundaries exist (multiple sec="" sections),
+                // the scoped ownedSegs correctly limits which subsections
+                // each section can adopt. When there are NO boundaries
+                // (single sec="" section, e.g. mangopay's "Introduction"),
+                // buildSectionTree("") would re-adopt all depth-0 peers;
+                // pass an empty child list instead — its leaf artifacts are
+                // already in its own segment nav.
+                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);
             }
             // Shared/merged sections (paths not rooted in scopePrefix) must not
             // carry childIndex — their source-version positions would sort them