Fixes for the Localization package (#26)

This PR contains the work done to Reviewed-on: rock-n-code/loud-amsterdam#26 Co-authored-by: Javier Cicchelli <javier@rock-n-code.com> Co-committed-by: Javier Cicchelli <javier@rock-n-code.com>
2026-07-28 23:37:33 +00:00
parent cdded06ba3
commit 0887135328
16 changed files with 518 additions and 80 deletions
@@ -0,0 +1,17 @@
+/// 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
+
+}