TransformingActionInput

Marketing entry-point input that morphs between surface modes, from a prompt bar into a chat handoff; pairs with ChatWidget.

When to use

Marketing entry-point input that morphs between surface modes (prompt bar into chat handoff). Pairs with ChatWidget.

The contract records no forbidden uses.

The contract names no look-alike with a deciding condition.

TransformingActionInput props
Prop	Type	Default	Description	Required
`initialMode`	`"button" \| "input"`	`button`	Initial surface mode before transformation.	No
`value`	`string`	none	Optional controlled value.	No
`defaultValue`	`string`	`""`	Default value when uncontrolled.	No
`disabled`	`boolean`	`false`	Disabled state for both button and input.	No
`actionLabelKey`	`string`	`transformingActionInput.trigger`	Translation key for the trigger label.	No
`inputLabelKey`	`string`	`transformingActionInput.label`	Translation key for the input label.	No
`helperTextKey`	`string`	`transformingActionInput.helper`	Translation key for helper text below the input.	No
`placeholderKey`	`string`	`transformingActionInput.placeholder`	Translation key for the placeholder.	No
`onChange`	`(value: string) => void`	none	Triggered when value changes.	No
`onSubmit`	`(value: string) => void`	none	Triggered on submit in input mode.	No
`stayInInputMode`	`boolean`	`false`	When true, retains the input after submit instead of returning to button mode.	No
`className`	`string`	`""`	Optional className passthrough.	No

MUST NOT: value and defaultValue set together. value makes the component controlled and defaultValue uncontrolled; pass one, not both.

The contract records no keyboard interaction.

Every item under When not to use is a MUST NOT. MUST and SHOULD follow RFC 2119.

TransformingActionInput rules
Level	Rule	How it is checked
MUST NOT	`value` and `defaultValue` set together. `value` makes the component controlled and `defaultValue` uncontrolled; pass one, not both.	Checked by the MCP tool validate_component_usage.
MUST	Required stories produce no axe violations at the configured severity.	Automated by `npm run test:stories:matrix:ci`. WCAG 2.5.8.
MUST	The accessibility tree (role, name, state) matches the committed snapshot for every required story.	Automated by `npm run test:stories:matrix:ci`. WCAG 1.3.1, 4.1.2.
MUST	The component remains legible and operable under a real browser forced-colors: active pass.	Automated by `npm run test:stories:hc`.
MUST	A human completed an end-to-end accessibility review of this component.	Manual review, last on 2026-05-28.
MUST NOT	Maintainers: Do not bypass design tokens or skip forced-colors verification at beta.	Release review; not machine-checked.

In-repo only. TransformingActionInput is not exported from @digitaltableteur/react, so there is no public import path.