@mintlify/common 1.0.1279 → 1.0.1280

package/dist/mdx/preprocessCustomHeadingIds.d.ts

@@ -23,6 +23,7 @@ export interface PreprocessCustomHeadingIdsOptions {
  * 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 declare function customHeadingIdSourceLines(content: string, options?: PreprocessCustomHeadingIdsOptions): number[];
 export declare function parseOpeningFence(stripped: string): {
     char: string;
     count: number;

package/dist/mdx/preprocessCustomHeadingIds.js

@@ -39,20 +39,30 @@ function normalizeCustomId(raw) {
  * Without this the `{#id}` would reach the expression parser as a JSX expression and fail.
  */
 export function preprocessCustomHeadingIds(content, options) {
+    return rewriteCustomHeadingIds(content, options).content;
+}
+export function customHeadingIdSourceLines(content, options) {
+    return rewriteCustomHeadingIds(content, options).sourceLines;
+}
+function rewriteCustomHeadingIds(content, options) {
     var _a, _b, _c, _d, _e;
     const lines = content.split('\n');
     const result = [];
+    const sourceLines = [];
+    let sourceLine = 0;
     let fenceChar;
     let fenceCount = 0;
     let mdxDepth = 0;
     let inComment = false;
     for (const line of lines) {
+        sourceLine += 1;
         const stripped = line.trimStart();
         if (fenceChar !== undefined) {
             if (isClosingFence(stripped, fenceChar, fenceCount)) {
                 fenceChar = undefined;
             }
             result.push(line);
+            sourceLines.push(sourceLine);
             continue;
         }
         const fence = !inComment && parseOpeningFence(stripped);
@@ -60,6 +70,7 @@ export function preprocessCustomHeadingIds(content, options) {
             fenceChar = fence.char;
             fenceCount = fence.count;
             result.push(line);
+            sourceLines.push(sourceLine);
             continue;
         }
         const { visible, inComment: endsInComment } = scanComments(line, inComment);
@@ -74,14 +85,16 @@ export function preprocessCustomHeadingIds(content, options) {
                 ? sanitizeHtmlAttr(heading[4])
                 : normalizeCustomId(heading[4]);
             result.push(`${indent}<h${level} id="${sanitizedId}">`, `${indent}${heading[3]}`, `${indent}</h${level}>`);
+            sourceLines.push(sourceLine, sourceLine, sourceLine);
             continue;
         }
         mdxDepth = Math.max(0, mdxDepth +
             ((_c = (_b = visible.match(MDX_OPEN_RE)) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0) -
             ((_e = (_d = visible.match(MDX_CLOSE_RE)) === null || _d === void 0 ? void 0 : _d.length) !== null && _e !== void 0 ? _e : 0));
         result.push(line);
+        sourceLines.push(sourceLine);
     }
-    return result.join('\n');
+    return { content: result.join('\n'), sourceLines };
 }
 function scanComments(line, inComment) {
     const masked = line.replace(COMMENT_MASK_RE, (span) => ' '.repeat(span.length));

package/dist/mdx/preprocessCustomHeadingIds.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { preprocessCustomHeadingIds } from './preprocessCustomHeadingIds.js';
+import { customHeadingIdSourceLines, 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>');
@@ -165,3 +165,18 @@ x = 1
         expect(preprocessCustomHeadingIds('  ## Heading {#my_id}', { preserveOriginal: true })).toBe('  <h2 id="my_id">\n  Heading\n  </h2>');
     });
 });
+describe('customHeadingIdSourceLines', () => {
+    it('maps each output line to the source line it came from', () => {
+        const content = [
+            '# Title {#title}',
+            'Body',
+            '```',
+            '## Code {#code}',
+            '```',
+            '## End {#end}',
+        ].join('\n');
+        const sourceLines = customHeadingIdSourceLines(content);
+        expect(sourceLines).toEqual([1, 1, 1, 2, 3, 4, 5, 6, 6, 6]);
+        expect(sourceLines).toHaveLength(preprocessCustomHeadingIds(content).split('\n').length);
+    });
+});

package/dist/rss/dates.d.ts

@@ -1,4 +1,5 @@
 import type { RootContent } from 'mdast';
 import type { UpdateMDXComponent } from './index.js';
-export declare const getDateForNode: (node: RootContent, lineBlame: Record<number, string>) => string;
+export declare const newestBlameDate: (lineBlame: Record<number, string>) => string | undefined;
+export declare const getDateForNode: (node: RootContent, lineBlame: Record<number, string>, fallbackDate: string) => string;
 export declare const getMostRepresentativeDate: (updateComponent: UpdateMDXComponent, lineBlame: Record<number, string>, defaultDate: string) => string;

package/dist/rss/dates.js

@@ -1,25 +1,29 @@
-export const getDateForNode = (node, lineBlame) => {
-    if (!node.position) {
-        return new Date().toISOString();
-    }
-    const startLine = node.position.start.line;
-    const blameDate = lineBlame[startLine];
-    if (blameDate) {
-        const parsedDate = new Date(blameDate);
-        if (!isNaN(parsedDate.getTime())) {
-            return parsedDate.toISOString();
-        }
+const blameDateForNode = (node, lineBlame) => {
+    if (!node.position)
+        return undefined;
+    const blameDate = lineBlame[node.position.start.line];
+    if (!blameDate)
+        return undefined;
+    const parsedDate = new Date(blameDate);
+    return isNaN(parsedDate.getTime()) ? undefined : parsedDate.toISOString();
+};
+export const newestBlameDate = (lineBlame) => {
+    let newest;
+    for (const blameDate of Object.values(lineBlame)) {
+        const time = new Date(blameDate).getTime();
+        if (!isNaN(time) && (newest === undefined || time > newest))
+            newest = time;
     }
-    return new Date().toISOString();
+    return newest === undefined ? undefined : new Date(newest).toISOString();
 };
+export const getDateForNode = (node, lineBlame, fallbackDate) => { var _a; return (_a = blameDateForNode(node, lineBlame)) !== null && _a !== void 0 ? _a : fallbackDate; };
 export const getMostRepresentativeDate = (updateComponent, lineBlame, defaultDate) => {
     const dates = [];
     const collectDates = (nodes) => {
         for (const node of nodes) {
-            if (node.type !== 'heading' && node.position) {
-                const nodeDate = getDateForNode(node, lineBlame);
+            const nodeDate = node.type === 'heading' ? undefined : blameDateForNode(node, lineBlame);
+            if (nodeDate !== undefined)
                 dates.push(nodeDate);
-            }
             if ('children' in node && Array.isArray(node.children) && node.children.length > 0) {
                 collectDates(node.children);
             }

package/dist/rss/getV4FeedUpdates.js

@@ -8,9 +8,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { remarkUserMentions } from '../mdx/plugins/remark/remarkUserMentions.js';
+import { customHeadingIdSourceLines } from '../mdx/preprocessCustomHeadingIds.js';
+import { preprocessMdxFragmentCode } from '../mdx/preprocessMdxFragmentCode.js';
 import { getAST } from '../mdx/remark.js';
 import { UPDATE_MAX } from './constants.js';
-import { getDateForNode, getMostRepresentativeDate } from './dates.js';
+import { getDateForNode, getMostRepresentativeDate, newestBlameDate } from './dates.js';
 import { enhanceSnippetsWithImportNames } from './enhanceSnippetsWithImportNames.js';
 import { isUpdate } from './index.js';
 import { processUpdateNode } from './processUpdateNode.js';
@@ -38,6 +40,16 @@ export const getV4FeedUpdates = (rssFile) => __awaiter(void 0, void 0, void 0, f
     catch (error) {
         return [];
     }
+    const astLineBlame = {};
+    customHeadingIdSourceLines(preprocessMdxFragmentCode(content)).forEach((sourceLine, index) => {
+        const blameDate = lineBlame[sourceLine];
+        if (blameDate !== undefined)
+            astLineBlame[index + 1] = blameDate;
+    });
+    const fallbackDate = newestBlameDate(lineBlame);
+    if (fallbackDate === undefined) {
+        return [];
+    }
     if (snippets && snippets.length > 0) {
         try {
             const enhancedSnippets = yield enhanceSnippetsWithImportNames(ast, snippets);
@@ -58,8 +70,8 @@ export const getV4FeedUpdates = (rssFile) => __awaiter(void 0, void 0, void 0, f
     }
     const allUpdates = [];
     for (const updateComponent of updateComponents) {
-        const componentDate = getDateForNode(updateComponent, lineBlame);
-        const representativeDate = getMostRepresentativeDate(updateComponent, lineBlame, componentDate);
+        const componentDate = getDateForNode(updateComponent, astLineBlame, fallbackDate);
+        const representativeDate = getMostRepresentativeDate(updateComponent, astLineBlame, componentDate);
         const updates = processUpdateNode({
             updateNode: updateComponent,
             date: representativeDate,