/// The outcome of reading a String Catalog from its bundle.
///
/// The package degrades gracefully when a catalog cannot be read — lookups return their keys and the
/// language list falls back to the default language — so nothing fails at the call site. This state is
/// the signal a server checks once at startup to warn before visitors ever see raw localization keys.
public enum CatalogState: Equatable, Sendable {

    /// The catalog was found and decoded; its entries are resolvable.
    case loaded

    /// No catalog resource exists in the bundle; every lookup returns its key.
    case missing

    /// The catalog resource exists but is not valid `.xcstrings` JSON; every lookup returns its key.
    case undecodable

}