Component · Inputs

Form Wizard

Multi-step form wizard chrome with stepper, validation gates, review, failure/retry, and resume. Domain fields stay consumer-owned.

Kind: widget
Input: interactive
Canvas: 120×40

Live preview

Ghostty· TermRock —blocks/form-wizardloading poster…

Loading terminal poster…

○ loading posterNo input — rendered state only

Form Wizard · exact mounted Rust story

01 · Purpose

What it is for

Multi-step form wizard chrome with stepper, validation gates, review, failure/retry, and resume. Domain fields stay consumer-owned.

Best fit: Inputs · input · widget

02 · Behavior

What the mounted story proves

01
FormWizard
Representative 120×40 terminal state.
02
Passive paint
No keyboard or pointer action is claimed by this representative story.
03
Evidence stays explicit
3 covered · 9 partial · 4 missing axes.

03 · Implement

Install, then start from exact code

Install

cargo add termrock --git https://github.com/tailrocks/termrock.git --rev 5283c2acf9154d0cfcd37b1ffe821c00faf90ea2

Add TermRock once. Keep domain effects in the host application.

Minimal implementation

Exact Rust setup used by blocks/form-wizard.

Open to load code.

04 · Adapt

Variants and composition

Variants

Use the preview Variant menu when alternate registered stories exist. Each selection mounts a fresh configuration.

Composition

Inputs · input · widget

05 · Reference

API, tokens, accessibility

API

FormWizardOpen source ↗

Tokens

DesignSystemInspect exact story code for roles and capability projection.

Accessibility

Input contract mountedNo input claim in the representative story.

Contract

Evidence in progress3/23 axes covered

06 · Go deeper

Advanced guidance

Authored implementation guidance

Purpose. Setup, onboarding, connections, migrations — multi-step chrome with validation gates. Domain values stay in the host; paint fields into body_area() after wizard chrome.

Ownership

Concern	Owner
Step titles, optional flags, progress ids	WizardStep / state
Field values, validation messages	Host Form / fields
Submit / async I/O / persistence	Host via outcomes
Side effects	Never in TermRock

Narrow layout

Width < 36 → single-step title (no full stepper strip).

Ownership boundary

TermRock owns reusable terminal rendering and interaction state. The host owns domain data, policy, persistence, authorization, and side effects.

Evidence status

3 covered, 9 partial, and 4 missing contract axes. Missing evidence is not a behavior claim.

Form

A responsive form layout with stable focus, validation, and hit geometry.

Input Group

InputGroup is the exact public paint owner for input terminal UI.