Struct SemanticQueryExpander 

pub struct SemanticQueryExpander {
    pub registry: Vec<TermEntry>,
    pub max_expansions: usize,
    pub total_expansions: u64,
    pub total_variants_generated: u64,
}

Expands semantic search queries using a registry of term relations.

The expander maintains a list of TermEntry records that encode relations (synonym, hypernym, hyponym, antonym) between pairs of terms. Given a raw query string and an ExpansionStrategy, SemanticQueryExpander::expand produces an ExpandedQuery with up to max_expansions variants.

Fields

registry: Vec<TermEntry>

All known term-relation entries.

max_expansions: usize

Maximum number of expansion variants returned per call (default 5).

total_expansions: u64

Cumulative count of successful expand() calls.

total_variants_generated: u64

Cumulative count of expansion variants generated (not counting the original).

Implementations

impl SemanticQueryExpander

pub fn new(max_expansions: usize) -> Self

Create a new expander with an empty registry.

Arguments

• max_expansions – maximum number of variant strings returned by each SemanticQueryExpander::expand call. Must be ≥ 1; a value of 0 means no variants are ever produced.

pub fn register_term(&mut self, entry: TermEntry)

Append a new TermEntry to the registry.

pub fn expand( &mut self, query: &str, strategy: ExpansionStrategy, ) -> ExpandedQuery

Expand query according to strategy, returning an ExpandedQuery.

Internally, the method:

1. Looks up matching entries in the registry (case-insensitive term match).
2. Formats candidate strings according to the strategy.
3. Sorts candidates by weight (descending), then deduplicates.
4. Caps the result at SemanticQueryExpander::max_expansions.
5. Updates cumulative statistics.

pub fn stats(&self) -> ExpanderStats

Return a snapshot of the current runtime statistics.