"""blackout-spoof-derkachi — visual blackout + spoofed GPS combination (FT-N-04, NFT-RES-04).

Concrete generator is owned by AZ-408. AZ-406 commits to the public
signature.
"""

from __future__ import annotations

from dataclasses import dataclass
from pathlib import Path


@dataclass(frozen=True)
class BlackoutSpoofPlan:
    """Configuration for the blackout-spoof-derkachi fixture.

    `blackout_seconds` corresponds to the 5 / 15 / 35 s window family from
    NFT-RES-04 (35 s escalation ladder) and FT-N-04 (blackout + spoof).
    """

    blackout_seconds: float
    spoof_offset_m: float
    spoof_bearing_deg: float


def build(plan: BlackoutSpoofPlan, out_root: Path) -> Path:
    raise NotImplementedError("Owned by AZ-408 — AZ-406 supplies only the contract.")