Enum Step 

pub enum Step {
    WaitFor {
        id: String,
        timeout_secs: Option<f64>,
    },
    WaitIdle,
    ScrollTo {
        id: String,
        edge: Option<String>,
        x: Option<f64>,
        y: Option<f64>,
    },
    Tap {
        id: String,
        repeat: Option<u32>,
    },
    Submit {
        id: String,
    },
    Input {
        id: String,
        text: Option<String>,
        key: Option<String>,
        args: Option<BTreeMap<String, Value>>,
    },
    SetValue {
        id: String,
        value: f64,
    },
    Toggle {
        id: String,
        value: Option<bool>,
    },
    Select {
        id: String,
        index: i64,
    },
    Reorder {
        id: String,
        from: usize,
        to: usize,
    },
    Menu {
        item: Option<String>,
        key: Option<String>,
        path: Option<Vec<String>>,
    },
    Toolbar {
        item: String,
        text: Option<String>,
        key: Option<String>,
        args: Option<BTreeMap<String, Value>>,
        on: Option<bool>,
    },
    AssertVisible {
        id: String,
    },
    AssertText {
        id: String,
        text: Option<String>,
        key: Option<String>,
        args: Option<BTreeMap<String, Value>>,
    },
    AssertValue {
        id: String,
        value: Value,
    },
    AssertNoPlaceholders {
        allow: Vec<String>,
    },
    CloseWindow {
        window: String,
    },
    Screenshot {
        name: String,
        window: Option<String>,
    },
    Pause {
        secs: f64,
    },
    Navigate {
        route: String,
    },
    NavBack,
    AssertRoute {
        route: String,
    },
    AssertPresented {
        title: Option<String>,
    },
    Respond {
        button: Option<i64>,
        text: Option<String>,
        path: Option<String>,
        dismiss: bool,
    },
    A11yAudit {
        id: Option<String>,
    },
    Focus {
        id: String,
        focused: Option<bool>,
    },
    AssertFocused {
        id: String,
        focused: Option<bool>,
    },
    ExpectExit {
        within: Option<f64>,
    },
}

Variants

WaitFor

Fields

id: String

timeout_secs: Option<f64>

Upper bound in seconds for the implicit retry wait (§14.3) — for elements that appear only after slow work (a login round-trip, a first sync). Defaults to the shared step timeout.

WaitIdle

ScrollTo

Programmatic scroll (docs/scroll.md §dayscript). With edge/x+y, id must name a scroll piece; with neither, id names ANY element and its nearest enclosing scroll reveals it. Unanimated, so the next step sees the settled position.

Fields

id: String

edge: Option<String>

"top" | "bottom" | "leading" | "trailing".

x: Option<f64>

y: Option<f64>

Tap

Fields

id: String

repeat: Option<u32>

Submit

Deliver Event::Submitted to the element — the scripted stand-in for the platform’s submit gesture (Enter in a text_area with .on_submit, a field’s return key).

Fields

id: String

Input

Fields

id: String

text: Option<String>

key: Option<String>

Localized alternative to text: resolve this Fluent key (with args) in the RUN’S locale and type the result — locale-portable queries (e.g. a localized fruit name).

args: Option<BTreeMap<String, Value>>

SetValue

Fields

id: String

value: f64

Toggle

Fields

id: String

value: Option<bool>

Select

Fields

id: String

index: i64

Reorder

Drag-reorder a list row programmatically: row from drops at row to through the same guard → commit path a native drag takes (docs/list.md) — the app’s reorder_guard may deny or retarget it. Fails (non-retryably) when the list isn’t .reorderable() or the guard denies the move.

Fields

id: String

from: usize

to: usize

Menu

Invoke an app-menu item programmatically (docs/menus.md): match a unique Action leaf in the installed app-menu model by exact item label, or by key — a Fluent key resolved in the run’s locale (locale-portable; a standard-role item also matches its role’s core-catalog key, so the auto Preferences item is key: day-preferences). path disambiguates with ancestor submenu labels (suffix match). Items that run a native selector instead of a day action (role items with id 0) are not invokable this way.

