@mintlify/common/dist/divisions/generatePathToPublicDict.js

Commonly shared code within Mintlify

import { divisions } from '@mintlify/validation';
import { isPage } from '../navigation/isPage.js';
import { optionallyRemoveLeadingSlash } from '../optionallyRemoveLeadingSlash.js';
import { iterateObjectArrayProperty } from './iterateObjectArrayProperty.js';
/**
 * Generates a map from page paths to their public status based on navigation hierarchy.
 * A page is public if it or any parent group/division has public: true.
 * Assumes page hrefs in navWithPageContext have a leading / but config page paths do not.
 * Outputted dictionary will NOT have a leading / in the dictionary keys.
 * @param rootPublic - The default public status for pages not explicitly set in navigation
 */
export function generatePathToPublicDict(decoratedNav, rootPublic) {
    const pathToPublicDict = new Map();
    generatePathToPublicDictRecursive(pathToPublicDict, decoratedNav, rootPublic !== null && rootPublic !== void 0 ? rootPublic : false);
    return pathToPublicDict;
}
function generatePathToPublicDictRecursive(pathToPublicDict, nav, parentPublic) {
    if (typeof nav !== 'object')
        return;
    // Determine the effective public status for this level
    const effectivePublic = 'public' in nav && typeof nav.public === 'boolean' ? nav.public : parentPublic;
    if (isPage(nav)) {
        const key = optionallyRemoveLeadingSlash(nav.href);
        // Set the public status for this page if not already set
        // We keep the first value encountered to handle duplicate paths
        if (!pathToPublicDict.has(key)) {
            pathToPublicDict.set(key, effectivePublic);
        }
    }
    if ('pages' in nav && Array.isArray(nav.pages)) {
        if ('root' in nav && typeof nav.root === 'object') {
            generatePathToPublicDictRecursive(pathToPublicDict, nav.root, effectivePublic);
        }
        for (const page of nav.pages) {
            if (typeof page === 'object') {
                generatePathToPublicDictRecursive(pathToPublicDict, page, effectivePublic);
            }
        }
    }
    for (const key of ['groups', ...divisions]) {
        iterateObjectArrayProperty(nav, key, (item) => generatePathToPublicDictRecursive(pathToPublicDict, item, effectivePublic));
    }
}