@mintlify/common 1.0.1278 → 1.0.1279

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

@@ -34,3 +34,4 @@ export { TITLE_COMPONENTS } from './remarkTitleMarkdown.js';
 export * from './remarkUserMentions.js';
 export * from './remarkVisibilityForMarkdown.js';
 export * from './pureTemplateComponents.js';
+export * from './remarkPrefixMediaBasePath.js';

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

@@ -34,3 +34,4 @@ export { TITLE_COMPONENTS } from './remarkTitleMarkdown.js';
 export * from './remarkUserMentions.js';
 export * from './remarkVisibilityForMarkdown.js';
 export * from './pureTemplateComponents.js';
+export * from './remarkPrefixMediaBasePath.js';

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

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

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

@@ -0,0 +1,35 @@
+import { visit } from 'unist-util-visit';
+const MEDIA_ATTRIBUTES = new Set(['src', 'srcSet', 'srcset', 'poster', 'img', 'image']);
+const prefix = (value, basePath) => value.startsWith('/') && !value.startsWith('//') ? `${basePath}${value}` : value;
+const prefixSrcSet = (value, basePath) => value
+    .split(',')
+    .map((candidate) => {
+    const trimmed = candidate.trim();
+    const [url = '', ...descriptors] = trimmed.split(/\s+/);
+    return [prefix(url, basePath), ...descriptors].join(' ');
+})
+    .join(', ');
+export const remarkPrefixMediaBasePath = ({ basePath }) => {
+    return (tree) => {
+        if (!basePath)
+            return;
+        visit(tree, 'image', (node) => {
+            node.url = prefix(node.url, basePath);
+        });
+        const prefixAttributes = (element) => {
+            for (const attribute of element.attributes) {
+                if (attribute.type !== 'mdxJsxAttribute' ||
+                    !MEDIA_ATTRIBUTES.has(attribute.name) ||
+                    typeof attribute.value !== 'string') {
+                    continue;
+                }
+                attribute.value =
+                    attribute.name.toLowerCase() === 'srcset'
+                        ? prefixSrcSet(attribute.value, basePath)
+                        : prefix(attribute.value, basePath);
+            }
+        };
+        visit(tree, 'mdxJsxFlowElement', (node) => prefixAttributes(node));
+        visit(tree, 'mdxJsxTextElement', (node) => prefixAttributes(node));
+    };
+};

package/dist/mdx/plugins/remark/remarkPrefixMediaBasePath.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/mdx/plugins/remark/remarkPrefixMediaBasePath.test.js

@@ -0,0 +1,45 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { remark } from 'remark';
+import remarkMdx from 'remark-mdx';
+import { describe, expect, it } from 'vitest';
+import { remarkPrefixMediaBasePath } from './remarkPrefixMediaBasePath.js';
+const run = (mdx, basePath) => __awaiter(void 0, void 0, void 0, function* () {
+    return String(yield remark().use(remarkMdx).use(remarkPrefixMediaBasePath, { basePath }).process(mdx)).trim();
+});
+describe('remarkPrefixMediaBasePath', () => {
+    it('prefixes root-relative markdown images and media attributes', () => __awaiter(void 0, void 0, void 0, function* () {
+        const output = yield run([
+            '![Logo](/images/logo.png)',
+            '',
+            '<img src="/images/a.png" srcSet="/images/a.png 1x, /images/a@2x.png 2x" />',
+            '',
+            '<video src="/videos/demo.mp4" poster="/images/poster.png" />',
+            '',
+            '<Card title="Card" img="/images/card.png" href="/quickstart" />',
+        ].join('\n'), '/docs');
+        expect(output).toContain('![Logo](/docs/images/logo.png)');
+        expect(output).toContain('src="/docs/images/a.png"');
+        expect(output).toContain('srcSet="/docs/images/a.png 1x, /docs/images/a@2x.png 2x"');
+        expect(output).toContain('src="/docs/videos/demo.mp4"');
+        expect(output).toContain('poster="/docs/images/poster.png"');
+        expect(output).toContain('img="/docs/images/card.png"');
+        expect(output).toContain('href="/quickstart"');
+    }));
+    it('leaves external, protocol-relative and data urls alone', () => __awaiter(void 0, void 0, void 0, function* () {
+        const output = yield run('![a](https://example.com/a.png) <img src="//cdn.example.com/b.png" /> <img src="data:image/png;base64,AA" />', '/docs');
+        expect(output).toContain('(https://example.com/a.png)');
+        expect(output).toContain('src="//cdn.example.com/b.png"');
+        expect(output).toContain('src="data:image/png;base64,AA"');
+    }));
+    it('is a no-op without a base path', () => __awaiter(void 0, void 0, void 0, function* () {
+        expect(yield run('![Logo](/images/logo.png)', '')).toBe('![Logo](/images/logo.png)');
+    }));
+});