@readme/markdown 13.8.2 → 13.8.4

package/dist/main.js

@@ -12110,17 +12110,22 @@ function getScrollParent(el) {
  * corresponding TOC links so the reader always knows where they are.
  */
 function useScrollHighlight(navRef) {
-    const [linkCount, setLinkCount] = (0,external_amd_react_commonjs_react_commonjs2_react_root_React_umd_react_.useState)(0);
+    const [tocKey, setTocKey] = (0,external_amd_react_commonjs_react_commonjs2_react_root_React_umd_react_.useState)('');
+    // Re-check after every render so we detect when children change
+    // (e.g. after page navigation). Only triggers a re-render when the
+    // set of TOC link hrefs actually differs.
     (0,external_amd_react_commonjs_react_commonjs2_react_root_React_umd_react_.useEffect)(() => {
         const nav = navRef.current;
         if (!nav)
             return;
-        const count = nav.querySelectorAll('a[href^="#"]').length;
-        setLinkCount(count);
-    }, [navRef]);
+        const key = Array.from(nav.querySelectorAll('a[href^="#"]'))
+            .map(a => a.getAttribute('href'))
+            .join('\0');
+        setTocKey(key);
+    });
     (0,external_amd_react_commonjs_react_commonjs2_react_root_React_umd_react_.useEffect)(() => {
         const nav = navRef.current;
-        if (!nav || typeof IntersectionObserver === 'undefined' || linkCount === 0)
+        if (!nav || typeof IntersectionObserver === 'undefined' || !tocKey)
             return undefined;
         const linkMap = buildLinkMap(nav);
         if (linkMap.size === 0)
@@ -12186,18 +12191,33 @@ function useScrollHighlight(navRef) {
         // Click a ToC link → immediately activate it, suppress the observer
         // until the smooth scroll finishes, then hand control back.
         const onClick = (e) => {
-            const anchor = e.target.closest?.('a[href^="#"]');
-            if (!anchor)
+            if (!(e.target instanceof Element))
+                return;
+            const anchor = e.target.closest('a[href^="#"]');
+            if (!(anchor instanceof HTMLAnchorElement))
                 return;
-            const id = decodeURIComponent(anchor.getAttribute('href').slice(1));
+            const id = decodeURIComponent(anchor.hash.slice(1));
             if (!linkMap.has(id))
                 return;
-            e.preventDefault();
+            if (window.location.hash !== anchor.hash) {
+                window.location.hash = anchor.hash;
+            }
             activate(id);
             clickLocked = true;
-            const unlock = () => { clickLocked = false; };
+            let unlockTimer = null;
+            const unlock = () => {
+                clickLocked = false;
+                scrollTarget.removeEventListener('scrollend', unlock);
+                window.removeEventListener('hashchange', unlock);
+                if (unlockTimer !== null) {
+                    window.clearTimeout(unlockTimer);
+                    unlockTimer = null;
+                }
+            };
             scrollTarget.addEventListener('scrollend', unlock, { once: true });
-            document.getElementById(id)?.scrollIntoView({ behavior: 'smooth' });
+            window.addEventListener('hashchange', unlock, { once: true });
+            // Fallback in case scrollend and hashchange don't fire
+            unlockTimer = window.setTimeout(unlock, 500);
         };
         headings.forEach(el => { observer.observe(el); });
         scrollTarget.addEventListener('scroll', onScroll, { passive: true });
@@ -12214,7 +12234,7 @@ function useScrollHighlight(navRef) {
             scrollTarget.removeEventListener('scroll', onScroll);
             nav.removeEventListener('click', onClick);
         };
-    }, [navRef, linkCount]);
+    }, [navRef, tocKey]);
 }
 function TableOfContents({ children }) {
     const navRef = (0,external_amd_react_commonjs_react_commonjs2_react_root_React_umd_react_.useRef)(null);
@@ -96456,10 +96476,10 @@ const parseTableCell = (text) => {
             node.value = escapeInvalidTags(node.value);
         }
     });
-    if (tree.children.length > 1) {
-        return tree.children;
-    }
-    return tree.children.flatMap(n => n.type === 'paragraph' && 'children' in n ? n.children : [n]);
+    const result = tree.children.length > 1
+        ? tree.children
+        : tree.children.flatMap(n => n.type === 'paragraph' && 'children' in n ? n.children : [n]);
+    return result;
 };
 const parseBlock = (text) => {
     if (!text.trim())
@@ -96671,7 +96691,9 @@ function transformMagicBlock(blockType, data, rawValue, options = {}) {
                 mapped[rowIndex][colIndex] = v;
                 return mapped;
             }, []);
