types: add Globals / MutableGlobals aliases

[dmadisetti]

📝 Summary

Replaces dict[str, Any] in the executor pipeline with MutableGlobals (alias), and Globals (Mapping[str, Any]).

Layering on top to prevent rebase churn

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
marimo-docs	Ready	Preview, Comment	May 21, 2026 12:03am

[cubic-dev-ai]

No issues found across 6 files

Architecture diagram

sequenceDiagram
    participant Runner as Runner (by_kwargs)
    participant Evaluator as Evaluator
    participant Executor as DefaultExecutor
    participant Lifecycle as StrictLifecycle
    participant Globals as Globals Dict

    Note over Runner,Globals: Core Execution Pipeline
    
    Runner->>Runner: _new_evaluator()
    Runner->>Globals: NEW: Create MutableGlobals (dict[str, Any])
    
    loop For each ancestor cell in topological order
        Runner->>Evaluator: evaluate(cell, glbls: MutableGlobals)
        Evaluator->>Lifecycle: setup(cell, glbls: MutableGlobals)
        Lifecycle->>Lifecycle: Backup transitive refs
        Lifecycle-->>Evaluator: Skip | None
        
        alt Skip returned
            Evaluator->>Evaluator: Skip execution
        else Execute cell
            Evaluator->>Executor: execute_cell(cell, glbls: MutableGlobals)
            Executor->>Globals: exec(cell.body) with glbls
            Globals-->>Executor: Updated glbls
            Executor-->>Evaluator: Return value
        end
        
        Evaluator->>Lifecycle: teardown(cell, glbls: MutableGlobals, run_result)
        Lifecycle->>Globals: Restore backed-up refs
        Lifecycle-->>Evaluator: None
        Evaluator-->>Runner: RunResult
        
        Runner->>Runner: CHANGED: _returns(cell_impl, glbls: Globals)
        Note over Runner: Read-only view for collecting cell defs
    end
    
    Runner->>Runner: _substitute_refs(cell_impl, glbls: MutableGlobals, kwargs)
    Note over Runner: Mutate glbls with kwargs
    
    Runner-->>Runner: Return (result, glbls: MutableGlobals)

Loading

_{Re-trigger cubic}