Struct ImportRegistry 

pub struct ImportRegistry {
    pub config_imports: HashMap<String, String>,
    /* private fields */
}

Unified import registry. Built during IR lowering, used throughout expansion.

All insertions are idempotent — duplicates are impossible by design. The registry has three sections:

1. Source imports — pre-populated from the user’s AST during lowering. Read-only after creation.
2. Config imports — from macroforge.config.ts import statements. Name → module.
3. Generated imports — accumulated during macro expansion via request_* methods.

Fields

config_imports: HashMap<String, String>

Config file imports (macroforge.config.ts import statements). Name → module.

Implementations

impl ImportRegistry

pub fn new() -> Self

Create an empty registry.

pub fn from_module(module: &Module, source: &str) -> Self

Build from AST — extracts all import declarations from the module. Called during IR lowering in prepare_expansion_context.

pub fn is_available(&self, name: &str) -> bool

Check if an identifier is available (in source OR already generated).

pub fn is_type_only(&self, name: &str) -> bool

Check if a source import is type-only. Returns false if the import is not found.

pub fn get_source(&self, name: &str) -> Option<&str>

Get import module for a source import.

pub fn resolve_alias(&self, name: &str) -> Option<&str>

Resolve alias to original name. For import { Option as EffectOption }, resolve_alias("EffectOption") → Some("Option").

pub fn source_map(&self) -> &HashMap<String, SourceImport>

Get all source imports as a reference to the internal HashMap.

pub fn source_modules(&self) -> HashMap<String, String>

Get source imports as a flat name→module HashMap (for backward-compat callers).

pub fn aliases(&self) -> HashMap<String, String>

Get import aliases as a flat local→original HashMap (for backward-compat callers).

pub fn source_import_entries(&self) -> Vec<SourceImportEntry>

Export source imports as serializable entries for cross-process transfer.

pub fn install_source_imports(&mut self, entries: Vec<SourceImportEntry>)

Install source imports from serializable entries (for external macro processes).

pub fn type_only_map(&self) -> HashMap<String, bool>

Get type-only tracking as a flat name→bool HashMap (for backward-compat callers).

pub fn request_import( &mut self, local_name: &str, original_name: Option<&str>, module: &str, is_type_only: bool, )

General-purpose import request. Idempotent — skips if local_name already exists in source or generated imports.

This is the method TsStream import helpers delegate to.

pub fn request_namespace_import( &mut self, namespace: &str, module: &str, alias: &str, )

Request a namespace import (e.g., import { DateTime as __mf_DateTime } from "effect").

No-op if namespace is already a value import in source. No-op if alias is already in generated.

pub fn request_type_import(&mut self, name: &str, module: &str)

Request a type-only import (e.g., import type { Utc } from "effect/DateTime").

No-op if name is already in source or generated. Rejects dotted names (logs warning, returns early).

pub fn generated_imports(&self) -> impl Iterator<Item = &GeneratedImport>

Get an iterator over generated imports.

pub fn take_generated_imports(&mut self) -> Vec<GeneratedImport>

Take a snapshot of generated imports and clear them from the registry. Used by TsStream::into_result() to capture imports into MacroResult so they survive serialization across process boundaries.

pub fn merge_imports(&mut self, imports: Vec<GeneratedImport>)

Merge a list of generated imports back into the registry. Used to restore imports from a MacroResult (e.g., from an external macro).

pub fn emit_generated_imports(&self) -> String

Format all generated imports as TypeScript import lines.

Trait Implementations

impl Clone for ImportRegistry

fn clone(&self) -> ImportRegistry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ImportRegistry

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

Formats the value using the given formatter.

impl Default for ImportRegistry

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ImportRegistry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ImportRegistry

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.