@mintlify/common 1.0.651 → 1.0.652

package/dist/getFileCategory.d.ts

@@ -1,3 +1,6 @@
+export type FileCategoryOptions = {
+    importedFiles?: Set<string>;
+};
 export type PotentialFileCategory = 'page' | 'snippet' | 'mintConfig' | 'potentialYamlOpenApiSpec' | 'potentialJsonOpenApiSpec' | 'staticFile' | 'snippet-v2' | 'css' | 'js' | 'docsConfig' | 'generatedStaticFile' | 'mintIgnore' | null;
 export type FileCategory = Omit<PotentialFileCategory, 'potentialYamlOpenApiSpec' | 'potentialJsonOpenApiSpec'> | 'openApi' | null;
 export declare const generatedStaticFiles: readonly ["llms.txt", "robots.txt", "sitemap.xml", "llms-full.txt"];
@@ -17,4 +20,4 @@ export declare function isGatedFormat(params: {
     filePath?: undefined;
     ext: string;
 }): boolean;
-export declare const getFileCategory: (filePath: string) => PotentialFileCategory;
+export declare const getFileCategory: (filePath: string, options?: FileCategoryOptions) => PotentialFileCategory;

package/dist/getFileCategory.js

@@ -1,5 +1,7 @@
 import { parse } from 'path';
 import { SNIPPET_EXTENSIONS } from './mdx/snippets/constants.js';
