Write sweepPro
An 'agent is writing here' pass: a soft band of light sweeps down the region being changed, each row it crosses blurs out its old value and settles into the new one, and the footer counts the changes with Undo.
oxyn add write-sweepWeek 3 · Half marathon plan
“Build up to a half marathon by March”
The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.
Rendered from Rust at build time · goes live when visible
When to use
- Show where an agent is writing so the eye follows the edit instead of hunting for what changed.
When not to use
- An agent asks before it acts: use Approval Card instead.
- Several open requests in one card: use Approval pager instead.
- An agent's question in its own card above the composer: use Decision Card instead.
Installation
Write sweep is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.
oxyn add write-sweepUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Aurora
A soft colour band.
Week 3 · Half marathon plan
“Build up to a half marathon by March”
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Mono
A grey band for quiet UIs (Oxyn extra).
Week 3 · Half marathon plan
“Build up to a half marathon by March”
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Compare
Keeps the old value struck through.
Week 3 · Half marathon plan
“Build up to a half marathon by March”
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
WriteSweep
| Prop | Type | Default | Description |
|---|---|---|---|
nowrequired | ClockMs | — | Host clock. |
duration_ms | u64 | 1_800 | Ms the band takes top to bottom. |
autoplay | bool | true | Start on its own after a moment. |
tone | String | "aurora" | `aurora` (a soft colour band) or `mono` (a grey band). |
show_before | bool | Default::default() | Show the old value struck through beside changed rows. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| EnterorSpace | Run the update |
| Cmd/CtrlZ | Undo the changes |
| Escape | Skip the sweep and apply at once |
Accessibility
- The region is marked busy while the band moves; the status line counts changes.
- The band is decorative and hidden for reduced motion; values still change.
From the spec
The region is aria-busy while sweeping; the band is decorative and hidden under reduced motion (values still change); Enter runs, Cmd/Ctrl+Z undoes, Escape applies at once. Every action returns the line the polite live region announces. The focus outline shows only for keyboard focus.
Motion & interaction
A soft blurred band moves top to bottom; each row it crosses blurs out and settles into its new value; changed rows keep a thin info-coloured marker. The mono tone uses a grey band.
Timing
Everything on screen is derived from the host clock now (no timers in the component), so playback, tests and the GPUI view agree.
| Transition | Duration | Easing |
|---|---|---|
| Sweep | 1800 ms default (duration_ms) | linear |
| Row settle | 450 ms | ease-out |
| Autoplay delay | 600 ms | — |
Reduced motion: CSS motion is cut to a frame; decorative bands and rings are hidden or still; state and text changes stay.
Responsive behaviour
- Rows wrap the old value under the new one on narrow cards.
Edge cases (spec)
Rows wrap the old value under the new one when show_before is on; the band is clipped to the region. Checked at 1440, 768 and 390 px in light and dark with no text overlap. Chrome is monochrome grey; colour is semantic only (success, warning, danger, info) plus the official coloured brand marks.
Notes for AI
- Import
WriteSweepfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
XPostViewinoxyn_gpui. - Props to set first:
now. - It reads a clock (
now) for live timers; pass one clock for the whole page rather than one per component. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.