Struct WasmMediaSource 

pub struct WasmMediaSource { /* private fields */ }

An async media-block producer over a plugin’s MediaClient.

Implementations

impl WasmMediaSource

pub fn new(client: MediaClient) -> Self

pub fn plugin_id(&self) -> PluginId

pub async fn media_blocks( &self, buffer_id: u64, path: Option<&Path>, line_count: u32, text: String, ) -> Result<Vec<MediaBlockRequest>, String>

Produce a buffer’s media blocks — the async producer the host calls OFF the render path.

Graceful: the outer host error (trap / plugin-gone) and the inner guest WIT err both collapse to the String the caller logs, and on an Err the caller keeps the buffer’s PRIOR blocks rather than clearing them. A transient failure mid-edit must not make every image in the document blink out.

A block naming a path that does not resolve is DROPPED here with a warning rather than failing the batch — one broken link in an org file should not cost the reader every other image on the page.

Trait Implementations

impl AsyncMediaSource for WasmMediaSource

fn source_id(&self) -> u64

Stable id of the producing plugin — the teardown key. Two producers with the same id are the same plugin, so a reload replaces rather than duplicates.

fn produce( &self, buffer_id: u64, path: Option<PathBuf>, line_count: u32, text: String, ) -> MediaFuture<'_>

Produce this buffer’s media blocks off the render path. text is the buffer’s contents. Passed by value rather than through a document handle because a media scan reads EVERY line: a handle would cost one boundary crossing per line, where one copy costs one. The copy is affordable because this runs on open / edit, not per frame.

impl Clone for WasmMediaSource

fn clone(&self) -> WasmMediaSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WasmMediaSource

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

Formats the value using the given formatter.