@mintlify/previewing 4.0.683 → 4.0.685

package/dist/__tests__/shouldRegenerateNavForPage.test.d.ts

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

package/dist/__tests__/shouldRegenerateNavForPage.test.js

@@ -0,0 +1,39 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { shouldRegenerateNavForPage } from '../local-preview/listener/utils.js';
+describe('shouldRegenerateNavForPage', () => {
+    let frontmatterHashes;
+    beforeEach(() => {
+        frontmatterHashes = new Map();
+    });
+    it('should return true for first-time file processing', async () => {
+        const content = `---\ntitle: "Test Page"\ndescription: "A test page"\n---\n# Test Content`;
+        const result = await shouldRegenerateNavForPage('test.mdx', content, frontmatterHashes);
+        expect(result).toBe(true);
+    });
+    it('should return false when frontmatter has not changed', async () => {
+        const content = `---\ntitle: "Test Page"\ndescription: "A test page"\n---\n# Test Content`;
+        await shouldRegenerateNavForPage('test.mdx', content, frontmatterHashes);
+        const result = await shouldRegenerateNavForPage('test.mdx', content, frontmatterHashes);
+        expect(result).toBe(false);
+    });
+    it('should return true when frontmatter changes', async () => {
+        const originalContent = `---\ntitle: "Test Page"\ndescription: "A test page"\n---\n# Test Content`;
+        const updatedContent = `---\ntitle: "Updated Test Page"\ndescription: "A test page"\n---\n# Test Content`;
+        await shouldRegenerateNavForPage('test.mdx', originalContent, frontmatterHashes);
+        const result = await shouldRegenerateNavForPage('test.mdx', updatedContent, frontmatterHashes);
+        expect(result).toBe(true);
+    });
+    it('should return false when only content changes but frontmatter stays same', async () => {
+        const originalContent = `---\ntitle: "Test Page"\ndescription: "A test page"\n---\n# Original Content`;
+        const updatedContent = `---\ntitle: "Test Page"\ndescription: "A test page"\n---\n# Updated Content`;
+        await shouldRegenerateNavForPage('test.mdx', originalContent, frontmatterHashes);
+        const result = await shouldRegenerateNavForPage('test.mdx', updatedContent, frontmatterHashes);
+        expect(result).toBe(false);
+    });
+    it('should handle files with no frontmatter', async () => {
+        const contentNoFrontmatter = '# Just a heading\n\nSome content';
+        await shouldRegenerateNavForPage('test.mdx', contentNoFrontmatter, frontmatterHashes);
+        const result = await shouldRegenerateNavForPage('test.mdx', contentNoFrontmatter, frontmatterHashes);
+        expect(result).toBe(false);
+    });
+});

package/dist/local-preview/listener/index.js

@@ -16,8 +16,9 @@ import { generatePagesWithImports } from './generatePagesWithImports.js';
 import { getDocsState } from './getDocsState.js';
 import { resolveAllImports } from './resolveAllImports.js';
 import { updateGeneratedNav, updateOpenApiFiles, upsertOpenApiFile } from './update.js';
-import { isFileSizeValid } from './utils.js';
+import { isFileSizeValid, shouldRegenerateNavForPage } from './utils.js';
 const { readFile } = _promises;
+const frontmatterHashes = new Map();
 const listener = (callback) => {
     chokidar
         .watch(CMD_EXEC_PATH, {
@@ -132,8 +133,8 @@ const onUpdateEvent = async (filename, callback) => {
         : potentialCategory;
     switch (potentialCategory) {
         case 'page': {
-            regenerateNav = true;
             let contentStr = (await readFile(filePath)).toString();
+            regenerateNav = await shouldRegenerateNavForPage(filename, contentStr, frontmatterHashes);
             const tree = await preparseMdxTree(contentStr, CMD_EXEC_PATH, filePath);
             const importsResponse = await findAndRemoveImports(tree);
             if (hasImports(importsResponse)) {

package/dist/local-preview/listener/utils.d.ts

@@ -2,3 +2,4 @@ export declare const getFileExtension: (filename: string) => string;
 export declare const isFileSizeValid: (path: string, maxFileSizeInMb: number) => Promise<boolean>;
 export declare function isError(obj: unknown): boolean;
 export declare const readJsonFile: (path: string) => Promise<any>;
+export declare const shouldRegenerateNavForPage: (filename: string, contentStr: string, frontmatterHashes: Map<string, string>) => Promise<boolean>;

package/dist/local-preview/listener/utils.js

@@ -1,5 +1,7 @@
+import crypto from 'crypto';
 import { promises as _promises } from 'fs';
 import fse from 'fs-extra';
+import matter from 'gray-matter';
 const { stat } = _promises;
 export const getFileExtension = (filename) => {
     return filename.substring(filename.lastIndexOf('.') + 1, filename.length) || filename;
@@ -16,3 +18,27 @@ export const readJsonFile = async (path) => {
     const file = await fse.readFile(path, 'utf-8');
     return JSON.parse(file);
 };
+export const shouldRegenerateNavForPage = async (filename, contentStr, frontmatterHashes) => {
+    try {
+        const { data: currentFrontmatter } = matter(contentStr);
+        const prevFrontmatterHash = frontmatterHashes.get(filename);
+        const currentFrontmatterHash = crypto
+            .createHash('md5')
+            .update(JSON.stringify(currentFrontmatter))
+            .digest('hex');
+        if (!prevFrontmatterHash) {
+            frontmatterHashes.set(filename, currentFrontmatterHash);
+            return true;
+        }
+        if (currentFrontmatterHash !== prevFrontmatterHash) {
+            frontmatterHashes.set(filename, currentFrontmatterHash);
+            return true;
+        }
+        frontmatterHashes.set(filename, currentFrontmatterHash);
+        return false;
+    }
+    catch (error) {
+        console.warn(`Error parsing frontmatter for ${filename}, regenerating nav:`, error);
+        return true;
+    }
+};