@node-cli/bundlecheck 1.4.1 → 1.5.0

package/dist/exports.js

@@ -0,0 +1,330 @@
+import fs from "node:fs";
+import path from "node:path";
+/**
+ * Resolve a relative import path to an absolute file path.
+ */ function resolveImportPath(basePath, importPath) {
+    // Remove quotes and trim.
+    let cleanPath = importPath.replace(/['"]/g, "").trim();
+    // Only handle relative imports.
+    if (!cleanPath.startsWith(".")) {
+        return null;
+    }
+    /**
+	 * Strip .js/.mjs extension if present (TypeScript uses .js in imports but
+	 * .d.ts for types).
+	 */ cleanPath = cleanPath.replace(/\.(m?js)$/, "");
+    const baseDir = path.dirname(basePath);
+    const resolved = path.resolve(baseDir, cleanPath);
+    // Try different extensions for the resolved path.
+    const extensions = [
+        ".d.ts",
+        ".d.mts",
+        ".ts",
+        ""
+    ];
+    for (const ext of extensions){
+        const tryPath = resolved + ext;
+        if (fs.existsSync(tryPath) && fs.statSync(tryPath).isFile()) {
+            return tryPath;
+        }
+    }
+    // Try index files in directory.
+    for (const ext of [
+        ".d.ts",
+        ".d.mts",
+        ".ts"
+    ]){
+        const indexPath = path.join(resolved, `index${ext}`);
+        if (fs.existsSync(indexPath) && fs.statSync(indexPath).isFile()) {
+            return indexPath;
+        }
+    }
+    return null;
+}
+/**
+ * Parse a TypeScript declaration file (.d.ts) to extract named exports.
+ * Recursively follows re-exports up to a maximum depth.
+ */ function parseDeclarationFile(filePath, content, visited = new Set(), depth = 0) {
+    const MAX_DEPTH = 10;
+    const MAX_FILES = 500;
+    if (depth > MAX_DEPTH || visited.size > MAX_FILES) {
+        return [];
+    }
+    // Avoid circular imports.
+    const normalizedPath = path.resolve(filePath);
+    if (visited.has(normalizedPath)) {
+        return [];
+    }
+    visited.add(normalizedPath);
+    const exports = [];
+    const seenNames = new Set();
+    const addExport = (name, kind)=>{
+        // Skip internal/private exports and TypeScript utility types.
+        if (name.startsWith("_") || name === "default" || seenNames.has(name)) {
+            return;
+        }
+        seenNames.add(name);
+        exports.push({
+            name,
+            kind
+        });
+    };
+    // Pattern for: export * from './path'.
+    const reExportAllPattern = /export\s+\*\s+from\s+['"]([^'"]+)['"]/g;
+    // Pattern for: export type { Name, Name2 } from './path' (type-only exports).
+    const reExportTypePattern = /export\s+type\s+\{([^}]+)\}\s+from\s+['"]([^'"]+)['"]/g;
+    /**
+	 * Pattern for: export { Name, Name2 } from './path' (value exports - NOT
+	 * type).
+	 */ const reExportValuePattern = /export\s+\{([^}]+)\}\s+from\s+['"]([^'"]+)['"]/g;
+    // Pattern for: export declare function Name.
+    const functionPattern = /export\s+declare\s+function\s+(\w+)/g;
+    // Pattern for: export declare class Name.
+    const classPattern = /export\s+declare\s+class\s+(\w+)/g;
+    // Pattern for: export declare const Name.
+    const constPattern = /export\s+declare\s+const\s+(\w+)/g;
+    // Pattern for: export declare type Name.
+    const typePattern = /export\s+declare\s+type\s+(\w+)/g;
+    // Pattern for: export type Name = ... (without declare).
+    const typePattern2 = /export\s+type\s+(\w+)\s*[=<]/g;
+    // Pattern for: export type { Name } (local re-export without from).
+    const typeExportPattern = /export\s+type\s+\{([^}]+)\}\s*;/g;
+    // Pattern for: export interface Name.
+    const interfacePattern = /export\s+(?:declare\s+)?interface\s+(\w+)/g;
+    // Pattern for: export declare enum Name.
+    const enumPattern = /export\s+declare\s+enum\s+(\w+)/g;
+    // Pattern for: export { Name, Name2 } (without from - local exports).
+    const namedExportPattern = /export\s+\{([^}]+)\}\s*;/g;
+    // Pattern for: export declare const Name: ... (component style).
+    const componentPattern = /export\s+declare\s+const\s+(\w+)\s*:/g;
+    // Pattern for: export function Name (without declare).
+    const functionPattern2 = /export\s+function\s+(\w+)/g;
+    // Pattern for: export class Name (without declare).
+    const classPattern2 = /export\s+class\s+(\w+)/g;
+    // Pattern for: export const Name (without declare).
+    const constPattern2 = /export\s+const\s+(\w+)/g;
+    // Helper to extract all matches from a regex.
+    const extractMatches = (pattern, text)=>{
+        const matches = [];
+        let result = pattern.exec(text);
+        while(result !== null){
+            matches.push(result);
+            result = pattern.exec(text);
+        }
+        return matches;
+    };
+    // Handle: export * from './path' - recursively parse.
+    for (const match of extractMatches(reExportAllPattern, content)){
+        const importPath = match[1];
+        const resolvedPath = resolveImportPath(filePath, importPath);
+        if (resolvedPath) {
+            try {
+                const importedContent = fs.readFileSync(resolvedPath, "utf-8");
+                const importedExports = parseDeclarationFile(resolvedPath, importedContent, visited, depth + 1);
+                for (const exp of importedExports){
+                    addExport(exp.name, exp.kind);
+                }
+            } catch  {
+            // Ignore read errors.
+            }
+        }
+    }
+    // Handle: export type { Name } from './path' (type-only exports).
+    for (const match of extractMatches(reExportTypePattern, content)){
+        const exportList = match[1];
+        const names = exportList.split(",").map((s)=>{
+            const trimmed = s.trim();
+            // Handle "Name as Alias".
+            const asMatch = trimmed.match(/(\w+)\s+as\s+(\w+)/);
+            if (asMatch) {
+                return asMatch[2];
+            }
+            return trimmed;
+        });
+        for (const name of names){
+            if (name && /^\w+$/.test(name)) {
+                addExport(name, "type");
+            }
+        }
+    }
+    // Handle: export { Name } from './path' (value exports).
+    for (const match of extractMatches(reExportValuePattern, content)){
+        // Skip if this is actually a type export (already handled above).
+        const fullMatch = match[0];
+        if (fullMatch.includes("export type")) {
+            continue;
+        }
+        const exportList = match[1];
+        const names = exportList.split(",").map((s)=>{
+            const trimmed = s.trim();
+            // Handle "Name as Alias".
+            const asMatch = trimmed.match(/(\w+)\s+as\s+(\w+)/);
+            if (asMatch) {
+                return asMatch[2];
+            }
+            // Handle "type Name" syntax within the braces.
+            const typeMatch = trimmed.match(/type\s+(\w+)/);
+            if (typeMatch) {
+                /**
+				 * This is a type being re-exported, skip it (will be handled by type
+				 * pattern).
+				 */ return null;
+            }
+            return trimmed;
+        });
+        for (const name of names){
+            if (name && /^\w+$/.test(name)) {
+                addExport(name, "unknown");
+            }
+        }
+    }
+    // Extract functions.
+    for (const match of extractMatches(functionPattern, content)){
+        addExport(match[1], "function");
+    }
+    for (const match of extractMatches(functionPattern2, content)){
+        addExport(match[1], "function");
+    }
+    // Extract classes.
+    for (const match of extractMatches(classPattern, content)){
+        addExport(match[1], "class");
+    }
+    for (const match of extractMatches(classPattern2, content)){
+        addExport(match[1], "class");
+    }
+    // Extract const (includes React components).
+    for (const match of extractMatches(constPattern, content)){
+        addExport(match[1], "const");
+    }
+    for (const match of extractMatches(constPattern2, content)){
+        addExport(match[1], "const");
+    }
+    // Also catch component-style declarations.
+    for (const match of extractMatches(componentPattern, content)){
+        addExport(match[1], "const");
+    }
+    // Extract types (declare type).
+    for (const match of extractMatches(typePattern, content)){
+        addExport(match[1], "type");
+    }
+    // Extract types (export type X =).
+    for (const match of extractMatches(typePattern2, content)){
+        addExport(match[1], "type");
+    }
+    // Extract type exports (export type { X }).
+    for (const match of extractMatches(typeExportPattern, content)){
+        const exportList = match[1];
+        const names = exportList.split(",").map((s)=>s.trim());
+        for (const name of names){
+            if (name && /^\w+$/.test(name)) {
+                addExport(name, "type");
+            }
+        }
+    }
+    // Extract interfaces.
+    for (const match of extractMatches(interfacePattern, content)){
+        addExport(match[1], "interface");
+    }
+    // Extract enums.
+    for (const match of extractMatches(enumPattern, content)){
+        addExport(match[1], "enum");
+    }
+    /**
+	 * Extract named exports from export { ... } (without from - these are local
+	 * exports).
+	 */ for (const match of extractMatches(namedExportPattern, content)){
+        const exportList = match[1];
+        // Skip if this looks like a type export (already handled above).
+        if (content.substring(match.index - 5, match.index).includes("type")) {
+            continue;
+        }
+        const names = exportList.split(",").map((s)=>{
+            const trimmed = s.trim();
+            const asMatch = trimmed.match(/(\w+)\s+as\s+(\w+)/);
+            if (asMatch) {
+                return asMatch[2];
+            }
+            const typeMatch = trimmed.match(/type\s+(\w+)/);
+            if (typeMatch) {
+                return typeMatch[1];
+            }
+            return trimmed;
+        });
+        for (const name of names){
+            if (name && /^\w+$/.test(name)) {
+                addExport(name, "unknown");
+            }
+        }
+    }
+    return exports;
+}
+/**
+ * Get named exports from an installed package by parsing its type definitions.
+ *
+ * @param tmpDir - The temporary directory where the package is installed
+ * @param packageName - The package name (e.g., "@mantine/core")
+ * @returns ParsedExports containing the list of exports and count
+ *
+ */ export function getNamedExports(tmpDir, packageName) {
+    const packageDir = path.join(tmpDir, "node_modules", packageName);
+    const emptyResult = {
+        exports: [],
+        count: 0,
+        runtimeExports: [],
+        runtimeCount: 0
+    };
+    // Try to read package.json to find the types entry.
+    const pkgJsonPath = path.join(packageDir, "package.json");
+    if (!fs.existsSync(pkgJsonPath)) {
+        return emptyResult;
+    }
+    let typesEntry;
+    try {
+        const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, "utf-8"));
+        // Look for types in order of preference.
+        typesEntry = pkgJson.types || pkgJson.typings || pkgJson.exports?.["."]?.types || typeof pkgJson.exports?.["."] === "object" && pkgJson.exports["."].types;
+        // If no types field, try common patterns.
+        if (!typesEntry) {
+            const commonPaths = [
+                "dist/index.d.ts",
+                "lib/index.d.ts",
+                "index.d.ts",
+                "types/index.d.ts"
+            ];
+            for (const tryPath of commonPaths){
+                if (fs.existsSync(path.join(packageDir, tryPath))) {
+                    typesEntry = tryPath;
+                    break;
+                }
+            }
+        }
+    } catch  {
+        return emptyResult;
+    }
+    if (!typesEntry) {
+        return emptyResult;
+    }
+    // Read and parse the types file.
+    const typesPath = path.join(packageDir, typesEntry);
+    if (!fs.existsSync(typesPath)) {
+        return emptyResult;
+    }
+    try {
+        const content = fs.readFileSync(typesPath, "utf-8");
+        const exports = parseDeclarationFile(typesPath, content);
+        // Sort exports by name for consistent output.
+        exports.sort((a, b)=>a.name.localeCompare(b.name));
+        // Filter to runtime-only exports (exclude types and interfaces).
+        const runtimeExports = exports.filter((e)=>e.kind !== "type" && e.kind !== "interface");
+        return {
+            exports,
+            count: exports.length,
+            runtimeExports,
+            runtimeCount: runtimeExports.length
+        };
+    } catch  {
+        return emptyResult;
+    }
+}
+
+//# sourceMappingURL=exports.js.map

