Struct ObjectWorld 

pub struct ObjectWorld { /* private fields */ }

The scripting-side runtime container. Lives on the MMS worker thread.

Holds the lexical scope chain (a stack of frames) and the MMS-side heap. Communication with the engine goes through intent channels owned by the evaluator — ObjectWorld itself never sends intents directly.

See docs/meow_meow/spec/env-heap-object-world.md for the full design and docs/meow_meow/task/frame-stack-object-world.md for the migration plan.

Implementations

impl ObjectWorld

pub fn new() -> Self

New ObjectWorld with one root frame already pushed.

pub fn with_heap(heap: HeapHandle) -> Self

pub fn push_frame(&mut self, kind: FrameKind)

pub fn push_function_frame(&mut self, captured: Arc<HashMap<String, Value>>)

Push a function frame seeded with the closure’s captured environment. This is a hard barrier: lookups inside the function will not see past it.

pub fn pop_frame(&mut self)

pub fn frame_depth(&self) -> usize

pub fn request_reset(&mut self)

pub fn take_reset_requested(&mut self) -> bool

pub fn bind(&mut self, name: impl Into<String>, value: Value)

Bind a name in the top (innermost) frame. Shadows outer bindings.

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

Look up a name. Walks frames from innermost outward; stops at a Function barrier (function bodies cannot see the caller’s locals).

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

Whether name is reachable from the current scope (same walk as lookup).

pub fn reassign(&mut self, name: &str, value: Value) -> Result<(), String>

Reassign an existing binding. Walks frames inward-to-outward looking for the declaring frame; stops at a Function barrier.

Errors:

• name not declared anywhere reachable
• name declared only beyond the function barrier (caller’s locals)

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

Flatten all frames visible from the current point into a single map for closure capture. Walks innermost outward, including the first Function barrier’s frame (so a closure created inside a function sees that function’s captured snapshot), then stops. Inner names shadow outer.

pub fn heap(&self) -> &HeapHandle

pub fn alloc_object(&self, object: Object) -> ObjectId

Trait Implementations

impl Debug for ObjectWorld

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

Formats the value using the given formatter.

impl Default for ObjectWorld

fn default() -> Self

Returns the “default value” for a type.