npm - @fern-api/fdr-sdk - Versions diffs - 1.2.45-932269c163 → 1.2.45-9cc0fe9249 - Mend

@fern-api/fdr-sdk 1.2.45-932269c163 → 1.2.45-9cc0fe9249

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (18) hide show

package/dist/navigation/__test__/ledger-root-builder.landingPageRedirect.test.d.ts ADDED Viewed

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

package/dist/navigation/__test__/ledger-root-builder.landingPageRedirect.test.d.ts.map ADDED Viewed

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

package/dist/navigation/__test__/ledger-root-builder.landingPageRedirect.test.js ADDED Viewed

@@ -0,0 +1,227 @@
+import { describe, expect, it } from "vitest";
+import * as FernNavigation from "../index.js";
+import { buildFullRootFromSegments } from "../ledger-root-builder";
+/**
+ * Regression test: unversioned sites with tabs + landing page.
+ *
+ * The V1 (legacy) path computes root.pointsTo via followRedirect(child), which
+ * visits unversioned.landingPage before unversioned.child (V1 followRedirect.ts:38):
+ *
+ *   unversioned: (node) => followRedirect(node.landingPage ?? node.child)
+ *
+ * The V2 (latest) followRedirect does the same via getChildren, which returns
+ * [landingPage, child] for unversioned nodes (getChildren.ts:38-39).
+ *
+ * The ledger builder (buildFullRootFromSegments) bypasses both V1 and the
+ * V1→V2 migrator: it builds V2 nodes directly. Before the fix, it seeded
+ * root.pointsTo from the first tab's metadata.pointsTo — ignoring the landing
+ * page entirely. Then mutableUpdatePointsTo preserved this incorrect value
+ * because the target slug existed in the tree.
+ *
+ * This test reproduces the exact topology of the reported site: an unversioned
+ * site with two tabs and a landing page at /welcome. It exercises:
+ *
+ *   1. The seed value from buildFullRootFromSegments
+ *   2. mutableUpdatePointsTo preserving the seed
+ *   3. findNode("") returning a redirect to the landing page
+ */
+function tabSegment(opts) {
+    return {
+        segmentId: opts.segmentHash,
+        segmentHash: opts.segmentHash,
+        section: opts.section,
+        locale: "en",
+        sortOrder: opts.sortOrder ?? 0,
+        hidden: false,
+        metadata: { type: "section", title: opts.section || "Root" },
+        product: null,
+        version: null,
+        variant: null,
+        tab: {
+            id: `tab:${opts.tabSlug}`,
+            displayName: opts.tabSlug,
+            icon: null,
+            sortOrder: opts.sortOrder ?? 0,
+            hidden: false,
+            viewers: [],
+            orphaned: false,
+            featureFlags: [],
+            metadata: {
+                slug: opts.tabSlug,
+                tab_type: "tab",
+                ...(opts.tabPointsTo != null ? { pointsTo: opts.tabPointsTo } : {})
+            }
+        }
+    };
+}
+function markdownRoute(fullPath, title, pageId) {
+    return {
+        type: "markdown",
+        fullPath,
+        hidden: false,
+        displaySortOrder: 0,
+        metadata: { title, pageId }
+    };
+}
+/**
+ * Builds a root node mimicking the reported site: unversioned, two tabs
+ * ("docs" → /docs/start/about, "api-ref" → /api-ref/functions), plus a
+ * landing page at /welcome.
+ */
+function buildTabbedSiteWithLandingPage() {
+    return buildFullRootFromSegments({
+        basePath: "",
+        title: "Tabbed Site With Landing Page",
+        segments: [
+            {
+                segmentId: "seg-landing",
+                segmentHash: "seg-landing",
+                section: "",
+                locale: "en",
+                sortOrder: 0,
+                hidden: false,
+                metadata: { type: "tabRoot", landingPage: true },
+                product: null,
+                version: null,
+                variant: null,
+                tab: null
+            },
+            tabSegment({
+                segmentHash: "seg-tab-docs",
+                section: "start",
+                tabSlug: "docs",
+                tabPointsTo: "docs/start/about",
+                sortOrder: 1
+            }),
+            tabSegment({
+                segmentHash: "seg-tab-api",
+                section: "functions",
+                tabSlug: "api-ref",
+                tabPointsTo: "api-ref/functions",
+                sortOrder: 2
+            })
+        ],
+        navBySegment: new Map([
+            ["seg-landing", [markdownRoute("welcome", "Welcome", "welcome-page")]],
+            ["seg-tab-docs", [markdownRoute("docs/start/about", "About", "about-page")]],
+            ["seg-tab-api", [markdownRoute("api-ref/functions", "Functions", "functions-page")]]
+        ])
+    });
+}
+describe("ledger landing-page redirect regression (ledger vs. legacy parity)", () => {
+    it("seeds root.pointsTo to the landing page, not the first tab", () => {
+        const root = buildTabbedSiteWithLandingPage();
+        expect(root.child.type).toBe("unversioned");
+        if (root.child.type !== "unversioned") {
+            throw new Error("expected unversioned");
+        }
+        expect(root.child.landingPage).toBeDefined();
+        expect(root.child.landingPage?.slug).toBe("welcome");
+        // The ledger builder should seed root.pointsTo to the landing page —
+        // matching the V1 legacy behavior (V1 followRedirect visits
+        // node.landingPage before node.child).
+        expect(root.pointsTo).toBe("welcome");
+        // Regression guard: the OLD (broken) seed was the first tab's pointsTo.
+        expect(root.pointsTo).not.toBe("docs/start/about");
+    });
+    it("mutableUpdatePointsTo preserves the landing page as root.pointsTo", () => {
+        const root = buildTabbedSiteWithLandingPage();
+        // Before update: seed is correct.
+        expect(root.pointsTo).toBe("welcome");
+        // After update: root.pointsTo should remain "welcome" because the
+        // landing page node is present in the slug map.
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        expect(root.pointsTo).toBe("welcome");
+    });
+    it("findNode('') returns redirect to landing page, not first tab page", () => {
+        const root = buildTabbedSiteWithLandingPage();
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        const result = FernNavigation.utils.findNode(root, FernNavigation.Slug(""));
+        // The root URL should redirect to the landing page.
+        expect(result.type).toBe("redirect");
+        if (result.type === "redirect") {
+            expect(result.redirect).toBe("welcome");
+        }
+    });
+    it("findNode('welcome') resolves the landing page as a found node", () => {
+        const root = buildTabbedSiteWithLandingPage();
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        const result = FernNavigation.utils.findNode(root, FernNavigation.Slug("welcome"));
+        expect(result.type).toBe("found");
+        if (result.type === "found") {
+            expect(result.node.type).toBe("landingPage");
+            expect(result.node.slug).toBe("welcome");
+        }
+    });
+    it("findNode still resolves tab pages normally", () => {
+        const root = buildTabbedSiteWithLandingPage();
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        const docs = FernNavigation.utils.findNode(root, FernNavigation.Slug("docs/start/about"));
+        expect(docs.type).toBe("found");
+        if (docs.type === "found") {
+            expect(docs.node.slug).toBe("docs/start/about");
+        }
+        const api = FernNavigation.utils.findNode(root, FernNavigation.Slug("api-ref/functions"));
+        expect(api.type).toBe("found");
+        if (api.type === "found") {
+            expect(api.node.slug).toBe("api-ref/functions");
+        }
+    });
+    it("without a landing page, root falls back to first tab's pointsTo", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Tabbed Site Without Landing Page",
+            segments: [
+                tabSegment({
+                    segmentHash: "seg-tab-docs",
+                    section: "start",
+                    tabSlug: "docs",
+                    tabPointsTo: "docs/start/about",
+                    sortOrder: 0
+                }),
+                tabSegment({
+                    segmentHash: "seg-tab-api",
+                    section: "functions",
+                    tabSlug: "api-ref",
+                    tabPointsTo: "api-ref/functions",
+                    sortOrder: 1
+                })
+            ],
+            navBySegment: new Map([
+                ["seg-tab-docs", [markdownRoute("docs/start/about", "About", "about-page")]],
+                ["seg-tab-api", [markdownRoute("api-ref/functions", "Functions", "functions-page")]]
+            ])
+        });
+        // No landing page → falls back to first tab's metadata.pointsTo.
+        expect(root.pointsTo).toBe("docs/start/about");
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        expect(root.pointsTo).toBe("docs/start/about");
+        const result = FernNavigation.utils.findNode(root, FernNavigation.Slug(""));
+        expect(result.type).toBe("redirect");
+        if (result.type === "redirect") {
+            expect(result.redirect).toBe("docs/start/about");
+        }
+    });
+    it("demonstrates the pre-fix bug: manually seeding root.pointsTo to a tab page bypasses the landing page", () => {
+        // This test proves the regression existed. If root.pointsTo is
+        // incorrectly seeded (as the old code did), the landing page is
+        // unreachable from the root URL.
+        const root = buildTabbedSiteWithLandingPage();
+        // Simulate the OLD (broken) ledger behavior: seed root.pointsTo from
+        // the first tab's metadata instead of the landing page.
+        root.pointsTo = FernNavigation.Slug("docs/start/about");
+        // mutableUpdatePointsTo preserves the broken seed because the slug
+        // exists in the tree — it never re-derives from followRedirect.
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        expect(root.pointsTo).toBe("docs/start/about");
+        // findNode("") follows the broken redirect → wrong page.
+        const result = FernNavigation.utils.findNode(root, FernNavigation.Slug(""));
+        expect(result.type).toBe("redirect");
+        if (result.type === "redirect") {
+            expect(result.redirect).toBe("docs/start/about");
+            // This is the bug: the user expected "welcome" but got a tab page.
+            expect(result.redirect).not.toBe("welcome");
+        }
+    });
+});
+//# sourceMappingURL=ledger-root-builder.landingPageRedirect.test.js.map

