"""Caveat codes an engine can attach to a result, and the sentence each one stands for."""

NOTES: dict[str, str] = {
    "main_sequence_approximation": (
        "These values use simple main-sequence scaling laws, so real stars can differ noticeably."
    ),
    "extrapolated_mass_range": (
        "This mass is outside the range where the scaling laws are calibrated, so the numbers are rough extrapolations."
    ),
    "hubble_law_approx": (
        "At this redshift the simple linear Hubble law is only an approximation; the distance comes from the full expansion history."
    ),
    "relativistic_regime": (
        "Speeds or gravity here are strong enough that relativity matters, so Newtonian intuition breaks down."
    ),
    "high_eccentricity": (
        "This orbit is very stretched, so the distance and speed change dramatically over each orbit."
    ),
    "newtonian_approximation": (
        "This uses Newtonian gravity, which is an excellent approximation here but ignores relativistic corrections."
    ),
    "geostationary": (
        "This is a geostationary orbit: the satellite turns with Earth, so it hovers over one spot on the equator."
    ),
    "atmospheric_drag": (
        "At this height Earth's thin upper atmosphere causes drag that slowly lowers the orbit, so it needs occasional boosts."
    ),
    "circular_orbit_approx": "This assumes a circular orbit around a perfectly round body.",
    "falchi_2015_baseline": (
        "Sky darkness comes from the world atlas of light pollution, built from satellite data taken several years ago, so newer lighting is not included."
    ),
    "viirs_blind_to_blue": (
        "The VIIRS satellite misses much of the blue light from white LEDs, so real growth in light pollution may be larger."
    ),
    "moon_and_weather": (
        "Moonlight and cloud matter as much as location; plan for a moonless, clear night."
    ),
    "low_radiance_noise": (
        "The night-light level here is very low, so the percentage change is noisy and should not be over-interpreted."
    ),
}