GitCorner

Code

ossartcraftvectorcraft🌐
2bc41aeb8602
//! The system clipboard's formats: Copy and Cut publish every flavour the engine makes
//! ([`Session::clipboard_flavours`](vectorcraft_engine::Session::clipboard_flavours): text, SVG,
//! PDF, PNG), and a Paste first turns what another app copied (SVG, PDF, EPS, an EMF, text, a bitmap,
//! or a copied file that is one of them) into the internal clipboard with the `clipboard.import*`
//! commands. The host installs the platform side as
//! [`Services::system_clipboard`](crate::Services::system_clipboard); without it (the web) Copy
//! publishes SVG text through egui and Paste takes SVG text, and the pictures and files the host
//! reads from a paste itself ([`VectorcraftApp::paste_from_host`]).

use std::sync::Arc;
use std::sync::atomic::{AtomicU64, Ordering};
use std::sync::mpsc::channel;

use serde_json::{Value, json};
use vectorcraft_engine::cmd::clipboard::{AI, BITMAP, EMF, EPS, Flavour, ImageRead, PASTE_ORDER, PDF, SVG, TEXT, looks_like_svg, names_a_picture};

use crate::VectorcraftApp;
use crate::background::{self, Writer};

/// The platform clipboard, with every format it carries.
pub trait SystemClipboard {
    /// Replace the clipboard's contents with `flavours` (best first; none empties it).
    fn write(&mut self, flavours: &[Flavour]) -> Result<(), String>;
    /// Does the clipboard still hold what [`Self::write`] last put there (nothing copied since)?
    fn holds_ours(&mut self) -> bool;
    /// The first of `mimes` the clipboard holds; `image/*` is any bitmap (returned as PNG, BMP…).
    fn read(&mut self, mimes: &[&'static str]) -> Option<Flavour>;
    /// Does the clipboard hold one of `mimes`? Cheap enough to ask a few times a second.
    fn has(&mut self, mimes: &[&'static str]) -> bool;
    /// [`Self::read`], except that a bitmap the host converts to PNG (Windows' device-independent
    /// bitmap, the image Linux gives) comes back as the work that converts it
    /// ([`ClipboardRead::Later`]), for a paste that runs it off the UI thread. By default every
    /// flavour is read at once.
    fn read_deferred(&mut self, mimes: &[&'static str]) -> Option<ClipboardRead> {
        self.read(mimes).map(ClipboardRead::Now)
    }
    /// A number that changes each time any app copies something, read without opening the
    /// clipboard; `None` where the platform has none (the default).
    fn change_count(&mut self) -> Option<u64> {
        None
    }
}

/// What the system clipboard held when the formats of a Copy or Cut could not be written.
#[derive(PartialEq)]
enum Held {
    /// Its [`SystemClipboard::change_count`].
    Count(u64),
    /// Its text, where the platform has no change count.
    Text(Option<Vec<u8>>),
}

impl Held {
    fn now(cb: &mut (dyn SystemClipboard + 'static)) -> Self {
        match cb.change_count() {
            Some(n) => Self::Count(n),
            None => Self::Text(cb.read(&[TEXT]).map(|f| f.data)),
        }
    }
}

/// What [`SystemClipboard::read_deferred`] read.
pub enum ClipboardRead {
    /// The flavour.
    Now(Flavour),
    /// The work that makes the flavour from the bytes read (a bitmap decoded and encoded as PNG).
    Later(MakeFlavour),
}

/// Makes a flavour from bytes read off the clipboard, on any thread; `None` when it can't be made.
pub type MakeFlavour = Box<dyn FnOnce() -> Option<Flavour> + Send>;

impl ClipboardRead {
    /// The flavour, made at once when it is work.
    pub fn flavour(self) -> Option<Flavour> {
        match self {
            Self::Now(f) => Some(f),
            Self::Later(make) => make(),
        }
    }
}

/// Makes a second system-clipboard handle, to check off the UI thread whether Paste has something
/// to take ([`Services::clipboard_probe`](crate::Services::clipboard_probe)). It is called on that
/// thread and the handle lives and dies there, so the handle needn't be `Send`.
pub type ClipboardProbeFactory = Box<dyn FnOnce() -> Box<dyn SystemClipboard> + Send>;

/// How long quitting waits for the probe's thread ([`ClipboardProbeFactory`]) to drop its handle
/// before the app drops its own: 27 s, VectorCraft's own bound. A host's handle should finish a
/// look and its own teardown within it, or the app's handle may not be the last one dropped; a
/// handle that never lets go still lets the app quit after this wait.
pub const CLIPBOARD_PROBE_STOP_WAIT: std::time::Duration = std::time::Duration::from_secs(27);

/// The Copy or Cut whose formats go to the system clipboard ([`VectorcraftApp::publish_clipboard`]).
#[derive(Default)]
pub(crate) struct Publishing {
    /// The number of the latest Copy or Cut, raised by one when a copy through egui drops the
    /// formats not written yet. Only the formats of the Copy or Cut with this number are made and
    /// written.
    latest: Arc<AtomicU64>,
    /// The latest one's formats wait to be written.
    pending: bool,
    /// The latest one's formats could not be written: what the system clipboard held when the
    /// write failed, and the text of those formats.
    unwritten: Option<(Held, String)>,
    /// The status bar's message when the latest one ran, with [`crate::state::UiState::status_sets`]
    /// then. Its formats' notes replace the message only while the status bar still shows it and
    /// nothing has set the status since.
    status: (String, u64),
    /// The status bar's message the latest Copy or Cut with notes left, with
    /// [`crate::state::UiState::status_sets`] then.
    notes_status: Option<(String, u64)>,
}

impl Publishing {
    /// Whether the latest Copy or Cut still has formats waiting to be written to the system clipboard.
    pub(crate) fn is_pending(&self) -> bool {
        self.pending
    }

    /// The number of the latest Copy or Cut: it changes with each Copy or Cut, and with each copy
    /// through egui that drops the formats not written yet.
    pub(crate) fn latest(&self) -> u64 {
        self.latest.load(Ordering::SeqCst)
    }

    /// `ui`'s status bar message is the one the latest Copy or Cut left, which its formats' notes
    /// may replace.
    pub(crate) fn ran_with_status(&mut self, ui: &crate::state::UiState) {
        ui.status.clone_into(&mut self.status.0);
        self.status.1 = ui.status_sets;
    }

    /// Does `ui`'s status bar still show the message the latest Copy or Cut left, with nothing
    /// setting the status since?
    fn shows_status(&self, ui: &crate::state::UiState) -> bool {
        ui.status == self.status.0 && ui.status_sets == self.status.1
    }
}

/// The status bar's line after a Copy (or with `cut`, a Cut) whose formats have `n` notes, the
/// first of them `first`.
pub(crate) fn copied_with_notes(cut: bool, n: usize, first: &str) -> String {
    let (one, other) = if cut {
        ("Cut with {n} note: {first}", "Cut with {n} notes: {first}")
    } else {
        ("Copied with {n} note: {first}", "Copied with {n} notes: {first}")
    };
    crate::i18n::msg_n(n as u64, one, other, &[("first", first)])
}

/// Show a Copy's (or with `cut`, a Cut's) formats' `notes` in the status bar: the first of them
/// and how many there are, with the rest for the message's hover. Without notes, the message an
/// earlier Copy's or Cut's notes left is cleared while nothing has set the status since, and any
/// other message stays.
pub(crate) fn show_copy_notes(app: &mut VectorcraftApp, cut: bool, notes: Vec<String>) {
    let left = app.clipboard_publishing.notes_status.take();
    let Some(first) = notes.first() else {
        crate::io::clear_notes_left(app, left);
        return;
    };
    let status = copied_with_notes(cut, notes.len(), first);
    crate::io::show_with_notes(app, status, notes);
    app.clipboard_publishing.notes_status = Some((app.ui.status.clone(), app.ui.status_sets));
}

/// Does a flavour of type `mime` load with `clipboard.importImage` ([`import_command`])?
pub(crate) fn imports_as_image(mime: &str) -> bool {
    ![TEXT, SVG, PDF, AI, EPS, EMF].contains(&mime)
}

/// The command (and its params) that loads `f` into the internal clipboard, centred on `center`.
pub(crate) fn import_command(f: &Flavour, center: Option<[f64; 2]>) -> (&'static str, Value) {
    let b64 = || vectorcraft_format::base64_encode(&f.data);
    match f.mime {
        TEXT => {
            let text = String::from_utf8_lossy(&f.data);
            if looks_like_svg(&text) {
                ("clipboard.importSvg", json!({ "svg": text, "center": center }))
            } else {
                ("clipboard.importText", json!({ "text": text, "center": center }))
            }
        }
        SVG => ("clipboard.importSvg", json!({ "dataBase64": b64(), "center": center })),
        PDF => ("clipboard.importPdf", json!({ "dataBase64": b64(), "center": center })),
        AI => ("clipboard.importPdf", json!({ "dataBase64": b64(), "editingData": true, "center": center })),
        EPS => ("clipboard.importEps", json!({ "dataBase64": b64(), "center": center })),
        EMF => ("clipboard.importEmf", json!({ "dataBase64": b64(), "center": center })),
        mime => ("clipboard.importImage", json!({ "dataBase64": b64(), "mime": mime, "center": center })),
    }
}

impl VectorcraftApp {
    /// A Type paste may reuse its saved styled runs only while our desktop copy still owns the
    /// clipboard. Pending formats also belong to that copy; web hosts have no ownership service.
    pub(crate) fn type_paste_has_our_clipboard(&mut self) -> bool {
        self.clipboard_publishing.pending
            || self.unwritten_clipboard_text().is_some()
            || self.services.system_clipboard.as_mut().is_none_or(|cb| cb.holds_ours())
    }

    /// The text of the latest Copy or Cut whose formats could not be written to the system
    /// clipboard, while nothing has been copied since that Copy or Cut. A paste into type or a text
    /// field takes this text until another app copies something. Where the platform has no change
    /// count, a copy is noticed only when it changes the clipboard's text, so the copy is kept only
    /// when the clipboard held text when the write failed.
    pub(crate) fn unwritten_clipboard_text(&mut self) -> Option<String> {
        let cb = self.services.system_clipboard.as_deref_mut()?;
        let (held, text) = self.clipboard_publishing.unwritten.as_ref()?;
        (Held::now(cb) == *held).then(|| text.clone())
    }

    /// After Copy or Cut: offer the copied objects to other apps. With the system clipboard
    /// service, the background worker makes the formats from a copy of the clipboard
    /// ([`background::run`]) and they are written when they are ready. While the worker has a
    /// save, an export, a print or a recovery copy to finish, they are made and written at once
    /// instead. A later Copy or Cut, or a copy through egui
    /// ([`Self::drop_formats_after_egui_copy`]), drops the formats not written yet. While the
    /// latest Copy or Cut's formats wait to be written, Paste takes the internal clipboard, and
    /// while a text field or type has the keyboard the app waits for them
    /// ([`Self::write_formats_before_text_input`]). Once they are written, while the status bar
    /// still shows the message the Copy or Cut (`cut`) left ([`Publishing::ran_with_status`]), it
    /// shows the first of the PNG's and PDF's notes and how many there are; hovering the message
    /// lists them ([`crate::io::show_with_notes`]).
    pub(crate) fn publish_clipboard(&mut self, cut: bool) {
        // Ruler guides copied alone stay in VectorCraft, but the Copy still replaces what the
        // system clipboard held: it is emptied, so the next Paste takes the guides rather than
        // what another app copied before, and what another app copies after still wins (#3226).
        if !self.session.clipboard.has_art() {
            self.clear_system_clipboard();
            // Guides have no formats, so this Copy or Cut has no notes.
            show_copy_notes(self, cut, vec![]);
            return;
        }
        if self.services.system_clipboard.is_none() {
            if self.session.prefs.copy_as_svg {
                self.clipboard_out = self.session.clipboard_svg();
                self.clipboard_published = self.clipboard_out.clone();
            }
            return;
        }
        // An SVG that would name a linked image's file outside the read roots of the automation
        // that asked for the Copy is left out (decided now: the formats are made later).
        let svg = self.session.prefs.copy_as_svg && !self.session.clipboard_svg_refused();
        let (clip, pdf) = (self.session.clipboard.clone(), self.session.prefs.copy_as_pdf);
        let latest = self.clipboard_publishing.latest.clone();
        let n = latest.fetch_add(1, Ordering::SeqCst).wrapping_add(1);
        self.clipboard_publishing.pending = true;
        self.clipboard_publishing.unwritten = None;
        self.clipboard_publishing.ran_with_status(&self.ui);
        // What the clipboard holds at the Copy or Cut: a copy made elsewhere before the write is newer.
        let before = self.services.system_clipboard.as_deref_mut().map(Held::now);
        let (tx, made) = channel();
        let work = move |_: Writer| {
            // These formats are not made when a later Copy or Cut, or a copy through egui, dropped them.
            if latest.load(Ordering::SeqCst) == n {
                // The receiver is gone only when the job was dropped unapplied.
                let _ = tx.send(clip.flavours_with_warnings(svg, pdf));
            }
            Ok(Value::Null)
        };
        let then = move |app: &mut VectorcraftApp, r: Result<Value, String>| {
            let publishing = &mut app.clipboard_publishing;
            if publishing.latest.load(Ordering::SeqCst) != n {
                return Ok(Value::Null);
            }
            publishing.pending = false;
            let formats = r.and_then(|_| made.try_recv().map_err(|e| e.to_string()));
            let written = formats.and_then(|(f, warnings)| {
                let Some(cb) = app.services.system_clipboard.as_mut() else { return Ok(warnings) };
                let before_write = Held::now(cb.as_mut());
                // Nothing copied elsewhere since the Copy or Cut.
                let current = before.as_ref() == Some(&before_write);
                if let Err(e) = cb.write(&f) {
                    // Another app may hold the clipboard open. It keeps what it held (or what the
                    // failed write left), and a paste into text takes this copy's text until
                    // something else is copied.
                    let held = Held::now(cb.as_mut());
                    let text = f.iter().find(|t| t.mime == TEXT).map(|t| String::from_utf8_lossy(&t.data).into_owned());
                    // A change during the write is the failed write emptying the clipboard and
                    // writing some of the formats, or another app's copy: the clipboard then holds
                    // nothing to paste, this copy's text, or no text and one of this copy's
                    // formats only after the former.
                    let left_by_write = held == before_write
                        || match cb.read(&[TEXT]) {
                            Some(now) => text.as_deref().is_some_and(|ours| now.data == ours.as_bytes()),
                            None => !cb.has(&PASTE_ORDER) || f.iter().any(|ours| cb.read(&[ours.mime]).is_some_and(|now| now.data == ours.data)),
                        };
                    // Without a change count, a clipboard with no text can't show a later copy of
                    // a picture, or tell an empty clipboard from one that couldn't be read.
                    let trackable = held != Held::Text(None);
                    app.clipboard_publishing.unwritten = text.filter(|_| current && left_by_write && trackable).map(|text| (held, text));
                    return Err(e);
                }
                Ok(warnings)
            });
            match written {
                Err(e) => app.ui.status = format!("Couldn't copy to the system clipboard: {e}"),
                // The PNG's and PDF's notes (an image that couldn't be decoded, type in the
                // fallback font), unless another message has replaced the Copy or Cut's since.
                Ok(warnings) => {
                    if app.clipboard_publishing.shows_status(&app.ui) {
                        show_copy_notes(app, cut, warnings);
                    }
                }
            }
            Ok(Value::Null)
        };
        // Only the formats of other copies (jobs without a label) may be ahead of these on the worker.
        let free = self.background.jobs.iter().all(|j| j.label.is_empty());
        // No label: the status bar doesn't show the job, and only a failure or a warning changes
        // the status.
        if let Err(e) = background::run(self, free, String::new(), None, work, then) {
            self.ui.status = e;
        }
    }

    /// A Copy with nothing for other apps (ruler guides alone): the formats of an earlier Copy or
    /// Cut not written yet are dropped and the system clipboard is emptied. On the web, empty text
    /// goes through egui when Copy As SVG is on, in place of the SVG objects would put there.
    fn clear_system_clipboard(&mut self) {
        let publishing = &mut self.clipboard_publishing;
        publishing.latest.fetch_add(1, Ordering::SeqCst);
        publishing.pending = false;
        publishing.unwritten = None;
        match self.services.system_clipboard.as_mut() {
            Some(cb) => {
                if let Err(e) = cb.write(&[]) {
                    self.ui.status = format!("Couldn't copy to the system clipboard: {e}");
                }
            }
            None => {
                if self.session.prefs.copy_as_svg {
                    self.clipboard_out = Some(String::new());
                    self.clipboard_published = None;
                }
            }
        }
    }

    /// End of a frame: when something copied text or a picture through egui this frame (a text
    /// field, the Type tool), the formats of an earlier Copy or Cut that are not written yet are
    /// dropped, and the system clipboard keeps that copy.
    pub(crate) fn drop_formats_after_egui_copy(&mut self, ctx: &egui::Context) {
        let copied = ctx.output(|o| o.commands.iter().any(|c| matches!(c, egui::OutputCommand::CopyText(_) | egui::OutputCommand::CopyImage(_))));
        if copied {
            self.drop_unwritten_formats();
        }
    }

    /// Drop the formats of an earlier Copy or Cut that are not written yet: something else is
    /// being copied (text through egui, the text selected in a label).
    pub(crate) fn drop_unwritten_formats(&mut self) {
        let publishing = &mut self.clipboard_publishing;
        publishing.unwritten = None;
        if publishing.pending {
            publishing.latest.fetch_add(1, Ordering::SeqCst);
            publishing.pending = false;
        }
    }

    /// Start of a frame, before the background results that arrived are applied: while a text
    /// field or type has the keyboard (egui's or the Type tool's), the formats a Copy or Cut is
    /// making are written first ([`Self::written_clipboard_text`]). A paste whose text the host read
    /// before that pastes their text instead, or nothing when they have none. A paste chord the
    /// host found no text for pastes their text, also when its key comes up after they were
    /// written, while the system clipboard still holds them. On the canvas the app does not wait
    /// for them: Paste takes the internal clipboard ([`Self::adopt_system_clipboard`]).
    pub(crate) fn write_formats_before_text_input(&mut self, ctx: &egui::Context) {
        if !(ctx.egui_wants_keyboard_input() || self.session.tool_wants_text()) {
            return;
        }
        // A paste chord egui sent no Paste event for: the clipboard held no text when it came.
        let textless = ctx.input(|i| self.paste_chord.clone().textless_paste(&i.events).is_some());
        // Formats that waited when this host iteration began still own a paste event read while
        // they were pending, even if the worker wrote them during this iteration's tick.
        let waited = ctx.data(|d| d.get_temp::<bool>(egui::Id::unique("clipboard.pending-at-tick"))).unwrap_or(false);
        ctx.data_mut(|d| d.remove::<bool>(egui::Id::unique("clipboard.pending-at-tick")));
        if !(self.clipboard_publishing.pending || waited) {
            // A copy whose formats could not be written: a paste takes its text, not the text the
            // clipboard kept ([`Self::unwritten_clipboard_text`]).
            let pasting = textless || ctx.input(|i| i.events.iter().any(|e| matches!(e, egui::Event::Paste(_))));
            if pasting && let Some(text) = self.unwritten_clipboard_text() {
                ctx.input_mut(|i| {
                    for e in &mut i.events {
                        if let egui::Event::Paste(t) = e {
                            t.clone_from(&text);
                        }
                    }
                    if textless {
                        i.events.insert(0, egui::Event::Paste(text));
                    }
                });
                return;
            }
            // The formats the clipboard still holds were written after the chord's key went down.
            if textless
                && self.services.system_clipboard.as_mut().is_some_and(|cb| cb.holds_ours())
                && let Some(text) = self.system_clipboard_text()
            {
                ctx.input_mut(|i| i.events.insert(0, egui::Event::Paste(text)));
            }
            return;
        }
        let text = self.written_clipboard_text();
        ctx.input_mut(|i| {
            i.events.retain_mut(|e| match (e, &text) {
                (egui::Event::Paste(t), Some(text)) => {
                    t.clone_from(text);
                    true
                }
                (egui::Event::Paste(_), None) => false,
                _ => true,
            });
            if textless && let Some(text) = text {
                i.events.insert(0, egui::Event::Paste(text));
            }
        });
    }

    /// Paste `f`, which the host read from the system clipboard itself (a web page's paste carries
    /// pictures and files, egui's Paste event text only), as the paste chord `held` pastes:
    /// unless a field or the Type tool has the keyboard, as with the paste keys.
    pub fn paste_from_host(&mut self, ctx: &egui::Context, f: Flavour, held: egui::Modifiers) {
        if ctx.egui_wants_keyboard_input() || self.session.tool_wants_text() {
            return;
        }
        self.clipboard_in = Some(f);
        crate::menus::invoke(self, crate::shortcuts::paste_command(held), json!({}));
    }

    /// Before a paste: what another app put on the system clipboard replaces the internal
    /// clipboard (centred in the view). What we published ourselves keeps the lossless internal
    /// copy, and so does what we are still making the formats of. An error means nothing should be
    /// pasted.
    pub(crate) fn adopt_system_clipboard(&mut self) -> Result<(), String> {
        self.adopt_system_clipboard_or_defer(false).map(drop)
    }

    /// [`Self::adopt_system_clipboard`]. With `defer`, a bitmap is not loaded here: the work that
    /// makes its flavour comes back (a bitmap the host converts to PNG is converted by it,
    /// [`SystemClipboard::read_deferred`]; text that names the picture is the flavour when the
    /// picture can't be made), and the internal clipboard is left as it is.
    pub(crate) fn adopt_system_clipboard_or_defer(&mut self, defer: bool) -> Result<Option<MakeFlavour>, String> {
        // A paste command may run before the next tick consumes an image signal: this is that
        // paste, so a queued `PasteImage` must not read the clipboard a second time.
        self.clipboard_image_request = None;
        let pasted = self.clipboard_in.take();
        let center = self.view().map(|v| [v.center.x, v.center.y]);
        let (cmd, params) = match (pasted, self.services.system_clipboard.as_mut()) {
            (Some(f), _) if defer && imports_as_image(f.mime) => return Ok(Some(Box::new(move || Some(f)))),
            // A picture or file the host read from the paste.
            (Some(f), _) if f.mime != TEXT => import_command(&f, center),
            (_, Some(cb)) => {
                if self.clipboard_publishing.pending || cb.holds_ours() {
                    return Ok(None);
                }
                let mut read = |mimes: &[&'static str]| if defer { cb.read_deferred(mimes) } else { cb.read(mimes).map(ClipboardRead::Now) };
                let f = match read(&PASTE_ORDER) {
                    Some(ClipboardRead::Now(f)) => f,
                    Some(ClipboardRead::Later(make)) => return Ok(Some(make)),
                    None => return Ok(None),
                };
                // Text that only names a picture (its address, or its image markup) goes with a
                // browser's copied picture: the picture.
                let text = String::from_utf8_lossy(&f.data);
                // Blank text is what some hosts put beside a copied picture. It is not the paste.
                let f = if f.mime == TEXT && (text.trim().is_empty() || names_a_picture(&text)) {
                    match read(&[BITMAP]) {
                        Some(ClipboardRead::Now(picture)) => picture,
                        // The text, when the picture can't be made.
                        Some(ClipboardRead::Later(make)) => return Ok(Some(Box::new(move || make().or(Some(f))))),
                        None => f,
                    }
                } else {
                    f
                };
                if defer && imports_as_image(f.mime) {
                    return Ok(Some(Box::new(move || Some(f))));
                }
                import_command(&f, center)
            }
            // Text only: SVG markup is art, other text is left alone.
            (pasted, None) => {
                let text =
                    pasted.map(|f| String::from_utf8_lossy(&f.data).into_owned()).or_else(|| self.services.clipboard_read.as_mut().and_then(|f| f()));
                let Some(text) = text.filter(|t| looks_like_svg(t)) else { return Ok(None) };
                if self.clipboard_published.as_deref() == Some(text.as_str()) {
                    return Ok(None);
                }
                self.clipboard_published = Some(text.clone());
                ("clipboard.importSvg", json!({ "svg": text, "center": center }))
            }
        };
        self.session.execute(cmd, &params).map(|_| None).map_err(|e| {
            self.clipboard_published = None;
            format!("Couldn't paste from the clipboard: {e}")
        })
    }

    /// Before a paste whose flavour was made off the UI thread ([`crate::placing::adopt_for_paste`]):
    /// `f` replaces the internal clipboard, centered on `center`, as
    /// [`Self::adopt_system_clipboard`] loads it. An error means nothing should be pasted.
    pub(crate) fn adopt_flavour(&mut self, f: &Flavour, center: Option<[f64; 2]>) -> Result<(), String> {
        let (cmd, params) = import_command(f, center);
        self.session.execute(cmd, &params).map(drop).map_err(|e| {
            self.clipboard_published = None;
            format!("Couldn't paste from the clipboard: {e}")
        })
    }

    /// [`Self::adopt_flavour`] for a bitmap of type `mime` decoded off the UI thread: the image `read`
    /// replaces the internal clipboard, centered on `center`.
    pub(crate) fn adopt_image_read(&mut self, mime: &str, center: Option<[f64; 2]>, read: Result<ImageRead, String>) -> Result<(), String> {
        let params = json!({ "mime": mime, "center": center });
        read.and_then(|read| self.session.import_image_read(read, &params).map(drop).map_err(|e| e.to_string())).map_err(|e| {
            self.clipboard_published = None;
            format!("Couldn't paste from the clipboard: {e}")
        })
    }

    /// The text on the system clipboard once the formats a Copy or Cut is making are written, for a
    /// paste into a text field or type. When they could not be written, their text
    /// ([`Self::unwritten_clipboard_text`]).
    pub(crate) fn written_clipboard_text(&mut self) -> Option<String> {
        // Only other copies' formats are ahead of them on the worker ([`Self::publish_clipboard`]).
        background::wait_until(self, |app| !app.clipboard_publishing.pending);
        self.unwritten_clipboard_text().or_else(|| self.system_clipboard_text())
    }

    /// The text on the system clipboard, if any.
    pub(crate) fn system_clipboard_text(&mut self) -> Option<String> {
        match self.services.system_clipboard.as_mut() {
            Some(cb) => cb.read(&[TEXT]).map(|f| String::from_utf8_lossy(&f.data).into_owned()),
            None => self.services.clipboard_read.as_mut().and_then(|read| read()),
        }
    }

    /// Does the system clipboard hold something Paste can take (with nothing copied in the app)?
    pub(crate) fn system_clipboard_pasteable(&mut self) -> bool {
        match self.services.system_clipboard.as_mut() {
            Some(cb) => cb.has(&PASTE_ORDER),
            None => self.services.clipboard_read.as_mut().and_then(|read| read()).is_some_and(|t| looks_like_svg(&t)),
        }
    }
}