@fern-api/fdr-sdk 1.1.24-e30ed51fda → 1.1.24-e3bdb9c0a9

package/dist/navigation/NodeCollector.d.ts

@@ -0,0 +1,51 @@
+import { FernNavigation } from "./..";
+import { type NavigationNodeWithMetadata } from "./versions";
+interface NavigationNodeWithMetadataAndParents {
+    node: FernNavigation.NavigationNodeWithMetadata;
+    parents: readonly FernNavigation.NavigationNodeParent[];
+    next: FernNavigation.NavigationNodeNeighbor | undefined;
+    prev: FernNavigation.NavigationNodeNeighbor | undefined;
+}
+export declare class NodeCollector {
+    #private;
+    private static readonly EMPTY;
+    private nodesInOrder;
+    private idToNode;
+    private idToNodeParents;
+    private slugToNode;
+    private orphanedNodes;
+    static collect(rootNode: FernNavigation.NavigationNode | undefined): NodeCollector;
+    private versionNodes;
+    private defaultVersion;
+    private productNodes;
+    private defaultProduct;
+    private variantNodes;
+    private defaultVariant;
+    constructor(rootNode: FernNavigation.NavigationNode | undefined);
+    private visitNode;
+    getOrphanedNodes(): FernNavigation.NavigationNodeWithMetadata[];
+    getOrphanedPages: () => FernNavigation.NavigationNodeWithMetadata[];
+    private getSlugMap;
+    get slugMap(): Map<string, FernNavigation.NavigationNodeWithMetadata>;
+    get defaultVersionNode(): FernNavigation.VersionNode | undefined;
+    get defaultProductNode(): FernNavigation.ProductNode | undefined;
+    get defaultVariantNode(): FernNavigation.VariantNode | undefined;
+    get(id: FernNavigation.NodeId): FernNavigation.NavigationNode | undefined;
+    getParents(id: FernNavigation.NodeId): readonly FernNavigation.NavigationNodeParent[];
+    getSlugMapWithParents: () => ReadonlyMap<FernNavigation.Slug, NavigationNodeWithMetadataAndParents>;
+    get slugs(): string[];
+    get staticPageSlugs(): string[];
+    get revalidationPageSlugs(): {
+        authedSlugs: string[];
+        unauthedSlugs: string[];
+        authedRoles: string[];
+    };
+    get indexablePageSlugs(): string[];
+    get indexablePageNodesWithAuth(): NavigationNodeWithMetadata[];
+    getProductNodes: () => FernNavigation.ProductNode[];
+    getVersionNodes: () => FernNavigation.VersionNode[];
+    getVariantNodes: () => FernNavigation.VariantNode[];
+    getNodesInOrder: () => FernNavigation.NavigationNode[];
+}
+export {};
+//# sourceMappingURL=NodeCollector.d.ts.map

