@fern-api/fdr-sdk 1.2.40-5c4b71a67c → 1.2.40-777f8723e0

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

@@ -0,0 +1,439 @@
+import { describe, expect, it } from "vitest";
+import * as FernNavigation from "../index.js";
+import { buildFullRootFromSegments } from "../ledger-root-builder.js";
+/**
+ * Tests for variant slug handling and root section slug inference.
+ *
+ * 1. **Default variant slug non-elision** (the main parity fix):
+ *    V2 never elides variant slugs — even default variants keep their slug
+ *    segment in the URL. The ledger was incorrectly using `detailIsDefault`
+ *    to collapse default variant slugs to the bare scope prefix, causing
+ *    breadcrumb divergence (e.g. `/tab-variants` instead of
+ *    `/tab-variants/overview` for a default "Overview" variant).
+ *
+ * 2. **Root section slug inference** (supplementary):
+ *    When a section has `seg.section === ""` and no overview page,
+ *    `sectionNode` infers the section slug from child page fullPaths.
+ */
+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: opts.isDefault ?? false, pointsTo: opts.pointsTo, tab_type: opts.tabType }
+    };
+}
+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 } : {}) },
+        product: opts.product ?? null,
+        version: opts.version ?? null,
+        variant: opts.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 slugMap(root) {
+    return new Set(FernNavigation.NodeCollector.collect(root).slugMap.keys());
+}
+/** Find all section nodes in the tree. */
+function findSectionNodes(root) {
+    const sections = [];
+    FernNavigation.traverseDF(root, (node) => {
+        if (node.type === "section") {
+            sections.push(node);
+        }
+    });
+    return sections;
+}
+describe("buildFullRootFromSegments — root section slug inference (overview-section parity)", () => {
+    it("creates a section node with inferred slug for a root section (section='', type='section')", () => {
+        // Reproduces the tab-variants/overview case: a variant root section
+        // with section="" whose pages live under …/overview/…
+        const product = detail({
+            id: "p-second",
+            name: "Second Product",
+            slug: "second-product",
+            pointsTo: "second-product/tab-variants/overview/introduction"
+        });
+        const tab = detail({
+            id: "t-tab-variants",
+            name: "Tab Variants",
+            slug: "tab-variants",
+            pointsTo: "second-product/tab-variants/overview/introduction"
+        });
+        const variant = detail({
+            id: "v-overview",
+            name: "Overview",
+            slug: "overview",
+            isDefault: true
+        });
+        const root = buildRoot({
+            basePath: "",
+            segments: [
+                // Root section (variant root): section="" but type="section"
+                seg({
+                    segmentHash: "s-root-section",
+                    section: "",
+                    type: "section",
+                    title: "Overview",
+                    product,
+                    tab,
+                    variant
+                }),
+                // Child section within the variant
+                seg({
+                    segmentHash: "s-resources",
+                    section: "resources",
+                    type: "section",
+                    title: "Resources",
+                    sortOrder: 1,
+                    product,
+                    tab,
+                    variant
+                })
+            ],
+            navBySegment: new Map([
+                [
+                    "s-root-section",
+                    [markdownRoute("second-product/tab-variants/overview/introduction", "Introduction", "pg-intro")]
+                ],
+                [
+                    "s-resources",
+                    [markdownRoute("second-product/tab-variants/overview/resources/setup", "Setup", "pg-setup")]
+                ]
+            ])
+        });
+        const sections = findSectionNodes(root);
+        // Should have 2 sections: root section "Overview" and child "Resources"
+        expect(sections.length).toBe(2);
+        const overviewSection = sections.find((s) => s.title === "Overview");
+        expect(overviewSection).toBeDefined();
+        // The inferred slug should include the "overview" segment from the page fullPaths
+        expect(overviewSection?.slug).toBe("second-product/tab-variants/overview");
+        const resourcesSection = sections.find((s) => s.title === "Resources");
+        expect(resourcesSection).toBeDefined();
+        // The page should be reachable via the slug map
+        const slugs = slugMap(root);
+        expect(slugs.has("second-product/tab-variants/overview")).toBe(true);
+        expect(slugs.has("second-product/tab-variants/overview/introduction")).toBe(true);
+    });
+    it("adopts depth-0 child sections into the root section, preventing duplication", () => {
+        const product = detail({
+            id: "p-prod",
+            name: "Product",
+            slug: "product",
+            pointsTo: "product/tab/overview/intro"
+        });
+        const tab = detail({
+            id: "t-tab",
+            name: "Tab",
+            slug: "tab",
+            pointsTo: "product/tab/overview/intro"
+        });
+        const variant = detail({
+            id: "v-ov",
+            name: "Overview",
+            slug: "overview",
+            isDefault: true
+        });
+        const root = buildRoot({
+            basePath: "",
+            segments: [
+                seg({
+                    segmentHash: "s-root",
+                    section: "",
+                    type: "section",
+                    title: "Overview",
+                    product,
+                    tab,
+                    variant
+                }),
+                seg({
+                    segmentHash: "s-gs",
+                    section: "get-started",
+                    type: "section",
+                    title: "Get Started",
+                    sortOrder: 1,
+                    product,
+                    tab,
+                    variant
+                }),
+                seg({
+                    segmentHash: "s-adv",
+                    section: "advanced",
+                    type: "section",
+                    title: "Advanced",
+                    sortOrder: 2,
+                    product,
+                    tab,
+                    variant
+                })
+            ],
+            navBySegment: new Map([
+                ["s-root", [markdownRoute("product/tab/overview/intro", "Intro", "pg-intro")]],
+                ["s-gs", [markdownRoute("product/tab/overview/get-started/setup", "Setup", "pg-setup")]],
+                ["s-adv", [markdownRoute("product/tab/overview/advanced/tips", "Tips", "pg-tips")]]
+            ])
+        });
+        const sections = findSectionNodes(root);
+        // "Overview" is the root section; "Get Started" and "Advanced" are its
+        // children, NOT duplicate root-level siblings.
+        const overviewSection = sections.find((s) => s.title === "Overview");
+        expect(overviewSection).toBeDefined();
+        expect(overviewSection?.slug).toBe("product/tab/overview");
+        // Child sections should be nested under Overview
+        const childTitles = (overviewSection?.children ?? [])
+            .filter((c) => c.type === "section")
+            .map((c) => c.title);
+        expect(childTitles).toContain("Get Started");
+        expect(childTitles).toContain("Advanced");
+        // Count total section nodes — should be 3 (Overview + Get Started + Advanced), not 5 (duplicated)
+        expect(sections.length).toBe(3);
+    });
+    it("falls back to scope prefix when nav routes have no section-level path segment", () => {
+        // Pages directly under the scope prefix (no intermediate section slug)
+        const root = buildRoot({
+            basePath: "",
+            segments: [
+                seg({
+                    segmentHash: "s-root",
+                    section: "",
+                    type: "section",
+                    title: "Root"
+                })
+            ],
+            navBySegment: new Map([
+                // Page fullPath has only one segment past scope (no section slug)
+                ["s-root", [markdownRoute("intro", "Intro", "pg-intro")]]
+            ])
+        });
+        const sections = findSectionNodes(root);
+        expect(sections.length).toBe(1);
+        // Falls back to scope prefix since no section slug is inferable
+        expect(sections[0]?.slug).toBe("");
+    });
+    it("uses overviewPageId from segment metadata when isOverview flag is missing", () => {
+        const product = detail({
+            id: "p-prod",
+            name: "Product",
+            slug: "product",
+            pointsTo: "product/overview"
+        });
+        const root = buildRoot({
+            basePath: "",
+            segments: [
+                {
+                    segmentId: "s-section",
+                    segmentHash: "s-section",
+                    section: "guides",
+                    locale: "en",
+                    sortOrder: 0,
+                    hidden: false,
+                    // overviewPageId set on segment metadata, but the page itself
+                    // doesn't have isOverview flag
+                    metadata: { type: "section", title: "Guides", overviewPageId: "pg-overview" },
+                    product,
+                    version: null,
+                    variant: null,
+                    tab: null
+                }
+            ],
+            navBySegment: new Map([
+                [
+                    "s-section",
+                    [
+                        // The overview page — has pageId but NOT isOverview
+                        {
+                            type: "markdown",
+                            fullPath: "product/guides",
+                            hidden: false,
+                            metadata: { title: "Guides Overview", pageId: "pg-overview" }
+                        },
+                        markdownRoute("product/guides/quickstart", "Quickstart", "pg-qs")
+                    ]
+                ]
+            ])
+        });
+        const sections = findSectionNodes(root);
+        expect(sections.length).toBe(1);
+        // Should use the overview page's fullPath to derive the slug
+        expect(sections[0]?.slug).toBe("product/guides");
+        expect(sections[0]?.overviewPageId).toBe("pg-overview");
+    });
+});
+// ── Default variant slug non-elision ─────────────────────────────────────────
+/** Find all variant nodes in the tree. */
+function findVariantNodes(root) {
+    const variants = [];
+    FernNavigation.traverseDF(root, (node) => {
+        if (node.type === "variant") {
+            variants.push(node);
+        }
+    });
+    return variants;
+}
+describe("buildFullRootFromSegments — default variant slug is NOT elided (v2 parity)", () => {
+    it("default variant includes its slug segment in the URL, matching v2", () => {
+        // Reproduces the exact smoke-test case: tab-variants tab with two
+        // variants: "Overview" (default) and "Other Links" (non-default).
+        // V2 gives both variants their full slug; the ledger was eliding
+        // the default variant's slug to the bare tab prefix.
+        const product = detail({
+            id: "p-second",
+            name: "Second Product",
+            slug: "second-product",
+            pointsTo: "second-product/tab-variants/overview/introduction"
+        });
+        const tab = detail({
+            id: "t-tab-variants",
+            name: "Tab Variants",
+            slug: "tab-variants",
+            pointsTo: "second-product/tab-variants/overview/introduction"
+        });
+        const overviewVariant = detail({
+            id: "v-overview",
+            name: "Overview",
+            slug: "overview",
+            isDefault: true
+        });
+        const otherLinksVariant = detail({
+            id: "v-other-links",
+            name: "Other Links",
+            slug: "other-links",
+            isDefault: false
+        });
+        const root = buildRoot({
+            basePath: "",
+            segments: [
+                // Overview variant's tabRoot segment
+                seg({
+                    segmentHash: "s-overview-tabroot",
+                    section: "",
+                    type: "tabRoot",
+                    product,
+                    tab,
+                    variant: overviewVariant
+                }),
+                // Other Links variant's tabRoot segment
+                seg({
+                    segmentHash: "s-otherlinks-tabroot",
+                    section: "",
+                    type: "tabRoot",
+                    product,
+                    tab,
+                    variant: otherLinksVariant
+                })
+            ],
+            navBySegment: new Map([
+                [
+                    "s-overview-tabroot",
+                    [
+                        markdownRoute("second-product/tab-variants/overview/introduction", "Introduction", "pg-overview-intro")
+                    ]
+                ],
+                [
+                    "s-otherlinks-tabroot",
+                    [
+                        markdownRoute("second-product/tab-variants/other-links/introduction", "Introduction", "pg-otherlinks-intro")
+                    ]
+                ]
+            ])
+        });
+        const variants = findVariantNodes(root);
+        expect(variants.length).toBe(2);
+        const overviewNode = variants.find((v) => v.title === "Overview");
+        const otherLinksNode = variants.find((v) => v.title === "Other Links");
+        expect(overviewNode).toBeDefined();
+        expect(otherLinksNode).toBeDefined();
+        // KEY ASSERTION: default variant slug is NOT elided — includes "overview"
+        expect(String(overviewNode?.slug)).toBe("second-product/tab-variants/overview");
+        // Non-default variant slug always includes its segment
+        expect(String(otherLinksNode?.slug)).toBe("second-product/tab-variants/other-links");
+        // Both pages should be reachable
+        const slugs = slugMap(root);
+        expect(slugs.has("second-product/tab-variants/overview/introduction")).toBe(true);
+        expect(slugs.has("second-product/tab-variants/other-links/introduction")).toBe(true);
+    });
+    it("variant breadcrumb has correct pathname for default variant", () => {
+        // Simplified case: single product, single tab, two variants.
+        // The breadcrumb ancestor for a page inside the default variant should
+        // include the variant slug segment.
+        const product = detail({
+            id: "p1",
+            name: "Product",
+            slug: "product",
+            pointsTo: "product/docs/overview/intro"
+        });
+        const tab = detail({
+            id: "t1",
+            name: "Docs",
+            slug: "docs",
+            pointsTo: "product/docs/overview/intro"
+        });
+        const defaultVariant = detail({
+            id: "v-default",
+            name: "Overview",
+            slug: "overview",
+            isDefault: true
+        });
+        const otherVariant = detail({
+            id: "v-other",
+            name: "Advanced",
+            slug: "advanced",
+            isDefault: false
+        });
+        const root = buildRoot({
+            basePath: "",
+            segments: [
+                seg({
+                    segmentHash: "s-default",
+                    section: "",
+                    type: "tabRoot",
+                    product,
+                    tab,
+                    variant: defaultVariant
+                }),
+                seg({
+                    segmentHash: "s-other",
+                    section: "",
+                    type: "tabRoot",
+                    product,
+                    tab,
+                    variant: otherVariant
+                })
+            ],
+            navBySegment: new Map([
+                ["s-default", [markdownRoute("product/docs/overview/intro", "Intro", "pg-intro")]],
+                ["s-other", [markdownRoute("product/docs/advanced/tips", "Tips", "pg-tips")]]
+            ])
+        });
+        const variants = findVariantNodes(root);
+        const defaultNode = variants.find((v) => v.title === "Overview");
+        expect(defaultNode).toBeDefined();
+        // Slug must include "overview", not collapse to "product/docs"
+        expect(String(defaultNode?.slug)).toBe("product/docs/overview");
+    });
+});
+//# sourceMappingURL=ledger-root-builder.rootSectionSlug.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,47 @@
+import { describe, expect, it } from "vitest";
+import { buildFullRootFromSegments } from "../ledger-root-builder.js";
+function segment(opts) {
+    return {
+        segmentId: opts.segmentHash,
+        segmentHash: opts.segmentHash,
+        section: "",
+        locale: "en",
+        sortOrder: 0,
+        hidden: false,
+        metadata: opts.metadata,
+        product: null,
+        version: null,
+        variant: null,
+        tab: null
+    };
+}
+describe("buildFullRootFromSegments — root slug", () => {
+    it("uses the persisted V1 root slug separately from the deployment basepath", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "developers/docs",
+            rootSlug: "",
+            title: "Docs",
+            segments: [segment({ segmentHash: "seg-root", metadata: { type: "tabRoot" } })],
+            navBySegment: new Map([
+                [
+                    "seg-root",
+                    [
+                        {
+                            type: "markdown",
+                            fullPath: "intro",
+                            hidden: false,
+                            displaySortOrder: 0,
+                            metadata: { title: "Intro", pageId: "intro-page" }
+                        }
+                    ]
+                ]
+            ])
+        });
+        expect(root.slug).toBe("");
+        const sidebarRoot = root.child.type === "unversioned" ? root.child.child : undefined;
+        expect(sidebarRoot?.type).toBe("sidebarRoot");
+        const [group] = sidebarRoot.children;
+        expect(group?.children?.[0]?.slug).toBe("developers/docs/intro");
+    });
+});
+//# sourceMappingURL=ledger-root-builder.rootSlug.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-root-builder.rootSlug.test.js","sourceRoot":"","sources":["../../../src/navigation/__test__/ledger-root-builder.rootSlug.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,SAAS,OAAO,CAAC,IAAgE;IAC7E,OAAO;QACH,SAAS,EAAE,IAAI,CAAC,WAAW;QAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,CAAC;QACZ,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,IAAI;KACZ,CAAC;AACN,CAAC;AAED,QAAQ,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QAC/E,MAAM,IAAI,GAAG,yBAAyB,CAAC;YACnC,QAAQ,EAAE,iBAAiB;YAC3B,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAU;YACxF,YAAY,EAAE,IAAI,GAAG,CAAC;gBAClB;oBACI,UAAU;oBACV;wBACI;4BACI,IAAI,EAAE,UAAU;4BAChB,QAAQ,EAAE,OAAO;4BACjB,MAAM,EAAE,KAAK;4BACb,gBAAgB,EAAE,CAAC;4BACnB,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE;yBACrD;qBACK;iBACb;aACJ,CAAC;SACL,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAE3B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QACrF,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,GAAI,WAA2E,CAAC,QAAQ,CAAC;QACtG,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

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

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

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