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

package/dist/navigation/utils/findNode.js

@@ -0,0 +1,208 @@
+import { escapeRegExp } from "es-toolkit/string";
+import { FernNavigation } from "../..";
+import { NodeCollector } from "../NodeCollector";
+import { isApiReferenceNode } from "../versions/latest/isApiReferenceNode";
+import { isProductGroupNode } from "../versions/latest/isProductGroupNode";
+import { isProductNode } from "../versions/latest/isProductNode";
+import { isSidebarRootNode } from "../versions/latest/isSidebarRootNode";
+import { isTabbedNode } from "../versions/latest/isTabbedNode";
+import { isUnversionedNode } from "../versions/latest/isUnversionedNode";
+import { isVariantNode } from "../versions/latest/isVariantNode";
+import { isVersionNode } from "../versions/latest/isVersionNode";
+import { createBreadcrumb } from "./createBreadcrumb";
+export function findNode(root, slug) {
+    const collector = NodeCollector.collect(root);
+    const found = collector.getSlugMapWithParents().get(slug);
+    // if the slug points to a node that doesn't exist, we should redirect to the first likely node
+    if (found == null) {
+        let maybeProductOrVersionNode = root;
+        let foundProductNode = false;
+        // the 404 behavior should be product-aware
+        for (const productNode of collector.getProductNodes()) {
+            // External product links don't have slugs, so skip them
+            if (productNode.type === "product" && slug.startsWith(productNode.slug)) {
+                maybeProductOrVersionNode = productNode;
+                foundProductNode = true;
+                break;
+            }
+        }
+        // if we didn't find a product node, try to find a version node
+        if (!foundProductNode) {
+            // the 404 behavior should be version-aware
+            for (const versionNode of collector.getVersionNodes()) {
+                if (slug.startsWith(versionNode.slug)) {
+                    maybeProductOrVersionNode = versionNode;
+                    break;
+                }
+            }
+        }
+        // if we still haven't found a matching product or version, check if the slug matches
+        // the productgroup's landing page (only if no product matched to avoid collisions)
+        if (!foundProductNode && isProductGroupNode(root.child) && root.child.landingPage != null) {
+            const landingPageSlug = root.child.landingPage.slug;
+            if (slug === landingPageSlug) {
+                return { type: "redirect", redirect: landingPageSlug };
+            }
+        }
+        return {
+            type: "notFound",
+            // External product links don't have pointsTo, only internal products and versions do
+            redirect: maybeProductOrVersionNode.type === "root" ||
+                maybeProductOrVersionNode.type === "product" ||
+                maybeProductOrVersionNode.type === "version"
+                ? maybeProductOrVersionNode.pointsTo
+                : undefined,
+            authed: maybeProductOrVersionNode.authed
+        };
+    }
+    let sidebar = found.parents.find(isSidebarRootNode);
+    const currentProductGroup = found.parents.find(isProductGroupNode);
+    const currentProduct = found.parents.find(isProductNode);
+    const currentVersion = found.parents.find(isVersionNode);
+    const unversionedNode = found.parents.find(isUnversionedNode);
+    const versionChild = (currentVersion ?? unversionedNode)?.child;
+    const currentVariant = found.parents.find(isVariantNode);
+    if (!sidebar && currentVersion != null) {
+        if (isSidebarRootNode(currentVersion.child)) {
+            sidebar = currentVersion.child;
+        }
+    }
+    const landingPage = (currentProductGroup ?? currentVersion ?? unversionedNode)?.landingPage;
+    const tabbedNode = found.parents.find(isTabbedNode) ??
+        // fallback to the version child because the current node may be a landing page
+        (versionChild != null && isTabbedNode(versionChild) ? versionChild : undefined);
+    const apiReference = found.parents.find(isApiReferenceNode) ?? (found.node.type === "apiReference" ? found.node : undefined);
+    // if the node is visible (because it's a page), return it as "found"
+    if (FernNavigation.isPage(found.node)) {
+        const parentsAndNode = [...found.parents, found.node];
+        const tabbedNodeIndex = parentsAndNode.findIndex((node) => node === tabbedNode);
+        const currentTabNode = tabbedNodeIndex !== -1 ? parentsAndNode[tabbedNodeIndex + 1] : undefined;
+        const products = collector.getProductNodes().map((node) => {
+            if (node.default) {
+                // if we're currently viewing the default product, we may be viewing the non-pruned product node
+                if (node.id === currentProduct?.id) {
+                    return currentProduct;
+                }
+                // otherwise, we should always use the pruned product node
+                return collector.defaultProductNode ?? node;
+            }
+            return node;
+        });
+        const versions = collector.getVersionNodes().map((node) => {
+            if (node.default) {
+                // if we're currently viewing the default version, we may be viewing the non-pruned version
+                if (node.id === currentVersion?.id) {
+                    return currentVersion;
+                }
+                // otherwise, we should always use the pruned version node
+                return collector.defaultVersionNode ?? node;
+            }
+            return node;
+        });
+        const variants = collector.getVariantNodes().map((node) => {
+            if (node.default) {
+                // if we're currently viewing the default variant, we may be viewing the non-pruned variant
+                if (node.id === currentVariant?.id) {
+                    return currentVariant;
+                }
+                // otherwise, we should always use the pruned variant node
+                return collector.defaultVariantNode ?? node;
+            }
+            return node;
+        });
+        let currentTab = currentTabNode?.type === "tab" || currentTabNode?.type === "changelog" ? currentTabNode : undefined;
+        // If currentTab is undefined and we have tabs, try to find the appropriate tab
+        if (currentTab == null && tabbedNode != null) {
+            // First, check if any tab's pointsTo matches the current page's slug
+            for (const tab of tabbedNode.children) {
+                if (tab.type === "tab" && tab.pointsTo === found.node.slug) {
+                    currentTab = tab;
+                    break;
+                }
+                if (tab.type === "changelog" && tab.slug === found.node.slug) {
+                    currentTab = tab;
+                    break;
+                }
+            }
+            // If still no tab found and we're on a landing page, select the first tab
+            if (currentTab == null && found.node.type === "landingPage") {
+                const firstTab = tabbedNode.children.find((tab) => tab.type === "tab" || tab.type === "changelog");
+                if (firstTab != null && (firstTab.type === "tab" || firstTab.type === "changelog")) {
+                    currentTab = firstTab;
+                }
+            }
+        }
+        // External product links don't have slugs, so fall back to version or root slug
+        const slugPrefix = currentVariant?.slug ??
+            (currentProduct?.type === "product" ? currentProduct.slug : undefined) ??
+            currentVersion?.slug ??
+            root.slug;
+        const unversionedSlug = FernNavigation.Slug(found.node.slug.replace(new RegExp(`^${escapeRegExp(slugPrefix)}/`), ""));
+        return {
+            type: "found",
+            node: found.node,
+            breadcrumb: createBreadcrumb(found.parents),
+            parents: found.parents,
+            root,
+            versions, // this is used to render the version switcher
+            tabs: tabbedNode?.children ?? [],
+            products,
+            currentProduct,
+            currentVersion,
+            isCurrentProductDefault: currentProduct?.default ? currentProduct === collector.defaultProductNode : false,
+            isCurrentVersionDefault: currentVersion?.default ? currentVersion === collector.defaultVersionNode : false,
+            variants, // this is used to render the variant switcher
+            currentVariant,
+            isCurrentVariantDefault: currentVariant?.default ? currentVariant === collector.defaultVariantNode : false,
+            currentTab,
+            sidebar,
+            apiReference,
+            landingPage,
+            next: found.next,
+            prev: found.prev,
+            collector,
+            unversionedSlug
+        };
+    }
+    // if the slug points matches the root node, redirect to the root node's pointsTo
+    if (root.type === "root" && root.slug === slug && root.pointsTo != null) {
+        return { type: "redirect", redirect: root.pointsTo };
+    }
+    // if the node has a redirect, return it
+    if (FernNavigation.hasRedirect(found.node) && found.node.pointsTo != null) {
+        return { type: "redirect", redirect: found.node.pointsTo };
+    }
+    // Special handling for variant nodes without pointsTo - find the first page in their children
+    if (found.node.type === "variant" && (found.node.pointsTo == null || found.node.pointsTo === undefined)) {
+        const firstPage = findFirstPageInNode(found.node);
+        if (firstPage != null) {
+            return { type: "redirect", redirect: firstPage };
+        }
+    }
+    // if the node does not have a redirect, return a 404
+    return {
+        type: "notFound",
+        redirect: currentVersion?.pointsTo ?? root.pointsTo,
+        authed: found.node.authed
+    };
+}
+/**
+ * Recursively searches for the first page node within a given node's children
+ */
+function findFirstPageInNode(node) {
+    if (FernNavigation.isPage(node)) {
+        return node.slug;
+    }
+    const children = FernNavigation.getChildren(node);
+    if (children == null) {
+        return undefined;
+    }
+    for (const child of children) {
+        const firstPage = findFirstPageInNode(child);
+        if (firstPage != null) {
+            return firstPage;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=findNode.js.map

package/dist/navigation/utils/findNode.js.map

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

package/dist/navigation/utils/followRedirect.d.ts

@@ -0,0 +1,4 @@
+import { FernNavigation } from "../..";
+export declare function followRedirect(nodeToFollow: FernNavigation.NavigationNode | undefined): FernNavigation.Slug | undefined;
+export declare function followRedirects(nodes: readonly FernNavigation.NavigationNode[]): FernNavigation.Slug | undefined;
+//# sourceMappingURL=followRedirect.d.ts.map

package/dist/navigation/utils/followRedirect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"followRedirect.d.ts","sourceRoot":"","sources":["../../../src/navigation/utils/followRedirect.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAEvC,wBAAgB,cAAc,CAC1B,YAAY,EAAE,cAAc,CAAC,cAAc,GAAG,SAAS,GACxD,cAAc,CAAC,IAAI,GAAG,SAAS,CA6CjC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,cAAc,CAAC,cAAc,EAAE,GAAG,cAAc,CAAC,IAAI,GAAG,SAAS,CAahH"}

package/dist/navigation/utils/followRedirect.js

@@ -0,0 +1,65 @@
+import { UnreachableCaseError } from "ts-essentials";
+import { FernNavigation } from "../..";
+export function followRedirect(nodeToFollow) {
+    if (nodeToFollow == null) {
+        return undefined;
+    }
+    // skip authed pages (but do not skip authed edge nodes, since we want to follow redirects to unauthed children)
+    // TODO: the `authed: boolean` logic here is a bit convoluted and will cause confusion. We should revisit this.
+    if (FernNavigation.isPage(nodeToFollow) && !nodeToFollow.authed) {
+        return nodeToFollow.slug;
+    }
+    // skip other leaf nodes that were not returned above
+    if (FernNavigation.isLeaf(nodeToFollow)) {
+        return undefined;
+    }
+    switch (nodeToFollow.type) {
+        /**
+         * Versioned and ProductGroup nodes are special in that they have a default child.
+         */
+        case "productgroup":
+        case "versioned":
+            return followRedirects([...nodeToFollow.children].sort(defaultFirst));
+        case "apiReference":
+        case "apiPackage":
+        case "changelogMonth": // note: changelog month nodes don't exist yet as pages
+        case "changelogYear": // note: changelog month nodes don't exist yet as pages
+        case "endpointPair":
+        case "product":
+        case "productLink":
+        case "root":
+        case "section":
+        case "sidebarRoot":
+        case "sidebarGroup":
+        case "tab":
+        case "tabbed":
+        case "unversioned":
+        case "version":
+        case "changelog":
+        case "varianted":
+        case "variant":
+            return followRedirects(FernNavigation.getChildren(nodeToFollow));
+        default:
+            throw new UnreachableCaseError(nodeToFollow);
+    }
+}
+export function followRedirects(nodes) {
+    for (const node of nodes) {
+        // skip hidden nodes
+        if (FernNavigation.hasMetadata(node) && node.hidden) {
+            continue;
+        }
+        const redirect = followRedirect(node);
+        if (redirect != null) {
+            return redirect;
+        }
+    }
+    return;
+}
+function rank(node) {
+    return node.default && !node.hidden ? 1 : node.hidden ? -1 : 0;
+}
+function defaultFirst(a, b) {
+    return rank(b) - rank(a);
+}
+//# sourceMappingURL=followRedirect.js.map

package/dist/navigation/utils/followRedirect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"followRedirect.js","sourceRoot":"","sources":["../../../src/navigation/utils/followRedirect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,UAAU,cAAc,CAC1B,YAAuD;IAEvD,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,gHAAgH;IAChH,+GAA+G;IAC/G,IAAI,cAAc,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QAC9D,OAAO,YAAY,CAAC,IAAI,CAAC;IAC7B,CAAC;IAED,qDAAqD;IACrD,IAAI,cAAc,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,QAAQ,YAAY,CAAC,IAAI,EAAE,CAAC;QACxB;;WAEG;QACH,KAAK,cAAc,CAAC;QACpB,KAAK,WAAW;YACZ,OAAO,eAAe,CAAC,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QAC1E,KAAK,cAAc,CAAC;QACpB,KAAK,YAAY,CAAC;QAClB,KAAK,gBAAgB,CAAC,CAAC,uDAAuD;QAC9E,KAAK,eAAe,CAAC,CAAC,uDAAuD;QAC7E,KAAK,cAAc,CAAC;QACpB,KAAK,SAAS,CAAC;QACf,KAAK,aAAa,CAAC;QACnB,KAAK,MAAM,CAAC;QACZ,KAAK,SAAS,CAAC;QACf,KAAK,aAAa,CAAC;QACnB,KAAK,cAAc,CAAC;QACpB,KAAK,KAAK,CAAC;QACX,KAAK,QAAQ,CAAC;QACd,KAAK,aAAa,CAAC;QACnB,KAAK,SAAS,CAAC;QACf,KAAK,WAAW,CAAC;QACjB,KAAK,WAAW,CAAC;QACjB,KAAK,SAAS;YACV,OAAO,eAAe,CAAC,cAAc,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC;QACrE;YACI,MAAM,IAAI,oBAAoB,CAAC,YAAY,CAAC,CAAC;IACrD,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAA+C;IAC3E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,oBAAoB;QACpB,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAClD,SAAS;QACb,CAAC;QAED,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;YACnB,OAAO,QAAQ,CAAC;QACpB,CAAC;IACL,CAAC;IACD,OAAO;AACX,CAAC;AAED,SAAS,IAAI,CAA8D,IAAO;IAC9E,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,YAAY,CAA8D,CAAI,EAAE,CAAI;IACzF,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/dist/navigation/utils/getApiReferenceId.d.ts

@@ -0,0 +1,3 @@
+import type { FernNavigation } from "../..";
+export declare function getApiReferenceId(node: FernNavigation.NavigationNode | undefined): FernNavigation.ApiDefinitionId | undefined;
+//# sourceMappingURL=getApiReferenceId.d.ts.map

package/dist/navigation/utils/getApiReferenceId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getApiReferenceId.d.ts","sourceRoot":"","sources":["../../../src/navigation/utils/getApiReferenceId.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAK5C,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,cAAc,CAAC,cAAc,GAAG,SAAS,GAChD,cAAc,CAAC,eAAe,GAAG,SAAS,CAqC5C"}

package/dist/navigation/utils/getApiReferenceId.js

@@ -0,0 +1,41 @@
+import visitDiscriminatedUnion from "@fern-api/ui-core-utils/visitDiscriminatedUnion";
+const RETURN_UNDEFINED = () => undefined;
+const RETURN_API_DEFINITION_ID = (node) => node.apiDefinitionId;
+export function getApiReferenceId(node) {
+    if (node == null) {
+        return undefined;
+    }
+    return visitDiscriminatedUnion(node)._visit({
+        root: RETURN_UNDEFINED,
+        versioned: RETURN_UNDEFINED,
+        varianted: RETURN_UNDEFINED,
+        tabbed: RETURN_UNDEFINED,
+        sidebarRoot: RETURN_UNDEFINED,
+        sidebarGroup: RETURN_UNDEFINED,
+        version: RETURN_UNDEFINED,
+        variant: RETURN_UNDEFINED,
+        tab: RETURN_UNDEFINED,
+        link: RETURN_UNDEFINED,
+        page: RETURN_UNDEFINED,
+        section: RETURN_UNDEFINED,
+        changelog: RETURN_UNDEFINED,
+        changelogYear: RETURN_UNDEFINED,
+        changelogMonth: RETURN_UNDEFINED,
+        changelogEntry: RETURN_UNDEFINED,
+        product: RETURN_UNDEFINED,
+        productLink: RETURN_UNDEFINED,
+        productgroup: RETURN_UNDEFINED,
+        // api nodes
+        apiReference: RETURN_API_DEFINITION_ID,
+        endpoint: RETURN_API_DEFINITION_ID,
+        endpointPair: (node) => node.nonStream.apiDefinitionId,
+        webSocket: RETURN_API_DEFINITION_ID,
+        webhook: RETURN_API_DEFINITION_ID,
+        grpc: RETURN_API_DEFINITION_ID,
+        graphql: RETURN_API_DEFINITION_ID,
+        apiPackage: RETURN_API_DEFINITION_ID,
+        unversioned: RETURN_UNDEFINED,
+        landingPage: RETURN_UNDEFINED
+    });
+}
+//# sourceMappingURL=getApiReferenceId.js.map

package/dist/navigation/utils/getApiReferenceId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getApiReferenceId.js","sourceRoot":"","sources":["../../../src/navigation/utils/getApiReferenceId.ts"],"names":[],"mappings":"AAAA,OAAO,uBAAuB,MAAM,iDAAiD,CAAC;AAItF,MAAM,gBAAgB,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC;AACzC,MAAM,wBAAwB,GAAG,CAAC,IAAwC,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC;AAEpG,MAAM,UAAU,iBAAiB,CAC7B,IAA+C;IAE/C,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QACxC,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,gBAAgB;QAC3B,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,gBAAgB;QACxB,WAAW,EAAE,gBAAgB;QAC7B,YAAY,EAAE,gBAAgB;QAC9B,OAAO,EAAE,gBAAgB;QACzB,OAAO,EAAE,gBAAgB;QACzB,GAAG,EAAE,gBAAgB;QACrB,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,gBAAgB;QACzB,SAAS,EAAE,gBAAgB;QAC3B,aAAa,EAAE,gBAAgB;QAC/B,cAAc,EAAE,gBAAgB;QAChC,cAAc,EAAE,gBAAgB;QAChC,OAAO,EAAE,gBAAgB;QACzB,WAAW,EAAE,gBAAgB;QAC7B,YAAY,EAAE,gBAAgB;QAE9B,YAAY;QACZ,YAAY,EAAE,wBAAwB;QACtC,QAAQ,EAAE,wBAAwB;QAClC,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,eAAe;QACtD,SAAS,EAAE,wBAAwB;QACnC,OAAO,EAAE,wBAAwB;QACjC,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,wBAAwB;QACjC,UAAU,EAAE,wBAAwB;QACpC,WAAW,EAAE,gBAAgB;QAC7B,WAAW,EAAE,gBAAgB;KAChC,CAAC,CAAC;AACP,CAAC"}

package/dist/navigation/utils/getFrontmatter.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The use of gray-matter package is not allowed in edge-side code, because it uses `eval` internally.
+ * https://github.com/jonschlinkert/gray-matter/blob/ce67a86dba419381db0dd01cc84e2d30a1d1e6a5/lib/engines.js#L43
+ */
+export declare function getFrontmatter(markdown: string): string | undefined;
+//# sourceMappingURL=getFrontmatter.d.ts.map

package/dist/navigation/utils/getFrontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFrontmatter.d.ts","sourceRoot":"","sources":["../../../src/navigation/utils/getFrontmatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMnE"}

package/dist/navigation/utils/getFrontmatter.js

@@ -0,0 +1,12 @@
+/**
+ * The use of gray-matter package is not allowed in edge-side code, because it uses `eval` internally.
+ * https://github.com/jonschlinkert/gray-matter/blob/ce67a86dba419381db0dd01cc84e2d30a1d1e6a5/lib/engines.js#L43
+ */
+export function getFrontmatter(markdown) {
+    const frontmatterMatch = /^---\s*([\s\S]*?)\s*---/.exec(markdown.trimStart());
+    if (!frontmatterMatch || frontmatterMatch[1] == null) {
+        return undefined;
+    }
+    return frontmatterMatch[1];
+}
+//# sourceMappingURL=getFrontmatter.js.map

package/dist/navigation/utils/getFrontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFrontmatter.js","sourceRoot":"","sources":["../../../src/navigation/utils/getFrontmatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC3C,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;IAC9E,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QACnD,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/navigation/utils/getNoIndexFromFrontmatter.d.ts

@@ -0,0 +1,5 @@
+/**
+ * As as temporary workaround, we'll use a simple regex to extract the frontmatter and check for `noindex: true` or `noindex: false`.
+ */
+export declare function getNoIndexFromFrontmatter(frontmatter: string): boolean | undefined;
+//# sourceMappingURL=getNoIndexFromFrontmatter.d.ts.map

package/dist/navigation/utils/getNoIndexFromFrontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNoIndexFromFrontmatter.d.ts","sourceRoot":"","sources":["../../../src/navigation/utils/getNoIndexFromFrontmatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAOlF"}

package/dist/navigation/utils/getNoIndexFromFrontmatter.js

@@ -0,0 +1,13 @@
+/**
+ * As as temporary workaround, we'll use a simple regex to extract the frontmatter and check for `noindex: true` or `noindex: false`.
+ */
+export function getNoIndexFromFrontmatter(frontmatter) {
+    if (/noindex:\s*true/.test(frontmatter)) {
+        return true;
+    }
+    else if (/noindex:\s*false/.test(frontmatter)) {
+        return false;
+    }
+    return undefined;
+}
+//# sourceMappingURL=getNoIndexFromFrontmatter.js.map

package/dist/navigation/utils/getNoIndexFromFrontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNoIndexFromFrontmatter.js","sourceRoot":"","sources":["../../../src/navigation/utils/getNoIndexFromFrontmatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IACzD,IAAI,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IAChB,CAAC;SAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC"}

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

@@ -0,0 +1,13 @@
+export * from "./buildPageIdToSlugMap";
+export * from "./collectApiReferences";
+export * from "./collectPageIds";
+export * from "./createBreadcrumb";
+export * from "./findNode";
+export * from "./getApiReferenceId";
+export * from "./getNoIndexFromFrontmatter";
+export * from "./toApis";
+export * from "./toPages";
+export * from "./toRootNode";
+export * from "./toUnversionedSlug";
+export * from "./updatePointsTo";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/navigation/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}

package/dist/navigation/utils/index.js

@@ -0,0 +1,13 @@
+export * from "./buildPageIdToSlugMap";
+export * from "./collectApiReferences";
+export * from "./collectPageIds";
+export * from "./createBreadcrumb";
+export * from "./findNode";
+export * from "./getApiReferenceId";
+export * from "./getNoIndexFromFrontmatter";
+export * from "./toApis";
+export * from "./toPages";
+export * from "./toRootNode";
+export * from "./toUnversionedSlug";
+export * from "./updatePointsTo";
+//# sourceMappingURL=index.js.map

package/dist/navigation/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/navigation/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}

package/dist/navigation/utils/isSubpackage.d.ts

@@ -0,0 +1,3 @@
+import type { APIV1Read } from "../../client/types";
+export declare function isSubpackage(package_: APIV1Read.ApiDefinitionPackage): package_ is APIV1Read.ApiDefinitionSubpackage;
+//# sourceMappingURL=isSubpackage.d.ts.map

package/dist/navigation/utils/isSubpackage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isSubpackage.d.ts","sourceRoot":"","sources":["../../../src/navigation/utils/isSubpackage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,oBAAoB,GAAG,QAAQ,IAAI,SAAS,CAAC,uBAAuB,CAEpH"}

package/dist/navigation/utils/isSubpackage.js

@@ -0,0 +1,4 @@
+export function isSubpackage(package_) {
+    return typeof package_.subpackageId === "string";
+}
+//# sourceMappingURL=isSubpackage.js.map

package/dist/navigation/utils/isSubpackage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isSubpackage.js","sourceRoot":"","sources":["../../../src/navigation/utils/isSubpackage.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,QAAwC;IACjE,OAAO,OAAQ,QAA8C,CAAC,YAAY,KAAK,QAAQ,CAAC;AAC5F,CAAC"}

package/dist/navigation/utils/pruneNavigationTree.d.ts

@@ -0,0 +1,14 @@
+import { FernNavigation } from "../..";
+type Predicate<T extends FernNavigation.NavigationNode = FernNavigation.NavigationNode> = (node: T, parents: readonly FernNavigation.NavigationNodeParent[]) => boolean;
+export declare class Pruner<ROOT extends FernNavigation.NavigationNode> {
+    static from<ROOT extends FernNavigation.NavigationNode>(tree: ROOT): Pruner<ROOT>;
+    private tree;
+    private constructor();
+    keep(predicate: Predicate): this;
+    remove(predicate: Predicate): this;
+    hide(predicate: Predicate<FernNavigation.NavigationNodeWithMetadata>): this;
+    authed(predicate: Predicate): this;
+    get(): ROOT | undefined;
+}
+export {};
+//# sourceMappingURL=pruneNavigationTree.d.ts.map

package/dist/navigation/utils/pruneNavigationTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pruneNavigationTree.d.ts","sourceRoot":"","sources":["../../../src/navigation/utils/pruneNavigationTree.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAKvC,KAAK,SAAS,CAAC,CAAC,SAAS,cAAc,CAAC,cAAc,GAAG,cAAc,CAAC,cAAc,IAAI,CACtF,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,SAAS,cAAc,CAAC,oBAAoB,EAAE,KACtD,OAAO,CAAC;AAEb,qBAAa,MAAM,CAAC,IAAI,SAAS,cAAc,CAAC,cAAc;WAC5C,IAAI,CAAC,IAAI,SAAS,cAAc,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAIxF,OAAO,CAAC,IAAI,CAAmB;IAC/B,OAAO;IAIA,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAchC,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAIlC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,cAAc,CAAC,0BAA0B,CAAC,GAAG,IAAI;IAY3E,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAiClC,GAAG,IAAI,IAAI,GAAG,SAAS;CAOjC"}

package/dist/navigation/utils/pruneNavigationTree.js

@@ -0,0 +1,77 @@
+import structuredClone from "@ungap/structured-clone";
+import { FernNavigation } from "../..";
+import { prunetree } from "../../utils/traversers/prunetree";
+import { mutableDeleteChild } from "./deleteChild";
+import { mutableUpdatePointsTo } from "./updatePointsTo";
+export class Pruner {
+    static from(tree) {
+        return new Pruner(tree);
+    }
+    tree;
+    constructor(tree) {
+        this.tree = structuredClone(tree);
+    }
+    keep(predicate) {
+        if (this.tree == null) {
+            return this;
+        }
+        const [result] = prunetree(this.tree, {
+            predicate,
+            getChildren: FernNavigation.getChildren,
+            getPointer: (node) => node.id,
+            deleter: mutableDeleteChild
+        });
+        this.tree = result;
+        return this;
+    }
+    remove(predicate) {
+        return this.keep((node, parents) => !predicate(node, parents));
+    }
+    hide(predicate) {
+        if (this.tree == null) {
+            return this;
+        }
+        FernNavigation.traverseBF(this.tree, (node, parents) => {
+            if (FernNavigation.hasMetadata(node)) {
+                node.hidden = predicate(node, parents);
+            }
+        });
+        return this;
+    }
+    authed(predicate) {
+        if (this.tree == null) {
+            return this;
+        }
+        const unauthedParents = new Set();
+        // step 1. mark nodes as authed if the match the predicate
+        FernNavigation.traverseBF(this.tree, (node, parents) => {
+            if (FernNavigation.hasMetadata(node)) {
+                node.authed = predicate(node, parents) ? true : undefined;
+                if (!node.authed) {
+                    for (const parent of parents) {
+                        unauthedParents.add(parent);
+                    }
+                }
+            }
+        });
+        // step 2. remove auth flag on edge nodes that contain children that are unauthed
+        // this helps us improve the rendering of the navigation tree and avoid deleting nodes that contain
+        // children that can be visited.
+        // Note: sections with overview pages are skipped here because the pages need to be filtered out
+        // by the mutableDeleteChild function, which relies on the authed flag in a separate pass.
+        for (const parent of unauthedParents) {
+            if (FernNavigation.hasMetadata(parent) && !FernNavigation.isPage(parent)) {
+                parent.authed = undefined;
+            }
+        }
+        return this;
+    }
+    get() {
+        if (this.tree == null) {
+            return undefined;
+        }
+        mutableUpdatePointsTo(this.tree);
+        return this.tree;
+    }
+}
+//# sourceMappingURL=pruneNavigationTree.js.map

package/dist/navigation/utils/pruneNavigationTree.js.map

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

package/dist/navigation/utils/pruneVersionNode.d.ts

@@ -0,0 +1,4 @@
+import { FernNavigation } from "../..";
+export declare function pruneVersionNode<T extends FernNavigation.NavigationNode>(node: T, rootSlug: FernNavigation.Slug, versionSlug: FernNavigation.Slug): T;
+export declare function pruneVersionNode<T extends FernNavigation.NavigationNode>(node: T | undefined, rootSlug: FernNavigation.Slug, versionSlug: FernNavigation.Slug): T | undefined;
+//# sourceMappingURL=pruneVersionNode.d.ts.map

package/dist/navigation/utils/pruneVersionNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pruneVersionNode.d.ts","sourceRoot":"","sources":["../../../src/navigation/utils/pruneVersionNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAEvC,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,cAAc,CAAC,cAAc,EACpE,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,cAAc,CAAC,IAAI,EAC7B,WAAW,EAAE,cAAc,CAAC,IAAI,GACjC,CAAC,CAAC;AACL,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,cAAc,CAAC,cAAc,EACpE,IAAI,EAAE,CAAC,GAAG,SAAS,EACnB,QAAQ,EAAE,cAAc,CAAC,IAAI,EAC7B,WAAW,EAAE,cAAc,CAAC,IAAI,GACjC,CAAC,GAAG,SAAS,CAAC"}

package/dist/navigation/utils/pruneVersionNode.js

@@ -0,0 +1,23 @@
+import { FernNavigation } from "../..";
+export function pruneVersionNode(node, rootSlug, versionSlug) {
+    if (node == null) {
+        return undefined;
+    }
+    FernNavigation.traverseDF(node, (node) => {
+        if (FernNavigation.hasMetadata(node)) {
+            const newSlug = FernNavigation.toDefaultSlug(node.slug, rootSlug, versionSlug);
+            // children of this node was already pruned
+            if (node.slug === newSlug) {
+                return "skip";
+            }
+            node.canonicalSlug = node.canonicalSlug ?? node.slug;
+            node.slug = newSlug;
+        }
+        if (FernNavigation.hasRedirect(node)) {
+            node.pointsTo = FernNavigation.toDefaultSlug(node.pointsTo, rootSlug, versionSlug);
+        }
+        return;
+    });
+    return node;
+}
+//# sourceMappingURL=pruneVersionNode.js.map

package/dist/navigation/utils/pruneVersionNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pruneVersionNode.js","sourceRoot":"","sources":["../../../src/navigation/utils/pruneVersionNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAYvC,MAAM,UAAU,gBAAgB,CAC5B,IAAmB,EACnB,QAA6B,EAC7B,WAAgC;IAEhC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;QACrC,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;YAC/E,2CAA2C;YAC3C,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACxB,OAAO,MAAM,CAAC;YAClB,CAAC;YACD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,IAAI,CAAC;YACrD,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;QACxB,CAAC;QAED,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,QAAQ,GAAG,cAAc,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QACvF,CAAC;QACD,OAAO;IACX,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/navigation/utils/stringifyEndpointPathParts.d.ts

@@ -0,0 +1,3 @@
+import type { APIV1Read } from "../../client/types";
+export declare function stringifyEndpointPathParts(path: APIV1Read.EndpointPathPart[]): string;
+//# sourceMappingURL=stringifyEndpointPathParts.d.ts.map

package/dist/navigation/utils/stringifyEndpointPathParts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringifyEndpointPathParts.d.ts","sourceRoot":"","sources":["../../../src/navigation/utils/stringifyEndpointPathParts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,SAAS,CAAC,gBAAgB,EAAE,GAAG,MAAM,CAErF"}