package/dist/navigation/__test__/ledger-root-builder.landingPageRedirect.test.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/navigation/__test__/ledger-root-builder.unversionedPointsTo.test.js CHANGED Viewed

@@ -92,7 +92,65 @@ describe("buildFullRootFromSegments — unversioned root.pointsTo", () => {
         });
         expect(root.pointsTo).toBe("visible/intro");
     });
-    it("seeds root.pointsTo from the first tab's metadata (unversioned with tabs)", () => {
+    it("seeds root.pointsTo from landing page slug when tabbed site has a landing page", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Tabbed Site With Landing",
+            segments: [
+                // Landing page segment (type: tabRoot with landingPage: true)
+                {
+                    segmentId: "seg-landing",
+                    segmentHash: "seg-landing",
+                    section: "",
+                    locale: "en",
+                    sortOrder: 0,
+                    hidden: false,
+                    metadata: { type: "tabRoot", landingPage: true },
+                    product: null,
+                    version: null,
+                    variant: null,
+                    tab: null
+                },
+                tabSegment({
+                    segmentHash: "seg-tab1",
+                    section: "start",
+                    tabSlug: "docs",
+                    tabPointsTo: "docs/start/about",
+                    sortOrder: 1
+                }),
+                tabSegment({
+                    segmentHash: "seg-tab2",
+                    section: "functions",
+                    tabSlug: "api-ref",
+                    tabPointsTo: "api-ref/functions",
+                    sortOrder: 2
+                })
+            ],
+            navBySegment: new Map([
+                [
+                    "seg-landing",
+                    [
+                        {
+                            type: "markdown",
+                            fullPath: "welcome",
+                            hidden: false,
+                            displaySortOrder: 0,
+                            metadata: { title: "Welcome", pageId: "welcome-page" }
+                        }
+                    ]
+                ]
+            ])
+        });
+        expect(root.child.type).toBe("unversioned");
+        if (root.child.type !== "unversioned") {
+            throw new Error("expected unversioned root child");
+        }
+        expect(root.child.landingPage).toBeDefined();
+        expect(root.child.landingPage?.slug).toBe("welcome");
+        // Root should redirect to the landing page, not the first tab
+        expect(root.pointsTo).toBe("welcome");
+    });
+    it("falls back to first tab's metadata when no landing page exists (unversioned with tabs)", () => {
         const root = buildFullRootFromSegments({
             basePath: "",
             title: "Tabbed Site",

package/dist/navigation/__test__/ledger-root-builder.unversionedPointsTo.test.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"ledger-root-builder.unversionedPointsTo.test.js","sourceRoot":"","sources":["../../../src/navigation/__test__/ledger-root-builder.unversionedPointsTo.test.ts"],"names":[],"mappings":"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~~2EAA2E~~,EAAE,GAAG,EAAE;~~QACjF~~,MAAM,IAAI,GAAG,yBAAyB,CAAC;YACnC,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,aAAa;YACpB,QAAQ,EAAE;gBACN,UAAU,CAAC;oBACP,WAAW,EAAE,UAAU;oBACvB,OAAO,EAAE,QAAQ;oBACjB,OAAO,EAAE,QAAQ;oBACjB,WAAW,EAAE,wBAAwB;oBACrC,SAAS,EAAE,CAAC;iBACf,CAAC;gBACF,UAAU,CAAC;oBACP,WAAW,EAAE,UAAU;oBACvB,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,SAAS;oBAClB,WAAW,EAAE,mBAAmB;oBAChC,SAAS,EAAE,CAAC;iBACf,CAAC;aACI;YACV,YAAY,EAAE,IAAI,GAAG,EAAE;SAC1B,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QACxE,MAAM,IAAI,GAAG,yBAAyB,CAAC;YACnC,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,YAAY;YACnB,QAAQ,EAAE;gBACN,cAAc,CAAC;oBACX,WAAW,EAAE,OAAO;oBACpB,OAAO,EAAE,MAAM;oBACf,cAAc;iBACjB,CAAC;aACI;YACV,YAAY,EAAE,IAAI,GAAG,EAAE;SAC1B,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,aAAa,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QACxD,MAAM,IAAI,GAAG,yBAAyB,CAAC;YACnC,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,eAAe;YACtB,QAAQ,EAAE;gBACN,cAAc,CAAC;oBACX,WAAW,EAAE,OAAO;oBACpB,OAAO,EAAE,MAAM;oBACf,QAAQ,EAAE,uBAAuB;iBACpC,CAAC;aACI;YACV,YAAY,EAAE,IAAI,GAAG,EAAE;SAC1B,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}
1	+ {"version":3,"file":"ledger-root-builder.unversionedPointsTo.test.js","sourceRoot":"","sources":["../../../src/navigation/__test__/ledger-root-builder.unversionedPointsTo.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAEnE;;GAEG;AACH,SAAS,cAAc,CAAC,IAMvB;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,IAAI,CAAC;QAC9B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;QAC5B,QAAQ,EAAE;YACN,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,IAAI,CAAC,OAAO,IAAI,MAAM;YAC7B,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChE;QACD,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,IAAI;KACZ,CAAC;AACN,CAAC;AAED,SAAS,UAAU,CAAC,IAMnB;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,IAAI,CAAC;QAC9B,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,IAAI,MAAM,EAAE;QAC5D,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,GAAG,EAAE;YACD,EAAE,EAAE,OAAO,IAAI,CAAC,OAAO,EAAE;YACzB,WAAW,EAAE,IAAI,CAAC,OAAO;YACzB,IAAI,EAAE,IAAI;YACV,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC;YAC9B,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,EAAE;YAChB,QAAQ,EAAE;gBACN,IAAI,EAAE,IAAI,CAAC,OAAO;gBAClB,QAAQ,EAAE,KAAK;gBACf,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtE;SACJ;KACJ,CAAC;AACN,CAAC;AAED,QAAQ,CAAC,uDAAuD,EAAE,GAAG,EAAE;IACnE,EAAE,CAAC,8EAA8E,EAAE,GAAG,EAAE;QACpF,MAAM,IAAI,GAAG,yBAAyB,CAAC;YACnC,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,cAAc;YACrB,QAAQ,EAAE;gBACN,cAAc,CAAC;oBACX,WAAW,EAAE,OAAO;oBACpB,OAAO,EAAE,MAAM;oBACf,QAAQ,EAAE,gBAAgB;iBAC7B,CAAC;aACI;YACV,YAAY,EAAE,IAAI,GAAG,EAAE;SAC1B,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACjF,MAAM,IAAI,GAAG,yBAAyB,CAAC;YACnC,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,eAAe;YACtB,QAAQ,EAAE;gBACN,cAAc,CAAC;oBACX,WAAW,EAAE,YAAY;oBACzB,OAAO,EAAE,QAAQ;oBACjB,QAAQ,EAAE,aAAa;oBACvB,SAAS,EAAE,CAAC;oBACZ,MAAM,EAAE,IAAI;iBACf,CAAC;gBACF,cAAc,CAAC;oBACX,WAAW,EAAE,aAAa;oBAC1B,OAAO,EAAE,SAAS;oBAClB,QAAQ,EAAE,eAAe;oBACzB,SAAS,EAAE,CAAC;oBACZ,MAAM,EAAE,KAAK;iBAChB,CAAC;aACI;YACV,YAAY,EAAE,IAAI,GAAG,EAAE;SAC1B,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gFAAgF,EAAE,GAAG,EAAE;QACtF,MAAM,IAAI,GAAG,yBAAyB,CAAC;YACnC,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,0BAA0B;YACjC,QAAQ,EAAE;gBACN,8DAA8D;gBAC9D;oBACI,SAAS,EAAE,aAAa;oBACxB,WAAW,EAAE,aAAa;oBAC1B,OAAO,EAAE,EAAE;oBACX,MAAM,EAAE,IAAI;oBACZ,SAAS,EAAE,CAAC;oBACZ,MAAM,EAAE,KAAK;oBACb,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE;oBAChD,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,IAAI;oBACb,GAAG,EAAE,IAAI;iBACZ;gBACD,UAAU,CAAC;oBACP,WAAW,EAAE,UAAU;oBACvB,OAAO,EAAE,OAAO;oBAChB,OAAO,EAAE,MAAM;oBACf,WAAW,EAAE,kBAAkB;oBAC/B,SAAS,EAAE,CAAC;iBACf,CAAC;gBACF,UAAU,CAAC;oBACP,WAAW,EAAE,UAAU;oBACvB,OAAO,EAAE,WAAW;oBACpB,OAAO,EAAE,SAAS;oBAClB,WAAW,EAAE,mBAAmB;oBAChC,SAAS,EAAE,CAAC;iBACf,CAAC;aACI;YACV,YAAY,EAAE,IAAI,GAAG,CAAC;gBAClB;oBACI,aAAa;oBACb;wBACI;4BACI,IAAI,EAAE,UAAU;4BAChB,QAAQ,EAAE,SAAS;4BACnB,MAAM,EAAE,KAAK;4BACb,gBAAgB,EAAE,CAAC;4BACnB,QAAQ,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE;yBACzD;qBACK;iBACb;aACJ,CAAC;SACL,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,8DAA8D;QAC9D,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wFAAwF,EAAE,GAAG,EAAE;QAC9F,MAAM,IAAI,GAAG,yBAAyB,CAAC;YACnC,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,aAAa;YACpB,QAAQ,EAAE;gBACN,UAAU,CAAC;oBACP,WAAW,EAAE,UAAU;oBACvB,OAAO,EAAE,QAAQ;oBACjB,OAAO,EAAE,QAAQ;oBACjB,WAAW,EAAE,wBAAwB;oBACrC,SAAS,EAAE,CAAC;iBACf,CAAC;gBACF,UAAU,CAAC;oBACP,WAAW,EAAE,UAAU;oBACvB,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,SAAS;oBAClB,WAAW,EAAE,mBAAmB;oBAChC,SAAS,EAAE,CAAC;iBACf,CAAC;aACI;YACV,YAAY,EAAE,IAAI,GAAG,EAAE;SAC1B,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QACxE,MAAM,IAAI,GAAG,yBAAyB,CAAC;YACnC,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,YAAY;YACnB,QAAQ,EAAE;gBACN,cAAc,CAAC;oBACX,WAAW,EAAE,OAAO;oBACpB,OAAO,EAAE,MAAM;oBACf,cAAc;iBACjB,CAAC;aACI;YACV,YAAY,EAAE,IAAI,GAAG,EAAE;SAC1B,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,aAAa,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QACxD,MAAM,IAAI,GAAG,yBAAyB,CAAC;YACnC,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,eAAe;YACtB,QAAQ,EAAE;gBACN,cAAc,CAAC;oBACX,WAAW,EAAE,OAAO;oBACpB,OAAO,EAAE,MAAM;oBACf,QAAQ,EAAE,uBAAuB;iBACpC,CAAC;aACI;YACV,YAAY,EAAE,IAAI,GAAG,EAAE;SAC1B,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

	@@ -1 +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;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;~~AAibD~~;;;;;;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;AAyzBD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,CAAC,QAAQ,~~CAmF5F~~"}
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;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;AAqbD;;;;;;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;AAyzBD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,CAAC,QAAQ,CA0F5F"}

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

@@ -623,7 +623,10 @@ function mergeChildrenByPosition(ctx, nav, sectionChildren) {
 function sectionNode(ctx, scoped, sectionChildren, scopePrefix) {
     const { seg, nav } = scoped;
     const overview = overviewRoute(nav) ?? overviewRouteFromSegmentMeta(seg, nav);
-    const overviewPageId = overview != null ? metaStr(overview.metadata, "pageId") : undefined;
+    // Only set overviewPageId from explicit segment metadata, matching v2
+    // where overviewPageId comes directly from the config. The isOverview
+    // flag discovered by overviewRoute() is still used for slug/noindex.
+    const overviewPageId = metaStr(seg.metadata, "overviewPageId");
     // Strip the leading scope prefix to prevent double-prefixing when the
     // section path already includes the scope (e.g. section="2026-02-09"
     // with scopePrefix="2026-02-09" would produce "2026-02-09/2026-02-09").
@@ -647,7 +650,6 @@ function sectionNode(ctx, scoped, sectionChildren, scopePrefix) {
             }
         }
     }
-    const metaPointsTo = metaStr(seg.metadata, "pointsTo");
     const defaults = withMetadataDefaults({
         id: ctx.nodeId(`section:${slug}`),
         title: metaStr(seg.metadata, "title") ?? "",
@@ -668,7 +670,10 @@ function sectionNode(ctx, scoped, sectionChildren, scopePrefix) {
         collapsible: metaBool(seg.metadata, "collapsible") ?? (metaCollapsed(seg.metadata) === true ? true : undefined),
         collapsedByDefault: metaBool(seg.metadata, "collapsedByDefault") ?? (metaCollapsed(seg.metadata) === true ? true : undefined),
         availability: metaAvailability(seg.metadata),
-        pointsTo: metaPointsTo != null ? pointsToSlug(metaPointsTo) : undefined,
+        // Don't read pointsTo from metadata for sections; let
+        // mutableUpdatePointsTo compute it via followRedirect so that
+        // self-referencing redirects are cleared, matching v2 behavior.
+        pointsTo: undefined,
         children: mergeChildrenByPosition(ctx, nav, sectionChildren)
     };
 }
@@ -1616,17 +1621,26 @@ export function buildFullRootFromSegments(options) {
     // on structure-only roots where the traversal is intentionally skipped.
     let rootPointsTo;
     if (child.type === "productgroup") {
-        const defaultProduct = child.children.find((p) => p.default) ?? child.children[0];
-        rootPointsTo = defaultProduct?.type === "product" ? defaultProduct.pointsTo : undefined;
+        if (child.landingPage != null && !child.landingPage.hidden) {
+            rootPointsTo = child.landingPage.slug;
+        }
+        else {
+            const defaultProduct = child.children.find((p) => p.default) ?? child.children[0];
+            rootPointsTo = defaultProduct?.type === "product" ? defaultProduct.pointsTo : undefined;
+        }
     }
     else if (child.type === "versioned") {
         const defaultVersion = child.children.find((v) => v.default) ?? child.children[0];
         rootPointsTo = defaultVersion?.pointsTo;
     }
     else if (child.type === "unversioned") {
-        // Unversioned sites have no product/version metadata to seed pointsTo.
-        // Derive from the first tab's or first section segment's metadata.
-        if (tabs.length > 0) {
+        // Landing pages take priority: when the unversioned child has a
+        // visible landing page the root should redirect there, not to the
+        // first tab's content page.
+        if (child.landingPage != null && !child.landingPage.hidden) {
+            rootPointsTo = child.landingPage.slug;
+        }
+        else if (tabs.length > 0) {
             const firstTab = tabs[0];
             const pt = firstTab != null ? metaStr(firstTab.metadata, "pointsTo") : undefined;
             rootPointsTo = pt != null ? pointsToSlug(pt) : undefined;