{# =========================================================================
   Shared confirm-dialog macro.

   Renders the DaisyUI <dialog id="confirm-dialog"> that /ui/js/confirm.js
   drives, plus the (cache-busted, deferred) script tag itself. Call it ONCE
   per page, in the page's scripts block:

       {% from "macros/confirm.html" import confirm_dialog %}
       {% block page_scripts %}{{ confirm_dialog() }}{% endblock %}

   Then put data-confirm="Prompt text" on any <form>, or on the submit
   button whose click needs its own wording. HTMX-driven forms (hx-* on the
   <form>) must carry the prompt on the FORM — htmx:confirm only sees the
   element issuing the request, so a prompt on a descendant button would
   silently never fire. See confirm.js for the full contract.

   Never use bare confirm() (unstyled, unthemed) or inline onclick=
   handlers (JS context that autoescape cannot protect) — this macro is the
   ecosystem's single confirmation mechanism.

   Parameters
   ----------
   title        : str — dialog heading (default 'Are you sure?').
   ok_label     : str — confirm-button text (default 'Yes, do it').
   cancel_label : str — cancel-button text (default 'Cancel').
   ok_class     : str — DaisyUI variant for the confirm button (default
                        'btn-primary'; destructive pages pass 'btn-error').
   ========================================================================= #}
{% macro confirm_dialog(title='Are you sure?', ok_label='Yes, do it',
                        cancel_label='Cancel', ok_class='btn-primary') %}
<dialog id="confirm-dialog" class="modal">
    <div class="modal-box">
        <h3 class="font-bold text-lg">{{ title }}</h3>
        <p class="py-4" id="confirm-message"></p>
        <div class="modal-action">
            <button type="button" class="btn btn-ghost" id="confirm-cancel">{{ cancel_label }}</button>
            <button type="button" class="btn {{ ok_class }}" id="confirm-ok">{{ ok_label }}</button>
        </div>
    </div>
    {# DaisyUI backdrop-close: clicking outside the modal-box submits this
       dialog-method form, which closes the dialog and fires the same `close`
       event the cancel path uses — confirm.js clears its pending state. #}
    <form method="dialog" class="modal-backdrop"><button>close</button></form>
</dialog>
<script src="/ui/js/confirm.js?v={{ static_v|default('') }}" defer></script>
{% endmacro %}