{#
    SAM Section Header Component - Colored bar header for sections

    Parameters:
    - label: string (required) - Section label text
    - entity: string - Entity type for color: 'users', 'cohorts', 'courses', 'activities', 'stats'
    - title: string - Optional main title below the header
    - subtitle: string - Optional subtitle (HTML allowed)
    - action: object - Optional action button {text/label, url, icon, dataAction}

    Usage:
    {% include 'sam/_components/section_header.html.twig' with {label: 'Stagiaires', entity: 'users'} %}

    {% include 'sam/_components/section_header.html.twig' with {
        label: 'Progression',
        entity: 'courses',
        title: 'Comment progressent-ils ?',
        subtitle: 'Trié par complétion',
        action: {text: 'Voir les formations', url: path('app_sam_courses'), icon: 'book'}
    } %}

    {% include 'sam/_components/section_header.html.twig' with {
        label: 'Membres',
        entity: 'users',
        title: 'Membres de la cohorte',
        action: {label: 'Ajouter', dataAction: 'click->controller#method'}
    } %}
#}

{% set entityType = entity|default('stats') %}

<div class="sam-section__header">
    <span class="sam-section__bar sam-section__bar--{{ entityType }}"></span>
    <span class="sam-section__label sam-section__label--{{ entityType }}">{{ label }}</span>
</div>

{% if title is defined or action is defined %}
<div class="sam-section__title-row">
    {% if title is defined %}
    <div>
        <h2 class="sam-section__title">{{ title }}</h2>
        {% if subtitle is defined %}
        <p class="sam-section__subtitle">{{ subtitle|raw }}</p>
        {% endif %}
    </div>
    {% endif %}

    {% if action is defined %}
        {% if action.dataAction is defined %}
            {# Button with Stimulus data-action #}
            <button type="button" class="sam-btn sam-btn--primary sam-btn--sm" data-action="{{ action.dataAction }}">
                {% if action.icon is defined %}
                    {% include 'sam/_components/icon.html.twig' with {name: action.icon, size: 14} %}
                {% else %}
                    <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
                        <path d="M12 5v14M5 12h14"/>
                    </svg>
                {% endif %}
                {{ action.label|default(action.text|default('Action')) }}
            </button>
        {% else %}
            {# Link button #}
            <a href="{{ action.url }}" class="sam-btn sam-btn--outline">
                {% if action.icon is defined %}
                    {% include 'sam/_components/icon.html.twig' with {name: action.icon, size: 16} %}
                {% endif %}
                {{ action.text|default(action.label|default('Action')) }}
            </a>
        {% endif %}
    {% endif %}
</div>
{% endif %}