from __future__ import annotations

from pathlib import Path

from .diagnostics import io_failure
from .model import GeneratedArtifact


def write_artifacts(
    *, output_dir: Path, artifacts: list[GeneratedArtifact], overwrite: bool
) -> list[Path]:
    output_dir.mkdir(parents=True, exist_ok=True)
    written: list[Path] = []

    for artifact in sorted(artifacts, key=lambda item: item.relative_path):
        target = output_dir / artifact.relative_path
        target.parent.mkdir(parents=True, exist_ok=True)
        if target.exists() and not overwrite:
            raise io_failure(
                "Target file already exists; use overwrite to replace", str(target)
            )
        target.write_text(artifact.content, encoding="utf-8")
        written.append(target)

    return written