@mintlify/common 1.0.816 → 1.0.818

package/dist/mdx/getMDXOptions.js

@@ -1,4 +1,4 @@
-import { rehypeCodeBlocks, rehypeDynamicTailwindCss, rehypeKeyboardSymbols, rehypeListItemText, rehypeMdxExtractEndpoint, rehypeMdxExtractExamples, rehypeParamFieldIds, rehypeRawComponents, rehypeTable, rehypeUnicodeIds, rehypeZoomImages, remarkExtractChangelogFilters, remarkExtractTableOfContents, remarkFrames, remarkComponentIds, remarkMdxInjectSnippets, remarkMdxRemoveUnusedVariables, remarkRemoveImports, remarkMdxExtractPanel, remarkVideo, remarkExtractMultiView, remarkPrompt, } from './plugins/index.js';
+import { rehypeCodeBlocks, rehypeDynamicTailwindCss, rehypeKeyboardSymbols, rehypeListItemText, rehypeMdxExtractEndpoint, rehypeMdxExtractExamples, rehypeParamFieldIds, rehypeRawComponents, rehypeTable, rehypeUnicodeIds, rehypeZoomImages, remarkExtractChangelogFilters, remarkExtractTableOfContents, remarkFrames, remarkComponentIds, remarkMdxInjectSnippets, remarkMdxRemoveUnusedVariables, remarkRemoveImports, remarkMdxExtractPanel, remarkVideo, remarkExtractMultiView, remarkPrompt, remarkUnwrapJsxHeadings, } from './plugins/index.js';
 import { remarkMdxRemoveUnknownJsx } from './plugins/remark/remarkMdxRemoveUnknownJsx/index.js';
 import { remarkMermaid } from './plugins/remark/remarkMermaid.js';
 // avoid running extractors unnecessarily
