@readme/markdown 14.1.1 → 14.1.2

package/dist/main.js

@@ -87611,7 +87611,12 @@ const tocHastToMdx = (toc, components, variables) => {
 
 
 const sanitizeSchema = cjs_default()(defaultSchema, {
-    protocols: ['doc', 'ref', 'blog', 'changelog', 'page'],
+    attributes: {
+        a: ['target'],
+    },
+    protocols: {
+        href: ['doc', 'ref', 'blog', 'changelog', 'page'],
+    },
 });
 const compile_compile = (text, { components = {}, missingComponents, copyButtons, useTailwind, ...opts } = {}) => {
     // Destructure at runtime to avoid circular dependency issues
@@ -97202,17 +97207,46 @@ function mdxComponent() {
 
 
 
+
+
+
+
+const buildInlineMdProcessor = (safeMode) => {
+    const micromarkExts = [mdxComponent(), syntax_gemoji(), legacyVariable(), magicBlock()];
+    const fromMarkdownExts = [
+        mdxComponentFromMarkdown(),
+        gemojiFromMarkdown(),
+        legacyVariableFromMarkdown(),
+        emptyTaskListItemFromMarkdown(),
+        magicBlockFromMarkdown(),
+    ];
+    // Since evaluating expressions can be dangerous, do so only when safeMode is off
+    if (!safeMode) {
+        const mdxExprExt = mdxExpression({ allowEmpty: true });
+        micromarkExts.push({ text: mdxExprExt.text });
+        fromMarkdownExts.push(mdxExpressionFromMarkdown());
+    }
+    return unified()
+        .data('micromarkExtensions', micromarkExts)
+        .data('fromMarkdownExtensions', fromMarkdownExts)
+        .use(remarkParse)
+        .use(remarkGfm);
+};
+const processorCache = new Map();
 /**
- * Shared unified processor for re-parsing the body of an MDX-ish component.
- * Used by both the block and inline-block transformers so a nested component
- * (e.g. `<Anchor>text with <b>bold</b></Anchor>`) goes through the same
- * tokenizer chain as the top-level parse.
+ * Unified processor for re-parsing the body of an MDX component
+ * Memoized based on the argument value so we don't pay the construction cost on every parse
+ * Currently the argument is only safeMode, but we could add more arguments in the future,
+ * in which case the key would need to be extend to include the new arguments.
  */
-const inlineMdProcessor = unified()
-    .data('micromarkExtensions', [mdxComponent(), legacyVariable(), magicBlock()])
-    .data('fromMarkdownExtensions', [mdxComponentFromMarkdown(), legacyVariableFromMarkdown(), emptyTaskListItemFromMarkdown(), magicBlockFromMarkdown()])
-    .use(remarkParse)
-    .use(remarkGfm);
+const getInlineMdProcessor = ({ safeMode = false } = {}) => {
+    let processor = processorCache.get(safeMode);
+    if (!processor) {
+        processor = buildInlineMdProcessor(safeMode);
+        processorCache.set(safeMode, processor);
+    }
+    return processor;
+};
 /**
  * True when a tag name starts with an uppercase letter — ReadMe's marker for
  * a custom MDX component (vs a lowercase HTML tag).
@@ -97253,11 +97287,11 @@ const toMdxJsxTextElement = (name, attributes, children, position) => ({
  * rejects line endings), so the paragraph-flatten path covers every case we
  * actually produce; other shapes fall back to empty children.
  */
-const parsePhrasingChildren = (value) => {
+const parsePhrasingChildren = (value, safeMode) => {
     const trimmed = value.trim();
     if (!trimmed)
         return [];
-    const [first] = inlineMdProcessor.parse(trimmed).children;
+    const [first] = getInlineMdProcessor({ safeMode }).parse(trimmed).children;
     return first?.type === 'paragraph' ? first.children : [];
 };
 /**
@@ -97270,7 +97304,7 @@ const parsePhrasingChildren = (value) => {
  *
  * Returns the original node unchanged when it doesn't qualify.
  */
-const promoteInlineHtml = (node, parseOpts) => {
+const promoteInlineHtml = (node, parseOpts, safeMode) => {
     const parsed = parseTag((node.value ?? '').trim(), parseOpts);
     if (!parsed)
         return node;
@@ -97295,7 +97329,7 @@ const promoteInlineHtml = (node, parseOpts) => {
     if (closeIdx < 0)
         return node;
     const inner = contentAfterTag.slice(0, closeIdx);
-    return toMdxJsxTextElement(tag, attributes, parsePhrasingChildren(inner), node.position);
+    return toMdxJsxTextElement(tag, attributes, parsePhrasingChildren(inner, safeMode), node.position);
 };
 /**
  * Transform inline html nodes with expression attributes
@@ -97314,9 +97348,10 @@ const promoteInlineHtml = (node, parseOpts) => {
  * `<a href="x">` stays as an html node for rehype-raw.
  */
 const mdxishInlineMdxHtmlBlocks = (opts = {}) => tree => {
-    const parseOpts = { preserveExpressionsAsText: !!opts.safeMode };
+    const safeMode = !!opts.safeMode;
+    const parseOpts = { preserveExpressionsAsText: safeMode };
     visit(tree, 'paragraph', (paragraph) => {
-        paragraph.children = paragraph.children.map(child => child.type === 'html' ? promoteInlineHtml(child, parseOpts) : child);
+        paragraph.children = paragraph.children.map(child => child.type === 'html' ? promoteInlineHtml(child, parseOpts, safeMode) : child);
     });
 };
 /* harmony default export */ const inline_html = (mdxishInlineMdxHtmlBlocks);
@@ -97399,15 +97434,15 @@ function safeDeindent(text) {
  * Dedents the content first to prevent indented component content
  * (from nested components) from being treated as code blocks.
  */
-const parseMdChildren = (value) => {
-    const parsed = inlineMdProcessor.parse(safeDeindent(value).trim());
+const parseMdChildren = (value, safeMode) => {
+    const parsed = getInlineMdProcessor({ safeMode }).parse(safeDeindent(value).trim());
     return parsed.children || [];
 };
 /**
  * Parse substring content of a node and update the parent's children to include the new nodes.
  */
-const parseSibling = (stack, parent, index, sibling) => {
-    const siblingNodes = parseMdChildren(sibling);
+const parseSibling = (stack, parent, index, sibling, safeMode) => {
+    const siblingNodes = parseMdChildren(sibling, safeMode);
     // The new sibling nodes might contain new components to be processed
     if (siblingNodes.length > 0) {
         parent.children.splice(index + 1, 0, ...siblingNodes);
@@ -97459,7 +97494,8 @@ const substituteNodeWithMdxNode = (parent, index, mdxNode) => {
  */
 const mdxishMdxComponentBlocks = (opts = {}) => tree => {
     const stack = [tree];
-    const parseOpts = { preserveExpressionsAsText: !!opts.safeMode };
+    const safeMode = !!opts.safeMode;
+    const parseOpts = { preserveExpressionsAsText: safeMode };
     const processChildNode = (parent, index) => {
         const node = parent.children[index];
         if (!node)
@@ -97505,7 +97541,7 @@ const mdxishMdxComponentBlocks = (opts = {}) => tree => {
             // Check and parse if there's relevant content after the current closing tag
             const remainingContent = contentAfterTag.trim();
             if (remainingContent) {
-                parseSibling(stack, parent, index, remainingContent);
+                parseSibling(stack, parent, index, remainingContent, safeMode);
             }
             return;
         }
@@ -97518,7 +97554,7 @@ const mdxishMdxComponentBlocks = (opts = {}) => tree => {
             const componentInnerContent = contentAfterTag.substring(0, closingTagIndex);
             const contentAfterClose = contentAfterTag.substring(closingTagIndex + closingTagStr.length).trim();
             let parsedChildren = componentInnerContent.trim()
-                ? parseMdChildren(componentInnerContent)
+                ? parseMdChildren(componentInnerContent, safeMode)
                 : [];
             // Lowercase HTML tags are usually inline (e.g. <a>, <span>). Remark wraps
             // bare text in a paragraph; unwrap when there's exactly one paragraph so
@@ -97535,7 +97571,7 @@ const mdxishMdxComponentBlocks = (opts = {}) => tree => {
             substituteNodeWithMdxNode(parent, index, componentNode);
             // After the closing tag, there might be more content to be processed
             if (contentAfterClose) {
-                parseSibling(stack, parent, index, contentAfterClose);
+                parseSibling(stack, parent, index, contentAfterClose, safeMode);
             }
             else if (componentNode.children.length > 0) {
                 // The content inside the component block might contain new components to be processed
@@ -101853,15 +101889,18 @@ function mdxishAstProcessor(mdContent, opts = {}) {
         .use(remarkParse)
         .use(remarkFrontmatter)
         .use(normalize_malformed_md_syntax)
-        .use(magic_block_transformer)
-        .use(transform_images, { isMdxish: true })
-        .use(defaultTransformers)
         .use(self_closing_blocks)
         .use(mdx_blocks, { safeMode })
         .use(inline_html, { safeMode })
         .use(restore_snake_case_component_name, { mapping: snakeCaseMapping })
         .use(mdxish_tables)
         .use(mdxish_html_blocks)
+        // The next few transformers must appear after mdxishMdxComponentBlocks
+        // so nodes produced by the inline re-parse of component bodies
+        // (e.g. code/image/embed inside <Tabs>) get visited too
+        .use(magic_block_transformer)
+        .use(transform_images, { isMdxish: true })
+        .use(defaultTransformers)
         .use(newEditorTypes ? inline_mdx_blocks : undefined) // Merge inline html components (e.g. <Anchor>) into MDAST nodes
         .use(newEditorTypes ? mdxish_jsx_to_mdast : undefined) // Convert block JSX elements to MDAST types
         .use(variables_text) // Parse {user.*} patterns from text nodes

package/dist/main.node.js

@@ -107805,7 +107805,12 @@ const tocHastToMdx = (toc, components, variables) => {
 
 
 const sanitizeSchema = cjs_default()(defaultSchema, {
-    protocols: ['doc', 'ref', 'blog', 'changelog', 'page'],
+    attributes: {
+        a: ['target'],
+    },
+    protocols: {
+        href: ['doc', 'ref', 'blog', 'changelog', 'page'],
+    },
 });
 const compile_compile = (text, { components = {}, missingComponents, copyButtons, useTailwind, ...opts } = {}) => {
     // Destructure at runtime to avoid circular dependency issues
@@ -117396,17 +117401,46 @@ function mdxComponent() {
 
 
 
+
+
+
+
+const buildInlineMdProcessor = (safeMode) => {
+    const micromarkExts = [mdxComponent(), syntax_gemoji(), legacyVariable(), magicBlock()];
+    const fromMarkdownExts = [
+        mdxComponentFromMarkdown(),
+        gemojiFromMarkdown(),
+        legacyVariableFromMarkdown(),
+        emptyTaskListItemFromMarkdown(),
+        magicBlockFromMarkdown(),
+    ];
+    // Since evaluating expressions can be dangerous, do so only when safeMode is off
+    if (!safeMode) {
+        const mdxExprExt = mdxExpression({ allowEmpty: true });
+        micromarkExts.push({ text: mdxExprExt.text });
+        fromMarkdownExts.push(mdxExpressionFromMarkdown());
+    }
+    return unified()
+        .data('micromarkExtensions', micromarkExts)
+        .data('fromMarkdownExtensions', fromMarkdownExts)
+        .use(remarkParse)
+        .use(remarkGfm);
+};
+const processorCache = new Map();
 /**
- * Shared unified processor for re-parsing the body of an MDX-ish component.
- * Used by both the block and inline-block transformers so a nested component
- * (e.g. `<Anchor>text with <b>bold</b></Anchor>`) goes through the same
- * tokenizer chain as the top-level parse.
+ * Unified processor for re-parsing the body of an MDX component
+ * Memoized based on the argument value so we don't pay the construction cost on every parse
+ * Currently the argument is only safeMode, but we could add more arguments in the future,
+ * in which case the key would need to be extend to include the new arguments.
  */
-const inlineMdProcessor = unified()
-    .data('micromarkExtensions', [mdxComponent(), legacyVariable(), magicBlock()])
-    .data('fromMarkdownExtensions', [mdxComponentFromMarkdown(), legacyVariableFromMarkdown(), emptyTaskListItemFromMarkdown(), magicBlockFromMarkdown()])
-    .use(remarkParse)
-    .use(remarkGfm);
+const getInlineMdProcessor = ({ safeMode = false } = {}) => {
+    let processor = processorCache.get(safeMode);
+    if (!processor) {
+        processor = buildInlineMdProcessor(safeMode);
+        processorCache.set(safeMode, processor);
+    }
+    return processor;
+};
 /**
  * True when a tag name starts with an uppercase letter — ReadMe's marker for
  * a custom MDX component (vs a lowercase HTML tag).
@@ -117447,11 +117481,11 @@ const toMdxJsxTextElement = (name, attributes, children, position) => ({
  * rejects line endings), so the paragraph-flatten path covers every case we
  * actually produce; other shapes fall back to empty children.
  */
-const parsePhrasingChildren = (value) => {
+const parsePhrasingChildren = (value, safeMode) => {
     const trimmed = value.trim();
     if (!trimmed)
         return [];
-    const [first] = inlineMdProcessor.parse(trimmed).children;
+    const [first] = getInlineMdProcessor({ safeMode }).parse(trimmed).children;
     return first?.type === 'paragraph' ? first.children : [];
 };
 /**
@@ -117464,7 +117498,7 @@ const parsePhrasingChildren = (value) => {
  *
  * Returns the original node unchanged when it doesn't qualify.
  */
-const promoteInlineHtml = (node, parseOpts) => {
+const promoteInlineHtml = (node, parseOpts, safeMode) => {
     const parsed = parseTag((node.value ?? '').trim(), parseOpts);
     if (!parsed)
         return node;
@@ -117489,7 +117523,7 @@ const promoteInlineHtml = (node, parseOpts) => {
     if (closeIdx < 0)
         return node;
     const inner = contentAfterTag.slice(0, closeIdx);
-    return toMdxJsxTextElement(tag, attributes, parsePhrasingChildren(inner), node.position);
+    return toMdxJsxTextElement(tag, attributes, parsePhrasingChildren(inner, safeMode), node.position);
 };
 /**
  * Transform inline html nodes with expression attributes
@@ -117508,9 +117542,10 @@ const promoteInlineHtml = (node, parseOpts) => {
  * `<a href="x">` stays as an html node for rehype-raw.
  */
 const mdxishInlineMdxHtmlBlocks = (opts = {}) => tree => {
-    const parseOpts = { preserveExpressionsAsText: !!opts.safeMode };
+    const safeMode = !!opts.safeMode;
+    const parseOpts = { preserveExpressionsAsText: safeMode };
     visit(tree, 'paragraph', (paragraph) => {
-        paragraph.children = paragraph.children.map(child => child.type === 'html' ? promoteInlineHtml(child, parseOpts) : child);
+        paragraph.children = paragraph.children.map(child => child.type === 'html' ? promoteInlineHtml(child, parseOpts, safeMode) : child);
     });
 };
 /* harmony default export */ const inline_html = (mdxishInlineMdxHtmlBlocks);
@@ -117593,15 +117628,15 @@ function safeDeindent(text) {
  * Dedents the content first to prevent indented component content
  * (from nested components) from being treated as code blocks.
  */
-const parseMdChildren = (value) => {
-    const parsed = inlineMdProcessor.parse(safeDeindent(value).trim());
+const parseMdChildren = (value, safeMode) => {
+    const parsed = getInlineMdProcessor({ safeMode }).parse(safeDeindent(value).trim());
     return parsed.children || [];
 };
 /**
  * Parse substring content of a node and update the parent's children to include the new nodes.
  */
-const parseSibling = (stack, parent, index, sibling) => {
-    const siblingNodes = parseMdChildren(sibling);
+const parseSibling = (stack, parent, index, sibling, safeMode) => {
+    const siblingNodes = parseMdChildren(sibling, safeMode);
     // The new sibling nodes might contain new components to be processed
     if (siblingNodes.length > 0) {
         parent.children.splice(index + 1, 0, ...siblingNodes);
@@ -117653,7 +117688,8 @@ const substituteNodeWithMdxNode = (parent, index, mdxNode) => {
  */
 const mdxishMdxComponentBlocks = (opts = {}) => tree => {
     const stack = [tree];
-    const parseOpts = { preserveExpressionsAsText: !!opts.safeMode };
+    const safeMode = !!opts.safeMode;
+    const parseOpts = { preserveExpressionsAsText: safeMode };
     const processChildNode = (parent, index) => {
         const node = parent.children[index];
         if (!node)
@@ -117699,7 +117735,7 @@ const mdxishMdxComponentBlocks = (opts = {}) => tree => {
             // Check and parse if there's relevant content after the current closing tag
             const remainingContent = contentAfterTag.trim();
             if (remainingContent) {
-                parseSibling(stack, parent, index, remainingContent);
+                parseSibling(stack, parent, index, remainingContent, safeMode);
             }
             return;
         }
@@ -117712,7 +117748,7 @@ const mdxishMdxComponentBlocks = (opts = {}) => tree => {
             const componentInnerContent = contentAfterTag.substring(0, closingTagIndex);
             const contentAfterClose = contentAfterTag.substring(closingTagIndex + closingTagStr.length).trim();
             let parsedChildren = componentInnerContent.trim()
-                ? parseMdChildren(componentInnerContent)
+                ? parseMdChildren(componentInnerContent, safeMode)
                 : [];
             // Lowercase HTML tags are usually inline (e.g. <a>, <span>). Remark wraps
             // bare text in a paragraph; unwrap when there's exactly one paragraph so
@@ -117729,7 +117765,7 @@ const mdxishMdxComponentBlocks = (opts = {}) => tree => {
             substituteNodeWithMdxNode(parent, index, componentNode);
             // After the closing tag, there might be more content to be processed
             if (contentAfterClose) {
-                parseSibling(stack, parent, index, contentAfterClose);
+                parseSibling(stack, parent, index, contentAfterClose, safeMode);
             }
             else if (componentNode.children.length > 0) {
                 // The content inside the component block might contain new components to be processed
@@ -122047,15 +122083,18 @@ function mdxishAstProcessor(mdContent, opts = {}) {
         .use(remarkParse)
         .use(remarkFrontmatter)
         .use(normalize_malformed_md_syntax)
-        .use(magic_block_transformer)
-        .use(transform_images, { isMdxish: true })
-        .use(defaultTransformers)
         .use(self_closing_blocks)
         .use(mdx_blocks, { safeMode })
         .use(inline_html, { safeMode })
         .use(restore_snake_case_component_name, { mapping: snakeCaseMapping })
         .use(mdxish_tables)
         .use(mdxish_html_blocks)
+        // The next few transformers must appear after mdxishMdxComponentBlocks
+        // so nodes produced by the inline re-parse of component bodies
+        // (e.g. code/image/embed inside <Tabs>) get visited too
+        .use(magic_block_transformer)
+        .use(transform_images, { isMdxish: true })
+        .use(defaultTransformers)
         .use(newEditorTypes ? inline_mdx_blocks : undefined) // Merge inline html components (e.g. <Anchor>) into MDAST nodes
         .use(newEditorTypes ? mdxish_jsx_to_mdast : undefined) // Convert block JSX elements to MDAST types
         .use(variables_text) // Parse {user.*} patterns from text nodes