@mintlify/common 1.0.1092 → 1.0.1094

package/dist/mdx/preprocessCustomHeadingIds.js

@@ -1,4 +1,4 @@
-const HEADING_ID_RE = /^(#{1,6})\s+(.+?)\s*\{\s*#([^}]+?)\s*\}\s*$/;
+const HEADING_ID_RE = /^( {0,3})(#{1,6})\s+(.+?)\s*\{\s*#([^}]+?)\s*\}\s*$/;
 const UNSAFE_HTML_ATTR_CHARS = /[<>"]/g;
 /**
  * Characters to strip from custom heading IDs in the default (non-editor) path.
@@ -25,6 +25,7 @@ function normalizeCustomId(raw) {
  * code blocks, avoiding backtracking over large documents.
  */
 export function preprocessCustomHeadingIds(content, options) {
+    var _a;
     const lines = content.split('\n');
     const result = [];
     let fenceChar;
@@ -46,12 +47,13 @@ export function preprocessCustomHeadingIds(content, options) {
             continue;
         }
         const heading = HEADING_ID_RE.exec(line);
-        if ((heading === null || heading === void 0 ? void 0 : heading[1]) && heading[2] && heading[3]) {
-            const level = heading[1].length;
+        if ((heading === null || heading === void 0 ? void 0 : heading[2]) && heading[3] && heading[4]) {
+            const indent = (_a = heading[1]) !== null && _a !== void 0 ? _a : '';
+            const level = heading[2].length;
             const sanitizedId = (options === null || options === void 0 ? void 0 : options.preserveOriginal)
-                ? sanitizeHtmlAttr(heading[3])
-                : normalizeCustomId(heading[3]);
-            result.push(`<h${level} id="${sanitizedId}">`, heading[2], `</h${level}>`);
+                ? sanitizeHtmlAttr(heading[4])
+                : normalizeCustomId(heading[4]);
+            result.push(`${indent}<h${level} id="${sanitizedId}">`, `${indent}${heading[3]}`, `${indent}</h${level}>`);
             continue;
         }
         result.push(line);

package/dist/mdx/preprocessCustomHeadingIds.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/mdx/preprocessCustomHeadingIds.test.js

@@ -0,0 +1,48 @@
+import { describe, expect, it } from 'vitest';
+import { preprocessCustomHeadingIds } from './preprocessCustomHeadingIds.js';
+describe('preprocessCustomHeadingIds', () => {
+    it('converts top-level headings with custom ids', () => {
+        expect(preprocessCustomHeadingIds('## Heading {#custom-id}')).toBe('<h2 id="custom-id">\nHeading\n</h2>');
+    });
+    it('converts headings indented by up to 3 spaces and preserves indentation', () => {
+        expect(preprocessCustomHeadingIds('  ## Heading {#custom_id}')).toBe('  <h2 id="custom_id">\n  Heading\n  </h2>');
+        expect(preprocessCustomHeadingIds(' # A {#a}')).toBe(' <h1 id="a">\n A\n </h1>');
+        expect(preprocessCustomHeadingIds('   ### B {#b}')).toBe('   <h3 id="b">\n   B\n   </h3>');
+    });
+    it('converts indented headings inside JSX components', () => {
+        const input = `<Update label="March 2026">
+  ## Release Notes {#release_notes}
+
+  Content
+</Update>`;
+        const output = preprocessCustomHeadingIds(input);
+        expect(output).toContain('  <h2 id="release_notes">\n  Release Notes\n  </h2>');
+        expect(output).not.toContain('{#');
+    });
+    it('leaves headings indented by 4 or more spaces alone', () => {
+        const input = '    ## Heading {#custom-id}';
+        expect(preprocessCustomHeadingIds(input)).toBe(input);
+    });
+    it('leaves tab-indented headings alone', () => {
+        const input = '\t## Heading {#custom-id}';
+        expect(preprocessCustomHeadingIds(input)).toBe(input);
+    });
+    it('leaves indented headings inside code fences alone', () => {
+        const input = `\`\`\`md
+  ## Heading {#custom-id}
+\`\`\``;
+        expect(preprocessCustomHeadingIds(input)).toBe(input);
+    });
+    it('leaves headings inside indented code fences alone', () => {
+        const input = `  \`\`\`md
+  ## Heading {#custom-id}
+  \`\`\``;
+        expect(preprocessCustomHeadingIds(input)).toBe(input);
+    });
+    it('normalizes ids by default', () => {
+        expect(preprocessCustomHeadingIds('  ## Heading {#my id!}')).toBe('  <h2 id="my-id">\n  Heading\n  </h2>');
+    });
+    it('preserves original ids when preserveOriginal is set', () => {
+        expect(preprocessCustomHeadingIds('  ## Heading {#my_id}', { preserveOriginal: true })).toBe('  <h2 id="my_id">\n  Heading\n  </h2>');
+    });
+});