Forms

import static dev.tamboui.toolkit.Toolkit.*;

        // With TextInputState
        TextInputState nameState = new TextInputState("John");
        formField("Name", nameState);

        // Creates internal state automatically
        formField("Email")
            .placeholder("you@example.com");

formField("Email", emailState)
    .labelWidth(14)           // Fixed label width for alignment
    .spacing(2)               // Gap between label and input
    .rounded()                // Rounded border
    .borderColor(Color.DARK_GRAY)
    .focusedBorderColor(Color.CYAN)
    .errorBorderColor(Color.RED);

FormFieldElement-label {
    color: gray;
}

FormFieldElement-error {
    color: red;
}

FormState form = FormState.builder()
    // Text fields
    .textField("username", "")
    .textField("email", "user@example.com")

    // Boolean fields
    .booleanField("newsletter", true)
    .booleanField("darkMode", false)

    // Select fields
    .selectField("country", Arrays.asList("USA", "UK", "Germany"), 0)
    .selectField("role", Arrays.asList("Admin", "User", "Guest"))  // defaults to index 0

    .build();

// Get state objects for UI binding
TextInputState usernameState = form.textField("username");
BooleanFieldState newsletterState = form.booleanField("newsletter");
SelectFieldState countryState = form.selectField("country");

// Get/set text values directly
String email = form.textValue("email");
form.setTextValue("email", "new@example.com");

// Get/set boolean values
boolean subscribed = form.booleanValue("newsletter");
form.setBooleanValue("newsletter", false);

// Get/set select values
String country = form.selectValue("country");
int countryIndex = form.selectIndex("country");
form.selectIndex("country", 2);  // Select "Germany"

// Get all text values as map
Map<String, String> allText = form.textValues();

formField("Email", emailState)
    .validate(Validators.required(), Validators.email())
    .errorBorderColor(Color.RED)
    .showInlineErrors(true);

Validators.required("Please enter your name");
Validators.email("Invalid email format");
Validators.minLength(3, "Username must be at least 3 characters");
Validators.range(1, 100, "Age must be between 1 and 100");

FormFieldElement field = formField("Email", emailState)
    .validate(Validators.required(), Validators.email());

// Validate and get result
ValidationResult result = field.validateField();

if (!result.isValid()) {
    String error = result.errorMessage();  // "Field is required" or "Invalid email"
}

// Get last validation result
ValidationResult lastResult = field.lastValidation();

Validator usernameAvailable = value -> {
    if (userService.exists(value)) {
        return ValidationResult.invalid("Username already taken");
    }
    return ValidationResult.valid();
};

formField("Username", usernameState)
    .validate(Validators.required(), usernameAvailable);

Validator emailValidator = Validators.required()
    .and(Validators.email())
    .and(Validators.maxLength(100));

formField("Email", emailState)
    .validate(emailValidator);

form(formState)
    .field("fullName", "Full Name")
    .field("email", "Email")
    .field("role", "Role")
    .labelWidth(14)
    .rounded();

form(formState)
    .group("Personal Info")
        .field("fullName", "Full Name")
        .field("email", "Email")
        .field("phone", "Phone")
    .group("Preferences")
        .field("newsletter", "Newsletter", FieldType.CHECKBOX)
        .field("darkMode", "Dark Mode", FieldType.TOGGLE)
    .labelWidth(14)
    .spacing(1);

form(formState)
    .field("username", "Username")
    .field("email", "Email")
    .field("role", "Role", FieldType.SELECT)
    .arrowNavigation(true);  // Up/Down navigate between fields

TextInputState state = new TextInputState("initial");

// Get/set text
String text = state.text();
state.setText("new value");

// Cursor operations
state.insert('c');
state.deleteBackward();
state.deleteForward();
state.moveCursorLeft();
state.moveCursorRight();
state.clear();

BooleanFieldState state = new BooleanFieldState(false);

// Get/set value
boolean value = state.value();
state.setValue(true);

// Toggle
state.toggle();  // Flips the value

SelectFieldState state = new SelectFieldState("A", "B", "C");
// Or with List
SelectFieldState stateFromList = new SelectFieldState(options, 1);  // Select index 1

// Get values
String selected = state.selectedValue();  // "A"
int index = state.selectedIndex();        // 0
List<String> opts = state.options();   // ["A", "B", "C"]

// Change selection
state.selectIndex(2);    // Select "C"
state.selectNext();      // Move to next option (wraps)
state.selectPrevious();  // Move to previous option (wraps)

// Individual state declarations
private static final TextInputState FULL_NAME = new TextInputState("Ada");
private static final TextInputState EMAIL = new TextInputState("ada@example.com");
private static final TextInputState ROLE = new TextInputState("Research");

// Custom helper
private static Element formRow(String label, TextInputState state) {
    return row(
        text(label).dim().length(14),
        textInput(state).rounded().borderColor(Color.DARK_GRAY).fill()
    ).spacing(1).length(3);
}

// Usage
Element beforeExample1 = formRow("Full name", FULL_NAME);
Element beforeExample2 = formRow("Email", EMAIL);

// Centralized state
private static final FormState FORM_STATE = FormState.builder()
    .textField("fullName", "Ada")
    .textField("email", "ada@example.com")
    .textField("role", "Research")
    .build();

// Usage - no helper needed
Element afterExample1 = formField("Full name", FORM_STATE.textField("fullName"))
    .labelWidth(14).rounded().borderColor(Color.DARK_GRAY);
Element afterExample2 = formField("Email", FORM_STATE.textField("email"))
    .labelWidth(14).rounded().borderColor(Color.DARK_GRAY);