{# Pagination block. One file replaces the three near-identical
   copies (opportunities/_pagination, failures/_pagination, dashboard/
   _pagination).

   Two ``pagination`` shapes ship across the audit:

   1. ``AuditPaginationContext`` (opportunities, failures, layout_index)
      exposes ``query_string_without_page`` so any active filters
      round-trip through Prev/Next.
   2. ``PaginationContext`` from governor_core (dashboard cost-drivers)
      doesn't expose it; sort key/dir come through as the ``sort_by``
      / ``sort_dir`` template variables.

   The component handles both by preferring ``query_string_without_page``
   when present (even if empty - the attribute existing flags
   "the route already stitched filters into me") and falling back to
   ``sort_by`` / ``sort_dir`` otherwise.

   Required context:
     - pagination
   Optional context:
     - sort_by, sort_dir   (fallback only)
     - pagination_item_noun (string, default "results"). Set this on
       surfaces where the unit isn't generic - e.g. the opportunities
       table groups by ``affected_table`` and the dashboard's cost-
       drivers groups by ``destination_table`` / ``query_hash``. Using
       a precise noun stops users wondering why two numbers on the
       same page (this footer vs the summary card above) disagree.
#}
{%- set _noun = pagination_item_noun | default("results") -%}
{%- if pagination.query_string_without_page is defined -%}
  {%- set _qs = pagination.query_string_without_page -%}
  {%- set _sep = "&" if _qs else "" -%}
{%- else -%}
  {%- set _qs %}{% if sort_by %}sort={{ sort_by }}{% endif %}{% if sort_dir %}{% if sort_by %}&{% endif %}direction={{ sort_dir }}{% endif %}{% endset -%}
  {%- set _sep = "&" if _qs else "" -%}
{%- endif -%}
{% if pagination.total_items > 0 %}
<div class="flex items-center justify-between px-4 py-3 border-t border-slate-200 dark:border-slate-800">
  <p class="ui-type-body-sm text-slate-500 dark:text-slate-400">
    Showing <span class="text-slate-900 dark:text-slate-100">{{ pagination.start_index }}</span>
    to <span class="text-slate-900 dark:text-slate-100">{{ pagination.end_index }}</span>
    of <span class="text-slate-900 dark:text-slate-100">{{ pagination.total_items }}</span> {{ _noun }}
  </p>
  {% if pagination.total_pages > 1 %}
  <nav class="ui-pagination" aria-label="Pagination">
    {% if pagination.has_prev %}
      <a href="?{{ _qs }}{{ _sep }}page={{ pagination.page - 1 }}" class="ui-page-link">Prev</a>
    {% else %}
      <span class="ui-page-link ui-page-link-disabled">Prev</span>
    {% endif %}

    {% for p in pagination.page_range(2) %}
      {% if p == pagination.page %}
        <span class="ui-page-link ui-page-link-active" aria-current="page">{{ p }}</span>
      {% else %}
        <a href="?{{ _qs }}{{ _sep }}page={{ p }}" class="ui-page-link">{{ p }}</a>
      {% endif %}
    {% endfor %}

    {% if pagination.has_next %}
      <a href="?{{ _qs }}{{ _sep }}page={{ pagination.page + 1 }}" class="ui-page-link">Next</a>
    {% else %}
      <span class="ui-page-link ui-page-link-disabled">Next</span>
    {% endif %}
  </nav>
  {% endif %}
</div>
{% endif %}