@mintlify/common 1.0.1150 → 1.0.1151

package/dist/mdx/getMDXOptions.d.ts

@@ -12,9 +12,10 @@ type MDXOptionsData = {
     tailwindSelectors?: string[];
     path?: string;
 };
-export declare const getMDXOptions: ({ data, remarkPlugins, rehypePlugins, mdxExtracts, allowedComponents, fragmentPlugins, }: {
+export declare const getMDXOptions: ({ data, remarkPlugins, earlyRemarkPlugins, rehypePlugins, mdxExtracts, allowedComponents, fragmentPlugins, }: {
     data: MDXOptionsData;
     remarkPlugins?: PluggableList;
+    earlyRemarkPlugins?: PluggableList;
     rehypePlugins?: PluggableList;
     mdxExtracts?: MdxExtracts;
     allowedComponents?: string[];

package/dist/mdx/getMDXOptions.js

@@ -13,7 +13,7 @@ const rehypeExtractors = (mdxExtracts, data) => {
         [rehypeMdxExtractEndpoint, data.pageMetadata, data.config, mdxExtracts],
     ];
 };
-export const getMDXOptions = ({ data, remarkPlugins = [], rehypePlugins = [], mdxExtracts, allowedComponents = [], fragmentPlugins, }) => {
+export const getMDXOptions = ({ data, remarkPlugins = [], earlyRemarkPlugins = [], rehypePlugins = [], mdxExtracts, allowedComponents = [], fragmentPlugins, }) => {
     // `fragment`: the list is compiling the body of an `<MDX>` inside an expression. Page-level
     // extractors that hoist an element out of the tree (`<Panel>`, `<RequestExample>`,
     // `<ResponseExample>`) are skipped there so the element stays in its branch and renders inline
@@ -36,10 +36,11 @@ export const getMDXOptions = ({ data, remarkPlugins = [], rehypePlugins = [], md
                     budget,
                 },
             ],
+            remarkPrompt,
+            ...earlyRemarkPlugins,
             remarkMdxStyleStringToObject,
             [remarkResolveRelativeLinks, { path: data.path }],
             remarkParseTitleMarkdown,
-            remarkPrompt,
             [remarkComponentIds, data.pageMetadata],
             remarkUnwrapJsxHeadings,
             remarkUnwrapInlineJsx,

package/dist/mdx/index.d.ts

@@ -1,4 +1,5 @@
 export * from './remark.js';
+export * from './mentions/index.js';
 export * from './snippets/index.js';
 export * from './utils.js';
 export * from './plugins/index.js';

package/dist/mdx/index.js

@@ -1,4 +1,5 @@
 export * from './remark.js';
+export * from './mentions/index.js';
 export * from './snippets/index.js';
 export * from './utils.js';
 export * from './plugins/index.js';

package/dist/mdx/mentions/index.d.ts

@@ -0,0 +1 @@
+export * from './userMentionToken.js';

package/dist/mdx/mentions/index.js

@@ -0,0 +1 @@
+export * from './userMentionToken.js';

package/dist/mdx/mentions/userMentionToken.d.ts

@@ -0,0 +1,22 @@
+export declare const USER_MENTION_ID_SOURCE = "[0-9a-fA-F]{24}";
+export declare function userMentionTokenPattern({ inText }?: TokenScanOptions): RegExp;
+export type TokenScanOptions = {
+    inText?: boolean;
+};
+export declare const UNKNOWN_USER_LABEL = "Unknown user";
+export declare const MAX_USER_MENTION_IDS = 1000;
+export declare const MENTION_TEXT_ATTRIBUTES: ReadonlySet<string>;
+export declare function isMentionTextAttribute(name: string): boolean;
+export type UserMentionNameResolver = (userId: string) => string | undefined;
+export type UserMentionTokenMatch = {
+    start: number;
+    end: number;
+    userId: string;
+};
+export declare function isUserMentionId(value: string): boolean;
+export declare function userMentionToken(userId: string): string;
+export declare function findUserMentionTokens(text: string, options?: TokenScanOptions): UserMentionTokenMatch[];
+export declare function hasUserMentionTokens(text: string, options?: TokenScanOptions): boolean;
+export declare function extractUserMentionIds(text: string, options?: TokenScanOptions): string[];
+export declare function flattenUserMentionTokens(text: string, resolve?: UserMentionNameResolver, options?: TokenScanOptions): string;
+export declare function escapeMentionNameForSource(name: string): string;

package/dist/mdx/mentions/userMentionToken.js

@@ -0,0 +1,77 @@
+export const USER_MENTION_ID_SOURCE = '[0-9a-fA-F]{24}';
+const USER_MENTION_ID_EXACT = new RegExp(`^${USER_MENTION_ID_SOURCE}$`);
+// Ingest re-stringifies pages and escapes the bracket, so in raw source `@\\[id]` is the same token.
+export function userMentionTokenPattern({ inText = false } = {}) {
+    return new RegExp(`@${inText ? '' : '\\\\?'}\\[(${USER_MENTION_ID_SOURCE})\\]`, 'g');
+}
+export const UNKNOWN_USER_LABEL = 'Unknown user';
+export const MAX_USER_MENTION_IDS = 1000;
+// Component string attributes that render as text. HTML attributes (alt, src, href, id, className...) are left as written.
+export const MENTION_TEXT_ATTRIBUTES = new Set([
+    'title',
+    'description',
+    'label',
+    'caption',
+    'subtitle',
+    'placeholder',
+    'tip',
+    'headline',
+    'text',
+    'cta',
+    'children',
+    'summary',
+    'heading',
+]);
+export function isMentionTextAttribute(name) {
+    return MENTION_TEXT_ATTRIBUTES.has(name);
+}
+export function isUserMentionId(value) {
+    return USER_MENTION_ID_EXACT.test(value);
+}
+export function userMentionToken(userId) {
+    return `@[${userId}]`;
+}
+export function findUserMentionTokens(text, options) {
+    const matches = [];
+    const pattern = userMentionTokenPattern(options);
+    for (let match = pattern.exec(text); match !== null; match = pattern.exec(text)) {
+        const userId = match[1];
+        if (userId === undefined)
+            continue;
+        matches.push({
+            start: match.index,
+            end: match.index + match[0].length,
+            userId: userId.toLowerCase(),
+        });
+    }
+    return matches;
+}
+export function hasUserMentionTokens(text, options) {
+    return userMentionTokenPattern(options).test(text);
+}
+export function extractUserMentionIds(text, options) {
+    const ids = new Set();
+    const pattern = userMentionTokenPattern(options);
+    for (let match = pattern.exec(text); match !== null; match = pattern.exec(text)) {
+        const userId = match[1];
+        if (userId === undefined)
+            continue;
+        ids.add(userId.toLowerCase());
+        if (ids.size === MAX_USER_MENTION_IDS)
+            break;
+    }
+    return [...ids];
+}
+export function flattenUserMentionTokens(text, resolve, options) {
+    return text.replace(userMentionTokenPattern(options), (_token, userId) => {
+        var _a;
+        const name = (_a = resolve === null || resolve === void 0 ? void 0 : resolve(userId.toLowerCase())) === null || _a === void 0 ? void 0 : _a.trim();
+        return name ? name : UNKNOWN_USER_LABEL;
+    });
+}
+export function escapeMentionNameForSource(name) {
+    return name
+        .replace(/\s*\n\s*/g, ' ')
+        .replaceAll('&', '&')
+        .replace(/([\\`*_{}[\]<>~|$])/g, '\\$1');
+}

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

@@ -29,4 +29,6 @@ export * from './remarkResolveRelativeLinks.js';
 export * from './remarkMapExplicitAnchors.js';
 export * from './remarkUnwrapInlineJsx.js';
 export * from './remarkUnwrapJsxHeadings.js';
+export { TITLE_COMPONENTS } from './remarkTitleMarkdown.js';
+export * from './remarkUserMentions.js';
 export * from './remarkVisibilityForMarkdown.js';

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

@@ -29,4 +29,6 @@ export * from './remarkResolveRelativeLinks.js';
 export * from './remarkMapExplicitAnchors.js';
 export * from './remarkUnwrapInlineJsx.js';
 export * from './remarkUnwrapJsxHeadings.js';
+export { TITLE_COMPONENTS } from './remarkTitleMarkdown.js';
+export * from './remarkUserMentions.js';
 export * from './remarkVisibilityForMarkdown.js';

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

@@ -1,4 +1,4 @@
 import type { Root } from 'mdast';
 export declare const remarkMdxRemoveUnknownJsx: ({ allowlist }?: {
     allowlist?: string[];
-}) => (tree: Root) => Root | import("mdast").Link | import("mdast").Delete | import("mdast").Code | import("mdast-util-mdx").MdxJsxFlowElement | import("mdast-util-mdx").MdxJsxTextElement | import("mdast").Blockquote | import("mdast").Break | import("mdast").Definition | import("mdast").Emphasis | import("mdast").FootnoteDefinition | import("mdast").FootnoteReference | import("mdast").Heading | import("mdast").Html | import("mdast").Image | import("mdast").ImageReference | import("mdast").InlineCode | import("mdast").LinkReference | import("mdast").List | import("mdast").ListItem | import("mdast").Paragraph | import("mdast").Strong | import("mdast").Table | import("mdast").TableCell | import("mdast").TableRow | import("mdast").Text | import("mdast").ThematicBreak | import("mdast").Yaml | import("mdast-util-math").InlineMath | import("mdast-util-math").Math | import("mdast-util-mdx-expression").MdxTextExpression | import("mdast-util-mdx-expression").MdxFlowExpression | import("mdast-util-mdxjs-esm").MdxjsEsm;
+}) => (tree: Root) => Root | import("mdast").Link | import("mdast").Delete | import("mdast").Code | import("mdast").Text | import("mdast").Heading | import("mdast-util-mdx").MdxJsxFlowElement | import("mdast-util-mdx").MdxJsxTextElement | import("mdast").Blockquote | import("mdast").Break | import("mdast").Definition | import("mdast").Emphasis | import("mdast").FootnoteDefinition | import("mdast").FootnoteReference | import("mdast").Html | import("mdast").Image | import("mdast").ImageReference | import("mdast").InlineCode | import("mdast").LinkReference | import("mdast").List | import("mdast").ListItem | import("mdast").Paragraph | import("mdast").Strong | import("mdast").Table | import("mdast").TableCell | import("mdast").TableRow | import("mdast").ThematicBreak | import("mdast").Yaml | import("mdast-util-math").InlineMath | import("mdast-util-math").Math | import("mdast-util-mdx-expression").MdxTextExpression | import("mdast-util-mdx-expression").MdxFlowExpression | import("mdast-util-mdxjs-esm").MdxjsEsm;

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

@@ -1,3 +1,13 @@
 import type { Root } from 'mdast';
 import type { VFile } from 'vfile';
+declare module 'mdast-util-mdx-jsx' {
+    interface MdxJsxAttributeData {
+        promptBodySource?: boolean;
+    }
+}
+export declare const isPromptBodySourceAttribute: (attribute: {
+    data?: {
+        promptBodySource?: boolean;
+    };
+}) => boolean;
 export declare const remarkPrompt: () => (tree: Root, file: VFile) => void;

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

@@ -1,4 +1,5 @@
 import { visit } from 'unist-util-visit';
+export const isPromptBodySourceAttribute = (attribute) => { var _a; return ((_a = attribute.data) === null || _a === void 0 ? void 0 : _a.promptBodySource) === true; };
 const dedent = (text) => {
     const lines = text.split('\n');
     const indents = lines
@@ -62,6 +63,7 @@ export const remarkPrompt = () => {
             node.attributes.push({
                 type: 'mdxJsxAttribute',
                 name: 'children',
+                data: { promptBodySource: true },
                 value: {
                     type: 'mdxJsxAttributeValueExpression',
                     value: JSON.stringify(trimmedContent),

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

@@ -1,3 +1,4 @@
 import type { Root } from 'mdast';
+export declare const TITLE_COMPONENTS: ReadonlySet<string>;
 export declare const remarkParseTitleMarkdown: () => (tree: Root) => void;
 export declare const remarkRenderTitleMarkdown: () => (tree: Root) => void;

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

@@ -3,7 +3,14 @@ import jsx from 'acorn-jsx';
 import { visit } from 'unist-util-visit';
 import { parseTitleMarkdown, titleMarkdownToText } from '../../titleMarkdown.js';
 const JSXParser = Parser.extend(jsx());
-const TITLE_COMPONENTS = new Set(['Accordion', 'Card', 'Color.Row', 'Step', 'Tab', 'Tile']);
+export const TITLE_COMPONENTS = new Set([
+    'Accordion',
+    'Card',
+    'Color.Row',
+    'Step',
+    'Tab',
+    'Tile',
+]);
 const TITLE_DATA_KEY = 'mintlifyTitleMarkdown';
 function nodeJsx(node) {
     if (node.type === 'text')

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

@@ -0,0 +1,6 @@
+import type { Root } from 'mdast';
+import { type UserMentionNameResolver } from '../../mentions/userMentionToken.js';
+export type RemarkUserMentionsOptions = {
+    resolveUserName?: UserMentionNameResolver;
+};
+export declare const remarkUserMentions: ({ resolveUserName }?: RemarkUserMentionsOptions) => (tree: Root) => void;

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

@@ -0,0 +1,107 @@
+import { visit } from 'unist-util-visit';
+import { escapeMentionNameForSource, flattenUserMentionTokens, hasUserMentionTokens, isMentionTextAttribute, isUserMentionId, } from '../../mentions/userMentionToken.js';
+import { isPromptBodySourceAttribute } from './remarkPrompt.js';
+import { TITLE_COMPONENTS } from './remarkTitleMarkdown.js';
+const IN_TEXT = { inText: true };
+const isMdxJsxElement = (node) => node.type === 'mdxJsxFlowElement' || node.type === 'mdxJsxTextElement';
+const isParent = (node) => 'children' in node && Array.isArray(node.children);
+const isRecord = (value) => typeof value === 'object' && value !== null;
+function flattenStringLiteralExpression(expression, resolve, { escapeNames, rawSource }) {
+    var _a;
+    const program = (_a = expression.data) === null || _a === void 0 ? void 0 : _a.estree;
+    const statement = program === null || program === void 0 ? void 0 : program.body[0];
+    if (!statement || program.body.length !== 1 || statement.type !== 'ExpressionStatement')
+        return;
+    const literal = statement.expression;
+    if (!isRecord(literal) || literal.type !== 'Literal' || typeof literal.value !== 'string')
+        return;
+    const scan = rawSource ? undefined : IN_TEXT;
+    if (!hasUserMentionTokens(literal.value, scan))
+        return;
+    const flat = flattenUserMentionTokens(literal.value, (userId) => {
+        const name = resolve === null || resolve === void 0 ? void 0 : resolve(userId);
+        return name === undefined || !escapeNames ? name : escapeMentionNameForSource(name);
+    }, scan);
+    literal.value = flat;
+    literal.raw = JSON.stringify(flat);
+    expression.value = JSON.stringify(flat);
+}
+function foldShortcutReferences(parent, resolve) {
+    var _a;
+    const children = parent.children;
+    for (let index = 0; index < children.length - 1; index++) {
+        const text = children[index];
+        const reference = children[index + 1];
+        if (!text || !reference || text.type !== 'text' || !text.value.endsWith('@'))
+            continue;
+        if (reference.type !== 'linkReference' || reference.referenceType !== 'shortcut')
+            continue;
+        const label = (_a = reference.label) !== null && _a !== void 0 ? _a : reference.identifier;
+        if (!isUserMentionId(label))
+            continue;
+        const [only, ...rest] = reference.children;
+        if (rest.length > 0 || !only || only.type !== 'text' || only.value !== label)
+            continue;
+        text.value = text.value.slice(0, -1) + flattenUserMentionTokens(`@[${label}]`, resolve);
+        children.splice(index + 1, 1);
+        const next = children[index + 1];
+        if ((next === null || next === void 0 ? void 0 : next.type) === 'text') {
+            text.value += next.value;
+            children.splice(index + 1, 1);
+        }
+        index--;
+    }
+}
+// A Prompt body is plain text on the page, so code and math inside it are text there too.
+function flattenPromptCode(prompt, resolve) {
+    visit(prompt, (child) => {
+        if (child.type !== 'inlineCode' &&
+            child.type !== 'code' &&
+            child.type !== 'inlineMath' &&
+            child.type !== 'math') {
+            return;
+        }
+        if (hasUserMentionTokens(child.value)) {
+            child.value = flattenUserMentionTokens(child.value, resolve);
+        }
+    });
+}
+export const remarkUserMentions = ({ resolveUserName } = {}) => (tree) => {
+    // Body text and text-bearing component attributes only: image alt/title, link and definition titles are HTML attributes and stay as written.
+    visit(tree, (node) => {
+        if (node.type === 'text') {
+            if (hasUserMentionTokens(node.value, IN_TEXT)) {
+                node.value = flattenUserMentionTokens(node.value, resolveUserName, IN_TEXT);
+            }
+            return;
+        }
+        if (isMdxJsxElement(node)) {
+            if (node.name === 'Prompt')
+                flattenPromptCode(node, resolveUserName);
+            const titleIsMarkdown = node.name !== null && TITLE_COMPONENTS.has(node.name);
+            for (const attribute of node.attributes) {
+                if (attribute.type !== 'mdxJsxAttribute' || !isMentionTextAttribute(attribute.name)) {
+                    continue;
+                }
+                if (typeof attribute.value === 'string') {
+                    if (!hasUserMentionTokens(attribute.value, IN_TEXT))
+                        continue;
+                    const escape = titleIsMarkdown && attribute.name === 'title';
+                    attribute.value = flattenUserMentionTokens(attribute.value, (userId) => {
+                        const name = resolveUserName === null || resolveUserName === void 0 ? void 0 : resolveUserName(userId);
+                        return name === undefined || !escape ? name : escapeMentionNameForSource(name);
+                    }, IN_TEXT);
+                }
+                else if (attribute.value && typeof attribute.value === 'object') {
+                    flattenStringLiteralExpression(attribute.value, resolveUserName, {
+                        escapeNames: titleIsMarkdown && attribute.name === 'title',
+                        rawSource: isPromptBodySourceAttribute(attribute),
+                    });
+                }
+            }
+        }
+        if (isParent(node) && node.children.some((child) => child.type === 'linkReference')) {
+            foldShortcutReferences(node, resolveUserName);
+        }
+    });
+};

package/dist/mdx/remark.d.ts

@@ -1,7 +1,9 @@
 import type { Root } from 'mdast';
 import type { PluggableList } from 'unified';
+import { type RemarkUserMentionsOptions } from './plugins/remark/remarkUserMentions.js';
 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;
+export declare function transformContentForMarkdown(mdx: string, mentionOptions?: RemarkUserMentionsOptions): 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 { remarkUserMentions, } from './plugins/remark/remarkUserMentions.js';
 import { remarkVisibilityForMarkdown } from './plugins/remark/remarkVisibilityForMarkdown.js';
 import { preprocessCustomHeadingIds } from './preprocessCustomHeadingIds.js';
 import { preprocessMdxFragmentCode } from './preprocessMdxFragmentCode.js';
@@ -28,3 +29,9 @@ export function stripVisibilityForMarkdown(mdx) {
     remarkVisibilityForMarkdown()(tree);
     return stringifyTree(tree);
 }
+export function transformContentForMarkdown(mdx, mentionOptions = {}) {
+    const tree = getAST(mdx);
+    remarkVisibilityForMarkdown()(tree);
+    remarkUserMentions(mentionOptions)(tree);
+    return stringifyTree(tree);
+}

package/dist/mdx/server-only/getMdx.d.ts

@@ -13,7 +13,7 @@ export type GetMdxType = {
     panelMdxSourceWithNoJs?: SerializeSuccess;
     parseFailed?: boolean;
 };
-export declare function getMdx({ path, content, metadata, snippets, subdomain, codeStyling, config, tailwindSelectors, pageType, trace, customLanguages, variables, rehypePlugins, remarkPlugins, allowedComponents, }: {
+export declare function getMdx({ path, content, metadata, snippets, subdomain, codeStyling, config, tailwindSelectors, pageType, trace, customLanguages, variables, rehypePlugins, remarkPlugins, earlyRemarkPlugins, allowedComponents, }: {
     path: string;
     content: string;
     metadata: PageMetaTags;
@@ -28,6 +28,7 @@ export declare function getMdx({ path, content, metadata, snippets, subdomain, c
     variables?: Record<string, string>;
     rehypePlugins?: PluggableList;
     remarkPlugins?: PluggableList;
+    earlyRemarkPlugins?: PluggableList;
     allowedComponents?: string[];
 }): Promise<GetMdxType>;
 export { createSnippetTreeMap, type Snippet };

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

@@ -17,7 +17,7 @@ import { replaceVariables } from '../replaceVariables.js';
 import { createSnippetTreeMap } from './getMdx/snippets.js';
 import { getSerializeExtras } from './getSerializeExtras.js';
 export function getMdx(_a) {
-    return __awaiter(this, arguments, void 0, function* ({ path, content, metadata, snippets, subdomain, codeStyling, config, tailwindSelectors = undefined, pageType = 'default', trace = undefined, customLanguages = [], variables = undefined, rehypePlugins = [], remarkPlugins = [], allowedComponents = [], }) {
+    return __awaiter(this, arguments, void 0, function* ({ path, content, metadata, snippets, subdomain, codeStyling, config, tailwindSelectors = undefined, pageType = 'default', trace = undefined, customLanguages = [], variables = undefined, rehypePlugins = [], remarkPlugins = [], earlyRemarkPlugins = [], allowedComponents = [], }) {
         const traceFn = trace !== null && trace !== void 0 ? trace : ((_name, fn) => fn());
         const processedContent = preprocessCustomHeadingIds(preprocessMdxFragmentCode(replaceVariables(content, variables)));
         const processedSnippets = snippets.map((snippet) => (Object.assign(Object.assign({}, snippet), { content: preprocessCustomHeadingIds(preprocessMdxFragmentCode(replaceVariables(snippet.content, variables))) })));
@@ -49,6 +49,7 @@ export function getMdx(_a) {
         const mdxOptions = getMDXOptions({
             data: mdxOptionsData,
             remarkPlugins: plugins,
+            earlyRemarkPlugins,
             rehypePlugins,
             mdxExtracts,
             allowedComponents,
@@ -57,6 +58,7 @@ export function getMdx(_a) {
         const mdxOptionsNoJs = getMDXOptions({
             data: mdxOptionsData,
             remarkPlugins: [remarkMdxRemoveJs, ...plugins],
+            earlyRemarkPlugins,
             rehypePlugins,
             allowedComponents,
             fragmentPlugins: getSerializeExtras(syntaxHighlightingOptions),

package/dist/rss/getV4FeedUpdates.d.ts

@@ -1,2 +1,3 @@
 import type { SavedRssFileV4, RSSItemV2 } from '../types/rss.js';
+export declare const feedSafeName: (name: string) => string;
 export declare const getV4FeedUpdates: (rssFile: SavedRssFileV4) => Promise<RSSItemV2[]>;

package/dist/rss/getV4FeedUpdates.js

@@ -7,6 +7,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+import { remarkUserMentions } from '../mdx/plugins/remark/remarkUserMentions.js';
 import { getAST } from '../mdx/remark.js';
 import { UPDATE_MAX } from './constants.js';
 import { getDateForNode, getMostRepresentativeDate } from './dates.js';
@@ -14,8 +15,16 @@ import { enhanceSnippetsWithImportNames } from './enhanceSnippetsWithImportNames
 import { isUpdate } from './index.js';
 import { processUpdateNode } from './processUpdateNode.js';
 import { resolveSnippets } from './resolveSnippets.js';
+const WORD_JOINER = '\u2060';
+// GFM autolink literals are found by a text-node transform after parsing, so backslash escapes cannot stop `alice@example.com`, `www.x.com` or `https://x` in a name from becoming a link when the feed is re-parsed. An invisible word joiner inside each pattern does.
+export const feedSafeName = (name) => name
+    .replace(/\s+/g, ' ')
+    .replace(/[<>]/g, '')
+    .replace(/@/g, `@${WORD_JOINER}`)
+    .replace(/:\/\//g, `:${WORD_JOINER}//`)
+    .replace(/\b(www)\./gi, `$1${WORD_JOINER}.`);
 export const getV4FeedUpdates = (rssFile) => __awaiter(void 0, void 0, void 0, function* () {
-    const { content, lineBlame, snippets } = rssFile;
+    const { content, lineBlame, snippets, mentionUserNames } = rssFile;
     if (!content) {
         return [];
     }
@@ -36,6 +45,13 @@ export const getV4FeedUpdates = (rssFile) => __awaiter(void 0, void 0, void 0, f
         }
         catch (_a) { }
     }
+    // Feed content is re-parsed as HTML downstream (encodeContentAsHtml): inside an HTML block a name is raw markup, and a blank line would end the block and hand the rest to markdown.
+    remarkUserMentions({
+        resolveUserName: (userId) => {
+            const name = mentionUserNames === null || mentionUserNames === void 0 ? void 0 : mentionUserNames[userId];
+            return name === undefined ? undefined : feedSafeName(name);
+        },
+    })(ast);
     const updateComponents = ast.children.filter((child) => isUpdate(child));
     if (updateComponents.length === 0) {
         return [];

package/dist/rss/index.js

@@ -166,32 +166,108 @@ export const getMarkdownHeadingProps = (heading) => {
     }
     return { title, anchor };
 };
-const jsxToHtml = (node) => {
+const escapeHtmlText = (value) => value.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
+const escapeHtmlAttribute = (value) => escapeHtmlText(value).replaceAll('"', '&quot;');
+// CommonMark HTML block start condition 6: content of these tags is raw HTML when the feed is re-parsed; content of any other tag is inline HTML and the text between tags is still markdown.
+// CommonMark HTML block start conditions 1 and 6: text inside these is raw HTML, never re-parsed as markdown.
+const HTML_BLOCK_TAGS = new Set([
+    'pre',
+    'script',
+    'style',
+    'textarea',
+    'address',
+    'article',
+    'aside',
+    'base',
+    'basefont',
+    'blockquote',
+    'body',
+    'caption',
+    'center',
+    'col',
+    'colgroup',
+    'dd',
+    'details',
+    'dialog',
+    'dir',
+    'div',
+    'dl',
+    'dt',
+    'fieldset',
+    'figcaption',
+    'figure',
+    'footer',
+    'form',
+    'frame',
+    'frameset',
+    'h1',
+    'h2',
+    'h3',
+    'h4',
+    'h5',
+    'h6',
+    'head',
+    'header',
+    'hr',
+    'html',
+    'iframe',
+    'legend',
+    'li',
+    'link',
+    'main',
+    'menu',
+    'menuitem',
+    'nav',
+    'noframes',
+    'ol',
+    'optgroup',
+    'option',
+    'p',
+    'param',
+    'search',
+    'section',
+    'summary',
+    'table',
+    'tbody',
+    'td',
+    'tfoot',
+    'th',
+    'thead',
+    'title',
+    'tr',
+    'track',
+    'ul',
+]);
+const escapeMarkdownText = (value) => value.replace(/([\\`*_{}[\]()#+!~|])/g, '\\$1');
+const jsxToHtml = (node, insideHtmlBlock = HTML_BLOCK_TAGS.has((node.name || 'div').toLowerCase())) => {
     const tagName = node.name || 'div';
     const attrs = node.attributes
         .filter((attr) => attr.type === 'mdxJsxAttribute' && typeof attr.value === 'string')
         .map((attr) => {
         if (attr.type === 'mdxJsxAttribute' && attr.name !== 'className') {
-            return `${attr.name}="${attr.value}"`;
+            return `${attr.name}="${escapeHtmlAttribute(String(attr.value))}"`;
         }
         return '';
     })
         .filter(Boolean)
         .join(' ');
     const attrsStr = attrs ? ` ${attrs}` : '';
-    const childrenStr = node.children
-        .map((child) => {
-        if (child.type === 'mdxJsxFlowElement' || child.type === 'mdxJsxTextElement') {
-            return jsxToHtml(child);
-        }
-        if (child.type === 'text') {
-            return child.value;
-        }
-        return stringifyTree({ type: 'root', children: [child] }).trim();
-    })
-        .join('');
-    return `<${tagName}${attrsStr}>${childrenStr}</${tagName}>`;
+    return `<${tagName}${attrsStr}>${childrenToHtml(node.children, insideHtmlBlock)}</${tagName}>`;
 };
+const childrenToHtml = (children, insideHtmlBlock) => children
+    .map((child) => {
+    if (child.type === 'mdxJsxFlowElement' || child.type === 'mdxJsxTextElement') {
+        return jsxToHtml(child, insideHtmlBlock);
+    }
+    if (child.type === 'text') {
+        return escapeHtmlText(insideHtmlBlock ? child.value : escapeMarkdownText(child.value));
+    }
+    if (insideHtmlBlock && child.type === 'paragraph') {
+        return childrenToHtml(child.children, insideHtmlBlock);
+    }
+    return stringifyTree({ type: 'root', children: [child] }).trim();
+})
+    .join('');
 const stripCustomInlineJsx = (parent) => {
     let i = 0;
     while (i < parent.children.length) {
@@ -208,6 +284,15 @@ const stripCustomInlineJsx = (parent) => {
         i++;
     }
 };
+// `<pre>text</pre>` on one line parses as a paragraph around an inline element, but CommonMark still reads that line as an HTML block.
+const soleBlockJsx = (child) => {
+    if (child.type !== 'paragraph' || child.children.length !== 1)
+        return undefined;
+    const only = child.children[0];
+    if ((only === null || only === void 0 ? void 0 : only.type) !== 'mdxJsxTextElement')
+        return undefined;
+    return HTML_BLOCK_TAGS.has((only.name || '').toLowerCase()) ? only : undefined;
+};
 const stringifyTreeForRSS = (tree) => {
     stripCustomInlineJsx(tree);
     return tree.children
@@ -215,6 +300,9 @@ const stringifyTreeForRSS = (tree) => {
         if (child.type === 'mdxJsxFlowElement' || child.type === 'mdxJsxTextElement') {
             return jsxToHtml(child);
         }
+        const block = soleBlockJsx(child);
+        if (block)
+            return jsxToHtml(block, true);
         return stringifyTree({ type: 'root', children: [child] }).trim();
     })
         .join('\n\n');