-            const tokenizeCell = compatibilityMode ? textToBlock : parseTableCell;
+            const tokenizeCell = compatibilityMode
+                ? textToBlock
+                : parseTableCell;
             const tableChildren = Array.from({ length: rows + 1 }, (_, y) => ({
                 children: Array.from({ length: cols }, (__, x) => ({
                     children: sparseData[y]?.[x] ? tokenizeCell(preprocessBody(sparseData[y][x])) : [{ type: 'text', value: '' }],
@@ -98364,6 +98386,7 @@ function restoreSnakeCase(placeholderName, mapping) {
 ;// ./processor/transform/mdxish/mdxish-tables-to-jsx.ts
 
 
+
 const SELF_CLOSING_JSX_REGEX = /^\s*<[A-Z][^>]*\/>\s*$/;
 const mdxish_tables_to_jsx_alignToStyle = (align) => {
     if (!align || align === 'left')
@@ -98393,22 +98416,27 @@ const mdxishTablesToJsx = () => tree => {
         visit(table, mdxish_tables_to_jsx_isTableCell, (cell) => {
             if (hasFlowContent || cell.children.length === 0)
                 return;
-            const content = cell.children.length === 1 && cell.children[0].type === 'paragraph'
-                ? cell.children[0].children[0]
-                : cell.children[0];
-            if (!content)
-                return;
             visit(cell, 'break', (_, breakIndex, breakParent) => {
                 breakParent.children.splice(breakIndex, 1, { type: 'text', value: '\n' });
             });
-            if (!(phrasing(content) || content.type === 'plain') && content.type !== 'escape') {
-                // Plain HTML (e.g. <div>Hello</div>) is skipped here — it stays in GFM cells fine.
-                // But self-closing JSX components (e.g. <Image src="..." caption="..." />) serialize
-                // with newlines that break GFM cells, so they must trigger JSX <Table> serialization.
-                const isPlainHtml = content.type === 'html' && !SELF_CLOSING_JSX_REGEX.test(content.value);
-                if (!isPlainHtml) {
-                    hasFlowContent = true;
+            // 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) => {
@@ -98486,6 +98514,40 @@ const mdxishTablesToJsx = () => tree => {
 };
 /* harmony default export */ const mdxish_tables_to_jsx = (mdxishTablesToJsx);
 
+;// ./processor/transform/mdxish/normalize-compact-headings.ts
+
+/**
+ * Preprocessor to normalize compact headings.
+ *
+ * CommonMark requires whitespace after # for headings, but users often omit it.
+ * This preprocessor adds the space while being careful not to modify:
+ * - Content inside fenced code blocks (protected via protectCodeBlocks)
+ * - Escaped hashtags (\#)
+ * - Mid-line hashtags (text #hashtag)
+ *
+ * Examples:
+ * - `#Header` → `# Header`
+ * - `##Title` → `## Title`
+ * - `######H6` → `###### H6`
+ */
+function normalizeCompactHeadings(content) {
+    const { protectedContent, protectedCode } = protectCodeBlocks(content);
+    const normalizedLines = protectedContent.split('\n').map(line => {
+        // Skip escaped hashtags
+        if (line.startsWith('\\#')) {
+            return line;
+        }
+        // Match compact heading: start of line, 1-6 #, followed by non-space/non-# character
+        const headingMatch = line.match(/^(#{1,6})([^\s#])/);
+        if (headingMatch) {
+            // Insert space after hashtags: "##Header" → "## Header"
+            return `${headingMatch[1]} ${line.slice(headingMatch[1].length)}`;
+        }
+        return line;
+    });
+    return restoreCodeBlocks(normalizedLines.join('\n'), protectedCode);
+}
+
 ;// ./processor/transform/mdxish/normalize-table-separator.ts
 /**
  * Preprocessor to normalize malformed GFM table separator syntax.
@@ -100665,6 +100727,7 @@ function loadComponents() {
 
 
 
+
 
 
 const defaultTransformers = [
@@ -100688,6 +100751,7 @@ function preprocessContent(content, opts) {
     let result = normalizeTableSeparator(content);
     result = terminateHtmlFlowBlocks(result);
     result = closeSelfClosingHtmlTags(result);
+    result = normalizeCompactHeadings(result);
     result = safeMode ? result : preprocessJSXExpressions(result, jsxContext);
     return processSnakeCaseComponent(result, { knownComponents });
 }

package/dist/main.node.js

@@ -24706,17 +24706,22 @@ function TableOfContents_getScrollParent(el) {
  * corresponding TOC links so the reader always knows where they are.
  */
 function useScrollHighlight(navRef) {
-    const [linkCount, setLinkCount] = (0,external_react_.useState)(0);
+    const [tocKey, setTocKey] = (0,external_react_.useState)('');
+    // Re-check after every render so we detect when children change
+    // (e.g. after page navigation). Only triggers a re-render when the
+    // set of TOC link hrefs actually differs.
     (0,external_react_.useEffect)(() => {
         const nav = navRef.current;
         if (!nav)
             return;
-        const count = nav.querySelectorAll('a[href^="#"]').length;
-        setLinkCount(count);
-    }, [navRef]);
+        const key = Array.from(nav.querySelectorAll('a[href^="#"]'))
+            .map(a => a.getAttribute('href'))
+            .join('\0');
+        setTocKey(key);
+    });
     (0,external_react_.useEffect)(() => {
         const nav = navRef.current;
-        if (!nav || typeof IntersectionObserver === 'undefined' || linkCount === 0)
+        if (!nav || typeof IntersectionObserver === 'undefined' || !tocKey)
             return undefined;
         const linkMap = buildLinkMap(nav);
         if (linkMap.size === 0)
@@ -24782,18 +24787,33 @@ function useScrollHighlight(navRef) {
         // Click a ToC link → immediately activate it, suppress the observer
         // until the smooth scroll finishes, then hand control back.
         const onClick = (e) => {
-            const anchor = e.target.closest?.('a[href^="#"]');
-            if (!anchor)
+            if (!(e.target instanceof Element))
+                return;
+            const anchor = e.target.closest('a[href^="#"]');
+            if (!(anchor instanceof HTMLAnchorElement))
                 return;
-            const id = decodeURIComponent(anchor.getAttribute('href').slice(1));
+            const id = decodeURIComponent(anchor.hash.slice(1));
             if (!linkMap.has(id))
                 return;
-            e.preventDefault();
+            if (window.location.hash !== anchor.hash) {
+                window.location.hash = anchor.hash;
+            }
             activate(id);
             clickLocked = true;
-            const unlock = () => { clickLocked = false; };
+            let unlockTimer = null;
+            const unlock = () => {
+                clickLocked = false;
+                scrollTarget.removeEventListener('scrollend', unlock);
+                window.removeEventListener('hashchange', unlock);
+                if (unlockTimer !== null) {
+                    window.clearTimeout(unlockTimer);
+                    unlockTimer = null;
+                }
+            };
             scrollTarget.addEventListener('scrollend', unlock, { once: true });
-            document.getElementById(id)?.scrollIntoView({ behavior: 'smooth' });
+            window.addEventListener('hashchange', unlock, { once: true });
+            // Fallback in case scrollend and hashchange don't fire
+            unlockTimer = window.setTimeout(unlock, 500);
         };
         headings.forEach(el => { observer.observe(el); });
         scrollTarget.addEventListener('scroll', onScroll, { passive: true });
@@ -24810,7 +24830,7 @@ function useScrollHighlight(navRef) {
             scrollTarget.removeEventListener('scroll', onScroll);
             nav.removeEventListener('click', onClick);
         };
-    }, [navRef, linkCount]);
+    }, [navRef, tocKey]);
 }
 function TableOfContents({ children }) {
     const navRef = (0,external_react_.useRef)(null);
@@ -116650,10 +116670,10 @@ const parseTableCell = (text) => {
             node.value = escapeInvalidTags(node.value);
         }
     });
-    if (tree.children.length > 1) {
-        return tree.children;
-    }
-    return tree.children.flatMap(n => n.type === 'paragraph' && 'children' in n ? n.children : [n]);
+    const result = tree.children.length > 1
+        ? tree.children
+        : tree.children.flatMap(n => n.type === 'paragraph' && 'children' in n ? n.children : [n]);
+    return result;
 };
 const parseBlock = (text) => {
     if (!text.trim())
@@ -116865,7 +116885,9 @@ function transformMagicBlock(blockType, data, rawValue, options = {}) {
                 mapped[rowIndex][colIndex] = v;
                 return mapped;
             }, []);
-            const tokenizeCell = compatibilityMode ? textToBlock : parseTableCell;
+            const tokenizeCell = compatibilityMode
+                ? textToBlock
+                : parseTableCell;
             const tableChildren = Array.from({ length: rows + 1 }, (_, y) => ({
                 children: Array.from({ length: cols }, (__, x) => ({
                     children: sparseData[y]?.[x] ? tokenizeCell(preprocessBody(sparseData[y][x])) : [{ type: 'text', value: '' }],
@@ -118558,6 +118580,7 @@ function restoreSnakeCase(placeholderName, mapping) {
 ;// ./processor/transform/mdxish/mdxish-tables-to-jsx.ts
 
 
+
 const SELF_CLOSING_JSX_REGEX = /^\s*<[A-Z][^>]*\/>\s*$/;
 const mdxish_tables_to_jsx_alignToStyle = (align) => {
     if (!align || align === 'left')
@@ -118587,22 +118610,27 @@ const mdxishTablesToJsx = () => tree => {
         visit(table, mdxish_tables_to_jsx_isTableCell, (cell) => {
             if (hasFlowContent || cell.children.length === 0)
                 return;
-            const content = cell.children.length === 1 && cell.children[0].type === 'paragraph'
-                ? cell.children[0].children[0]
-                : cell.children[0];
-            if (!content)
-                return;
             visit(cell, 'break', (_, breakIndex, breakParent) => {
                 breakParent.children.splice(breakIndex, 1, { type: 'text', value: '\n' });
             });
-            if (!(phrasing(content) || content.type === 'plain') && content.type !== 'escape') {
-                // Plain HTML (e.g. <div>Hello</div>) is skipped here — it stays in GFM cells fine.
-                // But self-closing JSX components (e.g. <Image src="..." caption="..." />) serialize
-                // with newlines that break GFM cells, so they must trigger JSX <Table> serialization.
-                const isPlainHtml = content.type === 'html' && !SELF_CLOSING_JSX_REGEX.test(content.value);
-                if (!isPlainHtml) {
-                    hasFlowContent = true;
+            // 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) => {
@@ -118680,6 +118708,40 @@ const mdxishTablesToJsx = () => tree => {
 };
 /* harmony default export */ const mdxish_tables_to_jsx = (mdxishTablesToJsx);
 
+;// ./processor/transform/mdxish/normalize-compact-headings.ts
+
+/**
+ * Preprocessor to normalize compact headings.
+ *
+ * CommonMark requires whitespace after # for headings, but users often omit it.
+ * This preprocessor adds the space while being careful not to modify:
+ * - Content inside fenced code blocks (protected via protectCodeBlocks)
+ * - Escaped hashtags (\#)
+ * - Mid-line hashtags (text #hashtag)
+ *
+ * Examples:
+ * - `#Header` → `# Header`
+ * - `##Title` → `## Title`
+ * - `######H6` → `###### H6`
+ */
+function normalizeCompactHeadings(content) {
+    const { protectedContent, protectedCode } = protectCodeBlocks(content);
+    const normalizedLines = protectedContent.split('\n').map(line => {
+        // Skip escaped hashtags
+        if (line.startsWith('\\#')) {
+            return line;
+        }
+        // Match compact heading: start of line, 1-6 #, followed by non-space/non-# character
+        const headingMatch = line.match(/^(#{1,6})([^\s#])/);
+        if (headingMatch) {
+            // Insert space after hashtags: "##Header" → "## Header"
+            return `${headingMatch[1]} ${line.slice(headingMatch[1].length)}`;
+        }
+        return line;
+    });
+    return restoreCodeBlocks(normalizedLines.join('\n'), protectedCode);
+}
+
 ;// ./processor/transform/mdxish/normalize-table-separator.ts
 /**
  * Preprocessor to normalize malformed GFM table separator syntax.
@@ -120859,6 +120921,7 @@ function loadComponents() {
 
 
 
+
 
 
 const defaultTransformers = [
@@ -120882,6 +120945,7 @@ function preprocessContent(content, opts) {
     let result = normalizeTableSeparator(content);
     result = terminateHtmlFlowBlocks(result);
     result = closeSelfClosingHtmlTags(result);
+    result = normalizeCompactHeadings(result);
     result = safeMode ? result : preprocessJSXExpressions(result, jsxContext);
     return processSnakeCaseComponent(result, { knownComponents });
 }