Enum HostCallKind 

pub enum HostCallKind {
    Spawn(MaterializedCE),
    Register(MaterializedCE),
    Attach {
        parent: Option<ComponentId>,
        child: ComponentId,
    },
    RegisterHandler {
        scope: ComponentId,
        signal_kind: SignalKind,
        name: Option<String>,
        handler: Value,
    },
    Query {
        selector: String,
        scope: Option<ComponentId>,
        multiple: bool,
    },
    ReplTree {
        value: Value,
        max_depth: Option<usize>,
    },
    ReplDump {
        value: Value,
    },
    ReplHelp,
    ReplClear,
    AudioClipInstance {
        source: ComponentId,
        start_beat: Option<f64>,
        stop_beat: Option<f64>,
    },
    InvokeComponentMethod {
        id: ComponentId,
        component_type: String,
        method: String,
        args: Vec<Value>,
    },
}

Operations the evaluator can request from the host.

Variants

Spawn(MaterializedCE)

Spawn a component tree and return its root ComponentId. Used for fire-and-forget root emissions (currently unused by the evaluator — top-level CEs are still pushed as IntentValue for now).

Register(MaterializedCE)

Create the component tree in the world but do not attach it to a parent and do not run init. Returns the root ComponentId. The caller (typically let x = CE) holds the id as a ComponentObject and decides where/when to splice the subtree in.

Attach

Attach a previously Registered (or Spawned) detached subtree to a parent and run the deferred init walk. With parent: None the subtree is initialised in place as a world root.

Fields

parent: Option<ComponentId>

child: ComponentId

RegisterHandler

Register an MMS function as a scoped signal handler. The host installs the closure and replies with HostValue::Null.

Fields

scope: ComponentId

signal_kind: SignalKind

name: Option<String>

handler: Value

Query

Query the live ECS world. scope = None means search from the world’s canonical roots; scope = Some(id) restricts the search to the subtree rooted at id. multiple selects between query_all (true, returns ComponentList) and query (false, returns the first match as Component or Null if none).

Fields

selector: String

scope: Option<ComponentId>

multiple: bool

ReplTree

Fields

value: Value

max_depth: Option<usize>

ReplDump

Fields

value: Value

ReplHelp

ReplClear

AudioClipInstance

Create a new AudioClipComponent that shares source’s decoded asset but gets its own playhead (RT instance). Returns the new component’s id, detached — mirrors Register semantics so the caller can splice it via the usual CE-body bare-reference path. See docs/draft/audio-clip-instance-cloning.md §3.

Fields

source: ComponentId

start_beat: Option<f64>

stop_beat: Option<f64>

InvokeComponentMethod

Fields

id: ComponentId

component_type: String

method: String

args: Vec<Value>

Trait Implementations

impl Clone for HostCallKind

fn clone(&self) -> HostCallKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HostCallKind

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

Formats the value using the given formatter.