Struct ModuleBindingRegistry 

pub struct ModuleBindingRegistry { /* private fields */ }

Single source of truth for all module binding values.

Used by:

• Interpreter: name-based lookup
• VM: index-based lookup (after compilation resolves names)
• JIT: stable pointers for inlined access

Implementations

impl ModuleBindingRegistry

pub fn new() -> Self

Create a new empty module binding registry

pub fn with_capacity(capacity: usize) -> Self

Create with pre-allocated capacity

pub fn register( &mut self, name: &str, value: ValueWord, is_const: bool, ) -> Result<u32>

Register or update a module binding, returns its stable index.

If the module binding already exists:

• If it’s const and we’re re-registering with same constness, update value
• If it’s const and we’re trying to make it mutable, error
• If it’s mutable, always update

Arguments

• name - The module binding’s name
• value - The value to store (converted to ValueWord internally)
• is_const - Whether this module binding is constant (functions, imports)

Returns

The stable index for this module binding

pub fn register_nb( &mut self, name: &str, value: ValueWord, is_const: bool, ) -> Result<u32>

Register or update a module binding with a ValueWord value, returns its stable index.

pub fn register_const(&mut self, name: &str, value: ValueWord) -> Result<u32>

Register a constant module binding (convenience method)

pub fn register_mut(&mut self, name: &str, value: ValueWord) -> Result<u32>

Register a mutable module binding (convenience method)

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

Check if a module binding exists

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

Resolve name to index (compile-time)

pub fn get_name(&self, idx: u32) -> Option<&str>

Get name for an index (for error messages)

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

Get by name as owned ValueWord (interpreter, dynamic lookup)

pub fn get_by_index(&self, idx: u32) -> Option<&ValueWord>

Get by index as ValueWord reference (O(1))

pub fn set_by_index(&mut self, idx: u32, value: ValueWord) -> Result<()>

Set by index from ValueWord (for VM assignment)

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

Check if a module binding is const

pub fn is_const_by_index(&self, idx: u32) -> Option<bool>

Check if a module binding at index is const

pub fn len(&self) -> usize

Get the number of registered module bindings

pub fn is_empty(&self) -> bool

Check if the registry is empty

pub fn names(&self) -> impl Iterator<Item = &str>

Get all module binding names (for debugging/introspection)

pub fn get_ptr(&self, idx: u32) -> Option<*const ValueWord>

Get stable pointer for JIT (address won’t change after registration)

Safety

The pointer is valid as long as no new module bindings are registered. For JIT, call this after all module bindings are registered.

pub fn snapshot_constants(&self) -> Vec<(u32, ValueWord)>

Snapshot constant module bindings for JIT constant folding

pub fn clear(&mut self)

Clear all module bindings (for testing or reset)

Trait Implementations

impl Debug for ModuleBindingRegistry

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

Formats the value using the given formatter.

impl Default for ModuleBindingRegistry

fn default() -> Self

Returns the “default value” for a type.