@readme/markdown 13.6.1 → 13.6.2

package/dist/lib/plain.d.ts

@@ -9,6 +9,13 @@ interface Options {
      * their respective regexes.
      */
     preserveVariableSyntax?: boolean;
+    /**
+     * Separator to use when joining sibling nodes.
+     * Defaults to a space for document-level plain text extraction.
+     * Use an empty string for inline-only contexts like TOC labels, where
+     * adjacent inline siblings should preserve authored adjacency.
+     */
+    separator?: string;
     variables?: Record<string, string>;
 }
 declare const plain: (node: Nodes, opts?: Options) => string | number | true | (string | number)[];

package/dist/main.js

@@ -53015,11 +53015,12 @@ function plain_one(node, opts) {
 function plain_all(node, opts) {
     let index = -1;
     const result = [];
+    const separator = opts.separator ?? ' ';
     // eslint-disable-next-line no-plusplus
     while (++index < node?.children.length) {
         result[index] = plain_one(node.children[index], opts);
     }
-    return result.join(' ').replaceAll(/\s+/g, ' ').trim();
+    return result.join(separator).replaceAll(/\s+/g, ' ').trim();
 }
 const plain = (node, opts = {}) => {
     return 'children' in node ? plain_all(node, opts) || plain_one(node, opts) : plain_one(node, opts);
@@ -71261,6 +71262,7 @@ const normalizeEmphasisAST = () => (tree) => {
 
 
 
+
 const isTableCell = (node) => isMDXElement(node) && ['th', 'td'].includes(node.name);
 const tableTypes = {
     tr: 'tableRow',
@@ -71271,7 +71273,7 @@ const tableNodeProcessor = unified()
     .use(remarkParse)
     .use(remarkMdx)
     .use(normalize_malformed_md_syntax)
-    .use([callouts, gemoji_])
+    .use([callouts, gemoji_, code_tabs])
     .use(remarkGfm);
 /**
  * Check if children are only text nodes that might contain markdown
@@ -86943,7 +86945,7 @@ const tocToHast = (headings = [], variables) => {
             stack.pop();
         }
         if (heading.properties) {
-            const content = lib_plain({ type: 'root', children: heading.children }, { variables: flatVars });
+            const content = lib_plain({ type: 'root', children: heading.children }, { separator: '', variables: flatVars });
             stack[stack.length - 1].children.push(hastscript_lib_h('li', null, hastscript_lib_h('a', { href: `#${heading.properties.id}` }, content)));
         }
     });
@@ -93754,6 +93756,14 @@ const rehypeMdxishComponents = ({ components, processMarkdown }) => {
         visit(tree, 'element', (node, index, parent) => {
             if (index === undefined || !parent)
                 return;
+            // Parse Image caption as markdown so it renders formatted (bold, code,
+            // decoded entities) in the figcaption instead of as a raw string.
+            // rehypeRaw strips children from <img> (void element), so we must
+            // re-process the caption here, after rehypeRaw.
+            if (node.tagName === 'img' && typeof node.properties?.caption === 'string' && !node.children?.length) {
+                const captionHast = processMarkdown(node.properties.caption);
+                node.children = (captionHast.children ?? []).filter(isElementContentNode);
+            }
             // Skip runtime components and standard HTML tags
             if (RUNTIME_COMPONENT_TAGS.has(node.tagName))
                 return;
@@ -95816,6 +95826,21 @@ const stripClosingTagFromParagraph = (node, tag) => {
     if (closingIndex === -1)
         return { paragraph: node, found: false };
     children.splice(closingIndex, 1);
+    // After removing the closing tag, trim trailing whitespace/newlines from the
+    // preceding text node. Remark parses "Hello\n</Callout>" as text("Hello\n") +
+    // html("</Callout>"), and the leftover \n would be converted to <br> in HAST.
+    if (closingIndex > 0) {
+        const prev = children[closingIndex - 1];
+        if (prev.type === 'text') {
+            const trimmed = prev.value.trimEnd();
+            if (trimmed) {
+                prev.value = trimmed;
+            }
+            else {
+                children.splice(closingIndex - 1, 1);
+            }
+        }
+    }
     return { paragraph: { ...node, children }, found: true };
 };
 /**
@@ -96428,6 +96453,7 @@ const mdxishInlineComponents = () => tree => {
 
 
 
+
 const transformAnchor = (jsx) => {
     const attrs = getAttrs(jsx);
     const { href = '', label, target, title } = attrs;
@@ -96467,6 +96493,7 @@ const transformImage = (jsx) => {
         alt,
         border: border !== undefined ? String(border) : undefined,
         caption,
+        children: caption ? lib_mdast(caption).children : [],
         className,
         height: height !== undefined ? String(height) : undefined,
         lazy,

package/dist/main.node.js

@@ -73219,11 +73219,12 @@ function plain_one(node, opts) {
 function plain_all(node, opts) {
     let index = -1;
     const result = [];
+    const separator = opts.separator ?? ' ';
     // eslint-disable-next-line no-plusplus
     while (++index < node?.children.length) {
         result[index] = plain_one(node.children[index], opts);
     }
-    return result.join(' ').replaceAll(/\s+/g, ' ').trim();
+    return result.join(separator).replaceAll(/\s+/g, ' ').trim();
 }
 const plain = (node, opts = {}) => {
     return 'children' in node ? plain_all(node, opts) || plain_one(node, opts) : plain_one(node, opts);
@@ -91465,6 +91466,7 @@ const normalizeEmphasisAST = () => (tree) => {
 
 
 
+
 const isTableCell = (node) => isMDXElement(node) && ['th', 'td'].includes(node.name);
 const tableTypes = {
     tr: 'tableRow',
@@ -91475,7 +91477,7 @@ const tableNodeProcessor = unified()
     .use(remarkParse)
     .use(remarkMdx)
     .use(normalize_malformed_md_syntax)
-    .use([callouts, gemoji_])
+    .use([callouts, gemoji_, code_tabs])
     .use(remarkGfm);
 /**
  * Check if children are only text nodes that might contain markdown
@@ -107147,7 +107149,7 @@ const tocToHast = (headings = [], variables) => {
             stack.pop();
         }
         if (heading.properties) {
-            const content = lib_plain({ type: 'root', children: heading.children }, { variables: flatVars });
+            const content = lib_plain({ type: 'root', children: heading.children }, { separator: '', variables: flatVars });
             stack[stack.length - 1].children.push(hastscript_lib_h('li', null, hastscript_lib_h('a', { href: `#${heading.properties.id}` }, content)));
         }
     });
@@ -113958,6 +113960,14 @@ const rehypeMdxishComponents = ({ components, processMarkdown }) => {
         visit(tree, 'element', (node, index, parent) => {
             if (index === undefined || !parent)
                 return;
+            // Parse Image caption as markdown so it renders formatted (bold, code,
+            // decoded entities) in the figcaption instead of as a raw string.
+            // rehypeRaw strips children from <img> (void element), so we must
+            // re-process the caption here, after rehypeRaw.
+            if (node.tagName === 'img' && typeof node.properties?.caption === 'string' && !node.children?.length) {
+                const captionHast = processMarkdown(node.properties.caption);
+                node.children = (captionHast.children ?? []).filter(isElementContentNode);
+            }
             // Skip runtime components and standard HTML tags
             if (RUNTIME_COMPONENT_TAGS.has(node.tagName))
                 return;
@@ -116020,6 +116030,21 @@ const stripClosingTagFromParagraph = (node, tag) => {
     if (closingIndex === -1)
         return { paragraph: node, found: false };
     children.splice(closingIndex, 1);
+    // After removing the closing tag, trim trailing whitespace/newlines from the
+    // preceding text node. Remark parses "Hello\n</Callout>" as text("Hello\n") +
+    // html("</Callout>"), and the leftover \n would be converted to <br> in HAST.
+    if (closingIndex > 0) {
+        const prev = children[closingIndex - 1];
+        if (prev.type === 'text') {
+            const trimmed = prev.value.trimEnd();
+            if (trimmed) {
+                prev.value = trimmed;
+            }
+            else {
+                children.splice(closingIndex - 1, 1);
+            }
+        }
+    }
     return { paragraph: { ...node, children }, found: true };
 };
 /**
@@ -116632,6 +116657,7 @@ const mdxishInlineComponents = () => tree => {
 
 
 
+
 const transformAnchor = (jsx) => {
     const attrs = getAttrs(jsx);
     const { href = '', label, target, title } = attrs;
@@ -116671,6 +116697,7 @@ const transformImage = (jsx) => {
         alt,
         border: border !== undefined ? String(border) : undefined,
         caption,
+        children: caption ? lib_mdast(caption).children : [],
         className,
         height: height !== undefined ? String(height) : undefined,
         lazy,