package/dist/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/exports.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * Represents a named export from a package.\n */\nexport type NamedExport = {\n\t/**\n\t * The export name (e.g., \"Button\", \"useState\").\n\t */\n\tname: string;\n\t/**\n\t * The type of export.\n\t */\n\tkind:\n\t\t| \"function\"\n\t\t| \"class\"\n\t\t| \"const\"\n\t\t| \"type\"\n\t\t| \"interface\"\n\t\t| \"enum\"\n\t\t| \"unknown\";\n};\n\n/**\n * Result from parsing package exports.\n */\nexport type ParsedExports = {\n\t/**\n\t * Array of all named exports found in the package (including types).\n\t */\n\texports: NamedExport[];\n\t/**\n\t * Total count of all named exports (including types).\n\t */\n\tcount: number;\n\t/**\n\t * Array of runtime exports only (excluding types and interfaces).\n\t */\n\truntimeExports: NamedExport[];\n\t/**\n\t * Count of runtime exports only (functions, classes, const, enums).\n\t */\n\truntimeCount: number;\n};\n\n/**\n * Resolve a relative import path to an absolute file path.\n */\nfunction resolveImportPath(\n\tbasePath: string,\n\timportPath: string,\n): string | null {\n\t// Remove quotes and trim.\n\tlet cleanPath = importPath.replace(/['\"]/g, \"\").trim();\n\n\t// Only handle relative imports.\n\tif (!cleanPath.startsWith(\".\")) {\n\t\treturn null;\n\t}\n\n\t/**\n\t * Strip .js/.mjs extension if present (TypeScript uses .js in imports but\n\t * .d.ts for types).\n\t */\n\tcleanPath = cleanPath.replace(/\\.(m?js)$/, \"\");\n\n\tconst baseDir = path.dirname(basePath);\n\tconst resolved = path.resolve(baseDir, cleanPath);\n\n\t// Try different extensions for the resolved path.\n\tconst extensions = [\".d.ts\", \".d.mts\", \".ts\", \"\"];\n\tfor (const ext of extensions) {\n\t\tconst tryPath = resolved + ext;\n\t\tif (fs.existsSync(tryPath) && fs.statSync(tryPath).isFile()) {\n\t\t\treturn tryPath;\n\t\t}\n\t}\n\n\t// Try index files in directory.\n\tfor (const ext of [\".d.ts\", \".d.mts\", \".ts\"]) {\n\t\tconst indexPath = path.join(resolved, `index${ext}`);\n\t\tif (fs.existsSync(indexPath) && fs.statSync(indexPath).isFile()) {\n\t\t\treturn indexPath;\n\t\t}\n\t}\n\n\treturn null;\n}\n\n/**\n * Parse a TypeScript declaration file (.d.ts) to extract named exports.\n * Recursively follows re-exports up to a maximum depth.\n */\nfunction parseDeclarationFile(\n\tfilePath: string,\n\tcontent: string,\n\tvisited: Set<string> = new Set(),\n\tdepth = 0,\n): NamedExport[] {\n\tconst MAX_DEPTH = 10;\n\tconst MAX_FILES = 500;\n\n\tif (depth > MAX_DEPTH || visited.size > MAX_FILES) {\n\t\treturn [];\n\t}\n\n\t// Avoid circular imports.\n\tconst normalizedPath = path.resolve(filePath);\n\tif (visited.has(normalizedPath)) {\n\t\treturn [];\n\t}\n\tvisited.add(normalizedPath);\n\n\tconst exports: NamedExport[] = [];\n\tconst seenNames = new Set<string>();\n\n\tconst addExport = (name: string, kind: NamedExport[\"kind\"]) => {\n\t\t// Skip internal/private exports and TypeScript utility types.\n\t\tif (name.startsWith(\"_\") || name === \"default\" || seenNames.has(name)) {\n\t\t\treturn;\n\t\t}\n\t\tseenNames.add(name);\n\t\texports.push({ name, kind });\n\t};\n\n\t// Pattern for: export * from './path'.\n\tconst reExportAllPattern = /export\\s+\\*\\s+from\\s+['\"]([^'\"]+)['\"]/g;\n\n\t// Pattern for: export type { Name, Name2 } from './path' (type-only exports).\n\tconst reExportTypePattern =\n\t\t/export\\s+type\\s+\\{([^}]+)\\}\\s+from\\s+['\"]([^'\"]+)['\"]/g;\n\n\t/**\n\t * Pattern for: export { Name, Name2 } from './path' (value exports - NOT\n\t * type).\n\t */\n\tconst reExportValuePattern =\n\t\t/export\\s+\\{([^}]+)\\}\\s+from\\s+['\"]([^'\"]+)['\"]/g;\n\n\t// Pattern for: export declare function Name.\n\tconst functionPattern = /export\\s+declare\\s+function\\s+(\\w+)/g;\n\t// Pattern for: export declare class Name.\n\tconst classPattern = /export\\s+declare\\s+class\\s+(\\w+)/g;\n\t// Pattern for: export declare const Name.\n\tconst constPattern = /export\\s+declare\\s+const\\s+(\\w+)/g;\n\t// Pattern for: export declare type Name.\n\tconst typePattern = /export\\s+declare\\s+type\\s+(\\w+)/g;\n\t// Pattern for: export type Name = ... (without declare).\n\tconst typePattern2 = /export\\s+type\\s+(\\w+)\\s*[=<]/g;\n\t// Pattern for: export type { Name } (local re-export without from).\n\tconst typeExportPattern = /export\\s+type\\s+\\{([^}]+)\\}\\s*;/g;\n\t// Pattern for: export interface Name.\n\tconst interfacePattern = /export\\s+(?:declare\\s+)?interface\\s+(\\w+)/g;\n\t// Pattern for: export declare enum Name.\n\tconst enumPattern = /export\\s+declare\\s+enum\\s+(\\w+)/g;\n\t// Pattern for: export { Name, Name2 } (without from - local exports).\n\tconst namedExportPattern = /export\\s+\\{([^}]+)\\}\\s*;/g;\n\t// Pattern for: export declare const Name: ... (component style).\n\tconst componentPattern = /export\\s+declare\\s+const\\s+(\\w+)\\s*:/g;\n\t// Pattern for: export function Name (without declare).\n\tconst functionPattern2 = /export\\s+function\\s+(\\w+)/g;\n\t// Pattern for: export class Name (without declare).\n\tconst classPattern2 = /export\\s+class\\s+(\\w+)/g;\n\t// Pattern for: export const Name (without declare).\n\tconst constPattern2 = /export\\s+const\\s+(\\w+)/g;\n\n\t// Helper to extract all matches from a regex.\n\tconst extractMatches = (pattern: RegExp, text: string): RegExpExecArray[] => {\n\t\tconst matches: RegExpExecArray[] = [];\n\t\tlet result = pattern.exec(text);\n\t\twhile (result !== null) {\n\t\t\tmatches.push(result);\n\t\t\tresult = pattern.exec(text);\n\t\t}\n\t\treturn matches;\n\t};\n\n\t// Handle: export * from './path' - recursively parse.\n\tfor (const match of extractMatches(reExportAllPattern, content)) {\n\t\tconst importPath = match[1];\n\t\tconst resolvedPath = resolveImportPath(filePath, importPath);\n\t\tif (resolvedPath) {\n\t\t\ttry {\n\t\t\t\tconst importedContent = fs.readFileSync(resolvedPath, \"utf-8\");\n\t\t\t\tconst importedExports = parseDeclarationFile(\n\t\t\t\t\tresolvedPath,\n\t\t\t\t\timportedContent,\n\t\t\t\t\tvisited,\n\t\t\t\t\tdepth + 1,\n\t\t\t\t);\n\t\t\t\tfor (const exp of importedExports) {\n\t\t\t\t\taddExport(exp.name, exp.kind);\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Ignore read errors.\n\t\t\t}\n\t\t}\n\t}\n\n\t// Handle: export type { Name } from './path' (type-only exports).\n\tfor (const match of extractMatches(reExportTypePattern, content)) {\n\t\tconst exportList = match[1];\n\t\tconst names = exportList.split(\",\").map((s) => {\n\t\t\tconst trimmed = s.trim();\n\t\t\t// Handle \"Name as Alias\".\n\t\t\tconst asMatch = trimmed.match(/(\\w+)\\s+as\\s+(\\w+)/);\n\t\t\tif (asMatch) {\n\t\t\t\treturn asMatch[2];\n\t\t\t}\n\t\t\treturn trimmed;\n\t\t});\n\n\t\tfor (const name of names) {\n\t\t\tif (name && /^\\w+$/.test(name)) {\n\t\t\t\taddExport(name, \"type\");\n\t\t\t}\n\t\t}\n\t}\n\n\t// Handle: export { Name } from './path' (value exports).\n\tfor (const match of extractMatches(reExportValuePattern, content)) {\n\t\t// Skip if this is actually a type export (already handled above).\n\t\tconst fullMatch = match[0];\n\t\tif (fullMatch.includes(\"export type\")) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst exportList = match[1];\n\t\tconst names = exportList.split(\",\").map((s) => {\n\t\t\tconst trimmed = s.trim();\n\t\t\t// Handle \"Name as Alias\".\n\t\t\tconst asMatch = trimmed.match(/(\\w+)\\s+as\\s+(\\w+)/);\n\t\t\tif (asMatch) {\n\t\t\t\treturn asMatch[2];\n\t\t\t}\n\t\t\t// Handle \"type Name\" syntax within the braces.\n\t\t\tconst typeMatch = trimmed.match(/type\\s+(\\w+)/);\n\t\t\tif (typeMatch) {\n\t\t\t\t/**\n\t\t\t\t * This is a type being re-exported, skip it (will be handled by type\n\t\t\t\t * pattern).\n\t\t\t\t */\n\t\t\t\treturn null;\n\t\t\t}\n\t\t\treturn trimmed;\n\t\t});\n\n\t\tfor (const name of names) {\n\t\t\tif (name && /^\\w+$/.test(name)) {\n\t\t\t\taddExport(name, \"unknown\");\n\t\t\t}\n\t\t}\n\t}\n\n\t// Extract functions.\n\tfor (const match of extractMatches(functionPattern, content)) {\n\t\taddExport(match[1], \"function\");\n\t}\n\tfor (const match of extractMatches(functionPattern2, content)) {\n\t\taddExport(match[1], \"function\");\n\t}\n\n\t// Extract classes.\n\tfor (const match of extractMatches(classPattern, content)) {\n\t\taddExport(match[1], \"class\");\n\t}\n\tfor (const match of extractMatches(classPattern2, content)) {\n\t\taddExport(match[1], \"class\");\n\t}\n\n\t// Extract const (includes React components).\n\tfor (const match of extractMatches(constPattern, content)) {\n\t\taddExport(match[1], \"const\");\n\t}\n\tfor (const match of extractMatches(constPattern2, content)) {\n\t\taddExport(match[1], \"const\");\n\t}\n\n\t// Also catch component-style declarations.\n\tfor (const match of extractMatches(componentPattern, content)) {\n\t\taddExport(match[1], \"const\");\n\t}\n\n\t// Extract types (declare type).\n\tfor (const match of extractMatches(typePattern, content)) {\n\t\taddExport(match[1], \"type\");\n\t}\n\n\t// Extract types (export type X =).\n\tfor (const match of extractMatches(typePattern2, content)) {\n\t\taddExport(match[1], \"type\");\n\t}\n\n\t// Extract type exports (export type { X }).\n\tfor (const match of extractMatches(typeExportPattern, content)) {\n\t\tconst exportList = match[1];\n\t\tconst names = exportList.split(\",\").map((s) => s.trim());\n\t\tfor (const name of names) {\n\t\t\tif (name && /^\\w+$/.test(name)) {\n\t\t\t\taddExport(name, \"type\");\n\t\t\t}\n\t\t}\n\t}\n\n\t// Extract interfaces.\n\tfor (const match of extractMatches(interfacePattern, content)) {\n\t\taddExport(match[1], \"interface\");\n\t}\n\n\t// Extract enums.\n\tfor (const match of extractMatches(enumPattern, content)) {\n\t\taddExport(match[1], \"enum\");\n\t}\n\n\t/**\n\t * Extract named exports from export { ... } (without from - these are local\n\t * exports).\n\t */\n\tfor (const match of extractMatches(namedExportPattern, content)) {\n\t\tconst exportList = match[1];\n\t\t// Skip if this looks like a type export (already handled above).\n\t\tif (content.substring(match.index - 5, match.index).includes(\"type\")) {\n\t\t\tcontinue;\n\t\t}\n\t\tconst names = exportList.split(\",\").map((s) => {\n\t\t\tconst trimmed = s.trim();\n\t\t\tconst asMatch = trimmed.match(/(\\w+)\\s+as\\s+(\\w+)/);\n\t\t\tif (asMatch) {\n\t\t\t\treturn asMatch[2];\n\t\t\t}\n\t\t\tconst typeMatch = trimmed.match(/type\\s+(\\w+)/);\n\t\t\tif (typeMatch) {\n\t\t\t\treturn typeMatch[1];\n\t\t\t}\n\t\t\treturn trimmed;\n\t\t});\n\n\t\tfor (const name of names) {\n\t\t\tif (name && /^\\w+$/.test(name)) {\n\t\t\t\taddExport(name, \"unknown\");\n\t\t\t}\n\t\t}\n\t}\n\n\treturn exports;\n}\n\n/**\n * Get named exports from an installed package by parsing its type definitions.\n *\n * @param tmpDir - The temporary directory where the package is installed\n * @param packageName - The package name (e.g., \"@mantine/core\")\n * @returns ParsedExports containing the list of exports and count\n *\n */\nexport function getNamedExports(\n\ttmpDir: string,\n\tpackageName: string,\n): ParsedExports {\n\tconst packageDir = path.join(tmpDir, \"node_modules\", packageName);\n\n\tconst emptyResult: ParsedExports = {\n\t\texports: [],\n\t\tcount: 0,\n\t\truntimeExports: [],\n\t\truntimeCount: 0,\n\t};\n\n\t// Try to read package.json to find the types entry.\n\tconst pkgJsonPath = path.join(packageDir, \"package.json\");\n\tif (!fs.existsSync(pkgJsonPath)) {\n\t\treturn emptyResult;\n\t}\n\n\tlet typesEntry: string | undefined;\n\ttry {\n\t\tconst pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, \"utf-8\"));\n\n\t\t// Look for types in order of preference.\n\t\ttypesEntry =\n\t\t\tpkgJson.types ||\n\t\t\tpkgJson.typings ||\n\t\t\tpkgJson.exports?.[\".\"]?.types ||\n\t\t\t(typeof pkgJson.exports?.[\".\"] === \"object\" &&\n\t\t\t\tpkgJson.exports[\".\"].types);\n\n\t\t// If no types field, try common patterns.\n\t\tif (!typesEntry) {\n\t\t\tconst commonPaths = [\n\t\t\t\t\"dist/index.d.ts\",\n\t\t\t\t\"lib/index.d.ts\",\n\t\t\t\t\"index.d.ts\",\n\t\t\t\t\"types/index.d.ts\",\n\t\t\t];\n\t\t\tfor (const tryPath of commonPaths) {\n\t\t\t\tif (fs.existsSync(path.join(packageDir, tryPath))) {\n\t\t\t\t\ttypesEntry = tryPath;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t} catch {\n\t\treturn emptyResult;\n\t}\n\n\tif (!typesEntry) {\n\t\treturn emptyResult;\n\t}\n\n\t// Read and parse the types file.\n\tconst typesPath = path.join(packageDir, typesEntry);\n\tif (!fs.existsSync(typesPath)) {\n\t\treturn emptyResult;\n\t}\n\n\ttry {\n\t\tconst content = fs.readFileSync(typesPath, \"utf-8\");\n\t\tconst exports = parseDeclarationFile(typesPath, content);\n\n\t\t// Sort exports by name for consistent output.\n\t\texports.sort((a, b) => a.name.localeCompare(b.name));\n\n\t\t// Filter to runtime-only exports (exclude types and interfaces).\n\t\tconst runtimeExports = exports.filter(\n\t\t\t(e) => e.kind !== \"type\" && e.kind !== \"interface\",\n\t\t);\n\n\t\treturn {\n\t\t\texports,\n\t\t\tcount: exports.length,\n\t\t\truntimeExports,\n\t\t\truntimeCount: runtimeExports.length,\n\t\t};\n\t} catch {\n\t\treturn emptyResult;\n\t}\n}\n"],"names":["fs","path","resolveImportPath","basePath","importPath","cleanPath","replace","trim","startsWith","baseDir","dirname","resolved","resolve","extensions","ext","tryPath","existsSync","statSync","isFile","indexPath","join","parseDeclarationFile","filePath","content","visited","Set","depth","MAX_DEPTH","MAX_FILES","size","normalizedPath","has","add","exports","seenNames","addExport","name","kind","push","reExportAllPattern","reExportTypePattern","reExportValuePattern","functionPattern","classPattern","constPattern","typePattern","typePattern2","typeExportPattern","interfacePattern","enumPattern","namedExportPattern","componentPattern","functionPattern2","classPattern2","constPattern2","extractMatches","pattern","text","matches","result","exec","match","resolvedPath","importedContent","readFileSync","importedExports","exp","exportList","names","split","map","s","trimmed","asMatch","test","fullMatch","includes","typeMatch","substring","index","getNamedExports","tmpDir","packageName","packageDir","emptyResult","count","runtimeExports","runtimeCount","pkgJsonPath","typesEntry","pkgJson","JSON","parse","types","typings","commonPaths","typesPath","sort","a","b","localeCompare","filter","e","length"],"mappings":"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"}

