@mintlify/common 1.0.789 → 1.0.791

package/dist/navigation/getFirstPageFromNavConfig.d.ts

@@ -0,0 +1,2 @@
+import { NavigationConfig, DivisionNavigationType } from '@mintlify/validation';
+export declare function getFirstPageFromNavConfig(nav: NavigationConfig | DivisionNavigationType | undefined): string | undefined;

package/dist/navigation/getFirstPageFromNavConfig.js

@@ -0,0 +1,48 @@
+import { divisions, } from '@mintlify/validation';
+import { replaceSlashIndex } from '../slug/replaceSlashIndex.js';
+function getFirstFromPageOrGroup(entry) {
+    if (typeof entry === 'string') {
+        return replaceSlashIndex(entry);
+    }
+    if ('hidden' in entry && entry.hidden)
+        return undefined;
+    return getFirstPageFromNavConfig(entry);
+}
+export function getFirstPageFromNavConfig(nav) {
+    if (!nav || typeof nav !== 'object')
+        return undefined;
+    if ('pages' in nav && nav.pages) {
+        if ('root' in nav && typeof nav.root === 'string') {
+            return replaceSlashIndex(nav.root);
+        }
+        for (const page of nav.pages) {
+            const result = getFirstFromPageOrGroup(page);
+            if (result !== undefined)
+                return result;
+        }
+    }
+    if ('groups' in nav) {
+        for (const group of nav.groups) {
+            if (group.hidden)
+                continue;
+            const result = getFirstPageFromNavConfig(group);
+            if (result !== undefined)
+                return result;
+        }
+    }
+    for (const key of divisions) {
+        if (key in nav) {
+            const items = nav[key];
+            if (Array.isArray(items)) {
+                for (const item of items) {
+                    if (typeof item === 'object' && 'hidden' in item && item.hidden)
+                        continue;
+                    const result = getFirstPageFromNavConfig(item);
+                    if (result !== undefined)
+                        return result;
+                }
+            }
+        }
+    }
+    return undefined;
+}

package/dist/navigation/index.d.ts

@@ -5,3 +5,4 @@ export * from './getFirstPageFromNavigation.js';
 export * from './generatePathToBreadcrumbsMapForDocsConfig.js';
 export * from './getAllPathsInDocsNav.js';
 export * from './checkNavAccess.js';
+export * from './getFirstPageFromNavConfig.js';

package/dist/navigation/index.js

@@ -5,3 +5,4 @@ export * from './getFirstPageFromNavigation.js';
 export * from './generatePathToBreadcrumbsMapForDocsConfig.js';
 export * from './getAllPathsInDocsNav.js';
 export * from './checkNavAccess.js';
+export * from './getFirstPageFromNavConfig.js';