Struct FileIndex 

pub struct FileIndex { /* private fields */ }

Index of all known repo-relative file paths for O(1) existence checks.

Wraps a HashSet<String> with helper methods that language resolvers commonly need. Linear-scan helpers (files_with_prefix, files_with_stem) are acceptable at Layer 0 scale — optimize if benchmarks show a hot spot.

Implementations

impl FileIndex

pub fn new(paths: impl IntoIterator<Item = String>) -> Self

Create a new FileIndex from an iterator of repo-relative paths.

pub fn new_with_root( root: PathBuf, paths: impl IntoIterator<Item = String>, ) -> Self

Create a FileIndex with a repo root for file content access.

pub fn set_crate_roots(&mut self, roots: Vec<String>)

Set Rust crate root prefixes for workspace resolution. Roots are sorted longest-first so workspace member paths take precedence over the repo-root src/.

pub fn crate_root_for(&self, file_path: &str) -> Option<&str>

Returns the crate root prefix for the given file, if any. For single-crate projects: Some("src/"). For workspace files at crates/foo/src/bar.rs: Some("crates/foo/src/").

pub fn set_workspace_members(&mut self, members: HashMap<String, String>)

Set workspace member mapping (snake_case crate name → crate root path).

pub fn workspace_member_root(&self, crate_name: &str) -> Option<&str>

Returns the crate root path for a workspace member crate name. The first segment of an import path (e.g. "grep_regex" in "grep_regex::matcher::Foo") is the name to look up.

pub fn has_workspace_members(&self) -> bool

True if workspace member mappings are configured.

pub fn set_scala_source_roots(&mut self, roots: Vec<String>)

Set Scala source root prefixes for multi-project sbt resolution.

pub fn scala_source_roots(&self) -> &[String]

Returns the discovered Scala source root prefixes.

pub fn set_ruby_autoload_roots(&mut self, roots: Vec<String>)

Set Ruby/Rails Zeitwerk autoload root directories.

pub fn ruby_autoload_roots(&self) -> &[String]

Returns the discovered Ruby autoload root directories.

pub fn set_ruby_lib_roots(&mut self, roots: Vec<String>)

Set Ruby lib/ root directories for monorepo require resolution.

pub fn ruby_lib_roots(&self) -> &[String]

Returns the discovered Ruby lib/ root directories.

pub fn read_file(&self, rel_path: &str) -> Option<String>

Read a file relative to the index root. Returns None if no root is configured or the file can’t be read. Resolvers that need content access (like Go for go.mod) must tolerate None gracefully.

pub fn contains(&self, path: &str) -> bool

Check if a repo-relative path exists in the index.

pub fn files_with_prefix(&self, prefix: &str) -> Vec<&String>

Find all files whose path starts with the given prefix. Returns references to avoid allocation when only checking existence.

pub fn files_with_stem(&self, stem: &str) -> Vec<&String>

Find all files whose stem (filename without extension) matches. Useful for Go package resolution where foo.go matches package foo.