@readme/markdown 14.1.3 → 14.2.0

package/dist/main.js

@@ -53325,9 +53325,16 @@ function formatHtmlForMdxish(html) {
     }
     // Removes the leading/trailing newlines
     let cleaned = processed.replace(/^\s*\n|\n\s*$/g, '');
-    // Convert literal \n sequences to actual newlines BEFORE processing backticks
-    // This prevents the backtick unescaping regex from incorrectly matching \n sequences
-    cleaned = cleaned.replace(/\\n/g, '\n');
+    // Convert literal \n sequences to actual newlines only inside <pre> and <code>.
+    // Because <pre> needs to respect the newline visual and
+    // escape characters should be processed in the <code> tag.
+    //
+    // We don't want to unescape every \n because it might break the HTML & cause errors
+    // Example: <script>console.log("\n");</script>
+    // Would get turned into: <script>console.log("
+    // ");</script>
+    // which is invalid javascript and will cause error
+    cleaned = cleaned.replace(/(<(pre|code)\b[^>]*>)([\s\S]*?)(<\/\2>)/gi, (_m, open, _tag, inner, close) => open + inner.replace(/\\n/g, '\n') + close);
     // Unescape backticks: \` -> ` (users escape backticks in template literals)
     // Handle both cases: \` (adjacent) and \ followed by ` (split by markdown parser)
     cleaned = cleaned.replace(/\\`/g, '`');
@@ -71907,7 +71914,7 @@ const hasFlowContent = (nodes) => {
  * a markdown table (phrasing-only) or keep as JSX <Table> (has flow content).
  */
 const processTableNode = (node, index, parent, documentPosition) => {
-    if (node.name !== 'Table')
+    if (node.name !== 'Table' && node.name !== 'table')
         return;
     const position = documentPosition ?? node.position;
     const { align: alignAttr } = getAttrs(node);
@@ -72021,7 +72028,7 @@ const mdxishTables = () => tree => {
         const node = _node;
         if (typeof index !== 'number' || !parent || !('children' in parent))
             return;
-        if (!node.value.startsWith('<Table'))
+        if (!node.value.startsWith('<Table') && !node.value.startsWith('<table'))
             return;
         try {
             const parsed = tableNodeProcessor.runSync(tableNodeProcessor.parse(node.value));
@@ -72043,13 +72050,10 @@ const mdxishTables = () => tree => {
                 }
             });
             visit(parsed, isMDXElement, (tableNode) => {
-                if (tableNode.name === 'Table') {
-                    processTableNode(tableNode, index, parent, node.position);
-                    // Stop after the outermost Table so nested Tables don't overwrite parent.children[index]
-                    // we let it get handled naturally
-                    return EXIT;
-                }
-                return undefined;
+                if (tableNode.name !== 'Table' && tableNode.name !== 'table')
+                    return undefined;
+                processTableNode(tableNode, index, parent, node.position);
+                return EXIT;
             });
         }
         catch {
@@ -84805,6 +84809,63 @@ function rehypeSanitize(options) {
   }
 }
 
+;// ./node_modules/mdast-util-newline-to-break/lib/index.js
+/**
+ * @typedef {import('mdast').Nodes} Nodes
+ * @typedef {import('mdast-util-find-and-replace').ReplaceFunction} ReplaceFunction
+ */
+
+
+
+/**
+ * Turn normal line endings into hard breaks.
+ *
+ * @param {Nodes} tree
+ *   Tree to change.
+ * @returns {undefined}
+ *   Nothing.
+ */
+function newlineToBreak(tree) {
+  findAndReplace(tree, [/\r?\n|\r/g, lib_replace])
+}
+
+/**
+ * Replace line endings.
+ *
+ * @type {ReplaceFunction}
+ */
+function lib_replace() {
+  return {type: 'break'}
+}
+
+;// ./node_modules/remark-breaks/lib/index.js
+/**
+ * @typedef {import('mdast').Root} Root
+ */
+
+
+
+/**
+ * Support hard breaks without needing spaces or escapes (turns enters into
+ * `<br>`s).
+ *
+ * @returns
+ *   Transform.
+ */
+function remarkBreaks() {
+  /**
+   * Transform.
+   *
+   * @param {Root} tree
+   *   Tree.
+   * @returns {undefined}
+   *   Nothing.
+   */
+  return function (tree) {
+    newlineToBreak(tree)
+  }
+}
+
 ;// ./errors/mdx-syntax-error.ts
 class MdxSyntaxError extends SyntaxError {
     original = null;
@@ -87610,6 +87671,7 @@ const tocHastToMdx = (toc, components, variables) => {
 
 
 
+
 const sanitizeSchema = cjs_default()(defaultSchema, {
     attributes: {
         a: ['target'],
@@ -87618,12 +87680,13 @@ const sanitizeSchema = cjs_default()(defaultSchema, {
         href: ['doc', 'ref', 'blog', 'changelog', 'page'],
     },
 });
-const compile_compile = (text, { components = {}, missingComponents, copyButtons, useTailwind, ...opts } = {}) => {
+const compile_compile = (text, { components = {}, missingComponents, copyButtons, useTailwind, hardBreaks, ...opts } = {}) => {
     // Destructure at runtime to avoid circular dependency issues
     const { codeTabsTransformer, ...transforms } = defaultTransforms;
     const remarkPlugins = [
         remarkFrontmatter,
         remarkGfm,
+        ...(hardBreaks ? [remarkBreaks] : []),
         ...Object.values(transforms),
         [codeTabsTransformer, { copyButtons }],
         [
@@ -94029,63 +94092,6 @@ function rehypeStringify(options) {
   }
 }
 
-;// ./node_modules/mdast-util-newline-to-break/lib/index.js
-/**
- * @typedef {import('mdast').Nodes} Nodes
- * @typedef {import('mdast-util-find-and-replace').ReplaceFunction} ReplaceFunction
- */
-
-
-
-/**
- * Turn normal line endings into hard breaks.
- *
- * @param {Nodes} tree
- *   Tree to change.
- * @returns {undefined}
- *   Nothing.
- */
-function newlineToBreak(tree) {
-  findAndReplace(tree, [/\r?\n|\r/g, lib_replace])
-}
-
-/**
- * Replace line endings.
- *
- * @type {ReplaceFunction}
- */
-function lib_replace() {
-  return {type: 'break'}
-}
-
-;// ./node_modules/remark-breaks/lib/index.js
-/**
- * @typedef {import('mdast').Root} Root
- */
-
-
-
-/**
- * Support hard breaks without needing spaces or escapes (turns enters into
- * `<br>`s).
- *
- * @returns
- *   Transform.
- */
-function remarkBreaks() {
-  /**
-   * Transform.
-   *
-   * @param {Root} tree
-   *   Tree.
-   * @returns {undefined}
-   *   Nothing.
-   */
-  return function (tree) {
-    newlineToBreak(tree)
-  }
-}
-
 ;// ./processor/plugin/flatten-table-cell-paragraphs.ts
 
 /** List elements that cause margin issues when adjacent to paragraphs */
@@ -98914,8 +98920,8 @@ const HTML_ELEMENT_BLOCK_RE = /<([a-zA-Z][a-zA-Z0-9-]*)[\s>][\s\S]*?<\/\1>/g;
 const NEWLINE_WITH_WHITESPACE_RE = /[^\S\n]*\n[^\S\n]*/g;
 /** Matches a closing block-level tag followed by non-tag text or by a newline then non-blank content. */
 const CLOSE_BLOCK_TAG_BOUNDARY_RE = /<\/([a-zA-Z][a-zA-Z0-9-]*)>\s*(?:(?!<)(\S)|\n([^\n]))/g;
-/** Tests whether a string contains a complete HTML element (open + close tag). */
-const COMPLETE_HTML_ELEMENT_RE = /<[a-zA-Z][^>]*>[\s\S]*<\/[a-zA-Z]/;
+/** Strips HTML open/close tags. Used to detect non-tag inner text content. */
+const HTML_TAG_STRIP_RE = /<\/?[a-zA-Z][^>]*>/g;
 
 ;// ./processor/transform/mdxish/magic-blocks/placeholder.ts
 const EMPTY_IMAGE_PLACEHOLDER = {
@@ -99155,10 +99161,12 @@ const parseTableCell = (text) => {
     const trimmedLines = normalized.split('\n').map(line => line.trimStart());
     const processed = trimmedLines.join('\n');
     const tree = contentParser.runSync(contentParser.parse(processed));
-    // Process markdown inside complete HTML elements (e.g. _emphasis_ within <li>).
-    // Bare tags like "<i>" are left for rehypeRaw since rehype-parse would mangle them.
+    // Process markdown inside HTML blocks that have non-tag inner text (e.g. `<div>**x**`
+    // or `<ul><li>_x_</li></ul>`). Pure bare tags like "<i>" or "<br>" are left for rehypeRaw
+    // since rehype-parse would mangle them (auto-closing void/inline elements).
     visit(tree, 'html', (node) => {
-        if (COMPLETE_HTML_ELEMENT_RE.test(node.value)) {
+        const hasInnerText = node.value.replace(HTML_TAG_STRIP_RE, '').trim().length > 0;
+        if (hasInnerText) {
             node.value = processMarkdownInHtmlString(node.value);
         }
         else {
@@ -101547,8 +101555,7 @@ function tokenizeJsxTable(effects, ok, nok) {
     let codeSpanOpenSize = 0;
     let codeSpanCloseSize = 0;
     let depth = 1;
-    const TABLE_NAME = [codes.uppercaseT, codes.lowercaseA, codes.lowercaseB, codes.lowercaseL, codes.lowercaseE];
-    const ABLE_SUFFIX = TABLE_NAME.slice(1);
+    const ABLE_SUFFIX = [codes.lowercaseA, codes.lowercaseB, codes.lowercaseL, codes.lowercaseE];
     /** Build a state chain that matches a sequence of character codes. */
     function matchChars(chars, onMatch, onFail) {
         if (chars.length === 0)
@@ -101568,7 +101575,14 @@ function tokenizeJsxTable(effects, ok, nok) {
         effects.enter('jsxTable');
         effects.enter('jsxTableData');
         effects.consume(code);
-        return matchChars(TABLE_NAME, afterTagName, nok);
+        return afterLessThan;
+    }
+    function afterLessThan(code) {
+        if (code === codes.uppercaseT || code === codes.lowercaseT) {
+            effects.consume(code);
+            return matchChars(ABLE_SUFFIX, afterTagName, nok);
+        }
+        return nok(code);
     }
     function afterTagName(code) {
         if (code === codes.greaterThan || code === codes.slash || code === codes.space || code === codes.horizontalTab) {
@@ -101640,14 +101654,21 @@ function tokenizeJsxTable(effects, ok, nok) {
     function closeSlash(code) {
         if (code === codes.slash) {
             effects.consume(code);
-            return matchChars(TABLE_NAME, closeGt, body);
+            return closeTagFirstChar;
         }
-        if (code === codes.uppercaseT) {
+        if (code === codes.uppercaseT || code === codes.lowercaseT) {
             effects.consume(code);
             return matchChars(ABLE_SUFFIX, openAfterTagName, body);
         }
         return body(code);
     }
+    function closeTagFirstChar(code) {
+        if (code === codes.uppercaseT || code === codes.lowercaseT) {
+            effects.consume(code);
+            return matchChars(ABLE_SUFFIX, closeGt, body);
+        }
+        return body(code);
+    }
     function openAfterTagName(code) {
         if (code === codes.greaterThan || code === codes.slash || code === codes.space || code === codes.horizontalTab) {
             depth += 1;
@@ -101723,10 +101744,10 @@ function jsx_table_syntax_tokenizeNonLazyContinuationStart(effects, ok, nok) {
     }
 }
 /**
- * Micromark extension that tokenizes `<Table>...</Table>` as a single flow block.
+ * Micromark extension that tokenizes `<Table>...</Table>` and `<table>...</table>`
+ * as a single flow block.
  *
- * Prevents CommonMark HTML block type 6 from matching `<Table>` (case-insensitive
- * match against `table`) and fragmenting it at blank lines.
+ * Prevents CommonMark HTML block type 6 from fragmenting table blocks at blank lines.
  */
 function jsxTable() {
     return {

package/dist/main.node.js

@@ -73519,9 +73519,16 @@ function formatHtmlForMdxish(html) {
     }
     // Removes the leading/trailing newlines
     let cleaned = processed.replace(/^\s*\n|\n\s*$/g, '');
-    // Convert literal \n sequences to actual newlines BEFORE processing backticks
-    // This prevents the backtick unescaping regex from incorrectly matching \n sequences
-    cleaned = cleaned.replace(/\\n/g, '\n');
+    // Convert literal \n sequences to actual newlines only inside <pre> and <code>.
+    // Because <pre> needs to respect the newline visual and
+    // escape characters should be processed in the <code> tag.
+    //
+    // We don't want to unescape every \n because it might break the HTML & cause errors
+    // Example: <script>console.log("\n");</script>
+    // Would get turned into: <script>console.log("
+    // ");</script>
+    // which is invalid javascript and will cause error
+    cleaned = cleaned.replace(/(<(pre|code)\b[^>]*>)([\s\S]*?)(<\/\2>)/gi, (_m, open, _tag, inner, close) => open + inner.replace(/\\n/g, '\n') + close);
     // Unescape backticks: \` -> ` (users escape backticks in template literals)
     // Handle both cases: \` (adjacent) and \ followed by ` (split by markdown parser)
     cleaned = cleaned.replace(/\\`/g, '`');
@@ -92101,7 +92108,7 @@ const hasFlowContent = (nodes) => {
  * a markdown table (phrasing-only) or keep as JSX <Table> (has flow content).
  */
 const processTableNode = (node, index, parent, documentPosition) => {
-    if (node.name !== 'Table')
+    if (node.name !== 'Table' && node.name !== 'table')
         return;
     const position = documentPosition ?? node.position;
     const { align: alignAttr } = getAttrs(node);
@@ -92215,7 +92222,7 @@ const mdxishTables = () => tree => {
         const node = _node;
         if (typeof index !== 'number' || !parent || !('children' in parent))
             return;
-        if (!node.value.startsWith('<Table'))
+        if (!node.value.startsWith('<Table') && !node.value.startsWith('<table'))
             return;
         try {
             const parsed = tableNodeProcessor.runSync(tableNodeProcessor.parse(node.value));
@@ -92237,13 +92244,10 @@ const mdxishTables = () => tree => {
                 }
             });
             visit(parsed, isMDXElement, (tableNode) => {
-                if (tableNode.name === 'Table') {
-                    processTableNode(tableNode, index, parent, node.position);
-                    // Stop after the outermost Table so nested Tables don't overwrite parent.children[index]
-                    // we let it get handled naturally
-                    return EXIT;
-                }
-                return undefined;
+                if (tableNode.name !== 'Table' && tableNode.name !== 'table')
+                    return undefined;
+                processTableNode(tableNode, index, parent, node.position);
+                return EXIT;
             });
         }
         catch {
@@ -104999,6 +105003,63 @@ function rehypeSanitize(options) {
   }
 }
 
+;// ./node_modules/mdast-util-newline-to-break/lib/index.js
+/**
+ * @typedef {import('mdast').Nodes} Nodes
+ * @typedef {import('mdast-util-find-and-replace').ReplaceFunction} ReplaceFunction
+ */
+
+
+
+/**
+ * Turn normal line endings into hard breaks.
+ *
+ * @param {Nodes} tree
+ *   Tree to change.
+ * @returns {undefined}
+ *   Nothing.
+ */
+function newlineToBreak(tree) {
+  findAndReplace(tree, [/\r?\n|\r/g, lib_replace])
+}
+
+/**
+ * Replace line endings.
+ *
+ * @type {ReplaceFunction}
+ */
+function lib_replace() {
+  return {type: 'break'}
+}
+
+;// ./node_modules/remark-breaks/lib/index.js
+/**
+ * @typedef {import('mdast').Root} Root
+ */
+
+
+
+/**
+ * Support hard breaks without needing spaces or escapes (turns enters into
+ * `<br>`s).
+ *
+ * @returns
+ *   Transform.
+ */
+function remarkBreaks() {
+  /**
+   * Transform.
+   *
+   * @param {Root} tree
+   *   Tree.
+   * @returns {undefined}
+   *   Nothing.
+   */
+  return function (tree) {
+    newlineToBreak(tree)
+  }
+}
+
 ;// ./errors/mdx-syntax-error.ts
 class MdxSyntaxError extends SyntaxError {
     original = null;
@@ -107804,6 +107865,7 @@ const tocHastToMdx = (toc, components, variables) => {
 
 
 
+
 const sanitizeSchema = cjs_default()(defaultSchema, {
     attributes: {
         a: ['target'],
@@ -107812,12 +107874,13 @@ const sanitizeSchema = cjs_default()(defaultSchema, {
         href: ['doc', 'ref', 'blog', 'changelog', 'page'],
     },
 });
-const compile_compile = (text, { components = {}, missingComponents, copyButtons, useTailwind, ...opts } = {}) => {
+const compile_compile = (text, { components = {}, missingComponents, copyButtons, useTailwind, hardBreaks, ...opts } = {}) => {
     // Destructure at runtime to avoid circular dependency issues
     const { codeTabsTransformer, ...transforms } = defaultTransforms;
     const remarkPlugins = [
         remarkFrontmatter,
         remarkGfm,
+        ...(hardBreaks ? [remarkBreaks] : []),
         ...Object.values(transforms),
         [codeTabsTransformer, { copyButtons }],
         [
@@ -114223,63 +114286,6 @@ function rehypeStringify(options) {
   }
 }
 
-;// ./node_modules/mdast-util-newline-to-break/lib/index.js
-/**
- * @typedef {import('mdast').Nodes} Nodes
- * @typedef {import('mdast-util-find-and-replace').ReplaceFunction} ReplaceFunction
- */
-
-
-
-/**
- * Turn normal line endings into hard breaks.
- *
- * @param {Nodes} tree
- *   Tree to change.
- * @returns {undefined}
- *   Nothing.
- */
-function newlineToBreak(tree) {
-  findAndReplace(tree, [/\r?\n|\r/g, lib_replace])
-}
-
-/**
- * Replace line endings.
- *
- * @type {ReplaceFunction}
- */
-function lib_replace() {
-  return {type: 'break'}
-}
-
-;// ./node_modules/remark-breaks/lib/index.js
-/**
- * @typedef {import('mdast').Root} Root
- */
-
-
-
-/**
- * Support hard breaks without needing spaces or escapes (turns enters into
- * `<br>`s).
- *
- * @returns
- *   Transform.
- */
-function remarkBreaks() {
-  /**
-   * Transform.
-   *
-   * @param {Root} tree
-   *   Tree.
-   * @returns {undefined}
-   *   Nothing.
-   */
-  return function (tree) {
-    newlineToBreak(tree)
-  }
-}
-
 ;// ./processor/plugin/flatten-table-cell-paragraphs.ts
 
 /** List elements that cause margin issues when adjacent to paragraphs */
@@ -119108,8 +119114,8 @@ const HTML_ELEMENT_BLOCK_RE = /<([a-zA-Z][a-zA-Z0-9-]*)[\s>][\s\S]*?<\/\1>/g;
 const NEWLINE_WITH_WHITESPACE_RE = /[^\S\n]*\n[^\S\n]*/g;
 /** Matches a closing block-level tag followed by non-tag text or by a newline then non-blank content. */
 const CLOSE_BLOCK_TAG_BOUNDARY_RE = /<\/([a-zA-Z][a-zA-Z0-9-]*)>\s*(?:(?!<)(\S)|\n([^\n]))/g;
-/** Tests whether a string contains a complete HTML element (open + close tag). */
-const COMPLETE_HTML_ELEMENT_RE = /<[a-zA-Z][^>]*>[\s\S]*<\/[a-zA-Z]/;
+/** Strips HTML open/close tags. Used to detect non-tag inner text content. */
+const HTML_TAG_STRIP_RE = /<\/?[a-zA-Z][^>]*>/g;
 
 ;// ./processor/transform/mdxish/magic-blocks/placeholder.ts
 const EMPTY_IMAGE_PLACEHOLDER = {
@@ -119349,10 +119355,12 @@ const parseTableCell = (text) => {
     const trimmedLines = normalized.split('\n').map(line => line.trimStart());
     const processed = trimmedLines.join('\n');
     const tree = contentParser.runSync(contentParser.parse(processed));
-    // Process markdown inside complete HTML elements (e.g. _emphasis_ within <li>).
-    // Bare tags like "<i>" are left for rehypeRaw since rehype-parse would mangle them.
+    // Process markdown inside HTML blocks that have non-tag inner text (e.g. `<div>**x**`
+    // or `<ul><li>_x_</li></ul>`). Pure bare tags like "<i>" or "<br>" are left for rehypeRaw
+    // since rehype-parse would mangle them (auto-closing void/inline elements).
     visit(tree, 'html', (node) => {
-        if (COMPLETE_HTML_ELEMENT_RE.test(node.value)) {
+        const hasInnerText = node.value.replace(HTML_TAG_STRIP_RE, '').trim().length > 0;
+        if (hasInnerText) {
             node.value = processMarkdownInHtmlString(node.value);
         }
         else {
@@ -121741,8 +121749,7 @@ function tokenizeJsxTable(effects, ok, nok) {
     let codeSpanOpenSize = 0;
     let codeSpanCloseSize = 0;
     let depth = 1;
-    const TABLE_NAME = [codes.uppercaseT, codes.lowercaseA, codes.lowercaseB, codes.lowercaseL, codes.lowercaseE];
-    const ABLE_SUFFIX = TABLE_NAME.slice(1);
+    const ABLE_SUFFIX = [codes.lowercaseA, codes.lowercaseB, codes.lowercaseL, codes.lowercaseE];
     /** Build a state chain that matches a sequence of character codes. */
     function matchChars(chars, onMatch, onFail) {
         if (chars.length === 0)
@@ -121762,7 +121769,14 @@ function tokenizeJsxTable(effects, ok, nok) {
         effects.enter('jsxTable');
         effects.enter('jsxTableData');
         effects.consume(code);
-        return matchChars(TABLE_NAME, afterTagName, nok);
+        return afterLessThan;
+    }
+    function afterLessThan(code) {
+        if (code === codes.uppercaseT || code === codes.lowercaseT) {
+            effects.consume(code);
+            return matchChars(ABLE_SUFFIX, afterTagName, nok);
+        }
+        return nok(code);
     }
     function afterTagName(code) {
         if (code === codes.greaterThan || code === codes.slash || code === codes.space || code === codes.horizontalTab) {
@@ -121834,14 +121848,21 @@ function tokenizeJsxTable(effects, ok, nok) {
     function closeSlash(code) {
         if (code === codes.slash) {
             effects.consume(code);
-            return matchChars(TABLE_NAME, closeGt, body);
+            return closeTagFirstChar;
         }
-        if (code === codes.uppercaseT) {
+        if (code === codes.uppercaseT || code === codes.lowercaseT) {
             effects.consume(code);
             return matchChars(ABLE_SUFFIX, openAfterTagName, body);
         }
         return body(code);
     }
+    function closeTagFirstChar(code) {
+        if (code === codes.uppercaseT || code === codes.lowercaseT) {
+            effects.consume(code);
+            return matchChars(ABLE_SUFFIX, closeGt, body);
+        }
+        return body(code);
+    }
     function openAfterTagName(code) {
         if (code === codes.greaterThan || code === codes.slash || code === codes.space || code === codes.horizontalTab) {
             depth += 1;
@@ -121917,10 +121938,10 @@ function jsx_table_syntax_tokenizeNonLazyContinuationStart(effects, ok, nok) {
     }
 }
 /**
- * Micromark extension that tokenizes `<Table>...</Table>` as a single flow block.
+ * Micromark extension that tokenizes `<Table>...</Table>` and `<table>...</table>`
+ * as a single flow block.
  *
- * Prevents CommonMark HTML block type 6 from matching `<Table>` (case-insensitive
- * match against `table`) and fragmenting it at blank lines.
+ * Prevents CommonMark HTML block type 6 from fragmenting table blocks at blank lines.
  */
 function jsxTable() {
     return {