{#- chirp-ui: Safe region / Fragment island primitives
    HTMX-safe mutation region that isolates local updates from inherited
    shell attributes (hx-select, hx-target, hx-swap). Use for add/delete/reorder
    regions inside app shells with hx-boost or broad hx-select.

    safe_region: Semantic name for the framework contract.
    fragment_island: Alias; use either.

    Usage:
        {% from "chirpui/fragment_island.html" import safe_region %}
        {% call safe_region("step-list") %}...{% end %}

        {% from "chirpui/fragment_island.html" import fragment_island %}
        {% call fragment_island("my-list", hx_target="#my-list", hx_swap="outerHTML") %}...{% end %}

        {% from "chirpui/fragment_island.html" import fragment_island_with_result %}
        {% call fragment_island_with_result("collections-results", "update-result", attrs='hx-get="/status" hx-trigger="load" hx-target="this" hx-swap="innerHTML"') %}
        ...forms with hx-target="#update-result"...
        {% end %}

        {% from "chirpui/fragment_island.html" import poll_trigger %}
        {{ poll_trigger("/status", "#collections-results", delay="2s") }}
-#}

{% def poll_trigger(url, target, delay=none, swap="innerHTML", select=none, cls="chirpui-sr-only", attrs="") %}
<button type="button"
        class="{{ cls }}"
        hidden
        tabindex="-1"
        hx-get="{{ url }}"
        hx-trigger="{{ "load delay:" ~ delay if delay else "load" }}"
        hx-target="{{ target }}"
        hx-swap="{{ swap }}"
        {% if select %}hx-select="{{ select }}"{% end %}
        aria-hidden="true"
        {{ attrs | safe }}></button>
{% end %}

{% def safe_region(
    id,
    hx_target=none,
    hx_swap=none,
    hx_select=none,
    cls="",
    attrs=""
) %}
{% set disinherit = "hx-select hx-target hx-swap" %}
<div id="{{ id }}"
     class="chirpui-fragment-island{{ " " ~ cls if cls else "" }}"
     hx-disinherit="{{ disinherit }}"
     {% if hx_target %}hx-target="{{ hx_target }}"{% end %}
     {% if hx_swap %}hx-swap="{{ hx_swap }}"{% end %}
     {% if hx_select %}hx-select="{{ hx_select }}"{% end %}
     {{ attrs | safe }}>
    {% slot %}
</div>
{% end %}

{% def fragment_island(
    id,
    hx_target=none,
    hx_swap=none,
    hx_select=none,
    cls="",
    attrs=""
) %}
{% call safe_region(id, hx_target=hx_target, hx_swap=hx_swap, hx_select=hx_select, cls=cls, attrs=attrs) %}
{{ caller() }}
{% end %}
{% end %}

{% def fragment_island_with_result(
    id,
    mutation_result_id,
    hx_target=none,
    hx_swap=none,
    hx_select=none,
    cls="",
    attrs=""
) %}
{% call safe_region(id, hx_target=hx_target, hx_swap=hx_swap, hx_select=hx_select, cls=cls, attrs=attrs) %}
<div id="{{ mutation_result_id }}" class="chirpui-fragment-island chirpui-mb-sm" aria-live="polite"></div>
{{ caller() }}
{% end %}
{% end %}