Struct MicroscopeMatcher 

pub struct MicroscopeMatcher { /* private fields */ }

Streaming fuzzy matcher using Nucleo

Provides non-blocking fuzzy matching with progressive results. Items are injected via Injector and results are retrieved via snapshot().

Example

let matcher = MicroscopeMatcher::new();

// Get injector for background task
let injector = matcher.injector();
tokio::spawn(async move {
    for item in items {
        injector.push(MatcherItem::new(item), |mi, cols| {
            cols[0] = mi.match_text.clone();
        });
    }
});

// In render loop
matcher.tick(10); // Process for max 10ms
let results = matcher.get_matched_items(100); // Get top 100 results

Implementations

impl MicroscopeMatcher

pub fn new() -> Self

Create a new streaming matcher

Uses smart case matching and Unicode normalization. Spawns worker threads for parallel matching.

pub fn injector(&self) -> Injector<MatcherItem>

Get an injector for pushing items from background tasks

The injector is thread-safe and can be cloned and sent to other threads.

pub fn set_pattern(&mut self, query: &str)

Update the search pattern

This triggers re-matching of all items against the new pattern.

pub fn tick(&mut self, timeout_ms: u64) -> MatcherStatus

Process pending matches (non-blocking)

Call this regularly (e.g., in render loop) to process matches. Returns status indicating if more processing is needed.

Arguments

• timeout_ms - Maximum time to spend processing (in milliseconds)

pub fn get_matched_items(&self, max_items: usize) -> Vec<MicroscopeItem>

Get matched items from the current snapshot

Returns items sorted by match score (best matches first). This is instant and does not block.

Note: The items are pre-sorted by nucleo, so the order reflects the ranking. Individual scores are not exposed by nucleo’s streaming API, so we use the item index as a rough score proxy (lower = better match).

Arguments

• max_items - Maximum number of items to return

pub fn total_count(&self) -> u32

Get total number of items in the matcher

pub fn matched_count(&self) -> u32

Get number of items matching the current pattern

pub fn is_pattern_empty(&self) -> bool

Check if pattern is empty (all items match)

pub fn restart(&mut self)

Restart the matcher (clear all items)

Call this when switching pickers or starting a new search.

pub fn restart_with_clear(&mut self)

Restart and also clear the pattern

Trait Implementations

impl Default for MicroscopeMatcher

fn default() -> Self

Returns the “default value” for a type.