html_utils.h

#ifndef HTML_UTILS_H
#define HTML_UTILS_H

#include <Arduino.h>

namespace HtmlUtils {

String escape(const String& s);

// <input type="text"> / "password" / "number"
String inputText(const String& name, const String& label, const String& value, int maxLen = 0);
String inputPassword(const String& name, const String& label, const String& placeholder = "");
String inputNumber(const String& name, const String& label, long value, long minVal, long maxVal);

// Radio group: pairs of (value, label) and a currently-selected value.
struct RadioOption {
  const char* value;
  const char* label;
};
String radioGroup(const String& name, const RadioOption* options, int count, const String& selectedValue);

// <select> with preset options + an optional "Custom" entry. If currentValue
// matches one of the options, that option is preselected; otherwise the
// Custom entry is preselected and currentValue is placed into the paired
// custom-text input (rendered separately via inputText).
String selectWithCustom(const String& name, const String& label,
                        const char* const* options, int count,
                        const String& currentValue,
                        const String& customOptionValue = "__custom__");

// Single labelled checkbox inside .checkbox-item.
String checkboxItem(const String& name, const String& label, bool checked);

} // namespace HtmlUtils

#endif