@mintlify/common 1.0.806 → 1.0.808

package/dist/asyncapi/getEnumValues.d.ts

@@ -0,0 +1,2 @@
+import { AnyRecord } from '../types/asyncapi.js';
+export declare const getEnumValues: (value: AnyRecord | undefined) => Array<string | number | boolean> | undefined;

package/dist/asyncapi/getEnumValues.js

@@ -0,0 +1,7 @@
+export const getEnumValues = (value) => {
+    if (!Array.isArray(value === null || value === void 0 ? void 0 : value.enum)) {
+        return undefined;
+    }
+    const enumValues = value.enum.filter((option) => typeof option === 'string' || typeof option === 'number' || typeof option === 'boolean');
+    return enumValues.length > 0 ? enumValues : undefined;
+};

package/dist/asyncapi/index.d.ts

@@ -2,4 +2,5 @@ export * from './getAsyncApiDocumentFromUrl.js';
 export * from './validateAsyncApi.js';
 export * from './parseAsyncApiString.js';
 export * from './parser/getChannelData.js';
+export * from './getEnumValues.js';
 export * from './prepAsyncApiFrontmatter.js';

package/dist/asyncapi/index.js

@@ -2,4 +2,5 @@ export * from './getAsyncApiDocumentFromUrl.js';
 export * from './validateAsyncApi.js';
 export * from './parseAsyncApiString.js';
 export * from './parser/getChannelData.js';
+export * from './getEnumValues.js';
 export * from './prepAsyncApiFrontmatter.js';

package/dist/asyncapi/parser/extractSchemaProperties.js

