Struct WasmCompletionSource 

pub struct WasmCompletionSource { /* private fields */ }

An async completion producer over a plugin’s CompletionClient. Cheap to clone (the client is an mpsc Sender clone + cached id/doc); every clone talks to the same actor.

Implementations

impl WasmCompletionSource

pub async fn connect(client: CompletionClient) -> Result<Self, PluginHostError>

Fetch the plugin’s spec through the bridge and build the adapter. Async because the one-time spec fetch is a guest call; a dead actor is a typed error, so a bad plugin fails registration loudly.

pub fn id(&self) -> &str

The completion source’s id (the insert_generator name).

pub fn doc(&self) -> &str

The completion source’s doc string.

pub fn accepts_non_word_query(&self) -> bool

OR.7: whether this source keeps matching once the query picks up a non-word character (a phrase source — org-roam’s node titles).

pub fn plugin_id(&self) -> PluginId

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

pub async fn generate( &self, ctx: &InsertContextSnapshot, ) -> Result<Vec<RawCandidate>, String>

Produce raw candidates for prefix — the async generator. The result is native RawCandidates the host feeds through match_and_rank (matching/ranking/annotation stay native). The outer host error (trap / plugin-gone) and the inner guest WIT err both collapse to the String the completion machinery logs; a candidate that fails to cross (malformed record) fails the whole batch as a typed error, never a silent drop.

Trait Implementations

impl AsyncCompletionSource for WasmCompletionSource

PH7.6 → PL8.B: the adapter that lets a WASM completion source ride a mode’s completion_sources() like any native async source (LSP’s precedent). The aggregator drives produce_async at popup-open / isIncomplete refresh; the async generate runs on the source’s actor (spawned by the loader on the multi-thread runtime), never the keystroke path — matching / ranking / annotation stay native (the host runs match_and_rank over the pushed candidates), so paramount #1 holds.

fn produce_async( &self, ctx: InsertContextSnapshot, sink: Arc<dyn CandidateSink>, token: CancellationToken, ) -> Pin<Box<dyn Future<Output = ()> + Send>>

Build the producer future. The future:

impl Clone for WasmCompletionSource

fn clone(&self) -> WasmCompletionSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WasmCompletionSource

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

Formats the value using the given formatter.