package/dist/navigation/NodeCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeCollector.d.ts","sourceRoot":"","sources":["../../src/navigation/NodeCollector.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAEtC,OAAO,EAAiB,KAAK,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAE5E,UAAU,oCAAoC;IAC1C,IAAI,EAAE,cAAc,CAAC,0BAA0B,CAAC;IAChD,OAAO,EAAE,SAAS,cAAc,CAAC,oBAAoB,EAAE,CAAC;IACxD,IAAI,EAAE,cAAc,CAAC,sBAAsB,GAAG,SAAS,CAAC;IACxD,IAAI,EAAE,cAAc,CAAC,sBAAsB,GAAG,SAAS,CAAC;CAC3D;AAID,qBAAa,aAAa;;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAgC;IAC7D,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,QAAQ,CAAmE;IACnF,OAAO,CAAC,eAAe,CAAoF;IAC3G,OAAO,CAAC,UAAU,CAAwE;IAC1F,OAAO,CAAC,aAAa,CAAmD;WAE1D,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,cAAc,GAAG,SAAS,GAAG,aAAa;IAqCzF,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,cAAc,CAAyC;IAE/D,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,cAAc,CAAyC;IAE/D,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,cAAc,CAAyC;gBAEnD,QAAQ,EAAE,cAAc,CAAC,cAAc,GAAG,SAAS;IAmC/D,OAAO,CAAC,SAAS;IAoCV,gBAAgB,IAAI,cAAc,CAAC,0BAA0B,EAAE;IAI/D,gBAAgB,QAAY,cAAc,CAAC,0BAA0B,EAAE,CAE3E;IAEH,OAAO,CAAC,UAAU,CAEf;IAEH,IAAI,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,0BAA0B,CAAC,CAEpE;IAED,IAAI,kBAAkB,IAAI,cAAc,CAAC,WAAW,GAAG,SAAS,CAE/D;IAED,IAAI,kBAAkB,IAAI,cAAc,CAAC,WAAW,GAAG,SAAS,CAE/D;IAED,IAAI,kBAAkB,IAAI,cAAc,CAAC,WAAW,GAAG,SAAS,CAE/D;IAEM,GAAG,CAAC,EAAE,EAAE,cAAc,CAAC,MAAM,GAAG,cAAc,CAAC,cAAc,GAAG,SAAS;IAIzE,UAAU,CAAC,EAAE,EAAE,cAAc,CAAC,MAAM,GAAG,SAAS,cAAc,CAAC,oBAAoB,EAAE;IAIrF,qBAAqB,QAAO,WAAW,CAAC,cAAc,CAAC,IAAI,EAAE,oCAAoC,CAAC,CAEvG;IAKF,IAAI,KAAK,IAAI,MAAM,EAAE,CAEpB;IAmBD,IAAI,eAAe,IAAI,MAAM,EAAE,CAE9B;IAoCD,IAAI,qBAAqB,IAAI;QAAE,WAAW,EAAE,MAAM,EAAE,CAAC;QAAC,aAAa,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAA;KAAE,CAErG;IAmBD,IAAI,kBAAkB,IAAI,MAAM,EAAE,CAEjC;IAmBD,IAAI,0BAA0B,IAAI,0BAA0B,EAAE,CAE7D;IAEM,eAAe,QAAO,cAAc,CAAC,WAAW,EAAE,CAEvD;IAEK,eAAe,QAAO,cAAc,CAAC,WAAW,EAAE,CAEvD;IAEK,eAAe,QAAO,cAAc,CAAC,WAAW,EAAE,CAEvD;IAEK,eAAe,QAAO,cAAc,CAAC,cAAc,EAAE,CAE1D;CACL"}

package/dist/navigation/NodeCollector.js

