Skip to content

Manual input ​

<sea-manual-input> edits the form required by a blocked step in an existing process. Bind it to the step's label, or use run-step-id to select an exact step instance.

When a step requires several forms, set output-form-id to choose one form or output-submission-id to choose its exact linked draft. Completing that form leaves the other inputs open.

IntegrationEntry
ReactSeaManualInput from @sea-dev/widget-lit/react/manual-input
Without React@sea-dev/widget-lit/manual-input
html
<sea-manual-input step-label="applicant-input"></sea-manual-input>

Place it inside a process and Sea context, with the page API host configured before mounting. The blocker supplies the required form. The widget reuses the draft linked by the backend, or prepares a draft after the user chooses to enter input. Mounting it creates no input submission.

Completing the input waits for pending field saves, finalises the submission and attaches it to the exact run step if needed. The backend then resolves the dependency. Failed saves leave the input open for correction or retry.

Attributes and properties ​

PropertyAttributeTypeDefaultDescription
stepLabelstep-labelstring""Selects the pipeline step with this unique label.
stepRolestep-rolePipelineStepRoleWire or undefined—Constrains the selected step to this execution role.
stepIdstep-idstring""Selects a pipeline step definition by ID.
runStepIdrun-step-idstring""Selects an exact step instance in the current run.
outputFormIdoutput-form-idstring""Selects the required form and its linked input.
outputSubmissionIdoutput-submission-idstring""Selects an exact linked input submission.

Events ​

EventTypeDescription
input-createdCustomEvent{ runId, runStepId, submissionId } after a draft is created without resuming the run.
input-completedCustomEvent{ runId, runStepId, submissionId } after edits are saved, the input is finalised and any new input is connected.

Styling parts ​

PartDescription
rootThe manual input container.
toolbarThe input actions and the editor toolbar.
actionsThe input actions.
contentThe input editor.
statusInput status and errors.

API and transport ​

The widget reads the required form and submission, saves field corrections and finalises the input through the submission API. A new draft uses submission.create. An unlinked completed input uses pipeline.manualInput with runId, runStepId and submissionId.

Custom transports implement these operations alongside the process reads. Run creation belongs to your application.