@@ -16,6 +16,7 @@ export const getMDXOptions = ({ data, remarkPlugins = [], rehypePlugins = [], md
             [remarkMdxInjectSnippets, data.snippetTreeMap],
             remarkPrompt,
             [remarkComponentIds, data.pageMetadata],
+            remarkUnwrapJsxHeadings,
             [remarkExtractTableOfContents, mdxExtracts, data.pageMetadata], // modifies tree so cannot be excluded
             [remarkExtractChangelogFilters, mdxExtracts],
             [remarkMdxExtractPanel, mdxExtracts],

package/dist/mdx/plugins/remark/index.d.ts

@@ -17,3 +17,4 @@ export * from './remarkValidateTabs.js';
 export * from './remarkVideo.js';
 export * from './remarkExtractMultiView.js';
 export * from './remarkPrompt.js';
+export * from './remarkUnwrapJsxHeadings.js';

package/dist/mdx/plugins/remark/index.js

@@ -17,3 +17,4 @@ export * from './remarkValidateTabs.js';
 export * from './remarkVideo.js';
 export * from './remarkExtractMultiView.js';
 export * from './remarkPrompt.js';
+export * from './remarkUnwrapJsxHeadings.js';

package/dist/mdx/plugins/remark/remarkExtractTableOfContents.js

@@ -183,14 +183,6 @@ export const remarkExtractTableOfContents = (mdxExtracts, pageMetadata) => {
                     mdxJsxAttributes.push(...node.attributes);
                 }
             }
-            // Unwrap paragraph children inside JSX headings (e.g. <h2>) so that the
-            // Heading component receives inline children instead of <p>-wrapped text.
-            // This happens because the preprocessor places text on its own line between
-            // JSX tags, which MDX parses as a paragraph block.
-            if (isValidMdxHeading && 'children' in node) {
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                node.children = node.children.flatMap((child) => child.type === 'paragraph' && 'children' in child ? child.children : [child]);
-            }
             // @ts-expect-error we're assigning over 'attributes' if it doesn't exist
             node.attributes = mdxJsxAttributes;
             node.type = 'mdxJsxFlowElement';

package/dist/mdx/plugins/remark/remarkUnwrapJsxHeadings.d.ts

@@ -0,0 +1,9 @@
+import type { Root } from 'mdast';
+/**
+ * Unwraps paragraph children inside JSX heading elements (h1–h6).
+ *
+ * The custom-ID preprocessor emits headings like `<h2 id="x">\nText\n</h2>`,
+ * and MDX parses the text on its own line as a paragraph block. This plugin
+ * flattens those paragraphs so the heading receives inline children directly.
+ */
+export declare const remarkUnwrapJsxHeadings: () => (tree: Root) => void;

package/dist/mdx/plugins/remark/remarkUnwrapJsxHeadings.js

@@ -0,0 +1,18 @@
+import { visit } from 'unist-util-visit';
+import { ALL_HEADING_NAMES } from '../../preprocessCustomHeadingIds.js';
+/**
+ * Unwraps paragraph children inside JSX heading elements (h1–h6).
+ *
+ * The custom-ID preprocessor emits headings like `<h2 id="x">\nText\n</h2>`,
+ * and MDX parses the text on its own line as a paragraph block. This plugin
+ * flattens those paragraphs so the heading receives inline children directly.
+ */
+export const remarkUnwrapJsxHeadings = () => (tree) => {
+    visit(tree, 'mdxJsxFlowElement', (node) => {
+        var _a;
+        if (!ALL_HEADING_NAMES.includes((_a = node.name) !== null && _a !== void 0 ? _a : ''))
+            return;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        node.children = node.children.flatMap((child) => child.type === 'paragraph' && 'children' in child ? child.children : [child]);
+    });
+};

package/dist/mdx/preprocessCustomHeadingIds.d.ts

@@ -6,9 +6,13 @@ import { MdxJsxFlowElement } from 'mdast-util-mdx-jsx';
  * Transforms `## Heading text {#custom-id}` into `<h2 id="custom-id">Heading text</h2>`.
  * This avoids MDX parsing errors (MDX treats `{...}` as JS expressions) and
  * produces JSX heading elements that the existing remark pipeline already handles.
+ *
+ * Uses a line-by-line scan with fence state tracking to skip headings inside
+ * code blocks, avoiding backtracking over large documents.
  */
 export declare function preprocessCustomHeadingIds(content: string): string;
 export interface JsxHeadingElement extends MdxJsxFlowElement {
     readonly __jsxHeading: true;
 }
+export declare const ALL_HEADING_NAMES: string[];
 export declare const isJsxHeadingElement: (node: RootContent) => node is JsxHeadingElement;

package/dist/mdx/preprocessCustomHeadingIds.js

@@ -1,27 +1,74 @@
 import slugify from '@sindresorhus/slugify';
-import { HEADING_NAMES } from './plugins/remark/remarkExtractTableOfContents.js';
+const HEADING_ID_RE = /^(#{1,6})\s+(.+?)\s*\{\s*#([^}]+?)\s*\}\s*$/;
 /**
  * Converts markdown headings with custom ID syntax into JSX heading elements.
  *
  * Transforms `## Heading text {#custom-id}` into `<h2 id="custom-id">Heading text</h2>`.
  * This avoids MDX parsing errors (MDX treats `{...}` as JS expressions) and
  * produces JSX heading elements that the existing remark pipeline already handles.
+ *
+ * Uses a line-by-line scan with fence state tracking to skip headings inside
+ * code blocks, avoiding backtracking over large documents.
  */
 export function preprocessCustomHeadingIds(content) {
-    // Single pass: match code fences (returned unchanged) or headings with
-    // custom IDs (transformed to JSX). Backreferences \1 / \2 ensure the
-    // closing fence matches the opening fence length.
-    return content.replace(/^(`{3,})[^\n]*\n[\s\S]*?^\1\s*$|^(~{3,})[^\n]*\n[\s\S]*?^\2\s*$|^(#{1,4})\s+(.+?)\s*\{\s*#([^}]+?)\s*\}\s*$/gm, (match, _backtickFence, _tildeFence, hashes, text, id) => {
-        if (!hashes)
-            return match; // code fence — leave unchanged
-        const level = hashes.length;
-        const sanitizedId = slugify(id.trim(), { preserveCharacters: ['_'] });
-        return `<h${level} id="${sanitizedId}">\n${text}\n</h${level}>`;
-    });
+    const lines = content.split('\n');
+    const result = [];
+    let fenceChar;
+    let fenceCount = 0;
+    for (const line of lines) {
+        const stripped = line.trimStart();
+        if (fenceChar !== undefined) {
+            if (isClosingFence(stripped, fenceChar, fenceCount)) {
+                fenceChar = undefined;
+            }
+            result.push(line);
+            continue;
+        }
+        const fence = parseOpeningFence(stripped);
+        if (fence) {
+            fenceChar = fence.char;
+            fenceCount = fence.count;
+            result.push(line);
+            continue;
+        }
+        const heading = HEADING_ID_RE.exec(line);
+        if ((heading === null || heading === void 0 ? void 0 : heading[1]) && heading[2] && heading[3]) {
+            const level = heading[1].length;
+            const sanitizedId = slugify(heading[3].trim(), { preserveCharacters: ['_'] });
+            result.push(`<h${level} id="${sanitizedId}">`, heading[2], `</h${level}>`);
+            continue;
+        }
+        result.push(line);
+    }
+    return result.join('\n');
+}
+function parseOpeningFence(stripped) {
+    const char = stripped[0];
+    if (char !== '`' && char !== '~')
+        return undefined;
+    let count = 1;
+    while (count < stripped.length && stripped[count] === char)
+        count++;
+    if (count < 3)
+        return undefined;
+    return { char, count };
+}
+function isClosingFence(stripped, fenceChar, fenceCount) {
+    let i = 0;
+    while (i < stripped.length && stripped[i] === fenceChar)
+        i++;
+    if (i < fenceCount)
+        return false;
+    for (; i < stripped.length; i++) {
+        if (stripped[i] !== ' ' && stripped[i] !== '\t' && stripped[i] !== '\r')
+            return false;
+    }
+    return true;
 }
+export const ALL_HEADING_NAMES = ['h1', 'h2', 'h3', 'h4', 'h5', 'h6'];
 export const isJsxHeadingElement = (node) => {
     return (node.type === 'mdxJsxFlowElement' &&
         'name' in node &&
         typeof node.name === 'string' &&
-        HEADING_NAMES.includes(node.name));
+        ALL_HEADING_NAMES.includes(node.name));
 };

package/dist/navigation/getFirstPageFromNavigation.js

@@ -1,6 +1,7 @@
 import { divisions, } from '@mintlify/validation';
 import { replaceSlashIndex } from '../slug/replaceSlashIndex.js';
 import { checkNavAccess, isPage } from './index.js';
+import { prioritizeDefaultDivisionItem } from './prioritize-default-division-item.js';
 export function getFirstPageFromNavigation(node, userGroups, shouldCheckNavAccess = false, isPreview = false) {
     if (!node || typeof node !== 'object')
         return undefined;
@@ -44,7 +45,8 @@ export function getFirstPageFromNavigation(node, userGroups, shouldCheckNavAcces
         if (key in node) {
             const items = node[key];
             if (Array.isArray(items)) {
-                for (const item of items) {
+                const orderedItems = prioritizeDefaultDivisionItem(items, key);
+                for (const item of orderedItems) {
                     if (typeof item === 'object' && 'hidden' in item && item.hidden)
                         continue;
                     const page = getFirstPageFromNavigation(item, userGroups, shouldCheckNavAccess, isPreview);

package/dist/navigation/index.d.ts

@@ -6,3 +6,4 @@ export * from './generatePathToBreadcrumbsMapForDocsConfig.js';
 export * from './getAllPathsInDocsNav.js';
 export * from './checkNavAccess.js';
 export * from './getFirstPageFromNavConfig.js';
+export * from './prioritize-default-division-item.js';

package/dist/navigation/index.js

@@ -6,3 +6,4 @@ export * from './generatePathToBreadcrumbsMapForDocsConfig.js';
 export * from './getAllPathsInDocsNav.js';
 export * from './checkNavAccess.js';
 export * from './getFirstPageFromNavConfig.js';
+export * from './prioritize-default-division-item.js';

package/dist/navigation/prioritize-default-division-item.d.ts

@@ -0,0 +1 @@
+export declare function prioritizeDefaultDivisionItem<T>(items: T[], key: string): T[];

package/dist/navigation/prioritize-default-division-item.js

@@ -0,0 +1,12 @@
+const divisionsThatPrioritizeDefault = new Set(['languages', 'versions']);
+function isDefaultDivisionItem(value) {
+    return typeof value === 'object' && value !== null && 'default' in value;
+}
+export function prioritizeDefaultDivisionItem(items, key) {
+    if (!divisionsThatPrioritizeDefault.has(key))
+        return items;
+    const defaultItem = items.find((item) => isDefaultDivisionItem(item) && item.default);
+    if (!defaultItem)
+        return items;
+    return [defaultItem, ...items.filter((item) => item !== defaultItem)];
+}