+import { isImportedAsSnippet } from './mdx/snippets/isImportedAsSnippet.js';
+import { optionallyRemoveLeadingSlash } from './optionallyRemoveLeadingSlash.js';
 const excludedMdFiles = ['readme', 'license', 'contributing', 'contribute'];
 export const generatedStaticFiles = [
     'llms.txt',
@@ -73,9 +75,9 @@ export function isGatedFormat({ filePath, ext }) {
     ext = ext.startsWith('.') ? ext : `.${ext}`;
     return gatedStaticAssetExtensions.includes(ext.toLowerCase());
 }
-export const getFileCategory = (filePath) => {
-    filePath = filePath.toLowerCase();
-    const parsed = parse(filePath);
+export const getFileCategory = (filePath, options) => {
+    const normalizedFilePath = optionallyRemoveLeadingSlash(filePath.toLowerCase());
+    const parsed = parse(normalizedFilePath);
     if (parsed.base === 'mint.json') {
         return 'mintConfig';
     }
@@ -90,16 +92,19 @@ export const getFileCategory = (filePath) => {
     if (generatedStaticFiles.includes(parsed.base)) {
         return 'generatedStaticFile';
     }
-    if ((filePath.startsWith('_snippets/') || filePath.startsWith('snippets/')) &&
-        (SNIPPET_EXTENSIONS.some((ext) => extension === ext) || extension === '.md')) {
-        if (filePath.startsWith('_snippets/')) {
+    if ((normalizedFilePath.startsWith('_snippets/') || normalizedFilePath.startsWith('snippets/')) &&
+        SNIPPET_EXTENSIONS.some((ext) => extension === ext)) {
+        if (normalizedFilePath.startsWith('_snippets/')) {
             return 'snippet';
         }
-        else if (filePath.startsWith('snippets/')) {
+        else if (normalizedFilePath.startsWith('snippets/')) {
             return 'snippet-v2';
         }
     }
     else if (extension === '.mdx') {
+        if ((options === null || options === void 0 ? void 0 : options.importedFiles) != null && isImportedAsSnippet(filePath, options.importedFiles)) {
+            return 'snippet-v2';
+        }
         return 'page';
     }
     else if (extension === '.md') {
@@ -107,8 +112,14 @@ export const getFileCategory = (filePath) => {
         if (excludedMdFiles.includes(fileName)) {
             return null;
         }
+        if ((options === null || options === void 0 ? void 0 : options.importedFiles) != null && isImportedAsSnippet(filePath, options.importedFiles)) {
+            return 'snippet-v2';
+        }
         return 'page';
     }
+    else if (extension === '.jsx') {
+        return 'snippet-v2';
+    }
     else if (extension === '.yaml' || extension === '.yml') {
         return 'potentialYamlOpenApiSpec';
     }

package/dist/mdx/snippets/buildImportMap.d.ts

@@ -0,0 +1,9 @@
+import type { Root } from 'mdast';
+export interface FileWithTree {
+    path: string;
+    tree: Root;
+}
+export declare const buildImportMap: (files: FileWithTree[]) => {
+    importedFiles: Set<string>;
+    fileImportsMap: Map<string, Set<string>>;
+};

package/dist/mdx/snippets/buildImportMap.js

@@ -0,0 +1,19 @@
+import { extractImportSources } from './extractImportSources.js';
+import { resolveImportPath } from './resolveImportPath.js';
+export const buildImportMap = (files) => {
+    const importedFiles = new Set();
+    const fileImportsMap = new Map();
+    for (const file of files) {
+        const resolvedImports = new Set();
+        for (const source of extractImportSources(file.tree)) {
+            const resolved = resolveImportPath(source, file.path);
+            if (resolved) {
+                const normalized = resolved.toLowerCase();
+                importedFiles.add(normalized);
+                resolvedImports.add(normalized);
+            }
+        }
+        fileImportsMap.set(file.path.toLowerCase(), resolvedImports);
+    }
+    return { importedFiles, fileImportsMap };
+};

package/dist/mdx/snippets/constants.js

@@ -1 +1 @@
-export const SNIPPET_EXTENSIONS = ['.mdx', '.jsx'];
+export const SNIPPET_EXTENSIONS = ['.mdx', '.jsx', '.md'];

package/dist/mdx/snippets/extractImportSources.d.ts

@@ -0,0 +1,2 @@
+import type { Root } from 'mdast';
+export declare const extractImportSources: (tree: Root) => string[];

package/dist/mdx/snippets/extractImportSources.js

@@ -0,0 +1,15 @@
+import { visit } from 'unist-util-visit';
+import { estreeIsProgram, isImportDeclaration, isMdxJsEsm } from '../utils.js';
+export const extractImportSources = (tree) => {
+    const sources = [];
+    visit(tree, (node) => {
+        if (isMdxJsEsm(node) && estreeIsProgram(node)) {
+            for (const bodyChild of node.data.estree.body) {
+                if (isImportDeclaration(bodyChild) && typeof bodyChild.source.value === 'string') {
+                    sources.push(bodyChild.source.value);
+                }
+            }
+        }
+    });
+    return sources;
+};

package/dist/mdx/snippets/index.d.ts

@@ -1,10 +1,14 @@
+export * from './buildImportMap.js';
+export * from './constants.js';
+export * from './extractImportSources.js';
+export * from './isSnippetExtension.js';
+export * from './findAndRemoveExports.js';
 export * from './findAndRemoveImports.js';
+export * from './getExportMap.js';
 export * from './hasImports.js';
+export * from './isImportedAsSnippet.js';
 export * from './nodeIncludesExport.js';
-export * from './resolveImport/index.js';
-export * from './resolveAllImports.js';
-export * from './resolveSnippetImportPath.js';
 export * from './removeExports.js';
-export * from './getExportMap.js';
-export * from './findAndRemoveExports.js';
-export * from './constants.js';
+export * from './resolveAllImports.js';
+export * from './resolveImport/index.js';
+export * from './resolveImportPath.js';

package/dist/mdx/snippets/index.js

@@ -1,10 +1,14 @@
+export * from './buildImportMap.js';
+export * from './constants.js';
+export * from './extractImportSources.js';
+export * from './isSnippetExtension.js';
+export * from './findAndRemoveExports.js';
 export * from './findAndRemoveImports.js';
+export * from './getExportMap.js';
 export * from './hasImports.js';
+export * from './isImportedAsSnippet.js';
 export * from './nodeIncludesExport.js';
-export * from './resolveImport/index.js';
-export * from './resolveAllImports.js';
-export * from './resolveSnippetImportPath.js';
 export * from './removeExports.js';
-export * from './getExportMap.js';
-export * from './findAndRemoveExports.js';
-export * from './constants.js';
+export * from './resolveAllImports.js';
+export * from './resolveImport/index.js';
+export * from './resolveImportPath.js';

package/dist/mdx/snippets/isImportedAsSnippet.d.ts

@@ -0,0 +1 @@
+export declare const isImportedAsSnippet: (filename: string, importedFiles: Set<string>) => boolean;

package/dist/mdx/snippets/isImportedAsSnippet.js

@@ -0,0 +1,7 @@
+import { optionallyAddLeadingSlash } from '../../fs/optionallySlash.js';
+export const isImportedAsSnippet = (filename, importedFiles) => {
+    const normalizedFilename = optionallyAddLeadingSlash(filename).toLowerCase();
+    return (importedFiles.has(normalizedFilename) &&
+        !normalizedFilename.startsWith('/snippets/') &&
+        !normalizedFilename.startsWith('/_snippets/'));
+};

package/dist/mdx/snippets/isSnippetExtension.d.ts

@@ -0,0 +1 @@
+export declare const isSnippetExtension: (extension: string) => boolean;

package/dist/mdx/snippets/isSnippetExtension.js

@@ -0,0 +1,5 @@
+import { SNIPPET_EXTENSIONS } from './constants.js';
+export const isSnippetExtension = (extension) => {
+    const normalizedExt = extension.startsWith('.') ? extension : `.${extension}`;
+    return SNIPPET_EXTENSIONS.includes(normalizedExt);
+};

package/dist/mdx/snippets/resolveAllImports.js

@@ -9,15 +9,15 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { getExportMapFromTree } from './getExportMap.js';
 import { resolveImport } from './resolveImport/index.js';
-import { resolveSnippetImportPath } from './resolveSnippetImportPath.js';
+import { resolveImportPath } from './resolveImportPath.js';
 export const resolveAllImports = (params) => __awaiter(void 0, void 0, void 0, function* () {
     const { snippets, fileWithImports } = params;
     let ast = fileWithImports.tree;
     const exportMap = getExportMapFromTree(ast);
     for (const source of Object.keys(fileWithImports.importMap)) {
-        const resolvedPath = resolveSnippetImportPath(source, fileWithImports.filename);
+        const resolvedPath = resolveImportPath(source, fileWithImports.filename);
         if (resolvedPath == null) {
-            console.log(`Invalid import path ${source} in ${fileWithImports.filename}. Import must resolve to a file in /snippets/.`);
+            console.log(`Invalid import path ${source} in ${fileWithImports.filename}. Only local imports are supported.`);
             continue;
         }
         const importedSnippet = snippets.find((snippet) => snippet.filename === resolvedPath);

package/dist/mdx/snippets/resolveImportPath.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Resolves an import path to an absolute path with leading slash.
+ *
+ * @param source The import source path (e.g., '/components/foo.mdx' or '../bar.mdx')
+ * @param importingFilePath The path of the file containing the import
+ * @returns The resolved absolute path with leading slash, or null if it's an external/package import
+ */
+export declare const resolveImportPath: (source: string, importingFilePath: string) => string | null;

package/dist/mdx/snippets/{resolveSnippetImportPath.js → resolveImportPath.js}

@@ -2,31 +2,27 @@ import { posix } from 'path';
 const isRelativeImport = (source) => {
     return source.startsWith('./') || source.startsWith('../');
 };
-const isInSnippetsFolder = (resolvedPath) => {
-    return resolvedPath.startsWith('/snippets/');
+const isLocalImport = (source) => {
+    return source.startsWith('/') || isRelativeImport(source);
 };
 /**
  * Resolves an import path to an absolute path with leading slash.
- * Only allows imports that resolve to files in /snippets/.
  *
- * @param source The import source path (e.g., '/snippets/foo.mdx' or '../snippets/bar.mdx')
+ * @param source The import source path (e.g., '/components/foo.mdx' or '../bar.mdx')
  * @param importingFilePath The path of the file containing the import
- * @returns The resolved absolute path with leading slash, or null if invalid or not in snippets folder
+ * @returns The resolved absolute path with leading slash, or null if it's an external/package import
  */
-export const resolveSnippetImportPath = (source, importingFilePath) => {
+export const resolveImportPath = (source, importingFilePath) => {
+    if (!isLocalImport(source)) {
+        return null;
+    }
     let resolvedPath;
     if (source.startsWith('/')) {
         resolvedPath = posix.normalize(source);
     }
-    else if (isRelativeImport(source)) {
+    else {
         const importingDir = posix.dirname(importingFilePath.startsWith('/') ? importingFilePath : '/' + importingFilePath);
         resolvedPath = posix.resolve(importingDir, source);
     }
-    else {
-        return null;
-    }
-    if (!isInSnippetsFolder(resolvedPath)) {
-        return null;
-    }
     return resolvedPath;
 };