@mintlify/common 1.0.1189 → 1.0.1190

package/dist/navigation/generatePathToBreadcrumbsMapForDocsConfig.d.ts

@@ -1,3 +1,9 @@
 import { NavigationConfig, PagesConfig } from '@mintlify/validation';
+type DivisionContext = {
+    language?: string;
+    isDefaultLanguage?: boolean;
+    version?: string;
+};
 export declare function generatePathToBreadcrumbsMapForDocsConfig(navigation: NavigationConfig): Map<any, any>;
-export declare function generatePathToBreadcrumbsMapForPagesRecursive(pages: PagesConfig, currentBreadcrumbs: string[], map: Map<string, string[]>, depth?: number): void;
+export declare function generatePathToBreadcrumbsMapForPagesRecursive(pages: PagesConfig, currentBreadcrumbs: string[], map: Map<string, string[]>, depth?: number, pathPriorities?: Map<string, number>, divisionContext?: DivisionContext): void;
+export {};

package/dist/navigation/generatePathToBreadcrumbsMapForDocsConfig.js

@@ -17,14 +17,37 @@ function getDivisionTitle(item, key) {
     return getStringProperty(item, divisionPropertyNameMap[key]);
 }
 const MAX_RECURSION_DEPTH = 100;
+function getDefaultLanguage(items) {
+    var _a;
+    const defaultItem = (_a = items.find((item) => Reflect.get(item, 'default') === true)) !== null && _a !== void 0 ? _a : items[0];
+    return defaultItem ? getStringProperty(defaultItem, 'language') : '';
+}
+function getPathPriority(path, { language, isDefaultLanguage, version }) {
+    if (!language)
+        return 0;
+    const localePrefixes = version ? [`${language}/`, `${version}/${language}/`] : [`${language}/`];
+    if (localePrefixes.some((prefix) => path.startsWith(prefix)))
+        return 2;
+    return isDefaultLanguage ? 1 : 0;
+}
+function getItemDivisionContext(key, item, divisionContext, defaultLanguage) {
+    if (key === 'languages') {
+        const language = getStringProperty(item, 'language');
+        return Object.assign(Object.assign({}, divisionContext), { language, isDefaultLanguage: language === defaultLanguage });
+    }
+    if (key === 'versions') {
+        return Object.assign(Object.assign({}, divisionContext), { version: getStringProperty(item, 'version') });
+    }
+    return divisionContext;
+}
 export function generatePathToBreadcrumbsMapForDocsConfig(navigation) {
     const pathToBreadcrumbs = new Map();
-    generatePathToBreadcrumbsMapForDocsConfigRecursive(navigation, pathToBreadcrumbs, []);
+    generatePathToBreadcrumbsMapForDocsConfigRecursive(navigation, pathToBreadcrumbs, [], new Map());
     return pathToBreadcrumbs;
 }
-function generatePathToBreadcrumbsMapForDocsConfigRecursive(nav, map, currentBreadcrumbs = []) {
+function generatePathToBreadcrumbsMapForDocsConfigRecursive(nav, map, currentBreadcrumbs, pathPriorities, divisionContext = {}) {
     if ('pages' in nav) {
-        generatePathToBreadcrumbsMapForPagesRecursive(nav.pages, currentBreadcrumbs, map);
+        generatePathToBreadcrumbsMapForPagesRecursive(nav.pages, currentBreadcrumbs, map, 0, pathPriorities, divisionContext);
     }
     for (const key of [...divisions, 'groups']) {
         if (key in nav) {
@@ -33,28 +56,34 @@ function generatePathToBreadcrumbsMapForDocsConfigRecursive(nav, map, currentBre
                 continue;
             }
             const includeDivisionInBreadcrumbs = key === 'groups' || !excludedBreadcrumbDivisions.has(key);
+            const defaultLanguage = key === 'languages' ? getDefaultLanguage(items) : undefined;
             for (const item of items) {
                 const divisionTitle = includeDivisionInBreadcrumbs ? getDivisionTitle(item, key) : '';
                 const newBreadcrumbs = divisionTitle
                     ? [...currentBreadcrumbs, divisionTitle]
                     : currentBreadcrumbs;
-                generatePathToBreadcrumbsMapForDocsConfigRecursive(item, map, newBreadcrumbs);
+                generatePathToBreadcrumbsMapForDocsConfigRecursive(item, map, newBreadcrumbs, pathPriorities, getItemDivisionContext(key, item, divisionContext, defaultLanguage));
             }
         }
     }
 }
-export function generatePathToBreadcrumbsMapForPagesRecursive(pages, currentBreadcrumbs, map, depth = 0) {
+export function generatePathToBreadcrumbsMapForPagesRecursive(pages, currentBreadcrumbs, map, depth = 0, pathPriorities = new Map(), divisionContext = {}) {
+    var _a;
     if (depth >= MAX_RECURSION_DEPTH)
         return;
     for (const entry of pages) {
         if (typeof entry === 'string') {
+            const priority = getPathPriority(entry, divisionContext);
+            if (((_a = pathPriorities.get(entry)) !== null && _a !== void 0 ? _a : -1) > priority)
+                continue;
             const nonEmptyBreadcrumbs = currentBreadcrumbs.filter((crumb) => !!crumb.trim());
             map.set(entry, [...nonEmptyBreadcrumbs]);
+            pathPriorities.set(entry, priority);
         }
         else {
             currentBreadcrumbs.push(entry.group);
             if ('pages' in entry && Array.isArray(entry.pages)) {
-                generatePathToBreadcrumbsMapForPagesRecursive(entry.pages, currentBreadcrumbs, map, depth + 1);
+                generatePathToBreadcrumbsMapForPagesRecursive(entry.pages, currentBreadcrumbs, map, depth + 1, pathPriorities, divisionContext);
             }
             currentBreadcrumbs.pop();
         }