@readme/markdown 14.14.1 → 14.14.2

package/dist/processor/transform/mdxish/tables/gfm-cell-normalization.d.ts

@@ -0,0 +1,9 @@
+import type { Node, TableCell } from 'mdast';
+export declare const hasChildren: (node: Node) => node is Node & {
+    children: Node[];
+};
+/**
+ * Returns a copy of the cell's children with line breaks — `break` nodes and newlines inside
+ * text — rewritten to the `<br />` a single-line GFM pipe cell can carry.
+ */
+export declare const normalizeCellChildrenForGfm: (cell: TableCell) => TableCell["children"];

package/dist/render-fixture.node.js

@@ -20197,7 +20197,7 @@ const CONTINUE = true
 /**
  * Stop traversing immediately.
  */
-const EXIT = false
+const lib_EXIT = false
 
 /**
  * Do not traverse this node’s children.
@@ -20311,7 +20311,7 @@ function visitParents(tree, test, visitor, reverse) {
         // @ts-expect-error: `visitor` is now a visitor.
         result = toResult(visitor(node, parents))
 
-        if (result[0] === EXIT) {
+        if (result[0] === lib_EXIT) {
           return result
         }
       }
@@ -20328,7 +20328,7 @@ function visitParents(tree, test, visitor, reverse) {
 
             subresult = factory(child, offset, grandparents)()
 
-            if (subresult[0] === EXIT) {
+            if (subresult[0] === lib_EXIT) {
               return subresult
             }
 
@@ -34035,7 +34035,7 @@ function formatHeadingAsSetext(node, state) {
       node.type === 'break'
     ) {
       literalWithBreak = true
-      return EXIT
+      return lib_EXIT
     }
   })
 
@@ -52885,7 +52885,7 @@ const lib_CONTINUE = Symbol('continue')
 /**
  * Stop traversing immediately.
  */
-const lib_EXIT = Symbol('exit')
+const estree_util_visit_lib_EXIT = Symbol('exit')
 
 /**
  * Do not traverse this node’s children.
@@ -52945,7 +52945,7 @@ function estree_util_visit_lib_visit(tree, visitor) {
       /** @type {ActionTuple} */
       const result = enter ? lib_toResult(enter(node, key, index, parents)) : []
 
-      if (result[0] === lib_EXIT) {
+      if (result[0] === estree_util_visit_lib_EXIT) {
         return result
       }
 
@@ -52981,7 +52981,7 @@ function estree_util_visit_lib_visit(tree, visitor) {
                     cIndex,
                     grandparents
                   )()
-                  if (subresult[0] === lib_EXIT) return subresult
+                  if (subresult[0] === estree_util_visit_lib_EXIT) return subresult
                   cIndex =
                     typeof subresult[1] === 'number' ? subresult[1] : cIndex + 1
                 } else {
@@ -52990,7 +52990,7 @@ function estree_util_visit_lib_visit(tree, visitor) {
               }
             } else if (nodelike(value)) {
               const subresult = build(value, cKey, undefined, grandparents)()
-              if (subresult[0] === lib_EXIT) return subresult
+              if (subresult[0] === estree_util_visit_lib_EXIT) return subresult
             }
           }
         }
@@ -68773,7 +68773,7 @@ const hasNamedExport = (tree, name) => {
             node.data.estree.body[0].declaration.type === 'VariableDeclaration') {
             const { declarations } = node.data.estree.body[0].declaration;
             hasExport = !!declarations.find(declaration => 'name' in declaration.id && declaration.id.name === name);
-            return hasExport ? EXIT : CONTINUE;
+            return hasExport ? lib_EXIT : CONTINUE;
         }
     });
     return hasExport;
