"""Canonical I/O for the corrective 0.4 rebuild."""
from __future__ import annotations

import json
from pathlib import Path
from typing import Any, Mapping

from tom_world03.canonical import canonical_bytes

from .model import ContinuationWorld


def load_record(path: str | Path) -> dict[str, Any]:
    value = json.loads(Path(path).read_text(encoding="utf-8"))
    if not isinstance(value, dict):
        raise ValueError("JSON root must be an object")
    return value


def load_world(path: str | Path) -> tuple[dict[str, Any], ContinuationWorld]:
    record = load_record(path)
    return record, ContinuationWorld.from_record(record)


def write_canonical(path: str | Path, value: Mapping[str, Any] | list[Any]) -> None:
    target = Path(path)
    target.parent.mkdir(parents=True, exist_ok=True)
    target.write_bytes(canonical_bytes(value) + b"\n")