@mintlify/prebuild 1.0.1453 → 1.0.1454

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

@@ -77,6 +77,7 @@ function toGeneratedPage(page, config, directory, referenceSlugs, autogeneratedB
             kind: page.target.kind,
             name: page.target.name,
             ...(page.target.parent ? { parent: page.target.parent } : {}),
+            ...(page.target.namespace ? { namespace: page.target.namespace } : {}),
         }
         : undefined;
     return {
@@ -84,7 +85,7 @@ function toGeneratedPage(page, config, directory, referenceSlugs, autogeneratedB
         title: page.title,
         ...(page.description ? { description: page.description } : {}),
         ...(page.tag ? { tag: page.tag } : {}),
-        content: prefixInternalLinks(stripLeadingDescription(page.content, page.description), directory, referenceSlugs),
+        content: prefixInternalLinks(renderGeneratedBody(page, true), directory, referenceSlugs),
         format: config.format,
         source: config.source,
         ...(sdk ? { sdk } : {}),
@@ -283,8 +284,8 @@ export async function composeSdkFrontmatterPage(args) {
             : slugDirectory
         : (args.inherited.directory ?? DEFAULT_OUTPUT_DIR);
     const referenceSlugs = new Set(reference.pages.map((entry) => entry.slug));
-    const generatedBody = prefixInternalLinks(stripLeadingDescription(page.content, page.description), directory, referenceSlugs);
     const authorBody = stripFrontmatter(args.authorContent).trim();
+    const generatedBody = prefixInternalLinks(renderGeneratedBody(page, authorBody.length === 0), directory, referenceSlugs);
     const content = [authorBody, generatedBody].filter(Boolean).join('\n\n');
     return {
         slug,
@@ -478,13 +479,25 @@ function assertSafeSlug(slug, config) {
         throw new Error(`SDK reference ${config.format}:${config.source} produced an unsafe page slug "${slug}"`);
     }
 }
+// Link text stops at the next bracket and a destination at the next paren, so
+// each attempt ends at the next markup character and a chunk full of unclosed
+// links costs linear time (destinations with nested parens are left as is).
 function normalizeProse(text) {
     return text
-        .replace(/!?\[([^\]]*)\]\([^)]*\)/g, '$1')
+        .replace(/!?\[([^\][\n]*)\]\([^()\n]*\)/g, '$1')
         .replace(/[`*_\\]/g, '')
         .replace(/\s+/g, ' ')
         .trim();
 }
+// A page's intro (a package README, for instance) stands in for author prose,
+// so an author who claims the page replaces it while the reference sections
+// stay. The converter has already left the description out of the intro.
+function renderGeneratedBody(page, withIntro) {
+    const body = stripLeadingDescription(page.content, page.description);
+    if (withIntro && page.intro)
+        return [page.intro, body].filter(Boolean).join('\n\n');
+    return body;
+}
 function stripLeadingDescription(content, description) {
     if (!description)
         return content;