@readme/markdown 13.8.3 → 13.8.4

package/components/TableOfContents/index.tsx

@@ -42,18 +42,23 @@ function getScrollParent(el: HTMLElement): HTMLElement | Window {
  * corresponding TOC links so the reader always knows where they are.
  */
 function useScrollHighlight(navRef: React.RefObject<HTMLElement | null>) {
-  const [linkCount, setLinkCount] = useState(0);
+  const [tocKey, setTocKey] = 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.
   useEffect(() => {
     const nav = navRef.current;
     if (!nav) return;
-    const count = nav.querySelectorAll('a[href^="#"]').length;
-    setLinkCount(count);
-  }, [navRef]);
+    const key = Array.from(nav.querySelectorAll<HTMLAnchorElement>('a[href^="#"]'))
+      .map(a => a.getAttribute('href'))
+      .join('\0');
+    setTocKey(key);
+  });
 
   useEffect(() => {
     const nav = navRef.current;
-    if (!nav || typeof IntersectionObserver === 'undefined' || linkCount === 0) return undefined;
+    if (!nav || typeof IntersectionObserver === 'undefined' || !tocKey) return undefined;
 
     const linkMap = buildLinkMap(nav);
     if (linkMap.size === 0) return undefined;
@@ -172,7 +177,7 @@ function useScrollHighlight(navRef: React.RefObject<HTMLElement | null>) {
       scrollTarget.removeEventListener('scroll', onScroll);
       nav.removeEventListener('click', onClick);
     };
-  }, [navRef, linkCount]);
+  }, [navRef, tocKey]);
 }
 
 function TableOfContents({ children }: React.PropsWithChildren) {

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)
@@ -12229,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);
@@ -98509,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.
@@ -100688,6 +100727,7 @@ function loadComponents() {
 
 
 
+
 
 
 const defaultTransformers = [
@@ -100711,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)
@@ -24825,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);
@@ -118703,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.
@@ -120882,6 +120921,7 @@ function loadComponents() {
 
 
 
+
 
 
 const defaultTransformers = [
@@ -120905,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 });
 }