@mintlify/link-rot 3.0.1538 → 3.0.1540

package/dist/graph.d.ts

@@ -1,6 +1,6 @@
 import { ParsedPath } from 'path';
 import type { SnippetReferences } from './static-checking/getSnippetReferences.js';
-declare enum PathType {
+export declare enum PathType {
     INTERNAL = "internal",
     EXTERNAL = "external",
     DATA = "data"
@@ -121,4 +121,3 @@ export declare class Graph {
     getExternalPathsByNode(): Map<string, MdxPath[]>;
     getAllInternalPaths(): string[];
 }
-export {};

package/dist/graph.js

@@ -1,10 +1,10 @@
 import { isMintIgnored, safeCleanHeadingId } from '@mintlify/common';
 import { getFileListWithDirectories } from '@mintlify/prebuild';
 import { existsSync } from 'fs';
-import { parse, join, resolve, relative, dirname, basename } from 'path';
+import { parse, join, resolve, dirname, basename } from 'path';
 import { sep as WINDOWS_SEPARATOR } from 'path/win32';
 import { getLinkPaths, normalizePath, removeSelectors } from './prebuild.js';
-var PathType;
+export var PathType;
 (function (PathType) {
     PathType["INTERNAL"] = "internal";
     PathType["EXTERNAL"] = "external";
@@ -61,27 +61,16 @@ export class MdxPath {
         let urlPath;
         let path;
         if (pathType === PathType.INTERNAL) {
-            let normalizedPath = this.originalPath.replaceAll(WINDOWS_SEPARATOR, '/');
-            if (normalizedPath.startsWith('.')) {
-                // also include paths that start with "..", etc.
-                normalizedPath = relative('.', resolve(this.relativeDir, normalizedPath));
-                // TODO path starts with .. if path resolves to file system outside of mintlify project
-            }
-            // remove leading slash
-            normalizedPath = normalizedPath.startsWith('/') ? normalizedPath.slice(1) : normalizedPath;
-            // resolve relative path
-            // add arbitrary protocol to parse as URL and isolate pathname
-            urlPath = new URL(`mintlify:${normalizedPath}`);
-            normalizedPath = decodeUrlComponent(urlPath.pathname);
+            const pageUrl = new URL('mintlify:/');
+            pageUrl.pathname = `/${this.relativeDir}/${this.filename}`.replaceAll(WINDOWS_SEPARATOR, '/');
+            urlPath = new URL(this.originalPath.replaceAll(WINDOWS_SEPARATOR, '/'), pageUrl);
+            let normalizedPath = decodeUrlComponent(urlPath.pathname).slice(1);
             // remove trailing slash
             if (normalizedPath.endsWith('/')) {
                 normalizedPath = normalizedPath.slice(0, -1);
-                urlPath.pathname = normalizedPath;
             }
-            // if path is "", then path points to same page
             if (normalizedPath === '') {
-                normalizedPath = join(this.relativeDir, this.filename);
-                urlPath.pathname = normalizedPath;
+                normalizedPath = '.';
             }
             path = parse(normalizedPath);
         }
@@ -446,7 +435,9 @@ export class Graph {
                 if (path.pathType === PathType.INTERNAL) {
                     const pathString = path.toString();
                     const resolvedFiles = this.fileResolutionMap.get(pathString);
-                    const hasExistingFile = (resolvedFiles && [...resolvedFiles].some((file) => nodeSet.has(file))) ||
+                    const isSiteRoot = pathString === '.';
+                    const hasExistingFile = isSiteRoot ||
+                        (resolvedFiles && [...resolvedFiles].some((file) => nodeSet.has(file))) ||
                         this.virtualNodes.has(pathString);
                     if (!hasExistingFile && !this.reachesPage(pathString)) {
                         brokenLinks.add(path);

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-export { buildGraph, getBrokenInternalLinks } from './static-checking/getBrokenInternalLinks.js';
+export { buildGraph, decorateGraphNodeFromPageContent, getBrokenInternalLinks, } from './static-checking/getBrokenInternalLinks.js';
+export { Node, PathType } from './graph.js';
 export { getBrokenExternalLinks } from './static-checking/getBrokenExternalLinks.js';
 export type { ExternalLinkResult } from './static-checking/getBrokenExternalLinks.js';
 export { getFilesLinksDependOn } from './static-checking/resolveSnippetLinksFromRenderingPages.js';

package/dist/index.js

@@ -1,4 +1,5 @@
-export { buildGraph, getBrokenInternalLinks } from './static-checking/getBrokenInternalLinks.js';
+export { buildGraph, decorateGraphNodeFromPageContent, getBrokenInternalLinks, } from './static-checking/getBrokenInternalLinks.js';
+export { Node, PathType } from './graph.js';
 export { getBrokenExternalLinks } from './static-checking/getBrokenExternalLinks.js';
 export { getFilesLinksDependOn } from './static-checking/resolveSnippetLinksFromRenderingPages.js';
 export { getBrokenRedirects } from './static-checking/getBrokenRedirects.js';

package/dist/static-checking/getBrokenInternalLinks.js

@@ -60,20 +60,44 @@ export const extractComponentAnchorIds = (tree) => {
     });
     return ids;
 };
+const attributeString = (value) => {
+    var _a, _b, _c, _d;
+    if (typeof value === 'string')
+        return value;
+    const statement = (_b = (_a = value === null || value === void 0 ? void 0 : value.data) === null || _a === void 0 ? void 0 : _a.estree) === null || _b === void 0 ? void 0 : _b.body[0];
+    const expression = (statement === null || statement === void 0 ? void 0 : statement.type) === 'ExpressionStatement' ? statement.expression : undefined;
+    if ((expression === null || expression === void 0 ? void 0 : expression.type) === 'Literal' && typeof expression.value === 'string') {
+        return expression.value;
+    }
+    if ((expression === null || expression === void 0 ? void 0 : expression.type) === 'TemplateLiteral' && expression.expressions.length === 0) {
+        return (_d = (_c = expression.quasis[0]) === null || _c === void 0 ? void 0 : _c.value.cooked) !== null && _d !== void 0 ? _d : undefined;
+    }
+    return undefined;
+};
 export const decorateGraphNodeFromPageContent = (graphNode, content, options) => __awaiter(void 0, void 0, void 0, function* () {
     const mdxExtracts = {};
     const visitLinks = () => {
         return (tree) => {
+            const referenced = new Set();
+            visit(tree, ['linkReference', 'imageReference'], (node) => {
+                if ('identifier' in node)
+                    referenced.add(node.identifier);
+            });
             visit(tree, (node) => {
                 var _a, _b;
                 if (node.type === 'link' || node.type === 'image') {
                     graphNode.addPath(node.url, Wrapper.MD);
                     return;
                 }
+                if (node.type === 'definition') {
+                    if (referenced.delete(node.identifier))
+                        graphNode.addPath(node.url, Wrapper.MD);
+                    return;
+                }
                 const mdxJsxFlowElement = node;
                 if (mdxJsxFlowElement.name === 'img' || mdxJsxFlowElement.name === 'source') {
                     const srcAttrIndex = mdxJsxFlowElement.attributes.findIndex((attr) => attr.type === 'mdxJsxAttribute' && attr.name === 'src');
-                    const nodeUrl = (_a = mdxJsxFlowElement.attributes[srcAttrIndex]) === null || _a === void 0 ? void 0 : _a.value;
+                    const nodeUrl = attributeString((_a = mdxJsxFlowElement.attributes[srcAttrIndex]) === null || _a === void 0 ? void 0 : _a.value);
                     if (typeof nodeUrl === 'string') {
                         graphNode.addPath(nodeUrl, Wrapper.SRC);
                         return;
@@ -81,7 +105,7 @@ export const decorateGraphNodeFromPageContent = (graphNode, content, options) =>
                 }
                 else if (mdxJsxFlowElement.name === 'a' || mdxJsxFlowElement.name === 'Card') {
                     const hrefAttrIndex = mdxJsxFlowElement.attributes.findIndex((attr) => attr.type === 'mdxJsxAttribute' && attr.name === 'href');
-                    const nodeUrl = (_b = mdxJsxFlowElement.attributes[hrefAttrIndex]) === null || _b === void 0 ? void 0 : _b.value;
+                    const nodeUrl = attributeString((_b = mdxJsxFlowElement.attributes[hrefAttrIndex]) === null || _b === void 0 ? void 0 : _b.value);
                     if (typeof nodeUrl === 'string') {
                         graphNode.addPath(nodeUrl, Wrapper.HREF);
                         return;

package/dist/static-checking/resolveSnippetLinksFromRenderingPages.js

@@ -1,10 +1,10 @@
 import { resolveImportPath } from '@mintlify/common';
 import { sep as WINDOWS_SEPARATOR } from 'path/win32';
-import { MdxPath, Wrapper } from '../graph.js';
+import { MdxPath, PathType, Wrapper } from '../graph.js';
 import { removeLeadingSlash } from '../prebuild.js';
 const SNIPPET_DIRECTORIES = ['snippets/', '_snippets/'];
 const toKey = (file) => file.replaceAll(WINDOWS_SEPARATOR, '/');
-const isPageRelativeLink = ({ originalPath, wrapper }) => wrapper !== Wrapper.IMPORT && (originalPath.startsWith('.') || originalPath.startsWith('#'));
+const isPageRelativeLink = ({ originalPath, pathType, wrapper }) => wrapper !== Wrapper.IMPORT && pathType === PathType.INTERNAL && !originalPath.startsWith('/');
 export const resolveSnippetLinksFromRenderingPages = (graph, snippetReferencesByFile) => {
     var _a, _b, _c;
     const fileByKey = new Map([...snippetReferencesByFile.keys()].map((file) => [toKey(file), file]));