Fields

item: Option<String>

key: Option<String>

path: Option<Vec<String>>

Toolbar

Drive a window-toolbar item by its id (docs/toolbars.md). With neither text: nor on: this runs a button’s command; text: types into a search item; on: sets a toggle. Each goes through the same dispatch the native control fires, so it exercises the app’s wiring — it does not prove the native widget drew (a screenshot does).

Fields

item: String

text: Option<String>

key: Option<String>

Localized alternative to text, exactly as Step::Input takes one: resolve this Fluent key (with args) in the RUN’S locale and type the result. A toolbar search field that filters on localized text needs this — a literal query written in English matches nothing once the run switches locale.

args: Option<BTreeMap<String, Value>>

on: Option<bool>

AssertVisible

Fields

id: String

AssertText

Fields

id: String

text: Option<String>

key: Option<String>

args: Option<BTreeMap<String, Value>>

AssertValue

Fields

id: String

value: Value

AssertNoPlaceholders

Fail if any piece kind rendered a ⟨kind⟩ placeholder — i.e. the backend had no renderer for it. Placeholders are invisible to every other assertion (the app still renders, the screenshot still looks plausible), so this is the only step that catches a missing or silently-dropped renderer. allow lists the kinds a target is expected to lack, which makes the script itself the per-target gap ledger; anything outside it is a failure.

Fields

allow: Vec<String>

CloseWindow

Close the secondary window opened under window (day::open_window’s key — the preferences window is day.preferences), through the same async confirm → teardown path a title-bar close takes (docs/windows.md; on the cover-fallback tier this dismisses the cover). An already-closed window is a success (closing is idempotent).

Fields

window: String

Screenshot

Fields

name: String

window: Option<String>

Capture the secondary window opened under this key (day::open_window’s key) instead of the primary (docs/windows.md). On the cover-fallback tier the key resolves to the primary window, whose fullscreen cover IS the content — same pixels, no special case. A missing key fails retryably (the window may still be opening).

Pause

Fields

secs: f64

Navigate

Navigate to a registered route (reset-to semantics; “” = root). docs/navigation.md.

Fields

route: String

NavBack

Pop one navigation level (the native back path, day-initiated).

AssertRoute

Assert the current route path (“” = root).

Fields

route: String

AssertPresented

Assert a modal is presented, optionally checking its title (docs/dialogs.md).

Fields

title: Option<String>

Respond

Answer the open modal: a button index, a prompt text, a file path (open/save pickers — relative paths resolve against the app temp dir, writable on every target), or dismiss.

Fields

button: Option<i64>

text: Option<String>

path: Option<String>

dismiss: bool

A11yAudit

Diff the NATIVE accessibility tree against Day’s expectations (role/label/value/identifier) for every id’d node, or just id (§13, §14.2). Backends that can’t read their native tree (found = false) are skipped; role is only compared when both sides map to a known Role.

Fields

id: Option<String>

Focus

Move native focus to the control — the real Toolkit duty, not a synthetic event, so keyboards and end-editing flows engage (docs/focus.md). focused: false resigns it.

Fields

id: String

focused: Option<bool>

AssertFocused

Assert the control’s focus state as Day resolved it (NodeProbe.focused; retryable — focus lands a turn after the request). focused defaults to true.

Fields

id: String

focused: Option<bool>

ExpectExit

Expect the app to TERMINATE — the only step that tolerates the app dying (docs/break.md’s crash-reporting flow, docs/agent.md). MUST be the last step: a preceding step triggered an intentional exit/crash, and expect_exit treats the connection dropping within within seconds (default 15) as success; the app surviving the window is the failure. Handled runner-side (day-cli), so the in-app engine never executes it — this arm is defensive.

Fields

within: Option<f64>

Trait Implementations

impl Clone for Step

fn clone(&self) -> Step

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Step

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Step

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Step

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.