@@ -1,3 +1,23 @@
+import { getEnumValues } from '../getEnumValues.js';
+const getSchemaType = (value, keys) => {
+    if ('type' in value) {
+        return value.type;
+    }
+    const customTypeKey = keys.find((key) => /^x-.*type$/.test(key));
+    if (customTypeKey) {
+        return value[customTypeKey];
+    }
+    const enumValues = getEnumValues(value);
+    if (enumValues === null || enumValues === void 0 ? void 0 : enumValues.length) {
+        const firstValue = enumValues[0];
+        if (typeof firstValue === 'boolean')
+            return 'boolean';
+        if (typeof firstValue === 'number')
+            return 'number';
+        return 'string';
+    }
+    return undefined;
+};
 export const extractSchemaProperties = (schema) => {
     if (!schema) {
         return [];
@@ -36,12 +56,13 @@ export const extractSchemaProperties = (schema) => {
         }
         if (typeof value === 'object' && !Array.isArray(value)) {
             const keys = Object.keys(value);
-            if ('type' in value || keys.some((key) => /^x-.*type$/.test(key))) {
-                const typeKey = 'type' in value ? 'type' : keys.find((key) => /^x-.*type$/.test(key));
+            const type = getSchemaType(value, keys);
+            if (type !== undefined) {
                 const prop = {
                     name: name,
-                    type: value[typeKey],
+                    type,
                     description: value.description || value['const'],
+                    enumValues: getEnumValues(value),
                     deprecated: value.deprecated,
                     required: requiredFields.has(name),
                 };

package/dist/mdx/index.d.ts

@@ -3,6 +3,7 @@ export * from './snippets/index.js';
 export * from './utils.js';
 export * from './plugins/index.js';
 export * from './lib/index.js';
+export * from './preprocessCustomHeadingIds.js';
 export * from './getMDXOptions.js';
 export * from './astUtils.js';
 export * from './getS3ImageUri.js';

package/dist/mdx/index.js

@@ -3,6 +3,7 @@ export * from './snippets/index.js';
 export * from './utils.js';
 export * from './plugins/index.js';
 export * from './lib/index.js';
+export * from './preprocessCustomHeadingIds.js';
 export * from './getMDXOptions.js';
 export * from './astUtils.js';
 export * from './getS3ImageUri.js';

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

@@ -37,7 +37,7 @@ export const remarkComponentIds = (pageMetadata) => (tree) => {
     const tabSlugs = new Map();
     const headingSlugs = new Map();
     const precomputeTabSlugs = (node) => {
-        var _a, _b;
+        var _a, _b, _c;
         if (node.type === 'mdxJsxFlowElement' && node.name === 'Tab') {
             const title = (_a = node.attributes.find((attr) => 'name' in attr && attr.name === 'title')) === null || _a === void 0 ? void 0 : _a.value;
             if (title && typeof title === 'string') {
@@ -45,8 +45,9 @@ export const remarkComponentIds = (pageMetadata) => (tree) => {
                 tabSlugs.set(node, slug);
             }
         }
-        else if (node.type === 'mdxJsxFlowElement' && node.name === 'Heading') {
-            const id = (_b = node.attributes.find((attr) => 'name' in attr && attr.name === 'id')) === null || _b === void 0 ? void 0 : _b.value;
+        else if (node.type === 'mdxJsxFlowElement' &&
+            (node.name === 'Heading' || ['h1', 'h2', 'h3', 'h4'].includes((_b = node.name) !== null && _b !== void 0 ? _b : ''))) {
+            const id = (_c = node.attributes.find((attr) => 'name' in attr && attr.name === 'id')) === null || _c === void 0 ? void 0 : _c.value;
             if (id && typeof id === 'string')
                 headingSlugs.set(node, id);
         }
@@ -90,9 +91,16 @@ export const remarkComponentIds = (pageMetadata) => (tree) => {
             }
         }
     };
+    const isHeadingNode = (node) => {
+        var _a;
+        return node.type === 'mdxJsxFlowElement' &&
+            (node.name === 'Heading' || ['h1', 'h2', 'h3', 'h4'].includes((_a = node.name) !== null && _a !== void 0 ? _a : ''));
+    };
     const collectDirectChildIds = (node, type) => {
         const childIds = [];
-        if (node.type === 'mdxJsxFlowElement' && node.name === type) {
+        const isMatch = node.type === 'mdxJsxFlowElement' &&
+            (type === 'Tab' ? node.name === 'Tab' : isHeadingNode(node));
+        if (isMatch) {
             const id = type === 'Tab' ? tabSlugs.get(node) : headingSlugs.get(node);
             if (id) {
                 childIds.push(id);

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

@@ -1,4 +1,3 @@
-import { slugifyWithCounter } from '@sindresorhus/slugify';
 import { visit } from 'unist-util-visit';
 import { slugify } from '../../../slugify.js';
 import { createMdxJsxAttribute, getTableOfContentsTitle } from '../../lib/remark-utils.js';
@@ -19,9 +18,20 @@ function getStringAttribute(attributes, name) {
     return undefined;
 }
 export const remarkExtractTableOfContents = (mdxExtracts, pageMetadata) => {
-    // slugifyWithCounter adds a counter (eg. slug, slug-2, slug-3) to the end of the slug if the header
-    // already exists. No counter is added for the first occurence.
-    const slugifyFn = slugifyWithCounter();
+    // Unified slug deduplication: both custom IDs and auto-generated slugs
+    // share the same seen-slug state so they cannot collide.
+    const seenSlugs = new Map();
+    const deduplicateSlug = (slug) => {
+        var _a;
+        const count = (_a = seenSlugs.get(slug)) !== null && _a !== void 0 ? _a : 0;
+        seenSlugs.set(slug, count + 1);
+        if (count === 0)
+            return slug;
+        const suffixed = `${slug}-${count + 1}`;
+        if (!seenSlugs.has(suffixed))
+            seenSlugs.set(suffixed, 0);
+        return suffixed;
+    };
     return (tree) => {
         const contents = [];
         let hasTopLayer = false;
@@ -58,7 +68,7 @@ export const remarkExtractTableOfContents = (mdxExtracts, pageMetadata) => {
             }
         });
         visit(tree, (node) => {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            var _a, _b, _c, _d, _e, _f, _g, _h;
             if (excludedNodes.has(node))
                 return;
             const currentTabId = tabContentMap.get(node);
@@ -110,6 +120,10 @@ export const remarkExtractTableOfContents = (mdxExtracts, pageMetadata) => {
             else if ('name' in node && ((_g = node.name) === null || _g === void 0 ? void 0 : _g[1])) {
                 const num = Number(node.name[1]);
                 level = !isNaN(num) ? num : undefined;
+                if (level !== undefined) {
+                    // @ts-expect-error we're assigning to depth despite the node not containing depth in the type
+                    node.depth = level;
+                }
             }
             let title;
             if ('name' in node && node.name === 'Step') {
@@ -119,28 +133,46 @@ export const remarkExtractTableOfContents = (mdxExtracts, pageMetadata) => {
                 title = getTableOfContentsTitle(node);
             }
             let slug;
-            if ('name' in node &&
-                (node.name === 'Heading' || node.name === 'Step' || node.name === 'Update')) {
-                slug = (_j = getStringAttribute(node.attributes, 'id')) !== null && _j !== void 0 ? _j : slugify(title, slugifyFn);
+            const explicitId = ('name' in node &&
+                (node.name === 'Heading' || node.name === 'Step' || node.name === 'Update')) ||
+                hasIdAttribute
+                ? getStringAttribute(node.attributes, 'id')
+                : undefined;
+            if (explicitId) {
+                slug = deduplicateSlug(explicitId);
             }
             else {
-                slug = slugify(title, slugifyFn);
+                slug = deduplicateSlug(slugify(title));
             }
             let mdxJsxAttributes;
             if ('name' in node && node.name === 'Update') {
                 const existingId = getStringAttribute(node.attributes, 'id');
-                mdxJsxAttributes = existingId
-                    ? node.attributes
-                    : [...node.attributes, createMdxJsxAttribute('id', slug)];
+                mdxJsxAttributes = !existingId
+                    ? [...node.attributes, createMdxJsxAttribute('id', slug)]
+                    : existingId !== slug
+                        ? node.attributes.map((attr) => 'name' in attr && attr.name === 'id' ? createMdxJsxAttribute('id', slug) : attr)
+                        : node.attributes;
             }
             else if ('name' in node && node.name === 'Step') {
                 const existingId = getStringAttribute(node.attributes, 'id');
-                mdxJsxAttributes = existingId
-                    ? node.attributes
-                    : [...node.attributes, createMdxJsxAttribute('id', slug)];
+                mdxJsxAttributes = !existingId
+                    ? [...node.attributes, createMdxJsxAttribute('id', slug)]
+                    : existingId !== slug
+                        ? node.attributes.map((attr) => 'name' in attr && attr.name === 'id' ? createMdxJsxAttribute('id', slug) : attr)
+                        : node.attributes;
             }
             else if ('name' in node && node.name === 'Heading') {
-                mdxJsxAttributes = node.attributes;
+                mdxJsxAttributes =
+                    explicitId && slug !== explicitId
+                        ? node.attributes.map((attr) => 'name' in attr && attr.name === 'id' ? createMdxJsxAttribute('id', slug) : attr)
+                        : node.attributes;
+            }
+            else if (level !== undefined && hasIdAttribute) {
+                // JSX heading with an explicit id attribute (e.g. <h2 id="custom-id">)
+                const updatedAttrs = explicitId && slug !== explicitId
+                    ? node.attributes.map((attr) => 'name' in attr && attr.name === 'id' ? createMdxJsxAttribute('id', slug) : attr)
+                    : node.attributes;
+                mdxJsxAttributes = [createMdxJsxAttribute('level', level), ...updatedAttrs];
             }
             else if (level !== undefined && !hasIdAttribute) {
                 mdxJsxAttributes = [
@@ -151,6 +183,14 @@ export const remarkExtractTableOfContents = (mdxExtracts, pageMetadata) => {
                     mdxJsxAttributes.push(...node.attributes);
                 }
             }
+            // Unwrap paragraph children inside JSX headings (e.g. <h2>) so that the
+            // Heading component receives inline children instead of <p>-wrapped text.
+            // This happens because the preprocessor places text on its own line between
+            // JSX tags, which MDX parses as a paragraph block.
+            if (isValidMdxHeading && 'children' in node) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                node.children = node.children.flatMap((child) => child.type === 'paragraph' && 'children' in child ? child.children : [child]);
+            }
             // @ts-expect-error we're assigning over 'attributes' if it doesn't exist
             node.attributes = mdxJsxAttributes;
             node.type = 'mdxJsxFlowElement';

package/dist/mdx/preprocessCustomHeadingIds.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Converts markdown headings with custom ID syntax into JSX heading elements.
+ *
+ * Transforms `## Heading text {#custom-id}` into `<h2 id="custom-id">Heading text</h2>`.
+ * This avoids MDX parsing errors (MDX treats `{...}` as JS expressions) and
+ * produces JSX heading elements that the existing remark pipeline already handles.
+ */
+export declare function preprocessCustomHeadingIds(content: string): string;

package/dist/mdx/preprocessCustomHeadingIds.js

@@ -0,0 +1,20 @@
+import slugify from '@sindresorhus/slugify';
+/**
+ * Converts markdown headings with custom ID syntax into JSX heading elements.
+ *
+ * Transforms `## Heading text {#custom-id}` into `<h2 id="custom-id">Heading text</h2>`.
+ * This avoids MDX parsing errors (MDX treats `{...}` as JS expressions) and
+ * produces JSX heading elements that the existing remark pipeline already handles.
+ */
+export function preprocessCustomHeadingIds(content) {
+    // Single pass: match code fences (returned unchanged) or headings with
+    // custom IDs (transformed to JSX). Backreferences \1 / \2 ensure the
+    // closing fence matches the opening fence length.
+    return content.replace(/^(`{3,})[^\n]*\n[\s\S]*?^\1\s*$|^(~{3,})[^\n]*\n[\s\S]*?^\2\s*$|^(#{1,4})\s+(.+?)\s*\{\s*#([^}]+?)\s*\}\s*$/gm, (match, _backtickFence, _tildeFence, hashes, text, id) => {
+        if (!hashes)
+            return match; // code fence — leave unchanged
+        const level = hashes.length;
+        const sanitizedId = slugify(id.trim(), { preserveCharacters: ['_'] });
+        return `<h${level} id="${sanitizedId}">\n${text}\n</h${level}>`;
+    });
+}

package/dist/mdx/remark.js

@@ -4,6 +4,7 @@ import remarkGfm from 'remark-gfm';
 import remarkMath from 'remark-math';
 import remarkMdx from 'remark-mdx';
 import remarkStringify from 'remark-stringify';
+import { preprocessCustomHeadingIds } from './preprocessCustomHeadingIds.js';
 import { getJsxEsmTree } from './snippets/getJsxEsmTree.js';
 import { isJsxOrTsx } from './snippets/isJsxOrTsx.js';
 export const coreRemarkMdxPlugins = [
@@ -17,6 +18,6 @@ export const getAST = (str, filePath) => {
     if (isJsxOrTsx(filePath)) {
         return getJsxEsmTree(str, filePath);
     }
-    return coreRemark().parse(str);
+    return coreRemark().parse(preprocessCustomHeadingIds(str));
 };
 export const stringifyTree = (tree) => coreRemark().use(remarkStringify).stringify(tree);

package/dist/mdx/server-only/getMdx.js

@@ -11,13 +11,14 @@ import { serialize } from '@mintlify/mdx/server';
 import { getTailwindSelectors } from '../../css/tailwind.js';
 import { getMDXOptions, remarkMdxRemoveJs, remarkExpandContent, remarkSplitCodeGroup, remarkSplitTabs, remarkValidateSteps, remarkValidateTabs, } from '../../index.js';
 import { codeStylingToThemeOrThemes } from '../getCodeStyling.js';
+import { preprocessCustomHeadingIds } from '../preprocessCustomHeadingIds.js';
 import { replaceVariables } from '../replaceVariables.js';
 import { createSnippetTreeMap } from './getMdx/snippets.js';
 export function getMdx(_a) {
     return __awaiter(this, arguments, void 0, function* ({ path, content, metadata, snippets, subdomain, codeStyling, config, tailwindSelectors = undefined, pageType = 'default', trace = undefined, customLanguages = [], variables = undefined, }) {
         const traceFn = trace !== null && trace !== void 0 ? trace : ((_name, fn) => fn());
-        const processedContent = replaceVariables(content, variables);
-        const processedSnippets = snippets.map((snippet) => (Object.assign(Object.assign({}, snippet), { content: replaceVariables(snippet.content, variables) })));
+        const processedContent = preprocessCustomHeadingIds(replaceVariables(content, variables));
+        const processedSnippets = snippets.map((snippet) => (Object.assign(Object.assign({}, snippet), { content: preprocessCustomHeadingIds(replaceVariables(snippet.content, variables)) })));
         if (!tailwindSelectors)
             tailwindSelectors = yield traceFn('getMdx.getTailwindSelectors', () => __awaiter(this, void 0, void 0, function* () { return getTailwindSelectors({ content: processedContent }); }));
         const snippetTreeMap = yield traceFn('getMdx.createSnippetTreeMap', () => __awaiter(this, void 0, void 0, function* () { return createSnippetTreeMap(processedSnippets); }));