package/dist/index.d.ts

@@ -27,7 +27,7 @@ export type GetBundleStatsOptions = {
      */
     external?: string[];
     /**
-     * Bundle everything including default externals (react, react-dom).
+     * Bundle everything including dependencies that would normally be external.
      */
     noExternal?: boolean;
     /**
@@ -100,6 +100,11 @@ export type BundleStats = {
      * Whether the result was retrieved from cache.
      */
     fromCache: boolean;
+    /**
+     * Total number of named exports in the package (when analyzing entire
+     * package).
+     */
+    namedExportCount: number;
 };
 /**
  * Options for getting bundle size trend across versions.
@@ -122,7 +127,7 @@ export type GetBundleTrendOptions = {
      */
     external?: string[];
     /**
-     * Bundle everything including default externals (react, react-dom).
+     * Bundle everything including dependencies that would normally be external.
      */
     noExternal?: boolean;
     /**
@@ -303,6 +308,80 @@ export declare function getBundleTrend(options: GetBundleTrendOptions): Promise<
  *
  */
 export declare function getPackageVersions(options: GetPackageVersionsOptions): Promise<PackageVersions>;
+/**
+ * Options for getting package exports.
+ */
+export type GetPackageExportsOptions = {
+    /**
+     * Package name with optional version (e.g., "@mantine/core" or
+     * "@mantine/core@7.0.0").
+     */
+    package: string;
+    /**
+     * Custom npm registry URL.
+     */
+    registry?: string;
+};
+/**
+ * A named export from a package.
+ */
+export type PackageExport = {
+    /**
+     * The export name (e.g., "Button", "useState").
+     */
+    name: string;
+    /**
+     * The type of export.
+     */
+    kind: "function" | "class" | "const" | "type" | "interface" | "enum" | "unknown";
+};
+/**
+ * Result from getPackageExports.
+ */
+export type PackageExports = {
+    /**
+     * Package name.
+     */
+    packageName: string;
+    /**
+     * Resolved package version.
+     */
+    packageVersion: string;
+    /**
+     * Array of all named exports found in the package (including types).
+     */
+    exports: PackageExport[];
+    /**
+     * Total count of all named exports (including types).
+     */
+    count: number;
+    /**
+     * Array of runtime exports only (excluding types and interfaces). These are
+     * the exports that can actually be imported at runtime.
+     */
+    runtimeExports: PackageExport[];
+    /**
+     * Count of runtime exports only (functions, classes, const, enums).
+     */
+    runtimeCount: number;
+};
+/**
+ * Get the named exports of an npm package by analyzing its type definitions.
+ *
+ * @example
+ * ```js
+ * import { getPackageExports } from "@node-cli/bundlecheck";
+ *
+ * const { exports, count } = await getPackageExports({
+ *   package: "@mantine/core@7.0.0",
+ * });
+ *
+ * console.log(`Found ${count} exports`);
+ * console.log(exports.map(e => e.name)); // ["Accordion", "ActionIcon", "Alert", ...]
+ * ```
+ *
+ */
+export declare function getPackageExports(options: GetPackageExportsOptions): Promise<PackageExports>;
 /**
  * =============================================================================
  * Re-exports for advanced usage

package/dist/index.js

@@ -3,7 +3,7 @@
  *
  * Programmatic interface for analyzing npm package bundle sizes.
  *
- */ import { checkBundleSize, formatBytes, getExternals, parsePackageSpecifier } from "./bundler.js";
+ */ import { checkBundleSize, formatBytes, parsePackageSpecifier } from "./bundler.js";
 import { getCachedResult, normalizeCacheKey, setCachedResult } from "./cache.js";
 import { normalizePlatform, TREND_VERSION_COUNT } from "./defaults.js";
 import { analyzeTrend, selectTrendVersions } from "./trend.js";
