Struct ScriptEngine 

pub struct ScriptEngine { /* private fields */ }

Script engine for executing VibeLang scripts.

The ScriptEngine:

1. Creates a Rhai engine with all VibeLang API registered
2. Executes scripts that call the API functions
3. Collects the resulting ScriptState

Example

let mut engine = ScriptEngine::new();
let state = engine.execute_file("song.vibe")?;
// Apply state to runtime via reload system

Implementations

impl ScriptEngine

pub fn new() -> Self

Create a new script engine with all VibeLang API registered.

pub fn add_import_path(&mut self, path: impl Into<PathBuf>)

Add import paths for module resolution (native only).

pub fn execute(&mut self, script: &str) -> Result<ScriptState>

Execute a script from a string.

Returns the collected ScriptState that can be applied to a runtime.

pub fn execute_file(&mut self, path: impl AsRef<Path>) -> Result<ScriptState>

Execute a script from a file (native only).

Returns the collected ScriptState that can be applied to a runtime.

pub fn execute_ast(&mut self, ast: &AST) -> Result<ScriptState>

Execute an AST (pre-compiled script).

pub fn compile(&self, script: &str) -> Result<AST>

Compile a script to AST for repeated execution.

pub fn compile_file(&self, path: impl AsRef<Path>) -> Result<AST>

Compile a script file to AST (native only).

pub fn engine(&self) -> &Engine

Get a reference to the underlying Rhai engine.

pub fn engine_mut(&mut self) -> &mut Engine

Get a mutable reference to the underlying Rhai engine.

Trait Implementations

impl Default for ScriptEngine

fn default() -> Self

Returns the “default value” for a type.