@mintlify/common 1.0.836 → 1.0.838

package/dist/mdx/preprocessCustomHeadingIds.d.ts

@@ -1,5 +1,12 @@
 import type { RootContent } from 'mdast';
 import { MdxJsxFlowElement } from 'mdast-util-mdx-jsx';
+export interface PreprocessCustomHeadingIdsOptions {
+    /**
+     * When true, preserves the original ID as-is (only removing characters unsafe
+     * in HTML attributes). When false (default), applies slugify for normalized IDs.
+     */
+    preserveOriginal?: boolean;
+}
 /**
  * Converts markdown headings with custom ID syntax into JSX heading elements.
  *
@@ -10,7 +17,7 @@ import { MdxJsxFlowElement } from 'mdast-util-mdx-jsx';
  * Uses a line-by-line scan with fence state tracking to skip headings inside
  * code blocks, avoiding backtracking over large documents.
  */
-export declare function preprocessCustomHeadingIds(content: string): string;
+export declare function preprocessCustomHeadingIds(content: string, options?: PreprocessCustomHeadingIdsOptions): string;
 export interface JsxHeadingElement extends MdxJsxFlowElement {
     readonly __jsxHeading: true;
 }

package/dist/mdx/preprocessCustomHeadingIds.js

@@ -1,5 +1,9 @@
 import slugify from '@sindresorhus/slugify';
 const HEADING_ID_RE = /^(#{1,6})\s+(.+?)\s*\{\s*#([^}]+?)\s*\}\s*$/;
+const UNSAFE_HTML_ATTR_CHARS = /[<>"]/g;
+function sanitizeHtmlAttr(id) {
+    return id.trim().replace(UNSAFE_HTML_ATTR_CHARS, '');
+}
 /**
  * Converts markdown headings with custom ID syntax into JSX heading elements.
  *
@@ -10,7 +14,7 @@ const HEADING_ID_RE = /^(#{1,6})\s+(.+?)\s*\{\s*#([^}]+?)\s*\}\s*$/;
  * Uses a line-by-line scan with fence state tracking to skip headings inside
  * code blocks, avoiding backtracking over large documents.
  */
-export function preprocessCustomHeadingIds(content) {
+export function preprocessCustomHeadingIds(content, options) {
     const lines = content.split('\n');
     const result = [];
     let fenceChar;
@@ -34,7 +38,9 @@ export function preprocessCustomHeadingIds(content) {
         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;
-            const sanitizedId = slugify(heading[3].trim(), { preserveCharacters: ['_'] });
+            const sanitizedId = (options === null || options === void 0 ? void 0 : options.preserveOriginal)
+                ? sanitizeHtmlAttr(heading[3])
+                : slugify(heading[3].trim(), { preserveCharacters: ['_'] });
             result.push(`<h${level} id="${sanitizedId}">`, heading[2], `</h${level}>`);
             continue;
         }

package/dist/mdx/utils.js

@@ -109,6 +109,7 @@ export const allowedComponents = [
     'h3',
     'h4',
     'head',
+    'hr',
     'iframe',
     'img',
     'input',

package/dist/navigation/getAllPathsInDecoratedNav.d.ts

@@ -0,0 +1,2 @@
+import { DecoratedNavigationConfig } from '@mintlify/validation';
+export declare function getAllPathsInDecoratedNav(nav: DecoratedNavigationConfig, paths?: string[]): string[];

package/dist/navigation/getAllPathsInDecoratedNav.js

@@ -0,0 +1,36 @@
+import { divisions, } from '@mintlify/validation';
+import { isAbsoluteUrl } from '../isAbsoluteUrl.js';
+import { optionallyRemoveLeadingSlash } from '../optionallyRemoveLeadingSlash.js';
+import { isPage } from './isPage.js';
+export function getAllPathsInDecoratedNav(nav, paths = []) {
+    getPaths(nav, paths);
+    return paths;
+}
+function getPaths(entry, paths) {
+    if (isPage(entry)) {
+        const internalPath = toInternalPath(entry.href);
+        if (internalPath !== undefined) {
+            paths.push(internalPath);
+        }
+        return;
+    }
+    if (entry.root != null && typeof entry.root === 'object') {
+        getPaths(entry.root, paths);
+    }
+    if (Array.isArray(entry.pages)) {
+        entry.pages.forEach((page) => getPaths(page, paths));
+        return;
+    }
+    for (const division of ['groups', ...divisions]) {
+        const items = entry[division];
+        if (!Array.isArray(items))
+            continue;
+        items.forEach((item) => getPaths(item, paths));
+    }
+}
+function toInternalPath(href) {
+    if (!href || href.startsWith('#') || href.startsWith('//') || isAbsoluteUrl(href)) {
+        return undefined;
+    }
+    return optionallyRemoveLeadingSlash(href);
+}

package/dist/navigation/index.d.ts

@@ -4,6 +4,7 @@ export * from './generatePathToBreadcrumbsMap.js';
 export * from './getFirstPageFromNavigation.js';
 export * from './generatePathToBreadcrumbsMapForDocsConfig.js';
 export * from './getAllPathsInDocsNav.js';
+export * from './getAllPathsInDecoratedNav.js';
 export * from './checkNavAccess.js';
 export * from './getFirstPageFromNavConfig.js';
 export * from './prioritize-default-division-item.js';

package/dist/navigation/index.js

@@ -4,6 +4,7 @@ export * from './generatePathToBreadcrumbsMap.js';
 export * from './getFirstPageFromNavigation.js';
 export * from './generatePathToBreadcrumbsMapForDocsConfig.js';
 export * from './getAllPathsInDocsNav.js';
+export * from './getAllPathsInDecoratedNav.js';
 export * from './checkNavAccess.js';
 export * from './getFirstPageFromNavConfig.js';
 export * from './prioritize-default-division-item.js';