@readme/markdown 14.13.1 → 14.13.2

package/dist/main.js

@@ -12645,6 +12645,10 @@ const tailwindPrefix = 'readme-tailwind';
 
 
 const TailwindRoot = ({ children, flow }) => {
+    // `styles/gfm.scss` spaces the wrapped block children through this element and
+    // relies on their margins collapsing through it. Keep it a plain block — no
+    // border, padding, or block formatting context (overflow, display: flow-root/
+    // flex/grid) — or the spacing breaks.
     const Tag = flow ? 'div' : 'span';
     return external_amd_react_commonjs_react_commonjs2_react_root_React_umd_react_default().createElement(Tag, { className: tailwindPrefix }, children);
 };
@@ -99107,7 +99111,7 @@ function normalizeProperties(node) {
  * Identifies custom MDX components and recursively parses markdown children.
  * Replaces tagName with PascalCase component name for React component resolution.
  *
- * @see {@link https://github.com/readmeio/rmdx/blob/main/docs/mdxish-flow.md}
+ * @see .claude/context/MDXish/Processor Overview.md
  * @param {Options} options - Configuration options
  * @param {CustomComponents} options.components - Available custom components
  * @param {Function} options.processMarkdown - Function to process markdown content
@@ -101605,6 +101609,13 @@ const htmlFlowTagNames = new Set([...htmlRawNames, ...htmlBlockNames]);
 // blank lines between nested JSX siblings don't fragment the block. Excludes table
 // tags (mdxishTables owns their blank lines) and voids (never close).
 const plainBlockClaimTagNames = new Set([...htmlBlockNames].filter(tag => !HTML_TABLE_STRUCTURE_TAGS.has(tag) && !HTML_VOID_ELEMENTS.has(tag)));
+const foreignContentTags = new Set(FOREIGN_CONTENT_TAGS);
+// Type-7 lowercase tags (a, span, button, and unknown names): CommonMark ends their
+// block at a blank line, fragmenting 4+ column children into indented code. Claimable
+// only in block-wrapper shape (see `blockWrapperOpenerRest`); lookalike openers
+// (`<https://…>`) never find a closer, so their claim retreats cleanly to CommonMark.
+// Voids never close and raw/foreign-content bodies have dedicated owners.
+const isBlockWrapperClaimTagName = (tag) => !htmlFlowTagNames.has(tag) && !HTML_VOID_ELEMENTS.has(tag) && !foreignContentTags.has(tag);
 // Both are 4 columns per CommonMark, but they mean different things: a tab advances
 // to the next multiple of TAB_STOP_WIDTH, and INDENTED_CODE_MIN_COLUMNS is the depth
 // at which a line would fragment into indented code. Named separately so the two
@@ -101669,6 +101680,11 @@ function createTokenize(mode) {
         // `plainClaimLineStart`: after a blank line it may only continue on a tag line.
         let isPlainBlockClaim = false;
         let pendingBlankLine = false;
+        // Type-7 tag claimed pending the block-wrapper (opener alone on its line) check.
+        let pendingBlockWrapperClaim = false;
+        // True once a block-wrapper claim is confirmed; relaxes the top-of-body island gate
+        // below (type-7 fallback is the fragmentation bug, not intentional indented code).
+        let isBlockWrapperClaim = false;
         // Leading indent columns of the current plain-claim line, reset per line; ≥4 is
         // where CommonMark would fragment the island as indented code. Tabs advance to the
         // next 4-column stop — the same rule `expandIndentToColumns`
@@ -101914,16 +101930,11 @@ function createTokenize(mode) {
             }
             // End of opening tag
             if (code === codes.greaterThan) {
-                if (requiresBraceAttr && !sawBraceAttr) {
-                    // Plain lowercase block tags stay claimable in flow, gated per line by
-                    // `plainClaimLineStart`; everything else falls through to CommonMark.
-                    if (!isFlow || !plainBlockClaimTagNames.has(tagName))
-                        return nok(code);
-                    isPlainBlockClaim = true;
-                }
+                if (requiresBraceAttr && !sawBraceAttr && !claimBraceLessTag())
+                    return nok(code);
                 effects.consume(code);
                 onOpenerLine = isFlow;
-                return body;
+                return pendingBlockWrapperClaim ? blockWrapperOpenerRest : body;
             }
             // Quoted attribute value
             if (code === codes.quotationMark || code === codes.apostrophe) {
@@ -101978,6 +101989,35 @@ function createTokenize(mode) {
             // `/ ` without `>` is just part of the attribute area
             return afterOpenTagName(code);
         }
+        // Whether a brace-less lowercase flow tag is claimable: type-6 tags immediately,
+        // type-7 tags pending the block-wrapper check; anything else is CommonMark's.
+        function claimBraceLessTag() {
+            if (!isFlow)
+                return false;
+            if (plainBlockClaimTagNames.has(tagName)) {
+                isPlainBlockClaim = true;
+                return true;
+            }
+            if (isBlockWrapperClaimTagName(tagName)) {
+                pendingBlockWrapperClaim = true;
+                return true;
+            }
+            return false;
+        }
+        // A type-7 tag is claimed only as a block wrapper: opener alone on its line
+        // (trailing spaces ok). Inline content after the opener bails to CommonMark.
+        function blockWrapperOpenerRest(code) {
+            if (markdownSpace(code)) {
+                effects.consume(code);
+                return blockWrapperOpenerRest;
+            }
+            if (!markdownLineEnding(code))
+                return nok(code);
+            pendingBlockWrapperClaim = false;
+            isPlainBlockClaim = true;
+            isBlockWrapperClaim = true;
+            return body(code);
+        }
         // Continuation for multi-line opening tags
         function openTagContinuationStart(code) {
             return effects.check(continuation_checks_nonLazyContinuationStart, openTagContinuationNonLazy, continuationAfter)(code);
@@ -102373,10 +102413,16 @@ function createTokenize(mode) {
         // continue on a tag line (`<…`); any markdown island (`**bold**`, `[block:…]`, a
         // fence) refuses so CommonMark html-flow reparses it exactly as it does today.
         function plainClaimLineStart(code) {
-            // Leading whitespace only → treat as a blank line, matching CommonMark.
-            if (code === codes.space || code === codes.horizontalTab) {
-                plainClaimIndentColumns +=
-                    code === codes.horizontalTab ? TAB_STOP_WIDTH - (plainClaimIndentColumns % TAB_STOP_WIDTH) : 1;
+            // Leading whitespace only → treat as a blank line, matching CommonMark. A tab
+            // advances to the next stop; its trailing `virtualSpace` fillers add nothing
+            // but must still be consumed or they'd read as line content below.
+            if (markdownSpace(code)) {
+                if (code === codes.horizontalTab) {
+                    plainClaimIndentColumns += TAB_STOP_WIDTH - (plainClaimIndentColumns % TAB_STOP_WIDTH);
+                }
+                else if (code === codes.space) {
+                    plainClaimIndentColumns += 1;
+                }
                 effects.consume(code);
                 return plainClaimLineStart;
             }
@@ -102388,10 +102434,11 @@ function createTokenize(mode) {
             if (pendingBlankLine) {
                 // A 4+ col island nested under other tags is cosmetic nesting indent, not code:
                 // keep claiming so promotion dedents + re-parses it as markdown (RM-17560).
-                // Tags whose bodies stay raw are excluded — a claimed island there would never
-                // be re-parsed and would leak as literal text.
+                // Block-wrapper claims extend this to top-of-body islands — their CommonMark
+                // fallback is the fragmentation bug, not intentional indented code. Tags whose
+                // bodies stay raw are excluded: a claimed island there would leak as literal text.
                 if (plainClaimIndentColumns >= INDENTED_CODE_MIN_COLUMNS &&
-                    sawPlainBlockBodyContent &&
+                    (sawPlainBlockBodyContent || isBlockWrapperClaim) &&
                     !NON_REPARSED_BODY_TAGS.has(tagName)) {
                     return plainClaimContinue(code);
                 }
@@ -106880,7 +106927,7 @@ function mdxishMdastToMd(mdast) {
  * Processes markdown content with MDX syntax support and returns a HAST.
  * Detects and renders custom component tags from the components hash.
  *
- * @see {@link https://github.com/readmeio/rmdx/blob/main/docs/mdxish-flow.md}
+ * @see .claude/context/MDXish/Processor Overview.md
  */
 function mdxish(mdContent, opts = {}) {
     const { components: userComponents = {}, safeMode = false, variables } = opts;
@@ -107220,7 +107267,7 @@ function buildRMDXModule(content, headings, tocHast, opts) {
  * @param opts - The options for the render
  * @returns The React component
  *
- * @see {@link https://github.com/readmeio/rmdx/blob/main/docs/mdxish-flow.md}
+ * @see .claude/context/MDXish/Processor Overview.md
  */
 const renderMdxish = (tree, opts = {}) => {
     const { components: userComponents = {}, variables, ...contextOpts } = opts;

package/dist/main.node.js

@@ -25271,6 +25271,10 @@ const tailwindPrefix = 'readme-tailwind';
 
 
 const TailwindRoot = ({ children, flow }) => {
+    // `styles/gfm.scss` spaces the wrapped block children through this element and
+    // relies on their margins collapsing through it. Keep it a plain block — no
+    // border, padding, or block formatting context (overflow, display: flow-root/
+    // flex/grid) — or the spacing breaks.
     const Tag = flow ? 'div' : 'span';
     return external_react_default().createElement(Tag, { className: tailwindPrefix }, children);
 };
@@ -119331,7 +119335,7 @@ function normalizeProperties(node) {
  * Identifies custom MDX components and recursively parses markdown children.
  * Replaces tagName with PascalCase component name for React component resolution.
  *
- * @see {@link https://github.com/readmeio/rmdx/blob/main/docs/mdxish-flow.md}
+ * @see .claude/context/MDXish/Processor Overview.md
  * @param {Options} options - Configuration options
  * @param {CustomComponents} options.components - Available custom components
  * @param {Function} options.processMarkdown - Function to process markdown content
@@ -121829,6 +121833,13 @@ const htmlFlowTagNames = new Set([...htmlRawNames, ...htmlBlockNames]);
 // blank lines between nested JSX siblings don't fragment the block. Excludes table
 // tags (mdxishTables owns their blank lines) and voids (never close).
 const plainBlockClaimTagNames = new Set([...htmlBlockNames].filter(tag => !HTML_TABLE_STRUCTURE_TAGS.has(tag) && !HTML_VOID_ELEMENTS.has(tag)));
+const foreignContentTags = new Set(FOREIGN_CONTENT_TAGS);
+// Type-7 lowercase tags (a, span, button, and unknown names): CommonMark ends their
+// block at a blank line, fragmenting 4+ column children into indented code. Claimable
+// only in block-wrapper shape (see `blockWrapperOpenerRest`); lookalike openers
+// (`<https://…>`) never find a closer, so their claim retreats cleanly to CommonMark.
+// Voids never close and raw/foreign-content bodies have dedicated owners.
+const isBlockWrapperClaimTagName = (tag) => !htmlFlowTagNames.has(tag) && !HTML_VOID_ELEMENTS.has(tag) && !foreignContentTags.has(tag);
 // Both are 4 columns per CommonMark, but they mean different things: a tab advances
 // to the next multiple of TAB_STOP_WIDTH, and INDENTED_CODE_MIN_COLUMNS is the depth
 // at which a line would fragment into indented code. Named separately so the two
@@ -121893,6 +121904,11 @@ function createTokenize(mode) {
         // `plainClaimLineStart`: after a blank line it may only continue on a tag line.
         let isPlainBlockClaim = false;
         let pendingBlankLine = false;
+        // Type-7 tag claimed pending the block-wrapper (opener alone on its line) check.
+        let pendingBlockWrapperClaim = false;
+        // True once a block-wrapper claim is confirmed; relaxes the top-of-body island gate
+        // below (type-7 fallback is the fragmentation bug, not intentional indented code).
+        let isBlockWrapperClaim = false;
         // Leading indent columns of the current plain-claim line, reset per line; ≥4 is
         // where CommonMark would fragment the island as indented code. Tabs advance to the
         // next 4-column stop — the same rule `expandIndentToColumns`
@@ -122138,16 +122154,11 @@ function createTokenize(mode) {
             }
             // End of opening tag
             if (code === codes.greaterThan) {
-                if (requiresBraceAttr && !sawBraceAttr) {
-                    // Plain lowercase block tags stay claimable in flow, gated per line by
-                    // `plainClaimLineStart`; everything else falls through to CommonMark.
-                    if (!isFlow || !plainBlockClaimTagNames.has(tagName))
-                        return nok(code);
-                    isPlainBlockClaim = true;
-                }
+                if (requiresBraceAttr && !sawBraceAttr && !claimBraceLessTag())
+                    return nok(code);
                 effects.consume(code);
                 onOpenerLine = isFlow;
-                return body;
+                return pendingBlockWrapperClaim ? blockWrapperOpenerRest : body;
             }
             // Quoted attribute value
             if (code === codes.quotationMark || code === codes.apostrophe) {
@@ -122202,6 +122213,35 @@ function createTokenize(mode) {
             // `/ ` without `>` is just part of the attribute area
             return afterOpenTagName(code);
         }
+        // Whether a brace-less lowercase flow tag is claimable: type-6 tags immediately,
+        // type-7 tags pending the block-wrapper check; anything else is CommonMark's.
+        function claimBraceLessTag() {
+            if (!isFlow)
+                return false;
+            if (plainBlockClaimTagNames.has(tagName)) {
+                isPlainBlockClaim = true;
+                return true;
+            }
+            if (isBlockWrapperClaimTagName(tagName)) {
+                pendingBlockWrapperClaim = true;
+                return true;
+            }
+            return false;
+        }
+        // A type-7 tag is claimed only as a block wrapper: opener alone on its line
+        // (trailing spaces ok). Inline content after the opener bails to CommonMark.
+        function blockWrapperOpenerRest(code) {
+            if (markdownSpace(code)) {
+                effects.consume(code);
+                return blockWrapperOpenerRest;
+            }
+            if (!markdownLineEnding(code))
+                return nok(code);
+            pendingBlockWrapperClaim = false;
+            isPlainBlockClaim = true;
+            isBlockWrapperClaim = true;
+            return body(code);
+        }
         // Continuation for multi-line opening tags
         function openTagContinuationStart(code) {
             return effects.check(continuation_checks_nonLazyContinuationStart, openTagContinuationNonLazy, continuationAfter)(code);
@@ -122597,10 +122637,16 @@ function createTokenize(mode) {
         // continue on a tag line (`<…`); any markdown island (`**bold**`, `[block:…]`, a
         // fence) refuses so CommonMark html-flow reparses it exactly as it does today.
         function plainClaimLineStart(code) {
-            // Leading whitespace only → treat as a blank line, matching CommonMark.
-            if (code === codes.space || code === codes.horizontalTab) {
-                plainClaimIndentColumns +=
-                    code === codes.horizontalTab ? TAB_STOP_WIDTH - (plainClaimIndentColumns % TAB_STOP_WIDTH) : 1;
+            // Leading whitespace only → treat as a blank line, matching CommonMark. A tab
+            // advances to the next stop; its trailing `virtualSpace` fillers add nothing
+            // but must still be consumed or they'd read as line content below.
+            if (markdownSpace(code)) {
+                if (code === codes.horizontalTab) {
+                    plainClaimIndentColumns += TAB_STOP_WIDTH - (plainClaimIndentColumns % TAB_STOP_WIDTH);
+                }
+                else if (code === codes.space) {
+                    plainClaimIndentColumns += 1;
+                }
                 effects.consume(code);
                 return plainClaimLineStart;
             }
@@ -122612,10 +122658,11 @@ function createTokenize(mode) {
             if (pendingBlankLine) {
                 // A 4+ col island nested under other tags is cosmetic nesting indent, not code:
                 // keep claiming so promotion dedents + re-parses it as markdown (RM-17560).
-                // Tags whose bodies stay raw are excluded — a claimed island there would never
-                // be re-parsed and would leak as literal text.
+                // Block-wrapper claims extend this to top-of-body islands — their CommonMark
+                // fallback is the fragmentation bug, not intentional indented code. Tags whose
+                // bodies stay raw are excluded: a claimed island there would leak as literal text.
                 if (plainClaimIndentColumns >= INDENTED_CODE_MIN_COLUMNS &&
-                    sawPlainBlockBodyContent &&
+                    (sawPlainBlockBodyContent || isBlockWrapperClaim) &&
                     !NON_REPARSED_BODY_TAGS.has(tagName)) {
                     return plainClaimContinue(code);
                 }
@@ -127104,7 +127151,7 @@ function mdxishMdastToMd(mdast) {
  * Processes markdown content with MDX syntax support and returns a HAST.
  * Detects and renders custom component tags from the components hash.
  *
- * @see {@link https://github.com/readmeio/rmdx/blob/main/docs/mdxish-flow.md}
+ * @see .claude/context/MDXish/Processor Overview.md
  */
 function mdxish(mdContent, opts = {}) {
     const { components: userComponents = {}, safeMode = false, variables } = opts;
@@ -127444,7 +127491,7 @@ function buildRMDXModule(content, headings, tocHast, opts) {
  * @param opts - The options for the render
  * @returns The React component
  *
- * @see {@link https://github.com/readmeio/rmdx/blob/main/docs/mdxish-flow.md}
+ * @see .claude/context/MDXish/Processor Overview.md
  */
 const renderMdxish = (tree, opts = {}) => {
     const { components: userComponents = {}, variables, ...contextOpts } = opts;