steppy-dev 0.3.0__py3-none-any.whl

steppy/_parallel/retry.py

@@ -0,0 +1,316 @@
+"""Scenario-level retry pass for parallel runs.
+
+After the main queue drains, re-run the scenarios that failed — at reduced
+concurrency, in the **already-running** stacks. A scenario that fails under N
+workers and then passes alone is FLAKY (contention), not broken; one that fails
+both times is a real failure. That single distinction is what turns an
+18-failure summary into "3 real failures, 15 flaky".
+
+Why this is different from ``report.retries`` (pytest-rerunfailures): that
+reruns the test in-process, immediately — same worker, same moment, same
+contention. It catches per-action timing flakes and nothing else. This pass
+waits for the contention to be *gone* before retrying, which is the only way to
+attribute a failure to it.
+
+Mechanism — the cheap part is that there barely is one:
+
+* ``worker.py`` resolves its whole world from ``STEPPY_COORD_DIR``, so pointing
+  attempt *n* at ``<tmp>/retry-<n>/`` gives it a private queue/claims/results
+  tree. **Neither ``worker.py`` nor ``queue.py`` needs any change**, and
+  attempt 1's evidence stays intact on disk beside attempt 2's (which is what
+  lets ``failures.py`` copy the right ``pytest.log`` afterwards).
+* The app services are left running. We recreate only ``steppy-worker``, with
+  ``--no-deps``, so the database, the network and any completed ``steppy-preauth``
+  survive untouched and the retry starts in seconds rather than minutes.
+
+Two things that look optional but are not:
+
+* A **fresh EventBus** per pass. ``EventBus._tests`` is keyed
+  ``(worker_id, nodeid)`` and ``test-start`` overwrites the record in place,
+  while ``_counts`` only ever increments — feeding a second attempt into the
+  same bus would both lose attempt 1's outcome and double-count the totals.
+* **Fresh log tailers.** ``docker compose logs -f`` is bound to the container
+  that existed when it started; recreating ``steppy-worker`` orphans it.
+
+Lazy-imported from :mod:`steppy.coordinator`, like every other ``_parallel``
+module, so the single-worker path stays clean
+(``tests/test_no_parallel_import_on_default_path.py``).
+"""
+
+from __future__ import annotations
+
+import subprocess
+from concurrent.futures import ThreadPoolExecutor, as_completed
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Callable, Optional
+
+from .compose import render_override
+from .event_bus import EventBus, RawLogChannel
+from .progress import WorkerLogTailer
+from .queue import Queue, ScenarioResult
+
+
+@dataclass
+class PassResult:
+    """One attempt's outcome. ``attempt`` is 1 for the main pass."""
+
+    attempt: int
+    coord_root: Path
+    results: list[ScenarioResult]
+    orphans: dict[str, list[str]] = field(default_factory=dict)
+    bus: Optional[EventBus] = None
+    # Scenarios that were queued and never claimed by anybody — every worker died
+    # with work left. Deliberately NOT part of ``failed_slugs``: see below.
+    never_started: set[str] = field(default_factory=set)
+
+    @property
+    def failed_slugs(self) -> set[str]:
+        """Scenarios this attempt did not get a clean result for — non-zero
+        exit codes plus orphans (claimed, never reported)."""
+        out = {r.slug for r in self.results if r.exit_code != 0}
+        for slugs in self.orphans.values():
+            out.update(slugs)
+        return out
+
+    @property
+    def pending_slugs(self) -> set[str]:
+        """What the next attempt should run: the failures **plus** anything that
+        never started.
+
+        The split matters because :func:`classify` builds ``ever_failed`` from
+        ``failed_slugs``. A scenario that never ran and then passed on retry is not
+        flaky, and marking it so would poison the append-only
+        ``.steppy/history.jsonl`` that ``steppy flaky`` ranks from — permanently,
+        and for a scenario that is not even faulty. An exclusion group makes that
+        acute: one worker death strands every unstarted member of its batch at
+        once, not just the one in flight.
+        """
+        return self.failed_slugs | self.never_started
+
+    @property
+    def passed_slugs(self) -> set[str]:
+        return {r.slug for r in self.results if r.exit_code == 0}
+
+
+@dataclass(frozen=True)
+class Verdict:
+    """Final per-scenario classification across every attempt."""
+
+    passed: list[str]
+    flaky: list[str]  # failed at least once, passed in the end
+    failed: list[str]  # never passed
+    attempts: dict[str, int]  # slug -> how many attempts it took/consumed
+
+    @property
+    def any_real_failure(self) -> bool:
+        return bool(self.failed)
+
+
+def classify(passes: list[PassResult]) -> Verdict:
+    """Fold the per-attempt results into passed / flaky / failed.
+
+    Later attempts win: a scenario is FLAKY when some attempt failed it and a
+    later one passed it, FAILED when no attempt ever passed it. Scenarios that
+    only ever passed are plain passes.
+
+    Orphans count as failures for the attempt they happened in, so a worker that
+    died mid-scenario is retried like any other failure instead of being a hard
+    loss (the v0.1 ``queue.orphaned_running_tasks`` behaviour).
+    """
+    final_outcome: dict[str, bool] = {}
+    ever_failed: set[str] = set()
+    attempts: dict[str, int] = {}
+
+    for p in passes:
+        failed = p.failed_slugs
+        for slug in failed:
+            ever_failed.add(slug)
+            final_outcome[slug] = False
+            attempts[slug] = p.attempt
+        for slug in p.passed_slugs:
+            final_outcome[slug] = True
+            attempts[slug] = p.attempt
+
+    passed, flaky, failed_out = [], [], []
+    for slug in sorted(final_outcome):
+        if not final_outcome[slug]:
+            failed_out.append(slug)
+        elif slug in ever_failed:
+            flaky.append(slug)
+        else:
+            passed.append(slug)
+    return Verdict(passed=passed, flaky=flaky, failed=failed_out, attempts=attempts)
+
+
+def log_roots_by_slug(passes: list[PassResult]) -> dict[str, Path]:
+    """Map each scenario to the coord root of its FINAL attempt.
+
+    ``failures.persist_failure_artifacts`` reads ``<root>/logs/<worker>/<slug>.log``;
+    without this it would look in the main pass's dir and silently copy a stale
+    (or missing) log for anything the retry pass touched.
+    """
+    roots: dict[str, Path] = {}
+    for p in passes:  # later passes overwrite earlier ones
+        for slug in p.failed_slugs | p.passed_slugs:
+            roots[slug] = p.coord_root
+    return roots
+
+
+def _recreate_worker(
+    *,
+    project: str,
+    compose_file: Path,
+    override: Path,
+) -> tuple[int, Optional[str]]:
+    """Replace one project's ``steppy-worker`` container with a fresh one bound
+    to the retry override. ``--no-deps`` is what keeps the app services (and the
+    already-completed preauth) alive, so only the worker restarts."""
+    cmd = [
+        "docker",
+        "compose",
+        "-p",
+        project,
+        "-f",
+        str(compose_file),
+        "-f",
+        str(override),
+        "up",
+        "-d",
+        "--no-deps",
+        "--force-recreate",
+        "steppy-worker",
+    ]
+    result = subprocess.run(cmd, capture_output=True, text=True, encoding="utf-8", errors="replace")
+    if result.returncode != 0:
+        return result.returncode, f"{project}: {result.stderr.strip()}"
+    return 0, None
+
+
+def run_retry_pass(
+    *,
+    attempt: int,
+    slugs: list[str],
+    projects: list[str],
+    batches: Optional[dict[str, list[str]]] = None,
+    compose_file: Path,
+    tmp_dir: Path,
+    override_kwargs: dict,
+    console,
+    verbose: bool,
+    resolve_container_ids: Callable[[list[str]], dict[str, str]],
+    wait_for_workers: Callable[..., list[int]],
+    register_teardown: Callable[[Callable[[], None]], None],
+) -> Optional[PassResult]:
+    """Run one retry attempt over ``slugs``. Returns None if it couldn't start.
+
+    ``projects`` is the subset of stacks to use (the caller slices it down to
+    ``parallel.retry.workers``). The unused stacks simply idle — they are torn
+    down with the rest at the end of the run.
+
+    ``override_kwargs`` is the exact kwargs dict the main pass handed to
+    :func:`render_override`; we re-render with ``coord_subdir`` pointed at this
+    attempt's private queue so a drifted main-pass setting can never silently
+    fail to apply to the retry.
+
+    ``slugs`` is a list of TASK IDS and ``batches`` maps any of them that is an
+    exclusion group to its members — re-derived by the caller for this attempt's
+    pending set, never inherited, since a retry usually re-runs only part of a
+    group. Without it two failed members of one group would run concurrently
+    whenever ``parallel.retry.workers`` is above its default of 1.
+
+    The coordinator's ``_resolve_worker_container_ids`` / ``_wait_for_workers``
+    / lifecycle hooks are injected rather than imported to keep this module
+    free of a circular dependency on ``coordinator``.
+    """
+    coord_subdir = f"retry-{attempt}"
+    coord_root = tmp_dir / coord_subdir
+    queue = Queue(root=coord_root)
+    if batches:
+        queue.seed(slugs, batches=batches)
+    else:
+        queue.seed(slugs)
+
+    console.print()
+    console.rule(f"[bold yellow]Retry pass {attempt}[/bold yellow]")
+    console.print(
+        f"[dim]re-running {len(slugs)} failed scenario(s) across {len(projects)} worker(s) "
+        f"— reduced concurrency isolates contention flakes[/dim]"
+    )
+
+    # Re-render one override per participating stack, pointed at this attempt's
+    # queue. Worker index must match the project's original index so worker ids
+    # stay stable in the summary.
+    overrides: list[Path] = []
+    for idx, _project in enumerate(projects, start=1):
+        kwargs = dict(override_kwargs)
+        kwargs["worker_index"] = idx
+        kwargs["coord_subdir"] = coord_subdir
+        if kwargs.get("auth_mount_by_worker"):
+            kwargs["auth_mount"] = kwargs["auth_mount_by_worker"][idx - 1]
+        kwargs.pop("auth_mount_by_worker", None)
+        path = tmp_dir / f"override-retry{attempt}-w{idx}.yml"
+        path.write_text(render_override(**kwargs), encoding="utf-8")
+        overrides.append(path)
+
+    failures: list[str] = []
+    with ThreadPoolExecutor(max_workers=max(1, len(projects))) as pool:
+        futures = [
+            pool.submit(_recreate_worker, project=p, compose_file=compose_file, override=o)
+            for p, o in zip(projects, overrides)
+        ]
+        for fut in as_completed(futures):
+            code, err = fut.result()
+            if code != 0:
+                failures.append(err or f"unknown error (exit {code})")
+    if failures:
+        console.print(f"[yellow]WARNING[/yellow] retry pass could not start: {'; '.join(failures)}")
+        return None
+
+    # Fresh bus per pass — see the module docstring; reusing the main pass's bus
+    # would overwrite attempt 1's records and double-count the totals.
+    raw_channel = RawLogChannel(console=console, verbose=verbose, log_dir=coord_root)
+    bus = EventBus(raw_line_sink=raw_channel)
+    register_teardown(raw_channel.close)
+    for idx in range(1, len(projects) + 1):
+        bus.register_worker(f"w{idx}")
+
+    # Fresh tailers too — the main pass's `compose logs -f` died with the
+    # container it was following.
+    for idx, project in enumerate(projects, start=1):
+        tailer = WorkerLogTailer(
+            project=project,
+            worker_id=f"w{idx}",
+            bus=bus,
+            app_log_file=tmp_dir / f"w{idx}-retry{attempt}-stack.log",
+        )
+        tailer.start()
+        register_teardown(tailer.stop)
+
+    try:
+        container_ids = resolve_container_ids(projects)
+    except Exception as e:  # noqa: BLE001 — a retry that can't start is not fatal
+        console.print(f"[yellow]WARNING[/yellow] retry pass could not resolve workers: {e}")
+        return None
+
+    worker_exits = wait_for_workers(container_ids, console)
+    for idx, code in enumerate(worker_exits, start=1):
+        bus.mark_worker_finished(f"w{idx}", died=code != 0)
+
+    return PassResult(
+        attempt=attempt,
+        coord_root=coord_root,
+        results=queue.collect_results(),
+        orphans=queue.orphaned_running_tasks(),
+        bus=bus,
+        never_started=set(queue.unclaimed_slugs()),
+    )
+
+
+__all__ = [
+    "PassResult",
+    "Verdict",
+    "classify",
+    "log_roots_by_slug",
+    "run_retry_pass",
+]

