@fern-api/fdr-sdk 1.2.40-bcfd2ff480 → 1.2.41-02971594aa

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

@@ -0,0 +1,210 @@
+import { describe, expect, it } from "vitest";
+import * as FernNavigation from "../index.js";
+import { buildFullRootFromSegments } from "../ledger-root-builder.js";
+function segment(opts) {
+    return {
+        segmentId: opts.segmentHash,
+        segmentHash: opts.segmentHash,
+        section: opts.section,
+        locale: "en",
+        sortOrder: opts.sortOrder,
+        hidden: false,
+        metadata: opts.metadata,
+        product: null,
+        version: null,
+        variant: null,
+        tab: opts.tab != null
+            ? {
+                id: opts.tab.id,
+                displayName: opts.tab.displayName,
+                icon: null,
+                sortOrder: opts.tab.sortOrder ?? 0,
+                hidden: false,
+                viewers: [],
+                orphaned: false,
+                featureFlags: [],
+                metadata: {
+                    slug: opts.tab.slug,
+                    tab_type: "tab",
+                    ...(opts.tab.pointsTo != null ? { pointsTo: opts.tab.pointsTo } : {})
+                }
+            }
+            : null
+    };
+}
+function restRoute(opts) {
+    return {
+        type: "rest",
+        fullPath: opts.fullPath,
+        hidden: false,
+        displaySortOrder: opts.displaySortOrder,
+        metadata: {
+            title: opts.title,
+            apiDefinitionId: "plant-api-def",
+            endpointId: opts.endpointId,
+            method: opts.method ?? "GET",
+            isResponseStream: false
+        }
+    };
+}
+function markdownRoute(opts) {
+    return {
+        type: "markdown",
+        fullPath: opts.fullPath,
+        hidden: false,
+        displaySortOrder: opts.displaySortOrder,
+        metadata: { title: opts.title, pageId: opts.pageId }
+    };
+}
+describe("buildFullRootFromSegments — skip-slug apiReference", () => {
+    const guidesTab = {
+        id: "tab:guides",
+        displayName: "Guides",
+        slug: "",
+        sortOrder: 0,
+        pointsTo: "welcome"
+    };
+    const apiTab = {
+        id: "tab:api-reference",
+        displayName: "API Reference",
+        slug: "api-reference",
+        sortOrder: 1,
+        pointsTo: "api-reference/list-plants"
+    };
+    it("skip-slug apiReference at section='' includes endpoint children in sidebar", () => {
+        const segments = [
+            // Guides tab section
+            segment({
+                segmentHash: "guides-section",
+                section: "get-started",
+                sortOrder: 0,
+                metadata: { type: "section", title: "Get Started", pointsTo: "welcome" },
+                tab: guidesTab
+            }),
+            // API Reference tab — apiReference with skip-slug (section="")
+            segment({
+                segmentHash: "api-ref",
+                section: "",
+                sortOrder: 1,
+                metadata: {
+                    type: "apiReference",
+                    title: "Plant API",
+                    apiDefinitionId: "plant-api-def",
+                    pointsTo: "api-reference/list-plants"
+                },
+                tab: apiTab
+            })
+        ];
+        const navBySegment = new Map([
+            [
+                "guides-section",
+                [
+                    markdownRoute({
+                        fullPath: "welcome",
+                        title: "Welcome",
+                        pageId: "pages/welcome.mdx",
+                        displaySortOrder: 0
+                    }),
+                    markdownRoute({
+                        fullPath: "quickstart",
+                        title: "Quickstart",
+                        pageId: "pages/quickstart.mdx",
+                        displaySortOrder: 1
+                    })
+                ]
+            ],
+            [
+                "api-ref",
+                [
+                    restRoute({
+                        fullPath: "api-reference/list-plants",
+                        title: "List plants",
+                        endpointId: "listPlants",
+                        displaySortOrder: 0
+                    }),
+                    restRoute({
+                        fullPath: "api-reference/get-plant",
+                        title: "Get plant",
+                        endpointId: "getPlant",
+                        displaySortOrder: 1
+                    })
+                ]
+            ]
+        ]);
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Plant Docs",
+            segments,
+            navBySegment
+        });
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        // Navigate to the tabbed node
+        expect(root.child.type).toBe("unversioned");
+        const unversioned = root.child;
+        expect(unversioned.child.type).toBe("tabbed");
+        const tabbed = unversioned.child;
+        expect(tabbed.children).toHaveLength(2);
+        // Find the API Reference tab
+        const apiRefTab = tabbed.children.find((t) => t.type === "tab" && t.title === "API Reference");
+        expect(apiRefTab).toBeDefined();
+        // The sidebar root should have children (the apiReference node)
+        const sidebar = apiRefTab.child;
+        expect(sidebar.type).toBe("sidebarRoot");
+        expect(sidebar.children.length).toBeGreaterThan(0);
+        // The first child should be an apiReference node with endpoint children
+        const apiNode = sidebar.children[0];
+        expect(apiNode.type).toBe("apiReference");
+        expect(apiNode.children.length).toBe(2);
+        expect(apiNode.children.map((c) => [c.type, "title" in c ? c.title : ""])).toEqual([
+            ["endpoint", "List plants"],
+            ["endpoint", "Get plant"]
+        ]);
+    });
+    it("skip-slug apiReference endpoints are indexable (appear in sitemap)", () => {
+        const segments = [
+            segment({
+                segmentHash: "api-ref",
+                section: "",
+                sortOrder: 0,
+                metadata: {
+                    type: "apiReference",
+                    title: "Plant API",
+                    apiDefinitionId: "plant-api-def",
+                    pointsTo: "api-reference/list-plants"
+                },
+                tab: apiTab
+            })
+        ];
+        const navBySegment = new Map([
+            [
+                "api-ref",
+                [
+                    restRoute({
+                        fullPath: "api-reference/list-plants",
+                        title: "List plants",
+                        endpointId: "listPlants",
+                        displaySortOrder: 0
+                    }),
+                    restRoute({
+                        fullPath: "api-reference/get-plant",
+                        title: "Get plant",
+                        endpointId: "getPlant",
+                        displaySortOrder: 1
+                    })
+                ]
+            ]
+        ]);
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Plant Docs",
+            segments,
+            navBySegment
+        });
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        const collector = FernNavigation.NodeCollector.collect(root);
+        const indexableSlugs = collector.indexablePageSlugs;
+        expect(indexableSlugs).toContain("api-reference/list-plants");
+        expect(indexableSlugs).toContain("api-reference/get-plant");
+    });
+});
+//# sourceMappingURL=ledger-root-builder.skipSlugApiReference.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-root-builder.skipSlugApiReference.test.js","sourceRoot":"","sources":["../../../src/navigation/__test__/ledger-root-builder.skipSlugApiReference.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,cAAc,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,SAAS,OAAO,CAAC,IAYhB;IACG,OAAO;QACH,SAAS,EAAE,IAAI,CAAC,WAAW;QAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,GAAG,EACC,IAAI,CAAC,GAAG,IAAI,IAAI;YACZ,CAAC,CAAC;gBACI,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE;gBACf,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW;gBACjC,IAAI,EAAE,IAAI;gBACV,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC;gBAClC,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,KAAK;gBACf,YAAY,EAAE,EAAE;gBAChB,QAAQ,EAAE;oBACN,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;oBACnB,QAAQ,EAAE,KAAK;oBACf,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACxE;aACJ;YACH,CAAC,CAAC,IAAI;KACjB,CAAC;AACN,CAAC;AAED,SAAS,SAAS,CAAC,IAMlB;IACG,OAAO;QACH,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,KAAK;QACb,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,QAAQ,EAAE;YACN,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,eAAe,EAAE,eAAe;YAChC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;YAC5B,gBAAgB,EAAE,KAAK;SAC1B;KACJ,CAAC;AACN,CAAC;AAED,SAAS,aAAa,CAAC,IAAmF;IACtG,OAAO;QACH,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,KAAK;QACb,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;KACvD,CAAC;AACN,CAAC;AAED,QAAQ,CAAC,oDAAoD,EAAE,GAAG,EAAE;IAChE,MAAM,SAAS,GAAG;QACd,EAAE,EAAE,YAAY;QAChB,WAAW,EAAE,QAAQ;QACrB,IAAI,EAAE,EAAE;QACR,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,SAAS;KACtB,CAAC;IAEF,MAAM,MAAM,GAAG;QACX,EAAE,EAAE,mBAAmB;QACvB,WAAW,EAAE,eAAe;QAC5B,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,2BAA2B;KACxC,CAAC;IAEF,EAAE,CAAC,4EAA4E,EAAE,GAAG,EAAE;QAClF,MAAM,QAAQ,GAAG;YACb,qBAAqB;YACrB,OAAO,CAAC;gBACJ,WAAW,EAAE,gBAAgB;gBAC7B,OAAO,EAAE,aAAa;gBACtB,SAAS,EAAE,CAAC;gBACZ,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE;gBACxE,GAAG,EAAE,SAAS;aACjB,CAAC;YACF,+DAA+D;YAC/D,OAAO,CAAC;gBACJ,WAAW,EAAE,SAAS;gBACtB,OAAO,EAAE,EAAE;gBACX,SAAS,EAAE,CAAC;gBACZ,QAAQ,EAAE;oBACN,IAAI,EAAE,cAAc;oBACpB,KAAK,EAAE,WAAW;oBAClB,eAAe,EAAE,eAAe;oBAChC,QAAQ,EAAE,2BAA2B;iBACxC;gBACD,GAAG,EAAE,MAAM;aACd,CAAC;SACM,CAAC;QAEb,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;YACzB;gBACI,gBAAgB;gBAChB;oBACI,aAAa,CAAC;wBACV,QAAQ,EAAE,SAAS;wBACnB,KAAK,EAAE,SAAS;wBAChB,MAAM,EAAE,mBAAmB;wBAC3B,gBAAgB,EAAE,CAAC;qBACtB,CAAC;oBACF,aAAa,CAAC;wBACV,QAAQ,EAAE,YAAY;wBACtB,KAAK,EAAE,YAAY;wBACnB,MAAM,EAAE,sBAAsB;wBAC9B,gBAAgB,EAAE,CAAC;qBACtB,CAAC;iBACI;aACb;YACD;gBACI,SAAS;gBACT;oBACI,SAAS,CAAC;wBACN,QAAQ,EAAE,2BAA2B;wBACrC,KAAK,EAAE,aAAa;wBACpB,UAAU,EAAE,YAAY;wBACxB,gBAAgB,EAAE,CAAC;qBACtB,CAAC;oBACF,SAAS,CAAC;wBACN,QAAQ,EAAE,yBAAyB;wBACnC,KAAK,EAAE,WAAW;wBAClB,UAAU,EAAE,UAAU;wBACtB,gBAAgB,EAAE,CAAC;qBACtB,CAAC;iBACI;aACb;SACJ,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,yBAAyB,CAAC;YACnC,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,YAAY;YACnB,QAAQ;YACR,YAAY;SACf,CAAC,CAAC;QAEH,cAAc,CAAC,KAAK,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAEjD,8BAA8B;QAC9B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,KAAuC,CAAC;QACjE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,WAAW,CAAC,KAAkC,CAAC;QAC9D,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAExC,6BAA6B;QAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,KAAK,KAAK,eAAe,CAC/B,CAAC;QAC5B,MAAM,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAEhC,gEAAgE;QAChE,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAEnD,wEAAwE;QACxE,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAoC,CAAC;QACvE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAC/E,CAAC,UAAU,EAAE,aAAa,CAAC;YAC3B,CAAC,UAAU,EAAE,WAAW,CAAC;SAC5B,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC1E,MAAM,QAAQ,GAAG;YACb,OAAO,CAAC;gBACJ,WAAW,EAAE,SAAS;gBACtB,OAAO,EAAE,EAAE;gBACX,SAAS,EAAE,CAAC;gBACZ,QAAQ,EAAE;oBACN,IAAI,EAAE,cAAc;oBACpB,KAAK,EAAE,WAAW;oBAClB,eAAe,EAAE,eAAe;oBAChC,QAAQ,EAAE,2BAA2B;iBACxC;gBACD,GAAG,EAAE,MAAM;aACd,CAAC;SACM,CAAC;QAEb,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;YACzB;gBACI,SAAS;gBACT;oBACI,SAAS,CAAC;wBACN,QAAQ,EAAE,2BAA2B;wBACrC,KAAK,EAAE,aAAa;wBACpB,UAAU,EAAE,YAAY;wBACxB,gBAAgB,EAAE,CAAC;qBACtB,CAAC;oBACF,SAAS,CAAC;wBACN,QAAQ,EAAE,yBAAyB;wBACnC,KAAK,EAAE,WAAW;wBAClB,UAAU,EAAE,UAAU;wBACtB,gBAAgB,EAAE,CAAC;qBACtB,CAAC;iBACI;aACb;SACJ,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,yBAAyB,CAAC;YACnC,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,YAAY;YACnB,QAAQ;YACR,YAAY;SACf,CAAC,CAAC;QAEH,cAAc,CAAC,KAAK,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAEjD,MAAM,SAAS,GAAG,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7D,MAAM,cAAc,GAAG,SAAS,CAAC,kBAAkB,CAAC;QAEpD,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;QAC9D,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/navigation/__test__/ledger-root-builder.skipSlugTabs.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ledger-root-builder.skipSlugTabs.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-root-builder.skipSlugTabs.test.d.ts","sourceRoot":"","sources":["../../../src/navigation/__test__/ledger-root-builder.skipSlugTabs.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,284 @@
+import { describe, expect, it } from "vitest";
+import * as FernNavigation from "../index.js";
+import { buildFullRootFromSegments } from "../ledger-root-builder";
+/**
+ * Segment builder for a versioned site with skip-slug tabs.
+ */
+function makeSegment(opts) {
+    return {
+        segmentId: opts.segmentHash,
+        segmentHash: opts.segmentHash,
+        section: opts.section,
+        locale: "en",
+        sortOrder: opts.sortOrder ?? 0,
+        hidden: opts.hidden ?? false,
+        metadata: {
+            type: opts.metadataType,
+            title: opts.title ?? (opts.section || "Root"),
+            ...(opts.pointsTo != null ? { pointsTo: opts.pointsTo } : {})
+        },
+        product: null,
+        version: opts.version != null
+            ? {
+                id: opts.version.id,
+                displayName: opts.version.displayName,
+                icon: null,
+                sortOrder: opts.version.sortOrder ?? 0,
+                hidden: false,
+                viewers: [],
+                orphaned: false,
+                featureFlags: [],
+                metadata: {
+                    slug: opts.version.slug,
+                    default: opts.version.default
+                }
+            }
+            : null,
+        variant: null,
+        tab: opts.tab != null
+            ? {
+                id: opts.tab.id,
+                displayName: opts.tab.displayName,
+                icon: null,
+                sortOrder: opts.tab.sortOrder ?? 0,
+                hidden: false,
+                viewers: [],
+                orphaned: false,
+                featureFlags: [],
+                metadata: {
+                    slug: opts.tab.slug,
+                    tab_type: "tab",
+                    ...(opts.tab.pointsTo != null ? { pointsTo: opts.tab.pointsTo } : {})
+                }
+            }
+            : null,
+        productId: null,
+        productName: null,
+        productIcon: null,
+        versionId: opts.version?.id ?? null,
+        versionName: opts.version?.displayName ?? null,
+        versionIcon: null,
+        variantId: null,
+        variantName: null,
+        variantIcon: null,
+        tabId: opts.tab?.id ?? null,
+        tabName: opts.tab?.displayName ?? null,
+        tabIcon: null
+    };
+}
+describe("buildFullRootFromSegments — versioned skip-slug tabs", () => {
+    const v2 = {
+        id: "version:v2",
+        displayName: "v2",
+        slug: "",
+        default: true,
+        sortOrder: 0
+    };
+    const v1 = {
+        id: "version:v1",
+        displayName: "v1",
+        slug: "v1",
+        default: false,
+        sortOrder: 1
+    };
+    // In production, skip-slug tabs inherit the version slug ("v-2")
+    // rather than being empty. This matches the actual S3 manifest data.
+    const docsTab = {
+        id: "tab:docs",
+        displayName: "Docs",
+        slug: "v-2",
+        sortOrder: 0,
+        pointsTo: "introduction"
+    };
+    const guidesTab = {
+        id: "tab:guides",
+        displayName: "Guides",
+        slug: "v-2",
+        sortOrder: 1,
+        pointsTo: "watering"
+    };
+    const segments = [
+        // v2 / Docs tab / tabRoot
+        makeSegment({
+            segmentHash: "v2-docs-tabroot",
+            section: "",
+            metadataType: "tabRoot",
+            version: v2,
+            tab: docsTab,
+            sortOrder: 0
+        }),
+        // v2 / Docs tab / Documentation section
+        makeSegment({
+            segmentHash: "v2-docs-section",
+            section: "documentation",
+            metadataType: "section",
+            title: "Documentation",
+            version: v2,
+            tab: docsTab,
+            sortOrder: 1,
+            pointsTo: "introduction"
+        }),
+        // v2 / Guides tab / tabRoot
+        makeSegment({
+            segmentHash: "v2-guides-tabroot",
+            section: "",
+            metadataType: "tabRoot",
+            version: v2,
+            tab: guidesTab,
+            sortOrder: 2
+        }),
+        // v2 / Guides tab / Plant Guides section
+        makeSegment({
+            segmentHash: "v2-guides-section",
+            section: "plant-guides",
+            metadataType: "section",
+            title: "Plant Guides",
+            version: v2,
+            tab: guidesTab,
+            sortOrder: 3,
+            pointsTo: "watering"
+        }),
+        // v1 / Docs tab / tabRoot
+        makeSegment({
+            segmentHash: "v1-docs-tabroot",
+            section: "",
+            metadataType: "tabRoot",
+            version: v1,
+            tab: { ...docsTab, slug: "v1", pointsTo: "v1/introduction" },
+            sortOrder: 4
+        }),
+        // v1 / Docs tab / Documentation section
+        makeSegment({
+            segmentHash: "v1-docs-section",
+            section: "documentation",
+            metadataType: "section",
+            title: "Documentation",
+            version: v1,
+            tab: { ...docsTab, slug: "v1", pointsTo: "v1/introduction" },
+            sortOrder: 5,
+            pointsTo: "v1/introduction"
+        })
+    ];
+    const navBySegment = new Map([
+        [
+            "v2-docs-section",
+            [
+                {
+                    fullPath: "introduction",
+                    type: "markdown",
+                    displaySortOrder: 0,
+                    hidden: false,
+                    metadata: { title: "Introduction", pageId: "pages/introduction.mdx", slug: "introduction" },
+                    artifactId: "art-intro"
+                },
+                {
+                    fullPath: "getting-started",
+                    type: "markdown",
+                    displaySortOrder: 1,
+                    hidden: false,
+                    metadata: {
+                        title: "Getting Started",
+                        pageId: "pages/getting-started.mdx",
+                        slug: "getting-started"
+                    },
+                    artifactId: "art-getting-started"
+                }
+            ]
+        ],
+        [
+            "v2-guides-section",
+            [
+                {
+                    fullPath: "watering",
+                    type: "markdown",
+                    displaySortOrder: 0,
+                    hidden: false,
+                    metadata: { title: "Watering Guide", pageId: "pages/watering.mdx", slug: "watering" },
+                    artifactId: "art-watering"
+                },
+                {
+                    fullPath: "sunlight",
+                    type: "markdown",
+                    displaySortOrder: 1,
+                    hidden: false,
+                    metadata: { title: "Sunlight Guide", pageId: "pages/sunlight.mdx", slug: "sunlight" },
+                    artifactId: "art-sunlight"
+                }
+            ]
+        ],
+        [
+            "v1-docs-section",
+            [
+                {
+                    fullPath: "v1/introduction",
+                    type: "markdown",
+                    displaySortOrder: 0,
+                    hidden: false,
+                    metadata: { title: "Introduction", pageId: "pages/introduction.mdx", slug: "introduction" },
+                    artifactId: "art-v1-intro"
+                }
+            ]
+        ]
+    ]);
+    it("should produce 2 tabs for v2 (default version) when both have skip-slug", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Skip-Slug Tabs Test",
+            segments,
+            navBySegment
+        });
+        // Root → versioned → v2 version node → tabbed → children
+        expect(root.child.type).toBe("versioned");
+        const versioned = root.child;
+        const v2Node = versioned.children.find((v) => v.default);
+        expect(v2Node).toBeDefined();
+        expect(v2Node.child.type).toBe("tabbed");
+        const tabbed = v2Node.child;
+        console.log("Tab children:", tabbed.children.map((t) => ({
+            type: t.type,
+            title: "title" in t ? t.title : "N/A",
+            slug: "slug" in t ? t.slug : "N/A",
+            id: t.id
+        })));
+        expect(tabbed.children.length).toBeGreaterThanOrEqual(2);
+    });
+    it("should produce correct tab pointsTo for skip-slug tabs", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Skip-Slug Tabs Test",
+            segments,
+            navBySegment
+        });
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        const versioned = root.child;
+        const v2Node = versioned.children.find((v) => v.default);
+        const tabbed = v2Node.child;
+        for (const tab of tabbed.children) {
+            if (tab.type === "tab") {
+                console.log(`Tab "${tab.title}": slug="${tab.slug}" pointsTo="${tab.pointsTo}"`);
+                expect(tab.pointsTo).toBeDefined();
+                expect(tab.pointsTo).not.toBe("/");
+            }
+        }
+    });
+    it("findNode should return all tabs for a page slug", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Skip-Slug Tabs Test",
+            segments,
+            navBySegment
+        });
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        const found = FernNavigation.utils.findNode(root, FernNavigation.Slug("introduction"));
+        expect(found.type).toBe("found");
+        if (found.type === "found") {
+            console.log("Tabs from findNode:", found.tabs.map((t) => ({
+                type: t.type,
+                title: "title" in t ? t.title : "N/A",
+                slug: "slug" in t ? t.slug : "N/A"
+            })));
+            expect(found.tabs.length).toBeGreaterThanOrEqual(2);
+        }
+    });
+});
+//# sourceMappingURL=ledger-root-builder.skipSlugTabs.test.js.map

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

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

package/dist/navigation/__test__/ledger-root-builder.tabSlug.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ledger-root-builder.tabSlug.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-root-builder.tabSlug.test.d.ts","sourceRoot":"","sources":["../../../src/navigation/__test__/ledger-root-builder.tabSlug.test.ts"],"names":[],"mappings":""}