@kkvcrobatz107/codegraph 0.9.6-pkm.1

package/dist/resolution/import-resolver.js

@@ -0,0 +1,1231 @@
+"use strict";
+/**
+ * Import Resolver
+ *
+ * Resolves import paths to actual files and symbols.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveImportPath = resolveImportPath;
+exports.clearCppIncludeDirCache = clearCppIncludeDirCache;
+exports.loadCppIncludeDirs = loadCppIncludeDirs;
+exports.extractImportMappings = extractImportMappings;
+exports.clearImportMappingCache = clearImportMappingCache;
+exports.extractReExports = extractReExports;
+exports.resolveJvmImport = resolveJvmImport;
+exports.resolveViaImport = resolveViaImport;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const path_aliases_1 = require("./path-aliases");
+/**
+ * Extension resolution order by language
+ */
+const EXTENSION_RESOLUTION = {
+    typescript: ['.ts', '.tsx', '.d.ts', '.js', '.jsx', '/index.ts', '/index.tsx', '/index.js'],
+    javascript: ['.js', '.jsx', '.mjs', '.cjs', '/index.js', '/index.jsx'],
+    tsx: ['.tsx', '.ts', '.d.ts', '.js', '.jsx', '/index.tsx', '/index.ts', '/index.js'],
+    jsx: ['.jsx', '.js', '/index.jsx', '/index.js'],
+    python: ['.py', '/__init__.py'],
+    go: ['.go'],
+    rust: ['.rs', '/mod.rs'],
+    java: ['.java'],
+    c: ['.h', '.c'],
+    cpp: ['.h', '.hpp', '.hxx', '.cpp', '.cc', '.cxx'],
+    csharp: ['.cs'],
+    php: ['.php'],
+    ruby: ['.rb'],
+    objc: ['.h', '.m', '.mm'],
+};
+/**
+ * Resolve an import path to an actual file
+ */
+function resolveImportPath(importPath, fromFile, language, context) {
+    // Skip external/npm packages — but pass the context so the
+    // bare-specifier heuristic can consult the project's tsconfig
+    // alias map first (custom prefixes like `@components/*` would
+    // otherwise be misclassified as npm).
+    if (isExternalImport(importPath, language, context)) {
+        return null;
+    }
+    const projectRoot = context.getProjectRoot();
+    const fromDir = path.dirname(path.join(projectRoot, fromFile));
+    // Handle relative imports
+    if (importPath.startsWith('.')) {
+        return resolveRelativeImport(importPath, fromDir, language, context);
+    }
+    // Handle absolute/aliased imports (like @/ or src/)
+    const aliased = resolveAliasedImport(importPath, projectRoot, language, context);
+    if (aliased)
+        return aliased;
+    // C/C++ include directory search: when neither relative nor aliased
+    // resolution found a match, search -I directories from
+    // compile_commands.json or heuristic probing.
+    if (language === 'c' || language === 'cpp') {
+        return resolveCppIncludePath(importPath, language, context);
+    }
+    return null;
+}
+/**
+ * C and C++ standard library header names (without delimiters).
+ * Used by isExternalImport to filter system includes from resolution.
+ */
+const C_CPP_STDLIB_HEADERS = new Set([
+    // C standard library headers
+    'assert.h', 'complex.h', 'ctype.h', 'errno.h', 'fenv.h', 'float.h',
+    'inttypes.h', 'iso646.h', 'limits.h', 'locale.h', 'math.h', 'setjmp.h',
+    'signal.h', 'stdalign.h', 'stdarg.h', 'stdatomic.h', 'stdbool.h',
+    'stddef.h', 'stdint.h', 'stdio.h', 'stdlib.h', 'stdnoreturn.h',
+    'string.h', 'tgmath.h', 'threads.h', 'time.h', 'uchar.h', 'wchar.h',
+    'wctype.h',
+    // C++ C-library wrappers (cname form)
+    'cassert', 'ccomplex', 'cctype', 'cerrno', 'cfenv', 'cfloat',
+    'cinttypes', 'ciso646', 'climits', 'clocale', 'cmath', 'csetjmp',
+    'csignal', 'cstdalign', 'cstdarg', 'cstdbool', 'cstddef', 'cstdint',
+    'cstdio', 'cstdlib', 'cstring', 'ctgmath', 'ctime', 'cuchar',
+    'cwchar', 'cwctype',
+    // C++ STL headers
+    'algorithm', 'any', 'array', 'atomic', 'barrier', 'bit', 'bitset',
+    'charconv', 'chrono', 'codecvt', 'compare', 'complex', 'concepts',
+    'condition_variable', 'coroutine', 'deque', 'exception', 'execution',
+    'expected', 'filesystem', 'format', 'forward_list', 'fstream',
+    'functional', 'future', 'generator', 'initializer_list', 'iomanip',
+    'ios', 'iosfwd', 'iostream', 'istream', 'iterator', 'latch',
+    'limits', 'list', 'locale', 'map', 'mdspan', 'memory', 'memory_resource',
+    'mutex', 'new', 'numbers', 'numeric', 'optional', 'ostream', 'print',
+    'queue', 'random', 'ranges', 'ratio', 'regex', 'scoped_allocator',
+    'semaphore', 'set', 'shared_mutex', 'source_location', 'span',
+    'spanstream', 'sstream', 'stack', 'stacktrace', 'stdexcept',
+    'stdfloat', 'stop_token', 'streambuf', 'string', 'string_view',
+    'strstream', 'syncstream', 'system_error', 'thread', 'tuple',
+    'type_traits', 'typeindex', 'typeinfo', 'unordered_map',
+    'unordered_set', 'utility', 'valarray', 'variant', 'vector',
+    'version',
+]);
+/**
+ * Check if an import is external (npm package, etc.)
+ *
+ * `context` is consulted for project-defined path aliases
+ * (tsconfig/jsconfig `paths`). Without that check, custom prefixes
+ * like `@components/*` would fail the bare-specifier heuristic and
+ * be classified as external before alias resolution can run.
+ */
+function isExternalImport(importPath, language, context) {
+    // Relative imports are not external
+    if (importPath.startsWith('.')) {
+        return false;
+    }
+    // Common external patterns
+    if (language === 'typescript' || language === 'javascript' || language === 'tsx' || language === 'jsx') {
+        // Node built-ins
+        if (['fs', 'path', 'os', 'crypto', 'http', 'https', 'url', 'util', 'events', 'stream', 'child_process', 'buffer'].includes(importPath)) {
+            return true;
+        }
+        // Project-defined alias prefix? Treat as local.
+        const aliases = context?.getProjectAliases?.();
+        if (aliases) {
+            for (const pat of aliases.patterns) {
+                if (importPath.startsWith(pat.prefix))
+                    return false;
+            }
+        }
+        // Scoped packages or bare specifiers that don't start with aliases
+        if (!importPath.startsWith('@/') && !importPath.startsWith('~/') && !importPath.startsWith('src/')) {
+            // Likely an npm package
+            return true;
+        }
+    }
+    if (language === 'python') {
+        // Standard library modules
+        const stdLibs = ['os', 'sys', 'json', 're', 'math', 'datetime', 'collections', 'typing', 'pathlib', 'logging'];
+        if (stdLibs.includes(importPath.split('.')[0])) {
+            return true;
+        }
+    }
+    if (language === 'go') {
+        // Relative imports (rare in idiomatic Go but the grammar allows them).
+        if (importPath.startsWith('.')) {
+            return false;
+        }
+        // In-module imports look like `<module-path>/sub/pkg` — local to
+        // this project. Without the module-path check we'd flag every
+        // cross-package call in a Go monorepo as external (issue #388).
+        const mod = context?.getGoModule?.();
+        if (mod && (importPath === mod.modulePath || importPath.startsWith(mod.modulePath + '/'))) {
+            return false;
+        }
+        // `internal/` packages stay local even when go.mod is missing —
+        // preserves the pre-#388 escape hatch for repos without a parsed module path.
+        if (importPath.includes('/internal/')) {
+            return false;
+        }
+        // Anything else is the Go standard library or a third-party module.
+        return true;
+    }
+    if (language === 'c' || language === 'cpp') {
+        // C/C++ standard library headers — both C-style (<stdio.h>) and
+        // C++-style (<cstdio>, <vector>) forms. Checked against the import
+        // path (which the extractor strips of <> or "" delimiters).
+        if (C_CPP_STDLIB_HEADERS.has(importPath))
+            return true;
+        // C++ headers without .h extension (e.g. "vector", "string")
+        const withoutExt = importPath.replace(/\.h$/, '');
+        if (C_CPP_STDLIB_HEADERS.has(withoutExt))
+            return true;
+    }
+    return false;
+}
+/**
+ * Resolve a relative import
+ */
+function resolveRelativeImport(importPath, fromDir, language, context) {
+    const projectRoot = context.getProjectRoot();
+    const extensions = EXTENSION_RESOLUTION[language] || [];
+    // Try the path as-is first
+    const basePath = path.resolve(fromDir, importPath);
+    const relativePath = path.relative(projectRoot, basePath).replace(/\\/g, '/');
+    // Try each extension
+    for (const ext of extensions) {
+        const candidatePath = relativePath + ext;
+        if (context.fileExists(candidatePath)) {
+            return candidatePath;
+        }
+    }
+    // Try without extension (might already have one)
+    if (context.fileExists(relativePath)) {
+        return relativePath;
+    }
+    return null;
+}
+/**
+ * Resolve an aliased/absolute import.
+ *
+ * Tries, in order:
+ *   1. Project-defined `compilerOptions.paths` (tsconfig/jsconfig).
+ *      Each pattern can have multiple replacements; tried in tsconfig
+ *      priority order with extension permutations.
+ *   2. The legacy hard-coded fallback list (`@/`, `~/`, `src/`, ...)
+ *      for projects that have aliases but no tsconfig paths block.
+ *   3. Direct path lookup (with extensions).
+ */
+function resolveAliasedImport(importPath, projectRoot, language, context) {
+    const extensions = EXTENSION_RESOLUTION[language] || [];
+    const tryWithExt = (basePath) => {
+        for (const ext of extensions) {
+            const candidate = basePath + ext;
+            if (context.fileExists(candidate))
+                return candidate;
+        }
+        if (context.fileExists(basePath))
+            return basePath;
+        return null;
+    };
+    // 1. Project tsconfig/jsconfig paths.
+    const aliasMap = context.getProjectAliases?.();
+    if (aliasMap) {
+        const candidates = (0, path_aliases_1.applyAliases)(importPath, aliasMap, projectRoot);
+        for (const c of candidates) {
+            const hit = tryWithExt(c);
+            if (hit)
+                return hit;
+        }
+    }
+    // 2. Hard-coded fallback list. Kept for projects that use these
+    //    conventional aliases without declaring them in tsconfig.
+    const fallbackAliases = {
+        '@/': 'src/',
+        '~/': 'src/',
+        '@src/': 'src/',
+        'src/': 'src/',
+        '@app/': 'app/',
+        'app/': 'app/',
+    };
+    for (const [alias, replacement] of Object.entries(fallbackAliases)) {
+        if (importPath.startsWith(alias)) {
+            const hit = tryWithExt(importPath.replace(alias, replacement));
+            if (hit)
+                return hit;
+        }
+    }
+    // 3. Direct path.
+    return tryWithExt(importPath);
+}
+/**
+ * C/C++ include directory cache (keyed by project root).
+ * Loaded once per resolver instance, shared across calls.
+ */
+const cppIncludeDirCache = new Map();
+/**
+ * Clear the C/C++ include directory cache (call between indexing runs)
+ */
+function clearCppIncludeDirCache() {
+    cppIncludeDirCache.clear();
+}
+/**
+ * Discover C/C++ include search directories for a project.
+ *
+ * Strategy:
+ * 1. Look for compile_commands.json (Clang compilation database) in the
+ *    project root and common build subdirectories. Parse -I and -isystem
+ *    flags from compiler commands.
+ * 2. If no compilation database is found, probe for common convention
+ *    directories (include/, src/, lib/, api/) and top-level directories
+ *    containing .h/.hpp files.
+ *
+ * Returns paths relative to projectRoot.
+ */
+function loadCppIncludeDirs(projectRoot) {
+    const cached = cppIncludeDirCache.get(projectRoot);
+    if (cached !== undefined)
+        return cached;
+    const dirs = loadCppIncludeDirsFromCompileDB(projectRoot)
+        || loadCppIncludeDirsHeuristic(projectRoot);
+    cppIncludeDirCache.set(projectRoot, dirs);
+    return dirs;
+}
+/**
+ * Try to load include directories from compile_commands.json.
+ * Returns null if no compilation database is found (so the heuristic
+ * fallback can run). Returns an array (possibly empty) otherwise.
+ */
+function loadCppIncludeDirsFromCompileDB(projectRoot) {
+    const candidates = [
+        path.join(projectRoot, 'compile_commands.json'),
+        path.join(projectRoot, 'build', 'compile_commands.json'),
+        path.join(projectRoot, 'cmake-build-debug', 'compile_commands.json'),
+        path.join(projectRoot, 'cmake-build-release', 'compile_commands.json'),
+        path.join(projectRoot, 'out', 'compile_commands.json'),
+    ];
+    let dbPath;
+    for (const c of candidates) {
+        try {
+            if (fs.existsSync(c)) {
+                dbPath = c;
+                break;
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    if (!dbPath)
+        return null;
+    try {
+        const content = fs.readFileSync(dbPath, 'utf-8');
+        const entries = JSON.parse(content);
+        if (!Array.isArray(entries))
+            return null;
+        const dirSet = new Set();
+        for (const entry of entries) {
+            const dir = entry.directory || projectRoot;
+            const args = entry.arguments || (entry.command ? shlexSplit(entry.command) : []);
+            for (let i = 0; i < args.length; i++) {
+                const arg = args[i];
+                let includeDir;
+                // -I<dir> (no space)
+                if (arg.startsWith('-I') && arg.length > 2) {
+                    includeDir = arg.substring(2);
+                }
+                // -isystem <dir> (space-separated)
+                else if ((arg === '-isystem' || arg === '-I') && i + 1 < args.length) {
+                    includeDir = args[i + 1];
+                    i++; // skip next arg
+                }
+                if (includeDir) {
+                    // Normalize: resolve relative to the compilation directory
+                    const absPath = path.isAbsolute(includeDir)
+                        ? includeDir
+                        : path.resolve(dir, includeDir);
+                    const relPath = path.relative(projectRoot, absPath).replace(/\\/g, '/');
+                    // Skip system directories and paths outside the project
+                    // (relative paths starting with .. or absolute paths like
+                    // /usr/include or C:\usr on Windows)
+                    if (!relPath.startsWith('..') && relPath.length > 0 && !path.isAbsolute(relPath)) {
+                        dirSet.add(relPath);
+                    }
+                }
+            }
+        }
+        return Array.from(dirSet);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Minimal shlex-style split for compiler command strings.
+ * Handles double-quoted and single-quoted arguments.
+ */
+function shlexSplit(cmd) {
+    const result = [];
+    let i = 0;
+    while (i < cmd.length) {
+        // Skip whitespace
+        while (i < cmd.length && /\s/.test(cmd[i]))
+            i++;
+        if (i >= cmd.length)
+            break;
+        const ch = cmd[i];
+        if (ch === '"') {
+            i++;
+            let arg = '';
+            while (i < cmd.length && cmd[i] !== '"') {
+                if (cmd[i] === '\\' && i + 1 < cmd.length) {
+                    i++;
+                    arg += cmd[i];
+                }
+                else {
+                    arg += cmd[i];
+                }
+                i++;
+            }
+            i++; // closing quote
+            result.push(arg);
+        }
+        else if (ch === "'") {
+            i++;
+            let arg = '';
+            while (i < cmd.length && cmd[i] !== "'") {
+                arg += cmd[i];
+                i++;
+            }
+            i++; // closing quote
+            result.push(arg);
+        }
+        else {
+            let arg = '';
+            while (i < cmd.length && !/\s/.test(cmd[i])) {
+                arg += cmd[i];
+                i++;
+            }
+            result.push(arg);
+        }
+    }
+    return result;
+}
+/**
+ * Heuristic include directory discovery when no compile_commands.json exists.
+ * Checks common convention directories and scans top-level dirs for headers.
+ */
+function loadCppIncludeDirsHeuristic(projectRoot) {
+    const dirs = [];
+    const conventionDirs = ['include', 'src', 'lib', 'api', 'inc'];
+    try {
+        const entries = fs.readdirSync(projectRoot, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const name = entry.name;
+            // Convention directories
+            if (conventionDirs.includes(name.toLowerCase())) {
+                dirs.push(name);
+                continue;
+            }
+            // Any top-level directory containing .h or .hpp files
+            try {
+                const subFiles = fs.readdirSync(path.join(projectRoot, name));
+                if (subFiles.some(f => /\.(h|hpp|hxx|hh)$/i.test(f))) {
+                    dirs.push(name);
+                }
+            }
+            catch {
+                // ignore permission errors
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    return dirs;
+}
+/**
+ * Resolve a C/C++ include path by searching include directories.
+ * Called as a fallback after relative and aliased resolution fail.
+ */
+function resolveCppIncludePath(importPath, language, context) {
+    const includeDirs = context.getCppIncludeDirs?.() ?? [];
+    const extensions = EXTENSION_RESOLUTION[language] ?? [];
+    for (const dir of includeDirs) {
+        const normalizedDir = dir.replace(/\\/g, '/');
+        for (const ext of extensions) {
+            const candidate = normalizedDir + '/' + importPath + ext;
+            if (context.fileExists(candidate))
+                return candidate;
+        }
+        // Try as-is (already has extension)
+        const candidate = normalizedDir + '/' + importPath;
+        if (context.fileExists(candidate))
+            return candidate;
+    }
+    return null;
+}
+/**
+ * Extract import mappings from a file
+ */
+function extractImportMappings(_filePath, content, language) {
+    const mappings = [];
+    if (language === 'typescript' || language === 'javascript' || language === 'tsx' || language === 'jsx') {
+        mappings.push(...extractJSImports(content));
+    }
+    else if (language === 'python') {
+        mappings.push(...extractPythonImports(content));
+    }
+    else if (language === 'go') {
+        mappings.push(...extractGoImports(content));
+    }
+    else if (language === 'java' || language === 'kotlin') {
+        mappings.push(...extractJavaImports(content));
+    }
+    else if (language === 'php') {
+        mappings.push(...extractPHPImports(content));
+    }
+    else if (language === 'c' || language === 'cpp') {
+        mappings.push(...extractCppImports(content));
+    }
+    return mappings;
+}
+/**
+ * Extract JS/TS import mappings
+ */
+function extractJSImports(content) {
+    const mappings = [];
+    // ES6 imports
+    const importRegex = /import\s+(?:(\w+)\s*,?\s*)?(?:\{([^}]+)\})?\s*(?:(\*)\s+as\s+(\w+))?\s*from\s*['"]([^'"]+)['"]/g;
+    let match;
+    while ((match = importRegex.exec(content)) !== null) {
+        const [, defaultImport, namedImports, star, namespaceAlias, source] = match;
+        // Default import
+        if (defaultImport) {
+            mappings.push({
+                localName: defaultImport,
+                exportedName: 'default',
+                source: source,
+                isDefault: true,
+                isNamespace: false,
+            });
+        }
+        // Named imports
+        if (namedImports) {
+            const names = namedImports.split(',').map((s) => s.trim());
+            for (const name of names) {
+                const aliasMatch = name.match(/(\w+)\s+as\s+(\w+)/);
+                if (aliasMatch) {
+                    mappings.push({
+                        localName: aliasMatch[2],
+                        exportedName: aliasMatch[1],
+                        source: source,
+                        isDefault: false,
+                        isNamespace: false,
+                    });
+                }
+                else if (name) {
+                    mappings.push({
+                        localName: name,
+                        exportedName: name,
+                        source: source,
+                        isDefault: false,
+                        isNamespace: false,
+                    });
+                }
+            }
+        }
+        // Namespace import
+        if (star && namespaceAlias) {
+            mappings.push({
+                localName: namespaceAlias,
+                exportedName: '*',
+                source: source,
+                isDefault: false,
+                isNamespace: true,
+            });
+        }
+    }
+    // Require statements
+    const requireRegex = /(?:const|let|var)\s+(?:(\w+)|{([^}]+)})\s*=\s*require\(['"]([^'"]+)['"]\)/g;
+    while ((match = requireRegex.exec(content)) !== null) {
+        const [, defaultName, destructured, source] = match;
+        if (defaultName) {
+            mappings.push({
+                localName: defaultName,
+                exportedName: 'default',
+                source: source,
+                isDefault: true,
+                isNamespace: false,
+            });
+        }
+        if (destructured) {
+            const names = destructured.split(',').map((s) => s.trim());
+            for (const name of names) {
+                const aliasMatch = name.match(/(\w+)\s*:\s*(\w+)/);
+                if (aliasMatch) {
+                    mappings.push({
+                        localName: aliasMatch[2],
+                        exportedName: aliasMatch[1],
+                        source: source,
+                        isDefault: false,
+                        isNamespace: false,
+                    });
+                }
+                else if (name) {
+                    mappings.push({
+                        localName: name,
+                        exportedName: name,
+                        source: source,
+                        isDefault: false,
+                        isNamespace: false,
+                    });
+                }
+            }
+        }
+    }
+    return mappings;
+}
+/**
+ * Extract Python import mappings
+ */
+function extractPythonImports(content) {
+    const mappings = [];
+    // from X import Y
+    const fromImportRegex = /from\s+([\w.]+)\s+import\s+([^#\n]+)/g;
+    let match;
+    while ((match = fromImportRegex.exec(content)) !== null) {
+        const [, source, imports] = match;
+        const names = imports.split(',').map((s) => s.trim());
+        for (const name of names) {
+            const aliasMatch = name.match(/(\w+)\s+as\s+(\w+)/);
+            if (aliasMatch) {
+                mappings.push({
+                    localName: aliasMatch[2],
+                    exportedName: aliasMatch[1],
+                    source: source,
+                    isDefault: false,
+                    isNamespace: false,
+                });
+            }
+            else if (name && name !== '*') {
+                mappings.push({
+                    localName: name,
+                    exportedName: name,
+                    source: source,
+                    isDefault: false,
+                    isNamespace: false,
+                });
+            }
+        }
+    }
+    // import X
+    const importRegex = /^import\s+([\w.]+)(?:\s+as\s+(\w+))?/gm;
+    while ((match = importRegex.exec(content)) !== null) {
+        const [, source, alias] = match;
+        const localName = alias || source.split('.').pop();
+        mappings.push({
+            localName,
+            exportedName: '*',
+            source: source,
+            isDefault: false,
+            isNamespace: true,
+        });
+    }
+    return mappings;
+}
+/**
+ * Extract Go import mappings
+ */
+function extractGoImports(content) {
+    const mappings = [];
+    // import "path" or import alias "path"
+    const singleImportRegex = /import\s+(?:(\w+)\s+)?["']([^"']+)["']/g;
+    let match;
+    while ((match = singleImportRegex.exec(content)) !== null) {
+        const [, alias, source] = match;
+        const packageName = source.split('/').pop();
+        mappings.push({
+            localName: alias || packageName,
+            exportedName: '*',
+            source: source,
+            isDefault: false,
+            isNamespace: true,
+        });
+    }
+    // import ( ... ) block
+    const blockImportRegex = /import\s*\(\s*([^)]+)\s*\)/gs;
+    while ((match = blockImportRegex.exec(content)) !== null) {
+        const block = match[1];
+        const lineRegex = /(?:(\w+)\s+)?["']([^"']+)["']/g;
+        let lineMatch;
+        while ((lineMatch = lineRegex.exec(block)) !== null) {
+            const [, alias, source] = lineMatch;
+            const packageName = source.split('/').pop();
+            mappings.push({
+                localName: alias || packageName,
+                exportedName: '*',
+                source: source,
+                isDefault: false,
+                isNamespace: true,
+            });
+        }
+    }
+    return mappings;
+}
+/**
+ * Extract Java / Kotlin import mappings.
+ *
+ * Java/Kotlin imports carry the full qualified name of the imported
+ * symbol — `import com.example.dao.converter.FooConverter;` — which is
+ * exactly the disambiguation signal we need when two packages both
+ * declare a `FooConverter`. Pre-#314 the resolver had no Java branch
+ * here at all, so this mapping was empty and cross-module name
+ * collisions were resolved by file-path proximity (often wrongly).
+ *
+ * `import static com.example.Foo.bar;` is parsed as a local-name `bar`
+ * pointing at FQN `com.example.Foo.bar` so static-method call sites
+ * (`bar(...)`) can resolve through the same import lookup.
+ */
+function extractJavaImports(content) {
+    const mappings = [];
+    // Strip line and block comments so `// import foo;` doesn't false-match.
+    const stripped = content
+        .replace(/\/\*[\s\S]*?\*\//g, '')
+        .replace(/\/\/[^\n]*/g, '');
+    // `import [static] <fqn>[.*];`
+    const re = /^\s*import\s+(static\s+)?([\w.]+(?:\.\*)?)\s*;/gm;
+    let match;
+    while ((match = re.exec(stripped)) !== null) {
+        const fqn = match[2];
+        // `import com.example.*;` — wildcard. We can't materialize a single
+        // local name; skip and let name-matching handle members reachable
+        // through the wildcard. (Future enhancement: enumerate package files.)
+        if (fqn.endsWith('.*'))
+            continue;
+        const parts = fqn.split('.');
+        const localName = parts[parts.length - 1];
+        if (!localName)
+            continue;
+        mappings.push({
+            localName,
+            exportedName: localName,
+            source: fqn,
+            isDefault: false,
+            isNamespace: false,
+        });
+    }
+    return mappings;
+}
+/**
+ * Extract PHP import mappings (use statements)
+ */
+function extractPHPImports(content) {
+    const mappings = [];
+    // use Namespace\Class; or use Namespace\Class as Alias;
+    const useRegex = /use\s+([\w\\]+)(?:\s+as\s+(\w+))?;/g;
+    let match;
+    while ((match = useRegex.exec(content)) !== null) {
+        const [, fullPath, alias] = match;
+        const className = fullPath.split('\\').pop();
+        mappings.push({
+            localName: alias || className,
+            exportedName: className,
+            source: fullPath,
+            isDefault: false,
+            isNamespace: false,
+        });
+    }
+    return mappings;
+}
+/**
+ * Extract C/C++ import mappings from #include directives.
+ *
+ * #include brings all symbols from the included header into scope
+ * (namespace import), so each mapping uses isNamespace: true and
+ * exportedName: '*'. The localName is set to the header's basename
+ * without extension so that symbol references like `MyClass` can
+ * match against any include that might provide it.
+ */
+function extractCppImports(content) {
+    const mappings = [];
+    // Match both #include <...> and #include "..."
+    const includeRegex = /^\s*#\s*include\s+[<"]([^>"]+)[>"]/gm;
+    let match;
+    while ((match = includeRegex.exec(content)) !== null) {
+        const modulePath = match[1];
+        // Basename without extension for localName matching
+        const basename = modulePath.split('/').pop().replace(/\.(h|hpp|hxx|hh|inl|ipp|cxx|cc|cpp)$/, '');
+        mappings.push({
+            localName: basename || modulePath,
+            exportedName: '*',
+            source: modulePath,
+            isDefault: false,
+            isNamespace: true,
+        });
+    }
+    return mappings;
+}
+// Cache import mappings per file to avoid re-reading and re-parsing
+const importMappingCache = new Map();
+/**
+ * Clear the import mapping cache (call between indexing runs)
+ */
+function clearImportMappingCache() {
+    importMappingCache.clear();
+    cppIncludeDirCache.clear();
+}
+/**
+ * Strip JS line + block comments from `content` while preserving
+ * string literals (so `"//"` inside a string stays intact). Used by
+ * {@link extractReExports} so commented-out export-from statements
+ * don't generate phantom re-export edges.
+ *
+ * Scanner is deliberately small: it only tracks the three contexts
+ * relevant for JS/TS — single-quote string, double-quote string, and
+ * template literal. Comment recognition is the JS spec subset, no
+ * regex-literal awareness (which is fine for our use case: we don't
+ * apply this to function bodies, only to top-level files).
+ */
+function stripJsComments(content) {
+    let out = '';
+    let i = 0;
+    let str = null;
+    while (i < content.length) {
+        const ch = content[i];
+        if (str !== null) {
+            out += ch;
+            if (ch === '\\' && i + 1 < content.length) {
+                out += content[i + 1];
+                i += 2;
+                continue;
+            }
+            if (ch === str)
+                str = null;
+            i++;
+            continue;
+        }
+        if (ch === '"' || ch === "'" || ch === '`') {
+            str = ch;
+            out += ch;
+            i++;
+            continue;
+        }
+        if (ch === '/' && content[i + 1] === '/') {
+            while (i < content.length && content[i] !== '\n')
+                i++;
+            continue;
+        }
+        if (ch === '/' && content[i + 1] === '*') {
+            i += 2;
+            while (i < content.length && !(content[i] === '*' && content[i + 1] === '/'))
+                i++;
+            i += 2;
+            continue;
+        }
+        out += ch;
+        i++;
+    }
+    return out;
+}
+/**
+ * Extract JS/TS re-export declarations from `content`.
+ *
+ * Recognised forms:
+ *   export { foo } from './a';
+ *   export { foo as bar } from './a';
+ *   export * from './a';
+ *   export * as ns from './a';   (treated as wildcard for chasing)
+ *   export { default as Foo } from './a';
+ *
+ * The walker intentionally stays regex-based — the import-resolver
+ * elsewhere in this file already chooses regex over a fresh
+ * tree-sitter pass, and this function shares that trade-off. Errors
+ * fall through silently; resolution simply skips the broken file.
+ */
+function extractReExports(content, language) {
+    if (language !== 'typescript' &&
+        language !== 'javascript' &&
+        language !== 'tsx' &&
+        language !== 'jsx') {
+        return [];
+    }
+    const out = [];
+    // Pre-strip block comments + line comments so a commented-out
+    // `// export { x } from '...'` doesn't produce a phantom edge.
+    // (Template literals are still a possible source of false positives;
+    // a project that builds export statements as runtime strings is
+    // out of scope.)
+    const cleaned = stripJsComments(content);
+    // Wildcard: `export * from '...'` or `export * as ns from '...'`
+    const wildcardRe = /export\s*\*(?:\s+as\s+\w+)?\s*from\s*['"]([^'"]+)['"]/g;
+    let m;
+    while ((m = wildcardRe.exec(cleaned)) !== null) {
+        out.push({ kind: 'wildcard', source: m[1] });
+    }
+    // Named: `export { a, b as c } from '...'`
+    const namedRe = /export\s*\{([^}]+)\}\s*from\s*['"]([^'"]+)['"]/g;
+    while ((m = namedRe.exec(cleaned)) !== null) {
+        const inner = m[1];
+        const source = m[2];
+        for (const raw of inner.split(',')) {
+            const item = raw.trim();
+            if (!item)
+                continue;
+            const aliasMatch = item.match(/^(\w+)\s+as\s+(\w+)$/);
+            if (aliasMatch) {
+                out.push({
+                    kind: 'named',
+                    exportedName: aliasMatch[2],
+                    originalName: aliasMatch[1],
+                    source,
+                });
+            }
+            else if (/^\w+$/.test(item)) {
+                out.push({
+                    kind: 'named',
+                    exportedName: item,
+                    originalName: item,
+                    source,
+                });
+            }
+        }
+    }
+    return out;
+}
+/**
+ * Resolve a reference using import mappings
+ */
+/**
+ * JVM (Java / Kotlin) imports use fully-qualified names (`import
+ * com.example.foo.Bar`) decoupled from filenames, so the JS/Python
+ * style filesystem path lookup misses them whenever the file isn't
+ * named after its primary symbol (Kotlin `Utils.kt` exporting `Bar`,
+ * top-level fns, extension fns). Resolve them through the
+ * `qualifiedName` index instead — populated by the package_header /
+ * package_declaration namespace wrappers in the extractor.
+ */
+function resolveJvmImport(ref, context) {
+    if (ref.referenceKind !== 'imports')
+        return null;
+    if (ref.language !== 'java' && ref.language !== 'kotlin')
+        return null;
+    const fqn = ref.referenceName;
+    const lastDot = fqn.lastIndexOf('.');
+    if (lastDot <= 0)
+        return null;
+    const pkg = fqn.substring(0, lastDot);
+    const sym = fqn.substring(lastDot + 1);
+    // Wildcard imports (`com.example.*`) deliberately punt to name-matcher.
+    if (sym === '*')
+        return null;
+    const candidates = context.getNodesByQualifiedName(`${pkg}::${sym}`);
+    if (candidates.length === 0)
+        return null;
+    return {
+        original: ref,
+        targetNodeId: candidates[0].id,
+        confidence: 0.95,
+        resolvedBy: 'import',
+    };
+}
+function resolveViaImport(ref, context) {
+    // C/C++ #include references — resolve directly to the included file
+    // (file→file edge), bypassing symbol lookup. The extractor emits these
+    // with `referenceKind: 'imports'` and `referenceName: <include path>`
+    // (e.g. "uint256.h" or "common/args.h"). Without this branch the
+    // include-dir scan path inside resolveImportPath never produces an
+    // edge — resolveViaImport's symbol lookup below would search the
+    // resolved file for a symbol named like the file extension and fail.
+    if ((ref.language === 'c' || ref.language === 'cpp') && ref.referenceKind === 'imports') {
+        const resolvedPath = resolveImportPath(ref.referenceName, ref.filePath, ref.language, context);
+        if (!resolvedPath)
+            return null;
+        const basename = resolvedPath.split('/').pop();
+        const fileNodes = context.getNodesByName(basename).filter((n) => n.kind === 'file');
+        const fileNode = fileNodes.find((n) => n.filePath === resolvedPath);
+        if (fileNode) {
+            return {
+                original: ref,
+                targetNodeId: fileNode.id,
+                confidence: 0.9,
+                resolvedBy: 'import',
+            };
+        }
+        return null;
+    }
+    // Use cached import mappings (avoids re-reading and re-parsing per ref)
+    const imports = context.getImportMappings(ref.filePath, ref.language);
+    if (imports.length === 0 && !context.readFile(ref.filePath)) {
+        return null;
+    }
+    // Go cross-package calls: `pkga.FuncX(...)` extracts to referenceName
+    // `pkga.FuncX` and the import `github.com/example/myproject/pkga`
+    // maps to a *package directory* containing one or more .go files.
+    // The generic file-based lookup below can't follow that — issue #388.
+    if (ref.language === 'go') {
+        const goResult = resolveGoCrossPackageReference(ref, imports, context);
+        if (goResult)
+            return goResult;
+    }
+    // Java / Kotlin: imports are FQNs (`import com.example.Foo;`) — no
+    // resolvable file path the JS/TS-style chain below could follow. Look
+    // up the symbol by name and filter to the candidate whose file path
+    // matches the imported FQN. This is the disambiguation signal that
+    // breaks the same-name class collision the path-proximity matcher
+    // can't resolve (issue #314).
+    if (ref.language === 'java' || ref.language === 'kotlin') {
+        const javaResult = resolveJavaImportedReference(ref, imports, context);
+        if (javaResult)
+            return javaResult;
+    }
+    // Check if the reference name matches any import
+    for (const imp of imports) {
+        if (imp.localName === ref.referenceName || ref.referenceName.startsWith(imp.localName + '.')) {
+            // Resolve the import path
+            const resolvedPath = resolveImportPath(imp.source, ref.filePath, ref.language, context);
+            if (resolvedPath) {
+                const exportedName = imp.isDefault ? 'default' : imp.exportedName;
+                const memberName = imp.isNamespace
+                    ? ref.referenceName.replace(imp.localName + '.', '')
+                    : null;
+                const targetNode = findExportedSymbol(resolvedPath, { isDefault: imp.isDefault, isNamespace: imp.isNamespace, exportedName, memberName }, ref.language, context, new Set());
+                if (targetNode) {
+                    return {
+                        original: ref,
+                        targetNodeId: targetNode.id,
+                        confidence: 0.9,
+                        resolvedBy: 'import',
+                    };
+                }
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Resolve a Java/Kotlin reference whose receiver is the simple name of
+ * an imported FQN: `Foo.bar(...)` where `import com.example.Foo;`. The
+ * imported FQN converts to a file-path suffix (`com/example/Foo.java`
+ * or `.kt`) which uniquely identifies the right symbol when multiple
+ * classes share the same simple name.
+ *
+ * Also handles bare references to the imported class itself
+ * (`new Foo()` extraction emits `Foo` as a `references`/`instantiates`
+ * ref) and `import static <Foo>.bar` style imports of a single member.
+ */
+function resolveJavaImportedReference(ref, imports, context) {
+    if (imports.length === 0)
+        return null;
+    const ext = ref.language === 'kotlin' ? '.kt' : '.java';
+    for (const imp of imports) {
+        const matchesBare = imp.localName === ref.referenceName;
+        const matchesQualified = ref.referenceName.startsWith(imp.localName + '.');
+        if (!matchesBare && !matchesQualified)
+            continue;
+        // Convert FQN to a file-path suffix. `com.example.Foo` ->
+        // `com/example/Foo.java` (or `.kt`). The actual file may live
+        // under any source root (`src/main/java/`, `src/`, etc.), so match
+        // by suffix rather than exact path.
+        const fqnPath = imp.source.replace(/\./g, '/') + ext;
+        // Which symbol name to look up: the class itself, or a member.
+        const memberName = matchesBare
+            ? imp.localName
+            : ref.referenceName.substring(imp.localName.length + 1);
+        const candidates = context.getNodesByName(memberName);
+        for (const node of candidates) {
+            if (node.language !== ref.language)
+                continue;
+            const fp = node.filePath.replace(/\\/g, '/');
+            if (fp.endsWith(fqnPath) || fp.endsWith('/' + fqnPath)) {
+                return {
+                    original: ref,
+                    targetNodeId: node.id,
+                    confidence: 0.9,
+                    resolvedBy: 'import',
+                };
+            }
+        }
+        // `import static com.example.Foo.bar;` — the FQN's tail is the
+        // member name, the part before is the owner class. Look up the
+        // member named `<imp.localName>` (e.g. `bar`) and prefer the
+        // candidate whose file matches the parent FQN's path.
+        if (matchesBare) {
+            const dot = imp.source.lastIndexOf('.');
+            if (dot > 0) {
+                const ownerFqn = imp.source.substring(0, dot);
+                const ownerPath = ownerFqn.replace(/\./g, '/') + ext;
+                for (const node of candidates) {
+                    if (node.language !== ref.language)
+                        continue;
+                    const fp = node.filePath.replace(/\\/g, '/');
+                    if (fp.endsWith(ownerPath) || fp.endsWith('/' + ownerPath)) {
+                        return {
+                            original: ref,
+                            targetNodeId: node.id,
+                            confidence: 0.9,
+                            resolvedBy: 'import',
+                        };
+                    }
+                }
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Resolve a Go cross-package qualified reference (`pkga.FuncX`) by matching
+ * the package alias against an in-module import, stripping the module prefix
+ * to a project-relative directory, and locating the exported symbol in any
+ * `.go` file under that directory. Returns `null` for stdlib / third-party
+ * imports (no `go.mod`-relative match) so the rest of `resolveViaImport`
+ * can still try the file-based path.
+ */
+function resolveGoCrossPackageReference(ref, imports, context) {
+    const mod = context.getGoModule?.();
+    if (!mod)
+        return null;
+    // Qualified call: receiver before `.`, member after. A bare reference
+    // (no dot) is a same-file/in-package call — handled elsewhere.
+    const dotIdx = ref.referenceName.indexOf('.');
+    if (dotIdx <= 0)
+        return null;
+    const receiver = ref.referenceName.substring(0, dotIdx);
+    const memberName = ref.referenceName.substring(dotIdx + 1);
+    if (!memberName)
+        return null;
+    for (const imp of imports) {
+        if (imp.localName !== receiver)
+            continue;
+        // Only in-module imports map to a known directory.
+        if (imp.source !== mod.modulePath && !imp.source.startsWith(mod.modulePath + '/')) {
+            continue;
+        }
+        const pkgDir = imp.source === mod.modulePath
+            ? ''
+            : imp.source.substring(mod.modulePath.length + 1);
+        // Look up the member by name and pick the candidate whose file lives
+        // directly in the package directory. Match the immediate parent dir
+        // exactly so a call to `pkga.FuncX` doesn't accidentally land on a
+        // `FuncX` declared in `pkga/subpkg/`.
+        const candidates = context.getNodesByName(memberName);
+        for (const node of candidates) {
+            if (node.language !== 'go')
+                continue;
+            if (!node.isExported)
+                continue;
+            const fp = node.filePath.replace(/\\/g, '/');
+            const lastSlash = fp.lastIndexOf('/');
+            const fileDir = lastSlash >= 0 ? fp.substring(0, lastSlash) : '';
+            if (fileDir === pkgDir) {
+                return {
+                    original: ref,
+                    targetNodeId: node.id,
+                    confidence: 0.9,
+                    resolvedBy: 'import',
+                };
+            }
+        }
+    }
+    return null;
+}
+/** Recursive depth cap for re-export chain following. Real codebases
+ *  rarely chain barrels more than 2–3 deep; 8 is a generous safety
+ *  net that still bounds worst-case work. */
+const REEXPORT_MAX_DEPTH = 8;
+/**
+ * Find an exported symbol in `filePath`, following `export { x } from
+ * './other'` and `export * from './other'` chains until the original
+ * declaration is reached. Cycle-safe via the `visited` set.
+ *
+ * Without this, every barrel-style import (`import { Foo } from
+ * './index'` where `index.ts` only re-exports) used to resolve to
+ * nothing — the existing code only looked for declarations IN the
+ * resolved file, not declarations the file forwarded.
+ */
+function findExportedSymbol(filePath, want, language, context, visited, depth = 0) {
+    if (depth > REEXPORT_MAX_DEPTH)
+        return undefined;
+    if (visited.has(filePath))
+        return undefined;
+    visited.add(filePath);
+    const nodesInFile = context.getNodesInFile(filePath);
+    // 1. Direct hit: the symbol is declared in this file.
+    if (want.isDefault) {
+        const direct = nodesInFile.find((n) => n.isExported && (n.kind === 'function' || n.kind === 'class'));
+        if (direct)
+            return direct;
+    }
+    else if (want.isNamespace && want.memberName) {
+        const direct = nodesInFile.find((n) => n.name === want.memberName && n.isExported);
+        if (direct)
+            return direct;
+    }
+    else {
+        const direct = nodesInFile.find((n) => n.name === want.exportedName && n.isExported);
+        if (direct)
+            return direct;
+    }
+    // 2. Re-export hit: the file forwards the symbol to another module.
+    const reExports = context.getReExports?.(filePath, language) ?? [];
+    if (reExports.length === 0)
+        return undefined;
+    // Look for explicit `export { want } from './other'` (with optional rename).
+    const targetName = want.isDefault ? 'default' : want.exportedName;
+    for (const rex of reExports) {
+        if (rex.kind === 'named' && rex.exportedName === targetName) {
+            const next = resolveImportPath(rex.source, filePath, language, context);
+            if (!next)
+                continue;
+            // After rename: `export { foo as bar } from './x'` — to chase
+            // `bar`, we look for `foo` in `./x`.
+            const chained = findExportedSymbol(next, {
+                isDefault: rex.originalName === 'default',
+                isNamespace: false,
+                exportedName: rex.originalName,
+                memberName: null,
+            }, language, context, visited, depth + 1);
+            if (chained)
+                return chained;
+        }
+    }
+    // 3. Wildcard re-export: `export * from './other'` — try every
+    //    forwarding source. This is the barrel-of-barrels case.
+    for (const rex of reExports) {
+        if (rex.kind === 'wildcard') {
+            const next = resolveImportPath(rex.source, filePath, language, context);
+            if (!next)
+                continue;
+            const chained = findExportedSymbol(next, want, language, context, visited, depth + 1);
+            if (chained)
+                return chained;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=import-resolver.js.map