steppy-dev 0.3.0__py3-none-any.whl

steppy/templates/test_scenario.py.j2

@@ -0,0 +1,767 @@
+"""
+Auto-generated by Steppy from: {{ scenario.file_path | string | replace("\\", "/") }}
+Do not edit manually — changes will be overwritten.
+Re-generate with: steppy generate
+
+Title: {{ scenario.title | docstring }}
+{% if scenario.description -%}
+Description: {{ scenario.description | docstring }}
+{% endif -%}
+{% if scenario.tags -%}
+Tags: {{ scenario.tags | join(', ') | docstring }}
+{% endif -%}
+{% if scenario.priority -%}
+Priority: {{ scenario.priority | docstring }}
+{% endif -%}
+"""
+import re
+import time
+
+import pytest
+from playwright.sync_api import Page, expect
+
+from .conftest import _assert_stays_hidden, _wait_until, _when, call_helper, take_screenshot_with_bbox, take_fillform_frames, take_fillform_progressive_frames, _safe_bbox, _safe_bbox_scrolled, _safe_bbox_locator, fill_login_credentials, capture, capture_dom, synthetic_click, _resolve_date, _pick_date, _pick_time, _interp, _interp_val, SKIP_ASSERTS, _step_runs, _steppy_mark_step, _steppy_end_step
+{% if tour_replay %}
+from ._steppy_tours import TourProbe, _tour_start, _tour_expect_step, _tour_ensure_advanced, _tour_expect_complete
+{% endif %}
+
+SCENARIO = "{{ scenario.slug }}"
+SCENARIO_LAYOUTS = {% if scenario.layouts %}{{ scenario.layouts | tojson }}{% else %}None{% endif %}
+{% macro disambig_locator(role, selector, step) -%}
+{{ role }}_page{% if step.within %}.locator(_interp({{ step.within | pystr }}, _vars)){% endif %}.locator(_interp({{ selector | pystr }}, _vars)){{ step.match | format_match_suffix }}
+{%- endmacro %}
+{#
+  One screenshot capture, guarded.
+
+  Every interactive action repeats the same scaffold: capture `_bbox`, emit a
+  pre-action shot when `screenshot-when: before`, run the action, emit a
+  post-action shot otherwise. This macro owns the guard and the kwargs so a new
+  action writes two `shot(...)` lines instead of copy-pasting eight.
+
+  `when` is "before" or "after" and is matched against the step's
+  `screenshot-when`. `selector`/`bbox`/`highlight` control the optional kwargs —
+  omitted entirely when falsy, which is what keeps output byte-identical for
+  the actions that never passed them.
+#}
+{% macro shot(step, action, when, selector=None, bbox=False, highlight=False) -%}
+{% if step | emits_screenshot and ((when == "before") == (step.screenshot_when == "before")) %}
+    take_screenshot_with_bbox({{ step.role }}_page, SCENARIO, {{ step.step_number }}, "{{ action }}"{% if selector is not none %}, selector={{ selector | pystr }}{% endif %}{% if bbox %}, precaptured_bbox=_bbox{% endif %}{% if highlight %}, highlight=True{% endif %})
+{% endif %}
+{%- endmacro %}
+{#
+  The assertion body, shared by the two places an `expect:` can appear:
+  a standalone `- action: assert` step, and an `expect:` riding on another
+  action (click, fill, …). Both emit the same 13 assertion types; only the
+  locator differs, so each call site passes its own `loc` in.
+
+  IMPORTANT: the trailing-expect site must pass the plain locator, NOT
+  disambig_locator's output. `within:`/`match:` disambiguate the *action's*
+  target; routing the assertion through them would silently retarget the
+  assertion of any step carrying both `within:` and `expect:`.
+
+  `unknown_comment` reproduces the standalone site's extra comment line on the
+  fallback branch.
+#}
+{% macro assert_body(role, assertion, loc, timeout, toast_timeout, unknown_comment) -%}
+{% if assertion.type == "toast" %}
+        expect({{ role }}_page.locator(_interp({{ ('text="' ~ assertion.message ~ '"') | pystr }}, _vars)){% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %}).to_be_visible(timeout={{ toast_timeout }})
+{% elif assertion.type == "visible" %}
+        expect({{ loc }}{% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %}).to_be_visible(timeout={{ timeout }})
+{% elif assertion.type == "hidden" %}
+        expect({{ loc }}{% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %}).to_be_hidden(timeout={{ timeout }})
+{% elif assertion.type == "text" %}
+        expect({{ loc }}{% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %}).to_have_text(_interp({{ assertion.text | pystr }}, _vars), timeout={{ timeout }})
+{% elif assertion.type == "contains" %}
+        expect({{ loc }}{% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %}).to_contain_text(_interp({{ assertion.text | pystr }}, _vars), timeout={{ timeout }})
+{% elif assertion.type == "url-contains" %}
+        expect({{ role }}_page{% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %}).to_have_url(re.compile(r".*" + {{ assertion.path | pystr }} + r".*"), timeout={{ timeout }})
+{% elif assertion.type == "count" %}
+        expect({{ loc }}{% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %}).to_have_count({{ assertion.count }}, timeout={{ timeout }})
+{% elif assertion.type == "count-cmp" %}
+        _n = {{ loc }}.count()
+{% if assertion.fail_message %}
+        assert _n {{ assertion.comparator }} {{ assertion.count }}, _interp({{ assertion.fail_message | pystr }}, _vars) + f" (count was {_n})"
+{% else %}
+        assert _n {{ assertion.comparator }} {{ assertion.count }}, f"expected count {{ assertion.comparator }} {{ assertion.count }}, got {_n}"
+{% endif %}
+{% elif assertion.type == "row-contains" %}
+        expect({{ role }}_page.locator(_interp({{ ('text="' ~ assertion.text ~ '"') | pystr }}, _vars)){% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %}).to_be_visible(timeout={{ timeout }})
+{% elif assertion.type == "value" %}
+        expect({{ loc }}{% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %}).to_have_value(_interp({{ assertion.text | pystr }}, _vars), timeout={{ timeout }})
+{% elif assertion.type == "attribute" %}
+        expect({{ loc }}{% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %}).to_have_attribute({{ assertion.attribute | pystr }}, _interp({{ assertion.text | pystr }}, _vars), timeout={{ timeout }})
+{% elif assertion.type == "not-contains" %}
+        expect({{ loc }}{% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %}).not_to_contain_text(_interp({{ assertion.text | pystr }}, _vars), timeout={{ timeout }})
+{% elif assertion.type == "not-visible" %}
+        expect({{ loc }}{% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %}).not_to_be_visible(timeout={{ timeout }})
+{% elif assertion.type == "icontains" %}
+        expect({{ loc }}{% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %}).to_contain_text(re.compile(re.escape(_interp({{ assertion.text | pystr }}, _vars)), re.IGNORECASE), timeout={{ timeout }})
+{% elif assertion.type == "checked" %}
+        expect({{ loc }}{% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %}).to_be_checked(timeout={{ timeout }})
+{% elif assertion.type == "unchecked" %}
+        expect({{ loc }}{% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %}).to_be_checked(checked=False, timeout={{ timeout }})
+{% elif assertion.type == "stays-hidden" %}
+        _assert_stays_hidden({{ loc }}, {{ assertion.duration | timeout_ms }}{% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %})
+{% elif assertion.type == "not-empty" %}
+        expect({{ loc }}{% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %}).not_to_be_empty(timeout={{ timeout }})
+{% elif assertion.type == "disabled" %}
+        expect({{ loc }}{% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %}).to_be_disabled(timeout={{ timeout }})
+{% elif assertion.type == "enabled" %}
+        expect({{ loc }}{% if assertion.fail_message %}, message=_interp({{ assertion.fail_message | pystr }}, _vars){% endif %}).to_be_enabled(timeout={{ timeout }})
+{% else %}
+{% if unknown_comment %}
+        # Unknown assertion: {{ unknown_comment }}
+{% endif %}
+        pass
+{% endif %}
+{%- endmacro %}
+{#
+  The code for one step, shared by the scenario test and (for opted-in
+  scenarios) the in-app tour replay, so the two can never diverge. Renders
+  exactly what the former inline `{% set body %}` block rendered.
+#}
+{% macro step_body(step) %}
+{% if step.action == "navigate" %}
+{% if step.reload %}
+    {{ step.role }}_page.reload({{ step | call_kwargs(scenario, config, False) }})
+{% else %}
+    {{ step.role }}_page.goto(_interp({{ step.target | pystr }}, _vars){{ step | call_kwargs(scenario, config) }})
+{% endif %}
+{% set _nav_wait = step.wait or config.timing.navigate_wait %}
+{% if _nav_wait != "none" %}
+    {{ step.role }}_page.wait_for_load_state("{{ _nav_wait }}")
+{% endif %}
+{% if step | emits_screenshot %}
+    take_screenshot_with_bbox({{ step.role }}_page, SCENARIO, {{ step.step_number }}, "navigate")
+{% endif %}
+
+{%- elif step.action == "click" %}
+{% if step | emits_screenshot %}
+{% if step.within or step.match %}
+    _bbox = _safe_bbox_locator({{ step.role }}_page, {{ disambig_locator(step.role, step.selector, step) }})
+{% else %}
+    _bbox = _safe_bbox_scrolled({{ step.role }}_page, _interp({{ step.selector | pystr }}, _vars))
+{% endif %}
+{{ shot(step, "click", "before", step.selector, True, True) -}}
+{% endif %}
+{% if step.synthetic %}
+{% if step.within or step.match %}
+    synthetic_click({{ disambig_locator(step.role, step.selector, step) }})
+{% else %}
+    synthetic_click({{ step.role }}_page.locator(_interp({{ step.selector | pystr }}, _vars)))
+{% endif %}
+{% else %}
+{% if step.within or step.match %}
+    {{ disambig_locator(step.role, step.selector, step) }}.click({{ step | call_kwargs(scenario, config, False) }})
+{% else %}
+    {{ step.role }}_page.click(_interp({{ step.selector | pystr }}, _vars){{ step | call_kwargs(scenario, config) }})
+{% endif %}
+{% endif %}
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+{{ shot(step, "click", "after", step.selector, True, True) -}}
+
+{%- elif step.action == "login" %}
+    fill_login_credentials({{ step.role }}_page, "{{ step.role }}")
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+
+{%- elif step.action == "fill" %}
+{% if step | emits_screenshot %}
+    _bbox = _safe_bbox_scrolled({{ step.role }}_page, _interp({{ step.selector | pystr }}, _vars))
+{{ shot(step, "fill", "before", step.selector, True, False) -}}
+{% endif %}
+{% if step.clear or step.sequential or step.blur_key %}
+{% if step.within or step.match %}
+    _el = {{ disambig_locator(step.role, step.selector, step) }}
+{% else %}
+    _el = {{ step.role }}_page.locator(_interp({{ step.selector | pystr }}, _vars))
+{% endif %}
+    _el.click()
+{% if step.clear %}
+    _el.press("ControlOrMeta+A")
+    _el.press("Delete")
+{% endif %}
+{% if step.sequential %}
+    _el.press_sequentially(_interp({{ step.value | pystr }}, _vars), delay=50)
+{% else %}
+    _el.fill(_interp({{ step.value | pystr }}, _vars))
+{% endif %}
+{% if step.blur_key %}
+    {{ step.role }}_page.keyboard.press({{ step.blur_key | pystr }})
+{% endif %}
+{% else %}
+{% if step.within or step.match %}
+    {{ disambig_locator(step.role, step.selector, step) }}.fill(_interp_val({{ step.value | pystr }}, _vars){{ step | call_kwargs(scenario, config) }})
+{% else %}
+    {{ step.role }}_page.fill(_interp({{ step.selector | pystr }}, _vars), _interp_val({{ step.value | pystr }}, _vars){{ step | call_kwargs(scenario, config) }})
+{% endif %}
+{% endif %}
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+{{ shot(step, "fill", "after", step.selector, True, False) -}}
+
+{%- elif step.action == "fill-form" %}
+{% if step.interactive_progressive %}
+{# Progressive capture: the helper fills fields itself, one at a time, with a
+   single-target cursor sidecar per frame. Emits one frame per field plus a
+   final settled "all filled" frame. Always captures (the helper interleaves
+   capture + fill internally). screenshot-when is ignored here — progressive
+   capture is inherently before+after on every field. #}
+{% if step | emits_screenshot %}
+    _form_fields = [{% for selector, value in step.fields.items() %}(_interp({{ selector | pystr }}, _vars), _interp({{ value | pystr }}, _vars)){% if not loop.last %}, {% endif %}{% endfor %}]
+    take_fillform_progressive_frames({{ step.role }}_page, SCENARIO, {{ step.step_number }}, _form_fields)
+{% else %}
+{# Even without screenshots, the page still needs the fields filled. #}
+{% for selector, value in step.fields.items() %}
+    {{ step.role }}_page.fill(_interp({{ selector | pystr }}, _vars), _interp({{ value | pystr }}, _vars))
+{% endfor %}
+{% endif %}
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+{% else %}
+{% if step | emits_screenshot %}
+    _form_selectors = [{% for selector in step.fields.keys() %}_interp({{ selector | pystr }}, _vars){% if not loop.last %}, {% endif %}{% endfor %}]
+{% if step.screenshot_when == "before" %}
+    # Capture the empty form BEFORE filling, so the guide cursor animates over
+    # pristine fields rather than pre-filled values.
+    take_fillform_frames({{ step.role }}_page, SCENARIO, {{ step.step_number }}, _form_selectors)
+{% endif %}
+{% endif %}
+{% for selector, value in step.fields.items() %}
+    {{ step.role }}_page.fill(_interp({{ selector | pystr }}, _vars), _interp({{ value | pystr }}, _vars))
+{% endfor %}
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+{% if step | emits_screenshot and step.screenshot_when != "before" %}
+    # Take as many frames as the form height requires so every field ends up
+    # fully in-viewport in at least one screenshot. The helper auto-detects
+    # coverage and emits frames -a, -b, -c, …
+    take_fillform_frames({{ step.role }}_page, SCENARIO, {{ step.step_number }}, _form_selectors)
+{% endif %}
+{% endif %}
+
+{%- elif step.action == "select" %}
+{% if step | emits_screenshot %}
+    _bbox = _safe_bbox_scrolled({{ step.role }}_page, _interp({{ step.selector | pystr }}, _vars))
+{{ shot(step, "select", "before", step.selector, True, False) -}}
+{% endif %}
+{% if step.within or step.match %}
+    {{ disambig_locator(step.role, step.selector, step) }}.select_option(_interp_val({{ step.value | pystr }}, _vars){{ step | call_kwargs(scenario, config) }})
+{% else %}
+    {{ step.role }}_page.select_option(_interp({{ step.selector | pystr }}, _vars), _interp_val({{ step.value | pystr }}, _vars){{ step | call_kwargs(scenario, config) }})
+{% endif %}
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+{{ shot(step, "select", "after", step.selector, True, False) -}}
+
+{%- elif step.action == "select-option" %}
+{% if step | emits_screenshot %}
+{% if step.within or step.match %}
+    _bbox = _safe_bbox_locator({{ step.role }}_page, {{ disambig_locator(step.role, step.selector, step) }})
+{% else %}
+    _bbox = _safe_bbox_scrolled({{ step.role }}_page, _interp({{ step.selector | pystr }}, _vars))
+{% endif %}
+{{ shot(step, "select-option", "before", step.selector, True, True) -}}
+{% endif %}
+{% if step.within or step.match %}
+    {{ disambig_locator(step.role, step.selector, step) }}.click({{ step | call_kwargs(scenario, config, False) }})
+{% else %}
+    {{ step.role }}_page.locator(_interp({{ step.selector | pystr }}, _vars)).click({{ step | call_kwargs(scenario, config, False) }})
+{% endif %}
+    {{ step.role }}_page.wait_for_selector({{ config.dropdown.overlay | pystr }}, state='visible', timeout={{ step | resolve_timeout(scenario, config) }})
+{% if step.search %}
+    {{ step.role }}_page.locator({{ config.dropdown.filter | pystr }}).fill(_interp({{ step.search | pystr }}, _vars))
+{% if config.dropdown.settle == "api" %}
+    {{ step.role }}_page.wait_for_load_state("networkidle")
+{% endif %}
+{% endif %}
+{% if step.multiple %}
+{% for label in step.multiple %}
+    {{ step.role }}_page.locator({{ config.dropdown.overlay | pystr }}).locator({{ config.dropdown.option | pystr }}).filter(has_text=_interp({{ label | pystr }}, _vars)).first.click(force=True)
+{% endfor %}
+    {{ step.role }}_page.keyboard.press("Escape")
+{% else %}
+{% set opt = step.option | format_dropdown_option %}
+{% if opt.kind == "first" %}
+    {{ step.role }}_page.locator({{ config.dropdown.overlay | pystr }}).locator({{ config.dropdown.option | pystr }}).first.click(force=True)
+{% elif opt.kind == "last" %}
+    {{ step.role }}_page.locator({{ config.dropdown.overlay | pystr }}).locator({{ config.dropdown.option | pystr }}).last.click(force=True)
+{% elif opt.kind == "nth" %}
+    {{ step.role }}_page.locator({{ config.dropdown.overlay | pystr }}).locator({{ config.dropdown.option | pystr }}).nth({{ opt.index }}).click(force=True)
+{% else %}
+    {{ step.role }}_page.locator({{ config.dropdown.overlay | pystr }}).locator({{ config.dropdown.option | pystr }}).filter(has_text=_interp({{ opt.text | pystr }}, _vars)).first.click(force=True)
+{% endif %}
+{% endif %}
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+{{ shot(step, "select-option", "after", step.selector, True, True) -}}
+
+{%- elif step.action == "confirm" %}
+    _overlay = {{ step.role }}_page.locator({{ config.dialog.overlay | pystr }}).last
+    _overlay.wait_for(state='visible', timeout={{ step | resolve_timeout(scenario, config) }})
+{% if step.button %}
+    _confirm_btn = _overlay.locator('button').filter(has_text=_interp({{ step.button | pystr }}, _vars)).first
+{% elif step.variant == "reject" %}
+    _confirm_btn = _overlay.locator({{ config.dialog.reject | pystr }}).first
+{% elif step.danger %}
+    _confirm_btn = _overlay.locator({{ config.dialog.danger | pystr }}).first
+{% else %}
+    _confirm_btn = _overlay.locator({{ config.dialog.accept | pystr }}).first
+{% endif %}
+{% if step | emits_screenshot %}
+    _bbox = _safe_bbox_locator({{ step.role }}_page, _confirm_btn)
+{{ shot(step, "confirm", "before", None, True, True) -}}
+{% endif %}
+    _confirm_btn.click({{ step | call_kwargs(scenario, config, False) }})
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+{{ shot(step, "confirm", "after", None, True, True) -}}
+
+{%- elif step.action == "fill-date" %}
+{% if step | emits_screenshot %}
+    _bbox = _safe_bbox_scrolled({{ step.role }}_page, _interp({{ step.selector | pystr }}, _vars))
+{{ shot(step, "fill-date", "before", step.selector, True, False) -}}
+{% endif %}
+    _date = _resolve_date({{ step.date | pystr }}, {{ (step.format or "%d/%m/%Y") | pystr }})
+    _el = {{ step.role }}_page.locator(_interp({{ step.selector | pystr }}, _vars))
+    _el.click()
+    _el.fill('')
+    _el.press_sequentially(_date, delay=50)
+    {{ step.role }}_page.keyboard.press('Tab')
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+{{ shot(step, "fill-date", "after", step.selector, True, False) -}}
+
+{%- elif step.action == "toggle" %}
+{% if step | emits_screenshot %}
+{% if step.within or step.match %}
+    _bbox = _safe_bbox_locator({{ step.role }}_page, {{ disambig_locator(step.role, step.selector, step) }})
+{% else %}
+    _bbox = _safe_bbox_scrolled({{ step.role }}_page, _interp({{ step.selector | pystr }}, _vars))
+{% endif %}
+{{ shot(step, "toggle", "before", step.selector, True, True) -}}
+{% endif %}
+{% if step.option %}
+{% if step.within or step.match %}
+    {{ disambig_locator(step.role, step.selector, step) }}.locator({{ config.toggle.segment | pystr }}).filter(has_text=_interp({{ step.option | pystr }}, _vars)).first.click()
+{% else %}
+    {{ step.role }}_page.locator(_interp({{ step.selector | pystr }}, _vars)).locator({{ config.toggle.segment | pystr }}).filter(has_text=_interp({{ step.option | pystr }}, _vars)).first.click()
+{% endif %}
+{% else %}
+{% if step.control == "self" %}
+    _switch = {{ step.role }}_page.locator(_interp({{ step.selector | pystr }}, _vars))
+{% elif step.control %}
+    _switch = {{ step.role }}_page.locator(_interp({{ step.selector | pystr }}, _vars)).locator(_interp({{ step.control | pystr }}, _vars))
+{% else %}
+{% if step.within or step.match %}
+    _switch = {{ disambig_locator(step.role, step.selector, step) }}.locator({{ config.toggle.switch | pystr }})
+{% else %}
+    _switch = {{ step.role }}_page.locator(_interp({{ step.selector | pystr }}, _vars)).locator({{ config.toggle.switch | pystr }})
+{% endif %}
+{% endif %}
+{% if step.state == "on" %}
+    if not _switch.is_checked():
+        _switch.check(force=True)
+{% elif step.state == "off" %}
+    if _switch.is_checked():
+        _switch.uncheck(force=True)
+{% else %}
+    _switch.click(force=True)
+{% endif %}
+{% endif %}
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+{{ shot(step, "toggle", "after", step.selector, True, True) -}}
+
+{%- elif step.action == "expand" %}
+{% if step.within or step.match %}
+    _fieldset = {{ disambig_locator(step.role, step.selector, step) }}
+{% else %}
+    _fieldset = {{ step.role }}_page.locator(_interp({{ step.selector | pystr }}, _vars))
+{% endif %}
+{% if step.control == "self" %}
+    _toggle = _fieldset.first
+{% elif step.control %}
+    _toggle = _fieldset.locator(_interp({{ step.control | pystr }}, _vars)).first
+{% else %}
+    _toggle = _fieldset.locator({{ config.fieldset.toggle | pystr }}).first
+{% endif %}
+{% if step.detect != "aria" %}
+    _content = _fieldset.locator({{ config.fieldset.content | pystr }}).first
+{% endif %}
+{% if step | emits_screenshot %}
+    _bbox = _safe_bbox_locator({{ step.role }}_page, _toggle)
+{{ shot(step, "expand", "before", None, True, True) -}}
+{% endif %}
+{# Four shapes, one per (detect, state) pair. `detect: aria` reads the
+   disclosure button's own aria-expanded — what a project's `ensure_open`
+   helper reads — because the content element can be present but clipped, or
+   animating, and `is_visible()` then disagrees with the widget. `state: off`
+   collapses instead of expanding. Neither field set emits the original three
+   lines verbatim, so existing scenarios regenerate byte-identically. #}
+{% if step.detect == "aria" %}
+    _toggle.wait_for(state="visible", timeout={{ step | resolve_timeout(scenario, config) }})
+{% if step.state == "off" %}
+    if (_toggle.get_attribute("aria-expanded") or "false") == "true":
+        _toggle.click()
+{% else %}
+    if (_toggle.get_attribute("aria-expanded") or "false") != "true":
+        _toggle.click()
+{% endif %}
+{% elif step.state == "off" %}
+    if _content.is_visible():
+        _toggle.click()
+        _content.wait_for(state="hidden", timeout={{ step | resolve_timeout(scenario, config) }})
+{% else %}
+    if not _content.is_visible():
+        _toggle.click()
+        _content.wait_for(state="visible", timeout={{ step | resolve_timeout(scenario, config) }})
+{% endif %}
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+{{ shot(step, "expand", "after", None, True, True) -}}
+
+{%- elif step.action == "pick-date" %}
+{% if step | emits_screenshot %}
+{% if step.within or step.match %}
+    _bbox = _safe_bbox_locator({{ step.role }}_page, {{ disambig_locator(step.role, step.selector, step) }})
+{% else %}
+    _bbox = _safe_bbox_scrolled({{ step.role }}_page, _interp({{ step.selector | pystr }}, _vars))
+{% endif %}
+{{ shot(step, "pick-date", "before", step.selector, True, True) -}}
+{% endif %}
+    _pick_date(
+        {{ step.role }}_page,
+        _interp({{ step | disambig_selector | pystr }}, _vars),
+        {{ step.date | pystr }},
+        panel={{ config.datepicker.panel | pystr }},
+        next_btn={{ config.datepicker.next_button | pystr }},
+        prev_btn={{ config.datepicker.prev_button | pystr }},
+        day_cell={{ config.datepicker.day_cell | pystr }},
+        trigger={{ config.datepicker.trigger | pystr }},
+        timeout={{ step | resolve_timeout(scenario, config) }},
+    )
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+{{ shot(step, "pick-date", "after", step.selector, True, True) -}}
+
+{%- elif step.action == "pick-time" %}
+{% if step | emits_screenshot %}
+{% if step.within or step.match %}
+    _bbox = _safe_bbox_locator({{ step.role }}_page, {{ disambig_locator(step.role, step.selector, step) }})
+{% else %}
+    _bbox = _safe_bbox_scrolled({{ step.role }}_page, _interp({{ step.selector | pystr }}, _vars))
+{% endif %}
+{{ shot(step, "pick-time", "before", step.selector, True, True) -}}
+{% endif %}
+    _pick_time(
+        {{ step.role }}_page,
+        _interp({{ step | disambig_selector | pystr }}, _vars),
+        {{ step.time | pystr }},
+        panel={{ config.datepicker.panel | pystr }},
+        hour_picker={{ config.datepicker.hour_picker | pystr }},
+        minute_picker={{ config.datepicker.minute_picker | pystr }},
+        trigger={{ config.datepicker.trigger | pystr }},
+        timeout={{ step | resolve_timeout(scenario, config) }},
+    )
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+{{ shot(step, "pick-time", "after", step.selector, True, True) -}}
+
+{%- elif step.action == "wait" %}
+    time.sleep({{ step.duration | format_wait_duration }}){% if step.note %}  # {{ step.note }}{% endif %}
+
+
+{%- elif step.action == "wait-for" %}
+{% if step.until %}
+{# A state predicate, not mere DOM presence. `_wait_until` polls through the
+   locator so every selector engine keeps working. #}
+    _wait_until({{ disambig_locator(step.role, step.selector, step) }}, {{ step.until | pystr }}, {{ step | resolve_timeout(scenario, config) }}{% if step.interval %}, interval={{ step.interval | timeout_ms }}{% endif %})
+{% elif step.within or step.match %}
+    {{ disambig_locator(step.role, step.selector, step) }}.wait_for(timeout={{ step | resolve_timeout(scenario, config) }}{% if step.state %}, state={{ step.state | pystr }}{% endif %})
+{% else %}
+    {{ step.role }}_page.wait_for_selector(_interp({{ step.selector | pystr }}, _vars), timeout={{ step | resolve_timeout(scenario, config) }}{% if step.state %}, state={{ step.state | pystr }}{% endif %})
+{% endif %}
+{% if step.wait %}
+    {{ step.role }}_page.wait_for_load_state({{ step.wait | pystr }})
+{% endif %}
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+{% if step | emits_screenshot %}
+    take_screenshot_with_bbox({{ step.role }}_page, SCENARIO, {{ step.step_number }}, "wait-for")
+{% endif %}
+
+{%- elif step.action == "wait-for-text" %}
+    {{ step.role }}_page.wait_for_selector(_interp({{ ('text="' ~ step.value ~ '"') | pystr }}, _vars), timeout={{ step | resolve_timeout(scenario, config) }})
+{% if step | emits_screenshot %}
+    take_screenshot_with_bbox({{ step.role }}_page, SCENARIO, {{ step.step_number }}, "wait-for-text")
+{% endif %}
+
+{%- elif step.action == "scroll" %}
+{% if step.within or step.match %}
+    {{ disambig_locator(step.role, step.selector, step) }}.scroll_into_view_if_needed({{ step | call_kwargs(scenario, config, False) }})
+{% else %}
+    {{ step.role }}_page.locator(_interp({{ step.selector | pystr }}, _vars)).scroll_into_view_if_needed({{ step | call_kwargs(scenario, config, False) }})
+{% endif %}
+{% if step | emits_screenshot %}
+    _bbox = _safe_bbox_scrolled({{ step.role }}_page, _interp({{ step.selector | pystr }}, _vars))
+    take_screenshot_with_bbox({{ step.role }}_page, SCENARIO, {{ step.step_number }}, "scroll", selector={{ step.selector | pystr }}, precaptured_bbox=_bbox)
+{% endif %}
+
+{%- elif step.action == "hover" %}
+{% if step | emits_screenshot %}
+{% if step.within or step.match %}
+    _bbox = _safe_bbox_locator({{ step.role }}_page, {{ disambig_locator(step.role, step.selector, step) }})
+{% else %}
+    _bbox = _safe_bbox_scrolled({{ step.role }}_page, _interp({{ step.selector | pystr }}, _vars))
+{% endif %}
+{{ shot(step, "hover", "before", step.selector, True, False) -}}
+{% endif %}
+{% if step.within or step.match %}
+    {{ disambig_locator(step.role, step.selector, step) }}.hover({{ step | call_kwargs(scenario, config, False) }})
+{% else %}
+    {{ step.role }}_page.hover(_interp({{ step.selector | pystr }}, _vars){{ step | call_kwargs(scenario, config) }})
+{% endif %}
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+{{ shot(step, "hover", "after", step.selector, True, False) -}}
+
+{%- elif step.action == "upload" %}
+{% if step | emits_screenshot %}
+{# When the <input type=file> is visually hidden behind a styled button or
+   drop zone, the scenario sets guide-cursor.target to the visible trigger so
+   bbox + cursor land on something the reader can actually see. #}
+{% if step.guide_cursor %}
+    _bbox = _safe_bbox_scrolled({{ step.role }}_page, _interp({{ step.guide_cursor.target | pystr }}, _vars))
+{% else %}
+    _bbox = _safe_bbox_scrolled({{ step.role }}_page, _interp({{ step.selector | pystr }}, _vars))
+{% endif %}
+{{ shot(step, "upload", "before", (step.guide_cursor.target if step.guide_cursor else step.selector), True, False) -}}
+{% endif %}
+{% if step.within or step.match %}
+    {{ disambig_locator(step.role, step.selector, step) }}.set_input_files(_interp({{ step.value | pystr }}, _vars){{ step | call_kwargs(scenario, config) }})
+{% else %}
+    {{ step.role }}_page.locator(_interp({{ step.selector | pystr }}, _vars)).set_input_files(_interp({{ step.value | pystr }}, _vars){{ step | call_kwargs(scenario, config) }})
+{% endif %}
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+{{ shot(step, "upload", "after", (step.guide_cursor.target if step.guide_cursor else step.selector), True, False) -}}
+
+{%- elif step.action == "keyboard" %}
+    {{ step.role }}_page.keyboard.press({{ step.value | pystr }})
+{% if step | emits_screenshot %}
+    take_screenshot_with_bbox({{ step.role }}_page, SCENARIO, {{ step.step_number }}, "keyboard")
+{% endif %}
+
+{%- elif step.action == "assert" %}
+    if not SKIP_ASSERTS:
+{% for assertion in step.expect | format_assertions %}
+{% set _aloc %}{{ disambig_locator(step.role, assertion.selector, step) }}{% endset %}
+{{ assert_body(step.role, assertion, _aloc, step | resolve_timeout(scenario, config), step | resolve_timeout(scenario, config, 5000), assertion.raw) -}}
+{% endfor %}
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+{% if step | emits_screenshot %}
+    take_screenshot_with_bbox({{ step.role }}_page, SCENARIO, {{ step.step_number }}, "assert")
+{% endif %}
+
+{%- elif step.action == "capture" %}
+{% if step.from_.type == "dom" %}
+    _vars[{{ step.store | pystr }}] = capture_dom(
+        {{ step.role }}_page,
+        {{ step.from_ | tojson }},
+        _vars,
+        retry={{ step.retry or 1 }},
+        interval={{ (step.interval or "200ms") | format_wait_duration }},
+    )
+{% else %}
+    _vars[{{ step.store | pystr }}] = capture(
+        {{ step.from_ | tojson }},
+        _vars,
+        retry={{ step.retry or 1 }},
+        interval={{ (step.interval or "200ms") | format_wait_duration }},
+    )
+{% endif %}
+
+{%- elif step.action == "call" %}
+{% if step | emits_screenshot and step.guide_cursor %}
+    _bbox = _safe_bbox_scrolled({{ step.role }}_page, _interp({{ step.guide_cursor.target | pystr }}, _vars))
+{% endif %}
+{% if step | emits_screenshot and step.screenshot_when == "before" %}
+{% if step.guide_cursor %}
+    take_screenshot_with_bbox({{ step.role }}_page, SCENARIO, {{ step.step_number }}, "call", selector={{ step.guide_cursor.target | pystr }}, precaptured_bbox=_bbox)
+{% else %}
+    take_screenshot_with_bbox({{ step.role }}_page, SCENARIO, {{ step.step_number }}, "call")
+{% endif %}
+{% endif %}
+{# `lstrip_blocks` eats the leading indent when a line starts with a tag, so
+   the two forms are spelled out rather than sharing a prefix. #}
+{% if step.store %}
+    _vars[{{ step.store | pystr }}] = call_helper(
+{% else %}
+    call_helper(
+{% endif %}
+        {{ step.role }}_page,
+        {{ step.fn | pystr }},
+{% if step.args %}
+        args={{ step.args | tojson }},
+{% endif %}
+{% if step.kwargs %}
+        kwargs={{ step.kwargs | tojson }},
+{% endif %}
+        _vars=_vars,
+{% if step.page is false %}
+        pass_page=False,
+{% endif %}
+    )
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+{% if step | emits_screenshot and step.screenshot_when != "before" %}
+{% if step.guide_cursor %}
+    take_screenshot_with_bbox({{ step.role }}_page, SCENARIO, {{ step.step_number }}, "call", selector={{ step.guide_cursor.target | pystr }}, precaptured_bbox=_bbox)
+{% else %}
+    take_screenshot_with_bbox({{ step.role }}_page, SCENARIO, {{ step.step_number }}, "call")
+{% endif %}
+{% endif %}
+
+{%- elif step.action == "custom" %}
+{% if step | emits_screenshot and step.guide_cursor %}
+    _bbox = _safe_bbox_scrolled({{ step.role }}_page, _interp({{ step.guide_cursor.target | pystr }}, _vars))
+{% endif %}
+{% if step | emits_screenshot and step.screenshot_when == "before" %}
+{% if step.guide_cursor %}
+    take_screenshot_with_bbox({{ step.role }}_page, SCENARIO, {{ step.step_number }}, "custom", selector={{ step.guide_cursor.target | pystr }}, precaptured_bbox=_bbox)
+{% else %}
+    take_screenshot_with_bbox({{ step.role }}_page, SCENARIO, {{ step.step_number }}, "custom")
+{% endif %}
+{% endif %}
+    # Custom code:
+    page = {{ step.role }}_page
+    {{ step.code | indent(4) }}
+{% if step.wait_after %}
+    time.sleep({{ step.wait_after / 1000 }})
+{% endif %}
+{% if step | emits_screenshot and step.screenshot_when != "before" %}
+{% if step.guide_cursor %}
+    take_screenshot_with_bbox({{ step.role }}_page, SCENARIO, {{ step.step_number }}, "custom", selector={{ step.guide_cursor.target | pystr }}, precaptured_bbox=_bbox)
+{% else %}
+    take_screenshot_with_bbox({{ step.role }}_page, SCENARIO, {{ step.step_number }}, "custom")
+{% endif %}
+{% endif %}
+{% endif %}
+
+{%- if step.expect and step.action != "assert" %}
+{% for assertion in step.expect | format_assertions %}
+    # Assert: {{ assertion.type }}
+{% endfor %}
+    if not SKIP_ASSERTS:
+{% for assertion in step.expect | format_assertions %}
+{% set _eloc %}{{ step.role }}_page.locator(_interp({{ assertion.selector | pystr }}, _vars)){% endset %}
+{{ assert_body(step.role, assertion, _eloc, step | resolve_timeout(scenario, config), step | resolve_timeout(scenario, config, 5000), None) -}}
+{% endfor %}
+{% endif %}
+{% endmacro %}
+
+{% if scenario.seed %}
+
+@pytest.fixture(autouse=True)
+def seed():
+    """Run seed script {{ scenario.seed.run }} this scenario."""
+    import subprocess
+    import sys
+    from pathlib import Path
+
+    seed_file = Path({{ ('seed/' ~ scenario.seed.script ~ '.py') | pystr }})
+
+    if not seed_file.exists():
+        pytest.fail(f'Seed script not found: {seed_file}')
+
+    def _run_seed():
+        try:
+            result = subprocess.run(
+                [sys.executable, str(seed_file)],
+                capture_output=True,
+                text=True,
+                timeout={{ scenario.seed.timeout }},
+            )
+        except subprocess.TimeoutExpired:
+            pytest.fail(f'Seed script timed out after {{ scenario.seed.timeout }}s: {seed_file}')
+        if result.returncode != 0:
+            error_msg = f'Seed script failed (exit code {result.returncode})'
+            if result.stderr:
+                error_msg += f'\nStderr: {result.stderr}'
+            if result.stdout:
+                error_msg += f'\nStdout: {result.stdout}'
+            pytest.fail(error_msg)
+
+{% if scenario.seed.run in ("before", "both") %}
+    _run_seed()
+{% endif %}
+
+    yield
+
+{% if scenario.seed.run in ("after", "both") %}
+    _run_seed()
+{% endif %}
+{% endif %}
+
+{% if not scenario.auth %}
+def test_{{ scenario.slug.replace('-', '_') }}(
+{%- for role in roles_needed -%}
+{{ role }}_page_noauth: Page{{ ", " if not loop.last else "" }}
+{%- endfor -%}
+):
+    """{{ scenario.title | docstring }}{% if scenario.description %} — {{ scenario.description | docstring }}{% endif %}."""
+    _vars: dict[str, str] = {}
+{% for role in roles_needed %}
+    {{ role }}_page = {{ role }}_page_noauth
+{% endfor %}
+{% else %}
+def test_{{ scenario.slug.replace('-', '_') }}(
+{%- for role in roles_needed -%}
+{{ role }}_page: Page{{ ", " if not loop.last else "" }}
+{%- endfor -%}
+):
+    """{{ scenario.title | docstring }}{% if scenario.description %} — {{ scenario.description | docstring }}{% endif %}."""
+    _vars: dict[str, str] = {}
+{% endif %}
+{% for step in scenario.steps %}
+
+    # ── Step {{ step.step_number }}: {{ step.step_title }} ──────────────────────────────────────────────────────
+{#
+  `bracket_step` adds the per-step event markers, `apply_step_guard` wraps the
+  result in `if _step_runs(...)` when the step is conditional. Order matters:
+  the markers must end up INSIDE the guard, so a skipped step emits neither and
+  `failed_step` can never name a step that did not run.
+
+  Both are Python filters rather than template lines because the captured body's
+  trailing newline varies by action branch — see `generator._bracket_step`.
+#}
+{{ step_body(step) | apply_optional(step) | bracket_step(step) | apply_step_guard(step) }}
+{%- endfor %}
+{#
+  In-app tour replay (only for scenarios whose tour is compiled, see
+  steppy.tours.replay): composed in Python around `step_body`, so every
+  action runs exactly the code the scenario test above runs.
+#}
+{% if tour_replay %}
+{{ tour_replay | tour_section(step_body) }}{% endif %}