module

Noir::ImportGraph

Shared file-level import-graph traversal for cross-file route / DTO resolution.

Today the JVM-style flavour is implemented (Java, Kotlin): a file belongs to a package whose dotted path is reflected in its directory layout (src/main/java/com/foo/Bar.java ↔ package com.foo), and imports map to file paths under the inferred source root. This is the pattern called out as duplication in #1107 for TreeSitterJavaDtoIndex and TreeSitterKotlinDtoIndex.

Caveats / non-goals:

  • Python / Ruby / JS-style cross-file resolution doesn't share this exact source-root inference. When those frameworks migrate, expect a sibling helper (or a mode: parameter) on this module rather than forcing them through this code path.
  • The traversal is one level deep — we yield the directly visible files, not files reachable through their imports. Recursive resolution is the caller's job (and usually unnecessary; one level covers the controller-→-DTO case).

Constants

DIRECTORY_MAX_ENTRIES = 262144
IMPORT_RESOLUTION_MAX_ENTRIES = 262144
JS_RESOLVE_EXTENSIONS = ["ts", "tsx", "js", "jsx", "mjs", "cjs"]
JS_TO_TS_EXT = {".js" => [".ts", ".tsx"], ".jsx" => [".tsx"], ".mjs" => [".mts"], ".cjs" => [".cts"]}

TypeScript ESM (moduleResolution: NodeNext) imports a sibling .ts source through a .js-family specifier — import x from './a.js' where the file on disk is a.ts. Map each JS extension to the TS source extension(s) it can stand in for.

PACKAGE_SIBLINGS_MAX_ENTRIES = 32768

Class methods

related_files(path : String, package_name : String, imports : Indexable(ImportRef), extension : String, &block : String -> ) : Nil

Yields every file path that should be considered when resolving symbols visible to path:

  1. path itself.
  2. Same-directory siblings ending in .{extension} (same package).
  3. Files reachable through imports, resolved against a source root inferred from package_name.

Wildcard imports expand to every matching file in the imported directory. Each file is yielded at most once. When package_name is empty, the source-root step is skipped (no safe inference possible) — same-directory siblings are still yielded.

Source
resolve_relative_import(from_file : String, import_specifier : String, extensions : Array(String) = JS_RESOLVE_EXTENSIONS, boundary : String | Nil = nil) : String | Nil
Source
source_root_for(file_path : String, package_name : String) : String | Nil

Infer the source root by stripping the package path from the file's directory. src/main/java/com/foo/Bar.java with package com.foo returns src/main/java. Returns nil when the package path doesn't actually trail the file's directory (the source tree is laid out differently and we can't safely resolve imports).

Source

Nested types