steppy/_player_bundle/THIRD_PARTY_LICENSES.txt

@@ -0,0 +1,158 @@
+Third-party software bundled in the Steppy player bundles
+(steppy-player.js, steppy-video.js). steppy-cursor-legacy.js bundles none.
+
+================================================================================
+lit 3.3.3
+================================================================================
+
+BSD 3-Clause License
+
+Copyright (c) 2017 Google LLC. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+================================================================================
+lit-html 3.3.3
+================================================================================
+
+BSD 3-Clause License
+
+Copyright (c) 2017 Google LLC. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+================================================================================
+lit-element 4.2.2
+================================================================================
+
+BSD 3-Clause License
+
+Copyright (c) 2017 Google LLC. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+================================================================================
+@lit/reactive-element 2.1.2
+================================================================================
+
+BSD 3-Clause License
+
+Copyright (c) 2017 Google LLC. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+================================================================================
+zod 3.25.76
+================================================================================
+
+MIT License
+
+Copyright (c) 2025 Colin McDonnell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

steppy/_player_bundle/__init__.py

@@ -0,0 +1,100 @@
+"""Vendored ``@steppy/player`` build artifacts.
+
+The cursor IIFE bundle (legacy stepbystep cursor animation), the
+``<steppy-guide>`` ESM bundle (interactive player) and the video
+renderer IIFE live here as pre-built artifacts, **committed to git** so
+``pip install git+…`` needs no Node toolchain. After changing
+``packages/player/src/``, run ``npm --prefix packages/player run build``
+and copy those three bundles (with their maps) back here; CI compares them
+byte for byte, and the release pipeline rebuilds them for the wheel.
+
+The fourth bundle the player build produces, the in-app tour overlay
+(``steppy-tour.js``), is deliberately not vendored: it ships to apps
+through npm, and no Python code serves it.
+"""
+
+import importlib.resources
+from functools import lru_cache
+from pathlib import Path
+
+
+class CursorBundleMissingError(FileNotFoundError):
+    """Raised when the legacy cursor IIFE bundle hasn't been built yet."""
+
+
+_BUILD_HINT = "Run `npm --prefix packages/player install && npm --prefix packages/player run build` to populate it."
+
+
+@lru_cache(maxsize=1)
+def get_legacy_cursor_iife() -> str:
+    """Return the bundled cursor IIFE JS as a string.
+
+    Single source of truth for the cursor animation. Both
+    ``templates/guide.html.j2`` (standalone HTML guide) and
+    ``templates/static/cursor.js.j2`` (build static target) read this
+    via the ``cursor_iife`` Jinja context variable.
+    """
+    pkg = importlib.resources.files("steppy") / "_player_bundle" / "steppy-cursor-legacy.js"
+    try:
+        return pkg.read_text(encoding="utf-8")
+    except (FileNotFoundError, OSError) as exc:
+        raise CursorBundleMissingError(
+            "Vendored cursor bundle missing at src/steppy/_player_bundle/steppy-cursor-legacy.js. " + _BUILD_HINT
+        ) from exc
+
+
+def get_player_bundle_path() -> Path:
+    """Filesystem path of the ESM player bundle (steppy-player.js).
+
+    Used by ``steppy build`` to copy the bundle next to the emitted
+    ``guide.json`` so ``<steppy-guide>`` works on both Angular and static
+    targets without a CDN.
+    """
+    path = bundle_dir() / "steppy-player.js"
+    if not path.is_file():
+        raise CursorBundleMissingError(f"Vendored player bundle missing at {path}. " + _BUILD_HINT)
+    return path
+
+
+def get_cursor_bundle_path() -> Path:
+    """Filesystem path of the legacy cursor IIFE bundle (steppy-cursor-legacy.js).
+
+    Used by ``steppy build`` (Angular target) to copy the bundle into the
+    assets dir as ``steppy-cursor.js``. The generated per-guide component loads
+    it once and calls ``window.__STEPPY_CURSOR__.mount(...)`` to animate the
+    stepbystep cursor — the static target inlines the same source via
+    ``get_legacy_cursor_iife()`` instead.
+    """
+    path = bundle_dir() / "steppy-cursor-legacy.js"
+    if not path.is_file():
+        raise CursorBundleMissingError(f"Vendored cursor bundle missing at {path}. " + _BUILD_HINT)
+    return path
+
+
+@lru_cache(maxsize=1)
+def get_video_iife() -> str:
+    """Return the bundled video-renderer IIFE as a string.
+
+    Exposes ``window.__STEPPY_VIDEO__``. Unlike the other two bundles this one
+    is **never copied into a build's output**: ``steppy/video.py`` inlines it
+    into a throwaway harness page, drives it frame by frame over CDP, and
+    deletes the page. Published guide sites get an ``.mp4``, not a renderer.
+    """
+    path = bundle_dir() / "steppy-video.js"
+    try:
+        return path.read_text(encoding="utf-8")
+    except (FileNotFoundError, OSError) as exc:
+        raise CursorBundleMissingError(f"Vendored video bundle missing at {path}. " + _BUILD_HINT) from exc
+
+
+def get_video_bundle_path() -> Path:
+    """Filesystem path of the video-renderer IIFE bundle (steppy-video.js)."""
+    path = bundle_dir() / "steppy-video.js"
+    if not path.is_file():
+        raise CursorBundleMissingError(f"Vendored video bundle missing at {path}. " + _BUILD_HINT)
+    return path
+
+
+def bundle_dir() -> Path:
+    """Filesystem path of the vendored bundle directory."""
+    return Path(__file__).resolve().parent

