@mintlify/prebuild 1.0.1523 → 1.0.1525

package/dist/prebuild/update/docsConfig/generateSdkDivisions.js

@@ -1,4 +1,4 @@
-import { isSdkFrontmatterValue, parseFrontmatter, parseSdkTargetFromMetadata, toPosixPath, } from '@mintlify/common';
+import { isObject, isSdkFrontmatterValue, parseFrontmatter, parseSdkTargetFromMetadata, toPosixPath, } from '@mintlify/common';
 import { generateSdkReference, renderSdkTarget, } from '@mintlify/scraping';
 import { Unzip, UnzipInflate } from 'fflate';
 import fse from 'fs-extra';
@@ -115,6 +115,8 @@ function expandSdkGroups(reference, directory) {
     const pageBySlug = new Map(reference.pages.map((page) => [page.slug, page]));
     const groups = reference.groups.map((group) => prefixSdkGroup(group, directory));
     const groupedSlugs = collectSdkGroupSlugs(reference.groups);
+    if (reference.overview)
+        groupedSlugs.add(reference.overview);
     const orphanedSlugs = reference.pages
         .filter((page) => !page.target?.parent)
         .map((page) => page.slug)
@@ -160,7 +162,12 @@ export async function generateSdkDivisionsFromDocsConfig(docsConfig, loadReferen
         for (const page of topLevelPages) {
             rememberGenerated(toGeneratedPage(page, config, directory, referenceSlugs, true));
         }
-        return { groups: expandSdkGroups({ ...reference, pages: topLevelPages }, directory) };
+        return {
+            groups: expandSdkGroups({ ...reference, pages: topLevelPages }, directory),
+            overview: reference.overview && referenceSlugs.has(reference.overview)
+                ? [path.posix.join(directory, reference.overview)]
+                : [],
+        };
     }
     async function processPages(pages, inherited) {
         if (!Array.isArray(pages))
@@ -196,23 +203,32 @@ export async function generateSdkDivisionsFromDocsConfig(docsConfig, loadReferen
         if (ownSdk && (isTab || isGroup)) {
             const skipBulk = hasExplicitSdkPages(node, pageMetadataBySlug, ownSdk);
             if (!skipBulk) {
-                const { groups } = await materializeBulk(ownSdk);
+                const { groups, overview } = await materializeBulk(ownSdk);
                 if (isTab) {
                     const { sdk: _sdk, ...tab } = node;
                     const existingGroups = Array.isArray(tab.groups)
                         ? (await processNode(tab.groups, ownSdk))
                         : [];
-                    const existingPages = Array.isArray(tab.pages)
-                        ? (await processPages(tab.pages, ownSdk))
-                        : [];
+                    const existingPages = [
+                        ...(Array.isArray(tab.pages)
+                            ? (await processPages(tab.pages, ownSdk))
+                            : []),
+                        ...overview,
+                    ];
                     const restEntries = await Promise.all(Object.entries(tab)
                         .filter(([key]) => key !== 'groups' && key !== 'pages')
                         .map(async ([key, entry]) => [key, await processNode(entry, ownSdk)]));
+                    const overviewIndex = existingGroups.findIndex((entry) => isObject(entry) && entry.group === 'Overview' && Array.isArray(entry.pages));
+                    const mergedGroups = existingGroups.map((entry, index) => index === overviewIndex && isObject(entry) && Array.isArray(entry.pages)
+                        ? { ...entry, pages: [...entry.pages, ...existingPages] }
+                        : entry);
                     return {
                         ...Object.fromEntries(restEntries),
                         groups: [
-                            ...existingGroups,
-                            ...(existingPages.length > 0 ? [{ group: 'Overview', pages: existingPages }] : []),
+                            ...mergedGroups,
+                            ...(overviewIndex === -1 && existingPages.length > 0
+                                ? [{ group: 'Overview', pages: existingPages }]
+                                : []),
                             ...groups,
                         ],
                     };
@@ -223,7 +239,7 @@ export async function generateSdkDivisionsFromDocsConfig(docsConfig, loadReferen
                     : [];
                 return {
                     ...group,
-                    pages: [...processedPages, ...groups],
+                    pages: [...processedPages, ...overview, ...groups],
                 };
             }
             if (isTab) {