@mintlify/common 1.0.1118 → 1.0.1119

package/dist/mdx/plugins/remark/remarkMdxExpandExpressions.d.ts

@@ -71,9 +71,10 @@ export declare const MAX_MDX_FRAGMENTS_PER_PAGE = 500;
  * `<p>` wrapper is unwrapped so it does not nest in the surrounding paragraph.
  *
  * Escaping: the fragment source is JSX text, so a literal brace must be written the JSX way,
- * e.g. `{'{'}` / `{'}'}`; that expression is then evaluated by MDX and renders the brace. For the
- * same reason a custom heading anchor cannot use `## Title {#id}` inside an expression fragment;
- * write `<h2 id="id">Title</h2>` instead. Nothing beyond dedenting is done to the recovered text.
+ * e.g. `{'{'}` / `{'}'}`; that expression is then evaluated by MDX and renders the brace. A custom
+ * heading anchor (`## Title {#id}`) is fine: `preprocessCustomHeadingIds` rewrites it before the
+ * expression is parsed, at any indent inside `<MDX>`. Nothing beyond dedenting is done to the
+ * recovered text.
  *
  * Components defined on the page (`export const Local = () => …`, and named snippet imports,
  * which prebuild rewrites into page exports) are passed into the fragment pipeline as known

package/dist/mdx/plugins/remark/remarkMdxExpandExpressions.js

@@ -61,9 +61,10 @@ export const MAX_MDX_FRAGMENTS_PER_PAGE = 500;
  * `<p>` wrapper is unwrapped so it does not nest in the surrounding paragraph.
  *
  * Escaping: the fragment source is JSX text, so a literal brace must be written the JSX way,
- * e.g. `{'{'}` / `{'}'}`; that expression is then evaluated by MDX and renders the brace. For the
- * same reason a custom heading anchor cannot use `## Title {#id}` inside an expression fragment;
- * write `<h2 id="id">Title</h2>` instead. Nothing beyond dedenting is done to the recovered text.
+ * e.g. `{'{'}` / `{'}'}`; that expression is then evaluated by MDX and renders the brace. A custom
+ * heading anchor (`## Title {#id}`) is fine: `preprocessCustomHeadingIds` rewrites it before the
+ * expression is parsed, at any indent inside `<MDX>`. Nothing beyond dedenting is done to the
+ * recovered text.
  *
  * Components defined on the page (`export const Local = () => …`, and named snippet imports,
  * which prebuild rewrites into page exports) are passed into the fragment pipeline as known

package/dist/mdx/preprocessCustomHeadingIds.d.ts

