{% load i18n %}
{% comment %}
Shared site header (ADR-113 / BR-BW-TPL-008): family-neutral public chrome
for brand, primary nav and header actions. Canonical classes are
.bw-site-header and its BEM children. Docs outer seams and any non-marketing
surface that needs the same band and measure consume this include with
.bw-site-* only (no .bw-marketing-* skin; ADR-090).

The marketing shell ships the same .bw-site-* classes (4.0.0 closed the
dual-class marketing alias window). Overlay (ADR-105 / BR-BW-MKT-006) stays
on the marketing shell path only.

Django {% include %} cannot expose named blocks to a parent that extends
a shell. The marketing shell therefore keeps brand_logo, brand_wordmark,
marketing_nav, marketing_actions and the *_region seams in
brickwork_marketing/shell/marketing.html (markup mirroring this file).
Docs and other consumers include this file (typically by overriding
docs_site_header_region so the landmark is not nested inside
.bw-docs-site-header), or author the same .bw-site-* class pair by hand.

Optional context when including:
  site_header_modifiers  extra classes on <header> (e.g. a consumer-owned
                         sticky variant). Empty by default. Do not put
                         bw-site-header--overlay here on a docs page;
                         overlay is marketing-shell-only.
  site_header_attrs      extra attributes on <header> (include a leading
                         space), e.g. data attributes.

Named blocks (semver-public when this template is {% extends %}d,
BR-BW-TPL-001), all empty-graceful:
  brand_logo       wrapped in .bw-site-header__brand-mark
  brand_wordmark   wrapped in .bw-site-header__brand-wordmark
  site_nav         primary public nav inside <nav aria-label="Primary">
  site_actions     header-end CTA cluster
  site_nav_region / site_actions_region
                   outer override seams mirroring marketing's
                   marketing_nav_region / marketing_actions_region

When {% include %}d, blocks render their defaults only; put brand/nav/
actions markup inside the include call site's surrounding blocks, or
extend this template.

States: none of its own. Pair with
  brickwork_marketing/components/_mobile_nav_toggle.html on a marketing
  surface (sibling of __nav / __actions) when a mobile collapse is needed;
  that toggle's CSS keys off .bw-site-header__nav / __actions.
Accessibility: <header> landmark; primary nav is
  <nav aria-label="Primary"> unless site_nav_region is overridden empty.
Responsive: flex-wrap brand row; package CSS in shell.css.
{% endcomment %}
<header class="bw-site-header{% if site_header_modifiers %} {{ site_header_modifiers }}{% endif %}"{% if site_header_attrs %}{{ site_header_attrs }}{% endif %}>
  <div class="bw-site-header__inner">
    <div class="bw-site-header__brand">
      <span class="bw-site-header__brand-mark">{% block brand_logo %}{% endblock %}</span>
      <span class="bw-site-header__brand-wordmark">{% block brand_wordmark %}{% endblock %}</span>
      {% block site_nav_region %}
      <nav class="bw-site-header__nav" aria-label="{% translate 'Primary' %}">
        {% block site_nav %}{% endblock %}
      </nav>
      {% endblock %}
      {% block site_actions_region %}
      <div class="bw-site-header__actions">
        {% block site_actions %}{% endblock %}
      </div>
      {% endblock %}
    </div>
  </div>
</header>