steppy/_player_bundle/steppy-cursor-legacy.js

@@ -0,0 +1,2 @@
+(function(){"use strict";const w={pre_action_ms:200,action_ms:300,post_action_ms:150,travel_speed_px_per_ms:1.5},h=n=>new Promise(t=>setTimeout(t,Math.max(0,n)));function E(n){return n*n*(3-2*n)}function y(n,t){if(!t||!t.width||!t.height)return null;const e=n.getBoundingClientRect();return!e.width||!e.height?null:{sx:e.width/t.width,sy:e.height/t.height}}function f(n,t){return{x:n.x*t.sx,y:n.y*t.sy,width:n.width*t.sx,height:n.height*t.sy}}function T(n){return{x:n.x+n.width/2,y:n.y+n.height/2}}function m(n,t,e){if(!n)return null;const s=y(t,e);return s?T(f(n,s)):null}function v(n,t,e){const s=t.x-n.x,i=t.y-n.y,a=Math.hypot(s,i);return Math.max(150,a/(e||1.5))}function P(n,t){const e=t.x-n.x,s=t.y-n.y,i=Math.hypot(e,s);if(!i)return{x:n.x,y:n.y};const a=(n.x+t.x)/2,o=(n.y+t.y)/2,r=-s/i,c=e/i;return{x:a+r*i*.15,y:o+c*i*.15}}class d{constructor(t){var e;this.cursorEl=null,this.rippleEl=null,this.kbdEl=null,this.imgEl=null,this.currentPos={x:8,y:8},this.aborted=!1,this.stage=t.stage,this.timings={...w,...(e=t.timings)!=null?e:{}},this.onPhaseChange=t.onPhaseChange,this.refreshDom()}setTimings(t){this.timings={...this.timings,...t}}setStage(t){this.stage=t,this.refreshDom()}abort(){this.aborted=!0}hide(){var t;this.cursorEl&&this.cursorEl.classList.remove("visible"),this.kbdEl&&this.kbdEl.classList.remove("visible"),(t=this.onPhaseChange)==null||t.call(this,"idle")}refreshDom(){this.cursorEl=this.stage.querySelector(".steppy-cursor"),this.rippleEl=this.stage.querySelector(".steppy-ripple"),this.kbdEl=this.stage.querySelector(".steppy-kbd"),this.imgEl=this.stage.querySelector("img")}static normalizeTargets(t){if(!t)return[];if(t.kind==="type-multi")return t.targets.map(i=>({bbox:i.bbox,value:i.value,selector:i.selector,kind:"type"}));const e=t.target,s=t.kind==="type"?t.value:void 0;return[{bbox:e.bbox,value:s,selector:e.selector,kind:t.kind==="click"?"click":t.kind==="hover"?"hover":"type"}]}async waitImageReady(){const t=this.imgEl;t&&(t.complete&&t.naturalWidth||await new Promise(e=>{const s=()=>e();t.addEventListener("load",s,{once:!0}),t.addEventListener("error",s,{once:!0})}))}async animateFrame(t){if(this.aborted=!1,this.refreshDom(),!this.cursorEl)return;if(!t.cursor){this.hide();return}await this.waitImageReady();const e=d.normalizeTargets(t.cursor);this.currentPos={x:8,y:8},this.cursorEl.classList.add("visible");for(let s=0;s<e.length;s++){if(this.aborted||(await this.travelToTargetIndex(t,e,s),this.aborted)||(await this.playTargetActionIndex(t,e,s),this.aborted))return;await h(this.timings.post_action_ms)}}async travelToTarget(t,e){if(this.aborted=!1,this.refreshDom(),!this.cursorEl)return;if(!t.cursor){this.hide();return}await this.waitImageReady();const s=d.normalizeTargets(t.cursor);this.cursorEl.classList.add("visible"),await this.travelToTargetIndex(t,s,e)}async playTargetAction(t,e){if(this.aborted=!1,this.refreshDom(),!t.cursor)return;const s=d.normalizeTargets(t.cursor);await this.playTargetActionIndex(t,s,e),!this.aborted&&await h(this.timings.post_action_ms)}computeDisplayRect(t,e){const s=this.imgEl;if(!s||!t)return null;const i=y(s,e);return i?f(t,i):null}async travelToTargetIndex(t,e,s){var r,c;const i=e[s],a=this.cursorEl;if(!i||!a)return;const o=m(i.bbox,this.imgEl,t.viewport);o&&((r=this.onPhaseChange)==null||r.call(this,"travel",i),await this.travelTo(a,this.currentPos,o),this.currentPos=o,(c=this.onPhaseChange)==null||c.call(this,"pre-action",i),a.classList.remove("pulse"),a.offsetWidth,a.classList.add("pulse"),await h(this.timings.pre_action_ms),a.classList.remove("pulse"))}async playTargetActionIndex(t,e,s){var o,r;const i=e[s];if(!i)return;const a=m(i.bbox,this.imgEl,t.viewport)||this.currentPos;(o=this.onPhaseChange)==null||o.call(this,"action",i),i.kind==="click"?(this.rippleEl&&this.fireClick(this.rippleEl,a),await h(this.timings.action_ms)):i.kind==="type"?this.kbdEl&&await this.typeValue(this.kbdEl,a,i.value):await h(this.timings.action_ms),(r=this.onPhaseChange)==null||r.call(this,"post-action",i)}async travelTo(t,e,s){const i=v(e,s,this.timings.travel_speed_px_per_ms),a=P(e,s);return new Promise(o=>{const r=performance.now(),c=u=>{if(this.aborted){o();return}const g=Math.min(1,(u-r)/i),l=E(g),b=(1-l)*(1-l)*e.x+2*(1-l)*l*a.x+l*l*s.x,I=(1-l)*(1-l)*e.y+2*(1-l)*l*a.y+l*l*s.y;t.style.left=`${b}px`,t.style.top=`${I}px`,g<1?requestAnimationFrame(c):o()};requestAnimationFrame(c)})}fireClick(t,e){t.style.left=`${e.x}px`,t.style.top=`${e.y}px`,t.classList.remove("fire"),t.offsetWidth,t.classList.add("fire")}async typeValue(t,e,s){var o;t.style.left=`${e.x+16}px`,t.style.top=`${e.y+16}px`,t.textContent="",t.classList.add("visible");const i=(s!=null?s:"").split(""),a=i.length?this.timings.action_ms/i.length:this.timings.action_ms;for(const r of i){if(this.aborted)break;t.textContent=((o=t.textContent)!=null?o:"")+r,await h(a)}await h(80),t.classList.remove("visible")}}function S(n,t,e,s){var o;if(!t)return Promise.resolve();const i=Array.from(n.querySelectorAll(".steppy-stage")),a=(o=t.frames)!=null?o:[];return(async()=>{for(let r=0;r<i.length;r++){const c=i[r],u=a[r];if(!u)continue;const g=new d({stage:c,timings:e});s==null||s.push(g),await g.animateFrame(u)}})()}function p(n,t,e){const s=Array.from(n.querySelectorAll(".steppy-step")),i=[],a=r=>{const c=r.dataset.stepIndex,u=c!==void 0?parseInt(c,10)-1:-1;return S(r,u>=0?t[u]:void 0,e,i)};let o=null;return"IntersectionObserver"in window?(o=new IntersectionObserver(r=>{r.forEach(c=>{c.isIntersecting&&(o.unobserve(c.target),a(c.target))})},{threshold:.5}),s.forEach(r=>o.observe(r))):(async()=>{for(const r of s)await a(r)})(),function(){o&&o.disconnect(),i.forEach(c=>c.abort())}}function x(){var n;p(document,(n=window.__STEPPY_STEPS__)!=null?n:[],window.__STEPPY_TIMINGS__)}window.__STEPPY_CURSOR__={mount:p,init:x};function _(){!window.__STEPPY_STEPS__&&!window.__STEPPY_STEPS_BY_LAYOUT__||x()}document.readyState==="loading"?document.addEventListener("DOMContentLoaded",_):_()})();
+//# sourceMappingURL=steppy-cursor-legacy.js.map