@@ -16,6 +16,11 @@ export interface PreprocessCustomHeadingIdsOptions {
  *
  * Uses a line-by-line scan with fence state tracking to skip headings inside
  * code blocks, avoiding backtracking over large documents.
+ *
+ * Headings are matched with at most 3 spaces of indent (deeper is an indented code block),
+ * except inside an `<MDX>` block — including one nested in a `{…}` expression, where authors
+ * indent the body — whose content is dedented before parsing, so any indent is accepted there.
+ * Without this the `{#id}` would reach the expression parser as a JSX expression and fail.
  */
 export declare function preprocessCustomHeadingIds(content: string, options?: PreprocessCustomHeadingIdsOptions): string;
 export interface JsxHeadingElement extends MdxJsxFlowElement {

package/dist/mdx/preprocessCustomHeadingIds.js

@@ -1,4 +1,12 @@
 const HEADING_ID_RE = /^( {0,3})(#{1,6})\s+(.+?)\s*\{\s*#([^}]+?)\s*\}\s*$/;
+/**
+ * Inside an `<MDX>` block the body is dedented before it is parsed, so indentation carries no
+ * meaning there (4+ spaces is not an indented code block) and any indent may precede the heading.
+ */
+const MDX_HEADING_ID_RE = /^(\s*)(#{1,6})\s+(.+?)\s*\{\s*#([^}]+?)\s*\}\s*$/;
+// `<MDX>` or `<MDX className="x">`; not `<MDX />` (no body) and not `<MDXProvider>`
+const MDX_OPEN_RE = /<MDX(?:\s[^>]*[^/>\s])?\s*>/g;
+const MDX_CLOSE_RE = /<\/MDX\s*>/g;
 const UNSAFE_HTML_ATTR_CHARS = /[<>"]/g;
 /**
  * Characters to strip from custom heading IDs in the default (non-editor) path.
@@ -23,13 +31,19 @@ function normalizeCustomId(raw) {
  *
  * Uses a line-by-line scan with fence state tracking to skip headings inside
  * code blocks, avoiding backtracking over large documents.
+ *
+ * Headings are matched with at most 3 spaces of indent (deeper is an indented code block),
+ * except inside an `<MDX>` block — including one nested in a `{…}` expression, where authors
+ * indent the body — whose content is dedented before parsing, so any indent is accepted there.
+ * Without this the `{#id}` would reach the expression parser as a JSX expression and fail.
  */
 export function preprocessCustomHeadingIds(content, options) {
-    var _a;
+    var _a, _b, _c, _d, _e;
     const lines = content.split('\n');
     const result = [];
     let fenceChar;
     let fenceCount = 0;
+    let mdxDepth = 0;
     for (const line of lines) {
         const stripped = line.trimStart();
         if (fenceChar !== undefined) {
@@ -46,7 +60,7 @@ export function preprocessCustomHeadingIds(content, options) {
             result.push(line);
             continue;
         }
-        const heading = HEADING_ID_RE.exec(line);
+        const heading = (mdxDepth > 0 ? MDX_HEADING_ID_RE : HEADING_ID_RE).exec(line);
         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;
@@ -56,6 +70,7 @@ export function preprocessCustomHeadingIds(content, options) {
             result.push(`${indent}<h${level} id="${sanitizedId}">`, `${indent}${heading[3]}`, `${indent}</h${level}>`);
             continue;
         }
+        mdxDepth = Math.max(0, mdxDepth + ((_c = (_b = line.match(MDX_OPEN_RE)) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0) - ((_e = (_d = line.match(MDX_CLOSE_RE)) === null || _d === void 0 ? void 0 : _d.length) !== null && _e !== void 0 ? _e : 0));
         result.push(line);
     }
     return result.join('\n');

package/dist/mdx/preprocessCustomHeadingIds.test.js

@@ -23,6 +23,40 @@ describe('preprocessCustomHeadingIds', () => {
         const input = '    ## Heading {#custom-id}';
         expect(preprocessCustomHeadingIds(input)).toBe(input);
     });
+    it('converts headings at any indent inside an <MDX> block', () => {
+        const input = `{variant === "fos" ? (
+  <MDX>
+    ### Request a token {#request-token}
+
+    Body
+  </MDX>
+) : null}
+
+    ## Still code {#not-converted}`;
+        const output = preprocessCustomHeadingIds(input);
+        expect(output).toContain('    <h3 id="request-token">\n    Request a token\n    </h3>');
+        // depth is back to 0 after </MDX>: 4-space indent is an indented code block again
+        expect(output).toContain('    ## Still code {#not-converted}');
+    });
+    it('leaves code fences inside an <MDX> block alone', () => {
+        const input = `<MDX>
+    \`\`\`md
+    ## Heading {#custom-id}
+    \`\`\`
+</MDX>`;
+        expect(preprocessCustomHeadingIds(input)).toBe(input);
+    });
+    it('ignores an unrelated MDX-prefixed tag', () => {
+        const input = '<MDXProvider>\n    ## Heading {#custom-id}\n</MDXProvider>';
+        expect(preprocessCustomHeadingIds(input)).toBe(input);
+    });
+    it('does not treat a self-closing <MDX /> as opening a block', () => {
+        // a self-closing tag has no body; the any-indent rule must not stay on for the rest of the file
+        for (const tag of ['<MDX />', '<MDX/>', '<MDX className="x" />']) {
+            const input = `${tag}\n\n    ## Still code {#not-converted}`;
+            expect(preprocessCustomHeadingIds(input)).toBe(input);
+        }
+    });
     it('leaves tab-indented headings alone', () => {
         const input = '\t## Heading {#custom-id}';
         expect(preprocessCustomHeadingIds(input)).toBe(input);