@@ -0,0 +1,242 @@
+import { EMPTY_ARRAY } from "@fern-api/ui-core-utils";
+import { once } from "es-toolkit/function";
+import { FernNavigation } from "./..";
+import { pruneVersionNode } from "./utils/pruneVersionNode";
+import { isProductNode } from "./versions";
+const NodeCollectorInstances = new WeakMap();
+export class NodeCollector {
+    static EMPTY = new NodeCollector(undefined);
+    nodesInOrder = [];
+    idToNode = new Map();
+    idToNodeParents = new Map();
+    slugToNode = new Map();
+    orphanedNodes = [];
+    static collect(rootNode) {
+        if (rootNode == null) {
+            return NodeCollector.EMPTY;
+        }
+        const existing = NodeCollectorInstances.get(rootNode);
+        if (existing != null) {
+            return existing;
+        }
+        const instance = new NodeCollector(rootNode);
+        NodeCollectorInstances.set(rootNode, instance);
+        return instance;
+    }
+    #last;
+    #lastNeighboringNode;
+    #setNode(slug, node, parents) {
+        const toSet = {
+            node,
+            parents,
+            prev: this.#lastNeighboringNode,
+            next: undefined
+        };
+        this.slugToNode.set(slug, toSet);
+        if (FernNavigation.isNeighbor(node)) {
+            this.#lastNeighboringNode = node;
+            if (this.#last != null) {
+                this.#last.next = node;
+            }
+            this.#last = toSet;
+        }
+    }
+    versionNodes = [];
+    defaultVersion;
+    productNodes = [];
+    defaultProduct;
+    variantNodes = [];
+    defaultVariant;
+    constructor(rootNode) {
+        if (rootNode == null) {
+            return;
+        }
+        FernNavigation.traverseDF(rootNode, (node, parents) => {
+            if (node.type === "product") {
+                this.productNodes.push(node);
+            }
+            // if the node is the default version, make a copy of it and "prune" the version slug from all children nodes
+            if (node.type === "version") {
+                this.versionNodes.push(node);
+            }
+            // collect variant nodes
+            if (node.type === "variant") {
+                this.variantNodes.push(node);
+            }
+            if (node.type === "version" && node.default && rootNode.type === "root") {
+                // if the node is the default version OF a product, we want to prune using the product slug, not the root slug.
+                const productNode = parents.find(isProductNode);
+                const copy = JSON.parse(JSON.stringify(node));
+                // External product nodes (productLink) don't have slugs, so we use the root slug in that case
+                const pruneSlug = productNode?.type === "product" ? productNode.slug : rootNode.slug;
+                this.defaultVersion = pruneVersionNode(copy, pruneSlug, node.slug);
+                FernNavigation.traverseDF(this.defaultVersion, (node, innerParents) => {
+                    this.visitNode(node, [...parents, ...innerParents], true);
+                });
+            }
+            this.visitNode(node, parents);
+        });
+    }
+    visitNode(node, parents, isDefaultVersion = false) {
+        if (!this.idToNode.has(node.id) || isDefaultVersion) {
+            this.idToNode.set(node.id, node);
+            this.idToNodeParents.set(node.id, parents);
+            this.nodesInOrder.push(node);
+        }
+        if (node.type === "sidebarRoot") {
+            this.#last = undefined;
+            this.#lastNeighboringNode = undefined;
+        }
+        // there's currently no visitable page for changelog months and years
+        if (!FernNavigation.hasMetadata(node) || node.type === "changelogMonth" || node.type === "changelogYear") {
+            return;
+        }
+        const existing = this.slugToNode.get(node.slug);
+        if (existing == null) {
+            this.#setNode(node.slug, node, parents);
+        }
+        else if (!node.hidden &&
+            FernNavigation.isPage(node) &&
+            (existing.node.hidden || !FernNavigation.isPage(existing.node))) {
+            this.orphanedNodes.push(existing.node);
+            this.#setNode(node.slug, node, parents);
+        }
+        else {
+            this.orphanedNodes.push(node);
+        }
+    }
+    getOrphanedNodes() {
+        return this.orphanedNodes;
+    }
+    getOrphanedPages = once(() => {
+        return this.orphanedNodes.filter(FernNavigation.isPage);
+    });
+    getSlugMap = once(() => {
+        return new Map([...this.slugToNode.entries()].map(([slug, { node }]) => [slug, node]));
+    });
+    get slugMap() {
+        return this.getSlugMap();
+    }
+    get defaultVersionNode() {
+        return this.defaultVersion;
+    }
+    get defaultProductNode() {
+        return this.defaultProduct;
+    }
+    get defaultVariantNode() {
+        return this.defaultVariant;
+    }
+    get(id) {
+        return this.idToNode.get(id);
+    }
+    getParents(id) {
+        return this.idToNodeParents.get(id) ?? EMPTY_ARRAY;
+    }
+    getSlugMapWithParents = () => {
+        return this.slugToNode;
+    };
+    #getSlugs = once(() => {
+        return [...this.slugToNode.keys()];
+    });
+    get slugs() {
+        return this.#getSlugs();
+    }
+    /**
+     * Returns a list of slugs for all pages in the navigation tree.
+     *
+     * This includes hidden pages and noindex pages, but not authed pages, and is intended for revalidation purposes.
+     *
+     * @returns {string[]} A list of slugs for all canonical pages in the navigation tree.
+     */
+    #getStaticPageSlugs = once(() => {
+        return Array.from(new Set([...this.slugToNode.values()]
+            .filter(({ node }) => FernNavigation.isPage(node))
+            .filter(({ node }) => !node.authed)
+            .map(({ node }) => node.slug)));
+    });
+    get staticPageSlugs() {
+        return this.#getStaticPageSlugs();
+    }
+    /**
+     * Returns all page slugs grouped by auth requirement for revalidation.
+     * Each page is categorized as either requiring auth or not based on the node's authed property.
+     * Also collects unique roles from the `viewers` field of authed nodes.
+     */
+    #getRevalidationPageSlugs = once(() => {
+        const authedSlugs = [];
+        const unauthedSlugs = [];
+        const rolesSet = new Set();
+        const seenSlugs = new Set();
+        for (const { node } of this.slugToNode.values()) {
+            if (!FernNavigation.isPage(node)) {
+                continue;
+            }
+            if (seenSlugs.has(node.slug)) {
+                continue;
+            }
+            seenSlugs.add(node.slug);
+            if (node.authed) {
+                authedSlugs.push(node.slug);
+                if (node.viewers != null) {
+                    for (const role of node.viewers) {
+                        rolesSet.add(role);
+                    }
+                }
+            }
+            else {
+                unauthedSlugs.push(node.slug);
+            }
+        }
+        return { authedSlugs, unauthedSlugs, authedRoles: Array.from(rolesSet) };
+    });
+    get revalidationPageSlugs() {
+        return this.#getRevalidationPageSlugs();
+    }
+    /**
+     * Returns a list of slugs for pages that should be indexed by search engines, and by algolia.
+     *
+     * This excludes hidden pages and noindex pages, and uses the canonical slug if it exists.
+     */
+    #getIndexablePageSlugs = once(() => {
+        return Array.from(new Set([...this.slugToNode.values()]
+            .filter(({ node }) => FernNavigation.isPage(node))
+            .filter(({ node }) => !node.hidden && !node.authed)
+            .filter(({ node }) => node.type !== "changelogEntry")
+            .filter(({ node }) => (FernNavigation.hasMarkdown(node) ? !node.noindex : true))
+            .map(({ node }) => node.canonicalSlug ?? node.slug)));
+    });
+    get indexablePageSlugs() {
+        return this.#getIndexablePageSlugs();
+    }
+    #getIndexablePageNodesWithAuth = once(() => {
+        const slugRecord = {};
+        [...this.slugToNode.values()]
+            .filter(({ node }) => FernNavigation.isPage(node))
+            .filter(({ node }) => !node.hidden)
+            .filter(({ node }) => (FernNavigation.hasMarkdown(node) ? !node.noindex : true))
+            .forEach((node) => {
+            const canonicalSlug = node.node.canonicalSlug ?? node.node.slug;
+            // Only keep the first node we see for each canonical slug
+            if (!(canonicalSlug in slugRecord)) {
+                slugRecord[canonicalSlug] = node.node;
+            }
+        });
+        return Object.values(slugRecord);
+    });
+    get indexablePageNodesWithAuth() {
+        return this.#getIndexablePageNodesWithAuth();
+    }
+    getProductNodes = () => {
+        return this.productNodes;
+    };
+    getVersionNodes = () => {
+        return this.versionNodes;
+    };
+    getVariantNodes = () => {
+        return this.variantNodes;
+    };
+    getNodesInOrder = () => {
+        return this.nodesInOrder;
+    };
+}
+//# sourceMappingURL=NodeCollector.js.map