@@ -42,16 +42,18 @@ import { fetchPackageVersions as fetchVersions } from "./versions.js";
         });
         resolvedVersion = tags.latest || requestedVersion;
     }
-    // Compute externals for cache key.
-    const externals = getExternals(baseName, additionalExternals, noExternal);
-    // Build cache key.
-    const cacheKey = normalizeCacheKey({
+    /**
+	 * Build cache key.
+	 * NOTE: We use additionalExternals here, not computed externals, because the default externals (react, react-dom) are determined at bundle time based on the package's dependencies.
+	 * The cache key captures the user's intent (additionalExternals + noExternal
+	 * flag), and the actual externals are stored in the cached result.
+	 */ const cacheKey = normalizeCacheKey({
         packageName: baseName,
         version: resolvedVersion,
         exports: exportsList,
         platform,
         gzipLevel,
-        externals,
+        externals: additionalExternals || [],
         noExternal: noExternal ?? false
     });
     // Check cache (unless force is set).
@@ -190,6 +192,60 @@ import { fetchPackageVersions as fetchVersions } from "./versions.js";
         tags: result.tags
     };
 }
+/**
+ * Get the named exports of an npm package by analyzing its type definitions.
+ *
+ * @example
+ * ```js
+ * import { getPackageExports } from "@node-cli/bundlecheck";
+ *
+ * const { exports, count } = await getPackageExports({
+ *   package: "@mantine/core@7.0.0",
+ * });
+ *
+ * console.log(`Found ${count} exports`);
+ * console.log(exports.map(e => e.name)); // ["Accordion", "ActionIcon", "Alert", ...]
+ * ```
+ *
+ */ export async function getPackageExports(options) {
+    const { package: packageName, registry } = options;
+    /**
+	 * Import the install utilities from bundler (we'll use a minimal bundle
+	 * check).
+	 */ const { name: baseName, version: requestedVersion } = parsePackageSpecifier(packageName);
+    // Resolve "latest" to actual version.
+    let resolvedVersion = requestedVersion;
+    if (requestedVersion === "latest") {
+        const { tags } = await fetchVersions({
+            packageName: baseName,
+            registry
+        });
+        resolvedVersion = tags.latest || requestedVersion;
+    }
+    /**
+	 * Use a minimal bundle check to install the package and get exports We'll
+	 * leverage the existing infrastructure.
+	 */ const { installPackage } = await import("./exports-installer.js");
+    const { version, exports, runtimeExports } = await installPackage({
+        packageName: baseName,
+        version: resolvedVersion,
+        registry
+    });
+    return {
+        packageName: baseName,
+        packageVersion: version,
+        exports: exports.map((e)=>({
+                name: e.name,
+                kind: e.kind
+            })),
+        count: exports.length,
+        runtimeExports: runtimeExports.map((e)=>({
+                name: e.name,
+                kind: e.kind
+            })),
+        runtimeCount: runtimeExports.length
+    };
+}
 /**
  * =============================================================================
  * Re-exports for advanced usage
@@ -222,7 +278,8 @@ import { fetchPackageVersions as fetchVersions } from "./versions.js";
         platform: result.platform,
         rawSizeFormatted: formatBytes(result.rawSize),
         gzipSizeFormatted: result.gzipSize !== null ? formatBytes(result.gzipSize) : null,
-        fromCache
+        fromCache,
+        namedExportCount: result.namedExportCount
     };
 }