# perl-module-resolution
Module-name resolution for workspace-aware Perl tooling.
Use this crate when you need to turn `Foo::Bar` into a filesystem path or
`file://` URI while respecting workspace roots, open documents, and include
paths.
## Where it fits
This crate sits above the low-level path and URI helpers and below editor
providers. It combines the `perl-module-resolution-path` and
`perl-module-resolution-uri` layers so callers can resolve modules without
re-implementing workspace lookup rules.
## Key entry points
- `resolve_module_path(root, module_name, include_paths)` - filesystem lookup
- `resolve_module_uri(...)` - workspace-aware URI resolution
- `ModuleUriResolution` - result type for URI lookups
- `use_lib` - helpers for `use lib` and `FindBin` include-path discovery
## Typical use
Use `perl-module-resolution` when you already know the module name and need to
find the right file or URI for navigation, completion, or hover features. If
you only need path safety or URI normalization, use the lower-level crates
directly.