{#
  UOFastForms — Jinja2 macros for rendering WTForms forms with Bootstrap 5.

  Import in any template:
      {% from 'uofast_forms/form_macros.html' import render_form, render_field,
              render_mv_fieldlist, render_form_errors %}

  Macros
  ------
  render_form(form, ...)          Full <form> block with all fields + submit button
  render_field(field, ...)        Single Bootstrap 5 form-group for any scalar field
  render_mv_fieldlist(field, ...) Repeater UI for MVFieldList fields
  render_form_errors(form)        Bootstrap alert summarising all form errors
#}


{# -----------------------------------------------------------------------
   render_form_errors(form)
   Renders a dismissable Bootstrap 5 danger alert listing all field errors.
   Pass the form after validate() has been called.
   ----------------------------------------------------------------------- #}
{% macro render_form_errors(form) %}
  {% set all_errors = [] %}
  {% for field in form %}
    {% if field.errors %}
      {% for err in field.errors %}
        {% set label = field.label.text if field.label else field.name %}
        {% if all_errors.append((label, err)) %}{% endif %}
      {% endfor %}
    {% endif %}
  {% endfor %}
  {% if all_errors %}
    <div class="alert alert-danger alert-dismissible fade show" role="alert">
      <strong>Please correct the following errors:</strong>
      <ul class="mb-0 mt-1">
        {% for label, msg in all_errors %}
          <li>
            {% if label and not label.startswith('_') %}<strong>{{ label }}:</strong> {% endif %}
            {{ msg }}
          </li>
        {% endfor %}
      </ul>
      <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
    </div>
  {% endif %}
{% endmacro %}


{# -----------------------------------------------------------------------
   render_field(field, label_class, input_class, wrapper_class)
   Renders a single Bootstrap 5 mb-3 form group for any scalar WTForms field.
   MV FieldList fields should use render_mv_fieldlist() instead.

   Args:
     field         WTForms field object
     label_class   CSS class(es) for the <label> (default: "form-label")
     input_class   CSS class(es) for the <input> / <select> / <textarea>
                   (default: "form-control"; checkboxes use "form-check-input")
     wrapper_class CSS class(es) for the outer <div> (default: "mb-3")
   ----------------------------------------------------------------------- #}
{% macro render_field(field, label_class="form-label", input_class="form-control", wrapper_class="mb-3") %}
  {% if field.name.startswith('_') %}
    {# Hidden sentinel fields — render silently so their validators still fire #}
    {{ field(type="hidden") }}
  {% else %}
    {% set is_checkbox = field.type == "BooleanField" %}
    {% set is_hidden   = field.type == "HiddenField" %}
    {% set has_errors  = field.errors | length > 0 %}

    {% if is_hidden %}
      {{ field() }}
    {% elif is_checkbox %}
      <div class="{{ wrapper_class }} form-check">
        {{ field(class="form-check-input" + (" is-invalid" if has_errors else "")) }}
        {{ field.label(class="form-check-label") }}
        {% if field.description %}
          <div class="form-text text-muted">{{ field.description }}</div>
        {% endif %}
        {% for error in field.errors %}
          <div class="invalid-feedback d-block">{{ error }}</div>
        {% endfor %}
      </div>
    {% else %}
      <div class="{{ wrapper_class }}">
        {{ field.label(class=label_class) }}
        {# Linked-file lookup: wrap the input in an input-group with a 🔍 button #}
        {% set is_lookup = field.render_kw and field.render_kw.get('data-lookup-file') %}
        {% if field.type == "TextAreaField" or field.type == "MVTextAreaField" %}
          {{ field(class=input_class + (" is-invalid" if has_errors else ""), rows=4) }}
        {% elif field.type == "SelectField" %}
          {{ field(class="form-select" + (" is-invalid" if has_errors else "")) }}
        {% elif is_lookup %}
          <div class="input-group">
            {{ field(class=input_class + (" is-invalid" if has_errors else "")) }}
            <button type="button"
                    class="btn btn-outline-secondary uof-lookup-btn"
                    title="Browse {{ field.render_kw.get('data-lookup-file', '') }}">
              &#128269;
            </button>
          </div>
        {% else %}
          {{ field(class=input_class + (" is-invalid" if has_errors else "")) }}
        {% endif %}
        {% if field.description %}
          <div class="form-text text-muted">{{ field.description }}</div>
        {% endif %}
        {% for error in field.errors %}
          <div class="invalid-feedback d-block">{{ error }}</div>
        {% endfor %}
      </div>
    {% endif %}
  {% endif %}
{% endmacro %}


{# -----------------------------------------------------------------------
   render_mv_fieldlist(field, add_label, input_class, wrapper_class)
   Renders an MVFieldList as a dynamic add/remove repeater.
   Requires the companion JavaScript (uofast_forms.js) for add/remove
   to work client-side.

   Args:
     field         An MVFieldList WTForms field
     add_label     Label for the "Add row" button (default: "+ Add")
     input_class   CSS class for each row input (default: "form-control")
     wrapper_class CSS class for the outer container (default: "mb-3")
   ----------------------------------------------------------------------- #}
{% macro render_mv_fieldlist(field, add_label="+ Add", input_class="form-control", wrapper_class="mb-3") %}
  {% set has_errors = field.errors | length > 0 %}
  <div class="{{ wrapper_class }}">
    <label class="form-label">{{ field.label.text }}</label>
    {% if field.description %}
      <div class="form-text text-muted mb-1">{{ field.description }}</div>
    {% endif %}

    <div class="uof-mv-list" data-fieldlist="{{ field.name }}">
      {% for entry in field.entries %}
        <div class="uof-mv-row input-group mb-1">
          {% if entry.value.type == "SelectField" %}
            {{ entry.value(class="form-select") }}
          {% else %}
            {{ entry.value(class=input_class) }}
          {% endif %}
          <button type="button" class="btn btn-outline-danger uof-mv-remove"
                  aria-label="Remove row"
                  {% if loop.length <= 1 %}disabled{% endif %}>
            &times;
          </button>
        </div>
        {% for error in entry.value.errors %}
          <div class="text-danger small">{{ error }}</div>
        {% endfor %}
      {% endfor %}
    </div>

    <button type="button"
            class="btn btn-outline-secondary btn-sm mt-1 uof-mv-add"
            data-fieldlist="{{ field.name }}"
            data-prefix="{{ field.name }}">
      {{ add_label }}
    </button>

    {% for error in field.errors %}
      <div class="text-danger small mt-1">{{ error }}</div>
    {% endfor %}
  </div>
{% endmacro %}


{# -----------------------------------------------------------------------
   render_form(form, action, method, submit_label, css_class, enctype)
   Renders the full <form> element with all fields and a submit button.
   MVFieldList fields are automatically dispatched to render_mv_fieldlist().
   Sentinel hidden fields are rendered silently.

   Args:
     form          WTForms Form instance
     action        form action URL (default: "")
     method        HTTP method (default: "POST")
     submit_label  Submit button text (default: "Save")
     css_class     Additional CSS classes on <form> (default: "")
     enctype       <form enctype> (default: "" — omitted unless set)
   ----------------------------------------------------------------------- #}
{% macro render_form(form, action="", method="POST", submit_label="Save", css_class="", enctype="") %}
  <form
    method="{{ method }}"
    action="{{ action }}"
    {% if css_class %}class="{{ css_class }}"{% endif %}
    {% if enctype %}enctype="{{ enctype }}"{% endif %}
    novalidate
  >
    {{ render_form_errors(form) }}

    {% for field in form %}
      {% if field.name == '_remote_validation_sentinel' %}
        {# Render hidden so the validator fires; never show to user #}
        {{ field(type="hidden") }}
      {% elif field.type == "MVFieldList" %}
        {{ render_mv_fieldlist(field) }}
      {% else %}
        {{ render_field(field) }}
      {% endif %}
    {% endfor %}

    <div class="mt-3">
      <button type="submit" class="btn btn-primary">{{ submit_label }}</button>
    </div>
  </form>
{% endmacro %}