<?php
/**
 * Text field partial — single-line text / number / url / email input.
 *
 * Variables consumed:
 *   string       $name         — input name attribute (also used for id)
 *   string       $label        — visible label text
 *   string       $value        — current value (already htmlspecialchars'd by caller, or raw)
 *   string       $type         — input type; default 'text'
 *   bool         $required     — whether the field is required; default false
 *   string       $placeholder  — placeholder text; default ''
 *   string|null  $hint         — optional hint shown in <small> below the input
 *   string|null  $id           — override the id attribute (defaults to $name)
 *   array        $attrs        — extra HTML attributes as key=>value pairs (e.g. min/max for number)
 *
 * The partial does NOT call htmlspecialchars on $value — the caller is responsible.
 */

$type        = $type        ?? 'text';
$required    = $required    ?? false;
$placeholder = $placeholder ?? '';
$hint        = $hint        ?? null;
$id          = $id          ?? $name;
$attrs       = $attrs       ?? [];

$attrStr = '';
foreach ($attrs as $k => $v) {
    if ($v === true) {
        $attrStr .= ' ' . htmlspecialchars($k);
    } else {
        $attrStr .= ' ' . htmlspecialchars($k) . '="' . htmlspecialchars((string)$v) . '"';
    }
}
?>
<div>
    <label for="<?= htmlspecialchars($id) ?>"><?= htmlspecialchars($label) ?><?= $required ? ' <span class="asterisk">*</span>' : '' ?></label>
    <?php if ($hint): ?>
    <div>
        <input type="<?= htmlspecialchars($type) ?>"
               id="<?= htmlspecialchars($id) ?>"
               name="<?= htmlspecialchars($name) ?>"
               value="<?= $value ?>"
               <?= $required ? 'required' : '' ?>
               <?= $placeholder ? 'placeholder="' . htmlspecialchars($placeholder) . '"' : '' ?>
               <?= $attrStr ?>>
        <small><?= htmlspecialchars($hint) ?></small>
    </div>
    <?php else: ?>
    <input type="<?= htmlspecialchars($type) ?>"
           id="<?= htmlspecialchars($id) ?>"
           name="<?= htmlspecialchars($name) ?>"
           value="<?= $value ?>"
           <?= $required ? 'required' : '' ?>
           <?= $placeholder ? 'placeholder="' . htmlspecialchars($placeholder) . '"' : '' ?>
           <?= $attrStr ?>>
    <?php endif; ?>
</div>
<?php
// Reset consumed variables so includes in a loop don't bleed state.
unset($type, $required, $placeholder, $hint, $id, $attrs, $attrStr, $k, $v);
