{{-- Monthly cards — one card per month of the quarter, each showing THAT MONTH ONLY.
     The headline percentage is the month's throughput: the stories moved to Completed
     (BA UAT / PO UAT / Done) during the month ÷ the stories that moved into In QA during it.
     Both halves are Jira transitions inside the month, so a closed month never changes again;
     the current month is the only one still moving, and months that haven't started render
     blank. Above 100% is real and expected — it means the month cleared stories that entered
     QA earlier.

     Those figures cover the quarter's CONFIRMED TARGETS only, so the percentage reads against
     the commitment. `outside_completed` reports the month's QA sign-offs on stories that were
     never committed as targets — beside the percentage, never inside it.

     Params: $months (rows from QaLoadService::monthlyCohort or the roll-up),
             $stages (key => ['cls','color']), $stageLabels (key => label). --}}
@php
  // The bar spans everything the month touched: the completions, plus the stories that
  // entered QA and were still there at month end.
  $touched = fn ($m) => array_sum($m['buckets']);
@endphp
<div class="ms-cards">
  @foreach ($months as $m)
    @php
      $noTargets = ! $m['in_qa'] && ! $m['signed_off'];
      // "Blank" only when nothing at all happened — non-target sign-offs still count as QA
      // having worked, so a month with those is not an empty month.
      $blank = ! empty($m['future']) || ($noTargets && empty($m['outside_completed']));
    @endphp
    <div class="ms-card {{ $blank ? 'ms-none' : '' }}">
      <div class="ms-card-head">
        <span class="ms-card-month">{{ $m['label'] }}</span>
        @if (empty($m['future']) && empty($m['closed']))
          <span class="ms-open" title="This month is still in progress — its figures move until it closes">in progress</span>
        @endif
        @if ($m['stale'])<span class="ms-stale" title="Jira was unreachable — showing the last stored figures">stale</span>@endif
      </div>

      @if (! empty($m['future']))
        {{-- Nothing has happened in it yet, and nothing is carried into it. --}}
        <div class="ms-pct">—</div>
        <div class="ms-pct-sub">not started yet</div>
        <div class="ms-bar"><span class="ms-bar-empty"></span></div>
      @elseif ($blank)
        <div class="ms-pct">—</div>
        <div class="ms-pct-sub">no QA movement this month</div>
        <div class="ms-bar"><span class="ms-bar-empty"></span></div>
      @elseif ($noTargets)
        {{-- QA worked, but on nothing that was committed as a target this quarter. --}}
        <div class="ms-pct">—</div>
        <div class="ms-pct-sub">no target movement this month</div>
        <div class="ms-bar"><span class="ms-bar-empty"></span></div>
      @else
        @if ($m['in_qa'])
          <div class="ms-pct" title="{{ $m['signed_off'] }} stories moved to Completed in {{ $m['label'] }} ÷ {{ $m['in_qa'] }} that entered In QA in {{ $m['label'] }}">{{ $m['percent'] }}%</div>
        @else
          {{-- Completions but no intake: a percentage would have no denominator. --}}
          <div class="ms-pct" style="font-size:1.4rem">{{ $m['signed_off'] }} done</div>
        @endif
        <div class="ms-pct-sub">
          <strong>{{ $m['signed_off'] }}</strong> moved to Completed
          @if ($m['in_qa'])
            · <strong>{{ $m['in_qa'] }}</strong> entered In QA
          @else
            <span class="muted">· none entered In QA</span>
          @endif
        </div>
        @php
          $notes = [];
          if ($m['buckets']['still_in_qa']) {
              $notes[] = $m['buckets']['still_in_qa'].' still in QA at month end';
          }
          // Why the percentage can read above 100%.
          if ($m['signed_off'] > $m['in_qa']) {
              $notes[] = ($m['signed_off'] - $m['in_qa']).' completed here entered QA earlier';
          }
        @endphp
        @if ($notes)
          <div class="ms-pct-sub ms-thismonth">{{ implode(' · ', $notes) }}</div>
        @endif
        @if (! empty($m['targets_in_scope']))
          {{-- The month's own completions read against the commitment that existed by then. --}}
          <div class="ms-pct-sub" title="{{ $m['signed_off'] }} completed in {{ $m['label'] }} ÷ {{ $m['targets_in_scope'] }} targets created in Jira by the end of {{ $m['label'] }}">
            <strong>{{ $m['percent_of_targets'] }}%</strong> of the {{ $m['targets_in_scope'] }} targets in scope
            <span class="muted">· this month</span>
          </div>
          @if (! empty($m['new_targets']))
            <div class="ms-pct-sub muted" title="Targets created in Jira during {{ $m['label'] }} — scope this month added">
              ✚ {{ $m['new_targets'] }} new target{{ $m['new_targets'] === 1 ? '' : 's' }} created this month
            </div>
          @endif
        @endif
        <div class="ms-bar" title="{{ $m['label'] }} — where the stories it touched ended the month">
          @foreach ($stages as $key => $s)
            @if ($m['buckets'][$key] > 0)
              <span class="{{ $s['cls'] }}" style="width:{{ 100 * $m['buckets'][$key] / $touched($m) }}%"
                    title="{{ $stageLabels[$key] }}: {{ $m['buckets'][$key] }}"></span>
            @endif
          @endforeach
        </div>
        <div class="ms-legend">
          @foreach ($stages as $key => $s)
            @if ($m['buckets'][$key] > 0)
              <span><i style="background:{{ $s['color'] }}"></i>{{ $stageLabels[$key] }} {{ $m['buckets'][$key] }}</span>
            @endif
          @endforeach
        </div>
      @endif

      @if (! empty($m['outside_completed']))
        {{-- QA sign-offs on stories that were never committed as targets. Counted apart from
             the percentage above, which is deliberately "of the commitment". --}}
        <div class="ms-pct-sub ms-outside"
             title="{{ $m['outside_completed'] }} stor{{ $m['outside_completed'] === 1 ? 'y' : 'ies' }} moved out of In QA into a completed status in {{ $m['label'] }} but are not confirmed targets of this quarter — real QA work, outside the commitment">
          ✚ <strong>{{ $m['outside_completed'] }}</strong> completed outside the target list
        </div>
      @endif

      @if (empty($m['future']))
        <div class="ms-bugline">
          <span class="ms-bugpill">{{ $m['bugs_filed'] }}</span>
          bug{{ $m['bugs_filed'] === 1 ? '' : 's' }} filed
          @if ($m['bugs_filed']) <span class="muted">· {{ $m['bugs_closed'] }} closed</span> @endif
        </div>
        @if (! empty($m['subtasks_created']))
          <div class="ms-bugline" style="border-top:0;padding-top:0;margin-top:.3rem">
            <span class="ms-subpill">{{ $m['subtasks_created'] }}</span>
            sub-task{{ $m['subtasks_created'] === 1 ? '' : 's' }} raised
            <span class="muted">· {{ $m['subtasks_done'] }} done</span>
          </div>
        @endif
      @endif
    </div>
  @endforeach
</div>