steppy/_player_bundle/steppy-cursor-legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steppy-cursor-legacy.js","sources":["../src/cursor/types.ts","../src/cursor/animator.ts","../src/cursor/legacy-iife.ts"],"sourcesContent":["/**\n * Cursor data shapes — shared by the Lit player, the legacy IIFE bundle, and\n * the manifest validator. Kept dependency-free (no Zod) so the legacy IIFE\n * stays a tiny standalone bundle.\n *\n * The manifest schema in ``../manifest/schema.ts`` produces types that are\n * structurally identical to these — by design.\n */\n\nexport interface Bbox {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\nexport interface Viewport {\n  width: number;\n  height: number;\n}\n\nexport interface SingleTarget {\n  selector?: string;\n  bbox: Bbox;\n}\n\nexport interface MultiTarget extends SingleTarget {\n  value?: string;\n}\n\nexport type CursorBehavior =\n  | { kind: 'click'; target: SingleTarget }\n  | { kind: 'hover'; target: SingleTarget }\n  | { kind: 'type'; target: SingleTarget; value?: string }\n  | { kind: 'type-multi'; targets: MultiTarget[] };\n\nexport interface CursorTimings {\n  pre_action_ms: number;\n  action_ms: number;\n  post_action_ms: number;\n  travel_speed_px_per_ms: number;\n}\n\nexport const DEFAULT_TIMINGS: CursorTimings = {\n  pre_action_ms: 200,\n  action_ms: 300,\n  post_action_ms: 150,\n  travel_speed_px_per_ms: 1.5,\n};\n\nexport interface AnimatorFrame {\n  cursor: CursorBehavior | null;\n  viewport: Viewport | null;\n}\n\n/** A scaled, displayed-space rect derived from a bbox + image size + viewport. */\nexport interface DisplayRect {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\nexport interface DisplayScale {\n  sx: number;\n  sy: number;\n}\n","/**\n * Cursor animation — canonical TS port of the inline JS that previously lived\n * in ``templates/static/cursor.js.j2`` and ``templates/guide.html.j2``. Both\n * the new ``<steppy-guide>`` Lit element and the legacy stepbystep templates\n * consume this module (the latter via ``legacy-iife.ts``).\n *\n * Two animation modes are supported off the same primitives:\n *\n * - **Full frame** (stepbystep): ``animateFrame(frame)`` walks every target in\n *   the frame and runs travel → pre-action → action → post-action without\n *   pause. Matches the historical behavior of the inline JS.\n * - **Interactive** (the new player): ``travelToTarget`` /\n *   ``playTargetAction`` split the sequence so the player can wait for the\n *   user to click a hotspot between phases.\n *\n * The animator owns the cursor / ripple / kbd DOM elements (it does not\n * create them — the host provides them via ``opts.stage`` and the elements\n * inside that stage). Coordinates are scaled at animation time from the\n * frame's capture-space viewport to the displayed image size; this is the\n * single point where capture-space → display-space conversion happens.\n */\n\nimport {\n  AnimatorFrame,\n  Bbox,\n  CursorBehavior,\n  CursorTimings,\n  DEFAULT_TIMINGS,\n  DisplayRect,\n  DisplayScale,\n  MultiTarget,\n  SingleTarget,\n  Viewport,\n} from './types.js';\n\nexport type TargetKind = 'click' | 'hover' | 'type';\n\nexport interface NormalizedTarget {\n  bbox: Bbox;\n  value?: string;\n  selector?: string;\n  kind: TargetKind;\n}\n\nconst sleep = (ms: number): Promise<void> =>\n  new Promise((resolve) => setTimeout(resolve, Math.max(0, ms)));\n\nexport function easeInOut(t: number): number {\n  // Smoothstep — symmetric S-curve, matches the legacy inline JS.\n  return t * t * (3 - 2 * t);\n}\n\nexport function getDisplayScale(\n  img: HTMLElement,\n  viewport: Viewport | null | undefined,\n): DisplayScale | null {\n  if (!viewport || !viewport.width || !viewport.height) return null;\n  const rect = img.getBoundingClientRect();\n  if (!rect.width || !rect.height) return null;\n  return { sx: rect.width / viewport.width, sy: rect.height / viewport.height };\n}\n\nexport function scaleRect(bbox: Bbox, scale: DisplayScale): DisplayRect {\n  return {\n    x: bbox.x * scale.sx,\n    y: bbox.y * scale.sy,\n    width: bbox.width * scale.sx,\n    height: bbox.height * scale.sy,\n  };\n}\n\nexport function rectCenter(rect: DisplayRect): { x: number; y: number } {\n  return { x: rect.x + rect.width / 2, y: rect.y + rect.height / 2 };\n}\n\n/**\n * Legacy entry point preserved verbatim for the IIFE bundle: capture-space\n * bbox + image + viewport → display-space center point.\n */\nexport function scaleBbox(\n  bbox: Bbox | null | undefined,\n  img: HTMLElement,\n  viewport: Viewport | null | undefined,\n): { x: number; y: number } | null {\n  if (!bbox) return null;\n  const scale = getDisplayScale(img, viewport);\n  if (!scale) return null;\n  return rectCenter(scaleRect(bbox, scale));\n}\n\n/**\n * Quadratic-Bezier travel duration. Pulled out so it's unit-testable\n * without DOM. ``speed`` is in capture-space px per ms.\n */\nexport function travelDuration(\n  from: { x: number; y: number },\n  to: { x: number; y: number },\n  speed: number,\n): number {\n  const dx = to.x - from.x;\n  const dy = to.y - from.y;\n  const dist = Math.hypot(dx, dy);\n  return Math.max(150, dist / (speed || 1.5));\n}\n\n/**\n * Compute a quadratic-Bezier control point offset 15% perpendicular to the\n * straight line between ``from`` and ``to``. Same formula the inline JS uses.\n */\nexport function bezierControlPoint(\n  from: { x: number; y: number },\n  to: { x: number; y: number },\n): { x: number; y: number } {\n  const dx = to.x - from.x;\n  const dy = to.y - from.y;\n  const dist = Math.hypot(dx, dy);\n  if (!dist) return { x: from.x, y: from.y };\n  const mx = (from.x + to.x) / 2;\n  const my = (from.y + to.y) / 2;\n  const nx = -dy / dist;\n  const ny = dx / dist;\n  return { x: mx + nx * dist * 0.15, y: my + ny * dist * 0.15 };\n}\n\nexport interface AnimatorOptions {\n  /** The stage element. Must contain ``.steppy-cursor``, ``.steppy-ripple``,\n   * ``.steppy-kbd`` descendants and a single ``img`` (the screenshot). */\n  stage: HTMLElement;\n  timings?: Partial<CursorTimings>;\n  /** Hook called when the cursor moves to or fires on a target. Used by the\n   * Lit player to broadcast progress events. */\n  onPhaseChange?: (phase: 'travel' | 'pre-action' | 'action' | 'post-action' | 'idle', target?: NormalizedTarget) => void;\n}\n\nexport class CursorAnimator {\n  private stage: HTMLElement;\n  private timings: CursorTimings;\n  private onPhaseChange: AnimatorOptions['onPhaseChange'];\n  private cursorEl: HTMLElement | null = null;\n  private rippleEl: HTMLElement | null = null;\n  private kbdEl: HTMLElement | null = null;\n  private imgEl: HTMLElement | null = null;\n  private currentPos: { x: number; y: number } = { x: 8, y: 8 };\n  private aborted = false;\n\n  constructor(opts: AnimatorOptions) {\n    this.stage = opts.stage;\n    this.timings = { ...DEFAULT_TIMINGS, ...(opts.timings ?? {}) };\n    this.onPhaseChange = opts.onPhaseChange;\n    this.refreshDom();\n  }\n\n  setTimings(t: Partial<CursorTimings>): void {\n    this.timings = { ...this.timings, ...t };\n  }\n\n  /** Re-point the animator at a (possibly relocated) stage element and re-read\n   *  its children. Needed when a host re-mounts the stage subtree — e.g. the\n   *  Lit player switching presentation templates moves ``.steppy-stage`` to a\n   *  new DOM position, and the cached ``stage`` ref would otherwise go stale. */\n  setStage(stage: HTMLElement): void {\n    this.stage = stage;\n    this.refreshDom();\n  }\n\n  abort(): void {\n    this.aborted = true;\n  }\n\n  hide(): void {\n    if (this.cursorEl) this.cursorEl.classList.remove('visible');\n    if (this.kbdEl) this.kbdEl.classList.remove('visible');\n    this.onPhaseChange?.('idle');\n  }\n\n  /** Re-read stage children. Call after the stage's DOM has been re-rendered. */\n  refreshDom(): void {\n    this.cursorEl = this.stage.querySelector<HTMLElement>('.steppy-cursor');\n    this.rippleEl = this.stage.querySelector<HTMLElement>('.steppy-ripple');\n    this.kbdEl = this.stage.querySelector<HTMLElement>('.steppy-kbd');\n    this.imgEl = this.stage.querySelector<HTMLImageElement>('img');\n  }\n\n  /**\n   * Normalize a frame's cursor behavior into an ordered list of targets.\n   * ``type-multi`` expands into N targets of kind ``type``; single-target\n   * variants produce a single entry. Returns ``[]`` when there's nothing to\n   * animate (cursor is null or no targets).\n   */\n  static normalizeTargets(behavior: CursorBehavior | null): NormalizedTarget[] {\n    if (!behavior) return [];\n    if (behavior.kind === 'type-multi') {\n      return behavior.targets.map(\n        (t: MultiTarget): NormalizedTarget => ({\n          bbox: t.bbox,\n          value: t.value,\n          selector: t.selector,\n          kind: 'type',\n        }),\n      );\n    }\n    const tgt = behavior.target as SingleTarget;\n    const value = behavior.kind === 'type' ? behavior.value : undefined;\n    return [\n      {\n        bbox: tgt.bbox,\n        value,\n        selector: tgt.selector,\n        kind: behavior.kind === 'click' ? 'click' : behavior.kind === 'hover' ? 'hover' : 'type',\n      },\n    ];\n  }\n\n  /** Wait for the screenshot ``<img>`` to be ready (load or error). */\n  async waitImageReady(): Promise<void> {\n    const img = this.imgEl as HTMLImageElement | null;\n    if (!img) return;\n    if (img.complete && img.naturalWidth) return;\n    await new Promise<void>((resolve) => {\n      const done = () => resolve();\n      img.addEventListener('load', done, { once: true });\n      img.addEventListener('error', done, { once: true });\n    });\n  }\n\n  /**\n   * Full sequence over every target in ``frame.cursor`` — historical\n   * stepbystep behavior. No user interaction.\n   */\n  async animateFrame(frame: AnimatorFrame): Promise<void> {\n    this.aborted = false;\n    this.refreshDom();\n    if (!this.cursorEl) return;\n    if (!frame.cursor) {\n      this.hide();\n      return;\n    }\n    await this.waitImageReady();\n    const targets = CursorAnimator.normalizeTargets(frame.cursor);\n    this.currentPos = { x: 8, y: 8 };\n    this.cursorEl.classList.add('visible');\n    for (let i = 0; i < targets.length; i++) {\n      if (this.aborted) return;\n      await this.travelToTargetIndex(frame, targets, i);\n      if (this.aborted) return;\n      await this.playTargetActionIndex(frame, targets, i);\n      if (this.aborted) return;\n      await sleep(this.timings.post_action_ms);\n    }\n  }\n\n  /**\n   * Interactive mode: move the cursor to ``targetIndex`` and pulse it. Caller\n   * waits for user input before invoking ``playTargetAction``.\n   */\n  async travelToTarget(frame: AnimatorFrame, targetIndex: number): Promise<void> {\n    this.aborted = false;\n    this.refreshDom();\n    if (!this.cursorEl) return;\n    if (!frame.cursor) {\n      this.hide();\n      return;\n    }\n    await this.waitImageReady();\n    const targets = CursorAnimator.normalizeTargets(frame.cursor);\n    this.cursorEl.classList.add('visible');\n    await this.travelToTargetIndex(frame, targets, targetIndex);\n  }\n\n  /**\n   * Interactive mode: run the action animation for ``targetIndex`` and the\n   * post-action settling beat.\n   */\n  async playTargetAction(frame: AnimatorFrame, targetIndex: number): Promise<void> {\n    this.aborted = false;\n    this.refreshDom();\n    if (!frame.cursor) return;\n    const targets = CursorAnimator.normalizeTargets(frame.cursor);\n    await this.playTargetActionIndex(frame, targets, targetIndex);\n    if (this.aborted) return;\n    await sleep(this.timings.post_action_ms);\n  }\n\n  /**\n   * Pure helper: project a capture-space bbox into the displayed coordinate\n   * space. Returns ``null`` when the image hasn't laid out yet. Exposed so\n   * the Lit player can place hotspots without duplicating the math.\n   */\n  computeDisplayRect(bbox: Bbox | null | undefined, viewport: Viewport | null | undefined): DisplayRect | null {\n    const img = this.imgEl;\n    if (!img || !bbox) return null;\n    const scale = getDisplayScale(img, viewport);\n    if (!scale) return null;\n    return scaleRect(bbox, scale);\n  }\n\n  // ── Internal building blocks ───────────────────────────────────────────\n\n  private async travelToTargetIndex(\n    frame: AnimatorFrame,\n    targets: NormalizedTarget[],\n    index: number,\n  ): Promise<void> {\n    const tgt = targets[index];\n    const cursor = this.cursorEl;\n    if (!tgt || !cursor) return;\n    const center = scaleBbox(tgt.bbox, this.imgEl!, frame.viewport);\n    if (!center) return;\n\n    this.onPhaseChange?.('travel', tgt);\n    await this.travelTo(cursor, this.currentPos, center);\n    this.currentPos = center;\n\n    this.onPhaseChange?.('pre-action', tgt);\n    // Pulse: drop the class, force reflow to restart the animation, re-add.\n    cursor.classList.remove('pulse');\n    void cursor.offsetWidth;\n    cursor.classList.add('pulse');\n    await sleep(this.timings.pre_action_ms);\n    cursor.classList.remove('pulse');\n  }\n\n  private async playTargetActionIndex(\n    frame: AnimatorFrame,\n    targets: NormalizedTarget[],\n    index: number,\n  ): Promise<void> {\n    const tgt = targets[index];\n    if (!tgt) return;\n    const center = scaleBbox(tgt.bbox, this.imgEl!, frame.viewport) || this.currentPos;\n    this.onPhaseChange?.('action', tgt);\n    if (tgt.kind === 'click') {\n      if (this.rippleEl) this.fireClick(this.rippleEl, center);\n      await sleep(this.timings.action_ms);\n    } else if (tgt.kind === 'type') {\n      if (this.kbdEl) await this.typeValue(this.kbdEl, center, tgt.value);\n    } else {\n      // hover: linger\n      await sleep(this.timings.action_ms);\n    }\n    this.onPhaseChange?.('post-action', tgt);\n  }\n\n  private async travelTo(\n    cursor: HTMLElement,\n    from: { x: number; y: number },\n    to: { x: number; y: number },\n  ): Promise<void> {\n    const duration = travelDuration(from, to, this.timings.travel_speed_px_per_ms);\n    const cp = bezierControlPoint(from, to);\n    return new Promise<void>((resolve) => {\n      const start = performance.now();\n      const frame = (now: number) => {\n        if (this.aborted) {\n          resolve();\n          return;\n        }\n        const raw = Math.min(1, (now - start) / duration);\n        const t = easeInOut(raw);\n        const x = (1 - t) * (1 - t) * from.x + 2 * (1 - t) * t * cp.x + t * t * to.x;\n        const y = (1 - t) * (1 - t) * from.y + 2 * (1 - t) * t * cp.y + t * t * to.y;\n        cursor.style.left = `${x}px`;\n        cursor.style.top = `${y}px`;\n        if (raw < 1) requestAnimationFrame(frame);\n        else resolve();\n      };\n      requestAnimationFrame(frame);\n    });\n  }\n\n  private fireClick(ripple: HTMLElement, to: { x: number; y: number }): void {\n    ripple.style.left = `${to.x}px`;\n    ripple.style.top = `${to.y}px`;\n    ripple.classList.remove('fire');\n    void ripple.offsetWidth;\n    ripple.classList.add('fire');\n  }\n\n  private async typeValue(\n    kbd: HTMLElement,\n    to: { x: number; y: number },\n    value: string | undefined,\n  ): Promise<void> {\n    kbd.style.left = `${to.x + 16}px`;\n    kbd.style.top = `${to.y + 16}px`;\n    kbd.textContent = '';\n    kbd.classList.add('visible');\n    const chars = (value ?? '').split('');\n    const per = chars.length ? this.timings.action_ms / chars.length : this.timings.action_ms;\n    for (const ch of chars) {\n      if (this.aborted) break;\n      kbd.textContent = (kbd.textContent ?? '') + ch;\n      await sleep(per);\n    }\n    await sleep(80);\n    kbd.classList.remove('visible');\n  }\n}\n","/**\n * Legacy IIFE — drop-in replacement for the inline JS that previously lived\n * in [templates/static/cursor.js.j2](../../../../templates/static/cursor.js.j2)\n * and the cursor block of [templates/guide.html.j2](../../../../templates/guide.html.j2).\n *\n * Reads ``window.__STEPPY_STEPS__`` (per-step frame data) and\n * ``window.__STEPPY_TIMINGS__`` (cursor timing overrides), then animates each\n * step's cursor when its ``.steppy-step`` section scrolls into view. This is\n * the exact contract those Jinja templates already produce; making them\n * include this bundle replaces ~175 lines of duplicated JS with a single\n * built artifact.\n *\n * Two consumers:\n *\n * - **Static / standalone HTML** (``cursor.js.j2`` / ``guide.html.j2``): the\n *   page sets the ``__STEPPY_STEPS__`` globals before the bundle loads, so the\n *   bundle auto-inits on DOM-ready over the whole document.\n * - **Angular host** (``angular/component.ts.j2``): there are no globals and\n *   the guide HTML is injected via ``[innerHTML]`` *after* DOM-ready (and\n *   re-injected on locale/layout/mode change). The bundle never auto-inits in\n *   that case; instead it exposes ``window.__STEPPY_CURSOR__.mount(root, steps,\n *   timings)`` so the component can (re)drive the cursor over its own subtree\n *   each time the DOM is swapped. ``mount`` returns a disposer that disconnects\n *   the observer and aborts any in-flight animation.\n *\n * Output format: IIFE bundle. Vite builds this via ``vite.iife.config.ts``.\n */\n\nimport type { CursorTimings } from './types.js';\nimport { CursorAnimator } from './animator.js';\n\ninterface LegacyFrame {\n  screenshot: string;\n  viewport: { width: number; height: number } | null;\n  cursor: Parameters<CursorAnimator['animateFrame']>[0]['cursor'];\n}\n\ninterface LegacyStep {\n  index: number;\n  frames: LegacyFrame[];\n}\n\ntype LegacyTimings = Partial<CursorTimings> | undefined;\n\ninterface SteppyCursorApi {\n  /** Drive the cursor over every ``.steppy-step`` under ``root``, animating\n   * each step as it scrolls into view. Returns a disposer. */\n  mount(root: ParentNode, steps: LegacyStep[], timings?: LegacyTimings): () => void;\n  /** Auto-init entry point used by the static/standalone templates (reads the\n   * ``window.__STEPPY_STEPS__`` globals and mounts over ``document``). */\n  init(): void;\n}\n\ndeclare global {\n  interface Window {\n    __STEPPY_STEPS__?: LegacyStep[];\n    __STEPPY_STEPS_BY_LAYOUT__?: Record<string, LegacyStep[]>;\n    __STEPPY_TIMINGS__?: Partial<CursorTimings>;\n    __STEPPY_CURSOR__?: SteppyCursorApi;\n  }\n}\n\nfunction animateStep(\n  section: Element,\n  step: LegacyStep | undefined,\n  timings: LegacyTimings,\n  animators?: CursorAnimator[],\n): Promise<void> {\n  if (!step) return Promise.resolve();\n  const stages = Array.from(section.querySelectorAll<HTMLElement>('.steppy-stage'));\n  const frames = step.frames ?? [];\n  return (async () => {\n    for (let i = 0; i < stages.length; i++) {\n      const stage = stages[i]!;\n      const frame = frames[i];\n      if (!frame) continue;\n      const animator = new CursorAnimator({ stage, timings });\n      animators?.push(animator);\n      await animator.animateFrame(frame);\n    }\n  })();\n}\n\n/**\n * Drive the cursor over a subtree. Used directly by the Angular host (which\n * passes its component root and the per-(locale, layout) step data) and\n * indirectly by ``init`` for the static templates (which pass ``document`` and\n * the ``window.__STEPPY_STEPS__`` globals).\n */\nfunction mount(root: ParentNode, steps: LegacyStep[], timings?: LegacyTimings): () => void {\n  const sections = Array.from(root.querySelectorAll<HTMLElement>('.steppy-step'));\n  const animators: CursorAnimator[] = [];\n\n  const runSection = (section: HTMLElement): Promise<void> => {\n    const idxAttr = section.dataset.stepIndex;\n    const idx = idxAttr !== undefined ? parseInt(idxAttr, 10) - 1 : -1;\n    return animateStep(section, idx >= 0 ? steps[idx] : undefined, timings, animators);\n  };\n\n  let io: IntersectionObserver | null = null;\n  if (!('IntersectionObserver' in window)) {\n    // Fallback: animate every section sequentially.\n    void (async () => {\n      for (const section of sections) await runSection(section);\n    })();\n  } else {\n    io = new IntersectionObserver(\n      (entries) => {\n        entries.forEach((entry) => {\n          if (!entry.isIntersecting) return;\n          io!.unobserve(entry.target);\n          void runSection(entry.target as HTMLElement);\n        });\n      },\n      { threshold: 0.5 },\n    );\n    sections.forEach((section) => io!.observe(section));\n  }\n\n  return function dispose(): void {\n    if (io) io.disconnect();\n    animators.forEach((a) => a.abort());\n  };\n}\n\nfunction init(): void {\n  mount(document, window.__STEPPY_STEPS__ ?? [], window.__STEPPY_TIMINGS__);\n}\n\n// Expose the programmatic API so SPA hosts (Angular) can (re)drive the cursor\n// over content injected after page load. Harmless for the static templates.\nwindow.__STEPPY_CURSOR__ = { mount, init };\n\n// Auto-init only when the page pre-declared the step globals (static /\n// standalone HTML). In an SPA the globals are absent and the host calls\n// ``mount`` explicitly after each render, so auto-init would be a no-op anyway\n// — guarding here avoids spinning up a stray document-wide observer.\nfunction autoInit(): void {\n  if (!window.__STEPPY_STEPS__ && !window.__STEPPY_STEPS_BY_LAYOUT__) return;\n  init();\n}\n\nif (document.readyState === 'loading') {\n  document.addEventListener('DOMContentLoaded', autoInit);\n} else {\n  autoInit();\n}\n"],"names":["DEFAULT_TIMINGS","sleep","ms","resolve","easeInOut","t","getDisplayScale","img","viewport","rect","scaleRect","bbox","scale","rectCenter","scaleBbox","travelDuration","from","to","speed","dx","dy","dist","bezierControlPoint","mx","my","nx","ny","CursorAnimator","opts","_a","stage","behavior","tgt","value","done","frame","targets","i","targetIndex","index","cursor","center","_b","duration","cp","start","now","raw","x","y","ripple","kbd","chars","per","ch","animateStep","section","step","timings","animators","stages","frames","animator","mount","root","steps","sections","runSection","idxAttr","idx","io","entries","entry","a","init","autoInit"],"mappings":"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"}