<?php

declare(strict_types=1);

/**
 * Einheitliches Formularfeld — EINZIGE Quelle für Feld-Markup aller Formulare.
 *
 * Props: $field (array):
 *   type         text | email | tel | select | textarea | checkbox (Default: text)
 *   name, label  Pflicht
 *   id           Default: field-<name>
 *   required     bool
 *   autocomplete, maxlength, rows (textarea)
 *   options[]    + placeholder (select)
 *   hint         optionaler Hilfetext (aria-describedby)
 *   label_html   NUR für vertrauenswürdiges Markup aus Komponenten-Code
 *                (z. B. Datenschutz-Link im Checkbox-Label) — nie Nutzereingaben!
 *
 * Jedes Feld bekommt ein Fehler-Element (#<id>-error, aria-describedby): serverseitig
 * gefüllt beim 422-Re-Render (form_field_error()), sonst von form.js mit der
 * Browser-Validierungsmeldung. Eingaben aus einem abgewiesenen POST schreibt
 * form_old() zurück — deshalb gehen Werte auch ohne JS nie verloren.
 */
$type = $field['type'] ?? 'text';
$name = $field['name'];
$id = $field['id'] ?? 'field-' . $name;
$required = !empty($field['required']);
$errorId = $id . '-error';
$hintId = $id . '-hint';
$describedBy = (!empty($field['hint']) ? $hintId . ' ' : '') . $errorId;
$old = form_old($name);
$fieldError = form_field_error($id);

// Sichtbarer roter Stern (aria-hidden) + pro Feld erklärendes Pflicht-Wort für
// Screenreader — ersetzt die frühere globale „Pflichtfelder mit *"-Hinweiszeile.
$requiredMark = $required
    ? ' <span class="form__required" aria-hidden="true">*</span><span class="visually-hidden"> (Pflichtfeld)</span>'
    : '';

$commonAttrs = 'name="' . e($name) . '" id="' . e($id) . '"'
    . ($required ? ' required' : '')
    . ' aria-describedby="' . e($describedBy) . '"'
    . (!empty($field['autocomplete']) ? ' autocomplete="' . e($field['autocomplete']) . '"' : '')
    . (!empty($field['maxlength']) ? ' maxlength="' . e($field['maxlength']) . '"' : '')
    . (isset($field['min']) ? ' min="' . e((string) $field['min']) . '"' : '')
    . (isset($field['max']) ? ' max="' . e((string) $field['max']) . '"' : '')
    . ($fieldError !== '' ? ' aria-invalid="true"' : '');
?>
<?php if ($type === 'checkbox'): ?>
                    <div class="form__field form__field--checkbox">
                        <input type="checkbox" <?= $commonAttrs ?> value="1"<?= $old === '1' ? ' checked' : '' ?>>
                        <label for="<?= e($id) ?>"><?= $field['label_html'] ?? e($field['label']) ?><?= $requiredMark ?></label>
                        <p class="form__error-msg" id="<?= e($errorId) ?>"<?= $fieldError === '' ? ' hidden' : '' ?>><?= e($fieldError) ?></p>
                    </div>
<?php else: ?>
                    <div class="form__field">
                        <label for="<?= e($id) ?>"><?= e($field['label']) ?><?= $requiredMark ?></label>
<?php if ($type === 'select'): ?>
                        <select <?= $commonAttrs ?>>
                            <option value=""><?= e($field['placeholder'] ?? 'Bitte wählen') ?></option>
<?php foreach ($field['options'] as $option): ?>
                            <option value="<?= e($option) ?>"<?= $old !== '' && $old === (string) $option ? ' selected' : '' ?>><?= e($option) ?></option>
<?php endforeach; ?>
                        </select>
<?php elseif ($type === 'textarea'): ?>
                        <textarea <?= $commonAttrs ?> rows="<?= e($field['rows'] ?? 6) ?>" placeholder=" "><?= e($old) ?></textarea>
<?php else: ?>
                        <input type="<?= e($type) ?>" <?= $commonAttrs ?> value="<?= e($old) ?>" placeholder=" ">
<?php endif; ?>
<?php if (!empty($field['hint'])): ?>
                        <p class="form__hint" id="<?= e($hintId) ?>"><?= e($field['hint']) ?></p>
<?php endif; ?>
                        <p class="form__error-msg" id="<?= e($errorId) ?>"<?= $fieldError === '' ? ' hidden' : '' ?>><?= e($fieldError) ?></p>
                    </div>
<?php endif; ?>
