Struct SearchContext 

pub struct SearchContext { /* private fields */ }

SearchContext - manages search state for a Lua runtime instance.

Each Lua runtime has its own SearchContext with independent SceneTable and WordTable state. This ensures thread safety and isolation between runtime instances.

Implementations

impl SearchContext

pub fn new( scene_registry: SceneRegistry, word_registry: WordDefRegistry, ) -> Result<Self, SearchError>

Create a new SearchContext from registries.

Converts SceneRegistry and WordDefRegistry into runtime tables with default random selectors.

pub fn search_scene( &mut self, name: &str, global_scene_name: Option<&str>, ) -> Result<Option<(String, String)>, SearchError>

Search for a scene with fallback strategy (local → global).

Arguments

• name - Search prefix
• global_scene_name - Parent scene name (None for global only)

Returns

• Ok(Some((global_name, local_name))) - Scene found
• Ok(None) - No scene found
• Err(e) - Internal error

Note

The returned names match the transpiler output format:

• global_name: e.g., “メイン1” (from fn_name before “::”)
• local_name: e.g., “選択肢_1” or “start” (Lua function name format)

pub fn search_word( &mut self, name: &str, global_scene_name: Option<&str>, ) -> Result<Option<String>, SearchError>

Search for a word with fallback strategy (local → global).

Arguments

• name - Search key
• global_scene_name - Parent scene name (None for global only)

Returns

• Ok(Some(word)) - Word found
• Ok(None) - No word found
• Err(e) - Internal error

pub fn set_scene_selector( &mut self, sequence: Option<Vec<usize>>, ) -> Result<(), SearchError>

Set scene selector for deterministic testing.

Arguments

• sequence - None to reset to default, Some(vec) for mock selector

pub fn set_word_selector( &mut self, sequence: Option<Vec<usize>>, ) -> Result<(), SearchError>

Set word selector for deterministic testing.

Arguments

• sequence - None to reset to default, Some(vec) for mock selector

Trait Implementations

impl UserData for SearchContext

fn add_methods<M: UserDataMethods<Self>>(methods: &mut M)

Adds custom methods and operators specific to this userdata.

fn add_fields<F>(fields: &mut F)

where F: UserDataFields<Self>,

Adds custom fields specific to this userdata.

fn register(registry: &mut UserDataRegistry<Self>)

Registers this type for use in Lua.