@mintlify/common 1.0.852 → 1.0.854

package/dist/mdx/getMDXOptions.d.ts

@@ -10,6 +10,7 @@ type MDXOptionsData = {
     config?: Pick<DocsConfig, 'api' | '$schema'> | Pick<MintConfig, 'api' | '$schema'>;
     subdomain?: string;
     tailwindSelectors?: string[];
+    path?: string;
 };
 export declare const getMDXOptions: ({ data, remarkPlugins, rehypePlugins, mdxExtracts, }: {
     data: MDXOptionsData;

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, remarkUnwrapJsxHeadings, } from './plugins/index.js';
+import { rehypeCodeBlocks, rehypeDynamicTailwindCss, rehypeKeyboardSymbols, rehypeListItemText, rehypeMdxExtractEndpoint, rehypeMdxExtractExamples, rehypeParamFieldIds, rehypeRawComponents, rehypeTable, rehypeUnicodeIds, rehypeZoomImages, remarkExtractChangelogFilters, remarkExtractTableOfContents, remarkFrames, remarkComponentIds, remarkMdxInjectSnippets, remarkMdxRemoveUnusedVariables, remarkRemoveImports, remarkMdxExtractPanel, remarkResolveRelativeLinks, 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
@@ -14,6 +14,7 @@ export const getMDXOptions = ({ data, remarkPlugins = [], rehypePlugins = [], md
     return {
         remarkPlugins: [
             [remarkMdxInjectSnippets, data.snippetTreeMap],
+            [remarkResolveRelativeLinks, { path: data.path }],
             remarkPrompt,
             [remarkComponentIds, data.pageMetadata],
             remarkUnwrapJsxHeadings,

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

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

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

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

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

@@ -0,0 +1,6 @@
+import type { Root } from 'mdast';
+type Options = {
+    path?: string;
+};
+export declare const remarkResolveRelativeLinks: (options?: Options) => (tree: Root) => void;
+export {};

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

@@ -0,0 +1,48 @@
+import { posix } from 'path';
+import { visit } from 'unist-util-visit';
+const isRelative = (url) => url.startsWith('./') || url.startsWith('../');
+const resolveRelative = (baseDir, url) => {
+    // Preserve any fragment or query string verbatim.
+    const splitIndex = url.search(/[#?]/);
+    const pathPart = splitIndex === -1 ? url : url.slice(0, splitIndex);
+    const tail = splitIndex === -1 ? '' : url.slice(splitIndex);
+    const resolved = posix.normalize(posix.join(baseDir, pathPart));
+    const absolute = resolved.startsWith('/') && !resolved.startsWith('//') ? resolved : `/${resolved}`;
+    return absolute + tail;
+};
+const ATTR_BY_TAG = {
+    a: 'href',
+    Card: 'href',
+    img: 'src',
+    source: 'src',
+};
+export const remarkResolveRelativeLinks = (options = {}) => {
+    return (tree) => {
+        const { path } = options;
+        if (!path)
+            return;
+        const stripped = path.replace(/^\/+/, '').replace(/\.mdx?$/i, '');
+        const dir = posix.dirname(stripped);
+        const baseDir = dir === '.' || dir === '' ? '/' : `/${dir}`;
+        visit(tree, (node) => {
+            if (node.type === 'link' || node.type === 'image') {
+                const linkOrImg = node;
+                if (linkOrImg.url && isRelative(linkOrImg.url)) {
+                    linkOrImg.url = resolveRelative(baseDir, linkOrImg.url);
+                }
+                return;
+            }
+            if (node.type !== 'mdxJsxFlowElement' && node.type !== 'mdxJsxTextElement') {
+                return;
+            }
+            const jsxNode = node;
+            const attrName = jsxNode.name ? ATTR_BY_TAG[jsxNode.name] : undefined;
+            if (!attrName)
+                return;
+            const attr = jsxNode.attributes.find((a) => a.type === 'mdxJsxAttribute' && a.name === attrName);
+            if (attr && 'value' in attr && typeof attr.value === 'string' && isRelative(attr.value)) {
+                attr.value = resolveRelative(baseDir, attr.value);
+            }
+        });
+    };
+};

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

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

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

@@ -0,0 +1,46 @@
+function isMdxJsxElement(node) {
+    return node.type === 'mdxJsxFlowElement' || node.type === 'mdxJsxTextElement';
+}
+function getVisibilityFor(node) {
+    for (const attr of node.attributes) {
+        if (attr.type !== 'mdxJsxAttribute' || attr.name !== 'for')
+            continue;
+        if (typeof attr.value === 'string') {
+            if (attr.value === 'humans' || attr.value === 'agents')
+                return attr.value;
+            continue;
+        }
+        if (attr.value &&
+            typeof attr.value === 'object' &&
+            'value' in attr.value &&
+            typeof attr.value.value === 'string') {
+            const raw = attr.value.value.trim();
+            const quoted = raw.match(/^(["'])(humans|agents)\1$/);
+            if (quoted)
+                return quoted[2];
+        }
+    }
+    return undefined;
+}
+function transformChildren(children) {
+    return children.flatMap((child) => transformNode(child));
+}
+function transformNode(node) {
+    if (isMdxJsxElement(node) && node.name === 'Visibility') {
+        const audience = getVisibilityFor(node);
+        if (audience === 'humans') {
+            return [];
+        }
+        if (audience === 'agents') {
+            return transformChildren(node.children);
+        }
+    }
+    if ('children' in node && Array.isArray(node.children)) {
+        const next = transformChildren(node.children);
+        node.children = next;
+    }
+    return [node];
+}
+export const remarkVisibilityForMarkdown = () => (tree) => {
+    tree.children = transformChildren(tree.children);
+};

package/dist/mdx/remark.d.ts

@@ -4,3 +4,4 @@ export declare const coreRemarkMdxPlugins: PluggableList;
 export declare const coreRemark: import("unified").Processor<Root, undefined, undefined, Root, string>;
 export declare const getAST: (str: string, filePath?: string) => Root;
 export declare const stringifyTree: (tree: Root) => string;
+export declare function stripVisibilityForMarkdown(mdx: string): string;

package/dist/mdx/remark.js

@@ -4,6 +4,7 @@ import remarkGfm from 'remark-gfm';
 import remarkMath from 'remark-math';
 import remarkMdx from 'remark-mdx';
 import remarkStringify from 'remark-stringify';
+import { remarkVisibilityForMarkdown } from './plugins/remark/remarkVisibilityForMarkdown.js';
 import { preprocessCustomHeadingIds } from './preprocessCustomHeadingIds.js';
 import { getJsxEsmTree } from './snippets/getJsxEsmTree.js';
 import { isJsxOrTsx } from './snippets/isJsxOrTsx.js';
@@ -21,3 +22,8 @@ export const getAST = (str, filePath) => {
     return coreRemark().parse(preprocessCustomHeadingIds(str));
 };
 export const stringifyTree = (tree) => coreRemark().use(remarkStringify).stringify(tree);
+export function stripVisibilityForMarkdown(mdx) {
+    const tree = getAST(mdx);
+    remarkVisibilityForMarkdown()(tree);
+    return stringifyTree(tree);
+}

package/dist/mdx/server-only/getMdx.js

@@ -29,6 +29,7 @@ export function getMdx(_a) {
             config,
             codeStyling,
             tailwindSelectors,
+            path,
         };
         let mdxExtracts = {};
         let plugins = [remarkValidateSteps, remarkValidateTabs, ...remarkPlugins];