TextInput

JSON-safe TextInput props forwarded to Astryx.

Supported Astryx props include:

• type ('text' or 'password' or 'email'): The HTML input type.
• label (string; required): Label text for the input: always rendered for accessibility.
• value (string; required): Current value of the input.
• onChange ((value: string, e: ChangeEvent<HTMLInputElement>) => void): Callback fired when the input value changes.
• changeAction ((value: string, e: ChangeEvent<HTMLInputElement>) => void or Promise<void>): Async action fired after onChange (if not prevented). Triggers optimistic update and shows a loading spinner while pending.
• size ('sm' or 'md' or 'lg'): Size variant of the input.
• isLabelHidden (boolean): Visually hides the label while keeping it accessible to screen readers.
• description (string): Description text displayed between the label and input.
• isOptional (boolean): Displays an "Optional" indicator next to the label. Mutually exclusive with isRequired.
• isRequired (boolean): Displays a "Required" indicator next to the label and sets aria-required. Mutually exclusive with isOptional.
• isDisabled (boolean): Disables the input, preventing interaction and dimming the element.
• isLoading (boolean): Puts the input in a loading state, showing a spinner and setting aria-busy.
• placeholder (string): Placeholder text shown when the input is empty.
• labelTooltip (string): Tooltip text displayed in an info icon at the end of the label.
• startIcon (IconType): SVG icon component displayed at the start of the input. See 'npx astryx docs icons' for valid semantic names.
• status ({type: 'error' or 'warning' or 'success', message?: string}): Validation status: applies a colored border and status icon. If message is provided, displays a floating message below the input. Error type also sets aria-invalid.
• hasClear (boolean): Shows a clear (x) button when the input has a value. Clicking it clears the value and returns focus to the input.
• hasAutoFocus (boolean): Automatically focuses the input on mount.
• htmlName (string): The HTML name attribute for the input, useful for form submissions.

Props typed as React nodes, render functions, event handlers, refs, or StyleX styles are documented for Astryx parity but cannot be serialized directly from Python unless the wrapper adapts them.

See Astryx component docs: https://astryx.atmeta.com/components/TextInput.