@mintlify/common 1.0.1082 → 1.0.1084

package/dist/mdx/getMDXOptions.js

@@ -1,4 +1,4 @@
-import { rehypeCodeBlocks, rehypeDynamicTailwindCss, rehypeKeyboardSymbols, rehypeListItemText, rehypeMdxExtractEndpoint, rehypeMdxExtractExamples, rehypeParamFieldIds, rehypeRawComponents, rehypeTable, rehypeUnicodeIds, rehypeZoomImages, remarkExtractChangelogFilters, remarkExtractTableOfContents, remarkFileTree, remarkFrames, remarkComponentIds, remarkMdxInjectSnippets, remarkMdxRemoveUnusedVariables, remarkRemoveImports, remarkMdxExtractPanel, remarkResolveRelativeLinks, remarkVideo, remarkMdxClientComponentBoundaries, remarkExtractMultiView, remarkPrompt, remarkUnwrapInlineJsx, remarkUnwrapJsxHeadings, } from './plugins/index.js';
+import { rehypeCodeBlocks, rehypeDynamicTailwindCss, rehypeKeyboardSymbols, rehypeListItemText, rehypeMdxExtractEndpoint, rehypeMdxExtractExamples, rehypeParamFieldIds, rehypeRawComponents, rehypeTable, rehypeUnicodeIds, rehypeZoomImages, remarkExtractChangelogFilters, remarkExtractTableOfContents, remarkFileTree, remarkFrames, remarkComponentIds, remarkMdxInjectSnippets, remarkMdxRemoveUnusedVariables, remarkRemoveImports, remarkMdxExtractPanel, remarkResolveRelativeLinks, remarkVideo, remarkMdxClientComponentBoundaries, remarkExtractMultiView, remarkPrompt, remarkUnwrapInlineJsx, remarkUnwrapJsxHeadings, remarkMapExplicitAnchors, } from './plugins/index.js';
 import { remarkMdxRemoveUnknownJsx } from './plugins/remark/remarkMdxRemoveUnknownJsx/index.js';
 import { remarkMermaid } from './plugins/remark/remarkMermaid.js';
 // avoid running extractors unnecessarily
@@ -30,6 +30,7 @@ export const getMDXOptions = ({ data, remarkPlugins = [], rehypePlugins = [], md
             remarkMermaid,
             remarkVideo,
             ...remarkPlugins,
+            remarkMapExplicitAnchors,
             [remarkMdxRemoveUnknownJsx, { allowlist: allowedComponents }],
             remarkMdxClientComponentBoundaries,
         ],

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

@@ -23,6 +23,7 @@ export * from './remarkVideo.js';
 export * from './remarkExtractMultiView.js';
 export * from './remarkPrompt.js';
 export * from './remarkResolveRelativeLinks.js';
+export * from './remarkMapExplicitAnchors.js';
 export * from './remarkUnwrapInlineJsx.js';
 export * from './remarkUnwrapJsxHeadings.js';
 export * from './remarkVisibilityForMarkdown.js';

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

@@ -23,6 +23,7 @@ export * from './remarkVideo.js';
 export * from './remarkExtractMultiView.js';
 export * from './remarkPrompt.js';
 export * from './remarkResolveRelativeLinks.js';
+export * from './remarkMapExplicitAnchors.js';
 export * from './remarkUnwrapInlineJsx.js';
 export * from './remarkUnwrapJsxHeadings.js';
 export * from './remarkVisibilityForMarkdown.js';

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

@@ -0,0 +1,2 @@
+import type { Root } from 'mdast';
+export declare const remarkMapExplicitAnchors: () => (tree: Root) => void;

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

@@ -0,0 +1,87 @@
+import { walk } from 'estree-walker';
+import { visit } from 'unist-util-visit';
+// `remarkMarkAndUnravel` flags author-written JSX with `_mdxExplicitJsx`, and `recmaJsxRewrite`
+// leaves flagged elements as intrinsics instead of resolving them through the components map.
+// Clearing the flag for `a` keeps `<a href="/page">` equivalent to `[page](/page)`, so both render
+// through DynamicLink and pick up client-side routing and the deployment base path.
+const EXPLICIT_JSX_DATA_KEY = '_mdxExplicitJsx';
+const MAPPED_TAGS = new Set(['a']);
+const unmarkExplicitJsx = (node) => {
+    if (node.data)
+        delete node.data[EXPLICIT_JSX_DATA_KEY];
+};
+// Only anchors that need DynamicLink are rerouted: absolute internal hrefs (the ones that must pick
+// up the base path) and dynamic hrefs we cannot read at compile time. Anchors with no href, a bare
+// relative href, a hash, or an external href already render correctly as intrinsics, and routing
+// them would hand them to DynamicLink's external branch (new tab + link styling).
+const isAbsoluteInternalHref = (value) => value.startsWith('/') && !value.startsWith('//');
+const unmarkJsxElement = (node) => {
+    if (!node.name || !MAPPED_TAGS.has(node.name))
+        return;
+    let hasSpread = false;
+    for (const attribute of node.attributes) {
+        if (attribute.type === 'mdxJsxExpressionAttribute') {
+            hasSpread = true;
+            continue;
+        }
+        if (attribute.name !== 'href')
+            continue;
+        if (typeof attribute.value === 'string') {
+            if (isAbsoluteInternalHref(attribute.value))
+                unmarkExplicitJsx(node);
+            return;
+        }
+        if (attribute.value)
+            unmarkExplicitJsx(node);
+        return;
+    }
+    if (hasSpread)
+        unmarkExplicitJsx(node);
+};
+export const remarkMapExplicitAnchors = () => {
+    return (tree) => {
+        visit(tree, 'mdxJsxFlowElement', unmarkJsxElement);
+        visit(tree, 'mdxJsxTextElement', unmarkJsxElement);
+        // `remarkMarkAndUnravel` walks the estree of expression nodes as well as ESM, so
+        // `{items.map((i) => <a href={i.href} />)}` needs the same treatment as an exported component.
+        const unmarkEstreeAnchors = (node) => {
+            var _a;
+            const estree = (_a = node.data) === null || _a === void 0 ? void 0 : _a.estree;
+            if (!estree)
+                return;
+            walk(estree, {
+                enter(estreeNode) {
+                    if (estreeNode.type !== 'JSXElement')
+                        return;
+                    const name = estreeNode.openingElement.name;
+                    if (name.type !== 'JSXIdentifier' || !MAPPED_TAGS.has(name.name))
+                        return;
+                    let hasSpread = false;
+                    for (const attribute of estreeNode.openingElement.attributes) {
+                        if (attribute.type === 'JSXSpreadAttribute') {
+                            hasSpread = true;
+                            continue;
+                        }
+                        if (attribute.name.type !== 'JSXIdentifier' || attribute.name.name !== 'href')
+                            continue;
+                        const value = attribute.value;
+                        if ((value === null || value === void 0 ? void 0 : value.type) === 'Literal') {
+                            if (typeof value.value === 'string' && isAbsoluteInternalHref(value.value)) {
+                                unmarkExplicitJsx(estreeNode);
+                            }
+                            return;
+                        }
+                        if (value)
+                            unmarkExplicitJsx(estreeNode);
+                        return;
+                    }
+                    if (hasSpread)
+                        unmarkExplicitJsx(estreeNode);
+                },
+            });
+        };
+        visit(tree, 'mdxjsEsm', unmarkEstreeAnchors);
+        visit(tree, 'mdxFlowExpression', unmarkEstreeAnchors);
+        visit(tree, 'mdxTextExpression', unmarkEstreeAnchors);
+    };
+};