@@ -69274,7 +69274,7 @@ const compatibilityTransfomer = () => tree => {
     const trimEmphasis = (node) => {
         lib_visit(node, 'text', child => {
             child.value = child.value.trim();
-            return EXIT;
+            return lib_EXIT;
         });
         return node;
     };
@@ -100447,7 +100447,7 @@ const processTableNode = (node, index, parent, documentPosition) => {
         ((candidate.type === 'mdxJsxFlowElement' || candidate.type === 'mdxJsxTextElement') &&
             candidate.name === 'HTMLBlock'), () => {
         tableHasFlowContent = true;
-        return EXIT;
+        return lib_EXIT;
     });
     // Re-parse text-only cells through markdown and detect flow content
     lib_visit(node, isTableCell, (cell) => {
@@ -100661,7 +100661,7 @@ const mdxish_tables_mdxishTables = () => tree => {
                 if (tableNode.name !== 'Table' && tableNode.name !== 'table')
                     return undefined;
                 processTableNode(tableNode, index, parent, node.position);
-                return EXIT;
+                return lib_EXIT;
             });
         }
         else if (node.value.startsWith('<table')) {
@@ -101147,13 +101147,13 @@ const visitor = (table, index, parent) => {
     let hasFlowContent = false;
     const tableCellVisitor = (cell) => {
         if (cell.children.length === 0)
-            return EXIT;
+            return lib_EXIT;
         const content = cell.children.length === 1 && cell.children[0].type === 'paragraph'
             ? cell.children[0].children[0]
             : cell.children[0];
         // If cell is empty there's nothing to visit
         if (!content)
-            return EXIT;
+            return lib_EXIT;
         // @note: Compatibility with RDMD. Ideally, I'd put this in a separate
         // transformer, but then there'd be some duplication.
         lib_visit(cell, 'break', (_, breakIndex, breakParent) => {
@@ -101161,12 +101161,12 @@ const visitor = (table, index, parent) => {
         });
         if (!(lib_phrasing(content) || content.type === 'plain') && content.type !== 'escape') {
             hasFlowContent = true;
-            return EXIT;
+            return lib_EXIT;
         }
         lib_visit(cell, isLiteral, (node) => {
             if (node.value.match(/\n/)) {
                 hasFlowContent = true;
-                return EXIT;
+                return lib_EXIT;
             }
         });
     };
@@ -119381,7 +119381,7 @@ function media(state, node) {
   lib_visit(fragment, function (node) {
     if (node.type === 'link') {
       linkInFallbackContent = true
-      return EXIT
+      return lib_EXIT
     }
   })
 
@@ -120905,7 +120905,7 @@ const trimEmphasis = (node, index, parent) => {
             trimmed = true;
             child.value = newValue;
         }
-        return EXIT;
+        return lib_EXIT;
     });
     lib_visit(node, 'text', (child) => {
         const newValue = child.value.trimEnd();
@@ -120913,7 +120913,7 @@ const trimEmphasis = (node, index, parent) => {
             trimmed = true;
             child.value = newValue;
         }
-        return EXIT;
+        return lib_EXIT;
     }, true);
     if (trimmed) {
         addSpaceBefore(index, parent);
@@ -126593,6 +126593,7 @@ const restoreBooleanProperties = () => tree => {
 
 
 
+
 const SELF_CLOSING_JSX_REGEX = /^\s*<[A-Z][^>]*\/>\s*$/;
 const mdxish_tables_to_jsx_alignToStyle = (align) => {
     if (!align || align === 'left')
@@ -126608,6 +126609,38 @@ const mdxish_tables_to_jsx_alignToStyle = (align) => {
 };
 const mdxish_tables_to_jsx_isTableCell = (node) => ['tableHead', 'tableCell'].includes(node.type);
 const mdxish_tables_to_jsx_isLiteral = (node) => 'value' in node;
+/**
+ * Block-level content that a single-line GFM cell cannot hold. `phrasing()` returns true
+ * for inline types (text, emphasis, strong, link…), which are safe to keep.
+ */
+const isFlowChild = (child) => {
+    if (child.type === 'paragraph' || child.type === 'plain' || child.type === 'escape')
+        return false;
+    if (child.type === NodeTypes.variable)
+        return false;
+    if (phrasing(child))
+        return false;
+    if (child.type === 'html')
+        return SELF_CLOSING_JSX_REGEX.test(child.value);
+    return true;
+};
+/** A newline in a normalized cell (e.g. inside `inlineCode`) has no inline equivalent. */
+const containsLiteralNewline = (nodes) => nodes.some(node => (mdxish_tables_to_jsx_isLiteral(node) && node.value.includes('\n')) || (hasChildren(node) && containsLiteralNewline(node.children)));
+/** True when normalized cell content survives a single-line GFM pipe cell without losing structure. */
+const canCellBeGfm = (children) => {
+    // Multiple paragraphs are distinct blocks; a single-line cell cannot keep them apart.
+    if (children.filter(child => child.type === 'paragraph').length > 1)
+        return false;
+    if (children.some(isFlowChild))
+        return false;
+    return !containsLiteralNewline(children);
+};
+/** On the promote path a `break` would serialize as a dangling `\`, so collapse it to a newline. */
+const flattenBreaksToNewlines = (cell) => {
+    visit(cell, 'break', (_, index, parent) => {
+        parent.children.splice(index, 1, { type: 'text', value: '\n' });
+    });
+};
 /**
  * Mdxish-specific version of `tablesToJsx`. Differs from the shared MDX version:
  *
@@ -126618,52 +126651,25 @@ const mdxish_tables_to_jsx_isLiteral = (node) => 'value' in node;
  */
 const mdxish_tables_to_jsx_mdxishTablesToJsx = () => tree => {
     visit(tree, (node) => ['table', 'tableau'].includes(node.type), (table, index, parent) => {
-        let hasFlowContent = false;
+        const gfmCells = [];
+        let requiresJsxTable = false;
         visit(table, mdxish_tables_to_jsx_isTableCell, (cell) => {
-            if (hasFlowContent || cell.children.length === 0)
-                return;
-            visit(cell, 'break', (_, breakIndex, breakParent) => {
-                breakParent.children.splice(breakIndex, 1, { type: 'text', value: '\n' });
-            });
-            // A cell with more than one paragraph child cannot be serialized as GFM
-            // (pipe tables are single-line per cell), so force JSX <Table> output to
-            // preserve paragraph separation.
-            const paragraphCount = cell.children.filter(child => child.type === 'paragraph').length;
-            if (paragraphCount > 1) {
-                hasFlowContent = true;
-                return;
-            }
-            // Check if any child is "flow" content (block-level) that requires JSX <Table>
-            // serialization instead of GFM. `phrasing()` from mdast-util-phrasing returns
-            // true for inline node types (text, emphasis, strong, link, etc.) which are
-            // safe to keep in GFM cells.
-            const hasFlowChild = cell.children.some(child => {
-                if (child.type === 'paragraph' || child.type === 'plain' || child.type === 'escape')
-                    return false;
-                if (child.type === NodeTypes.variable)
-                    return false;
-                if (phrasing(child))
-                    return false;
-                if (child.type === 'html') {
-                    return SELF_CLOSING_JSX_REGEX.test(child.value);
-                }
-                return true;
-            });
-            if (hasFlowChild) {
-                hasFlowContent = true;
-            }
-            if (!hasFlowContent) {
-                visit(cell, mdxish_tables_to_jsx_isLiteral, (node) => {
-                    if (node.value.match(/\n/)) {
-                        hasFlowContent = true;
-                    }
-                });
+            const normalized = normalizeCellChildrenForGfm(cell);
+            if (!canCellBeGfm(normalized)) {
+                requiresJsxTable = true;
+                return EXIT;
             }
+            gfmCells.push([cell, normalized]);
+            return undefined;
         });
-        if (!hasFlowContent) {
+        if (!requiresJsxTable) {
+            gfmCells.forEach(([cell, children]) => {
+                cell.children = children;
+            });
             table.type = 'table';
             return;
         }
+        visit(table, mdxish_tables_to_jsx_isTableCell, flattenBreaksToNewlines);
         const styles = table.align.map(mdxish_tables_to_jsx_alignToStyle);
         const head = {
             attributes: [],