Enum PresentSpec 

pub enum PresentSpec {
    Dialog {
        title: String,
        message: Option<String>,
        buttons: Vec<PresentButton>,
        sheet: bool,
    },
    Prompt {
        title: String,
        message: Option<String>,
        placeholder: String,
        initial: String,
        ok: String,
        cancel: String,
    },
    OpenFile {
        title: String,
        filters: Vec<FileFilter>,
    },
    SaveFile {
        title: String,
        suggested_name: String,
        src_path: String,
        filters: Vec<FileFilter>,
    },
}

What a backend should present for a req. Kept toolkit-agnostic; the pieces layer maps a chosen button index back to a typed payload.

Variants

Dialog

Alert / confirmation / action sheet: title + optional message + ordered buttons. sheet = present from the bottom on mobile (desktop falls back to an alert).

Fields

title: String

message: Option<String>

buttons: Vec<PresentButton>

sheet: bool

Prompt

A dialog with a single text field.

Fields

title: String

message: Option<String>

placeholder: String

initial: String

ok: String

cancel: String

OpenFile

Native “open file” picker (docs/files.md). The backend must answer with PresentResult::Files whose entries are readable local paths — desktop returns the chosen path directly; iOS/Android copy the selection into app storage first, so the pieces layer can read it with std::fs regardless of platform.

Fields

title: String

filters: Vec<FileFilter>

SaveFile

Native “save file” picker (docs/files.md). src_path is a Day-written temp file holding the bytes to save; iOS/Android deliver it to the chosen destination natively, and the pieces layer best-effort copies it to a chosen local path otherwise.

Fields

title: String

suggested_name: String

src_path: String

filters: Vec<FileFilter>

Implementations

impl PresentSpec

pub fn title(&self) -> &str

Backend-facing flattening for the C ABI: (title, message, button labels, button roles as ints, sheet-or-prompt fields). Pure-Rust backends read the enum directly.

pub fn message(&self) -> Option<&str>

pub fn buttons_joined(&self) -> String

Button labels joined with the unit separator (0x1f) — the encoding the nav menu and combobox shims already use for string lists.

pub fn roles_joined(&self) -> String

Button roles as ints (0 default, 1 cancel, 2 destructive), joined with commas.

pub fn filters(&self) -> &[FileFilter]

The file filters, if this is a file dialog.

pub fn suggested_name(&self) -> &str

The suggested file name for a save dialog (empty otherwise).

pub fn src_path(&self) -> &str

The Day-written temp source path for a save dialog (empty otherwise).

pub fn filters_joined(&self) -> String

Filters flattened for the C ABI: each filter is name|ext1,ext2, joined by the unit separator. A trailing | (no extensions) means “all files”. Empty when unfiltered.

Trait Implementations

impl Clone for PresentSpec

fn clone(&self) -> PresentSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PresentSpec

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

Formats the value using the given formatter.

impl PartialEq for PresentSpec

fn eq(&self, other: &PresentSpec) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for PresentSpec