Struct ModuleCache 

pub struct ModuleCache { /* private fields */ }

Module cache for tracking and resolving imports

Implementations

impl ModuleCache

pub fn new() -> Self

Create a new module cache

pub fn resolve_import( &self, import_path: &str, current_file: &Path, workspace_root: Option<&Path>, ) -> Option<PathBuf>

Resolve an import path to an absolute file path using runtime module resolution.

pub fn load_module(&self, path: &Path) -> Option<ModuleInfo>

Load a module from a file path

If the module is already cached, returns the cached version. Otherwise, reads and parses the file, extracts exports, and caches it.

pub fn load_module_with_context( &self, path: &Path, current_file: &Path, workspace_root: Option<&Path>, ) -> Option<ModuleInfo>

Context-aware module load using the same module-loader setup as import resolution.

pub fn load_module_by_import_with_context_and_source( &self, import_path: &str, current_file: &Path, workspace_root: Option<&Path>, current_source: Option<&str>, ) -> Option<ModuleInfo>

Load a module by import path using unified module-loader context.

This supports both filesystem modules and in-memory extension artifacts.

pub fn get_module(&self, path: &Path) -> Option<ModuleInfo>

Get a cached module (without loading if not present)

pub fn invalidate(&self, path: &Path)

Invalidate a module in the cache (when file changes)

pub fn clear(&self)

Clear the entire cache

pub fn list_importable_modules_with_context( &self, current_file: &Path, workspace_root: Option<&Path>, ) -> Vec<String>

List importable module paths for the current workspace context.

Includes:

• std.* modules from stdlib
• project module search paths from shape.toml ([modules].paths)
• path dependencies from shape.toml ([dependencies])

pub fn list_importable_modules_with_context_and_source( &self, current_file: &Path, workspace_root: Option<&Path>, current_source: Option<&str>, ) -> Vec<String>

List importable module paths with optional current source for frontmatter-aware context.

pub fn list_importable_modules(&self) -> Vec<String>

List importable module paths using the process CWD as context.

pub fn list_stdlib_modules(&self) -> Vec<String>

List all stdlib module import paths (e.g., std::core::math).

pub fn list_stdlib_children(&self, prefix: &str) -> Vec<ModuleChild>

Return direct children under a stdlib prefix for hierarchical completion.

For example, with prefix std::core it can return entries like:

• math (leaf, no children)
• indicators (non-leaf)

pub fn list_module_children_with_context( &self, prefix: &str, current_file: &Path, workspace_root: Option<&Path>, ) -> Vec<ModuleChild>

Return direct children under an import prefix for hierarchical completion.

pub fn list_module_children(&self, prefix: &str) -> Vec<ModuleChild>

Return direct children under an import prefix using process CWD as context.

pub fn find_exported_symbol_with_context( &self, name: &str, current_file: &Path, workspace_root: Option<&Path>, ) -> Vec<(String, ExportedSymbol)>

Find all modules that export a symbol with the given name. Scans importable modules and returns (import_path, ExportedSymbol) pairs.

pub fn find_exported_symbol(&self, name: &str) -> Vec<(String, ExportedSymbol)>

Scans importable modules using process CWD as context.

Trait Implementations

impl Debug for ModuleCache

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ModuleCache

fn default() -> ModuleCache

Returns the “default value” for a type.