Struct WasmPickerSource 

pub struct WasmPickerSource { /* private fields */ }

An Arc<dyn PickerSourceGenerator>-ready adapter over ONE of a picker plugin’s registered sources.

Cheap to clone (the client is an mpsc Sender clone + a cached spec); every clone talks to the same actor. N adapters share one actor and one guest instance since OR.5b — each carries the source id it was registered under and passes it on every init / accept, which is how one component serves several pickers.

Implementations

impl WasmPickerSource

pub async fn connect_all( client: PickerClient, ) -> Result<Vec<Self>, PluginHostError>

Drive the plugin’s register-picker-sources export and wrap each source it declared.

Async because registration is a guest call. A dead actor or a trapping registration is a typed error, so a bad plugin fails loudly rather than registering a broken source. An empty list is NOT an error — a plugin that declares nothing registers nothing, which is what it asked for.

pub fn plugin_id(&self) -> PluginId

The host-issued id of the plugin behind this source.

Trait Implementations

impl PickerSourceGenerator for WasmPickerSource

fn owner_plugin(&self) -> Option<u64>

PH.1: the plugin behind this source, so <C-h> can find the page the plugin registered as <plugin>.picker-<id> — and only that plugin’s. Same u64 widening the loader applies to HelpTopic::plugin_id.

fn spec(&self) -> &PickerSourceSpec

Generator metadata. Returned by reference so the registry can stamp it into :describe-picker / :picker <Tab> listings without cloning.

fn init( &self, ctx: &PickerContext<'_>, args: &[String], ) -> SourceResult<PickerInitResult>

Build the candidate set. Sync prelude: read what’s needed from ctx, clone into async captures if necessary, return the appropriate PickerInitResult variant. Synchronous errors (no active buffer when one was required, args validation failure) return Err; the host echoes the error and leaves the picker closed.

fn accept( &self, _ctx: &PickerContext<'_>, _routing: &RoutingPayload, ) -> SourceResult<PickerAcceptOutcome>

Translate the user’s chosen routing payload into a typed PickerAcceptOutcome the host applies. The generator owns the mapping from its emitted routing-payload variant(s) to outcome(s); mismatch returns Err, which the host echoes.

fn accept_async( &self, ctx: &PickerContext<'_>, routing: &RoutingPayload, ) -> Option<AcceptFuture>

Async-accept hook. Default None means “this source resolves accept synchronously” — every native source takes this path and is unchanged.

fn on_query_changed( &self, _ctx: &PickerContext<'_>, _query: &str, ) -> Option<Result<PickerInitResult, String>>

Live-source hook: re-fetch candidates when the user’s query changes. Default None means “static source – host uses fuzzy refilter over the candidate set returned by init”. Returning Some(result) from a source whose spec().live == true replaces the picker’s candidate set wholesale; the host wires up debouncing and cancels any in-flight invocation when a fresh query arrives.

fn descend( &self, _ctx: &PickerContext<'_>, _candidate: &RawCandidate, ) -> Option<String>

PC.10: <C-l> — refine the query from the selected candidate instead of accepting it.

fn ascend(&self, _query: &str) -> Option<String>

PC.10: <C-w> (<C-h> until PH.1) — descend’s peer, one level out.

fn accept_navigates( &self, _ctx: &PickerContext<'_>, _candidate: &RawCandidate, ) -> Option<String>

PP.3: <CR> on a row that is a SIGNPOST rather than a destination.

fn initial_query(&self, _args: &[String]) -> Option<String>

PP.1: the query the picker opens WITH.

fn preview( &self, _ctx: &PickerContext<'_>, _routing: &RoutingPayload, ) -> Option<PickerPreviewOutcome>

T.12: live-preview hook — invoked as the picker SELECTION moves to a candidate (before accept). Default None = no preview. A source returns an outcome the host applies immediately for a live preview; the host restores prior state on .

fn preview_debounce(&self) -> Option<Duration>

MG.54: how long the selection must sit still before the host calls preview. None (the default) = call it inline on every selection move, which is right for a source whose preview is a cheap projection of data it already holds.