@mintlify/common 1.0.1016 → 1.0.1018

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

@@ -1,6 +1,7 @@
 import { visit } from 'unist-util-visit';
-import { slugify } from '../../../slugify.js';
+import { safeCleanHeadingId, slugify } from '../../../slugify.js';
 import { createMdxJsxAttribute, getTableOfContentsTitle } from '../../lib/remark-utils.js';
+import { isMdxJsxFragment } from '../../utils.js';
 import { AVOIDED_PAGE_MODES, HEADING_LEVELS } from './remarkComponentIds.js';
 export const HEADING_NAMES = ['h1', 'h2', 'h3', 'h4'];
 const COMPONENTS_TO_EXCLUDE_HEADINGS = [
@@ -55,15 +56,25 @@ export const remarkExtractTableOfContents = (mdxExtracts, pageMetadata) => {
             if (node.type === 'mdxJsxFlowElement' && node.name === 'Steps') {
                 const stepsTitleSize = getStringAttribute(node.attributes, 'titleSize');
                 if (stepsTitleSize) {
-                    // At render time <Steps> only forwards titleSize to its immediate
-                    // child <Step>s, so mirror that here. Assigning to every descendant
-                    // would leak the value into a nested <Steps> and its own steps even
-                    // when that inner wrapper sets no (or a different) titleSize.
-                    for (const childNode of node.children) {
-                        if (childNode.type === 'mdxJsxFlowElement' && childNode.name === 'Step') {
-                            inheritedStepTitleSizeMap.set(childNode, stepsTitleSize);
+                    // At render time <Steps> forwards titleSize to its immediate child
+                    // <Step>s and flattens fragments, so mirror both here. Fragments
+                    // parse as name-less mdxJsxFlowElements and are transparent;
+                    // assigning to every descendant would leak the value into a nested
+                    // <Steps> and its own steps even when that inner wrapper sets no
+                    // (or a different) titleSize.
+                    const assignInheritedTitleSize = (children) => {
+                        for (const childNode of children) {
+                            if (childNode.type !== 'mdxJsxFlowElement')
+                                continue;
+                            if (childNode.name === 'Step') {
+                                inheritedStepTitleSizeMap.set(childNode, stepsTitleSize);
+                            }
+                            else if (isMdxJsxFragment(childNode)) {
+                                assignInheritedTitleSize(childNode.children);
+                            }
                         }
-                    }
+                    };
+                    assignInheritedTitleSize(node.children);
                 }
             }
             if (node.type === 'mdxJsxFlowElement' && node.name === 'Tab') {
@@ -100,8 +111,15 @@ export const remarkExtractTableOfContents = (mdxExtracts, pageMetadata) => {
             const stepTitleSize = node.type === 'mdxJsxFlowElement' && node.name === 'Step'
                 ? ((_b = getStringAttribute(node.attributes, 'titleSize')) !== null && _b !== void 0 ? _b : inheritedStepTitleSizeMap.get(node))
                 : undefined;
+            const hasNoAnchor = node.type === 'mdxJsxFlowElement' &&
+                node.attributes.some((attr) => 'name' in attr &&
+                    attr.name === 'noAnchor' &&
+                    (attr.value == null ||
+                        attr.value === 'true' ||
+                        (typeof attr.value === 'object' && attr.value.value === 'true')));
             const isValidStep = node.type === 'mdxJsxFlowElement' &&
                 node.name === 'Step' &&
+                !hasNoAnchor &&
                 ['h2', 'h3'].includes(stepTitleSize !== null && stepTitleSize !== void 0 ? stepTitleSize : '') &&
                 ((_d = (_c = getStringAttribute(node.attributes, 'title')) === null || _c === void 0 ? void 0 : _c.trim()) !== null && _d !== void 0 ? _d : '') !== '';
             const hasIdAttribute = node.type === 'mdxJsxFlowElement' &&
@@ -159,7 +177,7 @@ export const remarkExtractTableOfContents = (mdxExtracts, pageMetadata) => {
                 ? getStringAttribute(node.attributes, 'id')
                 : undefined;
             if (explicitId) {
-                slug = deduplicateSlug(explicitId);
+                slug = deduplicateSlug(safeCleanHeadingId(explicitId) || slugify(title));
             }
             else {
                 slug = deduplicateSlug(slugify(title));

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

@@ -1,11 +1,15 @@
-import { visit } from 'unist-util-visit';
+import { visitParents } from 'unist-util-visit-parents';
+import { isMdxJsxFlowElement, isMdxJsxFragment } from '../../utils.js';
 export const remarkValidateSteps = () => (tree) => {
-    visit(tree, 'mdxJsxFlowElement', (node, _idx, parent) => {
-        if (node.name === 'Step') {
-            const parentElement = parent;
-            if (!parentElement || parentElement.name !== 'Steps') {
-                console.warn('Please ensure that all <Step> components are direct children of <Steps>.');
-            }
+    visitParents(tree, 'mdxJsxFlowElement', (node, ancestors) => {
+        if (node.name !== 'Step')
+            return;
+        // Fragments are transparent: <Steps> flattens them at render time.
+        const meaningfulAncestors = ancestors.filter((ancestor) => !isMdxJsxFragment(ancestor));
+        const parent = meaningfulAncestors[meaningfulAncestors.length - 1];
+        const parentIsSteps = parent !== undefined && isMdxJsxFlowElement(parent) && parent.name === 'Steps';
+        if (!parentIsSteps) {
+            console.warn('Please ensure that all <Step> components are direct children of <Steps>.');
         }
     });
 };

package/dist/mdx/utils.d.ts

@@ -13,6 +13,7 @@ export declare const isImportDeclaration: (bodyChild: MdxNodeBodyChildType) => b
 export declare const isExport: (type: string) => boolean;
 export declare const isExportNode: (bodyChild: MdxNodeBodyChildType) => bodyChild is ExportAllDeclaration | ExportDefaultDeclaration | ExportNamedDeclaration;
 export declare const isMdxJsxFlowElement: (node: Node) => node is MdxJsxFlowElement;
+export declare const isMdxJsxFragment: (node: Node) => node is MdxJsxFlowElement;
 export declare const createUniqueVariableName: (variableName: string, id: number) => string;
 export declare const getObjectExpressionStringProperty: (key: string, attribute: MdxJsxAttribute | MdxJsxExpressionAttribute | undefined) => string | undefined;
 export declare const getArrayExpressionStringProperties: (attribute: MdxJsxAttribute | MdxJsxExpressionAttribute | undefined) => string[];

package/dist/mdx/utils.js

@@ -11,6 +11,7 @@ export const isExport = (type) => [
 ].includes(type);
 export const isExportNode = (bodyChild) => isExport(bodyChild.type);
 export const isMdxJsxFlowElement = (node) => node.type === 'mdxJsxFlowElement';
+export const isMdxJsxFragment = (node) => isMdxJsxFlowElement(node) && node.name == null;
 export const createUniqueVariableName = (variableName, id) => `${variableName}_${id}`;
 export const getObjectExpressionStringProperty = (key, attribute) => {
     var _a, _b, _c;

package/dist/slugify.d.ts

@@ -1,3 +1,4 @@
 import { CountableSlugify } from '@sindresorhus/slugify';
 export declare const cleanHeadingId: (id: string) => string;
+export declare const safeCleanHeadingId: (id: string) => string;
 export declare function slugify(string: string, slugify?: CountableSlugify): string;

package/dist/slugify.js

@@ -8,6 +8,16 @@ export const cleanHeadingId = (id) => {
         .replace(/[?,;:!'"()[\]{}]/g, '')
         .replace(/\p{Emoji_Modifier}|\p{Emoji_Modifier_Base}|\p{Emoji_Presentation}|\p{Extended_Pictographic}|[\u200D\uFE0E\uFE0F]/gu, '');
 };
+// decodeURIComponent throws on malformed percent sequences (e.g. an author id
+// of "100%1"); fall back to the raw id instead of crashing the render/compile
+export const safeCleanHeadingId = (id) => {
+    try {
+        return cleanHeadingId(id);
+    }
+    catch (_a) {
+        return id;
+    }
+};
 export function slugify(string, slugify = slugifyWithCounter()) {
     const encodedString = getUnicodeId(string);
     // if encoded title is already percent-encoded, return it as is