package/dist/navigation/NodeCollector.js.map

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

package/dist/navigation/__test__/NodeCollector.revalidationPageSlugs.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=NodeCollector.revalidationPageSlugs.test.d.ts.map

package/dist/navigation/__test__/NodeCollector.revalidationPageSlugs.test.d.ts.map

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

package/dist/navigation/__test__/NodeCollector.revalidationPageSlugs.test.js

@@ -0,0 +1,154 @@
+import { FernNavigation } from "../..";
+import { NodeCollector } from "../NodeCollector";
+function makePage(opts) {
+    return {
+        type: "page",
+        id: FernNavigation.NodeId(opts.id),
+        collapsed: undefined,
+        slug: FernNavigation.Slug(opts.slug),
+        title: opts.id,
+        pageId: FernNavigation.PageId(`${opts.id}.mdx`),
+        canonicalSlug: undefined,
+        icon: undefined,
+        hidden: undefined,
+        authed: opts.authed ?? undefined,
+        noindex: undefined,
+        viewers: opts.viewers,
+        orphaned: undefined,
+        featureFlags: undefined,
+        availability: undefined
+    };
+}
+function makeRoot(opts) {
+    return {
+        type: "root",
+        version: "v2",
+        id: FernNavigation.NodeId("root"),
+        collapsed: undefined,
+        slug: FernNavigation.Slug(""),
+        title: "Root",
+        roles: opts.roles,
+        canonicalSlug: undefined,
+        icon: undefined,
+        hidden: undefined,
+        authed: undefined,
+        pointsTo: undefined,
+        viewers: undefined,
+        orphaned: undefined,
+        featureFlags: undefined,
+        child: {
+            type: "unversioned",
+            id: FernNavigation.NodeId("unversioned"),
+            collapsed: undefined,
+            landingPage: undefined,
+            child: {
+                type: "sidebarRoot",
+                id: FernNavigation.NodeId("sidebar"),
+                collapsed: undefined,
+                children: [
+                    {
+                        type: "sidebarGroup",
+                        id: FernNavigation.NodeId("group"),
+                        collapsed: undefined,
+                        children: opts.pages
+                    }
+                ]
+            }
+        }
+    };
+}
+describe("NodeCollector.revalidationPageSlugs", () => {
+    it("should categorize unauthed pages correctly", () => {
+        const root = makeRoot({
+            pages: [
+                makePage({ id: "public-page", slug: "public" }),
+                makePage({ id: "another-public", slug: "another" })
+            ]
+        });
+        const collector = NodeCollector.collect(root);
+        const { authedSlugs, unauthedSlugs, authedRoles } = collector.revalidationPageSlugs;
+        expect(unauthedSlugs).toEqual(expect.arrayContaining(["public", "another"]));
+        expect(authedSlugs).toHaveLength(0);
+        expect(authedRoles).toHaveLength(0);
+    });
+    it("should categorize authed pages with no roles (viewers undefined)", () => {
+        const root = makeRoot({
+            pages: [
+                makePage({ id: "public-page", slug: "public" }),
+                makePage({ id: "authed-page", slug: "authed", authed: true })
+            ]
+        });
+        const collector = NodeCollector.collect(root);
+        const { authedSlugs, unauthedSlugs, authedRoles } = collector.revalidationPageSlugs;
+        expect(unauthedSlugs).toEqual(["public"]);
+        expect(authedSlugs).toEqual(["authed"]);
+        expect(authedRoles).toHaveLength(0);
+    });
+    it("should collect roles from authed pages with viewers defined", () => {
+        const root = makeRoot({
+            pages: [
+                makePage({ id: "public-page", slug: "public" }),
+                makePage({ id: "admin-page", slug: "admin-only", authed: true, viewers: ["admin"] }),
+                makePage({ id: "dev-page", slug: "dev-only", authed: true, viewers: ["developer"] })
+            ]
+        });
+        const collector = NodeCollector.collect(root);
+        const { authedSlugs, unauthedSlugs, authedRoles } = collector.revalidationPageSlugs;
+        expect(unauthedSlugs).toEqual(["public"]);
+        expect(authedSlugs).toEqual(expect.arrayContaining(["admin-only", "dev-only"]));
+        expect(authedSlugs).toHaveLength(2);
+        expect(authedRoles).toEqual(expect.arrayContaining(["admin", "developer"]));
+        expect(authedRoles).toHaveLength(2);
+    });
+    it("should deduplicate roles across multiple pages", () => {
+        const root = makeRoot({
+            pages: [
+                makePage({ id: "page-a", slug: "a", authed: true, viewers: ["admin", "developer"] }),
+                makePage({ id: "page-b", slug: "b", authed: true, viewers: ["admin", "support"] })
+            ]
+        });
+        const collector = NodeCollector.collect(root);
+        const { authedRoles } = collector.revalidationPageSlugs;
+        expect(authedRoles).toEqual(expect.arrayContaining(["admin", "developer", "support"]));
+        expect(authedRoles).toHaveLength(3);
+    });
+    it("should handle mix of unauthed, authed without roles, and authed with roles", () => {
+        const root = makeRoot({
+            pages: [
+                makePage({ id: "public", slug: "public" }),
+                makePage({ id: "login-only", slug: "login-only", authed: true }),
+                makePage({ id: "admin-page", slug: "admin", authed: true, viewers: ["admin"] }),
+                makePage({
+                    id: "multi-role",
+                    slug: "multi",
+                    authed: true,
+                    viewers: ["admin", "developer"]
+                })
+            ]
+        });
+        const collector = NodeCollector.collect(root);
+        const { authedSlugs, unauthedSlugs, authedRoles } = collector.revalidationPageSlugs;
+        expect(unauthedSlugs).toEqual(["public"]);
+        expect(authedSlugs).toEqual(expect.arrayContaining(["login-only", "admin", "multi"]));
+        expect(authedSlugs).toHaveLength(3);
+        expect(authedRoles).toEqual(expect.arrayContaining(["admin", "developer"]));
+        expect(authedRoles).toHaveLength(2);
+    });
+    it("should handle empty navigation tree", () => {
+        const collector = NodeCollector.collect(undefined);
+        const { authedSlugs, unauthedSlugs, authedRoles } = collector.revalidationPageSlugs;
+        expect(unauthedSlugs).toHaveLength(0);
+        expect(authedSlugs).toHaveLength(0);
+        expect(authedRoles).toHaveLength(0);
+    });
+    it("should handle authed pages with empty viewers array", () => {
+        const root = makeRoot({
+            pages: [makePage({ id: "empty-viewers", slug: "empty", authed: true, viewers: [] })]
+        });
+        const collector = NodeCollector.collect(root);
+        const { authedSlugs, authedRoles } = collector.revalidationPageSlugs;
+        expect(authedSlugs).toEqual(["empty"]);
+        expect(authedRoles).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=NodeCollector.revalidationPageSlugs.test.js.map

package/dist/navigation/__test__/NodeCollector.revalidationPageSlugs.test.js.map

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

package/dist/navigation/consts.d.ts

@@ -0,0 +1,2 @@
+export declare const ROOT_PACKAGE_ID: "__package__";
+//# sourceMappingURL=consts.d.ts.map

package/dist/navigation/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../src/navigation/consts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,EAAG,aAAsB,CAAC"}

package/dist/navigation/consts.js

@@ -0,0 +1,2 @@
+export const ROOT_PACKAGE_ID = "__package__";
+//# sourceMappingURL=consts.js.map

package/dist/navigation/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../src/navigation/consts.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,aAAsB,CAAC"}

package/dist/navigation/index.d.ts

@@ -0,0 +1,13 @@
+import { ApiDefinitionHolder } from "./ApiDefinitionHolder";
+import { ApiDefinitionPruner } from "./ApiDefinitionPruner";
+import { ApiTypeIdVisitor } from "./ApiTypeIdVisitor";
+import { NodeCollector } from "./NodeCollector";
+export * from "../orpc-client/api/shared.js";
+export * from "../orpc-client/shared.js";
+export * from "./ApiDefinitionHolder";
+export * as migrate from "./migrators";
+export * as utils from "./utils";
+export * from "./utils/pruneNavigationTree";
+export * from "./versions";
+export { ApiDefinitionHolder, ApiDefinitionPruner, ApiTypeIdVisitor, NodeCollector };
+//# sourceMappingURL=index.d.ts.map

package/dist/navigation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,aAAa,CAAC;AACvC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC"}

package/dist/navigation/index.js

@@ -0,0 +1,13 @@
+import { ApiDefinitionHolder } from "./ApiDefinitionHolder";
+import { ApiDefinitionPruner } from "./ApiDefinitionPruner";
+import { ApiTypeIdVisitor } from "./ApiTypeIdVisitor";
+import { NodeCollector } from "./NodeCollector";
+export * from "../orpc-client/api/shared.js";
+export * from "../orpc-client/shared.js";
+export * from "./ApiDefinitionHolder";
+export * as migrate from "./migrators";
+export * as utils from "./utils";
+export * from "./utils/pruneNavigationTree";
+export * from "./versions";
+export { ApiDefinitionHolder, ApiDefinitionPruner, ApiTypeIdVisitor, NodeCollector };
+//# sourceMappingURL=index.js.map

package/dist/navigation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,aAAa,CAAC;AACvC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC"}

package/dist/navigation/migrators/__test__/collapsed.test.d.ts

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

package/dist/navigation/migrators/__test__/collapsed.test.d.ts.map

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

package/dist/navigation/migrators/__test__/collapsed.test.js

@@ -0,0 +1,100 @@
+import { describe, expect, it } from "vitest";
+import { FernNavigation } from "../../..";
+import { FernNavigationV1ToLatest } from "../v1ToV2";
+describe("FernNavigationV1ToLatest collapsed", () => {
+    it("preserves collapsed values (including open-by-default)", () => {
+        const v1 = {
+            type: "root",
+            version: "v1",
+            id: FernNavigation.V1.NodeId("root"),
+            collapsed: undefined,
+            title: "Root",
+            slug: FernNavigation.V1.Slug(""),
+            icon: undefined,
+            hidden: undefined,
+            authed: undefined,
+            viewers: undefined,
+            orphaned: undefined,
+            featureFlags: undefined,
+            pointsTo: undefined,
+            roles: undefined,
+            child: {
+                type: "unversioned",
+                id: FernNavigation.V1.NodeId("unversioned"),
+                collapsed: undefined,
+                landingPage: undefined,
+                child: {
+                    type: "sidebarRoot",
+                    id: FernNavigation.V1.NodeId("sidebar"),
+                    collapsed: undefined,
+                    children: [
+                        {
+                            type: "section",
+                            id: FernNavigation.V1.NodeId("section"),
+                            collapsed: "open-by-default",
+                            title: "Section",
+                            slug: FernNavigation.V1.Slug("section"),
+                            icon: undefined,
+                            hidden: undefined,
+                            authed: undefined,
+                            viewers: undefined,
+                            orphaned: undefined,
+                            featureFlags: undefined,
+                            overviewPageId: undefined,
+                            noindex: undefined,
+                            pointsTo: undefined,
+                            collapsible: undefined,
+                            collapsedByDefault: undefined,
+                            availability: undefined,
+                            children: [
+                                {
+                                    type: "page",
+                                    id: FernNavigation.V1.NodeId("page"),
+                                    collapsed: false,
+                                    title: "Page",
+                                    slug: FernNavigation.V1.Slug("section/page"),
+                                    icon: undefined,
+                                    hidden: undefined,
+                                    authed: undefined,
+                                    viewers: undefined,
+                                    orphaned: undefined,
+                                    featureFlags: undefined,
+                                    pageId: FernNavigation.PageId("page.mdx"),
+                                    noindex: undefined,
+                                    availability: undefined
+                                }
+                            ]
+                        }
+                    ]
+                }
+            }
+        };
+        const latest = FernNavigationV1ToLatest.create().root(v1);
+        expect(Object.hasOwn(latest, "collapsed")).toBe(true);
+        const unversioned = latest.child;
+        if (unversioned.type !== "unversioned") {
+            throw new Error("Expected unversioned");
+        }
+        expect(Object.hasOwn(unversioned, "collapsed")).toBe(true);
+        const sidebarRoot = unversioned.child;
+        if (sidebarRoot.type !== "sidebarRoot") {
+            throw new Error("Expected sidebarRoot");
+        }
+        expect(Object.hasOwn(sidebarRoot, "collapsed")).toBe(true);
+        const section = sidebarRoot.children[0];
+        expect(section).toBeDefined();
+        if (section == null || section.type !== "section") {
+            throw new Error("Expected section");
+        }
+        expect(Object.hasOwn(section, "collapsed")).toBe(true);
+        expect(section.collapsed).toBe("open-by-default");
+        const page = section.children[0];
+        expect(page).toBeDefined();
+        if (page == null || page.type !== "page") {
+            throw new Error("Expected page");
+        }
+        expect(Object.hasOwn(page, "collapsed")).toBe(true);
+        expect(page.collapsed).toBe(false);
+    });
+});
+//# sourceMappingURL=collapsed.test.js.map